pandora-cli-skills 1.1.27 → 1.1.28

package/README_FOR_SHARING.md

@@ -55,7 +55,7 @@ Prerequisite: Node.js `>=18`.
 - Global machine-readable output:
   - `pandora --output json doctor`
   - `pandora --output table polls list --limit 10`
-  - `--output json` is for non-execution commands; `launch`/`clone-bet` stream script output directly.
+  - `--output json` is supported for all commands except `launch`/`clone-bet`; those stream script output directly.
 - Guided setup:
   - `pandora setup`
   - `pandora setup --check-usdc-code`
@@ -143,7 +143,8 @@ Prerequisite: Node.js `>=18`.
   - each scan item includes at minimum `id`, `chainId`, `marketType`, `question`, `marketCloseTimestamp`, and `odds`.
 
 ## Phase 1 limitations
-- `--expand` and `--with-odds` are supported on both `markets list` and `scan`.
+- `scan` always includes odds; `--with-odds` is accepted for backward compatibility.
+- `--expand` is supported on both `markets list` and `scan`.
 - `--active|--resolved|--expiring-soon` are client-side filters on fetched list pages.
 - Odds are indexer-derived and read-only; missing upstream liquidity/price fields can produce partial odds in some environments.
 - `scan` is indexer-backed only (no direct chain reads); freshness depends on indexer sync state.
@@ -215,7 +216,7 @@ Prerequisite: Node.js `>=18`.
 - `mirror sync`:
   - envelope is `ok=true`, `command="mirror.sync"`, with `data.strategyHash`, `data.stateFile`, `data.parameters`, `data.snapshots[]`, and `data.actions[]`.
   - hedge controls: `--hedge-trigger-usdc`, `--max-hedge-usdc`, `--hedge-ratio <n>` (default `1`), and `--no-hedge` to disable hedge execution while keeping drift rebalancing active.
-  - trust controls: `--trust-deploy [--manifest-file <path>]`.
+  - trust controls: `--trust-deploy`.
   - streaming: `--stream` emits per-tick logs for `mirror sync run` (table mode streams by default).
   - rebalance sizing is pool-aware: drift notional scales with `reserveYes + reserveNo`, then bounded by `--max-rebalance-usdc`.
   - Polymarket resilience: when Polymarket endpoints are unreachable, cached snapshots under `~/.pandora/polymarket` are reused for read paths; live sync blocks execution if source data is cached/stale.
@@ -239,6 +240,24 @@ Prerequisite: Node.js `>=18`.
 ## Resolve/LP commands
 - `resolve` and `lp` are active command paths with strict flag validation, runtime preflight checks, and decoded on-chain revert reporting.
 
+## Compatibility aliases
+- `--env-file` = `--dotenv-path`
+- `--no-env-file` = `--skip-dotenv`
+- `--amount` = `--amount-usdc` (trade/watch/autopilot paths)
+- `--market-id` = `--condition-id` (polymarket trade)
+- `--force-gate` = `--skip-gate` (deprecated; prefer `--skip-gate`)
+
+## Additional JSON response shapes
+- `doctor`: `{ ok: true, command: "doctor", data: { schemaVersion, generatedAt, env, rpc, codeChecks, polymarket, summary } }`
+- `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 } }`
+- `lp`:
+  - add/remove: `{ ok: true, command: "lp", data: { schemaVersion, generatedAt, action: "add"|"remove", mode, txPlan, tx? } }`
+  - positions: `{ ok: true, command: "lp", data: { schemaVersion, generatedAt, action: "positions", mode: "read", wallet, count, items } }`
+- `polymarket` (`check|preflight|approve|trade`):
+  - `{ ok: true, command, data: { schemaVersion, generatedAt, ... } }`
+
 ### Resolve command
 - Usage:
   - `pandora [--output table|json] resolve --poll-address <address> --answer yes|no --reason <text> --dry-run|--execute [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>]`

package/SKILL.md

@@ -36,7 +36,7 @@ npm link
 
 ## CLI ergonomics
 - Global output mode: `--output table|json` (default `table`)
