@takagaki/cortex-decisions-viewer 0.12.119 → 0.12.121

package/dist/build.js

@@ -45,6 +45,7 @@ exports.humanTouchedOf = humanTouchedOf;
 exports.attachHumanTouched = attachHumanTouched;
 exports.rawFrontmatterDate = rawFrontmatterDate;
 exports.attachSupersedes = attachSupersedes;
+exports.attachRetractedBy = attachRetractedBy;
 exports.readGoldProposals = readGoldProposals;
 exports.buildHomeGrounding = buildHomeGrounding;
 exports.collectMeetings = collectMeetings;
@@ -68,10 +69,12 @@ const marked_1 = require("marked");
 const sanitize_html_1 = __importDefault(require("sanitize-html"));
 const canonical_evidence_1 = require("./canonical-evidence");
 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 story_1 = require("./story");
 const ranking_1 = require("./ranking");
+const hands_1 = require("./hands");
 const rederivation_1 = require("./rederivation");
 // 直近のGold昇格で追加されたレコードのパス集合。レコード生成の各所から参照するのでモジュールスコープに置く
 // （引数で引き回すと呼び出し側の改修が広範囲になる）。build() の冒頭で1回だけ解決する。
@@ -826,6 +829,35 @@ function attachSupersedes(decisions, rawDateOf = (d) => d.fm.date, pathOf = () =
             d.supersedesIds = replaced;
     }
 }
