@takagaki/cortex-decisions-viewer 0.12.116 → 0.12.118

package/dist/build.js

@@ -41,7 +41,8 @@ exports.sanitizeBody = sanitizeBody;
 exports.findProjectIcon = findProjectIcon;
 exports.readFleetSources = readFleetSources;
 exports.attachRederived = attachRederived;
-exports.attachDecisionFollowup = attachDecisionFollowup;
+exports.humanTouchedOf = humanTouchedOf;
+exports.attachHumanTouched = attachHumanTouched;
 exports.rawFrontmatterDate = rawFrontmatterDate;
 exports.attachSupersedes = attachSupersedes;
 exports.readGoldProposals = readGoldProposals;
@@ -110,6 +111,8 @@ function takeProposals(filePath) {
 const external_id_1 = require("./external-id");
 const home_project_1 = require("./home-project");
 const supersedes_1 = require("./supersedes");
+const confirmed_1 = require("./confirmed");
+const minify_1 = require("./minify");
 const render_1 = require("./render");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
@@ -784,29 +787,37 @@ readBlobs = repo_1.readBlobsAt) {
     return (0, rederivation_1.orderByActivity)(records, pathOf, statusOf, ctx.ledgers, nowIso);
 }
 /**
- * 決定に「その後」（`.cortex/gold-decision-followup.json`・#705）を載せる。
+ * 記録に人の手があるか（cortex-engine #1094 段 4・削除の確認の文面を替える材料）。
  *
- * 🔴 **突き合わせはビルド時にここで閉じる**（`attachRederived` と同じ）。path は
- * **`repoRoot` 起点**で作る——帳簿の鍵は常にリポジトリルート相対（`Cortex/Decisions/records/…`）。
- * 画面に出す状態の結び付きが 1 件も無い決定には**キーごと付けない**（`shownFollowupOf`）。
+ * 次のどちらかで真:
+ *   1. status が人の値（口の `humanOwned`・区画の語彙。旧い記録の「確認済み」）
+ *   2. 確認の帳簿（`.cortex/gold-confirmation.json`）にその path の `confirmed` の行がある（消した行を除く）
  *
- * @returns 帳簿の行のうち、どの決定にも突き合わなかった path（ビルドログに 1 行出す材料）
+ * 🔴 **ビルドの git は使わない**（確定版 0 章 7）。cortex-bot の夜のコミットを人と数え、浅い clone では
+ * 全部が人になるため。engine の人の手の表がビューアに届く段 5 で差し替える。
+ * 取りこぼしの代償は「確認の一言が出ない」だけ（消せる範囲は変わらない）。
+ *
+ * @param p リポジトリルート相対の path（`Cortex/<区画>/records/…`）。帳簿の鍵は NFC なので NFC でも引く
+ * @param status その記録の `rstatus`（`String()` 済み）
  */
