Files
Claro/docs/WEB_SERVER_PLAN.md
T
Hermes Agent ed23524817 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

1.2 KiB

Claro Web Server Plan

Current release: Claro v2026.10.25.014405

Claro currently has beginner HTTP client commands and offline claro:// test URLs. A web server API is not complete yet.

Ready now

  • HTTP CHECK
  • HTTP GET
  • HTTP SAVE
  • offline claro://hello and related lesson/test URLs
  • LASTHTTP
  • real http:// and https:// requests through curl when available

Web server goals

A beginner web server should make tiny local apps possible without exposing learners to unsafe network defaults.

Desired properties:

  • localhost-only by default
  • readable route syntax
  • simple request/response values
  • friendly port-in-use errors
  • easy stop behavior
  • examples that work offline

Possible future syntax sketch

WEB START LOCAL PORT 8080

WHEN GET "/"
    WEB SAY "Hello from Claro"
END

WEB WAIT

This is a sketch, not a committed syntax.

Needed before implementation

  • route syntax decision
  • request value model
  • response helpers
  • safe defaults for host/port
  • tests for port conflicts and malformed requests
  • docs explaining localhost vs public internet

See also:

  • V1_17_NETWORKING.md
  • CURRENT_STATUS.md
  • ROADMAP.md