agent-bober 0.18.0 → 0.19.0

package/dist/do-bridge/coding-promoter.js

@@ -0,0 +1,43 @@
+// ── Coding domains ────────────────────────────────────────────────────
+/**
+ * Domains the coding promoter handles.
+ * Finding.domain is a free string (not an enum), so we match literals here.
+ * Contract assumption 3: coding/projects Findings are promoted to bober-run tasks.
+ */
+const CODING_DOMAINS = new Set(["coding", "projects"]);
+// ── codingPromoter ────────────────────────────────────────────────────
+/**
+ * Converts a coding or projects Finding into a bober-run PromotionPlan.
+ *
+ * task derivation (one-line, non-empty):
+ *  1. Base: finding.title (always present and non-empty per FindingSchema).
+ *  2. Evidence: up to 2 evidence lines appended as context (dash-separated).
+ *  3. teamId: extracted from the first "team:<id>" tag, or undefined (default team).
+ *
+ * PURE: no I/O, no clock read, no side effects.
+ */
+export function codingPromoter(finding) {
+    // Extract optional teamId from a "team:<id>" tag
+    const teamTag = finding.tags.find((t) => t.startsWith("team:"));
+    const teamId = teamTag !== undefined ? teamTag.slice("team:".length) : undefined;
+    // Build the one-line task from title + optional evidence context
+    let task = finding.title;
+    if (finding.evidence.length > 0) {
+        const evidenceSummary = finding.evidence.slice(0, 2).join("; ");
+        task = `${task} — ${evidenceSummary}`;
+    }
+    return {
+        kind: "bober-run",
+        task,
+        teamId,
+    };
+}
+// ── Domain guard ──────────────────────────────────────────────────────
+/**
+ * Returns true when the finding's domain is one the coding promoter handles.
+ * Used by the CLI registration to register the promoter under all applicable domains.
+ */
+export function isCodingDomain(domain) {
+    return CODING_DOMAINS.has(domain);
+}
+//# sourceMappingURL=coding-promoter.js.map

package/dist/do-bridge/coding-promoter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-promoter.js","sourceRoot":"","sources":["../../src/do-bridge/coding-promoter.ts"],"names":[],"mappings":"AAGA,yEAAyE;AAEzE;;;;GAIG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAE/D,yEAAyE;AAEzE;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,iDAAiD;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,iEAAiE;IACjE,IAAI,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;IACzB,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,GAAG,GAAG,IAAI,MAAM,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/do-bridge/finding-port.d.ts

