@takagaki/cortex-decisions-viewer 0.4.84 → 0.5.0

package/dist/build.js

@@ -152,6 +152,9 @@ async function readFleetSources(repoRoot) {
             // （このマッピングは素通しではなく明示の許可リスト）。落とすと、同じIDの
             // チャンネルを2つのワークスペースに持つ案件で「登録を解除」が別の行を消す
             workspace: s.workspace != null ? String(s.workspace) : undefined,
+            // **厳密比較。** サーバは true しか書かないので、
+            // 他の値（"true" や 1）を印として扱わない
+            orgUnknown: s.orgUnknown === true ? true : undefined,
         }))
         : undefined;
     // 接続済み Slack ワークスペース（#104）。**空配列と undefined を区別して通す**——

package/dist/render.js

@@ -1151,6 +1151,26 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-group[open] > summary { border-bottom-left-radius: 0; border-bottom-right-radius: 0; }
 .ds-group > .ds-list { margin-top: 8px; padding-left: 12px; border-left: 2px solid var(--border); }
 .badge.ds-sum-ok { background: #e9f7ef; color: #1f7a45; }
+/* 「断定しない」——古い fleet-status では接続状態が分からない。OKとも警告とも言わない */
+.ds-sum-unknown { background: var(--bg); color: var(--muted); }
+/* 組織が分かっていない行のラベル。**警告色にする**（並びの中で見つかる必要がある） */
+.badge.ds-workspace-unknown { border-color: #f0b429; color: #8a5a00; background: #fff8e6; }
+/* 組織についての案内。行ではないので、行と見分けが付く形にする */
+.ds-orgnote {
+  border: 1px solid #f0b429; background: #fffdf5; border-radius: 12px;
+  padding: 12px 16px; display: flex; flex-direction: column; gap: 8px;
+}
+.ds-orgnote-title { font-weight: 700; font-size: 13.5px; color: #8a5a00; }
+/* 案内が指す行。**囲うことで「どのチャンネルの話か」を示す**（開閉はしない） */
+.ds-orgnote-rows { display: flex; flex-direction: column; gap: 8px; margin-top: 2px; }
+/* 手順のリスト。番号を出し、1手ずつ離す（一続きの文章にしない） */
+.sec-steps { margin: 0; padding-left: 1.35em; display: flex; flex-direction: column; gap: 8px; }
+.sec-steps li { line-height: 1.75; }
+.sec-steps li > span { display: block; }
+.ds-group-body { display: flex; flex-direction: column; gap: 10px; padding: 4px 0 2px; }
+/* 組のまとまりを、行より弱い線で示す */
+.ds-group-note { font-size: 13px; color: var(--muted); line-height: 1.7; margin: 0; }
+.ds-group-note strong { color: var(--text); }
 .badge.ds-sum-warn { background: #fef3c7; color: #92400e; border: 1px solid #fcd34d; }
 /* ---- 接続マップ（操作タブ最上部のSVG図） ---- */
 .conn-map { overflow-x: auto; margin: 4px 0 20px; }
@@ -1298,7 +1318,13 @@ a.ds-name:hover { text-decoration: underline; }
    夜間のスナップショットの状態バッジと**同時に2つの判定を並べない**ため、押したあとは
    状態バッジをこの中の判定へ置き換える（同じ画面で「⚠️」と「接続OK」が並ぶのが、
    この節で3回直してきた壊れ方そのもの） */
-.ds-probe { flex: 1 1 100%; margin-top: 8px; padding-top: 8px; border-top: 1px dashed var(--border); }
+/* 押した結果の詳細。**押されるまでは何も出さない。**
+   以前は中身が空でも点線だけが全行に出ており、何も意味していなかった（2026-08-20） */
+.ds-probe { display: none; }
+.ds-probe.is-shown {
+  display: block; 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); }
@@ -1402,7 +1428,7 @@ a.ds-name:hover { text-decoration: underline; }
 button.ops-card-btn { cursor: pointer; }
 button.ops-card-btn:disabled { opacity: .6; cursor: default; }
 /* ---- 投入モーダル ---- */
-.modal-overlay {
+.modal-overlay, .confirm-overlay {
   position: fixed; inset: 0; z-index: 100; display: flex; align-items: center; justify-content: center;
   background: rgba(16,24,40,0.45); padding: 20px;
   -webkit-backdrop-filter: blur(2px); backdrop-filter: blur(2px);
@@ -1434,6 +1460,12 @@ button.ops-card-btn:disabled { opacity: .6; cursor: default; }
   background: var(--surface); color: var(--muted); font-size: 13px; font-weight: 600; cursor: pointer;
 }
 .modal-cancel:hover { background: var(--bg); }
+/* 確認モーダル。能力モーダルの上に重なるので z-index は上（下地は inert で塞ぐ） */
+.confirm-overlay { z-index: 110; }
+.confirm-box { max-width: 420px; gap: 10px; }
+/* 貼ったURLを1行で出すので、はみ出させない（箱は420px・モバイルは実質335px） */
+.confirm-line { font-size: 14px; color: var(--text); line-height: 1.75; margin: 0; white-space: pre-wrap; overflow-wrap: anywhere; }
+.confirm-line:first-child { font-weight: 700; }
 .modal-ok { color: #047857; font-weight: 600; }
 .modal-status-error { color: #dc2626; font-weight: 600; }
 .modal-paths { margin-top: 8px; display: flex; flex-direction: column; gap: 4px; }
@@ -2050,7 +2082,7 @@ ${capabilityState.toString()}
    * Slack のチャンネルは、どのワークスペースにあるかで読み取りの鍵が別物になる:
    *   - workspace 省略 … クラスメソッドの社内ワークスペース。中央 Bot の鍵（案件リポジトリの
    *     設定）で読む。**画面から設定できるものが1つも無い。**
-   *   - workspace: "T…" … お客様のワークスペース。下の「お客様の Slack ワークスペースを接続」で
+   *   - workspace: "T…" … お客様のワークスペース。「Slack ワークスペースに接続する」で
    *     承認を貰って読む。**画面から自己解決できる。**
    *
    * どちらも no_token に潰して「トークン未設定」と出していたため、社内チャンネルを
@@ -2067,13 +2099,17 @@ ${capabilityState.toString()}
     internal: {
       text: "管理者の設定が必要です",
       cls: "ds-gate-muted",
-      help: "このチャンネルはクラスメソッドの社内ワークスペースにあります。読み取りを始めるには cortex 側（管理者）の設定が必要で、下の「お客様の Slack ワークスペースを接続」では設定できません。cortex の担当者にご連絡ください。",
+      // **「この画面では設定できません」を必ず言う（2026-08-18 の不具合）。**
+      // 状態だけを出していたので、設定する場所を探した人が
+      // 顧客ワークスペースの接続へ吸い込まれ、押しても必ず失敗する画面を
+      // 何度も試した。**次に誰が何をするか**まで書く
+      help: "このチャンネルはクラスメソッドの社内ワークスペースにあります。読み取りを始めるには cortex 側（管理者）の設定が必要で、この画面では設定できません。cortex の担当者にご連絡ください。",
     },
     // お客様のワークスペース。従来どおり接続へ誘導する（自己解決できる唯一の経路）
     customer: {
       text: "トークン未設定",
       cls: "ds-gate-muted",
-      help: "このチャンネルがあるお客様の Slack ワークスペースが、まだ接続されていない（または接続が切れている）状態です。下の「お客様の Slack ワークスペースを接続」から接続してください。",
+      help: "このチャンネルがあるお客様の Slack ワークスペースが、まだ接続されていない（または接続が切れている）状態です。「Slack ワークスペースに接続する」から接続してください。",
     },
   };
   /**
@@ -2127,6 +2163,331 @@ ${capabilityState.toString()}
     var allInternal = noToken.every(function (s) { return isInternalSlack(s); });
     return head + "が読めていません（" + (allInternal ? "管理者の設定が必要です" : "トークン未設定") + "）";
   }
+  /**
+   * Slack のチャンネルを、所属する組織ごとに分ける（2026-08-20）。
+   *
+   * ## なぜ純関数にするか
+   *
+   * ここが**判断の全部**。描画に混ぜると「どう分けたか」を実測できなくなる。
+   * sourceGroup は受け取ったものを並べるだけで、意味を持たない
+   * （GitHub は組織・Backlog はスペースで同じ形が要るため）。
+   *
+   * ## 分け方
+   *
+   * 1. workspace（team_id）があれば、その組織。表示名は台帳から引く
+   * 2. orgUnknown の印が付いていれば「組織が分かりません」
+   * 3. どちらも無ければ社内（クラスメソッド）
+   *
+   * **印を先に見ない。** 判定が済んで workspace が入った行にも、
+   * 古いデータでは印が残っているかもしれない——**決まっている方を信じる**。
+   *
+   * ## 「分かりません」に入れる条件（ここが誤りやすい）
+   *
+   * **印が唯一の目印。** 夜間の実測（gate: "unreachable"）で判断してはいけない——
+   * unreachable はアーカイブ・削除・URLの打ち間違いでも起きるので、
+   * それを「組織が分かりません」と出すと**誤った案内**になる。
+   * 印はサーバが「全部の鍵で届かなかった」と実測した記録なので、意味が違う。
+   *
+   * @param items チャンネルの行（fleet-status の externalSources のうち type === "slack"）
+   * @param workspaces 台帳（slackWorkspaces() の返り値。null なら「知らない」）
+   * @returns [{ key, title, items, unknown }]  key は並びの安定のためだけに使う
+   */
+  function groupSlackByOrg(items, workspaces) {
+    var known = {};
+    (workspaces || []).forEach(function (w) { if (w && w.teamId) known[w.teamId] = w.name || w.teamId; });
+    var order = [];
+    var byKey = {};
+    (items || []).forEach(function (s) {
+      var key, title, unknown = false;
+      if (s.workspace) {
+        key = s.workspace;
+        // **台帳に無ければ team_id を出す。** 空欄より、少なくとも突き合わせられる
+        title = known[s.workspace] || s.workspace;
+      } else if (s.orgUnknown === true) {
+        key = "__unknown__";
+        title = "組織不明";
+        unknown = true;
+      } else {
+        key = "__internal__";
+        title = "クラスメソッド";
+      }
+      var g = byKey[key];
+      if (!g) { g = { key: key, title: title, items: [], unknown: unknown }; byKey[key] = g; order.push(g); }
+      g.items.push(s);
+    });
+    // **社内を先、「分かりません」を最後にする。** 分かりませんが先頭に来ると、
+    // 直すものが無い人にも毎回それが最初に見える
+    order.sort(function (a, b) {
+      var rank = function (g) { return g.key === "__internal__" ? 0 : g.unknown ? 2 : 1; };
+      return rank(a) - rank(b);
+    });
+    return order;
+  }
+
+  /**
+   * 会議の取り込みの案内。**操作ではなく条件を示す。**
+   *
+   * 取り込まれるには2つとも要る:
+   *   ① cortex-notetaker Bot が会議に招待されている（＝取り込む意思。これが同意のゲート）
+   *   ② 会議名が照合キーのどれかを含む（含まなければ、録れても案件に振り分けられない）
+   *
+   * ②の材料を画面が出さないと、招待したのに届かない理由が分からない。
+   */
+  function meetingHowTo() {
+    // **2つの条件がANDであることを、読み飛ばせない形で出す。** 散文で並べていたときに
+    // 「会議名は合っているのにBotを招待しておらず取り込まれなかった」事故が実際に起きた。
+    // 会議名の条件は上の行（ds-keys）が出すので、ここでは「上の語」と参照するに留める。
+    var wrap = el("div", { class: "sec-how" });
+    wrap.appendChild(el("p", { text: "次の2つが揃った会議だけが取り込まれます。" }));
+    var ul = el("ul", { class: "sec-how-list" });
+    ul.appendChild(el("li", { text: "cortex-notetaker Bot が招待されている（定例はシリーズに1回でOK）" }));
+    ul.appendChild(el("li", { text: "会議名に上の目印が入っている" }));
+    wrap.appendChild(ul);
+    wrap.appendChild(el("p", { text: "どちらか一方だけでは取り込まれません。" }));
+    return wrap;
+  }
+
+  /**
+   * Slack の承認画面へ進むボタン（2026-08-20 に接続カードから切り出した）。
+   *
+   * ## 押す人についての注意を必ず添える
+   *
+   * **承認画面はワークスペースを指定できない**（開始の口に team を渡す口が無い）。
+   * **承認する人がログインしているワークスペース**にボットが入る。だから
+   * 「〈お客様の名前〉と接続する」とは書けない——保証できないことを書かない。
+   *
+   * お客様の Slack なら、クラスメソッドの人間は押せないことが多い
+   * （その Slack の管理者にお願いすることになる）。それを書かないと、
+   * 押しても進まない人が「壊れている」と読む。
+   */
+  function slackConnectButton() {
+    var wrap = el("div", { class: "ds-toggle" });
+    // **「この」を付けない（2026-08-20・オーナー指摘）。**
+    // どのワークスペースを指すのか読み取れない——そもそも**指定できない**
+    // （承認する人がログインしているワークスペースに入る）ので、
+    // 特定のものを指すような書き方は嘘にもなる
+    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;
+      if (!intake) return;
+      btn.disabled = true;
+      msg.className = "ds-toggle-msg";
+      msg.textContent = "承認画面を準備しています…";
+      try {
+        var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
+        var res = await fetch(pfx + "op=slack-oauth-start&t=" + encodeURIComponent(intake.token), {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: "{}",
+        });
+        var j = await res.json().catch(function () { return {}; });
+        if (!res.ok || !j.url) {
+          // サーバの文言をそのまま出す（未設定のときは「準備中です」が返る）
+          msg.className = "ds-toggle-msg is-error";
+          msg.textContent = "✗ " + (j.message || "接続を開始できませんでした。");
+          btn.disabled = false;
+          return;
+        }
+        // **同じタブで遷移する。** 別タブだと、承認後の「接続しました」を見た人が
+        // 元のタブに戻る動線を自分で見つけることになる
+        location.href = j.url;
+      } catch (e) {
+        msg.className = "ds-toggle-msg is-error";
+        msg.textContent = "✗ 接続を開始できませんでした。時間をおいて試してください。";
+        btn.disabled = false;
+      }
+    });
+    wrap.appendChild(el("p", {
+      class: "ds-group-note",
+      text: "ボタンを押すと Slack の承認画面が開きます。承認できるのは、その Slack の管理者だけです"
+        + "（お客様の Slack なら、お客様の管理者にお願いしてください）。"
+        + "お願いする権限は読み取りだけで、Cortex から投稿することはありません。",
+    }));
+    wrap.appendChild(btn);
+    wrap.appendChild(msg);
+    return wrap;
+  }
+
+  /** 台帳から、そのワークスペースの接続状態を引く（無ければ null＝断定しない） */
+  function tokenStateOf(workspaces, teamId) {
+    var list = workspaces || [];
+    for (var i = 0; i < list.length; i++) {
+      if (list[i] && list[i].teamId === teamId) return list[i].tokenState || null;
+    }
+    return null;
+  }
+
+  /**
+   * 「組織が分かりません」の行を、サーバに判定し直してもらう（2026-08-20）。
+   *
+   * **1回の表示につき1度だけ。** 組が複数あっても、呼ぶのは1回。
+   *
+   * ## 結果をその場で反映しない理由
+   *
+   * この画面が読んでいるのは**夜間に作られた実測ファイル**で、
+   * 設定ファイルを直しても表示はすぐ変わらない。**嘘をつくよりは待たせる**——
+   * 「反映しました」とだけ言い、表示が変わる時期を書く。
+   * （設定を変える他の操作も同じ約束で「次回の Gold 昇格から反映されます」と言っている）
+   */
+  var orgResolveDone = false;
+  function requestOrgResolve() {
+    if (orgResolveDone) return;
+    orgResolveDone = true;
+    var intake = SITE.intake;
+    if (!intake) return;
+    var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
+    // **描画の途中で投げない。** ここは行を組み立てている最中に呼ばれるので、
+    // 例外が出ると**画面そのものが描かれない**（fetch が無い環境で実際にそうなった）。
+    // 判定し直しは「できたら直る」性質のもので、失敗しても行は
+    // 「組織が分かりません」のまま残る——画面を落としてまでやることではない。
+    //
+    // **守りは二重（この行と下の try/catch）。** 片方だけ消しても
+    // もう片方が受けるので変異検証では赤にならないが、**両方消すと6件赤**になる
+    // （実際に当てて確かめた）。二重なのは、投げ方が2通りあるため——
+    // fetch が存在しない（ReferenceError）と、呼び出しが投げる
+    if (typeof fetch !== "function") return;
+    try {
+    fetch(pfx + "op=slack-resolve&t=" + encodeURIComponent(intake.token), {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: "{}",
+    })
+      .then(function (res) { return res.ok ? res.json() : null; })
+      .then(function (j) {
+        if (!j || !j.resolved) return;
+        // **表示は次の更新まで変わらない。** それを書かないと、
+        // 「反映したのに何も変わらない」と読まれてもう一度押すことになる
+        var note = document.querySelector(".ds-org-resolved");
+        if (!note) return;
+        note.textContent = "✓ " + j.resolved + "件の所属を反映しました（この一覧の表示は次回の更新・毎晩22時ごろから正しくなります）。";
+      })
+      .catch(function () {
+        // **黙って諦める。** 直せなかっただけで、行は「組織が分かりません」のまま残る。
+        // 利用者にできることは変わらないので、失敗を出しても迷わせるだけ
+      });
+    } catch (e) {
+      // 同上。呼び出しそのものが投げても画面は描く
+    }
+  }
+
+  /**
+   * Slack のチャンネルを**平らに**並べる（2026-08-20）。
+   *
+   * ## なぜ折りたたみをやめたか
+   *
+   * オーナー指摘:
+   * > それぞれのワークスペースごとにセクション分けしてるけど、普通に並べて、
+   * > 他の接続OKとかの横にどのワークスペースを出すだけでいい。
+   * > 開いて閉じてみたいな感じで並ぶ必要があんまりわかんない。なんか複雑になっちゃってる。
+   *
+   * **並び順は組織ごと**（社内 → 顧客 → 分かりません）にするが、**箱で囲まない**。
+   * どの組織かは**行のラベル**が示す（同じチャンネル名が2つの組織に並びうるので、
+   * ラベル自体は必要）。
+   *
+   * ## 「組織が分かりません」の案内だけは別
+   *
+   * 3つの原因と、招待コマンド・接続ボタン・登録の解除が要る。**行ごとに繰り返すと
+   * 一覧が案内で埋まる**ので、その並びの手前に1つだけ置く。
+   */
+  function slackRows(items, meta) {
+    var ws = slackWorkspaces();
+    var out = [];
+    groupSlackByOrg(items, ws).forEach(function (g) {
+      var cards = g.items.map(function (x) { return extSourceCard(x, meta); });
+      if (g.unknown) {
+        // **開いたときに1度だけ、判定し直しをサーバへ頼む。**
+        // 承認が通っても、誰かが判定し直さなければ設定ファイルは古いまま。
+        // OAuth の戻り先は固定ページ（この画面には戻らない）ので、
+        // **利用者が操作タブを開き直したこの瞬間**が唯一の合図になる
+        requestOrgResolve();
+        // **案内が行を抱える（2026-08-20・オーナー指摘）。**
+        // 「次のチャンネル」と書いても、囲われていないと**どれを指すのか分からない**。
+        // 折りたたみは付けない——開閉させたいのではなく、**範囲を示したい**
+        out.push(orgNoteBox(unknownOrgNodes(), cards));
+        return;
+      }
+      if (g.key !== "__internal__") {
+        var st = tokenStateOf(ws, g.key);
+        // **接続が切れたときの導線を必ず残す。** それまでは接続カードの中の一覧に
+        // 出していた。カードごと消したので、ここへ移す——移さないと
+        // **接続が切れたことに気づけず、直す手段も画面から消える**
+        if (st === "revoked" || st === "missing") {
+          out.push(orgNoteBox(brokenOrgNodes(g.title, st), cards));
+          return;
+        }
+      }
+      cards.forEach(function (n) { out.push(n); });
+    });
+    return out;
+  }
+
+  /**
+   * 案内と、その案内が指す行を1つの箱にまとめる（2026-08-20）。
+   *
+   * **囲わないと「次のチャンネル」がどれを指すのか分からない**（オーナー指摘）。
+   * **折りたたみは付けない**——開閉させたいのではなく、範囲を示したいだけ。
+   */
+  function orgNoteBox(noteNodes, cards) {
+    var box = el("div", { class: "ds-orgnote" });
+    noteNodes.forEach(function (n) { if (n) box.appendChild(n); });
+    var list = el("div", { class: "ds-orgnote-rows" });
+    cards.forEach(function (c) { list.appendChild(c); });
+    box.appendChild(list);
+    return box;
+  }
+
+  /** 「組織不明」の案内。**原因を1つに絞らない** */
+  function unknownOrgNodes() {
+    // **接続だけを勧めると、招待すれば済む人に「直らない処方」を出す。**
+    // 非公開チャンネルは、同じ Slack でも招待前は「存在しない」と返る
+    var out = [];
+    // **「読めませんでした」では、行の「Slackで招待してください」と区別が付かない**
+    //（オーナー指摘・2026-08-20）。どちらも読めていないが、**分かっていることが違う**:
+    //   行に「招待してください」… クラスメソッドのチャンネルだと**分かっている**。招待だけが足りない
+    //   この案内             … **どのSlackのものかすら分からない**（どの鍵でも届かなかった）
+    // 状態の名前を「分かりません」に揃える
+    out.push(el("div", { class: "ds-orgnote-title", text: "⚠️ 組織不明のチャンネル" }));
+    out.push(el("p", {
+      class: "ds-group-note",
+      text: "Cortex が持っているどの鍵でも、このチャンネルに届きませんでした。次のどれかです。",
+    }));
+    var ul = el("ul", { class: "ds-group-note" });
+    // **公開との違いをここで言い切る。** 「同じ未招待なのに、なぜ上の行は
+    // 組織が分かっていて、こちらは分からないのか」が読み取れないと、
+    // 利用者は同じ状態が2通りに見えることに戸惑う
+    ul.appendChild(el("li", { text: "非公開チャンネルで、まだ Cortex を招待していない → 下のコマンドを Slack のそのチャンネルに貼ってください" }));
+    ul.appendChild(el("li", { text: "お客様の Slack にあり、まだつながっていない → 下のボタンから接続します" }));
+    ul.appendChild(el("li", { text: "チャンネルがアーカイブ／削除された、URLが違う → 「登録を解除」を押してください" }));
+    out.push(ul);
+    out.push(copyRow("/invite @Cortex"));
+    out.push(slackConnectButton());
+    // 判定し直しの結果を出す場所（何も起きなければ空のまま）
+    out.push(el("p", { class: "ds-group-note ds-org-resolved" }));
+    return out;
+  }
+
+  /** 接続が切れた／未接続のワークスペースの案内 */
+  function brokenOrgNodes(title, state) {
+    var out = [];
+    out.push(el("div", {
+      class: "ds-orgnote-title",
+      text: state === "revoked" ? "⚠️ " + title + " との接続が切れています" : "⚠️ " + title + " はまだ接続されていません",
+    }));
+    out.push(el("p", {
+      class: "ds-group-note",
+      // **revoked と missing を分ける。** 前者は「接続し直して」、後者は「まだ完了していない」で
+      // 次の一手が違う。unknown には何も出さない——繋がっているのに
+      // 「接続し直して」と言う方が、黙っているより悪い
+      text: state === "revoked"
+        ? "Slack 側で Cortex のアプリが削除されたか、接続が無効になっています。もう一度接続してください。"
+        : "このワークスペースのチャンネルが登録されていますが、接続が見つかりません。もう一度接続してください。",
+    }));
+    out.push(slackConnectButton());
+    return out;
+  }
+
+
   var DS_KIND_ICON = {
     "課題管理": "📋",
     "会議": "🗒️",
@@ -2283,7 +2644,7 @@ ${capabilityState.toString()}
     // **何が読み取られるのかを必ず書く。** 一覧に並ぶものと読み取られるものの関係は、
     // 書いていないと分からない（チャットは「載っていれば全部」、開発はリポジトリ単位でOFFできる）
     if (cap === "チャット") {
-      m.modal.appendChild(el("p", { class: "modal-desc", text: "ここに並んでいるチャンネルは、例外なく全て毎晩の Gold 昇格が読み取り、顧客も見る Decision・用語集の材料になります。読み取りを止めるには「登録を解除」してください。" }));
+      m.modal.appendChild(el("p", { class: "modal-desc", text: "ここに並んでいるチャンネルは、例外なく全て毎晩の Gold 昇格が読み取り、Decision・用語集の材料になります。読み取りを止めるには「登録を解除」してください。" }));
     } else if (cap === "開発") {
       m.modal.appendChild(el("p", { class: "modal-desc", text: "ここに並んでいるリポジトリの Issues を毎晩の Gold 昇格が読み取ります。リポジトリ単位で読み取りを止められます（止めたものは読み取られません）。" }));
     }
@@ -2517,6 +2878,14 @@ ${capabilityState.toString()}
       var UNIT = { "slack": "チャンネル", "github-issues": "リポジトリ", "github-discussions": "リポジトリ" };
       groups.forEach(function (g) {
         var meta = DS_TYPE[g.type] || { icon: "🔗", label: g.type || "その他" };
+        // **Slack は所属する組織ごとに分ける（2026-08-20）。**
+        // 追加のときにワークスペースを選ばせるのをやめたので、
+        // 「どの組織のものか」「その組織とつながっているか」を画面が言う。
+        // 分け方は groupSlackByOrg（純関数）が全部持っている
+        if (g.type === "slack") {
+          slackRows(g.items, meta).forEach(function (n) { pushCap("チャット", n); });
+          return;
+        }
         var cards = el("div", { class: "ds-list" });
         g.items.forEach(function (s) { cards.appendChild(extSourceCard(s, meta)); });
         if (g.items.length >= 4) {
@@ -2547,9 +2916,18 @@ ${capabilityState.toString()}
     // **追加フォームはグループの外に置く。** グループは0件だと描かれず、4件以上だと
     // 畳まれる（既定は閉）。中に入れると**新規案件（0件）＝一番追加したい場面**で消える。
     var adders = renderExternalAdders();
-    // **接続の入口はチャンネル追加より前に置く。** 顧客ワークスペースを繋いでいない状態で
-    // 先に追加フォームを見せると、貼れるのに読まれないチャンネルを登録することになる
-    pushCap("チャット", slackConnectBox());
+    // **接続の入口は「読み取れていない」組にだけ出す（2026-08-20）。**
+    //
+    // それまでは「お客様の Slack ワークスペースを接続」という独立した節を
+    // チャンネル追加より前に置いていた。オーナーの受け入れテストで
+    // 「モーダルを開いても何から始めればいいか分からない」と指摘された——
+    // 接続が先なのか追加が先なのか、そもそも自分に関係あるのかが読み取れない。
+    //
+    // **接続は「準備」ではなく、必要になった行から始まる。**
+    // 当時の警告コメント（「箱そのものは消さない。0件の案件で入口が消える」）は
+    // **新しい形が別の解き方をしている**——チャンネルを追加すれば
+    // 読み取れていない組として現れ、そこに接続ボタンが出る。
+    // 0件なら繋ぐ相手もまだ無いので、入口が要る場面にならない。
     pushCap("チャット", adders.querySelector('[data-adder="slack"]'));
     // **組織ごとの接続状況を、開発の一番上に置く。** トークンは組織ごとにしか
     // 効かない（Fine-grained PAT も GitHub App のインストールトークンも1組織分）ので、
@@ -2979,7 +3357,7 @@ ${capabilityState.toString()}
 
     // 注記は全能力の後ろに1つ。**何が Gold の材料になるのかを1文で言う。**
     if (anyCap) {
-      sec.appendChild(el("p", { class: "ds-note", text: "登録されている Slack チャンネルと GitHub リポジトリは、毎晩の Gold 昇格が読み取り、顧客も見る Decision・用語集の材料になります。チャンネルは登録を解除すると、リポジトリは読み取りを止めると、以後は読み取られません。" }));
+      sec.appendChild(el("p", { class: "ds-note", text: "登録されている Slack チャンネルと GitHub リポジトリは、毎晩の Gold 昇格が読み取り、Decision・用語集の材料になります。チャンネルは登録を解除すると、リポジトリは読み取りを止めると、以後は読み取られません。" }));
     }
 
     if (pipes.length) {
@@ -3141,7 +3519,7 @@ ${capabilityState.toString()}
       // 長い説明は落とし、次の行動の1行だけ残す
       return [p(isInternalSlack(s)
         ? "cortex の担当者にご連絡ください。"
-        : "下の「お客様の Slack ワークスペースを接続」から接続してください。")];
+        : "「Slack ワークスペースに接続する」から接続してください。")];
     }
     if (r.gate === "unreachable") {
       return [p("チャンネルが見つからないか、アーカイブされています。不要なら「登録を解除」してください。")];
@@ -3210,14 +3588,24 @@ ${capabilityState.toString()}
    * （押すたびにコミットが増えるのを避ける）。表示名だけが例外で、そちらは
    * Slack の実名が正なので自動で揃える（autoAlignName）。
    */
+  /**
+   * 接続の確認。
+   *
+   * **ボタンは行の中（「登録を解除」の隣）に置く（2026-08-20）。**
+   * それまでは行の下に独立した段を作っており、**1行が2段になって一覧が長かった**
+   * （オーナー指摘「レコードをそれぞれもうちょっと短くできるよね」）。
+   * 押した結果の詳細（測った時刻・次の一手）は下に出す——**押すまでは空**なので、
+   * 一覧を眺めているだけの人には行が伸びない。
+   *
+   * @returns { btn, detail } btn は行に、detail は行の下に置く
+   */
   function probeSection(s, card, gateEl) {
+    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "接続を確認" });
     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);
@@ -3227,6 +3615,10 @@ ${capabilityState.toString()}
       var intake = SITE.intake;
       if (!intake) return;
       btn.disabled = true;
+      // **押されて初めて枠を出す（2026-08-20・オーナー指摘）。**
+      // それまでは中身が空でも点線だけが全行に出ており、**何も意味していなかった**。
+      // 押した結果があるときだけ、行と結果を分ける線になる
+      wrap.className = "ds-probe is-shown";
       msg.className = "ds-toggle-msg";
       msg.textContent = "確認中…";
       at.textContent = "";
@@ -3272,7 +3664,7 @@ ${capabilityState.toString()}
       }
       btn.disabled = false;
     });
-    return wrap;
+    return { btn: btn, detail: wrap };
   }
 
   function removeChannelButton(s, card) {
@@ -3427,11 +3819,11 @@ ${capabilityState.toString()}
       ]);
       if (!editable) return row;
       var btn = el("button", { class: "ds-toggle-btn ds-danger", type: "button", text: "この接続先を外す" });
