@myvillage/cli 1.5.0 → 1.6.0

package/src/commands/story.js

@@ -0,0 +1,68 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { isAuthenticated } from '../utils/auth.js';
+import { brand } from '../utils/brand.js';
+import { createPost } from '../utils/api.js';
+import { resolveVillageContext } from '../utils/village-resolver.js';
+
+export async function storyCommand(options) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red("  \u2717 Authentication required. Run 'myvillage login' first."));
+    return;
+  }
+
+  const ctx = await resolveVillageContext();
+  if (!ctx) return;
+
+  // Guided prompts
+  const answers = await inquirer.prompt([
+    {
+      type: 'editor',
+      name: 'story',
+      message: 'What story, memory, or piece of wisdom would you like to share?',
+      validate: (v) => v.trim().length > 0 || 'Please share something.',
+    },
+    {
+      type: 'input',
+      name: 'source',
+      message: 'Who is this from? (you, a family elder, a community member)',
+      default: 'me',
+    },
+    {
+      type: 'input',
+      name: 'connection',
+      message: 'Is this connected to something the village is building? (optional)',
+    },
+  ]);
+
+  // Build tags
+  const tags = ['knowledge-contribution'];
+  const sourceName = answers.source.trim();
+  if (sourceName && sourceName.toLowerCase() !== 'me') {
+    tags.push(`source:${sourceName}`);
+  }
+  if (answers.connection?.trim()) {
+    tags.push(`theme:${answers.connection.trim()}`);
+  }
+
+  // Format body with attribution
+  let body = answers.story.trim();
+  if (sourceName && sourceName.toLowerCase() !== 'me') {
+    body = `"${body}"\n\n\u2014 ${sourceName}`;
+  }
+
+  try {
+    await createPost({
+      communitySlug: ctx.community.slug,
+      postType: 'DISCUSSION',
+      title: 'Knowledge Contribution',
+      body,
+      tags,
+    });
+
+    console.log(brand.green(`  \u2713 Story shared with ${ctx.village.name}`));
+  } catch (err) {
+    const msg = err.response?.data?.error || err.message;
+    console.log(chalk.red(`  \u2717 Failed to share story: ${msg}`));
+  }
+}

package/src/index.js

@@ -53,6 +53,22 @@ import {
   bizreqsStatusCommand,
   bizreqsImportCommand,
 } from './commands/bizreqs.js';
+import { checkinCommand } from './commands/checkin.js';
+import { discoverCommand } from './commands/discover.js';
+import { logCommand } from './commands/log.js';
+import { storyCommand } from './commands/story.js';
+import {
+  soulprintInitCommand,
+  soulprintIngestCommand,
+  soulprintDatasetListCommand,
+  soulprintDatasetPullCommand,
+  soulprintTrainCommand,
+  soulprintJobsCommand,
+  soulprintJobDetailCommand,
+  soulprintPushCommand,
+  soulprintPublishCommand,
+  soulprintModelsCommand,
+} from './commands/soulprint.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -73,6 +89,7 @@ export function run() {
   program
     .command('login')
     .description('Authenticate with MyVillageOS')
+    .option('--no-browser', 'Manual login for headless environments (servers, SSH, etc.)')
     .action(loginCommand);
 
   program