@@ -0,0 +1,88 @@
+import type { Finding } from "../hub/finding.js";
+import type { FactStore } from "../state/facts.js";
+import type { PromotionRef } from "./types.js";
+/**
+ * Do-bridge view of a Finding where promotesTo is a parsed PromotionRef
+ * object rather than the raw string stored on disk.
+ *
+ * FindingSchema.promotesTo is z.string().optional() — the hub schema is NOT
+ * modified. This type is owned by the do-bridge port layer; serialization
+ * and deserialization happen inside the adapters below.
+ */
+export type DoFinding = Omit<Finding, "promotesTo"> & {
+    promotesTo?: PromotionRef;
+};
+/**
+ * Narrow port for finding lookup and promotion state writes.
+ * Returns DoFinding (promotesTo as structured object) so callers never
+ * touch the raw JSON string stored on disk.
+ */
+export interface FindingStore {
+    /** Read a finding by id. Returns null if not found. */
+    readFinding(id: string): Promise<DoFinding | null>;
+    /**
+     * Set promotesTo = ref AND transition status open->in-progress in one call.
+     * Returns the updated DoFinding, or null if the id does not exist.
+     */
+    setPromotion(id: string, ref: PromotionRef, opts: {
+        now: string;
+    }): Promise<DoFinding | null>;
+    /** Return all findings that currently carry a PromotionRef (promotesTo defined). */
+    listPromoted(): Promise<DoFinding[]>;
+    /**
+     * Transition a finding to an arbitrary status AND overwrite its promotesTo ref,
+     * in one supersede-aware write. Used by reconcile for done/open outcomes.
+     * Returns the updated DoFinding, or null if the id does not exist.
+     */
+    applyOutcome(id: string, status: Finding["status"], ref: PromotionRef, opts: {
+        now: string;
+    }): Promise<DoFinding | null>;
+}
+/**
+ * FactStore-backed adapter for FindingStore.
+ *
+ * readFinding: delegates to readFindings() (hub's canonical read path) and
+ * converts the string promotesTo to a PromotionRef object.
+ *
+ * setPromotion: serializes the ref to a JSON string, delegates to
+ * transitionFinding() (hub's supersede-aware UPDATE path) so bitemporal
+ * history is preserved, then converts the result back to DoFinding.
+ */
+export declare class FactStoreFindingStore implements FindingStore {
+    private readonly store;
+    constructor(store: FactStore);
+    readFinding(id: string): Promise<DoFinding | null>;
+    setPromotion(id: string, ref: PromotionRef, { now }: {
+        now: string;
+    }): Promise<DoFinding | null>;
+    listPromoted(): Promise<DoFinding[]>;
+    applyOutcome(id: string, status: Finding["status"], ref: PromotionRef, { now }: {
+        now: string;
+    }): Promise<DoFinding | null>;
+}
+/**
+ * In-memory fake for tests — backed by a Map<string, DoFinding>.
+ *
+ * setPromotion stores the PromotionRef OBJECT directly (no serialization)
+ * so tests can assert promotesTo.runId / promotesTo.status on the result of
+ * readFinding without JSON.parse.
+ *
+ * `writes` records every setPromotion call:
+ *  - sc-2-2/2-3: assert writes.length === 1 on approve
+ *  - sc-2-4: assert writes.length === 0 on reject
+ */
+export declare class InMemoryFindingStore implements FindingStore {
+    private readonly map;
+    /** Records every setPromotion write. Tests assert .length for mutation count. */
+    readonly writes: DoFinding[];
+    constructor(seed?: Finding[]);
+    readFinding(id: string): Promise<DoFinding | null>;
+    setPromotion(id: string, ref: PromotionRef, _opts: {
+        now: string;
+    }): Promise<DoFinding | null>;
+    listPromoted(): Promise<DoFinding[]>;
+    applyOutcome(id: string, status: Finding["status"], ref: PromotionRef, _opts: {
+        now: string;
+    }): Promise<DoFinding | null>;
+}
+//# sourceMappingURL=finding-port.d.ts.map

package/dist/do-bridge/finding-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-port.d.ts","sourceRoot":"","sources":["../../src/do-bridge/finding-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG;IACpD,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B,CAAC;AAgBF;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,YAAY,CACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACpB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE7B,oFAAoF;IACpF,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErC;;;;OAIG;IACH,YAAY,CACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EACzB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACpB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CAC9B;AAID;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAEvC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAKlD,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,YAAY,EACjB,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACvB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAStB,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIpC,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EACzB,GAAG,EAAE,YAAY,EACjB,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACvB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAO7B;AAID;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAE7C,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAM;gBAEtB,IAAI,GAAE,OAAO,EAAO;IAI1B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIlD,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAStB,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIpC,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EACzB,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAQ7B"}

package/dist/do-bridge/finding-port.js

