@winspan/claude-forge 3.7.7 → 4.0.0

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

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

@@ -0,0 +1,22 @@
+/**
+ * MemoryPlugin — 历史/知识注入插件
+ *
+ * 整合 KnowledgeGraph 和 ResumeEngine，在 PreToolUse 阶段注入：
+ * - 会话续接摘要
+ * - 相似失败模式提醒
+ * - 历史决策参考
+ */
+import type { GovernancePlugin, PluginContext, PluginResult } from '../types.js';
+import type { KnowledgeGraph } from '../../knowledge/graph.js';
+import type { ResumeEngine } from '../../resume/index.js';
+export declare class MemoryPlugin implements GovernancePlugin {
+    private knowledgeGraph;
+    private resumeEngine;
+    readonly name = "memory";
+    readonly priority = 20;
+    readonly runOnPreTool = true;
+    readonly runOnPostTool = false;
+    constructor(knowledgeGraph: KnowledgeGraph | null, resumeEngine: ResumeEngine | null);
+    execute(ctx: PluginContext): Promise<PluginResult>;
+}
+//# sourceMappingURL=memory-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-plugin.d.ts","sourceRoot":"","sources":["../../../src/governance/plugins/memory-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAgB,MAAM,aAAa,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,qBAAa,YAAa,YAAW,gBAAgB;IAOjD,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY;IAPtB,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,QAAQ,MAAM;IACvB,QAAQ,CAAC,YAAY,QAAQ;IAC7B,QAAQ,CAAC,aAAa,SAAS;gBAGrB,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,YAAY,EAAE,YAAY,GAAG,IAAI;IAGrC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAmGzD"}

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

@@ -0,0 +1,106 @@
+/**
+ * MemoryPlugin — 历史/知识注入插件
+ *
+ * 整合 KnowledgeGraph 和 ResumeEngine，在 PreToolUse 阶段注入：
+ * - 会话续接摘要
+ * - 相似失败模式提醒
+ * - 历史决策参考
+ */
+import { logger } from '../../utils/logger.js';
+export class MemoryPlugin {
+    knowledgeGraph;
+    resumeEngine;
+    name = 'memory';
+    priority = 20;
+    runOnPreTool = true;
+    runOnPostTool = false;
+    constructor(knowledgeGraph, resumeEngine) {
+        this.knowledgeGraph = knowledgeGraph;
+        this.resumeEngine = resumeEngine;
+    }
+    async execute(ctx) {
+        const { contract, evidence, event } = ctx;
+        const memoryParts = [];
+        const knowledgeHits = [];
+        // 1. 会话续接（仅在会话开始时注入一次）
+        if (contract.memory_scope.enable_resume &&
+            this.resumeEngine &&
+            evidence.tool_events.length === 0) {
+            // Resume 已在 session 启动时注入到 CLAUDE.md，这里不重复注入
+            logger.debug('[MemoryPlugin] Resume 已在 CLAUDE.md 中');
+        }
+        // 2. 相似失败模式提醒
+        if (contract.memory_scope.enable_failure_patterns &&
+            this.knowledgeGraph &&
+            event.tool_name &&
+            event.tool_input) {
+            try {
+                const similarFailures = await this.knowledgeGraph.findSimilarFailures(event.tool_name, JSON.stringify(event.tool_input), contract.project_path);
+                if (similarFailures.length > 0) {
+                    const warnings = similarFailures.map(f => `⚠️ ${f.daysAgo} 天前，${f.action} 导致了 ${f.issue}。建议先阅读 ${f.suggestedFile}`);
+                    memoryParts.push(`[Forge 记忆·失败模式]\n${warnings.join('\n')}`);
+                    for (const f of similarFailures) {
+                        knowledgeHits.push({
+                            type: 'similar_failure',
+                            title: f.action,
+                            content: f.issue,
+                            relevance_score: 0.8,
+                            retrieved_at: new Date().toISOString(),
+                        });
+                    }
+                    logger.info(`[MemoryPlugin] 检测到 ${similarFailures.length} 个相似失败模式`);
+                }
+            }
+            catch (err) {
+                logger.warn(`[MemoryPlugin] 失败模式检索失败：${err}`);
+            }
+        }
+        // 3. 历史决策参考（基于需求关键词）
+        if (contract.memory_scope.enable_knowledge &&
+            this.knowledgeGraph &&
+            contract.memory_scope.decision_keywords &&
+            contract.memory_scope.decision_keywords.length > 0) {
+            try {
+                const query = contract.memory_scope.decision_keywords.join(' ');
+                const nodes = this.knowledgeGraph.search(query, contract.project_path, 3);
+                if (nodes.length > 0) {
+                    const decisions = nodes
+                        .filter(n => n.node_type === 'decision')
+                        .map(n => `- ${n.title}: ${n.content.substring(0, 100)}...`);
+                    if (decisions.length > 0) {
+                        memoryParts.push(`[Forge 记忆·历史决策]\n${decisions.join('\n')}`);
+                        for (const node of nodes) {
+                            knowledgeHits.push({
+                                type: 'prior_decision',
+                                title: node.title,
+                                content: node.content,
+                                relevance_score: 0.7,
+                                retrieved_at: new Date().toISOString(),
+                            });
+                        }
+                        logger.info(`[MemoryPlugin] 检索到 ${decisions.length} 条历史决策`);
+                    }
+                }
+            }
+            catch (err) {
+                logger.warn(`[MemoryPlugin] 历史决策检索失败：${err}`);
+            }
+        }
+        // 4. 返回注入内容
+        if (memoryParts.length > 0) {
+            return {
+                continue: true,
+                decision: {
+                    action: 'allow',
+                    inject_context: memoryParts.join('\n\n'),
+                    decided_at: new Date().toISOString(),
+                },
+                evidence_update: {
+                    knowledge_hits: knowledgeHits,
+                },
+            };
+        }
+        return { continue: true };
+    }
+}
+//# sourceMappingURL=memory-plugin.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * PolicyPlugin — 规则校验插件
+ *
+ * 复用 PolicyEngine，在 PreToolUse 阶段执行禁止规则校验
+ */
+import type { GovernancePlugin, PluginContext, PluginResult } from '../types.js';
+export declare class PolicyPlugin implements GovernancePlugin {
+    readonly name = "policy";
+    readonly priority = 10;
+    readonly runOnPreTool = true;
+    readonly runOnPostTool = false;
+    private policyEngine;
+    constructor();
+    execute(ctx: PluginContext): Promise<PluginResult>;
+}
+//# sourceMappingURL=policy-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy-plugin.d.ts","sourceRoot":"","sources":["../../../src/governance/plugins/policy-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIjF,qBAAa,YAAa,YAAW,gBAAgB;IACnD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,QAAQ,MAAM;IACvB,QAAQ,CAAC,YAAY,QAAQ;IAC7B,QAAQ,CAAC,aAAa,SAAS;IAE/B,OAAO,CAAC,YAAY,CAAe;;IAM7B,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA0DzD"}

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

