pandora-cli-skills 1.1.23 → 1.1.25

package/README.md

@@ -36,5 +36,7 @@ npx pandora-cli-skills@latest --help
 ## Notes
 
 - Node.js `>=18` required.
+- Full CLI skill contract, error semantics, and workflow references are documented in
+  [`SKILL.md`](./SKILL.md).
 - Full operational and JSON contract documentation is in
   [`README_FOR_SHARING.md`](./README_FOR_SHARING.md).

package/SKILL.md

@@ -193,6 +193,57 @@ pandora --output json suggest --wallet <0x...> --risk medium --budget 50 --inclu
 - `suggest`: risk/budget-ranked opportunities seeded from arbitrage output and wallet history.
 - `resolve` and `lp`: enabled command paths with strict flag/runtime validation and decoded on-chain revert reporting.
 
+## Polymarket command group
+- `pandora polymarket check [--rpc-url <url>] [--private-key <hex>] [--funder <address>]`
+  - Discovers signer + proxy wallet readiness and reports balances/allowances/ownership checks.
+- `pandora polymarket approve --dry-run|--execute [--rpc-url <url>] [--private-key <hex>] [--funder <address>]`
+  - Validates and applies required USDC.e + CTF approvals for hedge execution paths.
+- `pandora polymarket preflight [--rpc-url <url>] [--private-key <hex>] [--funder <address>]`
+  - Aggregated readiness gate for live Polymarket trading operations.
+- `pandora polymarket trade --condition-id <id>|--slug <slug>|--token-id <id> --token yes|no --amount-usdc <n> --dry-run|--execute [--side buy|sell] [--polymarket-host <url>] [--timeout-ms <ms>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>]`
+  - Direct Polymarket order path outside `mirror sync`.
+
+## Mirror workflow guide
+1. Plan:
+   - `pandora mirror plan --source polymarket --polymarket-slug <slug> --with-rules --include-similarity`
+2. Deploy:
+   - `pandora mirror deploy --polymarket-slug <slug> --liquidity-usdc 10 --dry-run|--execute`
+3. Verify:
+   - `pandora mirror verify --market-address <pandora-market> --polymarket-slug <slug> --include-similarity --with-rules`
+4. Run sync:
+   - `pandora mirror sync run --market-address <pandora-market> --polymarket-slug <slug> --paper`
+   - live: `--execute-live --max-open-exposure-usdc <n> --max-trades-per-day <n>`
+5. Inspect status:
+   - `pandora mirror status --state-file <path> --with-live`
+
+Mode aliases:
+- Mirror commands accept both mode styles:
+  - paper/live: `--paper` or `--dry-run`, and `--execute-live` or `--execute`
+- Mirror commands accept either market flag name:
+  - `--pandora-market-address` or `--market-address`
+
+## Distribution format (ppb)
+- Distribution inputs use parts-per-billion (ppb):
+  - `--distribution-yes 580000000` means YES seed weight = `58%`.
+  - `--distribution-no 420000000` means NO seed weight = `42%`.
+  - Constraint: `distributionYes + distributionNo = 1_000_000_000`.
+
+## Error code guide
+Common structured error codes for automation:
+- `MISSING_REQUIRED_FLAG`: required flag absent.
+- `INVALID_FLAG_VALUE`: wrong type/range/format for a flag.
+- `INVALID_ARGS`: conflicting or incompatible argument combinations.
+- `UNKNOWN_FLAG`: unrecognized flag for a command.
+- `UNKNOWN_COMMAND`: unrecognized top-level command.
+- `NOT_FOUND`: requested entity not found.
+- `INDEXER_HTTP_ERROR` / `INDEXER_TIMEOUT`: indexer transport failure.
+- `MIRROR_*`: mirror pipeline/service failures (plan/deploy/verify/sync/go/status).
+- `POLYMARKET_*`: Polymarket resolution/auth/order/preflight failures.
+- `WEBHOOK_DELIVERY_FAILED`: webhook hard-fail when `--fail-on-webhook-error` is set.
+
+Error envelope:
+- `{ ok: false, error: { code, message, details? } }`
+
 ## Pandora mainnet deployment reference
 - PredictionOracle (Factory): `0x259308E7d8557e4Ba192De1aB8Cf7e0E21896442`
 - PredictionPoll (Implementation): `0xC49c177736107fD8351ed6564136B9ADbE5B1eC3`

