throughline 0.14.2 → 0.15.0

package/.claude/commands/sc-detail.md

@@ -1,6 +1,6 @@
 ---
 description: Throughline の退避済みターン（L2 本文 + L3 ツール入出力）を時刻で復元する
-argument-hint: <HH:MM:SS> または <HH:MM:SS>-<HH:MM:SS>
+argument-hint: <HH:MM:SS>、<HH:MM:SS>-<HH:MM:SS>、または <YYYY-MM-DD>T<HH:MM:SS>
 ---
 
 以下の Bash コマンドを実行し、結果を全文そのまま表示してください（要約せず、一字一句）。
@@ -13,6 +13,9 @@ throughline detail "$ARGUMENTS"
 
 - `/sc-detail 14:23:05` — 指定時刻のターンを復元
 - `/sc-detail 14:23-14:30` — 時刻範囲のターンをまとめて復元
+- `/sc-detail 2026-10-04T14:23:05` — 日付を指定してターンを復元
+
+日付を省くと、今日から遡って、その時刻のターンがある最も新しい日を対象にします。
 
 ## 何が返るか
 

package/CHANGELOG.md

@@ -10,6 +10,50 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.15.0] — 2026-10-05
+
+### 追加
+
+- `handoff-context --project <path> --json` に `--sessions recent` を足す（[ADR 0034](docs/adr/0034-project-recent-sessions-context.md)）。同じprojectの直近の複数sessionから、同じ9,500字の予算で文脈を作る。sessionを合流させず、起動のたびに新しいsessionができるlauncher（BellTeam）向け。これまでは会話本文を持つ最新の1 sessionだけを返していたので、長い作業の後に1ターンの短い会話を挟むと、作業の内容が文脈に入らなかった。
+  - 最新のsessionは、既定と同じ文（ヘッダ・現在地・案内・L2）で先頭に置く。この部分は1字も変わらない。JSONの`sessionId`もこのsessionのまま。
+  - 過去の会話は、その後ろの余った予算にだけ入れる。最新のsessionのターンが全部入っている時だけ、それより前のsessionを新しい順にターン単位で足す。入らないターンが出たらそこで止める。新しいターンを飛ばして古いターンは載せない。
+  - 過去の会話は別の節にまとめ、会話ごとに日時・ターン数・session idを見出しに出す。「直前の会話」「短い返事はGO」の案内は付けず、次のユーザー入力をその会話への返事として扱わないよう書く。
+  - 本文を載せなかったsessionは5件まで、`throughline recall --l2 --session <id> --before <ISO> --last <N>`を付けた一覧にする。余りが足りない時は付けない。
+  - 同じ`(origin_session_id, turn_number)`は1回だけ載せる。別のprojectのsessionは入れない。
+  - JSONに`sessions`（`sessionId`・`role`・`firstTurnAt`・`lastTurnAt`・`turns`・`includedTurns`）を足す。schemaは`throughline.handoff_context.v1`のまま。
+- 引数を付けない時（`--sessions latest`と同じ）の出力は変わらない。`--session`の意味も変わらない。`--sessions`を`--session`と一緒に付けると、使い方の誤りとして終了コード2を返す。sessionが1つのprojectでは、`--sessions recent`の`context`は既定と同じになる。
+- `throughline detail` が `<YYYY-MM-DD>T<HH:MM:SS>` を受け取る。範囲は `<YYYY-MM-DD>T<HH:MM:SS>-<HH:MM:SS>`。
+
+### 修正
+
+- `throughline detail <HH:MM:SS>` が、実行した日のターンしか探さなかった不具合を直す。注入文の`[HH:MM:SS]`は過去の時刻で、日付が変わった後（UTCの端末では日本時間の朝9時以降）は前日のターンを指す。その時は「該当するターンが見つかりませんでした」と返っていた。日付を省いた時は、今日から1日ずつ遡り、その時刻のターンがある最も新しい日を対象にする。今日以外の日のターンを返す時は、見出しに日付を出す。
+
+### 互換性
+
+- 0.14.3以前に`--sessions`を渡すと終了コード2になる。呼び手は、Throughlineを先に上げてから引数を付ける。
+
+### 確認した範囲
+
+- BellTeamのコンテナ（Linux）の実データ。Botの席35のうち、会話のあるsessionが1つの6席は既定と同じ文、複数ある29席も最新のsessionの部分は全部、既定と同じ文。22席で過去の会話の本文が入り、文脈の中央値は4,225字から9,110字、最大9,500字で、上限を超えた席は無い。数えたのは件数と字数だけ。
+- 同じ実データで、9/25以後のsession開始428回を、その時点より前に始まったsessionだけで再生した。「直前の会話が1ターン・その前が5ターン以上」の場面は19回（14席）。既定で作業の会話が入ったのは0回、`--sessions recent`では19回（入ったターンは中央値5、最少2）。
+- Claude Code 2.1.289を隔離した置き場で動かした。6ターンの作業（最後に「追記してよければ『はい』と言ってください」と申し出て終わる）と、その後の1ターンの会話（別の申し出で終わる）を用意し、文脈を起動時の指示へ入れた。「はい」だけの入力は、Haiku 3回・Sonnet 1回とも最新の会話の申し出として扱われ、過去の会話の申し出は実行されなかった。過去の会話で決めた事柄を尋ねると、`--sessions recent`の文脈では道具を使わずに答え、既定の文脈では答えられなかった。過去の作業をあらためて頼んだ時は実行した。Codex・Grok・Cursorでは確かめていない。
+- macOS 27.0（arm64）とWindows 11（10.0.26200）の実DBをread-onlyで読み、上限内・`sessionId`の一致・最新のsessionの部分が既定と同じ文であることを確かめた。試験はLinuxとmacOSで全件、Windowsで関係する7ファイル。
+- `detail`は、UTCのコンテナで前日のターンの時刻を引き、0.14.3が「見つかりませんでした」と返す場面で、そのターンを返すことを確かめた。
+
+## [0.14.3] — 2026-10-05
+
+### 修正
+
+- Windowsで、同じhookが2本同時に走った時に、片方が`Windows owner-only ACL verification failed`で失敗することがあった不具合を直す。Cursorは同じStop hookを2本ほぼ同時に起動する。新しいフォルダでの最初の応答では、1本目が受領記録のlockファイルを作り、その後で所有者だけの権限（ACL）を付けていた。権限を付け終わるまでの約1秒、lockファイルはフォルダから継承した権限のまま見える。2本目がその間に権限を検証して落ち、`HOOK_PROCESS_TURN_FAILED`に数えられていた。会話の保存は同じStopで済んでいて、失われていない。
+- lockファイルは、別名で作って権限を付け、検証してから、hard linkで最終の場所へ出す。最終の場所に現れた時点で、所有者だけの権限が付いている。先に出した側が勝ち、後から来た側は既にあるlockを検証して使う。
+- 実行時エラーの記録（`runtime-errors`）のlockファイルも同じ作りだったので、同じ形に直す。
+- macOSとLinuxの動作は変わらない（作る時点で`0600`を指定しているので、この隙間は無い）。既にあるlockファイルの検証は変えていない。
+
+### 確認した範囲
+
+- Windows 11（10.0.26200）の実機。0.14.2では、lockファイルが作られて権限がまだ付いていない状態で2本目を走らせると、Cursorの実際の失敗と同じ文面・同じ呼び出し位置で落ちる。0.14.3は、同じ場面（1本目が別名を作った直後）で2本とも成功し、lockファイルと受領記録の権限は所有者だけになる。
+- 同じ実機で、新しい置き場に2本・4本を同時に起動する確認を、受領記録で51回、実行時エラーの記録で15回行い、失敗0。0.14.2は同じ確認18回のうち1回で失敗した。
+
 ## [0.14.2] — 2026-10-05
 
 ### 修正
