@tyhld/conductor 0.12.127 → 0.12.129

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.127",
3
+ "version": "0.12.129",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -21,6 +21,7 @@
21
21
  "!scripts/hooks/__pycache__",
22
22
  "scripts/update-guard.sh",
23
23
  "scripts/deny-rule-shape.py",
24
+ "scripts/report-store-path.py",
24
25
  "scripts/managed-settings-audit.py",
25
26
  "scripts/dist-source.sh",
26
27
  "scripts/conductor-run.sh",
@@ -6,6 +6,8 @@
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
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行も外していない。",
9
+ "_note_deny_memo_route": "★覚え書きの置き場(~/.claude/projects)の【下に、同じ形の木をもう1つ作る形】は、この一覧では止められない(便 99edd7bf・分かっている限界)。塞いだ穴そのもの=覚え書きの置き場は道具が設計上そこへ書く所なので通しているが、その下に .claude/agents のような形を作ると、職人の振る舞いを変える物を覚え書きの中に置けた(実測 allow)。番人側で塞いだ(policy.py の _loaded_tree_reason が .claude を【出てくる所すべて】で見るようにし、外す所は持ち主のホームの下だけに限った)。★この一覧へ Edit(~/.claude/projects/**/.claude/**) を足せない理由は実測にある: ホームから始まる規則の【途中】に * を含む書き方は、サンドボックスの起動が 7〜18 秒遅くなるか、そもそも効かない(_note_home_secret の実測。許されるのは末尾の /** だけ)。この決まりは test/home-secret-deny.test.ts が安全弁として固定しているので緩めない。★作業場所の中の同じ形は、既存の Edit(**/.claude/agents/**) ほかが覆う(**/ は作業場所の中だけに当たる仕様なので、ホーム側だけが床の外に残る)。★通常の覚え書き(~/.claude/projects/<現場>/memory/ の下・手番の控え)を止める行は足していない(止めると道具に備わった覚え書きが毎回止まる)。★既存の行は1行も外していない。",
10
+ "_note_deny_workcopy": "★「リポジトリの中の部品の置き場(node_modules など)の下に使い捨ての作業用コピーを作る」形は、この一覧では止められない(便 99edd7bf・分かっている限界)。この一覧が書けるのは「道具+コマンドの字面の当てはめ」か「ファイルの場所」だけで、写しを作る形は道具が多く(取り出し・写し・同期・取り出し・近道・移動・置き場を作る)、行き先が何番目の語に来るかも旗の並びで変わるため、字面の当てはめでは漏れる。ファイルの場所で Edit(**/node_modules/**) と書くと、部品の中のファイルを直して不具合を再現する通常の作業まで止まる。だから判定は番人(policy.py の _workcopy_scan)が持ち、止めたときは discipline の文で「置き場は /tmp/claude-1000/ の下」と直し方を示す。★番人が古い機体では、この形は止まらない(実地の違反3件はその状態で起きた)。各PCで人が1回 update-guard を流すまで効かない。",
9
11
  "_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が開くので消さないこと。",
10
12
  "permissions": {
11
13
  "defaultMode": "default",
@@ -189,7 +189,7 @@ branch protection は「CI が通っていない物を main に入れない」
189
189
  | `site-file` | どの `.claude` フォルダでも `settings…` で始まるファイル(ホームと各現場の `settings.json`・`settings.local.json`) |
190
190
  | `home-tree` | `~/.claude/skills`・`~/.tyhld/hooks`・`~/.tyhld/bin`・`~/.config/systemd`(中身ぜんぶ) |
191
191
  | `loaded-tree` | **職人が起動時に読み込む `.claude` の下(中身ぜんぶ)**。持ち主の `~/.claude`・作業場所とその上の階層の `.claude`(`commands`・`agents`・`hooks`・`skills`・`rules`・`plugins`・`workflows` ほか・便 3164b3fd) |
192
- | `loaded-tree-skip` | その中で**道具が設計上そこへ書く所**=`.claude/projects`(自動の覚え書き `projects/<現場>/memory/` と手番の控え)。ここは守りの対象から外す(外さないと覚え書きが毎回止まる) |
192
+ | `loaded-tree-skip` | その中で**道具が設計上そこへ書く所**=`.claude/projects`(自動の覚え書き `projects/<現場>/memory/` と手番の控え)。ここは守りの対象から外す(外さないと覚え書きが毎回止まる)。★外すのは**持ち主のホームの下だけ**で、その**下にもう1つ `.claude` の形の木**が在れば外さない(便 99edd7bf) |
193
193
  | `home-agent` | ホーム直下の隠しフォルダの `hooks.json`・`config.toml`(`~/.codex` の2つを含む・道具名を持たない一般形・ADR-022) |
194
194
  | `abs-tree` | 管理設定 `/etc/claude-code` 配下・`/Library/Application Support/ClaudeCode` 配下 |
195
195
 
@@ -232,8 +232,19 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
232
232
 
233
233
  ★**使い捨ての作業場の `.claude` は、一律に除外しません**(けいさん確定 2026-10-09)。
234
234
  その `.claude` が**職人が読み込む側**(持ち主のホーム・作業場所とその上の階層)なら、`/tmp` の下でも守ります
235
- (`_is_loaded_claude_path`)。読み込まれない置き場に置いた**試験用の作り物**(ADR-014 の実機事例=`/tmp` の
236
- 下に作った偽のホームの木)は、今までどおり通します。
235
+ (`_is_loaded_claude_path`)。
236
+
237
+ ★**通すのは「現場の試験の作り物だと言い切れる形」だけです**(便 99edd7bf・けいさん確定 2026-10-09
238
+ 「試験用データと、実際に職人へ読み込ませる設定を区別してください。判断できないものは未確認として残します」)。
239
+ `_throwaway_ok` は次の**3つがそろったときだけ**通します。
240
+ ① 使い捨ての場所(OS の一時領域)の下に在る ② 職人が読み込む側ではない
241
+ ③ **道筋に試験の作り物の印が在る**(`_FIXTURE_MARKS` =`fixture`・`fixtures`・`scratchpad`)。
242
+ 印は**実物から引いています**=ADR-014 の実機事例 `…/scratchpad/b/home/projects/s/.claude` と、
243
+ この現場の試験が使う `…/fixture/home/projects/s/.claude`。
244
+ ★印の無い形(例 `/tmp/w/.claude/settings.json`・使い捨ての複製の中の `.claude`)は、
245
+ 「後でその置き場で職人を起こすと読み込まれる」かを見分けられないので**通しません**(未確認として止める側)。
246
+ ★各現場の試験そのものが作る作り物は、試験の**コード**が作るので職人の命令には現れません
247
+ (=番人の判定を通らない)。だからこの印の一覧を増やしても減らしても、現場の試験の通り方は変わりません。
237
248
 
238
249
  ★**読むだけは通します**(`cat`・`less`・`grep`・`rg`・`diff`・`jq`・`ls`・`stat`・`git status`・外へ写す `cp`)。
239
250
  通常開発・作業ブランチ・正規 merge も通します。使い捨ての作業場(`/tmp` の下)の同じ名前も通します。
@@ -254,12 +265,67 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
254
265
  | 職人が読み込む `.claude` の下(`commands`・`agents`・`hooks`・`skills`・`rules`・`plugins`・`workflows`)へ物を置く形 | 塞いだ | `.claude` の下を場所でまるごと守る(便 3164b3fd・`loaded-tree`)。走る行も書く道具も同じ一覧を通る |
255
266
  | 符号化して渡す形の、拡張子なしの大文字混じりの殻の名前・旗の短縮形(`-enc`・`-ec`・`-e`) | 塞いだ | 殻の名前をそろえ、旗を前方一致で見る(便 3164b3fd) |
256
267
  | `.claude` **そのもの**を空のフォルダとして作る形(`mkdir -p ~/.claude`) | 塞いでいない | 空のフォルダでは読み込む物が0件=振る舞いが変わらない。**その中へ物を置く形はすべて止まる**(置けないので穴にならない) |
257
- | `.claude/projects` の下(自動の覚え書き・手番の控え) | 塞いでいない(意図して外した) | 道具が設計上そこへ書く所。守ると覚え書きの書き込みが毎回止まる=通常の操作が壊れる。★ここに置いた物も毎回の手番に読み込まれるので、**残る穴として正直に記す** |
258
- | 使い捨ての場所に置いた、**読み込まれない** `.claude` の形の試験データ | 塞いでいない(意図して外した) | ADR-014 の決め(名前ではなく場所で守る)。★ただし**その使い捨ての場所が作業場所やその上の階層なら守る**。将来その置き場で職人を起こすと読み込まれる形は、書いた時点では見分けられない(残る穴) |
268
+ | `~/.claude/projects` の下(自動の覚え書き・手番の控え) | 塞いでいない(意図して外した) | 道具が設計上そこへ書く所。守ると覚え書きの書き込みが毎回止まる=通常の操作が壊れる。★ここに置いた物も毎回の手番に読み込まれるので、**残る穴として正直に記す** |
269
+ | 覚え書きの置き場を**経由して**守る対象へ書く形(`..` で上へ抜ける・近道の先へ書く・`mv`/`cp`/`ln` で移す) | 塞いだ | 字面を正規化した形と、近道を解いた実体の両方で一覧と照らす(便 99edd7bf で実物の近道を張って測り直した) |
270
+ | 覚え書きの置き場の**下にもう1つ `.claude` の形の木**を作る形 | 塞いだ | `.claude` を**出てくる所すべて**で見る(便 99edd7bf)。前は最初の1つしか見ず、手前の「外す所」で道筋ぜんぶが免じられていた(実測 allow) |
271
+ | 覚え書きの置き場を**張って守る場所を指す近道**(`ln -s <守る場所> <projects の下>`) | 塞いだ | 近道の「指す先」が一覧の場所なら DENY(便 99edd7bf)。先へ書く形は前から止まっていたが、張る方を残すと守る場所への道筋が覚え書きの中に出来る |
272
+ | **各現場の** `.claude/projects`(持ち主のホームの下ではない同じ名前) | 塞いだ | 外す所(覚え書き・手番の控え)はホームの下にしか無い。どこの `.claude/projects` でも免じていたのを、ホームの下だけに限った(便 99edd7bf) |
273
+ | 使い捨ての場所に置いた `.claude` の形で、**試験の作り物だと言い切れる印がある**もの(`fixture`・`fixtures`・`scratchpad`) | 塞いでいない(意図して外した) | ADR-014 の決め(名前ではなく場所で守る)。実機で止まった当のパスはこの形 |
274
+ | 使い捨ての場所に置いた `.claude` の形で、**印が無い**もの | 塞いだ | 「試験用データ」か「後で職人へ読み込ませる設定」かを区別できない=未確認として止める側に置く(便 99edd7bf・けいさん確定 2026-10-09)。★ADR-014 の線を動かした点(ADR-014 の改訂履歴に記載) |
275
+ | リポジトリの中の部品の置き場(`node_modules` など)の下に使い捨ての作業用コピーを作る形 | 塞いだ(作法=`discipline`) | 下の「1-6」 |
259
276
 
260
277
  ★塞いでいないものの最後の砦は **OS の層(サンドボックス)** です。ここは「字面で見える書き込み」を
261
278
  広く塞ぐ層で、字面から見えない道(台本・未知の道具・別プロセス)は設計上の限界として残ります。
262
279
 
280
+ ## 1-6. ★リポジトリの中の部品の置き場に、使い捨ての作業用コピーを作らせない(便 99edd7bf)
281
+
282
+ **実地の違反3件(便 c48e51a0・261a2224・85df6654/devlog 8d35b678)。** 番人が「秘密を確かめるには
283
+ 大きすぎるフォルダをまとめて写した」で止めた直後、職人は**3便続けて**部品の置き場の下
284
+ (`node_modules/.tmp-作業名`)へ現場ごとの写しを作り、作業を続けました。番人は部品の置き場の**下**への
285
+ 写しを1つも止めていませんでした(実測 allow)。写しは**記録される場所の中**に出来るので、記録に混ざる
286
+ 危険が残り、片付け(再帰の削除)も番人に止められて残骸になります。=**置き場が悪い**(鉄則13 と同じ根治)。
287
+
288
+ ### 止める物
289
+
290
+ | 何を | どこへ |
291
+ | --- | --- |
292
+ | 取り出し(`git clone`)・枝の作業場(`git worktree add`) | **現場の中の部品の置き場の下**=置き場の親が、作業場所そのもの・その上の階層・その下のどれか |
293
+ | 写し(`cp -r`・`cp -a`・`-t` で行き先を渡す形)・同期(`rsync`)・`ditto`・`rclone`・`unison` | 同じ |
294
+ | 近道(`ln`・`ln -s`)・移動(`mv`) | 同じ(★この2つは旗や元の実在に関わらず「丸ごと」と見る) |
295
+ | 固めた物の取り出し(`tar -x -C`・`--directory`・`unzip -d`・`7z -o`・`cpio`・`pax`) | 同じ |
296
+ | 置き場として新しいフォルダを作る形(`mkdir`・`mkdir -p`・`install -d`) | 同じ |
297
+
298
+ 置き場の名前は**部品置き場の正本**(`_DEPENDENCY_DIR_NAMES`)から引きます=`node_modules`・
299
+ `site-packages`・`.venv`・`venv`。★`vendor` だけ引き算で外します(記録に入れて配る現場が在り、
300
+ 中へ写すのが普通の作業になるため)。つなぎ(`;` `&&` `|`)・包み(`sudo`・相互運用の呼び出し・`bash -c`)・
301
+ 変数の展開・波括弧にも同じ判定が届きます。
302
+
303
+ ### 通す物(巻き込まない)
304
+
305
+ - 人の通常の**部品取得**(取得の命令そのもの)。写す形でも置き場を作る形でもないので判定に入りません。
306
+ - 部品の**読み取り**(中身を見る・探す・一覧する・外へ写す)。書き込む形ではありません。
307
+ - **組み立てと試験**が置き場の下に作る控え(`.cache`・`.vite`・`.turbo`・`.next` など)。
308
+ 道具が自分で作るので、職人の命令には現れません(控えを読む・名指しで消す形も通ります)。
309
+ - **使い捨ての置き場**(OS の一時領域)への写し・その中の部品の置き場。既に使い捨てなので対象外です。
310
+ - **既にある写しを名指しで消す形**(`rm -r <置き場>/<写し>`)。消す道具はこの判定の対象にしません。
311
+ - 部品の置き場**そのもの**を作る形・置き場の**外**へ写す形・名前の似たふつうのフォルダ。
312
+
313
+ ### 止めたときの文は `discipline`(直し方を示す)
314
+
315
+ `danger` ではなく **`discipline:` で始まる1行**を返し、「正しい置き場は `/tmp/claude-1000/` の下」と
316
+ 直し方(`git clone --no-hardlinks <リポの実在のパス> /tmp/claude-1000/karaburi-<便IDの頭8文字>`)を示します。
317
+ 職人は、目的・対象・権限・副作用を広げない書き直しに限って続けられます(鉄則4・便 40501fbe の決め)。
318
+
319
+ ### 分かっている限界
320
+
321
+ - **配る禁止の一覧(床)では止められません。** 写す道具が多く、行き先が何番目の語に来るかも旗の並びで
322
+ 変わるため字面の当てはめでは漏れ、場所で `Edit(**/node_modules/**)` と書くと「部品の中のファイルを
323
+ 直して不具合を再現する」通常の作業まで止まります。判定は番人が持ちます
324
+ (`sales-template/settings.json` の `_note_deny_workcopy` に同じことを記載)。
325
+ - **番人が古い機体では止まりません。** 実地の違反3件はその状態で起きました。各PCで人が1回
326
+ `APPLY=1 bash scripts/update-guard.sh` を流すまで、その機では効きません。
327
+ - 台本の**ファイル**の中で写す形(`bash scripts/x.sh` の中の `cp -r`)は見ません(便2.5 と同じ限界)。
328
+
263
329
  ## 2. ファイルの役割
264
330
 
265
331
  | ファイル | 役割 |
@@ -560,11 +626,25 @@ Claude Code 側のフック打ち切り(`timeout: 600`)と同時に終わる
560
626
  ここを「引数に字面があれば止める」まで広げると、コミットメッセージや説明文に `.env` と
561
627
  書いただけで止まってしまい(実際に止まりました)、日常の作業が回らなくなるためです。
562
628
  - 職人が読み込む `.claude` の下は場所で守りますが(便 3164b3fd)、次の2つは**意図して外しています**。
563
- ① `.claude/projects` の下(自動の覚え書き `projects/<現場>/memory/` と手番の控え)。道具が設計上
629
+ ① `~/.claude/projects` の下(自動の覚え書き `projects/<現場>/memory/` と手番の控え)。道具が設計上
564
630
  そこへ書く所で、守ると覚え書きの書き込みが毎回止まります。★ここに置いた物も毎回読み込まれるので、
565
- **穴として残ります**。② 使い捨ての場所に置いた、**読み込まれない** `.claude` の形の試験データ
566
- (ADR-014 の決め)。★**その使い捨ての場所が作業場所やその上の階層なら守ります**が、
567
- 「将来その置き場で職人を起こすと読み込まれる」形は、書いた時点では見分けられません。
631
+ **穴として残ります**(便 99edd7bf で、ここを**経由して**守る対象へ書く4経路と、ここの**下にもう1つ
632
+ `.claude` の形の木を作る**形は塞ぎました)。② 使い捨ての場所に置いた `.claude` の形で、
633
+ **試験の作り物だと言い切れる印**(`fixture`・`fixtures`・`scratchpad`)が道筋に在るもの(ADR-014 の決め)。
634
+ ★印の無い形は便 99edd7bf から**通しません**(=「将来その置き場で職人を起こすと読み込まれる」かを
635
+ 見分けられないので、未確認として止める側に置いた)。
636
+ - **印の一覧は実物2つから引いた字面です**(便 99edd7bf)。だから、これと別の名前で偽のホームの木を
637
+ 作る試験の作り物は、**人が書き方を変えるまで止まります**(止まったときの文は `danger` なので、
638
+ 職人は回避せず人の手番として報告して止まります)。下の「未確認」の形は、報告に残しています。
639
+ - リポジトリの中の部品の置き場(`node_modules` など)の下へ使い捨ての作業用コピーを作る形は
640
+ 番人が作法(`discipline`)で止めますが、**配る禁止の一覧(床)では止められません**(1-6 の限界)。
641
+ **番人が古い機体では止まりません**(実地の違反3件はその状態で起きました)。
642
+ - **覚え書きの置き場の下にもう1つ `.claude` の形の木を作る形も、床では止められません**(便 99edd7bf)。
643
+ `Edit(~/.claude/projects/**/.claude/**)` のように**ホームから始まる規則の途中に `*` を含む書き方**は、
644
+ サンドボックスの起動が 7〜18 秒遅くなるか、そもそも効きません(実測・`_note_home_secret`)。
645
+ 許されるのは**末尾の `/**` だけ**で、この決まりは `test/home-secret-deny.test.ts` が安全弁として
646
+ 固定しています。だからホーム側はこの形だけ床の外に残り、番人だけが止めます
647
+ (作業場所の中の同じ形は既存の `Edit(**/.claude/agents/**)` ほかが覆います)。
568
648
  - 番人の設定への書き込み(便 c05796ec)は、コマンドの字面で見える書き込みだけを止めます。
569
649
  台本の**ファイル**(`bash scripts/x.sh`・`node x.mjs`)の中の書き込みは見ません。
570
650
  プログラムの中は「場所が書く呼び出しと同じ文に在る」か「場所を入れた変数を書く文で使う」形だけを拾います。
@@ -456,7 +456,8 @@ _HARMLESS_DEVICES = frozenset({
456
456
  '/dev/random', '/dev/fd',
457
457
  })
458
458
 
459
- # 使い捨ての作業場(OSの一時領域)の根。★ここ【だけ】が .claude 保護の例外になる。
459
+ # 使い捨ての作業場(OSの一時領域)の根。★.claude 保護の例外は、ここの下で、かつ
460
+ # 「試験の作り物だと言い切れる形」のときだけ(_throwaway_ok の3条件・便 99edd7bf)。
460
461
  # 実機 2026-09-02 12:07: 職人が検証のために作った
461
462
  # /tmp/claude-.../scratchpad/b/home/projects/s/.claude
462
463
  # が「.claude という名前」だけで本物の設定と同じ扱いになり、ターミナルが止まった。
@@ -3467,28 +3468,70 @@ def _is_loaded_claude_path(p: str, cwd=None) -> bool:
3467
3468
  return False
3468
3469
 
3469
3470
 
3471
+ #: 使い捨ての置き場の中で「現場の試験の作り物」と言い切れる印(★実物から引いた一覧)。
3472
+ # 実物1(ADR-014 の実機事例 2026-09-02)… 職人が検証のために作った
3473
+ # /tmp/claude-…/scratchpad/b/home/projects/s/.claude(偽のホームの木)
3474
+ # 実物2(この現場の試験が実際に使う置き場)… /tmp/claude-1000/fixture/home/projects/s/.claude
3475
+ # ★各現場の試験そのものが作る作り物(使い捨てフォルダの中の偽のホーム・偽の現場)は、
3476
+ # 試験の【コード】が作るので職人の命令には現れない=番人の判定を通らない。だから
3477
+ # この一覧を増やしても減らしても、現場の試験の通り方は変わらない(実測で確かめた)。
3478
+ _FIXTURE_MARKS = frozenset({'fixture', 'fixtures', 'scratchpad'})
3479
+
3480
+
3481
+ def _is_test_fixture_path(p: str) -> bool:
3482
+ """道筋に「試験の作り物」の印が在るか(=試験用データだと言い切れる形か)。"""
3483
+ return any(c in _FIXTURE_MARKS for c in p.replace('\\', '/').split('/'))
3484
+
3485
+
3470
3486
  def _throwaway_ok(p: str, cwd=None) -> bool:
3471
- """使い捨ての作業場の作り物として通してよいか(★読み込まれる `.claude` は通さない)。"""
3472
- return is_throwaway_path(p) and not _is_loaded_claude_path(p, cwd)
3487
+ """使い捨ての作業場の作り物として通してよいか。
3488
+
3489
+ ★3つとも満たすときだけ通す(既定は守る側)。
3490
+ ① 使い捨ての場所(OS の一時領域)の下に在る
3491
+ ② 職人が【起動時に読み込む側】ではない(便 3164b3fd)
3492
+ ③ ★試験の作り物だと言い切れる印が道筋に在る(便 99edd7bf)
3493
+
3494
+ 【③を足した理由(けいさん確定 2026-10-09)】
3495
+ 「後で職人が読み込む `.claude`」を試験用として一律に通す案は承諾されなかった。
3496
+ =試験用データ(現場の試験が使う作り物で、職人の起動で読み込まれない物)と、
3497
+ 実際に職人へ読み込ませる設定を区別し、区別できない形は試験用として通さない。
3498
+ ②だけでは「いま読み込まれていない」ことしか言えず、「将来その置き場で職人を起こすと
3499
+ 読み込まれる」形(例:使い捨ての下に置き場の木を作っておき、後でそこを作業場所にする)を
3500
+ 見分けられなかった(便 3164b3fd の要判断4)。印の無い形は未確認として止める側に置く。
3501
+ """
3502
+ return (is_throwaway_path(p) and not _is_loaded_claude_path(p, cwd)
3503
+ and _is_test_fixture_path(p))
3473
3504
 
3474
3505
 
3475
- def _loaded_tree_reason(path: str):
3506
+ def _loaded_tree_reason(path: str, home_rooted: bool = False):
3476
3507
  """職人が読み込む置き場の【下】へ書く形か(`.claude/<置き場>/…`)。
3477
3508
 
3478
3509
  ★`.claude` そのもの(空のフォルダを作るだけ)はここでは答えない(親の判定が見る)。
3479
3510
  ★設計上そこへ書く所(loaded-tree-skip)は外す。
3511
+
3512
+ 【塞いだ穴2つ(便 99edd7bf・けいさん決定「覚え書きの置き場を経由して守る対象へ
3513
+ 書き込めないことを確かめて塞ぐ」)】
3514
+ ① 一覧の名前の【最初の1つ】しか見ていなかった。だから覚え書きの置き場の下に
3515
+ もう1つ同じ形の木(`.claude/projects/<現場>/.claude/agents/…`)を作ると、
3516
+ 手前の「外す所」で道筋ぜんぶが免じられ、職人の振る舞いを変える物を置けた(実測 allow)。
3517
+ ★ここを【出てくる所すべて】で見るようにした(置き場の名前は数え上げない)。
3518
+ ② 外す所(自動の覚え書き・手番の控え)は【持ち主のホームの下】にしか無いのに、
3519
+ どこの `.claude/projects` でも免じていた=各現場の `.claude` の守りがその分だけ弱かった。
3520
+ ★`home_rooted=True`(絶対パスで照らすとき)は、外す所をホームの下に限る。
3521
+ 解けない変数の後ろの字面で照らすときは手前が分からないので今までどおり免じる
3522
+ (①の直しが効くので、下にもう1つ置き場の形が在れば止まる)。
3480
3523
  """
3481
3524
  comps = [c for c in path.replace('\\', '/').split('/') if c]
3482
3525
  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]})'
3526
+ for i, c in enumerate(comps):
3527
+ if c != d or len(comps) <= i + 1:
3528
+ continue
3529
+ rel = '/'.join(comps[i:])
3530
+ if any(rel == s or rel.startswith(s + '/') for s in _places('loaded-tree-skip')):
3531
+ prefix = ('/' + '/'.join(comps[:i])).rstrip('/') if i else '/'
3532
+ if not home_rooted or prefix in _homes():
3533
+ continue
3534
+ return f'agent config loaded at launch ({d}/{comps[i + 1]})'
3492
3535
  return None
3493
3536
 
3494
3537
 
@@ -3496,7 +3539,8 @@ def _place_reason_abs(p: str, cwd=None):
3496
3539
  """絶対パス1つ(解いた後)が一覧の場所か。"""
3497
3540
  if _site_file_match(p) and not _throwaway_ok(p, cwd):
3498
3541
  return 'guard settings (.claude/settings*.json)'
3499
- r = _loaded_tree_reason(p)
3542
+ # ★絶対パスなので、外す所(覚え書きの置き場)は持ち主のホームの下だけに限って照らす。
3543
+ r = _loaded_tree_reason(p, home_rooted=True)
3500
3544
  if r and not _throwaway_ok(p, cwd):
3501
3545
  return r
3502
3546
  for root in _places('abs-tree'):
@@ -4224,6 +4268,15 @@ def _guard_write_segment(segment: str, cwd=None, command='', depth=0, env=None):
4224
4268
  srcs = [p for p in paths if p != dest]
4225
4269
  if dest is None and paths:
4226
4270
  dest, srcs = paths[-1], paths[:-1]
4271
+ # ★近道(ln)で守る場所を【指す】形も止める(便 99edd7bf・けいさん決定の
4272
+ # 「覚え書きの置き場を経由して守る対象へ書き込めないか」の確認で見つけた)。
4273
+ # 近道の【先へ書く】形は、実体を解く判定が前から止めている。張る方を残すと、
4274
+ # 守る場所を指す道筋が覚え書きの置き場の中に出来てしまう=置けないようにする。
4275
+ if verb == 'ln':
4276
+ for s in srcs:
4277
+ r = guard_config_reason(s, cwd) or guard_ancestor_reason(s, cwd)
4278
+ if r:
4279
+ return f'{r} pointed to by {verb}'
4227
4280
  if dest and ':' in dest.split('/')[0] and verb in ('scp', 'rsync'):
4228
4281
  dest = None # 別の機械への書き込み(ここは見ない)
4229
4282
  if dest:
@@ -4724,6 +4777,10 @@ _DISC_CD = ('cd を && でほかの命令とつなげない・cd とリダイレ
4724
4777
  'cd は作業のはじめに1回だけ単独で打ち、以後は絶対パスか git -C を使う(鉄則2)')
4725
4778
  _DISC_SEARCH = ('リポ全体・ホーム全体を再帰で検索しない(重く、秘密の置き場にも当たる)。'
4726
4779
  '探す場所を名指しで(例: rg 語 src/ ・ find src -name 名前)')
4780
+ _DISC_WORKCOPY = ('リポジトリの中の部品の置き場(node_modules など)の下に、使い捨ての作業用コピーを作らない'
4781
+ '(記録される場所の中に出来る・片付けも番人に止められる)。'
4782
+ '使い捨ての置き場は /tmp/claude-1000/ の下にする(鉄則13)。'
4783
+ '例: git clone --no-hardlinks <リポの実在のパス> /tmp/claude-1000/karaburi-<便IDの頭8文字>')
4727
4784
 
4728
4785
 
4729
4786
  def _discipline_tokens(command: str):
@@ -4961,8 +5018,180 @@ def _disc_search(words, cwd):
4961
5018
  return None
4962
5019
 
4963
5020
 
5021
+ # ─────────────────────────────────────────────────────────────────────────────
5022
+ # 作法: リポジトリの中の部品の置き場へ、使い捨ての作業用コピーを作らない(便 99edd7bf)
5023
+ #
5024
+ # 【実地の違反(便 c48e51a0・261a2224・85df6654/devlog 8d35b678)】
5025
+ # 番人が「秘密を確かめるには大きすぎるフォルダをまとめて写した」で止めた直後、職人は
5026
+ # 3便続けて部品の置き場の下(`node_modules/.tmp-作業名`)へ現場ごとの写しを作り、作業を続けた。
5027
+ # 番人は部品の置き場の【下】への写しを1つも止めていなかった(実測 allow)。
5028
+ # 写しは「記録される場所の中」に出来るので、記録に混ざる危険が残り、片付け(再帰の削除)も
5029
+ # 番人に止められて残骸になる。=置き場が悪い(鉄則13 の根治と同じ向き)。
5030
+ #
5031
+ # 【止める形】現場(作業場所・その上の階層・その下)の部品の置き場の【下】へ、
5032
+ # 現場やその一部を丸ごと置く形=写し・同期・近道・移動・固めた物の取り出し・枝の作業場・
5033
+ # 取り出し(clone)と、置き場として新しいフォルダを作る形。
5034
+ #
5035
+ # 【巻き込まない物(=この判定に入らない形)】
5036
+ # ・人の通常の部品取得(取得の命令そのもの)… 写す形でも置き場を作る形でもない
5037
+ # ・部品の読み取り(中身を見る・探す・一覧する)… 書き込む形ではない
5038
+ # ・組み立てと試験が置き場の下に作る控え … 道具が自分で作るので、職人の命令には現れない
5039
+ # ・使い捨ての置き場(OS の一時領域)の中 … 既に使い捨てなので対象外
5040
+ # ・既にある写しを名指しで消す形 … 消す道具はこの判定の対象にしない
5041
+ #
5042
+ # 【文は discipline】書式上の理由と直し方(正しい置き場)を示す=職人は目的・対象・権限を
5043
+ # 広げない書き直しで続けられる(鉄則4・便 40501fbe の決め)。
5044
+ # ─────────────────────────────────────────────────────────────────────────────
5045
+
5046
+ #: 使い捨ての作業用コピーを作らせない置き場(機械が入れる部品の置き場)。
5047
+ # ★正本は _DEPENDENCY_DIR_NAMES(一覧を2つ持たない)。そこから `vendor` だけ引く=
5048
+ # 記録に入れて配る現場が在り、中へ写すのが普通の作業になるため。
5049
+ _WORKCOPY_DIRS = _DEPENDENCY_DIR_NAMES - frozenset({'vendor'})
5050
+
5051
+ #: 丸ごと置く道具(写し・同期・近道・移動・置く)。
5052
+ _WORKCOPY_COPY_VERBS = frozenset({'cp', 'rsync', 'ditto', 'scp', 'rclone', 'unison', 'install', 'ln', 'mv'})
5053
+ #: 固めた物を取り出す道具(取り出しは必ずその下へ書く)。
5054
+ _WORKCOPY_UNPACK_VERBS = frozenset({'tar', 'bsdtar', 'gtar', 'unzip', '7z', '7za', 'cpio', 'pax'})
5055
+ #: 「丸ごと」の印(長い形)。短い形は字でまとめて書けるので別に見る。
5056
+ _WORKCOPY_WHOLE_FLAGS = frozenset({'--recursive', '--archive', '--mirror', '--dereference'})
5057
+
5058
+
5059
+ def _workcopy_place(path: str, cwd=None):
5060
+ """その行き先が「現場の中の部品の置き場の【下】」なら、その置き場の名前。
5061
+
5062
+ ★使い捨ての置き場(OS の一時領域)の中は対象外(既に使い捨て)。
5063
+ ★「現場の中」=置き場の親が、作業場所そのもの・その上の階層・その下のどれか。
5064
+ 単一の現場も、束ねた現場(下の階層に置き場がある形)も、同じ条件で当たる。
5065
+ """
5066
+ base = cwd if (isinstance(cwd, str) and os.path.isabs(cwd)) else os.getcwd()
5067
+ base = os.path.normpath(base).rstrip('/') or '/'
5068
+ try:
5069
+ lit = _expand_path(path, cwd)
5070
+ real = resolved_path(lit)
5071
+ except Exception: # noqa: BLE001
5072
+ return None
5073
+ for p in (lit, real):
5074
+ if is_throwaway_path(p):
5075
+ continue
5076
+ comps = [c for c in p.split('/') if c]
5077
+ for i, c in enumerate(comps):
5078
+ if c not in _WORKCOPY_DIRS or len(comps) <= i + 1:
5079
+ continue
5080
+ parent = '/' + '/'.join(comps[:i]) if i else '/'
5081
+ parent = parent.rstrip('/') or '/'
5082
+ if parent == base or base.startswith(parent + '/') or parent.startswith(base + '/'):
5083
+ return c
5084
+ return None
5085
+
5086
+
5087
+ def _workcopy_dests(verb: str, tokens, args, paths, cwd=None):
5088
+ """「丸ごと置く/置き場を作る」形の行き先と、その行き先を解く基準の場所。"""
5089
+ if verb == 'git':
5090
+ sub, rest = _git_subcommand(args)
5091
+ if sub == 'clone':
5092
+ # ★位置の語を数えて「何番目が行き先か」を当てない(値を取る旗=--branch などが
5093
+ # 前に入ると番号がずれる・実測で素通りした)。位置の語ぜんぶを照らす。
5094
+ # 部品の置き場の下を指す語は、どの位置に在っても使い捨ての写しの置き場である。
5095
+ dests = [t for t in rest if not t.startswith('-')]
5096
+ elif sub == 'worktree' and rest[:1] == ['add']:
5097
+ dests = [t for t in rest[1:] if not t.startswith('-')]
5098
+ else:
5099
+ return [], cwd
5100
+ where = _git_cwd(args, cwd)
5101
+ if isinstance(where, str) and where != cwd:
5102
+ dests.append(where)
5103
+ return dests, where if isinstance(where, str) else cwd
5104
+ if verb == 'mkdir' or (verb == 'install' and ('-d' in args or '--directory' in args)):
5105
+ return paths, cwd
5106
+ if verb in _WORKCOPY_UNPACK_VERBS:
5107
+ out = []
5108
+ for k, a in enumerate(args):
5109
+ if a in ('-C', '--directory', '-d') and k + 1 < len(args):
5110
+ out.append(args[k + 1])
5111
+ elif a.startswith('--directory='):
5112
+ out.append(a.split('=', 1)[1])
5113
+ elif a.startswith('-o') and len(a) > 2 and verb in ('7z', '7za'):
5114
+ out.append(a[2:])
5115
+ # 取り出しは必ずその下へ書くので、置き場そのものを指す形も「下への書き込み」として照らす。
5116
+ return out + [os.path.join(d, 'x') for d in out], cwd
5117
+ if verb in _WORKCOPY_COPY_VERBS:
5118
+ dest = None
5119
+ for k, a in enumerate(args):
5120
+ if a in ('-t', '--target-directory') and k + 1 < len(args):
5121
+ dest = args[k + 1]
5122
+ elif a.startswith('--target-directory='):
5123
+ dest = a.split('=', 1)[1]
5124
+ srcs = [p for p in paths if p != dest]
5125
+ if dest is None and len(paths) >= 2:
5126
+ dest, srcs = paths[-1], paths[:-1]
5127
+ if not dest:
5128
+ return [], cwd
5129
+ # ★いつも「丸ごと」になる道具 … 同期(元の木をそのまま揃える)・近道(木ごとの別名)・
5130
+ # 移動(在った物をそこへ移す=置き場として使う形そのもの)。旗や元の実在に頼らない
5131
+ # (実測:`ln -s 現場 置き場/写し` と `mv -f 現場/src 置き場/写し` が素通りしていた)。
5132
+ whole = (verb in ('rsync', 'ditto', 'unison', 'rclone', 'ln', 'mv')
5133
+ or any(a in _WORKCOPY_WHOLE_FLAGS
5134
+ or (re.match(r'^-[A-Za-z]+$', a) and any(ch in a[1:] for ch in 'rRa'))
5135
+ for a in args)
5136
+ or any(_existing_dir(s, cwd) for s in srcs)
5137
+ or any(s.endswith('/') or s.rstrip('/').endswith('/.') for s in srcs))
5138
+ if not whole:
5139
+ return [], cwd
5140
+ root = _expand_path(dest, cwd)
5141
+ return ([dest] + [os.path.join(root, os.path.basename(s.rstrip('/')))
5142
+ for s in srcs if s.rstrip('/')]), cwd
5143
+ return [], cwd
5144
+
5145
+
5146
+ def _workcopy_segment(segment: str, cwd=None):
5147
+ """本物の1コマンドが、現場の部品の置き場の下へ写しを作る形なら理由。"""
5148
+ seg = _normalize_segment(segment)
5149
+ head = seg.split('\n', 1)[0] if '<<' in seg else seg
5150
+ tokens = tokens_of(head)
5151
+ pos, _wrappers = _unwrap(tokens)
5152
+ if pos >= len(tokens):
5153
+ return None
5154
+ verb = _exe_base(tokens[pos])
5155
+ args = _plain_args(tokens, pos + 1)
5156
+ paths = [a for a in args if not a.startswith('-')]
5157
+ dests, where = _workcopy_dests(verb, tokens, args, paths, cwd)
5158
+ for d in dests:
5159
+ for v in _brace_variants(d):
5160
+ if _workcopy_place(v, where):
5161
+ return _DISC_WORKCOPY
5162
+ return None
5163
+
5164
+
5165
+ def _workcopy_scan(command: str, cwd=None, depth: int = 0):
5166
+ """コマンド全体(つなぎ・包み・殻の中身・変数の展開)で同じ形を探す。"""
5167
+ if not command or not command.strip() or depth > _UNWRAP_MAX_DEPTH:
5168
+ return None
5169
+ texts = [command]
5170
+ expanded = _expand_local_vars(command)
5171
+ if expanded != command:
5172
+ texts.append(expanded)
5173
+ for text in texts:
5174
+ for seg in _real_segments(text):
5175
+ hit = _workcopy_segment(seg, cwd)
5176
+ if hit:
5177
+ return hit
5178
+ for kind, _runner, inner in _inner_payloads(command):
5179
+ if kind != 'shell' or not inner:
5180
+ continue
5181
+ hit = _workcopy_scan(inner, cwd, depth + 1)
5182
+ if hit:
5183
+ return hit
5184
+ return None
5185
+
5186
+
4964
5187
  def _discipline_scan(command: str, cwd=None):
4965
- """作法の3件(git add -A・cd の && とリダイレクト・全体の再帰検索)。当たれば職人へ返す1行、無ければ None。"""
5188
+ """作法の4件(git add -A・cd の && とリダイレクト・全体の再帰検索・部品の置き場への写し)。
5189
+
5190
+ 当たれば職人へ返す1行、無ければ None。
5191
+ """
5192
+ hit = _workcopy_scan(command, cwd)
5193
+ if hit:
5194
+ return hit
4966
5195
  toks = _discipline_tokens(command)
4967
5196
  if not toks:
4968
5197
  return None
