@takagaki/cortex-decisions-viewer 0.12.85 → 0.12.87

package/dist/supersedes.js

@@ -0,0 +1,112 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIRMED_STATUS = void 0;
+exports.decisionKeyOf = decisionKeyOf;
+exports.decisionDateOf = decisionDateOf;
+exports.supersedesIndex = supersedesIndex;
+exports.supersedesOf = supersedesOf;
+exports.retiredIdsOf = retiredIdsOf;
+/**
+ * 決定の置き換え（`supersedes`）の逆引き（cortex-engine #699 F3・オーナー決定 A-1'・A-1''）。
+ *
+ * ## 🔴 これは写しで、正本は engine にある
+ *
+ * 正本: cortex-engine `scripts/gold/supersedes-index.mjs`（`supersedesIndex`・`decisionKeyOf`・
+ * `decisionDateOf`）。**題材で一致を確かめる**: 両リポに同じ `supersedes-index-contract.json`
+ * （tools は `test/fixtures/`）を置き、`test/supersedes-index-parity.test.mjs` が全ケースを流す。
+ * 規則を変えるときは engine の正本・この写し・題材を同じ日に直す（**tools 側で規則を足さない**）。
+ *
+ * ## 規則（A-1'）
+ *
+ * 1. 置き換えの正本は**新しい側の `relations[supersedes]` だけ**。古い側の `superseded_by`
+ *    （engine の夜間の精製が書く写し）は逆引きの材料にしない
+ * 2. **確認済み＝新しい側の `status` が `active`**。空・`draft`・語彙の外は「未確認」
+ * 3. **置き換えられた（もう有効でない・retired）＝確認済みの置き換えが 1 本以上**
+ * 4. 置き換え先は**全部・新しい順**（決定日の降順 → ID の降順・同じ ID は 1 回）
+ * 5. 自分自身を指す・実在しない ID は数えない。古い側の `status` は問わない
+ */
+const node_path_1 = __importDefault(require("node:path"));
+/** 確認済みとみなす新しい側の status（これだけ） */
+exports.CONFIRMED_STATUS = "active";
+/**
+ * 決定を指す文字列を突き合わせの鍵にする（`decision:` の頭・パス・`.md` を落とす）。
+ * engine は `path.basename`（Linux で走る＝posix）なので、ここも posix で固定する
+ */
+function decisionKeyOf(ref) {
+    return node_path_1.default.posix.basename(String(ref ?? "").trim().replace(/^decision:/, ""), ".md");
+}
+/** `YYYY-MM-DD`。frontmatter の `date`（`20260910` / `2026-09-10`）→ ID の先頭 8 桁 → 無ければ空 */
+function decisionDateOf(date, id) {
+    const raw = String(date ?? "").trim();
+    const ymd = raw.match(/^(\d{4})-?(\d{2})-?(\d{2})/) || decisionKeyOf(id).match(/^(\d{4})(\d{2})(\d{2})/);
+    return ymd ? `${ymd[1]}-${ymd[2]}-${ymd[3]}` : "";
+}
+function normalize(d) {
+    if (!d || typeof d !== "object")
+        return null;
+    const r = d;
+    const id = String(r.id ?? "").trim();
+    if (!id)
+        return null;
+    return {
+        id,
+        key: decisionKeyOf(id),
+        date: decisionDateOf(r.date, id),
+        status: typeof r.status === "string" ? r.status.trim() : "",
+        supersedes: (Array.isArray(r.supersedes) ? r.supersedes : []).map(decisionKeyOf).filter(Boolean),
+    };
+}
+/** 新しい順（決定日の降順 → ID の降順）。日付の無いものは最後 */
+function newestFirst(a, b) {
+    if (a.date !== b.date) {
+        if (!a.date)
+            return 1;
+        if (!b.date)
+            return -1;
+        return a.date < b.date ? 1 : -1;
+    }
+    return a.id < b.id ? 1 : a.id > b.id ? -1 : 0;
+}
+/**
+ * 置き換えの逆引き。
+ *
+ * @returns `Map<古い決定の鍵, SupersedesEntry>`。置き換えが 1 本も無い決定は入らない
+ */
+function supersedesIndex(decisions) {
+    const src = decisions instanceof Map ? decisions.values() : decisions || [];
+    const list = [...src].map(normalize).filter((d) => d !== null);
+    const byKey = new Map();
+    for (const d of list)
+        if (!byKey.has(d.key))
+            byKey.set(d.key, d);
+    const out = new Map();
+    for (const d of list) {
+        for (const target of new Set(d.supersedes)) {
+            const old = byKey.get(target);
+            if (!old || old.key === d.key)
+                continue; // 実在しない・自分自身
+            const entry = out.get(old.key) || { id: old.id, by: [], retired: false };
+            if (entry.by.some((x) => decisionKeyOf(x.id) === d.key))
+                continue;
+            const confirmed = d.status === exports.CONFIRMED_STATUS;
+            entry.by.push({ id: d.id, date: d.date, status: d.status, confirmed });
+            if (confirmed)
+                entry.retired = true;
+            out.set(old.key, entry);
+        }
+    }
+    for (const entry of out.values())
+        entry.by.sort(newestFirst);
+    return out;
+}
+/** その決定の逆引き（無ければ空の形） */
+function supersedesOf(index, id) {
+    return index.get(decisionKeyOf(id)) || { id: String(id ?? ""), by: [], retired: false };
+}
+/** 置き換えられた（確認済みの置き換えがある）決定の ID の集合 */
+function retiredIdsOf(index) {
+    return new Set([...index.values()].filter((e) => e.retired).map((e) => e.id));
+}

