@takagaki/cortex-decisions-viewer 0.12.145 → 0.12.147

package/dist/build.js

@@ -60,6 +60,7 @@ exports.decidedByOf = decidedByOf;
 exports.isRelatedUrl = isRelatedUrl;
 exports.relatedMaterialsRead = relatedMaterialsRead;
 exports.relatedMaterialsView = relatedMaterialsView;
+exports.attachRuleReferences = attachRuleReferences;
 exports.attachRelatedMaterials = attachRelatedMaterials;
 exports.createRefResolver = createRefResolver;
 const node_crypto_1 = require("node:crypto");
@@ -126,6 +127,27 @@ const DEFAULT_EXCLUDE = ["README.md", "template.md"];
  * `supersedes` の写しで、描くと同じ置き換えが逆向きにもう 1 本出る。frontmatter のパネルには今までどおり出る
  */
 exports.MIRROR_RELS = new Set(["superseded_by"]);
+/**
+ * ストーリーの名前のリンクの材料（`story.screen-name-links`）。関係者・用語・ルールの記録ごとに、表示名と別名・同義語を集める。
+ * 画面に載る記録（`sections` に残った物）だけなので、取り下げ・削除された記録の id は表に無く、リンクにならない。
+ * 関係者の題は姓名の間に空白があることがあるので、空白を除いた形も名前に足す
+ */
+function storyNameSources(sections) {
+    const out = new Map();
+    const list = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === "string") : []);
+    for (const sec of sections) {
+        for (const r of sec.records) {
+            const kind = r.id.split(":")[0];
+            if (kind !== "member" && kind !== "term" && kind !== "rule")
+                continue;
+            const names = [r.title, ...list(r.fm.aliases), ...list(r.fm.synonyms)];
+            if (kind === "member")
+                names.push(r.title.replace(/\s+/g, ""));
+            out.set(r.id, { id: r.id, names });
+        }
+    }
+    return out;
+}
 /** frontmatterのrelationsを安全に正規化する */
 function toRelations(value) {
     if (!Array.isArray(value))
@@ -2446,6 +2468,8 @@ async function buildSite(opts, views) {
                 records = records.filter((r) => !r.relations.some((x) => x.rel === "retracted_by"));
             // 関連の資料（cortex-engine #1094 F8）。ルール・用語だけ・欄の無い記録には何も付かない
             attachRelatedMaterials(e.name, records, refs);
+            // ルールの参照（rule.card）。決定と同じ出典リンクにする
+            attachRuleReferences(e.name, records, refs);
             // 用語集の並び（活性度・強さ）。**帳簿を持たない案件では並びもそのまま**
             const rederived = orderRecordsByLedgers(records, recordsDir, rederive, opts.generatedAt);
             // 関係者だけ、関与の多い順（engine の目次と同じ `order`・便 14b）。用語集の並び
@@ -2514,7 +2538,9 @@ async function buildSite(opts, views) {
     // ストーリーの日々の動き（#901 V2-5）。帳簿で on の日のファイルが無ければ null（キーごと出さない）
     const story = await (0, story_1.readStory)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null, 
     // 動きのない日を埋める終点＝ビルドの時刻の日本時間の日付（時計を注入できる）
-    storyToday, ledgerDir);
+    storyToday, ledgerDir, 
+    // 名前のリンク（story.screen-name-links）: 日の relations の関係者・用語・ルールを、画面にある記録の表示名・別名・同義語で本文に当てる
+    (targets) => (0, story_1.storyNameLinks)(targets, storyNameSources(sections)));
     // 週・月のあらすじ（#901）。週・月のファイルが無ければ null（キーごと出さない＝今までと同じ画面）
     const storyDigest = await (0, story_1.readStoryDigest)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null, storyToday, ledgerDir);
     // 案件アイコン（#348）。Cortex構成でなければ undefined（旧レイアウトには置き場が無い）
@@ -2781,6 +2807,16 @@ function relatedMaterialsView(fm, refs) {
 }
 /** 関連の資料を持てる汎用の区画（関係者・ストーリーの日・Home の欄は拾わない） */
 exports.RELATED_MATERIALS_SECTIONS = new Set(["Rules", "Glossary"]);
