@tyhld/conductor 0.12.168 → 0.12.170

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/dist/selfcheck.js CHANGED
@@ -1037,10 +1037,82 @@ const DANGER_STOP_CLEAR = [
1037
1037
  ' for data in json.load(sys.stdin):',
1038
1038
  ' clear(*key(data))',
1039
1039
  ].join('\n');
1040
+ /** 入っている番人の入口(cc2_guard.py)の道筋。 */
1041
+ function guardPath(d) {
1042
+ return path.join(d.home, '.tyhld', 'hooks', 'cc2_guard.py');
1043
+ }
1044
+ /** 番人に1件判定させ、答え(deny / allow / ask / none=何も返さない=委譲)を返す。 */
1045
+ function askGuard(d, guard, probe, env) {
1046
+ const r = d.exec('python3', [guard], { input: JSON.stringify(probe), env, timeoutMs: 30_000 });
1047
+ try {
1048
+ return JSON.parse(r.stdout).hookSpecificOutput?.permissionDecision ?? 'none';
1049
+ }
1050
+ catch {
1051
+ return 'none'; // 何も返さない=委譲(allow ではない)
1052
+ }
1053
+ }
1054
+ // ── 完了の知らせを、この機体の名前のまま番人が通すか(便 12526bb8) ──
1055
+ // 【何が起きたか(実地 便 ba854574・TYHLD-GOTO)】claude.ai のコネクタだけの機体では、管制の道具は
1056
+ // `mcp__claude_ai_ai-kana__conductor_complete` の名前になる。番人は danger のあとに
1057
+ // `mcp__ai-kana__…` の形の読み込みしか通さなかったので、職人が完了の知らせを送れなかった。
1058
+ // 【どう確かめるか】この機体で職人に見える ai-kana の登録の名前から道具の名前を作り、
1059
+ // 番人に「danger で止めたあと」の状態で、呼び出しと ToolSearch の読み込みを当てる。
1060
+ // ★通る名前の決まりは番人(cc2_guard.py の CONDUCTOR_TOOL_PREFIXES)が正本=ここでは写さない。
1061
+ // 通らなければ fault で落とす=管制の「PCの状態」の落ちた項目に出る(便を出す前に分かる)。
1062
+ /** 完了の知らせの道具(管制の道具の名前の後ろ)。 */
1063
+ const COMPLETE_TOOL = 'conductor_complete';
1064
+ /** 登録の一覧が無い回に確かめる、ai-kana の登録の名前(MCP として入れた形/claude.ai のコネクタの形)。 */
1065
+ export const AI_KANA_SERVER_NAMES = ['ai-kana', 'claude.ai ai-kana'];
1066
+ /** MCP の登録の名前から、職人に見える道具の名前を作る(★Claude Code は英数字・`_`・`-` 以外を `_` にする)。 */
1067
+ export function mcpToolName(server, tool) {
1068
+ return `mcp__${server.replace(/[^A-Za-z0-9_-]/g, '_')}__${tool}`;
1069
+ }
1070
+ /**
1071
+ * 確かめる完了の知らせの道具の名前。つながっている ai-kana の登録があれば、その名前(=この機体で職人に見える物)。
1072
+ * 無い・一覧が無い回は、在り得る2通り(AI_KANA_SERVER_NAMES)。
1073
+ */
1074
+ export function completeToolNames(list) {
1075
+ const connected = (list ?? []).filter((s) => /ai-kana/i.test(s.name) && s.status === 'connected').map((s) => s.name);
1076
+ const servers = connected.length > 0 ? connected : [...AI_KANA_SERVER_NAMES];
1077
+ return [...new Set(servers.map((s) => mcpToolName(s, COMPLETE_TOOL)))];
1078
+ }
1079
+ /** +番人:danger で止めたあとでも、この機体の完了の知らせ(呼び出し・読み込み)を通すか。 */
1080
+ export function checkCompleteToolGuard(d, item, work, list) {
1081
+ const guard = guardPath(d);
1082
+ if (!existsSync(guard))
1083
+ return; // 番人が無いことは checkGuard が落としている
1084
+ const env = { ...d.env, PYTHONDONTWRITEBYTECODE: '1' };
1085
+ const names = completeToolNames(list);
1086
+ const [session] = guardProbeSessionIds(d, 1);
1087
+ const ev = (tool_name, tool_input) => ({ hook_event_name: 'PreToolUse', tool_name, tool_input, cwd: work, session_id: session });
1088
+ // ① danger で止めて印を置かせる → ② 印が効いている(ふつうの一覧が止まる)→ ③ 名前ごとに呼び出しと読み込み
1089
+ const probes = [ev('Bash', { command: 'rm -rf ~/.tyhld/hooks' }), ev('Bash', { command: 'ls' })];
1090
+ const first = askGuard(d, guard, probes[0], env);
1091
+ const latched = askGuard(d, guard, probes[1], env) === 'deny';
1092
+ if (first !== 'deny' || !latched) {
1093
+ note(item, `完了の知らせの確かめ: danger のあとの状態を作れませんでした(${first}/印 ${latched ? 'あり' : 'なし'})`);
1094
+ }
1095
+ else {
1096
+ for (const name of names) {
1097
+ const call = ev(name, { commandId: 'selfcheck' });
1098
+ const load = ev('ToolSearch', { query: `select:${name}`, max_results: 1 });
1099
+ probes.push(call, load);
1100
+ const got = [askGuard(d, guard, call, env), askGuard(d, guard, load, env)];
1101
+ if (got.every((g) => g !== 'deny'))
1102
+ pass(item, `danger のあとも完了の知らせ ${name}(呼び出し・読み込み)を通します`);
1103
+ else
1104
+ fail(item, 'fault', `danger のあとに完了の知らせ ${name} を番人が通しません(呼び出し ${got[0]}・読み込み ${got[1]})=この機体の職人は止まった便を完了にできません`);
1105
+ }
1106
+ }
1107
+ // ★自分が置かせた印を自分で片付ける(checkGuard と同じ・この回の session_id の分だけ)。
1108
+ const cleared = d.exec('python3', ['-c', DANGER_STOP_CLEAR, guard], { input: JSON.stringify(probes), env, timeoutMs: 30_000 });
1109
+ if (cleared.status !== 0)
1110
+ note(item, `完了の知らせの確かめが置いた印を片付けられませんでした(終了 ${cleared.status}・12時間で自然に無効になります)`);
1111
+ }
1040
1112
  /** +番人:入っている番人に、止めるべき物と通すべき物を1つずつ判定させる。 */
