skills-viewer 0.4.0 → 0.6.0

package/README.md

@@ -17,9 +17,14 @@ npx skills-viewer
 ## Features
 
 - **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
 - **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
+- **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

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, model = 'haiku') {
+    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.runClaude)(buildPrompt(name, content, lang), model));
+    store[realPath] = { ...result, hash, lang, model, 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/flow.js

@@ -0,0 +1,157 @@
+"use strict";
+/*
+ * AI フロー図解: SKILL.md からオーケストレーションの処理フローを抽出する
+ * (docs/plans/09 参照)。diagnose.ts と同じオンデマンド + content hash + lang キャッシュ。
+ * スキーマは LLM が壊しにくい「直列 steps + 分岐注記」に制約し、任意の DAG は扱わない。
+ */
+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.loadFlows = loadFlows;
+exports.parseFlow = parseFlow;
+exports.flowOne = flowOne;
+exports.attachFlows = attachFlows;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const summary_1 = require("./summary");
+const FLOW_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'flows.json');
+function loadFlows() {
+    try {
+        return JSON.parse(fs.readFileSync(FLOW_FILE, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveFlows(store) {
+    fs.mkdirSync(path.dirname(FLOW_FILE), { recursive: true });
+    fs.writeFileSync(FLOW_FILE, JSON.stringify(store, null, 1));
+}
+function buildPrompt(name, content, lang) {
+    if (lang === 'ja') {
+        return ('以下は Claude Code の skill 定義です。この skill が実行する処理フローを図解用に抽出し、次の JSON だけを出力してください(前置き・コードフェンス不要):\n' +
+            '{"steps": [{"title": "ステップ名(10字程度)", "detail": "何をするか(25字程度)",\n' +
+            ' "calls": ["このステップで起動/委譲する他の skill・コマンド名"],\n' +
+            ' "gate": "human" | "auto" | null,\n' +
+            ' "branches": [{"when": "分岐条件(15字程度)", "then": "その場合の挙動(20字程度)"}]}]}\n\n' +
+            '制約:\n' +
+            '- steps は実行順に 4〜8 個(単純な skill なら少なくてよい)\n' +
+            '- gate は人間の確認/承認を待つステップだけ "human"(自動で進むなら "auto"、該当なしは null)\n' +
+            '- calls は本文に実際に登場する名前のみ(幻覚禁止)\n' +
+            '- branches は中断・フォールバック等の分岐だけ(無ければ省略)\n\n' +
+            '# skill: ' +
+            name +
+            '\n\n' +
+            content);
+    }
+    return ('Below is a Claude Code skill definition. Extract the processing flow this skill executes, for a diagram, and output ONLY this JSON (no preamble, no code fences):\n' +
+        '{"steps": [{"title": "step name (2-4 words)", "detail": "what it does (about 10 words)",\n' +
+        ' "calls": ["other skill/command names this step invokes or delegates to"],\n' +
+        ' "gate": "human" | "auto" | null,\n' +
+        ' "branches": [{"when": "branch condition (about 5 words)", "then": "behavior in that case (about 7 words)"}]}]}\n\n' +
+        'Constraints:\n' +
+        '- 4 to 8 steps in execution order (fewer is fine for simple skills)\n' +
+        '- gate is "human" ONLY for steps that wait for human confirmation/approval ("auto" if it proceeds automatically, null otherwise)\n' +
+        '- calls may contain only names that actually appear in the body (no hallucination)\n' +
+        '- branches only for aborts / fallbacks / real forks (omit when none)\n\n' +
+        '# skill: ' +
+        name +
+        '\n\n' +
+        content);
+}
+/* haiku/sonnet の出力を検証つきでパース(壊れた出力は throw して UI にエラー表示) */
+function parseFlow(text) {
+    const stripped = text
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/, '')
+        .trim();
+    const j = JSON.parse(stripped);
+    const steps = [];
+    for (const s of Array.isArray(j.steps) ? j.steps : []) {
+        const title = String(s?.title || '').trim();
+        if (!title)
+            continue;
+        steps.push({
+            title: title.slice(0, 60),
+            detail: String(s?.detail || '').slice(0, 120),
+            calls: (Array.isArray(s?.calls) ? s.calls : [])
+                .filter((c) => typeof c === 'string' && c)
+                .map((c) => c.slice(0, 60))
+                .slice(0, 6),
+            gate: s?.gate === 'human' || s?.gate === 'auto' ? s.gate : null,
+            branches: (Array.isArray(s?.branches) ? s.branches : [])
+                .filter((b) => b && typeof b.when === 'string')
+                .map((b) => ({
+                when: String(b.when).slice(0, 60),
+                then: String(b.then || '').slice(0, 80),
+            }))
+                .slice(0, 4),
+        });
+        if (steps.length >= 12)
+            break;
+    }
+    if (!steps.length)
+        throw new Error('no steps in output');
+    return { steps };
+}
+async function flowOne(realPath, name, lang, model = 'haiku') {
+    const hash = (0, summary_1.contentHash)(realPath);
+    const store = loadFlows();
+    const cached = store[realPath];
+    if (cached && cached.hash === hash && cached.lang === lang) {
+        return { steps: cached.steps };
+    }
+    const content = fs.readFileSync(realPath, 'utf8').slice(0, 12000);
+    const result = parseFlow(await (0, summary_1.runClaude)(buildPrompt(name, content, lang), model));
+    store[realPath] = { ...result, hash, lang, model, generatedAt: new Date().toISOString() };
+    saveFlows(store);
+    return result;
+}
+/* スキャン結果にキャッシュ済みフローを付与(内容が変わっていれば付けない) */
+function attachFlows(sections, lang) {
+    const store = loadFlows();
+    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.aiFlow = { steps: cached.steps };
+            }
+        }
+    }
+}

