@akon-labs/nexus-cli 0.1.0

package/dist/extensions/gitnexus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/gitnexus/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ExtensionAPI } from \"../../core/extensions/types.ts\";\nimport { graphRailStore } from \"../../core/graph-rail-store.ts\";\nimport { openBrowser } from \"../../utils/open-browser.ts\";\nimport { registerAugmentedGrep } from \"./augment.ts\";\nimport { registerChangeTracking } from \"./changes.ts\";\nimport { GitNexusClient, GitNexusClientError } from \"./client.ts\";\nimport { DEFAULT_HUB_URL, resolveGitNexusConfig, saveGitNexusConfig } from \"./config.ts\";\nimport { defaultDeviceName, deviceFingerprint, pollDeviceAuth, startDeviceAuth } from \"./device-auth.ts\";\nimport { readGatewayCache, registerAutoProvider } from \"./gateway.ts\";\nimport { spawnObservatoryFetch } from \"./observatory.ts\";\nimport { buildGitNexusPrompt } from \"./prompt.ts\";\nimport { withGitNexusRenderer } from \"./render.ts\";\nimport {\n\tgitRemoteSlug,\n\ttype IndexedRepo,\n\tmatchCurrentRepo,\n\tparseRepoInventory,\n\ttype RepoInventory,\n} from \"./resolve.ts\";\nimport { createGitNexusTools } from \"./tools.ts\";\n\n/** Resolve workflow skills in source mode and bundled dist/cli.js mode. */\nexport function resolveGitNexusSkillsDir(\n\tmoduleUrl: string = import.meta.url,\n\tpathExists: (path: string) => boolean = existsSync,\n): string | undefined {\n\tconst candidates = [\n\t\tfileURLToPath(new URL(\"./skills/\", moduleUrl)),\n\t\tfileURLToPath(new URL(\"./extensions/gitnexus/skills/\", moduleUrl)),\n\t];\n\treturn candidates.find(pathExists);\n}\n\n/**\n * GitNexus built-in extension: connects nexus-cli to the GitNexus hub.\n *\n * - session_start: resolve config + repo inventory, register the six graph\n *   tools and the augmented grep. No token / hub down / repo unindexed all\n *   degrade to a plain coding agent (graph is additive, never load-bearing).\n * - before_agent_start: append the GitNexus guidance block (ported from the\n *   CLAUDE.md generator) to the system prompt.\n */\nexport default function gitnexusExtension(pi: ExtensionAPI): void {\n\tlet inventory: RepoInventory | undefined;\n\tlet current: IndexedRepo | undefined;\n\tlet activeClient: GitNexusClient | undefined;\n\tlet toolsRegistered = false;\n\tlet startupNotice: string | undefined;\n\tlet loginRequired = false;\n\n\tconst cwd = process.cwd();\n\n\t// Auto mode must also register at factory time: the initial model is\n\t// resolved before session_start fires, and a provider that appears after\n\t// that is invisible to it. Reads the policy cache the startup gate wrote.\n\tregisterAutoProvider(pi, resolveGitNexusConfig(), readGatewayCache());\n\n\t// Built-in tool overrides must happen at factory time (like the bash-spawn-hook\n\t// example) — session_start registrations only add NEW names reliably. The wrapper\n\t// behaves as plain grep until connect() provides a client + current repo.\n\tregisterAugmentedGrep(\n\t\tpi,\n\t\tcwd,\n\t\t() => activeClient,\n\t\t() => current?.name,\n\t);\n\tregisterChangeTracking(pi, cwd);\n\n\tasync function connect(): Promise<void> {\n\t\tinventory = undefined;\n\t\tcurrent = undefined;\n\t\tactiveClient = undefined;\n\t\tstartupNotice = undefined;\n\t\tloginRequired = false;\n\t\tconst config = resolveGitNexusConfig();\n\t\tif (!config) return;\n\t\tconst client = new GitNexusClient(config);\n\t\ttry {\n\t\t\tconst listResult = await client.callTool(\"list_repos\", {});\n\t\t\tinventory = parseRepoInventory(GitNexusClient.text(listResult));\n\t\t} catch (error) {\n\t\t\tconst reason = error instanceof GitNexusClientError ? error.message : String(error);\n\t\t\tif (error instanceof GitNexusClientError && error.kind === \"auth\") {\n\t\t\t\tloginRequired = true;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tstartupNotice = `GitNexus unavailable: ${reason}`;\n\t\t\treturn;\n\t\t}\n\n\t\tcurrent = matchCurrentRepo(inventory, gitRemoteSlug(cwd));\n\t\tactiveClient = client;\n\t\tgraphRailStore.setRepoList(inventory.repos.map((repo) => ({ name: repo.name, symbols: repo.symbols })));\n\t\t// Observatory (community map) rides a detached subprocess + temp-file\n\t\t// handoff — in-process hub calls made after startup can starve in some\n\t\t// environments, a fresh process never does. The UI picks the file up\n\t\t// lazily via tryLoadObservatoryCache.\n\t\tif (current) spawnObservatoryFetch(config, current.name);\n\t\tgraphRailStore.setRepo(\n\t\t\tcurrent\n\t\t\t\t? {\n\t\t\t\t\t\tname: current.name,\n\t\t\t\t\t\tsymbols: current.symbols,\n\t\t\t\t\t\trelationships: current.relationships,\n\t\t\t\t\t\tindexedAt: current.indexedAt,\n\t\t\t\t\t\trepoCount: inventory.repos.length,\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\tname: \"\",\n\t\t\t\t\t\tsymbols: \"0\",\n\t\t\t\t\t\trelationships: \"0\",\n\t\t\t\t\t\tindexedAt: \"\",\n\t\t\t\t\t\trepoCount: inventory.repos.length,\n\t\t\t\t\t},\n\t\t\tcurrent !== undefined,\n\t\t);\n\t\tif (!toolsRegistered) {\n\t\t\tconst ctx = { client, currentRepo: () => current?.name, cwd };\n\t\t\tfor (const tool of createGitNexusTools(ctx)) pi.registerTool(withGitNexusRenderer(tool));\n\t\t\ttoolsRegistered = true;\n\t\t}\n\n\t\tstartupNotice = current\n\t\t\t? `GitNexus: connected — ${current.name} (${current.symbols} symbols, indexed ${current.indexedAt}), ${inventory.repos.length} repos available.`\n\t\t\t: `GitNexus: connected — current directory is not indexed; ${inventory.repos.length} indexed repos remain queryable. Index this repo from the Hub dashboard to unlock local graph context.`;\n\t}\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tawait connect();\n\t\tif (startupNotice) ctx.ui.notify(startupNotice, inventory ? \"info\" : \"warning\");\n\t});\n\n\t// Bundled GitNexus workflow skills (debugging, exploring, impact-analysis,\n\t// refactoring, pr-review, guide) — same SKILL.md content the Claude plugin\n\t// ships, adapted for hub-based indexing. Loaded on-demand by pi's skill system.\n\t// Skipped entirely when the user already has gitnexus skills (project or\n\t// global) so the startup screen doesn't report shadowed duplicates.\n\tpi.on(\"resources_discover\", (event) => {\n\t\tconst hasOwnGitnexusSkills =\n\t\t\texistsSync(join(event.cwd, \".agents\", \"skills\", \"gitnexus\")) ||\n\t\t\texistsSync(join(homedir(), \".agents\", \"skills\", \"gitnexus-debugging\"));\n\t\tif (hasOwnGitnexusSkills) return;\n\t\tconst skillsDir = resolveGitNexusSkillsDir();\n\t\tif (!skillsDir) return;\n\t\treturn { skillPaths: [skillsDir] };\n\t});\n\n\tpi.on(\"before_agent_start\", (event) => {\n\t\tif (!inventory) return;\n\t\treturn { systemPrompt: `${event.systemPrompt}\\n\\n${buildGitNexusPrompt(inventory, current)}` };\n\t});\n\n\tpi.registerCommand(\"gitnexus-login\", {\n\t\tdescription: \"Sign in to GitNexus (implementation of /login → GitNexus account; accepts a pasted token)\",\n\t\thandler: async (args, ctx) => {\n\t\t\tconst hubUrl = process.env.GITNEXUS_HUB_URL ?? DEFAULT_HUB_URL;\n\t\t\tconst pasted = args.trim();\n\n\t\t\t// Pasting a token stays supported for CI and headless installs.\n\t\t\tif (pasted) {\n\t\t\t\tawait new GitNexusClient({ hubUrl, token: pasted }).callTool(\"list_repos\", {});\n\t\t\t\tconst path = saveGitNexusConfig({ hubUrl, token: pasted });\n\t\t\t\tawait connect();\n\t\t\t\tctx.ui.notify(`GitNexus token saved to ${path}. ${startupNotice ?? \"\"}`, \"info\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst deviceName = defaultDeviceName();\n\t\t\t\tconst fingerprint = deviceFingerprint();\n\t\t\t\tconst start = await startDeviceAuth(hubUrl, { deviceName, deviceFingerprint: fingerprint });\n\t\t\t\tconst link = start.verificationUrlComplete ?? start.verificationUrl;\n\t\t\t\t// The link carries the code, so an opened browser needs no typing.\n\t\t\t\t// Print it too: the launcher is best effort and can be headless.\n\t\t\t\tctx.ui.notify(`Code ${start.userCode} — opening ${link}`, \"info\");\n\t\t\t\topenBrowser(link);\n\n\t\t\t\tconst result = await pollDeviceAuth(hubUrl, start);\n\t\t\t\tconst config = {\n\t\t\t\t\thubUrl: result.hubUrl,\n\t\t\t\t\ttoken: result.token,\n\t\t\t\t\tdeviceFingerprint: fingerprint,\n\t\t\t\t\tdeviceName,\n\t\t\t\t};\n\t\t\t\tawait new GitNexusClient(config).callTool(\"list_repos\", {});\n\t\t\t\tconst path = saveGitNexusConfig(config);\n\t\t\t\tawait connect();\n\t\t\t\tctx.ui.notify(`Signed in. Token saved to ${path}. ${startupNotice ?? \"\"}`, \"info\");\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tctx.ui.notify(`GitNexus login failed: ${message}`, \"error\");\n\t\t\t}\n\t\t},\n\t});\n\n\tpi.registerCommand(\"gitnexus-status\", {\n\t\tdescription: \"Show GitNexus connection status\",\n\t\thandler: async (_args, ctx) => {\n\t\t\tif (!inventory) {\n\t\t\t\tconst message = loginRequired\n\t\t\t\t\t? \"GitNexus session expired. Run /login to sign in again.\"\n\t\t\t\t\t: (startupNotice ?? \"GitNexus: not signed in. Run /login.\");\n\t\t\t\tctx.ui.notify(message, \"warning\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst repoLine = current ? `current repo: ${current.name}` : \"current repo: not indexed\";\n\t\t\tctx.ui.notify(`GitNexus: connected — ${inventory.repos.length} repos, ${repoLine}`, \"info\");\n\t\t},\n\t});\n}\n"]}

