claude-cognitive 0.1.0

package/dist/learn/analyzers/structure.js

@@ -0,0 +1,172 @@
+/**
+ * Directory structure analyzer.
+ * @module learn/analyzers/structure
+ */
+import { readdir, stat } from "node:fs/promises";
+import { join, extname } from "node:path";
+/** Directories to skip during analysis */
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".next",
+    ".nuxt",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    ".cache",
+    "__pycache__",
+    ".venv",
+    "venv",
+]);
+/** Known source directory names */
+const SOURCE_DIRS = new Set([
+    "src",
+    "lib",
+    "app",
+    "source",
+    "packages",
+    "modules",
+]);
+/** Known test directory names */
+const TEST_DIRS = new Set([
+    "test",
+    "tests",
+    "__tests__",
+    "spec",
+    "specs",
+    "e2e",
+    "integration",
+]);
+/** Known config file patterns */
+const CONFIG_PATTERNS = [
+    /^tsconfig.*\.json$/,
+    /^\.eslintrc/,
+    /^\.prettierrc/,
+    /^vite\.config\./,
+    /^webpack\.config\./,
+    /^next\.config\./,
+    /^tailwind\.config\./,
+    /^jest\.config\./,
+    /^vitest\.config\./,
+    /^\.env/,
+    /^docker-compose/,
+    /^Dockerfile/,
+];
+/** Known entry point patterns */
+const ENTRY_PATTERNS = [
+    /^index\.[jt]sx?$/,
+    /^main\.[jt]sx?$/,
+    /^app\.[jt]sx?$/,
+    /^server\.[jt]sx?$/,
+    /^cli\.[jt]sx?$/,
+];
+/**
+ * Analyze directory structure of a project.
+ *
+ * @param projectPath - Project root directory
+ * @param maxDepth - Maximum depth to scan (default: 4)
+ * @returns Structure analysis
+ */
+export async function analyzeStructure(projectPath, maxDepth = 4) {
+    const result = {
+        sourceDirectories: [],
+        testDirectories: [],
+        configFiles: [],
+        entryPoints: [],
+        totalFiles: 0,
+        fileTypes: {},
+        topLevelDirs: [],
+    };
+    await scanDirectory(projectPath, result, 0, maxDepth, "");
+    return result;
+}
+/**
+ * Recursively scan a directory.
+ * @internal
+ */
+async function scanDirectory(dir, result, depth, maxDepth, relativePath) {
+    if (depth > maxDepth)
+        return;
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return; // Can't read directory
+    }
+    for (const entry of entries) {
+        if (SKIP_DIRS.has(entry))
+            continue;
+        const fullPath = join(dir, entry);
+        const relPath = relativePath ? `${relativePath}/${entry}` : entry;
+        let entryStat;
+        try {
+            entryStat = await stat(fullPath);
+        }
+        catch {
+            continue; // Can't stat entry
+        }
+        if (entryStat.isDirectory()) {
+            // Track top-level directories
+            if (depth === 0) {
+                result.topLevelDirs.push(entry);
+            }
+            // Identify source/test directories
+            if (SOURCE_DIRS.has(entry.toLowerCase())) {
+                result.sourceDirectories.push(relPath);
+            }
+            if (TEST_DIRS.has(entry.toLowerCase())) {
+                result.testDirectories.push(relPath);
+            }
+            // Recurse
+            await scanDirectory(fullPath, result, depth + 1, maxDepth, relPath);
+        }
+        else {
+            // Track file
+            result.totalFiles++;
+            // Track file types
+            const ext = extname(entry).toLowerCase() || "(no ext)";
+            result.fileTypes[ext] = (result.fileTypes[ext] || 0) + 1;
+            // Check for config files (only at root or config dirs)
+            if (depth <= 1 && CONFIG_PATTERNS.some((p) => p.test(entry))) {
+                result.configFiles.push(relPath);
+            }
+            // Check for entry points
+            if (ENTRY_PATTERNS.some((p) => p.test(entry))) {
+                // Prioritize entry points in source directories
+                const inSource = result.sourceDirectories.some((sd) => relPath.startsWith(sd + "/") || relativePath === sd);
+                if (inSource || depth <= 1) {
+                    result.entryPoints.push(relPath);
+                }
+            }
+        }
+    }
+}
+/**
+ * Get a summary of the project structure.
+ *
+ * @param analysis - Structure analysis result
+ * @returns Human-readable structure summary
+ */
+export function getStructureSummary(analysis) {
+    const parts = [];
+    if (analysis.sourceDirectories.length > 0) {
+        parts.push(`Source: ${analysis.sourceDirectories.join(", ")}`);
+    }
+    if (analysis.testDirectories.length > 0) {
+        parts.push(`Tests: ${analysis.testDirectories.join(", ")}`);
+    }
+    // Top file types
+    const topTypes = Object.entries(analysis.fileTypes)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([ext, count]) => `${ext}(${count})`)
+        .join(", ");
+    if (topTypes) {
+        parts.push(`Files: ${topTypes}`);
+    }
+    parts.push(`Total: ${analysis.totalFiles} files`);
+    return parts.join("; ");
+}
+//# sourceMappingURL=structure.js.map

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

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

