Trader-MCP compatibility note

This note is for Hermes-MCP developers.

Trader taxonomy expected by Hermes

Canonical strategy set currently used by Hermes supervision:

grid_trader
trend_follower
exposure_protector

Trader contract locations

Primary contract and runtime docs live in trader-mcp/:

trader-mcp/Hermes_Trader_Contract_v0.1.md
trader-mcp/Hermes_Trader_Action_Contract_v0.1.md
trader-mcp/Strategy_Contract.md
trader-mcp/Strategy_Runtime.md
trader-mcp/MCP_SURFACE_PROPOSAL.md
trader-mcp/TODO.md

Hermes-facing data

Hermes should read strategy snapshots via report(). Important fields:

identity
control
fit
supervision
position
state
assessment
execution

Hermes control path

Hermes should write through one canonical Trader tool:

apply_control_decision(payload)

Trader may still use these internally or for operator workflows:

control_strategy()
set_strategy_policy()

The current supervision hints used by Hermes include:

inventory_pressure
switch_readiness
desired_companion

grid_trader semantics are intentionally conservative now:

ready_for_handoff means true depletion, not merely directional conditions
watch_handoff means directional pressure plus moderate imbalance
prefer_hold means the grid does not self-report handoff pressure

Policies are still applied on reconcile and instance creation.