@@ -1710,7 +1754,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.14.2...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.15.0...HEAD
+[0.15.0]: https://github.com/kitepon/Throughline/compare/v0.14.3...v0.15.0
+[0.14.3]: https://github.com/kitepon/Throughline/compare/v0.14.2...v0.14.3
 [0.14.2]: https://github.com/kitepon/Throughline/compare/v0.14.1...v0.14.2
 [0.14.1]: https://github.com/kitepon/Throughline/compare/v0.14.0...v0.14.1
 [0.14.0]: https://github.com/kitepon/Throughline/compare/v0.13.0...v0.14.0

package/README.ja.md

@@ -444,7 +444,7 @@ v0.10.4以前には `self-update` が存在しない。該当版からの初回
 `throughline self-update` を実行する。以後の更新は `throughline self-update` だけで完結する。
 | `throughline monitor` | マルチセッション監視を起動 |
 | `throughline monitor --diag` | TTY/columns/env 診断ダンプ (描画バグ切り分け用) |
-| `throughline detail <時刻>` | あるターンの L2 本文と L3 ツール I/O を取得 (Claude が使う) |
+| `throughline detail [<日付>T]<時刻>` | あるターンの L2 本文と L3 ツール I/O を取得 (Claude が使う)。日付を省くと、今日から遡って、その時刻のターンがある最も新しい日を対象にする |
 | `throughline recall --l2\|--l1 --session <id> --before <ISO> ...` | 注入の案内セクションが指す古い記憶を pull (read-only、正確なコマンドは注入に焼き込み済み) |
 | `throughline doctor` | Node バージョン、hook 登録状況、DB、PATH をチェック |
 | `throughline doctor --trim --host claude` | trim boundary と手動手順を診断 |
