specweave 0.16.7 → 0.16.12

package/dist/spec-splitter.js

@@ -0,0 +1,283 @@
+/**
+ * Spec Splitter - Split Monolithic Specs into Project-Specific Files
+ *
+ * Takes a comprehensive spec file covering multiple projects and intelligently
+ * splits it into project-specific spec files (FE/, BE/, MOBILE/, etc.)
+ *
+ * @module spec-splitter
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import { splitSpecByProject, DEFAULT_PROJECT_RULES } from './project-mapper.js';
+/**
+ * Parse spec file into structured format
+ *
+ * @param specPath Path to spec.md file
+ * @returns Parsed spec structure
+ */
+export async function parseSpecFile(specPath) {
+    const content = await fs.readFile(specPath, 'utf-8');
+    // Extract frontmatter
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) {
+        throw new Error('No frontmatter found in spec file');
+    }
+    const metadata = parseFrontmatter(frontmatterMatch[1]);
+    // Extract sections
+    const sections = extractSections(content);
+    // Parse user stories
+    const userStories = parseUserStories(sections.userStories || '');
+    return {
+        metadata,
+        executiveSummary: sections.executiveSummary || '',
+        problemStatement: sections.problemStatement || '',
+        userStories,
+        functionalRequirements: sections.functionalRequirements || '',
+        nonFunctionalRequirements: sections.nonFunctionalRequirements || '',
+        successMetrics: sections.successMetrics || '',
+        technicalArchitecture: sections.technicalArchitecture || '',
+        testStrategy: sections.testStrategy || '',
+        riskAnalysis: sections.riskAnalysis || '',
+        futureRoadmap: sections.futureRoadmap || '',
+        appendices: sections.appendices || ''
+    };
+}
+/**
+ * Parse YAML frontmatter into metadata object
+ */
+function parseFrontmatter(frontmatter) {
+    const lines = frontmatter.split('\n');
+    const metadata = {};
+    for (const line of lines) {
+        const match = line.match(/^(\w+):\s*(.+)$/);
+        if (match) {
+            const key = match[1];
+            const value = match[2].trim();
+            // Handle arrays
+            if (value.startsWith('[')) {
+                metadata[key] = JSON.parse(value);
+            }
+            else {
+                metadata[key] = value.replace(/^["']|["']$/g, '');
+            }
+        }
+    }
+    return metadata;
+}
+/**
+ * Extract sections from spec markdown
+ */
+function extractSections(content) {
+    const sections = {};
+    // Remove frontmatter
+    const withoutFrontmatter = content.replace(/^---\n[\s\S]*?\n---\n/, '');
+    // Split by h2 headers (##)
+    const parts = withoutFrontmatter.split(/^## /m);
+    for (const part of parts) {
+        if (!part.trim())
+            continue;
+        const lines = part.split('\n');
+        const sectionName = lines[0].trim();
+        const sectionContent = lines.slice(1).join('\n').trim();
+        // Normalize section names
+        const normalizedName = sectionName
+            .replace(/[^a-zA-Z0-9\s]/g, '')
+            .replace(/\s+/g, '')
+            .replace(/^(.)/, (m) => m.toLowerCase());
+        sections[normalizedName] = sectionContent;
+    }
+    return sections;
+}
+/**
+ * Parse user stories from spec section
+ */
+function parseUserStories(userStoriesSection) {
+    const stories = [];
+    // Split by h3 headers (###)
+    const storyParts = userStoriesSection.split(/^### /m);
+    for (const part of storyParts) {
+        if (!part.trim())
+            continue;
+        const lines = part.split('\n');
+        const titleLine = lines[0].trim();
+        // Extract US-XXX: Title
+        const match = titleLine.match(/^(US-\d+):\s*(.+?)(?:\s*\(Priority|$)/);
+        if (!match)
+            continue;
+        const id = match[1];
+        const title = match[2].trim();
+        // Extract description (As a... I want... So that...)
+        const descriptionMatch = part.match(/\*\*As a\*\*\s+(.+?)\n\*\*I want\*\*\s+(.+?)\n\*\*So that\*\*\s+(.+?)(?:\n|$)/s);
+        const description = descriptionMatch
+            ? `As a ${descriptionMatch[1].trim()} I want ${descriptionMatch[2].trim()} So that ${descriptionMatch[3].trim()}`
+            : '';
+        // Extract acceptance criteria
+        const acceptanceCriteria = [];
+        const acMatches = part.matchAll(/\*\*AC-[A-Z0-9-]+\*\*:\s*(.+?)(?:\n-|\n\*\*|$)/gs);
+        for (const acMatch of acMatches) {
+            acceptanceCriteria.push(acMatch[1].trim());
+        }
+        // Extract technical context (if present)
+        const technicalContextMatch = part.match(/#### Technical Context\n\n([\s\S]+?)(?:\n####|\n---|\n###|$)/);
+        const technicalContext = technicalContextMatch ? technicalContextMatch[1].trim() : undefined;
+        stories.push({
+            id,
+            title,
+            description,
+            acceptanceCriteria,
+            technicalContext
+        });
+    }
+    return stories;
+}
+/**
+ * Split spec into project-specific files
+ *
+ * @param specPath Path to monolithic spec.md
+ * @param outputDir Directory to write project-specific specs (e.g., .specweave/docs/internal/specs/)
+ * @param projectRules Custom project mapping rules (optional)
+ * @returns Map of projectId → output file path
+ */
+export async function splitSpecIntoProjects(specPath, outputDir, projectRules = DEFAULT_PROJECT_RULES) {
+    // Parse spec
+    const parsedSpec = await parseSpecFile(specPath);
+    // Split user stories by project
+    const projectStories = splitSpecByProject(parsedSpec.userStories, projectRules);
+    // Create output map
+    const outputMap = new Map();
+    // Generate project-specific specs
+    for (const [projectId, stories] of projectStories.entries()) {
+        const projectDir = path.join(outputDir, projectId);
+        await fs.ensureDir(projectDir);
+        const outputPath = path.join(projectDir, `spec-${parsedSpec.metadata.specId.toLowerCase()}-${projectId.toLowerCase()}.md`);
+        const projectSpec = generateProjectSpec(parsedSpec, projectId, stories);
+        await fs.writeFile(outputPath, projectSpec, 'utf-8');
+        outputMap.set(projectId, outputPath);
+    }
+    return outputMap;
+}
+/**
+ * Generate project-specific spec file
+ */
+function generateProjectSpec(parsedSpec, projectId, userStories) {
+    const lines = [];
+    // Frontmatter
+    lines.push('---');
+    lines.push(`spec_id: ${parsedSpec.metadata.specId}`);
+    lines.push(`project: ${projectId}`);
+    lines.push(`title: "${parsedSpec.metadata.title} - ${projectId}"`);
+    lines.push(`version: ${parsedSpec.metadata.version}`);
+    lines.push(`status: ${parsedSpec.metadata.status}`);
+    lines.push(`created: ${parsedSpec.metadata.created}`);
+    lines.push(`last_updated: ${parsedSpec.metadata.lastUpdated}`);
+    lines.push(`authors:`);
+    for (const author of parsedSpec.metadata.authors) {
+        lines.push(`  - ${author}`);
+    }
+    lines.push(`priority: ${parsedSpec.metadata.priority}`);
+    lines.push(`estimated_effort: ${parsedSpec.metadata.estimatedEffort}`);
+    lines.push(`target_release: ${parsedSpec.metadata.targetRelease}`);
+    if (parsedSpec.metadata.jiraSync) {
+        lines.push(`jira_sync: true`);
+        lines.push(`jira_project: ${projectId}`);
+    }
+    lines.push('---');
+    lines.push('');
+    // Title
+    lines.push(`# SPEC-${parsedSpec.metadata.specId}: ${parsedSpec.metadata.title} - ${projectId}`);
+    lines.push('');
+    // Executive Summary (project-specific)
+    lines.push('## Executive Summary');
+    lines.push('');
+    lines.push(`**Project**: ${projectId}`);
+    lines.push(`**Scope**: ${userStories.length} user stories for ${projectId} component`);
+    lines.push('');
+    lines.push(parsedSpec.executiveSummary);
+    lines.push('');
+    // User Stories (filtered for this project)
+    lines.push('## User Stories');
+    lines.push('');
+    for (const story of userStories) {
+        lines.push(`### ${story.id}: ${story.title}`);
+        lines.push('');
+        lines.push(story.description);
+        lines.push('');
+        if (story.acceptanceCriteria.length > 0) {
+            lines.push('#### Acceptance Criteria');
+            lines.push('');
+            for (const ac of story.acceptanceCriteria) {
+                lines.push(`**${ac}**`);
+                lines.push('');
+            }
+        }
+        if (story.technicalContext) {
+            lines.push('#### Technical Context');
+            lines.push('');
+            lines.push(story.technicalContext);
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('');
+    }
+    // Shared sections (include full content from original spec)
+    if (parsedSpec.functionalRequirements) {
+        lines.push('## Functional Requirements (Shared)');
+        lines.push('');
+        lines.push('*See main spec for complete functional requirements*');
+        lines.push('');
+    }
+    if (parsedSpec.nonFunctionalRequirements) {
+        lines.push('## Non-Functional Requirements (Shared)');
+        lines.push('');
+        lines.push('*See main spec for complete non-functional requirements*');
+        lines.push('');
+    }
+    if (parsedSpec.technicalArchitecture) {
+        lines.push('## Technical Architecture');
+        lines.push('');
+        lines.push(parsedSpec.technicalArchitecture);
+        lines.push('');
+    }
+    // Footer
+    lines.push('---');
+    lines.push('');
+    lines.push('**Document End**');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Create multi-project folder structure
+ *
+ * @param specsDir Base specs directory (.specweave/docs/internal/specs/)
+ * @param projectIds Array of project IDs (e.g., ['FE', 'BE', 'MOBILE'])
+ */
+export async function createMultiProjectFolderStructure(specsDir, projectIds) {
+    await fs.ensureDir(specsDir);
+    for (const projectId of projectIds) {
+        const projectDir = path.join(specsDir, projectId);
+        await fs.ensureDir(projectDir);
+        // Create README.md for project
+        const readme = `# ${projectId} Specifications
+
+This folder contains specifications for the **${projectId}** project.
+
+## Organization
+
+- \`spec-NNNN-*.md\` - Project-specific specifications (living docs)
+- Each spec is permanently archived here after increment completion
+- Specs are auto-generated from increment specs and split by project
+
+## External Sync
+
+${projectId} specs sync to:
+- **JIRA**: Project ${projectId} (Epics)
+- **GitHub**: Issues tagged with \`${projectId}\` label
+
+## Maintenance
+
+- Specs are auto-updated via living docs sync hooks
+- Manual edits should be made in increment specs, not here
+`;
+        await fs.writeFile(path.join(projectDir, 'README.md'), readme, 'utf-8');
+    }
+}

package/dist/src/adapters/adapter-base.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Base Adapter Class
+ *
+ * Provides common functionality for all adapters.
+ * Concrete adapters extend this class and implement tool-specific logic.
+ */
+import { IAdapter, AdapterOptions, RequirementsResult, AdapterFile, AutomationLevel } from './adapter-interface.js';
+import type { Plugin } from '../core/types/plugin.js';
+export declare abstract class AdapterBase implements IAdapter {
+    abstract name: string;
+    abstract description: string;
+    abstract automationLevel: AutomationLevel;
+    /**
+     * Default detection - override in concrete adapters
+     */
+    detect(): Promise<boolean>;
+    /**
+     * Check common requirements (Node.js, Git)
+     * Concrete adapters can override to add tool-specific checks
+     */
+    checkRequirements(): Promise<RequirementsResult>;
+    /**
+     * Get files to install - must be implemented by concrete adapters
+     */
+    abstract getFiles(): AdapterFile[];
+    /**
+     * Install adapter files to project
+     */
+    install(options: AdapterOptions): Promise<void>;
+    /**
+     * Post-installation actions - can be overridden by concrete adapters
+     */
+    postInstall(options: AdapterOptions): Promise<void>;
+    /**
+     * Get usage instructions - must be implemented by concrete adapters
+     */
+    abstract getInstructions(): string;
+    /**
+     * Helper: Check if a command exists in PATH
+     */
+    protected commandExists(command: string): Promise<boolean>;
+    /**
+     * Helper: Check if a file exists
+     */
+    protected fileExists(filePath: string): Promise<boolean>;
+    /**
+     * Helper: Read template file and replace variables
+     */
+    protected readTemplate(templatePath: string, variables: Record<string, string>): Promise<string>;
+    /**
+     * Check if this adapter supports plugins
+     * Default: No plugin support (override in concrete adapters)
+     */
+    supportsPlugins(): boolean;
+    /**
+     * Compile and install a plugin
+     * Default: Throw error (override in concrete adapters that support plugins)
+     */
+    compilePlugin(plugin: Plugin): Promise<void>;
+    /**
+     * Unload a plugin
+     * Default: Throw error (override in concrete adapters that support plugins)
+     */
+    unloadPlugin(pluginName: string): Promise<void>;
+    /**
+     * Get installed plugins
+     * Default: Return empty array (override in concrete adapters that support plugins)
+     */
+    getInstalledPlugins(): Promise<string[]>;
+}
+//# sourceMappingURL=adapter-base.d.ts.map

package/dist/src/adapters/adapter-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-base.d.ts","sourceRoot":"","sources":["../../../src/adapters/adapter-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAItD,8BAAsB,WAAY,YAAW,QAAQ;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA0BtD;;OAEG;IACH,QAAQ,CAAC,QAAQ,IAAI,WAAW,EAAE;IAElC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzD;;OAEG;IACH,QAAQ,CAAC,eAAe,IAAI,MAAM;IAElC;;OAEG;cACa,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhE;;OAEG;cACa,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9D;;OAEG;cACa,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC;IAWlB;;;OAGG;IACH,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAG/C"}

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

@@ -0,0 +1,139 @@
+/**
+ * Base Adapter Class
+ *
+ * Provides common functionality for all adapters.
+ * Concrete adapters extend this class and implement tool-specific logic.
+ */
+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
+     */
+    async detect() {
+        return false;
+    }
+    /**
+     * Check common requirements (Node.js, Git)
+     * Concrete adapters can override to add tool-specific checks
+     */
+    async checkRequirements() {
+        const result = {
+            met: true,
+            missing: [],
+            warnings: []
+        };
+        // Check Node.js version
+        const nodeVersion = process.version;
+        const majorVersion = parseInt(nodeVersion.split('.')[0].slice(1));
+        if (majorVersion < 18) {
+            result.met = false;
+            result.missing.push(`Node.js >= 18.0.0 (current: ${nodeVersion})`);
+        }
+        // Check Git
+        try {
+            execSync('git --version', { stdio: 'ignore' });
+        }
+        catch (error) {
+            result.warnings.push('Git not found - version control features may not work');
+        }
+        return result;
+    }
+    /**
+     * Install adapter files to project
+     */
+    async install(options) {
+        const files = this.getFiles();
+        const adapterSourceDir = path.join(__dirname, this.name);
+        console.log(`\n📦 Installing ${this.name} adapter files...`);
+        for (const file of files) {
+            const sourcePath = path.join(adapterSourceDir, file.sourcePath);
+            const targetPath = path.join(options.projectPath, file.targetPath);
+            // Ensure target directory exists
+            await fs.ensureDir(path.dirname(targetPath));
+            // Copy file
+            if (await fs.pathExists(sourcePath)) {
+                await fs.copy(sourcePath, targetPath);
+                console.log(`  ✅ ${file.targetPath} - ${file.description}`);
+            }
+            else {
+                console.warn(`  ⚠️  Source file not found: ${sourcePath}`);
+            }
+        }
+    }
+    /**
+     * Post-installation actions - can be overridden by concrete adapters
+     */
+    async postInstall(options) {
+        // Default: Display instructions
+        console.log('\n' + this.getInstructions());
+    }
+    /**
+     * Helper: Check if a command exists in PATH
+     */
+    async commandExists(command) {
+        try {
+            const { execSync } = require('child_process');
+            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;
+        }
+    }
+    /**
+     * Helper: Read template file and replace variables
+     */
+    async readTemplate(templatePath, variables) {
+        let content = await fs.readFile(templatePath, 'utf-8');
+        // Replace all {{variable}} with actual values
+        for (const [key, value] of Object.entries(variables)) {
+            content = content.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+        }
+        return content;
+    }
+    /**
+     * Check if this adapter supports plugins
+     * Default: No plugin support (override in concrete adapters)
+     */
+    supportsPlugins() {
+        return false;
+    }
+    /**
+     * Compile and install a plugin
+     * Default: Throw error (override in concrete adapters that support plugins)
+     */
+    async compilePlugin(plugin) {
+        throw new Error(`Plugin support not implemented for ${this.name} adapter`);
+    }
+    /**
+     * Unload a plugin
+     * Default: Throw error (override in concrete adapters that support plugins)
+     */
+    async unloadPlugin(pluginName) {
+        throw new Error(`Plugin support not implemented for ${this.name} adapter`);
+    }
+    /**
+     * Get installed plugins
+     * Default: Return empty array (override in concrete adapters that support plugins)
+     */
+    async getInstalledPlugins() {
+        return [];
+    }
+}
+//# sourceMappingURL=adapter-base.js.map

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

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

package/dist/src/adapters/adapter-interface.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 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/ChatGPT/Gemini via generic, etc.)
+ */
+import type { Plugin } from '../core/types/plugin.js';
+export interface AdapterOptions {
+    projectPath: string;
+    projectName: string;
+    techStack?: {
+        language: string;
+        framework?: string;
+    };
+    docsApproach?: 'comprehensive' | 'incremental';
+}
+export interface RequirementsResult {
+    met: boolean;
+    missing: string[];
+    warnings: string[];
+}
+export interface AdapterFile {
+    sourcePath: string;
+    targetPath: string;
+    description: string;
+}
+export type AutomationLevel = 'full' | 'semi' | 'basic' | 'manual';
+/**
+ * Base Adapter Interface
+ *
+ * All adapters (Cursor, Generic) must implement this interface.
+ * Note: Claude Code is NOT an adapter - it's the native baseline experience.
+ */
+export interface IAdapter {
+    /**
+     * Adapter name (e.g., 'cursor', 'generic')
+     */
+    name: string;
+    /**
+     * Human-readable description of what this adapter provides
+     */
+    description: string;
+    /**
+     * Automation level this adapter provides
+     * - full: Complete automation (skills, agents, hooks auto-activate)
+     * - semi: Semi-automated (context shortcuts, multi-file editing)
+     * - basic: Basic automation (workspace instructions, suggestions)
+     * - manual: Manual workflow (step-by-step guide)
+     */
+    automationLevel: AutomationLevel;
+    /**
+     * Detect if this adapter's tool is present in the environment
+     *
+     * Examples:
+     * - Cursor: Check for .cursor/ directory or Cursor process
+     * - Generic: Always true (fallback for any tool)
+     *
+     * @returns Promise<boolean> True if tool detected
+     */
+    detect(): Promise<boolean>;
+    /**
+     * Check if system requirements are met for this adapter
+     *
+     * Examples:
+     * - Node.js version >= 18
+     * - Git installed
+     * - Tool-specific requirements
+     *
+     * @returns Promise<RequirementsResult> Requirements check result
+     */
+    checkRequirements(): Promise<RequirementsResult>;
+    /**
+     * Get list of files this adapter will install
+     *
+     * @returns AdapterFile[] Array of files to install
+     */
+    getFiles(): AdapterFile[];
+    /**
+     * Install this adapter to a project
+     *
+     * Creates tool-specific files (e.g., .cursorrules for Cursor, AGENTS.md for all)
+     * Installs relevant skills/agents if applicable
+     *
+     * @param options Installation options
+     * @returns Promise<void>
+     */
+    install(options: AdapterOptions): Promise<void>;
+    /**
+     * Post-installation actions
+     *
+     * Examples:
+     * - Create symlinks
+     * - Update config files
+     * - Display setup instructions to user
+     *
+     * @param options Installation options
+     * @returns Promise<void>
+     */
+    postInstall(options: AdapterOptions): Promise<void>;
+    /**
+     * Get human-readable instructions for using this adapter
+     *
+     * Displayed to user after installation
+     *
+     * @returns string Markdown-formatted instructions
+     */
+    getInstructions(): string;
+    /**
+     * Check if this adapter supports plugins
+     *
+     * Returns true if the adapter can install and compile plugins
+     * (Cursor AGENTS.md compilation, Generic AGENTS.md)
+     * Returns false for manual-only adapters
+     *
+     * @returns boolean True if plugins are supported
+     */
+    supportsPlugins(): boolean;
+    /**
+     * Compile and install a plugin for this adapter
+     *
+     * Transforms plugin content (skills/agents/commands) to tool-specific format:
+     * - Cursor: Compile to AGENTS.md + team commands JSON
+     * - Generic: Compile to AGENTS.md for Copilot/ChatGPT/Gemini
+     *
+     * Note: Claude Code uses native plugin system (no compilation needed)
+     *
+     * @param plugin Plugin to compile and install
+     * @returns Promise<void>
+     */
+    compilePlugin(plugin: Plugin): Promise<void>;
+    /**
+     * Unload (disable) a plugin for this adapter
+     *
+     * Removes plugin-specific files and restores previous state
+     *
+     * @param pluginName Name of plugin to unload
+     * @returns Promise<void>
+     */
+    unloadPlugin(pluginName: string): Promise<void>;
+    /**
+     * Get plugin installation status
+     *
+     * Returns information about which plugins are currently installed
+     *
+     * @returns Promise<string[]> Array of installed plugin names
+     */
+    getInstalledPlugins(): Promise<string[]>;
+}
+//# sourceMappingURL=adapter-interface.d.ts.map

package/dist/src/adapters/adapter-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-interface.d.ts","sourceRoot":"","sources":["../../../src/adapters/adapter-interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC;CAChD;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;;;;;;;OAQG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3B;;;;;;;;;OASG;IACH,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,IAAI,WAAW,EAAE,CAAC;IAE1B;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;OAUG;IACH,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;OAMG;IACH,eAAe,IAAI,MAAM,CAAC;IAE1B;;;;;;;;OAQG;IACH,eAAe,IAAI,OAAO,CAAC;IAE3B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;;;;;OAOG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;OAMG;IACH,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C"}

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

@@ -0,0 +1,8 @@
+/**
+ * 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/ChatGPT/Gemini via generic, etc.)
+ */
+export {};
+//# sourceMappingURL=adapter-interface.js.map

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

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