@myvillage/cli 2.1.0 → 2.2.0

package/package.json

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

package/src/commands/books.js

@@ -0,0 +1,76 @@
+import chalk from 'chalk';
+import { isAuthenticated } from '../utils/auth.js';
+import { getMyStoryBooks } from '../utils/api.js';
+
+/**
+ * books — the author's own shelf, every status.
+ *
+ * Exists so an author can see where their submissions stand without being sent
+ * to the portal. The portal's story-books screen is a reviewer's surface: it
+ * carries other people's books, the approve/reject controls, and the raw state
+ * names. None of that belongs in front of the person waiting on a decision.
+ *
+ * The `--json` shape is what Studio's Story Books screen renders.
+ */
+
+function fail(json, message) {
+  if (json) {
+    console.log(JSON.stringify({ success: false, error: message }));
+  } else {
+    console.log(chalk.red(`  ✗ ${message}`));
+  }
+  process.exitCode = 1;
+}
+
+/** Reviewer state name → what it means to the person who wrote the book. */
+const STATE_LABEL = {
+  DRAFT: 'Draft',
+  PROCESSING: 'Processing',
+  SUBMITTED: 'Waiting for review',
+  UNDER_REVIEW: 'Being reviewed',
+  APPROVED: 'Approved',
+  REJECTED: 'Needs changes',
+  PUBLISHED: 'Live',
+  ARCHIVED: 'Removed',
+};
+
+export async function booksListCommand(options = {}) {
+  const json = !!options.json;
+
+  if (!isAuthenticated()) {
+    return fail(json, "Authentication required. Run 'myvillage login' first.");
+  }
+
+  let books;
+  try {
+    const result = await getMyStoryBooks();
+    books = result.storyBooks || [];
+  } catch (err) {
+    return fail(json, err.response?.data?.error || err.message);
+  }
+
+  if (json) {
+    console.log(JSON.stringify({ success: true, storyBooks: books }));
+    return;
+  }
+
+  if (books.length === 0) {
+    console.log('');
+    console.log(`  No books yet. ${chalk.cyan('myvillage publish-book <pdf>')} publishes one.`);
+    console.log('');
+    return;
+  }
+
+  console.log('');
+  for (const b of books) {
+    const label = STATE_LABEL[b.status] || b.status;
+    console.log(`  ${chalk.bold(b.title)} ${chalk.dim(`(${b.slug})`)}`);
+    console.log(
+      `    ${chalk.dim('Status:')} ${label}   ${chalk.dim('Pages:')} ${b.pageCount ?? 0}`,
+    );
+    if (b.status === 'REJECTED' && b.rejectionReason) {
+      console.log(`    ${chalk.red(b.rejectionReason)}`);
+    }
+    console.log('');
+  }
+}

package/src/index.js

@@ -19,6 +19,7 @@ import { createGameCommand } from './commands/create-game.js';
 import { createCommand } from './commands/create-app.js';
 import { deployCommand } from './commands/deploy.js';
 import { publishBookCommand } from './commands/publish-book.js';
+import { booksListCommand } from './commands/books.js';
 import { publishEpisodeCommand } from './commands/publish-episode.js';
 import {
   podcastCreateCommand,
@@ -251,6 +252,12 @@ export function run() {
     .option('--json', 'Output the result as JSON (implies non-interactive)')
     .action((pdf, options) => publishBookCommand(pdf, options));
 
+  program
+    .command('books')
+    .description('List your story books and where each one stands')
+    .option('--json', 'Output the result as JSON')
+    .action((options) => booksListCommand(options));
+
   program
     .command('publish-episode <audio>')
     .description('Publish an audio file as a podcast episode')