implements PLN-0033 inline hint spec and contract propagation

This commit is contained in:
2026-04-03 11:21:28 +01:00
parent e8ec9973cd
commit 08f28b4a7d
5 changed files with 180 additions and 1 deletions
@@ -210,6 +210,25 @@ This contract MUST NOT:
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.
## 8.2 Frontend-Owned Inline Hint Contract Authority
Frontend-owned inline hint semantics MUST remain frontend-authored even when transported through tooling consumers.
When downstream semantic consumers require static contract metadata for inline hints, that metadata MUST come from `FrontendSpec` or from another accepted frontend-owned contract surface explicitly introduced for that purpose.
At minimum, any accepted frontend-owned inline hint contract authority MUST preserve:
1. frontend ownership of hint existence policy,
2. frontend ownership of hint semantic meaning,
3. enough contract metadata for `prometeu-lsp` to transport hint payloads without inventing host-owned semantics,
4. and enough contract clarity for Studio to render hints mechanically rather than semantically reinterpret them.
This authority model MUST NOT:
1. move semantic inline hint ownership into Studio,
2. move semantic inline hint policy into LSP,
3. or imply that the host editor may synthesize semantic hints when the frontend did not publish them.
## 9. Public Surface Rule
The shared compiler public surface MUST expose explicit entrypoints equivalent in meaning to: