opencode-account-manager 0.6.4 → 0.6.5

package/docs/ROADMAP.md

@@ -1,125 +1,143 @@
-# OpenCode Account Manager - Roadmap
-
-## Version History
-
-### v0.1.0 - Initial Release
-- [x] Basic TUI dashboard
-- [x] View accounts from antigravity-auth plugin
-- [x] Show rate limit status per account
-- [x] Import from Antigravity Manager folder
-
-### v0.2.0 - Account Management
-- [x] Select mode with keyboard navigation
-- [x] Enable/Disable selected accounts
-- [x] Delete selected accounts
-- [x] Export selected accounts to JSON
-- [x] Per-model rate limit display (claude, gemini, etc.)
-
-### v0.3.0 - OpenCode Dashboard
-- [x] Rename to opencode-account-manager
-- [x] Read opencode.json config
-- [x] Display all AI providers with model counts
-- [x] Display MCP servers with enabled/disabled status
-- [x] Tab navigation between sections (Providers, Accounts, MCP)
-- [x] Collapsible sections
-
-### v0.4.0 - Encrypted Export/Import
-- [x] **Encrypted Export** - AES-256-GCM with password protection
-- [x] **Plain JSON Export** - Keep original format as option
-- [x] **File Browser UI** - Browse folders, quick locations, paste path
-- [x] **Import from File** - Select .ocam or .json files
-- [x] **Password Input** - Masked input with confirmation
-- [x] **Remember Preferences** - Last export/import folder saved
-- [x] **Overwrite Mode** - Replace existing accounts on import
-
-### v0.4.1 - npm Publish
-- [x] Published to npm registry
-- [x] Global install via `npm install -g opencode-account-manager`
-- [x] Commands: `ocam`, `opencode-account-manager`
-
-### v0.4.2 - Antigravity Manager Export Support
-- [x] **AM Export Import** - Support `[{email, refresh_token}]` format
-- [x] **Auto-detect Format** - Recognize encrypted, portable, AM export formats
-- [x] **Format Preview** - Show detected format in import preview
-- [x] **Professional README** - Updated documentation with LLM installation guide
-
-### v0.4.3 - Keyboard Navigation Fix
-- [x] **Number Keys** - Press 1/2/3 to switch sections (Providers/Accounts/MCP)
-- [x] **Tab Navigation** - Fixed Tab key to cycle through sections
-- [x] **UI Indicator** - Show `[1] Providers [2] Accounts [3] MCP` in header
-
-### v0.4.4 - Arrow Key Navigation
-- [x] **←→ Arrow Keys** - Switch between sections (Providers ↔ Accounts ↔ MCP)
-- [x] **↑↓ Arrow Keys** - Navigate account list, auto-enters select mode
-- [x] **Space Key** - Toggle selection in select mode
-- [x] **Updated Help Text** - Show arrow key hints in UI
-
-### v0.5.0 - OpenCode-style UX
-- [x] **Action Palette** - Press P to open command palette (like OpenCode Ctrl+P)
-- [x] **Unified Navigation** - ↑↓ to navigate everything, Enter to expand/select
-- [x] **Simplified Controls** - No more complex keyboard shortcuts to remember
-- [x] **Inline Selection** - Space to toggle, selection count shown in help bar
-- [x] **Removed MenuBar** - Clean minimal interface
-
-### v0.5.1 - Dashboard Tab
-- [x] **Two Tabs** - Dashboard (rate limits) + Settings (providers, accounts, MCP)
-- [x] **Tab Switching** - Press Tab to switch between Dashboard and Settings
-- [x] **Rate Limit View** - Like Antigravity Manager, shows accounts with model limits
-- [x] **Progress Bars** - Visual indicator of rate limit status per model
-- [x] **Time Remaining** - Shows hours/minutes until limit resets
-
-### v0.5.2 - Loading Indicator (Current)
+# OpenCode Account Manager - Roadmap
+
+## Version History
+
+### v0.1.0 - Initial Release
+- [x] Basic TUI dashboard
+- [x] View accounts from antigravity-auth plugin
+- [x] Show rate limit status per account
+- [x] Import from Antigravity Manager folder
+
+### v0.2.0 - Account Management
+- [x] Select mode with keyboard navigation
+- [x] Enable/Disable selected accounts
+- [x] Delete selected accounts
+- [x] Export selected accounts to JSON
+- [x] Per-model rate limit display (claude, gemini, etc.)
+
+### v0.3.0 - OpenCode Dashboard
+- [x] Rename to opencode-account-manager
+- [x] Read opencode.json config
+- [x] Display all AI providers with model counts
+- [x] Display MCP servers with enabled/disabled status
+- [x] Tab navigation between sections (Providers, Accounts, MCP)
+- [x] Collapsible sections
+
+### v0.4.0 - Encrypted Export/Import
+- [x] **Encrypted Export** - AES-256-GCM with password protection
+- [x] **Plain JSON Export** - Keep original format as option
+- [x] **File Browser UI** - Browse folders, quick locations, paste path
+- [x] **Import from File** - Select .ocam or .json files
+- [x] **Password Input** - Masked input with confirmation
+- [x] **Remember Preferences** - Last export/import folder saved
+- [x] **Overwrite Mode** - Replace existing accounts on import
+
+### v0.4.1 - npm Publish
+- [x] Published to npm registry
+- [x] Global install via `npm install -g opencode-account-manager`
+- [x] Commands: `ocam`, `opencode-account-manager`
+
+### v0.4.2 - Antigravity Manager Export Support
+- [x] **AM Export Import** - Support `[{email, refresh_token}]` format
+- [x] **Auto-detect Format** - Recognize encrypted, portable, AM export formats
+- [x] **Format Preview** - Show detected format in import preview
+- [x] **Professional README** - Updated documentation with LLM installation guide
+
+### v0.4.3 - Keyboard Navigation Fix
+- [x] **Number Keys** - Press 1/2/3 to switch sections (Providers/Accounts/MCP)
+- [x] **Tab Navigation** - Fixed Tab key to cycle through sections
+- [x] **UI Indicator** - Show `[1] Providers [2] Accounts [3] MCP` in header
+
+### v0.4.4 - Arrow Key Navigation
+- [x] **←→ Arrow Keys** - Switch between sections (Providers ↔ Accounts ↔ MCP)
+- [x] **↑↓ Arrow Keys** - Navigate account list, auto-enters select mode
+- [x] **Space Key** - Toggle selection in select mode
+- [x] **Updated Help Text** - Show arrow key hints in UI
+
+### v0.5.0 - OpenCode-style UX
+- [x] **Action Palette** - Press P to open command palette (like OpenCode Ctrl+P)
+- [x] **Unified Navigation** - ↑↓ to navigate everything, Enter to expand/select
+- [x] **Simplified Controls** - No more complex keyboard shortcuts to remember
+- [x] **Inline Selection** - Space to toggle, selection count shown in help bar
+- [x] **Removed MenuBar** - Clean minimal interface
+
+### v0.5.1 - Dashboard Tab
+- [x] **Two Tabs** - Dashboard (rate limits) + Settings (providers, accounts, MCP)
+- [x] **Tab Switching** - Press Tab to switch between Dashboard and Settings
+- [x] **Rate Limit View** - Like Antigravity Manager, shows accounts with model limits
+- [x] **Progress Bars** - Visual indicator of rate limit status per model
+- [x] **Time Remaining** - Shows hours/minutes until limit resets
+
+### v0.5.2 - Loading Indicator
 - [x] **Loading State** - Shows progress during refresh
 - [x] **Step Messages** - "Loading OpenCode config...", "Loading accounts...", "Done!"
 - [x] **R Key Shortcut** - Added R to help bar for quick refresh
 
