@helix-agent/core 0.1.0 → 0.2.0

package/dist/engine/gene-map.d.ts

@@ -8,12 +8,24 @@ export declare class GeneMap {
     private stmtUpdatePlatforms;
     constructor(dbPath?: string);
     lookup(code: ErrorCode, category: FailureCategory): GeneCapsule | null;
-    /** Add a platform to an existing gene if not already present */
     addPlatform(code: ErrorCode, category: FailureCategory, platform: Platform): void;
     store(gene: GeneCapsule): void;
+    /** RL update after successful repair */
+    recordSuccess(code: string, category: string, repairMs: number): void;
+    /** RL update after failed repair */
+    recordFailure(code: string, category: string): void;
     list(): GeneCapsule[];
     immuneCount(): number;
     getSuccessRate(failureCode: string, strategy: string): number;
+    stats(): {
+        totalGenes: number;
+        avgQValue: number;
+        platforms: string[];
+        topStrategies: {
+            strategy: string;
+            count: number;
+        }[];
+    };
     close(): void;
 }
 //# sourceMappingURL=gene-map.d.ts.map

package/dist/engine/gene-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gene-map.d.ts","sourceRoot":"","sources":["../../src/engine/gene-map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkBpF,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,mBAAmB,CAAqB;gBAEpC,MAAM,GAAE,MAAmB;IAmCvC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI;IAwBtE,gEAAgE;IAChE,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAUjF,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAY9B,IAAI,IAAI,WAAW,EAAE;IAgBrB,WAAW,IAAI,MAAM;IAKrB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAW7D,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"gene-map.d.ts","sourceRoot":"","sources":["../../src/engine/gene-map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyCpF,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,mBAAmB,CAAqB;gBAEpC,MAAM,GAAE,MAAmB;IA8BvC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI;IActE,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAUjF,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAc9B,wCAAwC;IACxC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkBrE,oCAAoC;IACpC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBnD,IAAI,IAAI,WAAW,EAAE;IAIrB,WAAW,IAAI,MAAM;IAIrB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ7D,KAAK,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE;IAmB7H,KAAK,IAAI,IAAI;CAGd"}

package/dist/engine/gene-map.js

@@ -9,11 +9,33 @@ CREATE TABLE IF NOT EXISTS genes (
   success_count INTEGER NOT NULL DEFAULT 1,
   avg_repair_ms REAL NOT NULL DEFAULT 0,
   platforms TEXT NOT NULL DEFAULT '[]',
+  q_value REAL NOT NULL DEFAULT 0.5,
+  last_success_at INTEGER,
+  last_failed_at INTEGER,
+  consecutive_failures INTEGER NOT NULL DEFAULT 0,
   created_at TEXT NOT NULL DEFAULT (datetime('now')),
   last_used_at TEXT NOT NULL DEFAULT (datetime('now')),
   UNIQUE(failure_code, category)
 );
 `;
+function parseRow(row) {
+    return {
+        id: row.id,
+        failureCode: row.failure_code,
+        category: row.category,
+        strategy: row.strategy,
+        params: JSON.parse(row.params),
+        successCount: row.success_count,
+        avgRepairMs: row.avg_repair_ms,
+        platforms: JSON.parse(row.platforms),
+        qValue: row.q_value,
+        consecutiveFailures: row.consecutive_failures,
+        lastSuccessAt: row.last_success_at,
+        lastFailedAt: row.last_failed_at,
+        createdAt: row.created_at,
+        lastUsedAt: row.last_used_at,
+    };
+}
 export class GeneMap {
     db;
     stmtLookup;
@@ -26,53 +48,39 @@ export class GeneMap {
         this.db.pragma('journal_mode = WAL');
         this.db.exec(SCHEMA);
         this.stmtLookup = this.db.prepare(`
-      SELECT * FROM genes WHERE failure_code = ? AND category = ?
+      SELECT * FROM genes WHERE failure_code = ? AND category = ? ORDER BY q_value DESC LIMIT 1
     `);
         this.stmtUpsert = this.db.prepare(`
-      INSERT INTO genes (failure_code, category, strategy, params, success_count, avg_repair_ms, platforms)
-      VALUES (@failureCode, @category, @strategy, @params, @successCount, @avgRepairMs, @platforms)
+      INSERT INTO genes (failure_code, category, strategy, params, success_count, avg_repair_ms, platforms, q_value, consecutive_failures)
+      VALUES (@failureCode, @category, @strategy, @params, @successCount, @avgRepairMs, @platforms, @qValue, @consecutiveFailures)
       ON CONFLICT(failure_code, category) DO UPDATE SET
         strategy = @strategy,
         params = @params,
         success_count = success_count + 1,
         avg_repair_ms = (avg_repair_ms * success_count + @avgRepairMs) / (success_count + 1),
         platforms = @platforms,
