agileflow 3.0.1 → 3.1.0

package/scripts/lib/configure-features.js

@@ -55,7 +55,8 @@ const FEATURES = {
   },
   claudeflags: {
     metadataOnly: false,
-    description: 'Default flags for Claude CLI (sets permissions.defaultMode in .claude/settings.json)',
+    description:
+      'Default flags for Claude CLI (sets permissions.defaultMode in .claude/settings.json)',
   },
   agentteams: {
     metadataOnly: false,
@@ -459,12 +460,16 @@ function enableFeature(feature, options = {}, version) {
     : null;
   writeJSON('.claude/settings.json', settings);
   updateMetadata(
-    { features: { [feature]: {
-      enabled: true,
-      version,
-      ...(contentHash ? { contentHash } : {}),
-      at: new Date().toISOString(),
-    } } },
+    {
+      features: {
+        [feature]: {
+          enabled: true,
+          version,
+          ...(contentHash ? { contentHash } : {}),
+          at: new Date().toISOString(),
+        },
+      },
+    },
     version
   );
   updateGitignore();
@@ -1210,6 +1215,119 @@ function upgradeFeatures(status, version) {
   return upgraded > 0;
 }
 
+// ============================================================================
+// STARTUP MODE (atomic command)
+// ============================================================================
+
+/**
+ * Valid startup modes and their mappings
+ */
+const STARTUP_MODES = {
+  'skip-permissions': {
+    flags: '--dangerously-skip-permissions',
+    defaultMode: 'bypassPermissions',
+    description: 'Skip all permission prompts (trusted mode)',
+  },
+  'accept-edits': {
+    flags: '--permission-mode acceptEdits',
+    defaultMode: 'acceptEdits',
+    description: 'Auto-accept file edits, prompt for other actions',
+  },
+  normal: {
+    flags: null,
+    defaultMode: null,
+    description: 'Standard Claude with permission prompts',
+  },
+  'no-claude': {
+    flags: null,
+    defaultMode: null,
+    description: 'Create worktree only, start Claude manually',
+  },
+};
+
+/**
+ * Set startup mode atomically - updates BOTH metadata AND .claude/settings.json
+ * This replaces the fragile two-step process of updating metadata + running --enable=claudeflags
+ *
+ * @param {string} mode - One of: skip-permissions, accept-edits, normal, no-claude
+ * @param {string} version - Current version string
+ * @returns {boolean} Success
+ */
+function enableStartupMode(mode, version) {
+  const modeConfig = STARTUP_MODES[mode];
+  if (!modeConfig) {
+    error(`Unknown startup mode: ${mode}`);
+    log(`  Valid modes: ${Object.keys(STARTUP_MODES).join(', ')}`, c.dim);
+    return false;
+  }
+
+  ensureDir('.claude');
+  const settings = readJSON('.claude/settings.json') || {};
+  settings.permissions = settings.permissions || { allow: [], deny: [], ask: [] };
+
+  if (mode === 'normal' || mode === 'no-claude') {
+    // Remove defaultMode from settings
+    if (settings.permissions.defaultMode) {
+      delete settings.permissions.defaultMode;
+    }
+    writeJSON('.claude/settings.json', settings);
+
+    // Disable claudeflags + set defaultStartupMode in metadata (single write)
+    updateMetadata(
+      {
+        features: {
+          claudeFlags: {
+            enabled: false,
+            defaultFlags: '',
+            version,
+            at: new Date().toISOString(),
+          },
+        },
+      },
+      version
+    );
+  } else {
+    // Set defaultMode in settings.json
+    settings.permissions.defaultMode = modeConfig.defaultMode;
+    writeJSON('.claude/settings.json', settings);
+
+    // Enable claudeflags + set defaultStartupMode in metadata (single write)
+    updateMetadata(
+      {
+        features: {
+          claudeFlags: {
+            enabled: true,
+            defaultFlags: modeConfig.flags,
+            version,
+            at: new Date().toISOString(),
+          },
+        },
+      },
+      version
+    );
+  }
+
+  // Set defaultStartupMode in metadata (updateMetadata already created file if missing)
+  const metaPath = 'docs/00-meta/agileflow-metadata.json';
+  const meta = readJSON(metaPath) || {};
+  meta.defaultStartupMode = mode;
+  meta.updated = new Date().toISOString();
+  writeJSON(metaPath, meta);
+
+  success(`Default startup mode set to: ${mode}`);
+  if (modeConfig.defaultMode) {
+    info(`Set permissions.defaultMode = "${modeConfig.defaultMode}" in .claude/settings.json`);
+  } else {
+    info('Removed permissions.defaultMode from .claude/settings.json');
+  }
+  info(`Metadata: defaultStartupMode = "${mode}"`);
+  if (mode !== 'normal') {
+    info('Restart Claude Code for the new mode to take effect');
+  }
+
+  return true;
+}
+
 // ============================================================================
 // SHELL ALIASES
 // ============================================================================
@@ -1468,6 +1586,9 @@ module.exports = {
   // Helpers
   scriptExists,
   getScriptPath,
+  // Startup mode
+  enableStartupMode,
+  STARTUP_MODES,
   // Shell aliases
   enableShellAliases,
   disableShellAliases,

package/scripts/lib/configure-repair.js

@@ -116,11 +116,12 @@ function listScripts() {
     // Check if modified
     let isModified = false;
     if (exists && fileIndex?.files?.[`scripts/${script}`]) {
-      isModified = tryOptional(() => {
-        const currentHash = sha256(fs.readFileSync(scriptPath));
-        const indexHash = fileIndex.files[`scripts/${script}`].sha256;
-        return currentHash !== indexHash;
-      }, 'hash check') ?? false;
+      isModified =
+        tryOptional(() => {
+          const currentHash = sha256(fs.readFileSync(scriptPath));
+          const indexHash = fileIndex.files[`scripts/${script}`].sha256;
+          return currentHash !== indexHash;
+        }, 'hash check') ?? false;
     }
 
     // Print status

package/scripts/lib/context-formatter.js

@@ -323,7 +323,11 @@ function generateSummary(prefetched = null, options = {}) {
 
   // Scale indicator (EP-0033)
   let scaleDetectorSummary;
-  try { scaleDetectorSummary = require('./scale-detector'); } catch { /* not available */ }
+  try {
+    scaleDetectorSummary = require('./scale-detector');
+  } catch {
+    /* not available */
+  }
   if (scaleDetectorSummary) {
     try {
       const scaleResult = scaleDetectorSummary.detectScale({
@@ -503,7 +507,11 @@ function generateFullContent(prefetched = null, options = {}) {
 
   // SCALE DETECTION (EP-0033)
   let scaleDetector;
-  try { scaleDetector = require('./scale-detector'); } catch { /* not available */ }
+  try {
+    scaleDetector = require('./scale-detector');
+  } catch {
+    /* not available */
+  }
   if (scaleDetector) {
     try {
       const scaleResult = scaleDetector.detectScale({
@@ -886,7 +894,9 @@ function generateRemainingContent(prefetched, options = {}) {
 
     // Show auto-enabled modes
     const modes = auto_enabled || {};
-    const enabledModes = Object.entries(modes).filter(([, v]) => v).map(([k]) => k.replace('_', ' '));
+    const enabledModes = Object.entries(modes)
+      .filter(([, v]) => v)
+      .map(([k]) => k.replace('_', ' '));
     if (enabledModes.length > 0) {
       content += `\n${C.mintGreen}Auto-enabled:${C.reset} ${enabledModes.join(', ')}\n`;
     }

package/scripts/lib/damage-control-utils.js

@@ -96,7 +96,11 @@ function loadPatterns(projectRoot, parseYAML, defaultConfig = {}) {
         const stat = fs.statSync(fullPath);
         const mtime = stat.mtimeMs;
 
-        if (_patternCache.filePath === fullPath && _patternCache.mtime === mtime && _patternCache.config) {
+        if (
+          _patternCache.filePath === fullPath &&
+          _patternCache.mtime === mtime &&
+          _patternCache.config
+        ) {
           return _patternCache.config;
         }
 

package/scripts/lib/lifecycle-detector.js

@@ -92,7 +92,9 @@ function detectLifecyclePhase(signals = {}) {
   return {
     phase: 'pre-story',
     confidence: story.id ? 0.6 : 0.9,
-    reason: story.id ? `Story ${story.id} not yet started (status: ${story.status || 'unknown'})` : 'No active story',
+    reason: story.id
+      ? `Story ${story.id} not yet started (status: ${story.status || 'unknown'})`
+      : 'No active story',
   };
 }
 
@@ -107,8 +109,8 @@ function getRelevantPhases(phase) {
   // Each phase also includes adjacent phase features (for smooth transitions)
   const phaseMap = {
     'pre-story': ['pre-story'],
-    'planning': ['pre-story', 'planning'],
-    'implementation': ['planning', 'implementation'],
+    planning: ['pre-story', 'planning'],
+    implementation: ['planning', 'implementation'],
     'post-impl': ['implementation', 'post-impl'],
     'pre-pr': ['post-impl', 'pre-pr'],
   };

package/scripts/lib/process-cleanup.js

@@ -104,7 +104,8 @@ function getProcessStartTime(pid) {
 
   if (process.platform === 'darwin') {
     const result = executeCommandSync('ps', ['-o', 'lstart=', '-p', String(pid)], {
-      timeout: 2000, fallback: null,
+      timeout: 2000,
+      fallback: null,
     });
     if (result.data === null) return null;
     const ts = new Date(result.data).getTime();
@@ -142,7 +143,8 @@ function getParentPid(pid) {
 
   if (process.platform === 'darwin') {
     const result = executeCommandSync('ps', ['-o', 'ppid=', '-p', String(pid)], {
-      timeout: 2000, fallback: null,
+      timeout: 2000,
+      fallback: null,
     });
     if (result.data === null) return null;
     const ppid = parseInt(result.data, 10);
@@ -172,7 +174,8 @@ function getArgsForPid(pid) {
 
   if (process.platform === 'darwin') {
     const result = executeCommandSync('ps', ['-o', 'command=', '-p', String(pid)], {
-      timeout: 2000, fallback: null,
+      timeout: 2000,
+      fallback: null,
     });
     if (result.data === null) return [];
     return result.data ? [result.data] : [];
@@ -292,7 +295,8 @@ function findClaudeProcesses() {
       // Get cwd via lsof (slower but works on macOS)
       let cwd = null;
       const lsofResult = executeCommandSync('lsof', ['-p', String(pid)], {
-        timeout: 1000, fallback: null,
+        timeout: 1000,
+        fallback: null,
       });
       if (lsofResult.data) {
         const cwdLine = lsofResult.data.split('\n').find(l => l.includes('cwd'));

package/scripts/lib/scale-detector.js

@@ -38,17 +38,54 @@ const SCALE_THRESHOLDS = {
 
 // Directories to exclude from file counting
 const EXCLUDE_DIRS = new Set([
-  'node_modules', '.git', 'dist', 'build', '.next', '.nuxt',
-  'coverage', '.agileflow', '.claude', '__pycache__', '.venv',
-  'vendor', 'target', 'out', '.cache', '.turbo', '.vercel',
+  'node_modules',
+  '.git',
+  'dist',
+  'build',
+  '.next',
+  '.nuxt',
+  'coverage',
+  '.agileflow',
+  '.claude',
+  '__pycache__',
+  '.venv',
+  'vendor',
+  'target',
+  'out',
+  '.cache',
+  '.turbo',
+  '.vercel',
 ]);
 
 // Source file extensions to count
 const SOURCE_EXTENSIONS = new Set([
-  '.js', '.jsx', '.ts', '.tsx', '.py', '.rb', '.go', '.rs',
-  '.java', '.kt', '.swift', '.c', '.cpp', '.h', '.cs',
-  '.vue', '.svelte', '.astro', '.php', '.sh', '.bash',
-  '.css', '.scss', '.less', '.html', '.sql', '.graphql',
+  '.js',
+  '.jsx',
+  '.ts',
+  '.tsx',
+  '.py',
+  '.rb',
+  '.go',
+  '.rs',
+  '.java',
+  '.kt',
+  '.swift',
+  '.c',
+  '.cpp',
+  '.h',
+  '.cs',
+  '.vue',
+  '.svelte',
+  '.astro',
+  '.php',
+  '.sh',
+  '.bash',
+  '.css',
+  '.scss',
+  '.less',
+  '.html',
+  '.sql',
+  '.graphql',
 ]);
 
 /**
@@ -123,7 +160,9 @@ function countStories(statusJson, rootDir) {
  */
 function countGitCommits(rootDir) {
   const result = git(['rev-list', '--count', '--since=6 months ago', 'HEAD'], {
-    cwd: rootDir, timeout: 5000, fallback: '0',
+    cwd: rootDir,
+    timeout: 5000,
+    fallback: '0',
   });
   const count = parseInt(result.data, 10);
   return isNaN(count) ? 0 : count;