-**Controls:**
-| Key | Action |
-|-----|--------|
+### v0.6.4 - Account Health Check (Current)
+- [x] **Health Check Cache** - TTL + cooldown stored in ocam-config.json
+- [x] **OAuth Validation** - Refresh token check with status mapping
+- [x] **Log Hints** - Parse antigravity-logs for verification errors
+- [x] **Dashboard Badges** - Health indicator + summary counts
+- [x] **CLI Command** - `ocam check` with progress and warnings
+
+**Controls:**
+| Key | Action |
+|-----|--------|
 | Tab | Switch between Dashboard and Settings |
 | ↑↓ | Navigate accounts/sections |
 | Space | Toggle account selection |
 | R | Refresh with progress indicator |
+| H | Check account health |
 | P | Open Action Palette |
 | Q | Quit |
-
----
-
-## Future Ideas (Backlog)
-
-### v0.5.0 - Enhanced Security
-- [ ] Password strength indicator
-- [ ] Auto-lock after inactivity
-- [ ] Encrypted storage for config
-
-### v0.6.0 - Cloud Sync
-- [ ] Sync accounts to cloud storage (Google Drive, Dropbox)
-- [ ] Multi-device sync
-- [ ] Conflict resolution
-
-### v0.7.0 - Account Health
-- [ ] Check if refresh tokens are still valid
+
+---
+
+## Future Ideas (Backlog)
+
+### v0.5.0 - Enhanced Security
+- [ ] Password strength indicator
+- [ ] Auto-lock after inactivity
+- [ ] Encrypted storage for config
+
+### v0.6.0 - Cloud Sync
+- [ ] Sync accounts to cloud storage (Google Drive, Dropbox)
+- [ ] Multi-device sync
+- [ ] Conflict resolution
+
+### v0.7.0 - Account Health (Follow-ups)
 - [ ] Auto-refresh expired tokens
