Imported from InterstellarTechnologyGroup/NovelSequence (nova_sequence/AGENTS.md). Install upstream with npx skills add InterstellarTechnologyGroup/NovelSequence --skill nova_sequence. Copyright stays with the author.

NOVA Sequence - Development Guide

Quick Start

# Navigate to project
cd C:\Projects\NovelSequenceApp\nova_sequence

# Run analysis
flutter analyze

# Run tests
flutter test

# Build web
flutter build web --release

# Run local server (from project root)
powershell -ExecutionPolicy Bypass -File "..\run_server.ps1" 9001

Project Structure

nova_sequence/
├── lib/
│   ├── main.dart              # Entry point
│   ├── app.dart               # App widget + providers
│   ├── core/
│   │   └── constants/         # Game constants
│   ├── domain/
│   │   ├── models/            # Domain models
│   │   ├── functions/        # Pure functions
│   │   ├── trackers/         # Bayesian, Dragon7 counter
│   │   └── training/         # Tutorial system
│   ├── engine/
│   │   ├── nova_engine.dart  # Core betting engine
│   │   └── progression_manager.dart
│   ├── data/
│   │   └── simulators/       # Monte Carlo
│   └── screens/              # UI screens
└── test/
    ├── domain_models_test.dart
    ├── progression_manager_test.dart
    └── widget_test.dart

Development Workflow

1. Local Development Server

# Terminal 1: Start server
powershell -ExecutionPolicy Bypass -File "run_server.ps1" 9001

# Then open http://localhost:9001

2. Run Tests

flutter test

3. Code Analysis

flutter analyze

4. Full Workflow

dev.bat all  # analyze -> test -> build

Key Components

• NovaEngine: Core betting logic with immutable state
• ProgressionManager: 1-3-2-6 sequence management
• BayesianTracker: Beta-Binomial probability model
• Dragon7CardCounter: Jacobson card counting
• MonteCarloEngine: Simulation engine
• TutorialSystem: Interactive onboarding

Testing Strategy

• Unit tests for domain models and pure functions
• Widget tests for UI components
• Integration tests for engine flows