Architecture

This document describes the intended package/module separation for the research-focused, minimal refactor.

Target top-level modules

• motac.data: dataset loaders (Chicago, ACLED, simulation) and canonical schema validation

• motac.spatial: grid/graph builders, travel-time neighbours, POI features

• motac.models: parametric Hawkes, marked Hawkes, neural-kernel modules

• motac.inference: JAX likelihoods, sparse/jit kernels, optimisers, constraints

• motac.sim: simulator and observation-noise models

• motac.eval: backtesting, metrics, calibration, reporting

• motac.cli: commands for fetch, build-substrate, simulate, fit, forecast, backtest

Only these seven package directories are kept under src/motac.

Legacy split modules were removed to keep the codebase straightforward for research iteration.