Files
marqdo-cli/docs/evidence/2026-11-20-stdlib-package.md
T
cflmy b241d1d978 feat(stdlib): add deterministic offline stdlib packaging
- 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.
2026-11-20 23:17:09 +08:00

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=0 and 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 .sha256 sidecar 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