+        q_value = @qValue,
+        consecutive_failures = @consecutiveFailures,
         last_used_at = datetime('now')
     `);
-        this.stmtList = this.db.prepare(`
-      SELECT * FROM genes ORDER BY success_count DESC
-    `);
-        this.stmtCount = this.db.prepare(`
-      SELECT COUNT(*) as count FROM genes
-    `);
+        this.stmtList = this.db.prepare(`SELECT * FROM genes ORDER BY q_value DESC, success_count DESC`);
+        this.stmtCount = this.db.prepare(`SELECT COUNT(*) as count FROM genes`);
         this.stmtUpdatePlatforms = this.db.prepare(`
-      UPDATE genes SET platforms = ?, last_used_at = datetime('now')
-      WHERE failure_code = ? AND category = ?
+      UPDATE genes SET platforms = ?, last_used_at = datetime('now') WHERE failure_code = ? AND category = ?
     `);
     }
     lookup(code, category) {
         const row = this.stmtLookup.get(code, category);
         if (!row)
             return null;
-        // Update last_used_at and increment success_count on hit
         this.db.prepare(`
       UPDATE genes SET last_used_at = datetime('now'), success_count = success_count + 1
       WHERE failure_code = ? AND category = ?
     `).run(code, category);
-        return {
-            id: row.id,
-            failureCode: row.failure_code,
-            category: row.category,
-            strategy: row.strategy,
-            params: JSON.parse(row.params),
-            successCount: row.success_count + 1,
-            avgRepairMs: row.avg_repair_ms,
-            platforms: JSON.parse(row.platforms),
-            createdAt: row.created_at,
-            lastUsedAt: row.last_used_at,
-        };
+        const gene = parseRow(row);
+        gene.successCount += 1; // reflect the bump we just did
+        return gene;
     }
-    /** Add a platform to an existing gene if not already present */
     addPlatform(code, category, platform) {
         const row = this.stmtLookup.get(code, category);
         if (!row)
@@ -92,37 +100,79 @@ export class GeneMap {
             successCount: gene.successCount,
             avgRepairMs: gene.avgRepairMs,
             platforms: JSON.stringify(gene.platforms),
+            qValue: gene.qValue ?? 0.5,
+            consecutiveFailures: gene.consecutiveFailures ?? 0,
         });
     }
+    /** RL update after successful repair */
+    recordSuccess(code, category, repairMs) {
+        const row = this.stmtLookup.get(code, category);
+        if (!row)
+            return;
+        const alpha = 0.1;
+        const oldQ = row.q_value;
+        const newQ = oldQ + alpha * (1.0 - oldQ);
+        this.db.prepare(`
+      UPDATE genes SET
+        q_value = ?,
+        avg_repair_ms = (avg_repair_ms * success_count + ?) / (success_count + 1),
+        success_count = success_count + 1,
+        last_success_at = ?,
+        consecutive_failures = 0,
+        last_used_at = datetime('now')
+      WHERE failure_code = ? AND category = ?
+    `).run(newQ, repairMs, Date.now(), code, category);
+    }
+    /** RL update after failed repair */
+    recordFailure(code, category) {
+        const row = this.stmtLookup.get(code, category);
+        if (!row)
+            return;
+        const alpha = 0.1;
+        const oldQ = row.q_value;
+        const newQ = oldQ + alpha * (0.0 - oldQ);
+        this.db.prepare(`
+      UPDATE genes SET
+        q_value = ?,
+        last_failed_at = ?,
+        consecutive_failures = consecutive_failures + 1,
+        last_used_at = datetime('now')
+      WHERE failure_code = ? AND category = ?
+    `).run(newQ, Date.now(), code, category);
+    }
     list() {
-        const rows = this.stmtList.all();
-        return rows.map((row) => ({
-            id: row.id,
-            failureCode: row.failure_code,
-            category: row.category,
-            strategy: row.strategy,
-            params: JSON.parse(row.params),
-            successCount: row.success_count,
-            avgRepairMs: row.avg_repair_ms,
-            platforms: JSON.parse(row.platforms),
-            createdAt: row.created_at,
-            lastUsedAt: row.last_used_at,
-        }));
+        return this.stmtList.all().map(parseRow);
     }
     immuneCount() {
-        const row = this.stmtCount.get();
-        return row.count;
+        return this.stmtCount.get().count;
     }
     getSuccessRate(failureCode, strategy) {
         const row = this.db.prepare(`