-function attachDecisionFollowup(decisions, recordsDir, repoRoot, ledger) {
+function humanTouchedOf(p, status, confirmation) {
+    if ((0, confirmed_1.humanOwned)(p, status))
+        return true;
+    const row = confirmation.get(p) ?? confirmation.get(p.normalize("NFC"));
+    return !!row && row.deleted !== true;
+}
+/**
+ * 区画の記録に人の手の印（`humanTouched: true`）を載せる。**人の手が無い記録にはキーごと付けない**
+ * （今の SiteData の形を保つ）。path は `repoRoot` 起点で作る（帳簿の鍵はリポジトリルート相対）。
+ * 置き換えの逆引き（`attachSupersedes`）より前に呼ぶ。
+ */
+function attachHumanTouched(records, recordsDir, repoRoot, confirmation) {
     const recordsRel = path.relative(repoRoot, recordsDir).split(path.sep).join("/");
-    const matched = new Set();
-    for (const d of decisions) {
-        // 帳簿の鍵（git 由来）は NFC。readdir が NFD で返す環境でも突き合うように揃える
-        const p = (recordsRel ? `${recordsRel}/${d.fileName}` : d.fileName).normalize("NFC");
-        const row = ledger.get(p);
-        if (!row)
-            continue;
-        matched.add(p);
-        const shown = (0, rederivation_1.shownFollowupOf)(row);
-        if (shown)
-            d.followup = shown;
+    for (const r of records) {
+        const p = recordsRel ? `${recordsRel}/${r.fileName}` : r.fileName;
+        if (humanTouchedOf(p, r.rstatus, confirmation))
+            r.humanTouched = true;
     }
-    return [...ledger.keys()].filter((k) => !matched.has(k.normalize("NFC")));
 }
 /**
  * 決定に置き換えの逆引き（置き換え先・置き換えた決定）を載せる（cortex-engine #699 F3・A-1'）。
@@ -2465,19 +2476,10 @@ async function build(opts) {
         if (rd !== undefined)
             rawDates.set(rec, rd);
     }
+    // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）。**置き換えより前に・repoRoot で**
+    attachHumanTouched(decisions, dirAbs, repoRoot, ledgers.confirmation);
     // 置き換えの逆引き（#699 F3）。**置き換えの無い案件では 1 件も付かない**
     attachSupersedes(decisions, (d) => rawDates.get(d) ?? d.fm.date);
-    // 決定の「その後」（#705）。**帳簿を持たない案件では 1 件も付かず、絞り込みの印も立たない**
-    // （`decisionFollowup` はキーごと無い＝今までと 1 バイトも同じ画面）
-    const followupLedger = await (0, rederivation_1.readDecisionFollowup)(repoRoot);
-    if (followupLedger) {
-        const unmatchedFollowup = attachDecisionFollowup(decisions, dirAbs, repoRoot, followupLedger);
-        // **突き合わなかった行を 1 行残す**（path が 1 文字違うだけで画面から静かに消えるので）
-        if (unmatchedFollowup.length) {
-            console.warn(`gold-decision-followup.json: 決定に突き合わない行が ${unmatchedFollowup.length} 件ありました（表示しません）: ` +
-                unmatchedFollowup.slice(0, 3).join(", ") + (unmatchedFollowup.length > 3 ? " ほか" : ""));
-        }
-    }
     let home = null;
     let homeGrounding;
     let homeUpdatedAt;
@@ -2517,6 +2519,8 @@ async function build(opts) {
                 continue;
             const recordsDir = path.join(knowledgeRoot, e.name, "records");
             const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
+            // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）
+            attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation);
             // 「人が確認した版から変わりました」の帯と、用語集の並び（#665 便 12b）。
             // **帳簿を持たない案件では 1 件も付かず、並びもそのまま**（下の attachRederived）
             const rederived = await attachRederived(records, recordsDir, rederive, opts.generatedAt);
@@ -2574,6 +2578,17 @@ async function build(opts) {
         console.warn(`gold-proposals.json: レコードに突き合わない提案が ${unmatched.length} 件ありました（表示しません）: ` +
             unmatched.slice(0, 5).join(", ") + (unmatched.length > 5 ? " ほか" : ""));
     }
+    // 画面に出さなくなった提案（名寄せ以外・#1094 35d）の件数。**人の操作は足さず、ログに 1 行だけ残す**
+    // （kind が identity でない提案は、記録に載っていても画面のどこにも出ない）
+    let hiddenProposals = 0;
+    for (const [k, list] of PROPOSALS_BY_PATH) {
+        if (!PROPOSAL_PATHS_MATCHED.has(k))
+            continue;
+        hiddenProposals += list.filter((p) => p.kind !== "identity").length;
+    }
+    if (hiddenProposals) {
+        console.warn(`gold-proposals.json: 名寄せ以外の提案が ${hiddenProposals} 件あります（画面には出しません）`);
+    }
     const graph = buildGraph(decisions, home, graphSections, targetUrls, repo.baseUrl, evidenceBook);
     computeLayout(graph); // 各ノードに x/y を書き込む（クライアントはこれを初期位置に使いウォームアップ省略）
     // 点の明るさと大きさ（engine #551）。順位のファイルが読めない案件では 1 点も付かない（今までと同じ画面）
@@ -2622,7 +2637,6 @@ async function build(opts) {
             }
             : undefined,
         // 帳簿を読めた案件だけ true（無い・壊れ・版違いはキーごと出さない）
-        decisionFollowup: followupLedger ? true : undefined,
         meetings,
         // **URLとトークンが両方そろったときだけ出す。** 片方だけでは貼れるURLを作れないので、
         // 手順だけが出て「専用URLが空」という一番混乱する形になる（intake と同じ扱い）
@@ -2702,7 +2716,10 @@ async function build(opts) {
     // 配置側（cortex-engine の build-viewer.yml）の責務: aws s3 sync --delete が
     // 古いハッシュのファイルを消すこと、index.html に Cache-Control: no-cache を
     // 付けること（assets/ は内容ハッシュ名なので長期キャッシュでよい）。
-    const assetSources = (0, render_1.viewerAssetSources)();
+    // 🔴 **配る JS は縮めてから名前を決める**（ハッシュは縮めた後の中身から。コメント由来の実名を配信物に載せない・#731 便 4）。
+    // `viewerAssetSources()` の素の JS は埋め込み形（renderSite）とテストが読むので縮めない
+    const rawAssetSources = (0, render_1.viewerAssetSources)();
+    const assetSources = { css: rawAssetSources.css, js: (0, minify_1.minifyClientJs)(rawAssetSources.js) };
     const assets = (0, render_1.viewerAssetNames)(assetSources);
     await node_fs_1.promises.mkdir(path.join(outAbs, "assets"), { recursive: true });
     await node_fs_1.promises.writeFile(path.join(outAbs, assets.css), assetSources.css, "utf8");

package/dist/minify.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MINIFY_OPTIONS = void 0;
+exports.minifyClientJs = minifyClientJs;
+const esbuild_1 = require("esbuild");
+/**
+ * 画面の JS（`assets/viewer.<hash>.js`）を配る前に縮める（cortex-engine #731 便 4）。
+ *
+ * 配る JS はテンプレート文字列として書いた約 15,000 行で、コメントに案件名・社内の事情が入っている。
+ * そのまま書き出すと、お客様の組織の画面のソースにも読める形で載る。ここで**コメントと余分な空白を落とす**。
+ *
+ * 🔴 **空白とコメントだけを落とす（名前の短縮・構文の書き換えはしない）。** `.toString()` で埋め込んだ関数や
+ * 名前に頼る所を壊さないため。`charset: "utf8"` は日本語の文言を `\uXXXX` に展開させない（既定の ascii だと
+ * 読めず、かえって大きくなる）。`legalComments: "none"` は `/*!` 系も残さない。
+ *
+ * ⚠️ 番人（`test/shipped-js-minified.test.mjs`）は同じオプションを**わざと直書き**している（ここを再利用すると、縮めを恒等にされても緑になる）。
+ * ここを変えたら番人の直書きも同じにすること。
+ *
+ * 🔴 **失敗しても素のコメント入りで配らない**（例外のまま build を赤にする）。縮めに失敗した画面を黙って配ると、
+ * 番人（`test/shipped-js-minified.test.mjs`）の外で実名が載る。
+ */
+exports.MINIFY_OPTIONS = {
+    minifyWhitespace: true,
+    charset: "utf8",
+    legalComments: "none",
+};
+function minifyClientJs(js) {
+    return (0, esbuild_1.transformSync)(js, exports.MINIFY_OPTIONS).code;
+}

package/dist/rederivation.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HUMAN_FOLLOWUP_STATES = exports.FOLLOWUP_EVIDENCE_VERDICTS = exports.FOLLOWUP_SHOWN_STATES = exports.DECISION_FOLLOWUP_FILE = exports.emptyLedgers = exports.TERM_STRENGTH_FILE = exports.LEDGER_VERSION = void 0;
+exports.HUMAN_FOLLOWUP_STATES = exports.emptyLedgers = exports.TERM_STRENGTH_FILE = exports.LEDGER_VERSION = void 0;
 exports.isConfirmedStatus = isConfirmedStatus;
 exports.parseLedger = parseLedger;
 exports.readRederivationLedgers = readRederivationLedgers;
@@ -17,8 +17,6 @@ exports.rederivedContentKey = rederivedContentKey;
 exports.rederivedBandOf = rederivedBandOf;
 exports.orderByActivity = orderByActivity;
 exports.followupDateOf = followupDateOf;
-exports.readDecisionFollowup = readDecisionFollowup;
-exports.shownFollowupOf = shownFollowupOf;
 exports.humanFollowupOf = humanFollowupOf;
 /**
  * 再導出の 3 帳簿（＋用語の強さの帳簿）を読み、帯「人が確認した版から変わりました」と用語集の並びを作る（#665 便 12b）。
@@ -76,9 +74,9 @@ const MIN_ELAPSED_DAYS = 0.5;
  * （`rec.fm.status`）を渡さない——YAML は真偽値も配列も返すので、札と同じ文字列にならない
  * （口は文字列・null・undefined のほかを投げる）。
  *
- * ⚠️ **「確認済み」の門はもう 1 つある。** 削除の口の出し分けは `render.ts` の
- * `humanConfirmedStatus`（口の `humanOwned`・区画の語彙）で、`""` の扱いがここと逆
- * （確認済みとして**扱う**側は `humanOwned`、機械が触る前の**守り**は `!machineOwned` という割り当て）。
+ * ⚠️ **「人の手」は別にある。** 削除の確認の文面を替える `rec.humanTouched`（`build.ts` の
+ * `humanTouchedOf`）は口の `humanOwned`（区画の語彙）か確認の帳簿の行で、`""` の扱いがここと逆
+ * （人の手として**扱う**側は `humanOwned`、機械が触る前の**守り**は `!machineOwned` という割り当て）。
  */
 function isConfirmedStatus(status, recordPath = null) {
     return !(0, confirmed_1.machineOwned)(recordPath, status);
@@ -698,41 +696,15 @@ function breakTiesByStrength(records, pathOf, ledgers, nowIso) {
     return out;
 }
 /* ---------------------------------------------------------------------------
- * 決定の「その後」の帳簿（#705・engine #509 便 4）
+ * 決定の「その後」（人の答え）
  * ---------------------------------------------------------------------------
  *
- * `.cortex/gold-decision-followup.json` は夜間（engine `scripts/gold/decision-followup.mjs`）が
- * 型（`scripts/ledger/`）を通して書く。形は
- * `{ version: 1, venues: [...], sections: { Decisions: { <path>: { decided_on, state, links, candidates, evidence, checked_on } } } }`。
- *
- * 🔴 **帳簿が無い・壊れている・版が違う案件は「今までと 1 バイトも同じ画面」**（上の 3 帳簿と同じ規律）。
- * 読めないものは `null`（＝帳簿を持たない案件と同じ）として続ける。
- *
- * 🔴 **便 3 の `evidence[]` は形が未確定**。知らない verdict・欠けた欄は行ごと捨てる
- * （落ちない・知らないものを画面へ運ばない）。
- */
-/** 帳簿のファイル名（`.cortex/` の下） */
-exports.DECISION_FOLLOWUP_FILE = "gold-decision-followup.json";
-/**
- * 画面に出す結び付きの状態（engine `decision-followup-run.mjs` の `LINKED_STATES` と同じ 6 語）。
- *
- * 🔴 **`venue_unavailable` / `link_unresolved` / `no_link` / `source_missing` は出さない**
- * （発注書 #705）。「未接続のため」「記録なし」の文を画面に並べない——出来事だけを出す。
+ * 画面が読むのは、人が frontmatter に書いた `followup:` の 1 行だけ（#1094 35d）。
+ * 夜間の帳簿（`.cortex/gold-decision-followup.json`）は画面に出さない・読まない
+ * （PR のマージを完了と数える差 97 を画面から外すため）。
  */
-exports.FOLLOWUP_SHOWN_STATES = [
-    "issue_closed", "pr_merged", "issue_open", "superseded", "same_day", "pr_closed",
-];
-/** 結び付きの種類（`material` は出典の資料で、`source_missing` にしか現れないので載せない） */
-const FOLLOWUP_LINK_KINDS = ["issue", "pr", "gh", "decision"];
-/** 便 3 の verdict のうち画面が知っているもの。**知らない値は行ごと捨てる** */
-exports.FOLLOWUP_EVIDENCE_VERDICTS = ["done", "changed", "review"];
 /** 人が frontmatter に書く `followup.state` の語彙（intake `FOLLOWUP_STATES` と同じ 4 語） */
 exports.HUMAN_FOLLOWUP_STATES = ["confirmed", "done", "dropped", "ignore"];
-/** http(s) の URL だけを通す（`javascript:` などを画面へ運ばない） */
-const httpUrl = (v) => {
-    const s = typeof v === "string" ? v.trim() : "";
-    return /^https?:\/\//i.test(s) ? s : "";
-};
 /**
  * 日付を `YYYY-MM-DD` に畳む。
  *
@@ -756,90 +728,6 @@ function followupDateOf(v) {
         return "";
     return new Date(ms + 9 * 3600 * 1000).toISOString().slice(0, 10);
 }
-/**
- * 決定の「その後」の帳簿を読む。
- *
- * @returns path → 行。**帳簿が無い・壊れている・版が違うときは `null`**（＝帳簿を持たない案件）。
- *   読めたが行が 0 件のときは空の Map（帳簿を持つ案件として扱う＝絞り込みの「記録なし」が出うる）
- */
-async function readDecisionFollowup(repoRoot) {
-    let raw;
-    try {
-        raw = await promises_1.default.readFile(node_path_1.default.join(repoRoot, ".cortex", exports.DECISION_FOLLOWUP_FILE), "utf8");
-    }
-    catch (e) {
-        // 無いのが既定（栓 `decision_followup` を入れた案件だけが持つ）。無いことは警告しない
-        if (e?.code !== "ENOENT") {
-            console.warn(`${exports.DECISION_FOLLOWUP_FILE} を読めませんでした（その後の記録は出さずに続けます）: ${String(e)}`);
-        }
-        return null;
-    }
-    const parsed = parseLedger(raw);
-    if (!parsed) {
-        // 壊れ・版違いは 1 行残す（「夜間がまだ書いていない」と切り分けるため）
-        console.warn(`${exports.DECISION_FOLLOWUP_FILE} の形式か version が想定と違います（その後の記録は出さずに続けます）`);
-        return null;
-    }
-    const out = new Map();
-    const sections = asRecord(parsed.sections);
-    // 🔴 **区画は Decisions だけを見る**（engine の `SECTION`）。他の名前の節が増えても拾わない
-    const rows = asRecord(sections?.Decisions);
-    if (!rows)
-        return out;
-    for (const [p, v] of Object.entries(rows)) {
-        const row = asRecord(v);
-        if (!row)
-            continue;
-        const links = [];
-        if (Array.isArray(row.links)) {
-            for (const l of row.links) {
-                const link = asRecord(l);
-                if (!link)
-                    continue;
-                const kind = typeof link.kind === "string" ? link.kind : "";
-                const key = typeof link.key === "string" ? link.key : "";
-                const state = typeof link.state === "string" ? link.state : "";
-                if (!FOLLOWUP_LINK_KINDS.includes(kind) || !key || !state)
-                    continue;
-                links.push({ kind: kind, key: key, state: state, at: followupDateOf(link.at), url: httpUrl(link.url) });
-            }
-        }
-        const evidence = [];
-        if (Array.isArray(row.evidence)) {
-            for (const e of row.evidence) {
-                const ev = asRecord(e);
-                if (!ev)
-                    continue;
-                const verdict = typeof ev.verdict === "string" ? ev.verdict : "";
-                // 🔴 **知らない verdict は捨てる**（便 3 の語彙は未確定。知らない語を画面の文にしない）
-                if (!exports.FOLLOWUP_EVIDENCE_VERDICTS.includes(verdict))
-                    continue;
-                evidence.push({
-                    verdict: verdict,
-                    quote: typeof ev.quote === "string" ? ev.quote : "",
-                    url: httpUrl(ev.url),
-                    // engine の今の根拠行は `{id, venue, quote, verdict, judged_at}`（`occurred_at` を持たない）。
-                    // 無ければ判定した日で代える——形は便 3 で合わせる（docs/product-decisions.md）
-                    at: followupDateOf(ev.occurred_at) || followupDateOf(ev.judged_at),
-                });
-            }
-        }
-        out.set(p, { links: links, evidence: evidence });
-    }
-    return out;
-}
-/**
- * 帳簿の行から、画面に出すぶんだけを残す。**出す結び付きが 1 件も無ければ `null`**
- * （節を作らない・一覧の印も付かない）。
- */
-function shownFollowupOf(row) {
-    if (!row)
-        return null;
-    const links = row.links.filter((l) => exports.FOLLOWUP_SHOWN_STATES.includes(l.state));
-    if (!links.length)
-        return null;
-    return { links: links, evidence: row.evidence };
-}
 /**
  * frontmatter の `followup:`（人が画面のボタンで書く 1 行）を読む。
  *