package/build/server/groups.js

@@ -0,0 +1,202 @@
+"use strict";
+/*
+ * AI グルーピング: 環境内の全アイテム(name + description)を 1 回の haiku 呼び出しに渡し、
+ * 「用途グループの集合 + 各アイテムの割当」をまとめて生成する(docs/plans/08 参照)。
+ * グループ名はプロダクトに焼き込まず環境ごとに生成し、職種非依存の工程軸は
+ * 粒度ガイドとしてだけプロンプトに渡す。frontmatter に category を持つアイテムは
+ * 手動指定として AI 分類の対象外(クライアント側で category がそのままグループになる)。
+ * キャッシュは summary.ts と同思想だが、環境単位で言語ごとに 1 エントリ
+ * (全対象アイテムの name + description の hash)。アイテムの増減・description 変更で
+ * stale になるが、自動再生成はせず UI から手動で再分類する。
+ */
+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.groupTargets = groupTargets;
+exports.groupsHash = groupsHash;
+exports.parseGroups = parseGroups;
+exports.generateGroups = generateGroups;
+exports.attachGroups = attachGroups;
+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 summary_1 = require("./summary");
+const GROUPS_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'groups.json');
+function loadStore() {
+    try {
+        return JSON.parse(fs.readFileSync(GROUPS_FILE, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveStore(store) {
+    fs.mkdirSync(path.dirname(GROUPS_FILE), { recursive: true });
+    fs.writeFileSync(GROUPS_FILE, JSON.stringify(store, null, 1));
+}
+/*
+ * 分類対象 = hook 以外の全アイテム(built-in 含む)を name で重複排除したもの。
+ * 同名アイテム(user と project の code-review 等)は同じグループに落とす。
+ * category 持ちは手動指定なので対象外。description は 200 字で切る(分類には十分)。
+ */
+function groupTargets(sections) {
+    const seen = new Map();
+    for (const s of sections) {
+        for (const it of s.items) {
+            if (it.kind === 'hook' || it.category || seen.has(it.name))
+                continue;
+            seen.set(it.name, { name: it.name, description: it.description.slice(0, 200) });
+        }
+    }
+    return [...seen.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function groupsHash(targets) {
+    const src = targets.map((t) => t.name + '\t' + t.description).join('\n');
+    return crypto.createHash('sha256').update(src).digest('hex').slice(0, 16);
+}
+/* 職種非依存の工程軸(粒度ガイド)。グループ名の直接指定ではない */
+const AXIS_JA = '企画・要件 / 制作・実装 / レビュー・検証 / リリース・共有 / 調査・分析 / 記録・運用';
+const AXIS_EN = 'planning & requirements / building & creating / review & verification / release & sharing / research & analysis / records & operations';
+function buildPrompt(targets, lang) {
+    const list = targets.map((t) => t.name + ': ' + t.description).join('\n');
+    if (lang === 'ja') {
+        return ('以下は Claude Code にインストールされた skill / command / agent の一覧です(1行 = 「name: description」)。\n' +
+            'これらを「いつ・何をするときに使うか」の観点でグループ分けし、次の JSON だけを出力してください(前置き・コードフェンス不要):\n' +
+            '{"groups": [{"id": "英小文字とハイフンのスラッグ(言語非依存)", "label": "グループ名(日本語で10字程度)", "emoji": "グループを表す絵文字1つ"}],\n' +
+            ' "assign": {"<name>": "<groupId>"}}\n\n' +
+            '制約:\n' +
+            '- グループ数は 4〜8。粒度の目安は職種を問わない工程軸「' +
+            AXIS_JA +
+            '」。ただしグループ名はこの一覧の実態に合わせること(例に無い分野があればそのグループを作ってよい)\n' +
+            '- assign には一覧の全 name を必ず 1 回ずつ含める。迷う場合も最も近いグループに割り当てる\n' +
+            '- assign の値は groups で定義した id のみ使用する\n\n' +
+            '# 一覧\n' +
+            list);
+    }
+    return ('Below is a list of skills / commands / agents installed for Claude Code (one per line, "name: description").\n' +
+        'Group them by WHEN and FOR WHAT they are used, and output ONLY this JSON (no preamble, no code fences):\n' +
+        '{"groups": [{"id": "lowercase-hyphen slug (language-neutral)", "label": "group name in English (2-4 words)", "emoji": "one emoji for the group"}],\n' +
+        ' "assign": {"<name>": "<groupId>"}}\n\n' +
+        'Constraints:\n' +
+        '- 4 to 8 groups. Use this role-agnostic workflow axis as a granularity guide: ' +
+        AXIS_EN +
+        '. Name the groups after what is actually in the list (create different groups if the list calls for them).\n' +
+        '- assign MUST contain every name from the list exactly once; when unsure, pick the closest group.\n' +
+        '- assign values must be ids defined in groups.\n\n' +
+        '# List\n' +
+        list);
+}
+/* id を言語非依存スラッグに正規化(空になったら null) */
+function slugify(v) {
+    const s = String(v ?? '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return s || null;
+}
+/*
+ * haiku の出力を検証つきでパース。
+ * - groups: id をスラッグ正規化・重複排除し、最大 12 件
+ * - assign: 一覧に無い name(幻覚)と未定義グループへの割当は捨てる(→「その他」扱い)
+ * groups が 1 件も取れない出力はエラー(UI にエラー表示)
+ */
+function parseGroups(text, names) {
+    const stripped = text
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/, '')
+        .trim();
+    const j = JSON.parse(stripped);
+    const groups = [];
+    const ids = new Set();
+    for (const g of Array.isArray(j.groups) ? j.groups : []) {
+        const id = slugify(g?.id);
+        const label = String(g?.label || '').trim();
+        if (!id || !label || ids.has(id))
+            continue;
+        ids.add(id);
+        const emoji = String(g?.emoji || '').trim();
+        groups.push({ id, label: label.slice(0, 40), ...(emoji ? { emoji: emoji.slice(0, 8) } : {}) });
+        if (groups.length >= 12)
+            break;
+    }
+    if (!groups.length)
+        throw new Error('no groups in output');
+    const nameSet = new Set(names);
+    const assign = {};
+    for (const [name, gid] of Object.entries(j.assign || {})) {
+        const id = slugify(gid);
+        if (nameSet.has(name) && id && ids.has(id))
+            assign[name] = id;
+    }
+    return { groups, assign };
+}
+/*
+ * 環境全体を 1 回の claude 呼び出しで分類してキャッシュに保存する。
+ * 入力が大きく(全アイテム一覧)haiku でも 2 分近くかかるため、タイムアウトは
+ * 単体要約(120s)より長い 10 分にする(sonnet / opus はさらに遅い)
+ */
+async function generateGroups(sections, lang, model = 'haiku') {
+    const targets = groupTargets(sections);
+    const result = parseGroups(await (0, summary_1.runClaude)(buildPrompt(targets, lang), model, 600000), targets.map((t) => t.name));
+    const store = loadStore();
+    store[lang] = {
+        ...result,
+        hash: groupsHash(targets),
+        model,
+        generatedAt: new Date().toISOString(),
+    };
+    saveStore(store);
+    return result;
+}
+/*
+ * スキャン結果にキャッシュ済みの割当を付与する。
+ * stale(生成後に構成が変わった)でも古い割当は表示価値があるので付与し、
+ * stale フラグで UI に再分類を促す。新規アイテムは割当なし(「その他」に落ちる)。
+ */
+function attachGroups(sections, lang) {
+    const entry = loadStore()[lang];
+    if (!entry)
+        return { stale: false };
+    for (const s of sections) {
+        for (const it of s.items) {
+            if (it.kind === 'hook' || it.category)
+                continue;
+            const gid = entry.assign[it.name];
+            if (gid)
+                it.aiGroup = gid;
+        }
+    }
+    return { groups: entry.groups, stale: entry.hash !== groupsHash(groupTargets(sections)) };
+}