diff --git a/README.md b/README.md index 5fc1584..fd15022 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,8 @@ Implementation-grade blueprint for the **home-minted M1 suite on ChainID 138**, - **Pool topology**: Single-sided PMM edge pools per chain (`cW* / HUB` or multi-quote). - **Bot-driven mesh**: Deviation watcher, inventory re-centering, cross-pool routing, bridge-aware throttling; peg bands; oracles; mesh reflexivity controls. +**GRU policy integration (reference primacy):** this mesh is an **execution and capacity layer** for agreed peg bands and oracles — not an independent FX discovery layer for GRU/XDR. Parent canonical: [docs/04-configuration/GRU_REFERENCE_PRIMACY_AND_MESH_EXECUTION_MODEL.md](../docs/04-configuration/GRU_REFERENCE_PRIMACY_AND_MESH_EXECUTION_MODEL.md). + ## Quick start 1. See [docs/01-token-map.md](docs/01-token-map.md) for canonical and cW* token mapping. diff --git a/config/peg-bands.json b/config/peg-bands.json index ce8454a..db98fd4 100644 --- a/config/peg-bands.json +++ b/config/peg-bands.json @@ -23,5 +23,10 @@ "eurUsesEurUsdFeed": true, "stalenessWidenBands": true, "stalenessPauseTrades": true + }, + "gruPolicyIntegration": { + "referencePrimacyDoc": "docs/04-configuration/GRU_REFERENCE_PRIMACY_AND_MESH_EXECUTION_MODEL.md", + "meshExecutionRole": "public_pmm_corridor_implementation", + "summary": "Peg bands and oracle settings bound bot behavior against external references; they do not define GRU/XDR/XAU policy. Parent-repo CI verifies this block via scripts/verify/check-gru-reference-primacy-integration.sh." } } diff --git a/docs/04-bot-policy.md b/docs/04-bot-policy.md index c7708d4..d2ccab3 100644 --- a/docs/04-bot-policy.md +++ b/docs/04-bot-policy.md @@ -52,6 +52,8 @@ Important: this improves **tradability and price discovery**, but it does **not* ## Peg bands +**GRU reference primacy (proxmox parent repo):** Bot deviation logic implements **corridors around oracle targets**; it does not replace institution-grade FX/GRU/XDR references. Canonical policy + integration checklist: proxmox `docs/04-configuration/GRU_REFERENCE_PRIMACY_AND_MESH_EXECUTION_MODEL.md`. The peg config carries a machine hook **`gruPolicyIntegration`** in [../config/peg-bands.json](../config/peg-bands.json) (validated by parent `scripts/verify/check-gru-reference-primacy-integration.sh`). + See [../config/peg-bands.json](../config/peg-bands.json) and [05-oracles.md](05-oracles.md). Summary: - **USD-pegged**: Normal ±10–25 bps; stress ±50–150 bps; circuit break >2% diff --git a/docs/05-oracles.md b/docs/05-oracles.md index 67a2f55..ca314bb 100644 --- a/docs/05-oracles.md +++ b/docs/05-oracles.md @@ -17,4 +17,6 @@ - Do not trade against a stale oracle; treat staleness as a risk trigger. - Document fallback order (e.g. primary chainlink, secondary Pyth, tertiary internal). -Config and peg bands: [../config/peg-bands.json](../config/peg-bands.json). +Config and peg bands: [../config/peg-bands.json](../config/peg-bands.json) (includes **`gruPolicyIntegration`** linking proxmox `docs/04-configuration/GRU_REFERENCE_PRIMACY_AND_MESH_EXECUTION_MODEL.md` — oracle targets remain subordinate to institution-grade references). + +Parent verifier: proxmox `scripts/verify/check-gru-reference-primacy-integration.sh`.