@takagaki/cortex-decisions-viewer 0.4.43 → 0.4.45

package/dist/build.js

@@ -42,6 +42,9 @@ const path = __importStar(require("node:path"));
 const gray_matter_1 = __importDefault(require("gray-matter"));
 const marked_1 = require("marked");
 const repo_1 = require("./repo");
+// 直近のGold昇格で追加されたレコードのパス集合。レコード生成の各所から参照するのでモジュールスコープに置く
+// （引数で引き回すと呼び出し側の改修が広範囲になる）。build() の冒頭で1回だけ解決する。
+let LATEST_PATHS = new Set();
 const render_1 = require("./render");
 const DEFAULT_EXCLUDE = ["README.md", "template.md"];
 /** frontmatterのrelationsを安全に正規化する */
@@ -132,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,
         }))
@@ -175,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) {
@@ -245,6 +252,7 @@ async function parseGeneric(raw, fileName, repoRelDir, repoBaseUrl, branch) {
         editUrl,
         rtype: data.type != null ? String(data.type) : "",
         rstatus: data.status != null ? String(data.status) : "",
+        isLatest: LATEST_PATHS.has(filePath),
         relations: toRelations(data.relations),
         source: data.source != null ? String(data.source) : "",
         bodyLinks: extractBodyLinks(content),
@@ -663,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);
@@ -901,6 +909,11 @@ async function build(opts) {
         branch: opts.branch,
         cwd: dirAbs,
     });
