@isaacriehm/cairn-state 0.22.5

package/dist/sot-cache.js

@@ -0,0 +1,62 @@
+import { existsSync, readFileSync } from "node:fs";
+import { writeFileSafe } from "./fs.js";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { getLogger } from "./logger.js";
+import { sotCachePath } from "./paths.js";
+import { SotCache } from "./schemas.js";
+const log = getLogger();
+/**
+ * Sot-cache holds pre-tokenized DEC body content for the Layer A Jaccard
+ * pre-filter. Rebuilt at SessionStart, incremental on PostToolUse Write
+ * events that touch a DEC body or sot-path file. Mtime-keyed so a stale
+ * entry is detected without re-tokenizing every body on every Write.
+ */
+export function emptySotCache() {
+    return { version: 1, generated: new Date().toISOString(), entries: {} };
+}
+export function readSotCache(repoRoot) {
+    const path = sotCachePath(repoRoot);
+    if (!existsSync(path))
+        return emptySotCache();
+    try {
+        const raw = readFileSync(path, "utf8");
+        const parsed = SotCache.safeParse(parseYaml(raw));
+        if (!parsed.success) {
+            log.warn({ path, error: parsed.error.message }, "sot-cache invalid; treating as empty");
+            return emptySotCache();
+        }
+        return parsed.data;
+    }
+    catch (err) {
+        log.warn({ path, err }, "sot-cache read failed; treating as empty");
+        return emptySotCache();
+    }
+}
+export function writeSotCache(repoRoot, cache) {
+    const path = sotCachePath(repoRoot);
+    const next = { ...cache, generated: new Date().toISOString() };
+    writeFileSafe(path, stringifyYaml(next));
+    log.debug({ path, entries: Object.keys(next.entries).length }, "wrote sot-cache");
+    return path;
+}
+export function setSotCacheEntry(cache, decId, entry) {
+    return { ...cache, entries: { ...cache.entries, [decId]: entry } };
+}
+export function getSotCacheEntry(cache, decId) {
+    return cache.entries[decId] ?? null;
+}
+export function deleteSotCacheEntry(cache, decId) {
+    if (cache.entries[decId] === undefined)
+        return cache;
+    const entries = { ...cache.entries };
+    delete entries[decId];
+    return { ...cache, entries };
+}
+/**
+ * Iterate all entries. Layer A's pre-filter pass calls this on each
+ * Write to compute Jaccard against every cached DEC body.
+ */
+export function sotCacheEntries(cache) {
+    return Object.values(cache.entries);
+}
+//# sourceMappingURL=sot-cache.js.map

package/dist/sot-cache.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Get the 1-based line number for a given character index in a text string.
+ */
+export declare function lineOf(text: string, charIndex: number): number;
+/**
+ * Escape a string for literal use inside a `RegExp`. The single canonical
+ * implementation — `components.ts`, the assertion engine, and the audit all
+ * route through this instead of re-spelling the character class.
+ */
+export declare function escapeRegExp(s: string): string;
+/**
+ * Split a comma-separated tag value (`@aliases`, `@uses`, …) into trimmed,
+ * non-empty parts. Replaces the `.split(",").map(trim).filter(Boolean)`
+ * triple that was repeated at every tag-list read site.
+ */
+export declare function splitCsv(value: string | undefined | null): string[];
+/** True when `name` is PascalCase by the {@link PASCAL_CASE_RE} signal. */
+export declare function isPascalCase(name: string): boolean;
+/**
+ * The `@cairn` registry-header signal: `@cairn` then whitespace then an
+ * identifier start. Single source of truth — deliberately disjoint from the
+ * colon-form `@cairn:decision` / `@cairn:rule` SoT markers (those can never
+ * be whitespace-then-identifier), so a marker is never misread as a header.
+ */
+export declare const HEADER_SIGNAL_RE: RegExp;
+/** Strip a file's extension, returning the basename stem (`Button.vue` → `Button`). */
+export declare function stemOf(basename: string): string;

package/dist/text.js

