claude-cognitive 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Event system for claude-cognitive Mind class.
+ * @module events
+ */
+import { EventEmitter } from "node:events";
+import type { Memory, Opinion } from "./types.js";
+/**
+ * Observation that may be promoted to semantic memory.
+ */
+export interface Observation {
+    /** The observation text */
+    text: string;
+    /** Confidence score from 0.0 to 1.0 */
+    confidence: number;
+    /** Source identifier (e.g., session ID, reflect query) */
+    source: string;
+}
+/**
+ * Event map defining all Mind events and their payload types.
+ *
+ * Each event is defined as a tuple of arguments that will be passed
+ * to listeners when the event is emitted.
+ */
+export interface MindEventMap {
+    /** Emitted when Mind is initialized and ready */
+    ready: [];
+    /** Emitted when memories are recalled */
+    "memory:recalled": [memories: Memory[]];
+    /** Emitted when content is retained */
+    "memory:retained": [content: string];
+    /** Emitted when an opinion is formed via reflect() */
+    "opinion:formed": [opinion: Opinion];
+    /** Emitted when an observation is promoted to semantic memory */
+    "observation:promoted": [observation: Observation];
+    /** Emitted when degraded mode is entered or exited */
+    "degraded:change": [degraded: boolean];
+    /** Emitted when learn() operation starts */
+    "learn:start": [options: {
+        depth: string;
+    }];
+    /** Emitted when learn() operation completes */
+    "learn:complete": [result: {
+        summary: string;
+        worldFacts: number;
+    }];
+    /** Emitted when agent context is prepared for delegation */
+    "agent:context-prepared": [info: {
+        agent: string;
+        task: string;
+    }];
+    /** Emitted on errors (non-fatal, allows continued operation) */
+    error: [error: Error];
+}
+/**
+ * Event names as a union type.
+ */
+export type MindEventName = keyof MindEventMap;
+/**
+ * Type-safe EventEmitter for Mind class.
+ *
+ * Provides compile-time checking for event names and listener signatures.
+ * Extends the native Node.js EventEmitter with typed methods.
+ *
+ * @example
+ * ```typescript
+ * const emitter = new TypedEventEmitter();
+ *
+ * // Type-safe listener - compiler knows memories is Memory[]
+ * emitter.on('memory:recalled', (memories) => {
+ *   console.log(`Recalled ${memories.length} memories`);
+ * });
+ *
+ * // Type-safe emit - compiler checks argument types
+ * emitter.emit('memory:recalled', [{ id: '1', text: 'test', factType: 'world' }]);
+ *
+ * // Compile error: wrong event name
+ * emitter.on('invalid-event', () => {}); // Error!
+ *
+ * // Compile error: wrong argument type
+ * emitter.emit('memory:recalled', 'not an array'); // Error!
+ * ```
+ */
+export declare class TypedEventEmitter extends EventEmitter {
+    /**
+     * Add a listener for the specified event.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    on<K extends MindEventName>(event: K, listener: (...args: MindEventMap[K]) => void): this;
+    /**
+     * Add a one-time listener for the specified event.
+     * The listener is removed after the first invocation.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    once<K extends MindEventName>(event: K, listener: (...args: MindEventMap[K]) => void): this;
+    /**
+     * Remove a listener for the specified event.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function to remove
+     * @returns This emitter for chaining
+     */
+    off<K extends MindEventName>(event: K, listener: (...args: MindEventMap[K]) => void): this;
+    /**
+     * Emit an event with type-safe arguments.
+     *
+     * @param event - Event name
+     * @param args - Event arguments (type-checked against MindEventMap)
+     * @returns True if the event had listeners, false otherwise
+     */
+    emit<K extends MindEventName>(event: K, ...args: MindEventMap[K]): boolean;
+    /**
+     * Add a listener to the beginning of the listeners array.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    prependListener<K extends MindEventName>(event: K, listener: (...args: MindEventMap[K]) => void): this;
+    /**
+     * Add a one-time listener to the beginning of the listeners array.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    prependOnceListener<K extends MindEventName>(event: K, listener: (...args: MindEventMap[K]) => void): this;
+    /**
+     * Remove all listeners for the specified event, or all events if none specified.
+     *
+     * @param event - Optional event name
+     * @returns This emitter for chaining
+     */
+    removeAllListeners(event?: MindEventName): this;
+    /**
+     * Get the number of listeners for the specified event.
+     *
+     * @param event - Event name
+     * @returns Number of listeners
+     */
+    listenerCount(event: MindEventName): number;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,115 @@
+/**
+ * Event system for claude-cognitive Mind class.
+ * @module events
+ */
+import { EventEmitter } from "node:events";
+// ============================================
+// Typed EventEmitter
+// ============================================
+/**
+ * Type-safe EventEmitter for Mind class.
+ *
+ * Provides compile-time checking for event names and listener signatures.
+ * Extends the native Node.js EventEmitter with typed methods.
+ *
+ * @example
+ * ```typescript
+ * const emitter = new TypedEventEmitter();
+ *
+ * // Type-safe listener - compiler knows memories is Memory[]
+ * emitter.on('memory:recalled', (memories) => {
+ *   console.log(`Recalled ${memories.length} memories`);
+ * });
+ *
+ * // Type-safe emit - compiler checks argument types
+ * emitter.emit('memory:recalled', [{ id: '1', text: 'test', factType: 'world' }]);
+ *
+ * // Compile error: wrong event name
+ * emitter.on('invalid-event', () => {}); // Error!
+ *
+ * // Compile error: wrong argument type
+ * emitter.emit('memory:recalled', 'not an array'); // Error!
+ * ```
+ */
+export class TypedEventEmitter extends EventEmitter {
+    /**
+     * Add a listener for the specified event.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    /**
+     * Add a one-time listener for the specified event.
+     * The listener is removed after the first invocation.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    /**
+     * Remove a listener for the specified event.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function to remove
+     * @returns This emitter for chaining
+     */
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    /**
+     * Emit an event with type-safe arguments.
+     *
+     * @param event - Event name
+     * @param args - Event arguments (type-checked against MindEventMap)
+     * @returns True if the event had listeners, false otherwise
+     */
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    /**
+     * Add a listener to the beginning of the listeners array.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    prependListener(event, listener) {
+        return super.prependListener(event, listener);
+    }
+    /**
+     * Add a one-time listener to the beginning of the listeners array.
+     *
+     * @param event - Event name
+     * @param listener - Event handler function
+     * @returns This emitter for chaining
+     */
+    prependOnceListener(event, listener) {
+        return super.prependOnceListener(event, listener);
+    }
+    /**
+     * Remove all listeners for the specified event, or all events if none specified.
+     *
+     * @param event - Optional event name
+     * @returns This emitter for chaining
+     */
+    removeAllListeners(event) {
+        return super.removeAllListeners(event);
+    }
+    /**
+     * Get the number of listeners for the specified event.
+     *
+     * @param event - Event name
+     * @returns Number of listeners
+     */
+    listenerCount(event) {
+        return super.listenerCount(event);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8D3C,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD;;;;;;OAMG;IACH,EAAE,CACA,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CACD,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAA0B,KAAQ,EAAE,GAAG,IAAqB;QAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CACb,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,eAAe,CAC1B,KAAK,EACL,QAAwC,CACzC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CACjB,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,mBAAmB,CAC9B,KAAK,EACL,QAAwC,CACzC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,KAAqB;QACtC,OAAO,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,KAAoB;QAChC,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Claude Code hook exports.
+ * @module hooks
+ */
+export { registerInjectContextCommand } from "./inject-context.js";
+export { registerProcessSessionCommand } from "./process-session.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,7 @@
+/**
+ * Claude Code hook exports.
+ * @module hooks
+ */
+export { registerInjectContextCommand } from "./inject-context.js";
+export { registerProcessSessionCommand } from "./process-session.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/inject-context.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Session start hook - inject context into Claude Code session.
+ * @module hooks/inject-context
+ */
+import type { CAC } from "cac";
+/**
+ * Register the inject-context hook command.
+ *
+ * This command is called by Claude Code at session start.
+ * It outputs context to stdout for injection into the session.
+ *
+ * IMPORTANT: This command must:
+ * - Execute quickly (<500ms budget)
+ * - Output context to stdout
+ * - NEVER fail (always exit 0)
+ */
+export declare function registerInjectContextCommand(cli: CAC): void;
+//# sourceMappingURL=inject-context.d.ts.map

package/dist/hooks/inject-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-context.d.ts","sourceRoot":"","sources":["../../src/hooks/inject-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AA+B/B;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAkC3D"}

package/dist/hooks/inject-context.js

@@ -0,0 +1,57 @@
+/**
+ * Session start hook - inject context into Claude Code session.
+ * @module hooks/inject-context
+ */
+import { Mind } from "../mind.js";
+/** Default initialization timeout in milliseconds */
+const DEFAULT_TIMEOUT = 3000;
+/**
+ * Initialize Mind with a timeout to ensure fast execution.
+ */
+async function initWithTimeout(projectPath, timeout) {
+    const mind = new Mind({ projectPath });
+    const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => reject(new Error("Mind initialization timed out")), timeout);
+    });
+    await Promise.race([mind.init(), timeoutPromise]);
+    return mind;
+}
+/**
+ * Register the inject-context hook command.
+ *
+ * This command is called by Claude Code at session start.
+ * It outputs context to stdout for injection into the session.
+ *
+ * IMPORTANT: This command must:
+ * - Execute quickly (<500ms budget)
+ * - Output context to stdout
+ * - NEVER fail (always exit 0)
+ */
+export function registerInjectContextCommand(cli) {
+    cli
+        .command("inject-context", "Inject context at session start (hook)")
+        .option("--project <path>", "Project directory (default: current directory)")
+        .option("--timeout <ms>", "Initialization timeout in ms (default: 3000)")
+        .action(async (options) => {
+        const projectPath = options.project ?? process.cwd();
+        const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        try {
+            // Initialize Mind with timeout
+            const mind = await initWithTimeout(projectPath, timeout);
+            // Get session context
+            const context = await mind.onSessionStart();
+            // Output context to stdout
+            if (context.trim().length > 0) {
+                console.log(context);
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            // Log error to stderr but exit successfully
+            console.error(`inject-context warning: ${error instanceof Error ? error.message : error}`);
+            // Output empty string (session continues without context)
+            process.exit(0);
+        }
+    });
+}
+//# sourceMappingURL=inject-context.js.map

package/dist/hooks/inject-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-context.js","sourceRoot":"","sources":["../../src/hooks/inject-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOlC,qDAAqD;AACrD,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,WAAmB,EACnB,OAAe;IAEf,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAEvC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,UAAU,CACR,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,EACxD,OAAO,CACR,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAQ;IACnD,GAAG;SACA,OAAO,CAAC,gBAAgB,EAAE,wCAAwC,CAAC;SACnE,MAAM,CACL,kBAAkB,EAClB,gDAAgD,CACjD;SACA,MAAM,CAAC,gBAAgB,EAAE,8CAA8C,CAAC;SACxE,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;QAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC;QAEnD,IAAI,CAAC;YACH,+BAA+B;YAC/B,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEzD,sBAAsB;YACtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAE5C,2BAA2B;YAC3B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CACX,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAC5E,CAAC;YACF,0DAA0D;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/hooks/process-session.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Session end hook - process transcript and extract memories.
+ * @module hooks/process-session
+ */
+import type { CAC } from "cac";
+/**
+ * Register the process-session hook command.
+ *
+ * This command is called by Claude Code at session end.
+ * It processes the session transcript and extracts memories.
+ *
+ * IMPORTANT: This command must:
+ * - Accept transcript from file or stdin
+ * - Log to stderr only
+ * - NEVER fail (always exit 0)
+ */
+export declare function registerProcessSessionCommand(cli: CAC): void;
+//# sourceMappingURL=process-session.d.ts.map

package/dist/hooks/process-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-session.d.ts","sourceRoot":"","sources":["../../src/hooks/process-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AA8D/B;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAyD5D"}

package/dist/hooks/process-session.js

@@ -0,0 +1,119 @@
+/**
+ * Session end hook - process transcript and extract memories.
+ * @module hooks/process-session
+ */
+import { readFile } from "node:fs/promises";
+import { createInterface } from "node:readline";
+import { Mind } from "../mind.js";
+/**
+ * Read transcript from file or stdin.
+ */
+async function readTranscript(filePath) {
+    // If file path provided, read from file
+    if (filePath) {
+        try {
+            return await readFile(filePath, "utf-8");
+        }
+        catch (error) {
+            console.error(`Warning: Could not read transcript file: ${error instanceof Error ? error.message : error}`);
+            return null;
+        }
+    }
+    // Otherwise, try to read from stdin if it's not a TTY
+    if (process.stdin.isTTY) {
+        return null;
+    }
+    return new Promise((resolve) => {
+        const chunks = [];
+        const rl = createInterface({
+            input: process.stdin,
+            terminal: false,
+        });
+        rl.on("line", (line) => {
+            chunks.push(line);
+        });
+        rl.on("close", () => {
+            resolve(chunks.join("\n"));
+        });
+        // Timeout after 5 seconds if no input
+        setTimeout(() => {
+            rl.close();
+            resolve(chunks.join("\n"));
+        }, 5000);
+    });
+}
+/**
+ * Register the process-session hook command.
+ *
+ * This command is called by Claude Code at session end.
+ * It processes the session transcript and extracts memories.
+ *
+ * IMPORTANT: This command must:
+ * - Accept transcript from file or stdin
+ * - Log to stderr only
+ * - NEVER fail (always exit 0)
+ */
+export function registerProcessSessionCommand(cli) {
+    cli
+        .command("process-session", "Process session transcript (hook)")
+        .option("--project <path>", "Project directory (default: current directory)")
+        .option("--transcript <path>", "Path to transcript file")
+        .option("--json", "Output result as JSON")
+        .action(async (options) => {
+        const projectPath = options.project ?? process.cwd();
+        const result = {
+            processed: false,
+            transcriptLength: 0,
+            opinionsFormed: 0,
+        };
+        try {
+            // Read transcript
+            const transcript = await readTranscript(options.transcript);
+            if (!transcript || transcript.trim().length === 0) {
+                result.error = "No transcript provided";
+                outputResult(result, options.json);
+                process.exit(0);
+                return;
+            }
+            result.transcriptLength = transcript.length;
+            // Initialize Mind
+            const mind = new Mind({ projectPath });
+            await mind.init();
+            if (mind.isDegraded) {
+                result.error = "Hindsight unavailable (degraded mode)";
+                outputResult(result, options.json);
+                process.exit(0);
+                return;
+            }
+            // Process session end
+            const reflectResult = await mind.onSessionEnd(transcript);
+            result.processed = true;
+            result.opinionsFormed = reflectResult?.opinions.length ?? 0;
+            outputResult(result, options.json);
+            process.exit(0);
+        }
+        catch (error) {
+            result.error = error instanceof Error ? error.message : String(error);
+            outputResult(result, options.json);
+            // Always exit 0 to not break Claude Code
+            process.exit(0);
+        }
+    });
+}
+/**
+ * Output result to stderr (or stdout for JSON mode).
+ */
+function outputResult(result, json) {
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        if (result.error) {
+            console.error(`process-session: ${result.error}`);
+        }
+        else if (result.processed) {
+            console.error(`process-session: Processed ${result.transcriptLength} chars, formed ${result.opinionsFormed} opinions`);
+        }
+    }
+}
+//# sourceMappingURL=process-session.js.map

