agileflow 2.50.0 → 2.55.0

package/scripts/obtain-context.js

@@ -3,19 +3,24 @@
  * obtain-context.js
  *
  * Gathers all project context in a single execution for any AgileFlow command or agent.
- * Optionally registers the command/agent for PreCompact context preservation.
- * Outputs structured summary to reduce tool calls and startup time.
+ *
+ * SMART OUTPUT STRATEGY:
+ * - Calculates summary character count dynamically
+ * - Shows (30K - summary_chars) of full content first
+ * - Then shows the summary (so user sees it at their display cutoff)
+ * - Then shows rest of full content (for Claude)
  *
  * Usage:
  *   node scripts/obtain-context.js              # Just gather context
  *   node scripts/obtain-context.js babysit      # Gather + register 'babysit'
- *   node scripts/obtain-context.js mentor       # Gather + register 'mentor'
  */
 
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
+const DISPLAY_LIMIT = 30000; // Claude Code's Bash tool display limit
+
 // Optional: Register command for PreCompact context preservation
 const commandName = process.argv[2];
 if (commandName) {
@@ -23,7 +28,11 @@ if (commandName) {
   if (fs.existsSync(sessionStatePath)) {
     try {
       const state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-      state.active_command = { name: commandName, activated_at: new Date().toISOString(), state: {} };
+      state.active_command = {
+        name: commandName,
+        activated_at: new Date().toISOString(),
+        state: {},
+      };
       fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
     } catch (e) {
       // Silently continue if session state can't be updated
@@ -41,6 +50,11 @@ const C = {
   green: '\x1b[32m',
   red: '\x1b[31m',
   magenta: '\x1b[35m',
+  blue: '\x1b[34m',
+  brightCyan: '\x1b[96m',
+  brightYellow: '\x1b[93m',
+  brightGreen: '\x1b[92m',
+  brand: '\x1b[38;2;232;104;58m', // AgileFlow brand orange
 };
 
 function safeRead(filePath) {
@@ -75,219 +89,416 @@ function safeExec(cmd) {
   }
 }
 
-function section(title) {
-  console.log(`\n${C.cyan}${C.bold}═══ ${title} ═══${C.reset}`);
-}
-
-function subsection(title) {
-  console.log(`${C.dim}───${C.reset} ${title}`);
-}
-
 // ============================================
-// MAIN CONTEXT GATHERING
+// GENERATE SUMMARY (calculated first for positioning)
 // ============================================
 
-const title = commandName ? `AgileFlow Context [${commandName}]` : 'AgileFlow Context';
-console.log(`${C.magenta}${C.bold}${title}${C.reset}`);
-console.log(`${C.dim}Generated: ${new Date().toISOString()}${C.reset}`);
-
-// 1. GIT STATUS
-section('Git Status');
-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';
-
-console.log(`Branch: ${C.green}${branch}${C.reset}`);
-console.log(`Last commit: ${C.dim}${lastCommit}${C.reset}`);
-if (statusLines.length > 0) {
-  console.log(`Uncommitted: ${C.yellow}${statusLines.length} file(s)${C.reset}`);
-  statusLines.slice(0, 10).forEach(line => console.log(`  ${C.dim}${line}${C.reset}`));
-  if (statusLines.length > 10) console.log(`  ${C.dim}... and ${statusLines.length - 10} more${C.reset}`);
-} else {
-  console.log(`Uncommitted: ${C.green}clean${C.reset}`);
-}
+function generateSummary() {
+  // Box drawing characters
+  const box = {
+    tl: '╭',
+    tr: '╮',
+    bl: '╰',
+    br: '╯',
+    h: '─',
+    v: '│',
+    lT: '├',
+    rT: '┤',
+    tT: '┬',
+    bT: '┴',
+    cross: '┼',
+  };
 
-// 2. STATUS.JSON - Stories & Epics
-section('Stories & Epics');
-const statusJson = safeReadJSON('docs/09-agents/status.json');
-if (statusJson) {
-  // Epics summary
-  const epics = statusJson.epics || {};
-  const epicList = Object.entries(epics);
-  if (epicList.length > 0) {
-    subsection('Epics');
-    epicList.forEach(([id, epic]) => {
-      const statusColor = epic.status === 'complete' ? C.green : epic.status === 'active' ? C.yellow : C.dim;
-      console.log(`  ${id}: ${epic.title} ${statusColor}[${epic.status}]${C.reset}`);
-    });
+  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)
+
+  // Pad string to length, accounting for ANSI codes
+  function pad(str, len) {
+    const stripped = str.replace(/\x1b\[[0-9;]*m/g, '');
+    const diff = len - stripped.length;
+    if (diff <= 0) return str;
+    return str + ' '.repeat(diff);
   }
 
-  // Stories summary by status
-  const stories = statusJson.stories || {};
-  const storyList = Object.entries(stories);
-  const byStatus = {};
-  storyList.forEach(([id, story]) => {
-    const s = story.status || 'unknown';
-    if (!byStatus[s]) byStatus[s] = [];
-    byStatus[s].push({ id, ...story });
-  });
+  // Truncate string to max length, respecting ANSI codes
+  function truncate(str, maxLen, suffix = '..') {
+    const stripped = str.replace(/\x1b\[[0-9;]*m/g, '');
+    if (stripped.length <= maxLen) return str;
 
-  // Priority order for display
-  const statusOrder = ['in-progress', 'ready', 'blocked', 'draft', 'in-review', 'done'];
-
-  subsection('Stories by Status');
-  statusOrder.forEach(status => {
-    if (byStatus[status] && byStatus[status].length > 0) {
-      const color = status === 'in-progress' ? C.yellow :
-                    status === 'ready' ? C.green :
-                    status === 'blocked' ? C.red :
-                    status === 'done' ? C.dim : C.reset;
-      console.log(`  ${color}${status}${C.reset}: ${byStatus[status].length}`);
-      byStatus[status].slice(0, 5).forEach(story => {
-        console.log(`    ${C.dim}${story.id}: ${story.title}${C.reset}`);
-      });
-      if (byStatus[status].length > 5) {
-        console.log(`    ${C.dim}... and ${byStatus[status].length - 5} more${C.reset}`);
+    const targetLen = maxLen - suffix.length;
+    let visibleCount = 0;
+    let cutIndex = 0;
+    let inEscape = false;
+
+    for (let i = 0; i < str.length; i++) {
+      if (str[i] === '\x1b') {
+        inEscape = true;
+      } else if (inEscape && str[i] === 'm') {
+        inEscape = false;
+      } else if (!inEscape) {
+        visibleCount++;
+        if (visibleCount >= targetLen) {
+          cutIndex = i + 1;
+          break;
+        }
       }
     }
-  });
+    return str.substring(0, cutIndex) + suffix;
+  }
+
+  // Create a row with auto-truncation
+  function row(left, right, leftColor = '', rightColor = '') {
+    const leftStr = `${leftColor}${left}${leftColor ? C.reset : ''}`;
+    const rightTrunc = truncate(right, R);
+    const rightStr = `${rightColor}${rightTrunc}${rightColor ? C.reset : ''}`;
+    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`;
+  }
 
-  // Show READY stories prominently (these are actionable)
-  if (byStatus['ready'] && byStatus['ready'].length > 0) {
-    subsection(`${C.green}⭐ Ready to Implement${C.reset}`);
-    byStatus['ready'].forEach(story => {
-      console.log(`  ${story.id}: ${story.title} (${story.epic || 'no epic'})`);
+  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`;
+
+  // Gather data
+  const branch = safeExec('git branch --show-current') || 'unknown';
+  const lastCommitShort = safeExec('git log -1 --format="%h"') || '?';
+  const lastCommitMsg = safeExec('git log -1 --format="%s"') || 'no commits';
+  const statusLines = (safeExec('git status --short') || '').split('\n').filter(Boolean);
+  const statusJson = safeReadJSON('docs/09-agents/status.json');
+  const sessionState = safeReadJSON('docs/09-agents/session-state.json');
+  const researchFiles = safeLs('docs/10-research')
+    .filter(f => f.endsWith('.md') && f !== 'README.md')
+    .sort()
+    .reverse();
+  const epicFiles = safeLs('docs/05-epics').filter(f => f.endsWith('.md') && f !== 'README.md');
+
+  // Count stories by status
+  const byStatus = {};
+  const readyStories = [];
+  if (statusJson && statusJson.stories) {
+    Object.entries(statusJson.stories).forEach(([id, story]) => {
+      const s = story.status || 'unknown';
+      byStatus[s] = (byStatus[s] || 0) + 1;
+      if (s === 'ready') readyStories.push(id);
     });
   }
-} else {
-  console.log(`${C.dim}No status.json found${C.reset}`);
+
+  // Session info
+  let sessionDuration = null;
+  let currentStory = null;
+  if (sessionState && sessionState.current_session && sessionState.current_session.started_at) {
+    const started = new Date(sessionState.current_session.started_at);
+    sessionDuration = Math.round((Date.now() - started.getTime()) / 60000);
+    currentStory = sessionState.current_session.current_story;
+  }
+
+  // Build table
+  let summary = '\n';
+  summary += headerTopBorder;
+
+  // 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 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 += headerDivider;
+
+  // Story counts with colorful labels
+  summary += row(
+    'In Progress',
+    byStatus['in-progress'] ? `${byStatus['in-progress']}` : '0',
+    C.yellow,
+    byStatus['in-progress'] ? C.brightYellow : C.dim
+  );
+  summary += row(
+    'Blocked',
+    byStatus['blocked'] ? `${byStatus['blocked']}` : '0',
+    C.red,
+    byStatus['blocked'] ? C.red : C.dim
+  );
+  summary += row(
+    'Ready',
+    byStatus['ready'] ? `${byStatus['ready']}` : '0',
+    C.cyan,
+    byStatus['ready'] ? C.brightCyan : C.dim
+  );
+  const completedColor = `${C.bold}${C.green}`;
+  summary += row(
+    'Completed',
+    byStatus['done'] ? `${byStatus['done']}` : '0',
+    completedColor,
+    byStatus['done'] ? completedColor : C.dim
+  );
+
+  summary += divider();
+
+  // Git status
+  const uncommittedStatus =
+    statusLines.length > 0 ? `${statusLines.length} uncommitted` : '✓ clean';
+  summary += row('Git', uncommittedStatus, C.blue, statusLines.length > 0 ? C.yellow : C.green);
+
+  // Session
+  const sessionText = sessionDuration !== null ? `${sessionDuration} min active` : 'no session';
+  summary += row('Session', sessionText, C.blue, sessionDuration !== null ? C.brightGreen : C.dim);
+
+  // Current story
+  const storyText = currentStory ? currentStory : 'none';
+  summary += row('Working on', storyText, C.blue, currentStory ? C.brightYellow : C.dim);
+
+  // Ready stories (if any)
+  if (readyStories.length > 0) {
+    summary += row('⭐ Up Next', readyStories.slice(0, 3).join(', '), C.brightCyan, C.cyan);
+  }
+
+  summary += divider();
+
+  // Key files
+  const keyFileChecks = [
+    { path: 'CLAUDE.md', label: 'CLAUDE' },
+    { path: 'README.md', label: 'README' },
+    { path: 'docs/04-architecture/README.md', label: 'arch' },
+    { path: 'docs/02-practices/README.md', label: 'practices' },
+  ];
+  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}`;
+    })
+    .join(' ');
+  summary += row('Key files', keyFileStatus, C.magenta, '');
+
+  // Research
+  const researchText = researchFiles.length > 0 ? `${researchFiles.length} notes` : 'none';
+  summary += row('Research', researchText, C.magenta, researchFiles.length > 0 ? C.cyan : 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 += divider();
+
+  // Last commit
+  summary += row(
+    'Last commit',
+    `${C.yellow}${lastCommitShort}${C.reset} ${lastCommitMsg}`,
+    C.dim,
+    ''
+  );
+
+  summary += bottomBorder;
+
+  summary += `${C.dim}Full context continues below (Claude sees all)...${C.reset}\n\n`;
+
+  return summary;
 }
 
-// 3. SESSION STATE
-section('Session State');
-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);
-    console.log(`Active session: ${C.green}${duration} min${C.reset}`);
-    if (current.current_story) {
-      console.log(`Working on: ${C.yellow}${current.current_story}${C.reset}`);
+// ============================================
+// GENERATE FULL CONTENT
+// ============================================
+
+function generateFullContent() {
+  let content = '';
+
+  const title = commandName ? `AgileFlow Context [${commandName}]` : 'AgileFlow Context';
+  content += `${C.magenta}${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`;
+  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 += `Last commit: ${C.dim}${lastCommit}${C.reset}\n`;
+  if (statusLines.length > 0) {
+    content += `Uncommitted: ${C.yellow}${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`;
+  }
+
+  // 2. STATUS.JSON - Full Content
+  content += `\n${C.cyan}${C.bold}═══ Status.json (Full Content) ═══${C.reset}\n`;
+  const statusJsonPath = 'docs/09-agents/status.json';
+  const statusJson = safeReadJSON(statusJsonPath);
+
+  if (statusJson) {
+    content += `${C.dim}${'─'.repeat(50)}${C.reset}\n`;
+    content +=
+      JSON.stringify(statusJson, null, 2)
+        .split('\n')
+        .map(l => `  ${l}`)
+        .join('\n') + '\n';
+    content += `${C.dim}${'─'.repeat(50)}${C.reset}\n`;
+  } else {
+    content += `${C.dim}No status.json found${C.reset}\n`;
+  }
+
+  // 3. SESSION STATE
+  content += `\n${C.cyan}${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`;
+      if (current.current_story) {
+        content += `Working on: ${C.yellow}${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`;
     }
   } else {
-    console.log(`${C.dim}No active session${C.reset}`);
+    content += `${C.dim}No session-state.json found${C.reset}\n`;
   }
 
-  const last = sessionState.last_session;
-  if (last && last.ended_at) {
-    console.log(`Last session: ${C.dim}${last.ended_at} (${last.duration_minutes || '?'} min)${C.reset}`);
-    if (last.summary) console.log(`  Summary: ${C.dim}${last.summary}${C.reset}`);
+  // 4. DOCS STRUCTURE
+  content += `\n${C.cyan}${C.bold}═══ Documentation ═══${C.reset}\n`;
+  const docsDir = 'docs';
+  const docFolders = safeLs(docsDir).filter(f => {
+    try {
+      return fs.statSync(path.join(docsDir, f)).isDirectory();
+    } catch {
+      return false;
+    }
+  });
+
+  if (docFolders.length > 0) {
+    docFolders.forEach(folder => {
+      const folderPath = path.join(docsDir, folder);
+      const files = safeLs(folderPath);
+      const mdFiles = files.filter(f => f.endsWith('.md'));
+      const jsonFiles = files.filter(f => f.endsWith('.json') || f.endsWith('.jsonl'));
+      const info = [];
+      if (mdFiles.length > 0) info.push(`${mdFiles.length} md`);
+      if (jsonFiles.length > 0) info.push(`${jsonFiles.length} json`);
+      content += `  ${C.dim}${folder}/${C.reset} ${info.length > 0 ? `(${info.join(', ')})` : ''}\n`;
+    });
   }
 
-  // Active command (for context preservation)
-  if (sessionState.active_command) {
-    console.log(`Active command: ${C.cyan}${sessionState.active_command.name}${C.reset}`);
+  // 5. RESEARCH NOTES - List + Full content of most recent
+  content += `\n${C.cyan}${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) {
+    researchFiles.sort().reverse();
+    content += `${C.dim}───${C.reset} Available Research Notes\n`;
+    researchFiles.forEach(file => (content += `  ${C.dim}${file}${C.reset}\n`));
+
+    const mostRecentFile = researchFiles[0];
+    const mostRecentPath = path.join(researchDir, mostRecentFile);
+    const mostRecentContent = safeRead(mostRecentPath);
+
+    if (mostRecentContent) {
+      content += `\n${C.green}📄 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`;
+    }
+  } else {
+    content += `${C.dim}No research notes${C.reset}\n`;
   }
-} else {
-  console.log(`${C.dim}No session-state.json found${C.reset}`);
-}
 
-// 4. DOCS STRUCTURE
-section('Documentation');
-const docsDir = 'docs';
-const docFolders = safeLs(docsDir).filter(f => {
-  try {
-    return fs.statSync(path.join(docsDir, f)).isDirectory();
-  } catch {
-    return false;
+  // 6. BUS MESSAGES
+  content += `\n${C.cyan}${C.bold}═══ Recent Agent Messages ═══${C.reset}\n`;
+  const busPath = 'docs/09-agents/bus/log.jsonl';
+  const busContent = safeRead(busPath);
+  if (busContent) {
+    const lines = busContent.trim().split('\n').filter(Boolean);
+    const recent = lines.slice(-5);
+    if (recent.length > 0) {
+      recent.forEach(line => {
+        try {
+          const msg = JSON.parse(line);
+          const time = msg.timestamp ? new Date(msg.timestamp).toLocaleTimeString() : '?';
+          content += `  ${C.dim}[${time}]${C.reset} ${msg.from || '?'}: ${msg.type || msg.message || '?'}\n`;
+        } catch {
+          content += `  ${C.dim}${line.substring(0, 80)}...${C.reset}\n`;
+        }
+      });
+    } else {
+      content += `${C.dim}No messages${C.reset}\n`;
+    }
+  } else {
+    content += `${C.dim}No bus log found${C.reset}\n`;
   }
-});
 
-if (docFolders.length > 0) {
-  docFolders.forEach(folder => {
-    const folderPath = path.join(docsDir, folder);
-    const files = safeLs(folderPath);
-    const mdFiles = files.filter(f => f.endsWith('.md'));
-    const jsonFiles = files.filter(f => f.endsWith('.json') || f.endsWith('.jsonl'));
+  // 7. KEY FILES - Full content
+  content += `\n${C.cyan}${C.bold}═══ Key Context Files (Full Content) ═══${C.reset}\n`;
 
-    let info = [];
-    if (mdFiles.length > 0) info.push(`${mdFiles.length} md`);
-    if (jsonFiles.length > 0) info.push(`${jsonFiles.length} json`);
+  const keyFilesToRead = [
+    { path: 'CLAUDE.md', label: 'CLAUDE.md (Project Instructions)' },
+    { path: 'README.md', label: 'README.md (Project Overview)' },
+    { path: 'docs/04-architecture/README.md', label: 'Architecture Index' },
+    { path: 'docs/02-practices/README.md', label: 'Practices Index' },
+    { path: 'docs/08-project/roadmap.md', label: 'Roadmap' },
+  ];
 
-    console.log(`  ${C.dim}${folder}/${C.reset} ${info.length > 0 ? `(${info.join(', ')})` : ''}`);
+  keyFilesToRead.forEach(({ path: filePath, label }) => {
+    const fileContent = safeRead(filePath);
+    if (fileContent) {
+      content += `\n${C.green}✓ ${label}${C.reset} ${C.dim}(${filePath})${C.reset}\n`;
+      content += `${C.dim}${'─'.repeat(60)}${C.reset}\n`;
+      content += fileContent + '\n';
+      content += `${C.dim}${'─'.repeat(60)}${C.reset}\n`;
+    } else {
+      content += `${C.dim}○ ${label} (not found)${C.reset}\n`;
+    }
   });
-}
 
-// 5. RESEARCH NOTES
-section('Research Notes');
-const researchDir = 'docs/10-research';
-const researchFiles = safeLs(researchDir).filter(f => f.endsWith('.md') && f !== 'README.md');
-if (researchFiles.length > 0) {
-  // Sort by date (filename starts with YYYYMMDD)
-  researchFiles.sort().reverse();
-  researchFiles.slice(0, 5).forEach(file => {
-    console.log(`  ${C.dim}${file}${C.reset}`);
-  });
-  if (researchFiles.length > 5) {
-    console.log(`  ${C.dim}... and ${researchFiles.length - 5} more${C.reset}`);
-  }
-} else {
-  console.log(`${C.dim}No research notes${C.reset}`);
-}
+  const settingsExists = fs.existsSync('.claude/settings.json');
+  content += `\n  ${settingsExists ? `${C.green}✓${C.reset}` : `${C.dim}○${C.reset}`} .claude/settings.json\n`;
 
-// 6. BUS MESSAGES (last 5)
-section('Recent Agent Messages');
-const busPath = 'docs/09-agents/bus/log.jsonl';
-const busContent = safeRead(busPath);
-if (busContent) {
-  const lines = busContent.trim().split('\n').filter(Boolean);
-  const recent = lines.slice(-5);
-  if (recent.length > 0) {
-    recent.forEach(line => {
-      try {
-        const msg = JSON.parse(line);
-        const time = msg.timestamp ? new Date(msg.timestamp).toLocaleTimeString() : '?';
-        console.log(`  ${C.dim}[${time}]${C.reset} ${msg.from || '?'}: ${msg.type || msg.message || '?'}`);
-      } catch {
-        console.log(`  ${C.dim}${line.substring(0, 80)}...${C.reset}`);
-      }
-    });
+  // 8. EPICS FOLDER
+  content += `\n${C.cyan}${C.bold}═══ Epic Files ═══${C.reset}\n`;
+  const epicFiles = safeLs('docs/05-epics').filter(f => f.endsWith('.md') && f !== 'README.md');
+  if (epicFiles.length > 0) {
+    epicFiles.forEach(file => (content += `  ${C.dim}${file}${C.reset}\n`));
   } else {
-    console.log(`${C.dim}No messages${C.reset}`);
+    content += `${C.dim}No epic files${C.reset}\n`;
   }
-} else {
-  console.log(`${C.dim}No bus log found${C.reset}`);
+
+  // FOOTER
+  content += `\n${C.dim}─────────────────────────────────────────${C.reset}\n`;
+  content += `${C.dim}Context gathered in single execution. Claude has full context.${C.reset}\n`;
+
+  return content;
 }
 
-// 7. KEY FILES PRESENCE
-section('Key Files');
-const keyFiles = [
-  { path: 'CLAUDE.md', label: 'CLAUDE.md (project instructions)' },
-  { path: 'README.md', label: 'README.md (project overview)' },
-  { path: 'docs/08-project/roadmap.md', label: 'Roadmap' },
-  { path: 'docs/02-practices/README.md', label: 'Practices index' },
-  { path: '.claude/settings.json', label: 'Claude settings' },
-];
-
-keyFiles.forEach(({ path: filePath, label }) => {
-  const exists = fs.existsSync(filePath);
-  const icon = exists ? `${C.green}✓${C.reset}` : `${C.dim}○${C.reset}`;
-  console.log(`  ${icon} ${label}`);
-});
-
-// 8. EPICS FOLDER
-section('Epic Files');
-const epicFiles = safeLs('docs/05-epics').filter(f => f.endsWith('.md') && f !== 'README.md');
-if (epicFiles.length > 0) {
-  epicFiles.forEach(file => {
-    console.log(`  ${C.dim}${file}${C.reset}`);
-  });
+// ============================================
+// MAIN: Output with smart summary positioning
+// ============================================
+
+const summary = generateSummary();
+const fullContent = generateFullContent();
+
+const summaryLength = summary.length;
+const cutoffPoint = DISPLAY_LIMIT - summaryLength;
+
+if (fullContent.length <= cutoffPoint) {
+  // Full content fits before summary - just output everything
+  console.log(fullContent);
+  console.log(summary);
 } else {
-  console.log(`${C.dim}No epic files${C.reset}`);
-}
+  // Split: content before cutoff + summary + content after cutoff
+  const contentBefore = fullContent.substring(0, cutoffPoint);
+  const contentAfter = fullContent.substring(cutoffPoint);
 
-// FOOTER
-console.log(`\n${C.dim}─────────────────────────────────────────${C.reset}`);
-console.log(`${C.dim}Context gathered in single execution. Ready for task selection.${C.reset}\n`);
+  console.log(contentBefore);
+  console.log(summary);
+  console.log(contentAfter);
+}