@tocca-systems/twp-cli 0.14.0 → 0.15.0

package/CHANGELOG.public.md

@@ -11,6 +11,37 @@
 `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` と監査ログの置き場所を表示するようになりました。
+
+- `permission-mode: denyAll（read を含む全ツールを拒否）` のように、何が拒否されるかまで出ます。指定していないときは「未指定（モードの方針のまま）」と出ます。
+- `監査ログ: <パス>` … このセッションの監査ログの置き場所です。まだツールを1本も実行していない間は「未作成・最初のツール実行で作る」と付きます（ファイルは最初のツール実行で作られます）。
+- 監査ログの各行に、ツール呼び出しごとの相関IDが載るようになりました。判定（`decision`）と結果（`result`）を行の順序ではなく ID で突き合わせられます。
+
 ## 0.14.0
 
 ループが計画を立てるかどうかを設定で切り替えられるようになりました（`plan_enabled` / 環境変数 `PLAN_ENABLED`・既定は従来どおり計画します）。

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": []
+    }
+  ]
+}