@takagaki/cortex-decisions-viewer 0.12.58 → 0.12.59

package/dist/render.js

@@ -10,7 +10,7 @@ exports.devRepositoryRefs = devRepositoryRefs;
 exports.claudeCodeRepositories = claudeCodeRepositories;
 exports.claudeCodeUrl = claudeCodeUrl;
 exports.toolStateLabel = toolStateLabel;
-exports.toolStateWithLive = toolStateWithLive;
+exports.regRowOfToolItem = regRowOfToolItem;
 exports.toolsFoldSummary = toolsFoldSummary;
 exports.isAlreadyRegistered = isAlreadyRegistered;
 exports.sanitizeRegisteredNow = sanitizeRegisteredNow;
@@ -57,6 +57,10 @@ exports.calendarTemplateUrl = calendarTemplateUrl;
 exports.calendarAddUrl = calendarAddUrl;
 exports.deriveCapTile = deriveCapTile;
 exports.derivePendingTile = derivePendingTile;
+exports.liveRowVerdict = liveRowVerdict;
+exports.liveRegistryOf = liveRegistryOf;
+exports.liveToolKey = liveToolKey;
+exports.liveToolItems = liveToolItems;
 exports.renderConnectionMap = renderConnectionMap;
 const node_crypto_1 = require("node:crypto");
 const google_chat_guide_images_1 = require("./google-chat-guide-images");