+/** ルールの `references` を決定と同じ出典リンクにして載せる（rule.card）。ルールだけ・欄の無い記録にはキーごと付けない */
+function attachRuleReferences(section, records, refs) {
+    if (section !== "Rules")
+        return;
+    for (const r of records) {
+        const list = toStringArray(r.fm.references).map((x) => refs.resolve(x));
+        if (list.length)
+            r.references = list;
+    }
+}
 /** 区画の記録に関連の資料を載せる（ルール・用語だけ・欄の無い記録にはキーごと付けない） */
 function attachRelatedMaterials(section, records, refs) {
     if (!exports.RELATED_MATERIALS_SECTIONS.has(section))

package/dist/render.js

@@ -89,6 +89,7 @@ const node_crypto_1 = require("node:crypto");
 const google_chat_guide_images_1 = require("./google-chat-guide-images");
 const meet_guide_images_1 = require("./meet-guide-images");
 const figma_guide_images_1 = require("./figma-guide-images");
+const story_1 = require("./story");
 // 「人が確認したか／機械が触ってよいか」の口（#699 F2b）。正本は engine の confirmed.mjs・判定は流し込むだけ
 const confirmed_1 = require("./confirmed");
 // フロントマターの「つながっている ID」の欄名（#686）。**綴りはここ 1 本**——読む側（画面）も
@@ -6537,6 +6538,8 @@ ${calendarAddUrl.toString()}
     try { return elx ? JSON.parse(elx.textContent) : null; } catch (e) { return null; }
   })();
 
+  // ストーリーの名前のリンクの切り分け（story.ts の純関数をそのまま埋め込む）
+${story_1.splitByNameLinks.toString()}
   // ---------- インデックス構築 ----------
   var byId = {};
   SITE.decisions.forEach(function (d) { byId[d.id] = d; d._kind = "decision"; });
@@ -6565,6 +6568,38 @@ ${calendarAddUrl.toString()}
       return '<a class="wikilink" data-go="' + attr + '">' + disp + "</a>";
     });
   }
+  // ストーリーの本文の名前を記録へのリンクにする（story.screen-name-links）。
+  // 🔴 本文の DOM を作った後に**テキストノードだけ**を走査する（HTML の文字列は触らない＝タグ・属性は壊れない）。
+  // a・code・pre・既存のウィキリンクの中は当てない。飛び先（byId）が無い id は当てない（素の文字のまま＝空リンク・行き止まりを出さない）。
+  // 名前は textContent で入れる（表示名を HTML として混ぜない）
+  function linkifyStoryNames(root, links) {
+    if (!root || !links || !links.length) return;
+    var usable = links.filter(function (l) { return l && l.name && l.id && byId[l.id] && !byId[l.id].deleted; });
+    if (!usable.length) return;
+    var skip = { A: 1, CODE: 1, PRE: 1, SCRIPT: 1, STYLE: 1 };
+    var nodes = [];
+    var walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+      acceptNode: function (n) {
+        for (var p = n.parentNode; p && p !== root; p = p.parentNode) { if (skip[p.tagName]) return NodeFilter.FILTER_REJECT; }
+        return NodeFilter.FILTER_ACCEPT;
+      }
+    });
+    while (walker.nextNode()) nodes.push(walker.currentNode);
+    nodes.forEach(function (n) {
+      var parts = splitByNameLinks(n.nodeValue, usable);
+      if (parts.length === 1 && !parts[0].id) return;
+      var frag = document.createDocumentFragment();
+      parts.forEach(function (part) {
+        if (!part.id) { frag.appendChild(document.createTextNode(part.text)); return; }
+        var a = document.createElement("a");
+        a.className = "wikilink";
+        a.setAttribute("data-go", part.id);
+        a.textContent = part.text;
+        frag.appendChild(a);
+      });
+      n.parentNode.replaceChild(frag, n);
+    });
+  }
   // 本文は bodies/ 以下へ外出しされ詳細表示時に fetch されるため、linkify は loadBody 側で適用する
   // （ここで inline bodyHtml に適用すると検索テキストにHTMLが混ざるため適用しない）。
 
@@ -6984,6 +7019,24 @@ ${calendarAddUrl.toString()}
     box.appendChild(ul);
     return box;
   }