@@ -0,0 +1,95 @@
+import { readFindings, transitionFinding } from "../hub/finding-store.js";
+import { serializePromotionRef, parsePromotionRef } from "./types.js";
+// ── Internal helpers ──────────────────────────────────────────────────
+/**
+ * Convert a hub Finding (string promotesTo) to a DoFinding (object promotesTo).
+ * If promotesTo is present but unparseable, it is dropped (undefined).
+ */
+function toDoFinding(f) {
+    const ref = f.promotesTo !== undefined ? (parsePromotionRef(f.promotesTo) ?? undefined) : undefined;
+    return { ...f, promotesTo: ref };
+}
+// ── FactStoreFindingStore ─────────────────────────────────────────────
+/**
+ * FactStore-backed adapter for FindingStore.
+ *
+ * readFinding: delegates to readFindings() (hub's canonical read path) and
+ * converts the string promotesTo to a PromotionRef object.
+ *
+ * setPromotion: serializes the ref to a JSON string, delegates to
+ * transitionFinding() (hub's supersede-aware UPDATE path) so bitemporal
+ * history is preserved, then converts the result back to DoFinding.
+ */
+export class FactStoreFindingStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async readFinding(id) {
+        const f = readFindings(this.store).find((f) => f.id === id);
+        return f !== undefined ? toDoFinding(f) : null;
+    }
+    async setPromotion(id, ref, { now }) {
+        // Serialize the object ref to the string the hub schema expects on disk.
+        const result = await transitionFinding(this.store, id, "in-progress", {
+            now,
+            mutate: { promotesTo: serializePromotionRef(ref) },
+        });
+        return result !== null ? toDoFinding(result) : null;
+    }
+    async listPromoted() {
+        return readFindings(this.store).map(toDoFinding).filter((f) => f.promotesTo !== undefined);
+    }
+    async applyOutcome(id, status, ref, { now }) {
+        const result = await transitionFinding(this.store, id, status, {
+            now,
+            mutate: { promotesTo: serializePromotionRef(ref) },
+        });
+        return result !== null ? toDoFinding(result) : null;
+    }
+}
+// ── InMemoryFindingStore ──────────────────────────────────────────────
+/**
+ * In-memory fake for tests — backed by a Map<string, DoFinding>.
+ *
+ * setPromotion stores the PromotionRef OBJECT directly (no serialization)
+ * so tests can assert promotesTo.runId / promotesTo.status on the result of
+ * readFinding without JSON.parse.
+ *
+ * `writes` records every setPromotion call:
+ *  - sc-2-2/2-3: assert writes.length === 1 on approve
+ *  - sc-2-4: assert writes.length === 0 on reject
+ */
+export class InMemoryFindingStore {
+    map;
+    /** Records every setPromotion write. Tests assert .length for mutation count. */
+    writes = [];
+    constructor(seed = []) {
+        this.map = new Map(seed.map((f) => [f.id, toDoFinding(f)]));
+    }
+    async readFinding(id) {
+        return this.map.get(id) ?? null;
+    }
+    async setPromotion(id, ref, _opts) {
+        const cur = this.map.get(id);
+        if (cur === undefined)
+            return null;
+        const next = { ...cur, status: "in-progress", promotesTo: ref };
+        this.map.set(id, next);
+        this.writes.push(next);
+        return next;
+    }
+    async listPromoted() {
+        return [...this.map.values()].filter((f) => f.promotesTo !== undefined);
+    }
+    async applyOutcome(id, status, ref, _opts) {
+        const cur = this.map.get(id);
+        if (cur === undefined)
+            return null;
+        const next = { ...cur, status, promotesTo: ref };
+        this.map.set(id, next);
+        this.writes.push(next);
+        return next;
+    }
+}
+//# sourceMappingURL=finding-port.js.map

package/dist/do-bridge/finding-port.js.map

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

