Polytraders Dev Guide
internal
v3 spine Phase 1 · Shared contracts 9 demo-wired · 0 shadow-ready · 0 production-live · 100 pending · 109 total 15/33 infra tasks the plan status board

v3 status board

Per-bot state across three tracks: documentation, implementation, and runtime promotion. A bot can be 27/27 on docs and still 0/8 on runtime. Progress in one track does not satisfy the others.

1

Infrastructure

Phases 1–7: snapshots, envelopes, correlation IDs, replay, reconciler. Tracked by tasks, not bots. Done means the rail exists in code and has runtime-live observability.

View — By task
2

Bot implementation

Per-bot documentation score (out of 27) and implementation score (out of 15). Documentation completeness does not imply implementation. Tracked per bot.

View — By bot
3

Runtime promotion

Modes ladder: stub → shadow → advisory → enforced, then demo-wiredshadow-readyruntime-liveproduction-live. Tracked by runtime score (out of 8).

View — Runtime column
0 done 0 in progress 9 demo-wired 100 pending 0 blocked 0 deprecated

Honest state: 109 specs at 27/27 documentation. 9 bots demo-wired. 0 shadow-ready. 0 runtime-live. 0 production-live. Documentation is not implementation; implementation is not runtime.

StateBotCapital impactPhaseDocsImplRuntime
pendingduplicatemarketdetectorIndirectP2 · Data normalisation27/270/150/8
pendingeventcalendarmapperIndirectP2 · Data normalisation27/270/150/8
demo-wiredmarketqualityrankerIndirectP2 · Data normalisation27/270/150/8
pendingmarketscannerIndirectP2 · Data normalisation27/270/150/8
pendingnewmarketwatcherIndirectP2 · Data normalisation27/270/150/8
pendingopportunityqueueIndirectP2 · Data normalisation27/270/150/8
pendingapi_degradation_monitorIndirectP2 · Data normalisation27/270/150/8
pendinganomalydetectorIndirectP2 · Data normalisation27/270/150/8
pendingcontradictiondetectorIndirectP2 · Data normalisation27/270/150/8
pendingcrossmarketgraphIndirectP2 · Data normalisation27/270/150/8
pendingliquidity_decay_monitorIndirectP2 · Data normalisation27/270/150/8
pendingliquidityforecastmodelIndirectP2 · Data normalisation27/270/150/8
pendingmarket_resolution_watcherIndirectP2 · Data normalisation27/270/150/8
pendingmarketontologybuilderIndirectP2 · Data normalisation27/270/150/8
pendingnewsingestIndirectP2 · Data normalisation27/270/150/8
pendingonchainwatcherIndirectP2 · Data normalisation27/270/150/8
pendingoraclewatcherIndirectP2 · Data normalisation27/270/150/8
pendingorderflowanalyzerIndirectP2 · Data normalisation27/270/150/8
pendingresolutionruleparserIndirectP2 · Data normalisation27/270/150/8
pendingrulechangemonitorIndirectP2 · Data normalisation27/270/150/8
pendingsocialsentimentIndirectP2 · Data normalisation27/270/150/8
pendingsourceoftruthverifierIndirectP2 · Data normalisation27/270/150/8
pendingsportsfeed-adapterIndirectP2 · Data normalisation27/270/150/8
pendingwallet-flow-classifierIndirectP2 · Data normalisation27/270/150/8
demo-wiredmarket_halt_detectorDirectP2 · Data normalisation27/270/150/8
demo-wiredstale_book_guardDirectP2 · Data normalisation27/270/150/8
pendingattributionrevenuereporterIndirectP3 · Reporting & event store27/270/150/8
pendingbuilderattributionIndirectP3 · Reporting & event store27/270/150/8
pendinghealth-heartbeatIndirectP3 · Reporting & event store27/270/150/8
pendingpnl-reporterIndirectP3 · Reporting & event store27/270/150/8
pendingslamonitorIndirectP3 · Reporting & event store27/270/150/8
pendinguseractivityledgerIndirectP3 · Reporting & event store27/270/150/8
pendingblacklistkeeperDirectP4 · Core risk27/270/150/8
pendingcapitalallocatorDirectP4 · Core risk27/270/150/8
demo-wiredcompliancegateCriticalP4 · Core risk27/270/150/8
pendingcorrelationshockguardDirectP4 · Core risk27/270/150/8
pendingfeeandgasguardDirectP4 · Core risk27/270/150/8
pendinginventoryunwinderDirectP4 · Core risk27/270/150/8
demo-wiredkillswitchCriticalP4 · Core risk27/270/150/8
pendingliquidityguardDirectP4 · Core risk27/270/150/8
pendingmanualoverrideauditorDirectP4 · Core risk27/270/150/8
pendingmodeldriftmonitorDirectP4 · Core risk27/270/150/8
pendingoracleriskmonitorDirectP4 · Core risk27/270/150/8
demo-wiredportfolioguardDirectP4 · Core risk27/270/150/8
pendingratelimitgovernorDirectP4 · Core risk27/270/150/8
pendingself_trade_wash_guardDirectP4 · Core risk27/270/150/8
demo-wiredsettlementexposureguardDirectP4 · Core risk27/270/150/8
pendingstrategysuitabilitygateDirectP4 · Core risk27/270/150/8
pendingtaillosssimulatorDirectP4 · Core risk27/270/150/8
pendingantitoxicfillDirectP5 · Execution rails27/270/150/8
pendingcancelreplaceoptimizerDirectP5 · Execution rails27/270/150/8
pendingdustandroundingcleanerDirectP5 · Execution rails27/270/150/8
pendingexchangestatusmonitorDirectP5 · Execution rails27/270/150/8
pendingfee_slippage_estimatorDirectP5 · Execution rails27/270/150/8
pendingfillqualityanalyzerDirectP5 · Execution rails27/270/150/8
pendinggasoracleDirectP5 · Execution rails27/270/150/8
pendinglatencyprofilerDirectP5 · Execution rails27/270/150/8
pendingnonceshepherdDirectP5 · Execution rails27/270/150/8
pendingorder_amend_cancel_managerDirectP5 · Execution rails27/270/150/8
pendingorderlifecyclemanagerDirectP5 · Execution rails27/270/150/8
pendingpartialfillhandlerDirectP5 · Execution rails27/270/150/8
pendingpricebandvalidatorDirectP5 · Execution rails27/270/150/8
pendingqueuewardenDirectP5 · Execution rails27/270/150/8
demo-wiredsmartrouterDirectP5 · Execution rails27/270/150/8
pendingallowancemonitorDirectP5 · Execution rails27/270/150/8
pendingchainstateverifierDirectP5 · Execution rails27/270/150/8
pendingcontractaddressguardDirectP5 · Execution rails27/270/150/8
pendingkeyrotationreminderDirectP5 · Execution rails27/270/150/8
pendingrpcfailovermanagerDirectP5 · Execution rails27/270/150/8
pendingsessionkeymanagerDirectP5 · Execution rails27/270/150/8
pendingsignaturepreviewerDirectP5 · Execution rails27/270/150/8
pendingwallet_funding_guardDirectP5 · Execution rails27/270/150/8
pendingwalletpermissionguardCriticalP5 · Execution rails27/270/150/8
demo-wiredmaker-tightDirectP6 · One simple strategy27/270/150/8
pendingbacktesterIndirectP7 · Governance & replay27/270/150/8
pendingconfig_drift_detectorDirectP7 · Governance & replay27/270/150/8
pendingcron-runnerIndirectP7 · Governance & replay27/270/150/8
pendingexperimenttrackerIndirectP7 · Governance & replay27/270/150/8
pendingexposure_explainerIndirectP7 · Governance & replay27/270/150/8
pendingincidentcommanderCriticalP7 · Governance & replay27/270/150/8
pendingpaper-trade-runnerIndirectP7 · Governance & replay27/270/150/8
pendingparameterchangeauditorIndirectP7 · Governance & replay27/270/150/8
pendingportfolio-syncIndirectP7 · Governance & replay27/270/150/8
pendingposttradeexplainerIndirectP7 · Governance & replay27/270/150/8
pendingreplay_simulatorIndirectP7 · Governance & replay27/270/150/8
pendingstrategyregistryIndirectP7 · Governance & replay27/270/150/8
pendingbasistraderDirectP8 · Additional strategies27/270/150/8
pendingbreakout-followerDirectP8 · Additional strategies27/270/150/8
pendingbregman-projection-arbDirectP8 · Additional strategies27/270/150/8
pendingcalendarcompressionDirectP8 · Additional strategies27/270/150/8
pendingcross-market-arbDirectP8 · Additional strategies27/270/150/8
pendingcross-venue-arbDirectP8 · Additional strategies27/270/150/8
pendingdispute-risk-pricingDirectP8 · Additional strategies27/270/150/8
pendingfundingrotationbotDirectP8 · Additional strategies27/270/150/8
pendinglate-resolution-spreadDirectP8 · Additional strategies27/270/150/8
pendingliquidity-pulseDirectP8 · Additional strategies27/270/150/8
pendingmaker-wideDirectP8 · Additional strategies27/270/150/8
pendingmarketcreationscoutDirectP8 · Additional strategies27/270/150/8
pendingmean-reversion-sniperDirectP8 · Additional strategies27/270/150/8
pendingnarrativecrowdingfadeDirectP8 · Additional strategies27/270/150/8
pendingneg-risk-sum-arbDirectP8 · Additional strategies27/270/150/8
pendingnews-materiality-traderDirectP8 · Additional strategies27/270/150/8
pendingportfoliohedgerDirectP8 · Additional strategies27/270/150/8
pendingresolution-fair-valueDirectP8 · Additional strategies27/270/150/8
pendingresolutioncurvetraderDirectP8 · Additional strategies27/270/150/8
pendingrule-risk-discountDirectP8 · Additional strategies27/270/150/8
pendingsports-modelDirectP8 · Additional strategies27/270/150/8
pendingsum-to-one-arbDirectP8 · Additional strategies27/270/150/8
pendingvolatilityharvestDirectP8 · Additional strategies27/270/150/8
StatePhaseTasksBotsProgress
pendingP1 Shared contracts15/17 tasks0/0 bots done
pendingP2 Data normalisation0/4 tasks0/26 bots done
pendingP3 Reporting & event store0/3 tasks0/6 bots done
pendingP4 Core risk0/3 tasks0/17 bots done
pendingP5 Execution rails0/2 tasks0/24 bots done
pendingP6 One simple strategy0/1 tasks0/1 bots done
pendingP7 Governance & replay0/2 tasks0/12 bots done
pendingP8 Additional strategies0/1 tasks0/23 bots done
StatePhaseTask IDTitle
doneP1p1.contracts-packageCreate packages/polytraders-contracts with TS + JSON schemas
doneP1p1.schema-manifestschemas/manifest.json is the single source of truth for the dev guide
doneP1p1.verify-scripttests/verify-contracts.js — every TS file pairs with a schema, every schema has $id/title/description
doneP1p1.dev-guide-reads-manifest/standards/schemas reads from the manifest, not from inline strings
doneP1p1.reason-code-patternAll reason codes match ^(INTEL|DISC|STRAT|RISK|EXEC|SEC|GOV)_[A-Z0-9_]+$ — enforced by schema
doneP1p1.three-score-modelThree-score model (docs/impl/runtime) added to every bot page
doneP1p1.capital-impact-fieldcapital_impact added to every bot — Critical / Direct / Indirect
doneP1p1.quarantine-modeQuarantine mode added to risk/exec/sec bot mode_support
doneP1p1.deprecated-statusDeprecated status supported with tombstone renderer
doneP1p1.status-board/roadmap/status — by-bot, by-phase, by-task views
doneP1p1.v3-plan-page/roadmap/v3 — 8-phase timeline with done / in-progress / locked / pending pills
doneP1p1.system-health-barThin strip under topnav showing v3 phase + counts on every page
doneP1p1.definition-of-done/standards/definition-of-done — what counts as readiness, what does not
doneP1p1.forbidden-pattern-docsForbidden pattern: do not score documentation completeness as readiness
doneP1p1.forbidden-pattern-riskForbidden pattern: do not allow risk to evaluate orders before strategy emits an OrderIntent
pendingP1p1.cli-bot-newCLI: pt-bot new <slug> — scaffolds a bot from the matching class template
pendingP1p1.mock-adapterMock CLOB v2 adapter playing recorded fixtures through the contracts
pendingP2p2.contracts-importsReference Intel and Discovery bots import from @polytraders/contracts
pendingP2p2.fixture-packRecorded CLOB v2 fixture pack covering normal / warning / hard / failure
pendingP2p2.freshness-budgetsPer-source freshness budgets enforced at adapter boundary
pendingP2p2.provenance-hashEvery normalised object carries the source response hash
pendingP3p3.envelope-runtimeRuntime emits envelopes with botVersion + configVersion auto-populated
pendingP3p3.audit-log-consumergov.audit_log consumes the envelope stream end-to-end
pendingP3p3.lint-no-freetextCI lint rule: no console.log / no free-text logger calls in bot code
pendingP4p4.risk-pipeline-runtimeRuntime applies Risk bots in declared order and short-circuits on REJECT
pendingP4p4.killswitch-shadowrisk.killswitch running in shadow against historical intents
pendingP4p4.compliance-shadowrisk.compliance_gate running in shadow against historical intents
pendingP5p5.exec-plan-end-to-endOrderIntent → ExecutionPlan → SignedOrderRequest path through the mock adapter
pendingP5p5.builder-code-coverage100% builderCode coverage — emit fails closed if builderCode is missing
pendingP6p6.maker-tight-shadowstrat.maker_tight emits valid OrderIntents in shadow
pendingP7p7.replay-from-envelopegov.replay_simulator reconstructs decisions from the envelope stream alone
pendingP7p7.reconcile-heartbeatgov.reconciler runs on heartbeat against on-chain state
pendingP8p8.no-new-strategiesHard rule: no new Strategy bots until phases 1–7 lock