genesiscz · Jul 16, 2026 · Jul 13, 2026 · Jul 13, 2026 · Jul 13, 2026 · Jul 13, 2026
diff --git a/.claude/docs/tool-template.md b/.claude/docs/tool-template.md
@@ -297,6 +297,7 @@ spinner.succeed("Done!");
 8. **Add verbose/debug modes** for troubleshooting
 9. **Use meaningful exit codes** (0 for success, 1+ for errors)
 10. **Test with various input scenarios** including edge cases
+11. **Multi-column inventory output** (lists of models, accounts, ports, …): use `@app/utils/table` port-style helpers (`createBoxTable`, `renderCliHeader`, `formatDotStatus`) + `out.println` — not clack `out.log.info` lines. See CLAUDE.md → *CLI inventory tables*. Keep `--json` via `out.result`.
 
 ### 5. Testing Your Tool
 

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -88,7 +88,7 @@ When creating a new tool and writing helper functions, check if the utility is *
 
 - `src/utils/format.ts` - Formatting: `formatDuration()`, `formatBytes()`, `formatTokens()`, `formatNumber()`, `formatList()`, `formatTimestamp()`, `createStopwatch()`
 - `src/utils/Stopwatch.ts` - High-res stopwatch class: `elapsed()`, `lap()`, `stamp()` (wall-clock + elapsed), `now()` (HH:MM:SS.mmm)
-- `src/utils/table.ts` - Text table formatting
+- `src/utils/table.ts` - CLI tables: `formatTable()` (plain padded), **`createBoxTable()` / `renderCliHeader()` / `formatDotStatus()`** (port-style boxed inventories via `cli-table3`)
 - `src/utils/string.ts` - String utilities (glob matching, ANSI stripping)
 - `src/utils/cli/executor.ts` - CLI helpers: `suggestCommand()`, `isInteractive()`, `buildCommand()`, `Executor`, `enhanceHelp()`
 - `src/utils/storage/storage.ts` - Config & cache management
@@ -169,8 +169,9 @@ Most tools follow these common patterns:
 
 -   Support multiple output destinations: file, clipboard, stdout
 -   Use `clipboardy` for clipboard operations
--   Use `chalk` for colored terminal output (but strip ANSI codes for non-TTY)
+-   Use `picocolors` (or `chalk`) for colored terminal output (but strip ANSI codes for non-TTY)
 -   Respect `--silent` and `--verbose` flags
+-   **Human inventory lists (models, accounts, ports, processes, …):** do **not** dump multi-column data via clack `out.log.info`. Use the port-style table helpers from `@app/utils/table` + `out.println` — see **CLI inventory tables** below.
 
 **Process Execution**:
 
@@ -246,6 +247,35 @@ Two cleanly separated layers (the 2026-05 logger+out overhaul):
 - **Every commander entrypoint** ends with `await runTool(program, { tool })` (from `@app/utils/cli`) — it owns `-v`/`--readme`/help registration, console-level resolution, and the `{tool}` log binding, then `parseAsync`. The subprocess **spawner** is `execTool` (renamed from the old `runTool`).
 - **`scripts/ci/logging-guard.sh`** enforces this convention repo-wide in CI: no default/extension/relative-path/any-name import of the logger module (root `./tools` and `scripts/` included — not just `src/`), no bare `logger.*(SafeJSON.stringify(…))` result dumps, no reintroduced transitional shims, and that the browser-client isolation test exists. Browser-client trees never value-importing `@app/logger` is authoritatively enforced by `src/logger/client-isolation.test.ts`.
 - **`@app/utils/cli/ui` — high-density CLI status.** For tools that emit many short status lines per command (e.g. `tools stash`), clack's `│ ◆ ●` box-drawing is the wrong texture. Import `{ ui }` from `@app/utils/cli/ui` to get plain stderr writes with chalk decoration (`ui.ok/info/warn/err/dim/header/kv/section/raw`). Use this INSTEAD of `out.log.*` for high-density status; keep `out.log.*` for clack-shaped task lifecycles. `out.print()` / `out.result()` are still the only writers to stdout for machine-readable output.
+- **CLI inventory tables (port-style) — prefer this for multi-column human output.** Canonical helpers live in `@app/utils/table` (not reimplemented per tool). Reference UIs: `tools port`, `tools ai-proxy models`, `tools macos swap`.
+
+  | Need | API | Notes |
+  |---|---|---|
+  | Boxed inventory table | `createBoxTable(headers)` | `cli-table3` + shared box chars; `table.push(row)` then `out.println(table.toString())` |
+  | Title box | `renderCliHeader(title, subtitle)` | Cyan frame via `out.println` |
+  | Section + key rows | `renderCliSection` / `renderCliKeyRow` | Column legends, detail blocks |
+  | Status cell | `formatDotStatus("ok"\|"warn"\|"err"\|"dim", label)` | `● ok` / `● fail` coloring |
+  | Cell truncate | `truncateDisplay(value, max)` | Em dash for empty; `…` ellipsis |
+  | Plain padded table | `formatTable(rows, headers)` | Dense / non-TTY dumps without box borders |
+  | Machine-readable | `out.result(...)` + `--json` | Never put JSON through the table path |
+
+  Pattern:
+
+  ```typescript
+  import { out } from "@app/logger";
+  import { suggestCommand } from "@app/utils/cli";
+  import { createBoxTable, formatDotStatus, renderCliHeader, renderCliSection } from "@app/utils/table";
+  import pc from "picocolors";
+
+  renderCliHeader("Proxy Models", "ids clients can call");
+  const table = createBoxTable(["PROXY ID", "PROBE"]);
+  table.push([pc.white(id), formatDotStatus("ok", "ok")]);
+  out.println(table.toString());
+  renderCliSection("Columns");
+  // footer: counts · Next/Debug via suggestCommand("tools <tool>", { replaceCommand: [...] })
+  ```
+
+  **Do not** hand-roll `new Table({ chars: … })` or copy/paste box-drawing from `src/port/` — import from `@app/utils/table`. Keep domain coloring (framework names, etc.) in the tool's `display.ts`; keep the table chrome shared.
 
 ## Claude Agent SDK Types Reference
 
