@tyhld/conductor 0.12.174 → 0.12.176

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/headless.js CHANGED
@@ -19,7 +19,7 @@ import { createInterface } from 'node:readline';
19
19
  import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
20
20
  import path from 'node:path';
21
21
  import os from 'node:os';
22
- 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, fetchCommandState, fetchCommandStatus, fetchControlWithUpdate, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, pruneLogLine, pruneStaleWorktrees, recoverStuckProcessedReports, reconnectDelayMs, WAIT_CLOSED_STATUS, FINISH_GATE_KINDS, reportDelivery, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
22
+ 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, fetchCommandState, fetchCommandStatus, fetchControlWithUpdate, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noReportEndNote, noteDrain, noteReadiness, patchStatus, pruneLogLine, pruneStaleWorktrees, recoverStuckProcessedReports, reconnectDelayMs, WAIT_CLOSED_STATUS, FINISH_GATE_KINDS, reportDelivery, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
23
23
  import { claudePinPath, readClaudePinLine, } from './autoupdate-flags.js';
24
24
  import { cleanupJobWorkDir, jobWorkDirGuide, prepareJobWorkDir, stayInRepoDir, } from './job-workdir.js';
25
25
  import { authHoldHit, clearUsageHold, detectUsageLimit, formatJst, mergeUsageLimit, placeUsageHold, readUsageHold, saveLimitResume, takeLimitResume, usageHoldNotice, usageLimitLabel, } from './usage-limit.js';
@@ -37,6 +37,87 @@ export const HEADLESS_MAX_ATTEMPTS = 3;
37
37
  export const HEADLESS_EVENT_FLUSH_MS = 2_000;
38
38
  /** 実行中に stop_requested を確かめる間隔(ms)。 */
39
39
  export const HEADLESS_STOP_CHECK_MS = 15_000;
