@ai-coders/context 0.6.1 → 0.7.1

package/dist/index.js

@@ -67,13 +67,21 @@ const start_1 = require("./services/start");
 const export_1 = require("./services/export");
 const report_1 = require("./services/report");
 const quickSync_1 = require("./services/quickSync");
+const reverseSync_1 = require("./services/reverseSync");
 const workflow_2 = require("./workflow");
 const providerFactory_1 = require("./services/ai/providerFactory");
 const prompts_1 = require("./utils/prompts");
 const version_1 = require("./version");
 const rawArgs = process.argv.slice(2);
 const isMcpCommand = rawArgs.includes('mcp');
-if (!isMcpCommand) {
+// Determine if we're in interactive mode (no command args, only flags like --lang)
+const isInteractiveMode = rawArgs.every(arg => arg.startsWith('-') ||
+    rawArgs[rawArgs.indexOf(arg) - 1]?.startsWith('--lang') ||
+    rawArgs[rawArgs.indexOf(arg) - 1]?.startsWith('--language') ||
+    rawArgs[rawArgs.indexOf(arg) - 1]?.startsWith('-l'));
+// Load dotenv immediately for command-line mode (not MCP, not interactive)
+// For interactive mode, we'll ask the user first
+if (!isMcpCommand && !isInteractiveMode) {
     dotenv.config();
 }
 const initialLocale = (0, i18n_1.detectLocale)(rawArgs, process.env.AI_CONTEXT_LANG);
@@ -154,6 +162,7 @@ program
     .option('--include <patterns...>', t('commands.init.options.include'))
     .option('-v, --verbose', t('commands.init.options.verbose'))
     .option('--no-semantic', t('commands.init.options.noSemantic'))
+    .option('--no-content-stubs', t('commands.init.options.noContentStubs'))
     .action(async (repoPath, type, options) => {
     try {
         await initService.run(repoPath, type, options);
@@ -384,6 +393,39 @@ program
         process.exit(1);
     }
 });
+program
+    .command('reverse-sync')
+    .description('Import rules, agents, and skills from AI tool directories into .context/')
+    .argument('[repo-path]', 'Repository path to scan', process.cwd())
+    .option('--dry-run', 'Preview changes without importing')
+    .option('-f, --force', 'Overwrite existing files')
+    .option('--skip-agents', 'Skip importing agents')
+    .option('--skip-skills', 'Skip importing skills')
+    .option('--skip-rules', 'Skip importing rules')
+    .option('--merge-strategy <strategy>', 'How to handle conflicts: skip|overwrite|merge|rename', 'skip')
+    .option('--format <format>', 'Output format for rules: markdown|raw|formatted', 'formatted')
+    .option('--no-metadata', 'Do not add import metadata to files')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (repoPath, options) => {
+    try {
+        const service = new reverseSync_1.ReverseQuickSyncService({ ui, t, version: version_1.VERSION });
+        await service.run(repoPath, {
+            dryRun: options.dryRun,
+            force: options.force,
+            skipAgents: options.skipAgents,
+            skipSkills: options.skipSkills,
+            skipRules: options.skipRules,
+            mergeStrategy: options.mergeStrategy,
+            format: options.format,
+            metadata: options.metadata !== false,
+            verbose: options.verbose,
+        });
+    }
+    catch (error) {
+        ui.displayError(t('errors.reverseSync.failed'), error);
+        process.exit(1);
+    }
+});
 program
     .command('serve')
     .description('Start passthrough server for external AI agents (stdin/stdout JSON)')
@@ -434,6 +476,57 @@ program
         process.exit(1);
     }
 });
