@getrouter/getrouter-cli 0.1.0

package/docs/plans/2026-01-03-bun-migration-plan.md

@@ -0,0 +1,103 @@
+# Bun Migration Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Make Bun the default package manager/tooling for the repo, remove npm lockfile, and add Bun-based CI.
+
+**Architecture:** Replace npm usage with Bun in docs and CI, generate `bun.lock`, add `packageManager` in `package.json`, and delete `package-lock.json`.
+
+**Tech Stack:** Bun, GitHub Actions, TypeScript.
+
+### Task 1: Switch lockfile + package metadata
+
+**Files:**
+- Modify: `package.json`
+- Delete: `package-lock.json`
+- Create: `bun.lock`
+
+**Step 1: Add Bun packageManager field**
+
+Edit `package.json`:
+```json
+"packageManager": "bun@1.3.5"
+```
+
+**Step 2: Remove npm lockfile**
+
+Delete `package-lock.json`.
+
+**Step 3: Generate Bun lockfile**
+
+Run:
+```bash
+bun install
+```
+Expected: `bun.lock` created.
+
+### Task 2: Update contributor docs to Bun
+
+**Files:**
+- Modify: `README.md`
+- Modify: `AGENTS.md`
+
+**Step 1: Update README install/dev/test commands (English + Chinese)**
+
+Examples:
+```md
+bun install
+bun run build
+bun run dev -- --help
+bun run test
+bun run typecheck
+```
+
+**Step 2: Update AGENTS build/test commands to Bun**
+
+Replace `npm` commands with `bun run` equivalents.
+
+### Task 3: Add Bun-based GitHub Actions
+
+**Files:**
+- Create: `.github/workflows/ci.yml`
+
+**Step 1: Add CI workflow**
+
+```yaml
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: "1.3.5"
+      - run: bun install --frozen-lockfile
+      - run: bun run typecheck
+      - run: bun run test
+      - run: bun run build
+```
+
+### Task 4: Verify and commit
+
+**Step 1: Run Bun checks locally**
+
+Run:
+```bash
+bun run typecheck
+bun run test
+```
+Expected: PASS.
+
+**Step 2: Commit**
+
+```bash
+git add package.json bun.lock README.md AGENTS.md .github/workflows/ci.yml
+git rm package-lock.json
+git commit -m "chore: migrate tooling to bun"
+```

package/docs/plans/2026-01-03-cli-emoji-output.md

@@ -0,0 +1,45 @@
+# CLI Emoji Output Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Add minimal emoji to interactive prompts and key status messages (login + confirmation) while keeping errors plain.
+
+**Architecture:** Update user-facing string literals in auth flow and interactive key prompts; adjust tests to match new output.
+
+**Tech Stack:** TypeScript, Vitest.
+
+### Task 1: Add emoji to interactive/auth output strings
+
+**Files:**
+- Modify: `src/cmd/auth.ts`
+- Modify: `src/core/interactive/keys.ts`
+
+**Step 1: Update auth login output**
+
+```ts
+console.log("🔐 To authenticate, visit:");
+console.log("⏳ Waiting for confirmation...");
+console.log("✅ Login successful.");
+```
+
+**Step 2: Update key selection/delete prompts**
+
+```ts
+throw new Error("No available API keys");
+message: "🔎 Select an API key",
+message: `⚠️ Confirm delete ${name} (${id})?`,
+```
+
+### Task 2: Verify and commit
+
+**Step 1: Run targeted tests**
+
+Run: `npm test -- tests/cmd/auth.test.ts tests/cmd/keys.test.ts`
+Expected: PASS. (No test updates expected; update assertions only if failures mention output strings.)
+
+**Step 2: Commit**
+
+```bash
+git add src tests
+ git commit -m "feat: add emoji to interactive cli output"
+```

package/docs/plans/2026-01-03-cli-english-output.md

