daftari 1.15.0 → 1.17.0

package/dist/curation/staged-actions.d.ts

@@ -0,0 +1,68 @@
+import { type Result } from "../frontmatter/types.js";
+import { type IndexDb } from "../storage/index-db.js";
+export declare const STAGED_ACTION_TYPES: readonly ["promote", "deprecate", "supersede", "merge", "confidence-up"];
+export type StagedActionType = (typeof STAGED_ACTION_TYPES)[number];
+export declare const DEFERRED_ACTION_TYPES: readonly StagedActionType[];
+export declare const DEFAULT_TTL_DAYS = 14;
+export declare const STAGED_ACTION_STATUSES: readonly ["pending", "ratified", "rejected", "expired", "ratified-pending-tool"];
+export type StagedActionStatus = (typeof STAGED_ACTION_STATUSES)[number];
+export declare const SWEEP_PRINCIPAL = "system:lint-sweep";
+export interface StagedAction {
+    id: string;
+    actionType: string;
+    targetPath: string;
+    proposedBy: string;
+    proposedAt: string;
+    expiresAt: string;
+    status: string;
+    rationale: string;
+    proposedDiff: unknown;
+    ratifiedAt: string | null;
+    ratifiedBy: string | null;
+    ratificationReason: string | null;
+}
+export interface StageActionInput {
+    actionType: StagedActionType;
+    targetPath: string;
+    proposedBy: string;
+    rationale: string;
+    proposedDiff: unknown;
+    ttlDays?: number;
+    proposedAt?: string;
+}
+export interface DecisionInput {
+    status: StagedActionStatus;
+    ratifiedAt: string;
+    ratifiedBy: string;
+    reason?: string;
+}
+export declare function stagedActionsPath(vaultRoot: string): string;
+export declare function nowISO(): string;
+export declare function daysSince(iso: string, now: Date): number;
+export declare function daysUntil(iso: string, now: Date): number;
+export declare function stageAction(vaultRoot: string, input: StageActionInput): Promise<Result<{
+    id: string;
+    expires_at: string;
+}, Error>>;
+export declare function recordDecision(vaultRoot: string, id: string, decision: DecisionInput): Promise<Result<StagedAction, Error>>;
+export declare function listStagedActions(vaultRoot: string, status?: string): Promise<Result<StagedAction[], Error>>;
+export interface StagedActionLintItem {
+    id: string;
+    actionType: string;
+    targetPath: string;
+    ageDays: number;
+    expiresInDays: number;
+    rationale: string;
+}
+export declare function listPendingForLint(vaultRoot: string, now?: Date): Promise<Result<StagedActionLintItem[], Error>>;
+export declare function getStagedActionById(vaultRoot: string, id: string): Promise<Result<StagedAction | null, Error>>;
+export declare function sweepExpiredActions(vaultRoot: string, now?: Date): Promise<Result<{
+    expired: string[];
+}, Error>>;
+export declare function rebuildStagedActionsIndex(db: IndexDb, vaultRoot: string): Result<{
+    count: number;
+}, Error>;
+export declare function materializeStagedActions(vaultRoot: string): Result<{
+    count: number;
+}, Error>;
+//# sourceMappingURL=staged-actions.d.ts.map

package/dist/curation/staged-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-actions.d.ts","sourceRoot":"","sources":["../../src/curation/staged-actions.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAEL,KAAK,OAAO,EAIb,MAAM,wBAAwB,CAAC;AAKhC,eAAO,MAAM,mBAAmB,0EAMtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpE,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAI5D,CAAC;AAEF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAInC,eAAO,MAAM,sBAAsB,kFAMzB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzE,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAKnD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAYD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAUD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAExD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAExD;AAqID,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,CAAC,CAAC,CA6C5D;AAMD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAsBtC;AAGD,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC,CASxC;AAID,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,KAAK,CAAC,CAAC,CAkBhD;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAQ7C;AAMD,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,MAAM,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,KAAK,CAAC,CAAC,CAwB/C;AASD,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,OAAO,EACX,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,CAAC,CAalC;AAOD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,CAAC,CAS5F"}

