specweave 0.12.7 → 0.13.0

package/dist/src/utils/generate-skills-index.js

@@ -0,0 +1,410 @@
+/**
+ * Skills Index Generator
+ *
+ * Generates SKILLS-INDEX.md from all SKILL.md files
+ * Simulates Claude Code's progressive disclosure for non-native tools
+ *
+ * This allows GitHub Copilot, Cursor, and other AI tools to:
+ * 1. Quickly scan all available skills (single file read)
+ * 2. Match user requests to activation keywords
+ * 3. Load full SKILL.md only when relevant
+ * 4. Follow skill workflows for consistent output
+ *
+ * Usage:
+ *   import { generateSkillsIndex } from './generate-skills-index';
+ *   await generateSkillsIndex();
+ *
+ * Or run directly:
+ *   npx ts-node src/utils/generate-skills-index.ts
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Skill categories for organization
+ */
+const SkillCategory = {
+    FRAMEWORK: 'Framework Core',
+    INTEGRATIONS: 'External Integrations',
+    ARCHITECTURE: 'Architecture & Design',
+    DEVELOPMENT: 'Development',
+    QUALITY: 'Quality & Testing',
+    INFRASTRUCTURE: 'Infrastructure',
+    DOCUMENTATION: 'Documentation',
+    ORCHESTRATION: 'Orchestration & Planning',
+    OTHER: 'Other',
+};
+/**
+ * Parse YAML frontmatter from SKILL.md
+ */
+function parseSkillMetadata(content, filePath) {
+    try {
+        // Extract YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            console.warn(`⚠️  No frontmatter found in: ${filePath}`);
+            return null;
+        }
+        let frontmatter;
+        try {
+            frontmatter = yaml.load(frontmatterMatch[1]);
+        }
+        catch (yamlError) {
+            // If YAML parsing fails, try manual parsing for simple key-value pairs
+            // This handles cases where descriptions have unquoted colons
+            frontmatter = {};
+            const lines = frontmatterMatch[1].split('\n');
+            for (const line of lines) {
+                const colonIndex = line.indexOf(':');
+                if (colonIndex > 0) {
+                    const key = line.substring(0, colonIndex).trim();
+                    const value = line.substring(colonIndex + 1).trim();
+                    frontmatter[key] = value;
+                }
+            }
+        }
+        if (!frontmatter.name || !frontmatter.description) {
+            console.warn(`⚠️  Missing name or description in: ${filePath}`);
+            return null;
+        }
+        // Extract activation keywords from description
+        // Look for "Activates for:" or "Activates when user mentions:" in description
+        const activationKeywords = [];
+        const activatesMatch = frontmatter.description.match(/Activates (?:for|when user mentions):\s*(.+?)(?:\.|$)/i);
+        if (activatesMatch) {
+            // Split by comma and clean up
+            const keywords = activatesMatch[1]
+                .split(',')
+                .map((k) => k.trim())
+                .filter((k) => k.length > 0);
+            activationKeywords.push(...keywords);
+        }
+        // Determine category from skill name
+        const category = categorizeSkill(frontmatter.name, frontmatter.description);
+        // Relative path from .claude/skills/
+        const skillDir = path.basename(path.dirname(filePath));
+        const location = `.claude/skills/${skillDir}/SKILL.md`;
+        return {
+            name: frontmatter.name,
+            description: frontmatter.description,
+            activationKeywords,
+            location,
+            allowedTools: frontmatter['allowed-tools'],
+            category,
+        };
+    }
+    catch (error) {
+        console.error(`❌ Error parsing ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Categorize skill based on name and description
+ */
+function categorizeSkill(name, description) {
+    const nameLower = name.toLowerCase();
+    const descLower = description.toLowerCase();
+    // Framework core
+    if (nameLower.includes('increment') ||
+        nameLower.includes('context') ||
+        nameLower.includes('specweave') ||
+        nameLower.includes('skill-creator')) {
+        return SkillCategory.FRAMEWORK;
+    }
+    // Integrations
+    if (nameLower.includes('jira') ||
+        nameLower.includes('ado') ||
+        nameLower.includes('github') ||
+        nameLower.includes('sync') ||
+        nameLower.includes('figma-mcp')) {
+        return SkillCategory.INTEGRATIONS;
+    }
+    // Architecture & Design
+    if (nameLower.includes('diagram') ||
+        nameLower.includes('architect') ||
+        nameLower.includes('design-system') ||
+        descLower.includes('architecture') ||
+        descLower.includes('c4 model')) {
+        return SkillCategory.ARCHITECTURE;
+    }
+    // Development
+    if (nameLower.includes('frontend') ||
+        nameLower.includes('backend') ||
+        nameLower.includes('nodejs') ||
+        nameLower.includes('python') ||
+        nameLower.includes('dotnet') ||
+        nameLower.includes('nextjs') ||
+        nameLower.includes('figma-implementer') ||
+        nameLower.includes('figma-to-code')) {
+        return SkillCategory.DEVELOPMENT;
+    }
+    // Quality & Testing
+    if (nameLower.includes('quality') ||
+        nameLower.includes('test') ||
+        nameLower.includes('e2e') ||
+        nameLower.includes('playwright') ||
+        descLower.includes('testing') ||
+        descLower.includes('validation')) {
+        return SkillCategory.QUALITY;
+    }
+    // Infrastructure
+    if (nameLower.includes('hetzner') ||
+        nameLower.includes('provision') ||
+        nameLower.includes('cost-optimizer') ||
+        descLower.includes('infrastructure') ||
+        descLower.includes('deployment') ||
+        descLower.includes('hosting')) {
+        return SkillCategory.INFRASTRUCTURE;
+    }
+    // Documentation
+    if (nameLower.includes('docusaurus') ||
+        nameLower.includes('docs') ||
+        nameLower.includes('figma-designer') ||
+        descLower.includes('documentation') ||
+        descLower.includes('generating documentation')) {
+        return SkillCategory.DOCUMENTATION;
+    }
+    // Orchestration
+    if (nameLower.includes('orchestrat') ||
+        nameLower.includes('role-orchestrator') ||
+        nameLower.includes('skill-router') ||
+        nameLower.includes('brainstorm') ||
+        descLower.includes('multi-agent') ||
+        descLower.includes('coordinates') ||
+        descLower.includes('routing')) {
+        return SkillCategory.ORCHESTRATION;
+    }
+    return SkillCategory.OTHER;
+}
+/**
+ * Generate markdown for skills index
+ */
+function generateIndexMarkdown(skills) {
+    const now = new Date().toISOString();
+    const totalSkills = skills.length;
+    // Group skills by category
+    const categorized = new Map();
+    for (const skill of skills) {
+        const category = skill.category;
+        if (!categorized.has(category)) {
+            categorized.set(category, []);
+        }
+        categorized.get(category).push(skill);
+    }
+    // Sort skills within each category alphabetically
+    for (const skillList of categorized.values()) {
+        skillList.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    let markdown = `# SpecWeave Skills Index
+
+**Purpose**: Quick reference for all available skills. Read this file BEFORE starting any task.
+
+**Last Updated**: ${now} (auto-generated, do not edit manually)
+
+**Total Skills**: ${totalSkills}
+
+---
+
+## 🚀 Quick Start (Progressive Disclosure)
+
+**MANDATORY**: Skills are your expert manuals. Always check for relevant skills BEFORE starting implementation.
+
+### Progressive Disclosure Pattern
+
+1. **Scan this index** to find skills matching your task
+2. **Match activation keywords** to your current request
+3. **Load full SKILL.md** for matching skills
+4. **Follow the workflow** in SKILL.md precisely
+
+### Example Workflow
+
+\`\`\`
+User asks: "Plan a new feature for user authentication"
+
+Step 1: Scan this index → Find "increment-planner" skill
+Step 2: Check keywords → Matches "feature planning", "create increment"
+Step 3: Load skill → cat .claude/skills/increment-planner/SKILL.md
+Step 4: Execute → Follow the increment planning workflow
+\`\`\`
+
+---
+
+## 📚 All Available Skills
+
+`;
+    // Define category order
+    const categoryOrder = [
+        SkillCategory.FRAMEWORK,
+        SkillCategory.ORCHESTRATION,
+        SkillCategory.INTEGRATIONS,
+        SkillCategory.ARCHITECTURE,
+        SkillCategory.DEVELOPMENT,
+        SkillCategory.QUALITY,
+        SkillCategory.INFRASTRUCTURE,
+        SkillCategory.DOCUMENTATION,
+        SkillCategory.OTHER,
+    ];
+    // Generate sections by category
+    for (const category of categoryOrder) {
+        const skillList = categorized.get(category);
+        if (!skillList || skillList.length === 0)
+            continue;
+        markdown += `\n### ${category}\n\n`;
+        for (const skill of skillList) {
+            markdown += `#### ${skill.name}\n\n`;
+            markdown += `**Description**: ${skill.description}\n\n`;
+            if (skill.activationKeywords.length > 0) {
+                markdown += `**Activates for**: ${skill.activationKeywords.join(', ')}\n\n`;
+            }
+            markdown += `**Location**: \`${skill.location}\`\n\n`;
+            if (skill.allowedTools && Array.isArray(skill.allowedTools)) {
+                markdown += `**Allowed tools**: ${skill.allowedTools.join(', ')}\n\n`;
+            }
+            else if (skill.allowedTools && typeof skill.allowedTools === 'string') {
+                markdown += `**Allowed tools**: ${skill.allowedTools}\n\n`;
+            }
+            markdown += '---\n\n';
+        }
+    }
+    // Add usage guide
+    markdown += `
+## 💡 How Skills Work
+
+**Level 1 - Discovery (this file)**:
+- Scan activation keywords
+- Match to your current task
+- Identify 1-3 relevant skills
+
+**Level 2 - Deep Dive (SKILL.md)**:
+- Load full skill documentation
+- Read required prerequisites
+- Follow step-by-step workflow
+
+**Level 3 - Execution**:
+- Apply skill's instructions
+- Use recommended tools
+- Follow SpecWeave best practices
+
+---
+
+## 🎯 Task → Skill Matching Guide
+
+| Your Task | Relevant Skill | Keywords |
+|-----------|---------------|----------|
+| "Plan a new feature" | \`increment-planner\` | "feature planning", "create increment" |
+| "Sync to JIRA" | \`jira-sync\` | "JIRA sync", "create JIRA issue" |
+| "Create diagram" | \`diagrams-architect\` | "architecture diagram", "C4 diagram" |
+| "Build React UI" | \`frontend\` | "React", "components", "UI" |
+| "Deploy to cloud" | \`hetzner-provisioner\` | "deploy", "infrastructure" |
+| "Quality check" | \`increment-quality-judge\` | "quality check", "assess spec" |
+| "E2E testing" | \`e2e-playwright\` | "E2E test", "browser test" |
+| "Generate docs site" | \`docusaurus\` | "documentation site", "docs" |
+
+---
+
+## ⚡ Why Skills Matter
+
+**Without skills**:
+- ❌ Reinvent workflows every session
+- ❌ Inconsistent increment structure
+- ❌ Miss SpecWeave conventions
+- ❌ Waste tokens on irrelevant docs
+
+**With skills**:
+- ✅ Proven workflows ready to use
+- ✅ Consistent high-quality output
+- ✅ SpecWeave best practices enforced
+- ✅ Efficient token usage (load only what's needed)
+
+---
+
+## 🔧 For AI Tool Developers
+
+This index simulates Claude Code's native progressive disclosure:
+- Claude pre-loads skill metadata at startup (name + description)
+- Other tools read this index file for same benefit
+- Single file read replaces ${totalSkills} individual file scans
+- Token savings: ~97% (1 file vs ${totalSkills} files)
+
+**How to use in your AI tool**:
+1. Load this file at session start
+2. Parse activation keywords
+3. Match user requests to keywords
+4. Load full SKILL.md when matched
+5. Execute skill workflow
+
+---
+
+**Generated by**: \`src/utils/generate-skills-index.ts\`
+
+**Regenerate with**: \`npm run generate-skills-index\`
+`;
+    return markdown;
+}
+/**
+ * Main function: Generate skills index
+ */
+export async function generateSkillsIndex(outputPath) {
+    console.log('🔍 Scanning skills...');
+    // Determine skills directory (root-level after v0.5.0 Claude native architecture)
+    const skillsDir = path.join(__dirname, '../../skills');
+    if (!fs.existsSync(skillsDir)) {
+        throw new Error(`Skills directory not found: ${skillsDir}`);
+    }
+    // Scan all SKILL.md files
+    const skills = [];
+    const skillDirs = fs.readdirSync(skillsDir).filter(name => {
+        const fullPath = path.join(skillsDir, name);
+        return fs.statSync(fullPath).isDirectory();
+    });
+    for (const skillDir of skillDirs) {
+        const skillPath = path.join(skillsDir, skillDir, 'SKILL.md');
+        if (fs.existsSync(skillPath)) {
+            const content = fs.readFileSync(skillPath, 'utf-8');
+            const metadata = parseSkillMetadata(content, skillPath);
+            if (metadata) {
+                skills.push(metadata);
+            }
+        }
+    }
+    console.log(`✅ Found ${skills.length} skills`);
+    // Generate markdown
+    const markdown = generateIndexMarkdown(skills);
+    // Determine output path (root-level after v0.5.0 Claude native architecture)
+    const defaultOutputPath = path.join(__dirname, '../../skills/SKILLS-INDEX.md');
+    const finalOutputPath = outputPath || defaultOutputPath;
+    // Write to file
+    fs.writeFileSync(finalOutputPath, markdown, 'utf-8');
+    console.log(`✅ Generated skills index: ${finalOutputPath}`);
+    console.log('');
+    console.log('📊 Summary:');
+    console.log(`   Total skills: ${skills.length}`);
+    // Count by category
+    const categoryCounts = new Map();
+    for (const skill of skills) {
+        categoryCounts.set(skill.category, (categoryCounts.get(skill.category) || 0) + 1);
+    }
+    for (const [category, count] of Array.from(categoryCounts.entries()).sort((a, b) => b[1] - a[1])) {
+        console.log(`   ${category}: ${count}`);
+    }
+}
+/**
+ * CLI entry point (check if this file is being run directly)
+ */
+if (import.meta.url === `file://${process.argv[1]}`) {
+    generateSkillsIndex()
+        .then(() => {
+        console.log('');
+        console.log('✅ Skills index generation complete!');
+        process.exit(0);
+    })
+        .catch((error) => {
+        console.error('❌ Error generating skills index:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=generate-skills-index.js.map

package/dist/src/utils/generate-skills-index.js.map

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

package/dist/src/utils/model-selection.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Model Selection Utilities
+ *
+ * Intelligent model selection for SpecWeave tasks based on complexity,
+ * instruction detail, and task characteristics.
+ *
+ * Strategy:
+ * - Haiku: Detailed instructions, clear acceptance criteria, mechanical work
+ * - Sonnet: Complex decisions, architecture, creative problem-solving
+ * - Opus: Critical architecture, high-stakes decisions (rare)
+ */
+export type ModelTier = 'haiku' | 'sonnet' | 'opus';
+export interface Task {
+    id: string;
+    content: string;
+    description?: string;
+    acceptanceCriteria?: string[];
+    specReference?: string;
+    planReference?: string;
+    priority?: 'P1' | 'P2' | 'P3';
+    estimatedHours?: number;
+}
+export interface DetectionResult {
+    model: ModelTier;
+    confidence: number;
+    reasoning: string;
+}
+/**
+ * Detects the optimal model for a given task
+ *
+ * @param task - The task to analyze
+ * @param options - Additional context (spec detail level, etc.)
+ * @returns Detection result with model recommendation and reasoning
+ */
+export declare function detectModelForTask(task: Task, options?: {
+    specDetailLevel?: number;
+    hasDetailedPlan?: boolean;
+    isArchitectural?: boolean;
+}): DetectionResult;
+/**
+ * Batch detect models for multiple tasks
+ * Useful when generating tasks.md from plan.md
+ */
+export declare function detectModelsForTasks(tasks: Task[], options?: {
+    specDetailLevel?: number;
+    hasDetailedPlan?: boolean;
+}): Map<string, DetectionResult>;
+/**
+ * Format model hint for tasks.md
+ *
+ * @param model - The model tier
+ * @returns Formatted string for inclusion in tasks.md
+ */
+export declare function formatModelHint(model: ModelTier): string;
+/**
+ * Parse model hint from tasks.md line
+ *
+ * @param line - A line from tasks.md
+ * @returns Detected model or null
+ */
+export declare function parseModelHint(line: string): ModelTier | null;
+/**
+ * Cost estimation utilities
+ */
+export declare function estimateTaskCost(model: ModelTier, estimatedTokens?: number): number;
+/**
+ * Calculate total cost savings when using smart model selection
+ */
+export declare function calculateCostSavings(tasksWithModels: Map<string, ModelTier>, averageTokensPerTask?: number): {
+    optimizedCost: number;
+    allSonnetCost: number;
+    savings: number;
+    savingsPercent: number;
+};
+//# sourceMappingURL=model-selection.d.ts.map

package/dist/src/utils/model-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../../src/utils/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4BD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,eAAe,CAkGjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAS9B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAQxD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAU7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,eAAe,GAAE,MAAa,GAC7B,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACvC,oBAAoB,GAAE,MAAa,GAClC;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB,CAkBA"}