agile-context-engineering 0.3.0 → 0.5.1

package/hooks/ace-check-update.js

@@ -1,62 +1,71 @@
-#!/usr/bin/env node
-// Check for ACE updates in background, write result to cache
-// Called by SessionStart hook - runs once per session
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { spawn } = require('child_process');
-
-const homeDir = os.homedir();
-const cwd = process.cwd();
-const cacheDir = path.join(homeDir, '.claude', 'cache');
-const cacheFile = path.join(cacheDir, 'ace-update-check.json');
-
-// VERSION file locations (check project first, then global)
-const projectVersionFile = path.join(cwd, '.claude', 'agile-context-engineering', 'VERSION');
-const globalVersionFile = path.join(homeDir, '.claude', 'agile-context-engineering', 'VERSION');
-
-// Ensure cache directory exists
-if (!fs.existsSync(cacheDir)) {
-  fs.mkdirSync(cacheDir, { recursive: true });
-}
-
-// Run check in background (spawn detached process, windowsHide prevents console flash)
-const child = spawn(process.execPath, ['-e', `
-  const fs = require('fs');
-  const { execSync } = require('child_process');
-
-  const cacheFile = ${JSON.stringify(cacheFile)};
-  const projectVersionFile = ${JSON.stringify(projectVersionFile)};
-  const globalVersionFile = ${JSON.stringify(globalVersionFile)};
-
-  // Check project directory first (local install), then global
-  let installed = '0.0.0';
-  try {
-    if (fs.existsSync(projectVersionFile)) {
-      installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
-    } else if (fs.existsSync(globalVersionFile)) {
-      installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
-    }
-  } catch (e) {}
-
-  let latest = null;
-  try {
-    latest = execSync('npm view agile-context-engineering version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
-  } catch (e) {}
-
-  const result = {
-    update_available: latest && installed !== latest,
-    installed,
-    latest: latest || 'unknown',
-    checked: Math.floor(Date.now() / 1000)
-  };
-
-  fs.writeFileSync(cacheFile, JSON.stringify(result));
-`], {
-  stdio: 'ignore',
-  windowsHide: true,
-  detached: true
-});
-
-child.unref();
+#!/usr/bin/env node
+// Check for ACE updates in background, write result to cache
+// Called by SessionStart hook - runs once per session
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+// Use CLAUDE_PLUGIN_DATA for persistent cache (survives plugin updates)
+// Use CLAUDE_PLUGIN_ROOT to find the bundled VERSION file
+const pluginData = process.env.CLAUDE_PLUGIN_DATA;
+const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT;
+
+// Fallback for legacy standalone installs
+const homeDir = os.homedir();
+const cwd = process.cwd();
+
+const cacheDir = pluginData || path.join(homeDir, '.claude', 'cache');
+const cacheFile = path.join(cacheDir, 'ace-update-check.json');
+
+// VERSION file: prefer plugin root, then legacy locations
+const versionFiles = [
+  pluginRoot ? path.join(pluginRoot, 'shared', 'VERSION') : null,
+  path.join(cwd, '.claude', 'shared', 'VERSION'),
+  path.join(homeDir, '.claude', 'shared', 'VERSION'),
+].filter(Boolean);
+
+// Ensure cache directory exists
+if (!fs.existsSync(cacheDir)) {
+  fs.mkdirSync(cacheDir, { recursive: true });
+}
+
+// Run check in background (spawn detached process, windowsHide prevents console flash)
+const child = spawn(process.execPath, ['-e', `
+  const fs = require('fs');
+  const { execSync } = require('child_process');
+
+  const cacheFile = ${JSON.stringify(cacheFile)};
+  const versionFiles = ${JSON.stringify(versionFiles)};
+
+  let installed = '0.0.0';
+  try {
+    for (const vf of versionFiles) {
+      if (fs.existsSync(vf)) {
+        installed = fs.readFileSync(vf, 'utf8').trim();
+        break;
+      }
+    }
+  } catch (e) {}
+
+  let latest = null;
+  try {
+    latest = execSync('npm view agile-context-engineering version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
+  } catch (e) {}
+
+  const result = {
+    update_available: latest && installed !== latest,
+    installed,
+    latest: latest || 'unknown',
+    checked: Math.floor(Date.now() / 1000)
+  };
+
+  fs.writeFileSync(cacheFile, JSON.stringify(result));
+`], {
+  stdio: 'ignore',
+  windowsHide: true,
+  detached: true
+});
+
+child.unref();

