@takagaki/cortex-decisions-viewer 0.12.133 → 0.12.134

package/dist/build.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DECISION_FIRMNESS = exports.PROJECT_ICON_EXTS = exports.MIRROR_RELS = void 0;
+exports.RELATED_MATERIALS_SECTIONS = exports.RELATED_URL_MAX = exports.RELATED_MATERIALS_FIELD = exports.DECISION_FIRMNESS = exports.PROJECT_ICON_EXTS = exports.MIRROR_RELS = void 0;
 exports.sanitizeBody = sanitizeBody;
 exports.findProjectIcon = findProjectIcon;
 exports.readFleetSources = readFleetSources;
@@ -60,6 +60,10 @@ exports.build = build;
 exports.decisionFirmnessOf = decisionFirmnessOf;
 exports.decisionTopicOf = decisionTopicOf;
 exports.decidedByOf = decidedByOf;
+exports.isRelatedUrl = isRelatedUrl;
+exports.relatedMaterialsRead = relatedMaterialsRead;
+exports.relatedMaterialsView = relatedMaterialsView;
+exports.attachRelatedMaterials = attachRelatedMaterials;
 exports.createRefResolver = createRefResolver;
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
@@ -2530,6 +2534,8 @@ async function buildSite(opts, views) {
             const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
             // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）
             attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation, touchedBy);
+            // 関連の資料（cortex-engine #1094 F8）。ルール・用語だけ・欄の無い記録には何も付かない
+            attachRelatedMaterials(e.name, records, refs);
             // ルールの取り下げ（`retracted_by`・cortex-engine #1094 便 4-2d）。ルールの区画だけ・取り下げの無い案件では何も付かない
             if (e.name === "Rules")
                 attachRetractedBy(records, decisions, (d) => rawDates.get(d) ?? d.fm.date);
@@ -2745,6 +2751,8 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch, ref
     const firmness = decisionFirmnessOf(data.firmness);
     const topic = decisionTopicOf(data.topic);
     const decidedBy = decidedByOf(data.decided_by);
+    // 関連の資料（#1094 F8）。通る URL が 0 本ならキーごと載せない
+    const relatedMaterials = relatedMaterialsView(data, refs);
     // 本文先頭の H1 はタイトルと重複するため除去（詳細画面ではタイトルを別途表示する）
     const bodyHtml = await renderRecordBody(content);
     const filePath = repoRelDir ? `${repoRelDir}/${fileName}` : fileName;
@@ -2778,6 +2786,7 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch, ref
         ...(firmness ? { firmness } : {}),
         ...(topic ? { topic } : {}),
         ...(decidedBy ? { decidedBy } : {}),
