@tyhld/conductor 0.12.120 → 0.12.122

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.
@@ -0,0 +1,269 @@
1
+ /**
2
+ * 管理者の設定(/etc の管理設定)の状態を【読むだけ】で集める(便 662d7c03)。
3
+ *
4
+ * 【何のためか】自己診断(src/selfcheck.ts の ⑦「管理者の設定」)が、各PCの管理者の設定の状態を
5
+ * 管制の「PCの状態」へ届けるために使う。守りを管理者の層へ移すかどうかを決める前に、
6
+ * 4台(Fshima・FshimaNP・TYHLD-GOTO・TYHLD-OTA)がいまどうなっているかを機械で見えるようにする
7
+ * (便 6cc9959f の第3節=自己診断に管理者の設定を見る項目が1つも無く「分からない」だった)。
8
+ *
9
+ * 【★ここは事実を集めるだけ】合否の決め方と、人が読む文は src/selfcheck.ts の checkManaged に置く
10
+ * (この1か所に判定と言葉を混ぜない)。
11
+ *
12
+ * 【★書かない・値を出さない】
13
+ * ・/etc/claude-code へは1バイトも書かない(書けるかは `access` で見るだけ=書いて試さない)。
14
+ * ・設定の中身・登録された命令の文字・環境変数の値は、この部品の返り値に【持たせない】
15
+ * (持たせると、うっかり detail や報告へ流れる)。返すのは 在る/無い・件数・ファイル名・
16
+ * 持ち主と権限だけ。中身(json)は「登録の件数を数える」ためだけに持ち、呼び出し側も数以外は出さない。
17
+ *
18
+ * 【★安全を下げる明示の判定は、ここに写しを作らない】正本は `scripts/managed-settings-audit.py`
19
+ * (docs/managed-settings-methodD.md の一覧と `test/managed-settings-no-weaken.test.ts` が突き合わせる)。
20
+ * 自己診断は【その台本をそのまま呼ぶ】。だからこのファイルに同じ規則を並べない。
21
+ */
22
+ import { accessSync, closeSync, constants, openSync, readSync, readdirSync, readFileSync, statSync } from 'node:fs';
23
+ import path from 'node:path';
24
+ // ─────────────────────────────────────────────────────────────────────────────
25
+ // 置き場と名前(docs/managed-settings-methodD.md の「置き場」と同じ)
26
+ // ─────────────────────────────────────────────────────────────────────────────
27
+ /** 土台のファイル名。 */
28
+ export const MANAGED_BASE_FILE = 'managed-settings.json';
29
+ /** 差し込みのフォルダ名(この中の *.json が後から重ねられる・便 6cc9959f で実コードを確認)。 */
30
+ export const MANAGED_DROPIN_DIR = 'managed-settings.d';
31
+ /** 管理者の設定の置き場(OS ごと)。 */
32
+ export function managedSettingsDir(platform) {
33
+ return platform === 'darwin' ? '/Library/Application Support/ClaudeCode' : '/etc/claude-code';
34
+ }
35
+ /**
36
+ * WSL で「Windows の列」が使われる置き場(便 6cc9959f 重大発見5)。
37
+ * Windows 側の管理者だけが書ける場所で「受け継ぐ」を立てると、WSL は Windows の列を読み、
38
+ * そちらが優先される(しかも、その値が壊れていると /etc を下に読まない)。
39
+ * ★番人の守る場所の一覧にはこの置き場が入っていないので、自己診断は「無いこと」を見張る。
40
+ */
41
+ export const WINDOWS_MANAGED_DIR = '/mnt/c/Program Files/ClaudeCode';
42
+ /**
43
+ * 管理者の設定の置き場を差し替える環境変数の名前(便 6cc9959f 重大発見4)。
44
+ * ★いまの版(2.1.285)では読み手が空を返すので効かないが、版が上がると変わりうる。
45
+ * ★名前だけを見る(値は読まない・出さない)。
46
+ */
47
+ export const MANAGED_PATH_ENV = 'CLAUDE_CODE_MANAGED_SETTINGS_PATH';
48
+ /**
49
+ * 【★1か所】差し込みフォルダと管理者のフックの扱いを【実物で確かめた】Claude Code の版。
50
+ *
51
+ * 2.1.285 … 便 6cc9959f が道具の実体を読んで確かめた(読み込む出どころに管理者の層を必ず足す/
52
+ * 差し込みフォルダの *.json が後から重なる/最小の形の旗は管理者のフックまで止める)。
53
+ *
54
+ * ★ここに無い版は「この版は未確認」と表示するだけ(FAIL にしない)。新しい版を実物で確かめたら、
55
+ * この一覧に1行足す(★推測で足さない)。
56
+ */
57
+ export const MANAGED_VERIFIED_CLAUDE_VERSIONS = ['2.1.285'];
58
+ /** その版で、差し込みフォルダと管理者のフックの扱いを実物で確かめてあるか。 */
59
+ export function managedVersionVerified(version) {
60
+ return version !== null && MANAGED_VERIFIED_CLAUDE_VERSIONS.includes(version);
61
+ }
62
+ /** 番人の3つの入口(ADR-005)。★管理者の層に登録が在るかを、この並びで1つずつ見る。 */
63
+ export const GUARD_HOOK_EVENTS = [
64
+ { event: 'PreToolUse', label: '止める入口' },
65
+ { event: 'PermissionRequest', label: 'カードの入口' },
66
+ { event: 'Stop', label: '終わりの入口' },
67
+ ];
68
+ // ─────────────────────────────────────────────────────────────────────────────
69
+ // 読み取り(★すべて読むだけ)
70
+ // ─────────────────────────────────────────────────────────────────────────────
71
+ function ownerText(uid, gid) {
72
+ return `${uid === 0 ? 'root' : `uid ${uid}`}:${gid === 0 ? 'root' : `gid ${gid}`}`;
73
+ }
74
+ function failKindOf(err) {
75
+ const code = err?.code;
76
+ if (code === 'ENOENT' || code === 'ENOTDIR')
77
+ return 'missing';
78
+ if (code === 'EACCES' || code === 'EPERM')
79
+ return 'permission';
80
+ return 'other';
81
+ }
82
+ /** 在るか・持ち主・権限・いまのユーザーから書けるか(★書いて試さない)。 */
83
+ export function readManagedPath(p) {
84
+ const name = path.basename(p);
85
+ try {
86
+ const st = statSync(p);
87
+ let writableByMe = null;
88
+ try {
89
+ accessSync(p, constants.W_OK);
90
+ writableByMe = true;
91
+ }
92
+ catch (err) {
93
+ writableByMe = failKindOf(err) === 'other' ? null : false;
94
+ }
95
+ return {
96
+ name,
97
+ exists: true,
98
+ owner: ownerText(st.uid, st.gid),
99
+ mode: (st.mode & 0o777).toString(8),
100
+ writableByMe,
101
+ };
102
+ }
103
+ catch {
104
+ return { name, exists: false, owner: null, mode: null, writableByMe: null };
105
+ }
106
+ }
107
+ /** 設定ファイル1枚を読む(★読めない理由は種類だけ・中身は数を数えるためだけに持つ)。 */
108
+ export function readManagedFile(file) {
109
+ const at = readManagedPath(file);
110
+ if (!at.exists)
111
+ return { ...at, readFail: 'missing', shape: 'unread', json: null };
112
+ let raw;
113
+ try {
114
+ raw = readFileSync(file, 'utf8');
115
+ }
116
+ catch (err) {
117
+ return { ...at, readFail: failKindOf(err), shape: 'unread', json: null };
118
+ }
119
+ let parsed;
120
+ try {
121
+ parsed = JSON.parse(raw);
122
+ }
123
+ catch {
124
+ // ★JSON でない=そのPCで Claude Code が起動しなくなる(便 6cc9959f 重大発見7)。
125
+ return { ...at, readFail: null, shape: 'broken', json: null };
126
+ }
127
+ if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
128
+ return { ...at, readFail: null, shape: 'not-object', json: null };
129
+ }
130
+ return { ...at, readFail: null, shape: 'object', json: parsed };
131
+ }
132
+ /** 管理者の設定ぜんたいを読む(★読むだけ)。 */
133
+ export function readManagedState(opts) {
134
+ const dirState = readManagedPath(opts.dir);
135
+ const base = readManagedFile(path.join(opts.dir, MANAGED_BASE_FILE));
136
+ const dropinPath = path.join(opts.dir, MANAGED_DROPIN_DIR);
137
+ const dropinDir = readManagedPath(dropinPath);
138
+ let dropins = [];
139
+ let dropinListFail = null;
140
+ if (dropinDir.exists) {
141
+ try {
142
+ dropins = readdirSync(dropinPath)
143
+ .filter((f) => f.endsWith('.json'))
144
+ .sort()
145
+ .map((f) => readManagedFile(path.join(dropinPath, f)));
146
+ }
147
+ catch (err) {
148
+ dropinListFail = failKindOf(err);
149
+ }
150
+ }
151
+ return {
152
+ dir: opts.dir,
153
+ dirState,
154
+ base,
155
+ dropinDir,
156
+ dropins,
157
+ dropinListFail,
158
+ // ★名前が在るかだけを見る(値は読まない・出さない)。
159
+ envPathSet: typeof opts.env[MANAGED_PATH_ENV] === 'string' && opts.env[MANAGED_PATH_ENV] !== '',
160
+ windowsDir: readManagedPath(opts.windowsDir),
161
+ };
162
+ }
163
+ /** hooks.<入口> に登録されている命令の数を数える(★形が違えば 0)。 */
164
+ function countHooks(json, event) {
165
+ const hooks = json.hooks;
166
+ if (!hooks || typeof hooks !== 'object' || Array.isArray(hooks))
167
+ return 0;
168
+ const groups = hooks[event];
169
+ if (!Array.isArray(groups))
170
+ return 0;
171
+ let n = 0;
172
+ for (const g of groups) {
173
+ if (!g || typeof g !== 'object' || Array.isArray(g))
174
+ continue;
175
+ const inner = g.hooks;
176
+ if (Array.isArray(inner))
177
+ n += inner.filter((h) => h && typeof h === 'object').length;
178
+ }
179
+ return n;
180
+ }
181
+ /** permissions.deny の中身を集める(★数えるためだけ・文字は返さない)。 */
182
+ function denyEntries(json) {
183
+ const perms = json.permissions;
184
+ if (!perms || typeof perms !== 'object' || Array.isArray(perms))
185
+ return [];
186
+ const deny = perms.deny;
187
+ if (!Array.isArray(deny))
188
+ return [];
189
+ return deny.filter((d) => typeof d === 'string');
190
+ }
191
+ /**
192
+ * 管理者の層(土台+差し込み)に、番人の3つの入口と禁止の一覧が登録されているか。
193
+ *
194
+ * ★数え方:どれか1枚に在れば「在る」と数える(重ね方の細かい決まりには踏み込まない)。
195
+ * ここで知りたいのは「移行が済んでいるか」だけで、どの層の値が勝つかは別の話。
196
+ * ★書式が壊れたファイル(json が null)は数えない。
197
+ */
198
+ export function managedGuardRegistration(files) {
199
+ const usable = files.filter((f) => f.json !== null);
200
+ const deny = new Set();
201
+ for (const f of usable)
202
+ for (const d of denyEntries(f.json))
203
+ deny.add(d);
204
+ const hooks = GUARD_HOOK_EVENTS.map(({ event, label }) => ({
205
+ event,
206
+ label,
207
+ count: usable.reduce((n, f) => n + countHooks(f.json, event), 0),
208
+ }));
209
+ const present = hooks.filter((h) => h.count > 0).length + (deny.size > 0 ? 1 : 0);
210
+ const required = GUARD_HOOK_EVENTS.length + 1;
211
+ return {
212
+ hooks,
213
+ denyCount: deny.size,
214
+ countedFiles: usable.length,
215
+ present,
216
+ required,
217
+ complete: present === required,
218
+ empty: present === 0,
219
+ };
220
+ }
221
+ // ─────────────────────────────────────────────────────────────────────────────
222
+ // 道具の実体の手がかり(★証明ではない)
223
+ // ─────────────────────────────────────────────────────────────────────────────
224
+ /** 実体を探すときの1回の読み幅。 */
225
+ const SCAN_CHUNK = 4 * 1024 * 1024;
226
+ /** 実体を探すときに読む上限(★道具の実体は 2.1.285 で約 240MB)。 */
227
+ export const MANAGED_SCAN_MAX_BYTES = 512 * 1024 * 1024;
228
+ /**
229
+ * ファイルの中に、その文字の並びが在るか(★在ることは「その作りが効く」証明ではない=手がかり)。
230
+ * 読めない・上限まで見つからないときは null(「分からない」)を返す。
231
+ */
232
+ export function fileHasText(file, needle, maxBytes = MANAGED_SCAN_MAX_BYTES) {
233
+ const want = Buffer.from(needle, 'utf8');
234
+ let fd = null;
235
+ try {
236
+ fd = openSync(file, 'r');
237
+ // ★ひと続きの並びが読み幅の境目で切れないように、前の読みの末尾を次の読みへ重ねる。
238
+ const overlap = Math.max(0, want.length - 1);
239
+ let tail = Buffer.alloc(0);
240
+ let read = 0;
241
+ for (;;) {
242
+ const chunk = Buffer.allocUnsafe(SCAN_CHUNK);
243
+ const n = readSync(fd, chunk, 0, SCAN_CHUNK, null);
244
+ if (n <= 0)
245
+ break;
246
+ read += n;
247
+ const hay = tail.length > 0 ? Buffer.concat([tail, chunk.subarray(0, n)]) : chunk.subarray(0, n);
248
+ if (hay.indexOf(want) >= 0)
249
+ return true;
250
+ if (read >= maxBytes)
251
+ return null;
252
+ tail = Buffer.from(hay.subarray(Math.max(0, hay.length - overlap)));
253
+ }
254
+ return false;
255
+ }
256
+ catch {
257
+ return null;
258
+ }
259
+ finally {
260
+ if (fd !== null) {
261
+ try {
262
+ closeSync(fd);
263
+ }
264
+ catch {
265
+ // 閉じられなくても自己診断は続ける
266
+ }
267
+ }
268
+ }
269
+ }
package/dist/selfcheck.js CHANGED
@@ -14,6 +14,11 @@
14
14
  * ⑥ 小さな headless 試験 … 小さい型(haiku)・許可は中継と同じ(番人がそのまま効く)。
