fix: harden Claro diagnostics and runtime guards

Preserve source locations, validate malformed JSON, and add opt-in resource limits. Include executable error-guide coverage, learner pilot materials, native Windows acceptance helpers, and updated CI/documentation.
2026-10-25 02:42:53 +00:00
parent bf230f354e
commit ed23524817
42 changed files with 1128 additions and 176 deletions
@@ -59,6 +59,18 @@ and test formatting, numeric boundaries, and simple functions. Do not introduce
 C99 syntax or depend on generated project headers. See [C89 notes](docs/C89.md).


+## Learning-first charter
+
+Claro is a learning tool first and a general-purpose language second. Keep the
+core small, predictable, and beginner-focused; prioritize executable lessons,
+useful diagnostics, and reliability over feature breadth. Teach one recommended
+spelling per concept while preserving supported compatibility forms. Do not
+claim accessibility validation without feedback from intended learners. The
+[learning-first charter](docs/LEARNING_FIRST.md) is the current product guidance.
+Older ambitious plans are retained as historical context, not active priorities;
+they do not imply that existing features are removed. See the current
+[learning-first roadmap](docs/ROADMAP.md).
+
 ## Beginner syntax consistency

 Follow [the syntax guide](docs/SYNTAX.md) in introductory teaching material.