@takagaki/cortex-decisions-viewer 0.4.82 → 0.4.84

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" },
@@ -2065,6 +2083,25 @@ ${capabilityState.toString()}
   function isInternalSlack(s) {
     return s.type === "slack" && !s.workspace;
   }
+  /**
+   * Slack チャンネルの表示名。**# は表示のときだけ付ける**（保存値は素・2026-08-19）。
+   *
+   * 保存値に # を持たせていたせいで、人が手で # 無しに書いた行と Slack から引いた値が
+   * 「# の有無だけ」で食い違い、「名前が違います」と出た（実機で発生）。**保存は素に
+   * 決めた**ので、付けるのはここ1箇所だけ。決定の理由は infra/lambda/shared/slack-gate.mjs。
+   *
+   * **冪等にしてある**（先頭の # を落としてから付ける）。既存データには # 付きで
+   * 保存された行が10件あり、これが無いと「##tf-project-cortex」になる。冪等なので
+   * **データの移行を待たずにこの表示へ切り替えられる**（揃うのは名前が引き直された行から順に）。
+   *
+   * 印付きの名前（「（名前未取得: C0BQ…）」）には付けない——# は実名の印なので、
+   * 引けていない名前に付けると実名に見えてしまう。
+   */
+  function slackDisplayName(name) {
+    var s = String(name || "");
+    if (!s || s.indexOf("（名前未取得") === 0) return s;
+    return "#" + s.replace(/^#+/, "");
+  }
   /** 行に出す接続状態。no_token だけは経路（社内/顧客）で文面が分かれる */
   function dsGateOf(s) {
     if (s.gate === "no_token" && s.type === "slack") {
@@ -3034,6 +3071,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 });
+  }
+
+  /**
+   * 判定ごとの表示。**成功は1行で終わらせ、失敗は「理由＋次の一手」だけを残す。**
+   *
+   * ## 短くした理由（2026-08-19・オーナー指示）
+   *
+   * 「接続を確認を押して出てくる文言が長ったらしい」。実際、成功時に4行出ていた。
+   * **成功時は「読めている」以上の情報が要らない。**
+   *
+   * ## ただし失敗時は削りすぎない
+   *
+   * 短くしすぎると、今日と同じ「画面を見ても次に何をすればいいか決まらない」状態に戻る
+   * （それで半日かかった）。落とすのは**内部の仕組みの説明**——「設定ファイルの表示名だけが
+   * 書き換わります」「読み取りの対象・範囲は変わりません」のような、読む人の次の行動を
+   * 変えない文。残すのは「何が起きているか」と「次に何をするか」だけ。
+   *
+   * 状態の語そのものは DS_GATE / DS_GATE_NO_TOKEN が持つ（probeVerdict 経由）ので、
+   * ここが返すのは**それに足りない分だけ**。二重に言わない。
+   *
+   * @returns 本文に並べるノード（0〜2個）
+   */
+  function probeHelpNodes(s, r) {
+    var p = function (t) { return el("p", { class: "ds-probe-help", text: t }); };
+    // 成功。**1行で終わり。** 状態の語（「接続OK」）が既に出ているので本文は空
+    if (r.gate === "ok") return [];
+    if (r.gate === "not_in_channel") {
+      // 状態の語が「Slackで招待してください」なので、説明は足さずコマンドだけ出す。
+      // **手で打たせない**——打ち間違いは黙って失敗し、「招待したのに読まれない」に見える
+      return [copyRow("/invite @Cortex")];
+    }
+    if (r.gate === "missing_scope") {
+      // 不足スコープは頭のバッジ横に出る（probeSection）。ここは次の一手だけ
+      return [p("招待では直りません。cortex の担当者にこのスコープ名をお伝えください。")];
+    }
+    if (r.gate === "no_token") {
+      // **社内/顧客の出し分けは変えない。** 社内は画面から設定できるものが無いので
+      // 連絡先、顧客は接続へ誘導する（2026-08-18 の不具合の再発防止）。
+      // 長い説明は落とし、次の行動の1行だけ残す
+      return [p(isInternalSlack(s)
+        ? "cortex の担当者にご連絡ください。"
+        : "下の「お客様の Slack ワークスペースを接続」から接続してください。")];
+    }
+    if (r.gate === "unreachable") {
+      return [p("チャンネルが見つからないか、アーカイブされています。不要なら「登録を解除」してください。")];
+    }
+    // unknown。**生のエラーは隠さない**——「不明」だけだと切り分けが始められない
+    return [p("Slack の応答：" + (r.error || "不明") + "。時間をおいて再度お試しください。")];
+  }
+
+  /**
+   * 表示名を Slack の実名へ**自動で揃える**（2026-08-19・オーナー判断）。
+   *
+   * ## なぜ自動なのか
+   *
+   * 「表示名は人が決めるものではなく、Slack から引いたものをそのまま出す」と決まった。
+   * 正解が1つしかないので、**人に選ばせるボタンは摩擦でしかない**（差分表示と
+   * 「表示名を更新する」ボタンは撤去した。Gold トグルを撤去したときと同じ理屈）。
+   *
+   * ## なぜサーバの ?op=probe ではなく画面から送るのか
+   *
+   * **疎通確認そのものは読むだけ、を保ちたいから。** 「読むだけで設定を変えない」が
+   * ボタンを誰でも押せるようにした根拠なので、?op=probe を書き込む口にはしない。
+   * 書き込みは既存の ?op=config を通す——他案件チェック・コミットのリトライ・
+   * 画面への反映まで、設定変更と同じ守りがそのまま効く。
+   *
+   * **本来の置き場は夜間の接続状況生成（engine 側）。** そちらなら人の操作と無関係に
+   * 1日1回揃い、改名にも追従する。engine が今回の変更対象外なので、いまは押したときに揃える。
+   *
+   * ## 静かに失敗させる
+   *
+   * 揃えるのはおまけで、押した人の目的は「読めているか確かめる」こと。
+   * 失敗しても疎通確認の結果は出したままにする（名前が古いままなだけ）。
+   */
+  function autoAlignName(s, r, card) {
+    // 引けていない／既に同じなら何もしない（押すたびにコミットを積まない）
+    if (!r.name || !s.ref) return;
+    if (String(s.name || "").replace(/^#+/, "") === String(r.name)) return;
+    // **channels.json に無い行は書き換えられない。** dev-sources.json だけに載っている
+    // 行（origin: explicit）へ送ると必ず404になる（「登録を解除」と同じ条件）
+    if (s.origin === "explicit") return;
+    var intake = SITE.intake;
+    if (!intake) return;
+    var payload = { op: "refresh-channel-name", ref: s.ref };
+    if (s.workspace) payload.workspace = s.workspace;
+    var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
+    fetch(pfx + "op=config&t=" + encodeURIComponent(intake.token), {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(payload),
+    }).then(function (res) {
+      if (!res.ok) return;
+      // 一覧は夜間のスナップショットなので、その場では変わらない。行だけ追いつかせる
+      var nameEl = card.querySelector(".ds-name");
+      if (nameEl) nameEl.textContent = slackDisplayName(r.name);
+    }).catch(function () { /* 揃えられなくても疎通確認の結果は出したまま */ });
+  }
+
+  /**
+   * 「接続を確認」の一式（ボタン＋結果）。
+   *
+   * **押したら、その行の状態バッジを置き換える。** 夜間のスナップショットの判定と
+   * いま測った判定を**同じ行に並べない**ため——並べると「⚠️ と 接続OK が同時に出ている」
+   * になり、この節で3回直してきた食い違いを画面の側から作ることになる。
+   * 置き換えたことが分かるよう、いつ測ったかを必ず添える。
+   *
+   * **判定は保存しない。** fleet-status.json は夜間のスナップショットのまま置く
+   * （押すたびにコミットが増えるのを避ける）。表示名だけが例外で、そちらは
+   * Slack の実名が正なので自動で揃える（autoAlignName）。
+   */
+  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.className = "ds-toggle-msg" + (j.gate === "ok" ? " is-ok" : " is-error");
+        msg.textContent = j.gate === "ok" ? "✓" : "✗";
+        var v = probeVerdict(s, j);
+        gateEl.className = "ds-gate " + v.cls;
+        gateEl.textContent = v.text;
+        // 不足スコープは**状態の語のすぐ横**に出す（「権限が足りません：groups:read」）。
+        // 本文へ落とすと、いちばん要る情報が説明文に埋もれる
+        if (j.gate === "missing_scope") {
+          head.appendChild(el("code", { class: "ds-probe-scope", text: j.needed || "不明" }));
+        }
+        at.textContent = "いま測った結果（" + (dsFmtTime(j.checkedAt) || "たった今") + "）";
+        probeHelpNodes(s, j).forEach(function (n) { body.appendChild(n); });
+        // **夜間の判定に添えてあった案内は隠す。** 置き換えた判定と食い違う案内が
+        // 下に残ると、同じ行に2つのことが書いてある状態になる
+        var stale = card.querySelector(".ds-gate-help");
+        if (stale) stale.hidden = true;
+        // 表示名を Slack の実名へ自動で揃える（差分表示も更新ボタンも出さない）
+        autoAlignName(s, j, card);
+      } catch (e) {
+        msg.className = "ds-toggle-msg is-error";
+        msg.textContent = "✗ 通信に失敗しました。";
+      }
+      btn.disabled = false;
+    });
+    return wrap;
+  }
+
   function removeChannelButton(s, card) {
     return removeButton({
       label: "登録を解除",
@@ -4098,14 +4339,18 @@ ${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 }),
         el("span", { class: "ds-type", text: meta.label }),
-        dsNameEl(s.name || "", s.url),
+        // Slack だけ # を表示側で付ける（保存値は素）。他のアダプタの名前には触らない
+        dsNameEl(s.type === "slack" ? slackDisplayName(s.name) : (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 +4416,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.84",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,