@getrouter/getrouter-cli 0.1.0

package/docs/plans/2026-01-02-getrouter-cli-keys-create-update-output-plan.md

@@ -0,0 +1,141 @@
+# Keys Create/Update Table Output Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Change `keys create` and `keys update` default output to a single-row table matching `keys list/get`, while keeping JSON output unchanged and preserving the create reminder line.
+
+**Architecture:** Reuse the existing consumer table helper in `cmd/keys` and route non-JSON create/update output through that table renderer. Keep `--json` behavior intact and preserve the post-create reminder line.
+
+**Tech Stack:** TypeScript, Commander, Vitest.
+
+**Skills:** @superpowers:test-driven-development, @superpowers:systematic-debugging (if failures)
+
+### Task 1: Add failing tests for create/update table output
+
+**Files:**
+- Modify: `tests/cmd/keys.test.ts`
+
+**Step 1: Write the failing tests**
+
+```ts
+it("create prints table header and reminder in default mode", async () => {
+  (createApiClients as unknown as ReturnType<typeof vi.fn>).mockReturnValue({
+    consumerService: {
+      CreateConsumer: vi.fn().mockResolvedValue(mockConsumer),
+      UpdateConsumer: vi.fn().mockResolvedValue(mockConsumer),
+    },
+    subscriptionService: {} as any,
+  });
+  const log = vi.spyOn(console, "log").mockImplementation(() => {});
+  const program = createProgram();
+  await program.parseAsync([
+    "node",
+    "getrouter",
+    "keys",
+    "create",
+    "--name",
+    "dev",
+  ]);
+  const output = log.mock.calls.map((c) => c[0]).join("\n");
+  expect(output).toContain("ID");
+  expect(output).toContain("NAME");
+  expect(output).toContain("API_KEY");
+  expect(output).toContain("请妥善保存 API Key。");
+  log.mockRestore();
+});
+
+it("update prints table header in default mode", async () => {
+  (createApiClients as unknown as ReturnType<typeof vi.fn>).mockReturnValue({
+    consumerService: {
+      UpdateConsumer: vi.fn().mockResolvedValue(mockConsumer),
+    },
+    subscriptionService: {} as any,
+  });
+  const log = vi.spyOn(console, "log").mockImplementation(() => {});
+  const program = createProgram();
+  await program.parseAsync([
+    "node",
+    "getrouter",
+    "keys",
+    "update",
+    "c1",
+    "--name",
+    "dev",
+  ]);
+  const output = log.mock.calls.map((c) => c[0]).join("\n");
+  expect(output).toContain("ID");
+  expect(output).toContain("NAME");
+  expect(output).toContain("API_KEY");
+  log.mockRestore();
+});
+```
+
+**Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/cmd/keys.test.ts`
+
+Expected: FAIL because create/update currently output key=value lines.
+
+**Step 3: Commit the failing tests**
+
+```bash
+git add tests/cmd/keys.test.ts
+git commit -m "test: cover keys create/update table output"
+```
+
+### Task 2: Render create/update output using table helper
+
+**Files:**
+- Modify: `src/cmd/keys.ts`
+- Test: `tests/cmd/keys.test.ts`
+
+**Step 1: Route non-JSON create/update to table output**
+
+```ts
+// In create
+if (shouldJson(options)) {
+  outputConsumer(output, true);
+} else {
+  outputConsumerTable(output);
+  console.log("请妥善保存 API Key。");
+}
+
+// In update
+if (shouldJson(options)) {
+  outputConsumer(output, true);
+} else {
+  outputConsumerTable(output);
+}
+```
+
+**Step 2: Run tests to verify pass**
+
+Run: `npm test -- tests/cmd/keys.test.ts`
+
+Expected: PASS
+
+**Step 3: Commit**
+
+```bash
+git add src/cmd/keys.ts tests/cmd/keys.test.ts
+git commit -m "feat: render keys create/update output as table"
+```
+
+### Task 3: Full test run
+
+**Files:**
+- None
+
+**Step 1: Run full test suite**
+
+Run: `npm test`
+
+Expected: PASS
+
+**Step 2: Commit (if needed)**
+
+```bash
+git status -sb
+```
+
+If clean, no commit needed.

package/docs/plans/2026-01-02-getrouter-cli-keys-delete-output-design.md

@@ -0,0 +1,22 @@
+# getrouter CLI Keys delete 表格输出设计
+
+日期：2026-01-02  
+状态：已确认
+
+## 目标
+- `keys delete` 默认输出改为表格，与其它 `keys` 命令风格一致。
+- `--json` 行为不变。
+
+## 输出格式
+- 列顺序：`ID | NAME | ENABLED | LAST_ACCESS | CREATED_AT | API_KEY`
+- 单行表格：表头 + 1 行数据。
+- 仅填充 `ID`，其余字段为空（表格显示为 `-`）。
+
+## 行为细节
+- 默认人类可读：表格输出。
+- `--json`：输出 `{ deleted: true, id }`。
+- 不再输出 `deleted=true` / `id=...` 的 key=value 形式。
+
+## 测试策略
+- `keys delete` 默认输出包含表头并包含 `ID` 值。
+- `--json` 输出结构不变。

package/docs/plans/2026-01-02-getrouter-cli-keys-delete-output-plan.md

@@ -0,0 +1,122 @@
+# Keys Delete Table Output Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Change `keys delete` default output to the standard keys table while keeping JSON output unchanged.
+
+**Architecture:** Reuse the existing keys table helpers in `cmd/keys` and render a single-row table with only `id` populated. Preserve `{ deleted: true, id }` for `--json` output.
+
+**Tech Stack:** TypeScript, Commander, Vitest.
+
+**Skills:** @superpowers:test-driven-development, @superpowers:systematic-debugging (if failures)
+
+### Task 1: Add failing tests for delete table output
+
+**Files:**
+- Modify: `tests/cmd/keys.test.ts`
+
+**Step 1: Write the failing tests**
+
+```ts
+it("delete prints table header and id in default mode", async () => {
+  (createApiClients as unknown as ReturnType<typeof vi.fn>).mockReturnValue({
+    consumerService: {
+      DeleteConsumer: vi.fn().mockResolvedValue({}),
+    },
+    subscriptionService: {} as any,
+  });
+  const log = vi.spyOn(console, "log").mockImplementation(() => {});
+  const program = createProgram();
+  await program.parseAsync(["node", "getrouter", "keys", "delete", "c1"]);
+  const output = log.mock.calls.map((c) => c[0]).join("\n");
+  expect(output).toContain("ID");
+  expect(output).toContain("API_KEY");
+  expect(output).toContain("c1");
+  log.mockRestore();
+});
+
+it("delete outputs json when --json is set", async () => {
+  (createApiClients as unknown as ReturnType<typeof vi.fn>).mockReturnValue({
+    consumerService: {
+      DeleteConsumer: vi.fn().mockResolvedValue({}),
+    },
+    subscriptionService: {} as any,
+  });
+  const log = vi.spyOn(console, "log").mockImplementation(() => {});
+  const program = createProgram();
+  await program.parseAsync([
+    "node",
+    "getrouter",
+    "keys",
+    "delete",
+    "c1",
+    "--json",
+  ]);
+  const payload = JSON.parse(log.mock.calls[0][0]);
+  expect(payload.deleted).toBe(true);
+  expect(payload.id).toBe("c1");
+  log.mockRestore();
+});
+```
+
+**Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/cmd/keys.test.ts`
+
+Expected: FAIL because delete currently prints key=value lines.
+
+**Step 3: Commit the failing tests**
+
+```bash
+git add tests/cmd/keys.test.ts
+git commit -m "test: cover keys delete table output"
+```
+
+### Task 2: Render delete output using table helper
+
+**Files:**
+- Modify: `src/cmd/keys.ts`
+- Test: `tests/cmd/keys.test.ts`
+
+**Step 1: Route non-JSON delete output to table renderer**
+
+```ts
+// In delete
+if (shouldJson(options)) {
+  console.log(JSON.stringify({ deleted: true, id }, null, 2));
+} else {
+  outputConsumerTable({ id });
+}
+```
+
+**Step 2: Run tests to verify pass**
+
+Run: `npm test -- tests/cmd/keys.test.ts`
+
+Expected: PASS
+
+**Step 3: Commit**
+
+```bash
+git add src/cmd/keys.ts tests/cmd/keys.test.ts
+git commit -m "feat: render keys delete output as table"
+```
+
+### Task 3: Full test run
+
+**Files:**
+- None
+
+**Step 1: Run full test suite**
+
+Run: `npm test`
+
+Expected: PASS
+
+**Step 2: Commit (if needed)**
+
+```bash
+git status -sb
+```
+
+If clean, no commit needed.

