claude-cognitive 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Claudiu Sfetancu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,256 @@
+# claude-cognitive
+
+Human-inspired memory system for Claude, powered by [Hindsight](https://github.com/vectorize-io/hindsight).
+
+**LLM thinks. Hindsight remembers. Together = mind.**
+
+Claude's context clears after each session. claude-cognitive gives Claude persistent memory across sessions - it remembers what it learned, what it did, and forms opinions about your codebase over time.
+
+---
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g claude-cognitive
+
+# Interactive setup (recommended)
+cd /path/to/your/project
+claude-cognitive install
+
+# Or manual setup
+claude-cognitive init      # Create config
+claude-cognitive learn     # Bootstrap memory
+```
+
+The interactive installer will:
+
+- Configure memory bank and disposition
+- Set up MCP server for Claude Code
+- Inject memory instructions into CLAUDE.md
+- Optionally bootstrap from your codebase
+
+```bash
+# Check status
+claude-cognitive status
+
+# Uninstall from a project
+claude-cognitive uninstall --delete-bank
+```
+
+---
+
+## How It Works
+
+![Session Lifecycle](./docs/session-lifecycle.svg)
+
+### Core Operations
+
+| Operation   | What It Does                                                           |
+| ----------- | ---------------------------------------------------------------------- |
+| **retain**  | Store memories with automatic extraction (what, when, where, who, why) |
+| **recall**  | 4-way parallel search: semantic + keyword + graph + temporal           |
+| **reflect** | Reason through the bank's disposition, form opinions                   |
+| **learn**   | Bootstrap memory from existing codebase (solves cold start)            |
+
+### Memory Types
+
+| Type          | Purpose                  | Example                                          |
+| ------------- | ------------------------ | ------------------------------------------------ |
+| `world`       | Facts about the codebase | "Auth uses Supabase magic links"                 |
+| `experience`  | What Claude did          | "I fixed the redirect by moving AuthProvider"    |
+| `opinion`     | Beliefs with confidence  | "This codebase prefers explicit patterns" (0.85) |
+| `observation` | Cross-session insights   | "Auth changes require navigation updates"        |
+
+---
+
+## Architecture
+
+![Architecture](./docs/architecture.svg)
+
+### Two Memory Layers
+
+| Layer         | Storage               | Purpose                                                |
+| ------------- | --------------------- | ------------------------------------------------------ |
+| **Hindsight** | PostgreSQL + pgvector | All memories, entity graphs, 4-way retrieval, opinions |
+| **Semantic**  | `.claude/memory.md`   | Human-curated knowledge, promoted observations         |
+
+---
+
+## MCP Tools
+
+When running as an MCP server, Claude has access to:
+
+### memory_recall
+
+Search project memories for relevant context.
+
+```
+Claude: "I remember we had issues with auth redirects..."
+→ memory_recall({ query: "auth redirect issues" })
+```
+
+### memory_reflect
+
+Reason about accumulated knowledge, form opinions.
+
+```
+Claude: "What patterns have I noticed about error handling?"
+→ memory_reflect({ query: "error handling patterns" })
+```
+
+---
+
+## CLI Commands
+
+```bash
+claude-cognitive init                   # Initialize for project
+claude-cognitive serve                  # Start MCP server
+claude-cognitive status                 # Show connection status
+claude-cognitive learn                  # Bootstrap from codebase
+claude-cognitive learn --depth full     # Full analysis with git history
+claude-cognitive recall "query"         # Search memories
+claude-cognitive reflect "query"        # Reason about knowledge
+claude-cognitive semantic               # Show semantic memory
+claude-cognitive config                 # Show configuration
+```
+
+---
+
+## Configuration
+
+### .claudemindrc
+
+```json
+{
+  "hindsight": {
+    "host": "localhost",
+    "port": 8888
+  },
+  "bankId": "my-project",
+  "disposition": {
+    "skepticism": 4,
+    "literalism": 4,
+    "empathy": 2
+  },
+  "background": "Developer assistant for a React Native app",
+  "semantic": {
+    "path": ".claude/memory.md"
+  }
+}
+```
+
+### Disposition Traits
+
+Each memory bank has personality traits that shape how `reflect()` reasons:
+
+| Trait      | Low (1)                 | High (5)                    |
+| ---------- | ----------------------- | --------------------------- |
+| skepticism | Trusting                | Questions claims            |
+| literalism | Flexible interpretation | Precise, literal            |
+| empathy    | Fact-focused            | Considers emotional context |
+
+---
+
+## Semantic Memory
+
+The `.claude/memory.md` file contains human-curated project knowledge:
+
+```markdown
+## Tech Stack
+
+- React Native with Expo SDK 51
+- Supabase for auth and database
+- NativeWind for styling
+
+## Key Decisions
+
+- Magic link auth for better mobile UX
+- Zustand for state management
+
+## Critical Paths
+
+- Auth: src/lib/supabase.ts → src/providers/AuthProvider.tsx
+
+## Observations
+
+<!-- Promoted from Hindsight when confidence > 0.9 -->
+
+- Auth changes often require navigation updates
+```
+
+This file is always loaded at session start and takes precedence over Hindsight memories when there are conflicts.
+
+---
+
+## Graceful Degradation
+
+When Hindsight is unavailable, claude-cognitive continues working with semantic memory only:
+
+| Operation     | With Hindsight | Without Hindsight          |
+| ------------- | -------------- | -------------------------- |
+| Session start | Full context   | Semantic only              |
+| recall        | 4-way search   | Empty results              |
+| reflect       | LLM reasoning  | Error (requires Hindsight) |
+| retain        | Stored         | Skipped                    |
+
+---
+
+## API Usage
+
+```typescript
+import { Mind } from "claude-cognitive";
+
+const mind = new Mind({
+  projectPath: process.cwd(),
+  disposition: { skepticism: 4, literalism: 4, empathy: 2 },
+});
+
+await mind.init();
+
+// Get context at session start
+const context = await mind.onSessionStart();
+
+// Recall relevant memories
+const memories = await mind.recall("authentication flow");
+
+// Reason about knowledge
+const reflection = await mind.reflect("What patterns exist?");
+
+// Store new memory
+await mind.retain("Fixed auth by moving Provider to root");
+
+// Bootstrap from codebase
+const result = await mind.learn({ depth: "full" });
+```
+
+---
+
+## Requirements
+
+- **Node.js 18+**
+- **[Hindsight](https://github.com/vectorize-io/hindsight)** server running (for full functionality)
+
+Without Hindsight, claude-cognitive works in degraded mode with semantic memory only.
+
+---
+
+## Documentation
+
+- **[Getting Started](./docs/getting-started.md)** - Installation and setup guide
+- **[Concepts](./docs/concepts.md)** - Memory networks, operations, architecture
+- **[Configuration](./docs/configuration.md)** - Full configuration reference
+- **[API Reference](./docs/api-reference.md)** - Complete API documentation
+- **[Performance](./docs/performance.md)** - Benchmarks and optimization
+
+---
+
+## Example
+
+See the [todo-app example](./examples/todo-app/) for a complete integration.
+
+---
+
+## License
+
+MIT

package/bin/claude-cognitive.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+// CLI entry point for claude-cognitive
+// This file is the bin entry that gets executed when running `claude-cognitive` or `npx claude-cognitive`
+
+import("../dist/cli/index.js").catch((error) => {
+  console.error("Failed to load claude-cognitive CLI:", error.message);
+  process.exit(1);
+});

package/dist/agents/context.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Agent context preparation for delegation.
+ * @module agents/context
+ */
+import type { HindsightClient } from "../client.js";
+import type { AgentContext, AgentTemplate, GetAgentContextOptions } from "./types.js";
+/**
+ * Prepare context for agent delegation.
+ *
+ * This is called by the orchestrator BEFORE delegating to an agent.
+ * It retrieves relevant memories and formats them for the agent.
+ *
+ * @param client - HindsightClient instance
+ * @param bankId - Memory bank ID
+ * @param template - Agent template to use
+ * @param task - Task description for the agent
+ * @param options - Context preparation options
+ * @returns Agent context with memories and task
+ */
+export declare function getAgentContext(client: HindsightClient, bankId: string, template: AgentTemplate, task: string, options?: GetAgentContextOptions): Promise<AgentContext>;
+/**
+ * Format agent context as a prompt string.
+ *
+ * This creates the system prompt / context injection for the agent.
+ *
+ * @param context - Agent context to format
+ * @returns Formatted prompt string
+ */
+export declare function formatAgentPrompt(context: AgentContext): string;
+/**
+ * Create a minimal context string for quick delegation.
+ *
+ * Useful when you don't need full memory retrieval.
+ *
+ * @param template - Agent template
+ * @param task - Task description
+ * @returns Minimal context string
+ */
+export declare function createMinimalContext(template: AgentTemplate, task: string): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/agents/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/agents/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEtF;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA2D/D;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,GACX,MAAM,CAeR"}

package/dist/agents/context.js

@@ -0,0 +1,144 @@
+/**
+ * Agent context preparation for delegation.
+ * @module agents/context
+ */
+/**
+ * Prepare context for agent delegation.
+ *
+ * This is called by the orchestrator BEFORE delegating to an agent.
+ * It retrieves relevant memories and formats them for the agent.
+ *
+ * @param client - HindsightClient instance
+ * @param bankId - Memory bank ID
+ * @param template - Agent template to use
+ * @param task - Task description for the agent
+ * @param options - Context preparation options
+ * @returns Agent context with memories and task
+ */
+export async function getAgentContext(client, bankId, template, task, options = {}) {
+    const { budget = "mid", additionalContext, maxMemories = 10 } = options;
+    // Recall memories relevant to the task
+    const recallOptions = {
+        budget,
+        factType: "all", // Agent benefits from all memory types
+        includeEntities: true,
+    };
+    let memories = [];
+    try {
+        memories = await client.recall(bankId, task, recallOptions);
+        // Limit to maxMemories
+        memories = memories.slice(0, maxMemories);
+    }
+    catch {
+        // If recall fails, proceed without memories
+        memories = [];
+    }
+    const result = {
+        template,
+        memories,
+        task,
+    };
+    if (additionalContext) {
+        result.additionalContext = additionalContext;
+    }
+    return result;
+}
+/**
+ * Format agent context as a prompt string.
+ *
+ * This creates the system prompt / context injection for the agent.
+ *
+ * @param context - Agent context to format
+ * @returns Formatted prompt string
+ */
+export function formatAgentPrompt(context) {
+    const { template, memories, task, additionalContext } = context;
+    const sections = [];
+    // Mission and identity
+    sections.push(`# Agent: ${template.name}`);
+    sections.push("");
+    sections.push("## Mission");
+    sections.push(template.mission);
+    sections.push("");
+    // Tools
+    sections.push("## Tools Available");
+    for (const tool of template.tools) {
+        sections.push(`- ${tool}`);
+    }
+    sections.push("");
+    // Constraints (emphasized)
+    sections.push("## Constraints (MUST FOLLOW)");
+    for (const constraint of template.constraints) {
+        sections.push(`- ${constraint}`);
+    }
+    sections.push("");
+    // Relevant context from memory (provided by orchestrator)
+    if (memories.length > 0) {
+        sections.push("## Relevant Project Context");
+        sections.push("The orchestrator has provided the following relevant memories:");
+        sections.push("");
+        for (const memory of memories) {
+            const prefix = getMemoryPrefix(memory);
+            sections.push(`- [${prefix}] ${memory.text}`);
+        }
+        sections.push("");
+    }
+    // Additional context from orchestrator
+    if (additionalContext) {
+        sections.push("## Additional Context");
+        sections.push(additionalContext);
+        sections.push("");
+    }
+    // The task
+    sections.push("## Your Task");
+    sections.push(task);
+    sections.push("");
+    // Expected output format
+    sections.push("## Expected Output Format");
+    sections.push(template.outputFormat);
+    sections.push("");
+    return sections.join("\n");
+}
+/**
+ * Get a human-readable prefix for a memory based on its type.
+ * @internal
+ */
+function getMemoryPrefix(memory) {
+    switch (memory.factType) {
+        case "experience":
+            return "Past experience";
+        case "opinion":
+            return `Opinion (${memory.confidence?.toFixed(2) ?? "?"})`;
+        case "observation":
+            return "Observation";
+        case "world":
+        default:
+            return "Fact";
+    }
+}
+/**
+ * Create a minimal context string for quick delegation.
+ *
+ * Useful when you don't need full memory retrieval.
+ *
+ * @param template - Agent template
+ * @param task - Task description
+ * @returns Minimal context string
+ */
+export function createMinimalContext(template, task) {
+    return `# Agent: ${template.name}
+
+## Mission
+${template.mission}
+
+## Constraints
+${template.constraints.map((c) => `- ${c}`).join("\n")}
+
+## Your Task
+${task}
+
+## Expected Output Format
+${template.outputFormat}
+`;
+}
+//# sourceMappingURL=context.js.map

