@takagaki/cortex-decisions-viewer 0.12.33 → 0.12.35

package/dist/build.js

@@ -297,6 +297,16 @@ async function findProjectIcon(knowledgeRoot) {
  * ——「朝は正しいのに、開いて数秒すると表示が変わる」という一番気づきにくい食い違いになる。
  */
 const SECRET_SPACE_STATES = ["new", "legacy", "false"];
+/**
+ * 使っているツールの種別と状態の語彙（engine の `project-tools.mjs` の
+ * TOOL_KINDS / TOOL_STATES と**同じ並び・同じ語**）。
+ *
+ * 🔴 **知らない語の行は落とす。** 画面は kind でアイコンを、state で表示語を引くので、
+ * 知らない語を通すと「アイコンも状態も無い行」が並ぶ——engine が語を増やした日に、
+ * 顧客の画面が壊れて見える。落とせばその行が出ないだけで、他の行は今までどおり出る。
+ */
+const TOOL_KINDS = ["backlog", "github", "slack", "google-chat", "figma", "google-drive", "google-meet"];
+const TOOL_STATES = ["reading", "waiting", "stopped", "unknown"];
 /**
  * リポジトリルートの fleet-status.json から externalSources / internalSources / pipelines を読む。
  * ファイルが無い・パース不能・当該フィールドが無い場合は undefined を返し、
@@ -476,8 +486,56 @@ async function readFleetSources(repoRoot) {
             applicable: typeof p.applicable === "boolean" ? p.applicable : undefined,
         }))
         : undefined;
-    // **宣言（tools）は読まない（#125 ⑤）。** engine が出力から落としたので、
-    // 残っているのは再生成前の古いスナップショットだけ。読まずに捨てる。
+    // 案件が使っているツール（engine が登録簿 7 種から算出・#275）。
+    //
+    // **同じ `tools` という名前で、昔は能力→ツールの「宣言マップ」が入っていた**（#125 ⑤ で
+    // engine が出力から落とした）。艦隊には再生成前の古いスナップショットが残っていて、
+    // そこには `{ 開発: "github" }` のような**版を持たない別の形**が入っている。
+    // だから **version で見分ける**——`version: 1` でなければ、宣言マップも未知の新形式も
+    // 同じく「読まない」に倒れる。
+    //
+    // **知らないフィールドは黙って捨てる（明示の許可リスト）。** この JSON は engine が
+    // 単独で版を上げるので、画面が知らないキーは必ず先に入る。素通しにすると、
+    // 認証情報の伏せ字処理を通していない値が顧客の画面へ黙って流れる。
+    let tools;
+    if (obj.tools != null) {
+        const t = typeof obj.tools === "object" && !Array.isArray(obj.tools) ? obj.tools : null;
+        if (!t || t.version !== 1) {
+            // **1 行だけ残す。** 静かに消えると「engine が出していない」のか
+            // 「出しているが画面が読めていない」のかが切り分けられない
+            console.warn(`fleet-status.json の tools が未対応の形です（使用ツールの一覧は出しません）: version=${String(t ? t.version : typeof obj.tools)}`);
+        }
+        else if (!Array.isArray(t.items)) {
+            console.warn(`fleet-status.json の tools.items が配列ではありません（使用ツールの一覧は出しません）: ${typeof t.items}`);
+        }
+        else {
+            const items = t.items
+                .filter((x) => x != null && typeof x === "object" && !Array.isArray(x))
+                .map((x) => ({
+                // **短縮記法にしないこと。** fleet-passthrough のテストが「画面が読むフィールドを
+                // build.ts が受け渡しているか」を `名前:` の字面で走査している
+                kind: String(x.kind ?? ""),
+                label: String(x.label ?? ""),
+                name: String(x.name ?? ""),
+                // 🔴 **url だけは null を保つ。** 「開ける先が無いと分かっている」（Google Meet）を
+                // 空文字に潰すと、画面が「名前もURLも空の行」と区別できなくなる
+                // **https?:// 以外は null に落とす。** fleet-status.json は案件リポにコミットされる
+                // ファイルなので、engine の導出以外（手編集・古い生成物）でも中身を書ける。
+                // `javascript:` のような値をそのまま href に載せない（el() の注意書きと同じ作法）
+                url: typeof x.url === "string" && /^https?:\/\//.test(x.url) ? x.url : null,
+                note: String(x.note ?? ""),
+                cap: String(x.cap ?? ""),
+                question: String(x.question ?? ""),
+                ref: String(x.ref ?? ""),
+                workspace: String(x.workspace ?? ""),
+                state: String(x.state ?? ""),
+            }))
+                .filter((x) => TOOL_KINDS.indexOf(x.kind) >= 0 && TOOL_STATES.indexOf(x.state) >= 0);
+            // **items が 0 件でも器は通す。** 「まだ 1 つも接続が無い」（接続の導線を出す）と
+            // 「この項目を知らない古い生成物」（何も出さない）は別の状態
+            tools = { version: 1, items: items, paragraph: String(t.paragraph ?? "") };
+        }
+    }
     // 能力ごとの導出済みの状態（#125①が載せ、#125②で画面の正本になった）。
     //
     // **列挙し忘れは静かに消える。** このマッピングは素通しではなく明示の許可リストで、
@@ -585,7 +643,7 @@ async function readFleetSources(repoRoot) {
         if (Object.keys(out).length)
             secretSpaces = out;
     }
-    return { externalSources, slackWorkspaces, internalSources, pipelines, capabilities, fleetGeneratedAt, secretSources, secretSpaces, checks, githubOwners, backlogTarget };
+    return { externalSources, slackWorkspaces, internalSources, pipelines, capabilities, fleetGeneratedAt, secretSources, secretSpaces, checks, githubOwners, backlogTarget, tools };
 }
 /**
  * AIからの更新提案（`.cortex/gold-proposals.json`）を読む。
@@ -731,7 +789,10 @@ function isUnwritten(body) {
  *
  * @returns sections … 最上部に出す節（新形式・旧形式のどちらでも拾う）
  *          unfilled … 案件の概要・ゴールが未記入か（警告カードを出すか）
- *          restHtml … 自己記述と旧説明を除いた残りの本文（使用ツール等）
+ *          restHtml … 自己記述と旧説明を除いた残りの本文（案件ごとに書き足された節）。
+ *            手書きの「使用ツール」節もここに残る——**落とすのは画面側**（#275）。
+ *            engine が `tools` を載せている案件でだけ落とす判断なので、
+ *            `SITE.tools` を知らないここでは決められない
  */
 async function buildHomeGrounding(rawMarkdown) {
     const content = (0, gray_matter_1.default)(rawMarkdown).content;
@@ -1837,6 +1898,9 @@ async function build(opts) {
         checks: fleet.checks,
         githubOwners: fleet.githubOwners,
         backlogTarget: fleet.backlogTarget,
+        // 使っているツール（engine が登録簿から算出・#275）。**短縮記法にしないこと**
+        // ——fleet-passthrough のテストが `名前:` の字面で受け渡しを走査している
+        tools: fleet.tools,
         // **undefined ならキーごと出さない**——画面は
         // 「アイコンがある／無い」をキーの有無で見る（空の器を通さない）
         projectIcon: projectIcon ? { file: projectIcon.file, repoPath: projectIcon.repoPath } : undefined,

package/dist/render.js

@@ -9,6 +9,9 @@ exports.isRepositorySlug = isRepositorySlug;
 exports.devRepositoryRefs = devRepositoryRefs;
 exports.claudeCodeRepositories = claudeCodeRepositories;
 exports.claudeCodeUrl = claudeCodeUrl;
+exports.toolStateLabel = toolStateLabel;
+exports.toolStateWithLive = toolStateWithLive;
+exports.toolsFoldSummary = toolsFoldSummary;
 exports.isAlreadyRegistered = isAlreadyRegistered;
 exports.sanitizeRegisteredNow = sanitizeRegisteredNow;
 exports.sanitizeStateNow = sanitizeStateNow;
@@ -61,7 +64,9 @@ function renderSite(site, assets) {
         : "";
     // 組み立ての正本は claudeCodeUrl 1か所（#404）。ここは薄い包みに留める。
     // `?? []` は必須——build.ts は fleet-status.json が無い案件で externalSources を持たない
-    const codeUrl = (prompt) => claudeCodeUrl(prompt, repoSlug, site.externalSources ?? []);
+    // 第4引数は使っているツールの段落（#275）。**7導線すべてに同じ段落を付ける**ため、
+    // 渡す場所も codeUrl 1か所に寄せる（クライアント側の codeUrl と対）
+    const codeUrl = (prompt) => claudeCodeUrl(prompt, repoSlug, site.externalSources ?? [], site.tools && site.tools.paragraph);
     /** ヘッダー「AIに聞く」の指示文。data-ai-prompt に同じ値を残し、接続状況が届いたら href を組み直す */
     const ASK_PROMPT = "このプロジェクトの概要について教えてください。";
     const askUrl = codeUrl(ASK_PROMPT);
@@ -452,12 +457,138 @@ function claudeCodeRepositories(projectRepo, devRefs) {
  *
  * repositories はカンマ区切りで**素のまま**載せる（公式の例がその形で、スラッシュも
  * エンコードしない）。指示文だけ encodeURIComponent する。
+ *
+ * `toolsParagraph`（#275）は「この案件が使っているツール: …」の 1 段落。非空なら
+ * **指示文の先頭に付ける**。7 導線すべてがこの 1 関数を通るので、ここに置くだけで
+ * どのボタンから開いても AI が最初に案件の道具立てを知る——**呼び出し側で足さないこと**
+ * （足すと、足し忘れたボタンだけ文脈の無い起動になる）。
+ * `data-ai-prompt` には元の指示文を残す（貼り替えもこの関数を通るので段落は保たれる）。
  */
-function claudeCodeUrl(prompt, projectRepo, externals) {
+function claudeCodeUrl(prompt, projectRepo, externals, toolsParagraph) {
     var repos = claudeCodeRepositories(projectRepo, devRepositoryRefs(externals));
     if (!repos.length)
         return CLAUDE_CODE_HOME;
-    return "https://claude.ai/code?repositories=" + repos.join(",") + "&prompt=" + encodeURIComponent(prompt);
+    var text = toolsParagraph ? String(toolsParagraph) + "\n\n" + prompt : prompt;
+    return "https://claude.ai/code?repositories=" + repos.join(",") + "&prompt=" + encodeURIComponent(text);
+}
+// ---------------------------------------------------------------------------
+// Home の「使用ツール」（engine #275）— 一覧は engine が登録簿から算出した `SITE.tools`
+//
+// **ビューアは登録簿（channels.json 等）を読まない。** 読むと「使っていると言う条件」が
+// engine と画面で 2 枚になり、片方だけ直った日から一覧と AI の起動文が食い違う
+// （viewer/test/no-registry-read.test.mjs が見張っている）。
+// ---------------------------------------------------------------------------
+/**
+ * 種別のアイコン。**DS_TYPE（データソース一覧）と同じ絵柄にそろえる**——同じツールが
+ * 2 つの画面で違う顔をしていると、同じものだと分からない。
+ */
+const TOOL_KIND_ICONS = {
+    "backlog": "📋",
+    "github": "🐙",
+    "slack": "💬",
+    "google-chat": "💬",
+    "figma": "🎨",
+    "google-drive": "📁",
+    "google-meet": "🎥",
+};
+/**
+ * 状態の表示語と色。**4 語しか出さない**（読み取り中／承認待ち／停止中／未確認）。
+ *
+ * 色は既存の `ds-gate-*` を流用する——同じ画面で「緑＝読めている・橙＝人の操作待ち・
+ * 灰＝分からない」の意味を 2 通りに増やさない。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function toolStateLabel(state) {
+    if (state === "reading")
+        return { text: "読み取り中", cls: "ds-gate-ok" };
+    if (state === "waiting")
+        return { text: "承認待ち", cls: "ds-gate-warn" };
+    // 止めているものは警告色にしない（直す必要が無いので、橙にすると直しに行かせてしまう）
+    if (state === "stopped")
+        return { text: "停止中", cls: "ds-gate-muted" };
+    return { text: "未確認", cls: "ds-gate-muted" };
+}
+/**
+ * ビルド時の状態に、接続状態ストアの実測（`stateNow`）を重ねた state を返す。
+ *
+ * 🔴 **`stopped` は上書きしない。** 止めているのは登録簿から決まる事実で、
+ * ストアが「届く」と答えても読み取っていない。**止めたものを「読み取り中」と言わない**。
+ *
+ * 🔴 **突き合わせの鍵は行が自分で持っている**（cap + question + ref、Slack だけ workspace）。
+ * ここで種別ごとの if 連鎖を書き直すと、engine の書き手（connection-state-write-*）と
+ * 鍵の作り方が 2 枚になる。**github だけ大小を無視する**——登録簿の owner/repo と
+ * ストアの ref は、人が貼った URL 由来で大小が揺れる。
+ *
+ * 行が無ければビルド時の値のまま（**「不明」に化けさせない**——夜間が測った結果を
+ * ライブが答えなかっただけで消すと、朝には出ていたものが消える）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.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";
+}
+/**
+ * 畳んだ種別の 1 行に出す、状態の要約（#424）。
+ *
+ * **全部同じなら、その 1 語だけ**（「GitHub 7 件 ● 読み取り中」）。畳んだ 1 行に
+ * 「読み取り中 7」と件数を書いても、左に出ている 7 件と同じ数を 2 回言うだけになる。
+ *
+ * **混ざっていれば件数で**（「読み取り中 5・承認待ち 2」）。ここで「一部が承認待ち」の
+ * ような曖昧な言い方にすると、開くまで何件手を入れるのか分からない。
+ *
+ * 色は `toolStateLabel` の `ds-gate-*` をそのまま使う。混ざっているときは
+ * **承認待ちが 1 件でもあれば橙**——畳んだ 1 行が「人の操作待ちを含む」ことを、
+ * 開かずに見つけられる必要がある（畳んだせいで気づかれなくなる、が一番痛い）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function toolsFoldSummary(states) {
+    // 表示の順は状態の 4 語と同じ（読み取り中→承認待ち→停止中→未確認）
+    var order = ["reading", "waiting", "stopped", "unknown"];
+    var count = { reading: 0, waiting: 0, stopped: 0, unknown: 0 };
+    (states || []).forEach(function (s) {
+        // ⚠ 4 語のどれかに当たるかは **order で見る**（素のオブジェクトの添字だと
+        // "constructor" のような語が継承プロパティに当たって、知らない語が素通りする）
+        var k = String(s == null ? "" : s);
+        count[order.indexOf(k) < 0 ? "unknown" : k] += 1;
+    });
+    var used = order.filter(function (k) { return count[k] > 0; });
+    if (used.length <= 1) {
+        var lab = toolStateLabel(used[0] || "unknown");
+        return { text: lab.text, cls: lab.cls, state: used[0] || "unknown" };
+    }
+    var text = used
+        .map(function (k) { return toolStateLabel(k).text + " " + count[k]; })
+        .join("・");
+    return { text: text, cls: count.waiting > 0 ? "ds-gate-warn" : "ds-gate-muted", state: "mixed" };
 }
 /**
  * 外部ソースの行が「この能力・このアダプタのタイル」に属するか。
@@ -2702,6 +2833,49 @@ button.site-icon[aria-busy="true"] .site-icon-plus { opacity: 0; }
   padding-bottom: 6px; border-bottom: 1px solid var(--border);
 }
 .home-grounding > .home-grounding-title:first-child { margin-top: 0; }
+/* ---- Home の「使用ツール」（engine が登録簿から算出・#275）----
+   自己記述の直後に出る一覧。**本文より目立たせない**——案件の説明を押しのけない。
+   状態チップは操作タブと同じ .ds-gate 系を使う（同じ意味の色を2通りに増やさない） */
+.home-tools { margin: 0 0 8px; }
+.home-tools-list { list-style: none; margin: 8px 0 0; padding: 0; }
+.home-tools-item {
+  display: flex; flex-wrap: wrap; gap: 6px 12px; align-items: center;
+  padding: 7px 0; border-bottom: 1px solid var(--border); font-size: 13.5px;
+}
+.home-tools-item:last-child { border-bottom: none; }
+/* 種別は幅をそろえて縦に読めるようにする（名前の頭が段違いだと一覧に見えない） */
+.home-tools-kind { flex: 0 0 auto; min-width: 9.5em; font-weight: 600; color: var(--muted); }
+.home-tools-name { flex: 1 1 220px; min-width: 0; word-break: break-all; }
+.home-tools-state { flex: 0 0 auto; }
+.home-tools-empty, .home-tools-note { font-size: 12.5px; color: var(--muted); line-height: 1.7; margin: 8px 0 0; }
+/* 種別ごとの折りたたみ（3件以上・#424）。**畳んだ1行は、行と同じ高さ・同じ字の大きさ**
+   ——一覧の途中に「見出し」が生えたように見せない。既定は畳む（open を付けない） */
+.home-tools-fold { margin: 8px 0 0; }
+.home-tools-fold > summary {
+  display: flex; flex-wrap: wrap; gap: 6px 12px; align-items: center;
+  padding: 7px 0; border-bottom: 1px solid var(--border); font-size: 13.5px;
+  cursor: pointer; list-style: none;
+}
+.home-tools-fold > summary::-webkit-details-marker { display: none; }
+/* アイコンは別の span（読み上げから外すため）。畳まない行の種別と同じ字面にそろえる */
+.home-tools-fold-icon { flex: 0 0 auto; }
+.home-tools-fold-label { flex: 0 0 auto; font-weight: 600; color: var(--muted); }
+/* 状態は行と同じく右端へ寄せる。**縦にそろっていないと一覧に見えない**
+   （畳んだ1行だけ状態が真ん中にあると、同じ列の情報だと分からない） */
+.home-tools-fold-state { flex: 0 0 auto; margin-left: auto; }
+/* 開閉の印は CSS の content で出す（.ds-group と同じ形）。**要素にしない**——
+   読み上げ名を「GitHub 7 件」だけにしたいので、文字として DOM に置かない */
+.home-tools-fold > summary::after { content: "▸"; margin-left: 8px; color: var(--muted); font-size: 12px; }
+.home-tools-fold[open] > summary::after { content: "▾"; }
+/* 開いた中身は少し寄せて、畳んだ1行との親子が見えるようにする */
+.home-tools-fold > .home-tools-list { margin: 0 0 0 12px; padding-left: 10px; border-left: 2px solid var(--border); }
+/* 畳んだ1行が後ろに続くとき・開いた中身の後ろに行が続くときは、その手前の行にも
+   区切り線を引く。.home-tools-item:last-child で線を落としたままだと、**境目だけ
+   線が抜けて** 2行が1行に見える（畳みが無い案件の見た目は変えない）。
+   :has が効かない環境では、その境目の線が1本消えるだけ（並びも文言も無事） */
+.home-tools-list:has(+ .home-tools-fold) > .home-tools-item:last-child,
+.home-tools-fold:has(+ .home-tools-list) > .home-tools-list > .home-tools-item:last-child,
+.home-tools-fold:has(+ .home-tools-fold) > .home-tools-list > .home-tools-item:last-child { border-bottom: 1px solid var(--border); }
 /* ---- レコード詳細の「AIによる最近の変更」（リポジトリの git 履歴 由来）----
    カードは詳細ページの提案（.proposals）と同系色にする——どちらも
    「AIがやったこと・言っていることを読む」もので種類が同じ。
@@ -3689,6 +3863,18 @@ var STATE_STATUSES = ${JSON.stringify(STATE_STATUSES)};
 var STATE_ROW_FIELDS = ${JSON.stringify(STATE_ROW_FIELDS)};
 ${sanitizeStateNow.toString()}
 ${overlayStateOnFleet.toString()}
+  // Home の「使用ツール」（#275）。**判定と表示語の実体はビルド時の定義**——
+  // 画面側に書き写すと、状態の言い換えが 2 枚になって片方だけ直る。
+  // 🔴 この定数行を落とすと、流し込んだ描画がアイコンを引けずに素の kind を出す
+var TOOL_KIND_ICONS = ${JSON.stringify(TOOL_KIND_ICONS)};
+${toolStateLabel.toString()}
+${toolStateWithLive.toString()}
+  // 畳んだ種別の 1 行に出す状態の要約（#424）。**同じ 4 語を使う**——ここで別の言い方を
+  // 作ると、畳んだ 1 行と開いた行が違う語で同じ状態を指す
+${toolsFoldSummary.toString()}
+  // 🔴 **同じ種別が何件あったら畳むか。** 1 にすると 1 件の種別まで畳まれて、
+  // Backlog・Drive・Meet が「1 件 ▸」の行に化ける（#424 で明示的に避けた形）
+var TOOLS_FOLD_MIN = 3;
 ${nextStateDelay.toString()}
   // 工程1.5: 正本を直接読む（secretsNow / capabilitiesNow / githubOwners）。
   // **判定の実体はビルド時の定義**——画面側に書き写すと許可リストが2枚になる
@@ -4090,8 +4276,10 @@ ${deriveCapTile.toString()}
   // 🔴 **var MERGE_KEYS の宣言より上に codeUrl を呼ぶトップレベル文を足さないこと。**
   // fleetVal は MERGE_KEYS を読むが、var の初期化は宣言行に達するまで走らない
   // （関数宣言の巻き上げでは undefined を読む）。呼び出しは全て描画（route）以降に置く
+  // 第4引数は使っているツールの段落（#275）。**焼き込んだ SITE から取る**——この段落は
+  // engine が毎朝 fleet-status.json に載せるもので、ライブ（op=state）は運んでこない
   function codeUrl(prompt) {
-    return claudeCodeUrl(prompt, REPO_SLUG, fleetVal("externalSources") || []);
+    return claudeCodeUrl(prompt, REPO_SLUG, fleetVal("externalSources") || [], SITE.tools && SITE.tools.paragraph);
   }
   /**
    * 🔴 **「1件も登録されていない」と「確かめられなかった」を分ける（#409）。**
@@ -5089,6 +5277,10 @@ ${deriveCapTile.toString()}
     var g = SITE.homeGrounding;
     if (g && g.unfilled) app.appendChild(homeUnfilledCard());
     if (g && g.sections.length) app.appendChild(homeGroundingSections(g.sections));
+    // **使っているツールは自己記述の直後・本文の前**（#275）。案件の説明を読んだ流れで
+    // 「どこに情報があるか」を見せる。中身は engine が登録簿から算出したもの
+    var toolsSec = homeToolsSection();
+    if (toolsSec) app.appendChild(toolsSec);
 
     var homeBody = el("div", { class: "body" });
     app.appendChild(homeBody);
@@ -5113,6 +5305,169 @@ ${deriveCapTile.toString()}
     return box;
   }
 
+  /**
+   * Home の「使用ツール」（#275）。engine が登録簿 7 種から算出した SITE.tools を描く。
+   *
+   * 🔴 **SITE.tools が無ければ何も出さない。** 生成が古い案件（この項目を知らない
+   * fleet-status.json）では、手書きの節が本文に残っているので、そちらがそのまま出る
+   * ——ここで「まだ接続していません」と出すと、繋いである案件に嘘を出すことになる。
+   *
+   * **0 件は 1 行で言い切る。** 空の一覧を出すと「読み込み中」に見える。
+   */
+  function homeToolsSection() {
+    var t = SITE.tools;
+    // build を通った値は必ず items を持つ。持たない形（renderSite 直渡し・壊れた埋め込み）は
+    // 「この項目を知らない」と同じ扱いにして節ごと出さない
+    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 || [];
+    if (!items.length) {
+      box.appendChild(el("p", { class: "home-tools-empty", text: "まだツールを接続していません。操作タブから接続できます。" }));
+      return box;
+    }
+    // **種別ごとにまとめる（#424）。**
+    //
+    // 🔴 **隣り合う同じ種別だけをまとめる**（前から順に見て、種別が変わったら切る）。
+    // 種別ごとに拾い集める形にすると、engine が種別を飛び飛びに出した日に
+    // **並び順が変わる**——「並び順は変えない」は仕様なので、engine の出力の性質
+    // （いまは種別ごとに連続している）に寄りかからず、構造として変わらない形にする
+    var groups = [];
+    items.forEach(function (it) {
+      var k = String(it && it.kind != null ? it.kind : "");
+      var last = groups[groups.length - 1];
+      if (last && last.kind === k) last.items.push(it);
+      else groups.push({ kind: k, items: [it] });
+    });
+    // 畳まない種別は 1 つの <ul> に続けて入れる（1〜2 件の種別のあいだに区切り線が
+    // 入らない、いまの見た目のまま）。畳みを挟んだら次の種別から新しい <ul> にする
+    var ul = null;
+    var foldSeq = 0;
+    groups.forEach(function (g) {
+      if (g.items.length >= TOOLS_FOLD_MIN) {
+        ul = null;
+        // 連番を渡す。**同じ種別が離れて 2 度出ると、種別だけでは名前がぶつかる**
+        // （id が重複し、開閉の復元も両方に効く）
+        box.appendChild(homeToolsFold(g.items, foldSeq++));
+        return;
+      }
+      if (!ul) { ul = el("ul", { class: "home-tools-list" }); box.appendChild(ul); }
+      g.items.forEach(function (it) { ul.appendChild(homeToolRow(it)); });
+    });
+    // **どこで直せるか・いつの情報かを 1 行で言う。** 操作タブで繋いだ直後は
+    // この一覧に出ない（engine が毎朝作り直すまで）ので、黙っていると「効いていない」と読まれる
+    box.appendChild(el("p", {
+      class: "home-tools-note",
+      text: "接続の追加・変更は操作タブで行います（この一覧は毎朝更新されます）。",
+    }));
+    return box;
+  }
+
+  /**
+   * 使用ツールの 1 行。**畳んだ種別の中でも同じ形**（開いたときに見えるのは今までの行）。
+   */
+  function homeToolRow(it) {
+    var li = el("li", { class: "home-tools-item" });
+    // 種別は**ツール名**（能力名でも単位語でもない）。DS_TYPE の行の約束と同じ
+    li.appendChild(el("span", {
+      class: "home-tools-kind",
+      text: (TOOL_KIND_ICONS[it.kind] || "🔗") + " " + (it.label || it.kind),
+    }));
+    var name = it.name || it.ref || "";
+    // **開ける先が無い行（Google Meet）はリンクにしない。** 押せないリンクを出すより
+    // 素のテキストのほうが正直（url は engine が 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);
+    var lab = toolStateLabel(st);
+    var chip = el("span", { class: "home-tools-state ds-gate " + lab.cls, text: lab.text });
+    // 状態そのものを属性に残す（表示語を読み替えずに検査・スタイルできるように）
+    chip.setAttribute("data-state", st);
+    li.appendChild(chip);
+    return li;
+  }
+
+  /**
+   * 同じ種別が 3 件以上あるときの、畳んだ 1 行（#424）。
+   *
+   * 🔴 **既定は畳む（open 属性を付けない）。** GitHub 7 件・Slack 11 件が縦に並ぶと、
+   * その下の本文が画面の外へ押し出される。件数と状態の要約は畳んだまま読めるので、
+   * 「何件つながっていて、手を入れる先があるか」は開かなくても分かる。
+   * 開閉は**保存しない**（開き直すと畳んだ状態に戻る・portal #77 と同じ）
+   *
+   * 🔴 **行は畳んでも DOM に残す**（details の中に置くだけ）。描き直し（syncHomeTools）で
+   * 開閉を戻せるのも、検査が行数を数えられるのも、行がそこにあるからで、
+   * **作り直す形にすると開いている最中に中身が消える**
+   */
+  function homeToolsFold(group, seq) {
+    var first = group[0] || {};
+    var kind = String(first.kind == null ? "" : first.kind);
+    // 畳み 1 つを指す鍵。**種別だけにしない**——同じ種別が離れて 2 度出たときに
+    // id が重複し、開閉の復元も両方に効いてしまう
+    var key = (kind || "other") + "-" + seq;
+    // 状態は 1 行ずつ求めてから畳む（行と要約が別の判定を持たない）
+    var sum = toolsFoldSummary(group.map(function (it) { return toolStateWithLive(it, LIVE_STATE); }));
+    var chip = el("span", { class: "home-tools-fold-state ds-gate " + sum.cls, text: sum.text });
+    chip.setAttribute("data-state", sum.state);
+    // 説明として読ませるので id が要る
+    var chipId = "home-tools-fold-state-" + key;
+    chip.setAttribute("id", chipId);
+    // 件数まで含めて 1 つのテキストノードにする（分けると読み上げが途切れ、
+    // 文言の完全一致で拾えなくなる。portal #77 と同じ約束）。
+    // ⚠ **ツール名はまとまりの中から拾う**（先頭だけ見ると、engine が先頭の 1 件の
+    // label を落とした日に「github 3 件」と内部名が出る）
+    var named = null;
+    group.forEach(function (it) { if (!named && it && it.label) named = it; });
+    var label = ((named || first).label || first.kind || "その他") + " " + group.length + " 件";
+    var sums = el("summary", { class: "home-tools-fold-summary" }, [
+      // アイコンは読み上げから外す（「たこ」と読まれても種別は分からない）
+      el("span", { class: "home-tools-fold-icon", "aria-hidden": "true", text: TOOL_KIND_ICONS[first.kind] || "🔗" }),
+      el("span", { class: "home-tools-fold-label", text: label }),
+      chip,
+    ]);
+    // ⚠ **読み上げ名は「GitHub 7 件」**（aria-label で言い切る）。状態の要約は
+    // aria-describedby で**説明として**読ませる——チップを aria-hidden にすると、
+    // 畳んでいるあいだ（中身は支援技術からも見えない）「承認待ちが 2 件ある」ことが
+    // 目で見える人にしか伝わらない。それは畳みを橙にした理由と正面から矛盾する
+    sums.setAttribute("aria-label", label);
+    sums.setAttribute("aria-describedby", chipId);
+    var ul = el("ul", { class: "home-tools-list" });
+    group.forEach(function (it) { ul.appendChild(homeToolRow(it)); });
+    // data-fold-key は「描き直しても開いたままにする」ための目印（syncHomeTools が見る）。
+    // data-kind は種別そのもの（畳んだ 1 行がどのツールのものか、を素直に読めるように）
+    return el("details", { class: "home-tools-fold", "data-kind": kind, "data-fold-key": key }, [sums, ul]);
+  }
+
+  /**
+   * 接続状況（op=state）が届いたときに「使用ツール」を描き直す（#275）。
+   *
+   * 🔴 **document を素で引かない（app.ownerDocument）。** 応答は画面が畳まれた後に
+   * 届くことがある（syncAiLinks と同じ理由）。Home 以外のタブを開いていれば節そのものが
+   * 無いので、何もせずに戻る
+   */
+  function syncHomeTools() {
+    var old = app.ownerDocument.querySelector(".home-tools");
+    if (!old || !old.parentNode) return;
+    var next = homeToolsSection();
+    if (!next) return;
+    // 🔴 **人が開いた折りたたみは、描き直しても開いたままにする（#424）。**
+    // 実測は開いた直後に届くことがあり、そこで畳み直すと「押したのに閉じた」になる
+    // （portal #77 で踏んだのと同じ罠）。**保存はしない**——開き直せば畳んだ状態に戻る
+    var opened = {};
+    var before = old.querySelectorAll(".home-tools-fold");
+    for (var i = 0; i < before.length; i++) {
+      // 素のオブジェクトの添字にしない（"constructor" のような鍵が継承側に当たる）
+      if (before[i].open) opened["k:" + (before[i].getAttribute("data-fold-key") || "")] = true;
+    }
+    var after = next.querySelectorAll(".home-tools-fold");
+    for (var j = 0; j < after.length; j++) {
+      if (opened["k:" + (after[j].getAttribute("data-fold-key") || "")]) after[j].open = true;
+    }
+    old.parentNode.replaceChild(next, old);
+  }
+
   /**
    * 未記入の警告。**「書かれていないと何が起きるか」まで書く。**
    *
@@ -5160,7 +5515,13 @@ ${deriveCapTile.toString()}
     var kids = Array.prototype.slice.call(mount.children);
     var dropping = false;
     kids.forEach(function (n) {
-      if (n.tagName === "H2") dropping = !!HOME_DROP_HEADINGS[(n.textContent || "").trim()];
+      // 🔴 **「使用ツール」は HOME_DROP_HEADINGS に入れない。** 落としてよいのは
+      // 自動の一覧を出す案件（SITE.tools がある）だけ——engine が算出を載せていない
+      // 案件で手書きの節まで消すと、**画面から使用ツールが丸ごと消える**（#275）
+      if (n.tagName === "H2") {
+        var h2 = (n.textContent || "").trim();
+        dropping = !!HOME_DROP_HEADINGS[h2] || (h2 === "使用ツール" && !!SITE.tools);
+      }
       // H2 より上位の見出しが来たら、そこで打ち切る（節の外まで消さない）
       else if (n.tagName === "H1") dropping = false;
       if (dropping && n.parentNode) n.parentNode.removeChild(n);
@@ -11257,6 +11618,8 @@ ${deriveCapTile.toString()}
         // 🔴 **後段の仕事より後ろに置く。** ここで投げると、図の復帰・取り直しタイマーが
         // 丸ごと落ちる（href を貼り替えるだけの処理に、そこまで巻き込ませない）
         syncAiLinks();
+        // Home を開いていれば「使用ツール」の状態を実測で描き直す（#275）
+        syncHomeTools();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       })
@@ -11285,6 +11648,9 @@ ${deriveCapTile.toString()}
         // つまり**立ち上げ直後の案件＝開発リポジトリを登録したばかりの案件**では、
         // この行だけがヘッダーの導線を追いつかせる。**後段の仕事より後ろに置く**（上と同じ理由）
         syncAiLinks();
+        // 🔴 **ここでも「使用ツール」を描き直す（#275）。** 実測（stateNow）は fleet より
+        // 先に読んでいるので、まとめ表を持たない案件でもこの経路で状態が確定する
+        syncHomeTools();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       });

package/package.json

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