agent-bober 0.17.1 → 0.19.0

package/dist/contracts/spec.d.ts

@@ -70,8 +70,8 @@ export declare const ClarificationQuestionSchema: z.ZodObject<{
      */
     ambiguityWeight: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    questionId: string;
     category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+    questionId: string;
     question: string;
     options?: {
         description: string;
@@ -80,8 +80,8 @@ export declare const ClarificationQuestionSchema: z.ZodObject<{
     recommendation?: string | undefined;
     ambiguityWeight?: number | undefined;
 }, {
-    questionId: string;
     category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+    questionId: string;
     question: string;
     options?: {
         description: string;
@@ -100,15 +100,15 @@ export declare const ResolvedClarificationSchema: z.ZodObject<{
     /** Who answered: "user" (interactive) or "planner" (autonomous self-answer) */
     resolvedBy: z.ZodDefault<z.ZodEnum<["user", "planner"]>>;
 }, "strip", z.ZodTypeAny, {
-    questionId: string;
     answer: string;
+    questionId: string;
     resolvedAt: string;
-    resolvedBy: "planner" | "user";
+    resolvedBy: "user" | "planner";
 }, {
-    questionId: string;
     answer: string;
+    questionId: string;
     resolvedAt: string;
-    resolvedBy?: "planner" | "user" | undefined;
+    resolvedBy?: "user" | "planner" | undefined;
 }>;
 export type ResolvedClarification = z.infer<typeof ResolvedClarificationSchema>;
 export declare const FeatureSpecSchema: z.ZodObject<{
@@ -128,7 +128,7 @@ export declare const FeatureSpecSchema: z.ZodObject<{
     priority: "must-have" | "should-have" | "nice-to-have";
     acceptanceCriteria: string[];
     dependencies: string[];
-    estimatedComplexity?: "medium" | "low" | "high" | undefined;
+    estimatedComplexity?: "high" | "medium" | "low" | undefined;
     estimatedSprints?: number | undefined;
 }, {
     description: string;
@@ -137,7 +137,7 @@ export declare const FeatureSpecSchema: z.ZodObject<{
     priority: "must-have" | "should-have" | "nice-to-have";
     acceptanceCriteria: string[];
     dependencies?: string[] | undefined;
-    estimatedComplexity?: "medium" | "low" | "high" | undefined;
+    estimatedComplexity?: "high" | "medium" | "low" | undefined;
     estimatedSprints?: number | undefined;
 }>;
 export type FeatureSpec = z.infer<typeof FeatureSpecSchema>;
@@ -165,7 +165,7 @@ export declare const PlanSpecSchema: z.ZodObject<{
         priority: "must-have" | "should-have" | "nice-to-have";
         acceptanceCriteria: string[];
         dependencies: string[];
-        estimatedComplexity?: "medium" | "low" | "high" | undefined;
+        estimatedComplexity?: "high" | "medium" | "low" | undefined;
         estimatedSprints?: number | undefined;
     }, {
         description: string;
@@ -174,7 +174,7 @@ export declare const PlanSpecSchema: z.ZodObject<{
         priority: "must-have" | "should-have" | "nice-to-have";
         acceptanceCriteria: string[];
         dependencies?: string[] | undefined;
-        estimatedComplexity?: "medium" | "low" | "high" | undefined;
+        estimatedComplexity?: "high" | "medium" | "low" | undefined;
         estimatedSprints?: number | undefined;
     }>, "many">;
     assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -211,8 +211,8 @@ export declare const PlanSpecSchema: z.ZodObject<{
          */
         ambiguityWeight: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        questionId: string;
         category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+        questionId: string;
         question: string;
         options?: {
             description: string;
@@ -221,8 +221,8 @@ export declare const PlanSpecSchema: z.ZodObject<{
         recommendation?: string | undefined;
         ambiguityWeight?: number | undefined;
     }, {
-        questionId: string;
         category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+        questionId: string;
         question: string;
         options?: {
             description: string;
@@ -241,15 +241,15 @@ export declare const PlanSpecSchema: z.ZodObject<{
         /** Who answered: "user" (interactive) or "planner" (autonomous self-answer) */
         resolvedBy: z.ZodDefault<z.ZodEnum<["user", "planner"]>>;
     }, "strip", z.ZodTypeAny, {
-        questionId: string;
         answer: string;
+        questionId: string;
         resolvedAt: string;
-        resolvedBy: "planner" | "user";
+        resolvedBy: "user" | "planner";
     }, {
-        questionId: string;
         answer: string;
+        questionId: string;
         resolvedAt: string;
-        resolvedBy?: "planner" | "user" | undefined;
+        resolvedBy?: "user" | "planner" | undefined;
     }>, "many">>;
     techStack: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     techNotes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -261,8 +261,9 @@ export declare const PlanSpecSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     completedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    status: "completed" | "draft" | "needs-clarification" | "ready" | "in-progress" | "abandoned";
     mode: "greenfield" | "brownfield";
-    status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
     description: string;
     specId: string;
     version: number;
@@ -274,14 +275,14 @@ export declare const PlanSpecSchema: z.ZodObject<{
         priority: "must-have" | "should-have" | "nice-to-have";
         acceptanceCriteria: string[];
         dependencies: string[];
-        estimatedComplexity?: "medium" | "low" | "high" | undefined;
+        estimatedComplexity?: "high" | "medium" | "low" | undefined;
         estimatedSprints?: number | undefined;
     }[];
     assumptions: string[];
     outOfScope: string[];
     clarificationQuestions: {
-        questionId: string;
         category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+        questionId: string;
         question: string;
         options?: {
             description: string;
@@ -291,15 +292,14 @@ export declare const PlanSpecSchema: z.ZodObject<{
         ambiguityWeight?: number | undefined;
     }[];
     resolvedClarifications: {
-        questionId: string;
         answer: string;
+        questionId: string;
         resolvedAt: string;
-        resolvedBy: "planner" | "user";
+        resolvedBy: "user" | "planner";
     }[];
     techStack: string[];
     nonFunctionalRequirements: unknown[];
     constraints: string[];
-    createdAt: string;
     updatedAt: string;
     ambiguityScore?: number | undefined;
     techNotes?: Record<string, unknown> | undefined;
@@ -307,8 +307,9 @@ export declare const PlanSpecSchema: z.ZodObject<{
     metadata?: Record<string, unknown> | undefined;
     completedAt?: string | undefined;
 }, {
+    createdAt: string;
+    status: "completed" | "draft" | "needs-clarification" | "ready" | "in-progress" | "abandoned";
     mode: "greenfield" | "brownfield";
-    status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
     description: string;
     specId: string;
     title: string;
@@ -319,18 +320,17 @@ export declare const PlanSpecSchema: z.ZodObject<{
         priority: "must-have" | "should-have" | "nice-to-have";
         acceptanceCriteria: string[];
         dependencies?: string[] | undefined;
-        estimatedComplexity?: "medium" | "low" | "high" | undefined;
+        estimatedComplexity?: "high" | "medium" | "low" | undefined;
         estimatedSprints?: number | undefined;
     }[];
-    createdAt: string;
     updatedAt: string;
     version?: number | undefined;
     assumptions?: string[] | undefined;
     outOfScope?: string[] | undefined;
     ambiguityScore?: number | undefined;
     clarificationQuestions?: {
-        questionId: string;
         category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
+        questionId: string;
         question: string;
         options?: {
             description: string;
@@ -340,10 +340,10 @@ export declare const PlanSpecSchema: z.ZodObject<{
         ambiguityWeight?: number | undefined;
     }[] | undefined;
     resolvedClarifications?: {
-        questionId: string;
         answer: string;
+        questionId: string;
         resolvedAt: string;
-        resolvedBy?: "planner" | "user" | undefined;
+        resolvedBy?: "user" | "planner" | undefined;
     }[] | undefined;
     techStack?: string[] | undefined;
     techNotes?: Record<string, unknown> | undefined;

package/dist/contracts/sprint-contract.d.ts

@@ -96,7 +96,7 @@ export declare const SprintContractSchema: z.ZodObject<{
     startedAt: z.ZodOptional<z.ZodString>;
     completedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+    status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
     description: string;
     specId: string;
     title: string;
@@ -117,8 +117,8 @@ export declare const SprintContractSchema: z.ZodObject<{
     definitionOfDone: string;
     estimatedFiles: string[];
     iterationHistory: unknown[];
-    ambiguityScore?: number | undefined;
     createdAt?: string | undefined;
+    ambiguityScore?: number | undefined;
     updatedAt?: string | undefined;
     completedAt?: string | undefined;
     generatorNotes?: string | undefined;
@@ -129,7 +129,7 @@ export declare const SprintContractSchema: z.ZodObject<{
     evalResults?: unknown[] | undefined;
     startedAt?: string | undefined;
 }, {
-    status: "in-progress" | "completed" | "proposed" | "negotiating" | "agreed" | "evaluating" | "passed" | "failed" | "needs-rework";
+    status: "failed" | "completed" | "evaluating" | "in-progress" | "proposed" | "negotiating" | "agreed" | "passed" | "needs-rework";
     description: string;
     specId: string;
     title: string;
@@ -144,11 +144,11 @@ export declare const SprintContractSchema: z.ZodObject<{
     nonGoals: string[];
     stopConditions: string[];
     definitionOfDone: string;
+    createdAt?: string | undefined;
     features?: string[] | undefined;
     assumptions?: string[] | undefined;
     outOfScope?: string[] | undefined;
     ambiguityScore?: number | undefined;
-    createdAt?: string | undefined;
     updatedAt?: string | undefined;
     completedAt?: string | undefined;
     dependsOn?: string[] | undefined;

package/dist/do-bridge/coding-promoter.d.ts

@@ -0,0 +1,19 @@
+import type { Finding } from "../hub/finding.js";
+import type { PromotionPlan } from "./types.js";
+/**
+ * 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 declare function codingPromoter(finding: Finding): PromotionPlan;
+/**
+ * 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 declare function isCodingDomain(domain: string): boolean;
+//# sourceMappingURL=coding-promoter.d.ts.map

package/dist/do-bridge/coding-promoter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-promoter.d.ts","sourceRoot":"","sources":["../../src/do-bridge/coding-promoter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAahD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAiB9D;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD"}

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