@takagaki/cortex-decisions-viewer 0.4.62 → 0.4.63

package/dist/build.js

@@ -148,6 +148,26 @@ async function readFleetSources(repoRoot) {
             origin: s.origin != null ? String(s.origin) : undefined,
         }))
         : undefined;
+    // セットアップの充足チェック。**missing だけを通す。**
+    // na（使わないと宣言した能力）を通すと「設定する必要が無いものに設定を促す」偽の警告になり、
+    // #101 で潰した穴が復活する。unknown は AWS/gh へ到達できなかった回に出るので、
+    // 夜間実行がこけた日に嘘が出る。
+    // score / nextActions は通さない——nextActions は checks[].action を平坦化した
+    // 同じ内容の別キーで、通すと同じ文が2箇所に出る。
+    const checks = Array.isArray(obj.checks)
+        ? obj.checks
+            .filter((c) => c != null && typeof c === "object")
+            .filter((c) => String(c.status ?? "") === "missing")
+            .map((c) => ({
+            id: String(c.id ?? ""),
+            label: String(c.label ?? ""),
+            category: String(c.category ?? ""),
+            status: String(c.status ?? ""),
+            action: c.action != null ? String(c.action) : undefined,
+            detail: c.detail != null ? String(c.detail) : undefined,
+        }))
+            .filter((c) => c.id !== "")
+        : undefined;
     const internalSources = Array.isArray(obj.internalSources)
         ? obj.internalSources
             .filter((s) => s != null && typeof s === "object")
