@tocca-systems/twp-cli 0.15.1 → 0.17.0

package/CHANGELOG.public.md

@@ -11,6 +11,27 @@
 `CHANGELOG.md` に残してあります。顧客向けの履歴は public 公開以降を対象とします。
 -->
 
+## 0.16.0
+
+`twp task-loop` が、使っている AI アカウントの枠（利用率・上限・再ログイン期限）をエージェントループ画面へ報告できるようになりました。**設定しなければ何も変わりません**（プローブの実行も送信も起きません）。
+
+`~/.twp/loops/<プロジェクトUUID>.json` に次のキーを足すと有効になります。
+
+```jsonc
+"capacity_probe": {
+  "command": ["claude-auto-switch", "status", "--json"],
+  "format": "claude_auto_switch/v1",  // 既定は "twp.capacity/v1"（正準スキーマ直出し）
+  "interval": 900,                     // 送信間隔（秒）
+  "timeout": 15,                       // プローブのタイムアウト（秒）
+  "identity": "masked"                 // "masked"（既定） | "none" | "full"
+}
+```
+
+- `command` は任意のコマンドで、**標準出力の JSON を読むだけ**です。`format` が `twp.capacity/v1`（既定）なら正準スキーマをそのまま受け取り、`claude_auto_switch/v1` なら `claude-auto-switch status --json` の出力を変換します。他のツールを使う場合は、正準スキーマを標準出力に書くラッパを用意すれば `format` は既定のまま使えます。
+- メールアドレスは送信前に伏字化されます（`agent@example.com` → `a**nt@ex*******om`）。`"identity": "none"` にすると識別子を一切送りません。
+- プローブが失敗しても**ループは止まりません**。警告を1行出し、「取得に失敗した」という事実のほうを送ります。
+- `command` を指定していない・書式が不正な場合は、警告を出したうえで枠の観測を行いません（勝手に既定のコマンドを実行することはありません）。
+
 ## 0.15.0
 
 モードを自分で調整できるようになりました。`.twp/modes/dev.md`（プロジェクト）や `~/.twp/modes/dev.md`（個人）に markdown を置くと、そのモードのラベル・色・使えるツール・権限・モデルへの指示を上書きできます。書き間違えても起動は止まらず、警告を出して既定の設定で続きます。