persona-test-cli 0.1.3 → 0.1.4

package/README.md

@@ -39,7 +39,7 @@ authorize page loads decides the scope of the issued token.
 | `whoami` | anyone | Show current identity + available commands |
 | `campaigns list/create/edit/link/stats` | anyone | Share links — scoped to your own unless admin |
 | `personas list/create/edit` | anyone | Ad-copy personas — scoped to your own unless admin |
-| `events tail` | anyone | Poll new impression/click events |
+| `events tail` | anyone | Poll new impression/click events (starts from now; `--since <iso>` to replay history first) |
 | `users list/approve/reject` | **admin only** | Registration approval queue |
 
 Run any command with `--help` for its full options and copy-pasteable examples.

package/dist/commands/events.js

@@ -2,8 +2,10 @@ import { apiRequest } from "../http.js";
 import { requireSession } from "../session.js";
 import { jsonMode } from "../output.js";
 import { action } from "../output.js";
+import { fail, EXIT_CODES } from "../errors.js";
 export const EVENTS_TAIL_USAGE = `  persona-test-cli events tail
-  persona-test-cli events tail --slug summer --interval 3`;
+  persona-test-cli events tail --slug summer --interval 3
+  persona-test-cli events tail --since 2026-08-30T00:00:00Z   # 回看历史,再接实时`;
 const TAIL_USAGE = EVENTS_TAIL_USAGE;
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
@@ -12,17 +14,31 @@ export function eventsCommand(program) {
     const cmd = program.command("events").description("查看展示/点击事件");
     cmd
         .command("tail")
-        .description("轮询打印新的展示/点击事件,Ctrl+C 退出")
+        .description("从现在开始轮询打印新的展示/点击事件,Ctrl+C 退出(要回看历史用 --since)")
         .option("--slug <slug>", "只看某条分享链接的事件")
         .option("--interval <seconds>", "轮询间隔秒数", "5")
+        .option("--since <iso>", "从这个 ISO 时间点开始回放,再接实时(默认从启动时刻开始)")
         .option("--base-url <url>")
         .addHelpText("after", `\n示例:\n${TAIL_USAGE}`)
         .action(action(async (opts) => {
         const { baseUrl, token } = requireSession(opts.baseUrl);
         const intervalMs = Math.max(1, Number(opts.interval) || 5) * 1000;
-        let since = new Date(0).toISOString();
+        // Default to "now", not the epoch: `tail` promises *new* events, and
+        // starting at 1970 made the first poll replay up to 50 historical
+        // events before showing anything live.
+        let since = new Date().toISOString();
+        if (opts.since) {
+            const parsed = new Date(opts.since);
+            if (Number.isNaN(parsed.getTime())) {
+                fail(`--since 不是合法的时间: ${opts.since}(用 ISO 格式,如 2026-08-30T00:00:00Z)`, {
+                    exitCode: EXIT_CODES.validation,
+                    usage: TAIL_USAGE,
+                });
+            }
+            since = parsed.toISOString();
+        }
         if (!jsonMode) {
-            console.log(`轮询中(每 ${opts.interval} 秒)... Ctrl+C 退出`);
+            console.log(`轮询中(每 ${opts.interval} 秒)... Ctrl+C 退出${opts.since ? ` — 回放起点 ${since}` : ""}`);
         }
         for (;;) {
             const query = new URLSearchParams({ since, limit: "50" });

package/dist/index.js

@@ -2,7 +2,7 @@
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
-import { Command } from "commander";
+import { Command, CommanderError } from "commander";
 import { registerCommand } from "./commands/register.js";
 import { loginCommand } from "./commands/login.js";
 import { logoutCommand } from "./commands/logout.js";
@@ -12,7 +12,8 @@ import { personasCommand } from "./commands/personas.js";
 import { eventsCommand } from "./commands/events.js";
 import { usersCommand } from "./commands/users.js";
 import { examplesCommand } from "./commands/examples.js";
-import { jsonMode } from "./output.js";
+import { jsonMode, printError } from "./output.js";
+import { CliError, EXIT_CODES } from "./errors.js";
 // Reads package.json's version whether running from source (cli/index.ts,
 // package.json next to it) or from the built dist/index.js (package.json one
 // directory up) — avoids a hardcoded version string drifting from package.json.
@@ -30,6 +31,17 @@ function readVersion() {
 }
 const version = readVersion();
 const program = new Command();
+// Commander hardcodes exit code 1 for every usage/argument problem (missing
+// option, unknown flag, bad value) and writes the message to stderr itself.
+// `examples` documents 3 = 参数校验失败, so take over both halves: exitOverride
+// stops commander calling process.exit(1), and configureOutput silences its
+// stderr write so every error flows through printError() — which honours --json
+// and applies the documented exit code.
+//
+// MUST come before the subcommands are registered: commander copies
+// _exitCallback and _outputConfiguration onto a child at addCommand() time,
+// so declaring this at the bottom leaves every subcommand untouched.
+program.exitOverride().configureOutput({ writeErr: () => { } });
 program
     .name("persona-test-cli")
     .description("persona-test 运维 CLI —— admin 和已审核通过的普通用户都能用,普通用户只能看到/编辑自己创建的 campaigns/personas。\n" +
@@ -57,4 +69,16 @@ personasCommand(program);
 eventsCommand(program);
 usersCommand(program); // [仅 admin] — see the description on each of its subcommands
 examplesCommand(program);
-program.parseAsync(process.argv);
+program.parseAsync(process.argv).catch((err) => {
+    if (err instanceof CommanderError) {
+        // --help / -v travel through the throw path too, but they are normal exits.
+        if (err.code === "commander.helpDisplayed" || err.code === "commander.version")
+            return;
+        // Commander bakes its own "error: " prefix into some messages; printError
+        // adds ours, which would otherwise read "错误: error: unknown command ...".
+        const message = err.message.replace(/^error:\s*/i, "");
+        printError(new CliError(message, { exitCode: EXIT_CODES.validation }));
+        return;
+    }
+    printError(err);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persona-test-cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "运维 CLI for persona-test — admin 和已审核通过的普通用户都能用；设备码浏览器授权登录，管理分享链接(campaigns)和画像(personas)，普通用户只能看到/编辑自己创建的。",
   "type": "module",
   "bin": {