@evomap/evolver 1.90.0 → 2.0.0-beta.0

package/conformance/savings-core/golden-vectors.json

@@ -1,333 +0,0 @@
-{
-  "spec_version": "0.3.0",
-  "cases": [
-    {
-      "id": "r1_genebench_overall",
-      "formula": "measured_savings",
-      "input": {
-        "raw_tokens": 489273,
-        "optimized_tokens": 182943
-      },
-      "expected": {
-        "tokens_saved": 306330,
-        "savings_pct": 62.61
-      }
-    },
-    {
-      "id": "r1_genebench_max_single",
-      "formula": "measured_savings",
-      "input": {
-        "raw_tokens": 14340,
-        "optimized_tokens": 2179
-      },
-      "expected": {
-        "tokens_saved": 12161,
-        "savings_pct": 84.8
-      }
-    },
-    {
-      "id": "r1_zero_raw",
-      "formula": "measured_savings",
-      "input": {
-        "raw_tokens": 0,
-        "optimized_tokens": 500
-      },
-      "expected": {
-        "tokens_saved": 0,
-        "savings_pct": 0
-      }
-    },
-    {
-      "id": "r1_optimized_exceeds_raw_clamps",
-      "formula": "measured_savings",
-      "input": {
-        "raw_tokens": 1000,
-        "optimized_tokens": 1200
-      },
-      "expected": {
-        "tokens_saved": 0,
-        "savings_pct": 0
-      }
-    },
-    {
-      "id": "r2_genebench_avg_rollout",
-      "formula": "rollout_fold",
-      "input": {
-        "n_avg_rollouts": 1.48
-      },
-      "expected": {
-        "rollout_fold_pct": 32.43
-      }
-    },
-    {
-      "id": "r2_single_rollout",
-      "formula": "rollout_fold",
-      "input": {
-        "n_avg_rollouts": 1
-      },
-      "expected": {
-        "rollout_fold_pct": 0
-      }
-    },
-    {
-      "id": "e1_all_event_types_default_coeffs",
-      "formula": "entropy_total",
-      "input": {
-        "events": [
-          {
-            "type": "dedup_quarantine",
-            "count": 2
-          },
-          {
-            "type": "dedup_warning",
-            "count": 1
-          },
-          {
-            "type": "hub_search_hit",
-            "count": 3
-          },
-          {
-            "type": "hub_search_miss",
-            "count": 5
-          },
-          {
-            "type": "fetch_reuse",
-            "count": 4
-          }
-        ]
-      },
-      "expected": {
-        "total_tokens_saved": 67600,
-        "total_events": 15
-      }
-    },
-    {
-      "id": "e1_caller_supplied_measured_takes_precedence",
-      "formula": "entropy_total",
-      "input": {
-        "events": [
-          {
-            "type": "fetch_reuse",
-            "count": 1,
-            "tokensEstSaved": 7777
-          }
-        ]
-      },
-      "expected": {
-        "total_tokens_saved": 7777,
-        "total_events": 1
-      }
-    },
-    {
-      "id": "e1_negative_coerces_to_zero",
-      "formula": "entropy_total",
-      "input": {
-        "events": [
-          {
-            "type": "hub_search_hit",
-            "count": 1,
-            "tokensEstSaved": -50
-          }
-        ]
-      },
-      "expected": {
-        "total_tokens_saved": 0,
-        "total_events": 1
-      }
-    },
-    {
-      "id": "e1_unknown_type_ignored",
-      "formula": "entropy_total",
-      "input": {
-        "events": [
-          {
-            "type": "mystery_event",
-            "count": 9
-          },
-          {
-            "type": "fetch_reuse",
-            "count": 1
-          }
-        ]
-      },
-      "expected": {
-        "total_tokens_saved": 4000,
-        "total_events": 1
-      }
-    },
-    {
-      "id": "e2_mixed_asset_types",
-      "formula": "fetch_usage_estimate",
-      "input": {
-        "byType": {
-          "Gene": 10,
-          "Capsule": 3,
-          "EvolutionEvent": 7
-        }
-      },
-      "expected": {
-        "estimated_token_saved": 25500
-      }
-    },
-    {
-      "id": "e2_unknown_type_contributes_zero",
-      "formula": "fetch_usage_estimate",
-      "input": {
-        "byType": {
-          "Gene": 1,
-          "Artifact": 99
-        }
-      },
-      "expected": {
-        "estimated_token_saved": 1500
-      }
-    },
-    {
-      "id": "h1_homepage_style_hit_rate",
-      "formula": "hit_rate",
-      "input": {
-        "hits": 1531,
-        "misses": 60
-      },
-      "expected": {
-        "hit_rate_pct": 96.23
-      }
-    },
-    {
-      "id": "h1_empty_denominator",
-      "formula": "hit_rate",
-      "input": {
-        "hits": 0,
-        "misses": 0
-      },
-      "expected": {
-        "hit_rate_pct": 0
-      }
-    },
-    {
-      "id": "u1_round_two_decimals",
-      "formula": "usd_saved",
-      "input": {
-        "tokens": 67600
-      },
-      "expected": {
-        "usd_saved": 0.61
-      }
-    },
-    {
-      "id": "u1_two_million_tokens",
-      "formula": "usd_saved",
-      "input": {
-        "tokens": 2000000
-      },
-      "expected": {
-        "usd_saved": 18
-      }
-    },
-    {
-      "id": "c1_anthropic_one_million_cache_reads",
-      "formula": "cache_saved_usd",
-      "input": {
-        "provider": "anthropic",
-        "cache_read_tokens": 1000000
-      },
-      "expected": {
-        "cache_saved_usd": 2.7
-      }
-    },
-    {
-      "id": "c1_round_four_decimals",
-      "formula": "cache_saved_usd",
-      "input": {
-        "provider": "anthropic",
-        "cache_read_tokens": 123456
-      },
-      "expected": {
-        "cache_saved_usd": 0.3333
-      }
-    },
-    {
-      "id": "c1_unknown_provider_zero",
-      "formula": "cache_saved_usd",
-      "input": {
-        "provider": "acme",
-        "cache_read_tokens": 1000000
-      },
-      "expected": {
-        "cache_saved_usd": 0
-      }
-    },
-    {
-      "id": "e3_default_direct_anchors_legacy_blanket",
-      "formula": "reuse_estimate",
-      "input": {
-        "blast_radius_lines": null,
-        "mode": "direct"
-      },
-      "expected": {
-        "tokens_saved": 180000,
-        "basis": "estimated_default"
-      }
-    },
-    {
-      "id": "e3_median_patch_75_lines",
-      "formula": "reuse_estimate",
-      "input": {
-        "blast_radius_lines": 75,
-        "mode": "direct"
-      },
-      "expected": {
-        "tokens_saved": 180000,
-        "basis": "estimated_blast_radius"
-      }
-    },
-    {
-      "id": "e3_small_patch_scales_down",
-      "formula": "reuse_estimate",
-      "input": {
-        "blast_radius_lines": 2,
-        "mode": "direct"
-      },
-      "expected": {
-        "tokens_saved": 121600,
-        "basis": "estimated_blast_radius"
-      }
-    },
-    {
-      "id": "e3_pathological_blast_radius_capped",
-      "formula": "reuse_estimate",
-      "input": {
-        "blast_radius_lines": 1000,
-        "mode": "direct"
-      },
-      "expected": {
-        "tokens_saved": 600000,
-        "basis": "estimated_blast_radius"
-      }
-    },
-    {
-      "id": "e3_reference_mode_fractional",
-      "formula": "reuse_estimate",
-      "input": {
-        "blast_radius_lines": null,
-        "mode": "reference"
-      },
-      "expected": {
-        "tokens_saved": 72000,
-        "basis": "estimated_default"
-      }
-    },
-    {
-      "id": "e3_zero_lines_falls_back_to_default",
-      "formula": "reuse_estimate",
-      "input": {
-        "blast_radius_lines": 0,
-        "mode": "direct"
-      },
-      "expected": {
-        "tokens_saved": 180000,
-        "basis": "estimated_default"
-      }
-    }
-  ]
-}