package/dist/hooks/process-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-session.js","sourceRoot":"","sources":["../../src/hooks/process-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAelC;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,QAA4B;IAE5B,wCAAwC;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAC7F,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,eAAe,CAAC;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,sCAAsC;QACtC,UAAU,CAAC,GAAG,EAAE;YACd,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAQ;IACpD,GAAG;SACA,OAAO,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;SAC/D,MAAM,CACL,kBAAkB,EAClB,gDAAgD,CACjD;SACA,MAAM,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,OAA8B,EAAE,EAAE;QAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAErD,MAAM,MAAM,GAAkB;YAC5B,SAAS,EAAE,KAAK;YAChB,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;SAClB,CAAC;QAEF,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE5D,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,CAAC,KAAK,GAAG,wBAAwB,CAAC;gBACxC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,MAAM,CAAC,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC;YAE5C,kBAAkB;YAClB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAElB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,GAAG,uCAAuC,CAAC;gBACvD,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,sBAAsB;YACtB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAE1D,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,cAAc,GAAG,aAAa,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;YAE5D,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,yCAAyC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,MAAqB,EAAE,IAAc;IACzD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CACX,8BAA8B,MAAM,CAAC,gBAAgB,kBAAkB,MAAM,CAAC,cAAc,WAAW,CACxG,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * claude-cognitive - Memory integration layer for Claude Code with Hindsight.
+ *
+ * LLM thinks. Hindsight remembers. Together = mind.
+ *
+ * @example
+ * ```typescript
+ * import { HindsightClient, loadConfig } from 'claude-cognitive';
+ *
+ * // Load configuration from .claudemindrc or defaults
+ * const config = await loadConfig();
+ *
+ * // Create client
+ * const client = new HindsightClient({
+ *   host: config.hindsight.host,
+ *   port: config.hindsight.port,
+ * });
+ *
+ * // Check health
+ * const health = await client.health();
+ * if (health.healthy) {
+ *   // Store a memory
+ *   await client.retain('my-project', 'Fixed the auth bug');
+ *
+ *   // Search memories
+ *   const memories = await client.recall('my-project', 'authentication');
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { HindsightClient } from "./client.js";
+export { Mind } from "./mind.js";
+export { TypedEventEmitter } from "./events.js";
+export type { MindEventMap, MindEventName, Observation } from "./events.js";
+export { SemanticMemory, DEFAULT_TEMPLATE } from "./semantic.js";
+export type { SemanticMemoryOptions, ParseResult } from "./semantic.js";
+export { PromotionManager, DEFAULT_PROMOTION_THRESHOLD, opinionToObservation, shouldPromote, } from "./promotion.js";
+export type { PromotionOptions, PromotionResult } from "./promotion.js";
+export { learn } from "./learn/index.js";
+export { BUILT_IN_TEMPLATES, getBuiltInTemplate, getAllBuiltInTemplates, isBuiltInAgent, } from "./agents/index.js";
+export { loadCustomAgents, parseAgentMarkdown } from "./agents/index.js";
+export { getAgentContext, formatAgentPrompt } from "./agents/index.js";
+export { loadConfig, getDefaultConfig } from "./config.js";
+export { HindsightError } from "./errors.js";
+export { withRetry, createRetryable } from "./retry.js";
+export type { RetryOptions } from "./retry.js";
+export type { HindsightClientOptions, TimeoutConfig, ClaudeMindConfig, } from "./types.js";
+export type { Disposition, TraitValue } from "./types.js";
+export type { BankOptions, Bank } from "./types.js";
+export type { Memory, FactType, Entity, EntityType, CoOccurrence, } from "./types.js";
+export type { RecallOptions, RecallBudget } from "./types.js";
+export type { ReflectResult, Opinion } from "./types.js";
+export type { HealthStatus } from "./types.js";
+export { HindsightErrorCode } from "./types.js";
+export type { HindsightErrorCode as HindsightErrorCodeType } from "./types.js";
+export type { MindOptions } from "./types.js";
+export type { LearnOptions, LearnResult, LearnDepth, ExtractedFact } from "./types.js";
+export type { AgentTemplate, AgentContext, BuiltInAgentType, GetAgentContextOptions, } from "./agents/index.js";
+export { ClaudeMindMcpServer, createMcpServer } from "./mcp/index.js";
+export { TOOL_DEFINITIONS } from "./mcp/index.js";
+export type { McpServerOptions, McpTransportType, HttpTransportConfig, ToolResult, } from "./mcp/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGxE,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGpD,YAAY,EACV,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGzD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG/E,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvF,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,59 @@
+/**
+ * claude-cognitive - Memory integration layer for Claude Code with Hindsight.
+ *
+ * LLM thinks. Hindsight remembers. Together = mind.
+ *
+ * @example
+ * ```typescript
+ * import { HindsightClient, loadConfig } from 'claude-cognitive';
+ *
+ * // Load configuration from .claudemindrc or defaults
+ * const config = await loadConfig();
+ *
+ * // Create client
+ * const client = new HindsightClient({
+ *   host: config.hindsight.host,
+ *   port: config.hindsight.port,
+ * });
+ *
+ * // Check health
+ * const health = await client.health();
+ * if (health.healthy) {
+ *   // Store a memory
+ *   await client.retain('my-project', 'Fixed the auth bug');
+ *
+ *   // Search memories
+ *   const memories = await client.recall('my-project', 'authentication');
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Main client
+export { HindsightClient } from "./client.js";
+// Mind orchestrator
+export { Mind } from "./mind.js";
+// Event system
+export { TypedEventEmitter } from "./events.js";
+// Semantic memory
+export { SemanticMemory, DEFAULT_TEMPLATE } from "./semantic.js";
+// Promotion
+export { PromotionManager, DEFAULT_PROMOTION_THRESHOLD, opinionToObservation, shouldPromote, } from "./promotion.js";
+// Learn operation
+export { learn } from "./learn/index.js";
+// Agent templates
+export { BUILT_IN_TEMPLATES, getBuiltInTemplate, getAllBuiltInTemplates, isBuiltInAgent, } from "./agents/index.js";
+export { loadCustomAgents, parseAgentMarkdown } from "./agents/index.js";
+export { getAgentContext, formatAgentPrompt } from "./agents/index.js";
+// Configuration
+export { loadConfig, getDefaultConfig } from "./config.js";
+// Error handling
+export { HindsightError } from "./errors.js";
+// Retry utilities
+export { withRetry, createRetryable } from "./retry.js";
+// Types - Error codes
+export { HindsightErrorCode } from "./types.js";
+// MCP Server
+export { ClaudeMindMcpServer, createMcpServer } from "./mcp/index.js";
+export { TOOL_DEFINITIONS } from "./mcp/index.js";
+//# sourceMappingURL=index.js.map