specweave 0.13.5 → 0.14.0

package/dist/src/adapters/claude-md-generator.js

@@ -1,307 +0,0 @@
-/**
- * CLAUDE.md Generator
- *
- * Generates CLAUDE.md - the PRIMARY instruction file for Claude Code.
- *
- * CRITICAL:
- * - Claude Code ONLY reads CLAUDE.md (NOT AGENTS.md)
- * - This is the native/baseline implementation (skills, agents, hooks, slash commands)
- * - Claude Code is NOT an adapter - it's the gold standard that others try to approximate
- *
- * This generator creates a quick reference that lists what's actually installed,
- * so when we add new agents/skills, CLAUDE.md stays in sync automatically.
- */
-import { DocGenerator } from './doc-generator.js';
-import * as path from 'path';
-import fs from 'fs-extra';
-import { getDirname } from '../utils/esm-helpers.js';
-const __dirname = getDirname(import.meta.url);
-/**
- * Find the package root by walking up the directory tree looking for package.json
- * This works reliably on all platforms including Windows with UNC paths
- */
-function findPackageRoot(startDir) {
-    let currentDir = startDir;
-    const root = path.parse(currentDir).root;
-    while (currentDir !== root) {
-        const packageJsonPath = path.join(currentDir, 'package.json');
-        if (fs.existsSync(packageJsonPath)) {
-            try {
-                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-                // Verify this is the specweave package
-                if (packageJson.name === 'specweave') {
-                    return currentDir;
-                }
-            }
-            catch (error) {
-                // Not a valid package.json, continue searching
-            }
-        }
-        const parentDir = path.dirname(currentDir);
-        if (parentDir === currentDir)
-            break; // Reached root
-        currentDir = parentDir;
-    }
-    return null;
-}
-/**
- * Find template file using package root detection
- */
-function findTemplateFile(filename) {
-    const packageRoot = findPackageRoot(__dirname);
-    if (packageRoot) {
-        // Try src/templates/ first (for npm installs)
-        const srcPath = path.normalize(path.join(packageRoot, 'src', 'templates', filename));
-        if (fs.existsSync(srcPath)) {
-            return srcPath;
-        }
-        // Try dist/templates/ (shouldn't exist but try anyway)
-        const distPath = path.normalize(path.join(packageRoot, 'dist', 'templates', filename));
-        if (fs.existsSync(distPath)) {
-            return distPath;
-        }
-        // Try templates/ directly in package root
-        const rootPath = path.normalize(path.join(packageRoot, 'templates', filename));
-        if (fs.existsSync(rootPath)) {
-            return rootPath;
-        }
-    }
-    return null;
-}
-/**
- * Generate CLAUDE.md with dynamic agent/skill sections
- */
-export class ClaudeMdGenerator {
-    constructor(skillsDir, agentsDir, commandsDir) {
-        this.docGen = new DocGenerator(skillsDir, agentsDir, commandsDir);
-    }
-    /**
-     * Generate complete CLAUDE.md content
-     */
-    async generate(options) {
-        // Read template - use provided path or find it via package root
-        let templatePath = options.templatePath;
-        if (!templatePath || !await fs.pathExists(templatePath)) {
-            // Fallback: try to find template using package root detection
-            const foundPath = findTemplateFile('CLAUDE.md.template');
-            if (foundPath) {
-                templatePath = foundPath;
-            }
-            else {
-                const errorMsg = options.templatePath
-                    ? `CLAUDE.md template not found at: ${options.templatePath}\nAlso tried package root detection but failed.`
-                    : `CLAUDE.md template not found. Tried:\n  - Package root detection\n  - __dirname: ${__dirname}\n  - Default: ${path.join(__dirname, '../templates/CLAUDE.md.template')}`;
-                throw new Error(errorMsg);
-            }
-        }
-        let content = await fs.readFile(templatePath, 'utf-8');
-        // Replace placeholders
-        content = content.replace(/\{PROJECT_NAME\}/g, options.projectName);
-        // Replace dynamic sections
-        content = await this.replaceDynamicSections(content);
-        return content;
-    }
-    /**
-     * Replace dynamic sections in template
-     */
-    async replaceDynamicSections(content) {
-        // Extract actual skills and agents
-        const skills = await this.docGen.extractSkills();
-        const agents = await this.docGen.extractAgents();
-        const commands = await this.docGen.extractCommands();
-        // Replace agents section (lines 226-243 in template)
-        content = this.replaceAgentsSection(content, agents);
-        // Replace skills section (lines 248-278 in template)
-        content = this.replaceSkillsSection(content, skills);
-        // Replace commands section if needed
-        content = this.replaceCommandsSection(content, commands);
-        return content;
-    }
-    /**
-     * Generate dynamic agents section
-     */
-    replaceAgentsSection(content, agents) {
-        const agentsTable = this.generateAgentsTable(agents);
-        // Find the agents section and replace it
-        // Look for "## Agents (Activate Automatically)" section
-        const agentsSectionRegex = /## Agents \(Activate Automatically\)[\s\S]*?(?=\n## |$)/;
-        const agentsSection = `## Agents (Activate Automatically)
-
-**Strategic Agents** (pre-installed & ready to use):
-
-${agentsTable}
-
-**All ${agents.length} agents are pre-installed** - Claude uses the right one based on your request!
-
-**See**: \`.claude/agents/\` for complete list
-
----
-`;
-        if (agentsSectionRegex.test(content)) {
-            return content.replace(agentsSectionRegex, agentsSection);
-        }
-        return content;
-    }
-    /**
-     * Generate agents table
-     */
-    generateAgentsTable(agents) {
-        let table = '| Agent | Purpose | Activates When |\n';
-        table += '|-------|---------|----------------|\n';
-        for (const agent of agents) {
-            const activation = this.getAgentActivation(agent.name);
-            table += `| \`${agent.name}\` | ${agent.description} | ${activation} |\n`;
-        }
-        return table;
-    }
-    /**
-     * Get agent activation guidance
-     */
-    getAgentActivation(agentName) {
-        const activations = {
-            'pm': 'Planning features',
-            'architect': 'Technical design',
-            'security': 'Security review',
-            'qa-lead': 'Testing',
-            'devops': 'Deployment needed',
-            'tech-lead': 'Code review',
-            'sre': 'Troubleshooting',
-            'docs-writer': 'Writing docs',
-            'performance': 'Optimization needed',
-            'frontend': 'Frontend development',
-            'nodejs-backend': 'Node.js backend',
-            'python-backend': 'Python backend',
-            'nextjs': 'Next.js development',
-            'dotnet-backend': '.NET development'
-        };
-        return activations[agentName] || 'Specialized tasks';
-    }
-    /**
-     * Generate dynamic skills section
-     */
-    replaceSkillsSection(content, skills) {
-        const skillsTable = this.generateSkillsTable(skills);
-        // Find the skills section and replace it
-        const skillsSectionRegex = /## Skills \(Activate Automatically\)[\s\S]*?(?=\n## |$)/;
-        const skillsSection = `## Skills (Activate Automatically)
-
-**Framework Skills** (always available):
-
-${this.generateFrameworkSkillsTable(skills)}
-
-**Technology Skills** (all pre-installed):
-
-${this.generateTechSkillsTable(skills)}
-
-**Integration Skills** (all pre-installed):
-
-${this.generateIntegrationSkillsTable(skills)}
-
-**See**: \`.claude/skills/\` for complete list of ${skills.length}+ skills!
-
----
-`;
-        if (skillsSectionRegex.test(content)) {
-            return content.replace(skillsSectionRegex, skillsSection);
-        }
-        return content;
-    }
-    /**
-     * Generate framework skills table
-     */
-    generateFrameworkSkillsTable(skills) {
-        const frameworkSkills = skills.filter(s => ['specweave-detector', 'increment-planner', 'context-loader', 'skill-router',
-            'spec-driven-debugging', 'spec-driven-brainstorming', 'brownfield-analyzer'].includes(s.name));
-        let table = '| Skill | Purpose | Activates When |\n';
-        table += '|-------|---------|----------------|\n';
-        for (const skill of frameworkSkills) {
-            const activation = this.getSkillActivation(skill.name);
-            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 60)} | ${activation} |\n`;
-        }
-        return table;
-    }
-    /**
-     * Generate tech skills table
-     */
-    generateTechSkillsTable(skills) {
-        const techSkills = skills.filter(s => ['nodejs-backend', 'python-backend', 'nextjs', 'frontend', 'dotnet-backend',
-            'e2e-playwright'].includes(s.name));
-        let table = '| Skill | Purpose | Activates When |\n';
-        table += '|-------|---------|----------------|\n';
-        for (const skill of techSkills) {
-            const activation = this.getSkillActivation(skill.name);
-            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 60)} | ${activation} |\n`;
-        }
-        return table;
-    }
-    /**
-     * Generate integration skills table
-     */
-    generateIntegrationSkillsTable(skills) {
-        const integrationSkills = skills.filter(s => ['jira-sync', 'github-sync', 'ado-sync', 'hetzner-provisioner',
-            'cost-optimizer', 'figma-mcp-connector'].includes(s.name));
-        let table = '| Skill | Purpose | Activates When |\n';
-        table += '|-------|---------|----------------|\n';
-        for (const skill of integrationSkills) {
-            const activation = this.getSkillActivation(skill.name);
-            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 60)} | ${activation} |\n`;
-        }
-        return table;
-    }
-    /**
-     * Get skill activation guidance
-     */
-    getSkillActivation(skillName) {
-        const activations = {
-            'specweave-detector': 'User asks about SpecWeave',
-            'increment-planner': '/pi or feature planning',
-            'context-loader': 'Working on increments',
-            'skill-router': 'Ambiguous requests',
-            'spec-driven-debugging': 'Bug or test failure',
-            'spec-driven-brainstorming': 'Brainstorm or refine idea',
-            'nodejs-backend': 'Node.js backend',
-            'python-backend': 'Python backend',
-            'nextjs': 'Next.js',
-            'frontend': 'Frontend',
-            'dotnet-backend': '.NET',
-            'jira-sync': 'JIRA integration',
-            'github-sync': 'GitHub integration',
-            'ado-sync': 'Azure DevOps sync',
-            'hetzner-provisioner': 'Hetzner deployment',
-            'cost-optimizer': 'Cost optimization',
-            'e2e-playwright': 'E2E testing'
-        };
-        return activations[skillName] || 'Specialized tasks';
-    }
-    /**
-     * Generate skills table
-     */
-    generateSkillsTable(skills) {
-        let table = '| Skill | Description |\n';
-        table += '|-------|-------------|\n';
-        for (const skill of skills.slice(0, 20)) { // Top 20 skills
-            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 80)} |\n`;
-        }
-        if (skills.length > 20) {
-            table += `| _...and ${skills.length - 20} more_ | See \`.claude/skills/\` |\n`;
-        }
-        return table;
-    }
-    /**
-     * Replace commands section
-     */
-    replaceCommandsSection(content, commands) {
-        // Commands are already listed in the template, but we could make them dynamic too
-        // For now, we'll skip this since commands are explicitly documented
-        return content;
-    }
-    /**
-     * Truncate text to max length
-     */
-    truncate(text, maxLength) {
-        if (text.length <= maxLength)
-            return text;
-        return text.substring(0, maxLength - 3) + '...';
-    }
-}
-//# sourceMappingURL=claude-md-generator.js.map

