specweave 0.14.0 → 0.15.0

package/dist/src/adapters/codex/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/adapters/codex/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE9C,MAAM,OAAO,YAAa,SAAQ,WAAW;IAA7C;;QACE,SAAI,GAAG,OAAO,CAAC;QACf,gBAAW,GAAG,gFAAgF,CAAC;QAC/F,oBAAe,GAAG,MAAe,CAAC;IAkTpC,CAAC;IAhTC;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAEvD,OAAO,WAAW,IAAI,WAAW,IAAI,WAAW,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE,WAAW;gBACvB,UAAU,EAAE,WAAW;gBACvB,WAAW,EAAE,4DAA4D;aAC1E;YACD;gBACE,UAAU,EAAE,WAAW;gBACvB,UAAU,EAAE,kBAAkB;gBAC9B,WAAW,EAAE,6BAA6B;aAC3C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QAExE,iCAAiC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE7B,qBAAqB;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEnD,cAAc;QACd,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,OAAuB;QACxE,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CACvC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;YACvC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QAEH,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAuB;QACvC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoNN,CAAC;IACJ,CAAC;CACF"}

package/dist/src/adapters/cursor/adapter.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Cursor Adapter
+ *
+ * Semi-automation adapter for Cursor editor.
+ * Provides @ context shortcuts for quick context injection.
+ *
+ * Cursor automatically reads AGENTS.md (universal standard) for workflow instructions.
+ * This adapter only installs Cursor-specific features (@ shortcuts).
+ */
+import { AdapterBase } from '../adapter-base.js';
+import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+import type { Plugin } from '../../core/types/plugin.js';
+export declare class CursorAdapter extends AdapterBase {
+    name: string;
+    description: string;
+    automationLevel: "semi";
+    /**
+     * Detect if Cursor is available
+     *
+     * Checks for:
+     * - cursor command in PATH
+     * - .cursor/ directory exists
+     */
+    detect(): Promise<boolean>;
+    /**
+     * Get files to install for Cursor adapter
+     *
+     * Note: Cursor automatically reads AGENTS.md (universal standard).
+     * This adapter only installs Cursor-specific @ context shortcuts.
+     */
+    getFiles(): AdapterFile[];
+    /**
+     * Install Cursor adapter
+     */
+    install(options: AdapterOptions): Promise<void>;
+    /**
+     * Post-installation instructions
+     */
+    postInstall(options: AdapterOptions): Promise<void>;
+    /**
+     * Get usage instructions for Cursor adapter
+     */
+    getInstructions(): string;
+    /**
+     * Check if Cursor adapter supports plugins
+     *
+     * Cursor has plugin support via AGENTS.md compilation
+     *
+     * @returns boolean True for Cursor
+     */
+    supportsPlugins(): boolean;
+    /**
+     * Read language configuration from project config
+     *
+     * @returns Language setting from config, defaults to 'en'
+     */
+    private getLanguageConfig;
+    /**
+     * Inject system prompt for non-English languages
+     *
+     * Prepends language instruction to markdown content if language !== 'en'
+     *
+     * @param content Original markdown content
+     * @param language Target language
+     * @returns Modified content with system prompt (or unchanged if English)
+     */
+    private injectSystemPrompt;
+    /**
+     * Compile and install a plugin for Cursor
+     *
+     * Cursor uses AGENTS.md compilation:
+     * - Append skills to AGENTS.md
+     * - Append agents to AGENTS.md
+     * - Append commands to team commands JSON
+     *
+     * NEW: Injects system prompts for non-English languages
+     *
+     * @param plugin Plugin to install
+     */
+    compilePlugin(plugin: Plugin): Promise<void>;
+    /**
+     * Unload a plugin from Cursor
+     *
+     * Removes plugin section from AGENTS.md
+     *
+     * @param pluginName Name of plugin to unload
+     */
+    unloadPlugin(pluginName: string): Promise<void>;
+    /**
+     * Get list of installed plugins for Cursor
+     *
+     * Parses AGENTS.md for plugin markers
+     *
+     * @returns Array of installed plugin names
+     */
+    getInstalledPlugins(): Promise<string[]>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/src/adapters/cursor/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/cursor/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAIzD,qBAAa,aAAc,SAAQ,WAAW;IAC5C,IAAI,SAAY;IAChB,WAAW,SAA6E;IACxF,eAAe,EAAG,MAAM,CAAU;IAElC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAOhC;;;;;OAKG;IACH,QAAQ,IAAI,WAAW,EAAE;IA8BzB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;IA2HzB;;;;;;OAMG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;YACW,iBAAiB;IAiB/B;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsFlD;;;;;;OAMG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCrD;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAmB/C"}

package/dist/src/adapters/cursor/adapter.js

@@ -0,0 +1,406 @@
+/**
+ * Cursor Adapter
+ *
+ * Semi-automation adapter for Cursor editor.
+ * Provides @ context shortcuts for quick context injection.
+ *
+ * Cursor automatically reads AGENTS.md (universal standard) for workflow instructions.
+ * This adapter only installs Cursor-specific features (@ shortcuts).
+ */
+import * as path from 'path';
+import fs from 'fs-extra';
+import { AdapterBase } from '../adapter-base.js';
+import { getSystemPromptForLanguage } from '../../core/i18n/language-manager.js';
+export class CursorAdapter extends AdapterBase {
+    constructor() {
+        super(...arguments);
+        this.name = 'cursor';
+        this.description = 'Cursor adapter - Semi-automation with AGENTS.md and @ context shortcuts';
+        this.automationLevel = 'semi';
+    }
+    /**
+     * Detect if Cursor is available
+     *
+     * Checks for:
+     * - cursor command in PATH
+     * - .cursor/ directory exists
+     */
+    async detect() {
+        const hasCursorCLI = await this.commandExists('cursor');
+        const hasCursorDir = await this.fileExists('.cursor');
+        return hasCursorCLI || hasCursorDir;
+    }
+    /**
+     * Get files to install for Cursor adapter
+     *
+     * Note: Cursor automatically reads AGENTS.md (universal standard).
+     * This adapter only installs Cursor-specific @ context shortcuts.
+     */
+    getFiles() {
+        return [
+            {
+                sourcePath: '.cursor/context/increments-context.md',
+                targetPath: '.cursor/context/increments-context.md',
+                description: '@increments context shortcut'
+            },
+            {
+                sourcePath: '.cursor/context/docs-context.md',
+                targetPath: '.cursor/context/docs-context.md',
+                description: '@docs context shortcut'
+            },
+            {
+                sourcePath: '.cursor/context/strategy-context.md',
+                targetPath: '.cursor/context/strategy-context.md',
+                description: '@strategy context shortcut'
+            },
+            {
+                sourcePath: '.cursor/context/tests-context.md',
+                targetPath: '.cursor/context/tests-context.md',
+                description: '@tests context shortcut'
+            },
+            {
+                sourcePath: 'README.md',
+                targetPath: '.cursor/README.md',
+                description: 'Cursor adapter documentation'
+            }
+        ];
+    }
+    /**
+     * Install Cursor adapter
+     */
+    async install(options) {
+        console.log('\n📦 Installing Cursor Adapter (Semi-Automation)\n');
+        // Ensure .cursor directory exists
+        const cursorDir = path.join(options.projectPath, '.cursor');
+        await fs.ensureDir(cursorDir);
+        await fs.ensureDir(path.join(cursorDir, 'context'));
+        // Copy files
+        await super.install(options);
+        console.log('\n✨ Cursor adapter installed!');
+        console.log('\n📋 Files created:');
+        console.log('   - .cursor/context/ (@ shortcuts for quick context injection)');
+    }
+    /**
+     * Post-installation instructions
+     */
+    async postInstall(options) {
+        console.log(this.getInstructions());
+    }
+    /**
+     * Get usage instructions for Cursor adapter
+     */
+    getInstructions() {
+        return `
+================================================================
+        Cursor Adapter - Semi-Automation
+================================================================
+
+Your project is now configured for Cursor with SEMI-automation!
+
+WHAT THIS PROVIDES:
+
+- AGENTS.md (Universal Standard)
+  - Cursor automatically reads this file
+  - Contains all workflow instructions
+  - Defines agent roles (PM, Architect, etc.)
+  - Defines skill capabilities (increment-planner, context-loader, etc.)
+  - Project structure and templates
+  - Following agents.md standard (https://agents.md/)
+
+- @ Context Shortcuts (Quick Access)
+  - @increments - Load current increment files
+  - @docs - Load architecture documentation
+  - @strategy - Load business specifications
+  - @tests - Load test strategy and cases
+
+- Composer Multi-File Editing
+  - Create multiple files simultaneously
+  - Edit across spec.md, plan.md, tasks.md
+
+UNDERSTANDING THE DIFFERENCE:
+
+Claude Code (Full Automation):
+- Native skills (auto-activate)
+- Native agents (separate context windows)
+- Native hooks (auto-update docs)
+- Slash commands (/inc, /do, /done)
+
+Cursor (Semi-Automation - This Adapter):
+- Reads AGENTS.md for workflow instructions
+- Manual role adoption (say "act as PM")
+- No hooks (manual doc updates)
+- Manual workflows (follow AGENTS.md steps)
+
+HOW CURSOR USES AGENTS.MD:
+
+Cursor automatically reads AGENTS.md to understand:
+1. Project structure (.specweave/ folders)
+2. How to create increments (spec.md, plan.md, tasks.md)
+3. Agent roles (PM defines WHAT/WHY, Architect designs HOW)
+4. Skill workflows (increment-planner, context-loader, etc.)
+5. Context manifests (70%+ token savings)
+6. Templates and examples
+
+When you say "create increment for auth":
+→ Cursor reads AGENTS.md
+→ Follows the workflow described there
+→ Creates spec.md (adopting PM role)
+→ Creates plan.md (adopting Architect role)
+→ Creates tasks.md
+
+QUICK START:
+
+1. Open project in Cursor
+
+2. Create your first feature:
+   "Create increment for user authentication"
+
+   Cursor will:
+   - Read AGENTS.md for workflow
+   - Ask clarifying questions
+   - Create spec.md (acting as PM from AGENTS.md)
+   - Create plan.md (acting as Architect from AGENTS.md)
+   - Create tasks.md
+
+3. Use @ shortcuts for context:
+   "@increments show me the current increment"
+   "@docs show me the architecture"
+   "@strategy show me the business requirements"
+
+4. Use Composer for multi-file edits:
+   Cmd+I → "Update spec.md and plan.md to add OAuth2"
+
+CONTEXT LOADING (70%+ Token Savings):
+
+CRITICAL: Always read context-manifest.yaml first!
+
+AGENTS.md teaches Cursor:
+1. Look for .specweave/increments/####/context-manifest.yaml
+2. ONLY load files listed in manifest
+3. Don't load all specs (wastes tokens)
+
+Example manifest (YAML):
+
+spec_sections:
+  - .specweave/docs/internal/strategy/auth/spec.md
+documentation:
+  - .specweave/docs/internal/architecture/auth-design.md
+
+Cursor: "Only load these 2 files, not entire docs/ folder"
+
+LIMITATIONS (vs Claude Code):
+
+- No auto-activation (must explicitly request workflows)
+- No separate context windows (all context shared)
+- No hooks (can't auto-update docs on events)
+- Requires manual role adoption (say "act as PM")
+
+But still VERY good experience with Composer + @ shortcuts!
+
+DOCUMENTATION:
+
+- AGENTS.md: Universal workflow instructions (Cursor reads this!)
+- .cursor/README.md: Cursor-specific documentation
+- .specweave/docs/: Project documentation
+
+You're ready to build with SpecWeave on Cursor!
+
+Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
+- "act as PM and create spec" (AGENTS.md defines PM role)
+- "act as Architect and design system" (AGENTS.md defines Architect role)
+- "act as DevOps and create infrastructure" (AGENTS.md defines DevOps role)
+    `;
+    }
+    /**
+     * Check if Cursor adapter supports plugins
+     *
+     * Cursor has plugin support via AGENTS.md compilation
+     *
+     * @returns boolean True for Cursor
+     */
+    supportsPlugins() {
+        return true;
+    }
+    /**
+     * Read language configuration from project config
+     *
+     * @returns Language setting from config, defaults to 'en'
+     */
+    async getLanguageConfig() {
+        const projectPath = process.cwd();
+        const configPath = path.join(projectPath, '.specweave', 'config.json');
+        if (!(await fs.pathExists(configPath))) {
+            return 'en'; // Default to English if no config
+        }
+        try {
+            const config = await fs.readJson(configPath);
+            return config.language || 'en';
+        }
+        catch (error) {
+            console.warn('⚠️  Could not read language from config, defaulting to English');
+            return 'en';
+        }
+    }
+    /**
+     * Inject system prompt for non-English languages
+     *
+     * Prepends language instruction to markdown content if language !== 'en'
+     *
+     * @param content Original markdown content
+     * @param language Target language
+     * @returns Modified content with system prompt (or unchanged if English)
+     */
+    injectSystemPrompt(content, language) {
+        if (language === 'en') {
+            return content; // No changes for English - preserve default behavior
+        }
+        // Get system prompt for target language
+        const systemPrompt = getSystemPromptForLanguage(language);
+        // For AGENTS.md compilation, inject at the beginning of the content
+        return `${systemPrompt}\n\n${content}`;
+    }
+    /**
+     * Compile and install a plugin for Cursor
+     *
+     * Cursor uses AGENTS.md compilation:
+     * - Append skills to AGENTS.md
+     * - Append agents to AGENTS.md
+     * - Append commands to team commands JSON
+     *
+     * NEW: Injects system prompts for non-English languages
+     *
+     * @param plugin Plugin to install
+     */
+    async compilePlugin(plugin) {
+        const projectPath = process.cwd();
+        const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+        console.log(`\n📦 Compiling plugin for Cursor: ${plugin.manifest.name}`);
+        // Get language configuration for system prompt injection
+        const language = await this.getLanguageConfig();
+        if (language !== 'en') {
+            console.log(`   🌐 Language: ${language} (system prompts will be injected)`);
+        }
+        // Ensure AGENTS.md exists
+        if (!(await fs.pathExists(agentsMdPath))) {
+            throw new Error('AGENTS.md not found. Run specweave init first.');
+        }
+        // Read current AGENTS.md
+        let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+        // Check if plugin already compiled
+        const pluginMarker = `<!-- Plugin: ${plugin.manifest.name} -->`;
+        if (agentsMd.includes(pluginMarker)) {
+            console.log(`   ℹ️  Plugin ${plugin.manifest.name} already compiled to AGENTS.md`);
+            return;
+        }
+        // Generate plugin section for AGENTS.md
+        let pluginSection = `\n\n${pluginMarker}\n\n`;
+        pluginSection += `# Plugin: ${plugin.manifest.name}\n\n`;
+        pluginSection += `${plugin.manifest.description}\n\n`;
+        // Add skills
+        if (plugin.skills.length > 0) {
+            pluginSection += `## Skills\n\n`;
+            for (const skill of plugin.skills) {
+                const skillContent = await fs.readFile(path.join(skill.path, 'SKILL.md'), 'utf-8');
+                // Remove frontmatter for AGENTS.md
+                const contentWithoutFrontmatter = skillContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+                // Inject system prompt if needed
+                const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
+                pluginSection += `### ${skill.name}\n\n`;
+                pluginSection += `${modifiedContent}\n\n`;
+            }
+        }
+        // Add agents
+        if (plugin.agents.length > 0) {
+            pluginSection += `## Agents\n\n`;
+            for (const agent of plugin.agents) {
+                const agentContent = await fs.readFile(path.join(agent.path, 'AGENT.md'), 'utf-8');
+                // Inject system prompt if needed
+                const modifiedContent = this.injectSystemPrompt(agentContent, language);
+                pluginSection += `### ${agent.name}\n\n`;
+                pluginSection += `${modifiedContent}\n\n`;
+            }
+        }
+        // Add commands
+        if (plugin.commands.length > 0) {
+            pluginSection += `## Commands\n\n`;
+            for (const command of plugin.commands) {
+                const commandContent = await fs.readFile(command.path, 'utf-8');
+                // Remove frontmatter
+                const contentWithoutFrontmatter = commandContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+                // Inject system prompt if needed
+                const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
+                pluginSection += `### /${command.name}\n\n`;
+                pluginSection += `${modifiedContent}\n\n`;
+            }
+        }
+        pluginSection += `<!-- End Plugin: ${plugin.manifest.name} -->\n`;
+        // Append to AGENTS.md
+        agentsMd += pluginSection;
+        await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+        console.log(`   ✓ Compiled to AGENTS.md`);
+        console.log(`   ✓ ${plugin.skills.length} skills added`);
+        console.log(`   ✓ ${plugin.agents.length} agents added`);
+        console.log(`   ✓ ${plugin.commands.length} commands added`);
+        console.log(`\n✅ Plugin ${plugin.manifest.name} compiled for Cursor!`);
+    }
+    /**
+     * Unload a plugin from Cursor
+     *
+     * Removes plugin section from AGENTS.md
+     *
+     * @param pluginName Name of plugin to unload
+     */
+    async unloadPlugin(pluginName) {
+        const projectPath = process.cwd();
+        const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+        console.log(`\n🗑️  Unloading plugin from Cursor: ${pluginName}`);
+        if (!(await fs.pathExists(agentsMdPath))) {
+            console.warn(`⚠️  AGENTS.md not found`);
+            return;
+        }
+        // Read AGENTS.md
+        let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+        // Find plugin section
+        const startMarker = `<!-- Plugin: ${pluginName} -->`;
+        const endMarker = `<!-- End Plugin: ${pluginName} -->`;
+        const startIndex = agentsMd.indexOf(startMarker);
+        if (startIndex === -1) {
+            console.warn(`⚠️  Plugin ${pluginName} not found in AGENTS.md`);
+            return;
+        }
+        const endIndex = agentsMd.indexOf(endMarker, startIndex);
+        if (endIndex === -1) {
+            console.warn(`⚠️  Plugin ${pluginName} section malformed in AGENTS.md`);
+            return;
+        }
+        // Remove plugin section
+        agentsMd = agentsMd.slice(0, startIndex) + agentsMd.slice(endIndex + endMarker.length);
+        // Write back
+        await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+        console.log(`   ✓ Removed from AGENTS.md`);
+        console.log(`\n✅ Plugin ${pluginName} unloaded!`);
+    }
+    /**
+     * Get list of installed plugins for Cursor
+     *
+     * Parses AGENTS.md for plugin markers
+     *
+     * @returns Array of installed plugin names
+     */
+    async getInstalledPlugins() {
+        const projectPath = process.cwd();
+        const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+        if (!(await fs.pathExists(agentsMdPath))) {
+            return [];
+        }
+        const agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+        const pluginMarkerRegex = /<!-- Plugin: (specweave-[a-z0-9-]+) -->/g;
+        const matches = agentsMd.matchAll(pluginMarkerRegex);
+        const plugins = [];
+        for (const match of matches) {
+            plugins.push(match[1]);
+        }
+        return plugins;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/adapters/cursor/adapter.js.map

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

package/dist/src/adapters/doc-generator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Documentation Generator for Adapters
+ *
+ * Generates markdown documentation from actual skills/agents/commands
+ * for use in adapter instruction files (.cursorrules, instructions.md, etc.)
+ */
+interface SkillMetadata {
+    name: string;
+    description: string;
+    location: string;
+}
+interface AgentMetadata {
+    name: string;
+    role: string;
+    description: string;
+    location: string;
+}
+interface CommandMetadata {
+    name: string;
+    description: string;
+    location: string;
+}
+/**
+ * Documentation Generator
+ */
+export declare class DocGenerator {
+    private skillsDir;
+    private agentsDir;
+    private commandsDir;
+    constructor(skillsDir?: string, agentsDir?: string, commandsDir?: string);
+    /**
+     * Extract skills metadata from SKILL.md files
+     */
+    extractSkills(): Promise<SkillMetadata[]>;
+    /**
+     * Extract agents metadata from AGENT.md files
+     */
+    extractAgents(): Promise<AgentMetadata[]>;
+    /**
+     * Extract commands metadata from .md files
+     */
+    extractCommands(): Promise<CommandMetadata[]>;
+    /**
+     * Generate skills documentation for Cursor .cursorrules
+     */
+    generateSkillsDocForCursor(): Promise<string>;
+    /**
+     * Generate agents documentation for Cursor .cursorrules
+     */
+    generateAgentsDocForCursor(): Promise<string>;
+    /**
+     * Generate skills documentation for Copilot instructions.md
+     */
+    generateSkillsDocForCopilot(): Promise<string>;
+    /**
+     * Generate agents documentation for Copilot instructions.md
+     */
+    generateAgentsDocForCopilot(): Promise<string>;
+    /**
+     * Generate complete manual workflow for generic adapter
+     */
+    generateManualWorkflow(): Promise<string>;
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    private extractYAMLFrontmatter;
+}
+export {};
+//# sourceMappingURL=doc-generator.d.ts.map

package/dist/src/adapters/doc-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-generator.d.ts","sourceRoot":"","sources":["../../../src/adapters/doc-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAG1B,SAAS,GAAE,MAA0C,EACrD,SAAS,GAAE,MAA0C,EACrD,WAAW,GAAE,MAA4C;IAO3D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA8B/C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAoC/C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IA+BnD;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBnD;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBnD;;OAEG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC;IAepD;;OAEG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC;IAepD;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC;IAiF/C;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAU/B"}