pandora-cli-skills 1.1.57 → 1.1.59

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: pandora-cli-skills
 summary: Canonical skill and operator guide for Pandora CLI including mirror, polymarket, resolve, and LP flows.
-version: 1.1.57
+version: 1.1.59
 ---
 
 # Pandora CLI & Skills

package/cli/lib/mirror_service.cjs

@@ -3,7 +3,13 @@ const path = require('path');
 const crypto = require('crypto');
 const { computeLiquidityRecommendation, computeDistributionHint, normalizeProbability } = require('./mirror_sizing_service.cjs');
 const { resolvePolymarketMarket, fetchDepthForMarket, browsePolymarketMarkets } = require('./polymarket_trade_adapter.cjs');
-const { findBestPandoraMatch, fetchPandoraMarketContext, verifyMirrorPair, hashRules } = require('./mirror_verify_service.cjs');
+const {
+  findBestPandoraMatch,
+  fetchPandoraMarketContext,
+  verifyMirrorPair,
+  hashRules,
+  preloadPandoraMatchCandidates,
+} = require('./mirror_verify_service.cjs');
 const { deployPandoraAmmMarket } = require('./pandora_deploy_service.cjs');
 const { defaultManifestFile, upsertPair } = require('./mirror_manifest_store.cjs');
 const { round } = require('./shared/utils.cjs');
@@ -421,27 +427,45 @@ async function browseMirrorMarkets(options = {}) {
     limit: options.limit,
   });
 
