@tvbs-ai/news-rd 0.1.0 → 0.1.2

package/README.md

@@ -52,7 +52,7 @@ news-rd prompt compile 2026-03-10 0600
 
 | Option | Description | Default |
 |--------|-------------|---------|
-| `--base-url URL` | API base URL | `http://localhost:3000` |
+| `--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 | — |
@@ -69,6 +69,10 @@ news-rd prompt compile 2026-03-10 0600
 - Node.js >= 18 (uses built-in fetch)
 - A running TVBS News Rundown AI server
 
+## Publishing
+
+See [CLI 發佈指南](../../docs/cli-publishing.md) for version bumping and npm publishing workflow.
+
 ## License
 
 UNLICENSED

package/dist/cli.js

@@ -4,7 +4,7 @@
 var args = process.argv.slice(2);
 function parseArgs() {
   const options = {
-    baseUrl: process.env.RD_BASE_URL || "http://localhost:3000",
+    baseUrl: process.env.RD_BASE_URL || "https://news-rundown.tvbs.ai",
     token: process.env.RD_TOKEN || "",
     json: false
   };
@@ -73,7 +73,7 @@ Groups:
   token      JWT Token \u7BA1\u7406
 
 Global Options:
-  --base-url URL   API base URL (default: http://localhost:3000)
+  --base-url URL   API base URL (default: https://news-rundown.tvbs.ai)
   --token TOKEN    JWT token (or RD_TOKEN env)
   --json           Raw JSON output
   --help, -h       Show help
@@ -167,10 +167,71 @@ async function apiCall(path, options, method = "GET") {
   if (options.token) {
     headers["Authorization"] = `Bearer ${options.token}`;
   }
-  const response = await fetch(url, { method, headers });
+  let response;
+  try {
+    response = await fetch(url, { method, headers });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed")) {
+      console.error(`
+  Cannot connect to ${options.baseUrl}`);
+      console.error(`  Make sure the server is running, or set a different URL:
+`);
+      console.error(`    news-rd --base-url https://your-server ${path.replace(/^\//, "")}`);
+      console.error(`    # or`);
+      console.error(`    export RD_BASE_URL=https://your-server
+`);
+    } else {
+      console.error(`
+  Connection error: ${msg}
+`);
+    }
+    process.exit(1);
+  }
+  const contentType = response.headers.get("content-type") || "";
+  if (!contentType.includes("application/json")) {
+    if (response.status === 404) {
+      console.error(`
+  Endpoint not found: ${url}`);
+      console.error(`  The server may not have the Admin API deployed yet.
+`);
+    } else if (response.status >= 500) {
+      console.error(`
+  Server error (${response.status}) from ${options.baseUrl}`);
+      console.error(`  The server may be starting up or experiencing issues.
+`);
+    } else {
+      console.error(`
+  Unexpected response from ${options.baseUrl} (HTTP ${response.status})`);
+      console.error(`  Expected JSON but received ${contentType || "unknown content type"}.`);
+      console.error(`  Make sure the URL points to a News Rundown AI server.
+`);
+    }
+    process.exit(1);
+  }
   const data = await response.json();
   if (!response.ok) {
+    const errorCode = data?.error?.code;
     const errorMsg = data?.error?.message || `HTTP ${response.status}`;
+    if (response.status === 401) {
+      console.error(`
+  Authentication required.`);
+      if (errorCode === "UNAUTHORIZED") {
+        console.error(`  Set your token to access the API:
+`);
+        console.error(`    news-rd --token YOUR_TOKEN ${path.replace(/^\//, "")}`);
+        console.error(`    # or`);
+        console.error(`    export RD_TOKEN=YOUR_TOKEN
+`);
+        console.error(`  To generate a token, log in to the web UI and click "API Token",`);
+        console.error(`  or run: news-rd token generate (requires Clerk session).
+`);
+      } else {
+        console.error(`  ${errorMsg}
+`);
+      }
+      process.exit(1);
+    }
     throw new Error(`API Error: ${errorMsg}`);
   }
   return data;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tvbs-ai/news-rd",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TVBS News Rundown AI CLI — query rundowns, candidates, trends, and prompts",
   "type": "module",
   "bin": {
@@ -16,7 +16,13 @@
     "lint": "tsc --noEmit",
     "prepublishOnly": "pnpm build"
   },
-  "keywords": ["tvbs", "news", "rundown", "ai", "cli"],
+  "keywords": [
+    "tvbs",
+    "news",
+    "rundown",
+    "ai",
+    "cli"
+  ],
   "license": "UNLICENSED",
   "engines": {
     "node": ">=18.0.0"