throughline 0.9.1 → 0.10.0

package/CHANGELOG.md

@@ -10,6 +10,34 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.0] — 2026-08-17
+
+### Added
+
+- Grok is a first-class hook host. CamelCase envelopes are normalized to
+  `grok:<sessionId>` and L2 is recovered from Grok `chat_history.jsonl`.
+  `throughline install` writes `~/.grok/hooks/throughline.json` with absolute
+  `node` + `bin/throughline.mjs` commands so Desktop GUI PATH can fire them.
+  The v0.9.1 Claude-facing no-op for non-Claude envelopes is withdrawn.
+- `throughline grok-continue --session <id>` starts a person-facing Grok seat
+  whose first user text is the handoff-context body. cwd is the source
+  session's `project_path`, not the caller's cwd. The first user text is
+  preamble + context + continue + wait. Missing context or project_path does
+  not spawn. `--rules`, aiterm, and `--from` are not used. macOS Terminal only.
+- Grok `/tl` writes the baton and then launches `grok-continue` as a side
+  effect. Claude `/tl`, Codex `/tl`, and Grok `/clear` do not launch it.
+  Empty-L2 sources (including a `merged_into` chain member with no bodies)
+  do not spawn. The list of record is the session directory under
+  `~/.grok/sessions/<encodeURIComponent(cwd)>/`. Desktop Inactive folding is
+  not a success condition.
+
+### Documentation
+
+- README, README.ja, contributor entrypoints, docs overview, ADR 0021
+  current state, and the successor-launch plan now state the live Grok
+  `/tl` → `grok-continue` contract. Historical ADRs and archived plans
+  remain point-in-time records.
+
 ## [0.9.1] — 2026-08-14
 
 ### Fixed

package/README.ja.md

@@ -38,6 +38,41 @@ throughline install     # hook / Codex skill / VS Code monitor task を登録
 `/clear` を打てば新セッションはゼロからではなく、**思考の途中から再開** される。
 `/clear` を経由しない新規 chat / VS Code 再起動では `/tl` で前任を指名できる。
 
+Grok Desktop も first-class host である。`throughline install` は
+`~/.grok/hooks/throughline.json` を書く。Grok の `/tl` は今の窓へ注入せず、
+Terminal に新席を立てる（詳細は下）。
+
+<details>
+<summary><b>Grok も併用する場合</b> Grok hooks も登録される — クリックで詳細</summary>
+
+global install は `~/.grok/hooks/throughline.json` に絶対 `node` +
+installed `bin/throughline.mjs` の SessionStart / UserPromptSubmit / Stop を書く。
+bare `throughline` は書かない（Grok Desktop の GUI PATH では見えない）。
+
+ターンは `grok:<sessionId>` として保存し、L2 は
+`~/.grok/sessions/<encodeURIComponent(cwd)>/<id>/chat_history.jsonl` から回収する。
+Grok は UserPromptSubmit stdout や書き換えた `chat_history.jsonl` をライブ
+モデル文脈へ入れない。
+
+L2 がある Grok 席で `/tl` を打つと、バトンを書いたあと次を副作用起動する:
+
+```bash
+throughline grok-continue --session grok:<id>
+```
+
+cwd は源セッションの `project_path` であり、呼び出し元 cwd は使わない。
+初手 user 文は前文 + handoff-context 本文 + 続き + 待機。context /
+`project_path` が無ければ spawn しない。Claude / Codex の `/tl` と Grok の
+`/clear` では起動しない。aiterm / `--rules` / `--from` は使わない。
+macOS Terminal のみ。
+
+新席は `~/.grok/sessions/<encodeURIComponent(cwd)>/` のトップレベル
+ディレクトリ。Desktop の Inactive 畳みは成功条件にしない。L2 が無い源
+（`merged_into` チェーンの空席など）では起動しない。新しい chat で 1〜2
+往復してから `/tl` する。
+
+</details>
+
 <details>
 <summary><b>Codex も併用する場合</b> Codex hooks も登録される — クリックで詳細</summary>
 
@@ -324,7 +359,7 @@ Throughline state をまだ書いていない現在セッションも表示で
 
 | コマンド | 役割 |
 | --- | --- |
-| `throughline install` | hook / Codex UserPromptSubmit・PostToolUse・Stop hook / Codex skill を登録し、VS Code 配下なら現プロジェクトの monitor task も配置 |
+| `throughline install` | hook / Codex UserPromptSubmit・PostToolUse・Stop hook / Codex skill / `~/.grok/hooks/throughline.json` を登録し、VS Code 配下なら現プロジェクトの monitor task も配置 |
 | `throughline install --project` | 現リポジトリの `.claude/settings.json` だけに hook を登録 |
 | `throughline uninstall` | hook を削除 |
 | `throughline monitor` | マルチセッション監視を起動 |
