@rulemetric/cli 0.2.0 → 0.2.2

package/dist/opencode-IQ7X5YMJ.js

@@ -0,0 +1,190 @@
+import {
+  __require
+} from "./chunk-NSBPE2FW.js";
+
+// ../../packages/session/dist/providers/opencode.js
+import { readdir } from "fs/promises";
+import { join } from "path";
+import { homedir } from "os";
+var Database = null;
+function loadSqlite() {
+  if (Database)
+    return true;
+  try {
+    Database = __require("better-sqlite3");
+    return true;
+  } catch {
+    return false;
+  }
+}
+var toolNameMap = {
+  bash: "Bash",
+  read: "Read",
+  edit: "Edit",
+  write: "Write",
+  glob: "Glob",
+  grep: "Grep",
+  task: "Agent",
+  fetch: "WebFetch",
+  search: "WebSearch",
+  todo: "TodoWrite",
+  skill: "Skill",
+  patch: "Patch"
+};
+function sanitize(dir) {
+  return dir.replace(/^\//, "").replace(/\//g, "-");
+}
+function getDataDir() {
+  const base = process.env["XDG_DATA_HOME"] ?? join(homedir(), ".local", "share");
+  return join(base, "opencode");
+}
+async function findDbFiles(dir) {
+  try {
+    const entries = await readdir(dir);
+    return entries.filter((f) => f.startsWith("opencode") && f.endsWith(".db")).map((f) => join(dir, f));
+  } catch {
+    return [];
+  }
+}
+function parseTimestamp(raw) {
+  const ms = raw < 1e12 ? raw * 1e3 : raw;
+  return new Date(ms).toISOString();
+}
+function extractBashCommands(cmd) {
+  return cmd.split(/[;&|]+/).map((s) => s.trim().split(/\s+/)[0]).filter(Boolean);
+}
+function createParser(source, seenKeys) {
+  return {
+    async *parse() {
+      if (!loadSqlite() || !Database)
+        return;
+      const segments = source.path.split(":");
+      const sessionId = segments[segments.length - 1];
+      const dbPath = segments.slice(0, -1).join(":");
+      let db;
+      try {
+        db = new Database(dbPath, { readonly: true });
+      } catch {
+        return;
+      }
+      try {
+        const messages = db.prepare("SELECT id, time_created, data FROM message WHERE session_id = ? ORDER BY time_created ASC").all(sessionId);
+        const parts = db.prepare("SELECT message_id, data FROM part WHERE session_id = ? ORDER BY message_id, id").all(sessionId);
+        const partsByMsg = /* @__PURE__ */ new Map();
+        for (const part of parts) {
+          try {
+            const parsed = JSON.parse(part.data);
+            const list = partsByMsg.get(part.message_id) ?? [];
+            list.push(parsed);
+            partsByMsg.set(part.message_id, list);
+          } catch {
+          }
+        }
+        let currentUserMessage = "";
+        for (const msg of messages) {
+          let data;
+          try {
+            data = JSON.parse(msg.data);
+          } catch {
+            continue;
+          }
+          if (data.role === "user") {
+            const textParts = (partsByMsg.get(msg.id) ?? []).filter((p) => p.type === "text").map(() => "").filter(Boolean);
+            if (textParts.length > 0)
+              currentUserMessage = textParts.join(" ");
+            continue;
+          }
+          if (data.role !== "assistant")
+            continue;
+          const tokens = {
+            input: data.tokens?.input ?? 0,
+            output: data.tokens?.output ?? 0,
+            reasoning: data.tokens?.reasoning ?? 0,
+            cacheRead: data.tokens?.cache?.read ?? 0,
+            cacheWrite: data.tokens?.cache?.write ?? 0
+          };
+          const allZero = tokens.input === 0 && tokens.output === 0 && tokens.reasoning === 0 && tokens.cacheRead === 0 && tokens.cacheWrite === 0;
+          if (allZero && (data.cost ?? 0) === 0)
+            continue;
+          const msgParts = partsByMsg.get(msg.id) ?? [];
+          const toolParts = msgParts.filter((p) => p.type === "tool");
+          const tools = toolParts.map((p) => toolNameMap[p.tool ?? ""] ?? p.tool ?? "").filter(Boolean);
+          const bashCommands = toolParts.filter((p) => p.tool === "bash" && typeof p.state?.input?.command === "string").flatMap((p) => extractBashCommands(p.state.input.command));
+          const dedupKey = `opencode:${sessionId}:${msg.id}`;
+          if (seenKeys.has(dedupKey))
+            continue;
+          seenKeys.add(dedupKey);
+          yield {
+            provider: "opencode",
+            model: data.modelID ?? "unknown",
+            inputTokens: tokens.input,
+            outputTokens: tokens.output,
+            cacheCreationInputTokens: tokens.cacheWrite,
+            cacheReadInputTokens: tokens.cacheRead,
+            cachedInputTokens: tokens.cacheRead,
+            reasoningTokens: tokens.reasoning,
+            costUSD: data.cost ?? 0,
+            tools,
+            bashCommands,
+            timestamp: parseTimestamp(msg.time_created),
+            speed: "standard",
+            deduplicationKey: dedupKey,
+            userMessage: currentUserMessage,
+            sessionId
+          };
+        }
+      } finally {
+        db.close();
+      }
+    }
+  };
+}
+async function discoverFromDb(dbPath) {
+  if (!loadSqlite() || !Database)
+    return [];
+  let db;
+  try {
+    db = new Database(dbPath, { readonly: true });
+  } catch {
+    return [];
+  }
+  try {
+    const rows = db.prepare("SELECT id, directory, title FROM session WHERE time_archived IS NULL AND parent_id IS NULL ORDER BY time_created DESC").all();
+    return rows.map((row) => ({
+      path: `${dbPath}:${row.id}`,
+      project: row.directory ? sanitize(row.directory) : sanitize(row.title),
+      provider: "opencode"
+    }));
+  } catch {
+    return [];
+  } finally {
+    db.close();
+  }
+}
+var opencode = {
+  name: "opencode",
+  displayName: "OpenCode",
+  modelDisplayName(model) {
+    return model.replace(/^[^/]+\//, "");
+  },
+  toolDisplayName(rawTool) {
+    return toolNameMap[rawTool] ?? rawTool;
+  },
+  async discoverSessions() {
+    if (!loadSqlite())
+      return [];
+    const dbPaths = await findDbFiles(getDataDir());
+    const sessions = [];
+    for (const dbPath of dbPaths) {
+      sessions.push(...await discoverFromDb(dbPath));
+    }
+    return sessions;
+  },
+  createSessionParser(source, seenKeys) {
+    return createParser(source, seenKeys);
+  }
+};
+export {
+  opencode
+};
+//# sourceMappingURL=opencode-IQ7X5YMJ.js.map

package/dist/opencode-IQ7X5YMJ.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/session/src/providers/opencode.ts"],
+  "sourcesContent": ["import { readdir } from 'fs/promises';\nimport { join } from 'path';\nimport { homedir } from 'os';\n\nimport type { Provider, SessionSource, SessionParser, ParsedProviderCall } from './types.js';\n\n// Lazy-loaded \u2014 requires better-sqlite3\nlet Database: typeof import('better-sqlite3') | null = null;\n\nfunction loadSqlite(): boolean {\n  if (Database) return true;\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    Database = require('better-sqlite3');\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nconst toolNameMap: Record<string, string> = {\n  bash: 'Bash',\n  read: 'Read',\n  edit: 'Edit',\n  write: 'Write',\n  glob: 'Glob',\n  grep: 'Grep',\n  task: 'Agent',\n  fetch: 'WebFetch',\n  search: 'WebSearch',\n  todo: 'TodoWrite',\n  skill: 'Skill',\n  patch: 'Patch',\n};\n\ntype MessageRow = {\n  id: string;\n  time_created: number;\n  data: string;\n};\n\ntype PartRow = {\n  message_id: string;\n  data: string;\n};\n\ntype SessionRow = {\n  id: string;\n  directory: string;\n  title: string;\n};\n\ntype MessageData = {\n  role: string;\n  modelID?: string;\n  cost?: number;\n  tokens?: {\n    input?: number;\n    output?: number;\n    reasoning?: number;\n    cache?: { read?: number; write?: number };\n  };\n};\n\ntype PartData = {\n  type: string;\n  tool?: string;\n  state?: { input?: { command?: string } };\n};\n\nfunction sanitize(dir: string): string {\n  return dir.replace(/^\\//, '').replace(/\\//g, '-');\n}\n\nfunction getDataDir(): string {\n  const base = process.env['XDG_DATA_HOME'] ?? join(homedir(), '.local', 'share');\n  return join(base, 'opencode');\n}\n\nasync function findDbFiles(dir: string): Promise<string[]> {\n  try {\n    const entries = await readdir(dir);\n    return entries\n      .filter(f => f.startsWith('opencode') && f.endsWith('.db'))\n      .map(f => join(dir, f));\n  } catch {\n    return [];\n  }\n}\n\nfunction parseTimestamp(raw: number): string {\n  const ms = raw < 1e12 ? raw * 1000 : raw;\n  return new Date(ms).toISOString();\n}\n\nfunction extractBashCommands(cmd: string): string[] {\n  return cmd.split(/[;&|]+/).map(s => s.trim().split(/\\s+/)[0]).filter(Boolean);\n}\n\nfunction createParser(source: SessionSource, seenKeys: Set<string>): SessionParser {\n  return {\n    async *parse(): AsyncGenerator<ParsedProviderCall> {\n      if (!loadSqlite() || !Database) return;\n\n      // Path is encoded as `${dbPath}:${sessionId}`\n      const segments = source.path.split(':');\n      const sessionId = segments[segments.length - 1]!;\n      const dbPath = segments.slice(0, -1).join(':');\n\n      let db: InstanceType<typeof import('better-sqlite3')>;\n      try {\n        db = new Database!(dbPath, { readonly: true });\n      } catch {\n        return;\n      }\n\n      try {\n        const messages = db.prepare(\n          'SELECT id, time_created, data FROM message WHERE session_id = ? ORDER BY time_created ASC',\n        ).all(sessionId) as MessageRow[];\n\n        const parts = db.prepare(\n          'SELECT message_id, data FROM part WHERE session_id = ? ORDER BY message_id, id',\n        ).all(sessionId) as PartRow[];\n\n        const partsByMsg = new Map<string, PartData[]>();\n        for (const part of parts) {\n          try {\n            const parsed = JSON.parse(part.data) as PartData;\n            const list = partsByMsg.get(part.message_id) ?? [];\n            list.push(parsed);\n            partsByMsg.set(part.message_id, list);\n          } catch { /* skip corrupt */ }\n        }\n\n        let currentUserMessage = '';\n\n        for (const msg of messages) {\n          let data: MessageData;\n          try {\n            data = JSON.parse(msg.data) as MessageData;\n          } catch {\n            continue;\n          }\n\n          if (data.role === 'user') {\n            const textParts = (partsByMsg.get(msg.id) ?? [])\n              .filter(p => p.type === 'text')\n              .map(() => '') // text content not needed for analytics\n              .filter(Boolean);\n            if (textParts.length > 0) currentUserMessage = textParts.join(' ');\n            continue;\n          }\n\n          if (data.role !== 'assistant') continue;\n\n          const tokens = {\n            input: data.tokens?.input ?? 0,\n            output: data.tokens?.output ?? 0,\n            reasoning: data.tokens?.reasoning ?? 0,\n            cacheRead: data.tokens?.cache?.read ?? 0,\n            cacheWrite: data.tokens?.cache?.write ?? 0,\n          };\n\n          const allZero = tokens.input === 0 && tokens.output === 0 &&\n            tokens.reasoning === 0 && tokens.cacheRead === 0 && tokens.cacheWrite === 0;\n          if (allZero && (data.cost ?? 0) === 0) continue;\n\n          const msgParts = partsByMsg.get(msg.id) ?? [];\n          const toolParts = msgParts.filter(p => p.type === 'tool');\n          const tools = toolParts\n            .map(p => toolNameMap[p.tool ?? ''] ?? p.tool ?? '')\n            .filter(Boolean);\n\n          const bashCommands = toolParts\n            .filter(p => p.tool === 'bash' && typeof p.state?.input?.command === 'string')\n            .flatMap(p => extractBashCommands(p.state!.input!.command!));\n\n          const dedupKey = `opencode:${sessionId}:${msg.id}`;\n          if (seenKeys.has(dedupKey)) continue;\n          seenKeys.add(dedupKey);\n\n          yield {\n            provider: 'opencode',\n            model: data.modelID ?? 'unknown',\n            inputTokens: tokens.input,\n            outputTokens: tokens.output,\n            cacheCreationInputTokens: tokens.cacheWrite,\n            cacheReadInputTokens: tokens.cacheRead,\n            cachedInputTokens: tokens.cacheRead,\n            reasoningTokens: tokens.reasoning,\n            costUSD: data.cost ?? 0,\n            tools,\n            bashCommands,\n            timestamp: parseTimestamp(msg.time_created),\n            speed: 'standard',\n            deduplicationKey: dedupKey,\n            userMessage: currentUserMessage,\n            sessionId,\n          };\n        }\n      } finally {\n        db.close();\n      }\n    },\n  };\n}\n\nasync function discoverFromDb(dbPath: string): Promise<SessionSource[]> {\n  if (!loadSqlite() || !Database) return [];\n\n  let db: InstanceType<typeof import('better-sqlite3')>;\n  try {\n    db = new Database!(dbPath, { readonly: true });\n  } catch {\n    return [];\n  }\n\n  try {\n    const rows = db.prepare(\n      'SELECT id, directory, title FROM session WHERE time_archived IS NULL AND parent_id IS NULL ORDER BY time_created DESC',\n    ).all() as SessionRow[];\n\n    return rows.map(row => ({\n      path: `${dbPath}:${row.id}`,\n      project: row.directory ? sanitize(row.directory) : sanitize(row.title),\n      provider: 'opencode',\n    }));\n  } catch {\n    return [];\n  } finally {\n    db.close();\n  }\n}\n\nexport const opencode: Provider = {\n  name: 'opencode',\n  displayName: 'OpenCode',\n\n  modelDisplayName(model: string): string {\n    return model.replace(/^[^/]+\\//, '');\n  },\n\n  toolDisplayName(rawTool: string): string {\n    return toolNameMap[rawTool] ?? rawTool;\n  },\n\n  async discoverSessions(): Promise<SessionSource[]> {\n    if (!loadSqlite()) return [];\n    const dbPaths = await findDbFiles(getDataDir());\n    const sessions: SessionSource[] = [];\n    for (const dbPath of dbPaths) {\n      sessions.push(...await discoverFromDb(dbPath));\n    }\n    return sessions;\n  },\n\n  createSessionParser(source: SessionSource, seenKeys: Set<string>): SessionParser {\n    return createParser(source, seenKeys);\n  },\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/oclif.manifest.json

@@ -125,7 +125,7 @@
       "examples": [
         "<%= config.bin %> dashboard",
         "<%= config.bin %> dashboard --period 30days",
-        "<%= config.bin %> dashboard --period all"
+        "<%= config.bin %> dashboard --launcher"
       ],
       "flags": {
         "api-url": {
@@ -152,6 +152,13 @@
             "all"
           ],
           "type": "option"
+        },
+        "launcher": {
+          "char": "l",
+          "description": "Open the launcher overlay immediately",
+          "name": "launcher",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -254,6 +261,138 @@
         "import.js"
       ]
     },
+    "launcher": {
+      "aliases": [],
+      "args": {},
+      "description": "Open the launcher overlay (alias for `dashboard --launcher`)",
+      "examples": [
+        "<%= config.bin %> launcher",
+        "<%= config.bin %> launcher --period today"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "period": {
+          "char": "p",
+          "description": "Initial time period for the dashboard panels behind the overlay",
+          "name": "period",
+          "default": "week",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "today",
+            "week",
+            "30days",
+            "month",
+            "all"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "launcher",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "launcher.js"
+      ]
+    },
+    "antigravity:backfill": {
+      "aliases": [],
+      "args": {
+        "conversationId": {
+          "description": "Antigravity conversationId (UUID) — the directory name under ~/.gemini/antigravity-ide/brain/",
+          "name": "conversationId",
+          "required": true
+        }
+      },
+      "description": "Backfill historical events from an Antigravity conversation transcript into a RuleMetric session. Useful for seeding a conversation that existed before hooks were installed — the live hook intentionally only captures forward.",
+      "examples": [
+        "<%= config.bin %> antigravity backfill 26fd215d-f43b-4ea5-b177-dc2c0e696f97 --session 158db9aa-68ee-43fc-961b-f3a180578694",
+        "<%= config.bin %> antigravity backfill 26fd215d-f43b-4ea5-b177-dc2c0e696f97 --dry-run"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "session": {
+          "char": "s",
+          "description": "RuleMetric session UUID to POST events into. If omitted, resolved from the hook tmp file ($TMPDIR/rulemetric/<conversationId>) — fails if neither is present.",
+          "name": "session",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "transcript": {
+          "description": "Path to the transcript.jsonl file. Defaults to ~/.gemini/antigravity-ide/brain/<conversationId>/.system_generated/logs/transcript.jsonl",
+          "name": "transcript",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "after-step": {
+          "description": "Only emit records with step_index > this value. Default: read from existing state file, else -1 (everything).",
+          "name": "after-step",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Cap on the number of records to process this run.",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Classify records without POSTing. Reports counts only.",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "save-state": {
+          "description": "After backfill, persist the highest step_index so the live hook resumes from there.",
+          "name": "save-state",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "antigravity:backfill",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "antigravity",
+        "backfill.js"
+      ]
+    },
     "auth:create-key": {
       "aliases": [],
       "args": {},
@@ -564,7 +703,7 @@
     "crons:list": {
       "aliases": [],
       "args": {},
-      "description": "List all registered cron tasks and their schedules",
+      "description": "List manually-runnable maintenance tasks",
       "examples": [
         "<%= config.bin %> crons list"
       ],
@@ -599,14 +738,14 @@
       "aliases": [],
       "args": {
         "name": {
-          "description": "Cron task name (run `rulemetric crons list` to see all)",
+          "description": "Task name (run `rulemetric crons list` to see all)",
           "name": "name",
           "required": true
         }
       },
-      "description": "Run a registered cron task synchronously, right now",
+      "description": "Run a maintenance task synchronously, right now",
       "examples": [
-        "<%= config.bin %> crons run cron_refresh_skills",
+        "<%= config.bin %> crons run cron_check_changelog",
         "<%= config.bin %> crons run cron_suggest_instructions --quiet"
       ],
       "flags": {
@@ -776,6 +915,40 @@
         "list.js"
       ]
     },
+    "evals:agent": {
+      "aliases": [],
+      "args": {},
+      "description": "The worker daemon: long-polls /api/work/next, claims jobs, and runs them locally. Installed as a launchd service by `rulemetric service install`.",
+      "examples": [
+        "<%= config.bin %> evals agent"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "evals:agent",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "evals",
+        "agent.js"
+      ]
+    },
     "evals:benchmark": {
       "aliases": [],
       "args": {
@@ -964,60 +1137,6 @@
         "create.js"
       ]
     },
-    "evals:listen": {
-      "aliases": [],
-      "args": {},
-      "description": "Listen for eval jobs from the web UI and execute them locally",
-      "examples": [
-        "<%= config.bin %> evals listen"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "supabase-url": {
-          "description": "[deprecated, ignored] Supabase project URL (no longer used)",
-          "env": "SUPABASE_URL",
-          "hidden": true,
-          "name": "supabase-url",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "supabase-anon-key": {
-          "description": "[deprecated, ignored] Supabase anon key (no longer used)",
-          "env": "SUPABASE_ANON_KEY",
-          "hidden": true,
-          "name": "supabase-anon-key",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "evals:listen",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "evals",
-        "listen.js"
-      ]
-    },
     "evals:optimize-description": {
       "aliases": [],
       "args": {
@@ -1377,6 +1496,12 @@
           "name": "global",
           "allowNo": false,
           "type": "boolean"
+        },
+        "statusline-usage": {
+          "description": "Install the statusline shim so Claude Code pushes live rate_limits on every refresh (makes /usage rings update in real time without needing the proxy)",
+          "name": "statusline-usage",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -2615,7 +2740,8 @@
           "options": [
             "zsh",
             "bash",
-            "fish"
+            "fish",
+            "powershell"
           ],
           "type": "option"
         },
@@ -2790,13 +2916,108 @@
         "stop.js"
       ]
     },
+    "research:backfill": {
+      "aliases": [],
+      "args": {},
+      "description": "Scan every ~/.claude/projects transcript for past rate-limit (429) events and POST them as observations. Opt-in seed for the usage-research dataset — forward-only tail is the default capture path.",
+      "examples": [
+        "<%= config.bin %> research backfill",
+        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "claude-dir": {
+          "description": "Override the Claude Code projects directory",
+          "name": "claude-dir",
+          "default": "/home/runner/.claude",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Print observation count without POSTing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "research:backfill",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "research",
+        "backfill.js"
+      ]
+    },
+    "research:tail-transcript": {
+      "aliases": [],
+      "args": {
+        "transcript": {
+          "description": "Absolute path to a Claude Code .jsonl transcript",
+          "name": "transcript",
+          "required": true
+        }
+      },
+      "description": "Read new lines from a Claude Code transcript since the last cached offset, POST any 429 events, and persist the new offset. Invoked by the session-end hook — safe to re-run.",
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-post": {
+          "description": "Parse and advance the offset without POSTing (debug)",
+          "name": "no-post",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "research:tail-transcript",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "research",
+        "tail-transcript.js"
+      ]
+    },
     "service:install": {
       "aliases": [],
       "args": {},
-      "description": "Install RuleMetric API as a persistent macOS service (launchd)",
+      "description": "Install RuleMetric API, worker, gateway, and capture proxy as persistent macOS launchd services",
       "examples": [
         "<%= config.bin %> service install",
-        "<%= config.bin %> service install --port 3000"
+        "<%= config.bin %> service install --port 3000",
+        "<%= config.bin %> service install --skip-build",
+        "<%= config.bin %> service install --no-proxy"
       ],
       "flags": {
         "api-url": {
@@ -2819,10 +3040,22 @@
         },
         "force": {
           "char": "f",
-          "description": "Overwrite existing service configuration",
+          "description": "Overwrite existing service configuration and reclaim conflicting ports",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
+        },
+        "skip-build": {
+          "description": "Skip the pre-install workspace build (API/web/cli dist must already exist)",
+          "name": "skip-build",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-proxy": {
+          "description": "Skip gateway + mitmproxy plists (just install API + worker)",
+          "name": "no-proxy",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -2844,7 +3077,7 @@
     "service:status": {
       "aliases": [],
       "args": {},
-      "description": "Check the status of the RuleMetric API service",
+      "description": "Check the status of all RuleMetric launchd services",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2875,7 +3108,7 @@
     "service:uninstall": {
       "aliases": [],
       "args": {},
-      "description": "Remove the RuleMetric API service from launchd",
+      "description": "Remove all RuleMetric launchd services (API, worker, gateway, proxy)",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3723,5 +3956,5 @@
       ]
     }
   },
-  "version": "0.1.1"
+  "version": "0.2.1"
 }