-      btn.addEventListener("click", function () {
+      btn.addEventListener("click", async function () {
         // **最後の1件かどうかは「押した時点」で数える。** 描画時の件数で決めると、
         // 2件を1件ずつ外したとき最後の1件で確認が出ない（Figma で踏んだのと同じ）
         var last = targets.length === 1;
-        if (!confirmDanger(removeTargetConfirmLines(t, last))) { msg.textContent = ""; return; }
+        if (!(await confirmDanger(removeTargetConfirmLines(t, last), { returnTo: btn }))) { msg.textContent = ""; return; }
         var payload = {
           op: "backlog-target-remove",
           // **projectKey では送らない。** body の projectKey は案件キー（cortex の
@@ -3487,25 +3879,7 @@ ${capabilityState.toString()}
         title: "＋ 接続先を追加",
         placeholder: "https://<スペース>.backlog.jp/projects/<プロジェクトキー>",
         requiredNote: "BacklogのURLを入力してください（プロジェクトキーが入った形。数字だけのURLは受け付けません）。",
-        hint: "Backlog でこの案件のプロジェクトを開き、ブラウザのURLをそのまま貼ってください（課題の画面のURLでも構いません）。APIキーは下の「Backlog のAPIキー」から別に登録します。",
-        confirmLines: function (v) {
-          // **解析した結果を見せる。** 貼ったURLをそのまま出すと、どのプロジェクトを
-          // 指すことになるかが確定前に分からない。実際 /projects/PJ-CORTEX は
-          // ハイフンで切れて PJ と解釈される（黙って別プロジェクトを指す）
-          var t = backlogTargetOf(v);
-          return [
-            "この案件が同期する Backlog プロジェクトを追加します。",
-            "",
-            t ? t.domain + " / " + t.projectKey : v,
-            "",
-            "このプロジェクトの課題・ドキュメント・Wiki が、次の同期から取り込まれます。",
-            "貼ったURLがこの案件のものか、もう一度確認してください。",
-            "",
-            "※ 増えるのは同期先だけです。ビューアからの起票先は変わりません。リアルタイム同期を使う場合は、追加したプロジェクトの Backlog 側にも案件専用URLの登録が要ります。",
-            "",
-            "追加しますか？",
-          ];
-        },
+        hint: "Backlog でこの案件のプロジェクトを開き、ブラウザのURLをそのまま貼ってください（課題の画面のURLでも構いません）。APIキーは下の「Backlog のAPIキー」から別に登録します。増えるのは同期先だけで、ビューアからの起票先は変わりません。リアルタイム同期を使う場合は、追加したプロジェクトの Backlog 側にも案件専用URLの登録が要ります。",
         build: function (url) {
           return { op: "backlog-target-add", url: url, baseGeneration: targetsGenerationOf(targets) };
         },
@@ -3646,17 +4020,6 @@ ${capabilityState.toString()}
           namePlaceholder: "メモ（任意）",
           requiredNote: "フォルダのURLを入力してください。",
           hint: "このフォルダの中身が 共有資料 にコピーされ、Markdown 化されます。取り込み用アカウントをそのフォルダの閲覧者に招待しておいてください（招待が無いと読めません）。",
-          confirmLines: function (v) {
-            return [
-              "このフォルダの中身を、顧客も見るリポジトリにコピーします。",
-              "",
-              "貼ったURLがこの案件のものか、もう一度確認してください。",
-              "",
-              v,
-              "",
-              "追加しますか？",
-            ];
-          },
           build: function (url, name) { return { op: "add-drive-folder", url: url, name: name }; },
         }));
         // **ON/OFFのトグルは出さない。** フォルダを追加した時点で取り込みは始まる
@@ -3755,17 +4118,6 @@ ${capabilityState.toString()}
         namePlaceholder: "メモ（任意）",
         requiredNote: "FigmaのURLを入力してください。",
         hint: "このファイルの画面インベントリ（画面名・Figmaへのリンク）が毎晩同期されます。画像は取り込まれません。",
-        confirmLines: function (v) {
-          return [
-            "このFigmaファイルの画面名とFigmaへのリンクを、顧客も見るリポジトリに取り込みます（画像は取り込みません）。",
-            "",
-            "貼ったURLがこの案件のものか、もう一度確認してください。",
-            "",
-            v,
-            "",
-            "追加しますか？",
-          ];
-        },
         build: function (url, name) { return { op: "add-figma-file", url: url, name: name }; },
       }));
       used = true;