@@ -284,6 +314,14 @@ Key SDK type files: `sdk.d.ts` (session/message/streaming types), `sdk-tools.d.t
 -   **TypeScript Config**: Strict mode enabled, ES modules, no emit (Bun runs TS directly)
 -   **Logging**: Check `~/.genesis-tools/logs/` for debug information if tools encounter errors
 
+## LLM Model Library & Pricing (one place — do not add new rate tables)
+
+- **Canonical model list + pricing**: `providerManager.detectProviders()` (`src/ask/providers/ProviderManager.ts`) returns `ModelInfo[]` with `pricing?: PricingInfo` (`inputPer1M`/`outputPer1M`, `src/ask/types/provider.ts`). Pricing is populated by `dynamicPricingManager.getPricing(provider, modelId)` (`src/ask/providers/DynamicPricing.ts`), sourced from LiteLLM's `model_prices_and_context_window.json` (cached as `litellm-pricing.json`) + OpenRouter.
+- **Cost math (pure)**: `src/utils/ai/llm-cost.ts` — `estimateLlmCallCostUsd({pricing, inputTokens, outputTokens})`, `estimateSpeechTokens(durationSec)`. No rates in there, math only.
+- **Deliberate exception**: `src/ai-proxy/lib/billing/pricing.ts` keeps a small STATIC table — it's the ai-proxy client-ledger invoicing source of truth (deterministic, offline). Don't "deduplicate" it into the dynamic path, and don't copy it anywhere else.
+- Resolving a user's provider/model choice (default account, `-sub` suffix handling): `resolveProviderChoice()` in `src/youtube/lib/provider-choice.ts` wraps `modelSelector`/`providerManager`.
+- **Accounts** live in `~/.genesis-tools/ai/config.json` (`AIConfig`, types in `src/utils/config/ai.types.ts`). Subscription billing is flagged by `DetectedProvider.subscription` (set by the `*SubResolver`s in `src/utils/ai/resolvers/`) — never infer it from name suffixes. API-key accounts may REFERENCE an env var via `tokens.apiKeyEnv` (resolved by `AIConfig.resolveApiKey`, never copied); `grok-sub` accounts reference the Grok CLI auth file via `tokens.authFile` (default `~/.grok/auth.json`, resolved by `resolveGrokSubToken` in `src/utils/ai/grok/account.ts`). ai-proxy's subscription providers bill these same accounts by `accountName` reference.
+
 ## Database Infrastructure
 
 - **Storage**: `src/utils/storage/storage.ts` owns per-tool config/cache directories under `~/.genesis-tools/<tool>/`; wrap it with tool-specific subclasses such as `IndexerStorage`.

diff --git a/README.md b/README.md
@@ -160,6 +160,16 @@ Answer a question, then preserve the Q→A to the local question store so it can
 
 Captured via the `question_answer` MCP tool, falling back to the `tools question record` CLI.
 
+#### genesis-tools MCP server (`tools claude mcp`)
+
+The plugin's own MCP server (stdio) exposes two capabilities: `question_answer` (the Q&A capture tool above) and `boards` (dev-dashboard annotation boards — `boards_list_boards`, `boards_wait_for_work`, `boards_compose_board`, etc.). Both are enabled by default. To restrict which capabilities are registered, set `GENESIS_TOOLS_MCP_CAPABILITIES` to a comma-delimited list of capability names in the server's environment (e.g. in `~/.claude.json`'s `mcpServers.genesis-tools.env`):
+
+```bash
+GENESIS_TOOLS_MCP_CAPABILITIES=question_answer,boards   # both (default when unset)
+GENESIS_TOOLS_MCP_CAPABILITIES=question_answer          # only the Q&A tool
+GENESIS_TOOLS_MCP_CAPABILITIES=boards                   # only boards tools
+```
+
 ---
 
 ### Skill Details

diff --git a/biome.json b/biome.json
@@ -109,6 +109,16 @@
                 }
             }
         },
+        {
+            "includes": ["src/youtube/extension/**"],
+            "linter": {
+                "rules": {
+                    "style": {
+                        "noRestrictedGlobals": "off"
+                    }
+                }
+            }
+        },
         {
             "includes": ["**/*.test.ts", "**/*.test.tsx", "**/__tests__/**", "**/*.data.ts"],
             "plugins": []