@myvillage/cli 1.1.1 → 1.2.0

package/src/commands/post.js

@@ -0,0 +1,252 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { isAuthenticated } from '../utils/auth.js';
+import {
+  createPost as apiCreatePost,
+  getPost,
+  listPosts,
+  editPost as apiEditPost,
+  deletePost as apiDeletePost,
+  listCommunities,
+} from '../utils/api.js';
+import {
+  formatPostDetail,
+  formatPostList,
+  formatCommentThread,
+  formatPagination,
+} from '../utils/formatters.js';
+
+export async function postCommand(id) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  if (id) {
+    return postViewCommand(id);
+  }
+
+  // No args: interactive create
+  return postCreateCommand();
+}
+
+export async function postViewCommand(id) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  const spinner = ora('Loading post...').start();
+
+  try {
+    const result = await getPost(id);
+    spinner.stop();
+
+    const post = result.data || result;
+    formatPostDetail(post);
+
+    if (post.comments?.length) {
+      formatCommentThread(post.comments);
+    }
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    spinner.fail(`Failed to load post: ${message}`);
+  }
+}
+
+export async function postCreateCommand() {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  try {
+    // Fetch communities for selection
+    const commSpinner = ora('Loading your communities...').start();
+    let communities = [];
+    try {
+      const result = await listCommunities({ pageSize: 50 });
+      communities = result.data || result;
+    } catch {
+      // Fall back to manual entry if fetch fails
+    }
+    commSpinner.stop();
+
+    const communityChoices = Array.isArray(communities) && communities.length > 0
+      ? communities.map(c => ({ name: `r/${c.slug} - ${c.name}`, value: c.slug }))
+      : null;
+
+    const answers = await inquirer.prompt([
+      communityChoices
+        ? {
+          type: 'list',
+          name: 'communitySlug',
+          message: 'Select community:',
+          choices: communityChoices,
+        }
+        : {
+          type: 'input',
+          name: 'communitySlug',
+          message: 'Community slug:',
+          validate: (input) => input.trim().length > 0 || 'Community is required',
+        },
+      {
+        type: 'list',
+        name: 'postType',
+        message: 'Post type:',
+        choices: [
+          { name: 'Discussion', value: 'DISCUSSION' },
+          { name: 'Question', value: 'QUESTION' },
+          { name: 'Project Showcase', value: 'PROJECT_SHOWCASE' },
+          { name: 'Tutorial', value: 'TUTORIAL' },
+          { name: 'Game Showcase', value: 'GAME_SHOWCASE' },
+          { name: 'Bounty', value: 'BOUNTY' },
+          { name: 'Announcement', value: 'ANNOUNCEMENT' },
+        ],
+      },
+      {
+        type: 'input',
+        name: 'title',
+        message: 'Title (optional):',
+      },
+      {
+        type: 'editor',
+        name: 'body',
+        message: 'Post body (opens editor):',
+        validate: (input) => input.trim().length > 0 || 'Body is required',
+      },
+      {
+        type: 'input',
+        name: 'tags',
+        message: 'Tags (comma-separated):',
+      },
+    ]);
+
+    const spinner = ora('Creating post...').start();
+
+    const data = {
+      communitySlug: answers.communitySlug.trim(),
+      postType: answers.postType,
+      body: answers.body.trim(),
+      tags: answers.tags ? answers.tags.split(',').map(t => t.trim()).filter(Boolean) : [],
+    };
+    if (answers.title?.trim()) {
+      data.title = answers.title.trim();
+    }
+
+    const result = await apiCreatePost(data);
+    spinner.succeed('Post created!');
+
+    const post = result.data || result;
+    console.log(chalk.green(`  ✓ Post published in r/${answers.communitySlug}`));
+    console.log(chalk.dim(`  ID: ${post.id}\n`));
+  } catch (err) {
+    if (err.isTtyError) {
+      console.log(chalk.red('  ✗ Prompts cannot be rendered in this environment.\n'));
+      return;
+    }
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`  ✗ Failed to create post: ${message}\n`));
+  }
+}
+
+export async function postListCommand(options) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  const spinner = ora('Loading posts...').start();
+
+  try {
+    const params = {
+      pageSize: parseInt(options.limit) || 10,
+    };
+    if (options.community) params.communitySlug = options.community;
+    if (options.author) params.authorId = options.author;
+    if (options.type) params.postType = options.type;
+    if (options.sort) params.sort = options.sort;
+    if (options.cursor) params.cursor = options.cursor;
+
+    const result = await listPosts(params);
+    spinner.stop();
+
+    const posts = result.data || result;
+
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    formatPostList(posts);
+    formatPagination(result.meta);
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    spinner.fail(`Failed to load posts: ${message}`);
+  }
+}
+
+export async function postEditCommand(id) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  const loadSpinner = ora('Loading post...').start();
+
+  try {
+    const result = await getPost(id);
+    loadSpinner.stop();
+
+    const post = result.data || result;
+
+    const answers = await inquirer.prompt([
+      {
+        type: 'editor',
+        name: 'body',
+        message: 'Edit post body:',
+        default: post.body,
+        validate: (input) => input.trim().length > 0 || 'Body is required',
+      },
+    ]);
+
+    const spinner = ora('Saving changes...').start();
+    await apiEditPost(id, { body: answers.body.trim() });
+    spinner.succeed('Post updated!');
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    loadSpinner.stop();
+    console.log(chalk.red(`  ✗ Failed to edit post: ${message}\n`));
+  }
+}
+
+export async function postDeleteCommand(id) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.'));
+    return;
+  }
+
+  try {
+    const { confirm } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'confirm',
+        message: `Delete post ${id}? This cannot be undone.`,
+        default: false,
+      },
+    ]);
+
+    if (!confirm) {
+      console.log(chalk.dim('  Cancelled.\n'));
+      return;
+    }
+
+    const spinner = ora('Deleting post...').start();
+    await apiDeletePost(id);
+    spinner.succeed('Post deleted.');
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`  ✗ Failed to delete post: ${message}\n`));
+  }
+}

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');
@@ -16,9 +36,11 @@ export function run() {
 
   program
     .name('myvillage')
-    .description('MyVillageOS CLI for student game developers')
+    .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();
 }