diff --git a/.gitignore b/.gitignore
index 5ef6a52..e3a7542 100644
--- a/.gitignore
+++ b/.gitignore
@@ -39,3 +39,4 @@ yarn-error.log*
 # typescript
 *.tsbuildinfo
 next-env.d.ts
+.env*.local
diff --git a/.oxfmtrc.json b/.oxfmtrc.json
new file mode 100644
index 0000000..5106a3f
--- /dev/null
+++ b/.oxfmtrc.json
@@ -0,0 +1,5 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 120,
+  "proseWrap": "preserve"
+}
diff --git a/.oxlintrc.json b/.oxlintrc.json
new file mode 100644
index 0000000..e943e8f
--- /dev/null
+++ b/.oxlintrc.json
@@ -0,0 +1,10 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["react", "jsx-a11y", "nextjs"],
+  "env": {
+    "browser": true,
+    "node": true,
+    "es2024": true
+  },
+  "ignorePatterns": ["node_modules/**", ".next/**", "out/**", "build/**", "next-env.d.ts"]
+}
diff --git a/ORCA_REFERENCE.md b/ORCA_REFERENCE.md
index a953c36..44acfaf 100644
--- a/ORCA_REFERENCE.md
+++ b/ORCA_REFERENCE.md
@@ -1,138 +1,312 @@
-# orca
+# Orca CLI Reference
 
-Coordinated agent run harness.
+Orca is an observable agent-lane harness. Callers dispatch work to Codex,
+Claude, or Cursor and receive durable, machine-readable state. Orca provides a
+substrate for orchestrators; it does not plan, decompose, route, or judge lane
+work itself.
+
+This reference is validated against the built `orca contract` output. When
+documentation and the installed CLI disagree, trust `orca contract`.
 
 ## Install
 
-```bash
+```sh
 npm install -g orcastrator
+# pnpm add -g orcastrator
+# yarn global add orcastrator
+# bun add -g orcastrator
+```
+
+## Discover the Contract
+
+```sh
+orca contract
+orca agents
+orca dispatch --help
+```
+
+Every lane verb prints exactly one JSON envelope as its final stdout line.
+`dispatch` first prints a small handle line so a caller can capture the lane ID
+before native agent work begins. `--help` and `-h` are the documented
+human-readable exceptions.
+
+## Quick Start
+
+```sh
+# Internal worker lane (default surface)
+orca dispatch --agent codex --cwd . \
+  "Review the current diff and report actionable findings"
+
+# Named, user-followable Codex task
+orca dispatch --agent codex --surface task \
+  --label "HAPPY-123 — Fix API" \
+  --cwd /path/to/existing/worktree \
+  "Implement HAPPY-123 and run its focused tests"
 ```
 
-## Run Management
+The final envelope includes Orca's lane ID and, after native binding, the
+agent's session/thread ID.
+
+## Dispatch Surfaces
+
+### `lane` (default)
+
+An internal worker intended to report its result back to the coordinating
+agent or script. The lane remains durable so it can be inspected and resumed.
 
-Orca starts each run with a lightweight planning-necessity decision (`needsPlan?`). Multi-step work goes through full planning; simple focused work can execute directly as one task.
+### `task` (Codex only)
 
-```bash
-orca status                  # list all runs (default)
-orca status --last           # most recent run details
-orca status --run <run-id>   # specific run details
+A deliberately named, durable Codex thread intended for direct user follow-up.
+It requires a non-empty `--label`, which Orca applies as the native thread
+name.
 
-orca resume --last
-orca resume --run <run-id>
-orca resume --run <run-id> --codex-only --codex-effort high
+`--surface task` does not create a Codex Desktop-managed project, worktree, or
+handoff environment. Supply an existing checkout or worktree with `--cwd`.
+Persistent lane threads may also appear in Codex Desktop: the requested
+`user`/`subagent` source is a host-normalized hint, not a visibility filter.
 
-orca cancel --last
-orca cancel --run <run-id>
+## Commands
 
-orca answer <run-id> "yes, use migration A"
+### `orca dispatch`
+
+```text
+orca dispatch --agent <agent> [--surface lane|task] [--model <model>]
+  [--cwd <dir>] [--label <label>] [--timeout <ms>] <prompt>
 ```
 
-## PR Workflow
+Creates a lane and synchronously drives it until the turn is completed, failed,
+killed, timed out, or blocked on a question.
+
+| Option                 | Meaning                                                       |
+| ---------------------- | ------------------------------------------------------------- |
+| `--agent <agent>`      | Required adapter: `codex`, `claude`, or `cursor`              |
+| `--surface lane\|task` | Ownership surface; defaults to `lane`                         |
+| `--model <model>`      | Adapter-specific model override                               |
+| `--cwd <dir>`          | Agent working directory; defaults to the current directory    |
+| `--label <label>`      | Orca label; required native task title for `--surface task`   |
+| `--timeout <ms>`       | One deadline shared by connect, session binding, and the turn |
 
-Canonical public flow:
+Output order:
 
-```bash
-orca pr draft --run <run-id>
-orca pr create --run <run-id>
-orca pr publish --run <run-id>
-orca pr status --run <run-id>
+```json
+{"v":1,"kind":"handle","laneId":"lane_a3f81c02","agent":"codex"}
+{"v":1,"kind":"lane","ok":true,"status":"completed","lane":{"id":"lane_a3f81c02","agent":"codex","surface":"lane"},"delivery":"confirmed","nativeStatus":"completed","semanticOutcome":"unknown","result":{"text":"..."}}
 ```
 
-`orca pr publish` run selection behavior:
-- TTY: if `--run`/`--last` omitted, interactive picker is shown.
-- non-TTY: pass `--run` or `--last`.
+Harness diagnostics can appear on stderr during a successful run. Only stdout
+carries the contractual handle and envelope.
+
+### `orca inspect`
 
-## Config Discovery / Precedence
+```text
+orca inspect <laneId> [--follow] [--since <seq>]
+  [--wait-for blocked|done] [--timeout <ms>]
+```
 
-Load order (later overrides earlier):
-1. global config: `~/.orca/config.ts` then `~/.orca/config.js` (`.ts` takes precedence when both exist)
-2. project config: `./orca.config.ts` then `./orca.config.js` (`.ts` takes precedence when both exist)
-3. `--config <path>`
+Reports current lane state and stored events.
 
-## CLI Flags Reference
+```sh
+orca inspect lane_a3f81c02
+orca inspect lane_a3f81c02 --since 7
+orca inspect lane_a3f81c02 --follow
+orca inspect lane_a3f81c02 --wait-for blocked --timeout 600000
+```
 
-`orca` / `orca run`:
-- `[task]`, `--task <text>`, `-p, --prompt <text>`
-- `--spec <path>`, `--plan <path>`, `--config <path>`
-- `--codex-only`
-- `--codex-effort <low|medium|high|xhigh>`
-- `--on-milestone <cmd>`
-- `--on-task-complete <cmd>`
-- `--on-task-fail <cmd>`
-- `--on-invalid-plan <cmd>`
-- `--on-findings <cmd>`
-- `--on-complete <cmd>`
-- `--on-error <cmd>`
+`--since N` emits events whose sequence is greater than `N`. Terminal states
+also satisfy `--wait-for blocked`, so a wait does not hang when the agent
+finishes without asking a question. Read the returned `status` to distinguish
+`blocked` from a terminal result.
 
-`orca plan`:
-- `--spec <path>`
-- `--config <path>`
-- `--on-milestone <cmd>`
-- `--on-error <cmd>`
+### `orca answer`
 
-`orca status`: `--run <run-id>`, `--last`, `--config <path>`
+```text
+orca answer <laneId> <text>
+```
 
-`orca resume`: `--run <run-id>`, `--last`, `--config <path>`, `--codex-only`, `--codex-effort <low|medium|high|xhigh>`
+Submits an answer to a blocked lane. Answering a lane that is not blocked
+returns `invalid_state` (exit 4).
 
-`orca cancel`: `--run <run-id>`, `--last`, `--config <path>`
+```sh
+orca answer lane_a3f81c02 "Use the staging database"
+```
 
-`orca answer`: `[run-id] [answer]`, `--run <id>`
+Only Codex currently supports tool-mediated question parking. The capability
+is best-effort: a model can still place a question in result prose and complete
+the lane instead of blocking.
 
-`orca list`: `--config <path>`
+### `orca resume`
 
-`orca pr draft|create|publish|status`: `--run <run-id>`, `--last`, `--config <path>` (accepted for compatibility; currently unused by PR command run resolution)
+```text
+orca resume <laneId> [--timeout <ms>] <prompt>
+```
 
-`orca setup`:
-- `--openai-key <key>`
-- `--global`
-- `--project`
-- `--project-config-template`
-- `--skip-project-config`
+Starts a new turn on the same native session. Orca verifies continuity or
+returns `continuity_unverified` (exit 4).
 
-`orca skills`: `--config <path>`
+```sh
+orca resume lane_a3f81c02 "Now add tests for the edge cases"
+```
 
-`orca help`: `[command]`
+Completed lanes and parked blocked lanes can be resumed. Failed, killed, and
+lost lanes cannot. A blocked lane with a live question poller rejects resume to
+prevent two processes from driving the same native session.
 
-## Hooks + Types
+### `orca lanes`
 
-Hook names:
-- `onMilestone`
-- `onTaskComplete`
-- `onTaskFail`
-- `onInvalidPlan`
-- `onFindings`
-- `onComplete`
-- `onError`
+```sh
+orca lanes
+```
 
-Hook contract:
-- Function hooks (`hooks`) receive `(event, context)`.
-- `context` is `{ cwd, pid, invokedAt }`.
-- Command hooks (`hookCommands` and CLI `--on-*`) receive JSON via stdin.
-- No `ORCA_*` hook payload env-var framing.
-- `onError` fires for run errors and hook-dispatch/command-hook failures.
+Lists known lane records newest-first in a `kind:"list"` envelope.
 
-## OrcaConfig Reference (complete)
+### `orca kill`
 
-Top-level: `executor`, `openaiApiKey`, `runsDir`, `sessionLogs`, `skills`, `maxRetries`, `codex`, `hooks`, `hookCommands`, `pr`, `review`
+```text
+orca kill <laneId>
+```
 
-`maxRetries` is an accepted OrcaConfig field; current planner-generated task retry limits are still fixed by task graph contracts.
+Terminates a queued, running, or blocked lane. Killing an already-killed lane
+is idempotent. Killing a completed, failed, or lost lane returns
+`invalid_state`.
 
+### `orca agents`
 
-`codex.*`: `enabled`, `model`, `effort`, `thinkingLevel.decision|planning|execution`, `command`, `timeoutMs`, `multiAgent`, `perCwdExtraUserRoots`
+```sh
+orca agents
+```
 
-`pr.*`: `enabled`, `requireConfirmation`
+Returns adapter manifests with resume, kill, question, continuity, browser,
+worktree, model, measured-overhead, and caveat declarations.
+
+| Adapter | Continuity                       | Questions           | Important behavior                                                  |
+| ------- | -------------------------------- | ------------------- | ------------------------------------------------------------------- |
+| Codex   | `thread-id-match`                | Best-effort parking | App Server thread; supports named `task` surface                    |
+| Claude  | `session-id-match`               | No parking          | One-shot `claude -p`; default permissions can deny writes           |
+| Cursor  | `session-id-match`, `nonce-echo` | No parking          | Cold starts can take 30–100s; first native output emits a heartbeat |
+
+Use the live manifest rather than hard-coding model lists or assumptions:
+
+```sh
+orca agents | jq '.agents[] | {agent, capabilities, caveats}'
+```
+
+### `orca contract`
+
+```text
+orca contract [--schema envelope|event|manifest]
+```
+
+Returns the versioned `orca/v1` contract: command synopses, exit codes, notes,
+and JSON Schemas for envelopes, events, manifests, and dispatch handles.
+
+```sh
+orca contract
+orca contract --schema envelope
+orca contract --schema event
+orca contract --schema manifest
+```
+
+## Blocked Question Flow
+
+```sh
+# Terminal states also satisfy this wait; inspect the returned status.
+orca inspect lane_a3f81c02 --wait-for blocked --timeout 600000
+
+orca answer lane_a3f81c02 "Postgres"
+orca resume lane_a3f81c02 "Continue with that answer"
+```
+
+`blocked` is a successful state (`ok:true`, exit 0), not an agent failure.
+
+## Envelope Semantics
+
+The three outcome axes are independent:
+
+- `delivery`: whether the native agent acknowledged the turn.
+- `nativeStatus`: native protocol/process state.
+- `semanticOutcome`: explicit validation result. Without a validator, it stays
+  `unknown`; Orca never infers semantic correctness from prose.
+
+Common fields:
+
+```ts
+type Envelope = {
+  v: 1;
+  kind: "lane" | "list" | "agents" | "contract" | "error";
+  ok: boolean;
+  status: "queued" | "running" | "blocked" | "completed" | "failed" | "killed" | "lost";
+  code?:
+    | "usage_error"
+    | "invalid_state"
+    | "lane_not_found"
+    | "continuity_unverified"
+    | "agent_unavailable"
+    | "adapter_error"
+    | "agent_failed"
+    | "timeout";
+  lane?: {
+    id: string;
+    agent: string;
+    surface?: "lane" | "task";
+    cwd: string;
+    label?: string;
+    agentSessionId?: string;
+  };
+  delivery: "not_sent" | "confirmed" | "unknown";
+  nativeStatus: "running" | "completed" | "failed" | "interrupted" | "unknown";
+  semanticOutcome: "unknown" | "validated_pass" | "validated_fail";
+  blocked?: { questions: Array<{ id: string; question: string; options?: string[] }> };
+  result?: { text: string; artifacts?: string[] };
+  usage?: { inputTokens?: number; outputTokens?: number; costUsd?: number };
+  timing?: { wallMs: number; apiMs?: number; startupMs?: number };
+  continuity?: {
+    verified: boolean;
+    method: "thread-id-match" | "session-id-match" | "nonce-echo";
+    detail?: string;
+  };
+  next?: string[];
+  warnings?: string[];
+  error?: { message: string; remediation?: string };
+};
+```
+
+`usage` and `timing` cover the single dispatch or resume turn, not cumulative
+lane history. A command never exits 0 with `ok:false`.
+
+## Exit Codes
+
+| Exit | Meaning                               | Error codes                                                |
+| ---- | ------------------------------------- | ---------------------------------------------------------- |
+| `0`  | Success, including `status:"blocked"` | —                                                          |
+| `2`  | Malformed command line                | `usage_error`                                              |
+| `3`  | Adapter or agent failure              | `agent_unavailable`, `adapter_error`, `agent_failed`       |
+| `4`  | Invalid lane operation or continuity  | `invalid_state`, `lane_not_found`, `continuity_unverified` |
+| `5`  | Deadline exceeded                     | `timeout`                                                  |
+
+## Durable State
+
+Lane state lives under `${ORCA_HOME:-~/.orca}/lanes/<laneId>/`:
+
+```text
+lane.json       durable lane record
+events.ndjson   append-only evidence stream
+answer.txt      transient blocked-question answer handoff
+```
 
-`review.plan.*`: `enabled`, `onInvalid`
+Set `ORCA_HOME` to isolate tests or automation from personal lane history.
 
-`review.execution.*`: `enabled`, `maxCycles`, `onFindings`, `validator.auto`, `validator.commands`, `prompt`
+## Legacy Compatibility
 
-Thinking-level controls use `codex.thinkingLevel.decision|planning|execution` with canonical values `low|medium|high|xhigh`.
+Graph-era `run`, `plan`, `status`, `list`, `cancel`, setup/config, and PR
+commands can still appear in root help for compatibility. They are not the
+canonical lane architecture.
 
-Codex app-server integration: at session startup Orca calls `skills/list` with `cwds: [cwd]`, `forceReload: true`, and optional `codex.perCwdExtraUserRoots` mappings.
+The command names `answer` and `resume` exist in both surfaces. Orca selects
+the lane implementation when the first argument starts with `lane_` (all lane
+IDs do), or when lane help is requested. Other values route to the legacy
+commands.
 
-Deprecated compatibility aliases:
-- `review.enabled`
-- `review.onInvalid`
+## Source
 
-Validator caveat:
-- `ORCA_SKIP_VALIDATORS=1` forces `review.execution.validator.auto` off.
+- Package and source: <https://github.com/ratley/orca>
+- Public docs: <https://orcastrator.dev>
diff --git a/README.md b/README.md
index 380a43f..cda8d07 100644
--- a/README.md
+++ b/README.md
@@ -4,15 +4,16 @@ UI docs site for the **orca** CLI.
 
 ## What this repo is
 
-- Next.js app that renders an orca command/config reference page.
+- Next.js app that renders the canonical `orca/v1` lane-contract reference.
 - Main page implementation: `app/page.tsx`
-- Copyable markdown source used by the UI: `app/lib/pageMarkdown.ts`
+- Concise and copyable Markdown reference: `ORCA_REFERENCE.md`
+- Markdown route loader: `app/lib/pageMarkdown.ts`
 
 ## Run locally
 
 ```bash
 bun install
