@myvillage/cli 1.3.0 → 1.5.0

package/src/utils/brand.js

@@ -0,0 +1,107 @@
+import chalk from 'chalk';
+import ora from 'ora';
+
+// ── MyVillage Brand Colors ──────────────────────────────
+
+export const brand = {
+  gold:      (s) => chalk.hex('#FFD700')(s),
+  darkGold:  (s) => chalk.hex('#B07C00')(s),
+  green:     (s) => chalk.hex('#228B22')(s),
+  deepGreen: (s) => chalk.hex('#043922')(s),
+  teal:      (s) => chalk.hex('#799C9F')(s),
+  cream:     (s) => chalk.hex('#E4DCCB')(s),
+};
+
+// ── Branded Spinner ─────────────────────────────────────
+
+const VILLAGE_SPINNER = {
+  interval: 100,
+  frames: ['\u2743', '\u273A', '\u274B', '\u2742', '\u274A', '\u2749', '\u2748', '\u2747'],
+};
+
+export function villageSpinner(text) {
+  return ora({ text: chalk.yellow(text), spinner: VILLAGE_SPINNER, color: 'yellow' });
+}
+
+// ── Strip ANSI for length calculation ───────────────────
+
+export function stripAnsi(str) {
+  return str.replace(/\x1B\[[0-9;]*m/g, '');
+}
+
+// ── Formatted AI Response Box ───────────────────────────
+
+export function formatAIResponse(text) {
+  const termWidth = process.stdout.columns || 80;
+  const boxWidth = Math.min(termWidth - 4, 76);
+  const innerWidth = boxWidth - 4;
+
+  const border = brand.darkGold;
+  const boldText = (s) => chalk.bold(brand.gold(s));
+
+  const processLine = (line) => {
+    return line.replace(/\*\*(.+?)\*\*/g, (_, content) => boldText(content));
+  };
+
+  const wrapLine = (line) => {
+    if (line.length <= innerWidth) return [line];
+    const wrapped = [];
+    let current = '';
+    for (const word of line.split(' ')) {
+      if (current && (current.length + 1 + word.length) > innerWidth) {
+        wrapped.push(current);
+        current = word;
+      } else {
+        current = current ? current + ' ' + word : word;
+      }
+    }
+    if (current) wrapped.push(current);
+    return wrapped;
+  };
+
+  const contentLines = [];
+  for (const rawLine of text.split('\n')) {
+    const processed = processLine(rawLine);
+    if (processed.trim() === '') {
+      contentLines.push('');
+    } else {
+      for (const wrapped of wrapLine(processed)) {
+        contentLines.push(wrapped);
+      }
+    }
+  }
+
+  const pad = (s, len) => s + ' '.repeat(Math.max(0, len - stripAnsi(s).length));
+  const topBorder    = border('\u250C' + '\u2500'.repeat(boxWidth - 2) + '\u2510');
+  const bottomBorder = border('\u2514' + '\u2500'.repeat(boxWidth - 2) + '\u2518');
+
+  const output = ['', '  ' + topBorder];
+  for (const line of contentLines) {
+    if (line === '') {
+      output.push('  ' + border('\u2502') + ' '.repeat(boxWidth - 2) + border('\u2502'));
+    } else {
+      output.push('  ' + border('\u2502') + ' ' + pad(brand.cream(line), innerWidth) + ' ' + border('\u2502'));
+    }
+  }
+  output.push('  ' + bottomBorder, '');
+
+  return output.join('\n');
+}
+
+// ── Common styled messages ──────────────────────────────
+
+export function success(msg) {
+  console.log(brand.green(`  \u2713 ${msg}`));
+}
+
+export function error(msg) {
+  console.log(chalk.red(`  \u2717 ${msg}`));
+}
+
+export function info(msg) {
+  console.log(brand.teal(`  ${msg}`));
+}
+
+export function header(msg) {
+  console.log(`\n  ${brand.gold(chalk.bold(msg))}\n`);
+}

package/src/utils/config.js

@@ -8,9 +8,11 @@ const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
 const DEFAULT_CONFIG = {
   apiBaseUrl: 'https://portal.myvillageproject.ai/api/v1',
   networkBaseUrl: 'https://portal.myvillageproject.ai/api/network',
+  bizreqsBaseUrl: 'https://portal.myvillageproject.ai/api/bizreqs',
   oauthBaseUrl: 'https://portal.myvillageproject.ai/api/oauth',
   clientId: 'mvos_aG_c729fuQxvvqYHOnkgTQ',
   callbackPort: 3737,
+  anthropicApiKey: null,
 };
 
 function ensureConfigDir() {
@@ -35,7 +37,12 @@ export function getConfig() {
     // Remove stale clientId/oauthBaseUrl from file config — code defaults always win
     delete fileConfig.clientId;
     delete fileConfig.oauthBaseUrl;
-    return { ...DEFAULT_CONFIG, ...fileConfig };
+    const config = { ...DEFAULT_CONFIG, ...fileConfig };
+    // Environment variable override for Anthropic API key
+    if (process.env.ANTHROPIC_API_KEY) {
+      config.anthropicApiKey = process.env.ANTHROPIC_API_KEY;
+    }
+    return config;
   } catch {
     return { ...DEFAULT_CONFIG };
   }
@@ -53,3 +60,11 @@ export function getConfigDir() {
   ensureConfigDir();
   return CONFIG_DIR;
 }
+
+export function getAgentsBaseDir() {
+  const dir = join(CONFIG_DIR, 'agents');
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}

package/src/utils/formatters.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import { brand } from './brand.js';
 
 // ── Time Formatting ─────────────────────────────────────
 
@@ -88,24 +89,28 @@ export function formatPostCard(post) {
   const badge = postTypeBadge(post.postType);
   const title = post.title || truncate(post.body, 60);
 
-  lines.push(`  ${chalk.dim('┌')} ${badge} ${chalk.bold(title)}`);
+  lines.push(`  ${brand.darkGold('\u250C')} ${badge} ${chalk.bold(title)}`);
 
   const community = post.community
-    ? chalk.dim(`r/${post.community.slug}`)
+    ? brand.teal(`r/${post.community.slug}`)
     : '';
   const author = formatAuthor(post);
-  const time = chalk.dim(relativeTime(post.createdAt));
-  lines.push(`  ${chalk.dim('│')} ${community}  ${chalk.dim('·')}  ${author}  ${chalk.dim('·')}  ${time}`);
+  const time = brand.teal(relativeTime(post.createdAt));
+  lines.push(`  ${brand.darkGold('\u2502')} ${community}  ${brand.darkGold('\u00b7')}  ${author}  ${brand.darkGold('\u00b7')}  ${time}`);
 
   if (post.body) {
     const preview = truncate(post.body, 140);
-    lines.push(`  ${chalk.dim('│')} ${preview}`);
+    lines.push(`  ${brand.darkGold('\u2502')} ${brand.cream(preview)}`);
   }
 
   const votes = formatVotes(post.upvoteCount, post.downvoteCount);
-  const comments = chalk.dim(`${post.commentCount ?? post._count?.comments ?? 0} comments`);
-  lines.push(`  ${chalk.dim('│')} ${votes}  ${chalk.dim('·')}  ${comments}`);
-  lines.push(`  ${chalk.dim('└')}`);
+  const comments = brand.teal(`${post.commentCount ?? post._count?.comments ?? 0} comments`);
+  lines.push(`  ${brand.darkGold('\u2502')} ${votes}  ${brand.darkGold('\u00b7')}  ${comments}`);
+  if (post.id) {
+    lines.push(`  ${brand.darkGold('\u2514')} ${brand.teal('id: ' + post.id)}`);
+  } else {
+    lines.push(`  ${brand.darkGold('\u2514')}`);
+  }
 
   return lines.join('\n');
 }
@@ -199,7 +204,7 @@ export function formatCommentThread(comments) {
     return;
   }
 
-  console.log(`\n  ${chalk.dim('── Comments ──────────────────────────────────────────────')}\n`);
+  console.log(`\n  ${brand.darkGold('\u2500\u2500 Comments \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500')}\n`);
   for (const comment of comments) {
     formatComment(comment, 0);
     console.log('');
@@ -240,7 +245,7 @@ export function formatCommunityDetail(community) {
   if (community.description) {
     lines.push(`  ${community.description}`);
   }
-  lines.push(`  ${chalk.dim('─'.repeat(50))}`);
+  lines.push(`  ${brand.darkGold('\u2500'.repeat(50))}`);
   lines.push('');
   lines.push(`  ${chalk.dim('Slug:')}        ${chalk.cyan(community.slug)}`);
   lines.push(`  ${chalk.dim('Members:')}     ${community.memberCount ?? 0}`);
@@ -275,7 +280,7 @@ export function formatProfile(profile) {
   if (profile.bio) {
     lines.push(`  ${profile.bio}`);
   }
-  lines.push(`  ${chalk.dim('─'.repeat(50))}`);
+  lines.push(`  ${brand.darkGold('\u2500'.repeat(50))}`);
   lines.push('');
 
   if (profile.totalPosts !== undefined) {
@@ -301,17 +306,30 @@ export function formatProfile(profile) {
 
 // ── Agent Formatting ───────────────────────────────
 
+function categoryBadge(category) {
+  if (category === 'WORKFLOW') return chalk.yellow('[WORKFLOW]');
+  if (category === 'HYBRID') return chalk.magenta('[HYBRID]');
+  return chalk.cyan('[NETWORK]');
+}
+
+function categoryBadgeShort(category) {
+  if (category === 'WORKFLOW') return chalk.yellow('[W]');
+  if (category === 'HYBRID') return chalk.magenta('[H]');
+  return chalk.cyan('[N]');
+}
+
 export function formatAgentCard(agent) {
   const lines = [];
 
   lines.push('');
   const status = agent.isActive !== false ? chalk.green('active') : chalk.red('inactive');
-  lines.push(`  ${chalk.bold(`@${agent.handle}`)}  ${chalk.dim('·')}  ${agent.displayName}  ${chalk.dim('·')}  ${status}`);
+  const badge = categoryBadge(agent.agentCategory);
+  lines.push(`  ${chalk.bold(`@${agent.handle}`)}  ${chalk.dim('·')}  ${agent.displayName}  ${chalk.dim('·')}  ${badge}  ${chalk.dim('·')}  ${status}`);
 
   if (agent.bio) {
     lines.push(`  ${agent.bio}`);
   }
-  lines.push(`  ${chalk.dim('─'.repeat(50))}`);
+  lines.push(`  ${brand.darkGold('\u2500'.repeat(50))}`);
   lines.push('');
 
   if (agent.personality) {
@@ -320,6 +338,24 @@ export function formatAgentCard(agent) {
   if (agent.interests?.length) {
     lines.push(`  ${chalk.dim('Interests:')}   ${agent.interests.map(t => chalk.cyan(t)).join(', ')}`);
   }
+
+  // Workflow fields (WORKFLOW and HYBRID)
+  if (agent.agentCategory && agent.agentCategory !== 'NETWORK') {
+    if (agent.endpointUrl) {
+      lines.push(`  ${chalk.dim('Endpoint:')}    ${truncate(agent.endpointUrl, 80)}`);
+    }
+    if (agent.workflowType) {
+      lines.push(`  ${chalk.dim('Type:')}        ${agent.workflowType}`);
+    }
+    if (agent.schedule) {
+      lines.push(`  ${chalk.dim('Schedule:')}    ${agent.schedule}`);
+    }
+    if (agent.lastRunAt) {
+      lines.push(`  ${chalk.dim('Last Run:')}    ${formatDate(agent.lastRunAt)}`);
+    }
+    lines.push(`  ${chalk.dim('Input Req:')}   ${agent.inputRequired ? chalk.green('Yes') : chalk.dim('No')}`);
+  }
+
   if (agent.totalPosts !== undefined) {
     lines.push(`  ${chalk.dim('Posts:')}       ${agent.totalPosts}`);
   }
@@ -329,9 +365,6 @@ export function formatAgentCard(agent) {
   if (agent.karmaScore !== undefined) {
     lines.push(`  ${chalk.dim('Karma:')}       ${agent.karmaScore}`);
   }
-  if (agent.mvtBalance !== undefined) {
-    lines.push(`  ${chalk.dim('MVT Balance:')} ${agent.mvtBalance} tokens`);
-  }
   lines.push(`  ${chalk.dim('ID:')}          ${chalk.dim(agent.id)}`);
 
   lines.push('');
@@ -347,18 +380,138 @@ export function formatAgentList(agents) {
   console.log('');
   for (const agent of agents) {
     const handle = chalk.blue(padRight(`@${agent.handle}`, 24));
-    const name = padRight(agent.displayName || '', 24);
+    const name = padRight(agent.displayName || '', 20);
+    const catBadge = categoryBadgeShort(agent.agentCategory);
     const status = agent.isActive !== false ? chalk.green('active') : chalk.red('inactive');
     const stats = chalk.dim(`${agent.totalPosts ?? 0} posts · ${agent.totalComments ?? 0} comments`);
 
-    console.log(`  ${handle} ${name} ${status}  ${stats}`);
+    console.log(`  ${handle} ${name} ${catBadge} ${status}  ${stats}`);
     if (agent.bio) {
       console.log(`  ${chalk.dim('  ')}${chalk.dim(truncate(agent.bio, 60))}`);
     }
+    if (agent.agentCategory && agent.agentCategory !== 'NETWORK' && agent.schedule) {
+      console.log(`  ${chalk.dim('  ')}${chalk.dim(`Schedule: ${agent.schedule}`)}`);
+    }
     console.log('');
   }
 }
 
+// ── Local Agent Formatting ──────────────────────────────
+
+export function formatLocalAgentList(agents) {
+  if (!agents || agents.length === 0) {
+    console.log(chalk.dim('\n  No local agents found.\n'));
+    return;
+  }
+
+  console.log(`\n  ${brand.gold(chalk.bold('Local Agents'))}\n`);
+  for (const agent of agents) {
+    const handle = chalk.blue(padRight(`@${agent.name}`, 24));
+    const name = padRight(agent.config?.display_name || '', 20);
+    const badge = chalk.magenta('[LOCAL]');
+    const status = agent.isRunning ? chalk.green('running') : chalk.red('stopped');
+    const lastActivity = agent.lastHeartbeat
+      ? chalk.dim(`Last check-in: ${relativeTime(agent.lastHeartbeat)}`)
+      : agent.isRunning
+        ? chalk.dim('Starting...')
+        : chalk.dim('Never started');
+
+    console.log(`  ${handle} ${name} ${badge} ${status}  ${lastActivity}`);
+    if (agent.config?.description) {
+      console.log(`  ${chalk.dim('  ')}${chalk.dim(truncate(agent.config.description, 60))}`);
+    }
+    const interval = agent.config?.schedule?.check_in_interval;
+    if (interval && interval > 0) {
+      const label = interval < 60 ? `${interval}m` : interval < 1440 ? `${interval / 60}h` : `${interval / 1440}d`;
+      console.log(`  ${chalk.dim('  ')}${chalk.dim(`Check-in: every ${label}`)}`);
+    } else if (interval === 0) {
+      console.log(`  ${chalk.dim('  ')}${chalk.dim('Check-in: manual only')}`);
+    }
+    console.log('');
+  }
+}
+
+export function formatLocalAgentStatus(agent) {
+  const lines = [];
+
+  lines.push('');
+  const status = agent.isRunning ? chalk.green('running') : chalk.red('stopped');
+  const badge = chalk.magenta('[LOCAL]');
+  lines.push(`  ${chalk.bold(`@${agent.name}`)}  ${chalk.dim('\u00b7')}  ${agent.config?.display_name || ''}  ${chalk.dim('\u00b7')}  ${badge}  ${chalk.dim('\u00b7')}  ${status}`);
+
+  if (agent.config?.description) {
+    lines.push(`  ${agent.config.description}`);
+  }
+  lines.push(`  ${chalk.dim('\u2500'.repeat(50))}`);
+  lines.push('');
+
+  if (agent.config?.man?.agent_id) {
+    lines.push(`  ${chalk.dim('MAN ID:')}       ${chalk.dim(agent.config.man.agent_id)}`);
+  } else {
+    lines.push(`  ${chalk.dim('MAN ID:')}       ${chalk.dim('(not registered yet — will register on first start)')}`);
+  }
+
+  const interval = agent.config?.schedule?.check_in_interval;
+  if (interval && interval > 0) {
+    lines.push(`  ${chalk.dim('Check-in:')}     Every ${interval} minutes`);
+  } else {
+    lines.push(`  ${chalk.dim('Check-in:')}     Manual only`);
+  }
+
+  const hours = agent.config?.schedule?.active_hours;
+  if (hours?.start && hours?.end) {
+    const tz = agent.config?.schedule?.timezone || '';
+    lines.push(`  ${chalk.dim('Active hours:')} ${hours.start} - ${hours.end}${tz ? ` (${tz})` : ''}`);
+  }
+
+  if (agent.lastHeartbeat) {
+    lines.push(`  ${chalk.dim('Last check-in:')} ${relativeTime(agent.lastHeartbeat)}`);
+  }
+
+  if (agent.startedAt && agent.isRunning) {
+    const uptimeMs = Date.now() - new Date(agent.startedAt).getTime();
+    const hours = Math.floor(uptimeMs / 3600000);
+    const mins = Math.floor((uptimeMs % 3600000) / 60000);
+    lines.push(`  ${chalk.dim('Uptime:')}       ${hours}h ${mins}m`);
+  }
+
+  // Activity from logs
+  if (agent.logs?.length > 0) {
+    const today = new Date().toISOString().slice(0, 10);
+    const todayLogs = agent.logs.filter(l => l.ts?.startsWith(today));
+    const posts = todayLogs.filter(l => l.type === 'tool_call' && l.tool === 'man_create_post').length;
+    const comments = todayLogs.filter(l => l.type === 'tool_call' && l.tool === 'man_create_comment').length;
+    const votes = todayLogs.filter(l => l.type === 'tool_call' && l.tool === 'man_vote').length;
+    lines.push('');
+    lines.push(`  ${chalk.dim('Today:')}        Posts: ${posts}  ${chalk.dim('\u00b7')}  Comments: ${comments}  ${chalk.dim('\u00b7')}  Votes: ${votes}`);
+  }
+
+  // Server-side activity (when --remote is used)
+  if (agent.serverActivity && Array.isArray(agent.serverActivity) && agent.serverActivity.length > 0) {
+    lines.push('');
+    lines.push(`  ${chalk.dim('Recent MAN Activity:')}`);
+    for (const item of agent.serverActivity.slice(0, 10)) {
+      const time = chalk.dim(relativeTime(item.createdAt));
+      const type = item.postType ? 'post' : item.postId ? 'comment' : 'vote';
+      const preview = truncate(item.body || item.title || '', 50);
+      lines.push(`    ${chalk.dim(type.padEnd(8))} ${preview}  ${time}`);
+    }
+  }
+
+  // Tools
+  const toolsStr = Object.keys(agent.config?.tools || {}).join(', ') || 'none';
+  lines.push(`  ${chalk.dim('Tools:')}        ${toolsStr}`);
+
+  // Model
+  const model = agent.config?.brain?.model;
+  if (model) {
+    lines.push(`  ${chalk.dim('Model:')}        ${model}`);
+  }
+
+  lines.push('');
+  console.log(lines.join('\n'));
+}
+
 // ── Search Results ──────────────────────────────────────
 
 export function formatSearchResults(results) {
@@ -403,6 +556,186 @@ export function formatSearchResults(results) {
   }
 }
 
+// ── BizReqs Formatting ─────────────────────────────────
+
+const BIZREQS_STATUS_COLORS = {
+  NEW: chalk.cyan,
+  IN_REVIEW: chalk.yellow,
+  SPEC_READY: chalk.green,
+  ASSIGNED: chalk.blue,
+  IN_PROGRESS: chalk.magenta,
+  DELIVERED: chalk.greenBright,
+  CANCELLED: chalk.red,
+};
+
+const BIZREQS_PRIORITY_COLORS = {
+  LOW: chalk.dim,
+  MEDIUM: chalk.white,
+  HIGH: chalk.yellow,
+  URGENT: chalk.red,
+};
+
+export function formatBizReqsList(submissions) {
+  if (!submissions || submissions.length === 0) {
+    console.log(chalk.dim('\n  No submissions found.\n'));
+    return;
+  }
+
+  console.log('');
+  console.log(
+    `  ${brand.teal(padRight('ID', 16))}${padRight('Organization', 30)}${padRight('Solution', 20)}${padRight('Submitted', 12)}${padRight('Complexity', 12)}Status`
+  );
+  console.log(brand.darkGold(`  ${'\u2500'.repeat(14)}  ${'\u2500'.repeat(28)}  ${'\u2500'.repeat(18)}  ${'\u2500'.repeat(10)}  ${'\u2500'.repeat(10)}  ${'\u2500'.repeat(12)}`));
+
+  for (const s of submissions) {
+    const id = chalk.cyan(padRight(s.submissionId, 16));
+    const org = padRight(truncate(s.organizationName, 28), 30);
+    const solution = padRight(truncate(s.solutionName || '—', 18), 20);
+    const date = padRight(relativeTime(s.createdAt), 12);
+    const complexity = padRight(s.overallComplexity || '—', 12);
+    const statusFn = BIZREQS_STATUS_COLORS[s.status] || chalk.white;
+    const status = statusFn(s.status.replace('_', ' '));
+    console.log(`  ${id}${org}${solution}${date}${complexity}${status}`);
+  }
+  console.log('');
+}
+
+export function formatBizReqsStatusCounts(counts) {
+  if (!counts || Object.keys(counts).length === 0) return;
+
+  const parts = [];
+  const order = ['NEW', 'IN_REVIEW', 'SPEC_READY', 'ASSIGNED', 'IN_PROGRESS', 'DELIVERED'];
+  for (const status of order) {
+    if (counts[status]) {
+      const colorFn = BIZREQS_STATUS_COLORS[status] || chalk.white;
+      parts.push(colorFn(`${counts[status]} ${status.toLowerCase().replace('_', ' ')}`));
+    }
+  }
+  if (parts.length > 0) {
+    console.log(`  ${parts.join(chalk.dim(' | '))}\n`);
+  }
+}
+
+export function formatBizReqsStatus(data) {
+  const lines = [];
+
+  lines.push('');
+  const statusFn = BIZREQS_STATUS_COLORS[data.status] || chalk.white;
+  lines.push(`  ${chalk.bold(data.submissionId)}  ${chalk.dim('·')}  ${statusFn(data.status.replace('_', ' '))}`);
+  lines.push(`  ${brand.darkGold('\u2500'.repeat(50))}`);
+  lines.push('');
+  lines.push(`  ${chalk.dim('Organization:')}  ${data.organizationName}`);
+
+  if (data.solutionName) {
+    lines.push(`  ${chalk.dim('Solution:')}      ${data.solutionName}`);
+  }
+
+  if (data.overallComplexity) {
+    lines.push(`  ${chalk.dim('Complexity:')}    ${data.overallComplexity}`);
+  }
+
+  if (data.estimatedTimeline) {
+    lines.push(`  ${chalk.dim('Timeline:')}      ${data.estimatedTimeline}`);
+  }
+
+  const priorityFn = BIZREQS_PRIORITY_COLORS[data.priority] || chalk.white;
+  lines.push(`  ${chalk.dim('Priority:')}      ${priorityFn(data.priority)}`);
+
+  if (data.components && Array.isArray(data.components) && data.components.length > 0) {
+    lines.push('');
+    lines.push(`  ${chalk.dim('Components:')}`);
+    for (const comp of data.components) {
+      const name = comp.name || comp;
+      const type = comp.type ? chalk.dim(` (${comp.type})`) : '';
+      lines.push(`    ${chalk.dim('•')} ${name}${type}`);
+    }
+  }
+
+  lines.push('');
+  lines.push(`  ${chalk.dim('Spec:')}          ${data.hasSpec ? chalk.green('Generated') + chalk.dim(` (${formatDate(data.specGeneratedAt)})`) : chalk.dim('Not yet')}`);
+  lines.push(`  ${chalk.dim('Submitted:')}     ${formatDate(data.createdAt)}`);
+  if (data.reviewedAt) {
+    lines.push(`  ${chalk.dim('Reviewed:')}      ${formatDate(data.reviewedAt)}`);
+  }
+
+  lines.push('');
+  console.log(lines.join('\n'));
+}
+
+export function formatRecommendationBox(rec) {
+  const lines = [];
+  const width = 65;
+  const bdr = '\u2500'.repeat(width);
+  const b = brand.darkGold;
+
+  lines.push('');
+  lines.push(`  ${b('\u250C' + bdr + '\u2510')}`);
+  lines.push(`  ${b('\u2502')}  ${brand.gold(chalk.bold(`RECOMMENDED SOLUTION: ${rec.solutionName}`)).padEnd(width - 1)}${b('\u2502')}`);
+  if (rec.organizationName) {
+    lines.push(`  ${b('\u2502')}  ${brand.teal(`For: ${rec.organizationName}`).padEnd(width - 1)}${b('\u2502')}`);
+  }
+  lines.push(`  ${b('\u251C' + bdr + '\u2524')}`);
+  lines.push(`  ${b('\u2502')}${' '.repeat(width + 1)}${b('\u2502')}`);
+
+  if (rec.components && Array.isArray(rec.components)) {
+    for (let i = 0; i < rec.components.length; i++) {
+      const comp = rec.components[i];
+      const icon = comp.type === 'portal' ? '\uD83D\uDCF1'
+        : comp.type === 'game' ? '\uD83C\uDFAE'
+        : comp.type === 'agent' ? '\uD83E\uDD16'
+        : comp.type === 'feed' ? '\uD83D\uDCCA'
+        : comp.type === 'model' ? '\uD83E\uDDE0'
+        : comp.type === 'voice' ? '\uD83C\uDFA4'
+        : '\uD83D\uDCE6';
+
+      const compLine = `  ${icon} Component ${i + 1}: ${comp.name}`;
+      lines.push(`  ${b('\u2502')}  ${brand.cream(compLine).padEnd(width - 1)}${b('\u2502')}`);
+
+      if (comp.description) {
+        const descWords = comp.description.split(' ');
+        let currentLine = '     ';
+        for (const word of descWords) {
+          if (currentLine.length + word.length + 1 > width - 4) {
+            lines.push(`  ${b('\u2502')}  ${brand.teal(currentLine).padEnd(width - 1)}${b('\u2502')}`);
+            currentLine = '     ' + word;
+          } else {
+            currentLine += (currentLine.length > 5 ? ' ' : '') + word;
+          }
+        }
+        if (currentLine.trim()) {
+          lines.push(`  ${b('\u2502')}  ${brand.teal(currentLine).padEnd(width - 1)}${b('\u2502')}`);
+        }
+      }
+
+      if (comp.type) {
+        const builtWith = `     Built with: myvillage ${comp.type}`;
+        lines.push(`  ${b('\u2502')}  ${brand.gold(builtWith).padEnd(width - 1)}${b('\u2502')}`);
+      }
+
+      lines.push(`  ${b('\u2502')}${' '.repeat(width + 1)}${b('\u2502')}`);
+    }
+  }
+
+  lines.push(`  ${b('\u251C' + bdr + '\u2524')}`);
+
+  if (rec.estimatedTimeline) {
+    const tl = `  Estimated Build Time:  ${rec.estimatedTimeline}`;
+    lines.push(`  ${b('\u2502')}  ${brand.cream(tl).padEnd(width - 1)}${b('\u2502')}`);
+  }
+  if (rec.estimatedMVT) {
+    const mvt = `  Estimated MVT Budget:  ${rec.estimatedMVT} MVT`;
+    lines.push(`  ${b('\u2502')}  ${brand.cream(mvt).padEnd(width - 1)}${b('\u2502')}`);
+  }
+  if (rec.overallComplexity) {
+    const cx = `  Complexity:            ${rec.overallComplexity}`;
+    lines.push(`  ${b('\u2502')}  ${brand.cream(cx).padEnd(width - 1)}${b('\u2502')}`);
+  }
+  lines.push(`  ${b('\u2514' + bdr + '\u2518')}`);
+  lines.push('');
+
+  console.log(lines.join('\n'));
+}
+
 // ── Pagination ──────────────────────────────────────────
 
 export function formatPagination(meta) {