@takagaki/cortex-decisions-viewer 0.4.82 → 0.4.83

package/dist/render.js

@@ -1294,6 +1294,19 @@ a.ds-name:hover { text-decoration: underline; }
    （flex: 1 1 100%）——状態バッジの横に押し込むと、いちばん読ませたい一文が
    カード幅に負けて省略される。状態の語より弱く、しかし読める大きさで出す */
 .ds-gate-help { flex: 1 1 100%; margin: 4px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280; }
+/* 「接続を確認」を押した結果（2026-08-19）。**必ず自分の行を占める**（flex: 1 1 100%）。
+   夜間のスナップショットの状態バッジと**同時に2つの判定を並べない**ため、押したあとは
+   状態バッジをこの中の判定へ置き換える（同じ画面で「⚠️」と「接続OK」が並ぶのが、
+   この節で3回直してきた壊れ方そのもの） */
+.ds-probe { flex: 1 1 100%; margin-top: 8px; padding-top: 8px; border-top: 1px dashed var(--border); }
+.ds-probe-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+/* いつ測った結果かを必ず添える。夜間のスナップショットと混ざると、どちらの話か読めない */
+.ds-probe-at { font-size: 11.5px; color: var(--muted); }
+.ds-probe-help { margin: 6px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280;
+  min-width: 0; white-space: normal; overflow-wrap: anywhere; }
+/* Slack が名指しした不足スコープ。**そのまま読める形で出す**（言い換えると検索できない） */
+.ds-probe-scope { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; background: #fef3c7;
+  border: 1px solid #fde68a; border-radius: 6px; padding: 1px 6px; user-select: all; }
 /* 意図的にOFFにした能力（#125②）。**グレーにして誘わない**——未接続（入口を出してよい）
    とは別物で、同じ色にすると「押して繋ぎましょう」と読まれる */
 .ds-gate-off { color: #9ca3af; }
@@ -2022,6 +2035,11 @@ ${capabilityState.toString()}
     // **状態だけでなく、次にすることを書く。** 「bot未招待」では何をすればよいか分からない
     // （公開チャンネルでも招待が要ることは Slack の仕様で、知らない人のほうが多い）
     "not_in_channel": { text: "Slackで招待してください", cls: "ds-gate-warn" },
+    // **招待では直らない（2026-08-19 の不具合報告）。** 非公開チャンネルで groups:read が
+    // 足りていたのに、実測がこれを「不明」に潰していたので画面には「接続OK」としか出ず、
+    // 名前が引けない理由が一切分からなかった（原因の特定に半日かかった）。
+    // **状態の語で「招待」と言わない**——言うと、何度招待しても直らないものを繰り返させる
+    "missing_scope": { text: "権限が足りません", cls: "ds-gate-warn" },
     "unreachable": { text: "アクセス不可", cls: "ds-gate-warn" },
     "no_token": { text: "トークン未設定", cls: "ds-gate-muted" },
     "unknown": { text: "不明", cls: "ds-gate-muted" },
@@ -3034,6 +3052,210 @@ ${capabilityState.toString()}
    * 関わらず必ず出し、成功しても一覧からは消さずに行へ取り消し線を引く（一覧は夜間
    * スナップショットなので、翌朝まで残るのが正しい状態）。
    */
+  /* ---------------------------------------------------------------------------
+   * 「接続を確認」（2026-08-19 の不具合報告3件）
+   * ---------------------------------------------------------------------------
+   * 3つの別々の原因（トークン未登録・groups:read 不足・スナップショットが古い）が、
+   * **画面上はどれも区別できなかった。** 共通していたのは「画面を見ても次に何をすれば
+   * いいか決まらない」こと。実測は毎晩1回しか走らないので、招待やスコープを直した人が
+   * 直ったことを確かめる手段も無かった。**押した瞬間に測って、理由と次の一手を返す。**
+   *
+   * **判定はここで作らない。** 状態の語は DS_GATE、社内/顧客の出し分けは
+   * DS_GATE_NO_TOKEN が持っていて、どちらも dsGateOf を通して取る。ここで文面を
+   * 書き写すと、**同じ行の状態バッジと確認結果で語が割れる**（この節で3回直した形）。
+   *
+   * 他アダプタ（GitHub / Backlog / Figma / Drive）を足すときの拡張点:
+   *   - 判定と語彙は infra/lambda/shared/slack-gate.mjs 側に足す（画面は DS_GATE のまま）
+   *   - この節に増やすのは probeHelpNodes の「次の一手」だけ。**アダプタ固有の分岐を
+   *     probeVerdict に入れない**（入れた瞬間に判定が画面側にも生まれる）
+   *   - 行に出す条件（下の extSourceCard）を s.type === "slack" から広げる
+   * ------------------------------------------------------------------------- */
+
+  /**
+   * 確認結果の状態バッジ。**既存の dsGateOf をそのまま通す。**
+   *
+   * こうしておくと no_token の社内/顧客の出し分け（DS_GATE_NO_TOKEN）が確認結果にも
+   * そのまま効く。写経すると、同じ画面で行は「管理者の設定が必要です」・確認結果は
+   * 「トークン未設定」になり、社内チャンネルを登録した人が**また**顧客ワークスペースの
+   * 接続へ吸い込まれる（2026-08-18 の不具合そのもの）。
+   */
+  function probeVerdict(s, r) {
+    return dsGateOf({ type: s.type, workspace: s.workspace, gate: r.gate });
+  }
+
+  /**
+   * 判定ごとの「次の一手」。**状態の語だけでは足りない**——今日の3件はどれも
+   * 「何が起きているか」は分かっても「次に何をすればいいか」が決まらなかった。
+   */
+  function probeHelpNodes(s, r) {
+    var p = function (t) { return el("p", { class: "ds-probe-help", text: t }); };
+    var out = [];
+    if (r.gate === "ok") {
+      // **表示名が引けたかまで言う。** 読めているのに名前が「（名前未取得: C0BQ…）」の
+      // ままだった案件があり、読めていること自体は正しかったので誰も疑わなかった
+      out.push(p(r.name
+        ? "読めています。Slack で確認できた表示名は「" + r.name + "」です。"
+        : "読めています。ただし表示名は引けませんでした（Slack の応答: " +
+          (r.error || "不明") + "）。一覧の名前は登録したときのままになります。"));
+      return out;
+    }
+    if (r.gate === "not_in_channel") {
+      out.push(p("このチャンネルに Cortex を招待してください。公開チャンネルでも招待が必要で、" +
+        "招待していないと中身を1件も読めません。Slack でこのチャンネルを開き、次のコマンドを貼ります。" +
+        "招待したら、もう一度「接続を確認」を押して直ったことを確かめてください。"));
+      // **手で打たせない。** 短い文字列でも打ち間違いは黙って失敗し、
+      // 利用者には「招待したのに読まれない」としか見えない（copyRow の直上コメント）
+      out.push(copyRow("/invite @Cortex"));
+      return out;
+    }
+    if (r.gate === "missing_scope") {
+      // **足りないスコープ名をそのまま出す（2026-08-19 の不具合の本体）。**
+      // Slack は needed で名指しで返しているのに、実測がそれを捨てて「不明」にしていた。
+      // **招待と言わない**——招待では直らないので、言うと直らない操作を繰り返させる
+      var line = el("p", { class: "ds-probe-help" });
+      line.appendChild(document.createTextNode("Cortex の Slack App に権限（スコープ）が足りません。不足しているのは "));
+      line.appendChild(el("code", { class: "ds-probe-scope", text: r.needed || "不明（Slack が名前を返しませんでした）" }));
+      line.appendChild(document.createTextNode(" です。"));
+      out.push(line);
+      out.push(p("これは招待では直りません。Slack App にこのスコープを追加して再インストールする必要があるので、" +
+        "cortex の担当者にこのスコープ名をそのまま伝えてください。" +
+        (r.readable
+          ? "なお、チャンネルの中身そのものは読めています（毎晩の取り込みは動いています）。直らないのは表示名です。"
+          : "")));
+      return out;
+    }
+    if (r.gate === "no_token") {
+      // **社内/顧客の出し分けは既存の1箇所から取る。** ここで書き分けると必ずずれる
+      var help = probeVerdict(s, r).help;
+      if (help) out.push(p(help));
+      return out;
+    }
+    if (r.gate === "unreachable") {
+      out.push(p("チャンネルが見つからないか、アーカイブされています。" +
+        "Slack でこのチャンネルがまだ存在するかを確かめてください。" +
+        "アーカイブしたチャンネルなら、この行の「登録を解除」で読み取り対象から外せます。" +
+        "存在するのに見つからない場合は、Cortex が入っていない別ワークスペースのチャンネルの可能性があるので、" +
+        "cortex の担当者にご連絡ください。"));
+      return out;
+    }
+    // unknown。**生のエラーを隠さない**——「不明」だけだと切り分けが始められない
+    out.push(p("読めるかどうかを確かめられませんでした。Slack の応答は「" + (r.error || "不明") + "」です。" +
+      "少し時間をおいてもう一度お試しください。同じ応答が続く場合は、この文言をそのまま cortex の担当者にお伝えください。"));
+    return out;
+  }
+
+  /**
+   * 表示名の取り直し。**確認とは別のボタンにしてある。**
+   *
+   * 確認（?op=probe）は読むだけなので誰でも押してよいと決めた（オーナー判断・2026-08-19）。
+   * 名前の更新は案件リポジトリへのコミットなので、**設定変更と同じ入口（?op=config）**に
+   * 通す（sendConfig）。確認のついでに黙って書き込む形にすると、「読むだけだから誰でも
+   * 押してよい」という前提そのものが崩れる。**押す前に、何がどう変わるかを見せる。**
+   *
+   * 出すのは**違っているときだけ**。同じ名前のときにボタンだけ出すと、押しても
+   * 「変更はありません」と返るだけの操作になる。
+   */
+  function renameChannelRow(s, r, card) {
+    if (!r.name || r.name === s.name) return null;
+    var box = el("div");
+    box.appendChild(el("p", { class: "ds-probe-help",
+      text: "一覧の表示名「" + (s.name || "（未設定）") + "」は、Slack のいまの名前「" + r.name + "」と違います。" +
+        "更新すると、この案件の設定ファイル（チャット/channels.json）の表示名だけが書き換わります。" +
+        "読み取りの対象・範囲は変わりません。" }));
+    var row = el("div", { class: "ds-toggle" });
+    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "表示名を更新する" });
+    var msg = el("div", { class: "ds-toggle-msg" });
+    btn.addEventListener("click", function () {
+      // **名前は送らない。** サーバが Slack から引き直したものだけを書く（引けなければ
+      // 断って既存の名前を残す）。画面から任意の名前を送れる形にすると、
+      // 名前の取り直しの顔をした自由な改名になる
+      var payload = { op: "refresh-channel-name", ref: s.ref };
+      if (s.workspace) payload.workspace = s.workspace;
+      sendConfig(payload, msg, btn, function () {
+        // 一覧は夜間のスナップショットなので、その場では変わらない。行だけ追いつかせる
+        var nameEl = card.querySelector(".ds-name");
+        if (nameEl) nameEl.textContent = r.name;
+        btn.disabled = true;
+      });
+    });
+    row.appendChild(btn);
+    row.appendChild(msg);
+    box.appendChild(row);
+    return box;
+  }
+
+  /**
+   * 「接続を確認」の一式（ボタン＋結果）。
+   *
+   * **押したら、その行の状態バッジを置き換える。** 夜間のスナップショットの判定と
+   * いま測った判定を**同じ行に並べない**ため——並べると「⚠️ と 接続OK が同時に出ている」
+   * になり、この節で3回直してきた食い違いを画面の側から作ることになる。
+   * 置き換えたことが分かるよう、いつ測ったかを必ず添える。
+   *
+   * **結果は保存しない。** fleet-status.json は夜間のスナップショットのまま置く
+   * （押すたびにコミットが増えるのを避ける）。表示名の取り直しだけが例外で、
+   * そちらは正本（channels.json）を直す価値があるので別のボタンで書き込む。
+   */
+  function probeSection(s, card, gateEl) {
+    var wrap = el("div", { class: "ds-probe" });
+    var head = el("div", { class: "ds-probe-head" });
+    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "接続を確認" });
+    var msg = el("span", { class: "ds-toggle-msg" });
+    var at = el("span", { class: "ds-probe-at" });
+    var body = el("div");
+    head.appendChild(btn);
+    head.appendChild(msg);
+    head.appendChild(at);
+    wrap.appendChild(head);
+    wrap.appendChild(body);
+
+    btn.addEventListener("click", async function () {
+      var intake = SITE.intake;
+      if (!intake) return;
+      btn.disabled = true;
+      msg.className = "ds-toggle-msg";
+      msg.textContent = "確認中…";
+      at.textContent = "";
+      body.textContent = "";
+      var payload = { type: "slack", ref: s.ref };
+      if (s.workspace) payload.workspace = s.workspace;
+      var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
+      try {
+        var res = await fetch(pfx + "op=probe&t=" + encodeURIComponent(intake.token), {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(payload),
+        });
+        var j = await res.json().catch(function () { return {}; });
+        if (!res.ok) {
+          // サーバの文言をそのまま出す（回数制限の案内・未対応のアダプタの説明を含んでいる）
+          msg.className = "ds-toggle-msg is-error";
+          msg.textContent = "✗ " + (j.message || "確認できませんでした。");
+          btn.disabled = false;
+          return;
+        }
+        msg.textContent = "";
+        var v = probeVerdict(s, j);
+        gateEl.className = "ds-gate " + v.cls;
+        gateEl.textContent = v.text;
+        at.textContent = "いま測った結果（" + (dsFmtTime(j.checkedAt) || "たった今") + "）";
+        probeHelpNodes(s, j).forEach(function (n) { body.appendChild(n); });
+        // **登録ファイルが channels.json の行にだけ出す。** 書き換える先がそこなので、
+        // dev-sources.json だけに載っている行（origin: explicit）では必ず 404 になる
+        // ——「登録を解除」が同じ理由で同じ条件を持っている
+        if (s.origin !== "explicit") {
+          var rename = renameChannelRow(s, j, card);
+          if (rename) body.appendChild(rename);
+        }
+      } catch (e) {
+        msg.className = "ds-toggle-msg is-error";
+        msg.textContent = "✗ 通信に失敗しました。";
+      }
+      btn.disabled = false;
+    });
+    return wrap;
+  }
+
   function removeChannelButton(s, card) {
     return removeButton({
       label: "登録を解除",
@@ -4098,6 +4320,9 @@ ${capabilityState.toString()}
       }));
     }
     var gate = dsGateOf(s);