@@ -457,7 +457,7 @@ v0.10.4以前には `self-update` が存在しない。該当版からの初回
 | `throughline runtime-errors report --json` | 未受領のaggregateを今1回送る。`sent`と`nothing_pending`だけexit 0 |
 | `throughline runtime-errors report-status --json` | 最後に試した時刻と結果の固定codeを読む。宛先・credential・pathは出さない |
 | `throughline handoff-preview --session <id>` | Codex 向け `throughline_handoff` JSON projection を表示 |
-| `throughline handoff-context (--session <id> \| --project <path>) --json` | SessionStartと同じ引き継ぎ文脈を取得。project指定時は会話本文を持つ最新sessionを選び、`--disclosure silent`に対応し、本文がなければ`empty`を返す。session指定時はproject束縛済み補足を同じ9,500字枠へ合成できる |
+| `throughline handoff-context (--session <id> \| --project <path>) --json` | SessionStartと同じ引き継ぎ文脈を取得。project指定時は会話本文を持つ最新sessionを選び、`--disclosure silent`に対応し、本文がなければ`empty`を返す。`--sessions recent`を付けると、同じprojectの直近の複数sessionから同じ9,500字枠で文脈を作る。session指定時はproject束縛済み補足を同じ9,500字枠へ合成できる |
 | `throughline latest-session --project <absolute-path> --json` | 指定した1プロジェクトだけを対象に直近セッションIDを読み取る。既存DBをread-onlyで開き、記録がなければ`empty`を返す |
 | `throughline grok-continue --session <id>` | handoff-context を初手 user 文にした対話 Grok 席を立てる。cwd は源の `project_path`。ready でなければ spawn しない。`--rules` なし。macOS Terminal のみ |
 | `throughline trim --dry-run --host codex` | Codex same-thread trim の dry-run preview |
@@ -511,12 +511,28 @@ macOS/Linuxでは、本人所有でgroup/otherに権限が無く、symlinkでな
 ```bash
 throughline handoff-context --session codex:<thread-id> --json
 throughline handoff-context --project /absolute/bot/project --json --disclosure silent
+throughline handoff-context --project /absolute/bot/project --json --disclosure silent --sessions recent
 ```
 
 `throughline.handoff_context.v1`は`schema`、`status`、`sessionId`、`context`だけを返す。
 `--project`ではそのproject内で会話本文を持つ最新sessionを選び、存在しなければ`empty`を返す。
 `--disclosure silent`は長期記憶を追加せずThroughlineの案内を消す。`context`はSessionStartと
