soloforge 1.1.45 → 1.1.46

package/dist/verify/contracts/mechanism_contract_registry/index.js

@@ -1,21 +0,0 @@
-/**
- * Mechanism Contract Registry — P0 自治理契约。
- *
- * 主管线上的每个 P0 机制都在此注册，包含精确的输入、输出、
- * 失败模式和测试锚点，以便 validateMechanismContracts() 强制执行结构不变量。
- *
- * 模块拆分：
- *   - types.ts              类型定义
- *   - contracts-pipeline.ts  核心管线机制契约
- *   - contracts-platform.ts  平台与扩展机制契约
- *   - contracts-governance.ts 治理与安全机制契约
- *   - contracts-audit.ts     审计与管线架构机制契约
- *   - validation.ts          查询函数与治理验证
- */
-// ── P0 契约列表 ──
-export { P0_MECHANISM_CONTRACTS } from "./validation.js";
-// ── 查询函数 ──
-export { listMechanismContracts, findMechanismContractById, listMechanismContractsByStatus, } from "./validation.js";
-// ── 治理验证 ──
-export { validateMechanismContracts } from "./validation.js";
-//# sourceMappingURL=index.js.map

package/dist/verify/contracts/mechanism_contract_registry/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/verify/contracts/mechanism_contract_registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,gBAAgB;AAChB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,aAAa;AACb,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/verify/contracts/mechanism_contract_registry/types.d.ts

