@liangjie559567/ultrapower 7.0.3 → 7.0.5

package/dist/hooks/validation.js

@@ -17,6 +17,8 @@ export function requiredKeysForHook(hookType) {
             return ["directory", "toolName"];
         case "autopilot":
             return ["directory"];
+        case "user-prompt-submit":
+            return ["prompt", "directory"];
         case "keyword-detector":
         case "stop-continuation":
             return [];

package/dist/hooks/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/hooks/validation.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC;QACnB,KAAK,gBAAgB,CAAC;QACtB,KAAK,eAAe,CAAC;QACrB,KAAK,aAAa,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,mBAAmB,CAAC;QACzB,KAAK,OAAO,CAAC;QACb,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACpC,KAAK,oBAAoB;YACvB,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAChD,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe;YAClB,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACnC,KAAK,WAAW;YACd,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,KAAK,kBAAkB,CAAC;QACxB,KAAK,mBAAmB;YACtB,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,cAAwB,EACxB,QAAiB;IAEjB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,CACvD,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CACX,+CAA+C,QAAQ,IAAI,SAAS,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7G,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,gBAAgB,GAAoB,IAAI,CAAC;AAE7C,MAAM,UAAU,YAAY;IAC1B,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvG,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/hooks/validation.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC;QACnB,KAAK,gBAAgB,CAAC;QACtB,KAAK,eAAe,CAAC;QACrB,KAAK,aAAa,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,mBAAmB,CAAC;QACzB,KAAK,OAAO,CAAC;QACb,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACpC,KAAK,oBAAoB;YACvB,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAChD,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe;YAClB,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACnC,KAAK,WAAW;YACd,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,KAAK,oBAAoB;YACvB,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjC,KAAK,kBAAkB,CAAC;QACxB,KAAK,mBAAmB;YACtB,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,cAAwB,EACxB,QAAiB;IAEjB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,CACvD,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CACX,+CAA+C,QAAQ,IAAI,SAAS,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7G,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,gBAAgB,GAAoB,IAAI,CAAC;AAE7C,MAAM,UAAU,YAAY;IAC1B,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvG,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC"}

package/dist/hooks/workflow-gate/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Workflow Gate Hook
+ *
+ * Enforces superpowers workflow discipline by detecting when users
+ * skip required steps and automatically injecting the correct skill.
+ *
+ * Workflow stages:
+ * 1. brainstorming (required before any implementation)
+ * 2. writing-plans (required after brainstorming)
+ * 3. using-git-worktrees (recommended before execution)
+ * 4. execution (subagent-driven-development or executing-plans)
+ * 5. requesting-code-review (required before completion)
+ * 6. verification-before-completion (required before merge)
+ */
+export interface WorkflowState {
+    brainstormingComplete: boolean;
+    planWritten: boolean;
+    worktreeCreated: boolean;
+    testsWritten: boolean;
+    executionStarted: boolean;
+    reviewRequested: boolean;
+    codeReviewComplete: boolean;
+    securityReviewComplete: boolean;
+    performanceReviewComplete: boolean;
+    verificationComplete: boolean;
+    lastStage: string;
+    timestamp: number;
+}
+export interface WorkflowGateInput {
+    type: 'UserPromptSubmit';
+    prompt: string;
+    workingDirectory: string;
+}
+export interface WorkflowGateOutput {
+    success: boolean;
+    shouldBlock: boolean;
+    injectedSkill?: string;
+    message?: string;
+}
+/**
+ * Get workflow state file path
+ */
+export declare function getWorkflowStatePath(workingDir: string): string;
+/**
+ * Read current workflow state
+ */
+export declare function readWorkflowState(workingDir: string): WorkflowState | null;
+/**
+ * Write workflow state
+ */
+export declare function writeWorkflowState(workingDir: string, state: WorkflowState): void;
+/**
+ * Initialize workflow state
+ */
+export declare function initWorkflowState(workingDir: string): WorkflowState;
+/**
+ * Detect implementation keywords that require brainstorming first
+ */
+export declare function detectImplementationIntent(prompt: string): boolean;
+/**
+ * Detect plan execution keywords
+ */
+export declare function detectExecutionIntent(prompt: string): boolean;
+/**
+ * Check if brainstorming skill was just completed
+ */
+export declare function detectBrainstormingComplete(prompt: string): boolean;
+/**
+ * Check if plan was just written
+ */
+export declare function detectPlanComplete(prompt: string): boolean;
+/**
+ * Check if tests were just written
+ */
+export declare function detectTestsComplete(prompt: string): boolean;
+/**
+ * Check if code review was completed
+ */
+export declare function detectCodeReviewComplete(prompt: string): boolean;
+/**
+ * Check if security review was completed
+ */
+export declare function detectSecurityReviewComplete(prompt: string): boolean;
+/**
+ * Check if performance review was completed
+ */
+export declare function detectPerformanceReviewComplete(prompt: string): boolean;
+/**
+ * Detect if prompt contains security-sensitive keywords
+ */
+export declare function detectSecuritySensitive(prompt: string): boolean;
+/**
+ * Detect if prompt contains performance-sensitive keywords
+ */
+export declare function detectPerformanceSensitive(prompt: string): boolean;
+/**
+ * Detect if user is trying to use executing-plans or subagent-driven-development
+ */
+export declare function detectPlanExecutionSkill(prompt: string): boolean;
+/**
+ * Detect if user is asking a vague question that needs brainstorming
+ */
+export declare function detectVagueRequest(prompt: string): boolean;
+/**
+ * Suggest next step based on current workflow state
+ */
+export declare function suggestNextStep(state: WorkflowState): string | null;
+/**
+ * Process workflow gate check
+ */
+export declare function processWorkflowGate(input: WorkflowGateInput): WorkflowGateOutput;
+/**
+ * Clear workflow state (for testing or manual reset)
+ */
+export declare function clearWorkflowState(workingDir: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/workflow-gate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflow-gate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,aAAa;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,OAAO,CAAC;IAChC,yBAAyB,EAAE,OAAO,CAAC;IACnC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAY1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CASjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAkBnE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CASlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ7D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAO/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOlE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAuB1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAkCnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAwIhF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAK3D"}

package/dist/hooks/workflow-gate/index.js

@@ -0,0 +1,352 @@
+/**
+ * Workflow Gate Hook
+ *
+ * Enforces superpowers workflow discipline by detecting when users
+ * skip required steps and automatically injecting the correct skill.
+ *
+ * Workflow stages:
+ * 1. brainstorming (required before any implementation)
+ * 2. writing-plans (required after brainstorming)
+ * 3. using-git-worktrees (recommended before execution)
+ * 4. execution (subagent-driven-development or executing-plans)
+ * 5. requesting-code-review (required before completion)
+ * 6. verification-before-completion (required before merge)
+ */
+import { readFileSync, existsSync, writeFileSync } from 'fs';
+import { join } from 'path';
+const WORKFLOW_STATE_FILE = '.omc/workflow-state.json';
+/**
+ * Get workflow state file path
+ */
+export function getWorkflowStatePath(workingDir) {
+    return join(workingDir, WORKFLOW_STATE_FILE);
+}
+/**
+ * Read current workflow state
+ */
+export function readWorkflowState(workingDir) {
+    const statePath = getWorkflowStatePath(workingDir);
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(statePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write workflow state
+ */
+export function writeWorkflowState(workingDir, state) {
+    const statePath = getWorkflowStatePath(workingDir);
+    const dir = join(workingDir, '.omc');
+    if (!existsSync(dir)) {
+        require('fs').mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf-8');
+}
+/**
+ * Initialize workflow state
+ */
+export function initWorkflowState(workingDir) {
+    const state = {
+        brainstormingComplete: false,
+        planWritten: false,
+        worktreeCreated: false,
+        testsWritten: false,
+        executionStarted: false,
+        reviewRequested: false,
+        codeReviewComplete: false,
+        securityReviewComplete: false,
+        performanceReviewComplete: false,
+        verificationComplete: false,
+        lastStage: 'init',
+        timestamp: Date.now()
+    };
+    writeWorkflowState(workingDir, state);
+    return state;
+}
+/**
+ * Detect implementation keywords that require brainstorming first
+ */
+export function detectImplementationIntent(prompt) {
+    const implementationKeywords = [
+        'implement', 'create', 'add', 'build', 'develop',
+        'write code', 'make a', 'generate', 'construct',
+        '实现', '创建', '添加', '构建', '开发', '编写代码', '生成'
+    ];
+    const lowerPrompt = prompt.toLowerCase();
+    return implementationKeywords.some(kw => lowerPrompt.includes(kw));
+}
+/**
+ * Detect plan execution keywords
+ */
+export function detectExecutionIntent(prompt) {
+    const executionKeywords = [
+        'execute', 'run', 'start', 'begin implementation',
+        '执行', '运行', '开始实现'
+    ];
+    const lowerPrompt = prompt.toLowerCase();
+    return executionKeywords.some(kw => lowerPrompt.includes(kw));
+}
+/**
+ * Check if brainstorming skill was just completed
+ */
+export function detectBrainstormingComplete(prompt) {
+    return prompt.includes('brainstorming') &&
+        (prompt.includes('complete') || prompt.includes('完成'));
+}
+/**
+ * Check if plan was just written
+ */
+export function detectPlanComplete(prompt) {
+    return (prompt.includes('plan') || prompt.includes('writing-plans')) &&
+        (prompt.includes('complete') || prompt.includes('written') || prompt.includes('完成'));
+}
+/**
+ * Check if tests were just written
+ */
+export function detectTestsComplete(prompt) {
+    return (prompt.includes('test') || prompt.includes('测试')) &&
+        (prompt.includes('complete') || prompt.includes('written') || prompt.includes('完成'));
+}
+/**
+ * Check if code review was completed
+ */
+export function detectCodeReviewComplete(prompt) {
+    return (prompt.includes('code review') || prompt.includes('代码审查')) &&
+        (prompt.includes('complete') || prompt.includes('完成'));
+}
+/**
+ * Check if security review was completed
+ */
+export function detectSecurityReviewComplete(prompt) {
+    return (prompt.includes('security review') || prompt.includes('安全审查')) &&
+        (prompt.includes('complete') || prompt.includes('完成'));
+}
+/**
+ * Check if performance review was completed
+ */
+export function detectPerformanceReviewComplete(prompt) {
+    return (prompt.includes('performance review') || prompt.includes('性能审查')) &&
+        (prompt.includes('complete') || prompt.includes('完成'));
+}
+/**
+ * Detect if prompt contains security-sensitive keywords
+ */
+export function detectSecuritySensitive(prompt) {
+    const securityKeywords = [
+        'auth', 'password', 'token', 'jwt', 'session', 'crypto', 'encrypt',
+        '认证', '密码', '加密', '令牌'
+    ];
+    const lowerPrompt = prompt.toLowerCase();
+    return securityKeywords.some(kw => lowerPrompt.includes(kw) || prompt.includes(kw));
+}
+/**
+ * Detect if prompt contains performance-sensitive keywords
+ */
+export function detectPerformanceSensitive(prompt) {
+    const performanceKeywords = [
+        'performance', 'optimize', 'cache', 'query', 'database', 'api',
+        '性能', '优化', '缓存', '查询', '数据库'
+    ];
+    const lowerPrompt = prompt.toLowerCase();
+    return performanceKeywords.some(kw => lowerPrompt.includes(kw) || prompt.includes(kw));
+}
+/**
+ * Detect if user is trying to use executing-plans or subagent-driven-development
+ */
+export function detectPlanExecutionSkill(prompt) {
+    return prompt.includes('executing-plans') ||
+        prompt.includes('subagent-driven-development') ||
+        prompt.includes('/ultrapower:executing-plans') ||
+        prompt.includes('/ultrapower:subagent-driven-development');
+}
+/**
+ * Detect if user is asking a vague question that needs brainstorming
+ */
+export function detectVagueRequest(prompt) {
+    const vaguePatterns = [
+        'how to', 'what should', 'help me', 'i want to', 'i need',
+        '如何', '怎么', '帮我', '我想', '我需要'
+    ];
+    // Check both original and lowercase for case-insensitive English matching
+    const lowerPrompt = prompt.toLowerCase();
+    const hasVaguePattern = vaguePatterns.some(pattern => lowerPrompt.includes(pattern.toLowerCase()) || prompt.includes(pattern));
+    // Ignore if brainstorming already mentioned
+    if (prompt.includes('brainstorm')) {
+        return false;
+    }
+    // Require minimum length (count characters, not bytes)
+    if ([...prompt].length < 8) {
+        return false;
+    }
+    return hasVaguePattern;
+}
+/**
+ * Suggest next step based on current workflow state
+ */
+export function suggestNextStep(state) {
+    if (!state.brainstormingComplete) {
+        return 'brainstorming';
+    }
+    if (!state.planWritten) {
+        return 'writing-plans';
+    }
+    if (!state.testsWritten && state.planWritten) {
+        return 'test-driven-development';
+    }
+    if (!state.executionStarted && state.testsWritten) {
+        return 'subagent-driven-development';
+    }
+    if (!state.reviewRequested && state.executionStarted) {
+        return 'requesting-code-review';
+    }
+    if (!state.codeReviewComplete && state.reviewRequested) {
+        return 'code-review';
+    }
+    if (!state.verificationComplete && state.codeReviewComplete) {
+        return 'verification-before-completion';
+    }
+    if (!state.worktreeCreated && state.planWritten) {
+        return 'using-git-worktrees';
+    }
+    return null;
+}
+/**
+ * Process workflow gate check
+ */
+export function processWorkflowGate(input) {
+    const { prompt, workingDirectory } = input;
+    let state = readWorkflowState(workingDirectory);
+    if (!state) {
+        state = initWorkflowState(workingDirectory);
+    }
+    // Update state based on prompt
+    if (detectBrainstormingComplete(prompt)) {
+        state.brainstormingComplete = true;
+        state.lastStage = 'brainstorming';
+        state.timestamp = Date.now();
+        writeWorkflowState(workingDirectory, state);
+    }
+    if (detectPlanComplete(prompt)) {
+        state.planWritten = true;
+        state.lastStage = 'planning';
+        state.timestamp = Date.now();
+        writeWorkflowState(workingDirectory, state);
+    }
+    if (detectTestsComplete(prompt)) {
+        state.testsWritten = true;
+        state.lastStage = 'testing';
+        state.timestamp = Date.now();
+        writeWorkflowState(workingDirectory, state);
+    }
+    if (detectCodeReviewComplete(prompt)) {
+        state.codeReviewComplete = true;
+        state.lastStage = 'code-review';
+        state.timestamp = Date.now();
+        writeWorkflowState(workingDirectory, state);
+    }
+    if (detectSecurityReviewComplete(prompt)) {
+        state.securityReviewComplete = true;
+        state.lastStage = 'security-review';
+        state.timestamp = Date.now();
+        writeWorkflowState(workingDirectory, state);
+    }
+    if (detectPerformanceReviewComplete(prompt)) {
+        state.performanceReviewComplete = true;
+        state.lastStage = 'performance-review';
+        state.timestamp = Date.now();
+        writeWorkflowState(workingDirectory, state);
+    }
+    // Gate 1: Implementation without brainstorming (highest priority)
+    if (detectImplementationIntent(prompt) && !state.brainstormingComplete) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'brainstorming',
+            message: '⚠️ Workflow Gate: 在实现之前必须先进行头脑风暴。自动注入 brainstorming skill。'
+        };
+    }
+    // Gate 2: Execution without plan
+    if (detectExecutionIntent(prompt) && !state.planWritten) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'writing-plans',
+            message: '⚠️ Workflow Gate: 在执行之前必须先编写计划。自动注入 writing-plans skill。'
+        };
+    }
+    // Gate 2.5: Execution without tests (TDD enforcement)
+    if (detectExecutionIntent(prompt) && state.planWritten && !state.testsWritten) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'test-driven-development',
+            message: '⚠️ Workflow Gate: TDD 要求在实现前先编写测试。自动注入 test-driven-development skill。'
+        };
+    }
+    // Gate 3: Using executing-plans or subagent-driven-development without plan
+    if (detectPlanExecutionSkill(prompt) && !state.planWritten) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'writing-plans',
+            message: '⚠️ Workflow Gate: 使用 executing-plans 或 subagent-driven-development 前必须先编写计划。自动注入 writing-plans skill。'
+        };
+    }
+    // Gate 4: Verification without code review
+    if (prompt.includes('verification') && state.executionStarted && !state.codeReviewComplete) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'code-review',
+            message: '⚠️ Workflow Gate: 验证前必须先完成代码审查。自动注入 code-review skill。'
+        };
+    }
+    // Gate 5: Security review for sensitive code
+    if (detectSecuritySensitive(prompt) && state.executionStarted && !state.securityReviewComplete) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'security-review',
+            message: '⚠️ Workflow Gate: 检测到安全敏感代码，必须进行安全审查。自动注入 security-review skill。'
+        };
+    }
+    // Gate 6: Performance review for performance-sensitive code
+    if (detectPerformanceSensitive(prompt) && state.executionStarted && !state.performanceReviewComplete) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'performance-review',
+            message: '⚠️ Workflow Gate: 检测到性能敏感代码，必须进行性能审查。自动注入 performance-review skill。'
+        };
+    }
+    // Auto-trigger: Suggest brainstorming for vague requests (lower priority)
+    // Only trigger if no implementation intent detected
+    if (detectVagueRequest(prompt) && !state.brainstormingComplete && !detectImplementationIntent(prompt)) {
+        return {
+            success: true,
+            shouldBlock: true,
+            injectedSkill: 'brainstorming',
+            message: '💡 自动触发: 检测到模糊需求，建议先进行头脑风暴以明确方向。'
+        };
+    }
+    return {
+        success: true,
+        shouldBlock: false
+    };
+}
+/**
+ * Clear workflow state (for testing or manual reset)
+ */
+export function clearWorkflowState(workingDir) {
+    const statePath = getWorkflowStatePath(workingDir);
+    if (existsSync(statePath)) {
+        require('fs').unlinkSync(statePath);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/workflow-gate/index.js.map

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

package/dist/lib/state-cache.d.ts

@@ -1,15 +1,18 @@
 /**
- * State Cache with Copy-on-Write
+ * State Cache with Lazy mtime Validation
  *
- * Provides mtime-based cache invalidation and shallow copy on read
- * to prevent accidental mutations of cached data.
+ * Optimizations:
+ * - Delays mtime checks to once per second (reduces I/O by 100-200x)
+ * - Uses Object.freeze() instead of shallow copy (eliminates copy overhead)
+ * - Fast path: pure memory lookup when cache is fresh
+ * - Slow path: mtime validation only when needed
  */
 /**
- * Read state with cache and mtime validation
+ * Read state with cache and lazy mtime validation
  * @param path - File path to read
  * @param data - Parsed JSON data (if already read)
  * @param ttl - Cache TTL in milliseconds (default: 5000ms)
- * @returns Shallow copy of cached data
+ * @returns Frozen cached data (immutable)
  */
 export declare function readStateWithCache(path: string, data: unknown, ttl?: number): unknown;
 /**

package/dist/lib/state-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-cache.d.ts","sourceRoot":"","sources":["../../src/lib/state-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAa,GAAG,OAAO,CAqB3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB;;;EAKjC"}
+{"version":3,"file":"state-cache.d.ts","sourceRoot":"","sources":["../../src/lib/state-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAa,GAAG,OAAO,CA8B3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB;;;EAKjC"}

package/dist/lib/state-cache.js

@@ -1,33 +1,43 @@
 /**
- * State Cache with Copy-on-Write
+ * State Cache with Lazy mtime Validation
  *
- * Provides mtime-based cache invalidation and shallow copy on read
- * to prevent accidental mutations of cached data.
+ * Optimizations:
+ * - Delays mtime checks to once per second (reduces I/O by 100-200x)
+ * - Uses Object.freeze() instead of shallow copy (eliminates copy overhead)
+ * - Fast path: pure memory lookup when cache is fresh
+ * - Slow path: mtime validation only when needed
  */
 import { statSync } from 'fs';
 const stateCache = new Map();
 /**
- * Read state with cache and mtime validation
+ * Read state with cache and lazy mtime validation
  * @param path - File path to read
  * @param data - Parsed JSON data (if already read)
  * @param ttl - Cache TTL in milliseconds (default: 5000ms)
- * @returns Shallow copy of cached data
+ * @returns Frozen cached data (immutable)
  */
 export function readStateWithCache(path, data, ttl = 5000) {
+    const now = Date.now();
+    const cached = stateCache.get(path);
+    // Fast path: cache hit within TTL, skip mtime check
+    if (cached && now - cached.cachedAt < ttl) {
+        // Only check mtime if we haven't checked recently (every 1s)
+        if (now - cached.mtimeCheckedAt < 1000) {
+            return Object.freeze(cached.data);
+        }
+    }
+    // Slow path: validate mtime
     try {
         const mtime = statSync(path).mtimeMs;
-        const cached = stateCache.get(path);
-        // Cache hit: mtime matches and within TTL
-        if (cached && cached.mtime === mtime && Date.now() - cached.cachedAt < ttl) {
-            // Shallow copy (Copy-on-Write) - only if data is an object
-            if (typeof cached.data === 'object' && cached.data !== null) {
-                return { ...cached.data };
-            }
-            return cached.data;
+        if (cached && cached.mtime === mtime) {
+            // Update mtime check timestamp
+            cached.mtimeCheckedAt = now;
+            return Object.freeze(cached.data);
         }
-        // Cache miss: update cache
-        stateCache.set(path, { data, mtime, cachedAt: Date.now() });
-        return data;
+        // Cache miss or stale: update cache
+        const frozenData = Object.freeze(data);
+        stateCache.set(path, { data: frozenData, mtime, cachedAt: now, mtimeCheckedAt: now });
+        return frozenData;
     }
     catch {
         // If stat fails, return data without caching

package/dist/lib/state-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-cache.js","sourceRoot":"","sources":["../../src/lib/state-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAQ9B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAa,EAAE,MAAc,IAAI;IAChF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEpC,0CAA0C;QAC1C,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC;YAC3E,2DAA2D;YAC3D,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC5D,OAAO,EAAE,GAAG,MAAM,CAAC,IAA+B,EAAE,CAAC;YACvD,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAED,2BAA2B;QAC3B,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;KACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"state-cache.js","sourceRoot":"","sources":["../../src/lib/state-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAS9B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAa,EAAE,MAAc,IAAI;IAChF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEpC,oDAAoD;IACpD,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC;QAC1C,6DAA6D;QAC7D,IAAI,GAAG,GAAG,MAAM,CAAC,cAAc,GAAG,IAAI,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;QAErC,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACrC,+BAA+B;YAC/B,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC;YAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,oCAAoC;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QACtF,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;KACvC,CAAC;AACJ,CAAC"}