@winspan/claude-forge 3.7.8 → 4.1.0

package/dist/governance/engine.js

@@ -0,0 +1,183 @@
+/**
+ * GovernanceEngine — 统一治理引擎
+ *
+ * 核心职责：
+ * - 管理契约生命周期
+ * - 注册和调度插件
+ * - 协调 Pre/Post 处理
+ * - 维护证据收集
+ */
+import { EvidenceCollector } from './evidence-collector.js';
+import { logger } from '../utils/logger.js';
+export class GovernanceEngine {
+    contracts = new Map(); // sessionId → contract
+    evidenceCollector = new EvidenceCollector();
+    plugins = [];
+    /** 注册插件 */
+    registerPlugin(plugin) {
+        this.plugins.push(plugin);
+        // 按优先级排序
+        this.plugins.sort((a, b) => a.priority - b.priority);
+        logger.info(`[GovernanceEngine] 插件已注册：${plugin.name} (priority=${plugin.priority})`);
+    }
+    /** 加载契约 */
+    loadContract(contract) {
+        this.contracts.set(contract.session_id, contract);
+        this.evidenceCollector.init(contract.id);
+        logger.info(`[GovernanceEngine] 契约已加载：${contract.id} (mode=${contract.execution_mode}, session=${contract.session_id})`);
+    }
+    /** 获取契约 */
+    getContract(sessionId) {
+        return this.contracts.get(sessionId) ?? null;
+    }
+    /** 获取证据 */
+    getEvidence(contractId) {
+        return this.evidenceCollector.get(contractId);
+    }
+    /** PreToolUse 处理 */
+    async handlePreToolUse(event) {
+        const contract = this.contracts.get(event.session_id);
+        if (!contract) {
+            logger.debug(`[GovernanceEngine] 无契约，跳过 PreToolUse 处理`);
+            return null;
+        }
+        // 只处理 governance 模式
+        if (contract.execution_mode !== 'governance') {
+            return null;
+        }
+        const evidence = this.evidenceCollector.get(contract.id);
+        if (!evidence) {
+            logger.warn(`[GovernanceEngine] 证据容器未初始化：${contract.id}`);
+            return null;
+        }
+        const ctx = { contract, evidence, event };
+        const decisions = [];
+        // 执行 PreToolUse 插件链
+        for (const plugin of this.plugins) {
+            if (!plugin.runOnPreTool)
+                continue;
+            try {
+                const result = await plugin.execute(ctx);
+                // 更新证据
+                if (result.evidence_update) {
+                    if (result.evidence_update.knowledge_hits) {
+                        for (const hit of result.evidence_update.knowledge_hits) {
+                            this.evidenceCollector.recordKnowledgeHit(contract.id, hit);
+                        }
+                    }
+                }
+                // 收集决策
+                if (result.decision) {
+                    decisions.push(result.decision);
+                }
+                // 如果插件要求停止，立即返回
+                if (!result.continue) {
+                    logger.info(`[GovernanceEngine] 插件 ${plugin.name} 要求停止，返回决策`);
+                    return result.decision ?? null;
+                }
+            }
+            catch (err) {
+                logger.error(`[GovernanceEngine] 插件 ${plugin.name} 执行失败：${err}`);
+            }
+        }
+        // 合并所有决策
+        return this.mergeDecisions(decisions);
+    }
+    /** PostToolUse 处理 */
+    async handlePostToolUse(event) {
+        const contract = this.contracts.get(event.session_id);
+        if (!contract) {
+            logger.debug(`[GovernanceEngine] 无契约，跳过 PostToolUse 处理`);
+            return null;
+        }
+        // 只处理 governance 模式
+        if (contract.execution_mode !== 'governance') {
+            return null;
+        }
+        const evidence = this.evidenceCollector.get(contract.id);
+        if (!evidence) {
+            logger.warn(`[GovernanceEngine] 证据容器未初始化：${contract.id}`);
+            return null;
+        }
+        // 记录工具事件
+        this.evidenceCollector.recordToolEvent(contract.id, {
+            tool_name: event.tool_name || 'unknown',
+            tool_input: event.tool_input,
+            timestamp: new Date().toISOString(),
+            success: true, // TODO: 从 event 中获取实际状态
+        });
+        const ctx = { contract, evidence, event };
+        const decisions = [];
+        // 执行 PostToolUse 插件链
+        for (const plugin of this.plugins) {
+            if (!plugin.runOnPostTool)
+                continue;
+            try {
+                const result = await plugin.execute(ctx);
+                // 更新证据
+                if (result.evidence_update) {
+                    if (result.evidence_update.verification_results) {
+                        for (const vr of result.evidence_update.verification_results) {
+                            this.evidenceCollector.recordVerification(contract.id, vr);
+                        }
+                    }
+                    if (result.evidence_update.quality_issues) {
+                        for (const qi of result.evidence_update.quality_issues) {
+                            this.evidenceCollector.recordQualityIssue(contract.id, qi);
+                        }
+                    }
+                }
+                // 收集决策
+                if (result.decision) {
+                    decisions.push(result.decision);
+                }
+                // 如果插件要求停止，立即返回
+                if (!result.continue) {
+                    logger.info(`[GovernanceEngine] 插件 ${plugin.name} 要求停止，返回决策`);
+                    return result.decision ?? null;
+                }
+            }
+            catch (err) {
+                logger.error(`[GovernanceEngine] 插件 ${plugin.name} 执行失败：${err}`);
+            }
+        }
+        // 合并所有决策
+        return this.mergeDecisions(decisions);
+    }
+    /** 清理契约 */
+    clearContract(sessionId) {
+        const contract = this.contracts.get(sessionId);
+        if (contract) {
+            this.evidenceCollector.clear(contract.id);
+            this.contracts.delete(sessionId);
+            logger.info(`[GovernanceEngine] 契约已清理：${contract.id}`);
+        }
+    }
+    // ─── 私有辅助方法 ────────────────────────────────────────────────────
+    /** 合并多个决策 */
+    mergeDecisions(decisions) {
+        if (decisions.length === 0)
+            return null;
+        if (decisions.length === 1)
+            return decisions[0];
+        // 优先级：deny > warn > allow
+        const hasDeny = decisions.some(d => d.action === 'deny');
+        const hasWarn = decisions.some(d => d.action === 'warn');
+        const action = hasDeny ? 'deny' : hasWarn ? 'warn' : 'allow';
+        const reasons = decisions.map(d => d.reason).filter(Boolean);
+        const contexts = decisions.map(d => d.inject_context).filter(Boolean);
+        const missingDeliverables = decisions.flatMap(d => d.missing_deliverables ?? []);
+        const qualityFailures = decisions.flatMap(d => d.quality_failures ?? []);
+        const correctiveActions = decisions.flatMap(d => d.corrective_actions ?? []);
+        return {
+            action,
+            reason: reasons.length > 0 ? reasons.join('; ') : undefined,
+            inject_context: contexts.length > 0 ? contexts.join('\n\n') : undefined,
+            missing_deliverables: missingDeliverables.length > 0 ? missingDeliverables : undefined,
+            quality_failures: qualityFailures.length > 0 ? qualityFailures : undefined,
+            corrective_actions: correctiveActions.length > 0 ? correctiveActions : undefined,
+            decided_at: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/governance/engine.js.map

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

package/dist/governance/evidence-collector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * EvidenceCollector — 统一证据收集器
+ *
+ * 收集执行过程中的所有证据：工具事件、产物、验证结果、质量问题、知识命中。
+ * 按 contract_id 隔离，支持查询和统计。
+ */
+import type { GovernanceEvidence, ToolEvent, GovernanceArtifact, GovernanceVerificationResult, QualityIssue, KnowledgeHit } from './types.js';
+export declare class EvidenceCollector {
+    private evidenceMap;
+    /** 初始化一个契约的证据容器 */
+    init(contractId: string): void;
+    /** 获取证据（只读快照） */
+    get(contractId: string): GovernanceEvidence | null;
+    /** 记录工具事件 */
+    recordToolEvent(contractId: string, event: ToolEvent): void;
+    /** 记录产物 */
+    recordArtifact(contractId: string, artifact: GovernanceArtifact): void;
+    /** 记录验证结果 */
+    recordVerification(contractId: string, result: GovernanceVerificationResult): void;
+    /** 记录质量问题 */
+    recordQualityIssue(contractId: string, issue: QualityIssue): void;
+    /** 记录知识命中 */
+    recordKnowledgeHit(contractId: string, hit: KnowledgeHit): void;
+    /** 设置会话摘要 */
+    setSessionSummary(contractId: string, summary: string): void;
+    /** 最近 N 次工具事件 */
+    recentToolEvents(contractId: string, n: number): ToolEvent[];
+    /** 连续失败次数 */
+    consecutiveFailures(contractId: string): number;
+    /** 检测重复失败模式（最近 N 次是否都是同一工具失败） */
+    detectRepetitiveFailure(contractId: string, windowSize?: number): {
+        detected: boolean;
+        tool?: string;
+    };
+    /** 未通过的必需验证项 */
+    failedVerifications(contractId: string): GovernanceVerificationResult[];
+    /** 未解决的质量问题（fail 级别） */
+    openQualityIssues(contractId: string): QualityIssue[];
+    /** 清理契约证据 */
+    clear(contractId: string): void;
+}
+//# sourceMappingURL=evidence-collector.d.ts.map

package/dist/governance/evidence-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-collector.d.ts","sourceRoot":"","sources":["../../src/governance/evidence-collector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,4BAA4B,EAC5B,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAyC;IAE5D,mBAAmB;IACnB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAa9B,iBAAiB;IACjB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAIlD,aAAa;IACb,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAO3D,WAAW;IACX,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAYtE,aAAa;IACb,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,GAAG,IAAI;IAOlF,aAAa;IACb,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAOjE,aAAa;IACb,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI;IAO/D,aAAa;IACb,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAS5D,iBAAiB;IACjB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAM5D,aAAa;IACb,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAW/C,iCAAiC;IACjC,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAYjG,gBAAgB;IAChB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,4BAA4B,EAAE;IAMvE,wBAAwB;IACxB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE;IAMrD,aAAa;IACb,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGhC"}

package/dist/governance/evidence-collector.js

@@ -0,0 +1,136 @@
+/**
+ * EvidenceCollector — 统一证据收集器
+ *
+ * 收集执行过程中的所有证据：工具事件、产物、验证结果、质量问题、知识命中。
+ * 按 contract_id 隔离，支持查询和统计。
+ */
+export class EvidenceCollector {
+    evidenceMap = new Map();
+    /** 初始化一个契约的证据容器 */
+    init(contractId) {
+        if (this.evidenceMap.has(contractId))
+            return;
+        this.evidenceMap.set(contractId, {
+            contract_id: contractId,
+            tool_events: [],
+            artifacts: [],
+            verification_results: [],
+            quality_issues: [],
+            knowledge_hits: [],
+            updated_at: new Date().toISOString(),
+        });
+    }
+    /** 获取证据（只读快照） */
+    get(contractId) {
+        return this.evidenceMap.get(contractId) ?? null;
+    }
+    /** 记录工具事件 */
+    recordToolEvent(contractId, event) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return;
+        evidence.tool_events.push(event);
+        evidence.updated_at = event.timestamp;
+    }
+    /** 记录产物 */
+    recordArtifact(contractId, artifact) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return;
+        const existing = evidence.artifacts.findIndex(a => a.path === artifact.path);
+        if (existing >= 0) {
+            evidence.artifacts[existing] = artifact;
+        }
+        else {
+            evidence.artifacts.push(artifact);
+        }
+        evidence.updated_at = artifact.created_at;
+    }
+    /** 记录验证结果 */
+    recordVerification(contractId, result) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return;
+        evidence.verification_results.push(result);
+        evidence.updated_at = result.verified_at;
+    }
+    /** 记录质量问题 */
+    recordQualityIssue(contractId, issue) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return;
+        evidence.quality_issues.push(issue);
+        evidence.updated_at = issue.detected_at;
+    }
+    /** 记录知识命中 */
+    recordKnowledgeHit(contractId, hit) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return;
+        evidence.knowledge_hits.push(hit);
+        evidence.updated_at = hit.retrieved_at;
+    }
+    /** 设置会话摘要 */
+    setSessionSummary(contractId, summary) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return;
+        evidence.session_summary = summary;
+        evidence.updated_at = new Date().toISOString();
+    }
+    // ─── 查询与统计 ──────────────────────────────────────────────────────
+    /** 最近 N 次工具事件 */
+    recentToolEvents(contractId, n) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return [];
+        return evidence.tool_events.slice(-n);
+    }
+    /** 连续失败次数 */
+    consecutiveFailures(contractId) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return 0;
+        let count = 0;
+        for (let i = evidence.tool_events.length - 1; i >= 0; i--) {
+            if (!evidence.tool_events[i].success)
+                count++;
+            else
+                break;
+        }
+        return count;
+    }
+    /** 检测重复失败模式（最近 N 次是否都是同一工具失败） */
+    detectRepetitiveFailure(contractId, windowSize = 5) {
+        const recent = this.recentToolEvents(contractId, windowSize);
+        if (recent.length < windowSize)
+            return { detected: false };
+        const allFailed = recent.every(e => !e.success);
+        if (!allFailed)
+            return { detected: false };
+        const tools = new Set(recent.map(e => e.tool_name));
+        if (tools.size === 1) {
+            return { detected: true, tool: recent[0].tool_name };
+        }
+        return { detected: true };
+    }
+    /** 未通过的必需验证项 */
+    failedVerifications(contractId) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return [];
+        return evidence.verification_results.filter(r => !r.passed);
+    }
+    /** 未解决的质量问题（fail 级别） */
+    openQualityIssues(contractId) {
+        const evidence = this.evidenceMap.get(contractId);
+        if (!evidence)
+            return [];
+        return evidence.quality_issues.filter(i => i.level === 'fail');
+    }
+    /** 清理契约证据 */
+    clear(contractId) {
+        this.evidenceMap.delete(contractId);
+    }
+}
+//# sourceMappingURL=evidence-collector.js.map

