cluaupp 2.0.0-beta.1 → 2.0.0-beta.2

package/api/manifests/roblox-target.manifest.json

@@ -1,22 +1,22 @@
 {
 	"schemaVersion": 2,
-	"generatorVersion": "2.0.0-beta.1",
-	"profileHash": "1f6a8b3a31a8e75c98b411542f4a82e3057496da51301fc00d2d88ae04d8bf7e",
+	"generatorVersion": "2.0.0-beta.2",
+	"profileHash": "dd9f48a67175481b1270c36bbb55a1b7d22e9290f8d3e6475b2b37682242300d",
 	"overridesHash": "4d9132f0307a553e92b8863663295b0ddb9fc7cad57db75a8fb7b7d1ab258f46",
 	"sources": {
 		"mini-api-dump": {
 			"id": "mini-api-dump",
 			"path": "C:\\Users\\gtofr\\OneDrive\\Documentos\\GitHub\\Cluaupp\\data\\Mini-API-Dump.json",
 			"hash": "e73d0118d5fc9f134c6d8306fabecc14050ba87f3bb89ca950b0e44077283256",
-			"loadedAt": "2026-10-09T13:01:56.828Z",
+			"loadedAt": "2026-10-09T13:42:19.577Z",
 			"version": 1
 		},
 		"overrides": {
 			"id": "overrides",
 			"hash": "4d9132f0307a553e92b8863663295b0ddb9fc7cad57db75a8fb7b7d1ab258f46",
-			"loadedAt": "2026-10-09T13:01:57.025Z",
+			"loadedAt": "2026-10-09T13:42:19.676Z",
 			"path": "C:\\Users\\gtofr\\OneDrive\\Documentos\\GitHub\\Cluaupp\\api\\overrides"
 		}
 	},
-	"generatedAt": "2026-10-09T13:01:58.817Z"
+	"generatedAt": "2026-10-09T13:42:21.235Z"
 }

package/api/normalized/roblox-target.profile.json

@@ -2,19 +2,19 @@
 	"target": "roblox",
 	"schemaVersion": 2,
 	"robloxApiVersion": "1",
-	"generatorVersion": "2.0.0-beta.1",
+	"generatorVersion": "2.0.0-beta.2",
 	"sources": {
 		"mini-api-dump": {
 			"id": "mini-api-dump",
 			"path": "C:\\Users\\gtofr\\OneDrive\\Documentos\\GitHub\\Cluaupp\\data\\Mini-API-Dump.json",
 			"hash": "e73d0118d5fc9f134c6d8306fabecc14050ba87f3bb89ca950b0e44077283256",
-			"loadedAt": "2026-10-09T13:01:56.828Z",
+			"loadedAt": "2026-10-09T13:42:19.577Z",
 			"version": 1
 		},
 		"overrides": {
 			"id": "overrides",
 			"hash": "4d9132f0307a553e92b8863663295b0ddb9fc7cad57db75a8fb7b7d1ab258f46",
-			"loadedAt": "2026-10-09T13:01:57.025Z",
+			"loadedAt": "2026-10-09T13:42:19.676Z",
 			"path": "C:\\Users\\gtofr\\OneDrive\\Documentos\\GitHub\\Cluaupp\\api\\overrides"
 		}
 	},

package/api/roblox-api.lock.json

@@ -1,6 +1,6 @@
 {
 	"schemaVersion": 2,
-	"profileHash": "1f6a8b3a31a8e75c98b411542f4a82e3057496da51301fc00d2d88ae04d8bf7e",
+	"profileHash": "dd9f48a67175481b1270c36bbb55a1b7d22e9290f8d3e6475b2b37682242300d",
 	"overridesHash": "4d9132f0307a553e92b8863663295b0ddb9fc7cad57db75a8fb7b7d1ab258f46",
 	"robloxApiVersion": "1",
 	"files": {
@@ -13,6 +13,6 @@
 		"api/generated/luau/datatypes.d.luau": "555ce875e7c491a5a3c2eb90c4c2db7b56c7d3d41f10d9a7c2c667eb07f4fccc",
 		"api/generated/luau/classes.d.luau": "b1faf83c53c88217370094764d5e1f6a30a05501dd916f1b759ac37cb590e6b8",
 		"api/generated/luau/globals.d.luau": "44673b0daa8306aa2dd2e7c08c0c97c6e18a51926b00237ce0f1d262821d0f35",
-		"api/generated/lsp-index.json": "a0c5c91fa6be7348489ad473af3f8c442e6f184a037808c60ebe36aa058f3fef"
+		"api/generated/lsp-index.json": "ba3190b92e8b38bb8e48dddca31712f3bfc15de59d475d2f810be84b4134ef28"
 	}
 }

