pandora-cli-skills 1.1.36 → 1.1.37

package/cli/lib/error_recovery_service.cjs

@@ -39,6 +39,18 @@ function buildPolymarketPreflightCommand(cliName) {
   return `${cliName} polymarket preflight`;
 }
 
+function buildMirrorDeployRetryCommand(cliName) {
+  return `${cliName} mirror deploy --dry-run --plan-file <plan-file>`;
+}
+
+function buildMirrorSyncRetryCommand(cliName) {
+  return `${cliName} mirror sync once --paper --pandora-market-address <address> --polymarket-market-id <id>`;
+}
+
+function buildMcpRestartCommand(cliName) {
+  return `${cliName} mcp`;
+}
+
 /**
  * Build deterministic Next-Best-Action recovery hints for JSON errors.
  * @param {{cliName?: string}} [options]
@@ -83,6 +95,45 @@ function createErrorRecoveryService(options = {}) {
           command: buildPolymarketPreflightCommand(cliName),
           retryable: true,
         };
+      case 'MIRROR_DEPLOY_FAILED':
+      case 'MIRROR_GO_FAILED':
+      case 'MIRROR_GO_VERIFY_FAILED':
+      case 'MIRROR_GO_PREFLIGHT_FAILED':
+        return {
+          action: 'Re-run mirror deploy/verify in dry-run mode',
+          command: buildMirrorDeployRetryCommand(cliName),
+          retryable: true,
+        };
+      case 'MIRROR_SYNC_FAILED':
+      case 'MIRROR_GO_SYNC_FAILED':
+      case 'MIRROR_SYNC_PREFLIGHT_FAILED':
+      case 'MIRROR_SYNC_DAEMON_START_FAILED':
+      case 'MIRROR_SYNC_DAEMON_STOP_FAILED':
+      case 'MIRROR_SYNC_DAEMON_STATUS_FAILED':
+        return {
+          action: 'Run a bounded mirror sync iteration to isolate the failing gate',
+          command: buildMirrorSyncRetryCommand(cliName),
+          retryable: true,
+        };
+      case 'MCP_EXECUTE_INTENT_REQUIRED':
+        return {
+          action: 'Retry MCP tools/call with execute intent enabled',
+          command: buildMcpRestartCommand(cliName),
+          retryable: true,
+        };
+      case 'MCP_LONG_RUNNING_MODE_BLOCKED':
+        return {
+          action: 'Switch to a bounded command variant for MCP',
+          command: `${cliName} mirror sync once --help`,
+          retryable: true,
+        };
+      case 'MCP_TOOL_FAILED':
+      case 'UNKNOWN_TOOL':
+        return {
+          action: 'Inspect available MCP tools and retry with a supported tool name',
+          command: `${cliName} --output json schema`,
+          retryable: true,
+        };
       case 'MISSING_REQUIRED_FLAG':
       case 'MISSING_FLAG_VALUE':
       case 'INVALID_FLAG_VALUE':

package/cli/lib/parsers/mirror_remaining_flags.cjs

@@ -0,0 +1,580 @@
+function requireDep(deps, name) {
+  if (!deps || typeof deps[name] !== 'function') {
+    throw new Error(`mirror remaining parser requires deps.${name}()`);
+  }
+  return deps[name];
+}
+
+function parseDefaultIndexerTimeoutMs(deps) {
+  const value = deps && Number.isFinite(deps.defaultIndexerTimeoutMs) ? Number(deps.defaultIndexerTimeoutMs) : 60_000;
+  return value > 0 ? value : 60_000;
+}
+
+/**
+ * Creates the mirror browse parser.
+ * @param {object} deps
+ * @returns {(args: string[]) => object}
+ */
+function createParseMirrorBrowseFlags(deps) {
+  const CliError = requireDep(deps, 'CliError');
+  const requireFlagValue = requireDep(deps, 'requireFlagValue');
+  const parseProbabilityPercent = requireDep(deps, 'parseProbabilityPercent');
+  const parsePositiveNumber = requireDep(deps, 'parsePositiveNumber');
+  const parseDateLikeFlag = requireDep(deps, 'parseDateLikeFlag');
+  const parsePositiveInteger = requireDep(deps, 'parsePositiveInteger');
+  const parseInteger = requireDep(deps, 'parseInteger');
+
+  return function parseMirrorBrowseFlags(args) {
+    const options = {
+      minYesPct: null,
+      maxYesPct: null,
+      minVolume24h: 0,
+      closesAfter: null,
+      closesBefore: null,
+      questionContains: null,
+      limit: 10,
+      chainId: null,
+      polymarketGammaUrl: null,
+      polymarketGammaMockUrl: null,
+      polymarketMockUrl: null,
+    };
+
+    for (let i = 0; i < args.length; i += 1) {
+      const token = args[i];
+      if (token === '--min-yes-pct') {
+        options.minYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--min-yes-pct'), '--min-yes-pct');
+        i += 1;
+        continue;
+      }
+      if (token === '--max-yes-pct') {
+        options.maxYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--max-yes-pct'), '--max-yes-pct');
+        i += 1;
+        continue;
+      }
+      if (token === '--min-volume-24h') {
+        options.minVolume24h = parsePositiveNumber(requireFlagValue(args, i, '--min-volume-24h'), '--min-volume-24h');
+        i += 1;
+        continue;
+      }
+      if (token === '--closes-after') {
+        options.closesAfter = parseDateLikeFlag(requireFlagValue(args, i, '--closes-after'), '--closes-after');
+        i += 1;
+        continue;
+      }
+      if (token === '--closes-before') {
+        options.closesBefore = parseDateLikeFlag(requireFlagValue(args, i, '--closes-before'), '--closes-before');
+        i += 1;
+        continue;
+      }
+      if (token === '--question-contains') {
+        options.questionContains = requireFlagValue(args, i, '--question-contains');
+        i += 1;
+        continue;
+      }
+      if (token === '--limit') {
+        options.limit = parsePositiveInteger(requireFlagValue(args, i, '--limit'), '--limit');
+        i += 1;
+        continue;
+      }
+      if (token === '--chain-id') {
+        options.chainId = parseInteger(requireFlagValue(args, i, '--chain-id'), '--chain-id');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-gamma-url') {
+        options.polymarketGammaUrl = requireFlagValue(args, i, '--polymarket-gamma-url');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-gamma-mock-url') {
+        options.polymarketGammaMockUrl = requireFlagValue(args, i, '--polymarket-gamma-mock-url');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-mock-url') {
+        options.polymarketMockUrl = requireFlagValue(args, i, '--polymarket-mock-url');
+        i += 1;
+        continue;
+      }
+      throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror browse: ${token}`);
+    }
+
+    if (options.minYesPct !== null && options.maxYesPct !== null && options.minYesPct > options.maxYesPct) {
+      throw new CliError('INVALID_ARGS', '--min-yes-pct cannot be greater than --max-yes-pct.');
+    }
+
+    return options;
+  };
+}
+
+/**
+ * Creates the mirror verify parser.
+ * @param {object} deps
+ * @returns {(args: string[]) => object}
+ */
+function createParseMirrorVerifyFlags(deps) {
+  const CliError = requireDep(deps, 'CliError');
+  const parseAddressFlag = requireDep(deps, 'parseAddressFlag');
+  const requireFlagValue = requireDep(deps, 'requireFlagValue');
+
+  return function parseMirrorVerifyFlags(args) {
+    const options = {
+      pandoraMarketAddress: null,
+      polymarketMarketId: null,
+      polymarketSlug: null,
+      includeSimilarity: false,
+      withRules: false,
+      allowRuleMismatch: false,
+      trustDeploy: false,
+      manifestFile: null,
+      polymarketHost: null,
+      polymarketGammaUrl: null,
+      polymarketGammaMockUrl: null,
+      polymarketMockUrl: null,
+    };
+
+    for (let i = 0; i < args.length; i += 1) {
+      const token = args[i];
+      if (token === '--pandora-market-address' || token === '--market-address') {
+        options.pandoraMarketAddress = parseAddressFlag(requireFlagValue(args, i, token), token);
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-market-id') {
+        options.polymarketMarketId = requireFlagValue(args, i, '--polymarket-market-id');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-slug') {
+        options.polymarketSlug = requireFlagValue(args, i, '--polymarket-slug');
+        i += 1;
+        continue;
+      }
+      if (token === '--include-similarity') {
+        options.includeSimilarity = true;
+        continue;
+      }
+      if (token === '--with-rules') {
+        options.withRules = true;
+        continue;
+      }
+      if (token === '--allow-rule-mismatch') {
+        options.allowRuleMismatch = true;
+        continue;
+      }
+      if (token === '--trust-deploy') {
+        options.trustDeploy = true;
+        continue;
+      }
+      if (token === '--manifest-file') {
+        options.manifestFile = requireFlagValue(args, i, '--manifest-file');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-host') {
+        options.polymarketHost = requireFlagValue(args, i, '--polymarket-host');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-gamma-url') {
+        options.polymarketGammaUrl = requireFlagValue(args, i, '--polymarket-gamma-url');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-gamma-mock-url') {
+        options.polymarketGammaMockUrl = requireFlagValue(args, i, '--polymarket-gamma-mock-url');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-mock-url') {
+        options.polymarketMockUrl = requireFlagValue(args, i, '--polymarket-mock-url');
+        i += 1;
+        continue;
+      }
+      throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror verify: ${token}`);
+    }
+
+    if (!options.pandoraMarketAddress) {
+      throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address> (alias: --market-address).');
+    }
+    if (!options.polymarketMarketId && !options.polymarketSlug) {
+      throw new CliError('MISSING_REQUIRED_FLAG', 'mirror verify requires --polymarket-market-id <id> or --polymarket-slug <slug>.');
+    }
+
+    return options;
+  };
+}
+
+/**
+ * Creates the mirror status parser.
+ * @param {object} deps
+ * @returns {(args: string[]) => object}
+ */
+function createParseMirrorStatusFlags(deps) {
+  const CliError = requireDep(deps, 'CliError');
+  const parseAddressFlag = requireDep(deps, 'parseAddressFlag');
+  const requireFlagValue = requireDep(deps, 'requireFlagValue');
+  const parsePositiveInteger = requireDep(deps, 'parsePositiveInteger');
+  const parsePositiveNumber = requireDep(deps, 'parsePositiveNumber');
+  const defaultIndexerTimeoutMs = parseDefaultIndexerTimeoutMs(deps);
+
+  return function parseMirrorStatusFlags(args) {
+    const options = {
+      stateFile: null,
+      strategyHash: null,
+      withLive: false,
+      trustDeploy: false,
+      manifestFile: null,
+      pandoraMarketAddress: null,
+      polymarketMarketId: null,
+      polymarketSlug: null,
+      driftTriggerBps: 150,
+      hedgeTriggerUsdc: 10,
+      indexerUrl: null,
+      timeoutMs: defaultIndexerTimeoutMs,
+      polymarketHost: null,
+      polymarketGammaUrl: null,
+      polymarketGammaMockUrl: null,
+      polymarketMockUrl: null,
+    };
+
+    for (let i = 0; i < args.length; i += 1) {
+      const token = args[i];
+      if (token === '--state-file') {
+        options.stateFile = requireFlagValue(args, i, '--state-file');
+        i += 1;
+        continue;
+      }
+      if (token === '--strategy-hash') {
+        const value = requireFlagValue(args, i, '--strategy-hash');
+        if (!/^[a-f0-9]{16}$/i.test(value)) {
+          throw new CliError('INVALID_FLAG_VALUE', '--strategy-hash must be a 16-character hex value.');
+        }
+        options.strategyHash = value.toLowerCase();
+        i += 1;
+        continue;
+      }
+      if (token === '--with-live') {
+        options.withLive = true;
+        continue;
+      }
+      if (token === '--trust-deploy') {
+        options.trustDeploy = true;
+        continue;
+      }
+      if (token === '--manifest-file') {
+        options.manifestFile = requireFlagValue(args, i, '--manifest-file');
+        i += 1;
+        continue;
+      }
+      if (token === '--pandora-market-address' || token === '--market-address') {
+        options.pandoraMarketAddress = parseAddressFlag(requireFlagValue(args, i, token), token);
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-market-id') {
+        options.polymarketMarketId = requireFlagValue(args, i, '--polymarket-market-id');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-slug') {
+        options.polymarketSlug = requireFlagValue(args, i, '--polymarket-slug');
+        i += 1;
+        continue;
+      }
+      if (token === '--drift-trigger-bps') {
+        options.driftTriggerBps = parsePositiveInteger(requireFlagValue(args, i, '--drift-trigger-bps'), '--drift-trigger-bps');
+        i += 1;
+        continue;
+      }
+      if (token === '--hedge-trigger-usdc') {
+        options.hedgeTriggerUsdc = parsePositiveNumber(requireFlagValue(args, i, '--hedge-trigger-usdc'), '--hedge-trigger-usdc');
+        i += 1;
+        continue;
+      }
+      if (token === '--indexer-url') {
+        options.indexerUrl = requireFlagValue(args, i, '--indexer-url');
+        i += 1;
+        continue;
+      }
+      if (token === '--timeout-ms') {
+        options.timeoutMs = parsePositiveInteger(requireFlagValue(args, i, '--timeout-ms'), '--timeout-ms');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-host') {
+        options.polymarketHost = requireFlagValue(args, i, '--polymarket-host');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-gamma-url') {
+        options.polymarketGammaUrl = requireFlagValue(args, i, '--polymarket-gamma-url');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-gamma-mock-url') {
+        options.polymarketGammaMockUrl = requireFlagValue(args, i, '--polymarket-gamma-mock-url');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-mock-url') {
+        options.polymarketMockUrl = requireFlagValue(args, i, '--polymarket-mock-url');
+        i += 1;
+        continue;
+      }
+      throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror status: ${token}`);
+    }
+
+    if (!options.stateFile && !options.strategyHash) {
+      throw new CliError('MISSING_REQUIRED_FLAG', 'mirror status requires --state-file <path> or --strategy-hash <hash>.');
+    }
+
+    return options;
+  };
+}
+
+/**
+ * Creates the mirror close parser.
+ * @param {object} deps
+ * @returns {(args: string[]) => object}
+ */
+function createParseMirrorCloseFlags(deps) {
+  const CliError = requireDep(deps, 'CliError');
+  const parseAddressFlag = requireDep(deps, 'parseAddressFlag');
+  const requireFlagValue = requireDep(deps, 'requireFlagValue');
+
+  return function parseMirrorCloseFlags(args) {
+    const options = {
+      pandoraMarketAddress: null,
+      polymarketMarketId: null,
+      polymarketSlug: null,
+      execute: false,
+      dryRun: false,
+    };
+
+    for (let i = 0; i < args.length; i += 1) {
+      const token = args[i];
+      if (token === '--pandora-market-address' || token === '--market-address') {
+        options.pandoraMarketAddress = parseAddressFlag(requireFlagValue(args, i, token), token);
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-market-id') {
+        options.polymarketMarketId = requireFlagValue(args, i, '--polymarket-market-id');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-slug') {
+        options.polymarketSlug = requireFlagValue(args, i, '--polymarket-slug');
+        i += 1;
+        continue;
+      }
+      if (token === '--dry-run') {
+        options.dryRun = true;
+        continue;
+      }
+      if (token === '--execute') {
+        options.execute = true;
+        continue;
+      }
+      throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror close: ${token}`);
+    }
+
+    if (!options.pandoraMarketAddress) {
+      throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address> (alias: --market-address).');
+    }
+    if (!options.polymarketMarketId && !options.polymarketSlug) {
+      throw new CliError('MISSING_REQUIRED_FLAG', 'mirror close requires --polymarket-market-id <id> or --polymarket-slug <slug>.');
+    }
+    if (options.dryRun === options.execute) {
+      throw new CliError('INVALID_ARGS', 'mirror close requires exactly one mode: --dry-run or --execute.');
+    }
+
+    return options;
+  };
+}
+
+/**
+ * Creates the mirror lp-explain parser.
+ * @param {object} deps
+ * @returns {(args: string[]) => object}
+ */
+function createParseMirrorLpExplainFlags(deps) {
+  const CliError = requireDep(deps, 'CliError');
+  const requireFlagValue = requireDep(deps, 'requireFlagValue');
+  const parsePositiveNumber = requireDep(deps, 'parsePositiveNumber');
+  const parseProbabilityPercent = requireDep(deps, 'parseProbabilityPercent');
+  const parseNonNegativeInteger = requireDep(deps, 'parseNonNegativeInteger');
+
+  return function parseMirrorLpExplainFlags(args) {
+    const options = {
+      liquidityUsdc: null,
+      sourceYesPct: null,
+      distributionYes: null,
+      distributionNo: null,
+    };
+
+    for (let i = 0; i < args.length; i += 1) {
+      const token = args[i];
+      if (token === '--liquidity-usdc') {
+        options.liquidityUsdc = parsePositiveNumber(requireFlagValue(args, i, '--liquidity-usdc'), '--liquidity-usdc');
+        i += 1;
+        continue;
+      }
+      if (token === '--source-yes-pct') {
+        options.sourceYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--source-yes-pct'), '--source-yes-pct');
+        i += 1;
+        continue;
+      }
+      if (token === '--distribution-yes') {
+        options.distributionYes = parseNonNegativeInteger(requireFlagValue(args, i, '--distribution-yes'), '--distribution-yes');
+        i += 1;
+        continue;
+      }
+      if (token === '--distribution-no') {
+        options.distributionNo = parseNonNegativeInteger(requireFlagValue(args, i, '--distribution-no'), '--distribution-no');
+        i += 1;
+        continue;
+      }
+      throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror lp-explain: ${token}`);
+    }
+
+    if (options.liquidityUsdc === null) {
+      throw new CliError('MISSING_REQUIRED_FLAG', 'mirror lp-explain requires --liquidity-usdc <n>.');
+    }
+    if (
+      (options.distributionYes === null && options.distributionNo !== null) ||
+      (options.distributionYes !== null && options.distributionNo === null)
+    ) {
+      throw new CliError('INVALID_ARGS', 'Provide both --distribution-yes and --distribution-no together.');
+    }
+    if (
+      options.distributionYes !== null &&
+      options.distributionNo !== null &&
+      options.distributionYes + options.distributionNo !== 1_000_000_000
+    ) {
+      throw new CliError('INVALID_ARGS', '--distribution-yes + --distribution-no must equal 1000000000.');
+    }
+
+    return options;
+  };
+}
+
+/**
+ * Creates the mirror simulate parser.
+ * @param {object} deps
+ * @returns {(args: string[]) => object}
+ */
+function createParseMirrorSimulateFlags(deps) {
+  const CliError = requireDep(deps, 'CliError');
+  const requireFlagValue = requireDep(deps, 'requireFlagValue');
+  const parsePositiveNumber = requireDep(deps, 'parsePositiveNumber');
+  const parseProbabilityPercent = requireDep(deps, 'parseProbabilityPercent');
+  const parseNonNegativeInteger = requireDep(deps, 'parseNonNegativeInteger');
+  const parsePositiveInteger = requireDep(deps, 'parsePositiveInteger');
+  const parseCsvNumberList = requireDep(deps, 'parseCsvNumberList');
+
+  return function parseMirrorSimulateFlags(args) {
+    const options = {
+      liquidityUsdc: null,
+      sourceYesPct: null,
+      targetYesPct: null,
+      polymarketYesPct: null,
+      distributionYes: null,
+      distributionNo: null,
+      feeTier: 3000,
+      hedgeRatio: 1,
+      hedgeCostBps: 35,
+      volumeScenarios: null,
+    };
+
+    for (let i = 0; i < args.length; i += 1) {
+      const token = args[i];
+      if (token === '--liquidity-usdc') {
+        options.liquidityUsdc = parsePositiveNumber(requireFlagValue(args, i, '--liquidity-usdc'), '--liquidity-usdc');
+        i += 1;
+        continue;
+      }
+      if (token === '--source-yes-pct') {
+        options.sourceYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--source-yes-pct'), '--source-yes-pct');
+        i += 1;
+        continue;
+      }
+      if (token === '--target-yes-pct') {
+        options.targetYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--target-yes-pct'), '--target-yes-pct');
+        i += 1;
+        continue;
+      }
+      if (token === '--polymarket-yes-pct') {
+        options.polymarketYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--polymarket-yes-pct'), '--polymarket-yes-pct');
+        i += 1;
+        continue;
+      }
+      if (token === '--distribution-yes') {
+        options.distributionYes = parseNonNegativeInteger(requireFlagValue(args, i, '--distribution-yes'), '--distribution-yes');
+        i += 1;
+        continue;
+      }
+      if (token === '--distribution-no') {
+        options.distributionNo = parseNonNegativeInteger(requireFlagValue(args, i, '--distribution-no'), '--distribution-no');
+        i += 1;
+        continue;
+      }
+      if (token === '--fee-tier') {
+        options.feeTier = parsePositiveInteger(requireFlagValue(args, i, '--fee-tier'), '--fee-tier');
+        i += 1;
+        continue;
+      }
+      if (token === '--hedge-ratio') {
+        options.hedgeRatio = parsePositiveNumber(requireFlagValue(args, i, '--hedge-ratio'), '--hedge-ratio');
+        i += 1;
+        continue;
+      }
+      if (token === '--hedge-cost-bps') {
+        options.hedgeCostBps = parseNonNegativeInteger(requireFlagValue(args, i, '--hedge-cost-bps'), '--hedge-cost-bps');
+        i += 1;
+        continue;
+      }
+      if (token === '--volume-scenarios') {
+        options.volumeScenarios = parseCsvNumberList(requireFlagValue(args, i, '--volume-scenarios'), '--volume-scenarios');
+        i += 1;
+        continue;
+      }
+      throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror simulate: ${token}`);
+    }
+
+    if (options.liquidityUsdc === null) {
+      throw new CliError('MISSING_REQUIRED_FLAG', 'mirror simulate requires --liquidity-usdc <n>.');
+    }
+    if (
+      (options.distributionYes === null && options.distributionNo !== null) ||
+      (options.distributionYes !== null && options.distributionNo === null)
+    ) {
+      throw new CliError('INVALID_ARGS', 'Provide both --distribution-yes and --distribution-no together.');
+    }
+    if (
+      options.distributionYes !== null &&
+      options.distributionNo !== null &&
+      options.distributionYes + options.distributionNo !== 1_000_000_000
+    ) {
+      throw new CliError('INVALID_ARGS', '--distribution-yes + --distribution-no must equal 1000000000.');
+    }
+    if (![500, 3000, 10000].includes(options.feeTier)) {
+      throw new CliError('INVALID_FLAG_VALUE', '--fee-tier must be one of 500, 3000, 10000.');
+    }
+    if (options.hedgeRatio > 5) {
+      throw new CliError('INVALID_FLAG_VALUE', '--hedge-ratio must be <= 5.');
+    }
+
+    return options;
+  };
+}
+
+module.exports = {
+  createParseMirrorBrowseFlags,
+  createParseMirrorVerifyFlags,
+  createParseMirrorStatusFlags,
+  createParseMirrorCloseFlags,
+  createParseMirrorLpExplainFlags,
+  createParseMirrorSimulateFlags,
+};

