64 lines
3.2 KiB
Markdown
64 lines
3.2 KiB
Markdown
Selfhost Pipeline v2 (Box-First, Emit-Only)
|
||
|
||
Goal
|
||
- Make the selfhost compiler pipeline explicit in Nyash code without changing Core behavior.
|
||
- Keep execution in the parent Runner; Ny boxes handle parse→emit and print one JSON line.
|
||
- JSON v0 lowering is unified via MirBuilder; the legacy bridge path has been removed.
|
||
|
||
Boxes
|
||
- ExecutionPipelineBox: orchestrates ParserBox and EmitterBox; optional backend tag.
|
||
- BackendBox (stub): stores backend name only (no execution in Phase 15.7).
|
||
- MirBuilderBox (stub): reserved for Ny→MIR(JSON v0) lowering; pass-through today.
|
||
|
||
Constraints (Phase 15.7)
|
||
- No extern calls from Ny to invoke Rust VM/LLVM/PyVM; execution is a Runner responsibility.
|
||
- No new default-off toggles required for basic emit-only flow.
|
||
- Quiet acceptance: when `NYASH_JSON_ONLY=1`, prints exactly one JSON object line to stdout.
|
||
|
||
Folder Layout
|
||
- apps/selfhost-compiler/
|
||
- boxes/ (ParserBox / EmitterBox)
|
||
- pipeline_v2/ (ExecutionPipelineBox / BackendBox / MirBuilderBox)
|
||
- README.md (safe profile and acceptance)
|
||
- INTERFACES.md (contracts)
|
||
|
||
Usage (dev)
|
||
- Construct `ExecutionPipelineBox` and call `run_source(src, stage3_flag)`.
|
||
- For Runner-driven acceptance, keep using `NYASH_USE_NY_COMPILER=1 ... NYASH_JSON_ONLY=1`.
|
||
|
||
Dev knobs
|
||
- prefer_cfg levels (for Compare/If-Else lowering):
|
||
- 0 = Return-only (no CFG)
|
||
- 1 = CFG (no materialize copy)
|
||
- 2 = CFG + materialize copy before branch (LocalSSA.ensure_after_phis_copy)
|
||
- trace (emit-only): pass `--emit-trace` to print a single `[emit] ...` line before the final JSON.
|
||
- MirBuilderBox bridge (dev-only):
|
||
- Programmatic: `b.set_pipeline_v2(1); b.set_prefer_cfg(0|1|2); b.build(ast_json)`
|
||
- CLI: `--emit-mir --builder-bridge` + `--prefer-cfg` / `--prefer-cfg2`
|
||
|
||
Smokes (quick)
|
||
- Child path (emit-only): `tools/smokes/v2/profiles/quick/selfhost/selfhost_min_json_header_pipeline_v2_vm.sh`
|
||
- Direct driver (emit-only): `tools/smokes/v2/profiles/quick/selfhost/selfhost_pipeline_v2_driver_min_json_vm.sh`
|
||
- Compare variants (dev): `tools/smokes/v2/profiles/quick/selfhost/selfhost_pipeline_v2_cmp_*.sh`
|
||
- Materialize check (prefer_cfg=2): `tools/smokes/v2/profiles/quick/selfhost/selfhost_pipeline_v2_cmp_materialize_vm.sh`
|
||
|
||
Fail-Fast
|
||
- Empty/invalid JSON emission must return non-zero and avoid stdout noise.
|
||
- Diagnostics go to stderr; quiet mode suppresses non-essential logs.
|
||
|
||
Future Work (post 15.7)
|
||
- Wire MirBuilderBox to output minimal MIR(JSON v0).
|
||
- Introduce guarded externs for backend execution (opt-in, default OFF).
|
||
|
||
## Recent Updates (2025-10-08)
|
||
|
||
- Tolerant scanning via Stage1JsonScannerBox
|
||
- Early paths for Call and Method now use `Stage1JsonScannerBox.extract_name_args()` as a lightweight fallback when strict extractors cannot parse a minimal variant of JSON.
|
||
- Names are normalized through `NamespaceBox` and verified by `SignatureVerifierBox` before emitting.
|
||
|
||
- Throw/PHI handling in Builder
|
||
- `Match` then‑arm that ends with `Throw` no longer contributes a PHI input nor emits a merge jump. This prevents unreachable inputs from forming invalid PHIs.
|
||
|
||
- Quiet acceptance remains unchanged
|
||
- In `NYASH_JSON_ONLY=1`, pipeline prints a single JSON line; diagnostics go to stderr. The above changes do not alter this contract.
|