capman 0.5.1 → 0.5.3

package/dist/cjs/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":";;;AAoGA,wCAQC;AAED,4CAQC;AAtHD,6BAAuB;AAEvB,iFAAiF;AAEjF,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAS,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACxD,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IAC/D,QAAQ,EAAK,OAAC,CAAC,OAAO,EAAE;IACxB,MAAM,EAAO,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnE,OAAO,EAAM,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvE,CAAC,CAAA;AAEF,iFAAiF;AAEjF,MAAM,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QAC1B,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,EAAI,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;QACtD,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;CAChD,CAAC,CAAA;AAEF,MAAM,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAS,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6BAA6B,CAAC;IAC7D,IAAI,EAAS,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA;AAEF,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,GAAG,EAAE,OAAC,CAAC,MAAM,CAAC;QACZ,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YAC1B,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YACzD,IAAI,EAAI,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACvC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KACX,CAAC;IACF,GAAG,EAAE,OAAC,CAAC,MAAM,CAAC;QACZ,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,EAAS,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnC,CAAC;CACH,CAAC,CAAA;AAEF,MAAM,cAAc,GAAG,OAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAClD,iBAAiB;IACjB,iBAAiB;IACjB,oBAAoB;CACrB,CAAC,CAAA;AAEF,iFAAiF;AAEjF,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,EAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAA;AAEF,iFAAiF;AAEjF,MAAM,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAW,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SAC7C,KAAK,CAAC,cAAc,EAAE,8DAA8D,CAAC;IACnG,IAAI,EAAS,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6BAA6B,CAAC;IAC7D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,kEAAkE,CAAC;IACnG,QAAQ,EAAK,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAO,OAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IAC3C,OAAO,EAAM,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;IAChC,QAAQ,EAAK,cAAc;IAC3B,OAAO,EAAM,kBAAkB;CAChC,CAAC,CAAA;AAEF,iFAAiF;AAEpE,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,GAAG,EAAW,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC;IACvD,OAAO,EAAO,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;IACtE,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;SACxB,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;SAC7C,MAAM,CACL,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,EACzD,+BAA+B,CAChC;CAChB,CAAC,CAAA;AAEF,iFAAiF;AAEpE,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAO,OAAC,CAAC,MAAM,EAAE;IACxB,GAAG,EAAW,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/C,CAAC,CAAA;AASF,SAAgB,cAAc,CAAC,MAAe;IAC5C,MAAM,MAAM,GAAG,0BAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACnD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACzC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CACrC,CAAA;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AACjC,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAiB;IAChD,MAAM,MAAM,GAAG,sBAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IACjD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACzC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CACrC,CAAA;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AACjC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types.d.ts

@@ -134,4 +134,5 @@ export interface ExplainResult {
     resolvedVia: 'keyword' | 'llm';
     durationMs: number;
 }
+export type MatchMode = 'cheap' | 'balanced' | 'accurate';
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/cjs/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.5.1";
+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.1';
+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>;
@@ -47,5 +48,7 @@ export declare class ComboCache implements CacheStore {
     get(key: string, ttlMs?: number): Promise<CacheEntry | null>;
     set(key: string, result: MatchResult): Promise<void>;
     clear(): Promise<void>;
+    /** Returns the file-side entry count, not total unique entries across both stores.
+     *  Memory may have additional promoted entries not reflected here. */
     size(): Promise<number>;
 }

package/dist/esm/cache.js

@@ -66,19 +66,37 @@ 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();
-        this.filePath = path.resolve(process.cwd(), filePath);
+        const cwd = process.cwd();
+        const resolved = path.resolve(cwd, filePath);
+        const allowedPrefix = cwd === '/' ? '/' : cwd + path.sep;
+        if (!resolved.startsWith(allowedPrefix)) {
+            throw new Error(`FileCache path "${filePath}" resolves outside the working directory.\n` +
+                `Resolved: ${resolved}\nAllowed:  ${cwd}`);
+        }
+        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);
             if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-                this.store = new Map(Object.entries(parsed));