15
15
  * 合否は職人の言葉でなく、tool の結果と終了コードで機械判定する
16
16
  * +番人 … 入っている番人に、止めるべき物と通すべき物を1つずつ判定させる
17
+ * +管理者の設定 … /etc の管理設定の状態を【読むだけ】で見る(便 662d7c03)。置き場の有無・
18
+ * 持ち主と権限・読めるか・書式が正しいか・安全を下げる明示が無いか・
19
+ * 対象の版で確かめてあるか・必要な守りの登録が在るか・抜け道の見張り。
20
+ * ★「設定がある」だけで合格にしない。★登録が在っても動作は未確認と出す。
21
+ * ★値・秘密は出さない(在る/無い・件数・ファイル名・持ち主と権限だけ)。
17
22
  *
18
23
  * 【★副作用なし】commit・push・PR・合流・配備・npm 公開をしない。作業場所は一時フォルダ
19
24
  * (~/.local/state/conductor/selfcheck/run-<時刻>・git の中ではない)で、終わったら消す。
@@ -45,6 +50,7 @@ import { fileURLToPath } from 'node:url';
45
50
  import { buildWorkerPath, CLAUDE_MIN_VERSION, claudeUpdateHint, compareVersions, lastClaudePinStatus, resolveClaudeBin, } from './headless.js';
46
51
  import { fetchControl } from './relay.js';
47
52
  import { readDrain } from './autoupdate-flags.js';
53
+ import { fileHasText, MANAGED_BASE_FILE, MANAGED_DROPIN_DIR, MANAGED_PATH_ENV, MANAGED_VERIFIED_CLAUDE_VERSIONS, managedGuardRegistration, managedSettingsDir, managedVersionVerified, readManagedState, WINDOWS_MANAGED_DIR, } from './managed-settings.js';
48
54
  // ─────────────────────────────────────────────────────────────────────────────
49
55
  // 形
50
56
  // ─────────────────────────────────────────────────────────────────────────────
@@ -949,6 +955,142 @@ function checkGuard(d, work) {
949
955
  }
950
956
  return item;
951
957
  }
