@tocca-systems/twp-cli 0.10.0

package/CHANGELOG.public.md

@@ -0,0 +1,80 @@
+# @tocca-systems/twp-cli
+
+利用者から見た変更点です。開発上の詳細はリポジトリ内の `CHANGELOG.md` にあります。
+
+<!--
+この先頭から下へ、`npm run version` のたびに新しいリリースが挿入されます。
+生成元は changeset 本文の `<!-- public ... -->` ブロックです
+（`scripts/generate-public-changelog.mjs`）。
+
+0.7.0 までの履歴は社内配布（restricted）期間のもので、開発上の記録として
+`CHANGELOG.md` に残してあります。顧客向けの履歴は public 公開以降を対象とします。
+-->
+
+## 0.10.0
+
+`twp task-loop` がプロンプト先頭へ前置する憲章について、囲み文（前文・後文）を
+`charter_prefix` / `charter_suffix`（環境変数 `CHARTER_PREFIX` / `CHARTER_SUFFIX`）で
+差し替えられるようになりました。空文字を指定すると囲み文なしで本文だけを前置します。
+前置の有無は `charter_enabled`（環境変数 `CHARTER_ENABLED`）で明示的に切り替えられます。
+いずれも未指定なら従来どおりの動作です。
+
+`twp task-loop` が claude の枠切替に使うランチャを、ループ設定 `claude_launcher` で指定できる
+ようになりました。現時点で有効なのは実行ファイル名（`claude_launcher.bin`）で、未設定なら
+従来どおり `claude-auto-switch` を使います。引数の指定（`probe` / `probe_match` / `exec_args` /
+`active_args`）は受け付けますが、まだ動作には反映されません（既定と違う値を設定すると起動時に
+その旨を警告します）。
+
+`twp task-loop` で、リリースが出す `RECOVER:` の行からタスクキーを読み取れず、
+ブロッカー修正の割り込み投入が黙って見送られることがある問題を直しました。
+プロジェクトコードに小文字・日本語・複数のハイフンを使っている場合に起きていました。
+
+`twp task get` / `task subtasks` / `task comment` などで、末尾が数字だけの UUID をタスク ID として指定できるようになりました。これまでは一部の UUID がタスクキーと誤判定され、`--project` の有無にかかわらず対象のタスクに到達できませんでした。あわせて、UUID / ULID の形をした値はキーの形にも読める場合でも ID として扱うことをヘルプに明記しました（この場合は `--project` か既定プロジェクトが要ります）。
+
+配布物が小さくなり（2.4MB → 1.9MB）、起動が少し速くなりました。
+ヘルプやログのメッセージから、利用者には意味のない当社内部の識別子を取り除いています。
+`/demo` の再生内容も一般的な例に差し替えました。
+
+`twp project get` に、前後に空白や改行が付いたプロジェクト ID を渡しても正しく引けるようになりました。
+`$(cat id.txt)` のように末尾に改行が付く形で渡すと、これまでは 404 になることがありました。
+
+プロジェクトコードが小文字だったり空白を含んでいたりする場合に、`twp task-loop` が実行アイテムにタスクキーを記録できず、**同じタスクを複数のランナーが同時に取りうる**状態になっていたのを修正しました。タスクキーの受理範囲が、他のコマンド（`twp task get` など）とサーバのルート定義に揃います。あわせて、タスクキーとして記録できない値（長すぎる・制御文字を含む・実際にはコマンドのオプション）を取り違えて実行アイテムの作成そのものが失敗しないようにしました。
+
+一覧コマンドの「次のページ」案内が、プロジェクトや担当者などの絞り込み、利用プロファイル、件数上限を引き継ぐようになりました。表示されたコマンドをそのまま実行して、同じ条件の次ページを取得できます。
+
+プロジェクトに属さない**個人タスク**を `twp task` から読み書きできるようになりました。`--project __private__` を付けると、一覧・取得・サブタスク・作成・更新・削除の 6 操作が個人タスクに対して動きます（`twp task-loop --project __private__` と同じ綴りです）。
+
+```
+twp task list   --project __private__
+twp task get    PRIVATE-22361 --project __private__
+twp task create --project __private__ --subject "買い物リストを作る"
+```
+
+- 個人タスクのキーは `PRIVATE-<番号>` です
+- `--status` / `--type` は個人タスク側のマスタから名前で解決します。省略すると既定が使われ、**何を既定に使ったかは実行前に stderr へ出ます**
+- 個人タスクには**担当者がありません**（`--assignee` はエラーになります）。**コメント（`twp task comment`）も使えません**。サーバ側に個人タスク用の API がないためで、黙って無視したり「見つかりません」で終わったりせず、理由を出して止まります
+- `PRIVATE-<番号>` は「個人タスクのキー」とも「コード `PRIVATE` のプロジェクトのタスクキー」とも読めるため、**`--project` を付けずに打つと候補を示して止まります**（どちらかへ勝手に倒しません）
+
+## 0.9.0
+
+`twp task-loop` が、特定のスキル名を特別扱いしなくなりました。
+
+これまでは一部のスキル名（`develop-merge` などの一般的な名前）に対して、
+定期枠の抑止・AIモデルの固定・後続コマンドの自動投入といった挙動が組み込みで有効になっており、
+同じ名前を付けた場合に意図しない動作になることがありました。
+
+今後これらは `~/.twp/loops/<プロジェクト>.json` の `operations` で明示的に設定したときだけ有効になります。
+**設定しない場合、スキル名による特別扱いは一切行いません。**
+起動時に、いまどの設定が有効かを1行で表示します。
+
+## 0.8.1
+
+README を利用者向けに書き直しました。「いまできること・まだできないこと」を先頭に置き、
+設定例を本番の接続先に揃え、ライセンスとサポート窓口の案内を追加しています。
+npm パッケージの情報に、ドキュメント（docs.tocca.systems）とお問い合わせ先を追加しました。
+
+## 0.8.0
+
+`twp task-loop` が git の author 情報を揃える際、`twp task-loop setup` で設定した値
+（または `TWP_GIT_IDENTITY_NAME` / `TWP_GIT_IDENTITY_EMAIL`）だけを使うようになりました。
+未設定の場合はリポジトリの設定を変更しません。

