@tocca-systems/twp-cli 0.14.1 → 0.15.0

package/CHANGELOG.public.md

@@ -11,6 +11,29 @@
 `CHANGELOG.md` に残してあります。顧客向けの履歴は public 公開以降を対象とします。
 -->
 
+## 0.15.0
+
+モードを自分で調整できるようになりました。`.twp/modes/dev.md`（プロジェクト）や `~/.twp/modes/dev.md`（個人）に markdown を置くと、そのモードのラベル・色・使えるツール・権限・モデルへの指示を上書きできます。書き間違えても起動は止まらず、警告を出して既定の設定で続きます。
+
+`twp api <パス>` を追加しました。画面でできる操作はすべて API のパスを持つので、
+`twp task` / `twp project` などに出ていない操作へもここから到達できます。
+
+  twp api /v2/projects?limit=10
+  twp api /v2/tasks/{taskId} --method PUT --body-file body.json --yes
+  twp api /v2/attendance/records --method POST --generate-cli-skeleton > in.json
+
+GET 以外は `--yes` が必要です（送る内容は `--dry-run` で先に確認できます）。
+
+応答に載る token / secret / api_key / password などの値は、既定で伏字にして出します
+（出力は端末やログに平文で残るためです）。発行した鍵を受け取るなど値そのものが要るときは
+`--no-redact` を付けてください。
+
+使い方は `twp api help` を見てください。
+
+API 操作の定義カタログをパッケージへ同梱しました。インストールサイズが約 2.7MB 増えます。
+起動時間は変わりません（必要なドメインのファイルだけを実行時に読みます）。
+引数の詳細説明は、人手で内容を確かめたものだけを載せています（順次拡充します）。
+
 ## 0.14.1
 
 `/context` に、いま効いている `--permission-mode` と監査ログの置き場所を表示するようになりました。

package/README.md

@@ -258,6 +258,33 @@ twp login
 
 **モデルはモードと直交する。** 業務モードに切り替えてもモデルは変わらない（`/model` で別に切り替える）。
 
+#### モードを自分で調整する
+
+モードは markdown ファイルで上書きできる。置き場所は**プロジェクトの `.twp/modes/<モード名>.md`**（そのリポジトリで作業する全員に効く）と、**`~/.twp/modes/<モード名>.md`**（自分の全プロジェクトに効く）。プロジェクト側が強い。
+
+```markdown
+---
+label: 開発（社内）
+color: green
+tools:
+  - read_file
+  - grep
+  - glob
+  - git
+permissions:
+  git: ask
+---
+このリポジトリでは、変更する前に必ず既存の実装を読んでから提案してください。
+```
+
+- ファイル名（または front-matter の `id`）が `dev` / `biz` / `plan` のどれかに一致するモードを上書きする。**新しいモードの追加には未対応**
+- `tools` は**置き換え**（書いたものがそのモードの常駐ツールになる）。`permissions` は**重ね合わせ**で、書いていないツールは既定のまま——業務モードの `bash: deny` を書き忘れても拒否は外れない。緩めたいときは `bash: ask` のように明示的に書く
+- **`model` は書けない**（モデルはモードと直交するため。`/model` で切り替える）
+- front-matter より後ろの本文は、そのモードでの指示としてモデルへ渡る
+- **リポジトリ側（`.twp/modes/`）の定義は権限を緩められない。** 他人のリポジトリを clone しただけで確認なしにコマンドが走る状態を作らないため、`.twp/modes/` に書いた `allow` は無視して警告する（**厳しくする指定は効く**）。緩めるときは自分の `~/.twp/modes/` に書く
+- **書き間違えても起動は止まらない。** 読めなかった項目は警告を出して既定へ戻る。起動時に `⚠ モード定義:` が出たらその行を直す
+- いま何が効いているかは `/context` で確認できる（どのファイルが効いているか・有効ツール glob・常駐ツールの実体が出る）
+
 ### `--permission-mode`（実行1回ぶんの上書き）
 
 モードの方針の上に、その実行ぶんの既定を重ねる。CI・SSH・パイプで「何が自動で通るか」を呼び出し側が明示するためのもの。

package/command-model/account-lock.json

@@ -0,0 +1,108 @@
+{
+  "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": []
+    }
+  ]
+}

package/command-model/address.json

@@ -0,0 +1,40 @@
+{
+  "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": []
+    }
+  ]
+}