@intoinside/praxis 1.0.1

package/src/core/command-generation/adapters/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Command Adapters Index
+ *
+ * Re-exports all tool command adapters.
+ */
+export { antigravityAdapter } from './antigravity.js';

package/src/core/command-generation/adapters/index.js

@@ -0,0 +1,26 @@
+/**
+ * Command Adapters Index
+ *
+ * Re-exports all tool command adapters.
+ */
+// export { amazonQAdapter } from './amazon-q.js';
+export { antigravityAdapter } from './antigravity.js';
+// export { auggieAdapter } from './auggie.js';
+// export { claudeAdapter } from './claude.js';
+// export { clineAdapter } from './cline.js';
+// export { codexAdapter } from './codex.js';
+// export { codebuddyAdapter } from './codebuddy.js';
+// export { continueAdapter } from './continue.js';
+// export { costrictAdapter } from './costrict.js';
+// export { crushAdapter } from './crush.js';
+// export { cursorAdapter } from './cursor.js';
+// export { factoryAdapter } from './factory.js';
+// export { geminiAdapter } from './gemini.js';
+// export { githubCopilotAdapter } from './github-copilot.js';
+// export { iflowAdapter } from './iflow.js';
+// export { kilocodeAdapter } from './kilocode.js';
+// export { opencodeAdapter } from './opencode.js';
+// export { qoderAdapter } from './qoder.js';
+// export { qwenAdapter } from './qwen.js';
+// export { roocodeAdapter } from './roocode.js';
+// export { windsurfAdapter } from './windsurf.js';

package/src/core/command-generation/adapters/index.ts

@@ -0,0 +1,27 @@
+/**
+ * Command Adapters Index
+ *
+ * Re-exports all tool command adapters.
+ */
+
+// export { amazonQAdapter } from './amazon-q.js';
+export { antigravityAdapter } from './antigravity.js';
+// export { auggieAdapter } from './auggie.js';
+// export { claudeAdapter } from './claude.js';
+// export { clineAdapter } from './cline.js';
+// export { codexAdapter } from './codex.js';
+// export { codebuddyAdapter } from './codebuddy.js';
+// export { continueAdapter } from './continue.js';
+// export { costrictAdapter } from './costrict.js';
+// export { crushAdapter } from './crush.js';
+// export { cursorAdapter } from './cursor.js';
+// export { factoryAdapter } from './factory.js';
+// export { geminiAdapter } from './gemini.js';
+// export { githubCopilotAdapter } from './github-copilot.js';
+// export { iflowAdapter } from './iflow.js';
+// export { kilocodeAdapter } from './kilocode.js';
+// export { opencodeAdapter } from './opencode.js';
+// export { qoderAdapter } from './qoder.js';
+// export { qwenAdapter } from './qwen.js';
+// export { roocodeAdapter } from './roocode.js';
+// export { windsurfAdapter } from './windsurf.js';

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

@@ -0,0 +1,20 @@
+/**
+ * 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[];

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

@@ -0,0 +1,26 @@
+/**
+ * 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));
+}

package/src/core/command-generation/generator.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 function generateCommand(
+    content: CommandContent,
+    adapter: ToolCommandAdapter
+): GeneratedCommand {
+    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: CommandContent[],
+    adapter: ToolCommandAdapter
+): GeneratedCommand[] {
+    return contents.map((content) => generateCommand(content, adapter));
+}

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

@@ -0,0 +1,20 @@
+/**
+ * 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';

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

@@ -0,0 +1,23 @@
+/**
+ * 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';

package/src/core/command-generation/index.ts

@@ -0,0 +1,33 @@
+/**
+ * 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
+ * }
+ * ```
+ */
+
+// Types
+export type {
+    CommandContent,
+    ToolCommandAdapter,
+    GeneratedCommand,
+} from './types.js';
+
+// 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';

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

@@ -0,0 +1,35 @@
+/**
+ * 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;
+}

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

@@ -0,0 +1,87 @@
+/**
+ * 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);
+    }
+}

package/src/core/command-generation/registry.ts

@@ -0,0 +1,95 @@
+/**
+ * Command Adapter Registry
+ *
+ * Centralized registry for tool command adapters.
+ * Similar pattern to existing SlashCommandRegistry in the codebase.
+ */
+
+import type { ToolCommandAdapter } from './types.js';
+// 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 {
+    private static adapters: Map<string, ToolCommandAdapter> = 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: ToolCommandAdapter): void {
+        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: string): ToolCommandAdapter | undefined {
+        return CommandAdapterRegistry.adapters.get(toolId);
+    }
+
+    /**
+     * Get all registered adapters.
+     * @returns Array of all registered adapters
+     */
+    static getAll(): ToolCommandAdapter[] {
+        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: string): boolean {
+        return CommandAdapterRegistry.adapters.has(toolId);
+    }
+}

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

