@isaacriehm/cairn-state 0.22.5

package/dist/rejected.js

@@ -0,0 +1,100 @@
+/**
+ * `.cairn/ground/_rejected.yaml` — slug-keyed ledger of topic-index
+ * entries the operator (or AI curator) has marked as not-a-decision.
+ *
+ * Phase 6 / `cairn ingest` skip any slug present here. The PR 2
+ * `cairn_propose_decision` MCP tool refuses rejected slugs with
+ * `{ ok: false, reason: "rejected" }`. Phase 5b's GC pass at the end
+ * of `buildTopicIndex` drops any entry whose slug is no longer in the
+ * freshly-built topic-index — so rotating docs / deleted markdown
+ * files don't accumulate dead rejection records.
+ *
+ * Dedup: first writer wins the `reason`; subsequent writes for the
+ * same slug only refresh `rejected_at`.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { writeFileSafe } from "./fs.js";
+import { getLogger } from "./logger.js";
+import { rejectedYamlPath } from "./paths.js";
+import { RejectedYaml } from "./schemas.js";
+const log = getLogger();
+export function emptyRejectedYaml() {
+    return { version: 1, generated: new Date().toISOString(), rejected: [] };
+}
+/**
+ * Read `_rejected.yaml` and return a slug-keyed Map for O(1) lookups.
+ * Missing file → empty Map. Malformed file → empty Map + warn (the
+ * sensor surface treats this as a deliberate clean slate rather than
+ * an error so the operator can recover by deleting the file).
+ */
+export function readRejectedYaml(repoRoot) {
+    const path = rejectedYamlPath(repoRoot);
+    if (!existsSync(path))
+        return new Map();
+    let parsed;
+    try {
+        parsed = parseYaml(readFileSync(path, "utf8"));
+    }
+    catch (err) {
+        log.warn({ path, err }, "_rejected.yaml read failed; treating as empty");
+        return new Map();
+    }
+    const result = RejectedYaml.safeParse(parsed);
+    if (!result.success) {
+        log.warn({ path, error: result.error.message }, "_rejected.yaml invalid; treating as empty");
+        return new Map();
+    }
+    const out = new Map();
+    for (const entry of result.data.rejected)
+        out.set(entry.slug, entry);
+    return out;
+}
+/**
+ * Persist a slug-keyed Map to `_rejected.yaml`. Rebuilds `generated`.
+ * Sorted by slug for stable diffs.
+ */
+export function writeRejectedYaml(repoRoot, rejected) {
+    const path = rejectedYamlPath(repoRoot);
+    const sortedSlugs = [...rejected.keys()].sort();
+    const next = {
+        version: 1,
+        generated: new Date().toISOString(),
+        rejected: sortedSlugs.map((s) => rejected.get(s)),
+    };
+    writeFileSafe(path, stringifyYaml(next));
+    log.debug({ path, count: next.rejected.length }, "wrote _rejected.yaml");
+    return path;
+}
+/**
+ * Append (or refresh) a rejection record. Dedup by slug — first writer
+ * wins the `reason` string; subsequent writes update `rejected_at`
+ * only. Returns the merged Map without persisting; callers handle the
+ * write so concurrent paths can batch under a single lock.
+ */
+export function appendRejected(current, entry) {
+    const next = new Map(current);
+    const existing = next.get(entry.slug);
+    if (existing === undefined) {
+        next.set(entry.slug, entry);
+    }
+    else {
+        next.set(entry.slug, { ...existing, rejected_at: entry.rejected_at });
+    }
+    return next;
+}
+/**
+ * Garbage-collect rejection records whose slug is no longer present in
+ * the freshly-built topic-index. Phase 5b runs this at the end of
+ * `buildTopicIndex` so the index-builder owns rejection lifecycle —
+ * keeps the sensor surface clean as docs rotate.
+ */
+export function gcRejectedYaml(rejected, liveSlugs) {
+    const next = new Map();
+    for (const [slug, entry] of rejected.entries()) {
+        if (liveSlugs.has(slug))
+            next.set(slug, entry);
+    }
+    return next;
+}
+//# sourceMappingURL=rejected.js.map

package/dist/rejected.js.map

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