@@ -0,0 +1,69 @@
+/**
+ * PolicyPlugin — 规则校验插件
+ *
+ * 复用 PolicyEngine，在 PreToolUse 阶段执行禁止规则校验
+ */
+import { PolicyEngine } from '../../orchestration/policy-engine.js';
+import { logger } from '../../utils/logger.js';
+export class PolicyPlugin {
+    name = 'policy';
+    priority = 10; // 最高优先级，先执行
+    runOnPreTool = true;
+    runOnPostTool = false;
+    policyEngine;
+    constructor() {
+        this.policyEngine = new PolicyEngine();
+    }
+    async execute(ctx) {
+        // 1. 执行内置规则校验
+        const builtinDecision = this.policyEngine.evaluate(ctx.event);
+        if (builtinDecision && !builtinDecision.allow) {
+            logger.warn(`[PolicyPlugin] 内置规则拦截：${builtinDecision.reason}`);
+            return {
+                continue: false,
+                decision: {
+                    action: 'deny',
+                    reason: builtinDecision.reason,
+                    decided_at: new Date().toISOString(),
+                },
+            };
+        }
+        // 2. 执行契约中的禁止规则
+        for (const rule of ctx.contract.forbidden_rules) {
+            const toolName = ctx.event.tool_name || '';
+            const inputStr = ctx.event.tool_input ? JSON.stringify(ctx.event.tool_input) : '';
+            // 匹配工具名
+            if (rule.tool && !new RegExp(rule.tool, 'i').test(toolName)) {
+                continue;
+            }
+            // 匹配 input 内容
+            if (rule.pattern && !new RegExp(rule.pattern, 'i').test(inputStr)) {
+                continue;
+            }
+            logger.info(`[PolicyPlugin] 契约规则匹配：${rule.name} (${rule.action})`);
+            if (rule.action === 'deny') {
+                return {
+                    continue: false,
+                    decision: {
+                        action: 'deny',
+                        reason: `[规则 ${rule.id}·${rule.name}] ${rule.reason}`,
+                        decided_at: new Date().toISOString(),
+                    },
+                };
+            }
+            if (rule.action === 'warn') {
+                return {
+                    continue: true,
+                    decision: {
+                        action: 'warn',
+                        inject_context: `[规则 ${rule.id}·${rule.name}] ${rule.context || rule.reason}`,
+                        decided_at: new Date().toISOString(),
+                    },
+                };
+            }
+        }
+        // 3. 无匹配规则，放行
+        return { continue: true };
+    }
+}
+//# sourceMappingURL=policy-plugin.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * VerificationPlugin — 交付物验证插件
+ *
+ * 复用 CompletionVerifier，在 PostToolUse 阶段执行确定性验证
+ */
+import type { GovernancePlugin, PluginContext, PluginResult } from '../types.js';
+export declare class VerificationPlugin implements GovernancePlugin {
+    readonly name = "verification";
+    readonly priority = 10;
+    readonly runOnPreTool = false;
+    readonly runOnPostTool = true;
+    private verifier;
+    execute(ctx: PluginContext): Promise<PluginResult>;
+}
+//# sourceMappingURL=verification-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verification-plugin.d.ts","sourceRoot":"","sources":["../../../src/governance/plugins/verification-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAgC,MAAM,aAAa,CAAC;AAI/G,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,QAAQ,MAAM;IACvB,QAAQ,CAAC,YAAY,SAAS;IAC9B,QAAQ,CAAC,aAAa,QAAQ;IAE9B,OAAO,CAAC,QAAQ,CAA4B;IAEtC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA6DzD"}

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