+        ...(relatedMaterials ? { relatedMaterials } : {}),
     };
 }
 /**
@@ -2830,6 +2839,62 @@ function decidedByOf(value) {
         return undefined;
     return value.map(decidedByEntryOf).filter((e) => e !== null);
 }
+/**
+ * 関連の資料の欄 `related_materials` の読み手（決定・ルール・用語・cortex-engine #1094 F8）。
+ *
+ * 🔴 **写し。正本は cortex-engine `scripts/gold/related-materials-field.mjs` の `isRelatedUrl` と `relatedMaterialsRead`**。
+ * 同じバイト列の表 `test/fixtures/related-materials-contract.json` を両リポに置き、`test/related-materials-view.test.mjs` の
+ * 「[契約] …」が全ケースを流す。規則を変えるときは engine の正本・この写し・表を同じ日に直す。
+ * 重複も上限も見ない（人が足した分を落とさない）。`decided_by` の URL の門（`DECIDED_BY_URL_RE`）とは別の、engine と同じ門
+ */
+exports.RELATED_MATERIALS_FIELD = "related_materials";
+exports.RELATED_URL_MAX = 2000;
+// eslint-disable-next-line no-control-regex
+const RELATED_URL_RE = /^https?:\/\/[^\s<>"\[\]〔〕\u0000-\u001f\u007f]+$/i;
+/** 欄に置いてよい URL か（http(s)・空白と制御文字・`<>"[]〔〕` を含まない・ホストあり・2000 字まで） */
+function isRelatedUrl(v) {
+    if (typeof v !== "string" || !v || v.length > exports.RELATED_URL_MAX)
+        return false;
+    if (!RELATED_URL_RE.test(v))
+        return false;
+    try {
+        const u = new URL(v);
+        return (u.protocol === "http:" || u.protocol === "https:") && u.hostname !== "";
+    }
+    catch {
+        return false;
+    }
+}
+/** frontmatter → 欄の URL の並び（通るものだけ・順はそのまま）。欄が無い・リストでなければ [] */
+function relatedMaterialsRead(fm) {
+    const v = fm && typeof fm === "object" ? fm[exports.RELATED_MATERIALS_FIELD] : null;
+    return Array.isArray(v) ? v.filter(isRelatedUrl) : [];
+}
+/** 画面に載せる形（名前は根拠と同じ解決＝帳の題名・URL の種類の名前）。通る URL が 0 本なら undefined（キーごと載せない） */
+function relatedMaterialsView(fm, refs) {
+    const urls = relatedMaterialsRead(fm);
+    if (!urls.length)
+        return undefined;
+    return urls.map((u) => {
+        // 名前は scheme だけ小文字にして引く（根拠の解決は大文字の `HTTPS://` を URL と読まずパスに落とす）。飛び先は書かれたまま
+        const q = u.replace(/^https?:/i, (m) => m.toLowerCase());
+        const r = refs.resolve(q);
+        // 名前が引けなければ（解決が引いた文字をそのまま返した）、書かれた URL のまま出す
+        return { label: r.label && r.label !== q ? r.label : u, url: u };
+    });
+}
+/** 関連の資料を持てる汎用の区画（関係者・ストーリーの日・Home の欄は拾わない） */
+exports.RELATED_MATERIALS_SECTIONS = new Set(["Rules", "Glossary"]);
+/** 区画の記録に関連の資料を載せる（ルール・用語だけ・欄の無い記録にはキーごと付けない） */
+function attachRelatedMaterials(section, records, refs) {
+    if (!exports.RELATED_MATERIALS_SECTIONS.has(section))
+        return;
+    for (const r of records) {
+        const view = relatedMaterialsView(r.fm, refs);
+        if (view)
+            r.relatedMaterials = view;
+    }
+}
 /**
  * 解決した参照 → 書かれていた値（#968 tools 1）。つながり画面は点の鍵をこの値から決める
  * （`site-data` に載せない——機械の語を画面の材料に増やさない）

package/dist/render.js

@@ -6115,6 +6115,8 @@ button.ops-card-btn:disabled { opacity: .6; cursor: default; }
 .deciders { display: flex; flex-wrap: wrap; gap: 8px; }
 .refs { margin: 0; padding-left: 18px; }
 .refs li { margin: 4px 0; }
+/* 関連の資料（#1094 F8）: 名前の引けない資料は URL のまま（最大 2000 字）なので、狭い画面ではみ出さないよう折り返す */
+.related-materials li { overflow-wrap: anywhere; }
 .body {
   background: var(--surface); border: 1px solid var(--border); border-radius: var(--radius);
   padding: 4px 22px 8px; margin-top: 8px;
@@ -7043,6 +7045,27 @@ ${calendarAddUrl.toString()}
   function retractedFadedClass(rec) {
     return isRetracted(rec) ? " is-faded" : "";
   }
+  /**
+   * 詳細の節「関連の資料」（cortex-engine #1094 F8）。記録を生んだ会話に貼られた資料へのリンク。
+   * 根拠（「参照」）とは混ぜない。ビルドが engine と同じ門で検めてあるが、画面でも http(s) だけをリンクにする（二重に見る）。
+   * 関連の資料の無い記録では null（要素を作らない）
+   */
+  function relatedMaterialsSection(r) {
+    if (!r || !r.relatedMaterials || !r.relatedMaterials.length) return null;
+    // 🔴 大文字の scheme（HTTPS://）も engine の門では通るので、ここも大文字小文字を区別しない（isHttp は区別する＝ほかの画面の前例のまま触らない）
+    var items = r.relatedMaterials.filter(function (m) { return m && typeof m.url === "string" && /^https?:\\/\\//i.test(m.url); });
+    if (!items.length) return null;
+    var box = el("div", { class: "related-materials-section" });
+    box.appendChild(el("div", { class: "section-label", text: "関連の資料" }));
+    var ul = el("ul", { class: "refs related-materials" });
+    items.forEach(function (m) {
+      var li = el("li");
+      li.appendChild(el("a", { href: m.url, target: "_blank", rel: "noopener", text: m.label || m.url }));
+      ul.appendChild(li);
+    });
+    box.appendChild(ul);
+    return box;
+  }
   /** 詳細の節「取り下げを決めた決定」。取り下げの無い記録では null（要素を作らない） */
   function retractSection(r) {
     if (!isRetracted(r)) return null;
@@ -20537,6 +20560,10 @@ ${calendarAddUrl.toString()}
     app.appendChild(genBody);
     loadBody(r, genBody);
 
+    // 関連の資料（#1094 F8）。本文の後・取り下げの節の前。ルール・用語にしか載らない
+    var relm2 = relatedMaterialsSection(r);
+    if (relm2) app.appendChild(relm2);
+
     // 取り下げ（便 4-2d）。本文の後・「その後の記録」の前。取り下げの無い記録では何も作らない
     var retr = retractSection(r);
     if (retr) app.appendChild(retr);
@@ -21512,6 +21539,10 @@ ${calendarAddUrl.toString()}
       app.appendChild(ul);
     }
 
+    // 関連の資料（#1094 F8）。「参照」（根拠）の後・置き換えの前。根拠と混ぜない
+    var relm = relatedMaterialsSection(d);
+    if (relm) app.appendChild(relm);
+
     // 置き換え（#699 F3）。本文・参照の後、「その後の記録」の前。置き換えの無い決定では何も作らない
     var sup = supersedeSection(d);
     if (sup) app.appendChild(sup);

package/package.json

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