-- `--output json` applies to non-execution commands; `launch`/`clone-bet` stream script output directly.
+- `--output json` is supported for all commands except `launch`/`clone-bet`; those stream script output directly.
 - Guided setup command: `pandora setup`
 - Phase 1 discovery command: `pandora scan`
 - Phase 1 lifecycle filters: `pandora markets list --active|--resolved|--expiring-soon`
@@ -67,6 +67,7 @@ This section mirrors live CLI help output so agent runs can rely on one source o
 
 ```text
 pandora [--output table|json] --version
+pandora [--output table|json] help
 pandora [--output table|json] init-env [--force] [--dotenv-path <path>] [--example <path>]
 pandora [--output table|json] doctor [--dotenv-path <path>] [--skip-dotenv] [--check-usdc-code] [--check-polymarket] [--rpc-timeout-ms <ms>]
 pandora [--output table|json] setup [--force] [--dotenv-path <path>] [--example <path>] [--check-usdc-code] [--check-polymarket] [--rpc-timeout-ms <ms>]
@@ -79,7 +80,7 @@ pandora [--output table|json] events get --id <id> [--type all|liquidity|oracle-
 pandora [--output table|json] positions list [--wallet <address>] [--market-address <address>] [--chain-id <id>] [--limit <n>] [--after <cursor>] [--before <cursor>] [--order-by <field>] [--order-direction asc|desc] [--where-json <json>]
 pandora [--output table|json] portfolio --wallet <address> [--chain-id <id>] [--limit <n>] [--include-events|--no-events] [--with-lp] [--rpc-url <url>]
 pandora [--output table|json] watch [--wallet <address>] [--market-address <address>] [--side yes|no] [--amount-usdc <amount>] [--iterations <n>] [--interval-ms <ms>] [--chain-id <id>] [--include-events|--no-events] [--yes-pct <0-100>] [--alert-yes-below <0-100>] [--alert-yes-above <0-100>] [--alert-net-liquidity-below <amount>] [--alert-net-liquidity-above <amount>] [--fail-on-alert]
-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>] [--where-json <json>] [--expand] [--with-odds]
+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>] [--where-json <json>] [--active|--resolved|--expiring-soon] [--expiring-hours <n>] [--expand]
 pandora [--output table|json] quote [--indexer-url <url>] [--timeout-ms <ms>] --market-address <address> --side yes|no --amount-usdc <amount> [--yes-pct <0-100>] [--slippage-bps <0-10000>]
 pandora [--output table|json] trade [--indexer-url <url>] [--timeout-ms <ms>] [--dotenv-path <path>] [--skip-dotenv] --market-address <address> --side yes|no --amount-usdc <amount> --dry-run|--execute [--yes-pct <0-100>] [--slippage-bps <0-10000>] [--min-shares-out-raw <uint>] [--max-amount-usdc <amount>] [--min-probability-pct <0-100>] [--max-probability-pct <0-100>] [--allow-unquoted-execute] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--usdc <address>]
 pandora [--output table|json] history --wallet <address> [--chain-id <id>] [--market-address <address>] [--side yes|no|both] [--status all|open|won|lost|closed] [--limit <n>] [--after <cursor>] [--before <cursor>] [--order-by timestamp|pnl|entry-price|mark-price] [--order-direction asc|desc] [--include-seed]
@@ -94,21 +95,23 @@ pandora [--output table|json] analyze --market-address <address> [--provider <na
 pandora [--output table|json] suggest --wallet <address> --risk low|medium|high --budget <amount> [--count <n>] [--include-venues pandora,polymarket]
 pandora [--output table|json] resolve --poll-address <address> --answer yes|no --reason <text> --dry-run|--execute [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>]
 pandora [--output table|json] lp add|remove|positions [--market-address <address>] [--wallet <address>] [--amount-usdc <n>] [--lp-tokens <n>] [--dry-run|--execute] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--usdc <address>] [--deadline-seconds <n>] [--indexer-url <url>] [--timeout-ms <ms>]
+pandora launch [--dotenv-path <path>] [--skip-dotenv] [script args...]
+pandora clone-bet [--dotenv-path <path>] [--skip-dotenv] [script args...]
 ```
 
 Mirror subcommand detail:
 
 ```text
 browse --min-yes-pct <n> --max-yes-pct <n> --min-volume-24h <n> [--closes-after <date>] [--closes-before <date>] [--question-contains <text>] [--limit <n>]
-plan   --source polymarket --polymarket-market-id <id>|--polymarket-slug <slug> [--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>]
-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>]
+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>]
+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>] [--min-close-lead-seconds <n>] [--manifest-file <path>]
 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]
 lp-explain --liquidity-usdc <n> [--source-yes-pct <0-100>] [--distribution-yes <parts>] [--distribution-no <parts>]
-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>]
-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>]
+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>] [--paper|--dry-run|--execute-live|--execute] [--private-key <hex>] [--funder <address>] [--auto-sync] [--sync-once] [--skip-gate]
-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>] [--trust-deploy] [--skip-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>]
-status --state-file <path>|--strategy-hash <hash> [--with-live] [--trust-deploy]
+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>] [--trust-deploy] [--skip-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>]
+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
 ```
 
