@tyhld/conductor 0.12.120 → 0.12.121

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.121",
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",
@@ -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:]))