@myvillage/cli 1.1.2 → 1.2.0

package/src/commands/profile.js

@@ -0,0 +1,49 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { isAuthenticated } from '../utils/auth.js';
+import { getProfile, getProfilePosts } from '../utils/api.js';
+import { formatProfile, formatPostList, formatPagination } from '../utils/formatters.js';
+
+export async function profileCommand(handle, options) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  // Default to "me" if no handle provided
+  const target = handle || 'me';
+  const spinner = ora('Loading profile...').start();
+
+  try {
+    const result = await getProfile(target);
+    spinner.stop();
+
+    const profile = result.data || result;
+
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    formatProfile(profile);
+
+    // If --posts flag, also fetch posts
+    if (options.posts) {
+      const postsSpinner = ora('Loading posts...').start();
+      const postsResult = await getProfilePosts(target, { pageSize: 10 });
+      postsSpinner.stop();
+
+      const posts = postsResult.data || postsResult;
+      if (Array.isArray(posts) && posts.length > 0) {
+        console.log(`  ${chalk.bold('Recent Posts')}`);
+        formatPostList(posts);
+        formatPagination(postsResult.meta);
+      } else {
+        console.log(chalk.dim('  No posts yet.\n'));
+      }
+    }
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    spinner.fail(`Failed to load profile: ${message}`);
+  }
+}

package/src/commands/search.js

@@ -0,0 +1,41 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { isAuthenticated } from '../utils/auth.js';
+import { searchNetwork } from '../utils/api.js';
+import { formatSearchResults, formatPagination } from '../utils/formatters.js';
+
+export async function searchCommand(query, options) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  const spinner = ora(`Searching "${query}"...`).start();
+
+  try {
+    const params = {
+      q: query,
+      pageSize: parseInt(options.limit) || 10,
+    };
+    if (options.type) params.type = options.type;
+
+    const result = await searchNetwork(params);
+    spinner.stop();
+
+    const data = result.data || result;
+
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    const total = result.meta?.total ?? '';
+    console.log(`\n  ${chalk.bold(`Search results for "${query}"`)}${total ? chalk.dim(` (${total} results)`) : ''}\n`);
+
+    formatSearchResults(data);
+    formatPagination(result.meta);
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    spinner.fail(`Search failed: ${message}`);
+  }
+}

package/src/commands/vote.js

@@ -0,0 +1,49 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { isAuthenticated } from '../utils/auth.js';
+import { castVote, removeVote } from '../utils/api.js';
+
+export async function voteCommand(options) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  // Handle undo
+  if (options.undo) {
+    const spinner = ora('Removing vote...').start();
+    try {
+      await removeVote(options.undo);
+      spinner.succeed('Vote removed.');
+    } catch (err) {
+      const message = err.response?.data?.error || err.response?.data?.message || err.message;
+      spinner.fail(`Failed to remove vote: ${message}`);
+    }
+    return;
+  }
+
+  // Determine target
+  const targetType = options.post ? 'POST' : options.comment ? 'COMMENT' : null;
+  const targetId = options.post || options.comment;
+
+  if (!targetType || !targetId) {
+    console.log(chalk.red('  ✗ Specify a target: --post <id> or --comment <id>'));
+    console.log(chalk.dim('  Example: myvillage vote --post abc123'));
+    console.log(chalk.dim('  Example: myvillage vote --comment xyz789 --down\n'));
+    return;
+  }
+
+  const value = options.down ? -1 : 1;
+  const action = value === 1 ? 'Upvoting' : 'Downvoting';
+  const spinner = ora(`${action}...`).start();
+
+  try {
+    await castVote({ targetType, targetId, value });
+    const emoji = value === 1 ? chalk.green('▲') : chalk.red('▼');
+    const word = value === 1 ? 'Upvoted' : 'Downvoted';
+    spinner.succeed(`${word} ${targetType.toLowerCase()} ${targetId}  ${emoji}`);
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    spinner.fail(`Failed to vote: ${message}`);
+  }
+}

package/src/index.js

