oc2token 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kaan Yaren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,399 @@
+<p align="center">
+  <img src="assets/screenshots/dashboard.svg" width="100%" alt="OC2Token dashboard — day view with three window cards, trend sparkline and breakdown tables" />
+</p>
+
+<h1 align="center">OC2Token</h1>
+
+<p align="center">
+  <strong>macOS-first terminal dashboard for OpenCode&nbsp;2 token usage</strong><br/>
+  Unified, privacy-preserving telemetry for <code>opencode</code> · <code>codex</code> · <code>antigravity</code>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/oc2token"><img src="https://img.shields.io/npm/v/oc2token?style=flat-square&color=8B5CF6&label=npm" alt="npm version" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-ff8700?style=flat-square" alt="MIT license" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-00d7ff?style=flat-square" alt="node >=20" /></a>
+  <a href="#platform"><img src="https://img.shields.io/badge/platform-macOS%20%E2%80%A2%20Linux-lightgrey?style=flat-square" alt="macOS • Linux" /></a>
+  <a href="https://github.com/kaanyaren/OC2Token/issues"><img src="https://img.shields.io/github/issues/kaanyaren/OC2Token?style=flat-square&color=9a8fc2" alt="issues" /></a>
+</p>
+
+<p align="center">
+  <code>npx oc2token</code>&ensp;·&ensp;<code>oc2token day</code>&ensp;·&ensp;<code>oc2token --json</code>&ensp;·&ensp;<code>oc2token doctor</code>
+</p>
+
+---
+
+### Why OC2Token?
+
+OpenCode 2 records rich token telemetry locally, but the raw message stream is noisy and per-provider. **OC2Token** is a single, fast, terminal-native console that:
+
+- aggregates **all three providers** (`opencode`, `codex`, `antigravity`) into one unified report
+- shows three exact windows — **last 60 minutes · today · this week** — with local-day and ISO-week semantics
+- visualises a **sparkline trend**, per-model / per-provider / per-project breakdowns, and coverage status without ever persisting prompts or keys
+- stays instantly usable over pipes (`--json`, `--format table`) for CI and scripting
+
+> `recorded_total = input + output + reasoning + cacheRead + cacheWrite` — an explicit accounting sum, **not** a billing or quota total.
+
+---
+
+## ✨ Highlights
+
+- **Unified multi-provider** — one snapshot, one schema, three colours (purple · orange · cyan)
+- **Three exact windows** rendered side-by-side, responsive down to 20 columns
+- **CodeBurn-inspired palette** — violet structure, orange focus, cyan inputs; `--no-color` / `NO_COLOR` safe
+- **Trend sparkline** per window, not one row per bucket
+- **Privacy by design** — only normalized token counters are cached; no prompts, tool inputs, or session titles are stored
+- **Resilient collection** — paginated assistant-message aggregation with retry, dedup by `tokenRevision`, fallback when the filtered stats API ignores the range
+- **Scriptable** — stable JSON `schemaVersion: 3`, deterministic table output, exit codes `0` / `1` / `3`
+
+---
+
+## 📸 Preview
+
+<table>
+<tr>
+<td width="50%">
+
+**Dashboard — day (100 cols)**
+<br/>Three cards + inline provider stack + trend
+
+<img src="assets/screenshots/dashboard.svg" alt="Dashboard day view" />
+
+</td>
+<td width="50%">
+
+**Settings overlay — `s`**
+<br/>Toggle providers, scrub refresh interval
+
+<img src="assets/screenshots/dashboard-settings.svg" alt="Settings overlay" />
+
+</td>
+</tr>
+<tr>
+<td>
+
+**Projects — `p`**
+<br/>Per-project totals scoped to the selected window
+
+<img src="assets/screenshots/dashboard-projects.svg" alt="Projects overlay" />
+
+</td>
+<td>
+
+**Narrow — 60 cols**
+<br/>Stacks vertically, never wraps
+
+<img src="assets/screenshots/dashboard-narrow.svg" alt="Narrow 60-col layout" />
+
+</td>
+</tr>
+</table>
+
+<details>
+<summary>More screenshots</summary>
+
+| View | Screenshot |
+|------|------------|
+| Hour (`1` / `oc2token hour`) | ![hour](assets/screenshots/dashboard-hour.svg) |
+| Help (`?`) | ![help](assets/screenshots/dashboard-help.svg) |
+| Table pipe (`--format table`) | ![table](assets/screenshots/table.svg) |
+
+</details>
+
+---
+
+## 📦 Installation
+
+### npm / npx (recommended)
+
+```sh
+npm install -g oc2token
+# or without installing
+npx oc2token
+```
+
+Requires **Node.js ≥ 20**. The OpenCode 2 local service must be reachable; OC2Token talks to it via `@opencode-ai/client` (beta API subject to change).
+
+### From source
+
+```sh
+git clone https://github.com/kaanyaren/OC2Token.git
+cd OC2Token
+npm install
+npm run build
+npm link          # or: node dist/src/cli.js --help
+```
+
+### Verify
+
+```sh
+oc2token doctor          # human-readable health checks
+oc2token doctor --json   # machine-readable
+oc2token --help
+```
+
+---
+
+## 🚀 Quick start
+
+```sh
+oc2token                # interactive dashboard, refreshes every 5 min
+oc2token hour           # start on the rolling last-60-minutes card
+oc2token day            # start on today's local-calendar day
+oc2token week           # start on the ISO week (Mon–Sun)
+
+oc2token --once --json  # one-shot JSON for scripting
+oc2token --format table # deterministic plain table (great for pipes)
+oc2token --refresh 0    # manual-only; press r to refresh
+oc2token --timezone Europe/Istanbul  # override the local zone
+oc2token --no-color     # or NO_COLOR=1 for plain output
+```
+
+---
+
+## 🎮 Interactive dashboard
+
+| Key / Click | Action |
+|-------------|--------|
+| `r` / `R` | Refresh now |
+| `1` / `2` / `3` · **click top card** | Select **hour · day · week** |
+| `Tab` / `←` `→` / `↑` `↓` | Cycle windows |
+| `p` | Projects panel |
+| `s` | Settings — toggle providers, adjust refresh |
+| `?` | Help |
+| `q` / `Ctrl+C` | Quit |
+
+Settings persist under the cache directory (`~/.cache/oc2token` on macOS/Linux or `$XDG_CACHE_HOME`). At least one provider must stay enabled.
+
+**Theme.** Purple carries structure, orange carries activity and focus, cyan carries inputs. Respects `NO_COLOR` and `--no-color`.
+
+---
+
+## 🖥️ CLI reference
+
+```
+oc2token 0.1.0
+
+Usage:
+  oc2token [hour|day|week]
+  oc2token [options]
+  oc2token doctor [--source <provider>] [--json]
+
+Options:
+  --once                 Collect once and exit
+  --json                 Emit stable JSON and exit
+  --format <mode>        auto, dashboard, table, or json
+  --refresh <seconds>    Auto-refresh cadence; 0 is manual-only (60–14400)
+  --timezone <IANA>      Zone for local day / ISO week boundaries
+  --project <id>         Restrict collection to an OpenCode project
+  --cache-dir <path>     Override the normalized metadata cache directory
+  --source <provider>    Filter providers: opencode, codex, antigravity, or all (repeatable)
+  --no-color             Disable ANSI colors
+  -h, --help             Show help
+  -v, --version          Show version
+```
+
+### Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success, complete coverage |
+| `1` | Connection / validation / usage error |
+| `3` | Partial results — JSON emitted but coverage incomplete |
+
+### Filtering providers
+
+```sh
+oc2token --source codex                 # only Codex
+oc2token --source opencode --source codex  # two providers
+oc2token --source all                   # reset filter (default)
+oc2token doctor --source antigravity --json
+```
+
+Combine with `--once` / `--json` for scripting:
+
+```sh
+oc2token --once --json --source codex | jq .totals.day.recorded_total
+```
+
+---
+
+## 🔌 Providers
+
+| Provider | Source | Discovery |
+|----------|--------|-----------|
+| **opencode** | OpenCode 2 local service (`@opencode-ai/client`) | session/message pagination with `tokenRevision` dedup |
+| **codex** | `~/.codex/sessions` rollouts (JSONL) | file scan + parse |
+| **antigravity** | Antigravity SQLite + session JSON | proto + scanner |
+
+All three emit the same `UsageRecord` shape and are merged by `Aggregator → CachedUsageSource → Dashboard`. `doctor` reports each independently:
+
+```sh
+oc2token doctor
+# oc2token doctor: OK
+# ✓ opencode: OpenCode 2 service OK
+# ✓ codex: 14 sessions scanned
+# ✓ antigravity: 3 projects indexed
+```
+
+---
+
+## 📊 Output formats
+
+### Table (pipes & logs)
+
+No ANSI, deterministic — safe for `grep`, `awk`, `less`:
+
+```sh
+oc2token --format table
+```
+
+<p align="center"><img src="assets/screenshots/table.svg" width="100%" alt="Table output" /></p>
+
+### JSON (`schemaVersion: 3`)
+
+```sh
+oc2token --json | jq .
+oc2token --once --json > snapshot.json
+```
+
+Emits **all three windows**, `totalsByProvider`/`totalsByProject`, trends, and coverage in one stable contract:
+
+```json
+{
+  "schemaVersion": 3,
+  "source": "unified",
+  "version": "0.1.0",
+  "windows": { "hour": { "kind": "hour", "from": "…", "to": "…", "label": "last 60 minutes" }, "day": {}, "week": {} },
+  "totals": { "hour": { "recorded_total": 15582 }, "day": {}, "week": {} },
+  "providersByWindow": { "day": [ { "name": "openai", "totals": {} } ] },
+  "totalsByProvider": { "day": { "openai": { "recorded_total": 21785 } } },
+  "coverage": { "complete": true, "sessionsScanned": 14, "sessionsDiscovered": 14 }
+}
+```
+
+Use `--format json` for pretty-printed JSON without exiting interactive mode fallback.
+
+---
+
+## ⚙️ Configuration
+
+| Option | CLI | Env / Persisted |
+|--------|-----|-----------------|
+| Timezone | `--timezone Europe/Berlin` | Local system zone by default; validated as IANA |
+| Refresh | `--refresh 300` (60–14400, `0` manual) | Persisted via Settings panel (`s`) |
+| Cache dir | `--cache-dir /tmp/oc2` | `~/.cache/oc2token` / `$XDG_CACHE_HOME/oc2token` |
+| Project filter | `--project my-project` | Scopes OpenCode collection only |
+| Providers | `--source codex` | Persisted via Settings panel |
+| Color | `--no-color` | `NO_COLOR=1` disables all ANSI |
+
+A corrupt or future cache is ignored — the live service is always the authority; the cache is an optimization.
+
+---
+
+## 🔒 Privacy
+
+OC2Token stores **only normalized usage metadata**:
+
+- `input`, `output`, `reasoning`, `cacheRead`, `cacheWrite`, `recorded_total`, model / provider / project names, timestamps
+
+It **does not** persist:
+
+- prompts, tool input/output, API keys, session titles, message bodies
+
+All collection is local-first; no network calls besides the loopback OpenCode service.
+
+---
+
+## 🧭 How it works
+
+```
+┌─────────────┐  ┌─────────────┐  ┌──────────────┐
+│  opencode   │  │    codex    │  │ antigravity  │
+│ transport   │  │   scanner   │  │   scanner    │
+└──────┬──────┘  └──────┬──────┘  └──────┬───────┘
+       │                │                │
+       └────────────────┼────────────────┘
+                        ▼
+                 ┌─────────────┐
+                 │ Aggregator  │  dedup by sessionID/messageID + tokenRevision
+                 └──────┬──────┘
+                        ▼
+                 ┌──────────────┐  file lock · schema 1 · atomic writes
+                 │ CachedUsage  │
+                 └──────┬──────┘
+                        ▼
+              ┌───────────────────┐
+              │  dashboard / json │  normalize → renderDashboard | renderTable | renderJSON
+              └───────────────────┘
+```
+
+- Windows are derived with `Intl.DateTimeFormat` — including DST-aware local-day resolution.
+- Filtered stats responses are range-validated; if the service ignores the range, OC2Token falls back to full pagination rather than mislabelling all-time usage as filtered.
+
+---
+
+## 🛠️ Development
+
+```sh
+npm install
+npm test            # build + node --test
+npm run typecheck
+npm run pack:check  # dry-run npm pack
+npm run build
+```
+
+Project layout:
+
+```
+src/
+  accounting/   reducer for normalized records
+  collector/    parallel/serial message collection
+  opencode/     transport & doctor
+  codex/        rollout discovery & scanner
+  antigravity/  sqlite + proto + scanner
+  cache/        filesystem lock & store (schema 1)
+  dashboard/    render, state, settings
+  domain/       windows, tokens, records, contracts
+  output/       dashboard / table / json renderers
+```
+
+**Testing.** The suite uses `node:test` with a serial oracle vs parallel aggregator equivalence check, ANSI-gating invariants, and window-boundary coverage.
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome — bug reports, new provider adapters, render polish, docs.
+
+1. Fork & create a feature branch
+2. Add tests for new behaviour (`npm test`)
+3. Run `npm run typecheck`
+4. Open a PR with a clear description and screenshots for UI changes
+
+Please read the [MIT License](LICENSE). By contributing you agree to license your contributions under the same terms.
+
+> Be kind. This project follows the spirit of the [Contributor Covenant](https://www.contributor-covenant.org/).
+
+---
+
+## 🙏 Acknowledgments
+
+- [OpenCode 2](https://github.com/sst/opencode) for the local token telemetry API
+- The CodeBurn palette inspiration (violet · orange · cyan)
+- Built with TypeScript, `node:test`, and a lot of terminal love
+
+---
+
+## 📄 License
+
+MIT © 2026 [Kaan Yaren](https://github.com/kaanyaren)
+
+See [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">
+  <sub>OC2Token is not affiliated with OpenCode. <code>recorded_total</code> is an accounting sum — not a billing total.</sub><br/>
+  <sub><a href="https://github.com/kaanyaren/OC2Token">github.com/kaanyaren/OC2Token</a> · <code>npm i -g oc2token</code></sub>
+</p>

package/dist/src/accounting/index.d.ts

@@ -0,0 +1 @@
+export { UsageRecordReducer, compareFreshness, reduceUsageRecords, sumRecordComponents, } from "./reducer.js";

package/dist/src/accounting/index.js

@@ -0,0 +1,2 @@
+export { UsageRecordReducer, compareFreshness, reduceUsageRecords, sumRecordComponents, } from "./reducer.js";
+//# sourceMappingURL=index.js.map

package/dist/src/accounting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/accounting/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/src/accounting/reducer.d.ts

@@ -0,0 +1,21 @@
+import { type UsageTotals } from "../domain/index.js";
+import { type UsageRecord, type UsageWindow } from "../domain/index.js";
+/**
+ * A deterministic, synchronous reducer for usage records.
+ *
+ * Workers never mutate this reducer while they are reading pages. Callers can
+ * feed records in any completion order and the winner is selected by observed
+ * time, revision, and finally completeness, rather than arrival order.
+ */
+export declare class UsageRecordReducer {
+    private readonly byKey;
+    upsert(record: UsageRecord): boolean;
+    upsertMany(records: ReadonlyArray<UsageRecord>): void;
+    get size(): number;
+    get(key: string): UsageRecord | undefined;
+    records(): ReadonlyArray<UsageRecord>;
+    totals(window: UsageWindow, includeProvisional?: boolean): UsageTotals;
+}
+export declare function compareFreshness(left: UsageRecord, right: UsageRecord): number;
+export declare function reduceUsageRecords(records: ReadonlyArray<UsageRecord>): ReadonlyArray<UsageRecord>;
+export declare function sumRecordComponents(records: ReadonlyArray<UsageRecord>): UsageTotals;

package/dist/src/accounting/reducer.js

@@ -0,0 +1,105 @@
+import { parseTokenComponents, toUsageTotals, } from "../domain/index.js";
+import { sumUsageRecords, } from "../domain/index.js";
+const COMPONENTS = ["input", "output", "reasoning", "cacheRead", "cacheWrite"];
+function compareRevision(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    // Explicit numeric revisions are common in test transports and are the only
+    // safe way to compare revisions such as 9 and 10 lexically.
+    const leftNumber = /(?:^|:)(?:v)?(\d+)$/.exec(left)?.[1];
+    const rightNumber = /(?:^|:)(?:v)?(\d+)$/.exec(right)?.[1];
+    if (leftNumber !== undefined && rightNumber !== undefined) {
+        const difference = Number(leftNumber) - Number(rightNumber);
+        if (difference !== 0) {
+            return difference;
+        }
+    }
+    const leftScan = /^scan:(\d+):/.exec(left)?.[1];
+    const rightScan = /^scan:(\d+):/.exec(right)?.[1];
+    if (leftScan !== undefined && rightScan !== undefined) {
+        const difference = Number(leftScan) - Number(rightScan);
+        if (difference !== 0)
+            return difference;
+    }
+    return left < right ? -1 : 1;
+}
+/**
+ * A deterministic, synchronous reducer for usage records.
+ *
+ * Workers never mutate this reducer while they are reading pages. Callers can
+ * feed records in any completion order and the winner is selected by observed
+ * time, revision, and finally completeness, rather than arrival order.
+ */
+export class UsageRecordReducer {
+    byKey = new Map();
+    upsert(record) {
+        const previous = this.byKey.get(record.key);
+        if (previous === undefined || compareFreshness(record, previous) > 0) {
+            this.byKey.set(record.key, record);
+            return true;
+        }
+        return false;
+    }
+    upsertMany(records) {
+        for (const record of records) {
+            this.upsert(record);
+        }
+    }
+    get size() {
+        return this.byKey.size;
+    }
+    get(key) {
+        return this.byKey.get(key);
+    }
+    records() {
+        return [...this.byKey.values()].sort((left, right) => left.key.localeCompare(right.key));
+    }
+    totals(window, includeProvisional = false) {
+        return sumUsageRecords(this.records(), window, { includeProvisional });
+    }
+}
+export function compareFreshness(left, right) {
+    const observedDifference = left.observedAt.getTime() - right.observedAt.getTime();
+    if (observedDifference !== 0) {
+        return observedDifference;
+    }
+    const revisionDifference = compareRevision(left.tokenRevision, right.tokenRevision);
+    if (revisionDifference !== 0) {
+        return revisionDifference;
+    }
+    // A final observation supersedes a provisional observation at the same
+    // revision. This matters when a streaming message settles in one refresh.
+    if (left.completeness !== right.completeness) {
+        return left.completeness === "final" ? 1 : -1;
+    }
+    // Identical revisions should be byte-equivalent for accounting purposes. A
+    // stable key tie-break keeps the comparator total without using arrival order.
+    return left.key.localeCompare(right.key);
+}
+export function reduceUsageRecords(records) {
+    const reducer = new UsageRecordReducer();
+    reducer.upsertMany(records);
+    return reducer.records();
+}
+export function sumRecordComponents(records) {
+    const totals = {
+        input: 0,
+        output: 0,
+        reasoning: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+    };
+    for (const record of records) {
+        const normalized = parseTokenComponents(record);
+        for (const component of COMPONENTS) {
+            const next = totals[component] + normalized[component];
+            if (!Number.isSafeInteger(next)) {
+                throw new RangeError(`Summing ${component} exceeds the safe integer range`);
+            }
+            totals[component] = next;
+        }
+    }
+    return toUsageTotals(totals);
+}
+//# sourceMappingURL=reducer.js.map

package/dist/src/accounting/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../../../src/accounting/reducer.ts"],"names":[],"mappings":"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"}

package/dist/src/antigravity/discovery.d.ts

@@ -0,0 +1,18 @@
+export declare function defaultAntigravityHome(): string;
+/**
+ * Scan Antigravity SQLite conversation databases.
+ *
+ * Mirrors codeburn `conversationRoots()` (dist/main.js:1674) scanning:
+ * - ~/.gemini/antigravity/conversations
+ * - ~/.gemini/antigravity-cli/conversations
+ * - ~/.gemini/antigravity-cli/implicit
+ * - ~/.gemini/antigravity-ide/conversations
+ * - ~/.gemini/antigravity-ide/implicit
+ *
+ * Only `*.db` files are returned; `-shm`/`-wal` sidecars are ignored
+ * (they do not end with `.db`). Supports `ANTIGRAVITY_HOME` override via
+ * `resolveAntigravityHome` or explicit `root` parameter.
+ * For test fixtures `ANTIGRAVITY_HOME` may point directly to a directory
+ * containing `*.db` files — that directory is scanned as well.
+ */
+export declare function discoverAntigravityDatabases(root?: string): string[];

package/dist/src/antigravity/discovery.js

@@ -0,0 +1,95 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readdirSync } from "node:fs";
+export function defaultAntigravityHome() {
+    return join(homedir(), ".gemini");
+}
+function resolveAntigravityHome(root) {
+    if (root !== undefined) {
+        return root;
+    }
+    const env = process.env.ANTIGRAVITY_HOME;
+    if (typeof env === "string" && env.trim().length > 0) {
+        return env;
+    }
+    return defaultAntigravityHome();
+}
+/**
+ * Scan Antigravity SQLite conversation databases.
+ *
+ * Mirrors codeburn `conversationRoots()` (dist/main.js:1674) scanning:
+ * - ~/.gemini/antigravity/conversations
+ * - ~/.gemini/antigravity-cli/conversations
+ * - ~/.gemini/antigravity-cli/implicit
+ * - ~/.gemini/antigravity-ide/conversations
+ * - ~/.gemini/antigravity-ide/implicit
+ *
+ * Only `*.db` files are returned; `-shm`/`-wal` sidecars are ignored
+ * (they do not end with `.db`). Supports `ANTIGRAVITY_HOME` override via
+ * `resolveAntigravityHome` or explicit `root` parameter.
+ * For test fixtures `ANTIGRAVITY_HOME` may point directly to a directory
+ * containing `*.db` files — that directory is scanned as well.
+ */
+export function discoverAntigravityDatabases(root) {
+    const base = resolveAntigravityHome(root);
+    const seen = new Set();
+    const result = [];
+    const tryDir = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const file of entries) {
+            // Only *.db — ignore -shm/-wal sidecars and .pb files
+            if (!file.toLowerCase().endsWith(".db")) {
+                continue;
+            }
+            // Extra guard for sidecars that might be named *.db-shm / *.db-wal
+            const lower = file.toLowerCase();
+            if (lower.endsWith("-shm") || lower.endsWith("-wal") || lower.endsWith(".db-shm") || lower.endsWith(".db-wal")) {
+                continue;
+            }
+            const full = join(dir, file);
+            if (seen.has(full)) {
+                continue;
+            }
+            seen.add(full);
+            result.push(full);
+        }
+    };
+    // Direct base scan — handles ANTIGRAVITY_HOME pointing to a conversations dir
+    // or a test fixture containing .db files flat.
+    tryDir(base);
+    // Known relative paths (codeburn conversationRoots) relative to homedir base.
+    // We probe both interpretations of `base`:
+    // - base is homedir (e.g. /Users/you) -> join(base, ".gemini", ...)
+    // - base is .gemini dir (e.g. /Users/you/.gemini) -> join(base, "antigravity", ...)
+    const relativeFromHomedir = [
+        join(".gemini", "antigravity", "conversations"),
+        join(".gemini", "antigravity-cli", "conversations"),
+        join(".gemini", "antigravity-cli", "implicit"),
+        join(".gemini", "antigravity-ide", "conversations"),
+        join(".gemini", "antigravity-ide", "implicit"),
+    ];
+    const relativeFromGemini = [
+        join("antigravity", "conversations"),
+        join("antigravity-cli", "conversations"),
+        join("antigravity-cli", "implicit"),
+        join("antigravity-ide", "conversations"),
+        join("antigravity-ide", "implicit"),
+    ];
+    for (const rel of relativeFromHomedir) {
+        tryDir(join(base, rel));
+    }
+    for (const rel of relativeFromGemini) {
+        tryDir(join(base, rel));
+    }
+    // Also handle case where base is already a .gemini/antigravity-cli/conversations path's parent
+    // by not duplicating — seen set handles it.
+    result.sort();
+    return result;
+}
+//# sourceMappingURL=discovery.js.map