@@ -1,33 +0,0 @@
-/**
- * Mechanism Contract Registry — 类型定义。
- */
-export type MechanismType = "routing" | "classification" | "expansion" | "knowledge_matching" | "state_lifecycle" | "planning" | "verification" | "review" | "analysis" | "scaffolding" | "delivery" | "learning" | "governance" | "safety" | "observability" | "initialization" | "feedback" | "artifact_management" | "contract_enforcement" | "access_control";
-export type MechanismStatus = "enforced" | "advisory" | "experimental" | "deprecated";
-export interface MechanismContract {
-    id: string;
-    name: string;
-    owner_module: string;
-    owner_files?: string[];
-    owner_exports?: string[];
-    mechanism_type: MechanismType;
-    status: MechanismStatus;
-    trigger: string;
-    required_inputs: string[];
-    preconditions: string[];
-    outputs: string[];
-    downstream_consumers: string[];
-    state_transitions?: string[];
-    cleanup_hooks?: string[];
-    failure_modes: string[];
-    degradation_behavior: string;
-    tests: string[];
-    lifecycle_tests: string[];
-    notes?: string;
-}
-export interface MechanismGovernanceFinding {
-    severity: "hard_fail" | "advisory";
-    contract_id: string;
-    field: string;
-    message: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/verify/contracts/mechanism_contract_registry/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/verify/contracts/mechanism_contract_registry/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,oBAAoB,GACpB,iBAAiB,GACjB,UAAU,GACV,cAAc,GACd,QAAQ,GACR,UAAU,GACV,aAAa,GACb,UAAU,GACV,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,eAAe,GACf,gBAAgB,GAChB,UAAU,GACV,qBAAqB,GACrB,sBAAsB,GACtB,gBAAgB,CAAC;AAErB,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,UAAU,GACV,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,aAAa,CAAC;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,WAAW,GAAG,UAAU,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/verify/contracts/mechanism_contract_registry/types.js

@@ -1,5 +0,0 @@
-/**
- * Mechanism Contract Registry — 类型定义。
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/verify/contracts/mechanism_contract_registry/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/verify/contracts/mechanism_contract_registry/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/verify/contracts/mechanism_contract_registry/validation.d.ts

@@ -1,38 +0,0 @@
-/**
- * Validation — 契约层模块。
- *
- * 职责边界：
- * - 负责：P0_MECHANISM_CONTRACTS 等 契约层职责
- * - 不负责：不属于本模块的职责由对应模块承担
- *
- * 被谁调用：契约验证、注册表查询
- * 调用谁：node:fs、node:path、types、contracts-pipeline、contracts-platform、contracts-governance
- *
- * 数据流：契约定义 → 验证逻辑 → 通过/拒绝结果
- * 持久化：读写本地文件（详见代码内路径）
- */
-import type { MechanismContract, MechanismGovernanceFinding, MechanismStatus } from "./types.js";
-/** P0 级机制契约列表 */
-export declare const P0_MECHANISM_CONTRACTS: MechanismContract[];
-/**
- * 执行 listMechanismContracts 操作
- */
-export declare function listMechanismContracts(): MechanismContract[];
-/**
- * 根据契约 ID 查找机制契约。
- * @param id - 机制契约 ID
- * @returns 匹配的机制契约，未找到时返回 undefined
- */
-export declare function findMechanismContractById(id: string): MechanismContract | undefined;
-/**
- * 执行 listMechanismContractsByStatus 操作
- */
-export declare function listMechanismContractsByStatus(status: MechanismStatus): MechanismContract[];
-/**
- * 校验机制契约的结构完整性和一致性。
- * @param contracts - 待校验的契约列表，默认使用内置 P0 契约
- * @param rootDir - 项目根目录，默认为当前工作目录
- * @returns 治理发现列表（hard_fail 为硬性错误，advisory 为建议项）
- */
-export declare function validateMechanismContracts(contracts?: MechanismContract[], rootDir?: string): MechanismGovernanceFinding[];
-//# sourceMappingURL=validation.d.ts.map

package/dist/verify/contracts/mechanism_contract_registry/validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/verify/contracts/mechanism_contract_registry/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQjG,iBAAiB;AACjB,eAAO,MAAM,sBAAsB,EAAE,iBAAiB,EAKrD,CAAC;AAIF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,EAAE,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEnF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAE3F;AAID;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,iBAAiB,EAA2B,EACvD,OAAO,GAAE,MAAsB,GAC9B,0BAA0B,EAAE,CAgG9B"}

package/dist/verify/contracts/mechanism_contract_registry/validation.js

@@ -1,136 +0,0 @@
-/**
- * Validation — 契约层模块。
- *
- * 职责边界：
- * - 负责：P0_MECHANISM_CONTRACTS 等 契约层职责
- * - 不负责：不属于本模块的职责由对应模块承担
- *
- * 被谁调用：契约验证、注册表查询
- * 调用谁：node:fs、node:path、types、contracts-pipeline、contracts-platform、contracts-governance
- *
- * 数据流：契约定义 → 验证逻辑 → 通过/拒绝结果
- * 持久化：读写本地文件（详见代码内路径）
- */
-import fs from "node:fs";
-import path from "node:path";
-import { PIPELINE_CONTRACTS } from "./contracts-pipeline.js";
-import { PLATFORM_CONTRACTS } from "./contracts-platform.js";
-import { GOVERNANCE_CONTRACTS } from "./contracts-governance.js";
-import { AUDIT_CONTRACTS } from "./contracts-audit.js";
-// ── 聚合 P0 契约 ──
-/** P0 级机制契约列表 */
-export const P0_MECHANISM_CONTRACTS = [
-    ...PIPELINE_CONTRACTS,
-    ...PLATFORM_CONTRACTS,
-    ...GOVERNANCE_CONTRACTS,
-    ...AUDIT_CONTRACTS,
-];
-// ── 查询函数 ──
-/**
- * 执行 listMechanismContracts 操作
- */
-export function listMechanismContracts() {
-    return P0_MECHANISM_CONTRACTS;
-}
-/**
- * 根据契约 ID 查找机制契约。
- * @param id - 机制契约 ID
- * @returns 匹配的机制契约，未找到时返回 undefined
- */
-export function findMechanismContractById(id) {
-    return P0_MECHANISM_CONTRACTS.find((c) => c.id === id);
-}
-/**
- * 执行 listMechanismContractsByStatus 操作
- */
-export function listMechanismContractsByStatus(status) {
-    return P0_MECHANISM_CONTRACTS.filter((c) => c.status === status);
-}
-// ── 治理验证 ──
-/**
- * 校验机制契约的结构完整性和一致性。
- * @param contracts - 待校验的契约列表，默认使用内置 P0 契约
- * @param rootDir - 项目根目录，默认为当前工作目录
- * @returns 治理发现列表（hard_fail 为硬性错误，advisory 为建议项）
- */
-export function validateMechanismContracts(contracts = P0_MECHANISM_CONTRACTS, rootDir = process.cwd()) {
-    const findings = [];
-    const seenIds = new Set();
-    for (const c of contracts) {
-        // 重复 id
-        if (seenIds.has(c.id)) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "id", message: `Duplicate id: ${c.id}` });
-        }
-        seenIds.add(c.id);
-        // owner_module 文件存在性（deprecated 机制跳过）
-        if (c.status !== "deprecated" && !fs.existsSync(path.join(rootDir, c.owner_module))) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "owner_module", message: `Module not found: ${c.owner_module}` });
-        }
-        // owner_exports 验证：每个导出必须在模块文件中存在（deprecated 机制跳过）
-        if (c.status !== "deprecated" && c.owner_exports?.length && fs.existsSync(path.join(rootDir, c.owner_module))) {
-            const moduleContent = fs.readFileSync(path.join(rootDir, c.owner_module), "utf-8");
-            for (const exp of c.owner_exports) {
-                if (!moduleContent.includes(exp)) {
-                    findings.push({ severity: "hard_fail", contract_id: c.id, field: "owner_exports", message: `Export not found in module: ${exp}` });
-                }
-            }
-        }
-        // enforced 状态必须有 lifecycle_tests
-        if (c.status === "enforced" && c.lifecycle_tests.length === 0) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "lifecycle_tests", message: "Enforced mechanism must have lifecycle_tests" });
-        }
-        // 测试文件存在性（deprecated 机制跳过）
-        if (c.status !== "deprecated") {
-            for (const t of c.tests) {
-                if (!fs.existsSync(path.join(rootDir, t))) {
-                    findings.push({ severity: "hard_fail", contract_id: c.id, field: "tests", message: `Test file not found: ${t}` });
-                }
-            }
-            // lifecycle_tests 文件存在性
-            for (const t of c.lifecycle_tests) {
-                if (!fs.existsSync(path.join(rootDir, t))) {
-                    findings.push({ severity: "hard_fail", contract_id: c.id, field: "lifecycle_tests", message: `Lifecycle test file not found: ${t}` });
-                }
-            }
-        }
-        // required_inputs 非空（deprecated 机制跳过，已删除模块字段可能为空）
-        if (c.status !== "deprecated" && c.required_inputs.length === 0) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "required_inputs", message: "required_inputs must not be empty" });
-        }
-        // outputs 非空（deprecated 机制跳过）
-        if (c.status !== "deprecated" && c.outputs.length === 0) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "outputs", message: "outputs must not be empty" });
-        }
-        // downstream_consumers 非空（deprecated 机制跳过）
-        if (c.status !== "deprecated" && c.downstream_consumers.length === 0) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "downstream_consumers", message: "downstream_consumers must not be empty" });
-        }
-        // state_lifecycle 必须有 state_transitions
-        if (c.mechanism_type === "state_lifecycle" && (!c.state_transitions || c.state_transitions.length === 0)) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "state_transitions", message: "state_lifecycle mechanism must have state_transitions" });
-        }
-        // 有 cleanup_hooks 但无 lifecycle_tests
-        if (c.cleanup_hooks && c.cleanup_hooks.length > 0 && c.lifecycle_tests.length === 0) {
-            findings.push({ severity: "hard_fail", contract_id: c.id, field: "lifecycle_tests", message: "Mechanism with cleanup_hooks must have lifecycle_tests" });
-        }
-        // ── 建议性检查 ──
-        // failure_modes 为空
-        if (c.failure_modes.length === 0) {
-            findings.push({ severity: "advisory", contract_id: c.id, field: "failure_modes", message: "failure_modes is empty" });
-        }
-        // degradation_behavior 为空或过短
-        if (!c.degradation_behavior || c.degradation_behavior.length < 10) {
-            findings.push({ severity: "advisory", contract_id: c.id, field: "degradation_behavior", message: "degradation_behavior is empty or too short" });
-        }
-        // 通用 downstream_consumers
-        if (c.downstream_consumers.includes("unknown")) {
-            findings.push({ severity: "advisory", contract_id: c.id, field: "downstream_consumers", message: "downstream_consumers contains generic 'unknown'" });
-        }
-        // 已废弃但无 notes
-        if (c.status === "deprecated" && !c.notes) {
-            findings.push({ severity: "advisory", contract_id: c.id, field: "notes", message: "Deprecated mechanism must have notes explaining removal" });
-        }
-    }
-    return findings;
-}
-//# sourceMappingURL=validation.js.map

