skills-viewer 0.2.0

package/build/server/summary.js

@@ -0,0 +1,302 @@
+"use strict";
+/*
+ * AI 要約 + 起動分類: claude CLI headless (haiku) で SKILL.md を分析し、
+ * 内容ハッシュをキーに ~/.cache/skills-viewer/summaries.json へキャッシュ。
+ * ハッシュが一致する限り再生成しない(mtime でなくハッシュなので同期や clone に強い)。
+ */
+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.loadSummaries = loadSummaries;
+exports.contentHash = contentHash;
+exports.summarizeOne = summarizeOne;
+exports.parseAnalysis = parseAnalysis;
+exports.saveSummary = saveSummary;
+exports.staleItems = staleItems;
+exports.startSummarizeAll = startSummarizeAll;
+exports.summaryStatus = summaryStatus;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const crypto = __importStar(require("node:crypto"));
+const node_child_process_1 = require("node:child_process");
+const locale_1 = require("./locale");
+const CACHE_DIR = path.join(os.homedir(), '.cache', 'skills-viewer');
+const SUMMARY_FILE = path.join(CACHE_DIR, 'summaries.json');
+// 旧パッケージ名時代のキャッシュがあれば一度だけ引き継ぐ
+for (const legacy of ['claude-code-my-skills', 'claude-skills-browser']) {
+    const legacyDir = path.join(os.homedir(), '.cache', legacy);
+    if (!fs.existsSync(CACHE_DIR) && fs.existsSync(legacyDir)) {
+        try {
+            fs.renameSync(legacyDir, CACHE_DIR);
+        }
+        catch {
+            /* 失敗しても新規生成される */
+        }
+    }
+}
+/* relation type の正規化: 新キー以外(多言語対応前の日本語値・幻覚)は references に落とす */
+const REL_TYPES = ['invokes', 'delegates', 'called-by', 'references'];
+const LEGACY_REL = {
+    起動: 'invokes',
+    委譲: 'delegates',
+    呼ばれる側: 'called-by',
+    参照: 'references',
+};
+function normalizeRelType(t) {
+    if (REL_TYPES.includes(t))
+        return t;
+    return LEGACY_REL[String(t)] || 'references';
+}
+function loadSummaries() {
+    try {
+        const store = JSON.parse(fs.readFileSync(SUMMARY_FILE, 'utf8'));
+        // 多言語対応前のキャッシュは日本語生成・日本語 relation type なので読み込み時に正規化する
+        for (const e of Object.values(store)) {
+            if (!e.lang)
+                e.lang = 'ja';
+            for (const r of e.relations || [])
+                r.type = normalizeRelType(r.type);
+        }
+        return store;
+    }
+    catch {
+        return {};
+    }
+}
+function saveSummaries(s) {
+    fs.mkdirSync(CACHE_DIR, { recursive: true });
+    fs.writeFileSync(SUMMARY_FILE, JSON.stringify(s, null, 1));
+}
+function contentHash(fp) {
+    try {
+        return crypto.createHash('sha256').update(fs.readFileSync(fp)).digest('hex').slice(0, 16);
+    }
+    catch {
+        return null;
+    }
+}
+/* 分析プロンプト。relation type は言語非依存のキーで出力させ、表示はクライアント側で解決 */
+function buildPrompt(it, refs, content, lang) {
+    if (lang === 'ja') {
+        return ('以下は Claude Code の skill 定義ファイルです。読んで、次の JSON だけを出力してください(前置き・コードフェンス不要):\n' +
+            '{"summary": "何をする skill か・いつ使うかが伝わる日本語の要約(最大2文。手順の羅列でなく用途と価値)",\n' +
+            ' "invocation": "human" | "agent" | "both",\n' +
+            ' "invocationReason": "判定理由(日本語で15字程度)",\n' +
+            ' "relations": [{"name": "skill名", "type": "invokes" | "delegates" | "called-by" | "references", "note": "関係の説明(日本語で15字程度)"}]}\n\n' +
+            'invocation は「人間が意図してコマンドとして打つ起点(human)」「他の skill やエージェントから部品・後続として呼ばれる想定(agent)」「両方(both)」のどれか。\n' +
+            'relations の type は「相手を起動する(invokes)」「相手に処理を委ねる(delegates)」「相手から呼ばれる(called-by)」「言及・参照のみ(references)」のどれか。\n' +
+            (refs.length
+                ? 'relations の name は次の候補のみ使用し、実質的な関係が読み取れるものだけ含める: ' +
+                    refs.join(', ') +
+                    '\n'
+                : 'この skill に他 skill への言及は見つかっていないため relations は [] とすること。\n') +
+            '\n# skill: ' +
+            it.name +
+            '\n\n' +
+            content);
+    }
+    return ('Below is a Claude Code skill definition file. Read it and output ONLY the following JSON (no preamble, no code fences):\n' +
+        '{"summary": "English summary conveying what the skill does and when to use it (max 2 sentences; purpose and value, not a list of steps)",\n' +
+        ' "invocation": "human" | "agent" | "both",\n' +
+        ' "invocationReason": "reason for the verdict (about 8 words)",\n' +
+        ' "relations": [{"name": "skill name", "type": "invokes" | "delegates" | "called-by" | "references", "note": "short note on the relation (about 8 words)"}]}\n\n' +
+        'invocation: "human" = a human deliberately types it as a command, "agent" = meant to be called by other skills/agents as a building block, "both" = both.\n' +
+        'relation type: "invokes" = this skill launches the other, "delegates" = hands work off to it, "called-by" = is called by it, "references" = merely mentions it.\n' +
+        (refs.length
+            ? 'Use ONLY these candidates as relation names, and include only relations that are substantively present: ' +
+                refs.join(', ') +
+                '\n'
+            : 'No mentions of other skills were found, so relations MUST be [].\n') +
+        '\n# skill: ' +
+        it.name +
+        '\n\n' +
+        content);
+}
+/*
+ * 1 skill を haiku で分析し {summary, invocation, invocationReason, relations} を返す。
+ * relations の候補(refs)は静的解析で抽出済みの既知 skill 名のみに制限し、幻覚を防ぐ。
+ */
+function summarizeOne(it, lang) {
+    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'],
+        });
+        let out = '', errOut = '';
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            reject(new Error('timeout (120s)'));
+        }, 120000);
+        child.stdout.on('data', (d) => {
+            out += d;
+        });
+        child.stderr.on('data', (d) => {
+            errOut += d;
+        });
+        child.on('error', (e) => {
+            clearTimeout(timer);
+            reject(e);
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            const text = out.trim();
+            if (code !== 0 || !text)
+                return reject(new Error(errOut.trim().slice(0, 200) || 'claude exited ' + code));
+            resolve(parseAnalysis(text, refs));
+        });
+        child.stdin.end(prompt);
+    });
+}
+/* haiku の出力を検証つきでパース。壊れていたら全文を summary として扱う */
+function parseAnalysis(text, refs) {
+    const stripped = text
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/, '')
+        .trim();
+    try {
+        const j = JSON.parse(stripped);
+        const invocation = ['human', 'agent', 'both'].includes(j.invocation)
+            ? j.invocation
+            : null;
+        const refSet = new Set(refs);
+        const relations = Array.isArray(j.relations)
+            ? j.relations
+                .filter((r) => r && typeof r.name === 'string' && refSet.has(r.name))
+                .map((r) => ({
+                name: r.name,
+                type: normalizeRelType(r.type),
+                note: String(r.note || '').slice(0, 40),
+            }))
+            : [];
+        return {
+            summary: String(j.summary || '').trim() || stripped,
+            invocation,
+            invocationReason: String(j.invocationReason || '').slice(0, 40),
+            relations,
+        };
+    }
+    catch {
+        return { summary: stripped, invocation: null, invocationReason: '', relations: [] };
+    }
+}
+function saveSummary(realPath, name, analysis, lang) {
+    const summaries = loadSummaries();
+    summaries[realPath] = {
+        hash: contentHash(realPath),
+        name,
+        summary: analysis.summary,
+        invocation: analysis.invocation ?? undefined,
+        invocationReason: analysis.invocationReason,
+        relations: analysis.relations,
+        generatedAt: new Date().toISOString(),
+        lang,
+    };
+    saveSummaries(summaries);
+}
+/* 要約対象 = 実ファイルを持つ skill/command/agent(hook は設定エントリなので除外) */
+function summarizableItems(sections) {
+    const out = [];
+    for (const sec of sections) {
+        for (const it of sec.items) {
+            if (it.kind === 'hook')
+                continue;
+            if (!fs.existsSync(it.path))
+                continue; // built-in
+            out.push({ path: it.path, name: it.name, refs: it.refs || [] });
+        }
+    }
+    return out;
+}
+/* 未生成・内容変更に加え、要約の生成言語が表示言語と違うものも「未生成」扱いにする */
+function staleItems(sections, lang) {
+    const summaries = loadSummaries();
+    return summarizableItems(sections).filter((it) => {
+        const cached = summaries[it.path];
+        return (!cached ||
+            cached.hash !== contentHash(it.path) ||
+            cached.invocation === undefined ||
+            cached.lang !== lang);
+    });
+}
+let summaryJob = null;
+function startSummarizeAll(sections, force, lang) {
+    if (summaryJob && !summaryJob.finished)
+        return summaryJob;
+    const items = force ? summarizableItems(sections) : staleItems(sections, lang);
+    summaryJob = {
+        total: items.length,
+        done: 0,
+        current: '',
+        errors: [],
+        finished: items.length === 0,
+    };
+    if (summaryJob.finished)
+        return summaryJob;
+    const job = summaryJob;
+    (async () => {
+        let idx = 0;
+        const worker = async () => {
+            while (idx < items.length) {
+                const it = items[idx++];
+                job.current = it.name;
+                try {
+                    const analysis = await summarizeOne(it, lang);
+                    saveSummary(it.path, it.name, analysis, lang);
+                }
+                catch (e) {
+                    job.errors.push(it.name + ': ' + (e instanceof Error ? e.message : String(e)));
+                }
+                job.done++;
+            }
+        };
+        await Promise.all(Array.from({ length: Math.min(3, items.length) }, worker));
+        job.finished = true;
+        console.log((0, locale_1.srvMsg)(`summarize: ${job.done}件完了, エラー ${job.errors.length}件`, `summarize: ${job.done} done, ${job.errors.length} error(s)`));
+    })();
+    return summaryJob;
+}
+function summaryStatus() {
+    return summaryJob || { finished: true, total: 0, done: 0, errors: [] };
+}