958
+ /** 読めなかった理由の種類を、人が読む言葉にする(★理由の文そのものは出さない)。 */
959
+ const READ_FAIL_WORD = {
960
+ permission: '権限',
961
+ missing: '存在しない',
962
+ other: 'その他',
963
+ };
964
+ /** 「動作は守りが実際に働いたかまで見ていない」の1行(★登録が在っても必ず出す)。 */
965
+ export const MANAGED_UNVERIFIED_LINE = '動作は未確認(1台での確認の段で確かめる)';
966
+ /** 置き場1つ分の在り方を1行にする(★在る/無い・持ち主・権限だけ)。 */
967
+ function managedWhere(p) {
968
+ if (!p.exists)
969
+ return '無い';
970
+ const w = p.writableByMe === true
971
+ ? '★このユーザーから書けます'
972
+ : p.writableByMe === false
973
+ ? 'このユーザーからは書けません'
974
+ : '書けるかは分かりません';
975
+ return `在る(持ち主 ${p.owner}・権限 ${p.mode}・${w})`;
976
+ }
977
+ /**
978
+ * +管理者の設定(/etc の管理設定)を【読むだけ】で見る(便 662d7c03・けいさん指示 2026-10-09)。
979
+ *
980
+ * 【★8つの段を、それぞれ別の行で出す】1つにまとめて「ある/ない」で済ませない。
981
+ * 1 置き場の有無と持ち主・権限 2 読めるか 3 書式が正しいか 4 安全を下げる明示が無いか
982
+ * 5 対象の版で確かめてあるか(+実体の手がかり) 6 必要な守りの登録が在るか
983
+ * 7 実際に守りが働いたか(★この項目では確かめられない=必ず「未確認」と出す) 8 抜け道の見張り
984
+ *
985
+ * 【★合否の決め方】
986
+ * ・3(書式)か 4(安全を下げる明示)が駄目 → FAIL(fault)。★壊れていると、そのPCで
987
+ * Claude Code が起動しなくなる(便 6cc9959f 重大発見7)。
988
+ * ・6 が「無い」(移行前)→ ok=null(数えない)=「未移行」と出す。
989
+ * ・6 が全部「在る」ときだけ ok=true。それでも 7 は未確認なので、detail の先頭に
990
+ * 「動作は未確認」を出す。★「設定がある」だけで true にしない。
991
+ *
992
+ * 【★値・秘密は出さない】ファイルの中身・登録された命令の文字・環境変数の値は、detail にも
993
+ * 報告にも出さない(在る/無い・件数・ファイル名・持ち主と権限だけ)。
994
+ *
995
+ * 【★管理者の設定そのものは1バイトも変えない】書けるかは `access` で見るだけ(書いて試さない)。
996
+ */
997
+ function checkManaged(d, claude) {
998
+ const item = { key: 'managed', label: '管理者の設定', ok: null, detail: [] };
999
+ const dir = d.managedDir ?? managedSettingsDir(d.platform);
1000
+ const st = readManagedState({ dir, windowsDir: d.windowsManagedDir ?? WINDOWS_MANAGED_DIR, env: d.env });
1001
+ const files = [st.base, ...st.dropins];
1002
+ // 1. 置き場の有無・持ち主・権限(★root の持ち物で、いまのユーザーから書けないこと)
1003
+ note(item, `1 置き場 ${dir}: ${managedWhere(st.dirState)}`);
1004
+ note(item, `1 土台 ${MANAGED_BASE_FILE}: ${managedWhere(st.base)}`);
1005
+ note(item, `1 差し込み ${MANAGED_DROPIN_DIR}/: ${managedWhere(st.dropinDir)}${st.dropinDir.exists ? `・${st.dropins.length} 枚` : ''}`);
1006
+ // 2. 読めるか(★読めない場合は理由の種類だけ)
1007
+ const existing = files.filter((f) => f.exists);
1008
+ const unreadable = existing.filter((f) => f.readFail !== null);
1009
+ if (existing.length === 0)
1010
+ note(item, '2 読めるか: 対象のファイルがありません');
1011
+ else if (unreadable.length === 0)
1012
+ note(item, `2 読めるか: 対象 ${existing.length} 枚すべて読めました`);
1013
+ else
1014
+ for (const f of unreadable)
1015
+ note(item, `2 読めるか: ${f.name} を読めません(理由の種類 ${READ_FAIL_WORD[f.readFail]})`);
1016
+ if (st.dropinListFail)
1017
+ note(item, `2 読めるか: 差し込みの一覧を読めません(理由の種類 ${READ_FAIL_WORD[st.dropinListFail]})`);
1018
+ // 3. 書式が正しいか(★土台と差し込みの各ファイルそれぞれ・駄目なら FAIL)
1019
+ const parsed = existing.filter((f) => f.readFail === null);
1020
+ const badShape = parsed.filter((f) => f.shape !== 'object');
1021
+ for (const f of badShape) {
1022
+ fail(item, 'fault', `3 書式が正しくありません: ${f.name}(${f.shape === 'broken' ? 'JSON として読めない' : '最上位がオブジェクトでない'})` +
1023
+ '★このPCでは Claude Code が起動しません');
1024
+ }
1025
+ if (parsed.length === 0)
1026
+ note(item, '3 書式: 読めたファイルがないので見ていません');
1027
+ else if (badShape.length === 0)
1028
+ note(item, `3 書式: 対象 ${parsed.length} 枚すべて JSON のオブジェクトです`);
1029
+ // 4. 安全を下げる明示が無いか(★判定の正本は scripts/managed-settings-audit.py・写しを作らない)
1030
+ const good = parsed.filter((f) => f.shape === 'object');
1031
+ const auditTargets = good.map((f) => f === st.base ? path.join(dir, MANAGED_BASE_FILE) : path.join(dir, MANAGED_DROPIN_DIR, f.name));
1032
+ const auditScript = path.join(d.distRoot, 'scripts', 'managed-settings-audit.py');
1033
+ if (auditTargets.length === 0)
1034
+ note(item, '4 安全を下げる明示: 調べる対象がありません');
1035
+ else if (!existsSync(auditScript))
1036
+ note(item, '4 安全を下げる明示: 未確認(検査の台本が配布物にありません)');
1037
+ else {
1038
+ const r = d.exec('python3', [auditScript, ...auditTargets], { env: d.env, timeoutMs: 30_000 });
1039
+ // ★出すのは項目名だけ(検査の台本も値は出さない作り)。
1040
+ const keys = [...new Set([...r.stdout.matchAll(/^NG\s.*?:\s*([A-Za-z][A-Za-z0-9_.]*)\s/gm)].map((m) => m[1]))];
1041
+ if (r.status === 0)
1042
+ note(item, `4 安全を下げる明示: ありません(検査の台本で ${auditTargets.length} 枚)`);
1043
+ else if (r.status === 1)
1044
+ fail(item, 'fault', `4 安全を下げる明示が在ります(${keys.length} 件: ${keys.join('・')})`);
1045
+ else if (r.status === 2)
1046
+ fail(item, 'fault', '4 検査の台本が「読めない/JSON でない/最上位がオブジェクトでない」と判定しました');
1047
+ else
1048
+ note(item, `4 安全を下げる明示: 未確認(検査の台本を流せません・終了 ${r.status})`);
1049
+ }
1050
+ // 5. 対象の版で対応しているか(★一覧に無ければ「未確認」と出すだけ=FAIL にしない)
1051
+ if (managedVersionVerified(claude.version)) {
1052
+ note(item, `5 対象の版: ${claude.version} は実物で確かめた版の一覧に在ります`);
1053
+ }
1054
+ else {
1055
+ note(item, `5 対象の版: ${claude.version ?? '不明'} はこの版は未確認` +
1056
+ `(実物で確かめた版 ${MANAGED_VERIFIED_CLAUDE_VERSIONS.join('・')})`);
1057
+ }
1058
+ if (!claude.bin)
1059
+ note(item, '5 手がかり: 道具の実体が無いので見ていません');
1060
+ else {
1061
+ const has = fileHasText(claude.bin, MANAGED_DROPIN_DIR);
1062
+ const word = has === true ? '在ります' : has === false ? 'ありません' : '在るかは分かりません(読めない・上限まで見つからない)';
1063
+ note(item, `5 手がかり: 道具の実体に「${MANAGED_DROPIN_DIR}」の文字が ${word}(★在ることは効く証明ではありません)`);
1064
+ }
1065
+ // 6. 必要な守りの登録があるか(★項目ごとに在る/無い・中身の値は出さない)
1066
+ const reg = managedGuardRegistration(files);
1067
+ for (const h of reg.hooks) {
1068
+ note(item, `6 登録 ${h.label}(${h.event}): ${h.count > 0 ? `在る(${h.count} 件)` : '無い'}`);
1069
+ }
1070
+ note(item, `6 登録 禁止の一覧: ${reg.denyCount > 0 ? `在る(${reg.denyCount} 件)` : '無い'}`);
1071
+ if (badShape.length > 0)
1072
+ note(item, '6 登録: 書式が壊れたファイルは数えていません');
1073
+ const nowGuard = 'いまの守り=持ち主の層の番人と各現場の禁止の一覧で運用中';
1074
+ if (reg.complete)
1075
+ pass(item, '6 登録: 番人の3つの入口と禁止の一覧がそろって登録されています');
1076
+ else if (reg.empty)
1077
+ note(item, `6 登録: 未移行(${nowGuard})`);
1078
+ else
1079
+ note(item, `6 登録: 未移行の途中(${reg.required} つのうち ${reg.present} つだけ登録・${nowGuard})`);
1080
+ // 7. 実際に守りが働いたか(★この項目では確かめられない=ok=true のときは先頭に出す)
1081
+ if (item.ok === true)
1082
+ item.detail.unshift(`・7 ${MANAGED_UNVERIFIED_LINE}`);
1083
+ else
1084
+ note(item, `7 ${MANAGED_UNVERIFIED_LINE}`);
1085
+ // 8. 置き場を変える抜け道の見張り(★名前だけ・値は出さない)
1086
+ note(item, st.envPathSet
1087
+ ? `8 見張り: ★置き場を差し替える環境変数 ${MANAGED_PATH_ENV} が立っています(値は出しません)`
1088
+ : `8 見張り: 置き場を差し替える環境変数(${MANAGED_PATH_ENV})は立っていません`);
1089
+ note(item, st.windowsDir.exists
1090
+ ? `8 見張り: ★Windows 側の置き場が在ります(${st.windowsDir.name}・持ち主 ${st.windowsDir.owner}・権限 ${st.windowsDir.mode})`
1091
+ : '8 見張り: Windows 側の置き場はありません');
1092
+ return item;
1093
+ }
952
1094
  /** 項目ごとの合否(管制の checks)。見られなかった項目は skip。 */
