@tyhld/conductor 0.12.125 → 0.12.127

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.125",
3
+ "version": "0.12.127",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -5,6 +5,7 @@
5
5
  "_note_force_push": "★強い上書きの push の禁止は【旗の位置ごとに1行ずつ】要る(便 e619bd86・実地は便 6e8d85e6)。この一覧は公式の仕様どおり「語の並びの当てはめ」でしか測れないので、旗が動詞の直後に来る形(末尾 :* の3件)・旗が末尾ぴったりの形(* の3件)・旗の後ろにまだ語が続く形(* … * の3件)を、それぞれ書かないと閉まらない。実地(便 6e8d85e6 の 2-A)で、末尾ぴったりの形は「後ろに語が続く形」の規則では当たらず、中間の位置と後ろに別の旗が付く形は「末尾ぴったりの規則」では当たらないことを確かめたので、両方を持つ。★`*` と `:*` を混ぜた書き方は `*` がリテラルになり何も止めないので足さない(便 07ee11a2・退役済み)。★この一覧では閉められない形(部分命令の前に場所や設定を指す旗を挟む形・先頭が + の参照指定を引用符で囲う形)は、番人(policy.py の _force_push_token_danger)が語の並びに直してから止める=二層で守る。",
6
6
  "_note_read": "★Read(…) の禁止は【二重の守りの外側】(便 93b2fa03・えふさん確定 2026-09-16)。秘密の読み取りを本当に判定しているのは番人(~/.tyhld/hooks の policy.py の secret_reason)で、そちらは Read だけでなく NotebookRead・Grep・Glob・MCP・file:// まで同じ境界で止める。この一覧は【番人が外された機体でも Read だけは止まる】ための保険なので、番人より粗い。粗さの実害は1つだけ: Read(**/*.env) は example.env のような前置きの雛形まで止める(.env.example は止まらない)。番人の方は雛形を通すので、番人が入っている機体では今までどおり雛形を読める。 ★2026-09-16(便 3a3771b1)に「名前だけの規則」を1本外し、場所で名指しする規則に替えた。外したのは credentials という名前だけの Read 規則で、依存の部品(node_modules)の中の同じ名前のフォルダまで止め、現場の build と差分確認を落としていた(実測2件・11リポジトリ中)。本物の置き場(.aws / .gcloud / .config/gcloud / .azure / .ssh / .gnupg)は場所で名指しして守っているので、止める範囲は1つも減っていない。★この一覧の書き方(glob)では「依存の部品の中だけ除く」が書けない。名前が同じでも中身が違う、という判断は場所と管理主体を見ないとできず、glob は場所のパターンしか書けないため。だから外側のこの一覧は【場所】だけで名指しし、名前だけでは言い切れない物の可否は番人(policy.py の (4))が「機械が入れた部品の中か」を git の事実で確かめて決める。 ★2026-09-17(便 336e74e5=D1 方式D 第一便)に、遅くて安全性に寄与しない `**/` の Read 禁止を24件 退役した(実測:ホーム由来17本で本物のツリーの囲い起動が約7秒・広い鍵/認証で約3秒遅くなる。 D1b 重大発見1)。退役の内訳=(1) ホーム由来の `**/`(.ssh・.aws・.gnupg・.config/gcloud・.azure・.netrc・.pypirc・id_rsa* ほか・.tyhld・.config/gh/hosts.yml)=`**/` は作業場所の中だけに当たり home には当たらない(仕様)ので、home は ~/ 絶対パスの規則で守る。(2) 広い鍵・認証の `**/`(*.pem・*.key・credentials.json・auth.json・*login.json・*.env)=依存の部品(node_modules)を大量に歩いて遅く、番人(policy.py の secret_reason)が同じ名前を form A で止めるので重複(依存の中の credentials.json は番人が許すので通常開発も壊れない)。(3) .npmrc=中身は ${NPM_TOKEN} の参照だけで秘密の実値は無い。囲いで /dev/null 化すると @tyhld の取り寄せが壊れる(重大発見3)。残した `**/`=リポの中の .env 系(.env・.env.local・.env.development・.env.production・.env.test・.env.vercel・.env.*.local)=台本経由(form B)の持ち出しを囲いの OS 層で止めるのに要る。★退役した規則は update-guard が各現場からも外す(正本が配った物だけ・顧客が足した規則は消さない)。",
7
7
  "_note_home_secret": "★ホーム配下(リポの外)の秘密の置き場は【場所で1つずつ名指し】する(えふさん確定 2026-09-17・便 230c3175=D2)。~/ で始まる規則はホームからの場所、**/ で始まる規則は作業場所(リポ)の中だけに当たる(Claude Code 仕様)。★$HOME/** や ~/*token* のような広い書き方はしない。理由は2つ: (1) 通常の作業(npm・gh・git・build)が要るホームのファイルまで止める。(2) サンドボックスはこの一覧を OS の読み取り禁止に写すが、ホームに * を含む書き方は起動が 7〜18 秒遅くなるか、効かない(実測: ~/*/.env.local 17.5秒・~/.env* 8.5秒で効かず・~/*token* 15.7秒で効かず。場所を名指しした形は 0.25〜0.32 秒で効く)。★わざと禁止しない置き場(通常の作業に要る・中身の取り出しは番人が別に止める): ~/.npmrc(npm install が読む。npm config get の _auth 表示は番人が止める)、~/.config/gh/hosts.yml(gh と git push が読む。gh auth token・git credential fill は番人が止める)、~/.claude/session-env(Claude Code 自身が読む)、~/.bashrc・~/.profile(シェルが読む。中に秘密を置かないのが本筋)、~/.android/debug.keystore(開発用の署名)。★機体ごとに名前が違う置き場(ホーム直下の token・secret の名前のファイル、ホーム直下に残ったリポの写しの .env など)は、配る一覧では名指しできない。番人(policy.py の _home_secret_reason)が名前で止めるほか、必要なら機体の ~/.claude/settings.json に場所を足す。★フォルダごとの持ち出し(cp -r・rsync・tar・ln -s・コマンドに書いたプログラムでの複製)は番人が、写す元の中に秘密が在るかを名前だけで調べて止める。【限界】台本のファイルの中で写す形と、名前を書かずに読む子プロセスは、サンドボックスの無い現場では番人でも止まらない(OS の層が要る)。",
8
+ "_note_deny_loaded_claude": "★職人が起動時に読み込む置き場(.claude の下の commands・agents・hooks・skills・rules・plugins・workflows と、入口のファイル settings*.json)への Edit を床として止める(便 3164b3fd)。足した理由: これらは設定ファイルを1文字も変えずに職人の振る舞いを変えられる(道具が起動時に読み込んで、技能・子の職人・差し込み・指示文として使う)のに、この一覧は settings.json と hooks しか覆っていなかった(便 d1c60bac の重大発見1・2)。★Write(…) の行は足さない。Claude Code の deny では Write(…) はファイルの許可判定に当たらず(効かない)、便 88e008ab で15本すべて退役済み。Write の道具を止めているのは番人(policy.py の decide_write)で、Write・Edit・MultiEdit・NotebookEdit を同じ場所の一覧で止める。★本当に判定しているのは番人(GUARD_PLACES =.claude の下をまるごと場所で守る)で、この一覧は【番人が古い機体でも Edit だけは止まる】ための保険。だから番人より粗い(新しい置き場が増えたときは番人が先に守る)。★~/.claude/projects(自動の覚え書きと手番の控え)は、道具が設計上そこへ書く所なので一覧に入れない(入れると覚え書きが毎回止まる)。★既存の行は1行も外していない。",
8
9
  "_note_network": "★外への通信は全部通す(allowedDomains: [\"*\"]・えふさん決定 2026-09-03=甲)。販売版もお客さま機で自走するのが既定(2026-08-23 決定)。理由: サンドボックスの通信許可の問いは管制の3ボタンでは押せず(Claude Code 2.1.258 本体の作り・実測 2026-09-03)、端末に人が居ないと職人が止まったままになるため。★緩むのは『電話をかける』だけ。『金庫を持ち出す』(秘密の持ち出し)を止めるのは番人 cc2_guard.py の別判定で、通信設定とは独立に効き続ける。★下の deniedDomains は allowedDomains より先に判定されるので、本番DBへの直結禁止は \"*\" を入れても効いたまま(実測で確認)。この行を消すと本番DBが開くので消さないこと。",
