@deftai/directive-core 0.60.0 → 0.61.1

package/dist/render/scope-outlook.js

@@ -0,0 +1,248 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { PROPOSED_DISCLAIMER_LINES, PROPOSED_STATUS_FILTER } from "../spec-authority/constants.js";
+import { SCOPE_SUMMARY_NARRATIVES } from "./constants.js";
+function readEdgeEndpoints(edge) {
+    if (typeof edge !== "object" || edge === null || Array.isArray(edge))
+        return ["", ""];
+    const e = edge;
+    return [String(e.from ?? e.source ?? "") || "", String(e.to ?? e.target ?? "") || ""];
+}
+function loadScopeVbriefs(folder) {
+    if (!existsSync(folder))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(folder)
+            .filter((n) => n.endsWith(".vbrief.json"))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of entries) {
+        try {
+            const data = JSON.parse(readFileSync(join(folder, name), "utf8"));
+            const stem = name.endsWith(".vbrief.json") ? name.slice(0, -".vbrief.json".length) : name;
+            out.push([stem, data]);
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return out;
+}
+function scopeId(stem, vbrief) {
+    const plan = vbrief.plan;
+    if (typeof plan === "object" && plan !== null && !Array.isArray(plan)) {
+        const planId = plan.id;
+        if (typeof planId === "string" && planId)
+            return planId;
+    }
+    return stem;
+}
+function crossScopeDepMap(scopes) {
+    const scopeIds = new Set(scopes.map(([stem, vb]) => scopeId(stem, vb)));
+    const depMap = {};
+    for (const [, vbrief] of scopes) {
+        const plan = vbrief.plan;
+        if (typeof plan !== "object" || plan === null || Array.isArray(plan))
+            continue;
+        const edges = plan.edges;
+        if (!Array.isArray(edges))
+            continue;
+        for (const edge of edges) {
+            const [frm, to] = readEdgeEndpoints(edge);
+            if (frm && to && scopeIds.has(frm) && scopeIds.has(to)) {
+                if (!depMap[to])
+                    depMap[to] = [];
+                depMap[to].push(frm);
+            }
+        }
+    }
+    return depMap;
+}
+function topoSortScopes(scopes, depMap) {
+    if (scopes.length === 0)
+        return [];
+    const idByIndex = scopes.map(([stem, vb]) => scopeId(stem, vb));
+    const idToIndex = new Map(idByIndex.map((sid, i) => [sid, i]));
+    const depths = {};
+    const depth = (sid, visited = null) => {
+        if (sid in depths)
+            return depths[sid] ?? 0;
+        const vis = visited ?? new Set();
+        if (vis.has(sid))
+            return 0;
+        vis.add(sid);
+        const deps = (depMap[sid] ?? []).filter((d) => idToIndex.has(d));
+        if (deps.length === 0) {
+            depths[sid] = 0;
+            return 0;
+        }
+        const result = Math.max(...deps.map((d) => depth(d, vis))) + 1;
+        depths[sid] = result;
+        return result;
+    };
+    for (const sid of idByIndex)
+        depth(sid);
+    const orderedIndices = [...idByIndex.keys()].sort((a, b) => (depths[idByIndex[a] ?? ""] ?? 0) - (depths[idByIndex[b] ?? ""] ?? 0) || a - b);
+    return orderedIndices.map((i) => scopes[i]);
+}
+function scopeSummaryNarrative(plan) {
+    const narratives = plan.narratives;
+    if (typeof narratives !== "object" || narratives === null || Array.isArray(narratives))
+        return "";
+    const narr = narratives;
+    for (const key of SCOPE_SUMMARY_NARRATIVES) {
+        const val = narr[key];
+        if (typeof val === "string" && val.trim())
+            return val.trim();
+    }
+    for (const val of Object.values(narr)) {
+        if (typeof val === "string" && val.trim())
+            return val.trim();
+    }
+    return "";
+}
+function splitAcceptance(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => String(item).trim()).filter((s) => s.length > 0);
+    }
+    if (typeof value !== "string")
+        return [];
+    const parts = [];
+    for (const line of value.split("\n")) {
+        let cleaned = line.trim();
+        if (!cleaned)
+            continue;
+        if (cleaned.startsWith("- ") || cleaned.startsWith("* "))
+            cleaned = cleaned.slice(2).trim();
+        if (cleaned)
+            parts.push(cleaned);
+    }
+    return parts;
+}
+function itemAcceptance(item) {
+    const narrative = item.narrative;
+    if (typeof narrative !== "object" || narrative === null || Array.isArray(narrative))
+        return [];
+    return splitAcceptance(narrative.Acceptance);
+}
+function renderScopeBlock(stem, vbrief) {
+    const plan = vbrief.plan;
+    if (typeof plan !== "object" || plan === null || Array.isArray(plan))
+        return [];
+    const planObj = plan;
+    const title = String(planObj.title ?? stem);
+    const status = String(planObj.status ?? "");
+    let heading = `### ${stem}: ${title}`;
+    if (status)
+        heading += `  \`[${status}]\``;
+    const lines = [`${heading}\n`];
+    const summary = scopeSummaryNarrative(planObj);
+    if (summary)
+        lines.push(`${summary}\n`);
+    const narratives = planObj.narratives;
+    if (typeof narratives === "object" && narratives !== null && !Array.isArray(narratives)) {
+        const scopeAcceptance = splitAcceptance(narratives.Acceptance);
+        if (scopeAcceptance.length > 0) {
+            lines.push("**Scope Acceptance**:\n");
+            for (const criterion of scopeAcceptance)
+                lines.push(`- ${criterion}`);
+            lines.push("");
+        }
+    }
+    const items = planObj.items;
+    if (Array.isArray(items) && items.length > 0) {
+        lines.push("**Acceptance**:\n");
+        for (const item of items) {
+            if (typeof item !== "object" || item === null || Array.isArray(item))
+                continue;
+            const itemObj = item;
+            const itemTitle = String(itemObj.title ?? "Untitled");
+            const itemStatus = String(itemObj.status ?? "");
+            let bullet = `- ${itemTitle}`;
+            if (itemStatus)
+                bullet += ` \`[${itemStatus}]\``;
+            lines.push(bullet);
+            for (const criterion of itemAcceptance(itemObj)) {
+                if (criterion !== itemTitle)
+                    lines.push(`  - Acceptance: ${criterion}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines;
+}
+const COMMITTED_BUCKETS = [
+    ["pending", "Accepted backlog (pending)"],
+    ["active", "Active"],
+    [
+        "completed",
+        "Completed",
+        (vb) => {
+            const plan = vb.plan;
+            return (typeof plan === "object" &&
+                plan !== null &&
+                !Array.isArray(plan) &&
+                plan.status === "completed");
+        },
+    ],
+];
+function filterProposed(vb) {
+    const plan = vb.plan;
+    if (typeof plan !== "object" || plan === null || Array.isArray(plan))
+        return true;
+    const status = String(plan.status ?? "proposed").toLowerCase();
+    return PROPOSED_STATUS_FILTER.has(status);
+}
+/** Build Scope outlook section per #2013 Wave 0 §4. */
+export function buildScopeOutlookSection(vbriefDir, options = {}) {
+    const includeProposed = options.includeProposed ?? false;
+    const proposedLimit = options.proposedLimit ?? 0;
+    const buckets = [];
+    if (includeProposed) {
+        let proposed = loadScopeVbriefs(join(vbriefDir, "proposed")).filter(([, vb]) => filterProposed(vb));
+        if (proposedLimit > 0 && proposed.length > proposedLimit) {
+            const omitted = proposed.length - proposedLimit;
+            proposed = proposed.slice(0, proposedLimit);
+            buckets.push([
+                "proposed",
+                `Not yet accepted (proposed) — showing ${proposedLimit} of ${proposedLimit + omitted}`,
+                proposed,
+            ]);
+        }
+        else if (proposed.length > 0) {
+            buckets.push(["proposed", "Not yet accepted (proposed)", proposed]);
+        }
+    }
+    for (const [folder, heading, filter] of COMMITTED_BUCKETS) {
+        let scopes = loadScopeVbriefs(join(vbriefDir, folder));
+        if (filter)
+            scopes = scopes.filter(([, vb]) => filter(vb));
+        if (scopes.length > 0)
+            buckets.push([folder, heading, scopes]);
+    }
+    if (buckets.length === 0)
+        return [];
+    const lines = ["## Scope outlook\n"];
+    for (const [folder, heading, scopes] of buckets) {
+        const depMap = crossScopeDepMap(scopes);
+        const ordered = topoSortScopes(scopes, depMap);
+        lines.push(`### ${heading}\n`);
+        if (folder === "proposed") {
+            for (const line of PROPOSED_DISCLAIMER_LINES)
+                lines.push(line, "");
+        }
+        for (const [stem, vbrief] of ordered)
+            lines.push(...renderScopeBlock(stem, vbrief));
+    }
+    return lines;
+}
+/** Legacy wrapper: stakeholder export (no proposed). */
+export function aggregateScopeSection(vbriefDir) {
+    return buildScopeOutlookSection(vbriefDir, { includeProposed: false });
+}
+//# sourceMappingURL=scope-outlook.js.map

package/dist/render/spec-render.js

@@ -1,117 +1,8 @@
-import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
-import { LIFECYCLE_BUCKETS, RENDERABLE_SPEC_STATUSES, SCOPE_SUMMARY_NARRATIVES, SPEC_RENDER_BANNER, SPECIFICATION_NARRATIVE_KEY_ORDER, } from "./constants.js";
+import { RENDERABLE_SPEC_STATUSES, SPEC_RENDER_BANNER, SPECIFICATION_NARRATIVE_KEY_ORDER, } from "./constants.js";
+import { aggregateScopeSection } from "./scope-outlook.js";
 import { validateSpec } from "./spec-validate.js";
-function readEdgeEndpoints(edge) {
-    if (typeof edge !== "object" || edge === null || Array.isArray(edge))
-        return ["", ""];
-    const e = edge;
-    const frm = String(e.from ?? e.source ?? "") || "";
-    const to = String(e.to ?? e.target ?? "") || "";
-    return [frm, to];
-}
-function loadScopeVbriefs(folder) {
-    if (!existsSync(folder))
-        return [];
-    let entries;
-    try {
-        entries = readdirSync(folder)
-            .filter((n) => n.endsWith(".vbrief.json"))
-            .sort();
-    }
-    catch {
-        return [];
-    }
-    const out = [];
-    for (const name of entries) {
-        const path = join(folder, name);
-        try {
-            const data = JSON.parse(readFileSync(path, "utf8"));
-            let stem = name;
-            if (stem.endsWith(".vbrief.json"))
-                stem = stem.slice(0, -".vbrief.json".length);
-            out.push([stem, data]);
-        }
-        catch {
-            /* skip malformed */
-        }
-    }
-    return out;
-}
-function scopeId(stem, vbrief) {
-    const plan = vbrief.plan;
-    if (typeof plan === "object" && plan !== null && !Array.isArray(plan)) {
-        const planId = plan.id;
-        if (typeof planId === "string" && planId)
-            return planId;
-    }
-    return stem;
-}
-function crossScopeDepMap(scopes) {
-    const scopeIds = new Set(scopes.map(([stem, vb]) => scopeId(stem, vb)));
-    const depMap = {};
-    for (const [, vbrief] of scopes) {
-        const plan = vbrief.plan;
-        if (typeof plan !== "object" || plan === null || Array.isArray(plan))
-            continue;
-        const edges = plan.edges;
-        if (!Array.isArray(edges))
-            continue;
-        for (const edge of edges) {
-            const [frm, to] = readEdgeEndpoints(edge);
-            if (frm && to && scopeIds.has(frm) && scopeIds.has(to)) {
-                if (!depMap[to])
-                    depMap[to] = [];
-                depMap[to].push(frm);
-            }
-        }
-    }
-    return depMap;
-}
-function topoSortScopes(scopes, depMap) {
-    if (scopes.length === 0)
-        return [];
-    const idByIndex = scopes.map(([stem, vb]) => scopeId(stem, vb));
-    const idToIndex = new Map(idByIndex.map((sid, i) => [sid, i]));
-    const depths = {};
-    const depth = (sid, visited = null) => {
-        if (sid in depths)
-            return depths[sid] ?? 0;
-        const vis = visited ?? new Set();
-        if (vis.has(sid))
-            return 0;
-        vis.add(sid);
-        const deps = (depMap[sid] ?? []).filter((d) => idToIndex.has(d));
-        if (deps.length === 0) {
-            depths[sid] = 0;
-            return 0;
-        }
-        const result = Math.max(...deps.map((d) => depth(d, vis))) + 1;
-        depths[sid] = result;
-        return result;
-    };
-    for (const sid of idByIndex)
-        depth(sid);
-    const orderedIndices = [...idByIndex.keys()].sort((a, b) => (depths[idByIndex[a] ?? ""] ?? 0) - (depths[idByIndex[b] ?? ""] ?? 0) || a - b);
-    return orderedIndices.map((i) => scopes[i]);
-}
-function scopeSummaryNarrative(plan) {
-    const narratives = plan.narratives;
-    if (typeof narratives !== "object" || narratives === null || Array.isArray(narratives)) {
-        return "";
-    }
-    const narr = narratives;
-    for (const key of SCOPE_SUMMARY_NARRATIVES) {
-        const val = narr[key];
-        if (typeof val === "string" && val.trim())
-            return val.trim();
-    }
-    for (const val of Object.values(narr)) {
-        if (typeof val === "string" && val.trim())
-            return val.trim();
-    }
-    return "";
-}
 function splitAcceptance(value) {
     if (Array.isArray(value)) {
         return value.map((item) => String(item).trim()).filter((s) => s.length > 0);
@@ -131,86 +22,6 @@ function splitAcceptance(value) {
     }
     return parts;
 }
-function itemAcceptance(item) {
-    const narrative = item.narrative;
-    if (typeof narrative !== "object" || narrative === null || Array.isArray(narrative))
-        return [];
-    return splitAcceptance(narrative.Acceptance);
-}
-function renderScopeBlock(stem, vbrief) {
-    const plan = vbrief.plan;
-    if (typeof plan !== "object" || plan === null || Array.isArray(plan))
-        return [];
-    const planObj = plan;
-    const title = String(planObj.title ?? stem);
-    const status = String(planObj.status ?? "");
-    let heading = `### ${stem}: ${title}`;
-    if (status)
-        heading += `  \`[${status}]\``;
-    const lines = [`${heading}\n`];
-    const summary = scopeSummaryNarrative(planObj);
-    if (summary)
-        lines.push(`${summary}\n`);
-    const narratives = planObj.narratives;
-    if (typeof narratives === "object" && narratives !== null && !Array.isArray(narratives)) {
-        const scopeAcceptance = splitAcceptance(narratives.Acceptance);
-        if (scopeAcceptance.length > 0) {
-            lines.push("**Scope Acceptance**:\n");
-            for (const criterion of scopeAcceptance)
-                lines.push(`- ${criterion}`);
-            lines.push("");
-        }
-    }
-    const items = planObj.items;
-    if (Array.isArray(items) && items.length > 0) {
-        lines.push("**Acceptance**:\n");
-        for (const item of items) {
-            if (typeof item !== "object" || item === null || Array.isArray(item))
-                continue;
-            const itemObj = item;
-            const itemTitle = String(itemObj.title ?? "Untitled");
-            const itemStatus = String(itemObj.status ?? "");
-            let bullet = `- ${itemTitle}`;
-            if (itemStatus)
-                bullet += ` \`[${itemStatus}]\``;
-            lines.push(bullet);
-            for (const criterion of itemAcceptance(itemObj)) {
-                if (criterion !== itemTitle)
-                    lines.push(`  - Acceptance: ${criterion}`);
-            }
-        }
-        lines.push("");
-    }
-    return lines;
-}
-function aggregateScopeSection(vbriefDir) {
-    const buckets = [];
-    for (const [folderName, heading] of LIFECYCLE_BUCKETS) {
-        let scopes = loadScopeVbriefs(join(vbriefDir, folderName));
-        if (folderName === "completed") {
-            scopes = scopes.filter(([, vb]) => {
-                const plan = vb.plan;
-                return (typeof plan === "object" &&
-                    plan !== null &&
-                    !Array.isArray(plan) &&
-                    plan.status === "completed");
-            });
-        }
-        if (scopes.length > 0)
-            buckets.push([folderName, heading, scopes]);
-    }
-    if (buckets.length === 0)
-        return [];
-    const lines = ["## Implementation Plan\n"];
-    for (const [, heading, scopes] of buckets) {
-        const depMap = crossScopeDepMap(scopes);
-        const ordered = topoSortScopes(scopes, depMap);
-        lines.push(`### ${heading}\n`);
-        for (const [stem, vbrief] of ordered)
-            lines.push(...renderScopeBlock(stem, vbrief));
-    }
-    return lines;
-}
 /** Render specification JSON to markdown (mirrors ``scripts/spec_render.render_spec``). */
 export function renderSpec(specPath, outPath, options = {}) {
     const includeScopes = options.includeScopes ?? true;

package/dist/spec-authority/constants.d.ts

@@ -0,0 +1,12 @@
+/** Generated-spec banner tokens (lockstep with Python ``_precutover.py``). */
+export declare const GENERATED_SPEC_PURPOSE = "<!-- Purpose: rendered specification -->";
+export declare const GENERATED_SPEC_SOURCE_SPEC = "<!-- Source of truth: vbrief/specification.vbrief.json -->";
+export declare const GENERATED_SPEC_SOURCE_PD = "<!-- Source of truth: vbrief/PROJECT-DEFINITION.vbrief.json -->";
+export declare const EXPORT_SPEC_PD_BANNER: string;
+/** Narratives excluded from stakeholder SPEC/PRD exports (#2013 Wave 0 §5). */
+export declare const STAKEHOLDER_EXCLUDED_NARRATIVE_KEYS: Set<string>;
+/** Product narrative keys used for migration-fidelity checks (#2005). */
+export declare const PRODUCT_NARRATIVE_KEYS: readonly ["ProblemStatement", "Goals", "UserStories", "Requirements", "SuccessMetrics", "FunctionalRequirements", "NonFunctionalRequirements", "AcceptanceCriteria", "Architecture", "EdgeCases"];
+export declare const PROPOSED_DISCLAIMER_LINES: readonly ["_Scopes in this section are ideas, not approved backlog. Promotion to pending is required before work starts._", "_Nothing here is in-flight or committed delivery scope._"];
+export declare const PROPOSED_STATUS_FILTER: Set<string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/spec-authority/constants.js

@@ -0,0 +1,34 @@
+/** Generated-spec banner tokens (lockstep with Python ``_precutover.py``). */
+export const GENERATED_SPEC_PURPOSE = "<!-- Purpose: rendered specification -->";
+export const GENERATED_SPEC_SOURCE_SPEC = "<!-- Source of truth: vbrief/specification.vbrief.json -->";
+export const GENERATED_SPEC_SOURCE_PD = "<!-- Source of truth: vbrief/PROJECT-DEFINITION.vbrief.json -->";
+export const EXPORT_SPEC_PD_BANNER = "<!-- AUTO-GENERATED by task project:export-spec -- DO NOT EDIT MANUALLY -->\n" +
+    `${GENERATED_SPEC_PURPOSE}\n` +
+    `${GENERATED_SPEC_SOURCE_PD}\n` +
+    "<!-- Regenerate with: task project:export-spec -->\n";
+/** Narratives excluded from stakeholder SPEC/PRD exports (#2013 Wave 0 §5). */
+export const STAKEHOLDER_EXCLUDED_NARRATIVE_KEYS = new Set([
+    "projectconfig",
+    "tech stack",
+    "techstack",
+    "configuration",
+]);
+/** Product narrative keys used for migration-fidelity checks (#2005). */
+export const PRODUCT_NARRATIVE_KEYS = [
+    "ProblemStatement",
+    "Goals",
+    "UserStories",
+    "Requirements",
+    "SuccessMetrics",
+    "FunctionalRequirements",
+    "NonFunctionalRequirements",
+    "AcceptanceCriteria",
+    "Architecture",
+    "EdgeCases",
+];
+export const PROPOSED_DISCLAIMER_LINES = [
+    "_Scopes in this section are ideas, not approved backlog. Promotion to pending is required before work starts._",
+    "_Nothing here is in-flight or committed delivery scope._",
+];
+export const PROPOSED_STATUS_FILTER = new Set(["draft", "proposed"]);
+//# sourceMappingURL=constants.js.map

package/dist/spec-authority/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./constants.js";
+export * from "./migration-fidelity.js";
+export * from "./narratives.js";
+export * from "./resolver.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/spec-authority/index.js

@@ -0,0 +1,5 @@
+export * from "./constants.js";
+export * from "./migration-fidelity.js";
+export * from "./narratives.js";
+export * from "./resolver.js";
+//# sourceMappingURL=index.js.map

package/dist/spec-authority/migration-fidelity.d.ts

@@ -0,0 +1,6 @@
+/**
+ * #2005 migration-fidelity: when specification.vbrief.json is absent but a
+ * premigrate snapshot exists, require product narratives to land in PD or scopes.
+ */
+export declare function checkSpecMigrationFidelity(projectRoot: string): string[];
+//# sourceMappingURL=migration-fidelity.d.ts.map

package/dist/spec-authority/migration-fidelity.js

@@ -0,0 +1,96 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { PRODUCT_NARRATIVE_KEYS } from "./constants.js";
+const LIFECYCLE_SCAN = ["proposed", "pending", "active", "completed", "cancelled"];
+function loadJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function planNarrativeKeys(doc) {
+    const keys = new Set();
+    const plan = doc.plan;
+    if (typeof plan !== "object" || plan === null || Array.isArray(plan))
+        return keys;
+    const narratives = plan.narratives;
+    if (typeof narratives !== "object" || narratives === null || Array.isArray(narratives))
+        return keys;
+    for (const [key, val] of Object.entries(narratives)) {
+        if (typeof val === "string" && val.trim())
+            keys.add(key.toLowerCase());
+    }
+    return keys;
+}
+function collectCanonicalNarrativeKeys(vbriefDir) {
+    const keys = new Set();
+    const pdPath = join(vbriefDir, "PROJECT-DEFINITION.vbrief.json");
+    const pd = loadJson(pdPath);
+    if (pd) {
+        for (const k of planNarrativeKeys(pd))
+            keys.add(k);
+    }
+    for (const folder of LIFECYCLE_SCAN) {
+        const dir = join(vbriefDir, folder);
+        if (!existsSync(dir))
+            continue;
+        let names;
+        try {
+            names = readdirSync(dir).filter((n) => n.endsWith(".vbrief.json"));
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            const doc = loadJson(join(dir, name));
+            if (doc) {
+                for (const k of planNarrativeKeys(doc))
+                    keys.add(k);
+            }
+        }
+    }
+    return keys;
+}
+function premigrateNarrativeKeys(vbriefDir) {
+    const keys = new Set();
+    const premigrate = join(vbriefDir, "specification.premigrate.vbrief.json");
+    const doc = loadJson(premigrate);
+    if (!doc)
+        return keys;
+    for (const k of planNarrativeKeys(doc))
+        keys.add(k);
+    return keys;
+}
+function isProductKey(keyLower) {
+    if (keyLower === "overview")
+        return false;
+    return PRODUCT_NARRATIVE_KEYS.some((p) => p.toLowerCase() === keyLower);
+}
+/**
+ * #2005 migration-fidelity: when specification.vbrief.json is absent but a
+ * premigrate snapshot exists, require product narratives to land in PD or scopes.
+ */
+export function checkSpecMigrationFidelity(projectRoot) {
+    const vbriefDir = join(projectRoot, "vbrief");
+    const specPath = join(vbriefDir, "specification.vbrief.json");
+    if (existsSync(specPath))
+        return [];
+    const premigratePath = join(vbriefDir, "specification.premigrate.vbrief.json");
+    if (!existsSync(premigratePath))
+        return [];
+    const premigrateKeys = premigrateNarrativeKeys(vbriefDir);
+    const productPremigrate = [...premigrateKeys].filter(isProductKey);
+    if (productPremigrate.length === 0)
+        return [];
+    const canonicalKeys = collectCanonicalNarrativeKeys(vbriefDir);
+    const missing = productPremigrate.filter((k) => !canonicalKeys.has(k));
+    if (missing.length === 0)
+        return [];
+    return [
+        `vbrief/specification.vbrief.json is absent but vbrief/specification.premigrate.vbrief.json retains product narratives not found in PROJECT-DEFINITION or lifecycle scope vBRIEFs: ${missing.join(", ")}. ` +
+            "Do not delete the legacy spec without migrating content. Run `task migrate:vbrief` or manually merge narratives into PROJECT-DEFINITION / scope vBRIEFs before removing the premigrate snapshot. See #2005.",
+    ];
+}
+//# sourceMappingURL=migration-fidelity.js.map

package/dist/spec-authority/narratives.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedSpecAuthority } from "./resolver.js";
+/** Merge product narratives per Wave 0 locked precedence. */
+export declare function resolveExportNarratives(authority: ResolvedSpecAuthority): Record<string, string>;
+export declare function renderNarrativeSections(narratives: Record<string, string>): string[];
+export declare function greenfieldOverviewNonEmpty(authority: ResolvedSpecAuthority): boolean;
+//# sourceMappingURL=narratives.d.ts.map