agileflow 2.75.0 → 2.77.0

package/scripts/auto-self-improve.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+
+/**
+ * auto-self-improve.js - Automatic Agent Expertise Updates
+ *
+ * This script runs as a Stop hook and automatically updates agent
+ * expertise files based on work performed during the session.
+ *
+ * How it works:
+ * 1. Reads session-state.json to find which agent was active
+ * 2. Analyzes git diff to see what changed
+ * 3. Detects patterns, new files, significant changes
+ * 4. Generates a learning entry
+ * 5. Appends to the agent's expertise.yaml
+ *
+ * Usage (as Stop hook):
+ *   node scripts/auto-self-improve.js
+ */
+
+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',
+};
+
+// Agents that have expertise files
+const AGENTS_WITH_EXPERTISE = [
+  'accessibility',
+  'adr-writer',
+  'analytics',
+  'api',
+  'ci',
+  'compliance',
+  'database',
+  'datamigration',
+  'design',
+  'devops',
+  'documentation',
+  'epic-planner',
+  'integrations',
+  'mentor',
+  'mobile',
+  'monitoring',
+  'performance',
+  'product',
+  'qa',
+  'readme-updater',
+  'refactor',
+  'research',
+  'security',
+  'testing',
+  'ui',
+];
+
+// File patterns that suggest domain expertise
+const DOMAIN_PATTERNS = {
+  database: [/schema/, /migration/, /\.sql$/, /prisma/, /drizzle/, /sequelize/],
+  api: [/\/api\//, /controller/, /route/, /endpoint/, /graphql/],
+  ui: [/component/, /\.tsx$/, /\.jsx$/, /styles/, /\.css$/, /\.scss$/],
+  testing: [/\.test\./, /\.spec\./, /__tests__/, /jest/, /vitest/],
+  security: [/auth/, /password/, /token/, /jwt/, /oauth/, /permission/],
+  ci: [/\.github\/workflows/, /\.gitlab-ci/, /dockerfile/i, /docker-compose/],
+  documentation: [/\.md$/, /readme/i, /docs\//, /jsdoc/],
+  performance: [/cache/, /optimize/, /performance/, /benchmark/],
+  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 {};
+}
+
+// Get git diff summary
+function getGitDiff(rootDir) {
+  try {
+    // Get list of changed files (staged and unstaged)
+    const diffFiles = execSync('git diff --name-only HEAD 2>/dev/null || git diff --name-only', {
+      cwd: rootDir,
+      encoding: 'utf8',
+    })
+      .trim()
+      .split('\n')
+      .filter(Boolean);
+
+    // Get staged files
+    const stagedFiles = execSync('git diff --cached --name-only 2>/dev/null', {
+      cwd: rootDir,
+      encoding: 'utf8',
+    })
+      .trim()
+      .split('\n')
+      .filter(Boolean);
+
+    // Get untracked files
+    const untrackedFiles = execSync('git ls-files --others --exclude-standard 2>/dev/null', {
+      cwd: rootDir,
+      encoding: 'utf8',
+    })
+      .trim()
+      .split('\n')
+      .filter(Boolean);
+
+    // Combine all
+    const allFiles = [...new Set([...diffFiles, ...stagedFiles, ...untrackedFiles])];
+
+    // Get diff stats
+    let additions = 0;
+    let deletions = 0;
+    try {
+      const stats = execSync('git diff --shortstat HEAD 2>/dev/null || echo ""', {
+        cwd: rootDir,
+        encoding: 'utf8',
+      });
+      const addMatch = stats.match(/(\d+) insertion/);
+      const delMatch = stats.match(/(\d+) deletion/);
+      if (addMatch) additions = parseInt(addMatch[1]);
+      if (delMatch) deletions = parseInt(delMatch[1]);
+    } catch (e) {}
+
+    return {
+      files: allFiles,
+      additions,
+      deletions,
+      hasChanges: allFiles.length > 0,
+    };
+  } catch (e) {
+    return { files: [], additions: 0, deletions: 0, hasChanges: false };
+  }
+}
+
+// Detect which domain the changes relate to
+function detectDomain(files) {
+  const domainScores = {};
+
+  for (const file of files) {
+    for (const [domain, patterns] of Object.entries(DOMAIN_PATTERNS)) {
+      for (const pattern of patterns) {
+        if (pattern.test(file.toLowerCase())) {
+          domainScores[domain] = (domainScores[domain] || 0) + 1;
+        }
+      }
+    }
+  }
+
+  // Return domain with highest score
+  const sorted = Object.entries(domainScores).sort((a, b) => b[1] - a[1]);
+  return sorted.length > 0 ? sorted[0][0] : null;
+}
+
+// Generate learning summary from changes
+function generateLearningSummary(diff, activeAgent) {
+  const { files, additions, deletions } = diff;
+
+  if (files.length === 0) return null;
+
+  // Categorize files
+  const newFiles = files.filter(f => !f.includes('/'));
+  const testFiles = files.filter(f => /\.(test|spec)\.[jt]sx?$/.test(f));
+  const configFiles = files.filter(f => /\.(json|yaml|yml|toml|config\.)/.test(f));
+  const codeFiles = files.filter(f => /\.[jt]sx?$/.test(f) && !testFiles.includes(f));
+
+  // Build summary
+  const parts = [];
+
+  if (codeFiles.length > 0) {
+    const dirs = [...new Set(codeFiles.map(f => path.dirname(f)))];
+    parts.push(`Modified ${codeFiles.length} code file(s) in: ${dirs.slice(0, 3).join(', ')}`);
+  }
+
+  if (testFiles.length > 0) {
+    parts.push(`Updated ${testFiles.length} test file(s)`);
+  }
+
+  if (configFiles.length > 0) {
+    parts.push(`Changed config: ${configFiles.slice(0, 2).join(', ')}`);
+  }
+
+  if (additions > 50 || deletions > 50) {
+    parts.push(`Significant changes: +${additions}/-${deletions} lines`);
+  }
+
+  return parts.length > 0 ? parts.join('. ') : null;
+}
+
+// Find expertise file for agent
+function getExpertisePath(rootDir, agent) {
+  // Try installed location first
+  const installedPath = path.join(rootDir, '.agileflow', 'experts', agent, 'expertise.yaml');
+  if (fs.existsSync(installedPath)) return installedPath;
+
+  // Try source location
+  const sourcePath = path.join(
+    rootDir,
+    'packages',
+    'cli',
+    'src',
+    'core',
+    'experts',
+    agent,
+    'expertise.yaml'
+  );
+  if (fs.existsSync(sourcePath)) return sourcePath;
+
+  return null;
+}
+
+// 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);
+    }
+
+    fs.writeFileSync(expertisePath, content);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// Format learning as YAML
+function formatLearning(summary, files, detectedDomain) {
+  const date = new Date().toISOString().split('T')[0];
+  const topFiles = files
+    .slice(0, 5)
+    .map(f => `      - ${f}`)
+    .join('\n');
+
+  return `  - date: "${date}"
+    auto_generated: true
+    context: "Session work - ${detectedDomain || 'general'} domain"
+    insight: "${summary.replace(/"/g, '\\"')}"
+    files_touched:
+${topFiles}`;
+}
+
+// Main function
+function main() {
+  const rootDir = getProjectRoot();
+  const state = getSessionState(rootDir);
+  const diff = getGitDiff(rootDir);
+
+  // Check if there were any changes
+  if (!diff.hasChanges) {
+    return; // Silent exit - no changes to learn from
+  }
+
+  // Detect which agent was active
+  let activeAgent = null;
+
+  // Check session state for active command
+  if (state.active_command?.name) {
+    const name = state.active_command.name.replace('agileflow-', '');
+    if (AGENTS_WITH_EXPERTISE.includes(name)) {
+      activeAgent = name;
+    }
+  }
+
+  // If no agent from session, detect from file changes
+  if (!activeAgent) {
+    activeAgent = detectDomain(diff.files);
+  }
+
+  // If still no agent, skip
+  if (!activeAgent || !AGENTS_WITH_EXPERTISE.includes(activeAgent)) {
+    return; // Silent exit - can't determine which agent to update
+  }
+
+  // Find expertise file
+  const expertisePath = getExpertisePath(rootDir, activeAgent);
+  if (!expertisePath) {
+    return; // Silent exit - no expertise file found
+  }
+
+  // Generate learning summary
+  const summary = generateLearningSummary(diff, activeAgent);
+  if (!summary) {
+    return; // Silent exit - no meaningful summary
+  }
+
+  // Format and append learning
+  const learningYaml = formatLearning(summary, diff.files, activeAgent);
+  const success = appendLearning(expertisePath, learningYaml);
+
+  if (success) {
+    console.log('');
+    console.log(`${c.green}✓ Auto-learned:${c.reset} ${c.dim}${activeAgent}${c.reset}`);
+    console.log(`${c.dim}  ${summary}${c.reset}`);
+    console.log(
+      `${c.dim}  → Updated ${path.basename(path.dirname(expertisePath))}/expertise.yaml${c.reset}`
+    );
+    console.log('');
+  }
+}
+
+// Run if executed directly
+if (require.main === module) {
+  try {
+    main();
+  } catch (e) {
+    // Silent fail - don't break the workflow
+    if (process.env.DEBUG) {
+      console.error('auto-self-improve error:', e.message);
+    }
+  }
+}
+
+module.exports = { main, detectDomain, generateLearningSummary };

package/scripts/check-update.js

@@ -232,10 +232,7 @@ async function checkForUpdates(options = {}) {
   }
 
   // Check if we just updated (lastSeenVersion < installed)
-  if (
-    config.lastSeenVersion &&
-    compareVersions(config.lastSeenVersion, installedVersion) < 0
-  ) {
+  if (config.lastSeenVersion && compareVersions(config.lastSeenVersion, installedVersion) < 0) {
     result.justUpdated = true;
     result.previousVersion = config.lastSeenVersion;
   }

package/scripts/get-env.js

@@ -154,32 +154,40 @@ function formatOutput(info, asJson = false, compact = false) {
     cyan: '\x1b[36m',
     red: '\x1b[31m',
     brand: '\x1b[38;2;232;104;58m', // #e8683a - AgileFlow brand orange
+
+    // 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
+    skyBlue: '\x1b[38;5;117m',      // Directories/paths
+    lavender: '\x1b[38;5;147m',     // Model info
   };
 
-  // Beautiful compact colorful format
+  // Beautiful compact colorful format (using vibrant 256-color palette)
   const lines = [];
 
   // Header line with project info (brand color name, dim version, colored branch)
-  const branchColor = info.git.branch === 'main' ? c.green : c.cyan;
+  const branchColor = info.git.branch === 'main' ? c.mintGreen : c.skyBlue;
   lines.push(
     `${c.brand}${c.bold}${info.project.name}${c.reset} ${c.dim}v${info.project.version}${c.reset} | ${branchColor}${info.git.branch}${c.reset} ${c.dim}(${info.git.commit})${c.reset}`
   );
 
-  // Status line (yellow WIP, red blocked)
-  const wipColor = info.agileflow.wipCount > 0 ? c.yellow : c.dim;
+  // Status line (peach WIP, coral blocked)
+  const wipColor = info.agileflow.wipCount > 0 ? c.peach : c.dim;
   let statusLine =
     info.agileflow.wipCount > 0
       ? `${wipColor}WIP: ${info.agileflow.wipCount}${c.reset}`
       : `${c.dim}No active work${c.reset}`;
   if (info.agileflow.blockedCount > 0) {
-    statusLine += ` | ${c.red}Blocked: ${info.agileflow.blockedCount}${c.reset}`;
+    statusLine += ` | ${c.coral}Blocked: ${info.agileflow.blockedCount}${c.reset}`;
   }
   lines.push(statusLine);
 
-  // Active story (if any) - just the first one (blue label)
+  // Active story (if any) - just the first one (sky blue label)
   if (info.agileflow.activeStories.length > 0) {
     const story = info.agileflow.activeStories[0];
-    lines.push(`${c.blue}Current:${c.reset} ${story.id} - ${story.title}`);
+    lines.push(`${c.skyBlue}Current:${c.reset} ${story.id} - ${story.title}`);
   }
 
   // Last commit (just one, dim)

package/scripts/lib/frontmatter-parser.js

@@ -69,7 +69,10 @@ function normalizeTools(tools) {
   if (!tools) return [];
   if (Array.isArray(tools)) return tools;
   if (typeof tools === 'string') {
-    return tools.split(',').map(t => t.trim()).filter(Boolean);
+    return tools
+      .split(',')
+      .map(t => t.trim())
+      .filter(Boolean);
   }
   return [];
 }

package/scripts/obtain-context.js

@@ -55,6 +55,16 @@ const C = {
   brightYellow: '\x1b[93m',
   brightGreen: '\x1b[92m',
   brand: '\x1b[38;2;232;104;58m', // AgileFlow brand orange
+
+  // 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
+  skyBlue: '\x1b[38;5;117m',      // Directories/paths
+  lavender: '\x1b[38;5;147m',     // Model info
+  softGold: '\x1b[38;5;222m',     // Cost/money
 };
 
 function safeRead(filePath) {
@@ -111,7 +121,7 @@ function generateSummary() {
 
   const W = 58; // Total inner width (matches welcome script)
   const L = 20; // Left column width
-  const R = W - L - 3; // Right column width (35 chars)
+  const R = W - 24; // Right column width (34 chars) - matches welcome
 
   // Pad string to length, accounting for ANSI codes
   function pad(str, len) {
@@ -155,11 +165,12 @@ function generateSummary() {
     return `${C.dim}${box.v}${C.reset} ${pad(leftStr, L)} ${C.dim}${box.v}${C.reset} ${pad(rightStr, R)} ${C.dim}${box.v}${C.reset}\n`;
   }
 
+  // All borders use same width formula: 22 dashes + separator + 36 dashes = 61 total chars
   const divider = () =>
-    `${C.dim}${box.lT}${box.h.repeat(L + 2)}${box.cross}${box.h.repeat(R + 2)}${box.rT}${C.reset}\n`;
-  const headerTopBorder = `${C.dim}${box.tl}${box.h.repeat(W + 2)}${box.tr}${C.reset}\n`;
-  const headerDivider = `${C.dim}${box.lT}${box.h.repeat(L + 2)}${box.tT}${box.h.repeat(R + 2)}${box.rT}${C.reset}\n`;
-  const bottomBorder = `${C.dim}${box.bl}${box.h.repeat(L + 2)}${box.bT}${box.h.repeat(R + 2)}${box.br}${C.reset}\n`;
+    `${C.dim}${box.lT}${box.h.repeat(L + 2)}${box.cross}${box.h.repeat(W - L - 2)}${box.rT}${C.reset}\n`;
+  const headerTopBorder = `${C.dim}${box.tl}${box.h.repeat(L + 2)}${box.tT}${box.h.repeat(W - L - 2)}${box.tr}${C.reset}\n`;
+  const headerDivider = `${C.dim}${box.lT}${box.h.repeat(L + 2)}${box.tT}${box.h.repeat(W - L - 2)}${box.rT}${C.reset}\n`;
+  const bottomBorder = `${C.dim}${box.bl}${box.h.repeat(L + 2)}${box.bT}${box.h.repeat(W - L - 2)}${box.br}${C.reset}\n`;
 
   // Gather data
   const branch = safeExec('git branch --show-current') || 'unknown';
@@ -200,35 +211,35 @@ function generateSummary() {
 
   // Header row (full width, no column divider)
   const title = commandName ? `Context [${commandName}]` : 'Context Summary';
-  const branchColor = branch === 'main' ? C.green : branch.startsWith('fix') ? C.red : C.cyan;
+  const branchColor = branch === 'main' ? C.mintGreen : branch.startsWith('fix') ? C.coral : C.skyBlue;
   const maxBranchLen = 20;
   const branchDisplay =
     branch.length > maxBranchLen ? branch.substring(0, maxBranchLen - 2) + '..' : branch;
   const header = `${C.brand}${C.bold}${title}${C.reset}  ${branchColor}${branchDisplay}${C.reset} ${C.dim}(${lastCommitShort})${C.reset}`;
-  summary += `${C.dim}${box.v}${C.reset} ${pad(header, W)} ${C.dim}${box.v}${C.reset}\n`;
+  summary += `${C.dim}${box.v}${C.reset} ${pad(header, W - 1)} ${C.dim}${box.v}${C.reset}\n`;
 
   summary += headerDivider;
 
-  // Story counts with colorful labels
+  // Story counts with vibrant 256-color palette
   summary += row(
     'In Progress',
     byStatus['in-progress'] ? `${byStatus['in-progress']}` : '0',
-    C.yellow,
-    byStatus['in-progress'] ? C.brightYellow : C.dim
+    C.peach,
+    byStatus['in-progress'] ? C.peach : C.dim
   );
   summary += row(
     'Blocked',
     byStatus['blocked'] ? `${byStatus['blocked']}` : '0',
-    C.red,
-    byStatus['blocked'] ? C.red : C.dim
+    C.coral,
+    byStatus['blocked'] ? C.coral : C.dim
   );
   summary += row(
     'Ready',
     byStatus['ready'] ? `${byStatus['ready']}` : '0',
-    C.cyan,
-    byStatus['ready'] ? C.brightCyan : C.dim
+    C.skyBlue,
+    byStatus['ready'] ? C.skyBlue : C.dim
   );
-  const completedColor = `${C.bold}${C.green}`;
+  const completedColor = `${C.bold}${C.mintGreen}`;
   summary += row(
     'Completed',
     byStatus['done'] ? `${byStatus['done']}` : '0',
@@ -238,27 +249,27 @@ function generateSummary() {
 
   summary += divider();
 
-  // Git status
+  // Git status (using vibrant 256-color palette)
   const uncommittedStatus =
     statusLines.length > 0 ? `${statusLines.length} uncommitted` : '✓ clean';
-  summary += row('Git', uncommittedStatus, C.blue, statusLines.length > 0 ? C.yellow : C.green);
+  summary += row('Git', uncommittedStatus, C.blue, statusLines.length > 0 ? C.peach : C.mintGreen);
 
   // Session
   const sessionText = sessionDuration !== null ? `${sessionDuration} min active` : 'no session';
-  summary += row('Session', sessionText, C.blue, sessionDuration !== null ? C.brightGreen : C.dim);
+  summary += row('Session', sessionText, C.blue, sessionDuration !== null ? C.lightGreen : C.dim);
 
   // Current story
   const storyText = currentStory ? currentStory : 'none';
-  summary += row('Working on', storyText, C.blue, currentStory ? C.brightYellow : C.dim);
+  summary += row('Working on', storyText, C.blue, currentStory ? C.lightYellow : C.dim);
 
   // Ready stories (if any)
   if (readyStories.length > 0) {
-    summary += row('⭐ Up Next', readyStories.slice(0, 3).join(', '), C.brightCyan, C.cyan);
+    summary += row('⭐ Up Next', readyStories.slice(0, 3).join(', '), C.skyBlue, C.skyBlue);
   }
 
   summary += divider();
 
-  // Key files
+  // Key files (using vibrant 256-color palette)
   const keyFileChecks = [
     { path: 'CLAUDE.md', label: 'CLAUDE' },
     { path: 'README.md', label: 'README' },
@@ -268,31 +279,31 @@ function generateSummary() {
   const keyFileStatus = keyFileChecks
     .map(f => {
       const exists = fs.existsSync(f.path);
-      return exists ? `${C.brightGreen}✓${C.reset}${f.label}` : `${C.dim}○${f.label}${C.reset}`;
+      return exists ? `${C.mintGreen}✓${C.reset}${f.label}` : `${C.dim}○${f.label}${C.reset}`;
     })
     .join(' ');
-  summary += row('Key files', keyFileStatus, C.magenta, '');
+  summary += row('Key files', keyFileStatus, C.lavender, '');
 
   // Research
   const researchText = researchFiles.length > 0 ? `${researchFiles.length} notes` : 'none';
-  summary += row('Research', researchText, C.magenta, researchFiles.length > 0 ? C.cyan : C.dim);
+  summary += row('Research', researchText, C.lavender, researchFiles.length > 0 ? C.skyBlue : C.dim);
 
   // Epics
   const epicText = epicFiles.length > 0 ? `${epicFiles.length} epics` : 'none';
-  summary += row('Epics', epicText, C.magenta, epicFiles.length > 0 ? C.cyan : C.dim);
+  summary += row('Epics', epicText, C.lavender, epicFiles.length > 0 ? C.skyBlue : C.dim);
 
   summary += divider();
 
-  // Last commit
+  // Last commit (using vibrant 256-color palette)
   summary += row(
     'Last commit',
-    `${C.yellow}${lastCommitShort}${C.reset} ${lastCommitMsg}`,
+    `${C.peach}${lastCommitShort}${C.reset} ${lastCommitMsg}`,
     C.dim,
     ''
   );
 
   summary += bottomBorder;
-
+  summary += '\n';
   summary += `${C.dim}Full context continues below (Claude sees all)...${C.reset}\n\n`;
 
   return summary;
@@ -306,29 +317,29 @@ function generateFullContent() {
   let content = '';
 
   const title = commandName ? `AgileFlow Context [${commandName}]` : 'AgileFlow Context';
-  content += `${C.magenta}${C.bold}${title}${C.reset}\n`;
+  content += `${C.lavender}${C.bold}${title}${C.reset}\n`;
   content += `${C.dim}Generated: ${new Date().toISOString()}${C.reset}\n`;
 
-  // 1. GIT STATUS
-  content += `\n${C.cyan}${C.bold}═══ Git Status ═══${C.reset}\n`;
+  // 1. GIT STATUS (using vibrant 256-color palette)
+  content += `\n${C.skyBlue}${C.bold}═══ Git Status ═══${C.reset}\n`;
   const branch = safeExec('git branch --show-current') || 'unknown';
   const status = safeExec('git status --short') || '';
   const statusLines = status.split('\n').filter(Boolean);
   const lastCommit = safeExec('git log -1 --format="%h %s"') || 'no commits';
 
-  content += `Branch: ${C.green}${branch}${C.reset}\n`;
+  content += `Branch: ${C.mintGreen}${branch}${C.reset}\n`;
   content += `Last commit: ${C.dim}${lastCommit}${C.reset}\n`;
   if (statusLines.length > 0) {
-    content += `Uncommitted: ${C.yellow}${statusLines.length} file(s)${C.reset}\n`;
+    content += `Uncommitted: ${C.peach}${statusLines.length} file(s)${C.reset}\n`;
     statusLines.slice(0, 10).forEach(line => (content += `  ${C.dim}${line}${C.reset}\n`));
     if (statusLines.length > 10)
       content += `  ${C.dim}... and ${statusLines.length - 10} more${C.reset}\n`;
   } else {
-    content += `Uncommitted: ${C.green}clean${C.reset}\n`;
+    content += `Uncommitted: ${C.mintGreen}clean${C.reset}\n`;
   }
 
-  // 2. STATUS.JSON - Full Content
-  content += `\n${C.cyan}${C.bold}═══ Status.json (Full Content) ═══${C.reset}\n`;
+  // 2. STATUS.JSON - Full Content (using vibrant 256-color palette)
+  content += `\n${C.skyBlue}${C.bold}═══ Status.json (Full Content) ═══${C.reset}\n`;
   const statusJsonPath = 'docs/09-agents/status.json';
   const statusJson = safeReadJSON(statusJsonPath);
 
@@ -344,30 +355,30 @@ function generateFullContent() {
     content += `${C.dim}No status.json found${C.reset}\n`;
   }
 
-  // 3. SESSION STATE
-  content += `\n${C.cyan}${C.bold}═══ Session State ═══${C.reset}\n`;
+  // 3. SESSION STATE (using vibrant 256-color palette)
+  content += `\n${C.skyBlue}${C.bold}═══ Session State ═══${C.reset}\n`;
   const sessionState = safeReadJSON('docs/09-agents/session-state.json');
   if (sessionState) {
     const current = sessionState.current_session;
     if (current && current.started_at) {
       const started = new Date(current.started_at);
       const duration = Math.round((Date.now() - started.getTime()) / 60000);
-      content += `Active session: ${C.green}${duration} min${C.reset}\n`;
+      content += `Active session: ${C.lightGreen}${duration} min${C.reset}\n`;
       if (current.current_story) {
-        content += `Working on: ${C.yellow}${current.current_story}${C.reset}\n`;
+        content += `Working on: ${C.lightYellow}${current.current_story}${C.reset}\n`;
       }
     } else {
       content += `${C.dim}No active session${C.reset}\n`;
     }
     if (sessionState.active_command) {
-      content += `Active command: ${C.cyan}${sessionState.active_command.name}${C.reset}\n`;
+      content += `Active command: ${C.skyBlue}${sessionState.active_command.name}${C.reset}\n`;
     }
   } else {
     content += `${C.dim}No session-state.json found${C.reset}\n`;
   }
 
-  // 4. DOCS STRUCTURE
-  content += `\n${C.cyan}${C.bold}═══ Documentation ═══${C.reset}\n`;
+  // 4. DOCS STRUCTURE (using vibrant 256-color palette)
+  content += `\n${C.skyBlue}${C.bold}═══ Documentation ═══${C.reset}\n`;
   const docsDir = 'docs';
   const docFolders = safeLs(docsDir).filter(f => {
     try {
@@ -390,8 +401,8 @@ function generateFullContent() {
     });
   }
 
-  // 5. RESEARCH NOTES - List + Full content of most recent
-  content += `\n${C.cyan}${C.bold}═══ Research Notes ═══${C.reset}\n`;
+  // 5. RESEARCH NOTES - List + Full content of most recent (using vibrant 256-color palette)
+  content += `\n${C.skyBlue}${C.bold}═══ Research Notes ═══${C.reset}\n`;
   const researchDir = 'docs/10-research';
   const researchFiles = safeLs(researchDir).filter(f => f.endsWith('.md') && f !== 'README.md');
   if (researchFiles.length > 0) {
@@ -404,7 +415,7 @@ function generateFullContent() {
     const mostRecentContent = safeRead(mostRecentPath);
 
     if (mostRecentContent) {
-      content += `\n${C.green}📄 Most Recent: ${mostRecentFile}${C.reset}\n`;
+      content += `\n${C.mintGreen}📄 Most Recent: ${mostRecentFile}${C.reset}\n`;
       content += `${C.dim}${'─'.repeat(60)}${C.reset}\n`;
       content += mostRecentContent + '\n';
       content += `${C.dim}${'─'.repeat(60)}${C.reset}\n`;
@@ -413,8 +424,8 @@ function generateFullContent() {
     content += `${C.dim}No research notes${C.reset}\n`;
   }
 
-  // 6. BUS MESSAGES
-  content += `\n${C.cyan}${C.bold}═══ Recent Agent Messages ═══${C.reset}\n`;
+  // 6. BUS MESSAGES (using vibrant 256-color palette)
+  content += `\n${C.skyBlue}${C.bold}═══ Recent Agent Messages ═══${C.reset}\n`;
   const busPath = 'docs/09-agents/bus/log.jsonl';
   const busContent = safeRead(busPath);
   if (busContent) {