package/hooks/ace-statusline.js

@@ -1,89 +1,107 @@
-#!/usr/bin/env node
-// Claude Code Statusline - ACE Edition
-// Shows: update indicator | model | current task | directory | context usage
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Read JSON from stdin
-let input = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => input += chunk);
-process.stdin.on('end', () => {
-  try {
-    const data = JSON.parse(input);
-    const model = data.model?.display_name || 'Claude';
-    const dir = data.workspace?.current_dir || process.cwd();
-    const session = data.session_id || '';
-    const remaining = data.context_window?.remaining_percentage;
-
-    // Context window display (shows USED percentage scaled to 80% limit)
-    // Claude Code enforces an 80% context limit, so we scale to show 100% at that point
-    let ctx = '';
-    if (remaining != null) {
-      const rem = Math.round(remaining);
-      const rawUsed = Math.max(0, Math.min(100, 100 - rem));
-      // Scale: 80% real usage = 100% displayed
-      const used = Math.min(100, Math.round((rawUsed / 80) * 100));
-
-      // Build progress bar (10 segments)
-      const filled = Math.floor(used / 10);
-      const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(10 - filled);
-
-      // Color based on scaled usage
-      if (used < 63) {
-        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
-      } else if (used < 81) {
-        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
-      } else if (used < 95) {
-        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
-      } else {
-        ctx = ` \x1b[5;31m\u{1F480} ${bar} ${used}%\x1b[0m`;
-      }
-    }
-
-    // Current task from todos
-    let task = '';
-    const homeDir = os.homedir();
-    const todosDir = path.join(homeDir, '.claude', 'todos');
-    if (session && fs.existsSync(todosDir)) {
-      try {
-        const files = fs.readdirSync(todosDir)
-          .filter(f => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
-          .map(f => ({ name: f, mtime: fs.statSync(path.join(todosDir, f)).mtime }))
-          .sort((a, b) => b.mtime - a.mtime);
-
-        if (files.length > 0) {
-          try {
-            const todos = JSON.parse(fs.readFileSync(path.join(todosDir, files[0].name), 'utf8'));
-            const inProgress = todos.find(t => t.status === 'in_progress');
-            if (inProgress) task = inProgress.activeForm || '';
-          } catch (e) {}
-        }
-      } catch (e) {}
-    }
-
-    // ACE update available?
-    let aceUpdate = '';
-    const cacheFile = path.join(homeDir, '.claude', 'cache', 'ace-update-check.json');
-    if (fs.existsSync(cacheFile)) {
-      try {
-        const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
-        if (cache.update_available) {
-          aceUpdate = '\x1b[33m\u2B06 /ace:update\x1b[0m \u2502 ';
-        }
-      } catch (e) {}
-    }
-
-    // Output
-    const dirname = path.basename(dir);
-    if (task) {
-      process.stdout.write(`${aceUpdate}\x1b[2m${model}\x1b[0m \u2502 \x1b[1m${task}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${ctx}`);
-    } else {
-      process.stdout.write(`${aceUpdate}\x1b[2m${model}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${ctx}`);
-    }
-  } catch (e) {
-    // Silent fail - don't break statusline on parse errors
-  }
-});
+#!/usr/bin/env node
+// Claude Code Statusline - ACE Edition
+// Shows: update indicator | model | current task | directory | context usage
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// Read JSON from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    const model = data.model?.display_name || 'Claude';
+    const dir = data.workspace?.current_dir || process.cwd();
+    const session = data.session_id || '';
+    const remaining = data.context_window?.remaining_percentage;
+
+    // Context window display (shows USED percentage scaled to 80% limit)
+    // Claude Code enforces an 80% context limit, so we scale to show 100% at that point
+    let ctx = '';
+    if (remaining != null) {
+      const rem = Math.round(remaining);
+      const rawUsed = Math.max(0, Math.min(100, 100 - rem));
+      // Scale: 80% real usage = 100% displayed
+      const used = Math.min(100, Math.round((rawUsed / 80) * 100));
+
+      // Build progress bar (10 segments)
+      const filled = Math.floor(used / 10);
+      const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(10 - filled);
+
+      // Color based on scaled usage
+      if (used < 63) {
+        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
+      } else if (used < 81) {
+        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
+      } else if (used < 95) {
+        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
+      } else {
+        ctx = ` \x1b[5;31m\u{1F480} ${bar} ${used}%\x1b[0m`;
+      }
+    }
+
+    // Current task from todos (Claude Code internal directory — always ~/.claude/)
+    let task = '';
+    const homeDir = os.homedir();
+    const todosDir = path.join(homeDir, '.claude', 'todos');
+    if (session && fs.existsSync(todosDir)) {
+      try {
+        const files = fs.readdirSync(todosDir)
+          .filter(f => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
+          .map(f => ({ name: f, mtime: fs.statSync(path.join(todosDir, f)).mtime }))
+          .sort((a, b) => b.mtime - a.mtime);
+
+        if (files.length > 0) {
+          try {
+            const todos = JSON.parse(fs.readFileSync(path.join(todosDir, files[0].name), 'utf8'));
+            const inProgress = todos.find(t => t.status === 'in_progress');
+            if (inProgress) task = inProgress.activeForm || '';
+          } catch (e) {}
+        }
+      } catch (e) {}
+    }
+
+    // ACE update available? Check plugin data dir first, then legacy location
+    let aceUpdate = '';
+    const pluginData = process.env.CLAUDE_PLUGIN_DATA;
+    const cacheLocations = [
+      pluginData ? path.join(pluginData, 'ace-update-check.json') : null,
+      path.join(homeDir, '.claude', 'cache', 'ace-update-check.json'),
+    ].filter(Boolean);
+
+    for (const cacheFile of cacheLocations) {
+      if (fs.existsSync(cacheFile)) {
+        try {
+          const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+          if (cache.update_available) {
+            aceUpdate = '\x1b[33m\u2B06 /ace:update\x1b[0m \u2502 ';
+          }
+          break;
+        } catch (e) {}
+      }
+    }
+
+    // Git branch
+    let branch = '';
+    try {
+      const raw = execSync('git rev-parse --abbrev-ref HEAD', { cwd: dir, encoding: 'utf8', timeout: 2000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true }).trim();
+      if (raw && raw !== 'HEAD') {
+        branch = ` \x1b[36m\u2387 ${raw}\x1b[0m`;
+      }
+    } catch {}
+
+    // Output
+    const dirname = path.basename(dir);
+    if (task) {
+      process.stdout.write(`${aceUpdate}\x1b[2m${model}\x1b[0m \u2502 \x1b[1m${task}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${branch}${ctx}`);
+    } else {
+      process.stdout.write(`${aceUpdate}\x1b[2m${model}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${branch}${ctx}`);
+    }
+  } catch (e) {
+    // Silent fail - don't break statusline on parse errors
+  }
+});

package/hooks/hooks.json

@@ -0,0 +1,14 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/ace-check-update.js\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agile-context-engineering",
-  "version": "0.3.0",
-  "description": "ACE - Agile Context Engineering: A spec-driven development system for Claude Code and Crush (formerly OpenCode) with Agile workflows",
+  "version": "0.5.1",
+  "description": "ACE - Agile Context Engineering: a spec-driven development system for Claude Code, Codex, and Crush with Agile workflows",
   "main": "index.js",
   "bin": {
     "agile-context-engineering": "bin/install.js",
@@ -9,17 +9,19 @@
   },
   "files": [
     "bin",
-    "commands",
+    "skills",
+    "shared",
     "agents",
     "hooks",
-    "agile-context-engineering",
+    ".claude-plugin",
     "CHANGELOG.md"
   ],
   "scripts": {
-    "test": "node --test agile-context-engineering/src/ace-tools.test.js"
+    "test": "node --test shared/lib/*.test.js skills/*/script.test.js"
   },
   "keywords": [
     "claude-code",
+    "codex",
     "crush",
     "opencode",
     "anthropic",