package/cli/lib/schema_command_service.cjs

@@ -462,19 +462,30 @@ function createRunSchemaCommand(deps) {
   }
 
   function runSchemaCommand(args, context) {
+    if (Array.isArray(args) && (args.includes('--help') || args.includes('-h'))) {
+      if (context.outputMode === 'json') {
+        emitSuccess(context.outputMode, 'schema.help', {
+          usage: 'pandora --output json schema',
+        });
+      } else {
+        // eslint-disable-next-line no-console
+        console.log('Usage: pandora --output json schema');
+        // eslint-disable-next-line no-console
+        console.log('');
+        // eslint-disable-next-line no-console
+        console.log('Notes:');
+        // eslint-disable-next-line no-console
+        console.log('  - schema payload is available only in --output json mode.');
+      }
+      return;
+    }
+
     if (context.outputMode !== 'json') {
       throw new CliError('INVALID_USAGE', 'The schema command is only supported in --output json mode.', {
         hints: ['Run `pandora --output json schema`'],
       });
     }
 
-    if (Array.isArray(args) && (args.includes('--help') || args.includes('-h'))) {
-      emitSuccess(context.outputMode, 'schema.help', {
-        usage: 'pandora --output json schema',
-      });
-      return;
-    }
-
     if (Array.isArray(args) && args.length > 0) {
       throw new CliError('INVALID_ARGS', 'schema does not accept additional flags or positional arguments.', {
         hints: ['Run `pandora --output json schema` without extra arguments.'],

package/cli/pandora.cjs

@@ -19,6 +19,14 @@ const {
   createParseMirrorSyncFlags,
   createParseMirrorSyncDaemonSelectorFlags,
 } = require('./lib/parsers/mirror_sync_flags.cjs');
+const {
+  createParseMirrorBrowseFlags,
+  createParseMirrorVerifyFlags,
+  createParseMirrorStatusFlags,
+  createParseMirrorCloseFlags,
+  createParseMirrorLpExplainFlags,
+  createParseMirrorSimulateFlags,
+} = require('./lib/parsers/mirror_remaining_flags.cjs');
 const {
   createParsePolymarketSharedFlags,
   createParsePolymarketApproveFlags,
@@ -1114,295 +1122,6 @@ function runTargetScript(targetScript, passThroughArgs) {
   process.exit(result.status === null ? 1 : result.status);
 }
 
-function parseMirrorBrowseFlags(args) {
-  const options = {
-    minYesPct: null,
-    maxYesPct: null,
-    minVolume24h: 0,
-    closesAfter: null,
-    closesBefore: null,
-    questionContains: null,
-    limit: 10,
-    chainId: null,
-    polymarketGammaUrl: null,
-    polymarketGammaMockUrl: null,
-    polymarketMockUrl: null,
-  };
-
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i];
-    if (token === '--min-yes-pct') {
-      options.minYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--min-yes-pct'), '--min-yes-pct');
-      i += 1;
-      continue;
-    }
-    if (token === '--max-yes-pct') {
-      options.maxYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--max-yes-pct'), '--max-yes-pct');
-      i += 1;
-      continue;
-    }
-    if (token === '--min-volume-24h') {
-      options.minVolume24h = parsePositiveNumber(requireFlagValue(args, i, '--min-volume-24h'), '--min-volume-24h');
-      i += 1;
-      continue;
-    }
-    if (token === '--closes-after') {
-      options.closesAfter = parseDateLikeFlag(requireFlagValue(args, i, '--closes-after'), '--closes-after');
-      i += 1;
-      continue;
-    }
-    if (token === '--closes-before') {
-      options.closesBefore = parseDateLikeFlag(requireFlagValue(args, i, '--closes-before'), '--closes-before');
-      i += 1;
-      continue;
-    }
-    if (token === '--question-contains') {
-      options.questionContains = requireFlagValue(args, i, '--question-contains');
-      i += 1;
-      continue;
-    }
-    if (token === '--limit') {
-      options.limit = parsePositiveInteger(requireFlagValue(args, i, '--limit'), '--limit');
-      i += 1;
-      continue;
-    }
-    if (token === '--chain-id') {
-      options.chainId = parseInteger(requireFlagValue(args, i, '--chain-id'), '--chain-id');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-gamma-url') {
-      options.polymarketGammaUrl = requireFlagValue(args, i, '--polymarket-gamma-url');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-gamma-mock-url') {
-      options.polymarketGammaMockUrl = requireFlagValue(args, i, '--polymarket-gamma-mock-url');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-mock-url') {
-      options.polymarketMockUrl = requireFlagValue(args, i, '--polymarket-mock-url');
-      i += 1;
-      continue;
-    }
-    throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror browse: ${token}`);
-  }
-
-  if (options.minYesPct !== null && options.maxYesPct !== null && options.minYesPct > options.maxYesPct) {
-    throw new CliError('INVALID_ARGS', '--min-yes-pct cannot be greater than --max-yes-pct.');
-  }
-
-  return options;
-}
-
-function parseMirrorVerifyFlags(args) {
-  const options = {
-    pandoraMarketAddress: null,
-    polymarketMarketId: null,
-    polymarketSlug: null,
-    includeSimilarity: false,
-    withRules: false,
-    allowRuleMismatch: false,
-    trustDeploy: false,
-    manifestFile: null,
-    polymarketHost: null,
-    polymarketGammaUrl: null,
-    polymarketGammaMockUrl: null,
-    polymarketMockUrl: null,
-  };
-
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i];
-    if (token === '--pandora-market-address' || token === '--market-address') {
-      options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(args, i, token),
-        token,
-      );
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-market-id') {
-      options.polymarketMarketId = requireFlagValue(args, i, '--polymarket-market-id');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-slug') {
-      options.polymarketSlug = requireFlagValue(args, i, '--polymarket-slug');
-      i += 1;
-      continue;
-    }
-    if (token === '--include-similarity') {
-      options.includeSimilarity = true;
-      continue;
-    }
-    if (token === '--with-rules') {
-      options.withRules = true;
-      continue;
-    }
-    if (token === '--allow-rule-mismatch') {
-      options.allowRuleMismatch = true;
-      continue;
-    }
-    if (token === '--trust-deploy') {
-      options.trustDeploy = true;
-      continue;
-    }
-    if (token === '--manifest-file') {
-      options.manifestFile = requireFlagValue(args, i, '--manifest-file');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-host') {
-      options.polymarketHost = requireFlagValue(args, i, '--polymarket-host');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-gamma-url') {
-      options.polymarketGammaUrl = requireFlagValue(args, i, '--polymarket-gamma-url');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-gamma-mock-url') {
-      options.polymarketGammaMockUrl = requireFlagValue(args, i, '--polymarket-gamma-mock-url');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-mock-url') {
-      options.polymarketMockUrl = requireFlagValue(args, i, '--polymarket-mock-url');
-      i += 1;
-      continue;
-    }
-    throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror verify: ${token}`);
-  }
-
-  if (!options.pandoraMarketAddress) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address> (alias: --market-address).');
-  }
-  if (!options.polymarketMarketId && !options.polymarketSlug) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'mirror verify requires --polymarket-market-id <id> or --polymarket-slug <slug>.');
-  }
-
-  return options;
-}
-
-function parseMirrorStatusFlags(args) {
-  const options = {
-    stateFile: null,
-    strategyHash: null,
-    withLive: false,
-    trustDeploy: false,
-    manifestFile: null,
-    pandoraMarketAddress: null,
-    polymarketMarketId: null,
-    polymarketSlug: null,
-    driftTriggerBps: 150,
-    hedgeTriggerUsdc: 10,
-    indexerUrl: null,
-    timeoutMs: DEFAULT_INDEXER_TIMEOUT_MS,
-    polymarketHost: null,
-    polymarketGammaUrl: null,
-    polymarketGammaMockUrl: null,
-    polymarketMockUrl: null,
-  };
-
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i];
-    if (token === '--state-file') {
-      options.stateFile = requireFlagValue(args, i, '--state-file');
-      i += 1;
-      continue;
-    }
-    if (token === '--strategy-hash') {
-      const value = requireFlagValue(args, i, '--strategy-hash');
-      if (!/^[a-f0-9]{16}$/i.test(value)) {
-        throw new CliError('INVALID_FLAG_VALUE', '--strategy-hash must be a 16-character hex value.');
-      }
-      options.strategyHash = value.toLowerCase();
-      i += 1;
-      continue;
-    }
-    if (token === '--with-live') {
-      options.withLive = true;
-      continue;
-    }
-    if (token === '--trust-deploy') {
-      options.trustDeploy = true;
-      continue;
-    }
-    if (token === '--manifest-file') {
-      options.manifestFile = requireFlagValue(args, i, '--manifest-file');
-      i += 1;
-      continue;
-    }
-    if (token === '--pandora-market-address' || token === '--market-address') {
-      options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(args, i, token),
-        token,
-      );
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-market-id') {
-      options.polymarketMarketId = requireFlagValue(args, i, '--polymarket-market-id');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-slug') {
-      options.polymarketSlug = requireFlagValue(args, i, '--polymarket-slug');
-      i += 1;
-      continue;
-    }
-    if (token === '--drift-trigger-bps') {
-      options.driftTriggerBps = parsePositiveInteger(requireFlagValue(args, i, '--drift-trigger-bps'), '--drift-trigger-bps');
-      i += 1;
-      continue;
-    }
-    if (token === '--hedge-trigger-usdc') {
-      options.hedgeTriggerUsdc = parsePositiveNumber(requireFlagValue(args, i, '--hedge-trigger-usdc'), '--hedge-trigger-usdc');
-      i += 1;
-      continue;
-    }
-    if (token === '--indexer-url') {
-      options.indexerUrl = requireFlagValue(args, i, '--indexer-url');
-      i += 1;
-      continue;
-    }
-    if (token === '--timeout-ms') {
-      options.timeoutMs = parsePositiveInteger(requireFlagValue(args, i, '--timeout-ms'), '--timeout-ms');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-host') {
-      options.polymarketHost = requireFlagValue(args, i, '--polymarket-host');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-gamma-url') {
-      options.polymarketGammaUrl = requireFlagValue(args, i, '--polymarket-gamma-url');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-gamma-mock-url') {
-      options.polymarketGammaMockUrl = requireFlagValue(args, i, '--polymarket-gamma-mock-url');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-mock-url') {
-      options.polymarketMockUrl = requireFlagValue(args, i, '--polymarket-mock-url');
-      i += 1;
-      continue;
-    }
-    throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror status: ${token}`);
-  }
-
-  if (!options.stateFile && !options.strategyHash) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'mirror status requires --state-file <path> or --strategy-hash <hash>.');
-  }
-
-  return options;
-}
-
 function buildMirrorSyncStrategy(options) {
   return {
     mode: options.mode,
@@ -1504,222 +1223,6 @@ function buildMirrorSyncDaemonCliArgs(options, shared) {
   return args;
 }
 
-function parseMirrorCloseFlags(args) {
-  const options = {
-    pandoraMarketAddress: null,
-    polymarketMarketId: null,
-    polymarketSlug: null,
-    execute: false,
-    dryRun: false,
-  };
-
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i];
-    if (token === '--pandora-market-address' || token === '--market-address') {
-      options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(args, i, token),
-        token,
-      );
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-market-id') {
-      options.polymarketMarketId = requireFlagValue(args, i, '--polymarket-market-id');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-slug') {
-      options.polymarketSlug = requireFlagValue(args, i, '--polymarket-slug');
-      i += 1;
-      continue;
-    }
-    if (token === '--dry-run') {
-      options.dryRun = true;
-      continue;
-    }
-    if (token === '--execute') {
-      options.execute = true;
-      continue;
-    }
-    throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror close: ${token}`);
-  }
-
-  if (!options.pandoraMarketAddress) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address> (alias: --market-address).');
-  }
-  if (!options.polymarketMarketId && !options.polymarketSlug) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'mirror close requires --polymarket-market-id <id> or --polymarket-slug <slug>.');
-  }
-  if (options.dryRun === options.execute) {
-    throw new CliError('INVALID_ARGS', 'mirror close requires exactly one mode: --dry-run or --execute.');
-  }
-
-  return options;
-}
-
-function parseMirrorLpExplainFlags(args) {
-  const options = {
-    liquidityUsdc: null,
-    sourceYesPct: null,
-    distributionYes: null,
-    distributionNo: null,
-  };
-
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i];
-    if (token === '--liquidity-usdc') {
-      options.liquidityUsdc = parsePositiveNumber(requireFlagValue(args, i, '--liquidity-usdc'), '--liquidity-usdc');
-      i += 1;
-      continue;
-    }
-    if (token === '--source-yes-pct') {
-      options.sourceYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--source-yes-pct'), '--source-yes-pct');
-      i += 1;
-      continue;
-    }
-    if (token === '--distribution-yes') {
-      options.distributionYes = parseNonNegativeInteger(
-        requireFlagValue(args, i, '--distribution-yes'),
-        '--distribution-yes',
-      );
-      i += 1;
-      continue;
-    }
-    if (token === '--distribution-no') {
-      options.distributionNo = parseNonNegativeInteger(
-        requireFlagValue(args, i, '--distribution-no'),
-        '--distribution-no',
-      );
-      i += 1;
-      continue;
-    }
-    throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror lp-explain: ${token}`);
-  }
-
-  if (options.liquidityUsdc === null) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'mirror lp-explain requires --liquidity-usdc <n>.');
-  }
-  if (
-    (options.distributionYes === null && options.distributionNo !== null) ||
-    (options.distributionYes !== null && options.distributionNo === null)
-  ) {
-    throw new CliError('INVALID_ARGS', 'Provide both --distribution-yes and --distribution-no together.');
-  }
-  if (
-    options.distributionYes !== null &&
-    options.distributionNo !== null &&
-    options.distributionYes + options.distributionNo !== 1_000_000_000
-  ) {
-    throw new CliError('INVALID_ARGS', '--distribution-yes + --distribution-no must equal 1000000000.');
-  }
-
-  return options;
-}
-
-function parseMirrorSimulateFlags(args) {
-  const options = {
-    liquidityUsdc: null,
-    sourceYesPct: null,
-    targetYesPct: null,
-    polymarketYesPct: null,
-    distributionYes: null,
-    distributionNo: null,
-    feeTier: 3000,
-    hedgeRatio: 1,
-    hedgeCostBps: 35,
-    volumeScenarios: null,
-  };
-
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i];
-    if (token === '--liquidity-usdc') {
-      options.liquidityUsdc = parsePositiveNumber(requireFlagValue(args, i, '--liquidity-usdc'), '--liquidity-usdc');
-      i += 1;
-      continue;
-    }
-    if (token === '--source-yes-pct') {
-      options.sourceYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--source-yes-pct'), '--source-yes-pct');
-      i += 1;
-      continue;
-    }
-    if (token === '--target-yes-pct') {
-      options.targetYesPct = parseProbabilityPercent(requireFlagValue(args, i, '--target-yes-pct'), '--target-yes-pct');
-      i += 1;
-      continue;
-    }
-    if (token === '--polymarket-yes-pct') {
-      options.polymarketYesPct = parseProbabilityPercent(
-        requireFlagValue(args, i, '--polymarket-yes-pct'),
-        '--polymarket-yes-pct',
-      );
-      i += 1;
-      continue;
-    }
-    if (token === '--distribution-yes') {
-      options.distributionYes = parseNonNegativeInteger(
-        requireFlagValue(args, i, '--distribution-yes'),
-        '--distribution-yes',
-      );
-      i += 1;
-      continue;
-    }
-    if (token === '--distribution-no') {
-      options.distributionNo = parseNonNegativeInteger(
-        requireFlagValue(args, i, '--distribution-no'),
-        '--distribution-no',
-      );
-      i += 1;
-      continue;
-    }
-    if (token === '--fee-tier') {
-      options.feeTier = parsePositiveInteger(requireFlagValue(args, i, '--fee-tier'), '--fee-tier');
-      i += 1;
-      continue;
-    }
-    if (token === '--hedge-ratio') {
-      options.hedgeRatio = parsePositiveNumber(requireFlagValue(args, i, '--hedge-ratio'), '--hedge-ratio');
-      i += 1;
-      continue;
-    }
-    if (token === '--hedge-cost-bps') {
-      options.hedgeCostBps = parseNonNegativeInteger(requireFlagValue(args, i, '--hedge-cost-bps'), '--hedge-cost-bps');
-      i += 1;
-      continue;
-    }
-    if (token === '--volume-scenarios') {
-      options.volumeScenarios = parseCsvNumberList(requireFlagValue(args, i, '--volume-scenarios'), '--volume-scenarios');
-      i += 1;
-      continue;
-    }
-    throw new CliError('UNKNOWN_FLAG', `Unknown flag for mirror simulate: ${token}`);
-  }
-
-  if (options.liquidityUsdc === null) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'mirror simulate requires --liquidity-usdc <n>.');
-  }
-  if (
-    (options.distributionYes === null && options.distributionNo !== null) ||
-    (options.distributionYes !== null && options.distributionNo === null)
-  ) {
-    throw new CliError('INVALID_ARGS', 'Provide both --distribution-yes and --distribution-no together.');
-  }
-  if (
-    options.distributionYes !== null &&
-    options.distributionNo !== null &&
-    options.distributionYes + options.distributionNo !== 1_000_000_000
-  ) {
-    throw new CliError('INVALID_ARGS', '--distribution-yes + --distribution-no must equal 1000000000.');
-  }
-  if (![500, 3000, 10000].includes(options.feeTier)) {
-    throw new CliError('INVALID_FLAG_VALUE', '--fee-tier must be one of 500, 3000, 10000.');
-  }
-  if (options.hedgeRatio > 5) {
-    throw new CliError('INVALID_FLAG_VALUE', '--hedge-ratio must be <= 5.');
-  }
-
-  return options;
-}
-
 async function buildDoctorReport(options) {
   return getDoctorServiceInstance().buildDoctorReport(options);
 }
@@ -4674,6 +4177,21 @@ const parseMirrorSyncDaemonSelectorFlagsFromModule = createParseMirrorSyncDaemon
   CliError,
   requireFlagValue,
 });
+const parseMirrorBrowseFlagsFromModule = createParseMirrorBrowseFlags({
+  ...sharedParserDeps,
+  parseDateLikeFlag,
+});
+const parseMirrorVerifyFlagsFromModule = createParseMirrorVerifyFlags(sharedParserDeps);
+const parseMirrorStatusFlagsFromModule = createParseMirrorStatusFlags({
+  ...sharedParserDeps,
+  defaultIndexerTimeoutMs: DEFAULT_INDEXER_TIMEOUT_MS,
+});
+const parseMirrorCloseFlagsFromModule = createParseMirrorCloseFlags(sharedParserDeps);
+const parseMirrorLpExplainFlagsFromModule = createParseMirrorLpExplainFlags(sharedParserDeps);
+const parseMirrorSimulateFlagsFromModule = createParseMirrorSimulateFlags({
+  ...sharedParserDeps,
+  parseCsvNumberList,
+});
 const parsePolymarketSharedFlagsFromModule = createParsePolymarketSharedFlags({
   CliError,
   requireFlagValue,
@@ -5251,18 +4769,18 @@ const runMirrorCommand = createRunMirrorCommand({
   maybeLoadIndexerEnv,
   maybeLoadTradeEnv,
   resolveIndexerUrl,
-  parseMirrorBrowseFlags,
+  parseMirrorBrowseFlags: parseMirrorBrowseFlagsFromModule,
   parseMirrorPlanFlags: parseMirrorPlanFlagsFromModule,
   parseMirrorDeployFlags: parseMirrorDeployFlagsFromModule,
-  parseMirrorVerifyFlags,
-  parseMirrorStatusFlags,
+  parseMirrorVerifyFlags: parseMirrorVerifyFlagsFromModule,
+  parseMirrorStatusFlags: parseMirrorStatusFlagsFromModule,
   parseMirrorSyncFlags: parseMirrorSyncFlagsFromModule,
   parseMirrorSyncDaemonSelectorFlags: parseMirrorSyncDaemonSelectorFlagsFromModule,
   parseMirrorGoFlags: parseMirrorGoFlagsFromModule,
-  parseMirrorCloseFlags,
-  parseMirrorLpExplainFlags,
+  parseMirrorCloseFlags: parseMirrorCloseFlagsFromModule,
+  parseMirrorLpExplainFlags: parseMirrorLpExplainFlagsFromModule,
   parseMirrorHedgeCalcFlags: parseMirrorHedgeCalcFlagsFromModule,
-  parseMirrorSimulateFlags,
+  parseMirrorSimulateFlags: parseMirrorSimulateFlagsFromModule,
   buildMirrorPlan,
   deployMirror,
   verifyMirror,

package/package.json

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

package/tests/cli/cli.integration.test.cjs

@@ -1057,6 +1057,12 @@ test('schema command requires --output json mode', () => {
   assert.match(result.output, /only supported in --output json mode/i);
 });
 
+test('schema --help succeeds in table mode', () => {
+  const result = runCli(['schema', '--help']);
+  assert.equal(result.status, 0);
+  assert.match(String(result.stdout || ''), /Usage:\s+pandora --output json schema/);
+});
+
 test('schema command returns envelope schema plus command descriptors', () => {
   const result = runCli(['--output', 'json', 'schema']);
   assert.equal(result.status, 0);

package/tests/unit/new-features.test.cjs

@@ -46,6 +46,7 @@ const {
 const { runMirrorSync } = require('../../cli/lib/mirror_sync_service.cjs');
 const { createRunMirrorCommand } = require('../../cli/lib/mirror_command_service.cjs');
 const { resolveForkRuntime } = require('../../cli/lib/fork_runtime_service.cjs');
+const { createErrorRecoveryService } = require('../../cli/lib/error_recovery_service.cjs');
 const { createParseTradeFlags } = require('../../cli/lib/parsers/trade_flags.cjs');
 const { createParseWatchFlags } = require('../../cli/lib/parsers/watch_flags.cjs');
 const { createParseAutopilotFlags } = require('../../cli/lib/parsers/autopilot_flags.cjs');
@@ -1929,3 +1930,74 @@ test('createRunMirrorCommand sync help reports run|once|start usage and daemon s
   assert.match(payload.daemonLifecycle.stop, /--pid-file <path>\|--strategy-hash <hash>/);
   assert.match(payload.daemonLifecycle.status, /--pid-file <path>\|--strategy-hash <hash>/);
 });
+
+test('error recovery service returns hints for all mapped codes', () => {
+  const recovery = createErrorRecoveryService({ cliName: 'pandora' });
+  const mappedCodes = [
+    'TRADE_RISK_GUARD',
+    'ALLOWANCE_READ_FAILED',
+    'APPROVE_SIMULATION_FAILED',
+    'APPROVE_EXECUTION_FAILED',
+    'TRADE_EXECUTION_FAILED',
+    'POLYMARKET_APPROVE_FAILED',
+    'POLYMARKET_PROXY_APPROVAL_REQUIRES_MANUAL_EXECUTION',
+    'POLYMARKET_TRADE_FAILED',
+    'POLYMARKET_PREFLIGHT_FAILED',
+    'POLYMARKET_CHECK_FAILED',
+    'POLYMARKET_MARKET_RESOLUTION_FAILED',
+    'MIRROR_DEPLOY_FAILED',
+    'MIRROR_SYNC_FAILED',
+    'MCP_EXECUTE_INTENT_REQUIRED',
+    'MCP_LONG_RUNNING_MODE_BLOCKED',
+    'MCP_TOOL_FAILED',
+    'UNKNOWN_TOOL',
+    'MISSING_REQUIRED_FLAG',
+    'MISSING_FLAG_VALUE',
+    'INVALID_FLAG_VALUE',
+    'UNKNOWN_FLAG',
+    'INVALID_ARGS',
+    'INVALID_USAGE',
+    'INVALID_OUTPUT_MODE',
+    'UNSUPPORTED_OUTPUT_MODE',
+    'UNKNOWN_COMMAND',
+  ];
+
+  for (const code of mappedCodes) {
+    const result = recovery.getRecoveryForError({ code });
+    assert.equal(Boolean(result), true, `Expected recovery hint for ${code}`);
+    assert.equal(typeof result.action, 'string');
+    assert.equal(result.action.length > 0, true);
+    assert.equal(typeof result.command, 'string');
+    assert.equal(result.command.length > 0, true);
+    assert.equal(typeof result.retryable, 'boolean');
+  }
+});
+
+test('error recovery service falls through to null for unmapped codes', () => {
+  const recovery = createErrorRecoveryService({ cliName: 'pandora' });
+  assert.equal(recovery.getRecoveryForError({ code: 'SOME_NEW_CODE' }), null);
+  assert.equal(recovery.getRecoveryForError({ code: '' }), null);
+  assert.equal(recovery.getRecoveryForError(null), null);
+});
+
+test('error recovery service builds deterministic command hints for key flows', () => {
+  const recovery = createErrorRecoveryService({ cliName: 'pandora' });
+
+  const tradeRetry = recovery.getRecoveryForError({
+    code: 'TRADE_RISK_GUARD',
+    details: {
+      marketAddress: TEST_MARKET,
+      side: 'no',
+      amountUsdc: 12.5,
+    },
+  });
+  assert.equal(tradeRetry.command.includes(`--market-address ${TEST_MARKET}`), true);
+  assert.equal(tradeRetry.command.includes('--side no'), true);
+  assert.equal(tradeRetry.command.includes('--amount-usdc 12.5'), true);
+
+  const mirrorSyncRetry = recovery.getRecoveryForError({ code: 'MIRROR_SYNC_FAILED' });
+  assert.equal(mirrorSyncRetry.command, 'pandora mirror sync once --paper --pandora-market-address <address> --polymarket-market-id <id>');
+
+  const mcpRetry = recovery.getRecoveryForError({ code: 'MCP_EXECUTE_INTENT_REQUIRED' });
+  assert.equal(mcpRetry.command, 'pandora mcp');
+});