@takagaki/cortex-decisions-viewer 0.12.83 → 0.12.85

package/README.md

@@ -40,7 +40,7 @@ cortex-decisions-viewer build [dir] [options]
 | --- | --- | --- |
 | `[dir]` | `Decisions` | Decisionsディレクトリ（リポジトリルートからの相対 or 絶対） |
 | `-o, --out <dir>` | `site` | 出力ディレクトリ |
-| `-t, --title <title>` | `Decisions` | サイトタイトル |
+| `-t, --title <title>` | `Decisions` | サイトタイトル（`Cortex/Home.md` の frontmatter `project` が読めればそちらを優先。これは読めないときの控え） |
 | `--repo-url <url>` | （git remoteから解決） | GitHubリポジトリURL。CIで git remote が引けない場合に明示指定 |
 | `--branch <branch>` | `main`（環境変数 `AWS_BRANCH` があればそれ） | 編集リンク・参照リンクが指すブランチ |
 | `--exclude <files...>` | （なし） | 一覧から除外する追加ファイル名。既定で `README.md` / `template.md` は除外 |

package/dist/build.js

@@ -96,6 +96,7 @@ function takeProposals(filePath) {
     return hit;
 }
 const external_id_1 = require("./external-id");
+const home_project_1 = require("./home-project");
 const render_1 = require("./render");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
