agent-bober 0.18.0 → 0.19.0

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

@@ -0,0 +1,75 @@
+/** `bober calendar` — propose / apply a schedule from ranked findings + free/busy. */
+import type { Command } from "commander";
+import type { Finding, BusyInterval } from "../../calendar/types.js";
+import type { CalendarConnector } from "../../calendar/connector.js";
+/**
+ * Injectable dependencies for runCalendarPlan.
+ * Production callers pass undefined (all fields default to the real implementations).
+ * Tests inject fixture readers and a fixed clock to achieve deterministic assertions.
+ */
+export interface CalendarPlanDeps {
+    /** Override the findings reader (default: readFindingsFromFile). */
+    readFindings?: (path: string) => Promise<Finding[]>;
+    /** Override the free/busy reader (default: readBusyIntervalsFromFile). */
+    readFreeBusy?: (path: string) => Promise<BusyInterval[]>;
+    /** Override the current ISO time string (clock read ONLY at the CLI boundary). */
+    nowIso?: string;
+    /** Factory for the calendar connector used by --export-ics (default: createIcsConnector). */
+    makeConnector?: (outPath: string) => CalendarConnector;
+    /**
+     * Generate the planId for the live propose path.
+     * Default: `Date.now().toString(36)` (unique per run).
+     * Tests inject a fixed string for deterministic checkpointId assertions.
+     */
+    makePlanId?: () => string;
+    /**
+     * Override the connector name stored in the plan sidecar.
+     * Default: read from `config.calendar.connector` (or "ics" if no config).
+     * Tests inject "stub" to avoid config loading.
+     */
+    connectorName?: string;
+}
+/**
+ * Injectable dependencies for runCalendarApply.
+ * Tests inject a pre-built stub connector to avoid config loading and real I/O.
+ */
+export interface CalendarApplyDeps {
+    /** Inject a pre-built connector (bypasses config + factory). */
+    connector?: CalendarConnector;
+    /**
+     * ICS output path for the ics connector (only used when connector is 'ics').
+     * Default: <projectRoot>/.bober/calendar/schedule.ics
+     */
+    icsOutPath?: string;
+}
+/**
+ * Core logic for `bober calendar plan`.
+ *
+ * Extracted so tests can inject fixture deps without module-level mocking.
+ * The CLI .action() calls this with no deps (production path).
+ *
+ * --dry-run: prints the proposed plan to stdout only; writes NOTHING to any calendar
+ * or .ics file. No connectors exist in this sprint (sc-1-6 / nonGoals).
+ * --export-ics: writes a local RFC 5545 .ics file via the ICS connector.
+ * (no flags): live path — proposes via the approval gate; writes ZERO events until
+ *              an ApprovedMarker exists for the returned checkpointId.
+ */
+export declare function runCalendarPlan(projectRoot: string, opts: {
+    findings?: string;
+    freebusy?: string;
+    dryRun?: boolean;
+    exportIcs?: string;
+}, deps?: CalendarPlanDeps): Promise<void>;
+/**
+ * Core logic for `bober calendar apply <checkpointId>`.
+ *
+ * Detects the approved/rejected marker and calls connector.writeEvents exactly
+ * once on approval; never on rejection; prints "pending" when neither marker exists.
+ */
+export declare function runCalendarApply(projectRoot: string, checkpointId: string, deps?: CalendarApplyDeps): Promise<void>;
+/**
+ * Register the `bober calendar` command tree.
+ * Mirrors registerMedicalCommand (src/cli/commands/medical.ts:229-297).
+ */
+export declare function registerCalendarCommand(program: Command): void;
+//# sourceMappingURL=calendar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/calendar.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAKtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAmB,MAAM,yBAAyB,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAWrE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,0EAA0E;IAC1E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACzD,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACvD;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACpF,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA4Gf;AAID;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA+Df;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6B9D"}

package/dist/cli/commands/calendar.js

