@takagaki/cortex-decisions-viewer 0.4.44 → 0.4.45

package/dist/build.js

@@ -135,6 +135,9 @@ async function readFleetSources(repoRoot) {
             ref: s.ref != null ? String(s.ref) : undefined,
             url: s.url != null ? String(s.url) : undefined,
             gold: typeof s.gold === "boolean" ? s.gold : undefined,
+            // goldState は gold の理由。`gold: false` だけだと「意図的に外した」「宣言し忘れ」
+            // 「exclude による除外」が同じ値になり、**正常な除外にまで警告を出して麻痺する**。
+            goldState: s.goldState != null ? String(s.goldState) : undefined,
             notify: typeof s.notify === "boolean" ? s.notify : undefined,
             gate: s.gate != null ? String(s.gate) : undefined,
         }))
@@ -178,7 +181,8 @@ async function readFleetSources(repoRoot) {
         if (!Object.keys(tools).length)
             tools = undefined;
     }
-    return { externalSources, internalSources, pipelines, tools };
+    const fleetGeneratedAt = typeof obj.generatedAt === "string" ? obj.generatedAt : undefined;
+    return { externalSources, internalSources, pipelines, tools, fleetGeneratedAt };
 }
 /** パスがディレクトリとして存在するか */
 async function isDirectory(dirAbs) {
@@ -667,7 +671,7 @@ function buildGraph(decisions, home, sections, content, targetUrls, repoBaseUrl,
     const deduped = edges.filter((e) => {
         if (e.from === e.to)
             return false;
-        const key = `${e.from}${e.to}${e.rel}`;
+        const key = `${e.from}\u0000${e.to}\u0000${e.rel}`;
         if (seen.has(key))
             return false;
         seen.add(key);
@@ -979,6 +983,7 @@ async function build(opts) {
             }
             : undefined,
         externalSources: fleet.externalSources,
+        fleetGeneratedAt: fleet.fleetGeneratedAt,
         internalSources: fleet.internalSources,
         pipelines: fleet.pipelines,
         tools: fleet.tools,

package/dist/render.js

@@ -91,6 +91,23 @@ const CM_TOOL_LABEL = {
  * 状態: 健全=色付き＋流れるアニメーション / 問題あり=黄＋⚠️ / 未使用=グレー。
  * fleet-status由来の情報が何も無ければ null（マップを出さない・後方互換）。
  */
+/**
+ * このソースが「注意が必要」か。接続マップ（ビルド時生成）とデータソース一覧（クライアント側）で
+ * **同じ判定を使う**ためにここに置く。片方だけ直すと、同じ画面でマップが⚠️・直下が「接続OK」になる。
+ *
+ * 判定の考え方:
+ * - 明示的に Gold 対象から外したもの（`gold === false`）は、読めなくて当たり前なので警告しない。
+ *   ただし通知先（`notify`）に使っているなら、届いていないこと自体が問題なので拾う。
+ * - `gold` が無い（旧 fleet-status.json）ときは**警告する側に倒す**。「不明」を「対象外」と扱うと、
+ *   本当に壊れているものが黙って隠れる（フェイルオープン）。
+ */
+function sourceNeedsAttention(s) {
+    if (s.gate === "ok")
+        return false;
+    if (s.gold === false && s.notify !== true)
+        return false;
+    return true;
+}
 function renderConnectionMap(site) {
     const internals = site.internalSources ?? [];
     const externals = site.externalSources ?? [];
@@ -119,7 +136,9 @@ function renderConnectionMap(site) {
         // 問題あり: ライブ参照はgate≠okが1件以上、同期ソースは対応パイプラインの直近runがfailure
         const warn = !off &&
             (isLive
-                ? liveExts.some((s) => s.gate !== "ok")
+                // カード側の集計（sourceNeedsAttention）と同じ判定にする。ここだけ接続状態だけを見ていると、
+                // マップが⚠️なのに直下のグループが「接続OK」という矛盾が同じ画面に出る。
+                ? liveExts.some((s) => sourceNeedsAttention(s))
                 : pipes.some((p) => c.pipe != null && c.pipe.test(p.id) && p.applicable !== false && p.lastConclusion === "failure"));
         const state = off ? "cm-off" : warn ? "cm-warn" : "cm-ok";
         const toolName = toolVal && toolVal !== "none"
@@ -657,7 +676,8 @@ a:hover { text-decoration: underline; }
 /* ---- データソースと自動化 ---- */
 .datasources { margin-top: 34px; }
 .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 14px; }
+.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; }
 .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 {
@@ -722,6 +742,7 @@ 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; }
+.badge.ds-undeclared { background: #fff4e5; color: #9a6700; }
 .badge.ds-notify { background: #eff6ff; color: #1e40af; border: 1px solid #bfdbfe; }
 .ds-gate { display: inline-flex; align-items: center; gap: 5px; font-size: 12.5px; font-weight: 600; flex: 0 0 auto; }
 .ds-gate::before { content: ""; width: 8px; height: 8px; border-radius: 999px; background: currentColor; }
@@ -1348,6 +1369,14 @@ const CLIENT_JS = `
     var sec = el("section", { class: "datasources" });
     sec.appendChild(el("h2", { class: "datasources-head", text: "データソースと自動化" }));
     sec.appendChild(el("p", { class: "datasources-intro", text: "このCortexが接続している情報源と、毎晩自動でGoldに昇格する処理の一覧です。" }));
+    // **いつ時点の情報かを必ず出す。** この節は夜間バッチが作るスナップショットを読んでいるので、
+    // 設定を変えても次の生成までは古い値のまま。時刻が無いと「変えたのに反映されない」ではなく
+    // 「変えたはずなのに違う値が出ている」と読まれてしまう（実際に設定変更直後にそうなった）。
+    var asOf = SITE.fleetGeneratedAt ? dsFmtTime(SITE.fleetGeneratedAt) : "";
+    if (asOf) {
+      sec.appendChild(el("p", { class: "datasources-asof",
+        text: "接続状況は " + asOf + " 時点の自動チェック結果です。設定を変えた場合、ここに反映されるのは次回の実行後になります。" }));
+    }
 
     if (internals.length) {
       sec.appendChild(el("div", { class: "ds-sub", text: "リポジトリ内の情報源（自動同期）" }));
@@ -1414,14 +1443,27 @@ const CLIENT_JS = `
         var cards = el("div", { class: "ds-list" });
         g.items.forEach(function (s) { cards.appendChild(extSourceCard(s, meta)); });
         if (g.items.length >= 4) {
-          // 折りたたみ（既定は閉）。summaryに件数と状態の要約を出す
+          // 折りたたみ（既定は閉）。summaryに件数と状態の要約を出す。
+          // 判定は接続マップ側の sourceNeedsAttention と揃える（片方だけ直すと同じ画面で矛盾する）。
+          // 意図的に外したソースが接続できないのは当たり前なので数えない。ただし通知先に
+          // 使っているなら届いていないこと自体が問題なので拾う。gold 不明は警告する側に倒す。
           var bad = 0;
-          g.items.forEach(function (s) { if (s.gate !== "ok") bad++; });
+          var noToken = 0;
+          g.items.forEach(function (s) {
+            if (s.gate === "ok") return;
+            if (s.gold === false && s.notify !== true) return;
+            bad++;
+            if (s.gate === "no_token") noToken++;
+          });
           var sum = el("summary", {}, [
             el("span", { text: meta.icon + " " + meta.label + "（" + g.items.length + (UNIT[g.type] || "件") + "）" }),
             bad === 0
               ? el("span", { class: "badge ds-sum-ok", text: "接続OK" })
-              : el("span", { class: "badge ds-sum-warn", text: "⚠️ " + bad + "件に問題" }),
+              // 原因が1つに集約できるときは原因を書く。「19件に問題」より「トークンが未設定」の方が、
+              // 読んだ人が次に何をすればよいか分かる（実際、19件の原因がトークン1本ということがあった）。
+              : el("span", { class: "badge ds-sum-warn", text: noToken === bad
+                  ? "⚠️ " + bad + "件が読めていません（トークン未設定）"
+                  : "⚠️ " + bad + "件に問題" }),
           ]);
           var det = el("details", { class: "ds-group" }, [sum, cards]);
           if (anchorId) det.id = anchorId;
@@ -1439,7 +1481,7 @@ const CLIENT_JS = `
     // 注記は内部・外部の両グループの後ろに1つ（内部の直下だけに置くと外部ソースが
     // Gold昇格の対象外に見えるため）。除外の方法もここで案内する。
     if (internals.length || sources.length || chatOff || devOff) {
-      sec.appendChild(el("p", { class: "ds-note", text: "上記の情報源はすべて毎晩の Gold 昇格が読み取ります（「除外」バッジのものを除く。チャンネル・リポジトリ単位で除外できます）。" }));
+      sec.appendChild(el("p", { class: "ds-note", text: "「Gold昇格の読み取り対象」のものだけを毎晩の Gold 昇格が読み取ります。「除外」は意図的に外したもの、「未宣言（対象外）」はまだ判断されていないもので、どちらも読み取りません（チャンネル・リポジトリ単位で切り替えられます）。" }));
     }
 
     if (pipes.length) {
@@ -1485,7 +1527,10 @@ const CLIENT_JS = `
   // 外部ソース1件のカード（グループ化表示・展開表示の両方から使う）
   function extSourceCard(s, meta) {
     var badges = el("div", { class: "ds-badges" });
+    // 「意図的に外した」と「宣言し忘れ」を分けて出す。同じ「除外」と書くと、
+    // 判断されていないだけのものが「判断済み」に見えてしまう。
     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: "通知先" }));
     var gate = DS_GATE[s.gate] || DS_GATE["unknown"];

package/package.json

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