@takagaki/cortex-decisions-viewer 0.12.200 → 0.12.214

package/dist/engine/decision-v2-fields.js

@@ -0,0 +1,188 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// engine-src/decision-v2-fields.mjs
+var decision_v2_fields_exports = {};
+__export(decision_v2_fields_exports, {
+  DECIDED_BY_KEYS: () => DECIDED_BY_KEYS,
+  DECISION_DECIDED_BY_FIELD: () => DECISION_DECIDED_BY_FIELD,
+  DECISION_FIRMNESS_FIELD: () => DECISION_FIRMNESS_FIELD,
+  DECISION_FIRMNESS_READ_VALUES: () => DECISION_FIRMNESS_READ_VALUES,
+  DECISION_FIRMNESS_VALUES: () => DECISION_FIRMNESS_VALUES,
+  DECISION_SCENE_FIELD: () => DECISION_SCENE_FIELD,
+  DECISION_SCENE_KEYS: () => DECISION_SCENE_KEYS,
+  DECISION_STRAND_FIELD: () => DECISION_STRAND_FIELD,
+  DECISION_TOPIC_FIELD: () => DECISION_TOPIC_FIELD,
+  DECISION_V2_FIELDS: () => DECISION_V2_FIELDS,
+  decidedByEntryOf: () => decidedByEntryOf,
+  decidedByIssues: () => decidedByIssues,
+  decidersLabelOf: () => decidersLabelOf,
+  decidersOf: () => decidersOf,
+  decisionSceneIssues: () => decisionSceneIssues,
+  decisionStrandIssues: () => decisionStrandIssues,
+  decisionV2FieldsOf: () => decisionV2FieldsOf,
+  decisionV2Issues: () => decisionV2Issues,
+  memberNameOfId: () => memberNameOfId
+});
+module.exports = __toCommonJS(decision_v2_fields_exports);
+var DECISION_FIRMNESS_FIELD = "firmness";
+var DECISION_TOPIC_FIELD = "topic";
+var DECISION_DECIDED_BY_FIELD = "decided_by";
+var DECISION_V2_FIELDS = Object.freeze([DECISION_FIRMNESS_FIELD, DECISION_TOPIC_FIELD, DECISION_DECIDED_BY_FIELD]);
+var DECISION_STRAND_FIELD = "strand";
+var DECISION_FIRMNESS_VALUES = Object.freeze(["\u78BA\u5B9A", "\u4EEE"]);
+var DECISION_FIRMNESS_READ_VALUES = Object.freeze([...DECISION_FIRMNESS_VALUES, "\u691C\u8A0E\u4E2D"]);
+var DECIDED_BY_KEYS = Object.freeze(["member", "name", "url"]);
+var MEMBER_ID_RE = /^member:\S/;
+var URL_RE = /^https?:\/\/\S+$/;
+var isText = (v) => typeof v === "string" && v.trim() !== "";
+var written = (fm, field) => Object.hasOwn(fm, field) && fm[field] != null && fm[field] !== "";
+function decidedByEntryOf(entry) {
+  if (entry == null || typeof entry !== "object" || Array.isArray(entry)) {
+    return { issue: "\u8981\u7D20\u306F member \u304B name \u3092\u6301\u3064\u30DE\u30C3\u30D7\u3067\u66F8\u304F" };
+  }
+  const extra = Object.keys(entry).filter((k) => !DECIDED_BY_KEYS.includes(k));
+  if (extra.length) return { issue: `\u8981\u7D20\u306B\u77E5\u3089\u306A\u3044\u9375\u304C\u3042\u308B: ${extra.join(", ")}\uFF08\u66F8\u3051\u308B\u306E\u306F ${DECIDED_BY_KEYS.join(" / ")}\uFF09` };
+  const hasMember = Object.hasOwn(entry, "member");
+  const hasName = Object.hasOwn(entry, "name");
+  if (hasMember && (hasName || Object.hasOwn(entry, "url"))) {
+    return { issue: "member \u3068 name\u30FBurl \u306F\u540C\u3058\u8981\u7D20\u306B\u66F8\u304B\u306A\u3044\uFF08\u7D50\u3079\u305F\u4EBA\u306F member \u3060\u3051\uFF09" };
+  }
+  if (hasMember) {
+    if (typeof entry.member !== "string" || !MEMBER_ID_RE.test(entry.member)) {
+      return { issue: "member \u306F\u95A2\u4FC2\u8005\u306E id\uFF08member:\u3014\u6C0F\u540D\u3015\uFF09\u3067\u66F8\u304F" };
+    }
+    return { entry: { member: entry.member } };
+  }
+  if (!hasName) return { issue: "\u8981\u7D20\u306B member \u3082 name \u3082\u7121\u3044" };
+  if (!isText(entry.name)) return { issue: "name \u306F\u8868\u8A18\u306E\u6587\u5B57\u5217\u3067\u66F8\u304F" };
+  if (entry.url == null) return { entry: { name: entry.name } };
+  if (typeof entry.url !== "string" || !URL_RE.test(entry.url)) {
+    return { issue: "url \u306F\u5143\u306E\u767A\u8A00\u306E http(s) \u306E URL \u3067\u66F8\u304F" };
+  }
+  return { entry: { name: entry.name, url: entry.url } };
+}
+function decisionV2Issues(fm) {
+  const out = [];
+  if (fm == null || typeof fm !== "object") return out;
+  if (written(fm, DECISION_FIRMNESS_FIELD) && !DECISION_FIRMNESS_READ_VALUES.includes(fm[DECISION_FIRMNESS_FIELD])) {
+    out.push({
+      code: "bad_vocab",
+      field: DECISION_FIRMNESS_FIELD,
+      message: `firmness\u306F${DECISION_FIRMNESS_READ_VALUES.join("|")}\uFF08\u5B9F\u969B: ${fm[DECISION_FIRMNESS_FIELD]}\uFF09`
+    });
+  }
+  if (written(fm, DECISION_TOPIC_FIELD) && !isText(fm[DECISION_TOPIC_FIELD])) {
+    out.push({
+      code: "bad_format",
+      field: DECISION_TOPIC_FIELD,
+      message: "topic\u306F\u8AD6\u70B9\u306E\u672D\u306E\u540D\u524D\u30921\u3064\u306E\u6587\u5B57\u5217\u3067\u66F8\u304F"
+    });
+  }
+  out.push(...decidedByIssues(fm));
+  return out;
+}
+function decidedByIssues(fm) {
+  const out = [];
+  if (fm == null || typeof fm !== "object" || !written(fm, DECISION_DECIDED_BY_FIELD)) return out;
+  const list = fm[DECISION_DECIDED_BY_FIELD];
+  if (!Array.isArray(list)) {
+    out.push({
+      code: "bad_format",
+      field: DECISION_DECIDED_BY_FIELD,
+      message: "decided_by\u306F\u30EA\u30B9\u30C8\u3067\u66F8\u304F\uFF08\u7A7A\u3067\u3082\u3088\u3044\u3002\u8981\u7D20\u306F { member: member:\u3014\u6C0F\u540D\u3015 } \u304B { name, url }\uFF09"
+    });
+  } else {
+    list.forEach((entry, i) => {
+      const read = decidedByEntryOf(entry);
+      if (read.issue) out.push({ code: "bad_format", field: DECISION_DECIDED_BY_FIELD, message: `decided_by[${i}]: ${read.issue}` });
+    });
+  }
+  return out;
+}
+function decisionStrandIssues(fm) {
+  if (fm == null || typeof fm !== "object" || !written(fm, DECISION_STRAND_FIELD) || isText(fm[DECISION_STRAND_FIELD])) return [];
+  return [{ code: "bad_format", field: DECISION_STRAND_FIELD, message: "strand\u306F\u8A71\u306E\u7B4B\u306E\u540D\u524D\u30921\u3064\u306E\u6587\u5B57\u5217\u3067\u66F8\u304F" }];
+}
+var DECISION_SCENE_FIELD = "scene";
+var DECISION_SCENE_KEYS = Object.freeze(["venue", "date", "proposed_by", "agreed_by"]);
+var SCENE_DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
+var sceneDayOf = (v) => v instanceof Date && !Number.isNaN(v.getTime()) ? v.toISOString().slice(0, 10) : typeof v === "string" ? v.trim() : "";
+function decisionSceneIssues(fm) {
+  if (fm == null || typeof fm !== "object" || !written(fm, DECISION_SCENE_FIELD)) return [];
+  const s = fm[DECISION_SCENE_FIELD];
+  const bad = (message) => [{ code: "bad_format", field: DECISION_SCENE_FIELD, message }];
+  if (typeof s !== "object" || Array.isArray(s)) return bad("scene\u306F venue\u30FBdate\u30FBproposed_by\u30FBagreed_by \u3092\u6301\u3064\u30DE\u30C3\u30D7\u3067\u66F8\u304F");
+  const extra = Object.keys(s).filter((k) => !DECISION_SCENE_KEYS.includes(k));
+  if (extra.length) return bad(`scene\u306B\u77E5\u3089\u306A\u3044\u9375\u304C\u3042\u308B: ${extra.join(", ")}\uFF08\u66F8\u3051\u308B\u306E\u306F ${DECISION_SCENE_KEYS.join(" / ")}\uFF09`);
+  if (!SCENE_DAY_RE.test(sceneDayOf(s.date))) return bad("scene.date\u306F\u6C7A\u3081\u305F\u65E5\u3092 YYYY-MM-DD \u3067\u66F8\u304F");
+  if (Object.hasOwn(s, "venue") && !isText(s.venue)) return bad("scene.venue\u306F\u5834\u306E\u540D\u524D\u3092\u6587\u5B57\u5217\u3067\u66F8\u304F");
+  for (const k of ["proposed_by", "agreed_by"]) {
+    if (!Object.hasOwn(s, k)) continue;
+    if (!Array.isArray(s[k]) || s[k].some((x) => typeof x !== "string" || !MEMBER_ID_RE.test(x))) return bad(`scene.${k}\u306F\u95A2\u4FC2\u8005\u306E id\uFF08member:\u2026\uFF09\u306E\u30EA\u30B9\u30C8\u3067\u66F8\u304F`);
+  }
+  return [];
+}
+function decisionV2FieldsOf(fm) {
+  const src = fm && typeof fm === "object" ? fm : {};
+  const firmness = DECISION_FIRMNESS_READ_VALUES.includes(src[DECISION_FIRMNESS_FIELD]) ? src[DECISION_FIRMNESS_FIELD] : null;
+  const topic = isText(src[DECISION_TOPIC_FIELD]) ? src[DECISION_TOPIC_FIELD].trim() : null;
+  const raw = src[DECISION_DECIDED_BY_FIELD];
+  const decidedBy = Array.isArray(raw) ? raw.map(decidedByEntryOf).filter((r) => r.entry).map((r) => r.entry) : null;
+  return { firmness, topic, decidedBy };
+}
+function decidersOf(fm, { deciders } = {}) {
+  const src = fm && typeof fm === "object" ? fm : {};
+  const base = Array.isArray(deciders) ? deciders : Array.isArray(src.deciders) ? src.deciders : [];
+  const names = base.map((v) => String(v ?? "").trim()).filter(Boolean);
+  const memberIds = [];
+  for (const entry of decisionV2FieldsOf(src).decidedBy || []) {
+    if (entry.member) memberIds.push(entry.member);
+    else if (entry.name && entry.name.trim()) names.push(entry.name.trim());
+  }
+  return { names, memberIds: [...new Set(memberIds)] };
+}
+var memberNameOfId = (id) => String(id ?? "").trim().replace(/^member:/, "");
+function decidersLabelOf(decision) {
+  const names = Array.isArray(decision?.deciders) ? decision.deciders : [];
+  const ids = Array.isArray(decision?.deciderMemberIds) ? decision.deciderMemberIds.map(memberNameOfId).filter(Boolean) : [];
+  return [...names, ...ids.filter((n) => !names.includes(n))].join("\u30FB");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DECIDED_BY_KEYS,
+  DECISION_DECIDED_BY_FIELD,
+  DECISION_FIRMNESS_FIELD,
+  DECISION_FIRMNESS_READ_VALUES,
+  DECISION_FIRMNESS_VALUES,
+  DECISION_SCENE_FIELD,
+  DECISION_SCENE_KEYS,
+  DECISION_STRAND_FIELD,
+  DECISION_TOPIC_FIELD,
+  DECISION_V2_FIELDS,
+  decidedByEntryOf,
+  decidedByIssues,
+  decidersLabelOf,
+  decidersOf,
+  decisionSceneIssues,
+  decisionStrandIssues,
+  decisionV2FieldsOf,
+  decisionV2Issues,
+  memberNameOfId
+});

