@myvillage/cli 1.28.1 → 1.30.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myvillage/cli",
-  "version": "1.28.1",
+  "version": "1.30.0",
   "description": "MyVillageOS CLI for community developers",
   "type": "module",
   "bin": {

package/src/commands/agent-local.js

@@ -13,6 +13,7 @@ import {
   agentJoinCommunity as apiAgentJoinCommunity,
   listCommunities,
   getAgentActivity,
+  listMyAgents,
   listMyUnlinkedAgentProfiles,
   createVillageAgent as apiCreateVillageAgent,
   listAgentTasks,
@@ -122,6 +123,7 @@ export async function agentCreateLocalCommand() {
           { name: 'Gmail', value: 'gmail' },
           { name: 'Calendar', value: 'calendar' },
           { name: 'GitHub', value: 'github' },
+          { name: 'Browser (Puppeteer — downloads Chromium on first run)', value: 'browser' },
         ],
       },
       {
@@ -230,6 +232,26 @@ export async function agentStartCommand(name) {
   }
 
   if (!agentExists(name)) {
+    // Check whether the agent exists server-side under this handle. If so,
+    // this is a "different machine" situation \u2014 point them at `agent pull`
+    // rather than the misleading "not found" dead-end.
+    let remoteMatch = null;
+    try {
+      remoteMatch = await fetchMyAgentByHandle(name);
+    } catch {
+      // network error \u2014 fall through to the generic message below
+    }
+
+    if (remoteMatch) {
+      console.log(chalk.yellow(
+        `  Agent "${name}" exists on the server but isn't set up on this machine yet.`,
+      ));
+      console.log(chalk.yellow(
+        `  Run ${brand.gold(`myvillage agent pull ${name}`)} to scaffold it locally, then start it.\n`,
+      ));
+      return;
+    }
+
     console.log(chalk.red(`  \u2717 Agent "${name}" not found. Run 'myvillage agent' to see your agents.\n`));
     return;
   }
@@ -1108,3 +1130,111 @@ export async function agentRememberCommand(name, text, options = {}) {
     console.log(chalk.red(`  ✗ Remember failed: ${msg}\n`));
   }
 }
+
+// ── Pull Agent ─────────────────────────────────────────
+//
+// Rehydrate a local agent directory on a new machine from the server's
+// AgentProfile + VillageAgent records. Use case: you created `teacher_mvp`
+// on your laptop, now you want to run it on your desktop. The server
+// already has the agent — this command scaffolds the missing local config
+// (~/.myvillage/agents/<handle>/) so `agent start` can launch the daemon.
+//
+// What pulls down: the network identity (id, handle, displayName) and a
+// link to the existing VillageAgent task queue.
+// What doesn't: custom prompt edits, tools.yaml customizations, and any
+// API keys. Those stay machine-local and you'll need to redo them if you
+// want an exact replica. The scaffold defaults are a reasonable starting
+// point that will boot.
+
+async function fetchMyAgentByHandle(handle) {
+  const result = await listMyAgents({ includeVillageAgent: true });
+  const agents = result.data || result;
+  if (!Array.isArray(agents)) return null;
+  return agents.find(a => a.handle === handle) || null;
+}
+
+export async function agentPullCommand(handle, options = {}) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  // The local agent dir is keyed off the handle (= server-side AgentProfile.handle).
+  const agentName = handle;
+  const force = options.force === true;
+
+  if (agentExists(agentName) && !force) {
+    console.log(chalk.yellow(
+      `  Agent "${agentName}" already exists locally at ~/.myvillage/agents/${agentName}/`,
+    ));
+    console.log(chalk.yellow('  Use --force to overwrite, or just `myvillage agent start ' + agentName + '` to run it.\n'));
+    return;
+  }
+
+  const spinner = villageSpinner(`Pulling ${handle} from the network...`).start();
+
+  let profile;
+  try {
+    profile = await fetchMyAgentByHandle(handle);
+  } catch (err) {
+    spinner.fail(`Failed to look up agent: ${err.response?.data?.error || err.message}`);
+    return;
+  }
+
+  if (!profile) {
+    spinner.fail(`No agent with handle "${handle}" is owned by your account.`);
+    console.log(chalk.yellow(
+      '  Run `myvillage agent` to see the agents on your account, then pull one by its handle.\n',
+    ));
+    return;
+  }
+
+  // Default scaffold: just the always-on MyVillage MCP tool. Users can add
+  // more via `agent add-tool` once they're up.
+  const agentDir = getAgentDir(agentName);
+  try {
+    scaffoldAgent(agentDir, {
+      name: agentName,
+      displayName: profile.displayName || agentName,
+      description: profile.bio || `Pulled from the network on ${new Date().toISOString().split('T')[0]}.`,
+      tools: ['myvillage'],
+      checkInInterval: 'hourly',
+      provider: 'anthropic',
+      model: 'claude-sonnet-4-5-20250929',
+    });
+  } catch (err) {
+    spinner.fail(`Failed to scaffold local agent: ${err.message}`);
+    return;
+  }
+
+  // Prefill man.agent_id and man.village_agent_id so `start` skips the
+  // create-on-first-boot step and links straight to the existing server rows.
+  const cfg = readAgentConfig(agentName);
+  cfg.man = cfg.man || {};
+  cfg.man.agent_id = profile.id;
+  cfg.man.handle = profile.handle;
+  if (profile.villageAgent?.id) {
+    cfg.man.village_agent_id = profile.villageAgent.id;
+  }
+  writeAgentConfig(agentName, cfg);
+
+  spinner.succeed(`Pulled ${handle} to ~/.myvillage/agents/${agentName}/`);
+
+  console.log('');
+  console.log(brand.teal('  What pulled down:'));
+  console.log(`    - Network identity: @${profile.handle} (${profile.displayName})`);
+  if (profile.villageAgent?.id) {
+    console.log(`    - VillageAgent task queue: ${profile.villageAgent.id}`);
+  } else {
+    console.log(`    - ${chalk.yellow('No VillageAgent shim found — one will be created on first start.')}`);
+  }
+  console.log('');
+  console.log(brand.teal('  Defaults that may need tweaking:'));
+  console.log(`    - ${brand.gold('prompt.md')} (system prompt — generic template)`);
+  console.log(`    - ${brand.gold('tools.yaml')} (only the MyVillage tool is enabled)`);
+  console.log(`    - ${brand.gold('agent.config.yaml')} (anthropic + claude-sonnet by default)`);
+  console.log('');
+  console.log(brand.teal('  Next:'));
+  console.log(`    ${brand.gold(`myvillage agent edit ${agentName}`)}    Customize prompt / tools`);
+  console.log(`    ${brand.gold(`myvillage agent start ${agentName}`)}   Launch the daemon\n`);
+}

