Merge PR #6: migrate plugin to first-class OpenCode TUI

Author: ualtinok

.github/workflows/ci.yml

@@ -20,14 +20,31 @@ jobs:
         with:
           node-version: 24
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3
+
       - name: Install dependencies
-        run: npm install
+        run: bun install --frozen-lockfile
 
       - name: Run type check
-        run: npm run typecheck
+        run: bun run typecheck
 
       - name: Build
-        run: npm run build
+        run: bun run build
+
+      - name: Smoke test TUI
+        run: bun run --cwd packages/opencode smoke:tui
 
       - name: Run tests
-        run: npm test
+        run: bun run test
+
+      - name: Run E2E tests
+        run: bun run test:e2e
+
+      - name: Check formatting
+        run: bun run format:check
+
+      - name: Lint
+        run: bun run lint

.github/workflows/release.yml

@@ -34,17 +34,34 @@ jobs:
         with:
           node-version: "24"
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3
+
       - name: Install dependencies
-        run: npm install
+        run: bun install --frozen-lockfile
 
       - name: TypeScript typecheck
-        run: npm run typecheck
+        run: bun run typecheck
 
       - name: Build
-        run: npm run build
+        run: bun run build
+
+      - name: Smoke test TUI
+        run: bun run --cwd packages/opencode smoke:tui
 
       - name: Test
-        run: npm test
+        run: bun run test
+
+      - name: Run E2E tests
+        run: bun run test:e2e
+
+      - name: Check formatting
+        run: bun run format:check
+
+      - name: Lint
+        run: bun run lint
 
   publish-npm:
     name: Publish ${{ matrix.package }} to npm
@@ -72,11 +89,16 @@ jobs:
           node-version: "24"
           registry-url: "https://registry.npmjs.org"
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3
+
       - name: Ensure latest npm (for trusted publishing)
         run: npm install -g npm@latest
 
       - name: Install dependencies
-        run: npm install
+        run: bun install --frozen-lockfile
 
       - name: Resolve release version
         id: version
@@ -89,7 +111,7 @@ jobs:
         run: node scripts/version-sync.mjs "${{ steps.version.outputs.version }}"
 
       - name: Build
-        run: npm run build
+        run: bun run build
 
       - name: Check whether package version is already published
         id: published

.gitignore

@@ -6,6 +6,9 @@ out
 dist
 *.tgz
 
+# precompiled OpenTUI sidebar tree (regenerated by build:tui)
+packages/opencode/src/tui-compiled/
+
 # code coverage
 coverage
 *.lcov

AGENTS.MD

@@ -9,19 +9,28 @@ OpenCode plugin for Google Antigravity OAuth. Intercepts `fetch()` calls to `gen
 ## Build & Test Commands
 
 ```bash
