@takagaki/cortex-decisions-viewer 0.4.81 → 0.4.82

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,10 @@ 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; }
 /* 意図的にOFFにした能力（#125②）。**グレーにして誘わない**——未接続（入口を出してよい）
    とは別物で、同じ色にすると「押して繋ぎましょう」と読まれる */
 .ds-gate-off { color: #9ca3af; }
@@ -1322,6 +1326,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; }
@@ -2019,6 +2026,70 @@ ${capabilityState.toString()}
     "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 +2484,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 +2739,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("⚠️ 同期が失敗しています");
@@ -3517,7 +3579,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 +3588,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 +3645,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 +4097,7 @@ ${capabilityState.toString()}
         title: ORIGIN_HELP[s.origin],
       }));
     }
-    var gate = DS_GATE[s.gate] || DS_GATE["unknown"];
+    var gate = dsGateOf(s);
     var card = el("div", { class: "ds-card" }, [
       el("div", { class: "ds-card-main" }, [
         el("span", { class: "ds-icon", text: meta.icon }),
@@ -4082,6 +4163,14 @@ ${capabilityState.toString()}
         }));
       }
     }
+    // **「次に誰が何をするか」を、その行に書く（2026-08-18 の不具合報告）。**
+    // 状態（トークン未設定）だけを出していたので、設定する場所を探した人が直下の
+    // 顧客ワークスペースの接続へ吸い込まれた——社内チャンネルではそれが必ず失敗する。
+    // 文面は DS_GATE_NO_TOKEN が経路ごとに持つ（社内は連絡先・顧客は接続の導線）。
+    //
+    // **ボタンより後ろに置く。** カードは横並びの flex なので、間に挟むと
+    // 「登録を解除」が案内文の下の行へ落ちて、既存案件の行の形が変わる
+    if (gate.help) card.appendChild(el("p", { class: "ds-gate-help", text: gate.help }));
     return card;
   }
 

package/package.json

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