@specsafe/core 0.4.0 → 0.6.0

package/dist/agents/adapters/base.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Base Agent Adapter
+ * Abstract base class with common functionality for all agents
+ */
+import type { AgentAdapter, AgentDefinition, GeneratedFile, GenerateOptions } from '../types.js';
+/**
+ * Base adapter with common functionality
+ */
+export declare abstract class BaseAgentAdapter implements AgentAdapter {
+    abstract agent: AgentDefinition;
+    /**
+     * Detect if agent is configured by checking for detection files
+     */
+    detect(projectDir: string): Promise<boolean>;
+    /**
+     * Generate configuration files - must be implemented by subclasses
+     */
+    abstract generateConfig(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    /**
+     * Generate command files - must be implemented by subclasses
+     */
+    abstract generateCommands(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    /**
+     * Get usage instructions - must be implemented by subclasses
+     */
+    abstract getInstructions(): string;
+    /**
+     * Helper: Generate SpecSafe workflow commands
+     */
+    protected getWorkflowCommands(): string[];
+    /**
+     * Helper: Get command description
+     */
+    protected getCommandDescription(command: string): string;
+    /**
+     * Helper: Get command prompt
+     */
+    protected getCommandPrompt(command: string): string;
+    /**
+     * Helper: Get the main SpecSafe context
+     */
+    protected getMainContext(): string;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/agents/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjG;;GAEG;AACH,8BAAsB,gBAAiB,YAAW,YAAY;IAC5D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAEhC;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlD;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAEhG;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAElG;;OAEG;IACH,QAAQ,CAAC,eAAe,IAAI,MAAM;IAElC;;OAEG;IACH,SAAS,CAAC,mBAAmB,IAAI,MAAM,EAAE;IAazC;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAcxD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IA+EnD;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,MAAM;CA6BnC"}

package/dist/agents/adapters/base.js

@@ -0,0 +1,164 @@
+/**
+ * Base Agent Adapter
+ * Abstract base class with common functionality for all agents
+ */
+import { access } from 'fs/promises';
+import { join } from 'path';
+/**
+ * Base adapter with common functionality
+ */
+export class BaseAgentAdapter {
+    /**
+     * Detect if agent is configured by checking for detection files
+     */
+    async detect(projectDir) {
+        for (const file of this.agent.detectionFiles) {
+            try {
+                await access(join(projectDir, file));
+                return true;
+            }
+            catch {
+                // File doesn't exist, continue
+            }
+        }
+        return false;
+    }
+    /**
+     * Helper: Generate SpecSafe workflow commands
+     */
+    getWorkflowCommands() {
+        return [
+            'specsafe',
+            'specsafe-explore',
+            'specsafe-new',
+            'specsafe-spec',
+            'specsafe-test-create',
+            'specsafe-test-apply',
+            'specsafe-verify',
+            'specsafe-done',
+        ];
+    }
+    /**
+     * Helper: Get command description
+     */
+    getCommandDescription(command) {
+        const descriptions = {
+            'specsafe': 'Show SpecSafe project status',
+            'specsafe-explore': 'Pre-spec exploration and research',
+            'specsafe-new': 'Initialize spec with PRD',
+            'specsafe-spec': 'Generate detailed spec from PRD',
+            'specsafe-test-create': 'Create tests from spec scenarios',
+            'specsafe-test-apply': 'Apply tests - development mode',
+            'specsafe-verify': 'Verify implementation and iterate',
+            'specsafe-done': 'Complete and archive spec',
+        };
+        return descriptions[command] || '';
+    }
+    /**
+     * Helper: Get command prompt
+     */
+    getCommandPrompt(command) {
+        const prompts = {
+            'specsafe': `Read PROJECT_STATE.md and provide:
+1. Summary of active specs and their current stages
+2. Which specs need attention
+3. Recommended next actions
+4. Brief reminder of the SDD workflow`,
+            'specsafe-explore': `You are in exploration mode. Guide pre-spec research:
+- Define problem and identify target users
+- Research existing solutions and competitors
+- Evaluate technology options with pros/cons
+- Estimate effort (S/M/L/XL)
+- Document findings in specs/exploration/FEATURE-NAME.md
+
+Decision Gate: Recommend proceeding to spec creation or gathering more information.`,
+            'specsafe-new': `Create a new spec with Product Requirements Document:
+1. Generate spec ID: SPEC-YYYYMMDD-NNN
+2. Create PRD with problem statement, requirements, scenarios
+3. Recommend tech stack and define rules
+4. Output to specs/drafts/SPEC-ID.md
+5. Update PROJECT_STATE.md (status: DRAFT)
+
+Always confirm with user before writing files.`,
+            'specsafe-spec': `Convert PRD to comprehensive specification:
+- Read PRD from specs/drafts/SPEC-ID.md
+- Create functional requirements (FR-XXX)
+- Create technical requirements (TR-XXX)
+- Define scenarios (Given/When/Then)
+- Write acceptance criteria
+- Add architecture notes
+
+Move to specs/active/SPEC-ID.md and update PROJECT_STATE.md (DRAFT → SPEC).`,
+            'specsafe-test-create': `Generate comprehensive test suite:
+1. Read spec from specs/active/SPEC-ID.md
+2. Create test files in src/__tests__/SPEC-ID/
+3. Map Given/When/Then scenarios to test cases
+4. Include happy path and edge cases
+5. Update PROJECT_STATE.md (SPEC → TEST-CREATE)
+
+Report test count and coverage expectations.`,
+            'specsafe-test-apply': `Guide implementation for active spec:
+- Read requirements and existing tests
+- Implement one requirement at a time
+- Follow cycle: Plan → Implement → Test → Commit
+- Map every change to requirement IDs
+- Never modify tests to make them pass (fix the code)
+- Update PROJECT_STATE.md (TEST-CREATE → TEST-APPLY)
+
+Ask: "Which requirement should we tackle next?"`,
+            'specsafe-verify': `Verify implementation by running tests:
+1. Execute test suite: npm test -- SPEC-ID
+2. Analyze failures and map to requirements
+3. Fix code (not tests) and re-run
+4. Iterate until all tests pass
+5. Check coverage meets requirements
+6. Run full suite for regressions
+
+Update PROJECT_STATE.md (TEST-APPLY → VERIFY).
+Report: pass rate, coverage %, issues.`,
+            'specsafe-done': `Finalize spec after all tests pass:
+- Verify completion checklist
+- Run final test suite
+- Move specs/active/SPEC-ID.md → specs/archive/SPEC-ID.md
+- Update PROJECT_STATE.md (VERIFY → COMPLETE)
+- Generate completion summary
+- Suggest next spec from active list
+
+Ask for confirmation before archiving.`,
+        };
+        return prompts[command] || '';
+    }
+    /**
+     * Helper: Get the main SpecSafe context
+     */
+    getMainContext() {
+        return `You are working on a SpecSafe project using spec-driven development (SDD).
+
+## Project Context
+
+Always read PROJECT_STATE.md first. It contains:
+- Active specs and their current stages
+- Which spec is being worked on
+- Overall project status
+
+## Spec-Driven Development Workflow
+
+EXPLORE → NEW → SPEC → TEST-CREATE → TEST-APPLY → VERIFY → DONE
+
+## Critical Rules
+
+ALWAYS:
+- Read PROJECT_STATE.md before making changes
+- Ensure implementation satisfies tests
+- Use spec ID in commit messages: type(SPEC-XXX): description
+- Run tests before marking work complete
+
+NEVER:
+- Skip tests to implement faster
+- Modify PROJECT_STATE.md directly (use CLI commands)
+- Break verify loop by ignoring test failures
+- Modify tests to make them pass without discussion
+- Commit code without spec reference`;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/agents/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/agents/adapters/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B;;GAEG;AACH,MAAM,OAAgB,gBAAgB;IAGpC;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;gBACrC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAiBD;;OAEG;IACO,mBAAmB;QAC3B,OAAO;YACL,UAAU;YACV,kBAAkB;YAClB,cAAc;YACd,eAAe;YACf,sBAAsB;YACtB,qBAAqB;YACrB,iBAAiB;YACjB,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,qBAAqB,CAAC,OAAe;QAC7C,MAAM,YAAY,GAA2B;YAC3C,UAAU,EAAE,8BAA8B;YAC1C,kBAAkB,EAAE,mCAAmC;YACvD,cAAc,EAAE,0BAA0B;YAC1C,eAAe,EAAE,iCAAiC;YAClD,sBAAsB,EAAE,kCAAkC;YAC1D,qBAAqB,EAAE,gCAAgC;YACvD,iBAAiB,EAAE,mCAAmC;YACtD,eAAe,EAAE,2BAA2B;SAC7C,CAAC;QACF,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACO,gBAAgB,CAAC,OAAe;QACxC,MAAM,OAAO,GAA2B;YACtC,UAAU,EAAE;;;;sCAIoB;YAEhC,kBAAkB,EAAE;;;;;;;oFAO0D;YAE9E,cAAc,EAAE;;;;;;;+CAOyB;YAEzC,eAAe,EAAE;;;;;;;;4EAQqD;YAEtE,sBAAsB,EAAE;;;;;;;6CAOe;YAEvC,qBAAqB,EAAE;;;;;;;;gDAQmB;YAE1C,iBAAiB,EAAE;;;;;;;;;uCASc;YAEjC,eAAe,EAAE;;;;;;;;uCAQgB;SAClC,CAAC;QACF,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACO,cAAc;QACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;qCA0B0B,CAAC;IACpC,CAAC;CACF"}

package/dist/agents/adapters/claude-code.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Claude Code Adapter
+ * Generates configuration for Claude Code (Anthropic)
+ */
+import { BaseAgentAdapter } from './base.js';
+import type { AgentDefinition, GeneratedFile, GenerateOptions } from '../types.js';
+export declare class ClaudeCodeAdapter extends BaseAgentAdapter {
+    readonly agent: AgentDefinition;
+    generateConfig(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    generateCommands(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    private generateSkillFile;
+    getInstructions(): string;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/agents/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/claude-code.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnF,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAA6C;IAEtE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAmDvF,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAe/F,OAAO,CAAC,iBAAiB;IAgCzB,eAAe,IAAI,MAAM;CAsB1B"}

package/dist/agents/adapters/claude-code.js

@@ -0,0 +1,120 @@
+/**
+ * Claude Code Adapter
+ * Generates configuration for Claude Code (Anthropic)
+ */
+import { BaseAgentAdapter } from './base.js';
+import { getRequiredAgentDefinition } from '../registry.js';
+export class ClaudeCodeAdapter extends BaseAgentAdapter {
+    agent = getRequiredAgentDefinition('claude-code');
+    async generateConfig(projectDir, options) {
+        const files = [];
+        // Generate CLAUDE.md
+        files.push({
+            path: 'CLAUDE.md',
+            content: `# SpecSafe Project - Claude Code Configuration
+
+${this.getMainContext()}
+
+## Claude Code Skills
+
+This project includes Claude Code skills for slash commands:
+${this.getWorkflowCommands().map((cmd) => `- /${cmd} - ${this.getCommandDescription(cmd)}`).join('\n')}
+
+## Usage
+
+Use slash commands to navigate the SpecSafe workflow:
+1. \`/specsafe\` - Check project status
+2. \`/specsafe-explore\` - Start exploration for new features
+3. \`/specsafe-new\` - Create a new spec
+4. Follow the workflow through test-create, test-apply, verify, and done
+
+## File Organization
+
+my-project/
+├── specs/
+│   ├── drafts/          # PRD stage specs
+│   ├── active/          # In-progress specs
+│   ├── archive/         # Completed specs
+│   └── exploration/     # Research notes
+├── src/
+│   └── __tests__/       # Test files organized by spec
+├── PROJECT_STATE.md     # Central status tracker
+└── CLAUDE.md           # This file
+
+## Commit Message Format
+
+type(SPEC-ID): brief description
+
+Types: feat, fix, test, docs, refactor, chore
+Example: feat(SPEC-20260212-001): add user authentication
+
+---
+*Generated by SpecSafe v1.0*
+`,
+        });
+        return files;
+    }
+    async generateCommands(projectDir, options) {
+        const files = [];
+        // Generate skill files for each command
+        for (const command of this.getWorkflowCommands()) {
+            const skillContent = this.generateSkillFile(command);
+            files.push({
+                path: `.claude/skills/${command}/SKILL.md`,
+                content: skillContent,
+            });
+        }
+        return files;
+    }
+    generateSkillFile(command) {
+        const description = this.getCommandDescription(command);
+        const prompt = this.getCommandPrompt(command);
+        // Special handling for specsafe (main status command)
+        if (command === 'specsafe') {
+            return `---
+name: specsafe
+description: ${description}
+disable-model-invocation: true
+---
+
+${prompt}
+
+Read PROJECT_STATE.md to determine current state and provide actionable guidance.
+`;
+        }
+        // Commands with arguments
+        const commandsWithArgs = ['specsafe-spec', 'specsafe-test-create', 'specsafe-test-apply', 'specsafe-verify', 'specsafe-done'];
+        const hasArgs = commandsWithArgs.includes(command);
+        return `---
+name: ${command}
+description: ${description}${hasArgs ? '\nargument-hint: "[spec-id]"' : ''}
+disable-model-invocation: true
+---
+
+${prompt}
+`;
+    }
+    getInstructions() {
+        return `Claude Code Setup Complete!
+
+Files created:
+- CLAUDE.md - Main project context
+- .claude/skills/ - Slash command skills
+
+## Usage
+
+1. Open your project with Claude Code
+2. Use slash commands to navigate the workflow:
+   - /specsafe - Check status
+   - /specsafe-explore - Start exploration
+   - /specsafe-new - Create spec
+   - /specsafe-test-create - Generate tests
+   - /specsafe-test-apply - Implement
+   - /specsafe-verify - Run tests
+   - /specsafe-done - Complete spec
+
+The skills will guide you through the entire spec-driven development workflow.
+`;
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/agents/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/agents/adapters/claude-code.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IAC5C,KAAK,GAAoB,0BAA0B,CAAC,aAAa,CAAC,CAAC;IAE5E,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAyB;QAChE,MAAM,KAAK,GAAoB,EAAE,CAAC;QAElC,qBAAqB;QACrB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE;;EAEb,IAAI,CAAC,cAAc,EAAE;;;;;EAKrB,IAAI,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCrG;SACI,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,OAAyB;QAClE,MAAM,KAAK,GAAoB,EAAE,CAAC;QAElC,wCAAwC;QACxC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YACjD,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,kBAAkB,OAAO,WAAW;gBAC1C,OAAO,EAAE,YAAY;aACtB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB,CAAC,OAAe;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE9C,sDAAsD;QACtD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3B,OAAO;;eAEE,WAAW;;;;EAIxB,MAAM;;;CAGP,CAAC;QACE,CAAC;QAED,0BAA0B;QAC1B,MAAM,gBAAgB,GAAG,CAAC,eAAe,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;QAC9H,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEnD,OAAO;QACH,OAAO;eACA,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE;;;;EAIxE,MAAM;CACP,CAAC;IACA,CAAC;IAED,eAAe;QACb,OAAO;;;;;;;;;;;;;;;;;;;CAmBV,CAAC;IACA,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+/**
+ * GitHub Copilot Adapter
+ * Generates .github/copilot-instructions.md for GitHub Copilot
+ */
+import { BaseAgentAdapter } from './base.js';
+import type { AgentDefinition, GeneratedFile, GenerateOptions } from '../types.js';
+export declare class CopilotAdapter extends BaseAgentAdapter {
+    readonly agent: AgentDefinition;
+    generateConfig(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    generateCommands(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    getInstructions(): string;
+}
+//# sourceMappingURL=copilot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/copilot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnF,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAyC;IAElE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAkFvF,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK/F,eAAe,IAAI,MAAM;CAsB1B"}

package/dist/agents/adapters/copilot.js

@@ -0,0 +1,115 @@
+/**
+ * GitHub Copilot Adapter
+ * Generates .github/copilot-instructions.md for GitHub Copilot
+ */
+import { BaseAgentAdapter } from './base.js';
+import { getRequiredAgentDefinition } from '../registry.js';
+export class CopilotAdapter extends BaseAgentAdapter {
+    agent = getRequiredAgentDefinition('copilot');
+    async generateConfig(projectDir, options) {
+        const files = [];
+        files.push({
+            path: '.github/copilot-instructions.md',
+            content: `# SpecSafe - GitHub Copilot Instructions
+
+${this.getMainContext()}
+
+## Workflow Commands
+
+Use \`@workspace /command\` to invoke SpecSafe workflow commands:
+
+### @workspace /specsafe
+${this.getCommandPrompt('specsafe')}
+
+### @workspace /specsafe-explore
+${this.getCommandPrompt('specsafe-explore')}
+
+### @workspace /specsafe-new
+${this.getCommandPrompt('specsafe-new')}
+
+### @workspace /specsafe-spec
+${this.getCommandPrompt('specsafe-spec')}
+
+### @workspace /specsafe-test-create
+${this.getCommandPrompt('specsafe-test-create')}
+
+### @workspace /specsafe-test-apply
+${this.getCommandPrompt('specsafe-test-apply')}
+
+### @workspace /specsafe-verify
+${this.getCommandPrompt('specsafe-verify')}
+
+### @workspace /specsafe-done
+${this.getCommandPrompt('specsafe-done')}
+
+## Context Files
+
+Always check these files before making changes:
+- PROJECT_STATE.md - Current project status and active specs
+- specs/active/*.md - Detailed specifications
+- specsafe.config.json - Project configuration
+
+## File Structure
+
+\`\`\`
+my-project/
+├── specs/
+│   ├── drafts/          # PRD stage specs
+│   ├── active/          # In-progress specs
+│   ├── archive/         # Completed specs
+│   └── exploration/     # Research notes
+├── src/
+│   └── __tests__/       # Test files organized by spec
+├── PROJECT_STATE.md     # Central status tracker
+└── .github/
+    └── copilot-instructions.md  # This file
+\`\`\`
+
+## Commit Messages
+
+Always use this format:
+\`\`\`
+type(SPEC-ID): brief description
+
+- Detailed change 1
+- Detailed change 2
+
+Refs: SPEC-ID
+\`\`\`
+
+Types: feat, fix, test, docs, refactor, chore
+
+---
+*Generated by SpecSafe v1.0*
+`,
+        });
+        return files;
+    }
+    async generateCommands(projectDir, options) {
+        // Copilot doesn't use separate command files
+        return [];
+    }
+    getInstructions() {
+        return `GitHub Copilot Setup Complete!
+
+File created:
+- .github/copilot-instructions.md - SpecSafe workspace instructions
+
+## Usage
+
+1. Open your project in VS Code with GitHub Copilot
+2. Use @workspace commands:
+   - @workspace /specsafe - Check status
+   - @workspace /specsafe-explore - Start exploration
+   - @workspace /specsafe-new - Create spec
+   - @workspace /specsafe-spec - Review/refine spec
+   - @workspace /specsafe-test-create - Generate tests
+   - @workspace /specsafe-test-apply - Implement
+   - @workspace /specsafe-verify - Verify tests
+   - @workspace /specsafe-done - Complete spec
+
+Copilot will use the instructions in .github/copilot-instructions.md to guide suggestions.
+`;
+    }
+}
+//# sourceMappingURL=copilot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.js","sourceRoot":"","sources":["../../../src/agents/adapters/copilot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IACzC,KAAK,GAAoB,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAExE,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAyB;QAChE,MAAM,KAAK,GAAoB,EAAE,CAAC;QAElC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,iCAAiC;YACvC,OAAO,EAAE;;EAEb,IAAI,CAAC,cAAc,EAAE;;;;;;;EAOrB,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;;;EAGjC,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC;;;EAGzC,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;;;EAGrC,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC;;;EAGtC,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,CAAC;;;EAG7C,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC;;;EAG5C,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC;;;EAGxC,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCvC;SACI,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,OAAyB;QAClE,6CAA6C;QAC7C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe;QACb,OAAO;;;;;;;;;;;;;;;;;;;CAmBV,CAAC;IACA,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+/**
+ * Cursor Adapter
+ * Generates .cursorrules for Cursor IDE
+ */
+import { BaseAgentAdapter } from './base.js';
+import type { AgentDefinition, GeneratedFile, GenerateOptions } from '../types.js';
+export declare class CursorAdapter extends BaseAgentAdapter {
+    readonly agent: AgentDefinition;
+    generateConfig(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    generateCommands(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    getInstructions(): string;
+}
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnF,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAwC;IAEjE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyEvF,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK/F,eAAe,IAAI,MAAM;CAqB1B"}

package/dist/agents/adapters/cursor.js

@@ -0,0 +1,105 @@
+/**
+ * Cursor Adapter
+ * Generates .cursorrules for Cursor IDE
+ */
+import { BaseAgentAdapter } from './base.js';
+import { getRequiredAgentDefinition } from '../registry.js';
+export class CursorAdapter extends BaseAgentAdapter {
+    agent = getRequiredAgentDefinition('cursor');
+    async generateConfig(projectDir, options) {
+        const files = [];
+        files.push({
+            path: '.cursorrules',
+            content: `# SpecSafe Rules for Cursor IDE v1.0
+# Spec-Driven Development (SDD) Workflow
+# https://github.com/luci-efe/specsafe
+
+${this.getMainContext()}
+
+## The SpecSafe Workflow Commands
+
+When working on this project, follow the SDD workflow:
+
+### @specsafe - Show Project Status
+${this.getCommandPrompt('specsafe')}
+
+### @specsafe-explore - Pre-Spec Exploration
+${this.getCommandPrompt('specsafe-explore')}
+
+### @specsafe-new - Initialize Spec with PRD
+${this.getCommandPrompt('specsafe-new')}
+
+### @specsafe-spec - Generate Detailed Spec
+${this.getCommandPrompt('specsafe-spec')}
+
+### @specsafe-test-create - Create Tests from Spec
+${this.getCommandPrompt('specsafe-test-create')}
+
+### @specsafe-test-apply - Apply Tests (Development Mode)
+${this.getCommandPrompt('specsafe-test-apply')}
+
+### @specsafe-verify - Verify and Iterate
+${this.getCommandPrompt('specsafe-verify')}
+
+### @specsafe-done - Complete and Archive
+${this.getCommandPrompt('specsafe-done')}
+
+## File Organization
+
+my-project/
+├── specs/
+│   ├── drafts/          # PRD stage specs
+│   ├── active/          # In-progress specs
+│   ├── archive/         # Completed specs
+│   └── exploration/     # Research notes
+├── src/
+│   └── __tests__/       # Test files organized by spec
+├── PROJECT_STATE.md     # Central status tracker
+└── .cursorrules        # This file
+
+## Commit Message Format
+
+type(SPEC-ID): brief description
+
+- Detailed change 1
+- Detailed change 2
+
+Refs: SPEC-ID
+
+Types: feat, fix, test, docs, refactor, chore
+Example: feat(SPEC-20260212-001): add user authentication
+
+---
+*Version: 1.0*
+*Generated by SpecSafe*
+`,
+        });
+        return files;
+    }
+    async generateCommands(projectDir, options) {
+        // Cursor doesn't have separate command files - everything is in .cursorrules
+        return [];
+    }
+    getInstructions() {
+        return `Cursor IDE Setup Complete!
+
+File created:
+- .cursorrules - SpecSafe workflow rules
+
+## Usage
+
+1. Open your project in Cursor
+2. Use @ mentions to invoke commands:
+   - @specsafe - Check project status
+   - @specsafe-explore - Start exploration
+   - @specsafe-new - Create new spec
+   - @specsafe-test-create - Generate tests
+   - @specsafe-test-apply - Implement features
+   - @specsafe-verify - Run tests
+   - @specsafe-done - Complete spec
+
+Cursor will follow the rules defined in .cursorrules to guide you through the workflow.
+`;
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/agents/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/agents/adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,OAAO,aAAc,SAAQ,gBAAgB;IACxC,KAAK,GAAoB,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAEvE,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAyB;QAChE,MAAM,KAAK,GAAoB,EAAE,CAAC;QAElC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE;;;;EAIb,IAAI,CAAC,cAAc,EAAE;;;;;;;EAOrB,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;;;EAGjC,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC;;;EAGzC,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;;;EAGrC,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC;;;EAGtC,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,CAAC;;;EAG7C,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC;;;EAG5C,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC;;;EAGxC,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BvC;SACI,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,OAAyB;QAClE,6EAA6E;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe;QACb,OAAO;;;;;;;;;;;;;;;;;;CAkBV,CAAC;IACA,CAAC;CACF"}

package/dist/agents/adapters/gemini-cli.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Gemini CLI Adapter
+ * Generates configuration for Gemini CLI
+ */
+import { BaseAgentAdapter } from './base.js';
+import type { AgentDefinition, GeneratedFile, GenerateOptions } from '../types.js';
+export declare class GeminiCliAdapter extends BaseAgentAdapter {
+    readonly agent: AgentDefinition;
+    generateConfig(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    generateCommands(projectDir: string, options?: GenerateOptions): Promise<GeneratedFile[]>;
+    getInstructions(): string;
+}
+//# sourceMappingURL=gemini-cli.d.ts.map

package/dist/agents/adapters/gemini-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-cli.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/gemini-cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnF,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAA4C;IAErE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA+BvF,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAoB/F,eAAe,IAAI,MAAM;CAwB1B"}