throughline 0.16.3 → 0.16.5

package/CHANGELOG.md

@@ -10,6 +10,48 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.5] — 2026-10-08
+
+### 修正
+
+- Codexのhookが、道具を1回使うたびに、その会話のL3（`details`）を全部消して入れ直していたのを直す（[ADR 0042](docs/adr/0042-codex-capture-writes-only-changed-tail.md)）。DBにある行とrolloutの行を先頭から本文まで比べ、最初に食い違った行から後ろだけを書く。取り込んだ後の中身と並びは、全部入れ直した時と同じ。
+  - Windowsの端末で、L3が3,552行・約1.47億字（rolloutは288MB）の会話のhookが、1回でWALへ152.9MBを書いていた。その端末の`throughline.db-wal`は12.8GBまで伸びていた（DB本体は230MB）。本物のDBの写しで測ると、変化の無いhookは0.3MB、89行が増えたhookは12.5MBになる。
+- `getDb()`が`PRAGMA journal_size_limit`を64MBに設定する。WALが使い直された後の最初のcommitで、ファイルを64MBまで切り詰める。今までは、一度伸びたWALは中身が空になっても縮まなかった。
+
+### 変更
+
+- rolloutに時刻の無いL3の行は、最初に取り込んだ時刻のまま残る。今までは、取り込むたびにその時の時刻へ変わっていた。
+- `codex-capture --json`の結果へ、`keptDetails`・`writtenDetails`・`removedDetails`を足す。
+
+### 変わらない事
+
+- schema（v12）。`bodies`（L2）と`skeletons`（L1）の扱い。
+- Claude Code・Grok・Cursorの取り込み。
+
+### 確認していない範囲
+
+- 複数のCodexの会話が同時に動く本物の端末で、WALが伸びなくなるか。公開の後に端末で読む。
+- hookは今までどおり毎回rolloutの全体を読む。上の会話では約1.1秒かかる。Codexの画面での待ちとして見えているかは調べていない。
+
+## [0.16.4] — 2026-10-07
+
+### 変更
+
+- Codex StopのL1要約backend（Codex CLI）の失敗を、1回ごとにruntime errorとして数えるのをやめる（[ADR 0041](docs/adr/0041-l1-summarizer-backend-unrecovered.md)）。この失敗は、通信の断、利用上限、認証切れ、利用者の取り消しでも起きる。会話の取り込みは済んでいて、要約は次のStopがやり直し、recallはL2の本文を返すので、修理の対象として自動で登録しない。理由と外部CLIのstderrの末尾は、今までどおり端末の`hook-failures.log`に残る。hookの終了codeとstderrは変えない。
+- 最初の失敗から24時間を過ぎても成功を確認できない時だけ、`L1_SUMMARIZER_BACKEND_UNRECOVERED`（`warn`）で数える。要約が成功したら、その記録を`recovered`で解決にする。
+- Codexの自動継続のworkerは、要約のbackendの失敗を`handoff_summarizer_backend_failed`で止める（今までは汎用の`handoff_worker_failed`）。失敗の画面に、通信の断・利用上限・認証切れで起きる事、記録と入力が失われていない事、再開の仕方を書く。
+
+### 変わらない事
+
+- BugHubへ送る本文の形。項目は足していない。
+- hook処理の失敗（`HOOK_*_FAILED`）の数え方と重大度。これらの経路に通信は無い。
+- BugHubへの送信の失敗は、今までどおり送信の状態にだけ残し、runtime errorには数えない。
+
+### 確認していない範囲
+
+- 要約が失敗し続ける間のCodexの画面への影響。
+- 本物のCodex CLIが、通信の断・利用上限・認証切れのそれぞれで返す終了codeとstderr。
+
 ## [0.16.3] — 2026-10-07
 
 ### 修正
@@ -1940,7 +1982,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.3...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.5...HEAD
+[0.16.5]: https://github.com/kitepon/Throughline/compare/v0.16.4...v0.16.5
+[0.16.4]: https://github.com/kitepon/Throughline/compare/v0.16.3...v0.16.4
 [0.16.3]: https://github.com/kitepon/Throughline/compare/v0.16.2...v0.16.3
 [0.16.2]: https://github.com/kitepon/Throughline/compare/v0.16.1...v0.16.2
 [0.16.1]: https://github.com/kitepon/Throughline/compare/v0.16.0...v0.16.1

package/docs/adr/0041-l1-summarizer-backend-unrecovered.md

