@tyhld/conductor 0.12.139 → 0.12.141

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.
@@ -39,6 +39,7 @@ import { fileURLToPath } from 'node:url';
39
39
  import { CLAUDE_MIN_VERSION, compareVersions, isProcessAlive, parseClaudeVersion, resolveClaudeBin, } from './headless.js';
40
40
  import { defaultExec, fetchClaudeStable, npmBesideNode, pickCandidates, selfcheckDir } from './selfcheck.js';
41
41
  import { VERIFIED_VERSIONS_PATH, checkAlignment, guardDistRecordPath, parseVerifiedVersions, pickRollbackTarget, readRawLine, } from './rollback-target.js';
42
+ import { alignUnitsAndKey, confirmUnitSwap, pendingUnitSwap, revertUnits } from './unit-sync.js';
42
43
  // ─────────────────────────────────────────────────────────────────────────────
43
44
  // 定数(★時間の値は設計 3ed9e2b2 の推奨値・管制の ROLLOUT_TIMES と同じ考え方)
44
45
  // ─────────────────────────────────────────────────────────────────────────────
@@ -444,6 +445,63 @@ async function waitGuardSync(d, before) {
444
445
  await d.sleep(GUARD_SYNC_POLL_MS);
445
446
  }
446
447
  }
448
+ /**
449
+ * 常駐の定義と部品置き場の鍵を、入っている配布物にそろえる(便 2f984935・中身は src/unit-sync.ts)。
450
+ * ★番人の同期の後・常駐の起こし直しの前に呼ぶ(起き直す常駐が新しい定義で起きる)。
451
+ * ★失敗しても入れ替えは止めない(記録に残すだけ)。
452
+ */
453
+ function alignUnits(d) {
454
+ const a = alignUnitsAndKey({ home: d.home, distRoot: d.distRoot, exec: d.exec, env: d.env });
455
+ for (const line of a.lines)
456
+ d.log(line);
457
+ return a;
458
+ }
459
+ /**
460
+ * 入れ替えた常駐の定義を控えへ戻し、daemon-reload を打つ(便 2f764c3b)。戻り: 戻したか。
461
+ * ★確かめ待ちが無ければ何もしない(false)。常駐の起こし直しは呼び出し側。
462
+ */
463
+ function revertUnitsLogged(d, why) {
464
+ const lines = [];
465
+ const back = revertUnits({ home: d.home, distRoot: d.distRoot, exec: d.exec }, why, lines);
466
+ for (const line of lines)
467
+ d.log(line);
468
+ return back.length > 0;
469
+ }
470
+ /** 入れ替えた常駐の定義が自己診断で確かめられた=控えを消す(便 2f764c3b)。 */
471
+ function confirmUnits(d) {
472
+ const names = confirmUnitSwap(d.home);
473
+ if (names.length > 0)
474
+ d.log(`入れ替えた常駐の定義を確かめました(${names.join(',')})。入れ替える前の控えを消しました`);
475
+ }
476
+ /**
477
+ * 常駐を起こし直す。★起き上がらなければ、入れ替えた常駐の定義を控えへ戻し、daemon-reload・起こし直しをする
478
+ * (便 2f764c3b)。戻り: 起こし直しが通ったか(戻した後に通っても false=入れ替えは落ちた)。
479
+ */
480
+ async function restartRelaysOrRevert(d, version) {
481
+ const r = await restartRelays(d, version);
482
+ d.log(r.detail);
483
+ if (r.ok)
484
+ return true;
485
+ if (revertUnitsLogged(d, '常駐が起き上がらなかった'))
486
+ d.log((await restartRelays(d, version)).detail);
487
+ return false;
488
+ }
489
+ /**
490
+ * 入れ替えた常駐の定義を、自己診断で確かめる(便 2f764c3b)。版を入れ替えない回で、定義だけを入れ替えたとき。
491
+ * 通れば控えを消す。落ちれば控えへ戻して daemon-reload を打つ。
492
+ * ★常駐の起こし直しはしない(呼び出し側が空きを確かめてから行う=走っている便を止めない)。
493
+ * 戻り: 記録に残す1行と、控えへ戻したか。
494
+ */
495
+ function verifyUnitsBySelfcheck(d) {
496
+ const r = d.runSelfcheck('after-conductor');
497
+ if (r.pass) {
498
+ confirmUnits(d);
499
+ return { line: '入れ替えた常駐の定義で自己診断が通りました', reverted: false };
500
+ }
501
+ const failed = r.failedKeys.join(',') || '不明';
502
+ const reverted = revertUnitsLogged(d, `入れ替えた後の自己診断が落ちた(${failed})`);
503
+ return { line: `入れ替えた常駐の定義で自己診断が落ちたので、入れ替える前の控えへ戻しました(${failed})`, reverted };
504
+ }
447
505
  /** 人の判断待ちの札の元になる控え(★更新係の置き場=職人は書けない)。 */
