@lsctech/polaris 0.1.0

package/dist/cognition/cognition.test.js

@@ -0,0 +1,623 @@
+"use strict";
+/**
+ * Tests for route-local cognition delta logic.
+ *
+ * Covers:
+ * - isCognitionSkippedFolder
+ * - detectOperationalReasons
+ * - findNearestRoutePolarismd
+ * - applyRouteCognitionDelta
+ * - detectSummaryReasons
+ * - applySummaryDelta
+ * - isSummaryOversized / hasDoctrineBled
+ * - validateCognitionSurfaces / validateSummaryFile
+ * - looksLikePolarisChurn
+ * - detectMissingCognitionSurfaces (map/update)
+ * - seedCognitionDrafts (map/update)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const route_cognition_delta_js_1 = require("./route-cognition-delta.js");
+const summary_delta_js_1 = require("./summary-delta.js");
+const validate_js_1 = require("./validate.js");
+const archive_js_1 = require("./archive.js");
+const update_js_1 = require("../map/update.js");
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function makeTmp() {
+    const dir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `polaris-cognition-test-${Date.now()}`);
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    return dir;
+}
+function cleanup(dir) {
+    try {
+        (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+    }
+    catch { /* ignore */ }
+}
+// ── isCognitionSkippedFolder ──────────────────────────────────────────────────
+(0, vitest_1.describe)("isCognitionSkippedFolder", () => {
+    (0, vitest_1.it)("skips .git", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".git")).toBe(true));
+    (0, vitest_1.it)("skips .git/ prefix", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".git/refs")).toBe(true));
+    (0, vitest_1.it)("skips node_modules", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)("node_modules")).toBe(true));
+    (0, vitest_1.it)("skips dist/", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)("dist/index.js")).toBe(true));
+    (0, vitest_1.it)("skips .taskchain_artifacts/", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".taskchain_artifacts/polaris-run")).toBe(true));
+    (0, vitest_1.it)("allows .polaris root", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".polaris")).toBe(false));
+    (0, vitest_1.it)("allows .polaris/bootstrap", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".polaris/bootstrap")).toBe(false));
+    (0, vitest_1.it)("allows .polaris/clusters", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".polaris/clusters")).toBe(false));
+    (0, vitest_1.it)("allows .polaris/map", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".polaris/map")).toBe(false));
+    (0, vitest_1.it)("allows .polaris/runs", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".polaris/runs")).toBe(false));
+    (0, vitest_1.it)("skips generated .polaris/clusters descendants", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".polaris/clusters/POL-201")).toBe(true));
+    (0, vitest_1.it)("skips generated .polaris/runs descendants", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".polaris/runs/polaris-run-1")).toBe(true));
+    (0, vitest_1.it)("skips .claude agent folder", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)(".claude")).toBe(true));
+    (0, vitest_1.it)("does not skip src/", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)("src")).toBe(false));
+    (0, vitest_1.it)("does not skip src/loop", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)("src/loop")).toBe(false));
+    (0, vitest_1.it)("does not skip scripts/", () => (0, vitest_1.expect)((0, route_cognition_delta_js_1.isCognitionSkippedFolder)("scripts")).toBe(false));
+});
+// ── detectOperationalReasons ──────────────────────────────────────────────────
+(0, vitest_1.describe)("detectOperationalReasons", () => {
+    (0, vitest_1.it)("detects folder-responsibilities-changed from index.ts", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["src/loop/index.ts"]);
+        (0, vitest_1.expect)(reasons).toContain("folder-responsibilities-changed");
+    });
+    (0, vitest_1.it)("detects commands-workflows-changed from cli path", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["src/cli/args.ts"]);
+        (0, vitest_1.expect)(reasons).toContain("commands-workflows-changed");
+    });
+    (0, vitest_1.it)("detects execution-constraints-changed from config/schema.ts", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["src/config/schema.ts"]);
+        (0, vitest_1.expect)(reasons).toContain("execution-constraints-changed");
+    });
+    (0, vitest_1.it)("detects ownership-routing-changed from map/atlas.ts", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["src/map/atlas.ts"]);
+        (0, vitest_1.expect)(reasons).toContain("ownership-routing-changed");
+    });
+    (0, vitest_1.it)("detects operational-behavior-changed from worker.ts", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["src/loop/worker.ts"]);
+        (0, vitest_1.expect)(reasons).toContain("operational-behavior-changed");
+    });
+    (0, vitest_1.it)("returns empty for test files", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["src/loop/worker.test.ts"]);
+        (0, vitest_1.expect)(reasons).toHaveLength(0);
+    });
+    (0, vitest_1.it)("returns empty for non-operational markdown", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["docs/some-doc.md"]);
+        (0, vitest_1.expect)(reasons).toHaveLength(0);
+    });
+    (0, vitest_1.it)("returns empty for random json (non-config)", () => {
+        const reasons = (0, route_cognition_delta_js_1.detectOperationalReasons)(["data/fixtures.json"]);
+        (0, vitest_1.expect)(reasons).toHaveLength(0);
+    });
+});
+// ── findNearestRoutePolarismd ─────────────────────────────────────────────────
+(0, vitest_1.describe)("findNearestRoutePolarismd", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("finds POLARIS.md in parent dir when skipRoot=true", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "POLARIS.md"), "# loop", "utf-8");
+        const result = (0, route_cognition_delta_js_1.findNearestRoutePolarismd)("src/loop/worker.ts", tmp, true);
+        (0, vitest_1.expect)(result).toBe("src/loop/POLARIS.md");
+    });
+    (0, vitest_1.it)("skips root POLARIS.md when skipRoot=true", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# root", "utf-8");
+        const result = (0, route_cognition_delta_js_1.findNearestRoutePolarismd)("src/utils.ts", tmp, true);
+        (0, vitest_1.expect)(result).toBeNull();
+    });
+    (0, vitest_1.it)("returns root POLARIS.md when skipRoot=false", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# root", "utf-8");
+        const result = (0, route_cognition_delta_js_1.findNearestRoutePolarismd)("src/utils.ts", tmp, false);
+        (0, vitest_1.expect)(result).toBe("POLARIS.md");
+    });
+    (0, vitest_1.it)("finds nearest ancestor POLARIS.md", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "deep", "nested"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "POLARIS.md"), "# src", "utf-8");
+        const result = (0, route_cognition_delta_js_1.findNearestRoutePolarismd)("src/deep/nested/file.ts", tmp, true);
+        (0, vitest_1.expect)(result).toBe("src/POLARIS.md");
+    });
+    (0, vitest_1.it)("skips skipped folder paths", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, ".git", "hooks"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, ".git", "POLARIS.md"), "# git", "utf-8");
+        const result = (0, route_cognition_delta_js_1.findNearestRoutePolarismd)(".git/hooks/commit-msg", tmp, true);
+        (0, vitest_1.expect)(result).toBeNull();
+    });
+});
+// ── applyRouteCognitionDelta ──────────────────────────────────────────────────
+(0, vitest_1.describe)("applyRouteCognitionDelta", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("reports updateWarranted for operational files", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "POLARIS.md"), "# loop", "utf-8");
+        const result = (0, route_cognition_delta_js_1.applyRouteCognitionDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["src/loop/worker.ts", "src/loop/dispatch.ts"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.updateWarranted).toBe(true);
+        (0, vitest_1.expect)(result.reasons.length).toBeGreaterThan(0);
+        (0, vitest_1.expect)(result.routeLocalTargets).toContain("src/loop/POLARIS.md");
+    });
+    (0, vitest_1.it)("reports no update for test-only files", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "POLARIS.md"), "# loop", "utf-8");
+        const result = (0, route_cognition_delta_js_1.applyRouteCognitionDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["src/loop/worker.test.ts"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.updateWarranted).toBe(false);
+    });
+    (0, vitest_1.it)("detects missing POLARIS.md surfaces", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "newmod"), { recursive: true });
+        const result = (0, route_cognition_delta_js_1.applyRouteCognitionDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["src/newmod/index.ts"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.missingCognitionSurfaces).toContain("src/newmod");
+    });
+    (0, vitest_1.it)("does not scan root when skipRoot=true", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# root", "utf-8");
+        const result = (0, route_cognition_delta_js_1.applyRouteCognitionDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["src/loop/worker.ts"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.routeLocalTargets).not.toContain("POLARIS.md");
+    });
+    (0, vitest_1.it)("detects missing top-level Polaris runtime surfaces", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, ".polaris", "map"), { recursive: true });
+        const result = (0, route_cognition_delta_js_1.applyRouteCognitionDelta)({
+            repoRoot: tmp,
+            touchedFiles: [".polaris/map/file-routes.json"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.missingCognitionSurfaces).toContain(".polaris/map");
+    });
+});
+// ── archiveCognitionNotes ──────────────────────────────────────────────────────
+(0, vitest_1.describe)("archiveCognitionNotes", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("moves reconciled notes into archive and writes provenance files", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop", "note.md"), "hello", "utf-8");
+        const result = (0, archive_js_1.archiveCognitionNotes)({
+            repoRoot: tmp,
+            reconcileId: "reconcile-1",
+            runId: "run-1",
+            notesConsumed: ["src/loop/note.md"],
+            polarisMdUpdated: true,
+            summaryMdUpdated: false,
+            result: { status: "success", applied: true },
+        });
+        (0, vitest_1.expect)(result.archivedNotes).toEqual([".polaris/cognition/archive/src/loop/note.md"]);
+        (0, vitest_1.expect)(result.missingNotes).toEqual([]);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop", "note.md"))).toBe(false);
+        (0, vitest_1.expect)((0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "archive", "src", "loop", "note.md"), "utf-8")).toBe("hello");
+        (0, vitest_1.expect)(JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "archive", "src", "loop", ".reconcile-reconcile-1.json"), "utf-8"))).toEqual({
+            status: "success",
+            applied: true,
+        });
+        (0, vitest_1.expect)(JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "archive", "src", "loop", "cognition-index.json"), "utf-8"))).toEqual({
+            entries: [
+                {
+                    reconcile_id: "reconcile-1",
+                    run_id: "run-1",
+                    reconciled_at: vitest_1.expect.any(String),
+                    notes_consumed: ["note.md"],
+                    polaris_md_updated: true,
+                    summary_md_updated: false,
+                },
+            ],
+        });
+    });
+    (0, vitest_1.it)("keeps partial archive progress discoverable when some notes are missing", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop", "note.md"), "hello", "utf-8");
+        const result = (0, archive_js_1.archiveCognitionNotes)({
+            repoRoot: tmp,
+            reconcileId: "reconcile-2",
+            runId: "run-2",
+            notesConsumed: [
+                "src/loop/note.md",
+                "src/loop/missing.md",
+            ],
+            polarisMdUpdated: false,
+            summaryMdUpdated: true,
+        });
+        (0, vitest_1.expect)(result.archivedNotes).toEqual([".polaris/cognition/archive/src/loop/note.md"]);
+        (0, vitest_1.expect)(result.missingNotes).toEqual([".polaris/cognition/pending/src/loop/missing.md"]);
+        (0, vitest_1.expect)(JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "archive", "src", "loop", "cognition-index.json"), "utf-8"))).toEqual({
+            entries: [
+                {
+                    reconcile_id: "reconcile-2",
+                    run_id: "run-2",
+                    reconciled_at: vitest_1.expect.any(String),
+                    notes_consumed: ["note.md"],
+                    polaris_md_updated: false,
+                    summary_md_updated: true,
+                },
+            ],
+        });
+    });
+    (0, vitest_1.it)("keeps pending notes in place and records rejected librarian patches", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop", "note.md"), "hello", "utf-8");
+        const result = (0, archive_js_1.archiveCognitionNotes)({
+            repoRoot: tmp,
+            reconcileId: "reconcile-3",
+            runId: "run-3",
+            notesConsumed: ["src/loop/note.md"],
+            polarisMdUpdated: false,
+            summaryMdUpdated: false,
+            status: "rejected",
+            rejectionReason: "validation failed",
+            result: { status: "rejected" },
+        });
+        (0, vitest_1.expect)(result.archivedNotes).toEqual([]);
+        (0, vitest_1.expect)(result.resultFiles).toEqual([]);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop", "note.md"))).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "archive", "src", "loop", "note.md"))).toBe(false);
+        (0, vitest_1.expect)(JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, ".polaris", "cognition", "pending", "src", "loop", "cognition-index.json"), "utf-8"))).toEqual({
+            entries: [
+                {
+                    event: "cognition-librarian-patch-rejected",
+                    reconcile_id: "reconcile-3",
+                    run_id: "run-3",
+                    rejected_at: vitest_1.expect.any(String),
+                    notes_consumed: ["note.md"],
+                    polaris_md_updated: false,
+                    summary_md_updated: false,
+                    reason: "validation failed",
+                },
+            ],
+        });
+    });
+});
+// ── detectSummaryReasons ──────────────────────────────────────────────────────
+(0, vitest_1.describe)("detectSummaryReasons", () => {
+    (0, vitest_1.it)("detects linked-docs-changed for spec raw path", () => {
+        const reasons = (0, summary_delta_js_1.detectSummaryReasons)(["smartdocs/docs/specs/raw/arch.md"]);
+        (0, vitest_1.expect)(reasons).toContain("linked-docs-changed");
+    });
+    (0, vitest_1.it)("detects doctrine-spec-linkage-changed for AGENTS.md", () => {
+        const reasons = (0, summary_delta_js_1.detectSummaryReasons)(["AGENTS.md"]);
+        (0, vitest_1.expect)(reasons).toContain("canon-relationships-changed");
+    });
+    (0, vitest_1.it)("detects architecture-meaning-changed for architecture docs", () => {
+        const reasons = (0, summary_delta_js_1.detectSummaryReasons)(["smartdocs/docs/architecture/overview.md"]);
+        (0, vitest_1.expect)(reasons).toContain("architecture-meaning-changed");
+    });
+    (0, vitest_1.it)("returns empty for implementation source files", () => {
+        const reasons = (0, summary_delta_js_1.detectSummaryReasons)(["src/loop/worker.ts"]);
+        (0, vitest_1.expect)(reasons).toHaveLength(0);
+    });
+    (0, vitest_1.it)("detects config change as canon relationship", () => {
+        const reasons = (0, summary_delta_js_1.detectSummaryReasons)(["polaris.config.json"]);
+        (0, vitest_1.expect)(reasons).toContain("canon-relationships-changed");
+    });
+});
+// ── applySummaryDelta ─────────────────────────────────────────────────────────
+(0, vitest_1.describe)("applySummaryDelta", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("reports updateWarranted for spec changes", () => {
+        const result = (0, summary_delta_js_1.applySummaryDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["smartdocs/docs/specs/raw/some-spec.md"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.updateWarranted).toBe(true);
+    });
+    (0, vitest_1.it)("reports no update for implementation source", () => {
+        const result = (0, summary_delta_js_1.applySummaryDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["src/loop/checkpoint.ts"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.updateWarranted).toBe(false);
+    });
+    (0, vitest_1.it)("finds existing SUMMARY.md targets", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "smartdocs", "docs", "specs", "raw"), { recursive: true });
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "smartdocs", "docs", "specs"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "smartdocs", "docs", "specs", "SUMMARY.md"), "# specs summary", "utf-8");
+        const result = (0, summary_delta_js_1.applySummaryDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["smartdocs/docs/specs/raw/some.md"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.summaryTargets).toContain("smartdocs/docs/specs/SUMMARY.md");
+    });
+    (0, vitest_1.it)("detects folders with POLARIS.md but no SUMMARY.md", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "map"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "map", "POLARIS.md"), "# map", "utf-8");
+        const result = (0, summary_delta_js_1.applySummaryDelta)({
+            repoRoot: tmp,
+            touchedFiles: ["src/map/POLARIS.md"],
+            skipRoot: true,
+        });
+        (0, vitest_1.expect)(result.missingSummaries).toContain("src/map");
+    });
+});
+// ── detectPrecedenceLevel ─────────────────────────────────────────────────────
+(0, vitest_1.describe)("detectPrecedenceLevel", () => {
+    (0, vitest_1.it)("returns promoted-doctrine for active doctrine path", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)(["smartdocs/docs/doctrine/active/foo.md"])).toBe("promoted-doctrine");
+    });
+    (0, vitest_1.it)("returns spec-or-arch for active spec path", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)(["smartdocs/docs/specs/active/bar.md"])).toBe("spec-or-arch");
+    });
+    (0, vitest_1.it)("returns spec-or-arch for architecture doc", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)(["smartdocs/docs/architecture/overview.md"])).toBe("spec-or-arch");
+    });
+    (0, vitest_1.it)("returns spec-or-arch for specs/raw/ path", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)(["smartdocs/docs/specs/raw/polaris-spec.md"])).toBe("spec-or-arch");
+    });
+    (0, vitest_1.it)("returns route-polaris-md when only a POLARIS.md is touched", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)(["src/loop/POLARIS.md"])).toBe("route-polaris-md");
+    });
+    (0, vitest_1.it)("returns source-inference for plain source files", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)(["src/loop/worker.ts"])).toBe("source-inference");
+    });
+    (0, vitest_1.it)("promoted-doctrine wins over spec-or-arch in same batch", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)([
+            "smartdocs/docs/specs/raw/polaris-spec.md",
+            "smartdocs/docs/doctrine/active/core.md",
+        ])).toBe("promoted-doctrine");
+    });
+    (0, vitest_1.it)("spec-or-arch wins over route-polaris-md in same batch", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.detectPrecedenceLevel)([
+            "src/map/POLARIS.md",
+            "smartdocs/docs/architecture/overview.md",
+        ])).toBe("spec-or-arch");
+    });
+});
+// ── isSummaryOversized / hasDoctrineBled ──────────────────────────────────────
+(0, vitest_1.describe)("isSummaryOversized", () => {
+    (0, vitest_1.it)("returns false for short content", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.isSummaryOversized)("# Summary\n\nShort.")).toBe(false);
+    });
+    (0, vitest_1.it)("returns true when content exceeds SUMMARY_MAX_BYTES", () => {
+        const oversized = "x".repeat(summary_delta_js_1.SUMMARY_MAX_BYTES + 1);
+        (0, vitest_1.expect)((0, summary_delta_js_1.isSummaryOversized)(oversized)).toBe(true);
+    });
+});
+(0, vitest_1.describe)("hasDoctrineBled", () => {
+    (0, vitest_1.it)("detects '## Editing rules' section heading as doctrine bleed", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.hasDoctrineBled)("## Editing rules\n\nDo not add side effects.")).toBe(true);
+    });
+    (0, vitest_1.it)("detects '## Constraints' section heading as doctrine bleed", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.hasDoctrineBled)("## Constraints\n\nMust not skip.")).toBe(true);
+    });
+    (0, vitest_1.it)("detects strong imperative 'must always' at line start as doctrine bleed", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.hasDoctrineBled)("Workers must always stop after one child.")).toBe(true);
+    });
+    (0, vitest_1.it)("returns false for bare 'never' in prose (not imperative heading)", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.hasDoctrineBled)("This module never directly writes to disk.")).toBe(false);
+    });
+    (0, vitest_1.it)("returns false for 'do not' in quoted context", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.hasDoctrineBled)("The spec says \"do not skip validation\" in section 3.")).toBe(false);
+    });
+    (0, vitest_1.it)("returns false for normal informational content", () => {
+        (0, vitest_1.expect)((0, summary_delta_js_1.hasDoctrineBled)("# Summary\n\nThis module handles state management.")).toBe(false);
+    });
+});
+// ── validateCognitionSurfaces / validateSummaryFile ───────────────────────────
+(0, vitest_1.describe)("validateCognitionSurfaces", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("returns valid when no cognition files exist below root", () => {
+        const result = (0, validate_js_1.validateCognitionSurfaces)(tmp);
+        (0, vitest_1.expect)(result.valid).toBe(true);
+        (0, vitest_1.expect)(result.violations).toHaveLength(0);
+    });
+    (0, vitest_1.it)("detects oversized SUMMARY.md", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "SUMMARY.md"), "x".repeat(summary_delta_js_1.SUMMARY_MAX_BYTES + 100), "utf-8");
+        const result = (0, validate_js_1.validateCognitionSurfaces)(tmp);
+        const oversized = result.violations.filter((v) => v.type === "summary-oversized");
+        (0, vitest_1.expect)(oversized).toHaveLength(1);
+        (0, vitest_1.expect)(oversized[0].file).toBe("src/loop/SUMMARY.md");
+    });
+    (0, vitest_1.it)("puts doctrine bleed in warnings (not violations) and does not fail valid", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "SUMMARY.md"), "Workers must always stop after one child.", "utf-8");
+        const result = (0, validate_js_1.validateCognitionSurfaces)(tmp);
+        // Doctrine bleed is warn-only — must not fail validation
+        (0, vitest_1.expect)(result.valid).toBe(true);
+        (0, vitest_1.expect)(result.violations.filter((v) => v.type === "summary-doctrine-bleed")).toHaveLength(0);
+        (0, vitest_1.expect)(result.warnings.filter((v) => v.type === "summary-doctrine-bleed")).toHaveLength(1);
+    });
+    (0, vitest_1.it)("skips root-level POLARIS.md", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# Root", "utf-8");
+        const result = (0, validate_js_1.validateCognitionSurfaces)(tmp);
+        (0, vitest_1.expect)(result.valid).toBe(true);
+    });
+    (0, vitest_1.it)("skips skipped folders (.git, node_modules, etc.)", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, ".git"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, ".git", "SUMMARY.md"), "must always do X", "utf-8");
+        const result = (0, validate_js_1.validateCognitionSurfaces)(tmp);
+        (0, vitest_1.expect)(result.valid).toBe(true);
+    });
+});
+(0, vitest_1.describe)("validateSummaryFile", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("returns no violations for a clean summary", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "SUMMARY.md"), "# Summary\n\nContextual summary only.", "utf-8");
+        const violations = (0, validate_js_1.validateSummaryFile)("src/loop/SUMMARY.md", tmp);
+        (0, vitest_1.expect)(violations).toHaveLength(0);
+    });
+    (0, vitest_1.it)("returns warn-severity entry for doctrine bleed section heading", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "SUMMARY.md"), "## Editing rules\nNever skip.", "utf-8");
+        const results = (0, validate_js_1.validateSummaryFile)("src/loop/SUMMARY.md", tmp);
+        const bleed = results.find((v) => v.type === "summary-doctrine-bleed");
+        (0, vitest_1.expect)(bleed).toBeDefined();
+        (0, vitest_1.expect)(bleed.severity).toBe("warn");
+    });
+});
+// ── looksLikePolarisChurn ─────────────────────────────────────────────────────
+(0, vitest_1.describe)("looksLikePolarisChurn", () => {
+    (0, vitest_1.it)("detects identical content as churn", () => {
+        const content = "# Loop\n\nHandles session lifecycle.";
+        (0, vitest_1.expect)((0, validate_js_1.looksLikePolarisChurn)(content, content)).toBe(true);
+    });
+    (0, vitest_1.it)("detects whitespace-only diff as churn", () => {
+        (0, vitest_1.expect)((0, validate_js_1.looksLikePolarisChurn)("# Loop\n\nHandles sessions.", "# Loop\n\n\nHandles sessions.\n")).toBe(true);
+    });
+    (0, vitest_1.it)("does not flag substantive diff as churn", () => {
+        const before = "# Loop\n\nHandles sessions.";
+        const after = "# Loop\n\nHandles sessions.\n\n## New Section\n\nAdded new behavior.";
+        (0, vitest_1.expect)((0, validate_js_1.looksLikePolarisChurn)(before, after)).toBe(false);
+    });
+});
+// ── detectMissingCognitionSurfaces (map/update) ───────────────────────────────
+(0, vitest_1.describe)("detectMissingCognitionSurfaces", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("reports folder missing POLARIS.md for a touched file", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "newmod"), { recursive: true });
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)(["src/newmod/index.ts"], tmp);
+        (0, vitest_1.expect)(missingPolaris).toContain("src/newmod");
+    });
+    (0, vitest_1.it)("does not report a folder that already has POLARIS.md", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "POLARIS.md"), "# loop", "utf-8");
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)(["src/loop/worker.ts"], tmp);
+        (0, vitest_1.expect)(missingPolaris).not.toContain("src/loop");
+    });
+    (0, vitest_1.it)("reports folder with POLARIS.md but no SUMMARY.md as missing summary", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "POLARIS.md"), "# loop", "utf-8");
+        const { missingSummary } = (0, update_js_1.detectMissingCognitionSurfaces)(["src/loop/worker.ts"], tmp);
+        (0, vitest_1.expect)(missingSummary).toContain("src/loop");
+    });
+    (0, vitest_1.it)("does not report skipped folders", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, ".taskchain_artifacts", "polaris-run"), { recursive: true });
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)([".taskchain_artifacts/polaris-run/current-state.json"], tmp);
+        (0, vitest_1.expect)(missingPolaris).toHaveLength(0);
+    });
+    (0, vitest_1.it)("does not report root-level folder", () => {
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)(["README.md"], tmp);
+        (0, vitest_1.expect)(missingPolaris).not.toContain("");
+    });
+});
+// ── seedCognitionDrafts ───────────────────────────────────────────────────────
+(0, vitest_1.describe)("seedCognitionDrafts", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("creates draft POLARIS.md for eligible folders when seeding", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "newmod"), { recursive: true });
+        const seeded = (0, update_js_1.seedCognitionDrafts)({ polaris: ["src/newmod"], summary: [] }, tmp);
+        (0, vitest_1.expect)(seeded).toContain("src/newmod/POLARIS.md");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, "src", "newmod", "POLARIS.md"))).toBe(true);
+        const content = (0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, "src", "newmod", "POLARIS.md"), "utf-8");
+        // Draft only — scaffold headings with TODO placeholders, no filled content
+        (0, vitest_1.expect)(content).toContain("DRAFT");
+        (0, vitest_1.expect)(content).toContain("## Purpose");
+        (0, vitest_1.expect)(content).toContain("<!-- TODO -->");
+    });
+    (0, vitest_1.it)("creates draft SUMMARY.md for eligible folders when seeding", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "map"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "map", "POLARIS.md"), "# map", "utf-8");
+        const seeded = (0, update_js_1.seedCognitionDrafts)({ polaris: [], summary: ["src/map"] }, tmp);
+        (0, vitest_1.expect)(seeded).toContain("src/map/SUMMARY.md");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, "src", "map", "SUMMARY.md"))).toBe(true);
+        const content = (0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, "src", "map", "SUMMARY.md"), "utf-8");
+        // Draft only — no filled content, operator must complete
+        (0, vitest_1.expect)(content).toContain("DRAFT");
+        (0, vitest_1.expect)(content).toContain("Informational only");
+    });
+    (0, vitest_1.it)("does not overwrite existing files", () => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "loop"), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "src", "loop", "POLARIS.md"), "# existing content", "utf-8");
+        (0, update_js_1.seedCognitionDrafts)({ polaris: ["src/loop"], summary: [] }, tmp);
+        const content = (0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, "src", "loop", "POLARIS.md"), "utf-8");
+        (0, vitest_1.expect)(content).toBe("# existing content");
+    });
+    (0, vitest_1.it)("skips skipped folders", () => {
+        const seeded = (0, update_js_1.seedCognitionDrafts)({ polaris: [".taskchain_artifacts/polaris-run"], summary: [] }, tmp);
+        (0, vitest_1.expect)(seeded).toHaveLength(0);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, ".taskchain_artifacts", "polaris-run", "POLARIS.md"))).toBe(false);
+    });
+    (0, vitest_1.it)("does not create files during default map update (no seedCognition flag)", () => {
+        // This test verifies the integration contract: seedCognitionDrafts is only
+        // called when seedCognition=true is explicitly passed to runMapUpdate.
+        // Without that flag, detectMissingCognitionSurfaces runs but creates nothing.
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(tmp, "src", "newmod"), { recursive: true });
+        // Calling detectMissing but NOT seedCognitionDrafts simulates default behavior
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)(["src/newmod/index.ts"], tmp);
+        // Detection reports missing
+        (0, vitest_1.expect)(missingPolaris).toContain("src/newmod");
+        // But no files were created
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, "src", "newmod", "POLARIS.md"))).toBe(false);
+    });
+});
+// ── --include-root behavior ───────────────────────────────────────────────────
+(0, vitest_1.describe)("detectMissingCognitionSurfaces --include-root", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("does NOT report root when includeRoot is false/omitted", () => {
+        // Root-level file with no POLARIS.md at root
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)(["README.md"], tmp);
+        (0, vitest_1.expect)(missingPolaris).not.toContain("");
+    });
+    (0, vitest_1.it)("reports root as missing when includeRoot=true and no root POLARIS.md", () => {
+        // A top-level file (no sub-folder ancestor to find)
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)(["README.md"], tmp, true);
+        (0, vitest_1.expect)(missingPolaris).toContain("");
+    });
+    (0, vitest_1.it)("does NOT report root when root already has POLARIS.md and includeRoot=true", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# root", "utf-8");
+        const { missingPolaris } = (0, update_js_1.detectMissingCognitionSurfaces)(["README.md"], tmp, true);
+        (0, vitest_1.expect)(missingPolaris).not.toContain("");
+    });
+    (0, vitest_1.it)("reports root as missing SUMMARY.md when includeRoot=true and has POLARIS.md only", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# root", "utf-8");
+        const { missingSummary } = (0, update_js_1.detectMissingCognitionSurfaces)(["README.md"], tmp, true);
+        (0, vitest_1.expect)(missingSummary).toContain("");
+    });
+});
+(0, vitest_1.describe)("seedCognitionDrafts --include-root", () => {
+    let tmp;
+    (0, vitest_1.beforeEach)(() => { tmp = makeTmp(); });
+    (0, vitest_1.afterEach)(() => cleanup(tmp));
+    (0, vitest_1.it)("skips root by default (includeRoot omitted)", () => {
+        const seeded = (0, update_js_1.seedCognitionDrafts)({ polaris: [""], summary: [] }, tmp);
+        (0, vitest_1.expect)(seeded).toHaveLength(0);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, "POLARIS.md"))).toBe(false);
+    });
+    (0, vitest_1.it)("seeds root POLARIS.md when includeRoot=true", () => {
+        const seeded = (0, update_js_1.seedCognitionDrafts)({ polaris: [""], summary: [] }, tmp, true);
+        (0, vitest_1.expect)(seeded).toContain("POLARIS.md");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, "POLARIS.md"))).toBe(true);
+    });
+    (0, vitest_1.it)("seeds root SUMMARY.md when includeRoot=true", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# root", "utf-8");
+        const seeded = (0, update_js_1.seedCognitionDrafts)({ polaris: [], summary: [""] }, tmp, true);
+        (0, vitest_1.expect)(seeded).toContain("SUMMARY.md");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(tmp, "SUMMARY.md"))).toBe(true);
+    });
+    (0, vitest_1.it)("does not overwrite existing root POLARIS.md even with includeRoot=true", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "# existing root", "utf-8");
+        (0, update_js_1.seedCognitionDrafts)({ polaris: [""], summary: [] }, tmp, true);
+        (0, vitest_1.expect)((0, node_fs_1.readFileSync)((0, node_path_1.join)(tmp, "POLARIS.md"), "utf-8")).toBe("# existing root");
+    });
+});