wogiflow 2.0.0 → 2.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wogiflow",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "AI-powered development workflow management system with multi-model support",
   "main": "lib/index.js",
   "bin": {

package/scripts/flow-paths.js

@@ -116,6 +116,8 @@ const PATHS = {
   epics: path.join(WORKFLOW_DIR, 'epics'),
   features: path.join(WORKFLOW_DIR, 'features'),
   plans: path.join(WORKFLOW_DIR, 'plans'),
+  // Scratch directory for temporary files (auto-cleaned at session end)
+  scratch: path.join(WORKFLOW_DIR, 'scratch'),
   // Additional workflow directories
   runs: path.join(WORKFLOW_DIR, 'runs'),
   checkpoints: path.join(WORKFLOW_DIR, 'checkpoints'),

package/scripts/flow-version-check.js

@@ -119,17 +119,20 @@ function checkClaudeCodeVersionOnce() {
     return `Claude Code ${version} is below the minimum required version (${HARD_MIN.major}.${HARD_MIN.minor}.${HARD_MIN.patch}). WogiFlow hooks will not work correctly. Update with: npm install -g @anthropic-ai/claude-code@latest`;
   }
 
-  // Soft gates — degrade gracefully, no warning
-  // 2.1.50+: worktree hooks, agent isolation
-  // 2.1.72+: ExitWorktree, effort levels, model param on Agent
-  // 2.1.73+: SessionStart double-fire fix, hook context pollution fix, modelOverrides, subagent model fix
-  // 2.1.75+: 1M context default (Max/Team/Enterprise), accurate token estimation,
-  //          async hook completion suppressed by default, hook source in permission prompts,
-  //          memory file last-modified timestamps
-  // 2.1.76+: PostCompact hook (state recovery after compaction), Elicitation/ElicitationResult hooks
-  //          (MCP structured input), worktree.sparsePaths (sparse checkout for monorepos),
-  //          /effort slash command, deferred tools schema fix after compaction,
-  //          auto-compaction circuit breaker (3 retries), background agent partial results preserved
+  // Soft gates — generate informational warning listing disabled features
+  const SOFT_GATES = [
+    { version: [2, 1, 50], features: 'worktree hooks, agent isolation' },
+    { version: [2, 1, 72], features: 'ConfigChange/InstructionsLoaded hooks, effort levels' },
+    { version: [2, 1, 76], features: 'PostCompact hook (state recovery after compaction)' },
+  ];
+
+  const disabledFeatures = SOFT_GATES
+    .filter(gate => !meetsVersion(major, minor, patch, ...gate.version))
+    .map(gate => `  - ${gate.features} (requires ${gate.version.join('.')}+)`);
+
+  if (disabledFeatures.length > 0) {
+    return `Claude Code ${version} — some WogiFlow features are disabled:\n${disabledFeatures.join('\n')}\nUpdate for full functionality: npm i -g @anthropic-ai/claude-code@latest`;
+  }
 
   return null;
 }

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/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;