@tocca-systems/twp-cli 0.52.0 → 0.53.0

package/CHANGELOG.public.md

@@ -11,6 +11,16 @@
 `CHANGELOG.md` に残してあります。顧客向けの履歴は public 公開以降を対象とします。
 -->
 
+## 0.53.0
+
+`twp teams favorite` で、よく使う Teams のチャネル・チャットを用途の説明つきで自分だけのお気に入りに登録できるようになりました。`twp teams channel list` / `chat list` ではお気に入りに ★ と説明が付いて先頭に並びます。
+
+`twp task-loop run` の待機秒数を、`--interval` を省略したときはサーバのループ設定から取るようにしました。サーバ側で値を変えると、ループを再起動しなくても次のサイクルから反映されます。
+
+## 0.52.1
+
+`twp budget allocation set` のヘルプを、比率の合計がサーバで検査される現在の動作に合わせて修正しました。
+
 ## 0.52.0
 
 CLI から AI で動画・音楽を作れるようになりました（`twp media video create` / `twp media music create`）。送る前に消費クレジットの見積を表示し、`--wait` で完成まで待って `--out` でそのままファイルに保存できます。待ちきれなかった場合は表示されるコマンド（`twp media video get <task_id> --wait --out <パス>`）で、作り直さずに続きから受け取れます。画像や動画を元にした動画のリミックス（`--from` / `--from-video`）、生成中の取り消し、見積だけの確認（`preview`）にも対応しています。

package/README.md

@@ -1053,7 +1053,7 @@ twp budget allocation set [--project <コード>] --clear --yes
 - `--reliability` は見積の確度コード（`60` など）です。サーバが知らない確度は使われず、そのときは stderr でそう言います
 - `target set --file` の JSON は `[{"department": "開発部", "month": 4, "sales_target": 1000000, "profit_target": 200000}]` の形です。誤りは全部挙げて1件も送りません
 - `target import` は雛形（`import-template`）の形の CSV を取り込みます。1行でも誤りがあればサーバが1件も書かず、行ごとの理由をすべて出して終了コード 3 です
-- `allocation set` は按分を**全件置き換え**ます（指定しなかった部署の按分は消えます）。`--clear` で按分をすべて消します。送る前に置換前と置換後の按分を出します。比率の合計（100%）はサーバも CLI も検査しないので、自分で確かめてください
+- `allocation set` は按分を**全件置き換え**ます（指定しなかった部署の按分は消えます）。`--clear` で按分をすべて消します。送る前に置換前と置換後の按分を出します。比率の合計はサーバが画面と同じ規則で検査し（比率だけなら合計 100%、金額の行を含むなら比率の合計が 100% 以下）、違反すると 1 件も書かずに 422 の理由を出して終了コード 3 で終わります
 
 ### ワーカーエージェント（AIエージェント）を見る
 
@@ -1300,6 +1300,12 @@ twp outlook event create --subject <件名> --start <yyyy-MM-ddTHH:mm> --end <yy
 twp outlook event update <予定ID> [上と同じ項目のうち変えるもの] [--clear-attendees] --yes
 twp outlook event delete <予定ID> --yes
 
+twp teams favorite list   [--kind channel|chat]       # お気に入り（用途の説明つき）。宛先に迷ったら最初に見る
+twp teams favorite add    (--team <名前|ID> --channel <名前|ID> | --chat <ID>) [--description <文>] [--name <名前>]
+twp teams favorite update <種別>/<ID> [--team <名前|ID>] [--description <文>] [--name <名前>]
+twp teams favorite order  <種別> <ID> [<ID> …]
+twp teams favorite remove <種別>/<ID> --yes
+
 twp teams team list                                   # --team に渡す id / 名前
 twp teams member list   --team <名前|ID>
 twp teams channel list  --team <名前|ID>              # --channel に渡す id / 名前
