agent-bober 0.6.2 → 0.8.0

package/dist/mcp/tools/config.js

@@ -0,0 +1,153 @@
+// ── bober_config tool ─────────────────────────────────────────────────
+//
+// No args -> read and return bober.config.json as-is.
+// With { key, value } -> update a specific dot-path field and write back.
+// e.g. key="generator.model", value="opus"
+import { readFile, writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { constants } from "node:fs";
+import { cwd } from "node:process";
+import { registerTool } from "./registry.js";
+// ── Helpers ───────────────────────────────────────────────────────────
+const CONFIG_CANDIDATES = ["bober.config.json", ".bober/config.json"];
+async function findConfigPath(projectRoot) {
+    for (const candidate of CONFIG_CANDIDATES) {
+        const fullPath = join(projectRoot, candidate);
+        try {
+            await access(fullPath, constants.R_OK);
+            return fullPath;
+        }
+        catch {
+            // not found, try next
+        }
+    }
+    return null;
+}
+/**
+ * Set a value at a dot-separated path inside a plain object.
+ * Creates intermediate objects as needed.
+ * Returns the mutated object (same reference).
+ */
+function setNestedValue(obj, dotPath, value) {
+    const parts = dotPath.split(".");
+    let cursor = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (cursor[part] === undefined ||
+            cursor[part] === null ||
+            typeof cursor[part] !== "object" ||
+            Array.isArray(cursor[part])) {
+            cursor[part] = {};
+        }
+        cursor = cursor[part];
+    }
+    const lastPart = parts[parts.length - 1];
+    cursor[lastPart] = value;
+}
+/**
+ * Attempt to coerce a string value to a more appropriate JSON type.
+ * "true"/"false" -> boolean, numeric strings -> number, else keep as string.
+ */
+function coerceValue(raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    const n = Number(raw);
+    if (!isNaN(n) && raw.trim() !== "")
+        return n;
+    return raw;
+}
+// ── Registration ─────────────────────────────────────────────────────
+export function registerConfigTool() {
+    registerTool({
+        name: "bober_config",
+        description: "Read or update the Bober project configuration (bober.config.json). " +
+            "Without arguments returns the full config as JSON. " +
+            "With key and value, updates a specific config field using dot-notation " +
+            "(e.g. key='generator.model', value='opus'). " +
+            "Numeric and boolean values are coerced automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: {
+                    type: "string",
+                    description: "Dot-separated config path to update (e.g. generator.model, evaluator.maxIterations).",
+                },
+                value: {
+                    type: "string",
+                    description: "New value for the key. Numbers and booleans are coerced automatically.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const projectRoot = cwd();
+            const configPath = await findConfigPath(projectRoot);
+            if (!configPath) {
+                return JSON.stringify({
+                    error: "No bober.config.json found. Run bober_init first.",
+                }, null, 2);
+            }
+            // Parse the existing config file
+            let rawContent;
+            try {
+                rawContent = await readFile(configPath, "utf-8");
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: `Failed to read config: ${err instanceof Error ? err.message : String(err)}`,
+                }, null, 2);
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(rawContent);
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: `Invalid JSON in config file: ${err instanceof Error ? err.message : String(err)}`,
+                }, null, 2);
+            }
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                return JSON.stringify({ error: "Config file does not contain a JSON object." }, null, 2);
+            }
+            const configObj = parsed;
+            const key = typeof args.key === "string" && args.key.trim()
+                ? args.key.trim()
+                : undefined;
+            const value = typeof args.value === "string" ? args.value : undefined;
+            // Read mode (no key provided)
+            if (key === undefined) {
+                return JSON.stringify({
+                    path: configPath,
+                    config: configObj,
+                }, null, 2);
+            }
+            // Update mode requires both key and value
+            if (value === undefined) {
+                return JSON.stringify({
+                    error: "Both key and value must be provided to update the config.",
+                }, null, 2);
+            }
+            const coerced = coerceValue(value);
+            setNestedValue(configObj, key, coerced);
+            try {
+                await writeFile(configPath, JSON.stringify(configObj, null, 2) + "\n", "utf-8");
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: `Failed to write config: ${err instanceof Error ? err.message : String(err)}`,
+                }, null, 2);
+            }
+            process.stderr.write(`[bober_config] Updated ${key} = ${JSON.stringify(coerced)} in ${configPath}\n`);
+            return JSON.stringify({
+                status: "updated",
+                path: configPath,
+                key,
+                value: coerced,
+                config: configObj,
+            }, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function registerContractsTool(): void;
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/contracts.ts"],"names":[],"mappings":"AAYA,wBAAgB,qBAAqB,IAAI,IAAI,CAmE5C"}

package/dist/mcp/tools/contracts.js

@@ -0,0 +1,61 @@
+// ── bober_contracts tool ──────────────────────────────────────────────
+//
+// No args -> list all contracts with id, feature, status, dependsOn.
+// With { contractId } -> return the full contract JSON.
+import { cwd } from "node:process";
+import { listContracts, loadContract } from "../../state/index.js";
+import { registerTool } from "./registry.js";
+// ── Registration ─────────────────────────────────────────────────────
+export function registerContractsTool() {
+    registerTool({
+        name: "bober_contracts",
+        description: "List all sprint contracts or read a specific contract. " +
+            "Without arguments returns a summary list of all contracts (id, feature, status, dependsOn). " +
+            "With contractId returns the full contract JSON including success criteria and evaluator feedback.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contractId: {
+                    type: "string",
+                    description: "Contract ID to read. Omit to list all contracts.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const projectRoot = cwd();
+            const contractId = typeof args.contractId === "string" && args.contractId.trim()
+                ? args.contractId.trim()
+                : undefined;
+            // Return full contract when contractId is provided
+            if (contractId !== undefined) {
+                try {
+                    const contract = await loadContract(projectRoot, contractId);
+                    return JSON.stringify(contract, null, 2);
+                }
+                catch (err) {
+                    return JSON.stringify({
+                        error: `Contract "${contractId}" not found.`,
+                        details: err instanceof Error ? err.message : String(err),
+                    }, null, 2);
+                }
+            }
+            // List mode
+            const contracts = await listContracts(projectRoot);
+            if (contracts.length === 0) {
+                return JSON.stringify({
+                    contracts: [],
+                    message: "No contracts found. Run bober_plan first to generate sprint contracts.",
+                }, null, 2);
+            }
+            const summary = contracts.map((c) => ({
+                id: c.id,
+                feature: c.feature,
+                status: c.status,
+                dependsOn: c.dependsOn,
+            }));
+            return JSON.stringify({ contracts: summary }, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/mcp/tools/contracts.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,qEAAqE;AACrE,wDAAwD;AAExD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,wEAAwE;AAExE,MAAM,UAAU,qBAAqB;IACnC,YAAY,CAAC;QACX,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,yDAAyD;YACzD,8FAA8F;YAC9F,mGAAmG;QACrG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kDAAkD;iBACrD;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAmB,EAAE;YAChE,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,UAAU,GACd,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;gBAC3D,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;gBACxB,CAAC,CAAC,SAAS,CAAC;YAEhB,mDAAmD;YACnD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;oBAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC3C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,IAAI,CAAC,SAAS,CACnB;wBACE,KAAK,EAAE,aAAa,UAAU,cAAc;wBAC5C,OAAO,EACL,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACnD,EACD,IAAI,EACJ,CAAC,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,YAAY;YACZ,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;YACnD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,SAAS,CACnB;oBACE,SAAS,EAAE,EAAE;oBACb,OAAO,EACL,wEAAwE;iBAC3E,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC,CAAC,CAAC;YAEJ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function registerEvalTool(): void;
+//# sourceMappingURL=eval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/eval.ts"],"names":[],"mappings":"AAwBA,wBAAgB,gBAAgB,IAAI,IAAI,CAuKvC"}

package/dist/mcp/tools/eval.js

@@ -0,0 +1,157 @@
+// ── bober_eval tool ──────────────────────────────────────────────────
+//
+// Runs the evaluator agent against a specific sprint or the most
+// recent in-progress sprint.
+// Accepts { sprintId?: string }. Returns a JSON eval result summary.
+import { cwd } from "node:process";
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { configExists, loadConfig } from "../../config/loader.js";
+import { createHandoff } from "../../orchestrator/context-handoff.js";
+import { runEvaluatorAgent } from "../../orchestrator/evaluator-agent.js";
+import { ensureBoberDir, listContracts, loadLatestSpec, } from "../../state/index.js";
+import { getCurrentBranch, getChangedFiles } from "../../utils/git.js";
+import { registerTool } from "./registry.js";
+// ── Registration ─────────────────────────────────────────────────────
+export function registerEvalTool() {
+    registerTool({
+        name: "bober_eval",
+        description: "Run the Bober evaluator agent against a sprint. " +
+            "If sprintId is omitted the most recent in-progress, evaluating, or " +
+            "needs-rework sprint is targeted (falls back to the last contract). " +
+            "Returns a JSON object with pass/fail, score, per-criterion details, " +
+            "and actionable feedback.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sprintId: {
+                    type: "string",
+                    description: "ID of the sprint contract to evaluate. Omit to target the most " +
+                        "recent active sprint.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const sprintId = typeof args.sprintId === "string" && args.sprintId.trim()
+                ? args.sprintId.trim()
+                : undefined;
+            const projectRoot = cwd();
+            const hasConfig = await configExists(projectRoot);
+            if (!hasConfig) {
+                throw new McpError(ErrorCode.InvalidRequest, "No bober.config.json found. Run bober_init first.");
+            }
+            let config;
+            try {
+                config = await loadConfig(projectRoot);
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: `Failed to load config: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+            await ensureBoberDir(projectRoot);
+            const spec = await loadLatestSpec(projectRoot);
+            if (!spec) {
+                return JSON.stringify({
+                    error: "No plan found. Run bober_plan first.",
+                });
+            }
+            const contracts = await listContracts(projectRoot);
+            if (contracts.length === 0) {
+                return JSON.stringify({
+                    error: "No sprint contracts found. Run bober_plan first.",
+                });
+            }
+            // Resolve target contract
+            let targetContract;
+            if (sprintId) {
+                targetContract = contracts.find((c) => c.id === sprintId);
+                if (!targetContract) {
+                    return JSON.stringify({
+                        error: `Sprint "${sprintId}" not found.`,
+                        available: contracts.map((c) => c.id),
+                    });
+                }
+            }
+            else {
+                targetContract = contracts.find((c) => c.status === "in-progress" ||
+                    c.status === "evaluating" ||
+                    c.status === "needs-rework");
+                if (!targetContract) {
+                    // Fall back to the last contract
+                    targetContract = contracts[contracts.length - 1];
+                }
+            }
+            process.stderr.write(`[bober_eval] Evaluating: ${targetContract.feature} (${targetContract.id})\n`);
+            // Build project context
+            let currentBranch;
+            try {
+                currentBranch = await getCurrentBranch(projectRoot);
+            }
+            catch {
+                currentBranch = "unknown";
+            }
+            const projectContext = {
+                name: config.project.name,
+                type: config.project.mode,
+                techStack: spec.techStack,
+                entryPoints: [],
+                currentBranch,
+            };
+            // Get changed files
+            let changedFiles;
+            try {
+                changedFiles = await getChangedFiles(projectRoot);
+            }
+            catch {
+                changedFiles = [];
+            }
+            const completedContracts = contracts.filter((c) => c.status === "passed");
+            const handoff = createHandoff({
+                from: "generator",
+                to: "evaluator",
+                projectContext,
+                spec,
+                currentContract: targetContract,
+                sprintHistory: completedContracts,
+                instructions: `Evaluate sprint: ${targetContract.feature}`,
+                changedFiles,
+            });
+            try {
+                const evaluation = await runEvaluatorAgent(handoff, projectRoot, config);
+                return JSON.stringify({
+                    contractId: targetContract.id,
+                    feature: targetContract.feature,
+                    passed: evaluation.passed,
+                    score: evaluation.score,
+                    summary: evaluation.summary,
+                    feedback: evaluation.results
+                        .filter((r) => !r.passed && r.feedback)
+                        .map((r) => ({ evaluator: r.evaluator, feedback: r.feedback })),
+                    results: evaluation.results.map((r) => ({
+                        evaluator: r.evaluator,
+                        passed: r.passed,
+                        score: r.score,
+                        summary: r.summary,
+                        failedCriteria: r.details
+                            .filter((d) => !d.passed)
+                            .map((d) => ({
+                            message: d.message,
+                            severity: d.severity,
+                            ...(d.file ? { file: d.file, line: d.line } : {}),
+                        })),
+                    })),
+                    timestamp: evaluation.timestamp,
+                }, null, 2);
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: `Evaluation failed: ${err instanceof Error ? err.message : String(err)}`,
+                    contractId: targetContract.id,
+                    feature: targetContract.feature,
+                });
+            }
+        },
+    });
+}
+//# sourceMappingURL=eval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../../src/mcp/tools/eval.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,iEAAiE;AACjE,6BAA6B;AAC7B,qEAAqE;AAErE,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,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,wEAAwE;AAExE,MAAM,UAAU,gBAAgB;IAC9B,YAAY,CAAC;QACX,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,kDAAkD;YAClD,qEAAqE;YACrE,qEAAqE;YACrE,sEAAsE;YACtE,0BAA0B;QAC5B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iEAAiE;wBACjE,uBAAuB;iBAC1B;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAmB,EAAE;YAChE,MAAM,QAAQ,GACZ,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;gBACvD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;gBACtB,CAAC,CAAC,SAAS,CAAC;YAEhB,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,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,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;YAElC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,sCAAsC;iBAC9C,CAAC,CAAC;YACL,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;YACnD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,kDAAkD;iBAC1D,CAAC,CAAC;YACL,CAAC;YAED,0BAA0B;YAC1B,IAAI,cAAc,CAAC;YACnB,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;gBAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,KAAK,EAAE,WAAW,QAAQ,cAAc;wBACxC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACtC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,cAAc,GAAG,SAAS,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,aAAa;oBAC1B,CAAC,CAAC,MAAM,KAAK,YAAY;oBACzB,CAAC,CAAC,MAAM,KAAK,cAAc,CAC9B,CAAC;gBAEF,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,iCAAiC;oBACjC,cAAc,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,cAAc,CAAC,OAAO,KAAK,cAAc,CAAC,EAAE,KAAK,CAC9E,CAAC;YAEF,wBAAwB;YACxB,IAAI,aAAqB,CAAC;YAC1B,IAAI,CAAC;gBACH,aAAa,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa,GAAG,SAAS,CAAC;YAC5B,CAAC;YAED,MAAM,cAAc,GAAmB;gBACrC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;gBACzB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,EAAE;gBACf,aAAa;aACd,CAAC;YAEF,oBAAoB;YACpB,IAAI,YAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,EAAE,CAAC;YACpB,CAAC;YAED,MAAM,kBAAkB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;YAE1E,MAAM,OAAO,GAAG,aAAa,CAAC;gBAC5B,IAAI,EAAE,WAAW;gBACjB,EAAE,EAAE,WAAW;gBACf,cAAc;gBACd,IAAI;gBACJ,eAAe,EAAE,cAAc;gBAC/B,aAAa,EAAE,kBAAkB;gBACjC,YAAY,EAAE,oBAAoB,cAAc,CAAC,OAAO,EAAE;gBAC1D,YAAY;aACb,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;gBAEzE,OAAO,IAAI,CAAC,SAAS,CACnB;oBACE,UAAU,EAAE,cAAc,CAAC,EAAE;oBAC7B,OAAO,EAAE,cAAc,CAAC,OAAO;oBAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,QAAQ,EAAE,UAAU,CAAC,OAAO;yBACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC;yBACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACjE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACtC,SAAS,EAAE,CAAC,CAAC,SAAS;wBACtB,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,cAAc,EAAE,CAAC,CAAC,OAAO;6BACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;6BACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACX,OAAO,EAAE,CAAC,CAAC,OAAO;4BAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;4BACpB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAClD,CAAC,CAAC;qBACN,CAAC,CAAC;oBACH,SAAS,EAAE,UAAU,CAAC,SAAS;iBAChC,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;oBAC/E,UAAU,EAAE,cAAc,CAAC,EAAE;oBAC7B,OAAO,EAAE,cAAc,CAAC,OAAO;iBAChC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Registers all built-in agent-bober MCP tools into the global registry.
+ * Call this once before starting the MCP server.
+ *
+ * Registered tools (10 total):
+ *   1. bober_init       – Initialise a project
+ *   2. bober_plan       – Generate a sprint plan
+ *   3. bober_sprint     – Execute the next sprint cycle
+ *   4. bober_eval       – Evaluate a sprint
+ *   5. bober_run        – Start the full pipeline asynchronously
+ *   6. bober_status     – Poll pipeline status
+ *   7. bober_contracts  – List/read sprint contracts
+ *   8. bober_spec       – Read the latest plan spec
+ *   9. bober_principles – Read/write .bober/principles.md
+ *  10. bober_config     – Read/update bober.config.json
+ */
+export declare function registerAllTools(): void;
+export { registerTool, getAllTools, getTool } from "./registry.js";
+export type { BoberToolDefinition, JsonSchemaObject, JsonSchemaProperty, } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAgBvC;AAED,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/mcp/tools/index.js

@@ -0,0 +1,47 @@
+// ── Tool Registration ───────────────────────────────────────────────
+//
+// This file is the central place where all MCP tools are registered.
+// Import each tool module's register function here and call it once.
+import { registerInitTool } from "./init.js";
+import { registerPlanTool } from "./plan.js";
+import { registerSprintTool } from "./sprint.js";
+import { registerEvalTool } from "./eval.js";
+import { registerRunTool } from "./run.js";
+import { registerStatusTool } from "./status.js";
+import { registerContractsTool } from "./contracts.js";
+import { registerSpecTool } from "./spec.js";
+import { registerPrinciplesTool } from "./principles.js";
+import { registerConfigTool } from "./config.js";
+/**
+ * Registers all built-in agent-bober MCP tools into the global registry.
+ * Call this once before starting the MCP server.
+ *
+ * Registered tools (10 total):
+ *   1. bober_init       – Initialise a project
+ *   2. bober_plan       – Generate a sprint plan
+ *   3. bober_sprint     – Execute the next sprint cycle
+ *   4. bober_eval       – Evaluate a sprint
+ *   5. bober_run        – Start the full pipeline asynchronously
+ *   6. bober_status     – Poll pipeline status
+ *   7. bober_contracts  – List/read sprint contracts
+ *   8. bober_spec       – Read the latest plan spec
+ *   9. bober_principles – Read/write .bober/principles.md
+ *  10. bober_config     – Read/update bober.config.json
+ */
+export function registerAllTools() {
+    // ── Core workflow tools ─────────────────────────────────────────
+    registerInitTool();
+    registerPlanTool();
+    registerSprintTool();
+    registerEvalTool();
+    // ── Async pipeline tools ────────────────────────────────────────
+    registerRunTool();
+    registerStatusTool();
+    // ── Read / configuration tools ──────────────────────────────────
+    registerContractsTool();
+    registerSpecTool();
+    registerPrinciplesTool();
+    registerConfigTool();
+}
+export { registerTool, getAllTools, getTool } from "./registry.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB;IAC9B,mEAAmE;IACnE,gBAAgB,EAAE,CAAC;IACnB,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,CAAC;IACrB,gBAAgB,EAAE,CAAC;IAEnB,mEAAmE;IACnE,eAAe,EAAE,CAAC;IAClB,kBAAkB,EAAE,CAAC;IAErB,mEAAmE;IACnE,qBAAqB,EAAE,CAAC;IACxB,gBAAgB,EAAE,CAAC;IACnB,sBAAsB,EAAE,CAAC;IACzB,kBAAkB,EAAE,CAAC;AACvB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function registerInitTool(): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/init.ts"],"names":[],"mappings":"AAsBA,wBAAgB,gBAAgB,IAAI,IAAI,CA0OvC"}