package/docs/plans/2026-01-02-getrouter-cli-keys-get-output-design.md

@@ -0,0 +1,23 @@
+# getrouter CLI Keys get 表格输出设计
+
+日期：2026-01-02  
+状态：已确认
+
+## 目标
+- `keys get <id>` 默认输出改为单行表格，与 `keys list` 同列顺序。
+- `--json` 行为不变；`apiKey` 默认脱敏。
+
+## 输出格式
+- 列顺序：`ID | NAME | ENABLED | LAST_ACCESS | CREATED_AT | API_KEY`
+- 单行表格：表头 + 1 行数据。
+- 空值显示 `-`；超长字段按 `renderTable` 规则截断。
+
+## 行为细节
+- 默认人类可读：表格输出。
+- `--json`：输出完整对象（脱敏或明文由 `--show-secret` 决定）。
+- 其它命令输出暂不改变（create/update 保持 key=value）。
+
+## 测试策略
+- `keys get` 默认输出包含表头与列顺序。
+- `apiKey` 仍为脱敏值（前 4 后 4）。
+

package/docs/plans/2026-01-02-getrouter-cli-keys-get-output-plan.md

@@ -0,0 +1,141 @@
+# getrouter CLI Keys get Table Output Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Change `keys get <id>` default output to a single-row table matching `keys list` while keeping JSON output unchanged.
+
+**Architecture:** Reuse the existing table renderer by adding a shared row/headers helper for consumers, then route `keys get` non-JSON output through the table path without altering create/update behavior.
+
+**Tech Stack:** TypeScript, Commander, Vitest.
+
+**Skills:** @superpowers:test-driven-development, @superpowers:systematic-debugging (if failures)
+
+### Task 1: Add failing test for `keys get` default table output
+
+**Files:**
+- Modify: `tests/cmd/keys.test.ts`
+
+**Step 1: Write the failing test**
+
+```ts
+it("get prints table header and redacts apiKey in default mode", async () => {
+  (createApiClients as unknown as ReturnType<typeof vi.fn>).mockReturnValue({
+    consumerService: {
+      GetConsumer: vi.fn().mockResolvedValue(mockConsumer),
+    },
+    subscriptionService: {} as any,
+  });
+  const log = vi.spyOn(console, "log").mockImplementation(() => {});
+  const program = createProgram();
+  await program.parseAsync(["node", "getrouter", "keys", "get", "c1"]);
+  const output = log.mock.calls.map((c) => c[0]).join("\n");
+  expect(output).toContain("ID");
+  expect(output).toContain("NAME");
+  expect(output).toContain("ENABLED");
+  expect(output).toContain("LAST_ACCESS");
+  expect(output).toContain("CREATED_AT");
+  expect(output).toContain("API_KEY");
+  expect(output).toContain("abcd...WXYZ");
+  log.mockRestore();
+});
+```
+
+**Step 2: Run test to verify it fails**
+
+Run: `npm test -- tests/cmd/keys.test.ts`
+
+Expected: FAIL because `keys get` currently prints key=value lines instead of a table.
+
+**Step 3: Commit the failing test**
+
+```bash
+git add tests/cmd/keys.test.ts
+git commit -m "test: cover keys get table output"
+```
+
+### Task 2: Render `keys get` with table output
+
+**Files:**
+- Modify: `src/cmd/keys.ts`
+- Test: `tests/cmd/keys.test.ts`
+
+**Step 1: Implement shared headers/row helper**
+
+```ts
+const consumerHeaders = [
+  "ID",
+  "NAME",
+  "ENABLED",
+  "LAST_ACCESS",
+  "CREATED_AT",
+  "API_KEY",
+];
+
+const consumerRow = (consumer: any) => [
+  String(consumer.id ?? ""),
+  String(consumer.name ?? ""),
+  String(consumer.enabled ?? ""),
+  String(consumer.lastAccess ?? ""),
+  String(consumer.createdAt ?? ""),
+  String(consumer.apiKey ?? ""),
+];
+```
+
+**Step 2: Use table output for `keys get` only**
+
+```ts
+const outputConsumerTable = (consumer: any) =>
+  console.log(renderTable(consumerHeaders, [consumerRow(consumer)]));
+
+// In keys get
+if (shouldJson(options)) {
+  outputConsumer(output, true);
+} else {
+  outputConsumerTable(output);
+}
+```
+
+**Step 3: Keep list output using the same helpers**
+
+```ts
+const outputConsumers = (consumers: any[], json: boolean) => {
+  if (json) {
+    console.log(JSON.stringify({ consumers }, null, 2));
+    return;
+  }
+  const rows = consumers.map(consumerRow);
+  console.log(renderTable(consumerHeaders, rows));
+};
+```
+
+**Step 4: Run tests to verify pass**
+
+Run: `npm test -- tests/cmd/keys.test.ts`
+
+Expected: PASS
+
+**Step 5: Commit**
+
+```bash
+git add src/cmd/keys.ts tests/cmd/keys.test.ts
+git commit -m "feat: render keys get output as table"
+```
+
+### Task 3: Full test run
+
+**Files:**
+- None
+
+**Step 1: Run full test suite**
+
+Run: `npm test`
+
+Expected: PASS
+
+**Step 2: Commit (if needed)**
+
+```bash
+git status -sb
+```
+
+If clean, no commit needed.

