@lsctech/polaris 0.1.0

package/dist/smartdocs-engine/doctrine.test.js

@@ -0,0 +1,374 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_fs_2 = require("node:fs");
+const node_os_1 = require("node:os");
+const vitest_1 = require("vitest");
+const doctrine_js_1 = require("./doctrine.js");
+function makeTempDir() {
+    const root = (0, node_fs_2.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "polaris-doctrine-"));
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(root, "smartdocs", "docs", "raw"), { recursive: true });
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(root, "smartdocs", "docs", "doctrine", "candidate"), { recursive: true });
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(root, "smartdocs", "docs", "doctrine", "active"), { recursive: true });
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(root, "smartdocs", "docs", "doctrine", "deprecated"), { recursive: true });
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(root, "smartdocs", "docs", "specs", "active"), { recursive: true });
+    return root;
+}
+(0, vitest_1.describe)("doctrineDraft", () => {
+    let repoRoot;
+    (0, vitest_1.beforeEach)(() => {
+        repoRoot = makeTempDir();
+    });
+    (0, vitest_1.it)("moves a file from smartdocs/docs/raw/ to smartdocs/docs/doctrine/candidate/ with candidate marker", () => {
+        const source = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "some-doc.md");
+        (0, node_fs_1.writeFileSync)(source, "# Some Doc\n\nContent here.");
+        const result = (0, doctrine_js_1.doctrineDraft)(source, { repoRoot, runId: "test-run-001" });
+        (0, vitest_1.expect)(result.destination).toBe((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "some-doc.md"));
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(source)).toBe(false);
+        const content = (0, node_fs_1.readFileSync)(result.destination, "utf-8");
+        (0, vitest_1.expect)(content.startsWith(doctrine_js_1.CANDIDATE_MARKER)).toBe(true);
+        (0, vitest_1.expect)(content).toContain("# Some Doc");
+    });
+    (0, vitest_1.it)("emits a doctrine-draft event to lifecycle.jsonl", () => {
+        const source = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "event-doc.md");
+        (0, node_fs_1.writeFileSync)(source, "# Event Doc");
+        const result = (0, doctrine_js_1.doctrineDraft)(source, { repoRoot, runId: "test-run-001" });
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.lifecyclePath)).toBe(true);
+        const event = JSON.parse((0, node_fs_1.readFileSync)(result.lifecyclePath, "utf-8").trim().split("\n")[0]);
+        (0, vitest_1.expect)(event.event).toBe("doctrine-draft");
+        (0, vitest_1.expect)(event.run_id).toBe("test-run-001");
+        (0, vitest_1.expect)(event.source).toBe(source);
+        (0, vitest_1.expect)(event.destination).toBe(result.destination);
+    });
+    (0, vitest_1.it)("throws if source does not exist", () => {
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrineDraft)((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "nonexistent.md"), { repoRoot })).toThrow("Source file not found");
+    });
+    (0, vitest_1.it)("throws if source is not in smartdocs/docs/raw/", () => {
+        const source = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "wrong.md");
+        (0, node_fs_1.writeFileSync)(source, "# Wrong location");
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrineDraft)(source, { repoRoot })).toThrow("doctrineDraft source must be in smartdocs/docs/raw/");
+    });
+    (0, vitest_1.it)("throws if destination already exists", () => {
+        const source = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "dupe.md");
+        (0, node_fs_1.writeFileSync)(source, "# Dupe");
+        const dest = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "dupe.md");
+        (0, node_fs_1.writeFileSync)(dest, "# Already there");
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrineDraft)(source, { repoRoot })).toThrow("Destination already exists");
+    });
+});
+(0, vitest_1.describe)("doctrinePromote", () => {
+    let repoRoot;
+    (0, vitest_1.beforeEach)(() => {
+        repoRoot = makeTempDir();
+    });
+    const governanceFrontMatter = [
+        "---",
+        "status: candidate",
+        "doc-type: doctrine",
+        "confidence: 0.9",
+        "recommended-action: promote",
+        "overlap-analysis: none",
+        "---",
+        "",
+    ].join("\n");
+    (0, vitest_1.it)("moves a file from candidate/ to active/ and strips the candidate marker", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "my-doctrine.md");
+        (0, node_fs_1.writeFileSync)(candidatePath, `${doctrine_js_1.CANDIDATE_MARKER}\n${governanceFrontMatter}# My Doctrine\n\nContent.`);
+        const result = (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot, runId: "test-run-002" });
+        (0, vitest_1.expect)(result.destination).toBe((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "my-doctrine.md"));
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(candidatePath)).toBe(false);
+        const content = (0, node_fs_1.readFileSync)(result.destination, "utf-8");
+        (0, vitest_1.expect)(content).not.toContain(doctrine_js_1.CANDIDATE_MARKER);
+        (0, vitest_1.expect)(content).toContain("# My Doctrine");
+    });
+    (0, vitest_1.it)("emits a doctrine-promote event to lifecycle.jsonl", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "promoted.md");
+        (0, node_fs_1.writeFileSync)(candidatePath, `${doctrine_js_1.CANDIDATE_MARKER}\n${governanceFrontMatter}# Promoted`);
+        const result = (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot, runId: "test-run-002" });
+        const lines = (0, node_fs_1.readFileSync)(result.lifecyclePath, "utf-8").trim().split("\n");
+        const promoteEvent = lines.map((l) => JSON.parse(l)).find((e) => e.event === "doctrine-promote");
+        (0, vitest_1.expect)(promoteEvent).toBeDefined();
+        (0, vitest_1.expect)(promoteEvent.event).toBe("doctrine-promote");
+        (0, vitest_1.expect)(promoteEvent.run_id).toBe("test-run-002");
+    });
+    (0, vitest_1.it)("throws if source is not in smartdocs/docs/doctrine/candidate/", () => {
+        const source = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "wrong.md");
+        (0, node_fs_1.writeFileSync)(source, `${doctrine_js_1.CANDIDATE_MARKER}\n# Wrong`);
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrinePromote)(source, { repoRoot })).toThrow("doctrinePromote source must be in smartdocs/docs/doctrine/candidate/");
+    });
+    (0, vitest_1.it)("throws if file is missing the candidate marker", () => {
+        const source = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "unmarked.md");
+        (0, node_fs_1.writeFileSync)(source, "# No marker");
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrinePromote)(source, { repoRoot })).toThrow("not in candidate state");
+    });
+    (0, vitest_1.it)("throws if source does not exist", () => {
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrinePromote)((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "ghost.md"), { repoRoot })).toThrow("Source file not found");
+    });
+    (0, vitest_1.it)("rejects file missing governance fields", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "no-gov.md");
+        (0, node_fs_1.writeFileSync)(candidatePath, `${doctrine_js_1.CANDIDATE_MARKER}\n# Missing governance`);
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot })).toThrow('missing required governance field "doc-type"');
+    });
+    (0, vitest_1.it)("rejects file with recommended-action: hold", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "on-hold.md");
+        const content = [
+            doctrine_js_1.CANDIDATE_MARKER,
+            "---",
+            "doc-type: doctrine",
+            "confidence: 0.5",
+            "recommended-action: hold",
+            "overlap-analysis: none",
+            "---",
+            "",
+            "# On hold",
+        ].join("\n");
+        (0, node_fs_1.writeFileSync)(candidatePath, content);
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot })).toThrow('recommended-action must be "promote" but got "hold"');
+    });
+    (0, vitest_1.it)("succeeds with all required governance fields present", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "governed.md");
+        const content = [
+            doctrine_js_1.CANDIDATE_MARKER,
+            "---",
+            "doc-type: doctrine",
+            "confidence: 0.95",
+            "recommended-action: promote",
+            "overlap-analysis: none",
+            "---",
+            "",
+            "# Governed doc",
+        ].join("\n");
+        (0, node_fs_1.writeFileSync)(candidatePath, content);
+        const result = (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot, runId: "test-run-gov" });
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(candidatePath)).toBe(false);
+    });
+    (0, vitest_1.it)("moves co-located .provenance.json sidecar alongside the .md", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "with-prov.md");
+        const provenanceSrc = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "with-prov.provenance.json");
+        const content = [
+            doctrine_js_1.CANDIDATE_MARKER,
+            "---",
+            "doc-type: doctrine",
+            "confidence: 0.9",
+            "recommended-action: promote",
+            "overlap-analysis: none",
+            "---",
+            "",
+            "# With Provenance",
+        ].join("\n");
+        (0, node_fs_1.writeFileSync)(candidatePath, content);
+        (0, node_fs_1.writeFileSync)(provenanceSrc, JSON.stringify({ classifiedAs: "doctrine-candidate" }));
+        const result = (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot, runId: "test-run-prov" });
+        const provenanceDest = result.destination.replace(/\.md$/, ".provenance.json");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(provenanceDest)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(provenanceSrc)).toBe(false);
+    });
+    (0, vitest_1.it)("succeeds without error when no .provenance.json sidecar exists", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "no-prov.md");
+        const content = [
+            doctrine_js_1.CANDIDATE_MARKER,
+            "---",
+            "doc-type: doctrine",
+            "confidence: 0.9",
+            "recommended-action: promote",
+            "overlap-analysis: none",
+            "---",
+            "",
+            "# No Provenance",
+        ].join("\n");
+        (0, node_fs_1.writeFileSync)(candidatePath, content);
+        const result = (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot, runId: "test-run-noprov" });
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+    });
+    (0, vitest_1.it)("emits audit.jsonl event on successful promotion", () => {
+        const candidatePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "audited.md");
+        const content = [
+            doctrine_js_1.CANDIDATE_MARKER,
+            "---",
+            "doc-type: doctrine",
+            "confidence: 0.9",
+            "recommended-action: promote",
+            "overlap-analysis: minimal overlap with existing docs",
+            "---",
+            "",
+            "# Audited doc",
+        ].join("\n");
+        (0, node_fs_1.writeFileSync)(candidatePath, content);
+        const result = (0, doctrine_js_1.doctrinePromote)(candidatePath, { repoRoot, runId: "test-run-audit" });
+        const auditPath = (0, node_path_1.join)(repoRoot, ".taskchain_artifacts", "polaris-doctrine", "test-run-audit", "audit.jsonl");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(auditPath)).toBe(true);
+        const auditEvent = JSON.parse((0, node_fs_1.readFileSync)(auditPath, "utf-8").trim());
+        (0, vitest_1.expect)(auditEvent.event).toBe("doctrine-promoted");
+        (0, vitest_1.expect)(auditEvent.run_id).toBe("test-run-audit");
+        (0, vitest_1.expect)(auditEvent.doc_type).toBe("doctrine");
+        (0, vitest_1.expect)(auditEvent.confidence).toBe(0.9);
+        (0, vitest_1.expect)(auditEvent.recommended_action).toBe("promote");
+        (0, vitest_1.expect)(auditEvent.overlap_analysis).toBe("minimal overlap with existing docs");
+        (0, vitest_1.expect)(auditEvent.promoted_by).toBe("polaris-cli");
+        (0, vitest_1.expect)(result.destination).toBeDefined();
+    });
+});
+(0, vitest_1.describe)("addCandidateGovernanceMetadata", () => {
+    (0, vitest_1.it)("adds governance fields to content without front matter", () => {
+        const result = (0, doctrine_js_1.addCandidateGovernanceMetadata)("# Hello", "doctrine");
+        (0, vitest_1.expect)(result).toContain("doc-type: doctrine");
+        (0, vitest_1.expect)(result).toContain("confidence: 0.0");
+        (0, vitest_1.expect)(result).toContain("recommended-action: hold");
+        (0, vitest_1.expect)(result).toContain("overlap-analysis: pending");
+        (0, vitest_1.expect)(result).toContain("# Hello");
+    });
+    (0, vitest_1.it)("merges governance fields into existing front matter without overwriting existing keys", () => {
+        const content = "---\nstatus: candidate\ndoc-type: existing-type\n---\n\n# Hello";
+        const result = (0, doctrine_js_1.addCandidateGovernanceMetadata)(content, "doctrine");
+        (0, vitest_1.expect)(result).toContain("doc-type: existing-type");
+        (0, vitest_1.expect)(result).not.toContain("doc-type: doctrine");
+        (0, vitest_1.expect)(result).toContain("confidence: 0.0");
+        (0, vitest_1.expect)(result).toContain("recommended-action: hold");
+        (0, vitest_1.expect)(result).toContain("overlap-analysis: pending");
+    });
+    (0, vitest_1.it)("does not modify content when all governance fields already present", () => {
+        const content = [
+            "---",
+            "doc-type: doctrine",
+            "confidence: 0.9",
+            "recommended-action: promote",
+            "overlap-analysis: none",
+            "---",
+            "",
+            "# Hello",
+        ].join("\n");
+        const result = (0, doctrine_js_1.addCandidateGovernanceMetadata)(content, "other");
+        (0, vitest_1.expect)(result).toBe(content);
+    });
+});
+(0, vitest_1.describe)("doctrineDeprecate", () => {
+    let repoRoot;
+    (0, vitest_1.beforeEach)(() => {
+        repoRoot = makeTempDir();
+    });
+    (0, vitest_1.it)("moves a file from active/ to deprecated/ with deprecation provenance header", () => {
+        const activePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "old-doctrine.md");
+        (0, node_fs_1.writeFileSync)(activePath, "# Old Doctrine\n\nOriginal content.");
+        const result = (0, doctrine_js_1.doctrineDeprecate)(activePath, { repoRoot, runId: "test-run-003" });
+        (0, vitest_1.expect)(result.destination).toBe((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "deprecated", "old-doctrine.md"));
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(activePath)).toBe(false);
+        const content = (0, node_fs_1.readFileSync)(result.destination, "utf-8");
+        (0, vitest_1.expect)(content).toContain("polaris:doctrine-deprecated");
+        (0, vitest_1.expect)(content).toContain("# Old Doctrine");
+    });
+    (0, vitest_1.it)("emits a doctrine-deprecate event to lifecycle.jsonl", () => {
+        const activePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "deprecated.md");
+        (0, node_fs_1.writeFileSync)(activePath, "# Deprecated");
+        const result = (0, doctrine_js_1.doctrineDeprecate)(activePath, { repoRoot, runId: "test-run-003" });
+        const event = JSON.parse((0, node_fs_1.readFileSync)(result.lifecyclePath, "utf-8").trim().split("\n")[0]);
+        (0, vitest_1.expect)(event.event).toBe("doctrine-deprecate");
+        (0, vitest_1.expect)(event.run_id).toBe("test-run-003");
+        (0, vitest_1.expect)(event.deprecated_at).toBeDefined();
+    });
+    (0, vitest_1.it)("throws if source is not in smartdocs/docs/doctrine/active/", () => {
+        const source = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "candidate", "wrong.md");
+        (0, node_fs_1.writeFileSync)(source, `${doctrine_js_1.CANDIDATE_MARKER}\n# Wrong`);
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrineDeprecate)(source, { repoRoot })).toThrow("doctrineDeprecate source must be in smartdocs/docs/doctrine/active/");
+    });
+    (0, vitest_1.it)("throws if source does not exist", () => {
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.doctrineDeprecate)((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "ghost.md"), { repoRoot })).toThrow("Source file not found");
+    });
+    (0, vitest_1.it)("moves co-located .provenance.json sidecar alongside the .md", () => {
+        const activePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "prov-dep.md");
+        const provenanceSrc = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "prov-dep.provenance.json");
+        (0, node_fs_1.writeFileSync)(activePath, "# Prov Dep\n\nContent.");
+        (0, node_fs_1.writeFileSync)(provenanceSrc, JSON.stringify({ classifiedAs: "doctrine-candidate" }));
+        const result = (0, doctrine_js_1.doctrineDeprecate)(activePath, { repoRoot, runId: "test-run-dep-prov" });
+        const provenanceDest = result.destination.replace(/\.md$/, ".provenance.json");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(provenanceDest)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(provenanceSrc)).toBe(false);
+    });
+    (0, vitest_1.it)("succeeds without error when no .provenance.json sidecar exists", () => {
+        const activePath = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "doctrine", "active", "no-prov-dep.md");
+        (0, node_fs_1.writeFileSync)(activePath, "# No Prov\n\nContent.");
+        const result = (0, doctrine_js_1.doctrineDeprecate)(activePath, { repoRoot, runId: "test-run-dep-noprov" });
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+    });
+});
+(0, vitest_1.describe)("specPromote", () => {
+    let repoRoot;
+    (0, vitest_1.beforeEach)(() => {
+        repoRoot = makeTempDir();
+    });
+    (0, vitest_1.it)("promotes a raw spec to specs/active/ with no conflicts", () => {
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "my-spec.md");
+        (0, node_fs_1.writeFileSync)(src, "# My Spec\n\nThis spec must use the new API.");
+        const result = (0, doctrine_js_1.specPromote)(src, { repoRoot, runId: "spec-run-001" });
+        (0, vitest_1.expect)(result.halted).toBe(false);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(src)).toBe(false);
+        (0, vitest_1.expect)(result.destination).toContain("specs/active/my-spec.md");
+    });
+    (0, vitest_1.it)("moves co-located .provenance.json sidecar alongside the .md", () => {
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "prov-spec.md");
+        const provSrc = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "prov-spec.provenance.json");
+        (0, node_fs_1.writeFileSync)(src, "# Prov Spec\n\nMust always validate inputs.");
+        (0, node_fs_1.writeFileSync)(provSrc, JSON.stringify({ linkedMapArea: "src/api", classifiedAs: "spec-raw" }));
+        const result = (0, doctrine_js_1.specPromote)(src, { repoRoot, runId: "spec-run-prov" });
+        (0, vitest_1.expect)(result.halted).toBe(false);
+        const provDest = result.destination.replace(/\.md$/, ".provenance.json");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(provDest)).toBe(true);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(provSrc)).toBe(false);
+    });
+    (0, vitest_1.it)("halts when incoming content conflicts with an active spec", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "specs", "active", "existing.md"), "# Existing\n\nAgents must always validate inputs.");
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "conflict-spec.md");
+        (0, node_fs_1.writeFileSync)(src, "# Conflict\n\nAgents must never validate inputs.");
+        const result = (0, doctrine_js_1.specPromote)(src, { repoRoot, runId: "spec-run-conflict" });
+        (0, vitest_1.expect)(result.halted).toBe(true);
+        (0, vitest_1.expect)(result.conflicts.length).toBeGreaterThan(0);
+        (0, vitest_1.expect)(result.conflicts[0].type).toBe("content");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(src)).toBe(true);
+        (0, vitest_1.expect)(result.destination).toBe("");
+    });
+    (0, vitest_1.it)("proceeds past content conflicts when approve is true", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "specs", "active", "existing.md"), "# Existing\n\nAgents must always validate inputs.");
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "override-spec.md");
+        (0, node_fs_1.writeFileSync)(src, "# Override\n\nAgents must never validate inputs.");
+        const result = (0, doctrine_js_1.specPromote)(src, { repoRoot, runId: "spec-run-approve", approve: true });
+        (0, vitest_1.expect)(result.halted).toBe(false);
+        (0, vitest_1.expect)(result.conflicts.length).toBeGreaterThan(0);
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.destination)).toBe(true);
+    });
+    (0, vitest_1.it)("halts on map conflict when linkedMapArea already covered by active spec", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "specs", "active", "api-spec.md"), "# API Spec\n\nCovers src/api route logic.");
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "map-conflict.md");
+        const provSrc = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "map-conflict.provenance.json");
+        (0, node_fs_1.writeFileSync)(src, "# Map Conflict\n\nNew spec for the API.");
+        (0, node_fs_1.writeFileSync)(provSrc, JSON.stringify({ linkedMapArea: "src/api", classifiedAs: "spec-raw" }));
+        const result = (0, doctrine_js_1.specPromote)(src, { repoRoot, runId: "spec-run-map" });
+        (0, vitest_1.expect)(result.halted).toBe(true);
+        const mapConflict = result.conflicts.find((c) => c.type === "map");
+        (0, vitest_1.expect)(mapConflict).toBeDefined();
+    });
+    (0, vitest_1.it)("throws if source is not in smartdocs/docs/raw/", () => {
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "specs", "active", "wrong.md");
+        (0, node_fs_1.writeFileSync)(src, "# Wrong");
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.specPromote)(src, { repoRoot })).toThrow("specPromote source must be in smartdocs/docs/raw/");
+    });
+    (0, vitest_1.it)("throws if destination already exists", () => {
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "dupe-spec.md");
+        (0, node_fs_1.writeFileSync)(src, "# Dupe");
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(repoRoot, "smartdocs", "docs", "specs", "active", "dupe-spec.md"), "# Already there");
+        (0, vitest_1.expect)(() => (0, doctrine_js_1.specPromote)(src, { repoRoot })).toThrow("Destination already exists");
+    });
+    (0, vitest_1.it)("emits lifecycle event on successful promote", () => {
+        const src = (0, node_path_1.join)(repoRoot, "smartdocs", "docs", "raw", "lifecycle-spec.md");
+        (0, node_fs_1.writeFileSync)(src, "# Lifecycle Spec\n\nContent here.");
+        const result = (0, doctrine_js_1.specPromote)(src, { repoRoot, runId: "spec-lifecycle-001" });
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(result.lifecyclePath)).toBe(true);
+        const event = JSON.parse((0, node_fs_1.readFileSync)(result.lifecyclePath, "utf-8").trim().split("\n")[0]);
+        (0, vitest_1.expect)(event.event).toBe("spec-promote");
+        (0, vitest_1.expect)(event.run_id).toBe("spec-lifecycle-001");
+    });
+});