pandora-cli-skills 1.1.5 → 1.1.6

package/README_FOR_SHARING.md

@@ -35,6 +35,13 @@ Prerequisite: Node.js `>=18`.
    - `ORACLE`
    - `FACTORY`
    - `USDC`
+   - optional for live mirror hedging:
+     - `POLYMARKET_PRIVATE_KEY`
+     - `POLYMARKET_FUNDER`
+     - `POLYMARKET_API_KEY`
+     - `POLYMARKET_API_SECRET`
+     - `POLYMARKET_API_PASSPHRASE`
+     - `POLYMARKET_HOST`
 4. Validate and build:
    - `npm run doctor`
    - `npm run build`
@@ -188,6 +195,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.
+  - rebalance sizing is pool-aware: drift notional scales with `reserveYes + reserveNo`, then bounded by `--max-rebalance-usdc`.
 - `mirror status`:
   - envelope is `ok=true`, `command="mirror.status"`, with `data.stateFile`, `data.strategyHash`, and persisted `data.state`.
 - `webhook test`:

package/SKILL.md

@@ -165,6 +165,8 @@ pandora --output json suggest --wallet <0x...> --risk medium --budget 50 --inclu
 - `mirror deploy`: dry-run/execute Pandora AMM deployment from mirror plan inputs.
 - `mirror verify`: explicit question/rules similarity endpoint for AI-subagent validation.
 - `mirror sync`: paper-first delta-neutral loop with strict gates, state persistence, and optional live hedging (`--hedge-ratio <n>`, `--no-hedge`).
+  - live hedge env: `POLYMARKET_PRIVATE_KEY`, `POLYMARKET_FUNDER`, `POLYMARKET_API_KEY`, `POLYMARKET_API_SECRET`, `POLYMARKET_API_PASSPHRASE`, `POLYMARKET_HOST`.
+  - rebalance sizing is pool-aware and bounded by `--max-rebalance-usdc`.
 - `mirror status`: local mirror state inspection (no network side effects).
 - `webhook test`: channel validation for generic, Telegram, and Discord payload delivery.
 - `leaderboard`: ranked user aggregates by profit/volume/win-rate.

package/cli/lib/mirror_sync_service.cjs