package/dist/extensions/gitnexus/observatory.d.ts

@@ -0,0 +1,13 @@
+import { GitNexusClient } from "./client.ts";
+import type { GitNexusConfig } from "./config.ts";
+/** Parse the hub cypher result: `{"markdown": "| a | b |\n| --- |...", "row_count": n}`. */
+export declare function parseCypherRows(text: string): string[][];
+export declare function fetchObservatory(client: GitNexusClient, repo: string): Promise<void>;
+/**
+ * Fetch the observatory in a detached child process and hand the result over
+ * via a temp file (picked up lazily by the landing panel / rail). In-process
+ * hub calls issued after startup can starve behind the session's own HTTP
+ * machinery in some environments; a fresh process never does.
+ */
+export declare function spawnObservatoryFetch(config: GitNexusConfig, repo: string): void;
+//# sourceMappingURL=observatory.d.ts.map

package/dist/extensions/gitnexus/observatory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observatory.d.ts","sourceRoot":"","sources":["../../../src/extensions/gitnexus/observatory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkClD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAiBxD;AAeD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBhF","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { appendFileSync } from \"node:fs\";\nimport { graphRailStore } from \"../../core/graph-rail-store.ts\";\nimport { observatoryCachePath } from \"../../core/observatory-cache.ts\";\nimport { GitNexusClient } from \"./client.ts\";\nimport type { GitNexusConfig } from \"./config.ts\";\n\nfunction trace(message: string): void {\n\tif (!process.env.NEXUS_TRACE) return;\n\ttry {\n\t\tappendFileSync(\"/tmp/nexus-observatory-trace.log\", `${new Date().toISOString()} ${message}\\n`);\n\t} catch {\n\t\t// tracing is best-effort\n\t}\n}\n\n/**\n * Startup graph observatory: fetches the community map of the current repo\n * (community sizes, cross-community call edges, flow count) and feeds the\n * rail store. Fire-and-forget — failures leave the observatory empty and\n * never surface to the user.\n */\n\nconst COMMUNITY_QUERY =\n\t\"MATCH (f)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community) \" +\n\t\"RETURN c.heuristicLabel AS name, count(f) AS members ORDER BY members DESC LIMIT 8\";\n\nconst EDGE_QUERY =\n\t\"MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(ca:Community), \" +\n\t\"(b)-[:CodeRelation {type:'MEMBER_OF'}]->(cb:Community), \" +\n\t\"(a)-[r:CodeRelation {type:'CALLS'}]->(b) \" +\n\t\"WHERE ca.heuristicLabel <> cb.heuristicLabel \" +\n\t\"RETURN ca.heuristicLabel AS source, cb.heuristicLabel AS target, count(r) AS weight \" +\n\t\"ORDER BY weight DESC LIMIT 16\";\n\nconst FLOW_QUERY = \"MATCH (p:Process) RETURN count(p) AS flows\";\n\nconst TIMEOUT_MS = 20_000;\n\n/** Parse the hub cypher result: `{\"markdown\": \"| a | b |\\n| --- |...\", \"row_count\": n}`. */\nexport function parseCypherRows(text: string): string[][] {\n\tlet markdown: string;\n\ttry {\n\t\tconst parsed = JSON.parse(text.split(\"\\n\\n---\")[0]?.trim() ?? \"\") as { markdown?: string };\n\t\tif (typeof parsed.markdown !== \"string\") return [];\n\t\tmarkdown = parsed.markdown;\n\t} catch {\n\t\treturn [];\n\t}\n\tconst lines = markdown.split(\"\\n\").filter((line) => line.trim().startsWith(\"|\"));\n\t// Drop header + separator rows.\n\treturn lines.slice(2).map((line) =>\n\t\tline\n\t\t\t.split(\"|\")\n\t\t\t.slice(1, -1)\n\t\t\t.map((cell) => cell.trim()),\n\t);\n}\n\nasync function runQuery(client: GitNexusClient, repo: string, query: string, label: string): Promise<string[][]> {\n\tconst start = Date.now();\n\ttrace(`${label}: start`);\n\ttry {\n\t\tconst result = await client.callTool(\"cypher\", { query, repo }, AbortSignal.timeout(TIMEOUT_MS));\n\t\ttrace(`${label}: ok in ${Date.now() - start}ms`);\n\t\treturn parseCypherRows(GitNexusClient.text(result));\n\t} catch (error) {\n\t\ttrace(`${label}: failed in ${Date.now() - start}ms: ${String(error)}`);\n\t\tthrow error;\n\t}\n}\n\nexport async function fetchObservatory(client: GitNexusClient, repo: string): Promise<void> {\n\ttry {\n\t\ttrace(`fetching for ${repo}`);\n\t\t// Sequential on purpose: parallel POSTs against one hub MCP session stall\n\t\t// behind per-session serialization; three sequential cyphers finish in ~2s.\n\t\tconst communityRows = await runQuery(client, repo, COMMUNITY_QUERY, \"communities\");\n\t\tconst edgeRows = await runQuery(client, repo, EDGE_QUERY, \"edges\");\n\t\tconst flowRows = await runQuery(client, repo, FLOW_QUERY, \"flows\");\n\t\ttrace(`rows: communities=${communityRows.length} edges=${edgeRows.length} flows=${flowRows.length}`);\n\t\tconst communities = communityRows\n\t\t\t.filter((row) => row[0])\n\t\t\t.map((row) => ({ name: row[0], members: Number(row[1]) || 0 }));\n\t\tif (communities.length === 0) return;\n\t\tconst known = new Set(communities.map((c) => c.name));\n\t\tconst edges = edgeRows\n\t\t\t.filter((row) => row[0] && row[1] && known.has(row[0]) && known.has(row[1]))\n\t\t\t.map((row) => ({ source: row[0], target: row[1], weight: Number(row[2]) || 0 }));\n\t\tconst flowCount = Number(flowRows[0]?.[0]);\n\t\tgraphRailStore.setObservatory({\n\t\t\tcommunities,\n\t\t\tedges,\n\t\t\t...(Number.isNaN(flowCount) ? {} : { flowCount }),\n\t\t});\n\t} catch (error) {\n\t\t// observatory is cosmetic — startup must never depend on it\n\t\ttrace(`fetch failed: ${String(error)}`);\n\t}\n}\n\n/**\n * Fetch the observatory in a detached child process and hand the result over\n * via a temp file (picked up lazily by the landing panel / rail). In-process\n * hub calls issued after startup can starve behind the session's own HTTP\n * machinery in some environments; a fresh process never does.\n */\nexport function spawnObservatoryFetch(config: GitNexusConfig, repo: string): void {\n\ttry {\n\t\tconst script = buildFetchScript();\n\t\tconst child = spawn(process.execPath, [\"-e\", script], {\n\t\t\tdetached: true,\n\t\t\tstdio: \"ignore\",\n\t\t\tenv: {\n\t\t\t\t...process.env,\n\t\t\t\tNEXUS_OBS_HUB_URL: config.hubUrl,\n\t\t\t\tNEXUS_OBS_TOKEN: config.token,\n\t\t\t\tNEXUS_OBS_REPO: repo,\n\t\t\t\tNEXUS_OBS_OUT: observatoryCachePath(repo),\n\t\t\t},\n\t\t});\n\t\tchild.unref();\n\t\ttrace(`spawned observatory fetcher pid=${child.pid ?? \"?\"} for ${repo}`);\n\t} catch (error) {\n\t\ttrace(`spawn failed: ${String(error)}`);\n\t}\n}\n\n/** Self-contained fetch script (plain node, no imports beyond fs). */\nfunction buildFetchScript(): string {\n\treturn `\nconst { writeFileSync } = require(\"node:fs\");\nconst hubUrl = process.env.NEXUS_OBS_HUB_URL;\nconst token = process.env.NEXUS_OBS_TOKEN;\nconst repo = process.env.NEXUS_OBS_REPO;\nconst out = process.env.NEXUS_OBS_OUT;\nlet sessionId;\nasync function post(body) {\n\tconst res = await fetch(hubUrl, {\n\t\tmethod: \"POST\",\n\t\theaders: {\n\t\t\t\"content-type\": \"application/json\",\n\t\t\taccept: \"application/json, text/event-stream\",\n\t\t\tauthorization: \"Bearer \" + token,\n\t\t\t...(sessionId ? { \"mcp-session-id\": sessionId } : {}),\n\t\t},\n\t\tbody: JSON.stringify(body),\n\t\tsignal: AbortSignal.timeout(20000),\n\t});\n\tconst sid = res.headers.get(\"mcp-session-id\");\n\tif (sid) sessionId = sid;\n\tconst text = await res.text();\n\tif (res.status === 202) return undefined;\n\tif (!res.ok) throw new Error(\"hub HTTP \" + res.status);\n\tif ((res.headers.get(\"content-type\") || \"\").includes(\"text/event-stream\")) {\n\t\tlet last;\n\t\tfor (const ev of text.split(\"\\\\n\\\\n\")) {\n\t\t\tconst data = ev.split(\"\\\\n\").filter((l) => l.startsWith(\"data:\")).map((l) => l.slice(5).trim()).join(\"\\\\n\");\n\t\t\tif (!data) continue;\n\t\t\ttry { const p = JSON.parse(data); if (p.id !== undefined && p.id !== null) last = p; } catch {}\n\t\t}\n\t\treturn last;\n\t}\n\treturn text ? JSON.parse(text) : undefined;\n}\nlet nextId = 1;\nasync function call(name, args) {\n\tconst r = await post({ jsonrpc: \"2.0\", id: nextId++, method: \"tools/call\", params: { name, arguments: args } });\n\tif (!r || r.error) throw new Error(r && r.error ? r.error.message : \"empty response\");\n\tconst parts = (r.result && r.result.content) || [];\n\treturn parts.filter((p) => p.type === \"text\").map((p) => p.text).join(\"\\\\n\");\n}\nfunction rows(text) {\n\tlet md;\n\ttry { md = JSON.parse((text.split(\"\\\\n\\\\n---\")[0] || \"\").trim()).markdown; } catch { return []; }\n\tif (typeof md !== \"string\") return [];\n\tconst lines = md.split(\"\\\\n\").filter((l) => l.trim().startsWith(\"|\"));\n\treturn lines.slice(2).map((l) => l.split(\"|\").slice(1, -1).map((c) => c.trim()));\n}\n(async () => {\n\tawait post({ jsonrpc: \"2.0\", id: nextId++, method: \"initialize\", params: { protocolVersion: \"2025-06-18\", capabilities: {}, clientInfo: { name: \"nexus-observatory\", version: \"0.1.0\" } } });\n\tawait post({ jsonrpc: \"2.0\", method: \"notifications/initialized\" });\n\tconst communityRows = rows(await call(\"cypher\", { repo, query: \"MATCH (f)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community) RETURN c.heuristicLabel AS name, count(f) AS members ORDER BY members DESC LIMIT 8\" }));\n\tconst edgeRows = rows(await call(\"cypher\", { repo, query: \"MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(ca:Community), (b)-[:CodeRelation {type:'MEMBER_OF'}]->(cb:Community), (a)-[r:CodeRelation {type:'CALLS'}]->(b) WHERE ca.heuristicLabel <> cb.heuristicLabel RETURN ca.heuristicLabel AS source, cb.heuristicLabel AS target, count(r) AS weight ORDER BY weight DESC LIMIT 16\" }));\n\tconst flowRows = rows(await call(\"cypher\", { repo, query: \"MATCH (p:Process) RETURN count(p) AS flows\" }));\n\tconst communities = communityRows.filter((r) => r[0]).map((r) => ({ name: r[0], members: Number(r[1]) || 0 }));\n\tif (!communities.length) process.exit(0);\n\tconst known = new Set(communities.map((c) => c.name));\n\tconst edges = edgeRows.filter((r) => r[0] && r[1] && known.has(r[0]) && known.has(r[1])).map((r) => ({ source: r[0], target: r[1], weight: Number(r[2]) || 0 }));\n\tconst flowCount = Number(flowRows[0] && flowRows[0][0]);\n\tconst payload = { communities, edges, ...(Number.isNaN(flowCount) ? {} : { flowCount }), fetchedAt: Date.now() };\n\twriteFileSync(out, JSON.stringify(payload));\n\tprocess.exit(0);\n})().catch(() => process.exit(1));\n`;\n}\n"]}

