@takagaki/cortex-decisions-viewer 0.4.57 → 0.4.59

package/dist/build.js

@@ -157,8 +157,16 @@ async function readFleetSources(repoRoot) {
             label: String(s.label ?? ""),
             url: s.url != null ? String(s.url) : undefined,
             lastSync: s.lastSync != null ? String(s.lastSync) : undefined,
-            matchKeys: Array.isArray(s.matchKeys)
-                ? s.matchKeys.map((k) => String(k)).filter(Boolean)
+            // 会議名に入れる合図。**古い fleet-status.json の matchKeys は引き継がない**
+            // （client名と廃止した meetingNamePatterns の寄せ集めで、いま照合には使われていない。
+            // 出すと「この語を会議名に入れれば拾われる」と読めてしまう）。
+            meetingKey: s.meetingKey != null ? String(s.meetingKey) : undefined,
+            // 既存の定例を、いまの名前のまま拾うために登録した別名。設定ファイルにしか
+            // 無いと「なぜこの会議だけ入るのか」が画面から分からない
+            // **String() を先に噛ませない。** `String(null)` は "null" という文字列になり
+            // `.filter(Boolean)` を通り抜ける（画面に「null」という会議名が出る）
+            meetingAliases: Array.isArray(s.meetingAliases)
+                ? s.meetingAliases.filter((a) => typeof a === "string" && a !== "")
                 : undefined,
             driveSync: typeof s.driveSync === "boolean" ? s.driveSync : undefined,
             enabled: typeof s.enabled === "boolean" ? s.enabled : undefined,

package/dist/render.js

@@ -742,6 +742,9 @@ a:hover { text-decoration: underline; }
 .datasources-head { font-size: 18px; font-weight: 700; color: var(--text); margin: 0 0 4px; }
 .datasources-intro { color: var(--muted); font-size: 13.5px; line-height: 1.8; margin: 0 0 6px; }
 .datasources-asof { color: var(--muted); font-size: 12.5px; line-height: 1.7; margin: 0 0 14px; }
+/* 最新を取得できなかったとき。古い値を現在値と読ませないよう、通常の注記より目立たせる */
+.datasources-asof.is-stale { color: var(--warn, #a15c00); }
+.conn-map-asof { color: var(--muted); font-size: 12px; margin: 6px 0 0; text-align: right; }
 .ds-sub { font-size: 13px; font-weight: 700; color: var(--muted); margin: 20px 0 8px; }
 .ds-list { display: flex; flex-direction: column; gap: 10px; }
 .ds-card {
@@ -795,6 +798,12 @@ a.ds-name:hover { text-decoration: underline; }
 .cm-sync { font-size: 10.5px; fill: var(--muted); font-variant-numeric: tabular-nums; }
 .cm-node.cm-off .cm-sync { fill: #9ca3af; }
 .cm-badge { font-size: 13px; }
+/* 「入ってこない」ときに自分で確かめる口。一覧の直前に置く */
+.ds-syncnow { display: flex; align-items: center; gap: .5rem; flex-wrap: wrap; margin: 0 0 .6rem; }
+.ds-syncnow-label { font-size: .82rem; color: var(--muted); }
+/* 自分で繋げばよいことを、手順より先に伝える。埋もれると管理者に依頼しに行ってしまう */
+.sec-preferred { margin: .4rem 0 .2rem; padding: .5rem .7rem; font-size: .84rem; line-height: 1.6;
+  border-left: 3px solid var(--accent); background: var(--accent-weak); border-radius: 0 6px 6px 0; }
 /* 追加した直後にその場で見せる行。正式な一覧（スナップショット由来）に載るまでの繋ぎ */
 .ds-pending { margin-top: .5rem; display: flex; flex-direction: column; gap: .25rem; }
 .ds-pending-item { display: flex; align-items: center; gap: .5rem; font-size: .85rem;
@@ -819,6 +828,11 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-badges { display: flex; align-items: center; flex-wrap: wrap; gap: 6px; flex: 0 0 auto; }
 .badge.ds-gold { background: #fef3c7; color: #92400e; border: 1px solid #fcd34d; }
 .badge.ds-excluded { background: #eceef1; color: #6b7280; }
+/* 保存は済んでいるが、接続状況の再計算（1〜2分）がまだのもの。**確定と同じ見た目にしない**
+   ——リロードで消えたときに「戻された」と読まれるため、点線で区別して （反映中） を添える。
+   **幅と色まで指定する。** border-style だけだと、border を持たない .ds-excluded 側は
+   初期値の medium(≈3px)/currentColor に解決され、押した向きによって太さ3倍・色が別物になる */
+.badge.is-pending { border: 1px dashed currentColor; opacity: 0.85; }
 .badge.ds-undeclared { background: #fff4e5; color: #9a6700; }
 .ds-toggle { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin-top: 6px; }
 .ds-toggle-btn { font-size: 12px; padding: 3px 10px; border-radius: 999px; border: 1px solid var(--border); background: #fff; color: var(--text); cursor: pointer; }
@@ -1462,15 +1476,85 @@ const CLIENT_JS = `
     if (url) return el("a", { class: "ds-name", href: url, target: "_blank", rel: "noopener", text: text });
     return el("span", { class: "ds-name", text: text });
   }
-  function renderDataSources() {
-    var internals = SITE.internalSources || [];
-    var sources = SITE.externalSources || [];
-    var pipes = SITE.pipelines || [];
+  /**
+   * 「いま同期する」。中央の取り込み（Apps Script）を即時に起こす。
+   *
+   * **押しても即座に画面は変わらない。** 取り込み → コミット → 接続状況の再生成 →
+   * ビューアの再ビルド、と数分かかる。それを言わずにボタンだけ置くと、
+   * 「押したのに何も起きない」と読まれる（設定の追加でまさにそうなった）。
+   */
+  function syncNowRow() {
+    var row = el("div", { class: "ds-syncnow" });
+    if (!SITE.intake) return row;
+    var msg = el("span", { class: "ds-toggle-msg" });
+    var mk = function (kind, label) {
+      var btn = el("button", { class: "ds-toggle-btn", type: "button", text: label });
+      btn.addEventListener("click", async function () {
+        btn.disabled = true;
+        msg.className = "ds-toggle-msg";
+        msg.textContent = "実行中…";
+        var intake = SITE.intake;
+        var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
+        try {
+          var res = await fetch(pfx + "op=sync&t=" + encodeURIComponent(intake.token), {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ kind: kind }),
+          });
+          var j = await res.json().catch(function () { return {}; });
+          // **起こせなかったときも「失敗」と言わない。** 定期実行が拾うので、
+          // 押した人にできることは無い。何が起きるかだけを伝える
+          msg.className = "ds-toggle-msg" + (res.ok && j.started ? " is-ok" : "");
+          msg.textContent = (res.ok && j.started ? "✓ " : "") + (j.message || "開始できませんでした。");
+        } catch (e) {
+          msg.className = "ds-toggle-msg";
+          msg.textContent = "通信に失敗しました。定期実行（30分ごと）で取り込まれます。";
+        }
+        btn.disabled = false;
+      });
+      return btn;
+    };
+    row.appendChild(el("span", { class: "ds-syncnow-label", text: "いま同期する:" }));
+    row.appendChild(mk("materials", "資料"));
+    row.appendChild(mk("transcripts", "文字起こし"));
+    row.appendChild(msg);
+    return row;
+  }
+
+  /**
+   * 接続状況のライブ値（op=state の応答）。取得前・取得失敗時は null。
+   *
+   * **静的ビルド（SITE）は捨てない。** ビルド時に焼かれた値で先に描き切り、取れたら差し替える。
+   * こうすると (1) いま即座に出ている操作タブに読み込み待ちが入らない (2) 失敗しても
+   * 既に描き終わっているので空表示にならない。詳細表示の本文（loadBody）と同じ考え方。
+   */
+  var LIVE_FLEET = null;
+  var LIVE_FLEET_FAILED = false;
+  /**
+   * 接続状況の値を引く。ライブがあればライブ、無ければ静的ビルドの値。
+   * SITE 側はキー名が fleetGeneratedAt だけ異なる（他は fleet-status.json と同名）。
+   */
+  function fleetVal(key) {
+    // **ライブが取れたら、そちらだけを見る（キー単位で静的へ落ちない）。**
+    // キーごとにフォールバックすると、たとえば externalSources はライブ・secretSources は
+    // 前日のビルド、という**2つの時点が混ざった画面**になる。上に出す「◯◯時点」は1つしか
+    // 無いので、その注記が嘘になる——「変えたはずなのに違う値が出ている」という、
+    // この節がまさに警告している誤読を作ることになる。
+    // 欠けているキーは「無い」として扱い、既存の空配列ガードに任せる。
+    if (LIVE_FLEET) return LIVE_FLEET[key];
+    return SITE[key === "generatedAt" ? "fleetGeneratedAt" : key];
+  }
+
+  /** 組み立てだけを行う（設置は呼び出し側）。ライブ差し替えで同じ節を作り直すため分けている */
+  function buildDataSources() {
+    var internals = fleetVal("internalSources") || [];
+    var sources = fleetVal("externalSources") || [];
+    var pipes = fleetVal("pipelines") || [];
     // 能力→ツールの宣言（例: チャット: "none"）。"none" の能力は「未使用」のグレー行で存在だけ見せる
-    var tools = SITE.tools || {};
+    var tools = fleetVal("tools") || {};
     var chatOff = tools["チャット"] === "none";
     var devOff = tools["開発"] === "none";
-    if (!internals.length && !sources.length && !pipes.length && !chatOff && !devOff) return; // すべて無ければセクションごと出さない
+    if (!internals.length && !sources.length && !pipes.length && !chatOff && !devOff) return null; // すべて無ければセクションごと出さない
 
     var sec = el("section", { class: "datasources" });
     sec.appendChild(el("h2", { class: "datasources-head", text: "データソースと自動化" }));
@@ -1478,14 +1562,33 @@ const CLIENT_JS = `
     // **いつ時点の情報かを必ず出す。** この節は夜間バッチが作るスナップショットを読んでいるので、
     // 設定を変えても次の生成までは古い値のまま。時刻が無いと「変えたのに反映されない」ではなく
     // 「変えたはずなのに違う値が出ている」と読まれてしまう（実際に設定変更直後にそうなった）。
-    var asOf = SITE.fleetGeneratedAt ? dsFmtTime(SITE.fleetGeneratedAt) : "";
+    //
+    // **取得できたかで文言を変える。** 静的ビルドの値をそのまま「現在値」として見せると、
+    // まさにここが警告している誤読を自分で起こす。取りに行って失敗したことは隠さない。
+    var asOf = fleetVal("generatedAt") ? dsFmtTime(fleetVal("generatedAt")) : "";
     if (asOf) {
-      sec.appendChild(el("p", { class: "datasources-asof",
-        text: "接続状況は " + asOf + " 時点の自動チェック結果です。設定を変えた場合、ここに反映されるのは次回の実行後になります。" }));
+      var asOfText = LIVE_FLEET_FAILED
+        ? "最新の接続状況を取得できませんでした。表示しているのは " + asOf + " 時点の情報です。"
+        : "接続状況は " + asOf + " 時点の自動チェック結果です。設定を変えた場合、ここに反映されるのは次回の実行後になります。";
+      sec.appendChild(el("p", {
+        class: "datasources-asof" + (LIVE_FLEET_FAILED ? " is-stale" : ""),
+        text: asOfText,
+      }));
     }
 
     if (internals.length) {
       sec.appendChild(el("div", { class: "ds-sub", text: "リポジトリ内の情報源（自動同期）" }));
+      // **「いま同期する」ボタンは出さない。** 受け口（Apps Script の Webアプリ）を
+      // 公開できないため、押しても届かない。
+      //
+      // Workspace のポリシーで**匿名アクセス可能なWebアプリを公開できない**
+      // （デプロイ設定の「アクセスできるユーザー」に「全員」が出ず、「Classmethod.jp 内の全員」まで）。
+      // Lambda は Google アカウントを持たないのでドメイン制限を通れない。
+      //
+      // 代わりに**待ち時間そのものを縮めた**（トリガー30分→15分・設定キャッシュ30分→5分で
+      // 最悪60分→20分）。押す口が要るなら、bot の資格情報で Lambda が認証する経路を
+      // 用意してからここを戻す（syncNowRow と Lambda の op=sync は残してある）。
+      // sec.appendChild(syncNowRow());
       var ilist = el("div", { class: "ds-list" });
       internals.forEach(function (s) {
         // ラベルの下に補足行（会議の照合キー・Drive未設定の注記）を重ねられるよう縦組みにする
@@ -1495,30 +1598,36 @@ const CLIENT_JS = `
         // （Router.gs:「フィルタは持たない…招待が同意のゲート」）。enabled はルーティングの
         // 可否であって取り込みの可否ではないので、OFFにすると**Botは録り続けるのに
         // 文字起こしがINBOXに溜まる**という、招待しないより悪い状態を作れてしまう。
-        // **案件キーを先頭に足す。** 照合は「案件キー → 顧客名 → meetingNamePatterns」の
-        // 3段で行われるが、fleet-status が持つのは後ろ2つだけ。第1段は艦隊レジストリの
-        // キーで、投入設定から取れる。運用規約「会議名に案件キーを含める」の本体なので、
-        // これが抜けていると一番使われている目印が画面に出ない。
-        var keys = [];
+        // **合図（会議名に入れる目印）を出す。** 照合は「会議名に [合図] / 【合図】 が
+        // 入っているか」だけ（Router.gs）。合図は案件リポの meetingKey、未宣言なら艦隊
+        // レジストリのキーで、後者は案件リポも fleet-status も知らない——投入設定からしか取れない。
+        //
+        // **括弧を付けた形で出す。** 語だけ見せると 【KC定例】 のように混ぜて書かれ、
+        // どこも一致せず未仕分けへ落ちる（実際に起きた）。そのままコピーできる形にする。
+        var signal = null;
         // **自動取り込みが動いているときだけ出す。** Teams等で手動運用している案件に
         // 会議名の条件を出すと、自動で拾われると誤解させる（実際には拾われない）。
         if (s.kind === "会議" && s.ingestState === "on") {
-          // 案件キーは艦隊レジストリのもので、案件リポ自身は知らない（fleet-status にも無い）。
-          // ビルド時に注入される投入設定からしか取れないため、設定UIが未配線の案件では出ない。
-          if (SITE.intake && SITE.intake.projectKey) keys.push(SITE.intake.projectKey);
-          (s.matchKeys || []).forEach(function (k) {
-            // 照合は大小文字を区別しないので、違いだけの重複は出さない（「cortex / Cortex」は雑音）
-            var dup = keys.some(function (x) { return x.toLowerCase() === String(k).toLowerCase(); });
-            if (!dup) keys.push(k);
-          });
+          signal = s.meetingKey || (SITE.intake && SITE.intake.projectKey) || null;
+        }
+        var aliases = (s.kind === "会議" && s.ingestState === "on" && s.meetingAliases) || [];
+        if (signal) {
+          col.appendChild(el("span", {
+            class: "ds-keys",
+            text: "会議名に入れる目印: 【" + signal + "】 または [" + signal + "]",
+            title: "会議名のどこかにこの括弧付きの目印が入っていると、この案件に振り分けられます（大小文字は問いません）。括弧の中に他の文字を混ぜると一致しません。",
+          }));
         }
-        if (keys.length) {
-          var shown = keys.slice(0, 6).join(" / ");
-          if (keys.length > 6) shown += " 他" + (keys.length - 6) + "件";
+        if (aliases.length) {
+          // **目印が無くても入る会議。** 既に走っていて改名を頼みにくい定例を、
+          // いまの名前のまま登録したもの。出さないと「なぜこれだけ入るのか」
+          // 「新しい定例をどこに足すのか」が画面から分からない
+          var shown = aliases.slice(0, 5).join(" / ");
+          if (aliases.length > 5) shown += " 他" + (aliases.length - 5) + "件";
           col.appendChild(el("span", {
             class: "ds-keys",
-            text: "取り込み対象の会議名: " + shown,
-            title: "会議名にこれらの語が含まれていると、この案件に振り分けられます",
+            text: "目印なしで取り込む会議: " + shown,
+            title: "この名前の会議は、目印が無くてもこの案件に振り分けられます（大小文字・前後の空白は問いません。ファイル名に使えない記号（コロン・スラッシュ等）は同じものとして扱います）。既に走っている定例を改名せずに取り込むための登録です。",
           }));
         }
         if (s.driveSync === false) {
@@ -1651,7 +1760,11 @@ const CLIENT_JS = `
       sec.appendChild(plist);
     }
 
-    app.appendChild(sec);
+    return sec;
+  }
+  function renderDataSources() {
+    var sec = buildDataSources();
+    if (sec) app.appendChild(sec);
   }
   // 未使用能力のプレースホルダ行（アダプターとして存在するが、この案件では設定されていないもの）
   function inactiveSourceRow(icon, typeLabel, anchorId) {
@@ -1679,8 +1792,14 @@ const CLIENT_JS = `
     // **共通部品（stateToggle）に載せる。** 以前はここだけ変更者名をダイアログで聞いており、
     // 同じカードの中で2つの流儀が並んでいた。送信・エラー表示・向きの反転も個別実装で、
     // 片方だけ直したときにずれる状態だった。
+    // **控えはボタンにも効かせる。** バッジだけに効かせると、リロード後に同じカードの中で
+    // バッジが「対象です」・ボタンが「始めますか？」と逆を主張する。しかもその状態で
+    // ボタンの表示どおりに押すと、サーバは既に同じ値なので changed:false を返し、
+    // ボタンが永久に反転しない——**15分（TTL切れ）まで止められなくなる**。
+    // stateToggle の doc が要件として書いている「戻す操作を必ず残す」を破る。
+    var pendingNow = pendingGoldFor(s);
     return stateToggle({
-      on: s.gold === true,
+      on: pendingNow ? pendingNow.value : s.gold === true,
       labelOn: "Gold昇格を止める",
       labelOff: "Gold昇格を始める",
       confirmOn: [
@@ -1696,6 +1815,23 @@ const CLIENT_JS = `
       build: function (next) {
         return { op: "set-channel-gold", ref: s.ref, value: next };
       },
+      // 保存できた直後に、この行のバッジだけを「反映中」に差し替える。
+      // 一覧そのものは触らない（結果メッセージや他行の状態を巻き込まないため）。
+      pending: function (next, toggleEl) {
+        // **表示済みの値に戻したなら「反映中」ではない。** ON→OFF と押し直した場合、
+        // 画面が出している値と一致するので待つものが無い。ここで消さないと、
+        // 何も保留していないのに (反映中) が残り、リロードで消えて不可解に見える。
+        var back = next === (s.gold === true);
+        if (back) clearPendingGold(s.ref);
+        else markPendingGold(s.ref, next);
+        var card = toggleEl && toggleEl.parentNode;
+        var badges = card && card.querySelector(".ds-badges");
+        if (!badges) return;
+        var b = badges.querySelector(".badge.ds-gold, .badge.ds-excluded, .badge.ds-undeclared");
+        var spec = pendingBadgeSpec(next, back);
+        if (b) { b.className = spec.cls; b.textContent = spec.text; }
+        else badges.insertBefore(el("span", { class: spec.cls, text: spec.text }), badges.firstChild);
+      },
     });
   }
 
@@ -1715,7 +1851,7 @@ const CLIENT_JS = `
     // 「足したい案件でだけ足せない」という逆転になっていた。
     // 押しても必ず失敗するもの（別ツールが宣言済み）は usable() で弾く。
     if (!SITE.intake) return null;
-    var tools = SITE.tools || {};
+    var tools = fleetVal("tools") || {};
     var usable = function (cap, tool) { var v = tools[cap]; return !v || v === "none" || v === tool; };
     var box = el("div", {});
     var used = false;
@@ -1920,7 +2056,7 @@ const CLIENT_JS = `
   function renderExternalAdders() {
     var box = el("div", {});
     if (!SITE.intake) return box;
-    var tools = SITE.tools || {};
+    var tools = fleetVal("tools") || {};
     var usable = function (cap, tool) { var v = tools[cap]; return !v || v === "none" || v === tool; };
 
     // **Slack は tools 宣言で隠さない。** tools.チャット は能力ごとに1値しか持てないので、
@@ -1990,9 +2126,14 @@ const CLIENT_JS = `
   // 片方だけ直したときにずれる（既存の goldToggle で使っている作法をそのまま一般化したもの）。
 
   /**
-   * サーバへ設定変更を送る。**成功しても一覧やバッジは書き換えない**
+   * サーバへ設定変更を送る。**一覧は書き換えない**
    * （接続状況は夜間バッチのスナップショットなので、「もう効いている」と誤解させないため）。
-   * 呼び出し側は onDone で自分のボタンの向きだけを反転させる。
+   * 呼び出し側は onDone で自分のボタンの向きを反転させる。
+   *
+   * **例外はバッジの先出し。** opts.pending を持つ操作（いまは Gold の切り替えだけ）は、
+   * 押した内容を「（反映中）」として先に出す。出してよいのは (1) 保存の成否がサーバで
+   * 確定していて推測が入らない (2) **確定した表示と見た目で区別できる**、の両方を満たす
+   * ときだけ。区別しないと、リロードで消えたときに「戻された」と読まれる。
    */
   async function sendConfig(payload, msg, btn, onDone) {
     var intake = SITE.intake;
@@ -2059,7 +2200,9 @@ const CLIENT_JS = `
 
   /**
    * ON/OFF のトグル。**戻す操作を必ず残す**（誤って有効にしたとき翌朝まで止められないのは許容できない）。
-   * @param opts { on, labelOn, labelOff, confirmOn, build(next) }
+   * @param opts { on, labelOn, labelOff, confirmOn, build(next), pending(next, wrapEl) }
+   *   pending … 保存できた直後に、その行のバッジだけを「（反映中）」へ差し替える任意のフック。
+   *   持たない操作は従来どおりボタンの向きだけを反転する（バッジは触らない）。
    */
   function stateToggle(opts) {
     var wrap = el("div", { class: "ds-toggle" });
@@ -2077,9 +2220,12 @@ const CLIENT_JS = `
       // 読み始める方向（危険）だけ確認する。止める方向は素通し
       if (next && opts.confirmOn && !confirmDanger(opts.confirmOn)) { msg.textContent = ""; return; }
       sendConfig(opts.build(next), msg, btn, function () {
-        // **押した内容をボタンに反映し、逆向きの操作を残す。** バッジや一覧は触らない
+        // **押した内容をボタンに反映し、逆向きの操作を残す。**
         on = next;
         paint();
+        // バッジは「反映中」として先出しする（opts.pending がある操作だけ）。
+        // **カードごと作り直さない。** 上の msg に出した結果表示が消えてしまう
+        if (opts.pending) opts.pending(next, wrap);
       });
     });
     wrap.appendChild(btn);
@@ -2173,11 +2319,125 @@ const CLIENT_JS = `
     return box;
   }
 
+  /* ---------------------------------------------------------------------------
+   * Gold切り替えの「反映中」表示。
+   *
+   * 押しても一覧のバッジが変わるのは fleet-status.yml が完走したあと（1〜2分）。
+   * その間バッジが古いままだと「押したのに何も起きない」に見える。
+   *
+   * **推測ではない。** Lambda は書き込む前に Bot の在籍を確認し、ダメなら 400 を返すので、
+   * 200 が返った時点で channels.json は確実に書き換わっている。ここで出すのは
+   * 「確定した事実の先出し」であって楽観的な当て推量ではない。
+   *
+   * **確定したバッジと同じ見た目にはしない。** 30秒後にリロードした人には、付けたはずの
+   * ラベルが消えて見える——「変えたはずなのに違う値が出ている」という、この画面が
+   * 繰り返し警告してきた誤読そのものになる。だから (反映中) を付けて区別し、
+   * さらに sessionStorage に持たせてリロードしても残す。
+   *
+   * 消えるのは「fleet-status が追いついたとき」か「TTL 切れ」。TTL が無いと、
+   * ワークフローが落ちている案件で永久に「反映中」が残り、嘘の表示になる。
+   * ------------------------------------------------------------------------- */
+  // **キーは案件別にする。** Slackの共有チャンネルは複数案件のCortexに同時に載りうるので、
+  // 案件をまたぐキーにすると、案件Aで押した「反映中」が案件Bの同じ行に出る
+  // （チュートリアルの既読キーが同じ理由で案件別になっている）。
+  var PENDING_KEY = "cortex.pendingGold:" + ((SITE.intake && SITE.intake.projectKey) || "");
+  var PENDING_TTL_MS = 15 * 60 * 1000;
+  /**
+   * 保存する形: { "<チャンネルID>": { value: boolean, at: number } }
+   * at が無い/0 のエントリは期限切れとして落とす。
+   * **型では守れない**（このコードは render.ts のテンプレートリテラル内で、tsc が見ない）。
+   * 守るのはテストの仕事。
+   */
+
+  /**
+   * 先出しバッジの見た目。**1箇所に集約する**——文言とクラスを2箇所に書くと片方だけ直る。
+   *
+   * **「反映中」とは書かない。** この画面の既存語彙では「反映」が2つの意味で使われていて、
+   * 短いほう（数分）には必ず「一覧への」が付いている（サーバ文言「次回の Gold 昇格
+   * （毎晩22時ごろ）から反映されます。一覧への反映には数分かかります」）。修飾なしの
+   * 「反映中」だと、22時の蒸留の話と読めてしまう。
+   *
+   * とくに OFF 方向で害が大きい。**止めた時点で蒸留に対しては完全に効いている**
+   * （Slack はミラーせず Gold 昇格が直接読むため）。待っているのは画面だけなので、
+   * 「除外（反映中）」は「まだ除外されていない」と逆に読める。
+   */
+  function pendingBadgeSpec(value, settled) {
+    return {
+      cls: "badge " + (value ? "ds-gold" : "ds-excluded") + (settled ? "" : " is-pending"),
+      text: (value ? "Gold昇格の読み取り対象" : "除外") + (settled ? "" : "（画面反映待ち）"),
+    };
+  }
+
+  function readPending() {
+    try {
+      var raw = sessionStorage.getItem(PENDING_KEY);
+      if (!raw) return {};
+      var obj = JSON.parse(raw);
+      if (!obj || typeof obj !== "object") return {};
+      var now = Date.now();
+      var out = {};
+      for (var k in obj) {
+        if (!Object.prototype.hasOwnProperty.call(obj, k)) continue;
+        var e = obj[k];
+        if (e && typeof e === "object" && now - (e.at || 0) < PENDING_TTL_MS) out[k] = e;
+      }
+      return out;
+    } catch (_) {
+      // sessionStorage が使えない環境（プライベートモード等）でも画面は出す
+      return {};
+    }
+  }
+  function writePending(map) {
+    try { sessionStorage.setItem(PENDING_KEY, JSON.stringify(map)); } catch (_) {}
+  }
+  function clearPendingGold(ref) {
+    if (!ref) return;
+    var map = readPending();
+    if (!(ref in map)) return;
+    delete map[ref];
+    writePending(map);
+  }
+  /** 押した内容を控える。fleet-status が追いつくまでの間だけ効く */
+  function markPendingGold(ref, value) {
+    if (!ref) return;
+    var map = readPending();
+    map[ref] = { value: value === true, at: Date.now() };
+    writePending(map);
+  }
+  /**
+   * その行の「反映中」を引く。**実データが追いついていたら控えを捨てる。**
+   * 捨てないと、正しくなった後も (反映中) が残り続ける。
+   */
+  function pendingGoldFor(s) {
+    if (!s || !s.ref) return null;
+    var map = readPending();
+    var e = map[s.ref];
+    if (!e) return null;
+    // **「値が一致したら捨てる」だけでは足りない。** 別の人が直後に逆を押して、
+    // その結果で追いついた場合、値が一致しないので控えが残り、TTL切れまで
+    // 実際とは違う値を出し続ける。**押した時点より新しいスナップショットが来たら、
+    // 値が何であれ控えは用済み**——サーバの答えのほうが新しいので、そちらを信じる。
+    var snapshot = fleetVal("generatedAt");
+    var snapAt = snapshot ? Date.parse(snapshot) : NaN;
+    var stale = !isNaN(snapAt) && snapAt >= (e.at || 0);
+    if (s.gold === e.value || stale) {
+      delete map[s.ref];
+      writePending(map);
+      return null;
+    }
+    return e;
+  }
+
   function extSourceCard(s, meta) {
     var badges = el("div", { class: "ds-badges" });
+    var pending = pendingGoldFor(s);
     // 「意図的に外した」と「宣言し忘れ」を分けて出す。同じ「除外」と書くと、
     // 判断されていないだけのものが「判断済み」に見えてしまう。
-    if (s.gold === true) badges.appendChild(el("span", { class: "badge ds-gold", text: "Gold昇格の読み取り対象" }));
+    if (pending) {
+      var spec = pendingBadgeSpec(pending.value, false);
+      badges.appendChild(el("span", { class: spec.cls, text: spec.text }));
+    }
+    else if (s.gold === true) badges.appendChild(el("span", { class: "badge ds-gold", text: "Gold昇格の読み取り対象" }));
     else if (s.goldState === "undeclared") badges.appendChild(el("span", { class: "badge ds-undeclared", text: "未宣言（対象外）" }));
     else if (s.gold === false) badges.appendChild(el("span", { class: "badge ds-excluded", text: "除外" }));
     if (s.notify === true) badges.appendChild(el("span", { class: "badge ds-notify", text: "通知先" }));
@@ -2241,9 +2501,166 @@ const CLIENT_JS = `
   }
 
   // ---------- 操作タブ（接続マップ・データソースと自動化・取り込み。今後この受け皿に機能を足す） ----------
+  /**
+   * 接続状況をライブで取りに行き、取れたら操作タブを描き直す。
+   *
+   * **静的ビルドで描き切った後に呼ぶ。** 待たせないため、そして失敗しても既に画面が
+   * 出ているため。1タブ表示につき1回だけで、ポーリングはしない（GitHubトークンは
+   * 組織で共有していて、枯渇すると同じ組織の全案件のビルド・同期が止まる）。
+   */
+  /**
+   * ライブ応答の最低限の正規化。
+   *
+   * **静的経路は build.ts が同じことをしている。** あちらは要素を許可リストで組み直し、
+   * 非オブジェクトを落として型を強制する。ライブ経路にはそれが無いので、生成側
+   * （別リポの cortex-engine）が壊れた1件を混ぜると、要素を読む段で TypeError になり
+   * **操作タブが丸ごと出なくなる**（データソースだけでなく、その後の取り込みフォームも
+   * 鍵の登録も消える）。fleet-passthrough.test.mjs が「壊れた1件でビルド全体が落ちると
+   * 案件のビューアが丸ごと出なくなる」と書いているのと同じ事故を、ライブ経路で起こさない。
+   *
+   * ここは build.ts の許可リストを写さない（2枚になると列挙し忘れが静かに消える）。
+   * **落とすのは「読めない形のもの」だけ**——配列の非オブジェクト要素と、
+   * 文字列前提の配列に混ざった非文字列。
+   */
+  /** 入力中・送信中の節か（フォーカスがある／入力に値がある／進行中の表示がある） */
+  function isBeingEdited(node) {
+    if (node.contains(document.activeElement) && document.activeElement !== document.body) return true;
+    var inputs = node.querySelectorAll("input, textarea");
+    for (var i = 0; i < inputs.length; i++) { if (inputs[i].value) return true; }
+    var msgs = node.querySelectorAll(".ds-toggle-msg");
+    for (var m = 0; m < msgs.length; m++) { if (msgs[m].textContent) return true; }
+    return false;
+  }
+
+  /** 文字列だけを並べる配列。非文字列が混ざると "null" や "[object Object]" が表示される */
+  var STRING_LIST_FIELDS = { meetingAliases: 1, driveFolderIds: 1 };
+
+  function normalizeFleet(fleet) {
+    if (!fleet || typeof fleet !== "object") return null;
+    var out = {};
+    for (var k in fleet) {
+      if (!Object.prototype.hasOwnProperty.call(fleet, k)) continue;
+      var v = fleet[k];
+      if (!Array.isArray(v)) { out[k] = v; continue; }
+      out[k] = v
+        .filter(function (item) { return item != null && typeof item === "object" && !Array.isArray(item); })
+        .map(function (item) {
+          var copy = {};
+          for (var f in item) {
+            if (!Object.prototype.hasOwnProperty.call(item, f)) continue;
+            var fv = item[f];
+            // 画面が文字列として並べる配列（会議の別名・DriveフォルダID）に非文字列が
+            // 混ざると "null" や "[object Object]" が表示される。build.ts:178 が
+            // 名指しで防いでいる罠なので、ライブ側でも同じ扱いにする
+            if (Array.isArray(fv)) {
+              copy[f] = STRING_LIST_FIELDS[f]
+                ? fv.filter(function (x) { return typeof x === "string" && x !== ""; })
+                : fv.filter(function (x) { return x != null; });
+            } else {
+              copy[f] = fv;
+            }
+          }
+          return copy;
+        });
+    }
+    return out;
+  }
+
+  /**
+   * ライブ値が届いたときの差し替え。**画面全体を描き直さない。**
+   *
+   * 当初は route() を呼んでいたが、これは renderList() → app.innerHTML = "" で
+   * 操作タブを丸ごと作り直す。操作タブは DOM に状態を持つ設計なので
+   * （貼りかけのトークン・「保存中…」・押した直後のボタンの向き）、
+   * **保存中に応答が届くと入力が消え、成功メッセージは切り離された古いノードに書かれて
+   * 画面に出ない**——保存は成功しているのに「押したのに何も起きなかった」と見える。
+   * 差し替えるのはデータソース節と接続マップの注記だけにする。
+   */
+  function refreshDataSources() {
+    if (listState.tab !== "ops") return;
+    var old = app.querySelector(".datasources");
+    // **触っている最中は差し替えない。** この節の中には追加フォームの入力欄があり、
+    // 貼りかけのURLや「保存中…」の表示ごと作り直してしまう。保存が成功していても
+    // 結果メッセージは切り離された古いノードに書かれ、画面には出ない——
+    // 「押したのに何も起きなかった」と見えて、もう一度貼って押す（＝二重保存）に誘導する。
+    // 見送っても値は LIVE_FLEET に入っているので、次に操作タブを描くときに反映される。
+    if (old && isBeingEdited(old)) return;
+    var next = buildDataSources();
+    if (old && next) old.parentNode.replaceChild(next, old);
+    else if (old) old.parentNode.removeChild(old);
+    else if (next) {
+      // 静的では空でライブで出るようになった場合。接続マップの直後に入れる
+      var map = app.querySelector(".conn-map");
+      if (map && map.nextSibling) app.insertBefore(next, map.nextSibling);
+      else app.insertBefore(next, app.firstChild);
+    }
+    updateConnMapAsOf();
+    updateSecretStates();
+  }
+
+  /**
+   * 鍵カードの「現在: ◯◯ から取得中」だけを更新する。
+   * **カードごと作り直さない**（貼りかけのトークンが消える）。表示は1行なので差し替えで足りる。
+   */
+  function updateSecretStates() {
+    var sources = fleetVal("secretSources") || {};
+    var cards = app.querySelectorAll("[data-secret-kind]");
+    for (var i = 0; i < cards.length; i++) {
+      var kind = cards[i].getAttribute("data-secret-kind");
+      var line = cards[i].querySelector(".sec-state");
+      if (!line) continue;
+      var src = sources[kind] || "";
+      line.className = src
+        ? "sec-state" + (src === "Secrets Manager" ? " is-managed" : "")
+        : "sec-state is-none";
+      line.textContent = src ? "現在: " + src + " から取得中" : "現在: 未設定";
+    }
+  }
+
+  /**
+   * 取得中フラグ。**完了しても寝かせたままにしない。**
+   * 一度 true のままだと、タブを移動して戻ってきても再取得せず、設定を変えた人が
+   * その場で反映を確かめる手段がフルリロードだけになる。取得が終わったら倒して、
+   * **操作タブに入り直したときだけ**もう一度取りに行く（ポーリングはしない）。
+   */
+  var liveFleetRequested = false;
+  function loadLiveFleet() {
+    if (liveFleetRequested) return;
+    var intake = SITE.intake;
+    if (!intake) return;
+    // **fetch の有無を確かめてから呼ぶ。** テスト環境（JSDOM）は window.fetch を持たない。
+    // 素で呼ぶと描画中の ReferenceError になり、「画面が例外を出さずに描き切る」検査を割る。
+    if (typeof fetch !== "function") return;
+    liveFleetRequested = true;
+    var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
+    fetch(pfx + "op=state&t=" + encodeURIComponent(intake.token), {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: "{}",
+    })
+      // **非2xxも失敗として扱う。** ビューアとLambdaの版は独立に進むので、
+      // op=state 未対応のLambdaは 400 を返す。通信エラーだけを見ていると空表示になる。
+      .then(function (res) { if (!res.ok) throw new Error("http " + res.status); return res.json(); })
+      .then(function (j) {
+        if (!j || !j.fleet) throw new Error("no fleet");
+        LIVE_FLEET = normalizeFleet(j.fleet);
+        LIVE_FLEET_FAILED = false;
+        liveFleetRequested = false;
+        refreshDataSources();
+      })
+      .catch(function () {
+        // 静的ビルドの値で描き続ける。ただし「古いかもしれない」ことは画面に出す
+        LIVE_FLEET = null;
+        LIVE_FLEET_FAILED = true;
+        liveFleetRequested = false;
+        refreshDataSources();
+      });
+  }
+
   function renderOps() {
     renderConnMap();
     renderDataSources();
+    loadLiveFleet();
     if (SITE.intake) {
       app.appendChild(el("p", { class: "ops-intro", text: "Cortex にコンテキストを取り込む操作です。ファイルを選ぶかテキストを貼って送信すると、自動で取り込まれます（数分で反映）。" }));
       app.appendChild(el("div", { class: "section-label", text: "取り込み" }));
@@ -2267,7 +2684,21 @@ const CLIENT_JS = `
       icon: "📋",
       title: "Backlog のAPIキー",
       desc: "課題・Wiki・ドキュメントを毎晩同期するために使います。",
-      how: "Backlog → 個人設定 → API で発行",
+      how: "Backlog → 個人設定 → API で発行（この案件のプロジェクトが見えるアカウントで）",
+      // **案件の担当者が自分で繋ぐ。** 以前は艦隊共通の読み取りアカウントを1つ運用していたが、
+      // 案件が増えるたびに「その1人がプロジェクトへ参加追加してキーを配る」ことになり、
+      // セットアップが一箇所に詰まる。**繋ぐのは、その案件を持っている人**にする。
+      //
+      // 代償は「その人が離れると同期が止まる」こと。ただしこれは**担当が変わったときに
+      // 次の人が入れ直せば済む**話で、誰か1人に依存し続けるより回復しやすい。
+      selfServe: {
+        text:
+          "この案件を担当しているあなたのアカウントで発行して、ここに貼ってください。" +
+          "管理者への依頼は要りません。",
+        note:
+          "担当が変わったら、新しい担当者が同じ手順で入れ直してください" +
+          "（前の担当者のアカウントが無効になると同期が止まります）。",
+      },
     },
     "external-sources": {
       icon: "🐙",
@@ -2299,7 +2730,7 @@ const CLIENT_JS = `
     // **いま何で動いているか**を先に出す。入れ直したのに反映されていない状態が
     // 画面で分かるようにする（接続状況は夜間バッチのスナップショットなので、
     // 保存の直後は前日の値のまま。時刻は上の節に出している）。
-    var src = (SITE.secretSources || {})[kind] || "";
+    var src = (fleetVal("secretSources") || {})[kind] || "";
     var state = src
       ? el("p", { class: "sec-state" + (src === "Secrets Manager" ? " is-managed" : ""),
                   text: "現在: " + src + " から取得中" })
@@ -2349,14 +2780,19 @@ const CLIENT_JS = `
       }
     });
 
-    return el("div", { class: "ops-card" }, [
+    // ライブ取得後に「現在: …」だけを差し替えるための目印（カードごと作り直すと入力が消える）
+    return el("div", { class: "ops-card", "data-secret-kind": kind }, [
       el("div", { class: "ops-card-head" }, [
         el("span", { class: "ops-card-icon", text: meta.icon }),
         el("h3", { class: "ops-card-title", text: meta.title }),
       ]),
       el("p", { class: "ops-card-desc", text: meta.desc }),
       state,
+      // **未設定のときだけ、先に試すべき手を出す。** 既に動いているカードに
+      // 「まずこれをやれ」と出すと、直す必要が無いものを触らせることになる
+      !src && meta.selfServe ? el("p", { class: "sec-preferred", text: meta.selfServe.text }) : null,
       el("p", { class: "sec-how", text: meta.how }),
+      meta.selfServe ? el("p", { class: "sec-how", text: meta.selfServe.note }) : null,
       input,
       el("div", { class: "ds-toggle" }, [btn, msg]),
     ]);
@@ -2381,6 +2817,26 @@ const CLIENT_JS = `
       if (target && target.scrollIntoView) target.scrollIntoView({ behavior: "smooth", block: "center" });
     });
     app.appendChild(wrap);
+    updateConnMapAsOf();
+  }
+
+  /**
+   * 接続マップに「いつ時点か」を付ける／外す。
+   *
+   * **この図はビルド時に焼かれている。** 下の一覧はライブに差し替わるので、ライブが
+   * 取れているときは図だけが古い。同じ画面で図が⚠️・直下が「接続OK」になる状態を
+   * 黙って出さないよう、図がいつ時点かを明示する（図の再描画は別途）。
+   * ライブが取れていないときは図と一覧が同じ時点なので、注記は出さない。
+   */
+  function updateConnMapAsOf() {
+    var wrap = app.querySelector(".conn-map");
+    if (!wrap) return;
+    var existing = wrap.querySelector(".conn-map-asof");
+    if (existing) existing.parentNode.removeChild(existing);
+    if (!LIVE_FLEET || !SITE.fleetGeneratedAt) return;
+    var mapAsOf = dsFmtTime(SITE.fleetGeneratedAt);
+    if (!mapAsOf) return;
+    wrap.appendChild(el("p", { class: "conn-map-asof", text: "この図は " + mapAsOf + " 時点です（下の一覧は最新）。" }));
   }
   function opsCard(icon, title, desc, kind, btnLabel) {
     var btn = el("button", { class: "ops-card-btn", text: "＋ " + btnLabel });

package/package.json

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