pandora-cli-skills 1.1.29 → 1.1.30

package/SKILL.md

@@ -110,7 +110,7 @@ lp-explain --liquidity-usdc <n> [--source-yes-pct <0-100>] [--distribution-yes <
 hedge-calc [--reserve-yes-usdc <n> --reserve-no-usdc <n>] [--excess-yes-usdc <n>] [--excess-no-usdc <n>] [--polymarket-yes-pct <0-100>] [--hedge-ratio <n>] [--hedge-cost-bps <n>] [--volume-scenarios <csv>] [--pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug>] [--trust-deploy] [--manifest-file <path>]
 simulate --liquidity-usdc <n> [--source-yes-pct <0-100>] [--target-yes-pct <0-100>] [--distribution-yes <parts>] [--distribution-no <parts>] [--fee-tier 500|3000|10000] [--volume-scenarios <csv>] [--hedge-ratio <n>] [--hedge-cost-bps <n>] [--polymarket-yes-pct <0-100>]
 go     --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--fee-tier 500|3000|10000] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--paper|--dry-run|--execute-live|--execute] [--auto-sync] [--sync-once] [--sync-interval-ms <ms>] [--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>] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>] [--usdc <address>] [--oracle <address>] [--factory <address>] [--sources <url...>] [--manifest-file <path>] [--trust-deploy] [--skip-gate] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--with-rules] [--include-similarity] [--min-close-lead-seconds <n>]