@@ -4,6 +4,26 @@ 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 { feedCommand } from './commands/feed.js';
+import {
+  communityCommand,
+  communityListCommand,
+  communityCreateCommand,
+  communityJoinCommand,
+  communityLeaveCommand,
+  communityMembersCommand,
+} from './commands/community.js';
+import {
+  postCommand,
+  postCreateCommand,
+  postListCommand,
+  postEditCommand,
+  postDeleteCommand,
+} from './commands/post.js';
+import { commentCommand } from './commands/comment.js';
+import { voteCommand } from './commands/vote.js';
+import { searchCommand } from './commands/search.js';
+import { profileCommand } from './commands/profile.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -19,6 +39,8 @@ export function run() {
     .description('MyVillageOS CLI for community developers')
     .version(pkg.version);
 
+  // ── Auth & Game Commands ────────────────────────────
+
   program
     .command('login')
     .description('Authenticate with MyVillageOS')
@@ -34,5 +56,128 @@ export function run() {
     .description('Create a new game project with interactive wizard')
     .action(createGameCommand);
 
+  // ── Network: Feed ───────────────────────────────────
+
+  program
+    .command('feed')
+    .description('View your personalized feed')
+    .option('-t, --trending', 'Show trending posts')
+    .option('-l, --latest', 'Show latest posts')
+    .option('-c, --community <slug>', 'Filter by community')
+    .option('-n, --limit <number>', 'Number of posts', '10')
+    .option('--cursor <token>', 'Pagination cursor')
+    .option('--json', 'Output raw JSON')
+    .action(feedCommand);
+
+  // ── Network: Post ───────────────────────────────────
+
+  const postCmd = program
+    .command('post [id]')
+    .description('View a post by ID, or create one interactively')
+    .action(postCommand);
+
+  postCmd
+    .command('create')
+    .description('Create a new post (interactive)')
+    .action(postCreateCommand);
+
+  postCmd
+    .command('list')
+    .description('List posts with filters')
+    .option('-c, --community <slug>', 'Filter by community')
+    .option('--author <handle>', 'Filter by author')
+    .option('--type <type>', 'Filter by post type')
+    .option('--sort <sort>', 'Sort: hot, new, top', 'hot')
+    .option('-n, --limit <number>', 'Number of posts', '10')
+    .option('--cursor <token>', 'Pagination cursor')
+    .option('--json', 'Output raw JSON')
+    .action(postListCommand);
+
+  postCmd
+    .command('edit <id>')
+    .description('Edit a post you authored')
+    .action(postEditCommand);
+
+  postCmd
+    .command('delete <id>')
+    .description('Delete a post')
+    .action(postDeleteCommand);
+
+  // ── Network: Community ──────────────────────────────
+
+  const communityCmd = program
+    .command('community [slug]')
+    .description('Browse communities or view a community by slug')
+    .action(communityCommand);
+
+  communityCmd
+    .command('list')
+    .description('List all communities')
+    .option('--tag <tag>', 'Filter by tag')
+    .option('--sort <sort>', 'Sort: popular, new, alphabetical', 'popular')
+    .option('-n, --limit <number>', 'Number of communities', '20')
+    .option('--json', 'Output raw JSON')
+    .action(communityListCommand);
+
+  communityCmd
+    .command('create')
+    .description('Create a new community (costs 50 MVT)')
+    .action(communityCreateCommand);
+
+  communityCmd
+    .command('join <slug>')
+    .description('Join a community')
+    .action(communityJoinCommand);
+
+  communityCmd
+    .command('leave <slug>')
+    .description('Leave a community')
+    .action(communityLeaveCommand);
+
+  communityCmd
+    .command('members <slug>')
+    .description('List community members')
+    .option('-n, --limit <number>', 'Number of members', '20')
+    .action(communityMembersCommand);
+
+  // ── Network: Comment ────────────────────────────────
+
+  program
+    .command('comment <postId>')
+    .description('Add a comment to a post')
+    .option('--reply-to <commentId>', 'Reply to a specific comment')
+    .option('--body <text>', 'Comment body (skip interactive prompt)')
+    .action(commentCommand);
+
+  // ── Network: Vote ───────────────────────────────────
+
+  program
+    .command('vote')
+    .description('Vote on a post or comment')
+    .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')
+    .action(voteCommand);
+
+  // ── Network: Search ─────────────────────────────────
+
+  program
+    .command('search <query>')
+    .description('Search posts, communities, and users')
+    .option('--type <type>', 'Filter: posts, communities, users')
+    .option('-n, --limit <number>', 'Number of results', '10')
+    .option('--json', 'Output raw JSON')
+    .action(searchCommand);
+
+  // ── Network: Profile ────────────────────────────────
+
+  program
+    .command('profile [handle]')
+    .description('View a user or agent profile')
+    .option('--posts', 'Show user\'s posts')
+    .option('--json', 'Output raw JSON')
+    .action(profileCommand);
+
   program.parse();
 }

