@takagaki/cortex-decisions-viewer 0.12.200 → 0.12.214

package/README.md

@@ -74,8 +74,10 @@ cortex-decisions-viewer build [dir] [options]
 
 ```bash
 npm install
-npm run build          # tsc → dist/
-npm run demo           # ../../aidd-project-cortex の Cortex/ をビルドして .demo-site/ に出力
+node ../scripts/ci/assemble-engine.mjs   # engine の原本を viewer/engine-src/ に組み立てる（engine の場所は ENGINE_ROOT、無ければ tools の隣の ../cortex-engine）
+                                         # npm test は pretest が回す。build・demo を単独で回す前は手で
+npm run build          # tsc → dist/ と、engine の原本を束ねて dist/engine/（先に組み立て）
+npm run demo           # 中で build を呼ぶ（先に組み立て）。../../aidd-project-cortex の Cortex/ をビルドして .demo-site/ に出力
 ```
 
 ## 位置づけ（cortex-tools モノレポ）

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.REFERENCES_SECTIONS = exports.RELATED_MATERIALS_SECTIONS = exports.RELATED_URL_MAX = exports.RELATED_MATERIALS_FIELD = exports.DECISION_FIRMNESS = exports.GRAPH_RELS = exports.GRAPH_RECORD_TYPES = exports.GUIDE_VIDEO_SOURCES = exports.PROJECT_ICON_EXTS = exports.MIRROR_RELS = void 0;
+exports.REFERENCES_SECTIONS = exports.RELATED_MATERIALS_SECTIONS = exports.DECISION_FIRMNESS = exports.RELATED_URL_MAX = exports.RELATED_MATERIALS_FIELD = exports.relatedMaterialsRead = exports.isRelatedUrl = exports.GRAPH_RELS = exports.GRAPH_RECORD_TYPES = exports.GUIDE_VIDEO_SOURCES = exports.PROJECT_ICON_EXTS = exports.MIRROR_RELS = void 0;
 exports.sanitizeBody = sanitizeBody;
 exports.copyHashedAsset = copyHashedAsset;
 exports.buildGuideAssets = buildGuideAssets;
@@ -61,8 +61,6 @@ exports.build = build;
 exports.decisionFirmnessOf = decisionFirmnessOf;
 exports.decisionStrandOf = decisionStrandOf;
 exports.decidedByOf = decidedByOf;
-exports.isRelatedUrl = isRelatedUrl;
-exports.relatedMaterialsRead = relatedMaterialsRead;
 exports.relatedMaterialsView = relatedMaterialsView;
 exports.attachRecordReferences = attachRecordReferences;
 exports.attachRelatedMaterials = attachRelatedMaterials;
@@ -78,15 +76,19 @@ const evidence_names_1 = require("./evidence-names");
 const change_log_1 = require("./change-log");
 const repo_1 = require("./repo");
 const engagement_1 = require("./engagement");
+const memory_dir_1 = require("./memory-dir");
 const story_1 = require("./story");
 const ranking_1 = require("./ranking");
 const memory_evidence_1 = require("./memory-evidence");
 const hands_1 = require("./hands");
+const config_mode_1 = require("./config-mode");
 const rederivation_1 = require("./rederivation");
 const external_id_1 = require("./external-id");
 const member_origin_1 = require("./member-origin");
 const home_project_1 = require("./home-project");
 const supersedes_1 = require("./supersedes");
+const decision_v2_fields_1 = require("./engine/decision-v2-fields");
+const related_materials_field_1 = require("./engine/related-materials-field");
 const minify_1 = require("./minify");
 const google_confirm_page_1 = require("./google-confirm-page");
 const render_1 = require("./render");
@@ -259,14 +261,20 @@ function memberSearchText(data, sectionDir, base) {
 }
 /** dir未指定時の探索候補（新構成 → 旧構成の順） */
 const DEFAULT_DIR_CANDIDATES = ["Cortex/Decisions/records", "Cortex/Decisions", "Decisions"];