package/cli/pandora.cjs

@@ -58,6 +58,15 @@ const ROOT = path.resolve(__dirname, '..');
 const DEFAULT_ENV_FILE = path.join(ROOT, 'scripts', '.env');
 const DEFAULT_ENV_EXAMPLE = path.join(ROOT, 'scripts', '.env.example');
 const DEFAULT_INDEXER_URL = 'https://pandoraindexer.up.railway.app/';
+let PACKAGE_VERSION = '0.0.0';
+try {
+  const packageJson = require(path.join(ROOT, 'package.json'));
+  if (packageJson && typeof packageJson.version === 'string' && packageJson.version.trim()) {
+    PACKAGE_VERSION = packageJson.version.trim();
+  }
+} catch {
+  // best effort
+}
 
 const REQUIRED_ENV_KEYS = ['CHAIN_ID', 'RPC_URL', 'PRIVATE_KEY', 'ORACLE', 'FACTORY', 'USDC'];
 const SUPPORTED_CHAIN_IDS = new Set([1, 146]);
@@ -228,6 +237,7 @@ pandora - Prediction market CLI
 
 Usage:
   pandora [--output table|json] help
+  pandora [--output table|json] --version
   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>]
@@ -540,8 +550,32 @@ function inferRequestedOutputMode(argv) {
   return 'table';
 }
 
+function expandEqualsStyleFlags(argv) {
+  const expanded = [];
+  for (const token of Array.isArray(argv) ? argv : []) {
+    if (
+      typeof token === 'string' &&
+      token.startsWith('--') &&
+      token.includes('=') &&
+      token !== '--'
+    ) {
+      const eqIndex = token.indexOf('=');
+      const flag = token.slice(0, eqIndex);
+      const value = token.slice(eqIndex + 1);
+      if (flag && flag !== '--') {
+        expanded.push(flag);
+        if (value.length) expanded.push(value);
+        continue;
+      }
+    }
+    expanded.push(token);
+  }
+  return expanded;
+}
+
 function extractOutputMode(argv) {
   let outputMode = 'table';
+  let outputConfigured = false;
   const args = [];
 
   for (let i = 0; i < argv.length; i += 1) {
@@ -551,13 +585,23 @@ function extractOutputMode(argv) {
       if (!next) {
         throw new CliError('MISSING_FLAG_VALUE', `Missing value for ${token}`);
       }
-      outputMode = normalizeOutputMode(next);
+      const parsedMode = normalizeOutputMode(next);
+      if (outputConfigured && parsedMode !== outputMode) {
+        throw new CliError('INVALID_ARGS', `Conflicting --output values: "${outputMode}" and "${parsedMode}".`);
+      }
+      outputMode = parsedMode;
+      outputConfigured = true;
       i += 1;
       continue;
     }
 
     if (token.startsWith('--output=')) {
-      outputMode = normalizeOutputMode(token.slice('--output='.length));
+      const parsedMode = normalizeOutputMode(token.slice('--output='.length));
+      if (outputConfigured && parsedMode !== outputMode) {
+        throw new CliError('INVALID_ARGS', `Conflicting --output values: "${outputMode}" and "${parsedMode}".`);
+      }
+      outputMode = parsedMode;
+      outputConfigured = true;
       continue;
     }
 
@@ -567,6 +611,18 @@ function extractOutputMode(argv) {
   return { outputMode, args };
 }
 
+function parseDateLikeFlag(value, flagName) {
+  const text = String(value || '').trim();
+  const parsed = Date.parse(text);
+  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}"`,
+    );
+  }
+  return text;
+}
+
 function emitJson(payload) {
   console.log(JSON.stringify(payload, null, 2));
 }