+  /**
+   * 詳細の節「参照」（根拠の出典リンク）。決定とルールが同じ出し方（rule.card・出典リンク）。
+   * 参照の無い記録では null（要素を作らない）。リンクは http(s) だけ（ビルドが解決済みでも画面で二重に見る）
+   */
+  function referencesSection(r) {
+    if (!r || !r.references || !r.references.length) return null;
+    var box = el("div", { class: "refs-section" });
+    box.appendChild(el("div", { class: "section-label", text: "参照" }));
+    var ul = el("ul", { class: "refs" });
+    r.references.forEach(function (ref) {
+      var li = el("li");
+      if (ref.url && /^https?:\\/\\//i.test(ref.url)) li.appendChild(el("a", { href: ref.url, target: "_blank", rel: "noopener", text: ref.label }));
+      else li.textContent = ref.label;
+      ul.appendChild(li);
+    });
+    box.appendChild(ul);
+    return box;
+  }
   /** 候補の帯（症状）。行の札は「候補」とだけ言い、理由はこの帯 1 行に寄せる（繰り返さない） */
   var SUPERSEDE_CANDIDATE_NOTE = "前の決定は人が直しているため、置き換えは候補です";
   /** 決定 1 件の行。SITE にあれば題名で詳細へのリンク、無ければ ID だけ */
@@ -7013,6 +7066,21 @@ ${calendarAddUrl.toString()}
     for (var i = 0; i < by.length; i++) if (by[i].id === d.id) return !by[i].confirmed;
     return false;
   }
+  /**
+   * 一覧のカードの「→ 変更先」（decision.show-superseded）。置き換えられた決定の行に、一番新しい置き換え先の題名を 1 行で添える。
+   * 置き換え先が複数なら「ほか N 件」。置き換えられていない決定では null（行を作らない）。
+   * 札（置き換え済み・最新の生成）は出さない（common.screen-no-state-label）。題名は textContent で入れる
+   */
+  function supersededToLine(d) {
+    var by = (d && d.supersededBy && d.supersededBy.by) || [];
+    if (!by.length) return null;
+    // 画面で削除済みの置き換え先は題名を出さない（一覧から外れた決定を指さない）。見つからなければ ID の文字
+    var shown = by.filter(function (b) { var n = byId[b.id]; return !(n && n.deleted); });
+    var first = shown.length ? shown[0] : by[0];
+    var next = byId[first.id];
+    var name = next && next._kind === "decision" && !next.deleted ? humanTitle(next.title) : first.id;
+    return el("p", { class: "card-superseded-to", text: "→ 変更先: " + name + (by.length > 1 ? " ほか " + (by.length - 1) + " 件" : "") });
+  }
   /** 詳細の節「置き換え先の決定」「置き換えた決定」。どちらも無ければ null（要素を作らない） */
   function supersedeSection(d) {
     var by = (d && d.supersededBy && d.supersededBy.by) || [];
@@ -8659,7 +8727,7 @@ ${calendarAddUrl.toString()}
       }
       list.appendChild(el("section", { class: "story-card" }, [
         el("h3", { class: "story-card-heading", text: d.heading || d.date }),
-        d.bodyHtml ? el("div", { class: "body", html: d.bodyHtml }) : null,
+        d.bodyHtml ? (function () { var b = el("div", { class: "body", html: d.bodyHtml }); linkifyStoryNames(b, d.links); return b; })() : null,
         // その日のファイルを GitHub で開く（表示の文字にファイル名を出さない）。URL が無い案件は出さない
         storyEditRow(STORY_DAYS_BASE + d.date.slice(0, 7) + "/" + d.date + ".md", d.editUrl),
       ]));
@@ -19721,6 +19789,7 @@ ${calendarAddUrl.toString()}
       // 消したレコードは一覧でも取り消し線（次のビルドまで一覧には残る）
       var card = el("div", { class: "card", title: d.id, "data-record-id": d.id }, head.concat([
         d.summary ? el("p", { class: "card-summary", text: d.summary }) : null,
+        supersededToLine(d),
       ]));
       card.addEventListener("click", function () { go(d.id); });
       wrap.appendChild(card);
@@ -20591,6 +20660,10 @@ ${calendarAddUrl.toString()}
     app.appendChild(genBody);
     loadBody(r, genBody);
 
+    // 参照（rule.card）。ルールだけ。決定の詳細と同じ「参照」の節（ビルドが解決した出典リンク）
+    var refs2 = referencesSection(r);
+    if (refs2) app.appendChild(refs2);
+
     // 関連の資料（#1094 F8）。本文の後。ルール・用語にしか載らない
     var relm2 = relatedMaterialsSection(r);
     if (relm2) app.appendChild(relm2);
@@ -21544,17 +21617,8 @@ ${calendarAddUrl.toString()}
     app.appendChild(decBody);
     loadBody(d, decBody);
 
