@takagaki/cortex-decisions-viewer 0.4.62 → 0.4.64

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

@@ -172,6 +172,36 @@ function externalCapability(type) {
         return "開発";
     return CAP_OTHER;
 }
+/**
+ * 貼られたURLから Backlog の接続先を読む。
+ *
+ * **クライアントへは .toString() で渡す。** テンプレート文字列の中に正規表現を
+ * 手で書くと、バックスラッシュが二重に潰れて別物になる（実際に
+ * `\\/` が `/` になり、クライアントJSが構文エラーで丸ごと落ちた）。
+ * 既存の sourceNeedsAttention / capabilityState と同じ流儀にする。
+ *
+ * **判定の正本は Lambda 側**（そちらが書き込む）。ここは確認文の表示用で、
+ * 食い違うと「画面はこう見せたのに別のものが書かれた」になるので、
+ * 同じ形かをテストで突き合わせている。
+ */
+function backlogTargetOf(input) {
+    const s = String(input == null ? "" : input).trim();
+    const m = s.match(/^https?:\/\/([a-z0-9-]+\.(?:backlog\.jp|backlog\.com|backlogtool\.com))\/(.*)$/i);
+    if (!m)
+        return null;
+    const domain = m[1].toLowerCase();
+    const rest = m[2];
+    // **数値のプロジェクトIDは弾く。** 取り違えの検査（艦隊のキーとの照合）を
+    // 迂回できてしまう。Backlog はドキュメントのURLをこの形でも出す
+    const num = /^[0-9]+$/;
+    const head = rest.match(/^(?:projects|document|wiki|find|board|gantt|git)\/([A-Za-z0-9_]+)(?:[/?#]|$)/);
+    if (head)
+        return num.test(head[1]) ? null : { domain: domain, projectKey: head[1].toUpperCase() };
+    const view = rest.match(/^view\/([A-Za-z0-9_]+)-\d+/);
+    if (view)
+        return num.test(view[1]) ? null : { domain: domain, projectKey: view[1].toUpperCase() };
+    return null;
+}
 function capabilityState(cap, ctx) {
     // **能力→パイプラインの対応はここに持つ。** 呼び出し側に渡させると、
     // クライアント側（この関数を .toString() で受け取る側）が同じ表を書き写すことになり、
@@ -224,7 +254,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 +980,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 +1018,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);
@@ -1112,6 +1164,7 @@ const CLIENT_JS = `
   // 直列化した先（ここ）で undefined を参照して壊れる。
 var CAP_OTHER = ${JSON.stringify(CAP_OTHER)};
 ${externalCapability.toString()}
+${backlogTargetOf.toString()}
 ${sourceNeedsAttention.toString()}
 ${capabilityState.toString()}
   // 「はじめに」セクションのチュートリアルデータ（ビルド時に埋め込み。ボタンURL・チャレンジ4の決定は解決済み）
@@ -1827,14 +1880,34 @@ ${capabilityState.toString()}
         if (aliases.length) {
           // **目印が無くても入る会議。** 既に走っていて改名を頼みにくい定例を、
           // いまの名前のまま登録したもの。出さないと「なぜこれだけ入るのか」
-          // 「新しい定例をどこに足すのか」が画面から分からない
-          var shown = aliases.slice(0, 5).join(" / ");
-          if (aliases.length > 5) shown += " 他" + (aliases.length - 5) + "件";
+          // 「新しい定例をどこに足すのか」が画面から分からない。
+          //
+          // **1件ずつ外せるようにする。** 追加はできて削除はできない、だと
+          // 間違えて登録した名前（日付つきのファイル名など）を消す手段が無い
           col.appendChild(el("span", {
             class: "ds-keys",
-            text: "目印なしで取り込む会議: " + shown,
+            text: "目印なしで取り込む会議:",
             title: "この名前の会議は、目印が無くてもこの案件に振り分けられます（大小文字・前後の空白は問いません。ファイル名に使えない記号（コロン・スラッシュ等）は同じものとして扱います）。既に走っている定例を改名せずに取り込むための登録です。",
           }));
+          var alist = el("div", { class: "ds-subitems" });
+          aliases.forEach(function (a) {
+            var row = el("div", { class: "ds-subitem" }, [el("span", { class: "ds-name", text: a })]);
+            row.appendChild(removeButton({
+              label: "この会議を外す",
+              confirmLines: function () {
+                return [
+                  "「" + a + "」を取り込み対象から外します。",
+                  "",
+                  "以後この名前の会議は、会議名に目印を入れない限り取り込まれません。",
+                  "",
+                  "外しますか？",
+                ];
+              },
+              build: function () { return { op: "remove-meeting-alias", alias: a }; },
+            }));
+            alist.appendChild(row);
+          });
+          col.appendChild(alist);
         }
         if (s.driveSync === false) {
           col.appendChild(el("span", { class: "ds-drive-note", text: "Drive自動同期は未設定（手動で置いたファイルの変換のみ）" }));
@@ -1957,6 +2030,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 +2183,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 +2253,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() {
@@ -2232,6 +2396,18 @@ ${capabilityState.toString()}
     // 宣言で隠すと、動いているのに説明が出ない状態になる。
     if (s.kind === "会議" && s.ingestState === "on") {
       box.appendChild(meetingHowTo());
+      // **改名を頼めない定例のための逃げ道。** 通常は会議名に【合図】を入れてもらうが、
+      // 顧客が主催する定例では改名を頼めない。実際の会議名をそのまま登録して拾う
+      box.appendChild(addForm({
+        title: "＋ 会議名をそのまま取り込み対象にする",
+        placeholder: "例: GDO様 定例",
+        requiredNote: "会議名を入力してください。",
+        hint: "合図（【…】）を入れられない会議のための設定です。ここに入れた名前と**完全に一致する**会議だけが取り込まれます（部分一致はしません）。カレンダーに出ている会議名だけを入れてください——日付や「- Gemini によるメモ」のような後ろに付く文字列を含めると、どの会議とも一致しません。Bot の招待は別途必要です。",
+        confirmLines: function (v) {
+          return ["この名前の会議を取り込み対象にします。", "", v, "", "追加しますか？"];
+        },
+        build: function (alias) { return { op: "add-meeting-alias", alias: alias }; },
+      }));
       used = true;
     } else if (s.kind === "会議" && usable("会議", "google-meet")) {
       if (s.ingestState === "unset") {
@@ -2249,6 +2425,46 @@ ${capabilityState.toString()}
       }
     }
 
+    // 課題管理: 接続先（ドメイン・プロジェクトキー）をURL1本で設定する。
+    // **URLを貼らせる。** ドメインとキーを別々に入れさせると「スペースID」
+    // 「プロジェクトキー」「プロジェクト名」の区別が付かず取り違える。
+    // 実データでも cm1.backlog.jp と jleague.backlog.jp が混在している
+    if (s.kind === "課題管理" && usable("課題管理", "backlog")) {
+      // **設定ファイルが無い案件にはフォームを出さない。** 書き込み先が無いので
+      // 貼っても 404 で終わる。三菱電機は tools が backlog なのに
+      // backlog-settings.json が1つも無い（固定IP経由の同期で、UIからの投入は
+      // 鍵と同じく対応していない）。会議・共有資料は unset / broken を文言で
+      // 伝えてフォームを出さない形なので、課題管理だけ不揃いだった
+      if (!s.url) {
+        box.appendChild(el("p", { class: "sec-how", text: "この案件の課題管理の設定ファイル（backlog-settings.json）がまだありません。先に初回の同期を実行するか、担当者にご連絡ください。" }));
+        used = true;
+      } else box.appendChild(addForm({
+        title: "接続先を変更",
+        placeholder: "https://<スペース>.backlog.jp/projects/<プロジェクトキー>",
+        requiredNote: "BacklogのURLを入力してください（プロジェクトキーが入った形。数字だけのURLは受け付けません）。",
+        hint: "Backlog でこの案件のプロジェクトを開き、ブラウザのURLをそのまま貼ってください（課題の画面のURLでも構いません）。APIキーは下の「Backlog のAPIキー」から別に登録します。",
+        confirmLines: function (v) {
+          // **解析した結果を見せる。** 貼ったURLをそのまま出すと、どのプロジェクトを
+          // 指すことになるかが確定前に分からない。実際 /projects/PJ-CORTEX は
+          // ハイフンで切れて PJ と解釈される（黙って別プロジェクトを指す）
+          var t = backlogTargetOf(v);
+          return [
+            "この案件が同期する Backlog プロジェクトを設定します。",
+            "",
+            "別のプロジェクトを指すと、次の同期で別案件の課題が入ります。",
+            "",
+            t ? t.domain + " / " + t.projectKey : v,
+            "",
+            "※ 変わるのは同期先だけです。ビューアからの起票先と Webhook の配送先は別途の対応が要ります。",
+            "",
+            "設定しますか？",
+          ];
+        },
+        build: function (url) { return { op: "set-backlog-target", url: url }; },
+      }));
+      used = true;
+    }
+
     if (s.kind === "共有資料" && usable("共有資料", "google-drive")) {
       if (s.driveState === "unset") {
         box.appendChild(el("p", { class: "sec-how", text: "資料の同期設定がこのリポジトリにありません（materials-config.json）。先に設置が必要です。" }));

package/package.json

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