implements PLN-0026 frontend-owned semantic presentation spec propagation

This commit is contained in:
2026-04-02 15:05:56 +01:00
parent c00fc221be
commit 78758c1023
4 changed files with 47 additions and 3 deletions
@@ -52,6 +52,7 @@ This document depends on:
- `20. IRBackend to IRVM Lowering Specification.md`
- `21. IRVM Optimization Pipeline Specification.md`
- `docs/specs/compiler-languages/pbs/13. Lowering IRBackend Specification.md`
- the frontend-owned semantic presentation contract published through `FrontendSpec`
## 5. Canonical Shared Pipeline
@@ -191,6 +192,24 @@ Those configs/contexts MUST NOT:
Filesystem-default composition MUST happen outside the pipeline core.
## 8.1 FrontendSpec-Owned Semantic Presentation Contract
`FrontendSpec` MUST remain the canonical static contract surface for frontend-owned semantic presentation metadata.
At minimum, that contract MUST allow frontend publication of:
1. stable frontend-owned `semanticKeys`,
2. frontend-owned `resources`,
3. and enough static metadata for downstream semantic consumers to derive a consumable descriptor without inventing host-owned fallback semantics.
This contract MUST NOT:
1. move frontend semantic presentation ownership into Studio,
2. move frontend semantic presentation ownership into LSP,
3. or force frontend semantic output into a shared artificial host vocabulary.
Tooling consumers such as integrated LSP and Studio MAY derive downstream descriptors from `FrontendSpec`, but they MUST treat `FrontendSpec` as the canonical source rather than a host-owned replacement contract.
## 9. Public Surface Rule
The shared compiler public surface MUST expose explicit entrypoints equivalent in meaning to: