@takagaki/cortex-decisions-viewer 0.12.85 → 0.12.87

package/dist/build.js

@@ -36,16 +36,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROJECT_ICON_EXTS = void 0;
+exports.PROJECT_ICON_EXTS = exports.MIRROR_RELS = void 0;
 exports.sanitizeBody = sanitizeBody;
 exports.findProjectIcon = findProjectIcon;
 exports.readFleetSources = readFleetSources;
 exports.attachRederived = attachRederived;
 exports.attachDecisionFollowup = attachDecisionFollowup;
+exports.rawFrontmatterDate = rawFrontmatterDate;
+exports.attachSupersedes = attachSupersedes;
 exports.readGoldProposals = readGoldProposals;
 exports.buildHomeGrounding = buildHomeGrounding;
 exports.collectMeetings = collectMeetings;
 exports.findBacklogDir = findBacklogDir;
+exports.figmaUrlFromRef = figmaUrlFromRef;
 exports.bodyFileSlug = bodyFileSlug;
 exports.bodyStampId = bodyStampId;
 exports.bodyStampComment = bodyStampComment;
@@ -97,6 +100,7 @@ function takeProposals(filePath) {
 }
 const external_id_1 = require("./external-id");
 const home_project_1 = require("./home-project");
+const supersedes_1 = require("./supersedes");
 const render_1 = require("./render");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
@@ -113,6 +117,11 @@ const PKG_VERSION = (() => {
     }
 })();
 const DEFAULT_EXCLUDE = ["README.md", "template.md"];
