@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/skills/official/ui-ux-pro-max.md

@@ -1,105 +0,0 @@
----
-name: ui-ux-pro-max
-version: 2.5.0
-description: "AI 驱动的设计智能工具：67 种 UI 风格、161 种配色、57 种字体搭配、99 条 UX 准则"
-tags: [ui, ux, design, color, typography, accessibility]
----
-
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-Antigravity Kit is an AI-powered design intelligence toolkit providing searchable databases of UI styles, color palettes, font pairings, chart types, and UX guidelines. It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.).
-
-## Search Command
-
-```bash
-python3 src/ui-ux-pro-max/scripts/search.py "<query>" --domain <domain> [-n <max_results>]
-```
-
-**Domain search:**
-- `product` - Product type recommendations (SaaS, e-commerce, portfolio)
-- `style` - UI styles (glassmorphism, minimalism, brutalism) + AI prompts and CSS keywords
-- `typography` - Font pairings with Google Fonts imports
-- `color` - Color palettes by product type
-- `landing` - Page structure and CTA strategies
-- `chart` - Chart types and library recommendations
-- `ux` - Best practices and anti-patterns
-
-**Stack search:**
-```bash
-python3 src/ui-ux-pro-max/scripts/search.py "<query>" --stack <stack>
-```
-Available stacks: `html-tailwind` (default), `react`, `nextjs`, `astro`, `vue`, `nuxtjs`, `nuxt-ui`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`
-
-## Architecture
-
-```
-src/ui-ux-pro-max/                # Source of Truth
-├── data/                         # Canonical CSV databases
-│   ├── products.csv, styles.csv, colors.csv, typography.csv, ...
-│   └── stacks/                   # Stack-specific guidelines
-├── scripts/
-│   ├── search.py                 # CLI entry point
-│   ├── core.py                   # BM25 + regex hybrid search engine
-│   └── design_system.py          # Design system generation
-└── templates/
-    ├── base/                     # Base templates (skill-content.md, quick-reference.md)
-    └── platforms/                # Platform configs (claude.json, cursor.json, ...)
-
-cli/                              # CLI installer (uipro-cli on npm)
-├── src/
-│   ├── commands/init.ts          # Install command with template generation
-│   └── utils/template.ts         # Template rendering engine
-└── assets/                       # Bundled assets (~564KB)
-    ├── data/                     # Copy of src/ui-ux-pro-max/data/
-    ├── scripts/                  # Copy of src/ui-ux-pro-max/scripts/
-    └── templates/                # Copy of src/ui-ux-pro-max/templates/
-
-.claude/skills/ui-ux-pro-max/     # Claude Code skill (symlinks to src/)
-.factory/skills/ui-ux-pro-max/   # Droid (Factory) skill (symlinks to src/)
-.shared/ui-ux-pro-max/            # Symlink to src/ui-ux-pro-max/
-.claude-plugin/                   # Claude Marketplace publishing
-```
-
-The search engine uses BM25 ranking combined with regex matching. Domain auto-detection is available when `--domain` is omitted.
-
-## Sync Rules
-
-**Source of Truth:** `src/ui-ux-pro-max/`
-
-When modifying files:
-
-1. **Data & Scripts** - Edit in `src/ui-ux-pro-max/`:
-   - `data/*.csv` and `data/stacks/*.csv`
-   - `scripts/*.py`
-   - Changes automatically available via symlinks in `.claude/`, `.factory/`, `.shared/`
-
-2. **Templates** - Edit in `src/ui-ux-pro-max/templates/`:
-   - `base/skill-content.md` - Common SKILL.md content
-   - `base/quick-reference.md` - Quick reference section (Claude only)
-   - `platforms/*.json` - Platform-specific configs
-
-3. **CLI Assets** - Run sync before publishing:
-   ```bash
-   cp -r src/ui-ux-pro-max/data/* cli/assets/data/
-   cp -r src/ui-ux-pro-max/scripts/* cli/assets/scripts/
-   cp -r src/ui-ux-pro-max/templates/* cli/assets/templates/
-   ```
-
-4. **Reference Folders** - No manual sync needed. The CLI generates these from templates during `uipro init`.
-
-## Prerequisites
-
-Python 3.x (no external dependencies required)
-
-## Git Workflow
-
-Never push directly to `main`. Always:
-
-1. Create a new branch: `git checkout -b feat/...` or `fix/...`
-2. Commit changes
-3. Push branch: `git push -u origin <branch>`
-4. Create PR: `gh pr create`

package/dist/skills/official/webapp-testing.md

@@ -1,96 +0,0 @@
----
-name: webapp-testing
-description: Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
-license: Complete terms in LICENSE.txt
----
-
-# Web Application Testing
-
-To test local web applications, write native Python Playwright scripts.
-
-**Helper Scripts Available**:
-- `scripts/with_server.py` - Manages server lifecycle (supports multiple servers)
-
-**Always run scripts with `--help` first** to see usage. DO NOT read the source until you try running the script first and find that a customized solution is abslutely necessary. These scripts can be very large and thus pollute your context window. They exist to be called directly as black-box scripts rather than ingested into your context window.
-
-## Decision Tree: Choosing Your Approach
-
-```
-User task → Is it static HTML?
-    ├─ Yes → Read HTML file directly to identify selectors
-    │         ├─ Success → Write Playwright script using selectors
-    │         └─ Fails/Incomplete → Treat as dynamic (below)
-    │
-    └─ No (dynamic webapp) → Is the server already running?
-        ├─ No → Run: python scripts/with_server.py --help
-        │        Then use the helper + write simplified Playwright script
-        │
-        └─ Yes → Reconnaissance-then-action:
-            1. Navigate and wait for networkidle
-            2. Take screenshot or inspect DOM
-            3. Identify selectors from rendered state
-            4. Execute actions with discovered selectors
-```
-
-## Example: Using with_server.py
-
-To start a server, run `--help` first, then use the helper:
-
-**Single server:**
-```bash
-python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py
-```
-
-**Multiple servers (e.g., backend + frontend):**
-```bash
-python scripts/with_server.py \
-  --server "cd backend && python server.py" --port 3000 \
-  --server "cd frontend && npm run dev" --port 5173 \
-  -- python your_automation.py
-```
-
-To create an automation script, include only Playwright logic (servers are managed automatically):
-```python
-from playwright.sync_api import sync_playwright
-
-with sync_playwright() as p:
-    browser = p.chromium.launch(headless=True) # Always launch chromium in headless mode
-    page = browser.new_page()
-    page.goto('http://localhost:5173') # Server already running and ready
-    page.wait_for_load_state('networkidle') # CRITICAL: Wait for JS to execute
-    # ... your automation logic
-    browser.close()
-```
-
-## Reconnaissance-Then-Action Pattern
-
-1. **Inspect rendered DOM**:
-   ```python
-   page.screenshot(path='/tmp/inspect.png', full_page=True)
-   content = page.content()
-   page.locator('button').all()
-   ```
-
-2. **Identify selectors** from inspection results
-
-3. **Execute actions** using discovered selectors
-
-## Common Pitfall
-
-❌ **Don't** inspect the DOM before waiting for `networkidle` on dynamic apps
-✅ **Do** wait for `page.wait_for_load_state('networkidle')` before inspection
-
-## Best Practices
-
-- **Use bundled scripts as black boxes** - To accomplish a task, consider whether one of the scripts available in `scripts/` can help. These scripts handle common, complex workflows reliably without cluttering the context window. Use `--help` to see usage, then invoke directly. 
-- Use `sync_playwright()` for synchronous scripts
-- Always close the browser when done
-- Use descriptive selectors: `text=`, `role=`, CSS selectors, or IDs
-- Add appropriate waits: `page.wait_for_selector()` or `page.wait_for_timeout()`
-
-## Reference Files
-
-- **examples/** - Examples showing common patterns:
-  - `element_discovery.py` - Discovering buttons, links, and inputs on a page
-  - `static_html_automation.py` - Using file:// URLs for local HTML
-  - `console_logging.py` - Capturing console logs during automation

package/dist/skills/official-skills.d.ts

@@ -1,26 +0,0 @@
-/**
- * Official built-in skills for claude-forge
- * Skill content is stored in src/skills/official/*.md files.
- */
-export interface OfficialSkill {
-    name: string;
-    version: string;
-    description: string;
-    keywords: string[];
-    content: string;
-}
-/**
- * Official skill keyword mappings
- * Used for skill matching and orchestration
- */
-export declare const OFFICIAL_SKILL_KEYWORDS: Record<string, string[]>;
-/**
- * Load official skills from a directory of .md files.
- * Each .md file should have frontmatter with at minimum a `name` field.
- * The `keywords` or `tags` field in frontmatter provides keyword matching hints.
- *
- * @param builtinDir - Path to the directory containing official skill .md files
- * @returns Array of OfficialSkill objects
- */
-export declare function loadOfficialSkills(builtinDir: string): OfficialSkill[];
-//# sourceMappingURL=official-skills.d.ts.map