@@ -157,6 +177,9 @@ async function readFleetSources(repoRoot) {
             label: String(s.label ?? ""),
             url: s.url != null ? String(s.url) : undefined,
             lastSync: s.lastSync != null ? String(s.lastSync) : undefined,
+            // 取り込み済みの件数。**「同期が走った」と「実際に入った」は別物。**
+            // これが無いと、初回全量同期をしていない案件が「接続OK」に見える
+            itemCount: typeof s.itemCount === "number" ? s.itemCount : undefined,
             // 会議名に入れる合図。**古い fleet-status.json の matchKeys は引き継がない**
             // （client名と廃止した meetingNamePatterns の寄せ集めで、いま照合には使われていない。
             // 出すと「この語を会議名に入れれば拾われる」と読めてしまう）。
@@ -225,7 +248,7 @@ async function readFleetSources(repoRoot) {
     const secretSources = obj.secretSources && typeof obj.secretSources === "object"
         ? obj.secretSources
         : undefined;
-    return { externalSources, internalSources, pipelines, tools, fleetGeneratedAt, secretSources };
+    return { externalSources, internalSources, pipelines, tools, fleetGeneratedAt, secretSources, checks };
 }
 /** パスがディレクトリとして存在するか */
 async function isDirectory(dirAbs) {
@@ -1101,6 +1124,7 @@ async function build(opts) {
         internalSources: fleet.internalSources,
         pipelines: fleet.pipelines,
         tools: fleet.tools,
+        checks: fleet.checks,
     };
     // サムネイル（デザイン画面等）をサイトに同梱し、ノードのパスをサイト内相対に書き換える
     await node_fs_1.promises.mkdir(outAbs, { recursive: true });

package/dist/render.js

@@ -224,7 +224,13 @@ function capabilityState(cap, ctx) {
     const pipeSkipped = ctx.pipes.some(function (p) {
         return pipeRe != null && pipeRe.test(p.id) && p.applicable === false;
     });
-    const syncedForReal = internal != null && ((internal.lastSync && !pipeSkipped) || internal.url);
+    // **「同期が走った」と「実際にデータが入った」は別物。** 初回全量同期をしていない案件は、
+    // 毎晩の差分同期が成功し続けても0件のままになる（cortex-context の課題管理が実例で、
+    // lastSync はあるのに取り込み件数は0だった）。件数を見ないと、タイルが「接続OK」と言い、
+    // 同じ画面のセットアップ残りが「初回同期がまだです」と言う状態になる。
+    // 件数が無い（古い fleet-status.json・件数を持たない能力）ときは、いままでの判定に従う。
+    const emptyForReal = internal != null && internal.itemCount === 0;
+    const syncedForReal = internal != null && !emptyForReal && ((internal.lastSync && !pipeSkipped) || internal.url);
     const idle = !off &&
         (isLive
             ? liveExts.length === 0
@@ -944,6 +950,19 @@ a.ds-name:hover { text-decoration: underline; }
   width: 40px; height: 40px; flex: 0 0 40px; font-size: 26px; line-height: 1;
 }
 .ds-tile-logo svg { width: 100%; height: 100%; }
+/* セットアップの残り。**直し方を状態と同じ大きさで出す**——
+   何が足りないかだけ分かっても、次の一歩が分からなければ画面の意味が薄い */
+.ds-tile-todo { color: var(--muted); }
+.ds-checks { display: flex; flex-direction: column; gap: 8px; margin-bottom: 20px; }
+.ds-check-cat { font-size: 12px; font-weight: 700; color: var(--muted); margin-top: 8px; }
+.ds-check {
+  display: flex; flex-direction: column; gap: 3px;
+  border-left: 3px solid #fcd34d; background: #fffbeb;
+  border-radius: 0 8px 8px 0; padding: 8px 12px;
+}
+.ds-check-label { font-size: 13px; font-weight: 700; color: var(--text); }
+.ds-check-action { font-size: 13px; color: var(--text); line-height: 1.7; }
+.ds-check-detail { font-size: 12px; color: var(--muted); }
 .ds-tile-desc { font-size: 12.5px; color: var(--muted); }
 .ds-tile-sub { font-size: 12.5px; margin-top: 2px; }
 .ds-tile-chev { color: var(--muted); }
@@ -969,6 +988,9 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-gate-warn { color: #b45309; }
 .ds-gate-muted { color: #6b7280; }
 .ds-pipes { display: flex; flex-direction: column; gap: 8px; }
+/* 実行状況の行に直し方を添える。同じ run の未達を別の節にも出すと画面に2回並ぶ */
+.ds-pipe-wrap { display: flex; flex-direction: column; gap: 3px; }
+.ds-pipe-todo { font-size: 12.5px; color: var(--muted); line-height: 1.7; padding-left: 4px; }
 .ds-pipe {
   display: flex; align-items: baseline; flex-wrap: wrap; gap: 4px 12px;
   padding: 10px 14px; background: var(--surface); border: 1px solid var(--border); border-radius: 10px; box-shadow: var(--shadow);
@@ -1957,6 +1979,50 @@ ${capabilityState.toString()}
     var STATE_LABEL = { ok: "● 接続OK", idle: "⦿ 未接続", off: "未使用", warn: "⚠️" };
     var SECRET_OF_CAP = { "デザイン": "figma", "課題管理": "backlog", "開発": "external-sources" };
 
+    // ---- セットアップの残り（checks）----
+    //
+    // **能力に紐づくものはその能力のタイルへ、紐づかないものは節にまとめる。**
+    // 独立した一覧にすると、鍵カードの「現在: 未設定」やタイルの状態と
+    // 同じことを別の言い方で二度言うことになり、ズレたときに読み手が
+    // どちらを信じるか決められない（#101 で判定を1箇所に集めたのと同じ理由）。
+    //
+    // **missing 以外は出さない。** na は「使わないと宣言した能力」で、出すと
+    // 「設定する必要が無いものに設定を促す」偽の警告になる（#101 で潰した穴）。
+    // ビルド時とライブの両方で絞っているが、ここでも見る——経路が増えたときに
+    // 絞り忘れると、いちばん見せてはいけないものが出る側に倒れるため。
+    // **夜間 run の項目は、下の「自動化パイプライン」節が同じ run を出している。**
+    // 両方に出すと、同じ失敗が1画面に2回並ぶ。実行状況はパイプライン節に任せ、
+    // ここでは直し方だけをその行に添える（下の renderPipelines で使う）
+    var PIPE_CHECK = { "update-gold": "nightly_decisionlog", "sync-backlog": "nightly_backlog", "sync-designs": "figma_sync" };
+    var CHECK_CAP = {
+      backlog_secrets: "課題管理", backlog_synced: "課題管理",
+      meeting_minutes: "会議",
+      channels_json: "チャット",
+      figma_token: "デザイン", figma_inventory: "デザイン",
+      submodules: "開発", dev_issues_derived: "開発",
+    };
+    var allChecks = (fleetVal("checks") || []).filter(function (c) {
+      return c != null && c.status === "missing";
+    });
+    // **タイルに出せたものを覚えておく。** 振り分け先の能力タイルが立たない案件
+    //（tools に宣言が無い・行も無い）では出す場所が無くなり、項目が**黙って消える**。
+    // 消えた分は下の節へ落とす——振り分けを間違えても、消えるよりは出る方がよい
+    var shownOnTile = {};
+    function checksFor(cap) {
+      return allChecks.filter(function (c) { return CHECK_CAP[c.id] === cap; });
+    }
+    /** 残りの1件を、直し方まで含めて1行にする */
+    function checkLine(c) {
+      var row = el("div", { class: "ds-check" });
+      row.appendChild(el("span", { class: "ds-check-label", text: c.label }));
+      if (c.action) row.appendChild(el("span", { class: "ds-check-action", text: c.action }));
+      // **detail は内部値が入ることがある**（"none" / "success"）。読めるものだけ出す
+      if (c.detail && !/^(none|success|failure|skipped|unknown)$/.test(c.detail)) {
+        row.appendChild(el("span", { class: "ds-check-detail", text: c.detail }));
+      }
+      return row;
+    }
+
     /** タイルの2行目（状態と読み取り範囲）。**件数は出せる能力だけ出す** */
     function tileSub(cap, st) {
       var internal = internals.filter(function (s) { return s.kind === cap; })[0];
@@ -2066,6 +2132,18 @@ ${capabilityState.toString()}
       if (tools[cap] !== "none" && sk && (SITE.secretKinds || []).indexOf(sk) >= 0 && !((fleetVal("secretSources") || {})[sk])) {
         body.appendChild(el("div", { class: "ds-tile-note", text: "⚠ トークンが未設定です" }));
       }
+      // セットアップの残りのうち、この能力のもの。**鍵の注記と同じ位置**に出して
+      // 「何が足りないか」と「何をすればよいか」を同じ場所で読めるようにする
+      checksFor(cap).forEach(function (c) {
+        // **直し方が無いものはタイルに出さないが、出したことにもしない。**
+        // shownOnTile を先に立てると節からも外れ、画面のどこにも出なくなる
+        //（実データで mitsubishi の nightly_backlog / figma_token、verdy の
+        //  nightly_backlog が消えていた）。タイルは状態を読む場所なので
+        //「足りない」だけの行では埋めず、節の側で拾う
+        if (!c.action) return;
+        shownOnTile[c.id] = true;
+        body.appendChild(el("div", { class: "ds-tile-note ds-tile-todo", text: "→ " + c.action }));
+      });
       var tile = el("button", { class: "ds-tile", type: "button", id: "ds-" + cap }, [
         ic,
         body,
@@ -2124,11 +2202,46 @@ ${capabilityState.toString()}
         }
         children.push(el("span", { class: "ds-pipe-label", text: p.label || p.id || "" }));
         if (t) children.push(el("span", { class: "ds-pipe-time", text: "最終成功: " + t }));
-        plist.appendChild(el("div", { class: "ds-pipe" }, children));
+        var row = el("div", { class: "ds-pipe" }, children);
+        // **直し方はこの行に添える。** 同じ run の未達を「セットアップの残り」にも出すと、
+        // 同じ失敗が1画面に2回並ぶ。実行状況はここが正本なので、直し方だけを持ってくる
+        var pc = allChecks.filter(function (c) { return c.id === PIPE_CHECK[p.id]; })[0];
+        if (pc && pc.action) {
+          shownOnTile[pc.id] = true;
+          row = el("div", { class: "ds-pipe-wrap" }, [row, el("div", { class: "ds-pipe-todo", text: "→ " + pc.action })]);
+        }
+        plist.appendChild(row);
       });
       sec.appendChild(plist);
     }
 
+    // ---- セットアップの残り（どこにも出せなかったもの）----
+    //
+    // **パイプライン節より後に計算する。** 夜間 run の直し方はその行に添えるので、
+    // 先に計算すると shownOnTile がまだ立っておらず、同じ文が2箇所に出る
+    //
+    // **8/8案件で未達の scaffold_drift が、ここで初めて誰かの目に入る。**
+    // 能力のタイルに居場所が無い項目（基盤・Cortex・シークレット）は、
+    // ここに出さないとどこにも出ない。
+    var loose = allChecks.filter(function (c) { return !shownOnTile[c.id]; });
+    if (loose.length) {
+      sec.appendChild(el("div", { class: "ds-sub", text: "セットアップの残り" }));
+      sec.appendChild(el("p", { class: "ds-note", text: "毎晩の自動チェックで見つかった、まだ済んでいない設定です。" }));
+      var byCat = {};
+      var catOrder = [];
+      loose.forEach(function (c) {
+        var k = c.category || "その他";
+        if (!byCat[k]) { byCat[k] = []; catOrder.push(k); }
+        byCat[k].push(c);
+      });
+      var todo = el("div", { class: "ds-checks" });
+      catOrder.forEach(function (k) {
+        todo.appendChild(el("div", { class: "ds-check-cat", text: k }));
+        byCat[k].forEach(function (c) { todo.appendChild(checkLine(c)); });
+      });
+      sec.appendChild(todo);
+    }
+
     return sec;
   }
   function renderDataSources() {

package/package.json

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