@deftai/directive-core 0.59.0 → 0.61.0

package/dist/render/project-render.js

@@ -87,9 +87,57 @@ export function flagStaleNarratives(narratives, completedItems) {
     }
     return flags.sort();
 }
+function isoTimestamp(date) {
+    return date.toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+/** Parse `plan.metadata.staleness_review` when present and well-formed. */
+export function parseStalenessReview(metadata) {
+    if (typeof metadata !== "object" || metadata === null || Array.isArray(metadata)) {
+        return null;
+    }
+    const review = metadata.staleness_review;
+    if (typeof review !== "object" || review === null || Array.isArray(review)) {
+        return null;
+    }
+    const acknowledgedAt = review.acknowledged_at;
+    const scopeIds = review.acknowledged_completed_scope_ids;
+    if (typeof acknowledgedAt !== "string" || acknowledgedAt.length === 0) {
+        return null;
+    }
+    if (!Array.isArray(scopeIds) || !scopeIds.every((id) => typeof id === "string")) {
+        return null;
+    }
+    return {
+        acknowledged_at: acknowledgedAt,
+        acknowledged_completed_scope_ids: [...scopeIds].sort(),
+    };
+}
+/** Completed scopes not yet covered by the acknowledgement watermark. */
+export function unacknowledgedCompletedItems(completedItems, review) {
+    if (!review)
+        return [...completedItems];
+    const acknowledged = new Set(review.acknowledged_completed_scope_ids);
+    return completedItems.filter((item) => !acknowledged.has(item.id));
+}
+/** Build acknowledgement metadata for the current completed-scope set. */
+export function buildStalenessAcknowledgement(completedItems, options = {}) {
+    const now = isoTimestamp(options.now ?? new Date());
+    const mergedIds = new Set([
+        ...(options.existing?.acknowledged_completed_scope_ids ?? []),
+        ...completedItems.map((item) => item.id),
+    ]);
+    return {
+        acknowledged_at: now,
+        acknowledged_completed_scope_ids: [...mergedIds].sort(),
+    };
+}
+export function computeStalenessFlags(narratives, completedItems, review = null) {
+    const pending = unacknowledgedCompletedItems(completedItems, review);
+    return flagStaleNarratives(narratives, pending);
+}
 export function createSkeleton(items, now) {
     const completedItems = items.filter((i) => i.status === "completed");
-    const stalenessFlags = flagStaleNarratives({ ...SKELETON_NARRATIVES }, completedItems);
+    const stalenessFlags = computeStalenessFlags({ ...SKELETON_NARRATIVES }, completedItems);
     return {
         vBRIEFInfo: {
             version: EMITTED_VBRIEF_VERSION,
@@ -133,13 +181,15 @@ export function renderProjectDefinition(vbriefDir, options = {}) {
             ? plan.narratives
             : {};
         const completedItems = items.filter((i) => i.status === "completed");
-        const flags = flagStaleNarratives(narratives, completedItems);
         if (typeof plan.metadata !== "object" ||
             plan.metadata === null ||
             Array.isArray(plan.metadata)) {
             plan.metadata = {};
         }
-        plan.metadata.staleness_flags = flags;
+        const planMetadata = plan.metadata;
+        const review = parseStalenessReview(planMetadata);
+        const flags = computeStalenessFlags(narratives, completedItems, review);
+        planMetadata.staleness_flags = flags;
         projectDef.plan = plan;
     }
     else {
@@ -156,14 +206,68 @@ export function renderProjectDefinition(vbriefDir, options = {}) {
         parts.push(`⚠ ${flagCount} staleness flag(s) -- agent review recommended`);
     return [true, parts.join("\n")];
 }
+/**
+ * Mark current completed scopes as reviewed for PROJECT-DEFINITION narratives.
+ *
+ * Distinct from `task reconcile:issues`, which reconciles origin freshness on scope
+ * vBRIEFs — this path only clears narrative staleness heuristics on render.
+ */
+export function acknowledgeProjectDefinitionStaleness(vbriefDir, options = {}) {
+    const nowDate = options.now ?? new Date();
+    const now = isoTimestamp(nowDate);
+    const projectDefPath = join(vbriefDir, "PROJECT-DEFINITION.vbrief.json");
+    if (!existsSync(projectDefPath)) {
+        return [false, `✗ ${projectDefPath} not found — run project:render first`];
+    }
+    let projectDef;
+    try {
+        projectDef = JSON.parse(readFileSync(projectDefPath, "utf8"));
+    }
+    catch (exc) {
+        return [false, `✗ Failed to read ${projectDefPath}: ${String(exc)}`];
+    }
+    const plan = (projectDef.plan ?? {});
+    if (typeof plan.metadata !== "object" || plan.metadata === null || Array.isArray(plan.metadata)) {
+        plan.metadata = {};
+    }
+    const planMetadata = plan.metadata;
+    const items = scanLifecycleFolders(vbriefDir);
+    const completedItems = items.filter((i) => i.status === "completed");
+    const existing = parseStalenessReview(planMetadata);
+    planMetadata.staleness_review = buildStalenessAcknowledgement(completedItems, {
+        now: nowDate,
+        existing,
+    });
+    const narratives = typeof plan.narratives === "object" &&
+        plan.narratives !== null &&
+        !Array.isArray(plan.narratives)
+        ? plan.narratives
+        : {};
+    planMetadata.staleness_flags = computeStalenessFlags(narratives, completedItems, parseStalenessReview(planMetadata));
+    if (typeof projectDef.vBRIEFInfo !== "object" || projectDef.vBRIEFInfo === null) {
+        projectDef.vBRIEFInfo = {};
+    }
+    projectDef.vBRIEFInfo.updated = now;
+    projectDef.plan = plan;
+    writeFileSync(projectDefPath, `${JSON.stringify(projectDef, null, 2)}\n`, "utf8");
+    const ackCount = completedItems.length;
+    return [
+        true,
+        `✓ PROJECT-DEFINITION staleness acknowledged (${ackCount} completed scope(s) watermarked)`,
+    ];
+}
 /** CLI entry (mirrors ``scripts/project_render.main``). */
 export function main(argv) {
-    if (argv.length > 1) {
-        process.stderr.write("Usage: project_render.py [vbrief_dir]\n");
+    const acknowledge = argv[0] === "--acknowledge-staleness";
+    const rest = acknowledge ? argv.slice(1) : argv;
+    if (rest.length > 1) {
+        process.stderr.write("Usage: project_render.py [--acknowledge-staleness] [vbrief_dir]\n");
         return 2;
     }
-    const vbriefDir = argv[0] ?? "vbrief";
-    const [ok, message] = renderProjectDefinition(vbriefDir);
+    const vbriefDir = rest[0] ?? "vbrief";
+    const [ok, message] = acknowledge
+        ? acknowledgeProjectDefinitionStaleness(vbriefDir)
+        : renderProjectDefinition(vbriefDir);
     process.stdout.write(`${message}\n`);
     return ok ? 0 : 1;
 }

package/dist/render/scope-outlook.d.ts

@@ -0,0 +1,9 @@
+export interface ScopeOutlookOptions {
+    readonly includeProposed?: boolean;
+    readonly proposedLimit?: number;
+}
+/** Build Scope outlook section per #2013 Wave 0 §4. */
+export declare function buildScopeOutlookSection(vbriefDir: string, options?: ScopeOutlookOptions): string[];
+/** Legacy wrapper: stakeholder export (no proposed). */
+export declare function aggregateScopeSection(vbriefDir: string): string[];
+//# sourceMappingURL=scope-outlook.d.ts.map

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