-bun dev
+bun run dev
 ```
 
 Then open `http://localhost:3000`.
@@ -21,11 +22,13 @@ Then open `http://localhost:3000`.
 
 From `package.json`:
 
-- `bun dev` — start local dev server
+- `bun run dev` — start local dev server
 - `bun run build` — production build
 - `bun start` — run production server
-- `bun run lint` — run Biome checks
-- `bun run format` — format with Biome
+- `bun run lint` — run Oxlint checks
+- `bun run format` — format with Oxfmt
+- `bun run format:check` — check formatting with Oxfmt
+- `bun test` — verify the Markdown reference stays on the lane contract
 
 ## Project links
 
diff --git a/app/components/AgentSkillCard.tsx b/app/components/AgentSkillCard.tsx
index 34a17d4..31c00c2 100644
--- a/app/components/AgentSkillCard.tsx
+++ b/app/components/AgentSkillCard.tsx
@@ -4,47 +4,40 @@ import { CopyButton } from "./CopyButton";
 
 export const SKILL_MD = `---
 name: orca
-description: "Orchestrate multi-step AI coding tasks via the Orca CLI. Use when: running multi-file code changes, spawning background agents, planning and executing complex tasks end-to-end. NOT for: simple single-file edits, reading code."
+description: "Dispatch and manage Codex, Claude, or Cursor lanes through Orca's machine-readable contract."
 ---
 
 # Orca
 
-Orca (orcastrator) is a CLI that breaks a task into a graph of tasks and executes it end-to-end via Codex.
+Orca is an observable agent-lane harness. It does not plan or route work for you.
 
-## Install
-npm install -g orcastrator
+## First use
+orca contract
+orca agents
 
-## Run a Task
-orca "your task here"
+Trust the live contract and manifests over remembered CLI behavior.
 
-## Key Commands
-orca <task>              Start a new run
-orca status [--last]     Check run status
-orca answer <text>       Answer a question the agent raised
-orca resume [--last]     Resume a paused run
-orca cancel [--last]     Cancel a run
-orca pr create [--last]  Open a PR for the run's branch
+## Dispatch
+# Internal worker lane
+orca dispatch --agent codex --cwd /path/to/repo --timeout 600000 "<brief>"
 
-## Config (~/.orca/config.js or ./orca.config.js)
-export default {
-  executor: "codex",           // "codex" (default)
-  sessionLogs: "./session-logs",
-  hooks: {
-    onComplete: async (event, context) => {
-      console.log(event.message, context.cwd);
-    },
-  },
-  hookCommands: {
-    onComplete: "node ./scripts/on-complete.mjs",
-  },
-  codex: { multiAgent: false },
-}
+# Named, user-followable Codex task
+orca dispatch --agent codex --surface task --label "HAPPY-123 — Fix API" --cwd /path/to/worktree "<brief>"
+
+## Manage
+orca inspect <laneId> [--follow] [--since <seq>] [--wait-for blocked|done]
+orca answer <laneId> "<answer>"
+orca resume <laneId> --timeout 600000 "<follow-up>"
+orca lanes
+orca kill <laneId>
 
-## Notes
-- Codex executor requires ~/.codex/auth.json
-- Must be run inside a git repo
-- Run ID format: <slug>-<unix-ms>-<hex4>
-- Use orca answer to unblock a waiting run`;
+## Contract rules
+- Every lane verb ends with exactly one JSON envelope on stdout.
+- dispatch prints a handle line first.
+- status blocked is successful (exit 0); inspect the envelope status.
+- Read status and result.text; continuity alone does not prove task success.
+- --surface task names a durable Codex thread but does not provision a Desktop worktree.
+- Persistent lane threads can also appear in Codex Desktop; surface is not a visibility filter.`;
 
 export function AgentSkillCard({ compact = false }: { compact?: boolean }) {
   return (
@@ -57,7 +50,6 @@ export function AgentSkillCard({ compact = false }: { compact?: boolean }) {
         overflow: "hidden",
       }}
     >
-      {/* Header row */}
       <div
         style={{
           display: "flex",
@@ -92,7 +84,6 @@ export function AgentSkillCard({ compact = false }: { compact?: boolean }) {
         </span>
       </div>
 
-      {/* Content */}
       <div style={{ position: "relative" }}>
         <CopyButton text={SKILL_MD} />
         <pre
diff --git a/app/components/CodeBlock.tsx b/app/components/CodeBlock.tsx
index b3aee03..899b9a7 100644
--- a/app/components/CodeBlock.tsx
+++ b/app/components/CodeBlock.tsx
@@ -39,9 +39,7 @@ function highlightInline(line: string, lang?: string): React.ReactNode[] {
     return [tokenSpan(line, `shell-${line.length}`, "#e2e8f0")];
   }
 
-  const tokens = line
-    .split(/(\s+|"[^"]*"|'[^']*'|`[^`]*`|\/\/.*$|[{}()[\];,.:=<>])/g)
-    .filter(Boolean);
+  const tokens = line.split(/(\s+|"[^"]*"|'[^']*'|`[^`]*`|\/\/.*$|[{}()[\];,.:=<>])/g).filter(Boolean);
 
   const nodes: React.ReactNode[] = [];
   let cursor = 0;
diff --git a/app/components/PageCopyButton.tsx b/app/components/PageCopyButton.tsx
index 661ffb1..ae20b34 100644
--- a/app/components/PageCopyButton.tsx
+++ b/app/components/PageCopyButton.tsx
@@ -1,14 +1,20 @@
 "use client";
 
 import { useState } from "react";
-import { PAGE_MARKDOWN } from "../lib/pageMarkdown";
 
 export function PageCopyButton() {
   const [copied, setCopied] = useState(false);
 
   const handleCopy = async () => {
     try {
-      await navigator.clipboard.writeText(PAGE_MARKDOWN);
+      const response = await fetch("/md");
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch Markdown reference: ${response.status}`,
+        );
+      }
+
+      await navigator.clipboard.writeText(await response.text());
       setCopied(true);
       setTimeout(() => setCopied(false), 1500);
     } catch {
diff --git a/app/globals.css b/app/globals.css
index b7328a7..3b735f6 100644
--- a/app/globals.css
+++ b/app/globals.css
@@ -39,7 +39,11 @@ html {
 body {
   background-color: var(--bg);
   color: var(--text);
-  font-family: ui-sans-serif, system-ui, -apple-system, sans-serif;
+  font-family:
+    ui-sans-serif,
+    system-ui,
+    -apple-system,
+    sans-serif;
   font-size: 15px;
   line-height: 1.6;
   margin: 0;
@@ -48,9 +52,7 @@ body {
 code,
 kbd,
 pre {
-  font-family:
-    ui-monospace, "Cascadia Code", "Fira Code", Menlo, Monaco, "Courier New",
-    monospace;
+  font-family: ui-monospace, "Cascadia Code", "Fira Code", Menlo, Monaco, "Courier New", monospace;
 }
 
 ::-webkit-scrollbar {
@@ -70,3 +72,78 @@ pre {
   background: var(--accent-dim);
   color: white;
 }
+
+.docs-header {
+  position: sticky;
+  top: 0;
+  z-index: 50;
+  display: flex;
+  align-items: center;
+  height: 56px;
+  padding: 0 24px;
+  gap: 24px;
+  background: #0f0f0f;
+  border-bottom: 1px solid #1f1f1f;
+}
+
+.docs-header-links {
+  display: flex;
+  gap: 20px;
+  margin-left: 8px;
+  font-size: 13px;
+}
+
+.docs-header-links a {
+  color: #71717a;
+  text-decoration: none;
+}
+
+.docs-shell {
+  display: flex;
+  max-width: 1040px;
+  min-height: calc(100vh - 56px);
+  margin: 0 auto;
+}
+
+.docs-sidebar {
+  position: sticky;
+  top: 56px;
+  flex-shrink: 0;
+  width: 220px;
+  height: calc(100vh - 56px);
+  padding: 24px 0;
+  overflow-y: auto;
+  border-right: 1px solid #1f1f1f;
+}
+
+.docs-main {
+  flex: 1;
+  min-width: 0;
+  max-width: 780px;
+  padding: 0 40px;
+}
+
+.docs-hero {
+  padding: 44px 0 36px;
+  border-bottom: 1px solid #1f1f1f;
+}
+
+@media (max-width: 760px) {
+  .docs-header {
+    padding: 0 16px;
+  }
+
+  .docs-header-links,
+  .docs-sidebar {
+    display: none;
+  }
+
+  .docs-main {
+    max-width: none;
+    padding: 0 18px;
+  }
+
+  .docs-hero {
+    padding-top: 32px;
+  }
+}
diff --git a/app/layout.tsx b/app/layout.tsx
index 8d3db0e..0e2a483 100644
--- a/app/layout.tsx
+++ b/app/layout.tsx
@@ -3,7 +3,7 @@ import "./globals.css";
 
 export const metadata: Metadata = {
   title: "Orca CLI Reference",
-  description: "Orca CLI reference and docs.",
+  description: "Orca's machine-readable agent-lane CLI contract and operator reference.",
 };
 
 export default function RootLayout({
diff --git a/app/lib/pageMarkdown.test.ts b/app/lib/pageMarkdown.test.ts
index bd2dd50..de7c4c8 100644
--- a/app/lib/pageMarkdown.test.ts
+++ b/app/lib/pageMarkdown.test.ts
@@ -1,35 +1,28 @@
 import { expect, test } from "bun:test";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
+
 import { PAGE_MARKDOWN } from "./pageMarkdown";
 
 const ROOT = join(import.meta.dir, "..", "..");
 const ORCA_REFERENCE_PATH = join(ROOT, "ORCA_REFERENCE.md");
 
-test("uses canonical codex effort values and thinkingLevel naming", () => {
-  expect(PAGE_MARKDOWN).toContain("--codex-effort <low|medium|high|xhigh>");
-  expect(PAGE_MARKDOWN).toContain(
-    "codex.thinkingLevel.decision|planning|execution",
-  );
-  expect(PAGE_MARKDOWN).not.toContain("extra-high");
-  expect(PAGE_MARKDOWN).not.toContain("codex.thinking:");
+test("documents the canonical lane contract and task surface", () => {
+  expect(PAGE_MARKDOWN).toContain("versioned `orca/v1` contract");
+  expect(PAGE_MARKDOWN).toContain("orca dispatch --agent <agent> [--surface lane|task]");
+  expect(PAGE_MARKDOWN).toContain("--surface task");
+  expect(PAGE_MARKDOWN).toContain("does not create a Codex Desktop-managed project");
+  expect(PAGE_MARKDOWN).toContain("`continuity_unverified` (exit 4)");
+  expect(PAGE_MARKDOWN).toContain('Success, including `status:"blocked"`');
 });
 
-test("documents planning-necessity gate and skills/list cwd behavior", () => {
-  expect(PAGE_MARKDOWN).toContain("planning-necessity decision (`needsPlan?`)");
-  expect(PAGE_MARKDOWN).toContain("skills/list");
-  expect(PAGE_MARKDOWN).toContain("cwds: [cwd]");
-  expect(PAGE_MARKDOWN).toContain("forceReload: true");
+test("does not present the legacy graph runner as canonical", () => {
+  expect(PAGE_MARKDOWN).not.toContain("Breaks down a task into a graph");
+  expect(PAGE_MARKDOWN).not.toContain("Usage: orca run");
+  expect(PAGE_MARKDOWN).not.toContain("planner.router");
+  expect(PAGE_MARKDOWN).not.toContain("executor?:");
 });
 
-test("ORCA_REFERENCE.md stays aligned with PAGE_MARKDOWN semantics", () => {
-  const reference = readFileSync(ORCA_REFERENCE_PATH, "utf8");
-  expect(reference).toContain("--codex-effort <low|medium|high|xhigh>");
-  expect(reference).toContain(
-    "codex.thinkingLevel.decision|planning|execution",
-  );
-  expect(reference).toContain("planning-necessity decision (`needsPlan?`)");
-  expect(reference).toContain("skills/list");
-  expect(reference).toContain("cwds: [cwd]");
-  expect(reference).not.toContain("extra-high");
+test("matches the checked-in Markdown reference", () => {
+  expect(PAGE_MARKDOWN).toBe(readFileSync(ORCA_REFERENCE_PATH, "utf8"));
 });
diff --git a/app/lib/pageMarkdown.ts b/app/lib/pageMarkdown.ts
index 91e8b73..125e4cd 100644
--- a/app/lib/pageMarkdown.ts
+++ b/app/lib/pageMarkdown.ts
@@ -1,137 +1,7 @@
-export const PAGE_MARKDOWN = `# orca
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
 
-Coordinated agent run harness.
-
-## Install
-
-\`\`\`shell
-npm install -g orcastrator
-\`\`\`
-
-## Run Management
-
-Orca starts each run with a lightweight planning-necessity decision (\`needsPlan?\`). Multi-step work goes through full planning; simple focused work can execute directly as one task.
-
-\`\`\`shell
-orca status                  # list all runs (default)
-orca status --last           # most recent run details
-orca status --run <run-id>   # specific run details
-
-orca resume --last
-orca resume --run <run-id>
-orca resume --run <run-id> --codex-only --codex-effort high
-
-orca cancel --last
-orca cancel --run <run-id>
-
-orca answer <run-id> "yes, use migration A"
-\`\`\`
-
-## PR Workflow
-
-Canonical public flow:
-
-\`\`\`shell
-orca pr draft --run <run-id>
-orca pr create --run <run-id>
-orca pr publish --run <run-id>
-orca pr status --run <run-id>
-\`\`\`
-
-\`orca pr publish\` run selection behavior:
-- TTY: if \`--run\`/\`--last\` omitted, interactive picker is shown.
-- non-TTY: pass \`--run\` or \`--last\`.
-
-## Config Discovery / Precedence
-
-Load order (later overrides earlier):
-1. global config: \`~/.orca/config.ts\` then \`~/.orca/config.js\` (\`.ts\` takes precedence when both exist)
-2. project config: \`./orca.config.ts\` then \`./orca.config.js\` (\`.ts\` takes precedence when both exist)
-3. \`--config <path>\`
-
-## CLI Flags Reference
-
-\`orca\` / \`orca run\`:
-- \`[task]\`, \`--task <text>\`, \`-p, --prompt <text>\`
-- \`--spec <path>\`, \`--plan <path>\`, \`--config <path>\`
-- \`--codex-effort <low|medium|high|xhigh>\`
-- \`--on-milestone <cmd>\`
-- \`--on-task-complete <cmd>\`
-- \`--on-task-fail <cmd>\`
-- \`--on-invalid-plan <cmd>\`
-- \`--on-findings <cmd>\`
-- \`--on-complete <cmd>\`
-- \`--on-error <cmd>\`
-
-\`orca plan\`:
-- \`--spec <path>\`
-- \`--config <path>\`
-- \`--on-milestone <cmd>\`
-- \`--on-error <cmd>\`
-
-\`orca status\`: \`--run <run-id>\`, \`--last\`, \`--config <path>\`
-
-
-\`orca cancel\`: \`--run <run-id>\`, \`--last\`, \`--config <path>\`
-
-\`orca answer\`: \`[run-id] [answer]\`, \`--run <id>\`
-
-\`orca list\`: \`--config <path>\`
-
-\`orca pr draft|create|publish|status\`: \`--run <run-id>\`, \`--last\`, \`--config <path>\` (accepted for compatibility; currently unused by PR command run resolution)
-
-\`orca setup\`:
-- \`--openai-key <key>\`
-- \`--ts\` (write \`.ts\` config output)
-- \`--global\`
-- \`--project\`
-- \`--project-config-template\`
-- \`--skip-project-config\`
-
-\`orca skills\`: \`--config <path>\`
-
-\`orca help\`: \`[command]\`
-
-## Hooks + Types
-
-Hook names:
-- \`onMilestone\`
-- \`onTaskComplete\`
-- \`onTaskFail\`
-- \`onInvalidPlan\`
-- \`onFindings\`
-- \`onComplete\`
-- \`onError\`
-
-Hook contract:
-- Function hooks (\`hooks\`) receive \`(event, context)\`.
-- \`context\` is \`{ cwd, pid, invokedAt }\`.
-- Command hooks (\`hookCommands\` and CLI \`--on-*\`) receive JSON via stdin.
-- No \`ORCA_*\` hook payload env-var framing.
-- \`onError\` fires for run errors and hook-dispatch/command-hook failures.
-
-## OrcaConfig Reference (complete)
-
-
-\`maxRetries\` is an accepted OrcaConfig field; current planner-generated task retry limits are still fixed by task graph contracts.
-
-
-\`codex.*\`: \`enabled\`, \`model\`, \`effort\`, \`thinkingLevel.decision|planning|execution\`, \`command\`, \`timeoutMs\`, \`multiAgent\`, \`perCwdExtraUserRoots\`
-
-\`pr.*\`: \`enabled\`, \`requireConfirmation\`
-
-\`review.plan.*\`: \`enabled\`, \`onInvalid\`
-
-\`review.execution.*\`: \`enabled\`, \`maxCycles\`, \`onFindings\`, \`validator.auto\`, \`validator.commands\`, \`prompt\`
-
-Thinking-level controls use \`codex.thinkingLevel.decision|planning|execution\` with canonical values \`low|medium|high|xhigh\`.
-
-Codex app-server integration: at session startup Orca calls \`skills/list\` with \`cwds: [cwd]\`, \`forceReload: true\`, and optional \`codex.perCwdExtraUserRoots\` mappings.
-
-Deprecated compatibility aliases:
-- \`review.enabled\`
-- \`review.onInvalid\`
-
-Validator caveat:
-- \`ORCA_SKIP_VALIDATORS=1\` forces \`review.execution.validator.auto\` off.
-`;
+export const PAGE_MARKDOWN = readFileSync(
+  join(process.cwd(), "ORCA_REFERENCE.md"),
+  "utf8",
+);
diff --git a/app/page.tsx b/app/page.tsx
index 4c67b8f..5e58c7e 100644
--- a/app/page.tsx
+++ b/app/page.tsx
@@ -3,33 +3,50 @@ import { CodeBlock } from "./components/CodeBlock";
 import { InstallCommandSwitcher } from "./components/InstallCommandSwitcher";
 import { PageCopyButton } from "./components/PageCopyButton";
 
-// ─── Nav items ───────────────────────────────────────────────────────────────
-
-const NAV_COMMANDS: Array<{ id: string; label: string; accent?: boolean }> = [
-  { id: "get-started", label: "Get Started", accent: true },
-  { id: "cmd-run", label: "orca <task>" },
-  { id: "cmd-plan", label: "orca plan" },
-  { id: "cmd-status", label: "orca status" },
-  { id: "cmd-list", label: "orca list" },
-  { id: "cmd-resume", label: "orca resume" },
-  { id: "cmd-cancel", label: "orca cancel" },
-  { id: "cmd-answer", label: "orca answer" },
-  { id: "cmd-pr", label: "orca pr" },
-  { id: "cmd-setup", label: "orca setup" },
-  { id: "cmd-skills", label: "orca skills" },
-  { id: "cmd-help", label: "orca help" },
-];
+interface NavItem {
+  id: string;
+  label: string;
+  accent?: boolean;
+}
 
-const NAV_CONFIG = [
-  { id: "config-discovery", label: "Discovery" },
-  { id: "config-project-instructions", label: "Project Instructions" },
-  { id: "config-options", label: "Options" },
-  { id: "config-hooks", label: "Hooks" },
-  { id: "config-multiagent", label: "Multi-agent" },
+const NAV_GROUPS: Array<{ label: string; items: NavItem[] }> = [
+  {
+    label: "Start",
+    items: [
+      { id: "get-started", label: "Get Started", accent: true },
+      { id: "mental-model", label: "Mental Model" },
+      { id: "surfaces", label: "Dispatch Surfaces" },
+    ],
+  },
+  {
+    label: "Commands",
+    items: [
+      { id: "cmd-dispatch", label: "orca dispatch" },
+      { id: "cmd-inspect", label: "orca inspect" },
+      { id: "cmd-answer", label: "orca answer" },
+      { id: "cmd-resume", label: "orca resume" },
+      { id: "cmd-lanes", label: "orca lanes" },
+      { id: "cmd-kill", label: "orca kill" },
+      { id: "cmd-agents", label: "orca agents" },
+      { id: "cmd-contract", label: "orca contract" },
+    ],
+  },
+  {
+    label: "Contract",
+    items: [
+      { id: "question-flow", label: "Blocked Questions" },
+      { id: "envelopes", label: "Envelopes" },
+      { id: "exit-codes", label: "Exit Codes" },
+      { id: "storage", label: "Durable State" },
+      { id: "legacy", label: "Legacy Compatibility" },
+    ],
+  },
+  {
+    label: "Resources",
+    items: [{ id: "agent-skill", label: "Agent Skill" }],
+  },
 ];
 
-// ─── Shared style tokens ─────────────────────────────────────────────────────
-
 const S = {
   section: {
     padding: "40px 0",
@@ -39,15 +56,15 @@ const S = {
     fontSize: "22px",
     fontWeight: 600,
     color: "#f1f5f9",
-    margin: "0 0 6px",
+    margin: "0 0 8px",
     fontFamily: "ui-monospace, monospace",
     letterSpacing: "-0.02em",
   } as React.CSSProperties,
   h3: {
-    fontSize: "17px",
+    fontSize: "16px",
     fontWeight: 600,
     color: "#e2e8f0",
-    margin: "28px 0 6px",
+    margin: "28px 0 8px",
     fontFamily: "ui-monospace, monospace",
   } as React.CSSProperties,
   p: {
@@ -55,28 +72,29 @@ const S = {
     lineHeight: "1.7",
     margin: "0 0 12px",
   } as React.CSSProperties,
-  flagTable: {
+  table: {
     width: "100%",
     borderCollapse: "collapse" as const,
     fontSize: "13px",
-    margin: "12px 0",
+    margin: "14px 0",
   },
-  flagRow: {
+  row: {
     borderBottom: "1px solid #1f1f1f",
   } as React.CSSProperties,
-  flagCell: {
-    padding: "7px 12px 7px 0",
-    verticalAlign: "top",
-    color: "#a1a1aa",
-  } as React.CSSProperties,
-  flagName: {
-    padding: "7px 16px 7px 0",
+  keyCell: {
+    padding: "8px 16px 8px 0",
     verticalAlign: "top",
     color: "#22d3ee",
     fontFamily: "ui-monospace, monospace",
     whiteSpace: "nowrap" as const,
     fontSize: "12px",
   } as React.CSSProperties,
+  valueCell: {
+    padding: "8px 0",
+    verticalAlign: "top",
+    color: "#a1a1aa",
+    lineHeight: "1.55",
+  } as React.CSSProperties,
   badge: {
     display: "inline-block",
     padding: "1px 7px",
@@ -87,218 +105,121 @@ const S = {
     marginRight: "6px",
     letterSpacing: "0.04em",
   } as React.CSSProperties,
-  divider: {
-    height: "1px",
-    background: "#1f1f1f",
-    margin: "28px 0",
-    border: "none",
-  } as React.CSSProperties,
   note: {
-    background: "#1a1a2e",
+    background: "#111d2b",
     border: "1px solid #1e3a5f",
     borderRadius: "6px",
     padding: "12px 16px",
     color: "#7dd3fc",
     fontSize: "13px",
-    lineHeight: "1.6",
-    margin: "12px 0",
+    lineHeight: "1.65",
+    margin: "14px 0",
+  } as React.CSSProperties,
+  list: {
+    color: "#a1a1aa",
+    lineHeight: "1.8",
+    paddingLeft: "20px",
+    margin: "8px 0 16px",
   } as React.CSSProperties,
 };
 
-// ─── Flag row helper ─────────────────────────────────────────────────────────
-
-function Flag({ flag, desc }: { flag: string; desc: string }) {
+function DocRow({ name, children }: { name: string; children: React.ReactNode }) {
   return (
-    <tr style={S.flagRow}>
-      <td style={S.flagName}>{flag}</td>
-      <td style={S.flagCell}>{desc}</td>
+    <tr style={S.row}>
+      <td style={S.keyCell}>{name}</td>
+      <td style={S.valueCell}>{children}</td>
     </tr>
   );
 }
 
-// ─── Section header ───────────────────────────────────────────────────────────
-
 function CmdSection({
   id,
   title,
   usage,
-  desc,
+  description,
   children,
 }: {
   id: string;
   title: string;
-  usage?: string;
-  desc?: string;
+  usage: string;
+  description: string;
   children?: React.ReactNode;
 }) {
   return (
     <section id={id} style={S.section}>
       <h2 style={S.h2}>{title}</h2>
-      {usage && (
-        <div style={{ marginBottom: "10px" }}>
-          <span style={S.badge}>usage</span>
-          <code
-            style={{
-              fontFamily: "ui-monospace, monospace",
-              fontSize: "13px",
-              color: "#e2e8f0",
-            }}
-          >
-            {usage}
-          </code>
-        </div>
-      )}
-      {desc && <p style={S.p}>{desc}</p>}
+      <div style={{ marginBottom: "12px" }}>
+        <span style={S.badge}>usage</span>
+        <code style={{ color: "#e2e8f0", fontSize: "13px" }}>{usage}</code>
+      </div>
+      <p style={S.p}>{description}</p>
       {children}
     </section>
   );
 }
 
-// ─── Sidebar ──────────────────────────────────────────────────────────────────
-
-function Sidebar() {
+function SectionLabel({ children }: { children: React.ReactNode }) {
   return (
-    <nav
+    <div
       style={{
-        width: "200px",
-        flexShrink: 0,
-        position: "sticky",
-        top: "64px",
-        height: "calc(100vh - 64px)",
-        overflowY: "auto",
-        padding: "24px 0 24px 0",
-        borderRight: "1px solid #1f1f1f",
+        paddingTop: "36px",
+        paddingBottom: "2px",
+        color: "#52525b",
+        fontSize: "11px",
+        fontFamily: "ui-monospace, monospace",
+        letterSpacing: "0.1em",
+        textTransform: "uppercase",
       }}
     >
-      <div style={{ marginBottom: "20px" }}>
-        <div
-          style={{
-            fontSize: "10px",
-            fontFamily: "ui-monospace, monospace",
-            letterSpacing: "0.1em",
-            textTransform: "uppercase",
-            color: "#52525b",
-            marginBottom: "8px",
-            paddingLeft: "16px",
-          }}
-        >
-          Commands
-        </div>
-        {NAV_COMMANDS.map((item) => (
-          <a
-            key={item.id}
-            href={`#${item.id}`}
-            style={{
-              display: "block",
-              padding: "4px 16px",
-              fontSize: "13px",
-              color: item.accent ? "#22d3ee" : "#71717a",
-              textDecoration: "none",
-              fontFamily: "ui-monospace, monospace",
-              opacity: item.accent ? 0.85 : 1,
-            }}
-          >
-            {item.label}
-          </a>
-        ))}
-      </div>
-      <div>
-        <div
-          style={{
-            fontSize: "10px",
-            fontFamily: "ui-monospace, monospace",
-            letterSpacing: "0.1em",
-            textTransform: "uppercase",
-            color: "#52525b",
-            marginBottom: "8px",
-            paddingLeft: "16px",
-          }}
-        >
-          Config
-        </div>
-        {NAV_CONFIG.map((item) => (
-          <a
-            key={item.id}
-            href={`#${item.id}`}
+      {children}
+    </div>
+  );
+}
+
+function Sidebar() {
+  return (
+    <nav className="docs-sidebar">
+      {NAV_GROUPS.map((group) => (
+        <div key={group.label} style={{ marginBottom: "20px" }}>
+          <div
             style={{
-              display: "block",
-              padding: "4px 16px",
-              fontSize: "13px",
-              color: "#71717a",
-              textDecoration: "none",
+              fontSize: "10px",
               fontFamily: "ui-monospace, monospace",
+              letterSpacing: "0.1em",
+              textTransform: "uppercase",
+              color: "#52525b",
+              marginBottom: "8px",
+              paddingLeft: "16px",
             }}
           >
-            {item.label}
-          </a>
-        ))}
-      </div>
-
-      <div style={{ marginTop: "20px" }}>
-        <div
-          style={{
-            fontSize: "10px",
-            fontFamily: "ui-monospace, monospace",
-            letterSpacing: "0.1em",
-            textTransform: "uppercase",
-            color: "#52525b",
-            marginBottom: "8px",
-            paddingLeft: "16px",
-          }}
-        >
-          Resources
+            {group.label}
+          </div>
+          {group.items.map((item) => (
+            <a
+              key={item.id}
+              href={`#${item.id}`}
+              style={{
+                display: "block",
+                padding: "4px 16px",
+                fontSize: "13px",
+                color: item.accent ? "#22d3ee" : "#71717a",
+                textDecoration: "none",
+                fontFamily: "ui-monospace, monospace",
+              }}
+            >
+              {item.label}
+            </a>
+          ))}
         </div>
-        <a
-          href="#agent-skill"
-          style={{
-            display: "block",
-            padding: "4px 16px",
-            fontSize: "13px",
-            color: "#71717a",
-            textDecoration: "none",
-            fontFamily: "ui-monospace, monospace",
-          }}
-        >
-          Agent Skill
-        </a>
-        <a
-          href="#types"
-          style={{
-            display: "block",
-            padding: "4px 16px",
-            fontSize: "13px",
-            color: "#71717a",
-            textDecoration: "none",
-            fontFamily: "ui-monospace, monospace",
-          }}
-        >
-          Types
-        </a>
-      </div>
+      ))}
     </nav>
   );
 }
 
-// ─── Page ─────────────────────────────────────────────────────────────────────
-
 export default function Home() {
   return (
     <>
-      {/* ── Header ── */}
-      <header
-        style={{
-          position: "sticky",
-          top: 0,
-          zIndex: 50,
-          background: "#0f0f0f",
-          borderBottom: "1px solid #1f1f1f",
-          height: "56px",
-          display: "flex",
-          alignItems: "center",
-          padding: "0 24px",
-          gap: "24px",
-        }}
-      >
+      <header className="docs-header">
         <a
           href="#hero"
           style={{
@@ -312,1170 +233,396 @@ export default function Home() {
         >
           🐋 orca
         </a>
-        <div
-          style={{
-            display: "flex",
-            gap: "20px",
-            fontSize: "13px",
-            marginLeft: "8px",
-          }}
-        >
-          <a
-            href="#cmd-run"
-            style={{ color: "#71717a", textDecoration: "none" }}
-          >
-            commands
-          </a>
-          <a
-            href="#config-discovery"
-            style={{ color: "#71717a", textDecoration: "none" }}
-          >
-            config
-          </a>
-        </div>
-        <div style={{ marginLeft: "auto", fontSize: "13px" }}>
-          <a
-            href="https://github.com/ratley/orca"
-            target="_blank"
-            rel="noopener noreferrer"
-            style={{ color: "#52525b", textDecoration: "none" }}
-          >
-            github ↗
-          </a>
+        <div className="docs-header-links">
+          <a href="#cmd-dispatch">commands</a>
+          <a href="#envelopes">contract</a>
         </div>
+        <a
+          href="https://github.com/ratley/orca"
+          target="_blank"
+          rel="noopener noreferrer"
+          style={{ marginLeft: "auto", color: "#52525b", textDecoration: "none", fontSize: "13px" }}
+        >
+          github ↗
+        </a>
       </header>
 
-      {/* ── Body: sidebar + main ── */}
-      <div
-        style={{
-          display: "flex",
-          maxWidth: "1000px",
-          margin: "0 auto",
-          minHeight: "calc(100vh - 56px)",
-        }}
-      >
-        {/* Sidebar — hidden on small screens via inline media query workaround */}
-        <div className="sidebar-wrapper" style={{ display: "flex" }}>
-          <Sidebar />
-        </div>
+      <div className="docs-shell">
+        <Sidebar />
 
-        {/* Main content */}
-        <main
-          style={{
-            flex: 1,
-            padding: "0 40px",
-            minWidth: 0,
-            maxWidth: "740px",
-          }}
-        >
-          {/* ── Copy page button ── */}
+        <main className="docs-main">
           <PageCopyButton />
 
-          {/* ── Hero ── */}
-          <section
-            id="hero"
-            style={{
-              padding: "48px 0 32px",
-              borderBottom: "1px solid #1f1f1f",
-            }}
-          >
-            <h1
-              style={{
-                fontSize: "28px",
-                fontWeight: 700,
-                color: "#f1f5f9",
-                margin: "0 0 12px",
-                fontFamily: "ui-monospace, monospace",
-                letterSpacing: "-0.03em",
-              }}
-            >
-              orca
-            </h1>
+          <section id="hero" className="docs-hero">
+            <div style={{ display: "flex", alignItems: "center", gap: "9px", marginBottom: "12px" }}>
+              <h1
+                style={{
+                  fontSize: "30px",
+                  fontWeight: 700,
+                  color: "#f1f5f9",
+                  margin: 0,
+                  fontFamily: "ui-monospace, monospace",
+                  letterSpacing: "-0.04em",
+                }}
+              >
+                orca
+              </h1>
+              <span style={S.badge}>orca/v1</span>
+            </div>
             <p
               style={{
                 fontSize: "16px",
                 color: "#a1a1aa",
                 margin: "0 0 24px",
-                lineHeight: "1.6",
-                maxWidth: "520px",
+                lineHeight: "1.65",
+                maxWidth: "590px",
               }}
             >
-              Coordinated agent run harness. Breaks down a task into a graph of
-              tasks, then executes it end-to-end via a persistent{" "}
-              <a
-                href="https://developers.openai.com/codex/app-server/"
-                style={{ color: "#22d3ee", textDecoration: "none" }}
-              >
-                Codex
-              </a>{" "}
-              session with full context across tasks.
+              Observable agent lanes with one machine-readable contract. Dispatch Codex, Claude, or Cursor work; inspect
+              durable evidence; answer blocked questions; and resume the same native session with verified continuity.
             </p>
 
-            <div id="get-started" style={{ marginBottom: "8px" }}>
+            <div id="get-started">
               <InstallCommandSwitcher />
             </div>
-          </section>
-
-          {/* ══════════════════════════════════════════════
-              COMMANDS
-          ══════════════════════════════════════════════ */}
-
-          <div
-            style={{
-              paddingTop: "32px",
-              paddingBottom: "8px",
-              color: "#52525b",
-              fontSize: "11px",
-              fontFamily: "ui-monospace, monospace",
-              letterSpacing: "0.1em",
-              textTransform: "uppercase",
-            }}
-          >
-            Commands
-          </div>
-
-          {/* orca <task> */}
-          <CmdSection
-            id="cmd-run"
-            title="orca <task>"
-            usage="orca [task] [flags]"
-            desc="Start a new run from a plain-language task. Orca first runs a low-effort planning-necessity decision, then either generates a full plan for multi-step work or executes directly when one focused task is enough."
-          >
             <CodeBlock
-              code={`# Run a task
-orca "add auth to the app"
+              code={`# Discover the installed contract first
+orca contract
+orca agents
 
-# Run with a spec or plan file
-orca --spec ./specs/feature.md
-orca --plan ./specs/feature.md`}
+# Dispatch an internal Codex worker
+orca dispatch --agent codex --cwd . "Review the current diff"`}
               lang="shell"
             />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag flag="[task]" desc="Plain-language task (positional)" />
-                <Flag
-                  flag="--task, -p, --prompt <text>"
-                  desc="Task as a named flag (alias for positional)"
-                />
-                <Flag
-                  flag="--spec <path>"
-                  desc="Path to a spec/markdown breakdown file"
-                />
-                <Flag
-                  flag="--plan <path>"
-                  desc="Path to a plan file (same as --spec)"
-                />
-                <Flag
-                  flag="--config <path>"
-                  desc="Path to an orca config file"
-                />
-                <Flag
-                  flag="--on-milestone <cmd>"
-                  desc="Shell command to run on each milestone"
-                />
-                <Flag
-                  flag="--on-error <cmd>"
-                  desc="Shell command to run on error"
-                />
-                <Flag
-                  flag="--codex-only"
-                  desc="Force Codex executor for this run"
-                />
-                <Flag
-                  flag="--codex-effort <low|medium|high|xhigh>"
-                  desc="Override Codex effort for this run"
-                />
-                <Flag
-                  flag="--on-task-complete <cmd>"
-                  desc="Shell command to run when a task completes"
-                />
-                <Flag
-                  flag="--on-task-fail <cmd>"
-                  desc="Shell command to run when a task fails"
-                />
-                <Flag
-                  flag="--on-invalid-plan <cmd>"
-                  desc="Shell command to run when planner/review output is invalid"
-                />
-                <Flag
-                  flag="--on-findings <cmd>"
-                  desc="Shell command to run when post-execution review reports findings"
-                />
-                <Flag
-                  flag="--on-complete <cmd>"
-                  desc="Shell command to run when the full run completes"
-                />
-                <Flag flag="-h, --help" desc="Show help" />
-                <Flag flag="-V, --version" desc="Show version" />
-              </tbody>
-            </table>
-          </CmdSection>
+          </section>
 
-          {/* orca plan */}
-          <CmdSection
-            id="cmd-plan"
-            title="orca plan"
-            usage="orca plan [flags]"
-            desc="Plan tasks without executing them. Useful for reviewing the task breakdown before committing to a run."
-          >
-            <CodeBlock
-              code={`orca plan --spec ./specs/feature.md`}
-              lang="shell"
-            />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
+          <section id="mental-model" style={S.section}>
+            <h2 style={S.h2}>Mental Model</h2>
+            <p style={S.p}>
+              Orca is a substrate for orchestrators, not an orchestrator itself. The caller decides what work to
+              delegate and how to judge it. Orca owns native session binding, durable state, process control, continuity
+              checks, and a stable JSON boundary across agents.
+            </p>
+            <div style={S.note}>
+              Run <code>orca contract</code> and trust it over remembered behavior. Run <code>orca agents</code> before
+              routing work so capability and caveat decisions use the live adapter manifests.
+            </div>
+            <table style={S.table}>
               <tbody>
-                <Flag
-                  flag="--spec <path>"
-                  desc="Path to a spec/markdown breakdown file"
-                />
-                <Flag
-                  flag="--config <path>"
-                  desc="Path to an orca config file"
-                />
-                <Flag
-                  flag="--on-milestone <cmd>"
-                  desc="Shell command to run on each milestone"
-                />
-                <Flag
-                  flag="--on-error <cmd>"
-                  desc="Shell command to run on error"
-                />
+                <DocRow name="lane">Orca&apos;s durable unit of delegated work.</DocRow>
+                <DocRow name="native session">The Codex thread, Claude session, or Cursor chat bound to a lane.</DocRow>
+                <DocRow name="event stream">Append-only evidence with gap-free sequence numbers.</DocRow>
+                <DocRow name="envelope">The final, versioned JSON result emitted by every lane verb.</DocRow>
               </tbody>
             </table>
-          </CmdSection>
+          </section>
 
-          {/* orca status */}
-          <CmdSection
-            id="cmd-status"
-            title="orca status"
-            usage="orca status [flags]"
-            desc="Without --run or --last, lists all runs as a summary table. With --run or --last, shows detailed status for a specific run — tasks completed, in-progress, pending, or failed."
-          >
+          <section id="surfaces" style={S.section}>
+            <h2 style={S.h2}>Dispatch Surfaces</h2>
+            <h3 style={S.h3}>lane — internal worker (default)</h3>
+            <p style={S.p}>
+              A worker intended to report its result back to a coordinating agent or script. It remains durable so it
+              can be inspected and resumed.
+            </p>
+            <CodeBlock code={`orca dispatch --agent codex --cwd . "Investigate the flaky test"`} lang="shell" />
+
+            <h3 style={S.h3}>task — user-followable Codex thread</h3>
+            <p style={S.p}>
+              A deliberately named thread intended for direct follow-up in Codex clients that share the same
+              <code> CODEX_HOME</code>. Task surface is Codex-only and requires a non-empty <code>--label</code>.
+            </p>
             <CodeBlock
-              code={`orca status            # list all runs (summary table)
-orca status --last     # status of the most recent run
-orca status --run <id> # status of a specific run`}
+              code={`orca dispatch --agent codex --surface task \\
+  --label "HAPPY-123 — Fix API" \\
+  --cwd /path/to/existing/worktree \\
+  "Implement HAPPY-123 and run its focused tests"`}
               lang="shell"
             />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag
-                  flag="--run <run-id>"
-                  desc="Show status for a specific run ID"
-                />
-                <Flag
-                  flag="--last"
-                  desc="Show status for the most recent run"
-                />
-                <Flag
-                  flag="--config <path>"
-                  desc="Path to an orca config file"
-                />
-              </tbody>
-            </table>
-          </CmdSection>
+            <div style={S.note}>
+              Task surface does not provision a Codex Desktop-managed project or worktree. Pass an existing checkout
+              with <code>--cwd</code>. Persistent lane threads can also appear in Desktop because the requested source
+              is a host-normalized hint, not a visibility filter.
+            </div>
+          </section>
+
+          <SectionLabel>Commands</SectionLabel>
 
-          {/* orca list */}
           <CmdSection
-            id="cmd-list"
-            title="orca list"
-            usage="orca list [flags]"
-            desc="List all runs stored in the runs directory."
+            id="cmd-dispatch"
+            title="orca dispatch"
+            usage="orca dispatch --agent <agent> [--surface lane|task] [--model <model>] [--cwd <dir>] [--label <label>] [--timeout <ms>] <prompt>"
+            description="Create a lane and drive one native agent turn until it completes, fails, is killed, times out, or blocks on a question."
           >
-            <CodeBlock code={`orca list`} lang="shell" />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
+            <table style={S.table}>
               <tbody>
-                <Flag
-                  flag="--config <path>"
-                  desc="Path to an orca config file"
-                />
+                <DocRow name="--agent">Required adapter: codex, claude, or cursor.</DocRow>
+                <DocRow name="--surface">Ownership surface. Defaults to lane; task is Codex-only.</DocRow>
+                <DocRow name="--model">Adapter-specific model override.</DocRow>
+                <DocRow name="--cwd">Agent working directory. Defaults to the current directory.</DocRow>
+                <DocRow name="--label">Orca label; required native title for task surface.</DocRow>
+                <DocRow name="--timeout">One deadline shared by connection, session binding, and the turn.</DocRow>
               </tbody>
             </table>
-          </CmdSection>
-
-          {/* orca resume */}
-          <CmdSection
-            id="cmd-resume"
-            title="orca resume"
-            usage="orca resume [flags]"
-            desc="Resume a paused or interrupted run from where it left off."
-          >
+            <p style={S.p}>
+              Dispatch prints a handle line immediately after lane creation, then exactly one final envelope. Capture
+              the handle when another process may need to inspect or kill the lane before the turn settles.
+            </p>
             <CodeBlock
-              code={`orca resume --last
-orca resume --run feature-auth-1766228123456-1a2b`}
-              lang="shell"
+              code={`{"v":1,"kind":"handle","laneId":"lane_a3f81c02","agent":"codex"}
+{"v":1,"kind":"lane","ok":true,"status":"completed","lane":{"id":"lane_a3f81c02","agent":"codex","surface":"lane"},"delivery":"confirmed","nativeStatus":"completed","semanticOutcome":"unknown","result":{"text":"..."}}`}
+              lang="json"
             />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag
-                  flag="--run <run-id>"
-                  desc="Resume a specific run by ID"
-                />
-                <Flag flag="--last" desc="Resume the most recent run" />
-                <Flag
-                  flag="--config <path>"
-                  desc="Path to an orca config file"
-                />
-                <Flag
-                  flag="--codex-only"
-                  desc="Force Codex executor for this resume"
-                />
-                <Flag
-                  flag="--codex-effort <low|medium|high|xhigh>"
-                  desc="Override Codex effort for this resume"
-                />
-              </tbody>
-            </table>
           </CmdSection>
 
-          {/* orca cancel */}
           <CmdSection
-            id="cmd-cancel"
-            title="orca cancel"
-            usage="orca cancel [flags]"
-            desc="Cancel a running or paused run."
+            id="cmd-inspect"
+            title="orca inspect"
+            usage="orca inspect <laneId> [--follow] [--since <seq>] [--wait-for blocked|done] [--timeout <ms>]"
+            description="Read current state and durable events, optionally following until a target state is reached."
           >
             <CodeBlock
-              code={`orca cancel --last
-orca cancel --run feature-auth-1766228123456-1a2b`}
+              code={`orca inspect lane_a3f81c02
+orca inspect lane_a3f81c02 --since 7
+orca inspect lane_a3f81c02 --follow
+orca inspect lane_a3f81c02 --wait-for blocked --timeout 600000`}
               lang="shell"
             />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag
-                  flag="--run <run-id>"
-                  desc="Cancel a specific run by ID"
-                />
-                <Flag flag="--last" desc="Cancel the most recent run" />
-                <Flag
-                  flag="--config <path>"
-                  desc="Path to an orca config file"
-                />
-              </tbody>
-            </table>
+            <p style={S.p}>
+              <code>--since N</code> returns events with a sequence greater than N. Terminal states also satisfy
+              <code> --wait-for blocked</code>, so always read the returned <code>status</code> instead of assuming the
+              lane actually blocked.
+            </p>
           </CmdSection>
 
-          {/* orca answer */}
           <CmdSection
             id="cmd-answer"
             title="orca answer"
-            usage="orca answer <run-id> <answer>"
-            desc="Provide an answer to a run that is blocked waiting for input."
+            usage="orca answer <laneId> <text>"
+            description="Submit an answer to a blocked lane's pending question."
           >
-            <CodeBlock
-              code={`orca answer feature-auth-1766228123456-1a2b "yes, use migration A"`}
-              lang="shell"
-            />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag flag="[run-id]" desc="Run ID (positional)" />
-                <Flag flag="[answer]" desc="Answer text (positional)" />
-                <Flag
-                  flag="--run <id>"
-                  desc="Run ID as a named flag (alias for positional)"
-                />
-              </tbody>
-            </table>
+            <CodeBlock code={`orca answer lane_a3f81c02 "Use the staging database"`} lang="shell" />
+            <p style={S.p}>
+              Answering a lane that is not blocked returns <code>invalid_state</code> (exit 4). Only Codex currently
+              supports question parking, and that model behavior remains best-effort.
+            </p>
           </CmdSection>
 
-          {/* orca pr */}
           <CmdSection
-            id="cmd-pr"
-            title="orca pr"
-            usage="orca pr <subcommand> [flags]"
-            desc="Manage pull requests for a run. Subcommands: draft, create, publish, status."
+            id="cmd-resume"
+            title="orca resume"
+            usage="orca resume <laneId> [--timeout <ms>] <prompt>"
+            description="Start a follow-up turn on the same native session and fail loud if continuity cannot be verified."
           >
-            <CodeBlock
-              code={`orca pr                          # default pr action
-orca pr draft   --run <run-id>   # open a draft PR
-orca pr create  --run <run-id>   # create a PR
-orca pr publish --run <run-id>   # publish (un-draft) the PR
-orca pr status  --run <run-id>   # check PR status`}
-              lang="shell"
-            />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag
-                  flag="--run <run-id>"
-                  desc="Target a specific run by ID"
-                />
-                <Flag flag="--last" desc="Target the most recent run" />
-                <Flag
-                  flag="--config <path>"
-                  desc="Accepted for compatibility; currently unused by PR command run resolution"
-                />
-              </tbody>
-            </table>
+            <CodeBlock code={`orca resume lane_a3f81c02 "Now add tests for the edge cases"`} lang="shell" />
+            <p style={S.p}>
+              Completed and parked blocked lanes can resume. Failed, killed, and lost lanes cannot. A blocked lane with
+              a live question poller rejects resume to prevent two processes from driving one native session.
+            </p>
           </CmdSection>
 
-          {/* orca pr publish */}
           <CmdSection
-            id="cmd-pr-publish"
-            title="orca pr publish"
-            usage="orca pr publish [flags]"
-            desc="Publish a draft PR for a run (ready for review). In TTY mode, run selection is interactive when --run/--last is omitted; non-TTY requires --run or --last."
+            id="cmd-lanes"
+            title="orca lanes"
+            usage="orca lanes"
+            description="List known lane records newest-first in a kind:list envelope."
           >
-            <CodeBlock
-              code={`orca pr publish --run <run-id>
-orca pr publish --last
-orca pr publish --config ./orca.config.js   # accepted, currently unused by PR command resolution
-
-# Non-TTY requires explicit selection
-orca pr publish --last`}
-              lang="shell"
-            />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag
-                  flag="--run <run-id>"
-                  desc="Target a specific run by ID"
-                />
-                <Flag flag="--last" desc="Target the most recent run" />
-                <Flag
-                  flag="--config <path>"
-                  desc="Accepted for compatibility; currently unused by PR command run resolution"
-                />
-              </tbody>
-            </table>
+            <CodeBlock code="orca lanes" lang="shell" />
           </CmdSection>
 
-          {/* orca setup */}
           <CmdSection
-            id="cmd-setup"
-            title="orca setup"
-            usage="orca setup [flags]"
-            desc="Configure API keys and environment. Supports scoped config (global or project-level)."
+            id="cmd-kill"
+            title="orca kill"
+            usage="orca kill <laneId>"
+            description="Terminate a queued, running, or blocked lane using the persisted native process identity."
           >
-            <CodeBlock
-              code={`orca setup                      # auto-detect (default)
-orca setup --openai-key sk-...
-orca setup --openai-key sk-...
-orca setup --executor codex
-orca setup --ts --global         # write to ~/.orca/config.ts
-orca setup --ts --project        # write to ./orca.config.ts`}
-              lang="shell"
-            />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag flag="--openai-key <key>" desc="Set OpenAI API key" />
-                <Flag
-                  flag="--executor <codex>"
-                  desc="Explicitly set executor in written config"
-                />
-                <Flag
-                  flag="--ts"
-                  desc="Write TypeScript config output (.ts) instead of .js"
-                />
-                <Flag
-                  flag="--global"
-                  desc="Write global config (~/.orca/config.js by default, or .ts with --ts)"
-                />
-                <Flag
-                  flag="--project"
-                  desc="Write project config (./orca.config.js by default, or .ts with --ts)"
-                />
-                <Flag
-                  flag="--project-config-template"
-                  desc="Write a typed project hook template to ./orca.config.ts"
-                />
-                <Flag
-                  flag="--skip-project-config"
-                  desc="Do not prompt to generate a project config template"
-                />
-              </tbody>
-            </table>
+            <CodeBlock code="orca kill lane_a3f81c02" lang="shell" />
+            <p style={S.p}>
+              Killing an already-killed lane is idempotent. Killing a completed, failed, or lost lane returns
+              <code> invalid_state</code>.
+            </p>
           </CmdSection>
 
-          {/* orca skills */}
           <CmdSection
-            id="cmd-skills"
-            title="orca skills"
-            usage="orca skills [flags]"
-            desc="List loaded skills and their sources."
+            id="cmd-agents"
+            title="orca agents"
+            usage="orca agents"
+            description="Return the live adapter manifests used for evidence-based routing."
           >
-            <CodeBlock
-              code={`orca skills
-orca skills --config ./orca.config.js`}
-              lang="shell"
-            />
-            <h3 style={S.h3}>Flags</h3>
-            <table style={S.flagTable}>
+            <CodeBlock code={`orca agents | jq '.agents[] | {agent, capabilities, caveats}'`} lang="shell" />
+            <table style={S.table}>
               <tbody>
-                <Flag
-                  flag="--config <path>"
-                  desc="Path to an orca config file"
-                />
+                <DocRow name="codex">
+                  App Server threads, thread-ID continuity, best-effort question parking, optional browser use, and
+                  named task surface.
+                </DocRow>
+                <DocRow name="claude">
+                  One-shot <code>claude -p</code>, session-ID continuity, no question parking, and permissions that can
+                  deny writes by default.
+                </DocRow>
+                <DocRow name="cursor">
+                  Cursor chat continuity, worktree support, no question parking, and a first-output heartbeat for cold
+                  starts that can take 30–100 seconds.
+                </DocRow>
               </tbody>
             </table>
+            <p style={S.p}>
+              Model lists and measured overhead can change. Read the manifest instead of hard-coding them.
+            </p>
           </CmdSection>
 
-          {/* orca help */}
           <CmdSection
-            id="cmd-help"
-            title="orca help"
-            usage="orca help [command]"
-            desc="Show help for any command."
+            id="cmd-contract"
+            title="orca contract"
+            usage="orca contract [--schema envelope|event|manifest]"
+            description="Return the versioned command contract, exit codes, notes, and JSON Schemas."
           >
             <CodeBlock
-              code={`orca help
-orca help plan
-orca help pr
-orca --help`}
+              code={`orca contract
+orca contract --schema envelope
+orca contract --schema event
+orca contract --schema manifest`}
               lang="shell"
             />
+            <div style={S.note}>If this page and an installed Orca disagree, the installed contract wins.</div>
           </CmdSection>
 
-          {/* ══════════════════════════════════════════════
-              CONFIG
-          ══════════════════════════════════════════════ */}
+          <SectionLabel>Contract</SectionLabel>
 
-          <div
-            style={{
-              paddingTop: "40px",
-              paddingBottom: "8px",
-              color: "#52525b",
-              fontSize: "11px",
-              fontFamily: "ui-monospace, monospace",
-              letterSpacing: "0.1em",
-              textTransform: "uppercase",
-              borderTop: "1px solid #1f1f1f",
-            }}
-          >
-            Config
-          </div>
+          <section id="question-flow" style={S.section}>
+            <h2 style={S.h2}>Blocked Question Flow</h2>
+            <CodeBlock
+              code={`# Terminal states also satisfy this wait; inspect status.
+orca inspect lane_a3f81c02 --wait-for blocked --timeout 600000
 
-          {/* Config discovery */}
-          <section id="config-discovery" style={S.section}>
-            <h2 style={S.h2}>Config Discovery</h2>
+orca answer lane_a3f81c02 "Postgres"
+orca resume lane_a3f81c02 "Continue with that answer"`}
+              lang="shell"
+            />
             <p style={S.p}>
-              Orca auto-discovers config in this order — later entries override
-              earlier ones:
+              <code>blocked</code> is a successful state: <code>ok:true</code>, exit 0. It means the turn stopped at an
+              explicit input boundary, not that the adapter failed.
             </p>
-            <ol
-              style={{
-                color: "#a1a1aa",
-                lineHeight: "2",
-                paddingLeft: "20px",
-                margin: "0 0 16px",
-                fontSize: "14px",
-              }}
-            >
-              <li>
-                <code
-                  style={{
-                    fontFamily: "ui-monospace, monospace",
-                    color: "#22d3ee",
-                  }}
-                >
-                  ~/.orca/config.ts
-                </code>{" "}
-                (takes precedence when both exist) or{" "}
-                <code
-                  style={{
-                    fontFamily: "ui-monospace, monospace",
-                    color: "#22d3ee",
-                  }}
-                >
-                  ~/.orca/config.js
-                </code>{" "}
-                — global user config
-              </li>
+          </section>
+
+          <section id="envelopes" style={S.section}>
+            <h2 style={S.h2}>Envelope Semantics</h2>
+            <p style={S.p}>Three independent axes prevent protocol delivery from being mistaken for task success:</p>
+            <table style={S.table}>
+              <tbody>
+                <DocRow name="delivery">Whether the native agent acknowledged the turn.</DocRow>
+                <DocRow name="nativeStatus">What the native protocol or process reported.</DocRow>
+                <DocRow name="semanticOutcome">
+                  An explicit validator result. Without a validator it stays unknown; Orca never infers correctness from
+                  prose.
+                </DocRow>
+              </tbody>
+            </table>
+            <CodeBlock
+              code={`{
+  "v": 1,
+  "kind": "lane",
+  "ok": true,
+  "status": "completed",
+  "lane": {
+    "id": "lane_a3f81c02",
+    "agent": "codex",
+    "surface": "task",
+    "agentSessionId": "019f..."
+  },
+  "delivery": "confirmed",
+  "nativeStatus": "completed",
+  "semanticOutcome": "unknown",
+  "result": { "text": "..." },
+  "timing": { "wallMs": 6557, "startupMs": 2050 }
+}`}
+              lang="json"
+            />
+            <ul style={S.list}>
               <li>
-                <code
-                  style={{
-                    fontFamily: "ui-monospace, monospace",
-                    color: "#22d3ee",
-                  }}
-                >
-                  ./orca.config.ts
-                </code>{" "}
-                (takes precedence when both exist) or{" "}
-                <code
-                  style={{
-                    fontFamily: "ui-monospace, monospace",
-                    color: "#22d3ee",
-                  }}
-                >
-                  ./orca.config.js
-                </code>{" "}
-                — project config
+                A command never exits 0 with <code>ok:false</code>.
               </li>
               <li>
-                <code
-                  style={{
-                    fontFamily: "ui-monospace, monospace",
-                    color: "#22d3ee",
-                  }}
-                >
-                  --config {"<path>"}
-                </code>{" "}
-                — explicit override
+                <code>usage</code> and <code>timing</code> cover one dispatch or resume turn, not lane history.
               </li>
-            </ol>
-            <p style={{ ...S.p, fontSize: "13px" }}>
-              <strong style={{ color: "#e2e8f0" }}>Run state</strong> is stored
-              at{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {"<runsDir>/<run-id>/status.json"}
-              </code>
-              . Defaults to{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                ~/.orca/runs
-              </code>{" "}
-              unless overridden by{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                ORCA_RUNS_DIR
-              </code>
-              .
-            </p>
-            <p style={{ ...S.p, fontSize: "13px" }}>
-              Validator caveat:{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                ORCA_SKIP_VALIDATORS=1
-              </code>{" "}
-              forces{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                review.execution.validator.auto
-              </code>{" "}
-              off at runtime.
-            </p>
-          </section>
-
-          {/* Project instruction files */}
-          <section id="config-project-instructions" style={S.section}>
-            <h2 style={S.h2}>Project Instruction Files</h2>
-            <p style={S.p}>
-              During planning, Orca automatically injects project instruction
-              files when present:
-            </p>
-            <ol
-              style={{
-                color: "#a1a1aa",
-                lineHeight: "2",
-                paddingLeft: "20px",
-                margin: "0 0 16px",
-                fontSize: "14px",
-              }}
-            >
               <li>
-                <code
-                  style={{
-                    fontFamily: "ui-monospace, monospace",
-                    color: "#22d3ee",
-                  }}
-                >
-                  AGENTS.md
-                </code>
+                Continuity proves session identity, not semantic compliance. Read <code>status</code> and{" "}
+                <code>result.text</code>.
               </li>
-            </ol>
-            <p style={{ ...S.p, fontSize: "13px" }}>
-              Orca resolves the project root from the nearest{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                .git
-              </code>{" "}
-              and injects AGENTS.md when present.
-            </p>
+              <li>stderr is diagnostic and non-contractual; stdout carries the handle and envelope.</li>
+            </ul>
           </section>
 
-          {/* Config options */}
-          <section id="config-options" style={S.section}>
-            <h2 style={S.h2}>Config Options</h2>
-            <p style={S.p}>Full example — all options are optional:</p>
-            <CodeBlock
-              code={`// orca.config.ts
-import { defineOrcaConfig } from "orcastrator";
-
-export default defineOrcaConfig({
-  executor: "codex",
-  openaiApiKey: process.env.OPENAI_API_KEY,
-  runsDir: "./.orca/runs",
-  sessionLogs: "./session-logs",
-  skills: ["./.orca/skills"],
-  maxRetries: 1,
-
-  codex: {
-    enabled: true,
-    model: "gpt-5.3-codex",
-    thinkingLevel: {
-      decision: "low",
-      planning: "high",
-      execution: "medium",
-    },
-    command: "codex",
-    timeoutMs: 300000,
-    multiAgent: false,
-  },
-  pr: { enabled: true, requireConfirmation: true },
-  review: {
-    // Deprecated aliases: review.enabled / review.onInvalid
-    plan: { enabled: true, onInvalid: "fail" },
-    execution: {
-      enabled: true,
-      maxCycles: 2,
-      onFindings: "auto_fix",
-      validator: { auto: true },
-    },
-  },
-});`}
-              lang="ts"
-            />
-            <h3 style={S.h3}>Field reference</h3>
-            <table style={S.flagTable}>
+          <section id="exit-codes" style={S.section}>
+            <h2 style={S.h2}>Exit Codes</h2>
+            <table style={S.table}>
               <tbody>
-                <Flag
-                  flag="Top-level"
-                  desc="executor, openaiApiKey, runsDir, sessionLogs, skills, maxRetries, hooks, hookCommands, pr, review, codex"
-                />
-                <Flag
-                  flag="maxRetries"
-                  desc="Accepted OrcaConfig field; current planner-generated task retry limits remain fixed by task graph contracts"
-                />
-                <Flag
-                  flag="codex.*"
-                  desc="enabled, model, effort, thinkingLevel.decision|planning|execution, command, timeoutMs, multiAgent, perCwdExtraUserRoots"
-                />
-                <Flag flag="pr.*" desc="enabled, requireConfirmation" />
-                <Flag flag="review.plan.*" desc="enabled, onInvalid" />
-                <Flag
-                  flag="review.execution.*"
-                  desc="enabled, maxCycles, onFindings, validator.auto, validator.commands, prompt"
-                />
-                <Flag
-                  flag="Deprecated aliases"
-                  desc="review.enabled, review.onInvalid"
-                />
+                <DocRow name="0">
+                  Success, including <code>status:&quot;blocked&quot;</code>.
+                </DocRow>
+                <DocRow name="2">
+                  <code>usage_error</code> — malformed command line.
+                </DocRow>
+                <DocRow name="3">
+                  <code>agent_unavailable</code>, <code>adapter_error</code>, or <code>agent_failed</code>.
+                </DocRow>
+                <DocRow name="4">
+                  <code>invalid_state</code>, <code>lane_not_found</code>, or <code>continuity_unverified</code>.
+                </DocRow>
+                <DocRow name="5">
+                  <code>timeout</code> — the turn deadline was exceeded.
+                </DocRow>
               </tbody>
             </table>
-            <p style={{ ...S.p, fontSize: "13px", marginTop: "12px" }}>
-              Thinking-level controls are explicit: use
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {" codex.thinkingLevel.decision|planning|execution "}
-              </code>{" "}
-              with canonical values
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {" low|medium|high|xhigh "}
-              </code>
-              .
-            </p>
-            <p style={{ ...S.p, fontSize: "13px" }}>
-              On Codex session startup, Orca calls app-server
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {" skills/list "}
-              </code>{" "}
-              with
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {" cwds: [cwd], forceReload: true "}
-              </code>{" "}
-              and optional
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {" perCwdExtraUserRoots "}
-              </code>
-              .
-            </p>
           </section>
 
-          {/* Hooks */}
-          <section id="config-hooks" style={S.section}>
-            <h2 style={S.h2}>Hooks</h2>
+          <section id="storage" style={S.section}>
+            <h2 style={S.h2}>Durable State</h2>
             <p style={S.p}>
-              Function hooks are primary (
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                  fontSize: "13px",
-                }}
-              >
-                hooks
-              </code>
-              ) and are strongly typed with `defineOrcaConfig`. Command hooks (
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                  fontSize: "13px",
-                }}
-              >
-                hookCommands
-              </code>
-              ) are supported via config or CLI{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                  fontSize: "13px",
-                }}
-              >
-                --on-...
-              </code>{" "}
-              flags.
-            </p>
-            <table style={S.flagTable}>
-              <tbody>
-                <Flag
-                  flag="onMilestone"
-                  desc="Fired at each milestone checkpoint"
-                />
-                <Flag
-                  flag="onTaskComplete"
-                  desc="Fired when a single task completes successfully"
-                />
-                <Flag flag="onTaskFail" desc="Fired when a task fails" />
-                <Flag
-                  flag="onInvalidPlan"
-                  desc="Fired when planner/review output is invalid"
-                />
-                <Flag
-                  flag="onFindings"
-                  desc="Fired when post-exec review reports findings"
-                />
-                <Flag
-                  flag="onComplete"
-                  desc="Fired when the entire run completes successfully"
-                />
-                <Flag
-                  flag="onError"
-                  desc="Fired on run failure and on hook-dispatch/command-hook failures"
-                />
-              </tbody>
-            </table>
-            <p style={{ ...S.p, fontSize: "13px", marginTop: "16px" }}>
-              Hook handler context is deterministic:{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {"{ cwd, pid, invokedAt }"}
-              </code>
-              .
-            </p>
-            <p style={{ ...S.p, fontSize: "13px" }}>
-              Command hooks receive structured event payload JSON on stdin.
-            </p>
-            <h3 style={S.h3}>Interactive hook flow</h3>
-            <p style={{ ...S.p, fontSize: "13px" }}>
-              If a run needs operator input, Orca moves the run into
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {" waiting_for_answer "}
-              </code>
-              and pauses execution until an answer is submitted.
-            </p>
-            <CodeBlock
-              code={`# 1) Inspect the blocked run
-orca status --run <run-id>
-
-# 2) Submit the answer
-orca answer <run-id> "yes, use migration A"
-
-# 3) Continue execution
-orca resume --run <run-id>`}
-              lang="shell"
-            />
-            <p
-              style={{
-                ...S.p,
-                fontSize: "13px",
-                color: "#71717a",
-                marginTop: "8px",
-              }}
-            >
-              See{" "}
-              <a
-                href="#types"
-                style={{ color: "#93c5fd", textDecoration: "none" }}
-              >
-                Types ↓
-              </a>{" "}
-              for full hook event and context contracts.
+              Lane state lives under <code>${"${ORCA_HOME:-~/.orca}"}/lanes/&lt;laneId&gt;/</code>. Set
+              <code> ORCA_HOME</code> to isolate tests and automation from personal history.
             </p>
             <CodeBlock
-              code={`# Via config (function hooks + command hooks)
-import { defineOrcaConfig } from "orcastrator";
-import type { HookEventMap, HookHandlerContext } from "orcastrator/types";
-
-export default defineOrcaConfig({
-  hooks: {
-    onTaskComplete: async (event, context) => {
-      const _typedEvent: HookEventMap["onTaskComplete"] = event;
-      const _typedContext: HookHandlerContext = context;
-      console.log(\`task done: \${event.taskName}\`, context.cwd);
-    },
-  },
-  hookCommands: {
-    onTaskComplete: "node ./scripts/on-task-complete.mjs",
-  },
-});
-
-# ./scripts/on-task-complete.mjs
-# let s = ""; process.stdin.on("data", d => s += d);
-# process.stdin.on("end", () => {
-#   const payload = JSON.parse(s);
-#   console.log(\`done: \${payload.taskName}\`);
-# });`}
-              lang="ts"
+              code={`lane.json       # durable lane record
+events.ndjson   # append-only evidence stream
+answer.txt      # transient blocked-answer handoff`}
+              lang="text"
             />
           </section>
 
-          {/* Multi-agent */}
-          <section id="config-multiagent" style={S.section}>
-            <h2 style={S.h2}>Multi-agent Mode</h2>
+          <section id="legacy" style={S.section}>
+            <h2 style={S.h2}>Legacy Compatibility</h2>
             <p style={S.p}>
-              Codex supports experimental multi-agent workflows where it can
-              spawn parallel sub-agents for complex tasks. Off by default
-              because enabling it modifies your global{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                  fontSize: "13px",
-                }}
-              >
-                ~/.codex/config.toml
-              </code>
-              .
+              Graph-era run, plan, status, list, cancel, setup/config, and PR commands can still appear in root help.
+              They remain compatibility surfaces, not the canonical lane architecture.
             </p>
-            <div style={S.note}>
-              ⚠️ Enabling multi-agent mode writes{" "}
-              <code style={{ fontFamily: "ui-monospace, monospace" }}>
-                multi_agent = true
-              </code>{" "}
-              to your global Codex config. If you already have it enabled there,
-              orca picks it up automatically.
-            </div>
-            <CodeBlock
-              code={`// orca.config.js
-export default {
-  codex: { multiAgent: true }
-};`}
-              lang="js"
-            />
-
-            {/* Run ID format */}
-            <hr style={S.divider} />
-            <h3
-              style={{
-                ...S.h3,
-                marginTop: "0",
-                color: "#71717a",
-                fontSize: "13px",
-                fontWeight: 400,
-              }}
-            >
-              Run ID format
-            </h3>
-            <p style={{ ...S.p, fontSize: "13px" }}>
-              Run IDs are generated as{" "}
-              <code
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                }}
-              >
-                {"<slug>-<unix-ms>-<hex4>"}
-              </code>
-              :
+            <p style={S.p}>
+              The names <code>answer</code> and <code>resume</code> exist in both surfaces. Orca selects lane handling
+              when the first argument starts with <code>lane_</code>—all lane IDs do—or when lane help is requested.
+              Other values route to legacy commands.
             </p>
-            <CodeBlock code="feature-auth-1766228123456-1a2b" />
           </section>
 
-          {/* Agent Skill */}
           <section id="agent-skill" style={S.section}>
             <h2 style={S.h2}>Agent Skill</h2>
             <p style={S.p}>
-              Drop this SKILL.md into your agent&apos;s skills directory to give
-              it native Orca support.
+              Give an agent a compact operator guide. It starts with live contract discovery and keeps routing,
+              question, continuity, and task-surface caveats close to the commands.
             </p>
             <AgentSkillCard />
           </section>
 
-          {/* Types */}
-          <section id="types" style={S.section}>
-            <h2 style={S.h2}>Types</h2>
-            <p style={S.p}>
-              Full TypeScript contracts for hook events and context. Import
-              directly from{" "}
-              <a
-                href="https://github.com/ratley/orca/blob/master/src/types/index.ts"
-                target="_blank"
-                rel="noopener noreferrer"
-                style={{
-                  fontFamily: "ui-monospace, monospace",
-                  color: "#22d3ee",
-                  textDecoration: "none",
-                }}
-              >
-                orcastrator/types ↗
-              </a>
-              .
-            </p>
-            <h3 style={{ ...S.h3, marginTop: "24px" }}>HookHandlerContext</h3>
-            <p style={S.p}>
-              Passed as the second argument to every function hook.
-            </p>
-            <CodeBlock
-              code={`type HookHandlerContext = {
-  cwd: string;       // working directory of the orca run
-  pid: number;       // process id
-  invokedAt: string; // ISO timestamp of invocation
-};`}
-              lang="ts"
-            />
-            <h3 style={{ ...S.h3, marginTop: "24px" }}>BaseHookEvent</h3>
-            <p style={S.p}>
-              Base shape shared by all hook events. Hook-specific events extend
-              this.
-            </p>
-            <CodeBlock
-              code={`type BaseHookEvent = {
-  runId: RunId;
-  message: string;
-  timestamp: string;
-  taskId?: string;
-  taskName?: string;
-  error?: string;
-  metadata?: Record<string, string | number | boolean | null>;
-};`}
-              lang="ts"
-            />
-            <h3 style={{ ...S.h3, marginTop: "24px" }}>HookEventMap</h3>
-            <p style={S.p}>Maps each hook name to its full event type.</p>
-            <CodeBlock
-              code={`type HookEventMap = {
-  onMilestone:    BaseHookEvent & { hook: "onMilestone" };
-  onTaskComplete: BaseHookEvent & { hook: "onTaskComplete"; taskId: string; taskName: string };
-  onTaskFail:     BaseHookEvent & { hook: "onTaskFail"; taskId: string; taskName: string; error: string };
-  onInvalidPlan:  BaseHookEvent & { hook: "onInvalidPlan"; error: string };
-  onFindings:     BaseHookEvent & { hook: "onFindings" };
-  onComplete:     BaseHookEvent & { hook: "onComplete" };
-  onError:        BaseHookEvent & { hook: "onError"; error: string };
-};`}
-              lang="ts"
-            />
-            <h3 style={{ ...S.h3, marginTop: "24px" }}>
-              Example payload (JSON)
-            </h3>
-            <p style={S.p}>
-              Shape of the JSON written to stdin for command hooks.
-            </p>
-            <CodeBlock
-              code={`{
-  "hook": "onTaskComplete",
-  "runId": "feature-auth-1766228123456-1a2b",
-  "message": "Task completed",
-  "timestamp": "2026-02-22T12:00:00.000Z",
-  "taskId": "task-2",
-  "taskName": "Apply migration"
-}`}
-              lang="json"
-            />
-          </section>
-
-          {/* Footer */}
           <footer
             style={{
-              borderTop: "1px solid #1f1f1f",
-              padding: "32px 0",
+              padding: "28px 0 48px",
               color: "#3f3f46",
               fontSize: "12px",
               fontFamily: "ui-monospace, monospace",
-              display: "flex",
-              justifyContent: "space-between",
             }}
           >
-            <span>orca — orcastrator</span>
-            <a
-              href="https://github.com/ratley/orca"
-              target="_blank"
-              rel="noopener noreferrer"
-              style={{ color: "#3f3f46", textDecoration: "none" }}
-            >
-              github ↗
-            </a>
+            orcastrator · observable agent lanes · orca/v1
           </footer>
         </main>
       </div>
-
-      {/* Sidebar hide on mobile */}
-      <style>{`
-        @media (max-width: 640px) {
-          .sidebar-wrapper { display: none !important; }
-          main { padding: 0 20px !important; }
-        }
-        nav a:hover { color: #22d3ee !important; }
-        header a:hover { color: #e2e8f0 !important; }
-      `}</style>
     </>
   );
 }
diff --git a/biome.json b/biome.json
deleted file mode 100644
index 41b3b95..0000000
--- a/biome.json
+++ /dev/null
@@ -1,37 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.2.0/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "files": {
-    "ignoreUnknown": true,
-    "includes": ["**", "!node_modules", "!.next", "!dist", "!build"]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "suspicious": {
-        "noUnknownAtRules": "off"
-      }
-    },
-    "domains": {
-      "next": "recommended",
-      "react": "recommended"
-    }
-  },
-  "assist": {
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    }
-  }
-}
diff --git a/bun.lock b/bun.lock
index a0b29d6..eb15ac2 100644
--- a/bun.lock
+++ b/bun.lock
@@ -10,11 +10,12 @@
         "react-dom": "19.2.3",
       },
       "devDependencies": {
-        "@biomejs/biome": "2.2.0",
         "@tailwindcss/postcss": "^4",
         "@types/node": "^20",
         "@types/react": "^19",
         "@types/react-dom": "^19",
+        "oxfmt": "0.47.0",
+        "oxlint": "1.62.0",
         "tailwindcss": "^4",
         "typescript": "^5",
       },
@@ -26,24 +27,6 @@
   "packages": {
     "@alloc/quick-lru": ["@alloc/quick-lru@5.2.0", "", {}, "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw=="],
 
-    "@biomejs/biome": ["@biomejs/biome@2.2.0", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.2.0", "@biomejs/cli-darwin-x64": "2.2.0", "@biomejs/cli-linux-arm64": "2.2.0", "@biomejs/cli-linux-arm64-musl": "2.2.0", "@biomejs/cli-linux-x64": "2.2.0", "@biomejs/cli-linux-x64-musl": "2.2.0", "@biomejs/cli-win32-arm64": "2.2.0", "@biomejs/cli-win32-x64": "2.2.0" }, "bin": { "biome": "bin/biome" } }, "sha512-3On3RSYLsX+n9KnoSgfoYlckYBoU6VRM22cw1gB4Y0OuUVSYd/O/2saOJMrA4HFfA1Ff0eacOvMN1yAAvHtzIw=="],
-
-    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.2.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-zKbwUUh+9uFmWfS8IFxmVD6XwqFcENjZvEyfOxHs1epjdH3wyyMQG80FGDsmauPwS2r5kXdEM0v/+dTIA9FXAg=="],
-
-    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.2.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-+OmT4dsX2eTfhD5crUOPw3RPhaR+SKVspvGVmSdZ9y9O/AgL8pla6T4hOn1q+VAFBHuHhsdxDRJgFCSC7RaMOw=="],
-
-    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.2.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-6eoRdF2yW5FnW9Lpeivh7Mayhq0KDdaDMYOJnH9aT02KuSIX5V1HmWJCQQPwIQbhDh68Zrcpl8inRlTEan0SXw=="],
-
-    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.2.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-egKpOa+4FL9YO+SMUMLUvf543cprjevNc3CAgDNFLcjknuNMcZ0GLJYa3EGTCR2xIkIUJDVneBV3O9OcIlCEZQ=="],
-
-    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.2.0", "", { "os": "linux", "cpu": "x64" }, "sha512-5UmQx/OZAfJfi25zAnAGHUMuOd+LOsliIt119x2soA2gLggQYrVPA+2kMUxR6Mw5M1deUF/AWWP2qpxgH7Nyfw=="],
-
-    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.2.0", "", { "os": "linux", "cpu": "x64" }, "sha512-I5J85yWwUWpgJyC1CcytNSGusu2p9HjDnOPAFG4Y515hwRD0jpR9sT9/T1cKHtuCvEQ/sBvx+6zhz9l9wEJGAg=="],
-
-    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.2.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-n9a1/f2CwIDmNMNkFs+JI0ZjFnMO0jdOyGNtihgUNFnlmd84yIYY2KMTBmMV58ZlVHjgmY5Y6E1hVTnSRieggA=="],
-
-    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.2.0", "", { "os": "win32", "cpu": "x64" }, "sha512-Nawu5nHjP/zPKTIryh2AavzTc/KEg4um/MxWdXW0A6P/RZOyIpa7+QSjeXwAwX/utJGaCoXRPWtF3m5U/bB3Ww=="],
-
     "@emnapi/runtime": ["@emnapi/runtime@1.8.1", "", { "dependencies": { "tslib": "^2.4.0" } }, "sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg=="],
 
     "@img/colour": ["@img/colour@1.0.0", "", {}, "sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw=="],
@@ -124,6 +107,82 @@
 
     "@next/swc-win32-x64-msvc": ["@next/swc-win32-x64-msvc@16.1.6", "", { "os": "win32", "cpu": "x64" }, "sha512-NRfO39AIrzBnixKbjuo2YiYhB6o9d8v/ymU9m/Xk8cyVk+k7XylniXkHwjs4s70wedVffc6bQNbufk5v0xEm0A=="],
 
+    "@oxfmt/binding-android-arm-eabi": ["@oxfmt/binding-android-arm-eabi@0.47.0", "", { "os": "android", "cpu": "arm" }, "sha512-KrMQRdMi/upr81qT4ijK6X6BNp6jqpMY7FwILQnwIy9QLc3qpnhUx5rsCLGzn4ewsCQ0CNAspN2ogmP1GXLyLw=="],
+
+    "@oxfmt/binding-android-arm64": ["@oxfmt/binding-android-arm64@0.47.0", "", { "os": "android", "cpu": "arm64" }, "sha512-r4ixS/PeUpAFKgrpDoZ5pSkthjZzVzKd95525Aazj+aOv9H4ulK5zYHGb7wFY5n5kZxHK8TbOJUZgoEb1ohddQ=="],
+
+    "@oxfmt/binding-darwin-arm64": ["@oxfmt/binding-darwin-arm64@0.47.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-CLWxiKpMl+195cm09CuaWEhJK0CirRkoMa07aR9+9AFPat2LfIKtwx1JqxZM0MTvcMe6+adlJNdVL6jdInvq3g=="],
+
+    "@oxfmt/binding-darwin-x64": ["@oxfmt/binding-darwin-x64@0.47.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-Xq5fjTYDC50faUeLSm0rZdBqoTgleXEdD7NpJdARtQIczkCJn3xNjMUSQQkUmh4CtxkKTNL68lytcOK3e/osgg=="],
+
+    "@oxfmt/binding-freebsd-x64": ["@oxfmt/binding-freebsd-x64@0.47.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-QOU9ZIJ52p5askcEC0QJvvr8trHAWoonul8bgISo6gYUL3s50zkqafBYcNAr9LJZQbsZtPfIWHk9+5+nUp1qJQ=="],
+
+    "@oxfmt/binding-linux-arm-gnueabihf": ["@oxfmt/binding-linux-arm-gnueabihf@0.47.0", "", { "os": "linux", "cpu": "arm" }, "sha512-oJxDM1aBhPvz9gmElBv8UpxyiqhwfjcbrSxT5F0xtuUzY6dQI27/AQPIt3eu3Z5Yvn0kQl5R7MA3Z+MbnRvCBw=="],
+
+    "@oxfmt/binding-linux-arm-musleabihf": ["@oxfmt/binding-linux-arm-musleabihf@0.47.0", "", { "os": "linux", "cpu": "arm" }, "sha512-g8Lh50VS4ibGz2q6v7r9UZY4D0dM16SdrFYOMzhqIoCwGcai8VMIRUAcqn1/jlCsOOzUXJ741+kCeJt0cofakQ=="],
+
+    "@oxfmt/binding-linux-arm64-gnu": ["@oxfmt/binding-linux-arm64-gnu@0.47.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-YrNT1vQ0asaXoRbrvYENPqmBfOQ9Xr8enPNOULeYfg44VjCcrUowFy5QZr+WawE0zyP8cH9e9Gxxg0fDEFzhcg=="],
+
+    "@oxfmt/binding-linux-arm64-musl": ["@oxfmt/binding-linux-arm64-musl@0.47.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-IxtQC/sbBi4ubbY+MdwdanRWrG9InQJVZqyMsBa5IUaQcnSg86gQme574HxXMC1p4bo4YhV99zQ+wNnGCvEgzw=="],
+
+    "@oxfmt/binding-linux-ppc64-gnu": ["@oxfmt/binding-linux-ppc64-gnu@0.47.0", "", { "os": "linux", "cpu": "ppc64" }, "sha512-EWXEhOMbWO0q6eJSbu0QLkU8cKi0ljlYLngeDs2Ocu/pm1rrLwyQiYzlFbdnMRURI4w9ndr1sI9rSbhlJ5o23Q=="],
+
+    "@oxfmt/binding-linux-riscv64-gnu": ["@oxfmt/binding-linux-riscv64-gnu@0.47.0", "", { "os": "linux", "cpu": "none" }, "sha512-tZrjS11TUiDuEpRaqdk8K9F9xETRyKXfuZKmdeW+Gj7coBnm7+8sBEfyt033EAFEQSlkniAXvBLh+Qja2ioGBQ=="],
+
+    "@oxfmt/binding-linux-riscv64-musl": ["@oxfmt/binding-linux-riscv64-musl@0.47.0", "", { "os": "linux", "cpu": "none" }, "sha512-KBFy+2CFKUCZzYwX2ZOPQKck1vjQbz+hextuc19G4r0WRJwadfAeuQMQRQvB+Ivc8brlbOVg7et8K7E467440g=="],
+
+    "@oxfmt/binding-linux-s390x-gnu": ["@oxfmt/binding-linux-s390x-gnu@0.47.0", "", { "os": "linux", "cpu": "s390x" }, "sha512-REUPFKVGSiK99B+9eaPhluEVglzaoj/SMykNC5SUiV2RSsBfV5lWN7Y0iCIc251Wz3GaeAGZsJ/zj3gjarxdFg=="],
+
+    "@oxfmt/binding-linux-x64-gnu": ["@oxfmt/binding-linux-x64-gnu@0.47.0", "", { "os": "linux", "cpu": "x64" }, "sha512-KVftVSVEDeIfRW3TIeLe3aNI/iY4m1fu5mDwHcisKMZSCMKLkrhFsjowC7o9RoqNPxbbglm2+/6KAKBIts2t0Q=="],
+
+    "@oxfmt/binding-linux-x64-musl": ["@oxfmt/binding-linux-x64-musl@0.47.0", "", { "os": "linux", "cpu": "x64" }, "sha512-DTsmGEaA2860Aq5VUyDO8/MT9NFxwVL93RnRYmpMwK6DsSkThmvEpqoUDDljziEpAedMRG19SCogrNbINSbLUQ=="],
+
+    "@oxfmt/binding-openharmony-arm64": ["@oxfmt/binding-openharmony-arm64@0.47.0", "", { "os": "none", "cpu": "arm64" }, "sha512-8r5BDro7fLOBoq1JXHLVSs55OlrxQhEso4HVo0TcY7OXJUPYfjPoOaYL5us+yIwqyP9rQwN+rxuiNFSmaxSuOQ=="],
+
+    "@oxfmt/binding-win32-arm64-msvc": ["@oxfmt/binding-win32-arm64-msvc@0.47.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-qtz/gzm8IjSPUlseZ0ofW8zyHLoZsuP5HTfcGGkWkUblB89JT8GNYH3ICqjbDsqsGqXum0/ZndXTFplSdXFIcg=="],
+
+    "@oxfmt/binding-win32-ia32-msvc": ["@oxfmt/binding-win32-ia32-msvc@0.47.0", "", { "os": "win32", "cpu": "ia32" }, "sha512-5vIcdcIDE7nCx+MXN6sm8kbC4zajDB31E86rez4i45iHNH/2NjdKlJ720xcHTr3eeiMcttCGPHPhE1TjtBDGZw=="],
+
+    "@oxfmt/binding-win32-x64-msvc": ["@oxfmt/binding-win32-x64-msvc@0.47.0", "", { "os": "win32", "cpu": "x64" }, "sha512-Sr59Y5ms54ONBjxFeWhVlGyQcHXxcl9DxC23f6yXlRkcos7LXBLoO+KDfxexjHIOZh7cWqrWduzvUjJ+pHp8cQ=="],
+
+    "@oxlint/binding-android-arm-eabi": ["@oxlint/binding-android-arm-eabi@1.62.0", "", { "os": "android", "cpu": "arm" }, "sha512-pKsthNECyvJh8lPTICz6VcwVy2jOqdhhsp1rlxCkhgZR47aKvXPmaRWQDv+zlXpRae4qm1MaaTnutkaOk5aofg=="],
+
+    "@oxlint/binding-android-arm64": ["@oxlint/binding-android-arm64@1.62.0", "", { "os": "android", "cpu": "arm64" }, "sha512-b1AUNViByvgmR2xJDubvLIr+dSuu3uraG7bsAoKo+xrpspPvu6RIn6Fhr2JUhobfep3jwUTy18Huco6GkwdvGQ=="],
+
+    "@oxlint/binding-darwin-arm64": ["@oxlint/binding-darwin-arm64@1.62.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-iG+Tvf70UJ6otfwFYIHk36Sjq9cpPP5YLxkoggANNRtzgi3Tj3g8q6Ybqi6AtkU3+yg9QwF7bDCkCS6bbL4PCg=="],
+
+    "@oxlint/binding-darwin-x64": ["@oxlint/binding-darwin-x64@1.62.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-oOWI6YPPr5AJUx+yIDlxmuUbQjS5gZX3OH3QisawYvsZgLiQVvZtR0rPBcJTxLWqt2ClrWg0DlSrlUiG5SQNHg=="],
+
+    "@oxlint/binding-freebsd-x64": ["@oxlint/binding-freebsd-x64@1.62.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-dLP33T7VLCmLVv4cvjkVX+rmkcwNk2UfxmsZPNur/7BQHoQR60zJ7XLiRvNUawlzn0u8ngCa3itjEG73MAMa/w=="],
+
+    "@oxlint/binding-linux-arm-gnueabihf": ["@oxlint/binding-linux-arm-gnueabihf@1.62.0", "", { "os": "linux", "cpu": "arm" }, "sha512-fl//LWNks6qo9chNY60UDYyIwtp7a5cEx4Y/rHPjaarhuwqx6jtbzEpD5V5AqmdL4a6Y5D8zeXg5HF2Cr0QmSQ=="],
+
+    "@oxlint/binding-linux-arm-musleabihf": ["@oxlint/binding-linux-arm-musleabihf@1.62.0", "", { "os": "linux", "cpu": "arm" }, "sha512-i5vkAuxvueTODV3J2dL61/TXewDHhMFKvtD156cIsk7GsdfiAu7zW7kY0NJXhKeFHeiMZIh7eFNjkPYH6J47HQ=="],
+
+    "@oxlint/binding-linux-arm64-gnu": ["@oxlint/binding-linux-arm64-gnu@1.62.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-QwN19LLuIGuOjEflSeJkZmOTfBdBMlTmW8xbMf8TZhjd//cxVNYQPq75q7oKZBJc6hRx3gY7sX0Egc8cEIFZYg=="],
+
+    "@oxlint/binding-linux-arm64-musl": ["@oxlint/binding-linux-arm64-musl@1.62.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-8eCy3FCDuWUM5hWujAv6heMvfZPbcCOU3SdQUAkixZLu5bSzOkNfirJiLGoQFO943xceOKkiQRMQNzH++jM3WA=="],
+
+    "@oxlint/binding-linux-ppc64-gnu": ["@oxlint/binding-linux-ppc64-gnu@1.62.0", "", { "os": "linux", "cpu": "ppc64" }, "sha512-NjQ7K7tpTPDe9J+yq8p/s/J0E7lRCkK2uDBDqvT4XIT6f4Z0tlnr59OBg/WcrmVHER1AbrcfyxhGTXgcG8ytWg=="],
+
+    "@oxlint/binding-linux-riscv64-gnu": ["@oxlint/binding-linux-riscv64-gnu@1.62.0", "", { "os": "linux", "cpu": "none" }, "sha512-oKZed9gmSwze29dEt3/Wnsv6l/Ygw/FUst+8Kfpv2SGeS/glEoTGZAMQw37SVyzFV76UTHJN2snGgxK2t2+8ow=="],
+
+    "@oxlint/binding-linux-riscv64-musl": ["@oxlint/binding-linux-riscv64-musl@1.62.0", "", { "os": "linux", "cpu": "none" }, "sha512-gBjBxQ+9lGpAYq+ELqw0w8QXsBnkZclFc7GRX2r0LnEVn3ZTEqeIKpKcGjucmp76Q53bvJD0i4qBWBhcfhSfGA=="],
+
+    "@oxlint/binding-linux-s390x-gnu": ["@oxlint/binding-linux-s390x-gnu@1.62.0", "", { "os": "linux", "cpu": "s390x" }, "sha512-Ew2Kxs9EQ9/mbAIJ2hvocMC0wsOu6YKzStI2eFBDt+Td5O8seVC/oxgRIHqCcl5sf5ratA1nozQBAuv7tphkHg=="],
+
+    "@oxlint/binding-linux-x64-gnu": ["@oxlint/binding-linux-x64-gnu@1.62.0", "", { "os": "linux", "cpu": "x64" }, "sha512-5z25jcAA0gfKyVwz71A0VXgaPlocPoTAxhlv/hgoK6tlCrfoNuw7haWbDHvGMfjXhdic4EqVXGRv5XsTqFnbRQ=="],
+
+    "@oxlint/binding-linux-x64-musl": ["@oxlint/binding-linux-x64-musl@1.62.0", "", { "os": "linux", "cpu": "x64" }, "sha512-IWpHmMB6ZDllPvqWDkG6AmXrN7JF5e/c4g/0PuURsmlK+vHoYZPB70rr4u1bn3I4LsKCSpqqfveyx6UCOC8wdg=="],
+
+    "@oxlint/binding-openharmony-arm64": ["@oxlint/binding-openharmony-arm64@1.62.0", "", { "os": "none", "cpu": "arm64" }, "sha512-fjlSxxrD5pA594vkyikCS9MnPRjQawW6/BLgyTYkO+73wwPlYjkcZ7LSd974l0Q2zkHQmu4DPvJFLYA7o8xrxQ=="],
+
+    "@oxlint/binding-win32-arm64-msvc": ["@oxlint/binding-win32-arm64-msvc@1.62.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-EiFXr8loNS0Ul3Gu80+9nr1T8jRmnKocqmHHg16tj5ZqTgUXyb97l2rrspVHdDluyFn9JfR4PoJFdNzw4paHww=="],
+
+    "@oxlint/binding-win32-ia32-msvc": ["@oxlint/binding-win32-ia32-msvc@1.62.0", "", { "os": "win32", "cpu": "ia32" }, "sha512-IgOFvL73li1bFgab+hThXYA0N2Xms2kV2MvZN95cebV+fmrZ9AVui1JSxfeeqRLo3CpPxKZlzhyq4G0cnaAvIw=="],
+
+    "@oxlint/binding-win32-x64-msvc": ["@oxlint/binding-win32-x64-msvc@1.62.0", "", { "os": "win32", "cpu": "x64" }, "sha512-6hMpyDWQ2zGA1OXFKBrdYMUveUCO8UJhkO6JdwZPd78xIdHZNhjx+pib+4fC2Cljuhjyl0QwA2F3df/bs4Bp6A=="],
+
     "@swc/helpers": ["@swc/helpers@0.5.15", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g=="],
 
     "@tailwindcss/node": ["@tailwindcss/node@4.2.0", "", { "dependencies": { "@jridgewell/remapping": "^2.3.5", "enhanced-resolve": "^5.19.0", "jiti": "^2.6.1", "lightningcss": "1.31.1", "magic-string": "^0.30.21", "source-map-js": "^1.2.1", "tailwindcss": "4.2.0" } }, "sha512-Yv+fn/o2OmL5fh/Ir62VXItdShnUxfpkMA4Y7jdeC8O81WPB8Kf6TT6GSHvnqgSwDzlB5iT7kDpeXxLsUS0T6Q=="],
@@ -208,6 +267,10 @@
 
     "next": ["next@16.1.6", "", { "dependencies": { "@next/env": "16.1.6", "@swc/helpers": "0.5.15", "baseline-browser-mapping": "^2.8.3", "caniuse-lite": "^1.0.30001579", "postcss": "8.4.31", "styled-jsx": "5.1.6" }, "optionalDependencies": { "@next/swc-darwin-arm64": "16.1.6", "@next/swc-darwin-x64": "16.1.6", "@next/swc-linux-arm64-gnu": "16.1.6", "@next/swc-linux-arm64-musl": "16.1.6", "@next/swc-linux-x64-gnu": "16.1.6", "@next/swc-linux-x64-musl": "16.1.6", "@next/swc-win32-arm64-msvc": "16.1.6", "@next/swc-win32-x64-msvc": "16.1.6", "sharp": "^0.34.4" }, "peerDependencies": { "@opentelemetry/api": "^1.1.0", "@playwright/test": "^1.51.1", "babel-plugin-react-compiler": "*", "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "sass": "^1.3.0" }, "optionalPeers": ["@opentelemetry/api", "@playwright/test", "babel-plugin-react-compiler", "sass"], "bin": { "next": "dist/bin/next" } }, "sha512-hkyRkcu5x/41KoqnROkfTm2pZVbKxvbZRuNvKXLRXxs3VfyO0WhY50TQS40EuKO9SW3rBj/sF3WbVwDACeMZyw=="],
 
+    "oxfmt": ["oxfmt@0.47.0", "", { "dependencies": { "tinypool": "2.1.0" }, "optionalDependencies": { "@oxfmt/binding-android-arm-eabi": "0.47.0", "@oxfmt/binding-android-arm64": "0.47.0", "@oxfmt/binding-darwin-arm64": "0.47.0", "@oxfmt/binding-darwin-x64": "0.47.0", "@oxfmt/binding-freebsd-x64": "0.47.0", "@oxfmt/binding-linux-arm-gnueabihf": "0.47.0", "@oxfmt/binding-linux-arm-musleabihf": "0.47.0", "@oxfmt/binding-linux-arm64-gnu": "0.47.0", "@oxfmt/binding-linux-arm64-musl": "0.47.0", "@oxfmt/binding-linux-ppc64-gnu": "0.47.0", "@oxfmt/binding-linux-riscv64-gnu": "0.47.0", "@oxfmt/binding-linux-riscv64-musl": "0.47.0", "@oxfmt/binding-linux-s390x-gnu": "0.47.0", "@oxfmt/binding-linux-x64-gnu": "0.47.0", "@oxfmt/binding-linux-x64-musl": "0.47.0", "@oxfmt/binding-openharmony-arm64": "0.47.0", "@oxfmt/binding-win32-arm64-msvc": "0.47.0", "@oxfmt/binding-win32-ia32-msvc": "0.47.0", "@oxfmt/binding-win32-x64-msvc": "0.47.0" }, "bin": { "oxfmt": "bin/oxfmt" } }, "sha512-OFbkbzxKCpooQEnRmpTDnuwTX8KHXzZTQ4Df/hz85fpS67Pl+lxPEFvUtin56HIIS0B1k4X8oIzTXRZPufA2CA=="],
+
+    "oxlint": ["oxlint@1.62.0", "", { "optionalDependencies": { "@oxlint/binding-android-arm-eabi": "1.62.0", "@oxlint/binding-android-arm64": "1.62.0", "@oxlint/binding-darwin-arm64": "1.62.0", "@oxlint/binding-darwin-x64": "1.62.0", "@oxlint/binding-freebsd-x64": "1.62.0", "@oxlint/binding-linux-arm-gnueabihf": "1.62.0", "@oxlint/binding-linux-arm-musleabihf": "1.62.0", "@oxlint/binding-linux-arm64-gnu": "1.62.0", "@oxlint/binding-linux-arm64-musl": "1.62.0", "@oxlint/binding-linux-ppc64-gnu": "1.62.0", "@oxlint/binding-linux-riscv64-gnu": "1.62.0", "@oxlint/binding-linux-riscv64-musl": "1.62.0", "@oxlint/binding-linux-s390x-gnu": "1.62.0", "@oxlint/binding-linux-x64-gnu": "1.62.0", "@oxlint/binding-linux-x64-musl": "1.62.0", "@oxlint/binding-openharmony-arm64": "1.62.0", "@oxlint/binding-win32-arm64-msvc": "1.62.0", "@oxlint/binding-win32-ia32-msvc": "1.62.0", "@oxlint/binding-win32-x64-msvc": "1.62.0" }, "peerDependencies": { "oxlint-tsgolint": ">=0.18.0" }, "optionalPeers": ["oxlint-tsgolint"], "bin": { "oxlint": "bin/oxlint" } }, "sha512-1uFkg6HakjsGIpW9wNdeW4/2LOHW9MEkoWjZUTUfQtIHyLIZPYt00w3Sg+H3lH+206FgBPHBbW5dVE5l2ExECQ=="],
+
     "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
 
     "postcss": ["postcss@8.5.6", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg=="],
@@ -230,6 +293,8 @@
 
     "tapable": ["tapable@2.3.0", "", {}, "sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg=="],
 
+    "tinypool": ["tinypool@2.1.0", "", {}, "sha512-Pugqs6M0m7Lv1I7FtxN4aoyToKg1C4tu+/381vH35y8oENM/Ai7f7C4StcoK4/+BSw9ebcS8jRiVrORFKCALLw=="],
+
     "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
 
     "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
diff --git a/next.config.ts b/next.config.ts
index e9ffa30..fb626ac 100644
--- a/next.config.ts
+++ b/next.config.ts
@@ -1,7 +1,9 @@
 import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
-  /* config options here */
+  outputFileTracingIncludes: {
+    "/*": ["./ORCA_REFERENCE.md"],
+  },
 };
 
 export default nextConfig;
diff --git a/package.json b/package.json
index 970aaf9..d8f283d 100644
--- a/package.json
+++ b/package.json
@@ -6,8 +6,9 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
-    "lint": "biome check",
-    "format": "biome format --write"
+    "lint": "oxlint .",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check ."
   },
   "dependencies": {
     "next": "16.1.6",
@@ -15,11 +16,12 @@
     "react-dom": "19.2.3"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.0",
     "@tailwindcss/postcss": "^4",
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
+    "oxfmt": "0.47.0",
+    "oxlint": "1.62.0",
     "tailwindcss": "^4",
     "typescript": "^5"
   },
diff --git a/tsconfig.json b/tsconfig.json
index 3a13f90..cc9ed39 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -22,13 +22,6 @@
       "@/*": ["./*"]
     }
   },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    ".next/types/**/*.ts",
-    ".next/dev/types/**/*.ts",
-    "**/*.mts"
-  ],
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts", "**/*.mts"],
   "exclude": ["node_modules"]
 }