@takagaki/cortex-decisions-viewer 0.4.75 → 0.4.77

package/dist/build.js

@@ -37,6 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readFleetSources = readFleetSources;
+exports.findBacklogDir = findBacklogDir;
 exports.build = build;
 exports.createRefResolver = createRefResolver;
 const node_fs_1 = require("node:fs");
@@ -146,8 +147,31 @@ async function readFleetSources(repoRoot) {
             // 自動導出されたものは登録ファイルから消しても翌日また現れるので、
             // explicit のときだけ削除ボタンを出す。
             origin: s.origin != null ? String(s.origin) : undefined,
+            // どの Slack ワークスペースのチャンネルか（#104）。**列挙し忘れると静かに消える**
+            // （このマッピングは素通しではなく明示の許可リスト）。落とすと、同じIDの
+            // チャンネルを2つのワークスペースに持つ案件で Gold トグルが別の行を撃つ
+            workspace: s.workspace != null ? String(s.workspace) : undefined,
         }))
         : undefined;
+    // 接続済み Slack ワークスペース（#104）。**空配列と undefined を区別して通す**——
+    // 空配列は「まだ1つも繋いでいない」（接続の導線を出してよい）、undefined は
+    // 「この項目を知らない古い生成物」（何も言えないので出さない）。
+    // ここで `|| undefined` に潰すと、その2つが同じ表示になる
+    const slackWorkspaces = Array.isArray(obj.slackWorkspaces)
+        ? obj.slackWorkspaces
+            .filter((w) => w != null && typeof w === "object")
+            .map((w) => ({
+            teamId: String(w.teamId ?? ""),
+            // 表示名が無ければ team_id。**空欄にしない**（どれのことか分からない行になる）
+            name: String(w.name ?? "") || String(w.teamId ?? ""),
+            domain: w.domain != null ? String(w.domain) : undefined,
+            connectedAt: w.connectedAt != null ? String(w.connectedAt) : undefined,
+            channels: typeof w.channels === "number" ? w.channels : undefined,
+            // ok / missing / revoked / unknown。**潰さない**（次の一手が違う）
+            tokenState: w.tokenState != null ? String(w.tokenState) : undefined,
+        }))
+            .filter((w) => w.teamId !== "")
+        : undefined;
     // セットアップの充足チェック。**missing だけを通す。**
     // na（使わないと宣言した能力）を通すと「設定する必要が無いものに設定を促す」偽の警告になり、
     // #101 で潰した穴が復活する。unknown は AWS/gh へ到達できなかった回に出るので、
@@ -288,23 +312,42 @@ async function readFleetSources(repoRoot) {
     // **画面に現在値を出すために要る。** 「接続先を変更」フォームが入力欄だけだったため、
     // 実機で「何もセットされていない」と読まれ、同じURLが貼り直された（#127）。
     //
-    // **domain / projectKey しか通さない。** 生成側は configPath / sections / strays /
-    // features も持っているが、画面が使うのは接続先の2つだけ。素通しにすると、engine が
+    // **接続先そのものしか通さない。** 生成側は configPath / sections / strays /
+    // features も持っているが、画面が使うのは接続先だけ。素通しにすると、engine が
     // このオブジェクトに足したものが顧客の画面データへ黙って流れる（Lambda 側の
     // FLEET_PUBLIC_KEYS と同じ考え方で、こちらも許可リストにする）。
+    // 配列の要素も同じ2つに絞る——要素だけ素通しにすると、許可リストを通したつもりで
+    // 中身が漏れる（externalSources で実際にやった間違い）。
+    //
+    // **接続先は複数ありうる（#127）。** 1案件が複数の Backlog プロジェクトを同期できる
+    // ようになったので、`targets` があればそれを一覧の正本にする。**単数の2つは残す**
+    // （先頭と同じ値）——`targets` を載せない古いスナップショットでも現在値を出せるように、
+    // 読み手の両対応と同じ約束を画面データでも守る。
     //
     // **値が無い形は落とす。** 正本もミラーも持たない案件では `{ source: "secrets" }` だけが
     // 来る。空の器を通すと、画面は「接続先の情報がある」と判断して空文字を並べることになる
     const bt = obj.backlogTarget != null && typeof obj.backlogTarget === "object" && !Array.isArray(obj.backlogTarget)
         ? obj.backlogTarget
         : null;
-    const backlogTarget = bt && typeof bt.domain === "string" && bt.domain && typeof bt.projectKey === "string" && bt.projectKey
-        ? { domain: bt.domain, projectKey: bt.projectKey }
+    const oneTarget = (v) => {
+        if (v == null || typeof v !== "object")
+            return null;
+        const o = v;
+        return typeof o.domain === "string" && o.domain && typeof o.projectKey === "string" && o.projectKey
+            ? { domain: o.domain, projectKey: o.projectKey }
+            : null;
+    };
+    const btTargets = Array.isArray(bt?.targets)
+        ? bt.targets.map(oneTarget).filter((t) => t !== null)
+        : [];
+    const btHead = oneTarget(bt) ?? btTargets[0] ?? null;
+    const backlogTarget = btHead
+        ? { ...btHead, ...(btTargets.length ? { targets: btTargets } : {}) }
         : undefined;
     const secretSources = obj.secretSources && typeof obj.secretSources === "object"
         ? obj.secretSources
         : undefined;
-    return { externalSources, internalSources, pipelines, capabilities, fleetGeneratedAt, secretSources, checks, githubOwners, backlogTarget };
+    return { externalSources, slackWorkspaces, internalSources, pipelines, capabilities, fleetGeneratedAt, secretSources, checks, githubOwners, backlogTarget };
 }
 /** パスがディレクトリとして存在するか */
 async function isDirectory(dirAbs) {
@@ -482,9 +525,65 @@ async function findDirByMarker(repoRoot, marker, fallback) {
     }
     return fallback;
 }
