@fractalsynapse/dsh-chapters 0.0.0-stage → 0.2.20

package/lib/enrich-wire.js

@@ -0,0 +1,353 @@
+/**
+ * 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 { createEnrichQueue } from "./enrich-queue.js";
+import { buildEnrichInput, buildMineInput, parseEnrichResult, parseMinedRules, applyEnrich } from "./enrich.js";
+import { parseChapterFile, updateChapterFrontmatter } from "./enrich-store.js";
+import { resolveStoredPath } from "./archive.js";
+import { isActiveChapter } from "./registry.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 ?? ''}`, 
+                // #61: which build wrote it. Absent on records from before the field existed — rendering
+                // `pluginVersion: undefined` would be a lie about a legacy row.
+                ...(m.pluginVersion !== undefined && m.pluginVersion !== '' ? [`      pluginVersion: ${m.pluginVersion}`] : []));
+            else
+                lines.push(`    - by: deterministic`);
+        }
+    }
+    return '\n' + lines.join('\n');
+}
+/**
+ * The HUMAN bytes of a chapter, and only these. The annotator input splits the
+ * body on user-role markers and slices(1) — which leaves every chunk RUNNING ON
+ * into the
+ * assistant reply that follows it, so it is not a set of user turns. For the
+ * verbatim-quote gate (§7.5) that distinction is the whole mechanism: a quote
+ * found in assistant prose is the model restating an instruction (the
+ * amplification path), never evidence a human gave one. So each chunk is cut at
+ * the next role marker before it is offered as evidence.
+ */
+export function humanBytesOf(body) {
+    const out = [];
+    // walk: a role label, then its text until the NEXT label
+    const re = /\*\*(User|Assistant)[^*\n]*:\*\*/g;
+    let m;
+    const marks = [];
+    while ((m = re.exec(body)) !== null)
+        marks.push({ role: m[1], start: m.index, end: m.index + m[0].length });
+    for (let i = 0; i < marks.length; i += 1) {
+        if (marks[i].role !== 'User')
+            continue;
+        const next = i + 1 < marks.length ? marks[i + 1].start : body.length;
+        const text = body.slice(marks[i].end, next);
+        if (text.trim() !== '')
+            out.push(text.trim());
+    }
+    return out.join('\n');
+}
+/**
+ * The ONE "does this chapter still need annotating?" test, used by BOTH the queue and `pendingCount`
+ * (#61). They were two hand-written loops over `chaptersOf` that had already drifted in shape, and the
+ * missing half was the minimum-content gate: five model calls in the field were spent titling husks
+ * ("Empty conversation span with unknown events and zero-byte results") — money thrown at nothing to
+ * annotate, and worse, the AI rename replaced a `FRAGMENT_TITLE`-shaped title so `indexing.ts` could no
+ * longer stitch adjacent legacy fragments (indexing.ts:43). So an empty chapter is not a candidate, and
+ * its deterministic title survives to be stitched.
+ */
+export function isPendingChapter(c, modelKey) {
+    if ((c.messages ?? 1) === 0)
+        return false;
+    const top = c.generated?.title?.[0];
+    return !(top?.by === 'model' && top.model === modelKey);
+}
+function chaptersOf(state) {
+    const c = state?.chapters;
+    // #60, widened #255: the enrichment queue reads registry chapters through the ONE predicate, so a
+    // repaired-away husk AND an operator-removed stub are never annotated and never re-enter the corpus
+    // through the ladder. The old inline `!== 'superseded'` here was a second predicate (#59 shape) —
+    // tests/unit/one-predicate.test.ts keeps comparisons against tombstone statuses inside registry.ts.
+    return Array.isArray(c) ? c.filter(isActiveChapter) : [];
+}
+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 {
+            // Pre-flight read: cheap, and only used to find the file to annotate. The WRITE below never
+            // touches this snapshot (#59).
+            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 = resolveStoredPath(cwd, rec.path);
+            if (!fs.existsSync(file))
+                return { ok: false, skipped: 'chapter file absent' };
+            const doc = parseChapterFile(fs.readFileSync(file, 'utf8'));
+            // A plan document is a WORK DIRECTIVE: its body is the approved text, and an
+            // annotator rewriting its summary is a paraphrase of an order (invariant 4's
+            // discipline applied to the ladder). Directives are indexed, cited and searched
+            // as they are; only transcript chapters are ever annotated.
+            if (doc.fmLines.some((l) => /^kind:\s*plan\s*$/.test(l)))
+                return { ok: false, skipped: 'plan documents are directives — never annotated' };
+            const body = doc.body;
+            const userChunks = body.split(/\*\*User[^*\n]*:\*\*/g).slice(1);
+            const asstChunks = body.split(/\*\*Assistant[^*\n]*:\*\*/g).slice(1);
+            // Optional CodeGraph structural context: extract code-shaped tokens from
+            // the chapter body and explore them against the project index. Fire-and-forget;
+            // failure → undefined (buildEnrichInput treats it as zero bytes).
+            let codegraphContext;
+            try {
+                const cg = await import("./codegraph.js");
+                const root = cg.findCodegraphRoot(cwd);
+                if (root !== undefined) {
+                    const tokens = cg.extractCodeTokens(body, 5);
+                    if (tokens.length > 0) {
+                        codegraphContext = await cg.exploreCodegraph(undefined, root, tokens.join(' '), 800, 15000);
+                        if (codegraphContext === '')
+                            codegraphContext = undefined;
+                    }
+                }
+            }
+            catch { /* CodeGraph unavailable or failed — enrichment proceeds without */ }
+            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), codegraphContext);
+            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));
+            }
+            // §7.5 mining, and it happens BEFORE the hash-guarded frontmatter write, so a
+            // chapter whose annotation is refused still contributes its standing orders.
+            const humanText = humanBytesOf(body);
+            let mined = result !== null ? result.rules : [];
+            // A dedicated governance model is opt-in; when set, ITS answer is what gets
+            // mined and the annotation pass's rules are ignored — two models minting
+            // rules for one chapter would just duplicate under different judgement.
+            const mineSpec = (deps.store.getSetting('rules.model') ?? deps.config.rulesModel ?? '').trim();
+            if (deps.config.mineRules !== false && mineSpec !== '' && mineSpec !== 'conversation') {
+                try {
+                    const sep = mineSpec.indexOf('/');
+                    const base = resolveRoute();
+                    const route = sep > 0
+                        ? { provider: mineSpec.slice(0, sep), model: mineSpec.slice(sep + 1) }
+                        : { provider: base?.provider ?? '', model: mineSpec };
+                    if (route.provider !== '') {
+                        mined = parseMinedRules(await deps.fetch(buildMineInput({ requests: userChunks.map(stripFence) }, body.slice(0, 6000)), route));
+                    }
+                    else {
+                        deps.warn(`rules.model "${mineSpec}" names no provider to route through — mining with the annotation result instead`);
+                    }
+                }
+                catch (error) {
+                    deps.warn(`rule mining pass failed (${String(error?.message ?? error).slice(0, 120)}) — the annotation is unaffected`);
+                    mined = [];
+                }
+            }
+            if (mined.length > 0) {
+                if (deps.config.mineRules === false) {
+                    deps.log(`rule mining skipped for ${sid}#${num}: ${mined.length} candidate(s) dropped (rulesEnrichment off)`);
+                }
+                else if (deps.onMinedRules === undefined) {
+                    deps.warn(`rule mining UNWIRED on this plane: ${mined.length} candidate(s) for ${sid}#${num} were not recorded — the sink owns disk + identity`);
+                }
+                else {
+                    try {
+                        const got = await deps.onMinedRules({
+                            cwd,
+                            sessionId: sid,
+                            chapterNumber: num,
+                            // The human's own bytes, cut at the next role marker. They decide
+                            // whether a mined rule is LABELLED `stated` or `inferred` — a warrant
+                            // shown to the human, not permission to govern (§7.5, 2026-10-21).
+                            humanText,
+                            rules: mined,
+                            max: deps.config.mineCap ?? 3,
+                            autoActivate: deps.config.rulesAutoActivate !== false,
+                        });
+                        if (got.written > 0) {
+                            deps.log(`rule mining ${sid}#${num}: ${got.written} recorded (${got.stated} stated by you, ${got.inferred} inferred${got.pending > 0 ? `, ${got.pending} held for review` : ', all governing now'} — /chapters-rule list --scope session)`);
+                            // session rules are LOCAL: nothing is armed on the scheduler (§7.5)
+                        }
+                    }
+                    catch (error) {
+                        deps.warn(`rule mining failed for ${sid}#${num}: ${String(error?.message ?? error).slice(0, 140)} — the annotation itself is unaffected`);
+                    }
+                }
+            }
+            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);
+            // #59: this put was built from a row read BEFORE the model call, so every chapter annotated
+            // late enough rewound whatever another door had committed in the meantime — the field
+            // instance landed at 04:53:52.841 over a compaction commit from 04:53:50.915. The whole
+            // remaining step is now ONE section over a fresh read: re-find the record, write the file,
+            // re-anchor the row. Nothing derived from a pre-model snapshot survives into the write.
+            await deps.store.mutate(sid, (fresh) => {
+                const cur = fresh.chapters.find((c) => c.number === num);
+                if (cur === undefined)
+                    return fresh; // record vanished under us: the file write already happened, the row is its own truth
+                return {
+                    ...fresh,
+                    chapters: fresh.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, number: c.number, title: v.title, summary: v.summary, topics: v.topics, generated: v.generated, ...(written.changed ? { sha256: written.fileSha256 } : {}) }
+                        : c),
+                };
+            });
+            // Annotated bytes are new knowledge: arm the push, exactly as before #59 moved the write.
+            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)) {
+                    if (!isPendingChapter(c, 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)) {
+                    if (isPendingChapter(c, 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 */ }
+            const mine = deps.config.mineRules === false ? ' · rule mining OFF' : ` · rule mining ON (≤${deps.config.mineCap ?? 3}/chapter, verbatim-quote gated)`;
+            return `enrichment: ${deps.config.trigger}, model ${model}${mine}${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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"}

package/lib/enrich.d.ts

@@ -0,0 +1,102 @@
+/**
+ * P2 S1 — the enrichment pass, pure core (record §6.1).
+ *
+ * One structured call per ARCHIVED chapter, input = the cheap slice the user
+ * specified (user requests + first/last assistant message, capped, plus the
+ * first ~200 tokens of the chapter body), output = validated JSON:
+ *   {"title": "...", "summary": "...", "topics": ["...", ...], "rules": [{"text","category","quote"}]?}
+ *
+ * No fs, no harness, no model here — the queue (S2) wires the fetcher. This
+ * module guarantees the properties the record stakes:
+ *   - VALIDATION BEFORE COMMIT: parseEnrichResult accepts nothing malformed;
+ *   - NEVER BLOCKS OR BLANKS: applyEnrich(null) is a pure no-op — the
+ *     deterministic title/summary/topics from P1 survive any model failure.
+ */
+export interface EnrichSlice {
+    requests: string[];
+    firstAssistant?: string;
+    lastAssistant?: string;
+}
+export interface EnrichResult {
+    title: string;
+    summary: string;
+    topics: string[];
+    /**
+     * #50 §7.5 — rules mined from this chapter. OPTIONAL: a model that returns the
+     * old three-field shape still validates, so every existing stub, fake and tape
+     * keeps passing. Each entry carries the human's own words as `quote`, and the
+     * quote is what gates activation (`session-rules.quoteIsHuman`) — the pass may
+     * PROPOSE a standing order, it may not make one on inference alone.
+     */
+    rules: MinedRuleOut[];
+}
+export interface MinedRuleOut {
+    text: string;
+    category: string;
+    quote: string;
+    /** the model's own claim about its warrant; the plugin re-checks the quote and
+     * records `stated` only when the material really contains it (§7.5) */
+    basis?: 'stated' | 'inferred' | undefined;
+}
+export type GeneratedMark = {
+    by: 'deterministic';
+} | {
+    by: 'model';
+    model: string;
+    at: string;
+    pluginVersion?: string | undefined;
+};
+export interface GeneratedProvenance {
+    title: GeneratedMark[];
+    summary: GeneratedMark[];
+    topics: GeneratedMark[];
+}
+export type EnrichableFields = 'title' | 'summary' | 'topics';
+export declare const ENRICH_MAX_TOKENS_DEFAULT = 4000;
+/**
+ * Assemble the model input: capped slice, stable order, hard total budget.
+ * Deterministic — same chapter material always produces the same prompt,
+ * which is what makes the queue's chapter+model idempotency key sound.
+ *
+ * @param codegraphContext Optional structural context from CodeGraph (symbols,
+ *   call paths). When present, appended as a bounded block so the enricher can
+ *   produce more precise topics. Absent → identical output to before this feature.
+ */
+export declare function buildEnrichInput(meta: {
+    title: string;
+}, slice: EnrichSlice, bodyHead: string, codegraphContext?: string): string;
+/**
+ * The validator. Tolerates code fences and surrounding prose (extracts the
+ * first JSON object), then requires every field well-shaped. Returns null —
+ * never throws — on ANY failure; the retry-then-keep-deterministic ladder is
+ * the caller's loop by design.
+ */
+export declare function parseEnrichResult(text: string): EnrichResult | null;
+/** The rules-only prompt for a dedicated mining model (§7.5, `rulesModel`). */
+export declare function buildMineInput(slice: EnrichSlice, bodyHead: string): string;
+/**
+ * Validate a mining-only answer. Bounds are the same as the annotation path's
+ * `rules` field so the two routes cannot produce differently-shaped candidates;
+ * an unknown `basis` falls back to the conservative `inferred`.
+ */
+export declare function parseMinedRules(text: string): MinedRuleOut[];
+export interface CurrentValues {
+    title: string;
+    summary: string;
+    topics: string[];
+    generated?: Partial<GeneratedProvenance>;
+}
+/**
+ * Merge an enrichment result into the chapter's model-owned fields.
+ * - result === null (ladder bottomed out) → PURE no-op, values + provenance
+ *   untouched (deterministic P1 values survive forever).
+ * - same values AND same newest model author → no-op (idempotent re-run).
+ * - otherwise: fields update; each provenance chain grows newest-first, one
+ *   entry per model (re-annotation by a newer model never erases history).
+ * The verbatim BODY is not in this module's universe — callers may only
+ * rewrite frontmatter fields (record §6.2), body hash-verified elsewhere.
+ */
+export declare function applyEnrich(current: CurrentValues, result: EnrichResult | null, model: string, at: string): {
+    values: CurrentValues;
+    changed: boolean;
+};