package/package.json

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

package/dist/commit-classify.js

@@ -1,157 +0,0 @@
-"use strict";
-/**
- * コミットを **人／機械／不明** の 3 値に分ける（#665 便 12b・#432 裁定 5-4 / 5-7）。
- *
- * ## 🔴 これは写しで、正本は engine にある
- *
- * 正本: cortex-engine `scripts/observe/commit-classify.mjs`。表（入力 → 3 値）:
- * cortex-engine `test/observe-commit-classify.test.mjs` の 12 行。
- * **写すのはこの表で、実装を書き写すのではない**——同じ入力を両方に流して突き合わせる
- * （`connection-state-keys.mjs` の写しと同じ流儀）。tools 側の表は
- * `test/fixtures/commit-classify-contract.json` にあり、`commit-classify-parity.test.mjs`
- * が全行を流す。**engine が判定を変えたらこの fixture を差し替える**（テストは書き換えない）。
- *
- * 🔴 **tools 側で規則を足さない。** 「再導出:」のような件名を足したくなっても、足す先は
- * engine の正本（写しに足すと、正本と写しが逆向きにずれて契約テストが意味を失う）。
- *
- * ## なぜ `repo.ts` の `classifyCommit` と別に置くのか
- *
- * `repo.ts` のものは**別の問い**に答える 3 値（human / migration / ai）で、画面の
- * 「AI による最近の変更」が使っている。あれを揃えるのは #646 の便で、この便では触らない
- * ——揃えると 44 案件の既存の画面（履歴の節）が同時に変わる。ここは**新しい帯の条件だけ**が
- * 使う判定で、**既定は「不明」**（証拠が無ければ倒さない）。
- *
- * ## 裁定（2026-09-17・#432 のコメント 5-4）
- *
- * > Claude Code 経由の push も「人が書いた」に数える（責任の所在で決める。人の名義で本人が
- * > 結果を見て push している）。件数の閾値は設けない。「機械」に数えるのは**夜間処理・
- * > マイグレーション・一括取り込みだけ**。
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DELETE_SUBJECT_RE = exports.CONFIRM_SUBJECT_RE = exports.MIGRATION_REASON = void 0;
-exports.looksLikeMigrationSubject = looksLikeMigrationSubject;
-exports.operatedByKind = operatedByKind;
-exports.classifyGoldCommit = classifyGoldCommit;
-exports.isMachineRewrite = isMachineRewrite;
-/**
- * 機械の名義（**この 3 経路だけ**が機械）。`why` は `reason` にそのまま出る。
- *
- * 🔴 **`reason` の綴りは帯の条件が読む**（マイグレーションだけは帯を立てない・#665）。
- * 綴りを変えるなら正本と fixture と `MIGRATION_REASON` を同時に見ること。
- */
-const MACHINE_SUBJECTS = [
-    { re: /^自動追記/, why: "夜間処理" },
-    { re: /^自動生成/, why: "夜間処理" },
-    { re: /^週次整理/, why: "夜間処理（週次）" },
-    { re: /^(?:マイグレーション|migrate:|chore\(migrate\))/i, why: "マイグレーション" },
-    { re: /^一括取り込み/, why: "一括取り込み" },
-];
-/** マイグレーションの `reason`。**帯を立てない側に倒す鍵の 1 枚目**（#665 決定表 4d） */
-exports.MIGRATION_REASON = "マイグレーション";
-/**
- * 🔴 **「引っ越し」の綴りの 2 枚目**（`repo.ts:230` の写し・設計レビュー 🔴1）。
- *
- * 正本の `MACHINE_SUBJECTS` のマイグレーションの行は件名の**頭**を `マイグレーション` /
- * `migrate:` / `chore(migrate)` で見るが、**艦隊の実際の件名は
- * `エンジンマイグレーションを適用（schema_version更新）`** で、頭が「エンジン」なので
- * 当たらない（実測: レコードを触った 127 件のうち 93 件が「機械の名義」の枝に落ち、
- * engine の `isMigration()` では 0 件になる＝`changed_by` から除かれていない）。
- *
- * この 1 枚が無いと、**引っ越しの翌朝に確認済みのレコード全件へ帯が出る**——実データの
- * コミットの 53.6% が引っ越しで、中身は 1 文字も変わっていない。
- *
- * ⚠️ これは**正本に足すべき規則**（申し送り済み）。正本が拾うようになってもこの枚は
- * 害にならない（両方が「引っ越し」と言うだけ）ので、**消すのは正本が実件名を拾ったあと**。
- * 綴りは画面の「AI による最近の変更」が使う `repo.ts` の判定とそろえてある——ずれると
- * 「履歴からは隠れているのに帯は立つ」という食い違った 1 ページができる（🔴7）。
- */
-const MIGRATION_SUBJECT_RE = /^(エンジン)?マイグレーション|^スキーマ移行|^schema[_-]?version|^(apply\s+)?[a-z ]*migration/i;
-/** 件名が「データ構造の引っ越し」の規約か（`repo.ts` の綴り） */
-function looksLikeMigrationSubject(subject) {
-    return MIGRATION_SUBJECT_RE.test(String(subject || ""));
-}
-/** 機械の名義（名前）。`…[bot]` は GitHub のアプリ名義の綴り */
-const MACHINE_NAME_RE = /(?:^|\s)(?:github-actions|dependabot|renovate)(?:\[bot\])?$|\[bot\]$/i;
-/**
- * 「人の名義とは言えない」メール。`[bot]@users.noreply.github.com` は機械の名義だが、
- * `actions@github.com` のような汎用の名義は「誰が押したか分からない」＝**不明**に倒す。
- */
-const BOT_EMAIL_RE = /\[bot\]@users\.noreply\.github\.com$/i;
-const ANONYMOUS_EMAIL_RE = /^(?:actions@github\.com|noreply@github\.com|no-reply@github\.com)$/i;
-/** 人が Gold を直した印（tools の intake が書く件名。`repo.ts` と同じ綴り） */
-exports.CONFIRM_SUBJECT_RE = /^Gold確認[:：]/;
-exports.DELETE_SUBJECT_RE = /^(?:レコード削除|Gold削除)/;
-/** `Operated-By:` trailer の値から**経路だけ**を取る（値そのものは持ち回さない・PII） */
-function operatedByKind(trailerValue) {
-    const v = String(trailerValue || "").trim();
-    if (!v)
-        return "none";
-    return /^basic:/.test(v) ? "basic" : "portal";
-}
-/**
- * コミット 1 件を 3 値に分ける（正本と同じ順序・同じ規則）。
- *
- * 名前を `classifyCommit` にしない——`repo.ts` に同名で**別の問い**に答える関数があり、
- * 取り違えると画面の履歴の節と帯の条件が静かに入れ替わる。
- */
-function classifyGoldCommit({ authorName = "", authorEmail = "", committerName: _committerName = "", subject = "", body = "", } = {}) {
-    const trailer = (String(body).match(/^Operated-By:\s*(.+)$/m) || [])[1] || "";
-    const kind = operatedByKind(trailer);
-    // **検証済みか**は名乗り券の有無だけで決める（`basic:` は券が無いときの既定＝自己申告）
-    const verified = kind === "portal";
-    const confirmer = (String(subject).match(exports.CONFIRM_SUBJECT_RE)
-        ? String(subject).replace(exports.CONFIRM_SUBJECT_RE, "").trim()
-        : null) || null;
-    const out = (by, reason) => ({
-        by,
-        verified: by === "human" ? verified : false,
-        reason,
-        operatedByKind: kind,
-        confirmer,
-    });
-    // ---- 1. 機械（夜間処理・マイグレーション・一括取り込みだけ） ----
-    const machineSubject = MACHINE_SUBJECTS.find((m) => m.re.test(String(subject)));
-    if (machineSubject)
-        return out("machine", machineSubject.why);
-    if (MACHINE_NAME_RE.test(String(authorName).trim()))
-        return out("machine", "機械の名義");
-    if (BOT_EMAIL_RE.test(String(authorEmail).trim()))
-        return out("machine", "機械の名義（メール）");
-    // ---- 2. 人（**Claude Code 経由の push もここ**・裁定 5-4） ----
-    // 🔴 `Co-Authored-By: Claude` / `Generated with Claude Code` を**機械の証拠にしない**。
-    // 人の名義で本人が結果を見て push しているので、責任の所在は人にある
-    if (String(subject).match(exports.CONFIRM_SUBJECT_RE))
-        return out("human", "人が確認した（件名）");
-    if (exports.DELETE_SUBJECT_RE.test(String(subject)))
-        return out("human", "人が消した（件名）");
-    if (kind !== "none")
-        return out("human", "画面からの操作（Operated-By）");
-    const name = String(authorName).trim();
-    const email = String(authorEmail).trim();
-    if (name && email && !ANONYMOUS_EMAIL_RE.test(email))
-        return out("human", "人の名義の push");
-    // ---- 3. 既定は不明（裁定 5-7） ----
-    // 名義が空・汎用の名義（`actions@github.com`）は「誰が押したか分からない」
-    return out("unknown", "名義から人か機械か決められない");
-}
-/**
- * **帯を立てる側の機械の書き直しか**（#665 決定表 4c・4d）。
- *
- * 機械の 3 経路（夜間処理・引っ越し・一括取り込み）のうち**引っ越しだけを外す**。実データの
- * コミットの 53.6% が引っ越しで、中身は 1 文字も変わっていない（`repo.ts:199-207` の実測）
- * ので、これで帯を立てると全レコードに帯が出る。engine も `changed_by` を作るときに
- * `isMigration()` を当てているが（`history.mjs:145`）、**それは正本の綴りしか拾わない**うえに
- * **古い帳簿・作り直し前の帳簿を読む夜がある**ので、写し側でも外す。
- *
- * 🔴 **判定は 2 枚の OR**（設計レビュー 🔴1）: 正本の `reason` と `repo.ts` の綴り。
- * **どちらかが「引っ越し」と言えば立てない**（片方だけに頼ると実件名が素通りする）。
- */
-function isMachineRewrite(c, subject) {
-    if (c.by !== "machine")
-        return false;
-    if (c.reason === exports.MIGRATION_REASON)
-        return false;
-    if (looksLikeMigrationSubject(subject))
-        return false;
-    return true;
-}