@tyhld/conductor 0.12.100 → 0.12.102

package/dist/autoupdate.js

@@ -252,33 +252,82 @@ function installConductor(d, version, offline) {
     return { ok: false, detail: `npm install の終了 ${r.status}・入っている版 ${now ?? '不明'}（${(r.error ?? r.stderr).trim().slice(-200)}）` };
 }
 /**
- * 更新係・自己診断・常駐の入口を、入れ替えた配布物から写し直す（★在る物だけ・原子的に置き換える）。
+ * 入れ替え後に揃える物（配布物の中の元 → 置き場 → 実行権を付けるか）。
+ *   ★`dir` は ~/.tyhld の下の置き場の名前。番人が職人の書き込みを止める場所なので、
+ *     ここを書けるのは更新係・設置台本（人が打つ物）だけ。
+ */
+const ENTRY_SYNC = [
+    { from: 'scripts/tyhld-autoupdate.sh', dir: 'bin', to: 'tyhld-autoupdate', exe: true },
+    { from: 'scripts/tyhld-selfcheck.sh', dir: 'bin', to: 'tyhld-selfcheck', exe: true },
+    { from: 'scripts/dist-source.sh', dir: 'bin', to: 'dist-source.sh', exe: false },
+    { from: 'scripts/conductor-run.sh', dir: 'bin', to: 'conductor-run', exe: true },
+    { from: 'scripts/hooks/skill_sync_notify.py', dir: 'bin', to: 'skill_sync_notify.py', exe: false },
+    // ★Codex の完了の受け口（便 08af46e0）。
+    //   【なぜここで揃えるか】受け口の置き場（~/.tyhld/hooks/codex-notify.py）は
+    //     ~/.codex/config.toml の notify が【絶対パス】で指す1か所。版が上がって中身が変わっても、
+    //     各PCで人が設置台本（install-codex-hooks.sh）を打つまで古い受け口が残り、
+    //     新しい配り役が読む受け皿に完了の知らせが入らない。
+    //   【広げないための決め】★既に受け口が置いてあるPCだけに写す（下の `not-installed`）。
+    //     未設置のPC（Codex を使っていないPC）には1バイトも置かない。
+    //     ★~/.codex/hooks.json と ~/.codex/config.toml には触らない（設定を変える道は、
+    //       今までどおり人が設置台本を打つ）。ここで揃えるのは【受け口のファイルだけ】。
+    { from: 'scripts/codex/codex-notify.py', dir: 'hooks', to: 'codex-notify.py', exe: true },
+];
+/** 中身が1バイトも違わないか（★同じなら書き換えない＝毎回の入れ替えで日付だけ動かない）。 */
+function sameContent(a, b) {
+    try {
+        return readFileSync(a).equals(readFileSync(b));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 更新係・自己診断・常駐の入口と Codex の完了の受け口を、入れ替えた配布物から写し直す
+ * （★在る物だけ・原子的に置き換える）。
  *   常駐の入口（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) {
+    for (const { from, dir, to, exe } of ENTRY_SYNC) {
         const src = path.join(distRoot, from);
-        const dst = path.join(bin, to);
-        if (!existsSync(src) || !existsSync(dst))
+        const dst = path.join(home, '.tyhld', dir, to);
+        if (!existsSync(src)) {
+            out.push({ name: to, outcome: 'no-source' });
+            continue;
+        }
+        // ★既に置いてある物だけを揃える（未設置のPCには新しく置かない）。
+        if (!existsSync(dst)) {
+            out.push({ name: to, outcome: 'not-installed' });
             continue;
+        }
+        if (sameContent(src, dst)) {
+            out.push({ name: to, outcome: 'same' });
+            continue;
+        }
         copyFileSync(src, `${dst}.tmp`);
         if (exe)
             chmodSync(`${dst}.tmp`, 0o755);
         renameSync(`${dst}.tmp`, dst);
-        out.push(to);
+        out.push({ name: to, outcome: 'synced' });
     }
     return out;
 }
+/** 揃えた結果を1行の日本語にする（★記録に残して、あとから何をしたか読めるようにする）。 */
+export function describeEntrySync(results) {
+    const label = {
+        synced: '揃えた',
+        same: '揃える必要が無かった',
+        'not-installed': '置いていないので何もしなかった',
+        'no-source': '配布物に元が無かった',
+    };
+    const parts = ['synced', 'same', 'not-installed', 'no-source']
+        .map((k) => ({ k, names: results.filter((r) => r.outcome === k).map((r) => r.name) }))
+        .filter((g) => g.names.length > 0)
+        .map((g) => `${label[g.k]}=${g.names.join(',')}`);
+    return `入口と受け口の同期: ${parts.length > 0 ? parts.join('／') : '対象なし'}`;
+}
 /** 常駐（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 });
@@ -410,7 +459,7 @@ async function rollBack(d, s, back) {
     if (comp === 'conductor') {
         const r = installConductor(d, back, true);
         d.log(r.detail);
-        refreshEntries(d.home, d.distRoot);
+        d.log(describeEntrySync(refreshEntries(d.home, d.distRoot)));
         d.log(await restartRelays(d, back));
     }
     else {
@@ -471,6 +520,40 @@ function waitingForHuman(d, now) {
         detail: `自己診断を測り直しましたが、まだ通りません（${r.failedKeys.join(',') || '不明'}${r.humanOnly ? '・人の操作待ち' : ''}）`,
     };
 }
+/**
+ * 最後の自己診断が「仕組みの異常（🟡・fault）」で落ちたままなら、HELD_RECHECK_MS ごとに測り直す（便 cbc27db6）。
+ *
+ * 【なぜ要るか（実物 2026-10-05 00:19Z・メインPC）】
+ *   スリープから起きた直後の毎日の自己診断で、「管制との通信」の1行だけが時間切れで落ちた
+ *   （ほかの項目は全部通っていた）＝回線が戻りきる前の、その場かぎりの失敗。
+ *   ところがこの FAIL は【次の毎日の自己診断（翌日）まで残る】。そのあいだ管制は🟡のままで、
+ *   この機は後続の順番から外れ、新しい版を受け取れない。人が手で流し直すまで戻らなかった。
+ *   ＝人の手で直すのではなく、更新係が測り直して、通ったら自分で元に戻れるようにする（根治）。
+ *
+ * 【緩めていない所】
+ *   ★合否の決め方は1つも変えない。通らなければ今までどおり FAIL のまま（管制が🟡にし、順番から外す）。
+ *   ★入れ替えの直後（after-conductor・after-claude）の FAIL には当てない。
+ *     あちらは phase が swapped / held で先に処理されるので、ここまで来ない（戻す → 自己診断のまま）。
+ *   ★測り直すたびに小さな試験の費用がかかるので、間隔は held の測り直しと同じ（それより短くしない）。
+ *   ★常駐がまだ起きていない起動時（boot）は測らない（常駐が動いていない＝落ちて当たり前）。
+ *   ★通ったことは自己診断自身が管制へ届ける（更新係は届け直さない）。
+ */
+function recheckAfterFault(d, now) {
+    if (d.boot)
+        return '';
+    const last = readLastSelfcheck(d.home);
+    if (!last || last.pass || last.humanOnly)
+        return '';
+    const age = last.finishedAt === null ? Infinity : now.getTime() - last.finishedAt;
+    if (age < HELD_RECHECK_MS)
+        return '';
+    const r = d.runSelfcheck('daily');
+    const detail = r.pass
+        ? '仕組みの異常（🟡）で落ちていた自己診断を測り直したら通りました（管制へも届きました）'
+        : `仕組みの異常（🟡）の自己診断を測り直しましたが、まだ通りません（${r.failedKeys.join(',') || '不明'}）`;
+    d.log(detail);
+    return detail;
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // 1回ぶん
 // ─────────────────────────────────────────────────────────────────────────────
@@ -530,6 +613,10 @@ export async function runUpdater(d) {
     // ③-2 人の操作待ち（🔵）で自己診断が落ちたままなら、測り直してから先へ進む（便 4cf71dde）。
     //   ★落ちたまま入れ替えると、同じ理由で落ちて戻し、版に疑いが付く（実物 2026-10-03 02:43Z・ノートPC）。
     const human = waitingForHuman(d, now);
+    // ③-3 仕組みの異常（🟡）で自己診断が落ちたままなら、held と同じ間隔で測り直す（便 cbc27db6）。
+    //   ★その場かぎりの時間切れで落ちた FAIL が翌日まで残り、この機が順番から外れたままになるのを直す。
+    //   ★入れ替えるかどうかの決め方は1つも変えない（通らなければ今までどおり FAIL のまま）。
+    const refault = recheckAfterFault(d, now);
     // ④ どの部品を動かすか（★conductor の目標が今と違うあいだは Claude Code を動かさない）。
     const claudeNow = d.resolveClaude();
     let comp = null;
@@ -565,7 +652,8 @@ export async function runUpdater(d) {
         // ★後続の機は候補を探さない・候補の自己診断を流さない（役は管制が決める・欄が無ければ今までどおり）。
         if (target.role !== 'follower')
             await reportCandidates(d, s, installed, claudeNow?.version ?? null);
-        return done(d, s, 'none', `目標の版と同じです（conductor ${installed ?? '不明'}・Claude Code ${claudeNow?.version ?? '不明'}）`);
+        const same = `目標の版と同じです（conductor ${installed ?? '不明'}・Claude Code ${claudeNow?.version ?? '不明'}）`;
+        return done(d, s, 'none', refault ? `${same}。${refault}` : same);
     }
     if (human.waiting) {
         removeDrain(d, s);
@@ -615,7 +703,7 @@ export async function runUpdater(d) {
             removeDrain(d, s);
             return done(d, s, 'install-failed', r.detail);
         }
-        refreshEntries(d.home, d.distRoot);
+        d.log(describeEntrySync(refreshEntries(d.home, d.distRoot)));
         d.log(await restartRelays(d, want));
     }
     else {

package/dist/headless.js

@@ -19,7 +19,7 @@ import { createInterface } from 'node:readline';
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-import { CENTRAL_BUSY_HOLD_MAX_MS, RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_RESTORE_ORPHANS_ENABLED, ackResumeSignal, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, WAIT_CLOSED_STATUS, FINISH_GATE_KINDS, reportDelivery, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
+import { CENTRAL_BUSY_HOLD_MAX_MS, RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_RESTORE_ORPHANS_ENABLED, ackResumeSignal, buildAnchor, buildSendText, canDeliver, completeWithReportOutcome, createRelayState, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, WAIT_CLOSED_STATUS, FINISH_GATE_KINDS, reportDelivery, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
 import { claudePinPath, readClaudePinLine, } from './autoupdate-flags.js';
 const log = (msg) => {
     console.log(`[headless] ${msg}`);
@@ -1471,10 +1471,16 @@ async function checkRunningJob(cfg, state) {
             // ★書けるまでやり直す（便 6ebba0d0）。以前は false のとき patchStatus を1回試し、
             //   成否を見ずに state.job を畳んでいた＝誰も done を書いていないのに便を手放していた。
             //   畳まない間は次の便を配らない／管制には生存報告と理由が残る。
-            if (await completeWithReport(cfg, job.commandId, log)) {
+            // ★「どう畳んだか」を見て、手番の記録にも実際を書く（便 f20dd761 の候補3）。
+            //   以前は畳めたら必ず outcome=done・detail=「報告まで出しました」だった。
+            //   本番操作の承認待ちで閉じた手番（完了は1バイトも書いていない）まで
+            //   「報告まで出しました」になり、`kc 現場名` が「終わりました」と見せていた。
+            //   ★札（outcome）は増やさない。実際を言うのは detail の役目にする。
+            const settle = await completeWithReportOutcome(cfg, job.commandId, log);
+            if (settle.settled) {
                 state.doneWriteTries?.delete(job.commandId);
-                log(`site=${cfg.site} id=${job.commandId} 完了（exit=0, attempt ${job.attempt}）`);
-                noteLastJob('done', '報告まで出しました');
+                log(`site=${cfg.site} id=${job.commandId} 畳みます（exit=0, attempt ${job.attempt}・${settle.detail}）`);
+                noteLastJob('done', settle.detail);
                 state.job = null;
                 rs.lastHeartbeatAt = null;
                 return;

package/dist/relay.js

@@ -3491,6 +3491,8 @@ export async function fetchControl(cfg) {
         return {
             relayHalted: true,
             ok: false,
+            // ★例外で落ちた＝時間切れ・回線の失敗。断られた答え（HTTP 非2xx）はここへ来ない（上で返している）。
+            transient: true,
             detail: err instanceof Error ? err.message : String(err),
         };
     }
@@ -3679,8 +3681,16 @@ export async function patchStatus(cfg, id, status, report) {
  *   書けなければ未処理のまま残す＝次tickでやり直せるし、管制も生存報告で気づける。
  *
  * 返り: 追跡を畳んでよいか（true = 便の終了状態が確定した／false = 書けていない＝次の周でやり直す）。
+ *   ★★「どう畳んだか」も要るときは completeWithReportOutcome を呼ぶ（手番の記録に実際を書くため）。
  */
 export async function completeWithReport(cfg, id, logLine = log) {
+    return (await completeWithReportOutcome(cfg, id, logLine)).settled;
+}
+/**
+ * 完了を1回で送り、【どう畳んだか】も返す（★中身の説明は上の completeWithReport と同じ）。
+ *   呼び手は settled だけ見てもよいが、手番の記録を書くときは kind・detail も使う。
+ */
+export async function completeWithReportOutcome(cfg, id, logLine = log) {
     // ★①報告がどの段にあるか＋形が整っているか（送る工程の話）。②③の実行可否には使わない。
     //   ★形が整っていない報告は「届いた」と数えない（便 461be339）。ファイルは消さず・移さず残す。
     const delivery = reportDelivery(id);
@@ -3697,7 +3707,7 @@ export async function completeWithReport(cfg, id, logLine = log) {
             (phase === 'pending' && !delivery.delivered
                 ? `→relayからは送りません（${delivery.note}＝未処理のまま残します）`
                 : '→relayからは送りません（報告は控えとして処理済みにしました）'));
-        return true;
+        return { settled: true, kind: 'already-finished', detail: `管制で既に終わっていました（${already}）` };
     }
     if (isWaitClosedCommandStatus(already)) {
         // ★待ちのまま閉じられた便（本番操作の承認待ち・管制 PR #425）。★完了を1バイトも書かない。
@@ -3709,30 +3719,43 @@ export async function completeWithReport(cfg, id, logLine = log) {
         logLine(`site=${cfg.site} id=${id} は待ちのまま閉じられています(status=${already})` +
             '→完了は書きません（本番操作が済めば管制の合図で同じ便の続きから起きます）' +
             (phase === 'none' ? '' : `／報告は手元の控えに残します（${phase}）`));
-        return true;
+        return {
+            settled: true,
+            kind: 'wait-closed',
+            // ★ここが「報告まで出しました」になっていると、承認を待っている手番が
+            //   「終わりました」と記録される（便 f20dd761 の候補3）。実際を書く。
+            detail: '本番操作の承認待ちのまま閉じました（完了は書いていません。承認が済めば続きから起きます）',
+        };
     }
     if (phase === 'processed') {
         // ★①は済み・②は未了。本文は渡してあるので、状態だけを書く（開発履歴を2件にしない）。
         //   書けなければ false＝次の周でやり直す（完了を落とさない）。
-        if (!(await patchStatus(cfg, id, 'done')))
-            return false;
+        if (!(await patchStatus(cfg, id, 'done'))) {
+            return { settled: false, kind: 'not-written', detail: '便の終了状態を管制へ書けませんでした' };
+        }
         logLine(`site=${cfg.site} id=${id} done（報告は回収の道で渡し済み＝本文は添えない）`);
-        return true;
+        return { settled: true, kind: 'done', detail: '報告まで出しました' };
     }
     // ★形が整っていない報告は添えない（書きかけを完了の材料にしない）。便の確定は今までどおり行う
     //   ＝現場を占有したままにしない。「報告が届いていない」ことは終了の事実で管制へ届く。
     const report = delivery.delivered && delivery.raw !== null ? parseReport(delivery.raw).body : null;
-    if (!(await patchStatus(cfg, id, 'done', report)))
-        return false;
+    if (!(await patchStatus(cfg, id, 'done', report))) {
+        return { settled: false, kind: 'not-written', detail: '便の終了状態を管制へ書けませんでした' };
+    }
     if (report !== null)
         markReportProcessed(id); // ★消さずに処理済みへ（同じ報告を二度送らない）
-    logLine(`site=${cfg.site} id=${id} done` +
-        (report !== null
-            ? `（報告添付・${report.length}文字）`
-            : phase === 'none'
-                ? '（報告ファイルなし＝完了のみ）'
-                : `（${delivery.note}＝添えずに未処理のまま残します）`));
-    return true;
+    const how = report !== null
+        ? `（報告添付・${report.length}文字）`
+        : phase === 'none'
+            ? '（報告ファイルなし＝完了のみ）'
+            : `（${delivery.note}＝添えずに未処理のまま残します）`;
+    logLine(`site=${cfg.site} id=${id} done${how}`);
+    return {
+        settled: true,
+        kind: 'done',
+        // ★報告が無い／形が整っていない回を「報告まで出しました」と言わない。
+        detail: report !== null ? '報告まで出しました' : `完了は書きました${how}`,
+    };
 }
 /**
  * 「実プロセスが無い・報告は渡し済み・管制ではまだ終わっていない」便に、便の終了状態だけを書く

package/dist/selfcheck.js

@@ -235,6 +235,12 @@ export function aiKanaMcpState(mcp) {
 export const MCP_SETTLE_TRIES = 3;
 export const MCP_SETTLE_WAIT_MS = 5_000;
 export const MCP_LIST_TIMEOUT_MS = 45_000;
+/**
+ * 「緊急停止の読み取り」が時間切れ・回線の失敗で通らなかったとき、読み直すまでの待ち（便 cbc27db6）。
+ *   ★読み直しは1回だけ（回線が戻るのを待つだけなので、何度も読まない）。
+ *   ★管制が断った答え（HTTP 401・403・500 など）は読み直さない＝この待ちも入らない。
+ */
+export const CONTROL_RETRY_WAIT_MS = 5_000;
 /**
  * `claude mcp list` の出力を読む（★実機 2026-10-03・Claude Code 2.1.287 の形）。
  *   `claude.ai ai-kana: https://… - ✔ Connected` ／ `ai-kana: https://… (HTTP) - ! Needs authentication` ／
@@ -459,11 +465,30 @@ async function checkCentral(d) {
         return item;
     }
     const site = d.env.CONDUCTOR_SITE || 'selfcheck';
-    const ctl = await withFetch(d, () => fetchControl({ url, token, machine: d.machine, site }));
+    const read = () => withFetch(d, () => fetchControl({ url, token, machine: d.machine, site }));
+    let ctl = await read();
+    /** 1回目が「その場かぎりの失敗」で通らなかったときの、その理由（読み直していなければ null）。 */
+    let firstDetail = null;
+    if (!ctl.ok && ctl.transient) {
+        // ★時間切れ・回線の失敗のときだけ、少し待って1回だけ読み直す（便 cbc27db6）。
+        //   実物 2026-10-05 00:19Z メインPC：スリープから起きた直後の毎日の自己診断で、回線が戻りきる前に
+        //   読んで時間切れ（The operation was aborted due to timeout）。ほかは全部通っているのに FAIL になり、
+        //   🟡 が次の日の自己診断まで残って、この機が後続の順番から外れた。
+        //   ★管制が断った答え（HTTP 401・403・500 など）と応答が不正は読み直さない（待っても変わらない）。
+        firstDetail = ctl.detail;
+        const sleep = d.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+        await sleep(CONTROL_RETRY_WAIT_MS);
+        ctl = await read();
+    }
+    const again = firstDetail === null
+        ? ''
+        : ctl.ok
+            ? `・1回目は通りませんでした（${firstDetail}）・2回目で通りました`
+            : `・1回目も通りませんでした（${firstDetail}）`;
     if (ctl.ok)
-        pass(item, `緊急停止の読み取りが通りました（停止中=${ctl.relayHalted ? 'はい' : 'いいえ'}）`);
+        pass(item, `緊急停止の読み取りが通りました（停止中=${ctl.relayHalted ? 'はい' : 'いいえ'}）${again}`);
     else
-        fail(item, 'fault', `緊急停止の読み取りが通りません（${ctl.detail}）`);
+        fail(item, 'fault', `緊急停止の読み取りが通りません（${ctl.detail}）${again}`);
     return item;
 }
 /** relay.ts の fetch を試験で差し替えるための包み（globalThis.fetch を一時的に置き換える）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.100",
+  "version": "0.12.102",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {

package/scripts/hooks/skill_sync_notify.py

@@ -110,22 +110,32 @@ REINSTALL = ('npm install -g @tyhld/conductor '
 RESYNC = 'APPLY=1 bash "$(npm root -g)/@tyhld/conductor/scripts/update-guard.sh"'
 
 
-def autoupdate_enabled():
-    """自動更新が入っている PC か（自社PCの鍵 ~/.tyhld/bin/autoupdate/enabled・便 29babc5d）。"""
-    return os.path.isfile(os.path.join(os.path.expanduser('~'), '.tyhld', 'bin', 'autoupdate', 'enabled'))
+def autoupdate_enabled(home=None):
+    """自動更新が入っている PC か（自社PCの鍵 ~/.tyhld/bin/autoupdate/enabled・便 29babc5d）。
+
+    【なぜ住まいを受け取れる形にしたか（便 f20dd761 の重大発見2・便 08af46e0 で直した）】
+      住まいを中で決めていたので、試験が【実機の住まい】を覗いてしまっていた。
+      自動更新が入っているPCでは案内が「次の自動更新でそろいます」に変わるため、
+      同じ試験が機体によって通ったり落ちたりした。呼び手から渡せる形にして、
+      試験は使い捨ての住まいで判定する＝どのPCでも同じ結果になる。
+    """
+    base = os.path.expanduser('~') if home is None else home
+    return os.path.isfile(os.path.join(base, '.tyhld', 'bin', 'autoupdate', 'enabled'))
 
 
-def recovery_steps(reason):
+def recovery_steps(reason, home=None):
     """うまくいかなかった理由に【合った】手順を返す（便 675e2d05）。
 
     【なぜ理由ごとに分けるか（実地 2026-09-20・便 8692c586 の重大発見1）】
       以前は理由によらず「update-guard を打ってください」の固定文だった。version-drift
       （入っている版と公開の版が違う）のときにこれを打っても、配り元の確認でまた弾かれる＝
       同じ失敗を繰り返すだけで直らない。先に入れ直しが要る。
+
+    home … 自動更新の鍵を探す住まい（既定は実機の住まい。試験は使い捨てを渡す）。
     """
     if reason in ('flagged-bad', 'flagged-suspect'):
         # ★管制で不具合・疑いの印が付いた版（便 29babc5d）。入れ直しても同じ版なら直らない。
-        if autoupdate_enabled():
+        if autoupdate_enabled(home):
             return ['再開のしかた: この PC は自動更新が入っています。管制が直した版を決めれば、'
                     '次の自動更新で入れ替わります（人の操作は要りません）。']
         return ['再開のしかた: この版には管制で不具合の印が付いています。CC1 に知らせてください'
@@ -134,7 +144,7 @@ def recovery_steps(reason):
         # ★自動更新が入っている PC は、更新係が管制の決めた版へそろえる（便 29babc5d）。
         #   人が npm で入れると段階配布の順番が崩れるので、入れ直しを促さない。
         #   ★not-installed・incomplete は配布物そのものが無い＝更新係も動けないので、自動更新の有無によらず入れ直す。
-        if autoupdate_enabled() and reason in ('unpublished', 'deprecated', 'version-drift'):
+        if autoupdate_enabled(home) and reason in ('unpublished', 'deprecated', 'version-drift'):
             return ['再開のしかた: この PC は自動更新が入っています。次の自動更新（管制が決めた版を、'
                     '作業中の便が終わってから入れます）でそろいます。管制の「PCの状態」で確かめてください。']
         return [f'再開のしかた: この PC で次の順に打ってください。① {REINSTALL}',
@@ -153,7 +163,7 @@ def recovery_steps(reason):
     return [f'再開のしかた: この PC で次の1行を打ってください。　{RESYNC}']
 
 
-def build_payload(rec, env=None):
+def build_payload(rec, env=None, home=None):
     """カードの中身。★何が起きていて、何をすれば直るかを日本語で書く。
 
     ★本文は【その回の控え（rec）の実際の値】だけから組み立てる。固定の版番号や、
@@ -165,7 +175,7 @@ def build_payload(rec, env=None):
     kind = notice_kind(rec)
     lines = [
         f'いま止まっているもの: この PC（{machine}）で、{kind["stopped"]}',
-        *recovery_steps(reason),
+        *recovery_steps(reason, home),
         '★このカードは管制からは押せません（この PC での操作が要ります）。',
         f'PC: {machine}／うまくいかなかった理由: {reason}',
         f'最後に試した時刻: {rec.get("at", "不明")}',
@@ -231,13 +241,15 @@ def _close(cfg, datalink, cards, key, path=None):
     return True
 
 
-def run(last_path, cfg=None, datalink=hook_datalink, state_path=None):
+def run(last_path, cfg=None, datalink=hook_datalink, state_path=None, home=None):
     """返り値: 出したカードのID / None（出さなかった・閉じただけ）。
 
     ★失敗の回 … 前に出した札を【閉じてから】出し直す。管制は同じ鍵の再登録を寿命の延長
       として扱い、本文は最初のままになる（実地 2026-09-20・札に 4日前の版が出ていた）。
       閉じてから出し直せば、本文は必ずその回の値になる。
     ★成功の回 … 出していた札を閉じる。直ったのに札が最大60分出たままにならない。
+
+    home … 自動更新の鍵を探す住まい（既定は実機の住まい。試験は使い捨てを渡す）。
     """
     rec = parse_last(last_path)
     status = rec.get('status')
@@ -256,7 +268,7 @@ def run(last_path, cfg=None, datalink=hook_datalink, state_path=None):
 
     # 失敗。★古い本文の札が残っていたら先に閉じる（上書きできない作りへの対処）。
     _close(cfg, datalink, cards, key, state_path)
-    reg = datalink.register(cfg, build_payload(rec))
+    reg = datalink.register(cfg, build_payload(rec, home=home))
     if not reg or not reg.get('id'):
         return None
     cards[key] = reg['id']

package/scripts/hooks/test_skill_sync_notify.py

@@ -23,6 +23,12 @@
   (i) 成功の回は【出していた札を閉じる】＝直ったのに札が最大60分出たままにならない。
   (j) 再開の手順が【うまくいかなかった理由に合っている】＝同じ失敗を繰り返させない。
       版のずれに「配り直してください」とだけ言っても、配り元の確認でまた弾かれる。
+
+【★便 08af46e0 で塞いだ穴（便 f20dd761 の重大発見2）】
+  (k) 自動更新が入っているかの判定は【呼び手が渡した住まい】だけを見る。
+      以前は中で実機の住まい（~/.tyhld/bin/autoupdate/enabled）を覗いていたので、
+      自動更新が入ったPCでは案内の文が変わり、(j) の判定が機体ごとに通ったり落ちたりした。
+      この試験は使い捨ての住まいを渡すので、どのPCでも同じ結果になる。
 """
 import json
 import os
@@ -279,12 +285,19 @@ with tempfile.TemporaryDirectory() as tmp:
 # ── (j) 再開の手順が理由に合っている ────────────────────────────────────────
 print('\n【(j) 再開の手順が、うまくいかなかった理由に合っている】')
 with tempfile.TemporaryDirectory() as tmp:
-    def body_for(reason, what='dist-source'):
+    # ★自動更新の鍵を探す住まいは、必ず【この回だけの使い捨て】を渡す（便 08af46e0）。
+    #   既定は実機の住まい（~/.tyhld/bin/autoupdate/enabled）なので、渡さないと
+    #   自動更新が入っているPCでは案内が別の文に変わり、同じ試験が機体によって落ちる
+    #   （便 f20dd761 の重大発見2）。下の PLAIN_HOME は鍵を置かない＝自動更新なしのPC。
+    PLAIN_HOME = os.path.join(tmp, 'home-plain')
+    os.makedirs(PLAIN_HOME, exist_ok=True)
+
+    def body_for(reason, what='dist-source', home=PLAIN_HOME):
         line = (f'2026-09-20T09:00:00+0900 status=failed reason={reason} what={what} '
                 'version=0.12.6 published=0.12.31 root=/n/@tyhld/conductor')
         link = FakeLink()
         sn.run(write(tmp, f'{reason}.last', line + '\n'), datalink=link,
-               state_path=state(tmp, f'{reason}.json'))
+               state_path=state(tmp, f'{reason}.json'), home=home)
         return link.sent[0]['question']
 
     drift = body_for('version-drift')
@@ -332,21 +345,33 @@ with tempfile.TemporaryDirectory() as tmp:
 
     # ★自動更新が入っている PC（鍵 ~/.tyhld/bin/autoupdate/enabled）は、人に npm で入れさせない
     #   （更新係が管制の決めた版へそろえる。人が入れると段階配布の順番が崩れる）。
-    old_home = os.environ.get('HOME')
-    os.environ['HOME'] = tmp
-    try:
-        os.makedirs(os.path.join(tmp, '.tyhld', 'bin', 'autoupdate'), exist_ok=True)
-        write(os.path.join(tmp, '.tyhld', 'bin', 'autoupdate'), 'enabled', 'x\n')
-        auto = body_for('unpublished')
-        check_true('自動更新の PC: 次の自動更新でそろうと書く', '次の自動更新' in auto)
-        check('自動更新の PC: npm で入れさせない', 'npm install -g' in auto, False)
-        check_true('自動更新の PC・不具合の印: 人の操作は要らないと書く', '人の操作は要りません' in body_for('flagged-suspect'))
-        check_true('自動更新の PC でも、配布物が無いときは入れ直す', 'npm install -g' in body_for('not-installed'))
-    finally:
-        if old_home is None:
-            os.environ.pop('HOME', None)
-        else:
-            os.environ['HOME'] = old_home
+    #   ★判定する住まいは使い捨てを渡す（実機の住まいを覗かない＝どのPCでも同じ結果）。
+    AUTO_HOME = os.path.join(tmp, 'home-auto')
+    os.makedirs(os.path.join(AUTO_HOME, '.tyhld', 'bin', 'autoupdate'), exist_ok=True)
+    write(os.path.join(AUTO_HOME, '.tyhld', 'bin', 'autoupdate'), 'enabled', 'x\n')
+    auto = body_for('unpublished', home=AUTO_HOME)
+    check_true('自動更新の PC: 次の自動更新でそろうと書く', '次の自動更新' in auto)
+    check('自動更新の PC: npm で入れさせない', 'npm install -g' in auto, False)
+    check_true('自動更新の PC・不具合の印: 人の操作は要らないと書く',
+               '人の操作は要りません' in body_for('flagged-suspect', home=AUTO_HOME))
+    check_true('自動更新の PC でも、配布物が無いときは入れ直す',
+               'npm install -g' in body_for('not-installed', home=AUTO_HOME))
+
+    # ★判定は【渡した住まい】だけを見る＝実機の住まいに鍵が在っても無くても結果が変わらない
+    #   （便 f20dd761 の重大発見2 の根治。ここが穴だと、この試験は機体ごとに答えが変わる）。
+    check('鍵の無い住まい: 自動更新なしと判定', sn.autoupdate_enabled(PLAIN_HOME), False)
+    check('鍵の在る住まい: 自動更新ありと判定', sn.autoupdate_enabled(AUTO_HOME), True)
+    for fake_home in (PLAIN_HOME, AUTO_HOME, tmp):
+        old_home = os.environ.get('HOME')
+        os.environ['HOME'] = fake_home
+        try:
+            check(f'実機の住まいを覗かない（HOME={os.path.basename(fake_home)}）',
+                  sn.autoupdate_enabled(PLAIN_HOME), False)
+        finally:
+            if old_home is None:
+                os.environ.pop('HOME', None)
+            else:
+                os.environ['HOME'] = old_home
 
 # ── ★札の覚え書き（壊れていても・書けなくても止まらない）──────────────────
 print('\n【★札の覚え書き】')