package/dist/do-bridge/launcher.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Launcher port and default RunSpawner-backed adapter.
+ *
+ * HARD BOUNDARY: `src/cli/commands/do.ts` MUST NOT import RunSpawner or
+ * execa directly. The RunSpawner import lives here; do.ts imports from
+ * this file instead.
+ */
+import { RunSpawner } from "../chat/run-spawner.js";
+import type { PromotionPlan } from "./types.js";
+/**
+ * Port for launching the work behind an approved PromotionPlan.
+ * Injected into runDo so unit tests use a fake and never spawn a real process.
+ */
+export interface Launcher {
+    /** Launch the work described by plan. Returns the runId used + optional pid. */
+    launch(plan: PromotionPlan): Promise<{
+        runId: string;
+        pid?: number;
+    }>;
+}
+/** Options for the RunSpawnerLauncher adapter. */
+export interface RunSpawnerLauncherOptions {
+    /** Absolute project root, passed to RunSpawner. */
+    projectRoot: string;
+    /** The finding id — embedded in the generated runId: `do-<findingId>-<ts>`. */
+    findingId: string;
+    /** Session id for the RunSpawner sidecar. Defaults to `do-<findingId>`. */
+    sessionId?: string;
+    /** Clock injection. Defaults to () => new Date().toISOString(). */
+    now?: () => string;
+    /**
+     * Pre-built RunSpawner to use instead of constructing one.
+     * Inject a RunSpawner with a fake spawn fn in launcher.test.ts so no real
+     * process is ever started in unit tests.
+     */
+    spawner?: RunSpawner;
+}
+/**
+ * Default Launcher adapter — wraps RunSpawner to spawn a detached
+ * `agent-bober run <task> --run-id <id>` child.
+ *
+ * runId format: `do-<findingId>-<timestamp>` — stable prefix for identifying
+ * do-bridge runs in roster state.json files.
+ */
+export declare class RunSpawnerLauncher implements Launcher {
+    private readonly spawner;
+    private readonly findingId;
+    private readonly now;
+    constructor(opts: RunSpawnerLauncherOptions);
+    launch(plan: PromotionPlan): Promise<{
+        runId: string;
+        pid?: number;
+    }>;
+}
+//# sourceMappingURL=launcher.d.ts.map

package/dist/do-bridge/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/do-bridge/launcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,gFAAgF;IAChF,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAID,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,IAAI,EAAE,yBAAyB;IAarC,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAK5E"}

package/dist/do-bridge/launcher.js

@@ -0,0 +1,37 @@
+/**
+ * Launcher port and default RunSpawner-backed adapter.
+ *
+ * HARD BOUNDARY: `src/cli/commands/do.ts` MUST NOT import RunSpawner or
+ * execa directly. The RunSpawner import lives here; do.ts imports from
+ * this file instead.
+ */
+import { RunSpawner } from "../chat/run-spawner.js";
+/**
+ * Default Launcher adapter — wraps RunSpawner to spawn a detached
+ * `agent-bober run <task> --run-id <id>` child.
+ *
+ * runId format: `do-<findingId>-<timestamp>` — stable prefix for identifying
+ * do-bridge runs in roster state.json files.
+ */
+export class RunSpawnerLauncher {
+    spawner;
+    findingId;
+    now;
+    constructor(opts) {
+        this.findingId = opts.findingId;
+        this.now = opts.now ?? (() => new Date().toISOString());
+        // bober: builds a fresh RunSpawner per CLI invocation; swap for a pre-built
+        // injected spawner in tests so no real execa ever runs.
+        const spawnerOpts = {
+            projectRoot: opts.projectRoot,
+            sessionId: opts.sessionId ?? `do-${opts.findingId}`,
+        };
+        this.spawner = opts.spawner ?? new RunSpawner(spawnerOpts);
+    }
+    async launch(plan) {
+        const runId = `do-${this.findingId}-${this.now()}`;
+        const ack = await this.spawner.spawn(plan.task, runId);
+        return { runId, pid: ack.pid };
+    }
+}
+//# sourceMappingURL=launcher.js.map

