agent-bober 0.18.0 → 0.19.0

package/dist/research/cadence.js

@@ -0,0 +1,55 @@
+/**
+ * computeNextDue — deterministic cadence math (Sprint 4).
+ *
+ * PURE, clock-free: never calls new Date() with no argument or Date.now().
+ * The fromIso base instant is always injected from the CLI boundary
+ * (mirrors the clock discipline in src/state/facts.ts:18-21 and
+ * src/calendar/slotter.ts:14-16).
+ *
+ * new Date(Date.parse(iso)) parses the INJECTED string — that is pure, not
+ * a wall-clock read. The wall clock is read only at the CLI .action() boundary.
+ */
+// ── computeNextDue ────────────────────────────────────────────────────
+/**
+ * Return the next-due ISO-8601 timestamp for a job with the given cadence,
+ * computed from the injected `fromIso` instant.
+ *
+ * Cadence mapping:
+ *   - "daily"   → +1 UTC day  (setUTCDate + 1)
+ *   - "weekly"  → +7 UTC days (setUTCDate + 7)
+ *   - "monthly" → +1 UTC month (setUTCMonth + 1)
+ *
+ * Month-length rollover note: JavaScript's setUTCMonth overflows into the
+ * next month when the source day exceeds the destination month's length.
+ * E.g. 2026-01-31 + 1 month → 2026-03-03 (Feb has 28 days in 2026).
+ * This deterministic behaviour is intentional — callers MUST NOT rely on
+ * the result landing on the last day of the month.
+ *
+ * @param cadence  - One of "daily", "weekly", "monthly".
+ * @param fromIso  - Injected ISO-8601 base instant (e.g. the current `now`).
+ * @returns         ISO-8601 string satisfying z.string().datetime().
+ */
+export function computeNextDue(cadence, fromIso) {
+    // Parsing an injected string is pure — no wall-clock dependency.
+    const base = new Date(Date.parse(fromIso));
+    switch (cadence) {
+        case "daily":
+            base.setUTCDate(base.getUTCDate() + 1);
+            return base.toISOString();
+        case "weekly":
+            base.setUTCDate(base.getUTCDate() + 7);
+            return base.toISOString();
+        case "monthly":
+            // setUTCMonth overflows into the next month on day > last-day-of-month.
+            // This is deterministic and acceptable for a monthly cadence (contract
+            // outOfScope: no clamp-to-end-of-month behaviour).
+            base.setUTCMonth(base.getUTCMonth() + 1);
+            return base.toISOString();
+        default: {
+            // TypeScript exhaustive-switch guard — new cadences cause a compile error.
+            const _exhaustive = cadence;
+            throw new Error(`Unhandled cadence: ${String(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=cadence.js.map

package/dist/research/cadence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.js","sourceRoot":"","sources":["../../src/research/cadence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,yEAAyE;AAEzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,OAAe;IAC9D,iEAAiE;IACjE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAE5B,KAAK,QAAQ;YACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAE5B,KAAK,SAAS;YACZ,wEAAwE;YACxE,uEAAuE;YACvE,mDAAmD;YACnD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAE5B,OAAO,CAAC,CAAC,CAAC;YACR,2EAA2E;YAC3E,MAAM,WAAW,GAAU,OAAO,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/research/digest.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Research digest builder — aggregates in-window research runs into a
+ * dual markdown+JSON artifact for the Telegram bot (sibling spec) to push.
+ *
+ * Clock discipline: `now`/`since` are injected ISO strings — never new Date() here.
+ * Non-sensitive summary content only (titles/summaries; no raw body values).
+ *
+ * bober: collectRunsFromVault reads vault research notes (1:1 dated artifacts)
+ *        rather than hub Findings (content-deduped, historyless, path-less).
+ *        Swap if a dedicated digest store is ever introduced.
+ */
+/** One research run entry in a digest. */
+export interface DigestRun {
+    /** Job title — note frontmatter.title ("Research — <question>"). */
+    title: string;
+    /** Non-sensitive one-line summary derived from frontmatter.question/title only. */
+    topFinding: string;
+    /** ISO — note frontmatter.generatedAt. */
+    generatedAt: string;
+    /** Absolute note path — the source artifact link. */
+    source: string;
+}
+/** The full digest structure written to both .md and .json. */
+export interface Digest {
+    since: string;
+    now: string;
+    generatedAt: string;
+    runs: DigestRun[];
+}
+/** Injectable dependencies for buildDigest — keeps it testable without real vault. */
+export interface DigestDeps {
+    /** Injected collector — returns in-window runs. Fake in unit tests; real in CLI. */
+    collectRuns: (since: string, now: string) => Promise<DigestRun[]>;
+    /**
+     * Absolute path to the digests directory.
+     * e.g. <root>/.bober/research/digests — injected; temp dir in tests.
+     */
+    digestsDir: string;
+}
+/**
+ * Render a Digest into a markdown string.
+ *
+ * PURE: no IO, no Date.now(), no side effects.
+ * Mirrors src/hub/priority-md.ts: builds lines[] then joins with "\n".
+ *
+ * Empty-window rule (sc-5-3): when runs.length === 0, the body explicitly
+ * states no new research was produced in the window.
+ */
+export declare function renderDigestMarkdown(digest: Digest): string;
+/**
+ * Collect in-window research runs via deps.collectRuns, render both markdown
+ * and JSON artifacts, write them to deps.digestsDir, and return the result.
+ *
+ * File naming: `now.slice(0, 10)` → YYYY-MM-DD (matches note-writer.ts:24).
+ * JSON format: JSON.stringify(digest, null, 2) + "\n" (mirrors fleet/index.ts:69).
+ *
+ * Empty window: still writes both files with an explicit no-new-research body.
+ * Never throws on empty collectRuns — caller receives both paths.
+ */
+export declare function buildDigest(since: string, now: string, deps: DigestDeps): Promise<{
+    digest: Digest;
+    mdPath: string;
+    jsonPath: string;
+}>;
+/**
+ * Real collectRuns implementation: reads research vault notes under
+ * <vaultRoot>/research/, filters by frontmatter.generatedAt ∈ [since, now],
+ * and maps each matching note to a DigestRun.
+ *
+ * Source selection: vault notes are 1:1 dated run artifacts (runner.ts:186-190
+ * writes a new file per run). Hub Findings are content-deduped by
+ * sha256(domain|title|kind) and silently undercount a window — not suitable.
+ *
+ * Non-sensitive: topFinding is frontmatter.question/title only — never raw body.
+ *
+ * Window compare: ISO lexicographic (safe because all timestamps are
+ * toISOString() fixed-width — finding-store.ts:101-104).
+ */
+export declare function collectRunsFromVault(vaultRoot: string, since: string, now: string): Promise<DigestRun[]>;
+//# sourceMappingURL=digest.d.ts.map

package/dist/research/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/research/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAClE;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAuB3D;AAID;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB/D;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,SAAS,EAAE,CAAC,CAyCtB"}

package/dist/research/digest.js

@@ -0,0 +1,119 @@
+/**
+ * Research digest builder — aggregates in-window research runs into a
+ * dual markdown+JSON artifact for the Telegram bot (sibling spec) to push.
+ *
+ * Clock discipline: `now`/`since` are injected ISO strings — never new Date() here.
+ * Non-sensitive summary content only (titles/summaries; no raw body values).
+ *
+ * bober: collectRunsFromVault reads vault research notes (1:1 dated artifacts)
+ *        rather than hub Findings (content-deduped, historyless, path-less).
+ *        Swap if a dedicated digest store is ever introduced.
+ */
+import { join } from "node:path";
+import { writeFile } from "node:fs/promises";
+import { ensureDir } from "../state/helpers.js";
+import { listNotes, readNote } from "../vault/note-io.js";
+// ── Pure markdown render ──────────────────────────────────────────────
+/**
+ * Render a Digest into a markdown string.
+ *
+ * PURE: no IO, no Date.now(), no side effects.
+ * Mirrors src/hub/priority-md.ts: builds lines[] then joins with "\n".
+ *
+ * Empty-window rule (sc-5-3): when runs.length === 0, the body explicitly
+ * states no new research was produced in the window.
+ */
+export function renderDigestMarkdown(digest) {
+    const lines = [];
+    lines.push("# Research Digest");
+    lines.push("");
+    lines.push(`**Window:** ${digest.since} → ${digest.now}`);
+    lines.push(`**Generated:** ${digest.generatedAt}`);
+    lines.push("");
+    if (digest.runs.length === 0) {
+        lines.push("_No new research was produced in this window._");
+        lines.push("");
+        return lines.join("\n");
+    }
+    lines.push(`**Runs:** ${digest.runs.length}`);
+    lines.push("");
+    for (const run of digest.runs) {
+        lines.push(`- **${run.title}** — ${run.topFinding} ([source](${run.source}))`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+// ── buildDigest: collect → render both → write both ──────────────────
+/**
+ * Collect in-window research runs via deps.collectRuns, render both markdown
+ * and JSON artifacts, write them to deps.digestsDir, and return the result.
+ *
+ * File naming: `now.slice(0, 10)` → YYYY-MM-DD (matches note-writer.ts:24).
+ * JSON format: JSON.stringify(digest, null, 2) + "\n" (mirrors fleet/index.ts:69).
+ *
+ * Empty window: still writes both files with an explicit no-new-research body.
+ * Never throws on empty collectRuns — caller receives both paths.
+ */
+export async function buildDigest(since, now, deps) {
+    const runs = await deps.collectRuns(since, now);
+    const digest = { since, now, generatedAt: now, runs };
+    // Date derived from injected `now` — never wall-clock (mirrors note-writer.ts:24)
+    const date = now.slice(0, 10); // YYYY-MM-DD
+    await ensureDir(deps.digestsDir);
+    const mdPath = join(deps.digestsDir, `${date}.md`);
+    const jsonPath = join(deps.digestsDir, `${date}.json`);
+    await writeFile(mdPath, renderDigestMarkdown(digest), "utf-8");
+    // Mirror fleet/index.ts:69: JSON.stringify(obj, null, 2) + "\n"
+    await writeFile(jsonPath, JSON.stringify(digest, null, 2) + "\n", "utf-8");
+    return { digest, mdPath, jsonPath };
+}
+// ── Real vault-note collector (bound only by the CLI) ─────────────────
+/**
+ * Real collectRuns implementation: reads research vault notes under
+ * <vaultRoot>/research/, filters by frontmatter.generatedAt ∈ [since, now],
+ * and maps each matching note to a DigestRun.
+ *
+ * Source selection: vault notes are 1:1 dated run artifacts (runner.ts:186-190
+ * writes a new file per run). Hub Findings are content-deduped by
+ * sha256(domain|title|kind) and silently undercount a window — not suitable.
+ *
+ * Non-sensitive: topFinding is frontmatter.question/title only — never raw body.
+ *
+ * Window compare: ISO lexicographic (safe because all timestamps are
+ * toISOString() fixed-width — finding-store.ts:101-104).
+ */
+export async function collectRunsFromVault(vaultRoot, since, now) {
+    const researchDir = join(vaultRoot, "research");
+    let paths;
+    try {
+        paths = await listNotes(researchDir);
+    }
+    catch {
+        // Directory may not exist yet (first run, empty vault) — return empty, no error
+        return [];
+    }
+    const runs = [];
+    for (const p of paths) {
+        const note = await readNote(p);
+        const generatedAt = note.frontmatter["generatedAt"];
+        // Skip notes whose generatedAt is absent or not a string
+        if (typeof generatedAt !== "string")
+            continue;
+        // ISO lexicographic window filter
+        if (generatedAt < since || generatedAt > now)
+            continue;
+        // title: prefer frontmatter.title, fall back to "Research — <question>", then path
+        const rawTitle = note.frontmatter["title"];
+        const rawQuestion = note.frontmatter["question"];
+        const title = typeof rawTitle === "string"
+            ? rawTitle
+            : typeof rawQuestion === "string"
+                ? `Research — ${rawQuestion}`
+                : p;
+        // topFinding: frontmatter.question (non-sensitive; never raw body values)
+        const topFinding = typeof rawQuestion === "string" ? rawQuestion : title;
+        runs.push({ title, topFinding, generatedAt, source: p });
+    }
+    return runs;
+}
+//# sourceMappingURL=digest.js.map

package/dist/research/digest.js.map

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

package/dist/research/egress.d.ts

@@ -0,0 +1,28 @@
+/** ResearchEgressGuard — online-research egress axis, default false (Sprint 3, ADR-6 lineage). */
+import type { BoberConfig } from "../config/schema.js";
+/** The single research egress axis. Defaults FALSE (code-enforced zero-egress). */
+export type EgressAxis = "online-research";
+/**
+ * Guards outbound online-research egress.
+ *
+ * A single axis — onlineResearch — defaults to false.
+ * isAllowed returns false by default; assertAllowed throws when off.
+ * All default false when absent from config (fail-closed, ADR-6 lineage).
+ *
+ * bober: plain decision object; no network import here; swap for ABAC policy if
+ *        per-user granularity is needed.
+ */
+export declare class ResearchEgressGuard {
+    private readonly onlineResearch;
+    constructor(onlineResearch: boolean);
+    /** Build from BoberConfig research section; axis defaults false when absent. */
+    static fromConfig(config: BoberConfig): ResearchEgressGuard;
+    /** Returns true only when the axis has been explicitly opted in via config. */
+    isAllowed(axis: EgressAxis): boolean;
+    /**
+     * Throws an Error when the axis is not enabled.
+     * Returns void (not throws) when the axis is allowed.
+     */
+    assertAllowed(axis: EgressAxis): void;
+}
+//# sourceMappingURL=egress.d.ts.map

package/dist/research/egress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"egress.d.ts","sourceRoot":"","sources":["../../src/research/egress.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE3C;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,OAAO;IAEpD,gFAAgF;IAChF,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB;IAI3D,+EAA+E;IAC/E,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAWpC;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;CAKtC"}

package/dist/research/egress.js

@@ -0,0 +1,41 @@
+/**
+ * Guards outbound online-research egress.
+ *
+ * A single axis — onlineResearch — defaults to false.
+ * isAllowed returns false by default; assertAllowed throws when off.
+ * All default false when absent from config (fail-closed, ADR-6 lineage).
+ *
+ * bober: plain decision object; no network import here; swap for ABAC policy if
+ *        per-user granularity is needed.
+ */
+export class ResearchEgressGuard {
+    onlineResearch;
+    constructor(onlineResearch) {
+        this.onlineResearch = onlineResearch;
+    }
+    /** Build from BoberConfig research section; axis defaults false when absent. */
+    static fromConfig(config) {
+        return new ResearchEgressGuard(config.research?.egress?.onlineResearch ?? false);
+    }
+    /** Returns true only when the axis has been explicitly opted in via config. */
+    isAllowed(axis) {
+        switch (axis) {
+            case "online-research":
+                return this.onlineResearch;
+            default: {
+                const _exhaustive = axis; // compile error if an EgressAxis value is unhandled
+                return _exhaustive;
+            }
+        }
+    }
+    /**
+     * Throws an Error when the axis is not enabled.
+     * Returns void (not throws) when the axis is allowed.
+     */
+    assertAllowed(axis) {
+        if (!this.isAllowed(axis)) {
+            throw new Error(`Egress axis '${axis}' not enabled`);
+        }
+    }
+}
+//# sourceMappingURL=egress.js.map

package/dist/research/egress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"egress.js","sourceRoot":"","sources":["../../src/research/egress.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,cAAuB;QAAvB,mBAAc,GAAd,cAAc,CAAS;IAAG,CAAC;IAExD,gFAAgF;IAChF,MAAM,CAAC,UAAU,CAAC,MAAmB;QACnC,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,IAAI,KAAK,CAAC,CAAC;IACnF,CAAC;IAED,+EAA+E;IAC/E,SAAS,CAAC,IAAgB;QACxB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,iBAAiB;gBACpB,OAAO,IAAI,CAAC,cAAc,CAAC;YAC7B,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,WAAW,GAAU,IAAI,CAAC,CAAC,oDAAoD;gBACrF,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,IAAgB;QAC5B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,eAAe,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/research/job-store.d.ts

@@ -0,0 +1,30 @@
+import { type ResearchJob } from "./types.js";
+/**
+ * Derive a deterministic 16-char hex job id from a question slug + createdAt.
+ * Mirrors factId in src/state/facts.ts:58-69 — no wall-clock dependency.
+ * The CLI stamps createdAt at the handler boundary and passes it here.
+ */
+export declare function jobId(question: string, createdAt: string): string;
+/**
+ * Persist a research job as a JSON file.
+ * Validates with ResearchJobSchema before writing so an invalid job never
+ * reaches disk (mirrors plan-state.ts:22-38).
+ */
+export declare function addJob(projectRoot: string, job: ResearchJob): Promise<void>;
+/**
+ * List all persisted research jobs, sorted by filename.
+ * Returns [] if the jobs directory does not exist yet.
+ * Malformed JSON files are silently skipped (mirrors plan-state.ts:106-140).
+ */
+export declare function listJobs(projectRoot: string): Promise<ResearchJob[]>;
+/**
+ * Read a single research job by id.
+ * Returns null if not found or malformed.
+ */
+export declare function readJob(projectRoot: string, id: string): Promise<ResearchJob | null>;
+/**
+ * Delete a research job by id. Returns true if deleted, false if not found.
+ * Mirrors approval-state.ts:138-140.
+ */
+export declare function removeJob(projectRoot: string, id: string): Promise<boolean>;
+//# sourceMappingURL=job-store.d.ts.map

package/dist/research/job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-store.d.ts","sourceRoot":"","sources":["../../src/research/job-store.ts"],"names":[],"mappings":"AAKA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAiBjE;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKjE;AAID;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,EAAE,CAAC,CAwBxB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAU7B;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/research/job-store.js

@@ -0,0 +1,100 @@
+import { readFile, writeFile, readdir, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { ensureDir } from "../state/helpers.js";
+import { ResearchJobSchema } from "./types.js";
+// ── Path helpers ──────────────────────────────────────────────────────
+const JOBS_DIR = ".bober/research/jobs";
+function jobsDir(projectRoot) {
+    return join(projectRoot, JOBS_DIR);
+}
+function jobPath(projectRoot, id) {
+    const safeId = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(jobsDir(projectRoot), `${safeId}.json`);
+}
+// ── Deterministic id ──────────────────────────────────────────────────
+/**
+ * Derive a deterministic 16-char hex job id from a question slug + createdAt.
+ * Mirrors factId in src/state/facts.ts:58-69 — no wall-clock dependency.
+ * The CLI stamps createdAt at the handler boundary and passes it here.
+ */
+export function jobId(question, createdAt) {
+    return createHash("sha256")
+        .update(`${question}|${createdAt}`)
+        .digest("hex")
+        .slice(0, 16);
+}
+// ── Store operations ──────────────────────────────────────────────────
+/**
+ * Persist a research job as a JSON file.
+ * Validates with ResearchJobSchema before writing so an invalid job never
+ * reaches disk (mirrors plan-state.ts:22-38).
+ */
+export async function addJob(projectRoot, job) {
+    await ensureDir(jobsDir(projectRoot));
+    const validation = ResearchJobSchema.safeParse(job);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid research job:\n${issues}`);
+    }
+    await writeFile(jobPath(projectRoot, job.id), JSON.stringify(validation.data, null, 2) + "\n", "utf-8");
+}
+/**
+ * List all persisted research jobs, sorted by filename.
+ * Returns [] if the jobs directory does not exist yet.
+ * Malformed JSON files are silently skipped (mirrors plan-state.ts:106-140).
+ */
+export async function listJobs(projectRoot) {
+    let entries;
+    try {
+        entries = await readdir(jobsDir(projectRoot));
+    }
+    catch {
+        // Directory absent — no jobs yet.
+        return [];
+    }
+    const jobs = [];
+    for (const file of entries.filter((f) => f.endsWith(".json")).sort()) {
+        try {
+            const raw = JSON.parse(await readFile(join(jobsDir(projectRoot), file), "utf-8"));
+            const result = ResearchJobSchema.safeParse(raw);
+            if (result.success) {
+                jobs.push(result.data);
+            }
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+    return jobs;
+}
+/**
+ * Read a single research job by id.
+ * Returns null if not found or malformed.
+ */
+export async function readJob(projectRoot, id) {
+    try {
+        const raw = JSON.parse(await readFile(jobPath(projectRoot, id), "utf-8"));
+        const result = ResearchJobSchema.safeParse(raw);
+        return result.success ? result.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete a research job by id. Returns true if deleted, false if not found.
+ * Mirrors approval-state.ts:138-140.
+ */
+export async function removeJob(projectRoot, id) {
+    try {
+        await unlink(jobPath(projectRoot, id));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=job-store.js.map

package/dist/research/job-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-store.js","sourceRoot":"","sources":["../../src/research/job-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAEjE,yEAAyE;AAEzE,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,SAAS,OAAO,CAAC,WAAmB;IAClC,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,OAAO,CAAC,WAAmB,EAAE,EAAU;IAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,yEAAyE;AAEzE;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,QAAgB,EAAE,SAAiB;IACvD,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;SAClC,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,yEAAyE;AAEzE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,WAAmB,EACnB,GAAgB;IAEhB,MAAM,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM;aACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACnD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,SAAS,CACb,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAC/C,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,WAAmB;IAEnB,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAC7B,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAC1D,CAAC;YACF,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,WAAmB,EACnB,EAAU;IAEV,IAAI,CAAC;QACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAC7B,MAAM,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAClD,CAAC;QACF,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,EAAU;IAEV,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/research/model-diversity.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Model diversity resolver — returns >=2 distinct provider/model blocks by
+ * enumerating DIFFERENT tiers from fleet tier-policy.
+ *
+ * PURE: no fs, no network, no clock. Reads only the static tier table.
+ *
+ * Distinctness comes from DIFFERENT tiers (within one tier planner==generator
+ * ==evaluator all point at the same block, so deduplication must cross tiers).
+ */
+import type { RoleProviderBlock } from "../fleet/tier-policy.js";
+/**
+ * Canonical label for a block — used in notes and Finding evidence fields.
+ * Stable: derived purely from the block's provider and model fields.
+ */
+export declare function modelLabel(b: RoleProviderBlock): string;
+/**
+ * Return >=2 DISTINCT provider/model blocks for a multi-model research run.
+ *
+ * Strategy: enumerate the non-default tiers in a fixed priority order and
+ * dedup by `provider/model` label. The optional `tier` parameter seeds the
+ * first block by placing that tier at the front of the scan order.
+ *
+ * Returns all 4 distinct blocks (cheap/standard/hard/frontier) in the
+ * current tier-policy table; the runner takes the first >=2.
+ */
+export declare function diverseBlocks(tier?: string): RoleProviderBlock[];
+//# sourceMappingURL=model-diversity.d.ts.map

package/dist/research/model-diversity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-diversity.d.ts","sourceRoot":"","sources":["../../src/research/model-diversity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,yBAAyB,CAAC;AAIjF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAEvD;AAID;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAyBhE"}

package/dist/research/model-diversity.js

@@ -0,0 +1,52 @@
+/**
+ * Model diversity resolver — returns >=2 distinct provider/model blocks by
+ * enumerating DIFFERENT tiers from fleet tier-policy.
+ *
+ * PURE: no fs, no network, no clock. Reads only the static tier table.
+ *
+ * Distinctness comes from DIFFERENT tiers (within one tier planner==generator
+ * ==evaluator all point at the same block, so deduplication must cross tiers).
+ */
+import { tierPolicy } from "../fleet/tier-policy.js";
+// ── Label ─────────────────────────────────────────────────────────────
+/**
+ * Canonical label for a block — used in notes and Finding evidence fields.
+ * Stable: derived purely from the block's provider and model fields.
+ */
+export function modelLabel(b) {
+    return `${b.provider}/${b.model}`;
+}
+// ── Diversity resolver ────────────────────────────────────────────────
+/**
+ * Return >=2 DISTINCT provider/model blocks for a multi-model research run.
+ *
+ * Strategy: enumerate the non-default tiers in a fixed priority order and
+ * dedup by `provider/model` label. The optional `tier` parameter seeds the
+ * first block by placing that tier at the front of the scan order.
+ *
+ * Returns all 4 distinct blocks (cheap/standard/hard/frontier) in the
+ * current tier-policy table; the runner takes the first >=2.
+ */
+export function diverseBlocks(tier) {
+    const order = ["cheap", "standard", "hard", "frontier"];
+    const tiers = tier !== undefined && order.includes(tier)
+        ? [tier, ...order.filter((t) => t !== tier)]
+        : order;
+    const seen = new Set();
+    const out = [];
+    for (const t of tiers) {
+        const block = tierPolicy.resolveTier(t)?.generator;
+        if (block !== undefined) {
+            const label = modelLabel(block);
+            if (!seen.has(label)) {
+                seen.add(label);
+                out.push(block);
+            }
+        }
+    }
+    // bober: returns up to 4 distinct blocks; runner takes >=2. If tier-policy
+    // ever collapses tiers to a single block this falls back to whatever is
+    // available. A future upgrade path is to expose a configurable model list.
+    return out;
+}
+//# sourceMappingURL=model-diversity.js.map

package/dist/research/model-diversity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-diversity.js","sourceRoot":"","sources":["../../src/research/model-diversity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAAoB;IAC7C,OAAO,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,yEAAyE;AAEzE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,KAAK,GAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1E,MAAM,KAAK,GACT,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAsB,CAAC;QAC1D,CAAC,CAAC,CAAC,IAAsB,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC,KAAK,CAAC;IAEZ,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAwB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,wEAAwE;IACxE,2EAA2E;IAC3E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/research/note-writer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Research note serializer — PURE markdown note builder for multi-model research runs.
+ *
+ * PURE / NO fs / NO network / NO Date.now()
+ * All timestamps are injected parameters; the wall clock is read ONLY at the CLI boundary.
+ *
+ * Mirrors src/medical/research/research-note.ts in structure.
+ * Uses serializeFrontmatter (scalars + string-arrays ONLY — never pass objects).
+ */
+import type { ResearchJob } from "./types.js";
+/**
+ * Derive the canonical path for a research note under the vault.
+ * Output: <vaultRoot>/research/<YYYY-MM-DD>-<marker>.md
+ * Date is sliced from the injected ISO string — never wall-clock.
+ */
+export declare function researchNotePath(vaultRoot: string, marker: string, now: string): string;
+/** One labelled model answer collected by the runner. */
+export interface ModelContribution {
+    /** Canonical model label, e.g. "openai-compat/deepseek". */
+    label: string;
+    /** The model's answer text. */
+    text: string;
+}
+/**
+ * Serialize a multi-model research run into a vault note string.
+ *
+ * Frontmatter fields (all required by sc-2-2):
+ *   title, jobId, question, models (string[]), generatedAt, domain, type, status
+ *
+ * Body: per-model contribution sections — records WHICH model label produced each answer.
+ *
+ * PITFALL: models must be string[] (labels), never RoleProviderBlock[].
+ * serializeFrontmatter renders nested objects as "[object Object]".
+ */
+export declare function serializeResearchNote(job: ResearchJob, labels: string[], contributions: ModelContribution[], now: string, sources?: string[]): string;
+//# sourceMappingURL=note-writer.d.ts.map

package/dist/research/note-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-writer.d.ts","sourceRoot":"","sources":["../../src/research/note-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvF;AAID,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,EAAE,EAChB,aAAa,EAAE,iBAAiB,EAAE,EAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,EAAO,GACrB,MAAM,CAqBR"}