@tyhld/conductor 0.12.61 → 0.12.62

package/dist/headless.js

@@ -16,7 +16,7 @@
  */
 import { spawn } from 'node:child_process';
 import { createInterface } from 'node:readline';
-import { createWriteStream, existsSync, mkdirSync } from 'node:fs';
+import { createWriteStream, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_PENDING_TIMEOUT_MS, RELAY_RESTORE_ORPHANS_ENABLED, buildAnchor, buildSendText, canDeliver, completeWithReport, createRelayState, deliveryReport, fetchCommand, fetchCommandStatus, fetchControl, fetchOrphans, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteReadiness, patchStatus, reconnectDelayMs, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
@@ -42,6 +42,44 @@ const RESUME_PROMPT = '前回の作業の続きを行ってください。中断
 export const RUNS_DIR = path.join(os.homedir(), '.local', 'state', 'conductor', 'runs');
 /** セッションありと見なす最低実行時間(ms)。これより短いとセッションファイルが無い可能性が高い。 */
 export const SESSION_MIN_DURATION_MS = 30_000;
+/** 実行中のジョブを永続化するファイル。中継再起動後の拾い直しに使う。 */
+export const ACTIVE_JOB_PATH = path.join(os.homedir(), '.local', 'state', 'conductor', 'active-job.json');
+/** 実行中のジョブをファイルに書く（中継が死んでも拾い直せるように）。 */
+export function saveActiveJob(record) {
+    try {
+        const dir = path.dirname(ACTIVE_JOB_PATH);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(ACTIVE_JOB_PATH, JSON.stringify(record) + '\n');
+    }
+    catch (err) {
+        log(`WARN active-job の保存に失敗: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** 実行中のジョブ記録を消す（ジョブが完了・放棄したとき）。 */
+export function clearActiveJob() {
+    try {
+        if (existsSync(ACTIVE_JOB_PATH))
+            unlinkSync(ACTIVE_JOB_PATH);
+    }
+    catch { /* ignore */ }
+}
+/** 起動時に前回の実行中ジョブを読む。無ければ null。 */
+export function loadActiveJob() {
+    try {
+        if (!existsSync(ACTIVE_JOB_PATH))
+            return null;
+        const raw = readFileSync(ACTIVE_JOB_PATH, 'utf8').trim();
+        if (!raw)
+            return null;
+        const rec = JSON.parse(raw);
+        if (!rec.commandId)
+            return null;
+        return rec;
+    }
+    catch {
+        return null;
+    }
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // claude の実行ファイルの探索
 //
@@ -134,11 +172,23 @@ export function maskSecrets(text) {
 // ─────────────────────────────────────────────────────────────────────────────
 // ヘルパー
 // ─────────────────────────────────────────────────────────────────────────────
-/** commandId からセッション ID を作る（resume で再利用する決定的な値）。
- * ★commandId はそれ自体が UUID なので、そのまま使う（プレフィックスを付けない）。
+/**
+ * commandId と attempt 番号からセッション ID を作る（決定的な値）。
+ *
+ * 【なぜ attempt ごとに変えるか（実測 2026-10-01・便 03d3649f）】
+ *   attempt 1 で `--session-id UUID` → セッションが作られる。
+ *   attempt 2 で同じ UUID を `--session-id UUID` で渡すと "already in use" で即死。
+ *   attempt 2 で `--session-id UUID --resume` だと "requires --fork-session" で即死。
+ * ★resume のときは `--resume UUID` で前回のセッションIDを渡す（--session-id は使わない）。
+ *   fresh start のときは新しいセッション ID を使う。
  */
-export function sessionIdForCommand(commandId) {
-    return commandId;
+export function sessionIdForCommand(commandId, attempt = 1) {
+    if (attempt <= 1)
+        return commandId;
+    // attempt 2+ は UUID v4 の範囲で決定的に作る（末尾4桁を attempt に置き換え）。
+    // UUID の形を保つ（claude が UUID を要求するため）。
+    const hex = attempt.toString(16).padStart(4, '0');
+    return commandId.slice(0, -4) + hex;
 }
 /** stream-json の1行を CommandEvent に変換する。無関係な行は null。 */
 export function streamEventToCommandEvent(parsed, attempt) {
@@ -172,7 +222,11 @@ export function isAuthError(job) {
         s.includes('unauthorized') ||
         s.includes('authentication failed') ||
         s.includes('invalid api key') ||
-        s.includes('invalid_api_key'));
+        s.includes('invalid_api_key') ||
+        s.includes('not logged in') ||
+        s.includes('login required') ||
+        s.includes('session expired') ||
+        s.includes('token expired'));
 }
 // ─────────────────────────────────────────────────────────────────────────────
 // 実行ログ
@@ -232,15 +286,27 @@ export function spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume) {
     delete env.ANTHROPIC_API_KEY;
     env.CONDUCTOR_SITE = cfg.site;
     env.CONDUCTOR_MACHINE = cfg.machine;
+    // ★テスト用: CONDUCTOR_CLAUDE_CONFIG_DIR を設定すると、claude の設定フォルダを差し替える。
+    //   本物のログインを壊さずに認証エラーを再現できる（空のフォルダを指す → not logged in）。
+    //   本番では設定しない（claude は既定の ~/.claude を使う）。
+    if (process.env.CONDUCTOR_CLAUDE_CONFIG_DIR) {
+        env.CLAUDE_CONFIG_DIR = process.env.CONDUCTOR_CLAUDE_CONFIG_DIR;
+    }
     const args = [
         '-p',
         '--output-format', 'stream-json',
         '--verbose',
         '--permission-mode', cfg.permissionMode ?? 'acceptEdits',
-        '--session-id', sessionId,
     ];
-    if (isResume)
-        args.push('--resume');
+    if (isResume) {
+        // ★ --resume <前回のセッションID> で前回の続きから再開する。
+        //   --session-id と --resume を同時に使うと --fork-session が必要になるため、
+        //   --resume の引数としてセッション ID を渡す（実測 2026-10-01）。
+        args.push('--resume', sessionId);
+    }
+    else {
+        args.push('--session-id', sessionId);
+    }
     let proc;
     try {
         proc = spawn(claudeBin, args, {
@@ -413,6 +479,7 @@ async function checkRunningJob(cfg, state) {
     // ── 完了したプロセスの後始末 ──
     if (job.completed) {
         await flushEvents(cfg, job);
+        clearActiveJob();
         if (job.stopped) {
             // stop_requested で止めた
             await sendCommandEvents(cfg, job.commandId, [{
@@ -428,13 +495,15 @@ async function checkRunningJob(cfg, state) {
         }
         if (isAuthError(job)) {
             // 認証エラー → 再試行しない
+            const authMsg = maskSecrets(`認証エラー (exit=${job.exitCode}): ${job.stderrBuf.slice(0, 300)}`).slice(0, EVENT_TEXT_MAX);
             await sendCommandEvents(cfg, job.commandId, [{
                     type: 'auth_error',
-                    text: maskSecrets(`認証エラー (exit=${job.exitCode}): ${job.stderrBuf.slice(0, 300)}`).slice(0, EVENT_TEXT_MAX),
+                    text: authMsg,
                     at: new Date().toISOString(),
                     attempt: job.attempt,
                 }]);
-            // ★patchStatus は 'failed' を受け付けないので、放棄だけして中央の stalled/timeout に委ねる。
+            // ★中央へ failed を返す（次の便が止まらないように）
+            await patchStatus(cfg, job.commandId, 'failed', authMsg);
             rs.abandoned.add(job.commandId);
             state.job = null;
             rs.lastHeartbeatAt = null;
@@ -467,6 +536,15 @@ async function checkRunningJob(cfg, state) {
         const nextAttempt = (state.attempts.get(job.commandId) ?? job.attempt) + 1;
         if (nextAttempt > HEADLESS_MAX_ATTEMPTS) {
             log(`WARN site=${cfg.site} id=${job.commandId} 試行回数上限(${HEADLESS_MAX_ATTEMPTS}) → 放棄`);
+            // ★中央へ failed を返す（次の便が止まらないように）
+            const failReason = maskSecrets(`${HEADLESS_MAX_ATTEMPTS}回すべて異常終了 (最後: exit=${job.exitCode}, signal=${job.exitSignal}): ${stderrTail}`).slice(0, EVENT_TEXT_MAX);
+            await patchStatus(cfg, job.commandId, 'failed', failReason);
+            await sendCommandEvents(cfg, job.commandId, [{
+                    type: 'error',
+                    text: failReason,
+                    at: new Date().toISOString(),
+                    attempt: job.attempt,
+                }]);
             rs.abandoned.add(job.commandId);
         }
         else {
@@ -518,25 +596,61 @@ async function checkRunningJob(cfg, state) {
 /**
  * sent孤児を1件取得し、--resume で再開する（起動時1回）。
  *
- * PC 再起動後、「やっています(sent)」のまま残った便を中央から見つけ、
- * 決定的なセッション ID（conductor-{commandId}）で resume する。
- * Claude Code はセッションを ~/.claude/ に保存するので、同じセッション ID で
- * 再開すれば前回の途中から続けられる。
+ * 【2つの経路で孤児を見つける】
+ *   1. 手元の記録（active-job.json）：中継が起動して、まだ終わっていない便。
+ *      中継の再起動（子プロセスが一緒に死ぬ）後に、中央の生存報告に頼らず拾える。
+ *   2. 中央（fetchOrphans）：生存報告が途切れた現場の sent 便。PC 再起動後の復元。
  *
- * ★tmux 方式の restoreOrphans と同じ呼び出し経路（fetchOrphans → selectOrphanToRestore）
- *   を使う。headless では復元 = 即座に子プロセスを起動する（tmux のように pending に積んで待つ
- *   のではなく、直接 resume する）。
+ * ★手元の記録を先に見る（中継再起動 = 生存報告が新しく、中央は孤児と見なさないため）。
+ * ★二重起動しない: state.job が null のときだけ動く（④を壊さない）。
  */
 export async function restoreHeadlessOrphans(cfg, state) {
     if (!RELAY_RESTORE_ORPHANS_ENABLED)
         return;
     if (state.job !== null)
         return; // 既にジョブ実行中
+    // ── 経路1: 手元の記録から拾い直す ──
+    const saved = loadActiveJob();
+    if (saved !== null) {
+        clearActiveJob(); // 拾ったら消す（二重起動防止）
+        log(`site=${cfg.site} id=${saved.commandId} 手元の記録から孤児を検出（中継再起動後の拾い直し）`);
+        const pick = { id: saved.commandId, body: saved.body, site: cfg.site, sentAt: saved.startedAt };
+        const attempt = saved.attempt + 1;
+        state.attempts.set(pick.id, attempt);
+        if (attempt > HEADLESS_MAX_ATTEMPTS) {
+            state.relay.abandoned.add(pick.id);
+            await patchStatus(cfg, pick.id, 'failed', `中継再起動後の拾い直し: 試行回数上限(${HEADLESS_MAX_ATTEMPTS})`);
+            log(`WARN site=${cfg.site} id=${pick.id} 手元の孤児復元: 試行回数上限 → 放棄`);
+            return;
+        }
+        // 前回のセッション ID で再開
+        const sessionId = sessionIdForCommand(pick.id, saved.attempt);
+        const cmd = { id: pick.id, body: pick.body };
+        const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, true);
+        if (job === null) {
+            state.relay.abandoned.add(pick.id);
+            log(`ERROR site=${cfg.site} id=${pick.id} 手元の孤児復元: claude が見つからない → 放棄`);
+            return;
+        }
+        state.job = job;
+        saveActiveJob({ commandId: pick.id, body: pick.body, sessionId, attempt, startedAt: Date.now() });
+        markDelivered(state.relay, pick.id);
+        state.relay.lastHeartbeatAt = null;
+        noteReadiness(state.relay, 'delivered', pick.id);
+        await sendCommandEvents(cfg, pick.id, [{
+                type: 'resumed',
+                text: `中継再起動後の拾い直し: attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS}`,
+                at: new Date().toISOString(),
+                attempt,
+            }]);
+        log(`site=${cfg.site} id=${pick.id} 手元の記録から復元して再開しました (attempt ${attempt}/${HEADLESS_MAX_ATTEMPTS})`);
+        return;
+    }
+    // ── 経路2: 中央から孤児を拾う（PC 再起動後） ──
     const orphans = await fetchOrphans(cfg);
     const pick = selectOrphanToRestore(orphans, null);
     if (pick === null)
         return;
-    const sessionId = sessionIdForCommand(pick.id);
     const attempt = (state.attempts.get(pick.id) ?? 0) + 1;
     state.attempts.set(pick.id, attempt);
     if (attempt > HEADLESS_MAX_ATTEMPTS) {
@@ -545,6 +659,8 @@ export async function restoreHeadlessOrphans(cfg, state) {
         return;
     }
     // ★孤児は resume で再開する（元の指示本文ではなく続行プロンプトを渡す）。
+    // 前回のセッション ID を渡す（attempt - 1 で作った ID で再開）。
+    const sessionId = sessionIdForCommand(pick.id, attempt > 1 ? attempt - 1 : 1);
     const cmd = { id: pick.id, body: pick.body };
     const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, true);
     if (job === null) {
@@ -559,6 +675,7 @@ export async function restoreHeadlessOrphans(cfg, state) {
         return;
     }
     state.job = job;
+    saveActiveJob({ commandId: pick.id, body: pick.body, sessionId, attempt, startedAt: Date.now() });
     markDelivered(state.relay, pick.id);
     state.relay.lastHeartbeatAt = null;
     noteReadiness(state.relay, 'delivered', pick.id);
@@ -632,9 +749,12 @@ export async function headlessTick(cfg, state, hooks) {
             const retry = state.pendingRetry;
             state.pendingRetry = null;
             state.attempts.set(retry.cmd.id, retry.attempt);
-            const sessionId = sessionIdForCommand(retry.cmd.id);
             // 前回がセッションを作れないほど短命（< 30秒）なら fresh start、そうでなければ resume
             const isResume = retry.attempt > 1 && retry.durationMs >= SESSION_MIN_DURATION_MS;
+            // resume: 前回のセッション ID を渡す。fresh start: 新しいセッション ID を作る。
+            const sessionId = isResume
+                ? sessionIdForCommand(retry.cmd.id, retry.attempt - 1)
+                : sessionIdForCommand(retry.cmd.id, retry.attempt);
             const job = spawnClaudeProcess(cfg, retry.cmd, sessionId, retry.attempt, isResume);
             if (job === null) {
                 await sendCommandEvents(cfg, retry.cmd.id, [{
@@ -648,6 +768,7 @@ export async function headlessTick(cfg, state, hooks) {
                 return;
             }
             state.job = job;
+            saveActiveJob({ commandId: retry.cmd.id, body: retry.cmd.body, sessionId, attempt: retry.attempt, startedAt: Date.now() });
             rs.lastHeartbeatAt = null;
             noteReadiness(rs, 'delivered', retry.cmd.id);
             await sendCommandEvents(cfg, retry.cmd.id, [{
@@ -684,8 +805,11 @@ export async function headlessTick(cfg, state, hooks) {
             return;
         }
         // ── claude -p を起動 ──
-        const sessionId = sessionIdForCommand(cmd.id);
         const isResume = attempt > 1;
+        // resume: 前回のセッション ID を渡す。fresh start: 新しいセッション ID を作る。
+        const sessionId = isResume
+            ? sessionIdForCommand(cmd.id, attempt - 1)
+            : sessionIdForCommand(cmd.id, attempt);
         const job = spawnClaudeProcess(cfg, cmd, sessionId, attempt, isResume);
         if (job === null) {
             // ★起動失敗を管制へ知らせる（「起動しました」とは言わない）
@@ -700,6 +824,7 @@ export async function headlessTick(cfg, state, hooks) {
             return;
         }
         state.job = job;
+        saveActiveJob({ commandId: cmd.id, body: cmd.body, sessionId, attempt, startedAt: Date.now() });
         markDelivered(rs, cmd.id);
         rs.lastHeartbeatAt = null;
         noteReadiness(rs, 'delivered', cmd.id);

package/package.json

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