specweave 0.1.9 → 0.3.1

package/dist/adapters/codex/adapter.js

@@ -0,0 +1,316 @@
+/**
+ * Codex Adapter (OpenAI)
+ *
+ * Semi-automation adapter for OpenAI Codex (ChatGPT Code Interpreter/Codex CLI).
+ * Uses universal AGENTS.md file for instructions.
+ *
+ * Codex features:
+ * - Works in CLI, IDE, web, GitHub, iOS app
+ * - GPT-5-Codex optimized for engineering tasks
+ * - File read/write operations
+ * - Test execution and validation
+ * - Task-based isolated environments
+ */
+import * as path from 'path';
+import fs from 'fs-extra';
+import { AdapterBase } from '../adapter-base.js';
+import { AgentsMdGenerator } from '../agents-md-generator.js';
+import { getDirname } from '../../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+export class CodexAdapter extends AdapterBase {
+    constructor() {
+        super(...arguments);
+        this.name = 'codex';
+        this.description = 'OpenAI Codex adapter - Semi-automation with AGENTS.md and task-based execution';
+        this.automationLevel = 'semi';
+    }
+    /**
+     * Detect if Codex is available
+     *
+     * Checks for:
+     * - codex command in PATH (Codex CLI)
+     * - .codex/ directory exists
+     * - AGENTS.md file exists (previously configured)
+     */
+    async detect() {
+        const hasCodexCLI = await this.commandExists('codex');
+        const hasCodexDir = await this.fileExists('.codex');
+        const hasAgentsMd = await this.fileExists('AGENTS.md');
+        return hasCodexCLI || hasCodexDir || hasAgentsMd;
+    }
+    /**
+     * Get files to install for Codex adapter
+     */
+    getFiles() {
+        return [
+            {
+                sourcePath: 'AGENTS.md',
+                targetPath: 'AGENTS.md',
+                description: 'Universal SpecWeave instructions (works with all AI tools)'
+            },
+            {
+                sourcePath: 'README.md',
+                targetPath: '.codex/README.md',
+                description: 'Codex adapter documentation'
+            }
+        ];
+    }
+    /**
+     * Install Codex adapter
+     */
+    async install(options) {
+        console.log('\n📦 Installing OpenAI Codex Adapter (Semi-Automation)\n');
+        // Ensure .codex directory exists
+        const codexDir = path.join(options.projectPath, '.codex');
+        await fs.ensureDir(codexDir);
+        // Generate AGENTS.md
+        const agentsMdPath = path.join(options.projectPath, 'AGENTS.md');
+        await this.generateAgentsMd(agentsMdPath, options);
+        // Copy README
+        const readmePath = path.join(__dirname, 'README.md');
+        if (await fs.pathExists(readmePath)) {
+            await fs.copy(readmePath, path.join(codexDir, 'README.md'));
+        }
+        console.log('\n✨ Codex adapter installed!');
+        console.log('\n📋 Files created:');
+        console.log('   - AGENTS.md (universal instructions)');
+        console.log('   - .codex/README.md (adapter documentation)');
+    }
+    /**
+     * Generate AGENTS.md file
+     */
+    async generateAgentsMd(targetPath, options) {
+        const generator = new AgentsMdGenerator(path.join(__dirname, '../../skills'), path.join(__dirname, '../../agents'), path.join(__dirname, '../../commands'));
+        const content = await generator.generate({
+            projectName: options.projectName,
+            projectPath: options.projectPath
+        });
+        await fs.writeFile(targetPath, content);
+        console.log('  ✅ AGENTS.md - Universal SpecWeave instructions');
+    }
+    /**
+     * Post-installation instructions
+     */
+    async postInstall(options) {
+        console.log(this.getInstructions());
+    }
+    /**
+     * Get usage instructions for Codex adapter
+     */
+    getInstructions() {
+        return `
+================================================================
+      OpenAI Codex Adapter - Semi-Automation
+================================================================
+
+Your project is now configured for OpenAI Codex with SEMI-automation!
+
+WHAT THIS PROVIDES:
+
+- AGENTS.md (Universal Instructions)
+  - Works with Codex CLI, ChatGPT web, and IDEs
+  - Auto-generated from actual skills/agents
+  - SpecWeave structure and workflows
+  - GPT-5-Codex optimized guidance
+
+- Task-Based Execution
+  - Isolated environments per task
+  - File read/write operations
+  - Test execution and validation
+
+QUICK START:
+
+**Option 1: Codex CLI** (Fastest)
+
+1. Install Codex CLI:
+
+   # Included with ChatGPT Plus, Pro, Business, Enterprise
+   npm install -g openai-codex-cli
+
+2. Create your first feature:
+
+   codex "Read AGENTS.md and create increment for user authentication"
+
+   Codex will:
+   - Read AGENTS.md for SpecWeave context
+   - Adopt PM role: Create spec.md (WHAT/WHY)
+   - Adopt Architect role: Create plan.md (HOW)
+   - Create tasks.md
+   - Execute in isolated environment
+
+**Option 2: ChatGPT Web** (Most Accessible)
+
+1. Open ChatGPT (Plus/Pro/Business/Enterprise)
+
+2. Upload AGENTS.md file
+
+3. Say:
+   "I'm using SpecWeave framework. Create increment for user authentication."
+
+4. Copy generated content to files:
+   - spec.md
+   - plan.md
+   - tasks.md
+
+**Option 3: IDE Integration** (If available in your IDE)
+
+Use Codex integration in your IDE (VS Code, JetBrains, etc.)
+Reference AGENTS.md for SpecWeave structure.
+
+HOW TO USE:
+
+**With Codex CLI**:
+\`\`\`bash
+# Explicit reference (recommended):
+codex "Read AGENTS.md and [your request]"
+
+# Natural language:
+codex "Create a new feature following SpecWeave structure"
+
+# With context:
+codex "Following the PM role in AGENTS.md, create requirements for payments"
+\`\`\`
+
+**With ChatGPT Web**:
+1. Upload AGENTS.md at start of conversation
+2. Reference it: "Following AGENTS.md, create increment for..."
+3. Download or copy-paste generated files
+
+CONTEXT LOADING (70%+ Token Savings):
+
+CRITICAL: Tell Codex to read context-manifest.yaml first!
+
+\`\`\`bash
+# CLI:
+codex "Read context-manifest.yaml from increment 0001, load only those files, then implement task T001"
+
+# Web:
+# 1. Upload context-manifest.yaml
+# 2. Upload only files listed in manifest
+# 3. Request task implementation
+\`\`\`
+
+FEATURES:
+
+✅ GPT-5-Codex Model
+   - Optimized for engineering tasks
+   - Trained on complex, real-world projects
+   - Code generation, debugging, refactoring
+
+✅ Task-Based Execution
+   - Each task in isolated environment
+   - Real-time progress monitoring
+   - Verifiable evidence (citations, logs)
+
+✅ File Operations
+   - Read and edit files
+   - Run commands (tests, linters, type checkers)
+   - Create new files and directories
+
+✅ Multiple Access Points
+   - CLI (fastest)
+   - Web (most accessible)
+   - IDE (most integrated)
+   - GitHub (for PRs)
+   - iOS app (mobile)
+
+✅ Test Execution
+   - Run test harnesses
+   - Validate implementations
+   - Ensure quality
+
+EXAMPLE WORKFLOWS:
+
+1. **Create Feature (CLI)**:
+   \`\`\`bash
+   codex "Read AGENTS.md. Create increment 0002 for payment processing with Stripe. Follow SpecWeave structure."
+   \`\`\`
+
+2. **Create Feature (Web)**:
+   - Upload AGENTS.md
+   - Say: "Create increment for payment processing"
+   - Download generated files
+
+3. **Implement Task**:
+   \`\`\`bash
+   codex "Read increment 0002, implement task T001 (Setup Stripe SDK)"
+   \`\`\`
+
+4. **Fix Bug**:
+   \`\`\`bash
+   codex "Read AGENTS.md and increment 0001. Fix authentication bug. Run tests."
+   \`\`\`
+
+5. **Code Review**:
+   \`\`\`bash
+   codex "Adopt Tech Lead role from AGENTS.md. Review src/auth/ code."
+   \`\`\`
+
+TIPS & TRICKS:
+
+1. **Always Reference AGENTS.md**
+   - CLI: Explicit in command
+   - Web: Upload at conversation start
+
+2. **Use Task-Based Approach**
+   - Break work into tasks (T001, T002, etc.)
+   - Each task runs in isolated environment
+   - Easier to track and validate
+
+3. **Monitor Progress**
+   - CLI shows real-time progress (1-30 minutes per task)
+   - Web shows thinking process
+   - Review citations and logs
+
+4. **Leverage Multiple Access Points**
+   - CLI for speed
+   - Web for accessibility
+   - IDE for integration
+
+5. **Validate with Tests**
+   - Codex can run tests automatically
+   - Verify implementations work
+
+COMPARISON:
+
+| Feature | Claude Code | Codex |
+|---------|-------------|-------|
+| **Automation** | Full | Semi |
+| **Skills** | Native | Via AGENTS.md |
+| **Agents** | Native | Via AGENTS.md |
+| **Access** | CLI only | CLI + Web + IDE + GitHub + iOS |
+| **Model** | Sonnet 4.5 | GPT-5-Codex |
+| **Task Isolation** | No | Yes (isolated environments) |
+
+LIMITATIONS:
+
+- No native skills/agents (manual role adoption via AGENTS.md)
+- No hooks (can't auto-update docs on events)
+- Tasks run 1-30 minutes (not instant)
+- Requires ChatGPT Plus/Pro/Business/Enterprise
+
+But very powerful with GPT-5-Codex and multiple access points!
+
+PLANS & PRICING:
+
+- **ChatGPT Plus**: $20/month (includes Codex CLI + Web)
+- **ChatGPT Pro**: $200/month (unlimited, faster)
+- **Business/Enterprise**: Custom pricing
+
+Free trial may be available - check OpenAI website.
+
+DOCUMENTATION:
+
+- AGENTS.md: Universal SpecWeave instructions (READ THIS!)
+- SPECWEAVE.md: Complete framework documentation
+- .codex/README.md: Codex adapter guide
+- https://openai.com/codex/
+
+You're ready to build with SpecWeave on OpenAI Codex!
+
+Pro tip: Use CLI for speed, Web for accessibility, and always
+reference AGENTS.md for SpecWeave structure!
+    `;
+    }
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

