English summaries for Q+ tooling (site page)
This page is the English entry point for tooling/OS-SDK/AOT documents whose full authoritative text is Chinese. It is a summary index, not a full translation; when a summary and the Chinese document disagree, the Chinese document and the specification win. Status: release candidate — NOT PUBLISHED (1.6.0-dev / spec v4.37).
| Topic | English summary | Limits |
|---|---|---|
| Specification summary | English summary of the normative language spec (v4.37): language domain, types, errors, memory model, AOT, modules, known limitations. | Summary only — Chinese spec is normative. |
| Network Phase1 POC | VM-only TCP loopback builtins (Linux x86-64), opt-in, IPv4 literals, 32 fds, ≤65,535 B messages. | POC — no async/UDP/DNS/TLS/public network, no AOT/Windows/ARM64; not production networking. |
| qfmt v3 formatter | Standalone CLI formatter (tools/qfmt.sh): stdout by default, --write atomic in-place, --check/--diff for CI, .qfmt.toml discovery (stops at git root), --exclude, --jobs; 306 checks / 29 fixtures. | Safe subset: whitespace/layout only, no semantic rewrite; untrusted structure returns rc=2 unchanged; never implicitly modifies files. Not a complete formatter. |
| u64 bitwise | `& | ^ ~ << >>on raw u64;<<wrap,>>logical; shift clamp[0,63]`; unsigned print; VM/AOT parity. |
| AOT multi-module POC | qbc v1..v4 accepted; POC3 symbols/import-export model; modules_b10 VM/AOT parity 18 2.500000; generic Box parity; ELF-level cache POC HIT=2/MISS=2. | POC only: no per-module objects, no complete fixup/symbol model, no full cache, no AOT module:line; full 2.0 = 6–8/9–13 weeks HIGH, not implemented. |
| Windows AOT spike3 | 5/5 selected non-trivial AOT fixtures embedded in PE run under wine with byte-identical stdout/rc; estimate revised to 4–6/6–9 weeks MEDIUM-HIGH. | No Windows AOT implementation and no platform-usability claim; selected syscall-light fixtures only; PE emitter/bootstrap/general runtime/SEH missing; 1.5 defers full workstream. |
| OS SDK | OS SDK 1.6.0-prep external prototype: API-freeze candidate (E_* codes/handles/capabilities), tests 23/23, conformance 10 PASS/5 PARTIAL/5 BLOCKED, examples 3/3, api_stability 99/99; os.sync + std.fs integration. | External prototype: net BLOCKED (4–6 week design), VM-only/AOT-loud, not API 1.0, not production-usable, not in the release package. |
| LSP components | 0.6.0 is the supported release component (190 checks); 0.9.0/0.10.0/0.11.0 are optional/dev .vsix builds. | Optional/dev: not in the release tar, not Marketplace-published, not supported release components. |
| qpm docs | qpm 0.5-alpha local/static registry: install/vendor/lock/audit, index v2, optional detached signatures (ed25519/RSA-SHA256 via OpenSSL). | Local/static only: no hosted registry/signing infrastructure, no accounts/online revocation; private keys never stored in the repository. |
| TSAN | Measured TSAN limits: ucontext task switching is not fully trackable; a non-async subset can be built as limited reference. | TSAN is not a release gate; never claim TSAN-clean/no data races. |
| FFI / Macros / OS SDK design | Controlled extern "C" shim FFI (puts/strlen, AOT loud); declarative macros M1-lite (repetition/fragments/hygiene v2); OS SDK design/prototype documents. | FFI not general/AOT; macros M1-lite only; OS SDK external prototype (1.6.0-prep, net BLOCKED). |
| std.fs | Placeholder for a planned std.fs namespace; current file I/O exists outside std.fs; direction is a stable stdlib filesystem layer with capability/error semantics. | Planned/placeholder only — no std.fs API or compatibility promise; release-tree std.fs is VM-only (Windows stub, AOT loud). |
Deeper English references
- What's New in Q+ 1.5.0-dev · Language guide · Quick start · Building · FAQ
- English summaries document (repo
docs/ENGLISH_SUMMARIES.md) - English 1.5.0 summary document