package/dist/governance/evidence-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-collector.js","sourceRoot":"","sources":["../../src/governance/evidence-collector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,OAAO,iBAAiB;IACpB,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE5D,mBAAmB;IACnB,IAAI,CAAC,UAAkB;QACrB,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO;QAC7C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE;YAC/B,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,EAAE;YACb,oBAAoB,EAAE,EAAE;YACxB,cAAc,EAAE,EAAE;YAClB,cAAc,EAAE,EAAE;YAClB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;IACjB,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAClD,CAAC;IAED,aAAa;IACb,eAAe,CAAC,UAAkB,EAAE,KAAgB;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC;IACxC,CAAC;IAED,WAAW;IACX,cAAc,CAAC,UAAkB,EAAE,QAA4B;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7E,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QACD,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IAC5C,CAAC;IAED,aAAa;IACb,kBAAkB,CAAC,UAAkB,EAAE,MAAoC;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,aAAa;IACb,kBAAkB,CAAC,UAAkB,EAAE,KAAmB;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC;IAC1C,CAAC;IAED,aAAa;IACb,kBAAkB,CAAC,UAAkB,EAAE,GAAiB;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC;IACzC,CAAC;IAED,aAAa;IACb,iBAAiB,CAAC,UAAkB,EAAE,OAAe;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC;QACnC,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC;IAED,mEAAmE;IAEnE,iBAAiB;IACjB,gBAAgB,CAAC,UAAkB,EAAE,CAAS;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,aAAa;IACb,mBAAmB,CAAC,UAAkB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QACxB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO;gBAAE,KAAK,EAAE,CAAC;;gBACzC,MAAM;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iCAAiC;IACjC,uBAAuB,CAAC,UAAkB,EAAE,UAAU,GAAG,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,gBAAgB;IAChB,mBAAmB,CAAC,UAAkB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,wBAAwB;IACxB,iBAAiB,CAAC,UAAkB;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IACjE,CAAC;IAED,aAAa;IACb,KAAK,CAAC,UAAkB;QACtB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/governance/plugins/correction-plugin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CorrectionPlugin — 纠偏注入插件
+ *
+ * 在 PostToolUse 阶段检测偏离并注入纠偏建议：
+ * - 连续失败提醒
+ * - 重复失败模式提醒
+ * - 质量问题汇总
+ * - 缺失交付物提醒
+ */
+import type { GovernancePlugin, PluginContext, PluginResult } from '../types.js';
+export declare class CorrectionPlugin implements GovernancePlugin {
+    readonly name = "correction";
+    readonly priority = 20;
+    readonly runOnPreTool = false;
+    readonly runOnPostTool = true;
+    execute(ctx: PluginContext): Promise<PluginResult>;
+    private countConsecutiveFailures;
+    private detectRepetitiveFailure;
+}
+//# sourceMappingURL=correction-plugin.d.ts.map