@@ -1323,6 +1329,7 @@ twp onedrive link create   <項目ID> --scope organization|anonymous [--type vie
 
 - **Microsoft 365 と連携していないと、連携の手順を表示して終了コード 3 で止まります。** TWP の画面で「Microsoftアカウントでログイン」から一度ログインすると連携されます（`twp login` のやり直しは要りません）
 - **チームとチャネルは名前でも ID でも指定できます**（`--team 開発 --channel General`）。同じ名前が複数あれば候補を表示して止まります。**チャットは ID だけです**（チャットの数が多い人は名前で探すのに1分以上かかるため）。`twp teams chat list` に参加者の名前が出るので、`--all --query` で ID を探してください（例は `twp teams chat help`）
+- **お気に入り（`twp teams favorite`）は自分だけに見え、チャネル・チャットに用途の説明を付けられます。** `channel list` / `chat list` では `favorite` 列に ★、`favorite_description` 列に説明が出て先頭に並び、`team list` はお気に入りチャネルを含むチームに ★<数> が付きます。ただし並べ替えは取得したページ内だけなので、全件は `favorite list` で見てください。チャネルの `update` には `--team`（`favorite list` の `team_id`）が要ります
 - 一覧は Microsoft 365 が1回に返す件数に上限があります（チャットは25件）。**続きがあれば必ず表示し**、`--all` で最後まで辿れます。`--all` の途中で同じ項目が重複して返ったときは除いて、その件数を表示します（メール・予定で実測あり）
 - `--limit` の上限はメール 1000・チャット 50・Teams のメッセージと返信 50・メンション 200 です（超える値は送る前に止めます）。`twp teams team list` / `channel list` は件数を指定できません
 - `twp outlook mail list` の `--search` は `--filter` / `--unread` / `--orderby` と併用できません（Microsoft 365 が受け付けないため、送る前に止めます）。検索語に `"` は使えません
@@ -1687,6 +1694,16 @@ twp task-loop stop                          # このマシンで動いている
 
 止めるときは `twp task-loop stop` です。実行されたツールと権限判断は端末の監査ログ（`~/.twp/logs/`）に残ります。
 
+### サイクル間の待機秒数（`--interval`）
+
+ループはサイクルごとに一定時間待ちます。待機秒数は次の順で決まります。
+
+1. `twp task-loop run --interval <秒>` を付けて起動したら、その値
+2. 付けていなければ、サーバのループ設定 `loop.interval_sec`（30〜86400秒）
+3. どちらも無ければ 300秒
+
+サーバの値は**サイクルごとに取り直す**ので、変えると再起動なしで、次のサイクル冒頭の取得以降の待機から効きます（実行中のサイクルの待機には間に合いません）。起動時と取得元が変わったときに `INTERVAL: 60s（取得元: server）` のように1行出ます（`cli` / `server` / `cached`＝通信断で直前の値 / `default`）。取得に失敗してもループは止まらず、直前に取得した値か 300秒で動きます。
+
 ### 憲章をファイルとサーバで受け渡す
 
 ループが全アイテムに注入する憲章（ループ設定の憲章欄）を、ファイルとの間で登録・展開できます。常時同期はせず、実行したときだけ動きます。

package/command-model/account-lock.json

@@ -1,108 +1,8 @@
 {
   "domain": "account-lock",
   "operations": [
-    {
-      "name": "get",
-      "domain": "account-lock",
-      "operationId": "accountLock.show",
-      "method": "GET",
-      "path": "/v2/admin/tenant/account-lock",
-      "summary": "テナントのアカウントロック設定を取得",
-      "pathParams": [],
-      "queryParams": [
-        {
-          "name": "limit",
-          "type": "integer",
-          "required": false,
-          "description": "1ページあたりの件数",
-          "source": "curation"
-        },
-        {
-          "name": "cursor",
-          "type": "string",
-          "required": false,
-          "description": "次ページの取得に使うカーソル",
-          "source": "curation"
-        }
-      ],
-      "body": null,
-      "resultPath": "",
-      "risk": "read",
-      "aliases": []
-    },
-    {
-      "name": "unlock",
-      "domain": "account-lock",
-      "operationId": "accountLock.unlock",
-      "method": "POST",
-      "path": "/v2/admin/users/{id}/unlock",
-      "summary": "ユーザーのアカウントロックを解除",
-      "pathParams": [
-        {
-          "name": "id",
-          "type": "string",
-          "required": true,
-          "source": "spec"
-        }
-      ],
-      "queryParams": [],
-      "body": null,
-      "resultPath": "",
-      "risk": "write",
-      "aliases": []
-    },
-    {
-      "name": "update",
-      "domain": "account-lock",
-      "operationId": "accountLock.update",
-      "method": "PUT",
-      "path": "/v2/admin/tenant/account-lock",
-      "summary": "テナントのアカウントロック設定を更新",
-      "pathParams": [],
-      "queryParams": [],
-      "body": {
-        "schema": {
-          "type": "object",
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "max_login_attempts": {
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 100
-            },
-            "lockout_duration_minutes": {
-              "type": "integer",
-              "minimum": 0,
-              "maximum": 10080
-            },
-            "failure_count_reset_minutes": {
-              "type": "integer",
-              "minimum": 0,
-              "maximum": 10080
-            },
-            "auto_unlock_enabled": {
-              "type": "boolean"
-            },
-            "admin_unlock_enabled": {
-              "type": "boolean"
-            },
-            "password_reset_unlock_enabled": {
-              "type": "boolean"
-            },
-            "notify_admin_on_lock": {
-              "type": "boolean"
-            },
-            "notify_user_on_lock": {
-              "type": "boolean"
-            }
-          }
-        }
-      },
-      "resultPath": "",
-      "risk": "write",
-      "aliases": []
-    }
+    {"name":"get","domain":"account-lock","operationId":"accountLock.show","method":"GET","path":"/v2/admin/tenant/account-lock","summary":"テナントのアカウントロック設定を取得","pathParams":[],"queryParams":[{"name":"limit","type":"integer","required":false,"description":"1ページあたりの件数","source":"curation"},{"name":"cursor","type":"string","required":false,"description":"次ページの取得に使うカーソル","source":"curation"}],"body":null,"resultPath":"","risk":"read","aliases":[]},
+    {"name":"unlock","domain":"account-lock","operationId":"accountLock.unlock","method":"POST","path":"/v2/admin/users/{id}/unlock","summary":"ユーザーのアカウントロックを解除","pathParams":[{"name":"id","type":"string","required":true,"source":"spec"}],"queryParams":[],"body":null,"resultPath":"","risk":"write","aliases":[]},
+    {"name":"update","domain":"account-lock","operationId":"accountLock.update","method":"PUT","path":"/v2/admin/tenant/account-lock","summary":"テナントのアカウントロック設定を更新","pathParams":[],"queryParams":[],"body":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"max_login_attempts":{"type":"integer","minimum":1,"maximum":100},"lockout_duration_minutes":{"type":"integer","minimum":0,"maximum":10080},"failure_count_reset_minutes":{"type":"integer","minimum":0,"maximum":10080},"auto_unlock_enabled":{"type":"boolean"},"admin_unlock_enabled":{"type":"boolean"},"password_reset_unlock_enabled":{"type":"boolean"},"notify_admin_on_lock":{"type":"boolean"},"notify_user_on_lock":{"type":"boolean"}}}},"resultPath":"","risk":"write","aliases":[]}
   ]
 }

