Contributing

Where each kind of thing lives in the source.

Where each kind of thing lives, written from the table the source's own layering test reads. The source is grouped by what a file is responsible for, and a package imports its own layer and the layers below it, never one above:configuration (what a hop says: its keys, the environment, the endpoints and the addresses it is built from); scope (which objects and rows a hop carries); persistence (state that outlives a process: checkpoints, the audit record, the run's own files, the undo); safety (who may write, what must not leak, what keeps a mover from writing twice); execution (the running of work: processes, ranges, retries, pacing, stalls, sizing of what runs at once); conversion (a value or an object as another engine takes it: canonical text, transforms, types, stored code); reporting (what the operator reads: the verdict, the result shape, the log, the metrics, the notices); decision (choosing: the rungs, the cost model, the joint plan, what each engine can do); engines (the contract every engine fills and each engine's own adapter); integrations (the programs, libraries and provider APIs migkit wraps, and the other tools it meets); workflows (a move's phases and what they do around the move: copy, follow, prove, repair, cut over, recover); cli (the command line and the guide that asks for two addresses); web (the web view and its API); tools (the generators, the full suite and the checks run by the maintainers; they import migkit and migkit never imports them). data (the files migkit ships as resources).

The packages, lowest first

PackageLayerFilesWhat it holds
configuration111what a hop says: its keys, the environment, the endpoints and the addresses it is built from
scope25which objects and rows a hop carries
persistence318state that outlives a process: checkpoints, the audit record, the run's own files, the undo
safety412who may write, what must not leak, what keeps a mover from writing twice
execution517the running of work: processes, ranges, retries, pacing, stalls, sizing of what runs at once
conversion669a value or an object as another engine takes it: canonical text, transforms, types, stored code
reporting714what the operator reads: the verdict, the result shape, the log, the metrics, the notices
decision836choosing: the rungs, the cost model, the joint plan, what each engine can do
engines980the contract every engine fills and each engine's own adapter
integrations923the programs, libraries and provider APIs migkit wraps, and the other tools it meets
workflows10111a move's phases and what they do around the move: copy, follow, prove, repair, cut over, recover
cli114the command line and the guide that asks for two addresses
web1130the web view and its API
tools-13the generators, the full suite and the checks run by the maintainers; they import migkit and migkit never imports them
data-5the files migkit ships as resources