-同じ予算付き継承文脈である。`--session`で使える任意の`--supplement-file <path>`には
+同じ予算付き継承文脈である。
+
+`--project`は既定で1つのsessionを読む（`--sessions latest`）。launcherがsessionを合流させず、
+起動のたびに新しいsessionができる場合は`--sessions recent`を付ける
+（[ADR 0034](docs/adr/0034-project-recent-sessions-context.md)）。最新のsessionは今までと同じ形で
+先頭に置き、`sessionId`もそのsessionを指す。そのターンが全部入って予算が余った時だけ、同じprojectの
+それより前のsessionを新しい順に、ターン単位で足す。過去の会話は別の節にまとめ、会話ごとに日時・
+ターン数・session idを見出しに出し、次のユーザー入力をその会話への返事として扱わないよう案内する。
+入らなかったsessionは5件まで、`throughline recall --l2 --session <id> --before <ISO> --last <N>`を
+付けた一覧にする。全体は同じ9,500字枠に収める。この時だけJSONに`sessions`が加わり、文脈に載せた
+sessionごとに`sessionId`、`role`（`current` / `past`）、`firstTurnAt`、`lastTurnAt`、`turns`、
+`includedTurns`（一覧にだけ載せたsessionは0）を返す。`context`は、既定の`context`そのままか、その後ろに
+過去の会話の節を足したものになり、最新のsessionの部分が減ることは無い。sessionが1つのprojectでは、
+`--sessions recent`の有無で`context`は変わらない。`--sessions`は`--session`と一緒には使えない。
+
+`--session`で使える任意の`--supplement-file <path>`には
 `throughline.handoff_supplement.v1`、源sessionと同じ`projectPath`、`title`と`content`からなる
 `sections`を指定する。任意の`handoffDisclosure`は`visible`（既定）または`silent`を受け取る。
 補足は会話記憶と同じ9,500字枠へ入り、別projectの補足は拒否する。

package/README.md

@@ -895,7 +895,7 @@ once with `npm install --global throughline@latest`, then run
 `throughline self-update`. Later updates use `throughline self-update` alone.
 | `throughline monitor [--all] [--session <id>]` | Run the multi-session token monitor                          |
 | `throughline monitor --diag`                   | Dump TTY/columns/env diagnostics (for debugging monitor render bugs) |
-| `throughline detail <time>`                    | Retrieve L2 body text and L3 tool I/O for a turn (see below) |
+| `throughline detail [<date>T]<time>`           | Retrieve L2 body text and L3 tool I/O for a turn (see below) |
 | `throughline recall --l2\|--l1 --session <id> --before <ISO> ...` | Pull older memory referenced by the injection's guidance section (read-only; the exact command is baked into each injection) |
 | `throughline caveat-context --session <id> --project <root> --json` | Return three completed dialogue turns and available Thinking for Caveat, without tool logs; `--host claude\|codex --transcript <path>` checks freshness |
 | `throughline room-context --json`              | Record a room turn from JSON stdin and return the latest three turns through that message as `throughline.room_context.v1` |
@@ -999,6 +999,7 @@ performing a normal handoff:
 ```bash
 throughline handoff-context --session codex:<thread-id> --json
 throughline handoff-context --project /absolute/bot/project --json --disclosure silent
+throughline handoff-context --project /absolute/bot/project --json --disclosure silent --sessions recent
 ```
 
 The `throughline.handoff_context.v1` object contains only `schema`, `status`,
@@ -1006,7 +1007,42 @@ The `throughline.handoff_context.v1` object contains only `schema`, `status`,
 session in that project that has dialogue context; it returns `status: "empty"`
 when none exists. `--disclosure silent` removes the Throughline announcement
 without adding long-term memory. The context uses the same budget as
