Merge pull request #309 from jorgerojas26/feat/fk-jump

feat: add Foreign Key Jump in records table

Author: jorgerojas26

.atl/.skill-registry.cache.json

@@ -0,0 +1,3 @@
+{
+  "fingerprint": "8c2d82207ff0af3637fdba6bb03105578f142fea"
+}

.atl/skill-registry.md

@@ -0,0 +1,45 @@
+# Skill Registry — lazysql
+
+<!-- Auto-generated by gentle-ai skill-registry refresh. Run `gentle-ai skill-registry refresh --force` to regenerate. -->
+
+Last updated: 2026-05-25
+
+## Sources scanned
+
+- /Users/jorgerojas/.config/agents/skills
+- /Users/jorgerojas/.agents/skills
+- /Users/jorgerojas/.config/opencode/skills
+- /Users/jorgerojas/.gemini/skills
+- /Users/jorgerojas/.copilot/skills
+- /Users/jorgerojas/.codex/skills
+
+## Contract
+
+**Delegator use only.** This registry is an index, not a summary. Any agent that launches subagents reads it to select relevant skills, then passes exact `SKILL.md` paths for the subagent to read before work.
+
+`SKILL.md` remains the source of truth. Do not inject generated summaries or compact rules by default; pass paths so subagents load the full runtime contract and preserve author intent.
+
+## Skills
+
+| Skill | Trigger / description | Scope | Path |
+| --- | --- | --- | --- |
+| `branch-pr` | Create Gentle AI pull requests with issue-first checks. Trigger: creating, opening, or preparing PRs for review. | user | `/Users/jorgerojas/.config/opencode/skills/branch-pr/SKILL.md` |
+| `caveman` | Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra, wenyan-lite, wenyan-full, wenyan-ultra. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested. | user | `/Users/jorgerojas/.agents/skills/caveman/SKILL.md` |
+| `chained-pr` | Trigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus. | user | `/Users/jorgerojas/.config/opencode/skills/chained-pr/SKILL.md` |
+| `cognitive-doc-design` | Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs. | user | `/Users/jorgerojas/.config/opencode/skills/cognitive-doc-design/SKILL.md` |
+| `comment-writer` | Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments. | user | `/Users/jorgerojas/.config/opencode/skills/comment-writer/SKILL.md` |
+| `go-testing` | Trigger: Go tests, go test coverage, Bubbletea teatest, golden files. Apply focused Go testing patterns. | user | `/Users/jorgerojas/.config/opencode/skills/go-testing/SKILL.md` |
+| `grill-with-docs` | Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions. | user | `/Users/jorgerojas/.agents/skills/grill-with-docs/SKILL.md` |
+| `issue-creation` | Create Gentle AI issues with issue-first checks. Trigger: creating GitHub issues, bug reports, or feature requests. | user | `/Users/jorgerojas/.config/opencode/skills/issue-creation/SKILL.md` |
+| `judgment-day` | Trigger: judgment day, dual review, adversarial review, juzgar. Run blind dual review, fix confirmed issues, then re-judge. | user | `/Users/jorgerojas/.config/opencode/skills/judgment-day/SKILL.md` |
+| `skill-creator` | Trigger: new skills, agent instructions, documenting AI usage patterns. Create LLM-first skills with valid frontmatter. | user | `/Users/jorgerojas/.config/opencode/skills/skill-creator/SKILL.md` |
+| `skill-improver` | Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills. | user | `/Users/jorgerojas/.config/opencode/skills/skill-improver/SKILL.md` |
+| `to-prd` | Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context. | user | `/Users/jorgerojas/.agents/skills/to-prd/SKILL.md` |
+| `work-unit-commits` | Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code. | user | `/Users/jorgerojas/.config/opencode/skills/work-unit-commits/SKILL.md` |
+
+## Loading protocol
+
+1. Match task context and target files against the `Trigger / description` column.
+2. Pass only the matching `Path` values to the subagent under `## Skills to load before work`.
+3. Instruct the subagent to read those exact `SKILL.md` files before reading, writing, reviewing, testing, or creating artifacts.
+4. If no matching skill exists, proceed without project skill injection and report `skill_resolution: none`.

CONTEXT.md

@@ -0,0 +1,23 @@
+# Lazysql
+
+Context language for interactive database exploration in terminal UI.
+
+## Language
+
+**Foreign Key Jump**:
+Keyboard action that follows a foreign key value from a source row cell to a referenced table view with a prefilled filter.
+_Avoid_: FK drilldown, relation follow, link jump
+
+## Relationships
+
+- A **Foreign Key Jump** starts from one selected table cell in a source row.
+- A **Foreign Key Jump** targets one referenced table view filtered by the selected value.
+
+## Example dialogue
+
+> **Dev:** "Should Enter open JSON or follow relation here?"
+> **Domain expert:** "If this cell supports **Foreign Key Jump**, Enter follows relation; otherwise Enter keeps existing behavior."
+
+## Flagged ambiguities
+
+- "drilldown" was used to mean both JSON inspection and FK navigation - resolved: use **Foreign Key Jump** only for relation navigation.

