@tyhld/conductor 0.12.110 → 0.12.111

package/dist/autoupdate.js

@@ -310,6 +310,60 @@ const ENTRY_SYNC = [
     //       今までどおり人が設置台本を打つ）。ここで揃えるのは【受け口のファイルだけ】。
     { from: 'scripts/codex/codex-notify.py', dir: 'hooks', to: 'codex-notify.py', exe: true },
 ];
+// ── 番人の同期を、版の入れ替えと同じ時に1回起こす（便 b649d1f8・ADR-012 の穴） ──────
+//   【何が起きていたか（実測 2026-10-06）】
+//     受け口（codex-notify.py）は上の ENTRY_SYNC で【入れ替えと同時】に届くのに、
+//     番人（stop_hook.py など）は update-guard.sh の INSTALL_FILES からしか届かず、
+//     それを流すのは tyhld-guard-sync.timer＝【1時間ごと】。
+//     メインPC が 0.12.110 になった 09:57 から、番人がそろう 10:28:45 までの31分間、
+//     「受け口だけ新しく、番人が古い」半死の状態になった。その穴の中で流れた試験
+//     e13246e8 は、報告の本文が1文字も管制に載らなかった。
+//     ＝★番人を直した版を公開するたび、各PCで最長1時間その直しが効かない。
+//
+//   【なぜ ENTRY_SYNC に足すのではなく、同期を起こすのか（甲ではなく乙を選んだ理由）】
+//     ① 番人は1ファイルで完結しない。stop_hook.py は finish_gate / hook_datalink /
+//        summary_ja を import し、finish_gate.py は report-shape.json を実行時に読む。
+//        ENTRY_SYNC は1ファイルずつ写すので、ここへ stop_hook.py だけを足すと
+//        「入口だけ新しく、判定の本体と形の決まりが古い」というズレた組み合わせを
+//        新しく作ってしまう（＝いま直している穴と同じ種類の事故）。
+//     ② それを避けて番人一式（INSTALL_FILES ＋ INSTALL_CONFIGS）を ENTRY_SYNC へ並べると、
+//        配る物の一覧がリポジトリの中で【2か所】になる。今回の穴は「一覧が2つあって
+//        片方に stop_hook.py が無かった」事そのものなので、3つ目を作るのは根治にならない。
+//     ③ 同期を1回起こせば、配る中身を決めるのは今までどおり update-guard.sh の
+//        INSTALL_FILES だけ（正本は1つ）。番人一式が【同じ版から同時に】置かれるので、
+//        ファイルどうしで版がずれる組み合わせが原理的に作れない。
+//
+//   【番人を置いていないPCへ広がらない理由】
+//     このユニットを置くのは update-guard.sh の ①-f（APPLY=1 のときだけ）＝番人を
+//     設置したPCだけ。つまり【ユニットが在る ⟺ 番人が置いてある】。
+//     下の syncGuardNow は、ユニットの実体が無ければ systemctl を1回も呼ばずに戻る。
+//     ★ここから番人を新しく設置する道は1本も無い（置く中身を1バイトも持っていない）。
+/** 番人のコードと配線を正本へ揃える systemd --user サービス（systemd/tyhld-guard-sync.service）。 */
+export const GUARD_SYNC_UNIT = 'tyhld-guard-sync.service';
+/** そのPCに番人の同期サービスが設置されているか（＝番人が置いてあるPCか）。 */
+export function guardSyncUnitPath(home) {
+    return path.join(home, '.config', 'systemd', 'user', GUARD_SYNC_UNIT);
+}
+/**
+ * 番人の同期を1回起こす。★入れ替えた配布物から番人一式が置き直される。
+ *   戻り: 記録に残す1行（何もしなかった理由まで分かる形にする）。
+ *
+ * ★`--no-block` で頼むだけにする理由: 同期の本体（update-guard.sh）は公開 npm への
+ *   問い合わせを含み、数十秒かかることがある。入れ替えの手を止めて待つと、常駐の
+ *   起こし直しがその分遅れる。頼んだ後は systemd が面倒を見るので、待たなくてよい。
+ * ★失敗しても入れ替えは止めない（今までどおり1時間ごとの同期で追いつく）。
+ */
+export function syncGuardNow(d) {
+    const unit = guardSyncUnitPath(d.home);
+    if (!existsSync(unit))
+        return '番人の同期: このPCには番人が置かれていないので何もしませんでした';
+    const r = d.exec('systemctl', ['--user', 'start', '--no-block', GUARD_SYNC_UNIT], { timeoutMs: 15_000 });
+    if (r.status !== 0) {
+        return `番人の同期: 起こせませんでした（終了 ${r.status}・${(r.error ?? r.stderr).trim().slice(-120)}）`
+            + '。1時間ごとの同期で追いつきます';
+    }
+    return '番人の同期: 起こしました（番人一式が、入れ替えた版から置き直されます）';
+}
 /** 中身が1バイトも違わないか（★同じなら書き換えない＝毎回の入れ替えで日付だけ動かない）。 */
 function sameContent(a, b) {
     try {
@@ -529,6 +583,8 @@ async function rollBack(d, s, back) {
         const r = installConductor(d, back, true);
         d.log(r.detail);
         d.log(describeEntrySync(refreshEntries(d.home, d.distRoot)));
+        // ★戻すときも番人を一緒に戻す（入口だけ古い版、番人だけ新しい版を残さない）。
+        d.log(syncGuardNow(d));
         d.log(await restartRelays(d, back));
     }
     else {
@@ -785,6 +841,8 @@ export async function runUpdater(d) {
             return done(d, s, 'install-failed', r.detail);
         }
         d.log(describeEntrySync(refreshEntries(d.home, d.distRoot)));
+        // ★番人も【この瞬間】そろえる（1時間ごとの同期を待たない＝便 b649d1f8 の穴の根治）。
+        d.log(syncGuardNow(d));
         d.log(await restartRelays(d, want));
     }
     else {

package/dist/relay.js

@@ -661,7 +661,10 @@ export function relinkClosedCodexNotices(cfg, state, deps = {}, env = process.en
             turnId: notice.turnId ?? null,
         });
         logLine(`site=${cfg.site} id=${job.id} 便を閉じたあとに届いた終わりの知らせを、この便の報告として` +
-            `結び直しました（印が一致・閉じてから${Math.round((now - job.at) / 1000)}秒）: ${got.note}` +
+            // ★どの道の知らせで本文が載ったかを記録に出す（便 b649d1f8・決定4。ここは便を閉じる
+            //   道ではないが、知らせが報告になる3つ目の場所なので、記録の読み方をそろえる）。
+            `結び直しました（印が一致・閉じてから${Math.round((now - job.at) / 1000)}秒` +
+            `${codexRouteNote(notice.route)}）: ${got.note}` +
             '／★便の状態は書き換えていません（本文は後から届ける道で管制へ渡します）');
     }
 }
