tracelattice 1.2.5

package/dist/__tests__/helpers/factories.d.ts

@@ -0,0 +1,36 @@
+import type { ThoughtData } from '../../core/thought.js';
+import type { ToolRecommendation } from '../../types/tool.js';
+import type { SkillRecommendation } from '../../types/skill.js';
+import type { StepRecommendation } from '../../core/step.js';
+import type { IHistoryManager } from '../../core/IHistoryManager.js';
+import type { ThoughtFormatter } from '../../core/ThoughtFormatter.js';
+export declare function createTestThought(overrides?: Partial<ThoughtData>): ThoughtData;
+export declare function createToolRecommendation(overrides?: Partial<ToolRecommendation>): ToolRecommendation;
+export declare function createSkillRecommendation(overrides?: Partial<SkillRecommendation>): SkillRecommendation;
+export declare function createStepRecommendation(overrides?: Partial<StepRecommendation>): StepRecommendation;
+export declare function createHypothesisThought(overrides?: Partial<ThoughtData>): ThoughtData;
+export declare function createVerificationThought(overrides?: Partial<ThoughtData>): ThoughtData;
+export declare function createCritiqueThought(overrides?: Partial<ThoughtData>): ThoughtData;
+export declare function createSynthesisThought(overrides?: Partial<ThoughtData>): ThoughtData;
+export declare function createMetaThought(overrides?: Partial<ThoughtData>): ThoughtData;
+/**
+ * Mock implementation of IHistoryManager for testing.
+ * Tracks calls and stores data in-memory.
+ */
+export declare class MockHistoryManager implements IHistoryManager {
+    private _sessions;
+    private _clearCallCount;
+    private static readonly DEFAULT;
+    private _getSession;
+    addThought(thought: ThoughtData): void;
+    getHistory(sessionId?: string): ThoughtData[];
+    getHistoryLength(sessionId?: string): number;
+    getBranches(sessionId?: string): Record<string, ThoughtData[]>;
+    getBranchIds(sessionId?: string): string[];
+    clear(sessionId?: string): void;
+    getClearCallCount(): number;
+    getAvailableMcpTools(sessionId?: string): string[] | undefined;
+    getAvailableSkills(sessionId?: string): string[] | undefined;
+}
+export declare function createMockFormatter(): Pick<ThoughtFormatter, 'formatThought'>;
+//# sourceMappingURL=factories.d.ts.map

package/dist/__tests__/helpers/factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAU/E;AAED,wBAAgB,wBAAwB,CACvC,SAAS,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,kBAAkB,CAQpB;AAED,wBAAgB,yBAAyB,CACxC,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACtC,mBAAmB,CAQrB;AAED,wBAAgB,wBAAwB,CACvC,SAAS,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,kBAAkB,CAOpB;AAED,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAUrF;AAED,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAUvF;AAED,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAUnF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAWpF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAQ/E;AAID;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACzD,OAAO,CAAC,SAAS,CAQb;IACJ,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAgB;IAE/C,OAAO,CAAC,WAAW;IAanB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAOtC,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAI7C,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAI5C,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAI9D,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAI1C,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAM/B,iBAAiB,IAAI,MAAM;IAI3B,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAI9D,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;CAG5D;AAID,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAY7E"}

package/dist/__tests__/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './factories.js';
+export * from './timers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/__tests__/helpers/timers.d.ts

@@ -0,0 +1,4 @@
+export declare function useFakeTimers(): void;
+export declare function advanceTime(ms: number): void;
+export declare function useRealTimers(): void;
+//# sourceMappingURL=timers.d.ts.map

package/dist/__tests__/helpers/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/timers.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/__tests__/history-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=history-manager.test.d.ts.map

package/dist/__tests__/history-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-manager.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/history-manager.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/http-helpers-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-helpers-cov.test.d.ts.map

package/dist/__tests__/http-helpers-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-helpers-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/http-helpers-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/http-transport-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-transport-cov.test.d.ts.map

package/dist/__tests__/http-transport-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/http-transport-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/http-transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-transport.test.d.ts.map

package/dist/__tests__/http-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/http-transport.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/input-normalizer.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for InputNormalizer.
+ *
+ * This test file covers the normalization logic that handles common LLM
+ * field name mistakes such as using singular instead of plural forms.
+ */
+export {};
+//# sourceMappingURL=input-normalizer.test.d.ts.map

package/dist/__tests__/input-normalizer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-normalizer.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/input-normalizer.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/__tests__/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib-server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lib-server.test.d.ts.map

