agent-bober 0.6.2 → 0.8.0

package/dist/mcp/tools/init.js

@@ -0,0 +1,222 @@
+// ── 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";
+import { scanProject } from "../../discovery/scanner.js";
+import { generateEvalConfig } from "../../discovery/config-generator.js";
+import { synthesizePrinciples } from "../../discovery/synthesizer.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`);
+            }
+            // ── Brownfield: run auto-discovery pipeline ────────────────────
+            if (mode === "brownfield") {
+                process.stderr.write(`[bober_init] Running brownfield auto-discovery for ${projectRoot}\n`);
+                const report = await scanProject(projectRoot);
+                const evalConfig = generateEvalConfig(report);
+                const config = createDefaultConfig(projectName, mode, undefined, {
+                    planner: {
+                        maxClarifications: 5,
+                        model: "opus",
+                        provider,
+                    },
+                    generator: {
+                        model: "sonnet",
+                        maxTurnsPerSprint: 50,
+                        autoCommit: true,
+                        branchPattern: "bober/{feature-name}",
+                        provider,
+                    },
+                    evaluator: {
+                        model: "sonnet",
+                        strategies: evalConfig.strategies,
+                        maxIterations: 3,
+                        provider,
+                    },
+                    commands: evalConfig.commands,
+                });
+                // 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);
+                // Synthesize principles
+                let principles = null;
+                let principlesError = null;
+                try {
+                    principles = await synthesizePrinciples(report, projectRoot, config);
+                    const principlesPath = join(projectRoot, ".bober", "principles.md");
+                    await writeFile(principlesPath, principles, "utf-8");
+                }
+                catch (err) {
+                    principlesError = err instanceof Error ? err.message : String(err);
+                    process.stderr.write(`[bober_init] Could not synthesize principles: ${principlesError}\n`);
+                }
+                // Build discovery summary for response
+                const stack = report.detectedStack;
+                const detectedTech = [];
+                if (stack) {
+                    if (stack.hasTypescript)
+                        detectedTech.push("TypeScript");
+                    if (stack.hasReact)
+                        detectedTech.push("React");
+                    if (stack.hasNext)
+                        detectedTech.push("Next.js");
+                    if (stack.hasVite)
+                        detectedTech.push("Vite");
+                    if (stack.hasEslint)
+                        detectedTech.push("ESLint");
+                    if (stack.hasVitest)
+                        detectedTech.push("Vitest");
+                    if (stack.hasJest)
+                        detectedTech.push("Jest");
+                    if (stack.hasPlaywright)
+                        detectedTech.push("Playwright");
+                    if (stack.hasNestjs)
+                        detectedTech.push("NestJS");
+                    if (stack.hasFastify)
+                        detectedTech.push("Fastify");
+                    if (stack.hasExpress)
+                        detectedTech.push("Express");
+                    if (stack.hasPython)
+                        detectedTech.push("Python");
+                    if (stack.hasRust)
+                        detectedTech.push("Rust");
+                }
+                process.stderr.write(`[bober_init] Initialised brownfield project "${projectName}" in ${projectRoot}\n`);
+                return JSON.stringify({
+                    status: "initialised",
+                    projectName,
+                    mode,
+                    provider,
+                    configPath,
+                    boberDir: join(projectRoot, ".bober"),
+                    discovery: {
+                        detectedTech,
+                        packageManager: report.packageManager,
+                        strategies: evalConfig.strategies.map((s) => s.type),
+                        commands: evalConfig.commands,
+                    },
+                    principles: principles ?? null,
+                    principlesError,
+                    message: alreadyExists
+                        ? "Existing configuration was overwritten using auto-discovery."
+                        : "Brownfield project initialised with auto-discovered configuration.",
+                    nextStep: principles
+                        ? "Run bober_plan with a task description to generate a sprint plan."
+                        : "Run /bober-principles to generate project principles, then bober_plan.",
+                }, null, 2);
+            }
+            // ── Greenfield: use preset/default 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"principles.js","sourceRoot":"","sources":["../../../src/mcp/tools/principles.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,2DAA2D;AAC3D,yDAAyD;AAEzD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,yEAAyE;AAEzE,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAE5C,SAAS,cAAc,CAAC,WAAmB;IACzC,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAC1D,CAAC;AAED,wEAAwE;AAExE,MAAM,UAAU,sBAAsB;IACpC,YAAY,CAAC;QACX,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,oEAAoE;YACpE,kDAAkD;YAClD,oDAAoD;YACpD,0EAA0E;QAC5E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,+DAA+D;iBAClE;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAmB,EAAE;YAChE,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;YAE7C,MAAM,UAAU,GACd,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAE9D,aAAa;YACb,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;gBAClC,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;gBAE/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,UAAU,CAAC,MAAM,kBAAkB,QAAQ,IAAI,CAC5E,CAAC;gBAEF,OAAO,IAAI,CAAC,SAAS,CACnB;oBACE,MAAM,EAAE,SAAS;oBACjB,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,UAAU,CAAC,MAAM;oBAC7B,OAAO,EACL,gFAAgF;iBACnF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACJ,CAAC;YAED,YAAY;YACZ,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAClD,OAAO,IAAI,CAAC,SAAS,CACnB;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO;iBACR,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC,SAAS,CACnB;oBACE,OAAO,EAAE,IAAI;oBACb,OAAO,EACL,sEAAsE;iBACzE,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * A JSON Schema object for describing a tool's input parameters.
+ */
+export interface JsonSchemaObject {
+    type: string;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface JsonSchemaProperty {
+    type?: string;
+    description?: string;
+    enum?: unknown[];
+    default?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Definition of a single MCP tool that agent-bober exposes.
+ */
+export interface BoberToolDefinition {
+    /** The tool name as it will appear in tools/list (e.g. "bober_ping"). */
+    name: string;
+    /** Human-readable description of what the tool does. */
+    description: string;
+    /** JSON Schema object describing the tool's input parameters. */
+    inputSchema: JsonSchemaObject;
+    /** Function that executes the tool and returns a string result. */
+    handler: (args: Record<string, unknown>) => Promise<string>;
+}
+/**
+ * Register a tool in the global tool registry.
+ * If a tool with the same name is already registered, it is overwritten.
+ */
+export declare function registerTool(tool: BoberToolDefinition): void;
+/**
+ * Returns all registered tool definitions.
+ */
+export declare function getAllTools(): BoberToolDefinition[];
+/**
+ * Looks up a tool by name. Returns undefined if not found.
+ */
+export declare function getTool(name: string): BoberToolDefinition | undefined;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/registry.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,EAAE,gBAAgB,CAAC;IAC9B,mEAAmE;IACnE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,mBAAmB,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAErE"}

package/dist/mcp/tools/registry.js

@@ -0,0 +1,23 @@
+// ── Tool Registry ───────────────────────────────────────────────────
+// ── Registry implementation ─────────────────────────────────────────
+const registry = new Map();
+/**
+ * Register a tool in the global tool registry.
+ * If a tool with the same name is already registered, it is overwritten.
+ */
+export function registerTool(tool) {
+    registry.set(tool.name, tool);
+}
+/**
+ * Returns all registered tool definitions.
+ */
+export function getAllTools() {
+    return Array.from(registry.values());
+}
+/**
+ * Looks up a tool by name. Returns undefined if not found.
+ */
+export function getTool(name) {
+    return registry.get(name);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/mcp/tools/registry.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAoCvE,uEAAuE;AAEvE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAyB;IACpD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/run.ts"],"names":[],"mappings":"AAgBA,wBAAgB,eAAe,IAAI,IAAI,CA0EtC"}

package/dist/mcp/tools/run.js

@@ -0,0 +1,66 @@
+// ── bober_run tool ───────────────────────────────────────────────────
+//
+// Accepts { task: string }, starts the full pipeline asynchronously,
+// and returns immediately with a runId. The pipeline runs in the
+// background; poll bober_status to track progress.
+import { cwd } from "node:process";
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { configExists, loadConfig } from "../../config/loader.js";
+import { registerTool } from "./registry.js";
+import { runManager } from "../run-manager.js";
+// ── Registration ─────────────────────────────────────────────────────
+export function registerRunTool() {
+    registerTool({
+        name: "bober_run",
+        description: "Start the full Bober pipeline (plan + sprint + eval) asynchronously. " +
+            "Accepts a task description and returns immediately with a runId. " +
+            "Use bober_status to poll progress. Only one pipeline can run at a time.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task: {
+                    type: "string",
+                    description: "Feature or project description to build. Passed to the planner.",
+                },
+            },
+            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();
+            // Require a bober config before starting
+            const hasConfig = await configExists(projectRoot);
+            if (!hasConfig) {
+                throw new McpError(ErrorCode.InvalidRequest, "No bober.config.json found. Run bober_init first.");
+            }
+            // Reject concurrent runs with a clear error
+            if (runManager.isRunning()) {
+                const state = runManager.getStatus();
+                throw new McpError(ErrorCode.InvalidRequest, `A pipeline is already running (runId: ${state.runId}). Use bober_status to check progress.`);
+            }
+            let config;
+            try {
+                config = await loadConfig(projectRoot);
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: `Failed to load config: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+            const runId = runManager.startRun(task, projectRoot, config);
+            process.stderr.write(`[bober_run] Started pipeline run ${runId} for task: ${task.slice(0, 100)}\n`);
+            return JSON.stringify({
+                runId,
+                status: "running",
+                message: "Pipeline started. Use bober_status to check progress.",
+            }, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=run.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/mcp/tools/run.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,qEAAqE;AACrE,iEAAiE;AACjE,mDAAmD;AAEnD,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,eAAe;IAC7B,YAAY,CAAC;QACX,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,uEAAuE;YACvE,mEAAmE;YACnE,yEAAyE;QAC3E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iEAAiE;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;oBACpB,KAAK,EAAE,kDAAkD;iBAC1D,CAAC,CAAC;YACL,CAAC;YAED,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAE1B,yCAAyC;YACzC,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,4CAA4C;YAC5C,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,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YAE7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oCAAoC,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAC9E,CAAC;YAEF,OAAO,IAAI,CAAC,SAAS,CACnB;gBACE,KAAK;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EACL,uDAAuD;aAC1D,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

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

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

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

package/dist/mcp/tools/spec.js

@@ -0,0 +1,32 @@
+// ── bober_spec tool ───────────────────────────────────────────────────
+//
+// Returns the latest PlanSpec JSON.
+// If no plans exist, returns a descriptive error object.
+import { cwd } from "node:process";
+import { loadLatestSpec } from "../../state/index.js";
+import { registerTool } from "./registry.js";
+// ── Registration ─────────────────────────────────────────────────────
+export function registerSpecTool() {
+    registerTool({
+        name: "bober_spec",
+        description: "Return the latest PlanSpec JSON. " +
+            "The spec contains the project overview, feature breakdown, and sprint contracts. " +
+            "If no plan exists yet, returns an error message.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        },
+        handler: async (_args) => {
+            const projectRoot = cwd();
+            const spec = await loadLatestSpec(projectRoot);
+            if (spec === null) {
+                return JSON.stringify({
+                    error: "No plans found. Run bober_plan first.",
+                }, null, 2);
+            }
+            return JSON.stringify(spec, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../src/mcp/tools/spec.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,oCAAoC;AACpC,yDAAyD;AAEzD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,wEAAwE;AAExE,MAAM,UAAU,gBAAgB;IAC9B,YAAY,CAAC;QACX,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,mCAAmC;YACnC,mFAAmF;YACnF,kDAAkD;QACpD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAmB,EAAE;YACjE,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;YAE1B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,SAAS,CACnB;oBACE,KAAK,EAAE,uCAAuC;iBAC/C,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sprint.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/sprint.ts"],"names":[],"mappings":"AAgEA,wBAAgB,kBAAkB,IAAI,IAAI,CAwPzC"}