Production Readiness Roadmap

This page defines the stable strategic roadmap for production readiness.

Current implementation status is tracked in: - Production Progress Log

Milestone 0: Core Runtime and Tooling Foundation

  • [x] Core language parser/runtime (set, put, if, repeat, handlers, tell)
  • [x] tell application integration with model-based host runtime
  • [x] Advanced event handlers (on <verb> <subject> ... end <verb>)
  • [x] Tree-sitter grammar scaffold + highlighting queries
  • [x] VS Code extension scaffold
  • [x] LSP diagnostics (didOpen/didChange/didSave)
  • [x] LSP document symbols
  • [x] LSP basic completions (keywords, builtins, scope variables)
  • [x] Dictionary-backed tell completions from .hyperphp/models.json
  • [~] Zed support (highlighting scaffold present, LSP bridge pending)

Milestone 1: Reliability and Failure Semantics

  • [x] try ... on error ... end try
  • [x] error command support with structured payload
  • [x] Runtime call stack in errors (handler/tell chain + line/column)
  • [x] Configurable execution limits (timeout, loop cap, recursion/call-depth cap)
  • [ ] Strict mode toggle for runtime behavior and unknown host members

Milestone 2: Language and Scope Completeness

  • [ ] property, global, local declarations
  • [ ] Handler labeled parameters (AppleScript-style forms)
  • [ ] Command-style invocation with labeled arguments
  • [ ] Richer comparison/coercion edge-case behavior
  • [ ] Additional AppleScript-like syntax from gaps doc (considering/ignoring)

Milestone 3: Host Contract and IntelliSense Maturity

  • [ ] Stable dictionary schema versioning (.hyperphp/models.json)
  • [ ] CLI dictionary exporter from registered PHP applications/models
  • [ ] Host-aware completion quality improvements (args/signatures/types)
  • [ ] LSP hover and signature help
  • [ ] LSP go-to-definition for handlers/locals

Milestone 4: Team-Grade Delivery

  • [ ] Formatter (hyperfmt) and formatting LSP endpoint
  • [ ] Versioned language compatibility profiles
  • [ ] Migration/deprecation warnings across language versions
  • [ ] Packaging/import strategy for reusable scripts
  • [ ] CI profile for script determinism and policy checks

Priority Order

  1. Milestone 1 (reliability and safe failure modes)
  2. Milestone 3 (host contract and editor intelligence)
  3. Milestone 2 (language completeness)
  4. Milestone 4 (team-scale delivery concerns)

Status Legend

  • [x] complete
  • [~] partially complete
  • [ ] not started

Keep milestone checkboxes in this roadmap updated, and append dated updates in production-progress-log.md in the same PR.