@qase/mcp-server 1.1.8 → 2.0.1

package/build/cache/keys.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hash an API token into a stable, non-reversible tenant identifier.
+ *
+ * Why not raw tokens: tokens placed in Map keys land in heap snapshots, error
+ * dumps, and debug logs. A sha256 truncation gives us a stable key that is
+ * useless to anyone who sees it.
+ */
+export declare function hashToken(token: string): string;
+export interface CacheKeyParts {
+    host: string;
+    tenantId: string;
+    resource: string;
+    scope?: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Build a composite cache key:
+ *   v1:{host}:{tenantId}:{resource}:{scope}:{paramsJson}
+ *
+ * The `v1` prefix lets us wholesale-invalidate old entries on schema change.
+ * Params are JSON-stringified with sorted keys so equivalent param objects
+ * collapse to the same key.
+ */
+export declare function buildCacheKey(parts: CacheKeyParts): string;
+//# sourceMappingURL=keys.d.ts.map

package/build/cache/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/cache/keys.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAI1D"}

package/build/cache/keys.js

@@ -0,0 +1,36 @@
+import { createHash } from 'crypto';
+/**
+ * Hash an API token into a stable, non-reversible tenant identifier.
+ *
+ * Why not raw tokens: tokens placed in Map keys land in heap snapshots, error
+ * dumps, and debug logs. A sha256 truncation gives us a stable key that is
+ * useless to anyone who sees it.
+ */
+export function hashToken(token) {
+    if (!token) {
+        throw new Error('token must be non-empty');
+    }
+    return createHash('sha256').update(token).digest('hex').slice(0, 32);
+}
+/**
+ * Build a composite cache key:
+ *   v1:{host}:{tenantId}:{resource}:{scope}:{paramsJson}
+ *
+ * The `v1` prefix lets us wholesale-invalidate old entries on schema change.
+ * Params are JSON-stringified with sorted keys so equivalent param objects
+ * collapse to the same key.
+ */
+export function buildCacheKey(parts) {
+    const scope = parts.scope ?? '';
+    const params = parts.params ? stableStringify(parts.params) : '';
+    return `v1:${parts.host}:${parts.tenantId}:${parts.resource}:${scope}:${params}`;
+}
+function stableStringify(obj) {
+    const sortedKeys = Object.keys(obj).sort();
+    const pairs = {};
+    for (const k of sortedKeys) {
+        pairs[k] = obj[k];
+    }
+    return JSON.stringify(pairs);
+}
+//# sourceMappingURL=keys.js.map

package/build/cache/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/cache/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAUD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;AACnF,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/build/cache/layered.d.ts

@@ -0,0 +1,31 @@
+import { CacheBackend, InvalidationBus } from './types.js';
+/**
+ * Composite cache with L1 (process-local) + L2 (shared, typically Redis) and
+ * an InvalidationBus for cross-instance L1 coherence.
+ *
+ * Read: L1 → L2 → miss. L2 hits are promoted to L1 with the *remaining* TTL,
+ * not a fresh TTL — this prevents resurrecting near-expired data forever
+ * after a chain of L2→L1 promotions across a fleet.
+ *
+ * Write: parallel L1 + L2. Values written to L2 are wrapped in an envelope
+ * `{v, exp}` so `exp` (absolute time) survives TTL-bounded native storage
+ * and can be used to compute promotion TTL.
+ *
+ * Invalidation: local L1 + L2 delete, then `bus.publish(prefix)`. Other
+ * instances' subscribers evict the matching L1 entries.
+ */
+export declare class LayeredCache implements CacheBackend {
+    private readonly l1;
+    private readonly l2;
+    private readonly bus;
+    private readonly subscribeReady;
+    private readonly selfPublishing;
+    constructor(l1: CacheBackend, l2: CacheBackend, bus: InvalidationBus);
+    ready(): Promise<void>;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    deleteByPrefix(prefix: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=layered.d.ts.map

package/build/cache/layered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layered.d.ts","sourceRoot":"","sources":["../../src/cache/layered.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ3D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,YAAY;IAK7C,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAGjC,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,eAAe;IAQjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAc3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/build/cache/layered.js

@@ -0,0 +1,88 @@
+/**
+ * Composite cache with L1 (process-local) + L2 (shared, typically Redis) and
+ * an InvalidationBus for cross-instance L1 coherence.
+ *
+ * Read: L1 → L2 → miss. L2 hits are promoted to L1 with the *remaining* TTL,
+ * not a fresh TTL — this prevents resurrecting near-expired data forever
+ * after a chain of L2→L1 promotions across a fleet.
+ *
+ * Write: parallel L1 + L2. Values written to L2 are wrapped in an envelope
+ * `{v, exp}` so `exp` (absolute time) survives TTL-bounded native storage
+ * and can be used to compute promotion TTL.
+ *
+ * Invalidation: local L1 + L2 delete, then `bus.publish(prefix)`. Other
+ * instances' subscribers evict the matching L1 entries.
+ */
+export class LayeredCache {
+    l1;
+    l2;
+    bus;
+    subscribeReady;
+    selfPublishing = new Set();
+    constructor(l1, l2, bus) {
+        this.l1 = l1;
+        this.l2 = l2;
+        this.bus = bus;
+        this.subscribeReady = this.bus.subscribe((prefix) => {
+            if (this.selfPublishing.has(prefix))
+                return;
+            this.l1.deleteByPrefix(prefix).catch(() => { });
+        });
+    }
+    async ready() {
+        await this.subscribeReady;
+    }
+    async get(key) {
+        const fromL1 = await this.l1.get(key);
+        if (fromL1 !== undefined)
+            return fromL1;
+        const env = await this.l2.get(key);
+        if (env === undefined || env.v === undefined || env.exp === undefined)
+            return undefined;
+        const remaining = env.exp - Date.now();
+        if (remaining <= 0)
+            return undefined;
+        await this.l1.set(key, env.v, remaining);
+        return env.v;
+    }
+    async set(key, value, ttlMs) {
+        const envelope = { v: value, exp: Date.now() + ttlMs };
+        const results = await Promise.allSettled([
+            this.l1.set(key, value, ttlMs),
+            this.l2.set(key, envelope, ttlMs),
+        ]);
+        const l1Result = results[0];
+        if (l1Result.status === 'rejected')
+            throw l1Result.reason;
+    }
+    async delete(key) {
+        await Promise.allSettled([this.l1.delete(key), this.l2.delete(key)]);
+        this.selfPublishing.add(key);
+        try {
+            await this.bus.publish(key);
+        }
+        catch {
+            // Swallow — coherence drift is bounded by L1 TTL
+        }
+        finally {
+            this.selfPublishing.delete(key);
+        }
+    }
+    async deleteByPrefix(prefix) {
+        await Promise.allSettled([this.l1.deleteByPrefix(prefix), this.l2.deleteByPrefix(prefix)]);
+        this.selfPublishing.add(prefix);
+        try {
+            await this.bus.publish(prefix);
+        }
+        catch {
+            // Swallow
+        }
+        finally {
+            this.selfPublishing.delete(prefix);
+        }
+    }
+    async close() {
+        await Promise.allSettled([this.l1.close(), this.l2.close(), this.bus.close()]);
+    }
+}
+//# sourceMappingURL=layered.js.map

package/build/cache/layered.js.map

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

package/build/cache/memory.d.ts

@@ -0,0 +1,32 @@
+import { CacheBackend } from './types.js';
+export interface InMemoryCacheOptions {
+    /** Global cap across all tenants. */
+    maxEntries: number;
+    /** Per-tenant cap. Inferred from the 3rd segment of the key (`v1:host:tenantId:...`). */
+    maxPerTenant: number;
+    /** Optional periodic sweep interval for defensive cleanup. Default: 60 seconds. */
+    sweepIntervalMs?: number;
+}
+/**
+ * Process-local LRU cache with TTL and per-tenant cap.
+ *
+ * Tenant extraction: keys built by `buildCacheKey` have the shape
+ *   `v1:{host}:{tenantId}:{resource}:{scope}:{paramsJson}`
+ * We parse out `tenantId` to enforce per-tenant quotas without adding another
+ * indirection layer.
+ */
+export declare class InMemoryCache implements CacheBackend {
+    private readonly store;
+    private readonly perTenantCount;
+    private readonly maxPerTenant;
+    private readonly sweepTimer?;
+    constructor(opts: InMemoryCacheOptions);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    deleteByPrefix(prefix: string): Promise<void>;
+    close(): Promise<void>;
+    private sweep;
+    private decTenant;
+}
+//# sourceMappingURL=memory.d.ts.map

package/build/cache/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/cache/memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAOD;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAiC;gBAEjD,IAAI,EAAE,oBAAoB;IAwBhC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAe3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,SAAS;CAWlB"}

package/build/cache/memory.js

@@ -0,0 +1,108 @@
+import { LRUCache } from 'lru-cache';
+import { getMetrics } from './metrics.js';
+/**
+ * Process-local LRU cache with TTL and per-tenant cap.
+ *
+ * Tenant extraction: keys built by `buildCacheKey` have the shape
+ *   `v1:{host}:{tenantId}:{resource}:{scope}:{paramsJson}`
+ * We parse out `tenantId` to enforce per-tenant quotas without adding another
+ * indirection layer.
+ */
+export class InMemoryCache {
+    store;
+    perTenantCount = new Map();
+    maxPerTenant;
+    sweepTimer;
+    constructor(opts) {
+        this.maxPerTenant = opts.maxPerTenant;
+        this.store = new LRUCache({
+            max: opts.maxEntries,
+            dispose: (_value, key, reason) => {
+                // Decrement on every disposal reason except overwrite ('set'):
+                // - 'evict' → LRU global cap exceeded, entry removed from a different tenant's pressure
+                // - 'delete' → explicit delete()/deleteByPrefix()
+                // - 'expire' → lru-cache's own TTL (we don't use it but it's still possible)
+                // - 'fetch' → we don't use fetchMethod, but cover for completeness
+                // - 'set' → overwrite: old value disposed, but key still exists with new value, count unchanged
+                if (reason !== 'set') {
+                    this.decTenant(key);
+                }
+            },
+        });
+        const sweepMs = opts.sweepIntervalMs ?? 60_000;
+        if (sweepMs > 0) {
+            this.sweepTimer = setInterval(() => this.sweep(), sweepMs);
+            this.sweepTimer.unref?.();
+        }
+    }
+    async get(key) {
+        const entry = this.store.get(key);
+        if (!entry) {
+            getMetrics().incCounter('qase_mcp_cache_misses_total', { tier: 'l1' });
+            return undefined;
+        }
+        if (entry.expiresAt <= Date.now()) {
+            this.store.delete(key);
+            getMetrics().incCounter('qase_mcp_cache_misses_total', { tier: 'l1' });
+            return undefined;
+        }
+        getMetrics().incCounter('qase_mcp_cache_hits_total', { tier: 'l1' });
+        return entry.value;
+    }
+    async set(key, value, ttlMs) {
+        const existed = this.store.has(key);
+        const tenant = extractTenantId(key);
+        if (!existed && tenant) {
+            const current = this.perTenantCount.get(tenant) ?? 0;
+            if (current >= this.maxPerTenant) {
+                return; // silently drop — tenant is at quota
+            }
+            this.perTenantCount.set(tenant, current + 1);
+        }
+        this.store.set(key, { value, expiresAt: Date.now() + ttlMs });
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async deleteByPrefix(prefix) {
+        for (const key of this.store.keys()) {
+            if (key.startsWith(prefix)) {
+                this.store.delete(key);
+            }
+        }
+    }
+    async close() {
+        if (this.sweepTimer)
+            clearInterval(this.sweepTimer);
+        this.store.clear();
+        this.perTenantCount.clear();
+    }
+    sweep() {
+        const now = Date.now();
+        for (const [key, entry] of this.store.entries()) {
+            if (entry.expiresAt <= now) {
+                this.store.delete(key);
+            }
+        }
+    }
+    decTenant(key) {
+        const tenant = extractTenantId(key);
+        if (!tenant)
+            return;
+        const current = this.perTenantCount.get(tenant);
+        if (!current)
+            return;
+        if (current <= 1) {
+            this.perTenantCount.delete(tenant);
+        }
+        else {
+            this.perTenantCount.set(tenant, current - 1);
+        }
+    }
+}
+function extractTenantId(key) {
+    // key: v1:{host}:{tenantId}:...
+    const parts = key.split(':');
+    return parts.length >= 3 ? parts[2] : undefined;
+}
+//# sourceMappingURL=memory.js.map

package/build/cache/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/cache/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAgB1C;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IACP,KAAK,CAA0B;IAC/B,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,YAAY,CAAS;IACrB,UAAU,CAAkC;IAE7D,YAAY,IAA0B;QACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAgB;YACvC,GAAG,EAAE,IAAI,CAAC,UAAU;YACpB,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;gBAC/B,+DAA+D;gBAC/D,wFAAwF;gBACxF,kDAAkD;gBAClD,6EAA6E;gBAC7E,mEAAmE;gBACnE,gGAAgG;gBAChG,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;oBACrB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC;QAC/C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YAC3D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,UAAU,EAAE,CAAC,UAAU,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,UAAU,EAAE,CAAC,UAAU,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,UAAU,EAAE,CAAC,UAAU,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAa;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACjC,OAAO,CAAC,qCAAqC;YAC/C,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,UAAU;YAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAEO,KAAK;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,GAAW;QAC3B,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,gCAAgC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/build/cache/metrics.d.ts

@@ -0,0 +1,31 @@
+type Labels = Record<string, string>;
+/**
+ * Minimal, dependency-free metrics registry.
+ *
+ * Supports Prometheus text-format rendering. Designed for a small fixed set
+ * of metrics (cache hits/misses/errors, CB state, entry gauges); not a
+ * general-purpose replacement for prom-client.
+ */
+export declare class Metrics {
+    private readonly defs;
+    private readonly counters;
+    private readonly gauges;
+    registerCounter(name: string, help: string): void;
+    registerGauge(name: string, help: string): void;
+    incCounter(name: string, labels: Labels, by?: number): void;
+    getCounter(name: string, labels: Labels): number;
+    setGauge(name: string, labels: Labels, value: number): void;
+    getGauge(name: string, labels: Labels): number;
+    /**
+     * Render all registered metrics as Prometheus exposition text.
+     * Series from unregistered metric names are rendered too (with no HELP/TYPE
+     * lines) — this keeps `incCounter` safe to call even before `registerCounter`.
+     */
+    renderPrometheus(): string;
+    private seriesKey;
+}
+export declare function getMetrics(): Metrics;
+/** @internal — used by tests to reset the registry. */
+export declare function resetMetricsForTest(): void;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/build/cache/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/cache/metrics.ts"],"names":[],"mappings":"AAEA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAOrC;;;;;;GAMG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAEjE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,IAAI;IAQtD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9C;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IAqB1B,OAAO,CAAC,SAAS;CAOlB;AAOD,wBAAgB,UAAU,IAAI,OAAO,CAMpC;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/build/cache/metrics.js

@@ -0,0 +1,95 @@
+import { formatLabels } from './prom-format.js';
+/**
+ * Minimal, dependency-free metrics registry.
+ *
+ * Supports Prometheus text-format rendering. Designed for a small fixed set
+ * of metrics (cache hits/misses/errors, CB state, entry gauges); not a
+ * general-purpose replacement for prom-client.
+ */
+export class Metrics {
+    defs = new Map();
+    counters = new Map();
+    gauges = new Map();
+    registerCounter(name, help) {
+        this.defs.set(name, { help, type: 'counter' });
+        if (!this.counters.has(name))
+            this.counters.set(name, new Map());
+    }
+    registerGauge(name, help) {
+        this.defs.set(name, { help, type: 'gauge' });
+        if (!this.gauges.has(name))
+            this.gauges.set(name, new Map());
+    }
+    incCounter(name, labels, by = 1) {
+        const series = this.counters.get(name) ??
+            this.counters.set(name, new Map()).get(name);
+        const key = this.seriesKey(labels);
+        series.set(key, (series.get(key) ?? 0) + by);
+    }
+    getCounter(name, labels) {
+        return this.counters.get(name)?.get(this.seriesKey(labels)) ?? 0;
+    }
+    setGauge(name, labels, value) {
+        const series = this.gauges.get(name) ?? this.gauges.set(name, new Map()).get(name);
+        series.set(this.seriesKey(labels), value);
+    }
+    getGauge(name, labels) {
+        return this.gauges.get(name)?.get(this.seriesKey(labels)) ?? 0;
+    }
+    /**
+     * Render all registered metrics as Prometheus exposition text.
+     * Series from unregistered metric names are rendered too (with no HELP/TYPE
+     * lines) — this keeps `incCounter` safe to call even before `registerCounter`.
+     */
+    renderPrometheus() {
+        const lines = [];
+        const emit = (name, series, type) => {
+            const def = this.defs.get(name);
+            if (def) {
+                lines.push(`# HELP ${name} ${def.help}`);
+                lines.push(`# TYPE ${name} ${type}`);
+            }
+            for (const [labelKey, val] of series.entries()) {
+                const labels = labelKey ? JSON.parse(labelKey) : {};
+                lines.push(`${name}${formatLabels(labels)} ${val}`);
+            }
+        };
+        for (const [name, series] of this.counters.entries())
+            emit(name, series, 'counter');
+        for (const [name, series] of this.gauges.entries())
+            emit(name, series, 'gauge');
+        return lines.join('\n') + '\n';
+    }
+    seriesKey(labels) {
+        const keys = Object.keys(labels);
+        if (keys.length === 0)
+            return '';
+        const sorted = {};
+        for (const k of keys.sort())
+            sorted[k] = labels[k];
+        return JSON.stringify(sorted);
+    }
+}
+/**
+ * Process-wide singleton accessor. Reset only from tests.
+ */
+let instance = null;
+export function getMetrics() {
+    if (!instance) {
+        instance = new Metrics();
+        registerDefaults(instance);
+    }
+    return instance;
+}
+/** @internal — used by tests to reset the registry. */
+export function resetMetricsForTest() {
+    instance = null;
+}
+function registerDefaults(m) {
+    m.registerCounter('qase_mcp_cache_hits_total', 'Cache hits by tier (l1 or l2)');
+    m.registerCounter('qase_mcp_cache_misses_total', 'Cache misses by tier');
+    m.registerCounter('qase_mcp_cache_errors_total', 'Cache errors by tier');
+    m.registerGauge('qase_mcp_cache_entries', 'Current cache entries by tier');
+    m.registerGauge('qase_mcp_circuit_breaker_state', 'Circuit breaker state (0=closed, 1=half_open, 2=open) by name');
+}
+//# sourceMappingURL=metrics.js.map

package/build/cache/metrics.js.map

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

package/build/cache/prom-format.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Render a label object into the Prometheus `{k="v",…}` format.
+ * Label values are escaped per the Prometheus text format spec:
+ *   `\` → `\\`, `"` → `\"`, `\n` → `\n`.
+ */
+export declare function formatLabels(labels: Record<string, string>): string;
+//# sourceMappingURL=prom-format.d.ts.map

package/build/cache/prom-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prom-format.d.ts","sourceRoot":"","sources":["../../src/cache/prom-format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKnE"}

package/build/cache/prom-format.js

@@ -0,0 +1,16 @@
+/**
+ * Render a label object into the Prometheus `{k="v",…}` format.
+ * Label values are escaped per the Prometheus text format spec:
+ *   `\` → `\\`, `"` → `\"`, `\n` → `\n`.
+ */
+export function formatLabels(labels) {
+    const keys = Object.keys(labels);
+    if (keys.length === 0)
+        return '';
+    const parts = keys.sort().map((k) => `${k}="${escapeLabelValue(labels[k])}"`);
+    return `{${parts.join(',')}}`;
+}
+function escapeLabelValue(v) {
+    return v.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+}
+//# sourceMappingURL=prom-format.js.map

package/build/cache/prom-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prom-format.js","sourceRoot":"","sources":["../../src/cache/prom-format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9E,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC7E,CAAC"}

package/build/cache/redis-bus.d.ts

@@ -0,0 +1,29 @@
+import { InvalidationBus } from './types.js';
+export interface RedisLikePub {
+    publish(channel: string, message: string): Promise<number>;
+    quit(): Promise<'OK'>;
+}
+export interface RedisLikeSub {
+    subscribe(channel: string): Promise<number>;
+    on(event: 'message', handler: (channel: string, message: string) => void): this;
+    quit(): Promise<'OK'>;
+}
+/**
+ * InvalidationBus over Redis Pub/Sub.
+ *
+ * Message format: `{"pattern":"..."}` (JSON). Malformed messages are dropped
+ * silently — we never throw on receive so a single bad publisher cannot
+ * poison the bus for every subscriber.
+ */
+export declare class RedisInvalidationBus implements InvalidationBus {
+    private readonly pub;
+    private readonly sub;
+    private readonly channel;
+    private handlers;
+    private subscribed;
+    constructor(pub: RedisLikePub, sub: RedisLikeSub, channel: string);
+    publish(prefix: string): Promise<void>;
+    subscribe(handler: (pattern: string) => void): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=redis-bus.d.ts.map

package/build/cache/redis-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-bus.d.ts","sourceRoot":"","sources":["../../src/cache/redis-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAChF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAKxD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,UAAU,CAAS;gBAGR,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM;IAG5B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/build/cache/redis-bus.js

@@ -0,0 +1,50 @@
+/**
+ * InvalidationBus over Redis Pub/Sub.
+ *
+ * Message format: `{"pattern":"..."}` (JSON). Malformed messages are dropped
+ * silently — we never throw on receive so a single bad publisher cannot
+ * poison the bus for every subscriber.
+ */
+export class RedisInvalidationBus {
+    pub;
+    sub;
+    channel;
+    handlers = [];
+    subscribed = false;
+    constructor(pub, sub, channel) {
+        this.pub = pub;
+        this.sub = sub;
+        this.channel = channel;
+    }
+    async publish(prefix) {
+        const env = { pattern: prefix };
+        await this.pub.publish(this.channel, JSON.stringify(env));
+    }
+    async subscribe(handler) {
+        this.handlers.push(handler);
+        if (this.subscribed)
+            return;
+        this.subscribed = true;
+        this.sub.on('message', (channel, message) => {
+            if (channel !== this.channel)
+                return;
+            let env;
+            try {
+                env = JSON.parse(message);
+            }
+            catch {
+                return;
+            }
+            if (typeof env?.pattern !== 'string')
+                return;
+            for (const h of this.handlers)
+                h(env.pattern);
+        });
+        await this.sub.subscribe(this.channel);
+    }
+    async close() {
+        this.handlers = [];
+        await Promise.allSettled([this.pub.quit(), this.sub.quit()]);
+    }
+}
+//# sourceMappingURL=redis-bus.js.map

package/build/cache/redis-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-bus.js","sourceRoot":"","sources":["../../src/cache/redis-bus.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAKZ;IACA;IACA;IANX,QAAQ,GAAqC,EAAE,CAAC;IAChD,UAAU,GAAG,KAAK,CAAC;IAE3B,YACmB,GAAiB,EACjB,GAAiB,EACjB,OAAe;QAFf,QAAG,GAAH,GAAG,CAAc;QACjB,QAAG,GAAH,GAAG,CAAc;QACjB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,MAAM,GAAG,GAAyB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACtD,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAkC;QAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;YAC1C,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrC,IAAI,GAAyB,CAAC;YAC9B,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ;gBAAE,OAAO;YAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ;gBAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}