# 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.