@tyhld/conductor 0.12.84 → 0.12.85

package/dist/autoupdate-flags.js

@@ -0,0 +1,62 @@
+/**
+ * 自動更新の土台（便 b7bd5e43・設計 3ed9e2b2 の A2）— 「入れ替え待ちの札」と「Claude Code の指名」。
+ *
+ * ★どちらも【置くのは更新係（次の便 A3）か人】。中継と自己診断はここを読むだけ。
+ *
+ * 【置き場は ~/.tyhld/bin/autoupdate/（職人が書けない場所）】
+ *   設計の案は札を ~/.local/state/conductor/drain、指名を ~/.tyhld/claude-pin に置く形だった。
+ *   実機と番人の判定で確かめると（2026-10-02・このPC）:
+ *     ・~/.local/state/conductor/ … 職人の Bash から書けて消せる。番人も止めない。
+ *     ・~/.tyhld/ の直下         … Write・Edit の道具は番人が止めるが、Bash の touch・rm・
+ *                                   リダイレクト・python などは番人が通す（守る場所の一覧
+ *                                   GUARD_PLACES に入っているのは ~/.tyhld/hooks と ~/.tyhld/bin だけ）。
+ *     ・~/.tyhld/bin/ の下        … どの書き方でも番人が止める（下の階層も含む）。
+ *   職人が札を【置ける】と、自分で全現場の便を止められる。【外せる】と、入れ替えの途中に
+ *   便を入れられ、起こし直しで作業中の職人ごと止まる（試行回数を1つ使う）。
+ *   ★番人の判定は変えない（この便の決め）ので、もう守られている ~/.tyhld/bin の下に置く。
+ *   更新係は systemd の中で動き、番人を通らないので書ける（置き場は更新係と同じ ~/.tyhld/bin）。
+ *   ★囲い（sandbox）の効いている現場では、どちらの置き場もそもそも書けない（自己診断④で確かめる）。
+ *
+ * 【試験用の入口】★安全境界ではない（ほかの CONDUCTOR_* と同じ）。
+ *   CONDUCTOR_DRAIN_FILE       … 札の場所を差し替える
+ *   CONDUCTOR_CLAUDE_PIN_FILE  … 指名の場所を差し替える
+ */
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { autoupdateDir } from './relay.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 入れ替え待ちの札
+// ─────────────────────────────────────────────────────────────────────────────
+// ★札を読む本体は relay.ts に置く（relay.ts は試験が src から直接読み込むので、
+//   ほかの src を import できない＝自分の中で完結させる）。ここは同じ物を見せるだけ。
+export { autoupdateDir, drainFilePath, readDrain } from './relay.js';
+/** 生存報告に載せる形（札が在るときだけ）。 */
+export function drainReport(d, now = Date.now()) {
+    if (!d.active)
+        return null;
+    return {
+        drain: true,
+        drainSince: d.sinceMs === null ? null : new Date(d.sinceMs).toISOString(),
+        drainSec: d.sinceMs === null ? null : Math.max(0, Math.round((now - d.sinceMs) / 1000)),
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Claude Code の指名
+// ─────────────────────────────────────────────────────────────────────────────
+/** 指名の場所。中身は1行目＝claude の実行ファイルの絶対パス（それ以外の行は読まない）。 */
+export function claudePinPath() {
+    return process.env.CONDUCTOR_CLAUDE_PIN_FILE || path.join(autoupdateDir(), 'claude-pin');
+}
+/** 指名のファイルの1行目を読む。無ければ undefined、読めなければ null。 */
+export function readClaudePinLine(file = claudePinPath()) {
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch (e) {
+        if (e?.code === 'ENOENT')
+            return undefined;
+        return null;
+    }
+    return (raw.split('\n')[0] ?? '').trim();
+}

package/dist/cli.js

@@ -15,7 +15,7 @@ import { fileURLToPath } from 'node:url';
 import os from 'node:os';
 import path from 'node:path';
 import { RELAY_FETCH_TIMEOUT_MS, createRelayState, deliveryReport, parseAgentKind, reconnectDelayMs, relayTick, tmuxHasSession, pendingReportIds, sendPendingReportFiles, sweepProcessedReports, } from './relay.js';
-import { createHeadlessState, headlessNextDelayMs, headlessTick, headlessTrackedCommandIds, parseRunnerMode, } from './headless.js';
+import { createHeadlessState, headlessNextDelayMs, headlessTick, headlessTrackedCommandIds, evaluateClaudePin, lastClaudePinStatus, parseRunnerMode, } from './headless.js';
 import { runViewCommand } from './view.js';
 import { createRelayRunner } from './relay-runner.js';
 import { installProcessGuards } from './process-guard.js';
@@ -24,6 +24,8 @@ import { startEar } from './ear.js';
 import { loadEarConfig } from './ear-routing.js';
 import { ensureEnvFilePermissions } from './env-file-perm.js';
 import { createCentralPorts } from './build-central.js';
+import { drainReport, readDrain } from './autoupdate-flags.js';
+import { runSelfcheckCommand } from './selfcheck.js';
 import { BUILD_NUDGE_NAME, REQUIRED_ENV, createBuildRunner, createMemoStore, loadBuildRunnerConfig, } from './build-runner.js';
 /**
  * relay の状態の参照（生存報告に「いま配れるか」を載せるため）。
@@ -199,6 +201,14 @@ async function sendReport(cfg) {
         if (d.waitingSec !== null)
             body.waitingSec = d.waitingSec;
     }
+    // ★入れ替え待ちの札と Claude Code の指名（便 b7bd5e43）。どちらも【在るときだけ】載せる
+    //   ＝札も指名も無い機の本文は今までと1バイトも変わらない。
+    const drain = drainReport(readDrain());
+    if (drain)
+        Object.assign(body, drain);
+    const pin = process.env.CONDUCTOR_CLAUDE_BIN ? lastClaudePinStatus() : evaluateClaudePin().status;
+    if (pin.state !== 'none')
+        body.claudePin = pin;
     // ★未処理の報告（まだ管制へ渡せていない控え）の指示IDを載せる（便 57c04e6d）。
     //   1件も無ければ載せない＝今までと同じ本文。多すぎるときは上限までにして総数を添える。
     const pending = pendingReportIds();
@@ -489,6 +499,8 @@ function printUsage() {
         '  conductor build-runner                                            この機に1本の「司令塔」（試作の段取り役）',
         '  conductor setup <現場名> [フォルダ] [--profile <default|proto>]     采配くんをこのPCに設置する（初回の1回だけ）',
         '  conductor view <現場名> [--once] [--detail]                        その現場の今を見るだけの画面（kc の実体）',
+        '  conductor selfcheck [--trigger <daily|after-conductor|after-claude|after-rollback|manual>] [--json] [--no-send]',
+        '                                                                    この機の自己診断（副作用なし・結果は手元の控えと管制へ）',
         '',
         '見るだけの画面（conductor view ＝ kc 現場名）:',
         '  いま職人が何をしているかを、やさしい日本語で見るだけの画面です。',
@@ -574,6 +586,10 @@ async function main() {
             // ★引数はそのまま setup.sh へ渡す（judgement は全部インストーラ側）。
             runSetupCommand(process.argv.slice(3));
             break;
+        case 'selfcheck':
+            // ★自己診断（便 b7bd5e43・A1）。副作用なし（commit・push・PR・合流・配備・公開をしない）。
+            process.exit(await runSelfcheckCommand(process.argv.slice(3)));
+            break;
         case 'view':
             // ★見るだけの画面。職人も tmux も relay も起動せず、入力も受け付けない。
             //   既定は「開いたまま流れ続ける」ので、Ctrl+C まで戻らない（--once は1回で戻る）。

package/dist/headless.js

@@ -19,7 +19,8 @@ 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, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, 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, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, recoverStuckProcessedReports, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
+import { claudePinPath, readClaudePinLine, } from './autoupdate-flags.js';
 const log = (msg) => {
     console.log(`[headless] ${msg}`);
 };
@@ -352,6 +353,64 @@ export function claudeUpdateHint(bin) {
     }
     return `入れ方を見分けられませんでした。ネイティブ導入なら "${bin}" update ／ npm 導入なら npm install -g @anthropic-ai/claude-code@latest`;
 }
+// ── Claude Code の指名（~/.tyhld/bin/autoupdate/claude-pin・便 b7bd5e43） ─────
+//
+// 【なぜ要るか（設計 3ed9e2b2 の発見4）】中継はいちばん新しい claude を選ぶ。2つ入っている機では、
+//   更新係が片方を元の版へ戻しても、もう片方の新しい版が選ばれて戻らない。更新係が「この実体を
+//   使う」と指名できるようにする。★置くのは更新係（~/.tyhld/bin の下＝番人がどの書き方でも止める＝職人は書けない）。
+// 【決め】指名が無い機は今までと1つも変わらない。CONDUCTOR_CLAUDE_BIN の指定は今までどおり最優先。
+//   指名の実体が無い・読めない・最低版より古いときは、今までの選び方に戻り、その理由を管制へ届ける。
+const CLAUDE_PIN_NONE = { state: 'none', pinned: null, reason: null, version: null };
+/** 直近に resolveClaudeBin が決めた指名の扱い（生存報告と自己診断が読む）。 */
+let lastClaudePin = CLAUDE_PIN_NONE;
+export function lastClaudePinStatus() {
+    return lastClaudePin;
+}
+/** 指名を確かめた結果の控え（★同じ指名・同じ実体なら --version を打ち直さない）。 */
+let pinCache = null;
+/**
+ * 指名を確かめる。info が在れば指名どおりの claude を使ってよい。
+ *   ★指名が無ければ { info: null, status: none }＝呼び出し側は今までの選び方をそのまま使う。
+ */
+export function evaluateClaudePin(file = claudePinPath()) {
+    const line = readClaudePinLine(file);
+    if (line === undefined)
+        return { info: null, status: CLAUDE_PIN_NONE };
+    const fallback = (reason, pinned, version = null) => ({
+        info: null,
+        status: { state: 'fallback', pinned, reason: `${reason}。今までの選び方（いちばん新しい版）に戻りました`, version },
+    });
+    if (line === null)
+        return fallback('指名のファイルを読めません', null);
+    if (line === '')
+        return fallback('指名のファイルが空です', null);
+    if (!path.isAbsolute(line))
+        return fallback(`指名が絶対パスではありません（${line}）`, line);
+    let key = '';
+    try {
+        const st = statSync(file);
+        const target = statSync(line);
+        key = `${file}:${st.mtimeMs}:${line}:${target.mtimeMs}:${target.size}`;
+    }
+    catch {
+        return fallback(`指名の claude がありません（${line}）`, line);
+    }
+    if (pinCache && pinCache.key === key)
+        return pinCache.result;
+    const version = getClaudeVersion(line);
+    let result;
+    if (version === null) {
+        result = fallback(`指名の claude の版を読めません（${line}）`, line);
+    }
+    else if (compareVersions(version, CLAUDE_MIN_VERSION) < 0) {
+        result = fallback(`指名の claude が最低版より古い（${line} = ${version}、必要な版 ${CLAUDE_MIN_VERSION} 以上）`, line, version);
+    }
+    else {
+        result = { info: { bin: line, version }, status: { state: 'used', pinned: line, reason: null, version } };
+    }
+    pinCache = { key, result };
+    return result;
+}
 /** ホームの外に在る、claude の既知の置き場（既定の候補）。 */
 export const CLAUDE_SYSTEM_BIN_DIRS = ['/usr/local/bin', '/usr/bin'];
 /** claude の実行ファイルの既知の候補を返す（新しい node の版から順）。 */
@@ -392,6 +451,8 @@ function claudeBinCandidates(systemDirs) {
  *
  * 探す順:
  *   1. 環境変数 CONDUCTOR_CLAUDE_BIN（テスト用の差し替え口）→ 指定があればそれだけ
+ *   1b. 指名（~/.tyhld/bin/autoupdate/claude-pin）が在り、使える（在る・版が読める・最低版以上）ならそれ
+ *       ★使えなければ黙って別の版を使わず、理由を lastClaudePinStatus() に残して 2 へ
  *   2. 候補のうち実在する物の版を確かめ、いちばん新しい版を使う
  *   3. 版を確かめられない物は後回し（版が分かる物が1つもないときだけ使う）
  *
@@ -401,10 +462,21 @@ function claudeBinCandidates(systemDirs) {
 export function resolveClaudeBin(systemDirs = CLAUDE_SYSTEM_BIN_DIRS) {
     const override = process.env.CONDUCTOR_CLAUDE_BIN;
     if (override) {
+        // ★今までどおり指定が最優先。指名が在っても見ない（在ることだけ管制へ届ける）。
+        lastClaudePin = readClaudePinLine() === undefined ? CLAUDE_PIN_NONE : {
+            state: 'override', pinned: null, version: null,
+            reason: 'CONDUCTOR_CLAUDE_BIN の指定があるので、指名は使っていません',
+        };
         if (!existsSync(override))
             return null;
         return { bin: override, version: getClaudeVersion(override) };
     }
+    // ★指名（~/.tyhld/bin/autoupdate/claude-pin）が在れば最初に選ぶ（便 b7bd5e43・A2）。
+    //   使えないときは黙って別の版を使わず、今までの選び方に戻ったことと理由を残す（管制へ届く）。
+    const pinned = evaluateClaudePin();
+    lastClaudePin = pinned.status;
+    if (pinned.info)
+        return pinned.info;
     const existing = claudeBinCandidates(systemDirs).filter(c => existsSync(c));
     if (existing.length === 0)
         return null;
@@ -838,6 +910,11 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
         return null;
     }
     const { bin: claudeBin, version: claudeVersion } = resolved;
+    const pin = lastClaudePinStatus();
+    if (pin.state === 'fallback')
+        log(`WARN Claude Code の指名を使えません: ${pin.reason}`);
+    else if (pin.state === 'used')
+        log(`Claude Code の指名どおりに使います: ${pin.pinned}`);
     // ── 最低版チェック ──
     if (claudeVersion && compareVersions(claudeVersion, CLAUDE_MIN_VERSION) < 0) {
         // ★候補のうちいちばん新しい物でも最低版より古い＝全部が古いときだけここに来る
@@ -1569,6 +1646,12 @@ export async function headlessTick(cfg, state, hooks) {
                 `自動再開しました (session=${sessionId}, attempt ${retry.attempt}/${HEADLESS_MAX_ATTEMPTS})`);
             return;
         }
+        // ── 入れ替え待ちの札（便 b7bd5e43・A2）──
+        //   札が在るあいだは新しい便を【取りに行かない】。管制に積まれた便はそのまま待つ＝
+        //   失われない・失敗にならない・試行回数も配達回数も使わない。札が外れたら次の周で今までどおり取る。
+        //   ★走っている便（state.job）と自動再開（pendingRetry）は上で済んでいる＝止めない。
+        if (!noteDrain(rs, cfg.site))
+            return;
         // ── 新規指示の取得 ──
         const cmd = await fetchCommand(cfg);
         if (!cmd) {

package/dist/relay.js

@@ -231,6 +231,7 @@ export function createRelayState() {
         running: false,
         restored: false,
         lastHalted: null,
+        lastDrain: null,
         lastSkippedId: null,
         skipCount: 0,
         skipWarned: false,
@@ -245,6 +246,53 @@ export function createRelayState() {
         readiness: createReadiness(),
     };
 }
+// ── 入れ替え待ちの札（便 b7bd5e43・設計 3ed9e2b2 の A2）─────────────────────
+//   置き場の決め方と理由は src/autoupdate-flags.ts の冒頭（★~/.tyhld/bin の下＝職人は書けない）。
+//   ★本体をここに置くのは、relay.ts を試験が src から直接読み込むため（ほかの src を import しない）。
+/** 札と指名の置き場（★番人がどの書き方でも書き込みを止める ~/.tyhld/bin の下）。 */
+export function autoupdateDir() {
+    return path.join(os.homedir(), '.tyhld', 'bin', 'autoupdate');
+}
+/** 札の場所（★置くのは更新係。中身は読まない＝在るか無いかだけで決める）。 */
+export function drainFilePath() {
+    return process.env.CONDUCTOR_DRAIN_FILE || path.join(autoupdateDir(), 'drain');
+}
+/**
+ * 札を読む。★読めない（権限など）ときも「在る」と扱う＝迷ったら新しい便を取らない側。
+ *   便は管制で待つだけで、失われない・失敗にならない・試行回数も使わない。
+ */
+export function readDrain(file = drainFilePath()) {
+    try {
+        const st = statSync(file);
+        return { active: true, sinceMs: st.mtimeMs };
+    }
+    catch (e) {
+        if (e?.code === 'ENOENT')
+            return { active: false, sinceMs: null };
+        return { active: true, sinceMs: null };
+    }
+}
+/**
+ * 入れ替え待ちの札を見る（便 b7bd5e43・A2）。返り true＝新しい便を取りに行ってよい。
+ *   ★画面あり・画面なしの両方式が、新しい便を取る直前にこれを呼ぶ（走っている便には効かない）。
+ *   ★置かれた/外れたの変わり目だけ1行出す。
+ */
+export function noteDrain(state, site, now = Date.now()) {
+    const d = readDrain();
+    if (d.active) {
+        if (state.lastDrain !== true) {
+            log(`site=${site} 入れ替え待ちの札があるため、新しい便を取りません（走っている便は止めません・積まれた便は管制で待ちます）`);
+        }
+        state.lastDrain = true;
+        noteReadiness(state, 'draining', null, now);
+        return false;
+    }
+    if (state.lastDrain === true) {
+        log(`site=${site} 入れ替え待ちの札が外れました。便の受け取りを再開します`);
+    }
+    state.lastDrain = false;
+    return true;
+}
 /** 「指示は在るのに配れていない」状態（この間が未配達の時間）。 */
 const BLOCKED_STATES = new Set([
     'busy',
@@ -3512,6 +3560,9 @@ export async function relayTick(cfg, state, hooks) {
             log('停止が解除されました。relayを再開します');
         }
         state.lastHalted = false;
+        // ── 入れ替え待ちの札（便 b7bd5e43）──札が在るあいだは新しい便を取りに行かない。
+        if (!noteDrain(state, cfg.site))
+            return;
         // ── 新規指示の取得 ──
         const cmd = await fetchCommand(cfg);
         if (!cmd) {