@takagaki/cortex-decisions-viewer 0.12.32 → 0.12.34

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,8 @@ exports.isRepositorySlug = isRepositorySlug;
 exports.devRepositoryRefs = devRepositoryRefs;
 exports.claudeCodeRepositories = claudeCodeRepositories;
 exports.claudeCodeUrl = claudeCodeUrl;
+exports.toolStateLabel = toolStateLabel;
+exports.toolStateWithLive = toolStateWithLive;
 exports.isAlreadyRegistered = isAlreadyRegistered;
 exports.sanitizeRegisteredNow = sanitizeRegisteredNow;
 exports.sanitizeStateNow = sanitizeStateNow;
@@ -16,6 +18,7 @@ exports.overlayStateOnFleet = overlayStateOnFleet;
 exports.chatRowsToAdd = chatRowsToAdd;
 exports.gchatRowsToAdd = gchatRowsToAdd;
 exports.devRowsToAdd = devRowsToAdd;
+exports.markExcludedPendingRows = markExcludedPendingRows;
 exports.designRowsToAdd = designRowsToAdd;
 exports.materialRowsToAdd = materialRowsToAdd;
 exports.issuesRefOf = issuesRefOf;
@@ -60,7 +63,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);
@@ -451,12 +456,103 @@ 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";
 }
 /**
  * 外部ソースの行が「この能力・このアダプタのタイル」に属するか。
@@ -1011,6 +1107,44 @@ function devRowsToAdd(externals, rows) {
     }
     return out;
 }
+/**
+ * 仮置きで足した GitHub の行に、「読み取り停止中」の印を写す（#409 の後追い）。
+ *
+ * 🔴 **仮置きの行は印を持たない。** `pendingExternalRow` が作れるのは payload から
+ * 切り出せる値だけで、その repo が `exclude` に居るかは登録ファイル側にしかない。
+ *
+ * それが問題になるのはこの一続きのときだけ:
+ * 読み取りを止めた repo を**もう一度追加すると、サーバは「既に登録されています」と断る**
+ *（`sources` には残っているため）。#409 で画面はその断りを事実として受け取り行を出すように
+ * なったが、**印が無いので「読み取り中の行」として並ぶ**——止めたはずのものが動いて
+ * 見えるので、**止め忘れたと思ってもう一度止めに行く**ことになる。まとめ表にも
+ * 即時読み取りの `dev` にもその行は居ない（除外は `devExcluded` に分かれている）ので、
+ * 他のどこからも印は付かない。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function markExcludedPendingRows(view, reg) {
+    const v = view || {};
+    const rows = v.externalSources;
+    if (!reg || !Array.isArray(reg.devExcluded) || !Array.isArray(rows))
+        return v;
+    const excluded = {};
+    for (const r of reg.devExcluded)
+        if (r && r.ref)
+            excluded[String(r.ref).toLowerCase()] = true;
+    let changed = false;
+    const next = rows.map(function (s) {
+        if (!s || s.pending !== true || !s.ref || s.goldState)
+            return s;
+        if (String(s.type || "").indexOf("github") !== 0)
+            return s;
+        if (excluded[String(s.ref).toLowerCase()] !== true)
+            return s;
+        changed = true;
+        return Object.assign({}, s, { goldState: "excluded" });
+    });
+    return changed ? Object.assign({}, v, { externalSources: next }) : v;
+}
 /** デザインの行で、まとめ表がまだ知らないもの（鍵はファイルキー） */
 function designRowsToAdd(files, rows) {
     const have = {};
@@ -2663,6 +2797,21 @@ 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; }
 /* ---- レコード詳細の「AIによる最近の変更」（リポジトリの git 履歴 由来）----
    カードは詳細ページの提案（.proposals）と同系色にする——どちらも
    「AIがやったこと・言っていることを読む」もので種類が同じ。
@@ -3604,6 +3753,7 @@ ${sanitizeRegisteredNow.toString()}
 ${chatRowsToAdd.toString()}
 ${gchatRowsToAdd.toString()}
 ${devRowsToAdd.toString()}
+${markExcludedPendingRows.toString()}
 ${designRowsToAdd.toString()}
 ${materialRowsToAdd.toString()}
 ${issueRowsToAdd.toString()}
@@ -3649,6 +3799,12 @@ 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()}
 ${nextStateDelay.toString()}
   // 工程1.5: 正本を直接読む（secretsNow / capabilitiesNow / githubOwners）。
   // **判定の実体はビルド時の定義**——画面側に書き写すと許可リストが2枚になる
@@ -4050,8 +4206,62 @@ ${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）。**
+   *
+   * サーバは登録ファイルを読めなかった能力を、**キーごと応答から落とす**
+   *（「読めなかった」を「0件」と混ぜないため。intake の buildRegisteredNow）。
+   * ところが画面はそれを「足す行が無い」としか受け取っていなかったので、
+   * **確かめられなかった結果が「登録されていません」として出ていた**。
+   * オーナーはそれを見て未登録だと読み、追加して「既に登録されています」と断られた。
+   *
+   * 🔴 **能力ごとのキーの有無で判定してはいけない（実装レビューの指摘）。** サーバは
+   * 「読めなかった」ときだけでなく **「そのファイルがまだ無い」ときにも同じくキーを落とす**
+   * （読んだ本文が null でも undefined でも、文字列でなければ同じ枝に落ちる）。
+   * キーの有無で見ると、**その能力をまだ使っていない案件**——つまり立ち上げ直後の、
+   * この画面が一番よく見られる状態——に**永久に消えない誤警報**が出る
+   * （「再読み込みしてください」と言われても、設定ファイルは再読み込みでは生えない）。
+   * しかも製品としては、その状態は「登録されていません」と言い切ると決めてある
+   * （engine の capabilities: ファイルの有無は実装の都合で、利用者にはどちらも「まだ登録していない」）。
+   *
+   * **だから応答まるごとで見る。** 登録ファイルの一覧（registeredNow）と
+   * 能力の状態（capabilitiesNow）は**サーバの同じ return から出る**ので、
+   * **両方とも無いときだけ**が「そもそも読みに行けなかった」——今回の症状の
+   * 3経路（ツリー取得の失敗・ツリーの打ち切り・応答そのものの失敗）は全部これに当たる。
+   *
+   * ⚠ この粒度では、**ファイル1本だけが読めなかった回**（8秒の打ち切り・単発の失敗）は
+   * 拾えない。そちらはサーバがログを出す経路なので、まず記録から追えるようにしてある。
+   */
+  function registrationUnreadable() {
+    return liveAnswered && LIVE_REGISTERED === null && LIVE_CAPS === null;
+  }
+  /**
+   * 一覧に添える1行。**帯は症状・行は一手・繰り返さない。**
+   * 応答がまだ届いていない間は出さない（確かめる前に「確かめられなかった」と言わない）。
+   *
+   * **0件のときは一覧の代わり**——空の一覧そのものを出さない（オーナーが踏んだのは
+   * 「空の一覧を見て未登録だと読んだ」ことなので）。
+   *
+   * 🔴 **行があるときも黙らない。** まとめ表が行を持っていれば一覧は出るが、
+   * **その日足したばかりの行だけが欠けたまま、完全な一覧に見える**——利用者の読み違い方は
+   * 0件のときと同じで、「自分が足したものは登録されていない」と読む。行は本物なので消さず、
+   * **欠けているかもしれないことだけを添える**。
+   *
+   * ⚠ 「表示は前の晩の内容です」とは言わない。一覧にはまとめ表（前の晩）だけでなく
+   * **このブラウザが覚えている反映待ちの行も混ざる**ので、言い切ると画面自身が嘘をつく。
+   * 利用者が知りたいのは日付ではなく「自分が足したものが抜けているかどうか」。
+   */
+  function unverifiedListNote(noun, hasRows) {
+    if (!registrationUnreadable()) return null;
+    var head = "登録されている" + noun + "を確認できませんでした。";
+    return el("div", { class: "ds-note", text: hasRows
+      ? head + "最近足したものが抜けているかもしれません。再読み込みしてください。"
+      : head + "再読み込みしてください。" });
   }
   // AI 導線の a はここでだけ作る。href を決めてよいのは codeUrl だけ（#404）。
   // 指示文を属性に残すのは、接続状況の応答が届いたときに href を組み直すため（syncAiLinks）
