spectra-cli 4.1.1 → 4.3.0

package/dist/mcp/agent-context-tools.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Feature 155 — Agent-Context MCP Tools (impact / context / detect_changes)
+ *
+ * 3 个 tool handler，建在 Feature 151 已 ship 的 UnifiedGraph + call-resolver 之上：
+ *   - impact: blast radius — 反向 BFS 找受影响 symbols
+ *   - context: 360° symbol 视图 — definition + callers + callees + imports + relatedSpec
+ *   - detect_changes: git diff → changedSymbols → impact 链
+ *
+ * 数据流：
+ *   getCachedGraphData(projectRoot)  // 来自 graph-tools.ts，含 mtime/size stale 检测
+ *     ↓
+ *   query-helpers.ts (bfsTraverse / canonicalizeSymbolId / resolveSymbolFuzzy / ...)
+ *     ↓
+ *   tool handler 输出 JSON envelope
+ *
+ * 错误处理（FR-050）：统一 envelope `{ isError: true, content: [{type:'text', text: JSON({code, message, hint?, context?})}]}`
+ * 错误 code: graph-not-built / symbol-not-found / invalid-symbol-id / invalid-input /
+ *           invalid-diff / payload-too-large / git-spawn-failed / git-timeout / internal-error
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type BfsDirection } from '../knowledge-graph/query-helpers.js';
+import { type ToolResult } from './lib/tool-response.js';
+export { recordAndReturn, writeTelemetry, type TelemetryEntry } from './lib/telemetry.js';
+interface ImpactArgs {
+    target: string;
+    depth?: number;
+    minConfidence?: number;
+    direction?: BfsDirection;
+    budget?: number;
+    projectRoot?: string;
+}
+export declare function handleImpact(args: ImpactArgs): Promise<ToolResult>;
+interface ContextArgs {
+    symbolId: string;
+    include?: Array<'callers' | 'callees' | 'imports' | 'related-spec'>;
+    projectRoot?: string;
+}
+export declare function handleContext(args: ContextArgs): Promise<ToolResult>;
+interface DetectChangesArgs {
+    diff?: string;
+    baseRef?: string;
+    projectRoot?: string;
+    depth?: number;
+    budget?: number;
+    minConfidence?: number;
+}
+export declare function handleDetectChanges(args: DetectChangesArgs): Promise<ToolResult>;
+/**
+ * 把 3 个 Agent-Context tool 注册到 MCP server。
+ * 在 server.ts 里 registerGraphTools(server) 之后调用。
+ */
+export declare function registerAgentContextTools(server: McpServer): void;
+//# sourceMappingURL=agent-context-tools.d.ts.map

package/dist/mcp/agent-context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/agent-context-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,qCAAqC,CAAC;AAc7C,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA6G1F,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAoHxE;AAeD,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,CAAC;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8G1E;AAwED,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAYD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmJtF;AA4PD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyDjE"}