Document v0.5.0 trader milestone

CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## v0.5.0
+- Grid trader is now stable enough for real use.
+- Orders place, replace, recenter, and resize as expected.
+- Shared execution uses real fees for sizing.
+- Dashboard and live strategy state are aligned with the running strategy flow.
+- MCP surface remains compact while the runtime behaviour is much more complete.
+
+## v0.4.x
+- Earlier experimental trader/dashboard iterations.
+- Strategy and execution plumbing were still being hardened.

PROJECT.md

@@ -21,6 +21,16 @@ Trading helpers, strategy control, and a small MCP surface. Keep app logic isola
 - `update_strategy()` updates config/state and reconciles.
 - `control_strategy()` handles `start`, `pause`, `resume`, `stop`, and `reconcile`.
 
+## Upgrade plans
+
+The next phase should focus on making trader easier to operate, not just more capable:
+
+- standardize a shared config vocabulary across strategies
+- streamline how strategies appear in the dashboard and how they are configured
+- add more render widgets where they improve clarity, such as candle and line charts
+- keep the debug log useful, but visually lighter when possible
+- extend the strategy set only once the shared config and display model are clean
+
 ## Routes
 - `GET /` minimal landing page
 - `GET /health` liveness

README.md

@@ -1,7 +1,28 @@
-# Trader MCP
+# Trader MCP v0.5.0
 
 MCP server for trading-related helper functions, with a dashboard for accounts and strategies.
 
+## Release notes
+
+This release marks the point where the stack is genuinely usable:
+
+- grid trader places, replaces, recenters, and resizes orders as expected
+- strategy execution is stable enough to run continuously
+- shared execution now uses real fees for sizing
+- strategy state and dashboard behaviour are aligned with live trading flow
+- the public MCP surface stays compact while the runtime behaviour is much more complete
+
+## What works now
+
+- grid trading with live order placement and reconciliation
+- observe, pause, resume, stop, and reconcile control actions
+- live render panels and inline strategy config editing
+- account overview in the dashboard, kept intentionally out of the way
+
+## Next ideas
+
+Further improvements may include more strategies, a cleaner shared config schema, and extra render widgets such as candles or line graphs. These are useful follow-ups, but they are not blockers for the current release.
+
 ## Current MCP tools
 - `list_strategies`
 - `get_strategy`