@tyhld/conductor 0.12.122 → 0.12.123

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.122",
3
+ "version": "0.12.123",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -206,6 +206,16 @@ branch protection は「CI が通っていない物を main に入れない」
206
206
  `export`)・`~`・`$HOME`・`${HOME}`・相対の道・波括弧 `{a,b}`・`*`。**解けない変数は後ろの字面で照らし、
207
207
  確かめられないものは守る側に倒します。**
208
208
 
209
+ ★**Windows 側の相互運用の呼び出しも包みとして剥がします**(便 04da1a56・`_INTEROP_WRAPPERS`)。
210
+ `wsl` / `wsl.exe`(道筋つき・道筋なし・大文字小文字・`.exe` の有無)と、その前置きの旗
211
+ (利用者の指定 `-u` / `--user` / `--user=…`・配布の指定 `-d` / `--distribution`・作業場所 `--cd`・
212
+ 殻の種類 `--shell-type`・`-e` / `--exec` / `--`)を剥がし、**中身を素の形とまったく同じ判定にかけます**。
213
+ Windows 側の殻(`powershell` / `pwsh` / `cmd` の `-c` / `-Command` / `/c`)も「中身をもう一度測る殻」として
214
+ 扱います。★**中身が読めない形で `root` の指定が付いた呼び出しは DENY**(命令が1語も無い=root の殻を開く・
215
+ `bash` / `sh` / `su` / `sudo` のように殻を開くだけ・変数やコマンド置換で決まる・符号化して渡す形)。
216
+ 符号化した中身を Windows 側の殻へ渡す形(`-EncodedCommand`)も DENY です。
217
+ ★**読むだけは通します**(`wsl.exe -u root cat <場所>`・`wsl.exe -l -v`・`wsl.exe --version`)。
218
+
209
219
  ★**読むだけは通します**(`cat`・`less`・`grep`・`rg`・`diff`・`jq`・`ls`・`stat`・`git status`・外へ写す `cp`)。
210
220
  通常開発・作業ブランチ・正規 merge も通します。使い捨ての作業場(`/tmp` の下)の同じ名前も通します。
211
221
  報告・コミットの説明に場所の名前が書いてあるだけ、引用符の中の `>` も止めません。
@@ -220,6 +230,8 @@ branch protection は「CI が通っていない物を main に入れない」
220
230
  | 未知の道具に場所を渡す形(`mytool --write <場所>`・`ansible -m copy -a dest=<場所>`) | 塞いでいない | 道具ごとに「どの引数が書き込み先か」が違う。名指しで足すと際限がなく、普通の作業が止まる |
221
231
  | コンパイル済みプログラム・`$(cat ファイル)` で場所を作る形・機体の外で定義した環境変数だけの場所 | 塞いでいない | 番人からは書き込み先が見えない(中身を実行しないと分からない) |
222
232
  | 別の機械への書き込み(`scp x host:<場所>`・`rsync a host:…`) | 範囲外 | この機体の番人の設定ではない |
233
+ | Windows 側の相互運用の呼び出しで包む形(`wsl.exe -u root <書き込み>`・Windows 側の殻ごし) | 塞いだ | `_INTEROP_WRAPPERS` を包みの一覧へ入れ、中身を素と同じ判定にかける(便 04da1a56) |
234
+ | 相互運用の呼び出しを**別の名前に写して**打つ形(`cp /mnt/c/.../wsl.exe /tmp/w; /tmp/w …`) | 塞いでいない | 名前で見分ける作りの限界。既存の包み(`bash` を写した形)と同じ(便 04da1a56) |
223
235
 
224
236
  ★塞いでいないものの最後の砦は **OS の層(サンドボックス)** です。ここは「字面で見える書き込み」を
225
237
  広く塞ぐ層で、字面から見えない道(台本・未知の道具・別プロセス)は設計上の限界として残ります。
@@ -239,6 +251,7 @@ branch protection は「CI が通っていない物を main に入れない」
239
251
  | `test_gate_real_commands.py` | 関門の当てどころの回帰試験(誤読の実例81件の形・本物の反映・止めてはいけない関門・便 ad6b5db9) |
240
252
  | `test_deny_remaining_routes.py` | 残る抜け道(番人の設定への書き込み・千切れた動詞での秘密の読み取り・API での main の書き換え)の `deny` と、止めてはいけない操作の試験(便 c05796ec) |
241
253
  | `test_guard_config_all_routes.py` | 番人の設定を弱める道を「手段を問わず」塞ぐ試験(書き込みの手段ごと・包みを剥がす・止めてはいけないもの・便 0f92a767) |
254
+ | `test_interop_wsl_wrapper.py` | Windows 側の相互運用の呼び出しで包んだ命令の試験(7形 × 5つの置き場 × 包みの書き方・root で中身が読めない形・止めてはいけない読み取り・便 04da1a56) |
242
255
  | (`../check_permission_rules.py`) | 現場の許可設定に残った「番人と食い違う行」を洗い出す検査(読むだけ・ADR-009) |
243
256
  | `test_hook_datalink.py` | 連絡線の単体テスト。`python3 scripts/hooks/test_hook_datalink.py` |
244
257
  | `settings.sample.json` | フック登録の見本(★人間が `~/.claude/settings.json` へ反映する) |
@@ -514,6 +527,10 @@ Claude Code 側のフック打ち切り(`timeout: 600`)と同時に終わる
514
527
  破壊的な `DROP TABLE` / `DROP DATABASE` は関門ではなく **`deny`** で止まります。
515
528
  - `sudo` は「ラッパ」として読み飛ばし、中の実体で判定します(`sudo rm` は従来どおり deny)。
