@vibescore/tracker 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescore/tracker",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Codex CLI token usage tracker (macOS-first, notify-driven).",
   "license": "MIT",
   "publishConfig": {

package/src/commands/init.js

@@ -14,6 +14,7 @@ const {
   loadEveryCodeNotifyOriginal
 } = require('../lib/codex-config');
 const { upsertClaudeHook, buildClaudeHookCommand } = require('../lib/claude-config');
+const { resolveOpencodeConfigDir, upsertOpencodePlugin } = require('../lib/opencode-config');
 const { beginBrowserAuth } = require('../lib/browser-auth');
 const {
   issueDeviceTokenWithPassword,
@@ -162,6 +163,12 @@ async function cmdInit(argv) {
     });
   }
 
+  const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
+  const opencodeResult = await upsertOpencodePlugin({
+    configDir: opencodeConfigDir,
+    notifyPath
+  });
+
   process.stdout.write(
     [
       'Installed:',
@@ -186,6 +193,11 @@ async function cmdInit(argv) {
           ? `- Claude hooks: updated (${claudeSettingsPath})`
           : `- Claude hooks: already set (${claudeSettingsPath})`
         : '- Claude hooks: skipped (~/.claude not found)',
+      opencodeResult?.skippedReason === 'config-missing'
+        ? '- Opencode plugin: skipped (config dir missing)'
+        : opencodeResult?.changed
+          ? `- Opencode plugin: updated (${opencodeConfigDir})`
+          : `- Opencode plugin: already set (${opencodeConfigDir})`,
       deviceToken ? `- Device token: stored (${maskSecret(deviceToken)})` : '- Device token: not configured (set VIBESCORE_DEVICE_TOKEN and re-run init)',
       ''
     ].join('\n')
@@ -306,7 +318,12 @@ try {
 
 // Chain the original notify if present (Codex/Every Code only).
 try {
-  const originalPath = source === 'every-code' ? codeOriginalPath : source === 'claude' ? null : codexOriginalPath;
+  const originalPath =
+    source === 'every-code'
+      ? codeOriginalPath
+      : source === 'claude' || source === 'opencode'
+        ? null
+        : codexOriginalPath;
   if (originalPath) {
     const original = JSON.parse(fs.readFileSync(originalPath, 'utf8'));
     const cmd = Array.isArray(original?.notify) ? original.notify : null;
@@ -421,7 +438,7 @@ async function installLocalTrackerApp({ appDir }) {
 
 function spawnInitSync({ trackerBinPath, packageName }) {
   const fallbackPkg = packageName || '@vibescore/tracker';
-  const argv = ['sync'];
+  const argv = ['sync', '--drain'];
   const hasLocalRuntime = typeof trackerBinPath === 'string' && fssync.existsSync(trackerBinPath);
   const cmd = hasLocalRuntime
     ? [process.execPath, trackerBinPath, ...argv]

package/src/commands/status.js

@@ -5,6 +5,7 @@ const fs = require('node:fs/promises');
 const { readJson } = require('../lib/fs');
 const { readCodexNotify, readEveryCodeNotify } = require('../lib/codex-config');
 const { isClaudeHookConfigured, buildClaudeHookCommand } = require('../lib/claude-config');
+const { resolveOpencodeConfigDir, isOpencodePluginInstalled } = require('../lib/opencode-config');
 const { normalizeState: normalizeUploadState } = require('../lib/upload-throttle');
 const { collectTrackerDiagnostics } = require('../lib/diagnostics');
 
@@ -31,6 +32,7 @@ async function cmdStatus(argv = []) {
   const codeHome = process.env.CODE_HOME || path.join(home, '.code');
   const codeConfigPath = path.join(codeHome, 'config.toml');
   const claudeSettingsPath = path.join(home, '.claude', 'settings.json');
+  const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
   const claudeHookCommand = buildClaudeHookCommand(path.join(home, '.vibescore', 'bin', 'notify.cjs'));
 
   const config = await readJson(configPath);
@@ -53,6 +55,7 @@ async function cmdStatus(argv = []) {
     settingsPath: claudeSettingsPath,
     hookCommand: claudeHookCommand
   });
+  const opencodePluginConfigured = await isOpencodePluginInstalled({ configDir: opencodeConfigDir });
 
   const lastUpload = uploadThrottle.lastSuccessMs
     ? parseEpochMsToIso(uploadThrottle.lastSuccessMs)
@@ -88,6 +91,7 @@ async function cmdStatus(argv = []) {
       `- Codex notify: ${notifyConfigured ? JSON.stringify(codexNotify) : 'unset'}`,
       `- Every Code notify: ${everyCodeConfigured ? JSON.stringify(everyCodeNotify) : 'unset'}`,
       `- Claude hooks: ${claudeHookConfigured ? 'set' : 'unset'}`,
+      `- Opencode plugin: ${opencodePluginConfigured ? 'set' : 'unset'}`,
       ''
     ]
       .filter(Boolean)

package/src/commands/sync.js

@@ -8,9 +8,11 @@ const {
   listRolloutFiles,
   listClaudeProjectFiles,
   listGeminiSessionFiles,
+  listOpencodeMessageFiles,
   parseRolloutIncremental,
   parseClaudeIncremental,
-  parseGeminiIncremental
+  parseGeminiIncremental,
+  parseOpencodeIncremental
 } = require('../lib/rollout');
 const { drainQueueToCloud } = require('../lib/uploader');
 const { createProgress, renderBar, formatNumber, formatBytes } = require('../lib/progress');
@@ -54,6 +56,9 @@ async function cmdSync(argv) {
     const claudeProjectsDir = path.join(home, '.claude', 'projects');
     const geminiHome = process.env.GEMINI_HOME || path.join(home, '.gemini');
     const geminiTmpDir = path.join(geminiHome, 'tmp');
+    const xdgDataHome = process.env.XDG_DATA_HOME || path.join(home, '.local', 'share');
+    const opencodeHome = process.env.OPENCODE_HOME || path.join(xdgDataHome, 'opencode');
+    const opencodeStorageDir = path.join(opencodeHome, 'storage');
 
     const sources = [
       { source: 'codex', sessionsDir: path.join(codexHome, 'sessions') },
@@ -136,6 +141,29 @@ async function cmdSync(argv) {
       });
     }
 
+    const opencodeFiles = await listOpencodeMessageFiles(opencodeStorageDir);
+    let opencodeResult = { filesProcessed: 0, eventsAggregated: 0, bucketsQueued: 0 };
+    if (opencodeFiles.length > 0) {
+      if (progress?.enabled) {
+        progress.start(`Parsing Opencode ${renderBar(0)} 0/${formatNumber(opencodeFiles.length)} files | buckets 0`);
+      }
+      opencodeResult = await parseOpencodeIncremental({
+        messageFiles: opencodeFiles,
+        cursors,
+        queuePath,
+        onProgress: (p) => {
+          if (!progress?.enabled) return;
+          const pct = p.total > 0 ? p.index / p.total : 1;
+          progress.update(
+            `Parsing Opencode ${renderBar(pct)} ${formatNumber(p.index)}/${formatNumber(
+              p.total
+            )} files | buckets ${formatNumber(p.bucketsQueued)}`
+          );
+        },
+        source: 'opencode'
+      });
+    }
+
     cursors.updatedAt = new Date().toISOString();
     await writeJson(cursorsPath, cursors);
 
@@ -261,8 +289,16 @@ async function cmdSync(argv) {
     });
 
     if (!opts.auto) {
-      const totalParsed = parseResult.filesProcessed + claudeResult.filesProcessed + geminiResult.filesProcessed;
-      const totalBuckets = parseResult.bucketsQueued + claudeResult.bucketsQueued + geminiResult.bucketsQueued;
+      const totalParsed =
+        parseResult.filesProcessed +
+        claudeResult.filesProcessed +
+        geminiResult.filesProcessed +
+        opencodeResult.filesProcessed;
+      const totalBuckets =
+        parseResult.bucketsQueued +
+        claudeResult.bucketsQueued +
+        geminiResult.bucketsQueued +
+        opencodeResult.bucketsQueued;
       process.stdout.write(
         [
           'Sync finished:',

package/src/commands/uninstall.js

@@ -4,6 +4,7 @@ const fs = require('node:fs/promises');
 
 const { restoreCodexNotify, restoreEveryCodeNotify } = require('../lib/codex-config');
 const { removeClaudeHook, buildClaudeHookCommand } = require('../lib/claude-config');
+const { resolveOpencodeConfigDir, removeOpencodePlugin } = require('../lib/opencode-config');
 
 async function cmdUninstall(argv) {
   const opts = parseArgs(argv);
@@ -14,6 +15,7 @@ async function cmdUninstall(argv) {
   const codeHome = process.env.CODE_HOME || path.join(home, '.code');
   const codeConfigPath = path.join(codeHome, 'config.toml');
   const claudeSettingsPath = path.join(home, '.claude', 'settings.json');
+  const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
   const notifyPath = path.join(binDir, 'notify.cjs');
   const notifyOriginalPath = path.join(trackerDir, 'codex_notify_original.json');
   const codeNotifyOriginalPath = path.join(trackerDir, 'code_notify_original.json');
@@ -24,6 +26,7 @@ async function cmdUninstall(argv) {
   const codexConfigExists = await isFile(codexConfigPath);
   const codeConfigExists = await isFile(codeConfigPath);
   const claudeConfigExists = await isFile(claudeSettingsPath);
+  const opencodeConfigExists = await isDir(opencodeConfigDir);
   const codexRestore = codexConfigExists
     ? await restoreCodexNotify({
         codexConfigPath,
@@ -41,6 +44,9 @@ async function cmdUninstall(argv) {
   const claudeRemove = claudeConfigExists
     ? await removeClaudeHook({ settingsPath: claudeSettingsPath, hookCommand: claudeHookCommand })
     : { removed: false, skippedReason: 'config-missing' };
+  const opencodeRemove = opencodeConfigExists
+    ? await removeOpencodePlugin({ configDir: opencodeConfigDir })
+    : { removed: false, skippedReason: 'config-missing' };
 
   // Remove installed notify handler.
   await fs.unlink(notifyPath).catch(() => {});
@@ -76,6 +82,15 @@ async function cmdUninstall(argv) {
             ? '- Claude hooks: no change'
             : '- Claude hooks: skipped'
         : '- Claude hooks: skipped (settings.json not found)',
+      opencodeConfigExists
+        ? opencodeRemove?.removed
+          ? `- Opencode plugin removed: ${opencodeConfigDir}`
+          : opencodeRemove?.skippedReason === 'plugin-missing'
+            ? '- Opencode plugin: no change'
+            : opencodeRemove?.skippedReason === 'unexpected-content'
+              ? '- Opencode plugin: skipped (unexpected content)'
+              : '- Opencode plugin: skipped'
+        : `- Opencode plugin: skipped (${opencodeConfigDir} not found)`,
       opts.purge ? `- Purged: ${path.join(home, '.vibescore')}` : '- Purge: skipped (use --purge)',
       ''
     ].join('\n')
@@ -102,3 +117,12 @@ async function isFile(p) {
     return false;
   }
 }
+
+async function isDir(p) {
+  try {
+    const st = await fs.stat(p);
+    return st.isDirectory();
+  } catch (_e) {
+    return false;
+  }
+}

package/src/lib/diagnostics.js

@@ -5,6 +5,7 @@ const fs = require('node:fs/promises');
 const { readJson } = require('./fs');
 const { readCodexNotify, readEveryCodeNotify } = require('./codex-config');
 const { isClaudeHookConfigured, buildClaudeHookCommand } = require('./claude-config');
+const { resolveOpencodeConfigDir, isOpencodePluginInstalled } = require('./opencode-config');
 const { normalizeState: normalizeUploadState } = require('./upload-throttle');
 
 async function collectTrackerDiagnostics({
@@ -24,6 +25,7 @@ async function collectTrackerDiagnostics({
   const codexConfigPath = path.join(codexHome, 'config.toml');
   const codeConfigPath = path.join(codeHome, 'config.toml');
   const claudeConfigPath = path.join(home, '.claude', 'settings.json');
+  const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
 
   const config = await readJson(configPath);
   const cursors = await readJson(cursorsPath);
@@ -49,6 +51,7 @@ async function collectTrackerDiagnostics({
     settingsPath: claudeConfigPath,
     hookCommand: claudeHookCommand
   });
+  const opencodePluginConfigured = await isOpencodePluginInstalled({ configDir: opencodeConfigDir });
 
   const lastSuccessAt = uploadThrottle.lastSuccessMs ? new Date(uploadThrottle.lastSuccessMs).toISOString() : null;
   const autoRetryAt = parseEpochMsToIso(autoRetry?.retryAtMs);
@@ -68,7 +71,8 @@ async function collectTrackerDiagnostics({
       codex_config: redactValue(codexConfigPath, home),
       code_home: redactValue(codeHome, home),
       code_config: redactValue(codeConfigPath, home),
-      claude_config: redactValue(claudeConfigPath, home)
+      claude_config: redactValue(claudeConfigPath, home),
+      opencode_config: redactValue(opencodeConfigDir, home)
     },
     config: {
       base_url: typeof config?.baseUrl === 'string' ? config.baseUrl : null,
@@ -93,7 +97,8 @@ async function collectTrackerDiagnostics({
       codex_notify: codexNotify,
       every_code_notify_configured: everyCodeConfigured,
       every_code_notify: everyCodeNotify,
-      claude_hook_configured: claudeHookConfigured
+      claude_hook_configured: claudeHookConfigured,
+      opencode_plugin_configured: opencodePluginConfigured
     },
     upload: {
       last_success_at: lastSuccessAt,

package/src/lib/opencode-config.js

@@ -0,0 +1,98 @@
+const os = require('node:os');
+const path = require('node:path');
+const fs = require('node:fs/promises');
+
+const { ensureDir } = require('./fs');
+
+const DEFAULT_PLUGIN_NAME = 'vibescore-tracker.js';
+const PLUGIN_MARKER = 'VIBESCORE_TRACKER_PLUGIN';
+const DEFAULT_EVENT = 'session.idle';
+
+function resolveOpencodeConfigDir({ home = os.homedir(), env = process.env } = {}) {
+  const explicit = typeof env.OPENCODE_CONFIG_DIR === 'string' ? env.OPENCODE_CONFIG_DIR.trim() : '';
+  if (explicit) return path.resolve(explicit);
+  const xdg = typeof env.XDG_CONFIG_HOME === 'string' ? env.XDG_CONFIG_HOME.trim() : '';
+  const base = xdg || path.join(home, '.config');
+  return path.join(base, 'opencode');
+}
+
+function resolveOpencodePluginDir({ configDir }) {
+  return path.join(configDir, 'plugin');
+}
+
+function buildOpencodePlugin({ notifyPath }) {
+  const safeNotifyPath = typeof notifyPath === 'string' ? notifyPath : '';
+  return `// ${PLUGIN_MARKER}\n` +
+    `const notifyPath = ${JSON.stringify(safeNotifyPath)};\n` +
+    `export const VibeScorePlugin = async ({ $ }) => {\n` +
+    `  return {\n` +
+    `    event: async ({ event }) => {\n` +
+    `      if (!event || event.type !== ${JSON.stringify(DEFAULT_EVENT)}) return;\n` +
+    `      try {\n` +
+    `        if (!notifyPath) return;\n` +
+    `        const proc = $\\\`/usr/bin/env node ${'${notifyPath}'} --source=opencode\\\`;\n` +
+    `        if (proc && typeof proc.catch === 'function') proc.catch(() => {});\n` +
+    `      } catch (_) {}\n` +
+    `    }\n` +
+    `  };\n` +
+    `};\n`;
+}
+
+async function upsertOpencodePlugin({
+  configDir,
+  notifyPath,
+  pluginName = DEFAULT_PLUGIN_NAME
+}) {
+  if (!configDir) return { changed: false, pluginPath: null, skippedReason: 'config-missing' };
+  const pluginDir = resolveOpencodePluginDir({ configDir });
+  const pluginPath = path.join(pluginDir, pluginName);
+  const next = buildOpencodePlugin({ notifyPath });
+  const existing = await fs.readFile(pluginPath, 'utf8').catch(() => null);
+
+  if (existing === next) {
+    return { changed: false, pluginPath, skippedReason: null };
+  }
+
+  await ensureDir(pluginDir);
+
+  let backupPath = null;
+  if (existing != null) {
+    backupPath = `${pluginPath}.bak.${new Date().toISOString().replace(/[:.]/g, '-')}`;
+    await fs.copyFile(pluginPath, backupPath).catch(() => {});
+  }
+
+  await fs.writeFile(pluginPath, next, 'utf8');
+  return { changed: true, pluginPath, backupPath, skippedReason: null };
+}
+
+async function removeOpencodePlugin({ configDir, pluginName = DEFAULT_PLUGIN_NAME }) {
+  if (!configDir) return { removed: false, skippedReason: 'config-missing' };
+  const pluginPath = path.join(resolveOpencodePluginDir({ configDir }), pluginName);
+  const existing = await fs.readFile(pluginPath, 'utf8').catch(() => null);
+  if (existing == null) return { removed: false, skippedReason: 'plugin-missing' };
+  if (!hasPluginMarker(existing)) return { removed: false, skippedReason: 'unexpected-content' };
+  await fs.unlink(pluginPath).catch(() => {});
+  return { removed: true, skippedReason: null };
+}
+
+async function isOpencodePluginInstalled({ configDir, pluginName = DEFAULT_PLUGIN_NAME }) {
+  if (!configDir) return false;
+  const pluginPath = path.join(resolveOpencodePluginDir({ configDir }), pluginName);
+  const existing = await fs.readFile(pluginPath, 'utf8').catch(() => null);
+  if (!existing) return false;
+  return hasPluginMarker(existing);
+}
+
+function hasPluginMarker(text) {
+  return typeof text === 'string' && text.includes(PLUGIN_MARKER);
+}
+
+module.exports = {
+  DEFAULT_PLUGIN_NAME,
+  resolveOpencodeConfigDir,
+  resolveOpencodePluginDir,
+  buildOpencodePlugin,
+  upsertOpencodePlugin,
+  removeOpencodePlugin,
+  isOpencodePluginInstalled
+};

package/src/lib/rollout.js

@@ -61,6 +61,14 @@ async function listGeminiSessionFiles(tmpDir) {
   return out;
 }
 
+async function listOpencodeMessageFiles(storageDir) {
+  const out = [];
+  const messageDir = path.join(storageDir, 'message');
+  await walkOpencodeMessages(messageDir, out);
+  out.sort((a, b) => a.localeCompare(b));
+  return out;
+}
+
 async function parseRolloutIncremental({ rolloutFiles, cursors, queuePath, onProgress, source }) {
   await ensureDir(path.dirname(queuePath));
   let filesProcessed = 0;
@@ -270,6 +278,91 @@ async function parseGeminiIncremental({ sessionFiles, cursors, queuePath, onProg
   return { filesProcessed, eventsAggregated, bucketsQueued };
 }
 
+async function parseOpencodeIncremental({ messageFiles, cursors, queuePath, onProgress, source }) {
+  await ensureDir(path.dirname(queuePath));
+  let filesProcessed = 0;
+  let eventsAggregated = 0;
+
+  const cb = typeof onProgress === 'function' ? onProgress : null;
+  const files = Array.isArray(messageFiles) ? messageFiles : [];
+  const totalFiles = files.length;
+  const hourlyState = normalizeHourlyState(cursors?.hourly);
+  const touchedBuckets = new Set();
+  const defaultSource = normalizeSourceInput(source) || 'opencode';
+
+  if (!cursors.files || typeof cursors.files !== 'object') {
+    cursors.files = {};
+  }
+
+  for (let idx = 0; idx < files.length; idx++) {
+    const entry = files[idx];
+    const filePath = typeof entry === 'string' ? entry : entry?.path;
+    if (!filePath) continue;
+    const fileSource =
+      typeof entry === 'string' ? defaultSource : normalizeSourceInput(entry?.source) || defaultSource;
+    const st = await fs.stat(filePath).catch(() => null);
+    if (!st || !st.isFile()) continue;
+
+    const key = filePath;
+    const prev = cursors.files[key] || null;
+    const inode = st.ino || 0;
+    const size = Number.isFinite(st.size) ? st.size : 0;
+    const mtimeMs = Number.isFinite(st.mtimeMs) ? st.mtimeMs : 0;
+    const unchanged = prev && prev.inode === inode && prev.size === size && prev.mtimeMs === mtimeMs;
+    if (unchanged) {
+      filesProcessed += 1;
+      if (cb) {
+        cb({
+          index: idx + 1,
+          total: totalFiles,
+          filePath,
+          filesProcessed,
+          eventsAggregated,
+          bucketsQueued: touchedBuckets.size
+        });
+      }
+      continue;
+    }
+
+    const lastTotals = prev && prev.inode === inode ? prev.lastTotals || null : null;
+    const result = await parseOpencodeMessageFile({
+      filePath,
+      lastTotals,
+      hourlyState,
+      touchedBuckets,
+      source: fileSource
+    });
+
+    cursors.files[key] = {
+      inode,
+      size,
+      mtimeMs,
+      lastTotals: result.lastTotals,
+      updatedAt: new Date().toISOString()
+    };
+
+    filesProcessed += 1;
+    eventsAggregated += result.eventsAggregated;
+
+    if (cb) {
+      cb({
+        index: idx + 1,
+        total: totalFiles,
+        filePath,
+        filesProcessed,
+        eventsAggregated,
+        bucketsQueued: touchedBuckets.size
+      });
+    }
+  }
+
+  const bucketsQueued = await enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets });
+  hourlyState.updatedAt = new Date().toISOString();
+  cursors.hourly = hourlyState;
+
+  return { filesProcessed, eventsAggregated, bucketsQueued };
+}
+
 async function parseRolloutFile({
   filePath,
   startOffset,
@@ -457,6 +550,37 @@ async function parseGeminiFile({
   };
 }
 
+async function parseOpencodeMessageFile({ filePath, lastTotals, hourlyState, touchedBuckets, source }) {
+  const raw = await fs.readFile(filePath, 'utf8').catch(() => '');
+  if (!raw.trim()) return { lastTotals, eventsAggregated: 0 };
+
+  let msg;
+  try {
+    msg = JSON.parse(raw);
+  } catch (_e) {
+    return { lastTotals, eventsAggregated: 0 };
+  }
+
+  const currentTotals = normalizeOpencodeTokens(msg?.tokens);
+  if (!currentTotals) return { lastTotals, eventsAggregated: 0 };
+
+  const delta = diffGeminiTotals(currentTotals, lastTotals);
+  if (!delta || isAllZeroUsage(delta)) return { lastTotals: currentTotals, eventsAggregated: 0 };
+
+  const timestampMs = coerceEpochMs(msg?.time?.completed) || coerceEpochMs(msg?.time?.created);
+  if (!timestampMs) return { lastTotals, eventsAggregated: 0 };
+
+  const tsIso = new Date(timestampMs).toISOString();
+  const bucketStart = toUtcHalfHourStart(tsIso);
+  if (!bucketStart) return { lastTotals, eventsAggregated: 0 };
+
+  const model = normalizeModelInput(msg?.modelID) || DEFAULT_MODEL;
+  const bucket = getHourlyBucket(hourlyState, source, model, bucketStart);
+  addTotals(bucket.totals, delta);
+  touchedBuckets.add(bucketKey(source, model, bucketStart));
+  return { lastTotals: currentTotals, eventsAggregated: 1 };
+}
+
 async function enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets }) {
   if (!touchedBuckets || touchedBuckets.size === 0) return 0;
 
@@ -984,6 +1108,23 @@ function normalizeGeminiTokens(tokens) {
   };
 }
 
+function normalizeOpencodeTokens(tokens) {
+  if (!tokens || typeof tokens !== 'object') return null;
+  const input = toNonNegativeInt(tokens.input);
+  const output = toNonNegativeInt(tokens.output);
+  const reasoning = toNonNegativeInt(tokens.reasoning);
+  const cached = toNonNegativeInt(tokens.cache?.read);
+  const total = input + output + reasoning;
+
+  return {
+    input_tokens: input,
+    cached_input_tokens: cached,
+    output_tokens: output,
+    reasoning_output_tokens: reasoning,
+    total_tokens: total
+  };
+}
+
 function sameGeminiTotals(a, b) {
   if (!a || !b) return false;
   return (
@@ -1125,6 +1266,13 @@ function toNonNegativeInt(v) {
   return Math.floor(n);
 }
 
+function coerceEpochMs(v) {
+  const n = Number(v);
+  if (!Number.isFinite(n) || n <= 0) return 0;
+  if (n < 1e12) return Math.floor(n * 1000);
+  return Math.floor(n);
+}
+
 async function safeReadDir(dir) {
   try {
     return await fs.readdir(dir, { withFileTypes: true });
@@ -1145,11 +1293,25 @@ async function walkClaudeProjects(dir, out) {
   }
 }
 
+async function walkOpencodeMessages(dir, out) {
+  const entries = await safeReadDir(dir);
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await walkOpencodeMessages(fullPath, out);
+      continue;
+    }
+    if (entry.isFile() && entry.name.startsWith('msg_') && entry.name.endsWith('.json')) out.push(fullPath);
+  }
+}
+
 module.exports = {
   listRolloutFiles,
   listClaudeProjectFiles,
   listGeminiSessionFiles,
+  listOpencodeMessageFiles,
   parseRolloutIncremental,
   parseClaudeIncremental,
-  parseGeminiIncremental
+  parseGeminiIncremental,
+  parseOpencodeIncremental
 };