claude-cognitive 0.1.0

package/dist/learn/analyzers/readme.js

@@ -0,0 +1,163 @@
+/**
+ * README file analyzer.
+ * @module learn/analyzers/readme
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+/** Possible README filenames to check */
+const README_NAMES = [
+    "README.md",
+    "README",
+    "readme.md",
+    "readme",
+    "Readme.md",
+];
+/**
+ * Analyze README file in a project.
+ *
+ * @param projectPath - Project root directory
+ * @returns README analysis, or null if no README found
+ */
+export async function analyzeReadme(projectPath) {
+    // Find README file
+    let content = null;
+    for (const name of README_NAMES) {
+        try {
+            content = await readFile(join(projectPath, name), "utf-8");
+            break;
+        }
+        catch {
+            // Try next name
+        }
+    }
+    if (!content)
+        return null;
+    return {
+        projectDescription: extractDescription(content),
+        setupInstructions: extractSetupInstructions(content),
+        features: extractFeatures(content),
+        documentation: extractDocumentationLinks(content),
+        rawContent: content,
+    };
+}
+/**
+ * Extract project description from README.
+ * Usually the first paragraph after the title.
+ * @internal
+ */
+function extractDescription(content) {
+    const lines = content.split("\n");
+    let foundTitle = false;
+    const descriptionLines = [];
+    for (const line of lines) {
+        // Skip title line
+        if (line.startsWith("# ") && !foundTitle) {
+            foundTitle = true;
+            continue;
+        }
+        // Skip badges (common after title)
+        if (line.includes("![") || line.includes("[![")) {
+            continue;
+        }
+        // Empty line after description ends it
+        if (foundTitle && descriptionLines.length > 0 && line.trim() === "") {
+            break;
+        }
+        // Skip empty lines before description
+        if (foundTitle && line.trim() === "") {
+            continue;
+        }
+        // Next heading ends description
+        if (foundTitle && line.startsWith("#")) {
+            break;
+        }
+        // Collect description lines
+        if (foundTitle && line.trim()) {
+            descriptionLines.push(line.trim());
+        }
+    }
+    return descriptionLines.join(" ");
+}
+/**
+ * Extract setup/installation instructions.
+ * @internal
+ */
+function extractSetupInstructions(content) {
+    const instructions = [];
+    // Look for Installation, Setup, Getting Started sections
+    const sectionPatterns = [
+        /## (?:Installation|Setup|Getting Started|Quick Start)/i,
+    ];
+    const lines = content.split("\n");
+    let inSection = false;
+    for (const line of lines) {
+        // Check if entering a relevant section
+        if (sectionPatterns.some((p) => p.test(line))) {
+            inSection = true;
+            continue;
+        }
+        // Exit section on next heading
+        if (inSection && line.startsWith("##")) {
+            break;
+        }
+        // Collect code blocks and list items in section
+        if (inSection) {
+            if (line.includes("npm ") || line.includes("yarn ") || line.includes("npx ")) {
+                instructions.push(line.trim().replace(/^[\s$]+/, ""));
+            }
+            else if (line.trim().startsWith("-") || line.trim().startsWith("*")) {
+                instructions.push(line.trim().replace(/^[-*]\s*/, ""));
+            }
+        }
+    }
+    return instructions.slice(0, 10); // Limit to 10 instructions
+}
+/**
+ * Extract features list.
+ * @internal
+ */
+function extractFeatures(content) {
+    const features = [];
+    // Look for Features section
+    const lines = content.split("\n");
+    let inSection = false;
+    for (const line of lines) {
+        if (/## (?:Features|Capabilities|What it does)/i.test(line)) {
+            inSection = true;
+            continue;
+        }
+        if (inSection && line.startsWith("##")) {
+            break;
+        }
+        if (inSection && (line.trim().startsWith("-") || line.trim().startsWith("*"))) {
+            features.push(line.trim().replace(/^[-*]\s*/, ""));
+        }
+    }
+    return features.slice(0, 15); // Limit to 15 features
+}
+/**
+ * Extract documentation links.
+ * @internal
+ */
+function extractDocumentationLinks(content) {
+    const links = [];
+    // Find markdown links
+    const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+    let match;
+    while ((match = linkPattern.exec(content)) !== null) {
+        const text = match[1];
+        const url = match[2];
+        // Filter for documentation-like links
+        if (text && url) {
+            if (url.includes("docs") ||
+                url.includes("wiki") ||
+                url.includes("guide") ||
+                text.toLowerCase().includes("doc") ||
+                text.toLowerCase().includes("api")) {
+                links.push(`${text}: ${url}`);
+            }
+        }
+    }
+    return links.slice(0, 10);
+}
+//# sourceMappingURL=readme.js.map