+/** exporter が作る区画名（engine の `BACKLOG_SECTIONS` と同じ固定の名前） */
+const BACKLOG_SECTIONS = ["issues", "documents", "wiki"];
+/**
+ * 課題管理の能力ディレクトリ（`<ここ>/issues` に課題ミラーが入る）を探す。
+ *
+ * **汎用の `findDirByMarker` では足りない。** `backlog-settings.json` は能力ディレクトリの
+ * 直下ではなく**区画の中**（`<課題管理>/issues/` 等）にあり、しかも接続先が複数になると
+ * さらに1階層落ちる（`<課題管理>/<キー>/{issues,…}/`・#127）。汎用版は最上位の
+ * ディレクトリ名しか返さないので、入れ子形の案件では `<課題管理>/issues` という
+ * 実在しないパスを見に行き、**課題キー→Backlog URL の表が空になる**
+ * （グラフの課題ノードが全部リポ内パス止まりになり、Backlog へ飛べない）。
+ *
+ * 規則の出どころは cortex-engine の `plugin/scripts/issues-config.mjs`（`findBacklogDir`）。
+ * **あちらを変えたらここも変えること**（`viewer/test/backlog-nested-layout.test.mjs` が見張る）。
+ *
+ * 浅い順（ルート → 深さ1 → 深さ2）に見て最初に当たったものを採る。深い側は後ろなので、
+ * いまフラット形で見つかっている案件の答えは1つも動かない。
+ */
+async function findBacklogDir(repoRoot, fallback) {
+    const dirsIn = async (rel) => {
+        try {
+            return (await node_fs_1.promises.readdir(path.join(repoRoot, rel), { withFileTypes: true }))
+                .filter((e) => e.isDirectory() && e.name !== "node_modules" && !e.name.startsWith("."))
+                .map((e) => e.name)
+                .sort();
+        }
+        catch {
+            return [];
+        }
+    };
+    const hasMarker = async (rel) => {
+        for (const s of BACKLOG_SECTIONS) {
+            try {
+                await node_fs_1.promises.stat(path.join(repoRoot, rel, s, "backlog-settings.json"));
+                return true;
+            }
+            catch {
+                // 次の区画へ
+            }
+        }
+        return false;
+    };
+    if (await hasMarker(""))
+        return fallback; // ルート直下に区画がある形（`""` を返すと絶対パスになる）
+    const dirs = await dirsIn("");
+    for (const d of dirs)
+        if (await hasMarker(d))
+            return d;
+    for (const d of dirs) {
+        for (const sub of await dirsIn(d)) {
+            if (await hasMarker(`${d}/${sub}`))
+                return `${d}/${sub}`;
+        }
+    }
+    return fallback;
+}
 async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
     const map = new Map();
-    const issuesDir = await findDirByMarker(repoRoot, "backlog-settings.json", "課題管理");
+    const issuesDir = await findBacklogDir(repoRoot, "課題管理");
     const designDir = await findDirByMarker(repoRoot, "figma.json", "デザイン");
     const meetingDir = await findDirByMarker(repoRoot, "ingest-config.json", "会議");
     const materialsDir = await findDirByMarker(repoRoot, "materials-config.json", "共有資料");
