agent-bober 0.12.0 → 0.17.0

package/dist/cli/commands/list-approvals.js

@@ -0,0 +1,57 @@
+/**
+ * `agent-bober list-approvals [--json]` — list all pending checkpoints awaiting approval.
+ *
+ * Stateless: reads .bober/approvals/*.pending.json from the project root.
+ * Works from any cwd inside the project (findProjectRoot() walks upward).
+ * Output: human-readable table by default, machine-readable JSON via --json flag.
+ *
+ * Sprint 9 — colocated CLI command per Sprint 8/10 precedent.
+ */
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { listPendingApprovals } from "../../state/approval-state.js";
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+/**
+ * Format a duration in milliseconds as a human-readable string (e.g. "2h 15m").
+ */
+export function formatAge(ageMs) {
+    const totalSeconds = Math.floor(ageMs / 1000);
+    const days = Math.floor(totalSeconds / 86400);
+    const hours = Math.floor((totalSeconds % 86400) / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    if (days > 0)
+        return `${days}d ${hours}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes}m`;
+    if (minutes > 0)
+        return `${minutes}m`;
+    return `${totalSeconds}s`;
+}
+export function registerListApprovalsCommand(program) {
+    program
+        .command("list-approvals")
+        .description("List all pending checkpoints awaiting approval")
+        .option("--json", "Emit machine-readable JSON instead of a table")
+        .action(async (opts) => {
+        const projectRoot = await resolveRoot();
+        const rows = await listPendingApprovals(projectRoot);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(rows, null, 2) + "\n");
+            return;
+        }
+        if (rows.length === 0) {
+            process.stdout.write("No pending checkpoints.\n");
+            return;
+        }
+        // Human-readable table header
+        process.stdout.write(chalk.cyan(`${"Checkpoint ID".padEnd(48)} ${"Age".padEnd(10)} Prompt\n`));
+        process.stdout.write(chalk.gray(`${"-".repeat(48)} ${"-".repeat(10)} ${"-".repeat(40)}\n`));
+        for (const r of rows) {
+            process.stdout.write(`${r.checkpointId.padEnd(48)} ${formatAge(r.ageMs).padEnd(10)} ${r.prompt}\n`);
+        }
+    });
+}
+//# sourceMappingURL=list-approvals.js.map

package/dist/cli/commands/list-approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-approvals.js","sourceRoot":"","sources":["../../../src/cli/commands/list-approvals.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,KAAK,UAAU,WAAW;IACxB,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;IACrC,OAAO,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAEvD,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;IAC1C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,CAAC;IAC9C,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACtC,OAAO,GAAG,YAAY,GAAG,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,+CAA+C,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,EAAE;QACzC,MAAM,WAAW,GAAG,MAAM,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAErD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,8BAA8B;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,IAAI,CACR,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,CAC7D,CACF,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CACtE,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/memory.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `bober memory <distill|list|show>` — inspect and distill self-improvement lessons.
+ *
+ * Subcommands:
+ *   distill       — Distill sprint history into deterministic lessons (idempotent).
+ *   list          — Print the bounded lesson index.
+ *   show <id>     — Print one lesson with its sourceEntryRefs provenance.
+ *
+ * Error handling: CLI handlers MUST NOT throw. They set process.exitCode=1 and
+ * return on all errors. Pattern mirrors src/cli/commands/incident.ts.
+ */
+import type { Command } from "commander";
+export declare function registerMemoryCommand(program: Command): void;
+//# sourceMappingURL=memory.d.ts.map

package/dist/cli/commands/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8I5D"}

package/dist/cli/commands/memory.js

