@treeseed/dsh-chapters 0.1.0

package/lib/enrich-queue.d.ts

@@ -0,0 +1,66 @@
+/**
+ * P2 S2 — the enrichment queue: one queue, pluggable triggers, hard idle
+ * guarantee (record §6.2, plan decisions).
+ *
+ * Isomorphic factory (host plane + realm engine each own an instance, like
+ * createSyncScheduler). Providers are the ONLY variance:
+ *   afterPush  — schedule(reason) called after each completed sync pass
+ *   idle       — a resettable debounce timer (enrichment.idleMs)
+ *   both       — the default
+ *   manual     — no auto triggers; the /chapters-enrich run command drains
+ *
+ * Invariants this module owns:
+ *   - NEVER in a hot path: enrichOne is only reached from drain(), and
+ *     drain() is only fired by trigger events that already completed the
+ *     user's work (post-push) or by silence (idle) or a command.
+ *   - Idempotency key = chapter number + rootSession + model. Re-enqueue
+ *     after vocab change is NOT needed (vocab affects canonicalization at
+ *     index build, not the model call); after a MODEL change it IS (key
+ *     includes model, so the key naturally changes).
+ *   - enabled:false ⇒ every entry point is a pure no-op (kill-switch exit
+ *     criterion: the corpus stays fully functional, signatures-only).
+ *   - Cross-plane double-run: the caller-supplied lock (store-dir, same
+ *     pattern as sync's acquireLock) makes the realm + host queues safe on
+ *     one workspace.
+ */
+export interface EnrichQueueDeps {
+    /** enumerate chapters lacking current-model enrichment (cheap, durable-read only) */
+    listPending: (model: string, cap: number) => Promise<{
+        key: string;
+        label: string;
+    }[]>;
+    /** run the ladder for one chapter; must never throw (S1 core + persistence) */
+    enrichOne: (key: string) => Promise<{
+        ok: boolean;
+        skipped?: string;
+    }>;
+    /** current enrichment model id ('' = resolver said: conversation model — queue still needs a concrete string for keys) */
+    resolveModel: () => Promise<string>;
+    enabled: boolean;
+    trigger: 'afterPush' | 'idle' | 'both' | 'manual';
+    idleMs: number;
+    batchCap: number;
+    log: (msg: string) => void;
+    /** injectable timer for tests */
+    setTimer?: (fn: () => void, ms: number) => {
+        cancel: () => void;
+    };
+}
+export interface EnrichQueue {
+    /** a sync pass just completed (or any natural idle point) */
+    onSyncDone: (reason: string) => void;
+    /** archive activity happened — resets the idle timer */
+    noteActivity: () => void;
+    /** manual drain (command surface); returns processed count */
+    drainNow: () => Promise<number>;
+    /** queue state for /chapters-status + reports */
+    state: () => {
+        enabled: boolean;
+        trigger: string;
+        pendingEstimate: number;
+        lastBatch: number;
+        model: string | null;
+    };
+    dispose: () => void;
+}
+export declare function createEnrichQueue(deps: EnrichQueueDeps): EnrichQueue;

package/lib/enrich-queue.js

