@winspan/claude-forge 3.7.8 → 4.1.0

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

package/dist/governance/types.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Governance Framework - 统一治理框架类型定义
+ *
+ * 核心理念：声明式治理，而非命令式控制
+ * - Contract: 明确要做什么、不能做什么、交付标准
+ * - Evidence: 收集执行证据（工具、产物、质量）
+ * - Decision: 基于证据做出治理决策（允许/警告/拒绝）
+ */
+import type { ForgeEvent } from '../types/index.js';
+import type { QualityStandard } from '../convention/types.js';
+import type { CompletionRule } from '../pipeline/completion-verifier.js';
+import type { PolicyRule } from '../orchestration/policy-engine.js';
+/** 执行模式：governance（新治理路径）或 pipeline（旧 Pipeline 路径） */
+export type ExecutionMode = 'governance' | 'pipeline';
+/** 禁止规则（从 PolicyRule 扩展） */
+export interface ForbiddenRule extends PolicyRule {
+    /** 规则来源（convention/user/builtin） */
+    source?: string;
+}
+/** 交付物定义 */
+export interface Deliverable {
+    /** 交付物名称 */
+    name: string;
+    /** 交付物描述 */
+    description: string;
+    /** 文件路径模式（glob） */
+    path_pattern?: string;
+    /** 是否必需 */
+    required: boolean;
+    /** 验证规则 */
+    verification?: CompletionRule;
+}
+/** 记忆范围配置 */
+export interface MemoryScope {
+    /** 是否启用历史续接 */
+    enable_resume: boolean;
+    /** 是否启用知识图谱检索 */
+    enable_knowledge: boolean;
+    /** 是否启用相似失败模式提醒 */
+    enable_failure_patterns: boolean;
+    /** 历史决策查询关键词 */
+    decision_keywords?: string[];
+}
+/** 升级策略（连续失败、长时间无产出时的处理） */
+export interface EscalationPolicy {
+    /** 连续失败多少次后升级 */
+    max_consecutive_failures: number;
+    /** 无产出超时（分钟） */
+    no_output_timeout_minutes: number;
+    /** 升级动作：warn（警告）/ block（阻断）/ notify（通知用户） */
+    action: 'warn' | 'block' | 'notify';
+}
+/**
+ * 治理契约 - 一次任务/会话的唯一治理输入
+ *
+ * 不规定执行顺序，只声明边界与完成标准
+ */
+export interface GovernanceContract {
+    /** 契约 ID */
+    id: string;
+    /** 用户需求 */
+    requirement: string;
+    /** 项目路径 */
+    project_path: string;
+    /** 会话 ID */
+    session_id: string;
+    /** 执行模式 */
+    execution_mode: ExecutionMode;
+    /** 禁止规则（deny/warn） */
+    forbidden_rules: ForbiddenRule[];
+    /** 必需交付物 */
+    required_deliverables: Deliverable[];
+    /** 验证规则（artifact/command/manual） */
+    verification_rules: CompletionRule[];
+    /** 质量标准（从 Convention 编译） */
+    quality_standards: QualityStandard[];
+    /** 建议技能 */
+    suggested_skills: string[];
+    /** 记忆范围 */
+    memory_scope: MemoryScope;
+    /** 升级策略 */
+    escalation_policy?: EscalationPolicy;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+}
+/** 工具事件记录 */
+export interface ToolEvent {
+    tool_name: string;
+    tool_input: unknown;
+    timestamp: string;
+    success: boolean;
+    error?: string;
+}
+/** 产物记录（治理层） */
+export interface GovernanceArtifact {
+    type: string;
+    path: string;
+    size_bytes?: number;
+    created_at: string;
+    content_preview?: string;
+}
+/** 验证结果（治理层） */
+export interface GovernanceVerificationResult {
+    rule_id: string;
+    rule_type: 'artifact' | 'command' | 'manual';
+    passed: boolean;
+    error?: string;
+    details?: string;
+    verified_at: string;
+}
+/** 质量问题 */
+export interface QualityIssue {
+    category: 'spec' | 'security' | 'quality' | 'test' | 'performance';
+    level: 'pass' | 'warn' | 'fail';
+    message: string;
+    suggestion?: string;
+    file_path?: string;
+    detected_at: string;
+}
+/** 知识命中记录 */
+export interface KnowledgeHit {
+    type: 'similar_failure' | 'prior_decision' | 'successful_path';
+    title: string;
+    content: string;
+    relevance_score: number;
+    retrieved_at: string;
+}
+/**
+ * 治理证据 - 执行过程中收集的所有证据
+ *
+ * 所有"是否合格/是否完成"的判断都基于证据
+ */
+export interface GovernanceEvidence {
+    contract_id: string;
+    tool_events: ToolEvent[];
+    artifacts: GovernanceArtifact[];
+    verification_results: GovernanceVerificationResult[];
+    quality_issues: QualityIssue[];
+    knowledge_hits: KnowledgeHit[];
+    /** 会话摘要（Resume 生成） */
+    session_summary?: string;
+    /** 最后更新时间 */
+    updated_at: string;
+}
+/** 治理决策动作 */
+export type GovernanceAction = 'allow' | 'warn' | 'deny';
+/**
+ * 治理决策 - 基于契约和证据做出的决策
+ *
+ * 用于 PreToolUse（拦截）和 PostToolUse（纠偏）
+ */
+export interface GovernanceDecision {
+    /** 决策动作 */
+    action: GovernanceAction;
+    /** 决策原因 */
+    reason?: string;
+    /** 注入上下文（技能建议、历史提醒、规范约束） */
+    inject_context?: string;
+    /** 缺失的交付物列表 */
+    missing_deliverables?: string[];
+    /** 质量失败列表 */
+    quality_failures?: string[];
+    /** 纠偏动作建议 */
+    corrective_actions?: string[];
+    /** 决策时间 */
+    decided_at: string;
+}
+/** 插件执行上下文 */
+export interface PluginContext {
+    contract: GovernanceContract;
+    evidence: GovernanceEvidence;
+    event: ForgeEvent;
+}
+/** 插件执行结果 */
+export interface PluginResult {
+    /** 是否继续执行后续插件 */
+    continue: boolean;
+    /** 决策（如果插件做出了决策） */
+    decision?: GovernanceDecision;
+    /** 更新证据（如果插件收集了新证据） */
+    evidence_update?: Partial<GovernanceEvidence>;
+}
+/**
+ * 治理插件接口
+ *
+ * 所有治理逻辑通过插件实现，保持核心引擎简洁
+ */
+export interface GovernancePlugin {
+    /** 插件名称 */
+    readonly name: string;
+    /** 插件优先级（数值越小越优先） */
+    readonly priority: number;
+    /** 是否在 PreToolUse 阶段执行 */
+    readonly runOnPreTool: boolean;
+    /** 是否在 PostToolUse 阶段执行 */
+    readonly runOnPostTool: boolean;
+    /** 执行插件逻辑 */
+    execute(ctx: PluginContext): Promise<PluginResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/governance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAMpE,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,UAAU,CAAC;AAEtD,4BAA4B;AAC5B,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW;IACX,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED,aAAa;AACb,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB;IACnB,uBAAuB,EAAE,OAAO,CAAC;IACjC,gBAAgB;IAChB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,gBAAgB;IAChB,yBAAyB,EAAE,MAAM,CAAC;IAClC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,cAAc,EAAE,aAAa,CAAC;IAC9B,sBAAsB;IACtB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,YAAY;IACZ,qBAAqB,EAAE,WAAW,EAAE,CAAC;IACrC,oCAAoC;IACpC,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,4BAA4B;IAC5B,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,WAAW;IACX,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW;IACX,YAAY,EAAE,WAAW,CAAC;IAC1B,WAAW;IACX,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gBAAgB;AAChB,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;IACnE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,oBAAoB,EAAE,4BAA4B,EAAE,CAAC;IACrD,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,sBAAsB;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,aAAa;AACb,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa;IACb,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa;IACb,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,uBAAuB;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,aAAa;IACb,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpD"}

package/dist/governance/types.js

@@ -0,0 +1,10 @@
+/**
+ * Governance Framework - 统一治理框架类型定义
+ *
+ * 核心理念：声明式治理，而非命令式控制
+ * - Contract: 明确要做什么、不能做什么、交付标准
+ * - Evidence: 收集执行证据（工具、产物、质量）
+ * - Decision: 基于证据做出治理决策（允许/警告/拒绝）
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/governance/types.js.map

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

package/dist/pipeline/completion-engine.js

@@ -40,8 +40,8 @@ export class CompletionEngine {
         }
         // 第一层：精准检测
         let hasExplicitSignal = false;
-        if (nodeType.completion.explicit_signal) {
-            if (this.detector.detectExplicitSignal(event, nodeType.completion.explicit_signal)) {
+        if (nodeType.completion?.explicit_signal) {
+            if (this.detector.detectExplicitSignal(event, nodeType.completion?.explicit_signal)) {
                 hasExplicitSignal = true;
                 reasons.push('显式信号');
                 confidence += 40;
@@ -69,14 +69,14 @@ export class CompletionEngine {
             };
         }
         // 无必需产物的节点：保留原有推断逻辑
-        if (nodeType.completion.heuristic?.keywords) {
-            if (this.detector.detectKeywords(event, nodeType.completion.heuristic.keywords)) {
+        if (nodeType.completion?.heuristic?.keywords) {
+            if (this.detector.detectKeywords(event, nodeType.completion?.heuristic?.keywords)) {
                 reasons.push('关键词匹配');
                 confidence += 30;
             }
         }
-        if (nodeType.completion.heuristic?.file_patterns) {
-            if (this.detector.detectFilePatterns(event, nodeType.completion.heuristic.file_patterns)) {
+        if (nodeType.completion?.heuristic?.file_patterns) {
+            if (this.detector.detectFilePatterns(event, nodeType.completion?.heuristic?.file_patterns)) {
                 reasons.push('文件模式匹配');
                 confidence += 25;
             }
@@ -104,7 +104,7 @@ export class CompletionEngine {
             confidence += 30;
         }
         // 活动阈值
-        const threshold = nodeType.activity_threshold.min_tool_calls;
+        const threshold = nodeType.activity_threshold?.min_tool_calls ?? 25;
         if (eventCount >= threshold) {
             reasons.push(`活动阈值（${eventCount}/${threshold}）`);
             confidence += 20;

package/dist/pipeline/completion-engine.js.map

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

package/dist/pipeline/completion-gate.js

@@ -15,8 +15,8 @@ export class CompletionGate {
         this.semanticValidator = semanticValidator;
     }
     async evaluateTraditionalNode(context) {
-        const hasExplicitSignal = context.nodeType.completion.explicit_signal
-            ? this.detector.detectExplicitSignal(context.event, context.nodeType.completion.explicit_signal)
+        const hasExplicitSignal = context.nodeType.completion?.explicit_signal
+            ? this.detector.detectExplicitSignal(context.event, context.nodeType.completion?.explicit_signal)
             : false;
         // ── 绝对超时强制推进（最高优先级）────────────────────────────────────────
         // 节点运行超过阈值时，无论产物状态如何，强制推进到下一节点，防止永久卡死
@@ -147,7 +147,7 @@ export class CompletionGate {
         // 2. 如果有 file_patterns 且匹配成功，自动推进
         // 3. 如果有显式信号，推进
         // 4. 否则静默等待
-        const filePatterns = context.nodeType.completion.heuristic?.file_patterns;
+        const filePatterns = context.nodeType.completion?.heuristic?.file_patterns;
         if (filePatterns && filePatterns.length > 0) {
             if (this.detector.detectFilePatterns(context.event, filePatterns)) {
                 logger.info(`[CompletionGate] 📁 产物通过 + 文件模式匹配，自动推进`);