claude-cognitive 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,363 @@
+/**
+ * Type definitions for claude-cognitive Hindsight client.
+ * @module types
+ */
+/**
+ * Error codes for HindsightError.
+ * These match the codes documented in API.md.
+ */
+export declare const HindsightErrorCode: {
+    /** Cannot connect to Hindsight server */
+    readonly HINDSIGHT_UNAVAILABLE: "HINDSIGHT_UNAVAILABLE";
+    /** Request timed out */
+    readonly CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT";
+    /** Bank ID doesn't exist */
+    readonly BANK_NOT_FOUND: "BANK_NOT_FOUND";
+    /** Disposition values not 1-5 */
+    readonly INVALID_DISPOSITION: "INVALID_DISPOSITION";
+    /** Bad request or validation error */
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /** Rate limited by server */
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    /** Server error (5xx) */
+    readonly SERVER_ERROR: "SERVER_ERROR";
+    /** Unknown error */
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+export type HindsightErrorCode = (typeof HindsightErrorCode)[keyof typeof HindsightErrorCode];
+/** Valid trait values: 1 (low) to 5 (high) */
+export type TraitValue = 1 | 2 | 3 | 4 | 5;
+/**
+ * Bank personality traits that influence reflect() behavior.
+ * Each trait is a value from 1-5.
+ */
+export interface Disposition {
+    /** 1=trusting, 5=questions claims and looks for inconsistencies */
+    skepticism: TraitValue;
+    /** 1=flexible interpretation, 5=precise/literal */
+    literalism: TraitValue;
+    /** 1=fact-focused, 5=considers emotional context */
+    empathy: TraitValue;
+}
+/** Options for creating a new memory bank */
+export interface BankOptions {
+    /** Unique identifier for the bank */
+    bankId: string;
+    /** Personality traits for the bank */
+    disposition: Disposition;
+    /** Natural language background/identity description */
+    background?: string;
+}
+/** Memory bank information */
+export interface Bank {
+    /** Unique identifier */
+    bankId: string;
+    /** Personality traits */
+    disposition: Disposition;
+    /** Natural language background/identity */
+    background?: string;
+    /** When the bank was created (ISO 8601) */
+    createdAt: string;
+    /** Total number of memories stored */
+    memoryCount: number;
+}
+/** Memory classification types */
+export type FactType = "world" | "experience" | "opinion" | "observation";
+/** Entity types in the knowledge graph */
+export type EntityType = "person" | "component" | "file" | "concept";
+/** Co-occurrence relationship between entities */
+export interface CoOccurrence {
+    /** Related entity ID */
+    entityId: string;
+    /** Number of times entities appeared together */
+    count: number;
+}
+/** Entity in the knowledge graph */
+export interface Entity {
+    /** Unique entity identifier */
+    id: string;
+    /** Canonical entity name */
+    name: string;
+    /** Alternative names for this entity */
+    aliases: string[];
+    /** Entity classification */
+    type: EntityType;
+    /** Entities that frequently appear with this one */
+    coOccurrences: CoOccurrence[];
+}
+/**
+ * A memory unit stored in Hindsight.
+ * Contains the content, 5-dimension extraction, and metadata.
+ */
+export interface Memory {
+    /** Unique memory identifier */
+    id: string;
+    /** The actual memory content */
+    text: string;
+    /** Classification of the memory */
+    factType: FactType;
+    /** Optional context that was provided when storing */
+    context?: string;
+    /** Complete description of what happened */
+    what?: string;
+    /** Temporal context (dates, times, durations) */
+    when?: string;
+    /** Location context (files, paths, lines) */
+    where?: string;
+    /** Entities involved (people, components, concepts) */
+    who?: string[];
+    /** Motivation and reasoning */
+    why?: string;
+    /** When the memory was stored (ISO 8601) */
+    createdAt: string;
+    /** When the event started (if different from storage) */
+    occurredStart?: string;
+    /** When the event ended */
+    occurredEnd?: string;
+    /** Confidence score (0.0-1.0) for opinions */
+    confidence?: number;
+    /** Entities extracted from this memory */
+    entities?: Entity[];
+    /** Memory IDs this memory causes */
+    causes?: string[];
+    /** Memory IDs that caused this memory */
+    causedBy?: string[];
+    /** Memory IDs this memory enables */
+    enables?: string[];
+    /** Memory IDs this memory prevents */
+    prevents?: string[];
+}
+/** Search budget affecting thoroughness */
+export type RecallBudget = "low" | "mid" | "high";
+/** Filter options for recall() */
+export interface RecallOptions {
+    /**
+     * Search thoroughness:
+     * - low: ~2048 tokens, 1 graph hop
+     * - mid: ~4096 tokens, 2 graph hops (default)
+     * - high: ~8192 tokens, 3+ graph hops
+     */
+    budget?: RecallBudget;
+    /** Filter by memory type ('all' returns all types) */
+    factType?: FactType | "all";
+    /** Maximum tokens in response */
+    maxTokens?: number;
+    /** Include entity metadata in results */
+    includeEntities?: boolean;
+}
+/** An opinion formed through reflect() */
+export interface Opinion {
+    /** First-person opinion statement */
+    opinion: string;
+    /** Confidence score from 0.0 to 1.0 */
+    confidence: number;
+}
+/** Result from reflect() operation */
+export interface ReflectResult {
+    /** Natural language reasoned response */
+    text: string;
+    /** New opinions formed with confidence scores */
+    opinions: Opinion[];
+    /** Memories that informed the reflection */
+    basedOn: {
+        /** World facts used in reasoning */
+        world: Memory[];
+        /** Experiences used in reasoning */
+        experience: Memory[];
+        /** Prior opinions used in reasoning */
+        opinion: Memory[];
+    };
+}
+/** Health check response */
+export interface HealthStatus {
+    /** Whether Hindsight is healthy and reachable */
+    healthy: boolean;
+    /** Database connection status */
+    database?: string;
+    /** Error message if unhealthy */
+    error?: string;
+}
+/** Timeout configuration for different operations */
+export interface TimeoutConfig {
+    /** Default timeout for most operations (ms) */
+    default: number;
+    /** Timeout for health checks (ms) */
+    health: number;
+    /** Timeout for recall operations (ms) */
+    recall: number;
+    /** Timeout for reflect operations - LLM involved (ms) */
+    reflect: number;
+    /** Timeout for retain operations (ms) */
+    retain: number;
+}
+/** Options for HindsightClient constructor */
+export interface HindsightClientOptions {
+    /** Hindsight server hostname (default: 'localhost') */
+    host?: string;
+    /** Hindsight server port (default: 8888) */
+    port?: number;
+    /** Optional API key for authentication */
+    apiKey?: string;
+    /** Timeout configuration (all values in milliseconds) */
+    timeouts?: Partial<TimeoutConfig>;
+}
+/** Full configuration schema for claude-cognitive */
+export interface ClaudeMindConfig {
+    /** Hindsight server connection settings */
+    hindsight: {
+        host: string;
+        port: number;
+        apiKey?: string;
+        timeout?: number;
+    };
+    /** Memory bank identifier */
+    bankId?: string;
+    /** Bank disposition traits */
+    disposition?: Disposition;
+    /** Bank background/identity description */
+    background?: string;
+    /** Semantic memory file settings */
+    semantic?: {
+        path: string;
+    };
+}
+/** @internal Raw API response for entity */
+export interface EntityResponseDTO {
+    id: string;
+    name: string;
+    aliases: string[];
+    type: string;
+    co_occurrences: Array<{
+        entity_id: string;
+        count: number;
+    }>;
+}
+/** @internal Raw API response for memory */
+export interface MemoryResponseDTO {
+    id: string;
+    text: string;
+    fact_type: string;
+    context?: string;
+    what?: string;
+    when?: string;
+    where?: string;
+    who?: string[];
+    why?: string;
+    created_at: string;
+    occurred_start?: string;
+    occurred_end?: string;
+    confidence?: number;
+    entities?: EntityResponseDTO[];
+    causes?: string[];
+    caused_by?: string[];
+    enables?: string[];
+    prevents?: string[];
+}
+/** @internal Raw API response for bank */
+export interface BankResponseDTO {
+    bank_id: string;
+    disposition: Disposition;
+    background?: string;
+    created_at: string;
+    memory_count: number;
+}
+/** @internal Raw API response for retain */
+export interface RetainResponseDTO {
+    memory_ids: string[];
+}
+/** @internal Raw API response for recall */
+export interface RecallResponseDTO {
+    memories: MemoryResponseDTO[];
+}
+/** @internal Raw API response for reflect */
+export interface ReflectResponseDTO {
+    text: string;
+    opinions: Array<{
+        opinion: string;
+        confidence: number;
+    }>;
+    based_on: {
+        world: MemoryResponseDTO[];
+        experience: MemoryResponseDTO[];
+        opinion: MemoryResponseDTO[];
+    };
+}
+/** @internal Raw API response for health */
+export interface HealthResponseDTO {
+    healthy: boolean;
+    version: string;
+    bank_count: number;
+}
+/**
+ * Options for Mind constructor.
+ */
+export interface MindOptions {
+    /** Project root directory (default: process.cwd()) */
+    projectPath?: string;
+    /** Memory bank identifier (default: derived from project name) */
+    bankId?: string;
+    /** Hindsight server host */
+    host?: string;
+    /** Hindsight server port */
+    port?: number;
+    /** API key for Hindsight */
+    apiKey?: string;
+    /** Bank disposition traits */
+    disposition?: Disposition;
+    /** Bank background/identity description */
+    background?: string;
+    /** Path to semantic memory file */
+    semanticPath?: string;
+}
+/** Depth levels for learn() operation */
+export type LearnDepth = "quick" | "standard" | "full";
+/**
+ * Options for the learn() operation.
+ */
+export interface LearnOptions {
+    /**
+     * Analysis depth:
+     * - quick: README, package.json, directory structure (~10-30s)
+     * - standard: + key source files, git history (last 50 commits) (~1-5min)
+     * - full: + all source files, full git history, dependency analysis (~5-15min)
+     */
+    depth?: LearnDepth;
+    /** Whether to analyze git history (default: true) */
+    includeGitHistory?: boolean;
+    /** Maximum commits to analyze (default: 100) */
+    maxCommits?: number;
+    /** Whether to analyze dependencies (default: true) */
+    includeDependencies?: boolean;
+}
+/**
+ * Result from the learn() operation.
+ */
+export interface LearnResult {
+    /** Human-readable summary of what was learned */
+    summary: string;
+    /** Number of world facts stored */
+    worldFacts: number;
+    /** Initial opinions formed with confidence scores */
+    opinions: Opinion[];
+    /** Entities discovered in the codebase */
+    entities: Entity[];
+    /** Number of files analyzed */
+    filesAnalyzed: number;
+    /** Total duration in milliseconds */
+    duration: number;
+}
+/** Categories for extracted facts */
+export type FactCategory = "structure" | "stack" | "patterns" | "history" | "decisions";
+/**
+ * A fact extracted from codebase analysis.
+ * @internal Used by learn() operation.
+ */
+export interface ExtractedFact {
+    /** The fact content to store */
+    content: string;
+    /** Context about where this fact came from */
+    context: string;
+    /** Category for organization */
+    category: FactCategory;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,30 @@
+/**
+ * Type definitions for claude-cognitive Hindsight client.
+ * @module types
+ */
+// ============================================
+// Error Codes
+// ============================================
+/**
+ * Error codes for HindsightError.
+ * These match the codes documented in API.md.
+ */
+export const HindsightErrorCode = {
+    /** Cannot connect to Hindsight server */
+    HINDSIGHT_UNAVAILABLE: "HINDSIGHT_UNAVAILABLE",
+    /** Request timed out */
+    CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT",
+    /** Bank ID doesn't exist */
+    BANK_NOT_FOUND: "BANK_NOT_FOUND",
+    /** Disposition values not 1-5 */
+    INVALID_DISPOSITION: "INVALID_DISPOSITION",
+    /** Bad request or validation error */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** Rate limited by server */
+    RATE_LIMITED: "RATE_LIMITED",
+    /** Server error (5xx) */
+    SERVER_ERROR: "SERVER_ERROR",
+    /** Unknown error */
+    UNKNOWN_ERROR: "UNKNOWN_ERROR",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,yCAAyC;IACzC,qBAAqB,EAAE,uBAAuB;IAC9C,wBAAwB;IACxB,kBAAkB,EAAE,oBAAoB;IACxC,4BAA4B;IAC5B,cAAc,EAAE,gBAAgB;IAChC,iCAAiC;IACjC,mBAAmB,EAAE,qBAAqB;IAC1C,sCAAsC;IACtC,gBAAgB,EAAE,kBAAkB;IACpC,6BAA6B;IAC7B,YAAY,EAAE,cAAc;IAC5B,yBAAyB;IACzB,YAAY,EAAE,cAAc;IAC5B,oBAAoB;IACpB,aAAa,EAAE,eAAe;CACtB,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "claude-cognitive",
+  "version": "0.1.0",
+  "description": "Human-inspired memory system for Claude. LLM thinks. Hindsight remembers. Together = mind.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "claude-cognitive": "./bin/claude-cognitive.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "cognitive",
+    "memory",
+    "hindsight",
+    "ai",
+    "llm",
+    "context",
+    "persistence"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/csfet9/claude-cognitive"
+  },
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:e2e": "vitest run tests/e2e --testTimeout=60000",
+    "bench": "npx tsx tests/perf/mind.bench.ts",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "cac": "^6.7.14",
+    "express": "^4.21.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "prettier": "^3.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.16"
+  }
+}