@takagaki/cortex-decisions-viewer 0.4.57 → 0.4.58

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;
@@ -1462,15 +1471,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 +1557,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 +1593,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 +1755,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) {
@@ -1715,7 +1823,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 +2028,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値しか持てないので、
@@ -2241,9 +2349,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 +2532,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 +2578,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 +2628,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 +2665,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.58",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,