@evomap/evolver 1.90.0 → 2.0.0-beta.1

package/src/atp/merchantAgent.js

@@ -1,118 +0,0 @@
-// ATP Merchant Agent Template
-// Provides a ready-to-use merchant agent that registers services,
-// listens for orders, processes them, and submits delivery proofs.
-//
-// Usage:
-//   const merchant = require('./merchantAgent');
-//   merchant.start({ services: [{ title: 'Code Review', ... }] });
-
-const { getNodeId, sendHelloToHub, startHeartbeat, stopHeartbeat, consumeAvailableWork } = require('../gep/a2aProtocol');
-const { publishService } = require('./serviceHelper');
-const { submitDelivery, getMerchantTier, listProofs } = require('./hubClient');
-
-let _running = false;
-let _pollInterval = null;
-const DEFAULT_POLL_MS = 30000;
-
-/**
- * Start the merchant agent loop.
- * @param {object} opts
- * @param {Array<object>} opts.services - services to register
- * @param {function} opts.onOrder - async handler(order) => proofPayload
- * @param {number} [opts.pollMs] - order poll interval (default 30s)
- */
-async function start(opts) {
-  if (_running) {
-    console.log('[ATP-Merchant] Already running, skipping duplicate start.');
-    return;
-  }
-  _running = true;
-
-  const hello = await sendHelloToHub();
-  if (!hello || !hello.ok) {
-    console.error('[ATP-Merchant] Failed to register with Hub:', hello?.error);
-    _running = false;
-    return;
-  }
-
-  console.log('[ATP-Merchant] Registered as', getNodeId());
-
-  if (Array.isArray(opts.services)) {
-    for (const svc of opts.services) {
-      try {
-        const result = await publishService(svc);
-        if (result.ok) {
-          console.log('[ATP-Merchant] Published service:', svc.title);
-        } else {
-          console.warn('[ATP-Merchant] Failed to publish service:', svc.title, result.error);
-        }
-      } catch (e) {
-        console.warn('[ATP-Merchant] Service publish error:', e.message);
-      }
-    }
-  }
-
-  startHeartbeat();
-
-  const pollMs = opts.pollMs || DEFAULT_POLL_MS;
-  _pollInterval = setInterval(async () => {
-    try {
-      const work = consumeAvailableWork();
-      if (!work || work.length === 0) return;
-
-      for (const order of work) {
-        if (typeof opts.onOrder === 'function') {
-          try {
-            const proofPayload = await opts.onOrder(order);
-            if (proofPayload && order.atp_order_id) {
-              const delivery = await submitDelivery(order.atp_order_id, proofPayload);
-              if (delivery.ok) {
-                console.log('[ATP-Merchant] Delivered order:', order.atp_order_id);
-              } else {
-                console.warn('[ATP-Merchant] Delivery failed:', delivery.error);
-              }
-            }
-          } catch (e) {
-            console.error('[ATP-Merchant] Order handler error:', e.message);
-          }
-        }
-      }
-    } catch (e) {
-      console.error('[ATP-Merchant] Poll error:', e.message);
-    }
-  }, pollMs);
-
-  console.log('[ATP-Merchant] Polling for orders every', pollMs, 'ms');
-}
-
-function stop() {
-  _running = false;
-  if (_pollInterval) {
-    clearInterval(_pollInterval);
-    _pollInterval = null;
-  }
-  stopHeartbeat();
-  console.log('[ATP-Merchant] Stopped');
-}
-
-function isRunning() {
-  return _running;
-}
-
-async function getStatus() {
-  const tier = await getMerchantTier();
-  const proofs = await listProofs({ role: 'merchant', limit: 5 });
-  return {
-    node_id: getNodeId(),
-    running: _running,
-    tier: tier.ok ? tier.data : null,
-    recent_proofs: proofs.ok ? proofs.data : null,
-  };
-}
-
-module.exports = {
-  start,
-  stop,
-  isRunning,
-  getStatus,
-};

package/src/atp/protocol.js

