@takagaki/cortex-decisions-viewer 0.4.75 → 0.4.76

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 へ到達できなかった回に出るので、
@@ -304,7 +328,7 @@ async function readFleetSources(repoRoot) {
     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 +506,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 +1260,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; }
@@ -2326,6 +2336,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 +2846,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 +2860,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;
@@ -3167,6 +3186,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 +3340,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",
     }));
 
@@ -3397,6 +3532,24 @@ ${capabilityState.toString()}
     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,7 +3568,7 @@ ${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 = "";
@@ -3442,6 +3595,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 +3673,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 +3701,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 +3737,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 +3777,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.76",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,