dsh-codegraph-visualizer 0.3.0 → 0.3.1

package/dist/index.js

@@ -6,9 +6,9 @@ import { inferLayerFromPath } from "./layerUtils-DDm-EsaD.js";
 import "./treeSitterExtractors-B1ybKNrC.js";
 import { TreeSitterAdapter, isTreeSitterRuntimePresent } from "./TreeSitterAdapter-C-EWy8br.js";
 import { FILTERED_EDGE_KINDS, isNoisePath, mapEdgeKind, mapNodeKind, mapRowsToGraphEdges, mapRowsToGraphNodes, normalizeRepoPath } from "./codeGraphRows-C7hqu35E.js";
-import "./nativeIndex-DlSpD611.js";
-import { closeAllDbConnections, countEdgesInDb, readFileOutlineFromDb, readNodeChildrenFromDb, readSymbolASTFromDb, readTopLevelNodesFromDb } from "./codeGraphDb-BT9nZCEO.js";
-import { CODEGRAPH_SOURCE, readEdgesForNodesFromDb, readEdgesFromDb, readFilesFromDb, readIncidentEdgesWithFilePathsFromDb, resolveDbPath, sortEdgesByKindGroup } from "./CodeGraphAdapter-eyrhs0K0.js";
+import "./nativeIndex-CABbgERW.js";
+import { closeAllDbConnections, countEdgesInDb, readFileOutlineFromDb, readNodeChildrenFromDb, readSymbolASTFromDb, readTopLevelNodesFromDb } from "./codeGraphDb-T6K3dK5D.js";
+import { CODEGRAPH_SOURCE, readEdgesForNodesFromDb, readEdgesFromDb, readFilesFromDb, readIncidentEdgesWithFilePathsFromDb, resolveDbPath, sortEdgesByKindGroup } from "./CodeGraphAdapter-BNIK0xHU.js";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { ToolCallId } from "@deepseek-ai/dsh-llm";
 import Schema from "@deepseek-ai/schemastery";