package/dist/engine/ref-tokens.js

@@ -0,0 +1,276 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// engine-src/ref-tokens.mjs
+var ref_tokens_exports = {};
+__export(ref_tokens_exports, {
+  canonicalEvidence: () => canonicalEvidence,
+  driveFileUrl: () => driveFileUrl,
+  gfileKeyOf: () => gfileKeyOf,
+  githubRefToken: () => githubRefToken,
+  isPathLikeTarget: () => isPathLikeTarget,
+  matchableRef: () => matchableRef,
+  refTokenSet: () => refTokenSet,
+  refTokens: () => refTokens,
+  refsOverlap: () => refsOverlap,
+  rowRefTokens: () => rowRefTokens,
+  syntaxNormalizedUrl: () => syntaxNormalizedUrl,
+  urlsInText: () => urlsInText
+});
+module.exports = __toCommonJS(ref_tokens_exports);
+var ISSUE_KEY_RE = /\b[A-Z][A-Z0-9_]{1,20}-\d+\b/g;
+var URL_RE = /https?:\/\/[^\s<>()"'|、。」]+/g;
+var GH_SHORT_RE = /\b([A-Za-z0-9._-]+)\/([A-Za-z0-9._-]+)#(\d+)\b/g;
+var GH_URL_RE = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+)\/(?:issues|pull)\/(\d+)/i;
+function normalizeUrl(raw) {
+  return String(raw).replace(/[).,;:、。]+$/, "").replace(/\/+$/, "").toLowerCase();
+}
+var githubRefToken = (owner, repo, number) => `gh:${String(owner).toLowerCase()}/${String(repo).toLowerCase()}#${number}`;
+function legacyUrlTokens(url) {
+  const normalized = normalizeUrl(url);
+  const gh = normalized.match(GH_URL_RE);
+  return gh ? [githubRefToken(gh[1], gh[2], gh[3]), normalized] : [normalized];
+}
+var driveFileUrl = (fileId) => `https://drive.google.com/file/d/${encodeURIComponent(fileId)}/view`;
+function extractRefTokens(value, keyer = null) {
+  const raw = String(value ?? "").trim();
+  if (!raw) return { tokens: [], matchable: false };
+  if (keyer) return extractKeyedTokens(raw, keyer);
+  const out = /* @__PURE__ */ new Set();
+  for (const url of raw.match(URL_RE) || []) for (const t of legacyUrlTokens(url)) out.add(t);
+  for (const key of raw.match(ISSUE_KEY_RE) || []) out.add(key.toLowerCase());
+  for (const m of raw.matchAll(GH_SHORT_RE)) out.add(githubRefToken(m[1], m[2], m[3]));
+  if (out.size) return { tokens: [...out], matchable: true };
+  return wholeValueToken(raw);
+}
+var wholeValueToken = (raw) => ({ tokens: [raw.replace(/\/+$/, "").toLowerCase()], matchable: false });
+function extractKeyedTokens(raw, keyer) {
+  const urls = raw.match(URL_RE) || [];
+  const whole = typeof keyer.canonical === "function" ? keyer.canonical(raw) : null;
+  const wholeKeys = keyer.keysOf(raw);
+  if (wholeKeys && wholeKeys.length && !(whole && whole.kind === "url" && urls.length)) {
+    return { tokens: [...new Set(wholeKeys)], matchable: true };
+  }
+  const out = /* @__PURE__ */ new Set();
+  let residue = raw;
+  for (const url of urls) {
+    const keys = keyer.keysOf(url);
+    const c = typeof keyer.canonical === "function" ? keyer.canonical(url) : null;
+    if (keys && keys.length) for (const k of keys) out.add(k);
+    else for (const t of legacyUrlTokens(url)) out.add(t);
+    if (c && c.kind === "url") {
+      const gh = normalizeUrl(url).match(GH_URL_RE);
+      if (gh) out.add(githubRefToken(gh[1], gh[2], gh[3]));
+    }
+    if (c && c.kind !== "url") residue = residue.split(url).join(" ");
+  }
+  for (const key of residue.match(ISSUE_KEY_RE) || []) out.add(key.toLowerCase());
+  for (const m of residue.matchAll(GH_SHORT_RE)) out.add(githubRefToken(m[1], m[2], m[3]));
+  if (out.size) return { tokens: [...out], matchable: true };
+  return wholeValueToken(raw);
+}
+function refTokens(value, keyer = null) {
+  return extractRefTokens(value, keyer).tokens;
+}
+var matchableRef = (value, keyer = null) => extractRefTokens(value, keyer).matchable;
+var refTokenSet = (values = [], keyer = null) => new Set((values || []).flatMap((v) => refTokens(v, keyer)));
+function refsOverlap(a, b) {
+  const [small, large] = a.size <= b.size ? [a, b] : [b, a];
+  for (const token of small) if (large.has(token)) return true;
+  return false;
+}
+function rowRefTokens(row, keyer = null) {
+  const refs = row && row.refs || {};
+  const out = /* @__PURE__ */ new Set();
+  for (const key of refs.issue_keys || []) for (const t of refTokens(key, keyer)) out.add(t);
+  for (const url of refs.urls || []) for (const t of refTokens(url, keyer)) out.add(t);
+  return out;
+}
+var TEXT_URL_RE = /https?:\/\/[^\s<>()\[\]"'`|、。」）】』＞\u3000-\u303f\u3040-\u30ff\u3400-\u9fff\uff00-\uffef]+/g;
+var JA_LETTER_RE = /[\u3040-\u30ff\u3400-\u9fff]/;
+function urlsInText(text, stats = null) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const src = String(text ?? "").replace(/&amp;/g, "&");
+  for (const m of src.matchAll(TEXT_URL_RE)) {
+    if (m[0].endsWith("/") && JA_LETTER_RE.test(src[m.index + m[0].length] || "")) {
+      if (stats) stats.cut = (stats.cut || 0) + 1;
+      continue;
+    }
+    const url = m[0].replace(/[.,;:!?*~]+$/, "");
+    if (!/^https?:\/\/[^/?#]+/i.test(url) || seen.has(url)) continue;
+    seen.add(url);
+    out.push(url);
+  }
+  return out;
+}
+var WHOLE_URL_RE = /^(?:https?:\/\/\S+|\[[^\]\n]*\]\(https?:\/\/[^)\s]+\))$/i;
+function isPathLikeTarget(target) {
+  const t = String(target ?? "").trim();
+  return t.includes("/") && t.includes(".md") && !WHOLE_URL_RE.test(t);
+}
+var WHOLE_ISSUE_KEY_RE = /^([A-Z][A-Z0-9_]{1,20})-(\d+)$/;
+var WHOLE_GH_SHORT_RE = /^([A-Za-z0-9._-]+)\/([A-Za-z0-9._-]+)#(\d+)$/;
+var URL_PARTS_RE = /^(https?):\/\/([^/?#\s]+)([^\s]*)$/i;
+function syntaxNormalizedUrl(raw) {
+  let t = String(raw ?? "").trim();
+  for (let prev = ""; prev !== t; ) {
+    prev = t;
+    t = t.replace(/[).,;:、。]+$/, "").replace(/\/+$/, "");
+  }
+  const m = t.match(URL_PARTS_RE);
+  if (!m) return null;
+  const scheme = m[1].toLowerCase();
+  let host = m[2].toLowerCase();
+  if (scheme === "http" && host.endsWith(":80") || scheme === "https" && host.endsWith(":443")) host = host.replace(/:\d+$/, "");
+  if (!host) return null;
+  const rest = m[3].replace(/%[0-9a-f]{2}/gi, (x) => x.toUpperCase()).replace(/\/+(?=$|[?#])/, "");
+  return `${scheme}://${host}${rest}`;
+}
+function wholeUrlOf(value) {
+  const v = String(value ?? "").trim();
+  const m = v.match(/^(https?:\/\/\S+)$/i) || v.match(/^\[[^\]\n]*\]\((https?:\/\/[^)\s]+)\)$/i) || v.match(/^<(https?:\/\/[^|>\s]+)(?:\|[^>]*)?>$/i);
+  return m ? m[1].replace(/\\_/g, "_") : null;
+}
+var queryOf = (rest) => {
+  const q = rest.indexOf("?");
+  if (q < 0) return new URLSearchParams();
+  const h = rest.indexOf("#", q);
+  return new URLSearchParams(rest.slice(q + 1, h < 0 ? void 0 : h));
+};
+var pathOf = (rest) => rest.replace(/[?#].*$/, "");
+var fragmentOf = (rest) => {
+  const h = rest.indexOf("#");
+  return h < 0 ? "" : rest.slice(h + 1);
+};
+var gfileKeyOf = (fileId) => `gfile:${fileId}`;
+var GDOC_KINDS = /* @__PURE__ */ new Set(["document", "spreadsheets", "presentation", "forms"]);
+var BACKLOG_HOST_RE = /\.(?:backlog\.jp|backlog\.com|backlogtool\.com)$/;
+function canonicalOfUrl(url, ctx) {
+  const m = url.match(URL_PARTS_RE);
+  if (!m) return null;
+  const host = m[2];
+  const rest = m[3];
+  const p = pathOf(rest);
+  const q = queryOf(rest);
+  if (host === "docs.google.com") {
+    const g = p.match(/^\/(?:a\/[^/]+\/)?([a-z]+)\/(?:u\/\d+\/)?d\/([A-Za-z0-9_-]{10,})/);
+    if (g && GDOC_KINDS.has(g[1])) return { kind: "gdoc", key: gfileKeyOf(g[2]), url: `https://docs.google.com/${g[1]}/d/${g[2]}` };
+    const fd = p.match(/^\/(?:a\/[^/]+\/)?file\/d\/([A-Za-z0-9_-]{10,})/);
+    if (fd) return { kind: "drive", key: gfileKeyOf(fd[1]), url: driveFileUrl(fd[1]) };
+  }
+  if (host === "drive.google.com") {
+    const f = p.match(/^\/(?:a\/[^/]+\/)?file\/(?:u\/\d+\/)?d\/([A-Za-z0-9_-]{10,})/);
+    const id = f ? f[1] : /^\/(?:open|uc)$/.test(p) && /^[A-Za-z0-9_-]{10,}$/.test(q.get("id") || "") ? q.get("id") : "";
+    if (id) return { kind: "drive", key: gfileKeyOf(id), url: driveFileUrl(id) };
+    const d = p.match(/^\/drive\/(?:u\/\d+\/)?folders\/([A-Za-z0-9_-]{10,})/);
+    if (d) return { kind: "drive-folder", key: `gfolder:${d[1]}`, url: `https://drive.google.com/drive/folders/${d[1]}` };
+  }
+  if (host.endsWith(".slack.com")) {
+    const s = p.match(/^\/archives\/([A-Z0-9]+)(?:\/p(\d+))?$/);
+    if (s) {
+      const hosts = ctx.slackHosts instanceof Map ? ctx.slackHosts : new Map(Object.entries(ctx.slackHosts || {}));
+      const h = String(hosts.get(s[1]) || "").trim().toLowerCase() || host;
+      const thread = s[2] && /^\d+\.\d+$/.test(q.get("thread_ts") || "") ? q.get("thread_ts") : "";
+      const key = `slack:${s[1]}${s[2] ? `:p${s[2]}` : ""}`;
+      const tail = `${s[2] ? `/p${s[2]}` : ""}${thread ? `?thread_ts=${thread}` : ""}`;
+      return { kind: "slack", key, url: `https://${h}/archives/${s[1]}${tail}` };
+    }
+  }
+  if (host === "chat.google.com" || host === "mail.google.com") {
+    const room = host === "chat.google.com" ? p.match(/^\/(?:u\/\d+\/)?room\/([A-Za-z0-9_-]+)/) : null;
+    const inMail = host === "mail.google.com" && /^\/chat(?:\/|$)/.test(p) ? fragmentOf(rest).match(/^chat\/space\/([A-Za-z0-9_-]+)/) : null;
+    const space = room && room[1] || inMail && inMail[1];
+    if (space) return { kind: "gchat", key: `gchat:${space}`, url: `https://chat.google.com/room/${space}` };
+  }
+  if (BACKLOG_HOST_RE.test(host)) {
+    const v = p.match(/^\/view\/([A-Z][A-Z0-9_]{1,20}-\d+)$/);
+    if (v) {
+      const c = fragmentOf(rest).match(/^comment-(\d+)$/);
+      const issue = v[1].toLowerCase();
+      return {
+        kind: "backlog",
+        key: c ? `${issue}#comment-${c[1]}` : issue,
+        url: `https://${host}/view/${v[1]}${c ? `#comment-${c[1]}` : ""}`,
+        ...c ? { parentKey: issue } : {}
+      };
+    }
+    const w = p.match(/^\/alias\/wiki\/(\d+)$/);
+    if (w) return { kind: "backlog", key: `backlog:${host}:wiki:${w[1]}`, url: `https://${host}/alias/wiki/${w[1]}` };
+    const d = p.match(/^\/document\/([^/]+)\/([0-9a-f]{32})$/i);
+    if (d) return { kind: "backlog", key: `backlog:${host}:doc:${d[2].toLowerCase()}`, url: `https://${host}/document/${d[1]}/${d[2].toLowerCase()}` };
+  }
+  if (host === "figma.com" || host === "www.figma.com") {
+    const f = p.match(/^\/(design|file|proto|board)\/([A-Za-z0-9]{10,})(?:\/branch\/([A-Za-z0-9]{10,}))?(?:\/|$)/);
+    if (f) {
+      const fileKey = f[3] || f[2];
+      const node = String(q.get("node-id") || "").trim().replace(/%3A/gi, ":");
+      if (node && !/^\d+[-:]\d+$/.test(node)) return { kind: "url", key: `url:${url}`, url };
+      const n = node ? node.replace(":", "-") : "";
+      const seg = f[1] === "board" ? "board" : "design";
+      return { kind: "figma", key: `figma:${fileKey}${n ? `:${n.replace("-", ":")}` : ""}`, url: `https://www.figma.com/${seg}/${fileKey}${n ? `?node-id=${n}` : ""}` };
+    }
+  }
+  if (host === "github.com" || host === "www.github.com") {
+    const g = p.match(/^\/([^/]+)\/([^/]+)\/(?:issues|pull|discussions)\/(\d+)$/);
+    if (g) {
+      const [o, r] = [g[1].toLowerCase(), g[2].toLowerCase()];
+      const issue = githubRefToken(o, r, g[3]);
+      const c = fragmentOf(rest).match(/^(issuecomment-\d+|discussioncomment-\d+|discussion_r\d+|pullrequestreview-\d+)$/);
+      return {
+        kind: "github",
+        key: c ? `${issue}#${c[1]}` : issue,
+        url: `https://github.com/${o}/${r}/issues/${g[3]}${c ? `#${c[1]}` : ""}`,
+        ...c ? { parentKey: issue } : {}
+      };
+    }
+  }
+  return { kind: "url", key: `url:${url}`, url };
+}
+function canonicalEvidence(value, ctx = {}) {
+  const raw = String(value ?? "").trim();
+  if (!raw) return null;
+  const key = raw.match(WHOLE_ISSUE_KEY_RE);
+  if (key) {
+    const domains = ctx.backlogDomains instanceof Map ? ctx.backlogDomains : new Map(Object.entries(ctx.backlogDomains || {}));
+    const host = String(domains.get(key[1]) || "").trim().toLowerCase().replace(/^https?:\/\//, "").replace(/\/+$/, "");
+    return host ? canonicalOfUrl(`https://${host}/view/${raw}`, ctx) : null;
+  }
+  const gh = raw.match(WHOLE_GH_SHORT_RE);
+  if (gh) return canonicalOfUrl(`https://github.com/${gh[1]}/${gh[2]}/issues/${gh[3]}`, ctx);
+  const url = wholeUrlOf(raw);
+  if (!url) return null;
+  const normalized = syntaxNormalizedUrl(url);
+  return normalized ? canonicalOfUrl(normalized, ctx) : null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  canonicalEvidence,
+  driveFileUrl,
+  gfileKeyOf,
+  githubRefToken,
+  isPathLikeTarget,
+  matchableRef,
+  refTokenSet,
+  refTokens,
+  refsOverlap,
+  rowRefTokens,
+  syntaxNormalizedUrl,
+  urlsInText
+});

package/dist/engine/related-materials-field.js

@@ -0,0 +1,148 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// engine-src/related-materials-field.mjs
+var related_materials_field_exports = {};
+__export(related_materials_field_exports, {
+  RELATED_MATERIALS_FIELD: () => RELATED_MATERIALS_FIELD,
+  RELATED_URL_MAX: () => RELATED_URL_MAX,
+  RESOURCE_JOINT: () => RESOURCE_JOINT,
+  RESOURCE_LABEL: () => RESOURCE_LABEL,
+  hasRelatedMaterialsField: () => hasRelatedMaterialsField,
+  isRelatedUrl: () => isRelatedUrl,
+  relatedMaterialsIssues: () => relatedMaterialsIssues,
+  relatedMaterialsLines: () => relatedMaterialsLines,
+  relatedMaterialsOf: () => relatedMaterialsOf,
+  relatedMaterialsRead: () => relatedMaterialsRead,
+  withRelatedMaterials: () => withRelatedMaterials
+});
+module.exports = __toCommonJS(related_materials_field_exports);
+
+// engine-src/frontmatter-bounds.mjs
+var BOM = "\uFEFF";
+var BLANK_LINE = /^[ \t\r]*$/;
+var bareLine = (line) => String(line ?? "").replace(/\r$/, "");
+var lineTailOf = (lines) => (lines || []).some((l) => String(l ?? "").endsWith("\r")) ? "\r" : "";
+function frontmatterBounds(raw) {
+  const text = String(raw ?? "");
+  let at = text.startsWith(BOM) ? BOM.length : 0;
+  for (; ; ) {
+    const nl = text.indexOf("\n", at);
+    if (nl === -1) break;
+    if (!BLANK_LINE.test(text.slice(at, nl))) break;
+    at = nl + 1;
+  }
+  const openEnd = text.indexOf("\n", at);
+  if (openEnd === -1) return null;
+  const openLine = text.slice(at, openEnd);
+  if (openLine !== "---" && openLine !== "---\r") return null;
+  const innerStart = openEnd + 1;
+  const close = text.indexOf("\n---", innerStart);
+  if (close === -1) return null;
+  return {
+    head: text.slice(0, innerStart),
+    inner: text.slice(innerStart, close),
+    rest: text.slice(close),
+    body: text.slice(close + 4)
+  };
+}
+
+// engine-src/related-materials-field.mjs
+var RELATED_MATERIALS_FIELD = "related_materials";
+var RESOURCE_LABEL = "\u8CC7\u6599";
+var RESOURCE_JOINT = "\u30FB";
+var RELATED_URL_MAX = 2e3;
+function isRelatedUrl(v) {
+  if (typeof v !== "string" || !v || v.length > RELATED_URL_MAX) return false;
+  if (!/^https?:\/\/[^\s<>"\[\]〔〕\u0000-\u001f\u007f]+$/i.test(v)) return false;
+  try {
+    const u = new URL(v);
+    return (u.protocol === "http:" || u.protocol === "https:") && u.hostname !== "";
+  } catch {
+    return false;
+  }
+}
+function relatedMaterialsOf(list) {
+  const items = Array.isArray(list) ? list : [];
+  const urls = [];
+  let dropped = 0;
+  for (const v of items) {
+    if (!isRelatedUrl(v) || urls.includes(v)) dropped += 1;
+    else urls.push(v);
+  }
+  return { urls, dropped };
+}
+function hasRelatedMaterialsField(text) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(String(text ?? ""));
+  return Boolean(m) && new RegExp(`^${RELATED_MATERIALS_FIELD}:`, "m").test(m[1]);
+}
+var written = (fm) => {
+  if (fm == null || typeof fm !== "object" || !Object.hasOwn(fm, RELATED_MATERIALS_FIELD)) return false;
+  const v = fm[RELATED_MATERIALS_FIELD];
+  return !(v == null || v === "" || Array.isArray(v) && v.length === 0);
+};
+function relatedMaterialsIssues(fm) {
+  if (!written(fm)) return [];
+  const v = fm[RELATED_MATERIALS_FIELD];
+  const field = RELATED_MATERIALS_FIELD;
+  if (!Array.isArray(v)) return [{ code: "bad_format", field, message: `${field}\u306F http(s) \u306E URL \u306E\u30EA\u30B9\u30C8\u3067\u66F8\u304F\uFF08\u7A7A\u306A\u3089\u6B04\u3054\u3068\u66F8\u304B\u306A\u3044\uFF09` }];
+  const out = [];
+  v.forEach((u, i) => {
+    if (!isRelatedUrl(u)) out.push({ code: "bad_format", field, message: `${field}[${i}] \u306F http(s) \u306E URL \u3067\u66F8\u304F` });
+  });
+  return out;
+}
+function relatedMaterialsRead(fm) {
+  const v = fm && typeof fm === "object" ? fm[RELATED_MATERIALS_FIELD] : null;
+  return Array.isArray(v) ? v.filter(isRelatedUrl) : [];
+}
+function relatedMaterialsLines(urls) {
+  const list = Array.isArray(urls) ? urls.filter(isRelatedUrl) : [];
+  return list.length ? [`${RELATED_MATERIALS_FIELD}:`, ...list.map((u) => `  - ${JSON.stringify(u)}`)] : [];
+}
+function withRelatedMaterials(raw, urls) {
+  const text = String(raw ?? "");
+  if (hasRelatedMaterialsField(text)) return null;
+  const at = frontmatterBounds(text);
+  if (!at) return null;
+  const add = relatedMaterialsLines(urls);
+  if (!add.length) return null;
+  const lines = at.inner.split("\n");
+  if (lines.some((l) => bareLine(l).startsWith(`${RELATED_MATERIALS_FIELD}:`))) return null;
+  const tail = lineTailOf(lines);
+  const own = add.map((l) => `${l}${tail}`);
+  const i = lines.findIndex((l) => /^(?:relations|references):(?:[ \t]|$)/.test(bareLine(l)));
+  if (i === -1) return `${at.head}${at.inner}
+${own.join("\n")}${at.rest}`;
+  return `${at.head}${[...lines.slice(0, i), ...own, ...lines.slice(i)].join("\n")}${at.rest}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RELATED_MATERIALS_FIELD,
+  RELATED_URL_MAX,
+  RESOURCE_JOINT,
+  RESOURCE_LABEL,
+  hasRelatedMaterialsField,
+  isRelatedUrl,
+  relatedMaterialsIssues,
+  relatedMaterialsLines,
+  relatedMaterialsOf,
+  relatedMaterialsRead,
+  withRelatedMaterials
+});