package/dist/governance/plugins/correction-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-plugin.d.ts","sourceRoot":"","sources":["../../../src/governance/plugins/correction-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGjF,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,QAAQ,MAAM;IACvB,QAAQ,CAAC,YAAY,SAAS;IAC9B,QAAQ,CAAC,aAAa,QAAQ;IAExB,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAmFxD,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,uBAAuB;CAchC"}

package/dist/governance/plugins/correction-plugin.js

@@ -0,0 +1,113 @@
+/**
+ * CorrectionPlugin — 纠偏注入插件
+ *
+ * 在 PostToolUse 阶段检测偏离并注入纠偏建议：
+ * - 连续失败提醒
+ * - 重复失败模式提醒
+ * - 质量问题汇总
+ * - 缺失交付物提醒
+ */
+import { logger } from '../../utils/logger.js';
+export class CorrectionPlugin {
+    name = 'correction';
+    priority = 20; // 在 VerificationPlugin 之后执行
+    runOnPreTool = false;
+    runOnPostTool = true;
+    async execute(ctx) {
+        const { contract, evidence } = ctx;
+        const corrections = [];
+        // 1. 检测连续失败
+        const consecutiveFailures = this.countConsecutiveFailures(evidence.tool_events);
+        if (consecutiveFailures >= 3) {
+            corrections.push(`⚠️ 检测到连续 ${consecutiveFailures} 次工具调用失败，建议：\n` +
+                `1. 检查错误日志\n` +
+                `2. 尝试不同的方法\n` +
+                `3. 或请求用户帮助`);
+            logger.warn(`[CorrectionPlugin] 连续失败 ${consecutiveFailures} 次`);
+        }
+        // 2. 检测重复失败模式
+        const repetitiveFailure = this.detectRepetitiveFailure(evidence.tool_events);
+        if (repetitiveFailure.detected) {
+            corrections.push(`⚠️ 检测到重复失败模式${repetitiveFailure.tool ? `（工具：${repetitiveFailure.tool}）` : ''}，建议换一个思路`);
+            logger.warn(`[CorrectionPlugin] 重复失败模式：${repetitiveFailure.tool || 'unknown'}`);
+        }
+        // 3. 汇总未解决的质量问题
+        const openIssues = evidence.quality_issues.filter(i => i.level === 'fail');
+        if (openIssues.length > 0) {
+            const issueList = openIssues.map(i => `- ${i.category}: ${i.message}`).join('\n');
+            corrections.push(`❌ 未解决的质量问题：\n${issueList}`);
+            logger.info(`[CorrectionPlugin] ${openIssues.length} 个未解决质量问题`);
+        }
+        // 4. 提醒缺失的必需交付物
+        const missingDeliverables = contract.required_deliverables.filter(d => {
+            if (!d.required)
+                return false;
+            if (!d.path_pattern)
+                return false;
+            return !evidence.artifacts.some(a => a.path.includes(d.path_pattern));
+        });
+        if (missingDeliverables.length > 0) {
+            const missing = missingDeliverables.map(d => `- ${d.name}: ${d.description}`).join('\n');
+            corrections.push(`📋 缺失的必需交付物：\n${missing}`);
+            logger.info(`[CorrectionPlugin] ${missingDeliverables.length} 个缺失交付物`);
+        }
+        // 5. 检查升级策略
+        if (contract.escalation_policy) {
+            const { max_consecutive_failures, action } = contract.escalation_policy;
+            if (consecutiveFailures >= max_consecutive_failures) {
+                if (action === 'block') {
+                    return {
+                        continue: false,
+                        decision: {
+                            action: 'deny',
+                            reason: `连续失败 ${consecutiveFailures} 次，已达升级阈值，阻断执行`,
+                            corrective_actions: corrections,
+                            decided_at: new Date().toISOString(),
+                        },
+                    };
+                }
+                else if (action === 'notify') {
+                    corrections.push(`🚨 已达升级阈值（${consecutiveFailures}/${max_consecutive_failures}），建议通知用户`);
+                }
+            }
+        }
+        // 6. 返回纠偏建议
+        if (corrections.length > 0) {
+            return {
+                continue: true,
+                decision: {
+                    action: 'warn',
+                    inject_context: `[Forge 纠偏建议]\n${corrections.join('\n\n')}`,
+                    corrective_actions: corrections,
+                    decided_at: new Date().toISOString(),
+                },
+            };
+        }
+        return { continue: true };
+    }
+    // ─── 辅助方法 ────────────────────────────────────────────────────────
+    countConsecutiveFailures(events) {
+        let count = 0;
+        for (let i = events.length - 1; i >= 0; i--) {
+            if (!events[i].success)
+                count++;
+            else
+                break;
+        }
+        return count;
+    }
+    detectRepetitiveFailure(events, windowSize = 5) {
+        if (events.length < windowSize)
+            return { detected: false };
+        const recent = events.slice(-windowSize);
+        const allFailed = recent.every(e => !e.success);
+        if (!allFailed)
+            return { detected: false };
+        const tools = new Set(recent.map(e => e.tool_name));
+        if (tools.size === 1) {
+            return { detected: true, tool: recent[0].tool_name };
+        }
+        return { detected: true };
+    }
+}
+//# sourceMappingURL=correction-plugin.js.map