components/home.go

@@ -205,7 +205,7 @@ func (home *Home) showTable(databaseName, tableName string) {
 		table = tab.Content.(*ResultsTable)
 		home.TabbedPane.SwitchToTabByReference(tab.Reference)
 	} else {
-		table = NewResultsTable(&home.ListOfDBChanges, home.Tree, home.DBDriver, home.ConnectionIdentifier, home.ConnectionURL, home.ReadOnly).WithFilter()
+		table = NewResultsTable(&home.ListOfDBChanges, home.Tree, home.DBDriver, home, home.ConnectionIdentifier, home.ConnectionURL, home.ReadOnly).WithFilter()
 		table.SetDatabaseName(databaseName)
 		table.SetTableName(tableName)
 
@@ -233,6 +233,53 @@ func (home *Home) showTable(databaseName, tableName string) {
 	app.App.ForceDraw()
 }
 
+func (home *Home) ShowTableWithFilter(databaseName, tableName, where string) error {
+	if tableName == "" {
+		return fmt.Errorf("table name is required")
+	}
+
+	tabReference := fmt.Sprintf("%s.%s", databaseName, tableName)
+	tab := home.TabbedPane.GetTabByReference(tabReference)
+
+	var table *ResultsTable
+	if tab != nil {
+		table = tab.Content.(*ResultsTable)
+		home.TabbedPane.SwitchToTabByReference(tab.Reference)
+	} else {
+		table = NewResultsTable(&home.ListOfDBChanges, home.Tree, home.DBDriver, home, home.ConnectionIdentifier, home.ConnectionURL, home.ReadOnly).WithFilter()
+		table.SetDatabaseName(databaseName)
+		table.SetTableName(tableName)
+		home.TabbedPane.AppendTab(tableName, table, tabReference)
+	}
+
+	if table.Filter != nil {
+		table.Filter.SetCurrentFilterUnsafe(where)
+	}
+
+	results := table.FetchRecords(func() {
+		home.focusLeftWrapper()
+	})
+
+	if !app.App.Config().DisableSidebar && len(results) > 1 && !table.GetShowSidebar() {
+		table.ShowSidebar(true)
+	}
+
+	if table.state.error == "" {
+		if !home.treePinned && home.leftWrapperVisible {
+			home.toggleLeftWrapper()
+		}
+		home.focusRightWrapper()
+	}
+
+	app.App.ForceDraw()
+
+	if table.state.error != "" {
+		return fmt.Errorf(table.state.error)
+	}
+
+	return nil
+}
+
 func (home *Home) focusRightWrapper() {
 	home.Tree.RemoveHighlight()
 
@@ -551,7 +598,7 @@ func (home *Home) createOrFocusEditorTab() {
 			go table.loadEditorSchema()
 		}
 	} else {
-		tableWithEditor := NewResultsTable(&home.ListOfDBChanges, home.Tree, home.DBDriver, home.ConnectionIdentifier, home.ConnectionURL, home.ReadOnly)
+		tableWithEditor := NewResultsTable(&home.ListOfDBChanges, home.Tree, home.DBDriver, home, home.ConnectionIdentifier, home.ConnectionURL, home.ReadOnly)
 		// Set database name before WithEditor so the table is ready for schema loading
 		if dbName != "" {
 			tableWithEditor.SetDatabaseName(dbName)

components/result_table_filter.go

@@ -1,6 +1,8 @@
 package components
 
 import (
+	"strings"
+
 	"github.com/gdamore/tcell/v2"
 	"github.com/rivo/tview"
 
@@ -80,6 +82,24 @@ func (filter *ResultsTableFilter) GetCurrentFilter() string {
 	return filter.currentFilter
 }
 
+func (filter *ResultsTableFilter) SetCurrentFilterUnsafe(whereClause string) {
+	trimmed := strings.TrimSpace(whereClause)
+	if trimmed == "" {
+		filter.currentFilter = ""
+		filter.Input.SetText("")
+		return
+	}
+
+	if strings.HasPrefix(strings.ToUpper(trimmed), "WHERE ") {
+		filter.currentFilter = trimmed
+		filter.Input.SetText(strings.TrimSpace(trimmed[6:]))
+		return
+	}
+
+	filter.currentFilter = "WHERE " + trimmed
+	filter.Input.SetText(trimmed)
+}
+
 // Function to blur
 func (filter *ResultsTableFilter) RemoveHighlight() {
 	filter.SetBorderColor(app.Styles.InverseTextColor)