@speclife/core 0.9.1 → 0.10.0

package/dist/completions/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Types for shell completion system
+ */
+/** Supported shells for completion generation */
+export type Shell = 'bash' | 'zsh' | 'fish';
+/** Completion type for a command argument */
+export type CompletionType = 'none' | 'file' | 'directory' | 'change-id' | 'shell' | 'editor' | 'config-key' | 'static';
+/** Definition of a completable command */
+export interface CommandDef {
+    /** Command name (e.g., "status", "worktree create") */
+    name: string;
+    /** Subcommands if any */
+    subcommands?: CommandDef[];
+    /** Options/flags */
+    options?: OptionDef[];
+    /** Positional arguments */
+    args?: ArgDef[];
+}
+/** Definition of a command option */
+export interface OptionDef {
+    /** Short flag (e.g., "-f") */
+    short?: string;
+    /** Long flag (e.g., "--force") */
+    long: string;
+    /** Description for help */
+    description: string;
+    /** Whether this option takes a value */
+    takesValue?: boolean;
+    /** Completion type for the value */
+    valueCompletion?: CompletionType;
+    /** Static values if valueCompletion is 'static' */
+    staticValues?: string[];
+}
+/** Definition of a positional argument */
+export interface ArgDef {
+    /** Argument name for help */
+    name: string;
+    /** Completion type */
+    completion: CompletionType;
+    /** Static values if completion is 'static' */
+    staticValues?: string[];
+    /** Whether this argument is optional */
+    optional?: boolean;
+}
+/** Interface for shell completion generators */
+export interface CompletionGenerator {
+    /** Shell this generator targets */
+    readonly shell: Shell;
+    /**
+     * Generate the completion script
+     * @param commands Command definitions
+     * @returns Shell script for completions
+     */
+    generate(commands: CommandDef[]): string;
+    /**
+     * Get installation instructions
+     * @returns Human-readable installation instructions
+     */
+    getInstallInstructions(): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/completions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/completions/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iDAAiD;AACjD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,WAAW,GACX,WAAW,GACX,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,QAAQ,CAAC;AAEb,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,oBAAoB;IACpB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,MAAM;IACrB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,UAAU,EAAE,cAAc,CAAC;IAC3B,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAEzC;;;OAGG;IACH,sBAAsB,IAAI,MAAM,CAAC;CAClC"}

package/dist/completions/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for shell completion system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/completions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/completions/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/completions/zsh-generator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Zsh completion script generator
+ */
+import type { CompletionGenerator, CommandDef } from './types.js';
+export declare class ZshGenerator implements CompletionGenerator {
+    readonly shell: "zsh";
+    generate(commands: CommandDef[]): string;
+    getInstallInstructions(): string;
+    private getCommandDescription;
+    private generateCommandCase;
+    private getSubcommandDescription;
+    private generateArgsSpec;
+    private getZshValueSpec;
+    private getZshArgSpec;
+}
+//# sourceMappingURL=zsh-generator.d.ts.map

package/dist/completions/zsh-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zsh-generator.d.ts","sourceRoot":"","sources":["../../src/completions/zsh-generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAqB,MAAM,YAAY,CAAC;AAGrF,qBAAa,YAAa,YAAW,mBAAmB;IACtD,QAAQ,CAAC,KAAK,EAAG,KAAK,CAAU;IAEhC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM;IAkDxC,sBAAsB,IAAI,MAAM;IAUhC,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,mBAAmB;IAwC3B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,gBAAgB;IAsCxB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,aAAa;CActB"}

package/dist/completions/zsh-generator.js

@@ -0,0 +1,199 @@
+/**
+ * Zsh completion script generator
+ */
+import { getConfigKeys } from './commands.js';
+export class ZshGenerator {
+    shell = 'zsh';
+    generate(commands) {
+        const lines = [
+            '#compdef speclife',
+            '# Zsh completion for speclife',
+            '# Generated by speclife completion zsh',
+            '',
+            '_speclife_change_ids() {',
+            '  local changes',
+            '  changes=($(speclife list --json 2>/dev/null | grep -o \'"id":"[^"]*"\' | cut -d\'"\' -f4))',
+            '  _describe "change" changes',
+            '}',
+            '',
+            '_speclife_config_keys() {',
+            `  local keys=(${getConfigKeys().join(' ')})`,
+            '  _describe "config key" keys',
+            '}',
+            '',
+            '_speclife() {',
+            '  local -a commands',
+            '  commands=(',
+            ...commands.map(c => `    '${c.name}:${this.getCommandDescription(c)}'`),
+            '  )',
+            '',
+            '  _arguments -C \\',
+            '    "1: :->command" \\',
+            '    "*::arg:->args"',
+            '',
+            '  case "$state" in',
+            '    command)',
+            '      _describe "command" commands',
+            '      ;;',
+            '    args)',
+            '      case "$words[1]" in',
+        ];
+        for (const cmd of commands) {
+            lines.push(...this.generateCommandCase(cmd));
+        }
+        lines.push('      esac');
+        lines.push('      ;;');
+        lines.push('  esac');
+        lines.push('}');
+        lines.push('');
+        lines.push('_speclife "$@"');
+        lines.push('');
+        return lines.join('\n');
+    }
+    getInstallInstructions() {
+        return `# Add to your ~/.zshrc:
+speclife completion zsh >> ~/.zshrc
+source ~/.zshrc
+
+# Or install to fpath:
+speclife completion zsh > ~/.zsh/completions/_speclife
+# Then ensure ~/.zsh/completions is in your fpath`;
+    }
+    getCommandDescription(cmd) {
+        const descriptions = {
+            init: 'Initialize SpecLife in this project',
+            worktree: 'Manage git worktrees',
+            status: 'Show change status',
+            list: 'List all changes',
+            view: 'Show dashboard view',
+            completion: 'Generate shell completions',
+            config: 'Manage configuration',
+            validate: 'Validate change spec',
+            update: 'Update managed files',
+            version: 'Show version',
+        };
+        return descriptions[cmd.name] ?? cmd.name;
+    }
+    generateCommandCase(cmd) {
+        const lines = [];
+        lines.push(`        ${cmd.name})`);
+        if (cmd.subcommands && cmd.subcommands.length > 0) {
+            lines.push('          local -a subcommands');
+            lines.push('          subcommands=(');
+            for (const sub of cmd.subcommands) {
+                lines.push(`            '${sub.name}:${this.getSubcommandDescription(cmd.name, sub.name)}'`);
+            }
+            lines.push('          )');
+            lines.push('          _arguments -C \\');
+            lines.push('            "1: :->subcommand" \\');
+            lines.push('            "*::arg:->subargs"');
+            lines.push('          case "$state" in');
+            lines.push('            subcommand)');
+            lines.push('              _describe "subcommand" subcommands');
+            lines.push('              ;;');
+            lines.push('            subargs)');
+            lines.push('              case "$words[1]" in');
+            for (const sub of cmd.subcommands) {
+                lines.push(`                ${sub.name})`);
+                lines.push(...this.generateArgsSpec(sub.args ?? [], sub.options ?? [], 18));
+                lines.push('                  ;;');
+            }
+            lines.push('              esac');
+            lines.push('              ;;');
+            lines.push('          esac');
+        }
+        else {
+            lines.push(...this.generateArgsSpec(cmd.args ?? [], cmd.options ?? [], 10));
+        }
+        lines.push('          ;;');
+        return lines;
+    }
+    getSubcommandDescription(cmd, sub) {
+        const descriptions = {
+            worktree: {
+                create: 'Create a worktree for a change',
+                rm: 'Remove a worktree',
+                list: 'List all worktrees',
+            },
+            config: {
+                path: 'Show config file path',
+                list: 'List all config values',
+                get: 'Get a config value',
+                set: 'Set a config value',
+                unset: 'Remove a config value',
+                reset: 'Reset to defaults',
+                edit: 'Open config in editor',
+            },
+        };
+        return descriptions[cmd]?.[sub] ?? sub;
+    }
+    generateArgsSpec(args, options, indent) {
+        const pad = ' '.repeat(indent);
+        const lines = [];
+        lines.push(`${pad}_arguments \\`);
+        // Add options
+        for (const opt of options) {
+            const flags = [opt.short, opt.long].filter(Boolean);
+            const spec = flags.length > 1
+                ? `{${flags.join(',')}}`
+                : flags[0];
+            if (opt.takesValue) {
+                const valueSpec = this.getZshValueSpec(opt);
+                lines.push(`${pad}  '${spec}[${opt.description}]:${opt.long?.replace('--', '')}:${valueSpec}' \\`);
+            }
+            else {
+                lines.push(`${pad}  '${spec}[${opt.description}]' \\`);
+            }
+        }
+        // Add positional args
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            const pos = i + 1;
+            const valueSpec = this.getZshArgSpec(arg);
+            const optional = arg.optional ? ':' : '';
+            lines.push(`${pad}  '${optional}${pos}:${arg.name}:${valueSpec}' \\`);
+        }
+        // Remove trailing backslash from last line
+        if (lines.length > 1) {
+            lines[lines.length - 1] = lines[lines.length - 1].replace(/ \\$/, '');
+        }
+        return lines;
+    }
+    getZshValueSpec(opt) {
+        if (opt.valueCompletion === 'static' && opt.staticValues) {
+            return `(${opt.staticValues.join(' ')})`;
+        }
+        else if (opt.valueCompletion === 'change-id') {
+            return '_speclife_change_ids';
+        }
+        else if (opt.valueCompletion === 'config-key') {
+            return '_speclife_config_keys';
+        }
+        else if (opt.valueCompletion === 'file') {
+            return '_files';
+        }
+        else if (opt.valueCompletion === 'directory') {
+            return '_directories';
+        }
+        return '';
+    }
+    getZshArgSpec(arg) {
+        if (arg.completion === 'static' && arg.staticValues) {
+            return `(${arg.staticValues.join(' ')})`;
+        }
+        else if (arg.completion === 'change-id') {
+            return '_speclife_change_ids';
+        }
+        else if (arg.completion === 'config-key') {
+            return '_speclife_config_keys';
+        }
+        else if (arg.completion === 'file') {
+            return '_files';
+        }
+        else if (arg.completion === 'directory') {
+            return '_directories';
+        }
+        return '';
+    }
+}
+//# sourceMappingURL=zsh-generator.js.map