@@ -189,7 +192,8 @@ pandora --output json suggest --wallet <0x...> --risk medium --budget 50 --inclu
   - each scan item includes at minimum `id`, `chainId`, `marketType`, `question`, `marketCloseTimestamp`, and `odds`.
 
 ## Phase 1 limitations
-- `--expand` and `--with-odds` are supported on both `markets list` and `scan`.
+- `scan` always includes odds; `--with-odds` is accepted for backward compatibility.
+- `--expand` is supported on both `markets list` and `scan`.
 - `--active|--resolved|--expiring-soon` are client-side filters over fetched pages.
 - Odds are indexer-derived and read-only; missing upstream liquidity/price fields can produce partial odds in some environments.
 - `scan` is indexer-backed only (no direct chain reads); freshness depends on indexer sync state.
@@ -303,6 +307,13 @@ Mode aliases:
 - Mirror commands accept either market flag name:
   - `--pandora-market-address` or `--market-address`
 
+Common compatibility aliases:
+- `--env-file` = `--dotenv-path`
+- `--no-env-file` = `--skip-dotenv`
+- `--amount` = `--amount-usdc` (trade/watch/autopilot paths)
+- `--market-id` = `--condition-id` (polymarket trade)
+- `--force-gate` = `--skip-gate` (deprecated; use `--skip-gate`)
+
 ## Distribution format (ppb)
 - Distribution inputs use parts-per-billion (ppb):
   - `--distribution-yes 580000000` means YES seed weight = `58%`.
@@ -325,6 +336,18 @@ Common structured error codes for automation:
 Error envelope:
 - `{ ok: false, error: { code, message, details? } }`
 
