100: Add Perps collateral, leverage, value, uPnL and gross-exposure totals in EMC

openspec/changes/hide-empty-perps-venues/.openspec.yaml

@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-10-24

openspec/changes/hide-empty-perps-venues/design.md

@@ -0,0 +1,22 @@
+# Design
+
+## Context
+
+See proposal.md. Venue snapshots include successful-empty, not-yet-read and failed scopes. Cross accounts hold capital independently of positions, so position count alone cannot determine visibility.
+
+## Goals / Non-Goals
+
+**Goals:** Remove childless headings while preserving capital totals and failure visibility.
+
+**Non-Goals:** Changing integration reads, snapshot data, wallet visibility or refresh scheduling.
+
+## Decisions
+
+- Skip a venue during tree reconciliation only when both its positions and Cross-account lists are empty. Filtering the service snapshot instead would lose unknown scopes and could produce misleading totals.
+- Include childless venues' read status in wallet tooltip notes so hiding their headings does not hide the reason for unavailable totals. Keep the existing venue tooltips when rows exist.
+- Reconcile surviving items with the existing IDs; a venue returning after removal is a new expanded group. Its wallet and other venue rows remain retained.
+
+## Risks / Trade-offs
+
+- Hidden failed/initial reads can resemble a successfully empty portfolio → preserve unavailable totals and expose the exact status on the wallet row.
+- A Phoenix account may have capital without positions → treat the Cross account itself as a child.

openspec/changes/hide-empty-perps-venues/proposal.md

@@ -0,0 +1,26 @@
+# Proposal
+
+## Why
+
+Empty Jupiter and Phoenix headings add clutter to Evelyn's Perps capital/risk overview. The owner wants a venue shown only when it has something beneath it.
+
+## What Changes
+
+- Hide venue rows with neither isolated positions nor Cross accounts; show them again when data supplies children.
+- Retain Phoenix groups containing funded Cross accounts without open positions.
+- Keep hidden scopes in the service snapshot and totals; expose their read status through wallet tooltips.
+- Replace documentation that says empty venue headings remain visible.
+
+## Capabilities
+
+### New Capabilities
+
+None.
+
+### Modified Capabilities
+
+- `evelyn-perps-overview`: Suppress childless venues without discarding valuation or read-status information.
+
+## Impact
+
+Local `.tjava` presentation code, the overview specification, and relevant project/shared documentation only. No integration, refresh, wallet configuration, signing or trading changes. No commits, pushes or live Hub restart.

openspec/changes/hide-empty-perps-venues/specs/evelyn-perps-overview/spec.md

@@ -0,0 +1,23 @@
+## ADDED Requirements
+
+### Requirement: Venue visibility follows available child rows
+EMC SHALL hide venue rows with neither positions nor Cross accounts and show them when children reappear. Funded empty Cross accounts SHALL keep their venue visible. Hidden venues SHALL remain in snapshots and totals, with read status available in wallet tooltips. Unknown scopes SHALL NOT become zero totals; failed reads SHALL preserve last-success totals. Wallet rows and the root SHALL remain visible.
+
+#### Scenario: Empty venue
+- **WHEN** Jupiter or Phoenix has no positions and no Cross accounts
+- **THEN** its heading is absent from that wallet's displayed children
+- **AND** a successful empty scope still contributes zero to totals
+
+#### Scenario: Funded Cross account without positions
+- **WHEN** Phoenix returns a Cross account with capital but no open positions
+- **THEN** Phoenix and its Cross account remain visible with that capital counted once
+
+#### Scenario: Positions disappear and return
+- **WHEN** a venue loses its last child and later returns a position
+- **THEN** its heading disappears and reappears with the correct child
+- **AND** unrelated retained rows keep their selection and expansion state
+
+#### Scenario: Hidden scope has not been read successfully
+- **WHEN** a childless venue has never been read successfully and its first read is pending or failed
+- **THEN** the heading is hidden and its read status is available on the wallet tooltip
+- **AND** required totals remain unavailable rather than reporting zero

openspec/changes/hide-empty-perps-venues/tasks.md

@@ -0,0 +1,11 @@
+# Tasks
+
+## 1. Presentation and documentation
+
+- [x] 1.1 Filter childless venues and retain their wallet-level read status; verify empty, funded Cross, unknown/failed and returning-position cases in the standalone preview while preserving unrelated tree state.
+- [x] 1.2 Update the overview specification and relevant project/shared documentation; verify obsolete visible-empty-group claims are removed and links remain valid.
+
+## 2. Integrated verification
+
+- [x] 2.1 Run the normal Gradle build and strict validation for the change and affected spec; record the preview/build results.
+- [x] 2.2 Inspect the final diffs and confirm existing unrelated changes, integration behavior and the no-commit/no-push constraint are preserved.

openspec/changes/hide-empty-perps-venues/verification.md

@@ -0,0 +1,24 @@
+# Verification
+
+Verified locally on 24 October 2026. No commits, pushes or live Hub restart.
+
+- Normal `JAVA_HOME=/usr/local/software/java/jfx-25 ./gradlew build` passed:
+  42 existing tests, zero failures.
+- Strict OpenSpec validation passed for this change and `evelyn-perps-overview`;
+  the added requirement is synchronized into the main specification.
+- Reused the temporary standalone JavaFX preview outside application sources.
+  Checked both empty venues hidden with wallet retained; pending/failed hidden
+  scopes still unavailable in totals with wallet-level status; funded empty
+  Cross account keeping Phoenix visible; Jupiter appearing, disappearing and
+  returning; unrelated Phoenix item identity, selection and collapse retained;
+  a previously successful empty read still contributing zero after a failure.
+- Existing preview checks for eight columns, formatting and tree reconciliation
+  also passed. Screenshots are under `/tmp/issue100-check/hide-empty-venues/`;
+  the TEST and controlled-case views were visually inspected. The preview reused
+  prior read-only snapshots, with no new exchange reads or application sample data.
+- Updated `docs/Evelyn.md`, `docs/PhoenixPerps.md` and the canonical shared
+  `r35157_docs/projects/evelyn/README.md`, replacing obsolete claims about visible
+  empty groups and their error/loading indicators. Local links and diff checks passed.
+- The source change is confined to `PerpsTab.tjava`; snapshots, integrations,
+  totals and refresh timing are unchanged. Existing unrelated staged/deleted
+  OpenSpec artifacts were left untouched.