+  let preloadedPandoraCandidates = null;
+  let preloadDuplicateCheckError = null;
+  if (options.indexerUrl) {
+    try {
+      preloadedPandoraCandidates = await preloadPandoraMatchCandidates({
+        indexerUrl: options.indexerUrl,
+        timeoutMs: options.timeoutMs,
+        chainId: options.chainId,
+        limit: 100,
+      });
+    } catch (err) {
+      preloadDuplicateCheckError = err;
+    }
+  }
+
   const items = [];
   for (const entry of polymarket.items || []) {
     let existingMirror = null;
     if (options.indexerUrl) {
-      try {
-        const match = await findBestPandoraMatch({
-          indexerUrl: options.indexerUrl,
-          timeoutMs: options.timeoutMs,
-          chainId: options.chainId,
-          sourceQuestion: entry.question,
-          limit: 100,
-        });
-        if (match.best && match.best.similarity && Number(match.best.similarity.score) >= 0.86) {
-          existingMirror = {
-            marketAddress: match.best.marketAddress,
-            similarity: match.best.similarity.score,
-          };
+      if (preloadDuplicateCheckError) {
+        diagnostics.push(
+          `Duplicate-check skipped for "${entry.slug || entry.marketId || entry.question || 'market'}": ${preloadDuplicateCheckError && preloadDuplicateCheckError.message ? preloadDuplicateCheckError.message : String(preloadDuplicateCheckError)}`,
+        );
+      } else {
+        try {
+          const match = await findBestPandoraMatch({
+            sourceQuestion: entry.question,
+            candidateSet: preloadedPandoraCandidates,
+          });
+          if (match.best && match.best.similarity && Number(match.best.similarity.score) >= 0.86) {
+            existingMirror = {
+              marketAddress: match.best.marketAddress,
+              similarity: match.best.similarity.score,
+            };
+          }
+          diagnostics.push(...(match.diagnostics || []));
+        } catch (err) {
+          diagnostics.push(`Duplicate-check skipped for "${entry.slug || entry.marketId || entry.question || 'market'}": ${err && err.message ? err.message : String(err)}`);
         }
-        diagnostics.push(...(match.diagnostics || []));
-      } catch (err) {
-        diagnostics.push(`Duplicate-check skipped for "${entry.slug || entry.marketId || entry.question || 'market'}": ${err && err.message ? err.message : String(err)}`);
       }
     }
 

package/cli/lib/mirror_verify_service.cjs

@@ -161,6 +161,91 @@ async function fetchPandoraMarketContext(options = {}) {
   };
 }
 
+function buildPandoraMatchCandidates(markets, pollsMap) {
+  const rows = [];
+
+  for (const market of Array.isArray(markets) ? markets : []) {
+    const pollAddress = String(market && market.pollAddress ? market.pollAddress : '').trim();
+    const poll = pollsMap.get(pollAddress.toLowerCase()) || pollsMap.get(pollAddress);
+    const question = poll && poll.question ? String(poll.question) : null;
+    if (!question) continue;
+
+    rows.push({
+      marketAddress: market.id,
+      pollAddress: market.pollAddress,
+      question,
+      status: toOptionalNumber(poll && poll.status),
+      rules: poll && poll.rules ? String(poll.rules) : null,
+      yesPct: derivePandoraYesPct(market),
+      closeTimestamp: toOptionalNumber(market.marketCloseTimestamp),
+      chainId: toOptionalNumber(market.chainId),
+      marketType: market.marketType || null,
+    });
+  }
+
+  return rows;
+}
+
+function scorePandoraMatchCandidates(sourceQuestion, candidates) {
+  const rows = (Array.isArray(candidates) ? candidates : []).map((candidate) => ({
+    ...candidate,
+    similarity: questionSimilarityBreakdown(sourceQuestion, candidate.question),
+  }));
+
+  rows.sort((a, b) => (b.similarity.score || 0) - (a.similarity.score || 0));
+
+  const diagnostics = [];
+  const best = rows[0] || null;
+  if (!best) diagnostics.push('No Pandora candidate markets with poll questions were found.');
+
+  return {
+    generatedAt: new Date().toISOString(),
+    best,
+    candidateCount: rows.length,
+    diagnostics,
+  };
+}
+
+async function preloadPandoraMatchCandidates(options = {}) {
+  const client = createIndexerClient(options.indexerUrl, options.timeoutMs);
+
+  const page = await client.list({
+    queryName: 'marketss',
+    filterType: 'marketsFilter',
+    fields: ['id', 'chainId', 'marketType', 'pollAddress', 'marketCloseTimestamp', 'yesChance', 'reserveYes', 'reserveNo'],
+    variables: {
+      where: {
+        ...(options.chainId !== null && options.chainId !== undefined ? { chainId: options.chainId } : {}),
+      },
+      orderBy: 'createdAt',
+      orderDirection: 'desc',
+      before: null,
+      after: null,
+      limit: Math.max(25, Math.min(Number(options.limit) || 150, 500)),
+    },
+  });
+
+  const markets = Array.isArray(page.items) ? page.items : [];
+  const pollIds = Array.from(
+    new Set(
+      markets
+        .map((market) => String(market && market.pollAddress ? market.pollAddress : '').trim())
+        .filter(Boolean),
+    ),
+  );
+
+  const pollsMap = await client.getManyByIds({
+    queryName: 'polls',
+    fields: ['id', 'question', 'status', 'deadlineEpoch', 'rules'],
+    ids: pollIds,
+  });
+
+  return {
+    generatedAt: new Date().toISOString(),
+    candidates: buildPandoraMatchCandidates(markets, pollsMap),
+  };
+}
+
 function buildGateChecks({
   similarity,
   confidenceThreshold,
@@ -325,71 +410,8 @@ async function verifyMirrorPair(options = {}) {
 }
 
 async function findBestPandoraMatch(options = {}) {
-  const diagnostics = [];
-  const client = createIndexerClient(options.indexerUrl, options.timeoutMs);
-
-  const page = await client.list({
-    queryName: 'marketss',
-    filterType: 'marketsFilter',
-    fields: ['id', 'chainId', 'marketType', 'pollAddress', 'marketCloseTimestamp', 'yesChance', 'reserveYes', 'reserveNo'],
-    variables: {
-      where: {
-        ...(options.chainId !== null && options.chainId !== undefined ? { chainId: options.chainId } : {}),
-      },
-      orderBy: 'createdAt',
-      orderDirection: 'desc',
-      before: null,
-      after: null,
-      limit: Math.max(25, Math.min(Number(options.limit) || 150, 500)),
-    },
-  });
-
-  const markets = Array.isArray(page.items) ? page.items : [];
-  const pollIds = Array.from(
-    new Set(
-      markets
-        .map((market) => String(market && market.pollAddress ? market.pollAddress : '').trim())
-        .filter(Boolean),
-    ),
-  );
-
-  const pollsMap = await client.getManyByIds({
-    queryName: 'polls',
-    fields: ['id', 'question', 'status', 'deadlineEpoch', 'rules'],
-    ids: pollIds,
-  });
-
-  const rows = [];
-  for (const market of markets) {
-    const poll = pollsMap.get(String(market.pollAddress || '').toLowerCase()) || pollsMap.get(String(market.pollAddress || ''));
-    const question = poll && poll.question ? String(poll.question) : null;
-    if (!question) continue;
-
-    const similarity = questionSimilarityBreakdown(options.sourceQuestion, question);
-    rows.push({
-      marketAddress: market.id,
-      pollAddress: market.pollAddress,
-      question,
-      similarity,
-      status: toOptionalNumber(poll && poll.status),
-      rules: poll && poll.rules ? String(poll.rules) : null,
-      yesPct: derivePandoraYesPct(market),
-      closeTimestamp: toOptionalNumber(market.marketCloseTimestamp),
-      chainId: toOptionalNumber(market.chainId),
-      marketType: market.marketType || null,
-    });
-  }
-
-  rows.sort((a, b) => (b.similarity.score || 0) - (a.similarity.score || 0));
-  const best = rows[0] || null;
-  if (!best) diagnostics.push('No Pandora candidate markets with poll questions were found.');
-
-  return {
-    generatedAt: new Date().toISOString(),
-    best,
-    candidateCount: rows.length,
-    diagnostics,
-  };
+  const candidateSet = options.candidateSet || (await preloadPandoraMatchCandidates(options));
+  return scorePandoraMatchCandidates(options.sourceQuestion, candidateSet && candidateSet.candidates);
 }
 
 module.exports = {
@@ -400,5 +422,6 @@ module.exports = {
   questionSimilarityBreakdown,
   fetchPandoraMarketContext,
   verifyMirrorPair,
+  preloadPandoraMatchCandidates,
   findBestPandoraMatch,
 };

package/cli/lib/quant/abm_market.cjs

@@ -1,5 +1,3 @@
-const { createRng } = require('./rng.cjs');
-const { mean, standardDeviation } = require('./mc_stats.cjs');
 const { createQuantError } = require('./errors.cjs');
 
 const ABM_SCHEMA_VERSION = '1.0.0';
@@ -10,6 +8,67 @@ function clamp(value, min, max) {
   return Math.min(max, Math.max(min, value));
 }
 
+function createRng(seed) {
+  let state = Number.isInteger(seed) ? seed >>> 0 : 1;
+
+  function next() {
+    state += 0x6d2b79f5;
+    let t = Math.imul(state ^ (state >>> 15), 1 | state);
+    t ^= t + Math.imul(t ^ (t >>> 7), 61 | t);
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+  }
+
+  let spare = null;
+  function nextNormal(meanValue = 0, stdDev = 1) {
+    if (spare !== null) {
+      const value = spare;
+      spare = null;
+      return meanValue + value * stdDev;
+    }
+
+    let u1 = next();
+    let u2 = next();
+    if (u1 <= Number.EPSILON) u1 = Number.EPSILON;
+    if (u2 <= Number.EPSILON) u2 = Number.EPSILON;
+
+    const radius = Math.sqrt(-2 * Math.log(u1));
+    const theta = 2 * Math.PI * u2;
+    const z0 = radius * Math.cos(theta);
+    const z1 = radius * Math.sin(theta);
+    spare = z1;
+    return meanValue + z0 * stdDev;
+  }
+
+  return {
+    next,
+    nextNormal,
+  };
+}
+
+function mean(values) {
+  if (!Array.isArray(values) || values.length === 0) {
+    return 0;
+  }
+  let total = 0;
+  for (const value of values) {
+    total += value;
+  }
+  return total / values.length;
+}
+
+function standardDeviation(values) {
+  if (!Array.isArray(values) || values.length === 0) {
+    return 0;
+  }
+  const average = mean(values);
+  let variance = 0;
+  for (const value of values) {
+    const delta = value - average;
+    variance += delta * delta;
+  }
+  return Math.sqrt(variance / values.length);
+}
+
 function validatePositiveInteger(value, name) {
   const numeric = Number(value);
   if (!Number.isInteger(numeric) || numeric <= 0) {

package/cli/lib/scan_command_service.cjs

@@ -7,6 +7,7 @@ const SCAN_USAGE =
   'pandora [--output table|json] scan [--limit <n>] [--after <cursor>] [--before <cursor>] [--order-by <field>] [--order-direction asc|desc] [--chain-id <id>] [--creator <address>] [--poll-address <address>] [--market-type <type>|--type <type>] [--where-json <json>] [--active|--resolved|--expiring-soon] [--expiring-hours <n>] [--min-tvl <usdc>] [--hedgeable] [--expand] [--with-odds]';
 
 const SCAN_NOTES = [
+  'scan is a top-level alias for `markets scan`; prefer `markets scan` in docs and scripts.',
   'scan always returns expanded market payloads with odds included.',
   '--with-odds is accepted for backward compatibility and is effectively a no-op.',
   '--min-tvl applies a client-side filter against current TVL in USDC units.',