agileflow 2.94.1 → 2.95.0

package/scripts/lib/colors.sh

@@ -3,6 +3,10 @@
 #
 # Source this file: source "$(dirname "${BASH_SOURCE[0]}")/lib/colors.sh"
 #
+# Color definitions are sourced from colors.generated.sh which is
+# auto-generated from config/colors.yaml (single source of truth).
+# Run: node scripts/generate-colors.js
+#
 # WCAG AA Contrast Ratios (verified against #1a1a1a dark terminal background):
 # - Green (#32CD32):     4.5:1 ✓ (meets AA for normal text)
 # - Red (#FF6B6B):       5.0:1 ✓ (meets AA for normal text)
@@ -18,66 +22,15 @@
 #   echo -e "${BRAND}AgileFlow${RESET}"
 
 # ============================================================================
-# Reset and Modifiers
-# ============================================================================
-RESET="\033[0m"
-BOLD="\033[1m"
-DIM="\033[2m"
-ITALIC="\033[3m"
-UNDERLINE="\033[4m"
-
-# ============================================================================
-# Standard ANSI Colors (8 colors)
-# ============================================================================
-RED="\033[31m"
-GREEN="\033[32m"
-YELLOW="\033[33m"
-BLUE="\033[34m"
-MAGENTA="\033[35m"
-CYAN="\033[36m"
-WHITE="\033[37m"
-BLACK="\033[30m"
-
-# ============================================================================
-# Bright Variants
-# ============================================================================
-BRIGHT_RED="\033[91m"
-BRIGHT_GREEN="\033[92m"
-BRIGHT_YELLOW="\033[93m"
-BRIGHT_BLUE="\033[94m"
-BRIGHT_MAGENTA="\033[95m"
-BRIGHT_CYAN="\033[96m"
-BRIGHT_WHITE="\033[97m"
-BRIGHT_BLACK="\033[90m"
-
-# ============================================================================
-# Semantic Aliases (for consistent meaning across codebase)
+# Source generated colors from YAML
 # ============================================================================
-SUCCESS="$GREEN"
-ERROR="$RED"
-WARNING="$YELLOW"
-INFO="$CYAN"
-
-# ============================================================================
-# 256-Color Palette (vibrant, modern look)
-# ============================================================================
-MINT_GREEN="\033[38;5;158m"      # Healthy/success states
-PEACH="\033[38;5;215m"           # Warning states
-CORAL="\033[38;5;203m"           # Critical/error states
-LIGHT_GREEN="\033[38;5;194m"     # Session healthy
-LIGHT_YELLOW="\033[38;5;228m"    # Session warning
-LIGHT_PINK="\033[38;5;210m"      # Session critical
-SKY_BLUE="\033[38;5;117m"        # Directories/paths, ready states
-LAVENDER="\033[38;5;147m"        # Model info, story IDs
-SOFT_GOLD="\033[38;5;222m"       # Cost/money
-TEAL="\033[38;5;80m"             # Pending states
-SLATE="\033[38;5;103m"           # Secondary info
-ROSE="\033[38;5;211m"            # Blocked/critical accent
-AMBER="\033[38;5;214m"           # WIP/in-progress accent
-POWDER="\033[38;5;153m"          # Labels/headers
+_COLORS_DIR="$(dirname "${BASH_SOURCE[0]}")"
+# shellcheck source=colors.generated.sh
+source "${_COLORS_DIR}/colors.generated.sh"
 
 # ============================================================================
 # Context/Usage Colors (for status indicators)
+# These are additional aliases not in the generated file
 # ============================================================================
 CTX_GREEN="$MINT_GREEN"          # Healthy context
 CTX_YELLOW="$PEACH"              # Moderate usage
@@ -86,21 +39,8 @@ CTX_RED="$CORAL"                 # Critical
 
 # ============================================================================
 # Session Time Colors
+# These are additional aliases not in the generated file
 # ============================================================================
 SESSION_GREEN="$LIGHT_GREEN"     # Plenty of time
 SESSION_YELLOW="$LIGHT_YELLOW"   # Getting low
 SESSION_RED="$LIGHT_PINK"        # Critical
-
-# ============================================================================
-# Brand Color (#e8683a - burnt orange/terracotta)
-# ============================================================================
-BRAND="\033[38;2;232;104;58m"
-ORANGE="$BRAND"                  # Alias for brand color
-
-# ============================================================================
-# Background Colors
-# ============================================================================
-BG_RED="\033[41m"
-BG_GREEN="\033[42m"
-BG_YELLOW="\033[43m"
-BG_BLUE="\033[44m"