package/dist/verify/contracts/mechanism_contract_registry/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/verify/contracts/mechanism_contract_registry/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,iBAAiB;AAEjB,iBAAiB;AACjB,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,GAAG,kBAAkB;IACrB,GAAG,kBAAkB;IACrB,GAAG,oBAAoB;IACvB,GAAG,eAAe;CACnB,CAAC;AAEF,aAAa;AAEb;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAU;IAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAuB;IACpE,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACnE,CAAC;AAED,aAAa;AAEb;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAAiC,sBAAsB,EACvD,UAAkB,OAAO,CAAC,GAAG,EAAE;IAE/B,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,QAAQ;QACR,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7G,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAElB,sCAAsC;QACtC,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACrI,CAAC;QAED,mDAAmD;QACnD,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,CAAC,aAAa,EAAE,MAAM,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YAC9G,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;YACnF,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;gBAClC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,+BAA+B,GAAG,EAAE,EAAE,CAAC,CAAC;gBACrI,CAAC;YACH,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC,CAAC;QACjJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpH,CAAC;YACH,CAAC;YAED,wBAAwB;YACxB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;gBAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,kCAAkC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxI,CAAC;YACH,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;QACtI,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;QACtH,CAAC;QAED,2CAA2C;QAC3C,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC,CAAC;QAChJ,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,CAAC,cAAc,KAAK,iBAAiB,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACzG,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAAC;QAC5J,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC,CAAC;QAC3J,CAAC;QAED,cAAc;QAEd,mBAAmB;QACnB,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACxH,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC,oBAAoB,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC,CAAC;QACnJ,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC,CAAC;QACxJ,CAAC;QAED,cAAc;QACd,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC,CAAC;QACjJ,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/templates/shared/LLM/351/242/204/347/256/227/347/275/221/345/205/263.md

