@takagaki/cortex-decisions-viewer 0.10.3 → 0.10.5

package/dist/render.js

@@ -2168,6 +2168,8 @@ a.ds-name:hover { text-decoration: underline; }
 .rt-card { margin-top: 10px; }
 .rt-steps { margin: 0; padding-left: 1.4em; color: var(--text); font-size: 13px; line-height: 1.9; }
 .rt-steps li { margin: 2px 0; }
+/* 通知イベントのチェック名（10個）。1行に並べると読めないので、種別ごとに折る */
+.rt-steps li ul { margin: 2px 0 6px; padding-left: 1.1em; list-style: disc; color: var(--muted); line-height: 1.7; }
 /* URLは長いので、入力欄を伸ばしてボタンを右に置く（折り返しても崩れないように wrap） */
 .rt-url-row { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
 .rt-copy { margin: 6px 0 10px; }
@@ -7380,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; });
@@ -7428,7 +7442,20 @@ ${nextStateDelay.toString()}
       el("ol", { class: "rt-steps" }, [
         el("li", { text: "Backlog のプロジェクト設定 → インテグレーション → Webhook を開く" }),
         el("li", { text: "「WebHook URL」に下の案件専用URLを貼り付ける" }),
-        el("li", { text: "通知イベントで「課題の追加」「課題の更新」「課題にコメント」等にチェックを入れて保存する" }),
+        // **チェック名は受信側が処理する10種を全部並べる。** 「等」で省くと、担当者は
+        // 課題の3つだけにチェックして「設定した」と思い、Wikiとドキュメントの更新は
+        // 夜間まで届かない（画面は稼働中と出るので、欠けていることに気づけない）。
+        // ここを増減するときは受信側（backlog-webhook/logic.mjs の HANDLED_TYPES）と
+        // 揃える——ずれると realtime-sync-card.test.mjs が赤くなる。
+        // **「他はチェック不要」とは言い切らない。** 未対応の type（ドキュメントの更新等）は
+        // 「無視した」ログから見つける設計なので、外させると発見の経路が塞がる
+        el("li", { text: "通知イベントで次の10個にチェックを入れて保存する（他のイベントはチェックしても取り込まれません）" }, [
+          el("ul", {}, [
+            el("li", { text: "課題:「課題の追加」「課題の更新」「課題にコメント」「課題の削除」「課題をまとめて更新」" }),
+            el("li", { text: "Wiki:「Wikiページを追加」「Wikiページを更新」「Wikiページを削除」" }),
+            el("li", { text: "ドキュメント:「ドキュメントの追加」「ドキュメントの削除」" }),
+          ]),
+        ]),
       ]),
       el("div", { class: "rt-url-row" }, [field, copyBtn]),
       msg,
@@ -7473,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: "⚡" }),
         // **稼働中の枝と同じ見出しにする**（上の ⚠ 参照。片方だけ直すと、
@@ -7481,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.3",
+  "version": "0.10.5",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,