package/dist/__tests__/lib-server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib-server.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/lib-server.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/memory-persistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-persistence.test.d.ts.map

package/dist/__tests__/memory-persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-persistence.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/memory-persistence.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/metrics-integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metrics-integration.test.d.ts.map

package/dist/__tests__/metrics-integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/metrics-integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/persistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=persistence.test.d.ts.map

package/dist/__tests__/persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/persistence.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/reasoning-integration.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Integration tests for the full reasoning pipeline.
+ *
+ * Exercises ThoughtProcessor + ThoughtEvaluator together across multi-step
+ * reasoning chains: hypothesis → verification → synthesis, branching + merge,
+ * backward compatibility, metacognitive observations, and confidence tracking.
+ *
+ * @module __tests__/reasoning-integration
+ */
+export {};
+//# sourceMappingURL=reasoning-integration.test.d.ts.map

package/dist/__tests__/reasoning-integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/reasoning-integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/reasoning-types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reasoning-types.test.d.ts.map

package/dist/__tests__/reasoning-types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-types.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/reasoning-types.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/request-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=request-context.test.d.ts.map

package/dist/__tests__/request-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/request-context.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sanitize.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sanitize.test.d.ts.map

package/dist/__tests__/sanitize.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sanitize.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.test.d.ts.map

package/dist/__tests__/schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sequentialthinking-tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sequentialthinking-tools.test.d.ts.map

package/dist/__tests__/sequentialthinking-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequentialthinking-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sequentialthinking-tools.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/server-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server-config.test.d.ts.map

package/dist/__tests__/server-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/server-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/skill-discovery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-discovery.test.d.ts.map

package/dist/__tests__/skill-discovery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-discovery.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/skill-discovery.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/skill-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-registry.test.d.ts.map

package/dist/__tests__/skill-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/skill-registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/skill-watcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-watcher.test.d.ts.map

package/dist/__tests__/skill-watcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-watcher.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/skill-watcher.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sqlite-persistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-persistence.test.d.ts.map

package/dist/__tests__/sqlite-persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-persistence.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sqlite-persistence.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sse-transport-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sse-transport-cov.test.d.ts.map

package/dist/__tests__/sse-transport-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-transport-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sse-transport-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sse-transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sse-transport.test.d.ts.map

package/dist/__tests__/sse-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-transport.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sse-transport.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/streamable-http-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=streamable-http-cov.test.d.ts.map

package/dist/__tests__/streamable-http-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/streamable-http-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/streamable-http-transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=streamable-http-transport.test.d.ts.map

package/dist/__tests__/streamable-http-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/streamable-http-transport.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/structured-logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=structured-logger.test.d.ts.map

package/dist/__tests__/structured-logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-logger.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/structured-logger.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/thought-evaluator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thought-evaluator.test.d.ts.map

package/dist/__tests__/thought-evaluator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought-evaluator.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thought-evaluator.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/thought-formatter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thought-formatter.test.d.ts.map

package/dist/__tests__/thought-formatter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought-formatter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thought-formatter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/thought-processor.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Comprehensive tests for ThoughtProcessor.
+ *
+ * This test file covers input validation, error handling, history integration,
+ * response formatting, and edge cases for the ThoughtProcessor class.
+ */
+export {};
+//# sourceMappingURL=thought-processor.test.d.ts.map

package/dist/__tests__/thought-processor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought-processor.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thought-processor.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/tool-registry-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-registry-cov.test.d.ts.map

package/dist/__tests__/tool-registry-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-registry-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tool-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-registry.test.d.ts.map

package/dist/__tests__/tool-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tool-watcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-watcher.test.d.ts.map

package/dist/__tests__/tool-watcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-watcher.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-watcher.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/worker-manager-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-manager-cov.test.d.ts.map

package/dist/__tests__/worker-manager-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-manager-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/worker-manager-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/worker-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-manager.test.d.ts.map

package/dist/__tests__/worker-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-manager.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/worker-manager.test.ts"],"names":[],"mappings":""}

package/dist/cache/DiscoveryCache.d.ts