package/dist/extensions/gitnexus/observatory.js

@@ -0,0 +1,189 @@
+import { spawn } from "node:child_process";
+import { appendFileSync } from "node:fs";
+import { graphRailStore } from "../../core/graph-rail-store.js";
+import { observatoryCachePath } from "../../core/observatory-cache.js";
+import { GitNexusClient } from "./client.js";
+function trace(message) {
+    if (!process.env.NEXUS_TRACE)
+        return;
+    try {
+        appendFileSync("/tmp/nexus-observatory-trace.log", `${new Date().toISOString()} ${message}\n`);
+    }
+    catch {
+        // tracing is best-effort
+    }
+}
+/**
+ * Startup graph observatory: fetches the community map of the current repo
+ * (community sizes, cross-community call edges, flow count) and feeds the
+ * rail store. Fire-and-forget — failures leave the observatory empty and
+ * never surface to the user.
+ */
+const COMMUNITY_QUERY = "MATCH (f)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community) " +
+    "RETURN c.heuristicLabel AS name, count(f) AS members ORDER BY members DESC LIMIT 8";
+const EDGE_QUERY = "MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(ca:Community), " +
+    "(b)-[:CodeRelation {type:'MEMBER_OF'}]->(cb:Community), " +
+    "(a)-[r:CodeRelation {type:'CALLS'}]->(b) " +
+    "WHERE ca.heuristicLabel <> cb.heuristicLabel " +
+    "RETURN ca.heuristicLabel AS source, cb.heuristicLabel AS target, count(r) AS weight " +
+    "ORDER BY weight DESC LIMIT 16";
+const FLOW_QUERY = "MATCH (p:Process) RETURN count(p) AS flows";
+const TIMEOUT_MS = 20_000;
+/** Parse the hub cypher result: `{"markdown": "| a | b |\n| --- |...", "row_count": n}`. */
+export function parseCypherRows(text) {
+    let markdown;
+    try {
+        const parsed = JSON.parse(text.split("\n\n---")[0]?.trim() ?? "");
+        if (typeof parsed.markdown !== "string")
+            return [];
+        markdown = parsed.markdown;
+    }
+    catch {
+        return [];
+    }
+    const lines = markdown.split("\n").filter((line) => line.trim().startsWith("|"));
+    // Drop header + separator rows.
+    return lines.slice(2).map((line) => line
+        .split("|")
+        .slice(1, -1)
+        .map((cell) => cell.trim()));
+}
+async function runQuery(client, repo, query, label) {
+    const start = Date.now();
+    trace(`${label}: start`);
+    try {
+        const result = await client.callTool("cypher", { query, repo }, AbortSignal.timeout(TIMEOUT_MS));
+        trace(`${label}: ok in ${Date.now() - start}ms`);
+        return parseCypherRows(GitNexusClient.text(result));
+    }
+    catch (error) {
+        trace(`${label}: failed in ${Date.now() - start}ms: ${String(error)}`);
+        throw error;
+    }
+}
+export async function fetchObservatory(client, repo) {
+    try {
+        trace(`fetching for ${repo}`);
+        // Sequential on purpose: parallel POSTs against one hub MCP session stall
+        // behind per-session serialization; three sequential cyphers finish in ~2s.
+        const communityRows = await runQuery(client, repo, COMMUNITY_QUERY, "communities");
+        const edgeRows = await runQuery(client, repo, EDGE_QUERY, "edges");
+        const flowRows = await runQuery(client, repo, FLOW_QUERY, "flows");
+        trace(`rows: communities=${communityRows.length} edges=${edgeRows.length} flows=${flowRows.length}`);
+        const communities = communityRows
+            .filter((row) => row[0])
+            .map((row) => ({ name: row[0], members: Number(row[1]) || 0 }));
+        if (communities.length === 0)
+            return;
+        const known = new Set(communities.map((c) => c.name));
+        const edges = edgeRows
+            .filter((row) => row[0] && row[1] && known.has(row[0]) && known.has(row[1]))
+            .map((row) => ({ source: row[0], target: row[1], weight: Number(row[2]) || 0 }));
+        const flowCount = Number(flowRows[0]?.[0]);
+        graphRailStore.setObservatory({
+            communities,
+            edges,
+            ...(Number.isNaN(flowCount) ? {} : { flowCount }),
+        });
+    }
+    catch (error) {
+        // observatory is cosmetic — startup must never depend on it
+        trace(`fetch failed: ${String(error)}`);
+    }
+}
+/**
+ * Fetch the observatory in a detached child process and hand the result over
+ * via a temp file (picked up lazily by the landing panel / rail). In-process
+ * hub calls issued after startup can starve behind the session's own HTTP
+ * machinery in some environments; a fresh process never does.
+ */
+export function spawnObservatoryFetch(config, repo) {
+    try {
+        const script = buildFetchScript();
+        const child = spawn(process.execPath, ["-e", script], {
+            detached: true,
+            stdio: "ignore",
+            env: {
+                ...process.env,
+                NEXUS_OBS_HUB_URL: config.hubUrl,
+                NEXUS_OBS_TOKEN: config.token,
+                NEXUS_OBS_REPO: repo,
+                NEXUS_OBS_OUT: observatoryCachePath(repo),
+            },
+        });
+        child.unref();
+        trace(`spawned observatory fetcher pid=${child.pid ?? "?"} for ${repo}`);
+    }
+    catch (error) {
+        trace(`spawn failed: ${String(error)}`);
+    }
+}
+/** Self-contained fetch script (plain node, no imports beyond fs). */
+function buildFetchScript() {
+    return `
+const { writeFileSync } = require("node:fs");
+const hubUrl = process.env.NEXUS_OBS_HUB_URL;
+const token = process.env.NEXUS_OBS_TOKEN;
+const repo = process.env.NEXUS_OBS_REPO;
+const out = process.env.NEXUS_OBS_OUT;
+let sessionId;
+async function post(body) {
+	const res = await fetch(hubUrl, {
+		method: "POST",
+		headers: {
+			"content-type": "application/json",
+			accept: "application/json, text/event-stream",
+			authorization: "Bearer " + token,
+			...(sessionId ? { "mcp-session-id": sessionId } : {}),
+		},
+		body: JSON.stringify(body),
+		signal: AbortSignal.timeout(20000),
+	});
+	const sid = res.headers.get("mcp-session-id");
+	if (sid) sessionId = sid;
+	const text = await res.text();
+	if (res.status === 202) return undefined;
+	if (!res.ok) throw new Error("hub HTTP " + res.status);
+	if ((res.headers.get("content-type") || "").includes("text/event-stream")) {
+		let last;
+		for (const ev of text.split("\\n\\n")) {
+			const data = ev.split("\\n").filter((l) => l.startsWith("data:")).map((l) => l.slice(5).trim()).join("\\n");
+			if (!data) continue;
+			try { const p = JSON.parse(data); if (p.id !== undefined && p.id !== null) last = p; } catch {}
+		}
+		return last;
+	}
+	return text ? JSON.parse(text) : undefined;
+}
+let nextId = 1;
+async function call(name, args) {
+	const r = await post({ jsonrpc: "2.0", id: nextId++, method: "tools/call", params: { name, arguments: args } });
+	if (!r || r.error) throw new Error(r && r.error ? r.error.message : "empty response");
+	const parts = (r.result && r.result.content) || [];
+	return parts.filter((p) => p.type === "text").map((p) => p.text).join("\\n");
+}
+function rows(text) {
+	let md;
+	try { md = JSON.parse((text.split("\\n\\n---")[0] || "").trim()).markdown; } catch { return []; }
+	if (typeof md !== "string") return [];
+	const lines = md.split("\\n").filter((l) => l.trim().startsWith("|"));
+	return lines.slice(2).map((l) => l.split("|").slice(1, -1).map((c) => c.trim()));
+}
+(async () => {
+	await post({ jsonrpc: "2.0", id: nextId++, method: "initialize", params: { protocolVersion: "2025-06-18", capabilities: {}, clientInfo: { name: "nexus-observatory", version: "0.1.0" } } });
+	await post({ jsonrpc: "2.0", method: "notifications/initialized" });
+	const communityRows = rows(await call("cypher", { repo, query: "MATCH (f)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community) RETURN c.heuristicLabel AS name, count(f) AS members ORDER BY members DESC LIMIT 8" }));
+	const edgeRows = rows(await call("cypher", { repo, query: "MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(ca:Community), (b)-[:CodeRelation {type:'MEMBER_OF'}]->(cb:Community), (a)-[r:CodeRelation {type:'CALLS'}]->(b) WHERE ca.heuristicLabel <> cb.heuristicLabel RETURN ca.heuristicLabel AS source, cb.heuristicLabel AS target, count(r) AS weight ORDER BY weight DESC LIMIT 16" }));
+	const flowRows = rows(await call("cypher", { repo, query: "MATCH (p:Process) RETURN count(p) AS flows" }));
+	const communities = communityRows.filter((r) => r[0]).map((r) => ({ name: r[0], members: Number(r[1]) || 0 }));
+	if (!communities.length) process.exit(0);
+	const known = new Set(communities.map((c) => c.name));
+	const edges = edgeRows.filter((r) => r[0] && r[1] && known.has(r[0]) && known.has(r[1])).map((r) => ({ source: r[0], target: r[1], weight: Number(r[2]) || 0 }));
+	const flowCount = Number(flowRows[0] && flowRows[0][0]);
+	const payload = { communities, edges, ...(Number.isNaN(flowCount) ? {} : { flowCount }), fetchedAt: Date.now() };
+	writeFileSync(out, JSON.stringify(payload));
+	process.exit(0);
+})().catch(() => process.exit(1));
+`;
+}
+//# sourceMappingURL=observatory.js.map

