Skip to content

v0.7.0: full GitNexus 1.6.x tool coverage, TOON output, TUI renderers - #20

Open
yolonir wants to merge 10 commits into
tintinweb:masterfrom
yolonir:master
Open

v0.7.0: full GitNexus 1.6.x tool coverage, TOON output, TUI renderers#20
yolonir wants to merge 10 commits into
tintinweb:masterfrom
yolonir:master

Conversation

@yolonir

@yolonir yolonir commented Sep 9, 2026

Copy link
Copy Markdown

What

Brings the extension up to date with GitNexus 1.6.x and improves output economics:

  • Full MCP tool coverage — all 17 GitNexus 1.6.x tools (was 7): adds trace, explain, pdg_query (merged into gitnexus_query as a pdg param), check, route_map, tool_map, shape_check, api_impact, group_list, group_sync; existing tools gained new params (branch, service, mode, line, crossDepth, ...)
  • TOON output formatting (@toon-format/toon) — ~50% smaller tool results vs raw JSON dumped into agent context; cypher {markdown} payloads print verbatim
  • TUI renderers for all tools — labeled tool-call rows (Gitnexus Cypher query=...) + 15-line result preview with ctrl+o expand
  • Auto-augment covers pi-fff tools (ffgrep, fffind, fff-multi-grep, multi_grep)
  • Settings additions: PDG analysis toggle (analyze --pdg), startup-notice toggle
  • Cypher tool description teaches the LadybugDB dialect (no [:TYPE] syntax, no type(), filter r.type) — verified against live MCP; prevents agent error loops with Neo4j-style queries
  • Output budget applied after TOON formatting (large responses like detect_changes no longer arrive as truncated broken JSON)
  • When indexed with --pdg, gitnexus_query description advertises the pdg param

Verification

  • typecheck, biome lint, build: clean
  • vitest: 61/61
  • Live tested against GitNexus 1.6.9 MCP (query/context/impact/cypher/check/trace/group_list)

- 9 new tools: trace, explain, check, route_map, tool_map,
  shape_check, api_impact, group_list, group_sync
- gitnexus_query absorbs pdg_query via pdg: controls|flows param
- existing tools catch up with 1.6.x schemas: branch, service, kind,
  impact mode=pdg/line/target_uid/limit/offset/summaryOnly/crossDepth,
  cypher params, list_repos limit/offset
- settings toggle "PDG analysis": run analyze with --pdg
- MCP JSON re-serialized to TOON (~45% token cut on real payloads),
  trailing guidance text preserved
- renderCall: tool name + key args; renderResult: 15-line preview
  with expand hint (pi grep renderer pattern)
- dep: @toon-format/toon
Verified against live MCP: [:TYPE] fails ('Table X does not exist' — rels are
one generic table, filter r.type), type() is missing, schema resource documents
labels/props. Prevents the error loops agents hit when writing Neo4j-style queries.
The 8KB cap sliced raw JSON in the MCP client, so large responses (e.g.
detect_changes with 252 symbols) arrived as broken JSON and bypassed
formatting entirely. Now callTool takes an optional cap: tool results pass 0
(untruncated) and the budget is applied to the TOON-formatted text, so valid
JSON always reaches the formatter. Augment injections keep the raw cap.
When the analyzePdg setting is on, the gitnexus_query description tells the
model the PDG layer is present and to prefer pdg:'controls'/'flows' for
data/control-flow questions. No auto-routing — search stays search, PDG is
opt-in per call, so no information is lost.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant