@tyhld/conductor 0.12.132 → 0.12.134
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 +1 -1
- package/scripts/hooks/README.md +172 -1
- package/scripts/hooks/cc2_guard.py +178 -1
- package/scripts/hooks/hook_datalink.py +61 -0
- package/scripts/hooks/policy.py +233 -5
- package/scripts/hooks/test_named_target_search.py +314 -0
- package/scripts/hooks/test_port_forward_and_wait_loop.py +27 -8
- package/scripts/hooks/test_wait_loop_and_danger_stop.py +361 -0
- package/skills/conductor-craftsman/SKILL.md +16 -2
package/package.json
CHANGED
package/scripts/hooks/README.md
CHANGED
|
@@ -374,6 +374,9 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
|
|
|
374
374
|
- `(探す場所を書いていないので作業場所として判定)`
|
|
375
375
|
- `(書かれた場所を読み切れないので作業場所として判定)`=しるし(`*`)や変数で場所が決まる形
|
|
376
376
|
|
|
377
|
+
★**2026-10-10(便 3be099ba)から、倒す前に2つだけ読み切ります**=名指しの先が**実在のファイル**のときと、
|
|
378
|
+
引用符の途中で千切れた**切れ端**のとき(下の 1-10)。倒す安全側の振る舞いそのものは残しています。
|
|
379
|
+
|
|
377
380
|
### ★秘密の読み取りを、同じ目的のほかの道具でも止める
|
|
378
381
|
|
|
379
382
|
便 623cfb85・833c280c では、止められた探し方を**別の道具に替えて**続けていました。そこで
|
|
@@ -408,12 +411,180 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
|
|
|
408
411
|
- **番人が古い機体では効きません。** 各PCで人が1回 `APPLY=1 bash scripts/update-guard.sh` を
|
|
409
412
|
流すまで、その機では今までどおりです。
|
|
410
413
|
|
|
414
|
+
## 1-8. ★CI・合流の完了を「繰り返し」で待つ形を止める(便 de82bc3a・けいさん確定 2026-10-10)
|
|
415
|
+
|
|
416
|
+
### なぜ要るか(実地2便・どちらも devlog で未承認)
|
|
417
|
+
|
|
418
|
+
| 便 | 実地で打たれた形 | 何を待っていたか |
|
|
419
|
+
| --- | --- | --- |
|
|
420
|
+
| 812c68de | `until … ; do sleep …; done` | **合流**の完了 |
|
|
421
|
+
| 3c93bfc1 | `until grep -q 'exit=' <CI の記録>; do sleep 20; done` | **CI** の完了 |
|
|
422
|
+
|
|
423
|
+
便の禁止「CI や合流を待つ時は繰り返しを使わず、`gh pr checks`・`gh pr view` を1回ずつ打つ」が
|
|
424
|
+
2便続けて破られたのに、番人はこの形を**1度も止めていませんでした**(=職人の自制だけに任せていた)。
|
|
425
|
+
|
|
426
|
+
### 止める/通す(判定の正本は `policy.py` の `_disc_wait_loop`)
|
|
427
|
+
|
|
428
|
+
| 形 | 判定 | 理由 |
|
|
429
|
+
| --- | --- | --- |
|
|
430
|
+
| `until gh pr checks 301; do sleep 20; done` | **discipline** | 繰り返し + sleep + 合流・CI の状態 |
|
|
431
|
+
| `while true; do gh run list --limit 1; sleep 15; done` | **discipline** | 同 |
|
|
432
|
+
| `for i in $(seq 1 40); do gh run list --limit 1; sleep 15; done` | **discipline** | 同(`for` も見る) |
|
|
433
|
+
| `until grep -q 'exit=' /tmp/claude-1000/ci-pr301.log; do sleep 20; done` | **discipline** | 記録ファイルの名前が CI の記録と読める |
|
|
434
|
+
| `until grep -q success /tmp/claude-1000/release-main.log; do sleep 20; done` | **discipline** | 同(公開の記録) |
|
|
435
|
+
| `until git ls-remote origin main \| grep -q <SHA>; do sleep 10; done` | **discipline** | 合流の確かめ |
|
|
436
|
+
| `until npm view <部品> version \| grep -q <版>; do sleep 20; done` | **discipline** | 公開の確かめ |
|
|
437
|
+
| `gh run watch <実行ID> --exit-status` | **通す** | 道具自身が1回の命令で待つ(★推奨の形) |
|
|
438
|
+
| `gh pr checks 301 --watch` | **通す** | 同(★推奨案として通す・要判断に載せた) |
|
|
439
|
+
| `gh pr checks 301` / `gh pr view 301 --json state` / `gh run view <実行ID>` | **通す** | 状態を1回打つ(即返る) |
|
|
440
|
+
| `sleep 60` | **通す** | 1回だけの sleep(配信の読み置きを待つ) |
|
|
441
|
+
| `until [ -f /tmp/claude-1000/ready.flag ]; do sleep 2; done` | **通す** | CI と関係の無い待ち |
|
|
442
|
+
| `until grep -q owari /tmp/claude-1000/npm-test.log; do sleep 5; done` | **通す** | 手元の試験の記録(CI ではない) |
|
|
443
|
+
| `for f in test_*.py; do python3 "$f"; done` | **通す** | sleep が無い |
|
|
444
|
+
| `for n in 1 2 3; do gh pr view "$n" --json state; done` | **通す** | sleep が無い |
|
|
445
|
+
|
|
446
|
+
**当たる条件は3つとも揃ったときだけ**です。① `until`/`while`/`for` の繰り返しである
|
|
447
|
+
② その中で `sleep` を呼んでいる ③ 繰り返しの**条件か中身**で、CI・合流・配備・公開の状態
|
|
448
|
+
(`gh pr`/`gh run`/`gh workflow`/`gh release`/`gh api`、`git ls-remote`/`merge-base`/`fetch`、
|
|
449
|
+
`npm view`/`info`/`dist-tag`、配備の道具)か、**その記録だと読める名前のファイル**
|
|
450
|
+
(名前を `-_.` で割った1つが `ci`/`pr`/`merge`/`deploy`/`release`/`publish`/`workflow`/`actions`
|
|
451
|
+
と丸ごと一致する)を見に行っている。
|
|
452
|
+
|
|
453
|
+
### ほかの判定は1件も変わりません
|
|
454
|
+
|
|
455
|
+
作法(`discipline`)は `decide_bash` の**いちばん最後**に当たるので、繰り返しの中に危険・関門が
|
|
456
|
+
混ざっていれば今までどおりその理由が先に出ます(`until psql -h <本番> …; do sleep 5; done` は
|
|
457
|
+
`danger`、`until <配備の道具> --prod; do sleep 15; done` は人に聞く)。
|
|
458
|
+
|
|
459
|
+
### 分かっている限界
|
|
460
|
+
|
|
461
|
+
- **呼び出しを関数に寄せた形には当たりません。** 鉄則7-★の4段の塊の ④ は
|
|
462
|
+
`while :; do ST="$(V state .state)"; …; sleep 15; done` の形で、繰り返しの中に道具の名前が
|
|
463
|
+
字面で出ません。★この塊は**上限(`WAIT`・既定600秒)付きで段の結果を出す決められた待ち**で、
|
|
464
|
+
合流の完了を1回で待てる命令が無いため、**通したままにしています**(意図した線)。
|
|
465
|
+
- **見る先が変数で決まる形には当たりません**(`until grep -q x "$LOG"; do sleep 5; done`)。
|
|
466
|
+
- `for` の繰り返しで CI の記録を読みながら `sleep` を入れた形(待ちではなく繰り返し処理)も
|
|
467
|
+
止まります。`sleep` を外せば通ります(止める向きなので、そのままにしています)。
|
|
468
|
+
|
|
469
|
+
## 1-9. ★`danger` で止めた後は、報告と便の終わりに要る操作だけを通す(便 de82bc3a)
|
|
470
|
+
|
|
471
|
+
### なぜ要るか(実地 便 5d7e75fc・ai-saku・読むだけ)
|
|
472
|
+
|
|
473
|
+
番人が `danger: secret file (.env.local) inside … read without naming it by grep` で止めた後、
|
|
474
|
+
職人が「止められたのは**再帰の検索という手段**だけだ」と自分で判断し、`ls` と名指しの読み取りに
|
|
475
|
+
切り替えて作業を続けました。便の定め・鉄則⑤-2 の「`danger` のときは、書き直さず、別の方法・
|
|
476
|
+
別の道具も試さず、報告して停止する」に反します。**同じ日の便 9a9573b9 は同じ `danger` で正しく
|
|
477
|
+
停止**しており、守るかどうかが職人の判断に任されていました(根治=番人が機械で止める)。
|
|
478
|
+
|
|
479
|
+
### どう止めるか(正本は `cc2_guard.py` の `guard_output`)
|
|
480
|
+
|
|
481
|
+
その便(**セッション・現場・便ID の3つ**)で `danger` の `deny` を1回出したら印を置き、以後は
|
|
482
|
+
下の一覧だけを通します。ほかの命令・読み取り・書き込みは `danger:` のまま止めます(止め方は
|
|
483
|
+
`danger` のまま)。**関門(`gate`)の操作も、人に聞かずに止めます**(止めた後に本番操作の
|
|
484
|
+
カードを出さない)。
|
|
485
|
+
|
|
486
|
+
| # | `danger` の後でも通す物 | 何のため |
|
|
487
|
+
| --- | --- | --- |
|
|
488
|
+
| ① | 報告の置き場の中のファイルへの `Write`/`Edit`/`MultiEdit`/`NotebookEdit` | 報告を書く・直す |
|
|
489
|
+
| ② | 報告の置き場の中のファイルの `Read`/`NotebookRead` | `Edit` は先に読む必要がある |
|
|
490
|
+
| ③ | `mkdir -p <報告の置き場の中>` の1コマンドだけ(Bash) | 置き場のフォルダを作る |
|
|
491
|
+
| ④ | 道具の名前が `conductor_complete` で終わる物 | 完了の知らせ |
|
|
492
|
+
|
|
493
|
+
★報告の置き場の決め方は **`finish_gate.report_dirs` が正本**です(字面を2か所に置きません)。
|
|
494
|
+
★`build_output`(判定だけ)は1文字も変えていません。足したのは `guard_output` の1層だけで、
|
|
495
|
+
印が読めない機体では今までどおり動きます(フェイルセーフ)。
|
|
496
|
+
|
|
497
|
+
### 効く範囲と、人が解く方法
|
|
498
|
+
|
|
499
|
+
- **ほかの便・ほかの現場・別のセッションには効きません**(印の名前が3つで決まるので、便が
|
|
500
|
+
変われば自然に解けます)。印は一時領域(`$TMPDIR`/`/tmp`)に置き、**12時間で古くなります**
|
|
501
|
+
(`hook_datalink.DANGER_STOP_TTL_SEC`)。設定ファイルには1バイトも触りません。
|
|
502
|
+
- **印を置くのは `danger` だけ**です。作法(`discipline`)・関門(`gate`)で止めた回は置きません
|
|
503
|
+
(書き方を直して続けてよい種類なので)。
|
|
504
|
+
- **誤って止まったときは、人が自分のターミナルで印のファイルを消します**
|
|
505
|
+
(`rm -r <印のパス>`。番人は人の端末には掛かりません)。★印のパスは**止めたときの番人の文に
|
|
506
|
+
そのまま出します**ので、職人の報告を読めばそのまま打てます。
|
|
507
|
+
|
|
508
|
+
### 分かっている限界
|
|
509
|
+
|
|
510
|
+
- **PR を開いたまま `danger` で止まると、便の終わりの関門が「PR が開いたまま」で差し戻します。**
|
|
511
|
+
職人は合流の操作を打てないので、関門は上限(同じ理由3回・合計6回)まで止めた後、
|
|
512
|
+
「途中で終わった」の控えを残して手番を終わらせます。★**これは正しい姿**です(その便は実際に
|
|
513
|
+
途中で終わっています)。
|
|
514
|
+
- 印は「`danger` が1件出た」ことだけを見ます。**その `danger` が正しかったかどうかは見ません**
|
|
515
|
+
(止めすぎの直しは、これまでどおり番人の判定の側で直します)。
|
|
516
|
+
- ★**試験で本物のフック(`cc2_guard.py`)を動かすときは、`TMPDIR` を使い捨ての場所へ向けます。**
|
|
517
|
+
向けないと、試験が打った `danger` の印が**いま走っている本物の便**に付きます(実測:
|
|
518
|
+
`test/guard-for-codex.test.ts` が2回目の `npm test` で落ちた)。印の名前は現場と便IDで決まるので、
|
|
519
|
+
`CONDUCTOR_SITE` も使い捨ての名前にします。
|
|
520
|
+
|
|
521
|
+
## 1-10. ★名指しした先を読み切る(読むだけの検索を作業場所へ倒さない・便 3be099ba・2026-10-10)
|
|
522
|
+
|
|
523
|
+
### なぜ要るか(実地2便・どちらも作業が0件で終わった)
|
|
524
|
+
|
|
525
|
+
TYHLD-platform の2便が、**読むだけの検索**で同じ `danger` に止められました(どちらも職人は便の定めどおり
|
|
526
|
+
正しく停止=回避していません)。番人の文は2便とも同じで、
|
|
527
|
+
`danger: secret file (.npmrc) inside <リポの根> read without naming it by <検索の道具>` です。
|
|
528
|
+
|
|
529
|
+
| 便 | 実地で打たれた形 | 名指しした先 |
|
|
530
|
+
| --- | --- | --- |
|
|
531
|
+
| 1ff7b915 | `<検索の道具> -rn '語' <実在のファイル1つ> \| head -3` | **ファイル**1つ |
|
|
532
|
+
| 3bbde2e3 | `<検索の道具> -rn "a\|b\|c" <実在のフォルダ3つ> 2>/dev/null \| head -60` | **実在のフォルダ**3つ |
|
|
533
|
+
|
|
534
|
+
**原因は2つあり、どちらも「名指しした先を読み切れずに作業場所(リポの根)へ倒した」結果でした**
|
|
535
|
+
(作り物と実物の両方で再現済み。倒した先の根に `.npmrc` が在るため `danger` になっていました)。
|
|
536
|
+
|
|
537
|
+
1. **名指しの先が【ファイル】だと、1件も拾えなかった。** 探す場所を集める読み方が**実在のフォルダだけ**を
|
|
538
|
+
見ていたので、ファイルを名指しした形は「場所を書いていない形」と同じに扱われ、作業場所に倒れていました。
|
|
539
|
+
2. **探す言葉の当て字の縦棒(`\|`)で、場所が別の切れ端へ移っていた。** 止める側の区切りは
|
|
540
|
+
引用符の中でも機械的に割ります(便 ad6b5db9・**正しい設計**)。そのため `"a\` と `b\` と
|
|
541
|
+
`c" <フォルダ3つ>` に千切れ、**検索の道具の側に場所が1つも残らず**、やはり作業場所に倒れていました。
|
|
542
|
+
|
|
543
|
+
### どう直したか(判定の正本は `policy.py` の `_recursive_read_danger`)
|
|
544
|
+
|
|
545
|
+
- **名指しの先が実在のファイルなら、そのファイル自体だけを判定します**(`_existing_file`)。
|
|
546
|
+
再帰の旗が付いていても、読まれるのは名指しのファイルだけだからです(便 401fdc65 と同じ考え方=
|
|
547
|
+
**実在が確かめられたときだけ狭める**)。★**秘密の名前のファイルを名指しすれば、今までどおり止まります。**
|
|
548
|
+
- **引用符の途中で千切れた切れ端では、作業場所に倒しません**(`_quote_fragment`)。
|
|
549
|
+
★止める側は1件も減りません:同じ命令は**本物の区切り**(引用符を守る割り方)でも測り直すので、
|
|
550
|
+
場所を本当に書いていない形(`<検索の道具> -rn "a\|b"` だけ)は、そちらで今までどおり止まります。
|
|
551
|
+
- ★**`.npmrc` などを秘密として扱う判定は1文字も変えていません**(本物が探す先の中に在れば止まります)。
|
|
552
|
+
|
|
553
|
+
### 止める/通す(実測・★止まる→通るは「この読み違いの形」だけ)
|
|
554
|
+
|
|
555
|
+
| # | 形 | 判定 | 理由 |
|
|
556
|
+
| --- | --- | --- | --- |
|
|
557
|
+
| 通1 | `<検索の道具> -rn '語' <実在のファイル>` | **通す**(前は止まっていた) | 読むのはそのファイルだけ |
|
|
558
|
+
| 通2 | `<検索の道具> -rn "a\|b\|c" <実在のフォルダ3つ>` | **通す**(前は止まっていた) | 名指しの場所で判定する |
|
|
559
|
+
| 通3 | `<検索の道具> -rn "a\|b" <実在のファイル>` | **通す**(同) | 同 |
|
|
560
|
+
| 通4 | 隠しも読む旗つき・記録の外まで読む旗つきで**ファイルを名指し** | **通す**(同) | 同 |
|
|
561
|
+
| 止1 | `<検索の道具> -rn '語' <秘密の名前のファイル>` | **danger** | 名指しの先が秘密(`touched by …`) |
|
|
562
|
+
| 止2 | 場所を1つも書かない | **danger** | 作業場所として判定(前からの安全側) |
|
|
563
|
+
| 止3 | 作業場所の根・点1つ(`.`)を名指し | **danger** | 同 |
|
|
564
|
+
| 止4 | 実在しない場所・しるし(`*`)を含む場所 | **danger** | 読み切れないので作業場所として判定 |
|
|
565
|
+
| 止5 | 秘密を含むフォルダを名指し | **danger** | 探した場所の中に秘密が在る |
|
|
566
|
+
| 止6 | 当て字の縦棒+場所を書かない/根/秘密のファイル/実在しない場所 | **danger** | 本物の区切りの側で止まる |
|
|
567
|
+
| 止7 | 名前を並べて読ませる形・包みの中・変数ごし | **danger** | 変更なし(1-7 のまま) |
|
|
568
|
+
| 止8 | 名指しのファイルの検索と、同じ行の危険(秘密の読み・保護ブランチへの push ほか) | **danger** | ほかの判定が先に当たる |
|
|
569
|
+
|
|
570
|
+
直す前(`631d998`)と後を**60形**で突き合わせ、**変わらない48/★止まる→通る12(上の通1〜通4の仲間)/
|
|
571
|
+
通る→止まる0件**でした。既存の番人の試験(`test_*.py` 35本)は**1本も落ちていません**。
|
|
572
|
+
|
|
573
|
+
### 分かっている限界
|
|
574
|
+
|
|
575
|
+
- **`find <実在のファイル> -exec <読む道具> {} +` の形は、今までどおり作業場所に倒れます**
|
|
576
|
+
(`_find_feed_danger` は別の判定で、この便の原因として確かめられた形ではないため触っていません)。
|
|
577
|
+
- **切れ端の見分けは「閉じていない引用符で終わるか」で決めます。** 引用符が閉じている形
|
|
578
|
+
(`<検索の道具> -rn "it's" <場所>`)は切れ端ではないので、今までどおりの読み方になります。
|
|
579
|
+
- **番人が古い機体では効きません。** 各PCで人が1回配布を流すまで、その機では今までどおりです
|
|
580
|
+
(この機で実地2便が止まったときの版は **0.12.123**=理由の文に倒した旨の注が無い版でした)。
|
|
581
|
+
|
|
411
582
|
## 2. ファイルの役割
|
|
412
583
|
|
|
413
584
|
| ファイル | 役割 |
|
|
414
585
|
| --- | --- |
|
|
415
586
|
| `policy.py` | 判定そのもの(純粋関数だけ・標準ライブラリのみ)。**製品固有の名前を持たない=切り出し可能** |
|
|
416
|
-
| `cc2_guard.py` | PreToolUse フックの入口。標準入力を読み、policy
|
|
587
|
+
| `cc2_guard.py` | PreToolUse フックの入口。標準入力を読み、policy に聞き、決まった形で答える。★`danger` で止めた後は、報告と便の終わりに要る操作だけを通す(1-9・`guard_output`) |
|
|
417
588
|
| `permission_request_hook.py` | PermissionRequest フック。管制へ確認を送り、人の答えを待って返す |
|
|
418
589
|
| `stop_hook.py` | Stop フック。職人が人へ**問いかけて**止まったとき、管制へ知らせる(ADR-008) |
|
|
419
590
|
| `hook_datalink.py` | フックと管制のやり取り(HTTP)。**製品固有の前提を持たない=切り出し可能** |
|
|
@@ -69,6 +69,7 @@ import sys
|
|
|
69
69
|
|
|
70
70
|
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
|
71
71
|
|
|
72
|
+
import finish_gate # noqa: E402 … 報告の置き場の正本(report_dirs)だけを借りる
|
|
72
73
|
import hook_datalink # noqa: E402 … 起動記録 と 管制への問い合わせに使う
|
|
73
74
|
import permission_request_hook # noqa: E402 … 関門の2択カード(ask_gate)
|
|
74
75
|
import policy # noqa: E402
|
|
@@ -282,6 +283,182 @@ def build_output(data, datalink=hook_datalink, codex=False):
|
|
|
282
283
|
return out
|
|
283
284
|
|
|
284
285
|
|
|
286
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
287
|
+
# danger で止めたあとは、報告と便の終わりに要る操作だけを通す(便 de82bc3a)
|
|
288
|
+
#
|
|
289
|
+
# 【なぜ要るか(実地 便 5d7e75fc・ai-saku・読むだけ)】番人が
|
|
290
|
+
# danger: secret file (.env.local) inside … read without naming it by grep
|
|
291
|
+
# で止めたあと、職人が「止められたのは再帰の検索という手段だけだ」と自分で判断し、
|
|
292
|
+
# `ls` と名指しの読み取りに切り替えて作業を続けた。便の定め・鉄則⑤-2 の
|
|
293
|
+
# 「danger のときは、書き直さず、別の方法・別の道具も試さず、報告して停止する」に反する。
|
|
294
|
+
# 同じ日の便 9a9573b9 は同じ danger で正しく止まっており、★守るかどうかが職人の判断に
|
|
295
|
+
# 任されていた。番人が機械で止めれば、判断に任せない(根治=鉄則10)。
|
|
296
|
+
#
|
|
297
|
+
# 【どう止めるか】その便(セッション・現場・便ID の3つ)で danger の deny を1回出したら印を置き、
|
|
298
|
+
# 以後は「報告を書く・報告の置き場へ書く・便を終える」に要る操作だけを通す。
|
|
299
|
+
# ほかの命令・読み取り・書き込みは `danger:` のまま止める(止め方は danger のまま)。
|
|
300
|
+
#
|
|
301
|
+
# 【通す物の一覧(これだけ)】
|
|
302
|
+
# ① 報告の置き場の中のファイルへの Write / Edit / MultiEdit(=報告を書く・直す)
|
|
303
|
+
# ② 報告の置き場の中のファイルの Read(Edit は先に読む必要があるため)
|
|
304
|
+
# ③ 報告の置き場のフォルダを作る Bash(`mkdir -p <報告の置き場…>` の1コマンドだけ)
|
|
305
|
+
# ④ 完了の知らせ(道具の名前が `conductor_complete` で終わる物)
|
|
306
|
+
# ★報告の置き場の決め方は finish_gate.report_dirs が正本(字面を2か所に置かない)。
|
|
307
|
+
#
|
|
308
|
+
# 【効かない範囲】ほかの便・ほかの現場・別のセッションには効かない(印の名前が変わる)。
|
|
309
|
+
# 印は一時領域に置き、12時間で古くなる(hook_datalink.DANGER_STOP_TTL_SEC)。
|
|
310
|
+
# 【人が解く方法】人が自分のターミナルで印のファイルを消す(パスは止めたときの文に出る)。
|
|
311
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
312
|
+
|
|
313
|
+
#: 報告を書く・直す道具。
|
|
314
|
+
_REPORT_WRITE_TOOLS = frozenset({'Write', 'Edit', 'MultiEdit', 'NotebookEdit'})
|
|
315
|
+
#: 報告を読み返す道具(Edit の前提)。
|
|
316
|
+
_REPORT_READ_TOOLS = frozenset({'Read', 'NotebookRead'})
|
|
317
|
+
#: 報告の置き場を作る形で許す道具(これ以外の Bash は通さない)。
|
|
318
|
+
_REPORT_MKDIR = 'mkdir'
|
|
319
|
+
_REPORT_MKDIR_FLAGS = frozenset({'-p', '--parents', '-pv', '-v', '--verbose'})
|
|
320
|
+
|
|
321
|
+
|
|
322
|
+
def _report_store_dirs(env=None):
|
|
323
|
+
"""報告の置き場(★正本は finish_gate.report_dirs・ここでは絶対パスに直すだけ)。"""
|
|
324
|
+
try:
|
|
325
|
+
dirs = finish_gate.report_dirs(os.environ if env is None else env)
|
|
326
|
+
except Exception: # noqa: BLE001
|
|
327
|
+
return []
|
|
328
|
+
out = []
|
|
329
|
+
for d in dirs:
|
|
330
|
+
try:
|
|
331
|
+
out.append(os.path.realpath(os.path.abspath(os.path.expanduser(str(d)))))
|
|
332
|
+
except Exception: # noqa: BLE001
|
|
333
|
+
continue
|
|
334
|
+
return out
|
|
335
|
+
|
|
336
|
+
|
|
337
|
+
def inside_report_store(path, env=None):
|
|
338
|
+
"""その道のりが報告の置き場の【中】なら True(置き場そのものも中に数える)。"""
|
|
339
|
+
if not path or not isinstance(path, str) or not path.strip():
|
|
340
|
+
return False
|
|
341
|
+
try:
|
|
342
|
+
p = os.path.realpath(os.path.abspath(os.path.expanduser(path.strip())))
|
|
343
|
+
except Exception: # noqa: BLE001
|
|
344
|
+
return False
|
|
345
|
+
for d in _report_store_dirs(env):
|
|
346
|
+
if p == d or p.startswith(d + os.sep):
|
|
347
|
+
return True
|
|
348
|
+
return False
|
|
349
|
+
|
|
350
|
+
|
|
351
|
+
def _is_report_mkdir(command, env=None):
|
|
352
|
+
"""`mkdir -p <報告の置き場の中>` の1コマンドだけなら True。"""
|
|
353
|
+
try:
|
|
354
|
+
segments = policy.split_commands(command, bodies=False)
|
|
355
|
+
except Exception: # noqa: BLE001
|
|
356
|
+
return False
|
|
357
|
+
if len(segments) != 1:
|
|
358
|
+
return False
|
|
359
|
+
toks = policy.tokens_of(segments[0])
|
|
360
|
+
if not toks or os.path.basename(toks[0]) != _REPORT_MKDIR:
|
|
361
|
+
return False
|
|
362
|
+
targets = []
|
|
363
|
+
for t in toks[1:]:
|
|
364
|
+
if t.startswith('-'):
|
|
365
|
+
if t not in _REPORT_MKDIR_FLAGS:
|
|
366
|
+
return False
|
|
367
|
+
continue
|
|
368
|
+
targets.append(t)
|
|
369
|
+
return bool(targets) and all(inside_report_store(t, env) for t in targets)
|
|
370
|
+
|
|
371
|
+
|
|
372
|
+
def after_danger_allowed(data, env=None):
|
|
373
|
+
"""danger で止めたあとでも通す操作(報告と便の終わりに要る物)なら True。"""
|
|
374
|
+
if not isinstance(data, dict):
|
|
375
|
+
return False
|
|
376
|
+
tool = str(data.get('tool_name') or '')
|
|
377
|
+
tin = data.get('tool_input')
|
|
378
|
+
if not isinstance(tin, dict):
|
|
379
|
+
tin = {}
|
|
380
|
+
if tool.rsplit('__', 1)[-1] == 'conductor_complete':
|
|
381
|
+
return True
|
|
382
|
+
if tool in _REPORT_WRITE_TOOLS or tool in _REPORT_READ_TOOLS:
|
|
383
|
+
return inside_report_store(tin.get('file_path') or tin.get('notebook_path') or '', env)
|
|
384
|
+
if tool == 'Bash':
|
|
385
|
+
return _is_report_mkdir(str(tin.get('command') or ''), env)
|
|
386
|
+
return False
|
|
387
|
+
|
|
388
|
+
|
|
389
|
+
def danger_stop_key(data, env=None):
|
|
390
|
+
"""印の名前を決める3つ(セッション・現場・便ID)。"""
|
|
391
|
+
site = site_of(data if isinstance(data, dict) else {}, env)
|
|
392
|
+
session = ''
|
|
393
|
+
if isinstance(data, dict):
|
|
394
|
+
session = str(data.get('session_id') or '')
|
|
395
|
+
return session, site, job_id_of(site, env)
|
|
396
|
+
|
|
397
|
+
|
|
398
|
+
def danger_stop_reason(key, base, env=None):
|
|
399
|
+
"""止めたときに職人へ返す1行(★印のパスも出す=人が解けるように)。"""
|
|
400
|
+
try:
|
|
401
|
+
marker = hook_datalink.danger_stop_marker_path(*key, env=os.environ if env is None else env)
|
|
402
|
+
except Exception: # noqa: BLE001
|
|
403
|
+
marker = '(印のパスを読めません)'
|
|
404
|
+
base_reason = ''
|
|
405
|
+
if isinstance(base, dict) and base.get('reason'):
|
|
406
|
+
base_reason = f"(この命令そのものの判定: {base['reason']})"
|
|
407
|
+
return (
|
|
408
|
+
'danger: この便は番人が danger で止めたあとです。書き直さず・別の方法も別の道具も試さず、'
|
|
409
|
+
'止められた命令の全文と番人の文を報告して停止してください(鉄則4・鉄則の常連 ⑤-2)。'
|
|
410
|
+
'いま通すのは、報告の置き場の中のファイルを書く・直す・読む/その置き場を作る mkdir -p/'
|
|
411
|
+
'完了の知らせ(conductor_complete)だけです。'
|
|
412
|
+
f'★誤って止まったときは、人が自分のターミナルで印を消します: rm -r {marker}'
|
|
413
|
+
f'{base_reason}'
|
|
414
|
+
)
|
|
415
|
+
|
|
416
|
+
|
|
417
|
+
def is_danger_reason(reason):
|
|
418
|
+
"""番人の理由が「危険(danger)」の種類かどうか(作法 discipline・関門 gate は入らない)。"""
|
|
419
|
+
return str(reason or '').startswith('danger:')
|
|
420
|
+
|
|
421
|
+
|
|
422
|
+
def guard_output(data, datalink=hook_datalink, codex=False, env=None):
|
|
423
|
+
"""入口の答え(build_output)に、便の状態の決まり(danger のあとは止める)を重ねる。
|
|
424
|
+
|
|
425
|
+
★build_output(判定だけ)は1文字も変えない=今までの判定は1件も変わらない。
|
|
426
|
+
ここで足すのは「同じ便の中で danger を出したあとかどうか」の1つだけ。
|
|
427
|
+
"""
|
|
428
|
+
key = danger_stop_key(data if isinstance(data, dict) else {}, env)
|
|
429
|
+
try:
|
|
430
|
+
latched = datalink.danger_stop_active(*key)
|
|
431
|
+
except Exception: # noqa: BLE001
|
|
432
|
+
latched = False # 印が読めない機体では今までどおり(番人を止めない)
|
|
433
|
+
if latched and not after_danger_allowed(data, env):
|
|
434
|
+
try:
|
|
435
|
+
base = policy.decide_event(data) # ★純粋な判定(人には聞かない)
|
|
436
|
+
except Exception: # noqa: BLE001
|
|
437
|
+
base = None
|
|
438
|
+
try:
|
|
439
|
+
datalink.record_decision(data.get('tool_name') if isinstance(data, dict) else None,
|
|
440
|
+
'deny')
|
|
441
|
+
except Exception: # noqa: BLE001
|
|
442
|
+
pass
|
|
443
|
+
try:
|
|
444
|
+
datalink.mark_danger_stop(*key) # 便が続く間は印を新しく保つ
|
|
445
|
+
except Exception: # noqa: BLE001
|
|
446
|
+
pass
|
|
447
|
+
out = _deny_output(danger_stop_reason(key, base, env))
|
|
448
|
+
record_block(data, out['hookSpecificOutput']['permissionDecisionReason'], datalink)
|
|
449
|
+
return out
|
|
450
|
+
|
|
451
|
+
out = build_output(data, datalink=datalink, codex=codex)
|
|
452
|
+
if out and isinstance(out.get('hookSpecificOutput'), dict) \
|
|
453
|
+
and out['hookSpecificOutput'].get('permissionDecision') == 'deny' \
|
|
454
|
+
and is_danger_reason(out['hookSpecificOutput'].get('permissionDecisionReason')):
|
|
455
|
+
try:
|
|
456
|
+
datalink.mark_danger_stop(*key)
|
|
457
|
+
except Exception: # noqa: BLE001
|
|
458
|
+
pass
|
|
459
|
+
return out
|
|
460
|
+
|
|
461
|
+
|
|
285
462
|
def main() -> int:
|
|
286
463
|
# ★--codex … Codex から呼ばれた印(登録先 ~/.codex/hooks.json に付けてある)。
|
|
287
464
|
# 知らない引数は無視する(増えても番人は落とさない)。
|
|
@@ -296,7 +473,7 @@ def main() -> int:
|
|
|
296
473
|
# ふつうの操作は一瞬で終わるので、ここに達するのは関門で待っているときだけ。
|
|
297
474
|
_arm_hard_limit()
|
|
298
475
|
try:
|
|
299
|
-
out =
|
|
476
|
+
out = guard_output(data, codex=codex)
|
|
300
477
|
except Exception: # noqa: BLE001
|
|
301
478
|
out = None
|
|
302
479
|
if not codex and _is_gate(data):
|
|
@@ -409,6 +409,67 @@ def handoff_active(session_id='', env=None, now=None):
|
|
|
409
409
|
return 0 <= age < HANDOFF_TTL_SEC
|
|
410
410
|
|
|
411
411
|
|
|
412
|
+
# ─── 「この便は danger で止めたあと」の印(便 de82bc3a) ──────────────────────
|
|
413
|
+
# 【なぜ要るか(実地 便 5d7e75fc)】番人が `danger` で止めたあと、職人が「止められたのは
|
|
414
|
+
# 手段だけだ」と自分で判断し、別の読み方へ切り替えて作業を続けた。同じ日の便 9a9573b9 は
|
|
415
|
+
# 同じ `danger` で正しく止まっており、守るかどうかが職人の判断に任されていた。
|
|
416
|
+
# 【印の決め方】セッション・現場・便ID の3つで1つの印にする=ほかの便・ほかの現場・
|
|
417
|
+
# 別のセッションには効かない(便が変われば印の名前も変わるので、自然に消える)。
|
|
418
|
+
# 【印の置き場】プロセス間の合図なので一時領域に置く(設定ファイルには一切触れない)。
|
|
419
|
+
# 【人が解く方法】人が自分のターミナルで印のファイルを消す(番人は人の端末に掛からない)。
|
|
420
|
+
# 印のパスは、止めたときの番人の文にそのまま出す。
|
|
421
|
+
DANGER_STOP_TTL_SEC = 12 * 60 * 60
|
|
422
|
+
|
|
423
|
+
|
|
424
|
+
def _marker_key(*parts):
|
|
425
|
+
"""印の名前に使える形へ(英数と - _ だけ・各64字まで)。"""
|
|
426
|
+
out = []
|
|
427
|
+
for p in parts:
|
|
428
|
+
safe = ''.join(c for c in str(p or '') if c.isalnum() or c in '-_')[:64]
|
|
429
|
+
if safe:
|
|
430
|
+
out.append(safe)
|
|
431
|
+
return '-'.join(out) or 'default'
|
|
432
|
+
|
|
433
|
+
|
|
434
|
+
def danger_stop_marker_path(session_id='', site='', job='', env=None):
|
|
435
|
+
"""『この便は danger で止めたあと』の印の置き場(一時領域)。"""
|
|
436
|
+
env = os.environ if env is None else env
|
|
437
|
+
base = (env.get('TMPDIR') or '/tmp').rstrip('/')
|
|
438
|
+
return os.path.join(base, f'.tyhld-hook-danger-stop-{_marker_key(session_id, site, job)}')
|
|
439
|
+
|
|
440
|
+
|
|
441
|
+
def mark_danger_stop(session_id='', site='', job='', env=None):
|
|
442
|
+
"""印を置く/新しくする。失敗しても黙って進む(フックは止めない)。"""
|
|
443
|
+
path = danger_stop_marker_path(session_id, site, job, env)
|
|
444
|
+
try:
|
|
445
|
+
with open(path, 'w', encoding='utf-8') as f:
|
|
446
|
+
f.write(str(int(time.time())))
|
|
447
|
+
except Exception: # noqa: BLE001
|
|
448
|
+
return None
|
|
449
|
+
return path
|
|
450
|
+
|
|
451
|
+
|
|
452
|
+
def clear_danger_stop(session_id='', site='', job='', env=None):
|
|
453
|
+
"""印を消す(人が解くとき・試験の後片付け)。"""
|
|
454
|
+
try:
|
|
455
|
+
os.unlink(danger_stop_marker_path(session_id, site, job, env))
|
|
456
|
+
except Exception: # noqa: BLE001
|
|
457
|
+
pass
|
|
458
|
+
|
|
459
|
+
|
|
460
|
+
def danger_stop_active(session_id='', site='', job='', env=None, now=None):
|
|
461
|
+
"""印が新しければ True(=この便はもう danger で止めてある)。
|
|
462
|
+
|
|
463
|
+
★古い印は無効にする。フックが強制終了して印が残っても、次の便が永久に止まらない。
|
|
464
|
+
"""
|
|
465
|
+
path = danger_stop_marker_path(session_id, site, job, env)
|
|
466
|
+
try:
|
|
467
|
+
age = (time.time() if now is None else now) - os.path.getmtime(path)
|
|
468
|
+
except Exception: # noqa: BLE001
|
|
469
|
+
return False
|
|
470
|
+
return 0 <= age < DANGER_STOP_TTL_SEC
|
|
471
|
+
|
|
472
|
+
|
|
412
473
|
def _request(cfg, method, path, body=None, timeout=HTTP_TIMEOUT_SEC):
|
|
413
474
|
"""管制へ1回だけ問い合わせる。失敗は None(例外を投げない=フックを止めない)。
|
|
414
475
|
|