@@ -1180,6 +1279,7 @@ async function build(opts) {
             .map((s) => s.trim())
             .filter(Boolean),
         externalSources: fleet.externalSources,
+        slackWorkspaces: fleet.slackWorkspaces,
         fleetGeneratedAt: fleet.fleetGeneratedAt,
         secretSources: fleet.secretSources,
         internalSources: fleet.internalSources,

package/dist/render.js

@@ -1250,6 +1250,16 @@ a.ds-name:hover { text-decoration: underline; }
 /* 登録の由来（#118）。**薄く出す**——読み取りの可否や Gold 対象かより弱い情報で、
    ここが目立つと「除外」「未宣言」の判断のバッジと同じ強さに見えてしまう */
 .badge.ds-origin { background: transparent; color: var(--muted); border: 1px dashed var(--border); }
+/* どの Slack ワークスペースのチャンネルか（#104）。**由来のバッジと同じ強さにする**——
+   「Gold 対象か」より弱い、どれのことかを見分けるための情報。強くすると判断のバッジと競る */
+.badge.ds-workspace { background: transparent; color: var(--muted); border: 1px solid var(--border); }
+/* 接続済み Slack ワークスペースの一覧（#104）。追加フォームの中に置く */
+.ds-ws-list { display: flex; flex-direction: column; gap: 6px; margin: 8px 0 10px; }
+.ds-ws { display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap; font-size: 12.5px; }
+.ds-ws-name { color: var(--text); font-weight: 600; word-break: break-all; }
+.ds-ws-count { color: var(--muted); flex: 0 0 auto; }
+/* 1つも繋いでいない状態。**空白にしない**——一覧が出ていないのか繋がっていないのかが読めない */
+.ds-ws-empty { color: var(--muted); font-size: 12.5px; }
 /* 全組織が接続済みのときに、トークン入力欄の代わりに出す1行（#118） */
 .ds-all-connected { color: var(--muted); }
 .ds-gate { display: inline-flex; align-items: center; gap: 5px; font-size: 12.5px; font-weight: 600; flex: 0 0 auto; }
@@ -1294,6 +1304,12 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-current-label { color: var(--muted); flex: 0 0 auto; }
 .ds-current-value { color: var(--text); font-weight: 600; word-break: break-all; }
 .ds-current-value.is-unset { color: var(--muted); font-weight: 400; }
+/* 接続先の一覧（#127）。**1件のときは従来どおりラベルの右に1行**——単数の案件で
+   見た目が変わると、複数対応と関係のない全案件に「何か変わった」と読ませる */
+.ds-target-list { display: flex; flex-direction: column; gap: 6px; min-width: 0; }
+.ds-target-row { display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap; }
+/* 行の中のボタンは行に揃える（.ds-toggle の縦マージンは節と節の間隔なので効かせない） */
+.ds-target-row .ds-toggle-btn { flex: 0 0 auto; }
 /* 入力欄のすぐ下。貼る直前に読める位置に置く */
 .sec-note { color: var(--muted); font-size: 12px; line-height: 1.7; margin: 6px 0 0; }
 .sec-how p { margin: 0; }
@@ -2326,6 +2342,9 @@ ${capabilityState.toString()}
     // **追加フォームはグループの外に置く。** グループは0件だと描かれず、4件以上だと
     // 畳まれる（既定は閉）。中に入れると**新規案件（0件）＝一番追加したい場面**で消える。
     var adders = renderExternalAdders();
+    // **接続の入口はチャンネル追加より前に置く。** 顧客ワークスペースを繋いでいない状態で
+    // 先に追加フォームを見せると、貼れるのに読まれないチャンネルを登録することになる
+    pushCap("チャット", slackConnectBox());
     pushCap("チャット", adders.querySelector('[data-adder="slack"]'));
     // **組織ごとの接続状況を、開発の一番上に置く。** トークンは組織ごとにしか
     // 効かない（Fine-grained PAT も GitHub App のインストールトークンも1組織分）ので、
@@ -2833,7 +2852,12 @@ ${capabilityState.toString()}
         "有効にしますか？",
       ],
       build: function (next) {
-        return { op: "set-channel-gold", ref: s.ref, value: next };
+        // **どのワークスペースのチャンネルかを必ず送る（#104）。** 落とすと、サーバ側は
+        // 既定ワークスペースの同じIDのエントリを探しに行き、「対象チャンネルが
+        // 見つかりません」か、最悪**別のチャンネルを Gold に上げる**
+        var payload = { op: "set-channel-gold", ref: s.ref, value: next };
+        if (s.workspace) payload.workspace = s.workspace;
+        return payload;
       },
       // 保存できた直後に、この行のバッジだけを「反映中」に差し替える。
       // 一覧そのものは触らない（結果メッセージや他行の状態を巻き込まないため）。
@@ -2842,8 +2866,9 @@ ${capabilityState.toString()}
         // 画面が出している値と一致するので待つものが無い。ここで消さないと、
         // 何も保留していないのに (反映中) が残り、リロードで消えて不可解に見える。
         var back = next === (s.gold === true);
-        if (back) clearPendingGold(s.ref);
-        else markPendingGold(s.ref, next);
+        // 控えの鍵もワークスペース込み（#104。pendingKeyOf の doc）
+        if (back) clearPendingGold(pendingKeyOf(s));
+        else markPendingGold(pendingKeyOf(s), next);
         var card = toggleEl && toggleEl.parentNode;
         var badges = card && card.querySelector(".ds-badges");
         if (!badges) return;