package/dist/learn/analyzers/readme.js.map

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

package/dist/learn/analyzers/source.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Source code analyzer for full depth learning.
+ * @module learn/analyzers/source
+ */
+/**
+ * Code pattern detected in source.
+ */
+export interface CodePattern {
+    /** Pattern type identifier */
+    type: string;
+    /** Human-readable description */
+    description: string;
+    /** Example file paths where pattern was found */
+    examples: string[];
+}
+/**
+ * Module information.
+ */
+export interface ModuleInfo {
+    /** Module name (typically filename without extension) */
+    name: string;
+    /** File path */
+    path: string;
+    /** Exported identifiers */
+    exports: string[];
+    /** Imported modules */
+    imports: string[];
+}
+/**
+ * Detected coding conventions.
+ */
+export interface CodingConventions {
+    /** Naming style for variables/functions */
+    namingStyle: "camelCase" | "snake_case" | "PascalCase" | "mixed";
+    /** Import style preference */
+    importStyle: "named" | "default" | "mixed";
+    /** Error handling approach */
+    errorHandling: string;
+    /** Whether async/await is preferred */
+    prefersAsync: boolean;
+}
+/**
+ * Analysis result from source code.
+ */
+export interface SourceAnalysis {
+    /** Detected code patterns */
+    patterns: CodePattern[];
+    /** Module information */
+    modules: ModuleInfo[];
+    /** Coding conventions */
+    conventions: CodingConventions;
+    /** Files analyzed */
+    filesAnalyzed: number;
+}
+/**
+ * Analyze source files in a project.
+ *
+ * @param projectPath - Project root directory
+ * @param filePaths - Paths to analyze (relative to project)
+ * @returns Source analysis
+ */
+export declare function analyzeSource(projectPath: string, filePaths: string[]): Promise<SourceAnalysis>;
+/**
+ * Get a summary of source analysis.
+ *
+ * @param analysis - Source analysis result
+ * @returns Human-readable source summary
+ */
+export declare function getSourceSummary(analysis: SourceAnalysis): string;
+//# sourceMappingURL=source.d.ts.map

package/dist/learn/analyzers/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/learn/analyzers/source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,WAAW,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC;IACjE,8BAA8B;IAC9B,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3C,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,yBAAyB;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,yBAAyB;IACzB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAkBD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,cAAc,CAAC,CAoEzB;AAiLD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAajE"}

package/dist/learn/analyzers/source.js