-    if (d.references && d.references.length) {
-      app.appendChild(el("div", { class: "section-label", text: "参照" }));
-      var ul = el("ul", { class: "refs" });
-      d.references.forEach(function (r) {
-        var li = el("li");
-        if (r.url) li.appendChild(el("a", { href: r.url, target: "_blank", rel: "noopener", text: r.label }));
-        else li.textContent = r.label;
-        ul.appendChild(li);
-      });
-      app.appendChild(ul);
-    }
+    var refsBox = referencesSection(d);
+    if (refsBox) app.appendChild(refsBox);
 
     // 関連の資料（#1094 F8）。「参照」（根拠）の後・置き換えの前。根拠と混ぜない
     var relm = relatedMaterialsSection(d);

package/dist/story.js

@@ -3,13 +3,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STORY_DIGEST_EMPTY_LINE = exports.STORY_MAX_MONTHS = exports.STORY_MAX_WEEKS = exports.STORY_MONTHS_DIR = exports.STORY_WEEKS_DIR = exports.STORY_MAX_FILE_BYTES = exports.STORY_COLLAPSE_QUIET_DAYS = exports.STORY_EMPTY_LINE = exports.STORY_MAX_DAYS = exports.STORY_DAYS_DIR = exports.STORY_LEDGER_FILE = void 0;
+exports.STORY_DIGEST_EMPTY_LINE = exports.STORY_MAX_MONTHS = exports.STORY_MAX_WEEKS = exports.STORY_MONTHS_DIR = exports.STORY_WEEKS_DIR = exports.STORY_LINK_MIN_NAME = exports.STORY_LINK_KINDS = exports.STORY_MAX_FILE_BYTES = exports.STORY_COLLAPSE_QUIET_DAYS = exports.STORY_EMPTY_LINE = exports.STORY_MAX_DAYS = exports.STORY_DAYS_DIR = exports.STORY_LEDGER_FILE = void 0;
 exports.parseStoryLedger = parseStoryLedger;
 exports.partialDaysOf = partialDaysOf;
 exports.onDaysOf = onDaysOf;
 exports.successDaysOf = successDaysOf;
 exports.nightResultOf = nightResultOf;
 exports.splitFrontmatter = splitFrontmatter;
+exports.dayRelationTargets = dayRelationTargets;
+exports.storyNameLinks = storyNameLinks;
+exports.splitByNameLinks = splitByNameLinks;
 exports.storyDayMarkdown = storyDayMarkdown;
 exports.isEngineQuietDay = isEngineQuietDay;
 exports.todayJst = todayJst;
@@ -162,6 +165,88 @@ function splitFrontmatter(content) {
         return { frontmatter: null, body: text };
     return { frontmatter: m[1] ?? "", body: text.slice(m[0].length) };
 }