@@ -0,0 +1,132 @@
+/**
+ * `bober memory <distill|list|show>` — inspect and distill self-improvement lessons.
+ *
+ * Subcommands:
+ *   distill       — Distill sprint history into deterministic lessons (idempotent).
+ *   list          — Print the bounded lesson index.
+ *   show <id>     — Print one lesson with its sourceEntryRefs provenance.
+ *
+ * Error handling: CLI handlers MUST NOT throw. They set process.exitCode=1 and
+ * return on all errors. Pattern mirrors src/cli/commands/incident.ts.
+ */
+import { join } from "node:path";
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { loadHistory } from "../../state/history.js";
+import { listContracts } from "../../state/sprint-state.js";
+import { appendLesson, loadLessonIndex, loadLesson, } from "../../state/memory.js";
+import { distill } from "../../orchestrator/memory/distill.js";
+import { loadEvalResults } from "../../orchestrator/memory/eval-source.js";
+// ── Root resolver ─────────────────────────────────────────────────────
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+// ── registerMemoryCommand ─────────────────────────────────────────────
+export function registerMemoryCommand(program) {
+    const memCmd = program
+        .command("memory")
+        .description("Inspect and distill self-improvement lessons (distill, list, show)");
+    // ── memory distill ────────────────────────────────────────────────
+    memCmd
+        .command("distill")
+        .description("Distill sprint history into deterministic lessons (idempotent)")
+        .action(async () => {
+        const projectRoot = await resolveRoot();
+        try {
+            const history = await loadHistory(projectRoot);
+            const contracts = await listContracts(projectRoot);
+            const evalResults = await loadEvalResults(projectRoot);
+            const drafts = distill(history, contracts, evalResults);
+            // Stamp createdAt at persist time — never inside the pure distill fn
+            const now = new Date().toISOString();
+            // Count new lessons by comparing against the pre-existing index
+            const beforeIndex = await loadLessonIndex(projectRoot, {
+                limit: Number.MAX_SAFE_INTEGER,
+            });
+            const seen = new Set(beforeIndex.map((r) => r.lessonId));
+            let added = 0;
+            for (const draft of drafts) {
+                const lesson = { ...draft, createdAt: now };
+                if (!seen.has(lesson.lessonId))
+                    added++;
+                // appendLesson already UPSERTS — re-running same lessonId = no new index line
+                await appendLesson(projectRoot, lesson);
+            }
+            process.stdout.write(chalk.green(`distilled ${drafts.length} lessons (${added} new)\n`));
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to distill: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── memory list ───────────────────────────────────────────────────
+    memCmd
+        .command("list")
+        .description("Print the bounded lesson index")
+        .option("--limit <n>", "Maximum number of lessons to show", "50")
+        .action(async (opts) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const limit = Math.max(1, Number(opts.limit) || 50);
+            const records = await loadLessonIndex(projectRoot, { limit });
+            if (records.length === 0) {
+                process.stdout.write(chalk.gray("No lessons found. Run `bober memory distill` first.\n"));
+                return;
+            }
+            process.stdout.write(chalk.bold(`${"LESSON ID".padEnd(18)} ${"CATEGORY".padEnd(22)} ${"SEV".padEnd(6)} ${"OCC".padEnd(5)} SUMMARY\n`));
+            process.stdout.write(`${"-".repeat(100)}\n`);
+            for (const r of records) {
+                const sevColored = r.severity === "high"
+                    ? chalk.red(r.severity)
+                    : r.severity === "warn"
+                        ? chalk.yellow(r.severity)
+                        : chalk.gray(r.severity);
+                const snippet = r.summarySnippet.length > 60
+                    ? `${r.summarySnippet.slice(0, 57)}...`
+                    : r.summarySnippet;
+                process.stdout.write(`${r.lessonId.padEnd(18)} ${r.category.padEnd(22)} ${(sevColored + " ".repeat(Math.max(0, 6 - r.severity.length))).padEnd(6 + (sevColored.length - r.severity.length))} ${String(r.occurrences).padEnd(5)} ${snippet}\n`);
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to list lessons: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── memory show <lessonId> ─────────────────────────────────────────
+    memCmd
+        .command("show <lessonId>")
+        .description("Print one lesson with its sourceEntryRefs provenance")
+        .action(async (lessonId) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const lesson = await loadLesson(projectRoot, lessonId);
+            process.stdout.write(chalk.bold(`Lesson: ${lesson.lessonId}\n`));
+            process.stdout.write(`Category:    ${lesson.category}\n`);
+            process.stdout.write(`Severity:    ${lesson.severity}\n`);
+            process.stdout.write(`Occurrences: ${lesson.occurrences}\n`);
+            process.stdout.write(`Created at:  ${lesson.createdAt}\n`);
+            if (lesson.tags.length > 0) {
+                process.stdout.write(`Tags:        ${lesson.tags.join(", ")}\n`);
+            }
+            process.stdout.write(`\nSummary:\n${lesson.summary}\n`);
+            process.stdout.write(`\nSource References (${lesson.sourceEntryRefs.length}):\n`);
+            for (const ref of lesson.sourceEntryRefs) {
+                process.stdout.write(`  - ${ref}\n`);
+            }
+            // Re-export the lesson path for reference
+            process.stdout.write(chalk.gray(`\nLesson file: ${join(projectRoot, ".bober", "memory", `${lesson.lessonId}.md`)}\n`));
+        }
+        catch (err) {
+            const isNotFound = err instanceof Error && err.message.includes("Lesson not found");
+            if (isNotFound) {
+                process.stderr.write(chalk.yellow(`Lesson not found: ${lessonId}\n`));
+            }
+            else {
+                process.stderr.write(chalk.red(`Failed to show lesson: ${err instanceof Error ? err.message : String(err)}\n`));
+            }
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/cli/commands/memory.js.map

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

package/dist/cli/commands/onboard.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerOnboardCommand(program: Command): void;
+//# sourceMappingURL=onboard.d.ts.map

package/dist/cli/commands/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/onboard.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuM7D"}

package/dist/cli/commands/onboard.js

@@ -0,0 +1,190 @@
+/**
+ * `agent-bober onboard` — generate onboarding documentation from the code graph.
+ *
+ * Instantiates a short-lived GraphClient + OnboardingComposer, queries the
+ * code graph for all required data, renders 5 markdown artifacts, and writes
+ * them to .bober/onboarding/. Prints a summary table on success.
+ */
+import { join, relative } from "node:path";
+import { stat } from "node:fs/promises";
+import chalk from "chalk";
+import { loadConfig } from "../../config/loader.js";
+import { findProjectRoot } from "../../utils/fs.js";
+import { TokensavePrereqCheck } from "../../graph/prereq.js";
+import { GraphArtifactStore } from "../../graph/artifact-store.js";
+import { TokensaveMcpClient } from "../../graph/mcp-client.js";
+import { IncidentLog } from "../../graph/incidents.js";
+import { GraphFallback } from "../../graph/fallback.js";
+import { GraphClient } from "../../graph/client.js";
+import { OnboardingComposer } from "../../graph/onboarding-composer.js";
+// ── Architecture doc link ──────────────────────────────────────────
+const ARCH_DOC_PATH = ".bober/architecture/arch-20260524-port-code-review-graph-architecture.md";
+const DISABLED_MSG = "Graph integration is disabled. Enable via `graph.enabled: true` in bober.config.json." +
+    ` See: ${ARCH_DOC_PATH}`;
+// ── Helper ────────────────────────────────────────────────────────
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+// ── Command ───────────────────────────────────────────────────────
+export function registerOnboardCommand(program) {
+    program
+        .command("onboard")
+        .description("Generate onboarding documentation from the code graph (.bober/onboarding/)")
+        .action(async () => {
+        const projectRoot = await resolveRoot();
+        // Load config
+        let config;
+        try {
+            config = await loadConfig(projectRoot);
+        }
+        catch {
+            process.stderr.write(DISABLED_MSG + "\n");
+            process.exitCode = 1;
+            return;
+        }
+        const graphCfg = config.graph;
+        if (!graphCfg || graphCfg.enabled === false) {
+            process.stderr.write(DISABLED_MSG + "\n");
+            process.exitCode = 1;
+            return;
+        }
+        // Prereq check
+        const checker = new TokensavePrereqCheck(graphCfg.tokensavePath ?? "tokensave");
+        const prereq = await checker.check();
+        if (!prereq.ok) {
+            process.stderr.write(`tokensave is not available. To install:\n  ${prereq.hint}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const store = new GraphArtifactStore(projectRoot);
+        await store.ensureLayout();
+        const incidents = new IncidentLog(projectRoot);
+        const fallback = new GraphFallback("dual");
+        // Spawn a short-lived MCP client for the duration of this command
+        const mcpClient = new TokensaveMcpClient(projectRoot, graphCfg, incidents, graphCfg.tokensavePath ?? "tokensave");
+        process.stdout.write(chalk.cyan("Starting graph engine...\n"));
+        try {
+            await mcpClient.start();
+        }
+        catch (err) {
+            process.stderr.write(`Failed to start graph engine: ${err instanceof Error ? err.message : String(err)}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const graphClient = new GraphClient(projectRoot, mcpClient, store, fallback, incidents, graphCfg);
+            process.stdout.write(chalk.cyan("Querying code graph...\n"));
+            // Gather all inputs for the onboarding composer
+            const [hotspotsResult, deadCodeResult, circularResult, largestResult, filesResult] = await Promise.all([
+                graphClient.search("hotspots", { limit: 20 }),
+                graphClient.search("dead code unused", { limit: 20 }),
+                graphClient.search("circular dependency", { limit: 10 }),
+                graphClient.search("largest complex", { limit: 20, kind: "function" }),
+                graphClient.search("module public api", { limit: 50 }),
+            ]);
+            // Get manifest for status
+            const manifest = await store.readManifest();
+            // Build onboarding inputs from graph results
+            const inputs = {
+                status: {
+                    tokensaveVersion: manifest?.tokensaveVersion ?? prereq.version ?? "",
+                    indexedFileCount: manifest?.indexedFileCount ?? 0,
+                },
+                hotspots: hotspotsResult.ok
+                    ? hotspotsResult.data.map((h) => ({
+                        symbol: h.node.symbol,
+                        file: h.node.file,
+                        line: h.node.line,
+                        score: h.score,
+                        reason: h.snippet || undefined,
+                    }))
+                    : [],
+                deadCode: deadCodeResult.ok
+                    ? deadCodeResult.data.map((h) => ({
+                        symbol: h.node.symbol,
+                        file: h.node.file,
+                        line: h.node.line,
+                    }))
+                    : [],
+                circular: circularResult.ok
+                    ? circularResult.data.map((h) => ({
+                        cycle: [h.node.symbol],
+                    }))
+                    : [],
+                largest: largestResult.ok
+                    ? largestResult.data.map((h) => ({
+                        symbol: h.node.symbol,
+                        file: h.node.file,
+                        line: h.node.line,
+                        loc: 0,
+                    }))
+                    : [],
+                moduleApis: filesResult.ok
+                    ? [
+                        {
+                            module: "default",
+                            symbols: filesResult.data.map((h) => ({
+                                name: h.node.symbol,
+                                file: h.node.file,
+                                line: h.node.line,
+                                hasInternalCallers: true,
+                            })),
+                        },
+                    ]
+                    : [],
+                files: filesResult.ok
+                    ? filesResult.data.map((h) => ({
+                        path: h.node.file,
+                        symbols: 1,
+                    }))
+                    : [],
+            };
+            // Render and write artifacts
+            const composer = new OnboardingComposer();
+            const artifacts = composer.render(inputs);
+            const outputDir = join(projectRoot, ".bober", "onboarding");
+            process.stdout.write(chalk.cyan(`Writing artifacts to ${outputDir}...\n`));
+            await composer.writeAll(artifacts, outputDir);
+            // Print summary table
+            const files = [
+                ["README.md", artifacts.readme],
+                ["architecture-overview.md", artifacts.architectureOverview],
+                ["hotspots.md", artifacts.hotspots],
+                ["knowledge-gaps.md", artifacts.knowledgeGaps],
+                ["communities.md", artifacts.communities],
+            ];
+            process.stdout.write("\n");
+            process.stdout.write(chalk.bold("Onboarding artifacts written:\n"));
+            process.stdout.write("\n");
+            let totalBytes = 0;
+            for (const [filename, content] of files) {
+                const filePath = join(outputDir, filename);
+                let sizeStr = `${content.length} bytes`;
+                try {
+                    const s = await stat(filePath);
+                    sizeStr = `${s.size} bytes`;
+                    totalBytes += s.size;
+                }
+                catch {
+                    totalBytes += content.length;
+                }
+                const relPath = relative(projectRoot, filePath);
+                process.stdout.write(`  ${chalk.green(relPath.padEnd(45))}  ${sizeStr}\n`);
+            }
+            process.stdout.write("\n");
+            process.stdout.write(chalk.green(`5 files written (${totalBytes} bytes total)\n`));
+            process.stdout.write(chalk.gray(`  Run: open ${outputDir}/README.md\n`));
+        }
+        finally {
+            // Always stop the MCP client
+            try {
+                await mcpClient.stop();
+            }
+            catch {
+                // Best-effort cleanup
+            }
+        }
+    });
+}
+//# sourceMappingURL=onboard.js.map

package/dist/cli/commands/onboard.js.map

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

package/dist/cli/commands/playbook.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `bober playbook <list|show|search>` — playbook library CLI.
+ *
+ * Subcommands:
+ *   list                — Print a table of all playbooks.
+ *   show <name>         — Print the raw markdown content of a playbook.
+ *   search <symptom>    — Search for playbooks matching the symptom string.
+ *
+ * Error handling: CLI handlers MUST NOT throw. They set process.exitCode=1 and
+ * return on all errors (Pattern C per briefing). Top-level main().catch() is
+ * the last-ditch fallback, not the primary error path.
+ *
+ * Sprint 25 — src/cli/commands/playbook.ts
+ */
+import type { Command } from "commander";
+export declare function registerPlaybookCommand(program: Command): void;
+//# sourceMappingURL=playbook.d.ts.map

package/dist/cli/commands/playbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/playbook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkI9D"}

package/dist/cli/commands/playbook.js

@@ -0,0 +1,123 @@
+/**
+ * `bober playbook <list|show|search>` — playbook library CLI.
+ *
+ * Subcommands:
+ *   list                — Print a table of all playbooks.
+ *   show <name>         — Print the raw markdown content of a playbook.
+ *   search <symptom>    — Search for playbooks matching the symptom string.
+ *
+ * Error handling: CLI handlers MUST NOT throw. They set process.exitCode=1 and
+ * return on all errors (Pattern C per briefing). Top-level main().catch() is
+ * the last-ditch fallback, not the primary error path.
+ *
+ * Sprint 25 — src/cli/commands/playbook.ts
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { loadPlaybooks, searchPlaybooks, HIGH_CONFIDENCE_THRESHOLD, LOW_CONFIDENCE_THRESHOLD, } from "../../incident/playbook-search.js";
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+// ── registerPlaybookCommand ───────────────────────────────────────────────────
+export function registerPlaybookCommand(program) {
+    const pbCmd = program
+        .command("playbook")
+        .description("Manage incident response playbooks (list, show, search)");
+    // ── playbook list ──
+    pbCmd
+        .command("list")
+        .description("List all available playbooks")
+        .action(async () => {
+        const projectRoot = await resolveRoot();
+        try {
+            const playbooks = await loadPlaybooks(projectRoot);
+            if (playbooks.length === 0) {
+                process.stdout.write(chalk.gray("No playbooks found in .bober/playbooks/.\n"));
+                return;
+            }
+            // Header.
+            process.stdout.write(chalk.bold(`${"NAME".padEnd(24)} ${"CLASSIFICATION".padEnd(16)} SYMPTOMS SUMMARY\n`));
+            process.stdout.write(`${"-".repeat(80)}\n`);
+            for (const pb of playbooks) {
+                const classColored = pb.classification === "emergency"
+                    ? chalk.red(pb.classification)
+                    : chalk.cyan(pb.classification);
+                const symptomSummary = pb.applicableSymptoms.slice(0, 3).join(", ");
+                const symptomTrunc = symptomSummary.length > 40
+                    ? `${symptomSummary.slice(0, 37)}...`
+                    : symptomSummary;
+                process.stdout.write(`${pb.name.padEnd(24)} ${classColored.padEnd(16 + (classColored.length - pb.classification.length))} ${symptomTrunc}\n`);
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to list playbooks: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── playbook show <name> ──
+    pbCmd
+        .command("show <name>")
+        .description("Show the full content of a playbook by name")
+        .action(async (name) => {
+        const projectRoot = await resolveRoot();
+        const filePath = join(projectRoot, ".bober", "playbooks", `${name}.md`);
+        try {
+            const content = await readFile(filePath, "utf-8");
+            process.stdout.write(content);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                process.stderr.write(chalk.yellow(`Playbook '${name}' not found at .bober/playbooks/${name}.md\n`));
+                process.exitCode = 1;
+                return;
+            }
+            process.stderr.write(chalk.red(`Failed to read playbook '${name}': ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── playbook search <symptom> ──
+    pbCmd
+        .command("search <symptom>")
+        .description("Search for playbooks matching a symptom string")
+        .action(async (symptom) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const matches = await searchPlaybooks(symptom, projectRoot);
+            if (matches.length === 0) {
+                process.stdout.write(chalk.gray(`No playbooks matched '${symptom}'.\n`));
+                return;
+            }
+            // Header.
+            process.stdout.write(chalk.bold(`${"NAME".padEnd(24)} ${"CONFIDENCE".padEnd(12)} ${"TIER".padEnd(12)} MATCHED TOKENS\n`));
+            process.stdout.write(`${"-".repeat(80)}\n`);
+            for (const m of matches) {
+                const confidenceStr = m.confidence.toFixed(2);
+                let tier;
+                let tierColored;
+                if (m.confidence >= HIGH_CONFIDENCE_THRESHOLD) {
+                    tier = "high";
+                    tierColored = chalk.green(tier);
+                }
+                else if (m.confidence >= LOW_CONFIDENCE_THRESHOLD) {
+                    tier = "suggestion";
+                    tierColored = chalk.yellow(tier);
+                }
+                else {
+                    tier = "low";
+                    tierColored = chalk.gray(tier);
+                }
+                const tokensStr = m.matchedTokens.join(", ");
+                const tokensTrunc = tokensStr.length > 30 ? `${tokensStr.slice(0, 27)}...` : tokensStr;
+                process.stdout.write(`${m.playbook.name.padEnd(24)} ${confidenceStr.padEnd(12)} ${tierColored.padEnd(12 + (tierColored.length - tier.length))} ${tokensTrunc}\n`);
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to search playbooks: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=playbook.js.map

package/dist/cli/commands/playbook.js.map

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

package/dist/cli/commands/postmortem.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `bober postmortem generate <incidentId>` — synthesize (or re-synthesize)
+ *   the postmortem.md for an incident from its artifacts.
+ * `bober postmortem show <incidentId>` — print the postmortem.md to stdout.
+ *
+ * Nested subcommand pattern mirrors src/cli/commands/audit-show.ts.
+ *
+ * Sprint 23 — src/cli/commands/postmortem.ts
+ */
+import type { Command } from "commander";
+export declare function registerPostmortemCommand(program: Command): void;
+//# sourceMappingURL=postmortem.d.ts.map

package/dist/cli/commands/postmortem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmortem.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/postmortem.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+DhE"}