-npm install                          # Install dependencies
-npm run build                        # Compile (tsc -p tsconfig.build.json)
-npm run typecheck                    # Type-check only (tsc --noEmit)
-npm test                             # Run all tests (vitest run)
-npx vitest run src/plugin/auth.test.ts          # Single test file
-npx vitest run -t "test name here"              # Single test by name
-npx vitest --watch src/plugin/auth.test.ts      # Watch mode, single file
-npm run test:coverage                # Coverage report
-npm run test:e2e:models              # E2E: model availability check
-npm run test:e2e:regression          # E2E: regression suite
+bun install                          # Install dependencies
+bun run build                        # Compile (tsc -p tsconfig.build.json)
+bun run typecheck                    # Type-check only (tsc --noEmit)
+bun run test                         # Run all unit tests (bun test --isolate across packages)
+bun test --isolate src/plugin/auth.test.ts            # Single test file
+bun test --isolate -t "test name here"                # Single test by name (uses bun:test's -t filter)
+bun test --isolate --watch src/plugin/auth.test.ts   # Watch mode, single file
+bun run test:e2e                     # Deterministic e2e flows (mock Antigravity server, no network)
+bun run test:e2e:models              # Live Antigravity model inventory (CI-gated, network)
+bun run test:e2e:regression          # Cross-model + Gemini CLI regression (network)
+bun run --cwd packages/opencode smoke:tui            # Pack-and-install smoke test for the TUI subpath
 ```
 
-No linter or formatter is configured. Style is enforced by convention (see below).
+Format and lint via Biome:
+
+```bash
+bun run format                       # biome format --write .
+bun run format:check                 # biome format .  (CI gate)
+bun run lint                         # biome lint .     (CI gate)
+```
+
+Pre-commit hooks (`.lefthook.yml`) run Biome on changed `*.{ts,tsx,js,mjs,json,jsonc,yml,yaml}` files via `bunx biome check --staged --no-errors-on-unmatched`. The repo pins the toolchain in `mise.toml` (`bun = "1.3"`, `node = "24"`) and CI uses `oven-sh/setup-bun@v2` with `bun-version: 1.3`.
 
 ## TypeScript Configuration
 
@@ -70,7 +79,7 @@ No linter or formatter is configured. Style is enforced by convention (see below
 
 ### Formatting
 - 2-space indentation
-- Double quotes for strings
+- Single quotes for strings (Biome `quoteStyle: single`)
 - Trailing commas in multiline constructs
 - No semicolons (project convention)
 
@@ -80,24 +89,49 @@ No linter or formatter is configured. Style is enforced by convention (see below
 
 ## Module Structure
 
+The repository is a Bun workspace with three packages. The pre-monorepo
+single-root-`src/` layout was retired when the project split into
+`packages/{core,opencode,pi}` so the harness-agnostic engine, the host
+adapter, and the Pi host can ship on independent cadences.
+
 ```