@@ -0,0 +1,100 @@
+/**
+ * P2 S2 — the enrichment queue: one queue, pluggable triggers, hard idle
+ * guarantee (record §6.2, plan decisions).
+ *
+ * Isomorphic factory (host plane + realm engine each own an instance, like
+ * createSyncScheduler). Providers are the ONLY variance:
+ *   afterPush  — schedule(reason) called after each completed sync pass
+ *   idle       — a resettable debounce timer (enrichment.idleMs)
+ *   both       — the default
+ *   manual     — no auto triggers; the /chapters-enrich run command drains
+ *
+ * Invariants this module owns:
+ *   - NEVER in a hot path: enrichOne is only reached from drain(), and
+ *     drain() is only fired by trigger events that already completed the
+ *     user's work (post-push) or by silence (idle) or a command.
+ *   - Idempotency key = chapter number + rootSession + model. Re-enqueue
+ *     after vocab change is NOT needed (vocab affects canonicalization at
+ *     index build, not the model call); after a MODEL change it IS (key
+ *     includes model, so the key naturally changes).
+ *   - enabled:false ⇒ every entry point is a pure no-op (kill-switch exit
+ *     criterion: the corpus stays fully functional, signatures-only).
+ *   - Cross-plane double-run: the caller-supplied lock (store-dir, same
+ *     pattern as sync's acquireLock) makes the realm + host queues safe on
+ *     one workspace.
+ */
+export function createEnrichQueue(deps) {
+    let idleTimer = null;
+    let draining = null;
+    let lastBatch = 0;
+    let modelCache = null;
+    let pendingEstimate = 0;
+    const setTimer = deps.setTimer ?? ((fn, ms) => {
+        const t = setTimeout(fn, ms);
+        return { cancel: () => clearTimeout(t) };
+    });
+    const drain = (forced = false) => {
+        // auto drains honor the trigger choice; a forced drain (the command /
+        // manual surface) only honors the kill switch
+        if (!deps.enabled || (!forced && deps.trigger === 'manual'))
+            return Promise.resolve(0);
+        if (draining !== null)
+            return draining; // one batch at a time; requests collapse
+        draining = (async () => {
+            try {
+                const model = await deps.resolveModel();
+                modelCache = model;
+                const pending = await deps.listPending(model, deps.batchCap);
+                pendingEstimate = pending.length;
+                let done = 0;
+                for (const item of pending) {
+                    const r = await deps.enrichOne(item.key);
+                    if (r.ok)
+                        done++;
+                }
+                lastBatch = done;
+                if (done > 0)
+                    deps.log(`enrichment batch: ${done}/${pending.length} chapter(s) via ${model}`);
+                return done;
+            }
+            catch (error) {
+                deps.log(`enrichment drain failed (kept silent for the user): ${String(error)}`);
+                return 0;
+            }
+            finally {
+                draining = null;
+            }
+        })();
+        return draining;
+    };
+    return {
+        onSyncDone: (reason) => {
+            if (!deps.enabled)
+                return;
+            if (deps.trigger === 'afterPush' || deps.trigger === 'both') {
+                deps.log(`enrichment scheduled after sync (${reason})`);
+                void drain();
+            }
+        },
+        noteActivity: () => {
+            if (!deps.enabled || (deps.trigger !== 'idle' && deps.trigger !== 'both'))
+                return;
+            idleTimer?.cancel();
+            idleTimer = setTimer(() => { void drain(); }, deps.idleMs);
+        },
+        drainNow: async () => {
+            if (!deps.enabled)
+                return 0;
+            return await drain(true);
+        },
+        state: () => ({
+            enabled: deps.enabled,
+            trigger: deps.trigger,
+            pendingEstimate,
+            lastBatch,
+            model: modelCache,
+        }),
+        dispose: () => { idleTimer?.cancel(); idleTimer = null; },
+    };
+}
+//# sourceMappingURL=enrich-queue.js.map

package/lib/enrich-queue.js.map

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

package/lib/enrich-store.d.ts

