@takagaki/cortex-decisions-viewer 0.10.4 → 0.10.5

package/dist/render.js

@@ -7382,20 +7382,32 @@ ${nextStateDelay.toString()}
    */
   function realtimeSyncCard() {
     var rt = LIVE_REALTIME;
-    if (!rt) return null; // 取得前・取得失敗・Backlogを使わない案件
-    if (rt.supported === false) {
+    // **未対応（固定IP経由の同期）だけは、手順ではなく理由を出す。** ここは索引の状態ではなく
+    // 経路の話で、設定しても効かないことが確定している唯一の形。黙って欠けさせない
+    if (rt && rt.supported === false) {
       return el("p", {
         class: "sec-how",
         text: "この案件は固定IP経由でBacklogを同期しているため、リアルタイム同期（Webhook）には未対応です。反映は毎晩の同期のタイミングになります。",
       });
     }
     var wh = SITE.backlogWebhook;
-    if (!rt.ready || !wh || !wh.url || !wh.token) return null;
+    // **URLが無い案件には出さない。** 貼るものが無い手順は、一番読めない形になる
+    if (!wh || !wh.url || !wh.token) return null;
+    // **索引に行があるか（ready）でカードごと隠さない（2026-08-24 オーナー決定）。**
+    // それまでは「手順どおり設定すれば実際に効く案件だけに出す」としていたが、
+    // ready の材料（ルーティング索引の行）は**設定を始める前には揃わない**ので、
+    // これから設定する人ほど手順に辿り着けなかった。索引がまだ追いついていない案件も、
+    // 取得前・取得失敗（rt が null）も、手順は出す——URLは案件専用で、先に貼っておいても
+    // 困らない。ready のときだけ受信実績の行を足す
+    var ready = !!(rt && rt.ready);
     var url = wh.url + (wh.url.indexOf("?") === -1 ? "?" : "&") + "t=" + encodeURIComponent(wh.token);
     // 接続先ごとの受信実績（#123）。**配列で受ける**——1案件＝複数 Backlog プロジェクトは
     // 確定した将来要件（#107）で、今日は必ず1件。**時刻が読めない値は稼働中に数えない**
     // ——「最終受信: NaN分前」を出すくらいなら、未設定と同じ手順の画面のほうがまだ読める
-    var targets = (rt.targets || []).map(function (t) {
+    // **ready でないうちは受信実績を読まない。** ready の材料は索引の行（＝自リポ宛だと
+    // 確かめられた行）で、それが無いのに lastEventAt だけ来ている応答を信じると、
+    // **届いていない案件に「✓ 稼働中」を出す**——一番出してはいけない嘘になる
+    var targets = (ready && rt.targets ? rt.targets : []).map(function (t) {
       return { projectKey: t && t.projectKey ? String(t.projectKey) : "", ago: t && t.lastEventAt ? rtAgo(t.lastEventAt) : "" };
     });
     var live = targets.some(function (t) { return t.ago; });
@@ -7488,7 +7500,9 @@ ${nextStateDelay.toString()}
       ]);
     }
 
-    return el("div", { class: "ops-card rt-card" }, [
+    // まだ受け入れ体制が整っていない案件（接続先がこれから・索引が追いついていない）には、
+    // **次の一手だけを1行足す。** 担当者への連絡は促さない——この画面で完結する話だから
+    var head = [
       el("div", { class: "ops-card-head" }, [
         el("span", { class: "ops-card-icon", text: "⚡" }),
         // **稼働中の枝と同じ見出しにする**（上の ⚠ 参照。片方だけ直すと、
@@ -7496,7 +7510,14 @@ ${nextStateDelay.toString()}
         el("h3", { class: "ops-card-title", text: "リアルタイム同期（任意）" }),
       ]),
       el("p", { class: "ops-card-desc", text: "Backlog で課題やコメントが変わったときに、その内容をすぐ取り込みます（毎晩の同期を待たずに反映されます）。Backlog 側で一度だけ設定してください。" }),
-    ].concat(steps));
+    ];
+    if (!ready) {
+      head.push(el("p", {
+        class: "sec-how",
+        text: "上の「接続先」を先に設定してから貼り付けてください。設定した直後は、この画面が追いつくまで少し時間がかかることがあります。",
+      }));
+    }
+    return el("div", { class: "ops-card rt-card" }, head.concat(steps));
   }
 
   /**

package/package.json

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