@@ -2453,8 +2509,8 @@ function parseAutopilotFlags(args) {
 
   for (let i = 0; i < rest.length; i += 1) {
     const token = rest[i];
-    if (token === '--market-address') {
-      options.marketAddress = parseAddressFlag(requireFlagValue(rest, i, '--market-address'), '--market-address');
+    if (token === '--market-address' || token === '--pandora-market-address') {
+      options.marketAddress = parseAddressFlag(requireFlagValue(rest, i, token), token);
       i += 1;
       continue;
     }
@@ -2478,11 +2534,11 @@ function parseAutopilotFlags(args) {
       i += 1;
       continue;
     }
-    if (token === '--paper') {
+    if (token === '--paper' || token === '--dry-run') {
       options.executeLive = false;
       continue;
     }
-    if (token === '--execute-live') {
+    if (token === '--execute-live' || token === '--execute') {
       options.executeLive = true;
       continue;
     }
@@ -2801,12 +2857,12 @@ function parseMirrorBrowseFlags(args) {
       continue;
     }
     if (token === '--closes-after') {
-      options.closesAfter = requireFlagValue(args, i, '--closes-after');
+      options.closesAfter = parseDateLikeFlag(requireFlagValue(args, i, '--closes-after'), '--closes-after');
       i += 1;
       continue;
     }
     if (token === '--closes-before') {
-      options.closesBefore = requireFlagValue(args, i, '--closes-before');
+      options.closesBefore = parseDateLikeFlag(requireFlagValue(args, i, '--closes-before'), '--closes-before');
       i += 1;
       continue;
     }
@@ -3082,10 +3138,10 @@ function parseMirrorVerifyFlags(args) {
 
   for (let i = 0; i < args.length; i += 1) {
     const token = args[i];
-    if (token === '--pandora-market-address') {
+    if (token === '--pandora-market-address' || token === '--market-address') {
       options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(args, i, '--pandora-market-address'),
-        '--pandora-market-address',
+        requireFlagValue(args, i, token),
+        token,
       );
       i += 1;
       continue;
@@ -3145,7 +3201,7 @@ function parseMirrorVerifyFlags(args) {
   }
 
   if (!options.pandoraMarketAddress) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address>.');
+    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>.');
@@ -3203,10 +3259,10 @@ function parseMirrorStatusFlags(args) {
       i += 1;
       continue;
     }
-    if (token === '--pandora-market-address') {
+    if (token === '--pandora-market-address' || token === '--market-address') {
       options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(args, i, '--pandora-market-address'),
-        '--pandora-market-address',
+        requireFlagValue(args, i, token),
+        token,
       );
       i += 1;
       continue;
@@ -3327,10 +3383,10 @@ function parseMirrorSyncFlags(args) {
 
   for (let i = 0; i < rest.length; i += 1) {
     const token = rest[i];
-    if (token === '--pandora-market-address') {
+    if (token === '--pandora-market-address' || token === '--market-address') {
       options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(rest, i, '--pandora-market-address'),
-        '--pandora-market-address',
+        requireFlagValue(rest, i, token),
+        token,
       );
       i += 1;
       continue;
@@ -3345,12 +3401,12 @@ function parseMirrorSyncFlags(args) {
       i += 1;
       continue;
     }
-    if (token === '--paper') {
+    if (token === '--paper' || token === '--dry-run') {
       sawPaperModeFlag = true;
       options.executeLive = false;
       continue;
     }
-    if (token === '--execute-live') {
+    if (token === '--execute-live' || token === '--execute') {
       sawExecuteLiveModeFlag = true;
       options.executeLive = true;
       continue;
@@ -3531,10 +3587,13 @@ function parseMirrorSyncFlags(args) {
   }
 
   if (!options.pandoraMarketAddress) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address>.');
+    throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address> (alias: --market-address).');
   }
   if (sawPaperModeFlag && sawExecuteLiveModeFlag) {
-    throw new CliError('INVALID_ARGS', 'mirror sync accepts only one mode flag: --paper or --execute-live.');
+    throw new CliError(
+      'INVALID_ARGS',
+      'mirror sync accepts only one mode flag: --paper/--dry-run or --execute-live/--execute.',
+    );
   }
   if (options.mode === 'once' && options.daemon) {
     throw new CliError('INVALID_ARGS', 'mirror sync once does not support --daemon. Use mirror sync start for background run mode.');
@@ -3792,13 +3851,13 @@ function parseMirrorGoFlags(args) {
       i += 1;
       continue;
     }
-    if (token === '--paper') {
+    if (token === '--paper' || token === '--dry-run') {
       sawPaperModeFlag = true;
       options.paper = true;
       options.executeLive = false;
       continue;
     }
-    if (token === '--execute-live') {
+    if (token === '--execute-live' || token === '--execute') {
       sawExecuteLiveModeFlag = true;
       options.executeLive = true;
       options.paper = false;
@@ -3972,7 +4031,10 @@ function parseMirrorGoFlags(args) {
     throw new CliError('MISSING_REQUIRED_FLAG', 'mirror go requires --polymarket-market-id <id> or --polymarket-slug <slug>.');
   }
   if (sawPaperModeFlag && sawExecuteLiveModeFlag) {
-    throw new CliError('INVALID_ARGS', 'mirror go accepts only one mode flag: --paper or --execute-live.');
+    throw new CliError(
+      'INVALID_ARGS',
+      'mirror go accepts only one mode flag: --paper/--dry-run or --execute-live/--execute.',
+    );
   }
   if (![500, 3000, 10000].includes(options.feeTier)) {
     throw new CliError('INVALID_FLAG_VALUE', '--fee-tier must be one of 500, 3000, 10000.');
@@ -4003,10 +4065,10 @@ function parseMirrorCloseFlags(args) {
 
   for (let i = 0; i < args.length; i += 1) {
     const token = args[i];
-    if (token === '--pandora-market-address') {
+    if (token === '--pandora-market-address' || token === '--market-address') {
       options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(args, i, '--pandora-market-address'),
-        '--pandora-market-address',
+        requireFlagValue(args, i, token),
+        token,
       );
       i += 1;
       continue;
@@ -4033,7 +4095,7 @@ function parseMirrorCloseFlags(args) {
   }
 
   if (!options.pandoraMarketAddress) {
-    throw new CliError('MISSING_REQUIRED_FLAG', 'Missing --pandora-market-address <address>.');
+    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>.');
@@ -4176,10 +4238,10 @@ function parseMirrorHedgeCalcFlags(args) {
       i += 1;
       continue;
     }
-    if (token === '--pandora-market-address') {
+    if (token === '--pandora-market-address' || token === '--market-address') {
       options.pandoraMarketAddress = parseAddressFlag(
-        requireFlagValue(args, i, '--pandora-market-address'),
-        '--pandora-market-address',
+        requireFlagValue(args, i, token),
+        token,
       );
       i += 1;
       continue;
@@ -4232,7 +4294,7 @@ function parseMirrorHedgeCalcFlags(args) {
     if (!options.pandoraMarketAddress) {
       throw new CliError(
         'MISSING_REQUIRED_FLAG',
-        'mirror hedge-calc with market selectors requires --pandora-market-address <address>.',
+        'mirror hedge-calc with market selectors requires --pandora-market-address <address> (alias: --market-address).',
       );
     }
     if (!options.polymarketMarketId && !options.polymarketSlug) {
@@ -8814,25 +8876,25 @@ async function runMirrorCommand(args, context) {
         '  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>]',
       );
       console.log(
-        '  verify --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--trust-deploy] [--manifest-file <path>] [--include-similarity] [--with-rules] [--allow-rule-mismatch]',
+        '  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]',
       );
       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> --polymarket-market-id <id>|--polymarket-slug <slug>]',
+        '  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     --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--auto-sync] [--sync-once] [--force-gate]',
+        '  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] [--force-gate]',
       );
       console.log(
-        '  sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--state-file <path>] [--kill-switch-file <path>]',
+        '  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] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--state-file <path>] [--kill-switch-file <path>]',
       );
       console.log('  status --state-file <path>|--strategy-hash <hash> [--with-live] [--trust-deploy]');
-      console.log('  close  --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute');
+      console.log('  close  --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute');
     }
     return;
   }
@@ -8840,7 +8902,7 @@ async function runMirrorCommand(args, context) {
   if (action === 'status') {
     if (includesHelpFlag(actionArgs)) {
       const usage =
-        'pandora [--output table|json] mirror status --state-file <path>|--strategy-hash <hash> [--with-live] [--pandora-market-address <address>] [--polymarket-market-id <id>|--polymarket-slug <slug>]';
+        'pandora [--output table|json] mirror status --state-file <path>|--strategy-hash <hash> [--with-live] [--pandora-market-address <address>|--market-address <address>] [--polymarket-market-id <id>|--polymarket-slug <slug>]';
       const polymarketEnv = [
         'POLYMARKET_PRIVATE_KEY',
         'POLYMARKET_FUNDER',
@@ -8913,7 +8975,7 @@ async function runMirrorCommand(args, context) {
       if (!selector.pandoraMarketAddress) {
         throw new CliError(
           'MISSING_REQUIRED_FLAG',
-          'mirror status --with-live requires --pandora-market-address (or a state file containing it).',
+          'mirror status --with-live requires --pandora-market-address/--market-address (or a state file containing it).',
         );
       }
       if (!selector.polymarketMarketId && !selector.polymarketSlug) {
@@ -9078,12 +9140,12 @@ async function runMirrorCommand(args, context) {
           context.outputMode,
           'mirror.verify.help',
           commandHelpPayload(
-            'pandora [--output table|json] mirror verify --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--trust-deploy] [--manifest-file <path>] [--include-similarity] [--with-rules] [--allow-rule-mismatch]',
+            'pandora [--output table|json] mirror 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]',
           ),
         );
       } else {
         console.log(
-          'Usage: pandora [--output table|json] mirror verify --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--trust-deploy] [--manifest-file <path>] [--include-similarity] [--with-rules] [--allow-rule-mismatch]',
+          'Usage: pandora [--output table|json] mirror 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]',
         );
       }
       return;
@@ -9153,7 +9215,7 @@ async function runMirrorCommand(args, context) {
   if (action === 'hedge-calc') {
     if (includesHelpFlag(shared.rest)) {
       const usage =
-        'pandora [--output table|json] mirror 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> --polymarket-market-id <id>|--polymarket-slug <slug>] [--trust-deploy] [--manifest-file <path>]';
+        'pandora [--output table|json] mirror 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>]';
       if (context.outputMode === 'json') {
         emitSuccess(context.outputMode, 'mirror.hedge-calc.help', commandHelpPayload(usage));
       } else {
@@ -9273,7 +9335,7 @@ async function runMirrorCommand(args, context) {
   if (action === 'go') {
     if (includesHelpFlag(shared.rest)) {
       const usage =
-        'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--auto-sync] [--sync-once] [--force-gate]';
+        'pandora [--output table|json] mirror 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] [--force-gate]';
       if (context.outputMode === 'json') {
         emitSuccess(context.outputMode, 'mirror.go.help', commandHelpPayload(usage));
       } else {
@@ -9519,10 +9581,10 @@ async function runMirrorCommand(args, context) {
           'mirror.sync.help',
           {
             usage:
-              'pandora [--output table|json] mirror sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
+              'pandora [--output table|json] mirror 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] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
             daemonLifecycle: {
               start:
-                'pandora [--output table|json] mirror sync start --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [run flags]',
+                'pandora [--output table|json] mirror sync start --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [run flags]',
               stop:
                 'pandora [--output table|json] mirror sync stop --pid-file <path>|--strategy-hash <hash>',
               status:
@@ -9548,7 +9610,7 @@ async function runMirrorCommand(args, context) {
         );
       } else {
         console.log(
-          'Usage: pandora [--output table|json] mirror sync run|once|start|stop|status --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--private-key <hex>] [--funder <address>] [--trust-deploy] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
+          'Usage: pandora [--output table|json] mirror 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] [--force-gate] [--daemon] [--stream] [--interval-ms <ms>] [--drift-trigger-bps <n>] [--hedge-trigger-usdc <n>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--min-time-to-close-sec <n>] [--state-file <path>] [--kill-switch-file <path>]',
         );
         console.log('Daemon stop: pandora mirror sync stop --pid-file <path>|--strategy-hash <hash>');
         console.log('Daemon status: pandora mirror sync status --pid-file <path>|--strategy-hash <hash>');
@@ -9760,7 +9822,7 @@ async function runMirrorCommand(args, context) {
   if (action === 'close') {
     if (includesHelpFlag(shared.rest)) {
       const usage =
-        'pandora [--output table|json] mirror close --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute';
+        '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 {
@@ -10408,6 +10470,15 @@ async function dispatch(command, args, context) {
     return;
   }
 
+  if (command === '--version' || command === '-V' || command === 'version') {
+    if (context.outputMode === 'json') {
+      emitSuccess(context.outputMode, 'version', { version: PACKAGE_VERSION });
+    } else {
+      console.log(PACKAGE_VERSION);
+    }
+    return;
+  }
+
   if (command === 'init-env') {
     runInitEnv(args, context.outputMode);
     return;
@@ -10545,7 +10616,7 @@ async function dispatch(command, args, context) {
 }
 
 async function main() {
-  const rawArgv = process.argv.slice(2);
+  const rawArgv = expandEqualsStyleFlags(process.argv.slice(2));
   let outputMode = inferRequestedOutputMode(rawArgv);
   let args = rawArgv;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pandora-cli-skills",
-  "version": "1.1.23",
+  "version": "1.1.25",
   "description": "Pandora CLI & Skills",
   "main": "cli/pandora.cjs",
   "bin": {
@@ -17,8 +17,7 @@
     "references/creation-script.md",
     "SKILL.md",
     "README.md",
-    "README_FOR_SHARING.md",
-    "tsconfig.json"
+    "README_FOR_SHARING.md"
   ],
   "scripts": {
     "cli": "node cli/pandora.cjs",
@@ -37,9 +36,24 @@
     "test:smoke": "node tests/smoke/pack-install-smoke.cjs",
     "test": "npm run build && npm run test:unit && npm run test:cli && npm run test:smoke"
   },
-  "keywords": [],
-  "author": "",
+  "keywords": [
+    "pandora",
+    "prediction-market",
+    "cli",
+    "polymarket",
+    "defi",
+    "hedging"
+  ],
+  "author": "Pandora CLI Contributors",
   "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XoAnonXo/pandora-cli-skills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/XoAnonXo/pandora-cli-skills/issues"
+  },
+  "homepage": "https://github.com/XoAnonXo/pandora-cli-skills#readme",
   "type": "commonjs",
   "engines": {
     "node": ">=18"

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "strict": false,
-    "noEmit": true,
-    "types": ["node"]
-  },
-  "include": ["scripts/**/*.ts"]
-}