skills-viewer 0.3.0 → 0.5.0

package/README.md

@@ -18,8 +18,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
 - **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 unused-only 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** — 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
 - **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 haiku 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)
+- **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
 - **Usage stats** — invocation counts and last-used dates aggregated from Claude Code session transcripts (`~/.claude/projects/`), covering both user-typed `/skill` calls and model-invoked Skill tool calls
 - **AI summaries** — one-click summarization of each SKILL.md via `claude -p --model haiku`, cached by content hash in `~/.cache/skills-viewer/` so unchanged skills are never re-summarized
 - **Detail pane** — master/detail layout with an Overview tab (description, usage, bundled files) and a rendered SKILL.md tab

package/build/server/diagnose.js

@@ -0,0 +1,138 @@
+"use strict";
+/*
+ * AI 発動診断: description が「モデルの自動発動判断」に足るかを haiku で診断し、
+ * 指摘と改善版 description を返す。summary.ts と同じく content hash + lang で
+ * ~/.cache/skills-viewer/diagnoses.json にキャッシュし、内容が変わらない限り再生成しない。
+ */
+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.loadDiagnoses = loadDiagnoses;
+exports.parseDiagnosis = parseDiagnosis;
+exports.diagnoseOne = diagnoseOne;
+exports.attachDiagnoses = attachDiagnoses;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const summary_1 = require("./summary");
+const DIAG_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'diagnoses.json');
+function loadDiagnoses() {
+    try {
+        return JSON.parse(fs.readFileSync(DIAG_FILE, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveDiagnoses(store) {
+    fs.mkdirSync(path.dirname(DIAG_FILE), { recursive: true });
+    fs.writeFileSync(DIAG_FILE, JSON.stringify(store, null, 1));
+}
+function buildPrompt(name, content, lang) {
+    if (lang === 'ja') {
+        return ('以下は Claude Code の skill 定義ファイルです。モデルは frontmatter の name と description **だけ**を見て、' +
+            'このスキルを自動発動するか判断します(本文は発動後にしか読まれません)。\n' +
+            'description の「発動性」を診断し、次の JSON だけを出力してください(前置き・コードフェンス不要):\n' +
+            '{"verdict": "good" | "weak",\n' +
+            ' "issues": ["問題点(日本語で各25字程度、最大4件。無ければ空配列)"],\n' +
+            ' "improved": "改善版 description(日本語)。本文から読み取れる発動条件(〜するとき、〜と頼まれたとき等)を必ず含め、200字以内"}\n\n' +
+            'verdict は、description だけでモデルが適切な場面で発動を判断できるなら good、曖昧・条件不足なら weak。\n' +
+            'improved は verdict が good でも、より良くできるなら改善版を出すこと(現状のままで良ければ元の文をそのまま)。\n\n' +
+            '# skill: ' +
+            name +
+            '\n\n' +
+            content);
+    }
+    return ('Below is a Claude Code skill definition file. The model decides whether to auto-invoke this skill ' +
+        'based **only** on the frontmatter name and description (the body is read only after invocation).\n' +
+        'Diagnose how well the description triggers invocation, and output ONLY this JSON (no preamble, no code fences):\n' +
+        '{"verdict": "good" | "weak",\n' +
+        ' "issues": ["problem (about 10 words each, max 4; empty array if none)"],\n' +
+        ' "improved": "improved description in English; MUST include trigger conditions readable from the body (\\"use when …\\"), max 400 chars"}\n\n' +
+        'verdict: good if the description alone lets the model invoke at the right moments; weak if vague or missing conditions.\n' +
+        'improved: even when verdict is good, propose a better version if possible (return the original text if it is already ideal).\n\n' +
+        '# skill: ' +
+        name +
+        '\n\n' +
+        content);
+}
+/* haiku の出力を検証つきでパース(壊れた出力は reject して UI にエラー表示) */
+function parseDiagnosis(text) {
+    const stripped = text
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/, '')
+        .trim();
+    const j = JSON.parse(stripped);
+    const verdict = j.verdict === 'good' ? 'good' : 'weak';
+    const issues = Array.isArray(j.issues)
+        ? j.issues.filter((x) => typeof x === 'string').map((s) => s.slice(0, 80))
+        : [];
+    const improved = String(j.improved || '').trim();
+    if (!improved)
+        throw new Error('empty improved description');
+    return { verdict, issues: issues.slice(0, 4), improved };
+}
+async function diagnoseOne(realPath, name, lang) {
+    const hash = (0, summary_1.contentHash)(realPath);
+    const store = loadDiagnoses();
+    const cached = store[realPath];
+    if (cached && cached.hash === hash && cached.lang === lang) {
+        return { verdict: cached.verdict, issues: cached.issues, improved: cached.improved };
+    }
+    const content = fs.readFileSync(realPath, 'utf8').slice(0, 12000);
+    const result = parseDiagnosis(await (0, summary_1.runHaiku)(buildPrompt(name, content, lang)));
+    store[realPath] = { ...result, hash, lang, generatedAt: new Date().toISOString() };
+    saveDiagnoses(store);
+    return result;
+}
+/* スキャン結果にキャッシュ済み診断を付与(内容が変わっていれば付けない) */
+function attachDiagnoses(sections, lang) {
+    const store = loadDiagnoses();
+    for (const s of sections) {
+        for (const it of s.items) {
+            const cached = store[it.path];
+            if (cached &&
+                cached.lang === lang &&
+                it.path &&
+                fs.existsSync(it.path) &&
+                cached.hash === (0, summary_1.contentHash)(it.path)) {
+                it.aiDiagnosis = {
+                    verdict: cached.verdict,
+                    issues: cached.issues,
+                    improved: cached.improved,
+                };
+            }
+        }
+    }
+}

package/build/server/edit.js

@@ -0,0 +1,145 @@
+"use strict";
+/*
+ * ブラウザ内編集の実体: SKILL.md / command / agent の保存と description 差し替え。
+ * 本ツール初の「ファイル内容の書き換え」なので、
+ *   - パス検証は manage.ts の assertManagedPath(.claude/skills|commands|agents 限定、plugin 拒否)に乗せる
+ *   - mtime による競合検出(エディタ等での外部変更を上書きしない)
+ *   - 保存前に ~/.cache/skills-viewer/backups/ へ1世代バックアップ(trash と同じ思想)
+ * を必ず通す。
+ */
+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.assertEditableMd = assertEditableMd;
+exports.doSave = doSave;
+exports.replaceDescription = replaceDescription;
+exports.doApplyDescription = doApplyDescription;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const manage_1 = require("./manage");
+const errors_1 = require("./errors");
+/* テストから隔離できるよう env で差し替え可能にする(通常運用では未設定)。
+   モジュール読み込み後に env を設定するテストのため、参照は呼び出し時に行う */
+const backupDir = () => process.env.SKILLS_VIEWER_BACKUP_DIR ||
+    path.join(os.homedir(), '.cache', 'skills-viewer', 'backups');
+const MAX_CONTENT = 512 * 1024; // request body 上限(1MB)より小さく、md として十分
+function assertEditableMd(p) {
+    const { real } = (0, manage_1.assertManagedPath)(p);
+    if (!real.endsWith('.md'))
+        throw new errors_1.ApiError('not-md', real);
+    return real;
+}
+/* 上書き前の内容を1世代だけ退避(ファイルごとに1枠、保存のたびに更新) */
+function backupOnce(real, content) {
+    try {
+        const dir = backupDir();
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, real.replace(/[^a-zA-Z0-9.]/g, '-')), content);
+    }
+    catch {
+        /* バックアップ失敗で保存自体は止めない */
+    }
+}
+/* mtime 競合チェック → バックアップ → 書き込み、の共通経路 */
+function writeGuarded(real, next, baseMtime) {
+    const st = fs.statSync(real);
+    if (typeof baseMtime === 'number' && st.mtimeMs !== baseMtime) {
+        throw new errors_1.ApiError('edit-conflict', real);
+    }
+    backupOnce(real, fs.readFileSync(real, 'utf8'));
+    fs.writeFileSync(real, next);
+    return { mtime: fs.statSync(real).mtimeMs };
+}
+function doSave(data) {
+    const real = assertEditableMd(data.src);
+    const content = data.content;
+    if (typeof content !== 'string' || !content.trim())
+        throw new errors_1.ApiError('empty-content');
+    if (content.length > MAX_CONTENT)
+        throw new errors_1.ApiError('content-too-large');
+    const baseMtime = typeof data.baseMtime === 'number' ? data.baseMtime : undefined;
+    return { ok: true, ...writeGuarded(real, content, baseMtime) };
+}
+/*
+ * frontmatter の description だけを差し替える(AI 改善案のワンクリック適用用)。
+ * - 既存の description 行(block scalar 含む)を置き換え
+ * - description キーが無ければ frontmatter 先頭(name の次)に挿入
+ * - frontmatter 自体が無ければ新設
+ * 値は常に YAML double-quote(JSON.stringify)で書き、改行は空白に潰す。
+ */
+function replaceDescription(raw, desc) {
+    const value = 'description: ' + JSON.stringify(desc.replace(/\s*\n\s*/g, ' ').trim());
+    const fm = raw.match(/^---\r?\n([\s\S]*?)\r?\n---(\r?\n?)/);
+    if (!fm)
+        return `---\n${value}\n---\n\n` + raw;
+    const lines = fm[1].split(/\r?\n/);
+    const out = [];
+    let replaced = false;
+    let i = 0;
+    while (i < lines.length) {
+        const m = lines[i].match(/^description:\s*(.*)$/);
+        if (!m || replaced) {
+            out.push(lines[i]);
+            i++;
+            continue;
+        }
+        out.push(value);
+        replaced = true;
+        i++;
+        if (['|', '>', '|-', '>-'].includes(m[1].trim())) {
+            // block scalar の継続行(インデント行・空行)を捨てる
+            while (i < lines.length && (lines[i].startsWith('  ') || lines[i].trim() === ''))
+                i++;
+        }
+    }
+    if (!replaced) {
+        // name の直後、無ければ先頭に挿入
+        const nameIdx = out.findIndex((l) => /^name:/.test(l));
+        out.splice(nameIdx >= 0 ? nameIdx + 1 : 0, 0, value);
+    }
+    return '---\n' + out.join('\n') + '\n---' + fm[2] + raw.slice(fm[0].length);
+}
+function doApplyDescription(data) {
+    const real = assertEditableMd(data.src);
+    if (typeof data.description !== 'string' || !data.description.trim()) {
+        throw new errors_1.ApiError('empty-content');
+    }
+    const prev = fs.readFileSync(real, 'utf8');
+    const baseMtime = typeof data.baseMtime === 'number' ? data.baseMtime : undefined;
+    return {
+        ok: true,
+        ...writeGuarded(real, replaceDescription(prev, data.description), baseMtime),
+    };
+}

package/build/server/index.js

@@ -48,6 +48,9 @@ const scan_1 = require("./scan");
 const usage_1 = require("./usage");
 const summary_1 = require("./summary");
 const manage_1 = require("./manage");
+const edit_1 = require("./edit");
+const diagnose_1 = require("./diagnose");
+const snapshot_1 = require("./snapshot");
 const errors_1 = require("./errors");
 const locale_1 = require("./locale");
 const TOKEN = crypto.randomBytes(16).toString('hex');
@@ -120,6 +123,11 @@ function attributeUsage(sections) {
             target.autoCount = (target.autoCount || 0) + u.auto;
             target.useCount = (target.useCount || 0) + u.typed + u.auto;
             target.lastUsed = Math.max(target.lastUsed || 0, u.last);
+            if (u.daily) {
+                const du = target.dailyUse || (target.dailyUse = {});
+                for (const [day, n] of Object.entries(u.daily))
+                    du[day] = (du[day] || 0) + n;
+            }
         }
     }
     return Object.keys(byDir).length > 0;