package/dist/skills/official-skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"official-skills.d.ts","sourceRoot":"","sources":["../../src/skills/official-skills.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAqB5D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAqCtE"}

package/dist/skills/official-skills.js

@@ -1,74 +0,0 @@
-/**
- * Official built-in skills for claude-forge
- * Skill content is stored in src/skills/official/*.md files.
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import matter from 'gray-matter';
-/**
- * Official skill keyword mappings
- * Used for skill matching and orchestration
- */
-export const OFFICIAL_SKILL_KEYWORDS = {
-    'official-tdd': ['tdd', 'test-driven', '测试驱动'],
-    'official-debug': ['debug', '调试', 'bug', '修复', 'fix', 'hotfix', '报错', '异常', 'error', '不工作', '失败', 'failed', 'crash', '问题'],
-    'official-refactor': ['refactor', '重构', 'cleanup', 'reorganize', 'restructure'],
-    'official-pr-review': ['review', '审查', 'pr review', 'code review', '检查', '看看代码', '帮我看', '评审'],
-    'official-harness-engineering': ['harness', 'legacy', '遗留代码', '特征测试', 'characterization', '重构', 'refactor', '改造', '老代码'],
-    'official-bmad': ['bmad', 'agile', 'four-role', '敏捷', '四角色', 'story', 'user story', 'sprint', '迭代'],
-    'official-spec-driven-design': ['spec', 'sdd', 'spec-driven', '规格', '需求文档', 'requirements'],
-    'official-openspec': ['openspec', 'open spec', 'opsx', 'propose', '/opsx', 'proposal', '提案', 'spec 拆分', '规格驱动'],
-    'official-architecture-decision': ['adr', 'architecture decision', '架构决策', '技术选型'],
-    'official-api-design': ['api design', 'api 设计', 'restful', 'openapi', '接口设计'],
-    'official-db-schema-design': ['schema', 'database', '数据库设计', 'migration', '迁移', 'sql'],
-    'official-performance-optimization': ['performance', '性能', 'optimize', '优化', 'profiling', '瓶颈', '慢', 'slow', 'timeout', '超时', '卡顿', 'latency'],
-    'official-security-hardening': ['security', '安全', 'owasp', 'hardening', '加固', 'vulnerability', '漏洞', '注入', 'injection', 'xss', 'csrf', '权限', 'auth'],
-    'official-release-checklist': ['release', 'deploy', '发布', '上线', 'checklist', '部署'],
-    'official-doc-driven': ['doc-driven', 'documentation', '文档驱动', '写文档', 'readme'],
-    'planning-with-files': ['plan', 'planning', '规划', 'task plan', 'organize', '组织任务', '怎么做', '方案', '步骤', '计划'],
-    'code-simplifier': ['simplify', 'refine', '简化', 'cleanup', 'code quality'],
-    'find-skills': ['find skill', 'search skill', '查找技能', 'discover', 'install skill'],
-    'webapp-testing': ['test webapp', 'playwright', 'browser test', 'e2e', 'frontend test'],
-    'ui-ux-pro-max': ['ui', 'ux', 'design', 'color', 'typography', 'palette', '设计'],
-};
-/**
- * Load official skills from a directory of .md files.
- * Each .md file should have frontmatter with at minimum a `name` field.
- * The `keywords` or `tags` field in frontmatter provides keyword matching hints.
- *
- * @param builtinDir - Path to the directory containing official skill .md files
- * @returns Array of OfficialSkill objects
- */
-export function loadOfficialSkills(builtinDir) {
-    if (!fs.existsSync(builtinDir)) {
-        throw new Error(`Official skills directory not found: ${builtinDir}`);
-    }
-    const entries = fs.readdirSync(builtinDir);
-    const skills = [];
-    for (const filename of entries) {
-        if (!filename.endsWith('.md'))
-            continue;
-        const filePath = path.join(builtinDir, filename);
-        const raw = fs.readFileSync(filePath, 'utf-8');
-        const parsed = matter(raw);
-        const { data, content: body } = parsed;
-        const id = path.basename(filename, '.md');
-        const name = typeof data.name === 'string' ? data.name : id;
-        const version = typeof data.version === 'string' ? data.version : '1.0.0';
-        const description = typeof data.description === 'string' ? data.description : '';
-        // Support both `keywords` (claude-forge standard) and `tags` (Claude Code official skill convention)
-        const rawKeywords = data.keywords ?? data.tags;
-        const keywords = Array.isArray(rawKeywords)
-            ? rawKeywords.filter((k) => typeof k === 'string')
-            : [];
-        skills.push({
-            name,
-            version,
-            description,
-            keywords,
-            content: raw, // full file content including frontmatter
-        });
-    }
-    return skills;
-}
-//# sourceMappingURL=official-skills.js.map