@@ -0,0 +1,269 @@
+import type { IMetrics } from '../contracts/index.js';
+/**
+ * LRU Cache for tool/skill discovery results with TTL support.
+ *
+ * This module provides a generic Least Recently Used (LRU) cache with time-to-live
+ * (TTL) support. It's designed to cache discovery results to avoid repeated expensive
+ * operations like filesystem scanning.
+ *
+ * @module cache
+ */
+/**
+ * A cache entry containing data and metadata for LRU tracking.
+ *
+ * @template T - The type of data being cached (typically Tool or Skill)
+ *
+ * @example
+ * ```typescript
+ * const entry: CacheEntry<string> = {
+ *   data: ['tool1', 'tool2'],
+ *   timestamp: 1705550000000,
+ *   accessCount: 5
+ * };
+ * ```
+ */
+export interface CacheEntry<T> {
+    /** The cached data array. */
+    data: T[];
+    /** Unix timestamp (milliseconds) when the entry was created/last accessed. */
+    timestamp: number;
+    /** Number of times this entry has been accessed (for LRU tracking). */
+    accessCount: number;
+}
+/**
+ * Configuration options for creating a `DiscoveryCache` instance.
+ *
+ * @example
+ * ```typescript
+ * const options: DiscoveryCacheOptions = {
+ *   maxSize: 200,
+ *   ttl: 600000  // 10 minutes
+ * };
+ * ```
+ */
+export interface DiscoveryCacheOptions {
+    /**
+     * Maximum number of cache entries before LRU eviction begins.
+     * @default 100
+     */
+    maxSize?: number;
+    /**
+     * Time-to-live for cache entries in milliseconds.
+     * Entries older than this are considered expired.
+     * @default 300000 (5 minutes)
+     */
+    ttl?: number;
+    cleanupInterval?: number;
+    metrics?: IMetrics;
+}
+/**
+ * LRU (Least Recently Used) cache with TTL support for caching discovery results.
+ *
+ * This cache implements an LRU eviction policy where entries that haven't been
+ * accessed recently are removed first when the cache reaches maximum capacity.
+ * Additionally, entries expire after a configurable TTL period.
+ *
+ * @remarks
+ * **Eviction Policy:**
+ * - When `maxSize` is reached, the least recently used entry is removed
+ * - An entry's "recent use" is tracked by its position in the underlying Map
+ * - Accessing an entry moves it to the "most recently used" position
+ * - Setting an existing key also updates its position
+ *
+ * **Expiration:**
+ * - Entries older than `ttl` milliseconds are automatically removed on access
+ * - Expiration is checked lazily (when `get()` or `has()` is called)
+ *
+ * **Thread Safety:**
+ * - This implementation is not thread-safe and should not be shared
+ *   across asynchronous operations without proper synchronization
+ *
+ * @template T - The type of data being cached
+ *
+ * @example
+ * ```typescript
+ * const cache = new DiscoveryCache<string>({
+ *   maxSize: 100,
+ *   ttl: 300000  // 5 minutes
+ * });
+ *
+ * // Store discovery results
+ * cache.set('.claude/skills', ['commit', 'pdf', 'test']);
+ *
+ * // Retrieve from cache
+ * const skills = cache.get('.claude/skills');
+ * if (skills) {
+ *   console.log('Cached skills:', skills);
+ * } else {
+ *   console.log('Not cached or expired');
+ * }
+ *
+ * // Check if cached and valid
+ * if (cache.has('.claude/skills')) {
+ *   console.log('Skills are cached and fresh');
+ * }
+ *
+ * // Manually invalidate
+ * cache.invalidate('.claude/skills');
+ *
+ * // Clear all cache
+ * cache.clear();
+ *
+ * // Get statistics
+ * const stats = cache.getStats();
+ * console.log(`Cache size: ${stats.size}, keys: ${stats.keys.join(', ')}`);
+ * ```
+ */
+export declare class DiscoveryCache<T> {
+    /** Internal Map storing cache entries. Insertion order tracks LRU status. */
+    private _cache;
+    /** Maximum number of entries before eviction begins. */
+    private _maxSize;
+    /** Time-to-live in milliseconds for cache entries. */
+    private _ttl;
+    private _metrics?;
+    private _cleanupTimer;
+    /**
+     * Creates a new DiscoveryCache instance.
+     *
+     * @param options - Configuration options for the cache
+     *
+     * @example
+     * ```typescript
+     * // Default configuration (100 entries, 5 minute TTL)
+     * const cache1 = new DiscoveryCache();
+     *
+     * // Custom configuration
+     * const cache2 = new DiscoveryCache({
+     *   maxSize: 200,
+     *   ttl: 600000  // 10 minutes
+     * });
+     * ```
+     */
+    constructor(options?: DiscoveryCacheOptions);
+    private _cleanupExpired;
+    /**
+     * Retrieves a value from the cache by key.
+     *
+     * Returns the cached data if the key exists and the entry hasn't expired.
+     * Updates the entry's access time and moves it to the most-recently-used position.
+     * Returns null if the key doesn't exist or the entry has expired (expired entries
+     * are automatically deleted).
+     *
+     * @param key - The cache key to retrieve
+     * @returns The cached data array, or null if not found or expired
+     *
+     * @example
+     * ```typescript
+     * const tools = cache.get('/path/to/tools');
+     * if (tools) {
+     *   console.log('Found cached tools:', tools);
+     * } else {
+     *   console.log('Tools not cached or expired, need to discover');
+     * }
+     * ```
+     */
+    get(key: string): T[] | null;
+    /**
+     * Stores a value in the cache with the given key.
+     *
+     * If the cache is at maximum capacity and this is a new key, the least
+     * recently used entry is evicted before storing the new value. If the key
+     * already exists, its value and access time are updated.
+     *
+     * @param key - The cache key to store under
+     * @param data - The data array to cache
+     *
+     * @example
+     * ```typescript
+     * const discoveredTools = ['Read', 'Write', 'Bash', 'Grep'];
+     * cache.set('/usr/local/tools', discoveredTools);
+     * ```
+     */
+    set(key: string, data: T[]): void;
+    /**
+     * Checks if a key exists in the cache and hasn't expired.
+     *
+     * Returns true only if the key exists and the entry is within its TTL.
+     * Expired entries are not automatically removed by this method (use `get()`
+     * for automatic expiration cleanup).
+     *
+     * @param key - The cache key to check
+     * @returns true if the key exists and hasn't expired, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (cache.has('/path/to/skills')) {
+     *   // Key exists and is fresh
+     *   const skills = cache.get('/path/to/skills')!;
+     * } else {
+     *   // Need to discover skills
+     * }
+     * ```
+     */
+    has(key: string): boolean;
+    /**
+     * Removes a specific entry from the cache.
+     *
+     * This is useful for explicit invalidation when cached data is known
+     * to be stale due to external changes.
+     *
+     * @param key - The cache key to invalidate
+     *
+     * @example
+     * ```typescript
+     * // Invalidate cache when files change
+     * watcher.on('change', (path) => {
+     *   cache.invalidate(path);
+     * });
+     * ```
+     */
+    invalidate(key: string): void;
+    /**
+     * Removes all entries from the cache.
+     *
+     * This completely resets the cache to an empty state.
+     *
+     * @example
+     * ```typescript
+     * // Clear cache before running tests
+     * cache.clear();
+     * ```
+     */
+    clear(): void;
+    dispose(): void;
+    /**
+     * Gets the current number of entries in the cache.
+     *
+     * @returns The number of cached entries
+     *
+     * @example
+     * ```typescript
+     * console.log(`Cache contains ${cache.size()} entries`);
+     * if (cache.size() >= maxSize) {
+     *   console.log('Cache is at capacity');
+     * }
+     * ```
+     */
+    size(): number;
+    /**
+     * Gets cache statistics including size and all cached keys.
+     *
+     * Useful for monitoring and debugging cache behavior.
+     *
+     * @returns An object with cache size and array of all keys
+     *
+     * @example
+     * ```typescript
+     * const stats = cache.getStats();
+     * console.log(`Cache stats:`);
+     * console.log(`  Size: ${stats.size}`);
+     * console.log(`  Keys: ${stats.keys.join(', ')}`);
+     * ```
+     */
+    getStats(): {
+        size: number;
+        keys: string[];
+    };
+}
+//# sourceMappingURL=DiscoveryCache.d.ts.map

package/dist/cache/DiscoveryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoveryCache.d.ts","sourceRoot":"","sources":["../../src/cache/DiscoveryCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,6BAA6B;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IAEV,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,qBAAa,cAAc,CAAC,CAAC;IAC5B,6EAA6E;IAC7E,OAAO,CAAC,MAAM,CAA6B;IAE3C,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAS;IAEzB,sDAAsD;IACtD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,aAAa,CAA+B;IAEpD;;;;;;;;;;;;;;;;OAgBG;gBACS,OAAO,GAAE,qBAA0B;IAc/C,OAAO,CAAC,eAAe;IAWvB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI;IA8B5B;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IAuBjC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQzB;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;;;;;;;OAUG;IACH,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAOf;;;;;;;;;;;;OAYG;IACH,IAAI,IAAI,MAAM;IAId;;;;;;;;;;;;;;OAcG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;CAM5C"}