slhx agent
df0fabd4fb
Add repo-local northstars and ready slices for testing strategy, LSP/editor completion, and hemplate highlighting boundaries.
2.1 KiB
2.1 KiB
id, type, status, title, refs
| id | type | status | title | refs | ||||
|---|---|---|---|---|---|---|---|---|
| NS-0003 | northstar | ready | Hemplate highlighting and editor grammar boundary |
|
Objective
Make .heml highlighting predictable in editors by defining the repo-owned highlighting boundary: HTML/tree-sitter remains the base, hemplate overlays cover only the documented syntax facts, and diagnostics/completion stay owned by hemx-build/hemx-lsp.
Authority
docs/editor-support.mdsays.hemlshould keep normal HTML highlighting and layer hemx-specific editor support on top.docs/hemplate-syntax.mddefines escaped/trusted text, dynamic attributes, control flow, generated hemx targets, and boundaries.REQUIREMENTS.mddiagnostics/004throughdiagnostics/008require optional overlays to share authority withhemx-buildand avoid a second template language or custom editor framework.
Close when
- Highlighting ownership is explicit: repo-owned fixtures/queries can cover documented hemplate tokens, while external editor distribution remains a separate slice or blocker.
- Tree-sitter work is bounded to syntax highlighting/injection facts and never owns diagnostics, completion, formatting, Rust type checking, or template validation.
- Ready slices distinguish repo-testable grammar/query behavior from editor packaging/publishing work that may require external authority.
Verification
work checkwork list- Later implementation slices should use repo-owned fixture/query tests where available; provider-specific visual/manual checks must name the editor and blocker.
Non-goals
- Do not create a second
.hemlparser for hemx-build. - Do not make highlighting responsible for compiler diagnostics, completion, hover, formatting, or generated Rust facts.
- Do not publish editor extensions or tree-sitter packages without explicit release authority.
Evidence
- Current docs already frame
.hemlas HTML first with a small hemplate overlay. - No current repo authority grants external package publishing; that is represented as a separate blocked/future slice rather than assumed.