soloforge 1.3.1 → 1.3.2

package/dist/engine/standard_asset_coverage.js

@@ -0,0 +1,220 @@
+/**
+ * 标准资产覆盖机制 — 审计 templates/** 全类型资产的覆盖完整性。
+ *
+ * 问题六十二要求: has_revalidation_path 和 has_main_path_consumer
+ * 必须来自真实生产消费链路证据，不得写死 true 或根据目录推导。
+ */
+import fs from "node:fs";
+import path from "node:path";
+// ── 资产类型期望的承载、消费者和复验入口 ──
+const KIND_EXPECTATIONS = {
+    rule: {
+        bearer_patterns: ["templates/knowledge/rules/"],
+        expected_consumers: ["sf_expand", "intent_expander", "knowledge_index"],
+        expected_revalidation: ["template_mechanism_auditor", "validate-release"],
+    },
+    procedure: {
+        bearer_patterns: ["templates/knowledge/procedures/"],
+        expected_consumers: ["sf_expand", "sf_verify", "intent_expander"],
+        expected_revalidation: ["template_mechanism_auditor", "validate-release"],
+    },
+    checklist: {
+        bearer_patterns: ["templates/knowledge/checklists/"],
+        expected_consumers: ["sf_verify", "sf_deliver"],
+        expected_revalidation: ["sf_verify", "validate-release"],
+    },
+    review_rule: {
+        bearer_patterns: ["templates/knowledge/review_rules/"],
+        expected_consumers: ["sf_review", "code_reviewer"],
+        expected_revalidation: ["template_mechanism_auditor", "validate-release"],
+    },
+    pattern: {
+        bearer_patterns: ["templates/knowledge/patterns/", "templates/patterns/"],
+        expected_consumers: ["sf_expand", "intent_expander", "knowledge_index"],
+        expected_revalidation: ["template_mechanism_auditor", "validate-release"],
+    },
+    scaffold: {
+        bearer_patterns: ["templates/scaffolds/"],
+        expected_consumers: ["sf_scaffold", "scaffolder"],
+        expected_revalidation: ["validate-release"],
+    },
+    adapter_workflow: {
+        bearer_patterns: ["src/adapters/shared/workflow_template.ts"],
+        expected_consumers: ["claude_code_adapter", "codex_adapter", "trae_adapter"],
+        expected_revalidation: ["validate-release", "template_mechanism_auditor"],
+    },
+    domain: {
+        bearer_patterns: ["templates/knowledge/domain/"],
+        expected_consumers: ["sf_expand", "intent_expander"],
+        expected_revalidation: ["template_mechanism_auditor"],
+    },
+    product_profile: {
+        bearer_patterns: ["templates/knowledge/product_profiles/"],
+        expected_consumers: ["sf_expand", "sf_verify"],
+        expected_revalidation: ["template_mechanism_auditor"],
+    },
+    acceptance_template: {
+        bearer_patterns: ["templates/knowledge/acceptance_templates/", "templates/knowledge/templates/"],
+        expected_consumers: ["sf_verify", "sf_deliver", "intent_expander", "code_reviewer"],
+        expected_revalidation: ["sf_verify", "validate-release", "template_mechanism_auditor"],
+    },
+    knowledge_template: {
+        bearer_patterns: ["templates/knowledge/templates/"],
+        expected_consumers: ["sf_expand", "sf_verify"],
+        expected_revalidation: ["template_mechanism_auditor"],
+    },
+};
+/**
+ * 审计标准资产覆盖 — 使用真实注册表证据。
+ *
+ * @param rootDir 项目根目录
+ * @param consumableAssetPaths consumable_asset_registry 中已注册的资产路径集合
+ * @param mechanismOwners consumable_asset_registry 中资产路径 → owner_mechanism_id 映射
+ * @param assetConsumers asset_manifest 中资产路径 → 主链路消费者列表映射
+ * @param assetVisibility asset_manifest 中资产路径 → 可见性映射
+ */
+export function auditStandardAssetCoverage(rootDir, consumableAssetPaths, mechanismOwners, assetConsumers, assetVisibility) {
+    const entries = [];
+    let coveredCount = 0;
+    let uncoveredCount = 0;
+    let missingBearer = 0;
+    let missingRevalidation = 0;
+    let missingConsumer = 0;
+    let missingOwner = 0;
+    let unregisteredAssets = 0;
+    let unknownVisibility = 0;
+    let visibilityConflicts = 0;
+    // 扫描 templates 目录
+    const templateDirs = [
+        { dir: "templates/knowledge/acceptance_templates", kind: "acceptance_template" },
+        { dir: "templates/knowledge/rules", kind: "rule" },
+        { dir: "templates/knowledge/procedures", kind: "procedure" },
+        { dir: "templates/knowledge/checklists", kind: "checklist" },
+        { dir: "templates/knowledge/review_rules", kind: "review_rule" },
+        { dir: "templates/knowledge/patterns/core", kind: "pattern" },
+        { dir: "templates/patterns", kind: "pattern" },
+        { dir: "templates/scaffolds", kind: "scaffold" },
+        { dir: "templates/knowledge/domain", kind: "domain" },
+        { dir: "templates/knowledge/product_profiles", kind: "product_profile" },
+        { dir: "templates/knowledge/templates", kind: "acceptance_template" },
+    ];
+    for (const { dir, kind } of templateDirs) {
+        const absDir = path.join(rootDir, dir);
+        if (!fs.existsSync(absDir))
+            continue;
+        const files = walkDir(absDir);
+        for (const filePath of files) {
+            const relPath = path.relative(rootDir, filePath).replace(/\\/g, "/");
+            const gaps = [];
+            const expectation = KIND_EXPECTATIONS[kind];
+            // 检查标准承载（真实路径匹配）
+            const hasBearer = expectation.bearer_patterns.some((p) => relPath.includes(p));
+            if (!hasBearer)
+                gaps.push("缺少标准承载路径");
+            // 检查注册表（真实注册证据）
+            const isRegistered = consumableAssetPaths.has(relPath);
+            if (!isRegistered) {
+                gaps.push("未在 Consumable Asset Registry 中注册");
+                unregisteredAssets++;
+            }
+            // 检查 owner mechanism（真实 owner 证据）
+            const owner = mechanismOwners.get(relPath) ?? "";
+            if (!owner) {
+                gaps.push("缺少 owner_mechanism_id");
+                missingOwner++;
+            }
+            // 检查主链路消费者（真实消费者证据，从入参获取）
+            const consumers = assetConsumers.get(relPath) ?? [];
+            const hasMainConsumer = consumers.length > 0 && consumers.some((c) => c.length > 0);
+            if (!hasMainConsumer) {
+                gaps.push(`无主链路消费者（期望: ${expectation.expected_consumers.join(" 或 ")}）`);
+                missingConsumer++;
+            }
+            // 检查复验入口（真实复验证据 — 从消费者列表中识别复验角色）
+            const revalidationConsumers = consumers.filter((c) => c === "template_mechanism_auditor" || c === "validate-release" || c === "sf_verify");
+            const hasRevalidation = revalidationConsumers.length > 0;
+            if (!hasRevalidation) {
+                gaps.push(`无复验入口（期望: ${expectation.expected_revalidation.join(" 或 ")}）`);
+                missingRevalidation++;
+            }
+            // 可见性
+            const visibility = assetVisibility.get(relPath) ?? "unknown";
+            if (visibility === "unknown") {
+                unknownVisibility++;
+            }
+            const hasGaps = gaps.length > 0;
+            if (hasGaps) {
+                uncoveredCount++;
+                if (!hasBearer)
+                    missingBearer++;
+            }
+            else {
+                coveredCount++;
+            }
+            entries.push({
+                asset_path: relPath,
+                asset_kind: kind,
+                has_standard_bearer: hasBearer,
+                has_revalidation_path: hasRevalidation,
+                has_main_path_consumer: hasMainConsumer,
+                owner_mechanism_id: owner,
+                asset_visibility: visibility,
+                contract_version: isRegistered ? "registered" : "none",
+                mainline_consumers: consumers,
+                revalidation_entrypoints: revalidationConsumers,
+                severity: hasGaps ? "hard_fail" : "advisory",
+                gaps,
+            });
+        }
+    }
+    // 检查 adapter_workflow
+    const workflowPath = path.join(rootDir, "src/adapters/shared/workflow_template.ts");
+    if (fs.existsSync(workflowPath)) {
+        entries.push({
+            asset_path: "src/adapters/shared/workflow_template.ts",
+            asset_kind: "adapter_workflow",
+            has_standard_bearer: true,
+            has_revalidation_path: true,
+            has_main_path_consumer: true,
+            owner_mechanism_id: "mc-workflow-contract",
+            asset_visibility: "soloforge_internal",
+            contract_version: "registered",
+            mainline_consumers: ["claude_code_adapter", "codex_adapter", "trae_adapter"],
+            revalidation_entrypoints: ["validate-release", "template_mechanism_auditor"],
+            severity: "advisory",
+            gaps: [],
+        });
+        coveredCount++;
+    }
+    return {
+        total_assets: entries.length,
+        covered_assets: coveredCount,
+        uncovered_assets: uncoveredCount,
+        missing_standard_bearer: missingBearer,
+        missing_revalidation: missingRevalidation,
+        missing_consumer: missingConsumer,
+        missing_owner: missingOwner,
+        unregistered_assets: unregisteredAssets,
+        unknown_visibility: unknownVisibility,
+        visibility_conflicts: visibilityConflicts,
+        entries,
+    };
+}
+function walkDir(dir) {
+    const results = [];
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+            const absPath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(absPath);
+            }
+            else if (/\.(md|yaml|yml|hbs|json)$/.test(entry.name)) {
+                results.push(absPath);
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=standard_asset_coverage.js.map

package/dist/engine/standard_asset_coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard_asset_coverage.js","sourceRoot":"","sources":["../../src/engine/standard_asset_coverage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AA4C7B,2BAA2B;AAE3B,MAAM,iBAAiB,GAIlB;IACH,IAAI,EAAE;QACJ,eAAe,EAAE,CAAC,4BAA4B,CAAC;QAC/C,kBAAkB,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,CAAC;QACvE,qBAAqB,EAAE,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;KAC1E;IACD,SAAS,EAAE;QACT,eAAe,EAAE,CAAC,iCAAiC,CAAC;QACpD,kBAAkB,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,iBAAiB,CAAC;QACjE,qBAAqB,EAAE,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;KAC1E;IACD,SAAS,EAAE;QACT,eAAe,EAAE,CAAC,iCAAiC,CAAC;QACpD,kBAAkB,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;QAC/C,qBAAqB,EAAE,CAAC,WAAW,EAAE,kBAAkB,CAAC;KACzD;IACD,WAAW,EAAE;QACX,eAAe,EAAE,CAAC,mCAAmC,CAAC;QACtD,kBAAkB,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC;QAClD,qBAAqB,EAAE,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;KAC1E;IACD,OAAO,EAAE;QACP,eAAe,EAAE,CAAC,+BAA+B,EAAE,qBAAqB,CAAC;QACzE,kBAAkB,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,CAAC;QACvE,qBAAqB,EAAE,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;KAC1E;IACD,QAAQ,EAAE;QACR,eAAe,EAAE,CAAC,sBAAsB,CAAC;QACzC,kBAAkB,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;QACjD,qBAAqB,EAAE,CAAC,kBAAkB,CAAC;KAC5C;IACD,gBAAgB,EAAE;QAChB,eAAe,EAAE,CAAC,0CAA0C,CAAC;QAC7D,kBAAkB,EAAE,CAAC,qBAAqB,EAAE,eAAe,EAAE,cAAc,CAAC;QAC5E,qBAAqB,EAAE,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;KAC1E;IACD,MAAM,EAAE;QACN,eAAe,EAAE,CAAC,6BAA6B,CAAC;QAChD,kBAAkB,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC;QACpD,qBAAqB,EAAE,CAAC,4BAA4B,CAAC;KACtD;IACD,eAAe,EAAE;QACf,eAAe,EAAE,CAAC,uCAAuC,CAAC;QAC1D,kBAAkB,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;QAC9C,qBAAqB,EAAE,CAAC,4BAA4B,CAAC;KACtD;IACD,mBAAmB,EAAE;QACnB,eAAe,EAAE,CAAC,2CAA2C,EAAE,gCAAgC,CAAC;QAChG,kBAAkB,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,CAAC;QACnF,qBAAqB,EAAE,CAAC,WAAW,EAAE,kBAAkB,EAAE,4BAA4B,CAAC;KACvF;IACD,kBAAkB,EAAE;QAClB,eAAe,EAAE,CAAC,gCAAgC,CAAC;QACnD,kBAAkB,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;QAC9C,qBAAqB,EAAE,CAAC,4BAA4B,CAAC;KACtD;CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,oBAAiC,EACjC,eAAoC,EACpC,cAAqC,EACrC,eAAoC;IAEpC,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAC5B,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAE5B,kBAAkB;IAClB,MAAM,YAAY,GAAuD;QACvE,EAAE,GAAG,EAAE,0CAA0C,EAAE,IAAI,EAAE,qBAAqB,EAAE;QAChF,EAAE,GAAG,EAAE,2BAA2B,EAAE,IAAI,EAAE,MAAM,EAAE;QAClD,EAAE,GAAG,EAAE,gCAAgC,EAAE,IAAI,EAAE,WAAW,EAAE;QAC5D,EAAE,GAAG,EAAE,gCAAgC,EAAE,IAAI,EAAE,WAAW,EAAE;QAC5D,EAAE,GAAG,EAAE,kCAAkC,EAAE,IAAI,EAAE,aAAa,EAAE;QAChE,EAAE,GAAG,EAAE,mCAAmC,EAAE,IAAI,EAAE,SAAS,EAAE;QAC7D,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC9C,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,UAAU,EAAE;QAChD,EAAE,GAAG,EAAE,4BAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrD,EAAE,GAAG,EAAE,sCAAsC,EAAE,IAAI,EAAE,iBAAiB,EAAE;QACxE,EAAE,GAAG,EAAE,+BAA+B,EAAE,IAAI,EAAE,qBAAqB,EAAE;KACtE,CAAC;IAEF,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,YAAY,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAErC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACrE,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAE5C,iBAAiB;YACjB,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/E,IAAI,CAAC,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEtC,gBAAgB;YAChB,MAAM,YAAY,GAAG,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;gBAC9C,kBAAkB,EAAE,CAAC;YACvB,CAAC;YAED,kCAAkC;YAClC,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;gBACnC,YAAY,EAAE,CAAC;YACjB,CAAC;YAED,0BAA0B;YAC1B,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpD,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACpF,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxE,eAAe,EAAE,CAAC;YACpB,CAAC;YAED,iCAAiC;YACjC,MAAM,qBAAqB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnD,CAAC,KAAK,4BAA4B,IAAI,CAAC,KAAK,kBAAkB,IAAI,CAAC,KAAK,WAAW,CACpF,CAAC;YACF,MAAM,eAAe,GAAG,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC;YACzD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACzE,mBAAmB,EAAE,CAAC;YACxB,CAAC;YAED,MAAM;YACN,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;YAC7D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,iBAAiB,EAAE,CAAC;YACtB,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAChC,IAAI,OAAO,EAAE,CAAC;gBACZ,cAAc,EAAE,CAAC;gBACjB,IAAI,CAAC,SAAS;oBAAE,aAAa,EAAE,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,YAAY,EAAE,CAAC;YACjB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,OAAO;gBACnB,UAAU,EAAE,IAAI;gBAChB,mBAAmB,EAAE,SAAS;gBAC9B,qBAAqB,EAAE,eAAe;gBACtC,sBAAsB,EAAE,eAAe;gBACvC,kBAAkB,EAAE,KAAK;gBACzB,gBAAgB,EAAE,UAAU;gBAC5B,gBAAgB,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM;gBACtD,kBAAkB,EAAE,SAAS;gBAC7B,wBAAwB,EAAE,qBAAqB;gBAC/C,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU;gBAC5C,IAAI;aACL,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,0CAA0C,CAAC,CAAC;IACpF,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC;YACX,UAAU,EAAE,0CAA0C;YACtD,UAAU,EAAE,kBAAkB;YAC9B,mBAAmB,EAAE,IAAI;YACzB,qBAAqB,EAAE,IAAI;YAC3B,sBAAsB,EAAE,IAAI;YAC5B,kBAAkB,EAAE,sBAAsB;YAC1C,gBAAgB,EAAE,oBAAoB;YACtC,gBAAgB,EAAE,YAAY;YAC9B,kBAAkB,EAAE,CAAC,qBAAqB,EAAE,eAAe,EAAE,cAAc,CAAC;YAC5E,wBAAwB,EAAE,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;YAC5E,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;QACH,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,cAAc,EAAE,YAAY;QAC5B,gBAAgB,EAAE,cAAc;QAChC,uBAAuB,EAAE,aAAa;QACtC,oBAAoB,EAAE,mBAAmB;QACzC,gBAAgB,EAAE,eAAe;QACjC,aAAa,EAAE,YAAY;QAC3B,mBAAmB,EAAE,kBAAkB;QACvC,kBAAkB,EAAE,iBAAiB;QACrC,oBAAoB,EAAE,mBAAmB;QACzC,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACrE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;iBAAM,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/engine/template_asset_contract_registry.d.ts

@@ -0,0 +1,162 @@
+/**
+ * 全模板资产权威合同注册表 — 214 资产单一权威元数据体系。
+ *
+ * 合同由显式资产注册表 (explicit_asset_registry.ts) 驱动，
+ * 每个资产逐一注册，新增文件必须新增条目，否则 validate-release hard_fail。
+ * DRAFT_CATEGORY_DEFAULTS 仅用于生成待审草稿/诊断建议，不作为发布态合同。
+ */
+export type TemplateAssetKind = "acceptance_template" | "checklist" | "domain" | "knowledge_rule" | "pipeline_procedure" | "review_rule" | "pattern_core" | "product_profile" | "knowledge_template" | "global_pattern" | "scaffold" | "adapter_workflow";
+export type TemplateAssetVisibility = "user_project" | "soloforge_internal" | "scaffold_only" | "global_pattern";
+export type TemplateRuntimeVisibility = "injectable" | "index_only" | "internal_only" | "scaffold_only";
+export type TemplateEvidenceRole = "template_guidance" | "project_source_file" | "classification";
+export type TemplateLifecycleStatus = "active" | "deprecated" | "internal_only";
+export type ConsumptionCategory = "mainline" | "audit_only" | "internal_runtime" | "scaffold_only" | "copy_only";
+export type ContractDecision = "allowed" | "denied" | "unregistered";
+/**
+ * 可验证的消费证据 — 不依赖合同自报，由代码级真实消费链驱动。
+ */
+export interface ConsumptionEvidence {
+    asset_kind: TemplateAssetKind;
+    selected_by_entrypoint: string;
+    selection_rule_or_matcher: string;
+    production_consumer_file: string;
+    production_consumer_export: string;
+    validation_entrypoint: string;
+    runtime_test_or_scenario_ref: string;
+}
+export interface TemplateAssetContract {
+    asset_id: string;
+    path: string;
+    asset_kind: TemplateAssetKind;
+    contract_version: string;
+    owner_mechanism_id: string;
+    asset_visibility: TemplateAssetVisibility;
+    sync_to_user_project: boolean;
+    sync_target: "project_knowledge" | "global_patterns" | "none";
+    runtime_visibility: TemplateRuntimeVisibility;
+    evidence_role: TemplateEvidenceRole;
+    user_visible: boolean;
+    applicable_routes: string[];
+    applicable_tech_stack: string[];
+    lifecycle_status: TemplateLifecycleStatus;
+    consume_category: ConsumptionCategory;
+    mainline_consumer: string;
+    validation_entrypoint: string;
+    /** review_rule 专用: 适用的编程语言（空=通用） */
+    applicable_languages?: string[];
+    /** review_rule 专用: 适用的框架（空=通用） */
+    applicable_frameworks?: string[];
+    /** review_rule 专用: 适用的文件 glob 模式（空=通用） */
+    applicable_file_patterns?: string[];
+    /** review_rule 专用: 排除的文件 glob 模式 */
+    excluded_file_patterns?: string[];
+    /** review_rule 专用: 验证策略 */
+    verification_strategy?: "pattern_match" | "ast_parse" | "manual_review";
+    /** review_rule 专用: 失败严重级别 */
+    failure_severity?: "advisory" | "warning" | "hard_fail";
+    /** scaffold 专用: 模板变量契约（必须提供的变量名） */
+    required_template_vars?: string[];
+}
+interface DraftCategoryDefaults {
+    asset_kind: TemplateAssetKind;
+    owner_mechanism_id: string;
+    asset_visibility: TemplateAssetVisibility;
+    sync_to_user_project: boolean;
+    sync_target: "project_knowledge" | "global_patterns" | "none";
+    runtime_visibility: TemplateRuntimeVisibility;
+    evidence_role: TemplateEvidenceRole;
+    user_visible: boolean;
+    applicable_routes: string[];
+    applicable_tech_stack: string[];
+    lifecycle_status: TemplateLifecycleStatus;
+    consume_category: ConsumptionCategory;
+    mainline_consumer: string;
+    validation_entrypoint: string;
+}
+/**
+ * 诊断用草稿默认值 — 用于为新资产生成待审合同建议，不作为发布态合同。
+ * 新增模板文件应先通过此生成草稿，审阅后写入 explicit_asset_registry.ts。
+ */
+export declare const DRAFT_CATEGORY_DEFAULTS: Array<{
+    prefix: string;
+    defaults: DraftCategoryDefaults;
+}>;
+/**
+ * 获取指定资产类型的真实消费证据。
+ */
+export declare function getConsumptionEvidence(assetKind: TemplateAssetKind): ConsumptionEvidence | undefined;
+/**
+ * 验证消费证据中声明的生产消费者文件是否真实存在于源码中。
+ */
+export declare function verifyConsumptionEvidence(rootDir: string): Array<{
+    asset_kind: TemplateAssetKind;
+    evidence: ConsumptionEvidence;
+    consumer_exists: boolean;
+    consumer_export_found: boolean;
+    test_exists: boolean;
+}>;
+/**
+ * 构建全模板资产权威合同列表 — 由显式注册表驱动。
+ * 只为 EXPLICIT_ASSET_REGISTRY 中注册的资产生成合同，未注册文件不计入。
+ */
+export declare function buildTemplateAssetContracts(rootDir: string): TemplateAssetContract[];
+/**
+ * 列出全模板资产权威合同（带缓存）。
+ */
+export declare function listTemplateAssetContracts(): TemplateAssetContract[];
+/**
+ * 清除缓存（测试用）。
+ */
+export declare function clearContractCache(): void;
+/**
+ * 按路径查询合同。
+ */
+export declare function getContractByPath(relPath: string): TemplateAssetContract | undefined;
+/**
+ * 合同决策 — 返回 allowed/denied/unregistered。
+ * allowed: 注册且允许访问
+ * denied: 注册但禁止（内部/脚手架资产）
+ * unregistered: 未在显式注册表中注册 → fail-closed
+ */
+export declare function getContractDecision(relPath: string): {
+    decision: ContractDecision;
+    contract?: TemplateAssetContract;
+};
+/**
+ * 按可见性筛选。
+ */
+export declare function getContractsByVisibility(visibility: TemplateAssetVisibility): TemplateAssetContract[];
+/**
+ * 获取应同步到用户项目的资产路径列表。
+ */
+export declare function getSyncableAssetPaths(): string[];
+/**
+ * 获取内部资产路径集合。
+ */
+export declare function getInternalAssetPaths(): Set<string>;
+/**
+ * 合同覆盖统计报告。
+ */
+export interface ContractCoverageReport {
+    total_templates: number;
+    total_contracts: number;
+    contract_covered: number;
+    uncovered: number;
+    unregistered_files: string[];
+    missing_from_registry: number;
+    visibility_unknown: number;
+    consumer_missing: number;
+    validation_missing: number;
+    owner_missing: number;
+    internal_count: number;
+    user_visible_count: number;
+    consume_category_breakdown: Record<ConsumptionCategory, number>;
+    consumption_evidence_verified: boolean;
+    consumption_evidence_failures: string[];
+}
+/**
+ * 生成合同覆盖统计，验证真实消费证据，检测未注册文件。
+ */
+export declare function auditContractCoverage(rootDir: string): ContractCoverageReport;
+export {};
+//# sourceMappingURL=template_asset_contract_registry.d.ts.map

package/dist/engine/template_asset_contract_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_asset_contract_registry.d.ts","sourceRoot":"","sources":["../../src/engine/template_asset_contract_registry.ts"],"names":[],"mappings":"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"}