ORIGINAL FICTIONAL DOCUMENTARY EXAMPLE: alternates

Extract locally. Python 3.12+ standard library only. No network, device access, input editing or output-file writes. Run:
  python -I -B document_examples.py alternates samples/alternates.json
  python -I -B test_document_examples.py
The report is JSON on stdout. Exit 0 means only that the supplied data was parsed and the limited documentary calculation completed; it is NOT an all-clear or acceptance. Read per-record statuses and nulls. Exit 2 means invalid input. Compare the parsed return with samples/alternates-expected.json. Keep each input issue and return separately.

The common module includes all three original examples, fixtures and their tests so each package is self-contained. This package's owning article explains alternates; shared fixtures do not add product or service claims. No customer data is supplied. Do not put permissioned topology, customer identities or credentials in a public example.

Exchange: explicit integer millimetres, two-dimensional quarter-turn orientation about Z and 3D translation only. No nested placements, arbitrary-angle/scale conversion, IFC/Revit file, route length, engineering or model validation. Null endpoint remains unresolved. samples/exchange-r2.json changes B's origin by +1000 mm in X, with old input preserved.
Alternates: explicit exact line/issue/unit, technical and purchasing reference declarations and distinct proposed successor issue. Pending/rejected/incomplete entries withheld. Even a successor candidate does NOT modify demand, stock, receipts or installation or grant authority. Two accepted candidates for one line are invalid. Original BOM program and all eleven legacy members, if present, are unchanged; explicitly prepare actual owner-issued successor inputs separately.
Labor: user-supplied unsigned decimal strings with at most 12 digits per value, one common currency/unit, person-hour or crew-hour. Optional crew size null preserves unknown normalization. Positive integer crew size at most 1000000. No guessed rates, FX, winner, semantic scope equivalence, duration or staffing recommendations. No fixed-package reverse engineering.

Input UTF-8 JSON, optional BOM, at most 1 MiB; duplicate keys/record IDs rejected. Required strings nonempty/unpadded, IDs exact/case-sensitive, integer fields exclude Boolean. Unknown extra fields do not replace required fields. These unauthenticated records cannot establish completeness, actual approvals or technical adequacy. This is an original sample, not an industry standard, actual contract or real project.