@@ -1,41 +0,0 @@
-// Protocol-level enum constants for the Agent Transaction Protocol.
-//
-// These values (verify modes, routing modes, proof statuses, roles,
-// execution modes) live in @evomap/atp-sdk. This module is a thin
-// CommonJS facade so callsites in src/atp/ can `require('./protocol')`
-// for the authoritative sets instead of re-spelling the literals.
-//
-// Why move them out: ATP is the wire contract between this engine, the
-// EvoMap Hub, and (in future) evox-Rust. Hand-maintaining the allowed
-// value sets in each implementation is exactly the drift that the
-// v1.80.8 "explore" enum incident taught us to avoid for GEP. The ATP
-// contract is extracted into its own SDK before a second runtime wires
-// in, while it is still cheap. If you find yourself writing an enum
-// list literal here again (e.g. ['pending','verified',...]), stop --
-// import the constant from this facade instead, and bump
-// @evomap/atp-sdk if the set itself needs to change.
-//
-// Implementation note: @evomap/atp-sdk is published as ESM
-// (`"type": "module"`). Node supports `require()` of synchronous ESM
-// packages on 22.12.0 and later. The SDK itself stays permissive
-// (`engines.node >=18`) so `import`-based consumers on 18/20 aren't
-// blocked; the `>=22.12` guarantee that makes the require() below work
-// is pinned in THIS package's (evolver's) `engines.node`, not the SDK's.
-
-const {
-  ATP_VERIFY_MODES,
-  ATP_VERIFY_ACTIONS,
-  ATP_ROUTING_MODES,
-  ATP_PROOF_STATUSES,
-  ATP_ROLES,
-  ATP_EXECUTION_MODES,
-} = require('@evomap/atp-sdk');
-
-module.exports = {
-  ATP_VERIFY_MODES,
-  ATP_VERIFY_ACTIONS,
-  ATP_ROUTING_MODES,
-  ATP_PROOF_STATUSES,
-  ATP_ROLES,
-  ATP_EXECUTION_MODES,
-};

package/src/atp/questionComposer.js

