wogiflow 2.0.0 → 2.1.0

package/scripts/hooks/core/session-context.js

@@ -796,6 +796,18 @@ function formatContextForInjection(context) {
     output += `\`\`\`bash\nunset CLAUDE_CODE_SIMPLE\n\`\`\`\n\n`;
   }
 
+  // Version compatibility warning (Claude Code below hard minimum or missing features)
+  if (ctx.versionWarning) {
+    output += `### Version Warning\n`;
+    output += `${ctx.versionWarning}\n\n`;
+  }
+
+  // WogiFlow npm update available
+  if (ctx.updateWarning) {
+    output += `### Update Available\n`;
+    output += `${ctx.updateWarning}\n\n`;
+  }
+
   // PRIORITY: Setup required - show first if needs setup
   if (ctx.setupRequired && ctx.setupRequired.needsSetup) {
     output += `### ⚠️ Setup Required\n`;

package/scripts/hooks/core/session-end.js

@@ -68,6 +68,38 @@ function handleSessionEnd(input) {
       result.logged = false;
     }
 
+    // Scratch directory cleanup — remove temp files created during session
+    try {
+      const fs = require('node:fs');
+      const path = require('node:path');
+      const scratchDir = path.join(PATHS.workflow, 'scratch');
+      if (fs.existsSync(scratchDir)) {
+        const files = fs.readdirSync(scratchDir);
+        let scratchCleaned = 0;
+        for (const file of files) {
+          if (file === '.gitkeep') continue; // Keep the directory marker
+          try {
+            const filePath = path.join(scratchDir, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isFile()) {
+              fs.unlinkSync(filePath);
+              scratchCleaned++;
+            } else if (stat.isDirectory()) {
+              fs.rmSync(filePath, { recursive: true, force: true });
+              scratchCleaned++;
+            }
+          } catch (_err) {
+            // Skip files that can't be deleted
+          }
+        }
+        if (scratchCleaned > 0) {
+          result.scratchCleaned = scratchCleaned;
+        }
+      }
+    } catch (_err) {
+      // Non-critical — never block session end
+    }
+
     // State folder hygiene — clean stale/orphan files (fire-and-forget)
     try {
       const hygiene = cleanStaleFiles();

package/scripts/hooks/core/task-completed.js

@@ -251,6 +251,19 @@ async function handleTaskCompleted(input) {
     } catch (_err) {
       // Non-critical - registry manager may not be available
     }
+    // Check pending queue — notify user if items are waiting
+    try {
+      const { getPendingCount } = require('../../flow-pending');
+      const pendingCount = getPendingCount();
+      if (pendingCount > 0) {
+        result.pendingQueue = {
+          count: pendingCount,
+          message: `You have ${pendingCount} pending item${pendingCount !== 1 ? 's' : ''} queued. Run /wogi-pending --list to review, or I'll process them next.`
+        };
+      }
+    } catch (_err) {
+      // Non-critical — pending module may not be available
+    }
   } catch (err) {
     result.message = `Task completed handler error: ${err.message}`;
   }

package/scripts/postinstall.js

@@ -105,7 +105,8 @@ function createMinimalStructure() {
     WORKFLOW_DIR,
     STATE_DIR,
     path.join(WORKFLOW_DIR, 'changes'),
-    path.join(WORKFLOW_DIR, 'specs')
+    path.join(WORKFLOW_DIR, 'specs'),
+    path.join(WORKFLOW_DIR, 'scratch')
   ];
 
   for (const dir of dirs) {
@@ -244,6 +245,82 @@ function copyDir(src, dest, mergeMode = false, depth = 0) {
   }
 }
 
+/**
+ * Hook types and the minimum Claude Code version that supports them.
+ * Claude Code rejects the ENTIRE settings.json if any hook key is unrecognized,
+ * so we must exclude hooks that the installed version doesn't support.
+ */
+const HOOK_VERSION_MAP = {
+  // Hooks available since 2.1.23 (HARD_MIN)
+  SessionStart: { major: 2, minor: 1, patch: 23 },
+  UserPromptSubmit: { major: 2, minor: 1, patch: 23 },
+  PreToolUse: { major: 2, minor: 1, patch: 23 },
+  PostToolUse: { major: 2, minor: 1, patch: 23 },
+  Stop: { major: 2, minor: 1, patch: 23 },
+  SessionEnd: { major: 2, minor: 1, patch: 23 },
+  TaskCompleted: { major: 2, minor: 1, patch: 23 },
+  // Hooks added in 2.1.50+
+  WorktreeCreate: { major: 2, minor: 1, patch: 50 },
+  WorktreeRemove: { major: 2, minor: 1, patch: 50 },
+  // Hooks added in 2.1.72+
+  ConfigChange: { major: 2, minor: 1, patch: 72 },
+  InstructionsLoaded: { major: 2, minor: 1, patch: 72 },
+  // Hooks added in 2.1.76+
+  PostCompact: { major: 2, minor: 1, patch: 76 },
+};
+
+/**
+ * Detect Claude Code version.
+ * @returns {{ major: number, minor: number, patch: number } | null}
+ */
+function detectClaudeCodeVersion() {
+  try {
+    const output = execFileSync('claude', ['--version'], {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000
+    }).trim();
+    const match = output.match(/(\d+)\.(\d+)\.(\d+)/);
+    if (match) {
+      return { major: parseInt(match[1], 10), minor: parseInt(match[2], 10), patch: parseInt(match[3], 10) };
+    }
+  } catch (_err) {
+    // Claude CLI not available — can't detect version
+  }
+  return null;
+}
+
+/**
+ * Check if version A meets minimum version B.
+ * @returns {boolean}
+ */
+function versionMeetsMinimum(version, minimum) {
+  if (version.major !== minimum.major) return version.major > minimum.major;
+  if (version.minor !== minimum.minor) return version.minor > minimum.minor;
+  return version.patch >= minimum.patch;
+}
+
+/**
+ * Remove hook types from settings.json that the installed Claude Code version doesn't support.
+ * Claude Code rejects the ENTIRE settings file if any hook key is unrecognized.
+ * @param {Object} settings - Parsed settings object (mutated in place)
+ * @param {{ major: number, minor: number, patch: number } | null} ccVersion - Detected version
+ * @returns {string[]} List of removed hook names
+ */
+function stripUnsupportedHooks(settings, ccVersion) {
+  if (!settings || !settings.hooks || !ccVersion) return [];
+
+  const removed = [];
+  for (const hookName of Object.keys(settings.hooks)) {
+    const minVersion = HOOK_VERSION_MAP[hookName];
+    if (minVersion && !versionMeetsMinimum(ccVersion, minVersion)) {
+      delete settings.hooks[hookName];
+      removed.push(`${hookName} (requires ${minVersion.major}.${minVersion.minor}.${minVersion.patch}+)`);
+    }
+  }
+  return removed;
+}
+
 /**
  * Rewrite hook command paths from local dev paths to package paths.
  * The package's settings.json uses local paths (node scripts/hooks/...)
@@ -319,6 +396,18 @@ function copyClaudeResources() {
         // Rewrite hook paths: package uses local dev paths (node scripts/hooks/...)
         // but user projects need package paths (node node_modules/wogiflow/scripts/hooks/...)
         rewriteHookPaths(ours);
+        // Strip hooks unsupported by the installed Claude Code version.
+        // Claude Code rejects the ENTIRE settings.json if any hook key is unrecognized,
+        // so we must exclude hooks that the version doesn't support.
+        const ccVersion = detectClaudeCodeVersion();
+        const removedHooks = stripUnsupportedHooks(ours, ccVersion);
+        if (removedHooks.length > 0) {
+          console.log(`[wogiflow] Claude Code ${ccVersion.major}.${ccVersion.minor}.${ccVersion.patch} detected. Excluded unsupported hooks:`);
+          for (const h of removedHooks) {
+            console.log(`  - ${h}`);
+          }
+          console.log('[wogiflow] Update Claude Code for full functionality: npm i -g @anthropic-ai/claude-code@latest');
+        }
         // Always update hooks (core WogiFlow functionality)
         existing.hooks = ours.hooks;
         existing._wogiFlowManaged = true;