@@ -308,6 +325,30 @@ export function run() {
     .description('Remove an MCP server tool from a local agent')
     .action(agentRemoveToolCommand);
 
+  // ── Village Content Pipeline ───────────────────────────
+
+  program
+    .command('checkin')
+    .description('Check in with your village and share updates')
+    .option('--skip-discover', 'Skip the auto-discover step')
+    .action(checkinCommand);
+
+  program
+    .command('discover')
+    .description('Find connections between villages')
+    .action(discoverCommand);
+
+  program
+    .command('log [text]')
+    .description('Quick build log entry')
+    .option('-t, --track <track>', 'Build track (game, portal, agent, data, robot, general)')
+    .action(logCommand);
+
+  program
+    .command('story')
+    .description('Share a story or wisdom with the network')
+    .action(storyCommand);
+
   // ── BizReqs: Business Requirements Pipeline ───────────
 
   const bizreqsCmd = program
@@ -357,5 +398,105 @@ export function run() {
     .option('--contact <name>', 'Contact name')
     .action(bizreqsImportCommand);
 
+  // ── SoulPrint Studio: Model Training Pipeline ───────────
+
+  const soulprintCmd = program
+    .command('soulprint')
+    .description('SoulPrint Studio \u2014 datasets, training, and model publishing');
+
+  soulprintCmd
+    .command('init')
+    .description('Initialize local training workspace')
+    .option('--skip-python', 'Skip Python venv setup')
+    .option('--skip-scripts', 'Skip training script download')
+    .action(soulprintInitCommand);
+
+  soulprintCmd
+    .command('ingest <path>')
+    .description('Ingest training data into a dataset')
+    .requiredOption('--dataset <slug>', 'Target dataset slug')
+    .requiredOption('--type <type>', 'Data type: text, image, audio, structured, multimodal')
+    .option('--source <source>', 'Ingestion source label', 'CLI')
+    .option('--captions <path>', 'Path to captions file (image/multimodal)')
+    .option('--transcriptions <path>', 'Path to transcriptions file (audio)')
+    .option('--schema <path>', 'Path to schema JSON file (structured)')
+    .option('--recursive', 'Recurse into subdirectories')
+    .option('--glob <pattern>', 'File glob pattern to filter')
+    .option('--split <split>', 'Assign all items to a split: train, validation, test')
+    .option('--dry-run', 'Show what would be ingested without uploading')
+    .option('--concurrency <n>', 'Parallel upload limit', '5')
+    .action(soulprintIngestCommand);
+
+  const soulprintDatasetCmd = soulprintCmd
+    .command('datasets')
+    .description('Manage training datasets');
+
+  soulprintDatasetCmd
+    .command('list')
+    .description('List available datasets on SoulPrint Studio')
+    .option('--type <type>', 'Filter by type: text, image, audio, structured, multimodal')
+    .option('--status <status>', 'Filter by status: collecting, ready, training, archived')
+    .option('--json', 'Output raw JSON')
+    .action(soulprintDatasetListCommand);
+
+  soulprintDatasetCmd
+    .command('pull <slug>')
+    .description('Download a dataset to your local machine')
+    .option('--version <number>', 'Specific version (default: latest frozen)')
+    .option('--split <split>', 'Download only a specific split: train, validation, test')
+    .option('--force', 'Re-download even if already present locally')
+    .action(soulprintDatasetPullCommand);
+
+  soulprintCmd
+    .command('train')
+    .description('Run model training locally')
+    .requiredOption('--type <type>', 'Training type: text, image, audio, structured, multimodal')
+    .requiredOption('--dataset <slug>', 'Dataset slug to train on')
+    .option('--version <number>', 'Dataset version (default: latest)')
+    .option('--base <model>', 'Base model identifier')
+    .option('--method <method>', 'Training method')
+    .option('--config <path>', 'Path to training config YAML file')
+    .option('--name <name>', 'Name for the resulting model')
+    .option('--dry-run', 'Validate config and dataset without starting training')
+    .action(soulprintTrainCommand);
+
+  soulprintCmd
+    .command('jobs [jobId]')
+    .description('View training job status')
+    .option('--status <status>', 'Filter by status')
+    .option('--json', 'Output raw JSON')
+    .action((jobId, options) => {
+      if (jobId) return soulprintJobDetailCommand(jobId, options);
+      return soulprintJobsCommand(options);
+    });
+
+  soulprintCmd
+    .command('models')
+    .description('List models in the registry')
+    .option('--status <status>', 'Filter: draft, validated, published, rejected')
+    .option('--type <type>', 'Filter: text, image, audio, structured, multimodal')
+    .option('--json', 'Output raw JSON')
+    .action(soulprintModelsCommand);
+
+  soulprintCmd
+    .command('push <path>')
+    .description('Upload locally trained model artifacts to SoulPrint Studio')
+    .requiredOption('--name <name>', 'Model name')
+    .requiredOption('--type <type>', 'Model type: text, image, audio, structured, multimodal')
+    .option('--base <model>', 'Base model it was trained from')
+    .option('--method <method>', 'Training method used')
+    .option('--job <jobId>', 'Link to an existing training job')
+    .option('--description <text>', 'Model description')
+    .action(soulprintPushCommand);
+
+  soulprintCmd
+    .command('publish <modelSlug>')
+    .description('Publish a validated model to the MyVillage platform')
+    .option('--villager <id>', 'Target villager ID to own the model')
+    .option('--villages <ids>', 'Comma-separated village IDs to associate')
+    .option('--tier <tier>', 'Model tier: FREE, BASIC, PRO, ENTERPRISE', 'FREE')
+    .option('--public', 'Make the model publicly available')
+    .action(soulprintPublishCommand);
+
   program.parse();
 }

package/src/utils/agent-scaffolder.js

@@ -5,9 +5,9 @@ import { stringify as stringifyYaml } from 'yaml';
 // ── MCP Tool Catalog ────────────────────────────────────
 
 const TOOL_CATALOG = {
-  'man-feed': {
-    command: 'internal',
-    description: 'MAN feed access (post, read, react)',
+  myvillage: {
+    url: 'https://mcp.myvillageproject.ai',
+    description: 'MyVillageOS platform access (feed, posts, communities, wallet, knowledge)',
     always_enabled: true,
   },
   filesystem: {
@@ -151,11 +151,11 @@ ${description}
 function generateToolsYaml(selectedTools) {
   const servers = {};
 
-  // man-feed is always included
-  servers['man-feed'] = TOOL_CATALOG['man-feed'];
+  // myvillage is always included
+  servers['myvillage'] = TOOL_CATALOG['myvillage'];
 
   for (const toolId of selectedTools) {
-    if (toolId === 'man-feed') continue;
+    if (toolId === 'myvillage') continue;
     if (TOOL_CATALOG[toolId]) {
       servers[toolId] = { ...TOOL_CATALOG[toolId] };
     }

package/src/utils/ai.js

@@ -0,0 +1,30 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { getConfig } from './config.js';
+import { brand } from './brand.js';
+
+export async function getAnthropicProvider() {
+  const { createAnthropic } = await import('@ai-sdk/anthropic');
+  const config = getConfig();
+  let apiKey = config.anthropicApiKey || process.env.ANTHROPIC_API_KEY;
+
+  if (!apiKey) {
+    console.log(chalk.yellow('\n  Anthropic API key required for AI features.'));
+    console.log(brand.teal('  Get yours at: https://console.anthropic.com\n'));
+
+    const { key } = await inquirer.prompt([{
+      type: 'password',
+      name: 'key',
+      message: 'Anthropic API key:',
+      mask: '*',
+      validate: (input) => input.trim().length > 0 || 'API key is required',
+    }]);
+
+    apiKey = key.trim();
+    const { setConfig } = await import('./config.js');
+    setConfig({ anthropicApiKey: apiKey });
+    console.log(brand.green('  \u2713 API key saved to ~/.myvillage/config.json\n'));
+  }
+
+  return createAnthropic({ apiKey });
+}

package/src/utils/api.js

@@ -7,7 +7,7 @@ const require = createRequire(import.meta.url);
 const { version } = require('../../package.json');
 const USER_AGENT = `MyVillageOS-CLI/${version}`;
 
-function createClient(baseURL) {
+export function createClient(baseURL) {
   const client = axios.create({
     baseURL,
     headers: {
@@ -379,6 +379,37 @@ export async function registerOAuthClient(name, appType, redirectUris) {
   return response.data;
 }
 
+// ── Platform API Client (/api) ──────────────────────────
+
+export function getPlatformClient() {
+  const config = getConfig();
+  return createClient(config.platformBaseUrl);
+}
+
+export async function getVillagerVillages(villagerUuid) {
+  const client = getPlatformClient();
+  const response = await client.get(`/villagers/${villagerUuid}/villages`);
+  return response.data;
+}
+
+export async function getVillagerByVillagerId(villagerId) {
+  const client = getPlatformClient();
+  const response = await client.get(`/villagers/by-villager-id/${villagerId}`);
+  return response.data;
+}
+
+export async function getVillageCommunities(villageUuid) {
+  const client = getNetworkClient();
+  const response = await client.get('/communities', { params: { villageId: villageUuid } });
+  return response.data;
+}
+
+export async function listPostsByFilters(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/posts', { params });
+  return response.data;
+}
+
 // ── BizReqs API Client (/api/bizreqs) ───────────────────
 
 export function getBizReqsClient() {

package/src/utils/config.js

@@ -10,6 +10,8 @@ const DEFAULT_CONFIG = {
   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',
   clientId: 'mvos_aG_c729fuQxvvqYHOnkgTQ',
   callbackPort: 3737,
   anthropicApiKey: null,

package/src/utils/formatters.js

@@ -743,3 +743,88 @@ export function formatPagination(meta) {
     console.log(chalk.dim(`  ── More results available. Run with --cursor=${meta.nextCursor} to see next page\n`));
   }
 }
+
+// ── MAN Content Pipeline ────────────────────────────────
+
+export function formatCheckinSummary(post, meta) {
+  const b = (s) => chalk.hex('#B07C00')(s);
+  const width = 56;
+  const bdr = '\u2500'.repeat(width);
+
+  const lines = [''];
+  lines.push(`  ${b('\u250C' + bdr + '\u2510')}`);
+  lines.push(`  ${b('\u2502')}  ${brand.gold('\u2743 Village Check-in')}${' '.repeat(width - 19)}${b('\u2502')}`);
+  lines.push(`  ${b('\u2502' + '\u2500'.repeat(width) + '\u2502')}`);
+
+  if (meta.villageName) {
+    const vl = `  Village:  ${meta.villageName}`;
+    lines.push(`  ${b('\u2502')}${brand.cream(vl).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (meta.buildTrack) {
+    const tl = `  Track:    ${meta.buildTrack}`;
+    lines.push(`  ${b('\u2502')}${brand.teal(tl).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (meta.themes?.length) {
+    const th = `  Themes:   ${meta.themes.join(', ')}`;
+    lines.push(`  ${b('\u2502')}${chalk.white(th).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (meta.needs?.length) {
+    const nd = `  Needs:    ${meta.needs.join(', ')}`;
+    lines.push(`  ${b('\u2502')}${chalk.yellow(nd).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (meta.offers?.length) {
+    const of_ = `  Offers:   ${meta.offers.join(', ')}`;
+    lines.push(`  ${b('\u2502')}${brand.green(of_).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (post?.data?.id) {
+    const id = `  Post ID:  ${post.data.id.slice(0, 8)}...`;
+    lines.push(`  ${b('\u2502')}${chalk.dim(id).padEnd(width + 12)}${b('\u2502')}`);
+  }
+
+  lines.push(`  ${b('\u2514' + bdr + '\u2518')}`);
+  lines.push('');
+
+  console.log(lines.join('\n'));
+}
+
+export function formatConnection(connection) {
+  const b = (s) => chalk.hex('#B07C00')(s);
+  const width = 56;
+  const bdr = '\u2500'.repeat(width);
+
+  const lines = [''];
+  lines.push(`  ${b('\u250C' + bdr + '\u2510')}`);
+  lines.push(`  ${b('\u2502')}  ${brand.gold('\u21C4 Connection Found')}${' '.repeat(width - 20)}${b('\u2502')}`);
+  lines.push(`  ${b('\u2502' + '\u2500'.repeat(width) + '\u2502')}`);
+
+  if (connection.villageName) {
+    const vl = `  Village:    ${connection.villageName}`;
+    lines.push(`  ${b('\u2502')}${brand.cream(vl).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (connection.topic) {
+    const tp = `  Topic:      ${connection.topic}`;
+    lines.push(`  ${b('\u2502')}${chalk.white(tp).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (connection.matchType) {
+    const mt = `  Match:      ${connection.matchType}`;
+    lines.push(`  ${b('\u2502')}${brand.teal(mt).padEnd(width + 12)}${b('\u2502')}`);
+  }
+  if (connection.score !== undefined) {
+    const sc = `  Relevance:  ${'\u2605'.repeat(Math.min(connection.score, 5))}${'\u2606'.repeat(Math.max(0, 5 - connection.score))}`;
+    lines.push(`  ${b('\u2502')}${brand.gold(sc).padEnd(width + 12)}${b('\u2502')}`);
+  }
+
+  lines.push(`  ${b('\u2514' + bdr + '\u2518')}`);
+  lines.push('');
+
+  console.log(lines.join('\n'));
+}
+
+export function formatBuildLog(post) {
+  const tags = post.tags || [];
+  const track = tags.find((t) => t.startsWith('track:'))?.replace('track:', '') || 'general';
+  const body = post.body?.length > 60 ? post.body.slice(0, 57) + '...' : post.body || '';
+  const time = relativeTime(post.createdAt);
+
+  console.log(`  ${brand.teal(`[${track}]`)} ${chalk.white(body)}  ${chalk.dim(time)}`);
+}

package/src/utils/man-hooks.js

@@ -0,0 +1,16 @@
+import chalk from 'chalk';
+
+/**
+ * Trigger a MAN post from an automated event (deploy, publish, etc.).
+ * Stub implementation — future commands will call this to auto-generate MAN posts.
+ *
+ * @param {object} params
+ * @param {string} params.trigger - What triggered this (e.g., 'deploy', 'publish')
+ * @param {string} params.artifactId - ID of the artifact (game ID, model ID, etc.)
+ * @param {string} params.summary - Human-readable summary of what happened
+ * @param {string} params.villageId - Village UUID
+ * @param {string} params.communitySlug - Target community slug
+ */
+export async function triggerMANPost({ trigger, artifactId, summary, villageId, communitySlug }) {
+  console.log(chalk.dim(`  [MAN hook] ${trigger}: ${summary} (not yet wired — future feature)`));
+}

package/src/utils/soulprint-api.js

@@ -0,0 +1,136 @@
+import { createClient } from './api.js';
+import { getConfig } from './config.js';
+
+// ── Client Factory ─────────────────────────────────────
+
+export function getSoulprintClient() {
+  const config = getConfig();
+  return createClient(config.soulprintBaseUrl);
+}
+
+// ── Datasets ───────────────────────────────────────────
+
+export async function listDatasets(params = {}) {
+  const client = getSoulprintClient();
+  const response = await client.get('/datasets', { params });
+  return response.data;
+}
+
+export async function getDataset(slug) {
+  const client = getSoulprintClient();
+  const response = await client.get(`/datasets/${slug}`);
+  return response.data;
+}
+
+export async function getDatasetDownload(slug, version) {
+  const client = getSoulprintClient();
+  const params = version ? { version } : {};
+  const response = await client.get(`/datasets/${slug}/download`, { params });
+  return response.data;
+}
+
+// ── Training Jobs ──────────────────────────────────────
+
+export async function createJob(data) {
+  const client = getSoulprintClient();
+  const response = await client.post('/jobs', data);
+  return response.data;
+}
+
+export async function listJobs(params = {}) {
+  const client = getSoulprintClient();
+  const response = await client.get('/jobs', { params });
+  return response.data;
+}
+
+export async function getJob(id) {
+  const client = getSoulprintClient();
+  const response = await client.get(`/jobs/${id}`);
+  return response.data;
+}
+
+export async function updateJobStatus(id, data) {
+  const client = getSoulprintClient();
+  const response = await client.patch(`/jobs/${id}/status`, data);
+  return response.data;
+}
+
+export async function completeJob(id, data) {
+  const client = getSoulprintClient();
+  const response = await client.post(`/jobs/${id}/complete`, data);
+  return response.data;
+}
+
+export async function failJob(id, data) {
+  const client = getSoulprintClient();
+  const response = await client.post(`/jobs/${id}/fail`, data);
+  return response.data;
+}
+
+// ── Models ─────────────────────────────────────────────
+
+export async function listModels(params = {}) {
+  const client = getSoulprintClient();
+  const response = await client.get('/models', { params });
+  return response.data;
+}
+
+export async function getModel(slug) {
+  const client = getSoulprintClient();
+  const response = await client.get(`/models/${slug}`);
+  return response.data;
+}
+
+export async function publishModel(slug, data) {
+  const client = getSoulprintClient();
+  const response = await client.post(`/models/${slug}/publish`, data);
+  return response.data;
+}
+
+// ── Ingestion ──────────────────────────────────────────
+
+export async function ingestText(data) {
+  const client = getSoulprintClient();
+  const response = await client.post('/ingest/text', data);
+  return response.data;
+}
+
+export async function ingestStructured(data) {
+  const client = getSoulprintClient();
+  const response = await client.post('/ingest/structured', data);
+  return response.data;
+}
+
+export async function prepareIngestion(data) {
+  const client = getSoulprintClient();
+  const response = await client.post('/ingest/prepare', data);
+  return response.data;
+}
+
+export async function completeIngestion(ingestionId, data) {
+  const client = getSoulprintClient();
+  const response = await client.post(`/ingest/${ingestionId}/complete`, data);
+  return response.data;
+}
+
+export async function abortIngestion(ingestionId) {
+  const client = getSoulprintClient();
+  const response = await client.post(`/ingest/${ingestionId}/abort`);
+  return response.data;
+}
+
+// ── Upload ─────────────────────────────────────────────
+
+export async function getUploadUrls(data) {
+  const client = getSoulprintClient();
+  const response = await client.post('/upload/presign', data);
+  return response.data;
+}
+
+// ── Scripts ────────────────────────────────────────────
+
+export async function getScriptsManifest() {
+  const client = getSoulprintClient();
+  const response = await client.get('/scripts/manifest');
+  return response.data;
+}