@@ -0,0 +1,77 @@
+# ADR 0041: L1 要約 backend の失敗は、復帰を確認できない時だけ数える
+
+日付: 2026-10-07
+
+## Context
+
+オーナーは、通信失敗の報告・重大度・担当の決まりを定めた（2026-10-07、BugHub の `NETWORK_REPORTING.md`）。
+通信環境そのものの不調と、その状態への製品の対処不良を分ける。通常のオフライン、正常な取り消し、
+適切に処理された一時的な失敗を、自動で製品の欠陥として登録しない。必要な診断は保持する。重大度は
+エラーコードや回数だけで固定せず、機能停止・データの喪失・重複・復帰の可否を根拠に付ける。
+
+Throughline が runtime error として数える code は7つで、通信の失敗が入るのは `L1_SUMMARIZER_BACKEND_FAILED`
+（ADR 0028）だけだった。Codex Stop の要約は外部 CLI（`codex exec`）を呼ぶ。通信の断、利用上限、認証切れ、
+model の失敗、利用者の取り消しによる停止で、CLI は非0で終わるか空を返す。0.16.3 までは、この失敗を
+1回ごとに `warn` で数え、BugHub へ未解決の記録として送っていた。
+
+この失敗への Throughline の対処は、次のとおり（ADR 0015・0016・0028）。
+
+- 会話の取り込みは、要約の前に commit している。記憶は失われない。
+- 要約は、次の Stop が同じ turn からやり直す。重複は作らない。
+- L1 が無い間、recall は L2 の本文を返す。
+- hook は終了 code 1 と stderr で失敗を示す。理由と外部 CLI の stderr の末尾は、端末の `hook-failures.log` に残る。
+
+1回ごとの失敗は「適切に処理された一時的な失敗」に当たり、修理の対象として登録する物ではない。
+一方、backend が使えないまま続く端末では、古い turn の要約が作られず、Codex の自動継続は要約を作れずに
+止まる。この影響を隠さない。
+
+他の通信の扱いは、次のとおりで、変えない。
+
+- BugHub への送信の失敗（`unreachable` など）は、送信の状態（`runtime-errors report-status`）にだけ残し、
+  runtime error には数えない。次の時機に、その時点の累計を送り直す。hook の結果は変えない。
+- Claude Code の要約は、Codex CLI → Haiku → L2 の本文の、宣言済みの fallback。backend の失敗では throw せず、数えない。
+- `self-update` の npm の失敗は、呼び出し元へ結果として返す。runtime error には数えない。
+- hook 処理の失敗（`HOOK_*_FAILED`）の経路に、通信は無い。
+
+## Decision
+
+1. `L1_SUMMARIZER_BACKEND_FAILED` を、runtime error として数えるのをやめる。失敗の理由と stderr の末尾は、
+   今までどおり `hook-failures.log` に、この code の名前で残す（端末内だけ）。hook の終了 code と stderr は変えない。
+2. 端末ごとに、成功を確認できていない間の最初と最後の失敗の時刻を持つ
+   （`~/.throughline/l1-backend-recovery.json`。会話の内容も失敗の文面も書かない）。
+3. 最初の失敗から24時間を過ぎた後の失敗は、`L1_SUMMARIZER_BACKEND_UNRECOVERED` として数える。
+   component は `codex_l1_summarizer`、template は
+   `Throughline L1 summarizer backend (Codex CLI) has not recovered for over 24 hours`、severity は `warn`。
+4. severity を `warn` にする根拠は影響。記憶は失われていない（取り込みは済み、recall は L2 を返す）。重複は無い。
+   backend が戻れば、次の Stop で自動で復帰する。機能が止まるのは、Codex の自動継続が古い turn の要約を
+   作れない時で、その時は5の画面が出て、入力と記録は残り、再開できる。
+5. Codex の自動継続の worker は、要約の backend の失敗を、汎用の `handoff_worker_failed` ではなく
+   `handoff_summarizer_backend_failed` で止める。失敗の画面に、通信の断・利用上限・認証切れで起きる事、
+   記録と入力が失われていない事、backend が使える様になった後に旧タスクへ入力すると引き継ぎを始め直す事を書く。
+6. backend が要約を返したら、2の記録を消す。3を数えていた時は、その記録を `recovered` で解決にする
+   （製品の明示の解決。BugHub へは次の送信で届く）。復帰の後の失敗は、また最初から数える。
+7. 前の版が `L1_SUMMARIZER_BACKEND_FAILED` を記録した store を読める様に、その定義は残す。
+8. 送信の本文の形（BugHub の契約）は変えない。項目を足さない。
+
+ADR 0028 の1（1回ごとに数える）と5（severity の根拠のうち、数える条件）は、この ADR で置き換える。
+ADR 0028 の2（対象の error）・3（終了 code と stderr）・4（`hook-failures.log`）は変えない。
+
+## Consequences
+
+- 通信の一時的な断、利用上限、取り消しで要約が1回失敗しても、BugHub には何も出ない。端末の `hook-failures.log` で読める。
+- backend が使えないままの端末は、最初の失敗から24時間を過ぎた後の失敗で、BugHub に `warn` の未解決として出る。
+  これは「復帰を確認できていない」という事実で、原因が通信環境か、認証か、製品かは決めていない。
+  記録の担当は Throughline の保守だが、通信環境や認証の修理は、その環境を管理する担当へ渡す。
+- 「24時間」は、最初の失敗からの経過で見る。その間ずっと失敗し続けていた証明ではない（間に Stop が無ければ、
+  試していない）。記録は成功で自動で解決になる。
+- 要約が成功したかを見るのは、要約を実際に行った Stop だけ。20 turn 以内のスレッドの Stop は、復帰の証拠にしない。
+- runtime error store は、知らない code を持つ記録を schema invalid として拒否する。この版で
+  `L1_SUMMARIZER_BACKEND_UNRECOVERED` を記録した端末を 0.16.3 以前へ戻すと、store を読めなくなる。
+- 0.16.3 までに `L1_SUMMARIZER_BACKEND_FAILED` を記録した端末の記録は、そのまま残る。書き換えない。
+  保守の担当が、端末の正規の入口（`runtime-errors resolve`）で、根拠を付けて閉じる。
+
+## 確認していない範囲
+
+- 要約が失敗し続ける間、Codex の Stop hook は毎回 exit 1 になる。Codex の画面への影響は調べていない（ADR 0028 と同じ）。
+- 本物の Codex CLI が、通信の断・利用上限・認証切れのそれぞれで、どの終了 code と stderr を返すか。
+  試験は、非0で終わる代わりの CLI で行った。

package/docs/adr/0042-codex-capture-writes-only-changed-tail.md

@@ -0,0 +1,62 @@
+# ADR 0042: Codex の取り込みは、L3 の変わった所から後ろだけを書く。WAL の大きさに上限を置く
+
+日付: 2026-10-08
+
+## Context
+
+Codex の hook（UserPromptSubmit・PostToolUse・Stop・PreCompact）は、毎回 `captureCodexRolloutToDb` を呼ぶ。
+0.16.4 までは、その会話の `bodies` と `details` を全部消し、rollout を読み直した結果を全部入れ直していた。
+PostToolUse は道具を1回使うたびに走るので、会話が長いほど、1回の hook が会話全体と同じ量を WAL へ書く。
+
+2026-10-08 に Windows の端末で次の状態を見た。
+
+- `throughline.db` は 230MB。`throughline.db-wal` は 12.8GB。
+- Codex の会話1つが、L3 に 3,552 行・約 1.47 億字を持つ（rollout は 288MB）。
+- その会話の hook を、本物の DB の写しへ当てて測ると、1回で WAL へ 152.9MB を書いた。rollout に変化が無い時も同じ量を書く。
+- hook が続く間、44 秒で wal-index が約 600MB 分伸びた。
+
+WAL は、checkpoint が全部を本体へ書き戻し、読んでいる接続が無い時にだけ、先頭から使い直される。1回の
+hook が百数十 MB を書き、別の会話の hook が続けて来ると、使い直す隙が出来ず、WAL は伸び続ける。また、
+SQLite の既定（`journal_size_limit = -1`）では、一度伸びた WAL のファイルは、中身が空になっても縮まない。
+
+rollout は追記で伸びる。普通の hook の間で変わるのは、L3 の末尾の数行だけ。
+
+## Decision
+
+1. `captureCodexRolloutToDb` は、`details` を次の形で書く。
+   - DB にある行（`id` の順）と、rollout から作った行を、先頭から1行ずつ比べる。
+   - 比べるのは `origin_session_id`・`turn_number`・`tool_name`・`kind`・`source_id`・`token_count`・`created_at` と、
+     `input_text`・`output_text` の本文。本文は SQLite の中で比べる（`input_text IS ? AND output_text IS ?`）。
+   - 最初に食い違った行から後ろを消し、rollout の同じ位置から後ろを入れる。食い違いが無ければ、増えた行だけを入れる。
+2. 比べる前に、rollout から作った行を、DB に入る形へ揃える。同じ `source_id` の2件目は
+   `uq_details_source` と `INSERT OR IGNORE` が捨てるので、先に除く。
+3. rollout に時刻が無い行は、取り込んだ時刻が `created_at` に入る。その行は `created_at` を比べず、
+   最初に取り込んだ時刻のまま残す。0.16.4 までは、取り込むたびにその時の時刻へ変わっていた。
+4. `bodies` は、今までどおり全部消して入れ直す。会話の本文は小さい（上の会話で 98 行・約 7.7 万字）。
+   `skeletons`（L1）の扱いも変えない。
+5. `getDb()` は、開いた接続へ `PRAGMA journal_size_limit = 67108864`（64MB）を設定する。WAL が使い直された
+   後の最初の commit で、SQLite がファイルを 64MB まで切り詰める。切り詰めに失敗しても、SQLite はその
+   失敗を無視して書き込みを続ける。
+6. `captureCodexRolloutToDb` の結果へ、`keptDetails`・`writtenDetails`・`removedDetails` を足す。
+
+## Consequences
+
+- 取り込んだ後の `details` の中身と並び（`id` の順）は、全部入れ直した時と同じになる。3 の `created_at` だけが違う。
+- 変わっていない行の `id` は、hook をまたいで変わらなくなる。0.16.4 までは、毎回新しい `id` になっていた。
+- 上の会話の写しで測ると、変化の無い hook が WAL へ書く量は 152.9MB から 0.3MB になる。89 行が増えた hook は 12.5MB。
+- hook は、今までどおり毎回 rollout の全体を読む。上の会話では、読むのに約 1.1 秒、比べるのに約 0.3 秒かかる。
+  本文を比べるために、DB にあるその会話の L3 を毎回読む。書く量は減るが、読む量は減らない。
+- rollout の途中の行が変わった時（rollback の後など）は、その行から後ろを入れ直す。先頭の行が変われば、
+  今までと同じく全部を入れ直す。
+- 同じ会話の hook が2つ同時に走った時は、後で commit した方の rollout の読み取りが残る。今までと同じ。
+- すでに伸びている WAL は、この版の接続が、使い直された WAL へ最初に commit した時に縮む。それまでは元の大きさのまま。
+- `journal_size_limit` は接続ごとの設定で、DB には残らない。読み取り専用の接続（`openReadOnlyDb`）には設定しない。
+- schema は変えない（v12 のまま）。
+
+## 確認していない範囲
+
+- WAL が使い直されない状態（checkpoint が終わる前に次の書き込みが来る状態）が、この版で実際に起きなくなるか。
+  書く量が減った分、起きにくくなるが、本物の端末で複数の会話が同時に動いた時の WAL の大きさは、公開の後に読む。
+- rollout を毎回全部読む時間が、Codex の画面で道具の後の待ちとして見えているか。
+- Claude Code・Grok・Cursor の取り込みは、ターンごとに `INSERT OR IGNORE` で足す形で、この変更の対象ではない。
+  これらの host の長い会話での書く量は測っていない。

