@takagaki/cortex-decisions-viewer 0.4.54 → 0.4.56

package/dist/build.js

@@ -38,6 +38,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readFleetSources = readFleetSources;
 exports.build = build;
+exports.createRefResolver = createRefResolver;
 const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
 const gray_matter_1 = __importDefault(require("gray-matter"));
@@ -351,10 +352,57 @@ async function walkMd(dirAbs) {
  * - 課題キー（例: PJ_CORTEX-13）→ 同期mdに記載された Backlog Issue Link（実Backlog URL）
  * - minute:{定例名}:{YYYYMMDD} → 議事録ファイルのGitHub blobリンク
  */
+/**
+ * マーカーファイルの在り処からディレクトリ名を求める（`cortex-engine/scripts/fleet-status.mjs`
+ * の `findDirByMarker` と同じ考え方）。
+ *
+ * **ディレクトリ名をハードコードしない。** `customize-tooling` で改名している案件が実在する
+ * （ある案件は `課題管理/`→`Backlog/`・`会議/`→`MTG/`・`デザイン/`→`Figma/`）。
+ * 決め打ちだと、その案件では課題キーもFigmaも**永久に解決できない**。
+ */
+async function findDirByMarker(repoRoot, marker, fallback) {
+    try {
+        for (const d of await node_fs_1.promises.readdir(repoRoot, { withFileTypes: true })) {
+            if (!d.isDirectory() || d.name === "node_modules" || d.name.startsWith("."))
+                continue;
+            try {
+                await node_fs_1.promises.stat(path.join(repoRoot, d.name, marker));
+                return d.name;
+            }
+            catch {
+                // 直下に無ければ1階層下も見る（backlog-settings.json は issues/ の下に置かれる）
+            }
+            try {
+                for (const sub of await node_fs_1.promises.readdir(path.join(repoRoot, d.name), { withFileTypes: true })) {
+                    if (!sub.isDirectory())
+                        continue;
+                    try {
+                        await node_fs_1.promises.stat(path.join(repoRoot, d.name, sub.name, marker));
+                        return d.name;
+                    }
+                    catch {
+                        // 次へ
+                    }
+                }
+            }
+            catch {
+                // 読めないディレクトリは飛ばす
+            }
+        }
+    }
+    catch {
+        // repoRoot が読めなければ既定名で進む
+    }
+    return fallback;
+}
 async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
     const map = new Map();
-    // 課題キー → Backlog URL（課題管理/issues/ の同期mdの基本情報から抽出）
-    for (const file of await walkMd(path.join(repoRoot, "課題管理", "issues"))) {
+    const issuesDir = await findDirByMarker(repoRoot, "backlog-settings.json", "課題管理");
+    const designDir = await findDirByMarker(repoRoot, "figma.json", "デザイン");
+    const meetingDir = await findDirByMarker(repoRoot, "ingest-config.json", "会議");
+    const materialsDir = await findDirByMarker(repoRoot, "materials-config.json", "共有資料");
+    // 課題キー → Backlog URL（{課題管理}/issues/ の同期mdの基本情報から抽出）
+    for (const file of await walkMd(path.join(repoRoot, issuesDir, "issues"))) {
         try {
             const head = (await node_fs_1.promises.readFile(file, "utf8")).slice(0, 4000);
             const keyMatch = head.match(/^- 課題キー: (\S+)$/m);
@@ -367,7 +415,7 @@ async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
         }
     }
     // material:{slug} → 共有資料の正本（Drive等のsource URL）。無ければ変換済みmdのGitHubリンク
-    for (const file of await walkMd(path.join(repoRoot, "共有資料"))) {
+    for (const file of await walkMd(path.join(repoRoot, materialsDir))) {
         if (path.basename(file).toLowerCase() === "link.md")
             continue;
         try {
@@ -397,22 +445,32 @@ async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
             // 読めないファイルはスキップ
         }
     }
-    // design:{fileKey}:{nodeId} → Figmaディープリンク（インベントリのfrontmatterから）
-    for (const file of await walkMd(path.join(repoRoot, "デザイン", "inventory"))) {
+    // design:{fileKey}:{nodeId} → Figmaディープリンク
+    //
+    // **frontmatter からは取れない。** インベントリは frontmatter を持たない
+    // （frontmatter を持つのは Gold層だけ＝オントロジー規約）。参照IDもFigmaのURLも**本文**にある:
+    //   - 参照ID: `design:xxx:103:1836`
+    //   - [Figmaで開く](https://www.figma.com/design/...)
+    // 以前は `data.type === "design"` を見ていたので、この解決は**一度も効いていなかった**。
+    for (const file of await walkMd(path.join(repoRoot, designDir, "inventory"))) {
         try {
-            const { data } = (0, gray_matter_1.default)(await node_fs_1.promises.readFile(file, "utf8"));
-            if (data.type === "design" && data.id && data.source) {
-                map.set(String(data.id), String(data.source));
-            }
+            const body = await node_fs_1.promises.readFile(file, "utf8");
+            const id = body.match(/^- 参照ID: `(design:[^`]+)`\s*$/m);
+            const url = body.match(/^- \[Figmaで開く\]\((https?:[^)]+)\)\s*$/m);
+            if (id && url)
+                map.set(id[1], url[1]);
         }
         catch {
             // 読めないファイルはスキップ
         }
     }
     // minute:{定例名}:{YYYYMMDD} → 議事録ファイルのGitHubリンク
-    // パス規約: ミーティング/{フェーズ}/{定例名}/{YYYYMMDD}/*minutes*.md
+    // パス規約: {会議}/{フェーズ}/{定例名}/{YYYYMMDD}/*minutes*.md
+    //
+    // **以前は存在しない `ミーティング/` を見ていた**（艦隊は全案件 `会議/`。改名案件は `MTG/`）。
+    // そのため minute: の解決は一度も効いていなかった。
     if (repoBaseUrl) {
-        for (const file of await walkMd(path.join(repoRoot, "ミーティング"))) {
+        for (const file of await walkMd(path.join(repoRoot, meetingDir))) {
             const name = path.basename(file).toLowerCase();
             if (!name.includes("minutes"))
                 continue;
@@ -567,7 +625,7 @@ async function scanContent(repoRoot, goldDirName, repoBaseUrl, branch) {
  * 参照先がリポジトリ内のレコードでないIDは、層を推定したファントムノードとして表示する
  * （minute:/material:→Silver、課題キー・外部URL→Bronze、Goldの未解決ID→phantom）。
  */
-function buildGraph(decisions, home, sections, content, targetUrls, repoBaseUrl, branch) {
+function buildGraph(decisions, home, sections, content, targetUrls, repoBaseUrl, branch, refs) {
     const nodes = new Map();
     const edges = [];
     const addNode = (node) => {
@@ -627,7 +685,12 @@ function buildGraph(decisions, home, sections, content, targetUrls, repoBaseUrl,
         else if (target.includes("/") || target.toLowerCase().endsWith(".md")) {
             group = "silver"; // リポジトリ内ファイルへのパス参照 → GitHubのコピーへ飛べるようにする
             label = target.split("/").pop() ?? target;
-            const blobUrl = repoBaseUrl ? `${repoBaseUrl}/blob/${branch}/${encodePath(target)}` : undefined;
+            // **実在するものだけリンクにする。** 詳細画面（resolveReference）と同じ判定を使う。
+            // ここだけ無条件に blob URL を作っていたため、同じ参照が「詳細ではテキスト・
+            // グラフでは404リンク」に分かれていた（グラフのノードは window.open される）。
+            const blobUrl = repoBaseUrl && refs.exists(target)
+                ? `${repoBaseUrl}/blob/${branch}/${encodePath(target)}`
+                : undefined;
             return addNode({ id: target, label, group, url: blobUrl });
         }
         return addNode({ id: target, label, group });
@@ -948,15 +1011,23 @@ async function build(opts) {
     // （Decisionsディレクトリで実行すると `-- Cortex/` に一致せず常に空になる）。
     // 浅いclone・git無しの環境では空集合が返り、「最新」ラベルが出ないだけで他の表示は壊れない。
     LATEST_PATHS = (0, repo_1.latestGeneratedPaths)(process.cwd());
+    // Cortex構成なら、ホームと「records/ を持つディレクトリ」をすべて読み込む（旧構成では空）
+    // ディレクトリ名はハードコードしない: 案件が新しいレコード種別のディレクトリを足せば、そのままタブとして表示される
+    const knowledgeRoot = resolveKnowledgeRoot(dirAbs);
+    // **参照の解決器は decisions のパースより前に作る。** parseDecision が references を
+    // 解決するので、あとから作ると空の表・空の実在判定が渡り、**実在するパスまで
+    // 「リンクにしない」に倒れて全滅する**（以前は順序が逆だった）。
+    const repoRoot = knowledgeRoot ? path.dirname(knowledgeRoot) : path.dirname(dirAbs);
+    const targetUrls = knowledgeRoot
+        ? await buildTargetUrlMap(repoRoot, repo.baseUrl, repo.branch)
+        : new Map();
+    const refs = createRefResolver({ repoRoot, targetUrls, repoBaseUrl: repo.baseUrl, branch: repo.branch });
     const decisions = [];
     for (const fileName of mdFiles) {
         const raw = await node_fs_1.promises.readFile(path.join(dirAbs, fileName), "utf8");
-        const rec = await parseDecision(raw, fileName, repoRelDir, repo.baseUrl, repo.branch);
+        const rec = await parseDecision(raw, fileName, repoRelDir, repo.baseUrl, repo.branch, refs);
         decisions.push(rec);
     }
-    // Cortex構成なら、ホームと「records/ を持つディレクトリ」をすべて読み込む（旧構成では空）
-    // ディレクトリ名はハードコードしない: 案件が新しいレコード種別のディレクトリを足せば、そのままタブとして表示される
-    const knowledgeRoot = resolveKnowledgeRoot(dirAbs);
     let home = null;
     const sections = [];
     if (knowledgeRoot) {
@@ -989,12 +1060,8 @@ async function build(opts) {
     const categories = uniqueSorted(decisions.map((d) => d.category).filter(Boolean));
     // 期間フィルタ用の月（YYYY-MM）を日付から導出し、降順（新しい順）にする
     const months = uniqueSorted(decisions.map((d) => d.date.slice(0, 7)).filter((m) => /^\d{4}-\d{2}$/.test(m))).reverse();
-    const repoRoot = knowledgeRoot ? path.dirname(knowledgeRoot) : path.dirname(dirAbs);
-    const targetUrls = knowledgeRoot
-        ? await buildTargetUrlMap(repoRoot, repo.baseUrl, repo.branch)
-        : new Map();
     const contentEntries = await scanContent(repoRoot, knowledgeRoot ? path.basename(knowledgeRoot) : null, repo.baseUrl, repo.branch);
-    const graph = buildGraph(decisions, home, sections, contentEntries, targetUrls, repo.baseUrl, repo.branch);
+    const graph = buildGraph(decisions, home, sections, contentEntries, targetUrls, repo.baseUrl, repo.branch, refs);
     computeLayout(graph); // 各ノードに x/y を書き込む（クライアントはこれを初期位置に使いウォームアップ省略）
     // データソースと自動化（fleet-status.json 由来）。無ければ undefined でセクション非表示。
     const fleet = await readFleetSources(repoRoot);
@@ -1055,7 +1122,7 @@ async function build(opts) {
     const sectionCount = sections.reduce((n, s) => n + s.records.length, 0);
     return { count: decisions.length + (home ? 1 : 0) + sectionCount, outDir: outAbs };
 }
-async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch) {
+async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch, refs) {
     const { data, content } = (0, gray_matter_1.default)(raw);
     const id = String(data.id ?? fileName.replace(/\.md$/i, ""));
     const title = String(data.title ?? stripIdPrefix(fileName));
@@ -1065,7 +1132,7 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch) {
     const summary = data.description != null ? String(data.description) : data.summary != null ? String(data.summary) : ""; // description優先（旧summaryは移行期互換）
     const deciders = toStringArray(data.deciders);
     const referencesRaw = toStringArray(data.references);
-    const references = referencesRaw.map((r) => resolveReference(r, repoBaseUrl, branch));
+    const references = referencesRaw.map((r) => refs.resolve(r));
     const relations = toRelations(data.relations);
     // 本文先頭の H1 はタイトルと重複するため除去（詳細画面ではタイトルを別途表示する）
     const bodyHtml = externalLinksToNewTab((await marked_1.marked.parse(content, { async: true })).replace(/^\s*<h1[^>]*>[\s\S]*?<\/h1>\s*/, ""));
@@ -1095,25 +1162,50 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch) {
         fmErrors: validateFm(data),
     };
 }
-function resolveReference(ref, repoBaseUrl, branch) {
-    const trimmed = ref.trim();
-    // markdownリンク [label](url)
-    const mdLink = trimmed.match(/^\[([^\]]+)\]\(([^)]+)\)$/);
-    if (mdLink) {
-        return { label: mdLink[1], url: mdLink[2] };
-    }
-    // 既にURL
-    if (/^https?:\/\//.test(trimmed)) {
-        return { label: trimmed, url: trimmed };
-    }
-    // リポジトリルート相対のローカルパスとみなす → GitHubのblobリンク
-    if (repoBaseUrl) {
-        return {
-            label: trimmed,
-            url: `${repoBaseUrl}/blob/${branch}/${encodePath(trimmed)}`,
-        };
-    }
-    return { label: trimmed, url: null };
+function createRefResolver(opts) {
+    const { repoRoot, targetUrls, repoBaseUrl, branch } = opts;
+    // **走査結果を流用しない。** scanContent は `.md` しか歩かず SCAN_SKIP_DIRS を除外するので、
+    // 実在する `.txt`（Geminiメモ）や `tmp/` 配下のファイルを「実在しない」と誤判定して
+    // **いま動いているリンクを消す**。参照は1リポジトリあたり数百件なので stat で十分。
+    const seen = new Map();
+    const exists = (relPath) => {
+        const hit = seen.get(relPath);
+        if (hit !== undefined)
+            return hit;
+        let ok = false;
+        try {
+            // パス要素に混ざる制御文字・絶対パス・親ディレクトリ参照は見に行かない
+            if (relPath && !path.isAbsolute(relPath) && !relPath.split("/").includes("..")) {
+                (0, node_fs_1.statSync)(path.join(repoRoot, relPath));
+                ok = true;
+            }
+        }
+        catch {
+            ok = false;
+        }
+        seen.set(relPath, ok);
+        return ok;
+    };
+    const resolve = (ref) => {
+        const trimmed = String(ref ?? "").trim();
+        if (!trimmed)
+            return { label: trimmed, url: null };
+        const mdLink = trimmed.match(/^\[([^\]]+)\]\(([^)]+)\)$/);
+        if (mdLink)
+            return { label: mdLink[1], url: mdLink[2] };
+        if (/^https?:\/\//.test(trimmed))
+            return { label: trimmed, url: trimmed };
+        // 正本のURL（課題キー・material:・design:・minute:）。**ここが「ツールへ飛ぶ」の本体**
+        const known = targetUrls.get(trimmed);
+        if (known)
+            return { label: trimmed, url: known };
+        // 実在するファイルだけ blob URL にする
+        if (repoBaseUrl && exists(trimmed)) {
+            return { label: trimmed, url: `${repoBaseUrl}/blob/${branch}/${encodePath(trimmed)}` };
+        }
+        return { label: trimmed, url: null };
+    };
+    return { resolve, exists };
 }
 /** dirをリポジトリルート相対（posix）に。cwd配下でなければ basename を返す。 */
 function toRepoRelative(dir) {

package/dist/render.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderSite = renderSite;
+exports.renderConnectionMap = renderConnectionMap;
 /** SiteDataを単一の自己完結HTML（埋め込みデータ+CSS+JS）にレンダリングする */
 function renderSite(site) {
     // </script> によるブレイクアウトを防ぐため < をエスケープして埋め込む
@@ -140,36 +141,94 @@ function renderConnectionMap(site) {
                 // マップが⚠️なのに直下のグループが「接続OK」という矛盾が同じ画面に出る。
                 ? liveExts.some((s) => sourceNeedsAttention(s))
                 : pipes.some((p) => c.pipe != null && c.pipe.test(p.id) && p.applicable !== false && p.lastConclusion === "failure"));
-        const state = off ? "cm-off" : warn ? "cm-warn" : "cm-ok";
-        const toolName = toolVal && toolVal !== "none"
-            ? CM_TOOL_LABEL[toolVal] ?? toolVal
-            : internal
-                ? CM_TOOL_LABEL[internal.tool] ?? internal.tool
+        // **宣言されているだけで、実際には何も繋がっていない**状態を分けて表す。
+        //
+        // 会議に Teams、チャットに Teams を宣言した案件で、どちらも「接続済み」の見た目になっていた。
+        // notetaker は Teams の文字起こしを取り込めず（Google Meet 前提）、Teams の MCP も配っていないので、
+        // **実体は何も繋がっていない**。それを繋がって見せると、設定が足りないことに誰も気づけない。
+        //
+        //   - 会議: 取り込みが有効（ingestState === "on"）でなければ「自動連携なし」
+        //   - チャット/開発: ライブ参照の実体（登録されたチャンネル・リポジトリ）が無ければ同じ
+        //
+        // **能力ごとに場当たりで判定しない。** 最初は会議とライブ参照だけを見ていたが、
+        // 課題管理が「宣言があるだけ」で接続済み（青）に見えていた——同期が一度も走っておらず、
+        // APIキーすら入っていない案件で。指摘されるまで気づけなかった。
+        //
+        // 「実際に繋がっている」の証拠は共通で次のどれか:
+        //   - 一度でも同期が走った（lastSync）
+        //   - 正本のURLが導出できる（url。設定ファイルが実在して初めて出る）
+        //   - 会議は取り込みが有効（ingestState === "on"）
+        //   - ライブ参照は読む対象が1件以上ある
+        const idle = !off &&
+            (isLive
+                ? liveExts.length === 0
+                : c.cap === "会議"
+                    ? internal?.ingestState !== "on"
+                    : !(internal?.lastSync || internal?.url));
+        const state = off ? "cm-off" : warn ? "cm-warn" : idle ? "cm-idle" : "cm-ok";
+        // **ラベルは能力名（会議・課題管理…）。ツール名は下に小さく置く。**
+        // ツールは「その能力をいま何で実現しているか」という差し替え可能なアダプタで、
+        // 主語ではない。ツール名を主にすると、Teams のように複数の能力に使われるものが
+        // 同じ名前で並び（会議とチャットに Teams が2つ）、何が繋がっているのか読めなくなる。
+        // "none"（未使用の宣言）はツール名ではないので出さない。そのまま表示すると
+        // 「ツール: none」という読めない行になる（実際にそう出ていた）
+        const rawTool = toolVal && toolVal !== "none"
+            ? toolVal
+            : internal && internal.tool && internal.tool !== "none"
+                ? internal.tool
                 : isLive && liveExts.length
-                    ? CM_TOOL_LABEL[c.cap === "チャット" ? "slack" : "github"]
-                    : c.cap;
-        const label = `${c.icon} ${off && (toolVal === "none" || !toolName) ? c.cap : toolName}`;
-        // ノード下の補足: 未使用 / ライブ参照 / 最終同期（時刻はクライアントでローカルタイム整形するため data-ts で渡す）
-        let sub = "";
+                    ? c.cap === "チャット"
+                        ? "slack"
+                        : "github"
+                    : "";
+        const toolName = rawTool ? CM_TOOL_LABEL[rawTool] ?? rawTool : "";
+        const label = `${c.icon} ${c.cap}`;
+        // 2行目=ツール名（小さく）／3行目=状態（未使用・自動連携なし・ライブ参照・最終同期）
+        const toolLine = toolName
+            ? `<text class="cm-tool" x="${cx}" y="53" text-anchor="middle">${escapeHtml(toolName)}</text>`
+            : "";
+        let statusText = "";
+        let statusTs = "";
         if (off) {
-            sub = `<text class="cm-sync" x="${cx}" y="60" text-anchor="middle">未使用</text>`;
+            statusText = "未使用";
+        }
+        else if (idle) {
+            // **「未接続」と言い切る。** 「自動連携なし」だと運用でそう決めたようにも読めるが、
+            // 実際は「宣言はあるが、まだ一度も繋がっていない」——やることが残っている状態
+            statusText = "未接続";
         }
         else if (isLive) {
-            sub = `<text class="cm-sync" x="${cx}" y="60" text-anchor="middle">ライブ参照</text>`;
+            statusText = "ライブ参照";
         }
         else if (internal?.lastSync) {
-            sub = `<text class="cm-sync" x="${cx}" y="60" text-anchor="middle" data-ts="${escapeHtml(internal.lastSync)}"></text>`;
+            statusTs = internal.lastSync;
         }
-        const badge = warn ? `<text class="cm-badge" x="${cx + 62}" y="26" text-anchor="middle">⚠️</text>` : "";
+        // 時刻はクライアントでローカルタイム整形するため data-ts で渡す
+        const sub = statusText || statusTs
+            ? `<text class="cm-sync" x="${cx}" y="67" text-anchor="middle"` +
+                (statusTs ? ` data-ts="${escapeHtml(statusTs)}"` : "") +
+                `>${escapeHtml(statusText)}</text>`
+            : "";
+        const badge = warn ? `<text class="cm-badge" x="${cx + 62}" y="24" text-anchor="middle">⚠️</text>` : "";
         // クリックでページ内の該当詳細カード（アンカー）へスクロールする
         const anchor = `ds-${c.cap}`;
         nodes.push(`<g class="cm-node ${state}" data-target="${anchor}" tabindex="0" role="link" aria-label="${escapeHtml(c.cap)}の詳細へ">` +
-            `<rect x="${cx - 74}" y="16" width="148" height="54" rx="10"></rect>` +
-            `<text class="cm-label" x="${cx}" y="40" text-anchor="middle">${escapeHtml(label)}</text>` +
+            `<rect x="${cx - 74}" y="12" width="148" height="64" rx="10"></rect>` +
+            `<text class="cm-label" x="${cx}" y="35" text-anchor="middle">${escapeHtml(label)}</text>` +
+            toolLine +
             sub +
             badge +
             `</g>`);
-        links.push(`<path class="cm-link ${state}" d="M ${cx} 72 C ${cx} 150, ${REPO_X} 160, ${REPO_X} 238"></path>`);
+        // **線は「実際に繋がっていることが証明できたもの」だけに引く。**
+        // 未使用（cm-off）・宣言だけで実体が無いもの（cm-idle）からは線を出さない。
+        // 薄い線でも引いてしまうと、データが流れていない経路が流れているように読める——
+        // 実際、同期が一度も走っていない課題管理が、リポジトリと線で結ばれて見えていた。
+        //
+        // cm-warn は引く。**壊れているのは「繋がったうえで失敗している」状態**で、
+        // 経路自体は存在する（線を消すと、設定が無いのと区別が付かなくなる）。
+        if (state === "cm-ok" || state === "cm-warn") {
+            links.push(`<path class="cm-link ${state}" d="M ${cx} 78 C ${cx} 152, ${REPO_X} 162, ${REPO_X} 238"></path>`);
+        }
     });
     const repoTitle = site.title.length > 24 ? site.title.slice(0, 23) + "…" : site.title;
     const repo = `<g class="cm-repo">` +
@@ -719,17 +778,30 @@ a.ds-name:hover { text-decoration: underline; }
 .cm-node.cm-ok rect { stroke: var(--accent); }
 .cm-node.cm-warn rect { fill: #fffbeb; stroke: #fcd34d; }
 .cm-node.cm-off rect { fill: #f8f9fa; stroke: #d1d5db; stroke-dasharray: 4 3; }
+/* 宣言はあるが実体が繋がっていない。未使用（グレー）とも接続済み（青）とも違うことを見せる */
+.cm-node.cm-idle rect { fill: var(--surface); stroke: #cbd5e1; stroke-dasharray: 4 3; }
+.cm-node.cm-idle .cm-sync { fill: #b45309; }
 .cm-label { font-size: 13.5px; font-weight: 600; fill: var(--text); }
 .cm-node.cm-warn .cm-label { fill: #92400e; }
 .cm-node.cm-off .cm-label { fill: #9ca3af; }
 .cm-node.cm-off text { filter: grayscale(1); opacity: .8; }
+.cm-tool { font-size: 11px; fill: var(--muted); }
+.cm-node.cm-off .cm-tool { fill: #9ca3af; }
 .cm-sync { font-size: 10.5px; fill: var(--muted); font-variant-numeric: tabular-nums; }
 .cm-node.cm-off .cm-sync { fill: #9ca3af; }
 .cm-badge { font-size: 13px; }
+/* 追加した直後にその場で見せる行。正式な一覧（スナップショット由来）に載るまでの繋ぎ */
+.ds-pending { margin-top: .5rem; display: flex; flex-direction: column; gap: .25rem; }
+.ds-pending-item { display: flex; align-items: center; gap: .5rem; font-size: .85rem;
+  padding: .35rem .6rem; border: 1px dashed var(--accent); border-radius: 6px; background: var(--accent-weak); }
+.ds-pending-mark { color: var(--accent); font-weight: 700; }
+.ds-pending-name { font-weight: 600; word-break: break-all; }
+.ds-pending-note { color: var(--muted); font-size: .78rem; margin-left: auto; white-space: nowrap; }
 .cm-link { fill: none; stroke-width: 1.6; stroke-dasharray: 6 6; stroke: #94a3b8; }
 .cm-link.cm-ok { stroke: var(--accent); animation: cm-flow 1.1s linear infinite; }
 .cm-link.cm-warn { stroke: #d97706; }
 .cm-link.cm-off { stroke: #d1d5db; opacity: .6; }
+.cm-link.cm-idle { stroke: #cbd5e1; opacity: .7; }
 @keyframes cm-flow { to { stroke-dashoffset: -24; } }
 @media (prefers-reduced-motion: reduce) { .cm-link.cm-ok { animation: none; } }
 .cm-repo rect { fill: var(--accent-weak); stroke: var(--accent); stroke-width: 1.5; }
@@ -1846,32 +1918,41 @@ const CLIENT_JS = `
     var tools = SITE.tools || {};
     var usable = function (cap, tool) { var v = tools[cap]; return !v || v === "none" || v === tool; };
 
-    if (usable("チャット", "slack")) {
-      box.appendChild(addForm({
-        title: "＋ Slackチャンネルを追加",
-        placeholder: "https://…slack.com/archives/C0XXXXXXX",
-        // **名前は任意。** URLにはIDしか入っていないので、サーバがSlackから引く。
-        // 人に入力させると打ち間違いがそのまま登録されるうえ、手間も増える。
-        // 別名を付けたいときだけ入れてもらう。
-        namePlaceholder: "表示名（省略するとSlackから取得します）",
-        requiredNote: "チャンネルのURLを入力してください。",
-        hint: "チャンネル名を右クリック →「リンクをコピー」で出るURLを貼ってください。追加しただけでは Gold 昇格には載りません（載せるには各チャンネルの「Gold昇格を始める」を押します）。cortex の Bot が入っていないチャンネルは名前を取得できません（「名前未取得」で登録され、Bot招待後にGold昇格をONにすると実名に変わります）。",
-        // **「Goldに載る」と書かない。** 追加だけでは載らないので嘘になる。
-        // 確認する理由は「中央Botで読みに行く」「他案件の取り違え」。
-        confirmLines: function (v) {
-          return [
-            "このチャンネルを、Cortex が読みに行く対象に追加します。",
-            "",
-            "貼ったURLがこの案件のものか、もう一度確認してください。",
-            "",
-            v,
-            "",
-            "追加しますか？",
-          ];
-        },
-        build: function (url, name) { return { op: "add-channel", url: url, name: name }; },
-      }));
-    }
+    // **Slack は tools 宣言で隠さない。** tools.チャット は能力ごとに1値しか持てないので、
+    // 「会議はTeams・連絡はSlack」という普通の構成を表せない。teams を宣言した案件では
+    // フォームごと消え、**Slackを渡されているのに追加できない**状態になっていた。
+    //
+    // 読む側（resolve-external-sources.mjs）も Slack の tools ゲートを外してある。
+    // Gold昇格の本来のゲートは**チャンネル単位の gold: true**（追加直後は未宣言＝読まれない。
+    // 上げたければ追加後にトグルを押す）。そこは変えていないので、宣言なしで顧客可視のGoldへ
+    // 流れることはない。
+    //
+    // 注: ここは埋め込みJSのテンプレートリテラル内。**コメントでもバッククォートを使わない**
+    //（リテラルが閉じて構文エラーになる。実際にそれで壊した）。
+    box.appendChild(addForm({
+      title: "＋ Slackチャンネルを追加",
+      placeholder: "https://…slack.com/archives/C0XXXXXXX",
+      // **名前は任意。** URLにはIDしか入っていないので、サーバがSlackから引く。
+      // 人に入力させると打ち間違いがそのまま登録されるうえ、手間も増える。
+      // 別名を付けたいときだけ入れてもらう。
+      namePlaceholder: "表示名（省略するとSlackから取得します）",
+      requiredNote: "チャンネルのURLを入力してください。",
+      hint: "チャンネル名を右クリック →「リンクをコピー」で出るURLを貼ってください。追加しただけでは Gold 昇格には載りません（載せるには各チャンネルの「Gold昇格を始める」を押します）。cortex の Bot が入っていないチャンネルは名前を取得できません（「名前未取得」で登録され、Bot招待後にGold昇格をONにすると実名に変わります）。",
+      // **「Goldに載る」と書かない。** 追加だけでは載らないので嘘になる。
+      // 確認する理由は「中央Botで読みに行く」「他案件の取り違え」。
+      confirmLines: function (v) {
+        return [
+          "このチャンネルを、Cortex が読みに行く対象に追加します。",
+          "",
+          "貼ったURLがこの案件のものか、もう一度確認してください。",
+          "",
+          v,
+          "",
+          "追加しますか？",
+        ];
+      },
+      build: function (url, name) { return { op: "add-channel", url: url, name: name }; },
+    }));
 
     if (usable("開発", "github")) {
       box.appendChild(addForm({
@@ -1938,8 +2019,20 @@ const CLIENT_JS = `
         msg.appendChild(document.createTextNode(" "));
         msg.appendChild(el("a", { href: j.runsUrl, target: "_blank", rel: "noopener", text: "実行状況を見る →" }));
       }
+      // **画面への反映も起きていることを伝える。** 一覧はスナップショットから描かれるので、
+      // 「保存した」だけでは「一覧が変わらない＝失敗した」と読まれる。
+      // 数分かかること・再読み込みで正式な一覧に載ることまで書く（黙っていると待てない）
+      // 反映にかかる時間はサーバの文言（reflectionNote）が言うので、ここでは繰り返さない。
+      // 二重に書くと同じ一文に同じ話が並ぶ
+      if (j.refreshUrl) {
+        msg.appendChild(document.createTextNode(" "));
+        msg.appendChild(el("a", { href: j.refreshUrl, target: "_blank", rel: "noopener", text: "反映の状況 →" }));
+      }
       btn.disabled = false;
-      if (onDone) onDone();
+      // **何も変わっていないなら「追加した」と見せない。** 既に同じものが入っていた場合
+      // サーバは 200 + changed:false を返す。ここを res.ok だけで判定すると
+      // 「変更はありません」と言いながら追加した行が出る
+      if (onDone && j.changed !== false) onDone();
     } catch (e) {
       msg.className = "ds-toggle-msg is-error";
       msg.textContent = "✗ 通信に失敗しました。";
@@ -2040,20 +2133,37 @@ const CLIENT_JS = `
         return;
       }
       if (opts.confirmLines && !confirmDanger(opts.confirmLines(main.value.trim()))) { msg.textContent = ""; return; }
-      var payload = opts.build(main.value.trim(), name ? name.value.trim() : "");
+      var added = main.value.trim();
+      var addedName = name ? name.value.trim() : "";
+      var payload = opts.build(added, addedName);
       sendConfig(payload, msg, btn, function () {
         // 追加できたら入力欄を空にする（同じものを二度押ししないように）
         main.value = "";
         if (name) name.value = "";
+        // **追加したものをその場に出す。** 上の一覧は fleet-status.json（夜間スナップショット）
+        // から描かれているので、追加してもその場では変わらない。何も変わらないと
+        // 「追加できていない」と読まれ、もう一度押して「既に登録されています」になる
+        // （実際にそうなった）。だから押した結果をここで見せる。
+        pending.appendChild(
+          el("div", { class: "ds-pending-item" }, [
+            el("span", { class: "ds-pending-mark", text: "＋" }),
+            el("span", { class: "ds-pending-name", text: addedName || added }),
+            el("span", { class: "ds-pending-note", text: "追加済み・反映中" }),
+          ]),
+        );
       });
     });
 
+    // このセッションで追加したものを並べる場所（リロードすると消える＝正式な一覧は上に出る）
+    var pending = el("div", { class: "ds-pending" });
+
     var box = el("div", { class: "ds-addform" }, [
       el("div", { class: "ds-addform-title", text: opts.title }),
       opts.hint ? el("p", { class: "sec-how", text: opts.hint }) : null,
       main,
       name,
       el("div", { class: "ds-toggle" }, [btn, msg]),
+      pending,
     ]);
     return box;
   }

package/package.json

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