volatio

Market data integrity rules — gap filling, look-forward bias prevention, and stock split handling. Use when writing or reviewing code that loads prices, fills missing data, computes returns, backtests strategies, or makes trading decisions. Applies across Python, TypeScript, SQL, and TimescaleDB.

Analyze Volatio debug logs from /tmp/volatio-debug/. Use when the user asks to check debug logs, analyze problems, or diagnose simulation issues.

Apply bottom-up systematic testing to a multi-layer system. Use when asked to test, debug, or verify a pipeline that spans multiple layers (e.g., Python worker → bridge → processor → API → UI).

Drizzle Kit workflow for Volatio using idempotent migrations (generate + edit + migrate), never use push. Idempotent patterns prevent partial failure issues, enable safe re-runs, and work cleanly in CI. Use when schema changes, migration errors, or database sync issues occur.

Template for creating Volatio research experiments with Optuna optimization and portfolio backtesting. Includes proper train/test splits, lookahead bias prevention, results saving, and validated patterns from Exp 051-053.

Financial research look-ahead bias verification for Volatio ML pipelines, mandatory baseline comparisons, timezone handling, feature leakage detection. Use when model accuracy seems too good or validating prediction experiments.

Creating PROGRESSION.md documents for research experiment series in Volatio. Captures the evolution of ideas, learnings, and breakthroughs across numbered experiments (001, 002, ...). Use when documenting experiment series or reviewing research evolution.

Run Volatio CI locally before pushing (ci-local.sh), mirrors GitHub Actions exactly, catches failures fast. Use when preparing to push, debugging CI failures, or verifying changes will pass.

Playwright E2E testing for Volatio using e2e.sh script, timeout handling, port zombies, lock files, storageState auth, test projects. Use when running E2E tests, debugging flaky tests, or auth issues.

BullMQ job queue debugging for Volatio, redis-cli inspection patterns, checking stuck/failed/completed jobs, avoiding bun --eval hangs with queue connections. Use when jobs stuck, queue inspection needed, or debugging background workers.

Volatio debug logging convention with

Volatio database inspection via docker exec psql (volatio-postgres-1, db volatio_market), common queries for tables/enums/hypertables, schema drift checks, fast debug workflow. Use when checking counts, recent rows, missing relations, or TimescaleDB hypertables.

Terminal command patterns for Volatio to avoid hanging, never pipe to head/tail, use quick scripts, show output, timeout handling. Use when commands hang, output buffering issues, or process management needed.