+/** 組み直した案件（木に `Memory/Home.md`）の探索候補。**この木のときだけ先に探す**（今までの案件は上の 3 つのまま） */
+const MEMORY_DIR_CANDIDATES = ["Memory/Decisions/records", "Memory/Decisions"];
 /**
  * Decisionsディレクトリを解決する。明示指定があればそれを使い、
  * 未指定なら Cortex/Decisions/records → Cortex/Decisions → Decisions の順で存在するものを採用する。
+ * 組み直した案件（木に `Memory/Home.md`）は Memory/Decisions/records → Memory/Decisions だけ。
  */
 async function resolveDecisionsDir(dir) {
     if (dir)
         return path.resolve(dir);
-    for (const candidate of DEFAULT_DIR_CANDIDATES) {
+    const rebuilt = (await (0, memory_dir_1.memoryDirOfTree)(process.cwd())) === "Memory";
+    // 🔴 組み直した案件は `Memory/` だけを探す（今までの置き場〈Cortex/…・Decisions〉へ倒れない・cortex-engine #1911 便 GV）
+    const candidates = rebuilt ? MEMORY_DIR_CANDIDATES : DEFAULT_DIR_CANDIDATES;
+    for (const candidate of candidates) {
         const abs = path.resolve(candidate);
         try {
             const st = await node_fs_1.promises.stat(abs);
@@ -277,7 +285,53 @@ async function resolveDecisionsDir(dir) {
             // 存在しない候補はスキップ
         }
     }
-    throw new Error(`Decisionsディレクトリが見つかりません（${DEFAULT_DIR_CANDIDATES.join(" / ")} を確認してください）`);
+    throw new Error(`Decisionsディレクトリが見つかりません（${candidates.join(" / ")} を確認してください）`);
+}
+/** 取り出した区画にファイルが 1 本も無いか（無いフォルダも空と読む・読めないフォルダは空と読まない） */
+async function viewDirIsEmpty(viewDir) {
+    try {
+        return (await node_fs_1.promises.readdir(viewDir)).length === 0;
+    }
+    catch (e) {
+        return e?.code === "ENOENT";
+    }
+}
+/** 記憶の中身に数えない Markdown（入口・説明・雛形） */
+const MEMORY_NON_CONTENT_MD = new Set(["home.md", "readme.md", "template.md"]);
+/**
+ * 組み直した案件の木の記憶の中身の数（`Memory/` の下の .md。Home・README・template は数えない）。区画の名前も `records/` の有無も決め打ちしない
+ * （記録・ストーリー・区画の直下の記録を全部数える）。リンクはたどる（`stat`）。空の画面に倒してよいかの判定にだけ使う（cortex-engine #1911 便 GV）。
+ * 🔴 読めない階層・深すぎる階層は 1 と数える（空に倒れる側にしない）。`Memory/` が無い木も 1（組み直した案件の印と食い違う）
+ */
+async function memoryContentCount(dir, depth = 0) {
+    if (depth > 8)
+        return 1;
+    let names;
+    try {
+        names = await node_fs_1.promises.readdir(dir);
+    }
+    catch {
+        return 1;
+    }
+    let n = 0;
+    for (const name of names) {
+        const abs = path.join(dir, name);
+        let st;
+        try {
+            st = await node_fs_1.promises.stat(abs);
+        }
+        catch {
+            n += 1;
+            continue;
+        }
+        if (st.isDirectory())
+            n += await memoryContentCount(abs, depth + 1);
+        else if (name.toLowerCase().endsWith(".md") && !MEMORY_NON_CONTENT_MD.has(name.toLowerCase()))
+            n += 1;
+        if (n > 0)
+            return n;
+    }
+    return n;
 }
 /**
  * DecisionsディレクトリからCortex（Gold層）ルートを推定する。
@@ -289,7 +343,7 @@ function resolveKnowledgeRoot(decisionsDirAbs) {
     if (path.basename(decisionsDirAbs) === "records" && path.basename(parent) === "Decisions") {
         return path.dirname(parent);
     }
-    if (path.basename(decisionsDirAbs) === "Decisions" && path.basename(parent) === "Cortex") {
+    if (path.basename(decisionsDirAbs) === "Decisions" && (path.basename(parent) === "Cortex" || path.basename(parent) === "Memory")) {
         return parent;
     }
     return null;
@@ -1855,7 +1909,7 @@ function buildGraph(decisions, sections, targetUrls, repoBaseUrl, book = (0, evi
         if (ev)
             return addEvidence(ev);
         // 点にしない記録（Home・レポート・その他）へのパス参照は、根拠ではない。点を作らず数える
-        if (/(^|\/)Cortex\/(Home\.md|[^/]+\/records\/)/.test(target)) {
+        if (/(^|\/)(?:Cortex|Memory)\/(Home\.md|[^/]+\/records\/)/.test(target)) {
             unresolvedTargets++;
             return null;
         }
@@ -2438,11 +2492,36 @@ async function buildSite(opts, views) {
     // 解決するので、あとから作ると空の表・空の実在判定が渡り、**実在するパスまで
     // 「リンクにしない」に倒れて全滅する**（以前は順序が逆だった）。
     const repoRoot = knowledgeRoot ? path.dirname(knowledgeRoot) : path.dirname(dirAbs);
-    // 帳簿 9 本の置き場（既定は `<repoRoot>/.cortex`）。読み口はこの 1 つから読む（根拠の台帳はいつも `<repoRoot>/.cortex`）
+    // 記憶の置き場の名前（知識の根の名前から。`Cortex` ならこれまでと同じ出力）
+    const memoryDir = (0, memory_dir_1.memoryDirOfRoot)(knowledgeRoot);
+    // 帳簿 9 本の置き場（既定は `<repoRoot>/.cortex`）。読み口はこの 1 つから読む（根拠の台帳は組み直していない案件だけ `<repoRoot>/.cortex`）
     let ledgerDir = (0, ledger_dir_1.ledgerDirOf)(repoRoot, opts.ledgerDir);
-    // 記憶 v2 の画面用ファイル（cortex-engine #1094 鎖 3 V10b）。checkout の HEAD とそろう封筒だけを差し替えた合わせの置き場を読む
-    // 合わせの置き場を作れなかった回（一時フォルダの失敗など）は今の帳簿の置き場のまま組む（取り出しの失敗で画面を止めない・数は出さない）
-    if (opts.viewDir) {
+    // 設定の置き場のヒント（便 DS-8b）。組み直した案件（木に `Memory/Home.md`）だけ `table`。最初の描画（骨組みを出すか）だけに使い、応答の mode が勝つ
+    const configMode = await (0, config_mode_1.configModeHint)(repoRoot);
+    // 🔴 組み直した案件（v2・cortex-engine #1911 便 DC-2f・設計書 D-4）は封筒を無条件で採用し、帳簿 8 本と根拠の台帳（便 DC-2e）を `.cortex` から読まない。
+    // 封筒が無い・確かめられない回は投げる（空の画面を緑で配らない）。下の倒れ（catch）は組み直していない案件だけ
+    const rebuilt = configMode === "table";
+    if (rebuilt) {
+        if (!opts.viewDir)
+            throw new Error("組み直した案件（Memory/Home.md）のビルドには記憶側の画面用ファイル（--view-dir）が要ります（帳簿は .cortex から組みません）");
+        // 記憶がまだ 1 件も無い案件（組み直した直後で、記憶側がまだ画面用ファイルを 1 度も置いていない）は空の画面を組む（cortex-engine #1911 便 GV）。
+        // 🔴 空に倒れるのは「取り出した区画にファイルが 1 本も無い」かつ「読んだ決定と木の記憶の中身（記録・ストーリー）が 0 件」のときだけ。記録があるのに目次が無い・目次が空や壊れている・
+        // 封筒の欠けは、取り出しか公開が壊れている（今どおり赤）
+        const viewDirAbs = path.resolve(opts.viewDir);
+        const empty = mdFiles.length === 0 && (await viewDirIsEmpty(viewDirAbs)) && (await memoryContentCount(path.join(repoRoot, "Memory"))) === 0;
+        // 黙って緑にしない: 警告の 1 行を出す（記憶側の最初の通常の夜が目次を置けば、次のビルドから消える）
+        if (empty)
+            console.warn("記憶 v2 の画面用ファイル（組み直した案件）: 記憶がまだ 1 件も無く、記憶側の画面用ファイルもまだ 1 本も無いので、空の画面を組みます");
+        const plan = empty ? (0, view_dir_1.emptyPlanV2)() : await (0, view_dir_1.planViewsV2)(viewDirAbs);
+        const merged = await (0, view_dir_1.mergeViewsV2)(plan);
+        views.cleanup = merged.cleanup;
+        views.counts = plan.counts;
+        ledgerDir = merged.dir;
+        console.log((0, view_dir_1.viewCountsLineV2)(plan.counts));
+    }
+    else if (opts.viewDir) {
+        // 記憶 v2 の画面用ファイル（cortex-engine #1094 鎖 3 V10b）。checkout の HEAD とそろう封筒だけを差し替えた合わせの置き場を読む
+        // 合わせの置き場を作れなかった回（一時フォルダの失敗など）は今の帳簿の置き場のまま組む（取り出しの失敗で画面を止めない・数は出さない）
         try {
             const plan = await (0, view_dir_1.planViews)(path.resolve(opts.viewDir), (0, view_dir_1.checkoutGit)(repoRoot), ledgerDir);
             const merged = await (0, view_dir_1.mergeLedgerDir)(ledgerDir, plan);
@@ -2469,7 +2548,7 @@ async function buildSite(opts, views) {
     // 🔴 **強さ（`state` が on のときだけ中身が入る）だけの案件でも器を作る**——作らないと、活性度の帳簿を
     // 持たない案件で用語集が目次（engine の `termRows`）と違う順になる。
     // 確認の帳簿（`confirmation`）は並びには関係しない
-    const ledgers = await (0, rederivation_1.readRederivationLedgers)(repoRoot, ledgerDir);
+    const ledgers = await (0, rederivation_1.readRederivationLedgers)(repoRoot, ledgerDir, { v2: rebuilt });
     const rederive = ledgers.activity.size || ledgers.strength.size
         ? { ledgers: ledgers, repoRoot: repoRoot }
         : null;
@@ -2479,11 +2558,13 @@ async function buildSite(opts, views) {
     // 目次と同じ順位（engine #551）。**読めないなら `null`** で、つながり画面の点は今までどおり一律
     const memoryRanking = await (0, ranking_1.readMemoryRanking)(repoRoot, ledgerDir);
     // 根拠の台帳（便 B3）。**読めないなら `null`** で、根拠の段は記録に書かれた references のリンクだけ
-    const memoryEvidence = await (0, memory_evidence_1.readMemoryEvidence)(repoRoot); // 案件リポの .cortex から（--ledger-dir に従わない・memory-evidence.ts）
+    // 組み直していない案件は案件リポの .cortex から（--ledger-dir に従わない）。組み直した案件は封筒をほどいた置き場から（便 DC-2e・memory-evidence.ts）
+    const memoryEvidence = await (0, memory_evidence_1.readMemoryEvidence)(repoRoot, rebuilt ? ledgerDir : null);
     // 人の手の表の写し（engine #1094 q-10）。あれば記憶 v2 の案件で、確認の印とボタンを出さない。**無い案件は今と 1 バイトも同じ**（キーごと無い）
     // 「記憶 v2 の案件か」は 1 本の栓 `memory_v2_writer` の値で決める（cortex-engine #1094 鎖 3 V10b）。橋の間は写しとの OR
     const memoryHands = await (0, hands_1.readMemoryHands)(repoRoot, ledgerDir);
-    const memoryV2 = (0, hands_1.isMemoryV2)(opts.memoryV2Writer, memoryHands !== null);
+    // 組み直した案件（便 DC-2f）は記憶 v2 の案件（v1 の確認の帳簿を読まないので、確認の印とボタンを出さない）
+    const memoryV2 = (0, hands_1.isMemoryV2)(opts.memoryV2Writer, memoryHands !== null) || rebuilt;
     // 関係者の「つながっている ID」の出どころ（cortex-engine #1911 便 B4b）。`--view-dir` の中の平文を読むだけ。無い・読めない案件は何も付かない（今と 1 バイトも同じ）
     const memberOrigins = opts.viewDir ? await (0, member_origin_1.readMemberOrigins)(path.resolve(opts.viewDir)) : null;
     // 記録の id → リポジトリルート相対のパス（順位のファイルの鍵と突き合わせる。`repoRoot` 起点・cwd 起点にしない）
@@ -2637,9 +2718,9 @@ async function buildSite(opts, views) {
     // 名前のリンク（story.screen-name-links）: 日の relations の関係者・用語・ルールを、画面にある記録の表示名・別名・同義語で本文に当てる
     (targets) => (0, story_1.storyNameLinks)(targets, storyNameSources(sections)), 
     // 本文の相対リンク（決定の記録など）の飛び先: 画面に載る記録（決定・各区画）のパス → id
-    (repoPath) => idByRepoPath.get(repoPath));
+    (repoPath) => idByRepoPath.get(repoPath), memoryDir);
     // 週・月のあらすじ（#901）。週・月のファイルが無ければ null（キーごと出さない＝今までと同じ画面）
-    const storyDigest = await (0, story_1.readStoryDigest)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null, storyToday, ledgerDir);
+    const storyDigest = await (0, story_1.readStoryDigest)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null, storyToday, ledgerDir, memoryDir);
     // 案件アイコン（#348）。Cortex構成でなければ undefined（旧レイアウトには置き場が無い）
     const projectIcon = await findProjectIcon(knowledgeRoot);
     const site = {
@@ -2655,6 +2736,9 @@ async function buildSite(opts, views) {
         homeGrounding: homeGrounding,
         homeUpdatedAt: homeUpdatedAt,
         ...(memoryV2 ? { memoryV2: true } : {}),
+        // 組み直した案件（`Memory`）だけ印を出す。今までの案件はキーごと無い（出力を変えない）
+        ...(memoryDir === "Memory" ? { memoryDir } : {}),
+        ...(configMode ? { configMode } : {}),
         sections,
         graph,
         months,
@@ -2822,89 +2906,43 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch, ref
     };
 }
 /**
- * 記憶 v2 の決定の新しい欄の読み手（#1094）。
+ * 記憶 v2 の決定の新しい欄の読み手（#1094）と、関連の資料の欄 `related_materials` の読み手（cortex-engine #1094 F8）。
  *
- * 🔴 **写し。正本は cortex-engine `scripts/gold/decision-v2-fields.mjs` の `decisionV2FieldsOf`**。
- * 同じバイト列の表 `test/fixtures/decision-v2-fields-contract.json` を両リポに置き、
- * `test/supersedes-view.test.mjs` の「[契約] …」が全ケースを流す。規則を変えるときは engine の正本・この写し・表を同じ日に直す
+ * 原本は engine を束ねて引く（viewer/engine-src → dist/engine・便 R4）: `scripts/gold/decision-v2-fields.mjs` の
+ * `decisionV2FieldsOf`・`DECISION_FIRMNESS_READ_VALUES` と、`scripts/gold/related-materials-field.mjs` の `isRelatedUrl`・
+ * `relatedMaterialsRead`・`RELATED_URL_MAX`・`RELATED_MATERIALS_FIELD`。規則はここに書かない。
+ * 下の 3 つは欄 1 つの値を受ける viewer の薄い入口（原本は frontmatter 全体を受け、読めないとき `null`。viewer はキーごと載せないので `undefined`）。
+ * 題材は engine から組み立てる `test/fixtures/decision-v2-fields-contract.json`・`related-materials-contract.json`
+ * （`test/supersedes-view.test.mjs`・`test/related-materials-view.test.mjs` の「[契約] …」が流す）
  */
-/** 決定の固さの語彙（並びも正本と同じ） */
-exports.DECISION_FIRMNESS = ["確定", "仮", "検討中"];
-/** `decided_by` の要素が持ってよい鍵 */
-const DECIDED_BY_KEYS = ["member", "name", "url"];
-const MEMBER_ID_RE = /^member:\S/;
-const DECIDED_BY_URL_RE = /^https?:\/\/\S+$/;
-const isText = (v) => typeof v === "string" && v.trim() !== "";
+var related_materials_field_2 = require("./engine/related-materials-field");
+Object.defineProperty(exports, "isRelatedUrl", { enumerable: true, get: function () { return related_materials_field_2.isRelatedUrl; } });
+Object.defineProperty(exports, "relatedMaterialsRead", { enumerable: true, get: function () { return related_materials_field_2.relatedMaterialsRead; } });
+Object.defineProperty(exports, "RELATED_MATERIALS_FIELD", { enumerable: true, get: function () { return related_materials_field_2.RELATED_MATERIALS_FIELD; } });
+Object.defineProperty(exports, "RELATED_URL_MAX", { enumerable: true, get: function () { return related_materials_field_2.RELATED_URL_MAX; } });
+/** 決定の固さの語彙（受け付ける語彙・並びも原本の `DECISION_FIRMNESS_READ_VALUES`） */
+exports.DECISION_FIRMNESS = decision_v2_fields_1.DECISION_FIRMNESS_READ_VALUES;
 /** frontmatter の `firmness` → 語彙の 1 語。語彙外・文字列でないものは undefined（綴りはそのまま比べる） */
 function decisionFirmnessOf(value) {
-    return exports.DECISION_FIRMNESS.includes(value) ? value : undefined;
+    return (0, decision_v2_fields_1.decisionV2FieldsOf)({ firmness: value }).firmness ?? undefined;
 }
-/** frontmatter の `strand` → 筋の札の名前（前後の空白を落とす）。空・文字列でないものは undefined（`topic` は読まない） */
+/**
+ * frontmatter の `strand` → 筋の札の名前（前後の空白を落とす）。空・文字列でないものは undefined。
+ * 🔴 viewer は `topic` でなく `strand` を読む。原本の札の読み（`topic` の読み＝文字列で空でなければ trim）に `strand` の値を渡す
+ */
 function decisionStrandOf(value) {
-    return isText(value) ? value.trim() : undefined;
-}
-/** `decided_by` の要素 1 つ。読めなければ null（文字列・知らない鍵・member と name/url の同居・member: で始まらない・空の name・http(s) でない url） */
-function decidedByEntryOf(entry) {
-    if (entry == null || typeof entry !== "object" || Array.isArray(entry))
-        return null;
-    const o = entry;
-    if (Object.keys(o).some((k) => !DECIDED_BY_KEYS.includes(k)))
-        return null;
-    const has = (k) => Object.prototype.hasOwnProperty.call(o, k);
-    if (has("member")) {
-        if (has("name") || has("url"))
-            return null;
-        return typeof o.member === "string" && MEMBER_ID_RE.test(o.member) ? { member: o.member } : null;
-    }
-    if (!has("name") || !isText(o.name))
-        return null;
-    if (o.url == null)
-        return { name: o.name };
-    return typeof o.url === "string" && DECIDED_BY_URL_RE.test(o.url) ? { name: o.name, url: o.url } : null;
+    return (0, decision_v2_fields_1.decisionV2FieldsOf)({ topic: value }).topic ?? undefined;
 }
 /**
- * frontmatter の `decided_by` → 決めた人の並び。🔴 形の崩れた要素は**飛ばす**。
+ * frontmatter の `decided_by` → 決めた人の並び。形の崩れた要素は**飛ばす**（原本の読み）。
  * 欄がリストでなければ undefined（無いものとして扱う）。空のリストは []
  */
 function decidedByOf(value) {
-    if (!Array.isArray(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) : [];
+    return (0, decision_v2_fields_1.decisionV2FieldsOf)({ decided_by: value }).decidedBy ?? undefined;
 }
 /** 画面に載せる形（名前は根拠と同じ解決＝帳の題名・URL の種類の名前）。通る URL が 0 本なら undefined（キーごと載せない） */
 function relatedMaterialsView(fm, refs) {
-    const urls = relatedMaterialsRead(fm);
+    const urls = (0, related_materials_field_1.relatedMaterialsRead)(fm);
     if (!urls.length)
         return undefined;
     return urls.map((u) => {

package/dist/canonical-evidence.js

@@ -1,196 +1,16 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syntaxNormalizedUrl = exports.githubRefToken = exports.canonicalEvidence = void 0;
 /**
- * **根拠の名前の正規化**（cortex-engine #968 設計 v3 §1.4）。
- *
- * 正本は cortex-engine `scripts/gold/ref-tokens.mjs#canonicalEvidence`。ここはその TypeScript の写し
- * （ビューアは engine のコードを import できないので、ロジックごと複製する）。
+ * **根拠の名前の正規化**（cortex-engine #968 設計 v3 §1.4）の viewer の入口。
  *
- * 🔴 **写しを直したら、`test/fixtures/evidence-canonical-cases.json`（両リポに同じバイトで置く）で
- * 両方の実装が同じ答えを返すことを確かめる。** 手で見比べて直すと、どちらかの枝だけ直って
- * 静かに食い違う。
+ * 原本は engine を束ねて引く（viewer/engine-src → dist/engine・便 R4）: cortex-engine `scripts/gold/ref-tokens.mjs` の
+ * `canonicalEvidence`・`syntaxNormalizedUrl`・`githubRefToken`。規則はここに書かない（ctx の Map／Record の両対応も原本が持つ）。
+ * 題材は engine から組み立てる `test/fixtures/evidence-canonical-cases.json`（`test/canonical-evidence.test.mjs` が流す）。
  *
- * 比べるのは `key`、画面がリンク先として使うのは `url`。課題と GitHub の `key` は engine の
- * 既存の印（`refTokens`）と同じ綴り（小文字の課題キー・`gh:o/r#N`）——ビューアの他の場所
- * （課題キーをそのまま ID にする `classifyTarget` の旧経路）と当たり方をそろえるため。
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.githubRefToken = void 0;
-exports.syntaxNormalizedUrl = syntaxNormalizedUrl;
-exports.canonicalEvidence = canonicalEvidence;
-/** 課題キーだけの値（`PJ_CORTEX-12`）。engine の `ISSUE_KEY_RE` と同じ形の全体一致 */
-const WHOLE_ISSUE_KEY_RE = /^([A-Z][A-Z0-9_]{1,20})-(\d+)$/;
-/** `owner/repo#N` だけの値 */
-const WHOLE_GH_SHORT_RE = /^([A-Za-z0-9._-]+)\/([A-Za-z0-9._-]+)#(\d+)$/;
-/** スキーム・ホスト・残り（パス・クエリ・断片） */
-const URL_PARTS_RE = /^(https?):\/\/([^/?#\s]+)([^\s]*)$/i;
-/** GitHub の issue / PR を指す 2 つの綴りを同じ印にする（engine `githubRefToken` と同じ） */
-const githubRefToken = (owner, repo, num) => `gh:${String(owner).toLowerCase()}/${String(repo).toLowerCase()}#${num}`;
-exports.githubRefToken = githubRefToken;
-/**
- * URL の構文の正規化（RFC 3986 §6.2.2）。スキームとホストを小文字・既定のポートを落とす・`%xx` を大文字・
- * 末尾の句読点と末尾の `/` を落とす。日本語はエンコードしない。URL でなければ `null`。
- */
-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+$/, "");
-    }
-    const rest = m[3].replace(/%[0-9a-f]{2}/gi, (x) => x.toUpperCase()).replace(/\/+(?=$|[?#])/, "");
-    return `${scheme}://${host}${rest}`;
-}
-/**
- * 値全体が URL 1 本の形のときだけ、その URL を返す（素の URL・`[ラベル](URL)`・Slack の `<URL|ラベル>`）。
- * パスに URL を添えた値・文の中に URL がある値は `null`。Markdown のエスケープ（`PJ\_CORTEX`）は外す
- */
-function wholeUrlOf(value) {
-    const v = 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;
-}
-function toMap(v) {
-    if (v instanceof Map)
-        return v;
-    return new Map(Object.entries(v ?? {}));
-}
-const 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 ? undefined : h));
-};
-const pathOf = (rest) => rest.replace(/[?#].*$/, "");
-const fragmentOf = (rest) => {
-    const h = rest.indexOf("#");
-    return h < 0 ? "" : rest.slice(h + 1);
-};
-const GDOC_KINDS = new Set(["document", "spreadsheets", "presentation", "forms"]);
-const BACKLOG_HOST_RE = /\.(?:backlog\.jp|backlog\.com|backlogtool\.com)$/;
-/** 種類ごとの解き方（URL を構文正規化した後）。当たらなければ汎用の `url` 種に落ちる */
-function canonicalOfUrl(url, ctx) {
-    const m = url.match(URL_PARTS_RE);
-    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-z]+)\/(?:u\/\d+\/)?d\/([A-Za-z0-9_-]{10,})/);
-        if (g && GDOC_KINDS.has(g[1])) {
-            return { kind: "gdoc", key: `gfile:${g[2]}`, url: `https://docs.google.com/${g[1]}/d/${g[2]}` };
-        }
-        const fd = p.match(/^\/file\/d\/([A-Za-z0-9_-]{10,})/);
-        if (fd)
-            return { kind: "drive", key: `gfile:${fd[1]}`, url: `https://drive.google.com/file/d/${fd[1]}/view` };
-    }
-    if (host === "drive.google.com") {
-        const f = p.match(/^\/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: `gfile:${id}`, url: `https://drive.google.com/file/d/${id}/view` };
-        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 = toMap(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 = (0, exports.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 };
-}
-/**
- * 根拠の名前の正規化。解けない入力（Gold の ID・`minute:`・`material:`・`design:`・リポのパス・
- * ホストの決まらない課題キー・URL が 2 本以上の値）は `null`。engine 版と 1:1 対応。
+ * 比べるのは `key`、画面がリンク先として使うのは `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 = toMap(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;
-}
+var ref_tokens_1 = require("./engine/ref-tokens");
+Object.defineProperty(exports, "canonicalEvidence", { enumerable: true, get: function () { return ref_tokens_1.canonicalEvidence; } });
+Object.defineProperty(exports, "githubRefToken", { enumerable: true, get: function () { return ref_tokens_1.githubRefToken; } });
+Object.defineProperty(exports, "syntaxNormalizedUrl", { enumerable: true, get: function () { return ref_tokens_1.syntaxNormalizedUrl; } });

package/dist/change-log.js

@@ -46,7 +46,7 @@ exports.CHANGE_LOG_MAX_ROWS = 50;
 /** `why` は 1 行 3 本まで（engine の `WHY_MAX`）。これも画面の表示の絞り（`common.delete-cap-exceptions`・元のリンクはコミットに残る） */
 const WHY_MAX = 3;
 /** 載る記録のパス（4 区画の記録。README・雛形・入れ子は載らない） */
-const RECORD_PATH = /^Cortex\/(Decisions|Glossary|Members|Rules)\/records\/[^/]+\.md$/;
+const RECORD_PATH = /^(?:Cortex|Memory)\/(Decisions|Glossary|Members|Rules)\/records\/[^/]+\.md$/;
 const isObj = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 /** メールの形（URL の部分を除いて見る） */
 // engine `change-log.mjs` の定義と同じ（緩めると、URL の後ろのメールや非 ASCII のローカル部が通る）