claude-cognitive 0.1.0

package/dist/learn/index.js

@@ -0,0 +1,165 @@
+/**
+ * Learn operation - bootstrap memory from existing codebase.
+ * @module learn
+ */
+import { analyzeReadme, analyzePackage, analyzeStructure, analyzeGitHistory, analyzeSource, } from "./analyzers/index.js";
+import { createFactExtractor } from "./extractor.js";
+/**
+ * Default options for learn().
+ */
+const DEFAULT_OPTIONS = {
+    depth: "standard",
+    includeGitHistory: true,
+    maxCommits: 100,
+    includeDependencies: true,
+};
+/**
+ * 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 async function learn(client, bankId, projectPath, options = {}) {
+    const startTime = Date.now();
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Phase 1: Run analysis based on depth
+    const analysis = await runAnalysis(projectPath, opts);
+    // Phase 2: Extract facts
+    const extractor = createFactExtractor();
+    const facts = extractor.extractFacts(analysis.results);
+    // Phase 3: Store facts via retain()
+    let worldFacts = 0;
+    const failedFacts = [];
+    for (const fact of facts) {
+        try {
+            await client.retain(bankId, fact.content, fact.context);
+            worldFacts++;
+        }
+        catch (error) {
+            // Log but continue - don't fail entire learn on single fact
+            const msg = error instanceof Error ? error.message : String(error);
+            failedFacts.push(`${fact.content.substring(0, 50)}...: ${msg}`);
+        }
+    }
+    // Phase 4: Form initial opinions via reflect()
+    const opinions = [];
+    const entities = [];
+    const entitySet = new Set();
+    const reflectionQueries = getReflectionQueries(opts.depth);
+    for (const query of reflectionQueries) {
+        try {
+            const result = await client.reflect(bankId, query);
+            opinions.push(...result.opinions);
+            // Collect entities from basedOn memories
+            const allMemories = [
+                ...result.basedOn.world,
+                ...result.basedOn.experience,
+                ...result.basedOn.opinion,
+            ];
+            for (const memory of allMemories) {
+                for (const entity of memory.entities ?? []) {
+                    if (!entitySet.has(entity.id)) {
+                        entitySet.add(entity.id);
+                        entities.push(entity);
+                    }
+                }
+            }
+        }
+        catch {
+            // Reflection failed, continue without opinions for this query
+        }
+    }
+    const duration = Date.now() - startTime;
+    return {
+        summary: generateSummary(worldFacts, opinions, analysis.filesAnalyzed, duration, failedFacts),
+        worldFacts,
+        opinions,
+        entities,
+        filesAnalyzed: analysis.filesAnalyzed,
+        duration,
+    };
+}
+/**
+ * Run analysis based on depth.
+ * @internal
+ */
+async function runAnalysis(projectPath, opts) {
+    const results = {};
+    let filesAnalyzed = 0;
+    // Quick depth: README, package.json, structure (shallow)
+    results.readme = await analyzeReadme(projectPath);
+    results.package = await analyzePackage(projectPath);
+    results.structure = await analyzeStructure(projectPath, opts.depth === "quick" ? 2 : opts.depth === "standard" ? 4 : 10);
+    filesAnalyzed += results.structure?.totalFiles ?? 0;
+    // Standard and full depth: add git history
+    if (opts.depth !== "quick" && opts.includeGitHistory) {
+        const maxCommits = opts.depth === "standard" ? 50 : opts.maxCommits;
+        results.git = await analyzeGitHistory(projectPath, maxCommits);
+    }
+    // Full depth: add source code analysis
+    if (opts.depth === "full") {
+        // Get all source files from entry points and source directories
+        const sourceFiles = [];
+        if (results.structure?.entryPoints) {
+            sourceFiles.push(...results.structure.entryPoints);
+        }
+        // Add files from source directories (if available from structure scan)
+        // For now, we use entry points; a more complete implementation would
+        // recursively collect all source files
+        if (sourceFiles.length > 0) {
+            results.source = await analyzeSource(projectPath, sourceFiles);
+        }
+    }
+    return { results, filesAnalyzed };
+}
+/**
+ * Get reflection queries based on depth.
+ * @internal
+ */
+function getReflectionQueries(depth) {
+    const queries = [
+        "What are the main technologies and patterns used in this codebase?",
+    ];
+    if (depth === "standard" || depth === "full") {
+        queries.push("What architectural decisions seem important in this project?", "What areas of the codebase might need attention based on its structure?");
+    }
+    if (depth === "full") {
+        queries.push("What coding conventions and patterns should be followed when making changes?", "What are the most critical files and components in this codebase?");
+    }
+    return queries;
+}
+/**
+ * Generate human-readable summary.
+ * @internal
+ */
+function generateSummary(worldFacts, opinions, filesAnalyzed, duration, failedFacts) {
+    const parts = [];
+    parts.push(`Learned ${worldFacts} world facts from ${filesAnalyzed} files`);
+    if (opinions.length > 0) {
+        const avgConfidence = opinions.reduce((sum, o) => sum + o.confidence, 0) / opinions.length;
+        parts.push(`formed ${opinions.length} opinions with avg confidence ${avgConfidence.toFixed(2)}`);
+    }
+    parts.push(`Duration: ${(duration / 1000).toFixed(1)}s`);
+    if (failedFacts.length > 0) {
+        parts.push(`(${failedFacts.length} facts failed to store)`);
+    }
+    return parts.join("; ");
+}
+//# sourceMappingURL=index.js.map