516
529
  権限昇格そのものを止める規則は置いていません。
530
+ - Windows 側の相互運用の呼び出し(`wsl` / `wsl.exe`)も同じく包みとして読み飛ばし、中の実体で判定します
531
+ (便 04da1a56)。**`root` の指定が付いて中身が読めない形だけは、権限昇格そのものを deny にします**
532
+ (中身が読めなければ「素と同じ判定」にできないため)。見分けは**名前**なので、呼び出しを別の名前へ
533
+ 写して打つ形は素通りします(`bash` を写した形と同じ限界)。そこは OS の層(サンドボックス)が受け持ちます。
517
534
  - 秘密の判定は**「読む・書く・持ち出す」動詞が対象に取ったとき**だけ効きます。
518
535
  未知の道具に秘密を渡す形(`mytool .env`)は素通りします。
519
536
  ここを「引数に字面があれば止める」まで広げると、コミットメッセージや説明文に `.env` と
@@ -668,6 +668,131 @@ _WRAPPERS = frozenset({
668
668
  })
669
669
  _ASSIGN_RE = re.compile(r'^[A-Za-z_][A-Za-z0-9_]*=')
670
670
 
671
+ # ═════════════════════════════════════════════════════════════════════════════
672
+ # ★Windows 側の相互運用の呼び出し(包み)— ここが唯一の正本(便 04da1a56)
673
+ #
674
+ # 【塞いだ穴(便 6659f7e2 の重大発見1・この便で再測)】
675
+ # 番人は包み(env・sudo・nohup・time・xargs …)を剥がしてから測る作りだが、剥がす一覧に
676
+ # Windows 側の相互運用の呼び出しが1つも無かった。そのため、同じ中身をこの呼び出しで包むと
677
+ # 先頭が「見知らぬ道筋の命令」に見えて、守りの置き場への書き込みが「no gate, no danger」で
678
+ # 通った(この便の測り:320形のうち 240形が ALLOW。/etc の管理者の設定・差し込み・
679
+ # ~/.tyhld の番人の本体・持ち主の登録・各現場の設定の5か所すべて)。
680
+ # 同じ原因で、Windows 側の殻(中身を文字列で抱える形)ごしの呼び出しも素通りしていた。
681
+ #
682
+ # 【どう直すか】道具の名前を足して回るのではなく、既存の「包みを剥がす」仕掛けに
683
+ # この呼び出しの形を足し、剥がした中身を【今までと同じ判定】にかける(根治)。
684
+ # 剥がす処理は3か所(verb_of・_tool_words・_unwrap)あるが、一覧はこの1か所だけを引く。
685
+ # ★中身が読めない形(1語も無い=root の殻がそのまま開く・変数やコマンド置換・符号化で渡す形)に
686
+ # 利用者の指定(root)が付いていたら、危険として止める(_interop_root_danger)。
687
+ # ═════════════════════════════════════════════════════════════════════════════
688
+
689
+ #: Windows 側の相互運用の呼び出し(道筋つき・道筋なし・.exe の有無・大文字小文字を問わない)。
690
+ _INTEROP_WRAPPERS = frozenset({'wsl'})
691
+
692
+ #: その前置きの旗のうち、値を【次の語】で受け取る物(利用者の指定・配布の指定・作業場所・殻の種類)。
693
+ # ★`=` で値を付ける形(--user=root)は1語で済むので、ここには要らない。
694
+ # ★`-e` / `--exec` / `--` は値を取らない(この次から中の命令)ので、ここには入れない。
695
+ _INTEROP_VALUE_FLAGS = frozenset({
696
+ '-u', '--user', '-d', '--distribution', '--distribution-id', '--cd', '--shell-type',
697
+ })
698
+
699
+ #: 利用者を指定する旗(この指定が root で、中の命令が読めないときは危険として止める)。
700
+ _INTEROP_USER_FLAGS = frozenset({'-u', '--user'})
701
+
702
+ #: Windows 側の殻(`-Command "…"` / `/c "…"` のように、中身を文字列で抱える)。
703
+ # ★_SHELL_RUNNERS へ混ぜる=「中身をもう一度コマンドとして測る」既存の仕掛けに相乗りする。
704
+ _WINDOWS_SHELLS = frozenset({'powershell', 'pwsh', 'cmd'})
705
+
706
+ #: Windows 側の殻が「中身」を渡すための旗(大文字小文字を問わずに照らす)。
707
+ _WIN_CODE_FLAGS = frozenset({'-c', '-command', '-commandwithargs', '-encodedcommand', '/c', '/k'})
708
+
709
+ #: 中身を確かめられない渡し方(符号化して渡す形)。
710
+ _INTEROP_OPAQUE_FLAGS = frozenset({'-encodedcommand', '--encodedcommand'})
711
+
712
+ #: 中の命令が「殻を開くだけ」で、何をするかが字面に無い形。
713
+ _ROOT_SHELL_VERBS = frozenset({'su', 'login', 'sudo', 'doas'})
714
+
715
+
716
+ def _exe_base(token: str) -> str:
717
+ """道具の名前(道筋を落とした字面)。
718
+
719
+ ★Windows 側の実行ファイルの形(`.exe` 付き・大文字小文字・逆斜線の道筋)のときだけ、
720
+ その飾りを外して小文字にそろえる。`.exe` で終わらない名前は1文字も変えない
721
+ (=今までの判定を1つも変えない。実コードに `.exe` を見る行は元から0行だった)。
722
+ """
723
+ base = token.split('/')[-1]
724
+ low = base.lower()
725
+ if low.endswith('.exe'):
726
+ return low.split('\\')[-1][:-4]
727
+ return base
728
+
729
+
730
+ def _skip_interop_flags(tokens, i: int) -> int:
731
+ """相互運用の呼び出しの旗を飛ばして、中の命令が始まる位置を返す。"""
732
+ while i < len(tokens) and tokens[i].startswith('-'):
733
+ t = tokens[i]
734
+ if t == '--':
735
+ return i + 1
736
+ i += 2 if t in _INTEROP_VALUE_FLAGS else 1
737
+ return i
738
+
739
+
740
+ def _interop_user(rest) -> str:
741
+ """相互運用の呼び出しの「利用者の指定」。無ければ ''。"""
742
+ user = ''
743
+ for k, a in enumerate(rest):
744
+ if a == '--':
745
+ break
746
+ if a in _INTEROP_USER_FLAGS and k + 1 < len(rest):
747
+ user = rest[k + 1]
748
+ elif a.startswith('--user='):
749
+ user = a.split('=', 1)[1]
750
+ return user.strip().strip('\'"').lower()
751
+
752
+
753
+ def _interop_root_danger(tokens):
754
+ """相互運用の呼び出しに root の指定が付き、中の命令が読めないなら理由を返す。
755
+
756
+ ★剥がせた呼び出しは、中身を今までと同じ判定にかけるので、ここでは何も言わない。
757
+ 読めないのは次の3つ:中の命令が1語も無い(root の殻がそのまま開く)・
758
+ 殻を開くだけの命令(su・login・包みだけ)・字面で確かめられない形(変数・
759
+ コマンド置換・符号化して渡す形)。
760
+ """
761
+ for i, t in enumerate(tokens):
762
+ if _exe_base(t) not in _INTEROP_WRAPPERS:
763
+ continue
764
+ rest = tokens[i + 1:]
765
+ if _interop_user(rest) != 'root':
766
+ continue
767
+ inner = rest[_skip_interop_flags(rest, 0):]
768
+ if not inner:
769
+ return 'interop call as root with no command (root shell)'
770
+ # 中の命令の名前が素の語でない(変数・コマンド置換で決まる)か、符号化して渡している。
771
+ if any(c in inner[0] for c in '$`') \
772
+ or any(a.lower() in _INTEROP_OPAQUE_FLAGS for a in inner):
773
+ return 'interop call as root with an unreadable command'
774
+ verb = _exe_base(inner[0])
775
+ if verb in _ROOT_SHELL_VERBS or verb in _SHELL_RUNNERS:
776
+ if not any(_is_code_flag(a) for a in inner[1:]):
777
+ return f'interop call as root opening a shell ({verb})'
778
+ return None
779
+
780
+
781
+ def _opaque_shell_danger(tokens):
782
+ """Windows 側の殻に、符号化した中身を渡す形なら理由を返す(便 04da1a56)。
783
+
784
+ ★中身が符号化されていると、番人は1文字も測れない=「剥がせない包み」そのもの。
785
+ 相互運用の呼び出しを中に隠せるので、この渡し方は危険として止める。
786
+ ★ふつうの中身(`-Command "…"`・`/c "…"`)は今までどおり測る(止めない)。
787
+ """
788
+ for i, t in enumerate(tokens):
789
+ if _exe_base(t) not in _WINDOWS_SHELLS:
790
+ continue
791
+ for a in tokens[i + 1:]:
792
+ if a.lower() in _INTEROP_OPAQUE_FLAGS:
793
+ return 'windows shell with an encoded (unreadable) command'
794
+ return None
795
+
671
796
 
