tmk241/hemx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(requirements): split diagnostics rows

Browse Source 
Add explicit northstar ring fields to diagnostics requirements and split editor overlay and rust-analyzer boundaries without changing behavior.

req: diagnostics/001

req: diagnostics/002

req: diagnostics/003

req: diagnostics/004

req: diagnostics/005

req: diagnostics/006

req: diagnostics/007

req: diagnostics/008
This commit is contained in:
slhx agent
2026-06-25 16:56:11 +02:00
parent 691c6f009a
commit 78bc761366
2 changed files with 13 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
REQUIREMENTS.md
+12 -6
View File
@@ -787,22 +787,28 @@ what a valid business email is. [north_star]
## diagnostics
### req: diag/001
001 Every compile-time error must point to both sides of the mismatch when possible: the Rust handler span and the template Surface span.
0 001 Every compile-time error must point to both sides of the mismatch when possible: the Rust handler span and the template Surface span. [north_star]
### req: diag/002
002 Diagnostics must include a suggested fix for common cases: missing key, unknown slot, missing form field, optionality mismatch, handler param mismatch, wrong keyed slot type.
0 002 Diagnostics must include a suggested fix for common cases: missing key, unknown slot, missing form field, optionality mismatch, handler param mismatch, wrong keyed slot type. [north_star]
### req: diag/003
003 Internal terms (`ResourceId`, `ScopeKey`, `EffectBatch`) must not appear in beginner-facing diagnostics unless `--verbose` is enabled.
0 003 Internal terms (`ResourceId`, `ScopeKey`, `EffectBatch`) must not appear in beginner-facing diagnostics unless `--verbose` is enabled. [north_star]
### req: diag/004
004 Optional `.heml` editor overlays must treat `hemx-build` diagnostics and the documented `.heml` syntax surface as authority; they may present compiler-shaped diagnostics, completion, hover, and navigation, but must not own a second template language, formatter, selector model, or custom editor framework. [north_star]
0 004 Optional `.heml` editor overlays treat `hemx-build` diagnostics and documented `.heml` syntax as authority. They may present compiler-shaped diagnostics, completion, hover, and navigation. [north_star]
### req: diag/007
0 007 Optional `.heml` editor overlays must not own a second template language, formatter, selector model, or custom editor framework. [north_star]
### req: diag/005
005 `.heml` editor startup for VS Code, Cursor, and Neovim must preserve normal HTML or tree-sitter HTML highlighting while using repo-owned `hemx-build` diagnostics through `hemx-lsp` as the shared authority for hemplate-specific feedback. [north_star]
0 005 `.heml` editor startup for VS Code, Cursor, and Neovim must preserve normal HTML or tree-sitter HTML highlighting while using repo-owned `hemx-build` diagnostics through `hemx-lsp` as the shared authority for hemplate-specific feedback. [north_star]
### req: diag/006
006 `hemx-lsp` completion and hover for `.heml` Rust-shaped expressions must use hemx-owned compiler/build facts for derive-known template context fields and simple `h-for` locals; missing or stale facts must fall back to syntax/document completions without proxying rust-analyzer or owning a second Rust type system. [north_star]
0 006 `hemx-lsp` completion and hover for `.heml` Rust-shaped expressions uses hemx-owned compiler/build facts for derive-known template context fields and simple `h-for` locals. Missing or stale facts fall back to syntax/document completions. [north_star]
### req: diag/008
0 008 `hemx-lsp` must not proxy rust-analyzer or own a second Rust type system. [north_star]
---