sdk: round-3 CLI follow-ups — expiry parity, fetchCollection BigIntify fix, simulate/preview coverage (#0428-#0430)

[trevormil]

Summary

Stacked on #242 (base feat/0422-0427-cli-followups-r2). Round-3 of the rolling CLI audit (same angles: FE-parity, producer-correctness, DRY, test-bar).

• #0428 listing / intent / pm-sell-intent / pm-buy-intent build builders still used duration-only durationToTimestamp — the #0424 bid fix missed them. Swapped to resolveExpiration: ms-since-epoch --expiration now accepted (parity with bb nfts list / bb intents create / bb prediction-markets). pm-sell/buy-intent default 7d→24h to match the end-user verbs' default (was a silent on-chain divergence). build.ts help strings corrected.
• #0429 New cli/utils/collection-options.ts. normalizeCollection is now the single boundary-normalization point: 5 command copies BigIntify-converted the indexer response, 4 (credit-tokens, pay-requests, bounties, prediction-markets) silently did not and handed string-typed amounts to bigint-comparing validators — a latent boundary bug, now fixed for all 9. validateCollectionOrExit dedups the 7 byte-identical result-variant validateOrExit blocks. The 2 bespoke boolean-protocol variants (subscriptions, credit-tokens) left as-is (no-churn).
• #0430 simulate.ts + preview.ts had zero spec coverage anywhere. ensureTxWrapper exported + unit-tested (messages passthrough / bare-Msg wrap / non-object passthrough); command-shape specs guard flag/arg drift.

Scope notes

• 0429: per-file fetchCollection wrappers kept (they bind the file's local callApi); only the duplicated logic (unwrap + BigIntify + the bug) is single-sourced — extracting the wrapper would force a ~50-call-site signature churn for no correctness gain (0423/0418 no-churn precedent). The 2-site bespoke boolean validateOrExit left (below the dedup bar, divergent messages).
• 0430: unit specs follow the project convention (command-shape + pure-helper; network paths are integration territory).

Validation

• Build clean — tsc ×2, no circular dependencies.
• Unit: 142 suites / 3092 tests green (+2 suites, +15 tests).
• Integration: 20 suites / 186 tests green (incl. the 4 newly-normalized standards).

Test plan

• bun run build clean
• bun run test:unit / test:integration green
• bb build pm-sell-intent … default expiry ≈ 24h (not 7d)
• bb build listing … --expiration 1798765432000 accepted (ms-since-epoch)

🤖 Generated with Claude Code

Stacked PRs: #242 → this.