cluaupp 1.5.2-cf → 2.0.0-beta.1

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+- **Init template only `game-modern`** — removed `templates/game` from the package; legacy `.clpp` scaffold lives under `test/fixtures/legacy-clpp-game` for tests. `game-modern` adds `Handlers/Guard.server.clp` (Ward boot).
+- **Docs site — CL++ 0.10 Roblox target** — Start, Language, Architecture/CLI, Examples, and all CluauppLibs handbook pages rewritten for `.clp`, `link`, top-level scripts, `@server`/`@client`, and `<<` comments. Site grammar aliases `clp` only; migration page documents legacy `.clpp`/`.clh` as deprecated.
+- **CL++ agent skills** — `skills/clpp-language`, `clpp-style`, `clpp-hive-flare` teach link-only modules and no `void init()` on Roblox; `cluaupp init` still copies them to `.cursor/skills/`.
 - **GetService ownership** — `GetService<T>()` is Cluaupp Roblox Target (registry + `CLUAU_SVC001` + Context Safety + header stubs + postprocess normalize). CL++ only forwards a generic call. New `src/target/get-service.ts`; wired into compile + doctor.
 - **Named `import` host support** — Parse/resolve `import { } from` alongside `#include`; Rojo mapper strips `.clh`/`.clpp`; authority + project graph; game-rooted require rewrite for all services; incremental cache fingerprints imported deps; CompileArtifact `nativeHints`/`layoutHints`/`requires`/`optimize` wired through `clpp api compile`.
 - **CL++ 0.8 floor** — `MIN_CLPP_VERSION` raised to **0.8.0** (refuse older `clpp`). Templates/examples use `import { PlayerTemplate } from` for app modules; angle `#include <clpp/…>` stays for prelude. Named `import` host support, `nativeHints`/`layoutHints`/`requires`, docs pages Option/Result + Cluaupp host.

package/README.md

@@ -4,7 +4,7 @@
   <img src="docs/public/assets/logo.png" alt="Cluaupp" width="160">
 </p>
 