@@ -0,0 +1,65 @@
+/**
+ * VerificationPlugin — 交付物验证插件
+ *
+ * 复用 CompletionVerifier，在 PostToolUse 阶段执行确定性验证
+ */
+import { CompletionVerifier } from '../../pipeline/completion-verifier.js';
+import { logger } from '../../utils/logger.js';
+export class VerificationPlugin {
+    name = 'verification';
+    priority = 10; // PostToolUse 阶段优先执行
+    runOnPreTool = false;
+    runOnPostTool = true;
+    verifier = new CompletionVerifier();
+    async execute(ctx) {
+        const { contract, evidence } = ctx;
+        // 只在有验证规则时执行
+        if (contract.verification_rules.length === 0) {
+            return { continue: true };
+        }
+        // 执行验证
+        try {
+            const result = await this.verifier.verify(contract.verification_rules, contract.project_path, {
+                // 传入已追踪的产物路径
+                trackedPaths: evidence.artifacts.map(a => a.path),
+            });
+            // 记录验证结果
+            const verificationResults = result.rule_results.map(r => ({
+                rule_id: r.rule.description || 'unknown',
+                rule_type: r.rule.type,
+                passed: r.passed,
+                error: r.error,
+                details: r.details,
+                verified_at: new Date().toISOString(),
+            }));
+            logger.info(`[VerificationPlugin] 验证完成：${result.passed ? '通过' : '失败'} (${result.rule_results.length} 条规则)`);
+            // 如果验证失败，返回纠偏建议
+            if (!result.passed) {
+                return {
+                    continue: true,
+                    decision: {
+                        action: 'warn',
+                        missing_deliverables: result.missing_items,
+                        inject_context: `[Forge 验证失败]\n${result.diagnostics}`,
+                        decided_at: new Date().toISOString(),
+                    },
+                    evidence_update: {
+                        verification_results: verificationResults,
+                    },
+                };
+            }
+            // 验证通过
+            return {
+                continue: true,
+                evidence_update: {
+                    verification_results: verificationResults,
+                },
+            };
+        }
+        catch (err) {
+            logger.error(`[VerificationPlugin] 验证执行失败：${err}`);
+            return { continue: true };
+        }
+    }
+}
+//# sourceMappingURL=verification-plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verification-plugin.js","sourceRoot":"","sources":["../../../src/governance/plugins/verification-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,cAAc,CAAC;IACtB,QAAQ,GAAG,EAAE,CAAC,CAAC,qBAAqB;IACpC,YAAY,GAAG,KAAK,CAAC;IACrB,aAAa,GAAG,IAAI,CAAC;IAEtB,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAE5C,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;QAEnC,aAAa;QACb,IAAI,QAAQ,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO;QACP,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CACvC,QAAQ,CAAC,kBAAkB,EAC3B,QAAQ,CAAC,YAAY,EACrB;gBACE,aAAa;gBACb,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClD,CACF,CAAC;YAEF,SAAS;YACT,MAAM,mBAAmB,GAAmC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxF,OAAO,EAAG,CAAC,CAAC,IAAY,CAAC,WAAW,IAAI,SAAS;gBACjD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC,CAAC;YAEJ,MAAM,CAAC,IAAI,CACT,6BAA6B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,YAAY,CAAC,MAAM,OAAO,CAC/F,CAAC;YAEF,gBAAgB;YAChB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE;wBACR,MAAM,EAAE,MAAM;wBACd,oBAAoB,EAAE,MAAM,CAAC,aAAa;wBAC1C,cAAc,EAAE,iBAAiB,MAAM,CAAC,WAAW,EAAE;wBACrD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACrC;oBACD,eAAe,EAAE;wBACf,oBAAoB,EAAE,mBAAmB;qBAC1C;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;YACP,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,eAAe,EAAE;oBACf,oBAAoB,EAAE,mBAAmB;iBAC1C;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}