throughline 0.10.17 → 0.10.18

package/.codex-sidecar.yml

@@ -9,7 +9,6 @@ safety_profile: claude-hook-package
 
 allowed_paths:
   - AGENTS.md
-  - CLAUDE.md
   - README.md
   - README.ja.md
   - CHANGELOG.md

package/CHANGELOG.md

@@ -10,6 +10,18 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.18] — 2026-09-23
+
+### 修正
+
+- runtime snapshotに実発生時の`product_version`を公開し、取得時の導入版と区別する。snapshotによる件数・時刻・発生版の変更は行わない。
+- L2のuser本文から端末制御を落とす。色・cursor移動・private mode・OSC（Windows ConPTYのtitle等）を除き、CRLFはLFに、行内のCR上書きは最後の表示だけにする。L3のtool出力にも同じ処理を使う。
+- Claude Codeの背景task通知は、状態・要約・Monitorのevent・subagentのresultだけを記憶に残す。識別子・出力path・定型の注記と、入力待ち時に付く端末の生出力は落とす。
+
+### 変更
+
+- npm公開をTrusted Publishingへ移した。既定ブランチへ着地したrelease commitに`v<version>` tagをpushすると、`.github/workflows/publish.yml`が公開する。
+
 ## [0.10.17] — 2026-09-12
 
 ### 修正
@@ -1466,7 +1478,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.17...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.18...HEAD
+[0.10.18]: https://github.com/kitepon/Throughline/compare/v0.10.17...v0.10.18
 [0.10.17]: https://github.com/kitepon/Throughline/compare/v0.10.16...v0.10.17
 [0.10.16]: https://github.com/kitepon/Throughline/compare/v0.10.15...v0.10.16
 [0.10.15]: https://github.com/kitepon/Throughline/compare/v0.10.14...v0.10.15

package/docs/00_overview.md

@@ -8,8 +8,7 @@ Throughline の文書は、現行契約・履歴・証拠を分ける。通常
 | 文書 | 役割 |
 |---|---|
 | [../README.md](../README.md) / [../README.ja.md](../README.ja.md) | 利用者向けの導入、設定、コマンド、状態、診断、復旧、更新 |
