@takagaki/cortex-decisions-viewer 0.12.84 → 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 を唯一の出どころにする。**
@@ -2081,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度出る）。
             // 旧い使い方の説明もここで落ちる（説明はビューアが持つようになった）
@@ -2194,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/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/package.json

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