@tocca-systems/twp-cli 0.20.0 → 0.22.0

package/CHANGELOG.public.md

@@ -11,6 +11,18 @@
 `CHANGELOG.md` に残してあります。顧客向けの履歴は public 公開以降を対象とします。
 -->
 
+## 0.22.0
+
+AI が git の差分や履歴を読むときに、リポジトリ側で設定された外部の差分表示コマンドを実行しないようになりました。信用できないリポジトリで「変更点を見て」と頼んだだけで、そのリポジトリが仕込んだコマンドが動いてしまうことを防ぎます。差分そのものは通常どおり表示されます。
+
+## 0.21.0
+
+確認画面が「はい」「はい、今後聞かない」「いいえ、代わりにこうして」の3択になりました。「今後聞かない」では、このセッション中だけか、このプロジェクトでは今後も聞かないかを選べます。後者は `~/.twp/project-permissions.json` に保存され、次に起動したときも効きます（コマンド実行は `git log` のようにコマンドの先頭で保存します）。「代わりにこうして」に入力した内容は、そのまま AI への指示として伝わります。`rm -rf` や `&&` でつないだコマンドなど、毎回確認するものでは「今後聞かない」は表示されません。
+
+エージェントループが、サーバに保存したループ設定（AI の割当・憲章・指示文面）を各サイクルの冒頭で取得して使うようになりました。サーバで設定を変えると、全ての実行機が次のサイクルから同じ設定で動きます。サーバに登録していない項目は、これまでどおり手元の設定ファイルを使います。通信が切れたときは、直前に取得した設定で動き続けます。
+
+サーバに保存するエージェントループ設定の憲章欄を、ファイルとの間で受け渡しできるようになりました。`twp task-loop charter push --project <キー> --file CONSTITUTION.md` で登録します。最初の実行では差分だけを表示し、案内されたコマンド（`--yes --revision <番号>`）で確定します。その間に管理画面で編集されていた場合は、上書きせずに止まります。`twp task-loop charter pull --project <キー>` でサーバの憲章をファイルへ書き出します。既存のファイルと内容が違うときは差分を表示し、`--yes` を付けたときだけ上書きします。
+
 ## 0.20.0
 
 TUI のスラッシュコマンドに `/tasks`（タスク一覧）・`/task <キー>`（タスクの詳細）・`/projects`（プロジェクト一覧）を追加しました。AI を動かさずに結果を表示するので、クレジットは消費しません。

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 スペースを通して、課題とコメントを読み、課題へ書きます。
@@ -378,20 +402,32 @@ mode: dev
 | `Write(src/**)` / `Edit(src/*.ts)` / `Read(~/notes/**)` | パスの glob（素の相対と `/` 始まりは作業ディレクトリ基準・`//` 始まりは絶対パス・`~/` はホーム）。`Edit` は `write_file` も含む |
 | `git(log:*)` | `git` ツールの `<サブコマンド> <引数>` |
 
-置き場所と強さ（上ほど強い）: `--allowed-tools` / `--disallowed-tools`（カンマ区切り・繰り返し可）→ セッション内の「今後聞かない」→ `.twp/settings.local.json` → `.twp/settings.json` → `~/.twp/settings.json` → モードの方針。
+置き場所と強さ（上ほど強い）: `--allowed-tools` / `--disallowed-tools`（カンマ区切り・繰り返し可）→ セッション内の「今後聞かない」→ `.twp/settings.local.json` → `.twp/settings.json` → `~/.twp/project-permissions.json`（承認画面の「このプロジェクトでは今後聞かない」）→ `~/.twp/settings.json` → モードの方針。
 
 - **拒否（deny）は常に勝つ。** どこに書いた deny も、どれだけ具体的な allow にも負けない。**モードの拒否も覆らない**（`--allowed-tools Bash` を付けても業務モードの `bash` は拒否のまま）
 - 拒否が無ければ**より具体的なルールが勝つ**（`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 した信用できるリポジトリで使う
-- **リポジトリ側（`.twp/settings.json` / `.twp/settings.local.json`）は締める向きにしか効かない。** `allow` は無視して警告する（モード定義ファイルと同じ理由）。緩めるときは自分の `~/.twp/settings.json` に書く
+- **信用できないリポジトリでは 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` 自体はまだ無い**（今後のバージョンで追加）
 
