soloforge 1.3.4 → 1.3.6

package/dist/engine/project_knowledge_contract.js

@@ -0,0 +1,298 @@
+/**
+ * 用户项目知识合同。
+ *
+ * 内置 templates/** 解决 SoloForge 自带资产的同步与可见性；
+ * 用户项目 .soloforge/knowledge/** 则需要独立承载: 允许用户沉淀项目特有规则，
+ * 同时保证它们能被索引、选中、注入或审计，而不是静态文件。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import matter from "gray-matter";
+import YAML from "yaml";
+import { getProjectKnowledgeDir } from "../knowledge/loader.js";
+import { readSyncManifest, resolveAuthoritativeIdentity, computeAuthoritativeHash, } from "./template_init_sync.js";
+import { getContractDecision } from "./template_asset_contract_registry.js";
+function listKnowledgeFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const out = [];
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+            if (["node_modules", ".git", ".DS_Store"].includes(entry.name))
+                continue;
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory())
+                stack.push(full);
+            else if (/\.(md|ya?ml)$/i.test(entry.name))
+                out.push(full);
+        }
+    }
+    return out.sort();
+}
+function parseKnowledgeFile(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        if (/\.md$/i.test(filePath)) {
+            const parsed = matter(raw);
+            return { data: parsed.data ?? {}, body: parsed.content ?? "", hasFrontmatter: raw.trimStart().startsWith("---") };
+        }
+        const data = YAML.parse(raw) ?? {};
+        return { data, body: raw, hasFrontmatter: Object.keys(data).length > 0 };
+    }
+    catch {
+        return { data: {}, body: "", hasFrontmatter: false };
+    }
+}
+function bodyHash(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        if (filePath.endsWith(".yaml") || filePath.endsWith(".yml")) {
+            const stripped = content.split("\n")
+                .filter((line) => !/^(status|updated_at)\s*:/.test(line.trim()))
+                .join("\n");
+            return crypto.createHash("sha256").update(stripped).digest("hex").substring(0, 16);
+        }
+        const bodyStart = content.indexOf("---", content.indexOf("---") + 3);
+        const body = bodyStart >= 0 ? content.substring(bodyStart + 3).trimStart() : content;
+        return crypto.createHash("sha256").update(body).digest("hex").substring(0, 16);
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeList(value) {
+    if (Array.isArray(value))
+        return value.map(String).filter(Boolean);
+    if (typeof value === "string" && value.trim())
+        return [value.trim()];
+    return [];
+}
+function inferConsumption(relPath, data, hardRule) {
+    const kind = String(data.asset_kind ?? data.type ?? "").toLowerCase();
+    if (hardRule)
+        return "hard_rule";
+    if (relPath.includes("review_rules/") || kind === "review_rule")
+        return "review_rule";
+    if (relPath.includes("acceptance_templates/") || kind === "acceptance_template")
+        return "acceptance_template";
+    const runtimeVisibility = String(data.runtime_visibility ?? "").toLowerCase();
+    if (runtimeVisibility === "injectable")
+        return "injectable";
+    if (normalizeList(data.routes).length > 0 || normalizeList(data.primary_triggers).length > 0)
+        return "injectable";
+    return "index_only";
+}
+function hasHardRuleMarker(relPath, data, body) {
+    const kind = String(data.asset_kind ?? data.type ?? "").toLowerCase();
+    const priority = String(data.priority ?? "").toUpperCase();
+    const enforcementLevel = String(data.enforcement?.level ?? data.enforcement_level ?? "").toLowerCase();
+    return kind === "hard_rule"
+        || priority === "P0"
+        || priority === "P1"
+        || enforcementLevel === "hard_rule"
+        || (relPath.includes("rules/") && /hard[_ -]?fail|必须|不得|禁止/.test(body));
+}
+function classifyIdentity(projectPath, relPath, filePath) {
+    const manifest = readSyncManifest(projectPath);
+    const syncEntry = manifest?.entries?.[relPath];
+    const authoritative = resolveAuthoritativeIdentity(relPath);
+    if (syncEntry && authoritative) {
+        const authoritativeHash = computeAuthoritativeHash(authoritative.source_contract_path);
+        const currentBodyHash = bodyHash(filePath);
+        if (syncEntry.source_contract_path !== authoritative.source_contract_path)
+            return "conflict";
+        if (authoritativeHash && currentBodyHash && currentBodyHash !== authoritativeHash)
+            return "user_modified_builtin";
+        const decision = getContractDecision(authoritative.source_contract_path);
+        if (decision.contract?.lifecycle_status === "deprecated")
+            return "deprecated_builtin";
+        return "builtin_synced";
+    }
+    if (authoritative) {
+        const decision = getContractDecision(authoritative.source_contract_path);
+        if (decision.decision === "denied")
+            return "conflict";
+        return "user_modified_builtin";
+    }
+    return "user_authored";
+}
+function analyzeAsset(projectPath, knowledgeDir, filePath) {
+    const relPath = path.relative(knowledgeDir, filePath).replace(/\\/g, "/");
+    const parsed = parseKnowledgeFile(filePath);
+    const data = parsed.data;
+    const hardRule = hasHardRuleMarker(relPath, data, parsed.body);
+    const routes = normalizeList(data.routes);
+    const primaryTriggers = normalizeList(data.primary_triggers);
+    const techStack = normalizeList(data.tech_stack);
+    const domains = normalizeList(data.domains ?? data.scope);
+    const conflictGroup = String(data.conflict_group ?? data.rule_key ?? "").trim() || undefined;
+    const ruleValue = String(data.rule_value ?? data.decision_value ?? data.format ?? "").trim() || undefined;
+    const conflictsWith = normalizeList(data.conflicts_with);
+    const consumption = inferConsumption(relPath, data, hardRule);
+    const identity = classifyIdentity(projectPath, relPath, filePath);
+    const findings = [];
+    if (!parsed.hasFrontmatter) {
+        findings.push({
+            severity: "warning",
+            code: "PROJECT_KNOWLEDGE_FRONTMATTER_MISSING",
+            message_zh: "用户项目知识缺少 frontmatter，只能作为低置信度索引知识，不能作为 hard rule 强执行。",
+        });
+    }
+    if (hardRule && routes.length === 0 && normalizeList(data.primary_triggers).length === 0) {
+        findings.push({
+            severity: "hard_fail",
+            code: "PROJECT_KNOWLEDGE_HARD_RULE_UNROUTED",
+            message_zh: "hard rule 缺少 routes 或 primary_triggers，无法被 SoloForge 稳定选中和消费。",
+        });
+    }
+    if (identity === "conflict") {
+        findings.push({
+            severity: "hard_fail",
+            code: "PROJECT_KNOWLEDGE_IDENTITY_CONFLICT",
+            message_zh: "项目知识与内置同步资产身份冲突，必须人工确认保留、合并或迁移。",
+        });
+    }
+    if (identity === "user_modified_builtin") {
+        findings.push({
+            severity: "advisory",
+            code: "PROJECT_KNOWLEDGE_USER_MODIFIED_BUILTIN",
+            message_zh: "用户修改过内置同步资产，sync-templates 不得自动覆盖；升级时应输出合并建议。",
+        });
+    }
+    if (consumption === "index_only" && hardRule) {
+        findings.push({
+            severity: "hard_fail",
+            code: "PROJECT_KNOWLEDGE_HARD_RULE_INDEX_ONLY",
+            message_zh: "hard rule 被判定为 index_only，必须补齐触发条件或降级为 advisory。",
+        });
+    }
+    return {
+        id: String(data.id ?? data.name ?? relPath),
+        name: String(data.name ?? path.basename(filePath, path.extname(filePath))),
+        rel_path: relPath,
+        abs_path: filePath,
+        identity,
+        consumption,
+        routes,
+        primary_triggers: primaryTriggers,
+        tech_stack: techStack,
+        domains,
+        conflict_group: conflictGroup,
+        rule_value: ruleValue,
+        conflicts_with: conflictsWith,
+        has_frontmatter: parsed.hasFrontmatter,
+        hard_rule: hardRule,
+        injectable: consumption === "injectable" || consumption === "hard_rule",
+        findings,
+    };
+}
+function detectProjectKnowledgeConflicts(assets) {
+    const byIdOrPath = new Map();
+    for (const asset of assets) {
+        byIdOrPath.set(asset.id, asset);
+        byIdOrPath.set(asset.rel_path, asset);
+    }
+    for (const asset of assets) {
+        for (const target of asset.conflicts_with) {
+            const other = byIdOrPath.get(target);
+            if (!other)
+                continue;
+            asset.findings.push({
+                severity: "hard_fail",
+                code: "PROJECT_KNOWLEDGE_RULE_CONFLICT",
+                message_zh: `项目规则声明与 ${other.rel_path} 冲突，必须由用户确认取舍或合并。`,
+            });
+        }
+    }
+    const grouped = new Map();
+    for (const asset of assets) {
+        if (!asset.conflict_group || !asset.rule_value)
+            continue;
+        const list = grouped.get(asset.conflict_group) ?? [];
+        list.push(asset);
+        grouped.set(asset.conflict_group, list);
+    }
+    for (const [group, list] of grouped) {
+        const values = new Set(list.map((asset) => asset.rule_value));
+        if (values.size <= 1)
+            continue;
+        for (const asset of list) {
+            asset.findings.push({
+                severity: "hard_fail",
+                code: "PROJECT_KNOWLEDGE_RULE_CONFLICT",
+                message_zh: `项目规则组 ${group} 存在多个互斥取值（${Array.from(values).join(" / ")}），必须由用户确认统一口径。`,
+            });
+        }
+    }
+}
+export function auditProjectKnowledge(projectPath, config) {
+    const knowledgeDir = config && config._projectPath
+        ? getProjectKnowledgeDir(config)
+        : path.join(projectPath, ".soloforge", "knowledge");
+    const assets = listKnowledgeFiles(knowledgeDir).map((file) => analyzeAsset(projectPath, knowledgeDir, file));
+    detectProjectKnowledgeConflicts(assets);
+    const hardFailCount = assets.reduce((sum, asset) => sum + asset.findings.filter((f) => f.severity === "hard_fail").length, 0);
+    const warningCount = assets.reduce((sum, asset) => sum + asset.findings.filter((f) => f.severity === "warning").length, 0);
+    const unconsumed = assets.filter((asset) => asset.consumption === "index_only" && asset.identity === "user_authored").length;
+    const recommendedNextSteps = [];
+    if (hardFailCount > 0)
+        recommendedNextSteps.push("先修复 hard rule 缺少触发条件或身份冲突的项目知识。");
+    if (unconsumed > 0)
+        recommendedNextSteps.push("为需要参与执行的项目规则补充 routes、primary_triggers 或 enforcement.level。");
+    if (assets.length === 0)
+        recommendedNextSteps.push("当前项目暂无自定义知识；可按需新增 .soloforge/knowledge/rules 或 domain 规则。");
+    return {
+        project_path: projectPath,
+        total: assets.length,
+        user_authored: assets.filter((a) => a.identity === "user_authored").length,
+        builtin_synced: assets.filter((a) => a.identity === "builtin_synced").length,
+        user_modified_builtin: assets.filter((a) => a.identity === "user_modified_builtin").length,
+        deprecated_builtin: assets.filter((a) => a.identity === "deprecated_builtin").length,
+        conflict: assets.filter((a) => a.identity === "conflict").length,
+        hard_rule: assets.filter((a) => a.hard_rule).length,
+        injectable: assets.filter((a) => a.injectable).length,
+        index_only: assets.filter((a) => a.consumption === "index_only").length,
+        unconsumed,
+        hard_fail_count: hardFailCount,
+        warning_count: warningCount,
+        assets,
+        recommended_next_steps: recommendedNextSteps,
+    };
+}
+export function selectProjectKnowledgeForTask(report, input) {
+    const haystack = `${input.intent} ${input.route ?? ""}`.toLowerCase();
+    const stack = (input.tech_stack ?? []).map((s) => s.toLowerCase());
+    const scored = report.assets
+        .filter((asset) => asset.identity !== "conflict")
+        .filter((asset) => asset.consumption !== "index_only" || asset.hard_rule)
+        .filter((asset) => asset.tech_stack.length === 0 || asset.tech_stack.some((t) => stack.some((s) => s.includes(t.toLowerCase()) || t.toLowerCase().includes(s))))
+        .filter((asset) => {
+        const routeMatches = asset.routes.length === 0 || (input.route ? asset.routes.includes(input.route) : false);
+        const triggerTokens = [...asset.primary_triggers, ...asset.domains];
+        const triggerMatches = triggerTokens.length === 0
+            || triggerTokens.some((token) => haystack.includes(token.toLowerCase()));
+        if (asset.hard_rule)
+            return routeMatches && triggerMatches;
+        return routeMatches || triggerMatches;
+    })
+        .map((asset) => {
+        let score = 0;
+        for (const token of [...asset.routes, ...asset.primary_triggers, ...asset.domains, asset.name, asset.rel_path]) {
+            const lower = token.toLowerCase();
+            if (lower && haystack.includes(lower))
+                score += 2;
+        }
+        if (asset.hard_rule)
+            score += 3;
+        if (asset.injectable)
+            score += 1;
+        return { asset, score };
+    })
+        .filter((item) => item.score > 0 || item.asset.hard_rule)
+        .sort((a, b) => b.score - a.score);
+    return scored.slice(0, input.limit ?? 8).map((item) => item.asset);
+}
+//# sourceMappingURL=project_knowledge_contract.js.map

package/dist/engine/project_knowledge_contract.js.map

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

package/dist/engine/project_knowledge_system_regression_matrix.d.ts

@@ -0,0 +1,27 @@
+export interface ProjectKnowledgeSystemMatrixCase {
+    id: string;
+    issue_id: "问题六十九";
+    title: string;
+    mechanism_family: string;
+    detail_scope: string;
+    production_entrypoints: string[];
+    must_fail: string;
+    must_pass: string;
+    release_gate_code: string;
+    doc_refs: string[];
+}
+export interface MatrixValidationFinding {
+    code: string;
+    severity: "hard_fail";
+    message: string;
+    case_id?: string;
+}
+export interface MatrixValidationReport {
+    passed: boolean;
+    total_cases: number;
+    hard_fail_count: number;
+    findings: MatrixValidationFinding[];
+}
+export declare const PROJECT_KNOWLEDGE_SYSTEM_MATRIX: readonly ProjectKnowledgeSystemMatrixCase[];
+export declare function validateProjectKnowledgeSystemMatrix(cases?: readonly ProjectKnowledgeSystemMatrixCase[]): MatrixValidationReport;
+//# sourceMappingURL=project_knowledge_system_regression_matrix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project_knowledge_system_regression_matrix.d.ts","sourceRoot":"","sources":["../../src/engine/project_knowledge_system_regression_matrix.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gCAAgC;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,+BAA+B,EAAE,SAAS,gCAAgC,EAiPtF,CAAC;AAaF,wBAAgB,oCAAoC,CAClD,KAAK,GAAE,SAAS,gCAAgC,EAAoC,GACnF,sBAAsB,CAsCxB"}

package/dist/engine/project_knowledge_system_regression_matrix.js

@@ -0,0 +1,295 @@
+export const PROJECT_KNOWLEDGE_SYSTEM_MATRIX = [
+    {
+        id: "PKS-01",
+        issue_id: "问题六十九",
+        title: "内置模板资产卫生",
+        mechanism_family: "template_asset_hygiene",
+        detail_scope: "清理 templates/** 的 TODO/FIXME、含糊词、内部施工语义；hard rule/advisory/procedure/template 边界明确；acceptance template 有复验闭环。",
+        production_entrypoints: ["validate-release", "audit-template-visibility", "sync-templates"],
+        must_fail: "用户可见模板出现 TODO/FIXME、Batch/problem/validate-batch 内部语义，或验收模板没有复验命令时 hard_fail。",
+        must_pass: "用户可见模板术语清晰、无内部泄漏、验收模板带复验闭环。",
+        release_gate_code: "PKS_TEMPLATE_ASSET_HYGIENE",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-02",
+        issue_id: "问题六十九",
+        title: "脚手架生成物质量",
+        mechanism_family: "scaffold_quality_contract",
+        detail_scope: "React/Spring Boot scaffold 生成物不得天然带 TODO，不得违反问题六十八，Controller/DTO/校验/错误码/日志/审计/测试有默认结构。",
+        production_entrypoints: ["sf_scaffold", "validate-release", "npm pack"],
+        must_fail: "脚手架模板或生成物带占位符、缺入参校验、缺统一出参或生成后触发问题六十八时 hard_fail。",
+        must_pass: "真实脚手架生成后通过质量契约和可观测性契约。",
+        release_gate_code: "PKS_SCAFFOLD_GENERATED_QUALITY",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-03",
+        issue_id: "问题六十九",
+        title: "用户项目知识承载消费",
+        mechanism_family: "project_knowledge_contract",
+        detail_scope: "识别 user_authored、user_modified_builtin、builtin_synced、deprecated_builtin、conflict；无 frontmatter 可索引但不能作为 hard rule 强执行。",
+        production_entrypoints: ["audit-project-knowledge", "sf_expand", "sf_review", "sf_verify", "sf_deliver", "soloforge next"],
+        must_fail: "用户 hard rule 缺 routes/primary_triggers、冲突未确认、或无法进入主链路时 hard_fail。",
+        must_pass: "用户项目规则可审计、可选择、可注入、可阻断、可解释。",
+        release_gate_code: "PKS_PROJECT_KNOWLEDGE_CONSUMPTION",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-04",
+        issue_id: "问题六十九",
+        title: "项目知识选择与注入",
+        mechanism_family: "knowledge_injection_boundary",
+        detail_scope: "按 intent、route、阶段、技术栈、文件路径、业务域选择，不全量塞 prompt；区分 index_only、injectable、hard_rule、audit_only。",
+        production_entrypoints: ["sf_expand", "KnowledgeIndexManager", "intent_expander"],
+        must_fail: "index_only/internal_only 进入 prompt、技术栈不匹配知识被注入、或注入无选中理由时 hard_fail。",
+        must_pass: "只注入当前任务必需规则，并说明为什么选中。",
+        release_gate_code: "PKS_PROJECT_KNOWLEDGE_INJECTION_BOUNDARY",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-05",
+        issue_id: "问题六十九",
+        title: "用户项目规则冲突检测",
+        mechanism_family: "project_rule_conflict_governance",
+        detail_scope: "覆盖项目规则 vs 内置规则、项目规则之间、API 响应、分页、日志字段、数据库命名、权限模型冲突；冲突必须进入用户确认。",
+        production_entrypoints: ["audit-project-knowledge", "sf_expand", "soloforge next"],
+        must_fail: "互斥 hard rule 没有冲突 finding 或 AI 直接拍板时 hard_fail。",
+        must_pass: "冲突以中文解释并要求用户确认，确认前不进入执行。",
+        release_gate_code: "PKS_PROJECT_RULE_CONFLICT_CONFIRMATION",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-06",
+        issue_id: "问题六十九",
+        title: "项目知识审计命令",
+        mechanism_family: "project_knowledge_audit_cli",
+        detail_scope: "audit-project-knowledge 输出总数、用户自建、修改内置、hard_rule、index_only、injectable、冲突、未消费规则、最近消费 trace 与入口覆盖。",
+        production_entrypoints: ["soloforge audit-project-knowledge"],
+        must_fail: "JSON 不纯、缺统计字段、或无法列出 hard_fail 与消费入口时 hard_fail。",
+        must_pass: "人类输出可读，--json 可解析且字段完整。",
+        release_gate_code: "PKS_PROJECT_KNOWLEDGE_AUDIT_COMMAND",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-07",
+        issue_id: "问题六十九",
+        title: "soloforge next 消费项目规则",
+        mechanism_family: "workflow_navigation_contract",
+        detail_scope: "next 不能只看阶段；API、数据库、权限、迁移等下一步必须展示将应用的项目规则，冲突优先确认。",
+        production_entrypoints: ["soloforge next", "next_action_planner"],
+        must_fail: "next 没有项目知识上下文，或冲突规则未优先提示确认时 hard_fail。",
+        must_pass: "next 明确列出下一步适用规则、阻断规则和确认事项。",
+        release_gate_code: "PKS_NEXT_PROJECT_RULE_CONTEXT",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-08",
+        issue_id: "问题六十九",
+        title: "sync-templates 升级策略",
+        mechanism_family: "template_sync_migration",
+        detail_scope: "不覆盖用户自建规则；保留用户修改内置模板；新版冲突输出 merge 建议；废弃模板标记 deprecated；内置资产仍合同化防泄漏。",
+        production_entrypoints: ["soloforge sync-templates", "template_init_sync"],
+        must_fail: "用户自建规则被覆盖/误删，或内置无合同资产被同步时 hard_fail。",
+        must_pass: "用户修改受保护，冲突有 merge 建议，废弃仅标记不删除。",
+        release_gate_code: "PKS_SYNC_TEMPLATES_USER_PROTECTION",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-09",
+        issue_id: "问题六十九",
+        title: "新项目降噪",
+        mechanism_family: "knowledge_noise_control",
+        detail_scope: "新项目只注入当前阶段必需资产；设计阶段不注入大量编码规范；编码阶段强化 OOD、后端工程、日志注释和测试。",
+        production_entrypoints: ["sf_expand", "soloforge init", "soloforge validate"],
+        must_fail: "空项目或设计阶段被注入大量不相关编码规则时 hard_fail。",
+        must_pass: "低噪声启动，其他规则保持可索引但不注入。",
+        release_gate_code: "PKS_NEW_PROJECT_NOISE_CONTROL",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-10",
+        issue_id: "问题六十九",
+        title: "生命周期阶段覆盖",
+        mechanism_family: "lifecycle_knowledge_matrix",
+        detail_scope: "需求、决策、架构、详细设计、数据库、API、OOD、编码、测试、审查、本地验收、交付、发布后复盘、演进维护均有知识消费口径。",
+        production_entrypoints: ["sf_classify", "sf_expand", "sf_review", "sf_verify", "sf_deliver", "soloforge next"],
+        must_fail: "任一生命周期阶段没有内置模板、项目规则、hard gate/advisory/确认口径时 hard_fail。",
+        must_pass: "每阶段知道读哪些模板、哪些项目规则、哪些必须阻断、哪些只建议。",
+        release_gate_code: "PKS_LIFECYCLE_STAGE_COVERAGE",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-11",
+        issue_id: "问题六十九",
+        title: "技术栈过滤",
+        mechanism_family: "technology_stack_filtering",
+        detail_scope: "React/Vue 互斥，Spring Boot/Node/Python 互斥；后端任务不注入前端模板，前端任务不注入数据库规则，安全/迁移任务强化对应规则。",
+        production_entrypoints: ["sf_expand", "KnowledgeIndexManager", "template_asset_contract_registry"],
+        must_fail: "不匹配技术栈规则进入 prompt 或被当作 hard rule 执行时 hard_fail。",
+        must_pass: "仅适配当前项目、当前阶段、当前任务的规则被注入。",
+        release_gate_code: "PKS_TECH_STACK_FILTERING",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-12",
+        issue_id: "问题六十九",
+        title: "设计产物模板消费",
+        mechanism_family: "design_artifact_contract",
+        detail_scope: "架构、数据库、API、OpenAPI/Markdown 一致性、SQL migration 权威资产、设计一致性报告闭环都由任务消费和审计。",
+        production_entrypoints: ["sf_expand", "sf_verify", "audit-design-artifacts"],
+        must_fail: "模板存在但架构/DB/API 任务不消费，或 OpenAPI/Markdown/SQL 权威资产不一致时 hard_fail。",
+        must_pass: "设计产物包能支撑后续 AI 开发且审计通过。",
+        release_gate_code: "PKS_DESIGN_ARTIFACT_TEMPLATE_CONSUMPTION",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-13",
+        issue_id: "问题六十九",
+        title: "近似资产去重与边界",
+        mechanism_family: "asset_boundary_governance",
+        detail_scope: "架构流程/工作流、紧急修复流程/流水线、接口设计/API 规格、数据库设计/变更方案、工程纪律/执行原则等明确阶段、消费、注入、验收、合并。",
+        production_entrypoints: ["audit-template-visibility", "validate-release"],
+        must_fail: "近似资产边界不明、互相重复且无消费归属时 hard_fail。",
+        must_pass: "每个近似资产都有阶段、消费者、注入/索引口径和验收边界。",
+        release_gate_code: "PKS_SIMILAR_ASSET_BOUNDARY",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-14",
+        issue_id: "问题六十九",
+        title: "命名统一迁移",
+        mechanism_family: "template_naming_migration",
+        detail_scope: "模版/模板统一必须有旧路径 alias、registry 更新、sync-templates 迁移、用户修改保护、release gate 防断链和文档同步。",
+        production_entrypoints: ["sync-templates", "template_asset_contract_registry", "validate-release"],
+        must_fail: "路径改名导致旧项目断链、用户修改丢失或 registry 别名缺失时 hard_fail。",
+        must_pass: "新旧路径兼容，用户项目平滑迁移。",
+        release_gate_code: "PKS_TEMPLATE_NAMING_MIGRATION",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-15",
+        issue_id: "问题六十九",
+        title: "可见性与安全边界",
+        mechanism_family: "template_asset_visibility",
+        detail_scope: "internal-only 不同步到用户项目；用户项目规则不得伪装成内置内部资产；敏感规则、内部机制、发布 gate 规则不泄露；项目知识 secret/token 拦截或脱敏。",
+        production_entrypoints: ["sync-templates", "audit-template-visibility", "audit-project-knowledge"],
+        must_fail: "内部资产泄漏或项目知识含 secret/token 被当作可注入规则时 hard_fail。",
+        must_pass: "内部资产隔离，用户知识敏感内容被阻断或脱敏。",
+        release_gate_code: "PKS_VISIBILITY_SECURITY_BOUNDARY",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-16",
+        issue_id: "问题六十九",
+        title: "消费证据追踪",
+        mechanism_family: "observed_consumption",
+        detail_scope: "每个知识资产回答谁创建、同步、索引、选择、注入、审查、验证、交付阻断，最近在哪个任务消费。",
+        production_entrypoints: ["observed_consumption", "audit-template-visibility", "audit-project-knowledge"],
+        must_fail: "资产只有文件存在或注册存在，没有消费 trace 时 hard_fail。",
+        must_pass: "消费证据能追踪到真实入口和最近任务。",
+        release_gate_code: "PKS_CONSUMPTION_TRACEABILITY",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-17",
+        issue_id: "问题六十九",
+        title: "用户可见解释",
+        mechanism_family: "user_visible_explanation",
+        detail_scope: "用户知道为什么选中规则、为什么阻断、怎么修、修完跑什么命令、哪些建议、哪些必须满足。",
+        production_entrypoints: ["sf_expand", "sf_review", "sf_verify", "sf_deliver", "soloforge next"],
+        must_fail: "阻断只给内部码或不说明修复命令时 hard_fail。",
+        must_pass: "中文解释包含证据、风险、修复步骤和复验命令。",
+        release_gate_code: "PKS_USER_VISIBLE_EXPLANATION",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-18",
+        issue_id: "问题六十九",
+        title: "防回归 gate",
+        mechanism_family: "release_gate_regression_matrix",
+        detail_scope: "覆盖模板无内部词、scaffold 无占位、hard rule 无含糊词、acceptance template 有复验、项目知识被消费、sync 不覆盖、技术栈过滤、next 读取、冲突确认、问题六十八生成物不违约。",
+        production_entrypoints: ["validate-release"],
+        must_fail: "20 项任意缺失或只停留在文档时 hard_fail。",
+        must_pass: "release gate 对 20 项矩阵有结构化校验和行为验证。",
+        release_gate_code: "PKS_RELEASE_GATE_REGRESSION_MATRIX",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-19",
+        issue_id: "问题六十九",
+        title: "文档同步",
+        mechanism_family: "documentation_contract",
+        detail_scope: "README 和设计方案说明 templates/**、.soloforge/knowledge/**、内置模板/项目规则区别、index_only/injectable/hard_rule、sync 保护、添加规则和审计方式。",
+        production_entrypoints: ["README.md", "docs/SoloForge-设计方案.md", "docs/正式发布门槛.md"],
+        must_fail: "实现存在但用户文档不知道如何使用或审计时 hard_fail。",
+        must_pass: "用户能按自然语言和 CLI 完成项目规则新增、审计和复验。",
+        release_gate_code: "PKS_DOCUMENTATION_SYNC",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+    {
+        id: "PKS-20",
+        issue_id: "问题六十九",
+        title: "自然语言添加项目规则体验",
+        mechanism_family: "natural_language_project_rule_authoring",
+        detail_scope: "用户说“我们项目有一条特殊 API 响应规则，请加入 SoloForge，以后所有接口设计和实现都遵守”时，SoloForge 能引导写到哪里、frontmatter、阶段、hard rule、验证和冲突处理。",
+        production_entrypoints: ["sf_classify", "sf_expand", "soloforge next", "audit-project-knowledge"],
+        must_fail: "自然语言只能生成静态文件，不进入审计/消费/冲突确认时 hard_fail。",
+        must_pass: "规则被写入项目知识、带最小契约、可审计、可选择、可阻断。",
+        release_gate_code: "PKS_NATURAL_LANGUAGE_RULE_AUTHORING",
+        doc_refs: ["docs/SoloForge-Batch8问题集.md#问题六十九"],
+    },
+];
+const REQUIRED_ENTRYPOINTS = [
+    "sf_expand",
+    "sf_review",
+    "sf_verify",
+    "sf_deliver",
+    "soloforge next",
+    "audit-project-knowledge",
+    "sync-templates",
+    "validate-release",
+];
+export function validateProjectKnowledgeSystemMatrix(cases = PROJECT_KNOWLEDGE_SYSTEM_MATRIX) {
+    const findings = [];
+    const add = (code, message, case_id) => findings.push({ code, severity: "hard_fail", message, case_id });
+    if (cases.length !== 20) {
+        add("PKS_MATRIX_COUNT_MISMATCH", `项目知识体系矩阵必须精确覆盖 20 项讨论细节，当前为 ${cases.length}`);
+    }
+    const ids = new Set();
+    for (const item of cases) {
+        if (ids.has(item.id))
+            add("PKS_MATRIX_DUPLICATE_ID", `矩阵 ID 重复: ${item.id}`, item.id);
+        ids.add(item.id);
+        if (item.issue_id !== "问题六十九")
+            add("PKS_MATRIX_WRONG_ISSUE", `${item.id} 未归属问题六十九`, item.id);
+        if (!item.mechanism_family || !item.detail_scope)
+            add("PKS_MATRIX_SCOPE_MISSING", `${item.id} 缺少机制族或细节范围`, item.id);
+        if (item.production_entrypoints.length === 0)
+            add("PKS_MATRIX_ENTRYPOINT_MISSING", `${item.id} 缺少生产入口`, item.id);
+        if (!item.must_fail || !item.must_pass)
+            add("PKS_MATRIX_BEHAVIOR_MISSING", `${item.id} 缺少 must-fail/must-pass`, item.id);
+        if (!item.release_gate_code)
+            add("PKS_MATRIX_GATE_CODE_MISSING", `${item.id} 缺少 release gate code`, item.id);
+        if (item.doc_refs.length === 0)
+            add("PKS_MATRIX_DOC_REF_MISSING", `${item.id} 缺少文档引用`, item.id);
+    }
+    for (let i = 1; i <= 20; i++) {
+        const id = `PKS-${String(i).padStart(2, "0")}`;
+        if (!ids.has(id))
+            add("PKS_MATRIX_REQUIRED_ID_MISSING", `缺少讨论细节矩阵项 ${id}`);
+    }
+    const joinedEntrypoints = cases.flatMap((item) => item.production_entrypoints).join("\n");
+    for (const entrypoint of REQUIRED_ENTRYPOINTS) {
+        if (!joinedEntrypoints.includes(entrypoint)) {
+            add("PKS_MATRIX_REQUIRED_ENTRYPOINT_MISSING", `矩阵缺少生产入口覆盖: ${entrypoint}`);
+        }
+    }
+    return {
+        passed: findings.length === 0,
+        total_cases: cases.length,
+        hard_fail_count: findings.length,
+        findings,
+    };
+}
+//# sourceMappingURL=project_knowledge_system_regression_matrix.js.map