package/dist/learn/index.js.map

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

package/dist/mcp/handlers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP tool execution handlers.
+ * @module mcp/handlers
+ */
+import type { Mind } from "../mind.js";
+import type { RecallToolInput, ReflectToolInput, ToolResult } from "./types.js";
+/**
+ * Handle memory_recall tool invocation.
+ *
+ * @param mind - Mind instance to use for recall
+ * @param input - Tool input with query and optional type filter
+ * @returns Tool result with formatted memories
+ */
+export declare function handleRecall(mind: Mind, input: RecallToolInput): Promise<ToolResult>;
+/**
+ * Handle memory_reflect tool invocation.
+ *
+ * @param mind - Mind instance to use for reflection
+ * @param input - Tool input with query
+ * @returns Tool result with formatted reflection
+ */
+export declare function handleReflect(mind: Mind, input: ReflectToolInput): Promise<ToolResult>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/mcp/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8EhF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,UAAU,CAAC,CA8BrB"}

package/dist/mcp/handlers.js

@@ -0,0 +1,124 @@
+/**
+ * MCP tool execution handlers.
+ * @module mcp/handlers
+ */
+// ============================================
+// Formatters
+// ============================================
+/**
+ * Format memories as readable text for Claude.
+ */
+function formatMemories(memories) {
+    if (memories.length === 0) {
+        return "No relevant memories found.";
+    }
+    const lines = [`Found ${memories.length} relevant memories:\n`];
+    for (const memory of memories) {
+        const date = new Date(memory.createdAt).toLocaleDateString();
+        const type = memory.factType;
+        lines.push(`[${type}] ${date}`);
+        lines.push(memory.text);
+        // Include confidence for opinions
+        if (memory.factType === "opinion" && memory.confidence !== undefined) {
+            lines.push(`  Confidence: ${(memory.confidence * 100).toFixed(0)}%`);
+        }
+        // Include context if available
+        if (memory.context) {
+            lines.push(`  Context: ${memory.context}`);
+        }
+        lines.push(""); // Blank line between memories
+    }
+    return lines.join("\n").trim();
+}
+/**
+ * Format reflect result as readable text for Claude.
+ */
+function formatReflection(result) {
+    const lines = [];
+    // Main reflection text
+    lines.push(result.text);
+    lines.push("");
+    // List opinions formed
+    if (result.opinions.length > 0) {
+        lines.push("Opinions formed:");
+        for (const opinion of result.opinions) {
+            const confidence = (opinion.confidence * 100).toFixed(0);
+            lines.push(`- ${opinion.opinion} (${confidence}% confidence)`);
+        }
+        lines.push("");
+    }
+    // Summarize what the reflection was based on
+    const worldCount = result.basedOn.world.length;
+    const expCount = result.basedOn.experience.length;
+    const opinionCount = result.basedOn.opinion.length;
+    const total = worldCount + expCount + opinionCount;
+    if (total > 0) {
+        lines.push(`Based on ${total} memories: ${worldCount} world facts, ${expCount} experiences, ${opinionCount} prior opinions.`);
+    }
+    return lines.join("\n").trim();
+}
+// ============================================
+// Handlers
+// ============================================
+/**
+ * Handle memory_recall tool invocation.
+ *
+ * @param mind - Mind instance to use for recall
+ * @param input - Tool input with query and optional type filter
+ * @returns Tool result with formatted memories
+ */
+export async function handleRecall(mind, input) {
+    try {
+        const options = input.type && input.type !== "all" ? { factType: input.type } : undefined;
+        const memories = await mind.recall(input.query, options);
+        const text = formatMemories(memories);
+        return {
+            content: [{ type: "text", text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+            content: [
+                { type: "text", text: `Error searching memories: ${message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Handle memory_reflect tool invocation.
+ *
+ * @param mind - Mind instance to use for reflection
+ * @param input - Tool input with query
+ * @returns Tool result with formatted reflection
+ */
+export async function handleReflect(mind, input) {
+    try {
+        const result = await mind.reflect(input.query);
+        const text = formatReflection(result);
+        return {
+            content: [{ type: "text", text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error occurred";
+        // Check if this is a degraded mode error
+        if (message.includes("requires Hindsight connection")) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Cannot reflect: Hindsight server is unavailable. Memory operations are in degraded mode.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: `Error reflecting: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/mcp/handlers.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MCP (Model Context Protocol) server for claude-cognitive.
+ * @module mcp
+ */
+export { ClaudeMindMcpServer } from "./server.js";
+export { TOOL_DEFINITIONS, recallInputSchema, reflectInputSchema, } from "./tools.js";
+export { handleRecall, handleReflect } from "./handlers.js";
+export type { HttpTransportConfig, McpServerOptions, McpTransportType, RecallToolInput, ReflectToolInput, ToolResult, ToolResultContent, } from "./types.js";
+import { ClaudeMindMcpServer } from "./server.js";
+import type { McpServerOptions } from "./types.js";
+/**
+ * Factory function to create and start an MCP server.
+ *
+ * @param options - Server configuration options
+ * @returns Started MCP server instance
+ *
+ * @example
+ * ```typescript
+ * import { createMcpServer } from 'claude-cognitive/mcp';
+ * import { Mind } from 'claude-cognitive';
+ *
+ * const mind = new Mind({ projectPath: process.cwd() });
+ * await mind.init();
+ *
+ * const server = await createMcpServer({
+ *   mind,
+ *   transport: 'stdio',
+ * });
+ * ```
+ */
+export declare function createMcpServer(options: McpServerOptions): Promise<ClaudeMindMcpServer>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG5D,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAI9B"}

package/dist/mcp/index.js

@@ -0,0 +1,40 @@
+/**
+ * MCP (Model Context Protocol) server for claude-cognitive.
+ * @module mcp
+ */
+// Server
+export { ClaudeMindMcpServer } from "./server.js";
+// Tools
+export { TOOL_DEFINITIONS, recallInputSchema, reflectInputSchema, } from "./tools.js";
+// Handlers
+export { handleRecall, handleReflect } from "./handlers.js";
+// ============================================
+// Factory Function
+// ============================================
+import { ClaudeMindMcpServer } from "./server.js";
+/**
+ * Factory function to create and start an MCP server.
+ *
+ * @param options - Server configuration options
+ * @returns Started MCP server instance
+ *
+ * @example
+ * ```typescript
+ * import { createMcpServer } from 'claude-cognitive/mcp';
+ * import { Mind } from 'claude-cognitive';
+ *
+ * const mind = new Mind({ projectPath: process.cwd() });
+ * await mind.init();
+ *
+ * const server = await createMcpServer({
+ *   mind,
+ *   transport: 'stdio',
+ * });
+ * ```
+ */
+export async function createMcpServer(options) {
+    const server = new ClaudeMindMcpServer(options);
+    await server.start();
+    return server;
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,SAAS;AACT,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAa5D,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAyB;IAEzB,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,79 @@
+/**
+ * MCP server implementation for claude-cognitive.
+ * @module mcp/server
+ */
+import type { McpServerOptions, McpTransportType } from "./types.js";
+/**
+ * ClaudeMindMcpServer wraps the MCP SDK and provides memory tools.
+ *
+ * Supports both STDIO and HTTP transports for flexible deployment:
+ * - STDIO: For local CLI integration with Claude Code
+ * - HTTP: For remote/networked deployments and testing
+ *
+ * @example
+ * ```typescript
+ * const mind = new Mind({ projectPath: '/path/to/project' });
+ * await mind.init();
+ *
+ * const server = new ClaudeMindMcpServer({
+ *   mind,
+ *   transport: 'stdio',
+ * });
+ *
+ * await server.start();
+ * ```
+ */
+export declare class ClaudeMindMcpServer {
+    private readonly mind;
+    private readonly transportType;
+    private readonly serverName;
+    private readonly serverVersion;
+    private readonly httpConfig;
+    private mcpServer;
+    private httpServer;
+    private expressApp;
+    private running;
+    constructor(options: McpServerOptions);
+    /**
+     * Start the MCP server.
+     *
+     * @throws {Error} If server is already running
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP server.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the server is running.
+     */
+    isRunning(): boolean;
+    /**
+     * Get the transport type.
+     */
+    getTransportType(): McpTransportType;
+    /**
+     * Get the HTTP port (only relevant for HTTP transport).
+     */
+    getHttpPort(): number;
+    /**
+     * Get the HTTP host (only relevant for HTTP transport).
+     */
+    getHttpHost(): string;
+    /**
+     * Register memory tools with the MCP server.
+     */
+    private registerTools;
+    /**
+     * Start STDIO transport.
+     */
+    private startStdioTransport;
+    /**
+     * Start HTTP transport with Express.
+     *
+     * Note: The MCP SDK's StreamableHTTPServerTransport is still experimental.
+     * For now, we implement a simple JSON-RPC endpoint.
+     */
+    private startHttpTransport;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,KAAK,EAEV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAmBpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAE3D,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,gBAAgB;IAarC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,gBAAgB,IAAI,gBAAgB;IAIpC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;YACW,mBAAmB;IAUjC;;;;;OAKG;YACW,kBAAkB;CA0GjC"}