package/LICENSE

@@ -0,0 +1,47 @@
+Copyright (c) 2026 Tocca Systems Inc. All rights reserved.
+
+このソフトウェア（twp-cli / npm パッケージ `@tocca-systems/twp-cli`。以下「本ソフトウェア」）
+は Tocca Systems Inc.（以下「当社」）の専有物である。本ソフトウェアは npm レジストリを通じて
+配布されるが、**取得できることは利用を許諾されたことを意味しない。**
+`package.json` の `license` フィールドが `SEE LICENSE IN LICENSE` であることは、この文書が
+許諾の全部であることを指す。
+
+利用を許諾される者
+    当社との間で有効な Tocca Working Platform（以下「TWP」）の利用契約があるテナント、
+    および当該テナントが本ソフトウェアの利用を認めたその役職員・委託先に限る。
+    契約が終了した場合、本許諾も同時に終了する。
+
+許諾される範囲
+    上記の者は、当該テナントの業務のために本ソフトウェアをインストールし、実行し、
+    社内利用を目的として複製することができる。本ソフトウェアが TWP へ接続して行う処理は、
+    当該テナントの TWP 利用契約および当社が別途定める利用条件に従う。
+
+料金
+    本ソフトウェアを通じた AI 機能の利用は、当該テナントの TWP クレジットを消費する。
+    消費量・上限・課金の条件は TWP 利用契約に従う。
+
+禁止される行為
+    上記の範囲を超える、複製・改変・二次的著作物の作成・再配布・公開・販売・貸与・
+    サブライセンス、およびリバースエンジニアリング・逆コンパイル・逆アセンブルは、
+    当社の事前の書面による許諾がない限り認められない。
+    有効な TWP 利用契約を持たない者による本ソフトウェアの利用も認められない。
+
+データの送信
+    本ソフトウェアは、利用者の指示に応じて実行された処理の内容（読み取ったファイルの
+    内容、コマンドの出力、利用者が入力した文言を含む）を、応答を生成する目的で当社の
+    サーバへ送信し、当社を経由して AI モデルの提供元へ送信する。送信の範囲・取扱いは
+    TWP 利用契約および当社が別途定める利用条件に従う。
+
+第三者コンポーネント
+    本ソフトウェアの配布物には第三者のオープンソースソフトウェアが同梱されており、
+    それらは各々のライセンスに従う。該当する著作権表示とライセンス条文は配布物内の
+    `dist/THIRD-PARTY-NOTICES.md` に収録している。本ライセンスの定めは、これら第三者
+    コンポーネントに各ライセンスが付与する権利を制限するものではない。
+
+無保証・免責
+    本ソフトウェアは現状有姿で提供され、明示黙示を問わずいかなる保証も伴わない。
+    商品性・特定目的適合性・権利非侵害の保証を含むがこれに限られない。当社は、本
+    ソフトウェアの使用または使用不能から生じるいかなる損害についても責任を負わない。
+
+お問い合わせ
+    本ライセンスに関する照会・許諾の申請は当社まで。

