@esotech/contextuate 2.1.0 → 2.1.2

package/dist/commands/init.js

@@ -9,6 +9,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = require("fs");
+const tools_1 = require("../utils/tools");
 // Get package version dynamically
 function getPackageVersion() {
     try {
@@ -19,7 +20,7 @@ function getPackageVersion() {
         return '0.0.0';
     }
 }
-// Get package info for version.json
+// Get package info for contextuate.json
 function getPackageInfo() {
     try {
         const packageJson = JSON.parse((0, fs_1.readFileSync)(path_1.default.join(__dirname, '../../package.json'), 'utf-8'));
@@ -70,10 +71,45 @@ function fuzzyMatchPlatform(input) {
     }
     return null;
 }
+// Get template source directory
+function getTemplateSource() {
+    let templateSource = path_1.default.join(__dirname, '../templates');
+    // Handle ts-node vs compiled paths
+    if (path_1.default.basename(path_1.default.join(__dirname, '..')) === 'src') {
+        templateSource = path_1.default.join(__dirname, '../../src/templates');
+    }
+    else if (path_1.default.basename(__dirname) === 'commands') {
+        templateSource = path_1.default.join(__dirname, '../templates');
+    }
+    if (!fs_extra_1.default.existsSync(templateSource)) {
+        templateSource = path_1.default.join(__dirname, '../../templates');
+    }
+    return templateSource;
+}
+// Discover available agents from template source
+async function discoverAgents(templateSource) {
+    const agentDir = path_1.default.join(templateSource, 'agents');
+    if (!fs_extra_1.default.existsSync(agentDir)) {
+        return [];
+    }
+    const files = await fs_extra_1.default.readdir(agentDir);
+    return files
+        .filter(f => f.endsWith('.md'))
+        .map(f => f.replace('.md', ''));
+}
+// Discover available skills from template source
+async function discoverSkills(templateSource) {
+    const commandsDir = path_1.default.join(templateSource, 'commands');
+    if (!fs_extra_1.default.existsSync(commandsDir)) {
+        return [];
+    }
+    const files = await fs_extra_1.default.readdir(commandsDir);
+    return files
+        .filter(f => f.endsWith('.md'))
+        .map(f => f.replace('.md', ''));
+}
 async function initCommand(platformArgs, options) {
     // Handle both old signature (no args) and new signature (with variadic args)
-    // When called with no args: first param is options object
-    // When called with args: first param is array, second param is options
     let platforms = [];
     let opts = {};
     if (Array.isArray(platformArgs)) {
@@ -81,14 +117,12 @@ async function initCommand(platformArgs, options) {
         opts = options || {};
     }
     else {
-        // Old signature - first param is actually options
         opts = platformArgs || {};
         platforms = [];
     }
     console.log(chalk_1.default.blue('╔════════════════════════════════════════╗'));
     console.log(chalk_1.default.blue('║     Contextuate Installer              ║'));
     console.log(chalk_1.default.blue('║     AI Context Framework               ║'));
-    console.log(chalk_1.default.blue('║                                        ║'));
     console.log(chalk_1.default.blue('╚════════════════════════════════════════╝'));
     console.log('');
     try {
@@ -113,18 +147,23 @@ async function initCommand(platformArgs, options) {
             }
         }
         else if (!hasMarker && nonInteractive) {
-            console.log(chalk_1.default.yellow('[WARN] No project markers found (.git, package.json, etc.) - continuing anyway in non-interactive mode'));
+            console.log(chalk_1.default.yellow('[WARN] No project markers found - continuing anyway'));
         }
+        // Get template source
+        const templateSource = getTemplateSource();
+        if (!fs_extra_1.default.existsSync(templateSource)) {
+            console.error(chalk_1.default.red(`[ERROR] Could not find template source at ${templateSource}`));
+            return;
+        }
+        // Determine selected platforms
         let selectedPlatforms = [];
-        // Non-interactive mode - process CLI arguments
         if (nonInteractive) {
-            // Check for "all" argument
+            // Non-interactive: parse CLI arguments
             if (platforms.some(arg => arg.toLowerCase() === 'all')) {
                 selectedPlatforms = PLATFORMS;
                 console.log(chalk_1.default.blue('[INFO] Installing all platforms'));
             }
             else {
-                // Fuzzy match each platform argument
                 for (const arg of platforms) {
                     const matchedId = fuzzyMatchPlatform(arg);
                     if (matchedId) {
@@ -146,126 +185,46 @@ async function initCommand(platformArgs, options) {
             }
         }
         else {
-            // Interactive mode - ask about platform selection
-            const { platforms } = await inquirer_1.default.prompt([
-                {
-                    type: 'checkbox',
-                    name: 'platforms',
-                    message: 'Select the platforms to install:',
-                    choices: [
-                        { name: 'Select All', value: 'all' },
-                        new inquirer_1.default.Separator(),
-                        ...PLATFORMS.map(p => ({
-                            name: p.name,
-                            value: p.id,
-                            checked: false,
-                        }))
-                    ],
-                    validate: (answer) => {
-                        if (answer.length < 1) {
-                            return 'You must select at least one platform.';
-                        }
-                        return true;
-                    },
-                },
-            ]);
-            if (platforms.includes('all')) {
-                selectedPlatforms = PLATFORMS;
+            // Interactive: default to Claude Code (opinionated)
+            const claudePlatform = PLATFORMS.find(p => p.id === 'claude');
+            if (claudePlatform) {
+                selectedPlatforms = [claudePlatform];
+                console.log(chalk_1.default.blue(`[INFO] Installing for ${claudePlatform.name} (default)`));
             }
-            else {
-                selectedPlatforms = PLATFORMS.filter(p => platforms.includes(p.id));
-            }
-        }
-        // Handle agent installation
-        let selectedAgents = [];
-        // Dynamically discover available agents from template source
-        let agentTemplateDir = path_1.default.join(__dirname, '../templates/agents');
-        // Handle ts-node vs compiled paths
-        if (path_1.default.basename(path_1.default.join(__dirname, '..')) === 'src') {
-            agentTemplateDir = path_1.default.join(__dirname, '../../src/templates/agents');
-        }
-        else if (path_1.default.basename(__dirname) === 'commands') {
-            agentTemplateDir = path_1.default.join(__dirname, '../templates/agents');
-        }
-        if (!fs_extra_1.default.existsSync(agentTemplateDir)) {
-            agentTemplateDir = path_1.default.join(__dirname, '../../templates/agents');
-        }
-        let availableAgents = [];
-        if (fs_extra_1.default.existsSync(agentTemplateDir)) {
-            const agentFiles = await fs_extra_1.default.readdir(agentTemplateDir);
-            availableAgents = agentFiles
-                .filter(f => f.endsWith('.md'))
-                .map(f => f.replace('.md', ''));
-        }
-        if (opts.agents && opts.agents.length > 0) {
-            // Non-interactive agent selection via --agents flag
-            if (opts.agents.includes('none')) {
-                // Explicitly skip agent installation
-                console.log(chalk_1.default.blue('[INFO] Skipping agent installation (--agents none)'));
-            }
-            else if (opts.agents.includes('all')) {
-                selectedAgents = availableAgents;
-                console.log(chalk_1.default.blue('[INFO] Installing all agents'));
-            }
-            else {
-                // Match specific agents
-                for (const agentArg of opts.agents) {
-                    const normalized = agentArg.toLowerCase().trim();
-                    const matched = availableAgents.find(a => a.toLowerCase() === normalized);
-                    if (matched) {
-                        selectedAgents.push(matched);
-                        console.log(chalk_1.default.green(`[OK] Matched agent "${agentArg}" to ${matched}`));
-                    }
-                    else {
-                        console.log(chalk_1.default.yellow(`[WARN] Could not match agent "${agentArg}" - skipping`));
-                    }
-                }
-                if (selectedAgents.length === 0 && opts.agents.length > 0) {
-                    console.log(chalk_1.default.yellow('[WARN] No valid agents matched. Available agents:'));
-                    availableAgents.forEach(a => console.log(`  - ${a}`));
-                }
-            }
-        }
-        else if (!nonInteractive) {
-            // Interactive mode - ask about agent installation
-            const { installAgents } = await inquirer_1.default.prompt([
+            // Ask if they want additional platforms
+            const { addMorePlatforms } = await inquirer_1.default.prompt([
                 {
                     type: 'confirm',
-                    name: 'installAgents',
-                    message: 'Would you like to install pre-built AI agents?',
-                    default: true,
+                    name: 'addMorePlatforms',
+                    message: 'Would you like to add other platforms?',
+                    default: false,
                 },
             ]);
-            if (installAgents && availableAgents.length > 0) {
-                const { agents } = await inquirer_1.default.prompt([
+            if (addMorePlatforms) {
+                const otherPlatforms = PLATFORMS.filter(p => p.id !== 'claude');
+                const { additionalPlatforms } = await inquirer_1.default.prompt([
                     {
                         type: 'checkbox',
-                        name: 'agents',
-                        message: 'Select agents to install:',
-                        choices: [
-                            { name: 'Select All', value: 'all' },
-                            new inquirer_1.default.Separator(),
-                            ...availableAgents.map(agent => ({
-                                name: agent.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' '),
-                                value: agent,
-                                checked: false,
-                            }))
-                        ],
+                        name: 'additionalPlatforms',
+                        message: 'Select additional platforms:',
+                        choices: otherPlatforms.map(p => ({
+                            name: p.name,
+                            value: p.id,
+                            checked: false,
+                        })),
                     },
                 ]);
-                if (agents.includes('all')) {
-                    selectedAgents = availableAgents;
-                }
-                else {
-                    selectedAgents = agents;
+                for (const platformId of additionalPlatforms) {
+                    const platform = PLATFORMS.find(p => p.id === platformId);
+                    if (platform) {
+                        selectedPlatforms.push(platform);
+                    }
                 }
             }
         }
-        else {
-            // Non-interactive mode without --agents flag: default to all agents
-            selectedAgents = availableAgents;
-            console.log(chalk_1.default.blue('[INFO] Installing all agents (default in non-interactive mode)'));
-        }
+        // Discover all agents and skills
+        const availableAgents = await discoverAgents(templateSource);
+        const availableSkills = await discoverSkills(templateSource);
         console.log('');
         console.log(chalk_1.default.blue('[INFO] Installing Contextuate framework...'));
         console.log('');
@@ -287,170 +246,142 @@ async function initCommand(platformArgs, options) {
             await fs_extra_1.default.ensureDir(dir);
             console.log(chalk_1.default.green(`[OK] Created directory: ${dir}`));
         }
-        // Cleanup legacy template directories if they exist
-        const legacyDirs = [
-            'docs/ai/.contextuate/templates',
-        ];
+        // Cleanup legacy directories
+        const legacyDirs = ['docs/ai/.contextuate/templates'];
         for (const dir of legacyDirs) {
             if (fs_extra_1.default.existsSync(dir)) {
                 await fs_extra_1.default.remove(dir);
                 console.log(chalk_1.default.yellow(`[CLEANUP] Removed legacy directory: ${dir}`));
             }
         }
+        // Cleanup legacy version.json (replaced by contextuate.json)
+        const legacyVersionJson = 'docs/ai/.contextuate/version.json';
+        if (fs_extra_1.default.existsSync(legacyVersionJson)) {
+            await fs_extra_1.default.remove(legacyVersionJson);
+            console.log(chalk_1.default.yellow(`[CLEANUP] Removed legacy version.json (migrated to contextuate.json)`));
+        }
         console.log('');
-        // 2. Copy templates
+        // 2. Detect tools
+        console.log(chalk_1.default.blue('[INFO] Checking for optional tools...'));
+        let tools = (0, tools_1.detectTools)();
+        (0, tools_1.printToolStatus)(tools);
+        // Offer to install missing tools
+        tools = await (0, tools_1.promptInstallTools)(tools, nonInteractive);
+        console.log('');
+        // 3. Copy framework files
         console.log(chalk_1.default.blue('[INFO] Installing framework files...'));
-        // In development (ts-node), this is ../../src/templates relative to src/commands/init.ts
-        // In production (dist), this is ../templates relative to dist/commands/init.js
-        let templateSource = path_1.default.join(__dirname, '../templates');
-        // If running from src/commands (ts-node), we need to go up one more level if structure is src/commands/init.ts
-        if (path_1.default.basename(path_1.default.join(__dirname, '..')) === 'src') {
-            templateSource = path_1.default.join(__dirname, '../../src/templates');
-        }
-        else if (path_1.default.basename(__dirname) === 'commands') {
-            // dist/commands/init.js -> dist/templates
-            templateSource = path_1.default.join(__dirname, '../templates');
-        }
-        // Fallback/Verify
-        if (!fs_extra_1.default.existsSync(templateSource)) {
-            // Try one level up just in case
-            templateSource = path_1.default.join(__dirname, '../../templates');
-        }
-        if (!fs_extra_1.default.existsSync(templateSource)) {
-            console.error(chalk_1.default.red(`[ERROR] Could not find template source at ${templateSource}`));
-            return;
-        }
         const installDir = 'docs/ai/.contextuate';
-        // Helper to copy files
-        const copyFile = async (src, dest) => {
-            // Resolve absolute paths to check for equality
+        // Helper to copy and process files
+        const copyFile = async (src, dest, processTemplates = false) => {
             const absSrc = path_1.default.resolve(src);
             const absDest = path_1.default.resolve(dest);
-            if (absSrc === absDest) {
+            if (absSrc === absDest)
                 return;
-            }
             if (!fs_extra_1.default.existsSync(src)) {
                 console.log(chalk_1.default.red(`[ERROR] Source file missing: ${src}`));
                 return;
             }
-            if (fs_extra_1.default.existsSync(dest) && !opts.force) {
-                console.log(chalk_1.default.yellow(`[WARN] Skipped (exists): ${dest}`));
+            // Only context.md is protected from overwrites
+            const isContextMd = path_1.default.basename(dest) === 'context.md';
+            if (isContextMd && fs_extra_1.default.existsSync(dest)) {
+                console.log(chalk_1.default.yellow(`[PRESERVE] Kept existing: ${dest}`));
                 return;
             }
-            await fs_extra_1.default.copy(src, dest);
+            let content = await fs_extra_1.default.readFile(src, 'utf-8');
+            // Process template variables if needed
+            if (processTemplates && dest.endsWith('.md')) {
+                content = (0, tools_1.processTemplateVariables)(content, tools);
+            }
+            await fs_extra_1.default.ensureDir(path_1.default.dirname(dest));
+            await fs_extra_1.default.writeFile(dest, content);
             console.log(chalk_1.default.green(`[OK] Created: ${dest}`));
         };
-        // Copy core engine files only to .contextuate
-        // Generate version.json dynamically from package.json
-        const pkgInfo = getPackageInfo();
-        const versionData = {
-            name: pkgInfo.name,
-            version: pkgInfo.version,
-            description: pkgInfo.description,
-            repository: pkgInfo.repository,
-            installed: new Date().toISOString(),
-            updated: new Date().toISOString()
-        };
-        await fs_extra_1.default.writeFile(path_1.default.join(installDir, 'version.json'), JSON.stringify(versionData, null, 2));
-        console.log(chalk_1.default.green(`[OK] Created: ${path_1.default.join(installDir, 'version.json')}`));
-        await copyFile(path_1.default.join(templateSource, 'README.md'), path_1.default.join(installDir, 'README.md'));
-        // Copy directories - only core framework files
-        const copyDirContents = async (srcSubDir, destDir) => {
+        // Copy directories with template processing
+        const copyDirContents = async (srcSubDir, destDir, processTemplates = false) => {
             const srcDir = path_1.default.join(templateSource, srcSubDir);
             if (fs_extra_1.default.existsSync(srcDir)) {
                 await fs_extra_1.default.ensureDir(destDir);
                 const files = await fs_extra_1.default.readdir(srcDir);
                 for (const file of files) {
-                    await copyFile(path_1.default.join(srcDir, file), path_1.default.join(destDir, file));
+                    await copyFile(path_1.default.join(srcDir, file), path_1.default.join(destDir, file), processTemplates);
                 }
             }
         };
-        // Copy core standards, tools, and framework agents to .contextuate (engine files)
+        // Copy README
+        await copyFile(path_1.default.join(templateSource, 'README.md'), path_1.default.join(installDir, 'README.md'));
+        // Copy core standards, tools, and framework agents
         await copyDirContents('standards', path_1.default.join(installDir, 'standards'));
         await copyDirContents('tools', path_1.default.join(installDir, 'tools'));
         await copyDirContents('framework-agents', path_1.default.join(installDir, 'agents'));
         console.log(chalk_1.default.green('[OK] Copied framework files'));
         console.log('');
-        // 3. Install selected agents to docs/ai/agents/
-        if (selectedAgents.length > 0) {
-            console.log(chalk_1.default.blue('[INFO] Installing selected agents...'));
-            for (const agent of selectedAgents) {
-                const agentFile = `${agent}.md`;
-                const srcPath = path_1.default.join(templateSource, 'agents', agentFile);
-                const destPath = path_1.default.join('docs/ai/agents', agentFile);
-                await copyFile(srcPath, destPath);
+        // 4. Install ALL agents (opinionated - no prompt)
+        if (availableAgents.length > 0) {
+            console.log(chalk_1.default.blue(`[INFO] Installing agents (${availableAgents.length} agents)...`));
+            for (const agent of availableAgents) {
+                const srcPath = path_1.default.join(templateSource, 'agents', `${agent}.md`);
+                const destPath = path_1.default.join('docs/ai/agents', `${agent}.md`);
+                await copyFile(srcPath, destPath, true); // Process templates
             }
-            console.log(chalk_1.default.green(`[OK] Installed ${selectedAgents.length} agent(s) to docs/ai/agents/`));
+            console.log(chalk_1.default.green(`[OK] Installed ${availableAgents.length} agent(s)`));
             console.log('');
         }
-        // 4. Setup project context files
+        // 5. Install ALL skills (opinionated - no prompt)
+        if (availableSkills.length > 0) {
+            console.log(chalk_1.default.blue(`[INFO] Installing skills (${availableSkills.length} skills)...`));
+            for (const skill of availableSkills) {
+                const srcPath = path_1.default.join(templateSource, 'commands', `${skill}.md`);
+                const destPath = path_1.default.join('docs/ai/commands', `${skill}.md`);
+                await copyFile(srcPath, destPath, true); // Process templates
+            }
+            console.log(chalk_1.default.green(`[OK] Installed ${availableSkills.length} skill(s)`));
+            console.log('');
+        }
+        // 6. Setup project context files
         console.log(chalk_1.default.blue('[INFO] Setting up project context...'));
-        // Copy contextuate.md (main entry point) directly from templates to docs/ai/.contextuate/ (protected)
         await copyFile(path_1.default.join(templateSource, 'templates/contextuate.md'), 'docs/ai/.contextuate/contextuate.md');
-        // Copy context.md (user customizable) directly from templates to docs/ai/
-        // IMPORTANT: Never overwrite context.md even with --force, as it contains project-specific context
-        const contextMdPath = 'docs/ai/context.md';
-        if (fs_extra_1.default.existsSync(contextMdPath)) {
-            console.log(chalk_1.default.yellow(`[WARN] Preserved (project context): ${contextMdPath}`));
-        }
-        else {
-            await copyFile(path_1.default.join(templateSource, 'templates/context.md'), contextMdPath);
-        }
+        await copyFile(path_1.default.join(templateSource, 'templates/context.md'), 'docs/ai/context.md');
         console.log('');
-        // 5. Generate jump files for selected platforms
-        console.log(chalk_1.default.blue('[INFO] Generating platform jump files...'));
+        // 7. Generate platform files
+        console.log(chalk_1.default.blue('[INFO] Generating platform files...'));
         for (const platform of selectedPlatforms) {
             if (platform.ensureDir) {
                 await fs_extra_1.default.ensureDir(platform.ensureDir);
             }
-            // Copy directly from template source, not from .contextuate
             await copyFile(path_1.default.join(templateSource, platform.src), platform.dest);
         }
         console.log('');
-        // 6. Create platform-specific symlinks (only for platforms that need them)
+        // 8. Create symlinks for platforms that need them
         const platformsWithSymlinks = selectedPlatforms.filter(p => p.symlinks);
         if (platformsWithSymlinks.length > 0) {
             console.log(chalk_1.default.blue('[INFO] Creating platform symlinks...'));
-            // Helper to create symlinks
             const createSymlink = async (target, linkPath) => {
                 const linkDir = path_1.default.dirname(linkPath);
                 await fs_extra_1.default.ensureDir(linkDir);
-                // Calculate relative path from link location to target
                 const relativeTarget = path_1.default.relative(linkDir, target);
-                // Check if symlink already exists
                 try {
                     const existingLink = await fs_extra_1.default.readlink(linkPath);
                     if (existingLink === relativeTarget) {
-                        console.log(chalk_1.default.yellow(`[WARN] Symlink exists: ${linkPath} -> ${relativeTarget}`));
+                        console.log(chalk_1.default.yellow(`[SKIP] Symlink exists: ${linkPath}`));
                         return;
                     }
-                    // Remove existing symlink if it points elsewhere
                     await fs_extra_1.default.remove(linkPath);
                 }
                 catch {
-                    // Not a symlink or doesn't exist
                     if (fs_extra_1.default.existsSync(linkPath)) {
-                        if (opts.force) {
-                            await fs_extra_1.default.remove(linkPath);
-                        }
-                        else {
-                            console.log(chalk_1.default.yellow(`[WARN] Skipped (path exists): ${linkPath}`));
-                            return;
-                        }
+                        await fs_extra_1.default.remove(linkPath);
                     }
                 }
                 await fs_extra_1.default.ensureSymlink(relativeTarget, linkPath);
                 console.log(chalk_1.default.green(`[OK] Symlink: ${linkPath} -> ${relativeTarget}`));
             };
-            // Create symlinks for Claude Code
+            // Claude Code symlinks
             if (selectedPlatforms.some(p => p.id === 'claude')) {
                 const symlinks = [
                     { target: 'docs/ai/commands', link: '.claude/commands' },
                     { target: 'docs/ai/agents', link: '.claude/agents' },
                     { target: 'docs/ai/hooks', link: '.claude/hooks' },
                     { target: 'docs/ai/skills', link: '.claude/skills' },
-                    // Link .contextuate so relative paths from agents work correctly
-                    // (e.g., ../.contextuate/agents/base.md resolves properly)
                     { target: 'docs/ai/.contextuate', link: '.claude/.contextuate' },
                 ];
                 for (const symlink of symlinks) {
@@ -459,6 +390,20 @@ async function initCommand(platformArgs, options) {
             }
             console.log('');
         }
+        // 9. Create contextuate.json
+        console.log(chalk_1.default.blue('[INFO] Creating contextuate.json...'));
+        const pkgInfo = getPackageInfo();
+        const now = new Date().toISOString();
+        const config = {
+            ...pkgInfo,
+            initialized: now,
+            updated: now,
+            tools
+        };
+        await (0, tools_1.writeContextuateConfig)(installDir, config);
+        console.log(chalk_1.default.green('[OK] Created contextuate.json'));
+        console.log('');
+        // Summary
         console.log(chalk_1.default.green('╔════════════════════════════════════════╗'));
         console.log(chalk_1.default.green('║     Installation Complete!             ║'));
         console.log(chalk_1.default.green('╚════════════════════════════════════════╝'));
@@ -468,44 +413,35 @@ async function initCommand(platformArgs, options) {
             console.log(`  - ${chalk_1.default.cyan(platform.name)} (${platform.dest})`);
         }
         console.log('');
-        if (selectedAgents.length > 0) {
-            console.log('Installed agents:');
-            for (const agent of selectedAgents) {
-                console.log(`  - ${chalk_1.default.cyan(agent)} (docs/ai/agents/${agent}.md)`);
-            }
-            console.log('');
-        }
-        console.log('Next steps:');
+        console.log(`Installed: ${chalk_1.default.cyan(availableAgents.length)} agents, ${chalk_1.default.cyan(availableSkills.length)} skills`);
         console.log('');
-        console.log(`  1. Edit ${chalk_1.default.blue('docs/ai/context.md')} with your project details`);
-        if (selectedAgents.length > 0) {
-            console.log(`  2. Review installed agents in ${chalk_1.default.blue('docs/ai/agents/')}`);
-            console.log(`  3. Add custom agents or quickrefs as needed`);
+        // Tool status summary
+        if (tools.ripgrep.installed) {
+            console.log(`Search tool: ${chalk_1.default.green('ripgrep')} (fast)`);
         }
         else {
-            console.log(`  2. Create custom agents in ${chalk_1.default.blue('docs/ai/agents/')}`);
-            console.log(`  3. Add quickrefs in ${chalk_1.default.blue('docs/ai/quickrefs/')}`);
+            console.log(`Search tool: ${chalk_1.default.yellow('grep')} (fallback - consider installing ripgrep)`);
         }
         console.log('');
+        console.log('Next steps:');
         console.log('');
-        console.log('Documentation: https://contextuate.md');
+        console.log(`  1. Edit ${chalk_1.default.blue('docs/ai/context.md')} with your project details`);
+        console.log(`  2. Review agents in ${chalk_1.default.blue('docs/ai/agents/')}`);
+        console.log(`  3. Run ${chalk_1.default.blue('contextuate doctor')} to check configuration`);
         console.log('');
-        console.log(chalk_1.default.gray('Contextuate Framework'));
-        console.log(chalk_1.default.gray('Created by Alexander Conroy (@geilt)'));
+        console.log('Documentation: https://contextuate.md');
         console.log('');
     }
     catch (error) {
         if (error.isTtyError) {
-            // Prompt couldn't be rendered in the current environment
             console.error(chalk_1.default.red('[ERROR] Prompt could not be rendered in the current environment'));
         }
         else if (error.name === 'ExitPromptError' || error.message.includes('User force closed the prompt')) {
             console.log('');
-            console.log(chalk_1.default.yellow('👋 Installation cancelled by user.'));
+            console.log(chalk_1.default.yellow('Installation cancelled by user.'));
             process.exit(0);
         }
         else {
-            // Something else went wrong
             console.error(chalk_1.default.red('[ERROR] An unexpected error occurred:'), error);
             process.exit(1);
         }

package/dist/commands/install.js

@@ -60,10 +60,10 @@ async function discoverTemplates() {
             .filter(f => f.endsWith('.md'))
             .map(f => f.replace('.md', ''));
     }
-    // Discover skills
-    const skillsDir = path_1.default.join(templateSource, 'skills');
-    if (fs_extra_1.default.existsSync(skillsDir)) {
-        const files = await fs_extra_1.default.readdir(skillsDir);
+    // Discover skills (stored in commands/ directory)
+    const commandsDir = path_1.default.join(templateSource, 'commands');
+    if (fs_extra_1.default.existsSync(commandsDir)) {
+        const files = await fs_extra_1.default.readdir(commandsDir);
         result.skills = files
             .filter(f => f.endsWith('.md'))
             .map(f => f.replace('.md', ''));
@@ -188,7 +188,7 @@ async function installTools(names, force) {
     return installed;
 }
 // Install skills (slash commands)
-// Skills are installed to docs/ai/skills/ and symlinked to docs/ai/commands/ for Claude Code
+// Skills are installed directly to docs/ai/commands/ for Claude Code
 async function installSkills(names, force) {
     const templateSource = getTemplateSource();
     const templates = await discoverTemplates();
@@ -197,26 +197,10 @@ async function installSkills(names, force) {
         const normalized = name.toLowerCase().trim().replace(/^\//, ''); // Remove leading slash if present
         const matched = templates.skills.find(s => s.toLowerCase() === normalized);
         if (matched) {
-            const src = path_1.default.join(templateSource, 'skills', `${matched}.md`);
-            const skillDest = path_1.default.join('docs/ai/skills', `${matched}.md`);
-            const commandDest = path_1.default.join('docs/ai/commands', `${matched}.md`);
-            // Install skill file to skills/
-            if (await copyFile(src, skillDest, force)) {
+            const src = path_1.default.join(templateSource, 'commands', `${matched}.md`);
+            const dest = path_1.default.join('docs/ai/commands', `${matched}.md`);
+            if (await copyFile(src, dest, force)) {
                 installed++;
-                // Create symlink in commands/ for Claude Code to pick up
-                await fs_extra_1.default.ensureDir(path_1.default.dirname(commandDest));
-                const symlinkTarget = path_1.default.relative(path_1.default.dirname(commandDest), skillDest);
-                if (fs_extra_1.default.existsSync(commandDest)) {
-                    if (force) {
-                        await fs_extra_1.default.remove(commandDest);
-                    }
-                    else {
-                        console.log(chalk_1.default.yellow(`[SKIP] Symlink already exists: ${commandDest}`));
-                        continue;
-                    }
-                }
-                await fs_extra_1.default.symlink(symlinkTarget, commandDest);
-                console.log(chalk_1.default.green(`[OK] Symlinked: ${commandDest} -> ${symlinkTarget}`));
             }
         }
         else {

package/dist/index.js

@@ -9,6 +9,7 @@ const create_1 = require("./commands/create");
 const index_1 = require("./commands/index");
 const context_1 = require("./commands/context");
 const install_1 = require("./commands/install");
+const doctor_1 = require("./commands/doctor");
 const monitor_1 = require("./commands/monitor");
 const claude_1 = require("./commands/claude");
 const fs_1 = require("fs");
@@ -54,6 +55,12 @@ program
     .command('add-context')
     .description('Interactively add files to docs/ai/context.md')
     .action(context_1.addContextCommand);
+program
+    .command('doctor')
+    .description('Check and fix Contextuate configuration')
+    .option('--fix', 'Attempt to fix issues and update template variables')
+    .option('--install', 'Offer to install missing tools')
+    .action(doctor_1.doctorCommand);
 program
     .command('run')
     .description('Run an agent definition')