+// ---------------------------------------------------------------------------
+// 名前のリンク（`story.screen-name-links`）。日のページの `relations` で当てる（本文からは名前を拾わない）
+// ---------------------------------------------------------------------------
+/** 名前のリンクにする記録の種類（id の頭）。同じ名前が複数の種類にあるときはこの順で勝つ（関係者 → 用語 → ルール・設計 A4） */
+exports.STORY_LINK_KINDS = ["member", "term", "rule"];
+/** 名前の最小の長さ（1 文字の名前は本文のあちこちに当たるので当てない） */
+exports.STORY_LINK_MIN_NAME = 2;
+/**
+ * 日のページの frontmatter から `relations` の `target` を取る（純関数・YAML としては読まない）。
+ * `- { rel: relates_to, target: "term:設計" }` も、`- rel:` と `target:` を行で分けた形も読む。壊れた行は飛ばす
+ */
+function dayRelationTargets(frontmatter) {
+    if (!frontmatter)
+        return [];
+    const out = [];
+    for (const line of frontmatter.split("\n")) {
+        const m = line.match(/\btarget\s*:\s*(?:"([^"]*)"|'([^']*)'|([^\s,}"']+))/);
+        const t = (m ? (m[1] ?? m[2] ?? m[3] ?? "") : "").trim();
+        if (t && !out.includes(t))
+            out.push(t);
+    }
+    return out;
+}
+/**
+ * その日の `relations` の target から、名前のリンクの表を作る（純関数）。
+ *
+ * - 材料（`sources`）に **無い id は捨てる**（廃止・削除された記録、実在しない id、記録ではない id＝決定など）。飛び先の無い線は出さない
+ * - 同じ名前が複数の記録にあれば、関係者 → 用語 → ルールの順で勝つ。同じ種類なら先に出た target
+ * - 2 文字未満の名前は当てない。返りは名前の長い順（同じ長さは文字の順）。1 件も無ければ空
+ */
+function storyNameLinks(targets, sources) {
+    const kindOf = (id) => exports.STORY_LINK_KINDS.findIndex((k) => id.startsWith(`${k}:`));
+    const ids = [...new Set(targets)].filter((t) => kindOf(t) >= 0 && sources.has(t));
+    ids.sort((a, b) => kindOf(a) - kindOf(b));
+    const byName = new Map();
+    for (const id of ids) {
+        for (const raw of sources.get(id).names) {
+            const name = String(raw ?? "").trim();
+            if (name.length >= exports.STORY_LINK_MIN_NAME && !byName.has(name))
+                byName.set(name, id);
+        }
+    }
+    return [...byName.entries()]
+        .map(([name, id]) => ({ name, id }))
+        .sort((a, b) => b.name.length - a.name.length || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}
+/**
+ * 画面側の純関数: 1 つの文字列を、名前に当たる所とそれ以外に分ける。**画面の JS にそのまま埋め込む**ので、このファイルの外の物を使わない。
+ * 長い名前を先に当てる（`links` は長い順で渡す）。当たらなければ 1 件（元の文字）を返す
+ */
+function splitByNameLinks(text, links) {
+    if (!text || !links || !links.length)
+        return [{ text: text }];
+    const byName = {};
+    const names = [];
+    links.forEach((l) => {
+        if (l && l.name && l.id && !Object.prototype.hasOwnProperty.call(byName, l.name)) {
+            byName[l.name] = l.id;
+            names.push(l.name);
+        }
+    });
+    names.sort((a, b) => b.length - a.length);
+    // 英数字で始まる・終わる名前は、前後が英数字のときは当てない（`AI` が `MAIN` の途中に当たらない）。日本語の名前は途中でも当てる
+    const word = (n) => n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const re = new RegExp(names.map((n) => (/^[A-Za-z0-9_]/.test(n) ? "(?<![A-Za-z0-9_])" : "") + word(n) + (/[A-Za-z0-9_]$/.test(n) ? "(?![A-Za-z0-9_])" : "")).join("|"), "g");
+    const out = [];
+    let last = 0;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        if (!m[0]) {
+            re.lastIndex++;
+            continue;
+        }
+        if (m.index > last)
+            out.push({ text: text.slice(last, m.index) });
+        out.push({ text: m[0], id: byName[m[0]] });
+        last = m.index + m[0].length;
+    }
+    if (last < text.length)
+        out.push({ text: text.slice(last) });
+    return out.length ? out : [{ text: text }];
+}
 /** 曜日つきの見出し（`# 2026-09-24（木）`）の文字。無ければ日付だけ */
 function headingOf(lines, day) {
     for (const l of lines) {
@@ -372,7 +457,9 @@ editUrlOf = () => null,
 // 日本時間の今日（テストは時計を注入する）
 today = todayJst(), 
 // 帳簿の置き場（既定は `<repoRoot>/.cortex`）
-ledgerDir) {
+ledgerDir, 
+// 日の `relations` の target から名前のリンクの表を作る口（build が記録の表を握って渡す。無ければリンクは付けない）
+linksOf = () => []) {
     const ledger = await loadStoryLedger(repoRoot, true, ledgerDir);
     if (!ledger)
         return null;
@@ -432,7 +519,12 @@ ledgerDir) {
             continue;
         const { heading, markdown } = storyDayMarkdown(raw, f.day);
         const editUrl = editUrlOf(f.rel);
-        out.push({ date: f.day, heading: heading, bodyHtml: await renderMarkdown(markdown), ...(editUrl ? { editUrl: editUrl } : {}) });
+        const links = linksOf(dayRelationTargets(splitFrontmatter(raw).frontmatter));
+        out.push({
+            date: f.day, heading: heading, bodyHtml: await renderMarkdown(markdown),
+            ...(editUrl ? { editUrl: editUrl } : {}),
+            ...(links.length ? { links: links } : {}),
+        });
     }
     // 一番古い「動きのある日」から今日まで、日付の抜けを動きのない日の行で埋める。動きのある日が 1 つも無ければ出さない
     // 抜けの日は、帳簿の「成功した日」（行があり・on で・途中まででない日）なら動きなし、そうでなければ更新の失敗として出す

package/package.json

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