package/README.md

@@ -0,0 +1,279 @@
+# twp-cli
+
+TWP（Tocca Working Platform）を、ターミナルから使うための CLI です。単なる API ラッパーではなく **AI エージェントハーネス**として作られています。
+
+- AI と会話しながら、**手元のファイルを読ませ、コマンドを実行させて**作業を進められます
+- **モデルの利用は TWP 経由**です。AI プロバイダの API キーを自分で用意する必要はなく、利用料はテナントのクレジットから引かれます
+- **`twp project` / `twp task` で TWP のプロジェクトとタスクを直接読み書き**できます（AI を介さないので、スクリプトからも使えます）
+- **Shift+Tab でモードを切り替え**、開発作業と業務作業を1つの端末で行き来できます
+- Windows / macOS / Linux / WSL で動作します
+
+ドキュメント: <https://docs.tocca.systems/>
+
+---
+
+## いまできること・まだできないこと
+
+はじめに期待値を合わせておきます。
+
+| | |
+|---|---|
+| **できる** | AI との会話（ストリーミング表示）。手元のファイルの読み書き・検索、コマンド実行、git の読み取り——いずれも**実行前に確認**します |
+| **できる** | `twp project` / `twp task` によるプロジェクト・タスクの読み書き（一覧・取得・作成・更新・削除・コメント） |
+| **できる** | `twp task-loop` による、TWP のタスクキューを手元の AI CLI に実行させる常駐ループ |
+| **まだできない** | **会話中の AI から TWP のデータを直接参照・操作すること。** 「このタスクの内容を読んで」と会話で頼むことはまだできません。TWP のデータを扱うときは `twp task` などのコマンドをお使いください |
+| **まだできない** | TWP の操作を行うスラッシュコマンド（`/task` など）。現在使えるスラッシュコマンドは `/help` `/mode` `/model` `/clear` `/context` `/doctor` `/exit` の7つと、動作デモの `/demo` です |
+
+登録されていないコマンドは補完にも `/help` にも出しません。**「あるのに動かない」ものは置かない**方針です。
+
+## 入れる
+
+```bash
+npm i -g @tocca-systems/twp-cli
+twp login                              # ブラウザでログイン
+twp -p "こんにちは"                      # 疎通確認（非対話）
+```
+
+Node 22 以上が必要です。postinstall もネイティブ依存もありません。インストールサイズは **3.9MB / 依存1パッケージ**です。
+
+## 使い方
+
+```
+twp                  対話 TUI を起動
+twp -p "<プロンプト>"  非対話で 1 往復だけ実行（応答は stdout・`-p -` で標準入力）
+twp login            ログイン（ブラウザ委譲 / --password / --token）
+twp login --tenant <code>
+                     テナントコードを先に指定する（--password のプロンプトを 1 つ省ける）
+twp logout / whoami
+twp update           npm の最新版と、サーバが要求する最小バージョンを確認
+twp --mode biz       起動時のモードを指定（dev | biz | plan）
+twp --permission-mode denyAll
+                     ツール実行の既定を上書き（plan | acceptEdits | denyAll）
+twp --model <id>     起動時のモデルを指定
+twp --profile <name> 接続プロファイルを指定
+twp --no-tui         非TTY 環境向け（TUI を起動せず入口を案内する）
+twp --doctor         端末キー入力の実測画面
+twp --version / --help
+```
+
+### TWP のプロジェクトとタスクを操作する
+
+AI を介さずに TWP を直接読み書きします。スクリプトからも使えます。
+
+```
+twp project list | get <コード|ID> | members <コード|ID>
+
+twp task list [--project <コード|__private__>] [--status <名前>] [--type <名前>] [--assignee <me|名前>]
+twp task get      <キー|ID>          # 例: twp task get ACME-123
+twp task subtasks <キー|ID>
+twp task create   --project <コード> --subject "<件名>" [--type <名前>] [--assignee <名前>]
+twp task update   <キー|ID> [--status <名前>] [--subject "<件名>"] [--assignee <名前>]
+twp task delete   <キー|ID> --yes
+
+twp task comment list   <キー|ID>
+twp task comment create <キー|ID> --body-file <パス>
+twp task comment update <コメントID> --body-file <パス>
+twp task comment delete <コメントID> --yes
+```
+
+- **個人タスク（プロジェクトに属さない自分だけのタスク）は `--project __private__` で操作します**（`twp task list --project __private__`）。キーは `PRIVATE-<番号>` です。担当者（`--assignee`）とコメント（`twp task comment`）は個人タスクにはありません
+- **`--status` / `--type` / `--assignee` は名前で指定できます**（`--assignee me` は自分）。候補が絞れないときは候補を出して止まります
+- **`delete` には `--yes` が必要です。** 対話中でも確認プロンプトには落ちません（自動実行と手動実行で必要な引数を変えないため）
+- **本文は `--body-file` / `--description-file` を主経路にしてください**（`-` で標準入力）。引数に直接書くと改行と Markdown が壊れます
+- 一覧は `--limit <件数>` / `--all` / `--cursor` で辿れます（`task subtasks` と `project members` はページングがありません）
+- **フラグの値は `--flag 値` でも `--flag=値` でも書けます。** 空白を含む値は `--keyword "山田 太郎"` のように引用し、`-` で始まる値は `--keyword=-foo` の形で渡します
+- ヘルプは `twp task help` / `twp task comment help` / `twp task create help`
+
+グローバルオプション: `--profile <名前>` / `--output <json|table|text|tsv>` / `--query <JMESPath>` / `--dry-run` / `--debug` / `--yes` / `--refresh`。**`--output json` は常に API の生のレスポンス**を返します（表示用に間引きません）。
+
+```bash
+twp task list --project ACME --status 進行中 --output json --query '[].{key:key,subject:subject}'
+```
+
+### エージェントループを回す
+
+```
+twp task-loop setup  --project <コード|ID>   # 作業ディレクトリと使う AI を決める
+twp task-loop run    --project <コード|ID>
+twp task-loop status --project <コード|ID>
+twp task-loop stop
+```
+
+実行前に「[⚠️ 実行する前に理解しておくこと（信頼境界）](#️-実行する前に理解しておくこと信頼境界)」を必ずお読みください。
+
+**モデル取次には `cli` 権限付きトークンが必要。** `twp login`（ブラウザ委譲）と `twp login --password` が発行する。`twp login --token` で保存した通常トークンは TWP API には使えるが会話は 401 になる。
+
+### 更新（`twp update`）
+
+`twp update` は **npm の最新版**と、**接続先のリレーが要求する最小サポートバージョン**の両方を報告する。**自分では更新しない**（インストール方法・権限が環境で違うため、実行すべきコマンドを表示する）。最小サポート未満なら終了コード 1。
+
+リレーは古いクライアントを拒否しない（`/api/cli/v1` の後方互換は恒久的に保つ）。止めるのは CLI 側で、**下限が読めない・取れないときは素通りする**（回線断やサーバ未対応で全員が使えなくなるのを避ける）。下限は `~/.twp/models.json` にプロファイル単位でキャッシュする。
+
+- **下限を満たしていれば1バイトも通信しない**（起動時に見るのはキャッシュだけ）
+- **キャッシュが「止める」と言ったときだけ、止める前に1回サーバへ確認する**。サーバ側が下限を下げたら、その端末はこの確認で自動的に回復する
+- 下限が上がった直後の初回起動: TUI は毎回 `/api/cli/v1/models` を引くのでその場で止まる。`twp -p` は**モデルが指定済みだと一覧を引かない**ため、キャッシュが6時間より古いときだけ引き直す（＝最大6時間は古い下限で動く）
+- **`0.0.0-dev`（`npm run dev` / `tsx` / 素の `node dist/cli.js`）は判定しない**（下限を上げて検証する作業そのものを塞がないため）
+
+```
+$ twp update
+twp 0.2.3
+
+  最新版        0.3.0（npm registry）
+  最小サポート  0.2.0（サーバ / https://ai-api.tocca.systems）
+  判定          更新できます（必須ではありません）
+
+  npm i -g @tocca-systems/twp-cli@latest
+```
+
+対象は**リレーを使う経路（TUI と `-p`）だけ**。`twp task-loop`（`/api/cli/v1` を使わない）・`twp login` / `whoami`・`--no-tui` / `--doctor`（リレーを1往復も使わない診断経路）は対象外。
+
+### 企業プロキシ・TLS 傍受プロキシの下で使う
+
+`HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY`（小文字も可・**小文字が優先**）を読み、すべての外向き通信
+（ログイン・TWP API・モデル取次と SSE・`twp update` の registry 参照）をプロキシ経由にする。
+
+```bash
+export HTTPS_PROXY=http://proxy.example.com:8080
+export NO_PROXY=localhost,127.0.0.1,.internal.example.com
+# TLS 傍受プロキシなら、そのプロキシの CA を Node に信頼させる（**Node の機構**）
+export NODE_EXTRA_CA_CERTS=/path/to/corp-proxy-ca.pem
+twp login
+```
+
+- **ループバック（`localhost` / `127.0.0.1` / `::1`）は既定でプロキシを経由しない。** ローカルの API（`TWP_API_URL=http://localhost:8086`）を使うときに `Authorization: Bearer …` が第三者のプロキシへ渡るのを防ぐため（`twp --doctor` の「NO_PROXY（実効）」に出る）
+- **`NODE_EXTRA_CA_CERTS` は Node が起動時にしか読まない。** 設定したら `twp` を起動し直す
+- 効いているか・何が足りないかは **`twp --doctor`** の「ネットワーク（プロキシ / CA）」で確認できる（プロキシ URL に資格情報が入っていても伏字で表示する）
+- **Node 組込みの `--use-env-proxy` / `NODE_USE_ENV_PROXY` には依存していない**（Node 22 では効かないことを実測。24 でのみ有効）。この CLI はプロキシ変数があるときだけ undici の `EnvHttpProxyAgent` を読み込み、無ければ素の `fetch` のまま
+- **プロキシが応答を溜め込む設定だと、ストリーミングが一括で届く**（内容は同じ）。mitmproxy の既定でこれを実測している。CLI 側では回避できないので、逐次表示が必要なら proxy 側でストリーミングを許可する
+- 認証付きプロキシは **Basic まで**（`http://user:pass@proxy:8080`）。NTLM / Kerberos は未対応
+- `socks5://` も通る（`socks` / `socks4` / `socks5h` も同様）
+- **`HTTP_PROXY` だけを設定すると、https もそのプロキシを通る**（undici の既定。https だけ直結にしたいなら `NO_PROXY` で除外する）
+- **プロキシ経由の通信は Node 22.19 以上が必要**（内部で使う undici の要件）。それより古い 22.x では、プロキシ変数を設定したときだけ失敗する（`twp --doctor` が指摘する）
+- ⚠ **TLS 傍受プロキシは通信の中身を復号する。** アクセストークンとモデルへ送るプロンプト（タスク本文・コード断片）は、そのプロキシの運用者から見える状態になる
+
+### 接続先の設定
+
+```jsonc
+// ~/.twp/config.json
+//
+// 既定の接続先は本番なので、通常この設定は要りません。
+// 別の環境へ繋ぐときや、複数の接続先を切り替えたいときだけ書きます。
+{
+  "default_profile": "production",
+  "profiles": {
+    "production": {
+      "api_url": "https://backend.tocca.systems",
+      "frontend_url": "https://app.tocca.systems",
+      "relay_url": "https://ai-api.tocca.systems",
+      "model": "claude-sonnet-5"
+    }
+  }
+}
+```
+
+`TWP_API_URL` / `TWP_FRONTEND_URL` / `TWP_RELAY_URL` で一時的に上書きできる。既定モデルの優先順は `--model` > プロジェクト `.twp/config.json` の `model` > ユーザー設定 > サーバ既定。
+
+### キー操作
+
+| キー | 動作 |
+|---|---|
+| `Shift+Tab` / `Alt+M` | モード巡回（開発 → 業務 → プラン） |
+| `/` | スラッシュコマンドパレット（ファジー絞り込み・`Tab` 補完・`↑↓` 選択） |
+| `Shift+Enter` / `Ctrl+J` / `\` + `Enter` | 改行（複数行入力） |
+| `Ctrl+R` | 直前のツール出力を全文展開 |
+| `Ctrl+C` | 実行中なら中断 / 入力が空なら 2 回で終了 |
+| `Ctrl+D` / `/exit`（`/quit` も可） | 終了 |
+
+**Shift+Enter が効かない端末がある。** kitty keyboard protocol 非対応の端末（Windows Terminal / VS Code / tmux など大半）では Shift+Enter が素の Enter と区別できない。その場合は **`Ctrl+J`**（全端末で確実）か **`\` を打ってから Enter**（Claude Code と同じ）を使う。Ctrl+Enter を LF として送る端末では Ctrl+Enter も改行になる。
+
+**Shift+Tab が効かない端末がある。** legacy conhost や一部の JetBrains 内蔵端末は Shift+Tab を素の `TAB` として送るため、Tab と区別できない。その場合は `Alt+M` か `/mode` を使う。自分の端末が何を送っているかは `/doctor` で実測できる。
+
+### モード
+
+| モード | ツール | 権限 |
+|---|---|---|
+| 開発 `dev` | ローカルツール全部 ＋ 開発系 TWP ドメイン | 書き込みは確認 / 読み取りは許可 |
+| 業務 `biz` | TWP ドメイン中心 | `bash` と `write_file` は拒否 |
+| プラン `plan` | 読み取りのみ | 全書き込み拒否 |
+
+**モデルはモードと直交する。** 業務モードに切り替えてもモデルは変わらない（`/model` で別に切り替える）。
+
+### `--permission-mode`（実行1回ぶんの上書き）
+
+モードの方針の上に、その実行ぶんの既定を重ねる。CI・SSH・パイプで「何が自動で通るか」を呼び出し側が明示するためのもの。
+
+| 値 | 読み取り | 書き込み | コマンド実行 |
+|---|---|---|---|
+| 未指定 | モードのまま | モードのまま | モードのまま |
+| `plan` | モードのまま | 拒否 | 拒否 |
+| `acceptEdits` | モードのまま | 確認を省いて許可 | モードのまま |
+| `denyAll` | 拒否 | 拒否 | 拒否 |
+
+- **モードの拒否は覆らない。** `acceptEdits` を付けても業務モードの `write_file` は通らない
+- **`rm -rf` と分岐したコマンドは `acceptEdits` でも必ず確認する**（自動許可しないものは権限モードより上位）
+- **後で実行に化ける書き込み先は `acceptEdits` でも毎回確認する**（`.git/` `.github/` `.claude/` `.husky/` `.githooks/` と `package.json` / `Makefile` / `.envrc` / `.mcp.json`）。判定は**実体のパス**で行うので、`hooks -> .git/hooks` のような symlink や `.GIT/` のような大文字小文字違いでも迂回できない
+- **ただし `acceptEdits` は「安全な書き込みだけを通す機構」ではない。** 後で実行に化わる書き込み先を網羅はできない（`CLAUDE.md` や任意のスクリプトも同じ性質を持つ）。信用できないリポジトリでは付けない
+- **`plan` / `denyAll` は `git` も止める。** git は読み取りサブコマンドしか許していないが、**リポジトリ側の設定（`diff.external` 等）が任意のコマンドを起こせる**ため `exec` に分類している
+- **非対話（`-p` / パイプ）では確認できないので、確認が必要なツールは拒否になる**（拒否は tool result としてモデルへ返り、会話は続く）。無言で許可することはない
+- 拒否されたツールは**そもそもモデルに渡さない**（プロンプトに載せない）。`denyAll` ではツールが0本になる
+
+### 監査ログ
+
+`~/.twp/logs/session-<id>.jsonl` に、1行1件で「いつ・どのツールを・どう判断したか（根拠つき）」を残す。
+
+```jsonc
+{"ts":"…","v":1,"session":"01M1…","permission_mode":null,"event":"decision",
+ "tool":"bash","risk":"exec","decision":"deny","reason_code":"non_interactive",
+ "reason":"非対話セッションで承認が必要（deny-and-continue）","mode":"dev","input":{"command":"pwd"}}
+```
+
+集計・スクリプトは **`reason_code`（機械可読）** を読む。`reason` は人間向けの説明で文言が変わる。
+
+- **本文は書かない。** `write_file` の `content` や差分はバイト数だけ（`"content":"<redacted 45 bytes>"`）。一度落とした値は、後のターンで別のフィールド（`bash` のコマンド行など）に現れても消す（値は保持せずハッシュで突き合わせる）
+- **覚える対象には限界がある**: 12文字未満・`KEY=VALUE` 形以外の行にあるパス様の値・複数語のパスフレーズは覚えない（普通のログが読めなくなるため）。上限（トークン4096件）に達したら**それ以上覚えるのをやめ**、`{"event":"registry_saturated"}` を残す（黙って忘れない）
+- **監査ログ自身はモデルから読めない**（`~/.twp/logs/*.jsonl` は `read_file` / `grep` の拒否対象）
+- **残るフィールドもある。** `bash` の `command`、`grep` / `glob` の `pattern`、`read_file` / `write_file` の `path` は監査の目的そのものなので残す。したがって**そこへ直接書かれた秘密は残りうる**（`Bearer …` / `ghp_…` のような既知の形と、一度 redact した値は消す）。逆に **git の完全 SHA のような40桁以上の16進は秘密として潰れる**——秘密側に倒す判断
+- ファイルは **0600**・ディレクトリは **0700**（`credentials.json` と同じ扱い）。**Windows では OS 既定の ACL に従う**（Node が mode を無視するため。共有端末では他ユーザーから読める）。ログディレクトリが symlink のときは書かない
+- **ツールを1本も使わなかったセッションではファイルを作らない**（空のログが保持枠を食い潰さないようにするため）
+- **14日・200本**で自動的に刈る。1ファイル 5MB・1行 4KB の上限もある
+- `TWP_NO_AUDIT=1` で無効化できる
+
+## `twp task-loop`（エージェントループ実行）
+
+TWP のタスクキューから項目を取り出し、**あなたの端末にインストールされた AI CLI**（`claude` / `codex` / `gemini` / `copilot`）にそれを実行させる常駐ループです。TUI や `twp -p` と違って**リレーを通らないので、TWP のクレジットを消費しません**——動かすのは利用者ご自身の AI サブスクリプションです。
+
+```bash
+twp task-loop setup --project <キー|UUID>   # 作業ディレクトリと使う AI を決める
+twp task-loop run   --project <キー|UUID>
+twp task-loop status --project <キー|UUID>
+twp task-loop stop                          # このマシンで動いているループを止める
+```
+
+### ⚠️ 実行する前に理解しておくこと（信頼境界）
+
+**このループは、キューに入っている指示を、承認ゲートとサンドボックスを外した AI CLI として実行します。** つまりファイルの読み書きもコマンド実行も、都度の確認なしに走ります（`claude --dangerously-skip-permissions` / `codex -s danger-full-access` / `gemini --yolo` / `copilot --allow-all` 相当）。ループを無人で回すための設計であり、TUI の権限モデルはここには適用されません。
+
+そして**キューに項目を入れられるのは、そのプロジェクトのメンバー全員**です。したがって:
+
+> **`twp task-loop run` を実行するということは、そのプロジェクトのメンバーが、あなたの端末で任意のコードを実行できる状態にする、ということです。**
+
+これは CI ランナーを自分の端末で動かすのと同じ信頼モデルです。次を満たす場合にだけ実行してください。
+
+- **プロジェクトのメンバー全員を信頼している**（メンバーを絞ることが制御手段になります）
+- **作業ディレクトリに、失われて困るもの・見られて困るものを置いていない**
+- できれば**専用のマシンかコンテナ**で動かす（共用の開発端末では動かさない）
+
+止めるときは `twp task-loop stop` です。実行されたツールと権限判断は端末の監査ログ（`~/.twp/logs/`）に残ります。
+
+### 必要なもの
+
+- 使う AI CLI が**インストール済みかつログイン済み**であること（`twp task-loop setup` が検出し、使えないものは理由を出して止まります）
+- 作業ディレクトリに**スキル定義**（`.claude/commands/*.md`）があること。何を実行させるかはこの定義が決めます。twp-cli は定義を同梱しません
+
+## ライセンスとサポート
+
+本ソフトウェアは TWP の利用契約を結んでいるテナントの利用者に対してのみ利用を許諾しています。詳細はパッケージに同梱の `LICENSE` をご確認ください。
+
+- ドキュメント: <https://docs.tocca.systems/>
+- お問い合わせ・不具合のご報告: TWP の[サポート](https://app.tocca.systems/v1/support)からご連絡ください（ログインが必要です）
+- 変更履歴: パッケージに同梱の `CHANGELOG.public.md`