package/scripts/a2a_export.js

@@ -1,63 +0,0 @@
-const { loadGenes, loadCapsules, readAllEvents } = require('../src/gep/assetStore');
-const { exportEligibleCapsules, exportEligibleGenes, isAllowedA2AAsset } = require('../src/gep/a2a');
-const { buildPublish, buildHello, getTransport } = require('../src/gep/a2aProtocol');
-const { computeAssetId, SCHEMA_VERSION } = require('../src/gep/contentHash');
-
-function main() {
-  var args = process.argv.slice(2);
-  var asJson = args.includes('--json');
-  var asProtocol = args.includes('--protocol');
-  var withHello = args.includes('--hello');
-  var persist = args.includes('--persist');
-  var includeEvents = args.includes('--include-events');
-
-  var capsules = loadCapsules();
-  var genes = loadGenes();
-  var events = readAllEvents();
-
-  // Build eligible list: Capsules (filtered) + Genes (filtered) + Events (opt-in)
-  var eligibleCapsules = exportEligibleCapsules({ capsules: capsules, events: events });
-  var eligibleGenes = exportEligibleGenes({ genes: genes });
-  var eligible = eligibleCapsules.concat(eligibleGenes);
-
-  if (includeEvents) {
-    var eligibleEvents = (Array.isArray(events) ? events : []).filter(function (e) {
-      return isAllowedA2AAsset(e) && e.type === 'EvolutionEvent';
-    });
-    for (var ei = 0; ei < eligibleEvents.length; ei++) {
-      var ev = eligibleEvents[ei];
-      if (!ev.schema_version) ev.schema_version = SCHEMA_VERSION;
-      if (!ev.asset_id) { try { ev.asset_id = computeAssetId(ev); } catch (e) {} }
-    }
-    eligible = eligible.concat(eligibleEvents);
-  }
-
-  if (withHello || asProtocol) {
-    var hello = buildHello({ geneCount: genes.length, capsuleCount: capsules.length });
-    process.stdout.write(JSON.stringify(hello) + '\n');
-    if (persist) { try { getTransport().send(hello); } catch (e) {} }
-  }
-
-  if (asProtocol) {
-    for (var i = 0; i < eligible.length; i++) {
-      var msg = buildPublish({ asset: eligible[i] });
-      process.stdout.write(JSON.stringify(msg) + '\n');
-      if (persist) { try { getTransport().send(msg); } catch (e) {} }
-    }
-    return;
-  }
-
-  if (asJson) {
-    process.stdout.write(JSON.stringify(eligible, null, 2) + '\n');
-    return;
-  }
-
-  for (var j = 0; j < eligible.length; j++) {
-    process.stdout.write(JSON.stringify(eligible[j]) + '\n');
-  }
-}
-
-try { main(); } catch (e) {
-  process.stderr.write((e && e.message ? e.message : String(e)) + '\n');
-  process.exit(1);
-}