+    // **「接続を確認」が押されたら、この要素を live の判定で置き換える**（probeSection）。
+    // 2つの判定を同じ行に並べないため、参照を持っておく
+    var gateEl = el("span", { class: "ds-gate " + gate.cls, text: gate.text });
     var card = el("div", { class: "ds-card" }, [
       el("div", { class: "ds-card-main" }, [
         el("span", { class: "ds-icon", text: meta.icon }),
@@ -4105,7 +4330,7 @@ ${capabilityState.toString()}
         dsNameEl(s.name || "", s.url),
       ]),
       badges,
-      el("span", { class: "ds-gate " + gate.cls, text: gate.text }),
+      gateEl,
     ]);
     // チャンネルの登録解除。書き込み経路（intake Lambda）がある案件でだけ出す。
     // **Slack だけ。** github は登録ファイルが別（dev-sources.json）で、下のトグルと
@@ -4171,6 +4396,19 @@ ${capabilityState.toString()}
     // **ボタンより後ろに置く。** カードは横並びの flex なので、間に挟むと
     // 「登録を解除」が案内文の下の行へ落ちて、既存案件の行の形が変わる
     if (gate.help) card.appendChild(el("p", { class: "ds-gate-help", text: gate.help }));
+    // 「接続を確認」（2026-08-19）。**押せる人を絞らない**——読むだけで設定を変えないので、
+    // 気づいた人がその場で確かめられるほうがよい（オーナー判断）。書き込みになる
+    // 「表示名を更新する」は、押した結果の中から別のボタンとして出る（probeSection）。
+    //
+    // **いまは Slack だけ。** GitHub は夜間の実測（probeGithubGate）が既にあるので繋ぐだけ、
+    // Backlog / Figma / Drive は実測そのものが新規になる。同じ型で足せるよう、
+    // 判定は infra/lambda/shared/slack-gate.mjs 側に置いてある（末尾に拡張点の説明がある）。
+    //
+    // **origin === "explicit" でも出す。** 確認は読むだけで、どの登録ファイル由来かに
+    // 関係なく効く（書き込みになる「表示名を更新する」だけが由来で出し分かれる）
+    if (SITE.intake && s.type === "slack" && s.ref) {
+      card.appendChild(probeSection(s, card, gateEl));
+    }
     return card;
   }
 

package/package.json

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