672
797
  def verb_of(tokens):
673
798
  """セグメントの実行動詞(ラッパ・変数代入を飛ばした先頭語)。無ければ ''。"""
@@ -679,7 +804,11 @@ def verb_of(tokens):
679
804
  if _ASSIGN_RE.match(t) or t in _SHELL_KEYWORDS:
680
805
  i += 1
681
806
  continue
682
- base = t.split('/')[-1]
807
+ base = _exe_base(t)
808
+ # ★Windows 側の相互運用の呼び出しも包みとして剥がす(旗は値を取る物だけ値ごと飛ばす)。
809
+ if base in _INTEROP_WRAPPERS:
810
+ i = _skip_interop_flags(tokens, i + 1)
811
+ continue
683
812
  if base in _WRAPPERS:
684
813
  i += 1
685
814
  # ラッパのオプションを飛ばす(timeout 600 のような値も1つ飛ばす)。
@@ -789,7 +918,10 @@ def redirect_targets(segment: str):
789
918
  # ═════════════════════════════════════════════════════════════════════════════
790
919
 
791
920
  # 「-c の中身がシェルコマンド」の道具。中身はもう一度コマンドとして測る。
792
- _SHELL_RUNNERS = frozenset({'bash', 'sh', 'zsh', 'dash', 'ksh'})
921
+ # ★Windows 側の殻も混ぜる(便 04da1a56)。混ぜないと、殻ごしに相互運用を呼ぶ形
922
+ # (`<Windows の殻> -c "<相互運用の呼び出し> -u root tee <守りの置き場>"`)の中身が
923
+ # 1度も測られず素通りする(実測)。一覧は _WINDOWS_SHELLS が正本。
924
+ _SHELL_RUNNERS = frozenset({'bash', 'sh', 'zsh', 'dash', 'ksh'}) | _WINDOWS_SHELLS
793
925
 
794
926
  # 「-c / -e の中身がプログラム」の道具。中身は文字列として秘密の名前を探す。