-| [CLAUDE.md](https://github.com/kitepon/Throughline/blob/main/CLAUDE.md) | Claude Code 作業者向けの製品正本 |
-| [AGENTS.md](https://github.com/kitepon/Throughline/blob/main/AGENTS.md) | Codex など Claude Code 以外の作業者向け入口 |
+| [AGENTS.md](https://github.com/kitepon/Throughline/blob/main/AGENTS.md) | 全 host の作業者向けの製品正本 |
 | [01_l1_l2_l3_redesign.md](01_l1_l2_l3_redesign.md) | L1/L2/L3 記憶レイヤーの設計 |
 | [02_clear_auto_handoff_plan.md](02_clear_auto_handoff_plan.md) | `/clear` / `/tl` handoff の現行仕様 |
 | [04_public_release_plan.md](04_public_release_plan.md) | 公開配布、明示的失敗、release gate |

package/docs/04_public_release_plan.md

@@ -61,13 +61,13 @@ Windows PowerShell 5.1へ切り替えない。更新前CLIを再利用せず、
 
 release候補は次の全条件を満たしたときだけ公開する。
 
-1. `package.json` と `CHANGELOG.md` の候補版が一致し、READMEとCLAUDE.mdが版の正本を参照する。
+1. `package.json` と `CHANGELOG.md` の候補版が一致し、READMEとAGENTS.mdが版の正本を参照する。
    schema・host契約も実装と一致し、`npm run verify:docs` が全Markdownと梱包内リンクを検査する。
 2. 変更に直結するfocused testがgreenで、その後に `npm test` を最終確認として1回通す。
 3. `npm run verify:release-commit` が、clean working treeかつHEADが`origin`既定ブランチの
    祖先であることを確認する。既定ブランチへ着地していないcommitからpublishしない。
 4. `npm pack --dry-run`でtarball内容、秘密混入、必要なREADME/docsの収録を確認する。
-5. npm publish後にregistryのversionとshasum、tag、GitHub Releaseを確認する。
+5. 公開は既定ブランチへ着地したrelease commitへ`v<version>` tagをpushし、`.github/workflows/publish.yml`がnpm Trusted Publishingで行う。手元から`npm publish`しない。公開後にregistryのversionとshasum、tag、GitHub Releaseを確認する。
 6. registry由来の隔離installで `throughline --version`、`throughline install`、
    `throughline migrate --json`、`throughline doctor`を確認する。
 7. 変更したhost面で実captureまたはfocused install/diagnostics smokeを行う。

package/docs/05_codex_first_roadmap.md

@@ -15,7 +15,7 @@
 | [08_codex_dual_support.md](08_codex_dual_support.md) | Claude / Codex 両対応の architecture brief。adapter 境界の基本方針として維持する |
 | [09_rollback_context_trim_insight.md](09_rollback_context_trim_insight.md) | rollback / rewind を context delete primitive と見る設計メモ |
 | [04_public_release_plan.md](04_public_release_plan.md) | 公開配布の状態表。実装済み behavior だけを公開説明に出す |
-| [CLAUDE.md](https://github.com/kitepon/Throughline/blob/main/CLAUDE.md) / [AGENTS.md](https://github.com/kitepon/Throughline/blob/main/AGENTS.md) | 作業者向け入口。Claude 正本を守りつつ、この文書を次フェーズ計画として参照する |
+| [AGENTS.md](https://github.com/kitepon/Throughline/blob/main/AGENTS.md) | 作業者向け入口。Claude 正本を守りつつ、この文書を次フェーズ計画として参照する |
 
 この文書は、以後の実装順について [archive/07_codex_trim_implementation_plan.md](archive/07_codex_trim_implementation_plan.md) を上書きする。
 ただし、Claude primary を壊さない、Claude hooks / `/tl` / baton / DB / resume context を Codex 用に置き換えない、という既存の絶対条件は維持する。
@@ -75,7 +75,7 @@ Codex 側で再実装しないこと:
 
 1. この `新セッション引き継ぎ` を読む。
 2. Codex 側をやり直さず、Claude `/rewind conversation only` の手動 UX 確認へ進む。
-3. Claude 側に触る前に [CLAUDE.md](https://github.com/kitepon/Throughline/blob/main/CLAUDE.md) を読む。
+3. Claude 側に触る前に [AGENTS.md](https://github.com/kitepon/Throughline/blob/main/AGENTS.md) を読む。
 4. Codex rollback incident の追加診断が必要な場合だけ、[06_codex_trim_rollback_fix_plan.md](06_codex_trim_rollback_fix_plan.md) の Phase 4 を参照する。
 5. `.claude/settings.json` はユーザー環境差分を含み得るため、明示依頼なしに整理・置換しない。
 
@@ -103,7 +103,7 @@ Codex 側で再実装しないこと:
 ## 絶対に守ること
 
 - Claude の設定を Codex 用に置き換えない。
-- `CLAUDE.md` は Claude 正本として維持し、`AGENTS.md` は Codex / agent 向けの参照入口として扱う。
+- `AGENTS.md` を全 host 共通の作業者向け正本とし、Claude 契約を守る規則もそこに置く。
 - Claude hooks / slash command / transcript parser / baton / resume context の既存 semantics を rename しない。
 - Codex 対応は adapter / bridge / Codex primary entrypoint として足す。
 - Codex CLI / app-server / rollout の仕様は実測で固定する。未確認の host behavior を成功扱いにしない。

package/package.json

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

package/src/docs-contract.test.mjs

@@ -64,7 +64,7 @@ test('現行文書は版の正本を参照し、変更履歴は候補版と一
   const version = packageJson.version;
   const currentSources = [
     readFileSync(new URL('../README.md', import.meta.url), 'utf8'),
-    readFileSync(new URL('../CLAUDE.md', import.meta.url), 'utf8'),
+    readFileSync(new URL('../AGENTS.md', import.meta.url), 'utf8'),
     readFileSync(new URL('../docs/04_public_release_plan.md', import.meta.url), 'utf8'),
   ];
   for (const source of currentSources) {

package/src/hosts/claude.mjs

@@ -6,6 +6,25 @@
  */
 import { CLAUDE_HOST, hostOfSessionId } from './identity.mjs';
 
+// Claude Code の背景 task 通知は user 発言として transcript に入る。識別子・出力 path・
+// 定型の注記と、入力待ち時に付く端末の生出力 (`Last output:` 以降) は記憶に要らない。
+// 状態・要約・Monitor の event・subagent の result だけを残す。
+const TASK_NOTIFICATION_NOISE_TAGS = ['task-id', 'tool-use-id', 'output-file', 'usage', 'note', 'task-type', 'diagnostics'];
+
+export function compactClaudeTaskNotification(text) {
+  if (typeof text !== 'string' || !text.trimStart().startsWith('<task-notification>')) return text;
+  const close = text.indexOf('</task-notification>');
+  if (close < 0) return text;
+  let block = text.slice(0, close + '</task-notification>'.length);
+  for (const tag of TASK_NOTIFICATION_NOISE_TAGS) {
+    block = block.replace(new RegExp(`\\n?<${tag}>[\\s\\S]*?</${tag}>`, 'g'), '');
+  }
+  const tail = text.slice(close + '</task-notification>'.length);
+  const lastOutput = tail.search(/^Last output:/m);
+  const kept = (lastOutput < 0 ? tail : tail.slice(0, lastOutput)).trim();
+  return kept ? `${block}\n${kept}` : block;
+}
+
 export const claudeHostAdapter = Object.freeze({
   host: CLAUDE_HOST,
   matchesSessionId: (sessionId) => hostOfSessionId(sessionId) === CLAUDE_HOST,

package/src/runtime-error-store.mjs

@@ -530,6 +530,7 @@ function toPublicRuntimeError(record) {
     occurrence_count: record.count,
     first_seen: record.first_seen,
     last_seen: record.last_seen,
+    product_version: record.product_version,
     state_schema_version: record.state_schema_version,
   };
 }

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

@@ -44,6 +44,17 @@ function enableCollection(box) {
   applyWindowsPrivateAcl(box.configPath);
 }
 
+test('発生版は直近の発生で更新し、snapshotの実行版から推測しない', () => {
+  const box = sandbox(); enableCollection(box);
+  observeRuntimeError({ code: 'HOOK_PROCESS_TURN_FAILED', now: '2026-09-01T00:00:00.000Z' }, { env: box.env, version: '1.0.0' });
+  assert.equal(readRuntimeErrorSnapshot({ env: box.env, version: '2.0.0' }).runtime_errors[0].product_version, '1.0.0');
+  observeRuntimeError({ code: 'HOOK_PROCESS_TURN_FAILED', now: '2026-09-02T00:00:00.000Z' }, { env: box.env, version: '2.0.0' });
+  const entry = readRuntimeErrorSnapshot({ env: box.env, version: '3.0.0' }).runtime_errors[0];
+  assert.equal(entry.product_version, '2.0.0');
+  assert.equal(entry.occurrence_count, 2);
+  assert.equal(entry.last_seen, '2026-09-02T00:00:00.000Z');
+});
+
 test('runtime error store: missing/false/malformed config is fail-closed and creates no state', () => {
   for (const config of [
     null,
@@ -232,6 +243,7 @@ test('runtime error store: fixed template SHA-256 fingerprint aggregates and reo
     occurrence_count: 2,
     first_seen: '2026-07-13T00:00:00.000Z',
     last_seen: '2026-07-13T00:01:00.000Z',
+    product_version: '0.6.1',
     state_schema_version: '1.0',
   });
 

package/src/transcript-reader.mjs

@@ -10,6 +10,7 @@
 
 import { readFileSync, existsSync } from 'fs';
 import { DETAIL_KIND } from './constants.mjs';
+import { compactClaudeTaskNotification } from './hosts/claude.mjs';
 
 function entryKind(entry) {
   if (typeof entry?.type === 'string' && entry.type.length > 0) return entry.type;
@@ -71,7 +72,12 @@ export function readTranscript(transcriptPath) {
     const rawContent = msg?.content ?? grokContent;
     if (!role || rawContent == null) continue;
 
-    const text = extractText(rawContent);
+    const extracted = extractText(rawContent);
+    // user 発言には端末の生出力 (貼り付け・Claude の task 通知) が入る。記憶には
+    // 制御文字を落とした本文だけを残す。
+    const text = role === 'user'
+      ? normalizeTerminalText(compactClaudeTaskNotification(extracted))
+      : extracted;
     if (!text) continue;
 
     const ts = typeof entry.timestamp === 'string' ? Date.parse(entry.timestamp) : NaN;
@@ -185,14 +191,30 @@ export function readLatestLogicalTurnCompletion(transcriptPath) {
 }
 
 /**
- * ANSI エスケープシーケンスを除去する。
- * ツール出力（特に Bash）にしばしば含まれる色コードを剥がす。
+ * 端末出力の制御を除いて、画面に残る文字列にする。
+ * - ESC 系列: OSC (window title 等。Windows ConPTY が出す)、DCS/SOS/PM/APC、
+ *   CSI (色・cursor 移動・private mode)、その他の 2 byte 以上の ESC 系列。
+ * - 改行: CRLF は LF にし、行内の CR は上書き表示として最後の区間だけを残す。
  * @param {string} s
  */
-export function stripAnsi(s) {
+export function normalizeTerminalText(s) {
   if (typeof s !== 'string') return s;
-  // eslint-disable-next-line no-control-regex
-  return s.replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, '');
+  /* eslint-disable no-control-regex */
+  const stripped = s
+    .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
+    .replace(/\x1b[PX^_][^\x1b]*\x1b\\/g, '')
+    .replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, '')
+    .replace(/\x1b[ -/]*[0-~]/g, '');
+  /* eslint-enable no-control-regex */
+  return stripped
+    .replace(/\r\n/g, '\n')
+    .split('\n')
+    .map((line) => {
+      if (!line.includes('\r')) return line;
+      const segments = line.split('\r').filter((segment) => segment.length > 0);
+      return segments.length ? segments[segments.length - 1] : '';
+    })
+    .join('\n');
 }
 
 /**
@@ -378,7 +400,7 @@ export function extractDetailBlocks(turnEntries) {
             tool_name: toolName,
             source_id: toolUseId ? `${toolUseId}:result` : null,
             input_text: null,
-            output_text: stripAnsi(rawOutput),
+            output_text: normalizeTerminalText(rawOutput),
           });
         } else if (b.type === 'image') {
           out.push({
@@ -419,7 +441,7 @@ export function extractDetailBlocks(turnEntries) {
         tool_name: toolName,
         source_id: e.uuid ?? null,
         input_text: a.command ?? a.path ?? null,
-        output_text: stripAnsi(String(output)),
+        output_text: normalizeTerminalText(String(output)),
       });
     }
     // type === 'system' (stop_hook_summary) や queue-operation / file-history-snapshot は skip

package/src/transcript-reader.test.mjs

@@ -1,17 +1,88 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
 import {
-  stripAnsi,
+  normalizeTerminalText,
   normalizeToolResultContent,
+  readTranscript,
   sliceCurrentTurnEntries,
   extractDetailBlocks,
 } from './transcript-reader.mjs';
 import { DETAIL_KIND } from './constants.mjs';
 
-test('stripAnsi: ANSI 色コードを除去する', () => {
-  assert.equal(stripAnsi('\x1b[32mgreen\x1b[0m text'), 'green text');
-  assert.equal(stripAnsi('plain'), 'plain');
-  assert.equal(stripAnsi(''), '');
+test('normalizeTerminalText: ANSI 色コードを除去する', () => {
+  assert.equal(normalizeTerminalText('\x1b[32mgreen\x1b[0m text'), 'green text');
+  assert.equal(normalizeTerminalText('plain'), 'plain');
+  assert.equal(normalizeTerminalText(''), '');
+});
+
+test('normalizeTerminalText: cursor 移動・private mode・OSC・2 byte ESC を除去する', () => {
+  // npm の spinner (macOS 実測) と Windows ConPTY の title / cursor 表示切替
+  assert.equal(normalizeTerminalText('\x1b[1G\x1b[0K|\x1b[1G\x1b[0Jdone\x1b[38G'), '|done');
+  assert.equal(normalizeTerminalText('\x1b]0;C:\\Windows\\pwsh.exe\x07\x1b[?25lok\x1b[?25h'), 'ok');
+  assert.equal(normalizeTerminalText('\x1b]8;;https://e.x\x1b\\link\x1b]8;;\x1b\\'), 'link');
+  assert.equal(normalizeTerminalText('\x1b(Bx\x1b7y\x1b8'), 'xy');
+});
+
+test('normalizeTerminalText: CRLF を LF にし、行内 CR は最後の上書きだけを残す', () => {
+  assert.equal(normalizeTerminalText('a\r\nb\r\n'), 'a\nb\n');
+  assert.equal(normalizeTerminalText('10%\r50%\r100%\nnext'), '100%\nnext');
+  assert.equal(normalizeTerminalText('line\r'), 'line');
+});
+
+function writeTranscript(entries) {
+  const dir = mkdtempSync(join(tmpdir(), 'tl-transcript-'));
+  const path = join(dir, 't.jsonl');
+  writeFileSync(path, entries.map((e) => JSON.stringify(e)).join('\n') + '\n');
+  return path;
+}
+
+test('readTranscript: Claude task 通知は識別子・path・端末生出力を落として残す', () => {
+  const notice = [
+    '<task-notification>',
+    '<task-id>b1</task-id>',
+    '<tool-use-id>toolu_1</tool-use-id>',
+    '<output-file>/tmp/tasks/b1.output</output-file>',
+    '<status>completed</status>',
+    '<summary>Background command "x" completed (exit code 0)</summary>',
+    '<result>subagent report</result>',
+    '<usage><subagent_tokens>1</subagent_tokens></usage>',
+    '<note>A task-notification fires each time this agent stops.</note>',
+    '</task-notification>',
+    'Last output:',
+    '\x1b[34mEstablishing\x1b[39m\r\nPress ENTER',
+    '',
+    'The command is likely blocked on an interactive prompt.',
+  ].join('\n');
+  const path = writeTranscript([
+    { type: 'user', message: { role: 'user', content: notice } },
+    { type: 'assistant', message: { role: 'assistant', content: [{ type: 'text', text: '\x1b[1mkeep\x1b[0m' }] } },
+  ]);
+  const [user, assistant] = readTranscript(path);
+  assert.equal(
+    user.content,
+    [
+      '<task-notification>',
+      '<status>completed</status>',
+      '<summary>Background command "x" completed (exit code 0)</summary>',
+      '<result>subagent report</result>',
+      '</task-notification>',
+    ].join('\n'),
+  );
+  // assistant 本文は Stop payload との照合に使うため変えない
+  assert.equal(assistant.content, '\x1b[1mkeep\x1b[0m');
+});
+
+test('readTranscript: task 通知の後ろの system-reminder と通常の user 発言は残す', () => {
+  const path = writeTranscript([
+    { type: 'user', message: { role: 'user', content: '<task-notification>\n<task-id>b2</task-id>\n<summary>s</summary>\n</task-notification>\n<system-reminder>r</system-reminder>' } },
+    { type: 'user', message: { role: 'user', content: [{ type: 'text', text: '貼った出力 \x1b[31mERR\x1b[0m' }] } },
+  ]);
+  const [notice, typed] = readTranscript(path);
+  assert.equal(notice.content, '<task-notification>\n<summary>s</summary>\n</task-notification>\n<system-reminder>r</system-reminder>');
+  assert.equal(typed.content, '貼った出力 ERR');
 });
 
 test('normalizeToolResultContent: string / array / image mix', () => {