claude-cognitive 0.1.0

package/dist/client.js

@@ -0,0 +1,447 @@
+/**
+ * HindsightClient - TypeScript client for the Hindsight memory API.
+ * @module client
+ */
+import { HindsightError, createErrorFromResponse, createErrorFromNetworkFailure, } from "./errors.js";
+/**
+ * Default timeout configuration (milliseconds).
+ */
+const DEFAULT_TIMEOUTS = {
+    default: 10_000, // 10 seconds
+    health: 3_000, // 3 seconds - quick check
+    recall: 15_000, // 15 seconds - 4-way search
+    reflect: 30_000, // 30 seconds - involves LLM
+    retain: 10_000, // 10 seconds - write operation
+};
+/**
+ * HindsightClient provides a TypeScript interface to the Hindsight memory API.
+ *
+ * @example
+ * ```typescript
+ * const client = new HindsightClient({
+ *   host: 'localhost',
+ *   port: 8888,
+ * });
+ *
+ * // Check health
+ * const health = await client.health();
+ * if (!health.healthy) {
+ *   console.error('Hindsight unavailable');
+ * }
+ *
+ * // Create a bank
+ * await client.createBank({
+ *   bankId: 'my-project',
+ *   disposition: { skepticism: 4, literalism: 4, empathy: 2 },
+ *   background: 'Developer assistant for a React app',
+ * });
+ *
+ * // Store a memory
+ * await client.retain(
+ *   'my-project',
+ *   'Fixed auth redirect by moving AuthProvider to root',
+ *   'User was experiencing infinite redirects'
+ * );
+ *
+ * // Recall memories
+ * const memories = await client.recall('my-project', 'authentication issues');
+ *
+ * // Reflect and form opinions
+ * const reflection = await client.reflect('my-project', 'What patterns have I noticed?');
+ * ```
+ */
+export class HindsightClient {
+    baseUrl;
+    apiKey;
+    timeouts;
+    /**
+     * Create a new HindsightClient.
+     *
+     * @param options - Client configuration options
+     */
+    constructor(options = {}) {
+        const host = options.host ?? "localhost";
+        const port = options.port ?? 8888;
+        this.baseUrl = `http://${host}:${port}`;
+        if (options.apiKey !== undefined) {
+            this.apiKey = options.apiKey;
+        }
+        this.timeouts = { ...DEFAULT_TIMEOUTS, ...options.timeouts };
+    }
+    // ============================================
+    // Bank Management
+    // ============================================
+    /**
+     * Create a new memory bank with disposition.
+     *
+     * @param options - Bank creation options
+     * @throws {HindsightError} If bank already exists or disposition is invalid
+     */
+    async createBank(options) {
+        this.validateDisposition(options.disposition);
+        await this.request("PUT", `/v1/default/banks/${encodeURIComponent(options.bankId)}`, {
+            body: {
+                name: options.bankId,
+                disposition: options.disposition,
+                background: options.background ?? "",
+            },
+        });
+    }
+    /**
+     * Get bank information.
+     *
+     * @param bankId - Bank identifier
+     * @returns Bank information
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async getBank(bankId) {
+        // List all banks and find the one we want
+        const response = await this.request("GET", "/v1/default/banks");
+        const bank = response.banks.find((b) => b.bank_id === bankId);
+        if (!bank) {
+            throw new HindsightError(`Bank not found: ${bankId}`, "BANK_NOT_FOUND", {
+                isRetryable: false,
+            });
+        }
+        return this.mapBankResponse(bank);
+    }
+    /**
+     * Update bank disposition traits.
+     *
+     * @param bankId - Bank identifier
+     * @param disposition - New disposition values
+     * @throws {HindsightError} If bank doesn't exist or disposition is invalid
+     */
+    async updateDisposition(bankId, disposition) {
+        this.validateDisposition(disposition);
+        await this.request("PUT", `/v1/default/banks/${encodeURIComponent(bankId)}/profile`, { body: { disposition } });
+    }
+    /**
+     * Update bank settings (background and/or disposition).
+     *
+     * @param bankId - Bank identifier
+     * @param updates - Fields to update
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async updateBank(bankId, updates) {
+        const body = {};
+        if (updates.background !== undefined) {
+            body.background = updates.background;
+        }
+        if (updates.disposition) {
+            body.disposition = updates.disposition;
+        }
+        // Use PUT to update bank (Hindsight doesn't support PATCH)
+        // First get current bank to merge with updates
+        const current = await this.getBank(bankId);
+        const mergedBody = {
+            name: bankId,
+            disposition: {
+                ...current.disposition,
+                ...(updates.disposition ?? {}),
+            },
+            background: updates.background ?? current.background ?? "",
+        };
+        await this.request("PUT", `/v1/default/banks/${encodeURIComponent(bankId)}`, { body: mergedBody });
+    }
+    /**
+     * Delete a memory bank and all its memories.
+     *
+     * @param bankId - Bank identifier
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async deleteBank(bankId) {
+        await this.request("DELETE", `/v1/default/banks/${encodeURIComponent(bankId)}`);
+    }
+    // ============================================
+    // Core Operations
+    // ============================================
+    /**
+     * Store content with automatic extraction.
+     *
+     * Hindsight automatically extracts entities, relationships, and metadata.
+     *
+     * @param bankId - Bank identifier
+     * @param content - Content to store
+     * @param context - Optional additional context
+     * @returns Number of items processed
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async retain(bankId, content, context) {
+        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(bankId)}/memories`, {
+            body: {
+                items: [{ content, context }],
+                async: false,
+            },
+            timeout: this.timeouts.retain,
+        });
+        return response.items_count;
+    }
+    /**
+     * Search memories using 4-way parallel retrieval.
+     *
+     * Uses four search strategies in parallel:
+     * - Semantic: Vector similarity for conceptual matches
+     * - BM25: Full-text keyword search for exact terms
+     * - Graph: Entity traversal for indirect relationships
+     * - Temporal: Time-range + semantic for historical queries
+     *
+     * Results are fused using Reciprocal Rank Fusion (RRF),
+     * then reranked with a neural cross-encoder.
+     *
+     * @param bankId - Bank identifier
+     * @param query - Search query
+     * @param options - Search options
+     * @returns Ranked list of matching memories
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async recall(bankId, query, options = {}) {
+        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(bankId)}/memories/recall`, {
+            body: {
+                query,
+                budget: options.budget ?? "mid",
+                type: options.factType !== "all" ? options.factType : undefined,
+                max_tokens: options.maxTokens,
+            },
+            timeout: this.timeouts.recall,
+        });
+        return response.results.map((r) => {
+            const mem = {
+                id: r.id,
+                text: r.text,
+                factType: r.type ?? "world",
+                createdAt: r.mentioned_at ?? new Date().toISOString(),
+            };
+            if (r.context)
+                mem.context = r.context;
+            if (r.occurred_start)
+                mem.occurredStart = r.occurred_start;
+            if (r.occurred_end)
+                mem.occurredEnd = r.occurred_end;
+            return mem;
+        });
+    }
+    /**
+     * Reason about accumulated knowledge through disposition lens.
+     *
+     * Process:
+     * 1. Recalls relevant memories (world, experience, opinion)
+     * 2. Loads bank disposition (skepticism, literalism, empathy)
+     * 3. LLM reasons through disposition lens
+     * 4. Extracts new opinions with confidence scores
+     * 5. Stores opinions asynchronously (influences future reflects)
+     * 6. Returns reasoned response with citations
+     *
+     * @param bankId - Bank identifier
+     * @param query - What to think about or reason through
+     * @param context - Optional additional context
+     * @returns Reflection result with text, opinions, and citations
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async reflect(bankId, query, context) {
+        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(bankId)}/reflect`, {
+            body: { query, context },
+            timeout: this.timeouts.reflect,
+        });
+        // Map the simpler API response to our ReflectResult structure
+        const basedOn = response.based_on ?? [];
+        return {
+            text: response.text,
+            opinions: [], // API doesn't return opinions separately
+            basedOn: {
+                world: basedOn
+                    .filter((f) => f.type === "world")
+                    .map((f) => ({
+                    id: f.id,
+                    text: f.text,
+                    factType: "world",
+                    createdAt: new Date().toISOString(),
+                })),
+                experience: basedOn
+                    .filter((f) => f.type === "experience")
+                    .map((f) => ({
+                    id: f.id,
+                    text: f.text,
+                    factType: "experience",
+                    createdAt: new Date().toISOString(),
+                })),
+                opinion: basedOn
+                    .filter((f) => f.type === "opinion")
+                    .map((f) => ({
+                    id: f.id,
+                    text: f.text,
+                    factType: "opinion",
+                    createdAt: new Date().toISOString(),
+                })),
+            },
+        };
+    }
+    // ============================================
+    // Utilities
+    // ============================================
+    /**
+     * Check Hindsight connection health.
+     *
+     * Unlike other methods, this returns a status object instead of
+     * throwing on failure. This makes it safe to use for health checks.
+     *
+     * @returns Health status
+     */
+    async health() {
+        try {
+            const response = await this.request("GET", "/health", {
+                timeout: this.timeouts.health,
+            });
+            return {
+                healthy: response.status === "healthy",
+                database: response.database,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            return {
+                healthy: false,
+                error: message,
+            };
+        }
+    }
+    /**
+     * Get recent memories from a bank.
+     *
+     * @param bankId - Bank identifier
+     * @param limit - Maximum number of memories to return (default: 50)
+     * @returns Recent memories sorted by creation time (newest first)
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async recent(bankId, limit = 50) {
+        const response = await this.request("GET", `/v1/default/banks/${encodeURIComponent(bankId)}/memories/list`, { params: { limit: limit.toString() } });
+        return response.items.map((item) => {
+            const mem = {
+                id: item.id,
+                text: item.text,
+                factType: item.type ?? "world",
+                createdAt: item.date ?? new Date().toISOString(),
+            };
+            if (item.context)
+                mem.context = item.context;
+            return mem;
+        });
+    }
+    /**
+     * Clear all memories from a bank.
+     *
+     * Note: The Hindsight API only supports clearing all memories at once,
+     * not removing individual memories.
+     *
+     * @param bankId - Bank identifier
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    async forgetAll(bankId) {
+        await this.request("DELETE", `/v1/default/banks/${encodeURIComponent(bankId)}/memories`);
+    }
+    /**
+     * @deprecated Use forgetAll() instead - individual memory deletion not supported
+     */
+    async forget(bankId, _memoryId) {
+        await this.forgetAll(bankId);
+    }
+    // ============================================
+    // Private Methods
+    // ============================================
+    /**
+     * Make an HTTP request to the Hindsight API.
+     * @internal
+     */
+    async request(method, path, options = {}) {
+        const timeout = options.timeout ?? this.timeouts.default;
+        let url = `${this.baseUrl}${path}`;
+        // Add query parameters if present
+        if (options.params) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(options.params)) {
+                searchParams.set(key, String(value));
+            }
+            url += `?${searchParams.toString()}`;
+        }
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        try {
+            const fetchOptions = {
+                method,
+                headers,
+                signal: AbortSignal.timeout(timeout),
+            };
+            if (options.body !== undefined) {
+                fetchOptions.body = JSON.stringify(options.body);
+            }
+            const response = await fetch(url, fetchOptions);
+            if (!response.ok) {
+                const body = await this.safeParseJson(response);
+                throw createErrorFromResponse(response, body, path);
+            }
+            // Handle 204 No Content
+            if (response.status === 204) {
+                return undefined;
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            // Re-throw HindsightErrors as-is
+            if (HindsightError.isHindsightError(error)) {
+                throw error;
+            }
+            // Convert network errors to HindsightError
+            throw createErrorFromNetworkFailure(error);
+        }
+    }
+    /**
+     * Safely parse JSON from response, returning undefined on failure.
+     * @internal
+     */
+    async safeParseJson(response) {
+        try {
+            return await response.json();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Validate disposition values are in the valid range (1-5).
+     * @internal
+     */
+    validateDisposition(disposition) {
+        const traits = ["skepticism", "literalism", "empathy"];
+        for (const trait of traits) {
+            const value = disposition[trait];
+            if (typeof value !== "number" ||
+                !Number.isInteger(value) ||
+                value < 1 ||
+                value > 5) {
+                throw new HindsightError(`Invalid ${trait}: must be an integer between 1 and 5, got: ${value}`, "INVALID_DISPOSITION", { isRetryable: false });
+            }
+        }
+    }
+    /**
+     * Map bank response DTO to public Bank interface.
+     * @internal
+     */
+    mapBankResponse(raw) {
+        const result = {
+            bankId: raw.bank_id,
+            disposition: raw.disposition,
+            createdAt: raw.created_at,
+            memoryCount: raw.memory_count,
+        };
+        if (raw.background !== undefined) {
+            result.background = raw.background;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAgBrB;;GAEG;AACH,MAAM,gBAAgB,GAAkB;IACtC,OAAO,EAAE,MAAM,EAAE,aAAa;IAC9B,MAAM,EAAE,KAAK,EAAE,0BAA0B;IACzC,MAAM,EAAE,MAAM,EAAE,4BAA4B;IAC5C,OAAO,EAAE,MAAM,EAAE,4BAA4B;IAC7C,MAAM,EAAE,MAAM,EAAE,+BAA+B;CAChD,CAAC;AAWF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAS;IAChB,MAAM,CAAU;IAChB,QAAQ,CAAgB;IAEzC;;;;OAIG;IACH,YAAY,UAAkC,EAAE;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;QAElC,IAAI,CAAC,OAAO,GAAG,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC/D,CAAC;IAED,+CAA+C;IAC/C,kBAAkB;IAClB,+CAA+C;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,OAAoB;QACnC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE9C,MAAM,IAAI,CAAC,OAAO,CAChB,KAAK,EACL,qBAAqB,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EACzD;YACE,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO,CAAC,MAAM;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;aACrC;SACF,CACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,KAAK,EACL,mBAAmB,CACpB,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,cAAc,CAAC,mBAAmB,MAAM,EAAE,EAAE,gBAAgB,EAAE;gBACtE,WAAW,EAAE,KAAK;aACnB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CACrB,MAAc,EACd,WAAwB;QAExB,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAEtC,MAAM,IAAI,CAAC,OAAO,CAChB,KAAK,EACL,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,UAAU,EACzD,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,OAOC;QAED,MAAM,IAAI,GAA4B,EAAE,CAAC;QAEzC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACvC,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACzC,CAAC;QAED,2DAA2D;QAC3D,+CAA+C;QAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE3C,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE;gBACX,GAAG,OAAO,CAAC,WAAW;gBACtB,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;aAC/B;YACD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE;SAC3D,CAAC;QAEF,MAAM,IAAI,CAAC,OAAO,CAChB,KAAK,EACL,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,EAAE,EACjD,EAAE,IAAI,EAAE,UAAU,EAAE,CACrB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,MAAM,IAAI,CAAC,OAAO,CAChB,QAAQ,EACR,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAClD,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,kBAAkB;IAClB,+CAA+C;IAE/C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CACV,MAAc,EACd,OAAe,EACf,OAAgB;QAQhB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,MAAM,EACN,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAC1D;YACE,IAAI,EAAE;gBACJ,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;gBAC7B,KAAK,EAAE,KAAK;aACb;YACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;SAC9B,CACF,CAAC;QACF,OAAO,QAAQ,CAAC,WAAW,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,MAAM,CACV,MAAc,EACd,KAAa,EACb,UAAyB,EAAE;QAe3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,MAAM,EACN,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,kBAAkB,EACjE;YACE,IAAI,EAAE;gBACJ,KAAK;gBACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;gBAC/B,IAAI,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC/D,UAAU,EAAE,OAAO,CAAC,SAAS;aAC9B;YACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;SAC9B,CACF,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAU,EAAE;YACxC,MAAM,GAAG,GAAW;gBAClB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAG,CAAC,CAAC,IAAiB,IAAI,OAAO;gBACzC,SAAS,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtD,CAAC;YACF,IAAI,CAAC,CAAC,OAAO;gBAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;YACvC,IAAI,CAAC,CAAC,cAAc;gBAAE,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,cAAc,CAAC;YAC3D,IAAI,CAAC,CAAC,YAAY;gBAAE,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC;YACrD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,OAAO,CACX,MAAc,EACd,KAAa,EACb,OAAgB;QAYhB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,MAAM,EACN,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,UAAU,EACzD;YACE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;YACxB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;SAC/B,CACF,CAAC;QACF,8DAA8D;QAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,QAAQ,EAAE,EAAE,EAAE,yCAAyC;YACvD,OAAO,EAAE;gBACP,KAAK,EAAE,OAAO;qBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;qBACjC,GAAG,CACF,CAAC,CAAC,EAAU,EAAE,CAAC,CAAC;oBACd,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,OAAO;oBACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC,CACH;gBACH,UAAU,EAAE,OAAO;qBAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;qBACtC,GAAG,CACF,CAAC,CAAC,EAAU,EAAE,CAAC,CAAC;oBACd,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,YAAY;oBACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC,CACH;gBACH,OAAO,EAAE,OAAO;qBACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;qBACnC,GAAG,CACF,CAAC,CAAC,EAAU,EAAE,CAAC,CAAC;oBACd,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,SAAS;oBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC,CACH;aACJ;SACF,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,YAAY;IACZ,+CAA+C;IAE/C;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,KAAK,EACL,SAAS,EACT;gBACE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;aAC9B,CACF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,QAAQ,CAAC,MAAM,KAAK,SAAS;gBACtC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO;aACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,QAAgB,EAAE;QAe7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,KAAK,EACL,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,gBAAgB,EAC/D,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,CACxC,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAU,EAAE;YACzC,MAAM,GAAG,GAAW;gBAClB,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAG,IAAI,CAAC,IAAiB,IAAI,OAAO;gBAC5C,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACjD,CAAC;YACF,IAAI,IAAI,CAAC,OAAO;gBAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7C,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,MAAM,IAAI,CAAC,OAAO,CAChB,QAAQ,EACR,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAC3D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,SAAkB;QAC7C,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,+CAA+C;IAC/C,kBAAkB;IAClB,+CAA+C;IAE/C;;;OAGG;IACK,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,UAA0B,EAAE;QAE5B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzD,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAEnC,kCAAkC;QAClC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1D,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACvC,CAAC;YACD,GAAG,IAAI,IAAI,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACrD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAgB;gBAChC,MAAM;gBACN,OAAO;gBACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;aACrC,CAAC;YACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM,uBAAuB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACtD,CAAC;YAED,wBAAwB;YACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,SAAc,CAAC;YACxB,CAAC;YAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iCAAiC;YACjC,IAAI,cAAc,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC;YACd,CAAC;YAED,2CAA2C;YAC3C,MAAM,6BAA6B,CAAC,KAAc,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa,CAAC,QAAkB;QAC5C,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,WAAwB;QAClD,MAAM,MAAM,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAU,CAAC;QAEhE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACjC,IACE,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;gBACxB,KAAK,GAAG,CAAC;gBACT,KAAK,GAAG,CAAC,EACT,CAAC;gBACD,MAAM,IAAI,cAAc,CACtB,WAAW,KAAK,8CAA8C,KAAK,EAAE,EACrE,qBAAqB,EACrB,EAAE,WAAW,EAAE,KAAK,EAAE,CACvB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,GAAoB;QAC1C,MAAM,MAAM,GAAS;YACnB,MAAM,EAAE,GAAG,CAAC,OAAO;YACnB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,WAAW,EAAE,GAAG,CAAC,YAAY;SAC9B,CAAC;QACF,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CAEF"}

package/dist/config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Configuration loading for claude-cognitive.
+ * @module config
+ */
+import type { ClaudeMindConfig } from "./types.js";
+/**
+ * Partial configuration for merging.
+ */
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+export type PartialConfig = DeepPartial<ClaudeMindConfig>;
+/**
+ * Load configuration from multiple sources with priority order:
+ *
+ * 1. Constructor overrides (highest priority)
+ * 2. Environment variables
+ * 3. .claudemindrc file
+ * 4. package.json "claudemind" key
+ * 5. Default values (lowest priority)
+ *
+ * @param projectPath - Root directory of the project (default: process.cwd())
+ * @param overrides - Explicit configuration overrides
+ * @returns Merged configuration
+ *
+ * @example
+ * ```typescript
+ * // Load from current directory with defaults
+ * const config = await loadConfig();
+ *
+ * // Load from specific directory with overrides
+ * const config = await loadConfig('/path/to/project', {
+ *   hindsight: { host: 'hindsight.example.com' }
+ * });
+ * ```
+ */
+export declare function loadConfig(projectPath?: string, overrides?: PartialConfig): Promise<ClaudeMindConfig>;
+/**
+ * Get default configuration without loading from files.
+ * Useful for testing or when you want explicit control.
+ */
+export declare function getDefaultConfig(): ClaudeMindConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,YAAY,CAAC;AAgBhE;;GAEG;AACH,KAAK,WAAW,CAAC,CAAC,IAAI;KACnB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAiO1D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAC9B,WAAW,GAAE,MAAsB,EACnC,SAAS,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAgC3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD"}