package/dist/skills/official-skills.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"official-skills.js","sourceRoot":"","sources":["../../src/skills/official-skills.ts"],"names":[],"mappings":"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"}

package/dist/skills/semantic-matcher.d.ts

@@ -1,60 +0,0 @@
-/**
- * AI-powered semantic skill matcher using Claude API
- * Provides more accurate skill recommendations by understanding user intent
- */
-import type { Skill } from './registry.js';
-export interface SemanticMatchResult {
-    skill: Skill;
-    confidence: number;
-    reasoning: string;
-}
-export interface SemanticMatchContext {
-    prompt: string;
-    intentKeywords?: string[];
-    recentFiles?: string[];
-    projectPath?: string;
-}
-/**
- * Semantic matcher using Claude API for intent understanding
- */
-export declare class SemanticSkillMatcher {
-    private client;
-    private model;
-    private static readonly CACHE_MAX_ENTRIES;
-    private readonly CACHE_TTL;
-    private cache;
-    constructor(apiKey?: string, model?: string, baseURL?: string);
-    /**
-     * Match skills using semantic understanding
-     * Falls back to keyword matching if API is not configured
-     */
-    match(skills: Skill[], context: SemanticMatchContext): Promise<SemanticMatchResult | null>;
-    /**
-     * Use Claude API to understand intent and match skills
-     */
-    private matchWithAI;
-    /**
-     * Build the matching prompt for Claude API
-     */
-    private buildMatchingPrompt;
-    /**
-     * Parse AI response into match result
-     */
-    private parseAIResponse;
-    /**
-     * Extract description from skill content
-     * Prioritizes frontmatter description over content extraction
-     */
-    private extractDescription;
-    /**
-     * Cache management
-     */
-    private getCacheKey;
-    private getFromCache;
-    private setCache;
-    /**
-     * Clear cache
-     */
-    clearCache(): void;
-}
-//# sourceMappingURL=semantic-matcher.d.ts.map