package/dist/curation/staged-actions.js

@@ -0,0 +1,394 @@
+// Staged-action queue — the "always-stage" tier of the cortex consolidation
+// loop (spec §11.2). A staged action is a proposed change to the vault that
+// waits for a human to ratify (approve) or reject it through `vault_ratify`.
+// Unratified actions auto-expire after a TTL (default 14 days).
+//
+// Two stores, mirroring the rest of Daftari:
+//
+//   - Canonical: .daftari/staged-actions.jsonl — append-only, one JSON record
+//     per line, the durable source of truth. A proposal is one record; its
+//     later decision (ratify / reject / expire) is a SECOND record referencing
+//     the same id. Collapsing the log to current state is this module's job.
+//
+//   - Index: the `staged_actions` table in .daftari/index.db. Like every table
+//     there it is a derived cache: a reindex collapses the jsonl and
+//     repopulates it (rebuildStagedActionsIndex / materializeStagedActions).
+//     v1 read paths (list / ratify validation / lint) read the jsonl directly —
+//     the same posture the tension log takes with tensions.md — so the
+//     advisory/curation layer never has to open the embedding-backed index db
+//     on a hot path. The sqlite index exists for the future loop's traversal
+//     engine (§11.3+), which wants concurrent SQL reads.
+//
+// All file I/O here is synchronous on purpose: it lets `stageAction` allocate a
+// monotonic id and append in one critical section with no intervening await, so
+// two stagings in the same instant can never collide on an id. This guarantee
+// is per-process; it is sufficient because Daftari enforces one process per
+// vault (.daftari/process.lock — see CLAUDE.md), so there is never a second
+// writer racing this one. It is NOT a cross-process file lock.
+import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { err, ok } from "../frontmatter/types.js";
+import { getProvider } from "../search/vector.js";
+import { clearStagedActions, openIndexDb, upsertStagedAction, } from "../storage/index-db.js";
+// The action verbs the queue understands. `promote` and `deprecate` dispatch to
+// existing write tools on ratify; the rest are STAGED ONLY in v1 and dispatch
+// is deferred to §11.4 (vault_supersede / vault_merge / vault_set_confidence).
+export const STAGED_ACTION_TYPES = [
+    "promote",
+    "deprecate",
+    "supersede",
+    "merge",
+    "confidence-up",
+];
+// Action types whose ratify dispatch is deferred to §11.4. Approving one of
+// these is recorded as `ratified-pending-tool` and applies nothing.
+export const DEFERRED_ACTION_TYPES = [
+    "supersede",
+    "merge",
+    "confidence-up",
+];
+export const DEFAULT_TTL_DAYS = 14;
+// The lifecycle states a staged action moves through. `ratified-pending-tool`
+// is the terminal state for an approved-but-deferred action (§11.4).
+export const STAGED_ACTION_STATUSES = [
+    "pending",
+    "ratified",
+    "rejected",
+    "expired",
+    "ratified-pending-tool",
+];
+// The principal recorded as the actor when the lint sweep auto-expires an
+// action. Mirrors the agent:/human: convention with a system: prefix.
+export const SWEEP_PRINCIPAL = "system:lint-sweep";
+export function stagedActionsPath(vaultRoot) {
+    return join(vaultRoot, ".daftari", "staged-actions.jsonl");
+}
+// --- time helpers ----------------------------------------------------------
+// ISO 8601 to the second (YYYY-MM-DDTHH:MM:SSZ) — drops the millisecond field
+// that toISOString() adds, matching the spec's record format.
+function toSecondISO(d) {
+    return d.toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+// Current instant as a second-resolution ISO string. Exported so the tool
+// layer stamps ratify/reject decisions in the same format the log uses.
+export function nowISO() {
+    return toSecondISO(new Date());
+}
+function addDaysISO(iso, days) {
+    const d = new Date(iso);
+    d.setUTCDate(d.getUTCDate() + days);
+    return toSecondISO(d);
+}
+// Whole days between two instants, floored. Negative when `iso` is in the past
+// relative to `now` (for daysUntil) or the future (for daysSince).
+export function daysSince(iso, now) {
+    return Math.floor((now.getTime() - Date.parse(iso)) / 86_400_000);
+}
+export function daysUntil(iso, now) {
+    return Math.floor((Date.parse(iso) - now.getTime()) / 86_400_000);
+}
+function readRawRecords(vaultRoot) {
+    let raw;
+    try {
+        raw = readFileSync(stagedActionsPath(vaultRoot), "utf-8");
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return [];
+        throw e;
+    }
+    const records = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const rec = JSON.parse(trimmed);
+            if (typeof rec.id === "string")
+                records.push(rec);
+        }
+        catch {
+            // Skip a corrupt line; the log is append-only and best-effort.
+        }
+    }
+    return records;
+}
+// Collapses the append-only log to one current row per id. Records are applied
+// in file order: a proposal seeds the row, each later decision overwrites the
+// status + ratification fields. A decision with no matching proposal is
+// ignored (it cannot stand alone).
+function collapse(records) {
+    const byId = new Map();
+    for (const rec of records) {
+        if (rec.action_type !== undefined) {
+            // Proposal record.
+            byId.set(rec.id, {
+                id: rec.id,
+                action_type: rec.action_type,
+                target_path: rec.target_path ?? "",
+                proposed_by: rec.proposed_by ?? "",
+                proposed_at: rec.proposed_at ?? "",
+                expires_at: rec.expires_at ?? "",
+                status: rec.status ?? "pending",
+                rationale: rec.rationale ?? "",
+                proposed_diff: rec.proposed_diff ?? "null",
+                ratified_at: null,
+                ratified_by: null,
+                ratification_reason: null,
+            });
+        }
+        else {
+            // Decision record — only meaningful if the proposal was already seen.
+            const existing = byId.get(rec.id);
+            if (!existing)
+                continue;
+            existing.status = rec.status ?? existing.status;
+            existing.ratified_at = rec.ratified_at ?? null;
+            existing.ratified_by = rec.ratified_by ?? null;
+            existing.ratification_reason = rec.ratification_reason ?? null;
+        }
+    }
+    return byId;
+}
+function rowToStagedAction(row) {
+    let proposedDiff = null;
+    try {
+        proposedDiff = JSON.parse(row.proposed_diff);
+    }
+    catch {
+        proposedDiff = row.proposed_diff;
+    }
+    return {
+        id: row.id,
+        actionType: row.action_type,
+        targetPath: row.target_path,
+        proposedBy: row.proposed_by,
+        proposedAt: row.proposed_at,
+        expiresAt: row.expires_at,
+        status: row.status,
+        rationale: row.rationale,
+        proposedDiff,
+        ratifiedAt: row.ratified_at,
+        ratifiedBy: row.ratified_by,
+        ratificationReason: row.ratification_reason,
+    };
+}
+// Reads the log and returns current state as parsed actions, id order. A
+// missing log is not an error — it just means nothing has been staged.
+function currentRows(vaultRoot) {
+    return [...collapse(readRawRecords(vaultRoot)).values()].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+}
+// --- id allocation ---------------------------------------------------------
+// Next `stage-NNN` id: the highest numeric suffix ever seen across the whole
+// log (proposals and decisions both carry the id) plus one. Scans every record
+// so a decision-only collapse can't reset the counter.
+function nextStagedId(records) {
+    let max = 0;
+    for (const rec of records) {
+        const m = rec.id.match(/^stage-(\d+)$/);
+        if (!m)
+            continue;
+        const n = Number.parseInt(m[1], 10);
+        if (Number.isFinite(n) && n > max)
+            max = n;
+    }
+    return `stage-${String(max + 1).padStart(3, "0")}`;
+}
+// --- producer / consumer / sweep -------------------------------------------
+// Stages a proposed action. Validation is defensive — the tool layer validates
+// too — but this is the durable boundary, so it re-checks. The id-allocation +
+// append run synchronously with no intervening await, so concurrent calls get
+// distinct, monotonic ids.
+export async function stageAction(vaultRoot, input) {
+    if (!STAGED_ACTION_TYPES.includes(input.actionType)) {
+        return err(new Error(`stageAction: action_type must be one of: ${STAGED_ACTION_TYPES.join(", ")}`));
+    }
+    for (const field of ["targetPath", "proposedBy", "rationale"]) {
+        const v = input[field];
+        if (typeof v !== "string" || v.trim().length === 0) {
+            return err(new Error(`stageAction requires a non-empty '${field}'`));
+        }
+    }
+    if (input.proposedDiff === undefined || input.proposedDiff === null) {
+        return err(new Error("stageAction requires a 'proposedDiff'"));
+    }
+    const ttlDays = input.ttlDays ?? DEFAULT_TTL_DAYS;
+    if (!Number.isFinite(ttlDays) || ttlDays <= 0) {
+        return err(new Error("stageAction 'ttlDays' must be a positive number"));
+    }
+    const proposedAt = input.proposedAt ?? nowISO();
+    const expiresAt = addDaysISO(proposedAt, ttlDays);
+    try {
+        mkdirSync(join(vaultRoot, ".daftari"), { recursive: true });
+        // Critical section: read max id and append in one synchronous breath so no
+        // concurrent stageAction can observe the same max.
+        const id = nextStagedId(readRawRecords(vaultRoot));
+        const record = {
+            id,
+            action_type: input.actionType,
+            target_path: input.targetPath.trim(),
+            proposed_by: input.proposedBy.trim(),
+            proposed_at: proposedAt,
+            expires_at: expiresAt,
+            status: "pending",
+            rationale: input.rationale.trim(),
+            proposed_diff: JSON.stringify(input.proposedDiff),
+        };
+        appendFileSync(stagedActionsPath(vaultRoot), `${JSON.stringify(record)}\n`);
+        return ok({ id, expires_at: expiresAt });
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot stage action: ${reason}`));
+    }
+}
+// Appends a decision record (ratify / reject / expire) for an existing action
+// and returns the collapsed result. Does NOT validate that the action is
+// pending — the caller (vault_ratify, the sweep) owns that policy. Errors only
+// if the id was never proposed.
+export async function recordDecision(vaultRoot, id, decision) {
+    try {
+        const before = collapse(readRawRecords(vaultRoot));
+        if (!before.has(id))
+            return err(new Error(`staged action not found: ${id}`));
+        const record = {
+            id,
+            status: decision.status,
+            ratified_at: decision.ratifiedAt,
+            ratified_by: decision.ratifiedBy,
+            ...(decision.reason ? { ratification_reason: decision.reason } : {}),
+        };
+        mkdirSync(join(vaultRoot, ".daftari"), { recursive: true });
+        appendFileSync(stagedActionsPath(vaultRoot), `${JSON.stringify(record)}\n`);
+        const after = collapse(readRawRecords(vaultRoot)).get(id);
+        if (!after)
+            return err(new Error(`staged action not found after write: ${id}`));
+        return ok(rowToStagedAction(after));
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot record decision: ${reason}`));
+    }
+}
+// Returns current actions, optionally filtered to one status, id order.
+export async function listStagedActions(vaultRoot, status) {
+    try {
+        const rows = currentRows(vaultRoot);
+        const actions = rows.map(rowToStagedAction);
+        return ok(status ? actions.filter((a) => a.status === status) : actions);
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot read staged actions: ${reason}`));
+    }
+}
+// First sentence of a rationale: up to the first sentence-ending period
+// followed by whitespace, else the whole trimmed string.
+function firstSentence(text) {
+    const trimmed = text.trim();
+    const m = trimmed.match(/^(.*?[.!?])(\s|$)/);
+    return m ? m[1] : trimmed;
+}
+// Pending actions for the lint "Staged actions" section, soonest-to-expire
+// first. Read-only — the sweep that expires stale actions is a separate step.
+export async function listPendingForLint(vaultRoot, now = new Date()) {
+    try {
+        const items = currentRows(vaultRoot)
+            .filter((r) => r.status === "pending")
+            .sort((a, b) => (a.expires_at < b.expires_at ? -1 : a.expires_at > b.expires_at ? 1 : 0))
+            .map((r) => ({
+            id: r.id,
+            actionType: r.action_type,
+            targetPath: r.target_path,
+            ageDays: daysSince(r.proposed_at, now),
+            expiresInDays: daysUntil(r.expires_at, now),
+            rationale: firstSentence(r.rationale),
+        }));
+        return ok(items);
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot read staged actions: ${reason}`));
+    }
+}
+export async function getStagedActionById(vaultRoot, id) {
+    try {
+        const row = collapse(readRawRecords(vaultRoot)).get(id);
+        return ok(row ? rowToStagedAction(row) : null);
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot read staged action: ${reason}`));
+    }
+}
+// Sweeps every `pending` action whose expiry has passed into `expired`. One
+// expiry decision record is appended per action. Returns the swept ids,
+// soonest-expired first. Idempotent: an action already past expiry but not
+// pending is left alone.
+export async function sweepExpiredActions(vaultRoot, now = new Date()) {
+    try {
+        const rows = currentRows(vaultRoot);
+        const stale = rows
+            .filter((r) => r.status === "pending" && Date.parse(r.expires_at) < now.getTime())
+            .sort((a, b) => (a.expires_at < b.expires_at ? -1 : a.expires_at > b.expires_at ? 1 : 0));
+        const at = toSecondISO(now);
+        const expired = [];
+        if (stale.length > 0)
+            mkdirSync(join(vaultRoot, ".daftari"), { recursive: true });
+        for (const row of stale) {
+            const record = {
+                id: row.id,
+                status: "expired",
+                ratified_at: at,
+                ratified_by: SWEEP_PRINCIPAL,
+            };
+            appendFileSync(stagedActionsPath(vaultRoot), `${JSON.stringify(record)}\n`);
+            expired.push(row.id);
+        }
+        return ok({ expired });
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot sweep staged actions: ${reason}`));
+    }
+}
+// --- sqlite index rebuild --------------------------------------------------
+// Collapses the jsonl and repopulates the `staged_actions` table from scratch.
+// Synchronous (better-sqlite3 + readFileSync). The upserts run in one
+// transaction so a mid-rebuild failure rolls back rather than leaving a
+// half-populated index, and any sqlite throw surfaces as an err Result instead
+// of silently dropping rows.
+export function rebuildStagedActionsIndex(db, vaultRoot) {
+    try {
+        const rows = currentRows(vaultRoot);
+        const write = db.transaction(() => {
+            clearStagedActions(db);
+            for (const row of rows)
+                upsertStagedAction(db, row);
+        });
+        write();
+        return ok({ count: rows.length });
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return err(new Error(`cannot rebuild staged-actions index: ${reason}`));
+    }
+}
+// Opens the index db at the active provider's dim, rebuilds the staged_actions
+// table, and closes. Used at startup when a reindex isn't otherwise running
+// (the fresh-index path); the reindex path calls rebuildStagedActionsIndex
+// directly against its already-open handle. The provider dim matters: opening
+// at the wrong dim would drop and recreate the embeddings_vec mirror.
+export function materializeStagedActions(vaultRoot) {
+    const opened = openIndexDb(vaultRoot, getProvider().dim);
+    if (!opened.ok)
+        return opened;
+    const db = opened.value;
+    try {
+        return rebuildStagedActionsIndex(db, vaultRoot);
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=staged-actions.js.map

package/dist/curation/staged-actions.js.map

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

package/dist/eval/generate.d.ts

@@ -0,0 +1,12 @@
+import { type Result } from "../frontmatter/types.js";
+import type { LlmClient } from "./llm.js";
+import type { Subgraph } from "./subgraph.js";
+import { type CortexEvalError, type QuestionSet } from "./types.js";
+export interface GenerateOptions {
+    n: number;
+    model: string;
+    vaultHash?: string;
+    seed?: string;
+}
+export declare function generateQuestions(subgraph: Subgraph, llm: LlmClient, opts: GenerateOptions): Promise<Result<QuestionSet, CortexEvalError>>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/eval/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/eval/generate.ts"],"names":[],"mappings":"AAUA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,WAAW,EAIjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CA0E/C"}