package/dist/governance/plugins/correction-plugin.js.map

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

package/dist/governance/plugins/guidance-plugin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * GuidancePlugin — 技能/规范建议插件
+ *
+ * 整合 SkillOrchestrator 和 Convention，在 PreToolUse 阶段注入：
+ * - 技能推荐
+ * - 规范约束提醒
+ */
+import type { GovernancePlugin, PluginContext, PluginResult } from '../types.js';
+import type { SkillOrchestrator } from '../../skill-registry/orchestrator.js';
+import type { ConventionManager } from '../../convention/convention-manager.js';
+export declare class GuidancePlugin implements GovernancePlugin {
+    private skillOrchestrator;
+    private conventionManager;
+    readonly name = "guidance";
+    readonly priority = 30;
+    readonly runOnPreTool = true;
+    readonly runOnPostTool = false;
+    constructor(skillOrchestrator: SkillOrchestrator | null, conventionManager: ConventionManager | null);
+    execute(ctx: PluginContext): Promise<PluginResult>;
+}
+//# sourceMappingURL=guidance-plugin.d.ts.map

package/dist/governance/plugins/guidance-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-plugin.d.ts","sourceRoot":"","sources":["../../../src/governance/plugins/guidance-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAGhF,qBAAa,cAAe,YAAW,gBAAgB;IAOnD,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,iBAAiB;IAP3B,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,MAAM;IACvB,QAAQ,CAAC,YAAY,QAAQ;IAC7B,QAAQ,CAAC,aAAa,SAAS;gBAGrB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,EAC3C,iBAAiB,EAAE,iBAAiB,GAAG,IAAI;IAG/C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAmDzD"}

