Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

0035: Explicit pinned document acquisition

Pinned document acquisition is an explicit CLI operation for one public GitHub file at a complete commit identity and a separately reviewed expected SHA-256. It preserves unchanged bytes in a new native file and produces a bounded Acquisition receipt. Keeping retrieval separate makes the resulting Acquired snapshot an ordinary offline input and preserves ADR 0004: Supplied catalogues and checking scope and ADR 0006: Scoped reference failures.

The acquisition contract fixes origin, verified TLS, identity content encoding, no redirects or retries, byte ceilings and transfer deadlines under ADR 0009: Bounded processing and reporting. Native destination preflight and no-replacement commits protect prior evidence. The document and optional named receipt are independent outputs. A committed document can remain after receipt delivery or staging cleanup fails, and the outcome must disclose that state. Neither transport success nor a matching digest establishes Model checking, licensing or real-device acceptance.

Considered Options

Implicit namespace retrieval would make model meaning and completeness depend on network availability and an acquisition convention SDF does not require. Following branches, learning the expected digest from the same transfer, replacing snapshots or coalescing identical contributors would weaken explicit source selection and offline replay. Receipts therefore remain separate evidence that callers may deliberately translate into existing Source metadata, rather than new remote inputs or automatically loaded plans.