package/build/server/usage.js

@@ -0,0 +1,165 @@
+"use strict";
+/*
+ * skill / agent 起動履歴の集計。~/.claude/projects/<proj>/<session>.jsonl に残る3形式を拾う:
+ *   - user-typed slash:  <command-name>/weall-ship</command-name>
+ *   - model via tool:    "name":"Skill","input":{"skill":"weall-ship"
+ *   - subagent 起動:      "subagent_type":"code-reviewer"
+ * ファイルごとに mtime でキャッシュ。トランスクリプトは Claude Code の保持期間で
+ * 削除されるため、集計はその期間内のみ。
+ */
+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.extractHits = extractHits;
+exports.scanUsageByDir = scanUsageByDir;
+exports.encodeProjectPath = encodeProjectPath;
+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");
+const usageCache = new Map();
+function scanLine(line, hits) {
+    const isCmd = line.includes('<command-name>');
+    const isSkill = line.includes('"name":"Skill"');
+    const isAgent = line.includes('"subagent_type"');
+    if (!isCmd && !isSkill && !isAgent)
+        return;
+    const tm = line.match(/"timestamp":"([^"]+)"/);
+    const ts = tm ? Date.parse(tm[1]) || 0 : 0;
+    if (isCmd) {
+        for (const m of line.matchAll(/<command-name>\/?([^<]+)<\/command-name>/g)) {
+            hits.push({ name: m[1].trim(), ts, via: 'typed' });
+        }
+    }
+    if (isSkill) {
+        for (const m of line.matchAll(/"name":"Skill","input":\{"skill":"([^"]+)"/g)) {
+            hits.push({ name: m[1], ts, via: 'auto' });
+        }
+    }
+    if (isAgent) {
+        // Agent/Task ツールによるサブエージェント起動(agent 定義の使用実績として扱う)
+        for (const m of line.matchAll(/"subagent_type":"([^"]+)"/g)) {
+            hits.push({ name: m[1], ts, via: 'auto' });
+        }
+    }
+}
+/*
+ * トランスクリプトは合計 GB 級になり得るため全文を一括読みせず、チャンク単位で読んで
+ * 行ごとに処理する(メモリ使用はチャンク + 改行待ちの1行分に収まる)。
+ * chunkSize はテスト用に指定可能。StringDecoder が境界で割れたマルチバイト文字を繋ぐ。
+ */
+function extractHits(fp, chunkSize = 1 << 20) {
+    const hits = [];
+    let fd;
+    try {
+        fd = fs.openSync(fp, 'r');
+    }
+    catch {
+        return hits;
+    }
+    try {
+        const buf = Buffer.alloc(chunkSize);
+        const decoder = new node_string_decoder_1.StringDecoder('utf8');
+        let rest = '';
+        let bytes;
+        while ((bytes = fs.readSync(fd, buf, 0, buf.length, null)) > 0) {
+            const lines = (rest + decoder.write(buf.subarray(0, bytes))).split('\n');
+            rest = lines.pop() || '';
+            for (const line of lines)
+                scanLine(line, hits);
+        }
+        rest += decoder.end();
+        if (rest)
+            scanLine(rest, hits);
+    }
+    catch {
+        /* 途中で読めなくなったら部分結果を返す */
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return hits;
+}
+/*
+ * トランスクリプトの親ディレクトリ = 呼び出し元プロジェクト(パスを [^a-zA-Z0-9]→'-' で
+ * エンコードした名前)。同名 skill を正しい定義に帰属させるため、ディレクトリ別に集計する。
+ */
+function scanUsageByDir() {
+    const byDir = {};
+    const root = path.join(os.homedir(), '.claude', 'projects');
+    let dirs;
+    try {
+        dirs = fs.readdirSync(root, { withFileTypes: true }).filter((d) => d.isDirectory());
+    }
+    catch {
+        return byDir;
+    }
+    for (const d of dirs) {
+        const dir = path.join(root, d.name);
+        let files;
+        try {
+            files = fs.readdirSync(dir).filter((f) => f.endsWith('.jsonl'));
+        }
+        catch {
+            continue;
+        }
+        const agg = byDir[d.name] || (byDir[d.name] = {});
+        for (const f of files) {
+            const fp = path.join(dir, f);
+            let st;
+            try {
+                st = fs.statSync(fp);
+            }
+            catch {
+                continue;
+            }
+            let entry = usageCache.get(fp);
+            if (!entry || entry.mtimeMs !== st.mtimeMs) {
+                entry = { mtimeMs: st.mtimeMs, hits: extractHits(fp) };
+                usageCache.set(fp, entry);
+            }
+            for (const h of entry.hits) {
+                const a = agg[h.name] || (agg[h.name] = { typed: 0, auto: 0, last: 0 });
+                a[h.via === 'typed' ? 'typed' : 'auto']++;
+                if (h.ts > a.last)
+                    a.last = h.ts;
+            }
+        }
+    }
+    return byDir;
+}
+/* Claude Code のトランスクリプトディレクトリ名と同じ規則でプロジェクトパスをエンコード */
+function encodeProjectPath(p) {
+    return p.replace(/[^a-zA-Z0-9]/g, '-');
+}

package/build/shared/types.js

@@ -0,0 +1,3 @@
+"use strict";
+/* server / web 共通の型定義(単一ソース) */
+Object.defineProperty(exports, "__esModule", { value: true });