package/dist/extensions/gitnexus/observatory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observatory.js","sourceRoot":"","sources":["../../../src/extensions/gitnexus/observatory.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { appendFileSync } from \"node:fs\";\nimport { graphRailStore } from \"../../core/graph-rail-store.ts\";\nimport { observatoryCachePath } from \"../../core/observatory-cache.ts\";\nimport { GitNexusClient } from \"./client.ts\";\nimport type { GitNexusConfig } from \"./config.ts\";\n\nfunction trace(message: string): void {\n\tif (!process.env.NEXUS_TRACE) return;\n\ttry {\n\t\tappendFileSync(\"/tmp/nexus-observatory-trace.log\", `${new Date().toISOString()} ${message}\\n`);\n\t} catch {\n\t\t// tracing is best-effort\n\t}\n}\n\n/**\n * Startup graph observatory: fetches the community map of the current repo\n * (community sizes, cross-community call edges, flow count) and feeds the\n * rail store. Fire-and-forget — failures leave the observatory empty and\n * never surface to the user.\n */\n\nconst COMMUNITY_QUERY =\n\t\"MATCH (f)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community) \" +\n\t\"RETURN c.heuristicLabel AS name, count(f) AS members ORDER BY members DESC LIMIT 8\";\n\nconst EDGE_QUERY =\n\t\"MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(ca:Community), \" +\n\t\"(b)-[:CodeRelation {type:'MEMBER_OF'}]->(cb:Community), \" +\n\t\"(a)-[r:CodeRelation {type:'CALLS'}]->(b) \" +\n\t\"WHERE ca.heuristicLabel <> cb.heuristicLabel \" +\n\t\"RETURN ca.heuristicLabel AS source, cb.heuristicLabel AS target, count(r) AS weight \" +\n\t\"ORDER BY weight DESC LIMIT 16\";\n\nconst FLOW_QUERY = \"MATCH (p:Process) RETURN count(p) AS flows\";\n\nconst TIMEOUT_MS = 20_000;\n\n/** Parse the hub cypher result: `{\"markdown\": \"| a | b |\\n| --- |...\", \"row_count\": n}`. */\nexport function parseCypherRows(text: string): string[][] {\n\tlet markdown: string;\n\ttry {\n\t\tconst parsed = JSON.parse(text.split(\"\\n\\n---\")[0]?.trim() ?? \"\") as { markdown?: string };\n\t\tif (typeof parsed.markdown !== \"string\") return [];\n\t\tmarkdown = parsed.markdown;\n\t} catch {\n\t\treturn [];\n\t}\n\tconst lines = markdown.split(\"\\n\").filter((line) => line.trim().startsWith(\"|\"));\n\t// Drop header + separator rows.\n\treturn lines.slice(2).map((line) =>\n\t\tline\n\t\t\t.split(\"|\")\n\t\t\t.slice(1, -1)\n\t\t\t.map((cell) => cell.trim()),\n\t);\n}\n\nasync function runQuery(client: GitNexusClient, repo: string, query: string, label: string): Promise<string[][]> {\n\tconst start = Date.now();\n\ttrace(`${label}: start`);\n\ttry {\n\t\tconst result = await client.callTool(\"cypher\", { query, repo }, AbortSignal.timeout(TIMEOUT_MS));\n\t\ttrace(`${label}: ok in ${Date.now() - start}ms`);\n\t\treturn parseCypherRows(GitNexusClient.text(result));\n\t} catch (error) {\n\t\ttrace(`${label}: failed in ${Date.now() - start}ms: ${String(error)}`);\n\t\tthrow error;\n\t}\n}\n\nexport async function fetchObservatory(client: GitNexusClient, repo: string): Promise<void> {\n\ttry {\n\t\ttrace(`fetching for ${repo}`);\n\t\t// Sequential on purpose: parallel POSTs against one hub MCP session stall\n\t\t// behind per-session serialization; three sequential cyphers finish in ~2s.\n\t\tconst communityRows = await runQuery(client, repo, COMMUNITY_QUERY, \"communities\");\n\t\tconst edgeRows = await runQuery(client, repo, EDGE_QUERY, \"edges\");\n\t\tconst flowRows = await runQuery(client, repo, FLOW_QUERY, \"flows\");\n\t\ttrace(`rows: communities=${communityRows.length} edges=${edgeRows.length} flows=${flowRows.length}`);\n\t\tconst communities = communityRows\n\t\t\t.filter((row) => row[0])\n\t\t\t.map((row) => ({ name: row[0], members: Number(row[1]) || 0 }));\n\t\tif (communities.length === 0) return;\n\t\tconst known = new Set(communities.map((c) => c.name));\n\t\tconst edges = edgeRows\n\t\t\t.filter((row) => row[0] && row[1] && known.has(row[0]) && known.has(row[1]))\n\t\t\t.map((row) => ({ source: row[0], target: row[1], weight: Number(row[2]) || 0 }));\n\t\tconst flowCount = Number(flowRows[0]?.[0]);\n\t\tgraphRailStore.setObservatory({\n\t\t\tcommunities,\n\t\t\tedges,\n\t\t\t...(Number.isNaN(flowCount) ? {} : { flowCount }),\n\t\t});\n\t} catch (error) {\n\t\t// observatory is cosmetic — startup must never depend on it\n\t\ttrace(`fetch failed: ${String(error)}`);\n\t}\n}\n\n/**\n * Fetch the observatory in a detached child process and hand the result over\n * via a temp file (picked up lazily by the landing panel / rail). In-process\n * hub calls issued after startup can starve behind the session's own HTTP\n * machinery in some environments; a fresh process never does.\n */\nexport function spawnObservatoryFetch(config: GitNexusConfig, repo: string): void {\n\ttry {\n\t\tconst script = buildFetchScript();\n\t\tconst child = spawn(process.execPath, [\"-e\", script], {\n\t\t\tdetached: true,\n\t\t\tstdio: \"ignore\",\n\t\t\tenv: {\n\t\t\t\t...process.env,\n\t\t\t\tNEXUS_OBS_HUB_URL: config.hubUrl,\n\t\t\t\tNEXUS_OBS_TOKEN: config.token,\n\t\t\t\tNEXUS_OBS_REPO: repo,\n\t\t\t\tNEXUS_OBS_OUT: observatoryCachePath(repo),\n\t\t\t},\n\t\t});\n\t\tchild.unref();\n\t\ttrace(`spawned observatory fetcher pid=${child.pid ?? \"?\"} for ${repo}`);\n\t} catch (error) {\n\t\ttrace(`spawn failed: ${String(error)}`);\n\t}\n}\n\n/** Self-contained fetch script (plain node, no imports beyond fs). */\nfunction buildFetchScript(): string {\n\treturn `\nconst { writeFileSync } = require(\"node:fs\");\nconst hubUrl = process.env.NEXUS_OBS_HUB_URL;\nconst token = process.env.NEXUS_OBS_TOKEN;\nconst repo = process.env.NEXUS_OBS_REPO;\nconst out = process.env.NEXUS_OBS_OUT;\nlet sessionId;\nasync function post(body) {\n\tconst res = await fetch(hubUrl, {\n\t\tmethod: \"POST\",\n\t\theaders: {\n\t\t\t\"content-type\": \"application/json\",\n\t\t\taccept: \"application/json, text/event-stream\",\n\t\t\tauthorization: \"Bearer \" + token,\n\t\t\t...(sessionId ? { \"mcp-session-id\": sessionId } : {}),\n\t\t},\n\t\tbody: JSON.stringify(body),\n\t\tsignal: AbortSignal.timeout(20000),\n\t});\n\tconst sid = res.headers.get(\"mcp-session-id\");\n\tif (sid) sessionId = sid;\n\tconst text = await res.text();\n\tif (res.status === 202) return undefined;\n\tif (!res.ok) throw new Error(\"hub HTTP \" + res.status);\n\tif ((res.headers.get(\"content-type\") || \"\").includes(\"text/event-stream\")) {\n\t\tlet last;\n\t\tfor (const ev of text.split(\"\\\\n\\\\n\")) {\n\t\t\tconst data = ev.split(\"\\\\n\").filter((l) => l.startsWith(\"data:\")).map((l) => l.slice(5).trim()).join(\"\\\\n\");\n\t\t\tif (!data) continue;\n\t\t\ttry { const p = JSON.parse(data); if (p.id !== undefined && p.id !== null) last = p; } catch {}\n\t\t}\n\t\treturn last;\n\t}\n\treturn text ? JSON.parse(text) : undefined;\n}\nlet nextId = 1;\nasync function call(name, args) {\n\tconst r = await post({ jsonrpc: \"2.0\", id: nextId++, method: \"tools/call\", params: { name, arguments: args } });\n\tif (!r || r.error) throw new Error(r && r.error ? r.error.message : \"empty response\");\n\tconst parts = (r.result && r.result.content) || [];\n\treturn parts.filter((p) => p.type === \"text\").map((p) => p.text).join(\"\\\\n\");\n}\nfunction rows(text) {\n\tlet md;\n\ttry { md = JSON.parse((text.split(\"\\\\n\\\\n---\")[0] || \"\").trim()).markdown; } catch { return []; }\n\tif (typeof md !== \"string\") return [];\n\tconst lines = md.split(\"\\\\n\").filter((l) => l.trim().startsWith(\"|\"));\n\treturn lines.slice(2).map((l) => l.split(\"|\").slice(1, -1).map((c) => c.trim()));\n}\n(async () => {\n\tawait post({ jsonrpc: \"2.0\", id: nextId++, method: \"initialize\", params: { protocolVersion: \"2025-06-18\", capabilities: {}, clientInfo: { name: \"nexus-observatory\", version: \"0.1.0\" } } });\n\tawait post({ jsonrpc: \"2.0\", method: \"notifications/initialized\" });\n\tconst communityRows = rows(await call(\"cypher\", { repo, query: \"MATCH (f)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community) RETURN c.heuristicLabel AS name, count(f) AS members ORDER BY members DESC LIMIT 8\" }));\n\tconst edgeRows = rows(await call(\"cypher\", { repo, query: \"MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(ca:Community), (b)-[:CodeRelation {type:'MEMBER_OF'}]->(cb:Community), (a)-[r:CodeRelation {type:'CALLS'}]->(b) WHERE ca.heuristicLabel <> cb.heuristicLabel RETURN ca.heuristicLabel AS source, cb.heuristicLabel AS target, count(r) AS weight ORDER BY weight DESC LIMIT 16\" }));\n\tconst flowRows = rows(await call(\"cypher\", { repo, query: \"MATCH (p:Process) RETURN count(p) AS flows\" }));\n\tconst communities = communityRows.filter((r) => r[0]).map((r) => ({ name: r[0], members: Number(r[1]) || 0 }));\n\tif (!communities.length) process.exit(0);\n\tconst known = new Set(communities.map((c) => c.name));\n\tconst edges = edgeRows.filter((r) => r[0] && r[1] && known.has(r[0]) && known.has(r[1])).map((r) => ({ source: r[0], target: r[1], weight: Number(r[2]) || 0 }));\n\tconst flowCount = Number(flowRows[0] && flowRows[0][0]);\n\tconst payload = { communities, edges, ...(Number.isNaN(flowCount) ? {} : { flowCount }), fetchedAt: Date.now() };\n\twriteFileSync(out, JSON.stringify(payload));\n\tprocess.exit(0);\n})().catch(() => process.exit(1));\n`;\n}\n"]}

