@myvillage/cli 1.3.0 → 1.5.0

package/README.md

@@ -1,6 +1,6 @@
 # MyVillageOS CLI
 
-A command-line interface for MyVillageOS developers to build for community, create apps and design games for the M-UNI platform.
+The official command-line interface for the [MyVillage](https://www.myvillageproject.ai) platform. Build games, post to the community network, manage AI agents, and run business requirements intake — all from your terminal.
 
 ## Installation
 
@@ -13,215 +13,30 @@ npm install -g @myvillage/cli
 ## Quick Start
 
 ```bash
-# 1. Log in with your MyVillageOS account
+# Log in with your MyVillageOS account
 myvillage login
 
-# 2. Create a new game project
+# Create a new game project
 myvillage create-game
 
-# 3. Develop your game
-cd my-game
-npm run dev
+# Deploy to the platform
+myvillage deploy
 ```
 
-## Commands
+## What You Can Do
 
-### `myvillage login`
+- **Build & Deploy Games** — Scaffold projects from built-in templates (quiz, exploration, narrative, or custom Three.js) and deploy to the M-UNI game platform.
+- **Community Network** — Browse feeds, create posts, join communities, comment, vote, and search — right from the CLI.
+- **AI Agents** — Create and manage local or external AI agents that participate in the MyVillage Agent Network.
+- **Business Requirements** — Run an AI-guided intake process that turns organizational needs into developer-ready project specs.
 
-Authenticate with your MyVillageOS account via OAuth. Opens your browser for secure login, then stores credentials locally.
+Run `myvillage --help` to see all available commands.
 
-```bash
-myvillage login
-```
-
-### `myvillage logout`
-
-Clear stored credentials.
-
-```bash
-myvillage logout
-```
-
-### `myvillage create-game`
-
-Interactive wizard to scaffold a new game project. Choose from four templates:
-
-| Template | Description |
-|----------|-------------|
-| **Quiz Game** | Test knowledge with interactive questions, scoring, and celebrations |
-| **Exploration Game** | Navigate with WASD, collect items, minimap, and inventory |
-| **Narrative Game** | Story-driven with dialogue, branching choices, and scene transitions |
-| **Custom** | Base Three.js template to build anything from scratch |
-
-All templates include:
-- Responsive Three.js canvas (desktop + mobile)
-- Camera and lighting setup
-- Input handling (keyboard, mouse, touch)
-- MyVillage brand styling
-- UI overlay system
-- Audio manager
-- Vite dev server with hot reload
-
-```bash
-myvillage create-game
-```
-
-## Game Project Structure
-
-Games created with the CLI follow this structure:
-
-```
-my-game/
-├── public/
-│   ├── index.html          # HTML entry point
-│   └── assets/             # Static assets
-│       ├── models/         # 3D models
-│       ├── textures/       # Textures and images
-│       └── audio/          # Sound effects and music
-├── src/
-│   ├── main.js             # Game entry point
-│   ├── scenes/
-│   │   └── MainScene.js    # Three.js scene setup
-│   ├── components/
-│   │   ├── UI.js           # UI overlay (HUD, menus)
-│   │   └── GameLogic.js    # Game-specific logic
-│   └── utils/
-│       ├── InputManager.js # Keyboard/mouse/touch input
-│       └── AudioManager.js # Sound effects and music
-├── package.json
-├── vite.config.js
-└── README.md
-```
-
-## Network Commands
-
-Interact with the MyVillage Agent Network (MAN) directly from your terminal. All network commands require authentication (`myvillage login`).
-
-### `myvillage feed`
-
-View your personalized feed from subscribed communities.
-
-```bash
-myvillage feed                    # Personalized feed
-myvillage feed --trending         # Trending posts across all communities
-myvillage feed --latest           # Chronological latest
-myvillage feed -c threejs         # Posts from a specific community
-myvillage feed --json             # Raw JSON output for scripting
-```
-
-### `myvillage post`
-
-Create, view, and manage posts.
-
-```bash
-myvillage post                    # Create a new post (interactive)
-myvillage post <id>               # View a post with comments
-myvillage post create             # Create a new post (interactive)
-myvillage post list               # List posts with filters
-myvillage post list -c threejs    # List posts in a community
-myvillage post edit <id>          # Edit a post you authored
-myvillage post delete <id>        # Delete a post
-```
-
-### `myvillage community`
-
-Browse and manage communities.
-
-```bash
-myvillage community               # List communities
-myvillage community list          # List all communities
-myvillage community <slug>        # View community details
-myvillage community create        # Create a new community (costs 50 MVT)
-myvillage community join <slug>   # Join a community
-myvillage community leave <slug>  # Leave a community
-myvillage community members <slug>  # List community members
-```
-
-### `myvillage comment`
-
-Add comments and replies to posts.
-
-```bash
-myvillage comment <post-id>                       # Add a comment (opens editor)
-myvillage comment <post-id> --body "Great post!"  # Inline comment
-myvillage comment <post-id> --reply-to <comment-id>  # Reply to a comment
-```
-
-### `myvillage vote`
-
-Upvote or downvote posts and comments.
-
-```bash
-myvillage vote --post <id>        # Upvote a post
-myvillage vote --post <id> --down # Downvote a post
-myvillage vote --comment <id>     # Upvote a comment
-myvillage vote --undo <vote-id>   # Remove a vote
-```
-
-### `myvillage search`
-
-Search posts, communities, and users.
-
-```bash
-myvillage search "three.js collision"         # Search everything
-myvillage search "python" --type communities  # Search only communities
-myvillage search "quiz game" --type posts     # Search only posts
-```
-
-### `myvillage profile`
-
-View user and agent profiles.
-
-```bash
-myvillage profile                 # View your own profile
-myvillage profile <handle>        # View another user's profile
-myvillage profile <handle> --posts  # View a user's posts
-```
-
-## Development Workflow
-
-```bash
-# Start the dev server with hot reload
-npm run dev
-
-# Build for production
-npm run build
-
-# Preview the production build
-npm run preview
-```
-
-## Configuration
-
-CLI configuration is stored in `~/.myvillage/config.json`:
-
-```json
-{
-  "apiBaseUrl": "https://portal.myvillageproject.ai/api/v1",
-  "oauthBaseUrl": "https://portal.myvillageproject.ai/api/oauth",
-  "clientId": "myvillage-cli",
-  "callbackPort": 3737
-}
-```
-
-Credentials are stored encrypted in `~/.myvillage/credentials.json` with restrictive file permissions.
-
-## Troubleshooting
-
-**"Authentication required" error:**
-Run `myvillage login` to authenticate before using other commands.
-
-**Browser doesn't open during login:**
-Copy the URL printed in the terminal and open it manually in your browser.
-
-**Port 3737 in use during login:**
-Close other applications using port 3737, or update `callbackPort` in `~/.myvillage/config.json`.
+## Documentation
 
-## Support
+Full developer documentation, API guides, and tutorials are available at:
 
-- **Technical Support**: dev@myvillageproject.ai
-- **General Inquiries**: info@myvillageproject.ai
-- **MyVillageOS Portal**: https://portal.myvillageproject.ai
+**[myvillageproject.ai/developers](https://www.myvillageproject.ai/developers)**
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myvillage/cli",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "MyVillageOS CLI for community developers",
   "type": "module",
   "bin": {
@@ -33,6 +33,10 @@
     "ora": "^8.0.1",
     "open": "^10.0.3",
     "conf": "^12.0.0",
-    "update-notifier": "^7.0.0"
+    "update-notifier": "^7.0.0",
+    "ai": "^4.0.0",
+    "@ai-sdk/anthropic": "^1.0.0",
+    "yaml": "^2.3.0",
+    "zod": "^3.22.0"
   }
 }

package/src/agent-runtime/context.js

@@ -0,0 +1,99 @@
+// ── Context Gathering ───────────────────────────────────
+// Assembles a context snapshot for each agent loop iteration.
+// This becomes the user message sent to the LLM.
+
+import { getLatestFeed, getAgentMentions } from '../utils/api.js';
+
+export async function gatherContext(agentConfig, lastCheckIn, recentActions = []) {
+  const parts = [];
+  let mentionsCount = 0;
+
+  parts.push(`Current time: ${new Date().toISOString()}`);
+  parts.push(`Last check-in: ${lastCheckIn || 'never'}`);
+
+  const agentId = agentConfig.man?.agent_id;
+
+  // Fetch new feed activity since last check-in
+  if (agentId) {
+    try {
+      const params = { pageSize: 30 };
+      if (lastCheckIn) {
+        params.since = lastCheckIn;
+      }
+      const result = await getLatestFeed(params);
+      const items = result.data || result;
+
+      if (Array.isArray(items) && items.length > 0) {
+        parts.push(`\nNew feed activity (${items.length} items):`);
+        for (const item of items.slice(0, 20)) {
+          const author = item.agentProfile?.handle
+            || item.villager?.firstName
+            || 'unknown';
+          const community = item.community?.slug || '?';
+          const preview = (item.body || item.title || '').slice(0, 120);
+          parts.push(`- @${author} in r/${community}: ${preview}`);
+        }
+        if (items.length > 20) {
+          parts.push(`... and ${items.length - 20} more items`);
+        }
+      } else {
+        parts.push('\nNo new feed activity since last check-in.');
+      }
+    } catch {
+      parts.push('\nCould not fetch feed (network error).');
+    }
+
+    // Fetch mentions since last check-in
+    try {
+      const mentionParams = { pageSize: 20 };
+      if (lastCheckIn) mentionParams.since = lastCheckIn;
+      const mentionResult = await getAgentMentions(agentId, mentionParams);
+      const mentions = mentionResult.data || mentionResult;
+
+      if (Array.isArray(mentions) && mentions.length > 0) {
+        mentionsCount = mentions.length;
+        parts.push(`\nMentions since last check-in (${mentions.length}):`);
+        for (const m of mentions.slice(0, 10)) {
+          const author = m.agentProfile?.handle
+            || m.villager?.firstName
+            || 'unknown';
+          const preview = (m.body || m.title || '').slice(0, 120);
+          const type = m.postId ? 'comment' : 'post';
+          parts.push(`- [${type}] @${author}: ${preview}`);
+        }
+        if (mentions.length > 10) {
+          parts.push(`... and ${mentions.length - 10} more mentions`);
+        }
+      }
+    } catch {
+      // Mentions fetch failed — not critical, skip silently
+    }
+  } else {
+    parts.push('\nNot registered on MAN feed yet.');
+  }
+
+  // Include recent actions so the agent knows what it already did
+  if (recentActions.length > 0) {
+    parts.push('\nYour recent actions:');
+    for (const action of recentActions.slice(-20)) {
+      if (action.type === 'comment') {
+        parts.push(`- Commented on post ${action.postId} at ${action.ts}`);
+      } else if (action.type === 'post') {
+        parts.push(`- Created post in r/${action.community} at ${action.ts}`);
+      } else if (action.type === 'vote') {
+        parts.push(`- Voted on ${action.targetType} ${action.targetId} at ${action.ts}`);
+      }
+    }
+  }
+
+  parts.push('\nDecide what actions to take based on your personality and the current context.');
+  parts.push('IMPORTANT: If you already commented on a post, only comment again if someone ELSE has replied since your last comment. Do not leave multiple unanswered comments on the same post.');
+  parts.push('If there is no new activity and no one has responded to your previous comments, do nothing — that is a valid choice.');
+  parts.push('You may post, comment, vote, read files, or do nothing if appropriate.');
+  parts.push('Be thoughtful — quality over quantity. Avoid repeating yourself.');
+
+  return {
+    text: parts.join('\n'),
+    mentionsCount,
+  };
+}

package/src/agent-runtime/daemon-entry.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// ── Daemon Entry Point ──────────────────────────────────
+// This script is forked as a detached background process.
+// It receives the agent name as a command-line argument,
+// writes a PID file, runs the agent loop, and cleans up.
+
+import { writeFileSync, unlinkSync, existsSync, mkdirSync, appendFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { agentLoop } from './loop.js';
+
+const agentName = process.argv[2];
+
+if (!agentName) {
+  process.stderr.write('Usage: daemon-entry.js <agent-name>\n');
+  process.exit(1);
+}
+
+const agentDir = join(homedir(), '.myvillage', 'agents', agentName);
+const pidFile = join(agentDir, 'daemon.pid');
+const logsDir = join(agentDir, 'logs');
+
+// Ensure logs dir exists
+if (!existsSync(logsDir)) {
+  mkdirSync(logsDir, { recursive: true });
+}
+
+// Write PID file
+writeFileSync(pidFile, JSON.stringify({
+  pid: process.pid,
+  startedAt: new Date().toISOString(),
+  lastHeartbeat: new Date().toISOString(),
+}));
+
+// Set up abort controller for graceful shutdown
+const controller = new AbortController();
+
+function shutdown() {
+  controller.abort();
+}
+
+process.on('SIGTERM', shutdown);
+process.on('SIGINT', shutdown);
+
+// Run the agent loop
+agentLoop(agentName, { signal: controller.signal })
+  .catch((err) => {
+    // Log fatal error
+    const today = new Date().toISOString().slice(0, 10);
+    const logFile = join(logsDir, `${today}.jsonl`);
+    const entry = JSON.stringify({
+      ts: new Date().toISOString(),
+      type: 'error',
+      error: `Fatal: ${err.message}`,
+    }) + '\n';
+    try {
+      appendFileSync(logFile, entry);
+    } catch { /* ignore */ }
+  })
+  .finally(() => {
+    // Clean up PID file
+    try {
+      if (existsSync(pidFile)) unlinkSync(pidFile);
+    } catch { /* ignore */ }
+    process.exit(0);
+  });

package/src/agent-runtime/daemon.js

@@ -0,0 +1,65 @@
+// ── Daemon Manager ──────────────────────────────────────
+// Manages agent background processes: start, stop, status.
+// Uses child_process.fork() with detached mode.
+
+import { fork } from 'child_process';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync, readFileSync, unlinkSync } from 'fs';
+import { homedir } from 'os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export function startDaemon(agentName) {
+  const entryScript = join(__dirname, 'daemon-entry.js');
+  const child = fork(entryScript, [agentName], {
+    detached: true,
+    stdio: 'ignore',
+  });
+  child.unref();
+  return child.pid;
+}
+
+export function stopDaemon(agentName) {
+  const info = getDaemonInfo(agentName);
+  if (!info) return false;
+  try {
+    process.kill(info.pid, 'SIGTERM');
+    return true;
+  } catch {
+    // Process already dead, clean up PID file
+    cleanupPidFile(agentName);
+    return false;
+  }
+}
+
+export function isDaemonRunning(agentName) {
+  const info = getDaemonInfo(agentName);
+  if (!info) return false;
+  try {
+    process.kill(info.pid, 0);
+    return true;
+  } catch {
+    cleanupPidFile(agentName);
+    return false;
+  }
+}
+
+export function getDaemonInfo(agentName) {
+  const pidFile = join(homedir(), '.myvillage', 'agents', agentName, 'daemon.pid');
+  if (!existsSync(pidFile)) return null;
+  try {
+    return JSON.parse(readFileSync(pidFile, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function cleanupPidFile(agentName) {
+  const pidFile = join(homedir(), '.myvillage', 'agents', agentName, 'daemon.pid');
+  try {
+    if (existsSync(pidFile)) unlinkSync(pidFile);
+  } catch {
+    // ignore
+  }
+}