@@ -2856,31 +2881,200 @@ ${capabilityState.toString()}
   }
 
   /**
-   * いま同期している Backlog の接続先（#127）。
+   * いま同期している Backlog の接続先の一覧（#127）。**1件でも配列で返す。**
    *
-   * **2つの経路から引く。** 正本は fleet の backlogTarget（engine が正本
-   * issues-config.json → ミラーの順で解決した値）だが、**このキーを載せているのは
-   * 新しい engine だけ**で、艦隊の多くは @v1 のまま持っていない。無いときは
-   * 内部ソースの url（同じ値から機械導出されたプロジェクトURL）を解析して補う。
+   * **3つの経路から引く。** 正本は fleet の backlogTarget で、接続先が複数ある案件では
+   * targets に全件が入る。targets を載せていないスナップショット（複数対応より前に
+   * 生成されたもの）では単数の2つを1件として読み、それも無ければ内部ソースの url
+   * （同じ値から機械導出されたプロジェクトURL）を解析して補う。
    * ここを backlogTarget だけにすると、**設定済みの案件に「未設定」と出す**
-   * ——今回直している誤読（何もセットされていないと読んで貼り直す）を、
-   * 画面の側からもう一度作ることになる。
+   * ——直したい誤読（何もセットされていないと読んで貼り直す）を画面の側から作ることになる。
    *
-   * **解析できないときは黙らない。** 「未設定」と明示する。行ごと消すと、
-   * 「表示が無い＝まだ何も無い」なのか「出し忘れ」なのかが読み手に区別できない。
+   * **半端な要素は落とす。** ドメインかキーの片方しか無い接続先は行として読めない
+   * （「cm1.backlog.jp / 」が並ぶ）。空になったら「未設定」に倒す。
    */
