The build log

What broke A documentation audit found the position-manager README claiming the service does market-only execution and has no reconciliation. Both claims are false — it has limit entry and a reconcile worker. The docs had drifted behind the code, which is how you end up confidently telling people wrong things about your own system.

The fix Treat docs drift like a bug class, not an accident: the public description of the system now comes from one audited source of truth, and README claims get checked against the code before they're repeated anywhere — including on this site.

What broke The position-manager suite has 35 failures with one root cause: constructing the Hyperliquid exchange adapter fetches live metadata from the real API — inside unit tests. Works on a good network day, flakes on CI, and couples test results to someone else's uptime.

The fix (in progress) The same seam pattern that already works in the carry-signal service: route the network call through one injectable function, stub it in tests, and let CI run fully offline. Boring, proven, and it makes the suite deterministic again.