40
+ /**
41
+ * 見回りも職人も黙っていた時間がこれ以上なら「PC が止まっていた(眠っていた)」と見る(ms)。
42
+ *
43
+ * 【根拠(便 b518520a)】便を抱えている間の見回りは約2秒ごと。管制へつながらない間でも
44
+ * 次の周までは最長60秒(RELAY_RECONNECT_MAX_MS)で、1周の中の通信は1回20秒で切れる
45
+ * (止める問い合わせ・生存報告・進み具合の3回+止める処理10秒=最長でも約70秒)。
46
+ * =PC が動いていれば周の間は約2分半を超えない。その2倍の5分を境にする。
47
+ * 実地 e947eff3 は最後の動き 2026-11-04T19:37:58Z から戻った見回りまで約14時間47分空いていた。
48
+ */
49
+ export const HEADLESS_SUSPEND_GAP_MS = 5 * 60 * 1000;
50
+ /**
51
+ * PC が戻った直後に上限時間を超えていたとき、止める前に職人へ与える猶予(ms)。
52
+ *
53
+ * 【根拠(便 b518520a)】職人が報告を書いて完了の知らせを出すまでは数分(e947eff3 は合流の確かめの
54
+ * 直後で、残りは報告と知らせだけだった)。15分あれば書き切れる。猶予は1便に1回だけ。
55
+ * 猶予の後も終わっていなければ今までどおり止める(上限の3時間そのものは変えない)。
56
+ */
57
+ export const HEADLESS_RESUME_GRACE_MS = 15 * 60 * 1000;
58
+ /**
59
+ * 見回り1回ぶんの「止まっていた時間」を数える(★純粋関数・便 b518520a)。
60
+ *
61
+ * 【見方】前の見回りから、職人の最初の記録(無ければ今)までの間に、見回りも職人も黙っていた。
62
+ * それが HEADLESS_SUSPEND_GAP_MS 以上なら PC が止まっていたと見て、その長さを作業時間から引く。
63
+ * 【★職人が動いていた間は引かない】配り役の周だけが遅れて職人が記録を出し続けていた形は、
64
+ * 前の見回りのすぐ後に記録が出るので、黙っていた時間が短くなり引かない(作業を見逃さない)。
65
+ * 返す値は今回引いた長さ(ms)。0=止まっていなかった。
66
+ */
67
+ export function noteTickGap(c, now) {
68
+ const last = c.lastTickAt ?? c.startedAt;
69
+ const quietUntil = Math.min(c.firstActivitySinceTickAt ?? now, now);
70
+ const quiet = quietUntil - last;
71
+ c.lastTickAt = now;
72
+ c.firstActivitySinceTickAt = null;
73
+ if (!(quiet >= HEADLESS_SUSPEND_GAP_MS))
74
+ return 0;
75
+ c.pausedMs = (c.pausedMs ?? 0) + quiet;
76
+ c.pauseCount = (c.pauseCount ?? 0) + 1;
77
+ c.resumedAt = now;
78
+ return quiet;
79
+ }
80
+ /** 作業時間(ms)=始まってからの時間から、PC が止まっていた時間を引いた物(★純粋関数)。 */
81
+ export function jobWorkMs(c, now) {
82
+ return now - c.startedAt - (c.pausedMs ?? 0);
83
+ }
84
+ /**
85
+ * 上限時間の判定(★純粋関数・便 b518520a)。
86
+ * 'ok' … 作業時間が上限以内
87
+ * 'grace' … 上限を超えたが PC が戻った直後なので、今回から猶予を与える(1便に1回だけ)
88
+ * 'in_grace' … 猶予の間(止めない)
89
+ * 'stop' … 今までどおり止める
90
+ * ★上限(CENTRAL_BUSY_HOLD_MAX_MS)そのものは変えない。PC が止まっていない便は今までどおり止める。
91
+ */
92
+ export function timeoutDecision(c, now) {
93
+ if (jobWorkMs(c, now) <= CENTRAL_BUSY_HOLD_MAX_MS)
94
+ return 'ok';
95
+ if (c.graceGivenAt != null) {
96
+ return now - c.graceGivenAt < HEADLESS_RESUME_GRACE_MS ? 'in_grace' : 'stop';
97
+ }
98
+ if (c.resumedAt != null && now - c.resumedAt <= HEADLESS_RESUME_GRACE_MS) {
99
+ c.graceGivenAt = now;
100
+ return 'grace';
101
+ }
102
+ return 'stop';
103
+ }
104
+ /**
105
+ * 時間の数え方の事実の一言(★純粋関数・便 b518520a)。止まっていた時間も猶予も無ければ null。
106
+ * ★終わりの事実(jobEndDetail)と失敗の理由に添える。
107
+ */
108
+ export function jobClockNote(c) {
109
+ const parts = [];
110
+ const paused = c.pausedMs ?? 0;
111
+ if (paused > 0) {
112
+ const min = Math.round(paused / 60000);
113
+ parts.push(`PC が止まっていた${Math.floor(min / 60)}時間${min % 60}分(${c.pauseCount ?? 1}回)を作業時間から除きました`);
114
+ }
115
+ if (c.graceGivenAt != null) {
116
+ parts.push(`PC が戻った直後に上限を超えていたので、止める前に${Math.round(HEADLESS_RESUME_GRACE_MS / 60000)}分の猶予を与えました` +
117
+ `(${new Date(c.graceGivenAt).toISOString()} から)`);
118
+ }
119
+ return parts.length > 0 ? parts.join('。') : null;
120
+ }
40
121
  /**
41
122
  * 便の終了状態(done)を管制へ書き直す上限回数(★便 6ebba0d0・定数はここ1か所)。
42
123
  *
@@ -1371,7 +1452,13 @@ resumeNote) {
1371
1452
  durationMs: 0,
1372
1453
  finishedAt: null,
1373
1454
  bodyHandoff: 'pending',
1455
+ pausedMs: 0,
1456
+ pauseCount: 0,
1457
+ resumedAt: null,
1458
+ graceGivenAt: null,
1374
1459
  };
1460
+ job.lastTickAt = job.startedAt;
1461
+ job.firstActivitySinceTickAt = null;
1375
1462
  // spawn の 'error' イベント(ENOENT 等は非同期で届く。同期例外と両方捕まえる)
1376
1463
  proc.on('error', (err) => {
1377
1464
  if (!job.completed) {
@@ -1430,6 +1517,8 @@ resumeNote) {
1430
1517
  job.stdoutLog?.write(line + '\n');
1431
1518
  // ★記録が1行出たこと自体が「手が動いている」印。管制の「作業中」判定に使う。
1432
1519
  job.lastActivityAt = Date.now();
1520
+ // ★前の見回りの後の最初の記録(便 b518520a)。PC が止まっていた時間を数える境目に使う。
1521
+ job.firstActivitySinceTickAt ??= job.lastActivityAt;
1433
1522
  try {
1434
1523
  const parsed = JSON.parse(line);
1435
1524
  // ★stream-json から認証エラーを検出(stderr に出ない実物に対応)
@@ -1611,6 +1700,16 @@ async function checkRunningJob(cfg, state) {
1611
1700
  ? null
1612
1701
  : `Claude の${usageLimitLabel(usageHit.limitType)}に当たって終わりました(失敗にせず待ちに戻します)` +
1613
1702
  (usageHit.text ? `: ${usageHit.text}` : '');
1703
+ // ★時間切れで、報告ファイルが1つも無い便(便 eb63dba5・実地 e947eff3)。送り直せる物が無いので、
1704
+ // 「報告なしで終わった」ことを終わりの事実と失敗の理由の両方で管制へはっきり知らせる。
1705
+ const noReportNote = job.timedOut
1706
+ ? noReportEndNote({
1707
+ endKind: 'timeout',
1708
+ phase: reportDelivery(job.commandId).phase,
1709
+ lastActivityAt: job.lastActivityAt,
1710
+ finishedAt: job.finishedAt ?? Date.now(),
1711
+ })
1712
+ : null;
1614
1713
  // ★再開するかもしれない便だけ、終わりの事実を届ける前に「停止の依頼」を1回確かめる
1615
1714
  // (けいさん決定 2026-10-07・便 fbdd7482)。
1616
1715
  //
@@ -1672,6 +1771,19 @@ async function checkRunningJob(cfg, state) {
1672
1771
  // (入れると管制が「ふつうに終わりました(終了コード 143)」と、異常に見える形で出す)。
1673
1772
  // ★捨てるのではなく、人向けの一言へ「片づけの結果」と分かる形で載せる。
1674
1773
  const reaped = job.reapedAfterFinish;
1774
+ // ★PC が止まっていた時間を除いた・猶予を与えた事実(便 b518520a)。どの終わり方でも後ろに添える。
1775
+ const clockNote = jobClockNote(job);
1776
+ const detail = job.bodyHandoffError
1777
+ ?? residue?.text
1778
+ ?? (reaped ? reapedAfterFinishDetail(job.exitCode, job.exitSignal) : null)
1779
+ // ★停止の依頼が無いのに外から終了した便(便 fbdd7482)。「止めました」とは書かず、
1780
+ // 原因不明の終了として残す(扱いは今までどおり=再開・上限3回)。
1781
+ ?? (unknownExternalEnd ? unknownExternalEndDetail(job.exitCode, job.exitSignal) : null)
1782
+ // ★利用上限で終わった便(便 27a9fb19)。異常終了とは別の理由だと分かる一言を載せる。
1783
+ ?? usageDetail
1784
+ ?? noReportNote
1785
+ ?? delivery.note
1786
+ ?? `attempt ${job.attempt}/${HEADLESS_MAX_ATTEMPTS}`;
1675
1787
  await deliverJobEndFacts(cfg, {
1676
1788
  commandId: job.commandId,
1677
1789
  site: cfg.site,
@@ -1687,16 +1799,7 @@ async function checkRunningJob(cfg, state) {
1687
1799
  // ★終わりの関門が「途中で終わった」と残していれば、その理由を先に載せる(便 7aa63a97)。
1688
1800
  // 本文を渡せなかった理由がいちばん強い(職人は何も受け取っていない)ので、それが先。
1689
1801
  // そのどちらも無く、報告の形が整っていないときは、その理由を載せる(便 461be339)。
1690
- detail: job.bodyHandoffError
1691
- ?? residue?.text
1692
- ?? (reaped ? reapedAfterFinishDetail(job.exitCode, job.exitSignal) : null)
1693
- // ★停止の依頼が無いのに外から終了した便(便 fbdd7482)。「止めました」とは書かず、
1694
- // 原因不明の終了として残す(扱いは今までどおり=再開・上限3回)。
1695
- ?? (unknownExternalEnd ? unknownExternalEndDetail(job.exitCode, job.exitSignal) : null)
1696
- // ★利用上限で終わった便(便 27a9fb19)。異常終了とは別の理由だと分かる一言を載せる。
1697
- ?? usageDetail
1698
- ?? delivery.note
1699
- ?? `attempt ${job.attempt}/${HEADLESS_MAX_ATTEMPTS}`,
1802
+ detail: clockNote !== null ? `${detail}。${clockNote}` : detail,
1700
1803
  // ★上限に達して「途中で終わった」便だけに付ける(管制が機械で見分けられる形)。
1701
1804
  ...(residue?.facts != null ? { finishGate: residue.facts } : {}),
1702
1805
  }, { logLine: log });
@@ -1704,7 +1807,12 @@ async function checkRunningJob(cfg, state) {
1704
1807
  if (job.timedOut) {
1705
1808
  // 上限時間で強制停止した → 管制へ理由つきで failed を記録する
1706
1809
  const elapsed = Math.round((Date.now() - job.startedAt) / 1000);
1707
- const reason = `上限時間(${Math.round(CENTRAL_BUSY_HOLD_MAX_MS / 1000)}s)で強制停止 (実行${elapsed}s, exit=${job.exitCode}, signal=${job.exitSignal})`;
1810
+ // ★作業時間(PC が止まっていた時間を引いた物)も並べる(便 b518520a)。止まっていなければ同じ値。
1811
+ const worked = Math.round(jobWorkMs(job, Date.now()) / 1000);
1812
+ const clockNote = jobClockNote(job);
1813
+ const reason = `上限時間(${Math.round(CENTRAL_BUSY_HOLD_MAX_MS / 1000)}s)で強制停止 (実行${elapsed}s, 作業${worked}s, exit=${job.exitCode}, signal=${job.exitSignal})` +
1814
+ (noReportNote !== null ? `。${noReportNote}` : '') +
1815
+ (clockNote !== null ? `。${clockNote}` : '');
1708
1816
  await sendCommandEvents(cfg, job.commandId, [{
1709
1817
  type: 'error',
1710
1818
  text: reason.slice(0, EVENT_TEXT_MAX),
@@ -1916,6 +2024,17 @@ async function checkRunningJob(cfg, state) {
1916
2024
  }
1917
2025
  // ── 実行中のプロセスの監視 ──
1918
2026
  const now = Date.now();
2027
+ // ★PC が止まっていた時間を数える(便 b518520a・実地 e947eff3)。止まっている間は職人も凍っているので、
2028
+ // その時間は作業時間に数えない(下の上限時間の判定で引く)。
2029
+ const pausedNow = noteTickGap(job, now);
2030
+ if (pausedNow > 0) {
2031
+ const text = `PC が止まっていたと見て、${Math.round(pausedNow / 60000)}分を作業時間から除きます` +
2032
+ `(作業時間 ${Math.round(jobWorkMs(job, now) / 60000)}分・上限 ${Math.round(CENTRAL_BUSY_HOLD_MAX_MS / 60000)}分)`;
2033
+ log(`site=${cfg.site} id=${job.commandId} ${text}`);
2034
+ const event = { type: 'progress', text, at: new Date(now).toISOString(), attempt: job.attempt };
2035
+ job.eventsLog?.write(JSON.stringify(event) + '\n');
2036
+ await sendCommandEvents(cfg, job.commandId, [event]);
2037
+ }
1919
2038
  // ★本文を渡せなかったことが後から分かったとき(便 915694ac)。
1920
2039
  // 画面なし方式は中継が自分で処理を立ち上げて本文を渡す。渡せていなければ職人は何も
1921
2040
  // 受け取っていないので、動いているふりをさせず、理由つきで管制へ届けて止める。
@@ -1978,8 +2097,20 @@ async function checkRunningJob(cfg, state) {
1978
2097
  // タイムアウト — 中央の上限(3時間)で強制停止する。
1979
2098
  // ★RELAY_PENDING_TIMEOUT_MS(15分)は tmux の pending 解除用。画面なし方式では
1980
2099
  // 作業中の職人そのものを殺すので、中央と同じ CENTRAL_BUSY_HOLD_MAX_MS を使う。
1981
- if (now - job.startedAt > CENTRAL_BUSY_HOLD_MAX_MS) {
1982
- log(`WARN site=${cfg.site} id=${job.commandId} タイムアウト(${Math.round((now - job.startedAt) / 1000)}s) → SIGTERM`);
2100
+ // ★数えるのは作業時間=PC が止まっていた時間を引いた物(便 b518520a)。上限そのものは変えない。
2101
+ // PC が戻った直後に上限を超えていたら、1回だけ猶予を与えて報告を書けるようにする。
2102
+ const decision = timeoutDecision(job, now);
2103
+ if (decision === 'grace') {
2104
+ const text = `PC が戻った直後に上限時間を超えていました(作業時間 ${Math.round(jobWorkMs(job, now) / 60000)}分)。` +
2105
+ `報告を書けるよう ${Math.round(HEADLESS_RESUME_GRACE_MS / 60000)}分の猶予を与えます(猶予の後も終わっていなければ止めます)`;
2106
+ log(`WARN site=${cfg.site} id=${job.commandId} ${text}`);
2107
+ const event = { type: 'progress', text, at: new Date(now).toISOString(), attempt: job.attempt };
2108
+ job.eventsLog?.write(JSON.stringify(event) + '\n');
2109
+ await sendCommandEvents(cfg, job.commandId, [event]);
2110
+ }
2111
+ else if (decision === 'stop') {
2112
+ log(`WARN site=${cfg.site} id=${job.commandId} タイムアウト(作業${Math.round(jobWorkMs(job, now) / 1000)}s` +
2113
+ `・経過${Math.round((now - job.startedAt) / 1000)}s) → SIGTERM`);
1983
2114
  job.timedOut = true;
1984
2115
  await stopJob(job);
1985
2116
  return;
package/dist/relay.js CHANGED
@@ -5792,6 +5792,35 @@ export function jobEndFactsPath(site, commandId, env = process.env) {
5792
5792
  }
5793
5793
  /** 人向けの一言の上限(管制の列を汚さない)。 */