+/**
+ * ルールに取り下げ（`relations[retracted_by]`・cortex-engine #1094 便 4-2d）を載せる。
+ *
+ * 取り下げ＝この線が 1 本以上（決定の「置き換えられた」と同じ導出・engine の目次と同じ）。
+ * target は取り下げを決めた決定の ID。実在する決定なら記録の綴りと決定日を添える（無ければ ID のまま・日付は空）。
+ * **取り下げの無いルール・ルール以外の区画にはキーごと付けない**（今までと同じ SiteData）
+ */
+function attachRetractedBy(records, decisions, rawDateOf = (d) => d.date) {
+    const byKey = new Map();
+    for (const d of decisions) {
+        const k = (0, supersedes_1.decisionKeyOf)(d.id);
+        if (!byKey.has(k))
+            byKey.set(k, d);
+    }
+    for (const r of records) {
+        const out = [];
+        for (const rel of r.relations) {
+            if (rel.rel !== "retracted_by")
+                continue;
+            const k = (0, supersedes_1.decisionKeyOf)(rel.target);
+            if (!k || out.some((x) => (0, supersedes_1.decisionKeyOf)(x.id) === k))
+                continue;
+            const d = byKey.get(k);
+            out.push({ id: d ? d.id : k, date: d ? (0, supersedes_1.decisionDateOf)(rawDateOf(d), d.id) : "" });
+        }
+        if (out.length)
+            r.retractedBy = out;
+    }
+}
 /**
  * AIからの更新提案（`.cortex/gold-proposals.json`）を読む。
  *
@@ -2366,7 +2398,7 @@ async function build(opts) {
     // 解決するので、あとから作ると空の表・空の実在判定が渡り、**実在するパスまで
     // 「リンクにしない」に倒れて全滅する**（以前は順序が逆だった）。
     const repoRoot = knowledgeRoot ? path.dirname(knowledgeRoot) : path.dirname(dirAbs);
-    // 帳簿 9 本の置き場（既定は `<repoRoot>/.cortex`）。読み口はこの 1 つから読む
+    // 帳簿 10 本の置き場（既定は `<repoRoot>/.cortex`）。読み口はこの 1 つから読む
     const ledgerDir = (0, ledger_dir_1.ledgerDirOf)(repoRoot, opts.ledgerDir);
     const targetUrls = knowledgeRoot
         ? await buildTargetUrlMap(repoRoot, repo.baseUrl, repo.branch)
@@ -2394,6 +2426,8 @@ async function build(opts) {
     const engagement = await (0, engagement_1.readEngagementLedger)(repoRoot, ledgerDir);
     // 目次と同じ順位（engine #551）。**読めないなら `null`** で、つながり画面の点は今までどおり一律
     const memoryRanking = await (0, ranking_1.readMemoryRanking)(repoRoot, ledgerDir);
+    // 人の手の表の写し（engine #1094 q-10）。あれば記憶 v2 の案件で、確認の印とボタンを出さない。**無い案件は今と 1 バイトも同じ**（キーごと無い）
+    const memoryV2 = await (0, hands_1.readMemoryV2)(repoRoot, ledgerDir);
     // 記録の id → リポジトリルート相対のパス（順位のファイルの鍵と突き合わせる。`repoRoot` 起点・cwd 起点にしない）
     const recordRelPaths = new Map();
     const relOf = (dir, fileName) => {
@@ -2457,6 +2491,9 @@ async function build(opts) {
             const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
             // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）
             attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation);
+            // ルールの取り下げ（`retracted_by`・cortex-engine #1094 便 4-2d）。ルールの区画だけ・取り下げの無い案件では何も付かない
+            if (e.name === "Rules")
+                attachRetractedBy(records, decisions, (d) => rawDates.get(d) ?? d.fm.date);
             // 用語集の並び（活性度・強さ）。**帳簿を持たない案件では並びもそのまま**
             const rederived = orderRecordsByLedgers(records, recordsDir, rederive, opts.generatedAt);
             // 関係者だけ、関与の多い順（engine の目次と同じ `order`・便 14b）。用語集の並び
@@ -2518,11 +2555,9 @@ async function build(opts) {
     // すでにある会議（投入モーダルの「会議名」の選択肢）。intake の有無に関わらず載せる——
     // 出し分けは表示側の仕事で、ここで絞ると「投入の口を後から付けたら選択肢が空」になる
     const meetings = await collectMeetings(repoRoot);
-    // AIによるレコードの変更履歴を git から取る。**レコード数に関わらず git は2回だけ呼ぶ**。
-    // git が無い・浅い clone・該当0件なら空で、履歴の節が出ないだけ（他の表示は壊れない）。
-    // 走るのは latestGeneratedPaths と同じ **リポジトリルート**（process.cwd()）——
-    // Decisions ディレクトリで実行すると pathspec に一致せず常に空になる
-    const aiHistory = (0, repo_1.collectAiChangeHistory)(process.cwd());
+    // 記録ページの「更新履歴」。engine が毎晩書く帳簿（ledger-dir の gold-change-log.json）だけを読む（git は読まない）。
+    // 無い・壊れ・版違いは null で、画面は「更新履歴はまだありません」の 1 つの形になる
+    const changeLog = await (0, change_log_1.readChangeLog)(repoRoot, ledgerDir);
     // ストーリー（#901 V2-5）の日本時間の今日。日・週・月の3つで同じ日にそろえるため1回だけ計算する
     const storyToday = (0, story_1.todayJst)(new Date(opts.generatedAt));
     // ストーリーの日々の動き（#901 V2-5）。帳簿で on の日のファイルが無ければ null（キーごと出さない）
@@ -2545,6 +2580,7 @@ async function build(opts) {
         home,
         homeGrounding: homeGrounding,
         homeUpdatedAt: homeUpdatedAt,
+        ...(memoryV2 ? { memoryV2: true } : {}),
         sections,
         graph,
         categories,
@@ -2587,7 +2623,7 @@ async function build(opts) {
         // null（無い・壊れ・version違い）は undefined へ落とす——SiteData の
         // 「知らないことはキーが無いことで表す」に合わせる（空の器を通さない）
         // 空の器は通さない（0件なら undefined = キーごと出さない）
-        aiHistory: Object.keys(aiHistory).length ? aiHistory : undefined,
+        changeLog: changeLog ?? undefined,
         // 載せる日が無い案件（帳簿なし・壊れ・shadow の日だけ・ファイルなし）はキーごと出さない
         story: story ?? undefined,
         storyDigest: storyDigest ?? undefined,

package/dist/change-log.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHANGE_LOG_MAX_ROWS = exports.CHANGE_LOG_VERSION = exports.CHANGE_LOG_FILE = void 0;
+exports.isCleanUrl = isCleanUrl;
+exports.jstDay = jstDay;
+exports.parseChangeLog = parseChangeLog;
+exports.readChangeLog = readChangeLog;
+/**
+ * 記録ページの「更新履歴」の材料（cortex-engine #1094 便 35b-1 U2・設計 D3）。
+ *
+ * 読むのは engine が毎晩書く帳簿 `gold-change-log.json`（ledger-dir の下）だけ。git は読まない。
+ * 形の契約は engine `test/fixtures/change-log-contract.json`（tools の `viewer/test/fixtures/` へ配られる）。
+ *
+ * ## 🔴 読めなければ空（縮退は 1 つの形）
+ *
+ * 帳簿が無い・壊れ・版違い・形違いは `null`（画面は「更新履歴はまだありません」。今の欄には戻さない）。
+ * 1 行でも契約に反すれば全体を捨てる（engine は書く前に同じ基準で検査するので、viewer を engine より厳しくしない）。
+ *
+ * ## 🔴 禁止語の表は写さない
+ *
+ * 機械の語（frontmatter・commit …）を `what` に出さない番人は engine の持ち物（`hasForbiddenTerm`）。
+ * 写すと表が 2 つになるので、ここは**構造・表示の安全・メールの形・Operated-By**だけを見る。
+ *
+ * ## 日付
+ *
+ * `at` は git の author date（作者のオフセット付き）。engine は同じ日のまとめを JST で行うので、画面の日付も
+ * **固定 +9 時間の UTC 算術**で JST に直す（閲覧者のタイムゾーンに依存しない・Date の地域表示は使わない）。
+ */
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const ledger_dir_1 = require("./ledger-dir");
+/** 置き場（engine `scripts/gold/change-log.mjs` の `CHANGE_LOG_PATH`） */
+exports.CHANGE_LOG_FILE = "gold-change-log.json";
+/** 形の版（engine の `CHANGE_LOG_VERSION`。違ったら読まない） */
+exports.CHANGE_LOG_VERSION = 1;
+/** 1 記録で画面に渡す行数の上限（窓の `per_record` と同じ 50） */
+exports.CHANGE_LOG_MAX_ROWS = 50;
+/** `why` は 1 行 3 本まで（engine の `WHY_MAX`） */
+const WHY_MAX = 3;
+/** 載る記録のパス（4 区画の記録。README・雛形・入れ子は載らない） */
+const RECORD_PATH = /^Cortex\/(Decisions|Glossary|Members|Rules)\/records\/[^/]+\.md$/;
+const isObj = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+/** メールの形（URL の部分を除いて見る） */
+// engine `change-log.mjs` の定義と同じ（緩めると、URL の後ろのメールや非 ASCII のローカル部が通る）
+const URL_IN_TEXT_RE = /https?:\/\/[^\s"'<>)\]]+/g;
+const EMAIL_RE = /[^\s@/:]+@[^\s@/:]+\.[^\s@/:]+/;
+const hasEmailShape = (text) => EMAIL_RE.test(text.replace(URL_IN_TEXT_RE, " "));
+/**
+ * `why.url` の検査（engine `cleanUrl` と同じ述語）。http(s) だけ・userinfo なし・クエリとフラグメントなし・
+ * 正規化しても同じ文字列。`javascript:` や `mailto:` は通らない
+ */
+function isCleanUrl(raw) {
+    if (typeof raw !== "string")
+        return false;
+    const s = raw.trim().replace(/[.,;:!?)\]>"'、。）」』]+$/u, "");
+    if (!/^https?:\/\//i.test(s))
+        return false;
+    let u;
+    try {
+        u = new URL(s);
+    }
+    catch {
+        return false;
+    }
+    if (!/^https?:$/.test(u.protocol))
+        return false;
+    if (u.username || u.password)
+        return false;
+    u.search = "";
+    u.hash = "";
+    return u.toString() === raw;
+}
+/** 日本時間の `YYYY/M/D`。読めない値は `null` */
+function jstDay(at) {
+    const t = Date.parse(at);
+    if (!Number.isFinite(t))
+        return null;
+    const d = new Date(t + 9 * 3600 * 1000);
+    return `${d.getUTCFullYear()}/${d.getUTCMonth() + 1}/${d.getUTCDate()}`;
+}
+const ROW_KEYS = ["at", "by", "what", "why", "commit"];
+const BY_KINDS = ["member", "night", "unknown"];
+const norm = (p) => p.normalize("NFC");
+/** 中身を読む（投げない）。契約に 1 つでも反すれば `null` */
+function parseChangeLog(text) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!isObj(value) || value.version !== exports.CHANGE_LOG_VERSION)
+        return null;
+    if (Object.keys(value).some((k) => !["version", "window", "records"].includes(k)))
+        return null;
+    const w = value.window;
+    if (!isObj(w) || !Number.isInteger(w.days) || w.days <= 0 || !Number.isInteger(w.per_record) || w.per_record <= 0)
+        return null;
+    if (!isObj(value.records))
+        return null;
+    const rows = Object.create(null);
+    let seq = 0;
+    for (const rec of Object.values(value.records)) {
+        if (!isObj(rec))
+            return null;
+        if (Object.keys(rec).some((k) => k !== "path" && k !== "rows"))
+            return null;
+        if (typeof rec.path !== "string" || !rec.path || !Array.isArray(rec.rows))
+            return null;
+        const recPath = norm(rec.path);
+        const out = [];
+        for (const r of rec.rows) {
+            if (!isObj(r))
+                return null;
+            if (Object.keys(r).some((k) => !ROW_KEYS.includes(k)))
+                return null;
+            if (typeof r.at !== "string")
+                return null;
+            const t = Date.parse(r.at);
+            const day = jstDay(r.at);
+            if (!Number.isFinite(t) || !day)
+                return null;
+            const by = r.by;
+            if (!isObj(by) || typeof by.kind !== "string" || !BY_KINDS.includes(by.kind))
+                return null;
+            if (Object.keys(by).some((k) => k !== "kind" && k !== "member"))
+                return null;
+            if (by.kind === "member" && (typeof by.member !== "string" || !by.member))
+                return null;
+            if (by.kind !== "member" && "member" in by)
+                return null;
+            if (typeof r.what !== "string" || !r.what)
+                return null;
+            if (!/^[0-9a-f]{7,64}$/.test(String(r.commit ?? "")))
+                return null;
+            if (!Array.isArray(r.why) || r.why.length > WHY_MAX)
+                return null;
+            const why = [];
+            for (const x of r.why) {
+                if (!isObj(x) || Object.keys(x).some((k) => k !== "label" && k !== "url"))
+                    return null;
+                if (typeof x.label !== "string" || !x.label || !isCleanUrl(x.url))
+                    return null;
+                why.push({ label: x.label, url: x.url });
+            }
+            const row = {
+                day, who: by.kind, what: r.what, why, commit: r.commit, _t: t, _i: seq++,
+            };
+            if (by.kind === "member")
+                row.member = by.member;
+            out.push(row);
+        }
+        // 記録の鍵（id）の綴りは走査しない。載る記録のパスの形でないものは捨てる（__proto__ などの鍵も入らない）
+        if (!RECORD_PATH.test(recPath))
+            continue;
+        (rows[recPath] ||= []).push(...out);
+    }
+    // メール・Operated-By は行の中のどこにも持たない（URL の部分を除いたメールの形も）
+    const rowsText = JSON.stringify([value.window, ...Object.values(value.records).map((r) => (isObj(r) ? r.rows : null))]);
+    if (hasEmailShape(rowsText) || /operated-by/i.test(rowsText))
+        return null;
+    const result = { windowDays: w.days, rows: {} };
+    for (const [p, list] of Object.entries(rows)) {
+        // 新しい順（時刻の数値で・同じ時刻は元の並びのまま）→ 50 行で切る
+        list.sort((a, b) => b._t - a._t || a._i - b._i);
+        result.rows[p] = list.slice(0, exports.CHANGE_LOG_MAX_ROWS).map(({ _t, _i, ...row }) => row);
+    }
+    return result;
+}
+/** 案件リポから読む。無い → `null`（黙る）・壊れている → `null`（build のログに 1 行） */
+async function readChangeLog(repoRoot, ledgerDir) {
+    let text;
+    try {
+        text = await promises_1.default.readFile(node_path_1.default.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), exports.CHANGE_LOG_FILE), "utf8");
+    }
+    catch {
+        return null;
+    }
+    const parsed = parseChangeLog(text);
+    if (!parsed)
+        console.warn(`${exports.CHANGE_LOG_FILE}: 読めないので、記録ページの更新履歴は「まだありません」と出します`);
+    return parsed;
+}