@@ -5895,11 +5895,8 @@ const PATH_EDGE_TYPE_DOMAIN = new Set([
 	"composition"
 ]);
 /**
-
 * 解析 `edgeTypes` 逗号列表：只保留域内类型；未提供或全部非法时返回 null（用默认读法）。
-
 * 空集规则匹配不到任何边（璇玑图 §八），所以「全部非法」不能静默变成空集过滤。
-
 */
 function parseEdgeTypes$1(raw) {
 	if (!raw) return null;
@@ -5911,9 +5908,52 @@ function clampInt$1(value, min, max, fallback) {
 	if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
 	return Math.min(max, Math.max(min, Math.trunc(value)));
 }
+/** UI 摘要文本块上限（单条 content ≤ 300 字符）。 */
+const SUMMARY_MAX_CHARS = 300;
+/** 把一行摘要截到上限内并包成 content 形状。 */
+function summaryBlock(text) {
+	const clipped = text.length > SUMMARY_MAX_CHARS ? `${text.slice(0, SUMMARY_MAX_CHARS - 1)}…` : text;
+	return [{
+		type: "text",
+		text: clipped
+	}];
+}
+/** meta 持久化行上限（tool/result.meta 不是日志：单工具 ≤10 键、单值 ≤200 字符）。 */
+const META_MAX_CHARS = 200;
+/** presentationMeta 的统一出口：把一行 meta 摘要截到持久化上限内。 */
+function metaText(text) {
+	return text.length > META_MAX_CHARS ? `${text.slice(0, META_MAX_CHARS - 1)}…` : text;
+}
+/** 成功态 UI 摘要：只认 meta（value 通道）；meta 缺席/非字符串 = undefined（UI 回退原始内容）。 */
+function successSummaryFromMeta(meta) {
+	if (typeof meta !== "string" || meta === "") return void 0;
+	return summaryBlock(meta);
+}
+/** 失败态一行摘要：压平错误投影的首条文本；投影为空 = undefined（UI 回退渲染原始错误文本）。 */
+function failureSummaryFromContent(content) {
+	const first = (content ?? []).find((b) => typeof b === "object" && b !== null && typeof b.text === "string");
+	if (!first) return void 0;
+	const flat = first.text.replace(/\s+/g, " ").trim();
+	return summaryBlock(flat.length > 0 ? `Failed: ${flat}` : "Failed.");
+}
+/**
+* presentResult 工厂：成功/失败标题 + UI 一行摘要。
+* 成功摘要只来自 meta（presentationMeta 从 value 投影），失败摘要只来自 result.content
+* （错误投影）——模型通道 render 的输出从不进入本函数，UI 通道 content 也从不进入 render。
+*/
+function presentResultWithSummary(okTitle, failTitle) {
+	return (_args, result) => {
+		const content = result.isError ? failureSummaryFromContent(result.content) : successSummaryFromMeta(result.meta);
+		return {
+			card: "generic",
+			title: result.isError ? failTitle : okTitle,
+			...content === void 0 ? {} : { content }
+		};
+	};
+}
 const GRAPH_CACHE_LIMIT = CACHE.GRAPH_CACHE_LIMIT;
 async function createGraphToolDeps() {
-	const [{ CodeGraphAdapter: CGA }, { LensAdapter: LA }] = await Promise.all([import("./CodeGraphAdapter-C8JvcS7m.js"), import("./LensAdapter-C9Saf_i_.js")]);
+	const [{ CodeGraphAdapter: CGA }, { LensAdapter: LA }] = await Promise.all([import("./CodeGraphAdapter-CXj1hbdm.js"), import("./LensAdapter-C9Saf_i_.js")]);
 	return {
 		codegraphAdapter: new CGA(),
 		lensAdapter: new LA(),
@@ -5922,15 +5962,10 @@ async function createGraphToolDeps() {
 	};
 }
 /**
-
 * 原生图适配器的模块级单例（cycle-131 · P0 第二层修复）。
-
 *
-
 * 组装一次全 host 复用（Node fs + TreeSitterAdapter 各自内部已单例化 wasm）；
-
 * 失败结果也缓存（null = 环境不支持，避免每次调用重试）。
-
 */
 let nativeAdapterSingleton;
 async function ensureNativeAdapter() {
@@ -5976,9 +6011,9 @@ async function fetchMergedGraph(invoke, repoId, source = "both", deps) {
 	const allowNativeFallback = merged.nodes.length === 0 && d.nativeAdapter !== null && (source === "auto" || source === "both");
 	if (allowNativeFallback) try {
 		const [{ readGraphFromDbPaged }, { mapRowsToGraphNodes: mapRowsToGraphNodes$1, mapRowsToGraphEdges: mapRowsToGraphEdges$1 }, { resolveNativeIndexPath, readNativeIndexMeta, writeNativeIndex }] = await Promise.all([
-			import("./codeGraphDb-Bg7bWud2.js"),
+			import("./codeGraphDb-B-vpZmpm.js"),
 			import("./codeGraphRows-BhZX34uB.js"),
-			import("./nativeIndex-Cx7RLXUp.js")
+			import("./nativeIndex-esaDOsq8.js")
 		]);
 		try {
 			const indexPath = resolveNativeIndexPath(repoId);
@@ -6196,31 +6231,18 @@ async function executeGraphImpact(args, invoke) {
 	});
 }
 /**
-
 * `graph_slice` 的执行体（cycle-135：多维视图切片）。
-
 *
-
 * 四个视图共用一条链路：先 `fetchMergedGraph` 取合并图，再交给 `graphSlice` 统一切片。
-
 * 时序/所有权视图的**外部事实**（commit 历史、blame）通过两个可选字符串参数注入：
-
 * - `commitLog`：`git log --name-only --format=%x1e%H%x1f%ct` 的原始输出；
-
 * - `blameLog`：`git blame --porcelain <file>` 的原始输出。
-
 *
-
 * 为什么让模型/调用方注入原始文本而不是在工具里直接跑 git：本工具是**读图**工具，
-
 * 与其余 `graph_*` 一样只依赖 `invoke` 上游通道；git 子进程属于宿主 `/churn`、
-
 * `/blame` 一类的分析路由职责（`gitChurn.ts` 已有实现）。这样切片逻辑保持纯函数、
-
 * 可单测，也避免在工具层再引入一条 git 依赖。缺这两个参数时，对应视图走**显式降级**
-
 * （`viewDataAvailable: false` + `reason`），而不是编造一份缺维度的图。
-
 */
 async function executeGraphSlice(args, invoke) {
 	const data = await fetchMergedGraph(invoke, args.repoId);
@@ -6260,7 +6282,12 @@ const createGraphTools = async (ctx, options = {}) => {
 		} },
 		output: {
 			schema: { type: "json" },
-			render: renderGraphStatus
+			render: renderGraphStatus,
+			presentationMeta: (_args, value) => {
+				const v = value;
+				const s = v?.sources;
+				return metaText(`status=${String(v?.status ?? "unknown")}, nodes=${String(v?.nodeCount ?? 0)}, edges=${String(v?.edgeCount ?? 0)}, sources: codegraph=${s?.codegraph === true ? "✓" : "✗"} lens=${s?.lens === true ? "✓" : "✗"}`);
+			}
 		},
 		presentCall: (args) => {
 			const a = args;
@@ -6271,10 +6298,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				rawInput: { repoId: a.repoId }
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Graph status failed" : "Graph status"
-		}),
+		presentResult: presentResultWithSummary("Graph status", "Graph status failed"),
 		execute: (args) => executeGraphStatus(args, invoke, deps)
 	});
 	const graphData = defineTool({
@@ -6299,7 +6323,15 @@ const createGraphTools = async (ctx, options = {}) => {
 		},
 		output: {
 			schema: { type: "json" },
-			render: renderGraphData
+			render: renderGraphData,
+			presentationMeta: (_args, value) => {
+				const d = value;
+				if (!d) return "empty graph";
+				const x = d.metadata.xuanji;
+				const mode = x ? x.applied ? `incremental delta (+${String(x.addedPaths ?? 0)} paths)` : "full rebuild" : "no delta signal";
+				const layer = d.metadata.graphLayer === void 0 ? "" : ` · layer=${String(d.metadata.graphLayer)}`;
+				return metaText(`${String(d.metadata.nodeCount)} node(s) / ${String(d.metadata.edgeCount)} edge(s) · ${mode}${layer}`);
+			}
 		},
 		presentCall: (args) => {
 			const a = args;
@@ -6313,10 +6345,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Graph fetch failed" : "Code graph fetched"
-		}),
+		presentResult: presentResultWithSummary("Code graph fetched", "Graph fetch failed"),
 		execute: (args) => executeGraphData(args, invoke, emitUpdate, emitData, graphCache, deps, xuanjiPool)
 	});
 	const graphSymbol = defineTool({
@@ -6329,7 +6358,12 @@ const createGraphTools = async (ctx, options = {}) => {
 		} },
 		output: {
 			schema: { type: "json" },
-			render: renderGraphSymbol
+			render: renderGraphSymbol,
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v) return "Symbol not found.";
+				return metaText(`${String(v.name ?? v.symbolId ?? "?")} (${String(v.category ?? "unknown")}) @ ${String(v.file ?? "?")}:${String(v.line ?? "?")}`);
+			}
 		},
 		presentCall: (args) => {
 			const a = args;
@@ -6340,10 +6374,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				rawInput: { symbolId: a.symbolId }
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Symbol resolution failed" : "Symbol resolved"
-		}),
+		presentResult: presentResultWithSummary("Symbol resolved", "Symbol resolution failed"),
 		execute: (args) => executeGraphSymbol(args, invoke)
 	});
 	const graphImpact = defineTool({
@@ -6356,7 +6387,13 @@ const createGraphTools = async (ctx, options = {}) => {
 		} },
 		output: {
 			schema: { type: "json" },
-			render: renderGraphImpact
+			render: renderGraphImpact,
+			presentationMeta: (_args, value) => {
+				const v = value;
+				const n = v?.affected?.length ?? 0;
+				if (n === 0) return "No affected symbols.";
+				return metaText(`${String(n)} symbol(s) affected (depth ${String(v?.depth ?? 0)}): ${v?.affected?.slice(0, 5).join(", ") ?? ""}`);
+			}
 		},
 		presentCall: (args) => {
 			const a = args;
@@ -6367,10 +6404,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				rawInput: { symbolId: a.symbolId }
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Impact analysis failed" : "Impact analyzed"
-		}),
+		presentResult: presentResultWithSummary("Impact analyzed", "Impact analysis failed"),
 		execute: (args) => executeGraphImpact(args, invoke)
 	});
 	const graphPathFind = defineTool({
@@ -6411,6 +6445,12 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `${TOOL_MESSAGES.PATH_FOUND?.en ?? "Path found"} (${v.length} ${TOOL_MESSAGES.HOPS?.en ?? "hops"}): ${v.path.join(" → ")}`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (v?.truncated) return "Graph too large for path search.";
+				if (!v || !v.path || v.path.length === 0) return "No path found.";
+				return metaText(`${String(v.length)} hops: ${v.path.join(" → ")}`);
 			}
 		},
 		presentCall: (args) => {
@@ -6425,10 +6465,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Path search failed" : "Call path"
-		}),
+		presentResult: presentResultWithSummary("Call path", "Path search failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId);
@@ -6511,6 +6548,13 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `${v.total ?? v.paths.length} path(s)${suffix}${next}\n${lines.join("\n")}`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v || !v.paths || v.paths.length === 0) return "No path found.";
+				const first = v.paths[0]?.join(" → ") ?? "";
+				const cursor = v.nextCursor === null || v.nextCursor === void 0 ? "" : `, nextCursor=${String(v.nextCursor)}`;
+				return metaText(`${String(v.total ?? v.paths.length)} path(s)${v.truncated ? " (truncated)" : ""}${cursor}; first: ${first}`);
 			}
 		},
 		presentCall: (args) => {
@@ -6525,10 +6569,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Path enumeration failed" : "Paths enumerated"
-		}),
+		presentResult: presentResultWithSummary("Paths enumerated", "Path enumeration failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId);
@@ -6556,29 +6597,17 @@ const createGraphTools = async (ctx, options = {}) => {
 		}
 	});
 	/**
-	
 	* 路径模式 ρ（cycle-134）：`graph_path_enumerate` 的**序列约束**版本。
-	
 	*
-	
 	* 与 `graph_path_enumerate` 的差别只在表达能力：
-	
 	* - 后者 `edgeTypes` 是扁平集合（「每步走这些之一」）；
-	
 	* - 本工具 `pattern` 是边类型**序列正则**，能表达「先 call 再 import 再 dependency」
-	
 	*   这类跨视图路径（研究方案 §4 的 `P = (v_s, ρ, v_t)`）。
-	
 	*
-	
 	* 为什么仍是独立工具而不合并进 `graph_path_enumerate`：两者的**参数语义不同**
-	
 	* （`edgeTypes` 是集合语义、`pattern` 是序列语义），合并成一个可选参数会让模型
-	
 	* 无法从参数名判断该传哪个，且两者同时给出时的优先级无自然定义。模型侧的选择表
-	
 	* 写在 `src/host/skills.ts` 的 SKILL_CONTENT 第 8 条。
-	
 	*/
 	const graphPathPattern = defineTool({
 		name: "graph_path_pattern",
@@ -6684,6 +6713,20 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `${head}\n${v.total ?? v.paths.length} path(s)${suffix}${next}\n${lines.join("\n")}`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (v?.error) return `Pattern error: ${v.error}`;
+				const unknown = v?.unknownEdgeTypes ?? [];
+				if (unknown.length > 0) return `Unknown edge type(s): ${unknown.join(", ")}.`;
+				if (!v || !v.paths) return "Pattern evaluation failed.";
+				if (v.paths.length === 0) {
+					const degraded = v.temporal?.requested === true && v.temporal.available === false;
+					return degraded ? `No paths; temporal slice unavailable (${String(v.reason ?? "unknown")}).` : "No paths matched the pattern.";
+				}
+				const first = v.paths[0]?.join(" → ") ?? "";
+				const cursor = v.nextCursor === null || v.nextCursor === void 0 ? "" : `, nextCursor=${String(v.nextCursor)}`;
+				return metaText(`pattern "${String(v.pattern ?? "")}": ${String(v.total ?? v.paths.length)} path(s)${v.truncated ? " (truncated)" : ""}${cursor}; first: ${first}`);
 			}
 		},
 		presentCall: (args) => {
@@ -6699,10 +6742,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Path pattern failed" : "Pattern paths"
-		}),
+		presentResult: presentResultWithSummary("Pattern paths", "Path pattern failed"),
 		execute: async (args) => {
 			const a = args;
 			const merged = await fetchMergedGraph(invoke, a.repoId);
@@ -6823,6 +6863,13 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `${v.total ?? v.paths.length} cycle(s)${suffix}${next}\n${lines.join("\n")}`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v || !v.paths || v.paths.length === 0) return "No dependency cycles detected.";
+				const first3 = v.paths.slice(0, 3).map((c, i) => `${String(i + 1)}) ${c.join(" → ")}`).join("; ");
+				const cursor = v.nextCursor === null || v.nextCursor === void 0 ? "" : `, nextCursor=${String(v.nextCursor)}`;
+				return metaText(`${String(v.total ?? v.paths.length)} cycle(s)${v.truncated ? " (truncated)" : ""}${cursor}: ${first3}`);
 			}
 		},
 		presentCall: (args) => {
@@ -6834,10 +6881,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				rawInput: { repoId: a.repoId }
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Cycle enumeration failed" : "Dependency cycles"
-		}),
+		presentResult: presentResultWithSummary("Dependency cycles", "Cycle enumeration failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId);
@@ -6881,6 +6925,11 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `Architecture Health: ${v.overall}/100\n  Coupling: ${v.coupling}/100\n  Cohesion: ${v.cohesion}/100\n  Cyclic Dep Rate: ${v.cyclicDependencyRate}/100\n  Modularity: ${v.modularity}/100`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v) return "Insufficient data for health scoring.";
+				return metaText(`overall ${String(v.overall)}/100 (coupling ${String(v.coupling)}, cohesion ${String(v.cohesion)}, cyclic-dep ${String(v.cyclicDependencyRate)}, modularity ${String(v.modularity)}) — ${v.overall >= 70 ? "healthy" : v.overall >= 40 ? "degraded" : "poor"}`);
 			}
 		},
 		presentCall: (args) => {
@@ -6892,10 +6941,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				rawInput: { repoId: a.repoId }
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Health scoring failed" : "Health score"
-		}),
+		presentResult: presentResultWithSummary("Health score", "Health scoring failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId);
@@ -6936,6 +6982,11 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `${v.length} ${TOOL_MESSAGES.RULE_VIOLATIONS?.en ?? "rule violations:"}\n${lines.join("\n")}`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v || v.length === 0) return "No rule violations.";
+				return metaText(`${String(v.length)} violation(s): ${v.slice(0, 3).map((r) => `[${r.severity}] ${r.message}`).join("; ")}`);
 			}
 		},
 		presentCall: (args) => {
@@ -6951,10 +7002,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Rules check failed" : "Rules checked"
-		}),
+		presentResult: presentResultWithSummary("Rules checked", "Rules check failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId, "both", deps);
@@ -7008,6 +7056,12 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `Focus on ${v.symbolId}: ${v.neighbors?.length ?? 0} direct neighbors\n  ${v.neighbors?.slice(0, 15).join(", ") ?? ""}`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v) return "Symbol not found in graph.";
+				const n = v.neighbors?.length ?? 0;
+				return metaText(n === 0 ? `${String(v.symbolId)}: 0 direct neighbors` : `${String(v.symbolId)}: ${String(n)} direct neighbor(s), e.g. ${v.neighbors?.slice(0, 3).join(", ") ?? ""}`);
 			}
 		},
 		presentCall: (args) => {
@@ -7019,10 +7073,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				rawInput: { symbolId: a.symbolId }
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Focus failed" : "Symbol neighborhood"
-		}),
+		presentResult: presentResultWithSummary("Symbol neighborhood", "Focus failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId);
@@ -7080,6 +7131,11 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: `${seedLine}${meta}\n${v.text}`
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v || !v.text) return "No seed matched the query.";
+				return metaText(`${String(v.seeds?.length ?? 0)} seed(s), ${String(v.nodeCount ?? 0)} node(s) / ${String(v.edgeCount ?? 0)} edge(s) in subgraph, ${String(v.tokens ?? 0)} tokens${v.truncated === true ? ` (truncated: ${String(v.reason ?? "unknown")})` : ""}`);
 			}
 		},
 		presentCall: (args) => {
@@ -7094,10 +7150,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Graph query failed" : "Graph query result"
-		}),
+		presentResult: presentResultWithSummary("Graph query result", "Graph query failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId);
@@ -7192,6 +7245,22 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: lines.join("\n")
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v || v.loaded !== true) return "Graph layer not loaded for this repo yet.";
+				const g = v.graph ?? {
+					nodes: 0,
+					edges: 0,
+					version: 0
+				};
+				const c = v.changeLog ?? {
+					pending: 0,
+					dropped: 0,
+					drained: null
+				};
+				const stale = (v.rules ?? []).reduce((sum, r) => sum + r.counters.stale, 0);
+				return metaText(`loaded, nodes=${String(g.nodes)} edges=${String(g.edges)} version=${String(g.version)}; changeLog pending=${String(c.pending)} dropped=${String(c.dropped)}${c.drained === null ? "" : ` drained=${String(c.drained)}`}; stale index entries=${String(stale)}${v.incrementalIdle === true ? "; incremental pipeline dormant" : ""}`);
 			}
 		},
 		presentCall: (args) => {
@@ -7203,10 +7272,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				rawInput: { repoId: a.repoId }
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Integrity check failed" : "Graph integrity"
-		}),
+		presentResult: presentResultWithSummary("Graph integrity", "Integrity check failed"),
 		execute: async (args) => {
 			const a = args;
 			try {
@@ -7273,6 +7339,11 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: lines.join("\n")
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v || !v.available) return `Slice unavailable: ${String(v?.reason ?? "unknown reason")}`;
+				return metaText(`${String(v.view)} @ ${String(v.granularity)}: ${String(v.nodes.length)} node(s), ${String(v.edges.length)} edge(s), ${String(Object.keys(v.labels).length)} label(s)${v.viewDataAvailable ? "" : " (view data unavailable)"}`);
 			}
 		},
 		presentCall: (args) => {
@@ -7288,10 +7359,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "Graph slice failed" : "Graph slice"
-		}),
+		presentResult: presentResultWithSummary("Graph slice", "Graph slice failed"),
 		execute: async (args) => {
 			const slice = await executeGraphSlice(args, invoke);
 			return toJsonValue(slice);
@@ -7347,6 +7415,12 @@ const createGraphTools = async (ctx, options = {}) => {
 					type: "text",
 					text: lines.join("\n")
 				}];