@@ -0,0 +1,54 @@
+/**
+ * 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/praxis/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;
+}

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

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

package/src/core/command-generation/types.ts

@@ -0,0 +1,57 @@
+/**
+ * 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/praxis/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;
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/src/index.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { manifest } from './manifest.js';
+import { initCommand } from './commands/init.js';
+import { intentCreateAction } from './commands/intent/create.js';
+import { intentListAction } from './commands/intent/list.js';
+import { generateSlashCommandsAction } from './commands/integration/generate.js';
+import { specDeriveAction } from './commands/spec/derive.js';
+import { specDeleteAction } from './commands/spec/delete.js';
+import { specApplyAction } from './commands/spec/apply.js';
+import { specArchiveAction } from './commands/spec/archive.js';
+const program = new Command();
+program
+    .name('praxis')
+    .description('Praxis: Intent-First Development Framework')
+    .version('1.0.0');
+// Dynamically build commands from manifest
+manifest.forEach((cmdDef) => {
+    const cmd = program.command(cmdDef.name).description(cmdDef.description);
+    if (cmdDef.subcommands) {
+        cmdDef.subcommands.forEach((subCmdDef) => {
+            const subCmd = cmd.command(subCmdDef.name).description(subCmdDef.description);
+            if (subCmdDef.arguments) {
+                subCmdDef.arguments.forEach(arg => {
+                    const argStr = arg.required ? `<${arg.name}>` : `[${arg.name}]`;
+                    subCmd.argument(argStr, arg.description);
+                });
+            }
+            if (subCmdDef.options) {
+                subCmdDef.options.forEach(opt => {
+                    const flag = opt.required ? `<${opt.name}>` : `[${opt.name}]`;
+                    subCmd.option(opt.alias ? `-${opt.alias}, --${opt.name} ${flag}` : `--${opt.name} ${flag}`, opt.description);
+                });
+            }
+            subCmd.action(async (...args) => {
+                if (cmdDef.name === 'intent' && subCmdDef.name === 'create') {
+                    const [description] = args;
+                    await intentCreateAction(description);
+                }
+                else if (cmdDef.name === 'intent' && subCmdDef.name === 'list') {
+                    await intentListAction();
+                }
+                else if (cmdDef.name === 'integration' && subCmdDef.name === 'generate-slash-commands') {
+                    const [tool] = args;
+                    await generateSlashCommandsAction(tool);
+                }
+                else if (cmdDef.name === 'spec' && subCmdDef.name === 'derive') {
+                    const [options] = args;
+                    await specDeriveAction(options);
+                }
+                else if (cmdDef.name === 'spec' && subCmdDef.name === 'delete') {
+                    const [specId] = args;
+                    await specDeleteAction(specId);
+                }
+                else if (cmdDef.name === 'spec' && subCmdDef.name === 'apply') {
+                    const [specId] = args;
+                    await specApplyAction(specId);
+                }
+                else if (cmdDef.name === 'spec' && subCmdDef.name === 'archive') {
+                    const [specId] = args;
+                    await specArchiveAction(specId);
+                }
+                else {
+                    console.log(`Executing ${cmdDef.name} ${subCmdDef.name}...`);
+                    // Implementation will go here
+                }
+            });
+        });
+    }
+    else {
+        // Top-level command with no subcommands
+        if (cmdDef.arguments) {
+            cmdDef.arguments.forEach(arg => {
+                const argStr = arg.required ? `<${arg.name}>` : `[${arg.name}]`;
+                cmd.argument(argStr, arg.description);
+            });
+        }
+        if (cmdDef.options) {
+            cmdDef.options.forEach(opt => {
+                const flag = opt.required ? `<${opt.name}>` : `[${opt.name}]`;
+                cmd.option(opt.alias ? `-${opt.alias}, --${opt.name} ${flag}` : `--${opt.name} ${flag}`, opt.description);
+            });
+        }
+        cmd.action(async () => {
+            if (cmdDef.name === 'init') {
+                await initCommand();
+            }
+            else {
+                console.log(`Executing ${cmdDef.name}...`);
+                // Implementation will go here
+            }
+        });
+    }
+});
+program.parse();