package/editors/vscode/README.md

@@ -16,4 +16,4 @@ Installed by `cluaupp intellisense` into `~/.cursor/extensions` and `~/.vscode/e
 | `.shift` | states / transitions | snippets |
 | `.axiom` | groups | snippets |
 
-CL++ (`.clpp` / `.clp` / `.clh`) highlighting still comes from `clpp setup`.
+CL++ .clp language support is installed separately through the CL++ editor extension. The clpp 0.10 VM has no setup or install subcommand. Legacy .clpp/.clh associations are retained for older projects.

package/editors/vscode/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "cluaupp-flare",
 	"displayName": "Cluaupp",
-	"description": "Highlighting and IntelliSense for Cluaupp schemas: .flare, .hive, .mint, .bloom, .helm, .shift, .axiom. CL++ (.clpp) still comes from clpp setup.",
+	"description": "Highlighting and IntelliSense for Cluaupp schemas: .flare, .hive, .mint, .bloom, .helm, .shift, .axiom. CL++ language support is installed separately.",
 	"version": "1.5.1",
 	"publisher": "kartzdev",
 	"engines": {
@@ -37,8 +37,13 @@
 		"languages": [
 			{
 				"id": "flare",
-				"aliases": ["Flare", "flare"],
-				"extensions": [".flare"],
+				"aliases": [
+					"Flare",
+					"flare"
+				],
+				"extensions": [
+					".flare"
+				],
 				"configuration": "./language-configuration.json",
 				"icon": {
 					"light": "./icons/flare.svg",
@@ -47,8 +52,13 @@
 			},
 			{
 				"id": "hive",
-				"aliases": ["Hive", "hive"],
-				"extensions": [".hive"],
+				"aliases": [
+					"Hive",
+					"hive"
+				],
+				"extensions": [
+					".hive"
+				],
 				"configuration": "./language-configuration-schema.json",
 				"icon": {
 					"light": "./icons/hive.svg",
@@ -57,8 +67,13 @@
 			},
 			{
 				"id": "mint",
-				"aliases": ["Mint", "mint"],
-				"extensions": [".mint"],
+				"aliases": [
+					"Mint",
+					"mint"
+				],
+				"extensions": [
+					".mint"
+				],
 				"configuration": "./language-configuration-schema.json",
 				"icon": {
 					"light": "./icons/mint.svg",
@@ -67,8 +82,13 @@
 			},
 			{
 				"id": "bloom",
-				"aliases": ["Bloom", "bloom"],
-				"extensions": [".bloom"],
+				"aliases": [
+					"Bloom",
+					"bloom"
+				],
+				"extensions": [
+					".bloom"
+				],
 				"configuration": "./language-configuration-schema.json",
 				"icon": {
 					"light": "./icons/bloom.svg",
@@ -77,8 +97,13 @@
 			},
 			{
 				"id": "helm",
-				"aliases": ["Helm", "helm"],
-				"extensions": [".helm"],
+				"aliases": [
+					"Helm",
+					"helm"
+				],
+				"extensions": [
+					".helm"
+				],
 				"configuration": "./language-configuration-schema.json",
 				"icon": {
 					"light": "./icons/helm.svg",
@@ -87,8 +112,13 @@
 			},
 			{
 				"id": "shift",
-				"aliases": ["Shift", "shift"],
-				"extensions": [".shift"],
+				"aliases": [
+					"Shift",
+					"shift"
+				],
+				"extensions": [
+					".shift"
+				],
 				"configuration": "./language-configuration-schema.json",
 				"icon": {
 					"light": "./icons/shift.svg",
@@ -97,8 +127,13 @@
 			},
 			{
 				"id": "axiom",
-				"aliases": ["Axiom", "axiom"],
-				"extensions": [".axiom"],
+				"aliases": [
+					"Axiom",
+					"axiom"
+				],
+				"extensions": [
+					".axiom"
+				],
 				"configuration": "./language-configuration-schema.json",
 				"icon": {
 					"light": "./icons/axiom.svg",

package/editors/vscode/snippets/flare.json

@@ -22,6 +22,6 @@
 	"opt name": {
 		"prefix": "opt",
 		"body": "opt name = ${1:Net}",
-		"description": "Generated module name (Net.clh / Net.Hit)"
+		"description": "Generated module name (Net runtime module / Net.Hit)"
 	}
 }

package/editors/vscode/snippets/hive.json

@@ -2,7 +2,7 @@
 	"opt name": {
 		"prefix": "opt",
 		"body": "opt name = ${1:PlayerECS}",
-		"description": "Generated module name (PlayerECS.clh / PlayerECS.Health)"
+		"description": "Generated module name (PlayerECS runtime module / PlayerECS.Health)"
 	},
 	"Component": {
 		"prefix": "component",

package/generated/api-cli.js

@@ -30,7 +30,7 @@ function registerApiCommands(program) {
         .command("generate")
         .description("Build RobloxTargetProfile and regenerate CL++ / Luau projections")
         .option("--dump <path>", "Mini-API-Dump.json path")
-        .option("--skip-headers", "Skip CL++ header generation")
+        .option("--skip-headers", "Skip legacy .clh API projections")
         .option("--skip-luau", "Skip .d.luau generation")
         .option("--docs", "No-op retained for CLI compat (Creator Docs are not mirrored)")
         .action((opts) => {
@@ -183,7 +183,7 @@ function registerTargetCommands(program) {
     });
     target
         .command("datamodel")
-        .description("Build Typed DataModel profile + generated datamodel.clh from Rojo project")
+        .description("Build Typed DataModel profile (legacy projects also get .clh)")
         .argument("[folder]", "game root with default.project.json", ".")
         .option("-r, --rojo <path>", "Rojo project json")
         .action((folder, options) => {

package/generated/cli.js

@@ -12,7 +12,6 @@ const node_path_1 = __importDefault(require("node:path"));
 const package_info_js_1 = require("./package-info.js");
 const lsp_js_1 = require("./lsp.js");
 const paths_js_1 = require("./clpp/paths.js");
-const contract_js_1 = require("./clpp/contract.js");
 const runner_js_1 = require("./clpp/runner.js");
 Object.defineProperty(exports, "hasClpp", { enumerable: true, get: function () { return runner_js_1.hasClpp; } });
 const intellisense_js_1 = require("./intellisense.js");
@@ -101,7 +100,8 @@ program
 });
 program
     .command("lsp")
-    .description("Language server stdio — Flare `.flare` IntelliSense. CL++ still uses `clpp setup`.")
+    .description("Schema language server over stdio")
+    .option("--stdio", "Use standard input/output (default)")
     .argument("[folder]", "project folder", ".")
     .action((folder) => {
     (0, lsp_js_1.start)({ projectRoot: node_path_1.default.resolve(process.cwd(), folder) });
@@ -109,7 +109,7 @@ program
 program
     .command("intellisense")
     .alias("intelisense")
-    .description("Install schema IntelliSense (.flare .hive .mint .bloom .helm .shift .axiom) + sync .vscode; CL++ via clpp install")
+    .description("Install schema editor support and sync .vscode")
     .argument("[folder]", "project folder", ".")
     .action(async (folder) => {
     try {
@@ -117,7 +117,6 @@ program
         (0, intellisense_js_1.syncEditorSupport)(root, (0, project_js_1.loadConfig)(root));
         await (0, intellisense_js_1.installEditorSupport)();
         console.log("cluaupp: editor associations written in", root);
-        console.log("cluaupp:", contract_js_1.CLPP_INSTALL_HINT);
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : err);
@@ -126,20 +125,22 @@ program
 });
 program
     .command("language")
-    .description("CL++ manifest (`clpp api manifest`)")
-    .action(() => {
+    .description("Describe the Roblox .clp target; --legacy probes external clpp")
+    .option("--legacy", "Read the manifest of the compatible legacy compiler")
+    .action((options) => {
     try {
-        const bin = (0, runner_js_1.resolveClppBinary)();
-        const version = (0, runner_js_1.clppVersion)();
-        if (version) {
-            console.log(version, `(${bin})`);
-        }
-        for (const install of (0, runner_js_1.clppInstalls)()) {
-            if (!install.selected) {
-                console.log(`skipped ${install.bin} (${install.version || "unknown"})`);
-            }
-        }
-        console.log(JSON.stringify((0, runner_js_1.clppManifest)(), null, "\t"));
+        const manifest = options.legacy ? (0, runner_js_1.clppManifest)() : {
+            name: "Cluaupp Roblox target",
+            version: package_info_js_1.pkg.version,
+            status: "experimental",
+            sourceExtensions: [".clp"],
+            fileTags: { server: ".server.clp", client: ".client.clp", plugin: ".plugin.clp" },
+            importSyntax: "link",
+            headers: false,
+            builtinLinks: ["@clpp.roblox", "@clpp.libs.<Library>"],
+            legacy: { sourceExtensions: [".clpp", ".clh"], command: "cluaupp language --legacy" },
+        };
+        console.log(JSON.stringify(manifest, null, "\t"));
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : err);

package/generated/compiler/project.js

@@ -283,7 +283,7 @@ class ProjectCompiler {
             target = `${target}.clp`;
         }
         if (!target.toLowerCase().endsWith(exports.SOURCE_EXT)) {
-            return { kind: "error", message: `cannot link '${p}': CL++ modules are .clp files`, notes: [/\.(clh|clpp)$/i.test(p) ? "CL++ 0.9 has no headers: rename the module to .clp" : "link \"./file.clp\" as Name;"] };
+            return { kind: "error", message: `cannot link '${p}': CL++ modules are .clp files`, notes: [/\.(clh|clpp)$/i.test(p) ? "Legacy .clh/.clpp files use a different syntax: migrate the declarations and imports to .clp; changing the extension alone is insufficient" : "link \"./file.clp\" as Name;"] };
         }
         if (!node_fs_1.default.existsSync(target)) {
             return { kind: "error", message: `cannot open module '${p}'` };

package/generated/intellisense.js

@@ -13,8 +13,6 @@ const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_child_process_1 = require("node:child_process");
 const package_info_js_1 = require("./package-info.js");
-const contract_js_1 = require("./clpp/contract.js");
-const runner_js_1 = require("./clpp/runner.js");
 const paths_js_1 = require("./clpp/paths.js");
 const editor_install_js_1 = require("./editor-install.js");
 function copyDir(from, to) {
@@ -111,7 +109,7 @@ function writeVscode(root) {
     });
 }
 function diagnosticsFor(_source, _fileName) {
-    // Language diagnostics belong to `clpp install`. Do not spawn `clpp api compile`
+    // CL++ diagnostics are reported by the compiler during build. Do not spawn a compiler
     // from the editor — that duplicates source=clpp and freezes on every keystroke.
     return [];
 }
@@ -198,18 +196,6 @@ async function installEditorSupport() {
             console.log(" ", dest);
         }
     }
-    if ((0, runner_js_1.hasClpp)()) {
-        const result = (0, node_child_process_1.spawnSync)("clpp", ["install"], { encoding: "utf8", windowsHide: true });
-        if (result.status === 0) {
-            console.log(String(result.stderr || result.stdout || "clpp install ok").trim());
-        }
-        else {
-            console.log("cluaupp:", contract_js_1.CLPP_INSTALL_HINT);
-        }
-    }
-    else {
-        console.log("cluaupp:", contract_js_1.CLPP_INSTALL_HINT);
-    }
     return { local };
 }
 exports.isClppSource = paths_js_1.isSourceFile;

package/generated/lsp.js

@@ -34,7 +34,7 @@ function flareDiagnostics(document) {
     }));
 }
 function start(_options = {}) {
-    const connection = (0, node_1.createConnection)(node_1.ProposedFeatures.all);
+    const connection = (0, node_1.createConnection)(node_1.ProposedFeatures.all, process.stdin, process.stdout);
     const documents = new node_1.TextDocuments(vscode_languageserver_textdocument_1.TextDocument);
     connection.onInitialize(() => ({
         capabilities: {

package/generated/target/datamodel-generate.js

@@ -12,6 +12,7 @@ exports.writeDatamodelArtifacts = writeDatamodelArtifacts;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const datamodel_js_1 = require("./datamodel.js");
+const paths_js_1 = require("../clpp/paths.js");
 function safeIdent(name) {
     const cleaned = name.replace(/[^A-Za-z0-9_]/g, "_");
     return /^[A-Za-z_]/.test(cleaned) ? cleaned : `_${cleaned}`;
@@ -66,6 +67,17 @@ function writeDatamodelArtifacts(projectRoot, opts) {
     node_fs_1.default.mkdirSync(outDir, { recursive: true });
     const profilePath = node_path_1.default.join(outDir, "datamodel-profile.json");
     node_fs_1.default.writeFileSync(profilePath, JSON.stringify(profileWithoutIndex(profile), null, "\t") + "\n", "utf8");
+    let sourceRoot = "src";
+    const configPath = node_path_1.default.join(projectRoot, "cluaupp.config.json");
+    if (node_fs_1.default.existsSync(configPath)) {
+        const config = JSON.parse(node_fs_1.default.readFileSync(configPath, "utf8"));
+        if (typeof config.rootDir === "string")
+            sourceRoot = config.rootDir;
+    }
+    const sources = (0, paths_js_1.collectSources)(node_path_1.default.resolve(projectRoot, sourceRoot));
+    const modern = sources.some(file => /\.clp$/i.test(file)) && !sources.some(file => /\.clpp$/i.test(file));
+    if (modern && !opts?.headerPath)
+        return { profile, profilePath, headerPath: null };
     const headerPath = opts?.headerPath ||
         node_path_1.default.join(projectRoot, "include", "clpp", "generated", "datamodel.clh");
     node_fs_1.default.mkdirSync(node_path_1.default.dirname(headerPath), { recursive: true });

package/generated/utils/project.js

@@ -325,6 +325,10 @@ function compileOptions(root, config, file, rel) {
         outDir: config.outDir,
     };
 }
+function needsLegacyHeaders(srcDir) {
+    const sources = (0, paths_js_1.collectSources)(srcDir);
+    return sources.some(file => /\.clpp$/i.test(file)) || !sources.some(file => /\.clp$/i.test(file));
+}
 function compileSchemaJobs(root, config, srcDir) {
     const jobs = [];
     const errors = [];
@@ -339,7 +343,8 @@ function compileSchemaJobs(root, config, srcDir) {
             if (!(0, safe_paths_js_1.isInside)(node_path_1.default.resolve(root, config.rootDir), headerDest) && !(0, safe_paths_js_1.isInside)(srcDir, headerDest)) {
                 throw new Error(`cluaupp schema: skip unsafe header ${emit.headerRel}`);
             }
-            writeTextIfChanged(headerDest, emit.header);
+            if (needsLegacyHeaders(srcDir))
+                writeTextIfChanged(headerDest, emit.header);
             jobs.push({
                 rel,
                 files: [{ name: emit.luauRel, contents: emit.luau }],
@@ -367,7 +372,8 @@ function compileFlareJobs(root, config, srcDir) {
             if (!(0, safe_paths_js_1.isInside)(node_path_1.default.resolve(root, config.rootDir), headerDest) && !(0, safe_paths_js_1.isInside)(srcDir, headerDest)) {
                 throw new Error(`cluaupp flare: skip unsafe header ${emit.headerRel}`);
             }
-            writeTextIfChanged(headerDest, emit.header);
+            if (needsLegacyHeaders(srcDir))
+                writeTextIfChanged(headerDest, emit.header);
             jobs.push({
                 rel,
                 files: [{ name: emit.luauRel, contents: emit.luau }],
@@ -631,7 +637,10 @@ function writeJobs(root, config, jobs, format) {
 }
 function ensureVendor(root) {
     copyRuntime(root);
-    copyHeaders(root);
+    const config = loadConfig(root);
+    if ((0, paths_js_1.collectSources)(node_path_1.default.join(root, config.rootDir)).some(file => /\.clpp$/i.test(file))) {
+        copyHeaders(root);
+    }
 }
 function finishBuild(root, config, compiled, options) {
     const exitOnError = options.exitOnError !== false;
@@ -760,10 +769,15 @@ async function buildAsync(root, options = {}) {
 }
 async function init(dest) {
     const target = (0, safe_paths_js_1.assertInitDest)(dest);
+    if (node_fs_1.default.existsSync(node_path_1.default.join(target, "cluaupp.config.json")) || node_fs_1.default.existsSync(node_path_1.default.join(target, "src"))) {
+        throw new Error("cluaupp init: project already exists; choose a new folder. Existing .clpp/.clh sources require migration, not another init.");
+    }
     const template = node_path_1.default.join(__dirname, "..", "..", "templates", "game-modern");
-    const include = node_path_1.default.join(__dirname, "..", "..", "include");
     copyDir(template, target);
-    copyDir(include, node_path_1.default.join(target, "include"));
+    const packageFile = node_path_1.default.join(target, "package.json");
+    const projectPackage = JSON.parse(node_fs_1.default.readFileSync(packageFile, "utf8"));
+    projectPackage.devDependencies = { ...projectPackage.devDependencies, cluaupp: package_info_js_1.pkg.version };
+    node_fs_1.default.writeFileSync(packageFile, JSON.stringify(projectPackage, null, "\t") + "\n");
     const skills = node_path_1.default.join(__dirname, "..", "..", "skills");
     if (node_fs_1.default.existsSync(skills)) {
         copyDir(skills, node_path_1.default.join(target, ".cursor", "skills"));
@@ -777,7 +791,8 @@ async function init(dest) {
     console.log("  CL++ 0.10 editor extension provides syntax highlighting; Cluaupp compiles Roblox .clp files");
     console.log("  cluaupp intellisense  (schema .flare .hive .mint .bloom .helm .shift .axiom)");
     console.log("  rokit install");
-    console.log("  cluaupp build");
+    console.log("  npm install");
+    console.log("  npm run build");
     console.log("  rojo serve");
 }
 function pidAlive(pid) {

package/include/README.md

@@ -0,0 +1,5 @@
+# Legacy CL++ headers
+
+The .clh files in this directory use the legacy .clpp compiler syntax. They are preserved for the explicit legacy adapter and API projection tests. They are not modules for modern .clp programs, and modern cluaupp init and build do not copy them into a project.
+
+Modern Roblox code uses link @clpp.roblox; and libraries use link @clpp.libs.Ward as Ward; (replace Ward with the runtime library). The API types come from the registry. Changing .clh to .clp does not migrate the syntax. Generated schema bindings still need modern type projections; legacy headers are not advertised as modern bindings.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cluaupp",
-	"version": "2.0.0-beta.1",
+	"version": "2.0.0-beta.2",
 	"description": "Roblox target for CL++: compile .clp to Luau with Rojo and CluauppLibs.",
 	"author": "KartzDev",
 	"license": "MIT",
@@ -47,7 +47,7 @@
 		"dev:cli": "tsx src/cli.ts",
 		"prepare": "tsc",
 		"postinstall": "node scripts/postinstall-native.js && node scripts/postinstall-editor.js",
-		"test": "node test/handshake.test.js && node test/source-map.test.js && node test/cache-invalidation.test.js && node test/package.test.js && node test/security.test.js && node test/understander.test.js && node test/modern-clp.test.js && node test/out.test.js && node test/types.test.js && node test/modules.test.js && node test/modules-import.test.js && node test/gen-rojo-tree.test.js && node test/get-service.test.js && node test/clpp.test.js && node test/flare.test.js && node test/native.test.js && node test/postprocess.test.js && node test/api.test.js && node test/api-reuse.test.js && node test/context-safety.test.js && node test/datamodel.test.js && node test/platform-analyzers.test.js && node test/platform-extras.test.js && node test/generator.test.js && node test/studio/smoke.test.js",
+		"test": "node test/cli-modern.test.js && node test/handshake.test.js && node test/source-map.test.js && node test/cache-invalidation.test.js && node test/package.test.js && node test/security.test.js && node test/understander.test.js && node test/modern-clp.test.js && node test/out.test.js && node test/types.test.js && node test/modules.test.js && node test/modules-import.test.js && node test/gen-rojo-tree.test.js && node test/get-service.test.js && node test/clpp.test.js && node test/flare.test.js && node test/native.test.js && node test/postprocess.test.js && node test/api.test.js && node test/api-reuse.test.js && node test/context-safety.test.js && node test/datamodel.test.js && node test/platform-analyzers.test.js && node test/platform-extras.test.js && node test/generator.test.js && node test/studio/smoke.test.js",
 		"test:clpp-contract": "node test/clpp.test.js",
 		"test:modern": "node test/modern-clp.test.js",
 		"bench": "node scripts/bench-site.cjs",

package/src/api-cli.ts

@@ -55,7 +55,7 @@ export function registerApiCommands(program: import("commander").Command): void
 		.command("generate")
 		.description("Build RobloxTargetProfile and regenerate CL++ / Luau projections")
 		.option("--dump <path>", "Mini-API-Dump.json path")
-		.option("--skip-headers", "Skip CL++ header generation")
+		.option("--skip-headers", "Skip legacy .clh API projections")
 		.option("--skip-luau", "Skip .d.luau generation")
 		.option("--docs", "No-op retained for CLI compat (Creator Docs are not mirrored)")
 		.action((opts: { dump?: string; skipHeaders?: boolean; skipLuau?: boolean; docs?: boolean }) => {
@@ -235,7 +235,7 @@ export function registerTargetCommands(program: import("commander").Command): vo
 
 	target
 		.command("datamodel")
-		.description("Build Typed DataModel profile + generated datamodel.clh from Rojo project")
+		.description("Build Typed DataModel profile (legacy projects also get .clh)")
 		.argument("[folder]", "game root with default.project.json", ".")
 		.option("-r, --rojo <path>", "Rojo project json")
 		.action((folder: string, options: { rojo?: string }) => {

package/src/cli.ts

@@ -4,8 +4,7 @@ import path from "node:path";
 import { pkg } from "./package-info.js";
 import { start as startLsp } from "./lsp.js";
 import { collectSources, toLuauPath } from "./clpp/paths.js";
-import { CLPP_INSTALL_HINT } from "./clpp/contract.js";
-import { clppInstalls, clppManifest, clppVersion, hasClpp, resolveClppBinary } from "./clpp/runner.js";
+import { clppManifest, hasClpp } from "./clpp/runner.js";
 import { installEditorSupport, syncEditorSupport } from "./intellisense.js";
 import { RojoMapper } from "./utils/rojo-mapper.js";
 import { ProcessOrchestrator } from "./utils/process-orchestrator.js";
@@ -103,7 +102,8 @@ program
 
 program
 	.command("lsp")
-	.description("Language server stdio — Flare `.flare` IntelliSense. CL++ still uses `clpp setup`.")
+	.description("Schema language server over stdio")
+	.option("--stdio", "Use standard input/output (default)")
 	.argument("[folder]", "project folder", ".")
 	.action((folder: string) => {
 		startLsp({ projectRoot: path.resolve(process.cwd(), folder) });
@@ -112,7 +112,7 @@ program
 program
 	.command("intellisense")
 	.alias("intelisense")
-	.description("Install schema IntelliSense (.flare .hive .mint .bloom .helm .shift .axiom) + sync .vscode; CL++ via clpp install")
+	.description("Install schema editor support and sync .vscode")
 	.argument("[folder]", "project folder", ".")
 	.action(async (folder: string) => {
 		try {
@@ -120,7 +120,6 @@ program
 			syncEditorSupport(root, loadConfig(root));
 			await installEditorSupport();
 			console.log("cluaupp: editor associations written in", root);
-			console.log("cluaupp:", CLPP_INSTALL_HINT);
 		} catch (err) {
 			console.error(err instanceof Error ? err.message : err);
 			process.exit(1);
@@ -129,20 +128,22 @@ program
 
 program
 	.command("language")
-	.description("CL++ manifest (`clpp api manifest`)")
-	.action(() => {
+	.description("Describe the Roblox .clp target; --legacy probes external clpp")
+	.option("--legacy", "Read the manifest of the compatible legacy compiler")
+	.action((options: { legacy?: boolean }) => {
 		try {
-			const bin = resolveClppBinary();
-			const version = clppVersion();
-			if (version) {
-				console.log(version, `(${bin})`);
-			}
-			for (const install of clppInstalls()) {
-				if (!install.selected) {
-					console.log(`skipped ${install.bin} (${install.version || "unknown"})`);
-				}
-			}
-			console.log(JSON.stringify(clppManifest(), null, "\t"));
+			const manifest = options.legacy ? clppManifest() : {
+				name: "Cluaupp Roblox target",
+				version: pkg.version,
+				status: "experimental",
+				sourceExtensions: [".clp"],
+				fileTags: { server: ".server.clp", client: ".client.clp", plugin: ".plugin.clp" },
+				importSyntax: "link",
+				headers: false,
+				builtinLinks: ["@clpp.roblox", "@clpp.libs.<Library>"],
+				legacy: { sourceExtensions: [".clpp", ".clh"], command: "cluaupp language --legacy" },
+			};
+			console.log(JSON.stringify(manifest, null, "\t"));
 		} catch (err) {
 			console.error(err instanceof Error ? err.message : err);
 			process.exit(1);

package/src/compiler/project.ts

@@ -300,7 +300,7 @@ export class ProjectCompiler {
 			target = `${target}.clp`;
 		}
 		if (!target.toLowerCase().endsWith(SOURCE_EXT)) {
-			return { kind: "error", message: `cannot link '${p}': CL++ modules are .clp files`, notes: [/\.(clh|clpp)$/i.test(p) ? "CL++ 0.9 has no headers: rename the module to .clp" : "link \"./file.clp\" as Name;"] };
+			return { kind: "error", message: `cannot link '${p}': CL++ modules are .clp files`, notes: [/\.(clh|clpp)$/i.test(p) ? "Legacy .clh/.clpp files use a different syntax: migrate the declarations and imports to .clp; changing the extension alone is insufficient" : "link \"./file.clp\" as Name;"] };
 		}
 		if (!fs.existsSync(target)) {
 			return { kind: "error", message: `cannot open module '${p}'` };

package/src/intellisense.ts

@@ -4,8 +4,6 @@ import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { pkg, projectRoot as PACKAGE_ROOT } from "./package-info.js";
 import type { ProjectConfig } from "./types.js";
-import { CLPP_INSTALL_HINT } from "./clpp/contract.js";
-import { hasClpp } from "./clpp/runner.js";
 import { isSourceFile } from "./clpp/paths.js";
 import { editorBin } from "./editor-install.js";
 
@@ -114,7 +112,7 @@ function writeVscode(root: string): void {
 }
 
 export function diagnosticsFor(_source?: string, _fileName?: string): CluauppDiagnostic[] {
-	// Language diagnostics belong to `clpp install`. Do not spawn `clpp api compile`
+	// CL++ diagnostics are reported by the compiler during build. Do not spawn a compiler
 	// from the editor — that duplicates source=clpp and freezes on every keystroke.
 	return [];
 }
@@ -204,16 +202,6 @@ export async function installEditorSupport() {
 			console.log(" ", dest);
 		}
 	}
-	if (hasClpp()) {
-		const result = spawnSync("clpp", ["install"], { encoding: "utf8", windowsHide: true });
-		if (result.status === 0) {
-			console.log(String(result.stderr || result.stdout || "clpp install ok").trim());
-		} else {
-			console.log("cluaupp:", CLPP_INSTALL_HINT);
-		}
-	} else {
-		console.log("cluaupp:", CLPP_INSTALL_HINT);
-	}
 	return { local };
 }
 

package/src/lsp.ts

@@ -61,7 +61,7 @@ function flareDiagnostics(document: TextDocument): Diagnostic[] {
 }
 
 export function start(_options: { projectRoot?: string } = {}): void {
-	const connection = createConnection(ProposedFeatures.all);
+	const connection = createConnection(ProposedFeatures.all, process.stdin, process.stdout);
 	const documents = new TextDocuments(TextDocument);
 
 	connection.onInitialize(() => ({