@takagaki/cortex-decisions-viewer 0.12.54 → 0.12.56

package/dist/render.js

@@ -37,6 +37,10 @@ exports.sanitizeCapabilitiesNow = sanitizeCapabilitiesNow;
 exports.sanitizeGithubOwnersNow = sanitizeGithubOwnersNow;
 exports.splitNeededParts = splitNeededParts;
 exports.ingestedAtOf = ingestedAtOf;
+exports.ingestedRowOf = ingestedRowOf;
+exports.runLogUrlOf = runLogUrlOf;
+exports.lastSyncRunUrlOf = lastSyncRunUrlOf;
+exports.runSourceWordOf = runSourceWordOf;
 exports.fleetLastSyncOf = fleetLastSyncOf;
 exports.stateRefKey = stateRefKey;
 exports.registeredRefKeys = registeredRefKeys;
@@ -977,7 +981,23 @@ const STATE_STATUSES = {
     // 「作成済み」の行が overlay に届く前に落ちて、画面は永久に「作成中」のまま
     calendar: ["requested", "ok", "failed"],
 };
-const STATE_ROW_FIELDS = ["cap", "ref", "workspace", "question", "status", "at", "by", "needed", "detail", "lastOkAt", "lastFailAt"];
+const STATE_ROW_FIELDS = ["cap", "ref", "workspace", "question", "status", "at", "by", "needed", "detail", "lastOkAt", "lastFailAt", "runUrl"];
+/**
+ * 行の `runUrl`（その行を書いた GitHub Actions の run・#560）に許す形。**原本は
+ * `infra/lambda/shared/connection-state-keys.mjs` の `RUN_URL_RE`**で、これはその写し
+ * （画面は `href` にそのまま置くので、intake が篩ったあとでも画面側でもう一度縛る）。
+ * 埋め込み JS には `var RUN_URL_RE` として注入する（export すると `exports.` 参照が客先へ
+ * 渡って画面が死ぬ——`state-vocab-parity.test.mjs` 冒頭の実害）。
+ */
+const RUN_URL_RE = /^https:\/\/github\.com\/[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+\/actions\/runs\/[0-9]+$/;
+/** `runUrl` を持てる書き手（Actions の run の中で動く engine の書き手）。ほかの書き手の値は出さない */
+const RUN_URL_WRITERS = ["ingest", "gold", "nightly"];
+/**
+ * `runUrl` が無い行の出どころの語（#560）。run が無い書き手だけ。**`ingest` / `gold` は
+ * 載せない**——`runUrl` が無いのは古い engine か固定 IP の CodeBuild で、行からは区別できない
+ * （「Webhook」と断定すると嘘になる）
+ */
+const RUN_SOURCE_WORDS = { central: "中央の処理", button: "その場で確認", auto: "保存時に確認" };
 /** stateNow はライブ専用キーで build.ts の網にかからない。画面側でも許可リストを通す */
 function sanitizeStateNow(v) {
     if (!Array.isArray(v))
@@ -999,6 +1019,9 @@ function sanitizeStateNow(v) {
             continue; // 知らない語は「不明」に化けさせず落とす
         if (!item.cap || !item.ref || !item.at)
             continue;
+        // `runUrl` は run ページの形だけ（#560）。形が違えば**欄だけ落として行は残す**
+        if (item.runUrl && !RUN_URL_RE.test(item.runUrl))
+            delete item.runUrl;
         out.push(item);
     }
     return out.length ? out : null;
@@ -1079,6 +1102,8 @@ function overlayStateOnFleet(view, rows) {
             gateBy: hit.by,
             needed: hit.needed || "",
             detail: hit.detail || "",
+            // その行を書いた run（#560）。無ければ空
+            gateRunUrl: hit.runUrl || "",
         });
     });
     return changed ? Object.assign({}, v, { externalSources: externals }) : v;
@@ -1922,6 +1947,75 @@ function ingestedAtOf(rows, capId, refs) {
     }
     return best;
 }