@@ -3774,156 +4126,6 @@ ${capabilityState.toString()}
     return used ? box : null;
   }
 
-  /**
-   * 会議の取り込みの案内。**操作ではなく条件を示す。**
-   *
-   * 取り込まれるには2つとも要る:
-   *   ① cortex-notetaker Bot が会議に招待されている（＝取り込む意思。これが同意のゲート）
-   *   ② 会議名が照合キーのどれかを含む（含まなければ、録れても案件に振り分けられない）
-   *
-   * ②の材料を画面が出さないと、招待したのに届かない理由が分からない。
-   */
-  function meetingHowTo() {
-    // **2つの条件がANDであることを、読み飛ばせない形で出す。** 散文で並べていたときに
-    // 「会議名は合っているのにBotを招待しておらず取り込まれなかった」事故が実際に起きた。
-    // 会議名の条件は上の行（ds-keys）が出すので、ここでは「上の語」と参照するに留める。
-    var wrap = el("div", { class: "sec-how" });
-    wrap.appendChild(el("p", { text: "次の2つが揃った会議だけが取り込まれます。" }));
-    var ul = el("ul", { class: "sec-how-list" });
-    ul.appendChild(el("li", { text: "cortex-notetaker Bot が招待されている（定例はシリーズに1回でOK）" }));
-    ul.appendChild(el("li", { text: "会議名に上の目印が入っている" }));
-    wrap.appendChild(ul);
-    wrap.appendChild(el("p", { text: "どちらか一方だけでは取り込まれません。" }));
-    return wrap;
-  }
-
-  /* ---------------------------------------------------------------------------
-   * Slack ワークスペースの接続（#104）
-   *
-   * 顧客のワークスペースを読み始める日の入口。押す → サーバが署名つきの承認リンクを
-   * 作って返す → そこへ遷移 → 顧客が Slack で承認 → 別の Lambda が受け取って棚に鍵を入れる。
-   *
-   * **リンクを静的に焼き込まない。** 承認リンクには「この案件へ書き込んでよい」という
-   * 10分間有効な署名（state）が載っている。HTML に埋めると、配信物を読める人（＝その案件の
-   * Basic 認証を通れる人）が期限のないリンクを手に入れることになるし、
-   * ビルド時点の state はどのみち期限切れで使えない。押した瞬間にサーバから貰う。
-   *
-   * **「トークン」という語を出さない。** 顧客に見せる画面なので、内部語ではなく
-   * 「接続する／読み取りたいチャンネルに招待する」で通す（内部語排除の原則の資格情報版）。
-   * ------------------------------------------------------------------------- */
-  function slackConnectBox() {
-    if (!SITE.intake) return null;
-    // **この項目を知らない古い fleet-status では何も出さない。** 「0件」と「知らない」を
-    // 同じ扱いにすると、engine が @v1 で止まっている案件に「まだ接続されていません」と
-    // 嘘を出すことになる（実際には社内ワークスペースで動いている）
-    var list = slackWorkspaces();
-    if (!list) return null;
-
-    var box = el("div", { class: "ds-addform", "data-adder": "slack-workspace" }, [
-      el("div", { class: "ds-addform-title", text: "お客様の Slack ワークスペースを接続" }),
-      el("p", {
-        class: "sec-how",
-        text:
-          "お客様の Slack ワークスペースのチャンネルを読み取り対象にするための接続です。" +
-          "ボタンを押すと Slack の承認画面が開きます（承認するのはワークスペースの管理者です）。" +
-          "お願いする権限は読み取りだけで、Cortex から投稿することはありません。" +
-          "接続したあと、読み取りたいチャンネルにボットを招待し、この画面から追加してください。",
-      }),
-      // **「これは何のためのものでないか」を書く（2026-08-18 の不具合報告）。**
-      // 社内ワークスペースのチャンネルが読めていない人が、設定する場所を探して
-      // ここへ来る。押すと社内ワークスペースの承認画面が出て必ず失敗し、
-      // 「もう一度お試しください」に従ってまた押す——何度試しても直らない。
-      //
-      // **箱そのものは消さない。** 直上の renderExternalAdders のコメントが警告している
-      // のと同じ失敗で、「顧客チャンネルがある案件だけ出す」にすると
-      // **新規案件（0件）＝一番繋ぎたい場面**でこの入口が消える。出したまま、
-      // 使う場面と使わない場面をここで言い切る
-      el("p", {
-        class: "sec-how ds-scope-note",
-        text:
-          "クラスメソッドの社内ワークスペース（Classmethod Group）のチャンネルには、この接続は使いません。" +
-          "社内のチャンネルは Cortex の中央ボットで読んでいるので、ここで接続しても読めるようにはなりません。" +
-          "社内のチャンネルが読めていない場合は、cortex の担当者にご連絡ください。",
-      }),
-    ]);
-
-    // 接続済みの一覧。**0件でも「まだありません」と書く**——空白だと、
-    // 一覧が出ていないのか繋がっていないのかが読めない
-    var listBox = el("div", { class: "ds-ws-list" });
-    if (!list.length) {
-      listBox.appendChild(el("div", { class: "ds-ws-empty", text: "接続済みのワークスペースはまだありません。" }));
-    } else {
-      list.forEach(function (w) {
-        var row = el("div", { class: "ds-ws" }, [
-          el("span", { class: "ds-ws-name", text: w.name || w.teamId }),
-          el("span", {
-            class: "ds-ws-count",
-            text: (w.channels || 0) + "チャンネル",
-          }),
-        ]);
-        // **revoked と missing を分けて出す。** 前者は「接続し直してください」、
-        // 後者は「まだ接続が完了していない」で、次の一手が違う。
-        // unknown（確かめられなかった回）には何も出さない——繋がっているのに
-        // 「接続し直して」と言う方が、黙っているより悪い。
-        // 注: ここは埋め込みJSのテンプレートリテラル内。**コメントでもバッククォートを使わない**
-        if (w.tokenState === "revoked") {
-          row.appendChild(el("span", {
-            class: "ds-gate ds-gate-warn",
-            text: "⚠️ 接続が切れています",
-            title: "Slack 側で Cortex のアプリが削除されたか、接続が無効になっています。もう一度接続してください。",
-          }));
-        } else if (w.tokenState === "missing") {
-          row.appendChild(el("span", {
-            class: "ds-gate ds-gate-warn",
-            text: "⚠️ 未接続",
-            title: "このワークスペースのチャンネルが登録されていますが、接続が見つかりません。もう一度接続してください。",
-          }));
-        } else if (w.tokenState === "ok") {
-          row.appendChild(el("span", { class: "ds-gate ds-gate-ok", text: "● 接続OK" }));
-        }
-        listBox.appendChild(row);
-      });
-    }
-    box.appendChild(listBox);
-
-    // **ボタン自身に「お客様の」と書く（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;
-      if (!intake) return;
-      btn.disabled = true;
-      msg.className = "ds-toggle-msg";
-      msg.textContent = "承認画面を準備しています…";
-      try {
-        var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
-        var res = await fetch(pfx + "op=slack-oauth-start&t=" + encodeURIComponent(intake.token), {
-          method: "POST",
-          headers: { "content-type": "application/json" },
-          body: "{}",
-        });
-        var j = await res.json().catch(function () { return {}; });
-        if (!res.ok || !j.url) {
-          // サーバの文言をそのまま出す（未設定のときは「準備中です」が返る）
-          msg.className = "ds-toggle-msg is-error";
-          msg.textContent = "✗ " + (j.message || "接続を開始できませんでした。");
-          btn.disabled = false;
-          return;
-        }
-        // **同じタブで遷移する。** 別タブだと、承認後の「接続しました」を見た人が
-        // 元のタブに戻る動線を自分で見つけることになる
-        location.href = j.url;
-      } catch (e) {
-        msg.className = "ds-toggle-msg is-error";
-        msg.textContent = "✗ 接続を開始できませんでした。時間をおいて試してください。";
-        btn.disabled = false;
-      }
-    });
-    box.appendChild(el("div", { class: "ds-toggle" }, [btn, msg]));
-    return box;
-  }
 
   /**
    * 外部ソースの追加フォーム（Slack・GitHub）。
@@ -3959,30 +4161,21 @@ ${capabilityState.toString()}
       // **招待の話を先頭に置く。** Slack の仕様で、ボットは**公開チャンネルでも**招待されるまで
       // 中身を1件も読めない（conversations.history が not_in_channel を返す・2026-08-16 実測+公式ドキュメント）。
       // そのあとに「追加＝Gold 昇格の対象」を置く（手順と、その手順の重さ）。
-      hint: "先に Slack でそのチャンネルを開き、下のコマンドを貼って Cortex を招待してください。公開チャンネルでも招待が必要で、招待していないと中身を読めません。そのあと、チャンネル名を右クリック →「リンクをコピー」で出るURLを下に貼ります。追加したチャンネルは毎晩の Gold 昇格の対象になり、顧客も見る Decision・用語集の材料になります（読み取りを止めるには、追加した行の「登録を解除」を押します）。招待前に登録すると名前は「名前未取得」になるので、招待してから追加するのがおすすめです。",
-      copyText: "/invite @Cortex",
-      // 撤去した Gold トグルの確認文の趣旨をここへ移した。**追加が昇格の意思決定そのもの**
-      // なので、社内限定の会話が顧客可視の層に出てしまう話はここで伝えるしかない
-      // （実際にその事故が起きている）。あわせて他案件の取り違えも確認させる。
-      confirmLines: function (v) {
-        return [
-          "このチャンネルの内容を、顧客も見る Decision・用語集に蒸留するようになります。",
-          "",
-          v,
-          "",
-          "社内限定の会話が含まれるチャンネルでは、顧客に見せられない内容が出てしまう可能性があります。",
-          "顧客がこのチャンネルにいる（＝すでに会話を見ている）場合にだけ追加してください。",
-          "",
-          "貼ったURLがこの案件のものか、もう一度確認してください。",
-          "",
-          // Slack の仕様（公開チャンネルでも招待が要る）を、最後にもう一度置く。
-          // 「追加したのに何も取り込まれない」の原因のほとんどがこれ。
-          "※ Slack でこのチャンネルに Cortex を招待していないと、中身は読めません。",
-          "※ 今夜の蒸留（22時ごろ）までに登録を解除すれば取り込まれません。一度生成された記録は自動では消えません。",
-          "",
-          "追加しますか？",
-        ];
-      },
+      // **手順のリストにする（2026-08-20・オーナー指摘）。**
+      // 一続きの文章だと、読む人が「自分がいま何をすべきか」を自分で切り出すことになる。
+      //
+      // **接続（お客様の Slack への導入）の説明もここに置く。** 独立した節を
+      // 廃止したので、**繋ぎ方を知る場所はここしか無い**——
+      // 「0件の案件で入口が消える」という過去の事故（renderExternalAdders の
+      // 直上コメント）を、この手順が受け止めている。
+      hint: [
+        // **コマンドは手順1の中に置く。** フォームの下に離すと、どの手順のものか
+        // 対応が読めない（手で打たせない理由は copyRow のコメント）
+        { text: "読み取りたいチャンネルで、下のコマンドを貼って Cortex を招待します。公開チャンネルでも招待が必要です。", node: copyRow("/invite @Cortex") },
+        "下の欄に、そのチャンネルのリンクを貼って「追加」を押します（チャンネル名を右クリック →「リンクをコピー」）。",
+        "「組織不明」と出たら、そこにある「Slack ワークスペースに接続する」から承認をもらいます。お客様の Slack のチャンネルは、この承認が済むまで読めません（承認できるのはその Slack の管理者です）。",
+        "追加したチャンネルは毎晩の Gold 昇格の対象になり、Decision・用語集の材料になります。止めるときは、その行の「登録を解除」を押します。",
+      ],
       // **選んだワークスペースを送る（#104）。** 空文字＝社内ワークスペースなのでキーごと落とす
       // （サーバ側は「未宣言・null・空」を区別しない約束で、無いことで既定を表す）
       build: function (url, name, workspace) {
@@ -3990,7 +4183,29 @@ ${capabilityState.toString()}
         if (workspace) payload.workspace = workspace;
         return payload;
       },
-      workspacePicker: true,
+      // **別案件でも使われていたときに出す確認（2026-08-20）。**
+      //
+      // **追加のときに出る唯一のモーダル。** 同日に「追加のたびの確認」を廃止した
+      // （全部取り込む方針にし、顧客に見せるかは別途フラグで判定するため）ので、
+      // ここで止まるのは「他の案件と重複したとき」だけ。
+      // だから**何が起きるかもここで言う**（どちらの案件の顧客にも出ること）。
+      //
+      // **他案件の名前は出さない。** この画面の操作はその案件の Basic 認証を通れる人
+      // （顧客を含む）なら誰でもできるので、案件名の列挙に使わせない。
+      // **貼ったURLを本文に出す。** 「URLを確かめてください」と言うのに出ていなかった
+      duplicateConfirmLines: function (value) {
+        return [
+          "このチャンネルは、別の案件でも追加されています。",
+          "",
+          "このまま追加すると、同じ会話が両方の案件の Decision・用語集に出ます。",
+          "",
+          "全体定例のように複数の案件に関係するチャンネルなら、これは正しい状態です。",
+          "別のチャンネルと取り違えていないか、貼ったURLを確かめてください:",
+          String(value || ""),
+          "",
+          "追加しますか？",
+        ];
+      },
       adder: "slack",
     }));
 
@@ -4001,18 +4216,6 @@ ${capabilityState.toString()}
         namePlaceholder: "メモ（任意）",
         requiredNote: "リポジトリを入力してください。",
         hint: "このリポジトリの Issues が、毎晩の Gold 昇格の材料になります。",
-        confirmLines: function (v) {
-          return [
-            "このリポジトリの Issues を、Gold 昇格の材料に追加します。",
-            "",
-            "追加した時点で読み取りの対象になります。",
-            "Issues の内容から、顧客も見る Decision・用語集が作られます。",
-            "",
-            v,
-            "",
-            "追加しますか？",
-          ];
-        },
         build: function (repo, name) { return { op: "add-github-source", repo: repo, name: name }; },
         adder: "github",
       }));
@@ -4054,6 +4257,49 @@ ${capabilityState.toString()}
       // 一覧が添えられていれば、断られていても先に画面を追いつかせる（#127）
       var raced = hooks && hooks.onTargets && Array.isArray(j.targets) ? hooks.onTargets(j.targets) : false;
       if (!res.ok) {
+        // **確認すれば覆せる断り方（2026-08-20・Slack の重複だけ）。**
+        //
+        // 全体定例のように複数案件に関係するチャンネルは実在するのに、
+        // 「取り違えていないか確認してください」で終わっていて**確認しても進めなかった**。
+        //
+        // **完全一致で見る。** j.confirmable を truthy で見ると、次に触る人が他の能力にも
+        // 印を足したときに Drive でも確認が出て押せてしまう（サーバは通さないので実害は
+        // 「押しても409」だが、「確認すれば通る」というUIの約束が壊れる）。
+        //
+        // **一度「確認済み」で送って、それでも断られたら二度目は出さない。**
+        //
+        // **理由を正確に書く（実装レビューの指摘）。** 「画面が先に新しくなった時間帯に
+        // 押し続けることになる」は成立しない——古いサーバは印を返さないので、そもそも
+        // 確認が出ない（canConfirm が最初から false）。このガードが本当に守るのは
+        // **サーバを切り戻したとき**と**デプロイ中の版ズレ**。どちらも確認済みの再送だけが
+        // 断られる状態で、そこで出し続けると「はい」を押し続けることになる。
+        // 配る順番はサーバ→画面（これは順序の話とは別に必要）。
+        var canConfirm =
+          res.status === 409 &&
+          j.confirmable === "duplicate" &&
+          j.confirmableKind === "slack" &&
+          hooks &&
+          typeof hooks.onDuplicate === "function" &&
+          payload.confirmDuplicate !== true;
+        if (canConfirm) {
+          // **ボタンは必ず先に戻す。** 確認の前に戻しておかないと、「いいえ」を押した人の
+          // フォームが押せないまま残り、再読み込みするまで追加できなくなる
+          btn.disabled = false;
+          msg.className = "ds-toggle-msg";
+          msg.textContent = "";
+          if (await hooks.onDuplicate()) {
+            // 「はい」——同じ内容に確認の印を付けて送り直す
+            var again = {};
+            for (var k in payload) if (Object.prototype.hasOwnProperty.call(payload, k)) again[k] = payload[k];
+            again.confirmDuplicate = true;
+            await sendConfig(again, msg, btn, onDone, hooks);
+            return;
+          }
+          // 「いいえ」——サーバの文言を出して終わる（ボタンは戻してある）
+          msg.className = "ds-toggle-msg is-error";
+          msg.textContent = "✗ " + (j.message || "保存できませんでした。");
+          return;
+        }
         // サーバの文言をそのまま出す（貼り方の案内・取り違えの警告を含んでいる）。
         // **例外は「他の人が先に変えていた」だけ**——サーバは再読み込みを案内するが、
         // 画面は既に追いついているので、済んでいることをやらせる案内になる（#127）
@@ -4099,9 +4345,116 @@ ${capabilityState.toString()}
    * 書いていたが、取り違えはサーバ側が409で実際に弾く（findRefInOtherProjects）。
    * 実在する守りがあるのに脅し文を重ねると、操作者が萎縮するだけで安全は増えない。
    * 「貼ったURLがこの案件のものか確認してください」で足りる。
+   *
+   * **ただし Slack のチャンネルだけは、この前提が成り立たなくなった（2026-08-20）。**
+   * 重複は 409 で断られたあと**確認すれば覆せる**ので、「サーバが実際に弾く」とは
+   * 言えない。だから2枚目の確認（duplicateConfirmLines）では、重複そのものの事実と
+   * 「両方の案件の顧客が見る場所に出る」ことをはっきり書いている——**そこは脅し文ではなく、
+   * 押す前に知っておくべき事実**。1枚目（confirmLines）は変えていない。
+     * ※ この region はテンプレート文字列の中なので、コメントにもバッククォートを書かない。
    */