448
506
  export function rollbackHaltRecordPath(home) {
449
507
  return path.join(updaterDir(home), 'rollback-halt.last');
@@ -547,10 +605,10 @@ function relayUnits(d) {
547
605
  */
548
606
  async function restartRelays(d, version) {
549
607
  if (d.boot)
550
- return '起動時なので起こし直しません(常駐はこの後に新しい版で起きます)';
608
+ return { ok: true, detail: '起動時なので起こし直しません(常駐はこの後に新しい版で起きます)' };
551
609
  const units = relayUnits(d);
552
610
  if (units.length === 0)
553
- return '常駐がこの機にありません';
611
+ return { ok: true, detail: '常駐がこの機にありません' };
554
612
  d.exec('systemctl', ['--user', 'try-restart', '--no-block', ...units], { timeoutMs: 30_000 });
555
613
  const rt = path.join(d.home, '.tyhld', 'hooks', 'runtime-source.last');
556
614
  // ★待つ上限は回数で決める(時計が進まない形でも、いつまでも回らない)。
@@ -565,10 +623,10 @@ async function restartRelays(d, version) {
565
623
  // 控えが無い機もある
566
624
  }
567
625
  if (states.every((s) => s === 'active') && (rtVersion === '' || rtVersion === version)) {
568
- return `常駐 ${units.length} 本を起こし直しました(版 ${version})`;
626
+ return { ok: true, detail: `常駐 ${units.length} 本を起こし直しました(版 ${version})` };
569
627
  }
570
628
  if (i >= tries) {
571
- return `常駐 ${units.length} 本のうち立ち上がらない物があります(${states.join(',')}・控えの版 ${rtVersion || '無し'})`;
629
+ return { ok: false, detail: `常駐 ${units.length} 本のうち立ち上がらない物があります(${states.join(',')}・控えの版 ${rtVersion || '無し'})` };
572
630
  }
573
631
  await d.sleep(RESTART_POLL_MS);
574
632
  }
@@ -692,6 +750,8 @@ async function afterSwap(d, s) {
692
750
  const note = waited > 0 ? `(自己診断の前に ${waited}秒 待ちました)` : '';
693
751
  const r = d.runSelfcheck(trigger);
694
752
  if (r.pass) {
753
+ // ★入れ替えた常駐の定義も、この自己診断で確かめられた(控えを消す・便 2f764c3b)。
754
+ confirmUnits(d);
695
755
  // ★戻した回は、通っただけでは「戻した」としない(便 8a405f97)。
696
756
  // 本体・番人・呼び出す設定が同じ版でそろっていること、番人の項目が PASS していることを確かめる。
697
757
  if (s.rollback && comp === 'conductor') {
@@ -715,6 +775,13 @@ async function afterSwap(d, s) {
715
775
  return done(d, s, s.lastRun?.action === 'held' || s.lastRun?.action === 'halted' ? 'recovered' : 'pass', `${detail}${note}`);
716
776
  }
717
777
  const failed = r.failedKeys.join(',') || '不明';
778
+ // ★入れ替えた常駐の定義を、入れ替える前の控えへ戻す(便 2f764c3b)。
779
+ // 版も戻すときは、戻しの中で常駐を起こし直す。版を戻さないときは、ここで起こし直す(settle)。
780
+ const unitsBack = revertUnitsLogged(d, `入れ替えた後の自己診断が落ちた(${failed})`);
781
+ const settle = async () => {
782
+ if (unitsBack)
783
+ d.log((await restartRelays(d, readInstalledVersion(d.distRoot) ?? '')).detail);
784
+ };
718
785
  if (!s.rollback) {
719
786
  // ★前の版へ戻す(そのPCだけ)。
720
787
  // ★人にしかできない操作だけで落ちたときは、版の不具合と決めつけない(落ちた版の印を付けない)。
@@ -729,11 +796,14 @@ async function afterSwap(d, s) {
729
796
  const pick = await chooseRollbackTarget(d, s, s.to ?? null);
730
797
  d.log(pick.reason);
731
798
  if (!pick.version) {
799
+ await settle();
732
800
  return haltForHuman(d, s, 'no-verified-target', `${comp} ${s.to} の自己診断が落ちました(${failed})。${pick.reason}。戻しません${note}`, r.failedKeys);
733
801
  }
734
802
  d.log(`${comp} ${s.to} の自己診断が落ちました(${failed})。この機だけ ${pick.version} へ戻します`);
735
803
  return rollBack(d, s, pick.version);
736
804
  }
805
+ // ★Claude Code の戻しは常駐を起こし直さないので、戻した定義はここで起こし直す。
806
+ await settle();
737
807
  const back = s.from ?? null;
738
808
  if (comp === 'claude-code' && back && compareVersions(back, CLAUDE_MIN_VERSION) < 0) {
739
809
  s.phase = 'held';
@@ -749,6 +819,7 @@ async function afterSwap(d, s) {
749
819
  return rollBack(d, s, back);
750
820
  }
751
821
  // 戻しても直らない=原因は版ではない。版はそのまま、🟡(人の手番なら自己診断が🔵で届けている)。
822
+ await settle();
752
823
  s.phase = 'held';
753
824
  s.heldRecheckAt = new Date(d.now().getTime() + HELD_RECHECK_MS).toISOString();
754
825
  // ★Claude Code・囲い・小さな試験が落ちたままなら、札を残して新しい便を取らない(便を失敗で燃やさない)。
@@ -784,7 +855,10 @@ async function rollBack(d, s, back) {
784
855
  // ★戻すときだけ、番人の同期が1回走るのを待つ(待たないと、そろったかを測れない=便 8a405f97)。
785
856
  // 入れ替えのときは今までどおり待たない(常駐の起こし直しを遅らせない)。
786
857
  d.log((await waitGuardSync(d, guardBefore)).detail);
787
- d.log(await restartRelays(d, back));
858
+ // ★戻すときも常駐の定義を戻した版の物へそろえる(便 2f984935・定義だけ新しい版を残さない)。
859
+ alignUnits(d);
860
+ await restartRelaysOrRevert(d, back);
861
+ s.unitRestartPending = false;
788
862
  }
789
863
  else {
790
864
  // ★指名で戻す。前の実体が残っていればそれを指す(通信なしで戻せる)。無ければ公式の台本で入れ直す。
@@ -931,6 +1005,9 @@ async function runHalted(d, s, now) {
931
1005
  d.log(describeEntrySync(refreshEntries(d.home, d.distRoot)));
932
1006
  d.log(syncGuardNow(d));
933
1007
  d.log((await waitGuardSync(d, guardBefore)).detail);
1008
+ // ★常駐の定義もそろえ直す(便 2f984935)。起こし直しが要れば、元に戻った後の回で空きを待って行う。
1009
+ if (alignUnits(d).needRelayRestart)
1010
+ s.unitRestartPending = true;
934
1011
  const a = checkAlignment({ home: d.home, distRoot: d.distRoot, body: installed });
935
1012
  if (!a.ok)
936
1013
  return stay(`そろえ直しましたが、まだそろいません(${a.detail})`);
@@ -942,6 +1019,7 @@ async function runHalted(d, s, now) {
942
1019
  }
943
1020
  s.phase = 'idle';
944
1021
  delete s.halt;
1022
+ confirmUnits(d);
945
1023
  removeDrain(d, s);
946
1024
  const closed = clearNotice(d, s);
947
1025
  if (closed !== '')
@@ -973,7 +1051,10 @@ export async function runUpdater(d) {
973
1051
  if (d.boot)
974
1052
  return done(d, s, 'wait', '入れ替えの後の自己診断は、常駐が起きてから次の回で行います');
975
1053
  if (s.component === 'conductor') {
976
- d.log(await restartRelays(d, s.to ?? ''));
1054
+ // ★途中で切れた回も、起こし直す前に常駐の定義をそろえる(便 2f984935)。
1055
+ alignUnits(d);
1056
+ await restartRelaysOrRevert(d, s.to ?? '');
1057
+ s.unitRestartPending = false;
977
1058
  }
978
1059
  return afterSwap(d, s);
979
1060
  }
@@ -1064,6 +1145,11 @@ export async function runUpdater(d) {
1064
1145
  }
1065
1146
  }
1066
1147
  if (!comp || !want) {
1148
+ // ★版が目標と同じでも、常駐の定義と部品置き場の鍵が配布物とずれていればそろえる(便 2f984935)。
1149
+ // 古い更新係(0.12.139 まで)が入れ替えた版は定義をそろえないので、次の回のここで追いつく。
1150
+ const units = await settleUnits(d, s, now, installed);
1151
+ if (s.unitRestartPending)
1152
+ return done(d, s, 'units-wait', units);
1067
1153
  removeDrain(d, s);
1068
1154
  s.busySince = null;
1069
1155
  if (human.waiting)
@@ -1072,7 +1158,7 @@ export async function runUpdater(d) {
1072
1158
  if (target.role !== 'follower')
1073
1159
  await reportCandidates(d, s, installed, claudeNow?.version ?? null);
1074
1160
  const same = `目標の版と同じです(conductor ${installed ?? '不明'}・Claude Code ${claudeNow?.version ?? '不明'})`;
1075
- return done(d, s, 'none', refault ? `${same}。${refault}` : same);
1161
+ return done(d, s, 'none', [same, units, refault].filter((x) => x !== '').join('。'));
1076
1162
  }
1077
1163
  if (human.waiting) {
1078
1164
  removeDrain(d, s);
@@ -1125,7 +1211,10 @@ export async function runUpdater(d) {
1125
1211
  d.log(describeEntrySync(refreshEntries(d.home, d.distRoot)));
1126
1212
  // ★番人も【この瞬間】そろえる(1時間ごとの同期を待たない=便 b649d1f8 の穴の根治)。
1127
1213
  d.log(syncGuardNow(d));
1128
- d.log(await restartRelays(d, want));
1214
+ // ★常駐の定義と部品置き場の鍵も【この瞬間】そろえる(各PCで setup を流し直さない=便 2f984935)。
1215
+ alignUnits(d);
1216
+ await restartRelaysOrRevert(d, want);
1217
+ s.unitRestartPending = false;
1129
1218
  }
1130
1219
  else {
1131
1220
  const r = installClaude(d, want);
@@ -1142,6 +1231,72 @@ export async function runUpdater(d) {
1142
1231
  return done(d, s, 'swapped', `${comp} を ${want} にしました。自己診断は常駐が起きてから次の回で行います`);
1143
1232
  return afterSwap(d, s);
1144
1233
  }
1234
+ /**
1235
+ * 版を入れ替えない回に、常駐の定義と部品置き場の鍵をそろえ、要れば常駐を起こし直す(便 2f984935)。
1236
+ * ★起こし直しは版の入れ替えと同じ決まり:作業中の便があれば起こし直さず次の回に再挑戦/
1237
+ * 30分空きが来なければ札を置いて走っている便の終わりを待つ(★走っている便は止めない)/
1238
+ * 札を置いたら中継の1周ぶん待って空きを確かめ直す。
1239
+ * ★起こし直しが済むまで unitRestartPending を立てたままにする(回をまたいで覚えておく)。
1240
+ * ★入れ替えた定義は自己診断で確かめる(便 2f764c3b)。起こし直しが要る物は起こし直した後に、要らない物
1241
+ * (タイマーなど・起動時に入れ替えて常駐が新しい定義で起きた物)は次の回に。落ちたら控えへ戻す。
1242
+ * 戻り: 記録に残す1行(何もしなかったときは空)。
1243
+ */
1244
+ async function settleUnits(d, s, now, installed) {
1245
+ if (alignUnits(d).needRelayRestart)
1246
+ s.unitRestartPending = true;
1247
+ let verified = '';
1248
+ if (!s.unitRestartPending && !d.boot && pendingUnitSwap(d.home).length > 0) {
1249
+ const v = verifyUnitsBySelfcheck(d);
1250
+ // ★戻した定義で常駐を起き直させる(空きを確かめてから=下の決まりのまま)。
1251
+ if (v.reverted)
1252
+ s.unitRestartPending = true;
1253
+ verified = v.line;
1254
+ }
1255
+ if (!s.unitRestartPending)
1256
+ return verified;
1257
+ if (d.boot) {
1258
+ s.unitRestartPending = false;
1259
+ return '常駐の定義をそろえました(起動時なので、常駐はこの後に新しい定義で起きます)';
1260
+ }
1261
+ const busy = busySites(d.home, d.isAlive);
1262
+ if (busy.length > 0) {
1263
+ s.busySince ??= now.toISOString();
1264
+ if (now.getTime() - Date.parse(s.busySince) >= BUSY_LIMIT_MS) {
1265
+ placeDrain(d, s);
1266
+ return `常駐の定義をそろえましたが、30分空きが来ません。札を置いて、走っている便(${busy.join(',')})の終わりを待ってから常駐を起こし直します`;
1267
+ }
1268
+ return `常駐の定義をそろえました。作業中の便があるので、常駐はまだ起こし直しません(${busy.join(',')})。次の回に再挑戦します`;
1269
+ }
1270
+ placeDrain(d, s);
1271
+ saveState(d.home, s);
1272
+ // ★札を置いた瞬間に中継が便を取りかけていることがある。1周ぶん待って確かめ直す。
1273
+ await d.sleep(d.relayCycleMs);
1274
+ const again = busySites(d.home, d.isAlive);
1275
+ if (again.length > 0) {
1276
+ s.busySince ??= now.toISOString();
1277
+ if (now.getTime() - Date.parse(s.busySince) < BUSY_LIMIT_MS)
1278
+ removeDrain(d, s);
1279
+ return `札を置いた直後に便が始まりました(${again.join(',')})。次の回に常駐を起こし直します`;
1280
+ }
1281
+ const lines = [verified];
1282
+ const ok = await restartRelaysOrRevert(d, installed ?? '');
1283
+ if (!ok)
1284
+ lines.push('常駐を起こし直しましたが、起き上がらない物がありました(入れ替えた定義は控えへ戻しました)');
1285
+ else {
1286
+ lines.push('常駐の定義をそろえたので起こし直しました');
1287
+ if (pendingUnitSwap(d.home).length > 0) {
1288
+ // ★札を置いたまま確かめる(確かめのあいだに便を取らない)。落ちたら戻した定義で起こし直す。
1289
+ const v = verifyUnitsBySelfcheck(d);
1290
+ lines.push(v.line);
1291
+ if (v.reverted)
1292
+ d.log((await restartRelays(d, installed ?? '')).detail);
1293
+ }
1294
+ }
1295
+ removeDrain(d, s);
1296
+ s.unitRestartPending = false;
1297
+ s.busySince = null;
1298
+ return lines.filter((x) => x !== '').join('。');
1299
+ }
1145
1300
  /**
1146
1301
  * 候補の版を見つけたら、自己診断に載せて管制へ届ける(★先行機かどうかは管制が決める)。
1147
1302
  * 同じ候補は1回だけ(届かなかったときは1日あけて届け直す)。
package/dist/selfcheck.js CHANGED
@@ -56,6 +56,7 @@ import { fileURLToPath } from 'node:url';
56
56
  import { buildWorkerPath, CLAUDE_MIN_VERSION, claudeUpdateHint, compareVersions, lastClaudePinStatus, resolveClaudeBin, } from './headless.js';
57
57
  import { fetchControl } from './relay.js';
58
58
  import { readDrain } from './autoupdate-flags.js';
59
+ import { unitHealth } from './unit-sync.js';
59
60
  import { fileHasText, guardPolicyFile, listFilesBySuffix, MANAGED_BASE_FILE, MANAGED_DROPIN_DIR, MANAGED_PATH_ENV, MANAGED_VERIFIED_CLAUDE_VERSIONS, managedGuardRegistration, managedSettingsDir, managedVersionVerified, readManagedState, readSettingsTarget, readSkipSafetyNames, readTextTarget, scanRunningAgents, WINDOWS_MANAGED_DIR, } from './managed-settings.js';
60
61
  // ─────────────────────────────────────────────────────────────────────────────
61
62
  // 形
@@ -1367,6 +1368,53 @@ export function checkUnsafe(d) {
1367
1368
  pass(item, `安全を外す指定は、見た場所すべてで立っていません(${kinds} 種・保存された設定と起動時だけ渡される指定の両方)`);
1368
1369
  return item;
1369
1370
  }
1371
+ /**
1372
+ * 常駐の定義と部品置き場の鍵(便 2f984935)。★読むだけ・1バイトも書かない・鍵の中身は読まない(有無と権限だけ)。
1373
+ * ・置いてある定義がどれも配布物と同じ → PASS。
1374
+ * ・違う定義がある → 合否に数えない(ok=null)で知らせる。★FAIL にしない理由: 入れ替えの直後の
1375
+ * 自己診断が FAIL だと版を疑って戻す。人が手で直した定義(前に配ったどの形とも違う物)まで版の不具合として
1376
+ * 戻させない。違いは自動更新が次の回にそろえる(手で直した物・入れ替えて落ちた物は人の確認として知らせ続ける・便 2f764c3b)。
1377
+ * ・鍵が無い・常駐から見えない → 止めない・合否に数えない。知らせだけ(使わない現場もある)。
1378
+ */
1379
+ export function checkUnits(d) {
1380
+ const item = { key: 'units', label: '常駐の定義と部品置き場の鍵', ok: null, detail: [] };
1381
+ if (d.platform !== 'linux') {
1382
+ note(item, 'この機は systemd の常駐ではないので見ていません');
1383
+ return item;
1384
+ }
1385
+ const h = unitHealth(d.home, d.distRoot);
1386
+ const names = (k) => h.units.filter((u) => u.outcome === k).map((u) => u.name);
1387
+ const same = names('same');
1388
+ const differ = names('synced');
1389
+ const custom = names('custom');
1390
+ const refused = names('refused');
1391
+ if (differ.length > 0)
1392
+ note(item, `配布物と違う常駐の定義があります(${differ.join('・')})。次の自動更新でそろえます`);
1393
+ if (custom.length > 0) {
1394
+ note(item, `前に采配くんが配ったどの形とも違う(手で直した)定義があります(${custom.join('・')})。自動では入れ替えません(人の確認)`);
1395
+ }
1396
+ if (refused.length > 0) {
1397
+ note(item, `この版で入れ替えて落ちたので、入れ替える前の形へ戻した定義があります(${refused.join('・')})。この版のあいだは入れ替え直しません(人の確認)`);
1398
+ }
1399
+ if (h.unitsAligned) {
1400
+ pass(item, same.length > 0 ? `常駐の定義は配布物と同じです(${same.join('・')})` : '比べる常駐の定義が、この機には置かれていません');
1401
+ }
1402
+ const k = h.key;
1403
+ if (k.present && k.nonEmpty && k.mode600 && k.unitReads) {
1404
+ note(item, '部品置き場の鍵: 常駐から見えます(置き場が在り・本人だけが読める形・常駐の定義が読む/値は見ていません)');
1405
+ }
1406
+ else {
1407
+ const why = !k.present
1408
+ ? '置き場がありません'
1409
+ : !k.nonEmpty
1410
+ ? '置き場が空です'
1411
+ : !k.mode600
1412
+ ? '置き場が本人だけが読める形(600)ではありません'
1413
+ : '常駐の定義が置き場を読んでいません';
1414
+ note(item, `部品置き場の鍵: 常駐から見えません(${why})。止めません(@tyhld の部品を使う現場だけ困ります。~/.npmrc に鍵があれば次の自動更新で置きます)`);
1415
+ }
1416
+ return item;
1417
+ }
1370
1418
  /** 項目ごとの合否(管制の checks)。見られなかった項目は skip。 */
1371
1419
  export function checksOf(r) {
1372
1420
  const out = {};
@@ -1489,6 +1537,8 @@ export async function runSelfcheck(d, trigger) {
1489
1537
  const managed = checkManaged(d, { bin: claude.bin, version: claude.version });
1490
1538
  // +安全を外す指定の見張り(★読むだけ・出どころを分けて書く・便 728c3bcc)
1491
1539
  const unsafe = checkUnsafe(d);
1540
+ // +常駐の定義と部品置き場の鍵(★読むだけ・鍵の中身は読まない・便 2f984935)
1541
+ const units = checkUnits(d);
1492
1542
  // ⑥ 小さな試験(③の MCP・④の書き込み・⑤の内側の通信もここで見る)
1493
1543
  //
1494
1544
  // ★1回目の失敗が【一時的と確認できた】ときだけ、60秒待って【1回だけ】やり直す
@@ -1571,7 +1621,7 @@ export async function runSelfcheck(d, trigger) {
1571
1621
  else
1572
1622
  fail(network, 'fault', `囲いの内側から ${u} → ${c}`);
1573
1623
  }
1574
- const items = [conductor, claude.item, central, sandbox, network, headless, guard, managed, unsafe];
1624
+ const items = [conductor, claude.item, central, sandbox, network, headless, guard, managed, unsafe, units];
1575
1625
  const humanActions = items.flatMap((i) => i.human ?? []);
1576
1626
  const candidates = pickCandidates({ conductor: version, claude: claude.version }, { conductor: net.latest, claude: await fetchClaudeStable(d.fetchImpl) });
1577
1627
  return {
@@ -0,0 +1,46 @@
1
+ /**
2
+ * 采配くんがこれまでに配った常駐の定義の指紋(便 2f764c3b)。
3
+ *
4
+ * 【何に使うか】
5
+ * 自動更新が PC の定義を新しい物へ入れ替えてよいのは、PC に在る物が「前に采配くんが配った形と同じ」
6
+ * ときだけ(src/unit-sync.ts の isKnownUnitForm)。人が手で書き換えた定義(どの形とも違う)は入れ替えない。
7
+ *
8
+ * 【中身】
9
+ * 名前ごとに、main の履歴にある systemd/<名前> の各版を、導入台本と同じ置き換え(renderUnit)で
10
+ * PC に置く形にしてから取った sha256。
11
+ * ★この一覧に加えて、自動更新が実際に書いた形の指紋を PC の控え(unitLedgerPath)に残す。
12
+ *
13
+ * 【★systemd/ の定義を変えたら】
14
+ * 新しい形の指紋をここへ足す。足し忘れると test/autoupdate-unit-sync.test.ts が落ち、足す値を出す
15
+ * (足し忘れたまま配ると、その版を入れた PC の次の更新で「人が直した物」と見なされ、入れ替わらない)。
16
+ */
17
+ export const UNIT_KNOWN_FINGERPRINTS = {
18
+ 'conductor@.service': [
19
+ '4604235514e4eef6de627847c78eb8668386bd2c38483d0d6977bf79e87135b0',
20
+ '492e3355eec4a54aad1b5b038d2539a0aaff76fbb431c1c3f1d7c984a4201470',
21
+ 'b68cdfef956a93be79152a1d0ffe7b68874a1334b0ba2dacdfce23390a5e5480',
22
+ 'b884f2b5be410f9fe6d2f30ac0442e65f687f3f8ab6eecea2de92af36398724e',
23
+ 'e4ccc93d66516ece4a10dfdb49bab668eb286dee59cb4326176060e85ebe5784',
24
+ 'e4ecc2294f4497032ff2d51d227854100b0a3224cece1c2368332cb7e0b6b38a',
25
+ ],
26
+ 'conductor-ear.service': [
27
+ '3a54a5455bf7dfe1212ebb2a58cfd33564021f41853b3c5686921f53ac6bb9a3',
28
+ 'bf16a3532ef46b09b9156e63fd5abc76cd16d8967413bddc11d6d7db5b82d3d7',
29
+ 'c073d364f86656f54ecc0dad30cbc4eeff01d511cf0c740748af8f7836f39099',
30
+ ],
31
+ 'conductor-build-runner.service': [
32
+ '044fcdb5883bba5447937ecf4175fddf69dde829cd0ff57a6db5b1dfa95397a1',
33
+ '1019d30542310710d8d939a1f570ca65aad382a12ba3ef842a7c6243a1b5dbbd',
34
+ ],
35
+ 'tyhld-autoupdate-boot.service': ['ca2e3f25363b06935d1104d237133127caf5120ea4f7d2888c0dac644ecce236'],
36
+ 'tyhld-autoupdate.service': ['0ea7576af2fda85562a490622155904600061b0af6ecace8837403db76ffd5d1'],
37
+ 'tyhld-autoupdate.timer': ['40f2a9fc71fcefa962899a9423fe203e9c678054cc4fb7893ae96b09158c62b9'],
38
+ 'tyhld-selfcheck.service': [
39
+ '05a27bd80408bdf00cfb0aadc0a95b0745f6edbbfd33f0700b6484774b1bea65',
40
+ '3a4b1bdb82bd27019a104b1bd9404938808d069ab563401adaf2e72d341c0e53',
41
+ ],
42
+ 'tyhld-selfcheck.timer': [
43
+ '7b1e71d57c7ac9130348cd89206fe050c18372ae26a010aa0cb338cf620ce209',
44
+ '8220dd3fbdeeff02aa7563f002fb4134279e6eaadc20f454f9d18fe613a140b1',
45
+ ],
46
+ };
@@ -0,0 +1,411 @@
1
+ /**
2
+ * @tyhld/conductor — 常駐の定義と部品置き場の鍵を、入っている配布物にそろえる(便 11c9dc93・2f984935)。
3
+ *
4
+ * 【何が起きていたか(0.12.139)】
5
+ * 常駐の定義(~/.config/systemd/user の conductor@.service など)と部品置き場の鍵の置き場は、
6
+ * setup.sh・各導入台本を【人が流したとき】にしか置き直されなかった。自動更新で新しい版が入っても
7
+ * 定義は古いまま残り、0.12.139 で足した「鍵の置き場を読む1行」が各PCで効かなかった
8
+ * (=版を上げるたびに各PCで setup を流し直す手作業が要った)。
9
+ *
10
+ * 【決め(えふさん決定 2026-10-20)】
11
+ * ・自動更新で入れた(戻した)配布物の systemd/ にある采配くんの常駐の定義を、PC に在る物と比べる。
12
+ * 違えば新しい物へ入れ替えて daemon-reload を1回。同じなら何もしない(日付も動かさない)。
13
+ * ・★PC に置いていない定義は新しく置かない(その常駐を使っていない PC に広げない)。
14
+ * ・★人が手で変えた定義は入れ替えず、知らせるだけにする(見分け方は下の「入れ替えを安全にする」)。
15
+ * ・★対象は下の UNIT_SYNC_TARGETS だけ。ほかの常駐と *.service.d/ の中身には触らない。
16
+ * ・部品置き場の鍵は setup.sh ⑥ と同じ部品(scripts/npm-token-place.sh)を呼んで置く
17
+ * (決まりを2か所に持たない・値はこの係を1文字も通らない)。
18
+ * ・常駐の起こし直しは呼び出し側(src/autoupdate.ts)が今までの決まり(作業中の便があれば待つ)で行う。
19
+ *
20
+ * 【入れ替えを安全にする(便 2f764c3b・えふさん承認 2026-10-20)】
21
+ * ・★入れ替えてよいのは、PC に在る定義が「前に采配くんが配った形」と同じときだけ。見分けは中身の指紋
22
+ * (sha256)で行う=配った形の一覧(src/unit-fingerprints.ts)か、この係が書いた形の控え(unitLedgerPath)。
23
+ * どれとも違えば人が手で直した物として入れ替えず、自己診断で「人の確認」として知らせる。
24
+ * ・★入れ替える前の定義を控え(unitBackupDir・1つの名前に1つだけ)に残し、入れ替えが確かめられる
25
+ * (その後の自己診断が通る)まで「確かめ待ち」として覚える。daemon-reload・常駐の起こし直し・その後の
26
+ * 自己診断のどれかが落ちたら、控えへ戻す(revertUnitSwap)。戻した形の版では、同じ形へは入れ替え直さない
27
+ * (起こし直しと自己診断を回ごとにくり返さない)。
28
+ * ・★何度流しても同じ:同じ版なら書かない・控えは名前ごとに1つ・指紋の控えは名前ごとに上限つき。
29
+ */
30
+ import { createHash } from 'node:crypto';
31
+ import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
32
+ import path from 'node:path';
33
+ import { UNIT_KNOWN_FINGERPRINTS } from './unit-fingerprints.js';
34
+ /** 配布物の定義に書いてある「起動の入口の置き換え先」の印(導入台本が置き換える)。 */
35
+ export const UNIT_EXEC_PLACEHOLDER = '__CONDUCTOR_BIN__';
36
+ /**
37
+ * 印を置き換える値(★scripts/dist-source.sh の DIST_RUNTIME_EXEC と同じ=試験で1文字も違わないことを固定)。
38
+ * 自社機もお客さま機も、定義には動かない入口だけを書く(便 81a08d58)。
39
+ */
40
+ export const UNIT_RUNTIME_EXEC = '/bin/bash %h/.tyhld/bin/conductor-run';
41
+ /**
42
+ * そろえる定義(配布物の systemd/ の名前と、PC に置く名前は同じ)。
43
+ * relay … 入れ替えたら常駐の起こし直しが要る物(中継・耳・司令塔)
44
+ */
45
+ export const UNIT_SYNC_TARGETS = [
46
+ { name: 'conductor@.service', relay: true },
47
+ { name: 'conductor-ear.service', relay: true },
48
+ { name: 'conductor-build-runner.service', relay: true },
49
+ { name: 'tyhld-autoupdate-boot.service', relay: false },
50
+ { name: 'tyhld-autoupdate.service', relay: false },
51
+ { name: 'tyhld-autoupdate.timer', relay: false },
52
+ { name: 'tyhld-selfcheck.service', relay: false },
53
+ { name: 'tyhld-selfcheck.timer', relay: false },
54
+ ];
55
+ /**
56
+ * 比べる対象から外す定義(★試験が「配布物の systemd/ の定義はどれも上か下に載っている」を固定する)。
57
+ * tyhld-guard-sync.service … @REPO@ を実機の場所に置き換えて置く(配布物と1文字比べができない)。
58
+ * tyhld-guard-sync.timer … 上とひと組。どちらも番人の同期(update-guard.sh ①-f)が自分で置き直す
59
+ * (自動更新は入れ替えのたびにその同期を起こしている=syncGuardNow)。
60
+ */
61
+ export const UNIT_SYNC_EXCLUDED = ['tyhld-guard-sync.service', 'tyhld-guard-sync.timer'];
62
+ /** 常駐の定義の置き場(導入台本と同じ=$HOME/.config/systemd/user)。 */
63
+ export function userUnitDir(home) {
64
+ return path.join(home, '.config', 'systemd', 'user');
65
+ }
66
+ /** 部品置き場の鍵の置き場(★中身は読まない。有無と権限だけを見る)。 */
67
+ export function pkgKeyFilePath(home) {
68
+ return path.join(home, '.config', 'conductor', 'npm-token.env');
69
+ }
70
+ /** 常駐の定義が鍵の置き場を読む1行(systemd/conductor@.service と同じ)。 */
71
+ export const PKG_KEY_ENV_LINE = 'EnvironmentFile=-%h/.config/conductor/npm-token.env';
72
+ /** 配布物の定義を、PC に置く形にする(印を入口に置き換える)。 */
73
+ export function renderUnit(src) {
74
+ return src.split(UNIT_EXEC_PLACEHOLDER).join(UNIT_RUNTIME_EXEC);
75
+ }
76
+ /** 定義の中の起動の行(ExecStart=)の値。 */
77
+ export function execStartsOf(text) {
78
+ const out = [];
79
+ for (const line of text.split('\n')) {
80
+ const m = line.match(/^\s*ExecStart\s*=\s*(.*?)\s*$/);
81
+ if (m)
82
+ out.push(m[1] ?? '');
83
+ }
84
+ return out;
85
+ }
86
+ function escapeRe(s) {
87
+ return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
88
+ }
89
+ /**
90
+ * 起動の行が采配くんの入口(/bin/bash で %h/.tyhld/bin の下を動かす形)か。
91
+ * ★空の ExecStart=(前の値を消す書き方)は入口ではない=独自の物として扱う。
92
+ */
93
+ export function isOwnExecStart(value, home) {
94
+ const re = new RegExp(`^/bin/bash (?:%h|${escapeRe(home)})/\\.tyhld/bin/[^\\s/]+(?:\\s|$)`);
95
+ return re.test(value);
96
+ }
97
+ // ─────────────────────────────────────────────────────────────────────────────
98
+ // 控え(★更新係の置き場=~/.tyhld/bin の下=番人がどの書き方でも書き込みを止める=職人は書けない)
99
+ // ─────────────────────────────────────────────────────────────────────────────
100
+ /** 控えの置き場(src/autoupdate.ts の updaterDir と同じ=試験で固定)。 */
101
+ function unitStateDir(home) {
102
+ return path.join(home, '.tyhld', 'bin', 'autoupdate');
103
+ }
104
+ /** 指紋・確かめ待ち・入れ替え直さない形の控え(1ファイル)。 */
105
+ export function unitLedgerPath(home) {
106
+ return path.join(unitStateDir(home), 'unit-sync.json');
107
+ }
108
+ /** 入れ替える前の定義の控え(★名前ごとに1つだけ・本人だけが読める形)。 */
109
+ export function unitBackupDir(home) {
110
+ return path.join(unitStateDir(home), 'unit-backup');
111
+ }
112
+ /** 名前ごとに残す「この係が書いた形」の指紋の数(★控えが増え続けない)。 */
113
+ export const UNIT_LEDGER_MAX = 8;
114
+ export function unitFingerprint(text) {
115
+ return createHash('sha256').update(text).digest('hex');
116
+ }
117
+ function readLedger(home) {
118
+ try {
119
+ const j = JSON.parse(readFileSync(unitLedgerPath(home), 'utf8'));
120
+ const pending = j.pending && Array.isArray(j.pending.names) ? { at: String(j.pending.at ?? ''), names: j.pending.names.map(String) } : undefined;
121
+ return { seen: j.seen ?? {}, refused: j.refused ?? {}, ...(pending ? { pending } : {}) };
122
+ }
123
+ catch {
124
+ return { seen: {}, refused: {} };
125
+ }
126
+ }
127
+ /** ★原子的に置き換える(途中で切れても半端な控えを残さない)。 */
128
+ function writeAtomic(p, body, mode) {
129
+ mkdirSync(path.dirname(p), { recursive: true, mode: 0o700 });
130
+ writeFileSync(`${p}.tmp`, body, { mode });
131
+ chmodSync(`${p}.tmp`, mode);
132
+ renameSync(`${p}.tmp`, p);
133
+ }
134
+ function writeLedger(home, l) {
135
+ const body = { seen: l.seen, refused: l.refused, ...(l.pending && l.pending.names.length > 0 ? { pending: l.pending } : {}) };
136
+ writeAtomic(unitLedgerPath(home), `${JSON.stringify(body, null, 2)}\n`, 0o600);
137
+ }
138
+ function rememberIn(l, name, text) {
139
+ const h = unitFingerprint(text);
140
+ const list = (l.seen[name] ?? []).filter((x) => x !== h);
141
+ list.push(h);
142
+ l.seen[name] = list.slice(-UNIT_LEDGER_MAX);
143
+ }
144
+ /** 采配くんが PC に置いた形として控えに残す(★導入台本の代わりに試験が使う・同じ形は1つにまとめる)。 */
145
+ export function rememberUnitForm(home, name, text) {
146
+ const l = readLedger(home);
147
+ rememberIn(l, name, text);
148
+ writeLedger(home, l);
149
+ }
150
+ /** PC に在る定義が、前に采配くんが配った形か(配った形の一覧か、この係が書いた形の控えにある)。 */
151
+ export function isKnownUnitForm(home, name, text) {
152
+ return knownIn(readLedger(home), name, text);
153
+ }
154
+ function knownIn(l, name, text) {
155
+ const h = unitFingerprint(text);
156
+ return (UNIT_KNOWN_FINGERPRINTS[name] ?? []).includes(h) || (l.seen[name] ?? []).includes(h);
157
+ }
158
+ /** 配布物の版(package.json の version)。読めなければ null。 */
159
+ function distVersion(distRoot) {
160
+ try {
161
+ const v = JSON.parse(readFileSync(path.join(distRoot, 'package.json'), 'utf8')).version;
162
+ return typeof v === 'string' ? v : null;
163
+ }
164
+ catch {
165
+ return null;
166
+ }
167
+ }
168
+ /** 確かめ待ちの定義の名前(無ければ空)。 */
169
+ export function pendingUnitSwap(home) {
170
+ return readLedger(home).pending?.names ?? [];
171
+ }
172
+ /** 1つぶんの見比べ(★書かない)。synced は「入れ替える」の意味。 */
173
+ function planOne(home, distRoot, t, ledger) {
174
+ const src = path.join(distRoot, 'systemd', t.name);
175
+ const dst = path.join(userUnitDir(home), t.name);
176
+ if (!existsSync(src))
177
+ return { r: { ...t, outcome: 'no-source' }, dst };
178
+ if (!existsSync(dst))
179
+ return { r: { ...t, outcome: 'not-installed' }, dst };
180
+ let want;
181
+ let have;
182
+ try {
183
+ want = renderUnit(readFileSync(src, 'utf8'));
184
+ have = readFileSync(dst, 'utf8');
185
+ }
186
+ catch {
187
+ return { r: { ...t, outcome: 'no-source' }, dst };
188
+ }
189
+ if (want === have)
190
+ return { r: { ...t, outcome: 'same' }, dst };
191
+ if (!knownIn(ledger, t.name, have))
192
+ return { r: { ...t, outcome: 'custom' }, dst };
193
+ const no = ledger.refused[t.name];
194
+ if (no && no.hash === unitFingerprint(want) && no.version === distVersion(distRoot))
195
+ return { r: { ...t, outcome: 'refused' }, dst };
196
+ return { r: { ...t, outcome: 'synced' }, want, have, dst };
197
+ }
198
+ /** 見比べだけ(★自己診断が使う・1バイトも書かない)。 */
199
+ export function planUnitSync(home, distRoot) {
200
+ const ledger = readLedger(home);
201
+ return UNIT_SYNC_TARGETS.map((t) => planOne(home, distRoot, t, ledger).r);
202
+ }
203
+ /**
204
+ * 見比べて、違う物だけを入れ替える(★原子的に置き換える・*.service.d/ には触らない)。
205
+ * ★入れ替える前の定義を控えに残し、確かめ待ちに載せる。既に確かめ待ちの名前は、最初の控え
206
+ * (確かめが済んだ最後の形)を残す=上書きしない。
207
+ */
208
+ export function syncUnits(home, distRoot) {
209
+ const ledger = readLedger(home);
210
+ const out = [];
211
+ const names = new Set(ledger.pending?.names ?? []);
212
+ for (const t of UNIT_SYNC_TARGETS) {
213
+ const p = planOne(home, distRoot, t, ledger);
214
+ if (p.r.outcome === 'synced' && p.want !== undefined && p.have !== undefined) {
215
+ if (!names.has(t.name)) {
216
+ writeAtomic(path.join(unitBackupDir(home), t.name), p.have, 0o600);
217
+ names.add(t.name);
218
+ }
219
+ // ★書く前に控えへ載せる(書いた後に切れても、次の回に「采配くんの形」として扱える)。
220
+ rememberIn(ledger, t.name, p.want);
221
+ ledger.pending = { at: new Date().toISOString(), names: [...names] };
222
+ writeLedger(home, ledger);
223
+ writeAtomic(p.dst, p.want, 0o644);
224
+ }
225
+ out.push(p.r);
226
+ }
227
+ return out;
228
+ }
229
+ /**
230
+ * 確かめ待ちの定義を、入れ替える前の控えへ戻す(★daemon-reload・起こし直しは呼び出し側)。
231
+ * ★戻した形を「采配くんの形」として覚え、入れ替えた形はこの版のあいだ入れ替え直さない。
232
+ * 戻り: 戻した名前(確かめ待ちが無ければ空=何もしない)。
233
+ */
234
+ export function revertUnitSwap(home, distRoot) {
235
+ const ledger = readLedger(home);
236
+ const names = ledger.pending?.names ?? [];
237
+ if (names.length === 0)
238
+ return [];
239
+ const version = distVersion(distRoot);
240
+ const back = [];
241
+ for (const name of names) {
242
+ const bk = path.join(unitBackupDir(home), name);
243
+ const dst = path.join(userUnitDir(home), name);
244
+ let body;
245
+ try {
246
+ body = readFileSync(bk, 'utf8');
247
+ }
248
+ catch {
249
+ continue;
250
+ }
251
+ try {
252
+ ledger.refused[name] = { hash: unitFingerprint(readFileSync(dst, 'utf8')), version };
253
+ }
254
+ catch {
255
+ // 定義が消えていても戻す
256
+ }
257
+ rememberIn(ledger, name, body);
258
+ writeAtomic(dst, body, 0o644);
259
+ rmSync(bk, { force: true });
260
+ back.push(name);
261
+ }
262
+ delete ledger.pending;
263
+ writeLedger(home, ledger);
264
+ return back;
265
+ }
266
+ /** 確かめ待ちの定義を「確かめた」にする(★控えを消す=控えが増え続けない)。戻り: 確かめた名前。 */
267
+ export function confirmUnitSwap(home) {
268
+ const ledger = readLedger(home);
269
+ const names = ledger.pending?.names ?? [];
270
+ if (names.length === 0)
271
+ return [];
272
+ for (const name of names)
273
+ rmSync(path.join(unitBackupDir(home), name), { force: true });
274
+ delete ledger.pending;
275
+ writeLedger(home, ledger);
276
+ return names;
277
+ }
278
+ /** 結果を1行の日本語にする(記録に残す)。 */
279
+ export function describeUnitSync(results) {
280
+ const label = {
281
+ synced: '入れ替えた',
282
+ same: '同じ',
283
+ 'not-installed': '置いていない',
284
+ 'no-source': '配布物に元が無い',
285
+ custom: '前に配った形と違うので入れ替えなかった(人の確認)',
286
+ refused: 'この版で入れ替えて落ちた形なので入れ替え直さなかった(人の確認)',
287
+ };
288
+ const parts = ['synced', 'custom', 'refused', 'same', 'not-installed', 'no-source']
289
+ .map((k) => ({ k, names: results.filter((r) => r.outcome === k).map((r) => r.name) }))
290
+ .filter((g) => g.names.length > 0)
291
+ .map((g) => `${label[g.k]}=${g.names.join(',')}`);
292
+ return `常駐の定義の同期: ${parts.length > 0 ? parts.join('/') : '対象なし'}`;
293
+ }
294
+ /**
295
+ * 部品置き場の鍵を置く(★setup.sh ⑥ と同じ部品を呼ぶ)。
296
+ * ★部品には HOME と PATH だけを渡す(この係が持つほかの環境変数を渡さない)。
297
+ * ★部品の出力は値を含まない1行([npm-token] <結果の語>: 日本語)。読むのは結果の語だけ。
298
+ */
299
+ export function placePkgKey(exec, home, distRoot, env) {
300
+ const placer = path.join(distRoot, 'scripts', 'npm-token-place.sh');
301
+ if (!existsSync(placer))
302
+ return { outcome: 'no-source', detail: '部品置き場の鍵: 置く部品がこの配布物にありません(何もしませんでした)' };
303
+ const r = exec('bash', [placer], { env: { HOME: home, PATH: env.PATH ?? '/usr/bin:/bin' }, timeoutMs: 30_000 });
304
+ const m = r.stdout.match(/\[npm-token\] (placed|kept|absent|failed): ?(.*)/);
305
+ if (!m)
306
+ return { outcome: 'failed', detail: `部品置き場の鍵: 部品の答えを読めませんでした(終了 ${r.status})` };
307
+ return { outcome: m[1], detail: m[2] || '部品置き場の鍵' };
308
+ }
309
+ /** daemon-reload を1回打つ。戻り: 通ったか。 */
310
+ function daemonReload(d, lines) {
311
+ const r = d.exec('systemctl', ['--user', 'daemon-reload'], { timeoutMs: 30_000 });
312
+ const ok = r.status === 0;
313
+ lines.push(ok ? 'daemon-reload を1回打ちました' : `daemon-reload に失敗しました(終了 ${r.status})`);
314
+ return ok;
315
+ }
316
+ /**
317
+ * 確かめ待ちの定義を控えへ戻し、daemon-reload を打つ(★常駐の起こし直しは呼び出し側)。
318
+ * why … 戻す理由(記録に残す・★値を含めない)。戻り: 戻した名前(確かめ待ちが無ければ空=何もしない)。
319
+ */
320
+ export function revertUnits(d, why, lines) {
321
+ let back = [];
322
+ try {
323
+ back = revertUnitSwap(d.home, d.distRoot);
324
+ }
325
+ catch (err) {
326
+ lines.push(`★常駐の定義を控えへ戻せませんでした(${errorCode(err)}・人の確認)`);
327
+ return [];
328
+ }
329
+ if (back.length === 0)
330
+ return [];
331
+ lines.push(`★${why}ので、常駐の定義を入れ替える前の控えへ戻しました(${back.join(',')})。この版のあいだは入れ替え直しません(人の確認)`);
332
+ daemonReload(d, lines);
333
+ return back;
334
+ }
335
+ /** 失敗の種類だけを出す(★文や中身は出さない=思わぬ値を記録や管制へ運ばない)。 */
336
+ function errorCode(err) {
337
+ const code = err?.code;
338
+ return typeof code === 'string' && /^[A-Z0-9_]+$/.test(code) ? code : '理由不明';
339
+ }
340
+ /**
341
+ * 常駐の定義と部品置き場の鍵を、入っている配布物にそろえる(★自動更新の各所から呼ぶ)。
342
+ * ★定義を1つでも入れ替えたときだけ daemon-reload を1回打つ。落ちたら控えへ戻して打ち直す。
343
+ * ★常駐の起こし直しはしない(呼び出し側が今までの決まりで行う)。
344
+ */
345
+ export function alignUnitsAndKey(d) {
346
+ const lines = [];
347
+ let units = [];
348
+ try {
349
+ units = syncUnits(d.home, d.distRoot);
350
+ }
351
+ catch (err) {
352
+ lines.push(`常駐の定義の同期: 書けませんでした(${errorCode(err)})`);
353
+ }
354
+ if (units.length > 0)
355
+ lines.push(describeUnitSync(units));
356
+ const changed = units.filter((u) => u.outcome === 'synced');
357
+ let reloaded = false;
358
+ let reverted = [];
359
+ if (changed.length > 0) {
360
+ reloaded = daemonReload(d, lines);
361
+ if (!reloaded)
362
+ reverted = revertUnits(d, 'daemon-reload が落ちた', lines);
363
+ }
364
+ for (const u of units.filter((x) => x.outcome === 'custom')) {
365
+ lines.push(`★${u.name} は前に采配くんが配ったどの形とも違う(手で直した物)ので、入れ替えていません(人の確認: 導入台本を流し直すか、手で直してください)`);
366
+ }
367
+ for (const u of units.filter((x) => x.outcome === 'refused')) {
368
+ lines.push(`★${u.name} はこの版で入れ替えて落ちた形なので、入れ替え直していません(人の確認)`);
369
+ }
370
+ const key = placePkgKey(d.exec, d.home, d.distRoot, d.env);
371
+ lines.push(key.detail);
372
+ return {
373
+ units,
374
+ reloaded,
375
+ reverted,
376
+ key,
377
+ // ★控えへ戻したときも起こし直す(戻した定義で起き直す)。戻した形へは入れ替え直さないので、くり返さない。
378
+ needRelayRestart: changed.some((u) => u.relay) || key.outcome === 'placed',
379
+ lines,
380
+ };
381
+ }
382
+ /**
383
+ * 自己診断のための見比べ(★書かない・鍵の中身は読まない=有無と権限だけ)。
384
+ * unitsAligned … 置いてある定義がどれも配布物と同じか(置いていない物は数えない)
385
+ * key … 鍵の置き場の有無・中身が空でないか・本人だけが読めるか・常駐の定義が読むか
386
+ */
387
+ export function unitHealth(home, distRoot) {
388
+ const units = planUnitSync(home, distRoot);
389
+ const unitsAligned = units.every((u) => u.outcome === 'same' || u.outcome === 'not-installed' || u.outcome === 'no-source');
390
+ const f = pkgKeyFilePath(home);
391
+ let present = false;
392
+ let nonEmpty = false;
393
+ let mode600 = false;
394
+ try {
395
+ const st = statSync(f);
396
+ present = st.isFile();
397
+ nonEmpty = st.size > 0;
398
+ mode600 = (st.mode & 0o777) === 0o600;
399
+ }
400
+ catch {
401
+ // 無い
402
+ }
403
+ let unitReads = false;
404
+ try {
405
+ unitReads = readFileSync(path.join(userUnitDir(home), 'conductor@.service'), 'utf8').split('\n').includes(PKG_KEY_ENV_LINE);
406
+ }
407
+ catch {
408
+ // 定義が無い
409
+ }
410
+ return { units, unitsAligned, key: { present, nonEmpty, mode600, unitReads } };
411
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.139",
3
+ "version": "0.12.141",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -28,6 +28,7 @@
28
28
  "scripts/tyhld-selfcheck.sh",
29
29
  "scripts/tyhld-autoupdate.sh",
30
30
  "scripts/autoupdate-install.sh",
31
+ "scripts/npm-token-place.sh",
31
32
  "scripts/kc.sh",
32
33
  "scripts/codex",
33
34
  "!scripts/codex/__pycache__",
@@ -1386,47 +1386,22 @@ fi
1386
1386
  # コマンドの引数に載せて取り込む操作が要る。ここなら常駐を入れ直すだけで効き、鍵は1度もコマンドの
1387
1387
  # 引数・画面に出ない。
1388
1388
  # ・名前が .env で終わるので、番人は職人からの読み取りを秘密として止める(判定は1文字も変えていない)。
1389
- # 【決め】★人が既に持っている鍵(~/.npmrc の npm.pkg.github.com の _authToken の値)を写すだけ。
1390
- # 新しい鍵は作らない・聞かない。値は画面・記録に1文字も出さない(umask 077 のもとで書き 600)。
1391
- # ★既に置いてあれば上書きしない(今ある鍵を勝手に替えない=何度流しても同じ)。
1392
- # ★鍵が無い・${…} の参照しか無い PC では何も置かない(⑦で知らせる・止めない)。
1389
+ # 【決め】★写す決まり(写すだけ・新しい鍵は作らない・既にあれば上書きしない・値を出さない・
1390
+ # 参照の形しか無ければ何も置かない)の正本は scripts/npm-token-place.sh の1ファイル(便 2f984935)。
1391
+ # 自動更新(src/unit-sync.ts)も同じ部品を呼ぶ=決まりを2か所に持たない。
1392
+ # ★鍵が無い PC では何も置かない(⑦で知らせる・止めない)。
1393
1393
  NPM_TOKEN_FILE="$HOME/.config/conductor/npm-token.env"
1394
-
1395
- # ~/.npmrc の部品置き場の鍵の値(★呼び出し側が変数で受ける。画面へは出さない)。無ければ空。
1396
- npm_token_from_npmrc() {
1397
- local f="$HOME/.npmrc" line v=''
1398
- [[ -f "$f" ]] || return 0
1399
- while IFS= read -r line || [[ -n "$line" ]]; do
1400
- line="${line%$'\r'}"
1401
- if [[ "$line" =~ ^[[:space:]]*//npm\.pkg\.github\.com/:_authToken[[:space:]]*=[[:space:]]*(.*)$ ]]; then
1402
- v="${BASH_REMATCH[1]}"
1403
- fi
1404
- done < "$f"
1405
- v="${v%"${v##*[![:space:]]}"}"
1406
- v="${v#\"}"; v="${v%\"}"
1407
- # ${NPM_TOKEN} のような参照は値ではない(写しても効かない)。
1408
- [[ "$v" == *'${'* ]] && v=''
1409
- printf '%s' "$v"
1410
- }
1394
+ PKG_KEY_PLACER="$SCRIPT_DIR/../scripts/npm-token-place.sh"
1411
1395
 
1412
1396
  if [[ "$OS_KIND" == "mac" ]]; then
1413
1397
  echo "[setup] 部品置き場の鍵の受け渡しは、Mac ではまだ用意していません(スキップ)"
1414
- elif [[ -f "$NPM_TOKEN_FILE" ]]; then
1415
- chmod 600 "$NPM_TOKEN_FILE" 2>/dev/null || true
1416
- echo "[setup] 部品置き場の鍵: 既に置いてあります → そのまま(上書きしません)"
1398
+ elif [[ -f "$PKG_KEY_PLACER" ]]; then
1399
+ # ★部品の1行([npm-token] <結果の語>: 日本語)から、日本語の部分だけを出す(値は元から含まない)。
1400
+ pkg_key_line="$(bash "$PKG_KEY_PLACER")" || warn "部品置き場の鍵を置けませんでした(設置は続けます)"
1401
+ echo "[setup] ${pkg_key_line#*: }"
1402
+ unset pkg_key_line
1417
1403
  else
1418
- npm_tok="$(npm_token_from_npmrc)"
1419
- if [[ -n "$npm_tok" ]]; then
1420
- mkdir -p "$(dirname "$NPM_TOKEN_FILE")"
1421
- ( umask 077; printf 'NPM_TOKEN=%s\n' "$npm_tok" > "$NPM_TOKEN_FILE.tmp.$$" ) \
1422
- && mv -f "$NPM_TOKEN_FILE.tmp.$$" "$NPM_TOKEN_FILE" \
1423
- && chmod 600 "$NPM_TOKEN_FILE" \
1424
- && echo "[setup] 部品置き場の鍵を、常駐から読める所へ置きました(本人だけが読める形・値は出していません)" \
1425
- || warn "部品置き場の鍵を置けませんでした(設置は続けます)"
1426
- else
1427
- echo "[setup] 部品置き場の鍵が ~/.npmrc に見当たらないため、何も置きません(⑦で知らせます)"
1428
- fi
1429
- unset npm_tok
1404
+ warn "部品置き場の鍵を置く部品が見つかりません: $PKG_KEY_PLACER(スキップ・⑦で知らせます)"
1430
1405
  fi
1431
1406
 
1432
1407
  # ★常駐の設置だけが OS で分かれる(ADR-019・案C)。ここより上も下も1本のまま。
@@ -0,0 +1,74 @@
1
+ #!/usr/bin/env bash
2
+ # npm-token-place.sh — 部品置き場の鍵を、采配くんの常駐だけが読む置き場へ写す(便 a940fa1a・11c9dc93・2f984935)。
3
+ #
4
+ # 【決まりの正本はこの1ファイル】setup.sh ⑥ と自動更新(src/unit-sync.ts)の両方がこれを呼ぶ。
5
+ # 以前は setup.sh の中にだけ書いてあり、自動更新で新しい版が入っても鍵は置かれなかった
6
+ # (各PCで setup を流し直す手作業が要った)。決まりを2か所に持たないため、ここへ寄せた。
7
+ #
8
+ # 【なぜ要るか(実物 2026-10-20・自宅PC)】各現場の .npmrc は鍵を環境変数の参照の形で書いてあり、
9
+ # 職人は常駐(中継)の環境を受け継ぐ。常駐は ~/.conductor.env しか読まないので、人の画面
10
+ # (~/.bashrc・~/.npmrc)に鍵があっても常駐の側には無く、@tyhld の部品の問い合わせが 401 になった。
11
+ # 常駐の定義 conductor@.service の EnvironmentFile=-%h/.config/conductor/npm-token.env がここを読む。
12
+ #
13
+ # 【決め】
14
+ # ★人が既に持っている鍵(~/.npmrc の npm.pkg.github.com の _authToken の値)を写すだけ。
15
+ # 新しい鍵は作らない・聞かない。値は画面・記録に1文字も出さない(umask 077 のもとで書き 600)。
16
+ # ★既に置いてあれば上書きしない(今ある鍵を勝手に替えない=何度流しても同じ)。権限だけ 600 にそろえる。
17
+ # ★鍵が無い・参照の形しか無い PC では何も置かない(止めない・呼び出し側が知らせる)。
18
+ #
19
+ # 使い方: bash npm-token-place.sh (HOME の下だけを見る・引数なし)
20
+ # 出力: 人が読む1行。★先頭は `[npm-token] <結果の語>: ` の形で、自動更新がこの語を読む(値は含まない)。
21
+ # placed … いま置いた / kept … 既に置いてあった(上書きしない)/ absent … 鍵が無いので置かない /
22
+ # failed … 置こうとして置けなかった
23
+ # 終了コード: 0=placed・kept・absent / 1=failed
24
+ #
25
+ # ★値を出さない(便 2f764c3b): 呼び出し側の環境から命令の書き出し(xtrace)を受け継いでも、ここで切る
26
+ # (受け継いだままだと、値を受ける行が画面・記録へそのまま書き出される)。値は外の命令の引数に渡さない
27
+ # (書くのは組み込みの printf だけ)。エラーの文にも値は入らない。
28
+ set +x
29
+ set -u
30
+
31
+ PKG_KEY_FILE="${HOME:?}/.config/conductor/npm-token.env"
32
+
33
+ # ~/.npmrc の部品置き場の鍵の値(★呼び出し側が変数で受ける。画面へは出さない)。無ければ空。
34
+ pkg_key_from_npmrc() {
35
+ local f="$HOME/.npmrc" line v=''
36
+ [[ -f "$f" ]] || return 0
37
+ while IFS= read -r line || [[ -n "$line" ]]; do
38
+ line="${line%$'\r'}"
39
+ if [[ "$line" =~ ^[[:space:]]*//npm\.pkg\.github\.com/:_authToken[[:space:]]*=[[:space:]]*(.*)$ ]]; then
40
+ v="${BASH_REMATCH[1]}"
41
+ fi
42
+ done < "$f"
43
+ v="${v%"${v##*[![:space:]]}"}"
44
+ v="${v#\"}"; v="${v%\"}"
45
+ # 環境変数の参照(ドル記号と波かっこ)は値ではない(写しても効かない)。
46
+ [[ "$v" == *'${'* ]] && v=''
47
+ printf '%s' "$v"
48
+ }
49
+
50
+ if [[ -f "$PKG_KEY_FILE" ]]; then
51
+ chmod 600 "$PKG_KEY_FILE" 2>/dev/null || true
52
+ echo "[npm-token] kept: 部品置き場の鍵: 既に置いてあります → そのまま(上書きしません)"
53
+ exit 0
54
+ fi
55
+
56
+ pkg_val="$(pkg_key_from_npmrc)"
57
+ if [[ -z "$pkg_val" ]]; then
58
+ echo "[npm-token] absent: 部品置き場の鍵が ~/.npmrc に見当たらないため、何も置きません"
59
+ exit 0
60
+ fi
61
+
62
+ tmp="$PKG_KEY_FILE.tmp.$$"
63
+ if mkdir -p "$(dirname "$PKG_KEY_FILE")" \
64
+ && ( umask 077; printf 'NPM_TOKEN=%s\n' "$pkg_val" > "$tmp" ) \
65
+ && mv -f "$tmp" "$PKG_KEY_FILE" \
66
+ && chmod 600 "$PKG_KEY_FILE"; then
67
+ unset pkg_val
68
+ echo "[npm-token] placed: 部品置き場の鍵を、常駐から読める所へ置きました(本人だけが読める形・値は出していません)"
69
+ exit 0
70
+ fi
71
+ unset pkg_val
72
+ rm -f "$tmp" 2>/dev/null || true
73
+ echo "[npm-token] failed: 部品置き場の鍵を置けませんでした"
74
+ exit 1