How loki4099/migratorybirdquantiveproject works
Migratory Bird is a local-first, versioned quantitative research platform. Researchers configure a governed universe and graph in the browser, then the backend validates and runs processing, aggregation, strategy, and frozen weekly/monthly experiments; results expose rankings, diagnostics, lineage, and evidence. Accepted results may cross into separately monitored Research Products. The README documents the domain workflow and major capabilities; the sampled source and index support selected frontend routes, API use, runtime modules, and reproducibility layers. Several backend stages are represented by their enclosing runtime modules because their detailed implementations were not sampled.
Main entry points: engine.py Backtest evidence · representative_pipeline_runtime.py Three processing layers · aggregation_work_runtime.py Aggregation runtime · service.py Immutable lineage
Components 21
Research workspace
- Graph workspace
frontend/src/pages/GraphWorkspacePage.tsx - Draft context
frontend/src/workspace/GraphDraftContext.tsx - API client
frontend/src/api/client.ts - Result views
frontend/src/pages/ExperimentResultPage.tsx
Governed data
- Governed market data
src/style_rotation/data/pipeline.py - Historical universe
src/style_rotation/catalog/dynamic_universe.py
Research pipeline
- Asset selection
src/style_rotation/v022/asset_selection.py - Three processing layers
src/style_rotation/v022/representative_pipeline_runtime.py - Frozen workspace context
src/style_rotation/v022/workspace_context.py - Aggregation runtime
src/style_rotation/v022/aggregation_work_runtime.py - Top-K strategy
src/style_rotation/strategy/engine.py
Experiments and products
- Weekly/monthly suites
src/style_rotation/experiment/orchestration_engine.py - Backtest evidence
src/style_rotation/experiment/engine.py - Cohort ranking
src/style_rotation/experiment/ranking.py - Product monitoring
src/style_rotation/product/monitoring_service.py
Runtime and evidence
- Research API
src/style_rotation/api/app.py - Immutable lineage
src/style_rotation/lineage/service.py - Canonical identity
src/style_rotation/core/canonical.py - Numerical environment
src/style_rotation/ops/environment.py
Other components
- Researcher
- Yahoo Finance
Connections 24
- Researcher → Graph workspace: configures
- Graph workspace → Draft context: edits draft
frontend/src/workspace/GraphWorkspaceRoute.tsx - Draft context → API client: saves draft
frontend/src/workspace/GraphDraftContext.tsx - API client → Research API: HTTP requests
- Research API → Frozen workspace context: loads context
- Yahoo Finance → Governed market data: provides observations
- Historical universe → Governed market data: governs history
- Governed market data → Asset selection: supplies inputs
- Asset selection → Three processing layers: selects assets
- Three processing layers → Aggregation runtime: emits signals
src/style_rotation/v022/representative_pipeline_runtime.py - Aggregation runtime → Top-K strategy: scores assets
- Top-K strategy → Weekly/monthly suites: launches experiments
- Weekly/monthly suites → Backtest evidence: runs cells
- Backtest evidence → Cohort ranking: publishes results
- Cohort ranking → Result views: displays evidence
- Backtest evidence → Product monitoring: promotes accepted cell
- Three processing layers → Immutable lineage: records lineage
src/style_rotation/v022/representative_pipeline_runtime.py - Aggregation runtime → Immutable lineage: records lineage
src/style_rotation/v022/aggregation_work_runtime.py - Backtest evidence → Immutable lineage: records lineage
src/style_rotation/experiment/engine.py - Immutable lineage → Canonical identity: fingerprints artifacts
src/style_rotation/lineage/service.py - Three processing layers → Canonical identity: canonicalizes identity
src/style_rotation/v022/representative_pipeline_runtime.py - Aggregation runtime → Canonical identity: canonicalizes identity
src/style_rotation/v022/aggregation_work_runtime.py - Backtest evidence → Canonical identity: canonicalizes identity
src/style_rotation/experiment/engine.py - Backtest evidence → Numerical environment: captures environment
src/style_rotation/experiment/engine.py