State 007 Learning Guide

Position In Learning Graph

• Previous state(s): 006-observability-lgtm-compose
• Dotted-line parent(s): none
• Next state(s): 008-order-management-matcher

Convergence Metadata

• Convergence state: no
• Convergence level: none
• Lineage role: canonical
• Nearest previous convergence: none
• Nearest next convergence: none

Rendered Code

• Generated branch: code/generated-state-007-pricing-awareness-market-data
• Authoring branch (spec source): feature/agentic-renovation

Code Comparison With Previous State

• Compare against 006-observability-lgtm-compose: code/generated-state-006-observability-lgtm-compose...code/generated-state-007-pricing-awareness-market-data

Plain-English Code Delta

• Added: Trade execution pricing (trade.price) with 3-decimal precision.
• Added: Position pre-aggregated volume-weighted average cost basis (position.averageCostBasis).
• Added: Market price stream topics (pricing.<TICKER>) from a new price-publisher component.
• Added: Startup-assigned per-ticker volatility band profile for synthetic pricing bounds (20% @ ±4%, 60% @ ±2%, 20% strict open/close).
• Added: UI valuation fields: market price, position value, unrealized P&L, portfolio totals.
• Added: Position blotter OPEN column and directional market marker (▲/▼/■) against open price.
• Added: Conditional valuation highlighting in position blotter for market-price/open and value-vs-cost comparisons.
• Added: Trade ticket selected-security live price stream subscription from pricing.<TICKER>.

Run This State

./scripts/start-state-007-pricing-awareness-market-data-generated.sh

Canonical Spec Links

• State spec pack: /specs/pricing-awareness-market-data
• Architecture: /specs/pricing-awareness-market-data/system/architecture
• Flows / topology: /specs/pricing-awareness-market-data/system/runtime-topology
• Research: link
• Data model: link
• Quickstart: link