@takagaki/cortex-decisions-viewer 0.12.111 → 0.12.113

package/dist/build.js

@@ -49,6 +49,7 @@ exports.buildHomeGrounding = buildHomeGrounding;
 exports.collectMeetings = collectMeetings;
 exports.findBacklogDir = findBacklogDir;
 exports.figmaUrlFromRef = figmaUrlFromRef;
+exports.identifyEvidence = identifyEvidence;
 exports.bodyFileSlug = bodyFileSlug;
 exports.bodyStampId = bodyStampId;
 exports.bodyStampComment = bodyStampComment;
@@ -61,6 +62,7 @@ const gray_matter_1 = __importDefault(require("gray-matter"));
 const marked_1 = require("marked");
 const sanitize_html_1 = __importDefault(require("sanitize-html"));
 const canonical_evidence_1 = require("./canonical-evidence");
+const evidence_names_1 = require("./evidence-names");
 const repo_1 = require("./repo");
 const engagement_1 = require("./engagement");
 const story_1 = require("./story");
@@ -1500,6 +1502,123 @@ async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
     }
     return map;
 }
+/**
+ * 根拠の**読める名前の帳**を組む（#968 tools 1・`evidence-names.ts`）。材料は写し（課題管理・共有資料・
+ * デザイン）と、engine が置いた `fleet-status.json` のチャンネルの一覧。読めないファイル・無い置き場は黙って飛ばす（帳が薄くなるだけ）。
+ *
+ * 🔴 **`buildTargetUrlMap` は触らない**（移る間だけ残す表・詳細画面の飛び先の正本）。ここは名前と、
+ * 写しのパス → 根拠の ID の対応だけを持つ。資料の題名を Drive の鍵にも載せるために、表の URL を読むだけ
+ */
+async function buildEvidenceBook(repoRoot, targetUrls, externalSources = []) {
+    const book = (0, evidence_names_1.emptyEvidenceBook)();
+    const rel = (file) => path.relative(repoRoot, file).split(path.sep).join("/");
+    const heading = (text) => text.match(/^#\s+(.+?)\s*$/m)?.[1] ?? null;
+    const foldKeyOf = (url) => {
+        const c = url ? (0, canonical_evidence_1.canonicalEvidence)(url) : null;
+        return c && c.kind !== "url" ? c.parentKey ?? c.key : null;
+    };
+    const putName = (key, name) => {
+        if (key && name && !book.names.has(key))
+            book.names.set(key, name);
+    };
+    // 課題（キー → 「キー 題名」）・Backlog のドキュメントと Wiki（URL の鍵 → 題名）
+    const backlogDir = await findBacklogDir(repoRoot, "課題管理");
+    for (const sub of BACKLOG_SECTIONS) {
+        for (const file of await walkMd(path.join(repoRoot, backlogDir, sub))) {
+            try {
+                const head = (await node_fs_1.promises.readFile(file, "utf8")).slice(0, 4000);
+                const title = heading(head);
+                const key = head.match(/^- 課題キー: (\S+)$/m)?.[1];
+                const link = key ? null : head.match(/\[Backlog (?:Document|Wiki) Link\]\((https?:[^)]+)\)/)?.[1];
+                const ref = key ?? link;
+                if (!ref)
+                    continue;
+                if (key)
+                    putName(key.toLowerCase(), title ? `${key} ${title}` : key);
+                else
+                    putName(foldKeyOf(link), title);
+                book.pathRefs.set(rel(file), ref);
+                const tail = (0, evidence_names_1.backlogTailOf)(rel(file));
+                if (tail && !book.backlogTailRefs.has(tail))
+                    book.backlogTailRefs.set(tail, ref);
+            }
+            catch {
+                // 読めないファイルはスキップ
+            }
+        }
+    }
+    // 資料（`material:` と元の Drive の鍵 → 題名・写しのパス → `material:`）
+    for (const file of await walkMd(path.join(repoRoot, MATERIALS_DIR))) {
+        if (path.basename(file).toLowerCase() === "link.md")
+            continue;
+        try {
+            const { data } = (0, gray_matter_1.default)(await node_fs_1.promises.readFile(file, "utf8"));
+            const stem = path.basename(file).replace(/\.md$/i, "");
+            const id = data.type === "material" && data.id ? String(data.id) : `material:${stem}`;
+            const title = typeof data.title === "string" && data.title.trim() ? data.title.trim() : stem;
+            putName(id, title);
+            putName(foldKeyOf(targetUrls.get(id)), title);
+            book.pathRefs.set(rel(file), id);
+        }
+        catch {
+            // 読めないファイルはスキップ
+        }
+    }
+    // デザイン（`design:` と Figma の鍵 → 画面・ファイルの名前・写しのパス → `design:`）。
+    // 指摘の月ごとのファイルは、同じ置き場の README の `design:`（ファイル全体）を指す
+    for (const sub of ["inventory", "指摘"]) {
+        const readmeIdByDir = new Map();
+        const monthFiles = [];
+        for (const file of await walkMd(path.join(repoRoot, DESIGN_DIR, sub))) {
+            try {
+                const body = await node_fs_1.promises.readFile(file, "utf8");
+                const id = body.match(/^- 参照ID: `(design:[^`]+)`\s*$/m)?.[1];
+                if (!id) {
+                    if (/^\d{4}-\d{2}\.md$/.test(path.basename(file)))
+                        monthFiles.push(file);
+                    continue;
+                }
+                const title = heading(body);
+                putName(id, title);
+                putName(foldKeyOf(targetUrls.get(id) ?? figmaUrlFromRef(id)), title);
+                book.pathRefs.set(rel(file), id);
+                if (path.basename(file).toLowerCase() === "readme.md")
+                    readmeIdByDir.set(path.dirname(file), id);
+            }
+            catch {
+                // 読めないファイルはスキップ
+            }
+        }
+        for (const file of monthFiles) {
+            const id = readmeIdByDir.get(path.dirname(file));
+            if (id)
+                book.pathRefs.set(rel(file), id);
+        }
+    }
+    // チャット（チャンネルの鍵 → `#名前`・名前 → URL）。同じ名前に違う URL が 2 本なら名前からは引かない。
+    // 🔴 **登録簿（`チャット/channels.json`）は読まない**（engine #275・`no-registry-read.test.mjs`）。engine が
+    // 登録簿から算出して置いた `fleet-status.json` の `externalSources` を読む
+    const ambiguous = new Set();
+    for (const src of externalSources) {
+        const url = src.url ?? "";
+        const bare = src.name.trim().replace(/^#/, "");
+        const key = foldKeyOf(url);
+        if (!url || !bare || !key || !(key.startsWith("slack:") || key.startsWith("gchat:")))
+            continue;
+        putName(key, key.startsWith("slack:") ? `#${bare}` : bare);
+        if (!key.startsWith("slack:"))
+            continue;
+        const k = bare.toLowerCase();
+        const prev = book.slackUrlsByName.get(k);
+        if (prev !== undefined && foldKeyOf(prev) !== key)
+            ambiguous.add(k);
+        else
+            book.slackUrlsByName.set(k, url);
+    }
+    for (const k of ambiguous)
+        book.slackUrlsByName.delete(k);
+    return book;
+}
 /**
  * 指摘のスレッドから `figma-comment:{fileKey}:{commentId}` → 「Figmaでこの指摘を開く」の URL を拾う。
  *
@@ -1609,6 +1728,9 @@ const NO_ORIGINAL_TOOL_LABEL = "元のツールが無い根拠";
 function readableEvidenceLabel(kind, key, fallback) {
     switch (kind) {
         case "backlog":
+            // Wiki・ドキュメントの鍵（`backlog:{host}:wiki:N`）は機械の語なので、種類の名前にする
+            if (key.startsWith("backlog:"))
+                return key.includes(":wiki:") ? "Backlog の Wiki" : "Backlog のドキュメント";
             return key.toUpperCase();
         case "github":
             return key.replace(/^gh:/, "");
@@ -1622,11 +1744,116 @@ function readableEvidenceLabel(kind, key, fallback) {
         case "slack":
             return "Slack のメッセージ";
         case "gchat":
-            return "Google Chat のメッセージ";
+            return "Google Chat のスペース";
         default:
             return fallback;
     }
 }
+/** 課題キーだけの値（`buildGraph` の旧経路と同じ形） */
+const ISSUE_KEY_ONLY_RE = /^[A-Z][A-Z0-9_]*-\d+$/;
+/** `owner/repo#N` だけの値（`canonicalEvidence` の `WHOLE_GH_SHORT_RE` と同じ形） */
+const GH_SHORT_ONLY_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+#\d+$/;
+/**
+ * 根拠の値（URL・`[ラベル](URL)`・課題キー・`owner/repo#N`・`minute:`/`material:`/`design:`/`figma-comment:`・
+ * 写しのパス・`[slack] #名前 (…)`）から、点の鍵と読める名前を決める（#968 tools 1）。
+ *
+ * 🔴 **今の ID の根拠と新しい URL の根拠を同じ鍵に寄せる。** ID は対応表（`targetUrls`）で URL に引き、
+ * `canonicalEvidence` の `key` にする（コメントは親の鍵）。写しのパスは帳で ID に引いてから同じ道を通す。
+ * cortex の Gold は付け替えの途中で ID と URL が混ざった状態が数晩続く（便 3 の on の夜から）ので、
+ * ここが割れると同じ課題・同じ資料の点が 2 つに分かれる。
+ *
+ * 根拠ではない値（Gold の ID・崩れた文字・帳に無いパス）は `null`——呼び出し側が今までどおり扱う。
+ */
+function identifyEvidence(value, ctx, humanLabel) {
+    const { book, targetUrls, dropLink } = ctx;
+    let raw = String(value ?? "").trim();
+    let human = humanLabel && humanLabel.trim() ? humanLabel.trim() : undefined;
+    if (!raw)
+        return null;
+    // 解決器（`createRefResolver`）と同じ受け方（URL の中の空白も受ける）
+    const md = raw.match(/^\[([^\]]+)\]\((https?:\/\/[^)]+)\)$/i);
+    if (md) {
+        human = human ?? md[1].trim();
+        raw = md[2];
+    }
+    const channel = (0, evidence_names_1.slackChannelOfLabel)(raw);
+    if (channel) {
+        const url = book.slackUrlsByName.get(channel.toLowerCase());
+        if (!url)
+            return { id: `slack-name:${channel.toLowerCase()}`, label: `#${channel}`, rank: 2, group: "silver", kind: "slack" };
+        human = human ?? `#${channel}`;
+        raw = url;
+    }
+    // 自分のリポジトリの写しへの blob URL は、写しのパスに戻してから引く（同じ会議・課題の点に畳む）
+    if (ctx.blobPrefix && raw.startsWith(ctx.blobPrefix)) {
+        try {
+            // `{branch}/{path}`（ブランチの段を外す）
+            raw = decodeURIComponent(raw.slice(ctx.blobPrefix.length).replace(/[?#].*$/, "").replace(/^[^/]+\//, ""));
+        }
+        catch {
+            // 崩れたエスケープはそのまま
+        }
+    }
+    const tail = (0, evidence_names_1.backlogTailOf)(raw);
+    raw = book.pathRefs.get(raw) ?? (tail ? book.backlogTailRefs.get(tail) : undefined) ?? (0, evidence_names_1.minuteRefOfPath)(raw) ?? raw;
+    const rankOf = (named) => (named ? 3 : human ? 2 : 1);
+    if (ISSUE_KEY_ONLY_RE.test(raw)) {
+        const key = raw.toLowerCase();
+        const name = book.names.get(key);
+        return { id: key, label: name ?? raw, rank: name ? 3 : 1, group: "bronze", url: dropLink(targetUrls.get(raw)), kind: "backlog" };
+    }
+    if (raw.startsWith("minute:")) {
+        const named = (0, evidence_names_1.minuteLabel)(raw);
+        return {
+            id: (0, evidence_names_1.minuteFoldKey)(raw) ?? raw,
+            label: named ?? human ?? "会議の議事録",
+            rank: named ? 3 : rankOf(false),
+            group: "silver",
+            url: dropLink(targetUrls.get(raw)),
+            kind: "minute",
+        };
+    }
+    let idRef = null;
+    let url = null;
+    if (/^(material|design|figma-comment):/.test(raw)) {
+        idRef = raw;
+        url = targetUrls.get(raw) ?? figmaUrlFromRef(raw);
+    }
+    else if (/^https?:\/\//i.test(raw) || GH_SHORT_ONLY_RE.test(raw)) {
+        url = raw;
+    }
+    else {
+        return null;
+    }
+    const canon = url ? (0, canonical_evidence_1.canonicalEvidence)(url) : null;
+    if (!canon || canon.kind === "url") {
+        if (idRef) {
+            const name = book.names.get(idRef);
+            return { id: idRef, label: name ?? human ?? (0, evidence_names_1.idFallbackLabel)(idRef), rank: rankOf(!!name), group: "silver", url: dropLink(url), kind: "id" };
+        }
+        // 対応表に無い種類の URL。今までどおり構文を正規化した URL を鍵にする
+        const id = canon ? canon.url : raw;
+        return { id, label: human ?? raw.replace(/^https?:\/\//i, "").slice(0, 60), rank: rankOf(false), group: "external", url: dropLink(id), kind: "url" };
+    }
+    const foldKey = canon.parentKey ?? canon.key;
+    // 飛び先も親（コメント・返信の断片を外した課題・Issue）にそろえる——点は親なので
+    const link = canon.parentKey ? canon.url.replace(/#.*$/, "") : canon.url;
+    let name = book.names.get(foldKey) ?? (idRef ? book.names.get(idRef) : undefined);
+    if (!name && canon.kind === "slack") {
+        const ch = book.names.get(foldKey.replace(/:p\d+$/, ""));
+        if (ch)
+            name = foldKey.includes(":p") ? `${ch} のメッセージ` : ch;
+    }
+    const fallback = canon.kind === "slack" && !foldKey.includes(":p") ? "Slack のチャンネル" : readableEvidenceLabel(canon.kind, foldKey, raw);
+    return {
+        id: foldKey,
+        label: name ?? human ?? fallback,
+        rank: rankOf(!!name),
+        group: EVIDENCE_GROUP[canon.kind] ?? "external",
+        url: dropLink(link),
+        kind: canon.kind,
+    };
+}
 /**
  * 全レコードのfrontmatter（relations / source / references）と本文リンクから関係グラフを構築する（engine #551・分類A 10/1）。
  *
@@ -1644,7 +1871,7 @@ function readableEvidenceLabel(kind, key, fallback) {
  * ほうがよい（`createRefResolver` と同じ考え方）。崩れた文字（宛先に見えない参照）も同様に、
  * 点は作るが飛び先は付けない。
  */
-function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
+function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl, book = (0, evidence_names_1.emptyEvidenceBook)()) {
     const nodes = new Map();
     const edges = [];
     const addNode = (node) => {
@@ -1685,83 +1912,56 @@ function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
     // （leaderの実測で77件）を無くすのが今回の決定の本題なので、ここも揃えて飛び先を外す
     // （`graph-gold-only.test.mjs` の「議事録を根拠にした決定」で固定）。
     const dropMirrorBlob = (url) => url == null || (repoBaseUrl != null && url.startsWith(`${repoBaseUrl}/blob/`)) ? undefined : url;
-    // 課題・GitHub 等の鍵（`canonicalEvidence` の `key`、コメントは親の鍵）→ 先に作った点のID。
-    // 同じ課題を「課題キー」「URL」「コメントのURL」のどの形で指していても、1つの点に畳むために使う
-    // （#968 tools 1・設計v3「点を正規化の鍵で畳む」）
-    const evidenceKeyToNodeId = new Map();
+    // 根拠の点の名前の強さ（`EvidenceIdentity.rank`）。同じ点に強い名前が後から来たら上書きする
+    const labelRank = new Map();
+    const identityCtx = { book, targetUrls, dropLink: dropMirrorBlob, blobPrefix: repoBaseUrl ? `${repoBaseUrl}/blob/` : undefined };
     /**
-     * 根拠の URL を、`canonicalEvidence` の鍵で重複を畳んで点にする（#968 tools 1）。
-     * 解けない（対応表でしか引けない・URLが2本以上混ざる等）URL は、今までどおり生のURLをIDにする。
+     * 根拠を、畳む鍵（`identifyEvidence`）で 1 つの点にする（#968 tools 1）。同じ課題・資料・会議を、
+     * 課題キー・URL・コメントの URL・`material:`・写しのパスのどの形で指しても同じ点に集まる。
+     * 先にできた点の名前が弱ければ（種類の既定・URL）、強い名前（帳の題名・人が付けたリンクの文字）で上書きし、
+     * 飛び先が無ければ後から来た飛び先を付ける
      */
-    const addEvidenceUrlNode = (rawUrl, fallbackLabel, preferFallbackLabel = false) => {
-        const canon = (0, canonical_evidence_1.canonicalEvidence)(rawUrl);
-        if (!canon)
-            return addNode({ id: rawUrl, label: fallbackLabel, group: "external", url: dropMirrorBlob(rawUrl) });
-        // コメント・返信は独立の点にせず、親（課題・Issue）の点に畳む
-        const foldKey = canon.parentKey ?? canon.key;
-        const existing = evidenceKeyToNodeId.get(foldKey);
-        if (existing && nodes.has(existing))
-            return existing;
-        const group = canon.kind === "url" ? "external" : EVIDENCE_GROUP[canon.kind] ?? "external";
-        // 対応表に無い種類（kind: "url"）は、元から有効だった生URLに近い綴りをIDにする
-        // （既存の点のURL・1番目に見つかった記録の飛び先を変えない）
-        const id = canon.kind === "url" ? canon.url : foldKey;
-        // fallbackLabel が markdown リンクの表示文字列等（既に読める名前）なら、それを使う
-        // （例: 資料の題名）。生URLしか無いときだけ、根拠の種類から読める名前を補う
-        const label = canon.kind === "url" || preferFallbackLabel ? fallbackLabel : readableEvidenceLabel(canon.kind, foldKey, fallbackLabel);
-        const nodeId = addNode({ id, label, group, url: dropMirrorBlob(canon.url) });
-        evidenceKeyToNodeId.set(foldKey, nodeId);
-        return nodeId;
+    const addEvidence = (ev) => {
+        const existing = nodes.get(ev.id);
+        // Gold の記録・宛先の引けない点と鍵がぶつかったときは、その点の名前・飛び先を書き換えない
+        if (existing && !labelRank.has(ev.id))
+            return ev.id;
+        if (!existing) {
+            addNode(ev.url ? { id: ev.id, label: ev.label, group: ev.group, url: ev.url } : { id: ev.id, label: ev.label, group: ev.group });
+            labelRank.set(ev.id, ev.rank);
+            return ev.id;
+        }
+        if (ev.rank > (labelRank.get(ev.id) ?? 0)) {
+            existing.label = ev.label;
+            labelRank.set(ev.id, ev.rank);
+        }
+        if (!existing.url && ev.url)
+            existing.url = ev.url;
+        return ev.id;
     };
     // 参照先IDから層を推定してノード化する
-    const classifyTarget = (target) => {
-        if (nodes.has(target))
+    const classifyTarget = (target, humanLabel) => {
+        if (nodes.has(target) && !labelRank.has(target))
             return target;
         // パス参照でも、末尾がレコードのファイル名ならレコードノードへ解決する
         const base = target.split("/").pop() ?? target;
         const resolved = fileNameToId.get(base);
         if (resolved && nodes.has(resolved))
             return resolved;
-        let group = "phantom";
-        let label = target;
         if (target.startsWith(NO_ORIGINAL_TOOL_PREFIX)) {
             // 元ツールが無い根拠（engine #968 の将来の語彙）。リンクにせず、機械の語（urn:…）を出さない
             return addNode({ id: target, label: NO_ORIGINAL_TOOL_LABEL, group: "phantom" });
         }
-        else if (target.startsWith("minute:") ||
-            target.startsWith("material:") ||
-            target.startsWith("design:") ||
-            target.startsWith("figma-comment:")) {
-            group = "silver";
-            // 表に無い design: / figma-comment: はキーから組む（詳細画面の resolve と同じ順）
-            const url = dropMirrorBlob(targetUrls.get(target) ?? figmaUrlFromRef(target));
-            if (url)
-                return addNode({ id: target, label, group, url });
-        }
-        else if (/^[A-Z][A-Z0-9_]*-\d+$/.test(target)) {
-            // 課題キー → 同期mdから解決した実Backlog URLに飛べるようにする（#968 便1までは1バイトも変えない表示）。
-            // 同じ課題が先にURLの形で現れていれば、その点に畳む
-            group = "bronze";
-            const foldKey = target.toLowerCase();
-            const existing = evidenceKeyToNodeId.get(foldKey);
-            if (existing && nodes.has(existing))
-                return existing;
-            const url = dropMirrorBlob(targetUrls.get(target));
-            const nodeId = addNode(url ? { id: target, label, group, url } : { id: target, label, group });
-            evidenceKeyToNodeId.set(foldKey, nodeId);
-            return nodeId;
-        }
-        else if (/^https?:\/\//.test(target)) {
-            return addEvidenceUrlNode(target, target.replace(/^https?:\/\//, "").slice(0, 60));
-        }
-        else if (target.includes("/") || target.toLowerCase().endsWith(".md")) {
-            // リポジトリ内ファイルへの生のパス参照（同期ミラーの議事録・資料など）。
-            // 元ツールのURLがまだ無い記録は、点にするが飛び先を付けない（#968 の書き換えを待つ）
-            group = "silver";
-            label = target.split("/").pop() ?? target;
-            return addNode({ id: target, label, group });
-        }
-        return addNode({ id: target, label, group });
+        const ev = identifyEvidence(target, identityCtx, humanLabel);
+        if (ev)
+            return addEvidence(ev);
+        if (target.includes("/") || target.toLowerCase().endsWith(".md")) {
+            // リポジトリ内ファイルへの生のパス参照で、帳（写しの課題・資料・議事録）に当たらないもの。
+            // 元ツールのURLがまだ無い記録は、点にするが飛び先を付けない（#968 の書き換えを待つ）。
+            // 名前は最後の段から拡張子を外したもの（`.md` のようなファイルの語を出さない）
+            return addNode({ id: target, label: (0, evidence_names_1.pathFallbackLabel)(target), group: "silver" });
+        }
+        return addNode({ id: target, label: target, group: "phantom" });
     };
     const addRelationEdges = (fromId, relations) => {
         for (const r of relations) {
@@ -1777,17 +1977,15 @@ function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
     };
     const addReferenceEdges = (fromId, references) => {
         for (const ref of references) {
-            if (ref.url) {
-                // ref.label はマークダウンリンクの表示文字列（既に読める名前のことが多い。例: 資料の題名）。
-                // 生URLそのものがラベルのとき（本文の裸URL等）だけ、根拠の種類から読める名前を補う
-                const hasHumanLabel = ref.label !== ref.url;
-                const fallback = hasHumanLabel ? ref.label.slice(0, 60) : ref.label.replace(/^https?:\/\//, "").slice(0, 60);
-                const id = addEvidenceUrlNode(ref.url, fallback, hasHumanLabel);
-                edges.push({ from: fromId, to: id, rel: "reference" });
-            }
-            else {
-                edges.push({ from: fromId, to: classifyTarget(ref.label), rel: "reference" });
-            }
+            // 点の鍵は**書かれていた値**から決める（解決器の飛び先は blob の写しのこともあるので鍵にしない）。
+            // マークダウンリンクの表示文字列（人が付けた名前）は、帳の題名が無いときの名前に使う
+            // （`[名前](URL)` の名前は `identifyEvidence` が書かれていた値から拾う。解決器が付けた名前は
+            // 種類の既定のこともあるので、人の名前としては渡さない）
+            const raw = REF_RAW.get(ref);
+            if (raw !== undefined)
+                edges.push({ from: fromId, to: classifyTarget(raw), rel: "reference" });
+            else
+                edges.push({ from: fromId, to: classifyTarget(ref.url ?? ref.label, ref.url && ref.label !== ref.url ? ref.label : undefined), rel: "reference" });
         }
     };
     const addLinkEdges = (fromId, links) => {
@@ -2165,7 +2363,11 @@ async function build(opts) {
     const targetUrls = knowledgeRoot
         ? await buildTargetUrlMap(repoRoot, repo.baseUrl, repo.branch)
         : new Map();
-    const refs = createRefResolver({ repoRoot, targetUrls, repoBaseUrl: repo.baseUrl, branch: repo.branch });
+    // fleet-status.json は 1 回だけ読む（読み手が警告を出すので、2 回読むと警告が 2 行になる）。
+    // 名前の帳（チャンネル名）と、下の「データソースと自動化」で同じものを使う
+    const fleet = await readFleetSources(repoRoot);
+    const evidenceBook = knowledgeRoot ? await buildEvidenceBook(repoRoot, targetUrls, fleet.externalSources) : (0, evidence_names_1.emptyEvidenceBook)();
+    const refs = createRefResolver({ repoRoot, targetUrls, repoBaseUrl: repo.baseUrl, branch: repo.branch, book: evidenceBook });
     // AIからの更新提案。**レコードを組み立てる前に読む**——各レコードが自分の分を
     // takeProposals で引き取るので、後から読んでも載せる先が既に閉じている。
     // 同一プロセスで2回ビルドしても前回の値が残らないよう、毎回入れ替える
@@ -2310,10 +2512,9 @@ async function build(opts) {
         console.warn(`gold-proposals.json: レコードに突き合わない提案が ${unmatched.length} 件ありました（表示しません）: ` +
             unmatched.slice(0, 5).join(", ") + (unmatched.length > 5 ? " ほか" : ""));
     }
-    const graph = buildGraph(decisions, home, graphSections, targetUrls, repo.baseUrl);
+    const graph = buildGraph(decisions, home, graphSections, targetUrls, repo.baseUrl, evidenceBook);
     computeLayout(graph); // 各ノードに x/y を書き込む（クライアントはこれを初期位置に使いウォームアップ省略）
-    // データソースと自動化（fleet-status.json 由来）。無ければ undefined でセクション非表示。
-    const fleet = await readFleetSources(repoRoot);
+    // データソースと自動化（fleet-status.json 由来・上で 1 回だけ読んだもの）。無ければ undefined でセクション非表示。
     // すでにある会議（投入モーダルの「会議名」の選択肢）。intake の有無に関わらず載せる——
     // 出し分けは表示側の仕事で、ここで絞ると「投入の口を後から付けたら選択肢が空」になる
     const meetings = await collectMeetings(repoRoot);
@@ -2495,8 +2696,16 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch, ref
         ...(followupHuman ? { followupHuman: followupHuman } : {}),
     };
 }
+/**
+ * 解決した参照 → 書かれていた値（#968 tools 1）。つながり画面は点の鍵をこの値から決める
+ * （`site-data` に載せない——機械の語を画面の材料に増やさない）
+ */
+const REF_RAW = new WeakMap();
+/** リポジトリのパス 1 本だけの値（`会議/…/x.md`・`tmp/a.txt`）。カンマ・読点・括弧の注記を含むものは当てない */
+const REPO_PATH_ONLY_RE = /^[^\s,、（）()]+(?:[ _-][^,、（）()/]*)*\/[^,、（）()/]+\.[A-Za-z0-9]{1,5}$/;
 function createRefResolver(opts) {
     const { repoRoot, targetUrls, repoBaseUrl, branch } = opts;
+    const book = opts.book ?? (0, evidence_names_1.emptyEvidenceBook)();
     // **他の走査結果を流用しない。** 全md一覧（Decisions走査や、かつてのグラフ走査 `scanContent`）は
     // `.md` しか歩かず一部のディレクトリを除外するので、実在する `.txt`（Geminiメモ）や
     // `tmp/` 配下のファイルを「実在しない」と誤判定して**いま動いているリンクを消す**。
@@ -2520,8 +2729,15 @@ function createRefResolver(opts) {
         seen.set(relPath, ok);
         return ok;
     };
-    const resolve = (ref) => {
-        const trimmed = String(ref ?? "").trim();
+    /**
+     * 書かれていた値の読める名前（#968 tools 1）。帳の題名・会議の定例名と日付・種類の既定の名前。
+     * **飛び先は変えない**（ここは名前だけ）。根拠でない値・汎用の URL は `null`（今までどおりの名前）
+     */
+    const nameOf = (raw) => {
+        const ev = identifyEvidence(raw, { book, targetUrls, dropLink: (u) => u ?? undefined });
+        return ev && ev.kind !== "url" ? ev.label : null;
+    };
+    const resolveOne = (trimmed) => {
         if (!trimmed)
             return { label: trimmed, url: null };
         // 元ツールが無い根拠（engine #968 の将来の語彙）。リンクにせず、機械の語（urn:…）を出さない
@@ -2540,23 +2756,31 @@ function createRefResolver(opts) {
         if (/^https?:\/\//.test(trimmed)) {
             // 裸のURL（markdownリンクでラベルを添えていないもの）は、分かる種類なら読める名前にする
             // （#968 tools 1「URL → 読める名前」）。**url は変えない**（正規化で既存のリンクを壊さない）
-            const canon = (0, canonical_evidence_1.canonicalEvidence)(trimmed);
-            const label = canon && canon.kind !== "url" ? readableEvidenceLabel(canon.kind, canon.parentKey ?? canon.key, trimmed) : trimmed;
-            return { label, url: trimmed };
+            return { label: nameOf(trimmed) ?? trimmed, url: trimmed };
         }
         // 正本のURL（課題キー・material:・design:・minute:）。**ここが「ツールへ飛ぶ」の本体**
         const known = targetUrls.get(trimmed);
         if (known)
-            return { label: trimmed, url: known };
+            return { label: nameOf(trimmed) ?? trimmed, url: known };
         // inventory の無い案件（#727 K10）の design: / figma-comment: は、キーとノードから組む
         const figma = figmaUrlFromRef(trimmed);
         if (figma)
-            return { label: trimmed, url: figma };
+            return { label: nameOf(trimmed) ?? trimmed, url: figma };
+        // リポジトリのパス 1 本だけの値は、最後の段から拡張子を外した名前で出す（ファイルの語を出さない・#968 tools 1）。
+        // 文の中のパス・パスに注記が付いた複合形は、書かれたまま（どれを指すか画面では決められない）
+        const pathName = REPO_PATH_ONLY_RE.test(trimmed) ? (0, evidence_names_1.pathFallbackLabel)(trimmed) : trimmed;
         // 実在するファイルだけ blob URL にする
         if (repoBaseUrl && exists(trimmed)) {
-            return { label: trimmed, url: `${repoBaseUrl}/blob/${branch}/${encodePath(trimmed)}` };
+            return { label: nameOf(trimmed) ?? pathName, url: `${repoBaseUrl}/blob/${branch}/${encodePath(trimmed)}` };
         }
-        return { label: trimmed, url: null };
+        return { label: nameOf(trimmed) ?? pathName, url: null };
+    };
+    const resolve = (ref) => {
+        const trimmed = String(ref ?? "").trim();
+        const out = resolveOne(trimmed);
+        if (trimmed)
+            REF_RAW.set(out, trimmed);
+        return out;
     };
     return { resolve, exists };
 }

package/dist/engagement.js

@@ -50,7 +50,7 @@ exports.ENGAGEMENT_LEDGER_VERSION = 1;
 /** 半減期（日）。engine `weights.mjs` の `HALF_LIFE_DAYS`（正本 6-B「半減期 90 日固定」） */
 exports.HALF_LIFE_DAYS = 90;
 /**
- * 行為 1 件の重み。engine `weights.mjs` の `WEIGHTS` の写し（26 値・**表に無い `kind` は 0**）。
+ * 行為 1 件の重み。engine `weights.mjs` の `WEIGHTS` の写し（31 値・**表に無い `kind` は 0**）。
  *
  * 🔴 契約の表（fixture）は `message.posted` しか使っていないので、**ここの写し間違いは表では
  * 捕まらない**。重みの番人は `test/member-engagement-parity.test.mjs` の `[重み]` が持つ。
@@ -90,6 +90,14 @@ exports.WEIGHTS = Object.freeze({
     // 人が承認して push した記憶の訂正（cortex-engine #935）。同じコミットから `record.edited` も起きるので、
     // 数えると二重になる。0
     "correction.stated": 0,
+    // 添付の原本の行（cortex-engine #1046 便 1）。本文は元の名前だけで、記憶のどの材料にも入れない。0
+    "file.attached": 0,
+    // リアクションの状態の行（cortex-engine #1046 便 1c）。人の行為ではない（`actor` は unknown・読み手の入口で外す）ので 0
+    "reaction.updated": 0,
+    // Slack の参加・退出・トピックなどの知らせ（cortex-engine #1046 便 1c）。今までは `message.posted`（1.0）に混ざって関与を水増ししていた。発言ではないので 0
+    "member.joined": 0,
+    "member.left": 0,
+    "venue.updated": 0,
 });
 const DAY_MS = 86400000;
 const cmp = (a, b) => (a < b ? -1 : a > b ? 1 : 0);

package/dist/evidence-names.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * **根拠の読める名前の帳**（cortex-engine #968 tools 1 の続き・設計は #968 の状態コメント 2026-10-02）。
+ *
+ * つながり画面の点と、詳細画面の「参照」に出す名前を、URL や機械の ID（`minute:`・`material:`・
+ * `gfile:`・写しのファイル名）ではなく、人が呼ぶ名前（課題キー＋題名・資料の題名・会議の定例名と
+ * 日付・チャンネル名）にするための材料。
+ *
+ * 帳は**ビルドのたびに写し（課題管理・共有資料・デザイン）と `fleet-status.json` のチャンネルの一覧から組む**。写しを
+ * 片付けた案件では帳が薄くなるだけで、点は今までどおり種類の既定の名前（「Google ドライブの資料」等）で出る。
+ *
+ * 鍵は `canonicalEvidence` の `key`（コメントは親の鍵）。ID の根拠（課題キー・`material:` 等）も、
+ * 対応表で URL に引けるものは同じ鍵に寄せる——今の ID と新しい URL の根拠が混ざっても 1 つの点になる。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyEvidenceBook = void 0;
+exports.minuteFoldKey = minuteFoldKey;
+exports.minuteLabel = minuteLabel;
+exports.minuteRefOfPath = minuteRefOfPath;
+exports.slackChannelOfLabel = slackChannelOfLabel;
+exports.backlogTailOf = backlogTailOf;
+exports.idFallbackLabel = idFallbackLabel;
+exports.pathFallbackLabel = pathFallbackLabel;
+const emptyEvidenceBook = () => ({
+    names: new Map(),
+    pathRefs: new Map(),
+    slackUrlsByName: new Map(),
+    backlogTailRefs: new Map(),
+});
+exports.emptyEvidenceBook = emptyEvidenceBook;
+/** `minute:{定例名}:{YYYYMMDD}`（定例名は `Ph.1/全体定例` のようにフェーズの段を含むことがある） */
+const MINUTE_ID_RE = /^minute:(.+):(\d{8})$/;
+/** 定例名の最後の段（`Ph.1/全体定例` → `全体定例`）。画面の名前に使う */
+const lastSegment = (s) => s.split("/").filter(Boolean).pop() ?? s;
+/** フェーズの段（`Ph.1`・`Phase2`）。会議の置き場の上の段で、会議そのものを区別しない */
+const PHASE_SEGMENT_RE = /^ph(?:ase)?\.?\s*\d+$/i;
+/**
+ * `minute:` の ID を畳む鍵にする。**落とすのはフェーズの段だけ**（`Ph.1/全体定例` と `全体定例` を同じ会議に）。
+ * ほかの段（`顧客A/定例` と `顧客B/定例`）は別の会議なので残す——最後の段だけで畳むと別の会議が 1 点になる。
+ * 形が違えば `null`
+ */
+function minuteFoldKey(id) {
+    const m = id.match(MINUTE_ID_RE);
+    if (!m)
+        return null;
+    const segs = m[1].split("/").filter(Boolean);
+    const kept = segs.filter((seg, i) => i === segs.length - 1 || !PHASE_SEGMENT_RE.test(seg));
+    return `minute:${kept.join("/")}:${m[2]}`;
+}
+/** `minute:` の ID → 「全体定例 2026-06-04」。形が違えば `null` */
+function minuteLabel(id) {
+    const m = id.match(MINUTE_ID_RE);
+    if (!m)
+        return null;
+    const d = m[2];
+    return `${lastSegment(m[1])} ${d.slice(0, 4)}-${d.slice(4, 6)}-${d.slice(6, 8)}`;
+}
+/**
+ * 議事録の写しのパス（`会議/{…}/{定例名}/{YYYYMMDD}/{…}minutes{…}.md`）→ `minute:{定例名}:{YYYYMMDD}`。
+ * `buildTargetUrlMap` の `minute:` の組み方と同じ規約（定例名は日付の 1 つ上の段）
+ */
+function minuteRefOfPath(p) {
+    const parts = p.split("/");
+    if (parts.length < 4 || parts[0] !== "会議")
+        return null;
+    const file = parts[parts.length - 1];
+    const date = parts[parts.length - 2];
+    const meeting = parts[parts.length - 3];
+    if (!/minutes/i.test(file) || !/\.md$/i.test(file) || !/^\d{8}$/.test(date) || !meeting)
+        return null;
+    return `minute:${meeting}:${date}`;
+}
+/**
+ * チャットの根拠の、チャンネル名だけで書かれた形 → `名前`。取り込みが書くラベル `[slack] #名前 (N messages since …)` と、
+ * AI が書いた `slack:{名前}:{YYYYMMDD}`。形が違えば `null`（チャンネル ID の `slack:C…` は鍵なのでここでは扱わない）
+ */
+function slackChannelOfLabel(raw) {
+    const t = raw.trim();
+    const m = t.match(/^\[slack\]\s+#([^\s()]+)(?:\s+\(.*\))?$/i) ?? t.match(/^slack:#?([^:\s]+):\d{8}$/);
+    return m && !/^C[A-Z0-9]{6,}$/.test(m[1]) ? m[1] : null;
+}
+/** 課題管理の写しのパス → 区画から下（`issues/2026/x.md`）。写しの形でなければ `null` */
+function backlogTailOf(p) {
+    const m = p.match(/^課題管理\/(?:[^/]+\/)?((?:issues|documents|wiki)\/.+)$/);
+    return m ? m[1] : null;
+}
+/** ID の根拠の既定の名前（題名が引けないとき）。機械の接頭辞（`material:` 等）を外す */
+function idFallbackLabel(id) {
+    const m = id.match(/^(material|design|figma-comment):(.+)$/);
+    if (!m)
+        return id;
+    if (m[1] === "material")
+        return m[2];
+    return m[1] === "design" ? "Figma のデザイン" : "Figma のコメント";
+}
+/** 写しのパスの既定の名前: 最後の段から拡張子を外す（`.md` のようなファイルの語を出さない） */
+function pathFallbackLabel(p) {
+    const base = p.split("/").filter(Boolean).pop() ?? p;
+    return base.replace(/\.[A-Za-z0-9]{1,5}$/, "") || base;
+}

package/dist/rederivation.js

@@ -9,6 +9,7 @@ exports.parseLedger = parseLedger;
 exports.readRederivationLedgers = readRederivationLedgers;
 exports.parseInjectedNow = parseInjectedNow;
 exports.activityScore = activityScore;
+exports.withoutFollowupHeadingText = withoutFollowupHeadingText;
 exports.comparableContent = comparableContent;
 exports.sameRederivedContent = sameRederivedContent;
 exports.contentShaOf = contentShaOf;
@@ -368,14 +369,15 @@ const isFollowupBegin = (line) => FOLLOWUP_BEGIN_RE.test(String(line ?? "").repl
  * 開始の印の行（最初の 1 つ・行末の `\r` は無視）から、終了の印**だけ**の行までを（両端を含めて）消す。終了の印が
  * 無ければ本文の終わりまで消す。塊の前後の空行も除き、両側に本文が残れば空行 1 行でつなぐ。そのあと末尾の空行を落とす。塊の無い本文は触らない。
  */
-function withoutBlock(body, isBegin, endMarker) {
+function withoutBlock(body, isBegin, endMarker, { keepEnd = false } = {}) {
     const lines = body.split("\n");
     const start = lines.findIndex((line) => isBegin(line));
     if (start < 0)
         return body;
     // 行末の `\r` は見ない（CRLF の記録でも印の行として当てる。当てないと毎晩印が立つ）
     const endRel = lines.slice(start + 1).findIndex((line) => line.replace(/\r$/, "") === endMarker);
-    const end = endRel < 0 ? lines.length : start + 1 + endRel + 1;
+    // `keepEnd`: 終わりの行（次の節の見出し）は残す（見出しで区切る「その後」の節・#1094 便 1）
+    const end = endRel < 0 ? lines.length : start + 1 + endRel + (keepEnd ? 0 : 1);
     const isBlank = (line) => line.trim() === "";
     // 塊の前後の空行も一緒に除き、両側に本文が残れば空行 1 行でつなぐ（engine の書き手と同じ規則・#702 実装レビュー R1）
     const before = lines.slice(0, start);
@@ -413,7 +415,28 @@ function stripMemberDecisions(body) {
 function withoutFollowup(body) {
     return withoutBlock(body, isFollowupBegin, FOLLOWUP_END);
 }
-function comparableContent(raw) {
+/** 「その後」の節の見出し（印を外した後の形・#1094 便 1）。🔴 engine の `FOLLOWUP_HEADING_RE` の写し */
+const FOLLOWUP_HEADING_RE = /^##\s+その後\s*$/;
+/**
+ * 印の無い「その後」の節（`## その後` の行から、次の `## ` の行か本文の終わりまで）を除く（#1094 便 1・#551 設計 D2）。
+ * 規則は塊と同じ 1 本（`withoutBlock`・次の節の見出しは残す）。印の塊がある本文は塊の規則で先に除くので、
+ * ここは印を外した後の本文だけに効く。
+ *
+ * 🔴 **engine の写し（`scripts/rederive/content-sha.mjs` の `withoutFollowupHeadingText`）と 1 バイト一致・
+ * 番人は `test/followup-block-sha.test.mjs` の `[markerFree]`**（engine の `contentShaOf(raw, { markerFree: true })` を
+ * 実際に呼んで焼いた表 `test/fixtures/marker-free-sha-contract.json`）。変えたら両方を変えて表を焼き直す。
+ */
+function withoutFollowupHeadingText(body) {
+    const text = String(body ?? "");
+    const lines = text.split("\n");
+    const start = lines.findIndex((line) => FOLLOWUP_HEADING_RE.test(line.replace(/\r$/, "")));
+    if (start < 0)
+        return text;
+    const nextRel = lines.slice(start + 1).findIndex((line) => /^##\s/.test(line));
+    const endLine = nextRel < 0 ? null : lines[start + 1 + nextRel].replace(/\r$/, "");
+    return withoutBlock(text, (line) => line === lines[start], endLine === null ? "\u0000" : endLine, { keepEnd: endLine !== null });
+}
+function comparableContent(raw, { markerFree = false } = {}) {
     let data = {};
     let content = String(raw ?? "");
     try {
@@ -428,7 +451,9 @@ function comparableContent(raw) {
     return {
         description: normalizeForCompare(String(data.description ?? "")),
         // engine と同じ順（目録の塊 → その後の塊）
-        body: normalizeForCompare(withoutFollowup(stripMemberDecisions(content))),
+        body: normalizeForCompare(markerFree
+            ? withoutFollowupHeadingText(withoutFollowup(stripMemberDecisions(content)))
+            : withoutFollowup(stripMemberDecisions(content))),
     };
 }
 /** 2 つの版で「説明文と本文」が同じか（frontmatter の他の欄の差は見ない） */
@@ -448,8 +473,8 @@ function sameRederivedContent(a, b) {
  * engine の写し: `cortex-engine/scripts/rederive/content-sha.mjs`・一致の番人:
  * `cortex-engine/test/rederive-history.test.mjs` の #546 の節（ここを変えたら engine の `VIEWER_SHA` を計算し直す）
  */
-function contentShaOf(raw) {
-    const c = comparableContent(raw);
+function contentShaOf(raw, options = {}) {
+    const c = comparableContent(raw, options);
     return node_crypto_1.default.createHash("sha256").update(c.description + "\u0000" + c.body, "utf8").digest("hex");
 }
 /**

package/dist/render.js

@@ -4554,7 +4554,7 @@ const TUT_MEMBER_PROMPT = [
 ].join("\n");
 const TUT_BACKLOG_PROMPT = [
     "Backlogの課題に、わたしの名義でコメントを1件投稿してください。Backlogの画面を開かずにAIから記票する練習です。",
-    "課題を取れる道具（Backlog のコネクタ）を道具の検索で探してください。同じ働きの道具が2つ以上あれば、課題管理/issues-config.json の targets の domain と同じスペースを読むものを選びます。",
+    "課題を取れる道具（Backlog のコネクタ）を道具の検索で探してください。同じ働きの道具が2つ以上あれば、Cortex/sources.json の backlog の接続の domain（このファイルがまだ無いプロジェクトは 課題管理/issues-config.json の targets の domain）と同じスペースを読むものを選びます。",
     "課題はその道具で一覧して、どの課題に何を書くかをわたしに質問してください（課題管理/<プロジェクトキー>/issues/ に写しがあれば手がかりにしてかまいません）。",
     "",
     "投稿はその道具で行います（あなた本人の名義）。Backlog上の名義を先に伝えてください。",
@@ -4575,7 +4575,7 @@ const TUT_DESIGN_PROMPT = [
 const TUT_SLACK_PROMPT = [
     "Cortex のチュートリアルを完了したことを、このプロジェクトの Slack チャンネルに投稿してください。最後のステップです。",
     "",
-    "1. チャット/channels.json を読んで投稿先のチャンネルを選ぶ（複数あれば description を見て判断し、迷ったらわたしに聞く）",
+    "1. Cortex/sources.json の slack の接続の channels（このファイルがまだ無いプロジェクトは チャット/channels.json）を読んで投稿先のチャンネルを選ぶ（複数あれば description を見て判断し、迷ったらわたしに聞く）",
     "2. 次の雛形で本文を作る（{名前} は Cortex/Members/records/ にあるわたしのレコードの表記に合わせる）",
     "",
     "🎉 {名前} さんが Cortex のチュートリアルを完了しました",
@@ -18871,7 +18871,7 @@ ${calendarAddUrl.toString()}
     // 置いていたため、能力モーダルの上に2枚目が重なり、Escape が下の1枚だけを
     // 閉じて上が残った。isModalOpen も app しか見ないので、開いている間の
     // ライブ差し替えの見送りも効いていなかった
-    var mk = makeModal(isT ? "会議の文字起こしを追加" : "共有資料を追加", false);
+    var mk = makeModal("会議の文字起こしを追加", false);
     var overlay = mk.overlay;
     var modal = mk.modal;
     // 🔴 **資料の案内はカードだけでは届かない**（#663・設計レビュー🔴2）。makeModal は
@@ -18892,7 +18892,7 @@ ${calendarAddUrl.toString()}
     var allowedExt = isT
       ? { txt: 1, md: 1, docx: 1, doc: 1, rtf: 1, pdf: 1, vtt: 1, srt: 1 }
       : { pdf: 1, docx: 1, doc: 1, pptx: 1, ppt: 1, xlsx: 1, xls: 1, csv: 1, txt: 1, md: 1, rtf: 1, png: 1, jpg: 1, jpeg: 1, gif: 1, webp: 1, svg: 1, bmp: 1, heic: 1, tiff: 1 };
-    var allowedLabel = isT ? "テキスト・Word・PDF・字幕(.vtt/.srt)" : "PDF・Word・PowerPoint・Excel・テキスト・画像";
+    var allowedLabel = "テキスト・Word・PDF・字幕(.vtt/.srt)";
     function extOf(name) { var m = String(name).toLowerCase().match(/\.([a-z0-9]+)$/); return m ? m[1] : ""; }
     var fileInput = el("input", { type: "file", multiple: "multiple", class: "modal-file-hidden" });
     var fileListEl = el("div", { class: "dropzone-files" });
@@ -19209,7 +19209,7 @@ ${calendarAddUrl.toString()}
       status.textContent = "";
       status.appendChild(el("div", { class: "modal-ok", text: allDup
         ? "✓ 送信しました。保存されました（この日付には既に議事録があるため、議事録の自動生成は行われません）"
-        : "✓ 送信しました。数分後に" + (isT ? "議事録が自動生成され" : "内容がMarkdownに変換されて") + "反映されます。" }));
+        : "✓ 送信しました。数分後に議事録が自動生成され反映されます。" }));
       var paths = (sub.j && sub.j.committed) || [];
       if (paths.length && sub.j.repo) {
         var br = SITE.branch || "main";
@@ -20343,12 +20343,15 @@ ${calendarAddUrl.toString()}
     reference:    { color: "#d1d5db", label: "参照",   kind: "evidence" },
     source:       { color: "#d1d5db", label: "出典",   kind: "evidence" },
     link:         { color: "#e2e8f0", label: "リンク", kind: "evidence" },
+    // 話題の線（決定・ルール・関係者 → 用語・engine #551 の about）。名前の一致で機械が付けた手がかりなので、
+    // 根拠の線と同じく細く薄い「ゆるいつながり」として描き、凡例は日本語の 1 行（栓 about_relations の on の条件）
+    about:        { color: "#ddd6fe", label: "話題",   kind: "topic" },
   };
   var WEAK_RELS = {};
   var REL_COLOR = {};
   Object.keys(REL_META).forEach(function (r) {
     REL_COLOR[r] = REL_META[r].color;
-    if (REL_META[r].kind === "evidence") WEAK_RELS[r] = true;
+    if (REL_META[r].kind === "evidence" || REL_META[r].kind === "topic") WEAK_RELS[r] = true;
   });
   var graphState = { showWeak: true, q: "" };
 
@@ -20381,7 +20384,7 @@ ${calendarAddUrl.toString()}
     });
 
     // 線（関係）の色凡例。グラフ内の有無に関わらず全種別を、Goldどうし／根拠の2群で表示する
-    [["gold", "線（Goldどうし）:"], ["evidence", "線（根拠）:"]].forEach(function (pair) {
+    [["gold", "線（Goldどうし）:"], ["evidence", "線（根拠）:"], ["topic", "線（話題）:"]].forEach(function (pair) {
       var kind = pair[0], heading = pair[1];
       var keys = Object.keys(REL_META).filter(function (r) { return REL_META[r].kind === kind; });
       if (!keys.length) return;
@@ -20398,7 +20401,7 @@ ${calendarAddUrl.toString()}
     cb.checked = graphState.showWeak;
     cb.addEventListener("change", function () { graphState.showWeak = cb.checked; renderList(); });
     toggle.appendChild(cb);
-    toggle.appendChild(document.createTextNode("ゆるいつながり（参照・本文リンク）も表示"));
+    toggle.appendChild(document.createTextNode("ゆるいつながり（参照・本文リンク・話題）も表示"));
     legend.appendChild(toggle);
     app.appendChild(legend);
 
@@ -20748,6 +20751,7 @@ ${calendarAddUrl.toString()}
         based_on: "rgba(125,165,255,0.85)", derived_from: "rgba(94,234,212,0.75)",
         relates_to: "rgba(148,163,184,0.6)", supersedes: "rgba(248,113,113,0.9)",
         reference: "rgba(180,196,230,0.32)", source: "rgba(180,196,230,0.32)", link: "rgba(180,196,230,0.22)",
+        about: "rgba(196,181,253,0.22)",
       };
       edges.forEach(function (e) {
         // ホバー中: リネージに入った辺だけ、波の順に「order の低い側→高い側」へ伸びながら金色に。
@@ -21055,6 +21059,7 @@ ${calendarAddUrl.toString()}
   var REL_LABEL = {
     based_on: "根拠", derived_from: "由来", relates_to: "関連",
     supersedes: "置換", superseded_by: "置換先", reference: "参照", source: "出典", link: "リンク",
+    about: "話題",
   };
   var explorerState = { folder: null, path: [], q: "", sx: 0, autoRight: false };
   // 索引もグラフ本体と同じ材料（削除済みを除いたもの）から作る。別々に間引くと、
@@ -21067,7 +21072,7 @@ ${calendarAddUrl.toString()}
     (adjDir[e.from] = adjDir[e.from] || []).push({ id: e.to, rel: e.rel, dir: "out" });
     (adjDir[e.to] = adjDir[e.to] || []).push({ id: e.from, rel: e.rel, dir: "in" });
   });
-  var REL_ORDER = ["supersedes", "based_on", "derived_from", "relates_to", "source", "reference", "link"];
+  var REL_ORDER = ["supersedes", "based_on", "derived_from", "relates_to", "source", "reference", "link", "about"];
 
   function recordText(rec) {
     if (!rec) return "";
@@ -21289,8 +21294,10 @@ ${calendarAddUrl.toString()}
           path.setAttribute("d", "M " + x1 + " " + y1 + " C " + mx + " " + y1 + ", " + mx + " " + y2 + ", " + x2 + " " + y2);
           path.setAttribute("fill", "none");
           path.setAttribute("stroke", REL_COLOR[rows[j].getAttribute("data-rel")] || "#cbd5e1");
-          path.setAttribute("stroke-width", "1.5");
-          path.setAttribute("opacity", "0.85");
+          // 話題の線は細く薄く（名前の一致の手がかり・根拠の線より弱い）
+          var weakLine = rows[j].getAttribute("data-rel") === "about";
+          path.setAttribute("stroke-width", weakLine ? "1" : "1.5");
+          path.setAttribute("opacity", weakLine ? "0.5" : "0.85");
           lines.appendChild(path);
         }
       }

package/package.json

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