@@ -335,6 +370,7 @@ Throughline state をまだ書いていない現在セッションも表示で
 | `throughline doctor --trim --host claude` | trim boundary と手動手順を診断 |
 | `throughline handoff-preview --session <id>` | Codex 向け `throughline_handoff` JSON projection を表示 |
 | `throughline handoff-context --session <id> --json` | SessionStart と同じ引き継ぎ文脈を versioned JSON で取得。記憶行の `session_id` と `sessions.merged_into` は変更せず、同一端末内の別ベンダーランチャーから使える |
+| `throughline grok-continue --session <id>` | handoff-context を初手 user 文にした対話 Grok 席を立てる。cwd は源の `project_path`。ready でなければ spawn しない。`--rules` なし。macOS Terminal のみ |
 | `throughline codex-sidecar-diagnostics` | この project の `codex-sidecar` diagnostics status を確認 |
 | `throughline codex-sidecar-dry-run` | App Server を呼ばずに read-only sidecar request を正規化表示 |
 | `throughline trim --dry-run --host codex` | Codex same-thread trim の dry-run preview |
@@ -360,7 +396,7 @@ latest session推測・`sessions.merged_into`変更・L1/L2/L3 rowの所属変
 
 | コマンド | 役割 |
 | --- | --- |
-| `/tl` | 引き継ぎバトンを書き込む (auto path を OFF にしているユーザー / `/clear` 経由しない引継ぎの逃げ道) |
+| `/tl` | 引き継ぎバトンを書き込む (auto path を OFF にしているユーザー / `/clear` 経由しない引継ぎの逃げ道)。Grok ではバトン成功後に `grok-continue` も起動する |
 | `/sc-detail <時刻>` | 過去ターンの L2 本文と L3 ツール I/O を取得 |
 
 > v0.4.0 から auto-handoff がデフォルト ON です。`/clear` だけで新セッションが
@@ -387,6 +423,8 @@ latest session推測・`sessions.merged_into`変更・L1/L2/L3 rowの所属変
 - [`docs/03_inheritance_on_clear_only.md`](docs/03_inheritance_on_clear_only.md) — `/tl` バトン引き継ぎ方式の設計判断記録 (schema v6–v7)
 - [`docs/08_codex_dual_support.md`](docs/08_codex_dual_support.md) — Claude 主軸を維持したまま Codex 対応を足すための architecture brief
 - [`docs/09_rollback_context_trim_insight.md`](docs/09_rollback_context_trim_insight.md) — rollback / trim 設計 insight。復元 memory を current work として読ませる制約も記録
+- [`docs/adr/0021-grok-host-capture.md`](docs/adr/0021-grok-host-capture.md) — Grok first-class host と `/tl` → `grok-continue` の現行契約
+- [`docs/plan_grok-successor-launch.md`](docs/plan_grok-successor-launch.md) — Grok 後継席の CLI・初手・非目標・実機受入
 - [`docs/07_codex_trim_implementation_plan.md`](docs/07_codex_trim_implementation_plan.md) — Claude/Codex 両対応と rollback trim の統合 TODO 計画
 - [`docs/04_public_release_plan.md`](docs/04_public_release_plan.md) — 公開配布化プラン、§ 0 フォールバック禁止ルール、バージョン別実装ステータス
 - [`docs/15_windows_ci_release_latency_plan.md`](docs/15_windows_ci_release_latency_plan.md) — Windows CI性能gateとACL契約を維持するrelease工程

package/README.md

@@ -39,6 +39,10 @@ type `/clear` — the new session resumes mid-thought instead of starting from
 zero. (For non-`/clear` boundaries such as a brand-new chat or a VSCode
 restart, type `/tl` first to mark the predecessor.)
 
+Grok Desktop is also a first-class host. `throughline install` writes
+`~/.grok/hooks/throughline.json`. On Grok, `/tl` does not inject into the
+current window — it starts a new Terminal seat. See below.
+
 <details>
 <summary><b>Also using Codex?</b> Global install registers Codex hooks too — click for details.</summary>
 
@@ -60,6 +64,40 @@ guarded `trim --execute --host codex` surface.
 
 </details>
 
