@takagaki/cortex-decisions-viewer 0.12.55 → 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種類あると、
@@ -4490,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）。**判定と表示語の実体はビルド時の定義**——
@@ -4522,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 が
@@ -8998,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) {
@@ -10365,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つのことを言う——この節が何度も直してきた形そのもの。
@@ -10817,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）。**
    *
@@ -10839,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)));
   }
 
   /**
@@ -10884,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;
   }
 
@@ -11032,12 +11210,30 @@ ${calendarAddUrl.toString()}
       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) : "",
     };
-    note.textContent = (j && j.message) || "";
+    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」 と同じ見た目にする**——
    * 夜間のスナップショットの判定といま測った判定を**同じ行に並べない**ため
@@ -11074,6 +11270,8 @@ ${calendarAddUrl.toString()}
       row.insertBefore(at, anchor);
     }
     at.textContent = "いま測った結果（" + (dsFmtTime(j.checkedAt) || "たった今") + "）";
+    // 古い run の導線も外す（#560）。残すと「いま測った結果」の横に夜間の run のログが並ぶ
+    removeRunTrail(row);
     // **夜間の判定に添えてあった案内は隠す。** 置き換えた判定と食い違う案内が下に残ると、
     // 同じ行が2つのことを言う（probeSection の stale 処理と同じ）
     var stale = row.querySelectorAll(".ds-gate-help");
@@ -11111,8 +11309,13 @@ ${calendarAddUrl.toString()}
     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;
 
     checkBtn.addEventListener("click", async function () {
@@ -12427,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 の実行」で、その起動ごと撤去した
@@ -12977,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 }),
@@ -12999,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）で、下のトグルと
     // 「登録から削除」が担う。
@@ -14027,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.55",
+  "version": "0.12.56",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,