package/command-model/address.json

@@ -1,40 +1,6 @@
 {
   "domain": "address",
   "operations": [
-    {
-      "name": "search",
-      "domain": "address",
-      "operationId": "address.search",
-      "method": "GET",
-      "path": "/v2/address/search",
-      "summary": "郵便番号から住所を検索",
-      "pathParams": [],
-      "queryParams": [
-        {
-          "name": "zipcode",
-          "type": "string",
-          "required": false,
-          "source": "spec"
-        },
-        {
-          "name": "limit",
-          "type": "integer",
-          "required": false,
-          "description": "1ページあたりの件数",
-          "source": "curation"
-        },
-        {
-          "name": "cursor",
-          "type": "string",
-          "required": false,
-          "description": "次ページの取得に使うカーソル",
-          "source": "curation"
-        }
-      ],
-      "body": null,
-      "resultPath": null,
-      "risk": "read",
-      "aliases": []
-    }
+    {"name":"search","domain":"address","operationId":"address.search","method":"GET","path":"/v2/address/search","summary":"郵便番号から住所を検索","pathParams":[],"queryParams":[{"name":"zipcode","type":"string","required":false,"source":"spec"},{"name":"limit","type":"integer","required":false,"description":"1ページあたりの件数","source":"curation"},{"name":"cursor","type":"string","required":false,"description":"次ページの取得に使うカーソル","source":"curation"}],"body":null,"resultPath":null,"risk":"read","aliases":[]}
   ]
 }