From f0c25be01d72e9ea3a67dfa4336707b5250cf7be Mon Sep 17 00:00:00 2001 From: Marqdo Agent Date: Sat, 21 Nov 2026 01:51:51 +0800 Subject: [PATCH] docs(tests): map architecture and e2e gates to executable lanes --- tests/architecture/README.md | 18 ++++++++++++++++++ tests/e2e/README.md | 14 ++++++++++++++ 2 files changed, 32 insertions(+) create mode 100644 tests/architecture/README.md create mode 100644 tests/e2e/README.md diff --git a/tests/architecture/README.md b/tests/architecture/README.md new file mode 100644 index 0000000..1f9232c --- /dev/null +++ b/tests/architecture/README.md @@ -0,0 +1,18 @@ +# Architecture gates + +The executable architecture checks are Rust integration tests in +`crates/cli/tests/`, so they run inside `cargo test --workspace`: + +| Gate | Test | What it pins | +|---|---|---| +| source dependency graph | `crates/cli/tests/architecture_boundaries.rs` | workspace members, `marqdo-runtime -> marqdo-host`, no back-edge, no `marqdo-stdlib` crate | +| bundled stdlib identity | `crates/cli/tests/architecture_boundaries.rs` | `stdlib.json` version + SHA-256 digest over sorted `.mq.md`, `std:`/relative imports stay inside `stdlib/` | +| public resource endpoints | `crates/cli/tests/architecture_boundaries.rs` | `stdio/stdin/stdout/stderr`, `file`, `tcp` remain in `marqdo-host/src/resource.rs` | +| documentation consistency | `crates/cli/tests/docs_consistency.rs` | one current overview, status/index links, evidence SHA pinning, no stale `c9f01aa8` claim | +| primitive-only programs | `crates/cli/tests/p2_closure.rs` | C01–C06/C11/C12 run in `--mode pure` with no Foreign/Plugin/import shortcut | +| strict refusal matrix | `crates/marqdo-sandbox/tests/security_linux.rs` | strict L1 refuses unverified resources; G-C VM lane | + +A `.mq.md` demo is not an architecture gate. Put semantic fixtures under +`tests/conformance/`, product tests under `stdlib/tests/`, and OS-isolation +commands under `tests/security/`. Do not move a Rust gate into this directory; +Cargo would stop running it. diff --git a/tests/e2e/README.md b/tests/e2e/README.md new file mode 100644 index 0000000..c46b5f5 --- /dev/null +++ b/tests/e2e/README.md @@ -0,0 +1,14 @@ +# End-to-end lanes + +The executable end-to-end lanes live next to the binary: + +| Lane | Test | What it runs | +|---|---|---| +| interactive stdio | `crates/cli/tests/resource_streams.rs` | piped stdin, separate stdout/stderr, EOF, partial reads/writes | +| print compatibility | `crates/cli/tests/print_routing.rs` | `打印/print` through the bundled `std:io` path | +| HTTP over TCP | `crates/cli/tests/http_over_tcp.rs` | HTTP/1.1 exchange over an authorized IP-literal TCP stream | +| whole stdlib | `crates/cli/tests/stdlib_product.rs` | every `stdlib/tests/*.mq.md` through `std:` imports | +| CLI contract | `crates/cli/tests/integration_cli.rs` | `run`/`call`/`check`/`inspect`/`package`/`tool` | + +A fixture alone is not an end-to-end lane. These tests spawn the frozen CLI +binary; update `docs/STATUS.md` with the executed command, not with a plan.