package/scripts/a2a_ingest.js

@@ -1,79 +0,0 @@
-var fs = require('fs');
-var assetStore = require('../src/gep/assetStore');
-var a2a = require('../src/gep/a2a');
-var memGraph = require('../src/gep/memoryGraphAdapter');
-var contentHash = require('../src/gep/contentHash');
-var a2aProto = require('../src/gep/a2aProtocol');
-
-function readStdin() {
-  try { return fs.readFileSync(0, 'utf8'); } catch (e) { return ''; }
-}
-
-function parseSignalsFromEnv() {
-  var raw = process.env.A2A_SIGNALS || '';
-  if (!raw) return [];
-  try {
-    var maybe = JSON.parse(raw);
-    if (Array.isArray(maybe)) return maybe.map(String).filter(Boolean);
-  } catch (e) {}
-  return String(raw).split(',').map(function (s) { return s.trim(); }).filter(Boolean);
-}
-
-function main() {
-  var args = process.argv.slice(2);
-  var inputPath = '';
-  for (var i = 0; i < args.length; i++) {
-    if (args[i] && !args[i].startsWith('--')) { inputPath = args[i]; break; }
-  }
-  var source = process.env.A2A_SOURCE || 'external';
-  var factor = Number.isFinite(Number(process.env.A2A_EXTERNAL_CONFIDENCE_FACTOR))
-    ? Number(process.env.A2A_EXTERNAL_CONFIDENCE_FACTOR) : 0.6;
-
-  var text = inputPath ? a2a.readTextIfExists(inputPath) : readStdin();
-  var parsed = a2a.parseA2AInput(text);
-  var signals = parseSignalsFromEnv();
-
-  var accepted = 0;
-  var rejected = 0;
-  var emitDecisions = process.env.A2A_EMIT_DECISIONS === 'true';
-
-  for (var j = 0; j < parsed.length; j++) {
-    var obj = parsed[j];
-    if (!a2a.isAllowedA2AAsset(obj)) continue;
-
-    if (obj.asset_id && typeof obj.asset_id === 'string') {
-      if (!contentHash.verifyAssetId(obj)) {
-        rejected += 1;
-        if (emitDecisions) {
-          try {
-            var dm = a2aProto.buildDecision({ assetId: obj.asset_id, localId: obj.id, decision: 'reject', reason: 'asset_id integrity check failed' });
-            a2aProto.getTransport().send(dm);
-          } catch (e) {}
-        }
-        continue;
-      }
-    }
-
-    var staged = a2a.lowerConfidence(obj, { source: source, factor: factor });
-    if (!staged) continue;
-
-    assetStore.appendExternalCandidateJsonl(staged);
-    try { memGraph.recordExternalCandidate({ asset: staged, source: source, signals: signals }); } catch (e) {}
-
-    if (emitDecisions) {
-      try {
-        var dm2 = a2aProto.buildDecision({ assetId: staged.asset_id, localId: staged.id, decision: 'quarantine', reason: 'staged as external candidate' });
-        a2aProto.getTransport().send(dm2);
-      } catch (e) {}
-    }
-
-    accepted += 1;
-  }
-
-  process.stdout.write('accepted=' + accepted + ' rejected=' + rejected + '\n');
-}
-
-try { main(); } catch (e) {
-  process.stderr.write((e && e.message ? e.message : String(e)) + '\n');
-  process.exit(1);
-}