@@ -141,6 +142,10 @@ const SANITIZE_OPTIONS = {
         // タスクリスト `- [ ]` / `- [x]` のチェック状態を残すのに要る。
         // 落とすと**装飾ではなく情報（未完了/完了の別）が消える**
         "input",
+        // 折りたたみ（#702）。engine が関係者の記録の末尾に「この人が関わった決定」を
+        // details で畳んで書く。落とすと一覧が常時展開のベタテキストになる。
+        // 属性は 1 つも許可しない（open も通さない＝常に閉じた状態で出る）
+        "details", "summary",
     ],
     allowedAttributes: {
         a: ["href", "target", "rel"],
@@ -213,6 +218,8 @@ async function renderGroundingSection(markdown) {
  */
 function toSearchText(md) {
     return md
+        .replace(/<!--[\s\S]*?-->/g, " ") // HTML コメント（engine の機械ブロックの印など・画面にも出ない）
+        .replace(/<\/?(details|summary)>/g, " ") // 折りたたみのタグ（#702）。文字は検索に要らない
         .replace(/!\[[^\]]*\]\([^)]*\)/g, " ") // 画像
         .replace(/\[([^\]]*)\]\([^)]*\)/g, "$1") // リンクはラベルだけ残す
         .replace(/[#>*_~`|]+/g, " ") // markdown記号・表の罫線
@@ -2075,12 +2082,15 @@ async function build(opts) {
     let home = null;
     let homeGrounding;
     let homeUpdatedAt;
+    // Home.md の本文（ヘッダーの案件名を frontmatter の `project` から決めるため。無ければ null）
+    let homeRaw = null;
     const sections = [];
     // グラフに渡す区画（**並べ替える前**の配列を持つ。上の sections とレコードの実体は同じ）
     const graphSections = [];
     if (knowledgeRoot) {
         try {
             const raw = await node_fs_1.promises.readFile(path.join(knowledgeRoot, "Home.md"), "utf8");
+            homeRaw = raw;
             home = await parseGeneric(raw, "Home.md", toRepoRelative(knowledgeRoot), repo.baseUrl, repo.branch);
             // 自己記述の節を取り出し、**本文からは抜く**（最上部に出すので、残すと2度出る）。
             // 旧い使い方の説明もここで落ちる（説明はビューアが持つようになった）
@@ -2188,7 +2198,8 @@ async function build(opts) {
     // 案件アイコン（#348）。Cortex構成でなければ undefined（旧レイアウトには置き場が無い）
     const projectIcon = await findProjectIcon(knowledgeRoot);
     const site = {
-        title: opts.title,
+        // 🔴 **案件名の正本は Home.md の `project`**（engine #699 F10）。`--title` は読めないときの控え
+        title: (0, home_project_1.resolveSiteTitle)(homeRaw, opts.title),
         generatedAt: opts.generatedAt,
         // **package.json から読む。** 手で書くと、上げ忘れて嘘の版が出る
         viewerVersion: PKG_VERSION,

package/dist/cli.js

@@ -12,7 +12,7 @@ program
     .description("Decisionsディレクトリを静的サイトにビルドする")
     .argument("[dir]", "Decisionsディレクトリ（未指定なら Cortex/Decisions/records → Cortex/Decisions → Decisions の順で自動検出）")
     .option("-o, --out <dir>", "出力ディレクトリ", "site")
-    .option("-t, --title <title>", "サイトタイトル", "Decisions")
+    .option("-t, --title <title>", "サイトタイトル（Cortex/Home.md の project が読めればそちらを優先。これは読めないときの控え）", "Decisions")
     .option("--repo-url <url>", "GitHubリポジトリURL（未指定なら git remote から解決）")
     .option("--branch <branch>", "編集リンクが指すブランチ（既定: main / 環境変数 AWS_BRANCH）")
     .option("--exclude <files...>", "一覧から除外する追加ファイル名（既定で README.md / template.md は除外）", [])

package/dist/engagement.js

@@ -78,6 +78,8 @@ exports.WEIGHTS = Object.freeze({
     "record.confirmed": 2.0,
     "record.edited": 2.0,
     "record.deleted": 0,
+    // 本文を取り込んだ（engine #695）。人の行為ではないので 0（話した人は `utterance.spoken` で数える）
+    "body.captured": 0,
 });
 const DAY_MS = 86400000;
 const cmp = (a, b) => (a < b ? -1 : a > b ? 1 : 0);

package/dist/home-project.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * `Cortex/Home.md` の frontmatter `project`（案件の表示名）を読む（engine #699 F10）。
+ *
+ * ## なぜビューアが自分で読むのか
+ *
+ * 案件の表示名の**正本は Home.md の `project`**（`title` は頁の名前 "Home" で、表示名ではない）。
+ * これまでヘッダーの案件名は `--title`（engine の viewer-config.json の title、旧 Amplify は
+ * `viewerTitle ?? key`）の写しだけを見ていたので、Home.md で改名しても写しを直すまで
+ * ヘッダーが古い名前のままだった。build の時点で Home を読んでいるので、ここで正本を直接見る。
+ * 読めないとき（Home が無い・`project` が空・`{{プロジェクト名}}` のまま等）は `--title` に倒す。
+ *
+ * ## 読み方は infra の正本の写し
+ *
+ * 正本は `infra/scripts/lib/home-md.mjs` の `parseHomeProjectName`（名簿・Apps Script と同じ規則）。
+ * ビューアは npm で配る別パッケージなので import できず、写しを持つ。
+ * **規則を変えるときは両側を同じ便で直すこと。** 一致は `viewer/test/home-grounding.test.mjs` の
+ * parity の節が、infra の題材（`infra/test/fixtures/home-md-cases.mjs`・通る題材と弾く題材の両方）で検査する。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHomeProjectName = parseHomeProjectName;
+exports.resolveSiteTitle = resolveSiteTitle;
+/** 区切り行か（`---`。行末の空白は許す） */
+const isDelimiter = (line) => /^---[ \t]*$/.test(line);
+/** `project:` の右側を値にする（正本の `parseScalar` と同じ規則） */
+function parseScalar(rest) {
+    const raw = rest.trim();
+    if (raw === "")
+        return { ok: false, reason: "EMPTY" };
+    const q = raw.charAt(0);
+    if (q === '"') {
+        let out = "";
+        for (let i = 1; i < raw.length; i += 1) {
+            const c = raw.charAt(i);
+            if (c === "\\") {
+                // `\"` と `\\` だけを剥がす（他のエスケープは原文のまま）
+                const n = raw.charAt(i + 1);
+                if (n === '"' || n === "\\") {
+                    out += n;
+                    i += 1;
+                    continue;
+                }
+                out += c;
+                continue;
+            }
+            if (c === '"')
+                return { ok: true, value: out };
+            out += c;
+        }
+        return { ok: false, reason: "BROKEN_VALUE" };
+    }
+    if (q === "'") {
+        let out = "";
+        for (let i = 1; i < raw.length; i += 1) {
+            const c = raw.charAt(i);
+            if (c === "'") {
+                if (raw.charAt(i + 1) === "'") {
+                    out += "'";
+                    i += 1;
+                    continue;
+                }
+                return { ok: true, value: out };
+            }
+            out += c;
+        }
+        return { ok: false, reason: "BROKEN_VALUE" };
+    }
+    // 裸の値: 空白の後ろの `#` から先はコメント。行頭の `#` は値が無いのと同じ
+    if (q === "#")
+        return { ok: false, reason: "EMPTY" };
+    const bare = (/^(.*?)(?:[ \t]+#.*)?$/.exec(raw) ?? [raw, raw])[1].trim();
+    // YAML の null は「無い」
+    if (bare === "null" || bare === "~")
+        return { ok: false, reason: "EMPTY" };
+    // 1 行の文字列以外（ブロックスカラー・flow・アンカー／エイリアス／タグ）は読まない
+    if (/^[|>][+-]?$/.test(bare) || /^[\[{&*!]/.test(bare))
+        return { ok: false, reason: "UNSUPPORTED" };
+    return { ok: true, value: bare };
+}
+/** Home.md の本文から `project` を読む（純関数。正本 `parseHomeProjectName` の写し） */
+function parseHomeProjectName(markdown) {
+    const text = String(markdown ?? "").replace(/^/, "").replace(/\r\n?/g, "\n");
+    const lines = text.split("\n");
+    if (lines.length === 0 || !isDelimiter(lines[0]))
+        return { ok: false, reason: "NO_FRONTMATTER" };
+    let end = -1;
+    for (let i = 1; i < lines.length; i += 1) {
+        if (isDelimiter(lines[i])) {
+            end = i;
+            break;
+        }
+    }
+    if (end < 0)
+        return { ok: false, reason: "UNCLOSED_FRONTMATTER" };
+    for (let i = 1; i < end; i += 1) {
+        const m = /^project:(.*)$/.exec(lines[i]);
+        if (!m)
+            continue;
+        const scalar = parseScalar(m[1]);
+        if (!scalar.ok)
+            return scalar;
+        const value = scalar.value.trim();
+        if (value === "")
+            return { ok: false, reason: "EMPTY" };
+        if (/\{\{[\s\S]*\}\}/.test(value))
+            return { ok: false, reason: "PLACEHOLDER" };
+        return { ok: true, project: value };
+    }
+    return { ok: false, reason: "MISSING" };
+}
+/**
+ * ヘッダーに出す案件名を決める。Home.md の `project` が読めればそれ、読めなければ `--title`。
+ * @param homeRaw Home.md の本文（無ければ null）
+ * @param fallback `--title` の値
+ */
+function resolveSiteTitle(homeRaw, fallback) {
+    if (homeRaw == null)
+        return fallback;
+    const parsed = parseHomeProjectName(homeRaw);
+    return parsed.ok ? parsed.project : fallback;
+}

package/dist/rederivation.js

@@ -289,6 +289,41 @@ function normalizeForCompare(text) {
  * 使われない 1 行（`side: cm`）が移行で消えたことだった。`identities` のような欄が
  * 足された晩に、説明文が 1 文字も変わっていないのに印を立てない。
  */
+/** engine が関係者の記録の末尾に毎晩書く「この人が関わった決定」の印（#702） */
+const MEMBER_DECISIONS_START = "<!-- cortex-engine:member-decisions -->";
+const MEMBER_DECISIONS_END = "<!-- /cortex-engine:member-decisions -->";
+/**
+ * 本文から engine の機械ブロック（「この人が関わった決定」）を取り除く（#702）。
+ *
+ * 🔴 **engine の写し（`scripts/rederive/content-sha.mjs`）と同じ規則。** 変えたら両方を変える。
+ * 開始の印**だけ**の行（行末の `\r` は無視）から、終了の印**だけ**の行までを（両端を含めて）消す。終了の印が
+ * 無ければ本文の終わりまで消す。塊の前後の空行も除き、両側に本文が残れば空行 1 行でつなぐ。そのあと末尾の空行を落とす。ブロックの無い本文は触らない。
+ *
+ * 毎晩書き換わる機械の一覧を「人が確認した版から中身が変わっています」に数えないため。
+ * ブロックの外を人が 1 文字でも直せば、従来どおり指紋は変わる。
+ */
+function stripMemberDecisions(body) {
+    const lines = body.split("\n");
+    // 行末の `\r` は見ない（CRLF の記録でも印の行として当てる。当てないと毎晩印が立つ）
+    const is = (marker) => (line) => line.replace(/\r$/, "") === marker;
+    const start = lines.findIndex(is(MEMBER_DECISIONS_START));
+    if (start < 0)
+        return body;
+    const endRel = lines.slice(start + 1).findIndex(is(MEMBER_DECISIONS_END));
+    const end = endRel < 0 ? lines.length : start + 1 + endRel + 1;
+    const isBlank = (line) => line.trim() === "";
+    // 塊の前後の空行も一緒に除き、両側に本文が残れば空行 1 行でつなぐ（engine の書き手と同じ規則・#702 実装レビュー R1）
+    const before = lines.slice(0, start);
+    while (before.length && isBlank(before[before.length - 1]))
+        before.pop();
+    const after = lines.slice(end);
+    while (after.length && isBlank(after[0]))
+        after.shift();
+    const kept = [...before, ...(before.length && after.length ? [""] : []), ...after];
+    while (kept.length && isBlank(kept[kept.length - 1]))
+        kept.pop();
+    return kept.join("\n");
+}
 function comparableContent(raw) {
     let data = {};
     let content = String(raw ?? "");
@@ -303,7 +338,7 @@ function comparableContent(raw) {
     }
     return {
         description: normalizeForCompare(String(data.description ?? "")),
-        body: normalizeForCompare(content),
+        body: normalizeForCompare(stripMemberDecisions(content)),
     };
 }
 /** 2 つの版で「説明文と本文」が同じか（frontmatter の他の欄の差は見ない） */

package/dist/render.js

@@ -5741,6 +5741,10 @@ button.ops-card-btn:disabled { opacity: .6; cursor: default; }
 .body pre code { background: none; padding: 0; color: inherit; }
 .body table { border-collapse: collapse; width: 100%; }
 .body th, .body td { border: 1px solid var(--border); padding: 6px 10px; text-align: left; }
+/* 本文中の折りたたみ（#702・関係者の記録の「この人が関わった決定」）。見出しの 1 行を押して開く */
+.body details { margin: 12px 0; }
+.body details > summary { cursor: pointer; }
+.body details[open] > summary { margin-bottom: 8px; }
 .body-loading { color: var(--muted); font-size: 13px; padding: 8px 2px; }
 
 /* 一行の結果表示（トースト）。#348 の案件アイコンで使う。

package/package.json

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