Decision records¶
Each record fixes one decision that would otherwise be reopened by accident. They rank
above the implementation and below AGENTS.md in the precedence order that file states.
Applying that order means knowing what each record decides, which is what this index is for:
one line per record, saying what it settles rather than what it is about.
Record |
What it decides |
|---|---|
The four decisions the project was founded on, in the words they were first written in. No shared core package; 0002-0004 are retired and never reused |
|
Distance shards run on a |
|
Producing object bytes is one concern and it belongs to the normalizer, whether the objects come from a table or from files |
|
Adopted files are copied into the run directory, never referenced where they live |
|
The encoding that produced the measured bytes is part of the result, recorded as a named, versioned |
|
Spreadsheets are read with |
|
The rule that turns a typed spreadsheet cell into text is this project’s, not the parsing library’s |
|
Three informationless fields in the published 0.2 schemas stay until a breaking release removes them |
|
Small helpers duplicated across packages stay duplicated; the evidence ADR 0001 asserted without it is here |
|
|
|
Dataset partitioning lives upstream of the source axis, emits datasets, and its results are fixed by a named rule |
|
A work with a DOI is never typed: |
|
The mapping from branch lengths to FastGreedy edge weights is this project’s own and decides the partition |
|
Q scores within a relative band are one tie, broken in lexicographic label order; neither published source states a tie rule |
|
The manifest records which named rule was in force at each stage, separately from the parameters |
|
Every attribution to a published work declares whether anybody read it against this code, and the gate checks shape, never truth |
|
PPMd variant I with restart is the default compressor, its order and memory are configuration, and |
|
bzip2 and raw LZMA2 join the compressors; each exposes only the settings that change its window, its stream memory is charged per worker, and its codec is named by a probe |
|
|
|
A pair longer than the window its compressor declares is refused by preflight, under a factor that lifts it; PPMd declares none, because its model size is not a limit the measurement shows |
- ADR 0001: Foundational decisions
- ADR 0005: Process pool for distance workers
- ADR 0006: The object source is an axis owned by the normalizer
- ADR 0007: A run directory is self-contained
- ADR 0008: The object encoding is named and versioned
- ADR 0009: openpyxl reads spreadsheets, through its own API
- ADR 0010: Spreadsheet cells become text by a rule this project owns
- ADR 0011: Dead schema fields wait for a breaking release
- ADR 0012: Duplicated helpers stay duplicated
- ADR 0013: The public signature stays flat
- ADR 0014: Dataset partitioning is upstream of the source axis and emits datasets
- ADR 0015: The bibliography is fetched, never written
- ADR 0016: Branch lengths become edge weights by a rule this project owns
- ADR 0017: The Neighbor Joining tie rule is this project’s, with a relative band
- ADR 0018: The manifest records which rule produced each stage
- ADR 0019: An attribution declares whether its work was read
- ADR 0020: PPMd is the default compressor
- ADR 0021: bzip2 and LZMA join the compressors
- ADR 0022: Execution settings are not run identity
- ADR 0023: The compressor window is a correctness gate, with a factor to lift it