package/dist/do-bridge/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../../src/do-bridge/launcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAmCpD;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAa;IACpB,SAAS,CAAS;IAClB,GAAG,CAAe;IAEnC,YAAY,IAA+B;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAExD,4EAA4E;QAC5E,wDAAwD;QACxD,MAAM,WAAW,GAAsB;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM,IAAI,CAAC,SAAS,EAAE;SACpD,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAmB;QAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/do-bridge/promote.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Promotion gate orchestration — write pending marker, resolve approve/reject,
+ * then on approval call launch; on rejection clean up and return.
+ *
+ * PURE-ish DI core: all I/O via injected projectRoot paths + approval-state.ts
+ * functions + injected confirm / now / launcher. Never reads the real clock
+ * (now is injected). Never throws — failures propagate as Promise rejections
+ * which the caller (runDo) converts to process.exitCode = 1.
+ */
+import type { PromotionPlan } from "./types.js";
+/** Result returned by runPromotionGate after the approve/reject decision. */
+export interface GateOutcome {
+    approved: boolean;
+}
+/** Arguments for runPromotionGate — all I/O dependencies are injected. */
+export interface PromotionGateArgs {
+    /** Absolute project root (used to build .bober/approvals paths). */
+    projectRoot: string;
+    /** Finding id — used to derive checkpointId `promote-<findingId>`. */
+    findingId: string;
+    /** The promotion plan to summarize in the pending marker. */
+    plan: PromotionPlan;
+    /** When true, bypass interactive prompt and auto-approve. */
+    yes?: boolean;
+    /**
+     * Whether stdout is a TTY. When true and not --yes, calls the injected
+     * confirm() and waits for a synchronous answer. When false, polls the
+     * approvals directory until an external approve/reject marker appears.
+     */
+    isTTY: boolean;
+    /** Injected interactive confirm. TTY path only; must return true/false. */
+    confirm: () => Promise<boolean>;
+    /** Clock injection — returns an ISO string. */
+    now: () => string;
+    /** Non-TTY poll interval in ms. Default 2000ms; use small values in tests. */
+    pollMs?: number;
+    /** Non-TTY timeout in ms. Default 24 hours. */
+    timeoutMs?: number;
+}
+/**
+ * Write promote-<findingId>.pending.json, gate on it
+ * (--yes → auto-approve; TTY → prompts(); non-TTY → poll directory),
+ * and return { approved }.
+ *
+ * Writes/deletes markers via approval-state.ts only — no new format.
+ * checkpointId is always `promote-${findingId}` so external
+ * `bober approve promote-<id>` resolves it (sc-2-5).
+ */
+export declare function runPromotionGate(args: PromotionGateArgs): Promise<GateOutcome>;
+//# sourceMappingURL=promote.d.ts.map

package/dist/do-bridge/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/do-bridge/promote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,IAAI,EAAE,aAAa,CAAC;IACpB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiHpF"}

package/dist/do-bridge/promote.js