+			},
+			presentationMeta: (_args, value) => {
+				const v = value;
+				if (!v) return "View partition unavailable.";
+				const counts = Object.entries(v.viewCounts ?? {}).map(([k, n]) => `${k}=${String(n)}`).join(", ");
+				return metaText(`${String(v.nodes?.length ?? 0)} node(s) / ${String(v.edges?.length ?? 0)} edge(s) partitioned; view counts: ${counts || "none"}${v.domain ? `; ${String(v.domain.domainCount)} domain community(ies)` : ""}`);
 			}
 		},
 		presentCall: (args) => {
@@ -7361,10 +7435,7 @@ const createGraphTools = async (ctx, options = {}) => {
 				}
 			};
 		},
-		presentResult: (_args, result) => ({
-			card: "generic",
-			title: result.isError ? "View partition failed" : "View partition Π"
-		}),
+		presentResult: presentResultWithSummary("View partition Π", "View partition failed"),
 		execute: async (args) => {
 			const a = args;
 			const data = await fetchMergedGraph(invoke, a.repoId);
@@ -7437,7 +7508,7 @@ const createGraphTools = async (ctx, options = {}) => {
 
 //#endregion
 //#region src/generated/version.ts
-const PLUGIN_VERSION = "0.3.0";
+const PLUGIN_VERSION = "0.3.1";
 
 //#endregion
 //#region src/host/config.ts
@@ -10457,7 +10528,7 @@ const resolveIndexDbPath = async (workspacePath) => {
 		layer: "upstream"
 	};
 	try {
-		const { resolveNativeIndexPath } = await import("./nativeIndex-Cx7RLXUp.js");
+		const { resolveNativeIndexPath } = await import("./nativeIndex-esaDOsq8.js");
 		return {
 			dbPath: resolveNativeIndexPath(workspacePath),
 			layer: "native"
@@ -11392,7 +11463,7 @@ function registerManageDeleteRoute(rc) {
 				const pathInput = extractStringField(parsed, "path", VALIDATION.MAX_PATH_LENGTH);
 				const deletePath = await resolveAndValidatePath(pathInput, ctx, deps, req, res, corsConfig);
 				if (deletePath === null) return;
-				const { deleteNativeIndex } = await import("./nativeIndex-Cx7RLXUp.js");
+				const { deleteNativeIndex } = await import("./nativeIndex-esaDOsq8.js");
 				const deleted = deleteNativeIndex(deletePath);
 				if (!deleted) {
 					sendJson(res, 200, {
@@ -11496,7 +11567,7 @@ function registerManageMetricsRoute(rc) {
 				const upstreamDbPath = resolveDbPath(workspacePath);
 				if (existsSync(upstreamDbPath)) dbPath = upstreamDbPath;
 				else try {
-					const { resolveNativeIndexPath } = await import("./nativeIndex-Cx7RLXUp.js");
+					const { resolveNativeIndexPath } = await import("./nativeIndex-esaDOsq8.js");
 					const nativePath = resolveNativeIndexPath(workspacePath);
 					if (existsSync(nativePath)) dbPath = nativePath;
 				} catch (e) {
@@ -11511,7 +11582,7 @@ function registerManageMetricsRoute(rc) {
 					}, req, corsConfig);
 					return;
 				}
-				const { readGraphFromDbPaged } = await import("./codeGraphDb-Bg7bWud2.js");
+				const { readGraphFromDbPaged } = await import("./codeGraphDb-B-vpZmpm.js");
 				const { mapRowsToGraphNodes: mapRowsToGraphNodes$1, mapRowsToGraphEdges: mapRowsToGraphEdges$1 } = await import("./codeGraphRows-BhZX34uB.js");
 				const MAX_NODES = METRICS.MAX_NODES;
 				const MAX_EDGES = METRICS.MAX_EDGES;
@@ -11549,7 +11620,7 @@ function registerManageMetricsRoute(rc) {
 				const truncated = !readExhausted || nodesTotal !== nodesSampled || edgesTotal !== edgesSampled;
 				let coverage = null;
 				try {
-					const { readNativeIndexCoverage } = await import("./nativeIndex-Cx7RLXUp.js");
+					const { readNativeIndexCoverage } = await import("./nativeIndex-esaDOsq8.js");
 					coverage = readNativeIndexCoverage(workspacePath);
 				} catch {
 					coverage = null;
@@ -12925,10 +12996,10 @@ function clampInt(v, min, max, dflt) {
 async function readIndexGraph(workspacePath) {
 	try {
 		const [{ resolveDbPath: resolveDbPath$1 }, { readGraphFromDb }, rows, native] = await Promise.all([
-			import("./CodeGraphAdapter-C8JvcS7m.js"),
-			import("./codeGraphDb-Bg7bWud2.js"),
+			import("./CodeGraphAdapter-CXj1hbdm.js"),
+			import("./codeGraphDb-B-vpZmpm.js"),
 			import("./codeGraphRows-BhZX34uB.js"),
-			import("./nativeIndex-Cx7RLXUp.js")
+			import("./nativeIndex-esaDOsq8.js")
 		]);
 		let dbPath = resolveDbPath$1(workspacePath);
 		if (!existsSync(dbPath)) try {
@@ -13459,14 +13530,14 @@ async function readGraphFromIndex(workspacePath) {
 	const upstreamDbPath = resolveDbPath(workspacePath);
 	if (existsSync(upstreamDbPath)) dbPath = upstreamDbPath;
 	else try {
-		const { resolveNativeIndexPath } = await import("./nativeIndex-Cx7RLXUp.js");
+		const { resolveNativeIndexPath } = await import("./nativeIndex-esaDOsq8.js");
 		const nativePath = resolveNativeIndexPath(workspacePath);
 		if (existsSync(nativePath)) dbPath = nativePath;
 	} catch (e) {
 		log$9.warn("views route: native index path rejected", e);
 	}
 	if (!dbPath) return null;
-	const { readGraphFromDbPaged } = await import("./codeGraphDb-Bg7bWud2.js");
+	const { readGraphFromDbPaged } = await import("./codeGraphDb-B-vpZmpm.js");
 	const { mapRowsToGraphNodes: mapRowsToGraphNodes$1, mapRowsToGraphEdges: mapRowsToGraphEdges$1 } = await import("./codeGraphRows-BhZX34uB.js");
 	let cursor = null;
 	const allDbNodes = [];
@@ -13854,7 +13925,7 @@ async function buildIncrementalUpdate(input) {
 	}
 	let rows = readFilesFromDb(dbPath, changedFiles);
 	if (!rows) try {
-		const { resolveNativeIndexPath } = await import("./nativeIndex-Cx7RLXUp.js");
+		const { resolveNativeIndexPath } = await import("./nativeIndex-esaDOsq8.js");
 		const nativePath = resolveNativeIndexPath(workspacePath);
 		rows = readFilesFromDb(nativePath, changedFiles);
 		if (rows) log$5.info("incremental update using native index", { changedFiles: changedFiles.length });
@@ -14849,37 +14920,45 @@ async function apply(ctx, userConfig) {
 		nativeWorkspaceRoot: primaryWorkspace
 	});
 	ctx.effect(() => {
-		const d1 = ctx.tools.register(graphStatus);
-		const d2 = ctx.tools.register(graphData);
-		const d3 = ctx.tools.register(graphSymbol);
-		const d4 = ctx.tools.register(graphImpact);
-		const d5 = ctx.tools.register(graphPathFind);
-		const d6 = ctx.tools.register(graphHealth);
-		const d7 = ctx.tools.register(graphRulesCheck);
-		const d8 = ctx.tools.register(graphFocus);
-		const d9 = ctx.tools.register(graphPathEnumerate);
-		const d10 = ctx.tools.register(graphCycles);
-		const d11 = ctx.tools.register(graphQuery);
-		const d12 = ctx.tools.register(graphIntegrity);
-		const d13 = ctx.tools.register(graphPathPattern);
-		const d14 = ctx.tools.register(graphSlice$1);
-		const d15 = ctx.tools.register(graphViews);
+		const disposers = [];
+		const failed$2 = [];
+		const safeRegister = (label, register) => {
+			try {
+				const d = register();
+				if (typeof d === "function") disposers.push(d);
+				else failed$2.push(`${label} (register returned no disposer)`);
+			} catch (err) {
+				failed$2.push(`${label} (${err instanceof Error ? err.message : String(err)})`);
+			}
+		};
+		safeRegister("graph_status", () => ctx.tools.register(graphStatus));
+		safeRegister("graph_data", () => ctx.tools.register(graphData));
+		safeRegister("graph_symbol", () => ctx.tools.register(graphSymbol));
+		safeRegister("graph_impact", () => ctx.tools.register(graphImpact));
+		safeRegister("graph_path_find", () => ctx.tools.register(graphPathFind));
+		safeRegister("graph_health", () => ctx.tools.register(graphHealth));
+		safeRegister("graph_rules_check", () => ctx.tools.register(graphRulesCheck));
+		safeRegister("graph_focus", () => ctx.tools.register(graphFocus));
+		safeRegister("graph_path_enumerate", () => ctx.tools.register(graphPathEnumerate));
+		safeRegister("graph_cycles", () => ctx.tools.register(graphCycles));
+		safeRegister("graph_query", () => ctx.tools.register(graphQuery));
+		safeRegister("graph_integrity", () => ctx.tools.register(graphIntegrity));
+		safeRegister("graph_path_pattern", () => ctx.tools.register(graphPathPattern));
+		safeRegister("graph_slice", () => ctx.tools.register(graphSlice$1));
+		safeRegister("graph_views", () => ctx.tools.register(graphViews));
+		if (failed$2.length > 0) log.warn("tool registration degraded", {
+			failed: failed$2,
+			registered: disposers.length
+		});
+		else log.info("tool registrations complete", { registered: disposers.length });
+		globalThis.__cgvRegistrationOutcome = {
+			registered: disposers.length,
+			failed: failed$2
+		};
 		return () => {
-			d1();
-			d2();
-			d3();
-			d4();
-			d5();
-			d6();
-			d7();
-			d8();
-			d9();
-			d10();
-			d11();
-			d12();
-			d13();
-			d14();
-			d15();
+			for (const d of disposers) try {
+				d();
+			} catch {}
 		};
 	}, "codegraph: tool registrations");
 	let lastGraphData = null;
@@ -14997,7 +15076,7 @@ async function apply(ctx, userConfig) {
 			securityManager.reset();
 			disposeGraphTools();
 			closeAllDbConnections();
-			import("./nativeIndex-Cx7RLXUp.js").then(({ closeNativeIndexConnections }) => closeNativeIndexConnections());
+			import("./nativeIndex-esaDOsq8.js").then(({ closeNativeIndexConnections }) => closeNativeIndexConnections());
 			graphRepo.close();
 		};
 	}, "codegraph: state cleanup");