+/**
+ * グラフ・エクスプローラーに描かない関係（#699 F3）。`superseded_by` は engine の夜間の精製が古い側に書く
+ * `supersedes` の写しで、描くと同じ置き換えが逆向きにもう 1 本出る。frontmatter のパネルには今までどおり出る
+ */
+exports.MIRROR_RELS = new Set(["superseded_by"]);
 /** frontmatterのrelationsを安全に正規化する */
 function toRelations(value) {
     if (!Array.isArray(value))
@@ -707,30 +716,35 @@ readBlobs = repo_1.readBlobsAt) {
     // 🔴 **「確認済み」は `status` だけで決まる**（#667）。帯も並びも同じ `rstatus` を見る
     // ——ここで別のものを渡すと、画面の札と食い違う（「未確認」の札が付いた記録に帯が出る）
     const statusOf = (r) => r.rstatus;
-    // 決定表の行 8（中身が変わったか）の材料。**印の候補になったレコードのぶんだけ**、
-    // 今の版を読み、`<基準コミット>:<path>` をまとめて 1 回引く。
+    // 決定表の行 5〜7 の材料。**帯の候補になったレコードのぶんだけ**今の版を読み、指紋を作る。
+    // 帳簿に人が確認した版の指紋が無い候補だけ、`<基準コミット>:<path>` をまとめて 1 回 git から引く。
     // 🔴 **キーが 0 件の区画では git を起こさない**（この関数は区画ごとに呼ばれる）
     const keyOf = new Map();
     // 今の版は**作業ツリーから読む**——画面が描いているのはこのファイルであって HEAD ではない
     const now = new Map();
+    const nowSha = new Map();
     for (const r of records) {
         const key = (0, rederivation_1.rederivedContentKey)(pathOf(r), statusOf(r), ctx.ledgers);
         if (!key)
             continue;
         const p = pathOf(r);
+        let nowRaw;
         try {
-            now.set(p, await node_fs_1.promises.readFile(path.join(ctx.repoRoot, p), "utf8"));
+            nowRaw = await node_fs_1.promises.readFile(path.join(ctx.repoRoot, p), "utf8");
         }
         catch {
-            // 読めなければ「引けなかった」側（下の verdict が unknown に倒す）
+            // 読めなければ「読めなかった」側（`rederivedBandOf` が帯を出さずに数える）
+            continue;
         }
-        // 🔴 **帳簿の指紋が今の中身と一致する記録は git の key に入れない**（engine #546）。
-        // 答えは下の verdict で `same` になるので、基準版を引く意味が無い——ここで外さないと、
-        // engine が指紋を書いても用語 1400 件の案件で毎晩 1400 個の blob を読み続ける。
-        // 指紋が無い・食い違う・今の版が読めない記録は今までどおり git へ落とす
-        const nowRaw = now.get(p);
-        const sha = ctx.ledgers.confirmation.get(p)?.contentSha;
-        if (nowRaw != null && sha && sha === (0, rederivation_1.contentShaOf)(nowRaw)) {
+        now.set(p, nowRaw);
+        const sha = (0, rederivation_1.contentShaOf)(nowRaw);
+        nowSha.set(p, sha);
+        const conf = ctx.ledgers.confirmation.get(p);
+        // 🔴 **今の版が機械の書き直しの版でなければ git を読まない**（帯は出ないと決まっている）。
+        // 人が確認した版の指紋が帳簿にあれば、それで決まるので git を読まない（engine #546）
+        if (sha !== conf?.rewritten?.contentSha)
+            continue;
+        if (conf.contentSha) {
             if (ctx.blobs)
                 ctx.blobs.skipped++;
             continue;
@@ -742,28 +756,18 @@ readBlobs = repo_1.readBlobsAt) {
     const bases = keyOf.size ? readBlobs(ctx.repoRoot, [...keyOf.values()]) : new Map();
     const verdict = (p, baseCommit) => {
         const nowRaw = now.get(p);
-        if (nowRaw == null) {
-            ctx.miss.unreadable.add(p);
-            return "unknown";
-        }
-        // 🔴 **帳簿が中身の指紋を持つならそれを先に使う**（engine #546 が書く。一致した記録は
-        // 上で git の key から外してある）。
-        // 一致したときだけ「変わっていない」と言い、食い違ったら git の二段目へ落とす——
-        // engine が別の綴りで指紋を作っていた場合に、全レコードへ誤報が出るのを避ける
-        const conf = ctx.ledgers.confirmation.get(p);
-        if (conf && conf.contentSha && conf.contentSha === (0, rederivation_1.contentShaOf)(nowRaw))
-            return "same";
         const baseRaw = bases.get(`${baseCommit}:${p}`);
-        if (baseRaw == null) {
+        if (nowRaw == null || baseRaw == null) {
             // 浅い clone の窓の外・確認の後に改名された・基準コミットにこの path が無い。
-            // **印は立てない**（誤報より無言）が、静かに消える経路なのでログの器に数える
+            // **帯は出さない**（誤報より無言）が、静かに消える経路なのでログの器に数える
             ctx.miss.unreadable.add(p);
             return "unknown";
         }
         return (0, rederivation_1.sameRederivedContent)(baseRaw, nowRaw) ? "same" : "changed";
     };
+    const nowShaOf = (p) => nowSha.get(p) ?? null;
     for (const r of records) {
-        const band = (0, rederivation_1.rederivedBandOf)(pathOf(r), statusOf(r), ctx.ledgers, ctx.identities, verdict, ctx.miss);
+        const band = (0, rederivation_1.rederivedBandOf)(pathOf(r), statusOf(r), ctx.ledgers, nowShaOf, verdict, ctx.miss);
         // **印が立たないレコードにはキーごと付けない**（空の器を通さない）
         if (band)
             r.rederived = band;
@@ -795,6 +799,78 @@ function attachDecisionFollowup(decisions, recordsDir, repoRoot, ledger) {
     }
     return [...ledger.keys()].filter((k) => !matched.has(k.normalize("NFC")));
 }
+/**
+ * 決定に置き換えの逆引き（置き換え先・置き換えた決定）を載せる（cortex-engine #699 F3・A-1'）。
+ *
+ * 🔴 **逆引きは `supersedes.ts`（engine `scripts/gold/supersedes-index.mjs` の写し）だけで組む**。
+ * 材料は新しい側の `relations[supersedes]` だけで、古い側の `superseded_by`（夜間の精製が書く写し）は
+ * 読まない。確認済み＝新しい側の `status` が `active`。
+ *
+ * 置き換えが無い決定には**キーごと付けない**（今までと同じ SiteData）
+ */
+/**
+ * frontmatter に**書かれたままの** `date` の値（トップレベルの `date:` の行・引用符と行末のコメントを外す）。
+ * 無い・frontmatter が無ければ undefined。置き換えの逆引きの決定日だけに使う（engine と同じ日付にするため）
+ */
+function rawFrontmatterDate(raw) {
+    const m = String(raw ?? "").replace(/^\uFEFF/, "").match(/^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/);
+    if (!m)
+        return undefined;
+    const line = m[1].match(/^date:[ \t]*(.*)$/m);
+    if (!line)
+        return undefined;
+    let v = line[1].replace(/\r$/, "").trim();
+    const q = v.match(/^(["'])(.*)\1(?:\s+#.*)?$/);
+    if (q)
+        return q[2];
+    v = v.replace(/\s+#.*$/, "").trim();
+    return v;
+}
+function attachSupersedes(decisions, rawDateOf = (d) => d.fm.date) {
+    const input = decisions.map((d) => ({
+        id: d.id,
+        // 🔴 **frontmatter に書かれたままの date の文字列**（`rawFrontmatterDate`）。gray-matter は時刻・時差つきの
+        // date を Date に読み、sanitizeFm は UTC の日付にするので、`2026-07-01T01:00:00+09:00` が 6/30 にずれる。
+        // engine は日付を Date にしない読み方（CORE_SCHEMA）で書かれた文字列の先頭 8 桁を使う。
+        // 無ければ写しが ID の先頭 8 桁から取る
+        date: rawDateOf(d),
+        status: d.fm.status,
+        supersedes: d.relations.filter((r) => r.rel === "supersedes").map((r) => r.target),
+    }));
+    const index = (0, supersedes_1.supersedesIndex)(input);
+    const idOfKey = new Map();
+    for (const d of decisions) {
+        const k = (0, supersedes_1.decisionKeyOf)(d.id);
+        if (!idOfKey.has(k))
+            idOfKey.set(k, d.id);
+    }
+    for (const d of decisions) {
+        const key = (0, supersedes_1.decisionKeyOf)(d.id);
+        const entry = index.get(key);
+        if (entry && entry.by.length) {
+            d.supersededBy = {
+                by: entry.by.map((b) => ({ id: b.id, date: b.date, confirmed: b.confirmed })),
+                retired: entry.retired,
+            };
+        }
+        const replaced = [];
+        for (const r of d.relations) {
+            if (r.rel !== "supersedes")
+                continue;
+            const k = (0, supersedes_1.decisionKeyOf)(r.target);
+            // engine の規則と同じく、自分自身・実在しない決定は数えない
+            if (!k || k === key)
+                continue;
+            const id = idOfKey.get(k);
+            if (id === undefined)
+                continue;
+            if (!replaced.includes(id))
+                replaced.push(id);
+        }
+        if (replaced.length)
+            d.supersedesIds = replaced;
+    }
+}
 /**
  * AIからの更新提案（`.cortex/gold-proposals.json`）を読む。
  *
@@ -1373,16 +1449,28 @@ async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
     //   - 参照ID: `design:xxx:103:1836`
     //   - [Figmaで開く](https://www.figma.com/design/...)
     // 以前は `data.type === "design"` を見ていたので、この解決は**一度も効いていなかった**。
-    for (const file of await walkMd(path.join(repoRoot, designDir, "inventory"))) {
-        try {
-            const body = await node_fs_1.promises.readFile(file, "utf8");
-            const id = body.match(/^- 参照ID: `(design:[^`]+)`\s*$/m);
-            const url = body.match(/^- \[Figmaで開く\]\((https?:[^)]+)\)\s*$/m);
-            if (id && url)
-                map.set(id[1], url[1]);
-        }
-        catch {
-            // 読めないファイルはスキップ
+    //
+    // #727 K10 で、コメントだけを取り込む案件（栓 `design_comments_only`）は inventory を持たず、
+    // `デザイン/指摘/<ファイル>/README.md`（`design:{fileKey}` と「Figmaで開く」）と
+    // 月ごとの `YYYY-MM.md`（スレッドごとの `figma-comment:` と「Figmaでこの指摘を開く」）になる。
+    // 移行期は両方ありうるので**両方歩く**。inventory を先に歩き、同じ ID は先勝ち
+    // （＝inventory があれば今までと同じ URL。1バイトも変えない）。
+    // 表に無い `design:` / `figma-comment:` は `figmaUrlFromRef` がキーから組む（解決器の側）。
+    for (const sub of ["inventory", "指摘"]) {
+        for (const file of await walkMd(path.join(repoRoot, designDir, sub))) {
+            try {
+                const body = await node_fs_1.promises.readFile(file, "utf8");
+                const id = body.match(/^- 参照ID: `(design:[^`]+)`\s*$/m);
+                const url = body.match(/^- \[Figmaで開く\]\((https?:[^)]+)\)\s*$/m);
+                if (id && url && !map.has(id[1]))
+                    map.set(id[1], url[1]);
+                for (const [cid, curl] of figmaCommentLinks(body))
+                    if (!map.has(cid))
+                        map.set(cid, curl);
+            }
+            catch {
+                // 読めないファイルはスキップ
+            }
         }
     }
     // minute:{定例名}:{YYYYMMDD} → 議事録ファイルのGitHubリンク
@@ -1405,6 +1493,70 @@ async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
     }
     return map;
 }
+/**
+ * 指摘のスレッドから `figma-comment:{fileKey}:{commentId}` → 「Figmaでこの指摘を開く」の URL を拾う。
+ *
+ * engine の `render_thread` の形（`### 未解決: …` の見出し・`- 参照ID:`・`- [Figmaでこの指摘を開く](…)`）。
+ * **対は同じスレッドの中でだけ組む。** 次の `### ` 見出しを越えて拾うと、リンクの欠けた
+ * スレッドに隣のスレッドの URL を付けてしまう（押すと別の指摘へ飛ぶ——エラーの出ない壊れ方）。
+ */
+function figmaCommentLinks(body) {
+    const out = [];
+    let pending = null;
+    for (const line of body.split("\n")) {
+        if (/^#{1,3}\s/.test(line)) {
+            pending = null;
+            continue;
+        }
+        const id = line.match(/^- 参照ID: `(figma-comment:[^`]+)`\s*$/);
+        if (id) {
+            pending = id[1];
+            continue;
+        }
+        const url = line.match(/^- \[Figmaでこの指摘を開く\]\((https?:[^)]+)\)\s*$/);
+        if (url && pending) {
+            out.push([pending, url[1]]);
+            pending = null;
+        }
+    }
+    return out;
+}
+/** Figma のファイルキー（engine `sync_designs.py` の `REAL_FIGMA_KEY` と同じ形） */
+const FIGMA_KEY = /^[A-Za-z0-9_-]{8,}$/;
+/** Figma のノード ID（`103:1836`。URL では `103-1836` と書く） */
+const FIGMA_NODE = /^\d+:\d+$/;
+/**
+ * `design:` / `figma-comment:` の参照から、**キーとノードだけで** Figma の URL を組む（#727 K10）。
+ *
+ * コメントだけを取り込む案件には画面ごとの inventory が無いので、Gold の
+ * `design:{fileKey}:{nodeId}` を表から引けない。画面の本体は Figma にあるので、キーとノードが
+ * 揃っていれば URL は決まる（スラグは Figma が読まないので付けない）。
+ *   - `design:{key}:{node}` → `https://www.figma.com/design/{key}?node-id={node の : を -}`
+ *   - `design:{key}` → `https://www.figma.com/design/{key}`
+ *   - `figma-comment:{key}:{id}` → `https://www.figma.com/design/{key}#{id}`
+ *     （フラグメントはサーバーに送られないので、外れてもファイルには着く。engine の `comment_link` と同じ倒し方）
+ *
+ * 🔴 **形の合わないものは組まない（null）。** キー・ノードに任意の文字列を通すと、
+ * `design:../../x` や `design:abc:1:2?x=` から**押せそうで 404** の URL ができる。
+ * 壊れたリンクは、無いより悪い。
+ */
+function figmaUrlFromRef(ref) {
+    const d = ref.match(/^design:([^:]+)(?::(.+))?$/);
+    if (d) {
+        const [, key, node] = d;
+        if (!FIGMA_KEY.test(key))
+            return null;
+        if (node === undefined)
+            return `https://www.figma.com/design/${key}`;
+        if (!FIGMA_NODE.test(node))
+            return null;
+        return `https://www.figma.com/design/${key}?node-id=${node.replace(":", "-")}`;
+    }
+    const c = ref.match(/^figma-comment:([^:]+):(\d+)$/);
+    if (c && FIGMA_KEY.test(c[1]))
+        return `https://www.figma.com/design/${c[1]}#${c[2]}`;
+    return null;
+}
 /** 画像・添付など、グラフのノードにしないリンクの拡張子 */
 const NON_DOC_LINK = /\.(png|jpe?g|gif|svg|webp|ico|zip|mp4|mov|heic)([?#]|$)/i;
 /** 本文markdownからhttp(s)リンクを抽出する（重複除去・画像等は除外） */
@@ -1509,7 +1661,8 @@ async function scanContent(repoRoot, goldDirName, repoBaseUrl, branch) {
                     }
                 }
                 for (const r of toRelations(data.relations))
-                    edges.push({ target: r.target, rel: r.rel });
+                    if (!exports.MIRROR_RELS.has(r.rel))
+                        edges.push({ target: r.target, rel: r.rel });
             }
             else {
                 const keyMatch = raw.slice(0, 4000).match(/^- 課題キー: (\S+)$/m);
@@ -1586,9 +1739,13 @@ function buildGraph(decisions, home, sections, content, targetUrls, repoBaseUrl,
             return resolved;
         let group = "phantom";
         let label = target;
-        if (target.startsWith("minute:") || target.startsWith("material:") || target.startsWith("design:")) {
+        if (target.startsWith("minute:") ||
+            target.startsWith("material:") ||
+            target.startsWith("design:") ||
+            target.startsWith("figma-comment:")) {
             group = "silver";
-            const url = targetUrls.get(target);
+            // 表に無い design: / figma-comment: はキーから組む（詳細画面の resolve と同じ順）
+            const url = targetUrls.get(target) ?? figmaUrlFromRef(target);
             if (url)
                 return addNode({ id: target, label, group, url });
         }
@@ -1618,6 +1775,9 @@ function buildGraph(decisions, home, sections, content, targetUrls, repoBaseUrl,
     };
     const addRelationEdges = (fromId, relations) => {
         for (const r of relations) {
+            // 🔴 `superseded_by` は描かない（#699 F3）。新しい側の `supersedes` の写しで、描くと同じ置き換えが 2 本になる
+            if (exports.MIRROR_RELS.has(r.rel))
+                continue;
             edges.push({ from: fromId, to: classifyTarget(r.target), rel: r.rel });
         }
     };
@@ -2043,8 +2203,8 @@ async function build(opts) {
     // 同一プロセスで2回ビルドしても前回の値が残らないよう、毎回入れ替える
     PROPOSALS_BY_PATH = await readGoldProposals(repoRoot);
     PROPOSAL_PATHS_MATCHED = new Set();
-    // 再導出の 3 帳簿（#665 便 12b）。**帳簿が無い案件では帯も並び替えも作らない**ので、
-    // 読めたときだけ git の素性を取りに行く（帳簿を持たない 44 案件で git の呼び出しを増やさない）
+    // 再導出の 3 帳簿（#665 便 12b）。**帳簿が無い案件では帯も並び替えも作らない**。
+    // 人か機械かの見分けは engine が帳簿（`rewritten`）に書くので、画面は git の素性を読まない（#799）
     const ledgers = await (0, rederivation_1.readRederivationLedgers)(repoRoot);
     const rederive = ledgers.confirmation.size || ledgers.activity.size
         ? {
@@ -2052,10 +2212,9 @@ async function build(opts) {
             // 🔴 **`repoRoot` で走らせる**（`collectAiChangeHistory` の `process.cwd()` に倣わない）。
             // あちらは「リポジトリルートで実行すること」が前提の既存の制約だが、こちらは repoRoot を
             // 既に知っている（帳簿をそこから読んでいる）。Decisions ディレクトリから CLI を叩いた
-            // ときも pathspec が当たり、帯が黙って消えない
+            // ときも今の版と基準版が引け、帯が黙って消えない
             repoRoot: repoRoot,
-            identities: ledgers.confirmation.size ? (0, repo_1.collectGoldCommitIdentities)(repoRoot) : new Map(),
-            miss: { unresolved: new Set(), unreadable: new Set() },
+            miss: { unreadable: new Set() },
             blobs: { read: 0, skipped: 0 },
         }
         : null;
@@ -2063,11 +2222,18 @@ async function build(opts) {
     // **読めない・使えないなら `null`** で、関係者の並びは今までと 1 バイトも同じ
     const engagement = await (0, engagement_1.readEngagementLedger)(repoRoot);
     const decisions = [];
+    const rawDates = new Map();
     for (const fileName of mdFiles) {
         const raw = await node_fs_1.promises.readFile(path.join(dirAbs, fileName), "utf8");
         const rec = await parseDecision(raw, fileName, repoRelDir, repo.baseUrl, repo.branch, refs);
         decisions.push(rec);
+        // 置き換えの逆引きの決定日（書かれたままの文字列・SiteData には載せない）
+        const rd = rawFrontmatterDate(raw);
+        if (rd !== undefined)
+            rawDates.set(rec, rd);
     }
+    // 置き換えの逆引き（#699 F3）。**置き換えの無い案件では 1 件も付かない**
+    attachSupersedes(decisions, (d) => rawDates.get(d) ?? d.fm.date);
     // 決定の「その後」（#705）。**帳簿を持たない案件では 1 件も付かず、絞り込みの印も立たない**
     // （`decisionFollowup` はキーごと無い＝今までと 1 バイトも同じ画面）
     const followupLedger = await (0, rederivation_1.readDecisionFollowup)(repoRoot);
@@ -2152,30 +2318,20 @@ async function build(opts) {
     // **突き合わなかった提案の件数をビルドログに出す。** path が1文字違うだけで
     // 画面から静かに消えるので、出さないと「提案が出ない」の原因に辿り着けない。
     // 表示からは落とす（どのレコードの話か分からない提案は、出しても行動につながらない）
-    // 🔴 **帯が静かに消える経路を 1 行残す（設計レビュー 🟡10）。** `changed_by` の sha が
-    // git の窓（fetch-depth 2000）の外にあると、人か機械か見分けられない＝帯が立たない。
-    // 画面には出さない（利用者が動ける症状ではない）が、ログに無いと「帯が出ない」の原因を
-    // 「夜間がまだ書いていない」と切り分けられない
-    if (rederive && rederive.miss.unresolved.size) {
-        const shas = [...rederive.miss.unresolved];
-        console.warn(`gold-confirmation.json: 変更のコミット ${shas.length} 件を git の履歴で引けませんでした` +
-            `（浅い clone か履歴の窓の外。人か機械か見分けられないので帯は出しません）: ` +
-            shas.slice(0, 3).map((s) => s.slice(0, 8)).join(", ") + (shas.length > 3 ? " ほか" : ""));
-    }
-    // 🔴 **印が静かに消えるもう 1 つの経路を 1 行残す。** 人が確認した版の中身を git から
-    // 引けないと「説明文が変わったか」を言えないので、印は出さない（誤報より無言）。
+    // 🔴 **帯が静かに消える経路を 1 行残す。** 今の版か、人が確認した版の中身を
+    // 引けないと「説明文が変わったか」を言えないので、帯は出さない（誤報より無言）。
     // 出さないと「印が出ない」の原因を「中身が変わっていない」と切り分けられない
     if (rederive && rederive.miss.unreadable.size) {
         const paths = [...rederive.miss.unreadable];
-        console.warn(`gold-confirmation.json: 人が確認した版の中身を ${paths.length} 件引けませんでした` +
-            `（浅い clone か、確認の後に改名・削除された。変わったかを言えないので印は出しません）: ` +
+        console.warn(`gold-confirmation.json: 人が確認した版か今の版の中身を ${paths.length} 件引けませんでした` +
+            `（浅い clone か、確認の後に改名・削除された。変わったかを言えないので帯は出しません）: ` +
             paths.slice(0, 3).join(", ") + (paths.length > 3 ? " ほか" : ""));
     }
     // 🔴 **指紋（engine #546）が効いているかを 1 行残す。** 一致した記録は git を読まないので、
     // 「読んだ件数」が候補の数より減っていれば効いている。警告ではないので console.log
     if (rederive?.blobs && rederive.blobs.read + rederive.blobs.skipped > 0) {
         console.log(`gold-confirmation.json: 人が確認した版の中身を git から ${rederive.blobs.read} 件読みました` +
-            `（中身の指紋が一致した ${rederive.blobs.skipped} 件は読んでいません）`);
+            `（中身の指紋で決めた ${rederive.blobs.skipped} 件は読んでいません）`);
     }
     const unmatched = [...PROPOSALS_BY_PATH.keys()].filter((k) => !PROPOSAL_PATHS_MATCHED.has(k));
     if (unmatched.length) {
@@ -2399,6 +2555,10 @@ function createRefResolver(opts) {
         const known = targetUrls.get(trimmed);
         if (known)
             return { label: trimmed, url: known };
+        // inventory の無い案件（#727 K10）の design: / figma-comment: は、キーとノードから組む
+        const figma = figmaUrlFromRef(trimmed);
+        if (figma)
+            return { label: trimmed, url: figma };
         // 実在するファイルだけ blob URL にする
         if (repoBaseUrl && exists(trimmed)) {
             return { label: trimmed, url: `${repoBaseUrl}/blob/${branch}/${encodePath(trimmed)}` };

package/dist/engagement.js

@@ -50,7 +50,7 @@ exports.ENGAGEMENT_LEDGER_VERSION = 1;
 /** 半減期（日）。engine `weights.mjs` の `HALF_LIFE_DAYS`（正本 6-B「半減期 90 日固定」） */
 exports.HALF_LIFE_DAYS = 90;
 /**
- * 行為 1 件の重み。engine `weights.mjs` の `WEIGHTS` の写し（22 値・**表に無い `kind` は 0**）。
+ * 行為 1 件の重み。engine `weights.mjs` の `WEIGHTS` の写し（24 値・**表に無い `kind` は 0**）。
  *
  * 🔴 契約の表（fixture）は `message.posted` しか使っていないので、**ここの写し間違いは表では
  * 捕まらない**。重みの番人は `test/member-engagement-parity.test.mjs` の `[重み]` が持つ。
@@ -80,6 +80,9 @@ exports.WEIGHTS = Object.freeze({
     "record.deleted": 0,
     // 本文を取り込んだ（engine #695）。人の行為ではないので 0（話した人は `utterance.spoken` で数える）
     "body.captured": 0,
+    // 人の宣言の指紋（cortex-engine #699 F1）。宣言の取り込みが書く行で、関与には数えない（0）。
+    // 場は宣言専用（`decl:<owner/repo>`）で帳簿にもともと入らないが、網羅のため写す
+    "decl.recorded": 0,
 });
 const DAY_MS = 86400000;
 const cmp = (a, b) => (a < b ? -1 : a > b ? 1 : 0);

package/dist/external-id.js

@@ -106,8 +106,8 @@ function splitTypedId(v) {
  * 両方がこれを引く。
  *
  * 🔴 画面の中では `identities` と呼ばない（`linkedIds` / `.linked-ids` / `.li-*`）。
- * `identities` という語は、このリポジトリでは既に `GoldCommitIdentity`
- *（帯のコミットの筆者）の意味で使っている——同じ語を 2 つの意味で使わない。
+ * `identities` という語は、このリポジトリでは `GoldCommitIdentity`
+ *（帯のコミットの筆者・#799 で撤去）の意味で使っていた——同じ語を 2 つの意味で使わない。
  */
 exports.FM_LINKED_IDS = "identities";
 /**