@@ -523,6 +527,11 @@ function claudeCodeUrl(prompt, projectRepo, externals) {
 // **ビューアは登録簿（channels.json 等）を読まない。** 読むと「使っていると言う条件」が
 // engine と画面で 2 枚になり、片方だけ直った日から一覧と AI の起動文が食い違う
 // （viewer/test/no-registry-read.test.mjs が見張っている）。
+//
+// **一覧の行の有無と状態は、ライブの登録一覧（op=state の registeredNow・操作タブが既に
+// 読んでいるもの）と接続状態ストア（stateNow）で差し替える（#581・`liveToolItems`）。**
+// まとめ表は毎朝の schedule でしか作り直されないので、そのまま描くと日中に外した接続先が
+// 翌朝まで残る。行ごとの状態の判定はタイル（`derivePendingTile`）と同じ `liveRowVerdict`。
 // ---------------------------------------------------------------------------
 /**
  * 種別のアイコン。**DS_TYPE（データソース一覧）と同じ絵柄にそろえる**——同じツールが
@@ -538,11 +547,15 @@ const TOOL_KIND_ICONS = {
     "google-meet": "🎥",
 };
 /**
- * 状態の表示語と色。**4 語しか出さない**（読み取り中／承認待ち／停止中／未確認）。
+ * 状態の表示語と色。**4 語＋「登録状況を確認中です」しか出さない**（読み取り中／承認待ち／
+ * 停止中／未確認、そして登録簿にしか無くまだ測っていない行の「確認中」・#581）。
  *
  * 色は既存の `ds-gate-*` を流用する——同じ画面で「緑＝読めている・橙＝人の操作待ち・
  * 灰＝分からない」の意味を 2 通りに増やさない。
  *
+ * 🔴 **`pending` の語は操作タブの行（`DS_GATE_PENDING`）と同じ「登録状況を確認中です」。**
+ * 新しい言い方を作ると、同じ接続先が Home と操作タブで違う語になる。
+ *
  * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
  */
 function toolStateLabel(state) {
@@ -553,53 +566,72 @@ function toolStateLabel(state) {
     // 止めているものは警告色にしない（直す必要が無いので、橙にすると直しに行かせてしまう）
     if (state === "stopped")
         return { text: "停止中", cls: "ds-gate-muted" };
+    // 登録簿にはあるが、まだ誰も測っていない（#581）。**既定分岐（未確認）より前に置く**
+    if (state === "pending")
+        return { text: "登録状況を確認中です", cls: "ds-gate-muted" };
     return { text: "未確認", cls: "ds-gate-muted" };
 }
 /**
- * ビルド時の状態に、接続状態ストアの実測（`stateNow`）を重ねた state を返す。
+ * 種別 → ライブの登録一覧（`registeredNow`）のキー（#581）。**この表は Home の一覧の
+ * 突き合わせにしか使わない**。会議（google-meet）は登録簿を持たない（ref 固定 `transcripts`）
+ * ので載せない＝Home ではまとめ表の行がそのまま残る。
  *
- * 🔴 **`stopped` は上書きしない。** 止めているのは登録簿から決まる事実で、
- * ストアが「届く」と答えても読み取っていない。**止めたものを「読み取り中」と言わない**。
+ * GitHub は `dev`（読み取り中）と `devExcluded`（停止中）の 2 キーに分かれて届く。
+ * 「停止中」と「登録から消えた」を分ける唯一の材料が `devExcluded` なので、
+ * **両方が配列のときだけ登録簿を正本にする**（`liveToolItems` の項）
+ */
+const TOOL_KIND_REG = {
+    backlog: "issues",
+    github: "dev",
+    slack: "chat",
+    "google-chat": "google-chat",
+    figma: "design",
+    "google-drive": "materials",
+};
+/**
+ * 種別の人向けの名前。**engine `project-tools.mjs` の `TOOL_LABELS` の写し**（一致は
+ * `home-tools-live.test.mjs` が契約 fixture と突き合わせる）。まとめ表の行が 1 つでも
+ * あればそちらの `label` を優先し、ここを引くのは**登録簿にしか無い種別の行**だけ。
+ */
+const TOOL_KIND_LABELS = {
+    backlog: "Backlog",
+    github: "GitHub",
+    slack: "Slack",
+    "google-chat": "Google Chat",
+    figma: "Figma",
+    "google-drive": "Google Drive",
+    "google-meet": "Google Meet",
+};
+/** ライブの登録行から組む href に許す字（英数と `/` `.` `_` `-`）。形が外れたら url は null */
+const TOOL_URL_SAFE = /^[A-Za-z0-9._\/-]+$/;
+/**
+ * まとめ表（`SITE.tools`）の 1 行を、ライブの登録一覧の行と同じ形に写す（#581）。
  *
- * 🔴 **突き合わせの鍵は行が自分で持っている**（cap + question + ref、Slack だけ workspace）。
- * ここで種別ごとの if 連鎖を書き直すと、engine の書き手（connection-state-write-*）と
- * 鍵の作り方が 2 枚になる。**github だけ大小を無視する**——登録簿の owner/repo と
- * ストアの ref は、人が貼った URL 由来で大小が揺れる。
+ * **状態の判定を 1 本にするための小さな写し。** 登録簿が読めなかった回（`registered` が
+ * null）でも、まとめ表の行をこの形にして `liveRowVerdict` に渡す——「登録簿が届いたか
+ * どうか」で別の関数から状態が出る形を残さない（設計レビュー🔴5）。
  *
- * 行が無ければビルド時の値のまま（**「不明」に化けさせない**——夜間が測った結果を
- * ライブが答えなかっただけで消すと、朝には出ていたものが消える）。
+ * 鍵の畳み方は `registeredRefKeys` が持つ。ここは欄の名前を合わせるだけ
+ * （issues は `domain/KEY` を割る。割れない値は空の行＝鍵が組めず未測定に倒れる）。
  *
  * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
  */
-function toolStateWithLive(item, rows) {
-    if (!item)
-        return "unknown";
-    if (item.state === "stopped")
-        return "stopped";
-    var hit = null;
-    (rows || []).forEach(function (r) {
-        if (hit || !r)
-            return;
-        if (r.cap !== item.cap || r.question !== item.question)
-            return;
-        var a = String(r.ref == null ? "" : r.ref);
-        var b = String(item.ref == null ? "" : item.ref);
-        if (item.cap === "dev" ? a.toLowerCase() !== b.toLowerCase() : a !== b)
-            return;
-        // チャンネルIDはワークスペースの中でしか一意でない（overlayStateOnFleet と同じ鍵）
-        if (item.cap === "chat" && String(r.workspace || "") !== String(item.workspace || ""))
-            return;
-        hit = r;
-    });
-    if (!hit)
-        return String(item.state || "unknown");
-    if (hit.status === "ok")
-        return "reading";
-    // **「測ったが分からなかった」は「承認待ち」に寄せない**（人が押す操作が無い）
-    if (hit.status === "unknown")
-        return "unknown";
-    // failed / skipped / not_in_channel / missing_scope / no_token … は全部「人の操作待ち」
-    return "waiting";
+function regRowOfToolItem(item) {
+    var kind = String(item && item.kind != null ? item.kind : "");
+    var ref = String(item && item.ref != null ? item.ref : "");
+    if (kind === "slack")
+        return { ref: ref, workspace: String(item.workspace == null ? "" : item.workspace), name: item.name };
+    if (kind === "figma")
+        return { key: ref, name: item.name };
+    if (kind === "google-drive")
+        return { id: ref, name: item.name };
+    if (kind === "backlog") {
+        var at = ref.indexOf("/");
+        if (at <= 0 || at === ref.length - 1)
+            return {};
+        return { domain: ref.slice(0, at), projectKey: ref.slice(at + 1) };
+    }
+    return { ref: ref, name: item.name };
 }
 /**
  * 畳んだ種別の 1 行に出す、状態の要約（#424）。
@@ -617,9 +649,9 @@ function toolStateWithLive(item, rows) {
  * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
  */
 function toolsFoldSummary(states) {
-    // 表示の順は状態の 4 語と同じ（読み取り中→承認待ち→停止中→未確認）
-    var order = ["reading", "waiting", "stopped", "unknown"];
-    var count = { reading: 0, waiting: 0, stopped: 0, unknown: 0 };
+    // 表示の順は状態の語と同じ（読み取り中→承認待ち→停止中→未確認→登録状況を確認中です）
+    var order = ["reading", "waiting", "stopped", "unknown", "pending"];
+    var count = { reading: 0, waiting: 0, stopped: 0, unknown: 0, pending: 0 };
     (states || []).forEach(function (s) {
         // ⚠ 4 語のどれかに当たるかは **order で見る**（素のオブジェクトの添字だと
         // "constructor" のような語が継承プロパティに当たって、知らない語が素通りする）
@@ -2538,9 +2570,15 @@ function calendarTemplateUrl(id) {
  *
  * ⚠ `calendarTemplateUrl` と同じく**実測は未了**（#425 の 3）。共有されている人が開くと
  * 「カレンダーを追加しますか」が出る想定。
+ *
+ * 🔴 **engine の `projectCalendarUrl`（Home の「使用ツール」の Google Meet 行）と同じ形にする**
+ * （cortex-engine #343）。`u/0` は「1 番目にログインしている Google アカウント」で、
+ * 片方だけに付いていると、業務アカウントが 2 番目の人には**Home のリンクは開けるのに
+ * この接続タブは開けない（あるいはその逆）**という、説明できない差になる。
+ * 外すときは engine 側と同じ回に外す。
  */
 function calendarAddUrl(id) {
-    return "https://calendar.google.com/calendar/r?cid=" + encodeURIComponent(id);
+    return "https://calendar.google.com/calendar/u/0/r?cid=" + encodeURIComponent(id);
 }
 /**
  * タイル1行（と接続グラフの1ノード）の状態を、**正本から導出する**（0.12.0）。
@@ -2717,8 +2755,6 @@ function deriveCapTile(cap, ctx) {
 function derivePendingTile(regKey, registered, rows) {
     if (!Array.isArray(registered) || registered.length === 0)
         return null;
-    var state = Array.isArray(rows) ? rows : [];
-    var bad = BAD_STATE_STATUSES.reachable || [];
     var latestAt = "";
     var latestMs = -Infinity;
     var unmeasured = false;
@@ -2727,37 +2763,25 @@ function derivePendingTile(regKey, registered, rows) {
         var reg = registered[i];
         if (!reg || typeof reg !== "object")
             continue;
-        var keys = registeredRefKeys(regKey, [reg]);
-        var hit = null;
-        var hitMs = -Infinity;
-        for (var j = 0; j < state.length; j++) {
-            var r = state[j];
-            if (!r || r.cap !== regKey || r.question !== "reachable")
-                continue;
-            if (!keys || !keys[stateRefKey(regKey, r.ref, r.workspace)])
-                continue;
-            // **最新の 1 行が勝つ。** 読めない at は最古（NaN は比較で常に負けるので -Infinity に畳む）。
-            // 同値は後勝ち（`>=`）——サーバが並べた順を崩さない
-            var ms = Date.parse(String(r.at || ""));
-            if (ms !== ms)
-                ms = -Infinity;
-            if (hit === null || ms >= hitMs) {
-                hit = r;
-                hitMs = ms;
-            }
-        }
+        // 行ごとの判定は Home の「使用ツール」と同じ 1 本（`liveRowVerdict`・#581）。
+        // ここに鍵の突き合わせや語の分類を書き戻すと、タイルと Home が別の判定を持つ
+        var v = liveRowVerdict(regKey, reg, rows, "reachable");
         // 🔴 **測っていない登録行が 1 つでもあれば「接続OK」と断言しない。** 1 件の OK で能力
         // 全体を「接続OK」にすると、登録したばかりで一度も測っていないチャンネルまで繋がっている
         // ことになる（この関数が直そうとしている嘘の裏返し）。ただし**ループは最後まで回す**
         // ——測定済みの失敗は事実なので、未測定の行が混ざっていても失敗は出す（下の優先順）。
         // `unknown`（測れなかった）も未測定と同じ扱い: 行は「不明」と出るが、タイルは断言しない
-        if (hit === null || (hit.status !== "ok" && bad.indexOf(hit.status) < 0)) {
+        if (v === null || v.status === "unknown") {
             unmeasured = true;
             continue;
         }
-        if (hit.status === "ok") {
-            if (hitMs >= latestMs) {
-                latestMs = hitMs;
+        var hit = v.row;
+        if (v.status === "ok") {
+            var ms = Date.parse(String(hit.at || ""));
+            if (ms !== ms)
+                ms = -Infinity;
+            if (ms >= latestMs) {
+                latestMs = ms;
                 latestAt = String(hit.at || "");
             }
             continue;
@@ -2779,6 +2803,338 @@ function derivePendingTile(regKey, registered, rows) {
         return null;
     return { kind: "ok", at: latestAt };
 }
+/**
+ * 登録行 1 つに対する、接続状態ストアの答え（#576 の行ごとの判定を切り出したもの・#581）。
+ *
+ * **タイル（`derivePendingTile`）と Home の「使用ツール」（`liveToolItems`）が同じこの
+ * 関数で行の状態を決める**——鍵の突き合わせ・複数行の勝ち方・語の分類を 2 枚にしない
+ * （`ops-ui-controls-policy.md` R10）。
+ *
+ * - 鍵は `registeredRefKeys`（登録行側）と `stateRefKey`（ストア側）の正本を使う。チャットは
+ *   ワークスペース付き／無しの 2 本（#523）。**`dev` だけ両側を小文字に畳む**——登録簿の
+ *   owner/repo とストアの ref は人が貼った URL 由来で大小が揺れる（engine の `toolState`・
+ *   撤去前の `toolStateWithLive` と同じ「github だけ大小を無視」）。`registeredRefKeys` /
+ *   `stateRefKey` 本体は触らない（`deriveCapTile` の篩＝#523 の挙動を変えない）
+ * - 当たった行が複数なら `at` が最新の 1 行（読めない `at` は最古・同値は後勝ち。#576 決定 4）
+ * - 分類は `BAD_STATE_STATUSES[question]` の 1 か所: `ok` → ok／悪い語 → bad／
+ *   それ以外（`unknown`＝測れなかった）→ unknown。**当たる行が無ければ `null`（未測定）**
+ *
+ * @param regKey `registeredNow` のキー（chat / google-chat / dev / design / materials / issues）
+ * @param reg 登録行（`registeredNow` の 1 行。まとめ表の行は `regRowOfToolItem` で同じ形にする）
+ * @param rows 接続状態ストアの行（`LIVE_STATE`）
+ * @param question 見る問い（タイルは `reachable`、Home は種別の問い＝`TILE_CAPS[*].question`）
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す。
+ * `registeredRefKeys` / `stateRefKey` / `BAD_STATE_STATUSES` はこれより前に流し込んである）。
+ */
+function liveRowVerdict(regKey, reg, rows, question) {
+    if (!reg || typeof reg !== "object")
+        return null;
+    var keys = registeredRefKeys(regKey, [reg]);
+    if (!keys)
+        return null;
+    var fold = regKey === "dev";
+    if (fold) {
+        var folded = {};
+        for (var k in keys)
+            if (Object.prototype.hasOwnProperty.call(keys, k))
+                folded[k.toLowerCase()] = true;
+        keys = folded;
+    }
+    var state = Array.isArray(rows) ? rows : [];
+    var hit = null;
+    var hitMs = -Infinity;
+    for (var j = 0; j < state.length; j++) {
+        var r = state[j];
+        if (!r || r.cap !== regKey || r.question !== question)
+            continue;
+        var key = stateRefKey(regKey, r.ref, r.workspace);
+        if (fold)
+            key = key.toLowerCase();
+        if (!key || !keys[key])
+            continue;
+        // **最新の 1 行が勝つ。** 読めない at は最古（NaN は比較で常に負けるので -Infinity に畳む）。
+        // 同値は後勝ち（`>=`）——サーバが並べた順を崩さない
+        var ms = Date.parse(String(r.at || ""));
+        if (ms !== ms)
+            ms = -Infinity;
+        if (hit === null || ms >= hitMs) {
+            hit = r;
+            hitMs = ms;
+        }
+    }
+    if (hit === null)
+        return null;
+    if (hit.status === "ok")
+        return { status: "ok", row: hit };
+    var bad = BAD_STATE_STATUSES[question] || [];
+    if (bad.indexOf(hit.status) >= 0)
+        return { status: "bad", row: hit };
+    return { status: "unknown", row: hit };
+}
+/**
+ * ライブの登録一覧から、Home の 1 種別ぶんの登録行を取り出す（#581）。
+ *
+ * 返すのは `{ reg, excluded }` の配列。**読めていなければ null**（配列でない＝その種別の
+ * 登録ファイルが読めなかった。「読めない」を「0 件」に化けさせない）。
+ * GitHub は `dev` と `devExcluded` が**両方**配列のときだけ読めたと見なす——片方しか無い
+ * 古い Lambda では、停止中（exclude）の行が `dev` に居ないので「登録から消えた」と誤読して
+ * 消してしまう（`pendingOpLiveAgrees` と同じ倒し方・設計レビュー🔴2）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function liveRegistryOf(registered, kind) {
+    var regKey = TOOL_KIND_REG[kind];
+    if (!regKey || !registered || typeof registered !== "object")
+        return null;
+    var out = [];
+    var i;
+    if (kind === "github") {
+        if (!Array.isArray(registered.dev) || !Array.isArray(registered.devExcluded))
+            return null;
+        for (i = 0; i < registered.dev.length; i++)
+            if (registered.dev[i] && typeof registered.dev[i] === "object")
+                out.push({ reg: registered.dev[i], excluded: false });
+        for (i = 0; i < registered.devExcluded.length; i++)
+            if (registered.devExcluded[i] && typeof registered.devExcluded[i] === "object")
+                out.push({ reg: registered.devExcluded[i], excluded: true });
+        return out;
+    }
+    var rows = registered[regKey];
+    if (!Array.isArray(rows))
+        return null;
+    for (i = 0; i < rows.length; i++)
+        if (rows[i] && typeof rows[i] === "object")
+            out.push({ reg: rows[i], excluded: false });
+    return out;
+}
+/**
+ * 登録行の突き合わせ鍵（Home の一覧で「同じ接続先か」を決める 1 本・#581）。
+ *
+ * `registeredRefKeys` の**ワークスペース無しの鍵**（チャットは `"\t" + ref`）を使う——
+ * 消す側の突き合わせは ref だけ（`subtractRemovedRegistered` の前例。まとめ表の workspace は
+ * engine が実測で埋めることがあり、宣言側と食い違う。誤削除は嘘・引き損ねは安全側）。
+ * **`dev` は小文字**（`liveRowVerdict` と同じ）。鍵が組めなければ空文字。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function liveToolKey(kind, reg) {
+    var regKey = TOOL_KIND_REG[kind];
+    if (!regKey || !reg || typeof reg !== "object")
+        return "";
+    var keys = registeredRefKeys(regKey, [reg]);
+    if (!keys)
+        return "";
+    var key = "";
+    if (regKey === "chat")
+        key = "\t" + String(reg.ref == null ? "" : reg.ref).trim();
+    else
+        for (var k in keys)
+            if (Object.prototype.hasOwnProperty.call(keys, k)) {
+                key = k;
+                break;
+            }
+    if (!keys[key])
+        return "";
+    return regKey === "dev" ? key.toLowerCase() : key;
+}
+/**
+ * Home の「使用ツール」に出す行を、**操作タブと同じ 3 つの材料**から作る（#581）。
+ *
+ * ## 何を直したか
+ *
+ * まとめ表（`SITE.tools`・fleet-status.json）は案件リポの `fleet-status.yml` が**毎朝 08:30 JST
+ * の schedule でしか再生成しない**ので、日中に操作タブで外した接続先（demo-sushiro）が
+ * 翌朝まで Home に残り、足した接続先は翌朝まで出なかった。**登録簿が読めた種別は登録簿が正**
+ * （消えた行は消す・無い行は足す）、状態はストアの行（`liveRowVerdict`＝タイルと同じ判定）。
+ *
+ * ## 規則（上から順）
+ *
+ * 1. `registered` が null（Lambda が古い・失敗・intake 無し）→ まとめ表の行をそのまま。
+ *    **消さない・足さない**（読めなかったことを「登録が無い」にしない）。状態だけは
+ *    同じ `liveRowVerdict` で出す（`regRowOfToolItem` で登録行の形に写す）
+ * 2. 登録簿を持たない種別（google-meet）はまとめ表の行をそのまま
+ * 3. 種別の登録簿が読めた（`liveRegistryOf` が配列）→ まとめ表の行は登録簿に当たるものだけ残す
+ *    （並びはまとめ表の順）。登録簿にしか無い行はその種別の最後の行の後ろに登録簿の順で足す
+ *    （まとめ表にその種別が無ければ末尾）。同じ鍵の行は 1 件に畳む（GitHub の issues /
+ *    discussions の 2 行）。読めなかった種別は規則 1 と同じ
+ * 4. 足す行: `label` は同じ種別のまとめ表の行の語、無ければ `TOOL_KIND_LABELS`。`name` は
+ *    登録簿の name（Slack は `#` を補う・engine と同じ）／GitHub は ref／Backlog は projectKey／
+ *    Drive は name か「共有資料フォルダ」。`url` は操作タブが既に組んでいる形を再利用できる
+ *    種別だけ（GitHub・Backlog・Figma・Drive）。Slack・Google Chat は null（ワークスペースの
+ *    ドメインが登録簿に無い）。`cap` / `question` は `TILE_CAPS`（engine の `TOOL_STORE_KEYS` と同じ表）
+ * 5. 状態: GitHub は `devExcluded` 所属なら `stopped`（まとめ表の `stopped` は引き継がない——
+ *    日中に読み取りを再開した repo を翌朝まで「停止中」と言わない）。Drive はまとめ表の
+ *    `stopped`（`enabled: false`）を引き継ぐ（登録簿に enabled が無い）。それ以外は
+ *    `liveRowVerdict`: ok → `reading`／bad → `waiting`／unknown → `unknown`。行が無ければ、
+ *    まとめ表の行は**ビルド時の state**（「不明」に化けさせない）、登録簿にしか無い行は
+ *    `pending`（「登録状況を確認中です」・操作タブの行と同じ語）
+ *
+ * @param tools `SITE.tools`（`{ version, items }`）
+ * @param registered `LIVE_REGISTERED`（仮置きを重ねた後のもの。null なら読めていない）
+ * @param rows `LIVE_STATE`
+ * @returns 描く行（まとめ表の行の形＋ `state`。足した行は `live: true`）
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す。
+ * `TOOL_KIND_REG` / `TOOL_KIND_LABELS` / `TOOL_URL_SAFE` / `TILE_CAPS` と上の 4 関数は
+ * これより前に流し込む）。
+ */
+function liveToolItems(tools, registered, rows) {
+    var items = tools && Array.isArray(tools.items) ? tools.items : [];
+    var reg = registered && typeof registered === "object" && !Array.isArray(registered) ? registered : null;
+    var questionOf = function (regKey) {
+        for (var cap in TILE_CAPS) {
+            if (Object.prototype.hasOwnProperty.call(TILE_CAPS, cap) && TILE_CAPS[cap].id === regKey)
+                return TILE_CAPS[cap].question;
+        }
+        return "reachable";
+    };
+    var stateOf = function (regKey, regRow, fallback) {
+        var v = liveRowVerdict(regKey, regRow, rows, questionOf(regKey));
+        if (!v)
+            return fallback;
+        if (v.status === "ok")
+            return "reading";
+        if (v.status === "bad")
+            return "waiting";
+        return "unknown";
+    };
+    var out = [];
+    var kept = {};
+    var labels = {};
+    var i;
+    for (i = 0; i < items.length; i++) {
+        var it = items[i];
+        if (!it)
+            continue;
+        var kind = String(it.kind == null ? "" : it.kind);
+        var regKey = TOOL_KIND_REG[kind] || "";
+        if (it.label && !labels[kind])
+            labels[kind] = String(it.label);
+        var live = reg ? liveRegistryOf(reg, kind) : null;
+        var stopped = it.state === "stopped";
+        var regRow = regRowOfToolItem(it);
+        // ストアに行が無いときの値（ビルド時の state）
+        var fallback = String(it.state || "unknown");
+        var key = live ? liveToolKey(kind, regRow) : "";
+        // **鍵が組めないまとめ表の行は消さない**（分からないものは落とさない・`registeredRefKeys` と同じ倒し方）
+        if (live && key) {
+            // 登録簿が正。当たる行が無ければ消えた（規則 3）
+            var match = null;
+            for (var m = 0; m < live.length; m++) {
+                if (liveToolKey(kind, live[m].reg) === key) {
+                    match = live[m];
+                    break;
+                }
+            }
+            if (!match)
+                continue;
+            if (!kept[kind])
+                kept[kind] = {};
+            kept[kind][key] = true;
+            // 停止中の正本（規則 5）: GitHub は登録簿、Drive はまとめ表、他の種別に停止中は無い。
+            // 🔴 **読み取りを再開した repo（まとめ表は stopped・登録簿は dev）は、ストアに行が無くても
+            // 「停止中」に戻さない**——engine が stopped でない行に置くビルド時の値は unknown（実装レビュー🔴1）
+            if (kind === "github") {
+                stopped = match.excluded;
+                if (!stopped && fallback === "stopped")
+                    fallback = "unknown";
+            }
+            regRow = Object.assign({}, match.reg);
+            // まとめ表の Slack 行が持つワークスペースを登録行が持たなければ補う（実装レビュー🟡3）。
+            // 登録簿は宣言に workspace があるときだけ載せるので、無いままだとワークスペース付きの
+            // ストア行に当たらず、ライブが届いた瞬間に「読み取り中」が「未確認」へ退化する
+            if (kind === "slack" && !regRow.workspace && it.workspace)
+                regRow.workspace = String(it.workspace);
+        }
+        // 登録簿を持たない種別（google-meet）も、ストアの行（cap=meetings / ingested）は同じ判定で重ねる
+        var stateKey = regKey || String(it.cap == null ? "" : it.cap);
+        var st = stopped ? "stopped" : !stateKey ? fallback : stateOf(stateKey, regRow, fallback);
+        out.push(Object.assign({}, it, { state: st }));
+    }
+    if (!reg)
+        return out;
+    // 登録簿にしか無い行を、種別ごとにまとめ表の最後の行の後ろへ（規則 3〜4）
+    var kinds = ["backlog", "github", "slack", "google-chat", "figma", "google-drive"];
+    for (var ki = 0; ki < kinds.length; ki++) {
+        var k2 = kinds[ki];
+        var live2 = liveRegistryOf(reg, k2);
+        if (!live2)
+            continue;
+        var regKey2 = TOOL_KIND_REG[k2];
+        var seen = kept[k2] || {};
+        var added = [];
+        for (var a = 0; a < live2.length; a++) {
+            var r2 = live2[a].reg;
+            var key2 = liveToolKey(k2, r2);
+            if (!key2 || seen[key2])
+                continue;
+            seen[key2] = true;
+            var ref = "";
+            var name = "";
+            var url = null;
+            if (k2 === "slack") {
+                ref = String(r2.ref).trim();
+                var raw = String(r2.name || ref).trim();
+                name = raw.charAt(0) === "#" ? raw : "#" + raw;
+            }
+            else if (k2 === "google-chat") {
+                ref = String(r2.ref).trim();
+                name = String(r2.name || ref).trim();
+            }
+            else if (k2 === "github") {
+                ref = String(r2.ref).trim();
+                name = ref;
+                if (TOOL_URL_SAFE.test(ref) && ref.split("/").length === 2)
+                    url = "https://github.com/" + ref;
+            }
+            else if (k2 === "figma") {
+                ref = String(r2.key).trim();
+                name = String(r2.name || ref).trim();
+                if (TOOL_URL_SAFE.test(ref) && ref.indexOf("/") < 0)
+                    url = "https://www.figma.com/design/" + ref;
+            }
+            else if (k2 === "google-drive") {
+                ref = String(r2.id).trim();
+                name = String(r2.name || "").trim() || "共有資料フォルダ";
+                if (TOOL_URL_SAFE.test(ref) && ref.indexOf("/") < 0)
+                    url = "https://drive.google.com/drive/folders/" + ref;
+            }
+            else {
+                var domain = String(r2.domain).trim();
+                var pk = String(r2.projectKey).trim();
+                ref = issuesRefOf(domain, pk);
+                name = pk;
+                if (TOOL_URL_SAFE.test(domain) && domain.indexOf("/") < 0 && TOOL_URL_SAFE.test(pk) && pk.indexOf("/") < 0)
+                    url = "https://" + domain + "/projects/" + pk;
+            }
+            added.push({
+                kind: k2,
+                label: labels[k2] || TOOL_KIND_LABELS[k2] || k2,
+                name: name,
+                url: url,
+                note: "",
+                cap: regKey2,
+                question: questionOf(regKey2),
+                ref: ref,
+                workspace: k2 === "slack" ? String(r2.workspace == null ? "" : r2.workspace) : "",
+                state: live2[a].excluded ? "stopped" : stateOf(regKey2, r2, "pending"),
+                live: true,
+            });
+        }
+        if (!added.length)
+            continue;
+        var at = -1;
+        for (var o = 0; o < out.length; o++)
+            if (out[o].kind === k2)
+                at = o;
+        if (at < 0)
+            out = out.concat(added);
+        else
+            out = out.slice(0, at + 1).concat(added, out.slice(at + 1));
+    }
+    return out;
+}
 function capabilityState(cap, ctx, adapter) {
     // **能力→パイプラインの対応はここに持つ。** 呼び出し側に渡させると、
     // クライアント側（この関数を .toString() で受け取る側）が同じ表を書き写すことになり、
@@ -4777,7 +5133,6 @@ ${overlayStateOnFleet.toString()}
   // 🔴 この定数行を落とすと、流し込んだ描画がアイコンを引けずに素の kind を出す
 var TOOL_KIND_ICONS = ${JSON.stringify(TOOL_KIND_ICONS)};
 ${toolStateLabel.toString()}
-${toolStateWithLive.toString()}
   // 畳んだ種別の 1 行に出す状態の要約（#424）。**同じ 4 語を使う**——ここで別の言い方を
   // 作ると、畳んだ 1 行と開いた行が違う語で同じ状態を指す
 ${toolsFoldSummary.toString()}
@@ -4816,6 +5171,18 @@ ${deriveCapTile.toString()}
   // 登録直後のタイル（#576）。**registeredRefKeys / stateRefKey / BAD_STATE_STATUSES より後に置く**
   //（上の 3 つを引く。前に置くと var の BAD_STATE_STATUSES が undefined で判定が丸ごと死ぬ）
 ${derivePendingTile.toString()}
+  // Home の「使用ツール」をライブの登録一覧＋ストアで描く（#581）。**行ごとの判定
+  // （liveRowVerdict）はタイル（derivePendingTile）と共有**——registeredRefKeys / stateRefKey /
+  // BAD_STATE_STATUSES / TILE_CAPS より後に置く。🔴 下の 3 つの定数行を落とすと、流し込んだ
+  // liveToolItems が未定義を参照して Home の描画が丸ごと死ぬ
+var TOOL_KIND_REG = ${JSON.stringify(TOOL_KIND_REG)};
+var TOOL_KIND_LABELS = ${JSON.stringify(TOOL_KIND_LABELS)};
+var TOOL_URL_SAFE = new RegExp(${JSON.stringify(TOOL_URL_SAFE.source)});
+${regRowOfToolItem.toString()}
+${liveRowVerdict.toString()}
+${liveRegistryOf.toString()}
+${liveToolKey.toString()}
+${liveToolItems.toString()}
   // 案件カレンダー（#428）。**判定の実体はビルド時の定義**——画面側に書き写すと、
   // 「作成済みか」の判定が 2 枚になって片方だけ直る（＝2 本目のカレンダーを作らせる）。
   // 🔴 **BAD_STATE_STATUSES より後に置く。** calendarPhase が「悪い」語をそこから引く
@@ -6315,13 +6682,78 @@ ${calendarAddUrl.toString()}
   }
 
   /**
-   * Home の「使用ツール」（#275）。engine が登録簿 7 種から算出した SITE.tools を描く。
+   * Home の「使用ツール」に、ライブの登録一覧（「LIVE_REGISTERED」）へ仮置き（#388）を重ねた
+   * 登録簿を渡す（#581）。「pendingTileVerdict」 と同じ材料を見る:
+   *
+   * - **remove で live に在る行は外す・add で live に無い行は足す。** Lambda の 「registeredNow」
+   *   は据え置き（保存直後の 1 回だけ迂回）なので、外した直後に Home を再読み込みすると
+   *   据え置きの古い一覧を読む窓がある——仮置きを重ねないと「操作タブでは消えたのに Home には
+   *   まだ在る」が最大 1 分並ぶ
+   * - 足す行は 「pendingExternalRow」（Slack のワークスペースは 「slackOrg」 から展開される）。
+   *   figma / drive / backlog は payload から登録行の形に組む
+   * - update（通知先トグル等）は行の有無に関わらないので何もしない
+   * - 「LIVE_REGISTERED」 が null なら null のまま（仮置きだけで一覧を作らない・規則 1）
+   *
+   * 既知の限界（「pendingTileVerdict」 と同じ）: GitHub の remove は 「targetId」 が小文字で
+   * 「pendingLiveRowMatches」 は生値一致なので、混在綴りの repo は据え置きの窓のあいだ消えない
+   */
+  function registryForHome() {
+    if (!LIVE_REGISTERED) return null;
+    var ops = pendingOpsNow();
+    if (!ops.length) return LIVE_REGISTERED;
+    var reg = Object.assign({}, LIVE_REGISTERED);
+    for (var i = 0; i < ops.length; i++) {
+      var e = ops[i];
+      var km = e && PENDING_KINDS[e.kind];
+      if (!km || !Array.isArray(reg[km.reg])) continue;
+      var rows = reg[km.reg];
+      var found = null;
+      for (var k = 0; k < rows.length; k++) {
+        if (pendingLiveRowMatches(e.kind, rows[k], e.targetId)) { found = rows[k]; break; }
+      }
+      // 停止中（devExcluded）の GitHub 行を「登録から削除」した直後は、その行は dev ではなく
+      // devExcluded に居る。こちらも外さないと据え置きの窓のあいだ「停止中」が残る（実装レビュー🟡4）
+      if (e.action === "remove" && e.kind === "github" && Array.isArray(reg.devExcluded)) {
+        reg.devExcluded = reg.devExcluded.filter(function (r) { return !pendingLiveRowMatches(e.kind, r, e.targetId); });
+      }
+      if (e.action === "remove" && found) {
+        reg[km.reg] = rows.filter(function (r) { return r !== found; });
+      } else if (e.action === "add" && !found) {
+        var p = e.payload || {};
+        var row;
+        if (e.kind === "figma") row = { key: e.targetId, name: p.name || "" };
+        else if (e.kind === "drive") row = { id: e.targetId, name: p.name || "" };
+        else if (e.kind === "backlog") row = { domain: p.domain || "", projectKey: p.projectKey || "" };
+        else row = pendingExternalRow(e);
+        reg[km.reg] = rows.concat([row]);
+      }
+    }
+    return reg;
+  }
+
+  /**
+   * いま Home に出す「使用ツール」の行（#581）。**判定は 「liveToolItems」 の 1 か所**——
+   * まとめ表（「SITE.tools」）を初期表示に、ライブの登録一覧（仮置き込み）と接続状態ストアが
+   * 届いていれば、消えた行は消し・足した行は足し・状態はタイルと同じ行ごとの判定で出す。
+   * 届く前（先読みが飛行中・intake 無し）は 「LIVE_REGISTERED」 が null なので、まとめ表の
+   * 行がそのまま出る
+   */
+  function homeToolsItemsNow() {
+    return liveToolItems(SITE.tools, registryForHome(), LIVE_STATE);
+  }
+
+  /**
+   * Home の「使用ツール」（#275）。engine が登録簿 7 種から算出した SITE.tools を初期表示に、
+   * ライブの登録一覧＋接続状態ストア（「homeToolsItemsNow」・#581）で描く。
    *
    * 🔴 **SITE.tools が無ければ何も出さない。** 生成が古い案件（この項目を知らない
    * fleet-status.json）では、手書きの節が本文に残っているので、そちらがそのまま出る
    * ——ここで「まだ接続していません」と出すと、繋いである案件に嘘を出すことになる。
+   * ライブだけで節を出すことはしない（手書きの節との重複回避 「dropLegacyHomeSections」 と
+   * 衝突する）。効くのは「SITE.tools はあるが古い」案件
    *
-   * **0 件は 1 行で言い切る。** 空の一覧を出すと「読み込み中」に見える。
+   * **0 件は 1 行で言い切る。** 空の一覧を出すと「読み込み中」に見える。ライブで全部消えて
+   * 0 件になった場合も同じ 1 行
    */
   function homeToolsSection() {
     var t = SITE.tools;
@@ -6330,7 +6762,7 @@ ${calendarAddUrl.toString()}
     if (!t || !Array.isArray(t.items)) return null;
     var box = el("section", { class: "home-tools" });
     box.appendChild(el("h2", { class: "home-grounding-title", text: "使用ツール" }));
-    var items = t.items || [];
+    var items = homeToolsItemsNow();
     if (!items.length) {
       // 「操作タブ」はその場で移れる口にする（文言は変えない・#424）
       box.appendChild(el("p", { class: "home-tools-empty" }, [
@@ -6368,12 +6800,12 @@ ${calendarAddUrl.toString()}
       if (!ul) { ul = el("ul", { class: "home-tools-list" }); box.appendChild(ul); }
       g.items.forEach(function (it) { ul.appendChild(homeToolRow(it)); });
     });
-    // **どこで直せるか・いつの情報かを 1 行で言う。** 操作タブで繋いだ直後は
-    // この一覧に出ない（engine が毎朝作り直すまで）ので、黙っていると「効いていない」と読まれる
+    // **どこで直せるかを 1 行で言う。** 「（この一覧は毎朝更新されます）」は #581 で落とした
+    // ——一覧はライブの登録一覧で描くので、操作タブで足した・外した行はその場で出る・消える
     box.appendChild(el("p", { class: "home-tools-note" }, [
       document.createTextNode("接続の追加・変更は"),
       opsTabLink("操作タブ"),
-      document.createTextNode("で行います（この一覧は毎朝更新されます）。"),
+      document.createTextNode("で行います。"),
     ]));
     return box;
   }
@@ -6389,13 +6821,15 @@ ${calendarAddUrl.toString()}
       text: (TOOL_KIND_ICONS[it.kind] || "🔗") + " " + (it.label || it.kind),
     }));
     var name = it.name || it.ref || "";
-    // **開ける先が無い行（Google Meet）はリンクにしない。** 押せないリンクを出すより
-    // 素のテキストのほうが正直（url は engine が null で「無い」と言い切っている）
+    // **開ける先が無い行はリンクにしない。** 押せないリンクを出すより素のテキストのほうが
+    // 正直（url は engine が null で「無い」と言い切っている）。Google Meet の行も
+    // 案件カレンダーができていれば url を持つ（cortex-engine #343。カレンダーがまだ無い案件は null）
     // href に載せる前に isHttp を通す（build 側の許可リストと二重の守り。el() の注意書きのとおり）
     if (it.url && isHttp(it.url)) li.appendChild(el("a", { class: "home-tools-name", href: it.url, target: "_blank", rel: "noopener", text: name }));
     else li.appendChild(el("span", { class: "home-tools-name", text: name }));
-    // ライブの実測が届いていれば重ねる（stopped は上書きしない・toolStateWithLive）
-    var st = toolStateWithLive(it, LIVE_STATE);
+    // 状態は 「liveToolItems」 が決めてある（#581）。**ここで判定し直さない**——タイルと同じ
+    // 行ごとの判定（liveRowVerdict）から出た値を語に変えるだけ
+    var st = String(it.state || "unknown");
     var lab = toolStateLabel(st);
     var chip = el("span", { class: "home-tools-state ds-gate " + lab.cls, text: lab.text });
     // 状態そのものを属性に残す（表示語を読み替えずに検査・スタイルできるように）
@@ -6430,8 +6864,8 @@ ${calendarAddUrl.toString()}
     // ⚠ **id に使うので、種別の字をそのまま持ち込まない。** kind は fleet-status.json 由来で、
     // 空白の入った値が来ると id が2つの idref に読まれ、aria-controls の対応が壊れる
     var key = (String(kind).replace(/[^A-Za-z0-9_-]/g, "") || "other") + "-" + seq;
-    // 状態は 1 行ずつ求めてから畳む（行と要約が別の判定を持たない）
-    var sum = toolsFoldSummary(group.map(function (it) { return toolStateWithLive(it, LIVE_STATE); }));
+    // 状態は行に決めてあるものを畳む（行と要約が別の判定を持たない・#581）
+    var sum = toolsFoldSummary(group.map(function (it) { return String(it.state || "unknown"); }));
     var chip = el("span", { class: "home-tools-fold-state ds-gate " + sum.cls, text: sum.text });
     chip.setAttribute("data-state", sum.state);
     // 説明として読ませるので id が要る

package/package.json

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