@@ -0,0 +1,203 @@
+/** `bober calendar` — propose / apply a schedule from ranked findings + free/busy. */
+import { join } from "node:path";
+import chalk from "chalk";
+import { findProjectRoot } from "../../utils/fs.js";
+import { planSlots } from "../../calendar/slotter.js";
+import { readFindingsFromFile, readBusyIntervalsFromFile } from "../../calendar/finding-source.js";
+import { createIcsConnector } from "../../calendar/ics-connector.js";
+import { loadConfig } from "../../config/loader.js";
+import { proposePlan, applyPlan } from "../../calendar/proposal-gate.js";
+// ── Root resolver ─────────────────────────────────────────────────────
+async function resolveRoot() {
+    const root = await findProjectRoot();
+    return root ?? process.cwd();
+}
+// ── Default planning window ───────────────────────────────────────────
+const WINDOW_DAYS = 7;
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+// ── Core (extracted for testability) ─────────────────────────────────
+/**
+ * Core logic for `bober calendar plan`.
+ *
+ * Extracted so tests can inject fixture deps without module-level mocking.
+ * The CLI .action() calls this with no deps (production path).
+ *
+ * --dry-run: prints the proposed plan to stdout only; writes NOTHING to any calendar
+ * or .ics file. No connectors exist in this sprint (sc-1-6 / nonGoals).
+ * --export-ics: writes a local RFC 5545 .ics file via the ICS connector.
+ * (no flags): live path — proposes via the approval gate; writes ZERO events until
+ *              an ApprovedMarker exists for the returned checkpointId.
+ */
+export async function runCalendarPlan(projectRoot, opts, deps = {}) {
+    try {
+        // ── 1. Read findings (pre-ranked by the hub) ──────────────────────
+        const findingsPath = opts.findings;
+        if (findingsPath === undefined) {
+            process.stderr.write(chalk.red("--findings <path> is required\n"));
+            process.exitCode = 1;
+            return;
+        }
+        const readFindings = deps.readFindings ?? readFindingsFromFile;
+        const findings = await readFindings(findingsPath);
+        // ── 2. Read free/busy intervals ───────────────────────────────────
+        const freebusyPath = opts.freebusy;
+        const readFreeBusy = deps.readFreeBusy ?? readBusyIntervalsFromFile;
+        const busy = freebusyPath !== undefined ? await readFreeBusy(freebusyPath) : [];
+        // ── 3. Build planning constraints ────────────────────────────────
+        // Clock read ONLY here at the CLI boundary (mirrors medical.ts:102).
+        const nowIso = deps.nowIso ?? new Date().toISOString();
+        const windowEndMs = Date.parse(nowIso) + WINDOW_DAYS * MS_PER_DAY;
+        const constraints = {
+            windowStartIso: nowIso,
+            windowEndIso: new Date(windowEndMs).toISOString(),
+        };
+        // ── 4. Slot-fill (pure, synchronous, LLM-free) ───────────────────
+        const plan = planSlots(findings, busy, constraints);
+        // ── 5. Print proposed plan (stdout only — dry-run writes nothing) ─
+        process.stdout.write(chalk.bold("\nProposed calendar plan\n"));
+        process.stdout.write(`Window: ${constraints.windowStartIso} → ${constraints.windowEndIso}\n\n`);
+        if (plan.scheduled.length === 0 && plan.unscheduled.length === 0) {
+            process.stdout.write(chalk.yellow("No findings to schedule.\n"));
+            return;
+        }
+        if (plan.scheduled.length > 0) {
+            process.stdout.write(chalk.green(`Scheduled (${plan.scheduled.length}):\n`));
+            for (const item of plan.scheduled) {
+                process.stdout.write(`  [${item.startIso} → ${item.endIso}]  ${item.title}\n`);
+            }
+        }
+        if (plan.unscheduled.length > 0) {
+            process.stdout.write(chalk.yellow(`\nUnscheduled (${plan.unscheduled.length}):\n`));
+            for (const entry of plan.unscheduled) {
+                process.stdout.write(`  ${entry.findingId}  reason: ${entry.reason}\n`);
+            }
+        }
+        // ── 6. --export-ics → write VCALENDAR via the connector ──────────
+        if (opts.exportIcs !== undefined) {
+            const makeConnector = deps.makeConnector ??
+                ((outPath) => createIcsConnector({ outPath, freeBusyPath: opts.freebusy, nowIso }));
+            const connector = makeConnector(opts.exportIcs);
+            const result = await connector.writeEvents(plan.scheduled);
+            process.stdout.write(chalk.green(`\nWrote ${result.writtenCount} event(s) to ${result.target}\n`));
+        }
+        if (opts.dryRun === true) {
+            process.stdout.write(chalk.gray("\n(dry-run — nothing written to any calendar)\n"));
+        }
+        // ── 7. Live path: no flags → propose via approval gate ───────────
+        // No auto-approve in ANY mode (contract nonGoal). Approval is strictly out-of-band
+        // via `bober approve <checkpointId>` or `/approve <checkpointId>` in chat.
+        if (opts.dryRun !== true && opts.exportIcs === undefined) {
+            const planId = deps.makePlanId !== undefined ? deps.makePlanId() : Date.now().toString(36);
+            // Determine connector name from config (informational for the marker summary)
+            let connName = deps.connectorName;
+            if (connName === undefined) {
+                try {
+                    const config = await loadConfig(projectRoot);
+                    connName = config.calendar?.connector ?? "ics";
+                }
+                catch {
+                    connName = "ics"; // bober: no-config fallback; upgrade: surface config-missing warning
+                }
+            }
+            const { checkpointId } = await proposePlan({
+                projectRoot,
+                planId,
+                plan,
+                connectorName: connName,
+                now: () => nowIso,
+            });
+            process.stdout.write(chalk.green(`\nProposal saved. Approve to write events:\n`));
+            process.stdout.write(`  bober approve ${checkpointId}\n`);
+            process.stdout.write(`  /approve ${checkpointId}  (in chat)\n`);
+            process.stdout.write(chalk.gray(`\nCheckpoint ID: ${checkpointId}\n`));
+        }
+    }
+    catch (err) {
+        process.stderr.write(chalk.red(`Failed to plan: ${err instanceof Error ? err.message : String(err)}\n`));
+        // CLI handlers MUST NOT throw — set exitCode and return (mirrors medical.ts:268-269).
+        process.exitCode = 1;
+    }
+}
+// ── runCalendarApply (extracted for testability) ──────────────────────
+/**
+ * Core logic for `bober calendar apply <checkpointId>`.
+ *
+ * Detects the approved/rejected marker and calls connector.writeEvents exactly
+ * once on approval; never on rejection; prints "pending" when neither marker exists.
+ */
+export async function runCalendarApply(projectRoot, checkpointId, deps = {}) {
+    try {
+        let connector = deps.connector;
+        if (connector === undefined) {
+            // Determine connector type from config
+            let connectorType = "ics";
+            try {
+                const config = await loadConfig(projectRoot);
+                connectorType = config.calendar?.connector ?? "ics";
+            }
+            catch {
+                // bober: no-config fallback to ics; upgrade: surface warning to user
+            }
+            if (connectorType === "google") {
+                process.stderr.write(chalk.red("Google Calendar apply requires OAuth token provisioning.\n" +
+                    "  Provision the token sidecar and use the programmatic API.\n" +
+                    "  Fallback: use `bober calendar plan --export-ics <path>` for local .ics output.\n"));
+                process.exitCode = 1;
+                return;
+            }
+            // ICS connector: use injected path or default
+            const outPath = deps.icsOutPath ??
+                join(projectRoot, ".bober", "calendar", "schedule.ics");
+            connector = createIcsConnector({ outPath, nowIso: new Date().toISOString() });
+        }
+        const outcome = await applyPlan(projectRoot, checkpointId, connector);
+        switch (outcome.status) {
+            case "applied":
+                process.stdout.write(chalk.green(`Applied: ${outcome.writtenCount} event(s) written.\n`));
+                break;
+            case "rejected":
+                process.stderr.write(chalk.red(`Plan rejected.${outcome.feedback !== undefined ? ` Reason: ${outcome.feedback}` : ""}\n`));
+                process.exitCode = 1;
+                break;
+            case "pending":
+                process.stdout.write(chalk.yellow(`Pending approval. Approve with:\n  bober approve ${checkpointId}\n  /approve ${checkpointId}  (in chat)\n`));
+                break;
+        }
+    }
+    catch (err) {
+        process.stderr.write(chalk.red(`Failed to apply: ${err instanceof Error ? err.message : String(err)}\n`));
+        process.exitCode = 1;
+    }
+}
+// ── registerCalendarCommand ───────────────────────────────────────────
+/**
+ * Register the `bober calendar` command tree.
+ * Mirrors registerMedicalCommand (src/cli/commands/medical.ts:229-297).
+ */
+export function registerCalendarCommand(program) {
+    const calendarCmd = program
+        .command("calendar")
+        .description("Calendar planner utilities");
+    // ── calendar plan ─────────────────────────────────────────────────
+    calendarCmd
+        .command("plan")
+        .description("Propose a schedule from ranked findings + free/busy (deterministic, LLM-free)")
+        .option("--dry-run", "print the proposed plan; write nothing to any calendar")
+        .option("--findings <path>", "ranked findings JSON file (Finding[] ordered by priority)")
+        .option("--freebusy <path>", "free/busy intervals JSON file (BusyInterval[])")
+        .option("--export-ics <path>", "write the scheduled plan to an RFC 5545 .ics file (local, no network)")
+        .action(async (opts) => {
+        const projectRoot = await resolveRoot();
+        await runCalendarPlan(projectRoot, opts);
+    });
+    // ── calendar apply ────────────────────────────────────────────────
+    calendarCmd
+        .command("apply <checkpointId>")
+        .description("Write events for an approved calendar plan (approve with: bober approve <id>)")
+        .option("--out <path>", "ICS output path (only used with ics connector)")
+        .action(async (checkpointId, opts) => {
+        const projectRoot = await resolveRoot();
+        await runCalendarApply(projectRoot, checkpointId, { icsOutPath: opts.out });
+    });
+}
+//# sourceMappingURL=calendar.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * `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 type { Command } from "commander";
+import type { FindingStore } from "../../do-bridge/finding-port.js";
+import { PromoterRegistry } from "../../do-bridge/registry.js";
+import type { Launcher } from "../../do-bridge/launcher.js";
+/**
+ * Injected dependencies for the real (non-dry-run) launch path.
+ * OPTIONAL so the 12 existing Sprint-1 tests (4-arg calls that hit
+ * dry-run/error branches) still compile without providing deps.
+ */
+export interface RunDoDeps {
+    /** Launcher port — injected so tests use a fake and never spawn a real process. */
+    launcher: Launcher;
+    /** Absolute project root for approval marker files. */
+    projectRoot: string;
+    /** Interactive confirm. TTY path calls this; tests pass a stub. */
+    confirm: () => Promise<boolean>;
+    /** Whether stdout is a TTY. Defaults to process.stdout.isTTY. */
+    isTTY?: boolean;
+    /** Clock injection. Defaults to () => new Date().toISOString(). */
+    now?: () => string;
+    /** Non-TTY poll interval in ms (small values for tests). */
+    pollMs?: number;
+    /** Non-TTY timeout in ms. */
+    timeoutMs?: number;
+}
+/**
+ * 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 declare function runDo(store: FindingStore, registry: PromoterRegistry, findingId: string, opts: {
+    dryRun?: boolean;
+    yes?: boolean;
+}, deps?: RunDoDeps): Promise<void>;
+export declare function registerDoCommand(program: Command): void;
+//# sourceMappingURL=do.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"do.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/do.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAkC5D;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,mFAAmF;IACnF,QAAQ,EAAE,QAAQ,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;GAWG;AACH,wBAAsB,KAAK,CACzB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,EACzC,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CA0Gf;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmHxD"}

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