795
927
  _CODE_RUNNERS = frozenset({
@@ -799,6 +931,15 @@ _CODE_RUNNERS = frozenset({
799
931
  # 中身を渡すための旗。
800
932
  _CODE_FLAGS = frozenset({'-c', '-e', '--eval', '--command'})
801
933
 
934
+
935
+ def _is_code_flag(token: str) -> bool:
936
+ """中身を文字列で渡す旗か。
937
+
938
+ ★Windows 側の殻の書き方(`-Command`・`/c`・大文字小文字の違い)も同じ扱いにする
939
+ (便 04da1a56)。そろえないと、殻ごしに渡した中身が1度も測られない。
940
+ """
941
+ return token in _CODE_FLAGS or token.lower() in _WIN_CODE_FLAGS
942
+
802
943
  # ヒアドキュメント(<<EOF … EOF / <<'PY' … PY)の本体を取り出す。
803
944
  _HEREDOC_RE = re.compile(
804
945
  r'<<-?\s*[\'"]?([A-Za-z_][A-Za-z0-9_]*)[\'"]?[^\n]*\n(.*?)\n\s*\1\s*(?:\n|$)',
@@ -910,7 +1051,7 @@ def _inner_payloads(command: str):
910
1051
  for text in [command] + split_segments(command):
911
1052
  toks = tokens_of(text)
912
1053
  for i, t in enumerate(toks):
913
- if t not in _CODE_FLAGS or i + 1 >= len(toks):
1054
+ if not _is_code_flag(t) or i + 1 >= len(toks):
914
1055
  continue
915
1056
  runner = verb_of(toks[:i]) if i else ''
916
1057
  if runner in _SHELL_RUNNERS:
@@ -1565,7 +1706,11 @@ def _tool_words(tokens):
1565
1706
  if _ASSIGN_RE.match(t) or t in _SHELL_KEYWORDS:
1566
1707
  i += 1
1567
1708
  continue
1568
- base = t.split('/')[-1]
1709
+ base = _exe_base(t)
1710
+ # ★Windows 側の相互運用の呼び出しも包みとして剥がす(一覧は _INTEROP_WRAPPERS が正本)。
1711
+ if base in _INTEROP_WRAPPERS:
1712
+ i = _skip_interop_flags(tokens, i + 1)
1713
+ continue
1569
1714
  if base in _WRAPPERS:
1570
1715
  i += 1
1571
1716
  while i < len(tokens) and tokens[i].startswith('-'):
@@ -1618,7 +1763,9 @@ def _tool_words(tokens):
1618
1763
  if t in value_flags:
1619
1764
  skip = True
1620
1765
  continue
1621
- words.append(_strip_version(t.split('/')[-1].lower()) if k == 0 else t.lower())
1766
+ # ★頭の語は、Windows 側の実行ファイルの飾り(.exe)も外す(便 04da1a56)。
1767
+ # 外さないと `<Windows の殻>.exe` が殻として読めず、中身が1度も測られない。
1768
+ words.append(_strip_version(_exe_base(t).lower()) if k == 0 else t.lower())
1622
1769
  return words
1623
1770
 
1624
1771
 
@@ -2317,6 +2464,11 @@ def _bypass_segment_danger(seg, tokens, cwd, command):
2317
2464
  # ★git の危険な部分命令(reset --hard・clean -fd・credential)も、前置きの旗を飛ばして
2318
2465
  # 語の並びで見る(便 65cd34ad)。
2319
2466
  hit = _git_token_danger(tokens)
2467
+ if hit:
2468
+ return hit
2469
+ # ★Windows 側の相互運用の呼び出しに root の指定が付き、中の命令が読めない形(便 04da1a56)。
2470
+ # 剥がせた呼び出しは中身を今までと同じ判定にかけるので、ここでは何も言わない。
2471
+ hit = _interop_root_danger(tokens) or _opaque_shell_danger(tokens)
2320
2472
  if hit:
2321
2473
  return hit
2322
2474
  # ★安全の決まりを省いた子の職人の起こし方も、同じく語の並びで見る(便 4b9e6e8b)。
@@ -3400,6 +3552,9 @@ _GUARD_WRAPPERS = {
3400
3552
  'flock': {'-w', '-E', '--timeout', '--conflict-exit-code'},
3401
3553
  'busybox': set(), 'toybox': set(), # 多機能の道具(`busybox sed -i …` の中の道具を見る)
3402
3554
  }
3555
+ # ★Windows 側の相互運用の呼び出しも、この包みの一覧へ足す(便 04da1a56)。
3556
+ # 名前と旗の一覧は _INTEROP_WRAPPERS / _INTEROP_VALUE_FLAGS が正本=同じ一覧を2つ持たない。
3557
+ _GUARD_WRAPPERS.update({name: set(_INTEROP_VALUE_FLAGS) for name in _INTEROP_WRAPPERS})
3403
3558
  # 文の頭に付く予約語(if/then/do …)とサブシェルの括弧。
3404
3559
  _SHELL_KEYWORDS = frozenset({'if', 'then', 'else', 'elif', 'do', 'while', 'until', '!', '{', '(', 'time'})
3405
3560
 
@@ -3490,7 +3645,8 @@ def _unwrap(tokens):
3490
3645
  if t in _SHELL_KEYWORDS or _ASSIGN_RE.match(t):
3491
3646
  i += 1
3492
3647
  continue
3493
- base = t.split('/')[-1]
3648
+ # ★Windows 側の実行ファイルの飾り(.exe・大文字小文字)を外してから一覧と照らす。
3649
+ base = _exe_base(t)
3494
3650
  if base in _GUARD_WRAPPERS:
3495
3651
  seen.add(base)
3496
3652
  vals = _GUARD_WRAPPERS[base]
@@ -3887,7 +4043,7 @@ def _guard_write_segment(segment: str, cwd=None, command='', depth=0, env=None):
3887
4043
  pos, wrappers = _unwrap(tokens)
3888
4044
  if pos >= len(tokens):
3889
4045
  return None
3890
- verb = tokens[pos].split('/')[-1]
4046
+ verb = _exe_base(tokens[pos])
3891
4047
  args = _plain_args(tokens, pos + 1)
3892
4048
  paths = [a for a in args if not a.startswith('-')]
3893
4049
  targets, parents = [], []
@@ -3898,7 +4054,7 @@ def _guard_write_segment(segment: str, cwd=None, command='', depth=0, env=None):
3898
4054
  payloads = []
3899
4055
  if verb == 'eval':
3900
4056
  payloads.append(' '.join(args))
3901
- payloads += [tokens[k + 1] for k, t in enumerate(tokens) if t in _CODE_FLAGS and k + 1 < len(tokens)]
4057
+ payloads += [tokens[k + 1] for k, t in enumerate(tokens) if _is_code_flag(t) and k + 1 < len(tokens)]
3902
4058
  for extra in (_here_string(tokens), _heredoc_body(head, command)):
3903
4059
  if extra:
3904
4060
  payloads.append(extra)
@@ -3908,7 +4064,7 @@ def _guard_write_segment(segment: str, cwd=None, command='', depth=0, env=None):
3908
4064
  return f'{hit} (inside {verb})'
3909
4065
  return None
3910
4066
  if verb in _CODE_RUNNERS:
3911
- codes = [tokens[k + 1] for k, t in enumerate(tokens) if t in _CODE_FLAGS and k + 1 < len(tokens)]
4067
+ codes = [tokens[k + 1] for k, t in enumerate(tokens) if _is_code_flag(t) and k + 1 < len(tokens)]
3912
4068
  for extra in (_here_string(tokens), _heredoc_body(head, command)):
3913
4069
  if extra:
3914
4070
  codes.append(extra)
@@ -4359,7 +4515,7 @@ def _shell_payloads(head_tokens, body):
4359
4515
  """シェルに渡された中身(-c の文字列・ヒアドキュメントの本文)。"""
4360
4516
  out = []
4361
4517
  for k, t in enumerate(head_tokens):
4362
- if t in _CODE_FLAGS and k + 1 < len(head_tokens):
4518
+ if _is_code_flag(t) and k + 1 < len(head_tokens):
4363
4519
  out.append(head_tokens[k + 1])
4364
4520
  if body.strip():
4365
4521
  out.append(body)
@@ -0,0 +1,301 @@
1
+ #!/usr/bin/env python3
2
+ """Windows 側の相互運用の呼び出しで包んだ命令の試験(便 04da1a56)。
3
+
4
+ 実行: python3 scripts/hooks/test_interop_wsl_wrapper.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【なぜ要るか(便 6659f7e2 の重大発見1・この便で測り直した)】
8
+ 番人は包み(env・sudo・nohup・time・xargs …)を剥がしてから測る作りだが、剥がす一覧に
9
+ Windows 側の相互運用の呼び出しが1つも入っていなかった。そのため、管理者権限の命令ごしなら
10
+ すべて止まる「守りの置き場への書き込み」が、同じ中身を相互運用の呼び出し+root の指定で
11
+ 包むだけで「no gate, no danger」で通った。
12
+ この機(WSL)では相互運用が有効で、呼び出しの口(/run/WSL/*_interop)は誰でも使える権限
13
+ なので、理屈の上の経路ではなく実在の経路である。
14
+ ★この便では実際に呼んでいない(判定の関数に文字列を渡しただけ)。
15
+
16
+ 【ここで固定すること】
17
+ (1) 便 6659f7e2 第4節の表で ALLOW だった7形が、5つの置き場すべてで止まる
18
+ (/etc の管理者の設定・/etc の差し込み・~/.tyhld の番人の本体・持ち主の登録・現場の設定)
19
+ (2) 包みの書き方を変えても止まる(道筋つき/なし・.exe の有無・大文字小文字・
20
+ 利用者の指定・配布の指定・-e・--exec・--・Windows の殻ごし・つなぎ・入れ子・変数)
21
+ (3) 中身が読めない形で root の指定が付いた呼び出しは止まる
22
+ (命令が1語も無い・殻を開くだけ・変数・符号化して渡す形)
23
+ (4) ★止めてはいけない普通の作業は止めない(読むだけ・一覧を見るだけ・
24
+ 相互運用を使わない Windows 側の読み取り・ふつうの版管理の作業)
25
+ (5) ★包みを剥がした結果は「素の形と同じ判定」になる(強くも弱くもしない)
26
+ (6) 包みの一覧は1か所だけ(同じ一覧を3つ持たない)
27
+
28
+ ★見本の危険語・置き場は部品から組み立てる(番人の見本にそのまま書かない)。
29
+ """
30
+ import os
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:78} {str(got)[:30]}')
45
+
46
+
47
+ # ── 部品(置き場と包みを直接書かない) ──
48
+ HOME = os.path.expanduser('~')
49
+ MANAGED = '/etc/' + 'claude' + '-' + 'code'
50
+ ETC_FILE = MANAGED + '/managed-settings.json'
51
+ ETC_DROPIN = MANAGED + '/managed-settings.d/10-deny.json'
52
+ GUARD_BODY = HOME + '/.' + 'tyhld' + '/hooks/policy.py'
53
+ HOME_REG = HOME + '/.' + 'claude' + '/settings.json'
54
+ #: 現場の設定(★使い捨ての作業場の下に置かない=そこは Write と同じ例外で元から通る)
55
+ SITE_CFG = '/opt/site/.' + 'claude' + '/settings.json'
56
+
57
+ WSL = 'wsl' + '.' + 'exe' # 相互運用の呼び出し(名前だけ)
58
+ WSL_BARE = 'wsl' # 拡張子なし
59
+ WSL_PATH = '/mnt/c/Windows/System32/' + WSL
60
+ WSL_UPPER = '/mnt/c/Windows/System32/WSL.EXE'
61
+ PWSH = 'powershell' + '.' + 'exe' # Windows 側の殻
62
+ CMD = 'cmd' + '.' + 'exe'
63
+ ROOT = '-u root'
64
+
65
+ WORK = '/tmp/claude-1000'
66
+
67
+
68
+ def dq(s):
69
+ """二重引用符で正しく囲む(中の引用符は逃がす)。★入れ子が壊れた字面を測らないため。"""
70
+ return '"' + s.replace('\\', '\\\\').replace('"', '\\"') + '"'
71
+
72
+
73
+ def bodies(path):
74
+ """便 6659f7e2 第4節の表の7形(+管理者権限の命令を重ねる形)。"""
75
+ folder = os.path.dirname(path)
76
+ return [
77
+ ('土台へ流し込む', 'tee ' + path),
78
+ ('置き場へ写す', 'cp ' + WORK + '/x.json ' + path),
79
+ ('別の写し道具で置く', 'install -m 644 ' + WORK + '/x.json ' + path),
80
+ ('細工の道具で流す', 'dd of=' + path),
81
+ ('別の言語から書く', 'python3 -c ' + dq("open('" + path + "','w')")),
82
+ ('差し込みのフォルダを作る', 'mkdir -p ' + folder),
83
+ ('管理者権限の命令を重ねる', 'sudo tee ' + path),
84
+ ]
85
+
86
+
87
+ PLACES = [
88
+ ('管理者の設定', ETC_FILE),
89
+ ('管理者の差し込み', ETC_DROPIN),
90
+ ('番人の本体', GUARD_BODY),
91
+ ('持ち主の登録', HOME_REG),
92
+ ('現場の設定', SITE_CFG),
93
+ ]
94
+
95
+ #: 包みの書き方(★すべて「中身は同じ」)。
96
+ WRAPS = [
97
+ ('相互運用(名前だけ)+root', lambda s: f'{WSL} {ROOT} {s}'),
98
+ ('相互運用(道筋つき)+root', lambda s: f'{WSL_PATH} {ROOT} {s}'),
99
+ ('相互運用(大文字・道筋つき)+root', lambda s: f'{WSL_UPPER} {ROOT} {s}'),
100
+ ('相互運用(拡張子なし)+root', lambda s: f'{WSL_BARE} {ROOT} {s}'),
101
+ ('相互運用+root+区切りの --', lambda s: f'{WSL} {ROOT} -- {s}'),
102
+ ('相互運用+root+-e', lambda s: f'{WSL} {ROOT} -e {s}'),
103
+ ('相互運用+root+--exec', lambda s: f'{WSL} {ROOT} --exec {s}'),
104
+ ('相互運用+--user=root', lambda s: f'{WSL} --user=root {s}'),
105
+ ('相互運用+配布の指定+root', lambda s: f'{WSL} -d Ubuntu-24.04 {ROOT} {s}'),
106
+ ('相互運用+配布の指定(長い旗)+root', lambda s: f'{WSL} --distribution Ubuntu {ROOT} {s}'),
107
+ ('相互運用+作業場所の指定+root', lambda s: f'{WSL} --cd {WORK} {ROOT} {s}'),
108
+ ('相互運用(root の指定なし)', lambda s: f'{WSL} {s}'),
109
+ ('Windows の殻+相互運用+root', lambda s: f'{PWSH} -c ' + dq(f'{WSL} {ROOT} {s}')),
110
+ ('Windows の殻(大文字の旗)+相互運用', lambda s: f'{PWSH} -Command ' + dq(f'{WSL} {ROOT} {s}')),
111
+ ('Windows の殻=cmd+相互運用', lambda s: f'{CMD} /c ' + dq(f'{WSL} {ROOT} {s}')),
112
+ ]
113
+
114
+ # ─────────────────────────────────────────────────────────────────────────────
115
+ # (1)(2) 7形 × 5つの置き場 × 包みの書き方
116
+ # ★素の形が止まる物は、どの包みでも止まる(=包みで逃げられない)。
117
+ # ★素の形が元から通る物(守りの置き場の親フォルダを作るだけ=設定は1文字も変わらない)は、
118
+ # 包みを剥がした結果も素と同じになる(強くも弱くもしない)。下の parity で固定する。
119
+ # ─────────────────────────────────────────────────────────────────────────────
120
+ print('\n=== (1) 素の形(包みなし)の判定を先に固定する ===')
121
+ parity = []
122
+ for place_name, path in PLACES:
123
+ for body_name, body in bodies(path):
124
+ bare = policy.decide_bash(body, cwd=WORK)['decision']
125
+ if body_name == '差し込みのフォルダを作る' and bare != policy.DENY:
126
+ # 置き場を作るだけ(~/.claude ・現場の .claude)。素でも通る=穴ではない。
127
+ parity.append((place_name, body_name, body, bare))
128
+ check(f'素は通る(置き場を作るだけ) {place_name}/{body_name}', bare, policy.ALLOW)
129
+ continue
130
+ check(f'素で止まる {place_name}/{body_name}', bare, policy.DENY)
131
+
132
+ print('\n=== (2) 相互運用の包みごしでも、素で止まる物はどの書き方でも止まる ===')
133
+ for place_name, path in PLACES:
134
+ for body_name, body in bodies(path):
135
+ if policy.decide_bash(body, cwd=WORK)['decision'] != policy.DENY:
136
+ continue
137
+ for wrap_name, wrap in WRAPS:
138
+ cmd = wrap(body)
139
+ r = policy.decide_bash(cmd, cwd=WORK)
140
+ check(f'deny {place_name}/{body_name}/{wrap_name}', r['decision'], policy.DENY)
141
+
142
+ print('\n=== (2a) 素で通る物は、包みごしでも素と同じ(強くも弱くもしない) ===')
143
+ for place_name, body_name, body, bare in parity:
144
+ for wrap_name, wrap in WRAPS:
145
+ got = policy.decide_bash(wrap(body), cwd=WORK)['decision']
146
+ check(f'素と同じ {place_name}/{body_name}/{wrap_name}', got, bare)
147
+
148
+ # ─────────────────────────────────────────────────────────────────────────────
149
+ # (2b) つなぎ・入れ子・ほかの包みの中に入れても止まる
150
+ # ─────────────────────────────────────────────────────────────────────────────
151
+ print('\n=== (2b) つなぎ・入れ子・ほかの包みの中でも止まる ===')
152
+ INNER = f'{WSL} {ROOT} tee {ETC_FILE}'
153
+ for cmd in [
154
+ f'true && {INNER}',
155
+ f'true; {INNER}',
156
+ f'echo x | {INNER}',
157
+ f'sudo {INNER}',
158
+ f'env FOO=1 {INNER}',
159
+ f'nohup {INNER}',
160
+ f'timeout 60 {INNER}',
161
+ f'xargs {INNER}',
162
+ f'( {INNER} )',
163
+ 'bash -c ' + dq(INNER),
164
+ 'sh -c ' + dq(INNER),
165
+ f'$({INNER})',
166
+ f'W={WSL}; $W {ROOT} tee {ETC_FILE}',
167
+ f'if true; then {INNER}; fi',
168
+ ]:
169
+ r = policy.decide_bash(cmd, cwd=WORK)
170
+ check(f'deny {cmd[:70]}', r['decision'], policy.DENY)
171
+
172
+ # ─────────────────────────────────────────────────────────────────────────────
173
+ # (3) 中身が読めない形で root の指定が付いた呼び出し
174
+ # ─────────────────────────────────────────────────────────────────────────────
175
+ print('\n=== (3) 中身が読めない形で root の指定が付いた呼び出しは止まる ===')
176
+ for cmd in [
177
+ f'{WSL} {ROOT}', # 命令が1語も無い=root の殻がそのまま開く
178
+ f'{WSL} {ROOT} --',
179
+ f'{WSL_PATH} {ROOT}',
180
+ f'{WSL} {ROOT} bash', # 殻を開くだけ(何をするかが字面に無い)
181
+ f'{WSL} {ROOT} sh',
182
+ f'{WSL} {ROOT} -- bash -i',
183
+ f'{WSL} {ROOT} su -',
184
+ f'{WSL} {ROOT} sudo -i',
185
+ f'{WSL} {ROOT} $CMD', # 変数(字面で確かめられない)
186
+ f'{WSL} {ROOT} ${{CMD}}',
187
+ f'{WSL} {ROOT} `echo tee`',
188
+ f'{WSL} {ROOT} {PWSH} -EncodedCommand dGVl', # 符号化して渡す形
189
+ f'{PWSH} -EncodedCommand dGVl', # 殻だけでも中身が読めない
190
+ f'{PWSH} -encodedcommand dGVl',
191
+ ]:
192
+ r = policy.decide_bash(cmd, cwd=WORK)
193
+ check(f'deny {cmd[:70]}', r['decision'], policy.DENY)
194
+
195
+ print('\n=== (3b) 止めているのは【足した判定】である(空振りの証拠) ===')
196
+ for cmd in [f'{WSL} {ROOT}', f'{WSL} {ROOT} bash', f'{WSL} {ROOT} $CMD']:
197
+ got = policy._interop_root_danger(policy.tokens_of(cmd))
198
+ check(f'root の読めない呼び出しの判定が当たる {cmd[:40]}', bool(got), True)
199
+ check('符号化の判定が当たる',
200
+ bool(policy._opaque_shell_danger(policy.tokens_of(f'{PWSH} -EncodedCommand dGVl'))), True)
201
+
202
+ # ─────────────────────────────────────────────────────────────────────────────
203
+ # (4) ★止めてはいけない普通の作業
204
+ # ─────────────────────────────────────────────────────────────────────────────
205
+ print('\n=== (4) 読むだけ・一覧を見るだけは今までどおり通る ===')
206
+ for cmd in [
207
+ f'{WSL} --version',
208
+ f'{WSL} -l -v',
209
+ f'{WSL} --status',
210
+ f'{WSL} cat {ETC_FILE}',
211
+ f'{WSL} {ROOT} cat {ETC_FILE}',
212
+ f'{WSL} {ROOT} ls -la {MANAGED}',
213
+ f'{WSL} {ROOT} stat {GUARD_BODY}',
214
+ f'{PWSH} -c ' + dq(f'{WSL} {ROOT} cat {ETC_FILE}'),
215
+ 'cat /mnt/c/Users/public/readme.txt', # 相互運用を使わない Windows 側の読み取り
216
+ 'ls -la /mnt/c/Windows/System32',
217
+ 'head -5 /mnt/c/Users/public/readme.txt',
218
+ f'{WSL} echo hello',
219
+ ]:
220
+ r = policy.decide_bash(cmd, cwd=WORK)
221
+ check(f'not deny {cmd[:70]}', r['decision'] != policy.DENY, True)
222
+
223
+ print('\n=== (4b) ふつうの作業(相互運用と無関係)も今までどおり ===')
224
+ for cmd in [
225
+ 'git status --porcelain',
226
+ 'git log --oneline -3',
227
+ 'rg relay src',
228
+ 'ls -la scripts/hooks',
229
+ 'npm test',
230
+ 'gh pr checks 1',
231
+ ]:
232
+ r = policy.decide_bash(cmd, cwd=WORK)
233
+ check(f'not deny {cmd[:70]}', r['decision'] != policy.DENY, True)
234
+
235
+ # ─────────────────────────────────────────────────────────────────────────────
236
+ # (5) ★包みを剥がした結果は「素の形と同じ判定」になる(強くも弱くもしない)
237
+ # ─────────────────────────────────────────────────────────────────────────────
238
+ print('\n=== (5) 包みを剥がした結果は素の形と同じ判定になる ===')
239
+ SAME = [
240
+ 'tee ' + ETC_FILE,
241
+ 'cp ' + WORK + '/x.json ' + HOME_REG,
242
+ 'cat ' + ETC_FILE,
243
+ 'ls -la ' + MANAGED,
244
+ 'mkdir -p ' + os.path.dirname(HOME_REG), # 置き場を作るだけ=素でも通る
245
+ 'mkdir -p ' + os.path.dirname(SITE_CFG),
246
+ 'echo hello',
247
+ ]
248
+ for body in SAME:
249
+ bare = policy.decide_bash(body, cwd=WORK)['decision']
250
+ for wrap_name, wrap in (('相互運用+root', WRAPS[0][1]), ('Windows の殻ごし', WRAPS[12][1])):
251
+ got = policy.decide_bash(wrap(body), cwd=WORK)['decision']
252
+ check(f'{wrap_name} は素と同じ: {body[:46]}', got, bare)
253
+
254
+ # ─────────────────────────────────────────────────────────────────────────────
255
+ # (6) 包みの一覧は1か所だけ(同じ一覧を3つ持たない)
256
+ # ─────────────────────────────────────────────────────────────────────────────
257
+ print('\n=== (6) 包みの一覧は1つの正本から使い回す ===')
258
+ check('相互運用の呼び出しの正本が在る', sorted(policy._INTEROP_WRAPPERS), ['wsl'])
259
+ check('包みを剥がす一覧(_GUARD_WRAPPERS)が正本を取り込んでいる',
260
+ all(n in policy._GUARD_WRAPPERS for n in policy._INTEROP_WRAPPERS), True)
261
+ check('その旗の一覧も正本と同じ',
262
+ all(set(policy._GUARD_WRAPPERS[n]) == set(policy._INTEROP_VALUE_FLAGS)
263
+ for n in policy._INTEROP_WRAPPERS), True)
264
+ check('動詞の読み取りが包みを剥がす',
265
+ policy.verb_of(policy.tokens_of(f'{WSL} {ROOT} tee {ETC_FILE}')), 'tee')
266
+ check('道具の語の並びも包みを剥がす',
267
+ policy._tool_words(policy.tokens_of(f'{WSL} {ROOT} git push origin main'))[:2],
268
+ ['git', 'push'])
269
+ check('Windows の殻は「中身を測る殻」として扱う',
270
+ policy._WINDOWS_SHELLS <= policy._SHELL_RUNNERS, True)
271
+ check('実行ファイルの飾りを外す(.exe・大文字・道筋)', policy._exe_base(WSL_UPPER), 'wsl')
272
+ check('.exe で終わらない名前は1文字も変えない', policy._exe_base('/usr/bin/Tee'), 'Tee')
273
+ check('旗の読み飛ばしは値を取る旗だけ値ごと飛ばす',
274
+ policy._skip_interop_flags(policy.tokens_of(f'{ROOT} -d Ubuntu --system tee x'), 0), 5)
275
+
276
+ # ─────────────────────────────────────────────────────────────────────────────
277
+ # (7) ★元から止まっていた形は1つも緩んでいない
278
+ # ─────────────────────────────────────────────────────────────────────────────
279
+ print('\n=== (7) 元から止まっていた形はそのまま止まる ===')
280
+ for cmd in [
281
+ 'sudo tee ' + ETC_FILE,
282
+ 'sudo cp ' + WORK + '/x.json ' + ETC_FILE,
283
+ 'tee ' + GUARD_BODY,
284
+ 'tee ' + HOME_REG,
285
+ 'tee ' + SITE_CFG,
286
+ 'sed -i s/a/b/ ' + HOME_REG,
287
+ 'python3 -c ' + dq("open('" + GUARD_BODY + "','w')"),
288
+ 'git -C ' + WORK + '/x re' + 'set --ha' + 'rd HEAD',
289
+ 'git push --force origin main',
290
+ 'git add -A',
291
+ ]:
292
+ r = policy.decide_bash(cmd, cwd=WORK)
293
+ check(f'deny {cmd[:70]}', r['decision'], policy.DENY)
294
+
295
+ print()
296
+ if failures:
297
+ print(f'FAIL {len(failures)} 件')
298
+ for f in failures:
299
+ print(f' - {f}')
300
+ sys.exit(1)
301
+ print('ALL PASS')