docs: clarify Claro v1 status and validation

This commit is contained in:
Hermes Agent
2026-06-07 03:03:13 -06:00
parent 0da1095c03
commit 1e0ea06d21
74 changed files with 2351 additions and 336 deletions
+39
View File
@@ -0,0 +1,39 @@
# Claro Editor and IDE Support Plan
Current release: **Claro v1.18.26**
Claro has an IDE metadata/helper foundation. It does not yet have a complete editor extension or LSP experience.
## Ready now
- `claro ide`
- metadata JSON
- completion list
- diagnostics helper
- formatter/checker commands that editor tools can call
## Goal
Give beginners fast, friendly feedback while they type, without requiring them to understand compiler internals.
## Suggested phases
1. Syntax highlighting grammar for `.claro` files.
2. Editor snippets for common beginner patterns.
3. On-save `claro check` diagnostics.
4. Formatter integration.
5. Hover help from command metadata.
6. Code actions for common mistakes such as `PRNT` -> `SAY`.
7. LSP server only after the metadata and diagnostics formats are stable.
## Beginner safety rules
- Messages should explain the fix, not just the error.
- Suggestions should prefer modern simple syntax.
- Editor tooling should never run network commands unless the user explicitly asks.
- Lessons should still work from the terminal without an editor extension.
See also:
- `IDE.md`
- `CURRENT_STATUS.md`
- `ROADMAP.md`