agent-bober 0.12.0 → 0.17.0

package/dist/mcp/tools/approve-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve-checkpoint.js","sourceRoot":"","sources":["../../../src/mcp/tools/approve-checkpoint.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,2CAA2C;AAC3C,qEAAqE;AACrE,oEAAoE;AACpE,gDAAgD;AAChD,EAAE;AACF,mDAAmD;AACnD,0DAA0D;AAC1D,EAAE;AACF,iCAAiC;AAEjC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,YAAY,GAEb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,wEAAwE;AAExE,MAAM,UAAU,6BAA6B;IAC3C,YAAY,CAAC;QACX,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,+EAA+E;YAC/E,qEAAqE;YACrE,kDAAkD;QACpD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wBAAwB;iBACtC;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;gBACD,SAAS,EAAE;oBACT,WAAW,EAAE,0DAA0D;iBACxE;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,CAAC;YAC1B,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAmB,EAAE;YAChE,MAAM,YAAY,GAChB,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,0DAA0D;iBAClE,CAAC,CAAC;YACL,CAAC;YAED,MAAM,WAAW,GACf,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAClE,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1E,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,gCAAgC,YAAY,EAAE;iBACtD,CAAC,CAAC;YACL,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAmB;gBAC7B,UAAU;gBACV,UAAU,EAAE,eAAe,EAAE;gBAC7B,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC;YACF,MAAM,YAAY,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;YAEtD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp/tools/brownfield.js