@@ -0,0 +1,116 @@
+/**
+ * Promotion gate orchestration — write pending marker, resolve approve/reject,
+ * then on approval call launch; on rejection clean up and return.
+ *
+ * PURE-ish DI core: all I/O via injected projectRoot paths + approval-state.ts
+ * functions + injected confirm / now / launcher. Never reads the real clock
+ * (now is injected). Never throws — failures propagate as Promise rejections
+ * which the caller (runDo) converts to process.exitCode = 1.
+ */
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { savePending, saveApproved, saveRejected, deletePending, } from "../state/approval-state.js";
+/**
+ * Write promote-<findingId>.pending.json, gate on it
+ * (--yes → auto-approve; TTY → prompts(); non-TTY → poll directory),
+ * and return { approved }.
+ *
+ * Writes/deletes markers via approval-state.ts only — no new format.
+ * checkpointId is always `promote-${findingId}` so external
+ * `bober approve promote-<id>` resolves it (sc-2-5).
+ */
+export async function runPromotionGate(args) {
+    const { projectRoot, findingId, plan, yes = false, isTTY, confirm, now, pollMs = 2_000, timeoutMs = 24 * 60 * 60 * 1_000, } = args;
+    const checkpointId = `promote-${findingId}`;
+    const requestedAt = now();
+    const requestedAtMs = Date.parse(requestedAt);
+    const timeoutAt = new Date(requestedAtMs + timeoutMs).toISOString();
+    // 1. Write the pending marker
+    await savePending(projectRoot, {
+        checkpointId,
+        artifact: { type: "bober-run", summary: plan.task },
+        prompt: `Promote to bober run: "${plan.task}"`,
+        requestedAt,
+        timeoutAt,
+    });
+    // 2. --yes: auto-approve without prompting
+    if (yes) {
+        await saveApproved(projectRoot, checkpointId, {
+            approvedAt: now(),
+            approverId: "auto",
+        });
+        await deletePending(projectRoot, checkpointId);
+        return { approved: true };
+    }
+    // 3. TTY: interactive confirm
+    if (isTTY) {
+        const confirmed = await confirm();
+        if (confirmed) {
+            await saveApproved(projectRoot, checkpointId, {
+                approvedAt: now(),
+                approverId: "tty",
+            });
+            await deletePending(projectRoot, checkpointId);
+            return { approved: true };
+        }
+        else {
+            await saveRejected(projectRoot, checkpointId, {
+                rejectedAt: now(),
+                rejecterId: "tty",
+                feedback: "User declined at TTY prompt",
+            });
+            await deletePending(projectRoot, checkpointId);
+            return { approved: false };
+        }
+    }
+    // 4. Non-TTY: poll the approvals directory until resolved or timeout
+    //    Mirror: src/orchestrator/checkpoints/mechanisms/disk.ts:104-175
+    //    Use Date.now() for elapsed-time tracking (not the injected `now` which is
+    //    for file timestamps only and may be frozen in tests).
+    const approvalsDir = join(projectRoot, ".bober", "approvals");
+    const startedAtMs = Date.now();
+    let pollHandle;
+    try {
+        return await new Promise((resolve, reject) => {
+            const tick = async () => {
+                try {
+                    const entries = new Set(await readdir(approvalsDir).catch(() => []));
+                    if (entries.has(`${checkpointId}.approved.json`)) {
+                        await deletePending(projectRoot, checkpointId);
+                        resolve({ approved: true });
+                        return;
+                    }
+                    if (entries.has(`${checkpointId}.rejected.json`)) {
+                        await deletePending(projectRoot, checkpointId);
+                        resolve({ approved: false });
+                        return;
+                    }
+                    // Timeout check (wall clock — not the injected now() which is for file timestamps)
+                    if (Date.now() - startedAtMs >= timeoutMs) {
+                        await deletePending(projectRoot, checkpointId);
+                        resolve({ approved: false });
+                        return;
+                    }
+                    // Schedule next tick — never leak timers (disk.ts:170-175)
+                    pollHandle = setTimeout(() => {
+                        tick().catch(reject);
+                    }, pollMs);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            };
+            // Kick off the first tick
+            pollHandle = setTimeout(() => {
+                tick().catch(reject);
+            }, pollMs);
+        });
+    }
+    finally {
+        // Always clear the handle — covers the resolved-before-tick case
+        if (pollHandle !== undefined) {
+            clearTimeout(pollHandle);
+        }
+    }
+}
+//# sourceMappingURL=promote.js.map

package/dist/do-bridge/promote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.js","sourceRoot":"","sources":["../../src/do-bridge/promote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,4BAA4B,CAAC;AAsCpC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IAC5D,MAAM,EACJ,WAAW,EACX,SAAS,EACT,IAAI,EACJ,GAAG,GAAG,KAAK,EACX,KAAK,EACL,OAAO,EACP,GAAG,EACH,MAAM,GAAG,KAAK,EACd,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,GACjC,GAAG,IAAI,CAAC;IAET,MAAM,YAAY,GAAG,WAAW,SAAS,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;IAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpE,8BAA8B;IAC9B,MAAM,WAAW,CAAC,WAAW,EAAE;QAC7B,YAAY;QACZ,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;QACnD,MAAM,EAAE,0BAA0B,IAAI,CAAC,IAAI,GAAG;QAC9C,WAAW;QACX,SAAS;KACV,CAAC,CAAC;IAEH,2CAA2C;IAC3C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,YAAY,CAAC,WAAW,EAAE,YAAY,EAAE;YAC5C,UAAU,EAAE,GAAG,EAAE;YACjB,UAAU,EAAE,MAAM;SACnB,CAAC,CAAC;QACH,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,8BAA8B;IAC9B,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,MAAM,OAAO,EAAE,CAAC;QAClC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,YAAY,CAAC,WAAW,EAAE,YAAY,EAAE;gBAC5C,UAAU,EAAE,GAAG,EAAE;gBACjB,UAAU,EAAE,KAAK;aAClB,CAAC,CAAC;YACH,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,CAAC,WAAW,EAAE,YAAY,EAAE;gBAC5C,UAAU,EAAE,GAAG,EAAE;gBACjB,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,6BAA6B;aACxC,CAAC,CAAC;YACH,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAC/C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,qEAAqE;IACrE,+EAA+E;IAC/E,2DAA2D;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,IAAI,UAAqD,CAAC;IAE1D,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxD,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;gBACrC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CACxD,CAAC;oBAEF,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,gBAAgB,CAAC,EAAE,CAAC;wBACjD,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;wBAC/C,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC5B,OAAO;oBACT,CAAC;oBAED,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,gBAAgB,CAAC,EAAE,CAAC;wBACjD,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;wBAC/C,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;wBAC7B,OAAO;oBACT,CAAC;oBAED,mFAAmF;oBACnF,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,IAAI,SAAS,EAAE,CAAC;wBAC1C,MAAM,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;wBAC/C,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;wBAC7B,OAAO;oBACT,CAAC;oBAED,2DAA2D;oBAC3D,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC3B,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBACvB,CAAC,EAAE,MAAM,CAAC,CAAC;gBACb,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC;YAEF,0BAA0B;YAC1B,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC3B,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC,EAAE,MAAM,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,iEAAiE;QACjE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,YAAY,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/do-bridge/reconcile.d.ts

@@ -0,0 +1,50 @@
+import type { FindingStore } from "./finding-port.js";
+import type { RunState } from "../mcp/run-manager.js";
+/**
+ * Injected dependencies for reconcilePromotions.
+ * Keeps the core pure so tests can inject a run-state fake without a real run.
+ */
+export interface ReconcileDeps {
+    store: FindingStore;
+    /**
+     * Injected run-state reader.
+     * CLI passes `(runId) => readRunState(projectRoot, runId)`.
+     * Tests inject a fake that returns a predetermined RunState or null.
+     */
+    readState: (runId: string) => Promise<RunState | null>;
+    /** Clock injection — never call new Date() inside the core. */
+    now: () => string;
+}
+/** Counts of findings advanced in a single reconcilePromotions pass. */
+export interface ReconcileSummary {
+    /** Findings transitioned to 'done' (run completed). */
+    completed: number;
+    /** Findings returned to 'open' (run aborted or failed). */
+    aborted: number;
+    /** Findings left unchanged (run still running, missing, or unrecognised). */
+    unchanged: number;
+}
+/**
+ * For each Finding whose promotesTo.status is 'launched', read the linked
+ * run's state.json snapshot and advance the Finding to its terminal status.
+ *
+ * Transition table:
+ *   run 'completed'          → finding 'done',  promotesTo.status 'completed'
+ *   run 'aborted'|'failed'   → finding 'open',  promotesTo.status 'aborted'
+ *   run 'running' (or null)  → finding unchanged (no write)
+ *
+ * PURE-ish: all I/O is injected. Never throws — per-finding failures are
+ * swallowed internally. Reads the current snapshot and returns immediately;
+ * does NOT poll or block waiting for an in-flight run to finish.
+ */
+export declare function reconcilePromotions(deps: ReconcileDeps): Promise<ReconcileSummary>;
+/**
+ * Thin wrapper around reconcilePromotions that injects the real readRunState
+ * adapter for a given project root. Called by the `bober do` CLI handler.
+ *
+ * Caller is responsible for wrapping this in try/catch so a reconcile failure
+ * can never abort the enclosing command (mirrors seedProjectFacts in
+ * src/orchestrator/pipeline.ts:981).
+ */
+export declare function reconcilePromotionsForRoot(projectRoot: string, store: FindingStore, now: () => string): Promise<ReconcileSummary>;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/do-bridge/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/do-bridge/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACvD,+DAA+D;IAC/D,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAID,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuCxF;AAID;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,MAAM,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}