@@ -0,0 +1,123 @@
+# CLI English Output Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Replace all Chinese CLI user-facing strings with English equivalents and update tests.
+
+**Architecture:** Update string literals in command handlers and interactive prompts, then update test expectations to match.
+
+**Tech Stack:** TypeScript, Vitest.
+
+### Task 1: Update CLI output strings in source
+
+**Files:**
+- Modify: `src/cmd/auth.ts`
+- Modify: `src/core/auth/device.ts`
+- Modify: `src/cmd/keys.ts`
+- Modify: `src/cmd/subscription.ts`
+- Modify: `src/cmd/setup.ts`
+- Modify: `src/core/interactive/keys.ts`
+
+**Step 1: Update auth command output**
+
+```ts
+console.log("Login successful.");
+console.log("Cleared local auth data.");
+```
+
+**Step 2: Update device auth error messages**
+
+```ts
+throw new Error("Auth code already used. Please log in again.");
+throw new Error("Auth code expired. Please log in again.");
+throw new Error("Login timed out. Please run getrouter auth login again.");
+```
+
+**Step 3: Update keys command errors and success message**
+
+```ts
+throw new Error("Missing key id.");
+console.log("Please store this API key securely.");
+```
+
+**Step 4: Update subscription status message**
+
+```ts
+console.log("No active subscription");
+```
+
+**Step 5: Update setup errors**
+
+```ts
+throw new Error("Missing key id.");
+throw new Error("API key not found. Please create one or choose another.");
+```
+
+**Step 6: Update interactive prompts**
+
+```ts
+throw new Error("No available API keys");
+message: "Select an API key",
+message: `Confirm delete ${name} (${id})?`,
+```
+
+### Task 2: Update test expectations
+
+**Files:**
+- Modify: `tests/auth/device.test.ts`
+- Modify: `tests/cmd/setup.test.ts`
+- Modify: `tests/cmd/subscription.test.ts`
+- Modify: `tests/cmd/auth.test.ts`
+- Modify: `tests/cmd/keys.test.ts`
+
+**Step 1: Update device auth error assertions**
+
+```ts
+).rejects.toThrow("Auth code already used");
+).rejects.toThrow("Auth code expired");
+).rejects.toThrow("Login timed out");
+```
+
+**Step 2: Update setup error assertion**
+
+```ts
+).rejects.toThrow("Missing key id");
+```
+
+**Step 3: Update subscription output assertion**
+
+```ts
+expect(output).toContain("No active subscription");
+```
+
+**Step 4: Update auth logout output assertion**
+
+```ts
+expect(log.mock.calls[0][0]).toContain("Cleared local auth data");
+```
+
+**Step 5: Update keys output/error assertions**
+
+```ts
+expect(output).toContain("Please store this API key securely.");
+).rejects.toThrow("Missing key id");
+```
+
+### Task 3: Verify and commit
+
+**Step 1: Confirm no Chinese text remains in src/tests**
+
+Run: `rg -n "[\u4e00-\u9fff]" src tests`
+Expected: no matches.
+
+**Step 2: Run targeted tests**
+
+Run: `npm test -- tests/auth/device.test.ts tests/cmd/auth.test.ts tests/cmd/keys.test.ts tests/cmd/setup.test.ts tests/cmd/subscription.test.ts`
+Expected: PASS.
+
+**Step 3: Commit**
+
+```bash
+git add src tests
+git commit -m "refactor: switch cli output to English"
+```

package/docs/plans/2026-01-03-cli-simplify-design.md

@@ -0,0 +1,62 @@
+# CLI 简化方案设计
+
+## 目标
+- 将 CLI 命令体系简化为一级命令，替换原有二级命令（auth/keys/subscription/setup 等）。
+- 输出美化，必要时使用 emoji，保留一致性与可读性。
+- 兼容新的 usages API，并提供最近 7 天聚合可视化。
+
+## 命令体系
+- `getrouter login` / `getrouter logout`
+  - 替代 `getrouter auth login/logout`。
+- `getrouter keys`
+  - 进入交互菜单，支持：列表 / 查看 / 创建 / 更新 / 删除 / 退出。
+  - 删除需 y/N 二次确认；完成某操作后回到菜单。
+- `getrouter usages`
+  - 默认展示最近 7 天按天聚合使用量，堆叠柱状图 + 表格。
+- `getrouter status`
+  - 统一展示登录状态 + 订阅状态。
+  - 登录仅显示状态与过期时间，不展示 token。
+- `getrouter codex` / `getrouter claude`
+  - 取代 `setup env`，仅保留 `--install`。
+  - codex 只写 OpenAI 变量，claude 只写 Anthropic 变量。
+  - 多 key 时进入交互选择。
+- `getrouter config`
+  - 简化为：`getrouter config` 显示全部；`getrouter config <key> <value>` 设置。
+  - 去掉 `--json`。
+
+移除：`models/plans/providers/user/setup` 以及旧的二级命令入口。
+
+## 输出与交互
+### status
+- 以“状态卡片”风格输出两块：登录状态 + 订阅状态。
+- 登录块：status + expiresAt（不显示 token）。
+- 订阅块：plan / status / startAt / endAt / requestPerMinute / tokenPerMinute。
+- 无订阅时提示“无有效订阅”。
+
+### usages
+- 接口：`GET v1/dashboard/usages`（pageSize/pageToken）。
+- 拉取策略：逐页拉取，按本地时区聚合日期，直到 7 天或数据耗尽。
+- 输出包含：
+  1) 堆叠柱状图（默认显示，input/output 分段）
+  2) 表格（日、input/output/total tokens、请求数若可得）
+- 不区分 TTY/管道，默认都显示图 + 表。
+
+### keys
+- 交互菜单：列表 / 查看 / 创建 / 更新 / 删除 / 退出。
+- 查看/删除：无 id 时进入选择列表。
+- 更新仅支持 `name` 和 `enabled`。
+- 删除需 y/N 确认。
+
+## 环境配置（codex/claude）
+- 仅保留 `--install`。
+- 写入 `~/.getrouter/env.sh` 或 `env.ps1`，Base URL 固定 `https://api.getrouter.dev/v1`。
+- `--install` 时：
+  - 自动判断 shell（zsh/bash/fish/pwsh）写入 rc。
+  - **立即生效策略**：
+    1) 更新当前 CLI 进程的 `process.env`；
+    2) best‑effort 执行一次 `source` / `. <path>`（PowerShell 使用 `. <path>`）。
+  - 若 source 失败，提示用户手动执行。
+
+## 实现注意
+- `usages` 需要更新 CLI 的生成代码以引入 `UsageService`。
+- 新命令与输出均移除 `--json` 选项，仅保留美化输出。