@@ -0,0 +1,63 @@
+/**
+ * Get the 1-based line number for a given character index in a text string.
+ */
+export function lineOf(text, charIndex) {
+    let line = 1;
+    for (let i = 0; i < charIndex && i < text.length; i++) {
+        if (text.charCodeAt(i) === 10 /* \n */) {
+            line += 1;
+        }
+    }
+    return line;
+}
+/* -------------------------------------------------------------------------- */
+/* Shared regex + string primitives                                           */
+/*                                                                            */
+/* These collapse identifiers that were re-derived inline across the          */
+/* component store, audit, sensors, and assertion engine. One definition,     */
+/* imported everywhere — never re-spell a regex literal in a call site.       */
+/* -------------------------------------------------------------------------- */
+/**
+ * Escape a string for literal use inside a `RegExp`. The single canonical
+ * implementation — `components.ts`, the assertion engine, and the audit all
+ * route through this instead of re-spelling the character class.
+ */
+export function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Split a comma-separated tag value (`@aliases`, `@uses`, …) into trimmed,
+ * non-empty parts. Replaces the `.split(",").map(trim).filter(Boolean)`
+ * triple that was repeated at every tag-list read site.
+ */
+export function splitCsv(value) {
+    return (value ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * PascalCase signal: a leading uppercase letter followed by a lowercase one.
+ * Deliberately excludes SCREAMING_CASE constants (`FEATURED_TABS`) and bare
+ * single-letter / acronym idents. The component convention for a unit name.
+ */
+const PASCAL_CASE_RE = /^[A-Z][a-z]/;
+/** True when `name` is PascalCase by the {@link PASCAL_CASE_RE} signal. */
+export function isPascalCase(name) {
+    return PASCAL_CASE_RE.test(name);
+}
+/**
+ * The `@cairn` registry-header signal: `@cairn` then whitespace then an
+ * identifier start. Single source of truth — deliberately disjoint from the
+ * colon-form `@cairn:decision` / `@cairn:rule` SoT markers (those can never
+ * be whitespace-then-identifier), so a marker is never misread as a header.
+ */
+export const HEADER_SIGNAL_RE = /@cairn[ \t]+[A-Za-z_$]/;
+/** Strip a file's extension, returning the basename stem (`Button.vue` → `Button`). */
+export function stemOf(basename) {
+    const slash = Math.max(basename.lastIndexOf("/"), basename.lastIndexOf("\\"));
+    const base = slash === -1 ? basename : basename.slice(slash + 1);
+    const dot = base.indexOf(".");
+    return dot === -1 ? base : base.slice(0, dot);
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,SAAiB;IACpD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAgC;IACvD,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,cAAc,GAAG,aAAa,CAAC;AAErC,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAEzD,uFAAuF;AACvF,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC"}

package/dist/topic-index.d.ts

@@ -0,0 +1,27 @@
+import { TopicIndex, type TopicIndexEntry } from "./schemas.js";
+/**
+ * Topic-index is the ground-state file that maps content-fingerprint
+ * slugs to the DECs they belong to. Phase 5b builds it before any
+ * extractor runs so phases 6 / 7b / 7c can dedup-by-topic instead of
+ * emitting one DEC per source. Layer A's PostToolUse hook reads it on
+ * every Write to know whether a freshly typed prose block is the first
+ * sighting of its content or a repeat of an existing topic.
+ */
+export declare function emptyTopicIndex(): TopicIndex;
+export declare function readTopicIndex(repoRoot: string): TopicIndex;
+export declare function writeTopicIndex(repoRoot: string, index: TopicIndex): string;
+/**
+ * Insert or replace a topic entry. Returns the updated index.
+ */
+export declare function setTopic(index: TopicIndex, slug: string, entry: TopicIndexEntry): TopicIndex;
+/**
+ * Look up a topic by slug. Returns null if absent.
+ */
+export declare function getTopic(index: TopicIndex, slug: string): TopicIndexEntry | null;
+/**
+ * Clear `dec_id` from any topic entry that references this DEC. Used
+ * by `cairn attention undo` for tier3-creation reversal so the topic
+ * stays in the index (next phase 5b walk can re-emit the topic) but
+ * no longer points at the now-deleted DEC.
+ */
+export declare function clearDecFromTopicIndex(index: TopicIndex, decId: string): TopicIndex;

package/dist/topic-index.js

@@ -0,0 +1,82 @@
+import { existsSync, readFileSync } from "node:fs";
+import { writeFileSafe } from "./fs.js";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { getLogger } from "./logger.js";
+import { topicIndexPath } from "./paths.js";
+import { TopicIndex } from "./schemas.js";
+const log = getLogger();
+/**
+ * Topic-index is the ground-state file that maps content-fingerprint
+ * slugs to the DECs they belong to. Phase 5b builds it before any
+ * extractor runs so phases 6 / 7b / 7c can dedup-by-topic instead of
+ * emitting one DEC per source. Layer A's PostToolUse hook reads it on
+ * every Write to know whether a freshly typed prose block is the first
+ * sighting of its content or a repeat of an existing topic.
+ */
+export function emptyTopicIndex() {
+    return { version: 1, generated: new Date().toISOString(), topics: {} };
+}
+export function readTopicIndex(repoRoot) {
+    const path = topicIndexPath(repoRoot);
+    if (!existsSync(path))
+        return emptyTopicIndex();
+    try {
+        const raw = readFileSync(path, "utf8");
+        const parsed = TopicIndex.safeParse(parseYaml(raw));
+        if (!parsed.success) {
+            log.warn({ path, error: parsed.error.message }, "topic-index invalid; treating as empty");
+            return emptyTopicIndex();
+        }
+        return parsed.data;
+    }
+    catch (err) {
+        log.warn({ path, err }, "topic-index read failed; treating as empty");
+        return emptyTopicIndex();
+    }
+}
+export function writeTopicIndex(repoRoot, index) {
+    const path = topicIndexPath(repoRoot);
+    const next = { ...index, generated: new Date().toISOString() };
+    writeFileSafe(path, stringifyYaml(next));
+    log.debug({ path, topics: Object.keys(next.topics).length }, "wrote topic-index");
+    return path;
+}
+/**
+ * Insert or replace a topic entry. Returns the updated index.
+ */
+export function setTopic(index, slug, entry) {
+    return {
+        ...index,
+        topics: { ...index.topics, [slug]: entry },
+    };
+}
+/**
+ * Look up a topic by slug. Returns null if absent.
+ */
+export function getTopic(index, slug) {
+    return index.topics[slug] ?? null;
+}
+/**
+ * Clear `dec_id` from any topic entry that references this DEC. Used
+ * by `cairn attention undo` for tier3-creation reversal so the topic
+ * stays in the index (next phase 5b walk can re-emit the topic) but
+ * no longer points at the now-deleted DEC.
+ */
+export function clearDecFromTopicIndex(index, decId) {
+    let mutated = false;
+    const topics = {};
+    for (const [slug, entry] of Object.entries(index.topics)) {
+        if (entry.dec_id === decId) {
+            const { dec_id: _omitted, ...rest } = entry;
+            topics[slug] = rest;
+            mutated = true;
+        }
+        else {
+            topics[slug] = entry;
+        }
+    }
+    if (!mutated)
+        return index;
+    return { ...index, topics };
+}
+//# sourceMappingURL=topic-index.js.map

package/dist/topic-index.js.map

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

package/dist/walk.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Walks the repo from root and returns every file (relative to root) that
+ * matches CANONICAL_GLOBS and is not excluded by CANONICAL_EXCLUDES.
+ *
+ * Skips heavyweight noise dirs (.git, node_modules, dist, etc.) eagerly.
+ */
+export declare function walkCanonical(repoRoot: string): string[];

package/dist/walk.js

@@ -0,0 +1,34 @@
+import { CANONICAL_EXCLUDES, CANONICAL_GLOBS } from "./paths.js";
+import { matchAnyGlob } from "./glob.js";
+import { walkFs } from "./fs.js";
+const SKIP_DIRS = new Set([
+    ".git",
+    "node_modules",
+    ".pnpm-store",
+    "dist",
+    ".next",
+    ".turbo",
+    ".cache",
+    ".archive",
+]);
+/**
+ * Walks the repo from root and returns every file (relative to root) that
+ * matches CANONICAL_GLOBS and is not excluded by CANONICAL_EXCLUDES.
+ *
+ * Skips heavyweight noise dirs (.git, node_modules, dist, etc.) eagerly.
+ */
+export function walkCanonical(repoRoot) {
+    const out = [];
+    walkFs({
+        dir: repoRoot,
+        skipDirs: SKIP_DIRS,
+        onFile: (rel) => {
+            if (matchAnyGlob(rel, CANONICAL_GLOBS) && !matchAnyGlob(rel, CANONICAL_EXCLUDES)) {
+                out.push(rel);
+            }
+        },
+    });
+    out.sort();
+    return out;
+}
+//# sourceMappingURL=walk.js.map

package/dist/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../src/walk.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,MAAM;IACN,cAAc;IACd,aAAa;IACb,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;CACX,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,CAAC;QACL,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,IAAI,YAAY,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,kBAAkB,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@isaacriehm/cairn-state",
+  "version": "0.22.5",
+  "description": "Cairn state — lightweight schemas and read-only I/O.",
+  "author": "Isaac Riehm",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}