@takagaki/cortex-decisions-viewer 0.12.45 → 0.12.47

package/dist/build.js

@@ -538,7 +538,11 @@ async function readFleetSources(repoRoot) {
                 .filter((x) => TOOL_KINDS.indexOf(x.kind) >= 0 && TOOL_STATES.indexOf(x.state) >= 0);
             // **items が 0 件でも器は通す。** 「まだ 1 つも接続が無い」（接続の導線を出す）と
             // 「この項目を知らない古い生成物」（何も出さない）は別の状態
-            tools = { version: 1, items: items, paragraph: String(t.paragraph ?? "") };
+            //
+            // 🔴 **`paragraph` は受け渡さない（#501 で #275 の一部を取り消した）。** engine は
+            // 「この案件が使っているツール: …」の段落を載せ続けているが、AI の起動文には
+            // 付けないと決めたので、画面データにも運ばない（知らないキーとして落ちる）
+            tools = { version: 1, items: items };
         }
     }
     // 能力ごとの導出済みの状態（#125①が載せ、#125②で画面の正本になった）。

package/dist/render.js

@@ -409,15 +409,14 @@ function projectRepoSlug(repoBaseUrl) {
  * 「この案件を Claude Code Web で開く」URL。
  *
  * 🔴 **AI 導線はこの1本を呼ぶ（`claudeCodeUrl` の呼び出しを写さない）。** 呼び出し側で
- * 組み直すと、引数を1つ落とした側だけが**開発リポジトリを載せない／ツールの段落を
- * 付けない**——「同じ先」が静かに割れる。指示文・slug の導出・URL の組み立ての3つを、
+ * 組み直すと、引数を1つ落とした側だけが**開発リポジトリを載せない**——「同じ先」が
+ * 静かに割れる。指示文・slug の導出・URL の組み立ての3つを、
  * ここと ASK_PROMPT / projectRepoSlug に閉じておく。
  *
  * `?? []` は必須——build.ts は fleet-status.json が無い案件で externalSources を持たない。
- * 第4引数は使っているツールの段落（#275・全導線に同じ段落を付ける）。
  */
 function askAiUrl(site) {
-    return claudeCodeUrl(ASK_PROMPT, projectRepoSlug(site.repoBaseUrl), site.externalSources ?? [], site.tools && site.tools.paragraph);
+    return claudeCodeUrl(ASK_PROMPT, projectRepoSlug(site.repoBaseUrl), site.externalSources ?? []);
 }
 /**
  * owner/repo の形か（ポータル web/src/features/harness/harness-link.ts の REPOSITORY_SLUG と同じ形）。
@@ -496,18 +495,16 @@ function claudeCodeRepositories(projectRepo, devRefs) {
  * repositories はカンマ区切りで**素のまま**載せる（公式の例がその形で、スラッシュも
  * エンコードしない）。指示文だけ encodeURIComponent する。
  *
- * `toolsParagraph`（#275）は「この案件が使っているツール: …」の 1 段落。非空なら
- * **指示文の先頭に付ける**。7 導線すべてがこの 1 関数を通るので、ここに置くだけで
- * どのボタンから開いても AI が最初に案件の道具立てを知る——**呼び出し側で足さないこと**
- * （足すと、足し忘れたボタンだけ文脈の無い起動になる）。
- * `data-ai-prompt` には元の指示文を残す（貼り替えもこの関数を通るので段落は保たれる）。
+ * 🔴 **指示文には前置きを足さない（#501・#275 の取り消し）。** かつては
+ * 「この案件が使っているツール: …」の 1 段落をここで先頭に付けていたが、オーナー判断で
+ * やめた。`href` の指示文と貼り替えの目印（`data-ai-prompt`）は**同じ文字列**に保つ
+ * ——ここで足すと、貼り替えのたびに前置きが増えるかどうかを両側で気にすることになる。
  */
-function claudeCodeUrl(prompt, projectRepo, externals, toolsParagraph) {
+function claudeCodeUrl(prompt, projectRepo, externals) {
     var repos = claudeCodeRepositories(projectRepo, devRepositoryRefs(externals));
     if (!repos.length)
         return CLAUDE_CODE_HOME;
-    var text = toolsParagraph ? String(toolsParagraph) + "\n\n" + prompt : prompt;
-    return "https://claude.ai/code?repositories=" + repos.join(",") + "&prompt=" + encodeURIComponent(text);
+    return "https://claude.ai/code?repositories=" + repos.join(",") + "&prompt=" + encodeURIComponent(prompt);
 }
 // ---------------------------------------------------------------------------
 // Home の「使用ツール」（engine #275）— 一覧は engine が登録簿から算出した `SITE.tools`
@@ -3692,6 +3689,19 @@ a.ds-tile:hover { text-decoration: none; }
 .ds-toggle-msg { font-size: 12px; color: var(--muted); }
 .ds-toggle-msg.is-ok { color: #1a7f37; }
 .ds-toggle-msg.is-error { color: #b42318; }
+/* Backlog の同期経路のスイッチ（#516）。role=switch の button に、トラックとつまみを描く。
+   語（.ds-switch-label）は押している間も差し替えない（状態は下の 1 行が言う） */
+.ds-route { margin-top: 10px; }
+.ds-switch { display: inline-flex; align-items: center; gap: 8px; padding: 0; border: 0; background: none; font: inherit; font-size: 13px; color: var(--text); cursor: pointer; text-align: left; }
+.ds-switch:disabled { opacity: .55; cursor: default; }
+.ds-switch.is-busy { cursor: wait; opacity: .75; }
+.ds-switch-track { position: relative; flex: 0 0 auto; width: 34px; height: 20px; border-radius: 999px; background: #c9ced6; transition: background .15s; }
+.ds-switch[aria-checked="true"] .ds-switch-track { background: var(--accent); }
+.ds-switch-knob { position: absolute; top: 2px; left: 2px; width: 16px; height: 16px; border-radius: 50%; background: #fff; box-shadow: 0 1px 2px rgba(0,0,0,.25); transition: left .15s; }
+.ds-switch[aria-checked="true"] .ds-switch-knob { left: 16px; }
+.ds-switch:focus-visible .ds-switch-track { outline: 2px solid var(--accent); outline-offset: 2px; }
+.ds-switch-label { min-width: 0; white-space: normal; overflow-wrap: anywhere; }
+.ds-route-line { margin: 4px 0 0; }
 .badge.ds-notify { background: #eff6ff; color: #1e40af; border: 1px solid #bfdbfe; }
 /* 読み取りを止めてあるリポジトリ（2026-08-21）。**それまではトグルの向きが示していた**ので、
    トグルを撤去したいま、読み取られていないことを示すのはこのバッジだけ。
@@ -4706,10 +4716,8 @@ ${calendarAddUrl.toString()}
   // 🔴 **var MERGE_KEYS の宣言より上に codeUrl を呼ぶトップレベル文を足さないこと。**
   // fleetVal は MERGE_KEYS を読むが、var の初期化は宣言行に達するまで走らない
   // （関数宣言の巻き上げでは undefined を読む）。呼び出しは全て描画（route）以降に置く
-  // 第4引数は使っているツールの段落（#275）。**焼き込んだ SITE から取る**——この段落は
-  // engine が毎朝 fleet-status.json に載せるもので、ライブ（op=state）は運んでこない
   function codeUrl(prompt) {
-    return claudeCodeUrl(prompt, REPO_SLUG, fleetVal("externalSources") || [], SITE.tools && SITE.tools.paragraph);
+    return claudeCodeUrl(prompt, REPO_SLUG, fleetVal("externalSources") || []);
   }
   /**
    * 🔴 **「1件も登録されていない」と「確かめられなかった」を分ける（#409）。**
@@ -7593,6 +7601,21 @@ ${calendarAddUrl.toString()}
    * 「いつ時点の情報か」の注記がどちらを指すのか説明できなくなる。
    */
   var LIVE_REALTIME = null;
+  /**
+   * Backlog の同期経路（op=state のトップレベル backlogRoute・#516）。
+   *
+   * 値は 4 つ: undefined＝まだ答えが無い／"fixed-ip"＝固定 IP 経由（正本に印がある）／
+   * "runner"＝通常の経路／null＝正本を読めなかった（サーバが null を返した・取得に失敗した・
+   * この値を知らない古い Lambda）。**null では切り替えさせない**（分からないのに書かせない）。
+   * 押した直後は backlog-route-set の応答で先に更新し、次の op=state が追いつく。
+   */
+  var LIVE_BACKLOG_ROUTE = undefined;
+  /**
+   * 固定の送信元 IP（op=state の realtime.fixedEgressIp・backlog-route-set の応答）。
+   * **画面に定数を持たない**——出どころは EIP の資源 → Intake の env の 1 本道で、
+   * 値が変わったときに画面だけ古いままにならない。取れていなければ空文字（IP を書かない）。
+   */
+  var LIVE_FIXED_IP = "";
   /**
    * いま登録ファイルに何が書いてあるか（op=state の registeredNow・段階1）。取得前は null。
    *
@@ -8060,6 +8083,21 @@ ${calendarAddUrl.toString()}
    */
   var KEY_POINTING_CHECKS = { backlog_secrets: "課題管理", figma_token: "デザイン" };
 
+  /**
+   * 鍵の入力欄を出す種別（#516）。
+   *
+   * **投入の口（intake）があるなら Backlog の鍵は必ず出す。** 固定 IP 経由で同期する案件は
+   * かつて CDK が secretKinds から backlog を落としていた（画面から入れても効かなかった頃の
+   * 名残）。いまは固定 IP 案件も同じ棚の鍵を画面から入れられる（#503 設計 v2 §5）ので、
+   * 写し（viewer-config.json）がまだ古い案件でも欄を出す。判定は接続先フォームと同じ線
+   *（backlogTargetsEditable）——2 か所で違う線を引くと、フォームは出るのに鍵だけ無い案件ができる。
+   */
+  function secretKindsShown() {
+    var kinds = (SITE.secretKinds || []).slice();
+    if (SITE.intake && kinds.indexOf("backlog") < 0) kinds.push("backlog");
+    return kinds;
+  }
+
   /**
    * 応答に添えられた接続先の一覧を採ったときの件数（Backlog の adoptTargets）。
    *
@@ -8416,7 +8454,7 @@ ${calendarAddUrl.toString()}
     //          「未対応です」と伝える場所も接続マップのアンカーの受け皿も無くなった
     //
     // 個別に足し続けると次も漏らすので、**この節に出す候補を列挙して判定する**形にする。
-    var hasSecrets = ((SITE.secretKinds || []).filter(function (k) { return SECRET_FORMS[k]; })).length > 0;
+    var hasSecrets = (secretKindsShown().filter(function (k) { return SECRET_FORMS[k]; })).length > 0;
     // **fleet のデータが取れているか、だけを見る（#125②）。** 宣言（tools）は撤去した（⑤）
     var hasCapModel = hasCaps;
     // **投入の口も候補。** fleet-status.json はGitHub Actionsが夜間に生成するので、
@@ -8832,7 +8870,9 @@ ${calendarAddUrl.toString()}
     // **GitHub（「external-sources」）はここに無い。** 読み取りトークンは廃止し、
     // 読み取りは GitHub App に一本化した。**この表に戻すと入力欄が復活する**
     // （対応表そのものは SECRET_CAP。3つの口で共有するので上に置いてある）
-    (SITE.secretKinds || []).forEach(function (k) {
+    // **種別の一覧は secretKindsShown()（#516）。** intake がある案件は写しの secretKinds に
+    // backlog が無くても Backlog の鍵を出す（固定 IP 案件も画面から鍵を入れる）
+    secretKindsShown().forEach(function (k) {
       if (!SECRET_FORMS[k]) return;
       // **意図的にOFFにした能力にだけ、入力欄を出さない（0.4.71）。** 使わないと決めたものに
       // 鍵を求めるのは、設定する必要が無いものに設定を促す偽の警告と同じ。
@@ -9282,7 +9322,7 @@ ${calendarAddUrl.toString()}
       var tokenRelevant = (derived != null ? derived !== "off" : true)
         && keyTargetCount(cap) > 0
         && !(derive && derive.keyMissing);
-      if (tokenRelevant && sk && (SITE.secretKinds || []).indexOf(sk) >= 0 && !secretPresentForTile(sk)) {
+      if (tokenRelevant && sk && secretKindsShown().indexOf(sk) >= 0 && !secretPresentForTile(sk)) {
         body.appendChild(el("div", { class: "ds-tile-note", text: "⚠ トークンが未設定です" }));
       }
       // 🔴 **セットアップの残り（checks）の長文はタイルに出さない（#230・オーナー指摘）。**
@@ -10053,14 +10093,140 @@ ${calendarAddUrl.toString()}
    * 立ち上げ直後の案件にも実在する。ミラーで判定すると、**まだ一度も繋いでいない案件＝
    * これから繋ぎたい案件**だけがフォームを出せない（実機で踏んだ）。
    *
-   * 出さないのは、この画面からの投入に対応していない固定IP同期の案件だけ。
-   * **その見分けは SITE.secretKinds に backlog が入っているかで行う。**
-   * 固定IPかどうかを直接示す値は画面に来ておらず（インフラ側の設定にしか無い）、
-   * 鍵の欄を出すかどうかの判定が同じ線で引かれているので、代理として正確に使える。
-   * インフラ側で secretKinds の条件を変えるときは、**ここの意味も一緒に変わる**。
+   * **判定は「投入の口（intake）があるか」（#516・#503 設計 v2 §4）。** それまでは
+   * SITE.secretKinds に backlog があるかで見ていた——固定 IP 経由で同期する案件は
+   * 画面からの投入に対応しておらず、CDK が secretKinds から backlog を落としていたので、
+   * その代理として使えた。いまは固定 IP 案件も同じ正本・同じ棚に画面から書けるので、
+   * 出さない理由は「書き込む口が無い」だけになった。**secretKinds に戻さないこと**——
+   * 写し（viewer-config.json）が古い案件で、接続先も鍵も画面から入れられなくなる。
+   * 鍵の欄の判定（secretKindsShown）も同じ線。
    */
   function backlogTargetsEditable() {
-    return (SITE.secretKinds || []).indexOf("backlog") >= 0;
+    return !!SITE.intake;
+  }
+
+  /**
+   * サーバが返した同期経路を 3 値に畳む（#516）。**知らない語は null（読めない）に倒す**
+   * ——新しい語を「通常」と読むと、印が付いている案件でスイッチが OFF に見える。
+   */
+  function backlogRouteOf(v) {
+    return v === "fixed-ip" || v === "runner" ? v : null;
+  }
+
+  /** スイッチの語（4 状態で変えない。状態は下の 1 行が言う） */
+  var BACKLOG_ROUTE_SWITCH_LABEL = "Backlog に IP 制限がある（固定 IP 経由で同期する）";
+
+  /**
+   * スイッチの下の 1 行（#516・#503 設計 v2 §6 の表と v3 §6 の ON 行）。
+   *
+   * 症状 → 一手の 1〜2 文。**技術語（CodeBuild・Lambda・runner）を出さない。**
+   * @param route      LIVE_BACKLOG_ROUTE（undefined / "fixed-ip" / "runner" / null）
+   * @param ip         固定の送信元 IP（無ければ空文字。**無いときは IP を書かない**——書けば嘘）
+   * @param count      いま画面に出ている接続先の件数
+   * @param keyState   Backlog の鍵の登録状況（"yes" / "no" / "unknown"）。**"no" のときだけ**
+   *                   鍵の登録を一手に出す。分からないときに「登録すると始まる」と言うと、
+   *                   入れてある人に入れ直させる
+   */
+  function backlogRouteLine(route, ip, count, keyState) {
+    if (route === undefined) return "設定を確認しています…";
+    if (route === null) return "設定を読み取れないため、いまは切り替えられません。";
+    if (route !== "fixed-ip") {
+      return count > 0
+        ? "Backlog の IP 制限で同期が失敗する案件は、これを入れてください。"
+        : "先に接続先を登録してください。";
+    }
+    var ipLabel = ip ? "固定の送信元 IP（" + ip + "）" : "固定の送信元 IP";
+    if (keyState === "no") {
+      return "同期は" + ipLabel + "から行います。お客様にこの IP の許可を依頼し、上の「Backlog のAPIキー」を登録すると同期が始まります。";
+    }
+    // 2 文に収める（実装レビューの指摘）。押した直後の帯（サーバの文面）も「許可を依頼」を言うが、
+    // 帯は数秒で読み終える結果で、この行は次に開いたときも残る状態——役目が違うので両方に置く
+    return "同期は" + ipLabel + "から行います。お客様にこの IP の許可を依頼してください（反映は毎晩 21:00 ごろの定期同期と、Webhook の受信から数分後です）。";
+  }
+
+  /**
+   * Backlog の同期経路の切り替えスイッチ（#516・#503 設計 v2 §6 / v3 §6・分類 A4）。
+   *
+   * 置き場は接続先の一覧の下・リアルタイム同期の上。部品はスイッチ 1 つ＋下の 1 行＋結果の帯。
+   *
+   * **確認ダイアログは出さない（A4）。** ON も OFF も同じスイッチで即時に戻せる（可逆）。
+   * 押した記録はサーバの監査に残る。
+   *
+   * **押せないのは 3 つ。** 印を読めない（null）・まだ答えが無い（undefined）・OFF で接続先 0 件
+   *（サーバも 400 で断る）。ON で接続先 0 件は押せる——止める方向を塞がない（T4 の契約）。
+   *
+   * **状態の正本は LIVE_BACKLOG_ROUTE。** 押して成功したら応答の route で先に更新し、
+   * その後の op=state（sendConfig が起こす）が追いつく。**画面の側で「押したから ON」と
+   * 決めない**——断られたときに向きだけ変わる形にしない。
+   *
+   * **結果の帯は差し替えの箱の外に置く。** 応答の文面（「お客様に IP の許可を依頼してください」）は
+   * 次の一手そのもので、数秒後に op=state が届いて箱を描き直した瞬間に消えると、
+   * 一番読ませたい文が読み終える前に消える（接続先の一覧の「結果は一覧の外」と同じ罠）。
+   *
+   * **IP の値は画面に持たない。** op=state（realtime.fixedEgressIp）と切り替えの応答
+   *（fixedEgressIp）から取る。取れていなければ IP を書かない。
+   */
+  function backlogRouteSwitch() {
+    var wrap = el("div", { class: "ds-route" });
+    var msg = el("div", { class: "ds-toggle-msg" });
+    var live = liveList("backlog-route", function () {
+      return JSON.stringify([
+        LIVE_BACKLOG_ROUTE === undefined ? "?" : LIVE_BACKLOG_ROUTE,
+        LIVE_FIXED_IP,
+        keyTargetCount("課題管理"),
+        secretRegisteredAnywhere(LIVE_SECRETS, "backlog"),
+      ]);
+    }, function (box) {
+      var route = LIVE_BACKLOG_ROUTE;
+      var on = route === "fixed-ip";
+      var count = keyTargetCount("課題管理");
+      var keyState = secretRegisteredAnywhere(LIVE_SECRETS, "backlog");
+      var disabled = route === undefined || route === null || (!on && count === 0);
+      var btn = el("button", {
+        class: "ds-switch",
+        type: "button",
+        role: "switch",
+        "aria-checked": on ? "true" : "false",
+      }, [
+        el("span", { class: "ds-switch-track", "aria-hidden": "true" }, [el("span", { class: "ds-switch-knob" })]),
+        el("span", { class: "ds-switch-label", text: BACKLOG_ROUTE_SWITCH_LABEL }),
+      ]);
+      if (disabled) btn.disabled = true;
+      btn.addEventListener("click", async function () {
+        if (btn.disabled) return;
+        var next = !on;
+        // **語は差し替えない**（beginBusy はボタンの語を「処理中…」に変える）。スイッチの語は
+        // 状態を言う 1 行と対なので、押している間だけ消えると何を押したのか読めなくなる。
+        // 押せない見た目にして、帯（msg）の「保存中…」で進んでいることを示す
+        btn.disabled = true;
+        btn.classList.add("is-busy");
+        msg.className = "ds-toggle-msg";
+        msg.textContent = "";
+        // **onDone ではなく hooks.onSaved で受ける（実装レビューの指摘）。** onDone は
+        // changed:false では流れない。正本が既に送った向きだった回（別の人・別のタブが先に
+        // 切り替えていた）はサーバが changed:false・route 無しで返すので、onDone だと
+        // スイッチが古い向きのまま「✓ 変更はありません」が出て、次の取り直しまで直らない。
+        // onSaved は res.ok なら changed を問わず流れる（冪等な op の受け口）
+        await sendConfig({ op: "backlog-route-set", route: next ? "fixed-ip" : "runner" }, msg, null, null, {
+          onSaved: function (j) {
+            // **応答の値を正とする。** 無ければ送った向き（サーバは断らなかった＝正本はその向き）
+            LIVE_BACKLOG_ROUTE = backlogRouteOf(j && j.route) || (next ? "fixed-ip" : "runner");
+            if (j && j.fixedEgressIp) LIVE_FIXED_IP = String(j.fixedEgressIp);
+            live.__rebuild();
+            // changed:false では sendConfig が読み直しを起こさない。正本の値で画面を揃えるために自分で起こす
+            if (j && j.changed === false) loadLiveFleet(true);
+          },
+        });
+        // 断られた・通信に失敗したときはこのボタンが残っている（成功時は描き直されて外れている）
+        btn.disabled = disabled;
+        btn.classList.remove("is-busy");
+      });
+      box.appendChild(el("div", { class: "ds-toggle ds-route-row" }, [btn]));
+      box.appendChild(el("p", { class: "sec-how ds-route-line", text: backlogRouteLine(route, LIVE_FIXED_IP, count, keyState) }));
+    });
+    wrap.appendChild(live);
+    wrap.appendChild(msg);
+    return wrap;
   }
 
   /**
@@ -10424,9 +10590,10 @@ ${calendarAddUrl.toString()}
      */
     function ensureKeySlots() {
       if (!editable) return;
-      // 受け皿を作る経路を通っていない案件（intake が無い・固定IP同期）はここも通さない
+      // 受け皿を作る経路を通っていない案件（intake が無い）はここも通さない
       if (!KEY_SLOTS.backlog || !Object.keys(KEY_SLOTS.backlog).length) return;
-      if ((SITE.secretKinds || []).indexOf("backlog") < 0 || !SECRET_FORMS["backlog"]) return;
+      // 種別の判定は鍵カードを作るループと同じ線（secretKindsShown・#516）
+      if (secretKindsShown().indexOf("backlog") < 0 || !SECRET_FORMS["backlog"]) return;
       var domains = [];
       for (var i = 0; i < targets.length; i++) {
         var dm = String(targets[i].domain || "").toLowerCase();
@@ -10477,9 +10644,9 @@ ${calendarAddUrl.toString()}
     // 呼ぶので、fleet が接続先を持たない案件（同期ミラーのURLから1行だけ作っている案件）では
     // **空を返す**——行は出るのに鍵の欄が1つも付かない、という空振りになる。
     //
-    // **この画面から投入できない案件（固定IP同期）には出さない。** 押しても Lambda が
-    // 「固定IP経由のため対応していません」で断るので、導線そのものを作らない。
-    // 判定は鍵カードを出すループの条件と同じ線（SITE.secretKinds に backlog があるか）。
+    // **固定 IP 経由の案件にも出す（#516）。** かつては Lambda が「固定IP経由のため
+    // 対応していません」で断るので導線を作らなかったが、いまは同じ棚に入る（#503 T4）。
+    // 判定は鍵カードを出すループの条件と同じ線（secretKindsShown＝intake があるか）。
     if (editable && !Object.keys(KEY_SLOTS.backlog).length) {
       // 保存時にスペースを名乗ってよいのは、名簿（fleet の backlogTarget）由来の行だけ。
       // 同期ミラーのURLから作った行で名乗ると、名簿とミラーがずれている案件で
@@ -10685,10 +10852,14 @@ ${calendarAddUrl.toString()}
       // 実在する。同期ミラーの有無で門前払いすると、**新規案件がこの画面から
       // Backlog に繋げない**——設定UIを置いている意味が無くなる
       box.appendChild(backlogTargetsSection(s));
-      if (!backlogTargetsEditable()) {
-        box.appendChild(el("p", { class: "sec-how", text: "この案件の Backlog は別の経路で同期しているため、この画面からは接続先を変更できません。変更が必要なときは cortex の担当者にご連絡ください。" }));
-        used = true;
-      }
+      // **「この画面からは接続先を変更できません」の枝は撤去した（#516）。** ゲートが
+      // 「intake があるか」になり、この関数は intake の無い案件では上で return しているので、
+      // 到達しない枝だった（到達不能な枝は変異検証の網から漏れる）。
+      //
+      // **接続先の下・リアルタイム同期の上に、同期経路のスイッチを置く（#516・設計 v2 §6）。**
+      // #497 の「固定 IP 経由で同期できます（切り替えは運用側）」の案内と画面の IP 定数は
+      // これに置き換わった——切り替えは担当者が自分で押す。
+      box.appendChild(backlogRouteSwitch());
       // **接続先の下に置く。** リアルタイム同期は「どのプロジェクトを見るか」が
       // 決まった後の話で、順序が逆だと、接続先を設定していない案件が先に
       // Webhook を貼りに行く（貼っても届かない）
@@ -10971,7 +11142,7 @@ ${calendarAddUrl.toString()}
         // how / note）。全文をここに移すと二重になり、片方だけ直る形になる
         // ——カードは接続マップとタイルの注記と条件を揃えているので、動かすと壊れやすい。
         hint: [
-          "Figma でトークンを発行します（読み取りだけ。スコープ2つ）。手順は「Figma のトークン」の欄にあります（ファイルを追加すると上に出ます）。",
+          "Figma でトークンを発行します（読み取りだけ。スコープ2つ。Dev または Full 席の方が発行）。手順は「Figma のトークン」の欄にあります（ファイルを追加すると上に出ます）。",
           "発行したアカウントを、読み取りたい Figma ファイルに閲覧者として招待します（招待が無いと、トークンが正しくても読めません）。",
           "そのファイルのURLを下の欄に貼って「追加」を押します。",
           "追加したファイルは、画面名と Figma へのリンクが毎晩同期されます（画像は取り込まれません）。",
@@ -12386,6 +12557,10 @@ ${calendarAddUrl.toString()}
         // **fleet より先に読む。** fleet-status.json をまだ持たない案件（立ち上げ直後）は
         // 下で throw するが、リアルタイム同期の可否は索引由来なので独立に決まる
         LIVE_REALTIME = (j && j.realtime) || null;
+        // 同期経路と固定 IP（#516）。**サーバが知らない値・返さない回は null（読めない）**
+        // ——undefined のままにすると「確認しています」が永久に残る
+        LIVE_BACKLOG_ROUTE = backlogRouteOf(j && j.backlogRoute);
+        if (LIVE_REALTIME && LIVE_REALTIME.fixedEgressIp) LIVE_FIXED_IP = String(LIVE_REALTIME.fixedEgressIp);
         // 🔴 **registeredNow も fleet より先に読む。** まとめ表をまだ持たない案件
         // （＝立ち上げ直後＝この仕組みが一番効く案件）は下で throw するので、
         // ここより後に置くと**その案件だけ素通り**する
@@ -12436,6 +12611,9 @@ ${calendarAddUrl.toString()}
         liveFleetRequested = false;
         liveAnswered = true;
         MERGED = null;
+        // 同期経路（#516）。**一度も答えが無いまま失敗したら「読めない」に倒す**（切り替えさせない）。
+        // 前の答え（または切り替え直後の応答の値）があるなら、それを捨てない
+        if (LIVE_BACKLOG_ROUTE === undefined) LIVE_BACKLOG_ROUTE = null;
         // 🔴 **確認中に倒した図を焼いた表示へ戻す（#256・設計v2 の3）。** ライブが
         // 取れなかったときのフォールバックはここに残る——戻さないと「確認中…」の
         // ままの図が残り、オフラインでは**何も分からない画面**になる。
@@ -12563,8 +12741,11 @@ ${calendarAddUrl.toString()}
    * **出すのは「手順どおり設定すれば実際に効く案件」だけ。** 判断は Lambda（op=state）が返す
    * realtime に委ねる——画面が持っている静的データからは「ルーティング索引に自分の行が
    * あるか」が分からないし、2箇所で判定すると片方だけがずれる。
-   *   - supported: false … 固定IP経由で同期している案件。**黙って欠けさせず**理由を1行出す
+   *   - via: "fixed-ip"  … 固定 IP 経由で同期する案件（#516・#503 設計 v3 §6）。手順は同じ。
+   *                        反映が「約1分」ではなく「数分」になることだけを言う
    *   - ready: false     … 索引にまだ行が無い。設定しても届かないので手順を出さない
+   *   「supported: false（固定 IP は未対応）」の枝は撤去した——固定 IP 案件でも Webhook を
+   *   受ける（分類 A2）。その値を返す古い Lambda に当たっても、手順を出す側に倒す
    *
    * **URLに載せるトークンは案件別**（SITE.backlogWebhook）。艦隊共通トークンを載せると、
    * この画面を見られる人が全案件ぶんの偽イベントを投げられる（types.ts の backlogWebhook 参照）。
@@ -12575,14 +12756,10 @@ ${calendarAddUrl.toString()}
    */
   function realtimeSyncCard() {
     var rt = LIVE_REALTIME;
-    // **未対応（固定IP経由の同期）だけは、手順ではなく理由を出す。** ここは索引の状態ではなく
-    // 経路の話で、設定しても効かないことが確定している唯一の形。黙って欠けさせない
-    if (rt && rt.supported === false) {
-      return el("p", {
-        class: "sec-how",
-        text: "この案件は固定IP経由でBacklogを同期しているため、リアルタイム同期（Webhook）には未対応です。反映は毎晩の同期のタイミングになります。",
-      });
-    }
+    // 固定 IP 経由か（#516）。**経路の正本は op=state の realtime.via**——スイッチの状態
+    //（LIVE_BACKLOG_ROUTE）から引かない。あちらは押した直後に先に変わるが、受信したイベントを
+    // どちらが同期するかはサーバ側の索引が決めるので、同じ応答の値で言う
+    var viaFixedIp = !!(rt && rt.via === "fixed-ip");
     var wh = SITE.backlogWebhook;
     // **URLが無い案件には出さない。** 貼るものが無い手順は、一番読めない形になる
     if (!wh || !wh.url || !wh.token) return null;
@@ -12654,7 +12831,11 @@ ${calendarAddUrl.toString()}
       msg,
       // **この画面は顧客も見る。** URLに秘密が入っていることと、その扱いを書いておく
       el("p", { class: "sec-note", text: "このURLはこの案件専用です（他の案件には届きません）。秘密のトークンを含むので、貼り付け先は Backlog のこのプロジェクトの設定欄だけにしてください。" }),
-      el("p", { class: "sec-how", text: "反映は受信から約1分後です（1分ごとのミニバッチでまとめて取り込みます）。初回は上の接続先の設定と、夜間同期が一度済んでいることが前提になります。" }),
+      // 固定 IP 経由の案件は反映が「約1分」にならない（1分のまとめ＋固定 IP の同期の起動で数分）。
+      // **同じ行を差し替える**——2 行に分けると「約1分」と「数分」が並んで矛盾する
+      el("p", { class: "sec-how", text: viaFixedIp
+        ? "固定 IP 経由で同期します（反映は受信から数分後です）。初回は上の接続先の設定と、夜間同期が一度済んでいることが前提になります。"
+        : "反映は受信から約1分後です（1分ごとのミニバッチでまとめて取り込みます）。初回は上の接続先の設定と、夜間同期が一度済んでいることが前提になります。" }),
     ];
 
     if (live) {
@@ -12688,7 +12869,10 @@ ${calendarAddUrl.toString()}
           el("span", { class: "rt-live-badge", text: "✓ 稼働中" }),
         ]),
         lines,
-        el("p", { class: "ops-card-desc", text: "Backlog の変更をすぐ取り込んでいます（毎晩の同期を待ちません）。設定は済んでいるので、このままお使いください。" }),
+        // 固定 IP 経由の案件は「すぐ」ではなく「数分」（手順は畳んであるので、ここでも言う）
+        el("p", { class: "ops-card-desc", text: viaFixedIp
+          ? "Backlog の変更を固定 IP 経由で取り込んでいます（反映まで数分・毎晩の同期を待ちません）。設定は済んでいるので、このままお使いください。"
+          : "Backlog の変更をすぐ取り込んでいます（毎晩の同期を待ちません）。設定は済んでいるので、このままお使いください。" }),
         det,
       ]);
     }
@@ -12743,7 +12927,8 @@ ${calendarAddUrl.toString()}
       // **スコープが正しくても、招待が無いと読めない。** トークンは「そのアカウントが
       // 見られるファイル」しか読めないので、招待漏れは 404 になる。権限の問題に見えないため
       // 現場で切り分けに時間がかかる（実際に踏んだ）。入力欄の隣に書いておく。
-      note: "発行したアカウントを、対象の Figma ファイルに閲覧者として招待しておいてください（招待が無いとトークンが正しくても読めません）。",
+      note: "発行したアカウントを、対象の Figma ファイルに閲覧者として招待しておいてください（招待が無いとトークンが正しくても読めません）。"
+        + "発行するのは、対象ファイルのあるチームで Dev または Full の席を持つ方にしてください。閲覧席（View/Collab）のトークンは取得回数が月 20 回までで、夜間同期が数日で止まります。",
     },
     "backlog": {
       icon: "📋",

package/package.json

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