specweave 0.1.0

package/bin/install-agents.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# Install SpecWeave agents to .claude/agents/
+#
+# Usage:
+#   bash bin/install-agents.sh          # Install to .claude/agents/ (project)
+#   bash bin/install-agents.sh --global # Install to ~/.claude/agents/ (global)
+
+set -e
+
+AGENTS_SRC="src/agents"
+AGENTS_DEST=".claude/agents"
+
+# Parse arguments
+if [ "$1" = "--global" ]; then
+  AGENTS_DEST="$HOME/.claude/agents"
+  echo "Installing agents globally to $AGENTS_DEST"
+else
+  echo "Installing agents to project: $AGENTS_DEST"
+fi
+
+# Create destination if not exists
+mkdir -p "$AGENTS_DEST"
+
+# Check if source exists
+if [ ! -d "$AGENTS_SRC" ]; then
+  echo "❌ Error: $AGENTS_SRC directory not found"
+  exit 1
+fi
+
+# Count agents
+agent_count=0
+
+# Copy all agents
+for agent in "$AGENTS_SRC"/*; do
+  if [ -d "$agent" ]; then
+    agent_name=$(basename "$agent")
+
+    # Check if agent has AGENT.md or README.md
+    if [ -f "$agent/AGENT.md" ] || [ -f "$agent/README.md" ]; then
+      echo "  📦 Installing agent: $agent_name"
+      # Create destination directory and copy contents (not the folder itself)
+      mkdir -p "$AGENTS_DEST/$agent_name"
+      cp -r "$agent"/* "$AGENTS_DEST/$agent_name/"
+      agent_count=$((agent_count + 1))
+    else
+      echo "  ⚠️  Skipping $agent_name (no AGENT.md or README.md)"
+    fi
+  fi
+done
+
+echo ""
+echo "✅ Installed $agent_count agents to $AGENTS_DEST"
+echo ""
+echo "Agents installed:"
+ls -1 "$AGENTS_DEST" | sed 's/^/  - /'
+echo ""
+echo "To use agents, invoke via Task tool with subagent_type parameter"

package/bin/install-all.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Install all SpecWeave agents, skills, and commands
+#
+# Usage:
+#   bash bin/install-all.sh          # Install to .claude/ (project)
+#   bash bin/install-all.sh --global # Install to ~/.claude/ (global)
+
+set -e
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  SpecWeave Installation"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Pass arguments to subscripts
+INSTALL_MODE="$1"
+
+# Install agents
+echo "📦 Installing Agents..."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+bash bin/install-agents.sh $INSTALL_MODE
+
+echo ""
+
+# Install skills
+echo "🔧 Installing Skills..."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+bash bin/install-skills.sh $INSTALL_MODE
+
+echo ""
+
+# Install commands (only project-local, not global)
+if [ "$INSTALL_MODE" != "--global" ]; then
+  echo "⚡ Installing Slash Commands..."
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  bash bin/install-commands.sh
+  echo ""
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ SpecWeave installation complete!"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Next steps:"
+echo "  1. Restart Claude Code to load agents, skills, and commands"
+echo "  2. Try: 'Create a product vision for X' (activates PM agent)"
+echo "  3. Try: 'Plan implementation for feature Y' (activates increment-planner skill)"
+echo "  4. Try: '/create-project' to bootstrap a new project"
+echo ""

package/bin/install-commands.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+
+# SpecWeave Commands Installation Script
+# Installs all slash commands from src/templates/commands/ to .claude/commands/
+
+set -e
+
+COMMANDS_SRC="src/templates/commands"
+COMMANDS_DEST=".claude/commands"
+
+echo "════════════════════════════════════════════════════════"
+echo "  Installing SpecWeave Slash Commands"
+echo "════════════════════════════════════════════════════════"
+echo ""
+
+# Create destination directory
+mkdir -p "$COMMANDS_DEST"
+
+# Copy all .md files from templates/commands/
+installed_count=0
+
+for cmd_file in "$COMMANDS_SRC"/*.md; do
+  if [ -f "$cmd_file" ]; then
+    # Extract command name (filename without .md)
+    cmd_name=$(basename "$cmd_file" .md)
+
+    # Copy to .claude/commands/
+    cp "$cmd_file" "$COMMANDS_DEST/${cmd_name}.md"
+
+    echo "✅ Installed: /$cmd_name"
+    ((installed_count++))
+  fi
+done
+
+echo ""
+echo "════════════════════════════════════════════════════════"
+echo "  Installation Complete"
+echo "════════════════════════════════════════════════════════"
+echo ""
+echo "Installed $installed_count commands:"
+echo ""
+
+# List all installed commands
+ls -1 "$COMMANDS_DEST" | sed 's/.md$//' | sed 's/^/  \//'
+
+echo ""
+echo "Usage: Type /command-name in Claude Code"
+echo ""
+echo "Examples:"
+echo "  /create-project"
+echo "  /create-increment \"user authentication\""
+echo "  /review-docs"
+echo "  /sync-github"
+echo ""
+
+exit 0

package/bin/install-skills.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# Install SpecWeave skills to .claude/skills/
+#
+# Usage:
+#   bash bin/install-skills.sh          # Install to .claude/skills/ (project)
+#   bash bin/install-skills.sh --global # Install to ~/.claude/skills/ (global)
+
+set -e
+
+SKILLS_SRC="src/skills"
+SKILLS_DEST=".claude/skills"
+
+# Parse arguments
+if [ "$1" = "--global" ]; then
+  SKILLS_DEST="$HOME/.claude/skills"
+  echo "Installing skills globally to $SKILLS_DEST"
+else
+  echo "Installing skills to project: $SKILLS_DEST"
+fi
+
+# Create destination if not exists
+mkdir -p "$SKILLS_DEST"
+
+# Check if source exists
+if [ ! -d "$SKILLS_SRC" ]; then
+  echo "❌ Error: $SKILLS_SRC directory not found"
+  exit 1
+fi
+
+# Count skills
+skill_count=0
+
+# Copy all skills
+for skill in "$SKILLS_SRC"/*; do
+  if [ -d "$skill" ]; then
+    skill_name=$(basename "$skill")
+
+    # Check if skill has SKILL.md
+    if [ -f "$skill/SKILL.md" ]; then
+      echo "  🔧 Installing skill: $skill_name"
+      # Create destination directory and copy contents (not the folder itself)
+      mkdir -p "$SKILLS_DEST/$skill_name"
+      cp -r "$skill"/* "$SKILLS_DEST/$skill_name/"
+      skill_count=$((skill_count + 1))
+    else
+      echo "  ⚠️  Skipping $skill_name (no SKILL.md)"
+    fi
+  fi
+done
+
+echo ""
+echo "✅ Installed $skill_count skills to $SKILLS_DEST"
+echo ""
+echo "Skills installed:"
+ls -1 "$SKILLS_DEST" | sed 's/^/  - /'
+echo ""
+echo "Skills activate automatically based on their descriptions"

package/bin/specweave.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+/**
+ * SpecWeave CLI
+ *
+ * Entry point for the SpecWeave command-line interface.
+ * Provides commands for initializing projects, creating increments, and managing skills.
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const package = require('../package.json');
+
+const program = new Command();
+
+program
+  .name('specweave')
+  .description('Spec-Driven Development framework with AI-powered autonomous agents')
+  .version(package.version);
+
+// Init command - Create new SpecWeave project
+program
+  .command('init [project-name]')
+  .description('Initialize a new SpecWeave project')
+  .option('-t, --template <type>', 'Project template (saas, api, fullstack)', 'saas')
+  .action(async (projectName, options) => {
+    const { initCommand } = require('../dist/cli/commands/init');
+    await initCommand(projectName, options);
+  });
+
+// Increment commands (TODO: Implement in future versions)
+// program
+//   .command('increment <action> [name]')
+//   .description('Manage increments (create, list, status)')
+//   .option('-p, --priority <level>', 'Priority level (P1, P2, P3)', 'P1')
+//   .action(async (action, name, options) => {
+//     const { incrementCommand } = require('../dist/cli/commands/increment');
+//     await incrementCommand(action, name, options);
+//   });
+
+// Install command - Install agents/skills
+program
+  .command('install [component-name]')
+  .description('Install agents/skills to .claude/ or ~/.claude/')
+  .option('-g, --global', 'Install globally to ~/.claude/')
+  .option('-l, --local', 'Install locally to .claude/ (default)')
+  .action(async (componentName, options) => {
+    const { installCommand } = require('../dist/cli/commands/install');
+    await installCommand(componentName, options);
+  });
+
+// List command - List available/installed components
+program
+  .command('list')
+  .description('List available and installed components')
+  .option('--installed', 'Show only installed components')
+  .action(async (options) => {
+    const { listCommand } = require('../dist/cli/commands/list');
+    await listCommand(options);
+  });
+
+// Help text
+program.on('--help', () => {
+  console.log('');
+  console.log('Examples:');
+  console.log('  $ specweave init my-saas                    # Create new project');
+  console.log('  $ specweave install pm --local              # Install PM agent locally');
+  console.log('  $ specweave install --global                # Install all (interactive)');
+  console.log('  $ specweave list                            # List all available components');
+  console.log('  $ specweave list --installed                # Show installed components');
+  console.log('');
+  console.log('For more information, visit: https://github.com/specweave/specweave');
+});
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command specified
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

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

@@ -0,0 +1,50 @@
+/**
+ * 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';
+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>;
+}
+//# sourceMappingURL=adapter-base.d.ts.map

package/dist/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;AAIH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B,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;IA2BtD;;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;CAUnB"}

package/dist/adapters/adapter-base.js

@@ -0,0 +1,146 @@
+"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 {
+    /**
+     * 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 {
+            const { execSync } = require('child_process');
+            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;
+    }
+}
+exports.AdapterBase = AdapterBase;
+//# sourceMappingURL=adapter-base.js.map

package/dist/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/adapters/adapter-interface.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 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.)
+ */
+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 (Claude, Cursor, Copilot, Generic) must implement this interface.
+ */
+export interface IAdapter {
+    /**
+     * Adapter name (e.g., 'claude', 'cursor', 'copilot', '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:
+     * - Claude: Check for Claude Code CLI
+     * - Cursor: Check for .cursor/ directory or Cursor process
+     * - Copilot: Check for .github/copilot/ or Copilot extension
+     *
+     * @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, .github/copilot/instructions.md)
+     * 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;
+}
+//# sourceMappingURL=adapter-interface.d.ts.map

package/dist/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,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;;;;GAIG;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;;;;;;;;;OASG;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;CAC3B"}

package/dist/adapters/adapter-interface.js

@@ -0,0 +1,9 @@
+"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 });
+//# sourceMappingURL=adapter-interface.js.map

package/dist/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"}