package/dist/src/adapters/claude-md-generator.js.map

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

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

@@ -1,50 +0,0 @@
-/**
- * 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 { AdapterBase } from '../adapter-base.js';
-import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
-export declare class CodexAdapter extends AdapterBase {
-    name: string;
-    description: string;
-    automationLevel: "semi";
-    /**
-     * Detect if Codex is available
-     *
-     * Checks for:
-     * - codex command in PATH (Codex CLI)
-     * - .codex/ directory exists
-     * - AGENTS.md file exists (previously configured)
-     */
-    detect(): Promise<boolean>;
-    /**
-     * Get files to install for Codex adapter
-     */
-    getFiles(): AdapterFile[];
-    /**
-     * Install Codex adapter
-     */
-    install(options: AdapterOptions): Promise<void>;
-    /**
-     * Generate AGENTS.md file
-     */
-    private generateAgentsMd;
-    /**
-     * Post-installation instructions
-     */
-    postInstall(options: AdapterOptions): Promise<void>;
-    /**
-     * Get usage instructions for Codex adapter
-     */
-    getInstructions(): string;
-}
-//# sourceMappingURL=adapter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/codex/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtE,qBAAa,YAAa,SAAQ,WAAW;IAC3C,IAAI,SAAW;IACf,WAAW,SAAoF;IAC/F,eAAe,EAAG,MAAM,CAAU;IAElC;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAQhC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAezB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAuN1B"}

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

@@ -1,316 +0,0 @@
-/**
- * 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