@hedge-layer/cli 1.8.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -56,10 +56,10 @@ hl brief "US China trade war tariffs"
56
56
  # 4. Or start an interactive research session
57
57
  hl research
58
58
 
59
- # 5. Run the persisted liquidity-provider loop
60
- hl lp scan "liquidity opportunities"
61
- hl lp recommend --scan-id <scan-id>
62
- hl lp evaluate
59
+ # 5. Run the manual liquidity-provider flow
60
+ hl --json feed liquidity-provider --limit 15 | jq '{ markets: .markets }' > markets.json
61
+ hl lp allocator --markets markets.json
62
+ hl-trader buy
63
63
 
64
64
  # 6. Check linked wallet funds
65
65
  hl wallet balances
@@ -77,11 +77,30 @@ Liquidity-provider workflows are available under `hl lp`:
77
77
 
78
78
  ```bash
79
79
  hl lp scan "liquidity opportunities" # persist candidate evidence
80
+ hl lp allocator --markets markets.json # run allocator agent on an explicit list
80
81
  hl lp recommend --scan-id <scan-id> # recommend allocate/reduce/exit actions
81
82
  hl lp evaluate # summarize PnL lessons
82
- hl lp run # run the dry-run chain
83
83
  ```
84
84
 
85
+ The lightweight manual loop is:
86
+
87
+ ```bash
88
+ hl --json feed lp-opportunity --limit 15 > markets.json
89
+ hl-trader pnl --json > pnl.json # optional: wallet PnL + live inventory
90
+ hl lp allocator --markets markets.json --pnl pnl.json --allocations pnl.json
91
+ hl-trader buy ...
92
+ ```
93
+
94
+ `hl lp allocator` submits the candidate market list through the web API to the
95
+ allocator agent. Allocator output shows target capital, quote regime, failed
96
+ safety checks, and split spread/reward economics. Trade execution stays outside
97
+ the `hl` allocator command.
98
+
99
+ `--allocations` tells the allocator what you already hold (enabling HOLD,
100
+ REDUCE, and EXIT decisions), and `--pnl` feeds per-market PnL into its caution
101
+ overlay so borderline allocations on losing markets are downgraded to WATCH or
102
+ HOLD. Both flags accept the `hl-trader pnl --json` output file directly.
103
+
85
104
  Wallet commands are available under `hl wallet`:
86
105
 
87
106
  ```bash