+<details>
+<summary><b>Also using Grok?</b> Global install registers Grok hooks — click for details.</summary>
+
+Global install writes `~/.grok/hooks/throughline.json` with absolute `node` +
+installed `bin/throughline.mjs` for SessionStart, UserPromptSubmit, and Stop.
+Do not register a bare `throughline` command: Grok Desktop's GUI PATH will not
+see it.
+
+Turns are stored as `grok:<sessionId>`. L2 is recovered from
+`~/.grok/sessions/<encodeURIComponent(cwd)>/<id>/chat_history.jsonl`.
+Grok does not feed UserPromptSubmit stdout or a rewritten `chat_history.jsonl`
+into the live model prompt.
+
+After `/tl` on a Grok session whose `handoff-context` is `ready`, Throughline
+writes the baton and then runs:
+
+```bash
+throughline grok-continue --session grok:<id>
+```
+
+cwd is the source session's `project_path`, not the caller's cwd. The first
+user text is preamble + the handoff-context body + continue + wait. Missing
+context or project_path does not spawn. Claude `/tl`, Codex `/tl`, and Grok
+`/clear` do not launch this CLI. Do not use aiterm, `--rules`, or `--from`.
+macOS Terminal only.
+
+The new seat is a top-level directory under
+`~/.grok/sessions/<encodeURIComponent(cwd)>/`. Desktop Inactive folding is
+not the success condition. A source with no L2 (including a `merged_into`
+chain member with zero bodies) does not spawn — open a fresh chat, exchange
+one or two turns, then `/tl`.
+
+</details>
+
 ## How it compares
 
 | | **Throughline** | `/clear` (built-in) | `/compact` (built-in) | MemGPT / SummaryBufferMemory |
@@ -774,7 +812,7 @@ local-only contracts.
 
 | Command                                        | What it does                                                 |
 | ---------------------------------------------- | ------------------------------------------------------------ |
-| `throughline install`                          | Register Claude user hooks/slash commands, the global Codex UserPromptSubmit/PostToolUse/Stop hooks, the global `$throughline` Codex skill, and the current VS Code monitor task when applicable |
+| `throughline install`                          | Register Claude user hooks/slash commands, the global Codex UserPromptSubmit/PostToolUse/Stop hooks, the global `$throughline` Codex skill, `~/.grok/hooks/throughline.json`, and the current VS Code monitor task when applicable |
 | `throughline install --project`                | Register Claude hooks/slash commands in this repo only       |
 | `throughline uninstall`                        | Remove Throughline-managed Claude hooks/slash commands, only the Throughline-managed Codex hook, and the `$throughline` Codex skill |
 | `throughline monitor [--all] [--session <id>]` | Run the multi-session token monitor                          |
@@ -797,6 +835,7 @@ local-only contracts.
 | `throughline runtime-errors compact --json`    | Remove only acknowledged, resolved aggregates after retention; open or unacknowledged records remain |
 | `throughline handoff-preview --session <id>`   | Print a Codex-facing `throughline_handoff` JSON projection    |
 | `throughline handoff-context --session <id> --json` | Print the exact SessionStart inheritance context as versioned JSON without moving memory rows or changing `sessions.merged_into`; intended for local launchers that need portable cross-vendor context |
+| `throughline grok-continue --session <id>` | Spawn a person-facing Grok seat whose first user text is the handoff-context body. cwd is the source session `project_path`. Does not spawn without ready context. No `--rules`. macOS Terminal only |
 | `throughline codex-capture --codex-thread-id <id>` | Capture active Codex rollout turns into a `codex:<thread_id>` DB session |
 | `throughline codex-summarize --session codex:<id>` | Summarize captured Codex L2 into L1 with the Codex CLI backend |
 | `throughline codex-resume --session codex:<id>` | Render Codex active-work context from a captured Codex session |
@@ -840,7 +879,7 @@ Slash commands (invoked by the user in Claude Code):
 
 | Command       | What it does                                                      |
 | ------------- | ----------------------------------------------------------------- |
-| `/tl`         | Write a handoff baton (explicit inheritance signal across non-`/clear` boundaries — new chat / VSCode restart) |
+| `/tl`         | Write a handoff baton (explicit inheritance signal across non-`/clear` boundaries — new chat / VSCode restart). On Grok, also launches `grok-continue` after a successful baton write |
 | `/clear`      | Built-in Claude Code reset. Throughline's `UserPromptSubmit` hook also writes a baton so the next session inherits the cleared session's memory |
 | `/sc-detail <time>` | Retrieve L2 body text and L3 tool I/O for a past turn       |
 
@@ -854,7 +893,7 @@ Slash commands (invoked by the user in Claude Code):
 
 Hook subcommands (invoked by Claude Code, not by humans):
 `session-start` (SessionStart), `process-turn` (Stop),
-`prompt-submit` (UserPromptSubmit — detects `/tl` and `/clear` and writes a baton).
+`prompt-submit` (UserPromptSubmit — detects `/tl` and `/clear` and writes a baton; Grok `/tl` also launches `grok-continue`).
 
 ### Observer completed-turn feed (development)
 

package/bin/throughline.mjs

@@ -12,6 +12,7 @@
  *   throughline recall --l2|--l1 # 注入案内から辿る pull 用 read-only 記憶取得
  *   throughline handoff-preview # Codex-facing throughline_handoff JSON preview
  *   throughline handoff-context --session <id> --json # Read-only inheritance context JSON
