agent-bober 0.17.1 → 0.19.0

package/dist/cli/commands/do.js

@@ -0,0 +1,216 @@
+/**
+ * `bober do <findingId>` — promote a hub Finding into a bober run task.
+ *
+ * Error handling: CLI handlers MUST NOT throw. Set process.exitCode=1 and return.
+ *
+ * HARD BOUNDARY: this file MUST NOT import execa, node:child_process,
+ * or RunSpawner directly. Import the Launcher adapter from do-bridge/launcher.ts
+ * instead — it owns the RunSpawner import.
+ */
+import chalk from "chalk";
+import prompts from "prompts";
+import { findProjectRoot } from "../../utils/fs.js";
+import { loadConfig } from "../../config/loader.js";
+import { loadTeam } from "../../teams/registry.js";
+import { FactStore, factsDbPath, ensureFactsDir } from "../../state/facts.js";
+import { FactStoreFindingStore } from "../../do-bridge/finding-port.js";
+import { PromoterRegistry } from "../../do-bridge/registry.js";
+import { codingPromoter } from "../../do-bridge/coding-promoter.js";
+import { RunSpawnerLauncher } from "../../do-bridge/launcher.js";
+import { runPromotionGate } from "../../do-bridge/promote.js";
+import { reconcilePromotionsForRoot } from "../../do-bridge/reconcile.js";
+import { logger } from "../../utils/logger.js";
+// ── Root resolver ─────────────────────────────────────────────────────
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+// ── Namespace resolver ────────────────────────────────────────────────
+/**
+ * Resolve the active memory namespace from the default team.
+ * Falls back to undefined (default .bober/memory/ path) if config is absent.
+ * Never throws — config absence is not fatal.
+ */
+async function resolveDefaultNamespace(projectRoot) {
+    try {
+        const config = await loadConfig(projectRoot);
+        return loadTeam(config, undefined).memoryNamespace || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ── runDo (DI core) ───────────────────────────────────────────────────
+/**
+ * DI core for `bober do` — accepts injected FindingStore + registry so tests
+ * can drive it without opening a real DB or spawning anything.
+ *
+ * Never throws: every failure branch sets process.exitCode=1 and returns.
+ *
+ * Resolution branches:
+ *  1. finding === null          → stderr "no finding with id …" + exitCode 1 + return.
+ *  2. promoter === undefined    → stderr naming the unsupported domain + exitCode 1 + return.
+ *  3. --dry-run                 → print ONE stdout line containing plan.task + "dry-run"; NO writes.
+ *  4. non-dry-run               → gate (pending → approve/reject) → launch on approve.
+ */
+export async function runDo(store, registry, findingId, opts, deps) {
+    // Branch 1: look up the finding
+    const finding = await store.readFinding(findingId);
+    if (finding === null) {
+        process.stderr.write(chalk.red(`do: no finding with id '${findingId}'\n`));
+        process.exitCode = 1;
+        return;
+    }
+    // Branch 2: resolve the promoter
+    const promoter = registry.resolve({ domain: finding.domain, kind: finding.kind });
+    if (promoter === undefined) {
+        // Name BOTH domain and kind so an operator can tell a missing domain-only
+        // registration apart from a missing kind-specific one.
+        process.stderr.write(chalk.red(`do: unsupported (${finding.domain}, ${finding.kind}) — no promoter registered for this domain+kind\n`));
+        process.exitCode = 1;
+        return;
+    }
+    // Branch 3: build the promotion plan
+    // Cast to Finding for the promoter call — DoFinding is compatible except for
+    // promotesTo type (object vs string); codingPromoter never reads promotesTo.
+    const plan = promoter(finding);
+    const teamDisplay = plan.teamId !== undefined ? plan.teamId : "default team";
+    if (opts.dryRun) {
+        // Dry-run: print the plan and return — NO writes, NO spawns (evaluator checks this)
+        process.stdout.write(chalk.green(`[dry-run] would launch: bober run "${plan.task}" (team: ${teamDisplay})\n`));
+        return;
+    }
+    // Branch 4: non-dry-run — gate + launch
+    if (deps === undefined) {
+        // Safety net: deps are required for the real path
+        process.stderr.write(chalk.red(`do: internal error — missing deps for real launch path\n`));
+        process.exitCode = 1;
+        return;
+    }
+    const now = deps.now ?? (() => new Date().toISOString());
+    const isTTY = deps.isTTY ?? process.stdout.isTTY ?? false;
+    process.stdout.write(chalk.cyan(`do: requesting approval to launch bober run "${plan.task}" (team: ${teamDisplay})\n`));
+    try {
+        const outcome = await runPromotionGate({
+            projectRoot: deps.projectRoot,
+            findingId,
+            plan,
+            yes: opts.yes ?? false,
+            isTTY,
+            confirm: deps.confirm,
+            now,
+            pollMs: deps.pollMs,
+            timeoutMs: deps.timeoutMs,
+        });
+        if (!outcome.approved) {
+            process.stdout.write(chalk.yellow(`do: promotion rejected — no launch, finding unchanged\n`));
+            return;
+        }
+        // Approved: launch and update finding
+        const { runId, pid } = await deps.launcher.launch(plan);
+        const ref = {
+            kind: "bober-run",
+            runId,
+            launchedAt: now(),
+            status: "launched",
+        };
+        await store.setPromotion(findingId, ref, { now: now() });
+        const pidDisplay = pid !== undefined ? ` (pid ${pid})` : "";
+        process.stdout.write(chalk.green(`do: launched bober run "${plan.task}" — runId: ${runId}${pidDisplay}\n`));
+    }
+    catch (err) {
+        process.stderr.write(chalk.red(`do: launch failed — ${err instanceof Error ? err.message : String(err)}\n`));
+        process.exitCode = 1;
+    }
+}
+// ── registerDoCommand ─────────────────────────────────────────────────
+export function registerDoCommand(program) {
+    program
+        .command("do [findingId]")
+        .description("Promote a hub Finding into a bober run task, or reconcile launched promotions")
+        .option("--dry-run", "Preview the planned launch without spawning anything", false)
+        .option("--yes", "Auto-approve the promotion without prompting", false)
+        .option("--reconcile", "Reconcile launched promotions to their run outcome and exit", false)
+        .action(async (findingId, opts) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const ns = await resolveDefaultNamespace(projectRoot);
+            await ensureFactsDir(projectRoot, ns);
+            const store = new FactStore(factsDbPath(projectRoot, ns));
+            const findingStore = new FactStoreFindingStore(store);
+            // ── reconcile-only path (--reconcile flag) ──────────────────
+            if (opts.reconcile === true) {
+                try {
+                    const summary = await reconcilePromotionsForRoot(projectRoot, findingStore, () => new Date().toISOString());
+                    process.stdout.write(chalk.green(`do --reconcile: completed=${summary.completed} aborted=${summary.aborted} unchanged=${summary.unchanged}\n`));
+                }
+                finally {
+                    store.close();
+                }
+                return;
+            }
+            // ── normal promote path (bober do <id>) ─────────────────────
+            if (findingId === undefined) {
+                store.close();
+                process.stderr.write(chalk.red(`do: findingId is required (run \`bober do --reconcile\` to reconcile)\n`));
+                process.exitCode = 1;
+                return;
+            }
+            // ── Registry: add promoters here to extend the do-bridge ──────
+            // See docs/do-bridge.md for the extension point documentation.
+            // Call site referenced from docs/do-bridge.md §The Promoter Registry Extension Point.
+            const registry = new PromoterRegistry();
+            registry.register({ domain: "coding" }, codingPromoter);
+            registry.register({ domain: "projects" }, codingPromoter);
+            // STUB — not functional; registered here only to prove registry.register
+            // accepts a new PromoterKey {domain:'projects', kind:'action'}.
+            // Replace with a real projectsActionPromoter in a future sprint.
+            // bober: stub promoter; swap for a real implementation when the
+            // projects-action use case is defined.
+            const projectsActionStub = (_f) => ({
+                kind: "bober-run",
+                task: "STUB — not functional",
+            });
+            registry.register({ domain: "projects", kind: "action" }, projectsActionStub);
+            // Best-effort start-of-command reconcile — mirrors seedProjectFacts in
+            // src/orchestrator/pipeline.ts:981. A reconcile failure MUST NOT abort
+            // `bober do`. Missing/corrupt run-state files are handled inside reconcile.
+            try {
+                await reconcilePromotionsForRoot(projectRoot, findingStore, () => new Date().toISOString());
+            }
+            catch (err) {
+                logger.warn(`Reconcile skipped: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            // Build the real deps for the launch path
+            const launcher = new RunSpawnerLauncher({
+                projectRoot,
+                findingId,
+            });
+            const deps = {
+                launcher,
+                projectRoot,
+                confirm: async () => {
+                    const answer = await prompts({
+                        type: "confirm",
+                        name: "value",
+                        message: `Approve promotion for finding '${findingId}'?`,
+                        initial: false,
+                    });
+                    return answer.value === true;
+                },
+                isTTY: process.stdout.isTTY,
+            };
+            try {
+                await runDo(findingStore, registry, findingId, opts, deps);
+            }
+            finally {
+                store.close();
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`do failed: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=do.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"do.js","sourceRoot":"","sources":["../../../src/cli/commands/do.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,yEAAyE;AAEzE,KAAK,UAAU,WAAW;IACxB,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;IACrC,OAAO,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED,yEAAyE;AAEzE;;;;GAIG;AACH,KAAK,UAAU,uBAAuB,CACpC,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,eAAe,IAAI,SAAS,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AA0BD,yEAAyE;AAEzE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,KAAmB,EACnB,QAA0B,EAC1B,SAAiB,EACjB,IAAyC,EACzC,IAAgB;IAEhB,gCAAgC;IAChC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CAAC,2BAA2B,SAAS,KAAK,CAAC,CACrD,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,0EAA0E;QAC1E,uDAAuD;QACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CACP,oBAAoB,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,mDAAmD,CACvG,CACF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,qCAAqC;IACrC,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAyC,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;IAE7E,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,oFAAoF;QACpF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,KAAK,CACT,sCAAsC,IAAI,CAAC,IAAI,YAAY,WAAW,KAAK,CAC5E,CACF,CAAC;QACF,OAAO;IACT,CAAC;IAED,wCAAwC;IACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,kDAAkD;QAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CAAC,0DAA0D,CAAC,CACtE,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;IAE1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,IAAI,CACR,gDAAgD,IAAI,CAAC,IAAI,YAAY,WAAW,KAAK,CACtF,CACF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS;YACT,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;YACtB,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG;YACH,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,MAAM,CAAC,yDAAyD,CAAC,CACxE,CAAC;YACF,OAAO;QACT,CAAC;QAED,sCAAsC;QACtC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAExD,MAAM,GAAG,GAAG;YACV,IAAI,EAAE,WAAoB;YAC1B,KAAK;YACL,UAAU,EAAE,GAAG,EAAE;YACjB,MAAM,EAAE,UAAmB;SAC5B,CAAC;QAEF,MAAM,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAEzD,MAAM,UAAU,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,KAAK,CACT,2BAA2B,IAAI,CAAC,IAAI,cAAc,KAAK,GAAG,UAAU,IAAI,CACzE,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CACP,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC5E,CACF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,yEAAyE;AAEzE,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,+EAA+E,CAAC;SAC5F,MAAM,CAAC,WAAW,EAAE,sDAAsD,EAAE,KAAK,CAAC;SAClF,MAAM,CAAC,OAAO,EAAE,8CAA8C,EAAE,KAAK,CAAC;SACtE,MAAM,CAAC,aAAa,EAAE,6DAA6D,EAAE,KAAK,CAAC;SAC3F,MAAM,CAAC,KAAK,EACX,SAA6B,EAC7B,IAA8D,EAC9D,EAAE;QACF,MAAM,WAAW,GAAG,MAAM,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAEtC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YAC1D,MAAM,YAAY,GAAG,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAEtD,+DAA+D;YAC/D,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAC9C,WAAW,EACX,YAAY,EACZ,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAC/B,CAAC;oBACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,KAAK,CACT,6BAA6B,OAAO,CAAC,SAAS,YAAY,OAAO,CAAC,OAAO,cAAc,OAAO,CAAC,SAAS,IAAI,CAC7G,CACF,CAAC;gBACJ,CAAC;wBAAS,CAAC;oBACT,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,CAAC;gBACD,OAAO;YACT,CAAC;YAED,+DAA+D;YAC/D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CAAC,yEAAyE,CAAC,CACrF,CAAC;gBACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,iEAAiE;YACjE,+DAA+D;YAC/D,sFAAsF;YACtF,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;YACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,cAAc,CAAC,CAAC;YAC1D,yEAAyE;YACzE,gEAAgE;YAChE,iEAAiE;YACjE,gEAAgE;YAChE,uCAAuC;YACvC,MAAM,kBAAkB,GAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC5C,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,uBAAuB;aAC9B,CAAC,CAAC;YACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAE9E,uEAAuE;YACvE,uEAAuE;YACvE,4EAA4E;YAC5E,IAAI,CAAC;gBACH,MAAM,0BAA0B,CAC9B,WAAW,EACX,YAAY,EACZ,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAC/B,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CACT,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACzE,CAAC;YACJ,CAAC;YAED,0CAA0C;YAC1C,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC;gBACtC,WAAW;gBACX,SAAS;aACV,CAAC,CAAC;YAEH,MAAM,IAAI,GAAc;gBACtB,QAAQ;gBACR,WAAW;gBACX,OAAO,EAAE,KAAK,IAAI,EAAE;oBAClB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;wBAC3B,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE,kCAAkC,SAAS,IAAI;wBACxD,OAAO,EAAE,KAAK;qBACf,CAAC,CAAC;oBACH,OAAO,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;gBAC/B,CAAC;gBACD,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;aAC5B,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC7D,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CACP,cAAc,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACnE,CACF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * `bober evolve` — offline replay-gated prompt evolution.
+ *
+ * Reads the generator or evaluator agent prompt, proposes deterministic variants,
+ * scores each ONLY via the Sprint 2 runReplayHarness gate (never live LLM runs),
+ * keeps the Pareto frontier, and writes a promoted prompt under
+ * .bober/evolve/<runId>/promoted/ ONLY when a variant beats the baseline with
+ * zero regressions.
+ *
+ * SAFETY: this command NEVER writes under the live agent definitions directory.
+ * All outputs are confined to .bober/evolve/<runId>/.
+ *
+ * Error handling: handler MUST NOT throw. Sets process.exitCode=1 and returns
+ * on all errors. Pattern mirrors src/cli/commands/facts.ts and replay.ts.
+ */
+import type { Command } from "commander";
+export declare function registerEvolveCommand(program: Command): void;
+//# sourceMappingURL=evolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evolve.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/evolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiE5D"}

package/dist/cli/commands/evolve.js

@@ -0,0 +1,72 @@
+/**
+ * `bober evolve` — offline replay-gated prompt evolution.
+ *
+ * Reads the generator or evaluator agent prompt, proposes deterministic variants,
+ * scores each ONLY via the Sprint 2 runReplayHarness gate (never live LLM runs),
+ * keeps the Pareto frontier, and writes a promoted prompt under
+ * .bober/evolve/<runId>/promoted/ ONLY when a variant beats the baseline with
+ * zero regressions.
+ *
+ * SAFETY: this command NEVER writes under the live agent definitions directory.
+ * All outputs are confined to .bober/evolve/<runId>/.
+ *
+ * Error handling: handler MUST NOT throw. Sets process.exitCode=1 and returns
+ * on all errors. Pattern mirrors src/cli/commands/facts.ts and replay.ts.
+ */
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { loadConfig } from "../../config/loader.js";
+import { evolve } from "../../orchestrator/selfimprove/gepa.js";
+// ── Root resolver ─────────────────────────────────────────────────────────────
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+// ── registerEvolveCommand ─────────────────────────────────────────────────────
+export function registerEvolveCommand(program) {
+    program
+        .command("evolve")
+        .description("Offline replay-gated prompt evolution (scores via frozen corpus, never writes live agent definitions, never live)")
+        .requiredOption("--role <role>", "Agent role to evolve: generator | evaluator")
+        .option("--seed <n>", "Deterministic PRNG seed for variant generation", "0")
+        .option("--dry-run", "Score and report variants without writing any promoted file")
+        .action(async (opts) => {
+        const projectRoot = await resolveRoot();
+        try {
+            // Tolerant config load — absence of bober.config.json is non-fatal.
+            // Mirror replay.ts:278-293.
+            let config;
+            try {
+                config = await loadConfig(projectRoot);
+            }
+            catch {
+                config = {
+                    project: { name: "evolve", mode: "greenfield" },
+                    selfImprove: {
+                        deterministicGate: false,
+                        rubricIsolation: false,
+                        requireCitedArtifact: false,
+                        replayDir: ".bober/replay",
+                    },
+                };
+            }
+            const role = opts.role;
+            const seed = Number(opts.seed) || 0;
+            const dryRun = Boolean(opts.dryRun);
+            process.stdout.write(chalk.bold(`bober evolve: role=${role} seed=${seed} dryRun=${dryRun}\n`));
+            const result = await evolve(projectRoot, config, { role, seed, dryRun });
+            process.stdout.write(chalk.bold(`Variants tried: ${result.variantsTried}\n`));
+            if (result.promoted) {
+                process.stdout.write(chalk.green(`Promoted → ${result.winnerPath ?? "(path unavailable)"}\n`));
+            }
+            else {
+                process.stdout.write(chalk.gray(`No variant beat the baseline (zero-regression + strictly-more-improvements). Nothing promoted.\n`));
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to evolve: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=evolve.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * `bober facts <add|list|show|invalidate>` — manage semantic bi-temporal facts.
+ *
+ * Subcommands:
+ *   add         — Insert a new fact into the store.
+ *   list        — Print active (non-invalidated) facts.
+ *   show <id>   — Print one fact including provenance and temporal fields.
+ *   invalidate  — Soft-delete a fact (sets t_invalidated; never removes the row).
+ *
+ * Error handling: CLI handlers MUST NOT throw. They set process.exitCode=1 and
+ * return on all errors. Pattern mirrors src/cli/commands/memory.ts.
+ */
+import type { Command } from "commander";
+export declare function registerFactsCommand(program: Command): void;
+//# sourceMappingURL=facts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/facts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuP3D"}

package/dist/cli/commands/facts.js

@@ -0,0 +1,213 @@
+/**
+ * `bober facts <add|list|show|invalidate>` — manage semantic bi-temporal facts.
+ *
+ * Subcommands:
+ *   add         — Insert a new fact into the store.
+ *   list        — Print active (non-invalidated) facts.
+ *   show <id>   — Print one fact including provenance and temporal fields.
+ *   invalidate  — Soft-delete a fact (sets t_invalidated; never removes the row).
+ *
+ * Error handling: CLI handlers MUST NOT throw. They set process.exitCode=1 and
+ * return on all errors. Pattern mirrors src/cli/commands/memory.ts.
+ */
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { loadConfig } from "../../config/loader.js";
+import { loadTeam } from "../../teams/registry.js";
+import { FactStore, factsDbPath, ensureFactsDir, writeFact, } from "../../state/facts.js";
+// ── Root resolver ─────────────────────────────────────────────────────
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+// ── Namespace resolver ────────────────────────────────────────────────
+/**
+ * Resolve the active memory namespace from the default team.
+ * Falls back to undefined (current .bober/memory/ path) if config is missing.
+ * Never throws — config absence is not fatal for facts commands.
+ */
+async function resolveDefaultNamespace(projectRoot) {
+    try {
+        const config = await loadConfig(projectRoot);
+        return loadTeam(config, undefined).memoryNamespace || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ── registerFactsCommand ──────────────────────────────────────────────
+export function registerFactsCommand(program) {
+    const factsCmd = program
+        .command("facts")
+        .description("Inspect and manage semantic bi-temporal facts (add, list, show, invalidate)");
+    // ── facts add ────────────────────────────────────────────────────
+    factsCmd
+        .command("add")
+        .description("Insert a new semantic fact into the store")
+        .requiredOption("--scope <scope>", "Fact scope (e.g. programming)", "programming")
+        .requiredOption("--subject <subject>", "Fact subject (e.g. project)")
+        .requiredOption("--predicate <predicate>", "Fact predicate (e.g. testCommand)")
+        .requiredOption("--value <value>", "Fact value (e.g. vitest)")
+        .option("--confidence <n>", "Confidence score 0.0-1.0", "1")
+        .option("--run-id <runId>", "Source run id")
+        .action(async (opts) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const ns = await resolveDefaultNamespace(projectRoot);
+            await ensureFactsDir(projectRoot, ns);
+            // Stamp wall-clock time at handler boundary — NEVER inside the store
+            const now = new Date().toISOString();
+            const input = {
+                scope: opts.scope,
+                subject: opts.subject,
+                predicate: opts.predicate,
+                value: opts.value,
+                confidence: Math.max(0, Math.min(1, Number(opts.confidence) || 1)),
+                sourceRunId: opts.runId ?? null,
+                tValid: now,
+                tCreated: now,
+            };
+            const store = new FactStore(factsDbPath(projectRoot, ns));
+            try {
+                // Route through writeFact so duplicate/supersede reconciliation runs.
+                // No judge wired here — deterministic ADD/UPDATE/NOOP only.
+                const action = await writeFact(store, input, { now });
+                if (action === "noop") {
+                    process.stdout.write(chalk.gray(`Fact unchanged (identical value already active).\n`));
+                    process.stdout.write(`  scope:     ${input.scope}\n`);
+                    process.stdout.write(`  subject:   ${input.subject}\n`);
+                    process.stdout.write(`  predicate: ${input.predicate}\n`);
+                    process.stdout.write(`  value:     ${input.value}\n`);
+                }
+                else if (action === "update") {
+                    process.stdout.write(chalk.yellow(`Superseded — prior fact invalidated.\n`));
+                    process.stdout.write(`  scope:     ${input.scope}\n`);
+                    process.stdout.write(`  subject:   ${input.subject}\n`);
+                    process.stdout.write(`  predicate: ${input.predicate}\n`);
+                    process.stdout.write(`  value:     ${input.value}\n`);
+                    process.stdout.write(`  t_created: ${input.tCreated}\n`);
+                }
+                else {
+                    // "add" (including deterministic fallback from ambiguity branch)
+                    process.stdout.write(chalk.green(`Added fact\n`));
+                    process.stdout.write(`  scope:     ${input.scope}\n`);
+                    process.stdout.write(`  subject:   ${input.subject}\n`);
+                    process.stdout.write(`  predicate: ${input.predicate}\n`);
+                    process.stdout.write(`  value:     ${input.value}\n`);
+                    process.stdout.write(`  t_created: ${input.tCreated}\n`);
+                }
+            }
+            finally {
+                store.close();
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to add fact: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── facts list ───────────────────────────────────────────────────
+    factsCmd
+        .command("list")
+        .description("Print active (non-invalidated) facts")
+        .option("--scope <scope>", "Filter by scope", "programming")
+        .option("--subject <subject>", "Filter by subject")
+        .option("--predicate <predicate>", "Filter by predicate")
+        .action(async (opts) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const ns = await resolveDefaultNamespace(projectRoot);
+            await ensureFactsDir(projectRoot, ns);
+            const store = new FactStore(factsDbPath(projectRoot, ns));
+            try {
+                const records = store.getActiveFacts(opts.scope, opts.subject, opts.predicate);
+                if (records.length === 0) {
+                    process.stdout.write(chalk.gray("No active facts found.\n"));
+                    return;
+                }
+                process.stdout.write(chalk.bold(`${"ID".padEnd(18)} ${"SUBJECT".padEnd(20)} ${"PREDICATE".padEnd(22)} VALUE\n`));
+                process.stdout.write(`${"-".repeat(90)}\n`);
+                for (const r of records) {
+                    const valueSnippet = r.value.length > 30 ? `${r.value.slice(0, 27)}...` : r.value;
+                    process.stdout.write(`${r.id.padEnd(18)} ${r.subject.padEnd(20)} ${r.predicate.padEnd(22)} ${valueSnippet}\n`);
+                }
+            }
+            finally {
+                store.close();
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to list facts: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── facts show <id> ──────────────────────────────────────────────
+    factsCmd
+        .command("show <id>")
+        .description("Print one fact with full provenance and temporal fields")
+        .action(async (id) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const ns = await resolveDefaultNamespace(projectRoot);
+            await ensureFactsDir(projectRoot, ns);
+            const store = new FactStore(factsDbPath(projectRoot, ns));
+            try {
+                const rec = store.getFact(id);
+                if (rec === null) {
+                    process.stderr.write(chalk.yellow(`Fact not found: ${id}\n`));
+                    process.exitCode = 1;
+                    return;
+                }
+                process.stdout.write(chalk.bold(`Fact: ${rec.id}\n`));
+                process.stdout.write(`  scope:        ${rec.scope}\n`);
+                process.stdout.write(`  subject:      ${rec.subject}\n`);
+                process.stdout.write(`  predicate:    ${rec.predicate}\n`);
+                process.stdout.write(`  value:        ${rec.value}\n`);
+                process.stdout.write(`  confidence:   ${rec.confidence}\n`);
+                process.stdout.write(`  source_run:   ${rec.sourceRunId ?? "(none)"}\n`);
+                process.stdout.write(`  t_valid:      ${rec.tValid}\n`);
+                process.stdout.write(`  t_invalid:    ${rec.tInvalid ?? "(none)"}\n`);
+                process.stdout.write(`  t_created:    ${rec.tCreated}\n`);
+                process.stdout.write(`  t_invalidated: ${rec.tInvalidated ?? chalk.green("(active)")}\n`);
+            }
+            finally {
+                store.close();
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to show fact: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+    // ── facts invalidate <id> ────────────────────────────────────────
+    factsCmd
+        .command("invalidate <id>")
+        .description("Soft-delete a fact (sets t_invalidated; row is kept)")
+        .action(async (id) => {
+        const projectRoot = await resolveRoot();
+        try {
+            const ns = await resolveDefaultNamespace(projectRoot);
+            await ensureFactsDir(projectRoot, ns);
+            // Stamp wall-clock time at handler boundary — NEVER inside the store
+            const now = new Date().toISOString();
+            const store = new FactStore(factsDbPath(projectRoot, ns));
+            try {
+                const changed = store.invalidateFact(id, now);
+                if (!changed) {
+                    process.stderr.write(chalk.yellow(`Fact ${id} not found or already invalidated.\n`));
+                    process.exitCode = 1;
+                    return;
+                }
+                process.stdout.write(chalk.green(`Fact ${chalk.bold(id)} invalidated at ${now}\n`));
+            }
+            finally {
+                store.close();
+            }
+        }
+        catch (err) {
+            process.stderr.write(chalk.red(`Failed to invalidate fact: ${err instanceof Error ? err.message : String(err)}\n`));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=facts.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * `bober hub list` — print findings held in the project's own FactStore.
+ * `bober hub priority` — rank findings across siblings and write priority.md.
+ * `bober hub decide <expr>` — rank findings under decision scope ("X vs Y").
+ *
+ * Error handling: handlers MUST NOT throw. Set process.exitCode=1 and return.
+ * Pattern mirrors src/cli/commands/facts.ts and src/cli/commands/blackboard.ts.
+ */
+import type { Command } from "commander";
+import type { FindingSource } from "../../hub/finding-source.js";
+import type { Finding } from "../../hub/finding.js";
+import { type Scope } from "../../hub/scope.js";
+import type { LLMClient } from "../../providers/types.js";
+/**
+ * DI core for `hub list` — accepts an injected FindingSource so tests can
+ * drive it against an in-memory store without spawning the CLI.
+ * Prints one line per finding with title, kind, urgency, and severity.
+ */
+export declare function runHubList(source: FindingSource): void;
+/**
+ * DI core for `hub priority` / `hub decide`. Injected llm + resolved outVault
+ * keep tests offline. Ranks (judge order), renders, writes <outVault>/priority.md,
+ * prints ranked summary to stdout.
+ *
+ * Missing outVault dir → clear stderr + process.exitCode=1, NEVER throws.
+ */
+export declare function runHubPriority(findings: Finding[], scope: Scope, llm: LLMClient, outVault: string, now: Date): Promise<void>;
+export declare function registerHubCommand(program: Command): void;
+//# sourceMappingURL=hub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/hub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,KAAK,KAAK,EAAc,MAAM,oBAAoB,CAAC;AAI5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAsE1D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAWtD;AAID;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,IAAI,CAAC,CAqBf;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuIzD"}