@tvbs-ai/news-rd 0.1.0

package/README.md

@@ -0,0 +1,74 @@
+# @tvbs-ai/news-rd
+
+TVBS News Rundown AI CLI — query rundowns, news candidates, Google Trends, and Langfuse prompts.
+
+## Install
+
+```bash
+npm install -g @tvbs-ai/news-rd
+# or
+npx @tvbs-ai/news-rd --help
+```
+
+## Usage
+
+```bash
+news-rd <group> <command> [args] [options]
+```
+
+### Groups
+
+| Group | Description |
+|-------|-------------|
+| `config` | 時段與環境設定 |
+| `rundown` | Rundown 查詢與版本比對 |
+| `news` | 候選新聞與趨勢關鍵字 |
+| `prompt` | Prompt 模板、變數與編譯 |
+| `token` | JWT Token 管理 |
+
+### Examples
+
+```bash
+# List timeslots
+news-rd config timeslots
+
+# Get rundown
+news-rd rundown get 2026-03-10 0600
+
+# Get news candidates
+news-rd news candidates 2026-03-10 0600 --category 政治
+
+# Get Google Trends
+news-rd news trends 2026-03-10 0600
+
+# List prompts
+news-rd prompt list
+
+# Get compiled prompt
+news-rd prompt compile 2026-03-10 0600
+```
+
+### Global Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--base-url URL` | API base URL | `http://localhost:3000` |
+| `--token TOKEN` | JWT token (or `RD_TOKEN` env) | — |
+| `--json` | Raw JSON output | — |
+| `--help` | Show help | — |
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `RD_BASE_URL` | API base URL |
+| `RD_TOKEN` | JWT authentication token |
+
+## Requirements
+
+- Node.js >= 18 (uses built-in fetch)
+- A running TVBS News Rundown AI server
+
+## License
+
+UNLICENSED

package/dist/cli.js