package/dist/governance/plugins/guidance-plugin.js

@@ -0,0 +1,69 @@
+/**
+ * GuidancePlugin — 技能/规范建议插件
+ *
+ * 整合 SkillOrchestrator 和 Convention，在 PreToolUse 阶段注入：
+ * - 技能推荐
+ * - 规范约束提醒
+ */
+import { logger } from '../../utils/logger.js';
+export class GuidancePlugin {
+    skillOrchestrator;
+    conventionManager;
+    name = 'guidance';
+    priority = 30;
+    runOnPreTool = true;
+    runOnPostTool = false;
+    constructor(skillOrchestrator, conventionManager) {
+        this.skillOrchestrator = skillOrchestrator;
+        this.conventionManager = conventionManager;
+    }
+    async execute(ctx) {
+        const { contract, event } = ctx;
+        const guidanceParts = [];
+        // 1. 技能推荐（基于工具调用模式）
+        if (this.skillOrchestrator) {
+            try {
+                const skillRec = await this.skillOrchestrator.orchestrate(event, undefined, undefined);
+                if (skillRec) {
+                    guidanceParts.push(skillRec);
+                    logger.info(`[GuidancePlugin] 技能推荐已注入`);
+                }
+            }
+            catch (err) {
+                logger.warn(`[GuidancePlugin] 技能推荐失败：${err}`);
+            }
+        }
+        // 2. 契约中的建议技能（显式推荐）
+        if (contract.suggested_skills.length > 0 && ctx.evidence.tool_events.length === 0) {
+            const skills = contract.suggested_skills.map(s => `- ${s}`).join('\n');
+            guidanceParts.push(`[Forge 建议技能]\n${skills}`);
+            logger.info(`[GuidancePlugin] 契约建议技能已注入：${contract.suggested_skills.length} 个`);
+        }
+        // 3. Convention active_prompt（每次注入）
+        if (this.conventionManager) {
+            try {
+                const activePrompt = this.conventionManager.getActivePrompt(contract.project_path);
+                if (activePrompt) {
+                    guidanceParts.push(`[Forge 规范提醒]\n${activePrompt}`);
+                    logger.debug(`[GuidancePlugin] Convention active_prompt 已注入`);
+                }
+            }
+            catch (err) {
+                logger.warn(`[GuidancePlugin] Convention 提示注入失败：${err}`);
+            }
+        }
+        // 4. 返回注入内容
+        if (guidanceParts.length > 0) {
+            return {
+                continue: true,
+                decision: {
+                    action: 'allow',
+                    inject_context: guidanceParts.join('\n\n'),
+                    decided_at: new Date().toISOString(),
+                },
+            };
+        }
+        return { continue: true };
+    }
+}
+//# sourceMappingURL=guidance-plugin.js.map