-  function currentBacklogTargetLine(s) {
+  function backlogTargetsNow(s) {
     var t = fleetVal("backlogTarget");
-    if (!t || !t.domain || !t.projectKey) t = (s && s.url && backlogTargetOf(s.url)) || null;
-    var p = el("p", { class: "ds-current" });
-    p.appendChild(el("span", { class: "ds-current-label", text: "現在の接続先" }));
-    p.appendChild(
-      el("span", {
-        class: t ? "ds-current-value" : "ds-current-value is-unset",
-        text: t ? t.domain + " / " + t.projectKey : "未設定",
-      }),
-    );
-    return p;
+    var raw = t && Array.isArray(t.targets) ? t.targets : t ? [t] : [];
+    var out = [];
+    for (var i = 0; i < raw.length; i++) {
+      var x = raw[i];
+      if (x && x.domain && x.projectKey) out.push({ domain: String(x.domain), projectKey: String(x.projectKey) });
+    }
+    if (out.length) return out;
+    var u = (s && s.url && backlogTargetOf(s.url)) || null;
+    return u ? [u] : [];
+  }
+
+  /**
+   * 接続先の一覧を1つの文字列にする（**サーバへ送る「いま画面が見ている世代」**・#127）。
+   *
+   * 追加・削除は一覧に対する操作なので、後勝ちで上書きすると**他の人が足した接続先が
+   * 黙って消える**。サーバは受け取った世代といまの正本を突き合わせ、違えば 409 で断る。
+   *
+   * **並びと大小は問わない**（サーバ側の targetsGeneration と同じ畳み方にすること）。
+   * 片方だけが大文字化していると、正しい操作が毎回 409 になって**再読み込みしても直らない**
+   * ——食い違わないことは backlog-targets-ui.test.mjs が実物どうしで突き合わせている。
+   *
+   * **クロージャを持たない純関数に保つこと**（テストが配信物から切り出して直接呼ぶ）。
+   */
+  function targetsGenerationOf(list) {
+    return (list || [])
+      .filter(function (t) { return t && t.domain && t.projectKey; })
+      .map(function (t) { return String(t.domain).toLowerCase() + "/" + String(t.projectKey).toUpperCase(); })
+      .sort()
+      .join(",");
+  }
+
+  /**
+   * 他の人が先に一覧を変えていたときの文面（#127）。
+   *
+   * **サーバの文面をそのまま出さない。** サーバは「画面を再読み込みして…」と案内するが、
+   * 画面は応答に添えられた一覧でその場で追いついている。再読み込みを促すと、
+   * 済んでいることをやらせる（そして再読み込みしても同じ表示になる＝堂々巡りに見える）。
+   */
+  var TARGETS_RACE_NOTE =
+    "他の人が先に接続先を変更しました。最新の一覧に更新しましたので、内容を確かめてもう一度お試しください。";
+
+  /**
+   * 「課題管理」カードの接続先（一覧＋追加＋削除・#127）。
+   *
+   * **一覧は応答で描き直す。** 追加・削除の応答には必ずいまの一覧が添えられている
+   * （成功も、重複で断られたときも、世代がずれていたときも）。夜間スナップショットの
+   * 到着を待つと、押した直後は何も変わらないので「効いていない」と読まれ、もう一度
+   * 押して「すでに登録されています」になる——他の追加フォームで実際に起きたこと。
+   *
+   * **結果の表示は一覧の外に置く。** 行の中に置くと、一覧を描き直した瞬間に
+   * 押した結果が消える（Gold の先出しバッジで踏んだのと同じ罠）。
+   */
+  function backlogTargetsSection(s) {
+    var targets = backlogTargetsNow(s);
+    // 書き込み先（正本の置き場）が決まらない案件では操作を出さない。判定は呼び出し側と
+    // 同じ s.url（同期ミラーが1つでもあるか）で、フォームを出さない条件と揃える
+    var editable = !!(s && s.url);
+
+    var listEl = el("div", { class: "ds-target-list" });
+    var current = el("div", { class: "ds-current" }, [
+      el("span", { class: "ds-current-label", text: "現在の接続先" }),
+      listEl,
+    ]);
+    // 追加・削除の結果はここに1つだけ出す（行を描き直しても消えない位置）
+    var msg = el("div", { class: "ds-toggle-msg" });
+
+    function removeRow(t) {
+      var row = el("div", { class: "ds-target-row" }, [
+        el("span", { class: "ds-current-value", text: t.domain + " / " + t.projectKey }),
+      ]);
+      if (!editable) return row;
+      var btn = el("button", { class: "ds-toggle-btn ds-danger", type: "button", text: "この接続先を外す" });
+      btn.addEventListener("click", function () {
+        // **最後の1件かどうかは「押した時点」で数える。** 描画時の件数で決めると、
+        // 2件を1件ずつ外したとき最後の1件で確認が出ない（Figma で踏んだのと同じ）
+        var last = targets.length === 1;
+        if (!confirmDanger(removeTargetConfirmLines(t, last))) { msg.textContent = ""; return; }
+        var payload = {
+          op: "backlog-target-remove",
+          // **projectKey では送らない。** body の projectKey は案件キー（cortex の
+          // 案件識別子）に予約されていて、トークンから解決した案件と食い違えば 403 で断られる
+          backlogProjectKey: t.projectKey,
+          baseGeneration: targetsGenerationOf(targets),
+        };
+        // **常には送らない。** 最後の1件の重さを利用者に確かめてもらった証がこのフラグで、
+        // 無条件に付けると「一覧から1行消すだけ」の見た目で同期が止まる
+        if (last) payload.confirmLast = true;
+        sendConfig(payload, msg, btn, null, targetsHooks());
+      });
+      row.appendChild(btn);
+      return row;
+    }
+
+    function paint() {
+      while (listEl.firstChild) listEl.removeChild(listEl.firstChild);
+      if (!targets.length) {
+        // **行ごと消さない。** 表示が無いと「まだ何も無い」のか「出し忘れ」なのか区別できない
+        listEl.appendChild(el("span", { class: "ds-current-value is-unset", text: "未設定" }));
+        return;
+      }
+      for (var i = 0; i < targets.length; i++) listEl.appendChild(removeRow(targets[i]));
+    }
+
+    /**
+     * 応答に添えられた一覧を取り込む。**画面が見ていた集合と違っていたら true**
+     * （＝他の人が先に変えていた。409 の文面をこちらの言葉に差し替える判断に使う）。
+     */
+    function adoptTargets(list) {
+      var before = targetsGenerationOf(targets);
+      var next = [];
+      for (var i = 0; i < list.length; i++) {
+        var x = list[i];
+        if (x && x.domain && x.projectKey) next.push({ domain: String(x.domain), projectKey: String(x.projectKey) });
+      }
+      targets = next;
+      paint();
+      return targetsGenerationOf(targets) !== before;
+    }
+
+    function targetsHooks() {
+      return { onTargets: adoptTargets, staleNote: TARGETS_RACE_NOTE };
+    }
+
+    paint();
+    var box = el("div", {}, [current]);
+    if (editable) {
+      box.appendChild(addForm({
+        // **「追加」に戻す（#127）。** 1件しか持てなかった頃は「保存」（置き換え）だったが、
+        // 接続先は本当に足せるようになった。押した結果は一覧の行として出る
+        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の登録が要ります。",
+            "",
+            "追加しますか？",
+          ];
+        },
+        build: function (url) {
+          return { op: "backlog-target-add", url: url, baseGeneration: targetsGenerationOf(targets) };
+        },
+        // 応答の一覧で本物の行が増えるので、フォーム側の控え（「追加済み・反映中」）は出さない
+        hooks: targetsHooks,
+      }));
+    }
+    box.appendChild(msg);
+    return box;
+  }
+
+  /** 接続先を外すときの確認。**最後の1件は、止まるものを名指しで伝える** */
+  function removeTargetConfirmLines(t, last) {
+    var lines = [
+      "「" + t.domain + " / " + t.projectKey + "」を同期の対象から外します。",
+      "",
+    ];
+    if (last) {
+      // 一覧から1行消す見た目と、実際に起きることの重さが釣り合わないので必ず言う
+      lines.push("これが最後の接続先です。この接続先を外すと課題の同期が止まります。よろしいですか？");
+    } else {
+      lines.push(
+        "次回の同期から、このプロジェクトの課題・ドキュメント・Wiki は取り込まれなくなります。",
+        "取り込み済みの内容はリポジトリに残ります（不要なら手で削除してください）。",
+        "",
+        "外しますか？",
+      );
+    }
+    return lines;
   }
 
   /**
@@ -2950,46 +3144,21 @@ ${capabilityState.toString()}
       // 画面のどこにも出ていなかった。保存直後に出る楽観的なチップはリロードで消えるので、
       // **利用者は「何もセットされていない」と読み、同じURLを貼り直した**。
       // 設定を変える口の隣には、いまの値が必ず要る。
-      box.appendChild(currentBacklogTargetLine(s));
-      // **設定ファイルが無い案件にはフォームを出さない。** 書き込み先が無いので
-      // 貼っても 404 で終わる。三菱電機は tools が backlog なのに
+      // **設定ファイルが無い案件には追加・削除を出さない。** 書き込み先が無いので
+      // 押しても 404 で終わる。三菱電機は tools が backlog なのに
       // backlog-settings.json が1つも無い（固定IP経由の同期で、UIからの投入は
       // 鍵と同じく対応していない）。会議・共有資料は unset / broken を文言で
-      // 伝えてフォームを出さない形なので、課題管理だけ不揃いだった
+      // 伝えてフォームを出さない形なので、課題管理だけ不揃いだった。
+      // 一覧そのもの（現在の接続先）は**そういう案件にも出す**——読めているものを隠さない
       //
       // **接続先の正本は issues-config.json（#111）**だが、その置き場は
       // 同期ミラー（backlog-settings.json）の位置から決めている。ミラーが1つも
       // 無い案件では正本をどこへ置けばよいかも決められないので、条件は変わらない
+      box.appendChild(backlogTargetsSection(s));
       if (!s.url) {
         box.appendChild(el("p", { class: "sec-how", text: "この案件はまだ一度も Backlog と同期していないため、この画面からは接続先を設定できません。先に初回の同期を実行するか、cortex の担当者にご連絡ください。" }));
         used = true;
-      } else box.appendChild(addForm({
-        title: "接続先を変更",
-        // **「追加」ではなく「保存」。** 接続先は1件しか持てない置き換えで、
-        // 「追加」だと2つ目を足せると読める（実機テストでの指摘・複数対応は #127）
-        submitLabel: "保存",
-        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,
-            "",
-            "※ 変わるのは同期先だけです。ビューアからの起票先と Webhook の配送先は別途の対応が要ります。",
-            "",
-            "設定しますか？",
-          ];
-        },
-        build: function (url) { return { op: "set-backlog-target", url: url }; },
-      }));
+      }
       // **接続先の下に置く。** リアルタイム同期は「どのプロジェクトを見るか」が
       // 決まった後の話で、順序が逆だと、接続先を設定していない案件が先に
       // Webhook を貼りに行く（貼っても届かない）
@@ -3167,6 +3336,115 @@ ${capabilityState.toString()}
     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 から投稿することはありません。" +
+          "接続したあと、読み取りたいチャンネルにボットを招待し、この画面から追加してください。",
+      }),
+    ]);
+
+    // 接続済みの一覧。**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);
+
+    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）。
    *
@@ -3212,7 +3490,14 @@ ${capabilityState.toString()}
           "追加しますか？",
         ];
       },
-      build: function (url, name) { return { op: "add-channel", url: url, name: name }; },
+      // **選んだワークスペースを送る（#104）。** 空文字＝社内ワークスペースなのでキーごと落とす
+      // （サーバ側は「未宣言・null・空」を区別しない約束で、無いことで既定を表す）
+      build: function (url, name, workspace) {
+        var payload = { op: "add-channel", url: url, name: name };
+        if (workspace) payload.workspace = workspace;
+        return payload;
+      },
+      workspacePicker: true,
       adder: "slack",
     }));
 
@@ -3256,8 +3541,15 @@ ${capabilityState.toString()}
    * 押した内容を「（反映中）」として先に出す。出してよいのは (1) 保存の成否がサーバで
    * 確定していて推測が入らない (2) **確定した表示と見た目で区別できる**、の両方を満たす
    * ときだけ。区別しないと、リロードで消えたときに「戻された」と読まれる。
+   *
+   * **もう1つの例外が接続先の一覧（#127）。** 追加・削除の応答にはいまの一覧が必ず
+   * 添えられていて（成功も、重複で断られたときも、世代がずれていたときも）、これは
+   * スナップショットではなく**サーバが書いた直後の確定値**なので、その場で描き直してよい。
+   * @param hooks { onTargets(list) → 画面が見ていた集合と違ったか, staleNote }
+   *   onTargets … 応答に添えられた一覧を画面へ取り込む。**成否を問わず先に呼ぶ**——
+   *     断られたときこそ、画面を正しい状態へ追いつかせないと堂々巡りになる
    */