@@ -2,14 +2,12 @@
  * GitHub Copilot Adapter
  *
  * Basic automation adapter for GitHub Copilot.
- * Provides workspace instructions that Copilot reads for context and suggestions.
+ * Copilot automatically reads AGENTS.md (universal standard) for context and suggestions.
  *
- * Since GitHub Copilot has limited configuration (workspace instructions only),
- * this adapter focuses on clear, structured guidance that Copilot can use
- * to provide better code suggestions and completions.
+ * This adapter requires no additional files - Copilot reads AGENTS.md automatically.
  */
-import { AdapterBase } from '../adapter-base';
-import { AdapterOptions, AdapterFile } from '../adapter-interface';
+import { AdapterBase } from '../adapter-base.js';
+import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
 export declare class CopilotAdapter extends AdapterBase {
     name: string;
     description: string;
@@ -17,13 +15,16 @@ export declare class CopilotAdapter extends AdapterBase {
     /**
      * Detect if GitHub Copilot is available
      *
-     * Checks for:
-     * - .github/copilot/instructions.md exists
-     * - VS Code with Copilot extension
+     * Note: Detection is best-effort since Copilot might be installed
+     * but we can't detect it reliably. This adapter is safe to use
+     * as a fallback since Copilot reads AGENTS.md (universal standard).
      */
     detect(): Promise<boolean>;
     /**
      * Get files to install for Copilot adapter
+     *
+     * Note: Copilot automatically reads AGENTS.md (universal standard).
+     * No additional files needed.
      */
     getFiles(): AdapterFile[];
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/copilot/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnE,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,SAAa;IACjB,WAAW,SAA2E;IACtF,eAAe,EAAG,OAAO,CAAU;IAEnC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAShC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAezB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAerD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CA8H1B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/copilot/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtE,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,SAAa;IACjB,WAAW,SAA8D;IACzE,eAAe,EAAG,OAAO,CAAU;IAEnC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAMhC;;;;;OAKG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAsH1B"}

package/dist/adapters/copilot/adapter.js

@@ -1,103 +1,47 @@
-"use strict";
 /**
  * GitHub Copilot Adapter
  *
  * Basic automation adapter for GitHub Copilot.
- * Provides workspace instructions that Copilot reads for context and suggestions.
+ * Copilot automatically reads AGENTS.md (universal standard) for context and suggestions.
  *
- * Since GitHub Copilot has limited configuration (workspace instructions only),
- * this adapter focuses on clear, structured guidance that Copilot can use
- * to provide better code suggestions and completions.
+ * This adapter requires no additional files - Copilot reads AGENTS.md automatically.
  */
-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.CopilotAdapter = void 0;
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs-extra"));
-const adapter_base_1 = require("../adapter-base");
-class CopilotAdapter extends adapter_base_1.AdapterBase {
+import { AdapterBase } from '../adapter-base.js';
+export class CopilotAdapter extends AdapterBase {
     constructor() {
         super(...arguments);
         this.name = 'copilot';
-        this.description = 'GitHub Copilot adapter - Basic automation with workspace instructions';
+        this.description = 'GitHub Copilot adapter - Basic automation with AGENTS.md';
         this.automationLevel = 'basic';
     }
     /**
      * Detect if GitHub Copilot is available
      *
-     * Checks for:
-     * - .github/copilot/instructions.md exists
-     * - VS Code with Copilot extension
+     * Note: Detection is best-effort since Copilot might be installed
+     * but we can't detect it reliably. This adapter is safe to use
+     * as a fallback since Copilot reads AGENTS.md (universal standard).
      */
     async detect() {
-        const hasInstructions = await this.fileExists('.github/copilot/instructions.md');
-        const hasGitHubDir = await this.fileExists('.github');
-        // Check for VS Code Copilot extension (best effort)
-        // This is approximate - Copilot might be installed but we can't detect reliably
-        return hasInstructions || hasGitHubDir;
+        // Always return false to make this a manual selection
+        // Users can explicitly choose Copilot adapter if they want
+        return false;
     }
     /**
      * Get files to install for Copilot adapter
+     *
+     * Note: Copilot automatically reads AGENTS.md (universal standard).
+     * No additional files needed.
      */
     getFiles() {
-        return [
-            {
-                sourcePath: '.github/copilot/instructions.md',
-                targetPath: '.github/copilot/instructions.md',
-                description: 'GitHub Copilot workspace instructions'
-            },
-            {
-                sourcePath: 'README.md',
-                targetPath: '.github/copilot/README.md',
-                description: 'Copilot adapter documentation'
-            }
-        ];
+        return [];
     }
     /**
      * Install Copilot adapter
      */
     async install(options) {
-        console.log('\n📦 Installing GitHub Copilot Adapter (Basic Automation)\n');
-        // Ensure .github/copilot directory exists
-        const copilotDir = path.join(options.projectPath, '.github', 'copilot');
-        await fs.ensureDir(copilotDir);
-        // Copy files
-        await super.install(options);
-        console.log('\n✨ Copilot adapter installed!');
-        console.log('\n📋 Files created:');
-        console.log('   - .github/copilot/instructions.md (workspace guidance)');
+        console.log('\n📦 Configuring GitHub Copilot (Basic Automation)\n');
+        // No files to install - Copilot reads AGENTS.md automatically
+        console.log('✅ Copilot will automatically read AGENTS.md');
     }
     /**
      * Post-installation instructions
@@ -118,14 +62,14 @@ Your project is now configured for GitHub Copilot!
 
 WHAT THIS PROVIDES:
 
-- Workspace Instructions (.github/copilot/instructions.md)
-  - Project overview (SpecWeave framework)
-  - Workflow guidance (creating increments)
-  - Context manifest explanation
-  - File structure reference
+- AGENTS.md (Universal Standard)
+  - Copilot automatically reads this file
+  - Contains all workflow instructions
+  - Project structure and templates
+  - Following agents.md standard (https://agents.md/)
 
 - Better Code Suggestions
-  - Copilot reads workspace instructions
+  - Copilot reads AGENTS.md for context
   - Suggests code following SpecWeave patterns
   - Understands project structure
 
@@ -135,26 +79,22 @@ Claude Code (Full Automation):
 - Native skills (auto-activate)
 - Native agents (separate context windows)
 - Native hooks (auto-update docs)
-- Slash commands
+- Slash commands (/inc, /do, /done)
 
 Cursor (Semi-Automation):
-- Simulated skills (.cursorrules)
-- Simulated agents (manual roles)
+- Reads AGENTS.md for workflow
 - @ context shortcuts
+- Composer multi-file editing
 
 Copilot (Basic Automation - This Adapter):
-- Workspace instructions only
+- Reads AGENTS.md automatically
 - Better code suggestions
 - No skills, agents, hooks, or commands
 - Manual workflow with AI assistance
 
-HOW WE BRIDGE THE GAP:
-
-GitHub Copilot doesn't support custom commands or complex
-workflows. But it DOES read workspace instructions to provide
-better code suggestions.
+HOW COPILOT USES AGENTS.MD:
 
-We provide clear instructions that teach Copilot about:
+GitHub Copilot automatically reads AGENTS.md to understand:
 - SpecWeave structure (.specweave/ folders)
 - File naming conventions (spec.md, plan.md, tasks.md)
 - Context manifests (what files to reference)
@@ -164,12 +104,11 @@ Result: Copilot suggests code that fits SpecWeave patterns!
 
 HOW TO USE SPECWEAVE WITH COPILOT:
 
-1. Copilot reads workspace instructions automatically
+1. Copilot reads AGENTS.md automatically
    - No action needed - just open project in VS Code
    - Copilot will suggest code following SpecWeave patterns
 
 2. Create increments manually:
-
    mkdir -p .specweave/increments/0001-user-auth
 
 3. Reference context manifests:
@@ -184,20 +123,19 @@ HOW TO USE SPECWEAVE WITH COPILOT:
 
 5. Use Copilot inline suggestions:
    Start typing in spec.md → Copilot suggests content
-   Following SpecWeave patterns from instructions.md
+   Following SpecWeave patterns from AGENTS.md
 
 WORKFLOW EXAMPLE:
 
 Creating a Feature:
 
 1. Create increment folder:
-
    mkdir -p .specweave/increments/0002-payments
    cd .specweave/increments/0002-payments
 
 2. Create spec.md:
    - Open file, start typing frontmatter
-   - Copilot suggests SpecWeave structure
+   - Copilot suggests SpecWeave structure (from AGENTS.md)
    - Fill in user stories, acceptance criteria
 
 3. Create plan.md:
@@ -218,14 +156,12 @@ LIMITATIONS (vs Claude Code & Cursor):
 - Completely manual workflow
 
 But Copilot still provides helpful suggestions!
-- Understands SpecWeave structure from instructions
+- Understands SpecWeave structure from AGENTS.md
 - Suggests code following project patterns
 
 DOCUMENTATION:
 
-- SPECWEAVE.md: Complete development guide
-- .github/copilot/instructions.md: Workspace instructions
-- .github/copilot/README.md: Copilot adapter guide
+- AGENTS.md: Universal workflow instructions (Copilot reads this!)
 - .specweave/docs/: Project documentation
 
 You're ready to build with SpecWeave on GitHub Copilot!
@@ -235,5 +171,4 @@ Copilot is best for simple projects or when already using VS Code + Copilot.
     `;
     }
 }
-exports.CopilotAdapter = CopilotAdapter;
 //# sourceMappingURL=adapter.js.map

package/dist/adapters/copilot/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/copilot/adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,2CAA6B;AAC7B,6CAA+B;AAC/B,kDAA8C;AAG9C,MAAa,cAAe,SAAQ,0BAAW;IAA/C;;QACE,SAAI,GAAG,SAAS,CAAC;QACjB,gBAAW,GAAG,uEAAuE,CAAC;QACtF,oBAAe,GAAG,OAAgB,CAAC;IA8LrC,CAAC;IA5LC;;;;;;OAMG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;QACjF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEtD,oDAAoD;QACpD,gFAAgF;QAChF,OAAO,eAAe,IAAI,YAAY,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE,iCAAiC;gBAC7C,UAAU,EAAE,iCAAiC;gBAC7C,WAAW,EAAE,uCAAuC;aACrD;YACD;gBACE,UAAU,EAAE,WAAW;gBACvB,UAAU,EAAE,2BAA2B;gBACvC,WAAW,EAAE,+BAA+B;aAC7C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAE3E,0CAA0C;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACxE,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAE/B,aAAa;QACb,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IAC3E,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2HN,CAAC;IACJ,CAAC;CACF;AAjMD,wCAiMC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/copilot/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,OAAO,cAAe,SAAQ,WAAW;IAA/C;;QACE,SAAI,GAAG,SAAS,CAAC;QACjB,gBAAW,GAAG,0DAA0D,CAAC;QACzE,oBAAe,GAAG,OAAgB,CAAC;IAmKrC,CAAC;IAjKC;;;;;;OAMG;IACH,KAAK,CAAC,MAAM;QACV,sDAAsD;QACtD,2DAA2D;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QAEpE,8DAA8D;QAC9D,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC7D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmHN,CAAC;IACJ,CAAC;CACF"}

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

@@ -2,13 +2,13 @@
  * Cursor Adapter
  *
  * Semi-automation adapter for Cursor editor.
- * Provides workflow instructions via .cursorrules and @ context shortcuts.
+ * Provides @ context shortcuts for quick context injection.
  *
- * Since Cursor doesn't natively support Claude Code's skills/agents/hooks,
- * this adapter teaches Cursor HOW TO BEHAVE LIKE it has these capabilities.
+ * Cursor automatically reads AGENTS.md (universal standard) for workflow instructions.
+ * This adapter only installs Cursor-specific features (@ shortcuts).
  */
-import { AdapterBase } from '../adapter-base';
-import { AdapterOptions, AdapterFile } from '../adapter-interface';
+import { AdapterBase } from '../adapter-base.js';
+import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
 export declare class CursorAdapter extends AdapterBase {
     name: string;
     description: string;
@@ -19,11 +19,13 @@ export declare class CursorAdapter extends AdapterBase {
      * Checks for:
      * - cursor command in PATH
      * - .cursor/ directory exists
-     * - .cursorrules file 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[];
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/cursor/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnE,qBAAa,aAAc,SAAQ,WAAW;IAC5C,IAAI,SAAY;IAChB,WAAW,SAAgF;IAC3F,eAAe,EAAG,MAAM,CAAU;IAElC;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAQhC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAmCzB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAmK1B"}
+{"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;AAEtE,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;CA0H1B"}