skills-viewer 0.7.0 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # skills-viewer
 
-Browse, search and manage your [Claude Code](https://code.claude.com) skills, commands, agents and hooks in the browser.
+Browse, search and manage your [Claude Code](https://code.claude.com) skills, commands, agents, hooks and auto memory in the browser.
 
 Scans every project registered in `~/.claude.json` (plus user scope, plugins and built-ins), and serves a local web UI to explore them — with usage stats, AI-generated summaries, full SKILL.md rendering, same-name diffs, and copy/delete management.
 
@@ -19,11 +19,12 @@ npx skills-viewer
 - **All scopes in one view** — user (`~/.claude/skills`), every project's `.claude/skills` / `.claude/commands`, installed plugins, and Claude Code built-ins, grouped by source
 - **Purpose grouping (AI)** — one haiku call classifies everything installed by _when you use it_ into 4–8 groups generated for your environment (planning / building / review / release / … as a role-agnostic guide — a designer's or PM's skills get their own groups). Switch the list between by-source, by-purpose and flat views; a frontmatter `category:` pins an item to a manual group that takes precedence
 - **Search / sort** — incremental search over name + description + usage; sort by name, usage count, last used, updated date, or token cost
-- **Diagnostics** — an _unused_ badge (no recorded use within the transcript retention window) with an all / used / unused filter, plus static description lint: missing / too-short / too-long descriptions, missing trigger conditions ("use when …") that make auto-invocation unlikely, and name-echo descriptions
+- **Diagnostics** — a _no recent use_ badge (no recorded use within the transcript retention window) with an all / recent use / no recent use filter, plus static description lint: missing / too-short / too-long descriptions, missing trigger conditions ("use when …") that make auto-invocation unlikely, and name-echo descriptions
 - **Token cost** — since every name + description is injected into each session, the estimated token overhead is shown per item, per scope, and as a per-session total for the current project
 - **AI trigger diagnosis** — one click asks the model whether the description is likely to trigger auto-invocation, lists concrete issues, and proposes an improved description you can apply with one click (cached by content hash)
 - **AI flow diagram** — extract the processing flow of orchestration-style skills (steps, branches, delegations, human gates) from the definition body and render it as a step diagram; delegated skills are clickable
 - **AI model choice** — pick the model behind all AI features (haiku default / sonnet / opus) in settings; aliases are resolved by your claude CLI
+- **Memory triage** — a _Memory_ view lists Claude Code's auto memory (`~/.claude/projects/<project>/memory/`) per project with its context cost split into the always-on part (the `MEMORY.md` index line injected into every session) and the pay-per-use part (the body, read on demand), plus Read / Write counts from transcripts, `[[link]]` resolution and backlinks. **AI triage** reads every memory of a project with the claude CLI (one call, split into a few for very large projects) and proposes a destination per memory — keep / shrink / move to CLAUDE.md / move to docs / move to a skill / delete / wrong project — with the reasoning and a paste-ready instruction for Claude Code (it is asked to always cover removing the `MEMORY.md` index line and re-pointing `[[link]]`s). Each memory is first judged for freshness (current / outdated / historical / obsolete) from mechanical signals — dates in the body, missing paths, merged or deleted branches, references to another project — and a _rewrite the body_ verdict covers memories whose gist still holds; the triage also flags when the `MEMORY.md` index line disagrees with the body. For feedback memories the instruction is built from a fixed template, so it reads the same on every model. The viewer never writes to memory: you paste the instruction into Claude Code, which inspects, asks when unsure, and executes after your approval
 - **Edit in the browser** — inline editor for SKILL.md / commands / agents (project & user scopes) with mtime conflict detection and a one-generation backup in `~/.cache/skills-viewer/backups/`
 - **What's changed** — a banner shows items added / updated / removed since your last launch (baseline advances only when you dismiss it); the CLI prints a one-line summary at startup too
 - **Usage sparkline** — the detail pane charts the last 30 days of per-day usage
@@ -35,7 +36,7 @@ npx skills-viewer
 - **Same-name diff** — when the same skill name exists in multiple scopes, the detail page lists the other definitions and shows a line diff between them
 - **Open in editor** — via URL scheme (VS Code / Cursor / Zed / Windsurf / custom, configurable in the ⚙ settings modal), or the OS default opener
 - **English / 日本語** — UI language auto-detected from the browser and switchable in settings; AI summaries are generated in the selected language (CLI messages follow `LANG`)
-- **URL routing** — `/skills/:id?tab=md`, search/sort/grouping in query params; links are shareable across reloads
+- **URL routing** — `/skills/:id?tab=md`, `/memory/:id`, `/memory/triage/:project`, search/sort/grouping in query params; links are shareable across reloads
 
 ## Usage
 
@@ -77,11 +78,12 @@ dist/             # prebuilt UI shipped in the npm package (generated by prepack
 
 ## Notes
 
-- Usage stats only cover the transcript retention window of Claude Code (`cleanupPeriodDays`, default 30 days) — the _unused_ badge has the same limitation
+- Usage stats only cover the transcript retention window of Claude Code (`cleanupPeriodDays`, default 30 days) — the _no recent use_ badge and memory Read counts have the same limitation (projects without transcripts show no usage columns at all)
 - Token costs are heuristic estimates (≈4 chars/token for ASCII, ≈1.5 for CJK), not exact tokenizer counts
 - Usage is attributed per calling project (worktrees roll up to their parent project by encoded-path prefix). When scopes share a name, the resolution order project > user > plugin > built-in is assumed
 - The built-in skill list is hardcoded in `server/scan.js` (they live inside the Claude Code binary); check `/skills` inside Claude Code for the authoritative list
 - AI summaries require a logged-in `claude` CLI
+- Memory triage sends each memory's body to the claude CLI, together with the project's `MEMORY.md` index, the **headings** of `CLAUDE.md` / `.claude/CLAUDE.md` / `~/.claude/CLAUDE.md` and the names + descriptions of the skills available to that project (never their bodies) so it can spot duplicates and promotion targets. Branch status for the freshness signals comes from local `git` (no network). Results are cached per memory by content hash (plus the index line); memory files themselves are never modified
 
 ## License
 

package/build/server/cache.js

@@ -0,0 +1,53 @@
+"use strict";
+/*
+ * AI 機能のキャッシュ(~/.cache/skills-viewer/*.json)の共通処理。
+ * どのキャッシュも「実パス → エントリ」の形なので、掃除の規則を 1 箇所に置く。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pruneMissing = pruneMissing;
+const fs = __importStar(require("node:fs"));
+/*
+ * 消えたファイル(削除・リネーム・別プロジェクトの撤去)のエントリを落とす。
+ * 呼ぶのは保存時だけにする — GET(読み取り API)で書き込みを発生させないため。
+ */
+function pruneMissing(store) {
+    const out = {};
+    for (const [key, value] of Object.entries(store)) {
+        if (fs.existsSync(key))
+            out[key] = value;
+    }
+    return out;
+}

package/build/server/diagnose.js

@@ -45,6 +45,7 @@ exports.attachDiagnoses = attachDiagnoses;
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
+const cache_1 = require("./cache");
 const summary_1 = require("./summary");
 const DIAG_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'diagnoses.json');
 function loadDiagnoses() {
@@ -57,7 +58,8 @@ function loadDiagnoses() {
 }
 function saveDiagnoses(store) {
     fs.mkdirSync(path.dirname(DIAG_FILE), { recursive: true });
-    fs.writeFileSync(DIAG_FILE, JSON.stringify(store, null, 1));
+    // 保存のついでに死にエントリを掃除する(GET では書き込まないので掃除もしない)
+    fs.writeFileSync(DIAG_FILE, JSON.stringify((0, cache_1.pruneMissing)(store), null, 1));
 }
 function buildPrompt(name, content, lang) {
     if (lang === 'ja') {

package/build/server/flow.js

@@ -45,6 +45,7 @@ exports.attachFlows = attachFlows;
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
+const cache_1 = require("./cache");
 const summary_1 = require("./summary");
 const FLOW_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'flows.json');
 /*
@@ -63,7 +64,8 @@ function loadFlows() {
 }
 function saveFlows(store) {
     fs.mkdirSync(path.dirname(FLOW_FILE), { recursive: true });
-    fs.writeFileSync(FLOW_FILE, JSON.stringify(store, null, 1));
+    // 保存のついでに死にエントリを掃除する(GET では書き込まないので掃除もしない)
+    fs.writeFileSync(FLOW_FILE, JSON.stringify((0, cache_1.pruneMissing)(store), null, 1));
 }
 function buildPrompt(name, content, lang) {
     if (lang === 'ja') {

package/build/server/index.js

@@ -46,12 +46,14 @@ const crypto = __importStar(require("node:crypto"));
 const node_child_process_1 = require("node:child_process");
 const scan_1 = require("./scan");
 const usage_1 = require("./usage");
+const memory_1 = require("./memory");
 const summary_1 = require("./summary");
 const manage_1 = require("./manage");
 const edit_1 = require("./edit");
 const diagnose_1 = require("./diagnose");
 const flow_1 = require("./flow");
 const groups_1 = require("./groups");
+const memory_triage_1 = require("./memory-triage");
 const snapshot_1 = require("./snapshot");
 const errors_1 = require("./errors");
 const locale_1 = require("./locale");
@@ -134,6 +136,41 @@ function attributeUsage(sections) {
     }
     return Object.keys(byDir).length > 0;
 }
+/*
+ * memory の Read(参照)/ Write・Edit(作成・更新)実績を付与する。
+ * skill と違って帰属先の解決は不要で、Read の file_path がそのまま実ファイルを指す。
+ * usageAvailable は「そのプロジェクトのトランスクリプトがあるか」= エンコード名で始まる
+ * ディレクトリ(worktree 分を含む)に jsonl が 1 件以上あるか。false なら Read 列は出さない。
+ */
+function attributeMemoryUsage(memory) {
+    if (!memory.length)
+        return;
+    const { byPath, dirsWithTranscripts } = (0, usage_1.scanMemoryUsage)();
+    for (const sec of memory) {
+        sec.usageAvailable = (0, usage_1.hasTranscripts)(dirsWithTranscripts, sec.id);
+        for (const it of sec.items) {
+            const u = byPath[it.path];
+            if (!u)
+                continue;
+            if (u.reads > 0) {
+                it.useCount = u.reads;
+                it.lastUsed = u.lastRead;
+                it.dailyUse = u.daily;
+            }
+            if (u.writes > 0)
+                it.writeCount = u.writes;
+        }
+    }
+}
+/*
+ * 実績付きの memory セクション一覧。/api/skills だけでなく /api/memory-triage からも
+ * 同じ事実(Read / W-E / usageAvailable)をプロンプトに載せる必要があるので共通化する。
+ */
+function memorySections(cwd) {
+    const memory = (0, memory_1.scanMemory)(cwd);
+    attributeMemoryUsage(memory);
+    return memory;
+}
 function collect(cwd, lang) {
     const sections = (0, scan_1.scanSections)(cwd, lang);
     const usageAvailable = attributeUsage(sections);
@@ -162,6 +199,9 @@ function collect(cwd, lang) {
     (0, flow_1.attachFlows)(sections, lang);
     const grp = (0, groups_1.attachGroups)(sections, lang);
     const aiStale = (0, summary_1.staleItems)(sections, lang).length;
+    // memory は「呼び出す」ものではないので sections には混ぜず、別配列で同乗させる
+    const memory = memorySections(cwd);
+    (0, memory_triage_1.attachMemoryTriage)(memory, lang);
     const targets = [
         { label: 'user skills', sub: '~/.claude/skills/', path: scan_1.HOME },
         ...(0, scan_1.listProjects)(cwd)
@@ -178,6 +218,7 @@ function collect(cwd, lang) {
         changes: (0, snapshot_1.computeChanges)(sections),
         ...(grp.groups ? { groups: grp.groups } : {}),
         ...(grp.stale ? { groupsStale: true } : {}),
+        ...(memory.length ? { memory } : {}),
     };
 }
 /* DNS rebinding 対策: same-origin GET には Origin が付かないため Host 側も検証する */
@@ -291,6 +332,26 @@ function handleApi(req, res, cwd) {
                     .catch((e) => send(400, (0, errors_1.toErrorBody)(e)));
                 return;
             }
+            if (url.pathname === '/api/memory-triage') {
+                // 1 プロジェクト分をまとめて 1 回の claude 呼び出しで棚卸しする(結果は再取得で反映)
+                const project = String(data.project || '');
+                const sec = memorySections(cwd).find((s) => s.id === project);
+                if (!sec)
+                    throw new errors_1.ApiError('not-found', project);
+                const files = Array.isArray(data.files)
+                    ? data.files.filter((f) => typeof f === 'string')
+                    : undefined;
+                // sections は「CLAUDE.md / skill に既に書いてある」「skill へ昇格」を判定させる文脈。
+                // AI を呼ぶときだけ要るので、フルスキャンは関数で渡して遅延させる
+                (0, memory_triage_1.triageProject)(sec, lang, model, {
+                    force: !!data.force,
+                    files,
+                    sections: () => (0, scan_1.scanSections)(cwd, lang),
+                })
+                    .then((results) => send(200, { ok: true, results }))
+                    .catch((e) => send(400, (0, errors_1.toErrorBody)(e)));
+                return;
+            }
             if (url.pathname === '/api/summarize') {
                 const real = (0, manage_1.assertReadableMd)(data.src);
                 // refs(関係候補)はスキャン結果から復元する
@@ -332,7 +393,7 @@ function serveStatic(req, res) {
 }
 /*
  * 起動時の1〜2行サマリー(--no-open 運用でも価値が出るように)。
- * 前回からの差分 + セッション注入トークン概算 + 未使用件数。失敗しても起動は止めない。
+ * 前回からの差分 + セッション注入トークン概算 + 直近未使用の件数。失敗しても起動は止めない。
  */
 function printStartupSummary(cwd) {
     try {
@@ -350,8 +411,8 @@ function printStartupSummary(cwd) {
                 .length
             : null;
         console.log((0, locale_1.srvMsg)(`スキル定義のセッション注入 ≈${sessionTokens.toLocaleString()}tok` +
-            (unused !== null ? ` / 未使用 ${unused} 件` : ''), `Skill definitions inject ≈${sessionTokens.toLocaleString()} tok/session` +
-            (unused !== null ? ` / ${unused} unused` : '')));
+            (unused !== null ? ` / 直近未使用 ${unused} 件` : ''), `Skill definitions inject ≈${sessionTokens.toLocaleString()} tok/session` +
+            (unused !== null ? ` / ${unused} with no recent use` : '')));
     }
     catch {
         /* サマリーは補助情報。失敗しても起動を妨げない */

package/build/server/memory-signals.js

@@ -0,0 +1,328 @@
+"use strict";
+/*
+ * memory の鮮度(state)を判定するための機械シグナル。事実を拾うだけで行き先は決めない。
+ *
+ * 2 層に分ける:
+ *   - テキスト / fs 層(extractSignals): 本文の絶対日付・参照パスの実在・完了語。
+ *     正規表現と existsSync だけなので /api/skills のスキャン時に毎回計算してよい
+ *   - git 層(loadBranches + branchSignals): 本文に出るブランチ名のマージ状況。
+ *     git の spawn を伴うので棚卸し診断の call 時にだけ計算する(起動経路に入れない)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.latestDate = latestDate;
+exports.missingPaths = missingPaths;
+exports.doneWords = doneWords;
+exports.extractSignals = extractSignals;
+exports.otherProjectRefs = otherProjectRefs;
+exports.parseFeedbackParts = parseFeedbackParts;
+exports.dice2gram = dice2gram;
+exports.episodicTokens = episodicTokens;
+exports.feedbackSignals = feedbackSignals;
+exports.loadBranches = loadBranches;
+exports.branchSignals = branchSignals;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const scan_1 = require("./scan");
+const MAX_MISSING_PATHS = 3;
+/* 完了・廃止を表す語。ASCII は単語境界つき・大文字小文字無視、日本語はそのまま部分一致 */
+const DONE_WORDS_JA = ['完了', 'マージ済', '対応済', 'リリース済', '廃止'];
+const DONE_WORDS_EN = ['merged', 'done', 'completed', 'deprecated', 'resolved'];
+/*
+ * 本文中の絶対日付(YYYY-MM-DD / YYYY/MM/DD / YYYY年M月D日)のうち最新のもの。
+ * memory の運用ルールで相対日付は絶対日付に直されているので、本文の日付がその記述の「いつ」を表す。
+ * 未来すぎる日付(1 年超)は誤検出として除く。
+ */
+function latestDate(body, now) {
+    let best = null;
+    for (const m of body.matchAll(/(20\d{2})[-/年](\d{1,2})[-/月](\d{1,2})日?/g)) {
+        const y = Number(m[1]);
+        const mo = Number(m[2]);
+        const d = Number(m[3]);
+        if (mo < 1 || mo > 12 || d < 1 || d > 31)
+            continue;
+        const ms = Date.UTC(y, mo - 1, d);
+        if (ms > now + 366 * 86400000)
+            continue;
+        if (!best || ms > best.ms) {
+            best = { value: `${y}-${String(mo).padStart(2, '0')}-${String(d).padStart(2, '0')}`, ms };
+        }
+    }
+    if (!best)
+        return null;
+    return { value: best.value, days: Math.max(0, Math.floor((now - best.ms) / 86400000)) };
+}
+/*
+ * 本文が参照するファイルパスのうち存在しないもの。
+ * 対象は「/ を含み、末尾が拡張子つきのファイル名」に限る(URL・ブランチ名・パッケージ名を拾わない)。
+ * 相対パスは projectPath 基準。projectPath が無い(孤児)なら絶対パスと ~/ だけを見る。
+ */
+function missingPaths(body, projectPath, home) {
+    const out = [];
+    const seen = new Set();
+    const re = /(?:^|[\s(`「'"<[])((?:~\/|\.{1,2}\/|\/)?[\w@.-]+(?:\/[\w@.-]+)+\.[A-Za-z0-9]{1,8})(?=$|[\s)`」'">\],:;。、])/gm;
+    for (const m of body.matchAll(re)) {
+        const raw = m[1];
+        if (seen.has(raw))
+            continue;
+        seen.add(raw);
+        // `foo.com/bar.js` のようなドメイン風は除く(ホスト名にドットを含む先頭セグメント)
+        const first = raw.replace(/^(?:~\/|\.{1,2}\/|\/)/, '').split('/')[0];
+        if (/\.[a-z]{2,}$/i.test(first) && !raw.startsWith('/') && !raw.startsWith('~/'))
+            continue;
+        let resolved;
+        if (raw.startsWith('~/'))
+            resolved = path.join(home, raw.slice(2));
+        else if (raw.startsWith('/'))
+            resolved = raw;
+        else if (projectPath)
+            resolved = path.resolve(projectPath, raw);
+        else
+            continue;
+        if (!fs.existsSync(resolved)) {
+            out.push(raw);
+            if (out.length >= MAX_MISSING_PATHS)
+                break;
+        }
+    }
+    return out;
+}
+/* description + 本文に含まれる完了語(重複排除、最大 3 語) */
+function doneWords(text) {
+    const found = [];
+    for (const w of DONE_WORDS_JA)
+        if (text.includes(w))
+            found.push(w);
+    for (const w of DONE_WORDS_EN) {
+        if (new RegExp('\\b' + w + '\\b', 'i').test(text))
+            found.push(w);
+    }
+    return found.slice(0, 3);
+}
+/* テキスト / fs 層のシグナルをまとめて計算する(スキャン時) */
+function extractSignals(body, description, projectPath, opts = {}) {
+    const now = opts.now ?? Date.now();
+    const home = opts.home ?? scan_1.HOME;
+    const out = [];
+    const date = latestDate(body, now);
+    if (date)
+        out.push({ kind: 'date', value: date.value, days: date.days });
+    for (const p of missingPaths(body, projectPath, home))
+        out.push({ kind: 'path-missing', value: p });
+    const words = doneWords(description + '\n' + body);
+    if (words.length)
+        out.push({ kind: 'done-words', value: words.join(', ') });
+    if (opts.memoryType === 'feedback' || opts.memoryType === 'user') {
+        out.push(...feedbackSignals(body, description, opts.bodyTokens ?? 0));
+    }
+    for (const p of otherProjectRefs(body, home, opts.otherProjects || []))
+        out.push({ kind: 'other-project', value: p });
+    return out;
+}
+/*
+ * 本文が別の登録プロジェクトの配下パス(絶対 / ~/)を指しているか。
+ * 「別プロジェクトの話が混入した memory」の機械的な根拠で、置き場所(wrong-project)の判断材料になる。
+ * 呼び出し側で自分自身と worktree 関係のプロジェクトは除いて渡す。
+ */
+function otherProjectRefs(body, home, others) {
+    if (!others.length)
+        return [];
+    const hit = new Set();
+    for (const m of body.matchAll(/(~\/[^\s)）」'"`<>]+|\/[\w.@-]+(?:\/[\w.@-]+)+)/g)) {
+        const raw = m[1].replace(/[/.,:;。、)）」]+$/, '');
+        const resolved = raw.startsWith('~/') ? path.join(home, raw.slice(2)) : raw;
+        for (const p of others) {
+            if (resolved === p || resolved.startsWith(p + path.sep))
+                hit.add(path.basename(p));
+        }
+    }
+    return [...hit].slice(0, 2);
+}
+const WHY_RE = /^\s*(?:\*\*)?Why:?(?:\*\*)?:?\s*/im;
+const HOW_RE = /^\s*(?:\*\*)?How to apply:?(?:\*\*)?:?\s*/im;
+/*
+ * Claude Code が feedback を書くときの定型(1 行目 / **Why:** / **How to apply:**)に分解する。
+ * 見出しが無ければ該当部分は空文字(テンプレートは「無い部分には触れない」)。
+ */
+function parseFeedbackParts(body) {
+    const whyAt = body.search(WHY_RE);
+    const howAt = body.search(HOW_RE);
+    const head = body.slice(0, Math.min(...[whyAt, howAt].filter((i) => i >= 0), body.length));
+    const rule = head
+        .split('\n')
+        .map((l) => l.trim())
+        .find((l) => l.length > 0) || '';
+    let why = '';
+    let how = '';
+    if (whyAt >= 0) {
+        const end = howAt > whyAt ? howAt : body.length;
+        why = body.slice(whyAt, end).replace(WHY_RE, '').trim();
+    }
+    if (howAt >= 0) {
+        const end = whyAt > howAt ? whyAt : body.length;
+        how = body.slice(howAt, end).replace(HOW_RE, '').trim();
+    }
+    return { rule, why, how };
+}
+/* 文字 2-gram の Dice 係数(0〜1)。空白・記号を落として比べる。日本語の言い換え検出に十分な粗さ */
+function dice2gram(a, b) {
+    const grams = (s) => {
+        const t = s.toLowerCase().replace(/[\s\p{P}]/gu, '');
+        const set = new Set();
+        for (let i = 0; i + 1 < t.length; i++)
+            set.add(t.slice(i, i + 2));
+        return set;
+    };
+    const ga = grams(a);
+    const gb = grams(b);
+    if (!ga.size || !gb.size)
+        return 0;
+    let hit = 0;
+    for (const g of ga)
+        if (gb.has(g))
+            hit++;
+    return (2 * hit) / (ga.size + gb.size);
+}
+const RESTATE_THRESHOLD = 0.3;
+// 実測: 索引 1 行で機能する feedback の本文は 150〜300 tok が多数派。opus が「短い」と評した 166 tok を超えない閾値にする
+const FEEDBACK_BODY_MAX_TOKENS = 200;
+const EXCEPTION_RE = /ただし|例外|除く|除き|unless|except(?!ion)/i;
+const EPISODIC_USER_RE = /ユーザー(?:が|の|から)?\s*(?:指摘|言|依頼|要望)|user (?:said|pointed out|asked)/i;
+const EPISODIC_ISSUE_RE = /#\d{2,}/;
+/* エピソード固有の語(ブランチ名 / #番号 / 日付 / 「ユーザーが指摘」)。why-episodic と whyRewrite の検証で共用 */
+function episodicTokens(text) {
+    const out = [];
+    for (const m of text.matchAll(BRANCH_RE))
+        out.push(m[1]);
+    const issue = text.match(EPISODIC_ISSUE_RE);
+    if (issue)
+        out.push(issue[0]);
+    const date = text.match(/20\d{2}[-/年]\d{1,2}[-/月]\d{1,2}日?/);
+    if (date)
+        out.push(date[0]);
+    const user = text.match(EPISODIC_USER_RE);
+    if (user)
+        out.push(user[0]);
+    return [...new Set(out)].slice(0, 4);
+}
+function feedbackSignals(body, description, bodyTokens) {
+    const out = [];
+    const parts = parseFeedbackParts(body);
+    const pct = (x) => Math.round(x * 100) + '%';
+    if (parts.rule && description) {
+        const sim = dice2gram(parts.rule, description);
+        if (sim >= RESTATE_THRESHOLD)
+            out.push({ kind: 'first-line-restates', value: pct(sim) });
+    }
+    if (parts.how && description) {
+        const sim = dice2gram(parts.how, description);
+        if (sim >= RESTATE_THRESHOLD)
+            out.push({ kind: 'how-restates', value: pct(sim) });
+    }
+    if (parts.why) {
+        const ep = episodicTokens(parts.why);
+        if (ep.length)
+            out.push({ kind: 'why-episodic', value: ep.join(', ') });
+    }
+    const exLine = body.split('\n').find((l) => EXCEPTION_RE.test(l));
+    if (exLine)
+        out.push({ kind: 'has-exception', value: exLine.trim().slice(0, 40) });
+    if (bodyTokens > FEEDBACK_BODY_MAX_TOKENS)
+        out.push({ kind: 'body-over', value: String(bodyTokens) });
+    return out;
+}
+function git(projectPath, args) {
+    return (0, node_child_process_1.execFileSync)('git', ['-C', projectPath, ...args], {
+        encoding: 'utf8',
+        timeout: 3000,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+}
+const normalizeRef = (r) => r.trim().replace(/^origin\//, '');
+/*
+ * プロジェクトのブランチ一覧とマージ状況。git リポジトリでない・git が無い・失敗した場合は null
+ * (シグナル無しとして扱う。診断を止めない)。
+ */
+function loadBranches(projectPath) {
+    if (!projectPath)
+        return null;
+    try {
+        const all = new Set(git(projectPath, ['for-each-ref', '--format=%(refname:short)', 'refs/heads', 'refs/remotes'])
+            .split('\n')
+            .map(normalizeRef)
+            .filter((r) => r && r !== 'HEAD'));
+        let defaultBranch = '';
+        try {
+            defaultBranch = normalizeRef(git(projectPath, ['symbolic-ref', '--short', 'refs/remotes/origin/HEAD']));
+        }
+        catch {
+            defaultBranch = all.has('main') ? 'main' : all.has('master') ? 'master' : '';
+        }
+        if (!defaultBranch)
+            return { all, merged: new Set(), defaultBranch };
+        const merged = new Set(git(projectPath, ['branch', '-a', '--merged', defaultBranch, '--format=%(refname:short)'])
+            .split('\n')
+            .map(normalizeRef)
+            .filter((r) => r && r !== 'HEAD' && r !== defaultBranch));
+        return { all, merged, defaultBranch };
+    }
+    catch {
+        return null;
+    }
+}
+/*
+ * 本文に出るブランチ名らしきトークン(接頭辞 feat/ fix/ 等)。ブランチ名は ASCII 前提。
+ * docs/ test/ style/ はディレクトリ名として頻出し(docs/projects-design/、test/contract)、
+ * 実測で誤検出になったので接頭辞から外す。末尾が / のものはディレクトリなので拾わない
+ * (否定先読みはトークン文字全体を対象にし、短い一致へのバックトラックを防ぐ)
+ */
+const BRANCH_RE = /\b((?:feat|feature|fix|bugfix|hotfix|chore|refactor|release|ci|perf)\/[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*)(?![A-Za-z0-9._/-])/g;
+function branchSignals(body, info) {
+    const out = [];
+    const seen = new Set();
+    for (const m of body.matchAll(BRANCH_RE)) {
+        const name = m[1].replace(/[.)\]]+$/, ''); // 文末の句読点・閉じ括弧を剥がす
+        if (seen.has(name) || name === info.defaultBranch)
+            continue;
+        seen.add(name);
+        if (info.merged.has(name))
+            out.push({ kind: 'branch-merged', value: name });
+        else if (!info.all.has(name))
+            out.push({ kind: 'branch-missing', value: name });
+        // 存在して未マージ = 進行中。シグナルは出さない
+    }
+    return out;
+}