@debian777/kairos-mcp 3.0.1-beta.14

package/dist/services/redis-cache.js

@@ -0,0 +1,214 @@
+import { logger } from '../utils/logger.js';
+import { keyValueStore } from './key-value-store-factory.js';
+import { KAIROS_REDIS_PREFIX } from '../config.js';
+import { getSpaceIdFromStorage } from '../utils/tenant-context.js';
+export class RedisCacheService {
+    cachePrefix = 'search:';
+    invalidationChannel = 'cache:invalidation';
+    statsPrefix = 'stats:';
+    memoryPrefix = 'mem:';
+    constructor() {
+        logger.info('[RedisCacheService] Initialized with RedisService');
+    }
+    getCacheKey(query, limit, opts) {
+        const mode = opts && typeof opts.collapse === 'boolean' ? (opts.collapse ? 'collapsed' : 'natural') : 'collapsed';
+        return `${this.cachePrefix}${mode}:${query}:${limit}`;
+    }
+    async getSearchResult(query, limit, opts) {
+        try {
+            const key = this.getCacheKey(query, limit, opts);
+            const cached = await keyValueStore.getJson(key);
+            if (cached) {
+                logger.debug(`[RedisCacheService] Cache hit for query "${query}" limit ${limit}`);
+                await this.incrementHits();
+                return cached;
+            }
+            logger.debug(`[RedisCacheService] Cache miss for query "${query}" limit ${limit}`);
+            await this.incrementMisses();
+            return null;
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get search result from cache:', error);
+            return null;
+        }
+    }
+    async setSearchResult(query, limit, result, opts) {
+        try {
+            const key = this.getCacheKey(query, limit, opts);
+            const ttl = 300; // 5 minutes
+            const cachedResult = {
+                results: result.memories.map((memory, index) => ({
+                    uri: `kairos://mem/${memory.memory_uuid}`,
+                    label: memory.label,
+                    score: result.scores[index] ?? 0
+                }))
+            };
+            await keyValueStore.setJson(key, cachedResult, ttl);
+            logger.debug(`[RedisCacheService] Cached search result for query "${query}" limit ${limit}`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to set search result in cache:', error);
+        }
+    }
+    async invalidateSearchCache() {
+        try {
+            logger.info(`[RedisCacheService] Search cache invalidation requested`);
+            // Delete keys matching search cache pattern (all collapse modes)
+            const keys = await keyValueStore.keys(`${this.cachePrefix}*`);
+            if (!keys || keys.length === 0) {
+                logger.debug('[RedisCacheService] No search cache keys to delete');
+                // Still publish invalidation event even if no keys to delete
+                await this.publishInvalidation('search');
+                return;
+            }
+            // Keys returned are full Redis keys (prefix + spaceId + logicalKey); strip to get logicalKey for del()
+            const keyPrefix = `${KAIROS_REDIS_PREFIX}${getSpaceIdFromStorage()}:`;
+            const stripped = keys.map(k => k.startsWith(keyPrefix) ? k.slice(keyPrefix.length) : k);
+            await Promise.all(stripped.map(k => keyValueStore.del(k)));
+            logger.info(`[RedisCacheService] Invalidated ${stripped.length} search cache keys`);
+            // Publish invalidation event
+            await this.publishInvalidation('search');
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to invalidate search cache:', error);
+        }
+    }
+    // Remove cached memory by UUID (kb:<prefix>mem:{uuid})
+    async invalidateMemoryCache(uuid) {
+        try {
+            if (!uuid || typeof uuid !== 'string') {
+                logger.warn('[RedisCacheService] invalidateMemoryCache called with invalid uuid');
+                return;
+            }
+            const key = `${this.memoryPrefix}${uuid}`;
+            await keyValueStore.del(key);
+            logger.debug(`[RedisCacheService] Invalidated memory cache for UUID ${uuid}`);
+            // Publish invalidation event
+            await this.publishInvalidation('memory');
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to invalidate memory cache:', error);
+        }
+    }
+    async publishInvalidation(type) {
+        try {
+            const message = JSON.stringify({
+                type,
+                timestamp: Date.now()
+            });
+            const subscribers = await keyValueStore.publish(this.invalidationChannel, message);
+            logger.debug(`[RedisCacheService] Published invalidation event: ${type} to ${this.invalidationChannel} (${subscribers} subscribers notified)`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to publish invalidation:', error);
+        }
+    }
+    async incrementHits() {
+        try {
+            await keyValueStore.incr(`${this.statsPrefix}hits`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to increment hits:', error);
+        }
+    }
+    async incrementMisses() {
+        try {
+            await keyValueStore.incr(`${this.statsPrefix}misses`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to increment misses:', error);
+        }
+    }
+    async getCacheStats() {
+        try {
+            const [hits, misses] = await Promise.all([
+                keyValueStore.get(`${this.statsPrefix}hits`),
+                keyValueStore.get(`${this.statsPrefix}misses`)
+            ]);
+            return {
+                hits: parseInt(hits || '0', 10),
+                misses: parseInt(misses || '0', 10)
+            };
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get cache stats:', error);
+            return { hits: 0, misses: 0 };
+        }
+    }
+    // Memory resource caching methods
+    async getMemoryResource(uuid) {
+        try {
+            const key = `${this.memoryPrefix}${uuid}`;
+            const cached = await keyValueStore.getJson(key);
+            if (cached) {
+                logger.debug(`[RedisCacheService] Memory cache hit for UUID ${uuid}`);
+                return cached;
+            }
+            return null;
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get memory from cache:', error);
+            return null;
+        }
+    }
+    async setMemoryResource(memory) {
+        try {
+            const key = `${this.memoryPrefix}${memory.memory_uuid}`;
+            // Store memories without TTL (permanent storage)
+            await keyValueStore.setJson(key, memory);
+            logger.debug(`[RedisCacheService] Cached memory resource for UUID ${memory.memory_uuid} (no TTL)`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to cache memory resource:', error);
+        }
+    }
+    // Invalidate begin cache (kairos_begin tool results)
+    async invalidateBeginCache() {
+        try {
+            logger.info(`[RedisCacheService] Begin cache invalidation requested`);
+            // Delete keys matching begin cache pattern
+            const keys = await keyValueStore.keys('begin:*');
+            if (!keys || keys.length === 0) {
+                logger.debug('[RedisCacheService] No begin cache keys to delete');
+                return;
+            }
+            // Keys returned are full Redis keys (prefix + spaceId + logicalKey); strip to get logicalKey for del()
+            const keyPrefix = `${KAIROS_REDIS_PREFIX}${getSpaceIdFromStorage()}:`;
+            const stripped = keys.map(k => k.startsWith(keyPrefix) ? k.slice(keyPrefix.length) : k);
+            await Promise.all(stripped.map(k => keyValueStore.del(k)));
+            logger.info(`[RedisCacheService] Invalidated ${stripped.length} begin cache keys`);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to invalidate begin cache:', error);
+        }
+    }
+    // For atomic operations as per plan
+    // System is mostly read-heavy, so invalidate aggressively on writes
+    async invalidateAfterUpdate() {
+        logger.info('[RedisCacheService] Cache invalidation after Qdrant update - clearing all search and begin caches');
+        await Promise.all([
+            this.invalidateSearchCache(),
+            this.invalidateBeginCache()
+        ]);
+    }
+    // Generic get and set methods for arbitrary caching
+    async get(key) {
+        try {
+            return await keyValueStore.get(key);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to get from cache:', error);
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        try {
+            await keyValueStore.set(key, value, ttl);
+        }
+        catch (error) {
+            logger.error('[RedisCacheService] Failed to set in cache:', error);
+        }
+    }
+}
+export const redisCacheService = new RedisCacheService();
+//# sourceMappingURL=redis-cache.js.map

package/dist/services/redis-cache.js.map

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

package/dist/services/redis.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Redis Service for KAIROS persistence
+ *
+ * Provides Redis-based persistence for game data and other shared state.
+ * Uses configurable key prefix (default: 'kb:') via KAIROS_REDIS_PREFIX env var for isolation.
+ * Use keyValueStore from key-value-store-factory.js unless you need Redis-specific behavior.
+ */
+import type { IKeyValueStore } from './key-value-store.js';
+export declare class RedisService implements IKeyValueStore {
+    private client;
+    private readonly prefix;
+    private connected;
+    private readonly redisUrl;
+    constructor();
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    /** Key is namespaced by current space (AsyncLocalStorage) so cache and proof-of-work do not collide across spaces. */
+    private getKey;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    hget(hash: string, field: string): Promise<string | null>;
+    hset(hash: string, field: string, value: string): Promise<void>;
+    hgetall(hash: string): Promise<Record<string, string> | null>;
+    hsetall(hash: string, data: Record<string, string>): Promise<void>;
+    incr(key: string): Promise<number>;
+    exists(key: string): Promise<boolean>;
+    keys(pattern: string): Promise<string[]>;
+    /**
+     * Publish a message to a Redis channel (pub/sub)
+     * Note: Channel names are NOT prefixed to allow cross-instance communication
+     * @param channel Channel name to publish to
+     * @param message Message to publish
+     * @returns Number of subscribers that received the message
+     */
+    publish(channel: string, message: string): Promise<number>;
+    getJson<T>(key: string): Promise<T | null>;
+    setJson<T>(key: string, value: T, ttl?: number): Promise<void>;
+    hgetJson<T>(hash: string, field: string): Promise<T | null>;
+    hsetJson<T>(hash: string, field: string, value: T): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/services/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/services/redis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,qBAAa,YAAa,YAAW,cAAc;IAC/C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;;IAuD5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,sHAAsH;IACtH,OAAO,CAAC,MAAM;IAKR,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASzD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAS7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS9C;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW1C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW3D,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,WAAW,IAAI,OAAO;CAGzB"}

package/dist/services/redis.js

@@ -0,0 +1,234 @@
+/**
+ * Redis Service for KAIROS persistence
+ *
+ * Provides Redis-based persistence for game data and other shared state.
+ * Uses configurable key prefix (default: 'kb:') via KAIROS_REDIS_PREFIX env var for isolation.
+ * Use keyValueStore from key-value-store-factory.js unless you need Redis-specific behavior.
+ */
+import { createClient } from 'redis';
+import { logger } from '../utils/logger.js';
+import { REDIS_URL, KAIROS_REDIS_PREFIX } from '../config.js';
+import { getSpaceIdFromStorage } from '../utils/tenant-context.js';
+export class RedisService {
+    client;
+    prefix;
+    connected = false;
+    redisUrl;
+    constructor() {
+        const redisUrl = REDIS_URL;
+        this.redisUrl = redisUrl;
+        this.prefix = KAIROS_REDIS_PREFIX;
+        logger.debug(`[RedisService] Initializing with REDIS_URL="${redisUrl}" and KAIROS_REDIS_PREFIX="${this.prefix}"`);
+        this.client = createClient({
+            url: redisUrl
+        });
+        this.client.on('error', (err) => {
+            logger.error('Redis Client Error', err);
+            logger.debug(`[RedisService] Error details: ${err?.message || err} | code=${(err && err.code) || 'n/a'} ` +
+                `errno=${(err && err.errno) || 'n/a'} address=${(err && err.address) || 'n/a'} ` +
+                `port=${(err && err.port) || 'n/a'} target="${this.redisUrl}"`);
+            // If this is an AggregateError, log each inner error for deep diagnostics
+            const innerErrors = err && typeof err === 'object' && 'errors' in err ? err.errors : undefined;
+            if (Array.isArray(innerErrors) && innerErrors.length > 0) {
+                innerErrors.forEach((inner, index) => {
+                    logger.debug(`[RedisService] Inner error[${index}] code=${inner?.code || 'n/a'} ` +
+                        `errno=${inner?.errno || 'n/a'} address=${inner?.address || 'n/a'} ` +
+                        `port=${inner?.port || 'n/a'} message=${inner?.message || inner}`);
+                });
+            }
+        });
+        this.client.on('connect', () => {
+            logger.info('Connecting to Redis...');
+            logger.debug(`[RedisService] Attempting connection to ${redisUrl}`);
+        });
+        this.client.on('ready', () => {
+            logger.info('Redis client ready');
+            logger.debug('[RedisService] Redis client is ready and operational');
+            this.connected = true;
+        });
+        this.client.on('end', () => {
+            logger.info('Redis connection closed');
+            logger.debug('[RedisService] Redis connection ended');
+            this.connected = false;
+        });
+    }
+    async connect() {
+        if (!this.connected) {
+            logger.info(`[RedisService] connect() called, attempting connection to "${this.redisUrl}"`);
+            try {
+                await this.client.connect();
+            }
+            catch (error) {
+                logger.error(`[RedisService] connect() failed for "${this.redisUrl}"`, error);
+                throw error;
+            }
+        }
+    }
+    async disconnect() {
+        if (this.connected) {
+            await this.client.quit();
+        }
+    }
+    /** Key is namespaced by current space (AsyncLocalStorage) so cache and proof-of-work do not collide across spaces. */
+    getKey(key) {
+        const spaceId = getSpaceIdFromStorage();
+        return `${this.prefix}${spaceId}:${key}`;
+    }
+    async get(key) {
+        try {
+            return await this.client.get(this.getKey(key));
+        }
+        catch (error) {
+            logger.error(`Redis GET error for key ${key}:`, error);
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        try {
+            if (ttl) {
+                await this.client.setEx(this.getKey(key), ttl, value);
+            }
+            else {
+                await this.client.set(this.getKey(key), value);
+            }
+        }
+        catch (error) {
+            logger.error(`Redis SET error for key ${key}:`, error);
+        }
+    }
+    async del(key) {
+        try {
+            await this.client.del(this.getKey(key));
+        }
+        catch (error) {
+            logger.error(`Redis DEL error for key ${key}:`, error);
+        }
+    }
+    async hget(hash, field) {
+        try {
+            return await this.client.hGet(this.getKey(hash), field);
+        }
+        catch (error) {
+            logger.error(`Redis HGET error for hash ${hash} field ${field}:`, error);
+            return null;
+        }
+    }
+    async hset(hash, field, value) {
+        try {
+            await this.client.hSet(this.getKey(hash), field, value);
+        }
+        catch (error) {
+            logger.error(`Redis HSET error for hash ${hash} field ${field}:`, error);
+        }
+    }
+    async hgetall(hash) {
+        try {
+            return await this.client.hGetAll(this.getKey(hash));
+        }
+        catch (error) {
+            logger.error(`Redis HGETALL error for hash ${hash}:`, error);
+            return null;
+        }
+    }
+    async hsetall(hash, data) {
+        try {
+            await this.client.hSet(this.getKey(hash), data);
+        }
+        catch (error) {
+            logger.error(`Redis HSETALL error for hash ${hash}:`, error);
+        }
+    }
+    async incr(key) {
+        try {
+            return await this.client.incr(this.getKey(key));
+        }
+        catch (error) {
+            logger.error(`Redis INCR error for key ${key}:`, error);
+            return 0;
+        }
+    }
+    async exists(key) {
+        try {
+            const result = await this.client.exists(this.getKey(key));
+            return result === 1;
+        }
+        catch (error) {
+            logger.error(`Redis EXISTS error for key ${key}:`, error);
+            return false;
+        }
+    }
+    async keys(pattern) {
+        try {
+            return await this.client.keys(this.getKey(pattern));
+        }
+        catch (error) {
+            logger.error(`Redis KEYS error for pattern ${pattern}:`, error);
+            return [];
+        }
+    }
+    /**
+     * Publish a message to a Redis channel (pub/sub)
+     * Note: Channel names are NOT prefixed to allow cross-instance communication
+     * @param channel Channel name to publish to
+     * @param message Message to publish
+     * @returns Number of subscribers that received the message
+     */
+    async publish(channel, message) {
+        try {
+            const result = await this.client.publish(channel, message);
+            logger.debug(`[RedisService] Published message to channel "${channel}", ${result} subscribers notified`);
+            return result;
+        }
+        catch (error) {
+            logger.error(`Redis PUBLISH error for channel ${channel}:`, error);
+            return 0;
+        }
+    }
+    // Utility methods for JSON objects
+    async getJson(key) {
+        const value = await this.get(key);
+        if (!value)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            logger.error(`JSON parse error for key ${key}:`, error);
+            return null;
+        }
+    }
+    async setJson(key, value, ttl) {
+        try {
+            const jsonValue = JSON.stringify(value);
+            await this.set(key, jsonValue, ttl);
+        }
+        catch (error) {
+            logger.error(`JSON stringify error for key ${key}:`, error);
+        }
+    }
+    async hgetJson(hash, field) {
+        const value = await this.hget(hash, field);
+        if (!value)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            logger.error(`JSON parse error for hash ${hash} field ${field}:`, error);
+            return null;
+        }
+    }
+    async hsetJson(hash, field, value) {
+        try {
+            const jsonValue = JSON.stringify(value);
+            await this.hset(hash, field, jsonValue);
+        }
+        catch (error) {
+            logger.error(`JSON stringify error for hash ${hash} field ${field}:`, error);
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/services/redis.js.map

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

package/dist/services/stats/bonuses.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Implementation bonus core algorithms (statistical adjustments, rarity/comparative)
+ * These functions are pure/near-pure and operate on supplied data structures so the
+ * orchestrator can handle persistence and state mutation.
+ */
+import type { ModelImplementationData } from '../../types/index.js';
+export declare function calculateWilsonAdjustment(modelData: ModelImplementationData): number;
+/**
+ * Compute implementation bonus given a qualityMetrics object.
+ *
+ * This function mutates qualityMetrics to record attempts/successes for the specific model.
+ * It returns an object describing the awarded bonus and whether a "rare success" occurred.
+ *
+ * Parameters:
+ * - qualityMetrics: the QualityMetrics object from memory payload (may be created by caller)
+ * - llm_model_id: model identifier
+ * - outcome: 'success' | 'partial' | 'failure'
+ *
+ * Returns:
+ * { finalBonus, comparativeBonus, rarityMultiplier, rareSuccess }
+ */
+export declare function computeImplementationBonus(qualityMetrics: any, llm_model_id: string, outcome: 'success' | 'partial' | 'failure'): {
+    finalBonus: number;
+    comparativeBonus: number;
+    rarityMultiplier: number;
+    rareSuccess: boolean;
+};
+//# sourceMappingURL=bonuses.d.ts.map

package/dist/services/stats/bonuses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bonuses.d.ts","sourceRoot":"","sources":["../../../src/services/stats/bonuses.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,uBAAuB,GAAG,MAAM,CAWpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACtC,cAAc,EAAE,GAAG,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAC3C;IACC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACxB,CA0EA"}

package/dist/services/stats/bonuses.js

@@ -0,0 +1,96 @@
+/**
+ * Implementation bonus core algorithms (statistical adjustments, rarity/comparative)
+ * These functions are pure/near-pure and operate on supplied data structures so the
+ * orchestrator can handle persistence and state mutation.
+ */
+export function calculateWilsonAdjustment(modelData) {
+    const { successes, attempts } = modelData;
+    if (attempts === 0)
+        return 0.5;
+    const z = 1.96;
+    const p = successes / attempts;
+    const n = attempts;
+    const denominator = 1 + z * z / n;
+    const numerator = p + z * z / (2 * n);
+    const adjustment = z * Math.sqrt(p * (1 - p) / n + z * z / (4 * n * n));
+    const lowerBound = Math.max(0, (numerator - adjustment) / denominator);
+    return 0.5 + (lowerBound * 1.0);
+}
+/**
+ * Compute implementation bonus given a qualityMetrics object.
+ *
+ * This function mutates qualityMetrics to record attempts/successes for the specific model.
+ * It returns an object describing the awarded bonus and whether a "rare success" occurred.
+ *
+ * Parameters:
+ * - qualityMetrics: the QualityMetrics object from memory payload (may be created by caller)
+ * - llm_model_id: model identifier
+ * - outcome: 'success' | 'partial' | 'failure'
+ *
+ * Returns:
+ * { finalBonus, comparativeBonus, rarityMultiplier, rareSuccess }
+ */
+export function computeImplementationBonus(qualityMetrics, llm_model_id, outcome) {
+    if (!qualityMetrics.implementation_stats) {
+        qualityMetrics.implementation_stats = {
+            total_attempts: 0,
+            success_attempts: 0,
+            model_success_rates: {},
+            confidence_level: 0,
+            last_implementation_attempt: null
+        };
+    }
+    const stats = qualityMetrics.implementation_stats;
+    if (!stats.model_success_rates[llm_model_id]) {
+        stats.model_success_rates[llm_model_id] = {
+            attempts: 0,
+            successes: 0,
+            success_rate: 0,
+            wilson_lower: 0,
+            wilson_upper: 0,
+            last_attempt: null
+        };
+    }
+    const modelData = stats.model_success_rates[llm_model_id];
+    // Update attempts
+    stats.total_attempts = (stats.total_attempts || 0) + 1;
+    modelData.attempts = (modelData.attempts || 0) + 1;
+    // Determine base bonus
+    let bonus = 0;
+    if (outcome === 'success') {
+        bonus = 5;
+        stats.success_attempts = (stats.success_attempts || 0) + 1;
+        modelData.successes = (modelData.successes || 0) + 1;
+    }
+    else if (outcome === 'partial') {
+        bonus = 2;
+    }
+    else {
+        // failure: record and return 0
+        modelData.success_rate = modelData.attempts > 0 ? (modelData.successes || 0) / modelData.attempts : 0;
+        return { finalBonus: 0, comparativeBonus: 0, rarityMultiplier: 1, rareSuccess: false };
+    }
+    modelData.success_rate = modelData.attempts > 0 ? (modelData.successes || 0) / modelData.attempts : 0;
+    const overallSuccessRate = stats.total_attempts > 0 ? (stats.success_attempts || 0) / stats.total_attempts : 0;
+    const rarityMultiplier = Math.max(1, 1 / Math.max(0.1, overallSuccessRate));
+    // Comparative bonus when model outperforms others
+    let comparativeBonus = 0;
+    const otherModels = Object.entries(stats.model_success_rates).filter(([modelId]) => modelId !== llm_model_id);
+    if (otherModels.length > 0) {
+        const otherSuccessRates = otherModels.map(([, data]) => data.attempts > 0 ? (data.successes || 0) / data.attempts : 0);
+        const avgOtherSuccessRate = otherSuccessRates.reduce((s, r) => s + r, 0) / otherSuccessRates.length;
+        if (avgOtherSuccessRate < 0.5 && modelData.success_rate > avgOtherSuccessRate) {
+            comparativeBonus = Math.min(10, (modelData.success_rate - avgOtherSuccessRate) * 20);
+            bonus += comparativeBonus;
+        }
+    }
+    // Wilson adjustment
+    const wilsonAdj = calculateWilsonAdjustment(modelData);
+    bonus *= wilsonAdj;
+    // Apply rarity multiplier (capped at 3x)
+    bonus *= Math.min(3, rarityMultiplier);
+    const finalBonus = Math.min(25, Math.round(bonus));
+    const rareSuccess = comparativeBonus > 0 && outcome === 'success';
+    return { finalBonus, comparativeBonus, rarityMultiplier, rareSuccess };
+}
+//# sourceMappingURL=bonuses.js.map

package/dist/services/stats/bonuses.js.map

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