package/docs/plans/2026-01-02-getrouter-cli-keys-interactive-design.md

@@ -0,0 +1,28 @@
+# getrouter CLI Keys 交互式选择设计
+
+日期：2026-01-02  
+状态：已确认
+
+## 目标
+- `keys get/update/delete` 在未传 `id` 时进入交互式选择（上下键选择）。
+- 非交互环境未传 `id` 时报错提示缺少 `id`。
+
+## 交互行为
+- 触发条件：`keys get/update/delete` 未传 `id`。
+- 非交互（stdin 非 TTY）：直接报错“缺少 id”（提示可传 `id`）。
+- `keys delete`：选择后二次确认（Y/N）再执行删除。
+- `keys get/update`：选择后直接执行。
+- `--json` 输出保持不变。
+
+## 列表显示与排序
+- 显示字段：`NAME (ID)` + `ENABLED` + `CREATED_AT`。
+- 排序：按 `CREATED_AT` 倒序（最新在前）。
+
+## 错误处理
+- 无可选 key：提示“没有可用的 API key”。
+- 401/403：沿用现有鉴权提示。
+
+## 测试策略
+- 未传 `id` 时进入选择流程（mock 选择返回）。
+- 非交互且未传 `id` 时抛错。
+- `keys delete` 需确认后才调用删除。