953
1095
  export function checksOf(r) {
954
1096
  const out = {};
@@ -1067,6 +1209,8 @@ export async function runSelfcheck(d, trigger) {
1067
1209
  const net = checkNetworkOutside(d, version);
1068
1210
  const network = net.item;
1069
1211
  const guard = checkGuard(d, path.join(runDir, 'work'));
1212
+ // +管理者の設定(★読むだけ・/etc へは1バイトも書かない・便 662d7c03)
1213
+ const managed = checkManaged(d, { bin: claude.bin, version: claude.version });
1070
1214
  // ⑥ 小さな試験(③の MCP・④の書き込み・⑤の内側の通信もここで見る)
1071
1215
  //
1072
1216
  // ★1回目の失敗が【一時的と確認できた】ときだけ、60秒待って【1回だけ】やり直す
@@ -1149,7 +1293,7 @@ export async function runSelfcheck(d, trigger) {
1149
1293
  else
1150
1294
  fail(network, 'fault', `囲いの内側から ${u} → ${c}`);
1151
1295
  }
1152
- const items = [conductor, claude.item, central, sandbox, network, headless, guard];
1296
+ const items = [conductor, claude.item, central, sandbox, network, headless, guard, managed];
1153
1297
  const humanActions = items.flatMap((i) => i.human ?? []);
1154
1298
  const candidates = pickCandidates({ conductor: version, claude: claude.version }, { conductor: net.latest, claude: await fetchClaudeStable(d.fetchImpl) });
1155
1299
  return {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.120",
3
+ "version": "0.12.122",
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/managed-settings-audit.py",
24
25
  "scripts/dist-source.sh",
25
26
  "scripts/conductor-run.sh",
26
27
  "scripts/tyhld-selfcheck.sh",
@@ -1525,11 +1525,24 @@ _KNOWN_TOOLS = frozenset({
1525
1525
  'vercel', 'supabase', 'wrangler', 'prisma', 'drizzle-kit', 'fly', 'flyctl', 'heroku',
1526
1526
  'netlify', 'gh', 'psql', 'dropdb', 'claude',
1527
1527
  })
1528
+ #: git の全体オプション(前置きの旗)のうち、値を【次の語】で受け取る物。
1529
+ # ★ここが「git の前置きの旗」の唯一の正本。読み飛ばす処理(_git_subcommand・_git_cwd)も、
1530
+ # 道具の語の並び(_tool_words)も、この1つの集合を使う=同じ一覧を2つ持たない。
1531
+ # ★「=」で値を付ける形(--git-dir=…)は1語で済むので、ここには要らない。
1532
+ _GIT_GLOBAL_VALUE_FLAGS = frozenset({
1533
+ '-C', '-c', '--git-dir', '--work-tree', '--namespace', '--super-prefix',
1534
+ })
1535
+
1528
1536
  # 値を1つ取る旗(語の並びから値ごと外す)。
1537
+ # ★git の前置きの旗(上の正本)も混ぜる。混ぜないと `git --git-dir <場所> commit -n` のように
1538
+ # 旗を挟んだだけで部分命令が読めなくなり、検査の省略の判定が外れる(便 65cd34ad の実測)。
1539
+ # ★supabase / prisma の全体の旗も同じ理由で足す(`supabase --workdir <場所> db push` が
1540
+ # 本番 DB の直接変更の判定から外れていた=同じ原因・便 65cd34ad の実測)。
1529
1541
  _VALUE_FLAGS = frozenset({
1530
1542
  '--scope', '-S', '--token', '-t', '--cwd', '--project-ref', '--app', '-a', '--config',
1531
1543
  '-c', '-C', '--account-id', '--site', '--env', '-e', '--repo', '-R', '--schema',
1532
- })
1544
+ '--workdir', '--dns-resolver', '--network-id', '--telemetry-information',
1545
+ }) | _GIT_GLOBAL_VALUE_FLAGS
1533
1546
 
1534
1547
  # 前置き(npm / pnpm / yarn / npx)の、値を1つ取る旗(`--filter <部品>` など)。
1535
1548
  _RUNNER_VALUE_FLAGS = frozenset({
@@ -1654,23 +1667,14 @@ def _main_push_danger(tokens, cwd):
1654
1667
  start = [t.split('/')[-1] for t in tokens].index('git')
1655
1668
  except ValueError:
1656
1669
  return None
1657
- # git の前置きの旗(-C 場所 / -c 設定)を読む。
1658
- where = cwd
1659
- args = list(tokens[start + 1:])
1660
- while args and args[0].startswith('-'):
1661
- flag = args.pop(0)
1662
- if flag == '-C' and args:
1663
- p = args.pop(0)
1664
- if any(c in p for c in '$`') or where is _UNKNOWN_DIR:
1665
- where = _UNKNOWN_DIR
1666
- else:
1667
- p = os.path.expanduser(p)
1668
- where = p if os.path.isabs(p) else os.path.join(where or os.getcwd(), p)
1669
- elif flag == '-c' and args:
1670
- args.pop(0)
1671
- if not args or args[0] != 'push':
1670
+ # git の前置きの旗(-C 場所・-c 設定・--git-dir 場所 …)を読み飛ばして部分命令を取り出す。
1671
+ # ★旗の一覧と読み飛ばし方は _git_subcommand / _git_cwd の1か所に寄せてある
1672
+ # (以前はここだけ -C と -c しか読まず、`git --git-dir <場所> push origin main` が
1673
+ # 素通りしていた=便 65cd34ad の実測)。
1674
+ where = _git_cwd(tokens[start + 1:], cwd)
1675
+ sub, push_args = _git_subcommand(tokens[start + 1:])
1676
+ if sub != 'push':
1672
1677
  return None
1673
- push_args = args[1:]
1674
1678
  positional = []
1675
1679
  it = iter(push_args)
1676
1680
  for t in it:
@@ -1732,10 +1736,8 @@ def _main_push_danger(tokens, cwd):
1732
1736
  # ★いまの字面の判定(_danger_patterns)は残す。どちらかに当たれば止める=止まる形は1つも減らない。
1733
1737
  # ─────────────────────────────────────────────────────────────────────────────
1734
1738
 
1735
- #: git の全体オプションのうち、値を【次の語】で受け取る物(「=」で付ける形は1語で済む)。
1736
- _GIT_GLOBAL_VALUE_FLAGS = frozenset({
1737
- '-C', '-c', '--git-dir', '--work-tree', '--namespace', '--super-prefix',
1738
- })
1739
+ # ★git の全体オプション(前置きの旗)の一覧は _GIT_GLOBAL_VALUE_FLAGS が正本(上の方で定義)。
1740
+ # 道具の語の並び(_tool_words)もそれを混ぜて使う=同じ一覧を2つ持たない。
1739
1741
 
1740
1742
  #: push の旗のうち、値を【次の語】で受け取る物(値が `-f` でも旗と読み違えないため)。
1741
1743
  _PUSH_VALUE_FLAGS = frozenset({
@@ -1760,6 +1762,79 @@ def _git_subcommand(args):
1760
1762
  return rest[0], rest[1:]
1761
1763
 
1762
1764
 
1765
+ def _git_cwd(args, cwd):
1766
+ """git の前置きの旗を読んだ後の作業場所(`-C 場所` を反映)。
1767
+
1768
+ ★旗の読み飛ばし方は _git_subcommand と同じ(一覧も _GIT_GLOBAL_VALUE_FLAGS の1つだけ)。
1769
+ ★場所が変数で決まるときは _UNKNOWN_DIR(=確かめられない)を返す。
1770
+ """
1771
+ where = cwd
1772
+ rest = list(args)
1773
+ while rest and rest[0].startswith('-') and rest[0] != '--':
1774
+ flag = rest.pop(0)
1775
+ if '=' in flag:
1776
+ continue
1777
+ if flag == '-C' and rest:
1778
+ p = rest.pop(0)
1779
+ if any(c in p for c in '$`') or where is _UNKNOWN_DIR:
1780
+ where = _UNKNOWN_DIR
1781
+ else:
1782
+ p = os.path.expanduser(p)
1783
+ where = p if os.path.isabs(p) else os.path.join(where or os.getcwd(), p)
1784
+ elif flag in _GIT_GLOBAL_VALUE_FLAGS and rest:
1785
+ rest.pop(0)
1786
+ return where
1787
+
1788
+
1789
+ # ─────────────────────────────────────────────────────────────────────────────
1790
+ # git の危険な部分命令を【語(トークン)】で見る(DENY・便 65cd34ad)
1791
+ #
1792
+ # 【なぜ要るか(実地 便 5157164e・b29110f3)】
1793
+ # 危険の判定(_danger_patterns)は「git のすぐ後ろに部分命令が来る字面」だけを見ていたので、
1794
+ # 前置きの旗を1つ挟むだけで外れていた(実測で allow だった形):
1795
+ # ・git -C <場所> reset --hard / git -c <設定> reset --hard
1796
+ # ・git --work-tree <場所> reset --hard / git --namespace <名> reset --hard
1797
+ # ・git -C <場所> clean -fd / git -c <設定> clean -fdx
1798
+ # ・git -C <場所> credential fill / git -C <場所> credential-store get
1799
+ # しかも番人自身が「cd は1回だけ・以後は絶対パスか git -C を使う」と案内する(鉄則2)ので、
1800
+ # 職人はこの形に辿り着きやすい。実際 utatane の2便は `cd <写し> && …` を番人に止められた
1801
+ # 直後に `git -C <写し> …` へ書き換えており、禁止の reset --hard がそのまま通った。
1802
+ #
1803
+ # 【どう見るか】強い上書きの push(便 e619bd86)と同じ作りを使い回す。
1804
+ # ① _git_subcommand で git の全体オプションを読み飛ばして部分命令を取り出す。
1805
+ # ② 部分命令ごとに、危険の印を【位置を問わずに】探す。
1806
+ # ★理由の文は _danger_patterns と同じ字面を返す(番人の言い方を増やさない)。
1807
+ # ★つなぎ(; && || |)・入れ子($( ) ・` `)・包み(env・sudo・nohup・command・bash -c)・
1808
+ # 変数の展開には、_bypass_scan に相乗りすることで同じ判定が届く(番人のいつもの流儀)。
1809
+ # ★いまの字面の判定(_danger_patterns)は残す。どちらかに当たれば止める=止まる形は1つも減らない。
1810
+ # ─────────────────────────────────────────────────────────────────────────────
1811
+
1812
+ def _git_clean_forced_dirs(rest) -> bool:
1813
+ """`git clean` の後ろの語が「強制(-f/--force)」と「フォルダごと(-d)」の両方か。"""
1814
+ short = ''.join(a[1:] for a in rest if a.startswith('-') and not a.startswith('--'))
1815
+ long_names = {a.split('=', 1)[0] for a in rest if a.startswith('--')}
1816
+ return ('f' in short or '--force' in long_names) and 'd' in short
1817
+
1818
+
1819
+ def _git_token_danger(tokens):
1820
+ """語の並びで見る git の危険な部分命令。危険なら理由を返す(_danger_patterns と同じ字面)。"""
1821
+ for i, t in enumerate(tokens):
1822
+ if _word_head(t) != 'git':
1823
+ continue
1824
+ sub, rest = _git_subcommand(tokens[i + 1:])
1825
+ if sub is None:
1826
+ continue
1827
+ sub = _word_head(sub)
1828
+ if sub == 'reset' and any(a.split('=', 1)[0] == '--hard' for a in rest):
1829
+ return 'git reset --hard'
1830
+ if sub == 'clean' and _git_clean_forced_dirs(rest):
1831
+ return 'git clean -fd'
1832
+ if (sub == 'credential' or sub.startswith('credential-')) \
1833
+ and rest[:1] and rest[0] in ('fill', 'get'):
1834
+ return 'git credential fill (合言葉の表示)'
1835
+ return None
1836
+
1837
+
1763
1838
  def _push_force_mark(push_args):
1764
1839
  """push の後ろの語に、強い上書きの印が在れば その語 を返す(位置は問わない)。"""
1765
1840
  i = 0
@@ -2192,10 +2267,56 @@ def _screen_launch_danger(tokens):
2192
2267
  return None
2193
2268
 
2194
2269
 
2270
+ # ─────────────────────────────────────────────────────────────────────────────
2271
+ # 道具+部分命令の形で止める危険を【語の並び】でも見る(DENY・便 65cd34ad)
2272
+ #
2273
+ # 【なぜ要るか(実測)】危険の判定(_danger_patterns)は全文の字面を見るので、道具と部分命令の
2274
+ # あいだに前置きの旗が1つ入るだけで外れていた(実測で allow だった形):
2275
+ # ・supabase --workdir <場所> db reset / supabase --workdir <場所> projects api-keys
2276
+ # ・vercel --cwd <場所> env pull / vercel --scope <組> env pull / vercel --token <値> env pull
2277
+ # ・gh -R <リポ> secret set <名> / gh --repo <リポ> secret set <名>
2278
+ # ・npm --prefix <場所> config get _authToken
2279
+ # =git の前置きの旗(_git_token_danger)と同じ原因なので、同じ形で塞ぐ。
2280
+ # 【どう見るか】実際に動く道具の語の並び(_tool_words=前置き・包み・値を取る旗を外した形)の
2281
+ # 先頭から当てる。★理由の文は _danger_patterns と同じ字面を返す(番人の言い方を増やさない)。
2282
+ # ★_danger_patterns の字面の判定は残す。どちらかに当たれば止める=止まる形は1つも減らない。
2283
+ # ─────────────────────────────────────────────────────────────────────────────
2284
+
2285
+ #: (語の並びの先頭, 理由) の一覧。★理由は _danger_patterns と同じ字面にそろえる。
2286
+ _TOOL_DANGER_WORDS = (
2287
+ (('supabase', 'db', 'reset'), 'supabase db reset'),
2288
+ (('supabase', 'projects', 'api-keys'), 'supabase projects api-keys (鍵の表示)'),
2289
+ (('vercel', 'env', 'pull'), 'vercel env pull (本番の環境設定の取り寄せ)'),
2290
+ (('gh', 'auth', 'token'), 'gh auth token (合言葉の表示)'),
2291
+ (('gh', 'auth', 'git-credential', 'get'), 'gh auth git-credential get (合言葉の表示)'),
2292
+ (('gh', 'secret'), 'gh secret'),
2293
+ )
2294
+
2295
+
2296
+ def _tool_words_danger(words, tokens):
2297
+ """道具の語の並びで見る危険。危険なら理由を返す(_danger_patterns と同じ字面)。"""
2298
+ for head, reason in _TOOL_DANGER_WORDS:
2299
+ if tuple(words[:len(head)]) == head:
2300
+ return reason
2301
+ if words[:2] == ['gh', 'auth'] and words[2:3] == ['status'] \
2302
+ and any(t == '--show-token' or (t.startswith('-') and not t.startswith('--')
2303
+ and 't' in t[1:]) for t in tokens):
2304
+ return 'gh auth status --show-token (合言葉の表示)'
2305
+ if words[:2] == ['npm', 'config'] and words[2:3] and words[2] in ('get', 'list', 'ls') \
2306
+ and any('_auth' in t.lower() for t in tokens):
2307
+ return 'npm config get _authToken (合言葉の表示)'
2308
+ return None
2309
+
2310
+
2195
2311
  def _bypass_segment_danger(seg, tokens, cwd, command):
2196
2312
  """1セグメントの抜け道(main 直 push 以外)。"""
2197
2313
  # ★強い上書きの push は、道具の語が読めなくても(包みの中でも)語の並びで見る(便 e619bd86)。
2198
2314
  hit = _force_push_token_danger(tokens)
2315
+ if hit:
2316
+ return hit
2317
+ # ★git の危険な部分命令(reset --hard・clean -fd・credential)も、前置きの旗を飛ばして
2318
+ # 語の並びで見る(便 65cd34ad)。
2319
+ hit = _git_token_danger(tokens)
2199
2320
  if hit:
2200
2321
  return hit
2201
2322
  # ★安全の決まりを省いた子の職人の起こし方も、同じく語の並びで見る(便 4b9e6e8b)。
@@ -2209,6 +2330,10 @@ def _bypass_segment_danger(seg, tokens, cwd, command):
2209
2330
  words = _tool_words(tokens)
2210
2331
  if not words:
2211
2332
  return None
2333
+ # ★道具+部分命令の形の危険も、前置きの旗で外れないよう語の並びで見る(便 65cd34ad)。
2334
+ hit = _tool_words_danger(words, tokens)
2335
+ if hit:
2336
+ return hit
2212
2337
  seg_low = seg.lower()
2213
2338
  hit = _gh_api_danger(words, tokens, seg_low) or _http_github_danger(words, tokens, seg_low)
2214
2339
  if hit:
@@ -4368,16 +4493,15 @@ def _disc_cd(cmds, toks):
4368
4493
 
4369
4494
 
4370
4495
  def _disc_git_add(words):
4496
+ # ★git の前置きの旗は _git_subcommand で飛ばす(以前はここで -C と -c だけを読んでいたので
4497
+ # `git --git-dir <場所> add -A` が外れていた=便 65cd34ad の実測)。
4371
4498
  if not words or words[0].split('/')[-1] != 'git':
4372
4499
  return None
4373
- i = 1
4374
- while i < len(words) and words[i].startswith('-'):
4375
- # git の全体の旗(-C 場所・-c 設定 は値を1つ取る)。
4376
- i += 2 if words[i] in ('-C', '-c') else 1
4377
- if i >= len(words) or words[i] != 'add':
4500
+ sub, rest = _git_subcommand(words[1:])
4501
+ if sub != 'add':
4378
4502
  return None
4379
4503
  after_dd = False
4380
- for a in words[i + 1:]:
4504
+ for a in rest:
4381
4505
  if not after_dd and a == '--':
4382
4506
  after_dd = True
4383
4507
  continue
@@ -4406,14 +4530,13 @@ def _disc_git_commit_all(words):
4406
4530
  手元の記録に入った(ai-kana の2便が続けて踏んだ)。`git add -A` と同じ「まとめて入れる」形なので、
4407
4531
  同じ扱いで止める(止める物を足すだけ)。
4408
4532
  """
4533
+ # ★git の前置きの旗は _git_subcommand で飛ばす(以前はここで -C と -c だけを読んでいたので
4534
+ # `git --work-tree <場所> commit -a -m x` が外れていた=便 65cd34ad の実測)。
4409
4535
  if not words or words[0].split('/')[-1] != 'git':
4410
4536
  return None
4411
- i = 1
4412
- while i < len(words) and words[i].startswith('-'):
4413
- i += 2 if words[i] in ('-C', '-c') else 1
4414
- if i >= len(words) or words[i] != 'commit':
4537
+ sub, rest = _git_subcommand(words[1:])
4538
+ if sub != 'commit':
4415
4539
  return None
4416
- rest = words[i + 1:]
4417
4540
  k = 0
4418
4541
  while k < len(rest):
4419
4542
  a = rest[k]
@@ -0,0 +1,260 @@
1
+ #!/usr/bin/env python3
2
+ """git の前置きの旗(-C 場所・-c 設定 など)を挟んだ危険な命令の試験(便 65cd34ad)。
3
+
4
+ 実行: python3 scripts/hooks/test_git_prefix_flags.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【なぜ要るか(実地 便 5157164e・b29110f3)】
8
+ 危険の判定(_danger_patterns)は「git のすぐ後ろに部分命令が来る字面」だけを見ていたので、
9
+ 前置きの旗を1つ挟むだけで外れていた。しかも番人自身が「cd は1回だけ・以後は絶対パスか
10
+ git -C を使う」と案内する(鉄則2)ので、職人はこの形に辿り着きやすい。
11
+ 実際 utatane の2便は `cd <写し> && …` を番人に止められた直後に `git -C <写し> …` へ書き換え、
12
+ 便で禁止されている戻しの命令がそのまま通った(職人の自己申告で発覚)。
13
+
14
+ 【ここで固定すること】
15
+ (1) 実測で素通りだった形が止まる(★語で見る判定だけが止める=足した判定が効いている証拠)
16
+ (2) つないだ行・入れ子・包み・変数の展開にも判定が届く
17
+ (3) ★止めてはいけない普通の作業(git -C 場所 status・log・diff・fetch・checkout・switch・
18
+ add・commit・push(force なし)ほか)は止めない
19
+ (4) ★いまの字面の判定は1つも弱めていない(元から止まっていた形はそのまま止まる)
20
+ (5) git 以外の道具でも、同じ原因(前置きの旗)で外れていた形が止まる
21
+ (6) 前置きの旗の一覧は1か所だけ(同じ一覧を2つ持たない)
22
+
23
+ ★見本の危険語は部品から組み立てる(番人の見本に危険語をそのまま書かない)。
24
+ """
25
+ import os
26
+ import sys
27
+
28
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
29
+
30
+ import policy # noqa: E402
31
+
32
+ failures = []
33
+
34
+
35
+ def check(label, got, want):
36
+ ok = got == want
37
+ if not ok:
38
+ failures.append(f'{label}: got={got!r} want={want!r}')
39
+ print(f'{"OK " if ok else "NG "} {label:72} {str(got)[:32]}')
40
+
41
+
42
+ # ── 部品(危険語を直接書かない) ──
43
+ RESET = 're' + 'set'
44
+ HARD = '--ha' + 'rd'
45
+ CLEAN = 'cle' + 'an'
46
+ FD = '-' + 'fd'
47
+ CRED = 'creden' + 'tial'
48
+ WORK = '/tmp/claude-1000' # 判定に使う作業場所(実物のリポを指さない)
49
+ REL = 'node_modules/.tmp-karaburi-65cd34ad' # 便 b29110f3 が実際に使った相対の置き場
50
+
51
+ # ─────────────────────────────────────────────────────────────────────────────
52
+ # (1) 実測で素通りだった形(CC1 の再現と、この便での測り直し)
53
+ # ─────────────────────────────────────────────────────────────────────────────
54
+ LEAKED = [
55
+ f'git -C {WORK}/x {RESET} {HARD} origin/main',
56
+ f'git -C {REL} {RESET} {HARD} HEAD',
57
+ f'git -c core.pager=cat {RESET} {HARD}',
58
+ f'git --work-tree {WORK}/x {RESET} {HARD} HEAD',
59
+ f'git --namespace probe {RESET} {HARD} HEAD',
60
+ f'git -C {WORK}/x -c core.pager=cat {RESET} {HARD} --quiet abc',
61
+ f'git -C {WORK}/x {CLEAN} {FD}',
62
+ f'git -c core.pager=cat {CLEAN} {FD}x',
63
+ f'git -C {WORK}/x {CRED} fill',
64
+ f'git -C {WORK}/x {CRED}-store get',
65
+ ]
66
+
67
+ print('\n=== (1) 実測で素通りだった形が止まる ===')
68
+ for cmd in LEAKED:
69
+ r = policy.decide_bash(cmd, cwd=WORK)
70
+ check(f'deny {cmd[:62]}', r['decision'], policy.DENY)
71
+
72
+ print('\n=== (1b) ★この形は【語で見る判定】が止めている(足した判定が効いている証拠) ===')
73
+ for cmd in LEAKED:
74
+ got = policy._git_token_danger(policy.tokens_of(cmd))
75
+ check(f'語で見る判定が当たる {cmd[:52]}', bool(got), True)
76
+
77
+ print('\n=== (1c) 旗の読み飛ばしで外れていた「まとめて記録に入れる形」も止まる ===')
78
+ for cmd in [
79
+ f'git --git-dir {WORK}/x/.git add -A',
80
+ f'git --work-tree {WORK}/x add --all',
81
+ f'git --work-tree {WORK}/x commit -a -m x',
82
+ f'git --git-dir {WORK}/x/.git commit --all -m x',
83
+ ]:
84
+ r = policy.decide_bash(cmd, cwd=WORK)
85
+ check(f'deny {cmd[:62]}', r['decision'], policy.DENY)
86
+
87
+ print('\n=== (1d) 旗の読み飛ばしで外れていた「保護ブランチへの直 push」も止まる ===')
88
+ for cmd in [
89
+ f'git --git-dir {WORK}/x/.git push origin main',
90
+ f'git --work-tree {WORK}/x push origin main',
91
+ ]:
92
+ r = policy.decide_bash(cmd, cwd=WORK)
93
+ check(f'deny {cmd[:62]}', r['decision'], policy.DENY)
94
+
95
+ # ─────────────────────────────────────────────────────────────────────────────
96
+ # (2) つなぎ・入れ子・包み・変数の展開にも届く
97
+ # ─────────────────────────────────────────────────────────────────────────────
98
+ BASE = f'git -C {WORK}/x {RESET} {HARD} HEAD'
99
+ print('\n=== (2) つなぎ・入れ子・包み・変数の展開にも判定が届く ===')
100
+ for cmd in [
101
+ f'env X=1 {BASE}',
102
+ f'nohup {BASE}',
103
+ f'command {BASE}',
104
+ f'sudo {BASE}',
105
+ f'time {BASE}',
106
+ f'echo ok; {BASE}',
107
+ f'echo ok && {BASE}',
108
+ f'echo ok | {BASE}',
109
+ f'echo ok\n{BASE}',
110
+ f'echo $({BASE})',
111
+ f'`{BASE}`',
112
+ f'bash -c "{BASE}"',
113
+ f'sh -c "{BASE}"',
114
+ f'D={WORK}/x; git -C "$D" {RESET} {HARD} HEAD',
115
+ f'xargs {BASE}',
116
+ ]:
117
+ r = policy.decide_bash(cmd, cwd=WORK)
118
+ check(f'deny {cmd[:62]!r}', r['decision'], policy.DENY)
119
+
120
+ # ─────────────────────────────────────────────────────────────────────────────
121
+ # (3) ★止めてはいけない普通の作業は止めない
122
+ # ─────────────────────────────────────────────────────────────────────────────
123
+ ALLOWED_SHAPES = [
124
+ f'git -C {WORK}/x status --porcelain',
125
+ f'git -C {WORK}/x log --oneline -3',
126
+ f'git -C {WORK}/x diff -- src docs',
127
+ f'git -C {WORK}/x fetch origin',
128
+ f'git -C {WORK}/x checkout -- src',
129
+ f'git -C {WORK}/x checkout probe',
130
+ f'git -C {WORK}/x switch -c feat/probe --no-track origin/main',
131
+ f'git -C {WORK}/x add src/a.ts',
132
+ f'git -C {WORK}/x commit -m x',
133
+ f'git -C {WORK}/x push origin feat/probe',
134
+ f'git -C {WORK}/x stash list',
135
+ f'git -C {WORK}/x branch --no-track feat/probe origin/main',
136
+ f'git -C {WORK}/x rev-parse --abbrev-ref HEAD',
137
+ f'git -C {WORK}/x merge-base --is-ancestor abc origin/main',
138
+ # 危険な印の付かない同じ部分命令(戻し方が違う・空振りの掃除・読むだけ)
139
+ f'git -C {WORK}/x {RESET} --soft HEAD~1',
140
+ f'git -C {WORK}/x {RESET} --mixed HEAD',
141
+ f'git -C {WORK}/x {RESET} -- src/a.ts',
142
+ f'git -C {WORK}/x {CLEAN} -n',
143
+ f'git -C {WORK}/x {CLEAN} -d --dry-run',
144
+ f'git -C {WORK}/x {CRED} approve',
145
+ # 探す言葉として書いた形(調べる作業を止めない)
146
+ f"git grep -n '{RESET} {HARD}' -- skills",
147
+ f"git grep -n '{CLEAN} {FD}' -- skills docs",
148
+ ]
149
+
150
+ print('\n=== (3) 止めてはいけない形は止めない ===')
151
+ for cmd in ALLOWED_SHAPES:
152
+ r = policy.decide_bash(cmd, cwd=WORK)
153
+ check(f'not deny {cmd[:58]}', r['decision'] != policy.DENY, True)
154
+
155
+ print('\n=== (3b) 語で見る判定も、止めてはいけない形には当たらない ===')
156
+ for cmd in ALLOWED_SHAPES:
157
+ got = policy._git_token_danger(policy.tokens_of(cmd))
158
+ check(f'当たらない {cmd[:58]}', got, None)
159
+
160
+ # ★探す言葉の中に git の危険語を書いた形(`grep -rn 'git <戻しの命令>' docs`)は、
161
+ # この便の【前から】字面の判定で deny になる(便 915694ac で免じたのは消す命令だけ)。
162
+ # この便は字面の判定を1文字も変えていないので、その振る舞いもそのまま残る=ここで固定する。
163
+ # ★語で見る判定は、探す言葉には当たらない(=この便が新しく止めた物ではないことの証拠)。
164
+ print('\n=== (3c) 探す言葉の中の危険語は、この便の前からの振る舞いのまま ===')
165
+ for cmd in [
166
+ f"grep -rn 'git {RESET} {HARD}' skills docs",
167
+ f"grep -rn 'git {CLEAN} {FD}' skills docs",
168
+ ]:
169
+ check(f'今までどおり deny {cmd[:52]}',
170
+ policy.decide_bash(cmd, cwd=WORK)['decision'], policy.DENY)
171
+ check(f'語で見る判定は当たらない {cmd[:46]}',
172
+ policy._git_token_danger(policy.tokens_of(cmd)), None)
173
+
174
+ # ─────────────────────────────────────────────────────────────────────────────
175
+ # (4) ★いまの字面の判定を弱めていない(元から止まっていた形はそのまま)
176
+ # ─────────────────────────────────────────────────────────────────────────────
177
+ print('\n=== (4) 字面の判定はそのまま残っている(二層で止める) ===')
178
+ for cmd in [
179
+ f'git {RESET} {HARD} origin/main',
180
+ f'git {CLEAN} {FD}',
181
+ f'git {CRED} fill',
182
+ ]:
183
+ check(f'字面の判定が当たる {cmd[:52]}',
184
+ bool(policy._danger_patterns(cmd.lower())), True)
185
+
186
+ print('\n=== (4b) 元から止まっていた形は今までどおり止まる ===')
187
+ for cmd in [
188
+ f'git {RESET} {HARD} HEAD',
189
+ f'cd {WORK}/x && git {RESET} {HARD} abc',
190
+ f'git --git-dir={WORK}/x/.git {RESET} {HARD}',
191
+ f'git {CLEAN} {FD}x',
192
+ f'git -C {WORK}/x push --force origin probe',
193
+ f'git -C {WORK}/x push origin main',
194
+ f'git -C {WORK}/x add -A',
195
+ f'git -C {WORK}/x commit -am x',
196
+ ]:
197
+ r = policy.decide_bash(cmd, cwd=WORK)
198
+ check(f'deny {cmd[:62]}', r['decision'], policy.DENY)
199
+
200
+ # ─────────────────────────────────────────────────────────────────────────────
201
+ # (5) git 以外の道具でも、同じ原因(前置きの旗)で外れていた形
202
+ # ─────────────────────────────────────────────────────────────────────────────
203
+ print('\n=== (5) ほかの道具の前置きの旗でも外れない ===')
204
+ for cmd in [
205
+ f'supabase --workdir {WORK}/x db push',
206
+ f'supabase --dns-resolver https db push',
207
+ f'supabase --network-id probe db push',
208
+ f'supabase --workdir {WORK}/x db {RESET}',
209
+ f'supabase --workdir {WORK}/x projects api-keys',
210
+ f'prisma --telemetry-information probe db push',
211
+ f'vercel --cwd {WORK}/x env pull',
212
+ 'vercel --scope probe env pull',
213
+ 'vercel --token probe env pull',
214
+ 'gh -R tyhld/conductor secret set X',
215
+ 'gh --repo tyhld/conductor secret set X',
216
+ f'npm --prefix {WORK}/x config get _authToken',
217
+ ]:
218
+ r = policy.decide_bash(cmd, cwd=WORK)
219
+ check(f'deny {cmd[:62]}', r['decision'], policy.DENY)
220
+
221
+ print('\n=== (5b) 前置きの旗が付いても関門は外れない ===')
222
+ for cmd in [
223
+ f'supabase --workdir {WORK}/x functions deploy probe',
224
+ f'wrangler --cwd {WORK}/x deploy',
225
+ f'npm --prefix {WORK}/x publish',
226
+ ]:
227
+ r = policy.decide_bash(cmd, cwd=WORK)
228
+ check(f'gate {cmd[:62]}', r['decision'], policy.GATE)
229
+
230
+ print('\n=== (5c) 読むだけの普通の作業は今までどおり通る ===')
231
+ for cmd in [
232
+ f'supabase --workdir {WORK}/x status',
233
+ f'vercel --cwd {WORK}/x ls',
234
+ 'gh -R tyhld/conductor pr checks 1',
235
+ f'npm --prefix {WORK}/x ls',
236
+ ]:
237
+ r = policy.decide_bash(cmd, cwd=WORK)
238
+ check(f'not deny {cmd[:58]}', r['decision'] != policy.DENY, True)
239
+
240
+ # ─────────────────────────────────────────────────────────────────────────────
241
+ # (6) 前置きの旗の一覧は1か所だけ(同じ一覧を2つ持たない)
242
+ # ─────────────────────────────────────────────────────────────────────────────
243
+ print('\n=== (6) 前置きの旗の一覧は1つの正本から使い回す ===')
244
+ check('git の前置きの旗の正本が在る',
245
+ sorted(policy._GIT_GLOBAL_VALUE_FLAGS),
246
+ sorted({'-C', '-c', '--git-dir', '--work-tree', '--namespace', '--super-prefix'}))
247
+ check('道具の語の並びも同じ正本を混ぜて使う',
248
+ policy._GIT_GLOBAL_VALUE_FLAGS <= policy._VALUE_FLAGS, True)
249
+ check('部分命令の取り出しも正本で旗を飛ばす',
250
+ policy._git_subcommand(['--work-tree', f'{WORK}/x', RESET, HARD])[0], RESET)
251
+ check('作業場所の読み取りも正本で旗を飛ばす',
252
+ policy._git_cwd(['--namespace', 'probe', '-C', f'{WORK}/x'], None), f'{WORK}/x')
253
+
254
+ print()
255
+ if failures:
256
+ print(f'FAIL {len(failures)} 件')
257
+ for f in failures:
258
+ print(f' - {f}')
259
+ sys.exit(1)
260
+ print('ALL PASS')
@@ -271,6 +271,17 @@ DENY_CASES = [
271
271
  'psql -c "DROP TABLE users"',
272
272
  'gh secret set X',
273
273
  'supabase db reset',
274
+ # ★git の前置きの旗を挟んだ形(便 65cd34ad・実測で allow だった穴)。
275
+ 'git -C /tmp/claude-1000/x reset --hard origin/main',
276
+ 'git -c core.pager=cat reset --hard HEAD',
277
+ 'git --work-tree /tmp/claude-1000/x reset --hard HEAD',
278
+ 'git -C /tmp/claude-1000/x clean -fd',
279
+ 'git -C /tmp/claude-1000/x credential fill',
280
+ # ★ほかの道具でも前置きの旗で外れていた形(同じ原因・便 65cd34ad)。
281
+ 'supabase --workdir /tmp/claude-1000/x db reset',
282
+ 'vercel --cwd /tmp/claude-1000/x env pull',
283
+ 'gh -R tyhld/conductor secret set X',
284
+ 'npm --prefix /tmp/claude-1000/x config get _authToken',
274
285
  ]
275
286
 
276
287
  print('\n=== (b) 危険(秘密の持ち出し・破壊)は deny ===')
@@ -0,0 +1,133 @@
1
+ #!/usr/bin/env python3
2
+ """管理設定(/etc/claude-code/managed-settings.json など)に「安全を下げる明示」が無いかを調べる。
3
+
4
+ なぜ要るか(便 4a45ee41・D1 方式D 第七便・事故の根治):
5
+ 0.12.15 の雛形は sandbox.enabled=false を【明示】していた。管理設定は現場の設定より強いので、
6
+ えふさんが /etc に置いた時点で、囲いを on にしていた8現場の囲いが off になった(2026-09-17 03:1x〜06:0x)。
7
+ 「中央で書いた値は、現場で書いた値を上書きする」。だから中央の設定には、安全を下げる値を
8
+ 黙って入れてはいけない。ここでそれを機械で止める(docs/managed-settings-methodD.md の一覧と同じ)。
9
+
10
+ ★「書いていない」は「現場の設定をそのまま使う」という意味({} =中央から指定しない)。
11
+ ここが止めるのは「書いてあって、しかも安全を下げる値」だけ。
12
+
13
+ 使い方: python3 managed-settings-audit.py <設定ファイル> [<設定ファイル> ...]
14
+ 見つからなければ戻り値 0。1件でもあれば、どのファイルのどの項目かを出して戻り値 1。
15
+ ファイルが読めない・JSON でない・最上位がオブジェクトでないときは戻り値 2(Claude Code もその管理設定では起動しない)。
16
+ ★値そのもの(許可の中身など)は出さない。項目名と理由だけを出す。
17
+ """
18
+ import json
19
+ import sys
20
+
21
+ _MISSING = object()
22
+
23
+
24
+ def _get(d, dotted):
25
+ cur = d
26
+ for part in dotted.split('.'):
27
+ if not isinstance(cur, dict) or part not in cur:
28
+ return _MISSING
29
+ cur = cur[part]
30
+ return cur
31
+
32
+
33
+ #: 「どこにでも書ける」形(便 fc568b25)。書き込みを許す場所に全体を入れると、囲いの意味が無くなる。
34
+ _EVERYTHING = frozenset({'/', '~', '~/', '/*', '~/*', '**', '/**', '~/**'})
35
+
36
+ #: ホームの【まとめて広い】置き場(便 3207b339・えふさん確定 2026-09-20)。
37
+ # ここを丸ごと許すと、道具が要る所だけでなく、その下の何もかもが書けるようになる。
38
+ # ★許すのは「その道具が実際に書く置き場」まで(例 ~/.cache 全体ではなく ~/.cache/pnpm)。
39
+ _BROAD_HOME = frozenset({
40
+ '~/.cache', '~/.config', '~/.local', '~/.local/share', '~/.local/state',
41
+ '~/.npm', '~/.ssh', '~/.tyhld', '~/projects',
42
+ })
43
+
44
+
45
+ def _norm_path(p):
46
+ """末尾の / を落として比べる(★`/` そのものは落とさない)。"""
47
+ t = str(p).strip()
48
+ if t in ('/', '~'):
49
+ return t
50
+ return t.rstrip('/') or t
51
+
52
+
53
+ def _allows_everything(v):
54
+ """書き込みを許す場所の一覧に【全体】か【ホームのまとめて広い置き場】が入っているか。"""
55
+ if not isinstance(v, list):
56
+ return False
57
+ return any(_norm_path(p) in (_EVERYTHING | _BROAD_HOME) for p in v)
58
+
59
+
60
+ # (項目, 安全を下げる値か判定する関数, 理由)。docs/managed-settings-methodD.md の「安全を下げる明示」と同じ並び。
61
+ RULES = [
62
+ ('sandbox.enabled', lambda v: v is False,
63
+ '囲いを切る。中央で false を書くと、囲いを on にしている現場も off になる(2026-09-17 の事故)'),
64
+ ('sandbox.allowUnsandboxedCommands', lambda v: v is True,
65
+ '囲いの外での再実行を許す(職人が囲いの外へ逃げる道が開く)'),
66
+ ('sandbox.filesystem.disabled', lambda v: v is True,
67
+ '囲いのファイルの層を切る(秘密のファイルが隠れなくなる)'),
68
+ ('sandbox.filesystem.denyWrite', lambda v: isinstance(v, list) and len(v) == 0,
69
+ '書き込み禁止の場所を【空で明示】する。中央の空が現場の denyWrite を上書きし、'
70
+ '秘密ファイルへの書き込みが開く(便 6af1e046)'),
71
+ ('sandbox.filesystem.denyRead', lambda v: isinstance(v, list) and len(v) == 0,
72
+ '読み取り禁止の場所を【空で明示】する。中央の空が現場の denyRead を上書きし、'
73
+ '秘密ファイルが読めるようになる'),
74
+ ('sandbox.filesystem.allowWrite', lambda v: _allows_everything(v),
75
+ '書き込みを許す場所に【全体】を入れる(/ や ~ など)。囲いの中からどこへでも書けるようになる'),
76
+ ('sandbox.failIfUnavailable', lambda v: v is False,
77
+ '囲いが使えない機でも、黙って囲いなしで動かす'),
78
+ ('sandbox.enableWeakerNestedSandbox', lambda v: v is True,
79
+ '弱い囲いで動かす'),
80
+ ('sandbox.enableWeakerNetworkIsolation', lambda v: v is True,
81
+ '通信の囲いを弱める'),
82
+ ('sandbox.excludedCommands', lambda v: isinstance(v, list) and len(v) > 0,
83
+ '名前を挙げたコマンドを、いつも囲いの外で動かす'),
84
+ ('sandbox.network.allowedDomains', lambda v: isinstance(v, list) and '*' in v,
85
+ 'すべての宛先への通信を許す("*")'),
86
+ ('sandbox.network.allowAllUnixSockets', lambda v: v is True,
87
+ 'すべての Unix ソケットへの接続を許す'),
88
+ ('sandbox.credentials.allowPlaintextInject', lambda v: v is True,
89
+ '隠した鍵を暗号化なしの通信にも差し込む'),
90
+ ('permissions.defaultMode', lambda v: v == 'bypassPermissions',
91
+ '許可の確認をすべて飛ばす状態で起動する'),
92
+ ]
93
+
94
+
95
+ def audit(settings):
96
+ """安全を下げる明示の一覧を返す((項目, 理由) のリスト)。"""
97
+ found = []
98
+ for key, lowers, why in RULES:
99
+ v = _get(settings, key)
100
+ if v is not _MISSING and lowers(v):
101
+ found.append((key, why))
102
+ return found
103
+
104
+
105
+ def main(argv):
106
+ if not argv:
107
+ print('使い方: managed-settings-audit.py <設定ファイル> [...]', file=sys.stderr)
108
+ return 2
109
+ worst = 0
110
+ for p in argv:
111
+ try:
112
+ with open(p, encoding='utf-8') as f:
113
+ d = json.load(f)
114
+ except (OSError, ValueError) as e:
115
+ print(f'NG {p}: 読めない/JSON でない({type(e).__name__})。この管理設定では Claude Code が起動しない')
116
+ worst = max(worst, 2)
117
+ continue
118
+ if not isinstance(d, dict):
119
+ print(f'NG {p}: 最上位がオブジェクトでない。この管理設定では Claude Code が起動しない')
120
+ worst = max(worst, 2)
121
+ continue
122
+ found = audit(d)
123
+ if not found:
124
+ print(f'OK {p}: 安全を下げる明示なし')
125
+ continue
126
+ worst = max(worst, 1)
127
+ for key, why in found:
128
+ print(f'NG {p}: {key} … {why}')
129
+ return worst
130
+
131
+
132
+ if __name__ == '__main__':
133
+ sys.exit(main(sys.argv[1:]))