package/package.json

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

package/src/cli/codex-hook.mjs

@@ -1,4 +1,4 @@
-import { recordRuntimeErrorBestEffort } from '../runtime-error-store.mjs';
+import { recordRuntimeErrorBestEffort, resolveRecoveredRuntimeErrorBestEffort } from '../runtime-error-store.mjs';
 import { logHookFailure } from '../hook-failure-log.mjs';
 
 function parseArgs(argv) {
@@ -422,6 +422,13 @@ export async function run(argv = []) {
         payload,
         env: process.env,
       });
+      // backend が要約を返した。失敗の後なら、復帰を確認できた（ADR 0041）。失敗の記録が無い時は、ファイルの有無を見るだけ。
+      if (result.summarized?.summarized?.some((turn) => turn.source === 'codex-cli')) {
+        const { noteL1BackendSuccess } = await import('../l1-backend-recovery.mjs');
+        if (noteL1BackendSuccess().reported) {
+          resolveRecoveredRuntimeErrorBestEffort('L1_SUMMARIZER_BACKEND_UNRECOVERED', { env: process.env });
+        }
+      }
     }
     if (parsed.event === 'pre-compact' && result.continue === false) {
       process.stdout.write(JSON.stringify({ continue: false, stopReason: result.stopReason }) + '\n');
@@ -434,7 +441,16 @@ export async function run(argv = []) {
     process.exit(result.continue === false || result.status === 'ok' || result.status === 'skipped' ? 0 : 1);
   } catch (err) {
     const code = codexHookFailureCode(err);
-    recordRuntimeErrorBestEffort(code, { env: process.env });
+    if (code === 'L1_SUMMARIZER_BACKEND_FAILED') {
+      // 取り込みは済み、要約は次の Stop がやり直す。1回ごとの失敗（通信の断・利用上限・取り消しを含む）は
+      // 端末の診断（hook-failures.log）にだけ残す。復帰を24時間確認できていない時だけ数える（ADR 0041）。
+      const { noteL1BackendFailure } = await import('../l1-backend-recovery.mjs');
+      if (noteL1BackendFailure().unrecovered) {
+        recordRuntimeErrorBestEffort('L1_SUMMARIZER_BACKEND_UNRECOVERED', { env: process.env });
+      }
+    } else {
+      recordRuntimeErrorBestEffort(code, { env: process.env });
+    }
     logHookFailure(code, err);
     const msg = err instanceof Error ? err.message : 'unknown';
     if (parsed.json) {

package/src/codex-auto-handoff.mjs

@@ -342,6 +342,7 @@ export function showAutoHandoffFailure(operation) {
 <h1>自動継続を完了できませんでした</h1><p>引き継ぎは下記の工程で止まっています。タスクと記録を確認してください。</p>
 <p><a href="codex://threads/${escape(operation.source_thread_id)}">旧タスクを開く</a>${operation.target_thread_id ? ` / <a href="codex://threads/${escape(operation.target_thread_id)}">後継タスクを開く</a>` : ''}</p>
 <p>理由: <code>${escape(operation.error_code)}</code></p><p>引き継ぎID: <code>${escape(operation.handoff_id)}</code></p>
+${operation.error_code === 'handoff_summarizer_backend_failed' ? '<p>記憶の要約に使うCodex CLIが失敗しました。通信の断、利用上限、認証切れなどで起きます。会話の記録と入力は失われていません。Codex CLIが使える様になった後、旧タスクへ入力すると、引き継ぎをもう一度始めます。</p>' : ''}
 <p>状態: ${escape(operation.state)} / 停止した工程: ${escape(operation.resume_state)}</p>
 <p>確認: <code>throughline auto-handoff status --operation ${escape(operation.handoff_id)}</code></p>
 <p>原因を解消した後の再開: <code>throughline auto-handoff resume --operation ${escape(operation.handoff_id)}</code></p>
@@ -408,7 +409,14 @@ export async function runAutoHandoffWorker(id, { db = getDb(), resume = false, d
         const state = deps.readSource(operation);
         update({ snapshot_json: freezeCodexMemory(db, operation, operation.settings, state) });
       }
-      deps.summaries(db, operation);
+      try { deps.summaries(db, operation); }
+      catch (cause) {
+        // 古いturnの要約を作るbackend（Codex CLI）が使えない。通信の断・利用上限・認証切れでも起きる。
+        // 汎用の理由にせず、固定の理由で止める。失敗の画面に、失われた物が無い事と再開の仕方を書く（ADR 0041）。
+        if ((cause?.source === 'codex-cli' && ['codex_cli_failed', 'empty_output'].includes(cause.reason)) ||
+            cause?.message === 'handoff_l1_unavailable') throw error('handoff_summarizer_backend_failed');
+        throw cause;
+      }
       update({ state: 'memory_ready' });
     }
     if (operation.state === 'memory_ready') {

package/src/codex-auto-handoff.test.mjs

@@ -614,3 +614,20 @@ test('引き継ぎの最中に旧タスクへ来た入力は、凍結する記
   assert.equal(freezeCodexMemory(db, operation, {}, { stoppedAt: 305, laterTurns: later }).bodies.length, 3);
   assert.equal(freezeCodexMemory(db, operation, {}, { stoppedAt: 200, laterTurns: [later[0]] }).bodies.length, 3);
 }));
+
+test('要約のbackendが使えない時、workerは固定の理由で止まり、後継を作らない', async () => withDb(async db => {
+  const backend = reason => Object.assign(new Error('Codex CLI summarizer failed: exit 1'), { source: 'codex-cli', reason });
+  const cases = [[backend('codex_cli_failed'), 'handoff_summarizer_backend_failed'], [backend('empty_output'), 'handoff_summarizer_backend_failed'],
+    [new Error('handoff_l1_unavailable'), 'handoff_summarizer_backend_failed'],
+    // 製品側の誤り（要約の呼び方の間違い）と、他の失敗は、今までどおり汎用の理由。
+    [backend('recursion_guard'), 'handoff_worker_failed'], [new Error('別の失敗'), 'handoff_worker_failed']];
+  for (const [index, [cause, expected]] of cases.entries()) {
+    const operation = request(db, `summarizer-${index}`, { now: 1 }).operation;
+    const counters = { created: 0, submitted: 0, notified: 0 };
+    const deps = workerDependencies(db, {}, async () => { counters.submitted++; }, counters);
+    deps.summaries = () => { throw cause; };
+    const result = await runAutoHandoffWorker(operation.handoff_id, { db, dependencies: deps });
+    assert.equal(result.state, 'failed'); assert.equal(result.error_code, expected); assert.equal(result.resume_state, 'source_stopped');
+    assert.equal(counters.created, 0); assert.equal(counters.submitted, 0); assert.equal(counters.notified, 1);
+  }
+}));

package/src/codex-capture.mjs

@@ -58,6 +58,7 @@ export function captureCodexRolloutToDb(
     now,
   });
 
+  let detailSync = null;
   db.exec('BEGIN IMMEDIATE');
   try {
     db.prepare(
@@ -80,19 +81,12 @@ export function captureCodexRolloutToDb(
       }
     }
     db.prepare('DELETE FROM bodies WHERE session_id = ?').run(sessionId);
-    db.prepare('DELETE FROM details WHERE session_id = ?').run(sessionId);
 
     const insertBody = db.prepare(
       `INSERT INTO bodies
          (session_id, origin_session_id, turn_number, role, text, token_count, created_at)
        VALUES (?, ?, ?, ?, ?, ?, ?)`,
     );
-    const insertDetail = db.prepare(
-      `INSERT OR IGNORE INTO details
-         (session_id, origin_session_id, turn_number, tool_name, input_text, output_text,
-          token_count, created_at, kind, source_id)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    );
 
     for (const row of rows) {
       insertBody.run(
@@ -105,20 +99,7 @@ export function captureCodexRolloutToDb(
         row.createdAt,
       );
     }
-    for (const row of detailRows) {
-      insertDetail.run(
-        row.sessionId,
-        row.originSessionId,
-        row.turnNumber,
-        row.toolName,
-        row.inputText,
-        row.outputText,
-        row.tokenCount,
-        row.createdAt,
-        row.kind,
-        row.sourceId,
-      );
-    }
+    detailSync = syncDetailRows(db, sessionId, detailRows, now);
 
     db.exec('COMMIT');
   } catch (err) {
@@ -137,10 +118,100 @@ export function captureCodexRolloutToDb(
     capturedTurns: parsed.activeTurnCount,
     capturedRows: rows.length,
     capturedDetails: detailRows.length,
+    keptDetails: detailSync.kept,
+    writtenDetails: detailSync.inserted,
+    removedDetails: detailSync.removed,
     stats: parsed.stats,
   };
 }
 
+/**
+ * L3 (details) を rollout の今の中身へ合わせる。変わっていない先頭の行はそのまま残し、
+ * 最初に食い違った行から後ろだけを消して入れ直す (ADR 0042)。
+ *
+ * hook は道具を1回使うたびに走る。会話の全行を消して入れ直すと、長い会話では1回の hook が
+ * 会話全体と同じ量を WAL へ書く。rollout は追記で伸びるので、普通は末尾の数行だけが変わる。
+ *
+ * 残った行の並び (id の順) は、全部入れ直した時と同じになる。食い違いは本文まで比べて決める。
+ */
+function syncDetailRows(db, sessionId, detailRows, now) {
+  const wanted = dropIgnoredDuplicates(detailRows);
+  const existing = db
+    .prepare(
+      `SELECT id, origin_session_id, turn_number, tool_name, kind, source_id, token_count, created_at
+         FROM details WHERE session_id = ? ORDER BY id`,
+    )
+    .all(sessionId);
+  const sameText = db.prepare(
+    'SELECT 1 AS same FROM details WHERE id = ? AND input_text IS ? AND output_text IS ?',
+  );
+
+  let kept = 0;
+  while (kept < existing.length && kept < wanted.length) {
+    const have = existing[kept];
+    const want = wanted[kept];
+    if (!sameDetailColumns(have, want, now)) break;
+    if (!sameText.get(have.id, want.inputText, want.outputText)) break;
+    kept++;
+  }
+
+  if (kept < existing.length) {
+    db.prepare('DELETE FROM details WHERE session_id = ? AND id >= ?').run(sessionId, existing[kept].id);
+  }
+
+  const insertDetail = db.prepare(
+    `INSERT OR IGNORE INTO details
+       (session_id, origin_session_id, turn_number, tool_name, input_text, output_text,
+        token_count, created_at, kind, source_id)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+  );
+  for (const row of wanted.slice(kept)) {
+    insertDetail.run(
+      row.sessionId,
+      row.originSessionId,
+      row.turnNumber,
+      row.toolName,
+      row.inputText,
+      row.outputText,
+      row.tokenCount,
+      row.createdAt,
+      row.kind,
+      row.sourceId,
+    );
+  }
+
+  return { kept, removed: existing.length - kept, inserted: wanted.length - kept };
+}
+
+// uq_details_source (session_id, origin_session_id, source_id) は、同じ source_id の2件目を
+// INSERT OR IGNORE で捨てる。DB に入る並びと比べるため、入れる前に同じ形へ揃える。
+function dropIgnoredDuplicates(detailRows) {
+  const seen = new Set();
+  const rows = [];
+  for (const row of detailRows) {
+    if (row.sourceId !== null) {
+      const key = `${row.originSessionId}\0${row.sourceId}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+    }
+    rows.push(row);
+  }
+  return rows;
+}
+
+function sameDetailColumns(have, want, now) {
+  return (
+    have.origin_session_id === want.originSessionId &&
+    have.turn_number === want.turnNumber &&
+    have.tool_name === want.toolName &&
+    have.kind === want.kind &&
+    have.source_id === want.sourceId &&
+    have.token_count === want.tokenCount &&
+    // rollout に時刻が無い行は取り込んだ時刻が入る。その行は最初に取り込んだ時刻のまま残す。
+    (have.created_at === want.createdAt || want.createdAt === now)
+  );
+}
+
 function bodyTurnTexts(rows) {
   const turns = new Map();
   for (const row of rows) {

package/src/codex-capture.test.mjs

@@ -459,6 +459,158 @@ test('同じ会話の再captureはL1を保持し、ユーザー本文が変わ
   }
 });
 
+// 本物の schema と同じく、同じ source_id の2件目を INSERT OR IGNORE が捨てる DB。
+function makeDbWithSourceIndex() {
+  const db = makeDb();
+  db.exec(`CREATE UNIQUE INDEX uq_details_source
+             ON details(session_id, origin_session_id, source_id) WHERE source_id IS NOT NULL`);
+  return db;
+}
+
+function detailSnapshot(db) {
+  return db
+    .prepare(
+      `SELECT origin_session_id, turn_number, tool_name, input_text, output_text, token_count,
+              created_at, kind, source_id
+         FROM details ORDER BY id`,
+    )
+    .all();
+}
+
+function toolCall(callId, input, output) {
+  return [
+    responseItem({ type: 'function_call', call_id: callId, name: 'shell', arguments: input }),
+    responseItem({ type: 'function_call_output', call_id: callId, output }),
+  ];
+}
+
+test('同じ会話の再captureは、変わっていないL3の行を書き直さず、増えた行だけを足す', () => {
+  const db = makeDbWithSourceIndex();
+  const home = mkdtempSync(join(tmpdir(), 'tl-codex-incr-'));
+  const project = mkdtempSync(join(tmpdir(), 'tl-codex-project-'));
+  const threadId = '019dfaba-f87e-7f41-a144-d5ca7c6dd7f9';
+  try {
+    const head = [
+      event('task_started'), event('user_message', { message: '作業を続ける' }),
+      ...toolCall('call-1', '{"cmd":"pwd"}', '/work'),
+      ...toolCall('call-2', '{"cmd":"ls"}', 'a\nb'),
+    ];
+    const rollout = writeRollout(home, { id: threadId, cwd: project, events: head });
+    const first = captureCodexRolloutToDb(db, { threadId, codexHome: home, projectPath: project, now: 1 });
+    assert.deepEqual([first.keptDetails, first.writtenDetails, first.removedDetails], [0, 4, 0]);
+    const idsBefore = db.prepare('SELECT id FROM details ORDER BY id').all().map((row) => row.id);
+
+    // 道具をもう1回使った後の hook。前の4行はそのまま残り、2行だけ増える。
+    writeRolloutRows(rollout, [sessionMeta(threadId, project), ...head, ...toolCall('call-3', '{"cmd":"date"}', 'now')]);
+    const second = captureCodexRolloutToDb(db, { threadId, codexHome: home, projectPath: project, now: 2 });
+    assert.deepEqual([second.keptDetails, second.writtenDetails, second.removedDetails], [4, 2, 0]);
+    const idsAfter = db.prepare('SELECT id FROM details ORDER BY id').all().map((row) => row.id);
+    assert.deepEqual(idsAfter.slice(0, 4), idsBefore);
+    assert.equal(idsAfter.length, 6);
+    assert.ok(idsAfter[4] > idsBefore[3]);
+
+    // 何も増えていない hook は、L3 を1行も書かない。
+    const third = captureCodexRolloutToDb(db, { threadId, codexHome: home, projectPath: project, now: 3 });
+    assert.deepEqual([third.keptDetails, third.writtenDetails, third.removedDetails], [6, 0, 0]);
+    assert.deepEqual(db.prepare('SELECT id FROM details ORDER BY id').all().map((row) => row.id), idsAfter);
+  } finally {
+    db.close(); rmSync(home, { recursive: true, force: true }); rmSync(project, { recursive: true, force: true });
+  }
+});
+
+test('L3の再captureは、どの変わり方でも、全部入れ直した時と同じ中身と並びになる', () => {
+  const threadId = '019dfaba-f87e-7f41-a144-d5ca7c6dd7f9';
+  const turn = (message, ...items) => [
+    event('task_started'), event('user_message', { message }), ...items.flat(), event('task_complete'),
+  ];
+  const orphanOutput = (output) => responseItem({ type: 'function_call_output', output });
+  const base = [
+    ...turn('1つ目', toolCall('call-1', '{"cmd":"pwd"}', '/work'), [orphanOutput('aaaa')]),
+    ...turn('2つ目', toolCall('call-2', '{"cmd":"ls"}', 'file-a'), toolCall('call-3', '{"cmd":"date"}', 'now')),
+  ];
+  const cases = {
+    // 末尾へ足されただけ。前の6行は残る。
+    '末尾へ行が増えた': { next: [...base, ...turn('3つ目', toolCall('call-4', '{"cmd":"id"}', 'kite'))], kept: 7 },
+    // 同じ source_id・同じ長さで、本文だけが違う。その行から後ろを入れ直す。
+    '途中の行の本文が同じ長さで変わった': {
+      next: [
+        ...turn('1つ目', toolCall('call-1', '{"cmd":"pwd"}', '/WORK'), [orphanOutput('aaaa')]),
+        ...turn('2つ目', toolCall('call-2', '{"cmd":"ls"}', 'file-a'), toolCall('call-3', '{"cmd":"date"}', 'now')),
+      ],
+      kept: 1,
+    },
+    // source_id の無い行は、本文でしか区別できない。
+    'source_idの無い行の本文が変わった': {
+      next: [
+        ...turn('1つ目', toolCall('call-1', '{"cmd":"pwd"}', '/work'), [orphanOutput('bbbb')]),
+        ...turn('2つ目', toolCall('call-2', '{"cmd":"ls"}', 'file-a'), toolCall('call-3', '{"cmd":"date"}', 'now')),
+      ],
+      kept: 2,
+    },
+    // 出力が後から届いた（NULL だった所へ入る形ではなく、行が増える）。
+    '途中へ行が差し込まれた': {
+      next: [
+        ...turn('1つ目', toolCall('call-1', '{"cmd":"pwd"}', '/work'), toolCall('call-1b', '{"cmd":"x"}', 'y'), [orphanOutput('aaaa')]),
+        ...turn('2つ目', toolCall('call-2', '{"cmd":"ls"}', 'file-a'), toolCall('call-3', '{"cmd":"date"}', 'now')),
+      ],
+      kept: 2,
+    },
+    // rollback で最後のターンが消えた。
+    '最後のターンが巻き戻された': { next: [...base, event('thread_rolled_back', { num_turns: 1 })], kept: 3 },
+    // 同じ call_id がもう一度出た。2件目は捨てられるので、並びは変わらない。
+    '同じsource_idがもう一度出た': {
+      next: [
+        ...turn('1つ目', toolCall('call-1', '{"cmd":"pwd"}', '/work'), [orphanOutput('aaaa')]),
+        ...turn('2つ目', toolCall('call-2', '{"cmd":"ls"}', 'file-a'), toolCall('call-2', '{"cmd":"ls"}', 'file-a'),
+          toolCall('call-3', '{"cmd":"date"}', 'now')),
+      ],
+      kept: 7,
+    },
+    '全部無くなった': { next: [...turn('1つ目')], kept: 0 },
+  };
+
+  for (const [name, { next, kept }] of Object.entries(cases)) {
+    const home = mkdtempSync(join(tmpdir(), 'tl-codex-incr-'));
+    const project = mkdtempSync(join(tmpdir(), 'tl-codex-project-'));
+    const db = makeDbWithSourceIndex();
+    const fresh = makeDbWithSourceIndex();
+    try {
+      const rollout = writeRollout(home, { id: threadId, cwd: project, events: base });
+      captureCodexRolloutToDb(db, { threadId, codexHome: home, projectPath: project, now: 1 });
+      assert.equal(detailSnapshot(db).length, 7, name);
+
+      writeRolloutRows(rollout, [sessionMeta(threadId, project), ...next]);
+      const again = captureCodexRolloutToDb(db, { threadId, codexHome: home, projectPath: project, now: 2 });
+      captureCodexRolloutToDb(fresh, { threadId, codexHome: home, projectPath: project, now: 2 });
+
+      assert.deepEqual(detailSnapshot(db), detailSnapshot(fresh), name);
+      assert.equal(again.keptDetails, kept, name);
+    } finally {
+      db.close(); fresh.close();
+      rmSync(home, { recursive: true, force: true }); rmSync(project, { recursive: true, force: true });
+    }
+  }
+});
+
+test('rolloutに時刻の無いL3の行は、再captureしても最初に取り込んだ時刻のまま残る', () => {
+  const db = makeDbWithSourceIndex();
+  const home = mkdtempSync(join(tmpdir(), 'tl-codex-incr-'));
+  const project = mkdtempSync(join(tmpdir(), 'tl-codex-project-'));
+  const threadId = '019dfaba-f87e-7f41-a144-d5ca7c6dd7f9';
+  try {
+    const untimed = { type: 'response_item', payload: { type: 'function_call', call_id: 'call-1', name: 'shell', arguments: '{}' } };
+    writeRollout(home, { id: threadId, cwd: project, events: [
+      event('task_started'), event('user_message', { message: '作業を続ける' }), untimed,
+    ] });
+    captureCodexRolloutToDb(db, { threadId, codexHome: home, projectPath: project, now: 1000 });
+    const again = captureCodexRolloutToDb(db, { threadId, codexHome: home, projectPath: project, now: 2000 });
+    assert.equal(again.keptDetails, 1);
+    assert.equal(db.prepare('SELECT created_at FROM details').get().created_at, 1000);
+  } finally {
+    db.close(); rmSync(home, { recursive: true, force: true }); rmSync(project, { recursive: true, force: true });
+  }
+});
+
 function writeRollout(home, { id, cwd, events }) {
   const dir = join(home, 'sessions', '2026', '05', '06');
   mkdirSync(dir, { recursive: true });

package/src/db-contention.test.mjs

@@ -52,6 +52,50 @@ test('getDb configures a bounded SQLite busy timeout for concurrent hook process
   }
 });
 
+test('getDbは、膨らんだWALを次の書き込みで上限まで切り詰める', () => {
+  const home = mkdtempSync(join(tmpdir(), 'throughline-db-wal-limit-'));
+  try {
+    const env = { ...process.env, HOME: home, USERPROFILE: home };
+    // 上限を持たない接続で、checkpoint を止めたまま WAL を膨らませ、そのまま閉じずに終わる。
+    const grow = spawnSync(process.execPath, ['--input-type=module', '-e', `
+      import { statSync } from 'node:fs';
+      import { DatabaseSync } from 'node:sqlite';
+      import { getDb, DB_PATH, WAL_SIZE_LIMIT_BYTES } from ${JSON.stringify(DB_MODULE_URL)};
+      getDb().close();
+      const db = new DatabaseSync(DB_PATH);
+      db.exec('PRAGMA wal_autocheckpoint = 0');
+      db.exec('CREATE TABLE filler (id INTEGER PRIMARY KEY, body TEXT)');
+      const insert = db.prepare('INSERT INTO filler (body) VALUES (?)');
+      const body = 'x'.repeat(1024 * 1024);
+      while (statSync(DB_PATH + '-wal').size <= WAL_SIZE_LIMIT_BYTES + 8 * 1024 * 1024) insert.run(body);
+      db.exec('DELETE FROM filler');
+      console.log(JSON.stringify({ wal: statSync(DB_PATH + '-wal').size, limit: WAL_SIZE_LIMIT_BYTES }));
+      process.exit(0);
+    `], { env, encoding: 'utf8' });
+    assert.equal(grow.status, 0, grow.stderr);
+    const grown = JSON.parse(grow.stdout);
+    assert.ok(grown.wal > grown.limit, `WAL が膨らんでいない: ${grow.stdout}`);
+
+    // 製品の入口で開いた接続が、checkpoint の後の最初の書き込みで切り詰める。
+    const shrink = spawnSync(process.execPath, ['--input-type=module', '-e', `
+      import { statSync } from 'node:fs';
+      import { getDb, DB_PATH } from ${JSON.stringify(DB_MODULE_URL)};
+      const db = getDb();
+      const limit = db.prepare('PRAGMA journal_size_limit').get().journal_size_limit;
+      db.exec('PRAGMA wal_checkpoint(PASSIVE)');
+      db.prepare("INSERT INTO sessions (session_id, project_path, status, created_at, updated_at) VALUES ('wal-limit', '/tmp', 'active', 1, 1)").run();
+      console.log(JSON.stringify({ limit, wal: statSync(DB_PATH + '-wal').size }));
+      process.exit(0);
+    `], { env, encoding: 'utf8' });
+    assert.equal(shrink.status, 0, shrink.stderr);
+    const shrunk = JSON.parse(shrink.stdout);
+    assert.equal(shrunk.limit, grown.limit);
+    assert.ok(shrunk.wal <= grown.limit, `WAL が上限を超えたまま: ${shrink.stdout}`);
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
 test('getDb reuses an existing WAL database while another process owns the writer lock', async () => {
   const home = mkdtempSync(join(tmpdir(), 'throughline-db-contention-'));
   const env = { ...process.env, HOME: home, USERPROFILE: home };

package/src/db.mjs

@@ -10,6 +10,9 @@ import { join } from 'path';
 const DB_DIR = join(homedir(), '.throughline');
 export const DB_PATH = join(DB_DIR, 'throughline.db');
 export const DB_BUSY_TIMEOUT_MS = 5_000;
+// WAL が checkpoint で巻き戻った後、次の書き込みでファイルをこの大きさまで切り詰める (ADR 0042)。
+// 既定 (-1) は切り詰めないので、一度膨らんだ WAL は中身が空でも元の大きさのまま残る。
+export const WAL_SIZE_LIMIT_BYTES = 64 * 1024 * 1024;
 export const CURRENT_VERSION = 12;
 
 let _db = null;
@@ -485,6 +488,7 @@ export function getDb() {
     db.exec(`PRAGMA busy_timeout = ${DB_BUSY_TIMEOUT_MS}`);
     settleFirstRead(db);
     ensureWalJournalMode(db);
+    db.exec(`PRAGMA journal_size_limit = ${WAL_SIZE_LIMIT_BYTES}`);
     db.exec('PRAGMA foreign_keys = ON');
     initSchema(db);
     _db = db;

package/src/l1-backend-recovery.mjs

@@ -0,0 +1,74 @@
+/**
+ * l1-backend-recovery.mjs — L1 要約の backend（Codex CLI）が失敗してから、復帰を確認できたかの記録 (ADR 0041)
+ *
+ * Codex Stop の要約は外部 CLI を呼ぶ。通信の断、利用上限、認証切れ、利用者の取り消しでも失敗する。
+ * 会話の取り込みは済んでいて、要約は次の Stop がやり直すので、1回ごとの失敗は修理の対象として数えない。
+ * 最初の失敗から期限（24時間）を過ぎても成功を確認できていない時だけ、runtime error として数える。
+ *
+ * 端末ごとに1つのファイル（~/.throughline/l1-backend-recovery.json）に、成功を確認できていない間の
+ * 最初と最後の失敗の時刻だけを持つ。会話の内容も失敗の文面も書かない（文面は hook-failures.log に残る）。
+ * 読み書きの失敗は stderr に出し、hook の結果を変えない。
+ */
+
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+
+export const L1_BACKEND_RECOVERY_SCHEMA = 'throughline.l1_backend_recovery.v1';
+export const L1_BACKEND_UNRECOVERED_MS = 24 * 60 * 60 * 1000;
+
+export function l1BackendRecoveryPath({ home = homedir() } = {}) {
+  return join(home, '.throughline', 'l1-backend-recovery.json');
+}
+
+function read(path) {
+  try {
+    const state = JSON.parse(readFileSync(path, 'utf8'));
+    if (state?.schema !== L1_BACKEND_RECOVERY_SCHEMA || !Number.isFinite(state.first_failure_at)) return null;
+    return state;
+  } catch (error) {
+    if (error.code !== 'ENOENT') process.stderr.write(`[l1-backend-recovery] ${error.message}\n`);
+    return null;
+  }
+}
+
+/**
+ * backend の失敗を1回記す。最初の失敗から期限を過ぎていれば unrecovered を返す。
+ * @returns {{ unrecovered: boolean, firstFailureAt: number|null }}
+ */
+export function noteL1BackendFailure({ home, now = Date.now() } = {}) {
+  const path = l1BackendRecoveryPath({ home });
+  try {
+    const previous = read(path);
+    const firstFailureAt = previous?.first_failure_at ?? now;
+    const unrecovered = now - firstFailureAt >= L1_BACKEND_UNRECOVERED_MS;
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    writeFileSync(temporary, `${JSON.stringify({ schema: L1_BACKEND_RECOVERY_SCHEMA, first_failure_at: firstFailureAt,
+      last_failure_at: now, reported: Boolean(previous?.reported) || unrecovered })}\n`, { mode: 0o600 });
+    renameSync(temporary, path);
+    return { unrecovered, firstFailureAt };
+  } catch (error) {
+    process.stderr.write(`[l1-backend-recovery] ${error.message}\n`);
+    return { unrecovered: false, firstFailureAt: null };
+  }
+}
+
+/**
+ * backend が要約を返した。失敗の記録があれば消す。期限を過ぎて runtime error に数えていた時は reported を返す。
+ * 記録が無い時（ふだん）は、ファイルの有無を1回見るだけで終わる。
+ * @returns {{ recovered: boolean, reported: boolean }}
+ */
+export function noteL1BackendSuccess({ home } = {}) {
+  const path = l1BackendRecoveryPath({ home });
+  if (!existsSync(path)) return { recovered: false, reported: false };
+  try {
+    const previous = read(path);
+    rmSync(path, { force: true });
+    return { recovered: true, reported: Boolean(previous?.reported) };
+  } catch (error) {
+    process.stderr.write(`[l1-backend-recovery] ${error.message}\n`);
+    return { recovered: false, reported: false };
+  }
+}

package/src/runtime-error-hook.test.mjs

@@ -144,7 +144,7 @@ function makeBin(dir, name, body) {
   return command;
 }
 
-test('Codex StopでL1要約backendが失敗した時、取り込みは残り、別のcodeで1回数える', () => {
+test('Codex StopのL1要約backendの失敗は1回ごとには数えず、24時間復帰を確認できない時だけ数え、成功で解決にする', () => {
   const { root, env } = createEnabledEnvironment('throughline-runtime-hook-summarizer-');
   const threadId = '019dfaba-f87e-7f41-a144-d5ca7c6dd7f9';
   const project = join(root, 'project');
@@ -168,20 +168,29 @@ test('Codex StopでL1要約backendが失敗した時、取り込みは残り、
   mkdirSync(binDir, { recursive: true });
   const codex = makeBin(binDir, 'codex', "process.stderr.write('ERROR: usage limit reached\\n');\nprocess.exit(42);\n");
 
-  const result = spawnSync(process.execPath, [BIN, 'codex-hook', 'stop'], {
-    env: { ...env, CODEX_HOME: codexHome, THROUGHLINE_CODEX_CLI_BIN: codex },
+  const stop = (bin) => spawnSync(process.execPath, [BIN, 'codex-hook', 'stop'], {
+    env: { ...env, CODEX_HOME: codexHome, THROUGHLINE_CODEX_CLI_BIN: bin },
     input: JSON.stringify({ session_id: threadId, transcript_path: rolloutPath, cwd: project }),
     encoding: 'utf8',
   });
+  const records = () => {
+    const storePath = defaultRuntimeErrorStorePath(env);
+    if (!existsSync(storePath)) return [];
+    return JSON.parse(readFileSync(storePath, 'utf8')).records
+      .map((record) => [record.error_code, record.component, record.severity, record.count, record.status, record.reason_code]);
+  };
+  const recoveryPath = join(root, '.throughline', 'l1-backend-recovery.json');
+  const result = stop(codex);
 
   // hook は明示して失敗する（終了 code と stderr は変えない）。
   assert.equal(result.status, 1, result.stderr);
   assert.match(result.stderr, /\[codex-hook\] Codex CLI summarizer failed: exit 42/);
 
-  const store = JSON.parse(readFileSync(defaultRuntimeErrorStorePath(env), 'utf8'));
-  assert.deepEqual(store.records.map((record) => [record.error_code, record.component, record.severity, record.count]), [
-    ['L1_SUMMARIZER_BACKEND_FAILED', 'codex_l1_summarizer', 'warn', 1],
-  ]);
+  // 1回の失敗は、修理の対象として数えない。通信の断・利用上限・取り消しでも起き、次の Stop がやり直す。
+  assert.deepEqual(records(), []);
+  const first = JSON.parse(readFileSync(recoveryPath, 'utf8'));
+  assert.equal(first.schema, 'throughline.l1_backend_recovery.v1'); assert.equal(first.reported, false);
+  assert.deepEqual(Object.keys(first).sort(), ['first_failure_at', 'last_failure_at', 'reported', 'schema']);
 
   // 取り込みは要約の前に commit 済み。
   const db = new DatabaseSync(join(root, '.throughline', 'throughline.db'));
@@ -198,6 +207,31 @@ test('Codex StopでL1要約backendが失敗した時、取り込みは残り、
   assert.equal(entry.code, 'L1_SUMMARIZER_BACKEND_FAILED');
   assert.equal(entry.reason, 'codex_cli_failed');
   assert.match(entry.stderr, /usage limit reached/);
+
+  // 続けて失敗しても、最初の失敗から24時間に届くまでは数えない。
+  assert.equal(stop(codex).status, 1);
+  assert.deepEqual(records(), []);
+  assert.equal(JSON.parse(readFileSync(recoveryPath, 'utf8')).first_failure_at, first.first_failure_at);
+
+  // 最初の失敗から24時間を過ぎても成功を確認できていない。warn で数える。
+  writeFileSync(recoveryPath, JSON.stringify({ ...first, first_failure_at: Date.now() - 25 * 3_600_000 }));
+  assert.equal(stop(codex).status, 1);
+  assert.deepEqual(records(), [['L1_SUMMARIZER_BACKEND_UNRECOVERED', 'codex_l1_summarizer', 'warn', 1, 'open', null]]);
+  assert.equal(JSON.parse(readFileSync(recoveryPath, 'utf8')).reported, true);
+  assert.equal(stop(codex).status, 1);
+  assert.deepEqual(records(), [['L1_SUMMARIZER_BACKEND_UNRECOVERED', 'codex_l1_summarizer', 'warn', 2, 'open', null]]);
+
+  // backend が要約を返した。失敗の記録を消し、数えていた記録を recovered で解決にする。
+  const working = makeBin(binDir, 'codex-ok', "process.stdout.write('要約\\n');\n");
+  const recovered = stop(working);
+  assert.equal(recovered.status, 0, recovered.stderr);
+  assert.equal(existsSync(recoveryPath), false);
+  assert.deepEqual(records(), [['L1_SUMMARIZER_BACKEND_UNRECOVERED', 'codex_l1_summarizer', 'warn', 2, 'resolved', 'recovered']]);
+
+  // 復帰した後の失敗は、また最初から数える（すぐには数えない）。
+  assert.equal(stop(codex).status, 1);
+  assert.deepEqual(records(), [['L1_SUMMARIZER_BACKEND_UNRECOVERED', 'codex_l1_summarizer', 'warn', 2, 'resolved', 'recovered']]);
+  assert.equal(JSON.parse(readFileSync(recoveryPath, 'utf8')).reported, false);
 });
 
 test('store failure preserves product failure and emits only fixed storage diagnostic', () => {

package/src/runtime-error-observer.mjs

@@ -1,7 +1,10 @@
-import { observeRuntimeError } from './runtime-error-store.mjs';
+import { observeRuntimeError, resolveRuntimeError, runtimeErrorFingerprint } from './runtime-error-store.mjs';
 
 try {
-  const result = observeRuntimeError({ code: process.argv[2] });
+  // 第2引数が recovered の時は、その code の記録を「復帰を確認した」として解決にする（ADR 0041）。
+  const result = process.argv[3] === 'recovered'
+    ? resolveRuntimeError(runtimeErrorFingerprint(process.argv[2]), { reasonCode: 'recovered' })
+    : observeRuntimeError({ code: process.argv[2] });
   process.exitCode = result.status === 'disabled' ? 3 : 0;
 } catch {
   process.exitCode = 1;

package/src/runtime-error-store.mjs

@@ -64,14 +64,30 @@ const DEFINITIONS = Object.freeze({
     template: 'Throughline Codex hook processing failed',
   }),
   // Codex Stop の取り込みは済み、L1 要約の backend（Codex CLI）だけが失敗した（ADR 0028）。
+  // 0.16.4 からは数えない（ADR 0041）。1回ごとの失敗は、通信の断・利用上限・取り消しでも起き、次の Stop がやり直す。
+  // 前の版が記録した store を読める様に、定義は残す。
   L1_SUMMARIZER_BACKEND_FAILED: Object.freeze({
     component: 'codex_l1_summarizer',
     // BugHub が受ける severity は fatal・high・warn・info だけ。他の値は report 全体が 422 になる。
     severity: 'warn',
     template: 'Throughline L1 summarizer backend (Codex CLI) failed',
   }),
+  // L1 要約の backend が失敗し、最初の失敗から24時間を過ぎても成功を確認できていない（ADR 0041）。
+  // 記憶は失われていない（取り込みは済み、recall は L2 を返す）。要約が成功した時に、recovered で解決にする。
+  L1_SUMMARIZER_BACKEND_UNRECOVERED: Object.freeze({
+    component: 'codex_l1_summarizer',
+    severity: 'warn',
+    template: 'Throughline L1 summarizer backend (Codex CLI) has not recovered for over 24 hours',
+  }),
 });
 
+/** 定型 code の fingerprint。記録は code ごとに1つ。 */
+export function runtimeErrorFingerprint(code) {
+  const definition = DEFINITIONS[code];
+  if (!definition) throw new TypeError('未登録の runtime error code です');
+  return createHash('sha256').update(['throughline', definition.component, code, definition.template].join('\0')).digest('hex');
+}
+
 export function defaultRuntimeErrorConfigPath(env = process.env) {
   if (isWindows(env)) {
     return join(windowsLocalAppData(env), 'throughline', 'runtime-errors.config.json');
@@ -143,9 +159,7 @@ export function observeRuntimeError(input, options = {}) {
   return withStoreLock(options, (privateDirectory) => {
     const now = normalizeTimestamp(input.now);
     const version = normalizeVersion(options.version ?? PACKAGE_VERSION);
-    const fingerprint = createHash('sha256')
-      .update(['throughline', definition.component, input.code, definition.template].join('\0'))
-      .digest('hex');
+    const fingerprint = runtimeErrorFingerprint(input.code);
     const store = readStore(options, { privateDirectory });
     const existing = store.records.find((record) => record.fingerprint === fingerprint);
     const sequence = nextSequence(store);
@@ -307,10 +321,15 @@ export function getRuntimeErrorDiagnostics(options = {}) {
   }
 }
 
+/** 復帰を確認できた記録を、recovered で解決にする。記録が無い時と、解決済みの時は何もしない。 */
+export function resolveRecoveredRuntimeErrorBestEffort(code, options = {}) {
+  return recordRuntimeErrorBestEffort(code, { ...options, action: 'recovered' });
+}
+
 export function recordRuntimeErrorBestEffort(code, options = {}) {
-  const { stderr = process.stderr, ...storeOptions } = options;
+  const { stderr = process.stderr, action = null, ...storeOptions } = options;
   try {
-    const child = childProcess.spawnSync(process.execPath, [fileURLToPath(new URL('./runtime-error-observer.mjs', import.meta.url)), code], {
+    const child = childProcess.spawnSync(process.execPath, [fileURLToPath(new URL('./runtime-error-observer.mjs', import.meta.url)), code, ...(action ? [action] : [])], {
       env: storeOptions.env ?? process.env,
       encoding: 'utf8',
       stdio: 'ignore',