-      SELECT success_count FROM genes
-      WHERE failure_code = ? AND strategy = ?
+      SELECT success_count, q_value FROM genes WHERE failure_code = ? AND strategy = ?
     `).get(failureCode, strategy);
         if (!row || row.success_count < 3)
-            return 0.5; // too few samples, return neutral
-        // More successes → higher probability, capped at 0.95
+            return 0.5;
         return Math.min(0.5 + (row.success_count / 100), 0.95);
     }
+    stats() {
+        const rows = this.stmtList.all();
+        const allPlatforms = new Set();
+        let qSum = 0;
+        for (const r of rows) {
+            qSum += r.q_value;
+            for (const p of JSON.parse(r.platforms))
+                allPlatforms.add(p);
+        }
+        return {
+            totalGenes: rows.length,
+            avgQValue: rows.length > 0 ? Math.round((qSum / rows.length) * 100) / 100 : 0,
+            platforms: [...allPlatforms],
+            topStrategies: rows.slice(0, 10).map(r => ({
+                strategy: r.strategy,
+                count: r.success_count,
+            })),
+        };
+    }
     close() {
         this.db.close();
     }

package/dist/engine/gene-map.js.map

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

package/dist/engine/pcec.d.ts

@@ -1,13 +1,11 @@
 import { GeneMap } from './gene-map.js';
-import type { FailureClassification, GeneCapsule, PlatformAdapter, RepairCandidate, RepairResult } from './types.js';
-export declare function commit(winner: RepairCandidate, _failure: FailureClassification): Promise<{
-    success: boolean;
-    result: string;
-}>;
+import type { GeneCapsule, PlatformAdapter, RepairResult, WrapOptions } from './types.js';
 export declare class PcecEngine {
     private adapters;
     private geneMap;
     private agentId;
+    private provider;
+    private options;
     stats: {
         repairs: number;
         savedRevenue: number;
@@ -15,14 +13,13 @@ export declare class PcecEngine {
     };
     private readonly MAX_CYCLES;
     private cycleCount;
-    constructor(geneMap: GeneMap, agentId?: string);
-    /** Register platform adapters (order matters — first match wins for perceive) */
+    constructor(geneMap: GeneMap, agentId?: string, options?: WrapOptions);
     registerAdapter(adapter: PlatformAdapter): void;
-    /** Perceive chains through adapters until one matches */
+    /** D16: Negative pattern guard — prevent false positives from success messages */
+    private shouldSkipPerceive;
     private perceive;
-    /** Construct collects candidates from ALL adapters */
-    private construct;
-    /** Full P→C→E→K repair flow */
+    private constructCandidates;
+    private verify;
     repair(error: Error, context?: Record<string, unknown>): Promise<RepairResult>;
     getStats(): {
         geneCount: number;
@@ -31,5 +28,6 @@ export declare class PcecEngine {
         savedRevenue: number;
         immuneHits: number;
     };
+    getGeneMap(): GeneMap;
 }
 //# sourceMappingURL=pcec.d.ts.map

package/dist/engine/pcec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pcec.d.ts","sourceRoot":"","sources":["../../src/engine/pcec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAKpB,wBAAsB,MAAM,CAC1B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAU/C;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAS;IACjB,KAAK;;;;MAAkD;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,MAAkB;IAKzD,iFAAiF;IACjF,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI/C,yDAAyD;IACzD,OAAO,CAAC,QAAQ;IAgBhB,sDAAsD;IACtD,OAAO,CAAC,SAAS;IAYjB,+BAA+B;IACzB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IA6MpF,QAAQ;;;;;;;CAOT"}
+{"version":3,"file":"pcec.d.ts","sourceRoot":"","sources":["../../src/engine/pcec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,EAEV,WAAW,EAEX,eAAe,EAEf,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AA6BpB,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAc;IACtB,KAAK;;;;MAAkD;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,MAAkB,EAAE,OAAO,CAAC,EAAE,WAAW;IAOhF,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI/C,kFAAkF;IAClF,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,mBAAmB;YAWb,MAAM;IAyBd,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAgOpF,QAAQ;;;;;;;IAQR,UAAU,IAAI,OAAO;CAGtB"}