@@ -4997,6 +5207,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);
@@ -5021,6 +5235,74 @@ ${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;
+    }
+    var ul = el("ul", { class: "home-tools-list" });
+    items.forEach(function (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);
+      ul.appendChild(li);
+    });
+    box.appendChild(ul);
+    // **どこで直せるか・いつの情報かを 1 行で言う。** 操作タブで繋いだ直後は
+    // この一覧に出ない（engine が毎朝作り直すまで）ので、黙っていると「効いていない」と読まれる
+    box.appendChild(el("p", {
+      class: "home-tools-note",
+      text: "接続の追加・変更は操作タブで行います（この一覧は毎朝更新されます）。",
+    }));
+    return box;
+  }
+
+  /**
+   * 接続状況（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) old.parentNode.replaceChild(next, old);
+  }
+
   /**
    * 未記入の警告。**「書かれていないと何が起きるか」まで書く。**
    *
@@ -5068,7 +5350,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);
@@ -6499,7 +6787,7 @@ ${deriveCapTile.toString()}
       // 状態ストアの答えは常に勝つ（まとめ表は gate を焼き込まない。overlayStateOnFleet の項）
       if (!MERGED) {
         MERGED = overlayStateOnFleet(
-          applyPendingOps(mergeRegisteredFleet(rawView(), LIVE_REGISTERED), pend),
+          markExcludedPendingRows(applyPendingOps(mergeRegisteredFleet(rawView(), LIVE_REGISTERED), pend), LIVE_REGISTERED),
           LIVE_STATE,
         );
       }
@@ -7431,44 +7719,6 @@ ${deriveCapTile.toString()}
      * （素の Decisions ビュー）で行も無い能力に空の箱を積むと、押しても何も無いモーダルになる。
      */
     function liveListWanted(kind) { return !!SITE.intake || liveExternals(kind).length > 0; }
