@tyhld/conductor 0.12.84 → 0.12.86

package/dist/autoupdate.js

@@ -0,0 +1,643 @@
+/**
+ * @tyhld/conductor — 更新係（`conductor autoupdate`・便 29babc5d・設計 3ed9e2b2 の A3）。
+ *
+ * 【何のためか】自社PCの自動更新（えふさん確定 2026-10-02）。通常時は PC の電源を入れるだけで、
+ *   常駐起動 → 版確認 → 必要なら安全に更新 → 自己診断 → 便を受け取る、まで人の手を要らなくする。
+ *
+ * 【動くとき】systemd のユーザーサービスから（★sudo なし・番人を通らない）。
+ *   ・起動時に1回（tyhld-autoupdate-boot.service・--boot）… 常駐（conductor@）より先に動く
+ *   ・以後は数分ごとのタイマー（tyhld-autoupdate.timer）… 管制が返す checkAgainMin が来た回だけ聞きに行く
+ *
+ * 【決め（設計 3ed9e2b2 の 1/4・2/4 と管制の口の決まり 2f5eb92c）】
+ *   ・鍵（~/.tyhld/bin/autoupdate/enabled）が無い機では何もしない（★お客さまの機には置かない）。
+ *   ・管制に目標の版を聞く。autoUpdate:false・ready:false・止める（halted）・届かない → 何もしない
+ *     （届かないときは更新しない＝安全側）。
+ *   ・conductor の目標が今と違えば conductor だけを入れ替える。★そのあいだ Claude Code は動かさない
+ *     （管制も同じ順番を守る。更新係は管制が返した目標だけを見る）。
+ *   ・入れ替えは全現場が空きのときだけ: 札を置く → 中継の1周ぶん待つ → もう一度空きを確かめる →
+ *     版を名指しして入れる（取得先は毎回 https://registry.npmjs.org・@latest にしない）→
+ *     全現場の常駐を起こし直す → 札を外す → 自己診断 → 管制へ（自己診断が届ける）。
+ *   ・空きでなければ次の回に再挑戦。6時間空かなければ札を置いて新しい便を取らない形に移り、
+ *     走っている便の終わりを待つ（★走っている便は止めない）。
+ *   ・自己診断が FAIL → そのPCだけ前の版へ戻す → 自己診断（after-rollback＝rolledBack が管制へ届く）。
+ *     戻しても FAIL なら、その版のまま止まって🟡（Claude Code・囲い・小さな試験が落ちたままなら
+ *     札を残して新しい便を取らない＝便を失敗で燃やさない）。人にしかできない原因は自己診断が🔵で届ける。
+ *   ・Claude Code は公式推奨の導入（https://claude.ai/install.sh）で版を名指しして入れ、
+ *     指名（~/.tyhld/bin/autoupdate/claude-pin）を書く。戻すときも指名で戻す。最低版より古い版へは戻さない。
+ *   ・候補の版（conductor＝公開 npm の latest／Claude Code＝公式の安定版）を見つけたら、自己診断に
+ *     載せて管制へ届ける。★先行機かどうかはこの機では決めない（機体名をコードに書かない・管制が決める）。
+ *
+ * 【控え】~/.tyhld/bin/autoupdate/state.json（★職人が書けない場所。途中で電源が切れても続きから動く）。
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, writeFileSync, copyFileSync, chmodSync, } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CLAUDE_MIN_VERSION, compareVersions, isProcessAlive, parseClaudeVersion, resolveClaudeBin, } from './headless.js';
+import { defaultExec, fetchClaudeStable, npmBesideNode, pickCandidates } from './selfcheck.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 定数（★時間の値は設計 3ed9e2b2 の推奨値・管制の ROLLOUT_TIMES と同じ考え方）
+// ─────────────────────────────────────────────────────────────────────────────
+/** 取得先（★毎回これに固定する＝手元の設定が何であっても公開 npm を見る）。 */
+export const CONDUCTOR_PKG = '@tyhld/conductor';
+export const CONDUCTOR_REGISTRY_ARG = '--@tyhld:registry=https://registry.npmjs.org';
+/** 公式推奨の導入台本（code.claude.com/docs/en/setup の Native Install (Recommended)）。 */
+export const CLAUDE_INSTALL_URL = 'https://claude.ai/install.sh';
+/** 管制が checkAgainMin を返さないときの間隔（分）。 */
+export const DEFAULT_CHECK_MIN = 15;
+/** 空きが来ないとき、札を置いて新しい便を取らない形に移るまでの長さ。 */
+export const BUSY_LIMIT_MS = 6 * 60 * 60 * 1000;
+/** 起こし直した常駐が立ち上がるのを待つ上限。 */
+export const RESTART_WAIT_MS = 120_000;
+/** 起こし直した常駐の様子を見る間隔。 */
+export const RESTART_POLL_MS = 5_000;
+/** 戻しても直らなかった機で、自己診断を測り直す間隔。 */
+export const HELD_RECHECK_MS = 60 * 60 * 1000;
+/** 候補を届けられなかったとき、もう一度届けに行くまでの間隔。 */
+export const CANDIDATE_RETRY_MS = 24 * 60 * 60 * 1000;
+const SEMVER = /^\d+\.\d+\.\d+$/;
+// ─────────────────────────────────────────────────────────────────────────────
+// 置き場
+// ─────────────────────────────────────────────────────────────────────────────
+/** 更新係の置き場（★~/.tyhld/bin の下＝番人がどの書き方でも書き込みを止める＝職人は書けない）。 */
+export function updaterDir(home) {
+    return path.join(home, '.tyhld', 'bin', 'autoupdate');
+}
+/** 鍵（自社PCの印）。★置くのは自社PCの導入台本（scripts/autoupdate-install.sh）だけ。 */
+export function keyPath(home) {
+    return path.join(updaterDir(home), 'enabled');
+}
+export function statePath(home) {
+    return path.join(updaterDir(home), 'state.json');
+}
+/** 札の場所（★中継が読む場所と同じ＝relay.ts の drainFilePath と同じ決め方）。 */
+export function drainPath(home, env) {
+    return env.CONDUCTOR_DRAIN_FILE || path.join(updaterDir(home), 'drain');
+}
+/** 指名の場所（★中継が読む場所と同じ＝autoupdate-flags.ts の claudePinPath と同じ決め方）。 */
+export function pinPath(home, env) {
+    return env.CONDUCTOR_CLAUDE_PIN_FILE || path.join(updaterDir(home), 'claude-pin');
+}
+/** ネイティブ導入の版の置き場（公式の導入台本がここへ入れる）。 */
+export function claudeVersionsDir(home) {
+    return path.join(home, '.local', 'share', 'claude', 'versions');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 小さな部品
+// ─────────────────────────────────────────────────────────────────────────────
+export function readInstalledVersion(distRoot) {
+    try {
+        const v = JSON.parse(readFileSync(path.join(distRoot, 'package.json'), 'utf8')).version;
+        return typeof v === 'string' ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function loadState(home) {
+    try {
+        const s = JSON.parse(readFileSync(statePath(home), 'utf8'));
+        if (s && s.schema === 'tyhld-autoupdate/1')
+            return s;
+    }
+    catch {
+        // 無い・壊れている → 初めから
+    }
+    return { schema: 'tyhld-autoupdate/1', phase: 'idle' };
+}
+/** 控えを書く（★入れ替えの前にも書く＝途中で切れても続きが分かる）。原子的に置き換える。 */
+export function saveState(home, s) {
+    mkdirSync(updaterDir(home), { recursive: true });
+    const p = statePath(home);
+    writeFileSync(`${p}.tmp`, `${JSON.stringify(s, null, 2)}\n`);
+    renameSync(`${p}.tmp`, p);
+}
+/**
+ * 作業中の便がある現場の一覧（★空きの確かめ）。
+ *   中継は便の実行中、~/.local/state/conductor/active-job-<現場>.json を置き、終われば消す。
+ *   記録の pid が生きていれば作業中。★pid の無い古い形の記録は「作業中」として扱う（迷ったら入れ替えない）。
+ */
+export function busySites(home, isAlive) {
+    const dir = path.join(home, '.local', 'state', 'conductor');
+    let names = [];
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const n of names) {
+        const m = n.match(/^active-job(?:-(.+))?\.json$/);
+        if (!m)
+            continue;
+        let pid;
+        try {
+            const rec = JSON.parse(readFileSync(path.join(dir, n), 'utf8'));
+            pid = typeof rec.pid === 'number' ? rec.pid : undefined;
+        }
+        catch {
+            out.push(m[1] ?? '(共有の記録)');
+            continue;
+        }
+        if (pid === undefined || isAlive(pid))
+            out.push(m[1] ?? '(共有の記録)');
+    }
+    return out;
+}
+/** 管制に目標の版を聞く。★届かない・JSON でない・ログイン画面へ回される → null（＝何もしない）。 */
+export async function fetchTarget(d, conductorVersion) {
+    const url = d.env.CONDUCTOR_URL;
+    const token = d.env.CONDUCTOR_TOKEN;
+    if (!url || !token)
+        return { target: null, detail: '接続設定（CONDUCTOR_URL・CONDUCTOR_TOKEN）がありません' };
+    const q = new URLSearchParams({ machine: d.machine });
+    if (conductorVersion)
+        q.set('conductorVersion', conductorVersion);
+    try {
+        const res = await d.fetchImpl(`${url}/api/conductor/machines/target?${q.toString()}`, {
+            headers: { Authorization: `Bearer ${token}` },
+            redirect: 'manual',
+            signal: AbortSignal.timeout(20_000),
+        });
+        const json = (res.headers.get('content-type') ?? '').includes('application/json');
+        if (!res.ok || !json)
+            return { target: null, detail: `HTTP ${res.status}${json ? '' : '（JSON の答えではない）'}` };
+        const b = (await res.json());
+        const ver = (v) => (typeof v === 'string' && SEMVER.test(v.trim()) ? v.trim() : null);
+        const min = typeof b.checkAgainMin === 'number' && Number.isFinite(b.checkAgainMin) && b.checkAgainMin > 0 ? b.checkAgainMin : DEFAULT_CHECK_MIN;
+        return {
+            target: {
+                autoUpdate: b.autoUpdate === true,
+                conductor: ver(b.conductor),
+                claudeCode: ver(b.claudeCode),
+                halted: b.halted === true,
+                reason: typeof b.reason === 'string' ? b.reason : null,
+                checkAgainMin: min,
+                ready: b.ready === true,
+            },
+            detail: `HTTP ${res.status}`,
+        };
+    }
+    catch (err) {
+        return { target: null, detail: err instanceof Error ? err.message : String(err) };
+    }
+}
+function placeDrain(d, s) {
+    const p = drainPath(d.home, d.env);
+    if (existsSync(p))
+        return;
+    mkdirSync(path.dirname(p), { recursive: true });
+    writeFileSync(p, `${d.now().toISOString()} tyhld-autoupdate\n`);
+    s.drainOwned = true;
+    d.log(`入れ替え待ちの札を置きました（新しい便を取りません・走っている便は止めません）: ${p}`);
+}
+/** 札を外す。★この係が置いた札だけ（人が置いた札は外さない）。 */
+function removeDrain(d, s) {
+    if (!s.drainOwned)
+        return;
+    rmSync(drainPath(d.home, d.env), { force: true });
+    s.drainOwned = false;
+    d.log('入れ替え待ちの札を外しました（便の受け取りを再開します）');
+}
+function addFailed(s, c, v) {
+    if (!v)
+        return;
+    const list = ((s.failedVersions ??= {})[c] ??= []);
+    if (!list.includes(v))
+        list.push(v);
+}
+function done(d, s, action, detail) {
+    s.lastRun = { at: d.now().toISOString(), action, detail };
+    saveState(d.home, s);
+    d.log(`${action}: ${detail}`);
+    return s;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 入れ替えの本体
+// ─────────────────────────────────────────────────────────────────────────────
+/** conductor を版を名指しして入れる（★@latest にしない・取得先は公開 npm に固定）。 */
+function installConductor(d, version, offline) {
+    if (!SEMVER.test(version))
+        return { ok: false, detail: `版の形が違います（${version}）` };
+    if (!d.npm)
+        return { ok: false, detail: '配布物の node の隣に npm がありません' };
+    const env = { ...d.env, PATH: `${path.dirname(d.npm)}:${d.env.PATH ?? ''}` };
+    const args = ['install', '-g', `${CONDUCTOR_PKG}@${version}`, CONDUCTOR_REGISTRY_ARG, ...(offline ? ['--prefer-offline'] : [])];
+    const r = d.exec(d.npm, args, { env, timeoutMs: 15 * 60_000 });
+    const now = readInstalledVersion(d.distRoot);
+    if (r.status === 0 && now === version)
+        return { ok: true, detail: `${CONDUCTOR_PKG}@${version} を入れました` };
+    return { ok: false, detail: `npm install の終了 ${r.status}・入っている版 ${now ?? '不明'}（${(r.error ?? r.stderr).trim().slice(-200)}）` };
+}
+/**
+ * 更新係・自己診断・常駐の入口を、入れ替えた配布物から写し直す（★在る物だけ・原子的に置き換える）。
+ *   常駐の入口（conductor-run・dist-source.sh・skill_sync_notify.py）は毎時同期でも揃うが、
+ *   起こし直す前に揃えておく（新しい配布物の探し方で起きる）。
+ */
+export function refreshEntries(home, distRoot) {
+    const bin = path.join(home, '.tyhld', 'bin');
+    const pairs = [
+        ['scripts/tyhld-autoupdate.sh', 'tyhld-autoupdate', true],
+        ['scripts/tyhld-selfcheck.sh', 'tyhld-selfcheck', true],
+        ['scripts/dist-source.sh', 'dist-source.sh', false],
+        ['scripts/conductor-run.sh', 'conductor-run', true],
+        ['scripts/hooks/skill_sync_notify.py', 'skill_sync_notify.py', false],
+    ];
+    const out = [];
+    for (const [from, to, exe] of pairs) {
+        const src = path.join(distRoot, from);
+        const dst = path.join(bin, to);
+        if (!existsSync(src) || !existsSync(dst))
+            continue;
+        copyFileSync(src, `${dst}.tmp`);
+        if (exe)
+            chmodSync(`${dst}.tmp`, 0o755);
+        renameSync(`${dst}.tmp`, dst);
+        out.push(to);
+    }
+    return out;
+}
+/** 常駐（conductor@*・耳・司令塔）の一覧。 */
+function relayUnits(d) {
+    const r = d.exec('systemctl', ['--user', 'list-units', 'conductor@*.service', 'conductor-ear.service', 'conductor-build-runner.service', '--all', '--no-legend', '--plain'], { timeoutMs: 15_000 });
+    return r.stdout
+        .split('\n')
+        .map((l) => l.trim().split(/\s+/)[0] ?? '')
+        .filter((u) => u.endsWith('.service'));
+}
+/**
+ * 全現場の常駐を起こし直し、立ち上がるのを待つ。
+ *   ★起動時の1回では起こし直さない（常駐はこの係の後に、新しい版で起きる）。
+ */
+async function restartRelays(d, version) {
+    if (d.boot)
+        return '起動時なので起こし直しません（常駐はこの後に新しい版で起きます）';
+    const units = relayUnits(d);
+    if (units.length === 0)
+        return '常駐がこの機にありません';
+    d.exec('systemctl', ['--user', 'try-restart', '--no-block', ...units], { timeoutMs: 30_000 });
+    const rt = path.join(d.home, '.tyhld', 'hooks', 'runtime-source.last');
+    // ★待つ上限は回数で決める（時計が進まない形でも、いつまでも回らない）。
+    const tries = Math.max(1, Math.ceil(RESTART_WAIT_MS / RESTART_POLL_MS));
+    for (let i = 1;; i++) {
+        const states = units.map((u) => d.exec('systemctl', ['--user', 'is-active', u], { timeoutMs: 10_000 }).stdout.trim());
+        let rtVersion = '';
+        try {
+            rtVersion = readFileSync(rt, 'utf8').match(/\bversion=(\S+)/)?.[1] ?? '';
+        }
+        catch {
+            // 控えが無い機もある
+        }
+        if (states.every((s) => s === 'active') && (rtVersion === '' || rtVersion === version)) {
+            return `常駐 ${units.length} 本を起こし直しました（版 ${version}）`;
+        }
+        if (i >= tries) {
+            return `常駐 ${units.length} 本のうち立ち上がらない物があります（${states.join(',')}・控えの版 ${rtVersion || '無し'}）`;
+        }
+        await d.sleep(RESTART_POLL_MS);
+    }
+}
+/** 実体がネイティブ導入（公式推奨方式）の版の置き場の物か。 */
+export function isNativeClaude(home, bin) {
+    let real = bin;
+    try {
+        real = realpathSync(bin);
+    }
+    catch {
+        // 実体を辿れなくても名前で見る
+    }
+    const dir = claudeVersionsDir(home) + path.sep;
+    return real.startsWith(dir) || bin.startsWith(dir);
+}
+/** Claude Code を公式推奨の導入台本で、版を名指しして入れる。 */
+function installClaude(d, version) {
+    const bin = path.join(claudeVersionsDir(d.home), version);
+    if (!SEMVER.test(version))
+        return { ok: false, bin, detail: `版の形が違います（${version}）` };
+    const r = d.exec('bash', ['-c', `set -o pipefail; curl -fsSL ${CLAUDE_INSTALL_URL} | bash -s "$1"`, 'claude-install', version], { env: d.env, timeoutMs: 15 * 60_000 });
+    const v = existsSync(bin) ? parseClaudeVersion(d.exec(bin, ['--version'], { timeoutMs: 15_000 }).stdout) : null;
+    if (v === version)
+        return { ok: true, bin, detail: `Claude Code ${version} を入れました（${bin}）` };
+    return { ok: false, bin, detail: `導入台本の終了 ${r.status}・${bin} の版 ${v ?? '読めません'}（${(r.error ?? r.stderr).trim().slice(-200)}）` };
+}
+/** 指名を書く（★原子的に置き換える）。 */
+function writePin(d, bin) {
+    const p = pinPath(d.home, d.env);
+    mkdirSync(path.dirname(p), { recursive: true });
+    writeFileSync(`${p}.tmp`, `${bin}\n`);
+    renameSync(`${p}.tmp`, p);
+    d.log(`Claude Code の指名を書きました: ${bin}`);
+}
+/** 入れ替え（または戻し）の後の自己診断と、その結果の扱い。 */
+async function afterSwap(d, s) {
+    const comp = s.component ?? 'conductor';
+    const trigger = s.rollback ? 'after-rollback' : comp === 'conductor' ? 'after-conductor' : 'after-claude';
+    const r = d.runSelfcheck(trigger);
+    if (r.pass) {
+        if (s.rollback)
+            addFailed(s, comp, s.from ?? undefined);
+        const detail = s.rollback
+            ? `${comp} を ${s.to} へ戻し、自己診断が通りました（戻したことは管制へ届けました）`
+            : `${comp} ${s.to} の自己診断が通りました`;
+        s.phase = 'idle';
+        delete s.rollback;
+        return done(d, s, s.lastRun?.action === 'held' ? 'recovered' : 'pass', detail);
+    }
+    const failed = r.failedKeys.join(',') || '不明';
+    if (!s.rollback) {
+        // ★前の版へ戻す（そのPCだけ）。
+        addFailed(s, comp, s.to);
+        const back = s.from ?? null;
+        if (comp === 'claude-code' && back && compareVersions(back, CLAUDE_MIN_VERSION) < 0) {
+            s.phase = 'held';
+            s.heldRecheckAt = new Date(d.now().getTime() + HELD_RECHECK_MS).toISOString();
+            return done(d, s, 'held', `Claude Code ${s.to} の自己診断が落ちました（${failed}）。戻す先 ${back} は最低版 ${CLAUDE_MIN_VERSION} より古いので戻しません（🟡）`);
+        }
+        if (!back) {
+            s.phase = 'held';
+            s.heldRecheckAt = new Date(d.now().getTime() + HELD_RECHECK_MS).toISOString();
+            return done(d, s, 'held', `${comp} ${s.to} の自己診断が落ちました（${failed}）。戻す先の版が分からないので戻せません（🟡）`);
+        }
+        d.log(`${comp} ${s.to} の自己診断が落ちました（${failed}）。この機だけ ${back} へ戻します`);
+        return rollBack(d, s, back);
+    }
+    // 戻しても直らない＝原因は版ではない。版はそのまま、🟡（人の手番なら自己診断が🔵で届けている）。
+    s.phase = 'held';
+    s.heldRecheckAt = new Date(d.now().getTime() + HELD_RECHECK_MS).toISOString();
+    // ★Claude Code・囲い・小さな試験が落ちたままなら、札を残して新しい便を取らない（便を失敗で燃やさない）。
+    const cannotWork = r.failedKeys.some((k) => ['claude', 'sandbox', 'headless'].includes(k));
+    if (cannotWork)
+        placeDrain(d, s);
+    else
+        removeDrain(d, s);
+    return done(d, s, 'held', `${comp} を ${s.to} へ戻しても自己診断が通りません（${failed}）。${cannotWork ? '札を残し、この機は新しい便を受け取りません' : '便の受け取りは続けます'}（🟡）`);
+}
+/** 前の版へ戻す。 */
+async function rollBack(d, s, back) {
+    const comp = s.component ?? 'conductor';
+    const bad = s.to;
+    s.rollback = true;
+    s.from = bad;
+    s.to = back;
+    s.swappedAt = d.now().toISOString();
+    saveState(d.home, s);
+    placeDrain(d, s);
+    if (comp === 'conductor') {
+        const r = installConductor(d, back, true);
+        d.log(r.detail);
+        refreshEntries(d.home, d.distRoot);
+        d.log(await restartRelays(d, back));
+    }
+    else {
+        // ★指名で戻す。前の実体が残っていればそれを指す（通信なしで戻せる）。無ければ公式の台本で入れ直す。
+        const prev = s.fromBin && existsSync(s.fromBin) ? s.fromBin : path.join(claudeVersionsDir(d.home), back);
+        if (existsSync(prev))
+            writePin(d, prev);
+        else {
+            const r = installClaude(d, back);
+            d.log(r.detail);
+            if (r.ok)
+                writePin(d, r.bin);
+        }
+    }
+    removeDrain(d, s);
+    return afterSwap(d, s);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 1回ぶん
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 更新係を1回流す。返り値は控え（試験で中身を見る）。
+ *   ★鍵が無い機では何も読まず・何も書かずに終わる（null）。
+ */
+export async function runUpdater(d) {
+    if (!existsSync(keyPath(d.home))) {
+        d.log(`自動更新の鍵がありません（${keyPath(d.home)}）。この機では何もしません`);
+        return null;
+    }
+    const s = loadState(d.home);
+    const now = d.now();
+    // ① 入れ替え（戻し）の直後で、自己診断がまだ → 続きから。
+    if (s.phase === 'swapped') {
+        if (d.boot)
+            return done(d, s, 'wait', '入れ替えの後の自己診断は、常駐が起きてから次の回で行います');
+        if (s.component === 'conductor') {
+            d.log(await restartRelays(d, s.to ?? ''));
+        }
+        return afterSwap(d, s);
+    }
+    // ② 戻しても直らなかった機 → 1時間ごとに測り直し、通れば元に戻る。
+    if (s.phase === 'held') {
+        if (d.boot || (s.heldRecheckAt && now.getTime() < Date.parse(s.heldRecheckAt))) {
+            return done(d, s, 'held', `自己診断が通らないまま止まっています（次の測り直し ${s.heldRecheckAt ?? '未定'}）`);
+        }
+        const r = d.runSelfcheck('daily');
+        if (r.pass) {
+            s.phase = 'idle';
+            removeDrain(d, s);
+            return done(d, s, 'recovered', '自己診断が通りました。自動更新を続けます');
+        }
+        s.heldRecheckAt = new Date(now.getTime() + HELD_RECHECK_MS).toISOString();
+        return done(d, s, 'held', `自己診断がまだ通りません（${r.failedKeys.join(',') || '不明'}）`);
+    }
+    // ③ 聞きに行く時刻か（起動時は必ず聞く）。
+    if (!d.boot && s.nextCheckAt && now.getTime() < Date.parse(s.nextCheckAt)) {
+        saveState(d.home, s);
+        return s;
+    }
+    const installed = readInstalledVersion(d.distRoot);
+    const { target, detail } = await fetchTarget(d, installed);
+    s.nextCheckAt = new Date(now.getTime() + (target?.checkAgainMin ?? DEFAULT_CHECK_MIN) * 60_000).toISOString();
+    if (!target) {
+        removeDrain(d, s);
+        s.busySince = null;
+        return done(d, s, 'skip', `管制に目標の版を聞けませんでした（${detail}）。更新しません`);
+    }
+    if (!target.ready || !target.autoUpdate || target.halted) {
+        removeDrain(d, s);
+        s.busySince = null;
+        const why = !target.ready ? '管制はまだ準備中です' : target.halted ? '管制で自動更新が止められています' : 'この機は自動更新の対象ではありません';
+        return done(d, s, 'skip', `${why}（${target.reason ?? '理由なし'}）。何もしません`);
+    }
+    // ④ どの部品を動かすか（★conductor の目標が今と違うあいだは Claude Code を動かさない）。
+    const claudeNow = d.resolveClaude();
+    let comp = null;
+    let want = null;
+    if (target.conductor && target.conductor !== installed) {
+        comp = 'conductor';
+        want = target.conductor;
+    }
+    else if (target.claudeCode && target.claudeCode !== claudeNow?.version) {
+        comp = 'claude-code';
+        want = target.claudeCode;
+    }
+    if (comp && want && s.failedVersions?.[comp]?.includes(want)) {
+        d.log(`${comp} ${want} はこの機で自己診断が通らなかった版なので入れません`);
+        comp = null;
+    }
+    if (comp === 'claude-code' && want) {
+        if (compareVersions(want, CLAUDE_MIN_VERSION) < 0) {
+            d.log(`Claude Code ${want} は最低版 ${CLAUDE_MIN_VERSION} より古いので入れません`);
+            comp = null;
+        }
+        else if (!claudeNow || !isNativeClaude(d.home, claudeNow.bin)) {
+            d.log(`Claude Code が公式推奨の導入（${claudeVersionsDir(d.home)}）ではありません（${claudeNow?.bin ?? '見つかりません'}）。` +
+                '入れ替えません（人の手番: APPLY=1 bash "$(npm root -g)/@tyhld/conductor/scripts/autoupdate-install.sh" の案内どおりにそろえる）');
+            comp = null;
+        }
+    }
+    if (!comp || !want) {
+        removeDrain(d, s);
+        s.busySince = null;
+        await reportCandidates(d, s, installed, claudeNow?.version ?? null);
+        return done(d, s, 'none', `目標の版と同じです（conductor ${installed ?? '不明'}・Claude Code ${claudeNow?.version ?? '不明'}）`);
+    }
+    // ⑤ 全現場が空きか。
+    const busy = busySites(d.home, d.isAlive);
+    if (busy.length > 0) {
+        s.busySince ??= now.toISOString();
+        const waited = now.getTime() - Date.parse(s.busySince);
+        if (waited >= BUSY_LIMIT_MS) {
+            placeDrain(d, s);
+            return done(d, s, 'draining', `${comp} ${want} へ入れ替えたいが、6時間空きが来ません。札を置いて、走っている便（${busy.join(',')}）の終わりを待ちます`);
+        }
+        return done(d, s, 'busy', `作業中の便があるので入れ替えません（${busy.join(',')}）。次の回に再挑戦します`);
+    }
+    placeDrain(d, s);
+    saveState(d.home, s);
+    if (!d.boot) {
+        // ★札を置いた瞬間に中継が便を取りかけていることがある。1周ぶん待って確かめ直す。
+        await d.sleep(d.relayCycleMs);
+        const again = busySites(d.home, d.isAlive);
+        if (again.length > 0) {
+            s.busySince ??= now.toISOString();
+            if (now.getTime() - Date.parse(s.busySince) < BUSY_LIMIT_MS)
+                removeDrain(d, s);
+            return done(d, s, 'busy', `札を置いた直後に便が始まりました（${again.join(',')}）。次の回に再挑戦します`);
+        }
+    }
+    // ⑥ 入れ替え。★入れる前に控えを書く（途中で切れても、次の回に自己診断から続ける）。
+    s.phase = 'swapped';
+    s.component = comp;
+    s.from = comp === 'conductor' ? installed : claudeNow?.version ?? null;
+    s.fromBin = comp === 'claude-code' ? claudeNow?.bin ?? null : null;
+    s.to = want;
+    s.rollback = false;
+    s.swappedAt = now.toISOString();
+    s.busySince = null;
+    saveState(d.home, s);
+    if (comp === 'conductor') {
+        const r = installConductor(d, want, false);
+        d.log(r.detail);
+        if (!r.ok && readInstalledVersion(d.distRoot) === installed) {
+            // 入れられなかった（回線など）＝何も変わっていない。版の不具合とは言わない。次の回に再挑戦。
+            s.phase = 'idle';
+            removeDrain(d, s);
+            return done(d, s, 'install-failed', r.detail);
+        }
+        refreshEntries(d.home, d.distRoot);
+        d.log(await restartRelays(d, want));
+    }
+    else {
+        const r = installClaude(d, want);
+        d.log(r.detail);
+        if (!r.ok) {
+            s.phase = 'idle';
+            removeDrain(d, s);
+            return done(d, s, 'install-failed', r.detail);
+        }
+        writePin(d, r.bin);
+    }
+    removeDrain(d, s);
+    if (d.boot)
+        return done(d, s, 'swapped', `${comp} を ${want} にしました。自己診断は常駐が起きてから次の回で行います`);
+    return afterSwap(d, s);
+}
+/**
+ * 候補の版を見つけたら、自己診断に載せて管制へ届ける（★先行機かどうかは管制が決める）。
+ *   同じ候補は1回だけ（届かなかったときは1日あけて届け直す）。
+ */
+async function reportCandidates(d, s, conductorNow, claudeNow) {
+    let latest = null;
+    if (d.npm) {
+        const env = { ...d.env, PATH: `${path.dirname(d.npm)}:${d.env.PATH ?? ''}` };
+        const r = d.exec(d.npm, ['view', CONDUCTOR_PKG, 'version', CONDUCTOR_REGISTRY_ARG], { env, timeoutMs: 60_000 });
+        const v = r.stdout.trim();
+        if (r.status === 0 && SEMVER.test(v))
+            latest = v;
+    }
+    const found = pickCandidates({ conductor: conductorNow, claude: claudeNow }, { conductor: latest, claude: await fetchClaudeStable(d.fetchImpl) });
+    const now = d.now().getTime();
+    const fresh = found.filter((c) => {
+        const prev = s.reported?.[`${c.component}@${c.version}`];
+        return !prev || (!prev.sent && now - Date.parse(prev.at) >= CANDIDATE_RETRY_MS);
+    });
+    if (fresh.length === 0)
+        return;
+    d.log(`候補の版を見つけました（${fresh.map((c) => `${c.component} ${c.version}`).join('・')}）。自己診断に載せて管制へ届けます`);
+    const r = d.runSelfcheck('candidate');
+    for (const c of fresh)
+        (s.reported ??= {})[`${c.component}@${c.version}`] = { at: d.now().toISOString(), sent: r.sent === true };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 入口
+// ─────────────────────────────────────────────────────────────────────────────
+/** 自己診断を、入れ替えた後の配布物の入口（~/.tyhld/bin/tyhld-selfcheck）を通して流す。 */
+export function selfcheckViaEntry(home, exec, env) {
+    return (trigger) => {
+        const entry = env.CONDUCTOR_SELFCHECK_ENTRY || path.join(home, '.tyhld', 'bin', 'tyhld-selfcheck');
+        const r = exec('/bin/bash', [entry, '--trigger', trigger, '--json'], { env, timeoutMs: 20 * 60_000 });
+        let parsed = {};
+        try {
+            const i = r.stdout.indexOf('{');
+            parsed = JSON.parse(i >= 0 ? r.stdout.slice(i) : '{}');
+        }
+        catch {
+            // 読めない＝FAIL として扱う（迷ったら戻す側）
+        }
+        const failedKeys = (parsed.items ?? []).filter((x) => x.ok === false).map((x) => String(x.key));
+        const pass = r.status === 0 && parsed.result === 'PASS';
+        if (!pass && failedKeys.length === 0)
+            failedKeys.push(`selfcheck(終了 ${r.status})`);
+        return { pass, failedKeys, sent: typeof parsed.sent?.sent === 'boolean' ? parsed.sent.sent : null };
+    };
+}
+/** `conductor autoupdate [--boot]` の入口。返り値は終了コード（★失敗でも 0＝タイマーを止めない。使い方の誤りだけ 2）。 */
+export async function runAutoupdateCommand(argv) {
+    let boot = false;
+    for (const a of argv) {
+        if (a === '--boot')
+            boot = true;
+        else {
+            console.error(`[autoupdate] 知らない引数: ${a}`);
+            return 2;
+        }
+    }
+    const home = os.homedir();
+    const interval = Number(process.env.CONDUCTOR_RELAY_INTERVAL_SEC ?? '15');
+    const d = {
+        home,
+        env: process.env,
+        machine: process.env.CONDUCTOR_MACHINE || os.hostname(),
+        now: () => new Date(),
+        sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
+        fetchImpl: globalThis.fetch,
+        exec: defaultExec,
+        distRoot: path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'),
+        npm: npmBesideNode(),
+        resolveClaude: () => resolveClaudeBin(),
+        runSelfcheck: selfcheckViaEntry(home, defaultExec, process.env),
+        isAlive: isProcessAlive,
+        log: (m) => console.log(`[autoupdate] ${m}`),
+        boot,
+        relayCycleMs: ((Number.isFinite(interval) && interval > 0 ? interval : 15) + 10) * 1000,
+    };
+    try {
+        await runUpdater(d);
+    }
+    catch (err) {
+        console.error(`[autoupdate] 思いがけない失敗: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return 0;
+}