package/dist/do-bridge/reconcile.js

@@ -0,0 +1,70 @@
+import { readRunState } from "../state/run-state.js";
+// ── reconcilePromotions (DI core) ─────────────────────────────────────
+/**
+ * For each Finding whose promotesTo.status is 'launched', read the linked
+ * run's state.json snapshot and advance the Finding to its terminal status.
+ *
+ * Transition table:
+ *   run 'completed'          → finding 'done',  promotesTo.status 'completed'
+ *   run 'aborted'|'failed'   → finding 'open',  promotesTo.status 'aborted'
+ *   run 'running' (or null)  → finding unchanged (no write)
+ *
+ * PURE-ish: all I/O is injected. Never throws — per-finding failures are
+ * swallowed internally. Reads the current snapshot and returns immediately;
+ * does NOT poll or block waiting for an in-flight run to finish.
+ */
+export async function reconcilePromotions(deps) {
+    const { store, readState, now } = deps;
+    const summary = { completed: 0, aborted: 0, unchanged: 0 };
+    const promoted = await store.listPromoted();
+    const launched = promoted.filter((f) => f.promotesTo?.status === "launched");
+    for (const finding of launched) {
+        try {
+            // promotesTo is guaranteed non-undefined by the filter above
+            const ref = finding.promotesTo;
+            const state = await readState(ref.runId);
+            if (state === null) {
+                // Missing or corrupt run-state file → treat as "still running"
+                summary.unchanged++;
+                continue;
+            }
+            if (state.status === "completed") {
+                const updatedRef = { ...ref, status: "completed" };
+                await store.applyOutcome(finding.id, "done", updatedRef, { now: now() });
+                summary.completed++;
+            }
+            else if (state.status === "aborted" || state.status === "failed") {
+                const updatedRef = { ...ref, status: "aborted" };
+                await store.applyOutcome(finding.id, "open", updatedRef, { now: now() });
+                summary.aborted++;
+            }
+            else {
+                // 'running', 'input-required', 'paused' — leave unchanged
+                summary.unchanged++;
+            }
+        }
+        catch {
+            // Per-finding error: swallow and count as unchanged (belt and suspenders).
+            // reconcilePromotions MUST NOT throw.
+            summary.unchanged++;
+        }
+    }
+    return summary;
+}
+// ── reconcilePromotionsForRoot (CLI wrapper) ──────────────────────────
+/**
+ * Thin wrapper around reconcilePromotions that injects the real readRunState
+ * adapter for a given project root. Called by the `bober do` CLI handler.
+ *
+ * Caller is responsible for wrapping this in try/catch so a reconcile failure
+ * can never abort the enclosing command (mirrors seedProjectFacts in
+ * src/orchestrator/pipeline.ts:981).
+ */
+export async function reconcilePromotionsForRoot(projectRoot, store, now) {
+    return reconcilePromotions({
+        store,
+        readState: (runId) => readRunState(projectRoot, runId),
+        now,
+    });
+}
+//# sourceMappingURL=reconcile.js.map