@@ -1,133 +0,0 @@
-// ATP Question Composer
-//
-// Generates a natural-language buyer question from raw capability/signal
-// inputs. autoBuyer previously concatenated signals into a string like
-// "Capability gap detected by evolver: code_evolution,performance,..."
-// which is uninformative to the merchant and produces poor answers.
-//
-// This module maps each known capability (or signal prefix) to a template
-// that phrases the request as something a real buyer might ask. When no
-// template matches, falls back to a generic "please help me with <caps>"
-// phrasing. Templates deliberately stay concise (under 240 chars) so buyer
-// budgets and merchant time are not wasted on padding.
-//
-// Templates are intentionally defensive: they never leak Evolver internals
-// ("signals", "cycle", "mutation") into merchant-visible text.
-
-const DEFAULT_MAX_LEN = 240;
-
-const TEMPLATES = {
-  code_evolution: [
-    'I want to improve code quality on a small module. Please suggest one concrete, minimal patch I can apply, including the exact files, the change, and why it helps.',
-    'I am iterating on a codebase and would like one high-leverage refactor suggestion. Be specific about the file, the current issue, and the proposed change.',
-  ],
-  performance: [
-    'My app has a slow hot-path and I want one concrete optimization idea. Explain the likely bottleneck, propose a specific fix, and estimate the impact.',
-    'I need help diagnosing a performance issue. Ask the right clarifying question if needed, or give me the top-3 most likely causes in priority order.',
-  ],
-  debugging: [
-    'I am stuck on a bug and need a fresh pair of eyes. Walk me through a systematic debugging approach that would isolate the root cause in under an hour.',
-    'Help me debug a tricky issue: please outline 3 reproduction strategies, each with the signals I should look for to confirm or rule out a hypothesis.',
-  ],
-  testing: [
-    'I want to add tests to an under-tested module. Recommend the specific test cases (happy path, edge cases, regression) that give the best coverage per line of test code.',
-    'Please review a typical testing gap for this kind of module and tell me the 3 test cases I probably missed.',
-  ],
-  documentation: [
-    'I need to write user-facing documentation for a feature. Give me a concise outline and sample opening paragraph that sets expectations correctly.',
-    'Help me rewrite a README section so it is clear to a first-time user. Focus on the smallest change that removes the most confusion.',
-  ],
-  refactoring: [
-    'I want to refactor a module without changing behavior. Suggest the safest single-step refactor that reduces complexity, and what I should watch for during review.',
-    'Please propose a refactoring plan I can apply in small commits, starting with the change that has the highest value/risk ratio.',
-  ],
-  security: [
-    'Review a typical security concern for this kind of service and give me one actionable hardening I should implement first.',
-    'I want a short security checklist for my app. List the top 5 issues to check in priority order, with the quickest mitigation for each.',
-  ],
-  data_analysis: [
-    'I have a dataset and want to extract one useful insight. Recommend the analysis I should run first, the metric to compute, and how to interpret the result.',
-    'Given a typical CSV of user events, which 3 analyses would most likely surface actionable patterns? Explain why for each.',
-  ],
-  architecture: [
-    'Help me think through an architectural trade-off: I need to choose between two patterns for a small service. Give me the decision factors and a recommended default.',
-    'I need a rough architecture sketch for a new feature. Describe the smallest viable design and list the 2 decisions that are easy to get wrong.',
-  ],
-  deployment: [
-    'Help me set up a safe deployment path for my app. Outline the minimum CI/CD steps and the 3 most common pitfalls to avoid.',
-    'I want to harden my deploy pipeline. Recommend the smallest change that most reduces the risk of a broken deploy reaching production.',
-  ],
-  general: [
-    'I have a small task I would like an agent to help with. Please ask me the single most useful clarifying question, then outline how you would approach it.',
-    'Please give me a concise, practical answer for a typical task in this capability. If context is needed, ask one focused clarifying question first.',
-  ],
-};
-
-function _normalize(s) {
-  return String(s || '').toLowerCase().replace(/[^a-z0-9_]+/g, '_').replace(/^_+|_+$/g, '');
-}
-
-function _pickTemplate(key, hashSeed) {
-  const list = TEMPLATES[key] || TEMPLATES.general;
-  if (!list || list.length === 0) return null;
-  // Deterministic pick from a seed so the same signals yield the same
-  // question across runs (plays nicely with autoBuyer's dedup hash).
-  const n = Math.abs(Number(hashSeed) || 0) % list.length;
-  return list[n];
-}
-
-function _hashFor(parts) {
-  const s = Array.isArray(parts) ? parts.join('|') : String(parts || '');
-  let h = 0;
-  for (let i = 0; i < s.length; i++) {
-    h = (h * 31 + s.charCodeAt(i)) | 0;
-  }
-  return h;
-}
-
-function _clip(s, maxLen) {
-  const text = String(s || '').trim();
-  const cap = Math.max(40, Number(maxLen) || DEFAULT_MAX_LEN);
-  if (text.length <= cap) return text;
-  return text.slice(0, cap - 3).replace(/\s+$/, '') + '...';
-}
-
-/**
- * Build a natural-language buyer question from capabilities + signals.
- *
- * @param {object} opts
- * @param {string[]} opts.capabilities -- buyer-side capability ids (first one picks the template)
- * @param {string[]} [opts.signals]    -- evolver signals (used as tiebreaker; never leaked verbatim)
- * @param {string}   [opts.fallback]   -- caller-provided fallback sentence
- * @param {number}   [opts.maxLen=240]
- * @returns {string} -- composed question (never empty)
- */
-function compose(opts) {
-  const capabilities = Array.isArray(opts && opts.capabilities) ? opts.capabilities : [];
-  const signals = Array.isArray(opts && opts.signals) ? opts.signals : [];
-  const maxLen = Number(opts && opts.maxLen) || DEFAULT_MAX_LEN;
-
-  const keys = capabilities.map(_normalize).filter(Boolean);
-  const primary = keys.find(function (k) { return TEMPLATES[k]; }) || keys[0] || 'general';
-  const tmplKey = TEMPLATES[primary] ? primary : 'general';
-
-  const seed = _hashFor(keys.concat(signals.slice(0, 4)));
-  const tmpl = _pickTemplate(tmplKey, seed);
-
-  if (tmpl) return _clip(tmpl, maxLen);
-
-  // Generic fallback when TEMPLATES does not have `general` (defensive).
-  const capsText = capabilities.length ? capabilities.slice(0, 3).join(', ') : 'a common task';
-  const fb = (opts && opts.fallback && String(opts.fallback).trim())
-    || 'I would like help with ' + capsText + '. Please provide one concrete, actionable answer.';
-  return _clip(fb, maxLen);
-}
-
-module.exports = {
-  compose,
-  // exported for tests
-  _normalize,
-  _pickTemplate,
-  _hashFor,
-  TEMPLATES,
-};

