@bobby_z/openspec 0.0.1

package/dist/core/command-generation/adapters/kilocode.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Kilo Code Command Adapter
+ *
+ * Formats commands for Kilo Code following its workflow specification.
+ * Kilo Code workflows don't use frontmatter.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Kilo Code adapter for command generation.
+ * File path: .kilocode/workflows/opsx-<id>.md
+ * Format: Plain markdown without frontmatter
+ */
+export declare const kilocodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=kilocode.d.ts.map

package/dist/core/command-generation/adapters/kilocode.js

@@ -0,0 +1,23 @@
+/**
+ * Kilo Code Command Adapter
+ *
+ * Formats commands for Kilo Code following its workflow specification.
+ * Kilo Code workflows don't use frontmatter.
+ */
+import path from 'path';
+/**
+ * Kilo Code adapter for command generation.
+ * File path: .kilocode/workflows/opsx-<id>.md
+ * Format: Plain markdown without frontmatter
+ */
+export const kilocodeAdapter = {
+    toolId: 'kilocode',
+    getFilePath(commandId) {
+        return path.join('.kilocode', 'workflows', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `${content.body}
+`;
+    },
+};
+//# sourceMappingURL=kilocode.js.map

package/dist/core/command-generation/adapters/opencode.d.ts

@@ -0,0 +1,13 @@
+/**
+ * OpenCode Command Adapter
+ *
+ * Formats commands for OpenCode following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * OpenCode adapter for command generation.
+ * File path: .opencode/command/opsx-<id>.md
+ * Frontmatter: description
+ */
+export declare const opencodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/core/command-generation/adapters/opencode.js

@@ -0,0 +1,29 @@
+/**
+ * OpenCode Command Adapter
+ *
+ * Formats commands for OpenCode following its frontmatter specification.
+ */
+import path from 'path';
+import { transformToHyphenCommands } from '../../../utils/command-references.js';
+/**
+ * OpenCode adapter for command generation.
+ * File path: .opencode/command/opsx-<id>.md
+ * Frontmatter: description
+ */
+export const opencodeAdapter = {
+    toolId: 'opencode',
+    getFilePath(commandId) {
+        return path.join('.opencode', 'command', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        // Transform command references from colon to hyphen format for OpenCode
+        const transformedBody = transformToHyphenCommands(content.body);
+        return `---
+description: ${content.description}
+---
+
+${transformedBody}
+`;
+    },
+};
+//# sourceMappingURL=opencode.js.map

package/dist/core/command-generation/adapters/qoder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Qoder Command Adapter
+ *
+ * Formats commands for Qoder following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Qoder adapter for command generation.
+ * File path: .qoder/commands/opsx/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export declare const qoderAdapter: ToolCommandAdapter;
+//# sourceMappingURL=qoder.d.ts.map

package/dist/core/command-generation/adapters/qoder.js

@@ -0,0 +1,30 @@
+/**
+ * Qoder Command Adapter
+ *
+ * Formats commands for Qoder following its frontmatter specification.
+ */
+import path from 'path';
+/**
+ * Qoder adapter for command generation.
+ * File path: .qoder/commands/opsx/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export const qoderAdapter = {
+    toolId: 'qoder',
+    getFilePath(commandId) {
+        return path.join('.qoder', 'commands', 'opsx', `${commandId}.md`);
+    },
+    formatFile(content) {
+        const tagsStr = content.tags.join(', ');
+        return `---
+name: ${content.name}
+description: ${content.description}
+category: ${content.category}
+tags: [${tagsStr}]
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=qoder.js.map

package/dist/core/command-generation/adapters/qwen.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Qwen Code Command Adapter
+ *
+ * Formats commands for Qwen Code following its TOML specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Qwen adapter for command generation.
+ * File path: .qwen/commands/opsx-<id>.toml
+ * Format: TOML with description and prompt fields
+ */
+export declare const qwenAdapter: ToolCommandAdapter;
+//# sourceMappingURL=qwen.d.ts.map

package/dist/core/command-generation/adapters/qwen.js

@@ -0,0 +1,26 @@
+/**
+ * Qwen Code Command Adapter
+ *
+ * Formats commands for Qwen Code following its TOML specification.
+ */
+import path from 'path';
+/**
+ * Qwen adapter for command generation.
+ * File path: .qwen/commands/opsx-<id>.toml
+ * Format: TOML with description and prompt fields
+ */
+export const qwenAdapter = {
+    toolId: 'qwen',
+    getFilePath(commandId) {
+        return path.join('.qwen', 'commands', `opsx-${commandId}.toml`);
+    },
+    formatFile(content) {
+        return `description = "${content.description}"
+
+prompt = """
+${content.body}
+"""
+`;
+    },
+};
+//# sourceMappingURL=qwen.js.map

package/dist/core/command-generation/adapters/roocode.d.ts

@@ -0,0 +1,14 @@
+/**
+ * RooCode Command Adapter
+ *
+ * Formats commands for RooCode following its workflow specification.
+ * RooCode uses markdown headers instead of YAML frontmatter.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * RooCode adapter for command generation.
+ * File path: .roo/commands/opsx-<id>.md
+ * Format: Markdown header with description
+ */
+export declare const roocodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=roocode.d.ts.map

package/dist/core/command-generation/adapters/roocode.js

@@ -0,0 +1,27 @@
+/**
+ * RooCode Command Adapter
+ *
+ * Formats commands for RooCode following its workflow specification.
+ * RooCode uses markdown headers instead of YAML frontmatter.
+ */
+import path from 'path';
+/**
+ * RooCode adapter for command generation.
+ * File path: .roo/commands/opsx-<id>.md
+ * Format: Markdown header with description
+ */
+export const roocodeAdapter = {
+    toolId: 'roocode',
+    getFilePath(commandId) {
+        return path.join('.roo', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `# ${content.name}
+
+${content.description}
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=roocode.js.map

package/dist/core/command-generation/adapters/windsurf.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Windsurf Command Adapter
+ *
+ * Formats commands for Windsurf following its frontmatter specification.
+ * Windsurf uses a similar format to Claude but may have different conventions.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Windsurf adapter for command generation.
+ * File path: .windsurf/workflows/opsx-<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export declare const windsurfAdapter: ToolCommandAdapter;
+//# sourceMappingURL=windsurf.d.ts.map

package/dist/core/command-generation/adapters/windsurf.js

@@ -0,0 +1,51 @@
+/**
+ * Windsurf Command Adapter
+ *
+ * Formats commands for Windsurf following its frontmatter specification.
+ * Windsurf uses a similar format to Claude but may have different conventions.
+ */
+import path from 'path';
+/**
+ * Escapes a string value for safe YAML output.
+ * Quotes the string if it contains special YAML characters.
+ */
+function escapeYamlValue(value) {
+    // Check if value needs quoting (contains special YAML characters or starts/ends with whitespace)
+    const needsQuoting = /[:\n\r#{}[\],&*!|>'"%@`]|^\s|\s$/.test(value);
+    if (needsQuoting) {
+        // Use double quotes and escape internal double quotes and backslashes
+        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+/**
+ * Formats a tags array as a YAML array with proper escaping.
+ */
+function formatTagsArray(tags) {
+    const escapedTags = tags.map((tag) => escapeYamlValue(tag));
+    return `[${escapedTags.join(', ')}]`;
+}
+/**
+ * Windsurf adapter for command generation.
+ * File path: .windsurf/workflows/opsx-<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export const windsurfAdapter = {
+    toolId: 'windsurf',
+    getFilePath(commandId) {
+        return path.join('.windsurf', 'workflows', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/core/command-generation/generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Command Generator
+ *
+ * Functions for generating command files using tool adapters.
+ */
+import type { CommandContent, ToolCommandAdapter, GeneratedCommand } from './types.js';
+/**
+ * Generate a single command file using the provided adapter.
+ * @param content - The tool-agnostic command content
+ * @param adapter - The tool-specific adapter
+ * @returns Generated command with path and file content
+ */
+export declare function generateCommand(content: CommandContent, adapter: ToolCommandAdapter): GeneratedCommand;
+/**
+ * Generate multiple command files using the provided adapter.
+ * @param contents - Array of tool-agnostic command contents
+ * @param adapter - The tool-specific adapter
+ * @returns Array of generated commands with paths and file contents
+ */
+export declare function generateCommands(contents: CommandContent[], adapter: ToolCommandAdapter): GeneratedCommand[];
+//# sourceMappingURL=generator.d.ts.map

package/dist/core/command-generation/generator.js

@@ -0,0 +1,27 @@
+/**
+ * Command Generator
+ *
+ * Functions for generating command files using tool adapters.
+ */
+/**
+ * Generate a single command file using the provided adapter.
+ * @param content - The tool-agnostic command content
+ * @param adapter - The tool-specific adapter
+ * @returns Generated command with path and file content
+ */
+export function generateCommand(content, adapter) {
+    return {
+        path: adapter.getFilePath(content.id),
+        fileContent: adapter.formatFile(content),
+    };
+}
+/**
+ * Generate multiple command files using the provided adapter.
+ * @param contents - Array of tool-agnostic command contents
+ * @param adapter - The tool-specific adapter
+ * @returns Array of generated commands with paths and file contents
+ */
+export function generateCommands(contents, adapter) {
+    return contents.map((content) => generateCommand(content, adapter));
+}
+//# sourceMappingURL=generator.js.map

package/dist/core/command-generation/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Command Generation Module
+ *
+ * Generic command generation system with tool-specific adapters.
+ *
+ * Usage:
+ * ```typescript
+ * import { generateCommands, CommandAdapterRegistry, type CommandContent } from './command-generation/index.js';
+ *
+ * const contents: CommandContent[] = [...];
+ * const adapter = CommandAdapterRegistry.get('cursor');
+ * if (adapter) {
+ *   const commands = generateCommands(contents, adapter);
+ *   // Write commands to disk
+ * }
+ * ```
+ */
+export type { CommandContent, ToolCommandAdapter, GeneratedCommand, } from './types.js';
+export { CommandAdapterRegistry } from './registry.js';
+export { generateCommand, generateCommands } from './generator.js';
+export { claudeAdapter, cursorAdapter, windsurfAdapter } from './adapters/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/command-generation/index.js

@@ -0,0 +1,24 @@
+/**
+ * Command Generation Module
+ *
+ * Generic command generation system with tool-specific adapters.
+ *
+ * Usage:
+ * ```typescript
+ * import { generateCommands, CommandAdapterRegistry, type CommandContent } from './command-generation/index.js';
+ *
+ * const contents: CommandContent[] = [...];
+ * const adapter = CommandAdapterRegistry.get('cursor');
+ * if (adapter) {
+ *   const commands = generateCommands(contents, adapter);
+ *   // Write commands to disk
+ * }
+ * ```
+ */
+// Registry
+export { CommandAdapterRegistry } from './registry.js';
+// Generator functions
+export { generateCommand, generateCommands } from './generator.js';
+// Adapters (for direct access if needed)
+export { claudeAdapter, cursorAdapter, windsurfAdapter } from './adapters/index.js';
+//# sourceMappingURL=index.js.map

package/dist/core/command-generation/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Command Adapter Registry
+ *
+ * Centralized registry for tool command adapters.
+ * Similar pattern to existing SlashCommandRegistry in the codebase.
+ */
+import type { ToolCommandAdapter } from "./types.js";
+/**
+ * Registry for looking up tool command adapters.
+ */
+export declare class CommandAdapterRegistry {
+    private static adapters;
+    /**
+     * Register a tool command adapter.
+     * @param adapter - The adapter to register
+     */
+    static register(adapter: ToolCommandAdapter): void;
+    /**
+     * Get an adapter by tool ID.
+     * @param toolId - The tool identifier (e.g., 'claude', 'cursor')
+     * @returns The adapter or undefined if not registered
+     */
+    static get(toolId: string): ToolCommandAdapter | undefined;
+    /**
+     * Get all registered adapters.
+     * @returns Array of all registered adapters
+     */
+    static getAll(): ToolCommandAdapter[];
+    /**
+     * Check if an adapter is registered for a tool.
+     * @param toolId - The tool identifier
+     * @returns True if an adapter exists
+     */
+    static has(toolId: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/command-generation/registry.js

@@ -0,0 +1,90 @@
+/**
+ * Command Adapter Registry
+ *
+ * Centralized registry for tool command adapters.
+ * Similar pattern to existing SlashCommandRegistry in the codebase.
+ */
+import { amazonQAdapter } from "./adapters/amazon-q.js";
+import { antigravityAdapter } from "./adapters/antigravity.js";
+import { auggieAdapter } from "./adapters/auggie.js";
+import { claudeAdapter } from "./adapters/claude.js";
+import { clineAdapter } from "./adapters/cline.js";
+import { devagentAdapter } from "./adapters/devagent.js";
+import { codexAdapter } from "./adapters/codex.js";
+import { codebuddyAdapter } from "./adapters/codebuddy.js";
+import { continueAdapter } from "./adapters/continue.js";
+import { costrictAdapter } from "./adapters/costrict.js";
+import { crushAdapter } from "./adapters/crush.js";
+import { cursorAdapter } from "./adapters/cursor.js";
+import { factoryAdapter } from "./adapters/factory.js";
+import { geminiAdapter } from "./adapters/gemini.js";
+import { githubCopilotAdapter } from "./adapters/github-copilot.js";
+import { iflowAdapter } from "./adapters/iflow.js";
+import { kilocodeAdapter } from "./adapters/kilocode.js";
+import { opencodeAdapter } from "./adapters/opencode.js";
+import { qoderAdapter } from "./adapters/qoder.js";
+import { qwenAdapter } from "./adapters/qwen.js";
+import { roocodeAdapter } from "./adapters/roocode.js";
+import { windsurfAdapter } from "./adapters/windsurf.js";
+/**
+ * Registry for looking up tool command adapters.
+ */
+export class CommandAdapterRegistry {
+    static adapters = new Map();
+    // Static initializer - register built-in adapters
+    static {
+        CommandAdapterRegistry.register(amazonQAdapter);
+        CommandAdapterRegistry.register(antigravityAdapter);
+        CommandAdapterRegistry.register(auggieAdapter);
+        CommandAdapterRegistry.register(claudeAdapter);
+        CommandAdapterRegistry.register(clineAdapter);
+        CommandAdapterRegistry.register(devagentAdapter);
+        CommandAdapterRegistry.register(codexAdapter);
+        CommandAdapterRegistry.register(codebuddyAdapter);
+        CommandAdapterRegistry.register(continueAdapter);
+        CommandAdapterRegistry.register(costrictAdapter);
+        CommandAdapterRegistry.register(crushAdapter);
+        CommandAdapterRegistry.register(cursorAdapter);
+        CommandAdapterRegistry.register(factoryAdapter);
+        CommandAdapterRegistry.register(geminiAdapter);
+        CommandAdapterRegistry.register(githubCopilotAdapter);
+        CommandAdapterRegistry.register(iflowAdapter);
+        CommandAdapterRegistry.register(kilocodeAdapter);
+        CommandAdapterRegistry.register(opencodeAdapter);
+        CommandAdapterRegistry.register(qoderAdapter);
+        CommandAdapterRegistry.register(qwenAdapter);
+        CommandAdapterRegistry.register(roocodeAdapter);
+        CommandAdapterRegistry.register(windsurfAdapter);
+    }
+    /**
+     * Register a tool command adapter.
+     * @param adapter - The adapter to register
+     */
+    static register(adapter) {
+        CommandAdapterRegistry.adapters.set(adapter.toolId, adapter);
+    }
+    /**
+     * Get an adapter by tool ID.
+     * @param toolId - The tool identifier (e.g., 'claude', 'cursor')
+     * @returns The adapter or undefined if not registered
+     */
+    static get(toolId) {
+        return CommandAdapterRegistry.adapters.get(toolId);
+    }
+    /**
+     * Get all registered adapters.
+     * @returns Array of all registered adapters
+     */
+    static getAll() {
+        return Array.from(CommandAdapterRegistry.adapters.values());
+    }
+    /**
+     * Check if an adapter is registered for a tool.
+     * @param toolId - The tool identifier
+     * @returns True if an adapter exists
+     */
+    static has(toolId) {
+        return CommandAdapterRegistry.adapters.has(toolId);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/command-generation/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Command Generation Types
+ *
+ * Tool-agnostic interfaces for command generation.
+ * These types separate "what to generate" from "how to format it".
+ */
+/**
+ * Tool-agnostic command data.
+ * Represents the content of a command without any tool-specific formatting.
+ */
+export interface CommandContent {
+    /** Command identifier (e.g., 'explore', 'apply', 'new') */
+    id: string;
+    /** Human-readable name (e.g., 'OpenSpec Explore') */
+    name: string;
+    /** Brief description of command purpose */
+    description: string;
+    /** Grouping category (e.g., 'Workflow') */
+    category: string;
+    /** Array of tag strings */
+    tags: string[];
+    /** The command instruction content (body text) */
+    body: string;
+}
+/**
+ * Per-tool formatting strategy.
+ * Each AI tool implements this interface to handle its specific file path
+ * and frontmatter format requirements.
+ */
+export interface ToolCommandAdapter {
+    /** Tool identifier matching AIToolOption.value (e.g., 'claude', 'cursor') */
+    toolId: string;
+    /**
+     * Returns the file path for a command.
+     * @param commandId - The command identifier (e.g., 'explore')
+     * @returns Path from project root (e.g., '.claude/commands/opsx/explore.md').
+     *          May be absolute for tools with global-scoped prompts (e.g., Codex).
+     */
+    getFilePath(commandId: string): string;
+    /**
+     * Formats the complete file content including frontmatter.
+     * @param content - The tool-agnostic command content
+     * @returns Complete file content ready to write
+     */
+    formatFile(content: CommandContent): string;
+}
+/**
+ * Result of generating a command file.
+ */
+export interface GeneratedCommand {
+    /** File path from project root, or absolute for global-scoped tools */
+    path: string;
+    /** Complete file content (frontmatter + body) */
+    fileContent: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/command-generation/types.js

@@ -0,0 +1,8 @@
+/**
+ * Command Generation Types
+ *
+ * Tool-agnostic interfaces for command generation.
+ * These types separate "what to generate" from "how to format it".
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/completions/command-registry.d.ts

@@ -0,0 +1,7 @@
+import { CommandDefinition } from "./types.js";
+/**
+ * Registry of all OpenSpec CLI commands with their flags and metadata.
+ * This registry is used to generate shell completion scripts.
+ */
+export declare const COMMAND_REGISTRY: CommandDefinition[];
+//# sourceMappingURL=command-registry.d.ts.map