package/src/index.js

@@ -55,6 +55,7 @@ import {
   agentStopCommand,
   agentStatusCommand,
   agentLogsCommand,
+  agentPullCommand,
   agentAddToolCommand,
   agentRemoveToolCommand,
   agentTaskListCommand,
@@ -78,13 +79,6 @@ import {
   agentDeactivateClientCommand,
   agentRotateClientKeyCommand,
 } from './commands/agent-client.js';
-import {
-  bizreqsNewCommand,
-  bizreqsSpecCommand,
-  bizreqsListCommand,
-  bizreqsStatusCommand,
-  bizreqsImportCommand,
-} from './commands/bizreqs.js';
 import {
   gameUpdateCommand,
   gameUploadThumbnailCommand,
@@ -447,6 +441,12 @@ export function run() {
     .description('Start a local agent daemon')
     .action(agentStartCommand);
 
+  agentCmd
+    .command('pull <handle>')
+    .description('Rehydrate a local agent dir on a new machine from the server')
+    .option('--force', 'Overwrite an existing local agent dir')
+    .action(agentPullCommand);
+
   agentCmd
     .command('stop <name>')
     .description('Stop a local agent daemon')
@@ -645,55 +645,6 @@ export function run() {
     .description('Show status of a reel draft')
     .action(mediaDraftStatusCommand);
 
-  // ── BizReqs: Business Requirements Pipeline ───────────
-
-  const bizreqsCmd = program
-    .command('bizreqs')
-    .description('Business requirements intake and project pipeline');
-
-  bizreqsCmd
-    .command('new')
-    .description('Start a new AI-guided business intake session')
-    .option('--org <name>', 'Organization name')
-    .option('--contact <name>', 'Contact name')
-    .option('--from-file <path>', 'Path to a text file with initial context')
-    .option('--from-url <url>', 'URL to the organization\'s website')
-    .option('--quick', 'Shortened flow (skip dream state, fewer exchanges)')
-    .action(bizreqsNewCommand);
-
-  bizreqsCmd
-    .command('spec <id>')
-    .description('Generate full project specification from an intake')
-    .option('--detail <level>', 'Detail level: brief, standard, comprehensive', 'standard')
-    .option('--output <dir>', 'Output directory for spec file', './specs')
-    .action(bizreqsSpecCommand);
-
-  bizreqsCmd
-    .command('list')
-    .description('List pipeline submissions')
-    .option('--status <status>', 'Filter: new, in-review, spec-ready, assigned, in-progress, delivered')
-    .option('--city <city>', 'Filter by city')
-    .option('--search <query>', 'Search by org name, solution, or ID')
-    .option('--sort <sort>', 'Sort: newest, oldest, priority', 'newest')
-    .option('-n, --limit <number>', 'Number of results', '50')
-    .option('--offset <number>', 'Pagination offset', '0')
-    .option('--json', 'Output raw JSON')
-    .action(bizreqsListCommand);
-
-  bizreqsCmd
-    .command('status <id>')
-    .description('Check project status')
-    .action(bizreqsStatusCommand);
-
-  bizreqsCmd
-    .command('import')
-    .description('Import requirements from a file or URL')
-    .option('--file <path>', 'Path to .txt or .md file')
-    .option('--url <url>', 'URL to fetch content from')
-    .option('--org <name>', 'Organization name')
-    .option('--contact <name>', 'Contact name')
-    .action(bizreqsImportCommand);
-
   // ── SoulPrint Studio: Model Training Pipeline ───────────
 
   // \u2500\u2500 Wisdom: agent skill packs (Books of Wisdom) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500

package/src/utils/agent-scaffolder.js

@@ -38,9 +38,11 @@ const TOOL_CATALOG = {
     env: { GITHUB_TOKEN: '${GITHUB_TOKEN}' },
     description: 'GitHub repository access',
   },
-  // browser: removed in v1.27.0 — the previously catalog'd
-  // `@anthropic/mcp-puppeteer` package is no longer published under that
-  // name. Add a working browser MCP back when one stabilizes.
+  browser: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-puppeteer'],
+    description: 'Navigate web pages, extract content (downloads Chromium on first run)',
+  },
 };
 
 export { TOOL_CATALOG };

package/src/utils/api.js

@@ -456,55 +456,6 @@ export async function rotateClientAgentKey(configId) {
   return response.data;
 }
 
-// ── BizReqs API Client (/api/bizreqs) ───────────────────
-
-export function getBizReqsClient() {
-  const config = getConfig();
-  return createClient(config.bizreqsBaseUrl);
-}
-
-export async function createBizReqsSubmission(data) {
-  const client = getBizReqsClient();
-  const response = await client.post('/', data);
-  return response.data;
-}
-
-export async function listBizReqsSubmissions(params = {}) {
-  const client = getBizReqsClient();
-  const response = await client.get('/', { params });
-  return response.data;
-}
-
-export async function getBizReqsSubmission(id) {
-  const client = getBizReqsClient();
-  const response = await client.get(`/${encodeURIComponent(id)}`);
-  return response.data;
-}
-
-export async function updateBizReqsSubmission(id, data) {
-  const client = getBizReqsClient();
-  const response = await client.patch(`/${encodeURIComponent(id)}`, data);
-  return response.data;
-}
-
-export async function getBizReqsStatus(id) {
-  const client = getBizReqsClient();
-  const response = await client.get(`/${encodeURIComponent(id)}/status`);
-  return response.data;
-}
-
-export async function saveBizReqsSpec(id, data) {
-  const client = getBizReqsClient();
-  const response = await client.post(`/${encodeURIComponent(id)}/spec`, data);
-  return response.data;
-}
-
-export async function getBizReqsSpec(id) {
-  const client = getBizReqsClient();
-  const response = await client.get(`/${encodeURIComponent(id)}/spec`);
-  return response.data;
-}
-
 // ── Media Drafts API (/api/media/drafts) ────────────────
 
 export async function createMediaDraft(data) {

package/src/utils/config.js

@@ -8,7 +8,6 @@ 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',
   soulprintBaseUrl: 'https://soulprint-studio.myvillageproject.ai/api',
   platformBaseUrl: 'https://portal.myvillageproject.ai/api',

package/src/utils/formatters.js

@@ -630,186 +630,6 @@ 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) {