throughline 0.10.13 → 0.10.15

package/CHANGELOG.md

@@ -10,6 +10,25 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.15] — 2026-09-06
+
+### Fixed
+
+- Windowsでnpmから導入したCodexをThroughlineの新規タスク引き継ぎと診断から起動できるようにした。
+  OS境界の起動処理を通し、PowerShell 7経由の標準入出力をUTF-8で受け渡す。
+- Windowsの起動試験を通常のテストと製品CIへ含め、日本語と接続中の要求・応答を検証する。
+- Windowsの起動条件、Codexフックの承認、既存ログの回収を文書化した。
+  自動refreshの古い案内を直し、公開版と開発中の版の参照先を分けた。
+
+## [0.10.14] — 2026-09-02
+
+### Added
+
+- `handoff-context --project <path> --json`で、指定project内の会話本文を持つ最新sessionを
+  read-onlyで選び、本文がなければ`empty`を返せるようにした。
+- `--disclosure silent`を補足ファイルなしで指定できるようにし、埋込製品が短期記憶だけを
+  基盤案内なしで受け取れるようにした。
+
 ## [0.10.13] — 2026-09-02
 
 ### Fixed
@@ -1430,7 +1449,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.13...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.15...HEAD
+[0.10.15]: https://github.com/kitepon/Throughline/compare/v0.10.14...v0.10.15
+[0.10.14]: https://github.com/kitepon/Throughline/compare/v0.10.13...v0.10.14
 [0.10.13]: https://github.com/kitepon/Throughline/compare/v0.10.12...v0.10.13
 [0.10.12]: https://github.com/kitepon/Throughline/compare/v0.10.11...v0.10.12
 [0.10.11]: https://github.com/kitepon/Throughline/compare/v0.10.10...v0.10.11

package/README.ja.md

@@ -75,8 +75,9 @@ cwd は源セッションの `project_path` であり、呼び出し元 cwd は
 macOS Terminal のみ。
 
 通常のhandoff-contextは、引き継いだことを最初の応答で一度だけ案内し、後続応答では
-繰り返させない。project束縛済み補足へ`handoffDisclosure: "silent"`を指定した埋込製品だけは
-案内を出さない。旧版がassistant本文へ付けた固定宣言は次回引き継ぎから除外し、ユーザーの
+繰り返させない。埋込製品は`handoff-context --disclosure silent`で案内を消せる。
+project束縛済み補足の`handoffDisclosure: "silent"`も同じ扱いになる。旧版がassistant本文へ
+付けた固定宣言は次回引き継ぎから除外し、ユーザーの
 引用と実際の応答本文は保持する。
 
 新席は `~/.grok/sessions/<encodeURIComponent(cwd)>/` のトップレベル
@@ -101,6 +102,11 @@ current-thread rollback
 診断が要る時だけ明示的に `trim --execute --host codex` を使う。既存の
 非 Throughline Codex hook は保持される。
 