package/dist/agents/context.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent templates module.
+ * @module agents
+ */
+export type { AgentTemplate, AgentContext, BuiltInAgentType, GetAgentContextOptions, } from "./types.js";
+export { CODE_EXPLORER_TEMPLATE, CODE_ARCHITECT_TEMPLATE, CODE_REVIEWER_TEMPLATE, BUILT_IN_TEMPLATES, getBuiltInTemplate, getAllBuiltInTemplates, isBuiltInAgent, } from "./templates.js";
+export { parseAgentMarkdown, loadCustomAgents, templateToMarkdown, } from "./loader.js";
+export { getAgentContext, formatAgentPrompt, createMinimalContext, } from "./context.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,11 @@
+/**
+ * Agent templates module.
+ * @module agents
+ */
+// Built-in templates
+export { CODE_EXPLORER_TEMPLATE, CODE_ARCHITECT_TEMPLATE, CODE_REVIEWER_TEMPLATE, BUILT_IN_TEMPLATES, getBuiltInTemplate, getAllBuiltInTemplates, isBuiltInAgent, } from "./templates.js";
+// Custom agent loading
+export { parseAgentMarkdown, loadCustomAgents, templateToMarkdown, } from "./loader.js";
+// Context preparation
+export { getAgentContext, formatAgentPrompt, createMinimalContext, } from "./context.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,sBAAsB;AACtB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/dist/agents/loader.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Custom agent template loading from .claude/agents/ directory.
+ * @module agents/loader
+ */
+import type { AgentTemplate } from "./types.js";
+/**
+ * Parse a markdown agent template file.
+ *
+ * Expected format:
+ * ```markdown
+ * # Agent: name
+ *
+ * ## Mission
+ * ...
+ *
+ * ## Tools Available
+ * - Tool 1
+ * - Tool 2
+ *
+ * ## Output Format
+ * ...
+ *
+ * ## Constraints
+ * - Constraint 1
+ * - Constraint 2
+ * ```
+ *
+ * @param content - Markdown file content
+ * @returns Parsed AgentTemplate, or null if parsing failed
+ */
+export declare function parseAgentMarkdown(content: string): AgentTemplate | null;
+/**
+ * Load custom agents from .claude/agents/ directory.
+ *
+ * @param projectPath - Project root directory
+ * @returns Array of custom agent templates
+ */
+export declare function loadCustomAgents(projectPath: string): Promise<AgentTemplate[]>;
+/**
+ * Generate markdown content from an agent template.
+ *
+ * Useful for creating template files programmatically.
+ *
+ * @param template - Agent template to convert
+ * @returns Markdown string
+ */
+export declare function templateToMarkdown(template: AgentTemplate): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/agents/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/agents/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsCxE;AAoBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CA8B1B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA+BlE"}