@zhuan-ai/zhuanspec 2.11.16 → 2.11.19

package/dist/core/hooks/deviation-check.js

@@ -70,9 +70,11 @@ export async function deviationCheckHook(options) {
     const toolName = options.tool || 'Write';
     // Read stdin for Claude Code hook input
     let stdinData = {};
+    let rawStdin = '';
     try {
         const stdinContent = await readStdin();
         if (stdinContent) {
+            rawStdin = stdinContent;
             stdinData = JSON.parse(stdinContent);
         }
     }
@@ -80,9 +82,20 @@ export async function deviationCheckHook(options) {
         // Ignore parse errors
     }
     // Get file path from stdin or options
-    const filePath = stdinData.tool_input?.file_path
+    // 兼容 Claude Code 两种输入形态：tool_input.file_path 或 tool_input.path
+    const toolInput = stdinData.tool_input || {};
+    const filePath = toolInput.file_path
+        || toolInput.path
+        || toolInput.notebook_path
         || options.file
         || '';
+    // DEBUG: 临时记录 stdin 与解析结果，定位路径传递问题后移除
+    try {
+        fs.appendFileSync('/tmp/zhuanspec-deviation-debug.log', `[${new Date().toISOString()}] phase=${process.env.ZHUANSPEC_PHASE} tool=${toolName} filePath="${filePath}"\n  raw=${rawStdin.slice(0, 500)}\n`, 'utf-8');
+    }
+    catch {
+        // ignore
+    }
     const promptText = stdinData?.prompt
         || options.prompt
         || '';
@@ -238,13 +251,28 @@ async function runDeviationCheck(filePath, trigger, promptText, _options) {
     // Propose phase → block all code modifications (Iron Law 1: No Spec No Code)
     // But check if we can transition to Apply phase
     if (phase === 'propose') {
-        // TODO: 路径匹配对相对路径不准，先注释掉放行分支（后续用正则+白名单修复）
-        // if (filePath.includes('zhuanspec/changes/') || filePath.includes('zhuanspec/specs/')) {
-        //   return {
-        //     continue: true,
-        //     systemMessage: '✓ Proposal file modification allowed in propose phase',
-        //   };
-        // }
+        // UserPromptSubmit(post-prompt) 和 resume 无 filePath 上下文，静默放行，仅 pre-tool 做拦截
+        if (trigger !== 'pre-tool') {
+            return { continue: true };
+        }
+        // 兼底：若 filePath 为空（stdin 未传 / 解析失败），不拦截，避免误伤用户修改提案文件
+        if (!filePath) {
+            return {
+                continue: true,
+                systemMessage: '⚠️ deviation-check: filePath empty, skip (see /tmp/zhuanspec-deviation-debug.log)',
+            };
+        }
+        // Allow proposal file modifications
+        // 修复：用正则匹配，同时兼容绝对路径和相对路径
+        // 匹配： changes/xxx / zhuanspec/changes/xxx / /abs/.../changes/xxx
+        const isProposalArtifact = /(?:^|\/)(?:zhuanspec\/)?changes\//.test(filePath) ||
+            /(?:^|\/)(?:zhuanspec\/)?specs\//.test(filePath);
+        if (isProposalArtifact) {
+            return {
+                continue: true,
+                systemMessage: '✓ Proposal file modification allowed in propose phase',
+            };
+        }
         // Check if this is a code file that might trigger Apply phase transition
         const isCodeFile = !filePath.includes('zhuanspec/') &&
             /\.(java|ts|tsx|js|jsx|py|go|rs|sql|kt|scala|c|cpp|cs)$/i.test(filePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuan-ai/zhuanspec",
-  "version": "2.11.16",
+  "version": "2.11.19",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "zhuanspec",