@@ -0,0 +1,457 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+var args = process.argv.slice(2);
+function parseArgs() {
+  const options = {
+    baseUrl: process.env.RD_BASE_URL || "http://localhost:3000",
+    token: process.env.RD_TOKEN || "",
+    json: false
+  };
+  const positional = [];
+  let group = "";
+  let command = "";
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case "--base-url":
+        options.baseUrl = args[++i] || options.baseUrl;
+        break;
+      case "--token":
+        options.token = args[++i] || "";
+        break;
+      case "--json":
+        options.json = true;
+        break;
+      case "--category":
+        options.category = args[++i];
+        break;
+      case "--content-type":
+        options.contentType = args[++i];
+        break;
+      case "--limit":
+        options.limit = args[++i];
+        break;
+      case "--version":
+        options.version = args[++i];
+        break;
+      case "--variables":
+        options.variables = args[++i];
+        break;
+      case "--help":
+      case "-h":
+        if (group) {
+          showGroupHelp(group);
+        } else {
+          showHelp();
+        }
+        process.exit(0);
+        break;
+      default:
+        if (!group) {
+          group = arg;
+        } else if (!command) {
+          command = arg;
+        } else {
+          positional.push(arg);
+        }
+    }
+  }
+  return { group, command, positional, options };
+}
+function showHelp() {
+  console.log(`
+tvbs-news-rd \u2014 TVBS News Rundown AI CLI
+
+Usage: news-rd <group> <command> [args] [options]
+
+Groups:
+  config     \u6642\u6BB5\u8207\u74B0\u5883\u8A2D\u5B9A
+  rundown    Rundown \u67E5\u8A62\u8207\u7248\u672C\u6BD4\u5C0D
+  news       \u5019\u9078\u65B0\u805E\u8207\u8DA8\u52E2\u95DC\u9375\u5B57
+  prompt     Prompt \u6A21\u677F\u3001\u8B8A\u6578\u8207\u7DE8\u8B6F
+  token      JWT Token \u7BA1\u7406
+
+Global Options:
+  --base-url URL   API base URL (default: http://localhost:3000)
+  --token TOKEN    JWT token (or RD_TOKEN env)
+  --json           Raw JSON output
+  --help, -h       Show help
+
+Run 'news-rd <group> --help' for group-specific commands.
+`);
+}
+var groupHelps = {
+  config: `
+config \u2014 \u6642\u6BB5\u8207\u74B0\u5883\u8A2D\u5B9A
+
+Commands:
+  timeslots    List all available timeslots
+
+Examples:
+  news-rd config timeslots
+`,
+  rundown: `
+rundown \u2014 Rundown \u67E5\u8A62\u8207\u7248\u672C\u6BD4\u5C0D
+
+Commands:
+  get <date> <timeslot>       Get rundown content
+  history <date> <timeslot>   Get version history (initial + edits)
+
+Examples:
+  news-rd rundown get 2026-03-10 0600
+  news-rd rundown history 2026-03-10 0600
+`,
+  news: `
+news \u2014 \u5019\u9078\u65B0\u805E\u8207\u8DA8\u52E2\u95DC\u9375\u5B57
+
+Commands:
+  candidates <date> <timeslot>   Get scored candidates
+  trends <date> <timeslot>       Get Google Trends (4hr/24hr/48hr)
+  keywords <date> <timeslot>     Get NewsRadar hot keywords
+
+Options (candidates):
+  --category CAT        Filter by category (\u653F\u6CBB, \u793E\u6703, \u570B\u969B, ...)
+  --content-type TYPE   Filter by content type (feature, ...)
+  --limit N             Result limit (default 50, max 500)
+
+Examples:
+  news-rd news candidates 2026-03-10 0600 --category \u653F\u6CBB --limit 20
+  news-rd news trends 2026-03-10 0600
+  news-rd news keywords 2026-03-10 0600
+`,
+  prompt: `
+prompt \u2014 Prompt \u6A21\u677F\u3001\u8B8A\u6578\u8207\u7DE8\u8B6F
+
+Commands:
+  list                              List all Langfuse prompts
+  show <name> [--version N]         Get prompt template
+  variables                         List available template variables
+  resolve <date> <timeslot>         Resolve variables to actual values
+  compile <date> <timeslot>         Get fully compiled prompt
+
+Options:
+  --version N          Specific prompt version (show, compile)
+  --variables VARS     Comma-separated variable names (resolve)
+
+Examples:
+  news-rd prompt list
+  news-rd prompt show rundown-generation-0600
+  news-rd prompt show rundown-generation-0600 --version 5
+  news-rd prompt variables
+  news-rd prompt resolve 2026-03-10 0600 --variables GOOGLE_TRENDS_FOUR_HR
+  news-rd prompt compile 2026-03-10 0600
+`,
+  token: `
+token \u2014 JWT Token \u7BA1\u7406
+
+Commands:
+  generate    Generate a new admin JWT token (requires Clerk session)
+
+Examples:
+  news-rd token generate
+`
+};
+function showGroupHelp(group) {
+  const help = groupHelps[group];
+  if (help) {
+    console.log(help);
+  } else {
+    console.error(`Unknown group: ${group}`);
+    showHelp();
+  }
+}
+async function apiCall(path, options, method = "GET") {
+  const url = `${options.baseUrl}/api/admin${path}`;
+  const headers = {};
+  if (options.token) {
+    headers["Authorization"] = `Bearer ${options.token}`;
+  }
+  const response = await fetch(url, { method, headers });
+  const data = await response.json();
+  if (!response.ok) {
+    const errorMsg = data?.error?.message || `HTTP ${response.status}`;
+    throw new Error(`API Error: ${errorMsg}`);
+  }
+  return data;
+}
+function qs(params) {
+  const entries = Object.entries(params).filter(([, v]) => v !== void 0);
+  if (entries.length === 0) return "";
+  return "?" + entries.map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join("&");
+}
+function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+function printTable(rows, columns) {
+  if (rows.length === 0) {
+    console.log("(no results)");
+    return;
+  }
+  const cols = columns || Object.keys(rows[0]);
+  const widths = cols.map(
+    (col) => Math.max(col.length, ...rows.map((r) => String(r[col] ?? "").length))
+  );
+  console.log(cols.map((c, i) => c.padEnd(widths[i])).join("  "));
+  console.log(widths.map((w) => "-".repeat(w)).join("  "));
+  for (const row of rows) {
+    console.log(cols.map((c, i) => String(row[c] ?? "").padEnd(widths[i])).join("  "));
+  }
+}
+function requireDateTimeslot(positional, group, command) {
+  const [date, timeslot] = positional;
+  if (!date || !timeslot) {
+    console.error(`Usage: news-rd ${group} ${command} <date> <timeslot>`);
+    process.exit(1);
+  }
+  return [date, timeslot];
+}
+async function handleConfig(command, _positional, options) {
+  switch (command) {
+    case "timeslots": {
+      const data = await apiCall("/timeslots", options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      printTable(data.timeslots, ["slot_code", "description", "include_google_trends"]);
+      return;
+    }
+    default:
+      showGroupHelp("config");
+      process.exit(1);
+  }
+}
+async function handleRundown(command, positional, options) {
+  switch (command) {
+    case "get": {
+      const [date, timeslot] = requireDateTimeslot(positional, "rundown", "get");
+      const data = await apiCall(`/rundown${qs({ date, timeslot })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Rundown: ${data.rundown_id}`);
+      const items = data.rundown.items || [];
+      console.log(`Items: ${items.length}`);
+      printJson(data);
+      return;
+    }
+    case "history": {
+      const [date, timeslot] = requireDateTimeslot(positional, "rundown", "history");
+      const data = await apiCall(`/rundown/changes${qs({ date, timeslot })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Total changes: ${data.total_changes}
+`);
+      printTable(data.versions.map((v) => ({
+        version: v.version,
+        label: v.label,
+        modified_at: v.modified_at || "-"
+      })), ["version", "label", "modified_at"]);
+      return;
+    }
+    default:
+      showGroupHelp("rundown");
+      process.exit(1);
+  }
+}
+async function handleNews(command, positional, options) {
+  switch (command) {
+    case "candidates": {
+      const [date, timeslot] = requireDateTimeslot(positional, "news", "candidates");
+      const data = await apiCall(`/news/candidates${qs({
+        date,
+        timeslot,
+        category: options.category,
+        content_type: options.contentType,
+        limit: options.limit
+      })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      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"]);
+      return;
+    }
+    case "trends": {
+      const [date, timeslot] = requireDateTimeslot(positional, "news", "trends");
+      const data = await apiCall(`/trends${qs({ date, timeslot })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      for (const [window, trends] of Object.entries(data.google_trends)) {
+        console.log(`
+${window} keywords (${trends.keywords.length}):`);
+        console.log(`  ${trends.keywords.join(", ") || "(none)"}`);
+      }
+      console.log("");
+      return;
+    }
+    case "keywords": {
+      const [date, timeslot] = requireDateTimeslot(positional, "news", "keywords");
+      const data = await apiCall(`/newsradar${qs({ date, timeslot })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Hot keywords (${data.keywords.length}):`);
+      console.log(`  ${data.keywords.join(", ") || "(none)"}`);
+      return;
+    }
+    default:
+      showGroupHelp("news");
+      process.exit(1);
+  }
+}
+async function handlePrompt(command, positional, options) {
+  switch (command) {
+    case "list": {
+      const data = await apiCall("/prompt/list", options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Total: ${data.total}
+`);
+      printTable(data.prompts, ["name", "category", "latest_version", "version_count", "labels"]);
+      return;
+    }
+    case "show": {
+      const name = positional[0];
+      if (!name) {
+        console.error("Usage: news-rd prompt show <name> [--version N]");
+        process.exit(1);
+      }
+      const data = await apiCall(`/prompt/template${qs({ name, version: options.version })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Prompt: ${data.name} (v${data.version})`);
+      console.log(`Labels: ${data.labels?.join(", ") || "(none)"}`);
+      console.log(`Length: ${data.prompt_length} chars`);
+      console.log(`Variables: ${data.variables_in_template.join(", ")}`);
+      console.log(`
+--- Template ---
+${data.template}
+`);
+      return;
+    }
+    case "variables": {
+      const data = await apiCall("/prompt/rundown/variables/available", options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Available variables (${data.total}):
+`);
+      printTable(data.variables, ["name", "value_type", "description"]);
+      return;
+    }
+    case "resolve": {
+      const [date, timeslot] = requireDateTimeslot(positional, "prompt", "resolve");
+      const data = await apiCall(`/prompt/rundown/variables/resolve${qs({
+        date,
+        timeslot,
+        variables: options.variables
+      })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      for (const v of data.resolved) {
+        console.log(`
+${v.name} (${v.value_type}, ${v.value_length} chars${v.item_count !== void 0 ? `, ${v.item_count} items` : ""}):`);
+        const preview = v.value.length > 200 ? v.value.substring(0, 200) + "..." : v.value;
+        console.log(`  ${preview}`);
+      }
+      console.log("");
+      return;
+    }
+    case "compile": {
+      const [date, timeslot] = requireDateTimeslot(positional, "prompt", "compile");
+      const data = await apiCall(`/prompt/rundown/compiled${qs({ date, timeslot, version: options.version })}`, options);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Prompt: ${data.prompt_name} (v${data.prompt_version})`);
+      console.log(`Length: ${data.prompt_length} chars`);
+      console.log(`Variables resolved: ${data.variables_resolved.join(", ")}`);
+      console.log(`Candidates: ${data.candidates_count}`);
+      console.log(`
+--- Compiled Prompt ---
+${data.compiled_prompt}
+`);
+      return;
+    }
+    default:
+      showGroupHelp("prompt");
+      process.exit(1);
+  }
+}
+async function handleToken(command, _positional, options) {
+  switch (command) {
+    case "generate": {
+      const data = await apiCall("/token", options, "POST");
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`Token: ${data.token}`);
+      console.log(`Expires: ${data.expires_at}`);
+      console.log(`
+Set env: export RD_TOKEN="${data.token}"`);
+      return;
+    }
+    default:
+      showGroupHelp("token");
+      process.exit(1);
+  }
+}
+async function main() {
+  const { group, command, positional, options } = parseArgs();
+  if (!group) {
+    showHelp();
+    process.exit(1);
+  }
+  try {
+    switch (group) {
+      case "config":
+        await handleConfig(command, positional, options);
+        break;
+      case "rundown":
+        await handleRundown(command, positional, options);
+        break;
+      case "news":
+        await handleNews(command, positional, options);
+        break;
+      case "prompt":
+        await handlePrompt(command, positional, options);
+        break;
+      case "token":
+        await handleToken(command, positional, options);
+        break;
+      default:
+        console.error(`Unknown group: ${group}`);
+        showHelp();
+        process.exit(1);
+    }
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}
+main();

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@tvbs-ai/news-rd",
+  "version": "0.1.0",
+  "description": "TVBS News Rundown AI CLI — query rundowns, candidates, trends, and prompts",
+  "type": "module",
+  "bin": {
+    "news-rd": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": ["tvbs", "news", "rundown", "ai", "cli"],
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}