@takagaki/cortex-decisions-viewer 0.12.17 → 0.12.19

package/dist/repo.js

@@ -7,6 +7,7 @@ exports.normalizeToHttps = normalizeToHttps;
 exports.classifyCommit = classifyCommit;
 exports.isFrontmatterKeyRename = isFrontmatterKeyRename;
 exports.collectAiChangeHistory = collectAiChangeHistory;
+exports.lastSubstantiveUpdate = lastSubstantiveUpdate;
 const node_child_process_1 = require("node:child_process");
 /**
  * GitHubのowner/repoを表すベースURLを解決する。
@@ -250,8 +251,13 @@ function isFrontmatterKeyRename(before, after) {
  * 揃えないと、人が「改名しながら中身も直した」変更が**無音で消える**。
  */
 const RENAME_OPT = "--find-renames=90%";
-/** git log を1回。失敗（git 無し・リポジトリでない・出力が大きすぎる）は空文字にする */
-function gitLog(cwd, args) {
+/**
+ * git log を1回。失敗（git 無し・リポジトリでない・出力が大きすぎる）は空文字にする。
+ * @param what 警告に出す「何が取れなかったか」。呼び出し元が増えたので引数化した——
+ *   固定文のままだと Home の最終更新日が取れない日に「AIの変更履歴を…」という
+ *   嘘の警告が出て、診断がその文言に引っ張られる
+ */
+function gitLog(cwd, args, what = "AIの変更履歴") {
     try {
         // 🔴 **出力の形は、読む人の git 設定に左右させない。** ここで組み立てているのは
         // 機械が読む出力なので、人の ~/.gitconfig で形が変わる余地を全部潰す:
@@ -294,7 +300,7 @@ function gitLog(cwd, args) {
         // 戻り値の契約（空文字 = 履歴なしで正常継続）はどちらでも変えない
         const err = e;
         if (err.code !== "ENOENT" && err.status !== 128) {
-            console.warn(`AIの変更履歴を git から取れませんでした（履歴は出さずに続けます）: ${String(e)}`);
+            console.warn(`${what}を git から取れませんでした（表示は出さずに続けます）: ${String(e)}`);
         }
         return "";
     }
@@ -687,3 +693,126 @@ function collectAiChangeHistory(cwd) {
     }
     return history;
 }
+// ---- Home の「実質的な最終更新日」 ------------------------------------------
+//
+// Home タイトル横の「最終更新: YYYY-MM-DD」の出どころ。Home の自己記述（この案件に
+// ついて／ゴール／体制）は古くなるのに、画面にいつ時点の情報か出ていない——
+// 手書きの日付は更新し忘れで嘘になるので、git のコミット日から自動で導く。
+//
+// ## この機能で許せない劣化の方向
+//
+// - 「出ない」は許容（git 無し・浅い clone・窓切れ → null。既存機能と同じ倒し方）
+// - 「古めに出る」は許容（--follow は衝突解決マージを丸ごと落とすため、その形の
+//   編集は1つ前の実質コミットの日付になる。squash・通常の PR マージはブランチ側の
+//   編集コミットが本物の author date を持つので実害は小さい——知っていて許容した）
+// - 🔴 **「新しすぎる日付」だけは許さない。** 鮮度を知らせる表示が「いつも新鮮です」と
+//   嘘をつくのは目的そのものへの裏切りで、見た目が自然なので誰も気づけない。
+//   既知の例外が1つ: **権限（mode）だけのコミット**は --name-status では M と区別が
+//   付かず、実質更新に数えてしまう。区別には差分をもう1回 git から取る必要があり
+//   （AI変更履歴側の modeOnly がそれ）、Home.md にモードだけの変更が入る形は実質
+//   無いので、ここでは扱わないと決めた（isFrontmatterKeyRename の見送りと同じ理由）
+/** 遡るコミット数の上限。Home.md 1ファイルの履歴なので、これで実質十分 */
+const LAST_UPDATE_MAX_COMMITS = 50;
+/**
+ * 改名の検出閾値。🔴 **既存の RENAME_OPT（90%）を共有しない。50%（git の既定）を明示する。**
+ *
+ * 90% はレコード群の「誤検出＝人が消した本文が別の記録のページに出る」という重い事故を
+ * 避けるための数字。ここは対象が Home.md 1ファイルで、誤検出の被害は「日付が少し
+ * 古めに出る」だけ——**リスクの非対称性が逆向き**なので、値だけ持ってきても根拠は
+ * 付いてこない。実測でも「旧構成 → Cortex/Home.md への引っ越し（見出しを整えて
+ * 52% 類似）」は 90% だと追加＋削除に割れて追跡が切れ、50% なら R052 で追える。
+ * 省略せず明示するのは、diff.renames を切っている人の設定に左右されないため。
+ */
+const LAST_UPDATE_RENAME_OPT = "--find-renames=50%";
+/**
+ * 指定ファイルの「実質的な最終更新日」（YYYY-MM-DD）。
+ *
+ * 機械的なコミット（classifyCommit が "migration" と判定するもの）と、中身が
+ * 1文字も変わっていない移動（R100）は飛ばす。**人の編集と AI の編集はどちらも
+ * 「実質更新」として数える**——この表示は「誰が」ではなく「情報がいつ時点か」を
+ * 示す鮮度のヒントだから。
+ *
+ * 日付は author date（%aI）の先頭10文字。committer date にしないのは rebase や
+ * マージで日付が動くため（既存 AiChangeEntry.at と同じ選択で、読む人の log.date
+ * 設定にも左右されない）。タイムゾーンは書いた人のオフセット基準——bot の UTC 編集が
+ * JST より1日古く出ることがあるが、それは「古い方向」なので許容する。
+ *
+ * git が無い・リポジトリでない・浅い clone・窓内が全部機械的 → null
+ * （表示が出ないだけで、他は壊れない）。
+ *
+ * frontmatter の項目名だけの付け替えを落とす構造の規則（isFrontmatterKeyRename）は
+ * ここでは使わない——差分の取得にもう1回 git を呼ぶ割に、Home.md ではマイグレーションの
+ * 件名規約で落ちる形しか観測されていない（適用しないと決めた・設計レビュー承認済み）。
+ */
+function lastSubstantiveUpdate(cwd, repoPath) {
+    // 🔴 **浅い clone を最初に弾く。** 浅い clone では境界コミットが親を持たないため、
+    // このファイルを触っていない直近のコミットまで `A <path>` として現れる（実測）。
+    // そのまま読むと「最終更新: 今日」という**常に新しい嘘の日付**になる——既存機能は
+    // 浅い clone で「出ない」に倒れるが、この計算だけは「嘘をつく」に倒れるので、
+    // ガードで丸ごと null にする。「A を全部飛ばす」で代用しないこと（本物の初回
+    // コミットは正当な A で、それを飛ばすと作られたきりの Home に日付が出ない）
+    try {
+        const shallow = (0, node_child_process_1.execFileSync)("git", ["rev-parse", "--is-shallow-repository"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        if (shallow !== "false")
+            return null;
+    }
+    catch {
+        return null; // git が無い・リポジトリでない（既定の状態なので警告もしない）
+    }
+    // 単一ファイルなので --follow で改名を git 側に追跡させる（readCommits が --no-follow
+    // なのは複数レコードを1回の log で読むため。ここはその制約が当てはまらない）
+    const out = gitLog(cwd, [
+        "log",
+        `-n${LAST_UPDATE_MAX_COMMITS}`,
+        "--follow",
+        LAST_UPDATE_RENAME_OPT,
+        "--no-color",
+        "--no-ext-diff",
+        "--name-status",
+        `--format=%x00%H%x1f%aI%x1f%an%x1f%ae%x1f%s`,
+        "--",
+        repoPath,
+    ], "Homeの最終更新日");
+    // 🔴 走査は「**飛ばされなかったファイル行を1つ以上持つ**、最も新しいコミット」を探す。
+    // ファイル行の無いコミット（素の log では衝突解決マージがこの形で出る）を実質更新に
+    // 数えない——いまは --follow がその形を落とすので踏まないが、「たまたま踏まない」を
+    // 不変条件にしない（--follow を外すフォールバックを将来足した瞬間に無音で壊れる）。
+    //
+    // ⚠️ **ファイル行のパスを repoPath と突き合わせて絞ってはいけない。** --follow では
+    // 改名より古いコミットのパスが**その時点の古いパス**で出る。目的パスで絞ると、
+    // 追跡してきた過去が丸ごと消える（絞りたくなっても締めないこと）。
+    let at = "";
+    let skip = true; // 先頭（コミット行より前）には何も無い
+    let hasSubstantiveFile = false;
+    const settle = () => !skip && hasSubstantiveFile && at.length >= 10 ? at.slice(0, 10) : null;
+    for (const line of out.split("\n")) {
+        if (line.startsWith(NUL)) {
+            const done = settle();
+            if (done)
+                return done;
+            const parts = line.slice(1).split(US);
+            at = parts[1] || "";
+            skip = classifyCommit({
+                name: parts[2] || "",
+                email: parts[3] || "",
+                subject: parts.slice(4).join(US),
+            }) === "migration";
+            hasSubstantiveFile = false;
+            continue;
+        }
+        // name-status 行だけを拾う（ヘッダとの間の空行はここで自然に落ちる）
+        const m = /^([A-Z])(\d*)\t/.exec(line);
+        if (!m)
+            continue;
+        if (m[1] === "D")
+            continue; // 防御。HEAD に居るファイルの --follow では実質出ない
+        if (m[1] === "R" && m[2] === "100")
+            continue; // 中身が1文字も変わっていない移動
+        hasSubstantiveFile = true;
+    }
+    return settle();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takagaki/cortex-decisions-viewer",
-  "version": "0.12.17",
+  "version": "0.12.19",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,
@@ -27,10 +27,12 @@
   "dependencies": {
     "commander": "^12.1.0",
     "gray-matter": "^4.0.3",
-    "marked": "^12.0.0"
+    "marked": "^12.0.0",
+    "sanitize-html": "^2.17.7"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "@types/sanitize-html": "^2.16.1",
     "jsdom": "^29.1.1",
     "linkedom": "^0.18.13",
     "typescript": "^5.7.0"