openxiangda-devkit-core 2.0.0-alpha.66 → 2.0.0-alpha.67

package/dist/app-spec.js

@@ -7,12 +7,13 @@ export const APP_SPEC_SCHEMAS = {
     capability: "openxiangda.appspec/capability/v1",
     change: "openxiangda.appspec/change/v1",
     decision: "openxiangda.appspec/decision/v1",
-    context: "openxiangda.appspec/context/v1",
+    context: "openxiangda.appspec/context/v2",
 };
 export const APP_SPEC_LIMITS = {
     maximumFiles: 128,
     maximumFileBytes: 256 * 1024,
     maximumTotalBytes: 2 * 1024 * 1024,
+    maximumContextBytes: 256 * 1024,
     maximumDirectoryEntries: 256,
     maximumHistoryDepth: 1,
 };
@@ -126,13 +127,61 @@ export function closeAppSpecChange(input) {
     }
     mkdirSync(historyDirectory, { recursive: true });
     const sourceContent = readFileSync(source, "utf8");
-    const document = parseAppSpecDocument(input.root, source, "change", sourceContent, []);
+    const effectiveContent = input.currentSpec
+        ? setFrontMatterValue(sourceContent, "currentSpec", input.currentSpec)
+        : sourceContent;
+    const diagnostics = [];
+    const document = parseAppSpecDocument(input.root, source, "change", effectiveContent, diagnostics);
     if (!document || document.id !== input.id) {
         throw stableError("APPSPEC_ACTIVE_CHANGE_INVALID", input.id);
     }
+    const collectionDiagnostics = [];
+    const collection = collectDocuments(input.root, collectionDiagnostics);
+    const sourcePointer = relativePath(input.root, source);
+    const relatedPaths = new Set([sourcePointer]);
+    for (const capability of collection.capabilities) {
+        if (document.references.capabilities.includes(capability.id) ||
+            capability.requirementIds.some(id => [...document.references.requirements, ...document.requirementIds].includes(id)) ||
+            capability.acceptanceIds.some(id => document.acceptanceIds.includes(id))) {
+            relatedPaths.add(capability.path);
+        }
+    }
+    for (const decision of collection.decisions) {
+        if (document.references.decisions.includes(decision.id)) {
+            relatedPaths.add(decision.path);
+        }
+    }
+    const collectionFatalCodes = new Set([
+        "APPSPEC_FILE_LIMIT_EXCEEDED",
+        "APPSPEC_FILE_UNREADABLE",
+        "APPSPEC_FILE_INVALID",
+        "APPSPEC_FILE_SIZE_EXCEEDED",
+        "APPSPEC_TOTAL_SIZE_EXCEEDED",
+        "APPSPEC_DIRECTORY_INVALID",
+        "APPSPEC_DIRECTORY_ENTRY_LIMIT_EXCEEDED",
+        "APPSPEC_SYMLINK_FORBIDDEN",
+        "APPSPEC_HISTORY_DEPTH_EXCEEDED",
+    ]);
+    diagnostics.push(...collectionDiagnostics.filter(item => item.severity === "error" &&
+        item.path !== sourcePointer &&
+        (collectionFatalCodes.has(item.code) ||
+            (item.path !== undefined && relatedPaths.has(item.path)))));
+    validateCloseConvergence(document, collection, input.contract, diagnostics);
+    if (diagnostics.some(item => item.severity === "error")) {
+        return {
+            schemaVersion: APP_SPEC_SCHEMAS.context,
+            enabled: true,
+            advisory: true,
+            releaseGate: false,
+            archived: null,
+            status: document.status,
+            converged: false,
+            diagnostics,
+        };
+    }
     renameSync(source, target);
     const closedAt = new Date().toISOString();
