@claudetools/cli 0.9.2

package/dist/onboard/context7-fetcher.js

@@ -0,0 +1,116 @@
+// =============================================================================
+// Context7 Documentation Fetcher
+// =============================================================================
+// Fetches official documentation via Context7 MCP integration
+import { execSync } from 'child_process';
+// Cache for library IDs to avoid repeated lookups
+const libraryIdCache = new Map();
+/**
+ * Check if mcp-cli is available
+ */
+export function isMcpCliAvailable() {
+    try {
+        execSync('which mcp-cli', { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve a library name to its Context7 library ID
+ */
+export async function resolveLibraryId(libraryName) {
+    // Check cache first
+    if (libraryIdCache.has(libraryName)) {
+        return libraryIdCache.get(libraryName);
+    }
+    try {
+        const result = execSync(`mcp-cli call context7/resolve-library-id '${JSON.stringify({
+            libraryName,
+        })}'`, { encoding: 'utf-8', timeout: 30000, stdio: 'pipe' });
+        const parsed = JSON.parse(result);
+        const libraryId = parsed?.libraryId || parsed?.library_id;
+        if (libraryId) {
+            libraryIdCache.set(libraryName, libraryId);
+            return libraryId;
+        }
+    }
+    catch {
+        // Silent fail - library might not be in Context7
+    }
+    return null;
+}
+/**
+ * Query documentation for a library
+ */
+export async function queryDocs(libraryId, query) {
+    try {
+        const result = execSync(`mcp-cli call context7/query-docs '${JSON.stringify({
+            context7CompatibleLibraryID: libraryId,
+            topic: query,
+        })}'`, { encoding: 'utf-8', timeout: 60000, stdio: 'pipe' });
+        // The result should contain the documentation
+        if (result && result.trim().length > 0) {
+            return result.trim();
+        }
+    }
+    catch {
+        // Silent fail
+    }
+    return null;
+}
+/**
+ * Fetch comprehensive documentation for a library
+ * Makes up to 3 queries to get a complete overview
+ */
+export async function fetchLibraryDocs(libraryName, context7Id) {
+    const result = {
+        overview: null,
+        bestPractices: null,
+        examples: null,
+    };
+    // Resolve library ID
+    const libraryId = context7Id || (await resolveLibraryId(libraryName));
+    if (!libraryId) {
+        return result;
+    }
+    // Query 1: Overview and getting started
+    result.overview = await queryDocs(libraryId, `Overview, installation, and getting started guide for ${libraryName}`);
+    // Query 2: Best practices and patterns
+    result.bestPractices = await queryDocs(libraryId, `Best practices, recommended patterns, and common conventions for ${libraryName}`);
+    // Query 3: Examples
+    result.examples = await queryDocs(libraryId, `Code examples and common use cases for ${libraryName}`);
+    return result;
+}
+/**
+ * Search for available libraries in Context7
+ */
+export async function searchLibraries(query) {
+    try {
+        const result = execSync(`mcp-cli call context7/resolve-library-id '${JSON.stringify({
+            libraryName: query,
+        })}'`, { encoding: 'utf-8', timeout: 30000, stdio: 'pipe' });
+        const parsed = JSON.parse(result);
+        // Return as array if multiple results, or single item array
+        if (Array.isArray(parsed)) {
+            return parsed.map((item) => ({
+                libraryId: item.libraryId || item.library_id || '',
+                name: item.name || query,
+                description: item.description,
+            }));
+        }
+        if (parsed?.libraryId || parsed?.library_id) {
+            return [{
+                    libraryId: parsed.libraryId || parsed.library_id,
+                    name: parsed.name || query,
+                    description: parsed.description,
+                }];
+        }
+    }
+    catch {
+        // Silent fail
+    }
+    return [];
+}
+//# sourceMappingURL=context7-fetcher.js.map

package/dist/onboard/context7-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context7-fetcher.js","sourceRoot":"","sources":["../../src/onboard/context7-fetcher.ts"],"names":[],"mappings":"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"}

package/dist/onboard/docs-generator.d.ts

@@ -0,0 +1,8 @@
+import type { StackInfo, DocumentationFile } from './types.js';
+/**
+ * Generate documentation directory structure
+ */
+export declare function generateDocs(projectPath: string, stack: StackInfo, options?: {
+    verbose?: boolean;
+}): Promise<DocumentationFile[]>;
+//# sourceMappingURL=docs-generator.d.ts.map

package/dist/onboard/docs-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-generator.d.ts","sourceRoot":"","sources":["../../src/onboard/docs-generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAgB,MAAM,YAAY,CAAC;AAI7E;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqN9B"}

package/dist/onboard/docs-generator.js

@@ -0,0 +1,250 @@
+// =============================================================================
+// Documentation Generator
+// =============================================================================
+// Generates the /docs/ directory structure with fetched documentation
+import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync } from 'fs';
+import { join } from 'path';
+import { fetchLibraryDocs, isMcpCliAvailable } from './context7-fetcher.js';
+import { researchLibrary } from './web-research.js';
+/**
+ * Generate documentation directory structure
+ */
+export async function generateDocs(projectPath, stack, options = {}) {
+    const docsPath = join(projectPath, 'docs');
+    const files = [];
+    // Create docs directory structure
+    const dirs = [
+        docsPath,
+        join(docsPath, 'frameworks'),
+        join(docsPath, 'libraries'),
+        join(docsPath, 'tooling'),
+        join(docsPath, 'patterns'),
+    ];
+    for (const dir of dirs) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    const hasContext7 = isMcpCliAvailable();
+    // Generate framework documentation
+    for (const framework of stack.frameworks) {
+        if (options.verbose) {
+            console.log(`  Fetching docs for ${framework.name}...`);
+        }
+        let content = '';
+        let source = 'generated';
+        if (hasContext7 && framework.context7Id) {
+            const docs = await fetchLibraryDocs(framework.name, framework.context7Id);
+            if (docs.overview) {
+                content = `# ${framework.name}\n\n`;
+                content += `## Overview\n\n${docs.overview}\n\n`;
+                if (docs.bestPractices) {
+                    content += `## Best Practices\n\n${docs.bestPractices}\n\n`;
+                }
+                if (docs.examples) {
+                    content += `## Examples\n\n${docs.examples}\n\n`;
+                }
+                source = 'context7';
+            }
+        }
+        // Supplement with web research
+        const research = await researchLibrary(framework.name);
+        if (research.bestPractices.length > 0 || !content) {
+            if (!content) {
+                content = `# ${framework.name}\n\n`;
+                content += `**Version:** ${framework.version}\n`;
+                content += `**Category:** ${framework.category}\n\n`;
+            }
+            if (research.bestPractices.length > 0) {
+                content += `## Best Practices\n\n`;
+                content += research.bestPractices.map(bp => `- ${bp}`).join('\n');
+                content += '\n\n';
+                source = source === 'context7' ? 'context7' : 'web-research';
+            }
+            if (research.commonPatterns.length > 0) {
+                content += `## Common Patterns\n\n`;
+                content += research.commonPatterns.map(p => `- ${p}`).join('\n');
+                content += '\n\n';
+            }
+            if (research.gotchas.length > 0) {
+                content += `## Gotchas\n\n`;
+                content += research.gotchas.map(g => `- ${g}`).join('\n');
+                content += '\n\n';
+            }
+        }
+        if (content) {
+            const fileName = `${framework.name.toLowerCase().replace(/[^a-z0-9]/g, '-')}.md`;
+            const filePath = join(docsPath, 'frameworks', fileName);
+            writeFileSync(filePath, content);
+            files.push({
+                path: `docs/frameworks/${fileName}`,
+                title: framework.name,
+                category: 'frameworks',
+                content,
+                source,
+                lastUpdated: new Date().toISOString(),
+            });
+        }
+    }
+    // Generate library documentation
+    const significantLibraries = stack.libraries.filter(lib => ['database', 'state-management', 'data-fetching', 'validation', 'authentication'].includes(lib.category));
+    for (const library of significantLibraries) {
+        if (options.verbose) {
+            console.log(`  Fetching docs for ${library.name}...`);
+        }
+        let content = '';
+        let source = 'generated';
+        if (hasContext7 && library.context7Id) {
+            const docs = await fetchLibraryDocs(library.name, library.context7Id);
+            if (docs.overview) {
+                content = `# ${library.name}\n\n`;
+                content += `## Overview\n\n${docs.overview}\n\n`;
+                if (docs.bestPractices) {
+                    content += `## Best Practices\n\n${docs.bestPractices}\n\n`;
+                }
+                source = 'context7';
+            }
+        }
+        // Supplement with web research
+        const research = await researchLibrary(library.name);
+        if (research.bestPractices.length > 0 || !content) {
+            if (!content) {
+                content = `# ${library.name}\n\n`;
+                content += `**Version:** ${library.version}\n`;
+                content += `**Category:** ${library.category}\n\n`;
+            }
+            if (research.bestPractices.length > 0) {
+                content += `## Best Practices\n\n`;
+                content += research.bestPractices.map(bp => `- ${bp}`).join('\n');
+                content += '\n\n';
+                source = source === 'context7' ? 'context7' : 'web-research';
+            }
+            if (research.gotchas.length > 0) {
+                content += `## Gotchas\n\n`;
+                content += research.gotchas.map(g => `- ${g}`).join('\n');
+                content += '\n\n';
+            }
+        }
+        if (content) {
+            const fileName = `${library.name.toLowerCase().replace(/[^a-z0-9]/g, '-')}.md`;
+            const filePath = join(docsPath, 'libraries', fileName);
+            writeFileSync(filePath, content);
+            files.push({
+                path: `docs/libraries/${fileName}`,
+                title: library.name,
+                category: 'libraries',
+                content,
+                source,
+                lastUpdated: new Date().toISOString(),
+            });
+        }
+    }
+    // Generate dev tools documentation
+    for (const tool of stack.devTools) {
+        if (options.verbose) {
+            console.log(`  Fetching docs for ${tool.name}...`);
+        }
+        const research = await researchLibrary(tool.name);
+        let content = `# ${tool.name}\n\n`;
+        content += `**Version:** ${tool.version}\n`;
+        content += `**Category:** ${tool.category}\n\n`;
+        if (research.bestPractices.length > 0) {
+            content += `## Best Practices\n\n`;
+            content += research.bestPractices.map(bp => `- ${bp}`).join('\n');
+            content += '\n\n';
+        }
+        if (research.gotchas.length > 0) {
+            content += `## Gotchas\n\n`;
+            content += research.gotchas.map(g => `- ${g}`).join('\n');
+            content += '\n\n';
+        }
+        const fileName = `${tool.name.toLowerCase().replace(/[^a-z0-9]/g, '-')}.md`;
+        const filePath = join(docsPath, 'tooling', fileName);
+        writeFileSync(filePath, content);
+        files.push({
+            path: `docs/tooling/${fileName}`,
+            title: tool.name,
+            category: 'tooling',
+            content,
+            source: research.bestPractices.length > 0 ? 'web-research' : 'generated',
+            lastUpdated: new Date().toISOString(),
+        });
+    }
+    // Generate index.md
+    const indexContent = generateDocsIndex(stack, files);
+    writeFileSync(join(docsPath, 'index.md'), indexContent);
+    files.push({
+        path: 'docs/index.md',
+        title: 'Documentation Index',
+        category: 'frameworks',
+        content: indexContent,
+        source: 'generated',
+        lastUpdated: new Date().toISOString(),
+    });
+    // Generate metadata file
+    const metadata = {
+        generatedAt: new Date().toISOString(),
+        projectPath,
+        stack,
+        files: files.map(f => ({ path: f.path, title: f.title, source: f.source })),
+    };
+    writeFileSync(join(docsPath, '.metadata.json'), JSON.stringify(metadata, null, 2));
+    // Add docs/ to .gitignore
+    addToGitignore(projectPath, 'docs/');
+    return files;
+}
+/**
+ * Generate documentation index file
+ */
+function generateDocsIndex(stack, files) {
+    let content = `# Project Documentation\n\n`;
+    content += `> Auto-generated documentation. Refresh with \`claudetools onboard --refresh\`\n\n`;
+    const frameworkFiles = files.filter(f => f.category === 'frameworks');
+    const libraryFiles = files.filter(f => f.category === 'libraries');
+    const toolingFiles = files.filter(f => f.category === 'tooling');
+    if (frameworkFiles.length > 0) {
+        content += `## Frameworks\n\n`;
+        for (const file of frameworkFiles) {
+            content += `- [${file.title}](${file.path.replace('docs/', '')})\n`;
+        }
+        content += '\n';
+    }
+    if (libraryFiles.length > 0) {
+        content += `## Libraries\n\n`;
+        for (const file of libraryFiles) {
+            content += `- [${file.title}](${file.path.replace('docs/', '')})\n`;
+        }
+        content += '\n';
+    }
+    if (toolingFiles.length > 0) {
+        content += `## Tooling\n\n`;
+        for (const file of toolingFiles) {
+            content += `- [${file.title}](${file.path.replace('docs/', '')})\n`;
+        }
+        content += '\n';
+    }
+    content += `---\n\n`;
+    content += `*Generated: ${new Date().toISOString()}*\n`;
+    return content;
+}
+/**
+ * Add entry to .gitignore if not present
+ */
+function addToGitignore(projectPath, entry) {
+    const gitignorePath = join(projectPath, '.gitignore');
+    try {
+        if (existsSync(gitignorePath)) {
+            const content = readFileSync(gitignorePath, 'utf-8');
+            if (!content.includes(entry)) {
+                appendFileSync(gitignorePath, `\n# ClaudeTools generated docs (regenerate with claudetools onboard)\n${entry}\n`);
+            }
+        }
+        else {
+            writeFileSync(gitignorePath, `# ClaudeTools generated docs (regenerate with claudetools onboard)\n${entry}\n`);
+        }
+    }
+    catch {
+        // Non-fatal, just skip gitignore update
+    }
+}
+//# sourceMappingURL=docs-generator.js.map

package/dist/onboard/docs-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-generator.js","sourceRoot":"","sources":["../../src/onboard/docs-generator.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAChF,sEAAsE;AAEtE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AACxF,OAAO,EAAE,IAAI,EAAW,MAAM,MAAM,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,KAAgB,EAChB,UAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,kCAAkC;IAClC,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC;QAC5B,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC3B,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;QACzB,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;KAC3B,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;IAExC,mCAAmC;IACnC,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,MAAM,GAAgC,WAAW,CAAC;QAEtD,IAAI,WAAW,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;YAC1E,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,GAAG,KAAK,SAAS,CAAC,IAAI,MAAM,CAAC;gBACpC,OAAO,IAAI,kBAAkB,IAAI,CAAC,QAAQ,MAAM,CAAC;gBACjD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,OAAO,IAAI,wBAAwB,IAAI,CAAC,aAAa,MAAM,CAAC;gBAC9D,CAAC;gBACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,OAAO,IAAI,kBAAkB,IAAI,CAAC,QAAQ,MAAM,CAAC;gBACnD,CAAC;gBACD,MAAM,GAAG,UAAU,CAAC;YACtB,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,KAAK,SAAS,CAAC,IAAI,MAAM,CAAC;gBACpC,OAAO,IAAI,gBAAgB,SAAS,CAAC,OAAO,IAAI,CAAC;gBACjD,OAAO,IAAI,iBAAiB,SAAS,CAAC,QAAQ,MAAM,CAAC;YACvD,CAAC;YAED,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO,IAAI,uBAAuB,CAAC;gBACnC,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClE,OAAO,IAAI,MAAM,CAAC;gBAClB,MAAM,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;YAC/D,CAAC;YAED,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,OAAO,IAAI,wBAAwB,CAAC;gBACpC,OAAO,IAAI,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjE,OAAO,IAAI,MAAM,CAAC;YACpB,CAAC;YAED,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,OAAO,IAAI,gBAAgB,CAAC;gBAC5B,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1D,OAAO,IAAI,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC;YACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;YACxD,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,mBAAmB,QAAQ,EAAE;gBACnC,KAAK,EAAE,SAAS,CAAC,IAAI;gBACrB,QAAQ,EAAE,YAAY;gBACtB,OAAO;gBACP,MAAM;gBACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,MAAM,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxD,CAAC,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CACzG,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,MAAM,GAAgC,WAAW,CAAC;QAEtD,IAAI,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;YACtE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,GAAG,KAAK,OAAO,CAAC,IAAI,MAAM,CAAC;gBAClC,OAAO,IAAI,kBAAkB,IAAI,CAAC,QAAQ,MAAM,CAAC;gBACjD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,OAAO,IAAI,wBAAwB,IAAI,CAAC,aAAa,MAAM,CAAC;gBAC9D,CAAC;gBACD,MAAM,GAAG,UAAU,CAAC;YACtB,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,KAAK,OAAO,CAAC,IAAI,MAAM,CAAC;gBAClC,OAAO,IAAI,gBAAgB,OAAO,CAAC,OAAO,IAAI,CAAC;gBAC/C,OAAO,IAAI,iBAAiB,OAAO,CAAC,QAAQ,MAAM,CAAC;YACrD,CAAC;YAED,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO,IAAI,uBAAuB,CAAC;gBACnC,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClE,OAAO,IAAI,MAAM,CAAC;gBAClB,MAAM,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;YAC/D,CAAC;YAED,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,OAAO,IAAI,gBAAgB,CAAC;gBAC5B,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1D,OAAO,IAAI,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC;YAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YACvD,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,kBAAkB,QAAQ,EAAE;gBAClC,KAAK,EAAE,OAAO,CAAC,IAAI;gBACnB,QAAQ,EAAE,WAAW;gBACrB,OAAO;gBACP,MAAM;gBACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,OAAO,GAAG,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC;QACnC,OAAO,IAAI,gBAAgB,IAAI,CAAC,OAAO,IAAI,CAAC;QAC5C,OAAO,IAAI,iBAAiB,IAAI,CAAC,QAAQ,MAAM,CAAC;QAEhD,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,uBAAuB,CAAC;YACnC,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClE,OAAO,IAAI,MAAM,CAAC;QACpB,CAAC;QAED,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,gBAAgB,CAAC;YAC5B,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,OAAO,IAAI,MAAM,CAAC;QACpB,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACrD,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,gBAAgB,QAAQ,EAAE;YAChC,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,QAAQ,EAAE,SAAS;YACnB,OAAO;YACP,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW;YACxE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACrD,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,qBAAqB;QAC5B,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC,CAAC;IAEH,yBAAyB;IACzB,MAAM,QAAQ,GAAiB;QAC7B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,WAAW;QACX,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KAC5E,CAAC;IACF,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnF,0BAA0B;IAC1B,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAErC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAgB,EAAE,KAA0B;IACrE,IAAI,OAAO,GAAG,6BAA6B,CAAC;IAC5C,OAAO,IAAI,oFAAoF,CAAC;IAEhG,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAEjE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,mBAAmB,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,OAAO,IAAI,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,kBAAkB,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,OAAO,IAAI,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,gBAAgB,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,OAAO,IAAI,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,SAAS,CAAC;IACrB,OAAO,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC;IAExD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,WAAmB,EAAE,KAAa;IACxD,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,cAAc,CAAC,aAAa,EAAE,yEAAyE,KAAK,IAAI,CAAC,CAAC;YACpH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,aAAa,EAAE,uEAAuE,KAAK,IAAI,CAAC,CAAC;QACjH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;AACH,CAAC"}

package/dist/onboard/index.d.ts

@@ -0,0 +1,11 @@
+export interface OnboardOptions {
+    refresh?: boolean;
+    verbose?: boolean;
+    skipDocs?: boolean;
+}
+/**
+ * Run the complete onboarding workflow
+ */
+export declare function runOnboard(projectPath: string, options?: OnboardOptions): Promise<void>;
+export type { StackInfo } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/onboard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onboard/index.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA4Df;AAyED,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/onboard/index.js

@@ -0,0 +1,128 @@
+// =============================================================================
+// Onboard Module - Main Orchestrator
+// =============================================================================
+// Coordinates the documentation-driven onboarding workflow
+import chalk from 'chalk';
+import ora from 'ora';
+import { existsSync, writeFileSync, mkdirSync, readFileSync } from 'fs';
+import { join, basename } from 'path';
+import { detectStack, getStackSummary } from './stack-detector.js';
+import { generateDocs } from './docs-generator.js';
+import { buildAgentsMd, writeAgentsMd } from './agents-md-builder.js';
+import { isMcpCliAvailable } from './context7-fetcher.js';
+/**
+ * Run the complete onboarding workflow
+ */
+export async function runOnboard(projectPath, options = {}) {
+    const projectName = basename(projectPath);
+    console.log('\n' + chalk.bold.cyan('  ClaudeTools Onboarding') + '\n');
+    console.log('  ' + chalk.dim(`Project: ${projectName}`) + '\n');
+    // Phase 1: Stack Detection
+    const stackSpinner = ora('Detecting project stack...').start();
+    const stack = detectStack(projectPath);
+    stackSpinner.succeed(`Detected: ${getStackSummary(stack)}`);
+    if (options.verbose) {
+        printStackDetails(stack);
+    }
+    // Phase 2: Documentation Generation
+    if (!options.skipDocs) {
+        const hasContext7 = isMcpCliAvailable();
+        if (hasContext7) {
+            console.log(chalk.dim('  Context7 MCP available - fetching official docs'));
+        }
+        else {
+            console.log(chalk.dim('  Context7 not available - using built-in knowledge'));
+        }
+        const docsSpinner = ora('Generating documentation...').start();
+        try {
+            const docFiles = await generateDocs(projectPath, stack, { verbose: options.verbose });
+            docsSpinner.succeed(`Generated ${docFiles.length} documentation files`);
+            // Phase 3: Build AGENTS.md
+            const agentsSpinner = ora('Building AGENTS.md...').start();
+            const agentsContent = buildAgentsMd(projectPath, stack, docFiles);
+            writeAgentsMd(projectPath, agentsContent);
+            agentsSpinner.succeed('Created AGENTS.md');
+            // Phase 4: Create minimal CLAUDE.md pointer
+            createClaudeMdPointer(projectPath, projectName);
+        }
+        catch (err) {
+            docsSpinner.fail('Documentation generation failed');
+            console.error(chalk.red(`  ${err instanceof Error ? err.message : String(err)}`));
+        }
+    }
+    else {
+        // Skip docs, just create AGENTS.md from stack
+        const agentsSpinner = ora('Building AGENTS.md...').start();
+        const agentsContent = buildAgentsMd(projectPath, stack, []);
+        writeAgentsMd(projectPath, agentsContent);
+        agentsSpinner.succeed('Created AGENTS.md');
+        createClaudeMdPointer(projectPath, projectName);
+    }
+    // Done
+    console.log('\n' + chalk.green('  Onboarding complete!'));
+    console.log(chalk.dim('\n  Generated files:'));
+    console.log(chalk.dim('  - AGENTS.md (comprehensive agent context)'));
+    console.log(chalk.dim('  - docs/ (stack documentation, gitignored)'));
+    console.log(chalk.dim('  - .claude/CLAUDE.md (minimal pointer)'));
+    console.log('\n');
+}
+/**
+ * Create minimal CLAUDE.md that points to AGENTS.md
+ */
+function createClaudeMdPointer(projectPath, projectName) {
+    const claudeDir = join(projectPath, '.claude');
+    const claudeMdPath = join(claudeDir, 'CLAUDE.md');
+    // Create .claude directory if needed
+    if (!existsSync(claudeDir)) {
+        mkdirSync(claudeDir, { recursive: true });
+    }
+    // Check if CLAUDE.md already exists with custom content
+    if (existsSync(claudeMdPath)) {
+        const existing = readFileSync(claudeMdPath, 'utf-8');
+        // If it has substantial custom content, don't overwrite
+        if (existing.length > 500 && !existing.includes('See [AGENTS.md]')) {
+            console.log(chalk.dim('  Existing CLAUDE.md preserved (has custom content)'));
+            return;
+        }
+    }
+    const content = `# ${projectName}
+
+See [AGENTS.md](../AGENTS.md) for comprehensive project context.
+
+## Quick Links
+
+- Project docs: \`docs/\`
+- Agent context: \`AGENTS.md\`
+
+---
+
+*Generated by ClaudeTools. Refresh: \`claudetools onboard --refresh\`*
+`;
+    writeFileSync(claudeMdPath, content);
+}
+/**
+ * Print detailed stack information
+ */
+function printStackDetails(stack) {
+    console.log(chalk.dim('\n  Stack Details:'));
+    if (stack.frameworks.length > 0) {
+        console.log(chalk.dim('  Frameworks:'));
+        for (const fw of stack.frameworks) {
+            console.log(chalk.dim(`    - ${fw.name} ${fw.version} (${fw.category})`));
+        }
+    }
+    if (stack.libraries.length > 0) {
+        console.log(chalk.dim('  Libraries:'));
+        for (const lib of stack.libraries) {
+            console.log(chalk.dim(`    - ${lib.name} ${lib.version} (${lib.category})`));
+        }
+    }
+    if (stack.devTools.length > 0) {
+        console.log(chalk.dim('  Dev Tools:'));
+        for (const tool of stack.devTools) {
+            console.log(chalk.dim(`    - ${tool.name} (${tool.category})`));
+        }
+    }
+    console.log('');
+}
+//# sourceMappingURL=index.js.map

package/dist/onboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/onboard/index.ts"],"names":[],"mappings":"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"}

package/dist/onboard/stack-detector.d.ts

@@ -0,0 +1,4 @@
+import type { StackInfo } from './types.js';
+export declare function detectStack(projectPath: string): StackInfo;
+export declare function getStackSummary(stack: StackInfo): string;
+//# sourceMappingURL=stack-detector.d.ts.map

package/dist/onboard/stack-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detector.d.ts","sourceRoot":"","sources":["../../src/onboard/stack-detector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAA2C,MAAM,YAAY,CAAC;AAoHrF,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAgD1D;AA2KD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAYxD"}