@@ -0,0 +1,231 @@
+/**
+ * Source code analyzer for full depth learning.
+ * @module learn/analyzers/source
+ */
+import { readFile } from "node:fs/promises";
+import { extname } from "node:path";
+/**
+ * Analyze source files in a project.
+ *
+ * @param projectPath - Project root directory
+ * @param filePaths - Paths to analyze (relative to project)
+ * @returns Source analysis
+ */
+export async function analyzeSource(projectPath, filePaths) {
+    const patterns = [];
+    const modules = [];
+    const conventionStats = {
+        camelCase: 0,
+        snake_case: 0,
+        PascalCase: 0,
+        namedImports: 0,
+        defaultImports: 0,
+        tryCatch: 0,
+        errorCallbacks: 0,
+        asyncAwait: 0,
+        promiseCount: 0,
+    };
+    let filesAnalyzed = 0;
+    for (const filePath of filePaths) {
+        try {
+            const fullPath = `${projectPath}/${filePath}`;
+            const content = await readFile(fullPath, "utf-8");
+            const ext = extname(filePath).toLowerCase();
+            // Only analyze JS/TS files
+            if (![".js", ".ts", ".jsx", ".tsx", ".mjs", ".mts"].includes(ext)) {
+                continue;
+            }
+            filesAnalyzed++;
+            // Analyze the file
+            const analysis = analyzeFile(content, filePath);
+            // Collect module info
+            modules.push({
+                name: filePath.replace(/\.[^/.]+$/, ""),
+                path: filePath,
+                exports: analysis.exports,
+                imports: analysis.imports,
+            });
+            // Update convention stats
+            conventionStats.camelCase += analysis.camelCaseCount;
+            conventionStats.snake_case += analysis.snakeCaseCount;
+            conventionStats.PascalCase += analysis.pascalCaseCount;
+            conventionStats.namedImports += analysis.namedImportCount;
+            conventionStats.defaultImports += analysis.defaultImportCount;
+            conventionStats.tryCatch += analysis.tryCatchCount;
+            conventionStats.errorCallbacks += analysis.errorCallbackCount;
+            conventionStats.asyncAwait += analysis.asyncAwaitCount;
+            conventionStats.promiseCount += analysis.promiseCount;
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    // Detect patterns from aggregated analysis
+    patterns.push(...detectPatterns(modules));
+    // Determine conventions
+    const conventions = determineConventions(conventionStats);
+    return {
+        patterns,
+        modules,
+        conventions,
+        filesAnalyzed,
+    };
+}
+/**
+ * Analyze a single file.
+ * @internal
+ */
+function analyzeFile(content, _filePath) {
+    const result = {
+        exports: [],
+        imports: [],
+        camelCaseCount: 0,
+        snakeCaseCount: 0,
+        pascalCaseCount: 0,
+        namedImportCount: 0,
+        defaultImportCount: 0,
+        tryCatchCount: 0,
+        errorCallbackCount: 0,
+        asyncAwaitCount: 0,
+        promiseCount: 0,
+    };
+    // Extract exports
+    const exportMatches = content.matchAll(/export\s+(?:const|let|var|function|class|interface|type|enum)\s+(\w+)/g);
+    for (const match of exportMatches) {
+        if (match[1]) {
+            result.exports.push(match[1]);
+        }
+    }
+    // Extract export { ... }
+    const namedExportMatches = content.matchAll(/export\s*\{([^}]+)\}/g);
+    for (const match of namedExportMatches) {
+        if (match[1]) {
+            const names = match[1].split(",").map((n) => {
+                const parts = n.trim().split(" as ");
+                return parts[0]?.trim() ?? "";
+            });
+            result.exports.push(...names.filter(Boolean));
+        }
+    }
+    // Extract imports
+    const importMatches = content.matchAll(/import\s+.*?\s+from\s+['"]([^'"]+)['"]/g);
+    for (const match of importMatches) {
+        if (match[1]) {
+            result.imports.push(match[1]);
+        }
+    }
+    // Count naming conventions
+    const identifierMatches = content.matchAll(/\b([a-z][a-zA-Z0-9]*)\b/g);
+    for (const match of identifierMatches) {
+        const name = match[1];
+        if (name && name.length > 0) {
+            const firstChar = name[0];
+            if (name.includes("_")) {
+                result.snakeCaseCount++;
+            }
+            else if (firstChar && firstChar === firstChar.toUpperCase()) {
+                result.pascalCaseCount++;
+            }
+            else {
+                result.camelCaseCount++;
+            }
+        }
+    }
+    // Count import styles
+    result.namedImportCount = (content.match(/import\s*\{/g) || []).length;
+    result.defaultImportCount = (content.match(/import\s+\w+\s+from/g) || []).length;
+    // Count error handling
+    result.tryCatchCount = (content.match(/try\s*\{/g) || []).length;
+    result.errorCallbackCount = (content.match(/\.catch\s*\(/g) || []).length;
+    // Count async patterns
+    result.asyncAwaitCount = (content.match(/\basync\b/g) || []).length;
+    result.promiseCount = (content.match(/new\s+Promise/g) || []).length;
+    return result;
+}
+/**
+ * Detect patterns from module analysis.
+ * @internal
+ */
+function detectPatterns(modules) {
+    const patterns = [];
+    // Detect barrel exports (index.ts that re-exports)
+    const barrelModules = modules.filter((m) => m.name.endsWith("index") && m.exports.length > 3);
+    if (barrelModules.length > 0) {
+        patterns.push({
+            type: "barrel-exports",
+            description: "Uses barrel exports (index files that re-export)",
+            examples: barrelModules.slice(0, 3).map((m) => m.path),
+        });
+    }
+    // Detect modular architecture
+    const hasMultipleModules = modules.length > 10;
+    const avgExports = modules.reduce((sum, m) => sum + m.exports.length, 0) / modules.length;
+    if (hasMultipleModules && avgExports < 10) {
+        patterns.push({
+            type: "modular-architecture",
+            description: "Follows modular architecture with small, focused modules",
+            examples: modules.slice(0, 3).map((m) => m.path),
+        });
+    }
+    return patterns;
+}
+/**
+ * Determine coding conventions from stats.
+ * @internal
+ */
+function determineConventions(stats) {
+    // Determine naming style
+    let namingStyle = "mixed";
+    const totalNaming = stats.camelCase + stats.snake_case + stats.PascalCase;
+    if (stats.camelCase > totalNaming * 0.6) {
+        namingStyle = "camelCase";
+    }
+    else if (stats.snake_case > totalNaming * 0.6) {
+        namingStyle = "snake_case";
+    }
+    else if (stats.PascalCase > totalNaming * 0.6) {
+        namingStyle = "PascalCase";
+    }
+    // Determine import style
+    let importStyle = "mixed";
+    const totalImports = stats.namedImports + stats.defaultImports;
+    if (stats.namedImports > totalImports * 0.7) {
+        importStyle = "named";
+    }
+    else if (stats.defaultImports > totalImports * 0.7) {
+        importStyle = "default";
+    }
+    // Determine error handling
+    let errorHandling = "mixed";
+    if (stats.tryCatch > stats.errorCallbacks * 2) {
+        errorHandling = "try-catch blocks";
+    }
+    else if (stats.errorCallbacks > stats.tryCatch * 2) {
+        errorHandling = "promise .catch()";
+    }
+    // Determine async preference
+    const prefersAsync = stats.asyncAwait > stats.promiseCount;
+    return {
+        namingStyle,
+        importStyle,
+        errorHandling,
+        prefersAsync,
+    };
+}
+/**
+ * Get a summary of source analysis.
+ *
+ * @param analysis - Source analysis result
+ * @returns Human-readable source summary
+ */
+export function getSourceSummary(analysis) {
+    const parts = [];
+    parts.push(`${analysis.filesAnalyzed} files analyzed`);
+    parts.push(`${analysis.modules.length} modules`);
+    if (analysis.patterns.length > 0) {
+        parts.push(`Patterns: ${analysis.patterns.map((p) => p.type).join(", ")}`);
+    }
+    parts.push(`Style: ${analysis.conventions.namingStyle}`);
+    return parts.join("; ");
+}
+//# sourceMappingURL=source.js.map

package/dist/learn/analyzers/source.js.map

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

package/dist/learn/analyzers/structure.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Directory structure analyzer.
+ * @module learn/analyzers/structure
+ */
+/**
+ * Analysis result from directory structure.
+ */
+export interface StructureAnalysis {
+    /** Identified source directories */
+    sourceDirectories: string[];
+    /** Identified test directories */
+    testDirectories: string[];
+    /** Configuration files found */
+    configFiles: string[];
+    /** Likely entry points */
+    entryPoints: string[];
+    /** Total files analyzed */
+    totalFiles: number;
+    /** File types distribution (extension -> count) */
+    fileTypes: Record<string, number>;
+    /** Top-level directories */
+    topLevelDirs: string[];
+}
+/**
+ * Analyze directory structure of a project.
+ *
+ * @param projectPath - Project root directory
+ * @param maxDepth - Maximum depth to scan (default: 4)
+ * @returns Structure analysis
+ */
+export declare function analyzeStructure(projectPath: string, maxDepth?: number): Promise<StructureAnalysis>;
+/**
+ * Get a summary of the project structure.
+ *
+ * @param analysis - Structure analysis result
+ * @returns Human-readable structure summary
+ */
+export declare function getStructureSummary(analysis: StructureAnalysis): string;
+//# sourceMappingURL=structure.d.ts.map

package/dist/learn/analyzers/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/learn/analyzers/structure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kCAAkC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gCAAgC;IAChC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,4BAA4B;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAgED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AA8ED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAwBvE"}