specweave 0.1.9 → 0.3.1

package/dist/adapters/adapter-base.js

@@ -1,48 +1,15 @@
-"use strict";
 /**
  * Base Adapter Class
  *
  * Provides common functionality for all adapters.
  * Concrete adapters extend this class and implement tool-specific logic.
  */
-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.AdapterBase = void 0;
-const fs = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-class AdapterBase {
+import fs from 'fs-extra';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import { getDirname } from '../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+export class AdapterBase {
     /**
      * Default detection - override in concrete adapters
      */
@@ -68,7 +35,6 @@ class AdapterBase {
         }
         // Check Git
         try {
-            const { execSync } = require('child_process');
             execSync('git --version', { stdio: 'ignore' });
         }
         catch (error) {
@@ -142,5 +108,4 @@ class AdapterBase {
         return content;
     }
 }
-exports.AdapterBase = AdapterBase;
 //# sourceMappingURL=adapter-base.js.map

package/dist/adapters/adapter-base.js.map

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

package/dist/adapters/adapter-interface.js

@@ -1,9 +1,8 @@
-"use strict";
 /**
  * Adapter Interface for Multi-Tool Support
  *
  * Defines the contract that all SpecWeave adapters must implement.
  * Enables SpecWeave to work with ANY AI coding tool (Claude, Cursor, Copilot, etc.)
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=adapter-interface.js.map

package/dist/adapters/adapter-interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-interface.js","sourceRoot":"","sources":["../../src/adapters/adapter-interface.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}
+{"version":3,"file":"adapter-interface.js","sourceRoot":"","sources":["../../src/adapters/adapter-interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/adapters/adapter-loader.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Adapter Loader
+ *
+ * Loads adapters from registry, detects tools, and provides API for init command.
+ * Enables SpecWeave to work with ANY AI coding tool.
+ */
+import { IAdapter } from './adapter-interface.js';
+export interface AdapterRegistry {
+    version: number;
+    last_updated: string;
+    adapters: Array<{
+        name: string;
+        description: string;
+        automation_level: string;
+        status: string;
+        directory: string;
+        market_share: string;
+        priority: string;
+    }>;
+}
+/**
+ * Adapter Loader - Main API for working with adapters
+ */
+export declare class AdapterLoader {
+    private adapters;
+    private registry;
+    constructor();
+    /**
+     * Initialize all adapters
+     *
+     * NOTE: Claude Code is NOT an adapter - it's the native/default experience!
+     * Adapters only exist for tools that need to APPROXIMATE Claude's native capabilities.
+     */
+    private initializeAdapters;
+    /**
+     * Load registry.yaml
+     */
+    loadRegistry(): Promise<AdapterRegistry>;
+    /**
+     * Get all available adapters
+     */
+    getAllAdapters(): IAdapter[];
+    /**
+     * Get adapter by name
+     */
+    getAdapter(name: string): IAdapter | undefined;
+    /**
+     * Auto-detect which tool is being used
+     *
+     * Detection priority (based on market share and probability):
+     * 1. Claude Code (if .claude/ exists or claude CLI found) - NATIVE, no adapter needed
+     * 2. Cursor (if cursor CLI or .cursor/ or .cursorrules exists)
+     * 3. Gemini CLI (if gemini CLI found)
+     * 4. Codex (if codex CLI found)
+     * 5. Copilot (if .github/copilot/ exists)
+     * 6. Generic (fallback - always returns true)
+     *
+     * @returns Promise<string> Detected tool name (not adapter - Claude has no adapter!)
+     */
+    detectTool(): Promise<string>;
+    /**
+     * Helper: Check if a command exists in PATH
+     */
+    private commandExists;
+    /**
+     * Helper: Check if a file exists
+     */
+    private fileExists;
+    /**
+     * Check requirements for a specific adapter
+     */
+    checkRequirements(adapterName: string): Promise<void>;
+    /**
+     * List all available adapters with details
+     */
+    listAdapters(): Promise<void>;
+    /**
+     * Get icon for automation level
+     */
+    private getAutomationIcon;
+    /**
+     * Get recommended adapter based on detection and user preference
+     */
+    getRecommendedAdapter(explicitChoice?: string): Promise<IAdapter>;
+}
+//# sourceMappingURL=adapter-loader.d.ts.map

package/dist/adapters/adapter-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-loader.d.ts","sourceRoot":"","sources":["../../src/adapters/adapter-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAUlD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,QAAQ,CAAgC;;IAMhD;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAiB9C;;OAEG;IACH,cAAc,IAAI,QAAQ,EAAE;IAI5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI9C;;;;;;;;;;;;OAYG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BnC;;OAEG;YACW,aAAa;IAS3B;;OAEG;YACW,UAAU;IASxB;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3D;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCnC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACG,qBAAqB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAoBxE"}

package/dist/adapters/adapter-loader.js

@@ -0,0 +1,216 @@
+/**
+ * Adapter Loader
+ *
+ * Loads adapters from registry, detects tools, and provides API for init command.
+ * Enables SpecWeave to work with ANY AI coding tool.
+ */
+import fs from 'fs-extra';
+import * as path from 'path';
+import * as YAML from 'yaml';
+import { execSync } from 'child_process';
+import { CursorAdapter } from './cursor/adapter.js';
+import { CopilotAdapter } from './copilot/adapter.js';
+import { GeminiAdapter } from './gemini/adapter.js';
+import { CodexAdapter } from './codex/adapter.js';
+import { GenericAdapter } from './generic/adapter.js';
+import { getDirname } from '../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+/**
+ * Adapter Loader - Main API for working with adapters
+ */
+export class AdapterLoader {
+    constructor() {
+        this.adapters = new Map();
+        this.registry = null;
+        this.initializeAdapters();
+    }
+    /**
+     * Initialize all adapters
+     *
+     * NOTE: Claude Code is NOT an adapter - it's the native/default experience!
+     * Adapters only exist for tools that need to APPROXIMATE Claude's native capabilities.
+     */
+    initializeAdapters() {
+        // Note: No ClaudeAdapter - Claude is the baseline, not an adaptation!
+        this.adapters.set('cursor', new CursorAdapter());
+        this.adapters.set('copilot', new CopilotAdapter());
+        this.adapters.set('gemini', new GeminiAdapter());
+        this.adapters.set('codex', new CodexAdapter());
+        this.adapters.set('generic', new GenericAdapter());
+    }
+    /**
+     * Load registry.yaml
+     */
+    async loadRegistry() {
+        if (this.registry) {
+            return this.registry;
+        }
+        // Try dist first, then fall back to src (for development)
+        let registryPath = path.join(__dirname, 'registry.yaml');
+        if (!await fs.pathExists(registryPath)) {
+            registryPath = path.join(__dirname, '../../src/adapters/registry.yaml');
+        }
+        const content = await fs.readFile(registryPath, 'utf-8');
+        this.registry = YAML.parse(content);
+        return this.registry;
+    }
+    /**
+     * Get all available adapters
+     */
+    getAllAdapters() {
+        return Array.from(this.adapters.values());
+    }
+    /**
+     * Get adapter by name
+     */
+    getAdapter(name) {
+        return this.adapters.get(name);
+    }
+    /**
+     * Auto-detect which tool is being used
+     *
+     * Detection priority (based on market share and probability):
+     * 1. Claude Code (if .claude/ exists or claude CLI found) - NATIVE, no adapter needed
+     * 2. Cursor (if cursor CLI or .cursor/ or .cursorrules exists)
+     * 3. Gemini CLI (if gemini CLI found)
+     * 4. Codex (if codex CLI found)
+     * 5. Copilot (if .github/copilot/ exists)
+     * 6. Generic (fallback - always returns true)
+     *
+     * @returns Promise<string> Detected tool name (not adapter - Claude has no adapter!)
+     */
+    async detectTool() {
+        console.log('🔍 Detecting AI coding tool...\n');
+        // Check for Claude first (native, no adapter)
+        if (await this.commandExists('claude') || await this.fileExists('.claude')) {
+            console.log(`✅ Detected: Claude Code (native - full automation)`);
+            return 'claude';
+        }
+        // Check other tools (need adapters)
+        const detectionOrder = ['cursor', 'gemini', 'codex', 'copilot', 'generic'];
+        for (const adapterName of detectionOrder) {
+            const adapter = this.adapters.get(adapterName);
+            if (!adapter)
+                continue;
+            const detected = await adapter.detect();
+            if (detected) {
+                console.log(`✅ Detected: ${adapter.name} (${adapter.automationLevel} automation)`);
+                return adapterName;
+            }
+        }
+        // Fallback to generic (should never reach here since generic always returns true)
+        console.log('ℹ️  Using generic adapter (manual workflow)');
+        return 'generic';
+    }
+    /**
+     * Helper: Check if a command exists in PATH
+     */
+    async commandExists(command) {
+        try {
+            execSync(`which ${command}`, { stdio: 'ignore' });
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Helper: Check if a file exists
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Check requirements for a specific adapter
+     */
+    async checkRequirements(adapterName) {
+        const adapter = this.adapters.get(adapterName);
+        if (!adapter) {
+            throw new Error(`Adapter not found: ${adapterName}`);
+        }
+        const result = await adapter.checkRequirements();
+        if (!result.met) {
+            console.error('\n❌ Requirements not met:\n');
+            result.missing.forEach(req => console.error(`  - ${req}`));
+            throw new Error('System requirements not met');
+        }
+        if (result.warnings.length > 0) {
+            console.warn('\n⚠️  Warnings:\n');
+            result.warnings.forEach(warning => console.warn(`  - ${warning}`));
+        }
+    }
+    /**
+     * List all available adapters with details
+     */
+    async listAdapters() {
+        const registry = await this.loadRegistry();
+        console.log('\n📋 SpecWeave Tool Support:\n');
+        console.log('━'.repeat(70));
+        console.log('');
+        // Show Claude first (baseline, not an adapter)
+        const claudeInfo = registry.adapters.find(a => a.name === 'claude');
+        if (claudeInfo) {
+            console.log(`🚀 CLAUDE CODE (Baseline - No Adapter Needed)`);
+            console.log(`   ${claudeInfo.description}`);
+            console.log(`   Native: skills, agents, hooks, slash commands | Market: ${claudeInfo.market_share}`);
+            console.log('');
+        }
+        console.log('📦 Adapters (For Other Tools):\n');
+        // Show other adapters
+        for (const adapterInfo of registry.adapters) {
+            if (adapterInfo.name === 'claude')
+                continue; // Skip Claude, already shown
+            const adapter = this.adapters.get(adapterInfo.name);
+            if (!adapter)
+                continue;
+            console.log(`${this.getAutomationIcon(adapter.automationLevel)} ${adapter.name.toUpperCase()}`);
+            console.log(`   ${adapter.description}`);
+            console.log(`   Automation: ${adapter.automationLevel} | Market: ${adapterInfo.market_share}`);
+            console.log('');
+        }
+        console.log('━'.repeat(70));
+        console.log('\nTotal Market Coverage: 100%');
+        console.log('SpecWeave works with ANY AI coding tool!');
+        console.log('\n💡 Claude Code = Native experience (no adapter)');
+        console.log('   Other tools = Adapters approximate Claude\'s capabilities\n');
+    }
+    /**
+     * Get icon for automation level
+     */
+    getAutomationIcon(level) {
+        switch (level) {
+            case 'full': return '🚀';
+            case 'semi': return '⚡';
+            case 'basic': return '📝';
+            case 'manual': return '📖';
+            default: return '❓';
+        }
+    }
+    /**
+     * Get recommended adapter based on detection and user preference
+     */
+    async getRecommendedAdapter(explicitChoice) {
+        // If user explicitly chose an adapter, use it
+        if (explicitChoice) {
+            const adapter = this.adapters.get(explicitChoice);
+            if (!adapter) {
+                throw new Error(`Invalid adapter: ${explicitChoice}. Use 'claude', 'cursor', 'copilot', or 'generic'`);
+            }
+            return adapter;
+        }
+        // Otherwise, auto-detect
+        const detectedName = await this.detectTool();
+        const adapter = this.adapters.get(detectedName);
+        if (!adapter) {
+            throw new Error(`Detected adapter not found: ${detectedName}`);
+        }
+        return adapter;
+    }
+}
+//# sourceMappingURL=adapter-loader.js.map

package/dist/adapters/adapter-loader.js.map

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

package/dist/adapters/agents-md-generator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * AGENTS.md Generator
+ *
+ * Generates a universal AGENTS.md file for ALL AI coding tools EXCEPT Claude Code.
+ * Follows the agents.md standard: https://agents.md/
+ *
+ * IMPORTANT:
+ * - Claude Code does NOT read this file - it only reads CLAUDE.md
+ * - This file is for: Cursor, Gemini CLI, Codex, GitHub Copilot, and ANY other AI tool
+ *
+ * This ONE file replaces:
+ * - .cursorrules (Cursor)
+ * - .github/copilot/instructions.md (Copilot)
+ * - Any other tool-specific configuration files
+ */
+export interface AgentsMdOptions {
+    projectName: string;
+    projectPath: string;
+    templatePath?: string;
+}
+/**
+ * Generate universal AGENTS.md file
+ */
+export declare class AgentsMdGenerator {
+    private docGen;
+    constructor(skillsDir?: string, agentsDir?: string, commandsDir?: string);
+    /**
+     * Generate complete AGENTS.md content
+     */
+    generate(options: AgentsMdOptions): Promise<string>;
+    /**
+     * Generate agents section as simple Markdown
+     */
+    private generateAgentsSection;
+    /**
+     * Get agent activation guidance
+     */
+    private getAgentActivation;
+    /**
+     * Generate skills section as simple Markdown
+     */
+    private generateSkillsSection;
+    /**
+     * Get skill activation guidance
+     */
+    private getSkillActivation;
+}
+//# sourceMappingURL=agents-md-generator.d.ts.map

package/dist/adapters/agents-md-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md-generator.d.ts","sourceRoot":"","sources":["../../src/adapters/agents-md-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAe;gBAG3B,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM;IAKtB;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBzD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgC3B"}

package/dist/adapters/agents-md-generator.js

@@ -0,0 +1,132 @@
+/**
+ * AGENTS.md Generator
+ *
+ * Generates a universal AGENTS.md file for ALL AI coding tools EXCEPT Claude Code.
+ * Follows the agents.md standard: https://agents.md/
+ *
+ * IMPORTANT:
+ * - Claude Code does NOT read this file - it only reads CLAUDE.md
+ * - This file is for: Cursor, Gemini CLI, Codex, GitHub Copilot, and ANY other AI tool
+ *
+ * This ONE file replaces:
+ * - .cursorrules (Cursor)
+ * - .github/copilot/instructions.md (Copilot)
+ * - Any other tool-specific configuration files
+ */
+import { DocGenerator } from './doc-generator.js';
+import * as path from 'path';
+import fs from 'fs-extra';
+import { getDirname } from '../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+/**
+ * Generate universal AGENTS.md file
+ */
+export class AgentsMdGenerator {
+    constructor(skillsDir, agentsDir, commandsDir) {
+        this.docGen = new DocGenerator(skillsDir, agentsDir, commandsDir);
+    }
+    /**
+     * Generate complete AGENTS.md content
+     */
+    async generate(options) {
+        // Read template
+        const templatePath = options.templatePath ||
+            path.join(__dirname, '../templates/AGENTS.md.template');
+        if (!await fs.pathExists(templatePath)) {
+            throw new Error(`AGENTS.md template not found at: ${templatePath}`);
+        }
+        let content = await fs.readFile(templatePath, 'utf-8');
+        // Extract agents and skills
+        const skills = await this.docGen.extractSkills();
+        const agents = await this.docGen.extractAgents();
+        // Replace placeholders
+        content = content.replace(/\{PROJECT_NAME\}/g, options.projectName);
+        content = content.replace('{AGENTS_SECTION}', this.generateAgentsSection(agents));
+        content = content.replace('{SKILLS_SECTION}', this.generateSkillsSection(skills));
+        content = content.replace('{TIMESTAMP}', new Date().toISOString().split('T')[0]);
+        return content;
+    }
+    /**
+     * Generate agents section as simple Markdown
+     */
+    generateAgentsSection(agents) {
+        let section = '';
+        for (const agent of agents) {
+            section += `### ${agent.role}\n`;
+            section += `**Purpose**: ${agent.description}\n`;
+            section += `**When to use**: ${this.getAgentActivation(agent.name)}\n`;
+            section += `**Location**: \`.claude/agents/${agent.name}/AGENT.md\`\n\n`;
+        }
+        return section;
+    }
+    /**
+     * Get agent activation guidance
+     */
+    getAgentActivation(agentName) {
+        const activations = {
+            'pm': 'Creating requirements, user stories, product specs (WHAT/WHY)',
+            'architect': 'System design, architecture decisions, technical plans (HOW)',
+            'devops': 'Infrastructure, deployment, CI/CD pipelines',
+            'qa-lead': 'Test strategy, test cases, quality assurance',
+            'security': 'Threat modeling, security review, vulnerability assessment',
+            'tech-lead': 'Code review, best practices, refactoring',
+            'frontend': 'UI components, React/Vue/Angular implementation',
+            'nodejs-backend': 'Node.js/Express/NestJS backend APIs',
+            'python-backend': 'FastAPI/Django backend APIs',
+            'nextjs': 'Next.js App Router applications',
+            'dotnet-backend': 'ASP.NET Core backend APIs',
+            'sre': 'Incident response, troubleshooting, runbooks',
+            'docs-writer': 'Technical documentation, API docs, guides',
+            'performance': 'Performance optimization, profiling, benchmarking'
+        };
+        return activations[agentName] || 'Specialized tasks requiring this expertise';
+    }
+    /**
+     * Generate skills section as simple Markdown
+     */
+    generateSkillsSection(skills) {
+        let section = '';
+        for (const skill of skills) {
+            section += `### ${skill.name}\n`;
+            section += `**Purpose**: ${skill.description}\n`;
+            section += `**When to use**: ${this.getSkillActivation(skill.name)}\n`;
+            section += `**Location**: \`.claude/skills/${skill.name}/SKILL.md\`\n\n`;
+        }
+        return section;
+    }
+    /**
+     * Get skill activation guidance
+     */
+    getSkillActivation(skillName) {
+        const activations = {
+            'specweave-detector': 'User asks about SpecWeave commands or workflows',
+            'increment-planner': 'Creating new feature increments (/inc command)',
+            'context-loader': 'Working on increments, need to load relevant context',
+            'skill-router': 'Ambiguous requests that need routing to specific skills',
+            'spec-driven-debugging': 'Bug investigation, test failures, unexpected behavior',
+            'spec-driven-brainstorming': 'Brainstorming ideas, refining concepts, design thinking',
+            'brownfield-analyzer': 'Analyzing existing projects for SpecWeave migration',
+            'brownfield-onboarder': 'Onboarding existing projects to SpecWeave',
+            'nodejs-backend': 'Node.js/Express/NestJS backend development',
+            'python-backend': 'Python/FastAPI/Django backend development',
+            'nextjs': 'Next.js App Router application development',
+            'frontend': 'React/Vue/Angular frontend development',
+            'dotnet-backend': 'ASP.NET Core backend development',
+            'e2e-playwright': 'End-to-end testing with Playwright',
+            'jira-sync': 'JIRA integration and synchronization',
+            'github-sync': 'GitHub issues/milestones synchronization',
+            'ado-sync': 'Azure DevOps synchronization',
+            'hetzner-provisioner': 'Hetzner Cloud infrastructure provisioning',
+            'cost-optimizer': 'Cloud cost optimization and platform comparison',
+            'figma-mcp-connector': 'Figma design integration via MCP',
+            'design-system-architect': 'Design system and Atomic Design methodology',
+            'figma-designer': 'Figma design creation and design tokens',
+            'figma-implementer': 'Converting Figma designs to code',
+            'figma-to-code': 'Figma to React/Angular code generation',
+            'role-orchestrator': 'Multi-agent orchestration for complex tasks',
+            'increment-quality-judge': 'AI-powered quality assessment of specs and plans'
+        };
+        return activations[skillName] || 'Specialized tasks';
+    }
+}
+//# sourceMappingURL=agents-md-generator.js.map

package/dist/adapters/agents-md-generator.js.map

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

package/dist/adapters/claude/adapter.d.ts

@@ -7,8 +7,8 @@
  * This is the BASELINE adapter - all other adapters try to approximate this experience
  * within their tool's capabilities.
  */
-import { AdapterBase } from '../adapter-base';
-import { AdapterOptions, AdapterFile } from '../adapter-interface';
+import { AdapterBase } from '../adapter-base.js';
+import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
 export declare class ClaudeAdapter extends AdapterBase {
     name: string;
     description: string;

package/dist/adapters/claude/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnE,qBAAa,aAAc,SAAQ,WAAW;IAC5C,IAAI,SAAY;IAChB,WAAW,SAA0F;IACrG,eAAe,EAAG,MAAM,CAAU;IAElC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAUhC;;;;;;;;OAQG;IACH,QAAQ,IAAI,WAAW,EAAE;IAYzB;;;;;;;;;OASG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAsD1B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtE,qBAAa,aAAc,SAAQ,WAAW;IAC5C,IAAI,SAAY;IAChB,WAAW,SAA0F;IACrG,eAAe,EAAG,MAAM,CAAU;IAElC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAUhC;;;;;;;;OAQG;IACH,QAAQ,IAAI,WAAW,EAAE;IAYzB;;;;;;;;;OASG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAsD1B"}