@tvbs-ai/news-rd 0.2.0 → 0.3.0

package/README.md

@@ -6,7 +6,7 @@ TVBS News Rundown AI CLI — query rundowns, news candidates, Google Trends, and
 
 ```bash
 npm install -g @tvbs-ai/news-rd
-# or
+# or run directly
 npx @tvbs-ai/news-rd --help
 ```
 
@@ -25,6 +25,7 @@ news-rd <group> <command> [args] [options]
 | `news` | 候選新聞與趨勢關鍵字 |
 | `prompt` | Prompt 模板、變數與編譯 |
 | `token` | JWT Token 管理 |
+| `completion` | Shell auto-completion |
 
 ### Examples
 
@@ -55,7 +56,8 @@ news-rd prompt compile 2026-03-10 0600
 | `--base-url URL` | API base URL | `https://news-rundown.tvbs.ai` |
 | `--token TOKEN` | JWT token (or `RD_TOKEN` env) | — |
 | `--json` | Raw JSON output | — |
-| `--help` | Show help | — |
+| `--version, -v` | Show version | — |
+| `--help, -h` | Show help | — |
 
 ### Environment Variables
 
@@ -64,14 +66,33 @@ news-rd prompt compile 2026-03-10 0600
 | `RD_BASE_URL` | API base URL |
 | `RD_TOKEN` | JWT authentication token |
 
+### Shell Completion
+
+```bash
+# Bash
+news-rd completion bash >> ~/.bashrc && source ~/.bashrc
+
+# Zsh
+news-rd completion zsh >> ~/.zshrc && source ~/.zshrc
+```
+
+## Update
+
+The CLI automatically checks for new versions and shows a hint after command output. To update:
+
+```bash
+npm install -g @tvbs-ai/news-rd@latest
+```
+
 ## Requirements
 
 - Node.js >= 18 (uses built-in fetch)
 - A running TVBS News Rundown AI server
 
-## Publishing
+## Documentation
 
-See [CLI 發佈指南](../../docs/cli-publishing.md) for version bumping and npm publishing workflow.
+- [使用教學](../../docs/cli-guide.md) — 完整的操作教學（中文）
+- [發佈指南](../../docs/cli-publishing.md) — 版本更新與 npm 發佈流程
 
 ## License
 

package/dist/cli.js

@@ -35,6 +35,12 @@ function parseArgs() {
           options.limit = rawArgs[++i];
           break;
         case "--version":
+          if (!group) {
+            console.log(`@tvbs-ai/news-rd v${CLI_VERSION}`);
+            process.exit(0);
+          }
+          options.version = rawArgs[++i];
+          break;
         case "-v":
           console.log(`@tvbs-ai/news-rd v${CLI_VERSION}`);
           process.exit(0);
@@ -337,14 +343,24 @@ async function handleRundown(command, positional, options) {
 `);
       printTable(items.map((item, i) => {
         const newsItem = item.news_item;
+        const scoring = newsItem?.scoring || {};
+        const bonus = scoring.rundown_bonus || {};
         return {
           "#": item.sequence ?? i + 1,
           type: item.item_type,
-          title: newsItem ? String(newsItem.title ?? "").substring(0, 45) : item.placeholder?.caption ?? "-",
-          score: newsItem ? newsItem.scoring?.rundown_final_score ?? "-" : "-",
-          video_id: newsItem?.video_id ?? "-"
+          slug: newsItem?.slug ?? "-",
+          category: newsItem?.category ?? "-",
+          content_type: newsItem?.content_type ?? "-",
+          final: newsItem ? scoring.rundown_final_score?.toFixed?.(1) ?? "-" : "-",
+          summary: newsItem ? scoring.summary_score?.toFixed?.(1) ?? "-" : "-",
+          visual: newsItem ? scoring.visual_score?.toFixed?.(1) ?? "-" : "-",
+          trends: newsItem ? bonus.google_trends_score ?? 0 : "-",
+          excl: newsItem ? bonus.exclusivity_score ?? 0 : "-",
+          radar: newsItem ? bonus.trending_keywords_score ?? 0 : "-",
+          topic: newsItem ? bonus.featured_topic_score ?? 0 : "-",
+          title: newsItem ? String(newsItem.title ?? "").substring(0, 40) : item.placeholder?.caption ?? "-"
         };
-      }), ["#", "type", "title", "score", "video_id"]);
+      }), ["#", "type", "slug", "category", "content_type", "final", "summary", "visual", "trends", "excl", "radar", "topic", "title"]);
       return;
     }
     case "history": {
@@ -385,13 +401,23 @@ async function handleNews(command, positional, options) {
       }
       console.log(`Statistics: total=${data.statistics.total}, with_slug=${data.statistics.with_slug}, without_slug=${data.statistics.without_slug}
 `);
-      printTable(data.candidates.map((c) => ({
-        score: c.final_score?.toFixed(1),
-        title: String(c.title).substring(0, 50),
-        category: c.category,
-        slug: c.slug || "-",
-        video_id: c.video_id
-      })), ["score", "category", "title", "slug", "video_id"]);
+      printTable(data.candidates.map((c) => {
+        const bonus = c.bonus_scoring || {};
+        return {
+          slug: c.slug || "-",
+          category: c.category,
+          content_type: c.content_type || "-",
+          publish_time: c.publish_time ? String(c.publish_time).substring(0, 16) : "-",
+          final: c.final_score?.toFixed(1),
+          summary: c.summary_score?.toFixed(1) ?? "-",
+          visual: c.visual_score?.toFixed(1) ?? "-",
+          trends: bonus.google_trends_score ?? 0,
+          excl: bonus.exclusivity_score ?? 0,
+          radar: bonus.trending_keywords_score ?? 0,
+          topic: bonus.featured_topic_score ?? 0,
+          title: String(c.title).substring(0, 40)
+        };
+      }), ["slug", "category", "content_type", "publish_time", "final", "summary", "visual", "trends", "excl", "radar", "topic", "title"]);
       return;
     }
     case "trends": {
@@ -650,12 +676,34 @@ _news_rd() {
 
 _news_rd "$@"`;
 }
+async function checkForUpdates() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3e3);
+    const res = await fetch(
+      "https://registry.npmjs.org/@tvbs-ai/news-rd/latest",
+      { signal: controller.signal }
+    );
+    clearTimeout(timeout);
+    if (!res.ok) return;
+    const data = await res.json();
+    const latest = data.version;
+    if (latest && latest !== CLI_VERSION) {
+      console.error(`
+  \u65B0\u7248\u672C\u53EF\u7528: v${latest} (\u76EE\u524D v${CLI_VERSION})`);
+      console.error(`  \u66F4\u65B0\u6307\u4EE4: npm install -g @tvbs-ai/news-rd@latest
+`);
+    }
+  } catch {
+  }
+}
 async function main() {
   const { group, command, positional, options } = parseArgs();
   if (!group) {
     showHelp();
     process.exit(0);
   }
+  const updateCheck = checkForUpdates();
   try {
     switch (group) {
       case "config":
@@ -685,5 +733,6 @@ async function main() {
     console.error(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
+  await updateCheck;
 }
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tvbs-ai/news-rd",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TVBS News Rundown AI CLI — query rundowns, candidates, trends, and prompts",
   "type": "module",
   "bin": {