+### 承認画面
+
+確認が必要なツール呼び出しでは、実行の前に次の3択が出る（書き込みは色付きの差分を先に見せる。TWP の操作を AI が呼べるようになったら、操作名・キー・件名の要約を出す）。
+
+1. **はい**（今回だけ）
+2. **はい、今後聞かない…** — 範囲を選ぶ
+   - このセッション中は、このツールを確認しない（終了すれば忘れる）
+   - このプロジェクトでは確認しない — `~/.twp/project-permissions.json` に、リポジトリ直下のパスごとに保存する。次に起動したときも、同じリポジトリでの `twp -p` にも効く。コマンド実行（`bash` / `git`）はツール全体ではなく `git log` / `npm run test` のような**コマンドの先頭2〜3語**で保存する。`python3` `node` `sudo` `npx` など後ろに任意のコードを書けるコマンド、`./script` のようなパス、`-C` のようなフラグが2語目に来るコマンドは保存できない（このセッション中だけの許可は選べる）
+3. **いいえ、代わりにこうして…** — 入力した指示を AI に返す（実行はしない）。空のまま Enter なら拒否だけ
+
+Esc は拒否。`rm -rf` や `&&` で分岐したコマンドなど**毎回確認するもの**では「今後聞かない」が出ない（選択肢は2つになり、2 が「代わりにこうして」になる）。`@path` でファイルを添付するときの確認では 3 が「いいえ（拒否）」になる（指示を渡す相手がいないため）。保存した内容はファイルを編集すれば取り消せる。リポジトリ側の `.twp/settings.json` に書いた確認・拒否は、保存した「今後聞かない」より強い。
+
 ### `--permission-mode`（実行1回ぶんの上書き）
 
 モードの方針の上に、その実行ぶんの既定を重ねる。CI・SSH・パイプで「何が自動で通るか」を呼び出し側が明示するためのもの。
@@ -459,6 +495,21 @@ twp task-loop stop                          # このマシンで動いている
 
 止めるときは `twp task-loop stop` です。実行されたツールと権限判断は端末の監査ログ（`~/.twp/logs/`）に残ります。
 
+### 憲章をファイルとサーバで受け渡す
+
+ループが全アイテムに注入する憲章（ループ設定の憲章欄）を、ファイルとの間で登録・展開できます。常時同期はせず、実行したときだけ動きます。
+
+```bash
+twp task-loop charter push --project <キー|UUID> --file CONSTITUTION.md   # ファイル → サーバ
+twp task-loop charter pull --project <キー|UUID> [--out CONSTITUTION.md]  # サーバ → ファイル
+```
+
+- **push は `--yes` なしでは登録しません。** 差分と revision を表示し、確定用のコマンド（`--yes --revision <番号>`）を案内します。その番号を送るので、差分を見た後に管理画面で編集されていれば 409 で止まり、画面の編集を上書きしません。`--revision` を省いた `--yes` はその場で取得した revision で登録します
+- **pull は既存ファイルと内容が違うとき差分を表示し、`--yes` を付けたときだけ上書きします。** 同じなら何もしません。サーバに憲章が無いときはファイルを書きません
+- 比較は改行を含む完全一致です。書き込みには、そのプロジェクトのループ設定を変更する権限が必要です（無ければサーバの 403 をそのまま表示します）
+- 終了コードは他のコマンドと同じ規約です: `0` 反映した／差分なし ／ `1` pull でサーバに憲章が無い・ファイルを書けない ／ `2` 引数の誤り・差分があり `--yes` なし ／ `3` サーバが 4xx を返した（403・409 等）／ `4` 5xx・通信失敗 ／ `5` 認証失敗
+- 個人タスクのキュー（`--project __private__`）には憲章の設定がありません
+
 ### 必要なもの
 
 - 使う AI CLI が**インストール済みかつログイン済み**であること（`twp task-loop setup` が検出し、使えないものは理由を出して止まります）