Skip to content

Latest commit

 

History

History
33 lines (23 loc) · 3.46 KB

roadmap.md

File metadata and controls

33 lines (23 loc) · 3.46 KB

Learning roadmap and feature gates

This page separates course design from compiler implementation. A planned lesson is not an executable feature.

Learning area Course position Publication gate
Output, bindings, arithmetic, booleans Basics Working compiler fixtures and passing CI
if/elif/else, while, repeat Control flow Working compiler fixtures and passing CI
Typed functions and recursion Functions Working compiler fixtures and passing CI
Numeric vectors, windows, matrices Collections / AI foundations Working compiler fixtures and passing CI
Source modules and imports Modules Working compiler fixtures and passing CI
Unicode text construction, slicing and repetition Basics Published alpha.3 implementation, retained in alpha.5 and passing exact-output CI
Stable root mean square on numeric vectors Collections Published Scarp alpha.6, exact-output fixture and CI
Read-only symbol/reference inspection Developer CLI Published Scarp alpha.6, schema-v1 smoke tests and bilingual tutorial
Generic lists, maps, sets, records Future Compiler implements and tests the complete construct
Structured errors and propagation Future Compiler ships a tested public syntax and runtime semantics
Async, concurrency, networking Future Tested runtime APIs and deterministic, safe demonstrations
Agents, inference tooling and model training Future Explicitly implemented APIs, repeatable local tests and honest limitations

Developer CLI

Published alpha.5 and retained in alpha.6: The official compiler continues to support offline Scarp.project directories with create, static project verify, and interpreter-backed launch. See the English tutorial and हिन्दी. Alpha.5 additionally supports read-only project-directory module inspection with scarp inspect modules --json DIRECTORY; English and हिन्दी tutorials show the actual module graph. This is a development manifest, not a package manager or native compiler. Alpha.5 also exposes a limited C11 emitter through Rust embedding APIs only; it does not ship scarp compile.

The compiler-tested source-navigation workshop demonstrates shadowing, named arguments and imported declarations with a two-file project. Its bilingual learning page does not simulate execution.

The pinned prerelease CLI is taught in separate English and Hindi guides, backed by real-command smoke tests. Inspection metadata is not treated as a runnable .srp lesson; native compilation, an LSP and package tools remain outside the current verified feature set.

Website

The static, searchable learning catalog is deployed using GitHub Actions after validating all runnable examples with the pinned compiler. Source lessons and CI remain authoritative. Browser-based Scarp execution and richer interactivity are future enhancements; English/Hindi companion guides already cover every published lesson, and the catalog must not present unimplemented syntax as runnable.

See feature matrix for upstream implementation status.