-  function confirmDanger(lines) {
-    return window.confirm(lines.join(String.fromCharCode(10)));
+  function confirmDanger(lines, opts) {
+    return openConfirm(lines, opts);
+  }
+
+  var confirmSeq = 0;
+
+  /**
+   * 画面内の確認モーダル。**window.confirm の置き換え（2026-08-20）。**
+   * 返すのは Promise で、中身は「進めてよいか」。
+   *
+   * ## なぜ makeModal を使わないのか（一番大事）
+   *
+   * **makeModal は開いているモーダルを畳む**（existing.__close(true)）。
+   * ところが確認が要る5か所は**すべて能力モーダルの中にいる**——
+   * openCapabilityModal の items.forEach(m.modal.appendChild(n)) は
+   * **ノードの移動**なので、利用者が「追加」を押した時点でフォームはモーダルの子。
+   * makeModal で確認を開くと**親ごと消え、フォームが無くなる**。
+   * しかも sendConfig の再送は掴んだままの msg/btn に書くので、
+   * **追加は成功するのに画面には何も起きない**（利用者はもう一度押す）。
+   *
+   * makeModal の close() は refreshDataSources と能力モーダル専用の戻り先処理に
+   * 絡んでいるため、フラグで分岐させると**あちらを壊すリスクをこちらの都合で背負う**。
+   * 確認は「短い文と2つのボタン」しかないので、小さく別に持つ。
+   *
+   * ## なぜクラスを .modal-overlay にしないのか
+   *
+   * isModalOpen()・expandAllCaps・openCapModal がいずれも .modal-overlay を
+   * 見ている。名前を共有すると「モーダルが開いている間は一覧を差し替えない」等の
+   * 判定に確認が混ざる。見た目だけ CSS のカンマセレクタで揃える。
+   *
+   * ## なぜ Esc を capture で受けて止めるのか
+   *
+   * **makeModal は開いている間ずっと document に keydown を張ったままにする。**
+   * inert は document レベルの keydown を止めない。素直に足すと
+   * **親のリスナが先に登録済みなので先に発火し、Esc 一発で親モーダルが閉じる**
+   * （＝上と同じ破壊が Esc 経由で起きる）。capture で受けて stopPropagation すれば
+   * 同一ノードの bubble リスナ＝親の onKey には届かない。
+   * オーバーレイ要素だけにリスナを張るのでは足りない（フォーカスが body にあると経路を通らない）。
+   *
+   * @param lines 表示する行（1行1段落）。先頭行が主文＝読み上げの名前になる
+   * @param opts { okLabel, returnTo }
+   */
+  function openConfirm(lines, opts) {
+    return new Promise(function (resolve) {
+      // **多重オープンはキャンセル扱いで無音。** 下地を inert にするので通常は起きない。
+      // ここで警告を出しても操作者にできることが無いし、2枚重なって
+      // 「下の1枚が residual で操作を受け付けない」状態のほうが害が大きい
+      if (app.querySelector(".confirm-overlay")) { resolve(false); return; }
+      var o = opts || {};
+      var overlay = el("div", { class: "confirm-overlay" });
+      // 確認は dialog ではなく alertdialog（「注意を促して答えを待つ」もの）
+      var box = el("div", { class: "modal confirm-box", role: "alertdialog", "aria-modal": "true" });
+      confirmSeq += 1;
+      var textId = "confirm-line-" + confirmSeq;
+      (lines || []).forEach(function (line, i) {
+        var pnode = el("p", { class: "confirm-line", text: line });
+        // 先頭行を読み上げの名前にする。見出しは付けない（主文を2回言うことになる）
+        if (i === 0) { pnode.id = textId; box.setAttribute("aria-labelledby", textId); }
+        box.appendChild(pnode);
+      });
+      var cancel = el("button", { class: "modal-cancel", type: "button", text: "キャンセル" });
+      var ok = el("button", { class: "ds-toggle-btn ds-danger", type: "button", text: o.okLabel || "はい" });
+      box.appendChild(el("div", { class: "modal-actions" }, [cancel, ok]));
+      overlay.appendChild(box);
+
+      function finish(answer) {
+        document.removeEventListener("keydown", onKey, true);
+        // **順序が仕様。** ①自分をDOMから外す → ②inertを全部外す →
+        // ③親が残っていれば掛け直す → ④それからフォーカスを戻す
+        if (overlay.parentNode) overlay.parentNode.removeChild(overlay);
+        setBackdropInert(overlay, false);
+        // **親モーダルはまだ開いている。** 全部外したままにすると、その後ろの画面が
+        // 触れるようになり Tab でタブ行へ抜けられる（別タブに移ると close() を
+        // 通らないので keydown が1本残る）
+        var rest = app.querySelector(".modal-overlay");
+        if (rest) setBackdropInert(rest, true);
+        // **戻し先は呼び出し側からもらう。** activeElement を記録する方式は破綻する——
+        // sendConfig は冒頭で btn.disabled = true にしており、実ブラウザでは
+        // フォーカス中の要素を disabled にした時点でフォーカスが body に落ちる。
+        // disabled を戻してもフォーカスは戻らない。**jsdom は落とさないのでテストから見えない。**
+        // Safari はクリックでボタンにフォーカスを当てないので、なおさら明示が要る
+        var back = o.returnTo;
+        if (back && typeof back.focus === "function" && app.contains(back)) back.focus();
+        resolve(answer);
+      }
+      function onKey(e) {
+        if (e.key !== "Escape") return;
+        e.stopPropagation();
+        e.preventDefault();
+        finish(false);
+      }
+      document.addEventListener("keydown", onKey, true);
+      // 外側クリックとキャンセルは「いいえ」。**確認は安全側に倒す**
+      overlay.addEventListener("click", function (e) { if (e.target === overlay) finish(false); });
+      cancel.addEventListener("click", function () { finish(false); });
+      ok.addEventListener("click", function () { finish(true); });
+
+      app.appendChild(overlay);
+      setBackdropInert(overlay, true);
+      // **キャンセルに載せる**（showModal と同じ「押しても何も壊れないものへ」の原則）
+      cancel.focus();
+    });
   }
 
   /**
@@ -4119,10 +4472,10 @@ ${capabilityState.toString()}
     };
     paint();
 
-    btn.addEventListener("click", function () {
+    btn.addEventListener("click", async function () {
       var next = !on;
       // 読み始める方向（危険）だけ確認する。止める方向は素通し
-      if (next && opts.confirmOn && !confirmDanger(opts.confirmOn)) { msg.textContent = ""; return; }
+      if (next && opts.confirmOn && !(await confirmDanger(opts.confirmOn, { returnTo: btn }))) { msg.textContent = ""; return; }
       sendConfig(opts.build(next), msg, btn, function () {
         // **押した内容をボタンに反映し、逆向きの操作を残す。**
         // **カードごと作り直さない。** 上の msg に出した結果表示が消えてしまう
@@ -4149,8 +4502,8 @@ ${capabilityState.toString()}
     var btn = el("button", { class: "ds-toggle-btn ds-danger", type: "button", text: opts.label || "削除" });
     var msg = el("div", { class: "ds-toggle-msg" });
 
-    btn.addEventListener("click", function () {
-      if (!confirmDanger(opts.confirmLines())) { msg.textContent = ""; return; }
+    btn.addEventListener("click", async function () {
+      if (!(await confirmDanger(opts.confirmLines(), { returnTo: btn }))) { msg.textContent = ""; return; }
       sendConfig(opts.build(), msg, btn, function () {
         btn.disabled = true;
         if (opts.onDone) opts.onDone();
@@ -4169,11 +4522,36 @@ ${capabilityState.toString()}
    * 2つ目を足せると読めるため、そういう口だけ submitLabel で語を変える。押した結果の
    * 表示（＋/追加済み）も同じ理由で語を揃える。
    *
-   * @param opts { title, placeholder, hint, needsName, confirmLines, build(values), submitLabel, hooks }
+   * @param opts { title, placeholder, hint, needsName, build(values), submitLabel, hooks }
    *   hooks … sendConfig へ渡す追い付き処理を返す関数（接続先の一覧・#127）。
    *     **これがある口では、その場の控え（「追加済み・反映中」）を出さない**——
    *     応答で本物の一覧が増えるので、控えを併記すると同じものが2回出る
    */
+  /**
+   * フォームの説明。**配列なら手順のリストにする（2026-08-20）。**
+   *
+   * オーナー指摘: 「もっと手続き的に、結局ユーザー自身が何をすればいいのかを
+   * わかるようにした方がいい。リスト形式でちゃんと並べてあげるとわかりやすい」。
+   * 一続きの文章は、読む人が「自分がいま何をすべきか」を自分で切り出すことになる。
+   *
+   * **文字列の口は今までどおり。** 他の4フォーム（共有資料・Figma・Backlog・GitHub）は
+   * まだ文章なので、そちらを壊さない。横展開でそれぞれ配列に変えていく。
+   *
+   * 各要素は文字列か、{ text, node } （手順の中に部品を挟むとき。招待コマンドなど）。
+   */
+  function hintNode(hint) {
+    if (!hint) return null;
+    if (!Array.isArray(hint)) return el("p", { class: "sec-how", text: hint });
+    var ol = el("ol", { class: "sec-how sec-steps" });
+    hint.forEach(function (step) {
+      var text = typeof step === "string" ? step : (step && step.text) || "";
+      var li = el("li", {}, [el("span", { text: text })]);
+      if (step && step.node) li.appendChild(step.node);
+      ol.appendChild(li);
+    });
+    return ol;
+  }
+
   function addForm(opts) {
     var main = el("input", { class: "sec-input", type: "text", placeholder: opts.placeholder, autocomplete: "off" });
     var name = opts.needsName
@@ -4188,20 +4566,18 @@ ${capabilityState.toString()}
     // ワークスペースの改名で変わるし、共有チャンネルでは貼った人のホストになる。
     // 推測して間違えると「追加できたのに読まれない」チャンネルができ、
     // 翌朝の接続状況で初めて分かる。人に選ばせる。
-    var wsList = opts.workspacePicker ? slackWorkspaces() || [] : [];
+    // **ワークスペースの選択は廃止した（2026-08-20）。**
+    // オーナーの受け入れテストで「意味が分からない」。実際、チャンネルIDを見ても
+    // どのワークスペースのものかは分からないし、**間違えると追加はできるのに
+    // 永久に読まれない**（気づくのは翌朝の接続状況）。
+    // いまはサーバが、持っている鍵を順に Slack へ投げて決める。
+    // **URLのホスト名から推測しない**という下の判断は今も正しい——推測ではなく実測にした。
     var wsSelect = null;
-    if (wsList.length) {
-      wsSelect = el("select", { class: "sec-input" });
-      wsSelect.appendChild(el("option", { value: "", text: "社内ワークスペース（クラスメソッド）" }));
-      wsList.forEach(function (w) {
-        wsSelect.appendChild(el("option", { value: w.teamId, text: w.name || w.teamId }));
-      });
-    }
     var submitLabel = opts.submitLabel || "追加";
     var btn = el("button", { class: "ds-toggle-btn", type: "button", text: submitLabel });
     var msg = el("div", { class: "ds-toggle-msg" });
 
-    btn.addEventListener("click", function () {
+    btn.addEventListener("click", async function () {
       if (!main.value.trim()) {
         msg.className = "ds-toggle-msg is-error";
         msg.textContent = "⚠ " + (opts.requiredNote || "入力してください。");
@@ -4212,7 +4588,6 @@ ${capabilityState.toString()}
         msg.textContent = "⚠ 表示名を入力してください。";
         return;
       }
-      if (opts.confirmLines && !confirmDanger(opts.confirmLines(main.value.trim()))) { msg.textContent = ""; return; }
       var added = main.value.trim();
       var addedName = name ? name.value.trim() : "";
       var payload = opts.build(added, addedName, wsSelect ? wsSelect.value : "");
@@ -4233,7 +4608,28 @@ ${capabilityState.toString()}
             el("span", { class: "ds-pending-note", text: submitLabel + "済み・反映中" }),
           ]),
         );
-      }, opts.hooks ? opts.hooks() : null);
+      }, (function () {
+        // **既存の hooks（接続先の一覧が持つ onTargets）と、重複の確認を1つにまとめる。**
+        // Slack の追加フォームは onTargets を持たないが、重複の確認は要る。
+        // 逆に接続先の一覧（Backlog）は onTargets を持つが確認は要らない——
+        // 共通に足すと、あちらの「他の人が先に変えていた」の判定と混ざる。
+        var h = opts.hooks ? opts.hooks() : null;
+        if (!opts.duplicateConfirmLines) return h;
+        h = h || {};
+        // **返り値が「進めてよいか」（Promise）。** 呼び出し側は必ず await すること——
+        // await を落とすと Promise は truthy なので**確認なしで「はい」扱いになる**。
+        // 2026-08-20 に window.confirm から画面内のモーダルに変えた（openConfirm）。
+        // **戻し先に btn を渡す。** sendConfig が冒頭で btn.disabled = true にしており、
+        // 実ブラウザではその時点でフォーカスが body に落ちるので、
+        // activeElement を記録する方式では戻し先が消える
+        h.onDuplicate = function () {
+          return confirmDanger(opts.duplicateConfirmLines(main.value.trim()), {
+            okLabel: "追加する",
+            returnTo: btn,
+          });
+        };
+        return h;
+      })());
     });
 
     // このセッションで追加したものを並べる場所（リロードすると消える＝正式な一覧は上に出る）