+                // Normalize keys on load — prevents duplicate entries from older versions,
+                // manual edits, or any path that bypassed normalizeQuery() on write.
+                // e.g. "Show me articles" and "show me articles" collapse to the same key.
+                const normalized = new Map();
+                for (const [k, v] of Object.entries(parsed)) {
+                    normalized.set(normalizeQuery(k), v);
+                }
+                this.store = normalized;
                 logger.debug(`File cache loaded: ${this.store.size} entries`);
             }
             else {
@@ -88,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());
@@ -98,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)}`);
@@ -107,20 +126,21 @@ export class FileCache {
     async get(key, ttlMs) {
         await this.load();
         const entry = this.store.get(key);
-        if (entry) {
-            if (ttlMs && Date.now() - new Date(entry.cachedAt).getTime() > ttlMs) {
-                this.store.delete(key);
-                await this.save();
-                logger.debug(`Cache entry expired (file): "${key}"`);
-                return null;
-            }
-            entry.hits++;
+        if (!entry)
+            return null;
+        if (ttlMs && Date.now() - new Date(entry.cachedAt).getTime() > ttlMs) {
             this.store.delete(key);
-            this.store.set(key, entry);
-            logger.debug(`Cache hit (file): "${key}"`);
-            await this.save();
+            await this.save(); // eviction must be persisted
+            logger.debug(`Cache entry expired (file): "${key}"`);
+            return null;
         }
-        return entry ?? null;
+        entry.hits++;
+        this.store.delete(key); // reinsert at end for LRU ordering
+        this.store.set(key, entry);
+        // hits counter is in-memory only — not saved on read
+        // saves only happen on set() and eviction to avoid full file rewrite per request
+        logger.debug(`Cache hit (file): "${key}"`);
+        return entry;
     }
     async set(key, result) {
         await this.load();
@@ -178,6 +198,8 @@ export class ComboCache {
             this.file.clear(),
         ]);
     }
+    /** Returns the file-side entry count, not total unique entries across both stores.
+     *  Memory may have additional promoted entries not reflected here. */
     async size() {
         return this.file.size();
     }

package/dist/esm/engine.d.ts

@@ -3,7 +3,7 @@ import type { LLMMatcherOptions } from './matcher';
 import type { ResolveOptions, AuthContext } from './resolver';
 import type { CacheStore } from './cache';
 import type { LearningStore } from './learning';
-import type { MatchMode } from './index';
+import type { MatchMode } from './types';
 /**
  * Options for constructing a CapmanEngine instance.
  *
@@ -93,6 +93,8 @@ export interface EngineResult {
     trace: ExecutionTrace;
 }
 export declare class CapmanEngine {
+    /** Maximum allowed query length in characters. Queries exceeding this throw RangeError. */
+    static readonly MAX_QUERY_LENGTH = 1000;
     private manifest;
     private mode;
     private llm?;

package/dist/esm/engine.js

@@ -1,4 +1,4 @@
-import { match as _match, matchWithLLM as _matchWithLLM, resolverToIntent, extractParams, STOPWORDS } from './matcher';
+import { match as _match, matchWithLLM as _matchWithLLM, resolverToIntent, extractParams, STOPWORDS, LLMParseError } from './matcher';
 import { resolve as _resolve } from './resolver';
 import { MemoryLearningStore } from './learning';
 import { logger } from './logger';
@@ -24,7 +24,7 @@ export class CapmanEngine {
         this.maxLLMCallsPerMinute = options.maxLLMCallsPerMinute ?? 60;
         this.llmCooldownMs = options.llmCooldownMs ?? 0;
         this.llmCircuitBreakerThreshold = options.llmCircuitBreakerThreshold ?? 3;
-        this.llmCircuitBreakerResetMs = options.llmCircuitBreakerResetMs ?? 60000;
+        this.llmCircuitBreakerResetMs = options.llmCircuitBreakerResetMs ?? 60_000;
         // 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,14 +37,22 @@ 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 ─────────────────────────────────
-        const manifestMajorMinor = options.manifest.version?.split('.').slice(0, 2).join('.');
-        const engineMajorMinor = VERSION.split('.').slice(0, 2).join('.');
-        if (manifestMajorMinor && manifestMajorMinor !== engineMajorMinor) {
-            // Use console.warn directly — must be visible regardless of logger level
-            // Default log level is 'silent' so logger.warn would never be seen
-            console.warn(`[capman] Manifest version "${options.manifest.version}" was generated with a ` +
-                `different engine version than "${VERSION}". If you experience matching issues, ` +
-                `regenerate with: npx capman generate`);
+        if (options.manifest.version) {
+            const SEMVER_RE = /^\d+\.\d+\.\d+$/;
+            if (SEMVER_RE.test(options.manifest.version) && SEMVER_RE.test(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`);
+                }
+            }
+            else if (options.manifest.version !== VERSION) {
+                //console.warn is used instead of logger.warn to avoid the warning being logged to the console
+                console.warn(`[capman] Manifest version "${options.manifest.version}" could not be compared ` +
+                    `to engine version "${VERSION}" — version strings are not valid semver.`);
+            }
         }
     }
     /**
@@ -59,6 +67,12 @@ export class CapmanEngine {
      * console.log(result.resolvedVia)           // 'keyword' | 'llm' | 'cache'
      */
     async ask(query, overrides = {}) {
+        if (!query || typeof query !== 'string') {
+            throw new TypeError('query must be a non-empty string');
+        }
+        if (query.length > CapmanEngine.MAX_QUERY_LENGTH) {
+            throw new RangeError(`query exceeds maximum length of ${CapmanEngine.MAX_QUERY_LENGTH} characters`);
+        }
         const start = Date.now();
         const steps = [];
         // ── Step 1: Check cache ──────────────────────────────────────────────────
@@ -68,8 +82,20 @@ 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}"`);
-                const resolution = await _resolve(cached.result, cached.result.extractedParams, this.resolveOptions(overrides));
+                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' }
+                //      User B: "show orders for jane" → must get { customer: 'jane' }, not john's
+                const freshParams = cached.result.capability
+                    ? extractParams(query, cached.result.capability)
+                    : {};
+                const matchWithFreshParams = {
+                    ...cached.result,
+                    extractedParams: freshParams,
+                };
+                const resolution = await _resolve(matchWithFreshParams, freshParams, this.resolveOptions(overrides));
                 const trace = {
                     query,
                     candidates: cached.result.candidates,
@@ -79,13 +105,13 @@ export class CapmanEngine {
                     totalMs: Date.now() - start,
                 };
                 const result = {
-                    match: cached.result,
+                    match: matchWithFreshParams,
                     resolution,
                     resolvedVia: 'cache',
                     durationMs: Date.now() - start,
                     trace,
                 };
-                await this.recordLearning(query, cached.result, 'cache');
+                await this.recordLearning(query, matchWithFreshParams, 'cache');
                 return result;
             }
             steps.push({ type: 'cache_check', status: 'miss', durationMs: Date.now() - cacheStart });
