agent-bober 0.6.2 → 0.7.0

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":"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"}

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":"AAmBA,wBAAgB,gBAAgB,IAAI,IAAI,CAsIvC"}

package/dist/mcp/tools/init.js

@@ -0,0 +1,121 @@
+// ── bober_init tool ──────────────────────────────────────────────────
+//
+// Creates bober.config.json and .bober/ directories in the current
+// working directory. Accepts { preset?: string, provider?: string }.
+// Returns a confirmation message.
+import { writeFile } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { cwd } from "node:process";
+import { configExists } from "../../config/loader.js";
+import { createDefaultConfig } from "../../config/schema.js";
+import { getPresetNames } from "../../config/defaults.js";
+import { ensureBoberDir } from "../../state/index.js";
+import { registerTool } from "./registry.js";
+// ── Registration ─────────────────────────────────────────────────────
+export function registerInitTool() {
+    registerTool({
+        name: "bober_init",
+        description: "Initialise a Bober project in the current working directory. " +
+            "Creates bober.config.json and the .bober/ state directory. " +
+            "Accepts an optional preset (e.g. nextjs, react-vite, api-node) and " +
+            "an optional provider (anthropic, openai, google, openai-compat). " +
+            "If a config already exists this will overwrite it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                preset: {
+                    type: "string",
+                    description: "Optional project preset. One of: nextjs, react-vite, api-node, " +
+                        "python-api, solidity, anchor. Leave blank for a generic config.",
+                },
+                provider: {
+                    type: "string",
+                    description: "AI provider to use: anthropic (default), openai, google, openai-compat.",
+                    default: "anthropic",
+                },
+                mode: {
+                    type: "string",
+                    description: "Project mode: greenfield (default) or brownfield.",
+                    default: "greenfield",
+                },
+                projectName: {
+                    type: "string",
+                    description: "Project name. Defaults to the name of the current directory.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const projectRoot = cwd();
+            const projectName = typeof args.projectName === "string" && args.projectName.trim()
+                ? args.projectName.trim()
+                : basename(projectRoot);
+            const rawPreset = typeof args.preset === "string" && args.preset.trim()
+                ? args.preset.trim()
+                : undefined;
+            const provider = typeof args.provider === "string" && args.provider.trim()
+                ? args.provider.trim()
+                : "anthropic";
+            const rawMode = typeof args.mode === "string" && args.mode.trim()
+                ? args.mode.trim()
+                : "greenfield";
+            const mode = rawMode === "brownfield" ? "brownfield" : "greenfield";
+            // Validate preset if provided
+            if (rawPreset) {
+                const knownPresets = getPresetNames();
+                if (!knownPresets.includes(rawPreset)) {
+                    return JSON.stringify({
+                        error: `Unknown preset "${rawPreset}".`,
+                        availablePresets: knownPresets,
+                    });
+                }
+            }
+            // Warn if already initialised (but proceed — tool contract says overwrite)
+            const alreadyExists = await configExists(projectRoot);
+            if (alreadyExists) {
+                process.stderr.write(`[bober_init] Overwriting existing bober.config.json in ${projectRoot}\n`);
+            }
+            // Build config
+            const config = createDefaultConfig(projectName, mode, rawPreset, {
+                planner: {
+                    maxClarifications: 5,
+                    model: "opus",
+                    provider,
+                },
+                generator: {
+                    model: "sonnet",
+                    maxTurnsPerSprint: 50,
+                    autoCommit: true,
+                    branchPattern: "bober/{feature-name}",
+                    provider,
+                },
+                evaluator: {
+                    model: "sonnet",
+                    strategies: [],
+                    maxIterations: 3,
+                    provider,
+                },
+            });
+            // Write bober.config.json
+            const configPath = join(projectRoot, "bober.config.json");
+            await writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+            // Create .bober/ directory structure
+            await ensureBoberDir(projectRoot);
+            process.stderr.write(`[bober_init] Initialised project "${projectName}" in ${projectRoot}\n`);
+            return JSON.stringify({
+                status: "initialised",
+                projectName,
+                mode,
+                preset: rawPreset ?? null,
+                provider,
+                configPath,
+                boberDir: join(projectRoot, ".bober"),
+                message: alreadyExists
+                    ? "Existing configuration was overwritten."
+                    : "Project successfully initialised. Run bober_plan to create your first plan.",
+                nextStep: "Run bober_plan with a task description to generate a sprint plan.",
+            }, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=init.js.map

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

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

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

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

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

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

package/dist/mcp/tools/plan.js

@@ -0,0 +1,97 @@
+// ── bober_plan tool ─────────────────────────────────────────────────
+//
+// Accepts { task: string }, calls the planner agent, and returns a
+// JSON summary of the produced PlanSpec.
+import { cwd } from "node:process";
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { configExists, loadConfig } from "../../config/loader.js";
+import { createContract } from "../../contracts/sprint-contract.js";
+import { runPlanner } from "../../orchestrator/planner-agent.js";
+import { ensureBoberDir, saveContract } from "../../state/index.js";
+import { registerTool } from "./registry.js";
+// ── Registration ─────────────────────────────────────────────────────
+export function registerPlanTool() {
+    registerTool({
+        name: "bober_plan",
+        description: "Run the Bober planner agent. Accepts a task/feature description and " +
+            "produces a PlanSpec with a sprint breakdown saved to .bober/specs/. " +
+            "Returns a JSON summary with the plan title, description, and sprint list.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task: {
+                    type: "string",
+                    description: "Feature or project description to plan.",
+                },
+            },
+            required: ["task"],
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const task = String(args.task ?? "").trim();
+            if (!task) {
+                return JSON.stringify({ error: "task is required and must be a non-empty string." });
+            }
+            const projectRoot = cwd();
+            // Check config exists before attempting to load
+            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)}`,
+                    projectRoot,
+                });
+            }
+            await ensureBoberDir(projectRoot);
+            try {
+                const spec = await runPlanner(task, projectRoot, config);
+                // Generate sprint contracts from features (same as pipeline.ts)
+                const contracts = [];
+                for (const feature of spec.features) {
+                    const contract = createContract(feature.title, feature.description, feature.acceptanceCriteria.map((ac, idx) => ({
+                        id: `${feature.id}-criterion-${idx + 1}`,
+                        description: ac,
+                        verificationMethod: "agent-evaluation",
+                    })));
+                    contracts.push(contract);
+                    await saveContract(projectRoot, contract);
+                }
+                const summary = {
+                    id: spec.id,
+                    title: spec.title,
+                    description: spec.description,
+                    projectType: spec.projectType,
+                    techStack: spec.techStack,
+                    sprintCount: spec.features.length,
+                    sprints: spec.features.map((f, idx) => ({
+                        id: f.id,
+                        contractId: contracts[idx]?.id,
+                        feature: f.title,
+                        description: f.description,
+                        priority: f.priority,
+                        estimatedSprints: f.estimatedSprints,
+                        criteriaCount: f.acceptanceCriteria.length,
+                        status: "proposed",
+                    })),
+                    contractIds: contracts.map((c) => c.id),
+                    nonFunctional: spec.nonFunctional,
+                    constraints: spec.constraints,
+                    savedTo: `.bober/specs/${spec.id}.json`,
+                };
+                return JSON.stringify(summary, null, 2);
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: `Planner failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        },
+    });
+}
+//# sourceMappingURL=plan.js.map

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

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

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

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

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

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

