- tools/pack-stdlib.py builds a byte-deterministic marqdo-stdlib-0.1.0.tar.gz (fixed metadata, gzip mtime 0) plus a schema-tagged descriptor with tree digest, archive SHA-256 and file list. - Verified repeated builds are identical and the extracted tree digest matches stdlib.json; archive is for the future external repo, not the CLI loader. - Update ADR-0028, status/changelog/tests README and evidence. Gate: fmt, clippy -D warnings, 430 tests passed.
1.9 KiB
RFC-CM CM-A10 evidence: deterministic offline stdlib package
Date: 2026-11-20 (Asia/Shanghai)
Repository: marqdo-cli
Baseline: e985da2 plus this step's changes.
Related: ADR-0028,
STATUS §5.
Scope: packaging artifact for the future external repository; no CLI command.
Artifact
tools/pack-stdlib.py builds dist/marqdo-stdlib-0.1.0.tar.gz from the
verified stdlib/ tree with:
- sorted relative names, fixed mode/uid/gid/uname/gname and
mtime=0; - gzip
mtime=0and an empty filename, so repeated builds are byte-identical; - a JSON descriptor (
marqdo.stdlib-package) with the tree digest, archive SHA-256 and file list; a.sha256sidecar is also written.
Descriptor: 2026-11-20-stdlib-package.json.
version 0.1.0
tree digest sha256:832940f35fe5651eabe4ac672e12e2d8f2bf4e649cc430e455425b4f2a983121
archive sha256:94127ba3353bdef7430b2ef3c1914d99f9d7f48e4d72fa973eac7ca76c881394
files 11 (README, stdlib.json, *.mq.md)
Two consecutive builds compared byte-identically (cmp), and extracting the
archive and recomputing the custom tree digest reproduces the manifest digest.
dist/ is gitignored, so the script and descriptor are the checked-in
reproducible inputs.
Boundary
This does not publish the separate marqdo-stdlib repository or sign a
release; no GitHub credentials/remote is available from this host. It gives the
future external repository a deterministic archive layout and digest contract.
The in-repo CLI still uses the bundled stdlib/ tree with digest verification
and the frozen-binary closure test (ADR-0028); this archive is not loaded by
the CLI.
Reproduce
export PATH=/root/.cargo/bin:$PATH
python3 tools/pack-stdlib.py > /tmp/stdlib-package.json
sha256sum dist/marqdo-stdlib-0.1.0.tar.gz