@specpow/framework 0.2.0

package/dist/core/hooks/hook-registry.js

@@ -0,0 +1,172 @@
+/**
+ * Hook 注册表
+ *
+ * P2-11: 管理所有 Hook 处理器的注册和调度
+ */
+import { SessionStartHook } from './session-start-hook.js';
+import { WorkflowStateHook } from './workflow-state-hook.js';
+import { PreToolCallHook } from './pre-tool-call-hook.js';
+import { PostToolCallHook } from './post-tool-call-hook.js';
+// ─── Hook 注册表 ───────────────────────────────────────────
+export class HookRegistry {
+    handlers = new Map();
+    /**
+     * 注册 Hook 处理器
+     */
+    register(handler) {
+        const existing = this.handlers.get(handler.event) || [];
+        existing.push(handler);
+        this.handlers.set(handler.event, existing);
+    }
+    /**
+     * 获取指定事件的所有处理器
+     */
+    getHandlers(event) {
+        return this.handlers.get(event) || [];
+    }
+    /**
+     * 执行指定事件的所有处理器
+     */
+    async execute(event, context) {
+        const handlers = this.getHandlers(event);
+        const results = [];
+        for (const handler of handlers) {
+            try {
+                const result = await handler.handle(context);
+                results.push(result);
+            }
+            catch (err) {
+                results.push({
+                    success: false,
+                    output: {},
+                    error: err.message,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * 合并多个 Hook 结果
+     */
+    mergeResults(results) {
+        const merged = {
+            success: true,
+            output: {},
+        };
+        const contexts = [];
+        const warnings = [];
+        let block = false;
+        let blockReason = '';
+        for (const result of results) {
+            if (!result.success) {
+                merged.success = false;
+                continue;
+            }
+            if (result.output.additionalContext) {
+                contexts.push(result.output.additionalContext);
+            }
+            if (result.output.warnings) {
+                warnings.push(...result.output.warnings);
+            }
+            if (result.output.block) {
+                block = true;
+                blockReason = result.output.blockReason || 'Blocked by hook';
+            }
+        }
+        merged.output = {
+            additionalContext: contexts.join('\n\n'),
+            warnings: warnings.length > 0 ? warnings : undefined,
+            block: block || undefined,
+            blockReason: block ? blockReason : undefined,
+        };
+        return merged;
+    }
+    /**
+     * 格式化输出为平台特定格式
+     */
+    formatForPlatform(result, event, _platform) {
+        const context = result.output.additionalContext || '';
+        return {
+            claude: {
+                hookSpecificOutput: {
+                    hookEventName: event,
+                    additionalContext: context,
+                },
+            },
+            cursor: {
+                additional_context: context,
+            },
+            generic: {
+                additionalContext: context,
+            },
+        };
+    }
+}
+// ─── 默认注册表（单例） ────────────────────────────────────
+let defaultRegistry = null;
+/**
+ * 获取默认 Hook 注册表
+ */
+export function getDefaultRegistry() {
+    if (!defaultRegistry) {
+        defaultRegistry = new HookRegistry();
+        // 注册内置 Hook
+        defaultRegistry.register(new SessionStartHook());
+        defaultRegistry.register(new WorkflowStateHook());
+        defaultRegistry.register(new PreToolCallHook());
+        defaultRegistry.register(new PostToolCallHook());
+    }
+    return defaultRegistry;
+}
+/**
+ * 执行 SessionStart Hook
+ */
+export async function executeSessionStart(projectRoot, platform = 'unknown') {
+    const registry = getDefaultRegistry();
+    const context = { projectRoot, platform };
+    const results = await registry.execute('SessionStart', context);
+    const merged = registry.mergeResults(results);
+    return merged.output.additionalContext || '';
+}
+/**
+ * 执行 UserPromptSubmit Hook
+ */
+export async function executeUserPromptSubmit(projectRoot, userInput, platform = 'unknown') {
+    const registry = getDefaultRegistry();
+    const context = { projectRoot, userInput, platform };
+    const results = await registry.execute('UserPromptSubmit', context);
+    const merged = registry.mergeResults(results);
+    return merged.output.additionalContext || '';
+}
+/**
+ * 执行 PreToolCall Hook
+ */
+export async function executePreToolCall(projectRoot, toolName, toolInput, platform = 'unknown') {
+    const registry = getDefaultRegistry();
+    const context = { projectRoot, toolName, toolInput, platform };
+    const results = await registry.execute('PreToolCall', context);
+    const merged = registry.mergeResults(results);
+    return {
+        context: merged.output.additionalContext || '',
+        blocked: merged.output.block || false,
+        blockReason: merged.output.blockReason,
+        warnings: merged.output.warnings || [],
+    };
+}
+/**
+ * 执行 PostToolCall Hook
+ */
+export async function executePostToolCall(projectRoot, toolName, toolSuccess, toolOutput, platform = 'unknown') {
+    const registry = getDefaultRegistry();
+    const context = {
+        projectRoot,
+        toolName,
+        toolSuccess,
+        toolOutput,
+        platform,
+    };
+    const results = await registry.execute('PostToolCall', context);
+    const merged = registry.mergeResults(results);
+    return merged.output.additionalContext || '';
+}
+//# sourceMappingURL=hook-registry.js.map

package/dist/core/hooks/hook-registry.js.map

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

package/dist/core/hooks/hook-types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Hook 系统类型定义
+ *
+ * P2-11: 3-hook 管道系统
+ *
+ * 1. SessionStart - 会话开始时注入项目概览
+ * 2. UserPromptSubmit - 用户提交提示时注入工作流状态
+ * 3. PreToolCall - 工具调用前注入上下文约束（预留）
+ */
+export type HookEvent = 'SessionStart' | 'UserPromptSubmit' | 'PreToolCall' | 'PostToolCall';
+export interface HookContext {
+    /** 项目根目录 */
+    projectRoot: string;
+    /** 用户输入（仅 UserPromptSubmit） */
+    userInput?: string;
+    /** 工具名称（仅 PreToolCall/PostToolCall） */
+    toolName?: string;
+    /** 工具输入参数（仅 PreToolCall/PostToolCall） */
+    toolInput?: Record<string, unknown>;
+    /** 工具输出结果（仅 PostToolCall） */
+    toolOutput?: unknown;
+    /** 工具调用是否成功（仅 PostToolCall） */
+    toolSuccess?: boolean;
+    /** 平台标识 */
+    platform: 'claude' | 'cursor' | 'copilot' | 'unknown';
+}
+export interface HookOutput {
+    /** 注入的上下文（追加到 AI 上下文） */
+    additionalContext?: string;
+    /** 警告消息（显示给用户） */
+    warnings?: string[];
+    /** 阻止执行（仅 PreToolCall） */
+    block?: boolean;
+    /** 阻止原因 */
+    blockReason?: string;
+}
+export interface HookResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 输出内容 */
+    output: HookOutput;
+    /** 错误信息 */
+    error?: string;
+}
+export interface HookHandler {
+    /** Hook 事件名称 */
+    event: HookEvent;
+    /** 处理函数 */
+    handle(context: HookContext): Promise<HookResult>;
+}
+export interface HookConfig {
+    /** 启用的 Hook 列表 */
+    enabled: HookEvent[];
+    /** 自定义 Hook 处理器 */
+    handlers?: Map<HookEvent, HookHandler>;
+}
+export interface ProjectState {
+    /** 项目名称 */
+    name: string;
+    /** 活跃变更列表 */
+    activeChanges: string[];
+    /** 当前工作流阶段 */
+    workflowStage: WorkflowStage | null;
+    /** 已有规范数量 */
+    specCount: number;
+    /** 检测到的 AI 工具 */
+    detectedTools: string[];
+}
+export type WorkflowStage = 'explore' | 'propose' | 'apply' | 'verify' | 'archive' | 'idle';
+export interface PlatformOutput {
+    /** Claude Code 格式 */
+    claude: {
+        hookSpecificOutput: {
+            hookEventName: string;
+            additionalContext: string;
+        };
+    };
+    /** Cursor 格式 */
+    cursor: {
+        additional_context: string;
+    };
+    /** Copilot/通用格式 */
+    generic: {
+        additionalContext: string;
+    };
+}
+//# sourceMappingURL=hook-types.d.ts.map

package/dist/core/hooks/hook-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-types.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/hook-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,kBAAkB,GAClB,aAAa,GACb,cAAc,CAAC;AAInB,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW;IACX,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACvD;AAID,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACnD;AAID,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;CACxC;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc;IACd,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAIX,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,MAAM,EAAE;QACN,kBAAkB,EAAE;YAClB,aAAa,EAAE,MAAM,CAAC;YACtB,iBAAiB,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH,CAAC;IACF,gBAAgB;IAChB,MAAM,EAAE;QACN,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,mBAAmB;IACnB,OAAO,EAAE;QACP,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH"}

package/dist/core/hooks/hook-types.js

@@ -0,0 +1,11 @@
+/**
+ * Hook 系统类型定义
+ *
+ * P2-11: 3-hook 管道系统
+ *
+ * 1. SessionStart - 会话开始时注入项目概览
+ * 2. UserPromptSubmit - 用户提交提示时注入工作流状态
+ * 3. PreToolCall - 工具调用前注入上下文约束（预留）
+ */
+export {};
+//# sourceMappingURL=hook-types.js.map

package/dist/core/hooks/hook-types.js.map

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

package/dist/core/hooks/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hook 系统入口
+ *
+ * P2-11: 3-hook 管道系统
+ *
+ * 提供自动上下文注入能力：
+ * - SessionStart: 会话开始时注入项目概览
+ * - UserPromptSubmit: 用户提交提示时注入工作流状态
+ * - PreToolCall: 工具调用前注入上下文约束（预留）
+ *
+ * @example
+ * ```typescript
+ * import { executeSessionStart, executeUserPromptSubmit } from 'specpow/core/hooks';
+ *
+ * // 会话启动
+ * const context = await executeSessionStart(projectRoot, 'claude');
+ *
+ * // 用户提示提交
+ * const workflowContext = await executeUserPromptSubmit(projectRoot, userInput, 'cursor');
+ * ```
+ */
+export type { HookEvent, HookContext, HookOutput, HookResult, HookHandler, HookConfig, ProjectState, WorkflowStage, PlatformOutput, } from './hook-types.js';
+export { HookRegistry, getDefaultRegistry, executeSessionStart, executeUserPromptSubmit } from './hook-registry.js';
+export { SessionStartHook, detectProjectState, generateSessionStartContext } from './session-start-hook.js';
+export { WorkflowStateHook } from './workflow-state-hook.js';
+export { PreToolCallHook, isToolAllowedInStage, getStageToolRules } from './pre-tool-call-hook.js';
+export { PostToolCallHook, getToolCallStats } from './post-tool-call-hook.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/hooks/index.js

@@ -0,0 +1,28 @@
+/**
+ * Hook 系统入口
+ *
+ * P2-11: 3-hook 管道系统
+ *
+ * 提供自动上下文注入能力：
+ * - SessionStart: 会话开始时注入项目概览
+ * - UserPromptSubmit: 用户提交提示时注入工作流状态
+ * - PreToolCall: 工具调用前注入上下文约束（预留）
+ *
+ * @example
+ * ```typescript
+ * import { executeSessionStart, executeUserPromptSubmit } from 'specpow/core/hooks';
+ *
+ * // 会话启动
+ * const context = await executeSessionStart(projectRoot, 'claude');
+ *
+ * // 用户提示提交
+ * const workflowContext = await executeUserPromptSubmit(projectRoot, userInput, 'cursor');
+ * ```
+ */
+// 类导出
+export { HookRegistry, getDefaultRegistry, executeSessionStart, executeUserPromptSubmit } from './hook-registry.js';
+export { SessionStartHook, detectProjectState, generateSessionStartContext } from './session-start-hook.js';
+export { WorkflowStateHook } from './workflow-state-hook.js';
+export { PreToolCallHook, isToolAllowedInStage, getStageToolRules } from './pre-tool-call-hook.js';
+export { PostToolCallHook, getToolCallStats } from './post-tool-call-hook.js';
+//# sourceMappingURL=index.js.map

package/dist/core/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAeH,MAAM;AACN,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/hooks/post-tool-call-hook.d.ts

@@ -0,0 +1,21 @@
+/**
+ * PostToolCall Hook
+ *
+ * P2-11: 工具调用后处理器
+ *
+ * 功能：
+ * 1. 记录工具调用结果到 ledger
+ * 2. 检测是否需要触发工作流阶段转换
+ * 3. 提供工具调用后的上下文增强
+ * 4. 统计工具调用模式
+ */
+import type { HookHandler, HookContext, HookResult } from './hook-types.js';
+export declare class PostToolCallHook implements HookHandler {
+    event: "PostToolCall";
+    handle(context: HookContext): Promise<HookResult>;
+}
+/**
+ * 获取工具调用统计（从 ledger）
+ */
+export declare function getToolCallStats(projectRoot: string): Map<string, number>;
+//# sourceMappingURL=post-tool-call-hook.d.ts.map

package/dist/core/hooks/post-tool-call-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-call-hook.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/post-tool-call-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AA0I3F,qBAAa,gBAAiB,YAAW,WAAW;IAClD,KAAK,EAAG,cAAc,CAAU;IAE1B,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAoExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BzE"}

package/dist/core/hooks/post-tool-call-hook.js

@@ -0,0 +1,191 @@
+/**
+ * PostToolCall Hook
+ *
+ * P2-11: 工具调用后处理器
+ *
+ * 功能：
+ * 1. 记录工具调用结果到 ledger
+ * 2. 检测是否需要触发工作流阶段转换
+ * 3. 提供工具调用后的上下文增强
+ * 4. 统计工具调用模式
+ */
+import { existsSync, appendFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+function detectTransitionSignals(toolName, toolSuccess, currentStage, toolOutput) {
+    // explore → propose: 用户创建了 proposal 文件
+    if (currentStage === 'explore' && toolName === 'Write' && toolSuccess) {
+        const output = String(toolOutput || '');
+        if (output.includes('proposal') || output.includes('提案')) {
+            return {
+                from: 'explore',
+                to: 'propose',
+                trigger: 'Created proposal document',
+                confidence: 0.8,
+            };
+        }
+    }
+    // propose → apply: 用户创建了 tasks 文件
+    if (currentStage === 'propose' && toolName === 'Write' && toolSuccess) {
+        const output = String(toolOutput || '');
+        if (output.includes('tasks') || output.includes('任务')) {
+            return {
+                from: 'propose',
+                to: 'apply',
+                trigger: 'Created task list',
+                confidence: 0.8,
+            };
+        }
+    }
+    // apply → verify: 用户运行了测试
+    if (currentStage === 'apply' && toolName === 'Bash' && toolSuccess) {
+        const output = String(toolOutput || '');
+        if (output.includes('test') || output.includes('vitest') || output.includes('npm test')) {
+            return {
+                from: 'apply',
+                to: 'verify',
+                trigger: 'Executed tests',
+                confidence: 0.7,
+            };
+        }
+    }
+    // verify → archive: 验证通过
+    if (currentStage === 'verify' && toolName === 'Bash' && toolSuccess) {
+        const output = String(toolOutput || '');
+        if (output.includes('all tests passed') || output.includes('✓')) {
+            return {
+                from: 'verify',
+                to: 'archive',
+                trigger: 'All tests passed',
+                confidence: 0.9,
+            };
+        }
+    }
+    return null;
+}
+// ─── Ledger 记录 ─────────────────────────────────────────────
+function recordToLedger(projectRoot, record) {
+    const ledgerDir = join(projectRoot, '.specpow', 'ledger');
+    try {
+        if (!existsSync(ledgerDir)) {
+            mkdirSync(ledgerDir, { recursive: true });
+        }
+        const ledgerFile = join(ledgerDir, 'tool-calls.jsonl');
+        const line = JSON.stringify(record) + '\n';
+        appendFileSync(ledgerFile, line, 'utf-8');
+    }
+    catch {
+        // 静默失败，不影响主流程
+    }
+}
+// ─── 工作流状态检测 ──────────────────────────────────────────
+function detectCurrentStage(projectRoot) {
+    const changesDir = join(projectRoot, 'openspec', 'changes');
+    if (!existsSync(changesDir)) {
+        return 'idle';
+    }
+    try {
+        const { readdirSync } = require('fs');
+        const entries = readdirSync(changesDir, { withFileTypes: true });
+        const changeDirs = entries.filter((e) => e.isDirectory() && e.name !== 'archive');
+        if (changeDirs.length === 0) {
+            return 'idle';
+        }
+        const changeDir = join(changesDir, changeDirs[0].name);
+        const files = readdirSync(changeDir);
+        if (files.some((f) => f.includes('verify') || f.includes('review'))) {
+            return 'verify';
+        }
+        if (files.some((f) => f.includes('tasks'))) {
+            return 'apply';
+        }
+        if (files.some((f) => f.includes('spec') || f.includes('design'))) {
+            return 'propose';
+        }
+        return 'explore';
+    }
+    catch {
+        return 'idle';
+    }
+}
+// ─── Hook 处理器 ────────────────────────────────────────────
+export class PostToolCallHook {
+    event = 'PostToolCall';
+    async handle(context) {
+        try {
+            const { toolName, toolSuccess, toolOutput, projectRoot } = context;
+            if (!toolName) {
+                return {
+                    success: true,
+                    output: {},
+                };
+            }
+            const currentStage = detectCurrentStage(projectRoot);
+            // 1. 记录到 ledger
+            const record = {
+                timestamp: Date.now(),
+                toolName,
+                success: toolSuccess ?? true,
+                stage: currentStage,
+            };
+            if (!toolSuccess && context.toolInput?.error) {
+                record.error = String(context.toolInput.error);
+            }
+            recordToLedger(projectRoot, record);
+            // 2. 检测阶段转换信号
+            const transition = detectTransitionSignals(toolName, toolSuccess ?? true, currentStage, toolOutput);
+            const additionalContextParts = [
+                `\n<!-- post-tool-call: ${toolName} -->`,
+                `<!-- workflow-stage: ${currentStage} -->`,
+                `工具调用完成: ${toolName} (${toolSuccess ? '✓' : '✗'})`,
+            ];
+            // 3. 如果有转换信号，注入提示
+            if (transition) {
+                additionalContextParts.push(`\n💡 检测到阶段转换信号:`, `  从: ${transition.from.toUpperCase()}`, `  到: ${transition.to.toUpperCase()}`, `  触发: ${transition.trigger}`, `  置信度: ${(transition.confidence * 100).toFixed(0)}%`, `\n建议: 考虑切换到 ${transition.to} 阶段`);
+            }
+            return {
+                success: true,
+                output: {
+                    additionalContext: additionalContextParts.join('\n'),
+                    warnings: [],
+                },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: {},
+                error: err.message,
+            };
+        }
+    }
+}
+/**
+ * 获取工具调用统计（从 ledger）
+ */
+export function getToolCallStats(projectRoot) {
+    const ledgerFile = join(projectRoot, '.specpow', 'ledger', 'tool-calls.jsonl');
+    if (!existsSync(ledgerFile)) {
+        return new Map();
+    }
+    try {
+        const { readFileSync } = require('fs');
+        const content = readFileSync(ledgerFile, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        const stats = new Map();
+        for (const line of lines) {
+            try {
+                const record = JSON.parse(line);
+                const count = stats.get(record.toolName) || 0;
+                stats.set(record.toolName, count + 1);
+            }
+            catch {
+                // 跳过无效行
+            }
+        }
+        return stats;
+    }
+    catch {
+        return new Map();
+    }
+}
+//# sourceMappingURL=post-tool-call-hook.js.map

package/dist/core/hooks/post-tool-call-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-call-hook.js","sourceRoot":"","sources":["../../../src/core/hooks/post-tool-call-hook.ts"],"names":[],"mappings":"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"}

package/dist/core/hooks/pre-tool-call-hook.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PreToolCall Hook
+ *
+ * P2-11: 工具调用前拦截器
+ *
+ * 功能：
+ * 1. 注入当前工作流上下文到工具调用
+ * 2. 验证工具调用是否符合当前阶段规则
+ * 3. 在 explore 阶段阻止写操作
+ * 4. 提供工具调用前的上下文增强
+ */
+import type { HookHandler, HookContext, HookResult, WorkflowStage } from './hook-types.js';
+interface StageRule {
+    allowedTools: string[];
+    blockedTools: string[];
+    description: string;
+}
+export declare class PreToolCallHook implements HookHandler {
+    event: "PreToolCall";
+    handle(context: HookContext): Promise<HookResult>;
+}
+/**
+ * 检查工具是否在指定阶段被允许
+ */
+export declare function isToolAllowedInStage(toolName: string, stage: WorkflowStage): boolean;
+/**
+ * 获取阶段的工具规则
+ */
+export declare function getStageToolRules(stage: WorkflowStage): StageRule;
+export {};
+//# sourceMappingURL=pre-tool-call-hook.d.ts.map

package/dist/core/hooks/pre-tool-call-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-call-hook.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/pre-tool-call-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAoB3F,UAAU,SAAS;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAqCD,qBAAa,eAAgB,YAAW,WAAW;IACjD,KAAK,EAAG,aAAa,CAAU;IAEzB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAoDxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAGpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAEjE"}