-src/
-├── plugin.ts                # Main entry, fetch interceptor
-├── constants.ts             # Endpoints, headers, API config, system prompts
-├── antigravity/oauth.ts     # OAuth token exchange
-└── plugin/
-    ├── auth.ts              # Token validation & refresh
-    ├── request.ts           # Request transformation (core logic)
-    ├── request-helpers.ts   # Schema cleaning, thinking filters
-    ├── thinking-recovery.ts # Turn boundary detection
-    ├── recovery.ts          # Session recovery (tool_result_missing)
-    ├── quota.ts             # Quota checking (API usage stats)
-    ├── cache.ts             # Auth & signature caching
-    ├── accounts.ts          # Multi-account management & storage
-    ├── storage.ts           # Persistent storage schemas (Zod)
-    ├── fingerprint.ts       # Device fingerprint generation & headers
-    ├── project.ts           # Managed project context resolution
-    └── debug.ts             # Debug logging utilities
+packages/
+├── core/                    # Harness-agnostic engine — auth, transform, storage, fingerprinting
+│   └── src/
+│       ├── index.ts             # Public barrel
+│       ├── account-manager.ts   # Per-account selection, rate-limit, quota, fingerprint
+│       ├── account-storage.ts   # v4 schema + lock-held read-modify-write + fail-closed unreadable
+│       ├── agy-transport.ts     # Bounded TLS pool, gzip/chunk decode, idle watchdog
+│       ├── agy-request-metadata.ts
+│       ├── antigravity/oauth.ts # OAuth token exchange + refresh
+│       ├── auth.ts              # Token validation helpers
+│       ├── file-lock.ts         # Fenced file lock for concurrent writes
+│       ├── fingerprint.ts       # Device fingerprint construction
+│       ├── model-registry.ts    # Anthropic / Gemini / GPT-OSS model definitions
+│       ├── project.ts           # Managed project resolution
+│       ├── quota-manager.ts     # Quota caching + fallbacks
+│       ├── rotation.ts          # Account rotation state
+│       └── transform/           # Claude / Gemini / cross-model sanitizer + tests
+├── opencode/                # OpenCode host adapter — plugin entry, fetch interceptor, TUI
+│   └── src/
+│       ├── cli.ts               # `antigravity-auth` CLI (login / list / quota)
+│       ├── plugin/              # Plugin factory, OAuth methods, account access, fetch
+│       │   ├── fetch-interceptor.ts  # Outer/inner loop, retry/quota/routing pipeline
+│       │   ├── auth-loader.ts   # Host `auth.loader()` integration
+│       │   ├── oauth-methods.ts # OAuth menu + callbacks
+│       │   ├── persist-account-pool.ts # Lock-held append after fresh OAuth login
+│       │   ├── storage.ts       # Host-path adapter for account pool (re-exports core errors)
+│       │   └── ui/              # TUI sidebar, auth menu, quota-status, command dialogs
+│       ├── tui/                 # Precompiled + raw TUI sources
+│       ├── rpc/                 # Loopback RPC server + client (sidebar notifications)
+│       └── hooks/               # Lifecycle hooks (auto-update checker, etc.)
+└── pi/                      # Pi host adapter — thinner facade around core
+    └── src/
+        ├── index.ts             # Public barrel — `streamCortexKitAntigravity` + OAuth helpers
+        ├── convert.ts           # Pi <-> Antigravity message-shape conversion
+        ├── credential-cache.ts # Packed refresh token cache
+        ├── paths.ts             # Pi AGENT_DIR + account-pool path resolution
+        └── stream.ts            # Stream factory consumed by `index.ts`
 ```
 
 ## Key Design Patterns
@@ -130,15 +164,19 @@ Per-account device fingerprints stored in `antigravity-accounts.json`. Each fing
 
 ## Testing
 
-- Framework: **Vitest 3** with native ESM
-- Config: `vitest.config.ts`
-- Tests colocated: `src/plugin/foo.test.ts` next to `src/plugin/foo.ts`
-- Use `describe`/`it`/`expect` — standard Vitest API
-- Mock with `vi.fn()`, `vi.spyOn()`, `vi.mock()`
+- Framework: **Bun's test runner** (`bun test`; the `bun:test` module re-exports a jest-compatible namespace)
+- Config: no per-package config — Bun discovers `*.test.ts` next to source. The `bunfig.toml` at the root and in each workspace preloads `test/setup.ts` (env-isolation + a per-test mkdtemp root + a `globalThis.stubbed` / `unstubAllGlobals` / `freshImport` helper). The e2e workspace uses `bunfig.toml` `root = "./src"` so its tests stay isolated from the unit workspace.
+- Tests colocated: `src/plugin/foo.test.ts` next to `src/plugin/foo.ts`. The e2e workspace uses `*.e2e.test.ts` so the root `bun run test` and `bun run test:e2e` selectors can target them precisely.
+- Use `describe`/`it`/`expect` from `bun:test` — the standard API.
+- Mock with `mock()`, `spyOn()`, and the `jest` namespace exported from `bun:test` (`jest.fn`, `jest.spyOn`, `jest.setSystemTime`, etc.). The `test/setup.ts` preload patches `jest.setSystemTime` / `jest.useRealTimers` so they also spy on `Date.now()` (Bun's `bun:test` clock only fakes the timer queue, not the wall clock).
 
 ## Documentation
 
 - [README.md](README.md) — Installation & usage
 - [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — Detailed architecture guide
 - [docs/ANTIGRAVITY_API_SPEC.md](docs/ANTIGRAVITY_API_SPEC.md) — API reference
 - [CHANGELOG.md](CHANGELOG.md) — Version history
+- [ARCHITECTURE.md](ARCHITECTURE.md) and [STRUCTURE.md](STRUCTURE.md) — repo-level architecture and file-system map
+- [biome.json](biome.json) — formatter + linter config
+- [lefthook.yml](lefthook.yml) — pre-commit Biome hook
+- [mise.toml](mise.toml) — pinned `bun` + `node` versions