1.9 KiB
1.9 KiB
Proposal
Why
The owner cannot assess Evelyn's committed capital and risk from direction and size alone. Issue #100 adds a first inspectable, read-only valuation overview for existing wallets, directly supporting safe Evelyn operation.
What Changes
- Show Position, Direction, Margin, Collateral, Leverage, Exposure, Value and uPnL beneath a visible Perpetual Contracts root.
- BREAKING: Extend snapshot and Phoenix result record contracts to represent shared Cross accounts separately from isolated positions, retaining funded empty Cross accounts.
- Publish precise venue valuations and complete gross exposure, dollar uPnL and closing-value totals without counting shared capital twice. Unsupported metrics remain explicitly unavailable.
- Add an overview-only Jupiter REST reader; preserve the existing trading, signing, alarm and entry-price integration.
- Preserve background refresh timing, independent last-success retention, immutable snapshots and stable UI reconciliation; explain retained or incomplete data.
Capabilities
New Capabilities
jupiter-perps-overview: Validated read-only Jupiter position metrics, independent of transaction operations.
Modified Capabilities
evelyn-perps-service: Account-aware immutable metrics and complete, field-specific aggregation with independent refresh status.evelyn-perps-overview: Eight columns, Cross hierarchy, totals, formatting and definitions.phoenix-perps-service: Shared balances, exact price PnL, initial margin and account closing-value estimates.
Impact
Changes are limited to .tjava integration/service/presentation code, passive Hub wiring, OpenSpec and applicable project/shared documentation. No new dependencies, configuration system, trading operations, live Hub restart, commits or pushes. Verification uses the normal build and temporary focused/read-only JavaFX harnesses.