package/dist/skills/semantic-matcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"semantic-matcher.d.ts","sourceRoot":"","sources":["../../src/skills/semantic-matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAK3C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,KAAK,CAC0C;gBAE3C,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAO7D;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAwBhG;;OAEG;YACW,WAAW;IAkCzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/skills/semantic-matcher.js

@@ -1,192 +0,0 @@
-/**
- * AI-powered semantic skill matcher using Claude API
- * Provides more accurate skill recommendations by understanding user intent
- */
-import Anthropic from '@anthropic-ai/sdk';
-import { logger } from '../core/utils/logger.js';
-import { DEFAULTS } from '../core/constants.js';
-import { LRUCache } from '../core/utils/lru-cache.js';
-/**
- * Semantic matcher using Claude API for intent understanding
- */
-export class SemanticSkillMatcher {
-    client = null;
-    model;
-    static CACHE_MAX_ENTRIES = 200;
-    CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-    cache = new LRUCache(SemanticSkillMatcher.CACHE_MAX_ENTRIES);
-    constructor(apiKey, model, baseURL) {
-        this.model = model || DEFAULTS.AI_MODEL;
-        if (apiKey) {
-            this.client = new Anthropic({ apiKey, baseURL });
-        }
-    }
-    /**
-     * Match skills using semantic understanding
-     * Falls back to keyword matching if API is not configured
-     */
-    async match(skills, context) {
-        // Check cache first
-        const cacheKey = this.getCacheKey(context);
-        const cached = this.getFromCache(cacheKey);
-        if (cached !== undefined) {
-            return cached;
-        }
-        // If no API key, return null (caller will fall back to keyword matching)
-        if (!this.client) {
-            logger.debug('[SemanticMatcher] No API key configured, skipping semantic matching');
-            return null;
-        }
-        try {
-            const result = await this.matchWithAI(skills, context);
-            this.setCache(cacheKey, result);
-            return result;
-        }
-        catch (err) {
-            logger.warn(`[SemanticMatcher] AI matching failed: ${err}`);
-            return null; // Fall back to keyword matching
-        }
-    }
-    /**
-     * Use Claude API to understand intent and match skills
-     */
-    async matchWithAI(skills, context) {
-        if (!this.client)
-            return null;
-        // Build skill descriptions for the prompt
-        const skillDescriptions = skills
-            .filter(s => s.isOfficial) // Only consider official skills for AI matching
-            .map((s, idx) => `${idx + 1}. **${s.id}**: ${s.name} - ${this.extractDescription(s)}`)
-            .join('\n');
-        const prompt = this.buildMatchingPrompt(context, skillDescriptions);
-        const response = await this.client.messages.create({
-            model: this.model,
-            max_tokens: 500,
-            temperature: 0,
-            messages: [
-                {
-                    role: 'user',
-                    content: prompt,
-                },
-            ],
-        });
-        const content = response.content[0];
-        if (content.type !== 'text') {
-            return null;
-        }
-        return this.parseAIResponse(content.text, skills);
-    }
-    /**
-     * Build the matching prompt for Claude API
-     */
-    buildMatchingPrompt(context, skillDescriptions) {
-        return `You are a skill recommendation system. Analyze the user's request and recommend the most relevant skill.
-
-User Request: "${context.prompt}"
-
-${context.intentKeywords && context.intentKeywords.length > 0 ? `Intent Keywords: ${context.intentKeywords.join(', ')}` : ''}
-
-Available Skills:
-${skillDescriptions}
-
-Instructions:
-1. Understand the user's intent and task type
-2. Match to the MOST relevant skill (only ONE skill)
-3. If no skill is clearly relevant (confidence < 60%), respond with "NONE"
-4. Respond in this exact format:
-
-SKILL_ID: <skill-id or NONE>
-CONFIDENCE: <0-100>
-REASONING: <one sentence explaining why this skill matches or why no skill matches>
-
-Example responses:
-- SKILL_ID: official-tdd
-  CONFIDENCE: 85
-  REASONING: User wants to write tests before implementation, which is the core of TDD.
-
-- SKILL_ID: NONE
-  CONFIDENCE: 30
-  REASONING: Request is about simple documentation update, no specialized skill needed.`;
-    }
-    /**
-     * Parse AI response into match result
-     */
-    parseAIResponse(response, skills) {
-        const lines = response.trim().split('\n');
-        let skillId = null;
-        let confidence = 0;
-        let reasoning = '';
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (trimmed.startsWith('SKILL_ID:')) {
-                skillId = trimmed.substring('SKILL_ID:'.length).trim();
-            }
-            else if (trimmed.startsWith('CONFIDENCE:')) {
-                confidence = parseInt(trimmed.substring('CONFIDENCE:'.length).trim(), 10);
-            }
-            else if (trimmed.startsWith('REASONING:')) {
-                reasoning = trimmed.substring('REASONING:'.length).trim();
-            }
-        }
-        // If AI says NONE or confidence too low, return null
-        if (!skillId || skillId === 'NONE' || confidence < 60) {
-            logger.debug(`[SemanticMatcher] No match: ${reasoning}`);
-            return null;
-        }
-        // Find the matched skill
-        const skill = skills.find(s => s.id === skillId);
-        if (!skill) {
-            logger.warn(`[SemanticMatcher] AI returned unknown skill: ${skillId}`);
-            return null;
-        }
-        logger.info(`[SemanticMatcher] Matched ${skillId} with ${confidence}% confidence`);
-        return { skill, confidence, reasoning };
-    }
-    /**
-     * Extract description from skill content
-     * Prioritizes frontmatter description over content extraction
-     */
-    extractDescription(skill) {
-        // Prefer frontmatter description if available (agent-skills format)
-        if (skill.description) {
-            return skill.description;
-        }
-        // Fallback: Try to extract first line of description from content
-        const lines = skill.content.split('\n');
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('---')) {
-                return trimmed.substring(0, 100);
-            }
-        }
-        return skill.keywords.join(', ');
-    }
-    /**
-     * Cache management
-     */
-    getCacheKey(context) {
-        const prompt = context.prompt.toLowerCase().substring(0, 200);
-        const intent = context.intentKeywords ? [...context.intentKeywords].sort().join(',') : '';
-        return `${prompt}|${intent}`;
-    }
-    getFromCache(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        if (Date.now() - entry.timestamp > this.CACHE_TTL) {
-            this.cache.delete(key);
-            return undefined;
-        }
-        return entry.result;
-    }
-    setCache(key, result) {
-        this.cache.set(key, { result, timestamp: Date.now() });
-    }
-    /**
-     * Clear cache
-     */
-    clearCache() {
-        this.cache.clear();
-    }
-}
-//# sourceMappingURL=semantic-matcher.js.map

package/dist/skills/semantic-matcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"semantic-matcher.js","sourceRoot":"","sources":["../../src/skills/semantic-matcher.ts"],"names":[],"mappings":"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"}