@takagaki/cortex-decisions-viewer 0.4.81 → 0.4.83

package/dist/render.js

@@ -1253,7 +1253,7 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-check-label, .ds-check-action, .ds-check-detail,
 .ds-pipe-label, .ds-pipe-todo, .ds-owner-state,
 .ds-empty, .sec-how, .modal-desc, .ds-toggle-msg,
-.ds-drive-note, .ds-inactive-note, .ds-legacy-chip, .ds-keys-code {
+.ds-drive-note, .ds-inactive-note, .ds-legacy-chip, .ds-keys-code, .ds-gate-help {
   min-width: 0; white-space: normal; overflow-wrap: anywhere;
 }
 .ds-toggle { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin-top: 6px; }
@@ -1290,6 +1290,23 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-gate-ok { color: #1f7a45; }
 .ds-gate-warn { color: #b45309; }
 .ds-gate-muted { color: #6b7280; }
+/* 行の状態に添える「次に誰が何をするか」（2026-08-18）。**必ず自分の行を占める**
+   （flex: 1 1 100%）——状態バッジの横に押し込むと、いちばん読ませたい一文が
+   カード幅に負けて省略される。状態の語より弱く、しかし読める大きさで出す */
+.ds-gate-help { flex: 1 1 100%; margin: 4px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280; }
+/* 「接続を確認」を押した結果（2026-08-19）。**必ず自分の行を占める**（flex: 1 1 100%）。
+   夜間のスナップショットの状態バッジと**同時に2つの判定を並べない**ため、押したあとは
+   状態バッジをこの中の判定へ置き換える（同じ画面で「⚠️」と「接続OK」が並ぶのが、
+   この節で3回直してきた壊れ方そのもの） */
+.ds-probe { flex: 1 1 100%; margin-top: 8px; padding-top: 8px; border-top: 1px dashed var(--border); }
+.ds-probe-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+/* いつ測った結果かを必ず添える。夜間のスナップショットと混ざると、どちらの話か読めない */
+.ds-probe-at { font-size: 11.5px; color: var(--muted); }
+.ds-probe-help { margin: 6px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280;
+  min-width: 0; white-space: normal; overflow-wrap: anywhere; }
+/* Slack が名指しした不足スコープ。**そのまま読める形で出す**（言い換えると検索できない） */
+.ds-probe-scope { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; background: #fef3c7;
+  border: 1px solid #fde68a; border-radius: 6px; padding: 1px 6px; user-select: all; }
 /* 意図的にOFFにした能力（#125②）。**グレーにして誘わない**——未接続（入口を出してよい）
    とは別物で、同じ色にすると「押して繋ぎましょう」と読まれる */
 .ds-gate-off { color: #9ca3af; }
@@ -1322,6 +1339,9 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-addform .sec-input { margin-bottom: 6px; }
 .sec-input-inline { width: auto; max-width: 220px; margin-bottom: 0; }
 .sec-how { color: var(--muted); font-size: 12px; line-height: 1.7; margin: 0 0 10px; }
+/* 「この接続は何のためのものでないか」（2026-08-18）。**説明文より強く出す**——
+   ここを読み飛ばした人が、社内チャンネルのためにボタンを押し、必ず失敗する */
+.ds-scope-note { color: var(--text); }
 /* いまの接続先（設定を変える口の直前に置く。値は本文色で、ラベルだけ弱める） */
 .ds-current { display: flex; align-items: baseline; gap: 8px; flex-wrap: wrap; margin: 0 0 8px; font-size: 12.5px; }
 .ds-current-label { color: var(--muted); flex: 0 0 auto; }
@@ -2015,10 +2035,79 @@ ${capabilityState.toString()}
     // **状態だけでなく、次にすることを書く。** 「bot未招待」では何をすればよいか分からない
     // （公開チャンネルでも招待が要ることは Slack の仕様で、知らない人のほうが多い）
     "not_in_channel": { text: "Slackで招待してください", cls: "ds-gate-warn" },
+    // **招待では直らない（2026-08-19 の不具合報告）。** 非公開チャンネルで groups:read が
+    // 足りていたのに、実測がこれを「不明」に潰していたので画面には「接続OK」としか出ず、
+    // 名前が引けない理由が一切分からなかった（原因の特定に半日かかった）。
+    // **状態の語で「招待」と言わない**——言うと、何度招待しても直らないものを繰り返させる
+    "missing_scope": { text: "権限が足りません", cls: "ds-gate-warn" },
     "unreachable": { text: "アクセス不可", cls: "ds-gate-warn" },
     "no_token": { text: "トークン未設定", cls: "ds-gate-muted" },
     "unknown": { text: "不明", cls: "ds-gate-muted" },
   };
+  /* ---------------------------------------------------------------------------
+   * no_token には**経路が2つある**（2026-08-18 の不具合報告）
+   *
+   * Slack のチャンネルは、どのワークスペースにあるかで読み取りの鍵が別物になる:
+   *   - workspace 省略 … クラスメソッドの社内ワークスペース。中央 Bot の鍵（案件リポジトリの
+   *     設定）で読む。**画面から設定できるものが1つも無い。**
+   *   - workspace: "T…" … お客様のワークスペース。下の「お客様の Slack ワークスペースを接続」で
+   *     承認を貰って読む。**画面から自己解決できる。**
+   *
+   * どちらも no_token に潰して「トークン未設定」と出していたため、社内チャンネルを
+   * 登録した人が「そのトークンをどこで設定するのか」を探し、直下にある唯一それらしい
+   * ボタン（顧客ワークスペースの接続）へ吸い込まれた。押すと社内ワークスペースの承認画面が
+   * 出て失敗し、「もう一度お試しください」と言われてまた押す——**何度試しても直らない**まま
+   * 不具合報告になった。状態だけでなく、**この行で次に誰が何をするのか**を出し分ける。
+   *
+   * **社内側で「担当者にご連絡ください」と書くのは後退ではない。** 画面から設定できる
+   * ものが本当に無いので、自己解決できると誤認させて空振りを繰り返させる方が損害が大きい。
+   * ------------------------------------------------------------------------- */
+  var DS_GATE_NO_TOKEN = {
+    // 社内ワークスペース。**顧客ワークスペースの接続へ誘導しない**（押しても必ず失敗する）
+    internal: {
+      text: "管理者の設定が必要です",
+      cls: "ds-gate-muted",
+      help: "このチャンネルはクラスメソッドの社内ワークスペースにあります。読み取りを始めるには cortex 側（管理者）の設定が必要で、下の「お客様の Slack ワークスペースを接続」では設定できません。cortex の担当者にご連絡ください。",
+    },
+    // お客様のワークスペース。従来どおり接続へ誘導する（自己解決できる唯一の経路）
+    customer: {
+      text: "トークン未設定",
+      cls: "ds-gate-muted",
+      help: "このチャンネルがあるお客様の Slack ワークスペースが、まだ接続されていない（または接続が切れている）状態です。下の「お客様の Slack ワークスペースを接続」から接続してください。",
+    },
+  };
+  /**
+   * Slack のチャンネルが社内ワークスペースのものか。**workspace の有無だけで決まる**
+   * （省略＝社内。#104 でこの値が画面まで届いていることは slack-workspace.test.mjs が見張る）。
+   */
+  function isInternalSlack(s) {
+    return s.type === "slack" && !s.workspace;
+  }
+  /** 行に出す接続状態。no_token だけは経路（社内/顧客）で文面が分かれる */
+  function dsGateOf(s) {
+    if (s.gate === "no_token" && s.type === "slack") {
+      return isInternalSlack(s) ? DS_GATE_NO_TOKEN.internal : DS_GATE_NO_TOKEN.customer;
+    }
+    return DS_GATE[s.gate] || DS_GATE["unknown"];
+  }
+  /**
+   * 一覧・タイルに出す「⚠️ …」の要約。**呼び出しは2箇所（グループの summary と能力タイル）。**
+   * 写経すると片方だけ古くなり、同じ画面で語が割れる（この節では実際に起きた）。
+   *
+   * **社内チャンネルだけが読めていないときは「トークン」と言わない。** 探しても設定する
+   * 場所が画面に無いので、探した人が顧客ワークスペースの接続へ吸い込まれる（DS_GATE_NO_TOKEN
+   * の項の事故がここから始まっている）。1件でも顧客側が混ざるときは従来の文面のまま——
+   * そちらは接続で直せるので、経路を名指しできない要約に倒す方が正しい。
+   */
+  function attentionSummary(items) {
+    var bad = items.filter(function (s) { return sourceNeedsAttention(s); });
+    if (!bad.length) return "";
+    var head = "⚠️ " + bad.length + "件";
+    var noToken = bad.filter(function (s) { return s.gate === "no_token"; });
+    if (noToken.length !== bad.length) return head + "に問題";
+    var allInternal = noToken.every(function (s) { return isInternalSlack(s); });
+    return head + "が読めていません（" + (allInternal ? "管理者の設定が必要です" : "トークン未設定") + "）";
+  }
   var DS_KIND_ICON = {
     "課題管理": "📋",
     "会議": "🗒️",
@@ -2413,24 +2502,16 @@ ${capabilityState.toString()}
         g.items.forEach(function (s) { cards.appendChild(extSourceCard(s, meta)); });
         if (g.items.length >= 4) {
           // 折りたたみ（既定は閉）。summaryに件数と状態の要約を出す。
-          // **判定は共有の sourceNeedsAttention を呼ぶ。** 以前はここに中身を写経していたが、
-          // 片方だけ直すと同じ画面でマップが⚠️・直下が「接続OK」になる（実際に起きた）。
-          var bad = 0;
-          var noToken = 0;
-          g.items.forEach(function (s) {
-            if (!sourceNeedsAttention(s)) return;
-            bad++;
-            if (s.gate === "no_token") noToken++;
-          });
+          // **判定と文面は共有の attentionSummary を呼ぶ。** 以前はここに中身を写経して
+          // いたが、片方だけ直すと同じ画面でマップが⚠️・直下が「接続OK」になる（実際に起きた）。
+          // 原因が1つに集約できるときは原因を書く（「19件に問題」より、読んだ人が次に何を
+          // すればよいか分かる）——その出し分けごと attentionSummary が持っている
+          var warn = attentionSummary(g.items);
           var sum = el("summary", {}, [
             el("span", { text: meta.icon + " " + meta.label + "（" + g.items.length + (UNIT[g.type] || "件") + "）" }),
-            bad === 0
+            warn === ""
               ? el("span", { class: "badge ds-sum-ok", text: "接続OK" })
-              // 原因が1つに集約できるときは原因を書く。「19件に問題」より「トークンが未設定」の方が、
-              // 読んだ人が次に何をすればよいか分かる（実際、19件の原因がトークン1本ということがあった）。
-              : el("span", { class: "badge ds-sum-warn", text: noToken === bad
-                  ? "⚠️ " + bad + "件が読めていません（トークン未設定）"
-                  : "⚠️ " + bad + "件に問題" }),
+              : el("span", { class: "badge ds-sum-warn", text: warn }),
           ]);
           var det = el("details", { class: "ds-group" }, [sum, cards]);
           pushCap(capOf(g.type), det);
@@ -2676,15 +2757,14 @@ ${capabilityState.toString()}
         parts.push((CAP_STATE_MARK[st] || "") + (CAP_STATE_TEXT[derived] || "状態が判定できません"));
       } else if (st === "warn") {
         if (live.length) {
-          var bad = 0, noToken = 0;
-          live.forEach(function (s) {
-            if (!sourceNeedsAttention(s)) return;
-            bad++;
-            if (s.gate === "no_token") noToken++;
-          });
-          parts.push(noToken === bad && bad > 0
-            ? "⚠️ " + bad + "件が読めていません（トークン未設定）"
-            : "⚠️ " + bad + "件に問題");
+          // **文面は共有の attentionSummary が持つ。** グループの summary と同じ文で、
+          // 写経すると片方だけ古くなる（社内/顧客の出し分けもここに要る）。
+          //
+          // **数えて0件でも文を出す。** warn はパイプラインの失敗からも立つので
+          // （ライブでない経路）、行の gate が全部 ok のまま warn になることがある。
+          // 空にすると⚠️のタイルの2行目が消えるので、従来どおりの件数表現に倒す
+          var warn = attentionSummary(live);
+          parts.push(warn || "⚠️ 0件に問題");
         } else {
           // 内部能力の warn はパイプラインの失敗由来。数えるものが無いので件数を出さない
           parts.push("⚠️ 同期が失敗しています");
@@ -2972,6 +3052,210 @@ ${capabilityState.toString()}
    * 関わらず必ず出し、成功しても一覧からは消さずに行へ取り消し線を引く（一覧は夜間
    * スナップショットなので、翌朝まで残るのが正しい状態）。
    */
+  /* ---------------------------------------------------------------------------
+   * 「接続を確認」（2026-08-19 の不具合報告3件）
+   * ---------------------------------------------------------------------------
+   * 3つの別々の原因（トークン未登録・groups:read 不足・スナップショットが古い）が、
+   * **画面上はどれも区別できなかった。** 共通していたのは「画面を見ても次に何をすれば
+   * いいか決まらない」こと。実測は毎晩1回しか走らないので、招待やスコープを直した人が
+   * 直ったことを確かめる手段も無かった。**押した瞬間に測って、理由と次の一手を返す。**
+   *
+   * **判定はここで作らない。** 状態の語は DS_GATE、社内/顧客の出し分けは
+   * DS_GATE_NO_TOKEN が持っていて、どちらも dsGateOf を通して取る。ここで文面を
+   * 書き写すと、**同じ行の状態バッジと確認結果で語が割れる**（この節で3回直した形）。
+   *
+   * 他アダプタ（GitHub / Backlog / Figma / Drive）を足すときの拡張点:
+   *   - 判定と語彙は infra/lambda/shared/slack-gate.mjs 側に足す（画面は DS_GATE のまま）
+   *   - この節に増やすのは probeHelpNodes の「次の一手」だけ。**アダプタ固有の分岐を
+   *     probeVerdict に入れない**（入れた瞬間に判定が画面側にも生まれる）
+   *   - 行に出す条件（下の extSourceCard）を s.type === "slack" から広げる
+   * ------------------------------------------------------------------------- */
+
+  /**
+   * 確認結果の状態バッジ。**既存の dsGateOf をそのまま通す。**
+   *
+   * こうしておくと no_token の社内/顧客の出し分け（DS_GATE_NO_TOKEN）が確認結果にも
+   * そのまま効く。写経すると、同じ画面で行は「管理者の設定が必要です」・確認結果は
+   * 「トークン未設定」になり、社内チャンネルを登録した人が**また**顧客ワークスペースの
+   * 接続へ吸い込まれる（2026-08-18 の不具合そのもの）。
+   */
+  function probeVerdict(s, r) {
+    return dsGateOf({ type: s.type, workspace: s.workspace, gate: r.gate });
+  }
+
+  /**
+   * 判定ごとの「次の一手」。**状態の語だけでは足りない**——今日の3件はどれも
+   * 「何が起きているか」は分かっても「次に何をすればいいか」が決まらなかった。
+   */
+  function probeHelpNodes(s, r) {
+    var p = function (t) { return el("p", { class: "ds-probe-help", text: t }); };
+    var out = [];
+    if (r.gate === "ok") {
+      // **表示名が引けたかまで言う。** 読めているのに名前が「（名前未取得: C0BQ…）」の
+      // ままだった案件があり、読めていること自体は正しかったので誰も疑わなかった
+      out.push(p(r.name
+        ? "読めています。Slack で確認できた表示名は「" + r.name + "」です。"
+        : "読めています。ただし表示名は引けませんでした（Slack の応答: " +
+          (r.error || "不明") + "）。一覧の名前は登録したときのままになります。"));
+      return out;
+    }
+    if (r.gate === "not_in_channel") {
+      out.push(p("このチャンネルに Cortex を招待してください。公開チャンネルでも招待が必要で、" +
+        "招待していないと中身を1件も読めません。Slack でこのチャンネルを開き、次のコマンドを貼ります。" +
+        "招待したら、もう一度「接続を確認」を押して直ったことを確かめてください。"));
+      // **手で打たせない。** 短い文字列でも打ち間違いは黙って失敗し、
+      // 利用者には「招待したのに読まれない」としか見えない（copyRow の直上コメント）
+      out.push(copyRow("/invite @Cortex"));
+      return out;
+    }
+    if (r.gate === "missing_scope") {
+      // **足りないスコープ名をそのまま出す（2026-08-19 の不具合の本体）。**
+      // Slack は needed で名指しで返しているのに、実測がそれを捨てて「不明」にしていた。
+      // **招待と言わない**——招待では直らないので、言うと直らない操作を繰り返させる
+      var line = el("p", { class: "ds-probe-help" });
+      line.appendChild(document.createTextNode("Cortex の Slack App に権限（スコープ）が足りません。不足しているのは "));
+      line.appendChild(el("code", { class: "ds-probe-scope", text: r.needed || "不明（Slack が名前を返しませんでした）" }));
+      line.appendChild(document.createTextNode(" です。"));
+      out.push(line);
+      out.push(p("これは招待では直りません。Slack App にこのスコープを追加して再インストールする必要があるので、" +
+        "cortex の担当者にこのスコープ名をそのまま伝えてください。" +
+        (r.readable
+          ? "なお、チャンネルの中身そのものは読めています（毎晩の取り込みは動いています）。直らないのは表示名です。"
+          : "")));
+      return out;
+    }
+    if (r.gate === "no_token") {
+      // **社内/顧客の出し分けは既存の1箇所から取る。** ここで書き分けると必ずずれる
+      var help = probeVerdict(s, r).help;
+      if (help) out.push(p(help));
+      return out;
+    }
+    if (r.gate === "unreachable") {
+      out.push(p("チャンネルが見つからないか、アーカイブされています。" +
+        "Slack でこのチャンネルがまだ存在するかを確かめてください。" +
+        "アーカイブしたチャンネルなら、この行の「登録を解除」で読み取り対象から外せます。" +
+        "存在するのに見つからない場合は、Cortex が入っていない別ワークスペースのチャンネルの可能性があるので、" +
+        "cortex の担当者にご連絡ください。"));
+      return out;
+    }
+    // unknown。**生のエラーを隠さない**——「不明」だけだと切り分けが始められない
+    out.push(p("読めるかどうかを確かめられませんでした。Slack の応答は「" + (r.error || "不明") + "」です。" +
+      "少し時間をおいてもう一度お試しください。同じ応答が続く場合は、この文言をそのまま cortex の担当者にお伝えください。"));
+    return out;
+  }
+
+  /**
+   * 表示名の取り直し。**確認とは別のボタンにしてある。**
+   *
+   * 確認（?op=probe）は読むだけなので誰でも押してよいと決めた（オーナー判断・2026-08-19）。
+   * 名前の更新は案件リポジトリへのコミットなので、**設定変更と同じ入口（?op=config）**に
+   * 通す（sendConfig）。確認のついでに黙って書き込む形にすると、「読むだけだから誰でも
+   * 押してよい」という前提そのものが崩れる。**押す前に、何がどう変わるかを見せる。**
+   *
+   * 出すのは**違っているときだけ**。同じ名前のときにボタンだけ出すと、押しても
+   * 「変更はありません」と返るだけの操作になる。
+   */
+  function renameChannelRow(s, r, card) {
+    if (!r.name || r.name === s.name) return null;
+    var box = el("div");
+    box.appendChild(el("p", { class: "ds-probe-help",
+      text: "一覧の表示名「" + (s.name || "（未設定）") + "」は、Slack のいまの名前「" + r.name + "」と違います。" +
+        "更新すると、この案件の設定ファイル（チャット/channels.json）の表示名だけが書き換わります。" +
+        "読み取りの対象・範囲は変わりません。" }));
+    var row = el("div", { class: "ds-toggle" });
+    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "表示名を更新する" });
+    var msg = el("div", { class: "ds-toggle-msg" });
+    btn.addEventListener("click", function () {
+      // **名前は送らない。** サーバが Slack から引き直したものだけを書く（引けなければ
+      // 断って既存の名前を残す）。画面から任意の名前を送れる形にすると、
+      // 名前の取り直しの顔をした自由な改名になる
+      var payload = { op: "refresh-channel-name", ref: s.ref };
+      if (s.workspace) payload.workspace = s.workspace;
+      sendConfig(payload, msg, btn, function () {
+        // 一覧は夜間のスナップショットなので、その場では変わらない。行だけ追いつかせる
+        var nameEl = card.querySelector(".ds-name");
+        if (nameEl) nameEl.textContent = r.name;
+        btn.disabled = true;
+      });
+    });
+    row.appendChild(btn);
+    row.appendChild(msg);
+    box.appendChild(row);
+    return box;
+  }
+
+  /**
+   * 「接続を確認」の一式（ボタン＋結果）。
+   *
+   * **押したら、その行の状態バッジを置き換える。** 夜間のスナップショットの判定と
+   * いま測った判定を**同じ行に並べない**ため——並べると「⚠️ と 接続OK が同時に出ている」
+   * になり、この節で3回直してきた食い違いを画面の側から作ることになる。
+   * 置き換えたことが分かるよう、いつ測ったかを必ず添える。
+   *
+   * **結果は保存しない。** fleet-status.json は夜間のスナップショットのまま置く
+   * （押すたびにコミットが増えるのを避ける）。表示名の取り直しだけが例外で、
+   * そちらは正本（channels.json）を直す価値があるので別のボタンで書き込む。
+   */
+  function probeSection(s, card, gateEl) {
+    var wrap = el("div", { class: "ds-probe" });
+    var head = el("div", { class: "ds-probe-head" });
+    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "接続を確認" });
+    var msg = el("span", { class: "ds-toggle-msg" });
+    var at = el("span", { class: "ds-probe-at" });
+    var body = el("div");
+    head.appendChild(btn);
+    head.appendChild(msg);
+    head.appendChild(at);
+    wrap.appendChild(head);
+    wrap.appendChild(body);
+
+    btn.addEventListener("click", async function () {
+      var intake = SITE.intake;
+      if (!intake) return;
+      btn.disabled = true;
+      msg.className = "ds-toggle-msg";
+      msg.textContent = "確認中…";
+      at.textContent = "";
+      body.textContent = "";
+      var payload = { type: "slack", ref: s.ref };
+      if (s.workspace) payload.workspace = s.workspace;
+      var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
+      try {
+        var res = await fetch(pfx + "op=probe&t=" + encodeURIComponent(intake.token), {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(payload),
+        });
+        var j = await res.json().catch(function () { return {}; });
+        if (!res.ok) {
+          // サーバの文言をそのまま出す（回数制限の案内・未対応のアダプタの説明を含んでいる）
+          msg.className = "ds-toggle-msg is-error";
+          msg.textContent = "✗ " + (j.message || "確認できませんでした。");
+          btn.disabled = false;
+          return;
+        }
+        msg.textContent = "";
+        var v = probeVerdict(s, j);
+        gateEl.className = "ds-gate " + v.cls;
+        gateEl.textContent = v.text;
+        at.textContent = "いま測った結果（" + (dsFmtTime(j.checkedAt) || "たった今") + "）";
+        probeHelpNodes(s, j).forEach(function (n) { body.appendChild(n); });
+        // **登録ファイルが channels.json の行にだけ出す。** 書き換える先がそこなので、
+        // dev-sources.json だけに載っている行（origin: explicit）では必ず 404 になる
+        // ——「登録を解除」が同じ理由で同じ条件を持っている
+        if (s.origin !== "explicit") {
+          var rename = renameChannelRow(s, j, card);
+          if (rename) body.appendChild(rename);
+        }
+      } catch (e) {
+        msg.className = "ds-toggle-msg is-error";
+        msg.textContent = "✗ 通信に失敗しました。";
+      }
+      btn.disabled = false;
+    });
+    return wrap;
+  }
+
   function removeChannelButton(s, card) {
     return removeButton({
       label: "登録を解除",
@@ -3517,7 +3801,7 @@ ${capabilityState.toString()}
     if (!list) return null;
 
     var box = el("div", { class: "ds-addform", "data-adder": "slack-workspace" }, [
-      el("div", { class: "ds-addform-title", text: "Slack ワークスペースを接続" }),
+      el("div", { class: "ds-addform-title", text: "お客様の Slack ワークスペースを接続" }),
       el("p", {
         class: "sec-how",
         text:
@@ -3526,6 +3810,22 @@ ${capabilityState.toString()}
           "お願いする権限は読み取りだけで、Cortex から投稿することはありません。" +
           "接続したあと、読み取りたいチャンネルにボットを招待し、この画面から追加してください。",
       }),
+      // **「これは何のためのものでないか」を書く（2026-08-18 の不具合報告）。**
+      // 社内ワークスペースのチャンネルが読めていない人が、設定する場所を探して
+      // ここへ来る。押すと社内ワークスペースの承認画面が出て必ず失敗し、
+      // 「もう一度お試しください」に従ってまた押す——何度試しても直らない。
+      //
+      // **箱そのものは消さない。** 直上の renderExternalAdders のコメントが警告している
+      // のと同じ失敗で、「顧客チャンネルがある案件だけ出す」にすると
+      // **新規案件（0件）＝一番繋ぎたい場面**でこの入口が消える。出したまま、
+      // 使う場面と使わない場面をここで言い切る
+      el("p", {
+        class: "sec-how ds-scope-note",
+        text:
+          "クラスメソッドの社内ワークスペース（Classmethod Group）のチャンネルには、この接続は使いません。" +
+          "社内のチャンネルは Cortex の中央ボットで読んでいるので、ここで接続しても読めるようにはなりません。" +
+          "社内のチャンネルが読めていない場合は、cortex の担当者にご連絡ください。",
+      }),
     ]);
 
     // 接続済みの一覧。**0件でも「まだありません」と書く**——空白だと、
@@ -3567,7 +3867,10 @@ ${capabilityState.toString()}
     }
     box.appendChild(listBox);
 
-    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "Slack ワークスペースを接続" });
+    // **ボタン自身に「お客様の」と書く（2026-08-18 の不具合報告）。** 社内チャンネルが
+    // 読めていない人が押したのはこのボタンで、当時の文言は「Slack ワークスペースを接続」
+    // ——誰のワークスペースの話かが書かれておらず、唯一それらしいボタンに見えた
+    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "お客様の Slack ワークスペースを接続" });
     var msg = el("div", { class: "ds-toggle-msg" });
     btn.addEventListener("click", async function () {
       var intake = SITE.intake;
@@ -4016,7 +4319,10 @@ ${capabilityState.toString()}
         title: ORIGIN_HELP[s.origin],
       }));
     }