@@ -1424,6 +1427,17 @@ export function codexNotifyDir(env = process.env) {
     const home = (env.HOME ?? '').trim();
     return home ? path.join(home, '.tyhld', 'codex-notify') : '';
 }
+/** 知らせの「道」を記録に出す形にする。分からなければ空（＝今までどおりの行になる）。 */
+export function codexRouteNote(route) {
+    const r = (route ?? '').trim();
+    if (r === '')
+        return '';
+    if (r === 'notify')
+        return '・道=notify（Codex の notify）';
+    if (r === 'stop')
+        return '・道=stop（Codex の Stop フック）';
+    return `・道=${r}`;
+}
 /**
  * 書きかけの行が末尾に在るとき、書き終わるのを待つ長さ。これを過ぎても改行が来なければ
  * 書き手が落ちた残骸とみなし、今までどおり捨てて進む（＝受け皿が詰まらない）。
@@ -1481,6 +1495,7 @@ export function takeCodexNotices(site, env = process.env) {
                     turnId: o.turnId ?? null,
                     jobId: typeof o.jobId === 'string' && o.jobId.trim() !== '' ? o.jobId.trim() : null,
                     at: parseNoticeAt(o.at),
+                    route: typeof o.route === 'string' && o.route.trim() !== '' ? o.route.trim() : null,
                 });
             }
         }
@@ -1578,6 +1593,7 @@ export function takeCodexNoticesForJobId(site, commandId, env = process.env) {
                 turnId: o.turnId ?? null,
                 jobId,
                 at: parseNoticeAt(o.at),
+                route: typeof o.route === 'string' && o.route.trim() !== '' ? o.route.trim() : null,
             });
         }
         else {
@@ -5100,7 +5116,9 @@ export async function keepaliveTick(cfg, state, deps = {}) {
             if (!ok)
                 return; // 書けなければ畳まない（次の周でやり直す。知らせは使い切っている＝囲みは報告ファイルに残る）
             logLine(`site=${cfg.site} id=${ka.id} 見張り終了: 追跡が切れたあとに届いた終わりの知らせで完了を報告` +
-                `（印が一致${intake.wrote ? '・囲みから報告ファイル' : body !== null ? '・報告添付' : ''}）`);
+                `（印が一致${intake.wrote ? '・囲みから報告ファイル' : body !== null ? '・報告添付' : ''}` +
+                // ★どちらの道の知らせで閉じたかを記録に出す（便 b649d1f8・決定4）。
+                `${codexRouteNote(notice.route)}）`);
             await deliverJobEndFacts(cfg, {
                 commandId: ka.id,
                 site: cfg.site,
@@ -5508,7 +5526,9 @@ export async function relayTick(cfg, state, hooks) {
                         : await patchStatus(cfg, state.pending.id, 'done', report);
                     if (written) {
                         log(`site=${cfg.site} id=${state.pending.id} done（Codexの通知` +
-                            `${intake.wrote ? '・囲みから報告ファイル' : report != null ? '・報告添付' : ''}）`);
+                            `${intake.wrote ? '・囲みから報告ファイル' : report != null ? '・報告添付' : ''}` +
+                            // ★どちらの道の知らせで閉じたかを記録に出す（便 b649d1f8・決定4）。
+                            `${codexRouteNote(notice.route)}）`);
                         // ★終了の事実を同じ項目で届ける（便 915694ac・1-3）。この配り方では実プロセスを
                         //   中継が持っていないので、終わりは【つかめていない】と伝える（終了コードは null）。
                         //   届けるのは「中継が完了を確かめた」という事実だけ。★作り話の終了を送らない。

package/package.json

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

package/scripts/update-guard.sh

@@ -332,13 +332,38 @@ DIST_STATE="$GUARD_HOME/dist-source.state"   # 最後に【確かめられた】
 DIST_LAST="$GUARD_HOME/dist-source.last"     # 直近の【試み】の結果
 DIST_NOTIFY="$SCRIPT_DIR/hooks/skill_sync_notify.py"
 
+# 入っている版と公開の最新がそろっているか（★控えの1行に残す印）。
+#   none   … 同じ（入っているのが公開の最新）
+#   behind … 違う（段階配布の途中・公開より古い正規の版で動いている）
+#   unknown… どちらかが読めない
+#
+# 【なぜ要るか（実測 2026-10-06・便 b649d1f8）】
+#   メインPC が 0.12.110 へ入れ替わる31分前の同期は、控えに
+#     status=ok reason=verified version=0.12.109 published=0.12.110
+#   と書いていた。★この行は「うまくいった」としか読めないが、実際には
+#   「これから入れ替わる版の一つ前の番人を配った」回だった。版の食い違いは
+#   2つの値を自分で見比べないと分からず、見落とすと「配られたつもり」になる。
+# 【決め】status と reason は1文字も変えない（成否は変えない・止めない）。
+#   ★食い違いは【別の欄】で残す。status=failed にはしない：公開の最新より古い
+#     正規の版で動くのは段階配布では正常で、2026-10-02 にその理由（version-drift）を
+#     「配らない理由」から外したばかり（便 29babc5d）。そこへ戻さない。
+dist_drift() {
+  if [[ -z "${DIST_VERSION:-}" || -z "${DIST_PUBLISHED:-}" ]]; then
+    printf 'unknown'
+  elif [[ "$DIST_VERSION" == "$DIST_PUBLISHED" ]]; then
+    printf 'none'
+  else
+    printf 'behind'
+  fi
+}
+
 # 直近の試みを1行残す。★確かめられたときだけ .state も更新する（成功と偽らない）。
 #   ★確認のみ（APPLY!=1）のときは1バイトも書かない。「見ただけ」で控えが動くと、
 #     控えが「実際に配った記録」でなくなり、外から見て何が起きたのか分からなくなる。
 dist_record() {
   [[ "$APPLY" == "1" ]] || return 0
   local status="$1" reason="$2" line
-  line="$(date '+%Y-%m-%dT%H:%M:%S%z') status=${status} reason=${reason} what=dist-source version=${DIST_VERSION:-unknown} published=${DIST_PUBLISHED:-unknown} root=${DIST_ROOT:-none}"
+  line="$(date '+%Y-%m-%dT%H:%M:%S%z') status=${status} reason=${reason} what=dist-source version=${DIST_VERSION:-unknown} published=${DIST_PUBLISHED:-unknown} drift=$(dist_drift) root=${DIST_ROOT:-none}"
   mkdir -p "$GUARD_HOME" 2>/dev/null || true
   printf '%s\n' "$line" > "$DIST_LAST" 2>/dev/null || true
   if [[ "$status" == "ok" ]]; then