-SessionStart. With `--session`, a launcher may append
+SessionStart.
+
+`--project` reads one session by default (`--sessions latest`). Add
+`--sessions recent` when the launcher does not merge sessions and each start
+creates a new one ([ADR 0034](docs/adr/0034-project-recent-sessions-context.md)).
+The newest session is still rendered first, exactly as before, and `sessionId`
+still names it. When all of its turns fit and budget remains, earlier sessions
+of the same project are appended newest first, whole turns only, under a
+separate "past conversations" section that carries each session's time range,
+turn count and session id, and that tells the model not to treat the next user
+message as a reply to them. Sessions that do not fit are listed (up to five)
+with a ready-to-run `throughline recall --l2 --session <id> --before <ISO>
+--last <N>` command. The total stays within the same 9,500-character budget.
+The JSON object then also carries `sessions`, one entry per session mentioned
+in the context:
+
+```json
+{
+  "sessionId": "0d5f…",
+  "role": "past",
+  "firstTurnAt": "2026-10-04T10:48:31.870Z",
+  "lastTurnAt": "2026-10-04T16:52:33.267Z",
+  "turns": 30,
+  "includedTurns": 1
+}
+```
+
+`role` is `current` for the newest session and `past` otherwise;
+`includedTurns` is `0` for a session that is only listed. The `context` is
+either the default `context` unchanged, or the default `context` followed by
+the past-conversations section; the newest session's part never shrinks. A
+project with a single session returns the same `context` with or without
+`--sessions recent`.
+`--sessions` cannot be combined with `--session`.
+
+With `--session`, a launcher may append
 `--supplement-file <path>` with a `throughline.handoff_supplement.v1` JSON object:
 
 ```json
@@ -1131,10 +1167,16 @@ footer explicitly instructs Claude to run this via its Bash tool when a past
 turn's tool I/O becomes relevant.
 
 ```bash