5794
5794
  const JOB_END_DETAIL_MAX = 500;
5795
+ /** 最後の動きから終わりまでがこれより長ければ「PC が止まっていた可能性」を添える。 */
5796
+ export const NO_REPORT_IDLE_GAP_MS = 30 * 60 * 1000;
5797
+ /**
5798
+ * 「報告なしで終わった便」を管制へはっきり知らせる一言(★純粋関数・便 eb63dba5)。
5799
+ *
5800
+ * 【なぜ要るか(実地 e947eff3・282e5926)】2026-11-04 夜に PC が止まり、戻ったときに上限時間を
5801
+ * 超えていた便が止められた。職人は報告を書く前(合流の確かめ・CI の待ち)だったので、報告ファイルは
5802
+ * どこにも無い=送り直せる物が無い。それなのに管制へ届く一言は `attempt 1/3` だけで、
5803
+ * 「報告が無いまま終わった・作った物が残っているかもしれない」ことが CC1 に伝わらなかった
5804
+ * (e947eff3 は PR #1383 が合流済みだった)。
5805
+ * 【★出すのは時間切れの便で、報告ファイルが1つも無いときだけ】
5806
+ * ・報告ファイルが在れば 30秒ごとの回収の道(sendPendingReportFiles)が送る=ここでは言わない。
5807
+ * ・形が整っていない報告は、今までどおり reportShapeNote が理由を言う。
5808
+ * ・異常終了(error)は自動でやり直す、止められた便(stopped)は人が止めた=どちらも続きの便は要らない。
5809
+ * 【★言うのは事実だけ】報告ファイルが無いこと・最後の動きの時刻。PC が止まっていたとは断定しない。
5810
+ */
5811
+ export function noReportEndNote(f) {
5812
+ if (f.endKind !== 'timeout' || f.phase !== 'none')
5813
+ return null;
5814
+ let text = '報告なしで終わりました(報告ファイルがありません=職人は報告を書く前に止まりました)。' +
5815
+ 'PR・合流など途中までの作業が残っていることがあるので、確かめと報告の続きの便が要ります';
5816
+ if (f.lastActivityAt !== null && f.finishedAt - f.lastActivityAt >= NO_REPORT_IDLE_GAP_MS) {
5817
+ const min = Math.round((f.finishedAt - f.lastActivityAt) / 60000);
5818
+ text +=
5819
+ `。最後の動きは ${new Date(f.lastActivityAt).toISOString()}(終わる${Math.floor(min / 60)}時間${min % 60}分前)` +
5820
+ '=その間 PC が止まっていた可能性があります';
5821
+ }
5822
+ return text;
5823
+ }
5795
5824
  /**
5796
5825
  * 管制へ送る本文(★純粋関数=単体テストできる)。
5797
5826
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.174",
3
+ "version": "0.12.176",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {