pandora-cli-skills 1.1.65 → 1.1.66

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: pandora-cli-skills
 summary: Canonical skill and operator guide for Pandora CLI including mirror, polymarket, resolve, and LP flows.
-version: 1.1.65
+version: 1.1.66
 ---
 
 # Pandora CLI & Skills

package/cli/lib/agent_contract_registry.cjs

@@ -1890,7 +1890,7 @@ const commandContracts = [
     name: 'mirror.plan',
     summary: 'Generate mirror sizing and distribution plan from a Polymarket source market.',
     usage:
-      'pandora [--output table|json] mirror plan --source polymarket --polymarket-market-id <id>|--polymarket-slug <slug> [--chain-id <id>] [--target-slippage-bps <n>] [--turnover-target <n>] [--depth-slippage-bps <n>] [--safety-multiplier <n>] [--min-liquidity-usdc <n>] [--max-liquidity-usdc <n>] [--with-rules] [--include-similarity] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
+      'pandora [--output table|json] mirror 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] [--min-close-lead-seconds <n>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
     emits: ['mirror.plan', 'mirror.plan.help'],
     dataSchema: '#/definitions/MirrorPlanPayload',
     mcpExposed: true,
@@ -1911,6 +1911,7 @@ const commandContracts = [
           'max-liquidity-usdc': numberSchema('Maximum liquidity in USDC.', { minimum: 0 }),
           'with-rules': booleanSchema('Include market rules payloads.'),
           'include-similarity': booleanSchema('Include similarity diagnostics.'),
+          'min-close-lead-seconds': integerSchema('Lead time before targetTimestamp when Pandora trading closes.', { minimum: 1 }),
           'polymarket-gamma-url': stringSchema('Polymarket Gamma API base URL.'),
           'polymarket-gamma-mock-url': stringSchema('Polymarket Gamma mock URL.'),
           'polymarket-mock-url': stringSchema('Polymarket mock CLOB URL.'),
@@ -1923,7 +1924,7 @@ const commandContracts = [
     name: 'mirror.deploy',
     summary: 'Deploy a mirror market from selector or plan in dry-run or execute mode.',
     usage:
-      'pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--oracle <address>] [--factory <address>] [--usdc <address>] [--distribution-yes <parts>] [--distribution-no <parts>] [--sources <url...>] [--validation-ticket <ticket>] [--manifest-file <path>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--min-close-lead-seconds <n>]',
+      'pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--oracle <address>] [--factory <address>] [--usdc <address>] [--distribution-yes <parts>] [--distribution-no <parts>] [--sources <url...>] [--validation-ticket <ticket>] [--target-timestamp <unix|iso>] [--manifest-file <path>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--min-close-lead-seconds <n>]',
     emits: ['mirror.deploy', 'mirror.deploy.help'],
     dataSchema: '#/definitions/MirrorDeployPayload',
     mcpExposed: true,
@@ -1963,6 +1964,13 @@ const commandContracts = [
           'distribution-no': numberSchema('Initial NO distribution parts.', { minimum: 0 }),
           sources: flexibleArraySchema(stringSchema(), 'Source URL list.'),
           'validation-ticket': stringSchema('Ticket returned by agent.market.validate for the exact final payload (CLI execute mode).'),
+          'target-timestamp': {
+            description: 'Explicit target timestamp override.',
+            anyOf: [
+              integerSchema('Explicit target timestamp in unix seconds.', { minimum: 1 }),
+              stringSchema('Explicit ISO date/time override for target timestamp.'),
+            ],
+          },
           'manifest-file': stringSchema('Mirror manifest path.'),
           'polymarket-host': stringSchema('Polymarket host override.'),
           'polymarket-gamma-url': stringSchema('Polymarket Gamma API base URL.'),
@@ -2091,7 +2099,7 @@ const commandContracts = [
     name: 'mirror.go',
     summary: 'Run mirror deploy, verify, and optional sync workflow.',
     usage:
-      'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--paper|--dry-run|--execute-live|--execute] [--auto-sync] [--sync-once] [--sync-interval-ms <ms>] [--max-open-exposure-usdc <amount>] [--max-trades-per-day <n>] [--polymarket-rpc-url <url>] [--sources <url...>] [--validation-ticket <ticket>] [--manifest-file <path>] [--dotenv-path <path>] [--rpc-url <url>] [--private-key <hex>]',
+      'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--paper|--dry-run|--execute-live|--execute] [--auto-sync] [--sync-once] [--sync-interval-ms <ms>] [--max-open-exposure-usdc <amount>] [--max-trades-per-day <n>] [--polymarket-rpc-url <url>] [--sources <url...>] [--validation-ticket <ticket>] [--target-timestamp <unix|iso>] [--manifest-file <path>] [--dotenv-path <path>] [--rpc-url <url>] [--private-key <hex>]',
     emits: ['mirror.go', 'mirror.go.help'],
     dataSchema: '#/definitions/MirrorDeployPayload',
     mcpExposed: true,
@@ -2130,6 +2138,13 @@ const commandContracts = [
           'polymarket-rpc-url': stringSchema('Polygon RPC URL for Polymarket preflight.'),
           sources: flexibleArraySchema(stringSchema(), 'Independent public source URL list.'),
           'validation-ticket': stringSchema('Ticket returned by agent.market.validate for the exact final payload (CLI execute mode).'),
+          'target-timestamp': {
+            description: 'Explicit target timestamp override.',
+            anyOf: [
+              integerSchema('Explicit target timestamp in unix seconds.', { minimum: 1 }),
+              stringSchema('Explicit ISO date/time override for target timestamp.'),
+            ],
+          },
           'manifest-file': stringSchema('Mirror manifest path.'),
           'dotenv-path': stringSchema('Env file path.'),
           'rpc-url': commonFlags.rpcUrl,

package/cli/lib/mirror_command_service.cjs

@@ -4,7 +4,7 @@
  * @type {string}
  */
 const MIRROR_GO_USAGE =
-  'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--paper|--dry-run|--execute-live|--execute] [--auto-sync] [--sync-once] [--sync-interval-ms <ms>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-rpc-url <url>] [--private-key <hex>] [--funder <address>] [--usdc <address>] [--oracle <address>] [--factory <address>] [--sources <url...>] [--validation-ticket <ticket>] [--manifest-file <path>] [--trust-deploy] [--skip-gate] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--with-rules] [--include-similarity] [--min-close-lead-seconds <n>]';
+  'pandora [--output table|json] mirror go --polymarket-market-id <id>|--polymarket-slug <slug> [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--paper|--dry-run|--execute-live|--execute] [--auto-sync] [--sync-once] [--sync-interval-ms <ms>] [--hedge-ratio <n>] [--no-hedge] [--max-rebalance-usdc <n>] [--max-hedge-usdc <n>] [--max-open-exposure-usdc <n>] [--max-trades-per-day <n>] [--cooldown-ms <ms>] [--chain-id <id>] [--rpc-url <url>] [--polymarket-rpc-url <url>] [--private-key <hex>] [--funder <address>] [--usdc <address>] [--oracle <address>] [--factory <address>] [--sources <url...>] [--validation-ticket <ticket>] [--target-timestamp <unix|iso>] [--manifest-file <path>] [--trust-deploy] [--skip-gate] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--with-rules] [--include-similarity] [--min-close-lead-seconds <n>]';
 
 /**
  * Canonical usage string for `mirror sync`.
@@ -94,10 +94,10 @@ function createRunMirrorCommand(deps) {
           '  browse --min-yes-pct <n> --max-yes-pct <n> --min-volume-24h <n> [--closes-after <date>|--end-date-after <date|72h>] [--closes-before <date>|--end-date-before <date|72h>] [--question-contains <text>|--keyword <text>] [--slug <text>] [--category sports|crypto|politics|entertainment] [--exclude-sports] [--sort-by volume24h|liquidity|endDate] [--limit <n>] [--chain-id <id>] [--polymarket-tag-id <id>] [--polymarket-tag-ids <csv>] [--sport-tag-id <id>] [--sport-tag-ids <csv>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
         );
         console.log(
-          '  plan   --source polymarket --polymarket-market-id <id>|--polymarket-slug <slug> [--chain-id <id>] [--target-slippage-bps <n>] [--turnover-target <n>] [--depth-slippage-bps <n>] [--safety-multiplier <n>] [--min-liquidity-usdc <n>] [--max-liquidity-usdc <n>] [--with-rules] [--include-similarity] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
+          '  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] [--min-close-lead-seconds <n>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',
         );
         console.log(
-          '  deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--oracle <address>] [--factory <address>] [--usdc <address>] [--distribution-yes <parts>] [--distribution-no <parts>] [--sources <url...>] [--validation-ticket <ticket>] [--manifest-file <path>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--min-close-lead-seconds <n>]',
+          '  deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--chain-id <id>] [--rpc-url <url>] [--private-key <hex>] [--oracle <address>] [--factory <address>] [--usdc <address>] [--distribution-yes <parts>] [--distribution-no <parts>] [--sources <url...>] [--validation-ticket <ticket>] [--target-timestamp <unix|iso>] [--manifest-file <path>] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>] [--min-close-lead-seconds <n>]',
         );
         console.log(
           '  verify --pandora-market-address <address>|--market-address <address> --polymarket-market-id <id>|--polymarket-slug <slug> [--trust-deploy] [--manifest-file <path>] [--include-similarity] [--with-rules] [--allow-rule-mismatch] [--polymarket-host <url>] [--polymarket-gamma-url <url>] [--polymarket-gamma-mock-url <url>] [--polymarket-mock-url <url>]',

package/cli/lib/mirror_handlers/deploy.cjs

@@ -24,12 +24,12 @@ module.exports = async function handleMirrorDeploy({ shared, context, deps }) {
         context.outputMode,
         'mirror.deploy.help',
         commandHelpPayload(
-          'pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--sources <url...>] [--validation-ticket <ticket>] [--manifest-file <path>] [--min-close-lead-seconds <n>]',
+          'pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--sources <url...>] [--validation-ticket <ticket>] [--target-timestamp <unix|iso>] [--manifest-file <path>] [--min-close-lead-seconds <n>]',
         ),
       );
     } else {
       console.log(
-        'Usage: pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--sources <url...>] [--validation-ticket <ticket>] [--manifest-file <path>] [--min-close-lead-seconds <n>]',
+        'Usage: pandora [--output table|json] mirror deploy --plan-file <path>|--polymarket-market-id <id>|--polymarket-slug <slug> --dry-run|--execute [--liquidity-usdc <n>] [--fee-tier <500-50000>] [--max-imbalance <n>] [--arbiter <address>] [--category <n>] [--sources <url...>] [--validation-ticket <ticket>] [--target-timestamp <unix|iso>] [--manifest-file <path>] [--min-close-lead-seconds <n>]',
       );
     }
     return;

package/cli/lib/mirror_handlers/plan.cjs

@@ -22,12 +22,12 @@ module.exports = async function handleMirrorPlan({ shared, context, deps }) {
         context.outputMode,
         'mirror.plan.help',
         commandHelpPayload(
-          'pandora [--output table|json] mirror 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>]',
+          'pandora [--output table|json] mirror 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] [--min-close-lead-seconds <n>] [--polymarket-gamma-url <url>]',
         ),
       );
     } else {
       console.log(
-        'Usage: pandora [--output table|json] mirror 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>]',
+        'Usage: pandora [--output table|json] mirror 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] [--min-close-lead-seconds <n>] [--polymarket-gamma-url <url>]',
       );
     }
     return;

package/cli/lib/mirror_service.cjs

@@ -19,6 +19,27 @@ const { round } = require('./shared/utils.cjs');
 const MIRROR_PLAN_SCHEMA_VERSION = '1.0.0';
 const MIRROR_DEPLOY_SCHEMA_VERSION = '1.0.0';
 const MIRROR_BROWSE_SCHEMA_VERSION = '1.0.0';
+const DEFAULT_MIRROR_MIN_CLOSE_LEAD_SECONDS = 3600;
+const MIRROR_SPORT_TIMING_PROFILES = Object.freeze({
+  basketball: Object.freeze({
+    key: 'basketball',
+    expectedDurationMinutes: 150,
+    resolutionBufferMinutes: 30,
+    minimumTradingBufferMinutes: 90,
+  }),
+  soccer: Object.freeze({
+    key: 'soccer',
+    expectedDurationMinutes: 120,
+    resolutionBufferMinutes: 20,
+    minimumTradingBufferMinutes: 30,
+  }),
+  sports: Object.freeze({
+    key: 'sports',
+    expectedDurationMinutes: 150,
+    resolutionBufferMinutes: 30,
+    minimumTradingBufferMinutes: 45,
+  }),
+});
 
 function createServiceError(code, message, details = undefined) {
   const err = new Error(message);
@@ -50,6 +71,150 @@ function normalizeComparableText(value) {
     .trim();
 }
 
+function toUnixSeconds(value) {
+  if (value === null || value === undefined || value === '') return null;
+  const numeric = Number(value);
+  if (Number.isFinite(numeric)) {
+    return numeric > 1e12 ? Math.floor(numeric / 1000) : Math.floor(numeric);
+  }
+  const parsed = Date.parse(String(value));
+  if (Number.isNaN(parsed)) return null;
+  return Math.floor(parsed / 1000);
+}
+
+function formatTimestampIso(value) {
+  const unixSeconds = toUnixSeconds(value);
+  return Number.isFinite(unixSeconds) ? new Date(unixSeconds * 1000).toISOString() : null;
+}
+
+function parseMirrorTargetTimestampInput(value) {
+  if (value === null || value === undefined || value === '') return null;
+  const unixSeconds = toUnixSeconds(value);
+  return Number.isFinite(unixSeconds) && unixSeconds > 0 ? unixSeconds : null;
+}
+
+function collectMirrorTimingTextPool(sourceMarket) {
+  const raw = sourceMarket && sourceMarket.raw && typeof sourceMarket.raw === 'object' ? sourceMarket.raw : {};
+  const tagEntries = []
+    .concat(Array.isArray(raw.tags) ? raw.tags : [])
+    .concat(Array.isArray(raw.tag_ids) ? raw.tag_ids : [])
+    .concat(Array.isArray(raw.tagIds) ? raw.tagIds : []);
+  const tagText = [];
+  for (const entry of tagEntries) {
+    if (entry === null || entry === undefined) continue;
+    if (typeof entry === 'string' || typeof entry === 'number') {
+      tagText.push(String(entry));
+      continue;
+    }
+    if (typeof entry === 'object') {
+      for (const key of ['name', 'slug', 'label', 'title', 'group', 'topic', 'category', 'shortName', 'short_name']) {
+        if (entry[key]) tagText.push(String(entry[key]));
+      }
+    }
+  }
+  return [
+    sourceMarket && sourceMarket.question,
+    sourceMarket && sourceMarket.eventTitle,
+    sourceMarket && sourceMarket.eventSlug,
+    sourceMarket && sourceMarket.slug,
+    raw.sport,
+    raw.sport_type,
+    raw.league,
+    raw.competition,
+    ...tagText,
+  ]
+    .map((value) => normalizeComparableText(value))
+    .filter(Boolean)
+    .join(' ');
+}
+
+function inferMirrorSportTimingProfile(sourceMarket) {
+  const haystack = collectMirrorTimingTextPool(sourceMarket);
+  if (!haystack) return null;
+  if (/\b(nba|basketball)\b/.test(haystack)) {
+    return MIRROR_SPORT_TIMING_PROFILES.basketball;
+  }
+  if (/\b(soccer|football|premier league|epl|uefa|fifa|mls|la liga|serie a|bundesliga|champions league)\b/.test(haystack)) {
+    return MIRROR_SPORT_TIMING_PROFILES.soccer;
+  }
+  if (/\b(sport|sports|nfl|nhl|mlb|tennis|ufc|mma|formula 1|f1|cricket)\b/.test(haystack)) {
+    return MIRROR_SPORT_TIMING_PROFILES.sports;
+  }
+  return null;
+}
+
+function buildMirrorTimingData(sourceMarket, minCloseLeadSecondsInput) {
+  const minCloseLeadSeconds = Number.isFinite(Number(minCloseLeadSecondsInput))
+    ? Math.max(0, Math.trunc(Number(minCloseLeadSecondsInput)))
+    : DEFAULT_MIRROR_MIN_CLOSE_LEAD_SECONDS;
+  const sourceTimestamp = toUnixSeconds(sourceMarket && sourceMarket.closeTimestamp);
+  const eventStartTimestamp = toUnixSeconds(sourceMarket && sourceMarket.eventStartTimestamp) || sourceTimestamp;
+  const sourceCloseTimestamp = toUnixSeconds(sourceMarket && sourceMarket.sourceCloseTimestamp);
+  const timestampSource = String(
+    (sourceMarket && sourceMarket.timestampSource)
+    || (sourceMarket && sourceMarket.eventStartTimestamp ? 'game_start_time' : sourceMarket && sourceMarket.closeTimestamp ? 'source_timestamp' : ''),
+  ).trim() || null;
+  const profile = inferMirrorSportTimingProfile(sourceMarket);
+  const warnings = [];
+  let suggestedTargetTimestamp = sourceTimestamp;
+  let expectedEndTimestamp = null;
+  let tradingCutoffTimestamp = null;
+  let reason = null;
+
+  if (profile && eventStartTimestamp) {
+    expectedEndTimestamp = eventStartTimestamp + (profile.expectedDurationMinutes * 60);
+    const baseSuggestedTargetTimestamp = expectedEndTimestamp + (profile.resolutionBufferMinutes * 60);
+    const minimumTradingCutoffTimestamp = expectedEndTimestamp + (profile.minimumTradingBufferMinutes * 60);
+    suggestedTargetTimestamp = Math.max(baseSuggestedTargetTimestamp, minimumTradingCutoffTimestamp + minCloseLeadSeconds);
+    tradingCutoffTimestamp = suggestedTargetTimestamp - minCloseLeadSeconds;
+
+    if (timestampSource === 'game_start_time') {
+      warnings.push('Polymarket provided game_start_time, which is the event start. Mirror deploy should use a later targetTimestamp that covers event completion and a buffer.');
+    }
+    if (tradingCutoffTimestamp <= expectedEndTimestamp) {
+      warnings.push('With the current close lead, trading would stop before the expected regulation end. Increase targetTimestamp or reduce min-close-lead-seconds.');
+    } else if (tradingCutoffTimestamp < minimumTradingCutoffTimestamp) {
+      warnings.push('With the current close lead, trading would stop too close to the expected finish and may not cover overtime or stoppage time.');
+    }
+
+    reason = `Suggested targetTimestamp uses ${profile.key} timing defaults: expected duration ${profile.expectedDurationMinutes}m, resolution buffer ${profile.resolutionBufferMinutes}m, and trading cutoff buffer ${profile.minimumTradingBufferMinutes}m before the close lead.`;
+  } else {
+    if (timestampSource === 'game_start_time' && sourceTimestamp) {
+      warnings.push('Only a sports start time was available from Polymarket. Review targetTimestamp manually if you deploy this market.');
+    }
+    if (sourceTimestamp) {
+      tradingCutoffTimestamp = sourceTimestamp - minCloseLeadSeconds;
+    }
+  }
+
+  return {
+    sourceTimestamp,
+    sourceTimestampIso: formatTimestampIso(sourceTimestamp),
+    sourceTimestampKind: timestampSource,
+    sourceCloseTimestamp,
+    sourceCloseTimestampIso: formatTimestampIso(sourceCloseTimestamp),
+    eventStartTimestamp,
+    eventStartTimestampIso: formatTimestampIso(eventStartTimestamp),
+    expectedEndTimestamp,
+    expectedEndTimestampIso: formatTimestampIso(expectedEndTimestamp),
+    suggestedTargetTimestamp,
+    suggestedTargetTimestampIso: formatTimestampIso(suggestedTargetTimestamp),
+    tradingCutoffTimestamp,
+    tradingCutoffTimestampIso: formatTimestampIso(tradingCutoffTimestamp),
+    minCloseLeadSeconds,
+    profile: profile
+      ? {
+          sport: profile.key,
+          expectedDurationMinutes: profile.expectedDurationMinutes,
+          resolutionBufferMinutes: profile.resolutionBufferMinutes,
+          minimumTradingBufferMinutes: profile.minimumTradingBufferMinutes,
+        }
+      : null,
+    reason,
+    warnings,
+  };
+}
+
 function hasPandoraBinaryRules(value) {
   const text = String(value || '');
   return /(^|\n)\s*YES\s*:/i.test(text) && /(^|\n)\s*NO\s*:/i.test(text);
@@ -366,6 +531,14 @@ function buildPlanDigest(planData) {
           sourceCount: planData.rules.sourceCount || null,
         }
       : null,
+    timing: planData.timing
+      ? {
+          sourceTimestamp: planData.timing.sourceTimestamp || null,
+          sourceTimestampKind: planData.timing.sourceTimestampKind || null,
+          suggestedTargetTimestamp: planData.timing.suggestedTargetTimestamp || null,
+          minCloseLeadSeconds: planData.timing.minCloseLeadSeconds || null,
+        }
+      : null,
     liquidityRecommendation: planData.liquidityRecommendation,
     distributionHint: planData.distributionHint,
   }));
@@ -412,6 +585,12 @@ async function buildMirrorPlan(options = {}) {
 
   const distribution = computeDistributionHint(sourceYesProbability === null ? 0.5 : sourceYesProbability);
   const rules = buildRuleTemplate(sourceMarket);
+  const timing = buildMirrorTimingData(
+    sourceMarket,
+    Number.isFinite(Number(options.minCloseLeadSeconds))
+      ? Number(options.minCloseLeadSeconds)
+      : DEFAULT_MIRROR_MIN_CLOSE_LEAD_SECONDS,
+  );
 
   let match = { best: null, diagnostics: [] };
   try {
@@ -440,6 +619,8 @@ async function buildMirrorPlan(options = {}) {
   for (const item of distribution.diagnostics || []) diagnostics.push(item);
   for (const item of rules.diagnostics || []) diagnostics.push(item);
   for (const item of match.diagnostics || []) diagnostics.push(item);
+  for (const item of timing.warnings || []) diagnostics.push(item);
+  if (timing.reason) diagnostics.push(timing.reason);
 
   const topMatch = match.best
     ? {
@@ -464,6 +645,9 @@ async function buildMirrorPlan(options = {}) {
       question: sourceMarket.question,
       description: options.withRules ? sourceMarket.description : undefined,
       closeTimestamp: sourceMarket.closeTimestamp,
+      eventStartTimestamp: sourceMarket.eventStartTimestamp || null,
+      sourceCloseTimestamp: sourceMarket.sourceCloseTimestamp || null,
+      timestampSource: sourceMarket.timestampSource || null,
       yesPct: sourceMarket.yesPct,
       noPct: sourceMarket.noPct,
       volume24hUsd: round(sourceMarket.volume24hUsd, 6),
@@ -481,6 +665,7 @@ async function buildMirrorPlan(options = {}) {
       proposedPandoraRules: rules.rulesText,
       sourceCount: normalizeSources(options.sources).length,
     },
+    timing,
     similarity: topMatch ? topMatch.similarity : null,
     sizingInputs: {
       V24: round(sourceMarket.volume24hUsd, 6),
@@ -545,7 +730,25 @@ async function deployMirror(options = {}) {
 
   const diagnostics = [];
   const question = String(planData.sourceMarket && planData.sourceMarket.question ? planData.sourceMarket.question : '').trim();
-  const targetTimestamp = Number(planData.sourceMarket && planData.sourceMarket.closeTimestamp);
+  const minCloseLeadSeconds = Number.isFinite(Number(options.minCloseLeadSeconds))
+    ? Number(options.minCloseLeadSeconds)
+    : Number(planData.timing && planData.timing.minCloseLeadSeconds);
+  const effectiveTiming = planData.timing && typeof planData.timing === 'object'
+    ? {
+        ...planData.timing,
+        ...(Number.isFinite(Number(minCloseLeadSeconds))
+          ? { minCloseLeadSeconds: Number(minCloseLeadSeconds) }
+          : {}),
+      }
+    : buildMirrorTimingData(planData.sourceMarket || {}, minCloseLeadSeconds);
+  const suggestedTargetTimestamp = parseMirrorTargetTimestampInput(
+    effectiveTiming && effectiveTiming.suggestedTargetTimestamp,
+  );
+  const fallbackTargetTimestamp = parseMirrorTargetTimestampInput(
+    planData.sourceMarket && planData.sourceMarket.closeTimestamp,
+  );
+  const explicitTargetTimestamp = parseMirrorTargetTimestampInput(options.targetTimestamp);
+  const targetTimestamp = explicitTargetTimestamp || suggestedTargetTimestamp || fallbackTargetTimestamp;
   const refreshedRuleTemplate = buildRuleTemplate({
     ...(planData.sourceMarket || {}),
     description:
@@ -569,6 +772,17 @@ async function deployMirror(options = {}) {
     suggestedRules: refreshedRuleTemplate.rulesText,
   });
   diagnostics.push(...refreshedRuleTemplate.diagnostics);
+  if (explicitTargetTimestamp && suggestedTargetTimestamp && explicitTargetTimestamp < suggestedTargetTimestamp) {
+    diagnostics.push(
+      `Explicit --target-timestamp (${explicitTargetTimestamp}) is earlier than the suggested sports-safe target (${suggestedTargetTimestamp}). Trading may close before overtime or late completion.`,
+    );
+  } else if (!explicitTargetTimestamp && suggestedTargetTimestamp && suggestedTargetTimestamp !== fallbackTargetTimestamp) {
+    diagnostics.push(
+      `Using suggested targetTimestamp ${suggestedTargetTimestamp} instead of raw source timestamp ${fallbackTargetTimestamp}.`,
+    );
+  }
+  diagnostics.push(...(Array.isArray(effectiveTiming && effectiveTiming.warnings) ? effectiveTiming.warnings : []));
+  if (effectiveTiming && effectiveTiming.reason) diagnostics.push(effectiveTiming.reason);
 
   const liquidityUsdc =
     options.liquidityUsdc !== null && options.liquidityUsdc !== undefined
@@ -608,9 +822,9 @@ async function deployMirror(options = {}) {
       rules: sourceRulesText,
       sources,
       targetTimestamp,
-      minCloseLeadSeconds: Number.isFinite(Number(options.minCloseLeadSeconds))
-        ? Number(options.minCloseLeadSeconds)
-        : 3600,
+      minCloseLeadSeconds: Number.isFinite(Number(minCloseLeadSeconds))
+        ? Number(minCloseLeadSeconds)
+        : DEFAULT_MIRROR_MIN_CLOSE_LEAD_SECONDS,
       liquidityUsdc,
       distributionYes,
       distributionNo,
@@ -696,6 +910,12 @@ async function deployMirror(options = {}) {
     generatedAt: new Date().toISOString(),
     planDigest: planData.planDigest || buildPlanDigest(planData),
     deploymentArgs: deployPayload.deploymentArgs,
+    timing: {
+      ...(effectiveTiming || {}),
+      selectedTargetTimestamp: targetTimestamp,
+      selectedTargetTimestampIso: formatTimestampIso(targetTimestamp),
+      overrideApplied: Boolean(explicitTargetTimestamp),
+    },
     dryRun: deployPayload.mode === 'dry-run',
     requiredValidation: deployPayload.requiredValidation || validationGate.requiredValidation || null,
     agentValidation: deployPayload.agentValidation || validationGate.agentValidation || null,

package/cli/lib/parsers/mirror_deploy_flags.cjs

@@ -1,5 +1,5 @@
 const { MIN_AMM_FEE_TIER, MAX_AMM_FEE_TIER } = require('../shared/constants.cjs');
-const { normalizeMirrorPathForMcp, validateMirrorUrl } = require('./mirror_parser_guard.cjs');
+const { normalizeMirrorPathForMcp, parseMirrorTargetTimestamp, validateMirrorUrl } = require('./mirror_parser_guard.cjs');
 
 const MAX_UINT24 = 16_777_215;
 const DISTRIBUTION_SCALE = 1_000_000_000;
@@ -122,6 +122,7 @@ function createParseMirrorDeployFlags(deps) {
       distributionNoPct: null,
       rules: null,
       validationTicket: null,
+      targetTimestamp: null,
       polymarketHost: null,
       polymarketGammaUrl: null,
       polymarketGammaMockUrl: null,
@@ -258,6 +259,15 @@ function createParseMirrorDeployFlags(deps) {
         i += 1;
         continue;
       }
+      if (token === '--target-timestamp') {
+        options.targetTimestamp = parseMirrorTargetTimestamp(
+          requireFlagValue(args, i, '--target-timestamp'),
+          '--target-timestamp',
+          CliError,
+        );
+        i += 1;
+        continue;
+      }
       if (token === '--distribution-yes') {
         options.distributionYes = parseDistributionUnits(
           requireFlagValue(args, i, '--distribution-yes'),

package/cli/lib/parsers/mirror_go_flags.cjs

@@ -1,5 +1,5 @@
 const { MIN_AMM_FEE_TIER, MAX_AMM_FEE_TIER } = require('../shared/constants.cjs');
-const { normalizeMirrorPathForMcp, validateMirrorUrl } = require('./mirror_parser_guard.cjs');
+const { normalizeMirrorPathForMcp, parseMirrorTargetTimestamp, validateMirrorUrl } = require('./mirror_parser_guard.cjs');
 
 const MAX_UINT24 = 16_777_215;
 const DISTRIBUTION_SCALE = 1_000_000_000;
@@ -135,6 +135,7 @@ function createParseMirrorGoFlags(deps) {
       sources: [],
       sourcesProvided: false,
       validationTicket: null,
+      targetTimestamp: null,
       manifestFile: null,
       trustDeploy: false,
       forceGate: false,
@@ -380,6 +381,15 @@ function createParseMirrorGoFlags(deps) {
         i += 1;
         continue;
       }
+      if (token === '--target-timestamp') {
+        options.targetTimestamp = parseMirrorTargetTimestamp(
+          requireFlagValue(args, i, '--target-timestamp'),
+          '--target-timestamp',
+          CliError,
+        );
+        i += 1;
+        continue;
+      }
       if (token === '--manifest-file') {
         options.manifestFile = normalizeMirrorPathForMcp(
           requireFlagValue(args, i, '--manifest-file'),

package/cli/lib/parsers/mirror_parser_guard.cjs

@@ -34,8 +34,25 @@ function validateMirrorUrl(rawValue, flagName, CliError, isSecureHttpUrlOrLocal)
   return value;
 }
 
+function parseMirrorTargetTimestamp(rawValue, flagName, CliError) {
+  const value = String(rawValue || '').trim();
+  const numeric = Number(value);
+  if (Number.isFinite(numeric) && numeric > 0) {
+    return Math.trunc(numeric > 1e12 ? numeric / 1000 : numeric);
+  }
+  const parsed = Date.parse(value);
+  if (!Number.isNaN(parsed)) {
+    return Math.floor(parsed / 1000);
+  }
+  throw new CliError(
+    'INVALID_FLAG_VALUE',
+    `${flagName} must be a unix timestamp in seconds (or milliseconds) or an ISO date/time string.`,
+  );
+}
+
 module.exports = {
   normalizeMirrorPathForMcp,
   defaultMirrorWorkspacePath,
+  parseMirrorTargetTimestamp,
   validateMirrorUrl,
 };

package/cli/lib/parsers/mirror_plan_flags.cjs

@@ -34,6 +34,7 @@ function createParseMirrorPlanFlags(deps) {
       maxLiquidityUsdc: 50_000,
       withRules: false,
       includeSimilarity: false,
+      minCloseLeadSeconds: 3600,
       polymarketHost: null,
       polymarketGammaUrl: null,
       polymarketGammaMockUrl: null,
@@ -111,6 +112,14 @@ function createParseMirrorPlanFlags(deps) {
         options.includeSimilarity = true;
         continue;
       }
+      if (token === '--min-close-lead-seconds') {
+        options.minCloseLeadSeconds = parsePositiveInteger(
+          requireFlagValue(args, i, '--min-close-lead-seconds'),
+          '--min-close-lead-seconds',
+        );
+        i += 1;
+        continue;
+      }
       if (token === '--polymarket-host') {
         options.polymarketHost = validateMirrorUrl(
           requireFlagValue(args, i, '--polymarket-host'),

package/cli/lib/polymarket_adapter.cjs

@@ -14,17 +14,18 @@ function toTimestampSeconds(value) {
   return Math.floor(parsed / 1000);
 }
 
-function resolvePolymarketTimestampValue(row) {
+function resolvePolymarketEventStartValue(row) {
+  if (!row || typeof row !== 'object') return null;
+  return row.game_start_time || row.gameStartTime || null;
+}
+
+function resolvePolymarketCloseFallbackValue(row) {
   if (!row || typeof row !== 'object') return null;
-  return (
-    row.game_start_time ||
-    row.gameStartTime ||
-    row.endDateIso ||
-    row.end_date_iso ||
-    row.endDate ||
-    row.closedTime ||
-    null
-  );
+  return row.endDateIso || row.end_date_iso || row.endDate || row.closedTime || null;
+}
+
+function resolvePolymarketTimestampValue(row) {
+  return resolvePolymarketEventStartValue(row) || resolvePolymarketCloseFallbackValue(row);
 }
 
 function normalizeTokens(tokens) {
@@ -105,12 +106,17 @@ function mapGammaRow(row) {
   const marketId = row && (row.conditionId || row.condition_id || row.id || row.questionID) ? String(
     row.conditionId || row.condition_id || row.id || row.questionID,
   ) : null;
+  const eventStartTimestamp = toTimestampSeconds(resolvePolymarketEventStartValue(row));
+  const sourceCloseTimestamp = toTimestampSeconds(resolvePolymarketCloseFallbackValue(row));
   const closeTimestamp = toTimestampSeconds(resolvePolymarketTimestampValue(row));
   return {
     legId: `polymarket:${String(marketId || '')}`,
     venue: 'polymarket',
     marketId,
     question: row && (row.question || row.title || row.description) ? String(row.question || row.title || row.description) : null,
+    eventStartTimestamp,
+    sourceCloseTimestamp,
+    timestampSource: eventStartTimestamp ? 'game_start_time' : sourceCloseTimestamp ? 'end_date_iso' : null,
     closeTimestamp,
     yesPct: mapped.yes,
     noPct: mapped.no,
@@ -129,11 +135,16 @@ function mapPolymarketRow(row) {
   const mapped = normalizeTokens(row.tokens || []);
   const question = row.question || row.description || null;
   const marketId = row.condition_id || row.question_id || null;
+  const eventStartTimestamp = toTimestampSeconds(resolvePolymarketEventStartValue(row));
+  const sourceCloseTimestamp = toTimestampSeconds(resolvePolymarketCloseFallbackValue(row));
   return {
     legId: `polymarket:${String(marketId || '')}`,
     venue: 'polymarket',
     marketId,
     question,
+    eventStartTimestamp,
+    sourceCloseTimestamp,
+    timestampSource: eventStartTimestamp ? 'game_start_time' : sourceCloseTimestamp ? 'end_date_iso' : null,
     closeTimestamp: toTimestampSeconds(resolvePolymarketTimestampValue(row)),
     yesPct: mapped.yes,
     noPct: mapped.no,

package/cli/lib/polymarket_trade_adapter.cjs

@@ -49,11 +49,14 @@ function toTimestampSeconds(value) {
   return numeric > 1e12 ? Math.floor(numeric / 1000) : Math.floor(numeric);
 }
 
-function resolvePolymarketEventTimestamp(row) {
+function resolvePolymarketEventStartTimestampValue(row) {
+  if (!row || typeof row !== 'object') return null;
+  return row.game_start_time || row.gameStartTime || null;
+}
+
+function resolvePolymarketCloseFallbackValue(row) {
   if (!row || typeof row !== 'object') return null;
   return (
-    row.game_start_time ||
-    row.gameStartTime ||
     row.end_date_iso ||
     row.endDateIso ||
     row.endDate ||
@@ -64,6 +67,10 @@ function resolvePolymarketEventTimestamp(row) {
   );
 }
 
+function resolvePolymarketEventTimestamp(row) {
+  return resolvePolymarketEventStartTimestampValue(row) || resolvePolymarketCloseFallbackValue(row);
+}
+
 function normalizeHostList(hostInput) {
   const rawValues = Array.isArray(hostInput) ? hostInput : String(hostInput || '').split(',');
   const hosts = rawValues
@@ -424,6 +431,13 @@ function normalizeMarketRow(row) {
     eventSlug: toStringOrNull(row && (row.event_slug || row.eventSlug)),
     eventTitle: toStringOrNull(row && (row.event_title || row.eventTitle)),
     description: rulesSections.length ? rulesSections.join('\n\n') : null,
+    eventStartTimestamp: toTimestampSeconds(resolvePolymarketEventStartTimestampValue(row)),
+    sourceCloseTimestamp: toTimestampSeconds(resolvePolymarketCloseFallbackValue(row)),
+    timestampSource: resolvePolymarketEventStartTimestampValue(row)
+      ? 'game_start_time'
+      : resolvePolymarketCloseFallbackValue(row)
+        ? 'end_date_iso'
+        : null,
     closeTimestamp: toTimestampSeconds(resolvePolymarketEventTimestamp(row)),
     yesPct: tokens.yes,
     noPct: tokens.no,

package/cli/lib/schema_command_service.cjs

@@ -795,6 +795,7 @@ function buildSchemaPayload() {
         type: 'object',
         properties: {
           sourceMarket: { type: 'object' },
+          timing: { type: 'object' },
           liquidityRecommendation: { type: 'object' },
           distributionHint: { type: 'object' },
           rules: { type: 'object' },
@@ -808,6 +809,7 @@ function buildSchemaPayload() {
           mode: { enum: ['dry-run', 'execute'] },
           planDigest: { type: ['string', 'null'] },
           deploymentArgs: { type: ['object', 'null'] },
+          timing: { type: ['object', 'null'] },
           dryRun: { type: ['boolean', 'null'] },
           requiredValidation: { type: ['object', 'null'] },
           agentValidation: { type: ['object', 'null'] },

package/cli/pandora.cjs

@@ -2195,6 +2195,7 @@ function renderAutopilotTable(data) {
 }
 
 function renderMirrorPlanTable(data) {
+  const timing = data.timing || {};
   printTable(
     ['Field', 'Value'],
     [
@@ -2202,6 +2203,10 @@ function renderMirrorPlanTable(data) {
       ['sourceMarketId', data.sourceMarket ? data.sourceMarket.marketId : ''],
       ['sourceSlug', data.sourceMarket ? data.sourceMarket.slug || '' : ''],
       ['sourceYesPct', data.sourceMarket && data.sourceMarket.yesPct !== null ? data.sourceMarket.yesPct : ''],
+      ['sourceTimestampKind', timing.sourceTimestampKind || (data.sourceMarket ? data.sourceMarket.timestampSource || '' : '')],
+      ['eventStartAt', timing.eventStartTimestampIso || ''],
+      ['suggestedTargetAt', timing.suggestedTargetTimestampIso || ''],
+      ['tradingCutoffAt', timing.tradingCutoffTimestampIso || ''],
       ['recommendedLiquidityUsdc', data.liquidityRecommendation ? data.liquidityRecommendation.liquidityUsdc : ''],
       ['distributionYes', data.distributionHint ? data.distributionHint.distributionYes : ''],
       ['distributionNo', data.distributionHint ? data.distributionHint.distributionNo : ''],
@@ -2369,6 +2374,8 @@ function renderMirrorDeployTable(data) {
       ['pollTxHash', data.tx && data.tx.pollTxHash ? data.tx.pollTxHash : ''],
       ['approveTxHash', data.tx && data.tx.approveTxHash ? data.tx.approveTxHash : ''],
       ['marketTxHash', data.tx && data.tx.marketTxHash ? data.tx.marketTxHash : ''],
+      ['targetTimestamp', data.timing && data.timing.selectedTargetTimestampIso ? data.timing.selectedTargetTimestampIso : ''],
+      ['tradingCutoffAt', data.timing && data.timing.tradingCutoffTimestampIso ? data.timing.tradingCutoffTimestampIso : ''],
       ['seedOddsMatch', data.postDeployChecks && data.postDeployChecks.seedOddsMatch !== null ? (data.postDeployChecks.seedOddsMatch ? 'yes' : 'no') : ''],
       ['seedDiffPct', data.postDeployChecks && data.postDeployChecks.diffPct !== null ? data.postDeployChecks.diffPct : ''],
       ['blockedLiveSync', data.postDeployChecks && data.postDeployChecks.blockedLiveSync ? 'yes' : 'no'],

package/package.json

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