@defai.digital/ax-cli 3.15.26 → 4.0.0

package/README.md

@@ -1,8 +1,7 @@
 # AX CLI - Enterprise-Class CLI for Vibe Coding
 
-[![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-cli)
-[![Tests](https://img.shields.io/badge/tests-2112%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)
-[![Coverage](https://img.shields.io/badge/coverage-98%2B%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli)
+[![downloads](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-cli)
+[![Tests](https://img.shields.io/badge/tests-2265%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)
 [![macOS](https://img.shields.io/badge/macOS-26.0-blue?style=flat-square&logo=apple)](https://www.apple.com/macos/)
 [![Windows](https://img.shields.io/badge/Windows-10%2B-blue?style=flat-square&logo=windows)](https://www.microsoft.com/windows)
 [![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04-blue?style=flat-square&logo=ubuntu)](https://ubuntu.com/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
@@ -23,11 +22,14 @@
 # Install globally
 npm install -g @defai.digital/ax-cli
 
-# Configure API credentials and initialize project (one-time setup)
+# Configure API credentials (one-time setup)
 ax-cli setup
 
 # Start interactive mode
 ax-cli
+
+# Inside interactive mode, initialize your project
+> /init
 ```
 
 **That's it!** AX CLI is now ready to help you build, debug, and ship code faster.
@@ -47,7 +49,7 @@ ax-cli
 - [Security](#security)
 - [Architecture](#architecture)
 - [Changelog](#changelog)
-- [Recent Changes (v3.15.26)](#recent-changes-v31526)
+- [Recent Changes (v4.0.0)](#recent-changes-v400)
 - [Documentation](#documentation)
 
 ---
@@ -134,7 +136,8 @@ This interactive wizard will:
 2. Securely encrypt and store your API key (AES-256-GCM)
 3. Configure default model and settings
 4. Validate your configuration
-5. Initialize your project (generate `.ax-cli/CUSTOM.md`)
+
+Then start `ax-cli` and run `/init` to initialize your project and generate `.ax-cli/CUSTOM.md`.
 
 ### Environment Variable Override
 
@@ -434,31 +437,63 @@ Email: **security@defai.digital** (private disclosure)
 
 - **SSOT Type System** via `@ax-cli/schemas`
 - **TypeScript strict mode** with Zod validation
-- **98%+ test coverage** (2112+ tests)
+- **98%+ test coverage** (2265+ tests)
 - **Modular design** with clean separation
 - **Enterprise security** with AES-256-GCM encryption
 
 ---
 
-## Recent Changes (v3.15.26)
+## Recent Changes (v4.0.0)
 
-### Setup Command Enhancement
+### Tool System v3.0 - Major Architecture Upgrade
 
-- **Merged `init` into `setup`**: The `ax-cli setup` command now includes project initialization as the final step. After configuring your API credentials, it automatically analyzes your project and generates `.ax-cli/CUSTOM.md` with AI instructions.
-- **Deprecated `ax-cli init`**: The standalone `init` command is now deprecated and shows a migration notice pointing to `ax-cli setup`.
-- **New options for setup**:
-  - `-v, --verbose`: Show detailed output during setup
-  - `-d, --directory <dir>`: Specify project directory to initialize
-  - `--skip-project-init`: Skip project initialization step if only API configuration is needed
+This major release introduces a completely redesigned tool definition system inspired by Claude Code's quality standards:
 
-### Recommended Workflow
+#### Rich Tool Definitions (Single Source of Truth)
 
-```bash
-# One command does everything
-ax-cli setup
-```
+- **Comprehensive Metadata**: Each tool now has 500+ word descriptions, usage notes, constraints, anti-patterns, and concrete examples
+- **Type-Safe Architecture**: New `ToolDefinition` interface with full TypeScript support
+- **Format Generators**: OpenAI and Anthropic formats are now derived from rich definitions, not hand-written
+
+#### New Tool Definition System
+
+| Component | Purpose |
+|-----------|---------|
+| `src/tools/types.ts` | Core type definitions (ToolDefinition, ParameterDefinition, etc.) |
+| `src/tools/format-generators.ts` | Converts rich definitions to OpenAI/Anthropic formats |
+| `src/tools/result-enhancer.ts` | Adds security reminders and contextual guidance |
+| `src/tools/definitions/*.ts` | 17 rich tool definitions with Claude Code quality |
+
+#### Tool Categories
+
+- **File Operations**: view_file, create_file, str_replace_editor, multi_edit
+- **Command Execution**: bash, bash_output
+- **Search**: search (unified text/file search)
+- **Task Management**: create_todo_list, update_todo_list
+- **User Interaction**: ask_user
+- **Agent Delegation**: ax_agent
+- **Design Tools**: figma_map, figma_tokens, figma_audit, figma_search, figma_alias_list, figma_alias_resolve
+
+#### Result Enhancer Features
+
+- **Malware Detection**: Warns about potentially malicious code patterns
+- **Sensitive Data Detection**: Identifies exposed credentials, API keys, tokens
+- **Failure Guidance**: Provides contextual help when tools fail
+- **Format Reminders**: Handles truncated output and long lines
+
+#### Benefits
+
+- **Better LLM Behavior**: Rich descriptions guide correct tool usage
+- **Reduced Errors**: Anti-patterns and constraints prevent common mistakes
+- **Easier Maintenance**: Single source of truth for all tool metadata
+- **Token Cost Tracking**: Each tool has estimated token cost for budget planning
+
+## Previous Changes (v3.15.26)
+
+### Command Separation Clarification
 
-The setup wizard now handles both user-level API configuration (`~/.ax-cli/config.json`) and project-level initialization (`.ax-cli/CUSTOM.md`) in a single flow.
+- **`ax-cli setup`**: Handles user-level API configuration (provider, API key, model) - stored in `~/.ax-cli/config.json`
+- **`/init` in interactive mode**: Initializes the current project - stored in `.ax-cli/`
 
 ## Previous Changes (v3.15.25)
 

package/dist/commands/init.d.ts

@@ -1,8 +1,8 @@
 /**
- * Init command - DEPRECATED: Use 'ax-cli setup' instead
+ * Init command for project setup and analysis
  *
- * This command is kept for backwards compatibility and redirects to setup.
- * The project initialization functionality has been integrated into the setup command.
+ * This command initializes project-level configuration (.ax-cli/CUSTOM.md).
+ * For API configuration, use 'ax-cli setup'.
  */
 import { Command } from 'commander';
 export declare function createInitCommand(): Command;

package/dist/commands/init.js

@@ -1,14 +1,23 @@
 /**
- * Init command - DEPRECATED: Use 'ax-cli setup' instead
+ * Init command for project setup and analysis
  *
- * This command is kept for backwards compatibility and redirects to setup.
- * The project initialization functionality has been integrated into the setup command.
+ * This command initializes project-level configuration (.ax-cli/CUSTOM.md).
+ * For API configuration, use 'ax-cli setup'.
  */
 import { Command } from 'commander';
+import { existsSync, mkdirSync, writeFileSync, renameSync, unlinkSync } from 'fs';
+import { join, resolve } from 'path';
+import * as prompts from '@clack/prompts';
 import chalk from 'chalk';
+import { ProjectAnalyzer } from '../utils/project-analyzer.js';
+import { LLMOptimizedInstructionGenerator } from '../utils/llm-optimized-instruction-generator.js';
+import { InitValidator } from '../utils/init-validator.js';
+import { InitWizard } from './init/wizard.js';
+import { extractErrorMessage } from '../utils/error-handler.js';
+import { CONFIG_DIR_NAME, FILE_NAMES } from '../constants.js';
 export function createInitCommand() {
     const initCommand = new Command('init')
-        .description('Initialize project (deprecated: use "ax-cli setup" instead)')
+        .description('Initialize AX CLI for your project with intelligent analysis')
         .option('-f, --force', 'Force regeneration even if files exist', false)
         .option('-v, --verbose', 'Verbose output showing analysis details', false)
         .option('-d, --directory <dir>', 'Project directory to analyze')
@@ -19,28 +28,169 @@ export function createInitCommand() {
         .option('--dry-run', 'Show what would be done without making changes', false)
         .option('--validate', 'Run validation checks only', false)
         .action(async (options) => {
-        // Show deprecation notice
-        console.log(chalk.yellow('\n⚠️  Deprecation Notice:'));
-        console.log(chalk.yellow('   "ax-cli init" has been merged into "ax-cli setup"'));
-        console.log(chalk.yellow('   Please use "ax-cli setup" for full configuration.\n'));
-        // Build equivalent setup command
-        const args = ['setup'];
-        if (options.force)
-            args.push('--force');
-        if (options.verbose)
-            args.push('--verbose');
-        if (options.directory)
-            args.push('-d', options.directory);
-        // Note: Some init-specific options (template, preview, dry-run, validate)
-        // are not directly supported in setup. Show guidance.
-        if (options.template || options.preview || options.dryRun || options.validate) {
-            console.log(chalk.dim('Note: Some options (--template, --preview, --dry-run, --validate)'));
-            console.log(chalk.dim('are not available in the new setup command.\n'));
+        try {
+            prompts.intro(chalk.cyan('AX CLI Project Initialization'));
+            const projectRoot = options.directory ? resolve(options.directory) : process.cwd();
+            if (options.verbose) {
+                prompts.log.info(`Working directory: ${projectRoot}`);
+            }
+            // Run validation if requested
+            if (options.validate) {
+                const validator = new InitValidator(projectRoot);
+                const validationResult = validator.validate();
+                console.log('\n' + InitValidator.formatValidationResult(validationResult));
+                process.exit(validationResult.valid ? 0 : 1);
+            }
+            // Check if in a git repo or has package.json (reasonable project indicator)
+            const hasGit = existsSync(join(projectRoot, '.git'));
+            const hasPackageJson = existsSync(join(projectRoot, 'package.json'));
+            if (!hasGit && !hasPackageJson) {
+                prompts.log.warn('No project detected in current directory (no .git or package.json)');
+                prompts.log.info('Run from a project directory to initialize it.');
+                prompts.outro(chalk.yellow('Initialization skipped'));
+                return;
+            }
+            // Run validation
+            const validator = new InitValidator(projectRoot);
+            const validationResult = validator.validate();
+            if (!validationResult.valid) {
+                prompts.log.error('Project validation failed:');
+                console.log(InitValidator.formatValidationResult(validationResult));
+                process.exit(1);
+            }
+            if (options.verbose && (validationResult.warnings.length > 0 || validationResult.suggestions.length > 0)) {
+                console.log(InitValidator.formatValidationResult(validationResult));
+            }
+            // Check if already initialized
+            const axCliDir = join(projectRoot, CONFIG_DIR_NAME);
+            const customMdPath = join(axCliDir, FILE_NAMES.CUSTOM_MD);
+            const indexPath = join(axCliDir, FILE_NAMES.INDEX_JSON);
+            if (!options.force && existsSync(customMdPath)) {
+                prompts.log.success('Project already initialized!');
+                prompts.log.info(`Custom instructions: ${customMdPath}`);
+                prompts.log.info(`Project index: ${indexPath}`);
+                prompts.log.info('Use --force to regenerate');
+                prompts.outro(chalk.green('Already configured'));
+                return;
+            }
+            // Run interactive wizard for template selection (unless --yes or --no-interaction)
+            let selectedTemplate = undefined;
+            if (!options.noInteraction && !options.yes) {
+                const wizard = new InitWizard({
+                    nonInteractive: options.noInteraction,
+                    yes: options.yes,
+                    template: options.template,
+                });
+                const wizardResult = await wizard.run();
+                selectedTemplate = wizardResult.selectedTemplate;
+            }
+            // Create config directory
+            if (!existsSync(axCliDir)) {
+                mkdirSync(axCliDir, { recursive: true });
+                if (options.verbose) {
+                    prompts.log.info(`Created ${CONFIG_DIR_NAME} directory`);
+                }
+            }
+            // Analyze project
+            const spinner = prompts.spinner();
+            spinner.start('Analyzing project...');
+            const analyzer = new ProjectAnalyzer(projectRoot);
+            const result = await analyzer.analyze();
+            if (!result.success || !result.projectInfo) {
+                spinner.stop('Analysis failed');
+                prompts.log.error(`Project analysis failed: ${result.error || 'Unknown error'}`);
+                process.exit(1);
+            }
+            const projectInfo = result.projectInfo;
+            spinner.stop('Analysis complete');
+            // Display analysis results
+            if (options.verbose) {
+                prompts.log.info(`Project: ${projectInfo.name} (${projectInfo.projectType})`);
+                prompts.log.info(`Language: ${projectInfo.primaryLanguage}`);
+                if (projectInfo.techStack.length > 0) {
+                    prompts.log.info(`Stack: ${projectInfo.techStack.join(', ')}`);
+                }
+            }
+            // Generate content (either from template or project analysis)
+            let instructions;
+            let index;
+            if (selectedTemplate) {
+                instructions = selectedTemplate.instructions;
+                const indexData = {
+                    projectName: selectedTemplate.name,
+                    version: selectedTemplate.version,
+                    projectType: selectedTemplate.projectType,
+                    ...selectedTemplate.metadata,
+                    templateId: selectedTemplate.id,
+                    templateAppliedAt: new Date().toISOString(),
+                };
+                index = JSON.stringify(indexData, null, 2);
+            }
+            else {
+                // Generate LLM-optimized instructions
+                const generator = new LLMOptimizedInstructionGenerator({
+                    compressionLevel: 'moderate',
+                    hierarchyEnabled: true,
+                    criticalRulesCount: 5,
+                    includeDODONT: true,
+                    includeTroubleshooting: true,
+                });
+                instructions = generator.generateInstructions(projectInfo);
+                index = generator.generateIndex(projectInfo);
+            }
+            // Preview or dry-run mode
+            if (options.dryRun) {
+                prompts.log.info('Dry-run mode - no changes made');
+                prompts.log.info(`Would create: ${customMdPath}`);
+                prompts.log.info(`Would create: ${indexPath}`);
+                prompts.outro(chalk.green('Dry-run complete'));
+                return;
+            }
+            // Write files using atomic operations
+            const tmpCustomPath = `${customMdPath}.tmp`;
+            const tmpIndexPath = `${indexPath}.tmp`;
+            try {
+                writeFileSync(tmpCustomPath, instructions, 'utf-8');
+                writeFileSync(tmpIndexPath, index, 'utf-8');
+                // Atomic rename
+                renameSync(tmpCustomPath, customMdPath);
+                renameSync(tmpIndexPath, indexPath);
+                prompts.log.success(`Generated custom instructions: ${customMdPath}`);
+                prompts.log.success(`Generated project index: ${indexPath}`);
+            }
+            catch (writeError) {
+                // Cleanup temp files on error
+                try {
+                    if (existsSync(tmpCustomPath))
+                        unlinkSync(tmpCustomPath);
+                    if (existsSync(tmpIndexPath))
+                        unlinkSync(tmpIndexPath);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+                throw writeError;
+            }
+            // Show completion summary
+            await prompts.note(`Project: ${projectInfo.name} (${projectInfo.projectType})\n` +
+                `Language: ${projectInfo.primaryLanguage}\n` +
+                (projectInfo.techStack.length > 0 ? `Stack: ${projectInfo.techStack.join(', ')}\n` : '') +
+                `\nFiles created:\n` +
+                `  ${customMdPath}\n` +
+                `  ${indexPath}`, 'Project Summary');
+            await prompts.note('1. Review .ax-cli/CUSTOM.md and customize if needed\n' +
+                '2. Start chatting: ax-cli\n' +
+                '3. Use --force to regenerate after project changes', 'Next Steps');
+            prompts.outro(chalk.green('Project initialized successfully!'));
+        }
+        catch (error) {
+            prompts.log.error(`Error during initialization: ${extractErrorMessage(error)}`);
+            if (options.verbose && error instanceof Error && error.stack) {
+                console.error('\nStack trace:');
+                console.error(error.stack);
+            }
+            process.exit(1);
         }
-        console.log(chalk.cyan('Equivalent command:'));
-        console.log(chalk.cyan(`  ax-cli ${args.join(' ')}\n`));
-        // Instead of running, just inform the user
-        console.log('Run the setup command to configure your project.\n');
     });
     return initCommand;
 }

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,iBAAiB;IAC/B,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;SACpC,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,aAAa,EAAE,wCAAwC,EAAE,KAAK,CAAC;SACtE,MAAM,CAAC,eAAe,EAAE,yCAAyC,EAAE,KAAK,CAAC;SACzE,MAAM,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;SAC/D,MAAM,CAAC,WAAW,EAAE,2CAA2C,EAAE,KAAK,CAAC;SACvE,MAAM,CAAC,kBAAkB,EAAE,6BAA6B,EAAE,KAAK,CAAC;SAChE,MAAM,CAAC,8BAA8B,EAAE,yBAAyB,CAAC;SACjE,MAAM,CAAC,WAAW,EAAE,iCAAiC,EAAE,KAAK,CAAC;SAC7D,MAAM,CAAC,WAAW,EAAE,gDAAgD,EAAE,KAAK,CAAC;SAC5E,MAAM,CAAC,YAAY,EAAE,4BAA4B,EAAE,KAAK,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,OAUd,EAAE,EAAE;QACH,0BAA0B;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sDAAsD,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wDAAwD,CAAC,CAAC,CAAC;QAEpF,iCAAiC;QACjC,MAAM,IAAI,GAAa,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,OAAO,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAE1D,0EAA0E;QAC1E,sDAAsD;QACtD,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC,CAAC;YAC5F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAExD,2CAA2C;QAC3C,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEL,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup.d.ts

@@ -1,6 +1,5 @@
 import { Command } from 'commander';
 /**
  * Setup command - Initialize ~/.ax-cli/config.json with provider selection
- * Also initializes project-level configuration (.ax-cli/CUSTOM.md)
  */
 export declare function createSetupCommand(): Command;

package/dist/commands/setup.js

@@ -1,18 +1,15 @@
 import { Command } from 'commander';
-import { existsSync, mkdirSync, writeFileSync, renameSync, unlinkSync } from 'fs';
-import { dirname, join, resolve } from 'path';
+import { existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
 import { execSync, spawnSync } from 'child_process';
 import * as prompts from '@clack/prompts';
 import chalk from 'chalk';
 import { validateProviderSetup } from '../utils/setup-validator.js';
 import { getSettingsManager } from '../utils/settings-manager.js';
 import { extractErrorMessage } from '../utils/error-handler.js';
-import { CONFIG_PATHS, CONFIG_DIR_NAME, FILE_NAMES } from '../constants.js';
+import { CONFIG_PATHS } from '../constants.js';
 import { detectZAIServices, getRecommendedServers, generateZAIServerConfig, } from '../mcp/index.js';
 import { addMCPServer, removeMCPServer } from '../mcp/config.js';
-import { ProjectAnalyzer } from '../utils/project-analyzer.js';
-import { LLMOptimizedInstructionGenerator } from '../utils/llm-optimized-instruction-generator.js';
-import { InitValidator } from '../utils/init-validator.js';
 /**
  * Check if AutomatosX (ax) is installed
  */
@@ -138,123 +135,15 @@ function getProviderFromBaseURL(baseURL) {
     }
     return null;
 }
-/**
- * Initialize project with .ax-cli/CUSTOM.md and index.json
- * This is the core logic from the old init command, now integrated into setup
- */
-async function runProjectInit(options) {
-    const projectRoot = options.directory ? resolve(options.directory) : process.cwd();
-    // Check if in a git repo or has package.json (reasonable project indicator)
-    const hasGit = existsSync(join(projectRoot, '.git'));
-    const hasPackageJson = existsSync(join(projectRoot, 'package.json'));
-    if (!hasGit && !hasPackageJson) {
-        prompts.log.info('No project detected in current directory (no .git or package.json)');
-        prompts.log.info('Run "ax-cli setup" from a project directory to initialize it.');
-        return false;
-    }
-    // Run validation
-    const validator = new InitValidator(projectRoot);
-    const validationResult = validator.validate();
-    if (!validationResult.valid) {
-        if (options.verbose) {
-            prompts.log.warn('Project validation failed:');
-            prompts.log.warn(InitValidator.formatValidationResult(validationResult));
-        }
-        return false;
-    }
-    // Check if already initialized
-    const axCliDir = join(projectRoot, CONFIG_DIR_NAME);
-    const customMdPath = join(axCliDir, FILE_NAMES.CUSTOM_MD);
-    const indexPath = join(axCliDir, FILE_NAMES.INDEX_JSON);
-    if (!options.force && existsSync(customMdPath)) {
-        prompts.log.success('Project already initialized!');
-        prompts.log.info(`Custom instructions: ${customMdPath}`);
-        if (options.verbose) {
-            prompts.log.info(`Project index: ${indexPath}`);
-            prompts.log.info('Use --force to regenerate');
-        }
-        return true;
-    }
-    // Create config directory
-    if (!existsSync(axCliDir)) {
-        mkdirSync(axCliDir, { recursive: true });
-        if (options.verbose) {
-            prompts.log.info(`Created ${CONFIG_DIR_NAME} directory`);
-        }
-    }
-    // Analyze project
-    const analyzer = new ProjectAnalyzer(projectRoot);
-    const result = await analyzer.analyze();
-    if (!result.success || !result.projectInfo) {
-        if (options.verbose) {
-            prompts.log.warn(`Project analysis failed: ${result.error || 'Unknown error'}`);
-        }
-        return false;
-    }
-    const projectInfo = result.projectInfo;
-    // Display analysis results if verbose
-    if (options.verbose) {
-        prompts.log.info(`Project: ${projectInfo.name} (${projectInfo.projectType})`);
-        prompts.log.info(`Language: ${projectInfo.primaryLanguage}`);
-        if (projectInfo.techStack.length > 0) {
-            prompts.log.info(`Stack: ${projectInfo.techStack.join(', ')}`);
-        }
-    }
-    // Generate LLM-optimized instructions
-    const generator = new LLMOptimizedInstructionGenerator({
-        compressionLevel: 'moderate',
-        hierarchyEnabled: true,
-        criticalRulesCount: 5,
-        includeDODONT: true,
-        includeTroubleshooting: true,
-    });
-    const instructions = generator.generateInstructions(projectInfo);
-    const index = generator.generateIndex(projectInfo);
-    // Write files using atomic operations
-    const tmpCustomPath = `${customMdPath}.tmp`;
-    const tmpIndexPath = `${indexPath}.tmp`;
-    try {
-        writeFileSync(tmpCustomPath, instructions, 'utf-8');
-        writeFileSync(tmpIndexPath, index, 'utf-8');
-        // Atomic rename
-        renameSync(tmpCustomPath, customMdPath);
-        renameSync(tmpIndexPath, indexPath);
-        prompts.log.success(`Generated custom instructions: ${customMdPath}`);
-        if (options.verbose) {
-            prompts.log.success(`Generated project index: ${indexPath}`);
-        }
-        return true;
-    }
-    catch (writeError) {
-        // Cleanup temp files on error
-        try {
-            if (existsSync(tmpCustomPath))
-                unlinkSync(tmpCustomPath);
-            if (existsSync(tmpIndexPath))
-                unlinkSync(tmpIndexPath);
-        }
-        catch {
-            // Ignore cleanup errors
-        }
-        if (options.verbose) {
-            prompts.log.warn(`Failed to write project files: ${extractErrorMessage(writeError)}`);
-        }
-        return false;
-    }
-}
 /**
  * Setup command - Initialize ~/.ax-cli/config.json with provider selection
- * Also initializes project-level configuration (.ax-cli/CUSTOM.md)
  */
 export function createSetupCommand() {
     const setupCommand = new Command('setup');
     setupCommand
-        .description('Initialize AX CLI configuration with AI provider selection and project setup')
+        .description('Initialize AX CLI configuration with AI provider selection')
         .option('--force', 'Overwrite existing configuration')
         .option('--no-validate', 'Skip validation of API endpoint and credentials')
-        .option('-v, --verbose', 'Verbose output showing details', false)
-        .option('-d, --directory <dir>', 'Project directory to initialize')
-        .option('--skip-project-init', 'Skip project initialization step', false)
         .action(async (options) => {
         try {
             // Show intro
@@ -608,29 +497,6 @@ export function createSetupCommand() {
                 }
             }
             // ═══════════════════════════════════════════════════════════════════
-            // Project Initialization (integrated from init command)
-            // ═══════════════════════════════════════════════════════════════════
-            if (!options.skipProjectInit) {
-                await prompts.note('Setting up project-level configuration:\n' +
-                    '• Analyzes project structure and tech stack\n' +
-                    '• Generates .ax-cli/CUSTOM.md with AI instructions\n' +
-                    '• Creates project index for context awareness', 'Project Initialization');
-                const initSpinner = prompts.spinner();
-                initSpinner.start('Analyzing project...');
-                const initResult = await runProjectInit({
-                    force: options.force,
-                    verbose: options.verbose,
-                    directory: options.directory,
-                });
-                if (initResult) {
-                    initSpinner.stop('Project initialized successfully');
-                }
-                else {
-                    initSpinner.stop('Project initialization skipped');
-                    prompts.log.info('You can initialize a project later with: ax-cli setup -d /path/to/project');
-                }
-            }
-            // ═══════════════════════════════════════════════════════════════════
             // Completion Summary
             // ═══════════════════════════════════════════════════════════════════
             await prompts.note(`Location:    ${configPath}\n` +
@@ -641,7 +507,9 @@ export function createSetupCommand() {
                 `Temperature: ${mergedConfig.temperature ?? 0.7}`, 'Configuration Details');
             await prompts.note('1. Start interactive mode:\n' +
                 '   $ ax-cli\n\n' +
-                '2. Run a quick test:\n' +
+                '2. Initialize your project (inside ax-cli):\n' +
+                '   > /init\n\n' +
+                '3. Or run a quick test:\n' +
                 '   $ ax-cli -p "Hello, introduce yourself"', 'Next Steps');
             await prompts.note(`• Edit config manually:  ${configPath}\n` +
                 '• See example configs:   Check "_examples" in config file\n' +