-    const updated = appendClosure(setFrontMatterValue(setFrontMatterValue(sourceContent, "status", "archived"), "closedAt", closedAt), input.summary?.trim() || "变更记录已归档；验收与发布结果以实际证据为准。", closedAt);
+    const updated = appendClosure(setFrontMatterValue(setFrontMatterValue(effectiveContent, "status", "archived"), "closedAt", closedAt), input.summary?.trim() || "变更记录已归档；验收与发布结果以实际证据为准。", closedAt);
     atomicReplace(target, updated);
     return {
         schemaVersion: APP_SPEC_SCHEMAS.context,
@@ -141,6 +190,8 @@ export function closeAppSpecChange(input) {
         releaseGate: false,
         archived: relativePath(input.root, target),
         status: "archived",
+        converged: true,
+        diagnostics,
     };
 }
 export function inspectAppSpec(root, contract, selector) {
@@ -163,18 +214,16 @@ export function inspectAppSpec(root, contract, selector) {
         ...collection.history,
         ...collection.decisions,
     ];
-    const digest = allDocuments.length === 0
+    const index = summarizeCollection(collection);
+    const workspaceDigest = digestDocuments(allDocuments, contract);
+    const selectionDocuments = selectedDocuments(application, selected);
+    const selectionDigest = allDocuments.length === 0
         ? null
-        : createHash("sha256")
-            .update([
-            ...allDocuments
-                .sort((left, right) => left.path.localeCompare(right.path))
-                .map(document => `${document.path}\n${document.content}`),
-            contract.configDigest || "",
-            contract.contractDigest || "",
-            contract.aiCatalogDigest || "",
-        ].join("\n---\n"))
-            .digest("hex");
+        : digestDocuments(selectionDocuments, contract, selector ? [`selector:${selector}`] : [`index:${JSON.stringify(index)}`]);
+    const budgeted = applyContextBudget(application, selected);
+    if (budgeted.contextBudget.truncated) {
+        diagnostics.push(issue("warning", "APPSPEC_CONTEXT_BUDGET_EXCEEDED", `相关 AppSpec 正文超过 ${APP_SPEC_LIMITS.maximumContextBytes} 字节预算；已省略 ${budgeted.contextBudget.omitted.length} 份低优先级文档，可按稳定 ID 单独读取`, "appspec"));
+    }
     return {
         schemaVersion: APP_SPEC_SCHEMAS.context,
         enabled: true,
@@ -183,11 +232,13 @@ export function inspectAppSpec(root, contract, selector) {
         root: "appspec",
         selector: selector || null,
         contract,
-        application,
-        capabilities: selected.capabilities,
-        activeChanges: selected.activeChanges,
-        decisions: selected.decisions,
-        history: collection.history.map(summarize),
+        index,
+        application: budgeted.application,
+        capabilities: budgeted.capabilities,
+        activeChanges: budgeted.activeChanges,
+        archivedChanges: budgeted.archivedChanges,
+        decisions: budgeted.decisions,
+        contextBudget: budgeted.contextBudget,
         stats: {
             files: allDocuments.length,
             bytes: collection.bytes,
@@ -198,7 +249,8 @@ export function inspectAppSpec(root, contract, selector) {
             requirements: unique(collection.capabilities.flatMap(document => document.requirementIds)).length,
             acceptanceScenarios: unique(collection.capabilities.flatMap(document => document.acceptanceIds)).length,
         },
-        digest,
+        workspaceDigest,
+        selectionDigest,
         diagnostics,
     };
 }
@@ -215,7 +267,9 @@ export function summarizeAppSpecContext(context) {
         enabled: context.enabled,
         mode: context.mode,
         releaseGate: context.releaseGate,
-        digest: context.digest,
+        workspaceDigest: context.workspaceDigest,
+        selectionDigest: context.selectionDigest,
+        contextBudget: context.contextBudget,
         stats: context.stats,
         diagnostics: {
             errors: context.diagnostics.filter(item => item.severity === "error").length,
@@ -236,11 +290,24 @@ function emptyContext(contract, selector, diagnostics = [], enabled = false) {
         root: "appspec",
         selector: selector || null,
         contract,
+        index: {
+            application: null,
+            capabilities: [],
+            activeChanges: [],
+            decisions: [],
+            history: [],
+        },
         application: null,
         capabilities: [],
         activeChanges: [],
+        archivedChanges: [],
         decisions: [],
-        history: [],
+        contextBudget: {
+            maximumBytes: APP_SPEC_LIMITS.maximumContextBytes,
+            contentBytes: 0,
+            truncated: false,
+            omitted: [],
+        },
         stats: {
             files: 0,
             bytes: 0,
@@ -251,7 +318,8 @@ function emptyContext(contract, selector, diagnostics = [], enabled = false) {
             requirements: 0,
             acceptanceScenarios: 0,
         },
-        digest: null,
+        workspaceDigest: null,
+        selectionDigest: null,
         diagnostics,
     };
 }
@@ -348,6 +416,7 @@ function validateDocuments(collection, contract, diagnostics) {
     duplicateDiagnostics(collection.capabilities.flatMap(document => document.acceptanceIds.map(id => ({ ...document, id }))), document => document.id, "APPSPEC_ACCEPTANCE_ID_DUPLICATED", diagnostics);
     const capabilityIds = new Set(collection.capabilities.map(document => document.id));
     const requirementIds = new Set(collection.capabilities.flatMap(document => document.requirementIds));
+    const acceptanceIds = new Set(collection.capabilities.flatMap(document => document.acceptanceIds));
     const resourceCodes = new Set(contract.resourceCodes);
     const actionCodes = new Set(contract.actionCodes);
     const decisionIds = new Set(collection.decisions.map(document => document.id));
@@ -376,7 +445,12 @@ function validateDocuments(collection, contract, diagnostics) {
             }
         }
         validateReferences(document, resourceCodes, actionCodes, referenceSeverity, diagnostics);
+        validateEmbeddedCurrentSpecIds(document, requirementIds, acceptanceIds, diagnostics);
         validateRiskSections(document, diagnostics);
+        if (finalState &&
+            currentSpecStatus(document) === "pending") {
+            diagnostics.push(issue("error", "APPSPEC_CURRENT_SPEC_NOT_CONVERGED", "verified/released ChangeSpec 必须确认 currentSpec=merged 或 not-applicable", document.path));
+        }
         if (finalState && unresolvedQuestions(document.content).length > 0) {
             diagnostics.push(issue("error", "APPSPEC_VERIFIED_CHANGE_HAS_OPEN_QUESTIONS", "verified/released ChangeSpec 仍有未勾选问题", document.path));
         }
@@ -385,6 +459,70 @@ function validateDocuments(collection, contract, diagnostics) {
         diagnostics.push(issue("warning", "APPSPEC_ACTIVE_CHANGE_COUNT_HIGH", `当前有 ${collection.activeChanges.length} 个活跃变更；建议关闭已完成记录，避免 AI 上下文膨胀`, "appspec/changes/active"));
     }
 }
+function validateCloseConvergence(document, collection, contract, diagnostics) {
+    const currentSpec = currentSpecStatus(document);
+    if (currentSpec === "pending") {
+        diagnostics.push(issue("error", "APPSPEC_CURRENT_SPEC_NOT_CONVERGED", "关闭前必须确认 currentSpec=merged 或 not-applicable；该检查只约束 spec close", document.path));
+    }
+    const capabilityIds = new Set(collection.capabilities.map(item => item.id));
+    const requirementIds = new Set(collection.capabilities.flatMap(item => item.requirementIds));
+    const acceptanceIds = new Set(collection.capabilities.flatMap(item => item.acceptanceIds));
+    const decisionIds = new Set(collection.decisions.map(item => item.id));
+    for (const id of document.references.capabilities) {
+        const matches = collection.capabilities.filter(item => item.id === id);
+        if (!capabilityIds.has(id)) {
+            diagnostics.push(issue("error", "APPSPEC_CHANGE_CAPABILITY_UNKNOWN", `关闭前必须建立当前能力引用 ${id}`, document.path));
+        }
+        else if (matches.length > 1) {
+            diagnostics.push(issue("error", "APPSPEC_DOCUMENT_ID_DUPLICATED", `关闭前必须消除能力 ${id} 的重复定义`, document.path));
+        }
+    }
+    for (const id of document.references.requirements) {
+        const matches = collection.capabilities.filter(item => item.requirementIds.includes(id));
+        if (!requirementIds.has(id)) {
+            diagnostics.push(issue("error", "APPSPEC_CHANGE_REQUIREMENT_UNKNOWN", `关闭前必须把需求 ${id} 合入当前 CapabilitySpec`, document.path));
+        }
+        else if (matches.length > 1) {
+            diagnostics.push(issue("error", "APPSPEC_REQUIREMENT_ID_DUPLICATED", `关闭前必须消除需求 ${id} 的重复定义`, document.path));
+        }
+    }
+    for (const id of document.references.decisions) {
+        const matches = collection.decisions.filter(item => item.id === id);
+        if (!decisionIds.has(id)) {
+            diagnostics.push(issue("error", "APPSPEC_CHANGE_DECISION_UNKNOWN", `关闭前必须建立架构决策 ${id}`, document.path));
+        }
+        else if (matches.length > 1) {
+            diagnostics.push(issue("error", "APPSPEC_DOCUMENT_ID_DUPLICATED", `关闭前必须消除决策 ${id} 的重复定义`, document.path));
+        }
+    }
+    for (const id of document.requirementIds) {
+        const matches = collection.capabilities.filter(item => item.requirementIds.includes(id));
+        if (matches.length > 1) {
+            diagnostics.push(issue("error", "APPSPEC_REQUIREMENT_ID_DUPLICATED", `关闭前必须消除需求 ${id} 的重复定义`, document.path));
+        }
+    }
+    for (const id of document.acceptanceIds) {
+        const matches = collection.capabilities.filter(item => item.acceptanceIds.includes(id));
+        if (matches.length > 1) {
+            diagnostics.push(issue("error", "APPSPEC_ACCEPTANCE_ID_DUPLICATED", `关闭前必须消除验收场景 ${id} 的重复定义`, document.path));
+        }
+    }
+    validateEmbeddedCurrentSpecIds(document, requirementIds, acceptanceIds, diagnostics);
+    validateReferences(document, new Set(contract.resourceCodes), new Set(contract.actionCodes), "error", diagnostics);
+    validateRiskSections(document, diagnostics);
+}
+function validateEmbeddedCurrentSpecIds(document, currentRequirementIds, currentAcceptanceIds, diagnostics) {
+    for (const id of document.requirementIds) {
+        if (!currentRequirementIds.has(id)) {
+            diagnostics.push(issue("error", "APPSPEC_CHANGE_REQUIREMENT_NOT_CURRENT", `ChangeSpec 中的长期需求 ${id} 尚未进入当前 CapabilitySpec`, document.path));
+        }
+    }
+    for (const id of document.acceptanceIds) {
+        if (!currentAcceptanceIds.has(id)) {
+            diagnostics.push(issue("error", "APPSPEC_CHANGE_ACCEPTANCE_NOT_CURRENT", `ChangeSpec 中的验收场景 ${id} 尚未进入当前 CapabilitySpec`, document.path));
+        }
+    }
+}
 function validateReferences(document, resourceCodes, actionCodes, severity, diagnostics) {
     for (const code of document.references.resources) {
         if (!resourceCodes.has(code)) {
@@ -406,25 +544,45 @@ function validateRiskSections(document, diagnostics) {
     if (risk === "L1")
         return;
     const required = [
-        ["验收", "Acceptance"],
-        ["数据与权限", "Data and Permissions"],
-        ["回滚", "Rollback"],
+        {
+            titles: ["验收", "Acceptance"],
+            placeholders: [
+                "一个可观察的正向结果",
+                "需要时补充拒绝、异常或权限反例",
+            ],
+        },
+        {
+            titles: ["数据与权限", "Data and Permissions"],
+            placeholders: ["无，或说明资源、字段、角色和数据范围变化。"],
+        },
+        {
+            titles: ["回滚", "Rollback"],
+            placeholders: ["回退声明/代码并保持旧数据可读；如不适用请说明。"],
+        },
     ];
     if (risk === "L3") {
-        required.push(["失败、并发与幂等", "Failure, Concurrency, and Idempotency"], ["架构决策", "Decision Records"]);
+        required.push({
+            titles: ["失败、并发与幂等", "Failure, Concurrency, and Idempotency"],
+            placeholders: ["L3 才需要详细维护；其他变化写“无”。"],
+        }, {
+            titles: ["架构决策", "Decision Records"],
+            placeholders: ["L3 如涉及 ADR，在 front matter 的 decisions 中引用。"],
+        });
     }
-    for (const alternatives of required) {
-        if (!hasSection(document.content, alternatives)) {
-            diagnostics.push(issue("warning", "APPSPEC_RISK_SECTION_RECOMMENDED", `${risk} ChangeSpec 建议补充“${alternatives[0]}”`, document.path));
+    for (const section of required) {
+        if (!hasMeaningfulSection(document.content, section.titles, section.placeholders)) {
+            diagnostics.push(issue("error", "APPSPEC_RISK_SECTION_INCOMPLETE", `${risk} ChangeSpec 的“${section.titles[0]}”为空或仍是默认占位内容`, document.path));
         }
     }
 }
 function selectContext(collection, selector, diagnostics) {
     if (!selector) {
         return {
-            capabilities: collection.capabilities,
-            activeChanges: collection.activeChanges,
-            decisions: collection.decisions,
+            primary: collection.app[0] || null,
+            capabilities: [],
+            activeChanges: [],
+            archivedChanges: [],
+            decisions: [],
         };
     }
     const change = collection.activeChanges.find(document => document.id === selector);
@@ -432,21 +590,133 @@ function selectContext(collection, selector, diagnostics) {
         const capabilityIds = new Set(change.references.capabilities);
         const decisionIds = new Set(change.references.decisions);
         return {
+            primary: change,
             capabilities: collection.capabilities.filter(document => capabilityIds.has(document.id)),
             activeChanges: [change],
+            archivedChanges: [],
+            decisions: collection.decisions.filter(document => decisionIds.has(document.id)),
+        };
+    }
+    const archivedChange = collection.history.find(document => document.id === selector);
+    if (archivedChange) {
+        const capabilityIds = new Set(archivedChange.references.capabilities);
+        const decisionIds = new Set(archivedChange.references.decisions);
+        return {
+            primary: archivedChange,
+            capabilities: collection.capabilities.filter(document => capabilityIds.has(document.id)),
+            activeChanges: [],
+            archivedChanges: [archivedChange],
             decisions: collection.decisions.filter(document => decisionIds.has(document.id)),
         };
     }
     const capability = collection.capabilities.find(document => document.id === selector);
     if (capability) {
+        const activeChanges = collection.activeChanges.filter(document => document.references.capabilities.includes(capability.id));
+        const decisionIds = new Set(activeChanges.flatMap(document => document.references.decisions));
         return {
+            primary: capability,
             capabilities: [capability],
-            activeChanges: collection.activeChanges.filter(document => document.references.capabilities.includes(capability.id)),
-            decisions: collection.decisions,
+            activeChanges,
+            archivedChanges: [],
+            decisions: collection.decisions.filter(document => decisionIds.has(document.id)),
+        };
+    }
+    const decision = collection.decisions.find(document => document.id === selector);
+    if (decision) {
+        return {
+            primary: decision,
+            capabilities: [],
+            activeChanges: [],
+            archivedChanges: [],
+            decisions: [decision],
         };
     }
     diagnostics.push(issue("warning", "APPSPEC_SELECTOR_NOT_FOUND", `未找到 AppSpec selector ${selector}，已返回应用总纲和空的相关上下文`, "appspec"));
-    return { capabilities: [], activeChanges: [], decisions: [] };
+    return {
+        primary: null,
+        capabilities: [],
+        activeChanges: [],
+        archivedChanges: [],
+        decisions: [],
+    };
+}
+function summarizeCollection(collection) {
+    return {
+        application: collection.app[0] ? summarize(collection.app[0]) : null,
+        capabilities: collection.capabilities.map(summarize),
+        activeChanges: collection.activeChanges.map(summarize),
+        decisions: collection.decisions.map(summarize),
+        history: collection.history.map(summarize),
+    };
+}
+function selectedDocuments(application, selected) {
+    return uniqueDocuments([
+        selected.primary,
+        application,
+        ...selected.capabilities,
+        ...selected.activeChanges,
+        ...selected.archivedChanges,
+        ...selected.decisions,
+    ]);
+}
+function applyContextBudget(application, selected) {
+    const prioritized = selectedDocuments(application, selected);
+    const included = new Set();
+    const omitted = [];
+    let contentBytes = 0;
+    for (const document of prioritized) {
+        const bytes = Buffer.byteLength(document.content, "utf8");
+        if (contentBytes + bytes > APP_SPEC_LIMITS.maximumContextBytes) {
+            omitted.push(document);
+            continue;
+        }
+        included.add(document.path);
+        contentBytes += bytes;
+    }
+    const keep = (documents) => documents.filter(document => included.has(document.path));
+    return {
+        application: application && included.has(application.path) ? application : null,
+        capabilities: keep(selected.capabilities),
+        activeChanges: keep(selected.activeChanges),
+        archivedChanges: keep(selected.archivedChanges),
+        decisions: keep(selected.decisions),
+        contextBudget: {
+            maximumBytes: APP_SPEC_LIMITS.maximumContextBytes,
+            contentBytes,
+            truncated: omitted.length > 0,
+            omitted: omitted.map(summarize),
+        },
+    };
+}
+function uniqueDocuments(documents) {
+    const paths = new Set();
+    return documents.filter((document) => {
+        if (!document || paths.has(document.path))
+            return false;
+        paths.add(document.path);
+        return true;
+    });
+}
+function digestDocuments(documents, contract, extra = []) {
+    if (documents.length === 0 && extra.length === 0)
+        return null;
+    const contractIdentity = {
+        appCode: contract.appCode,
+        resourceCodes: unique(contract.resourceCodes),
+        actionCodes: unique(contract.actionCodes),
+        configDigest: contract.configDigest || null,
+        contractDigest: contract.contractDigest || null,
+        aiCatalogDigest: contract.aiCatalogDigest || null,
+    };
+    return createHash("sha256")
+        .update([
+        ...[...documents]
+            .sort((left, right) => left.path.localeCompare(right.path))
+            .map(document => `${document.path}\n${document.content}`),
+        ...extra,
+        `contract:${JSON.stringify(contractIdentity)}`,
+    ].join("\n---\n"))
+        .digest("hex");
 }
 function parseAppSpecDocument(root, path, kind, content, diagnostics) {
     const pointer = relativePath(root, path);
@@ -479,6 +749,12 @@ function parseAppSpecDocument(root, path, kind, content, diagnostics) {
     if (!validStatuses[kind].includes(status)) {
         diagnostics.push(issue("error", "APPSPEC_STATUS_INVALID", `${kind} status=${status} 不受支持`, pointer));
     }
+    if (kind === "change") {
+        const currentSpec = String(frontMatter.metadata.currentSpec || "pending");
+        if (!["pending", "merged", "not-applicable"].includes(currentSpec)) {
+            diagnostics.push(issue("error", "APPSPEC_CURRENT_SPEC_STATUS_INVALID", `change currentSpec=${currentSpec} 不受支持`, pointer));
+        }
+    }
     const h1 = content.match(/^#\s+(.+)$/m)?.[1]?.trim() || "";
     const title = String(frontMatter.metadata.title || h1 || id);
     const requirementIds = extractIds(content, /^###\s+(REQ-[A-Z0-9-]+)\b/gm, REQUIREMENT_ID);
@@ -610,8 +886,31 @@ function unresolvedQuestions(content) {
     const section = nextHeading >= 0 ? tail.slice(0, nextHeading) : tail;
     return section ? [...section.matchAll(/^- \[ \]\s+(.+)$/gm)].map(match => match[1]) : [];
 }
-function hasSection(content, alternatives) {
-    return alternatives.some(title => new RegExp(`^##\\s+${escapeRegExp(title)}\\s*$`, "m").test(content));
+function hasMeaningfulSection(content, alternatives, placeholders) {
+    const source = withoutHtmlComments(content);
+    for (const title of alternatives) {
+        const heading = new RegExp(`^##\\s+${escapeRegExp(title)}\\s*$`, "m").exec(source);
+        if (heading?.index === undefined)
+            continue;
+        const tail = source.slice(heading.index + heading[0].length);
+        const nextHeading = tail.search(/^##\s+/m);
+        const body = nextHeading >= 0 ? tail.slice(0, nextHeading) : tail;
+        const meaningfulLines = body
+            .split(/\r?\n/)
+            .map(line => line.trim())
+            .filter(Boolean)
+            .filter(line => !/^[-*](?:\s+\[[ xX]\])?\s*$/.test(line))
+            .filter(line => !placeholders.some(placeholder => line.includes(placeholder)));
+        if (meaningfulLines.length > 0)
+            return true;
+    }
+    return false;
+}
+function currentSpecStatus(document) {
+    const value = String(document.metadata.currentSpec || "pending");
+    return ["merged", "not-applicable"].includes(value)
+        ? value
+        : "pending";
 }
 function duplicateDiagnostics(values, id, code, diagnostics) {
     const seen = new Map();
@@ -758,6 +1057,7 @@ schema: ${APP_SPEC_SCHEMAS.change}
 id: ${input.id}
 title: ${JSON.stringify(input.title)}
 status: draft
+currentSpec: pending
 risk: ${input.risk}
 createdAt: ${JSON.stringify(createdAt)}
 capabilities: ${JSON.stringify(input.capabilities)}
@@ -881,8 +1181,11 @@ function summarize(document) {
         title: document.title,
         status: document.status,
         path: document.path,
-        requirementIds: document.requirementIds,
-        acceptanceIds: document.acceptanceIds,
+        risk: document.kind === "change" && ["L1", "L2", "L3"].includes(String(document.metadata.risk))
+            ? String(document.metadata.risk)
+            : null,
+        requirementCount: document.requirementIds.length,
+        acceptanceScenarioCount: document.acceptanceIds.length,
     };
 }
 function extractIds(content, pattern, validation) {
@@ -909,6 +1212,7 @@ function validateMetadata(kind, metadata, pointer, diagnostics) {
             "id",
             "title",
             "status",
+            "currentSpec",
             "risk",
             "createdAt",
             "closedAt",