package/dist/learn/extractor.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Fact extraction from analysis results.
+ * @module learn/extractor
+ */
+import type { ExtractedFact } from "../types.js";
+import type { ReadmeAnalysis } from "./analyzers/readme.js";
+import type { PackageAnalysis } from "./analyzers/package.js";
+import type { StructureAnalysis } from "./analyzers/structure.js";
+import type { GitAnalysis } from "./analyzers/git.js";
+import type { SourceAnalysis } from "./analyzers/source.js";
+/**
+ * Combined analysis results for fact extraction.
+ */
+export interface AnalysisResults {
+    readme?: ReadmeAnalysis | null;
+    package?: PackageAnalysis | null;
+    structure?: StructureAnalysis | null;
+    git?: GitAnalysis | null;
+    source?: SourceAnalysis | null;
+}
+/**
+ * Fact extractor interface.
+ */
+export interface FactExtractor {
+    /**
+     * Extract facts from analysis results.
+     *
+     * @param analysis - Combined analysis results
+     * @returns Array of extracted facts
+     */
+    extractFacts(analysis: AnalysisResults): ExtractedFact[];
+}
+/**
+ * Default fact extractor implementation.
+ *
+ * Converts analysis results into structured facts for storage in Hindsight.
+ */
+export declare class DefaultFactExtractor implements FactExtractor {
+    /**
+     * Extract facts from analysis results.
+     *
+     * @param analysis - Combined analysis results
+     * @returns Array of extracted facts
+     */
+    extractFacts(analysis: AnalysisResults): ExtractedFact[];
+    /**
+     * Extract facts from README analysis.
+     * @internal
+     */
+    private extractFromReadme;
+    /**
+     * Extract facts from package.json analysis.
+     * @internal
+     */
+    private extractFromPackage;
+    /**
+     * Extract facts from structure analysis.
+     * @internal
+     */
+    private extractFromStructure;
+    /**
+     * Extract facts from git history analysis.
+     * @internal
+     */
+    private extractFromGit;
+    /**
+     * Extract facts from source code analysis.
+     * @internal
+     */
+    private extractFromSource;
+}
+/**
+ * Create a default fact extractor.
+ */
+export declare function createFactExtractor(): FactExtractor;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/learn/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/learn/extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,EAAE,CAAC;CAC1D;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,EAAE;IA+BxD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAoG1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAoD5B;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2CtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAyC1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/learn/extractor.js

