feat(stdlib): add datetime and project-mode clock APIs
This commit is contained in:
1 parent
cffb6790be
commit
ae69391bc0
15 files changed
+527
-11
No files matched your search
+7
-6
@@ -58,7 +58,7 @@ byte-identical).
|
||||
cargo fmt --all -- --check PASS
|
||||
cargo clippy --workspace --all-targets -- -D warnings PASS
|
||||
cargo test --workspace --locked PASS
|
||||
471 passed, 0 failed, 2 ignored; includes 7/7 Linux security tests
|
||||
474 passed, 0 failed, 2 ignored; includes 7/7 Linux security tests
|
||||
```
|
||||
|
||||
The documentation and test migration is local work; re-run this block after it
|
||||
@@ -202,11 +202,12 @@ This is still a **local VM lane**, not a self-hosted GitHub Actions security URL
|
||||
over the existing `resource.*` ABI plus `存在`/`元数据`/`列出目录`/`创建目录`/
|
||||
`删除`/`重命名` over `resource.request` (ADR-0041); `data/json`/`data/csv`
|
||||
provide recursive JSON and quoted single-row CSV product parsers; `path` and a
|
||||
`regex` subset are pure `.mq.md`. Append/seek/watch, recursive walk, streaming
|
||||
JSON/CSV, a JSON depth bound, regex groups/alternation and `datetime`/`env`/
|
||||
`process` remain open.
|
||||
`regex` subset are pure `.mq.md`; `datetime` is pure UTC ISO-8601 and
|
||||
`clock.现在` reads `clock.now` in project mode (ADR-0042). Append/seek/watch,
|
||||
recursive walk, streaming JSON/CSV, a JSON depth bound, regex groups/
|
||||
alternation and `env`/`process` remain open.
|
||||
- Bundled standard library (CM-A10, ADR-0028): `stdlib/` ships
|
||||
`format`/`text`/`io`/`fs`/`data`/`path`/`regex`; explicit `std:` imports resolve only inside the bundle;
|
||||
`format`/`text`/`io`/`fs`/`data`/`path`/`regex`/`datetime`/`clock`; explicit `std:` imports resolve only inside the bundle;
|
||||
a SHA-256 digest over `*.mq.md` is verified before loading; Analysis records
|
||||
`project.stdlib`; a frozen-binary test asserts the CLI hash is unchanged after
|
||||
running a `std:io` project and that tampering is rejected. `打印/print` is
|
||||
@@ -232,7 +233,7 @@ This is still a **local VM lane**, not a self-hosted GitHub Actions security URL
|
||||
status/index links and SHA-pinned evidence; `crates/cli/tests/architecture_boundaries.rs`
|
||||
pins the workspace graph, `marqdo-runtime -> marqdo-host`, the bundled stdlib
|
||||
digest and the stdio/file/TCP endpoints; `crates/cli/tests/stdlib_product.rs`
|
||||
runs every public stdlib module (`console/csv/demo/format/fs/http/io/json/path/regex/stream/table/text/utf8`)
|
||||
runs every public stdlib module (`clock/console/csv/datetime/demo/format/fs/http/io/json/path/regex/stream/table/text/utf8`)
|
||||
through `std:` imports over `stdlib/tests/*.mq.md`. `tools/pack-stdlib.py`
|
||||
now sorts `.mq.md` by the same relative path key as the CLI. Source/test baseline
|
||||
`0d40de7`; later docs-only commits keep code/test bytes identical. Evidence:
|
||||
|
||||
@@ -0,0 +1,40 @@
|
||||
# ADR-0042: `clock.now` resource operation
|
||||
|
||||
Status: **Accepted**
|
||||
Date: 2026-11-21
|
||||
Relates to: ADR-0041
|
||||
Specs: `spec/evaluation.md`
|
||||
Evidence: `docs/evidence/2026-11-21-datetime-clock-product.md`
|
||||
|
||||
## Context
|
||||
|
||||
The bundled standard library needs a product clock API. Reading the OS clock
|
||||
inside a Rust builtin would add a second side-effect path beside
|
||||
`resource.request`, and making time available in every mode would break the
|
||||
pure/strict fail-closed contract without an explicit capability decision.
|
||||
|
||||
## Decision
|
||||
|
||||
Extend `resource.request` with one non-filesystem operation:
|
||||
|
||||
```text
|
||||
resource.request("clock.now", []) -> {ok:true, value:UnixMillis}
|
||||
```
|
||||
|
||||
* Zero arguments; any argument is a fatal `call.arity` error.
|
||||
* Project mode only. `pure` and `strict` return `permission.denied`, like
|
||||
`fs.*`.
|
||||
* The value is UTC Unix milliseconds, clamped to `i64`. A clock before the
|
||||
Unix epoch is a fatal `host.error`.
|
||||
* The call records the same `resource.request` semantic/effect events with
|
||||
`op=clock.now`.
|
||||
* `stdlib/clock.mq.md` is a thin `.mq.md` facade; `stdlib/datetime.mq.md` is a
|
||||
pure UTC formatter/parser over Unix milliseconds and has no host dependency.
|
||||
|
||||
## Consequences
|
||||
|
||||
* The clock remains a capability-gated host operation, not a language keyword.
|
||||
* No new CLI flag is introduced; project mode already implies the existing
|
||||
host boundary. A future per-call clock grant can replace this default.
|
||||
* Monotonic time, time zones and locale formatting are not part of this
|
||||
decision.
|
||||
@@ -18,7 +18,7 @@ platform".
|
||||
| Dimension | Current state | Source |
|
||||
|---|---|---|
|
||||
| Implemented | Rust workspace `0.1.0`: Markdown/frontend/IR, tree-walk runtime, `Memory`, capability host, Tool/Analysis/Trace, Plugin ABI, Foreign kernels, bundled stdlib, CLI composition root | `Cargo.toml`, `crates/`, `stdlib/` |
|
||||
| Tested locally | `cargo test --workspace --locked`: **471 passed, 0 failed, 2 ignored** on Linux x86_64 at the baseline | `docs/STATUS.md` §3 |
|
||||
| Tested locally | `cargo test --workspace --locked`: **474 passed, 0 failed, 2 ignored** on Linux x86_64 at the baseline | `docs/STATUS.md` §3 |
|
||||
| Bundled stdlib released | In-repo bundle `marqdo-stdlib@0.1.0`, SHA-256 digest verified before loading; it is **not** an external registry package | `stdlib/stdlib.json`, `stdlib/README.md` |
|
||||
| Multi-platform verified | Linux local gate is the only executed lane here; Windows/macOS native lanes are **UNVERIFIED**, and the GitHub security lane remains a **VM-only** gate | `docs/STATUS.md` §1, §4 |
|
||||
|
||||
@@ -92,6 +92,8 @@ review RFC, not a new crate per provider.
|
||||
| `std:data/csv` | `csv.解析行(文本)` -> Result with List<Text>; `csv.格式化行(列表)` -> Text | implemented (single row, quoted) | `stdlib_product` |
|
||||
| `std:path` | `path.连接/文件名/目录名/扩展名/规范/是否绝对`; lexical only | implemented (no I/O) | `stdlib_product` |
|
||||
| `std:regex` | `regex.匹配/搜索` with `^ $ . * + ? [...]` escapes | implemented subset; no groups/alternation | `stdlib_product` |
|
||||
| `std:datetime` | `datetime.格式化(毫秒)` / `datetime.解析(文本)`; UTC ISO-8601, pre-1970 supported | implemented (pure) | `stdlib_product` |
|
||||
| `std:clock` | `clock.现在()` -> `resource.request("clock.now", [])` | implemented (project mode; pure/strict denied) | `resource_streams`, `stdlib_product` |
|
||||
| file metadata / directory / rename / remove / mkdir | not part of the current Resource contract | **not implemented**; needs a separate Resource Operation ADR | — |
|
||||
| TCP | `resource.open("tcp", ip:port, ["read","write"])`; exact IP grant, 5 s timeout | implemented; no DNS/TLS/server socket/UDP | `tcp_endpoint`, `http_over_tcp` |
|
||||
| HTTP/1.1 | `stdlib/net/http.mq.md`: status/header/chunked-byte parse, request build | implemented over an already-authorized TCP stream; not a DNS/TLS client | `stdlib_http`, `http_over_tcp`, `stdlib_product` |
|
||||
@@ -123,7 +125,7 @@ that a phase is complete.
|
||||
| P1 | `crates/cli/src/commands.rs` and `crates/marqdo-host/src/host.rs` still mix multiple responsibilities | open refactor, behavior-preserving |
|
||||
| P2 | HTTP parsing is Unicode-codepoint oriented; a general byte body is not the only path | open; convert before a general network release |
|
||||
| P2 | No DNS, TLS, listener or UDP provider | open |
|
||||
| P2 | `std:path` and a regex subset are implemented; no `std:datetime`, `std:env`, `std:process`, secure random or compression | open |
|
||||
| P2 | `std:path`, a regex subset, `std:datetime` and `std:clock` are implemented; no `std:env`, `std:process`, secure random or compression | open |
|
||||
| P2 | Memory limits: 16 MiB per region, 64 MiB per run | current budget, not a product limit |
|
||||
| P3 | No concurrency tasks, atomics or cancellable long-running scheduling | open; separate ADR |
|
||||
| P3 | No native optimizer/JIT or columnar numeric backend | open; benchmark-first |
|
||||
@@ -154,5 +156,6 @@ that a phase is complete.
|
||||
- [Language/frontmatter blueprint](../DEVELOPMENT_BLUEPRINT.md) — design baseline; not current status.
|
||||
- [Stable-release implementation plan](../STABLE_RELEASE_IMPLEMENTATION.md) — next-phase plan; not implemented behavior.
|
||||
- [ADR-0041: non-streaming resource operations](../adr/0041-resource-operation-fs.md) — accepted `resource.request` `fs.*` contract.
|
||||
- [ADR-0042: `clock.now` resource operation](../adr/0042-clock-resource-operation.md) — accepted project-mode Unix-millis clock.
|
||||
- [Compute-machine RFC-0001](../MARQDO_COMPUTE_MACHINE_RFC_0001.md) and [core/stdlib RFC-0002](../MARQDO_COMPUTE_CORE_STDLIB_MIGRATION_RFC_0002.md) — design input.
|
||||
- [Architecture audit and refactor RFC](Marqdo_CLI_Latest_Architecture_Audit_and_Refactor_RFC.md) — review input for this migration.
|
||||
@@ -46,6 +46,7 @@ The implemented first slices of these RFCs are recorded in `CURRENT.md` and
|
||||
| Stdlib extraction deferral | [0039](../adr/0039-stdlib-extraction-intent.md) | Accepted (in-repo for now) |
|
||||
| Stdio stdin/stderr plus stdlib stream/console APIs | [0040](../adr/0040-stdio-stdin-stderr-and-stdlib-streams.md) | Accepted (stdin read, separate stdout/stderr, product stdlib) |
|
||||
| Non-streaming `resource.request` `fs.*` operations | [0041](../adr/0041-resource-operation-fs.md) | Accepted (project mode, grant-checked, recoverable fs Result) |
|
||||
| `clock.now` resource operation | [0042](../adr/0042-clock-resource-operation.md) | Accepted (project mode, Unix millis) |
|
||||
| Table physical storage (T1/T2/T3), strict stdin/stderr/file/network resources | — | **Not decided**; do not implement by implication |
|
||||
|
||||
## Evidence and status
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
# Evidence: `std:datetime` and `std:clock`
|
||||
|
||||
Date: 2026-11-21 (Asia/Shanghai)
|
||||
Source baseline: `cffb6790bee49966226f5abc3be026e6c4e0f8f3`
|
||||
Repository: `marqdo-cli`
|
||||
Decision record: [ADR-0042](../adr/0042-clock-resource-operation.md)
|
||||
RFC item: P2 datetime/clock product APIs
|
||||
|
||||
## Implemented
|
||||
|
||||
`stdlib/datetime.mq.md` is pure `.mq.md`: `格式化(毫秒)` emits UTC ISO-8601
|
||||
(`YYYY-MM-DDTHH:MM:SS[.mmm]Z`) using the civil-from-days algorithm;
|
||||
`解析(文本)` validates separators, digit components, ranges, leap years and
|
||||
returns recoverable `datetime.invalid`. Pre-1970 negatives are supported.
|
||||
|
||||
`stdlib/clock.mq.md` is a thin facade: `现在()` ->
|
||||
`resource.request("clock.now", [])`. The host adds `clock.now` to the
|
||||
ADR-0041 operation channel: zero arguments, project mode only, UTC Unix
|
||||
milliseconds, one `resource.request` trace/effect event. `pure`/`strict`
|
||||
return `permission.denied`.
|
||||
|
||||
No new Rust builtin, `HostOp` or parser node was added.
|
||||
|
||||
## Tests
|
||||
|
||||
`stdlib/tests/datetime.mq.md` and `stdlib/tests/clock.mq.md` run through
|
||||
`std:datetime`/`std:clock` and are pinned by
|
||||
`crates/cli/tests/stdlib_product.rs` (12 product tests total).
|
||||
`crates/marqdo-host/tests/resource_streams.rs` pins project-only access,
|
||||
Unix-millis shape and zero-argument arity (21 host tests).
|
||||
|
||||
```text
|
||||
cargo fmt --all -- --check PASS
|
||||
cargo clippy --workspace --all-targets -- -D warnings PASS
|
||||
cargo test --workspace 474 passed, 0 failed, 2 ignored
|
||||
cargo test -p marqdo-host --test resource_streams 21 passed
|
||||
cargo test -p marqdo-cli --test stdlib_product 12 passed
|
||||
python3 tools/pack-stdlib.py PASS
|
||||
```
|
||||
|
||||
## Not covered
|
||||
|
||||
No time zones, locale formatting, duration type, monotonic clock or
|
||||
calendar arithmetic beyond UTC instants. No network time source.
|
||||
Reference in new issue
Block a user