@cstart/coldstart 2.0.0

package/dist/kb/view.js

@@ -0,0 +1,118 @@
+/**
+ * `coldstart kb view` — generate a single self-contained HTML file that browses
+ * the notebook, then open it in the default browser. No server: this is a
+ * one-shot generate-and-open. Freshness is computed NOW (whole-file hash
+ * tripwire, same as `status`), so the snapshot is accurate at generation time;
+ * re-run to refresh.
+ *
+ * The client is an embedded, dependency-free HTML/JS app (VIEW_TEMPLATE); this
+ * module only produces the baked JSON data and drops it into the template.
+ */
+import { writeFileSync, existsSync, readFileSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+import { execFile } from 'node:child_process';
+import { loadAll, notebookDir } from './store.js';
+import { renderNote } from './render.js';
+import { stampAnchors } from './freshness.js';
+const RANK = { fresh: 0, unverified: 1, changed: 2, missing: 3 };
+/** Strip renderNote's frontmatter + leading `# title` to get just the body md. */
+function bodyMarkdown(note) {
+    const md = renderNote(note);
+    const m = md.match(/^---\n[\s\S]*?\n---\n?([\s\S]*)$/);
+    let body = m ? m[1] : md;
+    body = body.replace(/^\s*#\s+.*\n?/, ''); // drop the first H1 (dupes the title)
+    return body.trim();
+}
+/** FoldedNote → the flat shape the client expects (mirrors the extract script). */
+function toClientNote(root, note) {
+    const stamped = stampAnchors(root, note.anchors).map((a) => ({
+        path: a.path,
+        symbols: a.symbols,
+        hash: a.hash,
+        state: a.state,
+    }));
+    let roll = stamped.length ? 'fresh' : 'unverified';
+    for (const a of stamped)
+        if (RANK[a.state] > RANK[roll])
+            roll = a.state;
+    const body = bodyMarkdown(note);
+    const outLinks = [...new Set([...body.matchAll(/\[\[([^\]]+)\]\]/g)].map((x) => x[1]))];
+    return {
+        id: note.id,
+        type: note.type,
+        character: note.character ?? null,
+        title: note.title,
+        aliases: note.aliases ?? [],
+        status: note.status,
+        updated: note.updated ?? '',
+        edits: note.edits ?? 0,
+        anchors: stamped,
+        freshness: roll,
+        dir: stamped[0] ? dirname(stamped[0].path) : '(unanchored)',
+        outLinks,
+        body,
+        backlinks: [],
+    };
+}
+/** Build the `{ summary, notes }` payload the template bakes in. */
+export function buildViewData(root, generated) {
+    const { notes: folded } = loadAll(root);
+    const notes = folded
+        .filter((n) => n.status !== 'retracted')
+        .map((n) => toClientNote(root, n));
+    const byId = new Map(notes.map((n) => [n.id, n]));
+    for (const n of notes) {
+        for (const l of n.outLinks) {
+            const t = byId.get(l);
+            if (t && l !== n.id && !t.backlinks.includes(n.id))
+                t.backlinks.push(n.id);
+        }
+    }
+    notes.sort((a, b) => (b.updated || '').localeCompare(a.updated || ''));
+    const byType = {};
+    const byFreshness = {};
+    for (const n of notes) {
+        byType[n.type] = (byType[n.type] || 0) + 1;
+        byFreshness[n.freshness] = (byFreshness[n.freshness] || 0) + 1;
+    }
+    return { summary: { total: notes.length, byType, byFreshness, repo: basename(root), generated }, notes };
+}
+/** Bake data into the template. `</` is neutralized so note text can't break the script tag. */
+export function renderViewHtml(template, data) {
+    const json = JSON.stringify(data).replace(/<\//g, '<\\/');
+    return template.replace('__DATA_JSON__', () => json);
+}
+/** Best-effort open in the OS default browser. Never throws. */
+function openInBrowser(file) {
+    const cmd = process.platform === 'darwin' ? { bin: 'open', args: [file] }
+        : process.platform === 'win32' ? { bin: 'cmd', args: ['/c', 'start', '', file] }
+            : { bin: 'xdg-open', args: [file] };
+    try {
+        const child = execFile(cmd.bin, cmd.args, () => { });
+        child.unref();
+    }
+    catch { /* ignore — the path is printed regardless */ }
+}
+/** Ensure the notebook .gitignore excludes the generated index.html. */
+function ignoreIndexHtml(root) {
+    const gi = join(notebookDir(root), '.gitignore');
+    try {
+        const cur = existsSync(gi) ? readFileSync(gi, 'utf8') : '';
+        if (!cur.split('\n').some((l) => l.trim() === 'index.html')) {
+            writeFileSync(gi, (cur && !cur.endsWith('\n') ? cur + '\n' : cur) + 'index.html\n');
+        }
+    }
+    catch { /* non-fatal */ }
+}
+/** Returns the written file path. */
+export function kbView(root, template, opts) {
+    const data = buildViewData(root, opts.generated);
+    const html = renderViewHtml(template, data);
+    const outPath = join(notebookDir(root), 'index.html');
+    writeFileSync(outPath, html);
+    ignoreIndexHtml(root);
+    if (opts.open !== false)
+        openInBrowser(outPath);
+    return outPath;
+}
+//# sourceMappingURL=view.js.map

package/dist/kb/view.js.map

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

package/dist/kb/write.d.ts

@@ -0,0 +1,72 @@
+import type { FileCharacter, LessonKind, NoteType } from './types.js';
+/** The agent-authored spec (JSON). Flat; unknown fields ride into the record.
+ *  `type` also accepts the shorthands "file-hub" / "file-single" — sugar for
+ *  type "file" + the character field (the log stores the canonical form so the
+ *  tolerant reader's type set never grows). */
+export interface WriteSpec {
+    type?: NoteType | 'file-hub' | 'file-single';
+    op?: 'put' | 'retract' | 'supersede';
+    id?: string;
+    /** File notes: the file the note is about (id + sole anchor derive from it). */
+    path?: string;
+    title?: string;
+    aliases?: string[];
+    anchors?: {
+        path: string;
+        symbols?: string[];
+    }[];
+    verified?: string[];
+    summary?: string;
+    character?: FileCharacter;
+    facets?: unknown[];
+    behaviors?: unknown[];
+    features?: unknown[];
+    steps?: unknown[];
+    invariants?: string[];
+    kind?: LessonKind;
+    body?: string;
+    scope?: {
+        terms?: string[];
+        globs?: string[];
+    };
+    target?: {
+        kind: string;
+        key?: string;
+    };
+    by?: string;
+    [key: string]: unknown;
+}
+export interface WriteCandidate {
+    id: string;
+    type: string;
+    title: string;
+    summary: string;
+}
+export type WriteResult = {
+    status: 'written';
+    id: string;
+    mdPath: string;
+    op: string;
+    warnings?: string[];
+} | {
+    status: 'candidates';
+    candidates: WriteCandidate[];
+    message: string;
+} | {
+    status: 'error';
+    message: string;
+};
+export interface WriteOptions {
+    /** Merge into this existing note id (phase-2 answer). */
+    into?: string;
+    /** Explicitly declare a new concept (phase-2 answer). */
+    isNew?: boolean;
+    /** Skip ALL candidate gates (fuzzy, exact-address, facet clash) and just
+     *  write. Validation-run mode: duplicates are observable data. Structural
+     *  validation (character, facet shape, ids) still applies. */
+    force?: boolean;
+    /** Session id for the capture-rate metric. */
+    session?: string;
+}
+export declare function kbWrite(root: string, spec: WriteSpec, opts?: WriteOptions): Promise<WriteResult>;
+//# sourceMappingURL=write.d.ts.map

package/dist/kb/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/kb/write.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAS,aAAa,EAAc,UAAU,EAAkB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAUzG;;;+CAG+C;AAC/C,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;IAC7C,EAAE,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAClF;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;kEAE8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsO1G"}

package/dist/kb/write.js

@@ -0,0 +1,345 @@
+/**
+ * kb write — the single write gate. The agent authors a JSON spec; this
+ * validates it, enforces the TWO-PHASE reuse gate for flow/lesson concepts,
+ * appends to the `.raw` log (which stamps ts + hashes), re-folds, and renders
+ * the derived md.
+ *
+ * Two-phase (the id-stability answer): a flow/lesson spec arriving WITHOUT an
+ * id first runs the note search on its own words. Any plausible matches →
+ * exit "candidates": the agent must re-run with `--into <id>` (merge into the
+ * existing concept) or `--new` (explicitly declare a new one). Unreliable
+ * generation ("produce the identical string") becomes reliable matching
+ * ("is this the same as one of these five?"). File notes skip the gate —
+ * their id is derived from the path.
+ */
+import { existsSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { fileNoteId, coinId, isValidId } from './ids.js';
+import { appendRecord, listIds } from './raw-log.js';
+import { loadNote, loadAll, writeNoteMd, logMetric } from './store.js';
+import { kbSearch } from './search.js';
+const NOTE_TYPES = new Set(['file', 'flow', 'lesson']);
+const LESSON_KINDS = new Set(['absence']);
+const CHARACTERS = new Set(['hub', 'single']);
+export async function kbWrite(root, spec, opts = {}) {
+    if (!spec || typeof spec !== 'object' || Array.isArray(spec))
+        return err('spec must be a JSON object');
+    const op = spec.op ?? 'put';
+    if (!['put', 'retract', 'supersede'].includes(op))
+        return err(`unknown op ${JSON.stringify(op)} — use put, retract, or supersede`);
+    // "file-hub" / "file-single" are spec-level sugar; the log stores type "file"
+    // + character (type is fold-immutable, character is a revisable judgment).
+    let type = spec.type;
+    let character = spec.character;
+    if (spec.type === 'file-hub' || spec.type === 'file-single') {
+        const sugared = spec.type === 'file-hub' ? 'hub' : 'single';
+        if (character && character !== sugared)
+            return err(`type "${spec.type}" conflicts with character "${character}"`);
+        character = sugared;
+        type = 'file';
+    }
+    if (!type || !NOTE_TYPES.has(type))
+        return err('spec needs a `type`: "file" (one real file — or shorthand "file-hub"/"file-single"), "flow" (a cross-file story), or "lesson" (a confirmed absence — "there is no X in this repo", with the search terms that proved it)');
+    if (character !== undefined && !CHARACTERS.has(character))
+        return err('`character` must be "hub" (no single purpose — knowledge lives as symbol-keyed facets) or "single" (one purpose, one summary)');
+    if (character !== undefined && type !== 'file')
+        return err('`character` belongs to file notes');
+    const facets = spec.facets;
+    if (facets !== undefined) {
+        if (type !== 'file')
+            return err('`facets` belong to file notes — flows point at them via step symbols; lessons anchor to them');
+        if (!Array.isArray(facets) || !facets.length)
+            return err('`facets` must be a non-empty array');
+        for (const f of facets) {
+            if (!f || typeof f !== 'object' || typeof f.symbol !== 'string' || !f.symbol.trim() || typeof f.detail !== 'string' || !f.detail.trim()) {
+                return err('each facet needs `symbol` (the top-level symbol it is about) and `detail` (+ optional `flows`: related flow-note ids)');
+            }
+        }
+    }
+    // ---- resolve the id -------------------------------------------------------
+    let id = opts.into ?? spec.id;
+    let freshlyCoined = false; // a coined id is created EXCLUSIVELY (see appendRecord)
+    const existing = new Set(listIds(root));
+    if (id !== undefined) {
+        if (!isValidId(id))
+            return err(`invalid id ${JSON.stringify(id)}`);
+        if ((opts.into || op !== 'put') && !existing.has(id))
+            return err(`no existing note ${id} — omit the id to create, or check \`kb status\``);
+        if (existing.has(id)) {
+            // A type-mismatched append would be skipped by the fold — reject it here.
+            const { note: target } = loadNote(root, id);
+            if (target && target.type !== type) {
+                return err(`${id} is a ${target.type} note, but this spec says type ${type} — wrong target id?`);
+            }
+        }
+    }
+    if (type === 'file') {
+        if (!spec.path)
+            return err('a file note needs `path` — the file it is about');
+        const derived = fileNoteId(spec.path);
+        if (id && id !== derived)
+            return err(`file-note ids are derived from the path (${derived}) — omit \`id\``);
+        id = derived;
+    }
+    else if (op === 'put' && !id) {
+        if (!spec.title || !String(spec.title).trim())
+            return err(`a new ${type} note needs a \`title\` (concept words a future agent would search with)`);
+        // ---- the two-phase gate ----
+        if (!opts.isNew && !opts.force) {
+            if (type === 'lesson' && Array.isArray(spec.anchors) && spec.anchors.length) {
+                // File-anchored facts dedup by EXACT (path, symbol) address — never by
+                // fuzzy title overlap (title words are whatever this session happened
+                // to choose; the address is stable).
+                const candidates = exactAddressCandidates(root, spec.anchors);
+                if (candidates.length) {
+                    return {
+                        status: 'candidates',
+                        candidates,
+                        message: 'Existing knowledge at this exact (path, symbol) address. A lesson → re-run with `--into <id>` to reconcile into it. A file-note facet → the fact may belong there instead: re-submit as `{"type": "file-hub", "path": ..., "facets": [...]}` with `--into <file-note-id>`. Only if yours is a genuinely different fact, re-run with `--new`.',
+                    };
+                }
+            }
+            else {
+                const queryWords = [spec.title, ...(spec.aliases ?? []), spec.summary ?? ''].join(' ');
+                const { hits } = await kbSearch(root, queryWords, { maxResults: 5, noMissLog: true });
+                // Same-type only: a lesson about a flow's file always word-overlaps that
+                // flow, but they are never the same concept — cross-type candidates would
+                // gate every lesson (and merging a lesson --into a flow corrupts the log).
+                const candidates = hits
+                    .filter((h) => h.note.type === type && h.note.status === 'active')
+                    .map((h) => ({
+                    id: h.note.id,
+                    type: h.note.type,
+                    title: h.note.title,
+                    summary: (h.note.summary ?? h.note.body ?? '').split('\n')[0].slice(0, 160),
+                }));
+                if (candidates.length) {
+                    return {
+                        status: 'candidates',
+                        candidates,
+                        message: 'Existing notes may already cover this concept. If one of these IS your concept, re-run with `--into <id>` to merge into it (reconcile, don\'t duplicate). Only if none match, re-run with `--new`.',
+                    };
+                }
+            }
+        }
+        id = coinId(spec.title, existing);
+        freshlyCoined = true;
+    }
+    if (!id)
+        return err(`op ${op} needs an \`id\` (which note to ${op})`);
+    const current = existing.has(id) ? loadNote(root, id).note : null;
+    // ---- per-type validation (put only) --------------------------------------
+    if (op === 'put') {
+        if (type === 'file') {
+            const effective = character ?? current?.character;
+            if (!effective)
+                return err('a file note needs `character` — "hub" (no single purpose; knowledge lives as symbol-keyed facets) or "single" (one purpose, one summary). Shorthand: `"type": "file-hub"` / `"file-single"`');
+            if (facets && effective === 'single')
+                return err('facets are for hub files — a single-purpose file carries one `summary`. If this file has outgrown one purpose, re-declare it: `"character": "hub"`');
+            // ---- facet clash gate: replacing existing knowledge must be informed ----
+            if (facets && current && !opts.into && !opts.force) {
+                const clashes = facets.filter((f) => current.facets.some((x) => x.symbol === f.symbol));
+                if (clashes.length) {
+                    return {
+                        status: 'candidates',
+                        candidates: clashes.map((f) => {
+                            const cur = current.facets.find((x) => x.symbol === f.symbol);
+                            return { id: id, type: 'file', title: `${spec.path} :: ${cur.symbol}`, summary: cur.detail.split('\n')[0].slice(0, 160) };
+                        }),
+                        message: 'A facet already exists at this symbol address (current knowledge shown above). If yours corrects or extends it, re-run with `--into <file-note-id>` — your detail replaces it, flow links union. If it is about something else, use a different symbol.',
+                    };
+                }
+            }
+        }
+        if (type === 'lesson') {
+            if (!spec.kind || !LESSON_KINDS.has(spec.kind))
+                return err('a lesson needs `kind`: absence (the only lesson kind — a confirmed "there is no X", with the search that proved it)');
+            if (spec.kind === 'absence' && !spec.scope?.terms?.length)
+                return err('an absence lesson needs `scope.terms` — the search that proved the absence (freshness = re-running it)');
+            if (!spec.body && !spec.id && !opts.into)
+                return err('a lesson needs a `body` — when it applies + the actual truth');
+        }
+        if (type === 'flow' && !spec.id && !opts.into && !spec.steps?.length && !spec.summary) {
+            return err('a flow note needs `steps` (the ordered cross-file story) or at least a `summary`');
+        }
+    }
+    else if (op === 'retract' && (!spec.target || typeof spec.target !== 'object' || !spec.target.kind)) {
+        return err('a retract needs `target`: {kind: behavior|feature|anchor|invariant|alias|note, key?}');
+    }
+    else if (op === 'supersede' && !spec.by) {
+        return err('a supersede needs `by` — the id of the note that replaces this one');
+    }
+    // ---- facet flow-ref resolution (title → id; lexical, warn-never-reject) ---
+    // Agents write flows and the file notes that back-link them in ONE chained
+    // call, but a flow's coined id isn't predictable (collision suffix), so a
+    // facet `flows` entry may be the flow's EXACT title instead. Resolution is
+    // strictly lexical: exact id match first, else exact normalized-title match
+    // against active flows — never fuzzy, so a wrong id can't be substituted.
+    // Anything unresolvable (typo, ambiguous title, non-flow id) is kept AS
+    // WRITTEN and warned about — same contract as pathWarnings: the note is
+    // never lost over one bad link; the writing agent fixes it right now, and
+    // lint flags whatever survives.
+    const flowRefWarnings = [];
+    if (op === 'put' && facets?.some((f) => f.flows?.length)) {
+        const { notes } = loadAll(root);
+        const active = notes.filter((n) => n.status === 'active');
+        const byId = new Map(active.map((n) => [n.id, n]));
+        const norm = (s) => s.toLowerCase().replace(/\s+/g, ' ').trim();
+        const byTitle = new Map();
+        for (const n of active) {
+            if (n.type !== 'flow')
+                continue;
+            const k = norm(n.title);
+            byTitle.set(k, [...(byTitle.get(k) ?? []), n]);
+        }
+        const resolved = [];
+        for (const f of facets) {
+            if (!f.flows?.length) {
+                resolved.push(f);
+                continue;
+            }
+            const out = [];
+            for (const ref of f.flows) {
+                const hit = byId.get(ref);
+                if (hit) {
+                    out.push(ref);
+                    if (hit.type !== 'flow')
+                        flowRefWarnings.push(`facet "${f.symbol}": flows entry "${ref}" is a ${hit.type} note, not a flow — check the id`);
+                    continue;
+                }
+                const matches = byTitle.get(norm(ref)) ?? [];
+                if (matches.length === 1) {
+                    out.push(matches[0].id);
+                    continue;
+                }
+                out.push(ref); // preserved as written — dangling beats lost
+                flowRefWarnings.push(matches.length > 1
+                    ? `facet "${f.symbol}": flow title "${ref}" is ambiguous (${matches.map((m) => m.id).join(', ')}) — kept as written; replace with the id`
+                    : `facet "${f.symbol}": flows entry "${ref}" matches no flow id or exact flow title — kept as written (dangling); fix with the flow's printed id or exact title`);
+            }
+            resolved.push({ ...f, flows: out });
+        }
+        spec = { ...spec, facets: resolved };
+    }
+    // ---- build the record -----------------------------------------------------
+    const { type: _t, op: _o, id: _i, path, ...rest } = spec;
+    void _t;
+    void _o;
+    void _i;
+    // The fold's tolerant reader validates payload shapes; the spec passes through.
+    const record = { ...rest, id, type, op };
+    if (type === 'file' && op === 'put' && path) {
+        // The file IS the anchor; the writer just deep-read it, so it counts verified.
+        // Anchor symbols accumulate (union with what the note already knows +
+        // facet symbols). The fold ALSO unions (concurrent writers each see stale
+        // state); the write-side union just keeps each record self-contained.
+        const symbols = [...new Set([
+                ...(current?.anchors.find((a) => a.path === path)?.symbols ?? []),
+                ...(Array.isArray(spec.anchors?.[0]?.symbols) ? spec.anchors[0].symbols : []),
+                ...(facets?.map((f) => f.symbol) ?? []),
+            ])];
+        record.anchors = [{ path, ...(symbols.length ? { symbols } : {}) }];
+        record.verified = [...new Set([path, ...(spec.verified ?? [])])];
+        if (character)
+            record.character = character; // sugar form ("file-hub") lands here
+    }
+    // A freshly-coined id is created with O_EXCL: two concurrent sessions can
+    // coin the same id (both listed the dir before either created the file) and
+    // would otherwise silently merge into one note. The loser lands on EEXIST,
+    // marks the id taken, and re-coins — two same-moment captures of one concept
+    // become a visible duplicate, never a silent merge.
+    try {
+        for (let attempt = 0;; attempt++) {
+            try {
+                appendRecord(root, record, { exclusive: freshlyCoined });
+                break;
+            }
+            catch (e) {
+                const code = e?.code;
+                if (!freshlyCoined || code !== 'EEXIST' || attempt >= 50)
+                    throw e;
+                existing.add(id);
+                id = coinId(spec.title, existing);
+                record.id = id;
+            }
+        }
+    }
+    catch (e) {
+        return err(e instanceof Error ? e.message : String(e));
+    }
+    const { note } = loadNote(root, id);
+    if (!note)
+        return err(`internal: ${id} folded to nothing after write`);
+    const mdPath = writeNoteMd(root, note);
+    logMetric(root, 'capture', { event: 'write', id, type, op, session: opts.session });
+    const warnings = [...(op === 'put' ? pathWarnings(root, spec) : []), ...flowRefWarnings];
+    return { status: 'written', id, mdPath, op, ...(warnings.length ? { warnings } : {}) };
+}
+/** Flag step/anchor paths that don't exist on disk — the flow→file join is a
+ *  static path string, so a typo'd path is a silently dangling link. Warn,
+ *  never reject: the writing agent is best placed to fix it right now, and a
+ *  legitimately deleted file is the agent's call to record. */
+function pathWarnings(root, spec) {
+    const out = [];
+    const check = (p, where) => {
+        if (typeof p !== 'string' || !p)
+            return;
+        if (isAbsolute(p)) {
+            out.push(`${where} "${p}" is absolute — use a repo-relative path (links join on the exact string)`);
+            return;
+        }
+        if (!existsSync(join(root, p)))
+            out.push(`${where} "${p}" not found on disk — dangling link unless the path is fixed`);
+    };
+    check(spec.path, 'path');
+    for (const a of spec.anchors ?? [])
+        check(a?.path, 'anchor');
+    for (const s of (spec.steps ?? []))
+        check(s?.path, 'step');
+    return out;
+}
+function err(message) {
+    return { status: 'error', message };
+}
+/**
+ * Exact (path, symbol) dedup for anchored lessons — the S2 walk: "what do we
+ * know about models.py::LoadStaging?" resolves by address, never by title
+ * words. Same-granularity matching keeps it exact: a symbol-level spec matches
+ * symbol-level lessons (overlap) plus the file note's facets at those symbols;
+ * a file-level spec (no symbols) matches file-level lessons on the same path.
+ */
+function exactAddressCandidates(root, anchors) {
+    const out = [];
+    const seen = new Set();
+    const { notes } = loadAll(root);
+    for (const spec of anchors) {
+        if (!spec || typeof spec.path !== 'string' || !spec.path)
+            continue;
+        const symbols = Array.isArray(spec.symbols) ? spec.symbols.filter((s) => typeof s === 'string') : [];
+        for (const n of notes) {
+            if (n.status !== 'active' || n.type !== 'lesson')
+                continue;
+            const hit = n.anchors.some((a) => a.path === spec.path && (symbols.length
+                ? (a.symbols ?? []).some((s) => symbols.includes(s))
+                : !a.symbols?.length));
+            if (hit && !seen.has(n.id)) {
+                seen.add(n.id);
+                out.push({ id: n.id, type: 'lesson', title: n.title, summary: (n.body ?? '').split('\n')[0].slice(0, 160) });
+            }
+        }
+        if (symbols.length) {
+            const fnote = notes.find((n) => n.id === fileNoteId(spec.path) && n.status === 'active');
+            for (const f of fnote?.facets ?? []) {
+                if (!symbols.includes(f.symbol))
+                    continue;
+                const key = `${fnote.id}::${f.symbol}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                out.push({ id: fnote.id, type: 'file', title: `${spec.path} :: ${f.symbol}`, summary: f.detail.split('\n')[0].slice(0, 160) });
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=write.js.map

package/dist/kb/write.js.map

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

package/dist/keeper-state.d.ts

@@ -0,0 +1,29 @@
+export interface KeeperEventStamp {
+    at: number;
+    detail: string;
+}
+export interface KeeperState {
+    pid: number;
+    startedAt: number;
+    lastReconcile?: KeeperEventStamp;
+    lastPatch?: KeeperEventStamp;
+    lastRebuild?: KeeperEventStamp;
+    lastSave?: KeeperEventStamp;
+}
+export interface RepairEvent {
+    at: number;
+    event: 'patch-failed' | 'rebuild-failed' | 'invariant-violation' | 'reconcile-failed';
+    detail: string;
+}
+export declare function keeperStatePath(rootDir: string, baseCacheDir?: string): string;
+export declare function repairLogPath(rootDir: string, baseCacheDir?: string): string;
+/** Read-merge-write. Best-effort and atomic — observability must never take
+ *  the keeper down, so all failures are swallowed. */
+export declare function updateKeeperState(rootDir: string, patch: Partial<KeeperState>, baseCacheDir?: string): Promise<void>;
+export declare function readKeeperState(rootDir: string, baseCacheDir?: string): KeeperState | null;
+/** Append one failure record. Size-capped: past the cap the file starts over
+ *  (the tail is what matters; a growing failure log IS the signal). */
+export declare function appendRepairLog(rootDir: string, event: RepairEvent['event'], detail: string, baseCacheDir?: string): Promise<void>;
+/** Last N repair events (tolerant reader — skips corrupt lines). */
+export declare function readRepairTail(rootDir: string, n?: number, baseCacheDir?: string): RepairEvent[];
+//# sourceMappingURL=keeper-state.d.ts.map

package/dist/keeper-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper-state.d.ts","sourceRoot":"","sources":["../src/keeper-state.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;IACtF,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;sDACsD;AACtD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,EAC3B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAO1F;AAED;uEACuE;AACvE,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAC3B,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,SAAI,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAc3F"}