@@ -0,0 +1,302 @@
+/**
+ * Fact extraction from analysis results.
+ * @module learn/extractor
+ */
+/**
+ * Default fact extractor implementation.
+ *
+ * Converts analysis results into structured facts for storage in Hindsight.
+ */
+export class DefaultFactExtractor {
+    /**
+     * Extract facts from analysis results.
+     *
+     * @param analysis - Combined analysis results
+     * @returns Array of extracted facts
+     */
+    extractFacts(analysis) {
+        const facts = [];
+        // Extract from README
+        if (analysis.readme) {
+            facts.push(...this.extractFromReadme(analysis.readme));
+        }
+        // Extract from package.json
+        if (analysis.package) {
+            facts.push(...this.extractFromPackage(analysis.package));
+        }
+        // Extract from structure
+        if (analysis.structure) {
+            facts.push(...this.extractFromStructure(analysis.structure));
+        }
+        // Extract from git history
+        if (analysis.git) {
+            facts.push(...this.extractFromGit(analysis.git));
+        }
+        // Extract from source analysis
+        if (analysis.source) {
+            facts.push(...this.extractFromSource(analysis.source));
+        }
+        return facts;
+    }
+    /**
+     * Extract facts from README analysis.
+     * @internal
+     */
+    extractFromReadme(readme) {
+        const facts = [];
+        // Project description
+        if (readme.projectDescription) {
+            facts.push({
+                content: `Project description: ${readme.projectDescription}`,
+                context: "Extracted from README.md",
+                category: "decisions",
+            });
+        }
+        // Features
+        if (readme.features.length > 0) {
+            facts.push({
+                content: `Key features: ${readme.features.slice(0, 5).join("; ")}`,
+                context: "Extracted from README.md features section",
+                category: "decisions",
+            });
+        }
+        // Setup instructions
+        if (readme.setupInstructions.length > 0) {
+            facts.push({
+                content: `Setup commands: ${readme.setupInstructions.slice(0, 3).join(", ")}`,
+                context: "Extracted from README.md installation section",
+                category: "decisions",
+            });
+        }
+        return facts;
+    }
+    /**
+     * Extract facts from package.json analysis.
+     * @internal
+     */
+    extractFromPackage(pkg) {
+        const facts = [];
+        // Project identity
+        if (pkg.description) {
+            facts.push({
+                content: `Package ${pkg.name}: ${pkg.description}`,
+                context: "From package.json",
+                category: "decisions",
+            });
+        }
+        // Tech stack - frameworks
+        const frameworks = pkg.dependencies.filter((d) => d.category === "framework");
+        if (frameworks.length > 0) {
+            facts.push({
+                content: `Framework stack: ${frameworks.map((f) => f.name).join(", ")}`,
+                context: "From package.json dependencies",
+                category: "stack",
+            });
+        }
+        // Tech stack - UI
+        const ui = pkg.dependencies.filter((d) => d.category === "ui");
+        if (ui.length > 0) {
+            facts.push({
+                content: `UI libraries: ${ui.map((u) => u.name).join(", ")}`,
+                context: "From package.json dependencies",
+                category: "stack",
+            });
+        }
+        // Tech stack - state management
+        const state = pkg.dependencies.filter((d) => d.category === "state");
+        if (state.length > 0) {
+            facts.push({
+                content: `State management: ${state.map((s) => s.name).join(", ")}`,
+                context: "From package.json dependencies",
+                category: "stack",
+            });
+        }
+        // Tech stack - database
+        const db = pkg.dependencies.filter((d) => d.category === "database");
+        if (db.length > 0) {
+            facts.push({
+                content: `Database/ORM: ${db.map((d) => d.name).join(", ")}`,
+                context: "From package.json dependencies",
+                category: "stack",
+            });
+        }
+        // Development tools
+        const build = pkg.devDependencies.filter((d) => d.category === "build");
+        if (build.length > 0) {
+            facts.push({
+                content: `Build tools: ${build.map((b) => b.name).join(", ")}`,
+                context: "From package.json devDependencies",
+                category: "stack",
+            });
+        }
+        // Testing tools
+        const testing = pkg.devDependencies.filter((d) => d.category === "testing");
+        if (testing.length > 0) {
+            facts.push({
+                content: `Testing tools: ${testing.map((t) => t.name).join(", ")}`,
+                context: "From package.json devDependencies",
+                category: "stack",
+            });
+        }
+        // Key scripts
+        const importantScripts = ["test", "build", "dev", "start", "lint"];
+        const scripts = Object.entries(pkg.scripts)
+            .filter(([name]) => importantScripts.includes(name))
+            .map(([name, cmd]) => `${name}: ${cmd}`);
+        if (scripts.length > 0) {
+            facts.push({
+                content: `NPM scripts: ${scripts.join("; ")}`,
+                context: "From package.json scripts",
+                category: "decisions",
+            });
+        }
+        // TypeScript detection
+        const hasTS = pkg.devDependencies.some((d) => d.name === "typescript") ||
+            pkg.dependencies.some((d) => d.name === "typescript");
+        if (hasTS) {
+            facts.push({
+                content: "Language: TypeScript",
+                context: "TypeScript found in dependencies",
+                category: "stack",
+            });
+        }
+        return facts;
+    }
+    /**
+     * Extract facts from structure analysis.
+     * @internal
+     */
+    extractFromStructure(structure) {
+        const facts = [];
+        // Project structure
+        if (structure.sourceDirectories.length > 0 || structure.testDirectories.length > 0) {
+            const parts = [];
+            if (structure.sourceDirectories.length > 0) {
+                parts.push(`source in ${structure.sourceDirectories.join(", ")}`);
+            }
+            if (structure.testDirectories.length > 0) {
+                parts.push(`tests in ${structure.testDirectories.join(", ")}`);
+            }
+            facts.push({
+                content: `Project structure: ${parts.join("; ")}`,
+                context: "Analyzed directory structure",
+                category: "structure",
+            });
+        }
+        // Entry points
+        if (structure.entryPoints.length > 0) {
+            facts.push({
+                content: `Entry points: ${structure.entryPoints.slice(0, 5).join(", ")}`,
+                context: "Identified from file naming patterns",
+                category: "structure",
+            });
+        }
+        // Config files
+        if (structure.configFiles.length > 0) {
+            facts.push({
+                content: `Configuration files: ${structure.configFiles.slice(0, 10).join(", ")}`,
+                context: "Found in project root",
+                category: "structure",
+            });
+        }
+        // File type distribution
+        const topTypes = Object.entries(structure.fileTypes)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        if (topTypes.length > 0) {
+            facts.push({
+                content: `File types: ${topTypes.map(([ext, count]) => `${ext}(${count})`).join(", ")}`,
+                context: "From file extension analysis",
+                category: "structure",
+            });
+        }
+        return facts;
+    }
+    /**
+     * Extract facts from git history analysis.
+     * @internal
+     */
+    extractFromGit(git) {
+        const facts = [];
+        // Team size
+        if (git.contributors.length > 0) {
+            facts.push({
+                content: `Team: ${git.contributors.length} contributors (${git.contributors.slice(0, 5).join(", ")})`,
+                context: "From git history",
+                category: "history",
+            });
+        }
+        // Commit convention
+        if (git.commitPatterns.messageConvention) {
+            facts.push({
+                content: `Commit convention: ${git.commitPatterns.messageConvention}`,
+                context: "Detected from commit messages",
+                category: "patterns",
+            });
+        }
+        // Significant commits (decisions)
+        for (const commit of git.significantCommits.slice(0, 5)) {
+            facts.push({
+                content: `Historical decision: ${commit.message}`,
+                context: `From git commit ${commit.hash} on ${commit.date}`,
+                category: "history",
+            });
+        }
+        // File hotspots
+        if (git.hotspots.length > 0) {
+            const topHotspots = git.hotspots.slice(0, 5);
+            facts.push({
+                content: `Most active files: ${topHotspots.map((h) => h.file).join(", ")}`,
+                context: "Based on git commit frequency",
+                category: "patterns",
+            });
+        }
+        return facts;
+    }
+    /**
+     * Extract facts from source code analysis.
+     * @internal
+     */
+    extractFromSource(source) {
+        const facts = [];
+        // Coding conventions
+        facts.push({
+            content: `Naming convention: ${source.conventions.namingStyle}`,
+            context: "Detected from source code analysis",
+            category: "patterns",
+        });
+        facts.push({
+            content: `Import style: ${source.conventions.importStyle} imports preferred`,
+            context: "Detected from source code analysis",
+            category: "patterns",
+        });
+        facts.push({
+            content: `Error handling: ${source.conventions.errorHandling}`,
+            context: "Detected from source code analysis",
+            category: "patterns",
+        });
+        if (source.conventions.prefersAsync) {
+            facts.push({
+                content: "Async/await is preferred over raw Promises",
+                context: "Detected from source code analysis",
+                category: "patterns",
+            });
+        }
+        // Code patterns
+        for (const pattern of source.patterns) {
+            facts.push({
+                content: `Code pattern: ${pattern.description}`,
+                context: `Found in: ${pattern.examples.slice(0, 3).join(", ")}`,
+                category: "patterns",
+            });
+        }
+        return facts;
+    }
+}
+/**
+ * Create a default fact extractor.
+ */
+export function createFactExtractor() {
+    return new DefaultFactExtractor();
+}
+//# sourceMappingURL=extractor.js.map

package/dist/learn/extractor.js.map

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

package/dist/learn/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Learn operation - bootstrap memory from existing codebase.
+ * @module learn
+ */
+import type { HindsightClient } from "../client.js";
+import type { LearnOptions, LearnResult } from "../types.js";
+/**
+ * Bootstrap memory from an existing codebase.
+ *
+ * This operation analyzes the project and stores facts in Hindsight,
+ * solving the cold start problem when adopting claude-cognitive.
+ *
+ * @param client - HindsightClient instance
+ * @param bankId - Memory bank ID
+ * @param projectPath - Project root directory
+ * @param options - Learn options
+ * @returns Learn result with summary and stats
+ *
+ * @example
+ * ```typescript
+ * const result = await learn(client, 'my-project', '/path/to/project', {
+ *   depth: 'full',
+ *   includeGitHistory: true
+ * });
+ *
+ * console.log(result.summary);
+ * // "Learned 47 world facts from 123 files, formed 5 opinions"
+ * ```
+ */
+export declare function learn(client: HindsightClient, bankId: string, projectPath: string, options?: LearnOptions): Promise<LearnResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learn/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAU,YAAY,EAAE,WAAW,EAAW,MAAM,aAAa,CAAC;AAoB9E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAmEtB"}