package/dist/cli.js

@@ -22,7 +22,7 @@ program
     .option("--secret-kinds <kinds>", "鍵の入力欄を出す連携（カンマ区切り。例: figma,backlog）")
     .option("--webhook-url <url>", "Backlog Webhook 受信のLambda URL（環境変数 WEBHOOK_URL でも可）")
     .option("--webhook-token <token>", "リアルタイム同期の**案件別**トークン（環境変数 WEBHOOK_TOKEN でも可。艦隊共通トークンを渡さないこと）")
-    .option("--ledger-dir <dir>", "ビューアが読む帳簿（.cortex の 9 本）の置き場（未指定なら <リポジトリルート>/.cortex）")
+    .option("--ledger-dir <dir>", "ビューアが読む帳簿（.cortex の 10 本）の置き場（未指定なら <リポジトリルート>/.cortex）")
     .action(async (dir, opts) => {
     try {
         const result = await (0, build_1.build)({

package/dist/hands.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEMORY_HANDS_VERSION = exports.MEMORY_HANDS_FILE = void 0;
+exports.isMemoryHandsCopy = isMemoryHandsCopy;
+exports.readMemoryV2 = readMemoryV2;
+/**
+ * 人の手の表の写し（`.cortex/memory-hands.json`）を読む（cortex-engine #1094 q-10・仕様 1-6）。
+ *
+ * 仕様 1-6: **表があること自体が、その案件の記憶 v2 の印**。engine が栓 `human_touch_lock` が on の晩に、表が読めた晩だけ
+ * 目次と同じコミットで置く（engine `scripts/memory-hands-copy.mjs` の `HANDS_COPY_PATH`・`handsCopyText`）。ここは**印があるかを読むだけ**で、
+ * 記録ごとの欄（lock・touched …）はまだ画面の判定に使わない（残りは段 5・仕様の差 77）。
+ *
+ * v2 の案件では、画面から「AI生成・未確認」の札・警告帯・［確認済みにする］・「未確認のみ」を出さない（削除は残す）。
+ * 読めない・無い・版が違う案件は v2 でないものとして今のまま（`SiteData.memoryV2` はキーごと無い）。
+ */
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const ledger_dir_1 = require("./ledger-dir");
+/** 置き場（engine `scripts/memory-hands-copy.mjs` の `HANDS_COPY_PATH` の `.cortex/` の下） */
+exports.MEMORY_HANDS_FILE = "memory-hands.json";
+/** 形の版（engine の `HANDS_COPY_VERSION`。違ったら v2 の印と読まない） */
+exports.MEMORY_HANDS_VERSION = 1;
+/** 中身が人の手の表の写しの形か（投げない）。版が違う・形が違う・壊れている → `false` */
+function isMemoryHandsCopy(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return false;
+        const o = parsed;
+        return o.version === exports.MEMORY_HANDS_VERSION && !!o.records && typeof o.records === "object" && !Array.isArray(o.records);
+    }
+    catch {
+        return false;
+    }
+}
+/** 案件リポに写しがあり、読める形か。無い → `false`（黙る）・壊れている → `false`（build のログに 1 行） */
+async function readMemoryV2(repoRoot, ledgerDir) {
+    let text;
+    try {
+        text = await promises_1.default.readFile(node_path_1.default.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), exports.MEMORY_HANDS_FILE), "utf8");
+    }
+    catch {
+        return false;
+    }
+    const ok = isMemoryHandsCopy(text);
+    if (!ok)
+        console.warn(`${exports.MEMORY_HANDS_FILE}: 読めないので、この案件は記憶 v2 でないものとして出します`);
+    return ok;
+}

package/dist/ledger-dir.js

@@ -7,7 +7,7 @@ exports.DEFAULT_LEDGER_DIR_NAME = void 0;
 exports.defaultLedgerDir = defaultLedgerDir;
 exports.ledgerDirOf = ledgerDirOf;
 /**
- * ビューアが読む帳簿（9 本）の置き場（cortex-engine #1094 便 3-11 の tools（T1））。
+ * ビューアが読む帳簿（10 本）の置き場（cortex-engine #1094 便 3-11 の tools（T1））。
  *
  * 既定は `<リポジトリルート>/.cortex`（今までと同じ）。`--ledger-dir` で別のフォルダを指せる。
  * ビューアは保管庫（S3）も栓も知らない（AWS SDK を足さない）。どこから持ってくるかは呼び出し側（workflow）の仕事で、