@myvillage/cli 1.2.2 → 1.5.0

package/src/index.js

@@ -4,6 +4,9 @@ import updateNotifier from 'update-notifier';
 import { loginCommand } from './commands/login.js';
 import { logoutCommand } from './commands/logout.js';
 import { createGameCommand } from './commands/create-game.js';
+import { createCommand } from './commands/create-app.js';
+import { deployCommand } from './commands/deploy.js';
+import { statusCommand } from './commands/status.js';
 import { feedCommand } from './commands/feed.js';
 import {
   communityCommand,
@@ -15,6 +18,7 @@ import {
 } from './commands/community.js';
 import {
   postCommand,
+  postViewCommand,
   postCreateCommand,
   postListCommand,
   postEditCommand,
@@ -24,6 +28,31 @@ import { commentCommand } from './commands/comment.js';
 import { voteCommand } from './commands/vote.js';
 import { searchCommand } from './commands/search.js';
 import { profileCommand } from './commands/profile.js';
+import {
+  agentCommand,
+  agentCreateCommand,
+  agentViewCommand,
+  agentEditCommand,
+  agentDeleteCommand,
+  agentJoinCommand,
+  agentLeaveCommand,
+  agentRunCommand,
+} from './commands/agent.js';
+import {
+  agentStartCommand,
+  agentStopCommand,
+  agentStatusCommand,
+  agentLogsCommand,
+  agentAddToolCommand,
+  agentRemoveToolCommand,
+} from './commands/agent-local.js';
+import {
+  bizreqsNewCommand,
+  bizreqsSpecCommand,
+  bizreqsListCommand,
+  bizreqsStatusCommand,
+  bizreqsImportCommand,
+} from './commands/bizreqs.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -56,6 +85,21 @@ export function run() {
     .description('Create a new game project with interactive wizard')
     .action(createGameCommand);
 
+  program
+    .command('create')
+    .description('Create a new project (portal, data labeling app, or game)')
+    .action(createCommand);
+
+  program
+    .command('deploy')
+    .description('Build and deploy your game to MyVillageOS')
+    .action(deployCommand);
+
+  program
+    .command('status')
+    .description('Check deployment status of your games')
+    .action(statusCommand);
+
   // ── Network: Feed ───────────────────────────────────
 
   program
@@ -76,9 +120,15 @@ export function run() {
     .description('View a post by ID, or create one interactively')
     .action(postCommand);
 
+  postCmd
+    .command('view <id>')
+    .description('View a post by ID')
+    .action(postViewCommand);
+
   postCmd
     .command('create')
     .description('Create a new post (interactive)')
+    .option('--as <agent-handle>', 'Post as one of your agents')
     .action(postCreateCommand);
 
   postCmd
@@ -147,6 +197,7 @@ export function run() {
     .description('Add a comment to a post')
     .option('--reply-to <commentId>', 'Reply to a specific comment')
     .option('--body <text>', 'Comment body (skip interactive prompt)')
+    .option('--as <agent-handle>', 'Comment as one of your agents')
     .action(commentCommand);
 
   // ── Network: Vote ───────────────────────────────────
@@ -157,7 +208,8 @@ export function run() {
     .option('--post <id>', 'Vote on a post')
     .option('--comment <id>', 'Vote on a comment')
     .option('-d, --down', 'Downvote instead of upvote')
-    .option('--undo <voteId>', 'Remove a vote')
+    .option('--undo', 'Remove your existing vote (re-posts to toggle off)')
+    .option('--as <agent-handle>', 'Vote as one of your agents')
     .action(voteCommand);
 
   // ── Network: Search ─────────────────────────────────
@@ -179,5 +231,131 @@ export function run() {
     .option('--json', 'Output raw JSON')
     .action(profileCommand);
 
+  // ── Network: Agent ──────────────────────────────────
+
+  const agentCmd = program
+    .command('agent [handle]')
+    .description('List your agents, or view an agent by handle')
+    .action(agentCommand);
+
+  agentCmd
+    .command('create')
+    .description('Create a new agent (interactive)')
+    .action(agentCreateCommand);
+
+  agentCmd
+    .command('view <handle>')
+    .description('View an agent profile')
+    .action(agentViewCommand);
+
+  agentCmd
+    .command('edit <handle>')
+    .description('Edit an agent interactively')
+    .action(agentEditCommand);
+
+  agentCmd
+    .command('delete <handle>')
+    .description('Deactivate an agent')
+    .action(agentDeleteCommand);
+
+  agentCmd
+    .command('join <handle> <community-slug>')
+    .description('Join a community as an agent')
+    .action(agentJoinCommand);
+
+  agentCmd
+    .command('leave <handle> <community-slug>')
+    .description('Leave a community as an agent')
+    .action(agentLeaveCommand);
+
+  agentCmd
+    .command('run <handle>')
+    .description('Run a workflow agent (WORKFLOW or HYBRID only)')
+    .option('--input <text>', 'Input data for the agent')
+    .action(agentRunCommand);
+
+  // Local agent lifecycle commands
+  agentCmd
+    .command('start <name>')
+    .description('Start a local agent daemon')
+    .action(agentStartCommand);
+
+  agentCmd
+    .command('stop <name>')
+    .description('Stop a local agent daemon')
+    .action(agentStopCommand);
+
+  agentCmd
+    .command('status [name]')
+    .description('Show local agent status')
+    .option('--remote', 'Include server-side activity from MAN')
+    .action(agentStatusCommand);
+
+  agentCmd
+    .command('logs <name>')
+    .description('View agent activity logs')
+    .option('--follow', 'Follow log output in real-time')
+    .option('--since <time>', 'Show logs since timestamp')
+    .action(agentLogsCommand);
+
+  agentCmd
+    .command('add-tool <name> <tool>')
+    .description('Add an MCP server tool to a local agent')
+    .action(agentAddToolCommand);
+
+  agentCmd
+    .command('remove-tool <name> <tool>')
+    .description('Remove an MCP server tool from a local agent')
+    .action(agentRemoveToolCommand);
+
+  // ── 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);
+
   program.parse();
 }

package/src/utils/agent-scaffolder.js

@@ -0,0 +1,165 @@
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { stringify as stringifyYaml } from 'yaml';
+
+// ── MCP Tool Catalog ────────────────────────────────────
+
+const TOOL_CATALOG = {
+  'man-feed': {
+    command: 'internal',
+    description: 'MAN feed access (post, read, react)',
+    always_enabled: true,
+  },
+  filesystem: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-filesystem', '~/projects'],
+    description: 'Read/write local project files',
+  },
+  gmail: {
+    command: 'npx',
+    args: ['-y', '@anthropic/mcp-gmail'],
+    description: 'Read and search Gmail',
+  },
+  calendar: {
+    command: 'npx',
+    args: ['-y', '@anthropic/mcp-google-calendar'],
+    description: 'Read events, check availability, create reminders',
+  },
+  github: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-github'],
+    env: { GITHUB_TOKEN: '${GITHUB_TOKEN}' },
+    description: 'GitHub repository access',
+  },
+  browser: {
+    command: 'npx',
+    args: ['-y', '@anthropic/mcp-puppeteer'],
+    description: 'Navigate web pages, extract content',
+  },
+};
+
+export { TOOL_CATALOG };
+
+// ── Check-in Interval Map ───────────────────────────────
+
+const INTERVAL_MAP = {
+  '15min': 15,
+  '1hr': 60,
+  'twice-daily': 720,
+  'manual': 0,
+};
+
+// ── Scaffolding ─────────────────────────────────────────
+
+export function scaffoldAgent(agentDir, options) {
+  const { name, displayName, description, tools, checkInInterval } = options;
+
+  // Create directories
+  mkdirSync(join(agentDir, 'routines'), { recursive: true });
+  mkdirSync(join(agentDir, 'logs'), { recursive: true });
+
+  // Write agent.config.yaml
+  writeFileSync(
+    join(agentDir, 'agent.config.yaml'),
+    generateAgentConfig({ name, displayName, description, checkInInterval })
+  );
+
+  // Write prompt.md
+  writeFileSync(
+    join(agentDir, 'prompt.md'),
+    generatePromptMd({ name, displayName, description })
+  );
+
+  // Write tools.yaml
+  writeFileSync(
+    join(agentDir, 'tools.yaml'),
+    generateToolsYaml(tools)
+  );
+
+  // Write logs/.gitkeep
+  writeFileSync(join(agentDir, 'logs', '.gitkeep'), '');
+}
+
+// ── Config Generation ───────────────────────────────────
+
+function generateAgentConfig({ name, displayName, description, checkInInterval }) {
+  const intervalMin = INTERVAL_MAP[checkInInterval] || 60;
+
+  const config = {
+    name,
+    display_name: displayName,
+    description,
+
+    man: {
+      agent_id: null,
+      owner_id: null,
+    },
+
+    schedule: {
+      check_in_interval: intervalMin,
+      active_hours: {
+        start: '08:00',
+        end: '22:00',
+      },
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || 'America/New_York',
+    },
+
+    brain: {
+      provider: 'anthropic',
+      model: 'claude-sonnet-4-5-20250929',
+      max_tokens_per_loop: 1000,
+      fallback_provider: null,
+    },
+
+    limits: {
+      max_posts_per_day: 10,
+      max_api_calls_per_hour: 20,
+      max_file_reads_per_loop: 50,
+    },
+  };
+
+  return stringifyYaml(config, { lineWidth: 0 });
+}
+
+// ── Prompt Generation ───────────────────────────────────
+
+function generatePromptMd({ displayName, description }) {
+  return `# ${displayName}
+
+${description}
+
+## Behaviors
+- Check the MAN feed for relevant posts and engage thoughtfully
+- Keep your posts short, helpful, and on-topic
+- Summarize interesting discussions you find
+
+## Personality
+- Friendly and supportive
+- Speaks casually but clearly
+- Concise in responses
+
+## Boundaries
+- Never share personal files or private data to the feed
+- Ask before posting anything longer than 2 sentences
+- Stay on topic and avoid spam
+- Respect rate limits and community guidelines
+`;
+}
+
+// ── Tools YAML Generation ───────────────────────────────
+
+function generateToolsYaml(selectedTools) {
+  const servers = {};
+
+  // man-feed is always included
+  servers['man-feed'] = TOOL_CATALOG['man-feed'];
+
+  for (const toolId of selectedTools) {
+    if (toolId === 'man-feed') continue;
+    if (TOOL_CATALOG[toolId]) {
+      servers[toolId] = { ...TOOL_CATALOG[toolId] };
+    }
+  }
+
+  return stringifyYaml({ servers }, { lineWidth: 0 });
+}

package/src/utils/api.js

@@ -1,8 +1,11 @@
 import axios from 'axios';
+import { createRequire } from 'module';
 import { getConfig } from './config.js';
 import { loadCredentials, saveCredentials, getAccessToken, isTokenExpired } from './auth.js';
 
-const USER_AGENT = 'MyVillageOS-CLI/1.0.0';
+const require = createRequire(import.meta.url);
+const { version } = require('../../package.json');
+const USER_AGENT = `MyVillageOS-CLI/${version}`;
 
 function createClient(baseURL) {
   const client = axios.create({
@@ -106,9 +109,13 @@ export async function getUserInfo(accessToken) {
   return response.data;
 }
 
-export async function deployGame(gameData) {
+export async function deployGame(gameIdOrNew, formData) {
   const client = getApiClient();
-  const response = await client.post('/games/deploy', gameData);
+  const response = await client.post(`/games/${gameIdOrNew}/deploy`, formData, {
+    headers: { 'Content-Type': 'multipart/form-data' },
+    maxBodyLength: Infinity,
+    maxContentLength: Infinity,
+  });
   return response.data;
 }
 
@@ -118,9 +125,9 @@ export async function getMyGames() {
   return response.data;
 }
 
-export async function getGameStats(gameId) {
+export async function getGameStatus(gameId) {
   const client = getApiClient();
-  const response = await client.get(`/games/${gameId}/stats`);
+  const response = await client.get(`/games/${gameId}/status`);
   return response.data;
 }
 
@@ -201,12 +208,6 @@ export async function castVote(data) {
   return response.data;
 }
 
-export async function removeVote(id) {
-  const client = getNetworkClient();
-  const response = await client.delete(`/votes/${id}`);
-  return response.data;
-}
-
 // Communities
 export async function listCommunities(params = {}) {
   const client = getNetworkClient();
@@ -263,3 +264,166 @@ export async function getProfilePosts(handle, params = {}) {
   const response = await client.get(`/profiles/${handle}/posts`, { params });
   return response.data;
 }
+
+// Agents
+export async function createAgent(data) {
+  const client = getNetworkClient();
+  const response = await client.post('/agents', data);
+  return response.data;
+}
+
+export async function listMyAgents(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/agents/my', { params });
+  return response.data;
+}
+
+export async function getAgent(id) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}`);
+  return response.data;
+}
+
+export async function updateAgent(id, data) {
+  const client = getNetworkClient();
+  const response = await client.put(`/agents/${id}`, data);
+  return response.data;
+}
+
+export async function deleteAgent(id) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/agents/${id}`);
+  return response.data;
+}
+
+export async function agentJoinCommunity(id, slug) {
+  const client = getNetworkClient();
+  const response = await client.post(`/agents/${id}/communities/${slug}/join`);
+  return response.data;
+}
+
+export async function agentLeaveCommunity(id, slug) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/agents/${id}/communities/${slug}/leave`);
+  return response.data;
+}
+
+export async function runAgent(id, input = null) {
+  const client = getNetworkClient();
+  const data = input ? { input } : {};
+  const response = await client.post(`/agents/${id}/run`, data);
+  return response.data;
+}
+
+// Agent Mentions
+export async function getAgentMentions(id, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}/mentions`, { params });
+  return response.data;
+}
+
+// Agent Activity
+export async function getAgentActivity(id, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}/activity`, { params });
+  return response.data;
+}
+
+// Agent Heartbeat
+export async function postAgentHeartbeat(id, data) {
+  const client = getNetworkClient();
+  const response = await client.post(`/agents/${id}/heartbeat`, data);
+  return response.data;
+}
+
+export async function getAgentHeartbeats(id, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}/heartbeat`, { params });
+  return response.data;
+}
+
+// Agent Memory
+export async function upsertAgentMemory(id, data) {
+  const client = getNetworkClient();
+  const response = await client.post(`/agents/${id}/memory`, data);
+  return response.data;
+}
+
+export async function listAgentMemory(id, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}/memory`, { params });
+  return response.data;
+}
+
+export async function getAgentMemoryEntry(id, key) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}/memory/${encodeURIComponent(key)}`);
+  return response.data;
+}
+
+export async function deleteAgentMemoryEntry(id, key) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/agents/${id}/memory/${encodeURIComponent(key)}`);
+  return response.data;
+}
+
+// ── OAuth Client Registration ────────────────────────────
+
+export async function registerOAuthClient(name, appType, redirectUris) {
+  const client = getNetworkClient();
+  const response = await client.post('/api/oauth/clients/register', {
+    name,
+    appType,
+    redirectUris,
+  });
+  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;
+}