@tocca-systems/twp-cli 0.96.1 → 0.97.0

package/CHANGELOG.public.md

@@ -11,6 +11,16 @@
 `CHANGELOG.md` に残してあります。顧客向けの履歴は public 公開以降を対象とします。
 -->
 
+## 0.97.0
+
+エージェントループに「条件トリガー」を設定できるようになりました。同じタスクに同じスキルを投入しても状態が変わらない実行が続いたとき、指定したスキルを自動でキューへ差し込みます。`twp task-loop trigger` で一覧・作成・更新・削除・発火履歴の確認、止めた投入の再開ができます。止められている投入はエラーにならず、ログに「投入を落とした」と残してループが続きます。
+
+## 0.96.2
+
+廃止された見込客のアプローチ履歴の操作を、`twp api` と AI のツール候補から外しました（呼ぶと 404 になっていました）。
+
+`twp api` と AI のツール候補が、最新の TWP の操作（要員調整ボード・経費精算・チャットなど）を認識するようになりました。
+
 ## 0.96.1
 
 対話画面で接続先の異なるモデルへ切り替えたとき、「新しい会話を始めました」の案内が表示されるようにしました。

package/README.md

@@ -2421,6 +2421,38 @@ twp task-loop schedule config push --project <キー|UUID> --file config.json
 - config push はファイルに無いキーをサーバの現在値のまま保ちます（`max_per_cycle` は必須）
 - 書き込みはプロジェクトの管理者以上だけができます。権限が無ければサーバの 403 の理由をそのまま表示します。終了コードは憲章（`charter`）と同じ規約で、delete で対象が無いときは `1` です
 
+### 成果の出ない実行が続いたら別のスキルを差し込む（条件トリガー）
+
+「同じタスクに同じスキルを投入しても状態が変わらない」状態が続いたとき、サーバが指定のスキル（調査・是正用など）を自動でキューへ差し込むための設定です。評価と差し込みはサーバが行い、定義が1件も無いプロジェクトでは何も変わりません。
+
+```bash
+twp task-loop trigger list    --project <キー|UUID> [--output json|table|tsv] [--query <式>]   # 定義の一覧
+twp task-loop trigger show    --project <キー|UUID> <トリガーID>                              # 定義1件
+twp task-loop trigger push    --project <キー|UUID> --file triggers.json                      # ファイル → サーバ（作成・更新）
+twp task-loop trigger delete  --project <キー|UUID> <トリガーID>                              # 定義の削除
+twp task-loop trigger history --project <キー|UUID> [<トリガーID>] [--key <タスクキー>] [--limit <N>]  # 発火した記録
+twp task-loop trigger release --project <キー|UUID> <トリガーID> --key <タスクキー>           # 止めた投入を再開できるようにする
+```
+
+定義の例（省略した項目はサーバの既定値になります）:
+
+```json
+{
+  "id": "review-loop-guard",
+  "name": "レビューが3回続けて進まない",
+  "match": { "skills": ["review"], "outcome_codes": ["BLOCKED"] },
+  "threshold": { "count": 3, "window_hours": 6 },
+  "action": { "skill": "investigate", "args": "{task_key}", "priority": "P1", "block_source": true },
+  "cooldown_hours": 24
+}
+```
+
+- スキル名は接頭辞を付けない名前で書きます（`match.skills` は `"*"` で全スキル）。`action.args` には `{task_key}` `{skill}` `{count}` を使えます
+- ファイルは定義1件・定義の配列・`{ "triggers": [...] }` のいずれかです。知らないキーがあると送らずに止めます（`_` で始まるキーは注釈として送りません）
+- **push・delete・release は `--yes` なしでは書きません。** push と delete は定期枠の定義（`schedule push|delete`）と同じく差分と revision を表示し、確定用のコマンドを案内します。案内どおりに確定すると、表示した後に画面で更新された定義があれば1件も書かずに止まります。push はサーバにだけある定義を削除せず、書いた後にサーバと差分が無いことを確かめてから「反映しました」と表示します
+- `action.block_source` を `true` にすると、差し込んだ後は同じタスクへ元のスキルを投入できなくなります（タスクの状態が変わる・`cooldown_hours` が過ぎる・`release` で解除する、のいずれかで戻ります）。ブロック中の投入は、ループの計画・定期枠・後続の自動投入とも**エラーにせず「投入を落とした」とログに残して続行**します
+- 書き込みと release はプロジェクトの管理者以上だけができます（個人タスクのキュー `--project __private__` は本人）。終了コードは定期枠の定義と同じ規約で、delete・release で対象が無いときは `1` です
+
 ### サーバに残した版の履歴・差分・復元
 
 サーバは憲章（ループ設定）とスキル定義を更新するたびに、その版を残します（対象ごとに直近100版）。