sigrank-mcp 0.6.3

package/README.md

@@ -0,0 +1,93 @@
+---
+type: Reference
+title: SigRank MCP server
+description: The SigRank MCP — exposes the leaderboard as tools any agent can call (rank_paste, get_leaderboard, get_operator, submit_paste, tokenpull, tokenpull_submit). tokenpull is the zero-paste on-device reader (4-window cascade, verified vs token-dashboard). Token-only, read-only, no transcript content. Cascade math mirrors lib/ingest/bridge.ts; proprietary threshold cuts stay server-side.
+tags: [sigrank, mcp, tokenpull, agent, ingest, reference]
+timestamp: 2026-06-23
+---
+
+# SigRank MCP server
+
+Exposes SigRank as MCP tools any agent (Claude Code, Cursor, …) can call — turning the
+leaderboard into a tool every agent can invoke (distribution moat). Token-only, no auth,
+no transcript content.
+
+## Tools
+| tool | what |
+|---|---|
+| `rank_paste(text)` | paste ccusage token counts → **Υ Yield / SNR / Leverage / Velocity / 10xDEV + class + a deterministic prose `card`**. Accepts JSON `{input,output,cacheCreate,cacheRead}` or 4 whitespace numbers in that order. |
+| `get_leaderboard()` | the live public board (signalaf.com) |
+| `get_operator(codename)` | one operator's live profile |
+| `submit_paste(text, codename)` | **rank AND publish** in one call: local cascade + card, then POSTs the raw paste to the board's web-paste endpoint (server re-scores authoritatively). `codename` required to publish; omit for preview-only. |
+| `tokenpull(platform?)` | **in-house local reader** (no ccusage/tokscale): scans local logs → the 4 windows (7d/30d/90d/all) each cascaded. **Claude** (native, recursive incl. `subagents/`, dedup `(session,message)` keep-final, verified vs token-dashboard) + **Codex** (reads `~/.codex/sessions`, estimated via `io_ratio` — Beta from the operator's Claude ratio, else Alpha 2.0; verified vs `ccusage codex`). Zero paste, on-device, token-only. |
+| `tokenpull_submit(codename, window?)` | **the zero-paste flow**: `tokenpull` → publish each window's canonical pillars to the board (server re-scores), tagged with `platform`. `codename` required to publish; omit for preview. |
+
+The cascade math (`cascade.mjs`) mirrors `sigrank-app/lib/ingest/bridge.ts` — Υ = (Cr·O)/I².
+Open by design; the proprietary threshold cuts / weights stay server-side.
+
+## Privacy
+- **Token-only, always.** No message content is ever read, logged, or transmitted — only token counts (`input`, `output`, `cache_creation`, `cache_read`), message IDs, and timestamps.
+- **Local by default.** `tokenpull` and `tokenpull_submit` read only `~/.claude/projects` (Claude) or `~/.codex` (Codex) on your device. The numbers stay on your machine unless you explicitly call `_submit` with a codename.
+- **Background tooling excluded.** Memory plugins, observers, and summarizers (e.g. `claude-mem`, `mem0`, `observer-sessions`) are filtered out of both Claude and Codex reads. `subagents/` are kept — they represent real operator work. The filter list is in `EXCLUDE_TOOLING` in `tokenpull.mjs` and is extensible.
+- **No auth required.** All board reads and the web-paste submit path are anonymous. No credentials are stored or transmitted.
+- **Content hash per upload.** Every `_submit` call attaches a SHA-256 hash of the pillar payload + a `ddmmyy` datestamp. No personal identifiers beyond the operator-chosen codename.
+
+## Verified
+`node test.mjs` → `rank_paste` reproduces canon: **MO§ES `1251211 11296121 128196310 2555179769`
+→ Υ 18436.98 · lev 2042.2 · TRANSMITTER.** ✅ (math is dependency-free, runs without install.)
+
+## Run
+```bash
+npm install            # installs @modelcontextprotocol/sdk
+node index.mjs         # stdio MCP server
+```
+Add to an MCP client (e.g. Claude Code `.mcp.json`):
+```json
+{ "mcpServers": { "sigrank": { "command": "node", "args": ["/Users/dericmchenry/Desktop/SigRank/sigrank-mcp/index.mjs"] } } }
+```
+`SIGRANK_API_BASE` overrides the board host (default `https://signalaf.com`).
+
+## Status (MVP)
+- ✅ cascade math verified (`rank_paste` → canon Υ). `cascade.mjs` is the testable core.
+- ✅ **Runtime smoke PASS** (2026-06-19): `npm install` (0 vuln) + live MCP-client `tools/list`
+  + `rank_paste` round-trip + `get_leaderboard`/`get_operator` HTTP 200 against signalaf.com.
+- ✅ **3a insight card** (`narrate.mjs`): `rank_paste` returns a deterministic prose `card`
+  ported from `moses-sigrank/narrate.py` `_template` (model path skipped on purpose).
+- ✅ **3b `submit_paste`** (first write op): ranks locally then POSTs the raw paste to the
+  existing anonymous `/api/v1/ingest-paste` (web-paste path — `source='web_paste'`, no auth).
+  Verified via injected fetch (no live write). ⚠️ The **first live submit writes production
+  Supabase** — fire it once yourself: `SIGRANK_API_BASE=https://signalaf.com` + a real paste.
+- ✅ **tokenpull** (`tokenpull.mjs`): in-house local usage reader (Claude + Codex). Recursive scan
+  (incl. `subagents/`), dedup by `(session_id, message_id)` keep-final, 4-window cascade.
+  **Verified against token-dashboard (nateherkai): 7d input 3.44M EXACT match** (~1208 files).
+  Bug fixed: a 2-level readdir was dropping sub-agent transcripts → 4× input under-count.
+- ✅ **Hardened** (2026-06-23): div-by-zero guards in cascade, `_parseWarnings` on suspicious input,
+  AbortController fetch timeout (10s, env-overridable), symlink-safe `_walkJsonl` with MAX_JSONL_FILES
+  cap, `EXCLUDE_TOOLING` applied to Codex, uncaughtException/unhandledRejection handlers.
+
+## Multi-model adapter support
+All adapters are token-only (no message content, no cost fields, no credentials). Numbers are
+refined as data accumulates — SigRank is continuously improving methods as more operator data arrives.
+
+| Platform | Path | Notes |
+|---|---|---|
+| Claude Code | ✅ `~/.claude/projects` | native, verified; dedup by `(session_id, message_id)` |
+| Codex | ✅ `~/.codex/sessions` | estimated via `io_ratio`; verified vs `ccusage codex` |
+| Amp | ✅ `~/.local/share/amp/threads` | full 4-pillar; per-message |
+| Kimi | ✅ `~/.kimi/sessions` | full 4-pillar; `StatusUpdate` lines only |
+| pi-agent | ✅ `~/.pi/agent/sessions` | full 4-pillar; per-message JSONL |
+| OpenClaw | ✅ `~/.openclaw` (+ `.clawdbot`, `.moltbot`, `.moldbot`) | full 4-pillar; per-message JSONL |
+| Droid | ✅ `~/.factory/sessions/*.settings.json` | full 4-pillar; per-session JSON; thinking→output |
+| Codebuff | ✅ `~/.config/manicode` | full 4-pillar; `chat-messages.json` |
+| Hermes | ✅ `~/.hermes/state.db` | full 4-pillar; SQLite; reasoning→output |
+| Kilo | ✅ `~/.local/share/kilo/kilo.db` | full 4-pillar; SQLite |
+| Qwen | ✅ `~/.qwen/projects` | cacheCreate=0 (`estimated`); no create field in logs; thought→output |
+| Goose | ✅ `~/.local/share/goose/sessions/sessions.db` | cacheCreate=cacheRead=0 (`estimated`); SQLite |
+| Gemini CLI | ✅ `~/.gemini/tmp` | cacheCreate=0 (`estimated`); cache extracted from input field |
+| GitHub Copilot CLI | ✅ `~/.copilot/otel` | OTel JSONL; requires `COPILOT_OTEL_ENABLED=true` before session |
+| OpenCode | ⚠️ `~/.local/share/opencode` | `dataGap`: raw token counts not persisted in log format |
+| Cursor | 🔜 | chat log path TBD; token usage varies by plan |
+| Windsurf | 🔜 | session logs at `~/.codeium/windsurf/` |
+
+`estimated=true` means `cacheCreate` is unavailable — the other 3 pillars are native. The server
+re-scores all submitted pillars authoritatively; local preview Υ is indicative only.

package/adapters.mjs

@@ -0,0 +1,480 @@
+/**
+ * adapters.mjs — SigRank tokenpull adapters for all supported platforms.
+ *
+ * OKF (code-file form — fields live in this comment, not raw frontmatter, so the .mjs
+ * still parses as valid JS):
+ *   type: Reference
+ *   title: SigRank tokenpull adapters
+ *   description: Per-platform adapters implementing the tokenpull contract — async-generate
+ *     {id,sid,ts,input,output,cacheCreate,cacheRead,file} from local logs. Reasoning→output,
+ *     cost fields dropped, missing cacheCreate → estimated:true. Token-only, read-only.
+ *   tags: [sigrank, mcp, tokenpull, adapters, reference]
+ *   timestamp: 2026-06-23
+ *
+ * Each adapter implements the tokenpull contract:
+ *   messages(root): async generator → { id?, sid?, ts, input, output, cacheCreate, cacheRead, file }
+ *
+ * SigRank-specific mapping rules (applied consistently across all adapters):
+ *   - Reasoning / thinking tokens → folded into `output` (they are output-side spend)
+ *   - No cache-creation data available → cacheCreate: 0 + adapter sets `estimated: true`
+ *   - Cost fields (USD) → NEVER used or forwarded (SigRank scores cost efficiency from
+ *     token ratios, not from dollar amounts — cost efficiency is derived, not ingested)
+ *   - Credits / provider-specific fields → dropped
+ *
+ * "estimated" flag: set on the ADAPTER OBJECT (not per-record) when the adapter
+ * cannot provide native cacheCreate values. tokenpull() and tokenpullCodex() already
+ * handle this pattern; new adapters with estimated=true get the same treatment.
+ *
+ * SQLite adapters shell out to `sqlite3 -json` (macOS/Linux system tool, no npm dep).
+ * If sqlite3 is unavailable the adapter returns an empty generator with a dataGap note.
+ *
+ * Data-gap notes (sources that can't provide full 4-pillar data) are attached on the
+ * adapter object as `dataGap: string` so tokenpull() can surface them to the user.
+ */
+
+import { readdir, readFile } from 'node:fs/promises'
+import { join, extname } from 'node:path'
+import { homedir } from 'node:os'
+import { exec as execCb } from 'node:child_process'
+import { promisify } from 'node:util'
+
+const exec = promisify(execCb)
+const DAY_MS = 86_400_000 // shared with tokenpull.mjs but kept local to avoid circular import
+
+// ── File-system helpers ───────────────────────────────────────────────────────
+
+/** Recursively yield every file whose name matches `pred` under dir (skips symlink dirs). */
+async function* walkFiles(dir, pred, counter = { n: 0 }, max = 10_000) {
+  if (counter.n >= max) return
+  let entries
+  try { entries = await readdir(dir, { withFileTypes: true }) } catch { return }
+  for (const e of entries) {
+    if (counter.n >= max) return
+    const full = join(dir, e.name)
+    if (e.isSymbolicLink()) continue
+    if (e.isDirectory()) { yield* walkFiles(full, pred, counter, max) }
+    else if (e.isFile() && pred(e.name)) { counter.n++; yield full }
+  }
+}
+
+const isJsonl = (n) => n.endsWith('.jsonl') || n.endsWith('.jsonl.deleted') || n.match(/\.jsonl\.reset\.\d+$/)
+const isJson  = (n) => n.endsWith('.json') && !n.endsWith('.jsonl')
+
+/** Read a file as UTF-8, return null on error. */
+async function readUtf8(path) {
+  try { return await readFile(path, 'utf8') } catch { return null }
+}
+
+/** Parse each newline-delimited JSON line, yield parsed objects silently skipping bad lines. */
+function* parseJsonl(text, filePath) {
+  if (!text) return
+  for (const line of text.split('\n')) {
+    const s = line.trim()
+    if (!s) continue
+    try { yield [JSON.parse(s), filePath] } catch { /* skip malformed */ }
+  }
+}
+
+/** Shell out to sqlite3 and return parsed JSON rows, or [] on error/unavailability. */
+async function sqliteJson(dbPath, sql) {
+  try {
+    const { stdout } = await exec(`sqlite3 -json "${dbPath}" "${sql.replace(/"/g, '\\"')}"`, { timeout: 10_000 })
+    return JSON.parse(stdout || '[]')
+  } catch { return [] }
+}
+
+// ── Env-var helper ────────────────────────────────────────────────────────────
+/** Resolve roots from env var or default. Supports comma-separated list. */
+function roots(envVar, defaultPath) {
+  const v = process.env[envVar]
+  if (v) return v.split(',').map((s) => s.trim()).filter(Boolean)
+  return [defaultPath]
+}
+
+// ── 1. Amp ────────────────────────────────────────────────────────────────────
+// ~/.local/share/amp/threads/**/*.json
+// Fields: assistant message usage: input_tokens, output_tokens, cache_creation_tokens, cache_read_tokens
+export const ampAdapter = {
+  platform: 'amp',
+  defaultRoot: () => join(homedir(), '.local', 'share', 'amp'),
+  async *messages(root) {
+    for (const r of roots('AMP_DATA_DIR', root)) {
+      const threadsDir = join(r, 'threads')
+      for await (const path of walkFiles(threadsDir, isJson)) {
+        const text = await readUtf8(path)
+        if (!text) continue
+        let thread
+        try { thread = JSON.parse(text) } catch { continue }
+        // Amp thread is an array or object with messages
+        const msgs = Array.isArray(thread) ? thread : (thread.messages || [])
+        for (const msg of msgs) {
+          if (!msg || msg.role !== 'assistant') continue
+          const u = msg.usage || (msg.metadata && msg.metadata.usage) || {}
+          const input  = Number(u.input_tokens  || u.inputTokens  || 0)
+          const output = Number(u.output_tokens || u.outputTokens || 0)
+          const cacheCreate = Number(u.cache_creation_tokens || u.cacheCreationTokens || 0)
+          const cacheRead   = Number(u.cache_read_tokens     || u.cacheReadTokens     || 0)
+          if (input + output + cacheCreate + cacheRead === 0) continue
+          yield { id: msg.id || null, sid: thread.id || null, ts: msg.timestamp || msg.created_at || null, input, output, cacheCreate, cacheRead, file: path }
+        }
+      }
+    }
+  },
+}
+
+// ── 2. Kimi ───────────────────────────────────────────────────────────────────
+// ~/.kimi/sessions/<group-id>/<session-id>/wire.jsonl
+// StatusUpdate lines only; token_usage: { input_other, output, input_cache_read, input_cache_creation }
+export const kimiAdapter = {
+  platform: 'kimi',
+  defaultRoot: () => join(homedir(), '.kimi'),
+  async *messages(root) {
+    const sessionsDir = join(roots('KIMI_DATA_DIR', root)[0], 'sessions')
+    for await (const path of walkFiles(sessionsDir, isJsonl)) {
+      const text = await readUtf8(path)
+      for (const [ev] of parseJsonl(text, path)) {
+        if (!ev || ev.type !== 'StatusUpdate') continue
+        const u = ev.token_usage || {}
+        const input  = Number(u.input_other || 0)
+        const output = Number(u.output || 0)
+        const cacheCreate = Number(u.input_cache_creation || 0)
+        const cacheRead   = Number(u.input_cache_read     || 0)
+        if (input + output + cacheCreate + cacheRead === 0) continue
+        yield { id: ev.id || null, sid: null, ts: ev.timestamp || ev.created_at || null, input, output, cacheCreate, cacheRead, file: path }
+      }
+    }
+  },
+}
+
+// ── 3. Qwen ───────────────────────────────────────────────────────────────────
+// ~/.qwen/projects/{project}/chats/*.jsonl
+// usageMetadata: { promptTokenCount, candidatesTokenCount, cachedContentTokenCount, thoughtsTokenCount }
+// No cache creation field. Reasoning (thoughtsTokenCount) → output.
+export const qwenAdapter = {
+  platform: 'qwen',
+  estimated: true, // no cacheCreate in logs
+  defaultRoot: () => join(homedir(), '.qwen'),
+  async *messages(root) {
+    const projectsDir = join(roots('QWEN_DATA_DIR', root)[0], 'projects')
+    for await (const path of walkFiles(projectsDir, isJsonl)) {
+      const text = await readUtf8(path)
+      for (const [ev] of parseJsonl(text, path)) {
+        if (!ev || !ev.usageMetadata) continue
+        const u = ev.usageMetadata
+        const rawInput  = Number(u.promptTokenCount || 0)
+        const rawOutput = Number(u.candidatesTokenCount || 0)
+        const thoughts  = Number(u.thoughtsTokenCount || 0) // reasoning → output
+        const cacheRead = Number(u.cachedContentTokenCount || 0)
+        // promptTokenCount is inclusive of cached; subtract to get fresh input
+        const input  = Math.max(0, rawInput - cacheRead)
+        const output = rawOutput + thoughts
+        if (input + output + cacheRead === 0) continue
+        yield { id: ev.id || null, sid: null, ts: ev.timestamp || null, input, output, cacheCreate: 0, cacheRead, file: path }
+      }
+    }
+  },
+}
+
+// ── 4. pi-agent ───────────────────────────────────────────────────────────────
+// ~/.pi/agent/sessions/**/*.jsonl
+// Fields: inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens
+export const piAdapter = {
+  platform: 'pi',
+  defaultRoot: () => join(homedir(), '.pi', 'agent', 'sessions'),
+  async *messages(root) {
+    for (const r of roots('PI_AGENT_DIR', root)) {
+      for await (const path of walkFiles(r, isJsonl)) {
+        const text = await readUtf8(path)
+        for (const [ev] of parseJsonl(text, path)) {
+          if (!ev) continue
+          // pi-agent stores usage in assistant messages or usage events
+          const u = ev.usage || ev
+          const input  = Number(u.inputTokens  || u.input_tokens  || 0)
+          const output = Number(u.outputTokens || u.output_tokens || 0)
+          const cacheCreate = Number(u.cacheCreationTokens || u.cache_creation_tokens || 0)
+          const cacheRead   = Number(u.cacheReadTokens     || u.cache_read_tokens     || 0)
+          if (input + output + cacheCreate + cacheRead === 0) continue
+          yield { id: ev.id || null, sid: ev.sessionId || null, ts: ev.timestamp || null, input, output, cacheCreate, cacheRead, file: path }
+        }
+      }
+    }
+  },
+}
+
+// ── 5. OpenClaw ───────────────────────────────────────────────────────────────
+// ~/.openclaw/ (also ~/.clawdbot/, ~/.moltbot/, ~/.moldbot/)
+// agents/<agentId>/sessions/<uuid>.jsonl (+ .deleted.<ts> and .reset.<ts> variants)
+// Per-message: input_tokens, output_tokens, cache_creation_tokens, cache_read_tokens
+export const openclawAdapter = {
+  platform: 'openclaw',
+  defaultRoot: () => {
+    const env = process.env.OPENCLAW_DIR
+    if (env) return env.split(',')[0].trim()
+    for (const d of ['.openclaw', '.clawdbot', '.moltbot', '.moldbot']) {
+      const p = join(homedir(), d)
+      return p // return first; walkFiles silently skips missing
+    }
+    return join(homedir(), '.openclaw')
+  },
+  async *messages(root) {
+    const dirs = process.env.OPENCLAW_DIR
+      ? process.env.OPENCLAW_DIR.split(',').map((s) => s.trim())
+      : [join(homedir(), '.openclaw'), join(homedir(), '.clawdbot'), join(homedir(), '.moltbot'), join(homedir(), '.moldbot')]
+    const pred = (n) => isJsonl(n) || n.endsWith('.json') // covers archived variants
+    for (const dir of dirs) {
+      for await (const path of walkFiles(dir, pred)) {
+        const text = await readUtf8(path)
+        for (const [ev] of parseJsonl(text, path)) {
+          if (!ev || ev.role !== 'assistant') continue
+          const u = ev.usage || ev.tokens || {}
+          const input  = Number(u.input_tokens  || u.inputTokens  || 0)
+          const output = Number(u.output_tokens || u.outputTokens || 0)
+          const cacheCreate = Number(u.cache_creation_tokens || u.cacheCreationTokens || 0)
+          const cacheRead   = Number(u.cache_read_tokens     || u.cacheReadTokens     || 0)
+          if (input + output + cacheCreate + cacheRead === 0) continue
+          yield { id: ev.id || null, sid: null, ts: ev.timestamp || null, input, output, cacheCreate, cacheRead, file: path }
+        }
+      }
+    }
+  },
+}
+
+// ── 6. Droid ──────────────────────────────────────────────────────────────────
+// ~/.factory/sessions/**/*.settings.json
+// Fields: input_tokens, output_tokens, cache_creation_tokens, cache_read_tokens, thinking_tokens
+// Thinking tokens → output. Per-settings-file (session-level granularity).
+export const droidAdapter = {
+  platform: 'droid',
+  defaultRoot: () => join(homedir(), '.factory', 'sessions'),
+  async *messages(root) {
+    for (const r of roots('DROID_SESSIONS_DIR', root)) {
+      for await (const path of walkFiles(r, (n) => n.endsWith('.settings.json'))) {
+        const text = await readUtf8(path)
+        if (!text) continue
+        let s
+        try { s = JSON.parse(text) } catch { continue }
+        const input  = Number(s.input_tokens        || 0)
+        const output = Number(s.output_tokens       || 0) + Number(s.thinking_tokens || 0)
+        const cacheCreate = Number(s.cache_creation_tokens || 0)
+        const cacheRead   = Number(s.cache_read_tokens     || 0)
+        if (input + output + cacheCreate + cacheRead === 0) continue
+        yield { id: null, sid: s.session_id || s.id || null, ts: s.updated_at || s.created_at || null, input, output, cacheCreate, cacheRead, file: path }
+      }
+    }
+  },
+}
+
+// ── 7. Codebuff ───────────────────────────────────────────────────────────────
+// ~/.config/manicode/projects/<project>/chats/<chat-id>/chat-messages.json
+// assistant messages: metadata.usage or metadata.codebuff.usage
+export const codebuffAdapter = {
+  platform: 'codebuff',
+  defaultRoot: () => join(homedir(), '.config', 'manicode'),
+  async *messages(root) {
+    const dirs = process.env.CODEBUFF_DATA_DIR
+      ? process.env.CODEBUFF_DATA_DIR.split(',').map((s) => s.trim())
+      : [join(homedir(), '.config', 'manicode'), join(homedir(), '.config', 'manicode-dev'), join(homedir(), '.config', 'manicode-staging')]
+    for (const dir of dirs) {
+      for await (const path of walkFiles(dir, (n) => n === 'chat-messages.json')) {
+        const text = await readUtf8(path)
+        if (!text) continue
+        let msgs
+        try { msgs = JSON.parse(text) } catch { continue }
+        if (!Array.isArray(msgs)) continue
+        for (const msg of msgs) {
+          if (!msg || msg.role !== 'assistant') continue
+          const u = (msg.metadata && (msg.metadata.usage || msg.metadata.codebuff?.usage)) || {}
+          const input  = Number(u.input_tokens  || u.inputTokens  || 0)
+          const output = Number(u.output_tokens || u.outputTokens || 0)
+          const cacheCreate = Number(u.cache_creation_tokens || u.cacheCreationTokens || 0)
+          const cacheRead   = Number(u.cache_read_tokens     || u.cacheReadTokens     || 0)
+          if (input + output + cacheCreate + cacheRead === 0) continue
+          yield { id: msg.id || null, sid: null, ts: msg.timestamp || msg.created_at || null, input, output, cacheCreate, cacheRead, file: path }
+        }
+      }
+    }
+  },
+}
+
+// ── 8. Gemini CLI ─────────────────────────────────────────────────────────────
+// ~/.gemini/tmp/*/chats/*.json and *.jsonl
+// Fields: input, output, cached, thought (reasoning), tool, total
+// SigRank mapping: input = input−cached (fresh), cacheRead = cached, cacheCreate = 0 (not exposed),
+// output = output + thought (reasoning→output)
+export const geminiAdapter = {
+  platform: 'gemini',
+  estimated: true, // no cacheCreate field in Gemini logs
+  defaultRoot: () => join(homedir(), '.gemini', 'tmp'),
+  async *messages(root) {
+    for (const r of roots('GEMINI_DATA_DIR', root)) {
+      for await (const path of walkFiles(r, (n) => n.endsWith('.json') || n.endsWith('.jsonl'))) {
+        const text = await readUtf8(path)
+        if (!text) continue
+        // Try JSONL first, then single JSON
+        let parsed = []
+        try {
+          parsed = text.trim().split('\n').filter(Boolean).map((l) => JSON.parse(l))
+        } catch {
+          try { parsed = [JSON.parse(text)] } catch { continue }
+        }
+        for (const ev of parsed) {
+          if (!ev) continue
+          // Gemini usage may be at top level or nested in usageMetadata
+          const u = ev.usageMetadata || ev.usage || ev
+          const rawInput  = Number(u.input || u.promptTokenCount || 0)
+          const rawOutput = Number(u.output || u.candidatesTokenCount || 0)
+          const cached    = Number(u.cached || u.cachedContentTokenCount || 0)
+          const thought   = Number(u.thought || u.thoughtsTokenCount || 0)
+          if (rawInput + rawOutput + cached + thought === 0) continue
+          const input  = Math.max(0, rawInput - cached)   // strip cached from input
+          const output = rawOutput + thought               // reasoning → output
+          yield { id: ev.id || null, sid: null, ts: ev.timestamp || null, input, output, cacheCreate: 0, cacheRead: cached, file: path }
+        }
+      }
+    }
+  },
+}
+
+// ── 9. GitHub Copilot CLI ─────────────────────────────────────────────────────
+// ~/.copilot/otel/*.jsonl  (requires COPILOT_OTEL_ENABLED=true before session start)
+// OpenTelemetry spans; looks for llm.token_count.prompt / completion / cached attributes
+export const copilotAdapter = {
+  platform: 'copilot',
+  defaultRoot: () => join(homedir(), '.copilot', 'otel'),
+  async *messages(root) {
+    const dir = process.env.COPILOT_OTEL_FILE_EXPORTER_PATH
+      ? require('node:path').dirname(process.env.COPILOT_OTEL_FILE_EXPORTER_PATH)
+      : root
+    for await (const path of walkFiles(dir, isJsonl)) {
+      const text = await readUtf8(path)
+      for (const [ev] of parseJsonl(text, path)) {
+        if (!ev) continue
+        // OTel span: attributes may be an object or array of {key,value} pairs
+        const attrs = ev.attributes || ev.resource?.attributes || {}
+        const get = (k) => {
+          if (typeof attrs === 'object' && !Array.isArray(attrs)) return attrs[k]
+          if (Array.isArray(attrs)) { const a = attrs.find((x) => x.key === k); return a?.value?.intValue ?? a?.value?.stringValue ?? null }
+          return null
+        }
+        const input  = Number(get('llm.token_count.prompt')     || get('gen_ai.usage.input_tokens')  || 0)
+        const output = Number(get('llm.token_count.completion') || get('gen_ai.usage.output_tokens') || 0)
+        const cacheCreate = Number(get('llm.token_count.cache_creation') || 0)
+        const cacheRead   = Number(get('llm.token_count.cache_read')     || get('gen_ai.usage.cache_read_input_tokens') || 0)
+        if (input + output + cacheCreate + cacheRead === 0) continue
+        yield { id: ev.traceId || ev.spanId || null, sid: null, ts: ev.startTimeUnixNano ? new Date(Number(ev.startTimeUnixNano) / 1e6).toISOString() : null, input, output, cacheCreate, cacheRead, file: path }
+      }
+    }
+  },
+  setupNote: 'Requires COPILOT_OTEL_ENABLED=true and COPILOT_OTEL_EXPORTER_TYPE=file set BEFORE starting the Copilot session. Without this, no local token logs are written.',
+}
+
+// ── 10. OpenCode ──────────────────────────────────────────────────────────────
+// ~/.local/share/opencode — JSON message files, but costs stored as 0 and token fields
+// are calculated via LiteLLM pricing (not stored in the log). No raw token fields.
+// SigRank cannot derive pillars from OpenCode logs with current log format.
+export const opencodeAdapter = {
+  platform: 'opencode',
+  defaultRoot: () => join(homedir(), '.local', 'share', 'opencode'),
+  estimated: true,
+  dataGap: 'OpenCode logs store cost:0 and derive tokens via LiteLLM at runtime — raw token counts are not persisted. SigRank cannot read pillars from OpenCode logs with the current format. Track https://github.com/ccusage/ccusage for format changes.',
+  // eslint-disable-next-line require-yield
+  async *messages() { /* no data available */ },
+}
+
+// ── 11. Goose ─────────────────────────────────────────────────────────────────
+// SQLite: sessions.db at standard Goose data roots or $GOOSE_PATH_ROOT/data/sessions/sessions.db
+// Columns: accumulated_input_tokens (or input_tokens), accumulated_output_tokens (or output_tokens),
+//          accumulated_total_tokens (or total_tokens). NO cache fields. Reasoning = total-input-output.
+export const gooseAdapter = {
+  platform: 'goose',
+  estimated: true, // no cacheCreate or cacheRead
+  defaultRoot: () => {
+    const env = process.env.GOOSE_PATH_ROOT
+    if (env) return env
+    // Standard locations (macOS first, then XDG)
+    return join(homedir(), 'Library', 'Application Support', 'goose')
+  },
+  async *messages(root) {
+    const dbCandidates = process.env.GOOSE_PATH_ROOT
+      ? [join(process.env.GOOSE_PATH_ROOT, 'data', 'sessions', 'sessions.db')]
+      : [
+          join(homedir(), 'Library', 'Application Support', 'goose', 'sessions', 'sessions.db'),
+          join(homedir(), '.local', 'share', 'goose', 'sessions', 'sessions.db'),
+          join(homedir(), '.local', 'share', 'Block', 'goose', 'sessions', 'sessions.db'),
+        ]
+    for (const db of dbCandidates) {
+      const rows = await sqliteJson(db, 'SELECT * FROM sessions')
+      for (const row of rows) {
+        const input  = Number(row.accumulated_input_tokens  || row.input_tokens  || 0)
+        const output = Number(row.accumulated_output_tokens || row.output_tokens || 0)
+        const total  = Number(row.accumulated_total_tokens  || row.total_tokens  || 0)
+        const reasoning = Math.max(0, total - input - output) // folded into output
+        if (input + output === 0) continue
+        yield { id: String(row.id || ''), sid: null, ts: row.created_at || row.updated_at || null, input, output: output + reasoning, cacheCreate: 0, cacheRead: 0, file: db }
+      }
+    }
+  },
+}
+
+// ── 12. Kilo ──────────────────────────────────────────────────────────────────
+// SQLite: ~/.local/share/kilo/kilo.db
+// Per-message rows with model, input/output/cache token columns.
+export const kiloAdapter = {
+  platform: 'kilo',
+  defaultRoot: () => join(homedir(), '.local', 'share', 'kilo'),
+  async *messages(root) {
+    const dbPath = join(roots('KILO_DATA_DIR', root)[0], 'kilo.db')
+    const rows = await sqliteJson(dbPath, 'SELECT * FROM messages WHERE role="assistant"')
+    for (const row of rows) {
+      const input  = Number(row.input_tokens  || row.inputTokens  || 0)
+      const output = Number(row.output_tokens || row.outputTokens || 0)
+      const cacheCreate = Number(row.cache_creation_tokens || row.cacheCreationTokens || 0)
+      const cacheRead   = Number(row.cache_read_tokens     || row.cacheReadTokens     || 0)
+      if (input + output + cacheCreate + cacheRead === 0) continue
+      yield { id: String(row.id || ''), sid: String(row.session_id || row.sessionId || ''), ts: row.created_at || row.timestamp || null, input, output, cacheCreate, cacheRead, file: dbPath }
+    }
+  },
+}
+
+// ── 13. Hermes Agent ─────────────────────────────────────────────────────────
+// SQLite: ~/.hermes/state.db
+// Per-session rows: input, output, cache_read, cache_write (=cacheCreate), reasoning_tokens → output
+export const hermesAdapter = {
+  platform: 'hermes',
+  defaultRoot: () => join(homedir(), '.hermes'),
+  async *messages(root) {
+    for (const r of roots('HERMES_HOME', root)) {
+      const dbPath = join(r, 'state.db')
+      const rows = await sqliteJson(dbPath, 'SELECT * FROM sessions')
+      for (const row of rows) {
+        const input     = Number(row.input    || 0)
+        const reasoning = Number(row.reasoning_tokens || 0)
+        const output    = Number(row.output   || 0) + reasoning
+        const cacheCreate = Number(row.cache_write || row.cache_creation || 0)
+        const cacheRead   = Number(row.cache_read  || 0)
+        if (input + output + cacheCreate + cacheRead === 0) continue
+        yield { id: String(row.id || ''), sid: null, ts: row.created_at || row.updated_at || null, input, output, cacheCreate, cacheRead, file: dbPath }
+      }
+    }
+  },
+}
+
+// ── Registry ──────────────────────────────────────────────────────────────────
+/** All non-Claude, non-Codex adapters keyed by platform ID. */
+export const ADAPTERS = {
+  amp:      ampAdapter,
+  kimi:     kimiAdapter,
+  qwen:     qwenAdapter,
+  pi:       piAdapter,
+  openclaw: openclawAdapter,
+  droid:    droidAdapter,
+  codebuff: codebuffAdapter,
+  gemini:   geminiAdapter,
+  copilot:  copilotAdapter,
+  opencode: opencodeAdapter,
+  goose:    gooseAdapter,
+  kilo:     kiloAdapter,
+  hermes:   hermesAdapter,
+}
+
+export const ALL_PLATFORMS = Object.keys(ADAPTERS).concat(['claude', 'codex'])