1041
1113
  export function checkGuard(d, work) {
1042
1114
  const item = { key: 'guard', label: '番人', ok: null, detail: [] };
1043
- const guard = path.join(d.home, '.tyhld', 'hooks', 'cc2_guard.py');
1115
+ const guard = guardPath(d);
1044
1116
  const resync = 'APPLY=1 bash "$(npm root -g)/@tyhld/conductor/scripts/update-guard.sh"';
1045
1117
  if (!existsSync(guard)) {
1046
1118
  fail(item, 'human', `番人が入っていません(${guard})`, { machine: d.machine, what: 'Ubuntu で番人を配り直す', command: resync });
@@ -1062,14 +1134,7 @@ export function checkGuard(d, work) {
1062
1134
  session_id: sessions[i],
1063
1135
  }));
1064
1136
  for (const [i, c] of cases.entries()) {
1065
- const r = d.exec('python3', [guard], { input: JSON.stringify(probes[i]), env, timeoutMs: 30_000 });
1066
- let got = 'none';
1067
- try {
1068
- got = JSON.parse(r.stdout).hookSpecificOutput?.permissionDecision ?? 'none';
1069
- }
1070
- catch {
1071
- // 何も返さない=委譲(allow ではない)
1072
- }
1137
+ const got = askGuard(d, guard, probes[i], env);
1073
1138
  const ok = c.want === 'deny' ? got === 'deny' : got === 'allow' || got === 'none';
1074
1139
  if (ok)
1075
1140
  pass(item, `${c.label} → ${got}`);
@@ -1794,6 +1859,8 @@ export async function runSelfcheck(d, trigger, opts = {}) {
1794
1859
  note(headless, 'お客さまの機の定期の確かめでは Claude を呼びません(版を入れ替えた直後の1回だけ流します・使用量の上限)');
1795
1860
  note(sandbox, '囲いの中からの書き込みは、Claude を呼ぶ回(版を入れ替えた直後)にだけ確かめます');
1796
1861
  note(network, '囲いの内側からの通信は、Claude を呼ぶ回(版を入れ替えた直後)にだけ確かめます');
1862
+ // +完了の知らせを番人が通すか(★MCP の一覧を見ない回なので、在り得る2通りの名前で・便 12526bb8)
1863
+ checkCompleteToolGuard(d, guard, path.join(runDir, 'work'), null);
1797
1864
  const items = [conductor, claude.item, central, sandbox, network, headless, guard, managed, unsafe, units, siteGuard, accounts];
1798
1865
  return {
1799
1866
  schema: 'conductor-selfcheck/1',
@@ -1880,6 +1947,8 @@ export async function runSelfcheck(d, trigger, opts = {}) {
1880
1947
  fail(central, 'fault', `ai-kana の MCP につながりません(failed・${seen})`);
1881
1948
  else
1882
1949
  note(central, 'MCP の状態を読めませんでした(小さな試験の最初の行が無い)');
1950
+ // +完了の知らせを番人が通すか(★この機体でつながっている登録の名前で=職人に見える名前・便 12526bb8)
1951
+ checkCompleteToolGuard(d, guard, path.join(runDir, 'work'), mcp.list);
1883
1952
  // ④ 書き込み
1884
1953
  if (h.outsideWrite === 'blocked')
1885
1954
  pass(sandbox, '囲いの中から作業場所の外への書き込みが止まりました');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.168",
3
+ "version": "0.12.170",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -611,7 +611,13 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
611
611
  | ① | 報告の置き場の中のファイルへの `Write`/`Edit`/`MultiEdit`/`NotebookEdit` | 報告を書く・直す |
612
612
  | ② | 報告の置き場の中のファイルの `Read`/`NotebookRead` | `Edit` は先に読む必要がある |
613
613
  | ③ | `mkdir -p <報告の置き場の中>` の1コマンドだけ(Bash) | 置き場のフォルダを作る |
614
- | ④ | 道具の名前が `conductor_complete` で終わる物 | 完了の知らせ |
614
+ | ④ | 管制の完了の知らせ `mcp__ai-kana__conductor_complete`/`mcp__claude_ai_ai-kana__conductor_complete` とちょうど同じ名前の道具と、それだけを名指しする ToolSearch の読み込み(`select:<その名前>[,<その名前>]`) | 完了の知らせ |
615
+
616
+ ★④の名前は機体ごとに2通りあります(Claude Code に MCP として入れた機体は `mcp__ai-kana__`、claude.ai の
617
+ コネクタだけの機体は `mcp__claude_ai_ai-kana__`・実地 便 ba854574)。正本は `cc2_guard.py` の
618
+ `CONDUCTOR_TOOL_PREFIXES` の1か所です。ほかのコネクタの同じ名前(`mcp__other__conductor_complete`)・前後に
619
+ 文字が付いた名前・ほかの道具が混ざった読み込みは通しません(便 12526bb8)。自己診断の番人の項目が、
620
+ その機体で職人に見える名前のまま番人が通すかを確かめます(通らなければ fault で落ちる)。
615
621
 
616
622
  ★報告の置き場の決め方は **`finish_gate.report_dirs` が正本**です(字面を2か所に置きません)。
617
623
  ★`build_output`(判定だけ)は1文字も変えていません。足したのは `guard_output` の1層だけで、
@@ -302,7 +302,8 @@ def build_output(data, datalink=hook_datalink, codex=False):
302
302
  # ① 報告の置き場の中のファイルへの Write / Edit / MultiEdit(=報告を書く・直す)
303
303
  # ② 報告の置き場の中のファイルの Read(Edit は先に読む必要があるため)
304
304
  # ③ 報告の置き場のフォルダを作る Bash(`mkdir -p <報告の置き場…>` の1コマンドだけ)
305
- # ④ 完了の知らせ(道具の名前が `conductor_complete` で終わる物)
305
+ # ④ 完了の知らせ(管制の道具の名前の決まり=CONDUCTOR_TOOL_PREFIXES の2通りの頭+`conductor_complete`
306
+ # とちょうど同じ物だけ・ほかのコネクタの同じ名前は通さない=便 12526bb8)と、その読み込みの ToolSearch
306
307
  # ★報告の置き場の決め方は finish_gate.report_dirs が正本(字面を2か所に置かない)。
307
308
  #
308
309
  # 【効かない範囲】ほかの便・ほかの現場・別のセッションには効かない(印の名前が変わる)。
@@ -317,8 +318,47 @@ _REPORT_READ_TOOLS = frozenset({'Read', 'NotebookRead'})
317
318
  #: 報告の置き場を作る形で許す道具(これ以外の Bash は通さない)。
318
319
  _REPORT_MKDIR = 'mkdir'
319
320
  _REPORT_MKDIR_FLAGS = frozenset({'-p', '--parents', '-pv', '-v', '--verbose'})
320
- #: 完了の知らせの道具を読み込む ToolSearch の query(これちょうどのときだけ通す)。
321
- _COMPLETE_TOOL_SELECT = 'select:mcp__ai-kana__conductor_complete'
321
+ # ── 管制(ai-kana)の道具の名前の決まり(★正本はここ1か所・便 12526bb8) ──
322
+ # 【なぜ2通りか(実地 便 ba854574・TYHLD-GOTO)】ai-kana の道具は、機体によって名前の頭が違う。
323
+ # Claude Code に MCP として入れた機体(えふさん・太田さん)は `mcp__ai-kana__<道具>`、
324
+ # claude.ai のコネクタだけの機体(後藤さん)は `mcp__claude_ai_ai-kana__<道具>`。
325
+ # 前は ToolSearch の読み込みを `mcp__ai-kana__` の形だけで通していたので、コネクタだけの機体では
326
+ # danger の後に完了の知らせを読み込めず、便を報告で終えられなかった。
327
+ # ★通すのは下の頭+決められた道具の名前と【ちょうど同じ】物だけ。ほかのコネクタの同じ名前の道具
328
+ # (`mcp__other__conductor_complete`)や、前後に文字が付いた名前は通さない。
329
+ #: 管制の道具の名前の頭(MCP として入れた形/claude.ai のコネクタから来た形)。
330
+ CONDUCTOR_TOOL_PREFIXES = ('mcp__ai-kana__', 'mcp__claude_ai_ai-kana__')
331
+ #: danger のあとでも通す管制の道具(これだけ)。
332
+ _AFTER_DANGER_CONDUCTOR_TOOLS = ('conductor_complete',)
333
+ #: ToolSearch で道具を名指しして読み込む query の頭。
334
+ _SELECT_PREFIX = 'select:'
335
+
336
+
337
+ def conductor_tool_names(tools=_AFTER_DANGER_CONDUCTOR_TOOLS):
338
+ """管制の道具の、機体ごとに在り得る名前をすべて返す(頭2通り × 道具)。"""
339
+ return tuple(p + t for t in tools for p in CONDUCTOR_TOOL_PREFIXES)
340
+
341
+
342
+ def is_conductor_tool(name, tools=_AFTER_DANGER_CONDUCTOR_TOOLS):
343
+ """その名前が、決められた管制の道具の名前と【ちょうど同じ】なら True。"""
344
+ return isinstance(name, str) and name in conductor_tool_names(tools)
345
+
346
+
347
+ def is_conductor_tool_select(query, tools=_AFTER_DANGER_CONDUCTOR_TOOLS):
348
+ """ToolSearch の query が、決められた管制の道具【だけ】を名指しで読み込む形なら True。
349
+
350
+ `select:<名前>[,<名前>…]` の名前がすべて管制の決められた道具のときだけ通す
351
+ (1つでもほかの道具が混ざれば通さない=ほかの道具の読み込みは今までどおり止める)。
352
+ """
353
+ q = str(query or '')
354
+ if not q.startswith(_SELECT_PREFIX):
355
+ return False
356
+ names = [n.strip() for n in q[len(_SELECT_PREFIX):].split(',')]
357
+ return bool(names) and all(is_conductor_tool(n, tools) for n in names)
358
+
359
+
360
+ #: 止めたときの文に出す読み込みの形(機体ごとに名前が違うので2通りとも出す)。
361
+ _COMPLETE_TOOL_SELECTS = tuple(_SELECT_PREFIX + n for n in conductor_tool_names())
322
362
 
323
363
 
324
364
  def _report_store_dirs(env=None):
@@ -379,13 +419,14 @@ def after_danger_allowed(data, env=None):
379
419
  tin = data.get('tool_input')
380
420
  if not isinstance(tin, dict):
381
421
  tin = {}
382
- if tool.rsplit('__', 1)[-1] == 'conductor_complete':
422
+ # ★管制の完了の知らせ(名前は機体ごとに2通り・ちょうど同じ物だけ=便 12526bb8)。
423
+ if is_conductor_tool(tool):
383
424
  return True
384
425
  # ★完了の知らせの道具を読み込むだけの ToolSearch(便 e338e926・実地 便 0d887e4e・11265a0a・4cde5905)。
385
426
  # 読み込まないと conductor_complete を呼べず、止まった便を報告で終えられない。
386
- # query がこの1つちょうどのときだけ通す(ほかの道具の読み込みは今までどおり止める)。
427
+ # query が管制の完了の知らせだけを名指しするときだけ通す(ほかの道具の読み込みは今までどおり止める)。
387
428
  if tool == 'ToolSearch':
388
- return str(tin.get('query') or '') == _COMPLETE_TOOL_SELECT
429
+ return is_conductor_tool_select(tin.get('query'))
389
430
  if tool in _REPORT_WRITE_TOOLS or tool in _REPORT_READ_TOOLS:
390
431
  return inside_report_store(tin.get('file_path') or tin.get('notebook_path') or '', env)
391
432
  if tool == 'Bash':
@@ -416,7 +457,7 @@ def danger_stop_reason(key, base, env=None):
416
457
  '止められた命令の全文と番人の文を報告して停止してください(鉄則4・鉄則の常連 ⑤-2)。'
417
458
  'いま通すのは、報告の置き場の中のファイルを書く・直す・読む/その置き場を作る mkdir -p/'
418
459
  '完了の知らせ(conductor_complete と、その読み込み=ToolSearch の '
419
- f'{_COMPLETE_TOOL_SELECT})だけです。'
460
+ f'{" または ".join(_COMPLETE_TOOL_SELECTS)})だけです。'
420
461
  f'★誤って止まったときは、人が自分のターミナルで印を消します: rm -r {marker}'
421
462
  f'{base_reason}'
422
463
  )
@@ -0,0 +1,216 @@
1
+ #!/usr/bin/env python3
2
+ """番人の直し(便 12526bb8)の検査: 管制(ai-kana)の道具の名前が機体ごとに2通りあっても、
3
+ danger のあとに完了の知らせ・その読み込みを通す。
4
+
5
+ 実行: python3 scripts/hooks/test_guard_conductor_tool_names.py
6
+ 1件でも期待と違えば exit 1。
7
+
8
+ 【なぜ要るか(実地 便 ba854574・TYHLD-GOTO・現場 kenzokun)】
9
+ claude.ai のコネクタだけの機体では、管制の道具は `mcp__claude_ai_ai-kana__<道具>` の名前になる。
10
+ 番人が danger のあとに通す読み込みは `select:mcp__ai-kana__conductor_complete` ちょうどだけだったので、
11
+ ・select:mcp__claude_ai_ai-kana__conductor_complete … danger で止められた
12
+ ・select:mcp__ai-kana__conductor_complete … その機体には無い名前(No matching deferred tools found)
13
+ となり、職人が完了の知らせを管制へ送れなかった。
14
+
15
+ 【ここで固定すること】
16
+ (n) 名前の決まり … 2通りの頭+決められた道具とちょうど同じ名前だけが管制の道具。
17
+ ほかのコネクタの同じ名前・前後に文字が付いた名前・ほかの管制の道具は当たらない。
18
+ (a) danger のあと … 2通りとも完了の知らせ・その読み込み(両方を1回で名指しする形も)が通る。
19
+ ほかのコネクタの同じ名前・似た名前・ほかの道具が混ざった読み込みは止まる。
20
+ (s) 秘密の守りは今までどおり … danger の前でも後でも、秘密の値を見る命令は止まる。
21
+ (b) danger の前 … 2通りとも完了の知らせは止めない(今までどおり)。
22
+ (v) ★空振り確認 … コネクタの形の頭を外すと、コネクタの名前の読み込み・呼び出しが止まる。
23
+
24
+ ★本物のホーム・本物の秘密には1バイトも触れない。作り物の置き場で判定する。
25
+ """
26
+ import json
27
+ import os
28
+ import shutil
29
+ import sys
30
+ import tempfile
31
+
32
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
33
+
34
+ failures = []
35
+
36
+
37
+ def check(label, got, want):
38
+ ok = got == want
39
+ if not ok:
40
+ failures.append(f'{label}: got={got!r} want={want!r}')
41
+ print(f'{"OK " if ok else "NG "} {label:72} {str(got)[:40]}')
42
+
43
+
44
+ def truthy(label, got):
45
+ check(label, bool(got), True)
46
+
47
+
48
+ # ─────────────────────────────────────────────────────────────────────────────
49
+ # 作り物の置き場(★本物のホーム・本物の秘密には触れない)
50
+ # ─────────────────────────────────────────────────────────────────────────────
51
+ ROOT = tempfile.mkdtemp(prefix='guard-12526bb8-',
52
+ dir='/tmp/claude-1000' if os.path.isdir('/tmp/claude-1000') else None)
53
+ HOME = os.path.join(ROOT, 'home', 'tester')
54
+ STATE = os.path.join(ROOT, 'state')
55
+ WORK = os.path.join(HOME, 'projects', 'demo')
56
+ SITE = 'demo'
57
+ JOB = '12526bb8-6ba1-49ff-aec7-119b687ed026'
58
+ SESSION = 'se-12526bb8'
59
+
60
+
61
+ def mk(path, body=''):
62
+ os.makedirs(os.path.dirname(path), exist_ok=True)
63
+ with open(path, 'w', encoding='utf-8') as f:
64
+ f.write(body)
65
+ return path
66
+
67
+
68
+ os.makedirs(os.path.join(WORK, '.git'), exist_ok=True)
69
+ mk(os.path.join(WORK, 'src', 'a.ts'), 'export const a = 1\n')
70
+ os.environ['HOME'] = HOME
71
+ os.environ['TMPDIR'] = ROOT
72
+ os.environ['XDG_STATE_HOME'] = STATE
73
+ os.environ['CONDUCTOR_SITE'] = SITE
74
+ os.environ['CONDUCTOR_GUARD_LOG'] = os.path.join(ROOT, 'guard.log')
75
+ os.environ.pop('CONDUCTOR_REPORT_DIR', None)
76
+ os.environ.pop('CONDUCTOR_URL', None)
77
+ os.environ.pop('CONDUCTOR_TOKEN', None)
78
+ mk(os.path.join(STATE, 'conductor', f'active-job-{SITE}.json'),
79
+ json.dumps({'commandId': JOB, 'site': SITE, 'body': 'x'}))
80
+
81
+ import cc2_guard # noqa: E402
82
+ import hook_datalink # noqa: E402
83
+
84
+ MCP = 'mcp__ai-kana__conductor_complete' # Claude Code に MCP として入れた機体
85
+ CONNECTOR = 'mcp__claude_ai_ai-kana__conductor_complete' # claude.ai のコネクタだけの機体
86
+ LOOK_ALIKES = [
87
+ ('ほかのコネクタの同じ名前', 'mcp__claude_ai_Other__conductor_complete'),
88
+ ('ほかの MCP の同じ名前', 'mcp__evil__conductor_complete'),
89
+ ('頭に余計な文字', 'xmcp__ai-kana__conductor_complete'),
90
+ ('頭に余計な文字(コネクタ)', 'mcp__claude_ai_ai-kana-x__conductor_complete'),
91
+ ('後ろに余計な文字', 'mcp__ai-kana__conductor_complete2'),
92
+ ('後ろに余計な文字(コネクタ)', 'mcp__claude_ai_ai-kana__conductor_complete_x'),
93
+ ('前後に空白', ' mcp__ai-kana__conductor_complete '),
94
+ ('大文字に変えた', 'mcp__claude_ai_AI-KANA__conductor_complete'),
95
+ ('頭だけ', 'mcp__claude_ai_ai-kana__'),
96
+ ('ほかの管制の道具(返事)', 'mcp__claude_ai_ai-kana__conductor_reply'),
97
+ ('ほかの管制の道具(本番操作)', 'mcp__ai-kana__conductor_prod_op_request'),
98
+ ]
99
+
100
+ # ─────────────────────────────────────────────────────────────────────────────
101
+ # (n) 名前の決まり
102
+ # ─────────────────────────────────────────────────────────────────────────────
103
+ print('── (n) 名前の決まり ' + '─' * 50)
104
+ check('n1 在り得る名前は2通りだけ', sorted(cc2_guard.conductor_tool_names()), sorted([MCP, CONNECTOR]))
105
+ truthy('n2 MCP として入れた形は管制の道具', cc2_guard.is_conductor_tool(MCP))
106
+ truthy('n3 コネクタから来た形は管制の道具', cc2_guard.is_conductor_tool(CONNECTOR))
107
+ for label, name in LOOK_ALIKES:
108
+ check(f'n4 {label} は当たらない', cc2_guard.is_conductor_tool(name), False)
109
+ check('n5 名前でない物は当たらない', cc2_guard.is_conductor_tool(None), False)
110
+
111
+ # ─────────────────────────────────────────────────────────────────────────────
112
+ # (a) danger のあと
113
+ # ─────────────────────────────────────────────────────────────────────────────
114
+ print('── (a) danger のあと ' + '─' * 49)
115
+ KEY = (SESSION, SITE, JOB)
116
+
117
+
118
+ def ev(tool, tin, session=SESSION, cwd=WORK):
119
+ return {'tool_name': tool, 'tool_input': tin, 'cwd': cwd, 'session_id': session}
120
+
121
+
122
+ def run(data):
123
+ out = cc2_guard.guard_output(data)
124
+ if not out:
125
+ return 'defer', ''
126
+ spec = out['hookSpecificOutput']
127
+ return spec['permissionDecision'], spec.get('permissionDecisionReason', '')
128
+
129
+
130
+ def load(query):
131
+ return ev('ToolSearch', {'query': query, 'max_results': 2})
132
+
133
+
134
+ hook_datalink.clear_danger_stop(*KEY)
135
+ # ★便 ba854574 で正しく止められた形(秘密の値の有無を調べる)で danger にする。
136
+ dec, _ = run(ev('Bash', {'command': 'printenv NPM_TOKEN'}))
137
+ check('a0 秘密の名前を調べる命令は止まる(今までどおり)', dec, 'deny')
138
+ truthy('a0 印が置かれた', hook_datalink.danger_stop_active(*KEY))
139
+
140
+ A_PASS = [
141
+ ('a1 完了の知らせ(MCP の形)', ev(MCP, {'commandId': JOB})),
142
+ ('a2 完了の知らせ(コネクタの形)', ev(CONNECTOR, {'commandId': JOB})),
143
+ ('a3 読み込み(MCP の形)', load(f'select:{MCP}')),
144
+ ('a4 読み込み(コネクタの形)', load(f'select:{CONNECTOR}')),
145
+ ('a5 読み込み(両方を1回で名指し)', load(f'select:{MCP},{CONNECTOR}')),
146
+ ('a6 読み込み(両方・区切りに空白)', load(f'select:{CONNECTOR}, {MCP}')),
147
+ ]
148
+ for label, data in A_PASS:
149
+ truthy(label + ' は通る', run(data)[0] != 'deny')
150
+
151
+ A_DENY = [(f'a10 {label}(呼び出し)', ev(name.strip() if label == '前後に空白' else name,
152
+ {'commandId': JOB}))
153
+ for label, name in LOOK_ALIKES if label != '前後に空白']
154
+ A_DENY += [(f'a11 {label}(読み込み)', load(f'select:{name}')) for label, name in LOOK_ALIKES
155
+ if name.strip() not in (MCP, CONNECTOR)]
156
+ A_DENY += [
157
+ ('a12 コネクタの形にほかの道具を混ぜた読み込み', load(f'select:{CONNECTOR},WebFetch')),
158
+ ('a13 ほかのコネクタの道具を混ぜた読み込み',
159
+ load(f'select:{MCP},mcp__claude_ai_Supabase__execute_sql')),
160
+ ('a14 空の名指しを混ぜた読み込み', load(f'select:{CONNECTOR},')),
161
+ ('a15 名指しが空', load('select:')),
162
+ ('a16 select の前に文字', load(f'xselect:{CONNECTOR}')),
163
+ ('a17 言葉で探す読み込み(コネクタの名前)', load(CONNECTOR)),
164
+ ('a18 ほかの道具', ev('Bash', {'command': 'ls'})),
165
+ ]
166
+ for label, data in A_DENY:
167
+ check(label + ' は止まる', run(data)[0], 'deny')
168
+
169
+ why = run(ev('Bash', {'command': 'ls'}))[1]
170
+ truthy('a19 止めた文に、コネクタの形の読み込みも書いてある', f'select:{CONNECTOR}' in why)
171
+ truthy('a19 止めた文に、MCP の形の読み込みも書いてある', f'select:{MCP}' in why)
172
+
173
+ # ─────────────────────────────────────────────────────────────────────────────
174
+ # (s) 秘密の守りは今までどおり
175
+ # ─────────────────────────────────────────────────────────────────────────────
176
+ print('── (s) 秘密の守り ' + '─' * 52)
177
+ check('s1 danger のあとも秘密の名前を調べる命令は止まる',
178
+ run(ev('Bash', {'command': 'printenv NPM_TOKEN'}))[0], 'deny')
179
+ hook_datalink.clear_danger_stop(*KEY)
180
+ OTHER = 'se-12526bb8-before'
181
+ check('s2 danger の前でも秘密の名前を調べる命令は止まる',
182
+ run(ev('Bash', {'command': 'printenv NPM_TOKEN'}, session=OTHER))[0], 'deny')
183
+ hook_datalink.clear_danger_stop(OTHER, SITE, JOB)
184
+
185
+ # ─────────────────────────────────────────────────────────────────────────────
186
+ # (b) danger の前は今までどおり
187
+ # ─────────────────────────────────────────────────────────────────────────────
188
+ print('── (b) danger の前 ' + '─' * 51)
189
+ FRESH = 'se-12526bb8-fresh'
190
+ for name in (MCP, CONNECTOR):
191
+ truthy(f'b1 {name} は止めない', run(ev(name, {'commandId': JOB}, session=FRESH))[0] != 'deny')
192
+ truthy('b2 印は置かれていない', not hook_datalink.danger_stop_active(FRESH, SITE, JOB))
193
+
194
+ # ─────────────────────────────────────────────────────────────────────────────
195
+ # (v) ★空振り確認 … コネクタの形の頭を外すと、コネクタの名前が止まる(便 ba854574 の形に戻る)
196
+ # ─────────────────────────────────────────────────────────────────────────────
197
+ print('── (v) 空振り確認 ' + '─' * 52)
198
+ run(ev('Bash', {'command': 'printenv NPM_TOKEN'}))
199
+ saved = cc2_guard.CONDUCTOR_TOOL_PREFIXES
200
+ cc2_guard.CONDUCTOR_TOOL_PREFIXES = ('mcp__ai-kana__',)
201
+ check('v1 頭を外すとコネクタの形の読み込みが止まる', run(load(f'select:{CONNECTOR}'))[0], 'deny')
202
+ check('v2 頭を外すとコネクタの形の呼び出しが止まる', run(ev(CONNECTOR, {'commandId': JOB}))[0], 'deny')
203
+ cc2_guard.CONDUCTOR_TOOL_PREFIXES = saved
204
+ truthy('v3 戻すと読み込みが通る', run(load(f'select:{CONNECTOR}'))[0] != 'deny')
205
+ truthy('v3 戻すと呼び出しが通る', run(ev(CONNECTOR, {'commandId': JOB}))[0] != 'deny')
206
+
207
+ hook_datalink.clear_danger_stop(*KEY)
208
+ shutil.rmtree(ROOT, ignore_errors=True) # ★作り物は毎回片付ける
209
+
210
+ print()
211
+ if failures:
212
+ print(f'NG {len(failures)} 件')
213
+ for f in failures:
214
+ print(' ', f)
215
+ sys.exit(1)
216
+ print('すべて期待どおり')
@@ -19,7 +19,8 @@ danger のあとの完了の知らせの読み込み。
19
19
  (g) `*`・変数 … 展開して当たった物を今の判定に当てる。秘密に当たれば止まる。
20
20
  当たり0件・名前が決まらない変数は、今までどおり作業場所に倒して止まる。
21
21
  (d) danger のあと … ToolSearch の query が select:mcp__ai-kana__conductor_complete ちょうどの
22
- ときだけ通る。ほかの道具の読み込みは止まる。
22
+ ときだけ通る。ほかの道具の読み込みは止まる(★コネクタの名前の形は
23
+ test_guard_conductor_tool_names.py=便 12526bb8)。
23
24
  (v) ★空振り確認 … 直した所を外すと、上の期待が実際に崩れる。
24
25
 
25
26
  ★本物のホーム・本物の秘密には1バイトも触れない。作り物の置き場で判定する。
@@ -245,10 +246,10 @@ check('v2 展開を外すと `*` の検索が作業場所に倒れて止まる'
245
246
  policy._expand_read_arg = saved_ex
246
247
  check('v2 戻すと通る', decide(G_ALLOW[0][1]), policy.ALLOW)
247
248
 
248
- saved_sel = cc2_guard._COMPLETE_TOOL_SELECT
249
- cc2_guard._COMPLETE_TOOL_SELECT = '(外した)'
249
+ saved_sel = cc2_guard.CONDUCTOR_TOOL_PREFIXES
250
+ cc2_guard.CONDUCTOR_TOOL_PREFIXES = ('(外した)',)
250
251
  check('v3 一覧から外すと完了の知らせの読み込みが止まる', run(COMPLETE_LOAD)[0], 'deny')
251
- cc2_guard._COMPLETE_TOOL_SELECT = saved_sel
252
+ cc2_guard.CONDUCTOR_TOOL_PREFIXES = saved_sel
252
253
  truthy('v3 戻すと通る', run(COMPLETE_LOAD)[0] != 'deny')
253
254
 
254
255
  hook_datalink.clear_danger_stop(*KEY)
@@ -30,7 +30,11 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
30
30
  3. **持ち場の外に出ない** — 指示された作業ディレクトリの外を変更しない。
31
31
  4. **壁に当たったら止まる** — サンドボックス制約・保護されたパスに当たったら回避せず中断して報告する(★通信で塞がれたときの読み方は鉄則12)。
32
32
  5. **エージェント設定に書き込まない** — `.mcp.json`、`.claude/` 配下、hooks 等のエージェント設定パスには書き込まない。
33
- 6. **本番に触らない** — 本番DB・deploy・secret に触らない。SQL/DDL は作って提示のみ(適用は人間)。
33
+ 6. **本番に触らない** — 本番DB・deploy・secret に触らない。SQL/DDL は作って提示のみ(貼るのは人)。
34
+ - ★**SQL の適用を待って止まらない**(えふさん決定 2026-11-02)。DB の形を変えるときは **expand → code → contract** の順で進める:足すだけの SQL を先に作って提示する → コードは足した物がまだ本番に無くても落ちない作りにする → **PR を合流まで進める**。SQL は人が都合のよい時に貼る。消す・変える SQL(contract)は、足した物を使うコードが合流した後の別の便で出す。
35
+ - ★本番操作窓口(`prod_op`)は**使うと決めた操作だけに掛かる任意の道具**。便の本文が窓口を使うと言っていない限り、SQL の適用待ちで合流を止めない・手番を閉じない(便の終え方⑤は窓口を使う操作のときだけ)。
36
+ - ★お客さまの現場の本番の扱い(鍵の持ち方・承認の有無)は、お客さまが決める(当社の決まりを押しつけない)。
37
+ - 正本:TYHLD-platform の `docs/06-standards/claude-code-operations.md` §1.1・§2.8・§11.7 と ADR-082 の改訂(2026-11-02)の節。
34
38
  7. **便の終点はマージまで(★保護を迂回しない)** — push → PR作成 → 合流する。★push は**上流の設定を書かない形**で打つ(⓪)。★合流の仕方は、そのリポの合流先に**保護(必須の検査)**があるかで分ける。リポの名前は覚えなくてよい。
35
39
  - ⓪ **上流の設定を書かない形で push する**=`git push origin <作業ブランチ名>`。★`-u`(`--set-upstream`)を付けない。`-u` と `git checkout -b <枝> origin/main` は `.git/config` へ書き込むので、囲いがその書き込みを塞いでいるPCでは「上流の設定を書けない」で止まる(**push 自体は成功している**ので、打ち直すと食い違って見える=実測 便 2cb1adf6・ef8def38)。枝を切るときも同じで `git switch -c <枝> --no-track origin/main`(または `git branch --no-track <枝> origin/main` のあと `git switch <枝>`)。★これは回避の近道ではなく**どのPCでも同じに通る形**なので、塞がれていないPCでもこの形で打つ(上流の設定は職人の作業に要らない)。★切る元は `git fetch origin` のあとの**最新の `origin/main`**(手元の `main` ではない)。手元で切り替えられないときは `git worktree add -b <枝> --no-track /tmp/claude-1000/<便IDを入れた名前> origin/main` の別の作業場所で作業し、終わったら `git worktree remove` で片付ける(鉄則1)。
36
40
  - ① **保護があるかを読む。** 合流先は `gh pr view <番号> --json baseRefName -q .baseRefName`(ふつうは main)。`gh api 'repos/{owner}/{repo}/branches/<合流先>/protection/required_status_checks' --jq '.contexts | length'` が **1 以上の数を返したときだけ「保護あり」**。0・404(Branch not protected)・403・その他の失敗は、すべて**「保護なし」**として扱う。
@@ -313,7 +317,8 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
313
317
  - **blocked のときも必ず conductor_complete を呼び、report に理由を書く。**
314
318
  - ブランチを切らない**読み取り専用の作業では outcome=no_change** を渡す(branch は省略可)。
315
319
  ⑤ **★本番操作の承認を待って「待ち」のまま閉じる手番だけは、`DONE:` の行を出さない**(えふさん確定 2026-10-04 の 3・便 97f99a17)。
316
- - **どんな手番か** … 本番操作(本番の反映など)の承認が長引き、便をいったん「待ち」にして手番を閉じるとき。④を `waitForProdOp:true`(分かれば `prodOpRequestId` も)で呼ぶ。便は `done` にならず**本番操作の承認待ち**のまま閉じ、返事に `waitClosed: true` と `doneLineForbidden: true` が返る。
320
+ - ★**これは本番操作窓口(`prod_op`)を使うと決めた操作のときだけの終え方**(えふさん決定 2026-11-02)。窓口は任意の道具で、便の本文が窓口を使うと言っていない便では使わない。**SQL の適用を待って手番を閉じない**:SQL は作って提示し、expand → code → contract で合流まで進めて ⓪〜④ のとおりに終える(鉄則6)。
321
+ - **どんな手番か** … 窓口に出した本番操作(本番の反映など)の承認が長引き、便をいったん「待ち」にして手番を閉じるとき。④を `waitForProdOp:true`(分かれば `prodOpRequestId` も)で呼ぶ。便は `done` にならず**本番操作の承認待ち**のまま閉じ、返事に `waitClosed: true` と `doneLineForbidden: true` が返る。
317
322
  - **この手番ですること** … ①②のとおり**報告ファイルは置いてよい**(報告ファイルだけでは便は完了にならない)。④は `waitForProdOp:true` で呼ぶ。★**③の `DONE:<現場>` の行は出さない。**
318
323
  - **なぜ出さないか** … `DONE:` を出すと配り役の完了検出がこの便を完了(終端)にしてしまい、本番操作が済んでも**続きから起こせなくなる**(「終端は起こさない」は正しい決まりなので緩めない)。
319
324
  - **そのあと** … 本番操作が済むと、管制の**合図で同じ便の続きから起きる**。続きを行い、**本当に終わったときに ⓪〜④ のとおり(`DONE:<現場>` も出して)終える**。★却下・失敗・時間切れでは起きない(理由つきで人の手番で止まる)。