package/scripts/a2a_promote.js

@@ -1,118 +0,0 @@
-var assetStore = require('../src/gep/assetStore');
-var solidifyMod = require('../src/gep/solidify');
-var contentHash = require('../src/gep/contentHash');
-var a2aProto = require('../src/gep/a2aProtocol');
-
-function parseArgs(argv) {
-  var out = { flags: new Set(), kv: new Map(), positionals: [] };
-  for (var i = 0; i < argv.length; i++) {
-    var a = argv[i];
-    if (!a) continue;
-    if (a.startsWith('--')) {
-      var eq = a.indexOf('=');
-      if (eq > -1) { out.kv.set(a.slice(2, eq), a.slice(eq + 1)); }
-      else {
-        var key = a.slice(2);
-        var next = argv[i + 1];
-        if (next && !String(next).startsWith('--')) { out.kv.set(key, next); i++; }
-        else { out.flags.add(key); }
-      }
-    } else { out.positionals.push(a); }
-  }
-  return out;
-}
-
-function main() {
-  var args = parseArgs(process.argv.slice(2));
-  var id = String(args.kv.get('id') || '').trim();
-  var typeRaw = String(args.kv.get('type') || '').trim().toLowerCase();
-  var validated = args.flags.has('validated') || String(args.kv.get('validated') || '') === 'true';
-  var limit = Number.isFinite(Number(args.kv.get('limit'))) ? Number(args.kv.get('limit')) : 500;
-
-  if (!id || !typeRaw) throw new Error('Usage: node scripts/a2a_promote.js --type capsule|gene|event --id <id> --validated');
-  if (!validated) throw new Error('Refusing to promote without --validated (local verification must be done first).');
-
-  var type = typeRaw === 'capsule' ? 'Capsule' : typeRaw === 'gene' ? 'Gene' : typeRaw === 'event' ? 'EvolutionEvent' : '';
-  if (!type) throw new Error('Invalid --type. Use capsule, gene, or event.');
-
-  var external = assetStore.readRecentExternalCandidates(limit);
-  var candidate = null;
-  for (var i = 0; i < external.length; i++) {
-    if (external[i] && external[i].type === type && String(external[i].id) === id) { candidate = external[i]; break; }
-  }
-  if (!candidate) throw new Error('Candidate not found in external zone: type=' + type + ' id=' + id);
-
-  if (type === 'Gene') {
-    var validation = Array.isArray(candidate.validation) ? candidate.validation : [];
-    for (var j = 0; j < validation.length; j++) {
-      var c = String(validation[j] || '').trim();
-      if (!c) continue;
-      if (!solidifyMod.isValidationCommandAllowed(c)) {
-        throw new Error('Refusing to promote Gene ' + id + ': validation command rejected by safety check: "' + c + '". Only node/npm/npx commands without shell operators are allowed.');
-      }
-    }
-  }
-
-  var promoted = JSON.parse(JSON.stringify(candidate));
-  if (!promoted.a2a || typeof promoted.a2a !== 'object') promoted.a2a = {};
-  promoted.a2a.status = 'promoted';
-  promoted.a2a.promoted_at = new Date().toISOString();
-  if (!promoted.schema_version) promoted.schema_version = contentHash.SCHEMA_VERSION;
-  promoted.asset_id = contentHash.computeAssetId(promoted);
-
-  var emitDecisions = process.env.A2A_EMIT_DECISIONS === 'true';
-
-  if (type === 'EvolutionEvent') {
-    assetStore.appendEventJsonl(promoted);
-    if (emitDecisions) {
-      try {
-        var dmEv = a2aProto.buildDecision({ assetId: promoted.asset_id, localId: id, decision: 'accept', reason: 'event promoted for provenance tracking' });
-        a2aProto.getTransport().send(dmEv);
-      } catch (e) {}
-    }
-    process.stdout.write('promoted_event=' + id + '\n');
-    return;
-  }
-
-  if (type === 'Capsule') {
-    assetStore.appendCapsule(promoted);
-    if (emitDecisions) {
-      try {
-        var dm = a2aProto.buildDecision({ assetId: promoted.asset_id, localId: id, decision: 'accept', reason: 'capsule promoted after validation' });
-        a2aProto.getTransport().send(dm);
-      } catch (e) {}
-    }
-    process.stdout.write('promoted_capsule=' + id + '\n');
-    return;
-  }
-
-  var localGenes = assetStore.loadGenes();
-  var exists = false;
-  for (var k = 0; k < localGenes.length; k++) {
-    if (localGenes[k] && localGenes[k].type === 'Gene' && String(localGenes[k].id) === id) { exists = true; break; }
-  }
-  if (exists) {
-    if (emitDecisions) {
-      try {
-        var dm2 = a2aProto.buildDecision({ assetId: promoted.asset_id, localId: id, decision: 'reject', reason: 'local gene with same ID already exists' });
-        a2aProto.getTransport().send(dm2);
-      } catch (e) {}
-    }
-    process.stdout.write('conflict_keep_local_gene=' + id + '\n');
-    return;
-  }
-
-  assetStore.upsertGene(promoted);
-  if (emitDecisions) {
-    try {
-      var dm3 = a2aProto.buildDecision({ assetId: promoted.asset_id, localId: id, decision: 'accept', reason: 'gene promoted after safety audit' });
-      a2aProto.getTransport().send(dm3);
-    } catch (e) {}
-  }
-  process.stdout.write('promoted_gene=' + id + '\n');
-}
-
-try { main(); } catch (e) {
-  process.stderr.write((e && e.message ? e.message : String(e)) + '\n');
-  process.exit(1);
-}