-    /**
-     * 🔴 **「1件も登録されていない」と「確かめられなかった」を分ける（#409）。**
-     *
-     * サーバは登録ファイルを読めなかった能力を、**キーごと応答から落とす**
-     *（「読めなかった」を「0件」と混ぜないため。intake の buildRegisteredNow）。
-     * ところが画面はそれを「足す行が無い」としか受け取っていなかったので、
-     * **確かめられなかった結果が「登録されていません」として出ていた**。
-     * オーナーはそれを見て未登録だと読み、追加して「既に登録されています」と断られた。
-     *
-     * 🔴 **能力ごとのキーの有無で判定してはいけない（実装レビューの指摘）。** サーバは
-     * 「読めなかった」ときだけでなく **「そのファイルがまだ無い」ときにも同じくキーを落とす**
-     * （読んだ本文が null でも undefined でも、文字列でなければ同じ枝に落ちる）。
-     * キーの有無で見ると、**その能力をまだ使っていない案件**——つまり立ち上げ直後の、
-     * この画面が一番よく見られる状態——に**永久に消えない誤警報**が出る
-     * （「再読み込みしてください」と言われても、設定ファイルは再読み込みでは生えない）。
-     * しかも製品としては、その状態は「登録されていません」と言い切ると決めてある
-     * （engine の capabilities: ファイルの有無は実装の都合で、利用者にはどちらも「まだ登録していない」）。
-     *
-     * **だから応答まるごとで見る。** 登録ファイルの一覧（registeredNow）と
-     * 能力の状態（capabilitiesNow）は**サーバの同じ return から出る**ので、
-     * **両方とも無いときだけ**が「そもそも読みに行けなかった」——今回の症状の
-     * 3経路（ツリー取得の失敗・ツリーの打ち切り・応答そのものの失敗）は全部これに当たる。
-     *
-     * ⚠ この粒度では、**ファイル1本だけが読めなかった回**（8秒の打ち切り・単発の失敗）は
-     * 拾えない。そちらはサーバがログを出す経路なので、まず記録から追えるようにしてある。
-     */
-    function registrationUnreadable() {
-      return liveAnswered && LIVE_REGISTERED === null && LIVE_CAPS === null;
-    }
-    /**
-     * 空の一覧の代わりに出す1行。**帯は症状・行は一手・繰り返さない。**
-     * 空の一覧そのものを出さない——今回オーナーが踏んだのは「空の一覧を見て未登録だと読んだ」ことなので。
-     * 応答がまだ届いていない間は出さない（確かめる前に「確かめられなかった」と言わない）。
-     */
-    function unverifiedListNote(noun) {
-      if (!registrationUnreadable()) return null;
-      return el("div", { class: "ds-note", text: "登録されている" + noun + "を確認できませんでした。再読み込みしてください。" });
-    }
     // **箱にはアダプタのタグを付ける（#153）。** pushCap の無タグは「どのタイルにも出す」
     // 既定なので、タグを忘れると Slack の一覧が Google Chat モーダルに丸ごと出る
     if (liveListWanted("slack")) pushCap("チャット", liveList(
@@ -7476,11 +7726,10 @@ ${deriveCapTile.toString()}
       function () { return externalsSig("slack", slackWorkspaces()); },
       function (box) {
         var items = liveExternals("slack");
-        if (!items.length) {
-          var noteSlack = unverifiedListNote("チャンネル");
-          if (noteSlack) box.appendChild(noteSlack);
-          return;
-        }
+        // 注記は**行より前**に置く（0件なら一覧の代わり・行があれば添え書き）
+        var noteSlack = unverifiedListNote("チャンネル", items.length > 0);
+        if (noteSlack) box.appendChild(noteSlack);
+        if (!items.length) return;
         var meta = DS_TYPE["slack"] || { icon: "🔗", label: "Slack" };
         slackRows(items, meta).forEach(function (n) { box.appendChild(n); });
       },
@@ -7492,11 +7741,10 @@ ${deriveCapTile.toString()}
       function () { return externalsSig("google-chat", null); },
       function (box) {
         var items = liveExternals("google-chat");
-        if (!items.length) {
-          var noteGchat = unverifiedListNote("スペース");
-          if (noteGchat) box.appendChild(noteGchat);
-          return;
-        }
+        // 注記は**行より前**に置く（0件なら一覧の代わり・行があれば添え書き）
+        var noteGchat = unverifiedListNote("スペース", items.length > 0);
+        if (noteGchat) box.appendChild(noteGchat);
+        if (!items.length) return;
         var meta = DS_TYPE["google-chat"] || { icon: "💬", label: "Google Chat" };
         items.forEach(function (s) { box.appendChild(extSourceCard(s, meta)); });
       },
@@ -7506,11 +7754,10 @@ ${deriveCapTile.toString()}
       function () { return externalsSig("github", githubOwnersView() || null); },
       function (box) {
         var items = liveExternals("github");
-        if (!items.length) {
-          var noteDev = unverifiedListNote("リポジトリ");
-          if (noteDev) box.appendChild(noteDev);
-          return;
-        }
+        // 注記は**行より前**に置く（0件なら一覧の代わり・行があれば添え書き）
+        var noteDev = unverifiedListNote("リポジトリ", items.length > 0);
+        if (noteDev) box.appendChild(noteDev);
+        if (!items.length) return;
         // **meta は行ごとに引く**（issues と discussions でアイコンとラベルが違う）
         githubRows(items).forEach(function (n) { box.appendChild(n); });
       },
@@ -9512,10 +9759,14 @@ ${deriveCapTile.toString()}
         box.appendChild(liveList("共有資料", function () {
           var d = driveNow();
           // 仮置きの印（drivePending）も署名に入れる——外れたときに印だけ残さない（#388）
-          return JSON.stringify([d.driveFolderIds || [], d.driveFolderNames || {}, d.driveState || "", d.drivePending || {}]);
+          // 「確かめられたか」も混ぜる（#409。混ぜないと注記の要否が変わっても作り直されない）
+          return JSON.stringify([d.driveFolderIds || [], d.driveFolderNames || {}, d.driveState || "", d.drivePending || {}, registrationUnreadable()]);
         }, function (listBox) {
         var src = driveNow();
         var folders = src.driveFolderIds || [];
+        // 兄弟の穴を一緒に塞ぐ（#409）。ここも同じ registeredNow から行を足している
+        var noteDrive = unverifiedListNote("フォルダ", folders.length > 0);
+        if (noteDrive) listBox.appendChild(noteDrive);
         // 名前は任意。**無ければIDを出す**（既存の案件は名前を持っていない）
         var fnames = src.driveFolderNames || {};
         if (folders.length) {
@@ -9651,9 +9902,13 @@ ${deriveCapTile.toString()}
       // **署名に取り込みの状態も混ぜる（段C第二弾）。** 一覧のJSONだけだと、応答が返る前に
       // モーダルを開いた人には取り込みが1件も出ない（designIngestSigOf の項に経緯）
       figGroup.appendChild(liveList("デザイン", function () {
-        return JSON.stringify(figsOf()) + "|" + designIngestSigOf(figsOf());
+        // 「確かめられたか」も混ぜる（#409。混ぜないと注記の要否が変わっても作り直されない）
+        return JSON.stringify(figsOf()) + "|" + designIngestSigOf(figsOf()) + "|" + registrationUnreadable();
       }, function (listBox) {
       var figs = figsOf();
+      // 兄弟の穴を一緒に塞ぐ（#409）。ここも同じ registeredNow から行を足している
+      var noteFig = unverifiedListNote("ファイル", figs.length > 0);
+      if (noteFig) listBox.appendChild(noteFig);
       // **一覧から消えた鍵は「外し済み」から落とす**（figsRemoved の項に経緯）。
       // サーバが削除を認めた印なので、ここから先に同じ鍵が現れたら**貼り直された別の登録**
       var figKeys = figs.map(function (f) { return f.key; });
@@ -11198,6 +11453,8 @@ ${deriveCapTile.toString()}
         // 🔴 **後段の仕事より後ろに置く。** ここで投げると、図の復帰・取り直しタイマーが
         // 丸ごと落ちる（href を貼り替えるだけの処理に、そこまで巻き込ませない）
         syncAiLinks();
+        // Home を開いていれば「使用ツール」の状態を実測で描き直す（#275）
+        syncHomeTools();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       })
@@ -11226,6 +11483,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.32",
+  "version": "0.12.34",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,