-    var gate = DS_GATE[s.gate] || DS_GATE["unknown"];
+    var gate = dsGateOf(s);
+    // **「接続を確認」が押されたら、この要素を live の判定で置き換える**（probeSection）。
+    // 2つの判定を同じ行に並べないため、参照を持っておく
+    var gateEl = el("span", { class: "ds-gate " + gate.cls, text: gate.text });
     var card = el("div", { class: "ds-card" }, [
       el("div", { class: "ds-card-main" }, [
         el("span", { class: "ds-icon", text: meta.icon }),
@@ -4024,7 +4330,7 @@ ${capabilityState.toString()}
         dsNameEl(s.name || "", s.url),
       ]),
       badges,
-      el("span", { class: "ds-gate " + gate.cls, text: gate.text }),
+      gateEl,
     ]);
     // チャンネルの登録解除。書き込み経路（intake Lambda）がある案件でだけ出す。
     // **Slack だけ。** github は登録ファイルが別（dev-sources.json）で、下のトグルと
@@ -4082,6 +4388,27 @@ ${capabilityState.toString()}
         }));
       }
     }
+    // **「次に誰が何をするか」を、その行に書く（2026-08-18 の不具合報告）。**
+    // 状態（トークン未設定）だけを出していたので、設定する場所を探した人が直下の
+    // 顧客ワークスペースの接続へ吸い込まれた——社内チャンネルではそれが必ず失敗する。
+    // 文面は DS_GATE_NO_TOKEN が経路ごとに持つ（社内は連絡先・顧客は接続の導線）。
+    //
+    // **ボタンより後ろに置く。** カードは横並びの flex なので、間に挟むと
+    // 「登録を解除」が案内文の下の行へ落ちて、既存案件の行の形が変わる
+    if (gate.help) card.appendChild(el("p", { class: "ds-gate-help", text: gate.help }));
+    // 「接続を確認」（2026-08-19）。**押せる人を絞らない**——読むだけで設定を変えないので、
+    // 気づいた人がその場で確かめられるほうがよい（オーナー判断）。書き込みになる
+    // 「表示名を更新する」は、押した結果の中から別のボタンとして出る（probeSection）。
+    //
+    // **いまは Slack だけ。** GitHub は夜間の実測（probeGithubGate）が既にあるので繋ぐだけ、
+    // Backlog / Figma / Drive は実測そのものが新規になる。同じ型で足せるよう、
+    // 判定は infra/lambda/shared/slack-gate.mjs 側に置いてある（末尾に拡張点の説明がある）。
+    //
+    // **origin === "explicit" でも出す。** 確認は読むだけで、どの登録ファイル由来かに
+    // 関係なく効く（書き込みになる「表示名を更新する」だけが由来で出し分かれる）
+    if (SITE.intake && s.type === "slack" && s.ref) {
+      card.appendChild(probeSection(s, card, gateEl));
+    }
     return card;
   }
 

package/package.json

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