agent-bober 0.12.0 → 0.15.0

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

package/dist/cli/commands/postmortem.js

@@ -0,0 +1,67 @@
+/**
+ * `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 { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { generatePostmortem } from "../../incident/postmortem.js";
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+export function registerPostmortemCommand(program) {
+    const pmCmd = program
+        .command("postmortem")
+        .description("Inspect or (re)generate incident postmortems");
+    // ── postmortem generate <incidentId> ──
+    pmCmd
+        .command("generate <incidentId>")
+        .description("(Re)synthesize postmortem.md for an incident from its artifacts")
+        .action(async (incidentId) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const result = await generatePostmortem(projectRoot, incidentId);
+            process.stdout.write(chalk.green(`Postmortem written: ${result.path}\n`) +
+                chalk.gray(`  citations: ${result.citationCount}, redactions: ${result.redactionCount}` +
+                    (result.shallowWarning ? ", 5-Whys: SHALLOW (review required)" : "") +
+                    "\n"));
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                process.stderr.write(chalk.yellow(`No incident found at .bober/incidents/${incidentId}/.\n`));
+                process.exitCode = 1;
+                return;
+            }
+            process.stderr.write(chalk.red(`Failed to generate postmortem: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── postmortem show <incidentId> ──
+    pmCmd
+        .command("show <incidentId>")
+        .description("Print the postmortem.md for an incident to stdout")
+        .action(async (incidentId) => {
+        const projectRoot = await resolveRoot();
+        const path = join(projectRoot, ".bober", "incidents", incidentId, "postmortem.md");
+        try {
+            const content = await readFile(path, "utf-8");
+            process.stdout.write(content);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                process.stderr.write(chalk.yellow(`No postmortem found at ${path}. Generate it first with: bober postmortem generate ${incidentId}\n`));
+                process.exitCode = 1;
+                return;
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=postmortem.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * `agent-bober reject <checkpointId> --feedback <text>` — reject a pending
+ * disk-marker checkpoint by writing .bober/approvals/<id>.rejected.json.
+ *
+ * Stateless: does not talk to the orchestrator; communicates via filesystem.
+ * Works from any cwd inside the project (findProjectRoot() walks upward).
+ *
+ * Sprint 9 — colocated CLI command per Sprint 8/10 precedent.
+ */
+import type { Command } from "commander";
+/**
+ * Resolve the rejector identity from the environment.
+ * Uses $USER (macOS/Linux) or $USERNAME (Windows), falling back to "unknown".
+ */
+export declare function resolveRejecter(): string;
+export declare function registerRejectCommand(program: Command): void;
+//# sourceMappingURL=reject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reject.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqC5D"}

package/dist/cli/commands/reject.js

@@ -0,0 +1,52 @@
+/**
+ * `agent-bober reject <checkpointId> --feedback <text>` — reject a pending
+ * disk-marker checkpoint by writing .bober/approvals/<id>.rejected.json.
+ *
+ * Stateless: does not talk to the orchestrator; communicates via filesystem.
+ * Works from any cwd inside the project (findProjectRoot() walks upward).
+ *
+ * Sprint 9 — colocated CLI command per Sprint 8/10 precedent.
+ */
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { pendingExists } from "../../state/approval-state.js";
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+/**
+ * Resolve the rejector identity from the environment.
+ * Uses $USER (macOS/Linux) or $USERNAME (Windows), falling back to "unknown".
+ */
+export function resolveRejecter() {
+    return process.env["USER"] ?? process.env["USERNAME"] ?? "unknown";
+}
+export function registerRejectCommand(program) {
+    program
+        .command("reject <checkpointId>")
+        .description("Reject a pending checkpoint by writing the .rejected.json marker")
+        .requiredOption("--feedback <text>", "Why the checkpoint is rejected")
+        .action(async (checkpointId, opts) => {
+        const projectRoot = await resolveRoot();
+        const approvalsDir = join(projectRoot, ".bober", "approvals");
+        const rejectedPath = join(approvalsDir, `${checkpointId}.rejected.json`);
+        // Guard: pending file must exist — never write a dangling .rejected.json
+        const exists = await pendingExists(projectRoot, checkpointId);
+        if (!exists) {
+            process.stderr.write(chalk.red(`No pending checkpoint found: ${checkpointId}\n`) +
+                `  Expected: .bober/approvals/${checkpointId}.pending.json\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const payload = {
+            rejectedAt: new Date().toISOString(),
+            rejecterId: resolveRejecter(),
+            feedback: opts.feedback,
+        };
+        await writeFile(rejectedPath, JSON.stringify(payload, null, 2) + "\n", "utf-8");
+        process.stdout.write(chalk.green(`Rejected checkpoint: ${checkpointId}\n`));
+    });
+}
+//# sourceMappingURL=reject.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reject.js","sourceRoot":"","sources":["../../../src/cli/commands/reject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,KAAK,UAAU,WAAW;IACxB,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;IACrC,OAAO,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,kEAAkE,CAAC;SAC/E,cAAc,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,YAAoB,EAAE,IAA0B,EAAE,EAAE;QACjE,MAAM,WAAW,GAAG,MAAM,WAAW,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,YAAY,gBAAgB,CAAC,CAAC;QAEzE,yEAAyE;QACzE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CAAC,gCAAgC,YAAY,IAAI,CAAC;gBACzD,gCAAgC,YAAY,iBAAiB,CAChE,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG;YACd,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,UAAU,EAAE,eAAe,EAAE;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QAEF,MAAM,SAAS,CACb,YAAY,EACZ,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACvC,OAAO,CACR,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,KAAK,CAAC,wBAAwB,YAAY,IAAI,CAAC,CACtD,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * `bober rollback <incidentId>` — roll back executed changes for an incident.
+ *
+ * Each rollback step is itself a risky action that passes through the Sprint 20
+ * gate independently. Plan presentation is unconditional (even in autopilot mode)
+ * because rollback is destructive and requires explicit user consent.
+ *
+ * Flags:
+ *   --since <changeId>  Roll back only changes executed after this changeId.
+ *   --dry-run           Print the plan without executing anything.
+ *   --json              Emit plan as JSON instead of human-readable table.
+ *
+ * Exit codes:
+ *   0 — rollback completed (all steps succeeded) or --dry-run.
+ *   1 — rollback halted (a step failed) or planning error.
+ *
+ * Sprint 21 — src/cli/commands/rollback.ts
+ */
+import type { Command } from "commander";
+export declare function registerRollbackCommand(program: Command): void;
+//# sourceMappingURL=rollback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/rollback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0F9D"}