-**CL++ games on Roblox.** You write [CL++](https://kartzrbx.github.io/CLPP/). Cluaupp runs `clpp`, wires Rojo, and copies CluauppLibs.
+**CL++ games on Roblox.** You write [CL++](https://kartzrbx.github.io/CLPP/) in `.clp` files. Cluaupp checks Roblox APIs, emits Luau, wires Rojo, and copies CluauppLibs.
 
 [CL++ language](https://kartzrbx.github.io/CLPP/) · [Docs](https://kartzrbx.github.io/Cluaupp/) · [Why Cluaupp](https://kartzrbx.github.io/Cluaupp/why-cluaupp/) · [Benchmarks](https://kartzrbx.github.io/Cluaupp/benchmarks/) · [Roadmap](https://kartzrbx.github.io/Cluaupp/roadmap/)
 
@@ -12,45 +12,28 @@
 [![Node.js](https://img.shields.io/node/v/cluaupp.svg)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/license-MIT-white.svg)](LICENSE)
 
-Cluaupp is the **Roblox project host** for [CL++](https://kartzrbx.github.io/CLPP/) — not the language compiler and not “roblox-ts with different syntax.” It turns **CL++ + project semantics** into a **validated Roblox project**, then emits Luau. [KartzRbx/CLPP](https://github.com/KartzRbx/CLPP) owns language, checker, Language Server (`clpp setup`), and codegen. Cluaupp owns Rojo/DataModel wiring, Context Safety, Flare remotes, API Registry (`cluaupp api generate`), and CluauppLibs. Optional Luau IntelliSense: **luau-lsp** + Rojo. Never `CL++ → roblox-ts → Luau`. Architecture: [`docs/.../product-pillars.md`](docs/src/content/docs/architecture/product-pillars.md).
+CL++ 0.10 is an independent language with a bytecode VM. Its `clpp` executable does not emit Luau or expose the old `clpp api compile` command. The current experimental Roblox compiler in `src/compiler/` parses `.clp`, checks Roblox APIs and project links, and emits Luau. It is a transitional implementation: the shared-frontend design requires CL++ to provide a versioned Roblox Luau backend. See the [specification review](docs/src/content/docs/architecture/clpp-target-contract.md) for verified semantics and migration gates. [KartzRbx/CLPP](https://github.com/KartzRbx/CLPP) remains the language and desktop VM; Cluaupp owns the Roblox target, Rojo/DataModel wiring, Flare remotes, API Registry, and CluauppLibs. The older `.clpp`/`.clh` pipeline remains available only with a compatible legacy Luau compiler.
 
 Native PascalCase CluauppLibs: **Flare** net, **Sweep** zelador, **Spark** signal, **Keep** data, **Mint** numbers, **Axiom** math, **Roster** tables, **Gleam** UI, **Bloom** effects, **Lens** debug UI, **Crest** topbar, **Pin** billboard, **Stage** viewport 3D, **Coil** spring, **Helm** commands, **Shift** states, **Hive** ECS, **Ward** anti-cheat, **Ember** VFX, **Echo** replication, **Guide** tutorials, **Trace** pretty-print. Schemas pack u8 ids / ColorSequence / tables — never JSON on the hot path. Name map: [`runtime/SOURCES.md`](runtime/SOURCES.md).
 
-```clpp
+```clp
 link @clpp.roblox;
 
-struct HelloServer {
-	void Greet(Player player);
-};
-
-void HelloServer::Greet(Player player) {
+Players players = GetService<Players>();
+players.PlayerAdded ~> func (Player player) {
 	post("Player name: " .: player.Name);
-}
-
-void init() {
-	HelloServer hello;
-	Players players = GetService<Players>();
-
-	for (Player player in players.GetPlayers()) {
-		hello.Greet(player);
-	}
-
-	players.PlayerAdded~>Connect(func (Player playerEntered) {
-		hello.Greet(playerEntered);
-	});
-}
+};
 ```
 
 ## Install
 
-1. [Node.js](https://nodejs.org/) 18+
-2. [Rojo](https://rojo.space/) **7.7.0**
-3. **`clpp` 0.8.0+** on PATH from [CL++](https://github.com/KartzRbx/CLPP/releases) (`clpp-setup.exe` or `clpp setup`; host **refuses** older compilers). Do not leave a cargo `clpp 0.1.0` first on PATH.
+1. [Node.js](https://nodejs.org/) 22.12+
+2. [Rojo](https://rojo.space/) **>=7.7.0 <8.0.0**. Templates pin a reproducible version in rokit.toml.
+3. CL++ 0.10 and its VS Code extension are optional for standalone CL++ work. Cluaupp compiles Roblox `.clp` projects itself.
 
 ```bash
-npm install -g cluaupp@latest
-clpp setup
-npx cluaupp init my-game
+npm install -g cluaupp@next
+cluaupp init my-game
 cd my-game
 rokit install
 cluaupp build
@@ -59,10 +42,11 @@ rojo serve
 
 | Source | Output | Rojo |
 | --- | --- | --- |
-| `*.server.clpp` | `*.server.luau` | Script |
-| `*.client.clpp` | `*.client.luau` | LocalScript |
-| `*.clp` / untagged `.clpp` | `*.luau` | ModuleScript |
-| `*.clh` | `*.luau` | ModuleScript |
+| `*.server.clp` | `*.server.luau` | Script |
+| `*.client.clp` | `*.client.luau` | LocalScript |
+| untagged `*.clp` | `*.luau` | ModuleScript |
+
+The legacy `.clpp`/`.clh` adapter requires `>=0.8.0 <0.9.0` and `contractVersion: 1` in `api manifest`. A version string alone is insufficient; the installed 0.10 VM is incompatible. This adapter policy requires a matching compiler and does not claim that every 0.8 release implements it.
 
 ## CLI
 
@@ -70,22 +54,25 @@ rojo serve
 cluaupp init [folder]
 cluaupp build [folder]
 cluaupp watch [folder]
-cluaupp language          # clpp api manifest
-cluaupp intellisense      # schema highlighting (.flare .hive …) + clpp setup (CL++ LSP)
+cluaupp intellisense      # schema highlighting (.flare .hive …)
 cluaupp api generate      # Registry → headers + lsp-index.json + lock
 cluaupp target info       # schemaVersion, class/enum counts
 cluaupp api aux-diff <p>  # optional coverage vs @rbxts/types / LuauTypes
 ```
 
-**IntelliSense:** CL++ → `clpp` Language Server + Cluaupp `lsp-index.json`. Schemas (`.flare`/…) → Cluaupp editor extension. Emitted Luau → luau-lsp (optional). Cluaupp does not ship a Roblox class IntelliSense engine.
-
-`clpp` missing? Set `CLPP` / `CLPP_PATH` or install [CL++ 0.8.0+](https://github.com/KartzRbx/CLPP/releases).
+**IntelliSense:** The CL++ 0.10 editor extension covers the independent language. Cluaupp's Roblox checker runs during build; schema files use the Cluaupp editor extension. Emitted Luau can use luau-lsp.
 
 ## Language
 
-Course and reference: **[kartzrbx.github.io/CLPP](https://kartzrbx.github.io/CLPP/)**. Write `Player player` (never `Player*`). Default listen is `~>Connect`. Fire with `.Fire`. `@this` only inside `Class::Method`.
+Course and reference: **[kartzrbx.github.io/CLPP](https://kartzrbx.github.io/CLPP/)**. Roblox code adds `link @clpp.roblox;` and service API checks in Cluaupp. Use `.server.clp` and `.client.clp` file tags for script context.
+
+The new project scaffold is in [`templates/game-modern`](templates/game-modern). Existing `.clpp` projects can still use the legacy compiler path during migration. Toolchain docs (Starlight): `npm run site:dev`.
+
+## Preparing a beta release
+
+The maintainer gate runs `npm run setup:runtime`, regenerates the API projections and verifies their lock before tests. It downloads the official Luau 0.741 interpreter, analyzer and compiler into the ignored `.cluaupp/toolchains` directory and verifies pinned SHA-256 checksums. Rokit installs the interpreter but does not expose the complete analyzer/compiler bundle required by these tests. Runtime test tools are not consumer dependencies.
 
-Exclusive CL++ (`guard`, `match`, `signal`, `observable`, `.:`, `::`, Fusion) is compiled by `clpp`. Samples: [`examples/game`](examples/game). Old C++ games: [migration](docs/src/content/docs/migration.md). Toolchain docs (Starlight): `npm run site:dev`.
+Run `npm run prepublishOnly` to check a release without publishing. Publish an unused prerelease version with `npm publish --tag next`. The experimental compiler and remaining validation limits are described in the specification review above.
 
 ## License
 

package/api/generated/bench-latest.json

@@ -1,5 +1,5 @@
 {
-	"measuredAt": "2026-09-22T13:24:47.067Z",
+	"measuredAt": "2026-10-02T11:17:54.881Z",
 	"node": "v24.20.0",
 	"platform": "win32",
 	"registry": {
@@ -11,29 +11,51 @@
 		"methods": 3282,
 		"events": 1092,
 		"threadSafety": 8462,
-		"buildMs": 352,
-		"regMs": 39,
-		"lspMs": 306,
-		"totalMs": 697
+		"buildMs": 152,
+		"regMs": 19,
+		"lspMs": 121,
+		"totalMs": 291
 	},
 	"gameBuild": {
-		"cold": {
-			"ms": 3719,
+		"sources": 3,
+		"first": {
+			"ms": 816,
 			"status": 0,
-			"cacheHit": null,
-			"parallel": "8"
+			"generated": 3,
+			"error": null
 		},
-		"fill": {
-			"ms": 3477,
-			"status": 0,
-			"cacheHit": null,
-			"parallel": "8"
-		},
-		"warm": {
-			"ms": 1506,
-			"status": 0,
-			"cacheHit": "7/7",
-			"parallel": null
-		}
+		"repeats": [
+			{
+				"ms": 721,
+				"status": 0,
+				"generated": 0,
+				"error": null
+			},
+			{
+				"ms": 683,
+				"status": 0,
+				"generated": 0,
+				"error": null
+			},
+			{
+				"ms": 698,
+				"status": 0,
+				"generated": 0,
+				"error": null
+			},
+			{
+				"ms": 664,
+				"status": 0,
+				"generated": 0,
+				"error": null
+			},
+			{
+				"ms": 733,
+				"status": 0,
+				"generated": 0,
+				"error": null
+			}
+		],
+		"medianMs": 698
 	}
 }