package/dist/governance/plugins/guidance-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-plugin.js","sourceRoot":"","sources":["../../../src/governance/plugins/guidance-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,OAAO,cAAc;IAOf;IACA;IAPD,IAAI,GAAG,UAAU,CAAC;IAClB,QAAQ,GAAG,EAAE,CAAC;IACd,YAAY,GAAG,IAAI,CAAC;IACpB,aAAa,GAAG,KAAK,CAAC;IAE/B,YACU,iBAA2C,EAC3C,iBAA2C;QAD3C,sBAAiB,GAAjB,iBAAiB,CAA0B;QAC3C,sBAAiB,GAAjB,iBAAiB,CAA0B;IAClD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;QAChC,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,oBAAoB;QACpB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;gBACvF,IAAI,QAAQ,EAAE,CAAC;oBACb,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC7B,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClF,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvE,aAAa,CAAC,IAAI,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,8BAA8B,QAAQ,CAAC,gBAAgB,CAAC,MAAM,IAAI,CAAC,CAAC;QAClF,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACnF,IAAI,YAAY,EAAE,CAAC;oBACjB,aAAa,CAAC,IAAI,CAAC,iBAAiB,YAAY,EAAE,CAAC,CAAC;oBACpD,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,YAAY;QACZ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO;oBACf,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;oBAC1C,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACrC;aACF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;CACF"}