-  async function sendConfig(payload, msg, btn, onDone) {
+  async function sendConfig(payload, msg, btn, onDone, hooks) {
     var intake = SITE.intake;
     if (!intake) return;
     var pfx = intake.url + (intake.url.indexOf("?") === -1 ? "?" : "&");
@@ -3271,10 +3563,14 @@ ${capabilityState.toString()}
         body: JSON.stringify(payload),
       });
       var j = await res.json().catch(function () { return {}; });
+      // 一覧が添えられていれば、断られていても先に画面を追いつかせる（#127）
+      var raced = hooks && hooks.onTargets && Array.isArray(j.targets) ? hooks.onTargets(j.targets) : false;
       if (!res.ok) {
-        // サーバの文言をそのまま出す（貼り方の案内・取り違えの警告を含んでいる）
+        // サーバの文言をそのまま出す（貼り方の案内・取り違えの警告を含んでいる）。
+        // **例外は「他の人が先に変えていた」だけ**——サーバは再読み込みを案内するが、
+        // 画面は既に追いついているので、済んでいることをやらせる案内になる（#127）
         msg.className = "ds-toggle-msg is-error";
-        msg.textContent = "✗ " + (j.message || "保存できませんでした。");
+        msg.textContent = "✗ " + ((res.status === 409 && raced && hooks.staleNote) || j.message || "保存できませんでした。");
         btn.disabled = false;
         return;
       }