@@ -148,6 +156,7 @@ function collect(cwd, lang) {
             }
         }
     }
+    (0, diagnose_1.attachDiagnoses)(sections, lang);
     const aiStale = (0, summary_1.staleItems)(sections, lang).length;
     const targets = [
         { label: 'user skills', sub: '~/.claude/skills/', path: scan_1.HOME },
@@ -155,7 +164,15 @@ function collect(cwd, lang) {
             .sort((a, b) => path.basename(a).localeCompare(path.basename(b)))
             .map((p) => ({ label: path.basename(p), sub: p, path: p })),
     ];
-    return { generatedAt: new Date().toISOString(), cwd, sections, targets, aiStale, usageAvailable };
+    return {
+        generatedAt: new Date().toISOString(),
+        cwd,
+        sections,
+        targets,
+        aiStale,
+        usageAvailable,
+        changes: (0, snapshot_1.computeChanges)(sections),
+    };
 }
 /* DNS rebinding 対策: same-origin GET には Origin が付かないため Host 側も検証する */
 function hostOk(req) {
@@ -197,7 +214,11 @@ function handleApi(req, res, cwd) {
                 return send(200, (0, summary_1.summaryStatus)());
             if (url.pathname === '/api/file') {
                 const real = (0, manage_1.assertReadableMd)(url.searchParams.get('src') || '');
-                return send(200, { content: fs.readFileSync(real, 'utf8') });
+                // mtime は編集画面の競合検出(/api/save の baseMtime)に使う
+                return send(200, {
+                    content: fs.readFileSync(real, 'utf8'),
+                    mtime: fs.statSync(real).mtimeMs,
+                });
             }
             throw new errors_1.ApiError('unknown-endpoint', url.pathname);
         }
@@ -224,6 +245,22 @@ function handleApi(req, res, cwd) {
         }
         const lang = langOf(data.lang);
         try {
+            if (url.pathname === '/api/save')
+                return send(200, (0, edit_1.doSave)(data));
+            if (url.pathname === '/api/apply-description')
+                return send(200, (0, edit_1.doApplyDescription)(data));
+            if (url.pathname === '/api/diagnose') {
+                const real = (0, manage_1.assertReadableMd)(data.src);
+                const name = data.name || path.basename(path.dirname(real));
+                (0, diagnose_1.diagnoseOne)(real, name, lang)
+                    .then((d) => send(200, { ok: true, ...d }))
+                    .catch((e) => send(400, (0, errors_1.toErrorBody)(e)));
+                return;
+            }
+            if (url.pathname === '/api/changes-ack') {
+                (0, snapshot_1.ackChanges)((0, scan_1.scanSections)(cwd, lang));
+                return send(200, { ok: true });
+            }
             if (url.pathname === '/api/copy')
                 return send(200, (0, manage_1.doCopy)(data, cwd));
             if (url.pathname === '/api/delete')
@@ -271,6 +308,33 @@ function serveStatic(req, res) {
     res.writeHead(200, { 'Content-Type': MIME[path.extname(fp)] || 'application/octet-stream' });
     res.end(fs.readFileSync(fp));
 }
+/*
+ * 起動時の1〜2行サマリー(--no-open 運用でも価値が出るように)。
+ * 前回からの差分 + セッション注入トークン概算 + 未使用件数。失敗しても起動は止めない。
+ */
+function printStartupSummary(cwd) {
+    try {
+        const data = collect(cwd, locale_1.serverLang);
+        const ch = data.changes;
+        if (ch) {
+            console.log((0, locale_1.srvMsg)(`前回から: 追加 ${ch.added.length} / 更新 ${ch.updated.length} / 削除 ${ch.removed.length}`, `Since last run: ${ch.added.length} added / ${ch.updated.length} updated / ${ch.removed.length} removed`));
+        }
+        const sessionTokens = data.sections
+            .filter((s) => s.source !== 'project' || s.isCurrent)
+            .flatMap((s) => s.items)
+            .reduce((sum, it) => sum + (it.tokens || 0), 0);
+        const unused = data.usageAvailable
+            ? data.sections.flatMap((s) => s.items).filter((it) => it.kind !== 'hook' && !it.useCount)
+                .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` : '')));
+    }
+    catch {
+        /* サマリーは補助情報。失敗しても起動を妨げない */
+    }
+}
 function start({ port = 4763, open = true, cwd = process.cwd() } = {}, attempt = 0) {
     const server = http.createServer((req, res) => {
         if ((req.url || '').startsWith('/api/'))
@@ -289,6 +353,7 @@ function start({ port = 4763, open = true, cwd = process.cwd() } = {}, attempt =
     server.listen(port, '127.0.0.1', () => {
         const url = `http://127.0.0.1:${port}`;
         console.log(`skills-viewer: ${url}  (cwd: ${cwd})`);
+        printStartupSummary(cwd);
         console.log((0, locale_1.srvMsg)('Ctrl+C で終了。ページ再読み込みで再スキャンされます。', 'Press Ctrl+C to quit. Reloading the page rescans.'));
         if (open && process.platform === 'darwin')
             (0, node_child_process_1.execFile)('open', [url], () => { });

package/build/server/scan.js

@@ -70,7 +70,18 @@ function parseFrontmatter(raw) {
                 value = block.join('\n').trim();
             }
             else {
-                value = value.replace(/^["']|["']$/g, '');
+                if (/^".*"$/.test(value)) {
+                    // double-quote は JSON 互換エスケープ(\" 等)を解釈する(edit.ts の書き込みと対)
+                    try {
+                        value = JSON.parse(value);
+                    }
+                    catch {
+                        value = value.slice(1, -1);
+                    }
+                }
+                else {
+                    value = value.replace(/^'|'$/g, '');
+                }
                 i++;
             }
             meta[key] = value;

package/build/server/snapshot.js

@@ -0,0 +1,114 @@
+"use strict";
+/*
+ * 前回起動時のアイテム一覧スナップショット(~/.cache/skills-viewer/snapshot.json)と
+ * 現在のスキャン結果との diff(追加・更新・削除)。「前回から何が変わったか」の基盤。
+ * - hook は同一 path・同一 name の複数定義があり識別子が安定しないため対象外
+ * - built-in は実ファイルが無く description が表示言語依存のため対象外(path='' で除外される)
+ * スナップショットの更新はユーザーの「既読」操作時のみ(差分バナーはリロードしても消えない)。
+ */
+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.buildSnapshot = buildSnapshot;
+exports.diffSnapshot = diffSnapshot;
+exports.computeChanges = computeChanges;
+exports.ackChanges = ackChanges;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const summary_1 = require("./summary");
+const SNAPSHOT_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'snapshot.json');
+function buildSnapshot(sections) {
+    const snap = {};
+    for (const s of sections) {
+        for (const it of s.items) {
+            if (it.kind === 'hook' || !it.path)
+                continue;
+            snap[it.path] = { name: it.name, kind: it.kind, hash: (0, summary_1.contentHash)(it.path) };
+        }
+    }
+    return snap;
+}
+function loadSnapshot() {
+    try {
+        return JSON.parse(fs.readFileSync(SNAPSHOT_FILE, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function saveSnapshot(snap) {
+    try {
+        fs.mkdirSync(path.dirname(SNAPSHOT_FILE), { recursive: true });
+        fs.writeFileSync(SNAPSHOT_FILE, JSON.stringify(snap, null, 1));
+    }
+    catch {
+        /* キャッシュが書けなくても本体機能には影響させない */
+    }
+}
+function diffSnapshot(prev, cur) {
+    const added = [];
+    const updated = [];
+    const removed = [];
+    for (const [p, e] of Object.entries(cur)) {
+        const old = prev[p];
+        if (!old)
+            added.push({ name: e.name, kind: e.kind, path: p });
+        else if (old.hash !== e.hash)
+            updated.push({ name: e.name, kind: e.kind, path: p });
+    }
+    for (const [p, e] of Object.entries(prev)) {
+        if (!cur[p])
+            removed.push({ name: e.name, kind: e.kind, path: p });
+    }
+    return { added, updated, removed };
+}
+/*
+ * 現在のスキャン結果と前回スナップショットの差分。
+ * 初回(スナップショット無し)は全件が「追加」になってしまうため、基準だけ保存して null。
+ */
+function computeChanges(sections) {
+    const cur = buildSnapshot(sections);
+    const prev = loadSnapshot();
+    if (!prev) {
+        saveSnapshot(cur);
+        return null;
+    }
+    const d = diffSnapshot(prev, cur);
+    return d.added.length || d.updated.length || d.removed.length ? d : null;
+}
+/* 「既読にする」: 現在の状態を新しい基準として保存する */
+function ackChanges(sections) {
+    saveSnapshot(buildSnapshot(sections));
+}

package/build/server/summary.js

@@ -40,6 +40,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadSummaries = loadSummaries;
 exports.contentHash = contentHash;
+exports.runHaiku = runHaiku;
 exports.summarizeOne = summarizeOne;
 exports.parseAnalysis = parseAnalysis;
 exports.saveSummary = saveSummary;
@@ -145,22 +146,12 @@ function buildPrompt(it, refs, content, lang) {
         content);
 }
 /*
- * 1 skill を haiku で分析し {summary, invocation, invocationReason, relations} を返す。
- * relations の候補(refs)は静的解析で抽出済みの既知 skill 名のみに制限し、幻覚を防ぐ。
+ * claude CLI headless (haiku) にプロンプトを渡して生テキストを得る共通実行部。
+ * --tools '' で全ツールを無効化: SKILL.md は clone したリポジトリ由来もあり得るため、
+ * 本文に指示が仕込まれていても純粋なテキスト生成の外に出られないようにする
  */
-function summarizeOne(it, lang) {
+function runHaiku(prompt) {
     return new Promise((resolve, reject) => {
-        let content;
-        try {
-            content = fs.readFileSync(it.path, 'utf8').slice(0, 12000);
-        }
-        catch (e) {
-            return reject(e);
-        }
-        const refs = it.refs || [];
-        const prompt = buildPrompt(it, refs, content, lang);
-        // --tools '' で全ツールを無効化: SKILL.md は clone したリポジトリ由来もあり得るため、
-        // 本文に指示が仕込まれていても純粋なテキスト生成の外に出られないようにする
         const child = (0, node_child_process_1.spawn)('claude', ['-p', '--model', 'haiku', '--tools', ''], {
             stdio: ['pipe', 'pipe', 'pipe'],
         });
@@ -184,11 +175,21 @@ function summarizeOne(it, lang) {
             const text = out.trim();
             if (code !== 0 || !text)
                 return reject(new Error(errOut.trim().slice(0, 200) || 'claude exited ' + code));
-            resolve(parseAnalysis(text, refs));
+            resolve(text);
         });
         child.stdin.end(prompt);
     });
 }
+/*
+ * 1 skill を haiku で分析し {summary, invocation, invocationReason, relations} を返す。
+ * relations の候補(refs)は静的解析で抽出済みの既知 skill 名のみに制限し、幻覚を防ぐ。
+ */
+async function summarizeOne(it, lang) {
+    const content = fs.readFileSync(it.path, 'utf8').slice(0, 12000);
+    const refs = it.refs || [];
+    const text = await runHaiku(buildPrompt(it, refs, content, lang));
+    return parseAnalysis(text, refs);
+}
 /* haiku の出力を検証つきでパース。壊れていたら全文を summary として扱う */
 function parseAnalysis(text, refs) {
     const stripped = text

package/build/server/usage.js

@@ -41,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.dayKey = dayKey;
 exports.extractHits = extractHits;
 exports.scanUsageByDir = scanUsageByDir;
 exports.encodeProjectPath = encodeProjectPath;
@@ -48,6 +49,12 @@ const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const node_string_decoder_1 = require("node:string_decoder");
+/* ローカルタイムゾーンの日付キー。web 側のスパークラインと同じ形式であること */
+function dayKey(ts) {
+    const d = new Date(ts);
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
+}
 const usageCache = new Map();
 function scanLine(line, hits) {
     const isCmd = line.includes('<command-name>');
@@ -150,10 +157,14 @@ function scanUsageByDir() {
                 usageCache.set(fp, entry);
             }
             for (const h of entry.hits) {
-                const a = agg[h.name] || (agg[h.name] = { typed: 0, auto: 0, last: 0 });
+                const a = agg[h.name] || (agg[h.name] = { typed: 0, auto: 0, last: 0, daily: {} });
                 a[h.via === 'typed' ? 'typed' : 'auto']++;
                 if (h.ts > a.last)
                     a.last = h.ts;
+                if (h.ts > 0) {
+                    const day = dayKey(h.ts);
+                    a.daily[day] = (a.daily[day] || 0) + 1;
+                }
             }
         }
     }