@@ -56,6 +56,7 @@ function evaluateSnapshot(verifyPayload, options) {
 
   const reserveYes = toNumber(pandora.reserveYes);
   const reserveNo = toNumber(pandora.reserveNo);
+  const reserveTotalUsdc = reserveYes !== null && reserveNo !== null ? round(reserveYes + reserveNo, 6) : null;
   const deltaLpUsdc = reserveYes !== null && reserveNo !== null ? round(reserveYes - reserveNo, 6) : null;
   const targetHedgeUsdc = deltaLpUsdc === null ? null : round(-deltaLpUsdc, 6);
 
@@ -64,6 +65,9 @@ function evaluateSnapshot(verifyPayload, options) {
     pandoraYesPct: pandoraYes,
     driftBps,
     driftTriggered,
+    reserveYesUsdc: reserveYes,
+    reserveNoUsdc: reserveNo,
+    reserveTotalUsdc,
     deltaLpUsdc,
     targetHedgeUsdc,
   };
@@ -217,9 +221,14 @@ async function runMirrorSync(options, deps = {}) {
       const scaledHedgeUsdc = rawHedgeTriggered ? Math.abs(gapUsdc) * options.hedgeRatio : 0;
       const plannedHedgeUsdc = hedgeTriggered ? Math.min(scaledHedgeUsdc, options.maxHedgeUsdc) : 0;
 
-      const driftMagnitudePct = snapshotMetrics.driftBps === null ? 0 : snapshotMetrics.driftBps / 100;
+      const driftFraction = snapshotMetrics.driftBps === null ? 0 : snapshotMetrics.driftBps / 10_000;
+      const rebalanceFromPoolUsdc =
+        snapshotMetrics.reserveTotalUsdc === null ? null : snapshotMetrics.reserveTotalUsdc * driftFraction;
+      const rebalanceFromDriftPointsUsdc = snapshotMetrics.driftBps === null ? 0 : snapshotMetrics.driftBps / 100;
+      const rebalanceSizingBasis = rebalanceFromPoolUsdc === null ? 'drift-points-fallback' : 'pool-size-drift';
+      const rebalanceCandidateUsdc = rebalanceFromPoolUsdc === null ? rebalanceFromDriftPointsUsdc : rebalanceFromPoolUsdc;
       const plannedRebalanceUsdc = snapshotMetrics.driftTriggered
-        ? Math.min(options.maxRebalanceUsdc, Math.max(1, driftMagnitudePct))
+        ? Math.min(options.maxRebalanceUsdc, Math.max(1, rebalanceCandidateUsdc))
         : 0;
 
       const plannedSpendUsdc = round(plannedHedgeUsdc + plannedRebalanceUsdc, 6) || 0;
@@ -257,6 +266,8 @@ async function runMirrorSync(options, deps = {}) {
           hedgeRatio: options.hedgeRatio,
           hedgeSuppressed: rawHedgeTriggered && !options.hedgeEnabled,
           plannedHedgeUsdc,
+          rebalanceSizingBasis,
+          rebalanceCandidateUsdc: round(rebalanceCandidateUsdc, 6),
           plannedRebalanceUsdc,
           plannedSpendUsdc,
           depthWithinSlippageUsd: depth.depthWithinSlippageUsd,
@@ -320,7 +331,7 @@ async function runMirrorSync(options, deps = {}) {
           }
 
           if (hedgeTriggered && plannedHedgeUsdc > 0) {
-            const hedgeSide = gapUsdc >= 0 ? 'buy' : 'buy';
+            const hedgeSide = 'buy';
             const tokenId = gapUsdc >= 0 ? verifyPayload.sourceMarket.yesTokenId : verifyPayload.sourceMarket.noTokenId;
 
             if (options.executeLive) {

package/cli/pandora.cjs

@@ -6630,14 +6630,26 @@ async function runMirrorCommand(args, context) {
         emitSuccess(
           context.outputMode,
           'mirror.sync.help',
-          commandHelpPayload(
-            'pandora [--output table|json] mirror sync run|once --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--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>]',
-          ),
+          {
+            usage:
+              'pandora [--output table|json] mirror sync run|once --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--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>]',
+            liveHedgeEnv: [
+              'POLYMARKET_PRIVATE_KEY',
+              'POLYMARKET_FUNDER',
+              'POLYMARKET_API_KEY',
+              'POLYMARKET_API_SECRET',
+              'POLYMARKET_API_PASSPHRASE',
+              'POLYMARKET_HOST',
+            ],
+          },
         );
       } else {
         console.log(
           'Usage: pandora [--output table|json] mirror sync run|once --pandora-market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--paper|--execute-live] [--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(
+          'Live hedge env: POLYMARKET_PRIVATE_KEY, POLYMARKET_FUNDER, POLYMARKET_API_KEY, POLYMARKET_API_SECRET, POLYMARKET_API_PASSPHRASE, POLYMARKET_HOST.',
+        );
       }
       return;
     }

package/package.json

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

package/scripts/.env.example

@@ -5,3 +5,11 @@ PRIVATE_KEY=0x...
 ORACLE=0x259308E7d8557e4Ba192De1aB8Cf7e0E21896442
 FACTORY=0xaB120F1FD31FB1EC39893B75d80a3822b1Cd8d0c
 USDC=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
+
+# Optional: Polymarket live hedging credentials for `pandora mirror sync --execute-live`
+POLYMARKET_HOST=https://clob.polymarket.com
+POLYMARKET_PRIVATE_KEY=0x...
+POLYMARKET_FUNDER=
+POLYMARKET_API_KEY=
+POLYMARKET_API_SECRET=
+POLYMARKET_API_PASSPHRASE=