@@ -3385,18 +3681,38 @@ ${capabilityState.toString()}
   /**
    * 「＋…を追加」のフォーム。URLをそのまま貼れるようにする（IDだけを要求すると転記ミスが増える）。
    *
-   * **ボタンの語は呼び出し側が決める（既定は「追加」）。** 課題管理の「接続先を変更」だけは
-   * 1件しか持てない設定の**置き換え**なのに、ボタンが「追加」だと**複数登録できる**と読める
-   * （実機テストでの指摘。複数接続先の対応は #127 の将来要件で、いまは持てない）。
-   * 押した結果の表示（＋/追加済み）も同じ理由で語を揃える。
+   * **ボタンの語は呼び出し側が決める（既定は「追加」）。** 置き換えの設定に「追加」と書くと
+   * 2つ目を足せると読めるため、そういう口だけ submitLabel で語を変える。押した結果の
+   * 表示（＋/追加済み）も同じ理由で語を揃える。
    *
-   * @param opts { title, placeholder, hint, needsName, confirmLines, build(values), submitLabel }
+   * @param opts { title, placeholder, hint, needsName, confirmLines, build(values), submitLabel, hooks }
+   *   hooks … sendConfig へ渡す追い付き処理を返す関数（接続先の一覧・#127）。
+   *     **これがある口では、その場の控え（「追加済み・反映中」）を出さない**——
+   *     応答で本物の一覧が増えるので、控えを併記すると同じものが2回出る
    */
   function addForm(opts) {
     var main = el("input", { class: "sec-input", type: "text", placeholder: opts.placeholder, autocomplete: "off" });
     var name = opts.needsName
       ? el("input", { class: "sec-input", type: "text", placeholder: opts.namePlaceholder || "表示名", autocomplete: "off" })
       : null;
+    // 接続先ワークスペースの選択（#104・Slackの追加だけ）。
+    //
+    // **接続済みのワークスペースが1つも無ければ出さない。** 選択肢が「社内」1つだけの
+    // プルダウンは、選ぶものが無いのに1手増やすだけ。既存の全案件がこの状態から始まる。
+    //
+    // **チャンネルのURLから推測しない。** URL のホスト名（acme.slack.com）は
+    // ワークスペースの改名で変わるし、共有チャンネルでは貼った人のホストになる。
+    // 推測して間違えると「追加できたのに読まれない」チャンネルができ、
+    // 翌朝の接続状況で初めて分かる。人に選ばせる。
+    var wsList = opts.workspacePicker ? slackWorkspaces() || [] : [];
+    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" });
@@ -3415,11 +3731,13 @@ ${capabilityState.toString()}
       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);
+      var payload = opts.build(added, addedName, wsSelect ? wsSelect.value : "");
       sendConfig(payload, msg, btn, function () {
         // 追加できたら入力欄を空にする（同じものを二度押ししないように）
         main.value = "";
         if (name) name.value = "";
+        // 応答で本物の一覧が描き直される口では、控えを出さない（同じものが2回並ぶ）
+        if (opts.hooks) return;
         // **追加したものをその場に出す。** 上の一覧は fleet-status.json（夜間スナップショット）
         // から描かれているので、追加してもその場では変わらない。何も変わらないと
         // 「追加できていない」と読まれ、もう一度押して「既に登録されています」になる
@@ -3431,7 +3749,7 @@ ${capabilityState.toString()}
             el("span", { class: "ds-pending-note", text: submitLabel + "済み・反映中" }),
           ]),
         );
