@takagaki/cortex-decisions-viewer 0.12.78 → 0.12.80

package/dist/build.js

@@ -41,6 +41,7 @@ exports.sanitizeBody = sanitizeBody;
 exports.findProjectIcon = findProjectIcon;
 exports.readFleetSources = readFleetSources;
 exports.attachRederived = attachRederived;
+exports.attachDecisionFollowup = attachDecisionFollowup;
 exports.readGoldProposals = readGoldProposals;
 exports.buildHomeGrounding = buildHomeGrounding;
 exports.collectMeetings = collectMeetings;
@@ -93,6 +94,7 @@ function takeProposals(filePath) {
     PROPOSAL_PATHS_MATCHED.add(filePath);
     return hit;
 }
+const external_id_1 = require("./external-id");
 const render_1 = require("./render");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
@@ -216,6 +218,17 @@ function toSearchText(md) {
         .replace(/\s+/g, " ")
         .trim();
 }
+/**
+ * 関係者の記録だけ、検索用の plaintext の後ろに「つながっている ID」の値と email を足す（#704）。
+ * **関係者以外の記録は 1 文字も変えない**（本文から作った searchText をそのまま返す）。
+ * 足す語の正本は external-id.ts の memberSearchTerms。
+ */
+function memberSearchText(data, sectionDir, base) {
+    if (!(0, external_id_1.isMemberRecord)(data.type, data.id, sectionDir))
+        return base;
+    const extra = (0, external_id_1.memberSearchTerms)(data);
+    return extra.length ? (base ? base + " " : "") + extra.join(" ") : base;
+}
 /** dir未指定時の探索候補（新構成 → 旧構成の順） */
 const DEFAULT_DIR_CANDIDATES = ["Cortex/Decisions/records", "Cortex/Decisions", "Decisions"];
 /**
@@ -749,6 +762,31 @@ readBlobs = repo_1.readBlobsAt) {
     }
     return (0, rederivation_1.orderByActivity)(records, pathOf, statusOf, ctx.ledgers, nowIso);
 }
+/**
+ * 決定に「その後」（`.cortex/gold-decision-followup.json`・#705）を載せる。
+ *
+ * 🔴 **突き合わせはビルド時にここで閉じる**（`attachRederived` と同じ）。path は
+ * **`repoRoot` 起点**で作る——帳簿の鍵は常にリポジトリルート相対（`Cortex/Decisions/records/…`）。
+ * 画面に出す状態の結び付きが 1 件も無い決定には**キーごと付けない**（`shownFollowupOf`）。
+ *
+ * @returns 帳簿の行のうち、どの決定にも突き合わなかった path（ビルドログに 1 行出す材料）
+ */
+function attachDecisionFollowup(decisions, recordsDir, repoRoot, ledger) {
+    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;
+    }
+    return [...ledger.keys()].filter((k) => !matched.has(k.normalize("NFC")));
+}
 /**
  * AIからの更新提案（`.cortex/gold-proposals.json`）を読む。
  *
@@ -762,6 +800,10 @@ readBlobs = repo_1.readBlobsAt) {
  * **無い・壊れているときは提案ゼロで正常継続する。** 提案はあくまで付加情報で、
  * これが読めないことでレコードの表示まで止めるのは釣り合わない。
  */
+/** 文字列で中身があるときだけ返す（数・オブジェクトを String() して載せない） */
+function optionalText(v) {
+    return typeof v === "string" && v.trim() !== "" ? v : "";
+}
 async function readGoldProposals(repoRoot) {
     const empty = new Map();
     let json;
@@ -827,6 +869,25 @@ async function readGoldProposals(repoRoot) {
             reason: row.reason != null ? String(row.reason) : "",
             createdAt: row.createdAt != null ? String(row.createdAt) : "",
         };
+        // 名寄せの提案にだけ付く欄（engine の便 A・#704）。**文字列で中身があるときだけ**載せる
+        // ——無い提案にキーを生やすと、他の提案まで形が変わる（許可リストの守りのテストが見ている）。
+        // 🔴 **根拠の url（「その発言を開く」）はまだ通さない**（決定ログ 20260920-686.md の
+        // 「提案カードに新しい欄を 1 つも通さない」の url の項は生きている。20260923-704.md）
+        const kind = optionalText(row.kind);
+        if (kind)
+            proposal.kind = kind;
+        const claimKey = optionalText(row.claim_key);
+        if (claimKey)
+            proposal.claim_key = claimKey;
+        const displayName = optionalText(row.display_name);
+        if (displayName)
+            proposal.display_name = displayName;
+        const question = optionalText(row.question);
+        if (question)
+            proposal.question = question;
+        const why = optionalText(row.why);
+        if (why)
+            proposal.why = why;
         const list = byPath.get(recordPath);
         if (list)
             list.push(proposal);
@@ -975,6 +1036,9 @@ async function loadGenericRecords(dirAbs, exclude, repoBaseUrl, branch) {
         return [];
     }
     const repoRelDir = toRepoRelative(dirAbs);
+    // 区画のディレクトリ名（`records` の親）。**絶対パスから取る**——cwd 相対の repoRelDir は
+    // cwd がリポジトリルートでないと `records` に倒れる（isMemberRecord の注意書き）
+    const sectionDir = path.basename(dirAbs) === "records" ? path.basename(path.dirname(dirAbs)) : path.basename(dirAbs);
     const records = [];
     for (const e of entries) {
         if (!e.isFile() || !e.name.toLowerCase().endsWith(".md"))
@@ -982,7 +1046,7 @@ async function loadGenericRecords(dirAbs, exclude, repoBaseUrl, branch) {
         if (exclude.has(e.name.toLowerCase()))
             continue;
         const raw = await node_fs_1.promises.readFile(path.join(dirAbs, e.name), "utf8");
-        records.push(await parseGeneric(raw, e.name, repoRelDir, repoBaseUrl, branch));
+        records.push(await parseGeneric(raw, e.name, repoRelDir, repoBaseUrl, branch, sectionDir));
     }
     // 日付降順 → タイトル昇順（用語集のように日付が同一でも安定して並ぶ）
     //
@@ -1000,7 +1064,7 @@ async function loadGenericRecords(dirAbs, exclude, repoBaseUrl, branch) {
     });
     return records;
 }