@@ -157,9 +157,11 @@ GUARD_READS = [
157
157
  'systemctl --user restart relay.service', 'mkdir -p ~/.claude/projects/x',
158
158
  f'python3 -c "import json,os;print(json.load(open(os.path.expanduser(\'{S}\'))))"',
159
159
  # 使い捨ての作業場(/tmp の下)に作った同じ名前
160
- f'echo {{}} > /tmp/claude-1000/w/.claude/{SET}.json',
161
- f'P=/tmp/claude-1000/probe; mkdir -p $P/.claude; echo {{}} > $P/.claude/{SET}.local.json',
162
- f'rm -f /tmp/claude-1000/w/.claude/{SET}.json',
160
+ # ★便 99edd7bf から、通るのは「試験の作り物だと言い切れる印」が道筋に在るときだけ
161
+ # (印の無い形は下の (1b) で止まることを固定する)。
162
+ f'echo {{}} > /tmp/claude-1000/fixture/w/.claude/{SET}.json',
163
+ f'P=/tmp/claude-1000/fixture/probe; mkdir -p $P/.claude; echo {{}} > $P/.claude/{SET}.local.json',
164
+ f'rm -f /tmp/claude-1000/fixture/w/.claude/{SET}.json',
163
165
  # 報告・コミットの説明に場所の名前が書いてあるだけ
164
166
  f'cat > /tmp/claude-1000/report.md <<\'EOF\'\n- echo {{}} > {S} の形を止めた\n- cp x {CODEX_HOOKS} も止まる\nEOF',
165
167
  f'git commit -m "fix: > {S} への書き込みを止める"',
@@ -171,11 +173,23 @@ GUARD_READS = [
171
173
  ]
172
174
  for cmd in GUARD_READS:
173
175
  expect('(1) allow', cmd, policy.ALLOW)
174
- check('(1) Write: 使い捨ての作業場は allow',
175
- policy.decide_write(f'/tmp/claude-1000/w/.claude/{SET}.json')['decision'], policy.ALLOW)
176
+ check('(1) Write: 使い捨ての作業場(試験の作り物の印あり)は allow',
177
+ policy.decide_write(f'/tmp/claude-1000/fixture/w/.claude/{SET}.json')['decision'], policy.ALLOW)
176
178
  check('(1) Write: ほかの ~/.config は allow',
177
179
  policy.decide_write(os.path.expanduser('~/.config/some-tool/x.toml'))['decision'], policy.ALLOW)
178
180
 
181
+ # ★便 99edd7bf(けいさん確定 2026-10-09)… 使い捨ての場所に在るだけでは「試験用データ」と
182
+ # 言い切れないので通さない(止める向きの変更=今まで通っていた形だけが止まる)。
183
+ print('\n── (1b) 使い捨てでも「試験の作り物」の印が無い置き場の形は通さない ' + '─' * 6)
184
+ for cmd in [
185
+ f'echo {{}} > /tmp/claude-1000/w/.claude/{SET}.json',
186
+ f'P=/tmp/claude-1000/probe; mkdir -p $P/.claude; echo {{}} > $P/.claude/{SET}.local.json',
187
+ f'rm -f /tmp/claude-1000/w/.claude/{SET}.json',
188
+ ]:
189
+ expect('(1b) deny', cmd, policy.DENY)
190
+ check('(1b) Write も通さない',
191
+ policy.decide_write(f'/tmp/claude-1000/w/.claude/{SET}.json')['decision'], policy.DENY)
192
+
179
193
  print('\n── (2) 秘密のファイルの読み取り(縦棒・セミコロン・& で動詞が千切れる形) ' + '─' * 1)
180
194
  SECRET_READS = [
181
195
  f'grep -n "x|y" {E}', f'grep -n "x;y" {E}.local', f'grep -n "a&b" {E}', f'grep -nE \'^\\s*[#;]|registry\' .npmrc',
@@ -179,15 +179,21 @@ for c in [f'cat {S}', f'less {SL}', f'grep -n hooks {S}', f'rg PreToolUse {HOOKS
179
179
  f'echo {S} を守る >> notes.md', f'git commit -m "docs: {S} を守る"',
180
180
  f'gh pr create --title x --body "tee {HOOKS}/p.py を止める"',
181
181
  'git push -u origin feat/x', 'gh pr merge 12 --auto --merge --delete-branch',
182
- f'echo x > /tmp/claude-1000/w/{CLA}/{SET}.json',
182
+ # ★便 99edd7bf から、使い捨ての置き場の作り物が通るのは「試験の作り物」の印が
183
+ # 道筋に在るときだけ(印の無い形は下で止まることを固定する)。
184
+ f'echo x > /tmp/claude-1000/fixture/w/{CLA}/{SET}.json',
183
185
  f"python3 - <<'PY'\np='docs/g.md'\ns=open(p).read()\ns=s.replace('A','{S} は守る')\nopen(p,'w').write(s)\nPY"]:
184
186
  al('allow', c)
185
187
 
186
188
  print('\n── Write ツールも同じ一覧で守る/使い捨ては通す ' + '─' * 20)
187
189
  for p in (S, SL, f'{SKILLS}/a.md', f'{HOOKS}/p.py', f'{BIN}/x', CODEX_H, CODEX_C, MANAGED):
188
190
  check(f'Write DENY: {p}', policy.decide_write(os.path.expanduser(p))['decision'], policy.DENY)
189
- for p in (f'/tmp/claude-1000/w/{CLA}/{SET}.json', '~/.config/other-tool/x.toml', 'out.json'):
191
+ for p in (f'/tmp/claude-1000/fixture/w/{CLA}/{SET}.json', '~/.config/other-tool/x.toml', 'out.json'):
190
192
  check(f'Write allow: {p}', policy.decide_write(os.path.expanduser(p))['decision'], policy.ALLOW)
193
+ # ★印の無い使い捨ての置き場の形は通さない(止める向きの変更)。
194
+ dn('使い捨てでも印が無ければ通さない', f'echo x > /tmp/claude-1000/w/{CLA}/{SET}.json')
195
+ check(f'Write DENY: /tmp/claude-1000/w/{CLA}/{SET}.json',
196
+ policy.decide_write(f'/tmp/claude-1000/w/{CLA}/{SET}.json')['decision'], policy.DENY)
191
197
 
192
198
  # 一覧の場所ごとに「代表の手段」で当たること(場所を1か所に集めた確認)。
193
199
  print('\n── 守る場所の一覧の各所が塞がっている ' + '─' * 28)
@@ -325,14 +325,29 @@ for fp in _REAL_SETTINGS:
325
325
  _INCIDENT = ('/tmp/claude-1000/-home-fshim-projects-conductor/'
326
326
  '6da24b92-e375-432f-9aeb-95cfd623dd6e/scratchpad/b/home/projects/s/'
327
327
  '.claude/settings.json')
328
+ # ★便 99edd7bf(けいさん確定 2026-10-09)… 使い捨ての場所に在るだけでは通さない。
329
+ # 「試験の作り物だと言い切れる印」(実物から引いた一覧=実機事例の scratchpad・
330
+ # この現場の試験が使う fixture)が道筋に在るときだけ通す。印の無い形は
331
+ # 「後でその置き場で職人を起こすと読み込まれる」かを見分けられない=未確認として止める側。
328
332
  _THROWAWAY = [
329
- _INCIDENT,
330
- '/tmp/x/.claude/settings.json',
331
- '/tmp/x/.claude/settings.local.json',
333
+ _INCIDENT, # 実機で止まった当のパス(scratchpad の印あり)
334
+ '/tmp/x/fixture/.claude/settings.json',
335
+ '/tmp/x/fixtures/home/projects/s/.claude/settings.local.json',
332
336
  ]
333
337
  for fp in _THROWAWAY:
334
- check(f'使い捨ては止めない {fp[-40:]}',
338
+ check(f'使い捨ての作り物(印あり)は止めない {fp[-40:]}',
335
339
  policy.decide_write(fp, '/home/fshim/projects/x')['decision'], policy.ALLOW)
340
+ _THROWAWAY_UNKNOWN = [
341
+ '/tmp/x/.claude/settings.json',
342
+ '/tmp/x/.claude/settings.local.json',
343
+ '/tmp/claude-1000/karaburi-99edd7bf/.claude/agents/probe.md',
344
+ ]
345
+ for fp in _THROWAWAY_UNKNOWN:
346
+ check(f'印の無い使い捨ては通さない {fp[-40:]}',
347
+ policy.decide_write(fp, '/home/fshim/projects/x')['decision'], policy.DENY)
348
+ check('印の見分けそのもの(道筋に印が在るか)',
349
+ (policy._is_test_fixture_path('/tmp/x/fixture/.claude/settings.json'),
350
+ policy._is_test_fixture_path('/tmp/x/.claude/settings.json')), (True, False))
336
351
  # ★/var/tmp は場所としては使い捨てだが、その手前の「システム領域(/var)へは書かない」規則で
337
352
  # 止まる(この規則は今回変えていない)。=使い捨てとして使えるのは実質 /tmp 系。
338
353
  check('/var/tmp はシステム領域の規則で止まったまま',
@@ -353,12 +368,17 @@ check('`..` で本物へ回り込めない',
353
368
  # ★近道(symlink)で本物へ回り込めないこと。実在のリンクを作って確かめる(字面だけでは分からない)。
354
369
  _link_dir = tempfile.mkdtemp(prefix='policy-claude-')
355
370
  _home_claude = os.path.join(os.path.expanduser('~'), '.claude')
356
- _inner = os.path.join(_link_dir, 'inner', '.claude')
371
+ # ★近道の先も使い捨て=通す条件は「試験の作り物の印」も要る(便 99edd7bf)。印ありと印なしの
372
+ # 両方を作って、先の形で分かれることを確かめる。
373
+ _inner = os.path.join(_link_dir, 'fixture', '.claude')
374
+ _inner_plain = os.path.join(_link_dir, 'inner', '.claude')
357
375
  os.makedirs(_inner, exist_ok=True)
376
+ os.makedirs(_inner_plain, exist_ok=True)
358
377
  _links = {
359
378
  'shortcut': _home_claude, # 別名の近道 → 本物のホーム
360
379
  '.claude': _home_claude, # 同名の近道 → 本物のホーム
361
- 'near': _inner, # 近道の先も使い捨て
380
+ 'near': _inner, # 近道の先も使い捨て(試験の作り物の印あり)
381
+ 'near-plain': _inner_plain, # 近道の先も使い捨てだが印なし
362
382
  }
363
383
  for _name, _target in _links.items():
364
384
  _p = os.path.join(_link_dir, _name)
@@ -371,9 +391,12 @@ if os.path.isdir(_home_claude):
371
391
  check('同名の近道で本物へ書けない',
372
392
  policy.decide_write(os.path.join(_link_dir, '.claude', 'settings.json'))['decision'],
373
393
  policy.DENY)
374
- check('近道の先も使い捨てなら止めない',
394
+ check('近道の先も使い捨て+試験の作り物の印なら止めない',
375
395
  policy.decide_write(os.path.join(_link_dir, 'near', 'settings.json'))['decision'],
376
396
  policy.ALLOW)
397
+ check('近道の先が使い捨てでも印が無ければ通さない',
398
+ policy.decide_write(os.path.join(_link_dir, 'near-plain', 'settings.json'))['decision'],
399
+ policy.DENY)
377
400
  shutil.rmtree(_link_dir, ignore_errors=True)
378
401
 
379
402
  print('\n=== (b4) 秘密ファイル判定: 本体は止める / 雛形は通す ===')
@@ -0,0 +1,322 @@
1
+ #!/usr/bin/env python3
2
+ """番人の続き3つの試験(便 99edd7bf・守りを強める向きだけ)。
3
+
4
+ 実行: python3 scripts/hooks/test_workcopy_and_memo_routes.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【① リポジトリの中の部品の置き場に、使い捨ての作業用コピーを作らせない】
8
+ 実地の違反(便 c48e51a0・261a2224・85df6654/devlog 8d35b678)。番人が「秘密を確かめるには
9
+ 大きすぎるフォルダをまとめて写した」で止めた直後、職人は3便続けて部品の置き場の下
10
+ (`node_modules/.tmp-作業名`)へ現場ごとの写しを作って作業を続けた。番人は部品の置き場の
11
+ 【下】への写しを1つも止めていなかった(実測 allow)。写しは記録される場所の中に出来るので、
12
+ 記録に混ざる危険が残り、片付け(再帰の削除)も番人に止められて残骸になる。
13
+
14
+ 【② 覚え書きの置き場(.claude/projects)を経由して守る対象へ書けないこと】
15
+ けいさん決定 2026-10-09「.claude/projects は通常の覚え書きを保つ方針で構いません。ただし、
16
+ そこを経由して守る対象へ書き込めないことは確認してください」。4つの経路を実物で測る=
17
+ `..` で上へ抜ける/近道(シンボリックリンク)を張る・その先へ書く/mv・cp・ln で守る場所へ
18
+ 移す/projects の下に同じ形の木を作る。★本物の ~/.claude には1バイトも書かない
19
+ (使い捨ての偽のホームを /tmp の下に作って測る)。
20
+
21
+ 【③ 「後で職人が読み込む .claude」を試験用として一律に通さない】
22
+ けいさん決定 2026-10-09「試験用データと、実際に職人へ読み込ませる設定を区別してください。
23
+ 判断できないものは未確認として残します」。使い捨ての場所に在るだけでは通さず、
24
+ 「試験の作り物だと言い切れる印」(実物=ADR-014 の実機事例の scratchpad・この現場の試験が
25
+ 使う fixture)が道筋に在るときだけ通す。印の無い形は未確認として止める側に置く。
26
+
27
+ ★危険語・置き場の名前は部品から組み立てる(番人が測る文に素の字で置かない作法)。
28
+ """
29
+ import os
30
+ import shutil
31
+ import sys
32
+
33
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
34
+
35
+ import policy # noqa: E402
36
+
37
+ failures = []
38
+
39
+
40
+ def check(label, got, want):
41
+ ok = got == want
42
+ if not ok:
43
+ failures.append(f'{label}: got={got!r} want={want!r}')
44
+ print(f'{"OK " if ok else "NG "} {label:76} {str(got)[:16]}')
45
+
46
+
47
+ # ── 部品 ──
48
+ WORK = '/srv/site-sample' # 現場(/tmp の外・場所は字面で決まるので実在しなくてよい)
49
+ DEPS = 'node_' + 'modules' # 機械が入れる部品の置き場
50
+ TMP = '/tmp/claude-1000' # 使い捨ての置き場(鉄則13)
51
+ CLA = '.cla' + 'ude'
52
+ SET = 'sett' + 'ings'
53
+ MEMO = f'{CLA}/projects' # 道具が設計上そこへ書く所(覚え書き・手番の控え)
54
+ ADM = 'su' + 'do'
55
+ INTEROP = 'ws' + 'l.exe'
56
+
57
+
58
+ def dbash(cmd, cwd=WORK):
59
+ return policy.decide_bash(cmd, cwd)['decision']
60
+
61
+
62
+ def reason(cmd, cwd=WORK):
63
+ return policy.decide_bash(cmd, cwd)['reason']
64
+
65
+
66
+ def dwrite(path, cwd=WORK):
67
+ return policy.decide_write(path, cwd)['decision']
68
+
69
+
70
+ def dn(label, cmd, cwd=WORK):
71
+ check(f'{label}: {cmd[:52]!r}', dbash(cmd, cwd), policy.DENY)
72
+
73
+
74
+ def al(label, cmd, cwd=WORK):
75
+ check(f'{label}: {cmd[:52]!r}', dbash(cmd, cwd), policy.ALLOW)
76
+
77
+
78
+ # ═════════════════════════════════════════════════════════════════════════════
79
+ # ① 部品の置き場の下へ使い捨ての作業用コピーを作る形(止める側)
80
+ # ═════════════════════════════════════════════════════════════════════════════
81
+
82
+ def copy_forms(dest):
83
+ """現場やその一部を丸ごと置く形(実地の形を先頭に置く)。"""
84
+ return [
85
+ ('取り出し(実地の形)', f'git clone --no-hardlinks {WORK} {dest}'),
86
+ ('取り出し(枝を指定)', f'git clone --no-hardlinks --branch feat/x {WORK} {dest}'),
87
+ ('枝の作業場', f'git worktree add {dest}'),
88
+ ('写し(丸ごとの旗)', f'cp -r {WORK} {dest}'),
89
+ ('写し(まとめた旗)', f'cp -av {WORK}/src {dest}'),
90
+ ('写し(長い旗)', f'cp --recursive {WORK}/src {dest}'),
91
+ ('同期', f'rsync -a {WORK}/ {dest}'),
92
+ ('固めた物の取り出し', f'tar xf {TMP}/a.tar -C {dest}'),
93
+ ('固めた物の取り出し(長い旗)', f'tar --extract --file {TMP}/a.tar --directory {dest}'),
94
+ ('圧縮の取り出し', f'unzip {TMP}/a.zip -d {dest}'),
95
+ ('近道を張る', f'ln -s {WORK} {dest}'),
96
+ ('動かす', f'mv -f {WORK}/src {dest}'),
97
+ ('置き場を作る', f'mkdir -p {dest}'),
98
+ ('置き場を作る(install -d)', f'install -d {dest}'),
99
+ ('行き先を旗で渡す', f'cp -r -t {dest} {WORK}/src'),
100
+ ]
101
+
102
+
103
+ PLACES = [
104
+ ('作業場所の部品の置き場', f'{WORK}/{DEPS}/.tmp-karaburi-99edd7bf'),
105
+ ('作業場所の部品の置き場(相対)', f'{DEPS}/.tmp-karaburi-99edd7bf'),
106
+ ('上の階層の部品の置き場', f'/srv/{DEPS}/.tmp-karaburi-99edd7bf'),
107
+ ('深い階層', f'{WORK}/{DEPS}/.cache/deep/.tmp-karaburi-99edd7bf'),
108
+ ('束ねた現場(下の階層)', f'{WORK}/packages/app/{DEPS}/.tmp-karaburi-99edd7bf'),
109
+ ]
110
+
111
+
112
+ def wraps(cmd):
113
+ """包み(素・管理者権限の命令ごし・相互運用の包み・殻の中)。"""
114
+ out = [('素', cmd),
115
+ ('管理者権限の命令ごし', f'{ADM} {cmd}'),
116
+ ('相互運用の包み', f'{INTEROP} -u root -- {cmd}')]
117
+ if '"' not in cmd and "'" not in cmd:
118
+ out.append(('殻の中', f'bash -c "{cmd}"'))
119
+ return out
120
+
121
+
122
+ print('── ① 部品の置き場の下への写し(形 × 置き場 × 包み) ' + '─' * 16)
123
+ n1 = 0
124
+ for pname, dest in PLACES:
125
+ for fname, cmd in copy_forms(dest):
126
+ for wname, wcmd in wraps(cmd):
127
+ n1 += 1
128
+ dn(f'① {pname}/{fname}/{wname}', wcmd)
129
+ check('① 測った形の数', n1, len(PLACES) * len(copy_forms('x')) * 4)
130
+
131
+ print('\n── ①b つなぎ・変数・ほかの部品の置き場の名前でも当たる ' + '─' * 14)
132
+ dn('①b つないだ行の後ろ', f'git status && cp -r {WORK}/src {WORK}/{DEPS}/.tmp-x')
133
+ dn('①b 変数に入れた行き先', f'D={WORK}/{DEPS}/.tmp-x; cp -r {WORK}/src "$D"')
134
+ dn('①b 波括弧', f'mkdir -p {WORK}/{DEPS}/{{.tmp-a,.tmp-b}}')
135
+ for other in ('site-packages', '.venv', 'venv'):
136
+ dn(f'①b ほかの部品の置き場({other})', f'cp -r {WORK}/src {WORK}/{other}/.tmp-x')
137
+ check('①b 文は discipline(書式上の理由と直し方)',
138
+ reason(f'mkdir -p {DEPS}/.tmp-x').startswith('discipline:'), True)
139
+ for word in (TMP, '鉄則13', '使い捨て'):
140
+ check(f'①b 文に直し方が在る({word})', word in reason(f'mkdir -p {DEPS}/.tmp-x'), True)
141
+ check('①b 文は1行', '\n' in reason(f'mkdir -p {DEPS}/.tmp-x'), False)
142
+
143
+ print('\n── ①c 巻き込まない物は1つも止めない(通す側) ' + '─' * 20)
144
+ PASS_THROUGH = [
145
+ ('部品取得(npm)', 'npm install'),
146
+ ('部品取得(npm ci)', 'npm ci'),
147
+ ('部品取得(pnpm)', 'pnpm install'),
148
+ ('部品取得(yarn)', 'yarn'),
149
+ ('部品取得(版の指定つき)', 'npm install --save-dev typescript'),
150
+ ('読み取り(中身)', f'cat {DEPS}/.bin/vitest'),
151
+ ('読み取り(探す)', f'grep -n main {DEPS}/pkg/index.js'),
152
+ ('読み取り(一覧)', f'ls -la {DEPS}'),
153
+ ('読み取り(深い階層の一覧)', f'ls {DEPS}/@scope/pkg/dist'),
154
+ ('読み取り(外へ写す)', f'cp {DEPS}/pkg/index.js {TMP}/copy.js'),
155
+ ('組み立て', 'npm run build'),
156
+ ('試験', 'npm test'),
157
+ ('道具が作る控え(組み立ての命令)', 'npm run build -- --force'),
158
+ ('使い捨ての置き場へ写す', f'git clone --no-hardlinks {WORK} {TMP}/karaburi-99edd7bf'),
159
+ ('使い捨ての置き場へ丸ごと写す', f'cp -r {WORK} {TMP}/karaburi-99edd7bf'),
160
+ ('使い捨ての置き場に置き場を作る', f'mkdir -p {TMP}/karaburi-99edd7bf'),
161
+ ('既にある写しを名指しで消す', f'rm -r {DEPS}/.tmp-karaburi-99edd7bf'),
162
+ ('部品の置き場そのものを作る', f'mkdir -p {DEPS}'),
163
+ ('部品の置き場の外へ写す', f'cp -r {WORK}/src {WORK}/dist'),
164
+ ('名前の似たふつうのフォルダ', f'mkdir -p {WORK}/node-tools/.tmp-x'),
165
+ ('部品の置き場を外へ写す(元が置き場)', f'cp -r {DEPS} {TMP}/deps-copy'),
166
+ ]
167
+ for label, cmd in PASS_THROUGH:
168
+ al(f'①c {label}', cmd)
169
+
170
+ # ★道具が自分で作る控え(.cache・.vite など)は職人の命令に現れない=この判定を通らない。
171
+ # 念のため「控えの中のファイルを読む・消す」形が止まらないことも固定する。
172
+ al('①c 控えを読む', f'cat {DEPS}/.cache/x.json')
173
+ al('①c 控えを名指しで消す', f'rm -r {DEPS}/.vite')
174
+
175
+ # ★使い捨ての置き場の中では、部品の置き場の下でも止めない(既に使い捨て)。
176
+ al('①c 使い捨ての中の部品の置き場', f'cp -r {TMP}/karaburi/src {TMP}/karaburi/{DEPS}/.tmp-x',
177
+ f'{TMP}/karaburi')
178
+
179
+ print('\n── ①d 判定の部品(一覧は1か所から引く) ' + '─' * 24)
180
+ check('①d 置き場の一覧は部品置き場の正本から引く',
181
+ policy._WORKCOPY_DIRS == policy._DEPENDENCY_DIR_NAMES - frozenset({'vendor'}), True)
182
+ check('①d 記録に入れて配る置き場(vendor)は外す', 'vendor' in policy._WORKCOPY_DIRS, False)
183
+ check('①d 場所の見分け(作業場所の下)',
184
+ policy._workcopy_place(f'{WORK}/{DEPS}/.tmp-x', WORK), DEPS)
185
+ check('①d 場所の見分け(使い捨ては対象外)',
186
+ policy._workcopy_place(f'{TMP}/w/{DEPS}/.tmp-x', WORK), None)
187
+ check('①d 場所の見分け(置き場そのものは対象外)',
188
+ policy._workcopy_place(f'{WORK}/{DEPS}', WORK), None)
189
+ check('①d 場所の見分け(別の現場の下は対象外)',
190
+ policy._workcopy_place(f'/other/site/{DEPS}/.tmp-x', WORK), None)
191
+
192
+ # ═════════════════════════════════════════════════════════════════════════════
193
+ # ② 覚え書きの置き場を経由する形(★使い捨ての偽のホームで測る)
194
+ # ═════════════════════════════════════════════════════════════════════════════
195
+
196
+ FAKE = f'{TMP}/probe-99edd7bf-test/fakehome'
197
+ _saved_home = os.environ.get('HOME')
198
+ if os.path.isdir(FAKE):
199
+ shutil.rmtree(FAKE)
200
+ os.environ['HOME'] = FAKE
201
+ try:
202
+ for d in (f'{FAKE}/{CLA}/agents', f'{FAKE}/{CLA}/commands', f'{FAKE}/{MEMO}/p/memory'):
203
+ os.makedirs(d, exist_ok=True)
204
+ with open(f'{FAKE}/{CLA}/{SET}.json', 'w', encoding='utf-8') as f:
205
+ f.write('{}\n')
206
+ # 近道(シンボリックリンク)を実際に張る(字面だけでは分からないので実物で測る)
207
+ for name, target in (('link-claude', f'{FAKE}/{CLA}'),
208
+ ('link-agents', f'{FAKE}/{CLA}/agents'),
209
+ ('link-home', FAKE)):
210
+ link = f'{FAKE}/{MEMO}/p/{name}'
211
+ if not os.path.lexists(link):
212
+ os.symlink(target, link)
213
+
214
+ print('\n── ② 覚え書きの置き場を経由して守る対象へは書けない ' + '─' * 18)
215
+ ROUTES = [
216
+ ('上へ抜ける(入口のファイル)', f'echo x > {FAKE}/{MEMO}/p/../../{SET}.json'),
217
+ ('上へ抜ける(読み込む置き場)', f'echo x > {FAKE}/{MEMO}/p/../../agents/a.md'),
218
+ ('上へ抜ける(深い)', f'echo x > {FAKE}/{MEMO}/p/memory/../../../agents/a.md'),
219
+ ('近道の先へ書く(置き場ごと)', f'echo x > {FAKE}/{MEMO}/p/link-claude/agents/a.md'),
220
+ ('近道の先へ書く(置き場を直に)', f'echo x > {FAKE}/{MEMO}/p/link-agents/a.md'),
221
+ ('近道の先へ書く(ホーム経由)', f'echo x > {FAKE}/{MEMO}/p/link-home/{CLA}/agents/a.md'),
222
+ ('近道の先の入口のファイル', f'echo x > {FAKE}/{MEMO}/p/link-claude/{SET}.json'),
223
+ ('近道を張って守る場所を指す', f'ln -s {FAKE}/{CLA}/agents {FAKE}/{MEMO}/p/newlink'),
224
+ ('近道を張って置き場ごと指す', f'ln -s {FAKE}/{CLA} {FAKE}/{MEMO}/p/newlink2'),
225
+ ('mv で守る場所へ移す', f'mv {FAKE}/{MEMO}/p/memory/a.md {FAKE}/{CLA}/agents/a.md'),
226
+ ('cp で守る場所へ写す', f'cp {FAKE}/{MEMO}/p/memory/a.md {FAKE}/{CLA}/commands/a.md'),
227
+ ('ln で守る場所へつなぐ', f'ln {FAKE}/{MEMO}/p/memory/a.md {FAKE}/{CLA}/agents/a.md'),
228
+ ('同じ形の木を作る(書く)', f'echo x > {FAKE}/{MEMO}/p/{CLA}/agents/a.md'),
229
+ ('同じ形の木を作る(フォルダ)', f'mkdir -p {FAKE}/{MEMO}/p/{CLA}/agents'),
230
+ ('同じ形の木の入口のファイル', f'echo x > {FAKE}/{MEMO}/p/{CLA}/{SET}.json'),
231
+ ('同じ形の木(置き場ごと写す)', f'cp -r {TMP}/pack/ {FAKE}/{MEMO}/p/{CLA}/agents/'),
232
+ ('同じ形の木(取り出して置く)', f'tar xf {TMP}/p.tar -C {FAKE}/{MEMO}/p/{CLA}'),
233
+ ]
234
+ for label, cmd in ROUTES:
235
+ dn(f'② {label}', cmd)
236
+ for label, path in [
237
+ ('② 書く道具: 上へ抜ける', f'{FAKE}/{MEMO}/p/../../agents/a.md'),
238
+ ('② 書く道具: 近道の先', f'{FAKE}/{MEMO}/p/link-agents/a.md'),
239
+ ('② 書く道具: 同じ形の木', f'{FAKE}/{MEMO}/p/{CLA}/agents/a.md'),
240
+ ('② 書く道具: 同じ形の木の入口', f'{FAKE}/{MEMO}/p/{CLA}/{SET}.json'),
241
+ ]:
242
+ check(f'{label}: {path[-44:]}', dwrite(path), policy.DENY)
243
+
244
+ print('\n── ②b 通常の覚え書き・手番の控えは今までどおり通す ' + '─' * 18)
245
+ for label, cmd in [
246
+ ('覚え書きへ書く', f'echo x >> {FAKE}/{MEMO}/p/memory/MEMORY.md'),
247
+ ('覚え書きを作る', f'touch {FAKE}/{MEMO}/p/memory/note.md'),
248
+ ('覚え書きのフォルダを作る', f'mkdir -p {FAKE}/{MEMO}/p/memory'),
249
+ ('手番の控えのフォルダを作る', f'mkdir -p {FAKE}/{MEMO}/p/s/tool-results'),
250
+ ('覚え書きを直す', f'sed -i s/a/b/ {FAKE}/{MEMO}/p/memory/note.md'),
251
+ ('覚え書きを消す', f'rm {FAKE}/{MEMO}/p/memory/old.md'),
252
+ ('覚え書きを名前で整える', f'mv {FAKE}/{MEMO}/p/memory/a.md {FAKE}/{MEMO}/p/memory/b.md'),
253
+ ('覚え書きの一覧', f'ls -la {FAKE}/{MEMO}/p/memory'),
254
+ ('覚え書きを読む', f'cat {FAKE}/{MEMO}/p/memory/MEMORY.md'),
255
+ ]:
256
+ al(f'②b {label}', cmd)
257
+ check('②b 書く道具でも覚え書きは通る', dwrite(f'{FAKE}/{MEMO}/p/memory/note.md'), policy.ALLOW)
258
+
259
+ print('\n── ②c 外す所は【持ち主のホームの下】だけ(現場の同じ名前は守る) ' + '─' * 8)
260
+ dn('②c 現場の同じ名前の下へ書く', f'echo x > {WORK}/{MEMO}/p/memory/a.md')
261
+ check('②c 書く道具でも守る', dwrite(f'{WORK}/{MEMO}/p/memory/a.md'), policy.DENY)
262
+ finally:
263
+ if _saved_home is None:
264
+ os.environ.pop('HOME', None)
265
+ else:
266
+ os.environ['HOME'] = _saved_home
267
+ shutil.rmtree(f'{TMP}/probe-99edd7bf-test', ignore_errors=True)
268
+
269
+ # ═════════════════════════════════════════════════════════════════════════════
270
+ # ③ 「後で読み込む .claude」=試験用だと言い切れる形だけ通す
271
+ # ═════════════════════════════════════════════════════════════════════════════
272
+
273
+ print('\n── ③ 試験の作り物だと言い切れる形だけ通す(既定は守る側) ' + '─' * 12)
274
+ # 実物1: ADR-014 の実機事例(2026-09-02 に職人が検証のために作った偽のホームの木)
275
+ INCIDENT = (f'{TMP}/-home-fshim-projects-conductor/6da24b92-e375-432f-9aeb-95cfd623dd6e/'
276
+ f'scratchpad/b/home/projects/s/{CLA}/{SET}.json')
277
+ # 実物2: この現場の試験が使う置き場
278
+ FIXTURE = f'{TMP}/fixture/home/projects/s/{CLA}'
279
+ for label, path in [
280
+ ('③ 実機事例(印 scratchpad)', INCIDENT),
281
+ ('③ 現場の試験の置き場(印 fixture)', f'{FIXTURE}/agents/probe.md'),
282
+ ('③ 現場の試験の置き場の入口', f'{FIXTURE}/{SET}.json'),
283
+ ('③ 複数形の印(fixtures)', f'{TMP}/fixtures/home/p/{CLA}/commands/probe.md'),
284
+ ]:
285
+ check(f'{label} は通す', dwrite(path), policy.ALLOW)
286
+ al(f'{label} は通す(走る行)', f'echo x > {path}')
287
+
288
+ UNKNOWN = [
289
+ ('③ 印の無い使い捨て(入口のファイル)', f'{TMP}/w/{CLA}/{SET}.json'),
290
+ ('③ 印の無い使い捨て(読み込む置き場)', f'{TMP}/w/{CLA}/agents/probe.md'),
291
+ ('③ 使い捨ての複製の中(後で作業場所になりうる)', f'{TMP}/karaburi-99edd7bf/{CLA}/agents/probe.md'),
292
+ ('③ 偽のホームの形だが印が無い', f'{TMP}/home/projects/s/{CLA}/commands/probe.md'),
293
+ ('③ OS の一時領域の直下', f'/tmp/x/{CLA}/{SET}.local.json'),
294
+ ]
295
+ for label, path in UNKNOWN:
296
+ check(f'{label} は通さない', dwrite(path), policy.DENY)
297
+ dn(f'{label} は通さない(走る行)', f'echo x > {path}')
298
+
299
+ print('\n── ③b 判定の部品(印の一覧と3条件) ' + '─' * 26)
300
+ check('③b 印の一覧が在る', sorted(policy._FIXTURE_MARKS), ['fixture', 'fixtures', 'scratchpad'])
301
+ check('③b 印の見分け(印あり)', policy._is_test_fixture_path(INCIDENT), True)
302
+ check('③b 印の見分け(印なし)', policy._is_test_fixture_path(f'{TMP}/w/{CLA}/{SET}.json'), False)
303
+ check('③b 使い捨てでないと通さない', policy._throwaway_ok(f'/srv/fixture/{CLA}/{SET}.json', WORK), False)
304
+ check('③b 読み込む側だと通さない',
305
+ policy._throwaway_ok(f'{TMP}/fixture/{CLA}/{SET}.json', f'{TMP}/fixture'), False)
306
+ check('③b 3つそろえば通す', policy._throwaway_ok(f'{FIXTURE}/{SET}.json', WORK), True)
307
+
308
+ print('\n── ③c 本物の場所は1つも漏れていない(ADR-014 の確かめをそのまま) ' + '─' * 6)
309
+ HOME = os.path.expanduser('~')
310
+ for path in [f'{HOME}/{CLA}/{SET}.json', f'{HOME}/{CLA}/{SET}.local.json',
311
+ f'{HOME}/projects/x/{CLA}/{SET}.json', f'{CLA}/{SET}.json',
312
+ f'{HOME}/work/deep/nest/{CLA}/{SET}.json', f'{HOME}/{CLA}/agents/a.md']:
313
+ check(f'③c 本物は今までどおり止める {path[-40:]}',
314
+ policy.decide_write(path, f'{HOME}/projects/x')['decision'], policy.DENY)
315
+
316
+ print()
317
+ if failures:
318
+ print(f'FAILURES: {len(failures)}')
319
+ for f in failures:
320
+ print(' -', f)
321
+ sys.exit(1)
322
+ print('ALL OK')
@@ -0,0 +1,40 @@
1
+ #!/usr/bin/env python3
2
+ """職人の報告の置き場(★正本はこの1か所だけ・写しを作らない)。
3
+
4
+ なぜ別ファイルにしたか(便 2776f602):
5
+ 囲い(サンドボックス)の書き込みは「許した場所の中だけ」なので、報告の置き場を
6
+ 許可に入れていない現場では、職人の報告が1件も書けない(2026-09-27 に tyhld-point で実発生)。
7
+ この許可を各現場へ配るには、配り直しの台本(scripts/update-guard.sh)からも
8
+ 同じ置き場を読む必要がある。置き場の字面を台本へ写すと、片方だけ直して食い違う
9
+ (便 46205e8e の「同じ一覧が2か所に増える」)。だから小さな正本に切り出し、
10
+ 雛形を出す台本(gen-managed-settings-template.py)と配り直しの台本の両方がここを読む。
11
+ ★形は scripts/deny-rule-shape.py と同じ(判定・正本は1か所・両方の段が同じ物を呼ぶ)。
12
+
13
+ ★置き場の決まり方は配達役と同じ:
14
+ 配達役(src/relay.ts の reportStoreDirs)は XDG_STATE_HOME が在ればそちらを、
15
+ 無ければ ~/.local/state を使う。ここでも同じ規則で出す(片方だけずれると書けなくなる)。
16
+
17
+ ★どこまで許すか(必要最小・便 96e5455c のえふさん確定のまま):
18
+ ・許すのは 状態の置き場/conductor/reports の【中だけ】。
19
+ 親(状態の置き場/conductor)も、隣(conductor-reports のような別名)も許さない。
20
+ ・処理済みの控え(reports/processed/)はこの中なので、同じ許可で足りる(追加は要らない)。
21
+ ・守る場所の一覧(denyRead / denyWrite)には1件も足さない=秘密ファイル保護は広げない。
22
+ 囲いの禁止は許した場所の【中でも】効くので、万一この中に守る対象が置かれても止まる。
23
+ """
24
+ import os
25
+
26
+ #: 状態の置き場から見た、報告の控えの置き場。
27
+ REPORT_STORE_SUBPATH = ('conductor', 'reports')
28
+
29
+
30
+ def report_store_paths(env=None):
31
+ """報告の控えの置き場(囲いの設定に書く形で返す)。★配達役と同じ規則で決める。
32
+
33
+ XDG_STATE_HOME が在る機ではその絶対パス、無い機では `~/` から始まる形を返す
34
+ (`~` のままにするのは、囲いの設定にそのまま書けて、機ごとのホームに追従するため)。
35
+ """
36
+ env = os.environ if env is None else env
37
+ state = (env.get('XDG_STATE_HOME') or '').strip()
38
+ if state:
39
+ return [os.path.join(state, *REPORT_STORE_SUBPATH)]
40
+ return ['~/' + '/'.join(('.local', 'state') + REPORT_STORE_SUBPATH)]
@@ -435,6 +435,12 @@ SAMPLE_SETTINGS="$GUARD_SRC_DIR/settings.sample.json" # 取り寄せ先の宣
435
435
  # ★読み込めない機体では「1行も外さない・1行も書き換えない」へ倒す(フェイルクローズ)。
436
436
  DENY_SHAPE_SRC="$SCRIPT_DIR/deny-rule-shape.py"
437
437
 
438
+ # ★職人の報告の置き場の正本(置き場は1か所だけ・写しを作らない=便 2776f602)。
439
+ # ④-(3c) が、囲いの節が既に在る現場の「書いてよい場所」へこの1件だけを配る。
440
+ # 雛形を出す台本(gen-managed-settings-template.py)も同じ物を読む。
441
+ # ★読み込めない機体では「1件も足さない」へ倒す(推測で字面を書かない)。
442
+ REPORT_STORE_SRC="$SCRIPT_DIR/report-store-path.py"
443
+
438
444
  [[ -f "$GUARD_SRC_DIR/cc2_guard.py" ]] || fail "番人の正本が見つかりません: $GUARD_SRC_DIR/cc2_guard.py"
439
445
  [[ -f "$SETTINGS_SRC" ]] || fail "権限ルールの正本が見つかりません: $SETTINGS_SRC"
440
446
 
@@ -1320,11 +1326,12 @@ for proj in "${targets[@]}"; do
1320
1326
  fi
1321
1327
  rc=0
1322
1328
  APPLY="$APPLY" PYTHONDONTWRITEBYTECODE=1 \
1323
- python3 - "$dst" "$SETTINGS_SRC" "$SAMPLE_SETTINGS" "$DENY_SHAPE_SRC" <<'PYEOF' || rc=$?
1329
+ python3 - "$dst" "$SETTINGS_SRC" "$SAMPLE_SETTINGS" "$DENY_SHAPE_SRC" "$REPORT_STORE_SRC" <<'PYEOF' || rc=$?
1324
1330
  import importlib.util, json, os, shutil, sys, time
1325
1331
 
1326
1332
  dst_path, src_path, sample_path = sys.argv[1], sys.argv[2], sys.argv[3]
1327
1333
  shape_path = sys.argv[4]
1334
+ report_store_path_src = sys.argv[5]
1328
1335
  apply_mode = os.environ.get("APPLY") == "1"
1329
1336
 
1330
1337
  # ★形の判定は1か所(scripts/deny-rule-shape.py)だけ。①-e4(ホーム)も同じ物を読む=写しを作らない。
@@ -1341,6 +1348,20 @@ except Exception as e:
1341
1348
  file=sys.stderr)
1342
1349
  shape = None
1343
1350
 
1351
+ # ★報告の置き場も1か所(scripts/report-store-path.py)だけを読む=台本に字面を写さない。
1352
+ # 読めない機体では None にして (3c) を丸ごと飛ばす(推測で許可を足さない)。
1353
+ # ★飛ばしても守りは減らない(足し忘れるだけ)。足りない分は次の配り直しで入る。
1354
+ report_store = None
1355
+ try:
1356
+ _rspec = importlib.util.spec_from_file_location("report_store_path", report_store_path_src)
1357
+ _rmod = importlib.util.module_from_spec(_rspec)
1358
+ _rspec.loader.exec_module(_rmod)
1359
+ report_store = [p for p in _rmod.report_store_paths() if isinstance(p, str) and p]
1360
+ except Exception as e:
1361
+ print(f"[update-guard] 注意: 報告の置き場の正本を読めないので書き込み許可は足しません: "
1362
+ f"{report_store_path_src} ({e})", file=sys.stderr)
1363
+ report_store = None
1364
+
1344
1365
  def load(p):
1345
1366
  with open(p, encoding="utf-8") as f:
1346
1367
  return json.load(f)
@@ -1595,6 +1616,42 @@ if isinstance(dst_sandbox, dict):
1595
1616
  changes.append(f"sandbox.allowUnsandboxedCommands: {json.dumps(cur_unsandboxed)}→false 是正(サンドボックス外実行の素通りを塞ぐ)")
1596
1617
  # 既に false なら何もしない=2回流しても差分は出ない(冪等)。
1597
1618
 
1619
+ # --- (3c) 職人の報告の置き場を、囲いの中でも書ける場所に足す(便 2776f602) ---
1620
+ # 【なぜ要るか(★予言ではなく既発)】囲いの書き込みは「許した場所の中だけ」という作りなので、
1621
+ # 報告の置き場が許可に入っていない現場では、職人の報告が1件も残らない。
1622
+ # 2026-09-27 に tyhld-point で実際に起きた(`~/.local/state/conductor/reports/…:
1623
+ # Read-only file system`)。報告が無いと、管制は「終わった」と見えるのに中身が分からない。
1624
+ # 【なぜ配り直しに入れるか】2026-09-21(便 46205e8e)は、人が1現場ずつ手で足す手順で凌いだ。
1625
+ # 手で足した分は git にも配布にも載らないので、別のPC・新しい現場・設定を作り直した現場では
1626
+ # また塞がる。=「人が1回直す」ではなく、配り直しが毎回入れ直す形にして根治する。
1627
+ #
1628
+ # ★足すのは報告の置き場1件だけ($REPORT_STORE_SRC が出す物)。
1629
+ # 部品の置き場(pnpm・npm の控え)・/tmp/claude-1000 は【足さない】。
1630
+ # それらは要るかの判断が別(雛形 gen-managed-settings-template.py の側に在る)で、
1631
+ # ここで一緒に広げると「報告を残すため」の最小の許可でなくなる。
1632
+ # ★sandbox セクションが「既に在る現場」だけを対象にする((3)・(3b) と同じ理由=ADR-004)。
1633
+ # 無い現場に新設すると、囲い自体を有効化してしまう事故になる。
1634
+ # ★既存の allowWrite の行は1行も外さない・並べ替えない(不足分を後ろに足すだけ)。
1635
+ # ★allowWrite が一覧でない(壊れている・書き方が違う)ときは、推測で書き換えず報告だけする。
1636
+ # ★冪等: 既に入っていれば何もしない(2回流しても差分は出ない)。
1637
+ if isinstance(dst_sandbox, dict) and report_store:
1638
+ _fs = dst_sandbox.get("filesystem")
1639
+ _has_allow = isinstance(_fs, dict) and "allowWrite" in _fs
1640
+ if _has_allow and not isinstance(_fs.get("allowWrite"), list):
1641
+ print(f"[update-guard] ※ {dst_path}: sandbox.filesystem.allowWrite が一覧ではないので"
1642
+ f"報告の置き場は足しません(人の判断待ち)")
1643
+ else:
1644
+ _cur_allow = _fs.get("allowWrite") if _has_allow else []
1645
+ _missing_write = [p for p in report_store if p not in _cur_allow]
1646
+ if _missing_write:
1647
+ if not isinstance(_fs, dict):
1648
+ _fs = {}
1649
+ dst_sandbox["filesystem"] = _fs
1650
+ _fs["allowWrite"] = list(_cur_allow) + _missing_write
1651
+ changes.append(
1652
+ f"囲いの中でも書ける場所に報告の置き場を {len(_missing_write)} 件追記"
1653
+ f"({' / '.join(_missing_write)}。足さないと職人の報告が1件も残らない)")
1654
+
1598
1655
  # --- 反映 ---
1599
1656
  if not changes:
1600
1657
  print(f"[update-guard] 最新です(変更なし): {dst_path}")