@tocca-systems/twp-cli 0.21.0 → 0.23.0

package/CHANGELOG.public.md

@@ -11,6 +11,16 @@
 `CHANGELOG.md` に残してあります。顧客向けの履歴は public 公開以降を対象とします。
 -->
 
+## 0.23.0
+
+会話の中で AI が TWP のデータを調べて使えるようになりました。AI は必要な操作を検索し、内容を確かめてから実行します。TWP のデータを読む・書く操作は、実行前に確認が表示されます（削除は毎回確認します）。
+
+プロジェクトコードに小文字や空白を使っている場合でも、エージェントループがタスクの進み具合を正しく読み取れるようになりました。タスクが先に進んでいるのに同じ作業の再開が止められる、リリースを止めている不具合の修正が後回しになる、といったことが起きなくなります。
+
+## 0.22.0
+
+AI が git の差分や履歴を読むときに、リポジトリ側で設定された外部の差分表示コマンドを実行しないようになりました。信用できないリポジトリで「変更点を見て」と頼んだだけで、そのリポジトリが仕込んだコマンドが動いてしまうことを防ぎます。差分そのものは通常どおり表示されます。
+
 ## 0.21.0
 
 確認画面が「はい」「はい、今後聞かない」「いいえ、代わりにこうして」の3択になりました。「今後聞かない」では、このセッション中だけか、このプロジェクトでは今後も聞かないかを選べます。後者は `~/.twp/project-permissions.json` に保存され、次に起動したときも効きます（コマンド実行は `git log` のようにコマンドの先頭で保存します）。「代わりにこうして」に入力した内容は、そのまま AI への指示として伝わります。`rm -rf` や `&&` でつないだコマンドなど、毎回確認するものでは「今後聞かない」は表示されません。

package/README.md

@@ -20,6 +20,7 @@ TWP（Tocca Working Platform）を、ターミナルから使うための CLI
 |---|---|
 | **できる** | AI との会話（ストリーミング表示）。手元のファイルの読み書き・検索、コマンド実行、git の読み取り——いずれも**実行前に確認**します |
 | **できる** | `twp project` / `twp task` によるプロジェクト・タスクの読み書き（一覧・取得・作成・更新・削除・コメント） |
