@zhuan-ai/zhuanspec 2.11.15 → 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,8 +251,23 @@ 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') {
+        // 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
-        if (filePath.includes('zhuanspec/changes/') || filePath.includes('zhuanspec/specs/')) {
+        // 修复：用正则匹配，同时兼容绝对路径和相对路径
+        // 匹配： 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',

package/dist/core/templates/slash-command-templates.js

@@ -89,7 +89,6 @@ const proposalSteps = `**步骤**
    - **获取方式**：若用户提供链接（格式：\`https://zzcase.zhuanspirit.com/plan/taskDetail/module/{moduleId}/task/{taskId}\`），从 URL 路径中提取 \`moduleId\`，调用 MCP 工具 \`mcp__caseweb__GET_get2\` 读取数据；否则手动录入
    - **创建 test-cases.md**（路径：\`changes/<change-id>/test-cases.md\`），使用 \`getTestCasesTemplate\` 模板，每个 TC-XXX 包含：前置条件、测试步骤、预期结果、验收点
    - tasks.md 中使用 \`@test-case:TC-XXX\` 关联任务与测试 case，表格四列：Task、测试 Case ID、测试 Case 文件路径、覆盖场景
-   - 任务实施顺序调整为：先写测试 → 再写实现 → 验证测试通过
 
    用户选择"暂不提供"：跳过，按常规流程继续
    用户选择"其他"：等待用户补充说明后继续

package/package.json

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