-async function parseGeneric(raw, fileName, repoRelDir, repoBaseUrl, branch) {
+async function parseGeneric(raw, fileName, repoRelDir, repoBaseUrl, branch, sectionDir = "") {
     const { data, content } = (0, gray_matter_1.default)(raw);
     const h1 = content.match(/^#\s+(.+)$/m);
     const id = String(data.id ?? fileName.replace(/\.md$/i, ""));
@@ -1028,7 +1092,7 @@ async function parseGeneric(raw, fileName, repoRelDir, repoBaseUrl, branch) {
         bodyHtml,
         bodyRef: "",
         bodyId: "",
-        searchText: toSearchText(content),
+        searchText: memberSearchText(data, sectionDir, toSearchText(content)),
         fileName,
         editUrl,
         rtype: data.type != null ? String(data.type) : "",
@@ -1993,6 +2057,17 @@ async function build(opts) {
         const rec = await parseDecision(raw, fileName, repoRelDir, repo.baseUrl, repo.branch, refs);
         decisions.push(rec);
     }
+    // 決定の「その後」（#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;
@@ -2125,6 +2200,8 @@ async function build(opts) {
                 projectKey: opts.projectKey,
             }
             : undefined,
+        // 帳簿を読めた案件だけ true（無い・壊れ・版違いはキーごと出さない）
+        decisionFollowup: followupLedger ? true : undefined,
         meetings,
         // **URLとトークンが両方そろったときだけ出す。** 片方だけでは貼れるURLを作れないので、
         // 手順だけが出て「専用URLが空」という一番混乱する形になる（intake と同じ扱い）
@@ -2225,6 +2302,7 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch, ref
     const referencesRaw = toStringArray(data.references);
     const references = referencesRaw.map((r) => refs.resolve(r));
     const relations = toRelations(data.relations);
+    const followupHuman = (0, rederivation_1.humanFollowupOf)(data.followup);
     // 本文先頭の H1 はタイトルと重複するため除去（詳細画面ではタイトルを別途表示する）
     const bodyHtml = await renderRecordBody(content);
     const filePath = repoRelDir ? `${repoRelDir}/${fileName}` : fileName;
@@ -2253,6 +2331,8 @@ async function parseDecision(raw, fileName, repoRelDir, repoBaseUrl, branch, ref
         editUrl,
         fm: sanitizeFm(data),
         fmErrors: validateFm(data),
+        // 担当者の答え（#705）。**語彙外・形が違うものはキーごと載せない**
+        ...(followupHuman ? { followupHuman: followupHuman } : {}),
     };
 }
 function createRefResolver(opts) {

package/dist/external-id.js

@@ -27,6 +27,7 @@ exports.isExternalId = isExternalId;
 exports.splitTypedId = splitTypedId;
 exports.isMemberRecord = isMemberRecord;
 exports.isMemberRecordPath = isMemberRecordPath;
+exports.memberSearchTerms = memberSearchTerms;
 /**
  * このリポジトリの内側の呼び名。外の ID と見なさない。
  *
@@ -128,7 +129,9 @@ function isMemberRecord(type, id, sectionDir) {
         return true;
     if (typeof id === "string" && id.startsWith("member:"))
         return true;
-    return sectionDir === "Members";
+    // 日本語のディレクトリ名を使っている案件があるので、旧名「メンバー」も新名「関係者」も引く
+    //（画面の isMemberRec と同じ 3 つ・#704）
+    return sectionDir === "Members" || sectionDir === "メンバー" || sectionDir === "関係者";
 }
 /** そのリポジトリ相対パスが関係者の記録の置き場か（git のパスは cwd に依存しない） */
 function isMemberRecordPath(repoPath) {
@@ -146,3 +149,36 @@ function isMemberRecordPath(repoPath) {
 exports.TYPED_ID_WHOLE_SRC = "^" + TYPED_ID_SRC + "$";
 /** 内側の呼び名の一覧（同上。埋め込み JS が `splitTypedId` と同じ除外を持つため） */
 exports.INSIDE_KIND_LIST = [...INSIDE_KINDS];
+/**
+ * 関係者の記録の検索索引に足す語（#704）。**ID の値で関係者を引けるようにする。**
+ *
+ * - `identities` の各行の `id` を**全体**（`slack_user:U0…`）で入れる。画面の検索は部分一致なので、
+ *   人が値だけ（`U0…`）を打っても当たる——種類を外した値を別に足すのは冗長なので足さない
+ * - `email` の欄（文字列で中身があるとき）
+ *
+ * 🔴 **`not_aliases`（否定済み）は入れない。** 「私ではない」と言った ID で引いて
+ * その人が出てくると、検索が「この ID はこの人だ」と言っているように読める。
+ * 🔴 **関係者以外の記録には呼ばない**（呼び出し側が isMemberRecord で絞る）。
+ */
+function memberSearchTerms(fm) {
+    const out = [];
+    const push = (v) => {
+        const t = v.trim();
+        if (t && !out.includes(t))
+            out.push(t);
+    };
+    const list = fm[exports.FM_LINKED_IDS];
+    if (Array.isArray(list)) {
+        for (const ent of list) {
+            if (!ent || typeof ent !== "object" || Array.isArray(ent))
+                continue;
+            const id = ent.id;
+            if (typeof id !== "string" || id.trim() === "")
+                continue;
+            push(id);
+        }
+    }
+    if (typeof fm.email === "string")
+        push(fm.email);
+    return out;
+}

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.emptyLedgers = exports.LEDGER_VERSION = void 0;
+exports.HUMAN_FOLLOWUP_STATES = exports.FOLLOWUP_EVIDENCE_VERDICTS = exports.FOLLOWUP_SHOWN_STATES = exports.DECISION_FOLLOWUP_FILE = exports.emptyLedgers = exports.LEDGER_VERSION = void 0;
 exports.isConfirmedStatus = isConfirmedStatus;
 exports.parseLedger = parseLedger;
 exports.readRederivationLedgers = readRederivationLedgers;
@@ -15,6 +15,10 @@ exports.contentShaOf = contentShaOf;
 exports.rederivedContentKey = rederivedContentKey;
 exports.rederivedBandOf = rederivedBandOf;
 exports.orderByActivity = orderByActivity;
+exports.followupDateOf = followupDateOf;
+exports.readDecisionFollowup = readDecisionFollowup;
+exports.shownFollowupOf = shownFollowupOf;
+exports.humanFollowupOf = humanFollowupOf;
 /**
  * 再導出の 3 帳簿を読み、帯「人が確認した版から変わりました」と用語集の並びを作る（#665 便 12b）。
  *
@@ -527,3 +531,164 @@ function orderByActivity(records, pathOf, statusOf, ledgers, nowIso) {
     })
         .map((s) => s.r);
 }
+/* ---------------------------------------------------------------------------
+ * 決定の「その後」の帳簿（#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）。「未接続のため」「記録なし」の文を画面に並べない——出来事だけを出す。
+ */
+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` に畳む。
+ *
+ * 🔴 **engine の `at` は日付とは限らない**（`decision-links.mjs` の `terminalStateOf` は
+ * `merged_at` / `updated_at` の **ISO 日時**をそのまま入れる）。時刻つきのものは
+ * **JST の日付**に直す——UTC の先頭 10 文字を切ると、日本の夜に閉じた課題が前日に見える。
+ * 読めないもの（null・数・壊れた文字列）は空。
+ */
+function followupDateOf(v) {
+    if (v instanceof Date)
+        return Number.isFinite(v.getTime()) ? v.toISOString().slice(0, 10) : "";
+    const s = typeof v === "string" ? v.trim() : "";
+    if (!s)
+        return "";
+    if (/^\d{4}-\d{2}-\d{2}$/.test(s))
+        return s;
+    if (!/^\d{4}-\d{2}-\d{2}T/.test(s))
+        return "";
+    const ms = Date.parse(s);
+    if (!Number.isFinite(ms))
+        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 行）を読む。
+ *
+ * 形は `followup: { state: done, at: 2026-09-20 }`（intake `setFollowupLine` が書く）。
+ * YAML は `at` を Date に読むので日付に戻す。**語彙外・形が違うものは `null`**（載せない）。
+ */
+function humanFollowupOf(v) {
+    const o = asRecord(v);
+    if (!o)
+        return null;
+    const state = typeof o.state === "string" ? o.state : "";
+    if (!exports.HUMAN_FOLLOWUP_STATES.includes(state))
+        return null;
+    const at = followupDateOf(o.at);
+    if (!at)
+        return null;
+    return { state: state, at: at };
+}