+// MCP Install Command
+program
+    .command('mcp:install [tool]')
+    .description(t('commands.mcpInstall.description'))
+    .option('-g, --global', t('commands.mcpInstall.options.global'), true)
+    .option('-l, --local', t('commands.mcpInstall.options.local'))
+    .option('--dry-run', t('commands.mcpInstall.options.dryRun'))
+    .option('-v, --verbose', t('commands.mcpInstall.options.verbose'))
+    .action(async (tool, options) => {
+    try {
+        const mcpInstallService = new mcp_1.MCPInstallService({ ui, t, version: version_1.VERSION });
+        // If no tool specified and not in CI, show interactive prompt
+        if (!tool && process.stdin.isTTY) {
+            const supportedTools = mcpInstallService.getSupportedTools();
+            const detectedTools = await mcpInstallService.detectInstalledTools();
+            const choices = supportedTools.map(tool => ({
+                name: detectedTools.includes(tool.id)
+                    ? `${tool.displayName} (${t('labels.detected')})`
+                    : tool.displayName,
+                value: tool.id,
+            }));
+            choices.unshift({
+                name: t('commands.mcpInstall.allDetected'),
+                value: 'all',
+            });
+            const { selectedTool } = await inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'selectedTool',
+                    message: t('commands.mcpInstall.selectTool'),
+                    choices,
+                },
+            ]);
+            tool = selectedTool;
+        }
+        const result = await mcpInstallService.run({
+            tool,
+            global: options.local ? false : options.global,
+            dryRun: options.dryRun,
+            verbose: options.verbose,
+            repoPath: process.cwd(),
+        });
+        if (result.installations.length > 0) {
+            ui.displayInfo('MCP', t('info.mcp.restartTools'));
+        }
+    }
+    catch (error) {
+        ui.displayError(t('errors.mcp.installFailed', { tool: tool || 'unknown' }), error);
+        process.exit(1);
+    }
+});
 // Smart Start Command
 program
     .command('start')
@@ -732,7 +825,7 @@ workflowCommand
     .command('init <name>')
     .description('Initialize a new PREVC workflow')
     .option('-d, --description <text>', 'Project description for scale detection')