9
10
  "permissions": {
10
11
  "defaultMode": "default",
@@ -77,6 +78,22 @@
77
78
  "Edit(**/.dev.vars.preview)",
78
79
  "Edit(**/.claude/settings.json)",
79
80
  "Edit(**/.claude/hooks/**)",
81
+ "Edit(**/.claude/settings.local.json)",
82
+ "Edit(~/.claude/settings.json)",
83
+ "Edit(~/.claude/settings.local.json)",
84
+ "Edit(**/.claude/commands/**)",
85
+ "Edit(**/.claude/agents/**)",
86
+ "Edit(**/.claude/skills/**)",
87
+ "Edit(**/.claude/rules/**)",
88
+ "Edit(**/.claude/plugins/**)",
89
+ "Edit(**/.claude/workflows/**)",
90
+ "Edit(~/.claude/hooks/**)",
91
+ "Edit(~/.claude/commands/**)",
92
+ "Edit(~/.claude/agents/**)",
93
+ "Edit(~/.claude/skills/**)",
94
+ "Edit(~/.claude/rules/**)",
95
+ "Edit(~/.claude/plugins/**)",
96
+ "Edit(~/.claude/workflows/**)",
80
97
  "Edit(**/.tyhld/**)",
81
98
  "Edit(**/.ssh/**)",
82
99
  "Edit(**/*.pem)",
@@ -188,6 +188,8 @@ branch protection は「CI が通っていない物を main に入れない」
188
188
  | --- | --- |
189
189
  | `site-file` | どの `.claude` フォルダでも `settings…` で始まるファイル(ホームと各現場の `settings.json`・`settings.local.json`) |
190
190
  | `home-tree` | `~/.claude/skills`・`~/.tyhld/hooks`・`~/.tyhld/bin`・`~/.config/systemd`(中身ぜんぶ) |
191
+ | `loaded-tree` | **職人が起動時に読み込む `.claude` の下(中身ぜんぶ)**。持ち主の `~/.claude`・作業場所とその上の階層の `.claude`(`commands`・`agents`・`hooks`・`skills`・`rules`・`plugins`・`workflows` ほか・便 3164b3fd) |
192
+ | `loaded-tree-skip` | その中で**道具が設計上そこへ書く所**=`.claude/projects`(自動の覚え書き `projects/<現場>/memory/` と手番の控え)。ここは守りの対象から外す(外さないと覚え書きが毎回止まる) |
191
193
  | `home-agent` | ホーム直下の隠しフォルダの `hooks.json`・`config.toml`(`~/.codex` の2つを含む・道具名を持たない一般形・ADR-022) |
192
194
  | `abs-tree` | 管理設定 `/etc/claude-code` 配下・`/Library/Application Support/ClaudeCode` 配下 |
193
195
 
@@ -214,7 +216,24 @@ Windows 側の殻(`powershell` / `pwsh` / `cmd` の `-c` / `-Command` / `/c`
214
216
  扱います。★**中身が読めない形で `root` の指定が付いた呼び出しは DENY**(命令が1語も無い=root の殻を開く・
215
217
  `bash` / `sh` / `su` / `sudo` のように殻を開くだけ・変数やコマンド置換で決まる・符号化して渡す形)。
216
218
  符号化した中身を Windows 側の殻へ渡す形(`-EncodedCommand`)も DENY です。
219
+ ★**殻の名前は `.exe` の有無・大文字小文字・逆斜線の道筋を問わずそろえ、旗は短縮形も見ます**
220
+ (便 3164b3fd で塞いだ抜け3つ=拡張子なしの大文字混じりの名前・旗の `-enc` / `-ec` / `-e`。
221
+ 名前の正本は `_OPAQUE_CODE_FLAG_NAMES`、見分けは `_is_opaque_code_flag` の前方一致)。
222
+ ★Linux の道具の名前は1文字も変えません(大文字小文字で別の物なので、そろえると判定が緩む側に動くため)。
217
223
  ★**読むだけは通します**(`wsl.exe -u root cat <場所>`・`wsl.exe -l -v`・`wsl.exe --version`)。
224
+ ★ふつうの中身の渡し方(`-Command "…"`・`/c "…"`・`-File <台本>`)は今までどおり通します。
225
+
226
+ ★**職人が起動時に読み込む `.claude` の下は、場所でまるごと守ります**(便 3164b3fd・`loaded-tree`)。
227
+ `commands`・`agents`・`hooks`・`skills`・`rules`・`plugins`・`workflows` の下へ、ファイルを作る・書く・
228
+ 写す・流し込む・別の言語から書く・フォルダを作る・書き換える・消す形は、**走る行も書く道具(Write・Edit)も
229
+ DENY** です。読み込み先は公式の説明と道具の実体で確かめました(現場の `.claude` は作業場所から上の階層へ
230
+ たどって読み、持ち主の `~/.claude` も読む)。★名前を数え上げるのではなく `.claude` の下をまるごと守るので、
231
+ 新しい置き場が増えても漏れません。★**読むだけ(`cat`・`grep`・`ls`・Read・Grep)は今までどおり通します。**
232
+
233
+ ★**使い捨ての作業場の `.claude` は、一律に除外しません**(けいさん確定 2026-10-09)。
234
+ その `.claude` が**職人が読み込む側**(持ち主のホーム・作業場所とその上の階層)なら、`/tmp` の下でも守ります
235
+ (`_is_loaded_claude_path`)。読み込まれない置き場に置いた**試験用の作り物**(ADR-014 の実機事例=`/tmp` の
236
+ 下に作った偽のホームの木)は、今までどおり通します。
218
237
 
219
238
  ★**読むだけは通します**(`cat`・`less`・`grep`・`rg`・`diff`・`jq`・`ls`・`stat`・`git status`・外へ写す `cp`)。
220
239
  通常開発・作業ブランチ・正規 merge も通します。使い捨ての作業場(`/tmp` の下)の同じ名前も通します。
@@ -232,6 +251,11 @@ Windows 側の殻(`powershell` / `pwsh` / `cmd` の `-c` / `-Command` / `/c`
232
251
  | 別の機械への書き込み(`scp x host:<場所>`・`rsync a host:…`) | 範囲外 | この機体の番人の設定ではない |
233
252
  | Windows 側の相互運用の呼び出しで包む形(`wsl.exe -u root <書き込み>`・Windows 側の殻ごし) | 塞いだ | `_INTEROP_WRAPPERS` を包みの一覧へ入れ、中身を素と同じ判定にかける(便 04da1a56) |
234
253
  | 相互運用の呼び出しを**別の名前に写して**打つ形(`cp /mnt/c/.../wsl.exe /tmp/w; /tmp/w …`) | 塞いでいない | 名前で見分ける作りの限界。既存の包み(`bash` を写した形)と同じ(便 04da1a56) |
254
+ | 職人が読み込む `.claude` の下(`commands`・`agents`・`hooks`・`skills`・`rules`・`plugins`・`workflows`)へ物を置く形 | 塞いだ | `.claude` の下を場所でまるごと守る(便 3164b3fd・`loaded-tree`)。走る行も書く道具も同じ一覧を通る |
255
+ | 符号化して渡す形の、拡張子なしの大文字混じりの殻の名前・旗の短縮形(`-enc`・`-ec`・`-e`) | 塞いだ | 殻の名前をそろえ、旗を前方一致で見る(便 3164b3fd) |
256
+ | `.claude` **そのもの**を空のフォルダとして作る形(`mkdir -p ~/.claude`) | 塞いでいない | 空のフォルダでは読み込む物が0件=振る舞いが変わらない。**その中へ物を置く形はすべて止まる**(置けないので穴にならない) |
257
+ | `.claude/projects` の下(自動の覚え書き・手番の控え) | 塞いでいない(意図して外した) | 道具が設計上そこへ書く所。守ると覚え書きの書き込みが毎回止まる=通常の操作が壊れる。★ここに置いた物も毎回の手番に読み込まれるので、**残る穴として正直に記す** |
258
+ | 使い捨ての場所に置いた、**読み込まれない** `.claude` の形の試験データ | 塞いでいない(意図して外した) | ADR-014 の決め(名前ではなく場所で守る)。★ただし**その使い捨ての場所が作業場所やその上の階層なら守る**。将来その置き場で職人を起こすと読み込まれる形は、書いた時点では見分けられない(残る穴) |
235
259
 
236
260
  ★塞いでいないものの最後の砦は **OS の層(サンドボックス)** です。ここは「字面で見える書き込み」を
237
261
  広く塞ぐ層で、字面から見えない道(台本・未知の道具・別プロセス)は設計上の限界として残ります。
@@ -535,6 +559,12 @@ Claude Code 側のフック打ち切り(`timeout: 600`)と同時に終わる
535
559
  未知の道具に秘密を渡す形(`mytool .env`)は素通りします。
536
560
  ここを「引数に字面があれば止める」まで広げると、コミットメッセージや説明文に `.env` と
537
561
  書いただけで止まってしまい(実際に止まりました)、日常の作業が回らなくなるためです。
562
+ - 職人が読み込む `.claude` の下は場所で守りますが(便 3164b3fd)、次の2つは**意図して外しています**。
563
+ ① `.claude/projects` の下(自動の覚え書き `projects/<現場>/memory/` と手番の控え)。道具が設計上
564
+ そこへ書く所で、守ると覚え書きの書き込みが毎回止まります。★ここに置いた物も毎回読み込まれるので、
565
+ **穴として残ります**。② 使い捨ての場所に置いた、**読み込まれない** `.claude` の形の試験データ
566
+ (ADR-014 の決め)。★**その使い捨ての場所が作業場所やその上の階層なら守ります**が、
567
+ 「将来その置き場で職人を起こすと読み込まれる」形は、書いた時点では見分けられません。
538
568
  - 番人の設定への書き込み(便 c05796ec)は、コマンドの字面で見える書き込みだけを止めます。
539
569
  台本の**ファイル**(`bash scripts/x.sh`・`node x.mjs`)の中の書き込みは見ません。
540
570
  プログラムの中は「場所が書く呼び出しと同じ文に在る」か「場所を入れた変数を書く文で使う」形だけを拾います。
@@ -706,27 +706,59 @@ _WINDOWS_SHELLS = frozenset({'powershell', 'pwsh', 'cmd'})
706
706
  #: Windows 側の殻が「中身」を渡すための旗(大文字小文字を問わずに照らす)。
707
707
  _WIN_CODE_FLAGS = frozenset({'-c', '-command', '-commandwithargs', '-encodedcommand', '/c', '/k'})
708
708
 
709
+ #: 中身を確かめられない渡し方(符号化して渡す形)の旗の名前(★ここが正本・一覧を2つ持たない)。
710
+ # ★Windows 側の殻は、この旗を短く書ける(`-enc`・`-ec`・`-e`)。短縮は【前方一致】で見るので、
711
+ # `encodedcommand` の前方一致にならない書き方(`ec`)だけを、もう1つの綴りとして持つ。
712
+ _OPAQUE_CODE_FLAG_NAMES = ('encodedcommand', 'ec')
713
+ _OPAQUE_CODE_FLAG_NAME = _OPAQUE_CODE_FLAG_NAMES[0]
714
+
709
715
  #: 中身を確かめられない渡し方(符号化して渡す形)。
710
- _INTEROP_OPAQUE_FLAGS = frozenset({'-encodedcommand', '--encodedcommand'})
716
+ _INTEROP_OPAQUE_FLAGS = frozenset({'-' + _OPAQUE_CODE_FLAG_NAME, '--' + _OPAQUE_CODE_FLAG_NAME})
711
717
 
712
718
  #: 中の命令が「殻を開くだけ」で、何をするかが字面に無い形。
713
719
  _ROOT_SHELL_VERBS = frozenset({'su', 'login', 'sudo', 'doas'})
714
720
 
715
721
 
722
+ #: Windows 側の名前(相互運用の呼び出し・Windows 側の殻)。★大文字小文字を区別しない側の名前。
723
+ _WINDOWS_NAMES = _INTEROP_WRAPPERS | _WINDOWS_SHELLS
724
+
725
+
716
726
  def _exe_base(token: str) -> str:
717
727
  """道具の名前(道筋を落とした字面)。
718
728
 
719
- ★Windows 側の実行ファイルの形(`.exe` 付き・大文字小文字・逆斜線の道筋)のときだけ、
720
- その飾りを外して小文字にそろえる。`.exe` で終わらない名前は1文字も変えない
721
- (=今までの判定を1つも変えない。実コードに `.exe` を見る行は元から0行だった)。
729
+ ★Windows 側の実行ファイルの形(`.exe` 付き・大文字小文字・逆斜線の道筋)は、
730
+ その飾りを外して小文字にそろえる。
731
+ ★【塞いだ抜け(便 d1c60bac の重大発見3・この便で直した)】前は「`.exe` で終わるときだけ」
732
+ 小文字へそろえていたので、拡張子なしの大文字混じり(`PowerShell` = Windows 側では
733
+ 同じ道具)が一覧と一致せず素通りした。Windows 側の名前は大文字小文字を区別しないので、
734
+ `.exe` の有無に依らずそろえる。
735
+ ★それ以外の名前(Linux の道具)は1文字も変えない。Linux では大文字小文字で別の物なので、
736
+ そろえると「探すだけの道具」の見分けなどが緩む側に動く(=止まる物を通さないため)。
722
737
  """
723
738
  base = token.split('/')[-1]
724
739
  low = base.lower()
725
740
  if low.endswith('.exe'):
726
741
  return low.split('\\')[-1][:-4]
742
+ win = low.split('\\')[-1]
743
+ if win in _WINDOWS_NAMES:
744
+ return win
727
745
  return base
728
746
 
729
747
 
748
+ def _is_opaque_code_flag(token: str) -> bool:
749
+ """Windows 側の殻へ「符号化した中身」を渡す旗か(★短縮形も=前方一致で見る)。
750
+
751
+ ★【塞いだ抜け(便 d1c60bac の重大発見3・この便で直した)】Windows 側の殻の旗は、
752
+ 曖昧でない範囲で短く書ける(`-EncodedCommand` → `-enc`・`-ec`・`-e`)。
753
+ 前は長い形の字面だけを見ていたので、短縮形が素通りした。
754
+ ★名前の正本は _OPAQUE_CODE_FLAG_NAMES だけ(一覧を2つ持たない)。
755
+ """
756
+ if not isinstance(token, str) or not token.startswith('-'):
757
+ return False
758
+ name = token.lower().lstrip('-').split('=', 1)[0].split(':', 1)[0]
759
+ return bool(name) and any(n.startswith(name) for n in _OPAQUE_CODE_FLAG_NAMES)
760
+
761
+
730
762
  def _skip_interop_flags(tokens, i: int) -> int:
731
763
  """相互運用の呼び出しの旗を飛ばして、中の命令が始まる位置を返す。"""
732
764
  while i < len(tokens) and tokens[i].startswith('-'):
@@ -784,12 +816,14 @@ def _opaque_shell_danger(tokens):
784
816
  ★中身が符号化されていると、番人は1文字も測れない=「剥がせない包み」そのもの。
785
817
  相互運用の呼び出しを中に隠せるので、この渡し方は危険として止める。
786
818
  ★ふつうの中身(`-Command "…"`・`/c "…"`)は今までどおり測る(止めない)。
819
+ ★殻の名前は `.exe` の有無・大文字小文字を問わず、旗は短縮形(`-enc`・`-ec`・`-e`)も見る
820
+ (便 3164b3fd で塞いだ抜け=_exe_base・_is_opaque_code_flag)。
787
821
  """
788
822
  for i, t in enumerate(tokens):
789
823
  if _exe_base(t) not in _WINDOWS_SHELLS:
790
824
  continue
791
825
  for a in tokens[i + 1:]:
792
- if a.lower() in _INTEROP_OPAQUE_FLAGS:
826
+ if _is_opaque_code_flag(a):
793
827
  return 'windows shell with an encoded (unreadable) command'
794
828
  return None
795
829
 
@@ -3303,7 +3337,9 @@ def _real_segments(command: str):
3303
3337
  # ③ 先に決めた変数・~・$HOME・${HOME}・相対の道・波括弧・* を解いてから、一覧と照らす。
3304
3338
  # ④ 中身を走らせる形(bash -c・eval・<<<・ヒアドキュメント・$(…)・`…`・find -exec)は中身を測り直す。
3305
3339
  # 【止めないもの】読むだけ(cat・less・grep・rg・diff・jq・ls・stat・git status・外へ写す cp)。
3306
- # 使い捨ての作業場(/tmp の下)に作った同じ名前(Write と同じ例外 is_throwaway_path)。
3340
+ # 使い捨ての作業場(/tmp の下)に作った同じ名前(Write と同じ例外 _throwaway_ok)。
3341
+ # ★ただし、その `.claude` が【職人の起動時に読み込まれる側】(持ち主のホーム・作業場所と
3342
+ # その上の階層)なら、使い捨ての場所でも守る(便 3164b3fd・けいさん確定 2026-10-09)。
3307
3343
  # 報告やコミットの説明に場所の名前が書いてあるだけ(引用符の中の `>` も書き込みと読まない)。
3308
3344
  # ═════════════════════════════════════════════════════════════════════════════
3309
3345
 
@@ -3314,9 +3350,26 @@ def _real_segments(command: str):
3314
3350
  #: home-agent … ホーム直下の隠しフォルダに置かれた、この名前のファイル。道具の番人の登録と設定。
3315
3351
  #: ★道具の名前を持たない一般の形(番人の判定に道具名を持ち込まない決め・ADR-022)。
3316
3352
  #: abs-tree … 絶対パスの置き場(管理設定=managed settings)
3353
+ #: loaded-tree … 職人の起動時に読み込まれる置き場(中身ぜんぶ・ホームでも現場でもその上の階層でも)
3354
+ #: loaded-tree-skip … その中で【設計上そこへ書く】所(覚え書き・手番の控え)=守りの対象から外す
3317
3355
  GUARD_PLACES = (
3318
3356
  ('site-file', '.claude/settings'),
3319
3357
  ('home-tree', '.claude/skills'),
3358
+ # ★職人が起動時に読み込む置き場は【まるごと】守る(便 3164b3fd)。
3359
+ # 【塞いだ穴(便 d1c60bac の重大発見1・2)】守っていたのは入口のファイル(settings*)と
3360
+ # ~/.claude/skills だけで、`commands`・`agents`・`hooks`・`rules`・`plugins`・`workflows` の
3361
+ # 下へファイルを置く形は走る行も書く道具も素通りしていた。道具はこれらを起動時に読み込んで
3362
+ # 職人の振る舞いを変えるので、設定ファイルを1文字も変えずに職人を動かせる経路だった。
3363
+ # 【根拠(公式の説明と道具の実体で確かめた)】読み込むのは「持ち主の ~/.claude」と
3364
+ # 「作業場所とその上の階層の .claude」(公式: 現場の .claude/agents は作業場所から上へ
3365
+ # たどって読み、~/.claude/agents も読む/.claude/commands・.claude/skills・.claude/rules も
3366
+ # 現場と持ち主の両方/~/.claude/plugins は入れた物の置き場)。
3367
+ # ★名前を数え上げるのではなく `.claude` の下をまるごと守る(新しい置き場が増えても漏れない)。
3368
+ ('loaded-tree', '.claude'),
3369
+ # ★ここは職人(道具)が設計上そこへ書く所なので外す。外さないと、道具に備わった
3370
+ # 覚え書きの書き込みが毎回止まる(=通常の操作が壊れる)。
3371
+ # 公式: 自動の覚え書きは ~/.claude/projects/<現場>/memory/ に置かれ、手番の控えも同じ下。
3372
+ ('loaded-tree-skip', '.claude/projects'),
3320
3373
  # ★~/.tyhld は【まるごと】守る(便 7aa63a97)。
3321
3374
  # 【実地の穴(便 b7bd5e43 の発見・2026-10-03 に再現)】Write・Edit は前から ~/.tyhld の
3322
3375
  # どこでも止めていた(下の「前からの広い守り」)。ところが Bash は hooks と bin の下しか
@@ -3377,10 +3430,75 @@ def _home_rels(abs_paths):
3377
3430
  return out
3378
3431
 
3379
3432
 
3380
- def _place_reason_abs(p: str):
3433
+ def _loaded_claude_parents(cwd=None):
3434
+ """職人が起動時に `.claude` を読み込む「親フォルダ」たち。
3435
+
3436
+ ★公式の説明どおり、持ち主のホームと、作業場所からその上の階層ぜんぶ。
3437
+ """
3438
+ out = set(_homes())
3439
+ base = cwd if (isinstance(cwd, str) and os.path.isabs(cwd)) else os.getcwd()
3440
+ base = os.path.normpath(base).rstrip('/')
3441
+ while True:
3442
+ out.add(base or '/')
3443
+ parent = os.path.dirname(base)
3444
+ if parent == base:
3445
+ break
3446
+ base = parent
3447
+ return out
3448
+
3449
+
3450
+ def _is_loaded_claude_path(p: str, cwd=None) -> bool:
3451
+ """絶対パスの中の `.claude` が、職人が【起動時に読み込む側】の物か。
3452
+
3453
+ ★使い捨ての作業場(/tmp の下)でも、読み込まれる側なら守る(便 3164b3fd・けいさん確定
3454
+ 2026-10-09:使い捨ての場所の .claude を一律に除外しない)。読み込まれない置き場に
3455
+ 置いた試験用の作り物(ADR-014 の実機事例=/tmp の下に作った偽のホームの木)は、
3456
+ 親フォルダが読み込みの対象でないので、ここでは False=今までどおり通す。
3457
+ """
3458
+ site_dirs = {sf.split('/')[0] for sf in _places('site-file')} | set(_places('loaded-tree'))
3459
+ comps = p.split('/')
3460
+ parents = None
3461
+ for i, c in enumerate(comps):
3462
+ if c in site_dirs:
3463
+ if parents is None:
3464
+ parents = _loaded_claude_parents(cwd)
3465
+ if ('/'.join(comps[:i]) or '/') in parents:
3466
+ return True
3467
+ return False
3468
+
3469
+
3470
+ def _throwaway_ok(p: str, cwd=None) -> bool:
3471
+ """使い捨ての作業場の作り物として通してよいか(★読み込まれる `.claude` は通さない)。"""
3472
+ return is_throwaway_path(p) and not _is_loaded_claude_path(p, cwd)
3473
+
3474
+
3475
+ def _loaded_tree_reason(path: str):
3476
+ """職人が読み込む置き場の【下】へ書く形か(`.claude/<置き場>/…`)。
3477
+
3478
+ ★`.claude` そのもの(空のフォルダを作るだけ)はここでは答えない(親の判定が見る)。
3479
+ ★設計上そこへ書く所(loaded-tree-skip)は外す。
3480
+ """
3481
+ comps = [c for c in path.replace('\\', '/').split('/') if c]
3482
+ for d in _places('loaded-tree'):
3483
+ if d not in comps:
3484
+ continue
3485
+ i = comps.index(d)
3486
+ if len(comps) <= i + 1:
3487
+ continue
3488
+ rel = '/'.join(comps[i:])
3489
+ if any(rel == s or rel.startswith(s + '/') for s in _places('loaded-tree-skip')):
3490
+ continue
3491
+ return f'agent config loaded at launch ({d}/{comps[i + 1]})'
3492
+ return None
3493
+
3494
+
3495
+ def _place_reason_abs(p: str, cwd=None):
3381
3496
  """絶対パス1つ(解いた後)が一覧の場所か。"""
3382
- if _site_file_match(p) and not is_throwaway_path(p):
3497
+ if _site_file_match(p) and not _throwaway_ok(p, cwd):
3383
3498
  return 'guard settings (.claude/settings*.json)'
3499
+ r = _loaded_tree_reason(p)
3500
+ if r and not _throwaway_ok(p, cwd):
3501
+ return r
3384
3502
  for root in _places('abs-tree'):
3385
3503
  if p == root or p.startswith(root + '/'):
3386
3504
  return f'managed settings ({root})'
@@ -3400,9 +3518,15 @@ _GLOB_CHARS_RE = re.compile(r'[*?\[]')
3400
3518
 
3401
3519
 
3402
3520
  def _tail_reason(tail: str):
3403
- """解けない部分の後ろの字面(例 `/.tyhld/hooks/p.py`)が、一覧のどこかの形か。"""
3521
+ """解けない部分の後ろの字面(例 `/.tyhld/hooks/p.py`)が、一覧のどこかの形か。
3522
+
3523
+ ★解けない変数は「どこを指すか確かめられない」=守る側で測る(使い捨てかも見分けられない)。
3524
+ """
3404
3525
  if _site_file_match(tail):
3405
3526
  return 'guard settings (.claude/settings*.json)'
3527
+ r = _loaded_tree_reason(tail)
3528
+ if r:
3529
+ return r
3406
3530
  for d in _places('home-tree'):
3407
3531
  if ('/' + d + '/') in tail or tail.endswith('/' + d) or tail.startswith(d + '/'):
3408
3532
  return f'guard directory (~/{d})'
@@ -3421,10 +3545,13 @@ def _concrete_places(cwd=None):
3421
3545
  for h in _homes():
3422
3546
  out += [os.path.join(h, '.claude', 'settings.json'), os.path.join(h, '.claude', 'settings.local.json')]
3423
3547
  out += [os.path.join(h, d) for d in _places('home-tree')]
3548
+ # ★読み込まれる置き場も `*` を含む書き方と照らす(例 `~/.claude/*/x.md`)。
3549
+ out += [os.path.join(h, d) for d in _places('loaded-tree')]
3424
3550
  for name in _places('home-agent'):
3425
3551
  out += glob.glob(os.path.join(h, '.*', name))
3426
3552
  base = cwd if (isinstance(cwd, str) and os.path.isabs(cwd)) else os.getcwd()
3427
3553
  out += [os.path.join(base, '.claude', 'settings.json'), os.path.join(base, '.claude', 'settings.local.json')]
3554
+ out += [os.path.join(base, d) for d in _places('loaded-tree')]
3428
3555
  out += list(_places('abs-tree'))
3429
3556
  return out
3430
3557
 
@@ -3444,7 +3571,7 @@ def guard_config_reason(path: str, cwd=None):
3444
3571
  except Exception: # noqa: BLE001
3445
3572
  return None
3446
3573
  for p in (lit, real):
3447
- r = _place_reason_abs(p)
3574
+ r = _place_reason_abs(p, cwd)
3448
3575
  if r:
3449
3576
  return r
3450
3577
  if _UNRESOLVED_RE.search(lit):
@@ -3457,16 +3584,16 @@ def guard_config_reason(path: str, cwd=None):
3457
3584
  except Exception: # noqa: BLE001
3458
3585
  hits = []
3459
3586
  for h in hits[:200]:
3460
- r = _place_reason_abs(os.path.normpath(h))
3587
+ r = _place_reason_abs(os.path.normpath(h), cwd)
3461
3588
  if r:
3462
3589
  return r
3463
3590
  pc = lit.split('/')
3464
3591
  for c in _concrete_places(cwd):
3465
3592
  cc = c.split('/')
3466
- is_tree = _place_reason_abs(c + '/x') is not None and not _site_file_match(c)
3593
+ is_tree = _place_reason_abs(c + '/x', cwd) is not None and not _site_file_match(c)
3467
3594
  if len(pc) == len(cc) or (is_tree and len(pc) > len(cc)):
3468
3595
  if fnmatch.fnmatchcase(c, '/'.join(pc[:len(cc)])):
3469
- r = _place_reason_abs(c) or _place_reason_abs(c + '/x')
3596
+ r = _place_reason_abs(c, cwd) or _place_reason_abs(c + '/x', cwd)
3470
3597
  if r:
3471
3598
  return r
3472
3599
  return None
@@ -3488,7 +3615,7 @@ def guard_ancestor_reason(path: str, cwd=None):
3488
3615
  if p in _homes():
3489
3616
  return 'guard settings folder (~)'
3490
3617
  site_dirs = {sf.split('/')[0] for sf in _places('site-file')}
3491
- if p.split('/')[-1] in site_dirs and not is_throwaway_path(p):
3618
+ if p.split('/')[-1] in site_dirs and not _throwaway_ok(p, cwd):
3492
3619
  return f'guard settings folder ({p.split("/")[-1]})'
3493
3620
  for root in _places('abs-tree'):
3494
3621
  if root.startswith(p + '/') or p == '/':
@@ -3852,7 +3979,7 @@ def _find_danger(args, cwd):
3852
3979
  for c in places:
3853
3980
  if not names or any(fnmatch.fnmatchcase(os.path.basename(c), n) or fnmatch.fnmatchcase(c, '*' + n)
3854
3981
  for n in names):
3855
- return f'{_place_reason_abs(c) or "guard settings"} changed by find'
3982
+ return f'{_place_reason_abs(c, cwd) or "guard settings"} changed by find'
3856
3983
  return None
3857
3984
 
3858
3985
 
@@ -4982,7 +5109,8 @@ def decide_write(file_path: str, cwd=None):
4982
5109
  # ★字面だけでなく、近道(symlink)を解いた実体も見る。別名の近道
4983
5110
  # (例 /tmp/shortcut → ~/.claude)から本物へ書き込むのを塞ぐ。
4984
5111
  # ★Bash と同じ場所の一覧(GUARD_PLACES)だけで守る(便 2.6・場所を2か所に書かない)。
4985
- gr = guard_config_reason(path)
5112
+ # ★作業場所も渡す(読み込まれる `.claude` かの見分けに要る=便 3164b3fd・Bash と同じ判定)。
5113
+ gr = guard_config_reason(path, cwd)
4986
5114
  if gr:
4987
5115
  return _r(DENY, f'danger: write to {gr}')
4988
5116
  # ★前からの広い守り(~/.tyhld のどこでも)は、弱めないためにそのまま残す。
@@ -0,0 +1,238 @@
1
+ #!/usr/bin/env python3
2
+ """職人が起動時に読み込む置き場(`.claude` の下)を「場所」で守る試験(便 3164b3fd)。
3
+
4
+ 実行: python3 scripts/hooks/test_loaded_claude_dirs.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【塞いだ穴(便 d1c60bac の重大発見1・2)】
8
+ 守っていたのは入口のファイル(`settings*`)と `~/.claude/skills` だけだった。
9
+ `commands`・`agents`・`hooks`・`rules`・`plugins`・`workflows` の下へファイルを置く形は、
10
+ 走る行も書く道具も素通りしていた。道具はこれらを【起動時に読み込んで職人の振る舞いを変える】ので、
11
+ 設定ファイルを1文字も変えずに職人を動かせる経路だった。
12
+
13
+ 【守る場所の決め方(名前の数え上げではなく「読み込む場所」)】
14
+ 公式の説明と道具の実体で確かめた読み込み先は、持ち主の `~/.claude` と、
15
+ 作業場所からその上の階層ぜんぶの `.claude`。だから `.claude` の下をまるごと守る。
16
+ ★設計上そこへ書く所(`.claude/projects` =自動の覚え書きと手番の控え)だけ外す。
17
+
18
+ 【使い捨ての作業場の区別(けいさん確定 2026-10-09)】
19
+ 使い捨ての場所の `.claude` を一律に除外しない。
20
+ ・その `.claude` が【職人が読み込む側】(持ち主のホーム・作業場所とその上の階層)なら守る。
21
+ ・読み込まれない置き場に置いた試験用の作り物(ADR-014 の実機事例=/tmp の下の偽のホームの木)は
22
+ 今までどおり通す。
23
+ """
24
+ import os
25
+ import sys
26
+
27
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
28
+
29
+ import policy # noqa: E402
30
+
31
+ failures = []
32
+
33
+
34
+ def check(label, got, want):
35
+ ok = got == want
36
+ if not ok:
37
+ failures.append(f'{label}: got={got!r} want={want!r}')
38
+ print(f'{"OK " if ok else "NG "} {label:78} {str(got)[:16]}')
39
+
40
+
41
+ # ── 部品(守る場所・危険語を直接は書かない) ──
42
+ CLA = '.cla' + 'ude'
43
+ SET = 'sett' + 'ings'
44
+ HOME = os.path.expanduser('~')
45
+ WORK = '/srv/site-sample' # 現場(/tmp の外・場所は字面で決まるので実在しなくてよい)
46
+ TMPWORK = '/tmp/claude-1000/karaburi-3164b3fd' # 使い捨ての作業場(複製の置き場の形)
47
+ MEMO = f'{CLA}/projects' # 設計上そこへ書く所(覚え書き・手番の控え)
48
+
49
+ # 道具が起動時に読み込む置き場(公式の説明と道具の実体で確かめた)。
50
+ LOADED = ['commands', 'agents', 'hooks', 'skills', 'rules', 'plugins', 'workflows']
51
+
52
+
53
+ def dbash(cmd, cwd=WORK):
54
+ return policy.decide_bash(cmd, cwd)['decision']
55
+
56
+
57
+ def dwrite(path, cwd=WORK):
58
+ return policy.decide_write(path, cwd)['decision']
59
+
60
+
61
+ def dn(label, cmd, cwd=WORK):
62
+ check(f'{label}: {cmd[:56]!r}', dbash(cmd, cwd), policy.DENY)
63
+
64
+
65
+ def al(label, cmd, cwd=WORK):
66
+ check(f'{label}: {cmd[:56]!r}', dbash(cmd, cwd), policy.ALLOW)
67
+
68
+
69
+ def forms(p):
70
+ """中身の作り方(作成・書き込み・写し・流し込み・別の言語・フォルダ作成・書き換え・消す)。"""
71
+ d = os.path.dirname(p)
72
+ body = 'open(' + repr(p) + ", 'w').write('x')"
73
+ return [
74
+ ('作成', f'touch {p}'),
75
+ ('流し込み', f'echo x > {p}'),
76
+ ('追記', f'echo x >> {p}'),
77
+ ('写し', f'cp /tmp/a.md {p}'),
78
+ ('流し込み(tee)', f'echo x | tee {p}'),
79
+ ('別の言語から', f'python3 -c "{body}"'),
80
+ ('フォルダ作成', f'mkdir -p {d}'),
81
+ ('書き換え', f'sed -i s/a/b/ {p}'),
82
+ ('消す', f'rm {p}'),
83
+ ]
84
+
85
+
86
+ def wraps(cmd):
87
+ """包み(素・管理者権限の命令ごし・相互運用の包み・殻の中)。
88
+
89
+ ★殻の中の形は、引用符を含まない中身のときだけ重ねる(重ねた引用符は命令として壊れるため。
90
+ 引用符を含む中身=別の言語から書く形は、③で正しい重ね方を1つずつ測る)。
91
+ """
92
+ adm = 'su' + 'do'
93
+ interop = 'ws' + 'l.exe'
94
+ out = [('素', cmd),
95
+ ('管理者権限の命令ごし', f'{adm} {cmd}'),
96
+ ('相互運用の包み', f'{interop} -u root -- {cmd}')]
97
+ if '"' not in cmd and "'" not in cmd:
98
+ out.append(('殻の中', f'bash -c "{cmd}"'))
99
+ return out
100
+
101
+
102
+ print('── ① 持ち主・現場・その上の階層の読み込む置き場(置き場×中身×包み) ' + '─' * 10)
103
+ n1 = 0
104
+ for where, base in [('持ち主', f'{HOME}/{CLA}'), ('現場', f'{WORK}/{CLA}'), ('上の階層', f'/srv/{CLA}')]:
105
+ for sub in LOADED:
106
+ p = f'{base}/{sub}/probe.md'
107
+ for fname, cmd in forms(p):
108
+ for wname, wcmd in wraps(cmd):
109
+ n1 += 1
110
+ dn(f'① {where}/{sub} {fname}/{wname}', wcmd)
111
+ check('① 測った形の数', n1, 3 * len(LOADED) * (8 * 4 + 3))
112
+
113
+ print('\n── ② 書く道具(Write・Edit)でも同じ結果 ' + '─' * 24)
114
+ for where, base in [('持ち主', f'{HOME}/{CLA}'), ('現場', f'{WORK}/{CLA}'), ('上の階層', f'/srv/{CLA}')]:
115
+ for sub in LOADED:
116
+ p = f'{base}/{sub}/probe.md'
117
+ check(f'② Write {where}/{sub}', dwrite(p), policy.DENY)
118
+ check(f'② Edit {where}/{sub}', policy.decide_event(
119
+ {'tool_name': 'Edit', 'tool_input': {'file_path': p}, 'cwd': WORK})['decision'], policy.DENY)
120
+
121
+ print('\n── ③ 深い階層・解けない変数・* を含む書き方も守る ' + '─' * 18)
122
+ dn('③ 深い階層', f'echo x > {HOME}/{CLA}/agents/review/deep/probe.md')
123
+ _py = 'open(\\"' + f'{HOME}/{CLA}/commands/probe.md' + '\\", \\"w\\").write(\\"x\\")'
124
+ dn('③ 別の言語から(殻を重ねた形)', f"bash -c 'python3 -c \"{_py}\"'")
125
+ dn('③ 別の言語から(流し込む形)', f'python3 - <<PY\nopen("{HOME}/{CLA}/agents/probe.md", "w").write("x")\nPY')
126
+ dn('③ 別の言語から(node)', f'node -e \'require("fs").writeFileSync("{HOME}/{CLA}/agents/probe.md","x")\'')
127
+ dn('③ 解けない変数', f'echo x > "$D/{CLA}/commands/probe.md"')
128
+ dn('③ * を含む書き方', f'cp /tmp/a.md {HOME}/{CLA}/*/probe.md')
129
+ dn('③ 波括弧', f'touch {HOME}/{CLA}/{{commands,agents}}/probe.md')
130
+ dn('③ 置き場ごと写し込む', f'cp -r /tmp/pack/ {HOME}/{CLA}/agents/')
131
+ dn('③ 展開して置く', f'tar xf /tmp/p.tar -C {HOME}/{CLA}/commands')
132
+ dn('③ 取ってきて置く', f'curl -o {HOME}/{CLA}/agents/probe.md https://example.invalid/a')
133
+ dn('③ 近道を張る', f'ln -s /tmp/x.md {HOME}/{CLA}/commands/probe.md')
134
+ dn('③ 動かす(先)', f'mv /tmp/x.md {HOME}/{CLA}/agents/probe.md')
135
+ dn('③ 動かす(元)', f'mv {HOME}/{CLA}/agents/probe.md /tmp/away.md')
136
+
137
+ print('\n── ④ 使い捨ての場所でも、職人が読み込む側なら守る(区別の線) ' + '─' * 10)
138
+ n4 = 0
139
+ for sub in LOADED:
140
+ p = f'{TMPWORK}/{CLA}/{sub}/probe.md'
141
+ for fname, cmd in forms(p):
142
+ n4 += 1
143
+ dn(f'④ 使い捨ての作業場/{sub} {fname}', cmd, TMPWORK)
144
+ check(f'④ Write 使い捨ての作業場/{sub}', dwrite(p, TMPWORK), policy.DENY)
145
+ check('④ 入口のファイルも同じ', dbash(f'echo {{}} > {TMPWORK}/{CLA}/{SET}.json', TMPWORK), policy.DENY)
146
+ check('④ 測った形の数', n4, len(LOADED) * 9)
147
+
148
+ print('\n── ⑤ 読み込まれない試験用のデータは今までどおり通す(ADR-014 の線) ' + '─' * 6)
149
+ FIXTURE = f'/tmp/claude-1000/fixture/home/projects/s/{CLA}'
150
+ for fname, cmd in forms(f'{FIXTURE}/agents/probe.md'):
151
+ al(f'⑤ 読み込まれない作り物 {fname}', cmd)
152
+ al('⑤ 入口のファイルの作り物', f'echo {{}} > {FIXTURE}/{SET}.json')
153
+ check('⑤ Write も通す', dwrite(f'{FIXTURE}/agents/probe.md'), policy.ALLOW)
154
+ # ★作業場所が使い捨ての下に在っても、読み込まれない深い置き場の作り物は通す。
155
+ for fname, cmd in forms(f'{TMPWORK}/fixture/home/p/{CLA}/agents/probe.md'):
156
+ al(f'⑤ 使い捨ての作業場の中の作り物 {fname}', cmd, TMPWORK)
157
+
158
+ print('\n── ⑥ 設計上そこへ書く所(覚え書き・手番の控え)は止めない ' + '─' * 12)
159
+ al('⑥ 覚え書きへ書く', f'echo x >> {HOME}/{MEMO}/p/memory/MEMORY.md')
160
+ al('⑥ 覚え書きのフォルダを作る', f'mkdir -p {HOME}/{MEMO}/p/memory')
161
+ al('⑥ 手番の控えのフォルダを作る', f'mkdir -p {HOME}/{MEMO}/p/s/tool-results')
162
+ check('⑥ Write も通す', dwrite(f'{HOME}/{MEMO}/p/memory/note.md'), policy.ALLOW)
163
+
164
+ print('\n── ⑦ 通常の操作は1つも止めない ' + '─' * 28)
165
+ NORMAL = [
166
+ ('ふつうのファイルを作る', f'touch {WORK}/docs/new.md'),
167
+ ('ふつうのファイルへ書く', f'echo x > {WORK}/docs/new.md'),
168
+ ('ふつうのファイルを直す', f'sed -i s/a/b/ {WORK}/docs/new.md'),
169
+ ('現場の試験を流す', 'npm test'),
170
+ ('現場の試験を流す(番人の試験)', 'python3 scripts/hooks/test_policy.py'),
171
+ ('git: 名指しで記録に入れる', 'git add docs/new.md'),
172
+ ('git: 記録する', 'git commit -m x'),
173
+ ('git: 状態を見る', 'git status'),
174
+ ('git: 枝を切る', 'git switch -c feat/x --no-track origin/main'),
175
+ ('読み取り: 中身を見る', f'cat {HOME}/{CLA}/{SET}.json'),
176
+ ('読み取り: 探す', f'grep -n hooks {HOME}/{CLA}/{SET}.json'),
177
+ ('読み取り: 一覧', f'ls -la {HOME}/{CLA}/agents'),
178
+ ('読み取り: 現場の置き場の一覧', f'ls {WORK}/{CLA}/commands'),
179
+ ('読み取り: 外へ写す', f'cp {HOME}/{CLA}/agents/x.md /tmp/claude-1000/copy.md'),
180
+ ('使い捨ての置き場へ書く', 'echo x > /tmp/claude-1000/notes.md'),
181
+ ('報告の文に場所の名前が在るだけ', f'git commit -m "fix: {HOME}/{CLA}/agents への書き込みを止める"'),
182
+ ('ふつうの殻の呼び出し', 'powershell.exe -Command "Get-Date"'),
183
+ ('ふつうの殻の呼び出し(道筋つき・大文字混じり)', 'PowerShell -Command "Get-Date"'),
184
+ ('ふつうの殻の呼び出し(cmd)', 'cmd.exe /c "echo hi"'),
185
+ ('配布の一覧', 'ws' + 'l.exe --list --verbose'),
186
+ ]
187
+ for label, cmd in NORMAL:
188
+ al(f'⑦ {label}', cmd)
189
+ # 読み取りの道具は止めない(中身は見える・場所の守りは書き込みだけ)。
190
+ for tool in ('Read', 'Grep'):
191
+ key = 'file_path' if tool == 'Read' else 'path'
192
+ check(f'⑦ {tool} の道具で読む', policy.decide_event(
193
+ {'tool_name': tool, 'tool_input': {key: f'{HOME}/{CLA}/agents/x.md'}, 'cwd': WORK})['decision'],
194
+ policy.ALLOW)
195
+
196
+ print('\n── ⑧ 符号化して渡す形の抜け3つ(殻の名前・旗の短縮形) ' + '─' * 14)
197
+ ENC = 'Encoded' + 'Command'
198
+ SHELLS = ['Power' + 'Shell', 'power' + 'shell.exe', 'pw' + 'sh', 'PWSH.EXE',
199
+ 'C:\\\\Windows\\\\System32\\\\WindowsPowerShell\\\\v1.0\\\\Power' + 'Shell']
200
+ FLAGS = ['-' + ENC, '-' + ENC.lower(), '-' + ENC.upper(), '-enc', '-ec', '-e', '-Enc', '--' + ENC]
201
+ n8 = 0
202
+ for sh in SHELLS:
203
+ for fl in FLAGS:
204
+ n8 += 1
205
+ dn(f'⑧ {sh[-12:]} {fl}', f'{sh} {fl} ZQBjAGgAbwA=')
206
+ check('⑧ 測った形の数', n8, len(SHELLS) * len(FLAGS))
207
+ # ふつうの中身の渡し方は止めない(代わりの書き方が在る=止めると普通の作業が壊れる)。
208
+ for cmd in ['Power' + 'Shell -Command "Get-Date"', 'pw' + 'sh -c "Get-Date"',
209
+ 'cmd.exe /c "echo hi"', 'Power' + 'Shell -File C:\\\\tmp\\\\a.ps1',
210
+ 'Power' + 'Shell -ExecutionPolicy Bypass -File C:\\\\tmp\\\\a.ps1']:
211
+ al('⑧ ふつうの中身の渡し方', cmd)
212
+ # 名前の飾りの外し方は、Linux の道具の名前を1文字も変えない(大文字は別の物)。
213
+ check('⑧ 名前の飾り: 殻の名前はそろえる', policy._exe_base('Power' + 'Shell'), 'power' + 'shell')
214
+ check('⑧ 名前の飾り: .exe もそろえる', policy._exe_base('PWSH.EXE'), 'pw' + 'sh')
215
+ check('⑧ 名前の飾り: Linux の名前は変えない', policy._exe_base('GREP'), 'GREP')
216
+
217
+ print('\n── ⑨ 場所の一覧は1か所だけ(同じ一覧を2つ持たない) ' + '─' * 16)
218
+ check('⑨ 読み込む置き場が一覧に在る', '.claude' in [p for k, p in policy.GUARD_PLACES if k == 'loaded-tree'], True)
219
+ check('⑨ 外す所が一覧に在る', '.claude/projects' in [p for k, p in policy.GUARD_PLACES if k == 'loaded-tree-skip'],
220
+ True)
221
+ check('⑨ 前から守っている行は残っている',
222
+ all(e in policy.GUARD_PLACES for e in (('site-file', '.claude/settings'),
223
+ ('home-tree', '.claude/skills'),
224
+ ('home-tree', '.tyhld'),
225
+ ('home-tree', '.tyhld/hooks'),
226
+ ('home-tree', '.tyhld/bin'),
227
+ ('home-tree', '.config/systemd'),
228
+ ('home-agent', 'hooks.json'),
229
+ ('home-agent', 'config.toml'),
230
+ ('abs-tree', '/etc/claude-code'))), True)
231
+
232
+ print()
233
+ if failures:
234
+ print(f'FAILURES: {len(failures)}')
235
+ for f in failures:
236
+ print(' -', f)
237
+ sys.exit(1)
238
+ print('ALL OK')
@@ -162,16 +162,24 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
162
162
  止まる書き方を最初から使わなければ、打ち直しの往復が要らない。★番人の判定は変えない(弱めない)。
163
163
 
164
164
  ★**この表は「止まらない書き方を最初から選ぶため」の物で、止められた後に回避する根拠にしない**(けいさん確定 2026-10-09 20:15・便 b53481c2 の違反が元)。
165
- この節のどの行にも、先に次の3つが掛かる(鉄則4の言い切りは1文字も弱まらない)。
165
+ この節のどの行にも、先に次の①〜⑦が掛かる(鉄則4の言い切りは1文字も弱まらない)。
166
166
  ① **便に停止の指示がある場合は停止を優先する。**
167
167
  ② **止められた理由が分からないときは、別の方法(別の命令・別の道具・別の置き場・別の写し)を試さない。**
168
168
  ③ そのときは、**止められた命令の全文と番人の文を報告して止まる**(鉄則4・人の手番)。
169
+ ④ ★**書き方の決まりだけを指摘されて止められたときは、条件付きで書き直して続けてよい**(けいさん確定 2026-10-09 21:02)。続けてよいのは、次の4つが**すべて**そろうときだけ。
170
+ - (ア) 番人が**書式上の理由と直し方を明示している**=番人の文が `discipline` で始まる種類(理由と直す形がその1行に書いてある。この種類は Bash の命令にだけ出る4つ=まとめて足す `git add`・まとめて記録に入れる `git commit`・`cd` を他の命令とつなぐ形・全体の再帰検索)。
171
+ - (イ) 書き直しが、元の操作の**目的・対象・権限・副作用を広げない**(やることは同じで、書き方だけを直す)。
172
+ - (ウ) 書き直しが、**便の禁止事項に触れない**。
173
+ - (エ) **便に停止の指示が無い**(①が先に掛かる)。
174
+ ⑤ ★**次のどれかなら、書き直さずに止めて報告する。** 危険な操作として止められた(番人の文が `danger` で始まる種類)/**禁止の一覧・囲い(サンドボックス)・事前検査で止められた**(この3つは書き方の決まりの種類ではない)/止められた理由が分からない/(イ)(ウ) を満たすかどうか**判定できない**。
175
+ ⑥ ★**書き直して続けた場合も、報告に3つを書く。** 止められた命令の全文・番人の文・書き直した命令。
176
+ ⑦ ★**この決まりは、過去の違反をあとから承認する物ではない**(けいさん確定 2026-10-09 21:02)。番人の判定は1つも変わらない(弱めない)。
169
177
 
170
178
  - **cd を `&&` でつなぐ**(`cd 先 && 何か`・cd とリダイレクトを同じ行に混ぜる)→ 止まる。**cd は作業のはじめに1回だけ単独で**打ち、以後は絶対パスか `git -C <実際のパス>`(鉄則2)。
171
179
  - **リポの根やホームを再帰で検索する**(`grep -rn 語 .`・`rg 語 .`・`grep -rn 語 ~`・`grep -rn 語 /home/…/リポ`)→ 止まる。★**実際に止まっているのはこの形**で、`cat .npmrc` のような直接読みではない(便 f6b9ddb6 の9回はすべて普通の再帰検索が秘密ファイルに当たった形)。**探す場所をフォルダ名で名指しする。**
172
180
  - 通る例: `grep -rn 'relay' src docs` / `rg 'relay' src docs` / 追跡済みだけ見るなら `git grep -n 'relay' -- src docs`
173
181
  - ★**除外指定では通らない**(実測 2026-09-27)。`grep -rn 語 . --exclude=.npmrc` は、`.` の再帰でまず止まり、さらに**秘密のファイル名を引数に書いた事自体**でも止まる。「除いて探す」ではなく「場所を名指しする」が正解。
174
- - ★**上の形は最初から選ぶ物で、止められた後の替え先ではない。** フォルダ名を名指しした形でも止められたなら、探す場所や道具を替えて打ち直さず、止められた命令の全文と番人の文を報告して止まる(この節の冒頭の①〜③・便 b53481c2 §8 の1番がこの形だった)。
182
+ - ★**上の形は最初から選ぶ物。** ただし全体を指す形が**書き方の決まりで止められた**(番人の文が `discipline` で始まり、理由と直し方が書いてある)ときは、冒頭④の(ア)〜(エ)をすべて満たす限り、上の形へ書き直して続けてよい(⑥のとおり報告に3つを書く)。★**フォルダ名を名指しした形でも止められたなら、それは書き方の決まりの種類ではない**(場所を名指しした形は書き方の決まりでは止まらない)ので、探す場所や道具を替えて打ち直さず、止められた命令の全文と番人の文を報告して止まる(冒頭の①〜③と⑤・便 b53481c2 §8 の1番がこの形だった)。
175
183
  - **秘密のファイルを読む・引数に名前を書く**(`cat ~/.npmrc`・`--exclude=.npmrc`)→ 止まる。**中身は見に行かない。** 差分は対象を名指しで `git diff -- src docs`、全体で見たいときは除いて `git diff -- . ':(exclude).npmrc'`(`git diff` は中身を読み出す動詞ではないので、この形は通る・鉄則1)。
176
184
  - **標準エラーの捨て先を、あとで文字列の途中に差し込む変数の中に入れる**(`S="$(何か 2>/dev/null)"` と置き、別の行で `"repos/<その変数>/branches/…"` のように使う)→ 止まる。番人は変数を字面で展開してから測り直すので、捨て先が `/dev/null` ではなく**その後ろのパスが貼り付いた別の名前**として取り出され、`/dev` 直下への書き込みに見える(実測 2026-09-27。鉄則7の塊がこれで6便すべて止まっていた)。**文句を捨てる所を、小さな関数1か所に寄せる。**
177
185
  - 通る例: 先に `q() { "$@" 2>/dev/null; }` を置き、以後は `S="$(q 何か)"` と書く(★変数の値に捨て先が入らないので、どこに差し込んでも止まらない)。