specweave 0.12.7 → 0.13.0

package/dist/plugins/specweave-jira/lib/setup-wizard.js

@@ -0,0 +1,219 @@
+/**
+ * Smart Jira Setup Wizard
+ *
+ * Intelligent credential detection and setup flow:
+ * 1. Check .env for credentials (uses credentialsManager)
+ * 2. Interactive prompt only if missing
+ * 3. Never ask twice for same credentials
+ */
+import inquirer from 'inquirer';
+import { credentialsManager } from '../../../src/core/credentials-manager.js';
+// ============================================================================
+// Credential Detection
+// ============================================================================
+/**
+ * Smart credential detection - uses existing credentialsManager
+ */
+export async function detectJiraCredentials() {
+    if (credentialsManager.hasJiraCredentials()) {
+        try {
+            const credentials = credentialsManager.getJiraCredentials();
+            console.log('✅ Found Jira credentials in .env');
+            return {
+                found: true,
+                credentials,
+                source: 'env',
+            };
+        }
+        catch (error) {
+            // Credentials exist but invalid format
+            return { found: false };
+        }
+    }
+    return { found: false };
+}
+// ============================================================================
+// Interactive Setup
+// ============================================================================
+/**
+ * Interactive Jira credential setup
+ * Only runs if credentials not found
+ */
+export async function setupJiraCredentials() {
+    console.log('\n🔧 Jira Setup Wizard\n');
+    // Check for existing credentials first
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        // Ask user if they want to use existing or re-enter
+        const { useExisting } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'useExisting',
+                message: `Found credentials in ${detected.source}. Use these credentials?`,
+                default: true,
+            },
+        ]);
+        if (useExisting) {
+            return detected.credentials;
+        }
+        console.log('\n📝 Enter new credentials:\n');
+    }
+    else {
+        console.log('⚠️  No Jira credentials found\n');
+        console.log('📝 Let\'s set up your Jira connection:\n');
+    }
+    // Interactive credential entry
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'setupType',
+            message: 'How would you like to connect to Jira?',
+            choices: [
+                {
+                    name: 'Cloud (*.atlassian.net)',
+                    value: 'cloud',
+                },
+                {
+                    name: 'Server/Data Center (self-hosted)',
+                    value: 'server',
+                },
+            ],
+        },
+        {
+            type: 'input',
+            name: 'domain',
+            message: (answers) => answers.setupType === 'cloud'
+                ? 'Jira domain (e.g., mycompany.atlassian.net):'
+                : 'Jira server URL (e.g., jira.mycompany.com):',
+            validate: (value) => {
+                if (!value)
+                    return 'Domain is required';
+                if (answers.setupType === 'cloud' && !value.includes('.atlassian.net')) {
+                    return 'Cloud domain must end with .atlassian.net';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: 'Email address:',
+            validate: (value) => {
+                if (!value)
+                    return 'Email is required';
+                if (!value.includes('@'))
+                    return 'Must be a valid email';
+                return true;
+            },
+        },
+        {
+            type: 'password',
+            name: 'apiToken',
+            message: 'API token:',
+            mask: '*',
+            validate: (value) => {
+                if (!value)
+                    return 'API token is required';
+                if (value.length < 10)
+                    return 'API token seems too short';
+                return true;
+            },
+        },
+    ]);
+    const credentials = {
+        domain: answers.domain,
+        email: answers.email,
+        apiToken: answers.apiToken,
+    };
+    // Test connection
+    console.log('\n🔍 Testing connection...');
+    const isValid = await testJiraConnection(credentials);
+    if (!isValid) {
+        console.log('❌ Failed to connect to Jira');
+        console.log('💡 Please check your credentials and try again\n');
+        const { retry } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'retry',
+                message: 'Would you like to try again?',
+                default: true,
+            },
+        ]);
+        if (retry) {
+            return setupJiraCredentials();
+        }
+        throw new Error('Jira connection failed');
+    }
+    console.log('✅ Connection successful!\n');
+    // Save to .env using credentialsManager
+    await saveCredentialsToEnv(credentials);
+    return credentials;
+}
+/**
+ * Test Jira connection with credentials
+ */
+async function testJiraConnection(credentials) {
+    try {
+        const https = await import('https');
+        const auth = Buffer.from(`${credentials.email}:${credentials.apiToken}`).toString('base64');
+        return new Promise((resolve) => {
+            const req = https.request({
+                hostname: credentials.domain,
+                path: '/rest/api/3/myself',
+                method: 'GET',
+                headers: {
+                    Authorization: `Basic ${auth}`,
+                    'Content-Type': 'application/json',
+                },
+            }, (res) => {
+                resolve(res.statusCode === 200);
+            });
+            req.on('error', () => resolve(false));
+            req.setTimeout(5000, () => {
+                req.destroy();
+                resolve(false);
+            });
+            req.end();
+        });
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Save credentials to .env using credentialsManager
+ */
+async function saveCredentialsToEnv(credentials) {
+    console.log('💡 Save credentials to .env for future use\n');
+    const { saveToEnv } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'saveToEnv',
+            message: 'Save credentials to .env file?',
+            default: true,
+        },
+    ]);
+    if (saveToEnv) {
+        credentialsManager.saveToEnvFile({ jira: credentials });
+        console.log('✅ Credentials saved to .env');
+        console.log('✅ .env added to .gitignore');
+    }
+    else {
+        console.log('⚠️  Credentials not saved. You\'ll need to enter them again next time.');
+    }
+}
+// ============================================================================
+// Export Helpers
+// ============================================================================
+/**
+ * Get Jira credentials - smart detection with fallback to interactive setup
+ */
+export async function getJiraCredentials() {
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        return detected.credentials;
+    }
+    // Not found - run interactive setup
+    return setupJiraCredentials();
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/plugins/specweave-jira/lib/setup-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.js","sourceRoot":"","sources":["../../../../plugins/specweave-jira/lib/setup-wizard.ts"],"names":[],"mappings":"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"}

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"}