@tyhld/conductor 0.12.135 → 0.12.137
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/autoupdate.js +286 -4
- package/dist/rollback-target.js +315 -0
- package/package.json +1 -1
- package/scripts/hooks/README.md +68 -0
- package/scripts/hooks/policy.py +107 -37
- package/scripts/hooks/skill_sync_notify.py +13 -0
- package/scripts/hooks/test_search_word_not_path.py +339 -0
- package/skills/conductor-craftsman/SKILL.md +1 -0
|
@@ -0,0 +1,315 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 版を戻すときの「戻し先の選び方」と、戻した後の「そろっているかの確かめ」(便 8a405f97)。
|
|
3
|
+
*
|
|
4
|
+
* 【なぜ要るか(実地 FshimaNP・便 eaea5f68 の重大発見1)】
|
|
5
|
+
* 先行機は 0.12.134 の自己診断が落ちて 0.12.126 へ戻った。ところが戻し先の 0.12.126 にも
|
|
6
|
+
* 管制の「疑い(suspect)」の印が付いていたため、番人の同期(update-guard.sh の ①-src)が
|
|
7
|
+
* 1バイトも配らず、~/.tyhld/hooks の番人は 0.12.134 のまま残った。
|
|
8
|
+
* =★本体だけ戻って番人が戻らない組み合わせができ、自己診断は戻した後も同じ所で落ち続けた。
|
|
9
|
+
* 戻し先は state.json の `from`(入れ替える前に入っていた版)を【無条件に】使っていたので、
|
|
10
|
+
* 印の付いた版・誰も通していない版へ黙って戻ることができた。
|
|
11
|
+
*
|
|
12
|
+
* 【決め(けいさん指示 2026-10-11)】
|
|
13
|
+
* ① 戻し先は【確認済みの版】からだけ選ぶ。確認済み=管制の段階配布の記録で
|
|
14
|
+
* ・先行機か後続機の自己診断 PASS が在り
|
|
15
|
+
* ・その版で番人に関わる項目も PASS していて
|
|
16
|
+
* ・「疑い(suspect)」「不具合(bad)」の印が無い
|
|
17
|
+
* 版。★「疑いの印が無い」だけでは選ばない(印が無い版には「まだ誰も通していない版」も含まれる)。
|
|
18
|
+
* ② 記録を読めない・条件に合う版が1つも無い → 戻し先は null(=戻さない)。呼び手が配布を止める。
|
|
19
|
+
* ③ 戻した後は、本体・番人・呼び出す設定が同じ版でそろっているかを【実物】で確かめる。
|
|
20
|
+
* 版の自己申告(控えの version=)だけに頼らず、置かれている番人の中身を配布物と
|
|
21
|
+
* 1バイト単位で見比べる=「配ったつもり」を通さない。
|
|
22
|
+
*
|
|
23
|
+
* 【ここに番人の一覧を写さない】
|
|
24
|
+
* 配る中身の正本は update-guard.sh の INSTALL_FILES 1か所だけ(便 b649d1f8 の根治)。
|
|
25
|
+
* 見比べるのは「置かれている物のうち、配布物に同じ名前が在る物」だけなので、
|
|
26
|
+
* ここは番人のファイル名を1つも持たない(番人が増えても直さなくてよい)。
|
|
27
|
+
*/
|
|
28
|
+
import { readFileSync, readdirSync, statSync } from 'node:fs';
|
|
29
|
+
import path from 'node:path';
|
|
30
|
+
import { compareVersions } from './headless.js';
|
|
31
|
+
const SEMVER = /^\d+\.\d+\.\d+$/;
|
|
32
|
+
/** 管制の「確認済みの版」の口(★読むだけ・この機の状態は1バイトも動かさない)。 */
|
|
33
|
+
export const VERIFIED_VERSIONS_PATH = '/api/conductor/machines/verified-versions';
|
|
34
|
+
const FLAGS = ['ok', 'suspect', 'bad', 'unknown'];
|
|
35
|
+
/**
|
|
36
|
+
* 管制の答えを読む。★形が違う・欄が足りない → null(=「分からない」。戻さない側へ倒す)。
|
|
37
|
+
* 版ごとの欄は、1つでも欠けていれば「確認済みではない」側へ倒す(=== true で見る)。
|
|
38
|
+
*/
|
|
39
|
+
export function parseVerifiedVersions(body) {
|
|
40
|
+
if (typeof body !== 'object' || body === null)
|
|
41
|
+
return null;
|
|
42
|
+
const list = body.versions;
|
|
43
|
+
if (!Array.isArray(list))
|
|
44
|
+
return null;
|
|
45
|
+
const out = [];
|
|
46
|
+
for (const raw of list) {
|
|
47
|
+
if (typeof raw !== 'object' || raw === null)
|
|
48
|
+
continue;
|
|
49
|
+
const r = raw;
|
|
50
|
+
const version = typeof r.version === 'string' ? r.version.trim() : '';
|
|
51
|
+
if (!SEMVER.test(version))
|
|
52
|
+
continue;
|
|
53
|
+
const flag = FLAGS.includes(r.flag) ? r.flag : 'unknown';
|
|
54
|
+
out.push({
|
|
55
|
+
version,
|
|
56
|
+
selfcheckPass: r.selfcheckPass === true,
|
|
57
|
+
guardPass: r.guardPass === true,
|
|
58
|
+
flag,
|
|
59
|
+
machine: typeof r.machine === 'string' ? r.machine : null,
|
|
60
|
+
at: typeof r.at === 'string' ? r.at : null,
|
|
61
|
+
});
|
|
62
|
+
}
|
|
63
|
+
return out;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* その版は【確認済み】か。
|
|
67
|
+
* ★3つ全部が要る:自己診断 PASS の記録/番人の項目も PASS/疑い・不具合の印が無い。
|
|
68
|
+
* ★「印が無い」だけでは通さない(まだ誰も通していない版と区別がつかない)。
|
|
69
|
+
*/
|
|
70
|
+
export function isVerified(r) {
|
|
71
|
+
if (!r.selfcheckPass || !r.guardPass)
|
|
72
|
+
return false;
|
|
73
|
+
return r.flag !== 'suspect' && r.flag !== 'bad';
|
|
74
|
+
}
|
|
75
|
+
/** 確認済みでない理由を1つの短い語で(★記録に残して、あとから何が足りなかったか読めるようにする)。 */
|
|
76
|
+
function whyNotVerified(r) {
|
|
77
|
+
if (r.flag === 'suspect' || r.flag === 'bad')
|
|
78
|
+
return `${r.version}=${r.flag === 'bad' ? '不具合の印' : '疑いの印'}`;
|
|
79
|
+
if (!r.selfcheckPass)
|
|
80
|
+
return `${r.version}=自己診断 PASS の記録が無い`;
|
|
81
|
+
return `${r.version}=番人の項目の PASS が無い`;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* 戻し先を選ぶ。★確認済みの版からだけ選ぶ。
|
|
85
|
+
* failing … いま落ちた版(これより古い確認済みの版だけを候補にする。null=新旧を見ない)
|
|
86
|
+
* excluded … この機で自己診断が通らなかった版(state.json の failedVersions)
|
|
87
|
+
* 選ぶのは候補のうち【いちばん新しい版】(落ちた版のすぐ下の、通ったことが分かっている版)。
|
|
88
|
+
*/
|
|
89
|
+
export function pickRollbackTarget(records, o = {}) {
|
|
90
|
+
if (records === null) {
|
|
91
|
+
return { version: null, reason: '管制の確認済みの版の記録を読めません', seen: 0, verified: 0 };
|
|
92
|
+
}
|
|
93
|
+
const excluded = o.excluded ?? [];
|
|
94
|
+
const verified = records.filter(isVerified);
|
|
95
|
+
const notVerified = records.filter((r) => !isVerified(r));
|
|
96
|
+
const usable = verified
|
|
97
|
+
.filter((r) => r.version !== o.failing)
|
|
98
|
+
.filter((r) => !excluded.includes(r.version))
|
|
99
|
+
.filter((r) => (o.failing ? compareVersions(r.version, o.failing) < 0 : true))
|
|
100
|
+
.sort((a, b) => compareVersions(b.version, a.version));
|
|
101
|
+
const seen = records.length;
|
|
102
|
+
if (usable.length === 0) {
|
|
103
|
+
const why = [
|
|
104
|
+
`管制が返した版 ${seen} 件のうち確認済みは ${verified.length} 件`,
|
|
105
|
+
notVerified.length > 0 ? `選べない版: ${notVerified.map(whyNotVerified).join('/')}` : '',
|
|
106
|
+
excluded.length > 0 ? `この機で通らなかった版: ${excluded.join(',')}` : '',
|
|
107
|
+
o.failing ? `落ちた版 ${o.failing} より古い確認済みの版が1つもありません` : '',
|
|
108
|
+
].filter((s) => s !== '');
|
|
109
|
+
return { version: null, reason: `条件に合う戻し先がありません(${why.join('・')})`, seen, verified: verified.length };
|
|
110
|
+
}
|
|
111
|
+
const got = usable[0];
|
|
112
|
+
return {
|
|
113
|
+
version: got.version,
|
|
114
|
+
reason: `戻し先に確認済みの版 ${got.version} を選びました` +
|
|
115
|
+
`(自己診断 PASS・番人の項目も PASS・印 ${got.flag}` +
|
|
116
|
+
`${got.machine ? `・記録は ${got.machine}` : ''}${got.at ? `・${got.at}` : ''})`,
|
|
117
|
+
seen,
|
|
118
|
+
verified: verified.length,
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
122
|
+
// そろっているかの確かめ(本体・番人・呼び出す設定)
|
|
123
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
124
|
+
/** 番人の置き場(★update-guard.sh の GUARD_HOME と同じ決め方)。 */
|
|
125
|
+
export function guardHomeDir(home) {
|
|
126
|
+
return path.join(home, '.tyhld', 'hooks');
|
|
127
|
+
}
|
|
128
|
+
/** 番人の正本(配布物の中)。 */
|
|
129
|
+
export function guardSourceDir(distRoot) {
|
|
130
|
+
return path.join(distRoot, 'scripts', 'hooks');
|
|
131
|
+
}
|
|
132
|
+
/** 番人を配った側の控え(update-guard.sh の DIST_LAST)。 */
|
|
133
|
+
export function guardDistRecordPath(home) {
|
|
134
|
+
return path.join(guardHomeDir(home), 'dist-source.last');
|
|
135
|
+
}
|
|
136
|
+
/** 呼び出す設定(★番人の唯一の登録場所=update-guard.sh の ①-e と同じ場所)。 */
|
|
137
|
+
export function hookSettingsPath(home) {
|
|
138
|
+
return path.join(home, '.claude', 'settings.json');
|
|
139
|
+
}
|
|
140
|
+
/** 控えの1行(`<時刻> key=value …`)を読む。読めなければ空。 */
|
|
141
|
+
export function readKvLine(file) {
|
|
142
|
+
try {
|
|
143
|
+
const line = (readFileSync(file, 'utf8').split('\n')[0] ?? '').trim();
|
|
144
|
+
const out = {};
|
|
145
|
+
for (const p of line.split(' ').slice(1)) {
|
|
146
|
+
const i = p.indexOf('=');
|
|
147
|
+
if (i > 0)
|
|
148
|
+
out[p.slice(0, i)] = p.slice(i + 1);
|
|
149
|
+
}
|
|
150
|
+
return out;
|
|
151
|
+
}
|
|
152
|
+
catch {
|
|
153
|
+
return {};
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
/** 控えの1行をそのまま(同期が走ったかを見分けるための印)。読めなければ空文字。 */
|
|
157
|
+
export function readRawLine(file) {
|
|
158
|
+
try {
|
|
159
|
+
return (readFileSync(file, 'utf8').split('\n')[0] ?? '').trim();
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
return '';
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
function sameBytes(a, b) {
|
|
166
|
+
try {
|
|
167
|
+
return readFileSync(a).equals(readFileSync(b));
|
|
168
|
+
}
|
|
169
|
+
catch {
|
|
170
|
+
return false;
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
function readJson(file) {
|
|
174
|
+
try {
|
|
175
|
+
const got = JSON.parse(readFileSync(file, 'utf8'));
|
|
176
|
+
return typeof got === 'object' && got !== null ? got : null;
|
|
177
|
+
}
|
|
178
|
+
catch {
|
|
179
|
+
return null;
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
/** hooks の節から、登録されている命令を全部取り出す(イベント名つき)。 */
|
|
183
|
+
function hookCommands(hooks) {
|
|
184
|
+
const out = [];
|
|
185
|
+
if (typeof hooks !== 'object' || hooks === null)
|
|
186
|
+
return out;
|
|
187
|
+
for (const [event, groups] of Object.entries(hooks)) {
|
|
188
|
+
if (!Array.isArray(groups))
|
|
189
|
+
continue;
|
|
190
|
+
for (const g of groups) {
|
|
191
|
+
if (typeof g !== 'object' || g === null)
|
|
192
|
+
continue;
|
|
193
|
+
const entries = g.hooks;
|
|
194
|
+
if (!Array.isArray(entries))
|
|
195
|
+
continue;
|
|
196
|
+
for (const h of entries) {
|
|
197
|
+
if (typeof h !== 'object' || h === null)
|
|
198
|
+
continue;
|
|
199
|
+
const cmd = h.command;
|
|
200
|
+
if (typeof cmd === 'string' && cmd.trim() !== '')
|
|
201
|
+
out.push({ event, command: cmd.trim() });
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
return out;
|
|
206
|
+
}
|
|
207
|
+
/** 命令の最後の語(=呼ばれる台本のパス)。 */
|
|
208
|
+
function lastWord(command) {
|
|
209
|
+
const parts = command.split(/\s+/);
|
|
210
|
+
return parts[parts.length - 1] ?? '';
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* 呼び出す設定(ホームの hooks 登録)が、本体の版と合っているか。
|
|
214
|
+
* ① 配布物の見本(settings.sample.json)が要るイベントが、全部登録されている
|
|
215
|
+
* (=新しい入口が登録漏れになっていない)
|
|
216
|
+
* ② 番人の置き場を指す登録は、その版の配布物に【在る】台本だけを指している
|
|
217
|
+
* (=戻した版に無い入口を呼んでいない。呼ぶと番人が読めず止まる)
|
|
218
|
+
* ★読めない・見本が無い → false(フェイルクローズ=合っていると言わない)。
|
|
219
|
+
*/
|
|
220
|
+
export function checkHookSettings(home, distRoot) {
|
|
221
|
+
const sample = readJson(path.join(guardSourceDir(distRoot), 'settings.sample.json'));
|
|
222
|
+
const sampleHooks = sample === null ? null : sample.hooks;
|
|
223
|
+
if (typeof sampleHooks !== 'object' || sampleHooks === null || Object.keys(sampleHooks).length === 0) {
|
|
224
|
+
return { ok: false, detail: '配布物の見本(settings.sample.json)の hooks を読めません' };
|
|
225
|
+
}
|
|
226
|
+
const dst = readJson(hookSettingsPath(home));
|
|
227
|
+
if (dst === null) {
|
|
228
|
+
return { ok: false, detail: `呼び出す設定を読めません(${hookSettingsPath(home)})` };
|
|
229
|
+
}
|
|
230
|
+
const got = hookCommands(dst.hooks);
|
|
231
|
+
const wantEvents = Object.keys(sampleHooks).sort();
|
|
232
|
+
const missing = wantEvents.filter((ev) => !got.some((c) => c.event === ev));
|
|
233
|
+
if (missing.length > 0) {
|
|
234
|
+
return { ok: false, detail: `呼び出す設定に登録が無いイベント: ${missing.join(',')}(この版の見本が要る口)` };
|
|
235
|
+
}
|
|
236
|
+
const guardHome = guardHomeDir(home);
|
|
237
|
+
const srcDir = guardSourceDir(distRoot);
|
|
238
|
+
const stale = [];
|
|
239
|
+
for (const c of got) {
|
|
240
|
+
const target = lastWord(c.command);
|
|
241
|
+
if (path.dirname(target) !== guardHome)
|
|
242
|
+
continue; // 番人の置き場を指していない登録(顧客の独自フック)は見ない
|
|
243
|
+
const name = path.basename(target);
|
|
244
|
+
const inSrc = sameBytes(target, path.join(srcDir, name));
|
|
245
|
+
if (!inSrc)
|
|
246
|
+
stale.push(`${c.event}:${name}`);
|
|
247
|
+
}
|
|
248
|
+
if (stale.length > 0) {
|
|
249
|
+
return {
|
|
250
|
+
ok: false,
|
|
251
|
+
detail: `呼び出す設定が、本体の版と違う(または無い)番人を指しています: ${stale.join(',')}`,
|
|
252
|
+
};
|
|
253
|
+
}
|
|
254
|
+
return { ok: true, detail: `呼び出す設定は本体の版に合っています(イベント ${wantEvents.join(',')})` };
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* 本体・番人・呼び出す設定が同じ版でそろっているか(★実物を見る)。
|
|
258
|
+
* 番人は「置かれている物のうち、配布物に同じ名前が在る物」を1バイト単位で見比べる
|
|
259
|
+
* (=番人の一覧をここに持たない)。1つでも違えば、そろっていない。
|
|
260
|
+
*/
|
|
261
|
+
export function checkAlignment(o) {
|
|
262
|
+
const { home, distRoot, body } = o;
|
|
263
|
+
const guardHome = guardHomeDir(home);
|
|
264
|
+
const srcDir = guardSourceDir(distRoot);
|
|
265
|
+
if (body === null) {
|
|
266
|
+
return { ok: false, body: null, guard: null, settings: null, detail: '本体の版を読めません' };
|
|
267
|
+
}
|
|
268
|
+
let placed = [];
|
|
269
|
+
try {
|
|
270
|
+
placed = readdirSync(guardHome);
|
|
271
|
+
}
|
|
272
|
+
catch {
|
|
273
|
+
placed = [];
|
|
274
|
+
}
|
|
275
|
+
const shared = placed.filter((n) => {
|
|
276
|
+
try {
|
|
277
|
+
return statSync(path.join(guardHome, n)).isFile() && statSync(path.join(srcDir, n)).isFile();
|
|
278
|
+
}
|
|
279
|
+
catch {
|
|
280
|
+
return false;
|
|
281
|
+
}
|
|
282
|
+
});
|
|
283
|
+
if (shared.length === 0) {
|
|
284
|
+
// 番人が置かれていないPC(そろえる対象が無い)。★ここから番人を新しく置く道は1本も無い。
|
|
285
|
+
return {
|
|
286
|
+
ok: true,
|
|
287
|
+
body,
|
|
288
|
+
guard: null,
|
|
289
|
+
settings: null,
|
|
290
|
+
detail: `本体 ${body}/番人はこのPCに置かれていないので、そろえる対象がありません`,
|
|
291
|
+
};
|
|
292
|
+
}
|
|
293
|
+
const diff = shared.filter((n) => !sameBytes(path.join(guardHome, n), path.join(srcDir, n)));
|
|
294
|
+
const rec = readKvLine(guardDistRecordPath(home));
|
|
295
|
+
const recNote = rec.status
|
|
296
|
+
? `番人を配った控え: status=${rec.status} reason=${rec.reason ?? '不明'} version=${rec.version ?? '不明'}`
|
|
297
|
+
: '番人を配った控えがありません';
|
|
298
|
+
if (diff.length > 0) {
|
|
299
|
+
return {
|
|
300
|
+
ok: false,
|
|
301
|
+
body,
|
|
302
|
+
guard: false,
|
|
303
|
+
settings: null,
|
|
304
|
+
detail: `本体 ${body} と置かれている番人が違います(${diff.length}/${shared.length} 件ちがう: ${diff.slice(0, 5).join(',')})。${recNote}`,
|
|
305
|
+
};
|
|
306
|
+
}
|
|
307
|
+
const s = checkHookSettings(home, distRoot);
|
|
308
|
+
return {
|
|
309
|
+
ok: s.ok,
|
|
310
|
+
body,
|
|
311
|
+
guard: true,
|
|
312
|
+
settings: s.ok,
|
|
313
|
+
detail: `本体 ${body}/番人は本体と同じ中身(${shared.length} 件)/${s.detail}。${recNote}`,
|
|
314
|
+
};
|
|
315
|
+
}
|
package/package.json
CHANGED
package/scripts/hooks/README.md
CHANGED
|
@@ -579,6 +579,74 @@ TYHLD-platform の2便が、**読むだけの検索**で同じ `danger` に止
|
|
|
579
579
|
- **番人が古い機体では効きません。** 各PCで人が1回配布を流すまで、その機では今までどおりです
|
|
580
580
|
(この機で実地2便が止まったときの版は **0.12.123**=理由の文に倒した旨の注が無い版でした)。
|
|
581
581
|
|
|
582
|
+
## 1-11. ★探す言葉をパスとして測らない(便 18e9e32e・2026-10-11)
|
|
583
|
+
|
|
584
|
+
### なぜ要るか(実地 便 3f54ac4a・作業が0件で終わった)
|
|
585
|
+
|
|
586
|
+
名指しした普通の TypeScript **1ファイル**を読むだけの検索が `danger` で止められ、便が作業0件で
|
|
587
|
+
終わりました(職人は便の定めどおり正しく停止=回避していません)。
|
|
588
|
+
0.12.133 から `danger` の後は便の残りが止まる(1-9)ので、**読み違い1回で便が丸ごと止まります**。
|
|
589
|
+
|
|
590
|
+
- 止められた形 … `<検索の道具> -n 'env: <.env で終わって見える語>\|home:\|…' <名指しのファイル> | head -20`
|
|
591
|
+
- 番人の文 … `danger: secret file (<その語>) touched by <検索の道具>`
|
|
592
|
+
|
|
593
|
+
**原因は2つあり、どちらも「探す言葉(検索の語)をパスとして測った」結果でした**(使い捨ての場所の
|
|
594
|
+
写しの番人で、origin/main・0.12.132・0.12.124 の3版に当てて再現。3版とも同じでした)。
|
|
595
|
+
|
|
596
|
+
1. **探す言葉に【空白】と【当て字の縦棒】の両方が入ると、探す言葉が2語以上に割れていた。**
|
|
597
|
+
止める側の区切りは引用符の中でも機械的に割る(便 ad6b5db9・**正しい設計**)ので切れ端ができ、
|
|
598
|
+
クォートが壊れた切れ端では語の割り方が素朴分割へ倒れます(`tokens_of`)。
|
|
599
|
+
旧い読み方は**最初の1語だけ**を探す文字として外していたので、**2語目以降がパスとして測られ**、
|
|
600
|
+
`.env` で終わって見える語が秘密のファイルに当たっていました。
|
|
601
|
+
2. **`-e` / `--regexp` で探す言葉を明示すると、その【値】までパスとして測られていた。**
|
|
602
|
+
旧い読み方は「探す文字は旗で示されている=引数はすべてパス」として**1つも外さなかった**ため、
|
|
603
|
+
`-e` の値そのものが名前として測られていました(文は `secret file (env: <その語>)`)。
|
|
604
|
+
|
|
605
|
+
### どう直したか(判定の正本は `policy.py` の `pattern_arg_positions`)
|
|
606
|
+
|
|
607
|
+
- **探す文字の位置を「1つ」から「全部」へ**改めました(`pattern_arg_index` → `pattern_arg_positions`)。
|
|
608
|
+
外すのは探す文字だけで、**名指しのパスは1つも外しません**。
|
|
609
|
+
- **`-e` / `--regexp` の値は探す文字として外します**(原因②)。★そのとき、旗(-)でない最初の引数は
|
|
610
|
+
今までどおり**パス**として測ります(取りこぼさない)。
|
|
611
|
+
- **クォートが壊れて割れた探す言葉は、引用符が閉じるまでの語を続きとして外します**
|
|
612
|
+
(`_pattern_word_positions`・原因①)。★**最初の語が引用符そのもので始まるときだけ**です
|
|
613
|
+
(語の割り方が正しいときは引用符が剥がされているので当たりません=探す言葉の途中に引用符が1つ入る
|
|
614
|
+
形(`-rn "it's" <フォルダ>`)で名指しの場所を巻き込まない)。
|
|
615
|
+
- ★**止める側は1件も減りません。** クォートが壊れた切れ端は、同じ命令を**本物の区切り**
|
|
616
|
+
(引用符を守る割り方)でも必ず測り直すので(`_real_segments`・便 2.5)、
|
|
617
|
+
`<検索の道具> -n 'a\|b' <秘密のファイル>` のような形は、そちらで今までどおり止まります。
|
|
618
|
+
- ★**秘密として扱う名前の判定・読み書き持ち出しの動詞の一覧は1文字も変えていません。**
|
|
619
|
+
`-f` / `--file`(探す文字が書いてあるファイル)が在るときは、**今までどおり1つも外しません**。
|
|
620
|
+
|
|
621
|
+
### 止める/通す(実測・★止まる→通るは「探す言葉の読み違いの形」だけ)
|
|
622
|
+
|
|
623
|
+
| # | 形 | 判定 | 理由 |
|
|
624
|
+
| --- | --- | --- | --- |
|
|
625
|
+
| 通1 | `<検索の道具> -n 'env: <語>\|home:' <名指しのファイル>` | **通す**(前は止まっていた) | 探す言葉はパスではない |
|
|
626
|
+
| 通2 | 同じ形で**名指しのフォルダ**・隠しも読む旗つき・別の道具 | **通す**(同) | 同 |
|
|
627
|
+
| 通3 | `<検索の道具> -n -e 'env: <語>' -e 'home:' <名指しのファイル>` | **通す**(同) | `-e` の値は探す言葉 |
|
|
628
|
+
| 通4 | `--regexp=<語>` / `--regexp <語>` | **通す**(同) | 同 |
|
|
629
|
+
| 通5 | `<検索の道具> -rn "it's" <実在のフォルダ>` | **通す**(前も通る) | 途中の引用符では続きを外さない |
|
|
630
|
+
| 止1 | `<検索の道具> -n '語' <秘密の名前のファイル>` | **danger** | 名指しの先が秘密 |
|
|
631
|
+
| 止2 | `<検索の道具> -n -e '語' <秘密の名前のファイル>` | **danger** | 名指しのパスは外さない |
|
|
632
|
+
| 止3 | 割れた探す言葉+**秘密のファイルを名指し** | **danger** | 本物の区切りの側で止まる |
|
|
633
|
+
| 止4 | `-f` / `--file` の値が秘密のファイル | **danger** | 探す文字が書いてあるファイル=パス |
|
|
634
|
+
| 止5 | 場所を1つも書かない(`-e` つきを含む) | **danger** | 作業場所として判定(前からの安全側) |
|
|
635
|
+
| 止6 | 秘密を含むフォルダを名指し(`-e` つきを含む) | **danger** | 探した場所の中に秘密が在る |
|
|
636
|
+
| 止7 | この形と、同じ行の危険(秘密の読み・強い上書きの push ほか) | **danger** | ほかの判定が先に当たる |
|
|
637
|
+
|
|
638
|
+
直す前(`f02ecc6`=0.12.135)と後を**67形**で突き合わせ、**変わらない47/★止まる→通る16(上の通1〜通4の
|
|
639
|
+
仲間だけ)/通る→止まる0件/判定は同じで理由だけ正確になった4**でした。
|
|
640
|
+
既存の番人の試験(`test_*.py` 36本)は**1本も落ちていません**。
|
|
641
|
+
|
|
642
|
+
### 分かっている限界
|
|
643
|
+
|
|
644
|
+
- **`$'…'` のような引用符で始まらない書き方で割れた探す言葉は、今までどおりパスとして測られます**
|
|
645
|
+
(最初の語が引用符そのものでないと続きを外さないため。この便の原因として確かめられた形ではないので
|
|
646
|
+
触っていません。足すなら別便で、同じやり方=再現 → 直す → 突き合わせ で足せます)。
|
|
647
|
+
- **`-f` / `--file` と `-e` が混ざった形では、1つも外しません**(安全側に倒したまま)。
|
|
648
|
+
- **番人が古い機体では効きません。** 各PCで人が1回配布を流すまで、その機では今までどおりです。
|
|
649
|
+
|
|
582
650
|
## 2. ファイルの役割
|
|
583
651
|
|
|
584
652
|
| ファイル | 役割 |
|
package/scripts/hooks/policy.py
CHANGED
|
@@ -876,32 +876,92 @@ EXFIL_VERBS = frozenset({
|
|
|
876
876
|
# ★探す文字はパスではない。パスとして測ると、コードの書き方を調べる普通の作業が止まる。
|
|
877
877
|
# 【どう決めるか】この動詞では、旗(-)でない最初の引数を【探す文字】として扱い、
|
|
878
878
|
# パスの判定に掛けない。残りの引数は今までどおりパスとして測る。
|
|
879
|
-
# ★-e / --regexp
|
|
880
|
-
#
|
|
879
|
+
# ★-e / --regexp で探す文字を明示したときは、その【値】を探す文字として外し、
|
|
880
|
+
# 旗(-)でない最初の引数は【パス】に戻す(取りこぼさない・便 18e9e32e の原因②)。
|
|
881
|
+
# ★-f / --file の値は「探す文字が書いてあるファイル」=パスなので、1つも外さない。
|
|
881
882
|
_PATTERN_FIRST_VERBS = frozenset({'grep', 'egrep', 'fgrep', 'rg', 'ag', 'ack', 'ugrep'})
|
|
882
883
|
|
|
883
|
-
#
|
|
884
|
+
# 探す文字を旗で明示する書き方(これが在れば、最初の引数はパスに戻る)。
|
|
884
885
|
_PATTERN_FLAGS = ('-e', '--regexp')
|
|
885
886
|
# 「探す文字が書いてあるファイル」を指す旗(値はパスとして測る)。
|
|
886
887
|
_PATTERN_FILE_FLAGS = ('-f', '--file')
|
|
887
888
|
|
|
888
889
|
|
|
889
|
-
def
|
|
890
|
-
"""
|
|
890
|
+
def _pattern_word_positions(args, first: int, word=None):
|
|
891
|
+
"""探す文字の語の位置を返す(引用符が壊れて空白で割られた続きも含める)。
|
|
891
892
|
|
|
892
|
-
|
|
893
|
+
★word を渡せば、引用符の開き具合をその字面で見る(`--regexp=<探す文字>` のように
|
|
894
|
+
旗に埋まった形で、旗の部分を除いた値だけを見るため)。
|
|
895
|
+
|
|
896
|
+
【なぜ要るか(実測 便 18e9e32e・2026-10-11/実地 便 3f54ac4a)】
|
|
897
|
+
止める側の区切り(split_segments)は引用符の中でも機械的に割る(便 ad6b5db9・正しい設計)。
|
|
898
|
+
そのため探す言葉に【空白】と【当て字の縦棒】の両方が入った形
|
|
899
|
+
<検索の道具> -n 'env: <.env で終わって見える語>\\|home:' <名指しのファイル>
|
|
900
|
+
は `'env: <その語>\\` という切れ端になり、クォートが壊れているので tokens_of が
|
|
901
|
+
素朴分割へ倒れて、**1つの探す言葉が2つ以上の語に割れる**。
|
|
902
|
+
旧い読み方は【最初の1語だけ】を探す文字として外していたので、2語目以降が
|
|
903
|
+
パスとして測られ、`.env` で終わって見える語が秘密のファイルに当たって
|
|
904
|
+
読むだけの検索が danger で止まっていた(実地 便 3f54ac4a で便が丸ごと止まった)。
|
|
905
|
+
|
|
906
|
+
【どう使うか】最初の語が【引用符そのもので始まり、しかもその引用符が閉じていない】ときだけ、
|
|
907
|
+
その引用符が閉じるまでの語を同じ探す文字の続きとして外す。
|
|
908
|
+
★「引用符で始まる」を条件にするのが要点。語の割り方が正しいとき(shlex が通ったとき)は
|
|
909
|
+
引用符が剥がされているので、この条件には当たらない=続きを外さない。
|
|
910
|
+
これが無いと、探す言葉の【途中】に引用符が1つ入る形(`-rn "it's" <フォルダ>`)で
|
|
911
|
+
名指しのフォルダまで探す文字と見なし、作業場所に倒れてしまう(この便の測りで実測)。
|
|
912
|
+
★止める側は1件も減らない:クォートが壊れた切れ端は、同じ命令を本物の区切り
|
|
913
|
+
(split_commands・引用符を守る割り方)でも必ず測り直す(_real_segments・便 2.5)ので、
|
|
914
|
+
`<検索の道具> -n 'a\\|b' <秘密のファイル>` のような形は、そちらで今までどおり止まる。
|
|
915
|
+
★引用符が壊れていない(=語の割り方が正しい)ときは、最初の1語だけを外す
|
|
916
|
+
=これまでと同じ振る舞い。
|
|
917
|
+
"""
|
|
918
|
+
out = [first]
|
|
919
|
+
word = args[first] if word is None else word
|
|
920
|
+
if word[:1] not in ('"', "'"):
|
|
921
|
+
return out
|
|
922
|
+
quote = _open_quote(word)
|
|
923
|
+
i = first + 1
|
|
924
|
+
while quote and i < len(args):
|
|
925
|
+
out.append(i)
|
|
926
|
+
quote = _open_quote(args[i], quote)
|
|
927
|
+
i += 1
|
|
928
|
+
return out
|
|
929
|
+
|
|
930
|
+
|
|
931
|
+
def pattern_arg_positions(verb: str, args):
|
|
932
|
+
"""探す文字として扱う引数の位置を【全部】返す(無ければ空)。
|
|
933
|
+
|
|
934
|
+
★ここで返した位置だけをパスの判定から外す。それ以外は今までどおり全部測る。
|
|
935
|
+
★外すのは「探す文字」だけ:名指しのパス(-f / --file の値を含む)は1つも外さない。
|
|
893
936
|
"""
|
|
894
937
|
if verb not in _PATTERN_FIRST_VERBS:
|
|
895
|
-
return
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
938
|
+
return frozenset()
|
|
939
|
+
out = set()
|
|
940
|
+
explicit = False
|
|
941
|
+
i, n = 0, len(args)
|
|
942
|
+
while i < n:
|
|
943
|
+
t = args[i]
|
|
899
944
|
if t in _PATTERN_FILE_FLAGS or t.startswith('--file='):
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
if
|
|
903
|
-
|
|
904
|
-
|
|
945
|
+
# 探す文字はファイルに書いてある=引数はすべてパス。1つも外さない(安全側)。
|
|
946
|
+
return frozenset()
|
|
947
|
+
if t in _PATTERN_FLAGS:
|
|
948
|
+
explicit = True
|
|
949
|
+
if i + 1 < n:
|
|
950
|
+
# `-e 語` の値は探す文字(パスではない)。値も引用符の壊れで割れることがある。
|
|
951
|
+
out.update(_pattern_word_positions(args, i + 1))
|
|
952
|
+
i += 2
|
|
953
|
+
continue
|
|
954
|
+
elif t.startswith('--regexp='):
|
|
955
|
+
explicit = True
|
|
956
|
+
# `--regexp=語` は旗に探す文字が埋まっている(開き具合は `=` の後ろだけで見る)。
|
|
957
|
+
out.update(_pattern_word_positions(args, i, t.split('=', 1)[1]))
|
|
958
|
+
i += 1
|
|
959
|
+
if explicit:
|
|
960
|
+
return frozenset(out) # 探す文字は旗で示されている=最初の引数はパス
|
|
961
|
+
first = next((p for p, t in enumerate(args) if not t.startswith('-')), -1)
|
|
962
|
+
if first < 0:
|
|
963
|
+
return frozenset()
|
|
964
|
+
return frozenset(_pattern_word_positions(args, first))
|
|
905
965
|
|
|
906
966
|
|
|
907
967
|
# 「中身を読み出す」動詞(秘密に対して使われたら露出)。
|
|
@@ -1481,24 +1541,14 @@ def _search_excludes(args):
|
|
|
1481
1541
|
return [x.strip().strip('"').strip("'") for x in out if x]
|
|
1482
1542
|
|
|
1483
1543
|
|
|
1484
|
-
def
|
|
1485
|
-
"""
|
|
1486
|
-
|
|
1487
|
-
【なぜ要るか(実測 便 3be099ba・2026-10-10)】
|
|
1488
|
-
止める側の区切り(split_segments)は引用符の中でも機械的に割る(便 ad6b5db9・正しい設計)。
|
|
1489
|
-
そのため探す言葉に当て字の縦棒(`\\|`)を書いた形
|
|
1490
|
-
<検索の道具> -rn "a\\|b" <実在のフォルダ>
|
|
1491
|
-
は `"a\\` と `b" <実在のフォルダ>` に千切れ、**検索の道具の側に場所が1つも残らない**。
|
|
1492
|
-
すると「探す場所を書いていない」と読めてしまい、作業場所(リポの根)に倒れて
|
|
1493
|
-
根の秘密ファイルに当たり、読むだけの検索が danger で止まっていた(実地 便 3bbde2e3)。
|
|
1544
|
+
def _open_quote(text, quote=None):
|
|
1545
|
+
"""この字面を読み終えた時点で【開いたままの引用符】を返す(閉じていれば None)。
|
|
1494
1546
|
|
|
1495
|
-
|
|
1496
|
-
|
|
1497
|
-
|
|
1498
|
-
(`<検索の道具> -rn "a\\|b"` だけ)は、そちらで今までどおり作業場所として止まる。
|
|
1547
|
+
★quote に前の語の状態を渡せば、空白で割られた語をまたいで続きを読める
|
|
1548
|
+
(便 18e9e32e・_pattern_word_positions で使う)。
|
|
1549
|
+
★判定の中身は便 3be099ba の _quote_fragment と同じ(1文字も変えていない)。
|
|
1499
1550
|
"""
|
|
1500
|
-
text =
|
|
1501
|
-
quote = None
|
|
1551
|
+
text = text or ''
|
|
1502
1552
|
i, n = 0, len(text)
|
|
1503
1553
|
while i < n:
|
|
1504
1554
|
c = text[i]
|
|
@@ -1514,7 +1564,26 @@ def _quote_fragment(seg) -> bool:
|
|
|
1514
1564
|
i += 2
|
|
1515
1565
|
continue
|
|
1516
1566
|
i += 1
|
|
1517
|
-
return quote
|
|
1567
|
+
return quote
|
|
1568
|
+
|
|
1569
|
+
|
|
1570
|
+
def _quote_fragment(seg) -> bool:
|
|
1571
|
+
"""この区切りが【引用符の途中で千切れた切れ端】か(閉じていない引用符で終わる)。
|
|
1572
|
+
|
|
1573
|
+
【なぜ要るか(実測 便 3be099ba・2026-10-10)】
|
|
1574
|
+
止める側の区切り(split_segments)は引用符の中でも機械的に割る(便 ad6b5db9・正しい設計)。
|
|
1575
|
+
そのため探す言葉に当て字の縦棒(`\\|`)を書いた形
|
|
1576
|
+
<検索の道具> -rn "a\\|b" <実在のフォルダ>
|
|
1577
|
+
は `"a\\` と `b" <実在のフォルダ>` に千切れ、**検索の道具の側に場所が1つも残らない**。
|
|
1578
|
+
すると「探す場所を書いていない」と読めてしまい、作業場所(リポの根)に倒れて
|
|
1579
|
+
根の秘密ファイルに当たり、読むだけの検索が danger で止まっていた(実地 便 3bbde2e3)。
|
|
1580
|
+
|
|
1581
|
+
【どう使うか】切れ端では**作業場所に倒さない**(その切れ端だけでは場所が読めないため)。
|
|
1582
|
+
★止める側は1件も減らない:同じ命令は本物の区切り(split_commands・引用符を守る割り方)でも
|
|
1583
|
+
測り直すので(_real_segments)、場所を本当に書いていない形
|
|
1584
|
+
(`<検索の道具> -rn "a\\|b"` だけ)は、そちらで今までどおり作業場所として止まる。
|
|
1585
|
+
"""
|
|
1586
|
+
return _open_quote(seg) is not None
|
|
1518
1587
|
|
|
1519
1588
|
|
|
1520
1589
|
def _recursive_read_danger(verb: str, tokens, cwd=None, seg=None):
|
|
@@ -1559,12 +1628,12 @@ def _recursive_read_danger(verb: str, tokens, cwd=None, seg=None):
|
|
|
1559
1628
|
else:
|
|
1560
1629
|
return None
|
|
1561
1630
|
patterns = _search_excludes(args)
|
|
1562
|
-
|
|
1631
|
+
skips = pattern_arg_positions(verb, args) # 探す文字は【全部】パスの判定から外す
|
|
1563
1632
|
roots = []
|
|
1564
1633
|
files = []
|
|
1565
1634
|
named = 0
|
|
1566
1635
|
for pos, a in enumerate(args):
|
|
1567
|
-
if pos
|
|
1636
|
+
if pos in skips or a.startswith('-'):
|
|
1568
1637
|
continue
|
|
1569
1638
|
named += 1
|
|
1570
1639
|
d = _existing_dir(a, cwd)
|
|
@@ -3442,10 +3511,11 @@ def _secret_danger(segment: str, verb: str, tokens, cwd=None):
|
|
|
3442
3511
|
return 'secret environment variable exposure'
|
|
3443
3512
|
|
|
3444
3513
|
args = tokens[1:] if tokens else []
|
|
3445
|
-
# ★探す文字(grep の1
|
|
3446
|
-
|
|
3514
|
+
# ★探す文字(grep の1つ目の引数・-e / --regexp の値・引用符が壊れて割れた続き)は
|
|
3515
|
+
# パスではないので、パスの判定から外す(便 18e9e32e)。
|
|
3516
|
+
skips = pattern_arg_positions(verb, args)
|
|
3447
3517
|
for pos, raw in enumerate(args):
|
|
3448
|
-
if pos
|
|
3518
|
+
if pos in skips:
|
|
3449
3519
|
continue
|
|
3450
3520
|
# 値の書き方は色々ある: `.env` / `@.env`(curl -d @file)/ `--post-file=.env`。
|
|
3451
3521
|
# オプション名に埋まった値まで見ないと、持ち出しを1つ取りこぼす。
|
|
@@ -67,6 +67,13 @@ NOTICE_KINDS = {
|
|
|
67
67
|
'stopped': '常駐(配達と生存報告)と耳(指示の着信合図)を動かす采配くん本体が'
|
|
68
68
|
'見つからないため、起動を止めています。管制への配達が止まります。',
|
|
69
69
|
},
|
|
70
|
+
'rollback-halt': {
|
|
71
|
+
'key': 'rollback-no-verified-target',
|
|
72
|
+
'summary': '版を戻せないので人の判断待ちです',
|
|
73
|
+
'stopped': '自己診断が落ちた版から戻せる「確かめ済みの版」が無いため、'
|
|
74
|
+
'戻さずにこの PC の版の受け取りを止めています。'
|
|
75
|
+
'古い版・印の付いた版へ黙って戻ることはしません。',
|
|
76
|
+
},
|
|
70
77
|
'dist-source': {
|
|
71
78
|
'key': 'dist-source-unverified',
|
|
72
79
|
'summary': '安全装置を配れていません',
|
|
@@ -133,6 +140,12 @@ def recovery_steps(reason, home=None):
|
|
|
133
140
|
|
|
134
141
|
home … 自動更新の鍵を探す住まい(既定は実機の住まい。試験は使い捨てを渡す)。
|
|
135
142
|
"""
|
|
143
|
+
if reason in ('no-verified-target', 'not-aligned', 'selfcheck-failed'):
|
|
144
|
+
# ★版を戻せない(便 8a405f97)。この PC で打てる1行は無い=管制で人が決める。
|
|
145
|
+
# ここで update-guard.sh の案内を出すと、打っても直らない操作を人にさせてしまう。
|
|
146
|
+
return ['再開のしかた: 管制の「PCの状態」で、この PC の戻し先の版を人が決めてください'
|
|
147
|
+
'(確かめ済みの版が出れば、次の見直しで自動的にそろいます)。'
|
|
148
|
+
'この PC で打つ操作はありません。']
|
|
136
149
|
if reason in ('flagged-bad', 'flagged-suspect'):
|
|
137
150
|
# ★管制で不具合・疑いの印が付いた版(便 29babc5d)。入れ直しても同じ版なら直らない。
|
|
138
151
|
if autoupdate_enabled(home):
|