@takagaki/cortex-decisions-viewer 0.4.85 → 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); }
@@ -2056,7 +2082,7 @@ ${capabilityState.toString()}
    * Slack のチャンネルは、どのワークスペースにあるかで読み取りの鍵が別物になる:
    *   - workspace 省略 … クラスメソッドの社内ワークスペース。中央 Bot の鍵（案件リポジトリの
    *     設定）で読む。**画面から設定できるものが1つも無い。**
-   *   - workspace: "T…" … お客様のワークスペース。下の「お客様の Slack ワークスペースを接続」で
+   *   - workspace: "T…" … お客様のワークスペース。「Slack ワークスペースに接続する」で
    *     承認を貰って読む。**画面から自己解決できる。**
    *
    * どちらも no_token に潰して「トークン未設定」と出していたため、社内チャンネルを
@@ -2073,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 ワークスペースに接続する」から接続してください。",
     },
   };
   /**
@@ -2133,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 = {
     "課題管理": "📋",
     "会議": "🗒️",
@@ -2523,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) {
@@ -2553,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組織分）ので、
@@ -3147,7 +3519,7 @@ ${capabilityState.toString()}
       // 長い説明は落とし、次の行動の1行だけ残す
       return [p(isInternalSlack(s)
         ? "cortex の担当者にご連絡ください。"
-        : "下の「お客様の Slack ワークスペースを接続」から接続してください。")];
+        : "「Slack ワークスペースに接続する」から接続してください。")];
     }
     if (r.gate === "unreachable") {
       return [p("チャンネルが見つからないか、アーカイブされています。不要なら「登録を解除」してください。")];
@@ -3216,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);
@@ -3233,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 = "";
@@ -3278,7 +3664,7 @@ ${capabilityState.toString()}
       }
       btn.disabled = false;
     });
-    return wrap;
+    return { btn: btn, detail: wrap };
   }
 
   function removeChannelButton(s, card) {
@@ -3740,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）。
@@ -3925,8 +4161,21 @@ ${capabilityState.toString()}
       // **招待の話を先頭に置く。** Slack の仕様で、ボットは**公開チャンネルでも**招待されるまで
       // 中身を1件も読めない（conversations.history が not_in_channel を返す・2026-08-16 実測+公式ドキュメント）。
       // そのあとに「追加＝Gold 昇格の対象」を置く（手順と、その手順の重さ）。
-      hint: "先に Slack でそのチャンネルを開き、下のコマンドを貼って Cortex を招待してください。公開チャンネルでも招待が必要で、招待していないと中身を読めません。そのあと、チャンネル名を右クリック →「リンクをコピー」で出るURLを下に貼ります。追加したチャンネルは毎晩の Gold 昇格の対象になり、Decision・用語集の材料になります（読み取りを止めるには、追加した行の「登録を解除」を押します）。招待前に登録すると名前は「名前未取得」になるので、招待してから追加するのがおすすめです。",
-      copyText: "/invite @Cortex",
+      // **手順のリストにする（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) {
@@ -3934,7 +4183,6 @@ ${capabilityState.toString()}
         if (workspace) payload.workspace = workspace;
         return payload;
       },
-      workspacePicker: true,
       // **別案件でも使われていたときに出す確認（2026-08-20）。**
       //
       // **追加のときに出る唯一のモーダル。** 同日に「追加のたびの確認」を廃止した
@@ -4279,6 +4527,31 @@ ${capabilityState.toString()}
    *     **これがある口では、その場の控え（「追加済み・反映中」）を出さない**——
    *     応答で本物の一覧が増えるので、控えを併記すると同じものが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
@@ -4293,15 +4566,13 @@ ${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" });
@@ -4366,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,
@@ -4438,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）。**「登録から削除」が出る/出ないの理由がこれ。** 導出されたリポは
     // 登録ファイルから消しても翌日また現れるので削除を出していないが、画面には
@@ -4552,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.85",
+  "version": "0.5.0",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,