-      });
+      }, opts.hooks ? opts.hooks() : null);
     });
 
     // このセッションで追加したものを並べる場所（リロードすると消える＝正式な一覧は上に出る）
@@ -3442,6 +3760,7 @@ ${capabilityState.toString()}
       opts.hint ? el("p", { class: "sec-how", text: opts.hint }) : null,
       main,
       name,
+      wsSelect,
       el("div", { class: "ds-toggle" }, [btn, msg]),
       pending,
     ]);
@@ -3519,18 +3838,27 @@ ${capabilityState.toString()}
   function writePending(map) {
     try { sessionStorage.setItem(PENDING_KEY, JSON.stringify(map)); } catch (_) {}
   }
-  function clearPendingGold(ref) {
-    if (!ref) return;
+  function clearPendingGold(key) {
+    if (!key) return;
     var map = readPending();
-    if (!(ref in map)) return;
-    delete map[ref];
+    if (!(key in map)) return;
+    delete map[key];
     writePending(map);
   }
+  /**
+   * 控えの鍵。**チャンネルIDだけでは足りない（#104）。**
+   * IDはワークスペースの中でしか一意でないので、同じIDのチャンネルを2つのワークスペースに
+   * 持つ案件では、片方で押した「反映中」が**もう片方の行にも出る**。
+   */
+  function pendingKeyOf(s) {
+    if (!s || !s.ref) return "";
+    return s.workspace ? s.workspace + "\t" + s.ref : s.ref;
+  }
   /** 押した内容を控える。fleet-status が追いつくまでの間だけ効く */
-  function markPendingGold(ref, value) {
-    if (!ref) return;
+  function markPendingGold(key, value) {
+    if (!key) return;
     var map = readPending();
-    map[ref] = { value: value === true, at: Date.now() };
+    map[key] = { value: value === true, at: Date.now() };
     writePending(map);
   }
   /**
@@ -3538,9 +3866,10 @@ ${capabilityState.toString()}
    * 捨てないと、正しくなった後も (反映中) が残り続ける。
    */
   function pendingGoldFor(s) {
-    if (!s || !s.ref) return null;
+    var key = pendingKeyOf(s);
+    if (!key) return null;
     var map = readPending();
-    var e = map[s.ref];
+    var e = map[key];
     if (!e) return null;
     // **「値が一致したら捨てる」だけでは足りない。** 別の人が直後に逆を押して、
     // その結果で追いついた場合、値が一致しないので控えが残り、TTL切れまで
@@ -3573,6 +3902,26 @@ ${capabilityState.toString()}
    * **「登録から削除」が出てはいけない行に出て**、押しても翌日また現れる。
    * 全案件の再生成が回りきったら、github 側のこの分岐を落とす。
    */
+  /**
+   * 接続済み Slack ワークスペース（#104）。**空配列と undefined を区別する**——
+   * 空配列は「まだ1つも繋いでいない」（接続の導線を出してよい）、undefined は
+   * 「この項目を知らない古い fleet-status」（何も言えないので導線も一覧も出さない）。
+   * ライブ（op=state）があればそちら、無ければ静的ビルドの値。
+   */
+  function slackWorkspaces() {
+    var v = fleetVal("slackWorkspaces");
+    return Array.isArray(v) ? v : null;
+  }
+  /** team_id → 表示名。宣言はあるが一覧に無いワークスペースは team_id のまま出す */
+  function workspaceLabel(teamId) {
+    if (!teamId) return "";
+    var list = slackWorkspaces() || [];
+    for (var i = 0; i < list.length; i++) {
+      if (list[i].teamId === teamId) return list[i].name || teamId;
+    }
+    return teamId;
+  }
+
   var ORIGIN_LABEL = { explicit: "明示登録", derived: "自動検出", both: "明示登録＋自動検出" };
   var ORIGIN_HELP = {
     explicit: "開発の登録ファイル（dev-sources.json）に登録されているリポジトリです。ここから登録を削除できます。",
@@ -3593,6 +3942,16 @@ ${capabilityState.toString()}
     else if (s.goldState === "undeclared") badges.appendChild(el("span", { class: "badge ds-undeclared", text: "未宣言（対象外）" }));
     else if (s.gold === false) badges.appendChild(el("span", { class: "badge ds-excluded", text: "除外" }));
     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 ワークスペースのチャンネルです（読み取り専用の接続なので、通知は届きません）。",
+      }));
+    }
     // 登録の由来（#118）。**「登録から削除」が出る/出ないの理由がこれ。** 導出されたリポは
     // 登録ファイルから消しても翌日また現れるので削除を出していないが、画面には
     // 「同じ見た目の行なのに、片方にだけ削除がある」としか映らず、毎回考え直すことになる。

package/package.json

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