package/dist/extensions/gitnexus/prompt.d.ts

@@ -0,0 +1,11 @@
+import type { IndexedRepo, RepoInventory } from "./resolve.ts";
+/**
+ * The always-on GitNexus guidance appended to the system prompt.
+ *
+ * Ported from what `gitnexus` writes into CLAUDE.md/AGENTS.md today
+ * (gitnexus/src/cli/ai-context.ts generateGitNexusContent) — same rules, made
+ * dynamic: live repo inventory, current-repo stats, snapshot caveat. Keep this
+ * in sync with the generator until both share a single template.
+ */
+export declare function buildGitNexusPrompt(inventory: RepoInventory, current: IndexedRepo | undefined): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/extensions/gitnexus/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/extensions/gitnexus/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAqDtG","sourcesContent":["import type { IndexedRepo, RepoInventory } from \"./resolve.ts\";\n\n/**\n * The always-on GitNexus guidance appended to the system prompt.\n *\n * Ported from what `gitnexus` writes into CLAUDE.md/AGENTS.md today\n * (gitnexus/src/cli/ai-context.ts generateGitNexusContent) — same rules, made\n * dynamic: live repo inventory, current-repo stats, snapshot caveat. Keep this\n * in sync with the generator until both share a single template.\n */\nexport function buildGitNexusPrompt(inventory: RepoInventory, current: IndexedRepo | undefined): string {\n\tconst lines: string[] = [];\n\tlines.push(\"# GitNexus — Code Intelligence\");\n\tlines.push(\"\");\n\tif (current) {\n\t\tlines.push(\n\t\t\t`The current repository is indexed by GitNexus as **${current.name}** ` +\n\t\t\t\t`(${current.symbols} symbols, ${current.relationships} relationships, indexed ${current.indexedAt}).`,\n\t\t);\n\t} else {\n\t\tlines.push(\n\t\t\t\"The current working directory is NOT indexed by GitNexus. Graph tools still work for the indexed repositories listed below (pass `repo` explicitly).\",\n\t\t);\n\t}\n\tlines.push(\n\t\t\"The graph is a snapshot from the indexed time — for files changed after that (including your own edits this session), verify with read/grep.\",\n\t);\n\tlines.push(\"\");\n\tconst repoList = inventory.repos.map((r) => (r.name === current?.name ? `${r.name} (current)` : r.name)).join(\", \");\n\tlines.push(`Indexed repositories you can query: ${repoList || \"(none)\"}.`);\n\tif (inventory.groups.length > 0) {\n\t\tlines.push(\n\t\t\t`Multi-repo groups (pass as repo for cross-repo queries): ${inventory.groups.map((g) => g.name).join(\", \")}.`,\n\t\t);\n\t}\n\tlines.push(\n\t\t\"Every gitnexus tool takes an optional `repo` — omit it for the current repo, or pass any name/@group above.\",\n\t);\n\tlines.push(\"\");\n\tlines.push(\"## Always\");\n\tlines.push(\n\t\t\"- Run `gitnexus_impact({target})` BEFORE modifying a function/class/method, and report the blast radius (direct callers, processes, risk) when it is HIGH or CRITICAL.\",\n\t);\n\tlines.push(\n\t\t\"- When exploring unfamiliar code, prefer `gitnexus_query` (execution flows, ranked) over blind grepping.\",\n\t);\n\tlines.push(\"- For full context on one symbol (callers, callees, flows), use `gitnexus_context`.\");\n\tlines.push(\"- Before committing, use `gitnexus_detect_changes` to map your diff to affected flows.\");\n\tlines.push(\"\");\n\tlines.push(\"## Never\");\n\tlines.push(\"- Never ignore a HIGH or CRITICAL risk result from impact analysis.\");\n\tlines.push(\"- Never edit a graph-known symbol without having checked its blast radius first.\");\n\tlines.push(\"\");\n\tlines.push(\"## Impact risk levels\");\n\tlines.push(\"- d=1 WILL BREAK — direct callers/importers: you MUST update these.\");\n\tlines.push(\"- d=2 LIKELY AFFECTED — indirect dependents: should test.\");\n\tlines.push(\"- d=3 MAY NEED TESTING — transitive: test if on a critical path.\");\n\tlines.push(\"\");\n\tlines.push(\"## Before finishing a code change\");\n\tlines.push(\"1. `gitnexus_impact` was run for every modified symbol.\");\n\tlines.push(\"2. No HIGH/CRITICAL warnings were ignored.\");\n\tlines.push(\"3. All d=1 dependents were updated.\");\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/extensions/gitnexus/prompt.js

