ParameterChangeAuditor
ParameterChangeAuditor intercepts every config edit across the Polytraders fleet, records what changed, who changed it, when, and the before/after val
What it does
ParameterChangeAuditor intercepts every config edit across the Polytraders fleet, records what changed, who changed it, when, and the before/after values with replay-grade detail.
Pipeline placement
Applies to: Every bot parameter in the system
Why it matters
| If this fails | Consequence |
|---|---|
| Parameter change not recorded | Incidents cannot be root-caused; audit trails are incomplete for compliance. |
| P0 parameter changed without alert | A high-risk config change may go unnoticed until it causes a trading incident. |
Inputs
Polymarket inputs
| Input | Source | Required | Use |
|---|---|---|---|
| None — pure internal config audit hook | internal | optional | N/A |
Internal inputs
| Input | Source | Required | Use |
|---|---|---|---|
| Pre-write config delta event from each bot's config store | internal | required | Capture before/after parameter values and editor identity. |
| Ticket reference from change management system | internal | optional | Link the change to an approved ticket if require_ticket_for applies. |
Authority
What this bot is permitted to do
State
Readiness
Spec started
Status
planned
Class
Governance Service
Default mode
shadow_only
Developer owner
Polytraders core
Capital impact
Indirect
Reason codes emitted
| Code | Severity | Meaning | Action |
|---|---|---|---|
| PARAM_CHANGED | INFO | A parameter was successfully changed and recorded. | Log and emit OperationsReport. |
| P0_PARAMETER_CHANGED | WARN | A P0-tier parameter was changed; immediate alert required. | Emit alert to on-call. |
| AUDIT_TICKET_REQUIRED | HARD_REJECT | A P0/P1 parameter change was attempted without a ticket reference. | Reject change; emit alert. |
| AUDIT_LOG_UNAVAILABLE | WARN | Audit log store is unavailable; records buffered in memory. | Buffer and flush on reconnect. |
| AUDIT_RETENTION_WARN | WARN | retain_history_days < 90; below recommended minimum. | Emit WARN. |
Related bots in Governance & Ops
Used by
Reverse index — strategies that currently reference gov.parameterchangeauditor. If you change this bot's authority or reason codes, these strategies must re-pass shadow.
| Strategy | State | Activity |
|---|---|---|
| US Elect — book-builder | demo-wired | last triggered 33m ago |
| NBA H2H — moneyline market-make | demo-wired | last triggered 40m ago |
Showing 2 of 2 · demo-wired ≠ production-live
Why this matters
Governance & Ops bots does NOT propose, approve, or block trades; only observes and reports. Understanding the authority boundary prevents misuse and makes promotion-gate reviews faster and more reliable. View raw spec JSON →