+| **できる** | `twp user` によるテナントのユーザーと所属（部署・役職）の参照（一覧・取得・所属の履歴）。取得と他人の所属の参照は組織管理者の権限が要ります |
 | **できる** | `twp task-loop` による、TWP のタスクキューを手元の AI CLI に実行させる常駐ループ |
 | **できる** | スラッシュコマンド: `/help` `/mode` `/model` `/clear` `/context` `/doctor` `/exit` `/demo`（動作デモ） `/tasks` `/task` `/projects`。`/tasks` などの TWP 系は `twp task list` と同じ結果を画面に出すだけで、AI は動かしません（クレジットも消費しません）。スラッシュコマンドは TUI の中だけで使えます（`twp -p` では解釈しません） |
 | **できる** | 自分用のスラッシュコマンドを markdown で追加すること（`.twp/commands/*.md` / `~/.twp/commands/*.md`・[下記](#スラッシュコマンドを自分で足す)）。入力中の `@パス` でファイルを、`#ABC-123` でタスクの内容を AI へ添付できます |
@@ -47,7 +48,9 @@ twp login            ログイン（ブラウザ委譲 / --password / --token）
 twp login --tenant <code>
                      テナントコードを先に指定する（--password のプロンプトを 1 つ省ける）
 twp logout           ログアウト（同じ資格情報で twp task-loop が稼働中なら拒否する。--force で続行）
-twp whoami           ログイン中のユーザー・テナントを表示
+twp whoami           ログイン中のユーザー・ID・テナントを表示
+twp whoami --output text --query id
+                     ログイン中ユーザーのIDだけを出す（--output json も可。トークンは出さない）
 twp update           npm の最新版・サーバが要求する最小バージョン・自動更新の状態を確認
 twp --mode biz       起動時のモードを指定（dev | biz | plan）
 twp --permission-mode denyAll
@@ -117,6 +120,27 @@ twp task label list     [--project <コード>]
 twp task list --project ACME --status 進行中 --output json --query '[].{key:key,subject:subject}'
 ```
 
+### テナントのユーザーと所属を参照する
+
+組織管理者（総務）向けに、ユーザーの一覧・詳細と所属の履歴を引きます。
+
+```
+twp user list [--department <部署>] [--position <役職>] [--employment employee|partner]
+              [--keyword <語>] [--include-hidden] [--all]
+twp user get <ユーザー>                         # 組織管理者のみ
+twp user assignment list <ユーザー> [--current] # 本人・上長・組織管理者
+```
+
+- **`<ユーザー>` は ID・メールアドレス・社員番号・氏名・`me`（自分）で指定できます。** 氏名は完全一致で1人に絞れたときだけ受け付け、同姓同名なら候補を出して止まります（メールアドレスか社員番号で指定し直してください）
+- **表示フラグを外したユーザーは、ID・メールアドレス・氏名で指定してください**（社員番号では引けません。組織管理者でない場合は ID だけです）。一覧に出すときは `--include-hidden` を付けます（組織管理者のときだけ効きます）
+- **`--department` / `--position` は名前・コード・ID のどれでも指定できます**（主所属で絞り込みます）。候補が絞れないときは候補を出して止まります
+- **失効（ログイン不可）したユーザーも一覧に出ます。** 失効かどうかは `twp user get` の `auth_type`（`disabled` なら失効）で確認できます
+- `twp user get` の要約（table / text / tsv）には個人連絡先を出しません。`--output json` は API が返す全フィールドを出します
+- `twp user assignment list` の `is_primary` は主務、`is_approval_route` はワークフローの上長承認に使われる所属です。部署名・役職名を表示するため、部署一覧と役職一覧も取得します
+- 権限が無いときは HTTP 403 をそのまま出さず、誰の権限が要るかを案内します（終了コードは 3）
+- 組織管理者でなくても `twp user list` は使えます（表示フラグが付いたユーザーだけが出ます）
+- ヘルプは `twp user help` / `twp user assignment help`
+
 ### Backlog の課題を読む・書く
 
 TWP に登録した Backlog スペースを通して、課題とコメントを読み、課題へ書きます。
@@ -365,14 +389,14 @@ mode: dev
   "permissions": {
     "allow": ["Bash(git status:*)", "Bash(npm test)", "Write(src/**)", "git(log:*)"],
     "ask": ["Bash(git push:*)"],
-    "deny": ["Bash(rm:*)", "twp_delete_task"]
+    "deny": ["Bash(rm:*)", "twp_delete_project-task"]
   }
 }
 ```
 
 | 書き方 | 意味 |
 |---|---|
-| `Bash` / `twp_update_task` | そのツール全体 |
+| `Bash` / `twp_update_project-task` | そのツール全体 |
 | `Bash(git status:*)` | `git status` で始まるコマンド（語の区切りで一致） |
 | `Bash(npm test)` | そのコマンドと完全一致 |
 | `Write(src/**)` / `Edit(src/*.ts)` / `Read(~/notes/**)` | パスの glob（素の相対と `/` 始まりは作業ディレクトリ基準・`//` 始まりは絶対パス・`~/` はホーム）。`Edit` は `write_file` も含む |
@@ -384,13 +408,14 @@ mode: dev
 - 拒否が無ければ**より具体的なルールが勝つ**（`Bash` の allow より `Bash(npm test)` の ask が強い）。同じ具体性なら上の置き場所が勝つ
 - **`Bash(git status:*)` を許可しても `git status && rm -rf .` は通らない。** 許可ルールは「解釈の余地が無い文字（英数字と `_ - . / = : , @ % +` と空白）だけでできた1本のコマンド」にしか当たらない。引用符・`$`・`#`・`~`・`*`・分岐・リダイレクトを含むものと `rm -rf` には当たらず、確認へ落ちる（`git commit -m "x"` のような引用符付きも確認になる）。拒否ルールは逆に、分岐した後ろの断片にも当たる
 - **Windows の `shell`（PowerShell / cmd）には `Bash(...)` の許可ルールを当てない**（引用と分岐の規則が bash と違うため。拒否ルールは当たる）
-- **信用できないリポジトリでは git の許可ルールも安全ではない。** `git status` は `.git/config` の `core.fsmonitor` を、`git log -p` は textconv を実行しうる。上の例の `Bash(git status:*)` / `git(log:*)` は、自分で clone した信用できるリポジトリで使う
+- **信用できないリポジトリでは git の許可ルールも安全ではない。** `git status` は `.git/config` の `core.fsmonitor` を、差分を出すコマンドは `.gitattributes` の clean フィルタを実行しうる（`git` ツールは `diff.external` と textconv を無効化して起動するが、この2つは塞げない）。上の例の `Bash(git status:*)` / `git(log:*)` は、自分で clone した信用できるリポジトリで使う
 - **リポジトリ側（`.twp/settings.json` / `.twp/settings.local.json`）は締める向きにしか効かない。** `allow` は無視して警告する（モード定義ファイルと同じ理由）。緩めるときは自分の `~/.twp/settings.json` に書くか、承認画面で「このプロジェクトでは確認しない」を選ぶ（`~/.twp/project-permissions.json` に保存される）
 - **設定ファイルが読めないと自動許可を止める。** 壊れたファイルに書いていた拒否が消えて緩むのを避けるため、直るまで「許可」は「確認」に変わる。起動時に `⚠ 権限設定:` が出たらその行を直す
 - **拒否ルールは「よくある書き方を止める網」であって、書いたコマンドを確実に止める境界ではない。** `sudo rm` `/bin/rm` `then rm` `$(rm …)` のような書き方には当たるが、`find -exec rm` のように引数の中から起動するものは拾えない。確実に止めたいならツールごと拒否する（`Bash`）か、業務・プランモードを使う
 - `Read(...)` の拒否は `grep` / `glob` にも効くが、**探索の起点がその範囲の中にあるときだけ**（リポジトリ全体を起点にした `grep` は、拒否した範囲の中まで読む）。確実に読ませないなら `Read` ごと拒否するか業務・プランモードを使う
 - 設定ファイルが読めない間は、読み取りも含めて**すべての自動許可が確認に変わる**（`-p` では確認できないので拒否になる）
-- `twp_call`（ツールを名前で呼ぶメタツール）は**中で実行されるツールの名前**で判定するよう権限エンジン側は用意してある。`twp_call` そのものを許可しても何も緩まない。**ただし `twp_call` 自体はまだ無い**（今後のバージョンで追加）
+- `twp_call`（ツールを名前で呼ぶメタツール）は**中で実行されるツールの名前**（例: `twp_list_project-task`）で判定する。`twp_call` そのものを許可しても何も緩まない。TWP API のツールは読み取りも含めて既定で確認が出る（`-p` では拒否になる）ので、確認なしで使わせたいツールは名前で許可する（例: `--allowed-tools twp_list_project-task`）。**削除系（`destructive`）は許可ルールがあっても毎回確認する**
+- モデルが TWP を調べる手順は `twp_search_tools`（名前と1行説明だけ）→ `twp_describe_tools`（スキーマ）→ `twp_call`（実行）。カタログはパッケージ同梱のコマンドモデルで、ネットワークに取りに行かない。同じドメインを続けて使うときは `twp_mount` で次のターンから常駐させられる
 
 ### 承認画面