Implements RFC-EXT-0001 PR-00..PR-07 first pass: - CallSiteKey/CallBindingTable + one frontend binding pass; runtime dispatch by identity - prepare composition root shared by check/run/inspect/Analysis; exact plugin reconciliation - provider.json v2 --provider/--allow-provider worker CLI with fail-closed verification - capability handler registry with real fs.read and audit - verified stdlib public aliases replace print_override/AST scan - docs: specs, ADR-0054/0055/0057/0058, README, CI/release gates, evidence PR-04 extension selection/lock v4 and final frozen-binary evidence remain.
106 lines
5.2 KiB
Markdown
106 lines
5.2 KiB
Markdown
# ADR-0058: Official stdlib public aliases replace print magic
|
|
|
|
- Status: Accepted (2026-11-21)
|
|
- Implements: RFC-EXT-0001 §8 (PR-06)
|
|
- Related: ADR-0028/0030/0031/0039, ADR-0054
|
|
|
|
## Context
|
|
|
|
`打印`/`print` were implemented twice:
|
|
|
|
1. `crates/cli/src/loader.rs::program_uses_print` walked the entire AST, and if
|
|
any function called `打印`/`print` it injected the bundled
|
|
`stdlib/io.mq.md` module and set `Program.print_override` to its `写值`
|
|
function;
|
|
2. `crates/marqdo-runtime/src/interpreter.rs` contained a `打印`/`print`
|
|
special case that redirected to the override, while the builtin table also
|
|
contained a placeholder `打印` entry.
|
|
|
|
Copying this pattern to the next official high-level function (formatting,
|
|
console input, …) would add one AST scanner and one runtime branch per name.
|
|
The RFC forbids that ("为标准库每个高级函数复制 print_override 模式"), while
|
|
also requiring byte-identical output and no new Host op.
|
|
|
|
## Decision
|
|
|
|
1. **Verified metadata.** The bundled `stdlib/stdlib.json` declares
|
|
|
|
```json
|
|
"public_aliases": [
|
|
{
|
|
"public_names": ["print", "打印"],
|
|
"target_module": "io.mq.md",
|
|
"target_function": "写值",
|
|
"expected_signature": "params(值)",
|
|
"effects": ["host"]
|
|
}
|
|
],
|
|
"aliases_digest": "sha256:<64 lowercase hex>"
|
|
```
|
|
|
|
`aliases_digest` is the SHA-256 of the canonical binary encoding: for each
|
|
alias sorted by `(target_module, target_function)`, the module bytes, NUL,
|
|
the function bytes, NUL, then every public name in sorted order followed by
|
|
NUL. The same encoding is implemented by `tools/pack-stdlib.py` and
|
|
`crates/cli/src/stdlib.rs::aliases_digest`; `stdlib.json` cannot be edited
|
|
without updating the digest, and the loader verifies both digests before any
|
|
module loads. Metadata is integrity-checked, not signed: a SHA-256 proves
|
|
content equality, not publisher identity.
|
|
2. **Lazy, generic loading.** The loader reads the metadata, decides whether the
|
|
program references any public alias name (a generic identifier scan, not a
|
|
per-function hard code), and only then loads the declared target module.
|
|
The target signature is checked against `expected_signature`; a mismatch is
|
|
a load error. A program without `打印`/`print` keeps its previous module
|
|
graph and startup cost.
|
|
3. **Ordinary Marqdo binding.** For each used alias the loader produces an
|
|
`OfficialAlias { public_names, function, signature, owner_package,
|
|
effects_requested }`; `project_prepare` registers it in the
|
|
`CallableRegistry`. The binding pass targets
|
|
`Marqdo { function: <stdlib instance>::io.mq.md::写值 }`. The runtime calls
|
|
an ordinary Markdown function; it has no print branch.
|
|
4. **Reserved names stay reserved.** Official aliases may replace the builtin
|
|
placeholder for the same public name. Third-party registry insertion rejects
|
|
builtin *and* official-alias names (`ext.duplicate_callable`), so no plugin
|
|
or imported module can claim `打印`/`print`, `std.*` or `marqdo.*`.
|
|
`plugin.yaml` still rejects reserved export prefixes at manifest validation.
|
|
5. **No Host print operation.** Output continues to flow through
|
|
`io.写值` → `format.显示` → UTF-8 bytes → `Memory` →
|
|
`resource.write(stdout)`. There is no `HostOp::Print` and no second
|
|
formatter. Unbundled embedders that call the placeholder builtin receive
|
|
`kernel.unavailable`.
|
|
6. **Removed code.** `program_uses_print`, `stmts_use_print`,
|
|
`expr_uses_print`, `Program.print_override`, the runtime redirect branch and
|
|
the whole-AST print scanner are deleted. A structural test
|
|
(`architecture_boundaries.rs::callable_binding_is_the_only_static_resolution_path`)
|
|
fails if they reappear.
|
|
|
|
## Consequences
|
|
|
|
* `打印` and `print` are now ordinary calls in Analysis/Trace: the call target
|
|
is the stdlib function, `state` is `function`, and no synthetic `builtin`
|
|
target is reported for the alias.
|
|
* Output must stay byte-identical. `crates/cli/tests/stdlib_alias_routing.rs`
|
|
plus the existing print/format/Trace goldens pin this; a diff is a blocking
|
|
regression, not an acceptable "new design".
|
|
* A tampered alias table (metadata digest or expected signature) is rejected
|
|
before module loading; `stdlib.json` and the `.mq.md` tree remain separately
|
|
digest-pinned, and `tools/pack-stdlib.py` refuses to build an inconsistent
|
|
bundle.
|
|
* The generic metadata path is the only place a future official high-level name
|
|
needs to be declared locally. Any *new language syntax* still requires a
|
|
language RFC; aliases cannot change `@exec`/`@knowledge` semantics.
|
|
|
|
## Rejected alternatives
|
|
|
|
* **Keep `print_override` and add a second alias for another function.**
|
|
Rejected: it multiplies hard-coded scans/branches and violates RFC-EXT-0001
|
|
§8 and §14.10.
|
|
* **Move the print formatter into the Host as a `Print` op.** Rejected: it
|
|
would reintroduce an un-audited output path and duplicate the stdlib
|
|
formatter; output is a resource write.
|
|
* **Let third-party packages register `print`/`打印` aliases.** Rejected:
|
|
official public names are a language surface, not an extension registry.
|
|
* **Put the alias table in Rust `match` arms instead of metadata.** Rejected:
|
|
the table must be versioned with the verified bundle so a stale/mixed bundle
|
|
cannot run a different function.
|