@@ -0,0 +1,31 @@
+export interface ChapterDoc {
+    /** raw frontmatter lines (between the --- fences), verbatim */
+    fmLines: string[];
+    body: string;
+}
+export declare function parseChapterFile(text: string): ChapterDoc;
+export declare const bodyHash: (body: string) => string;
+/**
+ * Apply minimal frontmatter updates, body-guaranteed. expectedFileSha256 is
+ * the registry record's hash — which archive.ts computes over the WHOLE FILE
+ * (sha256(chapter.markdown)), the same value the tamper-check compares on-disk
+ * bytes against (archive.ts verify). The verbatim-BODY guarantee is the
+ * declared frontmatter anchor: a body that no longer matches its declared
+ * hash is corruption and refuses any write. Convention note: this guard once
+ * compared the registry's whole-file hash against the BODY hash — a mismatch
+ * on every real chapter, so enrichment silently never wrote (found by the
+ * enrich e2e 2026-09-22; the error was invisible behind the host logger).
+ * Callers MUST re-anchor the registry record with the returned fileSha256
+ * after a changed=true write (the ladder does).
+ */
+export declare function updateChapterFrontmatter(filePath: string, updates: Record<string, string>, expectedFileSha256?: string): {
+    changed: boolean;
+    body: string;
+    fileSha256: string;
+};
+/** YAML-ish serializer for the provenance chain (nested block, newest first) */
+export declare function renderGeneratedBlock(chain: {
+    by: string;
+    model?: string;
+    at?: string;
+}[]): string;

package/lib/enrich-store.js

@@ -0,0 +1,103 @@
+/**
+ * P2 S3 — provenance persistence (record §2.4/§6.2): the ONLY sanctioned
+ * chapter-file mutation in the system.
+ *
+ * A chapter file = YAML frontmatter + verbatim body. Enrichment may rewrite
+ * frontmatter fields it owns (title/summary/topics/generated); the body is
+ * untouchable, so EVERY write re-verifies the body hash before committing
+ * and refuses, loudly, on any mismatch. Frontmatter edits are LINE-BASED
+ * minimal replacements (order and unknown lines preserved — the file's own
+ * renderer stays the authority on shape); the write is atomic (tmp+rename);
+ * provenance chains grow, never truncate.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+const FM_DELIM = '---';
+export function parseChapterFile(text) {
+    if (!text.startsWith(`${FM_DELIM}\n`))
+        throw new Error('chapter file lacks frontmatter');
+    let endLine = -1;
+    const lines = text.split('\n');
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i] === FM_DELIM) {
+            endLine = i;
+            break;
+        }
+    }
+    if (endLine === -1)
+        throw new Error('unterminated frontmatter');
+    return { fmLines: lines.slice(1, endLine), body: lines.slice(endLine + 1).join('\n') };
+}
+export const bodyHash = (body) => createHash('sha256').update(body, 'utf8').digest('hex');
+/** replace-or-append one top-level key; block values arrive as multi-line strings */
+function setFmLine(lines, key, value) {
+    const start = lines.findIndex((l) => new RegExp(`^${key}:`).test(l));
+    const replacement = value.split('\n').map((l, i) => (i === 0 ? `${key}: ${l}` : l));
+    if (start === -1)
+        return [...lines, ...replacement];
+    let end = start + 1;
+    while (end < lines.length && /^\s/.test(lines[end]))
+        end++;
+    return [...lines.slice(0, start), ...replacement, ...lines.slice(end)];
+}
+/**
+ * Apply minimal frontmatter updates, body-guaranteed. expectedFileSha256 is
+ * the registry record's hash — which archive.ts computes over the WHOLE FILE
+ * (sha256(chapter.markdown)), the same value the tamper-check compares on-disk
+ * bytes against (archive.ts verify). The verbatim-BODY guarantee is the
+ * declared frontmatter anchor: a body that no longer matches its declared
+ * hash is corruption and refuses any write. Convention note: this guard once
+ * compared the registry's whole-file hash against the BODY hash — a mismatch
+ * on every real chapter, so enrichment silently never wrote (found by the
+ * enrich e2e 2026-09-22; the error was invisible behind the host logger).
+ * Callers MUST re-anchor the registry record with the returned fileSha256
+ * after a changed=true write (the ladder does).
+ */
+export function updateChapterFrontmatter(filePath, updates, expectedFileSha256) {
+    const text = fs.readFileSync(filePath, 'utf8');
+    const doc = parseChapterFile(text);
+    const hash = bodyHash(doc.body);
+    const fileHash = bodyHash(text);
+    // self-consistency: a declared bodySha256 that no longer matches the body
+    // means on-disk corruption — refuse before anything else
+    // render.ts anchors the body hash under 'sha256:' — accept either name as
+    // the declared guard value
+    const declared = doc.fmLines.find((l) => /^(?:bodySha256|sha256):/.test(l))?.split(': ')[1]?.trim();
+    // Two legitimate declared forms exist: current (hash of the parsed body,
+    // trailing newline included) and legacy (hash of bodyText before the
+    // writer appended '\n' — every chapter archived before the 2026-09-23
+    // convention fix). Either matches; anything else is corruption. Accepting
+    // the legacy form keeps already-archived chapters enrichable.
+    if (declared !== undefined && declared !== hash && declared !== bodyHash(doc.body.replace(/\n$/, ''))) {
+        throw new Error(`refusing to touch ${filePath}: declared body hash ${declared.slice(0, 12)}… != computed ${hash.slice(0, 12)}… — body altered on disk`);
+    }
+    if (expectedFileSha256 !== undefined && expectedFileSha256 !== fileHash) {
+        throw new Error(`refusing to rewrite ${filePath}: file hash ${fileHash.slice(0, 12)}… != registry ${expectedFileSha256.slice(0, 12)}…`);
+    }
+    let fm = doc.fmLines;
+    let changed = false;
+    for (const [k, v] of Object.entries(updates)) {
+        const next = setFmLine(fm, k, v);
+        if (next.join('\n') !== fm.join('\n')) {
+            fm = next;
+            changed = true;
+        }
+    }
+    if (!changed)
+        return { changed: false, body: doc.body, fileSha256: fileHash };
+    // every sanctioned write carries a body anchor; render.ts names it sha256
+    if (!fm.some((l) => /^(?:bodySha256|sha256):/.test(l)))
+        fm = setFmLine(fm, 'sha256', hash);
+    const nextText = `${FM_DELIM}\n${fm.join('\n')}\n${FM_DELIM}\n${doc.body}`;
+    const tmp = path.join(path.dirname(filePath), `.${path.basename(filePath)}.tmp-${process.pid}`);
+    fs.writeFileSync(tmp, nextText);
+    fs.renameSync(tmp, filePath);
+    return { changed: true, body: doc.body, fileSha256: bodyHash(nextText) };
+}
+/** YAML-ish serializer for the provenance chain (nested block, newest first) */
+export function renderGeneratedBlock(chain) {
+    const inner = chain.map((m) => m.by === 'model' ? `\n    - by: model\n      model: ${m.model}\n      at: ${m.at ?? ''}` : '\n    - by: deterministic');
+    return inner.join('');
+}
+//# sourceMappingURL=enrich-store.js.map