package/src/atp/serviceHelper.js

@@ -1,92 +0,0 @@
-// ATP Service Helper -- wraps marketplace service publishing for merchant agents.
-
-const { getNodeId, buildHubHeaders, buildNodeScopedHubHeaders, getHubUrl } = require('../gep/a2aProtocol');
-const { hubFetch } = require('../gep/hubFetch');
-const { HTTP_TRANSPORT_TIMEOUT_MS } = require('../config');
-
-async function postService(endpoint, body) {
-  try {
-    const buildHeaders = buildNodeScopedHubHeaders || buildHubHeaders;
-    const res = await hubFetch(endpoint, {
-      method: 'POST',
-      headers: Object.assign({ 'Content-Type': 'application/json' }, buildHeaders() || {}),
-      body: JSON.stringify(body),
-      signal: AbortSignal.timeout(HTTP_TRANSPORT_TIMEOUT_MS),
-    });
-
-    if (!res.ok) {
-      const t = await res.text();
-      return { ok: false, status: res.status, error: t.slice(0, 400) };
-    }
-    const data = await res.json();
-    return { ok: true, data };
-  } catch (err) {
-    const msg = (err && err.message) || String(err);
-    if (msg.indexOf('[hubFetch]') !== -1) {
-      return { ok: false, error: 'tls_refused: ' + msg };
-    }
-    return { ok: false, error: msg };
-  }
-}
-
-/**
- * Publish a ServiceListing via the Hub marketplace API.
- * @param {object} svc
- * @param {string} svc.title
- * @param {string} [svc.description]
- * @param {string[]} [svc.capabilities]
- * @param {string[]} [svc.useCases]
- * @param {number} [svc.pricePerTask] - min 1 Credit
- * @param {string} [svc.executionMode] - exclusive | open | swarm
- * @param {number} [svc.maxConcurrent]
- * @param {string} [svc.recipeId]
- * @returns {Promise<{ok: boolean, data?: object, error?: string}>}
- */
-async function publishService(svc) {
-  const hubUrl = getHubUrl();
-  if (!hubUrl) return { ok: false, error: 'no_hub_url' };
-
-  const nodeId = getNodeId();
-  const endpoint = hubUrl.replace(/\/+$/, '') + '/a2a/service/publish';
-
-  const body = {
-    sender_id: nodeId,
-    title: svc.title,
-    description: svc.description,
-    capabilities: svc.capabilities,
-    use_cases: svc.useCases,
-    price_per_task: Math.max(1, Math.round(Number(svc.pricePerTask) || 10)),
-    execution_mode: svc.executionMode || 'exclusive',
-    max_concurrent: Math.max(1, Math.round(Number(svc.maxConcurrent) || 3)),
-    recipe_id: svc.recipeId,
-  };
-
-  return postService(endpoint, body);
-}
-
-/**
- * Update an existing ServiceListing.
- * @param {string} listingId
- * @param {object} updates
- * @returns {Promise<{ok: boolean, data?: object, error?: string}>}
- */
-async function updateService(listingId, updates) {
-  const hubUrl = getHubUrl();
-  if (!hubUrl) return { ok: false, error: 'no_hub_url' };
-
-  const nodeId = getNodeId();
-  const endpoint = hubUrl.replace(/\/+$/, '') + '/a2a/service/update';
-
-  const body = {
-    sender_id: nodeId,
-    listing_id: listingId,
-    ...updates,
-  };
-
-  return postService(endpoint, body);
-}
-
-module.exports = {
-  publishService,
-  updateService,
-};

package/src/canary.js

@@ -1,13 +0,0 @@
-// Canary script: run in a forked child process to verify index.js loads
-// without crashing. Exit 0 = safe, non-zero = broken.
-//
-// This is the last safety net before solidify commits an evolution.
-// If a patch broke index.js (syntax error, missing require, etc.),
-// the canary catches it BEFORE the daemon restarts with broken code.
-try {
-  require('../index.js');
-  process.exit(0);
-} catch (e) {
-  process.stderr.write(String(e.message || e).slice(0, 500));
-  process.exit(1);
-}