@claudetools/cli 0.9.2

package/dist/onboard/stack-detector.js

@@ -0,0 +1,324 @@
+// =============================================================================
+// Stack Detector
+// =============================================================================
+// Detects project technology stack from manifest files
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+// Framework detection patterns
+const FRAMEWORK_PATTERNS = {
+    // Frontend
+    'next': { category: 'fullstack', context7Id: 'next.js' },
+    'react': { category: 'frontend', context7Id: 'react' },
+    'vue': { category: 'frontend', context7Id: 'vue' },
+    'svelte': { category: 'frontend', context7Id: 'svelte' },
+    'angular': { category: 'frontend', context7Id: 'angular' },
+    'solid-js': { category: 'frontend', context7Id: 'solid' },
+    'qwik': { category: 'frontend', context7Id: 'qwik' },
+    'astro': { category: 'fullstack', context7Id: 'astro' },
+    '@remix-run/react': { category: 'fullstack', context7Id: 'remix' },
+    '@tanstack/start': { category: 'fullstack', context7Id: 'tanstack-start' },
+    'nuxt': { category: 'fullstack', context7Id: 'nuxt' },
+    'sveltekit': { category: 'fullstack', context7Id: 'sveltekit' },
+    // Backend
+    'express': { category: 'backend', context7Id: 'express' },
+    'fastify': { category: 'backend', context7Id: 'fastify' },
+    'hono': { category: 'backend', context7Id: 'hono' },
+    'elysia': { category: 'backend', context7Id: 'elysia' },
+    'koa': { category: 'backend', context7Id: 'koa' },
+    'nestjs': { category: 'backend', context7Id: 'nestjs' },
+    '@nestjs/core': { category: 'backend', context7Id: 'nestjs' },
+    // Mobile/Desktop
+    'react-native': { category: 'mobile', context7Id: 'react-native' },
+    'expo': { category: 'mobile', context7Id: 'expo' },
+    'electron': { category: 'desktop', context7Id: 'electron' },
+    'tauri': { category: 'desktop', context7Id: 'tauri' },
+};
+// Library categories
+const LIBRARY_CATEGORIES = {
+    // Database/ORM
+    'drizzle-orm': 'database',
+    'prisma': 'database',
+    '@prisma/client': 'database',
+    'mongoose': 'database',
+    'typeorm': 'database',
+    'sequelize': 'database',
+    'kysely': 'database',
+    'better-sqlite3': 'database',
+    // State Management
+    'zustand': 'state-management',
+    'jotai': 'state-management',
+    'recoil': 'state-management',
+    '@reduxjs/toolkit': 'state-management',
+    'redux': 'state-management',
+    'mobx': 'state-management',
+    'pinia': 'state-management',
+    // Data Fetching
+    '@tanstack/react-query': 'data-fetching',
+    'swr': 'data-fetching',
+    '@trpc/client': 'data-fetching',
+    '@trpc/server': 'data-fetching',
+    'axios': 'data-fetching',
+    // Validation
+    'zod': 'validation',
+    'yup': 'validation',
+    'valibot': 'validation',
+    'joi': 'validation',
+    'arktype': 'validation',
+    // Authentication
+    'next-auth': 'authentication',
+    '@auth/core': 'authentication',
+    'lucia': 'authentication',
+    'better-auth': 'authentication',
+    '@clerk/nextjs': 'authentication',
+    'passport': 'authentication',
+    // UI Components
+    '@radix-ui/react-*': 'ui-components',
+    '@shadcn/ui': 'ui-components',
+    '@mantine/core': 'ui-components',
+    '@chakra-ui/react': 'ui-components',
+    '@mui/material': 'ui-components',
+    'antd': 'ui-components',
+    // Styling
+    'tailwindcss': 'styling',
+    'styled-components': 'styling',
+    '@emotion/react': 'styling',
+    'sass': 'styling',
+};
+// Dev tool categories
+const DEV_TOOL_CATEGORIES = {
+    // Testing
+    'vitest': 'testing',
+    'jest': 'testing',
+    '@testing-library/react': 'testing',
+    'playwright': 'testing',
+    'cypress': 'testing',
+    // Linting
+    'eslint': 'linting',
+    'prettier': 'linting',
+    '@typescript-eslint/eslint-plugin': 'linting',
+    'biome': 'linting',
+    // Bundling
+    'vite': 'bundling',
+    'webpack': 'bundling',
+    'esbuild': 'bundling',
+    'rollup': 'bundling',
+    'tsup': 'bundling',
+    'turbo': 'bundling',
+};
+export function detectStack(projectPath) {
+    const stack = {
+        frameworks: [],
+        libraries: [],
+        devTools: [],
+        primaryLanguage: 'unknown',
+        packageManager: 'unknown',
+    };
+    // Detect package manager and parse manifest
+    const packageJsonPath = join(projectPath, 'package.json');
+    if (existsSync(packageJsonPath)) {
+        stack.primaryLanguage = 'typescript';
+        parsePackageJson(packageJsonPath, stack);
+        stack.packageManager = detectPackageManager(projectPath);
+    }
+    // Python projects
+    const requirementsPath = join(projectPath, 'requirements.txt');
+    const pyprojectPath = join(projectPath, 'pyproject.toml');
+    if (existsSync(requirementsPath) || existsSync(pyprojectPath)) {
+        stack.primaryLanguage = 'python';
+        if (existsSync(pyprojectPath)) {
+            stack.packageManager = 'poetry';
+            parsePyproject(pyprojectPath, stack);
+        }
+        else {
+            stack.packageManager = 'pip';
+            parseRequirements(requirementsPath, stack);
+        }
+    }
+    // Go projects
+    const goModPath = join(projectPath, 'go.mod');
+    if (existsSync(goModPath)) {
+        stack.primaryLanguage = 'go';
+        stack.packageManager = 'go';
+        parseGoMod(goModPath, stack);
+    }
+    // Rust projects
+    const cargoPath = join(projectPath, 'Cargo.toml');
+    if (existsSync(cargoPath)) {
+        stack.primaryLanguage = 'rust';
+        stack.packageManager = 'cargo';
+        parseCargoToml(cargoPath, stack);
+    }
+    return stack;
+}
+function parsePackageJson(path, stack) {
+    try {
+        const content = JSON.parse(readFileSync(path, 'utf-8'));
+        const allDeps = {
+            ...content.dependencies,
+            ...content.devDependencies,
+            ...content.peerDependencies,
+        };
+        // Check for TypeScript
+        if (allDeps['typescript'] || existsSync(join(path, '..', 'tsconfig.json'))) {
+            stack.primaryLanguage = 'typescript';
+        }
+        else {
+            stack.primaryLanguage = 'javascript';
+        }
+        for (const [name, version] of Object.entries(allDeps)) {
+            const versionStr = String(version).replace(/^[\^~]/, '');
+            // Check frameworks
+            const frameworkKey = Object.keys(FRAMEWORK_PATTERNS).find(key => name === key || name.startsWith(key + '/'));
+            if (frameworkKey) {
+                const info = FRAMEWORK_PATTERNS[frameworkKey];
+                stack.frameworks.push({
+                    name: frameworkKey,
+                    version: versionStr,
+                    category: info.category,
+                    context7Id: info.context7Id,
+                });
+                continue;
+            }
+            // Check dev tools
+            const devToolKey = Object.keys(DEV_TOOL_CATEGORIES).find(key => name === key || name.startsWith(key + '/'));
+            if (devToolKey && content.devDependencies?.[name]) {
+                stack.devTools.push({
+                    name: devToolKey,
+                    version: versionStr,
+                    category: DEV_TOOL_CATEGORIES[devToolKey],
+                });
+                continue;
+            }
+            // Check libraries
+            const libraryKey = Object.keys(LIBRARY_CATEGORIES).find(key => name === key || (key.endsWith('*') && name.startsWith(key.slice(0, -1))));
+            if (libraryKey) {
+                stack.libraries.push({
+                    name,
+                    version: versionStr,
+                    category: LIBRARY_CATEGORIES[libraryKey],
+                });
+            }
+        }
+    }
+    catch {
+        // Silent fail
+    }
+}
+function detectPackageManager(projectPath) {
+    if (existsSync(join(projectPath, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (existsSync(join(projectPath, 'yarn.lock')))
+        return 'yarn';
+    if (existsSync(join(projectPath, 'bun.lockb')))
+        return 'bun';
+    if (existsSync(join(projectPath, 'package-lock.json')))
+        return 'npm';
+    return 'npm';
+}
+function parsePyproject(path, stack) {
+    try {
+        const content = readFileSync(path, 'utf-8');
+        // Detect common Python frameworks
+        if (content.includes('fastapi')) {
+            stack.frameworks.push({
+                name: 'fastapi',
+                version: '',
+                category: 'backend',
+                context7Id: 'fastapi',
+            });
+        }
+        if (content.includes('django')) {
+            stack.frameworks.push({
+                name: 'django',
+                version: '',
+                category: 'backend',
+                context7Id: 'django',
+            });
+        }
+        if (content.includes('flask')) {
+            stack.frameworks.push({
+                name: 'flask',
+                version: '',
+                category: 'backend',
+                context7Id: 'flask',
+            });
+        }
+    }
+    catch {
+        // Silent fail
+    }
+}
+function parseRequirements(path, stack) {
+    try {
+        const content = readFileSync(path, 'utf-8');
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const name = trimmed.split(/[=<>!]/)[0]?.toLowerCase();
+            if (!name)
+                continue;
+            if (name === 'fastapi') {
+                stack.frameworks.push({ name: 'fastapi', version: '', category: 'backend', context7Id: 'fastapi' });
+            }
+            else if (name === 'django') {
+                stack.frameworks.push({ name: 'django', version: '', category: 'backend', context7Id: 'django' });
+            }
+            else if (name === 'flask') {
+                stack.frameworks.push({ name: 'flask', version: '', category: 'backend', context7Id: 'flask' });
+            }
+            else if (name === 'pytest') {
+                stack.devTools.push({ name: 'pytest', version: '', category: 'testing' });
+            }
+        }
+    }
+    catch {
+        // Silent fail
+    }
+}
+function parseGoMod(path, stack) {
+    try {
+        const content = readFileSync(path, 'utf-8');
+        if (content.includes('github.com/gin-gonic/gin')) {
+            stack.frameworks.push({ name: 'gin', version: '', category: 'backend', context7Id: 'gin' });
+        }
+        if (content.includes('github.com/gofiber/fiber')) {
+            stack.frameworks.push({ name: 'fiber', version: '', category: 'backend', context7Id: 'fiber' });
+        }
+        if (content.includes('github.com/labstack/echo')) {
+            stack.frameworks.push({ name: 'echo', version: '', category: 'backend', context7Id: 'echo' });
+        }
+    }
+    catch {
+        // Silent fail
+    }
+}
+function parseCargoToml(path, stack) {
+    try {
+        const content = readFileSync(path, 'utf-8');
+        if (content.includes('actix-web')) {
+            stack.frameworks.push({ name: 'actix-web', version: '', category: 'backend', context7Id: 'actix' });
+        }
+        if (content.includes('axum')) {
+            stack.frameworks.push({ name: 'axum', version: '', category: 'backend', context7Id: 'axum' });
+        }
+        if (content.includes('rocket')) {
+            stack.frameworks.push({ name: 'rocket', version: '', category: 'backend', context7Id: 'rocket' });
+        }
+    }
+    catch {
+        // Silent fail
+    }
+}
+export function getStackSummary(stack) {
+    const parts = [];
+    if (stack.primaryLanguage !== 'unknown') {
+        parts.push(stack.primaryLanguage);
+    }
+    for (const framework of stack.frameworks) {
+        parts.push(`${framework.name} ${framework.version}`.trim());
+    }
+    return parts.join(' + ') || 'Unknown stack';
+}
+//# sourceMappingURL=stack-detector.js.map

package/dist/onboard/stack-detector.js.map

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

package/dist/onboard/types.d.ts

@@ -0,0 +1,80 @@
+export interface StackInfo {
+    frameworks: FrameworkInfo[];
+    libraries: LibraryInfo[];
+    devTools: DevToolInfo[];
+    primaryLanguage: string;
+    packageManager: 'npm' | 'pnpm' | 'yarn' | 'bun' | 'pip' | 'poetry' | 'go' | 'cargo' | 'unknown';
+}
+export interface FrameworkInfo {
+    name: string;
+    version: string;
+    category: 'frontend' | 'backend' | 'fullstack' | 'mobile' | 'desktop';
+    context7Id?: string;
+}
+export interface LibraryInfo {
+    name: string;
+    version: string;
+    category: string;
+    context7Id?: string;
+}
+export interface DevToolInfo {
+    name: string;
+    version: string;
+    category: 'testing' | 'linting' | 'bundling' | 'ci' | 'other';
+}
+export interface DocumentationFile {
+    path: string;
+    title: string;
+    category: 'frameworks' | 'libraries' | 'tooling' | 'patterns';
+    content: string;
+    source: 'context7' | 'web-research' | 'generated';
+    lastUpdated: string;
+}
+export interface DocsMetadata {
+    generatedAt: string;
+    projectPath: string;
+    stack: StackInfo;
+    files: Array<{
+        path: string;
+        title: string;
+        source: string;
+    }>;
+}
+export interface AgentsMdContent {
+    projectName: string;
+    projectPath: string;
+    generatedAt: string;
+    stack: StackInfo;
+    directoryTree: string;
+    entryPoints: EntryPoint[];
+    conventions: Convention[];
+    documentationLinks: DocumentationLink[];
+}
+export interface EntryPoint {
+    path: string;
+    description: string;
+    exports?: string[];
+}
+export interface Convention {
+    name: string;
+    pattern: string;
+    description: string;
+}
+export interface DocumentationLink {
+    title: string;
+    path: string;
+    description?: string;
+}
+export interface Context7Library {
+    libraryId: string;
+    name: string;
+    description?: string;
+}
+export interface WebResearchResult {
+    library: string;
+    bestPractices: string[];
+    commonPatterns: string[];
+    gotchas: string[];
+    source: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/onboard/types.js

@@ -0,0 +1,5 @@
+// =============================================================================
+// Onboard Module Types
+// =============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/onboard/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/onboard/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF"}

package/dist/onboard/web-research.d.ts

@@ -0,0 +1,11 @@
+import type { WebResearchResult } from './types.js';
+/**
+ * Get research results for a library
+ * Uses built-in knowledge base with web research as supplement
+ */
+export declare function researchLibrary(libraryName: string): Promise<WebResearchResult>;
+/**
+ * Research multiple libraries in parallel
+ */
+export declare function researchLibraries(libraryNames: string[]): Promise<WebResearchResult[]>;
+//# sourceMappingURL=web-research.d.ts.map

package/dist/onboard/web-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-research.d.ts","sourceRoot":"","sources":["../../src/onboard/web-research.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAiLpD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqBrF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAE9B"}

package/dist/onboard/web-research.js

@@ -0,0 +1,209 @@
+// =============================================================================
+// Web Research
+// =============================================================================
+// Supplements Context7 documentation with web-sourced best practices
+// Common best practices for popular libraries (fallback when web search unavailable)
+const KNOWN_BEST_PRACTICES = {
+    react: {
+        bestPractices: [
+            'Use functional components with hooks over class components',
+            'Memoize expensive computations with useMemo and callbacks with useCallback',
+            'Lift state up only when necessary, prefer local state',
+            'Use React.lazy and Suspense for code splitting',
+            'Keep components small and focused on a single responsibility',
+        ],
+        commonPatterns: [
+            'Container/Presentational pattern for separating logic from UI',
+            'Custom hooks for reusable stateful logic',
+            'Compound components for flexible component APIs',
+            'Render props for sharing cross-cutting concerns',
+        ],
+        gotchas: [
+            'Avoid inline function definitions in JSX (creates new references)',
+            'Don\'t forget cleanup in useEffect return functions',
+            'Keys in lists should be stable and unique identifiers',
+            'State updates are batched and asynchronous',
+        ],
+        source: 'built-in',
+    },
+    next: {
+        bestPractices: [
+            'Use Server Components by default, Client Components when needed',
+            'Implement proper loading and error states with loading.tsx and error.tsx',
+            'Use generateStaticParams for static generation of dynamic routes',
+            'Leverage Next.js Image component for automatic optimization',
+            'Use Server Actions for form submissions and mutations',
+        ],
+        commonPatterns: [
+            'App Router with nested layouts for shared UI',
+            'Route groups for organizing without affecting URL structure',
+            'Parallel routes for simultaneous page sections',
+            'Intercepting routes for modal patterns',
+        ],
+        gotchas: [
+            'Client Components cannot directly import Server Components',
+            'Cookies and headers only work in Server Components/Actions',
+            'Dynamic routes with revalidate may cache unexpectedly',
+            'Use the next/navigation router, not next/router in App Router',
+        ],
+        source: 'built-in',
+    },
+    typescript: {
+        bestPractices: [
+            'Prefer type over interface for union types and type aliases',
+            'Use strict mode and enable all strict checks',
+            'Avoid any, use unknown for truly unknown types',
+            'Use const assertions for literal types',
+            'Prefer readonly for immutable data structures',
+        ],
+        commonPatterns: [
+            'Discriminated unions for type-safe state machines',
+            'Utility types (Partial, Pick, Omit) for type transformations',
+            'Generic constraints with extends for type safety',
+            'Branded types for nominal typing',
+        ],
+        gotchas: [
+            'Object.keys returns string[], not keyof T',
+            'Type narrowing doesn\'t work across function boundaries',
+            'Excess property checking only works on object literals',
+            'Index signatures make all properties potentially undefined',
+        ],
+        source: 'built-in',
+    },
+    zod: {
+        bestPractices: [
+            'Define schemas once, infer types from them',
+            'Use transform for parsing and normalization',
+            'Leverage refinements for complex validation rules',
+            'Export both schema and inferred type together',
+        ],
+        commonPatterns: [
+            'z.infer<typeof schema> for type inference',
+            'Composing schemas with extend, merge, pick, omit',
+            'Custom error messages with message option',
+            'Preprocessing with preprocess for data normalization',
+        ],
+        gotchas: [
+            'Default values apply after parsing, not before',
+            'Coercion happens before validation',
+            'safeParse doesn\'t throw, returns result object',
+            'Optional vs nullable vs nullish have different behaviors',
+        ],
+        source: 'built-in',
+    },
+    'drizzle-orm': {
+        bestPractices: [
+            'Define schema in separate files, import for migrations',
+            'Use prepared statements for frequently executed queries',
+            'Leverage relations for type-safe joins',
+            'Use transactions for multi-step operations',
+        ],
+        commonPatterns: [
+            'Schema-first approach with drizzle-kit',
+            'Separate schema.ts and relations.ts files',
+            'Use db.$with for CTEs and complex queries',
+            'Custom types for application-specific columns',
+        ],
+        gotchas: [
+            'Relations are not automatically included in queries',
+            'Push vs migrate have different use cases',
+            'Column names in schema must match database exactly',
+            'Timestamps need explicit defaults in PostgreSQL',
+        ],
+        source: 'built-in',
+    },
+    prisma: {
+        bestPractices: [
+            'Use @unique for fields that should be unique',
+            'Define relations explicitly on both sides',
+            'Use select and include to optimize queries',
+            'Implement soft deletes with middleware',
+        ],
+        commonPatterns: [
+            'Repository pattern wrapping Prisma client',
+            'Middleware for logging, soft deletes, timing',
+            'Extensions for custom client methods',
+            'Raw queries for complex operations',
+        ],
+        gotchas: [
+            'Prisma client must be regenerated after schema changes',
+            'N+1 queries are easy to create with relations',
+            'DateTime is stored in UTC, convert on display',
+            'Unique constraints on optional fields can cause issues',
+        ],
+        source: 'built-in',
+    },
+    tailwindcss: {
+        bestPractices: [
+            'Use design tokens via theme configuration',
+            'Prefer component extraction over @apply for reuse',
+            'Use arbitrary values sparingly, prefer config',
+            'Leverage responsive prefixes mobile-first',
+        ],
+        commonPatterns: [
+            'Group related utilities with prose plugin',
+            'Custom variants for complex selectors',
+            'JIT mode for development efficiency',
+            'Content configuration for tree-shaking',
+        ],
+        gotchas: [
+            'Dynamic class names are not detected by PurgeCSS',
+            'Conflicting utilities follow source order',
+            'Some utilities require specific parent elements',
+            'Dark mode requires explicit configuration',
+        ],
+        source: 'built-in',
+    },
+    vitest: {
+        bestPractices: [
+            'Use describe blocks to organize related tests',
+            'Prefer toEqual for object comparison',
+            'Mock external dependencies at module boundaries',
+            'Use beforeEach for test isolation',
+        ],
+        commonPatterns: [
+            'Arrange-Act-Assert structure for tests',
+            'Factory functions for test data creation',
+            'Snapshot testing for UI components',
+            'In-source testing for utility functions',
+        ],
+        gotchas: [
+            'Module mocks must be before imports',
+            'Async tests need await or return promise',
+            'Timer mocks require useFakeTimers()',
+            'Coverage thresholds can block CI',
+        ],
+        source: 'built-in',
+    },
+};
+/**
+ * Get research results for a library
+ * Uses built-in knowledge base with web research as supplement
+ */
+export async function researchLibrary(libraryName) {
+    const normalizedName = libraryName.toLowerCase().replace(/@/g, '').replace(/\//g, '-');
+    // Check built-in knowledge base
+    for (const [key, value] of Object.entries(KNOWN_BEST_PRACTICES)) {
+        if (normalizedName.includes(key) || key.includes(normalizedName)) {
+            return {
+                library: libraryName,
+                ...value,
+            };
+        }
+    }
+    // Return empty result if no built-in knowledge
+    return {
+        library: libraryName,
+        bestPractices: [],
+        commonPatterns: [],
+        gotchas: [],
+        source: 'none',
+    };
+}
+/**
+ * Research multiple libraries in parallel
+ */
+export async function researchLibraries(libraryNames) {
+    return Promise.all(libraryNames.map(name => researchLibrary(name)));
+}
+//# sourceMappingURL=web-research.js.map