+## Additional JSON response shapes
+- `doctor`:
+  - `{ ok: true, command: "doctor", data: { schemaVersion, generatedAt, env, rpc, codeChecks, polymarket, summary } }`
+- `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 } }`
+- `lp`:
+  - `lp add|remove`: `{ ok: true, command: "lp", data: { schemaVersion, generatedAt, action: "add"|"remove", mode, txPlan, tx? } }`
+  - `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.
+
 ## Pandora mainnet deployment reference
 - PredictionOracle (Factory): `0x259308E7d8557e4Ba192De1aB8Cf7e0E21896442`
 - PredictionPoll (Implementation): `0xC49c177736107fD8351ed6564136B9ADbE5B1eC3`

package/cli/lib/cli_output_service.cjs

@@ -15,10 +15,6 @@ function createCliOutputService(options = {}) {
     console.log(JSON.stringify(payload, null, 2));
   }
 
-  function emitJsonError(payload) {
-    console.log(JSON.stringify(payload, null, 2));
-  }
-
   function formatErrorValue(value) {
     if (typeof value === 'string') return value;
     if (value && typeof value.message === 'string') return value.message;
@@ -75,7 +71,7 @@ function createCliOutputService(options = {}) {
     const envelope = toErrorEnvelope(error);
 
     if (outputMode === 'json') {
-      emitJsonError(envelope);
+      emitJson(envelope);
     } else {
       console.error(`[${envelope.error.code}] ${envelope.error.message}`);
       if (envelope.error.details && Array.isArray(envelope.error.details.errors) && envelope.error.details.errors.length) {
@@ -127,4 +123,3 @@ function createCliOutputService(options = {}) {
 module.exports = {
   createCliOutputService,
 };
-

package/cli/lib/market_admin_service.cjs

@@ -186,29 +186,6 @@ function toFiniteNumber(value) {
   return numeric;
 }
 
-function toBigIntOrNull(value) {
-  if (value === null || value === undefined || value === '') return null;
-  if (typeof value === 'bigint') return value;
-  try {
-    return BigInt(value);
-  } catch {
-    return null;
-  }
-}
-
-function normalizeBigIntForJson(value) {
-  if (typeof value === 'bigint') return value.toString();
-  if (Array.isArray(value)) return value.map((item) => normalizeBigIntForJson(item));
-  if (value && typeof value === 'object') {
-    const output = {};
-    for (const [key, nested] of Object.entries(value)) {
-      output[key] = normalizeBigIntForJson(nested);
-    }
-    return output;
-  }
-  return value;
-}
-
 function normalizeResolveOutcome(answer) {
   const normalized = String(answer || '').trim().toLowerCase();
   if (normalized === 'yes') return true;

package/cli/lib/mirror_service.cjs

@@ -18,10 +18,6 @@ function round(value, decimals = 6) {
   return Math.round(numeric * factor) / factor;
 }
 
-function clamp(value, min, max) {
-  return Math.max(min, Math.min(max, value));
-}
-
 function createServiceError(code, message, details = undefined) {
   const err = new Error(message);
   err.code = code;

package/cli/lib/scan_command_service.cjs

@@ -0,0 +1,52 @@
+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>] [--where-json <json>] [--active|--resolved|--expiring-soon] [--expiring-hours <n>] [--expand]';
+
+function createRunScanCommand(deps) {
+  const {
+    parseIndexerSharedFlags,
+    includesHelpFlag,
+    emitSuccess,
+    commandHelpPayload,
+    maybeLoadIndexerEnv,
+    resolveIndexerUrl,
+    parseMarketsListFlags,
+    fetchMarketsListPage,
+    buildMarketsEnrichmentContext,
+    buildMarketsListPayload,
+    renderScanTable,
+  } = deps;
+
+  return async function runScanCommand(args, context) {
+    const shared = parseIndexerSharedFlags(args);
+    if (includesHelpFlag(shared.rest)) {
+      if (context.outputMode === 'json') {
+        emitSuccess(context.outputMode, 'scan.help', commandHelpPayload(SCAN_USAGE));
+      } else {
+        console.log(`Usage: ${SCAN_USAGE}`);
+      }
+      return;
+    }
+
+    maybeLoadIndexerEnv(shared);
+    const indexerUrl = resolveIndexerUrl(shared.indexerUrl);
+
+    const options = parseMarketsListFlags(shared.rest);
+    options.withOdds = true;
+
+    const { items, pageInfo, unfilteredCount } = await fetchMarketsListPage(indexerUrl, options, shared.timeoutMs);
+    const enrichmentContext = await buildMarketsEnrichmentContext(indexerUrl, items, options, shared.timeoutMs);
+    const payload = buildMarketsListPayload(indexerUrl, options, items, pageInfo, {
+      includeEnrichedItems: true,
+      scanMode: true,
+      enrichmentContext,
+      unfilteredCount,
+    });
+
+    emitSuccess(context.outputMode, 'scan', payload, renderScanTable);
+  };
+}
+
+module.exports = {
+  SCAN_USAGE,
+  createRunScanCommand,
+};

package/cli/pandora.cjs

@@ -5,6 +5,7 @@ const path = require('path');
 const { spawnSync } = require('child_process');
 const { createCommandRouter } = require('./lib/command_router.cjs');
 const { createCliOutputService } = require('./lib/cli_output_service.cjs');
+const { createRunScanCommand } = require('./lib/scan_command_service.cjs');
 const {
   fetchHistory,
 } = require('./lib/history_service.cjs');
@@ -258,7 +259,7 @@ Usage:
   pandora [--output table|json] positions list [--wallet <address>] [--market-address <address>] [--chain-id <id>] [--limit <n>] [--after <cursor>] [--before <cursor>] [--order-by <field>] [--order-direction asc|desc] [--where-json <json>]
   pandora [--output table|json] portfolio --wallet <address> [--chain-id <id>] [--limit <n>] [--include-events|--no-events] [--with-lp] [--rpc-url <url>]
   pandora [--output table|json] watch [--wallet <address>] [--market-address <address>] [--side yes|no] [--amount-usdc <amount>] [--iterations <n>] [--interval-ms <ms>] [--chain-id <id>] [--include-events|--no-events] [--yes-pct <0-100>] [--alert-yes-below <0-100>] [--alert-yes-above <0-100>] [--alert-net-liquidity-below <amount>] [--alert-net-liquidity-above <amount>] [--fail-on-alert]
-  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>] [--where-json <json>] [--expand] [--with-odds]
+  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>] [--where-json <json>] [--active|--resolved|--expiring-soon] [--expiring-hours <n>] [--expand]
   pandora [--output table|json] quote [--indexer-url <url>] [--timeout-ms <ms>] --market-address <address> --side yes|no --amount-usdc <amount> [--yes-pct <0-100>] [--slippage-bps <0-10000>]
   pandora [--output table|json] trade [--indexer-url <url>] [--timeout-ms <ms>] [--dotenv-path <path>] [--skip-dotenv] --market-address <address> --side yes|no --amount-usdc <amount> --dry-run|--execute [--yes-pct <0-100>] [--slippage-bps <0-10000>] [--min-shares-out-raw <uint>] [--max-amount-usdc <amount>] [--min-probability-pct <0-100>] [--max-probability-pct <0-100>] [--allow-unquoted-execute] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--usdc <address>]
   pandora [--output table|json] history --wallet <address> [--chain-id <id>] [--market-address <address>] [--side yes|no|both] [--status all|open|won|lost|closed] [--limit <n>] [--after <cursor>] [--before <cursor>] [--order-by timestamp|pnl|entry-price|mark-price] [--order-direction asc|desc] [--include-seed]
@@ -286,7 +287,7 @@ Examples:
   pandora positions list --wallet 0x1234...
   pandora portfolio --wallet 0x1234... --chain-id 1 --with-lp
   pandora watch --market-address 0xabc... --side yes --amount-usdc 10 --iterations 5 --interval-ms 2000
-  pandora scan --limit 25 --chain-id 1 --with-odds
+  pandora scan --active --limit 25 --chain-id 1
   pandora quote --market-address 0xabc... --side yes --amount-usdc 50
   pandora trade --dry-run --market-address 0xabc... --side no --amount-usdc 25 --max-amount-usdc 50 --min-probability-pct 20
   pandora history --wallet 0x1234... --chain-id 1 --limit 50
@@ -560,6 +561,40 @@ function inferRequestedOutputMode(argv) {
 
 function expandEqualsStyleFlags(argv) {
   const expanded = [];
+  const unaryBooleanFlags = new Set([
+    '--force',
+    '--skip-dotenv',
+    '--no-env-file',
+    '--check-usdc-code',
+    '--check-polymarket',
+    '--stdin',
+    '--active',
+    '--resolved',
+    '--expiring-soon',
+    '--expand',
+    '--with-odds',
+    '--include-events',
+    '--no-events',
+    '--fail-on-alert',
+    '--dry-run',
+    '--execute',
+    '--allow-unquoted-execute',
+    '--cross-venue-only',
+    '--allow-same-venue',
+    '--with-rules',
+    '--include-similarity',
+    '--paper',
+    '--execute-live',
+    '--trust-deploy',
+    '--allow-rule-mismatch',
+    '--auto-sync',
+    '--sync-once',
+    '--skip-gate',
+    '--force-gate',
+    '--daemon',
+    '--stream',
+    '--no-hedge',
+  ]);
   for (const token of Array.isArray(argv) ? argv : []) {
     if (
       typeof token === 'string' &&
@@ -571,6 +606,17 @@ function expandEqualsStyleFlags(argv) {
       const flag = token.slice(0, eqIndex);
       const value = token.slice(eqIndex + 1);
       if (flag && flag !== '--') {
+        const normalizedValue = value.trim().toLowerCase();
+        if (
+          unaryBooleanFlags.has(flag) &&
+          (normalizedValue === 'true' || normalizedValue === 'false')
+        ) {
+          // Preserve explicit boolean-literal assignments for unary flags so they
+          // are handled as invalid/explicit input by command parsers instead of
+          // silently flipping behavior (for example, --dry-run=false).
+          expanded.push(token);
+          continue;
+        }
         expanded.push(flag);
         if (value.length) expanded.push(value);
         continue;
@@ -627,13 +673,29 @@ function parseDateLikeFlag(value, flagName) {
       `${flagName} must be a date/time string (for example: "2026-03-15" or "2026-03-15T18:00:00Z"), not a bare number.`,
     );
   }
-  const parsed = Date.parse(text);
+  const isDateOnly = /^\d{4}-\d{2}-\d{2}$/.test(text);
+  const isDateTime =
+    /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/.test(text);
+  if (!isDateOnly && !isDateTime) {
+    throw new CliError(
+      'INVALID_FLAG_VALUE',
+      `${flagName} must be an ISO date/time string (for example: "2026-03-15" or "2026-03-15T18:00:00Z"). Received: "${text}"`,
+    );
+  }
+  const normalized = isDateOnly ? `${text}T00:00:00Z` : text;
+  const parsed = Date.parse(normalized);
   if (Number.isNaN(parsed)) {
     throw new CliError(
       'INVALID_FLAG_VALUE',
       `${flagName} must be a valid date/time string (for example: "2026-03-15" or "2026-03-15T18:00:00Z"). Received: "${text}"`,
     );
   }
+  if (isDateOnly && new Date(parsed).toISOString().slice(0, 10) !== text) {
+    throw new CliError(
+      'INVALID_FLAG_VALUE',
+      `${flagName} must be a real calendar date (YYYY-MM-DD). Received: "${text}"`,
+    );
+  }
   return text;
 }
 
@@ -1429,7 +1491,6 @@ function parseTradeFlags(args) {
     chainId: null,
     rpcUrl: null,
     privateKey: null,
-    funder: null,
     usdc: null,
   };
 
@@ -5571,7 +5632,11 @@ function renderMarketsListTable(data) {
 }
 
 function renderScanTable(data) {
-  const items = Array.isArray(data.enrichedItems) ? data.enrichedItems : [];
+  const items = Array.isArray(data.enrichedItems)
+    ? data.enrichedItems
+    : Array.isArray(data.items)
+      ? data.items
+      : [];
   if (!items.length) {
     console.log('No markets found.');
     return;
@@ -6976,6 +7041,38 @@ function buildMarketExpansion(item) {
   };
 }
 
+function normalizeNumericLikeValue(value) {
+  if (typeof value === 'number') {
+    return Number.isFinite(value) ? value : value;
+  }
+  if (typeof value !== 'string') {
+    return value;
+  }
+  const trimmed = value.trim();
+  if (!trimmed.length) {
+    return value;
+  }
+  const numeric = Number(trimmed);
+  if (!Number.isFinite(numeric)) {
+    return value;
+  }
+  return numeric;
+}
+
+function normalizeMarketNumericFields(item) {
+  if (!item || typeof item !== 'object' || Array.isArray(item)) {
+    return item;
+  }
+  return {
+    ...item,
+    chainId: normalizeNumericLikeValue(item.chainId),
+    marketCloseTimestamp: normalizeNumericLikeValue(item.marketCloseTimestamp),
+    createdAt: normalizeNumericLikeValue(item.createdAt),
+    totalVolume: normalizeNumericLikeValue(item.totalVolume),
+    currentTvl: normalizeNumericLikeValue(item.currentTvl),
+  };
+}
+
 function enrichMarketItem(item, options, enrichmentContext) {
   const baseItem = item && typeof item === 'object' ? item : { value: item };
   const enriched = { ...baseItem };
@@ -7039,6 +7136,7 @@ function buildEnrichedMarketItems(items, options, enrichmentContext) {
 function buildMarketsListPayload(indexerUrl, options, items, pageInfo, opts = {}) {
   const isScanMode = Boolean(opts.scanMode);
   const enrichmentContext = opts.enrichmentContext || null;
+  const normalizedItems = Array.isArray(items) ? items.map((item) => normalizeMarketNumericFields(item)) : [];
   const filters = { ...(options.where || {}) };
   if (options.lifecycle && options.lifecycle !== 'all') {
     filters.lifecycle = options.lifecycle;
@@ -7050,23 +7148,27 @@ function buildMarketsListPayload(indexerUrl, options, items, pageInfo, opts = {}
     indexerUrl,
     pagination: buildMarketsPagination(options),
     filters,
-    count: items.length,
+    count: normalizedItems.length,
     pageInfo,
-    items,
+    items: normalizedItems,
   };
 
-  if (typeof opts.unfilteredCount === 'number' && opts.unfilteredCount >= items.length && options.lifecycle !== 'all') {
+  if (
+    typeof opts.unfilteredCount === 'number' &&
+    opts.unfilteredCount >= normalizedItems.length &&
+    options.lifecycle !== 'all'
+  ) {
     payload.lifecycle = {
       mode: options.lifecycle,
       expiringHours: options.lifecycle === 'expiring-soon' ? options.expiringSoonHours : null,
       unfilteredCount: opts.unfilteredCount,
-      filteredOut: opts.unfilteredCount - items.length,
+      filteredOut: opts.unfilteredCount - normalizedItems.length,
     };
   }
 
   const includeEnrichedItems = Boolean(opts.includeEnrichedItems || options.expand || options.withOdds);
   if (includeEnrichedItems) {
-    const enrichedItems = buildEnrichedMarketItems(items, options, enrichmentContext);
+    const enrichedItems = buildEnrichedMarketItems(normalizedItems, options, enrichmentContext);
     payload.enrichment = {
       expand: Boolean(options.expand),
       withOdds: Boolean(options.withOdds),
@@ -7687,7 +7789,7 @@ async function runMarketsCommand(args, context) {
     const responses = await Promise.all(
       ids.map(async (id) => {
         const data = await graphqlRequest(indexerUrl, query, { id }, shared.timeoutMs);
-        return { id, item: data.markets || null };
+        return { id, item: normalizeMarketNumericFields(data.markets || null) };
       }),
     );
 
@@ -7724,43 +7826,19 @@ async function runMarketsCommand(args, context) {
   throw new CliError('INVALID_ARGS', 'markets requires a subcommand: list|get');
 }
 
-async function runScanCommand(args, context) {
-  const shared = parseIndexerSharedFlags(args);
-  if (includesHelpFlag(shared.rest)) {
-    if (context.outputMode === 'json') {
-      emitSuccess(
-        context.outputMode,
-        'scan.help',
-        commandHelpPayload(
-          '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>] [--where-json <json>] [--expand] [--with-odds]',
-        ),
-      );
-    } else {
-      console.log(
-        '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>] [--where-json <json>] [--expand] [--with-odds]',
-      );
-    }
-    return;
-  }
-
-  maybeLoadIndexerEnv(shared);
-  const indexerUrl = resolveIndexerUrl(shared.indexerUrl);
-
-  const options = parseMarketsListFlags(shared.rest);
-  options.expand = true;
-  options.withOdds = true;
-
-  const { items, pageInfo, unfilteredCount } = await fetchMarketsListPage(indexerUrl, options, shared.timeoutMs);
-  const enrichmentContext = await buildMarketsEnrichmentContext(indexerUrl, items, options, shared.timeoutMs);
-  const payload = buildMarketsListPayload(indexerUrl, options, items, pageInfo, {
-    includeEnrichedItems: true,
-    scanMode: true,
-    enrichmentContext,
-    unfilteredCount,
-  });
-
-  emitSuccess(context.outputMode, 'scan', payload, renderScanTable);
-}
+const runScanCommand = createRunScanCommand({
+  parseIndexerSharedFlags,
+  includesHelpFlag,
+  emitSuccess,
+  commandHelpPayload,
+  maybeLoadIndexerEnv,
+  resolveIndexerUrl,
+  parseMarketsListFlags,
+  fetchMarketsListPage,
+  buildMarketsEnrichmentContext,
+  buildMarketsListPayload,
+  renderScanTable,
+});
 
 async function runPollsCommand(args, context) {
   const shared = parseIndexerSharedFlags(args);
@@ -10600,6 +10678,8 @@ async function main() {
     outputMode = parsed.outputMode;
     args = parsed.args;
   } catch (err) {
+    // Keep parse-time failures machine-readable for agent callers even when
+    // --output itself is malformed or missing.
     emitFailure('json', err);
     return;
   }

package/package.json

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