Add deep StarLang tutorial and learning graph nodes #2

Merged

lost-rob0t merged 5 commits from tutorial/starlang into main

2026-08-13 04:35:59 +00:00

lost-rob0t commented

2026-08-13 04:35:34 +00:00

(Migrated from github.com)

What this adds

tutorials/starlang-from-zero.org — deep implementation-level StarLang tutorial with runnable Common Lisp / .star examples, debugging playbook, testing workflow, and BBP major project
projects/starlang.org — canonical project node
architecture/starlang-compiler-runtime.org — compiler/runtime call graph and actor architecture
concepts/starlang-spec-libraries.org — spec-library / portable contract concept node
index.org — durable Org-roam links into the new cluster

Source grounding

Authored against current lost-rob0t/star-lang mainline, including the authoritative prototype/ implementation, starlang-prototype.asd, real fixtures, document runtime tests, and public STAR-LANG.API surface.

The tutorial explicitly treats star://domain:address:actor-name as incoming/experimental because that work is currently in StarLang PR #14 rather than main.

Tutorial contract

Uses persistent Org-roam IDs and durable id: links. The tutorial is intentionally mechanism-level: parser, syntax objects, macro expansion, validation, normalized IR, document runtime, actor dispatch, journal/lease/remoting boundaries, debugging, tests, and a hands-on BBP contract project.

## What this adds - `tutorials/starlang-from-zero.org` — deep implementation-level StarLang tutorial with runnable Common Lisp / `.star` examples, debugging playbook, testing workflow, and BBP major project - `projects/starlang.org` — canonical project node - `architecture/starlang-compiler-runtime.org` — compiler/runtime call graph and actor architecture - `concepts/starlang-spec-libraries.org` — spec-library / portable contract concept node - `index.org` — durable Org-roam links into the new cluster ## Source grounding Authored against current `lost-rob0t/star-lang` mainline, including the authoritative `prototype/` implementation, `starlang-prototype.asd`, real fixtures, document runtime tests, and public `STAR-LANG.API` surface. The tutorial explicitly treats `star://domain:address:actor-name` as incoming/experimental because that work is currently in StarLang PR #14 rather than main. ## Tutorial contract Uses persistent Org-roam IDs and durable `id:` links. The tutorial is intentionally mechanism-level: parser, syntax objects, macro expansion, validation, normalized IR, document runtime, actor dispatch, journal/lease/remoting boundaries, debugging, tests, and a hands-on BBP contract project.