package/lib/enrich-store.js.map

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

package/lib/enrich-wire.d.ts

@@ -0,0 +1,73 @@
+import { type EnrichQueue } from './enrich-queue.ts';
+import { type GeneratedProvenance, type GeneratedMark } from './enrich.ts';
+export interface EnrichConfig {
+    enabled: boolean;
+    /** 'provider/model' or '' = follow the conversation (realm) / stored route (host) */
+    model: string;
+    trigger: 'afterPush' | 'idle' | 'both' | 'manual';
+    idleMs: number;
+    batchCap: number;
+}
+export interface EnrichWiringDeps {
+    store: {
+        get(id: string): Promise<{
+            chapters: {
+                number: number;
+                path: string;
+                title: string;
+                summary: string;
+                topics: string[];
+                sha256: string;
+                generated?: Record<string, GeneratedMark[]>;
+            }[];
+        }>;
+        put(id: string, state: unknown): Promise<void>;
+        sessions(): IterableIterator<[string, unknown]>;
+        getSetting(key: string): string | undefined;
+        putSetting(key: string, value: string): Promise<void>;
+    };
+    cwd(): string | undefined;
+    config: EnrichConfig;
+    /** one completion; may reject — the ladder catches */
+    fetch(prompt: string, route: {
+        provider: string;
+        model: string;
+    } | null): Promise<string>;
+    /** route resolution when neither override nor config names one (realm: live agent; host: persisted) */
+    conversationRoute(): {
+        provider: string;
+        model: string;
+    } | null;
+    scheduler?: {
+        schedule(cwd: string, why: string): void;
+    };
+    log(m: string): void;
+    warn(m: string): void;
+    setTimer?: (fn: () => void, ms: number) => {
+        cancel(): void;
+    };
+}
+export interface EnrichWiring {
+    queue: EnrichQueue;
+    /** manual drain for the command surface (cwd arms the workspace for files) */
+    runNow(cwd?: string): Promise<{
+        processed: number;
+        remaining: number;
+    }>;
+    setModelOverride(v: string | null): Promise<void>;
+    modelOverride(): string | null;
+    statusLine(): string;
+    /** pending chapter count for reports (full scan, un-capped) */
+    pendingCount(): Promise<number>;
+    /** the resolved auxiliary route (enrichment AND plot share it, P2 decision) */
+    auxRoute(): {
+        provider: string;
+        model: string;
+    } | null;
+    /** planes remember the workspace seen at sync/command time */
+    rememberCwd(cwd: string): void;
+    dispose(): void;
+}
+/** YAML block for the generated: frontmatter field (newest-first chains) */
+export declare function renderGeneratedBlock(gen: GeneratedProvenance): string;
+export declare function createEnrichWiring(deps: EnrichWiringDeps): EnrichWiring;