+ *   throughline grok-continue --session <id> # Spawn a Grok seat whose first user text is handoff-context
  *   throughline auditor-context --json # Read-only bounded auditor context JSON
  *   throughline factory-diagnostics --json # Native factory read-only readiness JSON
  *   throughline migrate --json # Migrate the existing Throughline database only
@@ -82,6 +83,11 @@ switch (cmd) {
     if (exitCode !== 0) process.exitCode = exitCode;
     break;
   }
+  case 'grok-continue': {
+    const exitCode = (await import('../src/cli/grok-continue.mjs')).run(rest);
+    if (exitCode !== 0) process.exitCode = exitCode;
+    break;
+  }
   case 'auditor-context': {
     const exitCode = (await import('../src/cli/auditor-context.mjs')).run(rest);
     if (exitCode !== 0) process.exitCode = exitCode;
@@ -203,7 +209,7 @@ async function showHelp() {
   console.log(`throughline v${version}
 
 Usage:
-  throughline install           Register hooks in ~/.claude/settings.json
+  throughline install           Register Claude, Codex, and Grok hooks
   throughline uninstall         Remove hooks
   throughline monitor           Multi-session token monitor (use --all, --session <id>)
   throughline detail <time>     Retrieve L2+L3 detail for a turn (e.g. 14:23:05 or 14:23-14:30)
@@ -211,6 +217,11 @@ Usage:
   throughline handoff-context --session <id> --json
                               Print the exact inheritance context without
                               changing database ownership
+  throughline grok-continue --session <id>
+                              Spawn a person-facing Grok seat whose first
+                              user text is the handoff-context body. Does not
+                              spawn when context is unavailable. Does not pass
+                              --rules. macOS Terminal only
   throughline auditor-context --session <id> --project <root>
                               Read only bounded completed user/assistant context
                               for an auditor; requires either --host plus --transcript,

package/docs/00_overview.md

@@ -21,6 +21,7 @@
 | [14_observer_completed_turn_feed_plan.md](14_observer_completed_turn_feed_plan.md) | Observer向けcompleted-only read / wait CLIの完了済み設計・受入記録。v0.7.0で公開済み |
 | [15_windows_ci_release_latency_plan.md](15_windows_ci_release_latency_plan.md) | Windows CI 18分の原因、ACL安全網を維持した短縮、release gateの受入条件 |
 | [16_readonly_handoff_context_plan.md](16_readonly_handoff_context_plan.md) | DB所有権を変更せずSessionStartと同じ記憶を返す、ローカルランチャー向けread-only I/F。v0.9.0で公開済み |
+| [plan_grok-successor-launch.md](plan_grok-successor-launch.md) | Grok `/tl` 後の後継席起動。v0.10.0で公開済み。正本は本ファイルと [ADR 0021](adr/0021-grok-host-capture.md) |
 | [BUGHUB_RUNTIME_ERROR_STORE_PLAN.md](BUGHUB_RUNTIME_ERROR_STORE_PLAN.md) | local runtime error aggregate store の契約と実装 TODO |
 
 ## Supporting Records
@@ -38,6 +39,7 @@
 - [ADR 0002](adr/0002-observer-claude-completion-receipt.md): Claude completed turnはThroughline所有のStop receiptで固定する。
 - [ADR 0003](adr/0003-observer-completed-chain-cursor.md): Observer cursorをhost固有のcompleted pair chainとprefix検証へ束縛する。
 - [ADR 0020](adr/0020-windows-ci-release-latency.md): Windows ACL契約を維持し、境界fixtureと実ACL検証を分離する。
+- [ADR 0021](adr/0021-grok-host-capture.md): Grok を first-class hook host にし、`/tl` 後の記憶再開は `grok-continue` に固定する。
 
 Observerの公開境界は`throughline observer-read`／`throughline observer-wait`のJSON-only CLIである。
 ThroughlineはClaude Stop receiptとCodex rolloutの`task_complete`だけからcompleted cursorを構築し、

package/docs/02_clear_auto_handoff_plan.md

@@ -17,6 +17,12 @@ A 案 (= /clear で自動引継ぎ + /tl は逃げ道として残す + /tl-trim
 > `THROUGHLINE_DISABLE_AUTO_HANDOFF=1` は **fallback path のみに作用** する
 > ようになった (typed `/clear` / `/tl` には効かない)。
 
+> **2026-08-17 (ADR 0021 / v0.10.0)**: 本書は Claude `/clear`・`/tl` の現行仕様である。
+> Grok は UserPromptSubmit stdout をモデルへ渡さない。Grok `/tl` の記憶再開は
+> `throughline grok-continue` であり、本書の「次セッション初回プロンプトで注入」を
+> Grok に適用しない。正本は [ADR 0021](adr/0021-grok-host-capture.md) と
+> [plan_grok-successor-launch.md](plan_grok-successor-launch.md)。
+
 > **2026-07-18 (ADR 0016) update**: 注入の中身を push/pull 二段に再設計した。
 > push (9,500 字) はヘッダ + 現在地アンカー + 案内セクション + **L2 をターン原子で
 > 入るだけ全文**（L1 は注入しない）。窓 20 ターンの残りは `throughline recall --l2`、

package/docs/04_public_release_plan.md

@@ -34,10 +34,10 @@ Throughline を GitHub + npm で公開し、世界中の Claude Code ユーザ
 
 ```bash
 npm install -g throughline     # CLI を PATH に配置
-throughline install            # ~/.claude/settings.json、Codex hook、Codex skill を追記
+throughline install            # ~/.claude/settings.json、Codex hook、Codex skill、Grok hook を追記
 ```
 
-Claude hook コマンドは **`throughline <subcommand>` の PATH 解決型**。node のインストール先や OS が変わっても PATH さえ通っていれば動く。Codex Stop hook は Codex App Server / VSCode host の PATH 差分を避けるため、絶対 node + installed `bin/throughline.mjs` で登録する。Codex 手動 UX は `~/.codex/skills/throughline` の `$throughline` skill で自然言語から呼ぶ。
+Claude hook コマンドは **`throughline <subcommand>` の PATH 解決型**。node のインストール先や OS が変わっても PATH さえ通っていれば動く。Codex Stop hook と Grok hook は host の PATH 差分を避けるため、絶対 node + installed `bin/throughline.mjs` で登録する。Grok は `~/.grok/hooks/throughline.json`。Codex 手動 UX は `~/.codex/skills/throughline` の `$throughline` skill で自然言語から呼ぶ。Grok `/tl` の後継起動は `throughline grok-continue`（macOS Terminal）。
 
 ### hook 登録後の `~/.claude/settings.json`（抜粋）
 

package/docs/adr/0021-grok-host-capture.md

@@ -0,0 +1,60 @@
+# ADR 0021: Treat Grok as a first-class Throughline host
+
+Date: 2026-08-17
+
+## Status
+
+Accepted
+
+## Context
+
+Throughline v0.9.1 no-op'd Grok camelCase hook envelopes (GF04) because Grok was not a factory parent host. Wave 5 made Grok a peer parent. The 2026-08-16 factory ruling requires Throughline Grok capture / restore / handoff.
+
+Grok stores turns in `~/.grok/sessions/<encodeURIComponent(cwd)>/<sessionId>/chat_history.jsonl`, not Claude JSONL.
+
+## Decision
+
+- Detect the camelCase envelope (`sessionId` + `hookEventName`, no `session_id`) as host=grok.
+- Normalize it to the existing snake_case hook contract and prefix ids with `grok:`.
+- Read L2 from Grok `chat_history.jsonl`. Do not invent a Claude-shaped transcript.
+- Grok host ignores payload `transcriptPath`. Live Stop sends `updates.jsonl`, which has no user/assistant rows.
+- Install product hooks at `~/.grok/hooks/throughline.json`. Do not write factory.json.
+- Grok hook `command` is absolute `node` + `bin/throughline.mjs` + subcommand. Do not write bare `throughline`.
+- Keep Claude and Codex adapters unchanged. Do not mix `grok:` rows into Claude predecessor search.
+- Grok `/tl` / `/clear` / `/new` detection reads the inner `<user_query>`. If the hook `prompt` is empty, fall back to the last user row in `chat_history.jsonl`. Do not treat `source=new` as Claude `source=clear` auto-handoff.
+- Grok UserPromptSubmit stdout is observe-only. Writing into `chat_history.jsonl` does not enter the live model prompt. Live conversation is `updates.jsonl`. Claude still uses stdout additionalContext.
+
+## Consequences
+
+- GF04 no-op is withdrawn.
+- Restore/handoff for `grok:` sessions reuse existing DB + `handoff-context` after capture exists.
+- Live Grok hook fire on each seat is a separate install+new-session acceptance.
+
+## 現在地
+
+Grok 1.0.4 バイナリの hook 出力型は `GateHookJson`（PreToolUse deny/updatedInput）と `StopHookJson`（block/additionalContext/stopReason）だけ。UserPromptSubmit / SessionStart / PostToolUse の stdout は observe。モデルへ文章を渡せる公式口は (1) PreToolUse deny の reason (2) Stop/SubagentStop の block reason / additionalContext / exit2 stderr。初回トークン前の prompt 注入口は無い。Stop 注入は初回返答のあと 2 周目に載る。`01a00cfe` の chat_history 書き込みは updates に乗らず実証済み。capture と handoff-context は生きている。
+
+`/tl` 後の記憶再開は hook stdout や `chat_history.jsonl` 再注入では成立しない。後継経路は Throughline 所有の最小起動に固定する。正本は [plan_grok-successor-launch.md](../plan_grok-successor-launch.md)。
+
+- CLI: `throughline grok-continue --session <id>`。`<id>` は `grok:` 接頭辞付き Throughline session id。`--from` は採用しない。
+- 内部で `handoff-context --session <id> --json` を読む。ready でなければ spawn しない。
+- 初手 user 文は次の 4 段だけ。`{context}` は handoff-context の `context` 文字列。JSON envelope は載せない。末尾は待機。
+
+  ```
+  この発言は直前 Throughline 席の履歴を前提とする。
+
+  {context}
+
+  直前の作業の自然な続きとして応答すること。
+
+  この後ユーザーが指示を出す。何もせず待機すること。
+  ```
+
+- spawn の cwd は源セッションの `project_path`。呼び出し元 cwd は使わない。共有 `GROK_HOME` の対話 `grok`。位置引数 `[PROMPT]` を使う。`--rules` / `--system-prompt-override` / `--agent` / 単発 `-p` は使わない。aiterm は使わない。
+- Claude / Codex の `/tl` 契約は変えない。Grok `/tl` 成功後の副作用起動だけが配線対象。
+- 一覧の正は `~/.grok/sessions/<encodeURIComponent(cwd)>/<id>/`。Desktop Inactive 畳みは成功条件にしない。
+- L2 が無い源（`merged_into` チェーンの空席など）では spawn しない。新しい chat で 1〜2 往復してから `/tl` する。
+
+2026-08-17 実機受入: `grok:01a00ff1-3f97-70e2-ba76-5acd90561a84` の `/tl` が
+`c01a2689-5b4f-4977-97ce-f73fcf317f94` を Dotagents 棚に立て、初手末尾は待機、
+後継は待って止まった。v0.10.0 で公開。

package/docs/plan_grok-successor-launch.md

@@ -0,0 +1,99 @@
+# Grok successor launch — Throughline 所有の最小起動
+
+Date: 2026-08-17  
+Status: Accepted（v0.10.0）  
+Lattice plan: `grok-successor-launch`  
+対象 repo: Throughline だけ。aiterm は依存にも実装の借り先にもしない。
+
+t1-contract（2026-08-17）で起動核の CLI名・初手文面・非目標・受入を固定した。
+以降の工程は本ファイルと [ADR 0021](adr/0021-grok-host-capture.md) の現在地を正とする。
+
+2026-08-17 実機: Dotagents 棚の `grok:01a00ff1-3f97-70e2-ba76-5acd90561a84` で
+`handoff-context` が `ready` のあと `/tl`。後継
+`~/.grok/sessions/%2FUsers%2Fkite%2FDeveloper%2Fdotagents/c01a2689-5b4f-4977-97ce-f73fcf317f94/`
+が立ち、初手末尾は待機行、モデルは仕事を始めず待った。源の `merged_into` 空席
+（`01a00b38`、L2 0 件）では spawn しない。
+
+## 目的
+
+Grok Desktop の UserPromptSubmit はモデルへ本文を渡せない。`/tl` のあと人が新窓を開いても記憶は載らない。代わりに Throughline 自身が、handoff-context を**最初の user 文の前**に置いた普通の Grok 席を一本立てる。
+
+## 非目標
+
+次は成功条件にも実装手段にもしない。
+
+- aiterm / tmux / PTY 完了待ち / `role=subagent` を Throughline に持ち込む
+- `grok` 起動に `--rules` を付ける（dashboard の top-level から外れる）
+- `--system-prompt-override` / `--agent` で初手 user 文を代替する
+- Claude / Codex の `/tl` 契約を変える
+- UserPromptSubmit stdout や `chat_history.jsonl` への再注入で Desktop 新窓を直す
+- 実装キャンペーン中の Spotter 作業（npm 公開は製品完遂であり禁止ではない）
+
+## 固定契約
+
+### CLI
+
+名前と引数は次に固定する。
+
+```
+throughline grok-continue --session <id>
+```
+
+- `<id>` は Throughline の session id であり、Grok 由来なら `grok:` 接頭辞を含む。
+- 既存の `handoff-context --session` と同じ flag 名を使う。`--from` は採用しない。
+- この CLI は `handoff-context --session <id> --json` を読む。`status` が `ready` でない、終了が非 0、または context が空なら **spawn しない**。fallback 禁止。
+- JSON envelope（`schema` / `status` / `sessionId`）は初手文へ載せない。載せるのは `context` 文字列だけ。
+
+### spawn
+
+- 源セッション（`--session` の Throughline 行）の `project_path` で立てる。呼び出し元の cwd は使わない。`project_path` が無い・読めない・ディレクトリが無いときは spawn しない。
+- 共有 `GROK_HOME`（上書きしない）のまま `grok` を人の席として立てる。
+- 起動は対話セッションである。`-p` / `--prompt` / `--prompt-file` / `--prompt-json` の単発終了経路は使わない。
+- 初手は `grok` の位置引数 `[PROMPT]` に渡す。`--rules` は付けない。
+- hook から呼ぶので対話 TTY は無い。macOS では新しい Terminal 窓で grok を前面に出す。立てた session id が分かれば標準出力にも出す（`grok --resume` できるようにする）。両方できることが受入の強い形である。
+
+### 初手文面
+
+初手 user 文は次の 4 段だけとする。前後の飾り文を足さない。`{context}` は handoff-context が返した `context` 文字列そのもの。末尾の待機が無いと、要約を新しい仕事の着手と誤る。
+
+```
+この発言は直前 Throughline 席の履歴を前提とする。
+
+{context}
+
+直前の作業の自然な続きとして応答すること。
+
+この後ユーザーが指示を出す。何もせず待機すること。
+```
+
+### `/tl` 配線
+
+- Grok envelope の `/tl` 成功後に、上記 CLI を副作用で起動する。baton は今どおり書く。
+- Claude / Codex ではこの CLI を起動しない。
+
+### 一覧
+
+- 新席は `~/.grok/sessions/<encodeURIComponent(cwd)>/<id>/` にトップレベルとして残る。
+- aiterm の Inactive/subagent 隠しを再現しない。
+- Desktop roster が別プロセスを Inactive に畳むのは Grok 側の仕様。受入は session ディレクトリと `grok --resume` 一覧を正とする。
+
+## 受入
+
+### focused（t2 / t3）
+
+- `handoff-context` 失敗では `grok` を spawn しない。
+- 初手文面は上の 4 段で、2 段目に `context` 文字列がそのまま含まれ、末尾が待機である。
+- spawn argv に `--rules` が無い。
+- spawn 経路に aiterm / tmux / `role=subagent` が無い。
+- Grok 以外の `/tl` では `grok-continue` を呼ばない。
+
+### 実機（t4 / t5）
+
+- この Mac の Grok `/tl` から新席が立ち、session ディレクトリに載る。
+- `grok --resume` 一覧にトップレベルとして見える。Desktop Inactive 畳みは成功条件にしない。
+- その席の最初のモデル応答が前文の記憶を使う。宣言または L2 固有事実が出ること。
+- `chat_history.jsonl` への後書きや hook stdout を成功に数えない。
+
+## 円卓
+
+工程正本は Lattice plan `grok-successor-launch`。実装は Throughline のみ。

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "throughline",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "type": "module",
-  "description": "Claude Code hooks plugin for structured context compression (/clear-safe persistent memory)",
+  "description": "Persistent memory hooks for Claude Code, Codex, and Grok (/clear-safe context compression)",
   "keywords": [
     "claude-code",
+    "codex",
+    "grok",
     "hooks",
     "context-compression",
     "llm"

package/src/cli/grok-continue.mjs

@@ -0,0 +1,197 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import { delimiter, join } from 'node:path';
+
+import { readHandoffContext, readSessionProjectPath } from './handoff-context.mjs';
+
+export const GROK_CONTINUE_PREAMBLE = 'この発言は直前 Throughline 席の履歴を前提とする。';
+export const GROK_CONTINUE_REQUEST = '直前の作業の自然な続きとして応答すること。';
+export const GROK_CONTINUE_WAIT = 'この後ユーザーが指示を出す。何もせず待機すること。';
+
+export function parseArgs(argv = []) {
+  if (
+    argv.length !== 2
+    || argv[0] !== '--session'
+    || typeof argv[1] !== 'string'
+    || argv[1].length === 0
+  ) {
+    throw new TypeError('usage error');
+  }
+  return { sessionId: argv[1] };
+}
+
+export function buildGrokContinuePrompt(context) {
+  if (typeof context !== 'string' || context.length === 0) {
+    throw new TypeError('empty context');
+  }
+  return `${GROK_CONTINUE_PREAMBLE}\n\n${context}\n\n${GROK_CONTINUE_REQUEST}\n\n${GROK_CONTINUE_WAIT}`;
+}
+
+export function shQuote(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+export function resolveGrokBin({
+  home = homedir(),
+  env = process.env,
+  exists = existsSync,
+} = {}) {
+  const homeBin = join(home, '.grok', 'bin', 'grok');
+  if (exists(homeBin)) return homeBin;
+  for (const dir of String(env.PATH ?? '').split(delimiter)) {
+    if (!dir) continue;
+    const candidate = join(dir, 'grok');
+    if (exists(candidate)) return candidate;
+  }
+  return null;
+}
+
+export function buildGrokArgv(grokBin, sessionUuid, prompt) {
+  return [grokBin, '--session-id', sessionUuid, prompt];
+}
+
+export function buildLaunchScript({ cwd, grokBin, sessionUuid, promptFile }) {
+  return [
+    '#!/bin/sh',
+    'set -e',
+    `cd ${shQuote(cwd)}`,
+    `exec ${shQuote(grokBin)} --session-id ${shQuote(sessionUuid)} "$(cat ${shQuote(promptFile)})"`,
+    '',
+  ].join('\n');
+}
+
+export function appleScriptForLaunch(launchScriptPath) {
+  return [
+    'tell application "Terminal"',
+    '  activate',
+    `  do script "exec " & quoted form of ${JSON.stringify(launchScriptPath)}`,
+    'end tell',
+    '',
+  ].join('\n');
+}
+
+export function buildContinuePlan({
+  context,
+  grokBin,
+  cwd,
+  sessionUuid,
+}) {
+  const prompt = buildGrokContinuePrompt(context);
+  const grokArgv = buildGrokArgv(grokBin, sessionUuid, prompt);
+  if (grokArgv.includes('--rules')) {
+    throw new Error('grok-continue must not pass --rules');
+  }
+  return {
+    prompt,
+    grokArgv,
+    cwd,
+    sessionUuid,
+    throughlineSessionId: `grok:${sessionUuid}`,
+  };
+}
+
+export function writeLaunchArtifacts({
+  cwd,
+  grokBin,
+  sessionUuid,
+  prompt,
+  tmp = tmpdir(),
+}) {
+  const dir = join(tmp, `tl-grok-continue-${sessionUuid}`);
+  mkdirSync(dir, { recursive: true });
+  const promptFile = join(dir, 'prompt.txt');
+  const launchFile = join(dir, 'launch.sh');
+  writeFileSync(promptFile, prompt);
+  writeFileSync(launchFile, buildLaunchScript({
+    cwd,
+    grokBin,
+    sessionUuid,
+    promptFile,
+  }), { mode: 0o755 });
+  return { promptFile, launchFile };
+}
+
+export function defaultSpawnLaunch({ launchFile, spawnImpl = spawn }) {
+  const child = spawnImpl('osascript', ['-e', appleScriptForLaunch(launchFile)], {
+    detached: true,
+    stdio: 'ignore',
+  });
+  child.unref?.();
+  return child;
+}
+
+export function run(argv = [], {
+  stdout = process.stdout,
+  stderr = process.stderr,
+  readContext = readHandoffContext,
+  readProjectPath = readSessionProjectPath,
+  resolveBin = resolveGrokBin,
+  createSessionId = randomUUID,
+  platform = process.platform,
+  spawnLaunch = defaultSpawnLaunch,
+} = {}) {
+  let sessionId;
+  try {
+    ({ sessionId } = parseArgs(argv));
+  } catch {
+    stderr.write('Usage: throughline grok-continue --session <id>\n');
+    return 2;
+  }
+
+  let context;
+  try {
+    context = readContext(sessionId);
+  } catch {
+    stderr.write('Throughline handoff context could not be read.\n');
+    return 1;
+  }
+  if (!context) {
+    stderr.write('Throughline handoff context is not available for that session.\n');
+    return 1;
+  }
+
+  let cwd;
+  try {
+    cwd = readProjectPath(sessionId);
+  } catch {
+    stderr.write('Throughline session project path could not be read.\n');
+    return 1;
+  }
+  if (!cwd) {
+    stderr.write('Throughline session project path is not available for that session.\n');
+    return 1;
+  }
+  if (!existsSync(cwd)) {
+    stderr.write('Throughline session project path does not exist.\n');
+    return 1;
+  }
+
+  const grokBin = resolveBin();
+  if (!grokBin) {
+    stderr.write('grok binary was not found.\n');
+    return 1;
+  }
+  if (platform !== 'darwin') {
+    stderr.write('throughline grok-continue requires macOS Terminal.\n');
+    return 1;
+  }
+
+  const sessionUuid = createSessionId();
+  const plan = buildContinuePlan({
+    context,
+    grokBin,
+    cwd,
+    sessionUuid,
+  });
+  const { launchFile } = writeLaunchArtifacts({
+    cwd: plan.cwd,
+    grokBin,
+    sessionUuid: plan.sessionUuid,
+    prompt: plan.prompt,
+  });
+  spawnLaunch({ launchFile, grokArgv: plan.grokArgv, cwd: plan.cwd });
+  stdout.write(`${plan.throughlineSessionId}\n`);
+  return 0;
+}