package/dist/mcp/tools/principles.js

@@ -0,0 +1,66 @@
+// ── bober_principles tool ─────────────────────────────────────────────
+//
+// No args -> read .bober/principles.md and return content.
+// With { content } -> write/update .bober/principles.md.
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { cwd } from "node:process";
+import { ensureBoberDir } from "../../state/index.js";
+import { registerTool } from "./registry.js";
+// ── Constants ─────────────────────────────────────────────────────────
+const PRINCIPLES_FILENAME = "principles.md";
+function principlesPath(projectRoot) {
+    return join(projectRoot, ".bober", PRINCIPLES_FILENAME);
+}
+// ── Registration ─────────────────────────────────────────────────────
+export function registerPrinciplesTool() {
+    registerTool({
+        name: "bober_principles",
+        description: "Read or write the project principles file (.bober/principles.md). " +
+            "Without arguments reads the current principles. " +
+            "With content writes/replaces the principles file. " +
+            "Principles are injected into every generator and evaluator agent prompt.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                content: {
+                    type: "string",
+                    description: "Principles content to write. Omit to read current principles.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: async (args) => {
+            const projectRoot = cwd();
+            const filePath = principlesPath(projectRoot);
+            const newContent = typeof args.content === "string" ? args.content : undefined;
+            // Write mode
+            if (newContent !== undefined) {
+                await ensureBoberDir(projectRoot);
+                await writeFile(filePath, newContent, "utf-8");
+                process.stderr.write(`[bober_principles] Wrote ${newContent.length} characters to ${filePath}\n`);
+                return JSON.stringify({
+                    status: "updated",
+                    path: filePath,
+                    characters: newContent.length,
+                    message: "Principles file updated. These will be injected into all future agent prompts.",
+                }, null, 2);
+            }
+            // Read mode
+            try {
+                const content = await readFile(filePath, "utf-8");
+                return JSON.stringify({
+                    path: filePath,
+                    content,
+                }, null, 2);
+            }
+            catch {
+                return JSON.stringify({
+                    content: null,
+                    message: "No principles file. Use bober_principles with content to create one.",
+                }, null, 2);
+            }
+        },
+    });
+}
+//# sourceMappingURL=principles.js.map