Files
marqdo-cli/docs/evidence/2026-11-20-bundled-stdlib-cm-a10.md
T
cflmy 1377af1601 feat(stdlib): ship a verified bundled stdlib with std: imports
- Move the Compat-A print prototype into stdlib/ as the official offline
  bundle with stdlib.json (version 0.1.0 + sha256 content digest).
- Add std:<relative> import resolution in the loader with bundle path
  confinement, extension inference and fail-closed digest verification.
- Record the verified version/digest/instance_id in Analysis v2
  project.stdlib; stdlib modules get a std:name@version#digest instance id.
- Add CLI tests: std:io execution, digest-tamper rejection, missing manifest,
  Analysis identity, no foreign/plugin calls, and frozen binary hash equality.
- Update ADR-0028, specs, status, changelog and evidence.

Gate: fmt, clippy -D warnings, 415 tests passed.
2026-11-20 21:43:14 +08:00

3.8 KiB

RFC-CM CM-A10 evidence: bundled stdlib, std: imports and digest

Date: 2026-11-20 (Asia/Shanghai) Repository: marqdo-cli Baseline: 92bfbf2 plus this step's changes. Decision record: ADR-0028 Related: Compat-A, STATUS §5. Scope: bundled first slice; no external repository publication.

Environment and gate

Ubuntu 26.04 development container, Linux x86_64, Rust 1.100.0.

cargo fmt --all -- --check                            PASS
cargo clippy --workspace --all-targets -- -D warnings PASS
cargo test --workspace --locked                       PASS
  415 passed, 0 failed, 2 ignored (existing plugin-sdk doc-tests)

No GitHub CI is available from this checkout; this is local evidence.

Bundle

stdlib/ is the official offline bundle:

stdlib/
  stdlib.json      # name, version 0.1.0, sha256 digest
  README.md
  format.mq.md     # 显示 / 列表显示 / 映射显示 / 表格显示 / 转义文本
  text.mq.md       # utf8编码 into Memory
  io.mq.md         # 写文本 / 写值 via resource.write(stdout)
  demo.mq.md       # builtin 打印 comparison
  tests/io.mq.md   # std:io self-test

Digest scheme: SHA-256 over sorted *.mq.md relative paths, NUL, file bytes, NUL. stdlib.json and non-.mq.md files are excluded. The loader recomputes the digest before loading any stdlib module and fails closed on mismatch or a missing manifest.

std:<relative> is an explicit front-matter import target; it resolves only inside the bundle, rejects ../absolute paths, appends .mq.md when absent, and uses package instance std:marqdo-stdlib@0.1.0#<sha256-hex>.

Tests

crates/cli/tests/stdlib_bundle.rs (6):

std_import_resolves_the_verified_bundle
  index.mq.md imports std:io; io.写值(["bundle",1,2.5])
  -> ["bundle", 1, 2.5]

analysis_records_the_verified_stdlib_digest
  check --emit contains project.stdlib.version/digest/instance_id
  matching stdlib.json

tampered_bundle_is_rejected_before_module_loading
  copy bundle, modify io.mq.md
  -> non-zero, "stdlib digest mismatch"

missing_bundle_manifest_is_a_hard_error
  empty MARQDO_STDLIB_DIR -> non-zero stdlib error

bundle_uses_no_foreign_or_plugin_calls
  scans all stdlib *.mq.md for foreign./plugin. -> none

frozen_binary_hash_is_unchanged_after_stdlib_execution
  sha256(marqdo binary) before == after running the std:io project

CLI unit tests in crates/cli/src/stdlib.rs (2): dev bundle resolves and verifies; a copied/tampered bundle is rejected.

Existing mqmd_stdlib_print_output_matches_builtin_print still passes with the demo moved to stdlib/demo.mq.md.

Analysis identity

Analysis v2 project object now carries:

{"stdlib":{"version":"0.1.0",
           "digest":"sha256:<64 hex>",
           "instance_id":"std:marqdo-stdlib@0.1.0#<64 hex>"}}

It is null when no bundle is available. The digest is verified before load, so an Analysis artifact cannot name mismatched stdlib bytes.

What is not done

  • No separate cflmy/marqdo-stdlib repository, release tag, package registry or CI-signed digest. The bundle is vendored in this repository and copied next to the executable in a release layout by later packaging work.
  • No CM-A07 Compat-B/C routing; 打印 is still the builtin default.
  • No Windows/macOS bundle layout evidence and no remote CI URL.
  • No independent stdlib upgrade workflow; changing a module requires updating stdlib.json.digest, and an incompatible core requirement is not yet enforced by a version table.

Reproduce

export PATH=/root/.cargo/bin:$PATH
export CARGO_HOME=/root/work/marqdo-cli/.cache/cargo
export CARGO_TARGET_DIR=/root/work/marqdo-cli/.cache/target
cargo test -p marqdo-cli --test stdlib_bundle
cargo run -q -p marqdo-cli -- run examples/stdlib-bundle.mq.md
cargo test --workspace --locked