package/lib/enrich-wire.js

@@ -0,0 +1,209 @@
+/**
+ * P2 S6 — enrichment wiring: binds the pure ladder (enrich.ts) and the
+ * guarded persistence (enrich-store.ts) to the registry domain and the sync
+ * scheduler, per plane.
+ *
+ * Division of labor (deliberate):
+ *   - REALM engine owns the AUTO triggers (afterPush/idle/both): it sees the
+ *     conversation's routed model (requestHeader) and fires after its own
+ *     pushes/finalizes; it persists the resolved provider/model route and a
+ *     state heartbeat into the shared settings table.
+ *   - HOST plane runs the command surface (manual drains, model override,
+ *     report/status) and reads the same tables; its queue is trigger-manual
+ *     so auto work never double-runs.
+ *
+ * The ladder per chapter: build slice -> fetch -> validate; invalid -> ONE
+ * retry with a nudge; still invalid -> keep deterministic values (never
+ * blocks, never blanks). Frontmatter write goes through the body-hash guard;
+ * the registry record mirrors the new fields; a modified file is republished
+ * via the scheduler (debounced).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createEnrichQueue } from "./enrich-queue.js";
+import { buildEnrichInput, parseEnrichResult, applyEnrich } from "./enrich.js";
+import { parseChapterFile, updateChapterFrontmatter } from "./enrich-store.js";
+const ROUTE_KEY = 'enrichment.route';
+const STATE_KEY = 'enrichment.state';
+const stripFence = (chunk) => chunk.trim().replace(/^```[a-z]*\n?/, '').replace(/\n?```\s*$/, '').trim();
+/** YAML block for the generated: frontmatter field (newest-first chains) */
+export function renderGeneratedBlock(gen) {
+    const lines = [];
+    for (const key of ['title', 'summary', 'topics']) {
+        const chain = gen[key];
+        if (chain === undefined || chain.length === 0)
+            continue;
+        lines.push(`  ${key}:`);
+        for (const m of chain) {
+            if (m.by === 'model')
+                lines.push(`    - by: model`, `      model: ${m.model}`, `      at: ${m.at ?? ''}`);
+            else
+                lines.push(`    - by: deterministic`);
+        }
+    }
+    return '\n' + lines.join('\n');
+}
+function chaptersOf(state) {
+    const c = state?.chapters;
+    return Array.isArray(c) ? c : [];
+}
+export function createEnrichWiring(deps) {
+    const resolveRoute = () => {
+        const override = deps.store.getSetting('enrichment.model') ?? '';
+        const spec = (override !== '' ? override : deps.config.model).trim();
+        if (spec !== '' && spec !== 'conversation') {
+            const i = spec.indexOf('/');
+            if (i > 0)
+                return { provider: spec.slice(0, i), model: spec.slice(i + 1) };
+            return { provider: deps.conversationRoute()?.provider ?? '', model: spec };
+        }
+        const persisted = deps.store.getSetting(ROUTE_KEY);
+        if (persisted !== undefined) {
+            const i = persisted.indexOf('/');
+            if (i > 0)
+                return { provider: persisted.slice(0, i), model: persisted.slice(i + 1) };
+        }
+        return deps.conversationRoute();
+    };
+    const modelKey = () => {
+        const r = resolveRoute();
+        return r !== null && r.model !== '' ? `${r.provider}/${r.model}` : 'conversation';
+    };
+    let rememberedCwd;
+    const ladder = async (key) => {
+        const sep = key.lastIndexOf('#');
+        const sid = key.slice(0, sep);
+        const num = Number(key.slice(sep + 1));
+        const cwd = deps.cwd() ?? rememberedCwd;
+        if (cwd === undefined)
+            return { ok: false, skipped: 'no workspace cwd yet (a sync or command arms it)' };
+        try {
+            const state = await deps.store.get(sid);
+            const rec = state.chapters.find((c) => c.number === num);
+            if (rec === undefined)
+                return { ok: false, skipped: 'record gone' };
+            const file = path.join(cwd, rec.path);
+            if (!fs.existsSync(file))
+                return { ok: false, skipped: 'chapter file absent' };
+            const doc = parseChapterFile(fs.readFileSync(file, 'utf8'));
+            const body = doc.body;
+            const userChunks = body.split(/\*\*User[^*\n]*:\*\*/g).slice(1);
+            const asstChunks = body.split(/\*\*Assistant[^*\n]*:\*\*/g).slice(1);
+            const input = buildEnrichInput({ title: rec.title }, {
+                requests: userChunks.slice(-3).map(stripFence),
+                ...(asstChunks.length > 0 ? { firstAssistant: stripFence(asstChunks[0]) } : {}),
+                ...(asstChunks.length > 1 ? { lastAssistant: stripFence(asstChunks[asstChunks.length - 1]) } : asstChunks.length === 1 && userChunks.length === 0 ? { lastAssistant: stripFence(asstChunks[0]) } : {}),
+            }, body.slice(0, 8000));
+            const route = resolveRoute();
+            const key2 = modelKey();
+            let result = parseEnrichResult(await deps.fetch(input, route));
+            if (result === null) {
+                // one retry with a nudge; garbage stays non-fatal (record §6.1)
+                result = parseEnrichResult(await deps.fetch(input + '\nRemember: reply with ONLY the JSON object, no other text.', route));
+            }
+            const current = { title: rec.title, summary: rec.summary, topics: rec.topics, ...(rec.generated !== undefined ? { generated: rec.generated } : {}) };
+            const applied = applyEnrich(current, result, key2, new Date().toISOString());
+            if (!applied.changed)
+                return { ok: false, skipped: result === null ? 'model output invalid; deterministic kept' : 'already enriched' };
+            const v = applied.values;
+            const written = updateChapterFrontmatter(file, {
+                title: JSON.stringify(v.title),
+                summary: JSON.stringify(v.summary),
+                topics: `[${v.topics.map((t) => JSON.stringify(t)).join(', ')}]`,
+                generated: renderGeneratedBlock(v.generated),
+            }, typeof rec.sha256 === 'string' ? rec.sha256 : undefined);
+            await deps.store.put(sid, {
+                ...state,
+                chapters: state.chapters.map((c) => c.number === num
+                    // re-anchor the registry's whole-file hash after the sanctioned write
+                    // so the cite-time tamper check stays truthful for every descendant
+                    ? { ...c, title: v.title, summary: v.summary, topics: v.topics, generated: v.generated, ...(written.changed ? { sha256: written.fileSha256 } : {}) }
+                    : c),
+            });
+            deps.scheduler?.schedule(cwd, 'archive:enrichment');
+            return { ok: true };
+        }
+        catch (error) {
+            deps.warn(`enrichment failed for ${key}: ${String(error?.message ?? error).slice(0, 120)}`);
+            return { ok: false, skipped: 'error' };
+        }
+    };
+    const queue = createEnrichQueue({
+        listPending: async (modelKey2, cap) => {
+            const out = [];
+            for (const [sid, st] of deps.store.sessions()) {
+                for (const c of chaptersOf(st)) {
+                    const top = c.generated?.title?.[0];
+                    if (top?.by === 'model' && top.model === modelKey2)
+                        continue;
+                    out.push({ key: `${sid}#${c.number}`, label: c.title.slice(0, 48) });
+                    if (out.length >= cap)
+                        return out;
+                }
+            }
+            return out;
+        },
+        enrichOne: ladder,
+        resolveModel: async () => modelKey(),
+        enabled: deps.config.enabled,
+        trigger: deps.config.trigger,
+        idleMs: deps.config.idleMs,
+        batchCap: deps.config.batchCap,
+        log: (m) => {
+            deps.log(m);
+            const r = resolveRoute();
+            if (r !== null)
+                void deps.store.putSetting(ROUTE_KEY, `${r.provider}/${r.model}`).catch(() => undefined);
+            void deps.store.putSetting(STATE_KEY, JSON.stringify({ at: new Date().toISOString(), line: m })).catch(() => undefined);
+        },
+        ...(deps.setTimer !== undefined ? { setTimer: deps.setTimer } : {}),
+    });
+    return {
+        queue,
+        auxRoute: () => resolveRoute(),
+        rememberCwd(c) { rememberedCwd = c; },
+        async pendingCount() {
+            let n = 0;
+            const key2 = modelKey();
+            for (const [, st] of deps.store.sessions()) {
+                for (const c of chaptersOf(st)) {
+                    const top = c.generated?.title?.[0];
+                    if (!(top?.by === 'model' && top.model === key2))
+                        n += 1;
+                }
+            }
+            return n;
+        },
+        async runNow(cwd) {
+            if (cwd !== undefined)
+                rememberedCwd = cwd;
+            const processed = await queue.drainNow();
+            return { processed, remaining: await this.pendingCount() };
+        },
+        async setModelOverride(v) {
+            if (v === null)
+                await deps.store.putSetting('enrichment.model', '');
+            else
+                await deps.store.putSetting('enrichment.model', v);
+        },
+        modelOverride() {
+            const o = deps.store.getSetting('enrichment.model') ?? '';
+            return o === '' ? null : o;
+        },
+        statusLine() {
+            if (!deps.config.enabled)
+                return 'enrichment: disabled (signatures-only corpus, fully functional)';
+            const override = this.modelOverride();
+            const model = override ?? (deps.config.model !== '' ? deps.config.model : 'conversation model');
+            const heartbeat = deps.store.getSetting(STATE_KEY);
+            let last = '';
+            try {
+                last = ` · last: ${JSON.parse(heartbeat ?? '{}').line ?? 'idle'}`;
+            }
+            catch { /* cosmetic */ }
+            return `enrichment: ${deps.config.trigger}, model ${model}${last}`;
+        },
+        dispose() { queue.dispose(); },
+    };
+}
+//# sourceMappingURL=enrich-wire.js.map

package/lib/enrich-wire.js.map

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