@@ -4241,7 +4637,7 @@ ${capabilityState.toString()}
 
     var box = el("div", opts.adder ? { class: "ds-addform", "data-adder": opts.adder } : { class: "ds-addform" }, [
       el("div", { class: "ds-addform-title", text: opts.title }),
-      opts.hint ? el("p", { class: "sec-how", text: opts.hint }) : null,
+      hintNode(opts.hint),
       // 手順の中に「どこかへ貼る文字列」があるときは、**手で打たせない**。
       // 「/invite @Cortex」のような短い文字列でも、打ち間違えると黙って失敗する
       opts.copyText ? copyRow(opts.copyText) : null,
@@ -4313,15 +4709,35 @@ ${capabilityState.toString()}
     // 行ごとに「対象です」と書いても情報が増えない。github の除外は行のトグル
     // （「読み取りを始める／止める」）が向きで示す。
     if (s.notify === true) badges.appendChild(el("span", { class: "badge ds-notify", text: "通知先" }));
-    // **どのワークスペースのチャンネルかを出す（#104）。** 同じチャンネル名が
-    // 2つのワークスペースに並びうるので、これが無いと「どっちの #general か」が読めない。
-    // 宣言なし（社内ワークスペース）には何も出さない——これまでどおりの見た目を保つ
-    if (s.type === "slack" && s.workspace) {
-      badges.appendChild(el("span", {
-        class: "badge ds-workspace",
-        text: workspaceLabel(s.workspace),
-        title: "接続した Slack ワークスペースのチャンネルです（読み取り専用の接続なので、通知は届きません）。",
-      }));
+    // **どのワークスペースのチャンネルかを、必ず行に出す（#104・2026-08-20 に社内も）。**
+    //
+    // 折りたたみの見出しでまとめるのをやめた（オーナー指摘「複雑になっちゃってる」）ので、
+    // **どの組織かを言うのは行のラベルだけ**になった。社内に何も出さないと、
+    // ラベルの無い行が「社内」なのか「まだ分かっていない」のかを読み分けられない。
+    if (s.type === "slack") {
+      // **順序は groupSlackByOrg と揃える（workspace が先）。**
+      // 逆にすると、判定が済んで workspace が入った行に古い印が残っているとき、
+      // **並びは「Hapio AI」なのにラベルだけ「組織が分かりません」**になる
+      // ——同じ画面で2つの判定が食い違う、このプロダクトが何度も直した形
+      if (s.workspace) {
+        badges.appendChild(el("span", {
+          class: "badge ds-workspace",
+          text: workspaceLabel(s.workspace),
+          title: "接続した Slack ワークスペースのチャンネルです（読み取り専用の接続なので、通知は届きません）。",
+        }));
+      } else if (s.orgUnknown === true) {
+        badges.appendChild(el("span", {
+          class: "badge ds-workspace ds-workspace-unknown",
+          text: "組織不明",
+          title: "どの Slack のチャンネルか、まだ分かっていません。上の案内をご覧ください。",
+        }));
+      } else {
+        badges.appendChild(el("span", {
+          class: "badge ds-workspace",
+          text: "クラスメソッド",
+          title: "クラスメソッドの社内 Slack のチャンネルです。",
+        }));
+      }
     }
     // 登録の由来（#118）。**「登録から削除」が出る/出ないの理由がこれ。** 導出されたリポは
     // 登録ファイルから消しても翌日また現れるので削除を出していないが、画面には
@@ -4372,7 +4788,7 @@ ${capabilityState.toString()}
         confirmOn: [
           "このリポジトリの Issues を、Gold 昇格の材料に戻します。",
           "",
-          "Issues の内容から、顧客も見る Decision・用語集が作られます。",
+          "Issues の内容から、Decision・用語集が作られます。",
           "",
           s.ref,
           "",
@@ -4427,7 +4843,11 @@ ${capabilityState.toString()}
     // **origin === "explicit" でも出す。** 確認は読むだけで、どの登録ファイル由来かに
     // 関係なく効く（書き込みになる「表示名を更新する」だけが由来で出し分かれる）
     if (SITE.intake && s.type === "slack" && s.ref) {
-      card.appendChild(probeSection(s, card, gateEl));
+      var probe = probeSection(s, card, gateEl);
+      // **ボタンは行の中（「登録を解除」の隣）。** 独立した段を作ると1行が2段になる
+      card.appendChild(probe.btn);
+      // 押した結果の詳細だけを下に。**押すまでは空**なので行は伸びない
+      card.appendChild(probe.detail);
     }
     return card;
   }

package/package.json

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