@@ -108,15 +134,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({
@@ -125,6 +143,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) {
@@ -213,9 +241,21 @@ export class CapmanEngine {
      * console.log(explanation.candidates)
      */
     async explain(query) {
+        if (!query || typeof query !== 'string') {
+            throw new TypeError('query must be a non-empty string');
+        }
+        if (query.length > CapmanEngine.MAX_QUERY_LENGTH) {
+            throw new RangeError(`query exceeds maximum length of ${CapmanEngine.MAX_QUERY_LENGTH} characters`);
+        }
         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);
@@ -261,12 +301,17 @@ export class CapmanEngine {
         }
         reasoning.push(`Resolved via: ${resolvedVia}`);
         if (matchResult.extractedParams && Object.keys(matchResult.extractedParams).length) {
-            const params = Object.entries(matchResult.extractedParams)
+            const extracted = Object.entries(matchResult.extractedParams)
                 .filter(([, v]) => v !== null)
                 .map(([k, v]) => `${k}=${v}`)
                 .join(', ');
-            if (params)
-                reasoning.push(`Would extract params: ${params}`);
+            const session = matchResult.capability?.params
+                .filter(p => p.source === 'session')
+                .map(p => `${p.name}=[from auth]`)
+                .join(', ');
+            const parts = [extracted, session].filter(Boolean).join(', ');
+            if (parts)
+                reasoning.push(`Would extract params: ${parts}`);
         }
         // ── Build wouldExecute ───────────────────────────────────────────────────
         const cap = matchResult.capability;
@@ -299,7 +344,7 @@ export class CapmanEngine {
                     let path = endpoint.path;
                     for (const [k, v] of Object.entries(params)) {
                         if (v)
-                            path = path.replace(`{${k}}`, v);
+                            path = path.replaceAll(`{${k}}`, v);
                     }
                     const base = this.baseUrl ?? '';
                     action = `${endpoint.method} ${base}${path}`;
@@ -308,7 +353,7 @@ export class CapmanEngine {
                     let dest = cap.resolver.destination;
                     for (const [k, v] of Object.entries(params)) {
                         if (v)
-                            dest = dest.replace(`{${k}}`, v);
+                            dest = dest.replaceAll(`{${k}}`, v);
                     }
                     action = `navigate → ${dest}`;
                 }
@@ -318,12 +363,12 @@ export class CapmanEngine {
                     let path = endpoint.path;
                     for (const [k, v] of Object.entries(params)) {
                         if (v)
-                            path = path.replace(`{${k}}`, v);
+                            path = path.replaceAll(`{${k}}`, v);
                     }
                     let dest = hybrid.nav.destination;
                     for (const [k, v] of Object.entries(params)) {
                         if (v)
-                            dest = dest.replace(`{${k}}`, v);
+                            dest = dest.replaceAll(`{${k}}`, v);
                     }
                     const base = this.baseUrl ?? '';
                     action = `${endpoint.method} ${base}${path} + navigate → ${dest}`;
@@ -372,13 +417,13 @@ export class CapmanEngine {
         }
         // ── Per-minute rate limit ────────────────────────────────────────────────
         const windowElapsed = now - this.llmWindowStart;
-        if (windowElapsed >= 60000) {
+        if (windowElapsed >= 60_000) {
             this.llmCallsThisMinute = 0;
             this.llmWindowStart = now;
         }
         if (this.llmCallsThisMinute >= this.maxLLMCallsPerMinute) {
             // Recalculate elapsed after possible window reset above
-            const resetIn = Math.ceil((60000 - (now - this.llmWindowStart)) / 1000);
+            const resetIn = Math.ceil((60_000 - (now - this.llmWindowStart)) / 1000);
             return `rate limit reached (${this.maxLLMCallsPerMinute}/min) — resets in ${Math.max(0, resetIn)}s`;
         }
         // Reserve the slot atomically before the call happens
@@ -432,10 +477,21 @@ export class CapmanEngine {
                             matchResult = await _matchWithLLM(query, this.manifest, { llm: this.llm });
                             this.recordLLMSuccess();
                             resolvedVia = 'llm';
+                            // Merge keyword scores into LLM candidates so boost has real signal for alternatives
+                            const kwResult = _match(query, this.manifest);
+                            matchResult = {
+                                ...matchResult,
+                                candidates: matchResult.candidates.map(c => ({
+                                    ...c,
+                                    score: c.matched
+                                        ? c.score // keep LLM confidence for winner
+                                        : (kwResult.candidates.find(kc => kc.capabilityId === c.capabilityId)?.score ?? 0),
+                                })),
+                            };
                             steps?.push({ type: 'llm_match', status: 'pass', durationMs: Date.now() - t, detail: `confidence: ${matchResult.confidence}%` });
                         }
                         catch (err) {
-                            const isParseError = String(err).startsWith('LLM_PARSE_ERROR');
+                            const isParseError = err instanceof LLMParseError;
                             if (!isParseError)
                                 this.recordLLMFailure();
                             logger.warn(`LLM call failed — falling back to keyword: ${err instanceof Error ? err.message : String(err)}`);
@@ -470,16 +526,27 @@ 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 });
                             this.recordLLMSuccess();
                             resolvedVia = 'llm';
+                            // keywordResult already computed above in balanced mode — merge scores
+                            matchResult = {
+                                ...matchResult,
+                                candidates: matchResult.candidates.map(c => ({
+                                    ...c,
+                                    score: c.matched
+                                        ? c.score
+                                        : (keywordResult.candidates.find(kc => kc.capabilityId === c.capabilityId)?.score ?? 0),
+                                })),
+                            };
                             steps?.push({ type: 'llm_match', status: 'pass', durationMs: Date.now() - t2, detail: `confidence: ${matchResult.confidence}%` });
                         }
                         catch (err) {
-                            const isParseError = String(err).startsWith('LLM_PARSE_ERROR');
+                            const isParseError = err instanceof LLMParseError;
                             if (!isParseError)
                                 this.recordLLMFailure();
                             logger.warn(`LLM call failed — falling back to keyword: ${err instanceof Error ? err.message : String(err)}`);
@@ -594,3 +661,5 @@ export class CapmanEngine {
         });
     }
 }
+/** Maximum allowed query length in characters. Queries exceeding this throw RangeError. */
+CapmanEngine.MAX_QUERY_LENGTH = 1000;

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/index.d.ts

@@ -3,6 +3,7 @@ export type { LogLevel } from './logger';
 export type { Capability, CapabilityParam, CapmanConfig, Manifest, MatchResult, ExecutionTrace, TraceStep, MatchCandidate, ResolveResult, ApiCallResult, ValidationResult, Resolver, ApiResolver, NavResolver, HybridResolver, PrivacyScope, ResolverType, HttpMethod, ExplainResult, ExplainCandidate, } from './types';
 export { generate, loadConfig, writeManifest, readManifest, validate, generateStarterConfig, } from './generator';
 export { match, matchWithLLM, extractParams, } from './matcher';
+export { LLMParseError } from './matcher';
 export type { LLMMatcherOptions } from './matcher';
 export { resolve } from './resolver';
 export type { ResolveOptions, AuthContext } from './resolver';
@@ -14,10 +15,10 @@ export { FileLearningStore, MemoryLearningStore } from './learning';
 export type { LearningStore, LearningEntry, KeywordStats } from './learning';
 export { parseOpenAPI } from './parser';
 export type { ParseResult } from './parser';
-import type { Manifest, MatchResult, ResolveResult } from './types';
+import type { Manifest, MatchResult, ResolveResult, MatchMode } from './types';
 import type { LLMMatcherOptions } from './matcher';
 import type { ResolveOptions } from './resolver';
-export type MatchMode = 'cheap' | 'balanced' | 'accurate';
+export type { MatchMode } from './types';
 export interface AskOptions extends ResolveOptions {
     llm?: LLMMatcherOptions['llm'];
     /**

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 export { setLogLevel } from './logger';
 export { generate, loadConfig, writeManifest, readManifest, validate, generateStarterConfig, } from './generator';
 export { match, matchWithLLM, extractParams, } from './matcher';
+export { LLMParseError } from './matcher';
 export { resolve } from './resolver';
 // ─── Engine (recommended API) ─────────────────────────────────────────────────
 export { CapmanEngine } from './engine';

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,17 +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;
-    private rebuildIndex;
     getTopCapabilities(limit?: number): Promise<Array<{
         id: string;
         hits: number;
     }>>;
     clear(): Promise<void>;
+    destroy(): Promise<void>;
 }