@@ -1,54 +0,0 @@
----
-id: ka-pattern-llm_gateway
-kind: knowledge
-title: LLM预算网关
-sync_policy: internal
-status: active
-extra:
-  name: llm_gateway
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- H1 handler 返回 h1_advisory warning，任务仍继续进入 executing
-- 预算耗尽是 warning 不是 hard fail，不应阻断任务
-- heartbeat 机制定期检查预算使用率
-- 预算耗尽时建议降级到更便宜的模型（advisory 报告）
-
-## 验收项
-
-- [AC-01] H1 handler 返回 advisory 不阻断
-- [AC-02] heartbeat 正常触发
-- [AC-03] 预算超限产生 warning
-- [AC-04] 预算使用率可观测
-
-## 何时使用
-
-advisory: 预算耗尽是 warning 不是 hard fail，不应阻断任务
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- H1/H4 handler 测试通过
-- heartbeat 测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//346/265/201/345/274/217/345/277/203/350/267/263.md

@@ -1,64 +0,0 @@
----
-id: ka-pattern-streaming_protocol
-kind: knowledge
-title: 流式心跳
-sync_policy: internal
-status: active
-extra:
-  name: streaming_protocol
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 重型 AI 操作（tier=heavy）执行期间必须启动流式心跳
-- 心跳间隔 Heartbeat_Interval = 5000 毫秒
-- 心跳通过 stdio 输出，格式: [SoloForge Heartbeat] {操作描述} 执行中... 已耗时 {N}s，当前任务已用 {M}/{T} Token
-- 心跳包含字段: elapsed_ms, tokens_used, operation, message
-- 轻量/中型操作（light/medium）不触发心跳
-- 操作完成后调用 completeOperation() 停止心跳
-- 重型操作定义: estimated_tokens > 3000（code_generation/solution_brainstorm/verification_reasoning/review_deep_analysis）
-
-## 验收项
-
-- [AC-01] 重型操作启动后 5 秒内首次心跳输出
-- [AC-02] 心跳消息包含操作名称、耗时、Token 用量
-- [AC-03] completeOperation() 调用后心跳立即停止
-- [AC-04] 中型操作（test_generation/debug_analysis）不产生心跳
-- [AC-05] 心跳回调通过 setHeartbeatCallback() 注册
-
-## 格式规范
-
-```text
-[SoloForge Heartbeat] 代码生成 执行中... 已耗时 10s，当前任务已用 5000/30000 Token
-```
-
-## 何时使用
-
-advisory: 预算耗尽是 warning 不是 hard fail，不应阻断任务
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- H1/H4 handler 测试通过
-- heartbeat 测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 治理运行时 + 人工确认