-throughline detail 14:23:05          # single timestamp
-throughline detail 14:23-14:30       # timestamp range
+throughline detail 14:23:05                  # single timestamp
+throughline detail 14:23-14:30               # timestamp range
+throughline detail 2026-10-04T14:23:05       # a turn on a specific day
 ```
 
+Without a date, Throughline looks at today first and then walks back one day
+at a time to the most recent day that has a turn at that time, because the
+`[HH:MM:SS]` stamps in an injected context may refer to a previous day. The
+header names the day when it is not today.
+
 Output groups records by `kind`: L2 conversation bodies, then L3 tool input/
 output, then system messages (hook output), then images. Records are scoped to
 the current project's merge chain so Claude only sees turns from its own

package/bin/throughline.mjs

@@ -10,7 +10,7 @@
  *   throughline session-start # SessionStart hook (Claude Code から呼ばれる)
  *   throughline pre-compact   # PreCompact hook (Claude Code から呼ばれる。自動継続: 自動圧縮を止める)
  *   throughline pre-tool-use  # PreToolUse hook (Claude Code から呼ばれる。自動継続: 旧い会話を止める)
- *   throughline detail <時刻> # L2+L3 詳細取得 (Claude が Bash 経由で呼ぶ想定)
+ *   throughline detail [<日付>T]<時刻> # L2+L3 詳細取得 (Claude が Bash 経由で呼ぶ想定)
  *   throughline recall --l2|--l1 # 注入案内から辿る pull 用 read-only 記憶取得
  *   throughline handoff-preview # Codex-facing throughline_handoff JSON preview
  *   throughline handoff-context (--session <id> | --project <path>) --json # Read-only inheritance context JSON
@@ -263,14 +263,17 @@ Usage:
   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)
+  throughline detail <time>     Retrieve L2+L3 detail for a turn (e.g. 14:23:05, 14:23-14:30,
+                                or 2026-10-04T14:23:05 for a turn on another day)
   throughline handoff-preview   Print Codex-facing throughline_handoff JSON
   throughline handoff-context (--session <id> | --project <path>) --json
                               Print the exact inheritance context without
                               changing database ownership. Project mode selects
                               the newest session with dialogue and may use
-                              --disclosure silent. Session mode may use a
-                              project-bound --supplement-file
+                              --disclosure silent. Project mode with
+                              --sessions recent also appends earlier sessions
+                              of that project within the same budget. Session
+                              mode may use a project-bound --supplement-file
   throughline latest-session --project <absolute-path> --json
                               Read the latest session id for exactly one project
   throughline grok-continue --session <id>

package/docs/adr/0034-project-recent-sessions-context.md

@@ -0,0 +1,73 @@
+# ADR 0034: `handoff-context --project` は、引数で選んだ時だけ直近の複数の会話から文脈を作る
+
+日付: 2026-10-05
+
+## Context
+
+`handoff-context --project <path>`（0.10.14）は、その project で会話本文を持つ最新の1 session だけを返す。
+1 session に絞った理由を書いた記録は無い。通常の引き継ぎは前任の行を後継へ張り替えて1本にするので、
+最新の1 session に全部の記憶が載る。
+
+BellTeam は Bot の席を起こすたびにこの CLI を読み、返った文を起動時の指示へ入れる。張り替えはしないので、
+session は分かれたまま残る。席の session は、30分動きが無い時・夜間の再起動・反映のたびに替わる。
+2026-09-25〜10-05 の記録を件数だけ数えた結果（BellTeam のビスケット）:
+
+- 席の 422 session で `merged_into` は 0 件。
+- 起動 353 回のうち 113 回（32%）は、前の session が1ターン以下。
+- 「5ターン以上の作業 → 1ターン以下の session → 起動」が 18 回（13席）。この時、作業の内容は文脈に入らない。
+- 起動時の文脈は中央値 4,226 字で、上限 9,500 字の 44%。
+
+オーナーは、直近の複数 session から文脈を作る変更を承認した（2026-10-05、Approval Box K-8GPX8C）。
+
+## Decision
+
+1. **引数で選ぶ**: `--project <path>` に `--sessions recent` を付けた時だけ、複数の session をまたぐ。
+   省略時（`--sessions latest`）の出力は1字も変えない。`--session` と一緒に付けたら使い方の誤り（終了コード 2）。
+   `--project` の「最新の1 session」は README に書いた公開の約束で、既定の意味を変えると、Throughline を
+   上げた時に呼び手が全部一度に変わり、戻す手段が版下げだけになる。引数なら呼び手が1行で切り替えて1行で戻せる。
+2. **現在の会話**: 文脈を持つ最新の session（`--sessions latest` と同じ選び方）を、`--sessions latest` と
+   同じ文（ヘッダ・現在地・案内・L2）で先頭に置く。この部分は、過去の会話の有無で1字も変わらない。
+   公開 JSON の `sessionId` はこの session のまま。
+3. **過去の会話**: 現在の会話を置いた後の余った予算にだけ入れる。現在の会話のターンが全部入っている時だけ、
+   それより前の session を新しい順に足す。足す単位はターン。入らないターンが出たらそこで止める。
+   新しいターンを飛ばして古いターンを載せない。現在の会話に載せ残しがある時は、過去の会話の本文を足さない。
+4. **見出しと案内を分ける**: 過去の会話は「この project で記録された過去の会話」として1つの節にまとめ、
+   会話ごとに日時・ターン数・session id を見出しに出す。「直前の会話」「短い返事は GO」の案内は付けず、
+   「次のユーザー入力は、ここへの返事ではない」「載っている依頼は、あらためて頼まれた時だけ実行する」と書く。
+   行頭の時刻は `[YYYY-MM-DDTHH:MM:SS]` にする（`throughline detail` へそのまま渡せる）。
+5. **一覧**: 本文を載せなかった会話は、新しい順に5件まで、日時・ターン数と
+   `throughline recall --l2 --session <id> --before <ISO> --last <N>` を1行にして付ける。`--last` は 10 まで。
+   途中まで載せた会話は、見出しの下に残りの recall を付ける。過去の会話の本文を足す時は、それより古い
+   会話の一覧2件分を残す。余りが足りない時は、一覧も節の見出しも付けない（現在の会話は削らない）。
+6. **予算**: 全体で 9,500 字（`INJECTION_BUDGET_CHARS`）のまま。session ごとにはかけない。
+7. **重ねない・混ぜない**: 同じ `(origin_session_id, turn_number)` は、新しい会話の1回だけ載せる。
+   別の project の session は入れない。DB は read-only で開き、所有権は変えない。
+8. **公開 JSON**: schema は `throughline.handoff_context.v1` のまま。`--sessions recent` の時だけ `sessions` を足す。
+   各要素は `sessionId`・`role`（`current` / `past`）・`firstTurnAt`・`lastTurnAt`（ISO）・`turns`・`includedTurns`
+   （0 は一覧にだけ載せた会話）。
+9. **予定の実行・子の AI の session**: 区別せず、`updated_at` の新しい順に入れる。`sessions` の列には
+   起動の仕方を表すものが無く、host を替えた時の session とも見分けられない。予定の実行は席が自分で
+   動いたターンで、済ませたことを次の起動で知らないと同じことをやり直す。時間の重なりで外す方法は、
+   本物の会話を黙って落とす恐れがあるので採らない。過去の会話の見出しは「あなた自身の会話」とは書かない。
+10. **`detail` の日付**: 過去の会話は別の日のことが多い。`throughline detail` は `<YYYY-MM-DD>T<HH:MM:SS>` を
+    受け取る。日付を省いた時は、今日から1日ずつ遡り、その時刻のターンがある最も新しい日を対象にする
+    （これまでは実行した日だけを見ていたので、前日のターンは注入文に時刻が載っていても引けなかった。ADR 0016 の既知の制約）。
+
+## Consequences
+
+- `--sessions recent` の `context` は、`--sessions latest` の `context` と同じか、その後ろに過去の会話の節を
+  足したものになる。`--sessions latest` で受け取れていた文が減ることは無い。
+- 現在の会話が長く、余りが節の見出しと一覧1行（約 500 字）に足りない時は、過去の会話は何も付かない。
+  最初の案では一覧の分を先に差し引いたが、現在の会話のターンが1つ減り、全体が既定より短くなる席があった
+  （実データで 9,058 字 → 8,226 字）ので、やめた。
+- 予定の実行が頻繁な席では、1ターンの予定実行が並んで予算を使い、作業の会話は一覧にしか載らないことがある。
+  足りなければ、席の本来の会話を表す印を、起動する製品（BellTeam・Aiterm）から渡す形を別に決める。
+- 子の AI の session が最新になった時に現在の会話として扱われる点は、`--sessions latest` と同じで、変わらない。
+- 一覧は5件までで、それより古い会話の session id は文脈に載らない。project の session 一覧を返す公開 CLI は無い。
+- 古い版に `--sessions` を渡すと終了コード 2 になる。呼び手は、Throughline を先に上げてから引数を付ける。
+
+## 確認した範囲
+
+- `src/resume-context.test.mjs` の `recent:` 6件、`src/cli/handoff-context.test.mjs` の `--sessions` 4件、
+  `src/sc-detail.test.mjs` 4件。
+- 実地の確認の結果は CHANGELOG の該当版に書く。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-  "version": "0.14.2",
+  "version": "0.15.0",
   "type": "module",
   "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
   "keywords": [

package/src/cli/handoff-context.mjs

@@ -2,10 +2,11 @@ import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { isAbsolute, join, resolve } from 'node:path';
 
-import { sameProjectPath } from '../project-path.mjs';
+import { normalizeProjectPathForCompare, sameProjectPath } from '../project-path.mjs';
 import { openReadOnlyDb } from '../db.mjs';
 import {
   buildBudgetedResumeContext,
+  buildRecentSessionsContext,
   INJECTION_BUDGET_CHARS,
 } from '../resume-context.mjs';
 
@@ -25,6 +26,7 @@ export function parseArgs(argv = []) {
 
   let supplementFile = null;
   let handoffDisclosure = 'visible';
+  let projectSessions = 'latest';
   const seen = new Set();
   for (let index = 3; index < argv.length; index += 2) {
     const option = argv[index];
@@ -41,12 +43,15 @@ export function parseArgs(argv = []) {
       supplementFile = value;
     } else if (option === '--disclosure' && ['visible', 'silent'].includes(value)) {
       handoffDisclosure = value;
+    } else if (option === '--sessions' && ['latest', 'recent'].includes(value)) {
+      projectSessions = value;
     } else {
       throw new TypeError('usage error');
     }
   }
   if (
     (argv[0] === '--project' && supplementFile) ||
+    (argv[0] === '--session' && seen.has('--sessions')) ||
     (supplementFile && seen.has('--disclosure'))
   ) {
     throw new TypeError('usage error');
@@ -57,6 +62,7 @@ export function parseArgs(argv = []) {
     projectPath: argv[0] === '--project' ? resolve(argv[1]) : null,
     supplementFile,
     handoffDisclosure,
+    projectSessions,
   };
 }
 
@@ -155,6 +161,43 @@ export function readLatestProjectHandoffContext(projectPath, {
   }
 }
 
+/**
+ * 同じ project の直近の会話をまたいだ文脈 (`--project <path> --sessions recent`、ADR 0034)。
+ * 現在の会話は readLatestProjectHandoffContext と同じ session を選ぶ。
+ */
+export function readRecentProjectHandoffContext(projectPath, {
+  dbPath = join(homedir(), '.throughline', 'throughline.db'),
+  handoffDisclosure = 'visible',
+} = {}) {
+  if (!existsSync(dbPath)) return null;
+
+  const db = openReadOnlyDb(dbPath);
+  try {
+    const target = normalizeProjectPathForCompare(projectPath);
+    const sameProject = new Map();
+    const sessionIds = [];
+    const sessions = db.prepare(
+      `SELECT session_id, project_path
+       FROM sessions
+       ORDER BY updated_at DESC`,
+    ).all();
+    for (const session of sessions) {
+      let same = sameProject.get(session.project_path);
+      if (same === undefined) {
+        same = normalizeProjectPathForCompare(session.project_path) === target;
+        sameProject.set(session.project_path, same);
+      }
+      if (same) sessionIds.push(session.session_id);
+    }
+    const result = buildRecentSessionsContext(db, { sessionIds, handoffDisclosure });
+    return result
+      ? { sessionId: result.sessionId, context: result.text, sessions: result.sessions }
+      : null;
+  } finally {
+    db.close();
+  }
+}
+
 export function readSessionProjectPath(sessionId, {
   dbPath = join(homedir(), '.throughline', 'throughline.db'),
 } = {}) {
@@ -179,28 +222,34 @@ export function run(argv = [], {
   stderr = process.stderr,
   readContext = readHandoffContext,
   readProjectContext = readLatestProjectHandoffContext,
+  readRecentProjectContext = readRecentProjectHandoffContext,
 } = {}) {
   let sessionId;
   let projectPath;
   let supplementFile;
   let handoffDisclosure;
+  let projectSessions;
   try {
-    ({ sessionId, projectPath, supplementFile, handoffDisclosure } = parseArgs(argv));
+    ({ sessionId, projectPath, supplementFile, handoffDisclosure, projectSessions } = parseArgs(argv));
   } catch {
     stderr.write(
-      'Usage: throughline handoff-context (--session <id> | --project <path>) --json [--disclosure visible|silent | --supplement-file <path>]\n',
+      'Usage: throughline handoff-context (--session <id> | --project <path>) --json [--disclosure visible|silent | --supplement-file <path>] [--sessions latest|recent]\n',
     );
     return 2;
   }
 
+  // `sessions` は `--sessions recent` の時だけ足す。付けない時の出力は変えない。
+  const recent = Boolean(projectPath) && projectSessions === 'recent';
   let result;
   try {
-    result = projectPath
-      ? readProjectContext(projectPath, { handoffDisclosure })
-      : {
-          sessionId,
-          context: readContext(sessionId, { supplementFile, handoffDisclosure }),
-        };
+    if (recent) result = readRecentProjectContext(projectPath, { handoffDisclosure });
+    else if (projectPath) result = readProjectContext(projectPath, { handoffDisclosure });
+    else {
+      result = {
+        sessionId,
+        context: readContext(sessionId, { supplementFile, handoffDisclosure }),
+      };
+    }
   } catch {
     stderr.write('Throughline handoff context could not be read.\n');
     return 1;
@@ -211,6 +260,7 @@ export function run(argv = [], {
       status: 'empty',
       sessionId: null,
       context: '',
+      ...(recent ? { sessions: [] } : {}),
     })}\n`);
     return 0;
   }
@@ -224,6 +274,7 @@ export function run(argv = [], {
     status: 'ready',
     sessionId: result.sessionId,
     context: result.context,
+    ...(recent ? { sessions: result.sessions } : {}),
   })}\n`);
   return 0;
 }