+/**
+ * `ingestedAtOf` と**同じ選び方**で、時刻ではなく**その行**を返す（#560）。「最終同期」の横に
+ * 「実行ログ」を出すために要る。選び方をここに書き写さず、同じ規則で行を選ぶ
+ * （分かれると「最終同期の時刻」と「そのリンク先の run」が別の行のものになる）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ * @returns 選んだ行。1件も無ければ null
+ */
+function ingestedRowOf(rows, capId, refs) {
+    if (!Array.isArray(rows) || !capId)
+        return null;
+    let best = "";
+    let bestRow = null;
+    for (const r of rows) {
+        if (!r || r.cap !== capId || r.question !== "ingested")
+            continue;
+        if (refs && !refs[stateRefKey(capId, r.ref, r.workspace)])
+            continue;
+        const at = r.lastOkAt || (r.status === "ok" ? r.at : "");
+        if (typeof at === "string" && at > best) {
+            best = at;
+            bestRow = r;
+        }
+    }
+    return bestRow;
+}
+/**
+ * 行の横に出す「実行ログ」のリンク先（#560）。**無ければ空文字。**
+ *
+ * 出すのは Actions の run の中で動く書き手（`RUN_URL_WRITERS`）の行だけ。ボタン・中央の
+ * 書き手は intake が `runUrl` を消して書くが、画面側でも二重の網にする——残っていると
+ * 「いま測った結果」の横に別の run のログが出る。形は `RUN_URL_RE`（`href` にそのまま置く）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function runLogUrlOf(row) {
+    if (!row || typeof row.runUrl !== "string" || !RUN_URL_RE.test(row.runUrl))
+        return "";
+    if (RUN_URL_WRITERS.indexOf(String(row.by || "")) < 0)
+        return "";
+    return row.runUrl;
+}
+/**
+ * 「最終同期: …」の横に出すリンク先（#560）。**その時刻を書いた run のときだけ。**
+ *
+ * 「最終同期」は `lastOkAt`（最後に取り込めた時刻）で、行の `runUrl` は**いまの status を
+ * 書いた run**のもの。いま `failed` の行の `lastOkAt` が最大なら、その `runUrl` は失敗した run
+ * を指すので出さない（間違った run へ送るより、無いほうがよい）。`ok` の行でも `lastOkAt` と
+ * `statusAt` が違う（履歴だけ先に進んだ）回は出さない。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function lastSyncRunUrlOf(row) {
+    if (!row || row.status !== "ok")
+        return "";
+    if (row.lastOkAt && row.lastOkAt !== row.at)
+        return "";
+    return runLogUrlOf(row);
+}
+/**
+ * `runUrl` の無い行に添える出どころの語（#560）。リンクが出る行・語の無い書き手は空文字。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function runSourceWordOf(row) {
+    if (!row || runLogUrlOf(row))
+        return "";
+    return RUN_SOURCE_WORDS[String(row.by || "")] || "";
+}
 /**
  * まとめ表（fleet-status.json）の「最終同期」を、画面に出してよい形で取る（#523 決定1）。
  *
@@ -3926,6 +4020,12 @@ a.ds-tile:hover { text-decoration: none; }
 .ds-all-connected { color: var(--muted); }
 .ds-gate { display: inline-flex; align-items: center; gap: 5px; font-size: 12.5px; font-weight: 600; flex: 0 0 auto; }
 .ds-gate-at { font-size: 11px; color: var(--muted); flex: 0 0 auto; }
+/* 実行ログへの導線（#560）。時刻の横の添え物なので .ds-gate-at と同じ弱さ。押せることだけ
+   点線の下線で示す（目立たせない——案件リポジトリに入っていない人には開けない） */
+.ds-run-link { font-size: 11px; color: var(--muted); flex: 0 0 auto; text-decoration: underline dotted; text-underline-offset: 2px; }
+.ds-run-link:hover { color: var(--text); }
+/* run の無い書き手の行の出どころ（「中央の処理」「その場で確認」）。同じ弱さの文字 */
+.ds-run-src { font-size: 11px; color: var(--muted); flex: 0 0 auto; }
 /* 接続先1件ごとの「取り込み」（段C・2026-08-24）。**「最終同期」（.ds-sync・run単位）とは
    別の行に並ぶ**ので、同じ強さにしない——run の時刻より弱い添え物として読ませる。
    失敗だけは .ds-gate-warn と同じ色にする（同じ画面で警告の色が2種類あると、
@@ -3963,7 +4063,10 @@ a.ds-tile:hover { text-decoration: none; }
 .ds-probe-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
 /* いつ測った結果かを必ず添える。夜間のスナップショットと混ざると、どちらの話か読めない */
 .ds-probe-at { font-size: 11.5px; color: var(--muted); }
