soloforge 1.3.1 → 1.3.3

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":"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"}

package/dist/engine/task_stage_detector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 任务阶段检测器 — 问题六十五。
+ *
+ * 将 TaskContext 的内部状态映射到面向用户的丰富任务阶段模型。
+ * 不只看 status 字段，综合 classification、expansion、execution、verification
+ * 等子数据的存在性和状态。
+ */
+import type { TaskContext } from "../types.js";
+import type { TaskStage, StageExplanation } from "./workflow_navigation_contract.js";
+/**
+ * 检测任务当前所处阶段。
+ * 综合 TaskContext 的 status、子数据存在性和内容判断。
+ */
+export declare function detectTaskStage(ctx: TaskContext): TaskStage;
+/**
+ * 获取任务阶段的中文解释。
+ */
+export declare function explainTaskStage(stage: TaskStage): StageExplanation;
+//# sourceMappingURL=task_stage_detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task_stage_detector.d.ts","sourceRoot":"","sources":["../../src/engine/task_stage_detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,CAyF3D;AAgGD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,CASnE"}

package/dist/engine/task_stage_detector.js

@@ -0,0 +1,201 @@
+/**
+ * 任务阶段检测器 — 问题六十五。
+ *
+ * 将 TaskContext 的内部状态映射到面向用户的丰富任务阶段模型。
+ * 不只看 status 字段，综合 classification、expansion、execution、verification
+ * 等子数据的存在性和状态。
+ */
+/**
+ * 检测任务当前所处阶段。
+ * 综合 TaskContext 的 status、子数据存在性和内容判断。
+ */
+export function detectTaskStage(ctx) {
+    const status = ctx.status;
+    // 修复重验指令未清零 → 最高优先
+    if (ctx.repair_reverify_directive?.blocked) {
+        return "repair_reverify";
+    }
+    // 已完成 → 按交付流程判断
+    if (status === "done") {
+        if (ctx.delivery && ctx.delivery.actions_performed?.length > 0) {
+            return "release_preparation";
+        }
+        if (ctx.delivery_readiness?.delivery_allowed) {
+            return "delivery_acceptance";
+        }
+        return "delivery_acceptance";
+    }
+    // 已失败 → 归入最近阶段
+    if (status === "failed") {
+        return detectTaskStageFromHistory(ctx);
+    }
+    // classifying → 输入材料/需求
+    if (status === "classifying") {
+        if (ctx.classification) {
+            return "requirement_clarification";
+        }
+        return "input_material_collection";
+    }
+    // expanding / clarifying → 决策/设计
+    if (status === "expanding" || status === "clarifying") {
+        if (ctx.design_artifact_pack) {
+            // 按设计产物包状态细分
+            const packStatus = ctx.design_artifact_pack.status;
+            if (packStatus === "awaiting_decisions") {
+                return "decision_workshop";
+            }
+            return "architecture_design";
+        }
+        if (ctx.architecture_decision_workshop) {
+            return "decision_workshop";
+        }
+        if (ctx.decision_workshop) {
+            return "decision_workshop";
+        }
+        if (ctx.classification?.route_decision?.route === "artifact_generation") {
+            return "architecture_design";
+        }
+        return "requirement_clarification";
+    }
+    // executing → 编码
+    if (status === "executing" || status === "retrying") {
+        return "coding";
+    }
+    // verifying → 验证/测试
+    if (status === "verifying") {
+        if (ctx.phase_directive === "repair_reverify") {
+            return "repair_reverify";
+        }
+        // 区分本地验证和测试
+        if (ctx.verification_result?.status === "failed") {
+            return "testing";
+        }
+        return "local_verification";
+    }
+    // reworking → 回到最近的设计/编码
+    if (status === "reworking") {
+        if (ctx.design_artifact_pack && ctx.design_artifact_pack.status !== "implementation_ready") {
+            return "architecture_design";
+        }
+        return "coding";
+    }
+    // learning → 交付验收
+    if (status === "learning") {
+        if (ctx.code_review) {
+            return "code_review";
+        }
+        return "local_verification";
+    }
+    // 兜底
+    return "input_material_collection";
+}
+/**
+ * 从历史数据推断失败任务的最近阶段。
+ */
+function detectTaskStageFromHistory(ctx) {
+    if (ctx.delivery)
+        return "delivery_acceptance";
+    if (ctx.code_review)
+        return "code_review";
+    if (ctx.verification || ctx.verification_result)
+        return "local_verification";
+    if (ctx.execution?.changed_files?.length)
+        return "coding";
+    if (ctx.design_artifact_pack)
+        return "architecture_design";
+    if (ctx.expansion)
+        return "requirement_clarification";
+    if (ctx.classification)
+        return "requirement_clarification";
+    return "input_material_collection";
+}
+/** 任务阶段中文标签 */
+const TASK_STAGE_LABELS = {
+    input_material_collection: "输入材料收集",
+    requirement_clarification: "需求明确化",
+    decision_workshop: "决策研讨",
+    architecture_design: "架构设计",
+    detailed_design: "详细设计",
+    database_design: "数据库设计",
+    api_design: "API 设计",
+    slice_planning: "切片规划",
+    coding: "编码实现",
+    local_verification: "本地验证",
+    testing: "测试",
+    code_review: "代码审查",
+    repair_reverify: "修复复验",
+    delivery_acceptance: "交付验收",
+    release_preparation: "发布准备",
+    post_release_observation: "发布后观察",
+};
+/** 任务阶段中文描述 */
+const TASK_STAGE_DESCRIPTIONS = {
+    input_material_collection: "正在收集和理解输入材料，尚未开始分类",
+    requirement_clarification: "已完成初步分类，正在明确需求和意图",
+    decision_workshop: "需要确认关键技术决策后才能继续",
+    architecture_design: "正在进行架构/数据库/API 设计",
+    detailed_design: "正在进行详细设计",
+    database_design: "正在进行数据库设计",
+    api_design: "正在进行 API 设计",
+    slice_planning: "正在制定开发切片计划",
+    coding: "正在编码实现",
+    local_verification: "正在进行本地构建和验证",
+    testing: "测试中发现问题，需要修复",
+    code_review: "正在进行代码审查",
+    repair_reverify: "修复重验指令未清零，需要先完成修复和复验",
+    delivery_acceptance: "任务已完成验证，准备交付验收",
+    release_preparation: "已交付，准备发布",
+    post_release_observation: "发布后观察期",
+};
+/** 任务阶段必要证据 */
+const TASK_STAGE_EVIDENCE = {
+    input_material_collection: ["TaskContext.status=classifying", "classification 不存在"],
+    requirement_clarification: ["classification 存在"],
+    decision_workshop: ["architecture_decision_workshop 或 decision_workshop 存在"],
+    architecture_design: ["design_artifact_pack 存在"],
+    detailed_design: ["expansion.scope 详细"],
+    database_design: ["design_artifact_pack 含数据库文档"],
+    api_design: ["design_artifact_pack 含 API 文档"],
+    slice_planning: ["planning 存在"],
+    coding: ["TaskContext.status=executing/retrying"],
+    local_verification: ["TaskContext.status=verifying"],
+    testing: ["verification.status=failed"],
+    code_review: ["code_review 存在"],
+    repair_reverify: ["repair_reverify_directive.blocked=true"],
+    delivery_acceptance: ["verification passed 或 status=done"],
+    release_preparation: ["delivery_executed=true"],
+    post_release_observation: ["已发布"],
+};
+/** 任务阶段可能的下一阶段 */
+const TASK_STAGE_NEXT = {
+    input_material_collection: ["requirement_clarification"],
+    requirement_clarification: ["decision_workshop", "architecture_design", "coding"],
+    decision_workshop: ["architecture_design"],
+    architecture_design: ["detailed_design", "slice_planning"],
+    detailed_design: ["database_design", "api_design"],
+    database_design: ["slice_planning"],
+    api_design: ["slice_planning"],
+    slice_planning: ["coding"],
+    coding: ["local_verification"],
+    local_verification: ["testing", "code_review", "repair_reverify"],
+    testing: ["coding", "repair_reverify"],
+    code_review: ["coding", "delivery_acceptance"],
+    repair_reverify: ["local_verification"],
+    delivery_acceptance: ["release_preparation"],
+    release_preparation: ["post_release_observation"],
+    post_release_observation: [],
+};
+/**
+ * 获取任务阶段的中文解释。
+ */
+export function explainTaskStage(stage) {
+    return {
+        stage,
+        level: "task",
+        label_zh: TASK_STAGE_LABELS[stage],
+        description_zh: TASK_STAGE_DESCRIPTIONS[stage],
+        required_evidence: TASK_STAGE_EVIDENCE[stage],
+        next_possible_stages: TASK_STAGE_NEXT[stage],
+    };
+}
+//# sourceMappingURL=task_stage_detector.js.map

package/dist/engine/task_stage_detector.js.map

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

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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"}