@myvillage/cli 1.6.2 → 1.7.0

package/package.json

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

package/src/commands/create-app.js

@@ -7,6 +7,7 @@ import inquirer from 'inquirer';
 import { isAuthenticated } from '../utils/auth.js';
 import { createGameCommand } from './create-game.js';
 import { createPortalProject, createDataLabelingProject } from '../utils/app-templates.js';
+import { createAgenticAppProject } from '../utils/agentic-templates.js';
 import { registerOAuthClient } from '../utils/api.js';
 
 export async function createCommand() {
@@ -22,8 +23,7 @@ export async function createCommand() {
       name: 'projectType',
       message: 'What would you like to build?',
       choices: [
-        { name: 'Portal \u2014 Customizable multi-page web app', value: 'portal' },
-        { name: 'Data Labeling App \u2014 Multi-modal annotation workspace', value: 'data-labeling' },
+        { name: 'Application \u2014 Web app with optional AI agent, MCP, and API access', value: 'application' },
         { name: 'Game \u2014 Three.js educational game', value: 'game' },
       ],
     },
@@ -34,38 +34,51 @@ export async function createCommand() {
     return;
   }
 
-  if (projectType === 'portal') {
-    await portalFlow();
-    return;
-  }
-
-  if (projectType === 'data-labeling') {
-    await dataLabelingFlow();
+  if (projectType === 'application') {
+    await applicationFlow();
     return;
   }
 }
 
-async function portalFlow() {
-  const answers = await inquirer.prompt([
+async function applicationFlow() {
+  const basics = await inquirer.prompt([
     {
       type: 'input',
       name: 'name',
-      message: 'Portal name:',
-      default: 'My Portal',
+      message: 'Application name:',
+      default: 'My App',
       validate: input => input.trim() ? true : 'Name is required.',
     },
     {
       type: 'input',
       name: 'description',
       message: 'Description:',
-      default: 'A portal built with React and Vite',
+      default: 'A web application built with MyVillageOS',
     },
+  ]);
+
+  // Auth strategy
+  const { authStrategy } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'authStrategy',
+      message: 'How should users authenticate?',
+      choices: [
+        { name: 'MyVillageOS OAuth \u2014 "Login with MyVillageOS" (recommended)', value: 'oauth' },
+        { name: 'Email / Password \u2014 Local credentials', value: 'email-password' },
+        { name: 'Both \u2014 OAuth + local fallback', value: 'both' },
+        { name: 'No login needed \u2014 Public / anonymous', value: 'none' },
+      ],
+    },
+  ]);
+
+  // UI features
+  const { features } = await inquirer.prompt([
     {
       type: 'checkbox',
       name: 'features',
-      message: 'Select features:',
+      message: 'Select UI features:',
       choices: [
-        { name: 'Authentication (MyVillageOS OAuth) \u2014 recommended', value: 'auth', checked: true },
         { name: 'Dashboard with widgets', value: 'dashboard', checked: true },
         { name: 'Settings page', value: 'settings', checked: true },
         { name: 'User management', value: 'users', checked: false },
@@ -74,115 +87,46 @@ async function portalFlow() {
     },
   ]);
 
-  // Create project directory
-  const slug = answers.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
-  const targetDir = resolve(process.cwd(), slug);
-
-  if (existsSync(targetDir)) {
-    console.log(chalk.red(`\n  \u2717 Directory "${slug}" already exists. Choose a different name or remove the existing directory.`));
-    return;
-  }
-
-  // OAuth registration (if auth selected)
-  let oauthCredentials = null;
-  if (answers.features.includes('auth')) {
-    const oauthSpinner = villageSpinner('Registering OAuth application...').start();
-    try {
-      const result = await registerOAuthClient(
-        answers.name,
-        'portal',
-        ['http://localhost:5173/callback']
-      );
-      oauthCredentials = { clientId: result.clientId, clientSecret: result.clientSecret };
-      oauthSpinner.succeed('OAuth application registered!');
-      console.log(brand.teal(`  Client ID: ${result.clientId}`));
-    } catch (err) {
-      oauthSpinner.fail('Failed to register OAuth application.');
-      console.log(chalk.red(`  ${err.response?.data?.error || err.message}`));
-      const { continueWithoutAuth } = await inquirer.prompt([{
-        type: 'confirm',
-        name: 'continueWithoutAuth',
-        message: 'Continue without authentication?',
-        default: true,
-      }]);
-      if (!continueWithoutAuth) return;
-      answers.features = answers.features.filter(f => f !== 'auth');
-    }
-  }
-
-  // Scaffold project
-  const spinner = villageSpinner('Creating portal project...').start();
-  try {
-    createPortalProject(targetDir, {
-      name: answers.name,
-      description: answers.description,
-      features: answers.features,
-      oauthCredentials,
-    });
-
-    spinner.text = 'Installing dependencies...';
-    execSync('npm install', { cwd: targetDir, stdio: 'pipe' });
-    spinner.succeed(`Portal "${answers.name}" created successfully!`);
-
-    console.log();
-    console.log(brand.green(`  \u2713 Portal "${answers.name}" created successfully!`));
-    console.log();
-    console.log(brand.teal('  Next steps:'));
-    console.log();
-    console.log(`    ${brand.gold('cd')} ${slug}`);
-    console.log(`    ${brand.gold('npm run dev')}      ${brand.teal('- Start development server')}`);
-    console.log(`    ${brand.gold('npm run build')}    ${brand.teal('- Build for production')}`);
-    console.log();
-    if (answers.features.length > 0) {
-      console.log(brand.teal(`  Features: ${answers.features.join(', ')}`));
-    }
-    if (oauthCredentials) {
-      console.log(brand.teal(`  OAuth Client ID: ${oauthCredentials.clientId}`));
-    }
-    console.log();
-  } catch (err) {
-    spinner.fail('Failed to create portal project.');
-    console.error(chalk.red(`  ${err.message}`));
-  }
-}
-
-async function dataLabelingFlow() {
-  const answers = await inquirer.prompt([
-    {
-      type: 'input',
-      name: 'name',
-      message: 'App name:',
-      default: 'My Data Labeler',
-      validate: input => input.trim() ? true : 'Name is required.',
-    },
-    {
-      type: 'input',
-      name: 'description',
-      message: 'Description:',
-      default: 'A data labeling workspace built with React and Vite',
-    },
+  // Backend integration
+  const { integrations } = await inquirer.prompt([
     {
       type: 'checkbox',
-      name: 'dataTypes',
-      message: 'Select data types to support:',
+      name: 'integrations',
+      message: 'What MyVillageOS capabilities does your app need?',
       choices: [
-        { name: 'Image \u2014 bounding boxes, polygons, classification', value: 'image', checked: true },
-        { name: 'Text \u2014 NER, classification', value: 'text', checked: true },
-        { name: 'Audio \u2014 segment labeling, transcription', value: 'audio', checked: false },
-        { name: 'Video \u2014 frame-by-frame annotation', value: 'video', checked: false },
+        { name: 'MCP Server \u2014 AI agent access to villages, posts, events, etc.', value: 'mcp', checked: false },
+        { name: 'REST API \u2014 Direct HTTP calls to MyVillageOS endpoints', value: 'rest-api', checked: false },
       ],
-      validate: input => input.length > 0 ? true : 'Select at least one data type.',
-    },
-    {
-      type: 'confirm',
-      name: 'includeAuth',
-      message: 'Include MyVillageOS OAuth authentication? (recommended)',
-      default: true,
     },
   ]);
 
+  const includeMcp = integrations.includes('mcp');
+  const includeRestApi = integrations.includes('rest-api');
+
+  // MCP tool group selection
+  let mcpToolGroups = [];
+  if (includeMcp) {
+    const { toolGroups } = await inquirer.prompt([
+      {
+        type: 'checkbox',
+        name: 'toolGroups',
+        message: 'Which MCP tool groups should your app use?',
+        choices: [
+          { name: 'Social \u2014 Posts, comments, votes, feed', value: 'social', checked: true },
+          { name: 'Communities \u2014 Create, join, events', value: 'communities', checked: true },
+          { name: 'Villages \u2014 Manage villages, members, leaders', value: 'villages', checked: true },
+          { name: 'Moments & Pulse \u2014 Check-ins, engagement tracking', value: 'moments', checked: false },
+          { name: 'Villager Search \u2014 Lookup by name, phone, platform', value: 'villagers', checked: false },
+          { name: 'Meetings \u2014 Recall.ai bot, attendance tracking', value: 'meetings', checked: false },
+        ],
+        validate: input => input.length > 0 ? true : 'Select at least one tool group.',
+      },
+    ]);
+    mcpToolGroups = toolGroups;
+  }
+
   // Create project directory
-  const slug = answers.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
+  const slug = basics.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
   const targetDir = resolve(process.cwd(), slug);
 
   if (existsSync(targetDir)) {
@@ -190,14 +134,15 @@ async function dataLabelingFlow() {
     return;
   }
 
-  // OAuth registration (if auth selected)
+  // OAuth registration (if OAuth or both)
+  const hasOAuth = authStrategy === 'oauth' || authStrategy === 'both';
   let oauthCredentials = null;
-  if (answers.includeAuth) {
+  if (hasOAuth) {
     const oauthSpinner = villageSpinner('Registering OAuth application...').start();
     try {
       const result = await registerOAuthClient(
-        answers.name,
-        'data-labeling',
+        basics.name,
+        'agentic-app',
         ['http://localhost:5173/callback']
       );
       oauthCredentials = { clientId: result.clientId, clientSecret: result.clientSecret };
@@ -209,45 +154,83 @@ async function dataLabelingFlow() {
       const { continueWithoutAuth } = await inquirer.prompt([{
         type: 'confirm',
         name: 'continueWithoutAuth',
-        message: 'Continue without authentication?',
+        message: 'Continue without OAuth?',
         default: true,
       }]);
       if (!continueWithoutAuth) return;
-      answers.includeAuth = false;
     }
   }
 
+  // Determine if we need the agentic backend layer or just the frontend portal
+  const needsAgenticBackend = includeMcp || includeRestApi;
+
   // Scaffold project
-  const spinner = villageSpinner('Creating data labeling project...').start();
+  const spinner = villageSpinner('Creating application...').start();
   try {
-    createDataLabelingProject(targetDir, {
-      name: answers.name,
-      description: answers.description,
-      dataTypes: answers.dataTypes,
-      includeAuth: answers.includeAuth,
-      oauthCredentials,
-    });
+    if (needsAgenticBackend) {
+      // Full-stack: React frontend + Node.js backend with MCP/API integration
+      createAgenticAppProject(targetDir, {
+        name: basics.name,
+        description: basics.description,
+        authStrategy: oauthCredentials ? authStrategy : (authStrategy === 'oauth' ? 'none' : authStrategy),
+        features,
+        includeMcp,
+        includeRestApi,
+        mcpToolGroups,
+        oauthCredentials,
+      });
+    } else {
+      // Frontend-only: React + Vite portal (existing template)
+      // Map authStrategy to the features array the portal template expects
+      const portalFeatures = [...features];
+      if (hasOAuth && oauthCredentials) {
+        portalFeatures.push('auth');
+      }
+
+      createPortalProject(targetDir, {
+        name: basics.name,
+        description: basics.description,
+        features: portalFeatures,
+        oauthCredentials,
+      });
+    }
 
     spinner.text = 'Installing dependencies...';
     execSync('npm install', { cwd: targetDir, stdio: 'pipe' });
-    spinner.succeed(`Data labeling app "${answers.name}" created successfully!`);
+    spinner.succeed(`Application "${basics.name}" created successfully!`);
 
     console.log();
-    console.log(brand.green(`  \u2713 Data labeling app "${answers.name}" created successfully!`));
+    console.log(brand.green(`  \u2713 Application "${basics.name}" created successfully!`));
     console.log();
     console.log(brand.teal('  Next steps:'));
     console.log();
     console.log(`    ${brand.gold('cd')} ${slug}`);
-    console.log(`    ${brand.gold('npm run dev')}      ${brand.teal('- Start development server')}`);
-    console.log(`    ${brand.gold('npm run build')}    ${brand.teal('- Build for production')}`);
+    if (needsAgenticBackend) {
+      console.log(`    ${brand.gold('npm run dev')}      ${brand.teal('- Start development server (auto-restart)')}`);
+      console.log(`    ${brand.gold('npm start')}        ${brand.teal('- Start production server')}`);
+    } else {
+      console.log(`    ${brand.gold('npm run dev')}      ${brand.teal('- Start development server')}`);
+      console.log(`    ${brand.gold('npm run build')}    ${brand.teal('- Build for production')}`);
+    }
     console.log();
-    console.log(brand.teal(`  Data types: ${answers.dataTypes.join(', ')}`));
+
+    // Summary
+    const summaryParts = [];
+    summaryParts.push(`Auth: ${authStrategy}`);
+    if (features.length > 0) summaryParts.push(`UI: ${features.join(', ')}`);
+    if (includeMcp) summaryParts.push(`MCP tools: ${mcpToolGroups.join(', ')}`);
+    if (includeRestApi) summaryParts.push('REST API proxy');
+    console.log(brand.teal(`  ${summaryParts.join('  |  ')}`));
+
     if (oauthCredentials) {
       console.log(brand.teal(`  OAuth Client ID: ${oauthCredentials.clientId}`));
     }
+    if (includeMcp) {
+      console.log(brand.teal('  Set ANTHROPIC_API_KEY in .env to enable the AI agent'));
+    }
     console.log();
   } catch (err) {
-    spinner.fail('Failed to create data labeling project.');
+    spinner.fail('Failed to create application.');
     console.error(chalk.red(`  ${err.message}`));
   }
 }

package/src/index.js

@@ -104,7 +104,7 @@ export function run() {
 
   program
     .command('create')
-    .description('Create a new project (portal, data labeling app, or game)')
+    .description('Create a new application or game')
     .action(createCommand);
 
   program