+    // 直近のGold昇格で追加されたレコードを git から解決する（レコードの date は決定日なので生成時期が分からない）。
+    // git が返すのはリポジトリルート相対のパス（`Cortex/...`）なので、判定も**リポジトリルート**で行う
+    // （Decisionsディレクトリで実行すると `-- Cortex/` に一致せず常に空になる）。
+    // 浅いclone・git無しの環境では空集合が返り、「最新」ラベルが出ないだけで他の表示は壊れない。
+    LATEST_PATHS = (0, repo_1.latestGeneratedPaths)(process.cwd());
     const decisions = [];
     for (const fileName of mdFiles) {
         const raw = await node_fs_1.promises.readFile(path.join(dirAbs, fileName), "utf8");
@@ -970,6 +983,7 @@ async function build(opts) {
             }
             : undefined,
         externalSources: fleet.externalSources,
+        fleetGeneratedAt: fleet.fleetGeneratedAt,
         internalSources: fleet.internalSources,
         pipelines: fleet.pipelines,
         tools: fleet.tools,
@@ -1035,6 +1049,7 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch) {
         bodyRef: "",
         searchText: toSearchText(content),
         rstatus: data.status != null ? String(data.status) : "",
+        isLatest: LATEST_PATHS.has(filePath),
         fileName,
         editUrl,
         fm: sanitizeFm(data),

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"
@@ -549,6 +568,8 @@ a:hover { text-decoration: underline; }
 .badge.cat-ビジネス { background: #fde9ef; color: #be185d; }
 .badge.cat-デザイン { background: #fce7f3; color: #a21caf; }
 .badge.draft { background: #fef3c7; color: #92400e; border: 1px solid #fcd34d; }
+/* 直近のGold昇格で作られたレコードの印。draft（黄・要対応）と区別できるよう、新着を示す緑系にする */
+.badge.latest { background: #dcfce7; color: #166534; border: 1px solid #86efac; }
 .badge.error { background: #fee2e2; color: #b91c1c; border: 1px solid #fca5a5; }
 .draft-note {
   display: flex; gap: 8px; align-items: flex-start;
@@ -655,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 {
@@ -720,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; }
@@ -922,6 +945,11 @@ const CLIENT_JS = `
   function draftBadge(rec) {
     return rec && rec.rstatus === "draft" ? el("span", { class: "badge draft", text: "AI生成・未確認" }) : null;
   }
+  // 直近のGold昇格で作られたレコードの印。レコードの date は決定日なので、日付順に並べても
+  // 「今回の実行で何が増えたか」は分からない。ビルド時に git から判定した結果（isLatest）を出す
+  function latestBadge(rec) {
+    return rec && rec.isLatest ? el("span", { class: "badge latest", text: "最新の生成" }) : null;
+  }
   // 詳細ページの警告。バッジより強く「そのまま信じないでほしい」と伝える
   function draftNote(rec) {
     if (!rec || rec.rstatus !== "draft") return null;
@@ -1151,17 +1179,24 @@ const CLIENT_JS = `
     var base = SITE.repoBaseUrl;
     var INFO = {
       "decisions": {
-        text: "議事録・課題から確定した決定が毎晩自動で追記されます（update-decision-log-auto）。",
+        text: "議事録・課題から確定した決定が毎晩自動で追記されます。",
         btnLabel: "実行履歴を確認 →",
-        btnUrl: base ? base + "/actions/workflows/update-decision-log.yml" : null,
+        btnUrl: base ? base + "/actions/workflows/update-gold.yml" : null,
       },
       "dir:Glossary": {
-        text: "毎晩の自動走査が新しい用語を draft として直接追加します（update-glossary-auto）。AIが生成した定義は仮のものです。「AI生成・未確認」の用語は必ず内容を確認し、適切な定義に置き換えて status: active にしてください。",
+        text: "毎晩の自動走査が新しい用語を draft として直接追加します。AIが生成した定義は仮のものです。「AI生成・未確認」の用語は必ず内容を確認し、適切な定義に置き換えて status: active にしてください。",
         btnLabel: "実行履歴を確認 →",
-        btnUrl: base ? base + "/actions/workflows/update-glossary.yml" : null,
+        btnUrl: base ? base + "/actions/workflows/update-gold.yml" : null,
+      },
+      "dir:Members": {
+        text: "プロジェクト関係者の名簿です。人名の表記ゆれを解決する根拠になります。毎晩の自動走査が新しい参加者を draft として追加します。",
+        btnLabel: "実行履歴を確認 →",
+        btnUrl: base ? base + "/actions/workflows/update-gold.yml" : null,
       },
       "dir:Rules": {
         text: "案件で継続的に守る制約・ルールの一覧です。AIはここを読んで、違反する提案を避けます。",
+        btnLabel: "実行履歴を確認 →",
+        btnUrl: base ? base + "/actions/workflows/update-gold.yml" : null,
       },
       "graph": {
         text: "決定・用語・レポートと、その根拠になった課題・議事録・資料のつながりを自動でつないだ地図です。点をクリックすると、そのページや実際のシステム（Backlog・GitHub等）に移動できます。",
@@ -1334,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: "リポジトリ内の情報源（自動同期）" }));
@@ -1400,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;
@@ -1425,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) {
@@ -1471,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"];
@@ -1747,6 +1806,7 @@ const CLIENT_JS = `
     pg.slice.forEach(function (d) {
       var meta = el("div", { class: "card-meta" }, [
         draftBadge(d),
+        latestBadge(d),
         el("span", { class: "mono", text: d.date || "----" }),
         catBadge(d.category),
         el("span", { class: "mono", text: d.id }),
@@ -1814,6 +1874,7 @@ const CLIENT_JS = `
       pg.slice.forEach(function (r) {
         var meta = el("div", { class: "card-meta" }, [
           draftBadge(r),
+          latestBadge(r),
           r.date ? el("span", { class: "mono", text: r.date }) : null,
           el("span", { class: "mono", text: r.id }),
         ]);
@@ -1864,6 +1925,7 @@ const CLIENT_JS = `
 
     app.appendChild(el("div", { class: "detail-meta" }, [
       draftBadge(r),
+      latestBadge(r),
       r.date ? el("span", { class: "mono", text: r.date }) : null,
       el("span", { class: "mono", text: r.id }),
       r.summary ? el("span", { text: r.summary }) : null,
@@ -2521,6 +2583,7 @@ const CLIENT_JS = `
 
     var meta = el("div", { class: "detail-meta" }, [
       draftBadge(d),
+      latestBadge(d),
       el("span", { class: "mono", text: d.date || "----" }),
       catBadge(d.category),
       el("span", { class: "mono", text: d.id }),

package/dist/repo.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveRepo = resolveRepo;
+exports.latestGeneratedPaths = latestGeneratedPaths;
 exports.normalizeToHttps = normalizeToHttps;
 const node_child_process_1 = require("node:child_process");
 /**
@@ -15,6 +16,51 @@ function resolveRepo(opts) {
     const remote = tryGitRemote(opts.cwd);
     return { baseUrl: remote ? normalizeToHttps(remote) : null, branch };
 }
+/**
+ * 直近のGold昇格で追加されたレコードのパス集合を返す。
+ *
+ * 「最新の生成物」をビューアで区別するために使う。レコードの frontmatter の `date` は
+ * **決定日**（過去の議事録から起こした決定は古い日付になる）なので、生成のタイミングは
+ * git 側からしか分からない。
+ *
+ * 判定: 夜間パイプラインのコミット（メッセージが「自動追記」を含む）のうち最新の1回を探し、
+ * そのコミットで **追加（A）** されたファイルを返す。同じ夜に複数フェーズが別コミットで入るため、
+ * 最新コミットと同じ「日」のパイプラインコミットまでをまとめて1回の実行として扱う。
+ *
+ * clone が浅い（--depth 1 等）・git が無い環境では**空集合を返す**（ラベルが出ないだけで壊れない）。
+ */
+function latestGeneratedPaths(cwd) {
+    const empty = new Set();
+    try {
+        // 夜間パイプラインのコミットを新しい順に数件。--grep はコミットメッセージの規約に依存するため、
+        // 変わっても「ラベルが出ない」だけで済むように例外は握る。
+        const log = (0, node_child_process_1.execSync)('git log -n 20 --grep="自動追記" --pretty=format:"%H %cI" -- Cortex/', { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        if (!log)
+            return empty;
+        const rows = log.split("\n").map((l) => {
+            const [sha, iso] = l.trim().split(/\s+/);
+            return { sha, day: (iso || "").slice(0, 10) };
+        });
+        const latestDay = rows[0].day;
+        if (!latestDay)
+            return empty;
+        const out = new Set();
+        for (const r of rows) {
+            if (r.day !== latestDay)
+                break; // 直近の実行日ぶんだけ
+            const files = (0, node_child_process_1.execSync)(`git show --diff-filter=A --name-only --pretty=format: ${r.sha}`, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+            for (const f of files.split("\n")) {
+                const p = f.trim();
+                if (p)
+                    out.add(p);
+            }
+        }
+        return out;
+    }
+    catch {
+        return empty; // 浅いclone・git無し・メッセージ規約の変更 → ラベルなしで続行
+    }
+}
 function tryGitRemote(cwd) {
     try {
         return (0, node_child_process_1.execSync)("git config --get remote.origin.url", {

package/package.json

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