-.ds-probe-help { margin: 6px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280;
+/* flex: 1 1 100% は #548 で足した——「接続を確認」の即答は、この段を .ds-probe の中では
+   なく**行（.ds-card）に直接**置く。付けないと ID と「外す」の横に押し込まれて折り返す
+   （.ds-gate-help と同じ理由）。.ds-probe の中（display: block）では効かない */
+.ds-probe-help { flex: 1 1 100%; margin: 6px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280;
   min-width: 0; white-space: normal; overflow-wrap: anywhere; }
 /* 「アクセス不可」の原因の候補（0.12.2）。**箇条書きにする**——候補が3つあるので、
    一続きの文章にすると読む人が「自分がどれなのか」を自分で切り出すことになる
@@ -4487,6 +4590,12 @@ ${pending_ops_1.pendingCountDelta.toString()}
 ${pending_ops_1.pendingIssuesRef.toString()}
 var STATE_STATUSES = ${JSON.stringify(STATE_STATUSES)};
 var STATE_ROW_FIELDS = ${JSON.stringify(STATE_ROW_FIELDS)};
+  // 行の runUrl の形と、出どころの語（#560）。**正規表現は JSON にできない**ので
+  // source から組み立てる。この定数行を落とすと sanitizeStateNow が未定義を参照して
+  // ライブ取得が丸ごと死ぬ
+var RUN_URL_RE = new RegExp(${JSON.stringify(RUN_URL_RE.source)});
+var RUN_URL_WRITERS = ${JSON.stringify(RUN_URL_WRITERS)};
+var RUN_SOURCE_WORDS = ${JSON.stringify(RUN_SOURCE_WORDS)};
 ${sanitizeStateNow.toString()}
 ${overlayStateOnFleet.toString()}
   // Home の「使用ツール」（#275）。**判定と表示語の実体はビルド時の定義**——
@@ -4519,6 +4628,10 @@ ${stateRefKey.toString()}
 ${registeredRefKeys.toString()}
 ${fleetLastSyncOf.toString()}
 ${ingestedAtOf.toString()}
+${ingestedRowOf.toString()}
+${runLogUrlOf.toString()}
+${lastSyncRunUrlOf.toString()}
+${runSourceWordOf.toString()}
 var TILE_CAPS = ${JSON.stringify(TILE_CAPS)};
 var BAD_STATE_STATUSES = ${JSON.stringify(BAD_STATE_STATUSES)};
   // 登録直後の一時表示（#523 決定6）。**この定数行を落とすと、流し込んだ deriveCapTile が
@@ -6617,18 +6730,48 @@ ${calendarAddUrl.toString()}
     });
     return p;
   }
+  /**
+   * ボタンの detail が「機械語の痕跡」でしかない能力（#548・設計v2 🔴2）。
+   *
+   * この3つは中央が艦隊の鍵で叩く経路（gate）で、押した回の detail には判定の語そのもの
+   * （"unreachable"）や生のエラー（"ratelimited"）が入る。**それ以外の能力
+   * （design / materials / issues）のボタンは、engine の取り込みと同じ判定器の
+   * 同じ1文を書く**ので、出さないと「読めません」の理由が押した人に届かない。
+   */
+  var GATE_BUTTON_CAPS = ["chat", "dev", "google-chat"];
+  /**
+   * 外部ソースの種別 → 接続状態ストアの能力 id。**上の除外を引くためだけに使う。**
+   * 知らない種別は空文字（＝除外に当たらない＝理由を出す側に倒す）。
+   */
+  function gateCapOfType(type) {
+    var t = String(type || "");
+    if (t === "slack") return "chat";
+    if (t === "google-chat") return "google-chat";
+    if (t.indexOf("github") === 0) return "dev";
+    return "";
+  }
   /**
    * 休止状態の行に出す「最後に測った理由」（表にエントリが無い状態のフォールバック）。
    * needed（次の一手・URL 込み）を優先し、無ければ detail。
    *
-   * 🔴 **書き手が button の detail は出さない。** ボタンは detail に判定の語そのもの
-   * （"unreachable"）や生のエラー（"ratelimited"）を書く——lastFailDetail を空で潰さない
-   * ための痕跡で、表示用の値ではない（intake の op=probe のコメント）。人向けの文を持つのは
-   * needed の側。夜間（gold）の detail は人向けの文なので出す
+   * 🔴 **gate 経路の書き手が button の detail は出さない。** Slack / GitHub / Google Chat の
+   * ボタンは detail に判定の語そのもの（"unreachable"）や生のエラー（"ratelimited"）を
+   * 書く——lastFailDetail を空で潰さないための痕跡で、表示用の値ではない（intake の
+   * op=probe のコメント）。人向けの文を持つのは needed の側。夜間（gold）の detail は
+   * 人向けの文なので出す。
+   *
+   * 🔴 **除外は能力で絞る（#548）。** Figma / Drive / Backlog のボタンは中央がその場で
+   * 案件の鍵で叩いて、engine の取り込みと同じ判定器の同じ1文を detail に書く。
+   * 「button なら出さない」と一律にすると、**押した人にだけ理由が届かない**
+   * （夜間まで待てば同じ文が出る、という逆立ちした画面になる）。
+   *
+   * @param s needed / detail / gateBy に加えて **cap（接続状態ストアの能力 id）** を渡す。
+   *   cap を渡さない呼び方は「除外に当たらない」＝理由を出す側に倒れる
    */
   function stateReasonOf(s) {
     if (s.needed) return String(s.needed);
-    if (s.detail && s.gateBy !== "button") return String(s.detail);
+    var hidden = s.gateBy === "button" && GATE_BUTTON_CAPS.indexOf(String(s.cap || "")) >= 0;
+    if (s.detail && !hidden) return String(s.detail);
     return "";
   }
   /**
@@ -8965,9 +9108,18 @@ ${calendarAddUrl.toString()}
     function capBlockSyncEl(s, inactive) {
       if (inactive || !s || !s.kind) return null;
       var capId = capIdOf(s.kind);
-      var at = capId ? ingestedAtOf(LIVE_STATE, capId, refKeysOf(derCapOf(s.kind, ""))) : "";
+      var refs = capId ? refKeysOf(derCapOf(s.kind, "")) : null;
+      var at = capId ? ingestedAtOf(LIVE_STATE, capId, refs) : "";
       var t = dsFmtTime(at || fleetSyncFallback(s) || "");
-      return t ? el("span", { class: "ds-sync", text: "最終同期: " + t }) : null;
+      if (!t) return null;
+      var sync = el("span", { class: "ds-sync", text: "最終同期: " + t });
+      // その時刻を書いた run へ（#560）。**ストア由来の時刻のときだけ**——まとめ表の後詰めに
+      // run は無い。行は「ingestedAtOf」 と同じ選び方（「ingestedRowOf」）で取る。
+      // run の無い書き手（中央 Apps Script の会議・資料の取り込み）は出どころの語
+      var row = at ? ingestedRowOf(LIVE_STATE, capId, refs) : null;
+      var url = lastSyncRunUrlOf(row);
+      var trail = url ? [runLogLink(url)] : row ? runTrailNodes(row, "") : [];
+      return trail.length ? frag([sync].concat(trail)) : sync;
     }
 
     if (internals.length) {
@@ -10332,6 +10484,8 @@ ${calendarAddUrl.toString()}
         // 古い「X分前に確認」を残さない（下に出るいまの結果と、時刻が2つ並ぶ）
         var oldAt = card.querySelector(".ds-gate-at");
         if (oldAt) oldAt.remove();
+        // 古い run の導線も残さない（#560）。「いま測った結果」の横に夜間の run のログが並ぶ形になる
+        removeRunTrail(card);
         // 🔴 **古いスコープ名の札も必ず消してから出し直す。** 行には夜間の判定に添えた
         // 札が出ていることがあり（段B）、置き換えた「接続OK」の横に古いスコープ名が
         // 残ると、同じ行が2つのことを言う——この節が何度も直してきた形そのもの。
@@ -10784,6 +10938,59 @@ ${calendarAddUrl.toString()}
     return null;
   }
 
+  /* -------------------------------------------------------------------------
+   * 実行ログへの導線（#560）
+   * -------------------------------------------------------------------------
+   * 行の 「runUrl」（その行を書いた Actions の run）があれば、時刻の横に小さな「実行ログ ↗」を
+   * 出す。run の無い書き手の行は、出どころを語で示す（「中央の処理」「その場で確認」）。
+   * どちらを出すかの判断は純関数（runLogUrlOf / runSourceWordOf）が持ち、ここは描くだけ。
+   * ----------------------------------------------------------------------- */
+
+  /** リンクの title。案件リポジトリに入っていない人には開けないので、押す前に分かるようにする */
+  var RUN_LINK_TITLE = "GitHub Actions の実行ログを開きます（案件リポジトリへのアクセスが要ります）";
+  /** 一覧（開始直後・run の番号がまだ無い）の title。飛び先が違うので文言も分ける */
+  var RUN_LIST_TITLE = "GitHub Actions の実行の一覧を開きます（案件リポジトリへのアクセスが要ります）";
+  var RUN_LIST_TEXT = "実行の一覧 ↗";
+
+  /** 「実行ログ ↗」（新しいタブ・title つき）。一覧のときは文言と title を一覧のものにする */
+  function runLogLink(url, text) {
+    var list = text === RUN_LIST_TEXT;
+    return el("a", { class: "ds-run-link", href: url, target: "_blank", rel: "noopener", title: list ? RUN_LIST_TITLE : RUN_LINK_TITLE, text: text || "実行ログ ↗" });
+  }
+
+  /**
+   * 行の時刻の横に添えるもの（リンクか出どころの語）。**無ければ空配列。**
+   * 「.ds-gate-at」「.ds-ingest」 の**兄弟**として置く（子にすると、文言の検査と
+   * 「いま測った結果」への差し替えが崩れる）。
+   *
+   * @param kind どの時刻に添えたか（「gate」＝「◯分前に確認」）。「いま測った結果」への差し替えは
+   *   **この印のものだけ**消す——「取り込み: 〜に成功」の横のリンク（別の行の run）は残す
+   */
+  function runTrailNodes(row, url, kind) {
+    var u = url === undefined ? runLogUrlOf(row) : url;
+    var word = u ? "" : runSourceWordOf(row);
+    var node = u ? runLogLink(u) : word ? el("span", { class: "ds-run-src", text: word }) : null;
+    if (!node) return [];
+    if (kind) node.setAttribute("data-trail", kind);
+    return [node];
+  }
+
+  /** 複数のノードを 1 つの子として返す（「el」 の children に並べるため） */
+  function frag(nodes) {
+    var f = document.createDocumentFragment();
+    (nodes || []).forEach(function (n) { if (n) f.appendChild(n); });
+    return f;
+  }
+
+  /**
+   * 「いま測った結果」に差し替えるとき、**「◯分前に確認」に添えた**古い run の導線を外す
+   * （同じ行が 2 つのことを言わない）。「取り込み: 〜に成功」の横のリンクは別の行の run なので残す
+   */
+  function removeRunTrail(scope) {
+    var old = scope.querySelectorAll('.ds-run-link[data-trail="gate"], .ds-run-src[data-trail="gate"]');
+    for (var i = 0; i < old.length; i++) old[i].remove();
+  }
+
   /**
    * 接続先1件の「取り込み」の表示。**測っていなければ何も出さない（null）。**
    *
@@ -10806,10 +11013,12 @@ ${calendarAddUrl.toString()}
     // 語は鍵カードの名前と揃える（keyMissingText の項）
     else if (r.status === "skipped") text = "取り込み: 未実行（" + keyMissingText(cap) + "）";
     if (!text) return null;
-    return el("span", {
+    var span = el("span", {
       class: "ds-ingest" + (r.status === "failed" ? " ds-ingest-failed" : ""),
       text: text,
     });
+    // その行を書いた run へ（#560）。成功でも失敗でも、この時刻を書いた run のログ
+    return frag([span].concat(runTrailNodes(r)));
   }
 
   /**
@@ -10851,6 +11060,8 @@ ${calendarAddUrl.toString()}
     row.appendChild(el("span", { class: "ds-gate " + gate.cls, text: gate.text }));
     var when = rtAgo(r.at);
     if (when) row.appendChild(el("span", { class: "ds-gate-at", text: when + "に確認" }));
+    // その行を書いた run へ（#560）。run の無い書き手は出どころの語
+    runTrailNodes(r, undefined, "gate").forEach(function (n) { row.appendChild(n); });
     return row;
   }
 
@@ -10879,22 +11090,26 @@ ${calendarAddUrl.toString()}
       return row;
     }
     if (r.status === "ok" || r.status === "no_token" || r.status === "missing_scope" || r.status === "not_in_channel") return row;
-    var reason = stateReasonOf({ needed: r.needed, detail: r.detail, gateBy: r.by });
+    // **cap を渡す（#548）。** この3能力（design / materials / issues）のボタンは
+    // 判定器の1文を detail に書くので、gate 経路の除外に当てない（stateReasonOf の項）
+    var reason = stateReasonOf({ needed: r.needed, detail: r.detail, gateBy: r.by, cap: capId });
     // needed は Slack の行と同じ部品を通す（URL がリンクになる・スコープ名がラベル化される）
     if (reason) row.appendChild(r.needed ? neededNode(reason, "ds-gate-help") : el("p", { class: "ds-gate-help", text: reason }));
     return row;
   }
 
   /* -------------------------------------------------------------------------
-   * dispatch の「接続を確認」（#523 S3・Backlog / Drive / Figma）
+   * 「接続を確認」と「今すぐ同期」（#523 S3・#548・Backlog / Drive / Figma）
    * -------------------------------------------------------------------------
-   * Slack / GitHub / Google Chat の確認（「probeSection」）は中央がその場で叩いて
-   * 答えを返すが、この3つは**中央が鍵を読まない**（#105 決定5）ので、押すと
-   * その案件の同期が1回起きるだけ。答えは接続状態ストアの行として後から届く。
+   * #548 までは、この3つは中央が鍵を読まない（#105 決定5）ので、押すとその案件の同期が
+   * 1回起きるだけだった。オーナーがその境界を覆し、いまは「接続を確認」は Slack / GitHub と
+   * 同じく**中央がその場で叩いて答えを返す**（即答・「showProbeVerdict」）。同期を1回
+   * 起こす従来の動きは「今すぐ同期」（送る値に 「sync: true」）に移った。
    *
-   * だから画面がすることは3つ:
+   * 待ちの仕組み（下）は「今すぐ同期」と、Backlog が IP 制限で叩けず夜間と同じ経路へ
+   * 倒れた回のために残る:
    *   1. 押す前にその行の 「at」 を控える（🔴2・壁時計を使わない）
-   *   2. 「確認を開始しました」を出して、取り直し（op=state）を回す
+   *   2. 「同期を開始しました」を出して、取り直し（op=state）を回す
    *   3. 控えた 「at」 より新しい行が届いたら、待ちを解いて札を描き直す
    *      ——札そのものは 「appendReachableChip」 が描くので、ここは待ちの表示だけ
    * ----------------------------------------------------------------------- */
@@ -10972,60 +11187,203 @@ ${calendarAddUrl.toString()}
   }
 
   /**
-   * 接続先1件の「接続を確認」（ボタン＋待ちの1文）を行に足す。
+   * 断られた回の後始末。**待ちに入れない**（出ない結果を15分待たせない）。
+   * 文言はサーバのものをそのまま出す（回数制限・鍵未登録・未登録の接続先・
+   * 登録簿が読めない・ロール未登録・起動失敗が、全部ここへ来る）。
+   */
+  function probeDeclined(note, key, j) {
+    note.textContent = (j && j.message) || "確認できませんでした。";
+    delete PROBE_WAITS[key];
+  }
+
+  /**
+   * 従来の待ちに入る（同期が1回起きて、答えは接続状態ストアの行として後から届く）。
+   * 通るのは2つ——「今すぐ同期」と、Backlog が IP 制限でこの場では叩けず
+   * **夜間と同じ経路へ倒れた回**（#548）。
+   *
+   * 🔴 **控えた 「at」 で待つ（🔴2・壁時計を使わない）。** 押した時刻で見ると、
+   * 端末の時計がずれている人には永久に届かない（または届く前に届いたことになる）。
+   */
+  function probeEnterWait(note, key, capId, ref, before, j) {
+    PROBE_WAITS[key] = {
+      cap: capId, ref: ref,
+      at: (before && before.at) || "",
+      startedAt: Date.now(),
+      message: (j && j.message) || "",
+      // 起こした run（特定できた回）と一覧（#560）。描き直しでもリンクが消えないよう控える
+      runUrl: (j && RUN_URL_RE.test(String(j.runUrl || ""))) ? String(j.runUrl) : "",
+      runsUrl: (j && /^https:\\/\\/github\\.com\\/[^\\s"'<>]+$/.test(String(j.runsUrl || ""))) ? String(j.runsUrl) : "",
+    };
+    probeWaitNote(note, PROBE_WAITS[key]);
+    // 待っているあいだは取り直しを回す（届いた行で一覧が描き直される）
+    refreshStateTimer();
+  }
+
+  /**
+   * 待ちの 1 文と、その横の導線（#560）。**その run を特定できていればそれ、無ければ一覧。**
+   * 開始直後は run の番号が無いことが多いので一覧へ。行が更新されて待ちが解けたら、
+   * 行側の「実行ログ ↗」（その run）に置き換わる。run の無い経路（固定 IP・中央）は何も出ない
+   */
+  function probeWaitNote(note, wait) {
+    note.textContent = (wait && wait.message) || "";
+    if (!wait) return;
+    var link = wait.runUrl ? runLogLink(wait.runUrl) : wait.runsUrl ? runLogLink(wait.runsUrl, RUN_LIST_TEXT) : null;
+    if (link) {
+      note.appendChild(document.createTextNode(" "));
+      note.appendChild(link);
+    }
+  }
+
+  /**
+   * 即答（#548 の direct）を行に映す。**「probeSection」 と同じ見た目にする**——
+   * 夜間のスナップショットの判定といま測った判定を**同じ行に並べない**ため
+   * （並べると「⚠️ と 接続OK が同時に出ている」になり、この節で何度も直してきた
+   * 食い違いを画面の側から作ることになる）。置き換えたことが分かるよう、
+   * いつ測ったかを必ず添える。
+   *
+   * 🔴 **札が無い行もある**（一度も測っていない接続先＝ 「appendReachableChip」 が
+   * 何も足していない行）。その場合は札を作って**ボタンの前**に差し込む——後ろに置くと
+   * 行の読み順（札 → ボタン）が崩れる。
+   *
+   * @param anchor 差し込む位置の目印（1つ目のボタン）
+   */
+  function showProbeVerdict(row, capId, anchorIn, j) {
+    var gate = dsGateForCap(capId, j.gate);
+    // 差し込む位置は**行の最初のボタン**の前（「外す」が出る行では「外す」の前）。
+    // 「接続を確認」の前に置くと、外せる行だけ「外す → 札 → ボタン」の並びになる（🟡10）
+    var anchor = anchorIn;
+    var btns = row.querySelectorAll(".ds-toggle-btn");
+    for (var bi = 0; bi < btns.length; bi++) {
+      // **行の直下にあるボタンだけ**が目印になれる（入れ子の中のボタンの前には差し込めない）
+      if (btns[bi].parentNode === row) { anchor = btns[bi]; break; }
+    }
+    var chip = row.querySelector(".ds-gate");
+    if (!chip) {
+      chip = el("span", { class: "ds-gate" });
+      row.insertBefore(chip, anchor);
+    }
+    chip.className = "ds-gate " + gate.cls;
+    chip.textContent = gate.text;
+    var at = row.querySelector(".ds-gate-at");
+    if (!at) {
+      at = el("span", { class: "ds-gate-at" });
+      row.insertBefore(at, anchor);
+    }
+    at.textContent = "いま測った結果（" + (dsFmtTime(j.checkedAt) || "たった今") + "）";
+    // 古い run の導線も外す（#560）。残すと「いま測った結果」の横に夜間の run のログが並ぶ
+    removeRunTrail(row);
+    // **夜間の判定に添えてあった案内は隠す。** 置き換えた判定と食い違う案内が下に残ると、
+    // 同じ行が2つのことを言う（probeSection の stale 処理と同じ）
+    var stale = row.querySelectorAll(".ds-gate-help");
+    for (var si = 0; si < stale.length; si++) stale[si].hidden = true;
+    // **押し直しで段が増えないよう、前回の結果は消してから出す**（probeSection の札と同じ）
+    var old = row.querySelectorAll(".ds-probe-help");
+    for (var oi = 0; oi < old.length; oi++) old[oi].remove();
+    // 次の一手は語の表（DS_GATE_CAP）が持っていればそれ。無ければ判定器の1文（detail）
+    // ——どちらも**1段だけ**（帯は症状・行は一手・繰り返さない）
+    var nodes = gateHelpNodes(gate, "ds-probe-help");
+    if (!nodes.length && j.detail) nodes = [el("p", { class: "ds-probe-help", text: String(j.detail) })];
+    nodes.forEach(function (n) { row.appendChild(n); });
+  }
+
+  /**
+   * 接続先1件の「接続を確認」「今すぐ同期」（2ボタン＋その場の返事1文）を行に足す。
+   *
+   * **なぜ2つに割れたか（#548）。** 中央が案件の鍵で1回だけ叩けるようになった
+   * （オーナーが #105 決定5 を覆した）ので、「接続を確認」は**その場で答えが返る**
+   * ——押した人を数分〜十数分待たせない。一方「取り込みをやり直したい」は別の用事なので、
+   * 同期を1回起こす従来の動きは「今すぐ同期」として残す（送る値は 「sync: true」）。
    *
    * **ボタンは行の中**（Slack の行と同じ・2026-08-20 の「1行が2段になる」を繰り返さない）。
-   * 待ちの1文は 「.ds-gate-help」 で行の最後に落とす（「appendReachableReason」 の項）。
+   * 🔴 **その場の返事（「.ds-probe-wait」）は2つのボタンで1つ・行の最後。** 2つ持つと
+   * 行が2段になり、片方に古い返事が残る。「ds-gate-help」 は付けない——あれは
+   * 「最後に測った理由」の1段で、行の補足が1段であることを見張る検査（#523 S1）が
+   * 数えている。押した人へのその場の返事は別の話なので、専用の class を持たせる。
    */
   function appendDispatchProbe(row, capId, ref) {
     var type = dispatchProbeTypeOf(capId);
     // **書き込み経路が無ければ出さない**（押しても何も起きないボタンを置かない）
     if (!type || !SITE.intake || !ref) return row;
-    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "接続を確認" });
-    // 🔴 **「ds-gate-help」 を付けない。** あれは「最後に測った理由」の1段で、
-    // 行の補足が1段であることを見張る検査（#523 S1）が数えている。待ちの1文は
-    // 別の話（押した人へのその場の返事）なので、専用の class を持たせる
+    var checkBtn = el("button", { class: "ds-toggle-btn", type: "button", text: "接続を確認" });
+    var syncBtn = el("button", { class: "ds-toggle-btn", type: "button", text: "今すぐ同期" });
     var note = el("p", { class: "ds-probe-wait" });
     var phase = probeWaitPhaseOf(capId, ref);
     var wait = probeWaitOf(capId, ref);
-    if (phase === "waiting") note.textContent = (wait && wait.message) || "";
-    else if (phase === "timeout") note.textContent = PROBE_WAIT_TIMEOUT_TEXT;
+    if (phase === "waiting") probeWaitNote(note, wait);
+    else if (phase === "timeout") {
+      // 15 分待って届かないなら見に行く番。**行き先を添える**（#560）——一覧でも run でも
+      note.textContent = PROBE_WAIT_TIMEOUT_TEXT;
+      var to = wait && (wait.runUrl || wait.runsUrl);
+      if (to) { note.appendChild(document.createTextNode(" ")); note.appendChild(runLogLink(to, wait.runUrl ? "実行ログ ↗" : RUN_LIST_TEXT)); }
+    }
     else note.hidden = true;
 
-    btn.addEventListener("click", async function () {
-      var endBusy = beginBusy(btn, "確認中…");
+    checkBtn.addEventListener("click", async function () {
+      var endBusy = beginBusy(checkBtn, "確認中…");
       note.hidden = false;
       note.textContent = "確認中…";
       // 🔴 **押す前に、いまの行の 「at」 を控える（🔴2）。** 行が無ければ空文字
-      //（どんな 「at」 が来ても「新しい」と読める）
+      //（どんな 「at」 が来ても「新しい」と読める）。使うのは IP 制限で倒れた回だけだが、
+      // 応答が返ってからでは「押す前の行」を控えられない
       var before = probeLatestRow(capId, ref);
       var key = probeWaitKey(capId, ref);
       try {
         var res = await callIntake("probe", { type: type, ref: ref });
         var j = await res.json().catch(function () { return {}; });
         if (!res.ok || j.queued === false) {
-          // サーバの文言をそのまま出す（回数制限・鍵未登録・ロール未登録・起動失敗）
-          note.textContent = j.message || "確認できませんでした。";
-          delete PROBE_WAITS[key];
+          probeDeclined(note, key, j);
           endBusy();
           return;
         }
-        PROBE_WAITS[key] = {
-          cap: capId, ref: ref,
-          at: (before && before.at) || "",
-          startedAt: Date.now(),
-          message: j.message || "",
-        };
-        note.textContent = j.message || "";
-        // 待っているあいだは取り直しを回す（届いた行で一覧が描き直される）
-        refreshStateTimer();
+        if (!j.gate) {
+          // 語が返らない回＝この場では叩けなかった回。Backlog の IP 制限
+          //（「reason」 が 「ip-restricted」）で夜間と同じ経路へ倒したときと、
+          // 即答をまだ知らない古い Lambda が相手のとき。どちらも従来どおり待つ
+          probeEnterWait(note, key, capId, ref, before, j);
+          endBusy();
+          return;
+        }
+        // 即答。🔴 **待ちには入れない（🟡7）**——結果はもう行に出ているので、
+        // 待ちに入れると「届いた行」を探して15分待つ空回りになる
+        delete PROBE_WAITS[key];
+        note.hidden = true;
+        note.textContent = "";
+        showProbeVerdict(row, capId, checkBtn, j);
+        // ストアにも 「button」 の行が書かれている。**取りに行くのは1回だけ**——
+        // 届いた行で一覧が描き直され、この行の札が正本の値に揃う
+        loadLiveFleet();
       } catch (e) {
         note.textContent = "通信に失敗しました。";
         delete PROBE_WAITS[key];
       }
       endBusy();
     });
-    row.appendChild(btn);
+
+    syncBtn.addEventListener("click", async function () {
+      var endBusy = beginBusy(syncBtn, "同期中…");
+      note.hidden = false;
+      note.textContent = "同期中…";
+      // 押す前の 「at」 を控える（上と同じ理由・壁時計を使わない）
+      var before = probeLatestRow(capId, ref);
+      var key = probeWaitKey(capId, ref);
+      try {
+        var res = await callIntake("probe", { type: type, ref: ref, sync: true });
+        var j = await res.json().catch(function () { return {}; });
+        if (!res.ok || j.queued === false) {
+          probeDeclined(note, key, j);
+          endBusy();
+          return;
+        }
+        probeEnterWait(note, key, capId, ref, before, j);
+      } catch (e) {
+        note.textContent = "通信に失敗しました。";
+        delete PROBE_WAITS[key];
+      }
+      endBusy();
+    });
+
+    row.appendChild(checkBtn);
+    row.appendChild(syncBtn);
     row.appendChild(note);
     return row;
   }
@@ -11034,7 +11392,7 @@ ${calendarAddUrl.toString()}
    * 一覧に出ている接続先の「届くか」をひとつの文字列にする（描き直しの要否の判定用）。
    *
    * **待ちの相も混ぜる（#523 S3）。** 混ぜないと、15分の上限に達しても一覧が
-   * 作り直されず、「確認を開始しました」が出たまま止まる（待てば出ると言い続ける形）。
+   * 作り直されず、「同期を開始しました」が出たまま止まる（待てば出ると言い続ける形）。
    */
   function reachSigOf(capId, refs) {
     var now = Date.now();
@@ -12272,7 +12630,7 @@ ${calendarAddUrl.toString()}
       // 起動できなかった案件（権限・スタブ未配布）ではリンクを出さない——押しても何も無い
       if (j.runsUrl) {
         msg.appendChild(document.createTextNode(" "));
-        msg.appendChild(el("a", { href: j.runsUrl, target: "_blank", rel: "noopener", text: "実行状況を見る →" }));
+        msg.appendChild(el("a", { href: j.runUrl || j.runsUrl, target: "_blank", rel: "noopener", title: RUN_LINK_TITLE, text: "実行状況を見る →" })); // その run を特定できていればそれ（#560）、無ければ一覧
       }
       // **「反映の状況 →」のリンクは無くなった（#221・2026-08-25）。** 指していたのは
       // 「画面を追いつかせるための fleet-status の実行」で、その起動ごと撤去した
@@ -12822,6 +13180,8 @@ ${calendarAddUrl.toString()}
     var gateAtEl = s.gateAt
       ? el("span", { class: "ds-gate-at", text: rtAgo(s.gateAt) + "に確認" })
       : null;
+    // その行を書いた run へ（#560）。overlay が写した 「gateRunUrl」 / 「gateBy」 から決める
+    var gateTrail = s.gateAt ? runTrailNodes({ runUrl: s.gateRunUrl || "", by: s.gateBy || "" }, undefined, "gate") : [];
     var card = el("div", { class: "ds-card" }, [
       el("div", { class: "ds-card-main" }, [
         el("span", { class: "ds-icon", text: meta.icon }),
@@ -12844,6 +13204,7 @@ ${calendarAddUrl.toString()}
       card.appendChild(el("code", { class: "ds-probe-scope", text: String(s.needed) }));
     }
     if (gateAtEl) card.appendChild(gateAtEl);
+    gateTrail.forEach(function (n) { card.appendChild(n); });
     // チャンネルの登録解除。書き込み経路（intake Lambda）がある案件でだけ出す。
     // **Slack だけ。** github は登録ファイルが別（dev-sources.json）で、下のトグルと
     // 「登録から削除」が担う。
@@ -12921,7 +13282,9 @@ ${calendarAddUrl.toString()}
       var restingParts = restingHelpPartsOf(s.type, s.gate);
       if (restingParts) card.appendChild(restingHelpNode(restingParts, "ds-gate-help ds-gate-resting"));
       else {
-        var reason = stateReasonOf(s);
+        // **能力に畳んでから渡す（#548）。** ここへ来るのは Slack / GitHub / Google Chat の
+        // 行だけなので、ボタンが書いた detail（判定語）は従来どおり出さない
+        var reason = stateReasonOf({ needed: s.needed, detail: s.detail, gateBy: s.gateBy, cap: gateCapOfType(s.type) });
         if (reason) card.appendChild(neededNode(reason, "ds-gate-help ds-gate-reason"));
       }
     }
@@ -12935,9 +13298,9 @@ ${calendarAddUrl.toString()}
     // 判定と文面は infra/lambda/shared/github-gate.mjs 側（画面に分岐を持たせない）。
     // **Google Chat は #347（同じ理由）。** スペースにアプリを追加した人が、その場で
     // 直ったことを確かめられる。判定は infra/lambda/shared/google-chat-gate.mjs 側。
-    // **Backlog / Figma / Drive は「接続を確認」の型が違う**（#523 S3・レジストリの
-    // 「probe: dispatch」）。中央が叩くのではなく案件の同期を起こすので、ここではなく
-    // それぞれの一覧の行が 「appendDispatchProbe」 で出す。
+    // **Backlog / Figma / Drive は「接続を確認」の型が違う**（#523 S3・#548・レジストリの
+    // 「probe: direct」）。中央が案件の鍵で叩いて即答し、「今すぐ同期」も並ぶので、
+    // ここではなくそれぞれの一覧の行が 「appendDispatchProbe」 で出す。
     //
     // **origin === "explicit" でも出す。** 確認は読むだけで、どの登録ファイル由来かに
     // 関係なく効く（書き込みになる「表示名を更新する」だけが由来で出し分かれる）
@@ -13870,7 +14233,7 @@ ${calendarAddUrl.toString()}
         // 起動できたときだけ、実行状況への導線を出す（鍵を入れた直後に効いたか確かめられる）
         if (j.runsUrl) {
           msg.appendChild(document.createTextNode(" "));
-          msg.appendChild(el("a", { href: j.runsUrl, target: "_blank", rel: "noopener", text: "実行状況を見る →" }));
+          msg.appendChild(el("a", { href: j.runUrl || j.runsUrl, target: "_blank", rel: "noopener", title: RUN_LINK_TITLE, text: "実行状況を見る →" })); // その run を特定できていればそれ（#560）、無ければ一覧
         }
         // 入れた値は画面に残さない（肩越しに見えるのを防ぐ）
         input.value = "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takagaki/cortex-decisions-viewer",
-  "version": "0.12.54",
+  "version": "0.12.56",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,