+- [ ] Background health monitoring
 - [ ] Health check on startup
+
+### v0.8.0 - MCP Management
+- [ ] Enable/Disable MCP servers from TUI
+- [ ] Add new MCP servers
+- [ ] View MCP server logs
+
+### v0.9.0 - Provider Management
+- [ ] Add/Edit custom providers
+- [ ] Test provider connection
+- [ ] Model usage statistics
+
+### v1.0.0 - Stable Release
+- [x] npm publish
+- [ ] Full documentation
+- [ ] Windows/Mac/Linux installers
+- [ ] Integration tests
+
+---
 
-### v0.8.0 - MCP Management
-- [ ] Enable/Disable MCP servers from TUI
-- [ ] Add new MCP servers
-- [ ] View MCP server logs
-
-### v0.9.0 - Provider Management
-- [ ] Add/Edit custom providers
-- [ ] Test provider connection
-- [ ] Model usage statistics
+## Manual Test Checklist (Health Check)
 
-### v1.0.0 - Stable Release
-- [x] npm publish
-- [ ] Full documentation
-- [ ] Windows/Mac/Linux installers
-- [ ] Integration tests
+- [ ] **Happy path**: OAuth config set, refresh token valid → status `ok`
+- [ ] **Invalid grant**: revoked/expired token → status `revoked` (or `password_changed` if error_description matches)
+- [ ] **Verification required**: trigger `verification_required` mapping via `invalid_grant` with verify/challenge text
+- [ ] **Network error**: disconnect network → status `network_error`
+- [ ] **Missing OAuth config**: no client_id/client_secret → status `not_configured`
 
 ---
 
 ## Contributing
-
-See [BLUEPRINT.md](./BLUEPRINT.md) for technical architecture and implementation details.
+
+See [BLUEPRINT.md](./BLUEPRINT.md) for technical architecture and implementation details.

package/package.json

@@ -1,38 +1,38 @@
-{
-  "name": "opencode-account-manager",
-  "version": "0.6.4",
-  "description": "TUI Dashboard for OpenCode - View providers, MCP servers, and plugin accounts",
-  "main": "dist/cli.js",
+{
+  "name": "opencode-account-manager",
+  "version": "0.6.5",
+  "description": "TUI Dashboard for OpenCode - View providers, MCP servers, and plugin accounts",
+  "main": "dist/cli.js",
   "bin": {
-    "ocam": "./dist/cli.js",
-    "opencode-account-manager": "./dist/cli.js"
+    "ocam": "dist/cli.js",
+    "opencode-account-manager": "dist/cli.js"
   },
-  "scripts": {
-    "build": "npx tsc",
-    "dev": "npx tsc -w",
-    "start": "node dist/cli.js",
-    "dashboard": "node dist/cli.js dashboard"
-  },
-  "keywords": [
-    "opencode",
-    "antigravity",
-    "account-manager",
-    "dashboard",
-    "tui",
-    "mcp",
-    "providers"
-  ],
-  "author": "",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "@types/react": "^17.0.0",
-    "typescript": "^5.3.0"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "commander": "^11.1.0",
-    "ink": "^3.2.0",
-    "react": "^17.0.2"
-  }
-}
+  "scripts": {
+    "build": "npx tsc",
+    "dev": "npx tsc -w",
+    "start": "node dist/cli.js",
+    "dashboard": "node dist/cli.js dashboard"
+  },
+  "keywords": [
+    "opencode",
+    "antigravity",
+    "account-manager",
+    "dashboard",
+    "tui",
+    "mcp",
+    "providers"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/react": "^17.0.0",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "ink": "^3.2.0",
+    "react": "^17.0.2"
+  }
+}

package/src/cli.ts

@@ -3,24 +3,84 @@ import fs from "fs";
 import path from "path";
 import { Command } from "commander";
 import chalk from "chalk";
-import {
-  buildPortableExport,
-  createEmptyPluginAccountsFile,
-  extractAccountsFromImport,
-  mergeAccounts,
-  readPluginAccountsFile,
-  summarizeAccounts,
-  writePluginAccountsFile,
-} from "./core/accounts";
-import { getPluginAccountsPath, getAmFolderPath } from "./core/paths";
-import { importFromAmFolder, isAmFolder } from "./core/importers/amJson";
-import { writeJsonFile } from "./core/utils";
-import { startTuiDashboard } from "./tui";
-
-function formatTimestamp(timestamp?: number): string {
-  if (!timestamp) return "-";
-  return new Date(timestamp).toLocaleString();
-}
+import {
+  buildPortableExport,
+  createEmptyPluginAccountsFile,
+  extractAccountsFromImport,
+  mergeAccounts,
+  readPluginAccountsFile,
+  summarizeAccounts,
+  writePluginAccountsFile,
+} from "./core/accounts";
+import { getPluginAccountsPath, getAmFolderPath } from "./core/paths";
+import { importFromAmFolder, isAmFolder } from "./core/importers/amJson";
+import { writeJsonFile } from "./core/utils";
+import { startTuiDashboard } from "./tui";
+import { checkAccountsHealth, HealthCheckResult } from "./core/health-orchestrator";
+import { AccountHealthStatus } from "./core/types";
+
+function formatTimestamp(timestamp?: number): string {
+  if (!timestamp) return "-";
+  return new Date(timestamp).toLocaleString();
+}
+
+function getStatusLabel(status: AccountHealthStatus): string {
+  switch (status) {
+    case "verification_required":
+      return chalk.bgYellow.black(" VERIFY ");
+    case "revoked":
+      return chalk.bgRed.white(" REVOKED ");
+    case "disabled":
+      return chalk.bgRed.white(" DISABLED ");
+    case "deleted":
+      return chalk.bgRed.white(" DELETED ");
+    case "password_changed":
+      return chalk.bgYellow.black(" PASSWD ");
+    case "network_error":
+      return chalk.bgBlue.white(" NETWORK ");
+    case "unknown_error":
+      return chalk.bgRed.white(" ERROR ");
+    case "not_configured":
+      return chalk.bgGray.white(" CONFIG ");
+    default:
+      return chalk.bgGray.white(` ${status.toUpperCase()} `);
+  }
+}
+
+function printHealthCheckResult(result: HealthCheckResult) {
+  const { counts, timing, items } = result;
+  const issues =
+    counts.total -
+    counts.byStatus.ok -
+    (counts.byStatus.not_checked || 0);
+
+  console.log(chalk.bold("\n=== Health Check Summary ==="));
+  console.log(
+    `Total: ${counts.total} | ` +
+      `${chalk.green("OK: " + counts.byStatus.ok)} | ` +
+      `${
+        issues > 0 ? chalk.red("Issues: " + issues) : chalk.gray("Issues: 0")
+      } | ` +
+      `Time: ${(timing.durationMs / 1000).toFixed(1)}s\n`
+  );
+
+  const warnings = items.filter(
+    (item) => item.result.status !== "ok" && item.result.status !== "not_checked"
+  );
+
+  if (warnings.length > 0) {
+    console.log(chalk.bold("Warnings:"));
+    for (const item of warnings) {
+      const label = getStatusLabel(item.result.status);
+      const msg = item.result.message || item.result.status;
+      console.log(`${label} ${item.email} ${chalk.gray(`(${msg})`)}`);
+    }
+    console.log("");
+  } else if (counts.total > 0) {
+    console.log(chalk.green("All accounts are healthy.\n"));
+  }
+}
+
 
 function isLimited(rateLimitResetTimes?: Record<string, number>): boolean {
   if (!rateLimitResetTimes) return false;
@@ -28,20 +88,29 @@ function isLimited(rateLimitResetTimes?: Record<string, number>): boolean {
   return Object.values(rateLimitResetTimes).some((value) => value > now);
 }
 
-function safeReadPluginFile(pluginPath: string) {
-  try {
-    return readPluginAccountsFile(pluginPath);
-  } catch {
-    return createEmptyPluginAccountsFile();
-  }
-}
+function safeReadPluginFile(pluginPath: string) {
+  try {
+    return readPluginAccountsFile(pluginPath);
+  } catch {
+    return createEmptyPluginAccountsFile();
+  }
+}
+
+function parseEmailList(input?: string): string[] | undefined {
+  if (!input) return undefined;
+  const items = input
+    .split(",")
+    .map((value) => value.trim())
+    .filter((value) => value.length > 0);
+  return items.length > 0 ? items : undefined;
+}
 
 const program = new Command();
 
-program
-  .name("ocam")
-  .description("OpenCode Account Manager - TUI dashboard and CLI for managing accounts")
-  .version("0.5.3");
+program
+  .name("ocam")
+  .description("OpenCode Account Manager - TUI dashboard and CLI for managing accounts")
+  .version("0.5.3");
 
 // Default command - show dashboard
 program
@@ -54,11 +123,11 @@ program
     });
   });
 
-program
-  .command("list")
-  .description("List plugin accounts")
-  .option("--plugin-path <path>", "Path to plugin accounts file")
-  .action((options) => {
+program
+  .command("list")
+  .description("List plugin accounts")
+  .option("--plugin-path <path>", "Path to plugin accounts file")
+  .action((options) => {
     const pluginPath = getPluginAccountsPath(options.pluginPath);
     const file = safeReadPluginFile(pluginPath);
     const summary = summarizeAccounts(file.accounts);
@@ -79,9 +148,41 @@ program
             console.log(chalk.gray(`          └─ ${model}: ${hours}h`));
           }
         }
-      }
-    }
-  });
+      }
+    }
+  });
+
+program
+  .command("check")
+  .description("Check account health status")
+  .option("--plugin-path <path>", "Path to plugin accounts file")
+  .option("--emails <emails>", "Comma-separated list of emails to check")
+  .option("--force", "Bypass cache and cooldown checks", false)
+  .action(async (options) => {
+    const pluginPath = getPluginAccountsPath(options.pluginPath);
+    const file = safeReadPluginFile(pluginPath);
+    const emails = parseEmailList(options.emails);
+
+    if (file.accounts.length === 0) {
+      console.log(chalk.yellow("No accounts to check."));
+      return;
+    }
+
+    const result = await checkAccountsHealth(file.accounts, {
+      emails,
+      force: options.force === true,
+      includeLogs: true,
+      onProgress: (current, total, message) => {
+        if (total > 0) {
+          process.stdout.write(`\r${chalk.gray(`[${current}/${total}]`)} ${message}   `);
+        }
+      },
+    });
+
+    process.stdout.write("\n");
+
+    printHealthCheckResult(result);
+  });
 
 program
   .command("export")
@@ -204,4 +305,4 @@ program
     console.log(`Total: ${merged.accounts.length} accounts`);
   });
 
-program.parse();
+program.parse();