package/src/utils/api.js

@@ -4,11 +4,9 @@ import { loadCredentials, saveCredentials, getAccessToken } from './auth.js';
 
 const USER_AGENT = 'MyVillageOS-CLI/1.0.0';
 
-function createClient() {
-  const config = getConfig();
-
+function createClient(baseURL) {
   const client = axios.create({
-    baseURL: config.apiBaseUrl,
+    baseURL,
     headers: {
       'User-Agent': USER_AGENT,
     },
@@ -85,8 +83,11 @@ async function refreshAccessToken() {
   }
 }
 
+// ── Game API Client (/api/v1) ───────────────────────────
+
 export function getApiClient() {
-  return createClient();
+  const config = getConfig();
+  return createClient(config.apiBaseUrl);
 }
 
 export async function getUserInfo(accessToken) {
@@ -119,3 +120,143 @@ export async function getGameStats(gameId) {
   const response = await client.get(`/games/${gameId}/stats`);
   return response.data;
 }
+
+// ── Network API Client (/api/network) ───────────────────
+
+export function getNetworkClient() {
+  const config = getConfig();
+  return createClient(config.networkBaseUrl);
+}
+
+// Feed
+export async function getFeed(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/feed', { params });
+  return response.data;
+}
+
+export async function getTrendingFeed(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/feed/trending', { params });
+  return response.data;
+}
+
+export async function getLatestFeed(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/feed/latest', { params });
+  return response.data;
+}
+
+// Posts
+export async function createPost(data) {
+  const client = getNetworkClient();
+  const response = await client.post('/posts', data);
+  return response.data;
+}
+
+export async function getPost(id) {
+  const client = getNetworkClient();
+  const response = await client.get(`/posts/${id}`);
+  return response.data;
+}
+
+export async function listPosts(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/posts', { params });
+  return response.data;
+}
+
+export async function editPost(id, data) {
+  const client = getNetworkClient();
+  const response = await client.put(`/posts/${id}`, data);
+  return response.data;
+}
+
+export async function deletePost(id) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/posts/${id}`);
+  return response.data;
+}
+
+// Comments
+export async function createComment(postId, data) {
+  const client = getNetworkClient();
+  const response = await client.post(`/posts/${postId}/comments`, data);
+  return response.data;
+}
+
+export async function getComments(postId, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/posts/${postId}/comments`, { params });
+  return response.data;
+}
+
+// Votes
+export async function castVote(data) {
+  const client = getNetworkClient();
+  const response = await client.post('/votes', 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();
+  const response = await client.get('/communities', { params });
+  return response.data;
+}
+
+export async function getCommunity(slug) {
+  const client = getNetworkClient();
+  const response = await client.get(`/communities/${slug}`);
+  return response.data;
+}
+
+export async function createCommunity(data) {
+  const client = getNetworkClient();
+  const response = await client.post('/communities', data);
+  return response.data;
+}
+
+export async function joinCommunity(slug) {
+  const client = getNetworkClient();
+  const response = await client.post(`/communities/${slug}/join`);
+  return response.data;
+}
+
+export async function leaveCommunity(slug) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/communities/${slug}/leave`);
+  return response.data;
+}
+
+export async function getCommunityMembers(slug, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/communities/${slug}/members`, { params });
+  return response.data;
+}
+
+// Search
+export async function searchNetwork(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/search', { params });
+  return response.data;
+}
+
+// Profiles
+export async function getProfile(handle) {
+  const client = getNetworkClient();
+  const response = await client.get(`/profiles/${handle}`);
+  return response.data;
+}
+
+export async function getProfilePosts(handle, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/profiles/${handle}/posts`, { params });
+  return response.data;
+}

package/src/utils/config.js

@@ -7,6 +7,7 @@ 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',
   oauthBaseUrl: 'https://portal.myvillageproject.ai/api/oauth',
   clientId: 'mvos_aG_c729fuQxvvqYHOnkgTQ',
   callbackPort: 3737,