package/scripts/lib/configure-features.js

@@ -6,6 +6,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const {
   c,
   log,
@@ -39,6 +40,14 @@ const FEATURES = {
   },
   askuserquestion: { metadataOnly: true },
   tmuxautospawn: { metadataOnly: true },
+  shellaliases: {
+    metadataOnly: false,
+    description: 'Shell aliases (af/agileflow) for tmux-wrapped Claude',
+  },
+  claudemdreinforcement: {
+    metadataOnly: false,
+    description: 'Add /babysit rules to CLAUDE.md for context preservation',
+  },
 };
 
 const PROFILES = {
@@ -88,6 +97,26 @@ const PROFILES = {
       'tmuxautospawn',
     ],
   },
+  experimental: {
+    description:
+      '⚠️ CONTEXT HEAVY: Full command file injection during compact (uses more tokens but may be more reliable)',
+    enable: [
+      'sessionstart',
+      'precompact',
+      'archival',
+      'statusline',
+      'ralphloop',
+      'selfimprove',
+      'askuserquestion',
+      'tmuxautospawn',
+    ],
+    archivalDays: 30,
+    experimental: {
+      fullFileInjection: true,
+      description:
+        'Instead of compact summaries, injects entire command files during context compaction',
+    },
+  },
 };
 
 const STATUSLINE_COMPONENTS = [
@@ -243,6 +272,68 @@ function enableFeature(feature, options = {}, version) {
     return true;
   }
 
+  // Handle shell aliases
+  if (feature === 'shellaliases') {
+    const result = enableShellAliases();
+    if (
+      result.configured.length > 0 ||
+      result.skipped.some(s => s.includes('already configured'))
+    ) {
+      updateMetadata(
+        {
+          features: {
+            shellAliases: {
+              enabled: true,
+              version,
+              at: new Date().toISOString(),
+              shells: result.configured,
+            },
+          },
+        },
+        version
+      );
+      if (result.configured.length > 0) {
+        success(`Shell aliases added to: ${result.configured.join(', ')}`);
+        info('Reload shell: source ~/.bashrc or source ~/.zshrc');
+        info('Then use "af" or "agileflow" to start Claude in tmux');
+      } else {
+        info('Shell aliases already configured');
+      }
+      return true;
+    }
+    if (result.skipped.length > 0) {
+      warn(`Shell aliases skipped: ${result.skipped.join(', ')}`);
+    }
+    return false;
+  }
+
+  // Handle CLAUDE.md reinforcement
+  if (feature === 'claudemdreinforcement') {
+    const result = enableClaudeMdReinforcement();
+    if (result.success) {
+      updateMetadata(
+        {
+          features: {
+            claudeMdReinforcement: {
+              enabled: true,
+              version,
+              at: new Date().toISOString(),
+            },
+          },
+        },
+        version
+      );
+      if (result.added) {
+        success('Added /babysit rules to CLAUDE.md');
+      } else {
+        info('CLAUDE.md already has /babysit rules');
+      }
+      return true;
+    }
+    error(`Failed to update CLAUDE.md: ${result.error}`);
+    return false;
+  }
+
   // Handle damage control
   if (feature === 'damagecontrol') {
     return enableDamageControl(settings, options, version);
@@ -547,6 +638,53 @@ function disableFeature(feature, version) {
     return true;
   }
 
+  // Disable shell aliases
+  if (feature === 'shellaliases') {
+    const result = disableShellAliases();
+    updateMetadata(
+      {
+        features: {
+          shellAliases: {
+            enabled: false,
+            version,
+            at: new Date().toISOString(),
+          },
+        },
+      },
+      version
+    );
+    if (result.removed.length > 0) {
+      success(`Shell aliases removed from: ${result.removed.join(', ')}`);
+      info('Reload shell: source ~/.bashrc or source ~/.zshrc');
+    } else {
+      info('No shell aliases found to remove');
+    }
+    return true;
+  }
+
+  // Disable CLAUDE.md reinforcement
+  if (feature === 'claudemdreinforcement') {
+    const result = disableClaudeMdReinforcement();
+    updateMetadata(
+      {
+        features: {
+          claudeMdReinforcement: {
+            enabled: false,
+            version,
+            at: new Date().toISOString(),
+          },
+        },
+      },
+      version
+    );
+    if (result.removed) {
+      success('Removed /babysit rules from CLAUDE.md');
+    } else {
+      info('CLAUDE.md did not have /babysit rules');
+    }
+    return true;
+  }
+
   // Disable damage control
   if (feature === 'damagecontrol') {
     if (settings.hooks?.PreToolUse && Array.isArray(settings.hooks.PreToolUse)) {
@@ -625,6 +763,43 @@ function applyProfile(profileName, options = {}, version) {
     profile.disable.forEach(f => disableFeature(f, version));
   }
 
+  // Handle experimental profile settings
+  if (profile.experimental) {
+    updateMetadata(
+      {
+        features: {
+          experimental: {
+            enabled: true,
+            fullFileInjection: profile.experimental.fullFileInjection || false,
+            version,
+            at: new Date().toISOString(),
+          },
+        },
+      },
+      version
+    );
+    if (profile.experimental.fullFileInjection) {
+      warn('⚠️  EXPERIMENTAL: Full file injection enabled');
+      info('   PreCompact will inject entire command files instead of compact summaries');
+      info('   This uses more context tokens but may provide better instruction adherence');
+    }
+  } else {
+    // Disable experimental mode if switching to non-experimental profile
+    updateMetadata(
+      {
+        features: {
+          experimental: {
+            enabled: false,
+            fullFileInjection: false,
+            version,
+            at: new Date().toISOString(),
+          },
+        },
+      },
+      version
+    );
+  }
+
   return true;
 }
 
@@ -837,6 +1012,226 @@ function upgradeFeatures(status, version) {
   return upgraded > 0;
 }
 
+// ============================================================================
+// SHELL ALIASES
+// ============================================================================
+
+const SHELL_ALIAS_MARKER = '# AgileFlow tmux wrapper';
+const SHELL_ALIAS_BLOCK = `
+${SHELL_ALIAS_MARKER}
+# Use 'af' or 'agileflow' for tmux, 'claude' stays normal
+alias af="bash .agileflow/scripts/af"
+alias agileflow="bash .agileflow/scripts/af"
+`;
+
+/**
+ * Enable shell aliases by adding them to ~/.bashrc and ~/.zshrc
+ * @returns {object} Result with configured and skipped shells
+ */
+function enableShellAliases() {
+  const result = {
+    configured: [],
+    skipped: [],
+    error: null,
+  };
+
+  // Only set up aliases on Unix-like systems
+  if (process.platform === 'win32') {
+    result.skipped.push('Windows (not supported)');
+    return result;
+  }
+
+  const homeDir = os.homedir();
+  const rcFiles = [
+    { name: 'bash', path: path.join(homeDir, '.bashrc') },
+    { name: 'zsh', path: path.join(homeDir, '.zshrc') },
+  ];
+
+  for (const rc of rcFiles) {
+    try {
+      // Check if RC file exists
+      if (!fs.existsSync(rc.path)) {
+        result.skipped.push(`${rc.name} (no ${path.basename(rc.path)})`);
+        continue;
+      }
+
+      const content = fs.readFileSync(rc.path, 'utf8');
+
+      // Check if aliases already exist
+      if (content.includes(SHELL_ALIAS_MARKER)) {
+        result.skipped.push(`${rc.name} (already configured)`);
+        continue;
+      }
+
+      // Append aliases to RC file
+      fs.appendFileSync(rc.path, SHELL_ALIAS_BLOCK);
+      result.configured.push(rc.name);
+    } catch (err) {
+      result.skipped.push(`${rc.name} (error: ${err.message})`);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Disable shell aliases by removing them from ~/.bashrc and ~/.zshrc
+ * @returns {object} Result with removed shells
+ */
+function disableShellAliases() {
+  const result = {
+    removed: [],
+    skipped: [],
+  };
+
+  if (process.platform === 'win32') {
+    return result;
+  }
+
+  const homeDir = os.homedir();
+  const rcFiles = [
+    { name: 'bash', path: path.join(homeDir, '.bashrc') },
+    { name: 'zsh', path: path.join(homeDir, '.zshrc') },
+  ];
+
+  for (const rc of rcFiles) {
+    try {
+      if (!fs.existsSync(rc.path)) {
+        continue;
+      }
+
+      const content = fs.readFileSync(rc.path, 'utf8');
+
+      if (!content.includes(SHELL_ALIAS_MARKER)) {
+        continue;
+      }
+
+      // Remove the alias block
+      const lines = content.split('\n');
+      const filteredLines = [];
+      let inBlock = false;
+
+      for (const line of lines) {
+        if (line.includes(SHELL_ALIAS_MARKER)) {
+          inBlock = true;
+          continue;
+        }
+        if (
+          inBlock &&
+          (line.startsWith('# Use ') ||
+            line.startsWith('alias af=') ||
+            line.startsWith('alias agileflow='))
+        ) {
+          continue;
+        }
+        if (inBlock && line.trim() === '') {
+          inBlock = false;
+          continue;
+        }
+        inBlock = false;
+        filteredLines.push(line);
+      }
+
+      fs.writeFileSync(rc.path, filteredLines.join('\n'), 'utf8');
+      result.removed.push(rc.name);
+    } catch (err) {
+      result.skipped.push(`${rc.name} (error: ${err.message})`);
+    }
+  }
+
+  return result;
+}
+
+// ============================================================================
+// CLAUDE.MD REINFORCEMENT
+// ============================================================================
+
+const CLAUDE_MD_MARKER = '<!-- AGILEFLOW_BABYSIT_RULES -->';
+const CLAUDE_MD_CONTENT = `
+
+${CLAUDE_MD_MARKER}
+## AgileFlow /babysit Context Preservation Rules
+
+When \`/agileflow:babysit\` is active (check session-state.json), these rules are MANDATORY:
+
+1. **ALWAYS end responses with the AskUserQuestion tool** - Not text like "What next?" but the ACTUAL TOOL CALL
+2. **Use Plan Mode for non-trivial tasks** - Call \`EnterPlanMode\` before complex implementations
+3. **Delegate complex work to domain experts** - Use \`Task\` tool with appropriate \`subagent_type\`
+4. **Track progress with TodoWrite** - For any task with 3+ steps
+
+These rules persist across conversation compaction. Check \`docs/09-agents/session-state.json\` for active commands.
+${CLAUDE_MD_MARKER}
+`;
+
+/**
+ * Enable CLAUDE.md reinforcement by adding babysit rules
+ * @returns {object} Result with success, added, and error
+ */
+function enableClaudeMdReinforcement() {
+  const claudeMdPath = path.join(process.cwd(), 'CLAUDE.md');
+
+  try {
+    let existingContent = '';
+    if (fs.existsSync(claudeMdPath)) {
+      existingContent = fs.readFileSync(claudeMdPath, 'utf8');
+    }
+
+    // Only append if marker doesn't exist
+    if (existingContent.includes(CLAUDE_MD_MARKER)) {
+      return { success: true, added: false };
+    }
+
+    fs.appendFileSync(claudeMdPath, CLAUDE_MD_CONTENT);
+    return { success: true, added: true };
+  } catch (err) {
+    return { success: false, error: err.message };
+  }
+}
+
+/**
+ * Disable CLAUDE.md reinforcement by removing babysit rules
+ * @returns {object} Result with removed flag
+ */
+function disableClaudeMdReinforcement() {
+  const claudeMdPath = path.join(process.cwd(), 'CLAUDE.md');
+
+  if (!fs.existsSync(claudeMdPath)) {
+    return { removed: false };
+  }
+
+  try {
+    const content = fs.readFileSync(claudeMdPath, 'utf8');
+
+    if (!content.includes(CLAUDE_MD_MARKER)) {
+      return { removed: false };
+    }
+
+    // Remove the section between markers (inclusive)
+    const startIdx = content.indexOf(CLAUDE_MD_MARKER);
+    const endMarkerIdx = content.indexOf(CLAUDE_MD_MARKER, startIdx + CLAUDE_MD_MARKER.length);
+
+    if (startIdx === -1 || endMarkerIdx === -1) {
+      return { removed: false };
+    }
+
+    // Find the start of the line containing the first marker
+    let lineStart = content.lastIndexOf('\n', startIdx);
+    if (lineStart === -1) lineStart = 0;
+
+    // Find the end of the line containing the second marker
+    let lineEnd = content.indexOf('\n', endMarkerIdx + CLAUDE_MD_MARKER.length);
+    if (lineEnd === -1) lineEnd = content.length;
+
+    const newContent = content.slice(0, lineStart) + content.slice(lineEnd);
+
+    // Clean up any trailing newlines
+    fs.writeFileSync(claudeMdPath, newContent.trimEnd() + '\n', 'utf8');
+    return { removed: true };
+  } catch (err) {
+    return { removed: false, error: err.message };
+  }
+}
+
 module.exports = {
   // Constants
   FEATURES,
@@ -856,4 +1251,10 @@ module.exports = {
   // Helpers
   scriptExists,
   getScriptPath,
+  // Shell aliases
+  enableShellAliases,
+  disableShellAliases,
+  // CLAUDE.md reinforcement
+  enableClaudeMdReinforcement,
+  disableClaudeMdReinforcement,
 };