+登録後は `throughline doctor --codex` で承認状態も確認する。未承認のフックは
+Codexのフック承認画面で利用者が承認する。Throughlineは承認状態を書き換えない。
+Windowsの起動条件と、記録が見つからない場合の確認手順は
+[Codexの診断と復旧](README.md#codex-windows)を参照。
+
 </details>
 
 ## 他の手段との比較
@@ -395,7 +401,7 @@ v0.10.4以前には `self-update` が存在しない。該当版からの初回
 | `throughline runtime-errors snapshot --json` | boundedなlocal aggregateを読み取る（network I/Oなし） |
 | `throughline runtime-errors diagnostics --json` | collection/store状態をpathやraw errorなしで診断 |
 | `throughline handoff-preview --session <id>` | Codex 向け `throughline_handoff` JSON projection を表示 |
-| `throughline handoff-context --session <id> --json [--supplement-file <path>]` | SessionStartと同じ引き継ぎ文脈を取得。任意のproject束縛済み補足を、長期記憶・知識として同じ9,500字枠へ合成できる |
+| `throughline handoff-context (--session <id> \| --project <path>) --json` | SessionStartと同じ引き継ぎ文脈を取得。project指定時は会話本文を持つ最新sessionを選び、`--disclosure silent`に対応し、本文がなければ`empty`を返す。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 codex-sidecar-diagnostics` | この project の `codex-sidecar` diagnostics status を確認 |
@@ -428,15 +434,18 @@ throughline runtime-errors diagnostics --json
 
 ```bash
 throughline handoff-context --session codex:<thread-id> --json
+throughline handoff-context --project /absolute/bot/project --json --disclosure silent
 ```
 
-成功時の`throughline.handoff_context.v1`は`schema`、`status`、`sessionId`、`context`だけを返す。
-`context`はSessionStartと同じ予算付き継承文脈である。任意の`--supplement-file <path>`には
+`throughline.handoff_context.v1`は`schema`、`status`、`sessionId`、`context`だけを返す。
+`--project`ではそのproject内で会話本文を持つ最新sessionを選び、存在しなければ`empty`を返す。
+`--disclosure silent`は長期記憶を追加せずThroughlineの案内を消す。`context`はSessionStartと
+同じ予算付き継承文脈である。`--session`で使える任意の`--supplement-file <path>`には
 `throughline.handoff_supplement.v1`、源sessionと同じ`projectPath`、`title`と`content`からなる
 `sections`を指定する。任意の`handoffDisclosure`は`visible`（既定）または`silent`を受け取る。
 補足は会話記憶と同じ9,500字枠へ入り、別projectの補足は拒否する。
 DB作成・migration・baton消費・session merge・
-latest session推測・`sessions.merged_into`変更・L1/L2/L3 rowの所属変更は行わない。AItermは任意の
+`sessions.merged_into`変更・L1/L2/L3 rowの所属変更は行わない。AItermは任意の
 別harness portable forkでこの境界を使う。Observer feedはcompleted-turn projectionであり代替ではない。
 
 スラッシュコマンド (Claude Code 内でユーザーが叩く):
@@ -460,6 +469,7 @@ latest session推測・`sessions.merged_into`変更・L1/L2/L3 rowの所属変
 - **Codex CLI ログイン**（既定の L1 要約 backend、`gpt-5.6-luna`）または
   **Claude Max サブスクリプション**（`claude -p` 経由の Haiku fallback）— どちらも API キー不要
 - 対応 OS: **Windows / macOS / Linux**
+- Windowsでnpm版Codexを起動する場合は **PowerShell 7**（`pwsh.exe`）がPATHに必要。
 
 ランタイム依存 **ゼロ**。npm パッケージは純 `.mjs` ファイルのみで構成されています。
 

package/README.md

@@ -72,6 +72,8 @@ DB handoff memory as a developer item, and opens that thread in the selected
 host; ask explicitly for current-thread rollback diagnostics when you want the
 guarded `trim --execute --host codex` surface.
 
+フック登録後の承認とWindowsでの起動条件は、[Codexの診断と復旧](#codex-windows)を参照。
+
 </details>
 
 <details>
@@ -817,7 +819,7 @@ entry to the `tasks` array yourself:
 
 ## Commands
 
-**The current release is v0.10.13.** Throughline supports Claude Code, Codex,
+公開版は冒頭のnpmバッジ、開発中の版は `package.json`、版ごとの変更は [CHANGELOG.md](CHANGELOG.md) を参照。Throughline supports Claude Code, Codex,
 Grok, and Cursor as documented host adapters. The versioned, read-only
 `handoff-context` boundary opens only an existing database and leaves baton
 state, session ownership, and memory rows unchanged. Factory diagnostics,
@@ -826,8 +828,9 @@ under the same explicit-failure and local-only contracts.
 
 Normal handoffs announce inherited continuity once in the first response and
 explicitly forbid repeating that line in later responses. A project-bound
-supplement may set `handoffDisclosure` to `silent` for an embedded product that
-keeps continuity metadata out of its chat. Legacy Throughline disclosure lines
+launcher may pass `--disclosure silent` for an embedded product that keeps
+continuity metadata out of its chat. A supplement may also set
+`handoffDisclosure` to `silent`. Legacy Throughline disclosure lines
 in assistant memory are omitted from the next handoff; user quotations and the
 actual reply body remain intact.
 
@@ -862,7 +865,7 @@ once with `npm install --global throughline@latest`, then run
 | `throughline runtime-errors reopen <fingerprint> --json` | Explicitly reopen a resolved aggregate without fabricating a new occurrence |
 | `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 [--supplement-file <path>]` | Print the SessionStart inheritance context without moving memory rows; an optional project-bound supplement adds long-term memory and knowledge inside the same 9,500-character budget |
+| `throughline handoff-context (--session <id> \| --project <path>) --json` | Print the SessionStart inheritance context without moving memory rows. Project mode selects the newest captured session with dialogue, supports `--disclosure silent`, and returns `empty` when no dialogue exists. Session mode may add a project-bound supplement inside the same 9,500-character budget |
 | `throughline latest-session --project <absolute-path> --json` | Read the latest session id strictly scoped to one project; opens the existing database read-only and returns `empty` when the project has no captured session |
 | `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 |
@@ -912,11 +915,15 @@ performing a normal handoff:
 
 ```bash
 throughline handoff-context --session codex:<thread-id> --json
+throughline handoff-context --project /absolute/bot/project --json --disclosure silent
 ```
 
-The successful `throughline.handoff_context.v1` object contains only `schema`,
-`status`, `sessionId`, and `context`. The context is the same budgeted
-inheritance text used by SessionStart. A launcher may append
+The `throughline.handoff_context.v1` object contains only `schema`, `status`,
+`sessionId`, and `context`. With `--project`, Throughline selects the newest
+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
 `--supplement-file <path>` with a `throughline.handoff_supplement.v1` JSON object:
 
 ```json
@@ -936,7 +943,7 @@ The supplement is included only when `projectPath` matches the source session
 and shares the 9,500-character budget with conversation memory. If the captured
 session has no dialogue context yet, a valid project-bound supplement is returned
 by itself. The command does not create or migrate a
-database, consume a baton, merge sessions, infer a latest session, change
+database, consume a baton, merge sessions, change
 `sessions.merged_into`, or reassign L1/L2/L3 rows. AIterm uses this boundary for
 its optional cross-harness portable fork; the Observer feed is a separate
 completed-turn projection and is not a substitute.
@@ -1113,6 +1120,24 @@ See [`src/haiku-summarizer.mjs`](src/haiku-summarizer.mjs) for the implementatio
 
 ## Troubleshooting
 
+<a id="codex-windows"></a>
+
+### Codexの診断と復旧（Windowsを含む）
+
+Windowsでnpm版Codexを使う場合、`codex` とPowerShell 7の `pwsh.exe` がPATHに必要。
+Throughlineはnpmが生成したPowerShell起動ファイルを使い、引数と標準入出力を
+UTF-8で渡す。macOS/Linuxの起動方法は変わらない。
+
+引き継ぐ記録が見つからない場合は、対象プロジェクトで `throughline doctor --codex` を実行する。
+登録済みでも未承認のフックは動作しないため、Codexのフック承認画面で利用者が承認する。
+Throughlineのinstallや更新は、その承認を代行しない。
+
+旧版を使っている場合は、[更新手順](docs/04_public_release_plan.md#製品単独運用)で更新する。
+未承認期間の既存ログを回収する必要がある場合は、対象IDを確定して
+`throughline codex-capture --codex-thread-id <id> --json` を実行する。
+その後、通常のターン終了で記録が増えることを確認する。一度の手動回収を
+自動記録の復旧とは扱わない。現在のタスクへのrollbackや注入は復旧手順に含めない。
+
 ### Claude Code Desktop `/clear`
 
 Automatic inheritance (the auto path) does not fire for `/clear` in Claude Code Desktop: the client does not send `source="clear"` and also mislabels the SessionEnd `reason` as `"other"`. This is reported upstream in [anthropics/claude-code#76704](https://github.com/anthropics/claude-code/issues/76704). On Desktop, run `/tl` before `/clear` (the baton lasts one hour). The 0.6.0 backfill work means this `/tl` handoff carries complete L2 through the immediately preceding turn. The VS Code extension's `/clear` auto-handoff works normally.

package/bin/throughline.mjs

@@ -11,7 +11,7 @@
  *   throughline detail <時刻> # 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> --json [--supplement-file <path>] # Read-only inheritance context JSON
+ *   throughline handoff-context (--session <id> | --project <path>) --json # Read-only inheritance context JSON
  *   throughline latest-session --project <path> --json # Latest session strictly scoped to one project
  *   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
@@ -236,10 +236,12 @@ Usage:
   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 handoff-preview   Print Codex-facing throughline_handoff JSON
-  throughline handoff-context --session <id> --json [--supplement-file <path>]
+  throughline handoff-context (--session <id> | --project <path>) --json
                               Print the exact inheritance context without
-                              changing database ownership; optionally include
-                              project-bound long-term memory and knowledge
+                              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
   throughline latest-session --project <absolute-path> --json
                               Read the latest session id for exactly one project
   throughline grok-continue --session <id>

package/docs/04_public_release_plan.md

@@ -6,7 +6,7 @@
 
 ## 現行状態
 
-- release candidateのpackage版は `0.10.13`。tagとnpmの公開確認はpublish後に行う。
+- 候補の版は `package.json`、公開版はnpm registryを正とする。tagとnpmの一致はpublish後に確認する。
 - Claude Code、Codex、Grok、Cursorをfirst-class hostとして扱う。
 - 現行DB schemaはv9。schemaの正本は [src/db.mjs](../src/db.mjs) の
   `CURRENT_VERSION`、二相handoffの判断は
@@ -58,7 +58,8 @@ Windows PowerShell 5.1へ切り替えない。更新前CLIを再利用せず、
 
 release候補は次の全条件を満たしたときだけ公開する。
 
-1. `package.json`、`CHANGELOG.md`、README、CLAUDE.mdの現行版・schema・host契約が一致する。
+1. `package.json` と `CHANGELOG.md` の候補版が一致し、READMEとCLAUDE.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しない。
@@ -76,6 +77,8 @@ publish済みでも、上の確認が終わるまではrelease完了としない
 - Claude Code: user/project hooksとslash command。PATH解決型CLIを使う。
 - Codex: UserPromptSubmit / PostToolUse / Stop hook、feature flags、`$throughline` skill。
   絶対Node + installed CLI pathを使う。
+  登録と利用者の承認は別であり、未承認は `doctor --codex` で確認する。
+  Windowsのnpm版Codex起動は `src/os/portable-spawn-sync.mjs` が所有し、PowerShell 7を使う。
 - Grok: `~/.grok/hooks/throughline.json`と`grok-continue`。絶対pathを使う。
   Grok予約環境変数でhostを確定し、camelCase／snake_caseの属性名を同じ境界で正規化する。
 - Cursor: `~/.cursor/hooks.json`へsessionStart / beforeSubmitPrompt / stopをupsertし、

package/docs/05_codex_first_roadmap.md

@@ -22,6 +22,11 @@
 
 ## 現状認識
 
+Windowsの通常の新規タスク引き継ぎは実機確認済み。
+起動条件とフック承認は [README](../README.md#codex-windows)、
+当時の検証と未完了事項は [実測記録](https://github.com/kitepon/Throughline/blob/main/evidence/2026-09-06-windows-codex-handoff.md) を参照する。
+この確認は同一タスクのrollbackや自動記録の承認を保証しない。
+
 - Throughline 本体は、ほとんどが hook から起動されるローカル Node.js コードベースで動く。
 - 現行 Claude path は、Claude hooks、slash command、handoff baton、DB、resume context、L1 / L2 / L3 persistence で成立している。
 - 外部モデル的に呼ぶ主要箇所は L2 -> L1 要約。

package/docs/08_codex_dual_support.md

@@ -21,7 +21,10 @@
 
 Throughline は agent-neutral な handoff / context compression infrastructure になるべきです。
 
-Claude Code transcript と handoff behavior は守りつつ、Codex primary bridge と `codex-sidecar` 経由の compact context も生成できるようにします。現行の `HandoffRecord` は安定した中間表現だが、保存元はまだ Claude transcript 由来であり、Codex capture を実装して初めて source adapter が Codex 由来になる。
+Claude Code transcript と handoff behavior を維持し、Codex対応はadapterとして追加する。
+Codexの保存元は実装済みの `src/codex-capture.mjs` が読むrolloutであり、
+`codex:<thread_id>` の記憶を保存する。通常の引き継ぎは新規タスクへdeveloper itemを注入する。
+フック承認とWindows起動条件は [README](../README.md#codex-windows) を正とする。
 
 目指す形:
 
@@ -33,7 +36,7 @@ Claude Code transcript と handoff behavior は守りつつ、Codex primary brid
 ## 優先順位
 
 1. Throughline を Codex primary で使えるようにする。Codex primary の L2 -> L1 backend は Codex CLI を本線にする。
-2. Codex で Claude Rewind 相当の context trim を完成させる。2026-05-09 時点では Codex current-thread trim execute / auto-refresh は再有効化済みで、DB memory を必須にし、turn-count mismatch は diagnostics と app-server count 由来の rollback `numTurns` 補正に使う。
+2. Codexの同一タスクのtrimは明示的な診断として維持する。自動refreshは無効であり、通常の `$throughline` は新規タスクへ引き継ぐ。同一タスクでの継続的な使用量削減は保証しない。
 3. そのあと Claude 側の `/rewind` UX / 自動化 surface を詰める。
 
 Claude transcript handling の置き換えから始めないでください。Codex 対応は adapter / bridge / Codex primary entrypoint として追加します。

package/docs/adr/0023-handoff-disclosure-policy.md

@@ -20,8 +20,10 @@ Nターン分の記憶を引き継いだ」と応答冒頭で宣言させてい
 
 - 通常の引き継ぎは、引き継ぎの事実と保持ターン数を最初の応答で一度だけ案内する。
 - 同じhost sessionの2回目以降の応答では案内を繰り返させない。
-- project束縛済み`throughline.handoff_supplement.v1`は任意の`handoffDisclosure`として
-  `visible`（既定）または`silent`を持てる。`silent`を指定した埋込製品では案内しない。
+- `handoff-context`は`--disclosure visible|silent`を受け取り、`silent`を指定した埋込製品では
+  補足ファイルを作らずに案内を消せる。
+- project束縛済み`throughline.handoff_supplement.v1`も任意の`handoffDisclosure`として
+  `visible`（既定）または`silent`を持てる。
 - Throughline自身が旧版でassistantへ付けた固定宣言行は、後継へ渡すassistant本文から除外する。
 - ユーザー発言に含まれる同じ文字列は会話内容として保持する。
 - 引き継ぎの成立はsession対応、生成コンテキスト、継続応答の内容で検証する。宣言の反復を
@@ -30,6 +32,6 @@ Nターン分の記憶を引き継いだ」と応答冒頭で宣言させてい
 ## Consequences
 
 - 通常のThroughline利用では従来の引き継ぎ案内が残る。
-- 埋込製品は既存のproject分離境界を使って案内だけを非表示にできる。
+- 埋込製品はproject分離境界と公開CLI引数を使って案内だけを非表示にできる。
 - 旧宣言が保存済みのsessionも、次回の正規引き継ぎでメタ行を持ち越さない。
 - 保存済みの原会話は監査記録として変更しない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-    "version": "0.10.13",
+    "version": "0.10.15",
     "type": "module",
     "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
     "keywords": [
@@ -41,7 +41,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --import ./src/test-env.mjs --test scripts/verify-release-commit.test.mjs src/*.test.mjs src/cli/*.test.mjs src/hosts/*.test.mjs",
+    "test": "node --import ./src/test-env.mjs --test scripts/verify-release-commit.test.mjs src/*.test.mjs src/cli/*.test.mjs src/hosts/*.test.mjs src/os/*.test.mjs",
     "verify:docs": "node scripts/verify-docs.mjs && node scripts/verify-pack-markdown-links.mjs",
     "verify:release-commit": "node scripts/verify-release-commit.mjs",
     "prepublishOnly": "npm run verify:release-commit && npm test"

package/src/cli/handoff-context.mjs

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { isAbsolute, join } from 'node:path';
+import { isAbsolute, join, resolve } from 'node:path';
 
 import { sameProjectPath } from '../project-path.mjs';
 import { openReadOnlyDb } from '../db.mjs';
@@ -13,23 +13,50 @@ export const HANDOFF_CONTEXT_SCHEMA = 'throughline.handoff_context.v1';
 export const HANDOFF_SUPPLEMENT_SCHEMA = 'throughline.handoff_supplement.v1';
 
 export function parseArgs(argv = []) {
-  const baseArgsInvalid =
-    (argv.length !== 3 && argv.length !== 5) ||
-    argv[0] !== '--session' ||
+  if (
+    (argv[0] !== '--session' && argv[0] !== '--project') ||
     typeof argv[1] !== 'string' ||
     argv[1].length === 0 ||
-    argv[2] !== '--json';
-  const supplementArgsValid = argv.length === 3 || (
-    argv[3] === '--supplement-file' &&
-    typeof argv[4] === 'string' &&
-    argv[4].length > 0
-  );
-  if (baseArgsInvalid || !supplementArgsValid) {
+    argv[2] !== '--json' ||
+    argv.length % 2 === 0
+  ) {
     throw new TypeError('usage error');
   }
+
+  let supplementFile = null;
+  let handoffDisclosure = 'visible';
+  const seen = new Set();
+  for (let index = 3; index < argv.length; index += 2) {
+    const option = argv[index];
+    const value = argv[index + 1];
+    if (
+      seen.has(option) ||
+      typeof value !== 'string' ||
+      value.length === 0
+    ) {
+      throw new TypeError('usage error');
+    }
+    seen.add(option);
+    if (option === '--supplement-file') {
+      supplementFile = value;
+    } else if (option === '--disclosure' && ['visible', 'silent'].includes(value)) {
+      handoffDisclosure = value;
+    } else {
+      throw new TypeError('usage error');
+    }
+  }
+  if (
+    (argv[0] === '--project' && supplementFile) ||
+    (supplementFile && seen.has('--disclosure'))
+  ) {
+    throw new TypeError('usage error');
+  }
+
   return {
-    sessionId: argv[1],
-    supplementFile: argv.length === 5 ? argv[4] : null,
+    sessionId: argv[0] === '--session' ? argv[1] : null,
+    projectPath: argv[0] === '--project' ? resolve(argv[1]) : null,
+    supplementFile,
+    handoffDisclosure,
   };
 }
 
@@ -61,13 +88,14 @@ export function renderHandoffSupplement(value, projectPath) {
 export function readHandoffContext(sessionId, {
   dbPath = join(homedir(), '.throughline', 'throughline.db'),
   supplementFile = null,
+  handoffDisclosure = 'visible',
 } = {}) {
   if (!existsSync(dbPath)) return null;
 
   const db = openReadOnlyDb(dbPath);
   try {
     let supplementContext = null;
-    let handoffDisclosure = 'visible';
+    let resolvedHandoffDisclosure = handoffDisclosure;
     if (supplementFile) {
       const row = db.prepare(
         'SELECT project_path FROM sessions WHERE session_id = ?',
@@ -75,14 +103,14 @@ export function readHandoffContext(sessionId, {
       if (!row?.project_path) return null;
       const supplement = JSON.parse(readFileSync(supplementFile, 'utf8'));
       supplementContext = renderHandoffSupplement(supplement, row.project_path);
-      handoffDisclosure = supplement.handoffDisclosure ?? 'visible';
+      resolvedHandoffDisclosure = supplement.handoffDisclosure ?? handoffDisclosure;
     }
 
     const separator = supplementContext ? '\n\n' : '';
     const context = buildBudgetedResumeContext(db, {
       sessionId,
       isInheritance: true,
-      handoffDisclosure,
+      handoffDisclosure: resolvedHandoffDisclosure,
       maxChars: INJECTION_BUDGET_CHARS - (supplementContext?.length ?? 0) - separator.length,
     })?.text ?? null;
     if (!context && !supplementContext) return null;
@@ -99,6 +127,34 @@ export function readHandoffContext(sessionId, {
   }
 }
 
+export function readLatestProjectHandoffContext(projectPath, {
+  dbPath = join(homedir(), '.throughline', 'throughline.db'),
+  handoffDisclosure = 'visible',
+} = {}) {
+  if (!existsSync(dbPath)) return null;
+
+  const db = openReadOnlyDb(dbPath);
+  try {
+    const sessions = db.prepare(
+      `SELECT session_id, project_path
+       FROM sessions
+       ORDER BY updated_at DESC`,
+    ).all();
+    for (const session of sessions) {
+      if (!sameProjectPath(session.project_path, projectPath)) continue;
+      const context = buildBudgetedResumeContext(db, {
+        sessionId: session.session_id,
+        isInheritance: true,
+        handoffDisclosure,
+      })?.text ?? null;
+      if (context) return { sessionId: session.session_id, context };
+    }
+    return null;
+  } finally {
+    db.close();
+  }
+}
+
 export function readSessionProjectPath(sessionId, {
   dbPath = join(homedir(), '.throughline', 'throughline.db'),
 } = {}) {
@@ -122,26 +178,43 @@ export function run(argv = [], {
   stdout = process.stdout,
   stderr = process.stderr,
   readContext = readHandoffContext,
+  readProjectContext = readLatestProjectHandoffContext,
 } = {}) {
   let sessionId;
+  let projectPath;
   let supplementFile;
+  let handoffDisclosure;
   try {
-    ({ sessionId, supplementFile } = parseArgs(argv));
+    ({ sessionId, projectPath, supplementFile, handoffDisclosure } = parseArgs(argv));
   } catch {
     stderr.write(
-      'Usage: throughline handoff-context --session <id> --json [--supplement-file <path>]\n',
+      'Usage: throughline handoff-context (--session <id> | --project <path>) --json [--disclosure visible|silent | --supplement-file <path>]\n',
     );
     return 2;
   }
 
-  let context;
+  let result;
   try {
-    context = readContext(sessionId, { supplementFile });
+    result = projectPath
+      ? readProjectContext(projectPath, { handoffDisclosure })
+      : {
+          sessionId,
+          context: readContext(sessionId, { supplementFile, handoffDisclosure }),
+        };
   } catch {
     stderr.write('Throughline handoff context could not be read.\n');
     return 1;
   }
-  if (!context) {
+  if (!result?.context && projectPath) {
+    stdout.write(`${JSON.stringify({
+      schema: HANDOFF_CONTEXT_SCHEMA,
+      status: 'empty',
+      sessionId: null,
+      context: '',
+    })}\n`);
+    return 0;
+  }
+  if (!result?.context) {
     stderr.write('Throughline handoff context is not available for that session.\n');
     return 1;
   }
@@ -149,8 +222,8 @@ export function run(argv = [], {
   stdout.write(`${JSON.stringify({
     schema: HANDOFF_CONTEXT_SCHEMA,
     status: 'ready',
-    sessionId,
-    context,
+    sessionId: result.sessionId,
+    context: result.context,
   })}\n`);
   return 0;
 }

package/src/cli/handoff-context.test.mjs

@@ -8,7 +8,11 @@ import { fileURLToPath } from 'node:url';
 import { DatabaseSync } from 'node:sqlite';
 
 import { buildBudgetedResumeContext, INJECTION_BUDGET_CHARS } from '../resume-context.mjs';
-import { parseArgs, readSessionProjectPath } from './handoff-context.mjs';
+import {
+  parseArgs,
+  readLatestProjectHandoffContext,
+  readSessionProjectPath,
+} from './handoff-context.mjs';
 
 const REPO_ROOT = fileURLToPath(new URL('../..', import.meta.url));
 const BIN_PATH = join(REPO_ROOT, 'bin/throughline.mjs');
@@ -201,6 +205,93 @@ test('handoff-context supplement can silence disclosure without changing normal
   }
 });
 
+test('handoff-context can silence disclosure without a long-term-memory supplement', () => {
+  const home = mkdtempSync(join(tmpdir(), 'tl-handoff-direct-silent-'));
+  try {
+    const { db } = createFixture(home);
+    db.close();
+
+    const result = runCli(home, [
+      'handoff-context', '--session', SESSION_ID, '--json',
+      '--disclosure', 'silent',
+    ]);
+    assert.equal(result.status, 0, result.stderr);
+    const context = JSON.parse(result.stdout).context;
+    assert.doesNotMatch(context, /この引き継ぎ直後の最初の応答だけ/);
+    assert.doesNotMatch(context, /Throughline で前のセッションから .* ターン分/);
+    assert.match(context, /所有権を変えずに記憶を渡して/);
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
+test('handoff-context project selector skips the newest empty session', () => {
+  const home = mkdtempSync(join(tmpdir(), 'tl-handoff-project-'));
+  try {
+    const { db, dbPath } = createFixture(home);
+    db.prepare(
+      `INSERT INTO sessions
+         (session_id, project_path, status, created_at, updated_at, merged_into)
+       VALUES ('newest-empty', '/work/project', 'active', ?, ?, NULL)`,
+    ).run(1_700_000_005_000, 1_700_000_006_000);
+    db.prepare(
+      `INSERT INTO sessions
+         (session_id, project_path, status, created_at, updated_at, merged_into)
+       VALUES ('other-newest', '/work/other', 'active', ?, ?, NULL)`,
+    ).run(1_700_000_007_000, 1_700_000_008_000);
+    db.prepare(
+      `INSERT INTO bodies
+         (session_id, origin_session_id, turn_number, role, text, token_count, created_at)
+       VALUES ('other-newest', 'other-newest', 1, 'user', 'OTHER_PROJECT_PRIVATE', 4, ?)`,
+    ).run(1_700_000_007_500);
+    db.close();
+
+    const selected = readLatestProjectHandoffContext('/work/project', {
+      dbPath,
+      handoffDisclosure: 'silent',
+    });
+    assert.equal(selected.sessionId, SESSION_ID);
+    assert.match(selected.context, /所有権を変えずに記憶を渡して/);
+
+    const result = runCli(home, [
+      'handoff-context', '--project', '/work/project', '--json',
+      '--disclosure', 'silent',
+    ]);
+    assert.equal(result.status, 0, result.stderr);
+    const payload = JSON.parse(result.stdout);
+    assert.equal(payload.status, 'ready');
+    assert.equal(payload.sessionId, SESSION_ID);
+    assert.match(payload.context, /所有権を変えずに記憶を渡して/);
+    assert.doesNotMatch(payload.context, /OTHER_PROJECT_PRIVATE/);
+    assert.doesNotMatch(payload.context, /この引き継ぎ直後の最初の応答だけ/);
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
+test('handoff-context project selector returns empty when the project has no dialogue', () => {
+  const home = mkdtempSync(join(tmpdir(), 'tl-handoff-project-empty-'));
+  try {
+    const { db } = createFixture(home);
+    db.exec('DELETE FROM details; DELETE FROM bodies; DELETE FROM skeletons;');
+    db.close();
+
+    const result = runCli(home, [
+      'handoff-context', '--project', '/work/project', '--json',
+      '--disclosure', 'silent',
+    ]);
+    assert.equal(result.status, 0, result.stderr);
+    assert.deepEqual(JSON.parse(result.stdout), {
+      schema: 'throughline.handoff_context.v1',
+      status: 'empty',
+      sessionId: null,
+      context: '',
+    });
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
 test('handoff-context returns a project-bound supplement when the captured session has no dialogue yet', () => {
   const home = mkdtempSync(join(tmpdir(), 'tl-handoff-supplement-only-'));
   try {
@@ -261,15 +352,33 @@ test('handoff-context refuses a supplement from another bot project', () => {
 test('handoff-context accepts only the documented supplement argument shape', () => {
   assert.deepEqual(parseArgs(['--session', 's', '--json']), {
     sessionId: 's',
+    projectPath: null,
     supplementFile: null,
+    handoffDisclosure: 'visible',
   });
   assert.deepEqual(parseArgs([
     '--session', 's', '--json', '--supplement-file', '/tmp/memory.json',
   ]), {
     sessionId: 's',
+    projectPath: null,
     supplementFile: '/tmp/memory.json',
+    handoffDisclosure: 'visible',
+  });
+  assert.deepEqual(parseArgs([
+    '--project', '.', '--json', '--disclosure', 'silent',
+  ]), {
+    sessionId: null,
+    projectPath: process.cwd(),
+    supplementFile: null,
+    handoffDisclosure: 'silent',
   });
   assert.throws(() => parseArgs(['--session', 's', '--supplement-file', '/tmp/memory.json', '--json']));
+  assert.throws(() => parseArgs(['--project', '.', '--json', '--supplement-file', '/tmp/memory.json']));
+  assert.throws(() => parseArgs(['--session', 's', '--json', '--disclosure', 'hidden']));
+  assert.throws(() => parseArgs([
+    '--session', 's', '--json', '--disclosure', 'silent',
+    '--supplement-file', '/tmp/memory.json',
+  ]));
 });
 
 test('readSessionProjectPath returns the source session project', () => {

package/src/cli/help.test.mjs

@@ -51,7 +51,8 @@ test('CLI help exposes guided Codex handoff and guarded execute semantics', () =
   assert.match(result.stdout, /Use --execute to/);
   assert.match(result.stdout, /--open-host auto\|desktop\|vscode\|cli\|none/);
   assert.match(result.stdout, /throughline trim --execute/);
-  assert.match(result.stdout, /throughline handoff-context --session <id> --json/);
+  assert.match(result.stdout, /throughline handoff-context \(--session <id> \| --project <path>\) --json/);
+  assert.match(result.stdout, /--disclosure silent/);
   assert.match(result.stdout, /throughline latest-session --project <absolute-path> --json/);
   assert.match(result.stdout, /without\s+changing database ownership/);
   assert.match(result.stdout, /injectable DB memory/);

package/src/codex-app-server.mjs

@@ -1,4 +1,4 @@
-import { spawn } from 'node:child_process';
+import { spawnPortable as spawn } from './os/portable-spawn-sync.mjs';
 import { randomUUID } from 'node:crypto';
 
 export const CODEX_APP_SERVER_METHODS = Object.freeze({

package/src/codex-host-primitive-audit.mjs

@@ -1,4 +1,4 @@
-import { spawnSync } from 'node:child_process';
+import { spawnPortableSync as spawnSync } from './os/portable-spawn-sync.mjs';
 import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';

package/src/docs-contract.test.mjs

@@ -48,7 +48,7 @@ test('Markdown-only CI runs the product-owned documentation contract', () => {
   assert.match(result.stdout, /packed Markdown links:/);
 });
 
-test('release candidate version is synchronized across current product documents', () => {
+test('現行文書は版の正本を参照し、変更履歴は候補版と一致する', () => {
   const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
   const version = packageJson.version;
   const currentSources = [
@@ -56,7 +56,10 @@ test('release candidate version is synchronized across current product documents
     readFileSync(new URL('../CLAUDE.md', import.meta.url), 'utf8'),
     readFileSync(new URL('../docs/04_public_release_plan.md', import.meta.url), 'utf8'),
   ];
-  for (const source of currentSources) assert.match(source, new RegExp(`\\bv?${version.replaceAll('.', '\\.')}\\b`));
+  for (const source of currentSources) {
+    assert.match(source, /`package\.json`/);
+    assert.match(source, /公開版はnpm|公開版は冒頭のnpm/);
+  }
 
   const changelog = readFileSync(new URL('../CHANGELOG.md', import.meta.url), 'utf8');
   assert.match(changelog, new RegExp(`^## \\[${version.replaceAll('.', '\\.')}\\]`, 'm'));

package/src/os/portable-spawn-sync.mjs

@@ -1,4 +1,4 @@
-import { spawnSync } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { basename, delimiter, dirname, extname, isAbsolute, join } from 'node:path';
 
@@ -28,31 +28,42 @@ function resolveWindowsCommand(command, env) {
   return command;
 }
 
-export function spawnPortableSync(command, args, options = {}) {
+function portableInvocation(command, args, options = {}) {
   const platform = options.platform ?? process.platform;
   const spawnOptions = { ...options };
   delete spawnOptions.platform;
   spawnOptions.shell = false;
 
-  if (platform !== 'win32') return spawnSync(command, args, spawnOptions);
+  if (platform !== 'win32') return [command, args, spawnOptions];
 
   const env = spawnOptions.env ?? process.env;
   const resolved = resolveWindowsCommand(command, env);
   const extension = extname(resolved).toLowerCase();
   if (['.js', '.cjs', '.mjs'].includes(extension)) {
-    return spawnSync(process.execPath, [resolved, ...args], spawnOptions);
+    return [process.execPath, [resolved, ...args], spawnOptions];
   }
   if (extension === '.ps1') {
-    return spawnSync('pwsh.exe', [
+    const invocation = [resolved, ...args]
+      .map(value => `'${value.replaceAll("'", "''")}'`).join(' ');
+    return ['pwsh.exe', [
       '-NoLogo',
       '-NoProfile',
       '-NonInteractive',
       '-ExecutionPolicy',
       'Bypass',
-      '-File',
-      resolved,
-      ...args,
-    ], spawnOptions);
+      '-Command',
+      '[Console]::InputEncoding = [Console]::OutputEncoding = $OutputEncoding = ' +
+        '[System.Text.UTF8Encoding]::new($false); ' +
+        `& ${invocation}; exit $LASTEXITCODE`,
+    ], spawnOptions];
   }
-  return spawnSync(resolved, args, spawnOptions);
+  return [resolved, args, spawnOptions];
+}
+
+export function spawnPortableSync(command, args, options = {}) {
+  return spawnSync(...portableInvocation(command, args, options));
+}
+
+export function spawnPortable(command, args, options = {}) {
+  return spawn(...portableInvocation(command, args, options));
 }

package/src/os/portable-spawn-sync.test.mjs

@@ -3,7 +3,9 @@ import assert from 'node:assert/strict';
 import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { spawnPortableSync } from './portable-spawn-sync.mjs';
+import { spawnPortable, spawnPortableSync } from './portable-spawn-sync.mjs';
+import { createInterface } from 'node:readline';
+import { once } from 'node:events';
 
 test('spawnPortableSync: Windows cmd shim preserves argv boundaries and stdin', {
   skip: process.platform !== 'win32' ? 'Windows cmd shim contract' : undefined,
@@ -20,6 +22,7 @@ process.stdin.on('data', (chunk) => { input += chunk; });
 process.stdin.on('end', () => {
   process.stdout.write(JSON.stringify({ args: process.argv.slice(2), input }));
 });
+
 `);
     writeFileSync(command, `@echo off\r\n${JSON.stringify(process.execPath)} ${JSON.stringify(child)} %*\r\n`);
     writeFileSync(powerShellShim, `& ${JSON.stringify(process.execPath)} ${JSON.stringify(child)} @args\nexit $LASTEXITCODE\n`);
@@ -38,3 +41,50 @@ process.stdin.on('end', () => {
     rmSync(dir, { recursive: true, force: true });
   }
 });
+
+
+test('WindowsのPATHにあるnpm起動ファイルと標準入出力で往復できる', {
+  skip: process.platform !== 'win32',
+  timeout: 10_000,
+}, async () => {
+  const dir = mkdtempSync(join(tmpdir(), 'tl-npm-stream-'));
+  let child;
+  try {
+    const script = join(dir, 'rpc.mjs');
+    writeFileSync(script, `
+import { createInterface } from 'node:readline';
+createInterface({ input: process.stdin }).on('line', (line) => {
+  process.stdout.write(JSON.stringify({ line, args: process.argv.slice(2) }) + '\\n');
+});
+`);
+    // npmのPowerShell起動ファイルと同じ入力分岐で、EOF前の応答を確かめる。
+    writeFileSync(join(dir, 'tl-rpc.ps1'), `
+if ($MyInvocation.ExpectingInput) {
+  $input | & ${JSON.stringify(process.execPath)} ${JSON.stringify(script)} @args
+} else {
+  & ${JSON.stringify(process.execPath)} ${JSON.stringify(script)} @args
+}
+exit $LASTEXITCODE
+`);
+    const env = { ...process.env };
+    const pathKey = Object.keys(env).find(key => key.toLowerCase() === 'path');
+    env[pathKey] = `${dir};${env[pathKey]}`;
+    const args = ['空白 を含む', 'a&b', '100%'];
+    const sync = spawnPortableSync('tl-rpc', args, { env, encoding: 'utf8', input: '同期\n' });
+    assert.equal(sync.status, 0, sync.stderr || sync.error?.message);
+    assert.deepEqual(JSON.parse(sync.stdout), { line: '同期', args });
+    child = spawnPortable('tl-rpc', args, { env, stdio: ['pipe', 'pipe', 'pipe'] });
+    const lines = createInterface({ input: child.stdout });
+    for (const line of ['初期化', '次の要求']) {
+      const response = once(lines, 'line');
+      child.stdin.write(`${line}\n`);
+      assert.deepEqual(JSON.parse((await response)[0]), { line, args });
+    }
+    const closed = once(child, 'close');
+    child.stdin.end();
+    assert.equal((await closed)[0], 0);
+  } finally {
+    child?.kill();
+    rmSync(dir, { recursive: true, force: true });
+  }
+});