capman 0.5.2 → 0.5.4

package/dist/cjs/schema.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export declare const CapmanConfigSchema: z.ZodObject<{
+export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
     app: z.ZodString;
     baseUrl: z.ZodOptional<z.ZodString>;
     capabilities: z.ZodEffects<z.ZodArray<z.ZodObject<{
@@ -405,6 +405,98 @@ export declare const CapmanConfigSchema: z.ZodObject<{
         examples?: string[] | undefined;
     }[];
     baseUrl?: string | undefined;
+}>, {
+    app: string;
+    capabilities: {
+        name: string;
+        id: string;
+        params: {
+            name: string;
+            required: boolean;
+            description: string;
+            source: "user_query" | "session" | "context" | "static";
+            default?: string | number | boolean | undefined;
+        }[];
+        description: string;
+        returns: string[];
+        resolver: {
+            type: "api";
+            endpoints: {
+                method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+                path: string;
+                params?: string[] | undefined;
+            }[];
+        } | {
+            type: "nav";
+            destination: string;
+            hint?: string | undefined;
+        } | {
+            type: "hybrid";
+            api: {
+                endpoints: {
+                    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+                    path: string;
+                    params?: string[] | undefined;
+                }[];
+            };
+            nav: {
+                destination: string;
+                hint?: string | undefined;
+            };
+        };
+        privacy: {
+            level: "public" | "user_owned" | "admin";
+            note?: string | undefined;
+        };
+        examples?: string[] | undefined;
+    }[];
+    baseUrl?: string | undefined;
+}, {
+    app: string;
+    capabilities: {
+        name: string;
+        id: string;
+        params: {
+            name: string;
+            required: boolean;
+            description: string;
+            source: "user_query" | "session" | "context" | "static";
+            default?: string | number | boolean | undefined;
+        }[];
+        description: string;
+        returns: string[];
+        resolver: {
+            type: "api";
+            endpoints: {
+                method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+                path: string;
+                params?: string[] | undefined;
+            }[];
+        } | {
+            type: "nav";
+            destination: string;
+            hint?: string | undefined;
+        } | {
+            type: "hybrid";
+            api: {
+                endpoints: {
+                    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+                    path: string;
+                    params?: string[] | undefined;
+                }[];
+            };
+            nav: {
+                destination: string;
+                hint?: string | undefined;
+            };
+        };
+        privacy: {
+            level: "public" | "user_owned" | "admin";
+            note?: string | undefined;
+        };
+        examples?: string[] | undefined;
+    }[];
+    baseUrl?: string | undefined;
 }>;
 export declare const ManifestSchema: z.ZodObject<{
     version: z.ZodString;

package/dist/cjs/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA2EvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAA;AAIF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKzB,CAAA;AAIF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAQnE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAQvE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA2EvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB9B,CAAA;AAID,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKzB,CAAA;AAIF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAQnE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAQvE"}

package/dist/cjs/schema.js

@@ -67,11 +67,14 @@ const CapabilitySchema = zod_1.z.object({
 // ─── Config Schema ────────────────────────────────────────────────────────────
 exports.CapmanConfigSchema = zod_1.z.object({
     app: zod_1.z.string().min(1, 'app name is required'),
-    baseUrl: zod_1.z.string().url('baseUrl must be a valid URL').optional(),
+    baseUrl: zod_1.z.string().url().optional(),
     capabilities: zod_1.z.array(CapabilitySchema)
         .min(1, 'at least one capability is required')
         .refine(caps => new Set(caps.map(c => c.id)).size === caps.length, 'capability ids must be unique'),
-});
+}).refine(cfg => {
+    const needsBaseUrl = cfg.capabilities.some(c => c.resolver.type === 'api' || c.resolver.type === 'hybrid');
+    return !needsBaseUrl || !!cfg.baseUrl;
+}, { message: 'baseUrl is required when any capability uses an api or hybrid resolver' });
 // ─── Manifest Schema ──────────────────────────────────────────────────────────
 exports.ManifestSchema = zod_1.z.object({
     version: zod_1.z.string(),

package/dist/cjs/schema.js.map

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

package/dist/cjs/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.5.2";
+export declare const VERSION = "0.5.3";
 //# sourceMappingURL=version.d.ts.map

package/dist/cjs/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // Auto-generated by scripts/version.js — do not edit manually
-exports.VERSION = '0.5.2';
+exports.VERSION = '0.5.3';
 //# sourceMappingURL=version.js.map

package/dist/esm/cache.d.ts

@@ -29,10 +29,11 @@ export declare class MemoryCache implements CacheStore {
 export declare class FileCache implements CacheStore {
     private filePath;
     private store;
-    private loaded;
+    private loadPromise;
     private saveQueue;
     constructor(filePath?: string);
     private load;
+    private _doLoad;
     private save;
     private _doSave;
     get(key: string, ttlMs?: number): Promise<CacheEntry | null>;

package/dist/esm/cache.js

@@ -66,7 +66,7 @@ const FILE_CACHE_MAX = 2048;
 export class FileCache {
     constructor(filePath = '.capman/cache.json') {
         this.store = new Map();
-        this.loaded = false;
+        this.loadPromise = null;
         this.saveQueue = Promise.resolve();
         const cwd = process.cwd();
         const resolved = path.resolve(cwd, filePath);
@@ -78,9 +78,13 @@ export class FileCache {
         this.filePath = resolved;
         logger.info(`FileCache initialized — writing to: ${this.filePath}`);
     }
-    async load() {
-        if (this.loaded)
-            return;
+    load() {
+        if (!this.loadPromise) {
+            this.loadPromise = this._doLoad();
+        }
+        return this.loadPromise;
+    }
+    async _doLoad() {
         try {
             const raw = await fs.promises.readFile(this.filePath, 'utf-8');
             const parsed = JSON.parse(raw);
@@ -102,7 +106,6 @@ export class FileCache {
         catch {
             // File doesn't exist yet — start fresh
         }
-        this.loaded = true;
     }
     save() {
         this.saveQueue = this.saveQueue.then(() => this._doSave());
@@ -112,7 +115,9 @@ export class FileCache {
         try {
             const dir = path.dirname(this.filePath);
             await fs.promises.mkdir(dir, { recursive: true });
-            await fs.promises.writeFile(this.filePath, JSON.stringify(Object.fromEntries(this.store), null, 2));
+            const tmp = `${this.filePath}.tmp`;
+            await fs.promises.writeFile(tmp, JSON.stringify(Object.fromEntries(this.store), null, 2));
+            await fs.promises.rename(tmp, this.filePath);
         }
         catch (err) {
             logger.warn(`Failed to save file cache to ${this.filePath}: ${err instanceof Error ? err.message : String(err)}`);

package/dist/esm/engine.d.ts

@@ -83,6 +83,20 @@ export interface EngineOptions {
      * @default 60000
      */
     llmCircuitBreakerResetMs?: number;
+    /**
+     * Enable fuzzy matching using Fuse.js — catches paraphrases, typos,
+     * and morphological variants that exact keyword matching misses.
+     * Example: "cancel my booking" matches a capability with "abort reservation" examples.
+     * Only applies in balanced and accurate modes — never in cheap mode.
+     * @default false
+     */
+    fuzzyMatch?: boolean;
+    /**
+     * Fuse.js threshold for fuzzy matching. 0.0 = exact match only, 1.0 = match anything.
+     * Lower values are stricter. Only used when fuzzyMatch is true.
+     * @default 0.4
+     */
+    fuzzyThreshold?: number;
 }
 export interface EngineResult {
     match: MatchResult;
@@ -105,6 +119,8 @@ export declare class CapmanEngine {
     private headers?;
     private threshold;
     private cacheTtlMs;
+    private fuzzyMatch;
+    private fuzzyThreshold;
     private maxLLMCallsPerMinute;
     private llmCooldownMs;
     private llmCircuitBreakerThreshold;
@@ -143,6 +159,20 @@ export declare class CapmanEngine {
      * Clear the cache.
      */
     clearCache(): Promise<void>;
+    private checkManifestVersion;
+    /**
+     * Replaces the active manifest without creating a new engine instance.
+     * Useful for hot-reloading manifests in long-running servers without
+     * losing cache, learning history, or rate limiter state.
+     *
+     * Note: clears the cache automatically — cached results from the old
+     * manifest are no longer valid after the manifest changes.
+     *
+     * @example
+     * const newManifest = generate(updatedConfig)
+     * await engine.loadManifest(newManifest)
+     */
+    loadManifest(manifest: Manifest): Promise<void>;
     /**
      * Explain what would happen for a query — without executing it.
      * Shows matched capability, all candidate scores with reasoning,

package/dist/esm/engine.js

@@ -25,6 +25,8 @@ export class CapmanEngine {
         this.llmCooldownMs = options.llmCooldownMs ?? 0;
         this.llmCircuitBreakerThreshold = options.llmCircuitBreakerThreshold ?? 3;
         this.llmCircuitBreakerResetMs = options.llmCircuitBreakerResetMs ?? 60_000;
+        this.fuzzyMatch = options.fuzzyMatch ?? false;
+        this.fuzzyThreshold = options.fuzzyThreshold ?? 0.4;
         // Cache — default MemoryCache (no filesystem writes), or disabled with false
         // Use FileCache or ComboCache explicitly for persistence across restarts
         this.cache = options.cache === false
@@ -37,15 +39,7 @@ export class CapmanEngine {
             : (options.learning ?? new MemoryLearningStore());
         logger.info(`CapmanEngine initialized — mode: ${this.mode}, cache: ${this.cache ? 'enabled' : 'disabled'}, learning: ${this.learning ? 'enabled' : 'disabled'}`);
         // ── Manifest version compatibility check ─────────────────────────────────
-        if (options.manifest.version) {
-            const [mMaj, mMin] = options.manifest.version.split('.').map(Number);
-            const [eMaj, eMin] = VERSION.split('.').map(Number);
-            if (mMaj !== eMaj || mMin !== eMin) {
-                console.warn(`[capman] Manifest version "${options.manifest.version}" was generated with a ` +
-                    `different engine version than "${VERSION}". This is usually fine across patch versions. ` +
-                    `If you experience unexpected matching issues, regenerate with: npx capman generate`);
-            }
-        }
+        this.checkManifestVersion(options.manifest);
     }
     /**
      * Ask the engine a natural language query.
@@ -74,7 +68,8 @@ export class CapmanEngine {
             const cached = await this.cache.get(queryKey, this.cacheTtlMs ?? undefined);
             if (cached) {
                 steps.push({ type: 'cache_check', status: 'hit', durationMs: Date.now() - cacheStart, detail: 'Served from cache' });
-                logger.info(`Cache hit for: "${query}"`);
+                logger.info(`Cache hit — capability: "${cached.result.capability?.id ?? 'none'}"`);
+                logger.debug(`Cache hit for query: "${query}"`);
                 // Re-extract params from the current query — never re-use cached params.
                 // Cached params belong to the original query (potentially from a different user).
                 // e.g. User A: "show orders for john" → cached with { customer: 'john' }
@@ -125,15 +120,7 @@ export class CapmanEngine {
                 detail: `level: ${privacyLevel}`,
             });
         }
-        // ── Step 4: Cache the match result (public capabilities only) ─────────────
-        // Non-public capabilities are never cached — prevents auth bypass where
-        // User A's cached match is served to User B without privacy enforcement.
-        if (this.cache && matchResult.capability
-            && matchResult.capability.privacy.level === 'public') {
-            const queryKey = normalizeQuery(query);
-            await this.cache.set(queryKey, matchResult);
-        }
-        // ── Step 5: Resolve ──────────────────────────────────────────────────────
+        // ── Step 4: Resolve ──────────────────────────────────────────────────────
         const resolveStart = Date.now();
         const resolution = await _resolve(matchResult, matchResult.extractedParams, this.resolveOptions(overrides));
         steps.push({
@@ -142,6 +129,16 @@ export class CapmanEngine {
             durationMs: Date.now() - resolveStart,
             detail: resolution.error ?? `via ${resolution.resolverType}`,
         });
+        // ── Step 5: Cache after successful resolution ────────────────────────────
+        // Only cache when resolution succeeded — a failed resolution (network error,
+        // auth failure, bad params) must not poison the cache. A cached failed match
+        // would cause every subsequent cache hit to attempt the same failing resolution
+        // until TTL expires.
+        if (this.cache && resolution.success && matchResult.capability
+            && matchResult.capability.privacy.level === 'public') {
+            const queryKey = normalizeQuery(query);
+            await this.cache.set(queryKey, matchResult);
+        }
         // ── Step 6: Build reasoning array ────────────────────────────────────────
         const reasoning = [];
         if (matchResult.candidates.length) {
@@ -212,6 +209,41 @@ export class CapmanEngine {
         if (this.cache)
             await this.cache.clear();
     }
+    checkManifestVersion(manifest) {
+        if (!manifest.version)
+            return;
+        const SEMVER_RE = /^\d+\.\d+\.\d+$/;
+        if (SEMVER_RE.test(manifest.version) && SEMVER_RE.test(VERSION)) {
+            const [mMaj, mMin] = manifest.version.split('.').map(Number);
+            const [eMaj, eMin] = VERSION.split('.').map(Number);
+            if (mMaj !== eMaj || mMin !== eMin) {
+                console.warn(`[capman] Manifest version "${manifest.version}" was generated with a ` +
+                    `different engine version than "${VERSION}". This is usually fine across patch versions. ` +
+                    `If you experience unexpected matching issues, regenerate with: npx capman generate`);
+            }
+        }
+        else if (manifest.version !== VERSION) {
+            console.warn(`[capman] Manifest version "${manifest.version}" could not be compared ` +
+                `to engine version "${VERSION}" — version strings are not valid semver.`);
+        }
+    }
+    /**
+     * Replaces the active manifest without creating a new engine instance.
+     * Useful for hot-reloading manifests in long-running servers without
+     * losing cache, learning history, or rate limiter state.
+     *
+     * Note: clears the cache automatically — cached results from the old
+     * manifest are no longer valid after the manifest changes.
+     *
+     * @example
+     * const newManifest = generate(updatedConfig)
+     * await engine.loadManifest(newManifest)
+     */
+    async loadManifest(manifest) {
+        this.checkManifestVersion(manifest);
+        this.manifest = manifest;
+        await this.clearCache();
+    }
     /**
      * Explain what would happen for a query — without executing it.
      * Shows matched capability, all candidate scores with reasoning,
@@ -239,6 +271,12 @@ export class CapmanEngine {
         const start = Date.now();
         // ── Match — shared with ask() via _runMatch() ─────────────────────────────
         let { matchResult, resolvedVia: _resolvedVia } = await this._runMatch(query);
+        // explain() never reads from cache — it always runs a fresh match.
+        // This assertion catches any future refactor that accidentally adds
+        // cache reads to _runMatch() when called from explain().
+        if (_resolvedVia === 'cache') {
+            throw new Error('Invariant violation: explain() must never resolve via cache');
+        }
         let resolvedVia = _resolvedVia;
         // ── Apply learning boost (same as ask()) ─────────────────────────────────
         matchResult = await this.applyBoostToMatchResult(query, matchResult);
@@ -438,6 +476,11 @@ export class CapmanEngine {
     async _runMatch(query, steps) {
         let matchResult;
         let resolvedVia = 'keyword';
+        // Fuzzy options — never applied in cheap mode
+        const fuzzyOpts = {
+            fuzzyMatch: this.fuzzyMatch,
+            fuzzyThreshold: this.fuzzyThreshold,
+        };
         switch (this.mode) {
             case 'cheap': {
                 const t = Date.now();
@@ -451,7 +494,7 @@ export class CapmanEngine {
                     if (skipReason) {
                         logger.warn(`LLM skipped — ${skipReason} — falling back to keyword`);
                         const t = Date.now();
-                        matchResult = _match(query, this.manifest);
+                        matchResult = _match(query, this.manifest, fuzzyOpts);
                         steps?.push({ type: 'keyword_match', status: 'pass', durationMs: Date.now() - t, detail: `llm skipped: ${skipReason}` });
                     }
                     else {
@@ -461,7 +504,7 @@ export class CapmanEngine {
                             this.recordLLMSuccess();
                             resolvedVia = 'llm';
                             // Merge keyword scores into LLM candidates so boost has real signal for alternatives
-                            const kwResult = _match(query, this.manifest);
+                            const kwResult = _match(query, this.manifest, fuzzyOpts);
                             matchResult = {
                                 ...matchResult,
                                 candidates: matchResult.candidates.map(c => ({
@@ -479,7 +522,7 @@ export class CapmanEngine {
                                 this.recordLLMFailure();
                             logger.warn(`LLM call failed — falling back to keyword: ${err instanceof Error ? err.message : String(err)}`);
                             const t2 = Date.now();
-                            matchResult = _match(query, this.manifest);
+                            matchResult = _match(query, this.manifest, fuzzyOpts);
                             steps?.push({ type: 'llm_match', status: 'fail', durationMs: Date.now() - t, detail: String(err) });
                             steps?.push({ type: 'keyword_match', status: 'pass', durationMs: Date.now() - t2, detail: 'fallback after llm failure' });
                         }
@@ -488,7 +531,7 @@ export class CapmanEngine {
                 else {
                     logger.warn('accurate mode requires llm — falling back to keyword');
                     const t = Date.now();
-                    matchResult = _match(query, this.manifest);
+                    matchResult = _match(query, this.manifest, fuzzyOpts);
                     steps?.push({ type: 'keyword_match', status: 'pass', durationMs: Date.now() - t, detail: 'llm not provided, used keyword' });
                 }
                 break;
@@ -496,7 +539,7 @@ export class CapmanEngine {
             case 'balanced':
             default: {
                 const t1 = Date.now();
-                const keywordResult = _match(query, this.manifest);
+                const keywordResult = _match(query, this.manifest, fuzzyOpts);
                 steps?.push({ type: 'keyword_match', status: 'pass', durationMs: Date.now() - t1, detail: `confidence: ${keywordResult.confidence}%` });
                 if (keywordResult.confidence >= this.threshold || !this.llm) {
                     matchResult = keywordResult;
@@ -509,7 +552,8 @@ export class CapmanEngine {
                         matchResult = keywordResult;
                     }
                     else {
-                        logger.info(`Low confidence (${keywordResult.confidence}%) — escalating to LLM`);
+                        logger.info(`Low keyword confidence (${keywordResult.confidence}%) — escalating to LLM`);
+                        logger.debug(`Query escalated to LLM: "${query}"`);
                         const t2 = Date.now();
                         try {
                             matchResult = await _matchWithLLM(query, this.manifest, { llm: this.llm });

package/dist/esm/generator.js

@@ -37,8 +37,23 @@ export function loadConfig(configPath) {
                 raw = mod.default ?? mod;
             }
             catch (err) {
+                const code = err.code;
+                const message = err instanceof Error ? err.message : String(err);
+                // ERR_REQUIRE_ESM — file is an ES module (Node v12–v21)
+                // On Node v22+, the error message changed but code remains ERR_REQUIRE_ESM
+                // for .mjs files; .js files in ESM packages may show a different message.
+                const isESM = code === 'ERR_REQUIRE_ESM' ||
+                    message.includes('require() of ES Module') ||
+                    message.includes('must use import to load ES Module');
+                if (isESM) {
+                    throw new Error(`Config file "${resolved}" is an ES module but capman requires CommonJS.\n` +
+                        `Solutions:\n` +
+                        `  1. Rename to capman.config.cjs\n` +
+                        `  2. Change to: module.exports = { ... }\n` +
+                        `  3. Remove "type": "module" from your package.json`);
+                }
                 throw new Error(`Failed to load config at ${resolved}:\n` +
-                    `  ${err instanceof Error ? err.message : String(err)}\n\n` +
+                    `  ${message}\n\n` +
                     `Check your config file for syntax errors.`);
             }
             // Catch invalid config structure

package/dist/esm/learning.d.ts

@@ -28,19 +28,31 @@ export interface LearningStore {
     }>>;
     /** Returns the live keyword index without rebuilding — O(1) */
     getIndex(): Promise<Record<string, Record<string, number>>>;
+    /**
+     * Removes this store from the exit flush registry and flushes any pending data.
+     * Call when the store is no longer needed to prevent memory leaks.
+     * Must be awaited — final flush is async.
+     */
+    destroy(): Promise<void>;
 }
 export declare class FileLearningStore implements LearningStore {
     private filePath;
     private entries;
-    private loaded;
+    private loadPromise;
     private saveQueue;
-    private index;
-    private statsCounter;
+    private learningIndex;
+    private dirty;
+    private saveTimer;
     constructor(filePath?: string);
-    private updateIndex;
-    private subtractFromIndex;
-    private rebuildIndex;
+    flushSync(): void;
+    /**
+     * Removes this store from the exit flush registry and cancels any pending save timer.
+     * Call when the store is no longer needed to prevent memory leaks in long-running servers.
+     */
+    destroy(): Promise<void>;
     private load;
+    private _doLoad;
+    private scheduleSave;
     private save;
     private _doSave;
     record(entry: LearningEntry): Promise<void>;
@@ -54,16 +66,14 @@ export declare class FileLearningStore implements LearningStore {
 }
 export declare class MemoryLearningStore implements LearningStore {
     private entries;
-    private index;
-    private statsCounter;
+    private learningIndex;
     record(entry: LearningEntry): Promise<void>;
     getStats(): Promise<KeywordStats>;
     getIndex(): Promise<Record<string, Record<string, number>>>;
-    private updateIndex;
-    private subtractFromIndex;
     getTopCapabilities(limit?: number): Promise<Array<{
         id: string;
         hits: number;
     }>>;
     clear(): Promise<void>;
+    destroy(): Promise<void>;
 }