package/dist/completions/zsh-generator.js.map

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

package/dist/configurators/base.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Base interface for editor configurators
+ * Each editor has its own configurator that handles setup specifics
+ */
+import type { SpecLifeConfig } from '../config.js';
+/** Editor configuration result */
+export interface ConfigureResult {
+    /** Whether configuration was successful */
+    success: boolean;
+    /** Files that were created or modified */
+    filesModified: string[];
+    /** Files that were skipped (already exist) */
+    filesSkipped: string[];
+    /** Any warnings during configuration */
+    warnings: string[];
+}
+/** Options for editor configuration */
+export interface ConfigureOptions {
+    /** Project root path */
+    projectPath: string;
+    /** Spec directory name (e.g., "openspec") */
+    specDir: string;
+    /** Force overwrite existing files */
+    force?: boolean;
+    /** SpecLife config for context */
+    config?: SpecLifeConfig;
+}
+/**
+ * Abstract base class for editor configurators
+ * Implement this to add support for new editors
+ */
+export declare abstract class EditorConfigurator {
+    /** Human-readable name of the editor */
+    abstract readonly name: string;
+    /** Short identifier for the editor (used in commands) */
+    abstract readonly id: string;
+    /** Description of the editor */
+    abstract readonly description: string;
+    /** Directory name used by this editor (e.g., ".cursor", ".vscode") */
+    abstract readonly configDir: string;
+    /** Whether this editor supports dash-prefixed commands (e.g., /speclife-start) */
+    abstract readonly supportsDashPrefix: boolean;
+    /**
+     * Check if this editor is available on the system
+     * (e.g., check if its config directory exists or CLI is installed)
+     */
+    abstract isAvailable(projectPath: string): Promise<boolean>;
+    /**
+     * Check if this editor is already configured for SpecLife
+     */
+    abstract isConfigured(projectPath: string): Promise<boolean>;
+    /**
+     * Configure the editor for SpecLife
+     * Creates symlinks or copies command files
+     */
+    abstract configure(options: ConfigureOptions): Promise<ConfigureResult>;
+    /**
+     * Remove SpecLife configuration from this editor
+     */
+    abstract unconfigure(projectPath: string): Promise<void>;
+    /**
+     * Get detection hints for this editor
+     * @returns Array of paths to check for editor detection
+     */
+    getDetectionPaths(): string[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/configurators/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/configurators/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;GAGG;AACH,8BAAsB,kBAAkB;IACtC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IAE9C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE5D;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAEvE;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAExD;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE;CAG9B"}

package/dist/configurators/base.js

@@ -0,0 +1,18 @@
+/**
+ * Base interface for editor configurators
+ * Each editor has its own configurator that handles setup specifics
+ */
+/**
+ * Abstract base class for editor configurators
+ * Implement this to add support for new editors
+ */
+export class EditorConfigurator {
+    /**
+     * Get detection hints for this editor
+     * @returns Array of paths to check for editor detection
+     */
+    getDetectionPaths() {
+        return [this.configDir];
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/configurators/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/configurators/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH;;;GAGG;AACH,MAAM,OAAgB,kBAAkB;IAsCtC;;;OAGG;IACH,iBAAiB;QACf,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/configurators/claude-code.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Claude Code (Anthropic) editor configurator
+ */
+import { EditorConfigurator, type ConfigureResult, type ConfigureOptions } from './base.js';
+export declare class ClaudeCodeConfigurator extends EditorConfigurator {
+    readonly name = "Claude Code";
+    readonly id = "claude-code";
+    readonly description = "Claude-powered agentic IDE from Anthropic";
+    readonly configDir = ".claude";
+    readonly supportsDashPrefix = false;
+    isAvailable(_projectPath: string): Promise<boolean>;
+    isConfigured(projectPath: string): Promise<boolean>;
+    configure(options: ConfigureOptions): Promise<ConfigureResult>;
+    unconfigure(projectPath: string): Promise<void>;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/configurators/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/configurators/claude-code.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE5F,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,+CAA+C;IACnE,QAAQ,CAAC,SAAS,aAAa;IAC/B,QAAQ,CAAC,kBAAkB,SAAS;IAE9B,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKnD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUnD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsD9D,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYtD"}

package/dist/configurators/claude-code.js

@@ -0,0 +1,91 @@
+/**
+ * Claude Code (Anthropic) editor configurator
+ */
+import { access, mkdir, symlink, unlink, lstat, readlink } from 'fs/promises';
+import { join } from 'path';
+import { EditorConfigurator } from './base.js';
+export class ClaudeCodeConfigurator extends EditorConfigurator {
+    name = 'Claude Code';
+    id = 'claude-code';
+    description = 'Claude-powered agentic IDE from Anthropic';
+    configDir = '.claude';
+    supportsDashPrefix = false; // Claude Code uses subdirectory format only
+    async isAvailable(_projectPath) {
+        // Claude Code is always available as a supported editor
+        return true;
+    }
+    async isConfigured(projectPath) {
+        try {
+            const commandsDir = join(projectPath, this.configDir, 'commands', 'speclife');
+            await access(commandsDir);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async configure(options) {
+        const { projectPath, specDir, force = false } = options;
+        const result = {
+            success: true,
+            filesModified: [],
+            filesSkipped: [],
+            warnings: [],
+        };
+        const sourceDir = join(projectPath, specDir, 'commands', 'speclife');
+        const editorCommandsBase = join(projectPath, this.configDir, 'commands');
+        const editorCommandsDir = join(editorCommandsBase, 'speclife');
+        try {
+            // Ensure editor commands directory exists
+            await mkdir(editorCommandsBase, { recursive: true });
+            // Create symlink for speclife/ directory
+            try {
+                const stats = await lstat(editorCommandsDir);
+                if (stats.isSymbolicLink()) {
+                    if (force) {
+                        await unlink(editorCommandsDir);
+                        await symlink(sourceDir, editorCommandsDir);
+                        result.filesModified.push(editorCommandsDir);
+                    }
+                    else {
+                        // Check if symlink points to correct location
+                        const target = await readlink(editorCommandsDir);
+                        if (target !== sourceDir) {
+                            result.warnings.push(`Existing symlink points to ${target}, not ${sourceDir}`);
+                        }
+                        result.filesSkipped.push(editorCommandsDir);
+                    }
+                }
+                else {
+                    result.warnings.push(`${editorCommandsDir} exists but is not a symlink`);
+                    result.filesSkipped.push(editorCommandsDir);
+                }
+            }
+            catch {
+                // Symlink doesn't exist, create it
+                await symlink(sourceDir, editorCommandsDir);
+                result.filesModified.push(editorCommandsDir);
+            }
+            // Claude Code doesn't need dash-prefixed symlinks
+            // It only supports the subdirectory format: /speclife/command
+        }
+        catch (err) {
+            result.success = false;
+            result.warnings.push(`Configuration failed: ${err}`);
+        }
+        return result;
+    }
+    async unconfigure(projectPath) {
+        const editorCommandsDir = join(projectPath, this.configDir, 'commands', 'speclife');
+        try {
+            const stats = await lstat(editorCommandsDir);
+            if (stats.isSymbolicLink()) {
+                await unlink(editorCommandsDir);
+            }
+        }
+        catch {
+            // Ignore errors during cleanup
+        }
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/configurators/claude-code.js.map

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

package/dist/configurators/cursor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cursor editor configurator
+ */
+import { EditorConfigurator, type ConfigureResult, type ConfigureOptions } from './base.js';
+export declare class CursorConfigurator extends EditorConfigurator {
+    readonly name = "Cursor";
+    readonly id = "cursor";
+    readonly description = "AI-first code editor with Claude integration";
+    readonly configDir = ".cursor";
+    readonly supportsDashPrefix = true;
+    isAvailable(_projectPath: string): Promise<boolean>;
+    isConfigured(projectPath: string): Promise<boolean>;
+    configure(options: ConfigureOptions): Promise<ConfigureResult>;
+    unconfigure(projectPath: string): Promise<void>;
+    private discoverCommands;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/configurators/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/configurators/cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE5F,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,WAAW,kDAAkD;IACtE,QAAQ,CAAC,SAAS,aAAa;IAC/B,QAAQ,CAAC,kBAAkB,QAAQ;IAE7B,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKnD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUnD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6E9D,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA2BvC,gBAAgB;CAU/B"}