-sync run|once|start|stop|status --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--dry-run|--execute-live|--execute] [--private-key <hex>] [--funder <address>] [--usdc <address>] [--trust-deploy] [--manifest-file <path>] [--skip-gate] [--daemon] [--stream|--no-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>] [--depth-slippage-bps <n>] [--min-time-to-close-sec <n>] [--iterations <n>] [--state-file <path>] [--kill-switch-file <path>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--webhook-url <url>] [--telegram-bot-token <token>] [--discord-webhook-url <url>]
+sync run|once|start --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--dry-run|--execute-live|--execute] [--private-key <hex>] [--funder <address>] [--usdc <address>] [--trust-deploy] [--manifest-file <path>] [--skip-gate] [--daemon] [--stream|--no-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>] [--depth-slippage-bps <n>] [--min-time-to-close-sec <n>] [--iterations <n>] [--state-file <path>] [--kill-switch-file <path>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--webhook-url <url>] [--telegram-bot-token <token>] [--telegram-chat-id <id>] [--discord-webhook-url <url>]
 status --state-file <path>|--strategy-hash <hash> [--with-live] [--pandora-market-address <address>|--market-address <address>] [--polymarket-market-id <id>|--polymarket-slug <slug>]
 close  --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute
 ```
@@ -257,6 +257,7 @@ pandora --output json suggest --wallet <0x...> --risk medium --budget 50 --inclu
   - Polymarket trading collateral is Polygon USDC.e on the proxy wallet.
   - rebalance sizing is pool-aware and bounded by `--max-rebalance-usdc`.
   - endpoint resilience: Polymarket snapshots are cached under `~/.pandora/polymarket`; paper/read flows can reuse cache during outages, while live sync blocks cached sources.
+  - daemon verification note: `mirror sync start` launches a child process that executes `cli/pandora.cjs` and enters the same CLI `main()` handlers, so crash/error handling remains covered by the normal command dispatcher + structured error envelopes.
 - `mirror status`: local mirror state inspection with optional live market diagnostics (`--with-live`).
   - `--with-live` uses the same `POLYMARKET_*` env keys for optional position visibility (YES/NO balances, open orders count, estimated value) and adds `netDeltaApprox` / `pnlApprox`.
   - missing credentials or unavailable position endpoints do not hard-fail status; diagnostics are returned with null position fields.
@@ -346,6 +347,25 @@ Error envelope:
 ## Additional JSON response shapes
 - `doctor`:
   - `{ ok: true, command: "doctor", data: { schemaVersion, generatedAt, env, rpc, codeChecks, polymarket, summary } }`
+- `history`:
+  - `{ ok: true, command: "history", data: { schemaVersion, generatedAt, indexerUrl, wallet, chainId, filters, pagination, pageInfo, summary, count, items[] } }`
+  - each `items[]` row includes `entryPriceUsdcPerToken`, `markPriceUsdcPerToken`, `currentValueUsdc`, `pnlUnrealizedApproxUsdc`, `pnlRealizedApproxUsdc`, `status`, and `diagnostics[]`.
+- `export`:
+  - `{ ok: true, command: "export", data: { schemaVersion, generatedAt, format: "csv"|"json", wallet, chainId, count, filters, columns[], outPath, rows[], content } }`
+  - `content` is the deterministic serialized payload written to `outPath` when `--out` is provided.
+- `arbitrage`:
+  - `{ ok: true, command: "arbitrage", data: { schemaVersion, generatedAt, indexerUrl, venues, filters, count, opportunities[], diagnostics[] } }`
+- `autopilot`:
+  - `{ ok: true, command: "autopilot", data: { schemaVersion, generatedAt, strategyHash, mode, executeLive, stateFile, killSwitchFile, iterationsRequested, iterationsCompleted, stoppedReason?, parameters: { marketAddress, side, amountUsdc, triggerYesBelow?, triggerYesAbove?, intervalMs, cooldownMs, maxAmountUsdc?, maxOpenExposureUsdc, dailySpendCapUsdc, maxTradesPerDay }, state, actionCount, actions[], snapshots[], webhookReports[] } }`
+- `mirror browse`:
+  - `{ ok: true, command: "mirror.browse", data: { schemaVersion, generatedAt, source, gammaApiError, filters, count, items[], diagnostics[] } }`
+  - each candidate row can include `existingMirror: { marketAddress, similarity } | null`.
+- `mirror go`:
+  - `{ ok: true, command: "mirror.go", data: { schemaVersion, generatedAt, mode, plan, deploy, verify, sync, polymarketPreflight, suggestedSyncCommand, trustManifest, diagnostics[] } }`
+  - `plan` is the same payload shape as `mirror.plan`; `deploy` is the same payload shape as `mirror.deploy`; `sync` is null unless `--auto-sync` is used.
+- close peers:
+  - `mirror close`: `{ ok: true, command: "mirror.close", data: { schemaVersion, generatedAt, mode, pandoraMarketAddress, polymarketMarketId?, polymarketSlug?, steps[], diagnostics[] } }`
+  - `mirror sync start|status|stop`: `{ ok: true, command: "mirror.sync.start|mirror.sync.status|mirror.sync.stop", data: { strategyHash, pid?, pidFile, logFile?, alive, status, metadata? } }`
 - `resolve`:
   - dry-run: `{ ok: true, command: "resolve", data: { schemaVersion, generatedAt, mode: "dry-run", txPlan } }`
   - execute: `{ ok: true, command: "resolve", data: { schemaVersion, generatedAt, mode: "execute", tx } }`
@@ -354,6 +374,12 @@ Error envelope:
   - `lp positions`: `{ ok: true, command: "lp", data: { schemaVersion, generatedAt, action: "positions", mode: "read", wallet, count, items[] } }`
 - `polymarket`:
   - `check|preflight|approve|trade` all return `{ ok: true, command, data }` with `schemaVersion` and `generatedAt`; execute paths include `result`/`tx` blocks.
+- `leaderboard`:
+  - `{ ok: true, command: "leaderboard", data: { schemaVersion, generatedAt, indexerUrl, metric, limit, minTrades, count, items[], diagnostics[] } }`
+- `analyze`:
+  - `{ ok: true, command: "analyze", data: { schemaVersion, generatedAt, indexerUrl, marketAddress, provider, model, market, quote, result } }`
+- `suggest`:
+  - `{ ok: true, command: "suggest", data: { schemaVersion, generatedAt, wallet, risk, budget, count, items[], indexerUrl, includeVenues, historySummary, arbitrageCount } }`
 
 ## Pandora mainnet deployment reference
 - PredictionOracle (Factory): `0x259308E7d8557e4Ba192De1aB8Cf7e0E21896442`

package/cli/lib/arbitrage_service.cjs

@@ -5,21 +5,10 @@ const {
   questionSimilarityBreakdown,
   questionSimilarity,
 } = require('./similarity_service.cjs');
+const { toNumber, round } = require('./shared/utils.cjs');
 
 const ARBITRAGE_SCHEMA_VERSION = '1.1.0';
 
-function toNumber(value) {
-  const numeric = Number(value);
-  if (!Number.isFinite(numeric)) return null;
-  return numeric;
-}
-
-function round(value, decimals = 6) {
-  if (!Number.isFinite(value)) return null;
-  const factor = 10 ** decimals;
-  return Math.round(value * factor) / factor;
-}
-
 function toUsdc(raw) {
   const numeric = toNumber(raw);
   if (numeric === null) return null;

package/cli/lib/autopilot_service.cjs

@@ -9,17 +9,7 @@ const {
   pruneIdempotencyKeys,
   resetDailyCountersIfNeeded,
 } = require('./autopilot_state_store.cjs');
-
-function toNumber(value) {
-  const numeric = Number(value);
-  if (!Number.isFinite(numeric)) return null;
-  return numeric;
-}
-
-function sleepMs(ms) {
-  if (!Number.isFinite(ms) || ms <= 0) return Promise.resolve();
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
+const { toNumber, sleepMs } = require('./shared/utils.cjs');
 
 function buildIdempotencyKey(options, quote, nowMs) {
   const yesPct = toNumber(quote && quote.odds && quote.odds.yesPct);

package/cli/lib/history_service.cjs

@@ -1,4 +1,5 @@
 const { createIndexerClient } = require('./indexer_client.cjs');
+const { round } = require('./shared/utils.cjs');
 
 const USDC_DECIMALS = 6;
 const HISTORY_SCHEMA_VERSION = '1.0.0';
@@ -10,12 +11,6 @@ function toNumber(value) {
   return numeric;
 }
 
-function round(value, decimals = 6) {
-  if (!Number.isFinite(value)) return null;
-  const factor = 10 ** decimals;
-  return Math.round(value * factor) / factor;
-}
-
 function toUsdc(raw) {
   const numeric = toNumber(raw);
   if (numeric === null) return null;

package/cli/lib/leaderboard_service.cjs

@@ -1,13 +1,8 @@
 const { createIndexerClient } = require('./indexer_client.cjs');
+const { toNumber } = require('./shared/utils.cjs');
 
 const LEADERBOARD_SCHEMA_VERSION = '1.0.0';
 
-function toNumber(value) {
-  const numeric = Number(value);
-  if (!Number.isFinite(numeric)) return null;
-  return numeric;
-}
-
 function toCount(value) {
   const numeric = toNumber(value);
   if (numeric === null || numeric < 0) return 0;

package/cli/lib/market_admin_service.cjs

@@ -1,8 +1,4 @@
-const DEFAULT_INDEXER_URL = 'https://pandoraindexer.up.railway.app/';
-const DEFAULT_RPC_BY_CHAIN_ID = {
-  1: 'https://ethereum.publicnode.com',
-  146: 'https://rpc.soniclabs.com',
-};
+const { DEFAULT_INDEXER_URL, DEFAULT_RPC_BY_CHAIN_ID } = require('./shared/constants.cjs');
 
 const ERC20_ABI = [
   {
@@ -180,6 +176,12 @@ function normalizeTimeoutMs(value) {
   return Math.trunc(numeric);
 }
 
+/**
+ * Convert numeric-like input into a finite number.
+ * Used by LP/resolve input normalization paths.
+ * @param {*} value
+ * @returns {number|null}
+ */
 function toFiniteNumber(value) {
   const numeric = Number(value);
   if (!Number.isFinite(numeric)) return null;
@@ -313,6 +315,14 @@ async function readDecimals(publicClient, address, fallback = 18) {
   }
 }
 
+/**
+ * Read optional `calcRemoveLiquidity` preview outputs.
+ * Returned values are raw on-chain integers as decimal strings.
+ * @param {object} publicClient
+ * @param {string} marketAddress
+ * @param {bigint} sharesRaw
+ * @returns {Promise<{collateralOutRaw: string|null, yesOutRaw: string|null, noOutRaw: string|null}|null>}
+ */
 async function readCalcRemoveLiquidity(publicClient, marketAddress, sharesRaw) {
   for (const abi of CALC_REMOVE_LIQUIDITY_ABI_CANDIDATES) {
     try {
@@ -395,6 +405,11 @@ async function discoverLiquidityMarkets(indexerUrl, wallet, chainId, timeoutMs)
   return Array.from(new Set(addresses));
 }
 
+/**
+ * Resolve a market outcome by calling `resolveMarket(bool)`.
+ * @param {object} [options]
+ * @returns {Promise<object>}
+ */
 async function runResolve(options = {}) {
   const schemaVersion = '1.0.0';
   const generatedAt = new Date().toISOString();
@@ -468,6 +483,13 @@ async function runResolve(options = {}) {
   }
 }
 
+/**
+ * Read LP balances and remove-liquidity previews for a wallet.
+ * LP/share values are raw and human-readable decimal strings in the payload.
+ * `collateralOutUsdc` is decimal USDC (6 decimals).
+ * @param {object} [options]
+ * @returns {Promise<object>}
+ */
 async function runLpPositions(options = {}) {
   const schemaVersion = '1.0.0';
   const generatedAt = new Date().toISOString();
@@ -570,6 +592,12 @@ async function runLpPositions(options = {}) {
   };
 }
 
+/**
+ * Build or execute `addLiquidity`.
+ * `amountUsdc` is decimal USDC input; `collateralAmountRaw` is 6-decimal raw units.
+ * @param {object} [options]
+ * @returns {Promise<object>}
+ */
 async function runLpAdd(options = {}) {
   const schemaVersion = '1.0.0';
   const generatedAt = new Date().toISOString();
@@ -719,6 +747,12 @@ async function runLpAdd(options = {}) {
   }
 }
 
+/**
+ * Build or execute `removeLiquidity`.
+ * `lpTokens` is decimal LP token amount; `sharesToBurnRaw` is on-chain raw units.
+ * @param {object} [options]
+ * @returns {Promise<object>}
+ */
 async function runLpRemove(options = {}) {
   const schemaVersion = '1.0.0';
   const generatedAt = new Date().toISOString();
@@ -825,6 +859,11 @@ async function runLpRemove(options = {}) {
   }
 }
 
+/**
+ * Dispatch LP admin action (`positions`, `add`, `remove`).
+ * @param {object} [options]
+ * @returns {Promise<object>}
+ */
 async function runLp(options = {}) {
   if (options.action === 'positions') {
     return runLpPositions(options);
@@ -838,6 +877,7 @@ async function runLp(options = {}) {
   throw createServiceError('INVALID_ARGS', 'lp requires action add|remove|positions.');
 }
 
+/** Public market admin API consumed by CLI `resolve` and `lp` commands. */
 module.exports = {
   runResolve,
   runLp,

package/cli/lib/mirror_command_service.cjs

@@ -0,0 +1,133 @@
+const MIRROR_GO_USAGE =
+  'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--fee-tier 500|3000|10000] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--paper|--dry-run|--execute-live|--execute] [--auto-sync] [--sync-once] [--sync-interval-ms <ms>] [--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>] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>] [--usdc <address>] [--oracle <address>] [--factory <address>] [--sources <url...>] [--manifest-file <path>] [--trust-deploy] [--skip-gate] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--with-rules] [--include-similarity] [--min-close-lead-seconds <n>]';
+
+const MIRROR_SYNC_USAGE =
+  'pandora [--output table|json] mirror sync run|once|start --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--dry-run|--execute-live|--execute] [--private-key <hex>] [--funder <address>] [--usdc <address>] [--trust-deploy] [--manifest-file <path>] [--skip-gate] [--daemon] [--stream|--no-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>] [--depth-slippage-bps <n>] [--min-time-to-close-sec <n>] [--iterations <n>] [--state-file <path>] [--kill-switch-file <path>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--webhook-url <url>] [--telegram-bot-token <token>] [--telegram-chat-id <id>] [--discord-webhook-url <url>]';
+
+const INVALID_SUBCOMMAND_MESSAGE =
+  'mirror requires subcommand: browse|plan|deploy|verify|lp-explain|hedge-calc|simulate|go|sync|status|close';
+
+function createRunMirrorCommand(deps) {
+  const {
+    CliError,
+    emitSuccess,
+    commandHelpPayload,
+    parseIndexerSharedFlags,
+  } = deps;
+
+  const handlerLoaders = {
+    browse: () => require('./mirror_handlers/browse.cjs'),
+    plan: () => require('./mirror_handlers/plan.cjs'),
+    deploy: () => require('./mirror_handlers/deploy.cjs'),
+    verify: () => require('./mirror_handlers/verify.cjs'),
+    'lp-explain': () => require('./mirror_handlers/lp_explain.cjs'),
+    'hedge-calc': () => require('./mirror_handlers/hedge_calc.cjs'),
+    simulate: () => require('./mirror_handlers/simulate.cjs'),
+    go: () => require('./mirror_handlers/go.cjs'),
+    sync: () => require('./mirror_handlers/sync.cjs'),
+    status: () => require('./mirror_handlers/status.cjs'),
+    close: () => require('./mirror_handlers/close.cjs'),
+  };
+  const handlerCache = new Map();
+
+  function getHandler(action) {
+    if (handlerCache.has(action)) {
+      return handlerCache.get(action);
+    }
+
+    const load = handlerLoaders[action];
+    if (!load) {
+      return null;
+    }
+
+    const loaded = load();
+    const handler =
+      typeof loaded === 'function'
+        ? loaded
+        : loaded && typeof loaded.handle === 'function'
+          ? loaded.handle
+          : null;
+
+    if (!handler) {
+      throw new Error(`Invalid mirror handler module for action: ${action}`);
+    }
+
+    handlerCache.set(action, handler);
+    return handler;
+  }
+
+  return async function runMirrorCommand(args, context) {
+    const action = args[0];
+    const actionArgs = args.slice(1);
+
+    if (!action || action === '--help' || action === '-h') {
+      if (context.outputMode === 'json') {
+        emitSuccess(
+          context.outputMode,
+          'mirror.help',
+          commandHelpPayload(
+            'pandora [--output table|json] mirror browse|plan|deploy|verify|lp-explain|hedge-calc|simulate|go|sync|status|close ...',
+          ),
+        );
+      } else {
+        console.log(
+          'Usage: pandora [--output table|json] mirror browse|plan|deploy|verify|lp-explain|hedge-calc|simulate|go|sync|status|close ...',
+        );
+        console.log('');
+        console.log('Subcommands:');
+        console.log(
+          '  browse --min-yes-pct <n> --max-yes-pct <n> --min-volume-24h <n> [--closes-after <date>] [--closes-before <date>] [--question-contains <text>] [--limit <n>] [--chain-id <id>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
+        );
+        console.log(
+          '  plan   --source polymarket --polymarket-market-id <id>|--polymarket-slug <slug> [--chain-id <id>] [--target-slippage-bps <n>] [--turnover-target <n>] [--depth-slippage-bps <n>] [--safety-multiplier <n>] [--min-liquidity-usdc <n>] [--max-liquidity-usdc <n>] [--with-rules] [--include-similarity] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
+        );
+        console.log(
+          '  deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier 500|3000|10000] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--oracle <address>] [--factory <address>] [--usdc <address>] [--distribution-yes <parts>] [--distribution-no <parts>] [--sources <url...>] [--manifest-file <path>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--min-close-lead-seconds <n>]',
+        );
+        console.log(
+          '  verify --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--trust-deploy] [--manifest-file <path>] [--include-similarity] [--with-rules] [--allow-rule-mismatch] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
+        );
+        console.log(
+          '  lp-explain --liquidity-usdc <n> [--source-yes-pct <0-100>] [--distribution-yes <parts>] [--distribution-no <parts>]',
+        );
+        console.log(
+          '  hedge-calc [--reserve-yes-usdc <n> --reserve-no-usdc <n>] [--excess-yes-usdc <n>] [--excess-no-usdc <n>] [--polymarket-yes-pct <0-100>] [--hedge-ratio <n>] [--hedge-cost-bps <n>] [--volume-scenarios <csv>] [--pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug>]',
+        );
+        console.log(
+          '  simulate --liquidity-usdc <n> [--source-yes-pct <0-100>] [--target-yes-pct <0-100>] [--distribution-yes <parts>] [--distribution-no <parts>] [--fee-tier 500|3000|10000] [--volume-scenarios <csv>] [--hedge-ratio <n>] [--polymarket-yes-pct <0-100>]',
+        );
+        console.log(
+          `  go     ${MIRROR_GO_USAGE.replace('pandora [--output table|json] mirror go ', '')}`,
+        );
+        console.log(
+          `  sync ${MIRROR_SYNC_USAGE.replace('pandora [--output table|json] mirror sync ', '')}`,
+        );
+        console.log('         stop|status selector: --pid-file <path>|--strategy-hash <hash>');
+        console.log('  status --state-file <path>|--strategy-hash <hash> [--with-live] [--trust-deploy]');
+        console.log('  close  --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute');
+      }
+      return;
+    }
+
+    const handler = getHandler(action);
+    if (!handler) {
+      throw new CliError('INVALID_ARGS', INVALID_SUBCOMMAND_MESSAGE);
+    }
+    const shared = parseIndexerSharedFlags(actionArgs);
+
+    return handler({
+      actionArgs: shared.rest,
+      shared,
+      context,
+      deps,
+      mirrorGoUsage: MIRROR_GO_USAGE,
+      mirrorSyncUsage: MIRROR_SYNC_USAGE,
+    });
+  };
+}
+
+module.exports = {
+  MIRROR_GO_USAGE,
+  MIRROR_SYNC_USAGE,
+  createRunMirrorCommand,
+};

package/cli/lib/mirror_econ_service.cjs

@@ -1,4 +1,5 @@
 const { computeDistributionHint, normalizeProbability } = require('./mirror_sizing_service.cjs');
+const { round, clamp } = require('./shared/utils.cjs');
 
 const MIRROR_LP_EXPLAIN_SCHEMA_VERSION = '1.0.0';
 const MIRROR_HEDGE_CALC_SCHEMA_VERSION = '1.0.0';
@@ -13,16 +14,6 @@ function toNumber(value) {
   return numeric;
 }
 
-function round(value, decimals = 6) {
-  if (!Number.isFinite(value)) return null;
-  const factor = 10 ** decimals;
-  return Math.round(value * factor) / factor;
-}
-
-function clamp(value, min, max) {
-  return Math.max(min, Math.min(max, value));
-}
-
 function toRawUsdc(usdc) {
   const numeric = toNumber(usdc);
   if (numeric === null) return null;

package/cli/lib/mirror_handlers/browse.cjs

@@ -0,0 +1,40 @@
+module.exports = async function handleMirrorBrowse({ shared, context, deps }) {
+  const {
+    includesHelpFlag,
+    emitSuccess,
+    commandHelpPayload,
+    maybeLoadIndexerEnv,
+    resolveIndexerUrl,
+    parseMirrorBrowseFlags,
+    browseMirrorMarkets,
+    renderMirrorBrowseTable,
+  } = deps;
+
+  if (includesHelpFlag(shared.rest)) {
+    if (context.outputMode === 'json') {
+      emitSuccess(
+        context.outputMode,
+        'mirror.browse.help',
+        commandHelpPayload(
+          'pandora [--output table|json] mirror browse [--min-yes-pct <n>] [--max-yes-pct <n>] [--min-volume-24h <n>] [--closes-after <date>] [--closes-before <date>] [--question-contains <text>] [--limit <n>]',
+        ),
+      );
+    } else {
+      console.log(
+        'Usage: pandora [--output table|json] mirror browse [--min-yes-pct <n>] [--max-yes-pct <n>] [--min-volume-24h <n>] [--closes-after <date>] [--closes-before <date>] [--question-contains <text>] [--limit <n>]',
+      );
+    }
+    return;
+  }
+
+  maybeLoadIndexerEnv(shared);
+  const indexerUrl = resolveIndexerUrl(shared.indexerUrl);
+  const options = parseMirrorBrowseFlags(shared.rest);
+  const payload = await browseMirrorMarkets({
+    ...options,
+    indexerUrl,
+    timeoutMs: shared.timeoutMs,
+  });
+
+  emitSuccess(context.outputMode, 'mirror.browse', payload, renderMirrorBrowseTable);
+};

package/cli/lib/mirror_handlers/close.cjs

@@ -0,0 +1,25 @@
+module.exports = async function handleMirrorClose({ shared, context, deps }) {
+  const {
+    includesHelpFlag,
+    emitSuccess,
+    commandHelpPayload,
+    parseMirrorCloseFlags,
+    buildMirrorClosePlan,
+    renderMirrorCloseTable,
+  } = deps;
+
+  if (includesHelpFlag(shared.rest)) {
+    const usage =
+      'pandora [--output table|json] mirror close --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute';
+    if (context.outputMode === 'json') {
+      emitSuccess(context.outputMode, 'mirror.close.help', commandHelpPayload(usage));
+    } else {
+      console.log(`Usage: ${usage}`);
+    }
+    return;
+  }
+
+  const options = parseMirrorCloseFlags(shared.rest);
+  const payload = buildMirrorClosePlan(options);
+  emitSuccess(context.outputMode, 'mirror.close', payload, renderMirrorCloseTable);
+};

package/cli/lib/mirror_handlers/deploy.cjs

@@ -0,0 +1,47 @@
+module.exports = async function handleMirrorDeploy({ shared, context, deps }) {
+  const {
+    includesHelpFlag,
+    emitSuccess,
+    commandHelpPayload,
+    maybeLoadTradeEnv,
+    resolveIndexerUrl,
+    parseMirrorDeployFlags,
+    deployMirror,
+    coerceMirrorServiceError,
+    renderMirrorDeployTable,
+  } = deps;
+
+  if (includesHelpFlag(shared.rest)) {
+    if (context.outputMode === 'json') {
+      emitSuccess(
+        context.outputMode,
+        'mirror.deploy.help',
+        commandHelpPayload(
+          'pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier 500|3000|10000] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--manifest-file <path>] [--min-close-lead-seconds <n>]',
+        ),
+      );
+    } else {
+      console.log(
+        'Usage: pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier 500|3000|10000] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--manifest-file <path>] [--min-close-lead-seconds <n>]',
+      );
+    }
+    return;
+  }
+
+  maybeLoadTradeEnv(shared);
+  const indexerUrl = resolveIndexerUrl(shared.indexerUrl);
+  const options = parseMirrorDeployFlags(shared.rest);
+  let payload;
+  try {
+    payload = await deployMirror({
+      ...options,
+      indexerUrl,
+      timeoutMs: shared.timeoutMs,
+      execute: options.execute,
+    });
+  } catch (err) {
+    throw coerceMirrorServiceError(err, 'MIRROR_DEPLOY_FAILED');
+  }
+
+  emitSuccess(context.outputMode, 'mirror.deploy', payload, renderMirrorDeployTable);
+};