-    .option('-s, --scale <scale>', 'Project scale: QUICK, SMALL, MEDIUM, LARGE, ENTERPRISE')
+    .option('-s, --scale <scale>', 'Project scale: QUICK, SMALL, MEDIUM, LARGE')
     .option('-r, --repo-path <path>', 'Repository path', process.cwd())
     .action(async (name, options) => {
     try {
@@ -921,6 +1014,11 @@ async function selectLocale(showWelcome) {
 }
 async function runInteractive() {
     await selectLocale(false); // Don't show welcome yet
+    // Ask user if they want to load environment variables from .env
+    const loadEnv = await (0, prompts_1.promptLoadEnv)(t);
+    if (loadEnv) {
+        dotenv.config();
+    }
     // Show welcome screen with PREVC explanation
     ui.displayWelcome(version_1.VERSION);
     ui.displayPrevcExplanation();
@@ -982,18 +1080,19 @@ async function runInteractive() {
                 message: t('prompts.main.action'),
                 choices: [
                     { name: t('prompts.main.choice.quickSetup'), value: 'create' },
-                    { name: t('prompts.main.choice.scaffoldOnly'), value: 'scaffold' },
+                    { name: t('prompts.main.choice.enhanceWithAI'), value: 'enhance' },
                     { name: t('prompts.main.choice.exit'), value: 'exit' }
                 ]
             }
         ]);
         if (action === 'create') {
-            // Run init + fill with AI + LSP automatically
+            // Quick Setup: scaffold with semantic autoFill (no AI required)
             await runQuickSetup(projectPath);
         }
-        else if (action === 'scaffold') {
-            // Scaffold only without AI fill
-            await runInteractiveScaffold();
+        else if (action === 'enhance') {
+            // First scaffold, then enhance with AI
+            await runQuickSetup(projectPath);
+            await runEnhanceWithAI(projectPath);
         }
         return;
     }
@@ -1023,44 +1122,13 @@ async function runInteractive() {
     await runFullMenu(result.state === 'outdated' ? result.details.daysBehind : undefined);
 }
 async function runQuickSetup(projectPath) {
-    // AI-first: Detect smart defaults automatically
-    const defaults = await (0, prompts_1.detectSmartDefaults)();
-    // If no API key found, prompt for one
-    let llmConfig = null;
-    if (defaults.apiKeyConfigured && defaults.provider) {
-        // Auto-detected config
-        llmConfig = {
-            provider: defaults.provider,
-            model: DEFAULT_MODEL,
-            apiKey: (0, providerFactory_1.getApiKeyFromEnv)(defaults.provider),
-        };
-        console.log(theme_1.colors.secondary(`  Auto-detected: ${defaults.provider} API key found`));
-    }
-    else {
-        // Need to get API key from user
-        llmConfig = await (0, prompts_1.promptLLMConfig)(t);
-        if (!llmConfig) {
-            ui.displayInfo(t('info.setup.incomplete.title'), t('info.setup.incomplete.detail'));
-            return;
-        }
-    }
-    const { confirm } = await inquirer_1.default.prompt([
-        {
-            type: 'confirm',
-            name: 'confirm',
-            message: t('prompts.setup.confirmContinue'),
-            default: true
-        }
-    ]);
-    if (!confirm) {
-        return;
-    }
-    // Run init with semantic analysis
+    // Quick Setup: Always creates scaffolds with semantic autoFill (no AI required)
     ui.startSpinner(t('spinner.setup.creatingStructure'));
     try {
         const localInitService = new initService_1.InitService({ ui, t, version: version_1.VERSION });
         await localInitService.run(projectPath, 'both', {
-            semantic: true
+            semantic: true,
+            autoFill: true // Always use autoFill for semantic-based content
         });
         ui.stopSpinner();
     }
@@ -1069,7 +1137,7 @@ async function runQuickSetup(projectPath) {
         ui.displayError('Failed to create structure', error);
         return;
     }
-    // Initialize skills too (AI-first)
+    // Initialize skills too
     try {
         const { createSkillGenerator } = await Promise.resolve().then(() => __importStar(require('./generators/skills')));
         const skillGenerator = createSkillGenerator({ repoPath: projectPath });
@@ -1078,26 +1146,65 @@ async function runQuickSetup(projectPath) {
     catch {
         // Skills init failure is not critical
     }
-    // Fill with AI + LSP (default behavior)
-    ui.startSpinner(t('spinner.setup.fillingDocs'));
-    try {
-        const localFillService = new fillService_1.FillService({ ui, t, version: version_1.VERSION, defaultModel: DEFAULT_MODEL });
-        await localFillService.run(projectPath, {
-            model: llmConfig.model,
-            provider: llmConfig.provider,
-            apiKey: llmConfig.apiKey,
-            baseUrl: llmConfig.baseUrl,
-            verbose: false,
-            semantic: true,
-            useLsp: true // LSP enabled by default
-        });
-        ui.stopSpinner();
-        ui.displaySuccess(t('success.setup.docsCreated'));
-        console.log(theme_1.colors.secondaryDim(`  ${t('info.setup.reviewFiles')}`));
+    ui.displaySuccess(t('success.setup.scaffoldCreated'));
+    console.log(theme_1.colors.secondaryDim(`  ${t('info.setup.enhanceWithAI')}`));
+}
+async function runEnhanceWithAI(projectPath) {
+    // Enhance existing scaffolds with AI
+    const defaults = await (0, prompts_1.detectSmartDefaults)();
+    if (!defaults.apiKeyConfigured || !defaults.provider) {
+        // Need to get API key from user
+        const llmConfig = await (0, prompts_1.promptLLMConfig)(t);
+        if (!llmConfig) {
+            ui.displayInfo(t('info.setup.incomplete.title'), t('info.setup.incomplete.detail'));
+            return;
+        }
+        ui.startSpinner(t('spinner.setup.fillingDocs'));
+        try {
+            const localFillService = new fillService_1.FillService({ ui, t, version: version_1.VERSION, defaultModel: DEFAULT_MODEL });
+            await localFillService.run(projectPath, {
+                model: llmConfig.model,
+                provider: llmConfig.provider,
+                apiKey: llmConfig.apiKey,
+                baseUrl: llmConfig.baseUrl,
+                verbose: false,
+                semantic: true,
+                useLsp: true
+            });
+            ui.stopSpinner();
+            ui.displaySuccess(t('success.setup.docsCreated'));
+        }
+        catch (error) {
+            ui.stopSpinner();
+            ui.displayError('Failed to fill documentation', error);
+        }
     }
-    catch (error) {
-        ui.stopSpinner();
-        ui.displayError('Failed to fill documentation', error);
+    else {
+        // Auto-detected API key
+        console.log(theme_1.colors.secondary(`  Auto-detected: ${defaults.provider} API key found`));
+        const llmConfig = {
+            provider: defaults.provider,
+            model: DEFAULT_MODEL,
+            apiKey: (0, providerFactory_1.getApiKeyFromEnv)(defaults.provider),
+        };
+        ui.startSpinner(t('spinner.setup.fillingDocs'));
+        try {
+            const localFillService = new fillService_1.FillService({ ui, t, version: version_1.VERSION, defaultModel: DEFAULT_MODEL });
+            await localFillService.run(projectPath, {
+                model: llmConfig.model,
+                provider: llmConfig.provider,
+                apiKey: llmConfig.apiKey,
+                verbose: false,
+                semantic: true,
+                useLsp: true
+            });
+            ui.stopSpinner();
+            ui.displaySuccess(t('success.setup.docsCreated'));
+        }
+        catch (error) {
+            ui.stopSpinner();
+            ui.displayError('Failed to fill documentation', error);
+        }
     }
 }
 async function runFullMenu(daysBehind) {
@@ -1110,6 +1217,7 @@ async function runFullMenu(daysBehind) {
         const choices = [
             // Quick Actions (most used)
             { name: t('prompts.main.choice.quickSync'), value: 'quickSync' },
+            { name: t('prompts.main.choice.reverseSync'), value: 'reverseSync' },
             { name: t('prompts.main.choice.startWorkflow'), value: 'workflow' },
             { name: t('prompts.main.choice.createPlan'), value: 'plan' },
             new inquirer_1.default.Separator(),
@@ -1142,6 +1250,9 @@ async function runFullMenu(daysBehind) {
         if (action === 'quickSync') {
             await runQuickSync();
         }
+        else if (action === 'reverseSync') {
+            await runReverseSync();
+        }
         else if (action === 'scaffold') {
             await runInteractiveScaffold();
         }
@@ -1235,9 +1346,10 @@ async function runInteractiveScaffold() {
     if (scaffoldSkills) {
         try {
             const { createSkillGenerator } = await Promise.resolve().then(() => __importStar(require('./generators/skills')));
+            const relativeOutputDir = path.relative(resolvedRepo, outputDir);
             const generator = createSkillGenerator({
                 repoPath: resolvedRepo,
-                outputDir
+                outputDir: relativeOutputDir || '.context'
             });
             // Display step for skills scaffolding
             const stepNumber = (scaffoldDocs || scaffoldAgents) ? 4 : 1;
@@ -1703,8 +1815,7 @@ async function createNewWorkflow(workflowService) {
                 { name: t('prompts.workflow.scale.quick'), value: 'QUICK' },
                 { name: t('prompts.workflow.scale.small'), value: 'SMALL' },
                 { name: t('prompts.workflow.scale.medium'), value: 'MEDIUM' },
-                { name: t('prompts.workflow.scale.large'), value: 'LARGE' },
-                { name: t('prompts.workflow.scale.enterprise'), value: 'ENTERPRISE' }
+                { name: t('prompts.workflow.scale.large'), value: 'LARGE' }
             ],
             default: ''
         }
@@ -2127,6 +2238,102 @@ async function runQuickSync() {
     }
     ui.displaySuccess(t('success.quickSync.complete'));
 }
+// ============================================================================
+// Reverse Quick Sync - Import from AI tool directories
+// ============================================================================
+async function runReverseSync() {
+    const projectPath = process.cwd();
+    // Create service
+    const reverseSyncService = new reverseSync_1.ReverseQuickSyncService({
+        ui,
+        t,
+        version: version_1.VERSION,
+    });
+    // Step 1: Detect available tools
+    ui.startSpinner(t('prompts.reverseSync.detecting'));
+    const detection = await reverseSyncService.detect(projectPath);
+    ui.stopSpinner();
+    if (detection.summary.totalFiles === 0) {
+        ui.displayWarning(t('prompts.reverseSync.noFilesFound'));
+        return;
+    }
+    // Display detection summary
+    console.log('');
+    console.log(t('prompts.reverseSync.detected'));
+    console.log('');
+    for (const tool of detection.tools) {
+        if (tool.detected) {
+            const parts = [];
+            if (tool.counts.rules > 0)
+                parts.push(`${tool.counts.rules} rules`);
+            if (tool.counts.agents > 0)
+                parts.push(`${tool.counts.agents} agents`);
+            if (tool.counts.skills > 0)
+                parts.push(`${tool.counts.skills} skills`);
+            console.log(`  ${theme_1.colors.success('✓')} ${theme_1.colors.primary(tool.displayName)} (${parts.join(', ')})`);
+        }
+    }
+    console.log('');
+    // Step 2: Select components to import
+    const { components } = await inquirer_1.default.prompt([
+        {
+            type: 'checkbox',
+            name: 'components',
+            message: t('prompts.reverseSync.selectComponents'),
+            choices: [
+                {
+                    name: `Rules (${detection.summary.totalRules} files)`,
+                    value: 'rules',
+                    checked: detection.summary.totalRules > 0,
+                    disabled: detection.summary.totalRules === 0,
+                },
+                {
+                    name: `Agents (${detection.summary.totalAgents} files)`,
+                    value: 'agents',
+                    checked: detection.summary.totalAgents > 0,
+                    disabled: detection.summary.totalAgents === 0,
+                },
+                {
+                    name: `Skills (${detection.summary.totalSkills} files)`,
+                    value: 'skills',
+                    checked: detection.summary.totalSkills > 0,
+                    disabled: detection.summary.totalSkills === 0,
+                },
+            ],
+        },
+    ]);
+    if (components.length === 0) {
+        ui.displayWarning(t('prompts.reverseSync.noComponentsSelected'));
+        return;
+    }
+    // Step 3: Select merge strategy
+    const { mergeStrategy } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'mergeStrategy',
+            message: t('prompts.reverseSync.mergeStrategy'),
+            choices: [
+                { name: t('prompts.reverseSync.strategy.skip'), value: 'skip' },
+                { name: t('prompts.reverseSync.strategy.overwrite'), value: 'overwrite' },
+                { name: t('prompts.reverseSync.strategy.merge'), value: 'merge' },
+                { name: t('prompts.reverseSync.strategy.rename'), value: 'rename' },
+            ],
+        },
+    ]);
+    // Step 4: Run import
+    const result = await reverseSyncService.run(projectPath, {
+        skipRules: !components.includes('rules'),
+        skipAgents: !components.includes('agents'),
+        skipSkills: !components.includes('skills'),
+        mergeStrategy,
+        verbose: false,
+    });
+    // Display result
+    const totalImported = result.rulesImported + result.agentsImported + result.skillsImported;
+    if (totalImported > 0) {
+        ui.displaySuccess(t('success.reverseSync.complete', { count: totalImported }));
+    }
+}
 async function runManageAgents() {
     const projectPath = process.cwd();
     let continueMenu = true;