agileflow 2.78.0 → 2.80.0

package/README.md

@@ -3,8 +3,8 @@
 </p>
 
 [![npm version](https://img.shields.io/npm/v/agileflow?color=brightgreen)](https://www.npmjs.com/package/agileflow)
-[![Commands](https://img.shields.io/badge/commands-68-blue)](docs/04-architecture/commands.md)
-[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-27-orange)](docs/04-architecture/subagents.md)
+[![Commands](https://img.shields.io/badge/commands-69-blue)](docs/04-architecture/commands.md)
+[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-28-orange)](docs/04-architecture/subagents.md)
 [![Skills](https://img.shields.io/badge/skills-dynamic-purple)](docs/04-architecture/skills.md)
 
 **AI-driven agile development for Claude Code, Cursor, Windsurf, OpenAI Codex CLI, and more.** Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.
@@ -65,8 +65,8 @@ AgileFlow combines three proven methodologies:
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| [Commands](docs/04-architecture/commands.md) | 68 | Slash commands for agile workflows |
-| [Agents/Experts](docs/04-architecture/subagents.md) | 27 | Specialized agents with self-improving knowledge bases |
+| [Commands](docs/04-architecture/commands.md) | 69 | Slash commands for agile workflows |
+| [Agents/Experts](docs/04-architecture/subagents.md) | 28 | Specialized agents with self-improving knowledge bases |
 | [Skills](docs/04-architecture/skills.md) | Dynamic | Generated on-demand with `/agileflow:skill:create` |
 
 ---
@@ -76,8 +76,8 @@ AgileFlow combines three proven methodologies:
 Full documentation lives in [`docs/04-architecture/`](docs/04-architecture/):
 
 ### Reference
-- [Commands](docs/04-architecture/commands.md) - All 68 slash commands
-- [Agents/Experts](docs/04-architecture/subagents.md) - 27 specialized agents with self-improving knowledge
+- [Commands](docs/04-architecture/commands.md) - All 69 slash commands
+- [Agents/Experts](docs/04-architecture/subagents.md) - 28 specialized agents with self-improving knowledge
 - [Skills](docs/04-architecture/skills.md) - Dynamic skill generator with MCP integration
 
 ### Architecture

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.78.0",
+  "version": "2.80.0",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

package/scripts/agileflow-configure.js

@@ -23,7 +23,7 @@
  *   --detect                            Show current status
  *   --help                              Show help
  *
- * Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, autoupdate, damagecontrol
+ * Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, autoupdate, damagecontrol, askuserquestion
  */
 
 const fs = require('fs');
@@ -81,6 +81,7 @@ const FEATURES = {
     scripts: ['damage-control-bash.js', 'damage-control-edit.js', 'damage-control-write.js'],
     patternsFile: 'damage-control-patterns.yaml',
   },
+  askuserquestion: { metadataOnly: true }, // Stored in metadata.features.askUserQuestion
 };
 
 // Complete registry of all scripts that may need repair
@@ -131,24 +132,40 @@ const STATUSLINE_COMPONENTS = [
 const PROFILES = {
   full: {
     description: 'All features enabled (including experimental Stop hooks)',
-    enable: ['sessionstart', 'precompact', 'archival', 'statusline', 'ralphloop', 'selfimprove'],
+    enable: [
+      'sessionstart',
+      'precompact',
+      'archival',
+      'statusline',
+      'ralphloop',
+      'selfimprove',
+      'askuserquestion',
+    ],
     archivalDays: 30,
   },
   basic: {
     description: 'Essential hooks + archival (SessionStart + PreCompact + Archival)',
-    enable: ['sessionstart', 'precompact', 'archival'],
+    enable: ['sessionstart', 'precompact', 'archival', 'askuserquestion'],
     disable: ['statusline', 'ralphloop', 'selfimprove'],
     archivalDays: 30,
   },
   minimal: {
     description: 'SessionStart + archival only',
     enable: ['sessionstart', 'archival'],
-    disable: ['precompact', 'statusline', 'ralphloop', 'selfimprove'],
+    disable: ['precompact', 'statusline', 'ralphloop', 'selfimprove', 'askuserquestion'],
     archivalDays: 30,
   },
   none: {
     description: 'Disable all AgileFlow features',
-    disable: ['sessionstart', 'precompact', 'archival', 'statusline', 'ralphloop', 'selfimprove'],
+    disable: [
+      'sessionstart',
+      'precompact',
+      'archival',
+      'statusline',
+      'ralphloop',
+      'selfimprove',
+      'askuserquestion',
+    ],
   },
 };
 
@@ -223,7 +240,23 @@ function detectConfig() {
       selfimprove: { enabled: false, valid: true, issues: [], version: null, outdated: false },
       archival: { enabled: false, threshold: null, version: null, outdated: false },
       statusline: { enabled: false, valid: true, issues: [], version: null, outdated: false },
-      damagecontrol: { enabled: false, valid: true, issues: [], version: null, outdated: false, level: null, patternCount: 0 },
+      damagecontrol: {
+        enabled: false,
+        valid: true,
+        issues: [],
+        version: null,
+        outdated: false,
+        level: null,
+        patternCount: 0,
+      },
+      askuserquestion: {
+        enabled: false,
+        valid: true,
+        issues: [],
+        version: null,
+        outdated: false,
+        mode: null,
+      },
     },
     metadata: { exists: false, version: null },
     currentVersion: VERSION,
@@ -313,13 +346,16 @@ function detectConfig() {
           if (Array.isArray(settings.hooks.PreToolUse) && settings.hooks.PreToolUse.length > 0) {
             // Check for damage-control hooks by looking for damage-control scripts
             const hasBashHook = settings.hooks.PreToolUse.some(
-              h => h.matcher === 'Bash' && h.hooks?.some(hk => hk.command?.includes('damage-control'))
+              h =>
+                h.matcher === 'Bash' && h.hooks?.some(hk => hk.command?.includes('damage-control'))
             );
             const hasEditHook = settings.hooks.PreToolUse.some(
-              h => h.matcher === 'Edit' && h.hooks?.some(hk => hk.command?.includes('damage-control'))
+              h =>
+                h.matcher === 'Edit' && h.hooks?.some(hk => hk.command?.includes('damage-control'))
             );
             const hasWriteHook = settings.hooks.PreToolUse.some(
-              h => h.matcher === 'Write' && h.hooks?.some(hk => hk.command?.includes('damage-control'))
+              h =>
+                h.matcher === 'Write' && h.hooks?.some(hk => hk.command?.includes('damage-control'))
             );
 
             if (hasBashHook || hasEditHook || hasWriteHook) {
@@ -363,17 +399,30 @@ function detectConfig() {
 
       // Damage control metadata
       if (meta.features?.damagecontrol?.enabled) {
-        status.features.damagecontrol.level = meta.features.damagecontrol.protectionLevel || 'standard';
+        status.features.damagecontrol.level =
+          meta.features.damagecontrol.protectionLevel || 'standard';
+      }
+
+      // AskUserQuestion metadata
+      if (meta.features?.askUserQuestion?.enabled) {
+        status.features.askuserquestion.enabled = true;
+        status.features.askuserquestion.mode = meta.features.askUserQuestion.mode || 'all';
       }
 
       // Read feature versions from metadata and check if outdated
       if (meta.features) {
+        // Map metadata keys to status keys (handle camelCase differences)
+        const featureKeyMap = {
+          askUserQuestion: 'askuserquestion',
+        };
         Object.entries(meta.features).forEach(([feature, data]) => {
-          if (status.features[feature] && data.version) {
-            status.features[feature].version = data.version;
+          // Use mapped key if exists, otherwise lowercase
+          const statusKey = featureKeyMap[feature] || feature.toLowerCase();
+          if (status.features[statusKey] && data.version) {
+            status.features[statusKey].version = data.version;
             // Check if feature version differs from current VERSION
-            if (data.version !== VERSION && status.features[feature].enabled) {
-              status.features[feature].outdated = true;
+            if (data.version !== VERSION && status.features[statusKey].enabled) {
+              status.features[statusKey].outdated = true;
               status.hasOutdated = true;
             }
           }
@@ -458,6 +507,16 @@ function printStatus(status) {
     log(`  ❌ Damage Control: disabled`, c.dim);
   }
 
+  // AskUserQuestion
+  const auq = status.features.askuserquestion;
+  if (auq.enabled) {
+    let auqStatusText = 'enabled';
+    if (auq.mode) auqStatusText += ` (mode: ${auq.mode})`;
+    log(`  💬 AskUserQuestion: ${auqStatusText}`, c.green);
+  } else {
+    log(`  ❌ AskUserQuestion: disabled`, c.dim);
+  }
+
   // Metadata
   if (status.metadata.exists) {
     log(`\nMetadata: v${status.metadata.version}`, c.dim);
@@ -741,12 +800,34 @@ function enableFeature(feature, options = {}) {
     return true; // Skip settings.json write for this feature
   }
 
+  // Handle askuserquestion (metadata only, no hooks needed)
+  if (feature === 'askuserquestion') {
+    const mode = options.mode || 'all';
+    updateMetadata({
+      features: {
+        askUserQuestion: {
+          enabled: true,
+          mode: mode,
+          version: VERSION,
+          at: new Date().toISOString(),
+        },
+      },
+    });
+    success(`AskUserQuestion enabled (mode: ${mode})`);
+    info('All commands will end with AskUserQuestion tool for guided interaction');
+    return true; // Skip settings.json write for this feature
+  }
+
   // Handle damage control (PreToolUse hooks)
   if (feature === 'damagecontrol') {
     const level = options.protectionLevel || 'standard';
 
     // Verify all required scripts exist
-    const requiredScripts = ['damage-control-bash.js', 'damage-control-edit.js', 'damage-control-write.js'];
+    const requiredScripts = [
+      'damage-control-bash.js',
+      'damage-control-edit.js',
+      'damage-control-write.js',
+    ];
     for (const script of requiredScripts) {
       if (!scriptExists(script)) {
         error(`Script not found: ${getScriptPath(script)}`);
@@ -761,7 +842,12 @@ function enableFeature(feature, options = {}) {
     if (!fs.existsSync(patternsDest)) {
       ensureDir(patternsDir);
       // Try to copy from templates
-      const templatePath = path.join(process.cwd(), '.agileflow', 'templates', 'damage-control-patterns.yaml');
+      const templatePath = path.join(
+        process.cwd(),
+        '.agileflow',
+        'templates',
+        'damage-control-patterns.yaml'
+      );
       if (fs.existsSync(templatePath)) {
         fs.copyFileSync(templatePath, patternsDest);
         success('Deployed damage control patterns');
@@ -893,6 +979,22 @@ function disableFeature(feature) {
     return true; // Skip settings.json write for this feature
   }
 
+  // Disable askuserquestion
+  if (feature === 'askuserquestion') {
+    updateMetadata({
+      features: {
+        askUserQuestion: {
+          enabled: false,
+          version: VERSION,
+          at: new Date().toISOString(),
+        },
+      },
+    });
+    success('AskUserQuestion disabled');
+    info('Commands will end with natural text questions instead of AskUserQuestion tool');
+    return true; // Skip settings.json write for this feature
+  }
+
   // Disable damage control (PreToolUse hooks)
   if (feature === 'damagecontrol') {
     if (settings.hooks?.PreToolUse && Array.isArray(settings.hooks.PreToolUse)) {
@@ -1396,10 +1498,11 @@ ${c.cyan}Feature Control:${c.reset}
   --enable=<list>     Enable features (comma-separated)
   --disable=<list>    Disable features (comma-separated)
 
-  Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, damagecontrol
+  Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, damagecontrol, askuserquestion
 
   Stop hooks (ralphloop, selfimprove) run when Claude completes/pauses
   Damage control (damagecontrol) uses PreToolUse hooks to block dangerous commands
+  AskUserQuestion (askuserquestion) makes all commands end with guided options
 
 ${c.cyan}Statusline Components:${c.reset}
   --show=<list>       Show statusline components (comma-separated)
@@ -1465,6 +1568,12 @@ ${c.cyan}Examples:${c.reset}
 
   # Enable damage control (PreToolUse hooks to block dangerous commands)
   node .agileflow/scripts/agileflow-configure.js --enable=damagecontrol
+
+  # Enable AskUserQuestion (all commands end with guided options)
+  node .agileflow/scripts/agileflow-configure.js --enable=askuserquestion
+
+  # Disable AskUserQuestion (commands end with natural text questions)
+  node .agileflow/scripts/agileflow-configure.js --disable=askuserquestion
 `);
 }
 

package/scripts/agileflow-welcome.js

@@ -15,6 +15,10 @@ const fs = require('fs');
 const path = require('path');
 const { execSync, spawnSync } = require('child_process');
 
+// Shared utilities
+const { c, box } = require('../lib/colors');
+const { getProjectRoot } = require('../lib/paths');
+
 // Session manager path (relative to script location)
 const SESSION_MANAGER_PATH = path.join(__dirname, 'session-manager.js');
 
@@ -26,68 +30,6 @@ try {
   // Update checker not available
 }
 
-// ANSI color codes
-const c = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-
-  // Standard ANSI colors
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  magenta: '\x1b[35m',
-  cyan: '\x1b[36m',
-
-  brightBlack: '\x1b[90m',
-  brightGreen: '\x1b[92m',
-  brightYellow: '\x1b[93m',
-  brightCyan: '\x1b[96m',
-
-  // Vibrant 256-color palette (modern, sleek look)
-  mintGreen: '\x1b[38;5;158m',    // Healthy/success states
-  peach: '\x1b[38;5;215m',        // Warning states
-  coral: '\x1b[38;5;203m',        // Critical/error states
-  lightGreen: '\x1b[38;5;194m',   // Session healthy
-  lightYellow: '\x1b[38;5;228m',  // Session warning
-  lightPink: '\x1b[38;5;210m',    // Session critical
-  skyBlue: '\x1b[38;5;117m',      // Directories/paths
-  lavender: '\x1b[38;5;147m',     // Model info, story IDs
-  softGold: '\x1b[38;5;222m',     // Cost/money
-  teal: '\x1b[38;5;80m',          // Ready/pending states
-  slate: '\x1b[38;5;103m',        // Secondary info
-  rose: '\x1b[38;5;211m',         // Blocked/critical accent
-  amber: '\x1b[38;5;214m',        // WIP/in-progress accent
-  powder: '\x1b[38;5;153m',       // Labels/headers
-
-  // Brand color (#e8683a)
-  brand: '\x1b[38;2;232;104;58m',
-};
-
-// Box drawing characters
-const box = {
-  tl: '╭',
-  tr: '╮',
-  bl: '╰',
-  br: '╯',
-  h: '─',
-  v: '│',
-  lT: '├',
-  rT: '┤',
-  tT: '┬',
-  bT: '┴',
-  cross: '┼',
-};
-
-function getProjectRoot() {
-  let dir = process.cwd();
-  while (!fs.existsSync(path.join(dir, '.agileflow')) && dir !== '/') {
-    dir = path.dirname(dir);
-  }
-  return dir !== '/' ? dir : process.cwd();
-}
-
 function getProjectInfo(rootDir) {
   const info = {
     name: 'agileflow',
@@ -229,6 +171,7 @@ function clearActiveCommands(rootDir) {
     const state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
     result.ran = true;
 
+    // Handle new array format (active_commands)
     if (state.active_commands && state.active_commands.length > 0) {
       result.cleared = state.active_commands.length;
       // Capture command names before clearing
@@ -237,11 +180,14 @@ function clearActiveCommands(rootDir) {
       }
       state.active_commands = [];
     }
+
+    // Handle legacy singular format (active_command) - only capture if not already in array
     if (state.active_command !== undefined) {
-      result.cleared++;
-      // Capture single command name
-      if (state.active_command.name) {
-        result.commandNames.push(state.active_command.name);
+      const legacyName = state.active_command.name;
+      // Only add to count/names if not already captured from array (avoid duplicates)
+      if (legacyName && !result.commandNames.includes(legacyName)) {
+        result.cleared++;
+        result.commandNames.push(legacyName);
       }
       delete state.active_command;
     }
@@ -347,7 +293,7 @@ function checkPreCompact(rootDir) {
 }
 
 function checkDamageControl(rootDir) {
-  const result = { configured: false, level: null, patternCount: 0, scriptsOk: true };
+  const result = { configured: false, level: 'standard', patternCount: 0, scriptsOk: true };
 
   try {
     // Check if PreToolUse hooks are configured in settings
@@ -356,8 +302,8 @@ function checkDamageControl(rootDir) {
       const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
       if (settings.hooks?.PreToolUse && Array.isArray(settings.hooks.PreToolUse)) {
         // Check for damage-control hooks
-        const hasDamageControlHooks = settings.hooks.PreToolUse.some(
-          h => h.hooks?.some(hk => hk.command?.includes('damage-control'))
+        const hasDamageControlHooks = settings.hooks.PreToolUse.some(h =>
+          h.hooks?.some(hk => hk.command?.includes('damage-control'))
         );
         if (hasDamageControlHooks) {
           result.configured = true;
@@ -368,15 +314,23 @@ function checkDamageControl(rootDir) {
           );
           result.hooksCount = dcHooks.length;
 
-          // Check if all required scripts exist
-          const scriptsDir = path.join(rootDir, '.agileflow', 'scripts');
+          // Check for enhanced mode (has prompt hook)
+          const hasPromptHook = settings.hooks.PreToolUse.some(h =>
+            h.hooks?.some(hk => hk.type === 'prompt')
+          );
+          if (hasPromptHook) {
+            result.level = 'enhanced';
+          }
+
+          // Check if all required scripts exist (in .claude/hooks/damage-control/)
+          const hooksDir = path.join(rootDir, '.claude', 'hooks', 'damage-control');
           const requiredScripts = [
-            'damage-control-bash.js',
-            'damage-control-edit.js',
-            'damage-control-write.js',
+            'bash-tool-damage-control.js',
+            'edit-tool-damage-control.js',
+            'write-tool-damage-control.js',
           ];
           for (const script of requiredScripts) {
-            if (!fs.existsSync(path.join(scriptsDir, script))) {
+            if (!fs.existsSync(path.join(hooksDir, script))) {
               result.scriptsOk = false;
               break;
             }
@@ -385,23 +339,20 @@ function checkDamageControl(rootDir) {
       }
     }
 
-    // Get protection level and pattern count from metadata
-    const metadataPath = path.join(rootDir, 'docs/00-meta/agileflow-metadata.json');
-    if (fs.existsSync(metadataPath)) {
-      const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-      if (metadata.features?.damagecontrol) {
-        result.level = metadata.features.damagecontrol.protectionLevel || 'standard';
+    // Count patterns in patterns.yaml
+    const patternsLocations = [
+      path.join(rootDir, '.claude', 'hooks', 'damage-control', 'patterns.yaml'),
+      path.join(rootDir, '.agileflow', 'scripts', 'damage-control', 'patterns.yaml'),
+    ];
+    for (const patternsPath of patternsLocations) {
+      if (fs.existsSync(patternsPath)) {
+        const content = fs.readFileSync(patternsPath, 'utf8');
+        // Count pattern entries (lines starting with "  - pattern:")
+        const patternMatches = content.match(/^\s*-\s*pattern:/gm);
+        result.patternCount = patternMatches ? patternMatches.length : 0;
+        break;
       }
     }
-
-    // Count patterns in config file
-    const patternsPath = path.join(rootDir, '.agileflow', 'config', 'damage-control-patterns.yaml');
-    if (fs.existsSync(patternsPath)) {
-      const content = fs.readFileSync(patternsPath, 'utf8');
-      // Count pattern entries (lines starting with "  - pattern:")
-      const patternMatches = content.match(/^\s*-\s*pattern:/gm);
-      result.patternCount = patternMatches ? patternMatches.length : 0;
-    }
   } catch (e) {}
 
   return result;
@@ -733,14 +684,24 @@ function formatTable(
   // Show update available notification (using vibrant colors)
   if (updateInfo.available && updateInfo.latest && !updateInfo.justUpdated) {
     lines.push(fullDivider());
-    lines.push(fullRow(`${c.amber}↑${c.reset} Update available: ${c.softGold}v${updateInfo.latest}${c.reset}`, ''));
+    lines.push(
+      fullRow(
+        `${c.amber}↑${c.reset} Update available: ${c.softGold}v${updateInfo.latest}${c.reset}`,
+        ''
+      )
+    );
     lines.push(fullRow(`  Run: ${c.skyBlue}npx agileflow update${c.reset}`, ''));
   }
 
   // Show "just updated" changelog
   if (updateInfo.justUpdated && updateInfo.changelog && updateInfo.changelog.length > 0) {
     lines.push(fullDivider());
-    lines.push(fullRow(`${c.mintGreen}✨${c.reset} What's new in ${c.softGold}v${info.version}${c.reset}:`, ''));
+    lines.push(
+      fullRow(
+        `${c.mintGreen}✨${c.reset} What's new in ${c.softGold}v${info.version}${c.reset}:`,
+        ''
+      )
+    );
     for (const entry of updateInfo.changelog.slice(0, 2)) {
       lines.push(fullRow(`  ${c.teal}•${c.reset} ${truncate(entry, W - 6)}`, ''));
     }
@@ -799,7 +760,9 @@ function formatTable(
 
   // Session cleanup
   const sessionStatus = session.cleared > 0 ? `cleared ${session.cleared} command(s)` : `clean`;
-  lines.push(row('Session state', sessionStatus, c.lavender, session.cleared > 0 ? c.mintGreen : c.dim));
+  lines.push(
+    row('Session state', sessionStatus, c.lavender, session.cleared > 0 ? c.mintGreen : c.dim)
+  );
 
   // PreCompact status with version check
   if (precompact.configured && precompact.scriptExists) {
@@ -851,7 +814,8 @@ function formatTable(
       lines.push(row('Damage control', '⚠️ scripts missing', c.coral, c.coral));
     } else {
       const levelStr = damageControl.level || 'standard';
-      const patternStr = damageControl.patternCount > 0 ? `${damageControl.patternCount} patterns` : '';
+      const patternStr =
+        damageControl.patternCount > 0 ? `${damageControl.patternCount} patterns` : '';
       const dcStatus = `🛡️ ${levelStr}${patternStr ? ` (${patternStr})` : ''}`;
       lines.push(row('Damage control', dcStatus, c.lavender, c.mintGreen));
     }
@@ -876,7 +840,9 @@ function formatTable(
   }
 
   // Last commit (colorful like obtain-context)
-  lines.push(row('Last commit', `${c.peach}${info.commit}${c.reset} ${info.lastCommit}`, c.lavender, ''));
+  lines.push(
+    row('Last commit', `${c.peach}${info.commit}${c.reset} ${info.lastCommit}`, c.lavender, '')
+  );
 
   lines.push(bottomBorder);
 
@@ -917,15 +883,28 @@ async function main() {
   }
 
   console.log(
-    formatTable(info, archival, session, precompact, parallelSessions, updateInfo, expertise, damageControl)
+    formatTable(
+      info,
+      archival,
+      session,
+      precompact,
+      parallelSessions,
+      updateInfo,
+      expertise,
+      damageControl
+    )
   );
 
   // Show warning and tip if other sessions are active (vibrant colors)
   if (parallelSessions.otherActive > 0) {
     console.log('');
     console.log(`${c.amber}⚠️  Other Claude session(s) active in this repo.${c.reset}`);
-    console.log(`${c.slate}   Run ${c.skyBlue}/agileflow:session:status${c.reset}${c.slate} to see all sessions.${c.reset}`);
-    console.log(`${c.slate}   Run ${c.skyBlue}/agileflow:session:new${c.reset}${c.slate} to create isolated workspace.${c.reset}`);
+    console.log(
+      `${c.slate}   Run ${c.skyBlue}/agileflow:session:status${c.reset}${c.slate} to see all sessions.${c.reset}`
+    );
+    console.log(
+      `${c.slate}   Run ${c.skyBlue}/agileflow:session:new${c.reset}${c.slate} to create isolated workspace.${c.reset}`
+    );
   }
 }
 

package/scripts/auto-self-improve.js

@@ -21,18 +21,10 @@ const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
-// ANSI colors
-const c = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  brand: '\x1b[38;2;232;104;58m',
-};
+// Shared utilities
+const { c } = require('../lib/colors');
+const { getProjectRoot } = require('../lib/paths');
+const { safeReadJSON, safeReadFile, safeWriteFile } = require('../lib/errors');
 
 // Agents that have expertise files
 const AGENTS_WITH_EXPERTISE = [
@@ -76,24 +68,11 @@ const DOMAIN_PATTERNS = {
   devops: [/deploy/, /kubernetes/, /k8s/, /terraform/, /ansible/],
 };
 
-// Find project root
-function getProjectRoot() {
-  let dir = process.cwd();
-  while (!fs.existsSync(path.join(dir, '.agileflow')) && dir !== '/') {
-    dir = path.dirname(dir);
-  }
-  return dir !== '/' ? dir : process.cwd();
-}
-
 // Read session state
 function getSessionState(rootDir) {
   const statePath = path.join(rootDir, 'docs/09-agents/session-state.json');
-  try {
-    if (fs.existsSync(statePath)) {
-      return JSON.parse(fs.readFileSync(statePath, 'utf8'));
-    }
-  } catch (e) {}
-  return {};
+  const result = safeReadJSON(statePath, { defaultValue: {} });
+  return result.ok ? result.data : {};
 }
 
 // Get git diff summary
@@ -232,26 +211,25 @@ function getExpertisePath(rootDir, agent) {
 
 // Append learning to expertise file
 function appendLearning(expertisePath, learning) {
-  try {
-    let content = fs.readFileSync(expertisePath, 'utf8');
-
-    // Find the learnings section
-    const learningsMatch = content.match(/^learnings:\s*$/m);
-
-    if (!learningsMatch) {
-      // No learnings section, add it at the end
-      content += `\n\nlearnings:\n${learning}`;
-    } else {
-      // Find where to insert (after "learnings:" line)
-      const insertPos = learningsMatch.index + learningsMatch[0].length;
-      content = content.slice(0, insertPos) + '\n' + learning + content.slice(insertPos);
-    }
+  const readResult = safeReadFile(expertisePath);
+  if (!readResult.ok) return false;
 
-    fs.writeFileSync(expertisePath, content);
-    return true;
-  } catch (e) {
-    return false;
+  let content = readResult.data;
+
+  // Find the learnings section
+  const learningsMatch = content.match(/^learnings:\s*$/m);
+
+  if (!learningsMatch) {
+    // No learnings section, add it at the end
+    content += `\n\nlearnings:\n${learning}`;
+  } else {
+    // Find where to insert (after "learnings:" line)
+    const insertPos = learningsMatch.index + learningsMatch[0].length;
+    content = content.slice(0, insertPos) + '\n' + learning + content.slice(insertPos);
   }
+
+  const writeResult = safeWriteFile(expertisePath, content);
+  return writeResult.ok;
 }
 
 // Format learning as YAML