agileflow 2.76.0 → 2.77.0

package/scripts/auto-self-improve.js

@@ -36,24 +36,44 @@ const c = {
 
 // 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'
+  '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/],
+  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
@@ -83,19 +103,28 @@ function getGitDiff(rootDir) {
     const diffFiles = execSync('git diff --name-only HEAD 2>/dev/null || git diff --name-only', {
       cwd: rootDir,
       encoding: 'utf8',
-    }).trim().split('\n').filter(Boolean);
+    })
+      .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);
+    })
+      .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);
+    })
+      .trim()
+      .split('\n')
+      .filter(Boolean);
 
     // Combine all
     const allFiles = [...new Set([...diffFiles, ...stagedFiles, ...untrackedFiles])];
@@ -186,7 +215,16 @@ function getExpertisePath(rootDir, agent) {
   if (fs.existsSync(installedPath)) return installedPath;
 
   // Try source location
-  const sourcePath = path.join(rootDir, 'packages', 'cli', 'src', 'core', 'experts', agent, 'expertise.yaml');
+  const sourcePath = path.join(
+    rootDir,
+    'packages',
+    'cli',
+    'src',
+    'core',
+    'experts',
+    agent,
+    'expertise.yaml'
+  );
   if (fs.existsSync(sourcePath)) return sourcePath;
 
   return null;
@@ -219,7 +257,10 @@ function appendLearning(expertisePath, learning) {
 // 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');
+  const topFiles = files
+    .slice(0, 5)
+    .map(f => `      - ${f}`)
+    .join('\n');
 
   return `  - date: "${date}"
     auto_generated: true
@@ -281,7 +322,9 @@ function main() {
     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(
+      `${c.dim}  → Updated ${path.basename(path.dirname(expertisePath))}/expertise.yaml${c.reset}`
+    );
     console.log('');
   }
 }

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) {

package/scripts/ralph-loop.js

@@ -136,9 +136,7 @@ function getNextStory(status, epicId, currentStoryId) {
   // Get all stories in this epic that are ready
   const readyStories = Object.entries(stories)
     .filter(([id, story]) => {
-      return story.epic === epicId &&
-             story.status === 'ready' &&
-             id !== currentStoryId;
+      return story.epic === epicId && story.status === 'ready' && id !== currentStoryId;
     })
     .sort((a, b) => {
       // Sort by story number if possible
@@ -215,9 +213,15 @@ function handleLoop(rootDir) {
   const maxIterations = loop.max_iterations || 20;
 
   console.log('');
-  console.log(`${c.brand}${c.bold}══════════════════════════════════════════════════════════${c.reset}`);
-  console.log(`${c.brand}${c.bold}  RALPH LOOP - Iteration ${iteration}/${maxIterations}${c.reset}`);
-  console.log(`${c.brand}${c.bold}══════════════════════════════════════════════════════════${c.reset}`);
+  console.log(
+    `${c.brand}${c.bold}══════════════════════════════════════════════════════════${c.reset}`
+  );
+  console.log(
+    `${c.brand}${c.bold}  RALPH LOOP - Iteration ${iteration}/${maxIterations}${c.reset}`
+  );
+  console.log(
+    `${c.brand}${c.bold}══════════════════════════════════════════════════════════${c.reset}`
+  );
   console.log('');
 
   // Check iteration limit
@@ -243,7 +247,9 @@ function handleLoop(rootDir) {
     return;
   }
 
-  console.log(`${c.cyan}Current Story:${c.reset} ${currentStoryId} - ${currentStory.title || 'Untitled'}`);
+  console.log(
+    `${c.cyan}Current Story:${c.reset} ${currentStoryId} - ${currentStory.title || 'Untitled'}`
+  );
   console.log('');
 
   // Run tests
@@ -283,11 +289,12 @@ function handleLoop(rootDir) {
         criteria.slice(0, 3).forEach(ac => console.log(`  • ${ac}`));
       }
       console.log('');
-      console.log(`${c.dim}Epic Progress: ${progress.completed}/${progress.total} stories complete${c.reset}`);
+      console.log(
+        `${c.dim}Epic Progress: ${progress.completed}/${progress.total} stories complete${c.reset}`
+      );
       console.log('');
       console.log(`${c.brand}▶ Continue implementing ${nextStory.id}${c.reset}`);
       console.log(`${c.dim}  Run tests when ready. Loop will validate and continue.${c.reset}`);
-
     } else {
       // No more stories - epic complete!
       const progress = getEpicProgress(getStatus(rootDir), epicId);
@@ -297,15 +304,18 @@ function handleLoop(rootDir) {
       saveSessionState(rootDir, state);
 
       console.log('');
-      console.log(`${c.green}${c.bold}════════════════════════════════════════════════════════${c.reset}`);
+      console.log(
+        `${c.green}${c.bold}════════════════════════════════════════════════════════${c.reset}`
+      );
       console.log(`${c.green}${c.bold}  🎉 EPIC COMPLETE!${c.reset}`);
-      console.log(`${c.green}${c.bold}════════════════════════════════════════════════════════${c.reset}`);
+      console.log(
+        `${c.green}${c.bold}════════════════════════════════════════════════════════${c.reset}`
+      );
       console.log('');
       console.log(`${c.green}Epic ${epicId} finished in ${iteration} iterations${c.reset}`);
       console.log(`${c.dim}${progress.completed} stories completed${c.reset}`);
       console.log('');
     }
-
   } else {
     // Tests failed - feed back to Claude
     console.log(`${c.red}✗ Tests failed${c.reset} (${(testResult.duration / 1000).toFixed(1)}s)`);
@@ -440,7 +450,9 @@ function handleCLI() {
       criteria.slice(0, 3).forEach(ac => console.log(`    • ${ac}`));
     }
     console.log('');
-    console.log(`${c.dim}Work on this story. When you stop, tests will run automatically.${c.reset}`);
+    console.log(
+      `${c.dim}Work on this story. When you stop, tests will run automatically.${c.reset}`
+    );
     console.log(`${c.dim}If tests pass, the next story will be loaded.${c.reset}`);
     console.log('');
 

package/scripts/validate-expertise.sh

@@ -22,12 +22,16 @@
 
 set -e
 
-# Colors
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
+# Colors (using vibrant 256-color palette)
+NC='\033[0m'        # No Color / Reset
+RED='\033[0;31m'    # Standard red (fallback)
+GREEN='\033[0;32m'  # Standard green (fallback)
+
+# Vibrant 256-color palette
+MINT_GREEN='\033[38;5;158m'   # Healthy/success states
+PEACH='\033[38;5;215m'        # Warning states
+CORAL='\033[38;5;203m'        # Critical/error states
+SKY_BLUE='\033[38;5;117m'     # Headers/titles
 
 # Configuration
 EXPERTS_DIR="packages/cli/src/core/experts"
@@ -180,18 +184,18 @@ validate_expertise() {
         fi
     fi
 
-    # Output result
+    # Output result (using vibrant 256-color palette)
     case "$status" in
         PASS)
-            echo -e "${GREEN}PASS${NC}  $domain"
+            echo -e "${MINT_GREEN}PASS${NC}  $domain"
             PASSED=$((PASSED + 1))
             ;;
         WARN)
-            echo -e "${YELLOW}WARN${NC}  $domain - ${issues[*]}"
+            echo -e "${PEACH}WARN${NC}  $domain - ${issues[*]}"
             WARNINGS=$((WARNINGS + 1))
             ;;
         FAIL)
-            echo -e "${RED}FAIL${NC}  $domain - ${issues[*]}"
+            echo -e "${CORAL}FAIL${NC}  $domain - ${issues[*]}"
             FAILED=$((FAILED + 1))
             ;;
     esac
@@ -212,12 +216,12 @@ main() {
 
     # Check experts directory exists
     if [ ! -d "$EXPERTS_DIR" ]; then
-        echo -e "${RED}Error:${NC} Experts directory not found: $EXPERTS_DIR"
+        echo -e "${CORAL}Error:${NC} Experts directory not found: $EXPERTS_DIR"
         echo "Are you running this from the repository root?"
         exit 1
     fi
 
-    echo -e "${BLUE}Validating Agent Expert Files${NC}"
+    echo -e "${SKY_BLUE}Validating Agent Expert Files${NC}"
     echo "================================"
     echo ""
 
@@ -225,7 +229,7 @@ main() {
     if [ -n "$1" ]; then
         # Single domain
         if [ ! -d "$EXPERTS_DIR/$1" ]; then
-            echo -e "${RED}Error:${NC} Domain not found: $1"
+            echo -e "${CORAL}Error:${NC} Domain not found: $1"
             echo "Available domains:"
             ls -1 "$EXPERTS_DIR" | grep -v templates | grep -v README
             exit 1
@@ -244,10 +248,10 @@ main() {
         done
     fi
 
-    # Summary
+    # Summary (using vibrant 256-color palette)
     echo ""
     echo "================================"
-    echo -e "Total: $TOTAL | ${GREEN}Passed: $PASSED${NC} | ${YELLOW}Warnings: $WARNINGS${NC} | ${RED}Failed: $FAILED${NC}"
+    echo -e "Total: $TOTAL | ${MINT_GREEN}Passed: $PASSED${NC} | ${PEACH}Warnings: $WARNINGS${NC} | ${CORAL}Failed: $FAILED${NC}"
 
     # Exit code
     if [ "$FAILED" -gt 0 ]; then

package/tools/cli/commands/list.js

@@ -10,7 +10,9 @@ const fs = require('fs-extra');
 const yaml = require('js-yaml');
 const { Installer } = require('../installers/core/installer');
 const { displayLogo, displaySection, success, warning, info } = require('../lib/ui');
-const { parseFrontmatter: parseYamlFrontmatter } = require('../../../scripts/lib/frontmatter-parser');
+const {
+  parseFrontmatter: parseYamlFrontmatter,
+} = require('../../../scripts/lib/frontmatter-parser');
 
 const installer = new Installer();