pandora-cli-skills 1.1.13 → 1.1.15

package/cli/lib/market_admin_service.cjs

@@ -65,7 +65,7 @@ const PREDICTION_AMM_ABI = [
       { name: 'minCollateralOut', type: 'uint256' },
       { name: 'deadline', type: 'uint256' },
     ],
-    outputs: [{ type: 'uint256' }],
+    outputs: [],
   },
 ];
 

package/cli/lib/mirror_service.cjs

@@ -115,13 +115,18 @@ async function buildMirrorPlan(options = {}) {
   const distribution = computeDistributionHint(sourceYesProbability === null ? 0.5 : sourceYesProbability);
   const rules = buildRuleTemplate(sourceMarket);
 
-  const match = await findBestPandoraMatch({
-    indexerUrl: options.indexerUrl,
-    timeoutMs: options.timeoutMs,
-    chainId: options.chainId,
-    sourceQuestion: sourceMarket.question,
-    limit: 150,
-  });
+  let match = { best: null, diagnostics: [] };
+  try {
+    match = await findBestPandoraMatch({
+      indexerUrl: options.indexerUrl,
+      timeoutMs: options.timeoutMs,
+      chainId: options.chainId,
+      sourceQuestion: sourceMarket.question,
+      limit: 150,
+    });
+  } catch (err) {
+    diagnostics.push(`Duplicate-check fallback: ${err && err.message ? err.message : String(err)}`);
+  }
 
   if (Number.isFinite(sourceMarket.closeTimestamp)) {
     const nowSec = Math.floor(Date.now() / 1000);
@@ -405,20 +410,24 @@ async function browseMirrorMarkets(options = {}) {
   for (const entry of polymarket.items || []) {
     let existingMirror = null;
     if (options.indexerUrl) {
-      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,
-        };
+      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,
+          };
+        }
+        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 || []));
     }
 
     items.push({

package/cli/lib/mirror_sync_service.cjs

@@ -133,7 +133,8 @@ function evaluateStrictGates(context) {
   );
 
   const depthRequired = toNumber(context.plannedHedgeUsdc) || 0;
-  const depthAvailable = toNumber(context.depthWithinSlippageUsd) || 0;
+  const explicitHedgeDepth = toNumber(context.hedgeDepthWithinSlippageUsd);
+  const depthAvailable = explicitHedgeDepth === null ? toNumber(context.depthWithinSlippageUsd) || 0 : explicitHedgeDepth;
   add(
     'DEPTH_COVERAGE',
     depthRequired <= 0 ? true : depthAvailable >= depthRequired,
@@ -209,6 +210,7 @@ async function runMirrorSync(options, deps = {}) {
     hedgeEnabled: options.hedgeEnabled,
     hedgeRatio: options.hedgeRatio,
     hedgeTriggerUsdc: options.hedgeTriggerUsdc,
+    forceGate: Boolean(options.forceGate),
   };
 
   const hash = strategyHash(strategy);
@@ -354,6 +356,12 @@ async function runMirrorSync(options, deps = {}) {
         minTimeToExpirySec: snapshotMetrics.minTimeToExpirySec,
         minimumTimeToCloseSec,
         depthWithinSlippageUsd: depth.depthWithinSlippageUsd,
+        hedgeDepthWithinSlippageUsd:
+          plannedHedgeUsdc > 0
+            ? gapUsdc >= 0
+              ? depth.yesDepth && depth.yesDepth.depthUsd
+              : depth.noDepth && depth.noDepth.depthUsd
+            : null,
         depthSlippageBps: options.depthSlippageBps,
         maxOpenExposureUsdc: options.maxOpenExposureUsdc,
         maxTradesPerDay: options.maxTradesPerDay,
@@ -380,6 +388,16 @@ async function runMirrorSync(options, deps = {}) {
           plannedRebalanceUsdc,
           plannedSpendUsdc,
           depthWithinSlippageUsd: depth.depthWithinSlippageUsd,
+          hedgeDepthWithinSlippageUsd:
+            plannedHedgeUsdc > 0
+              ? gapUsdc >= 0
+                ? toNumber(depth.yesDepth && depth.yesDepth.depthUsd) || 0
+                : toNumber(depth.noDepth && depth.noDepth.depthUsd) || 0
+              : null,
+          yesDepthWithinSlippageUsd: toNumber(depth.yesDepth && depth.yesDepth.depthUsd),
+          noDepthWithinSlippageUsd: toNumber(depth.noDepth && depth.noDepth.depthUsd),
+          minDepthWithinSlippageUsd: toNumber(depth.minDepthWithinSlippageUsd),
+          bestDepthWithinSlippageUsd: toNumber(depth.bestDepthWithinSlippageUsd),
         },
         actionPlan: {
           rebalanceSide: plannedRebalanceUsdc > 0 ? rebalanceSide : null,
@@ -400,7 +418,7 @@ async function runMirrorSync(options, deps = {}) {
             reason: 'Duplicate trigger bucket (idempotency key already processed).',
             idempotencyKey,
           };
-        } else if (!gate.ok) {
+        } else if (!gate.ok && !options.forceGate) {
           snapshot.action = {
             mode: options.executeLive ? 'live' : 'paper',
             status: 'blocked',
@@ -413,6 +431,8 @@ async function runMirrorSync(options, deps = {}) {
             mode: options.executeLive ? 'live' : 'paper',
             status: options.executeLive ? 'executed' : 'simulated',
             idempotencyKey,
+            forcedGateBypass: Boolean(!gate.ok && options.forceGate),
+            failedChecks: !gate.ok ? gate.failedChecks : [],
             rebalance: null,
             hedge: null,
           };
@@ -578,6 +598,7 @@ async function runMirrorSync(options, deps = {}) {
       polymarketMarketId: options.polymarketMarketId,
       polymarketSlug: options.polymarketSlug,
       trustDeploy: Boolean(options.trustDeploy),
+      forceGate: Boolean(options.forceGate),
       intervalMs: options.intervalMs,
       minimumTimeToCloseSec,
       driftTriggerBps: options.driftTriggerBps,

package/cli/lib/mirror_verify_service.cjs

@@ -3,6 +3,7 @@ const { createIndexerClient } = require('./indexer_client.cjs');
 const { resolvePolymarketMarket } = require('./polymarket_trade_adapter.cjs');
 
 const MIRROR_VERIFY_SCHEMA_VERSION = '1.0.0';
+const USDC_DECIMALS = 6;
 
 function toNumber(value) {
   const numeric = Number(value);
@@ -16,6 +17,12 @@ function round(value, decimals = 6) {
   return Math.round(value * factor) / factor;
 }
 
+function normalizeUsdcRawToUsd(value) {
+  const numeric = toNumber(value);
+  if (numeric === null) return null;
+  return round(numeric / (10 ** USDC_DECIMALS), 6);
+}
+
 function normalizeQuestion(question) {
   return String(question || '')
     .toLowerCase()
@@ -125,8 +132,8 @@ function derivePandoraYesPct(market) {
     return round(yesFromChance * 100, 6);
   }
 
-  const reserveYes = toNumber(market && market.reserveYes);
-  const reserveNo = toNumber(market && market.reserveNo);
+  const reserveYes = normalizeUsdcRawToUsd(market && market.reserveYes);
+  const reserveNo = normalizeUsdcRawToUsd(market && market.reserveNo);
   if (reserveYes === null || reserveNo === null) return null;
 
   const total = reserveYes + reserveNo;
@@ -251,8 +258,8 @@ async function fetchPandoraMarketContext(options = {}) {
     closeTimestamp: toNumber(market.marketCloseTimestamp) || toNumber(poll && poll.deadlineEpoch),
     yesPct,
     noPct,
-    reserveYes: toNumber(market.reserveYes),
-    reserveNo: toNumber(market.reserveNo),
+    reserveYes: normalizeUsdcRawToUsd(market.reserveYes),
+    reserveNo: normalizeUsdcRawToUsd(market.reserveNo),
     totalVolumeUsd: toNumber(market.totalVolume),
     tvlUsd: toNumber(market.currentTvl),
     diagnostics,
@@ -288,17 +295,20 @@ function buildGateChecks({
   const strictRuleCheckOk = bothRulesPresent && rulesEqual;
   checks.push({
     code: 'RULE_HASH_MATCH',
-    ok: allowRuleMismatch ? true : strictRuleCheckOk,
-    message: allowRuleMismatch
-      ? 'Rule hash mismatch bypassed by --allow-rule-mismatch.'
-      : bothRulesPresent
-        ? 'Rule hashes must match.'
-        : 'Rule text missing on one or both sides.',
+    ok: trustDeploy ? true : allowRuleMismatch ? true : strictRuleCheckOk,
+    message: trustDeploy
+      ? 'Rule hash mismatch bypassed by trusted deploy pairing.'
+      : allowRuleMismatch
+        ? 'Rule hash mismatch bypassed by --allow-rule-mismatch.'
+        : bothRulesPresent
+          ? 'Rule hashes must match.'
+          : 'Rule text missing on one or both sides.',
     meta: {
       left: ruleHashes.left,
       right: ruleHashes.right,
       bothRulesPresent,
       rulesEqual: bothRulesPresent ? rulesEqual : null,
+      trustDeploy: Boolean(trustDeploy),
     },
   });
 

package/cli/lib/polymarket_trade_adapter.cjs

@@ -751,7 +751,15 @@ function calculateExecutableDepthUsd(orderbook, side, slippageBps) {
 
   const limitPriceFactor = slippageBps / 10_000;
   const entries = side === 'buy' ? normalized.asks : normalized.bids;
-  const priceLimit = side === 'buy' ? mid * (1 + limitPriceFactor) : mid * (1 - limitPriceFactor);
+  const bestBid = normalized.bids.length ? normalized.bids[0].price : null;
+  const bestAsk = normalized.asks.length ? normalized.asks[0].price : null;
+  const referencePrice =
+    side === 'buy'
+      ? (bestAsk !== null ? bestAsk : mid)
+      : (bestBid !== null ? bestBid : mid);
+  const priceLimit = side === 'buy'
+    ? referencePrice * (1 + limitPriceFactor)
+    : referencePrice * (1 - limitPriceFactor);
 
   let depthUsd = 0;
   let depthShares = 0;
@@ -770,6 +778,7 @@ function calculateExecutableDepthUsd(orderbook, side, slippageBps) {
     depthShares: round(depthShares, 6) || 0,
     worstPrice: worstPrice === null ? null : round(worstPrice, 8),
     midPrice: round(mid, 8),
+    referencePrice: round(referencePrice, 8),
     diagnostics: [],
   };
 }
@@ -850,7 +859,11 @@ async function fetchDepthForMarket(market, options = {}) {
   const noDepth = noBook ? calculateExecutableDepthUsd(noBook, 'buy', slippageBps) : null;
 
   const candidates = [yesDepth && yesDepth.depthUsd, noDepth && noDepth.depthUsd].filter((value) => Number.isFinite(value));
-  const depthWithinSlippageUsd = candidates.length ? Math.min(...candidates) : 0;
+  const minDepthWithinSlippageUsd = candidates.length ? Math.min(...candidates) : 0;
+  const bestDepthWithinSlippageUsd = candidates.length ? Math.max(...candidates) : 0;
+  // Keep the legacy/conservative aggregate as min depth (used by sizing paths),
+  // while exposing best-depth separately for hedge-side diagnostics.
+  const depthWithinSlippageUsd = minDepthWithinSlippageUsd;
 
   if (!yesDepth) diagnostics.push('YES token orderbook unavailable.');
   if (!noDepth) diagnostics.push('NO token orderbook unavailable.');
@@ -884,6 +897,8 @@ async function fetchDepthForMarket(market, options = {}) {
     slippageBps,
     host: hostUsed || null,
     depthWithinSlippageUsd: round(depthWithinSlippageUsd, 6) || 0,
+    minDepthWithinSlippageUsd: round(minDepthWithinSlippageUsd, 6) || 0,
+    bestDepthWithinSlippageUsd: round(bestDepthWithinSlippageUsd, 6) || 0,
     yesDepth,
     noDepth,
     cacheFile,

package/cli/pandora.cjs

@@ -21,7 +21,12 @@ const {
   daemonStatus: mirrorDaemonStatus,
 } = require('./lib/mirror_daemon_service.cjs');
 const { buildMirrorClosePlan } = require('./lib/mirror_close_service.cjs');
-const { fetchPolymarketPositionSummary } = require('./lib/polymarket_trade_adapter.cjs');
+const {
+  fetchPolymarketPositionSummary,
+  resolvePolymarketMarket,
+  placeHedgeOrder,
+  readTradingCredsFromEnv,
+} = require('./lib/polymarket_trade_adapter.cjs');
 const {
   runPolymarketCheck,
   runPolymarketApprove,
@@ -238,7 +243,7 @@ Usage:
   pandora [--output table|json] arbitrage [--chain-id <id>] [--venues pandora,polymarket] [--limit <n>] [--min-spread-pct <n>] [--min-liquidity-usdc <n>] [--max-close-diff-hours <n>] [--similarity-threshold <0-1>] [--cross-venue-only|--allow-same-venue] [--with-rules] [--include-similarity] [--question-contains <text>] [--polymarket-host <url>] [--polymarket-mock-url <url>]
   pandora [--output table|json] autopilot run|once --market-address <address> --side yes|no --amount-usdc <amount> [--trigger-yes-below <0-100>] [--trigger-yes-above <0-100>] [--paper|--execute-live] [--interval-ms <ms>] [--cooldown-ms <ms>] [--max-amount-usdc <amount>] [--max-open-exposure-usdc <amount>] [--max-trades-per-day <n>] [--state-file <path>] [--kill-switch-file <path>] [--webhook-url <url>] [--telegram-bot-token <token>] [--telegram-chat-id <id>] [--discord-webhook-url <url>]
   pandora [--output table|json] mirror browse|plan|deploy|verify|go|sync|status|close ...
-  pandora [--output table|json] polymarket check|approve|preflight ...
+  pandora [--output table|json] polymarket check|approve|preflight|trade ...
   pandora [--output table|json] webhook test [--webhook-url <url>] [--webhook-template <json>] [--webhook-secret <secret>] [--telegram-bot-token <token>] [--telegram-chat-id <id>] [--discord-webhook-url <url>] [--webhook-timeout-ms <ms>] [--webhook-retries <n>]
   pandora [--output table|json] leaderboard [--metric profit|volume|win-rate] [--chain-id <id>] [--limit <n>] [--min-trades <n>]
   pandora [--output table|json] analyze --market-address <address> [--provider <name>] [--model <id>] [--max-cost-usd <n>] [--temperature <n>] [--timeout-ms <ms>]
@@ -269,10 +274,11 @@ Examples:
   pandora mirror browse --min-yes-pct 20 --max-yes-pct 80 --min-volume-24h 100000 --limit 10
   pandora mirror verify --pandora-market-address 0xabc... --polymarket-market-id 0xdef... --include-similarity
   pandora mirror go --polymarket-slug nba-mia-phi-2026-02-28 --liquidity-usdc 10 --paper
-  pandora mirror sync once --pandora-market-address 0xabc... --polymarket-market-id 0xdef... --paper --hedge-ratio 1.0
+  pandora mirror sync once --pandora-market-address 0xabc... --polymarket-market-id 0xdef... --paper --hedge-ratio 1.0 --force-gate
   pandora polymarket check --rpc-url https://polygon-bor-rpc.publicnode.com --private-key 0x... --funder 0xproxy...
   pandora polymarket approve --dry-run --rpc-url https://polygon-bor-rpc.publicnode.com --private-key 0x... --funder 0xproxy...
   pandora polymarket preflight --rpc-url https://polygon-bor-rpc.publicnode.com --private-key 0x... --funder 0xproxy...
+  pandora polymarket trade --condition-id 0xabc... --token yes --amount-usdc 2 --dry-run
   pandora mirror close --pandora-market-address 0xabc... --polymarket-market-id 0xdef... --dry-run
   pandora webhook test --webhook-url https://example.com/hook --webhook-template '{\"text\":\"{{message}}\"}'
   pandora leaderboard --metric profit --limit 20
@@ -487,7 +493,7 @@ function helpJsonPayload() {
       'pandora [--output table|json] arbitrage ...',
       'pandora [--output table|json] autopilot run|once ...',
       'pandora [--output table|json] mirror plan|deploy|verify|sync|status ...',
-      'pandora [--output table|json] polymarket check|approve|preflight ...',
+      'pandora [--output table|json] polymarket check|approve|preflight|trade ...',
       'pandora [--output table|json] webhook test ...',
       'pandora [--output table|json] leaderboard ...',
       'pandora [--output table|json] analyze ...',
@@ -3261,6 +3267,7 @@ function parseMirrorSyncFlags(args) {
     discordWebhookUrl: null,
     failOnWebhookError: false,
     daemon: false,
+    forceGate: false,
   };
   let sawPaperModeFlag = false;
   let sawExecuteLiveModeFlag = false;
@@ -3451,6 +3458,10 @@ function parseMirrorSyncFlags(args) {
       options.trustDeploy = true;
       continue;
     }
+    if (token === '--force-gate' || token === '--skip-gate') {
+      options.forceGate = true;
+      continue;
+    }
     if (token === '--manifest-file') {
       options.manifestFile = requireFlagValue(rest, i, '--manifest-file');
       i += 1;
@@ -3508,6 +3519,7 @@ function parseMirrorSyncFlags(args) {
       hedgeEnabled: options.hedgeEnabled,
       hedgeRatio: options.hedgeRatio,
       hedgeTriggerUsdc: options.hedgeTriggerUsdc,
+      forceGate: options.forceGate,
     });
   }
   if (options.killSwitchFile === null) {
@@ -3563,6 +3575,7 @@ function buildMirrorSyncStrategy(options) {
     hedgeEnabled: options.hedgeEnabled,
     hedgeRatio: options.hedgeRatio,
     hedgeTriggerUsdc: options.hedgeTriggerUsdc,
+    forceGate: options.forceGate,
   };
 }
 
@@ -3628,6 +3641,7 @@ function buildMirrorSyncDaemonCliArgs(options, shared) {
   if (options.polymarketGammaMockUrl) args.push('--polymarket-gamma-mock-url', options.polymarketGammaMockUrl);
   if (options.polymarketMockUrl) args.push('--polymarket-mock-url', options.polymarketMockUrl);
   if (options.trustDeploy) args.push('--trust-deploy');
+  if (options.forceGate) args.push('--force-gate');
   if (options.manifestFile) args.push('--manifest-file', options.manifestFile);
 
   if (options.webhookUrl) args.push('--webhook-url', options.webhookUrl);
@@ -3676,6 +3690,7 @@ function parseMirrorGoFlags(args) {
     sources: [],
     manifestFile: null,
     trustDeploy: false,
+    forceGate: false,
     polymarketHost: null,
     polymarketGammaUrl: null,
     polymarketGammaMockUrl: null,
@@ -3857,6 +3872,10 @@ function parseMirrorGoFlags(args) {
       options.trustDeploy = true;
       continue;
     }
+    if (token === '--force-gate' || token === '--skip-gate') {
+      options.forceGate = true;
+      continue;
+    }
     if (token === '--polymarket-host') {
       options.polymarketHost = requireFlagValue(args, i, '--polymarket-host');
       i += 1;
@@ -4041,6 +4060,102 @@ function parsePolymarketApproveFlags(args) {
   return options;
 }
 
+function parsePolymarketTradeFlags(args) {
+  const options = {
+    conditionId: null,
+    slug: null,
+    token: null,
+    tokenId: null,
+    side: 'buy',
+    amountUsdc: null,
+    dryRun: false,
+    execute: false,
+    host: null,
+    rpcUrl: null,
+    privateKey: null,
+    funder: null,
+  };
+
+  const sharedArgs = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const token = args[i];
+    if (token === '--condition-id' || token === '--market-id') {
+      options.conditionId = requireFlagValue(args, i, token);
+      i += 1;
+      continue;
+    }
+    if (token === '--slug') {
+      options.slug = requireFlagValue(args, i, '--slug');
+      i += 1;
+      continue;
+    }
+    if (token === '--token') {
+      const value = String(requireFlagValue(args, i, '--token')).trim().toLowerCase();
+      if (!['yes', 'no'].includes(value)) {
+        throw new CliError('INVALID_FLAG_VALUE', '--token must be yes|no.');
+      }
+      options.token = value;
+      i += 1;
+      continue;
+    }
+    if (token === '--token-id') {
+      options.tokenId = requireFlagValue(args, i, '--token-id');
+      i += 1;
+      continue;
+    }
+    if (token === '--side') {
+      const value = String(requireFlagValue(args, i, '--side')).trim().toLowerCase();
+      if (!['buy', 'sell'].includes(value)) {
+        throw new CliError('INVALID_FLAG_VALUE', '--side must be buy|sell.');
+      }
+      options.side = value;
+      i += 1;
+      continue;
+    }
+    if (token === '--amount-usdc') {
+      options.amountUsdc = parsePositiveNumber(requireFlagValue(args, i, '--amount-usdc'), '--amount-usdc');
+      i += 1;
+      continue;
+    }
+    if (token === '--polymarket-host') {
+      options.host = requireFlagValue(args, i, '--polymarket-host');
+      i += 1;
+      continue;
+    }
+    if (token === '--dry-run') {
+      options.dryRun = true;
+      continue;
+    }
+    if (token === '--execute') {
+      options.execute = true;
+      continue;
+    }
+    sharedArgs.push(token);
+  }
+
+  if (options.dryRun === options.execute) {
+    throw new CliError('INVALID_ARGS', 'polymarket trade requires exactly one mode: --dry-run or --execute.');
+  }
+  if (options.amountUsdc === null) {
+    throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --amount-usdc <amount>.');
+  }
+  if (!options.tokenId && !options.token) {
+    throw new CliError('MISSING_REQUIRED_FLAG', 'Provide --token yes|no (or --token-id <id>).');
+  }
+  if (!options.tokenId && !options.conditionId && !options.slug) {
+    throw new CliError(
+      'MISSING_REQUIRED_FLAG',
+      'Provide --condition-id <id> or --slug <slug> when --token-id is not set.',
+    );
+  }
+
+  const shared = parsePolymarketSharedFlags(sharedArgs, 'trade');
+  options.rpcUrl = shared.rpcUrl;
+  options.privateKey = shared.privateKey;
+  options.funder = shared.funder;
+  return options;
+}
+
 function parseWebhookTestFlags(args) {
   const options = {
     webhookUrl: null,
@@ -4486,7 +4601,8 @@ async function rpcRequest(rpcUrl, method, params, timeoutMs) {
   return payload.result;
 }
 
-async function probeHttpEndpoint(url, timeoutMs, method = 'HEAD') {
+async function probeHttpEndpoint(url, timeoutMs, method = 'HEAD', options = {}) {
+  const acceptAnyHttpStatus = Boolean(options.acceptAnyHttpStatus);
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), timeoutMs);
   try {
@@ -4494,10 +4610,13 @@ async function probeHttpEndpoint(url, timeoutMs, method = 'HEAD') {
       method,
       signal: controller.signal,
     });
+    const reachable = acceptAnyHttpStatus
+      ? response.status >= 100 && response.status < 500
+      : response.ok;
     return {
-      ok: response.ok,
+      ok: reachable,
       status: response.status,
-      error: response.ok ? null : `HTTP ${response.status}`,
+      error: reachable ? null : `HTTP ${response.status}`,
     };
   } catch (err) {
     if (err && err.name === 'AbortError') {
@@ -4707,10 +4826,15 @@ async function buildDoctorReport(options) {
   }
 
   if (shouldCheckPolymarket) {
-    const hostProbe = await probeHttpEndpoint(report.polymarket.host, options.rpcTimeoutMs, 'HEAD');
+    const polymarketProbeTarget = `${String(report.polymarket.host).replace(/\/+$/, '')}/time`;
+    const hostProbe = await probeHttpEndpoint(polymarketProbeTarget, options.rpcTimeoutMs, 'GET', {
+      acceptAnyHttpStatus: true,
+    });
     report.polymarket.hostReachability = hostProbe;
     if (!hostProbe.ok) {
-      report.polymarket.failures.push(`Polymarket host reachability failed: ${hostProbe.error || 'unknown error'}`);
+      report.polymarket.failures.push(
+        `Polymarket host reachability failed (${polymarketProbeTarget}): ${hostProbe.error || 'unknown error'}`,
+      );
     }
 
     let polyCheck = null;
@@ -5735,7 +5859,26 @@ function renderSuggestTable(data) {
 }
 
 function renderSingleEntityTable(data) {
-  printRecord(data.item);
+  if (data && typeof data.item === 'object' && data.item !== null) {
+    printRecord(data.item);
+    return;
+  }
+  if (Array.isArray(data && data.items)) {
+    if (!data.items.length) {
+      console.log('No items found.');
+      return;
+    }
+    for (const item of data.items) {
+      printRecord(item);
+      console.log('');
+    }
+    return;
+  }
+  if (data && typeof data === 'object') {
+    printRecord(data);
+    return;
+  }
+  console.log(String(data));
 }
 
 function renderMarketsGetTable(data) {
@@ -8086,7 +8229,11 @@ function renderMirrorSyncTickLine(tickContext, outputMode) {
   const action = snapshot.action || null;
   const actionStatus = action && action.status ? action.status : 'idle';
   const gateCode =
-    action && Array.isArray(action.failedChecks) && action.failedChecks.length ? action.failedChecks[0] : '';
+    action && Array.isArray(action.failedChecks) && action.failedChecks.length
+      ? action.forcedGateBypass
+        ? `forced:${action.failedChecks[0]}`
+        : action.failedChecks[0]
+      : '';
 
   if (outputMode === 'json') {
     console.log(
@@ -8166,10 +8313,10 @@ async function runMirrorCommand(args, context) {
         '  verify --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--trust-deploy] [--manifest-file <path>] [--include-similarity] [--with-rules] [--allow-rule-mismatch]',
       );
       console.log(
-        '  go     --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--auto-sync] [--sync-once]',
+        '  go     --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--auto-sync] [--sync-once] [--force-gate]',
       );
       console.log(
-        '  sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--state-file <path>] [--kill-switch-file <path>]',
+        '  sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--state-file <path>] [--kill-switch-file <path>]',
       );
       console.log('  status --state-file <path>|--strategy-hash <hash> [--with-live] [--trust-deploy]');
       console.log('  close  --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute');
@@ -8470,7 +8617,7 @@ async function runMirrorCommand(args, context) {
   if (action === 'go') {
     if (includesHelpFlag(shared.rest)) {
       const usage =
-        'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--auto-sync] [--sync-once]';
+        'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--auto-sync] [--sync-once] [--force-gate]';
       if (context.outputMode === 'json') {
         emitSuccess(context.outputMode, 'mirror.go.help', commandHelpPayload(usage));
       } else {
@@ -8611,6 +8758,7 @@ async function runMirrorCommand(args, context) {
           polymarketGammaMockUrl: options.polymarketGammaMockUrl,
           polymarketMockUrl: options.polymarketMockUrl,
           trustDeploy,
+          forceGate: options.forceGate,
           webhookUrl: null,
           webhookTemplate: null,
           webhookSecret: null,
@@ -8672,6 +8820,7 @@ async function runMirrorCommand(args, context) {
           '--paper',
           `--drift-trigger-bps ${options.driftTriggerBps}`,
           `--hedge-trigger-usdc ${options.hedgeTriggerUsdc}`,
+          options.forceGate ? '--force-gate' : null,
         ]
           .filter(Boolean)
           .join(' ');
@@ -8714,7 +8863,7 @@ async function runMirrorCommand(args, context) {
           'mirror.sync.help',
           {
             usage:
-              'pandora [--output table|json] mirror sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
+              'pandora [--output table|json] mirror sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
             daemonLifecycle: {
               start:
                 'pandora [--output table|json] mirror sync start --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [run flags]',
@@ -8743,7 +8892,7 @@ async function runMirrorCommand(args, context) {
         );
       } else {
         console.log(
-          'Usage: pandora [--output table|json] mirror sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
+          'Usage: pandora [--output table|json] mirror sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
         );
         console.log('Daemon stop: pandora mirror sync stop --pid-file <path>|--strategy-hash <hash>');
         console.log('Daemon status: pandora mirror sync status --pid-file <path>|--strategy-hash <hash>');
@@ -8980,7 +9129,7 @@ async function runPolymarketCommand(args, context) {
   const actionArgs = args.slice(1);
 
   if (!action || action === '--help' || action === '-h') {
-    const usage = 'pandora [--output table|json] polymarket check|approve|preflight ...';
+    const usage = 'pandora [--output table|json] polymarket check|approve|preflight|trade ...';
     if (context.outputMode === 'json') {
       emitSuccess(context.outputMode, 'polymarket.help', commandHelpPayload(usage));
     } else {
@@ -8990,6 +9139,9 @@ async function runPolymarketCommand(args, context) {
       console.log('  check [--rpc-url <url>] [--private-key <hex>] [--funder <address>]');
       console.log('  approve --dry-run|--execute [--rpc-url <url>] [--private-key <hex>] [--funder <address>]');
       console.log('  preflight [--rpc-url <url>] [--private-key <hex>] [--funder <address>]');
+      console.log(
+        '  trade --condition-id <id>|--slug <slug>|--token-id <id> --token yes|no --amount-usdc <n> --dry-run|--execute [--side buy|sell] [--polymarket-host <url>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>]',
+      );
     }
     return;
   }
@@ -9064,7 +9216,102 @@ async function runPolymarketCommand(args, context) {
     return;
   }
 
-  throw new CliError('INVALID_ARGS', 'polymarket requires subcommand: check|approve|preflight');
+  if (action === 'trade') {
+    if (includesHelpFlag(actionArgs)) {
+      const usage =
+        'pandora [--output table|json] polymarket trade --condition-id <id>|--slug <slug>|--token-id <id> --token yes|no --amount-usdc <n> --dry-run|--execute [--side buy|sell] [--polymarket-host <url>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>]';
+      if (context.outputMode === 'json') {
+        emitSuccess(context.outputMode, 'polymarket.trade.help', commandHelpPayload(usage));
+      } else {
+        console.log(`Usage: ${usage}`);
+      }
+      return;
+    }
+
+    const options = parsePolymarketTradeFlags(actionArgs);
+    let market = null;
+    let tokenId = options.tokenId;
+    if (!tokenId) {
+      market = await resolvePolymarketMarket({
+        host: options.host || process.env.POLYMARKET_HOST || null,
+        timeoutMs: DEFAULT_INDEXER_TIMEOUT_MS,
+        marketId: options.conditionId,
+        slug: options.slug,
+      });
+      tokenId = options.token === 'yes' ? market.yesTokenId : market.noTokenId;
+      if (!tokenId) {
+        throw new CliError(
+          'POLYMARKET_TOKEN_MAPPING_FAILED',
+          `Unable to resolve ${String(options.token || '').toUpperCase()} token id for target market.`,
+          {
+            conditionId: options.conditionId,
+            slug: options.slug,
+            market,
+          },
+        );
+      }
+    }
+
+    if (options.dryRun) {
+      emitSuccess(context.outputMode, 'polymarket.trade', {
+        mode: 'dry-run',
+        status: 'planned',
+        conditionId: options.conditionId || (market && market.marketId) || null,
+        slug: options.slug || (market && market.slug) || null,
+        token: options.token || null,
+        tokenId,
+        side: options.side,
+        amountUsdc: options.amountUsdc,
+        host: options.host || process.env.POLYMARKET_HOST || null,
+      }, renderSingleEntityTable);
+      return;
+    }
+
+    const envCreds = readTradingCredsFromEnv();
+    let result;
+    try {
+      result = await placeHedgeOrder({
+        host: options.host || envCreds.host || null,
+        tokenId,
+        side: options.side,
+        amountUsd: options.amountUsdc,
+        privateKey: options.privateKey || envCreds.privateKey,
+        funder: options.funder || envCreds.funder,
+        apiKey: envCreds.apiKey,
+        apiSecret: envCreds.apiSecret,
+        apiPassphrase: envCreds.apiPassphrase,
+      });
+    } catch (err) {
+      throw new CliError(
+        'POLYMARKET_TRADE_FAILED',
+        err && err.message ? err.message : 'Polymarket trade execution failed.',
+        { cause: err && err.message ? err.message : String(err) },
+      );
+    }
+
+    if (!result || result.ok === false) {
+      throw new CliError(
+        'POLYMARKET_TRADE_FAILED',
+        result && result.error && result.error.message ? result.error.message : 'Polymarket order was rejected.',
+        { result },
+      );
+    }
+
+    emitSuccess(context.outputMode, 'polymarket.trade', {
+      mode: 'execute',
+      status: 'submitted',
+      conditionId: options.conditionId || (market && market.marketId) || null,
+      slug: options.slug || (market && market.slug) || null,
+      token: options.token || null,
+      tokenId,
+      side: options.side,
+      amountUsdc: options.amountUsdc,
+      result,
+    }, renderSingleEntityTable);
+    return;
+  }
+
+  throw new CliError('INVALID_ARGS', 'polymarket requires subcommand: check|approve|preflight|trade');
 }
 
 async function runWebhookCommand(args, context) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pandora-cli-skills",
-  "version": "1.1.13",
+  "version": "1.1.15",
   "description": "Pandora CLI & Skills",
   "main": "cli/pandora.cjs",
   "bin": {