@tyhld/conductor 0.12.33 → 0.12.37

package/dist/cli.js

@@ -13,7 +13,7 @@ import { execFileSync, spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import os from 'node:os';
-import { RELAY_FETCH_TIMEOUT_MS, createRelayState, parseAgentKind, reconnectDelayMs, relayTick, tmuxHasSession, } from './relay.js';
+import { RELAY_FETCH_TIMEOUT_MS, createRelayState, deliveryReport, parseAgentKind, reconnectDelayMs, relayTick, tmuxHasSession, } from './relay.js';
 import { createRelayRunner } from './relay-runner.js';
 import { installProcessGuards } from './process-guard.js';
 import { registerNudgeTarget, unregisterNudgeTarget, watchNudges, } from './nudge.js';
@@ -22,6 +22,11 @@ import { loadEarConfig } from './ear-routing.js';
 import { ensureEnvFilePermissions } from './env-file-perm.js';
 import { createCentralPorts } from './build-central.js';
 import { BUILD_NUDGE_NAME, REQUIRED_ENV, createBuildRunner, createMemoStore, loadBuildRunnerConfig, } from './build-runner.js';
+/**
+ * relay の状態の参照（生存報告に「いま配れるか」を載せるため）。
+ *   ★relay が無効な機では null のまま＝報告の中身は今までと1バイトも変わらない。
+ */
+let relayStateForReport = null;
 /** git コマンドを安全に実行し、失敗したら null を返す（git でない/未インストール等）。 */
 function git(args) {
     try {
@@ -161,6 +166,16 @@ async function sendReport(cfg) {
         lastAction: cfg.lastAction,
         artisanReady: tmuxHasSession(cfg.site),
     };
+    // ★relay が動いている機だけ、2段目（いま配れるか）を足す。
+    //   未配達でないときは秒数と指示idを載せない＝管制で「遅れ」を数えない。
+    if (relayStateForReport) {
+        const d = deliveryReport(relayStateForReport);
+        body.deliveryState = d.deliveryState;
+        if (d.undeliveredSec !== null)
+            body.undeliveredSec = d.undeliveredSec;
+        if (d.queuedCommandId !== null)
+            body.queuedCommandId = d.queuedCommandId;
+    }
     const time = new Date().toLocaleTimeString();
     try {
         const res = await fetch(`${cfg.url}/api/conductor/report`, {
@@ -222,6 +237,8 @@ async function start(args) {
             `（承認待ちの間だけ ${cfg.promptIntervalSec}s に短縮）` +
             `（tmuxセッション "${cfg.site}" がアイドルのときだけ送信します）`);
         const relayState = createRelayState();
+        // 生存報告に「いま配れるか」を載せるための参照（便 600d2a6a）。
+        relayStateForReport = relayState;
         relayRunner = createRelayRunner({
             tick: () => relayTick(cfg, relayState, {
                 // ★管制へつながらない状態から戻った瞬間に1回だけ呼ばれる。

package/dist/relay.js

@@ -223,6 +223,47 @@ export function createRelayState() {
         promptPending: false,
         busyRaisedId: null,
         central: { failures: 0, detail: '', downSince: null },
+        readiness: createReadiness(),
+    };
+}
+/** 「指示は在るのに配れていない」状態（この間が未配達の時間）。 */
+const BLOCKED_STATES = new Set([
+    'busy',
+    'no-session',
+    'not-agent',
+]);
+export function createReadiness(now = Date.now()) {
+    return { state: 'unknown', commandId: null, since: now, skipCount: 0 };
+}
+/**
+ * 1周の結末を記録する。同じ結末が続く間は since を動かさない（＝そこから何秒経ったかが分かる）。
+ * ★記録するだけ。配達の判断は1バイトも変えない。
+ */
+export function noteReadiness(state, next, commandId, now = Date.now()) {
+    const cur = state.readiness;
+    if (cur.state === next && cur.commandId === commandId) {
+        if (BLOCKED_STATES.has(next))
+            cur.skipCount += 1;
+        return;
+    }
+    state.readiness = {
+        state: next,
+        commandId,
+        since: now,
+        skipCount: BLOCKED_STATES.has(next) ? 1 : 0,
+    };
+}
+/**
+ * 生存報告に載せる形。★「指示が在るのに配れていない」ときだけ、その長さと指示idを出す。
+ *   配れている・指示が無いときは undeliveredSec を null にする（管制で「遅れ」を数えない）。
+ */
+export function deliveryReport(state, now = Date.now()) {
+    const r = state.readiness;
+    const blocked = BLOCKED_STATES.has(r.state) && r.commandId !== null;
+    return {
+        deliveryState: r.state,
+        queuedCommandId: blocked ? r.commandId : null,
+        undeliveredSec: blocked ? Math.max(0, Math.round((now - r.since) / 1000)) : null,
     };
 }
 /**
@@ -2045,6 +2086,7 @@ export async function relayTick(cfg, state, hooks) {
                     : 'relay停止中(緊急停止スイッチON)のため送信しません');
             }
             state.lastHalted = true;
+            noteReadiness(state, 'halted', null);
             return;
         }
         if (state.lastHalted === true) {
@@ -2053,8 +2095,10 @@ export async function relayTick(cfg, state, hooks) {
         state.lastHalted = false;
         // ── 新規指示の取得 ──
         const cmd = await fetchCommand(cfg);
-        if (!cmd)
+        if (!cmd) {
+            noteReadiness(state, 'no-command', null);
             return; // 指示なし
+        }
         // ── 配達放棄ガード（無限ループの構造的封じ込め） ──
         // 配達回数上限を超えて放棄した command は、サーバがまだ queued を返しても（＝完了通知が
         // 単線で切れて詰まった状態でも）二度と配達しない。放棄時に既にWARNを出しているので静かにスキップ。
@@ -2073,6 +2117,7 @@ export async function relayTick(cfg, state, hooks) {
         // ── アイドル判定（保守的・二重チェック） ──
         if (!tmuxHasSession(cfg.site)) {
             log(`site=${cfg.site} id=${cmd.id} tmux未起動のため送らずスキップ`);
+            noteReadiness(state, 'no-session', cmd.id);
             return;
         }
         if (!(await isIdleStable(cfg.site, kindOf(cfg)))) {
@@ -2084,6 +2129,9 @@ export async function relayTick(cfg, state, hooks) {
                 state.skipWarned = false;
             }
             state.skipCount += 1;
+            // ★「指示は在るのに配れていない」ことを、この周の結末として記録する（便 600d2a6a）。
+            //   生存報告に載せて、管制が「職人が作業中だから待っている」と言えるようにする。
+            noteReadiness(state, 'busy', cmd.id);
             log(`site=${cfg.site} id=${cmd.id} 作業中の可能性ありスキップ（次回再判定）`);
             if (state.skipCount > RELAY_SKIP_WARN_THRESHOLD && !state.skipWarned) {
                 state.skipWarned = true;
@@ -2104,6 +2152,7 @@ export async function relayTick(cfg, state, hooks) {
         if (guardCap === null || !looksLikeAgent(guardCap, kindOf(cfg))) {
             log(`WARN site=${cfg.site} id=${cmd.id} Claude Codeの箱と確認できないため送信せずスキップ` +
                 '（名前一致でも非claude窓への誤爆を防止）');
+            noteReadiness(state, 'not-agent', cmd.id);
             return;
         }
         // ── tmux 送信 ──
@@ -2140,6 +2189,7 @@ export async function relayTick(cfg, state, hooks) {
         markDelivered(state, cmd.id);
         // 新しい指示の生存ハートビートは先頭から数え直す（前指示のスロットルを引き継がない）。
         state.lastHeartbeatAt = null;
+        noteReadiness(state, 'delivered', cmd.id);
         log(`site=${cfg.site} id=${cmd.id} 配達しました`);
         // ★配達の直後に「配達済み(sent)」を管制へ書く。書けなければ次tick以降で書けるまでやり直す
         //   （markSentAtCentral）。★書けなくても再配達はしない。

package/package.json

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