@@ -0,0 +1,50 @@
+/**
+ * The always-on GitNexus guidance appended to the system prompt.
+ *
+ * Ported from what `gitnexus` writes into CLAUDE.md/AGENTS.md today
+ * (gitnexus/src/cli/ai-context.ts generateGitNexusContent) — same rules, made
+ * dynamic: live repo inventory, current-repo stats, snapshot caveat. Keep this
+ * in sync with the generator until both share a single template.
+ */
+export function buildGitNexusPrompt(inventory, current) {
+    const lines = [];
+    lines.push("# GitNexus — Code Intelligence");
+    lines.push("");
+    if (current) {
+        lines.push(`The current repository is indexed by GitNexus as **${current.name}** ` +
+            `(${current.symbols} symbols, ${current.relationships} relationships, indexed ${current.indexedAt}).`);
+    }
+    else {
+        lines.push("The current working directory is NOT indexed by GitNexus. Graph tools still work for the indexed repositories listed below (pass `repo` explicitly).");
+    }
+    lines.push("The graph is a snapshot from the indexed time — for files changed after that (including your own edits this session), verify with read/grep.");
+    lines.push("");
+    const repoList = inventory.repos.map((r) => (r.name === current?.name ? `${r.name} (current)` : r.name)).join(", ");
+    lines.push(`Indexed repositories you can query: ${repoList || "(none)"}.`);
+    if (inventory.groups.length > 0) {
+        lines.push(`Multi-repo groups (pass as repo for cross-repo queries): ${inventory.groups.map((g) => g.name).join(", ")}.`);
+    }
+    lines.push("Every gitnexus tool takes an optional `repo` — omit it for the current repo, or pass any name/@group above.");
+    lines.push("");
+    lines.push("## Always");
+    lines.push("- Run `gitnexus_impact({target})` BEFORE modifying a function/class/method, and report the blast radius (direct callers, processes, risk) when it is HIGH or CRITICAL.");
+    lines.push("- When exploring unfamiliar code, prefer `gitnexus_query` (execution flows, ranked) over blind grepping.");
+    lines.push("- For full context on one symbol (callers, callees, flows), use `gitnexus_context`.");
+    lines.push("- Before committing, use `gitnexus_detect_changes` to map your diff to affected flows.");
+    lines.push("");
+    lines.push("## Never");
+    lines.push("- Never ignore a HIGH or CRITICAL risk result from impact analysis.");
+    lines.push("- Never edit a graph-known symbol without having checked its blast radius first.");
+    lines.push("");
+    lines.push("## Impact risk levels");
+    lines.push("- d=1 WILL BREAK — direct callers/importers: you MUST update these.");
+    lines.push("- d=2 LIKELY AFFECTED — indirect dependents: should test.");
+    lines.push("- d=3 MAY NEED TESTING — transitive: test if on a critical path.");
+    lines.push("");
+    lines.push("## Before finishing a code change");
+    lines.push("1. `gitnexus_impact` was run for every modified symbol.");
+    lines.push("2. No HIGH/CRITICAL warnings were ignored.");
+    lines.push("3. All d=1 dependents were updated.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/extensions/gitnexus/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/extensions/gitnexus/prompt.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAwB,EAAE,OAAgC,EAAU;IACvG,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,kCAAgC,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,OAAO,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CACT,sDAAsD,OAAO,CAAC,IAAI,KAAK;YACtE,IAAI,OAAO,CAAC,OAAO,aAAa,OAAO,CAAC,aAAa,2BAA2B,OAAO,CAAC,SAAS,IAAI,CACtG,CAAC;IACH,CAAC;SAAM,CAAC;QACP,KAAK,CAAC,IAAI,CACT,sJAAsJ,CACtJ,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CACT,gJAA8I,CAC9I,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpH,KAAK,CAAC,IAAI,CAAC,uCAAuC,QAAQ,IAAI,QAAQ,GAAG,CAAC,CAAC;IAC3E,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CACT,4DAA4D,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7G,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CACT,+GAA6G,CAC7G,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CACT,wKAAwK,CACxK,CAAC;IACF,KAAK,CAAC,IAAI,CACT,0GAA0G,CAC1G,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;IAClG,KAAK,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;IACrG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;IAC/F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,uEAAqE,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,6DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,oEAAkE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACxB","sourcesContent":["import type { IndexedRepo, RepoInventory } from \"./resolve.ts\";\n\n/**\n * The always-on GitNexus guidance appended to the system prompt.\n *\n * Ported from what `gitnexus` writes into CLAUDE.md/AGENTS.md today\n * (gitnexus/src/cli/ai-context.ts generateGitNexusContent) — same rules, made\n * dynamic: live repo inventory, current-repo stats, snapshot caveat. Keep this\n * in sync with the generator until both share a single template.\n */\nexport function buildGitNexusPrompt(inventory: RepoInventory, current: IndexedRepo | undefined): string {\n\tconst lines: string[] = [];\n\tlines.push(\"# GitNexus — Code Intelligence\");\n\tlines.push(\"\");\n\tif (current) {\n\t\tlines.push(\n\t\t\t`The current repository is indexed by GitNexus as **${current.name}** ` +\n\t\t\t\t`(${current.symbols} symbols, ${current.relationships} relationships, indexed ${current.indexedAt}).`,\n\t\t);\n\t} else {\n\t\tlines.push(\n\t\t\t\"The current working directory is NOT indexed by GitNexus. Graph tools still work for the indexed repositories listed below (pass `repo` explicitly).\",\n\t\t);\n\t}\n\tlines.push(\n\t\t\"The graph is a snapshot from the indexed time — for files changed after that (including your own edits this session), verify with read/grep.\",\n\t);\n\tlines.push(\"\");\n\tconst repoList = inventory.repos.map((r) => (r.name === current?.name ? `${r.name} (current)` : r.name)).join(\", \");\n\tlines.push(`Indexed repositories you can query: ${repoList || \"(none)\"}.`);\n\tif (inventory.groups.length > 0) {\n\t\tlines.push(\n\t\t\t`Multi-repo groups (pass as repo for cross-repo queries): ${inventory.groups.map((g) => g.name).join(\", \")}.`,\n\t\t);\n\t}\n\tlines.push(\n\t\t\"Every gitnexus tool takes an optional `repo` — omit it for the current repo, or pass any name/@group above.\",\n\t);\n\tlines.push(\"\");\n\tlines.push(\"## Always\");\n\tlines.push(\n\t\t\"- Run `gitnexus_impact({target})` BEFORE modifying a function/class/method, and report the blast radius (direct callers, processes, risk) when it is HIGH or CRITICAL.\",\n\t);\n\tlines.push(\n\t\t\"- When exploring unfamiliar code, prefer `gitnexus_query` (execution flows, ranked) over blind grepping.\",\n\t);\n\tlines.push(\"- For full context on one symbol (callers, callees, flows), use `gitnexus_context`.\");\n\tlines.push(\"- Before committing, use `gitnexus_detect_changes` to map your diff to affected flows.\");\n\tlines.push(\"\");\n\tlines.push(\"## Never\");\n\tlines.push(\"- Never ignore a HIGH or CRITICAL risk result from impact analysis.\");\n\tlines.push(\"- Never edit a graph-known symbol without having checked its blast radius first.\");\n\tlines.push(\"\");\n\tlines.push(\"## Impact risk levels\");\n\tlines.push(\"- d=1 WILL BREAK — direct callers/importers: you MUST update these.\");\n\tlines.push(\"- d=2 LIKELY AFFECTED — indirect dependents: should test.\");\n\tlines.push(\"- d=3 MAY NEED TESTING — transitive: test if on a critical path.\");\n\tlines.push(\"\");\n\tlines.push(\"## Before finishing a code change\");\n\tlines.push(\"1. `gitnexus_impact` was run for every modified symbol.\");\n\tlines.push(\"2. No HIGH/CRITICAL warnings were ignored.\");\n\tlines.push(\"3. All d=1 dependents were updated.\");\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/extensions/gitnexus/render.d.ts

@@ -0,0 +1,61 @@
+import type { ToolDefinition } from "../../core/extensions/types.ts";
+import type { Theme } from "../../modes/interactive/theme/theme.ts";
+/**
+ * Inline rich renderers for gitnexus tool results — the visibility layer.
+ * Impact renders as a blast-radius tree, query as flow traces. Falls back to
+ * plain text whenever parsing fails (hub output format is JSON-in-text today).
+ */
+export interface ImpactNode {
+    name: string;
+    filePath?: string;
+    relationType?: string;
+    confidence?: number;
+}
+export interface ImpactData {
+    target?: {
+        name?: string;
+        filePath?: string;
+    };
+    risk?: string;
+    direction?: string;
+    byDepth?: Record<string, ImpactNode[]>;
+    affected_processes?: Array<{
+        name?: string;
+    } | string>;
+    affected_modules?: Array<{
+        name?: string;
+        hits?: number;
+        impact?: string;
+    }>;
+    summary?: {
+        direct?: number;
+        processes_affected?: number;
+        modules_affected?: number;
+    };
+}
+interface QueryProcess {
+    id?: string;
+    summary?: string;
+    priority?: number;
+    step_count?: number;
+}
+interface QuerySymbol {
+    name?: string;
+    filePath?: string;
+    startLine?: number;
+    process_id?: string;
+    step_index?: number;
+}
+export interface QueryData {
+    processes?: QueryProcess[];
+    process_symbols?: QuerySymbol[];
+    definitions?: QuerySymbol[];
+}
+/** The hub returns JSON, sometimes followed by a "\n\n---\n**Next:** ..." footer. */
+export declare function parseHubJson<T>(text: string): T | undefined;
+export declare function formatImpact(text: string, theme: Theme): string | undefined;
+export declare function formatQuery(text: string, theme: Theme): string | undefined;
+/** Attach an inline rich renderer to a gitnexus ToolDefinition when one exists. */
+export declare function withGitNexusRenderer(definition: ToolDefinition): ToolDefinition;
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/extensions/gitnexus/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/extensions/gitnexus/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAEpE;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACvC,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,CAAC;IACvD,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF;AAED,UAAU,YAAY;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,WAAW;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACzB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAQ3D;AAkHD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAqG3E;AA8CD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAoC1E;AA0ED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc,CAuB/E","sourcesContent":["import { Text, visibleWidth } from \"@earendil-works/pi-tui\";\nimport { type MermaidArt, render as renderMermaid, type Span } from \"grok-mermaid\";\nimport type { ToolDefinition } from \"../../core/extensions/types.ts\";\nimport { gradientText } from \"../../modes/interactive/theme/brand.ts\";\nimport type { Theme } from \"../../modes/interactive/theme/theme.ts\";\n\n/**\n * Inline rich renderers for gitnexus tool results — the visibility layer.\n * Impact renders as a blast-radius tree, query as flow traces. Falls back to\n * plain text whenever parsing fails (hub output format is JSON-in-text today).\n */\n\nexport interface ImpactNode {\n\tname: string;\n\tfilePath?: string;\n\trelationType?: string;\n\tconfidence?: number;\n}\n\nexport interface ImpactData {\n\ttarget?: { name?: string; filePath?: string };\n\trisk?: string;\n\tdirection?: string;\n\tbyDepth?: Record<string, ImpactNode[]>;\n\taffected_processes?: Array<{ name?: string } | string>;\n\taffected_modules?: Array<{ name?: string; hits?: number; impact?: string }>;\n\tsummary?: { direct?: number; processes_affected?: number; modules_affected?: number };\n}\n\ninterface QueryProcess {\n\tid?: string;\n\tsummary?: string;\n\tpriority?: number;\n\tstep_count?: number;\n}\n\ninterface QuerySymbol {\n\tname?: string;\n\tfilePath?: string;\n\tstartLine?: number;\n\tprocess_id?: string;\n\tstep_index?: number;\n}\n\nexport interface QueryData {\n\tprocesses?: QueryProcess[];\n\tprocess_symbols?: QuerySymbol[];\n\tdefinitions?: QuerySymbol[];\n}\n\n/** The hub returns JSON, sometimes followed by a \"\\n\\n---\\n**Next:** ...\" footer. */\nexport function parseHubJson<T>(text: string): T | undefined {\n\tconst jsonPart = text.split(\"\\n\\n---\")[0]?.trim() ?? \"\";\n\tif (!jsonPart.startsWith(\"{\")) return undefined;\n\ttry {\n\t\treturn JSON.parse(jsonPart) as T;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction basename(filePath: string | undefined): string {\n\tif (!filePath) return \"\";\n\treturn filePath.split(\"/\").pop() ?? filePath;\n}\n\nfunction riskColors(theme: Theme, risk: string): { label: string } {\n\tconst upper = risk.toUpperCase();\n\tif (upper === \"HIGH\" || upper === \"CRITICAL\") return { label: theme.bold(theme.fg(\"error\", ` RISK: ${upper} `)) };\n\tif (upper === \"MEDIUM\") return { label: theme.bold(theme.fg(\"warning\", ` RISK: ${upper} `)) };\n\treturn { label: theme.bold(theme.fg(\"success\", ` RISK: ${upper} `)) };\n}\n\n/** Truncate a plain label to a max width with an ellipsis. */\nfunction clipLabel(label: string, max: number): string {\n\tconst chars = [...label];\n\treturn chars.length <= max ? label : `${chars.slice(0, max - 1).join(\"\")}…`;\n}\n\nconst FAN_MAX_NODES = 5;\nconst FAN_LABEL_WIDTH = 20;\n\n/** Fan connector glyph for row i of n. */\nfunction fanGlyph(i: number, n: number): string {\n\tif (n === 1) return \"──\";\n\tif (i === 0) return \"╭─\";\n\tif (i === n - 1) return \"╰─\";\n\treturn \"├─\";\n}\n\n/** Escape a symbol name for a quoted mermaid node label. */\nfunction mermaidLabel(name: string): string {\n\treturn `\"${clipLabel(name, 26).replace(/\"/g, \"'\")}\"`;\n}\n\ntype NodeColor = \"accent\" | \"error\" | \"warning\" | \"muted\";\n\nfunction styleMermaidSpan(span: Span, theme: Theme, nodeColors: Map<string, NodeColor>): string {\n\tswitch (span.cls) {\n\t\tcase \"border\":\n\t\t\treturn theme.fg(\"borderMuted\", span.text);\n\t\tcase \"text\": {\n\t\t\t// Color node labels by their blast-radius tier.\n\t\t\tconst color = nodeColors.get(span.text.trim());\n\t\t\tif (color === \"accent\") return theme.bold(theme.fg(\"accent\", span.text));\n\t\t\tif (color) return theme.fg(color, span.text);\n\t\t\treturn theme.fg(\"text\", span.text);\n\t\t}\n\t\tcase \"edge\":\n\t\t\treturn theme.fg(\"dim\", span.text);\n\t\tcase \"edgeLabel\":\n\t\t\treturn theme.fg(\"muted\", span.text);\n\t\tcase \"title\":\n\t\t\treturn theme.fg(\"accent\", theme.bold(span.text));\n\t\tcase \"none\":\n\t\t\treturn span.text;\n\t}\n}\n\nconst MERMAID_MAX_WIDTH = 106;\nconst MERMAID_DEPTH_CAPS: Record<number, number> = { 1: 6, 2: 4, 3: 2 };\n\n/**\n * Impact as a grok-mermaid flowchart. NOTE: byDepth carries no parent links,\n * so d1→d2→d3 edges are round-robin approximations — depth layering is exact,\n * specific cross-links are positional until the hub exposes parent ids.\n */\nfunction impactMermaid(data: ImpactData, theme: Theme): string[] | undefined {\n\tconst byDepth = data.byDepth ?? {};\n\tconst layers = [1, 2, 3]\n\t\t.map((depth) => ({\n\t\t\tdepth,\n\t\t\tnodes: (byDepth[String(depth)] ?? []).slice(0, MERMAID_DEPTH_CAPS[depth] ?? 3),\n\t\t\ttotal: (byDepth[String(depth)] ?? []).length,\n\t\t}))\n\t\t.filter((layer) => layer.nodes.length > 0);\n\tif (layers.length === 0) return undefined;\n\n\tconst source: string[] = [\"flowchart LR\", `  T[${mermaidLabel(data.target?.name ?? \"?\")}]`];\n\tconst nodeColors = new Map<string, NodeColor>();\n\tnodeColors.set(clipLabel(data.target?.name ?? \"?\", 26).replace(/\"/g, \"'\"), \"accent\");\n\tconst idsByDepth: string[][] = [];\n\tlayers.forEach((layer, layerIndex) => {\n\t\tconst tierColor: NodeColor = layer.depth === 1 ? \"error\" : layer.depth === 2 ? \"warning\" : \"muted\";\n\t\tconst ids: string[] = [];\n\t\tlayer.nodes.forEach((node, i) => {\n\t\t\tconst id = `D${layer.depth}_${i}`;\n\t\t\tids.push(id);\n\t\t\tconst parents = layerIndex === 0 ? [\"T\"] : [idsByDepth[layerIndex - 1][i % idsByDepth[layerIndex - 1].length]];\n\t\t\tsource.push(`  ${parents[0]} --> ${id}[${mermaidLabel(node.name)}]`);\n\t\t\tnodeColors.set(clipLabel(node.name, 26).replace(/\"/g, \"'\"), tierColor);\n\t\t});\n\t\tif (layer.total > layer.nodes.length) {\n\t\t\tconst id = `D${layer.depth}_more`;\n\t\t\tconst parent = layerIndex === 0 ? \"T\" : idsByDepth[layerIndex - 1][0];\n\t\t\tconst moreLabel = `+${layer.total - layer.nodes.length} more`;\n\t\t\tsource.push(`  ${parent} --> ${id}[\"${moreLabel}\"]`);\n\t\t\tnodeColors.set(moreLabel, \"muted\");\n\t\t\tids.push(id);\n\t\t}\n\t\tidsByDepth.push(ids);\n\t});\n\n\tlet art: MermaidArt | null;\n\ttry {\n\t\tart = renderMermaid(source.join(\"\\n\"));\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!art || art.warnings.length > 0 || art.width > MERMAID_MAX_WIDTH) return undefined;\n\treturn art.styled.map((row) => row.map((span) => styleMermaidSpan(span, theme, nodeColors)).join(\"\"));\n}\n\nexport function formatImpact(text: string, theme: Theme): string | undefined {\n\tconst data = parseHubJson<ImpactData>(text);\n\tif (!data?.target?.name || !data.byDepth) return undefined;\n\n\tconst lines: string[] = [];\n\tconst risk = riskColors(theme, data.risk ?? \"UNKNOWN\");\n\n\tconst mermaidLines = impactMermaid(data, theme);\n\tif (mermaidLines) {\n\t\tlines.push(...mermaidLines);\n\t\tlines.push(\"\");\n\t\tconst depthCounts = [1, 2, 3]\n\t\t\t.map((d) => ({ d, n: data.byDepth?.[String(d)]?.length ?? 0 }))\n\t\t\t.filter((x) => x.n > 0)\n\t\t\t.map(({ d, n }) =>\n\t\t\t\td === 1\n\t\t\t\t\t? theme.bold(theme.fg(\"error\", `d1 · breaks (${n})`))\n\t\t\t\t\t: d === 2\n\t\t\t\t\t\t? theme.fg(\"warning\", `d2 · test (${n})`)\n\t\t\t\t\t\t: theme.fg(\"muted\", `d${d} · transitive (${n})`),\n\t\t\t)\n\t\t\t.join(\"   \");\n\t\tlines.push(` ${risk.label}   ${depthCounts}`);\n\t\tconst processes = (data.affected_processes ?? [])\n\t\t\t.map((p) => (typeof p === \"string\" ? p : (p.name ?? \"\")))\n\t\t\t.filter(Boolean);\n\t\tif (processes.length > 0) lines.push(theme.fg(\"muted\", `flows affected: ${processes.slice(0, 4).join(\", \")}`));\n\t\tconst modules = (data.affected_modules ?? []).map((m) => m.name).filter(Boolean);\n\t\tif (modules.length > 0) lines.push(theme.fg(\"muted\", `modules: ${modules.slice(0, 5).join(\", \")}`));\n\t\treturn lines.join(\"\\n\");\n\t}\n\n\tconst depths = Object.keys(data.byDepth)\n\t\t.map(Number)\n\t\t.filter((d) => !Number.isNaN(d) && (data.byDepth?.[String(d)]?.length ?? 0) > 0)\n\t\t.sort((a, b) => a - b)\n\t\t.slice(0, 3);\n\n\t// Left→right blast-radius graph: target node fans out to d1, d1 to d2, d2 to d3.\n\t//  ◉ target ─┬─● caller      ╭─○ indirect\n\t//            ╰─● caller    ──┤\n\tconst columns = depths.map((depth) => {\n\t\tconst nodes = data.byDepth?.[String(depth)] ?? [];\n\t\tconst shown = nodes.slice(0, FAN_MAX_NODES);\n\t\tconst overflow = nodes.length - shown.length;\n\t\tconst color = depth === 1 ? \"error\" : depth === 2 ? \"warning\" : \"muted\";\n\t\tconst bullet = depth === 1 ? \"●\" : depth === 2 ? \"○\" : \"·\";\n\t\tconst cells = shown.map((node) => {\n\t\t\tconst label = clipLabel(node.name, FAN_LABEL_WIDTH);\n\t\t\tconst pad = \" \".repeat(Math.max(0, FAN_LABEL_WIDTH - [...label].length));\n\t\t\treturn `${theme.fg(color as \"error\", bullet)} ${label}${pad}`;\n\t\t});\n\t\tif (overflow > 0)\n\t\t\tcells.push(\n\t\t\t\t`${theme.fg(\"dim\", `… +${overflow} more`)}${\" \".repeat(Math.max(0, FAN_LABEL_WIDTH - 8 - String(overflow).length))}`,\n\t\t\t);\n\t\tconst footer =\n\t\t\tdepth === 1\n\t\t\t\t? theme.bold(theme.fg(\"error\", `d1 · breaks (${nodes.length})`))\n\t\t\t\t: depth === 2\n\t\t\t\t\t? theme.fg(\"warning\", `d2 · test (${nodes.length})`)\n\t\t\t\t\t: theme.fg(\"muted\", `d${depth} · transitive (${nodes.length})`);\n\t\treturn { cells, footer };\n\t});\n\n\tconst rows = Math.max(...columns.map((c) => c.cells.length), 1);\n\tconst targetLabel = `${theme.fg(\"accent\", \"◉\")} ${theme.bold(clipLabel(data.target.name, 24))}`;\n\tconst targetWidth = [...clipLabel(data.target.name, 24)].length + 2;\n\tconst targetMid = Math.floor((rows - 1) / 2);\n\n\tfor (let row = 0; row < rows; row++) {\n\t\tlet line = row === targetMid ? ` ${targetLabel} ` : \" \".repeat(targetWidth + 2);\n\t\tcolumns.forEach((column) => {\n\t\t\tconst cell = column.cells[row];\n\t\t\tif (cell === undefined) {\n\t\t\t\tline += \" \".repeat(2 + 1 + FAN_LABEL_WIDTH + 2);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tline += `${theme.fg(\"dim\", fanGlyph(row, column.cells.length))} ${cell}  `;\n\t\t});\n\t\tlines.push(line);\n\t}\n\t// Footer row: risk + per-depth labels.\n\tlet footerLine = ` ${risk.label} `;\n\tfor (const column of columns) {\n\t\tfooterLine += ` ${column.footer}${\" \".repeat(4)}`;\n\t}\n\tlines.push(\"\");\n\tlines.push(footerLine);\n\n\tconst processes = (data.affected_processes ?? [])\n\t\t.map((p) => (typeof p === \"string\" ? p : (p.name ?? \"\")))\n\t\t.filter(Boolean);\n\tif (processes.length > 0) {\n\t\tlines.push(theme.fg(\"muted\", `flows affected: ${processes.slice(0, 4).join(\", \")}`));\n\t}\n\tconst modules = (data.affected_modules ?? []).map((m) => m.name).filter(Boolean);\n\tif (modules.length > 0) {\n\t\tlines.push(theme.fg(\"muted\", `modules: ${modules.slice(0, 5).join(\", \")}`));\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nconst QUERY_MAX_STEPS = 5;\n\n/**\n * Top execution flow as a mermaid step chain: parse ─▶ resolve ─▶ execute.\n * Uses `step_index` ordering from the hub's process_symbols.\n */\nfunction queryMermaid(\n\tdata: QueryData,\n\tsymbolsByProcess: Map<string, QuerySymbol[]>,\n\ttheme: Theme,\n): string[] | undefined {\n\tconst top = data.processes?.[0];\n\tif (!top?.id) return undefined;\n\tconst steps = (symbolsByProcess.get(top.id) ?? [])\n\t\t.slice()\n\t\t.sort((a, b) => (a.step_index ?? 0) - (b.step_index ?? 0))\n\t\t.filter((symbol) => symbol.name);\n\tif (steps.length < 2) return undefined;\n\n\tconst shown = steps.slice(0, QUERY_MAX_STEPS);\n\tconst source: string[] = [\"flowchart LR\"];\n\tconst nodeColors = new Map<string, NodeColor>();\n\tshown.forEach((symbol, i) => {\n\t\tconst label = mermaidLabel(symbol.name ?? \"?\");\n\t\tif (i === 0) source.push(`  S0[${label}]`);\n\t\telse source.push(`  S${i - 1} --> S${i}[${label}]`);\n\t\tnodeColors.set(clipLabel(symbol.name ?? \"?\", 26).replace(/\"/g, \"'\"), i === 0 ? \"accent\" : \"muted\");\n\t});\n\tif (steps.length > shown.length) {\n\t\tconst moreLabel = `+${steps.length - shown.length} more`;\n\t\tsource.push(`  S${shown.length - 1} --> SM[\"${moreLabel}\"]`);\n\t\tnodeColors.set(moreLabel, \"muted\");\n\t}\n\n\tlet art: MermaidArt | null;\n\ttry {\n\t\tart = renderMermaid(source.join(\"\\n\"));\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!art || art.warnings.length > 0 || art.width > MERMAID_MAX_WIDTH) return undefined;\n\treturn art.styled.map((row) => row.map((span) => styleMermaidSpan(span, theme, nodeColors)).join(\"\"));\n}\n\nexport function formatQuery(text: string, theme: Theme): string | undefined {\n\tconst data = parseHubJson<QueryData>(text);\n\tif (!data?.processes) return undefined;\n\tconst lines: string[] = [];\n\tconst symbolsByProcess = new Map<string, QuerySymbol[]>();\n\tfor (const sym of data.process_symbols ?? []) {\n\t\tif (!sym.process_id) continue;\n\t\tconst list = symbolsByProcess.get(sym.process_id) ?? [];\n\t\tlist.push(sym);\n\t\tsymbolsByProcess.set(sym.process_id, list);\n\t}\n\n\t// Draw the top flow as a step chain when the hub gives us ordered steps.\n\tconst chain = queryMermaid(data, symbolsByProcess, theme);\n\tif (chain) {\n\t\tlines.push(...chain);\n\t\tlines.push(\"\");\n\t}\n\n\tconst procs = data.processes.slice(0, 4);\n\tprocs.forEach((proc, i) => {\n\t\tconst marker = i === 0 ? theme.fg(\"accent\", \"◉\") : theme.fg(\"muted\", \"○\");\n\t\tconst summary = proc.summary ?? \"(flow)\";\n\t\tconst steps = proc.step_count ? theme.fg(\"muted\", ` · ${proc.step_count} steps`) : \"\";\n\t\tlines.push(`${marker} ${i === 0 ? theme.bold(summary) : summary}${steps}`);\n\t});\n\tconst shownSymbols = (data.process_symbols ?? []).slice(0, 6);\n\tif (shownSymbols.length > 0) {\n\t\tlines.push(theme.fg(\"muted\", \"symbols:\"));\n\t\tfor (const sym of shownSymbols) {\n\t\t\tconst loc = sym.filePath ? `${basename(sym.filePath)}${sym.startLine ? `:${sym.startLine}` : \"\"}` : \"\";\n\t\t\tlines.push(`  ${theme.fg(\"accent\", \"•\")} ${sym.name} ${theme.fg(\"muted\", loc)}`);\n\t\t}\n\t}\n\tif (lines.length === 0) return undefined;\n\treturn lines.join(\"\\n\");\n}\n\n/** ANSI-aware clip to a visible width, appending an ellipsis. */\nfunction clipAnsi(text: string, width: number): string {\n\tif (visibleWidth(text) <= width) return text;\n\tlet out = \"\";\n\tlet visible = 0;\n\tfor (let i = 0; i < text.length; i++) {\n\t\tif (text[i] === \"\\x1b\") {\n\t\t\tconst match = text.slice(i).match(/^\\x1b\\[[0-9;]*m/);\n\t\t\tif (match) {\n\t\t\t\tout += match[0];\n\t\t\t\ti += match[0].length - 1;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tif (visible >= width - 1) break;\n\t\tout += text[i];\n\t\tvisible++;\n\t}\n\treturn `${out}…\\x1b[0m`;\n}\n\nconst BOX_MAX_INNER = 108;\n\n/**\n * Branded frame around a GitNexus result:\n * ╭─ ⬢ GitNexus · impact ───────────╮\n * │ content                         │\n * ╰─────────────────────────────────╯\n */\nfunction gitnexusBox(content: string, toolLabel: string, theme: Theme): string {\n\tconst rawLines = content.split(\"\\n\");\n\tconst inner = Math.min(BOX_MAX_INNER, Math.max(24, ...rawLines.map((line) => visibleWidth(line))));\n\tconst border = (s: string) => theme.fg(\"border\", s);\n\tconst title = `${gradientText(\"⬢ GitNexus\")}${theme.fg(\"muted\", ` · ${toolLabel} `)}`;\n\t// Top row totals inner+4 like the side rows: ╭─␣(3) + title + fill + ╮(1).\n\tconst fill = Math.max(0, inner - visibleWidth(title));\n\tconst top = `${border(\"╭─ \")}${title}${border(\"─\".repeat(fill))}${border(\"╮\")}`;\n\tconst lines = [top];\n\tfor (const line of rawLines) {\n\t\tconst clipped = clipAnsi(line, inner);\n\t\tconst pad = \" \".repeat(Math.max(0, inner - visibleWidth(clipped)));\n\t\tlines.push(`${border(\"│\")} ${clipped}${pad} ${border(\"│\")}`);\n\t}\n\tlines.push(border(`╰${\"─\".repeat(inner + 2)}╯`));\n\treturn lines.join(\"\\n\");\n}\n\ntype Formatter = (text: string, theme: Theme) => string | undefined;\n\nconst FORMATTERS: Record<string, Formatter> = {\n\tgitnexus_impact: formatImpact,\n\tgitnexus_query: formatQuery,\n};\n\n/**\n * Collapsed height, matching the clamp ToolExecutionComponent applies to tools\n * that have no renderer of their own. A custom renderer opts out of that\n * fallback entirely, so it has to clamp itself or it dumps its whole result\n * into the transcript.\n */\nconst COLLAPSED_OUTPUT_LINES = 10;\n\n/** Clamp to the collapsed height, leaving a hint about the rest. */\nfunction clampOutput(content: string, expanded: boolean, theme: Theme): string {\n\tif (expanded) return content;\n\tconst lines = content.split(\"\\n\");\n\tif (lines.length <= COLLAPSED_OUTPUT_LINES) return content;\n\tconst hidden = lines.length - COLLAPSED_OUTPUT_LINES;\n\tconst hint = theme.fg(\"dim\", `… ${hidden} more lines (click or ctrl+o)`);\n\treturn [...lines.slice(0, COLLAPSED_OUTPUT_LINES), hint].join(\"\\n\");\n}\n\n/** Attach an inline rich renderer to a gitnexus ToolDefinition when one exists. */\nexport function withGitNexusRenderer(definition: ToolDefinition): ToolDefinition {\n\tconst format = FORMATTERS[definition.name];\n\tif (!format) return definition;\n\treturn {\n\t\t...definition,\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 1, 0);\n\t\t\tconst raw = result.content\n\t\t\t\t.filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n\t\t\t\t.map((c) => c.text)\n\t\t\t\t.join(\"\\n\");\n\t\t\tconst rich = context.isError ? undefined : format(raw, theme);\n\t\t\tconst toolLabel = definition.name.replace(/^gitnexus_/, \"\");\n\t\t\t// Clamp before boxing, so the hint sits inside the border and the box\n\t\t\t// still closes. Clamping the boxed text would cut off its last row.\n\t\t\ttext.setText(\n\t\t\t\trich\n\t\t\t\t\t? gitnexusBox(clampOutput(rich, options.expanded, theme), toolLabel, theme)\n\t\t\t\t\t: clampOutput(raw, options.expanded, theme),\n\t\t\t);\n\t\t\treturn text;\n\t\t},\n\t};\n}\n"]}