@@ -52,7 +52,7 @@ export function registerBrownfieldTool() {
             config.project.mode = "brownfield";
             config.sprint.sprintSize = "small";
             config.pipeline.researchPhase = true;
-            const runId = runManager.startRun(task, projectRoot, config);
+            const runId = await runManager.startRun(task, projectRoot, config);
             return JSON.stringify({
                 runId,
                 status: "running",

package/dist/mcp/tools/brownfield.js.map

@@ -1 +1 @@
-{"version":3,"file":"brownfield.js","sourceRoot":"","sources":["../../../src/mcp/tools/brownfield.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,uEAAuE;AACvE,oEAAoE;AAEpE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wEAAwE;AAExE,MAAM,UAAU,sBAAsB;IACpC,YAAY,CAAC;QACX,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,2EAA2E;YAC3E,iEAAiE;YACjE,kEAAkE;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAmB,EAAE;YAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAE1B,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,mDAAmD,CACpD,CAAC;YACJ,CAAC;YAED,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;gBACrC,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,yCAAyC,KAAM,CAAC,KAAK,wCAAwC,CAC9F,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;iBACpF,CAAC,CAAC;YACL,CAAC;YAED,6BAA6B;YAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC;YAErC,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YAE7D,OAAO,IAAI,CAAC,SAAS,CACnB;gBACE,KAAK;gBACL,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,kEAAkE;aAC5E,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"brownfield.js","sourceRoot":"","sources":["../../../src/mcp/tools/brownfield.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,uEAAuE;AACvE,oEAAoE;AAEpE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wEAAwE;AAExE,MAAM,UAAU,sBAAsB;IACpC,YAAY,CAAC;QACX,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,2EAA2E;YAC3E,iEAAiE;YACjE,kEAAkE;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAmB,EAAE;YAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAE1B,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,mDAAmD,CACpD,CAAC;YACJ,CAAC;YAED,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;gBACrC,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,yCAAyC,KAAM,CAAC,KAAK,wCAAwC,CAC9F,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;iBACpF,CAAC,CAAC;YACL,CAAC;YAED,6BAA6B;YAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC;YAErC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YAEnE,OAAO,IAAI,CAAC,SAAS,CACnB;gBACE,KAAK;gBACL,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,kEAAkE;aAC5E,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp/tools/get-project-state.d.ts

@@ -0,0 +1,2 @@
+export declare function registerGetProjectStateTool(): void;
+//# sourceMappingURL=get-project-state.d.ts.map

package/dist/mcp/tools/get-project-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-project-state.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-project-state.ts"],"names":[],"mappings":"AAgCA,wBAAgB,2BAA2B,IAAI,IAAI,CAsFlD"}

package/dist/mcp/tools/get-project-state.js

@@ -0,0 +1,107 @@
+// ── bober_get_project_state tool ──────────────────────────────────────
+//
+// Aggregates per-project state counts for the cockpit sidebar.
+// Returns:
+//   { configExists, activeRunCount, lastRunAt?, openIncidentCount,
+//     pendingApprovalCount, specCount, mode? }
+//
+// Does NOT instantiate RunManager; reads disk state directly.
+// Open incidents = incidents whose status is NOT 'resolved' or 'aborted'.
+//
+// Sprint 5 (cockpit-integration)
+import { cwd } from "node:process";
+import { isAbsolute, join } from "node:path";
+import { readFile, access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { registerTool } from "./registry.js";
+import { readRunStatesFromDisk } from "../../state/run-state.js";
+import { listIncidents } from "../../incident/timeline.js";
+import { listPendingApprovals } from "../../state/approval-state.js";
+import { listSpecs } from "../../state/plan-state.js";
+// ── Helpers ───────────────────────────────────────────────────────────
+/** Open = NOT one of {resolved, aborted} — per contract assumption #2. */
+function isOpenIncident(status) {
+    return status !== "resolved" && status !== "aborted";
+}
+// ── Registration ─────────────────────────────────────────────────────
+export function registerGetProjectStateTool() {
+    registerTool({
+        name: "bober_get_project_state",
+        description: "Aggregate per-project state counts for the cockpit sidebar. " +
+            "Returns { configExists, activeRunCount, lastRunAt?, openIncidentCount, " +
+            "pendingApprovalCount, specCount, mode? }. " +
+            "Does not instantiate RunManager — reads .bober/runs/*/state.json directly. " +
+            "projectPath must be absolute.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectPath: {
+                    type: "string",
+                    description: "Absolute path to the project root.",
+                },
+            },
+            required: ["projectPath"],
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const projectPath = typeof args.projectPath === "string" ? args.projectPath : cwd();
+            if (typeof args.projectPath === "string" && !isAbsolute(args.projectPath)) {
+                return JSON.stringify({ error: "projectPath must be absolute" });
+            }
+            // configExists
+            let configExistsValue = false;
+            try {
+                await access(join(projectPath, "bober.config.json"), constants.R_OK);
+                configExistsValue = true;
+            }
+            catch {
+                // no config
+            }
+            // mode — read directly from bober.config.json (not loadConfig — too strict)
+            let mode;
+            if (configExistsValue) {
+                try {
+                    const raw = await readFile(join(projectPath, "bober.config.json"), "utf-8");
+                    const parsed = JSON.parse(raw);
+                    if (parsed.project?.mode)
+                        mode = parsed.project.mode;
+                }
+                catch {
+                    // mode stays undefined
+                }
+            }
+            // activeRunCount and lastRunAt from disk
+            const runs = await readRunStatesFromDisk(projectPath);
+            const activeRunCount = runs.filter((r) => r.status === "running").length;
+            const lastRunAt = runs.length > 0
+                ? runs.map((r) => r.startedAt).sort().slice(-1)[0]
+                : undefined;
+            // openIncidentCount
+            let openIncidentCount = 0;
+            try {
+                const incidents = await listIncidents(projectPath);
+                openIncidentCount = incidents.filter((i) => isOpenIncident(i.status)).length;
+            }
+            catch {
+                // incidents dir may not exist; treat as 0
+            }
+            // pendingApprovalCount
+            const pendingApprovals = await listPendingApprovals(projectPath);
+            const pendingApprovalCount = pendingApprovals.length;
+            // specCount
+            const specs = await listSpecs(projectPath);
+            const specCount = specs.length;
+            const result = {
+                configExists: configExistsValue,
+                activeRunCount,
+                ...(lastRunAt !== undefined ? { lastRunAt } : {}),
+                openIncidentCount,
+                pendingApprovalCount,
+                specCount,
+                ...(mode !== undefined ? { mode } : {}),
+            };
+            return JSON.stringify(result, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=get-project-state.js.map

package/dist/mcp/tools/get-project-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-project-state.js","sourceRoot":"","sources":["../../../src/mcp/tools/get-project-state.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/get-run-status.d.ts

@@ -0,0 +1,2 @@
+export declare function registerGetRunStatusTool(): void;
+//# sourceMappingURL=get-run-status.d.ts.map

package/dist/mcp/tools/get-run-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-run-status.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-run-status.ts"],"names":[],"mappings":"AAaA,wBAAgB,wBAAwB,IAAI,IAAI,CAmC/C"}

package/dist/mcp/tools/get-run-status.js

@@ -0,0 +1,40 @@
+// ── bober_get_run_status tool ────────────────────────────────────────
+//
+// Returns the full RunState for a specific run identified by runId.
+// Returns a soft-error JSON when the runId is not found.
+// Throws McpError(InvalidRequest) when runId arg is missing or empty.
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { registerTool } from "./registry.js";
+import { runManager } from "../run-manager.js";
+// ── Registration ─────────────────────────────────────────────────────
+export function registerGetRunStatusTool() {
+    registerTool({
+        name: "bober_get_run_status",
+        description: "Get the full state of a specific run by runId. " +
+            "Returns the complete RunState object including status, progress, result, and error. " +
+            "Returns a soft-error JSON when the runId is not found.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                runId: {
+                    type: "string",
+                    description: "The unique identifier of the run to look up.",
+                },
+            },
+            required: ["runId"],
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const runId = typeof args.runId === "string" ? args.runId.trim() : "";
+            if (!runId) {
+                throw new McpError(ErrorCode.InvalidRequest, "runId is required and must be a non-empty string.");
+            }
+            const state = runManager.getRun(runId);
+            if (state === null) {
+                return JSON.stringify({ error: `Run not found: ${runId}` }, null, 2);
+            }
+            return JSON.stringify(state, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=get-run-status.js.map

package/dist/mcp/tools/get-run-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-run-status.js","sourceRoot":"","sources":["../../../src/mcp/tools/get-run-status.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,oEAAoE;AACpE,yDAAyD;AACzD,sEAAsE;AAEtE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wEAAwE;AAExE,MAAM,UAAU,wBAAwB;IACtC,YAAY,CAAC;QACX,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,iDAAiD;YACjD,sFAAsF;YACtF,wDAAwD;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAmB,EAAE;YAChE,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,mDAAmD,CACpD,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kBAAkB,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACvE,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp/tools/graph-schemas.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+export declare const GraphSearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    query: string;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+export type GraphSearchInput = z.infer<typeof GraphSearchInputSchema>;
+export declare const QueryPatternSchema: z.ZodEnum<["callers_of", "callees_of", "imports_of", "tests_for"]>;
+export declare const GraphQueryInputSchema: z.ZodObject<{
+    pattern: z.ZodEnum<["callers_of", "callees_of", "imports_of", "tests_for"]>;
+    target: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    pattern: "callers_of" | "callees_of" | "imports_of" | "tests_for";
+    target: string;
+}, {
+    pattern: "callers_of" | "callees_of" | "imports_of" | "tests_for";
+    target: string;
+}>;
+export type GraphQueryInput = z.infer<typeof GraphQueryInputSchema>;
+export declare const GraphImpactInputSchema: z.ZodObject<{
+    target: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+}, {
+    target: string;
+}>;
+export type GraphImpactInput = z.infer<typeof GraphImpactInputSchema>;
+export declare const NodeRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["function", "class", "module", "symbol"]>;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    symbol: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    symbol: string;
+    kind: "symbol" | "function" | "class" | "module";
+    file: string;
+    line: number;
+    id: string;
+}, {
+    symbol: string;
+    kind: "symbol" | "function" | "class" | "module";
+    file: string;
+    line: number;
+    id: string;
+}>;
+export declare const GraphReviewContextInputSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["function", "class", "module", "symbol"]>;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        symbol: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        symbol: string;
+        kind: "symbol" | "function" | "class" | "module";
+        file: string;
+        line: number;
+        id: string;
+    }, {
+        symbol: string;
+        kind: "symbol" | "function" | "class" | "module";
+        file: string;
+        line: number;
+        id: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        symbol: string;
+        kind: "symbol" | "function" | "class" | "module";
+        file: string;
+        line: number;
+        id: string;
+    }[];
+}, {
+    nodes: {
+        symbol: string;
+        kind: "symbol" | "function" | "class" | "module";
+        file: string;
+        line: number;
+        id: string;
+    }[];
+}>;
+export type GraphReviewContextInput = z.infer<typeof GraphReviewContextInputSchema>;
+export declare const GraphOverviewInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GraphOverviewInput = z.infer<typeof GraphOverviewInputSchema>;
+export declare const GraphChangesInputSchema: z.ZodObject<{
+    since: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    since?: string | undefined;
+}, {
+    since?: string | undefined;
+}>;
+export type GraphChangesInput = z.infer<typeof GraphChangesInputSchema>;
+//# sourceMappingURL=graph-schemas.d.ts.map

package/dist/mcp/tools/graph-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-schemas.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/graph-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,eAAO,MAAM,kBAAkB,oEAK7B,CAAC;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;EAMxB,CAAC;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAExC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAGpF,eAAO,MAAM,wBAAwB,gDAAe,CAAC;AACrD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/mcp/tools/graph-schemas.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+// ── graph_search ─────────────────────────────────────────────────────
+export const GraphSearchInputSchema = z.object({
+    query: z.string().min(1, "query must be a non-empty string"),
+    limit: z.number().int().min(1).max(100).optional().default(20),
+});
+// ── graph_query ──────────────────────────────────────────────────────
+export const QueryPatternSchema = z.enum([
+    "callers_of",
+    "callees_of",
+    "imports_of",
+    "tests_for",
+]);
+export const GraphQueryInputSchema = z.object({
+    pattern: QueryPatternSchema,
+    target: z.string().min(1, "target must be a non-empty string"),
+});
+// ── graph_impact ─────────────────────────────────────────────────────
+export const GraphImpactInputSchema = z.object({
+    target: z.string().min(1, "target must be a non-empty string"),
+});
+// ── graph_review_context ─────────────────────────────────────────────
+export const NodeRefSchema = z.object({
+    id: z.string(),
+    kind: z.enum(["function", "class", "module", "symbol"]),
+    file: z.string(),
+    line: z.number().int(),
+    symbol: z.string(),
+});
+export const GraphReviewContextInputSchema = z.object({
+    nodes: z.array(NodeRefSchema).min(1, "nodes must be a non-empty array"),
+});
+// ── graph_overview ───────────────────────────────────────────────────
+export const GraphOverviewInputSchema = z.object({});
+// ── graph_changes ────────────────────────────────────────────────────
+export const GraphChangesInputSchema = z.object({
+    since: z.string().optional(),
+});
+//# sourceMappingURL=graph-schemas.js.map

package/dist/mcp/tools/graph-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-schemas.js","sourceRoot":"","sources":["../../../src/mcp/tools/graph-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kCAAkC,CAAC;IAC5D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/D,CAAC,CAAC;AAGH,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,WAAW;CACZ,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;CAC/D,CAAC,CAAC;AAGH,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;CAC/D,CAAC,CAAC;AAGH,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;CACxE,CAAC,CAAC;AAGH,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGrD,wEAAwE;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/dist/mcp/tools/graph.d.ts

@@ -0,0 +1,19 @@
+import type { BoberToolDefinition } from "./registry.js";
+import type { GraphClient } from "../../graph/client.js";
+import type { GraphFallback } from "../../graph/fallback.js";
+export interface GraphToolDeps {
+    client: GraphClient;
+    fallback: GraphFallback;
+}
+/**
+ * Single source of truth — returns 6 BoberToolDefinitions.
+ * Consumed by registerGraphTools (external MCP) and getGraphInternalTools
+ * (internal orchestrator, sprint 5).
+ */
+export declare function createGraphTools(deps: GraphToolDeps): BoberToolDefinition[];
+/**
+ * External-server registration: loops over createGraphTools and calls registerTool.
+ * Called from src/mcp/server.ts when graph.enabled && graph.exposeOnExternalMcp.
+ */
+export declare function registerGraphTools(deps: GraphToolDeps): void;
+//# sourceMappingURL=graph.d.ts.map

package/dist/mcp/tools/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/graph.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAc7D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;CACzB;AA6CD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,EAAE,CAwN3E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAI5D"}

package/dist/mcp/tools/graph.js

@@ -0,0 +1,263 @@
+// ── graph_* MCP tools ─────────────────────────────────────────────────
+//
+// Single factory for the 6 graph_* tools consumed by both:
+//   - src/mcp/server.ts (external MCP registration)
+//   - src/orchestrator/tools/index.ts via getGraphInternalTools (sprint 5)
+//
+// DRY: ONE factory (createGraphTools), ONE set of handler closures.
+import { registerTool } from "./registry.js";
+import { MAX_OUTPUT_CHARS } from "../../orchestrator/tools/handlers.js";
+import { GraphSearchInputSchema, GraphQueryInputSchema, GraphImpactInputSchema, GraphReviewContextInputSchema, GraphOverviewInputSchema, GraphChangesInputSchema, } from "./graph-schemas.js";
+// ── Truncation helper ────────────────────────────────────────────────
+// NOTE: handlers.ts truncate() produces final length > MAX_OUTPUT_CHARS.
+// This helper guarantees EXACTLY MAX_OUTPUT_CHARS when truncation occurs.
+const TRUNCATION_MARKER = "...[truncated due to MAX_OUTPUT_CHARS]";
+function truncateForGraph(s) {
+    if (s.length <= MAX_OUTPUT_CHARS)
+        return s;
+    return s.slice(0, MAX_OUTPUT_CHARS - TRUNCATION_MARKER.length) + TRUNCATION_MARKER;
+}
+// ── Output formatters ────────────────────────────────────────────────
+function formatSearchHits(hits) {
+    return hits
+        .map((h) => `${h.node.file}:${h.node.line} — ${h.node.symbol} — ${h.snippet.trim()} — score=${h.score.toFixed(3)}`)
+        .join("\n");
+}
+function formatNodeRefList(nodes) {
+    return nodes
+        .map((n) => `- \`${n.symbol}\` (${n.kind}) — ${n.file}:${n.line}`)
+        .join("\n");
+}
+function formatImpactReport(r) {
+    return [
+        `## Impact analysis`,
+        `**Root:** \`${r.root.symbol}\` — ${r.root.file}:${r.root.line}`,
+        ``,
+        `### Affected (${r.affected.length})`,
+        formatNodeRefList(r.affected) || "_none_",
+        ``,
+        `### Tests affected (${r.testsAffected.length})`,
+        formatNodeRefList(r.testsAffected) || "_none_",
+    ].join("\n");
+}
+// ── Factory ──────────────────────────────────────────────────────────
+/**
+ * Single source of truth — returns 6 BoberToolDefinitions.
+ * Consumed by registerGraphTools (external MCP) and getGraphInternalTools
+ * (internal orchestrator, sprint 5).
+ */
+export function createGraphTools(deps) {
+    const { client, fallback } = deps;
+    return [
+        // ── graph_search ─────────────────────────────────────────────
+        {
+            name: "graph_search",
+            description: "Semantic + keyword search of the project's code graph. Returns ranked symbol " +
+                "matches with file:line and a code snippet. Prefer this over grep when looking " +
+                "for functions, classes, or concepts by name or meaning. " +
+                "Args: query (string), limit (number, default 20).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Search query — symbol name, keyword, or natural-language concept.",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "Max results to return (1–100, default 20).",
+                        default: 20,
+                    },
+                },
+                required: ["query"],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const parsed = GraphSearchInputSchema.safeParse(args);
+                if (!parsed.success) {
+                    return JSON.stringify({ error: "Invalid input: " + parsed.error.message });
+                }
+                const r = await client.search(parsed.data.query, { limit: parsed.data.limit });
+                if (!r.ok) {
+                    return fallback.hint(r.reason, r.detail).message;
+                }
+                return truncateForGraph(formatSearchHits(r.data));
+            },
+        },
+        // ── graph_query ──────────────────────────────────────────────
+        {
+            name: "graph_query",
+            description: "Traverse the code graph by relationship. patterns: 'callers_of' (who calls this), " +
+                "'callees_of' (what this calls), 'imports_of' (who imports this), " +
+                "'tests_for' (which tests cover this). " +
+                "Args: pattern (enum), target (symbol-or-file:line string). " +
+                "Prefer this over grep for callers/callees/imports — much more precise.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    pattern: {
+                        type: "string",
+                        enum: ["callers_of", "callees_of", "imports_of", "tests_for"],
+                        description: "Relationship to traverse.",
+                    },
+                    target: {
+                        type: "string",
+                        description: "Target symbol or file:line string (e.g. 'myFunction' or 'src/foo.ts:42').",
+                    },
+                },
+                required: ["pattern", "target"],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const parsed = GraphQueryInputSchema.safeParse(args);
+                if (!parsed.success) {
+                    return JSON.stringify({ error: "Invalid input: " + parsed.error.message });
+                }
+                const targetStr = parsed.data.target;
+                const targetNode = {
+                    id: targetStr,
+                    kind: "symbol",
+                    file: targetStr.includes(":") ? targetStr.split(":")[0] : targetStr,
+                    line: 0,
+                    symbol: targetStr,
+                };
+                const r = await client.query(parsed.data.pattern, targetNode);
+                if (!r.ok) {
+                    return fallback.hint(r.reason, r.detail).message;
+                }
+                return truncateForGraph(formatNodeRefList(r.data));
+            },
+        },
+        // ── graph_impact ─────────────────────────────────────────────
+        {
+            name: "graph_impact",
+            description: "Compute the blast radius of changing a symbol or file. Returns the root, " +
+                "affected nodes, and affected tests. Use BEFORE editing any function/class/file " +
+                "that may be widely called. Args: target (string).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    target: {
+                        type: "string",
+                        description: "Symbol or file path to analyse impact for.",
+                    },
+                },
+                required: ["target"],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const parsed = GraphImpactInputSchema.safeParse(args);
+                if (!parsed.success) {
+                    return JSON.stringify({ error: "Invalid input: " + parsed.error.message });
+                }
+                const r = await client.impact(parsed.data.target);
+                if (!r.ok) {
+                    return fallback.hint(r.reason, r.detail).message;
+                }
+                return truncateForGraph(formatImpactReport(r.data));
+            },
+        },
+        // ── graph_review_context ─────────────────────────────────────
+        {
+            name: "graph_review_context",
+            description: "Retrieve source snippets for a set of nodes for code-review context — " +
+                "token-efficient, returns only the relevant lines. Args: nodes (NodeRef[]).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    nodes: {
+                        type: "array",
+                        description: "Array of NodeRef objects to retrieve source context for.",
+                        items: {
+                            type: "object",
+                            properties: {
+                                id: { type: "string" },
+                                kind: {
+                                    type: "string",
+                                    enum: ["function", "class", "module", "symbol"],
+                                },
+                                file: { type: "string" },
+                                line: { type: "number" },
+                                symbol: { type: "string" },
+                            },
+                            required: ["id", "kind", "file", "line", "symbol"],
+                        },
+                        minItems: 1,
+                    },
+                },
+                required: ["nodes"],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const parsed = GraphReviewContextInputSchema.safeParse(args);
+                if (!parsed.success) {
+                    return JSON.stringify({ error: "Invalid input: " + parsed.error.message });
+                }
+                const r = await client.reviewContext(parsed.data.nodes);
+                if (!r.ok) {
+                    return fallback.hint(r.reason, r.detail).message;
+                }
+                return truncateForGraph(r.data);
+            },
+        },
+        // ── graph_overview ────────────────────────────────────────────
+        {
+            name: "graph_overview",
+            description: "High-level architecture overview of the codebase: modules, communities, " +
+                "top-level structure. Use at the start of exploring an unfamiliar repo. No args.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const parsed = GraphOverviewInputSchema.safeParse(args);
+                if (!parsed.success) {
+                    return JSON.stringify({ error: "Invalid input: " + parsed.error.message });
+                }
+                const r = await client.overview();
+                if (!r.ok) {
+                    return fallback.hint(r.reason, r.detail).message;
+                }
+                return truncateForGraph(r.data);
+            },
+        },
+        // ── graph_changes ─────────────────────────────────────────────
+        {
+            name: "graph_changes",
+            description: "List nodes changed since a given commit/ref. Use for code review or impact triage. " +
+                "Args: since (string, optional — defaults to last sync).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    since: {
+                        type: "string",
+                        description: "Git ref or commit SHA to compare from (optional — defaults to last sync).",
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const parsed = GraphChangesInputSchema.safeParse(args);
+                if (!parsed.success) {
+                    return JSON.stringify({ error: "Invalid input: " + parsed.error.message });
+                }
+                const r = await client.changes(parsed.data.since);
+                if (!r.ok) {
+                    return fallback.hint(r.reason, r.detail).message;
+                }
+                return truncateForGraph(formatNodeRefList(r.data));
+            },
+        },
+    ];
+}
+/**
+ * External-server registration: loops over createGraphTools and calls registerTool.
+ * Called from src/mcp/server.ts when graph.enabled && graph.exposeOnExternalMcp.
+ */
+export function registerGraphTools(deps) {
+    for (const tool of createGraphTools(deps)) {
+        registerTool(tool);
+    }
+}
+//# sourceMappingURL=graph.js.map