openspec-cn 0.23.0

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,88 @@
+/**
+ * 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 { 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(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,55 @@
+/**
+ * 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 relative file path for a command.
+     * @param commandId - The command identifier (e.g., 'explore')
+     * @returns Relative path from project root (e.g., '.claude/commands/opsx/explore.md')
+     */
+    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 {
+    /** Relative file path from project root */
+    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