MUS-2390 Rewrite with Lute

.env.template

@@ -0,0 +1,2 @@
+ROBLOX_API_KEY=
+LOG_LEVEL=info

.github/workflows/ci.yml

@@ -19,27 +19,10 @@ jobs:
           allow-external-github-orgs: true
 
       - name: Install dependencies
-        run: lune run install
+        run: lute scripts/install.luau
 
       - name: Run unit tests
-        run: lune run test
-
-  test-e2e:
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: Roblox/setup-foreman@v3
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          allow-external-github-orgs: true
-
-      - name: Install dependencies
-        run: lune run install
-
-      - name: Run end-to-end tests
-        run: lune run test-e2e
+        run: lute scripts/test.luau --e2e
         env:
           ROBLOX_API_KEY: ${{ secrets.ROBLOX_API_KEY }}
 
@@ -55,10 +38,10 @@ jobs:
           allow-external-github-orgs: true
 
       - name: Install dependencies
-        run: lune run install
+        run: lute scripts/install.luau
 
       - name: Lint
-        run: lune run lint
+        run: lute scripts/lint.luau
 
   analyze:
     runs-on: ubuntu-latest
@@ -72,12 +55,9 @@ jobs:
           allow-external-github-orgs: true
 
       - name: Install dependencies
-        run: lune run install
-
-      - name: Setup Lune typedefs
-        run: lune setup
+        run: lute scripts/install.luau
 
       # MUS-2103 TODO: This will error in CI until Foreman is updated to install
       # the correct linux binary for luau-lsp
       - name: Analyze
-        run: lune run analyze
+        run: lute scripts/analyze.luau

.github/workflows/release.yml

@@ -23,10 +23,10 @@ jobs:
           allow-external-github-orgs: true
 
       - name: Install dependencies
-        run: lune run install
+        run: lute scripts/install.luau
 
       - name: Build
-        run: lune run build
+        run: lute scripts/build.luau
 
       - uses: actions/upload-artifact@v4
         with:

.gitignore

@@ -1,3 +1,6 @@
+# Secrets
+.env
+
 # Build artifacts
 build
 temp

.luaurc

@@ -1,9 +1,10 @@
 {
   "languageMode": "strict",
   "aliases": {
-    "root": "src",
-    "examples": "examples",
+    "lute": "~/.lute/typedefs/0.1.0/lute/",
+    "std": "~/.lute/typedefs/0.1.0/std/",
     "pkg": "pkg",
-    "lune": "~/.lune/.typedefs/0.9.3"
+    "root": "src",
+    "examples": "examples"
   }
 }

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+  "luau-lsp.fflags.override": {
+    "LuauSolverV2": "true"
+  },
+  "luau-lsp.platform.type": "standard",
+  "luau-lsp.ignoreGlobs": ["**/pkg/**"]
+}

README.md

@@ -7,7 +7,7 @@ Deploy rbxm files from GitHub to the Creator Store.
 # Installation
 
 > [!NOTE]
-> [Lune](https://github.com/lune-org/lune) v0.9.3+ is required.
+> [Lute](https://github.com/luau-lang/lute) v0.1.0-nightly.20251217+ is required.
 
 ## Prebuilt zip (recommended)
 
@@ -24,8 +24,8 @@ Run the following commands to clone the repo, install dependencies, and build rb
 git clone https://github.com/Roblox/rbxasset.git
 cd rbxasset
 foreman install
-lune run install
-lune run build
+lute scripts/install.luau
+lute scripts/build.luau
 ```
 
 From there, drag and drop `build/rbxasset` to a place where you will require it via a Luau script.
@@ -54,25 +54,27 @@ This defines a `default` asset and a `production` environment to deploy to.
 Then create a Luau script to handle the deployment:
 
 ```luau
--- .lune/publish.luau
-local process = require("@lune/process")
+-- scripts/publish.luau
+local process = require("@lute/process")
 
 local rbxasset = require("./path/to/rbxasset")
 
-local apiKey = process.args[1]
+local args = { ... }
+
+local apiKey = args[1]
 assert(apiKey, "argument #1 must be a valid Open Cloud API key")
 
 -- The rbxm file needs to be built manually. rbxasset makes no assumptions about
 -- how your project is setup, it only cares about having a file to upload. Note
 -- the filename `build.rbxm` matches the `model` field in rbxasset.toml
-process.exec("rojo", { "build", "-o", "build.rbxm" })
+process.run("rojo build -o build.rbxm")
 
 -- Publish the `default` asset defined in rbxasset.toml
-rbxasset.publishPackageAsync(process.cwd, "default", apiKey)
+rbxasset.publishPackageAsync(process.cwd(), "default", apiKey)
 ```
 
 ```sh
-$ lune run publish <API_KEY>
+$ lute scripts/publish.luau <API_KEY>
 ```
 
 Where `<API_KEY>` represents an Open Cloud API key that has the following scopes:
@@ -94,7 +96,6 @@ Assets define how the asset will be deployed and shown on the Creator Store.
 | `environment` | `string`                | Defines which environment to deploy to. This value must equal one of the environments defined in the `environments` object                                    |
 | `description` | `string?`               | The description of the asset on the Creator Store                                                                                                             |
 | `icon`        | `string?`               | Path to the icon (png only) to display on the Creator Store                                                                                                   |
-| `description` | `string?`               | The description of the asset on the Creator Store                                                                                                             |
 | `type`        | `"Package" \| "Plugin"` | The type of asset to upload to the Creator Store. This must be set before the first publish as asset type is immutable once uploaded. Defaults to `"Package"` |
 
 ## Environments

examples/package/deploy.luau

@@ -1,12 +1,9 @@
-local rbxasset = require("@root/")
+local rbxasset = require("@root/init")
 
-local process = require("@lune/process")
+local process = require("@lute/process")
 
-local apiKey = process.args[1]
-assert(apiKey, "argument #1 must be a valid Open Cloud API key")
+assert(process.cwd():match("examples/package"), "you must be in the `examples/package` folder when running this script")
 
-assert(process.cwd:match("examples/package"), "you must be in the `examples/package` folder when running this script")
+process.system("rojo build -o asset.rbxm")
 
-process.exec("rojo", { "build", "-o", "asset.rbxm" })
-
-rbxasset.publishPackageAsync(process.cwd, "package", apiKey)
+rbxasset.publishPackageAsync(process.cwd(), "package", process.env.ROBLOX_API_KEY)

examples/package/e2e.spec.luau

@@ -1,27 +1,29 @@
-local frktest = require("@pkg/frktest")
-local fs = require("@lune/fs")
-local process = require("@lune/process")
-local serde = require("@lune/serde")
+local expect = require("@std/test/assert")
+local fs = require("@lute/fs")
+local process = require("@lute/process")
+local test = require("@std/test")
+local toml = require("@root/lib/toml")
 
 local getAssetDetailsAsync = require("@root/requests/getAssetDetailsAsync")
 local getOrCreateAssetLockfile = require("@root/manifest/getOrCreateAssetLockfile")
 local readManifest = require("@root/manifest/readManifest")
 local run = require("@root/lib/run")
 
-local test = frktest.test
-local check = frktest.assert.check
-
 local ROOT_PATH = "examples/package"
 local MANIFEST_PATH = `{ROOT_PATH}/rbxasset.toml`
 
 local function appendTextForTesting(path: string, text: string)
-	local content = fs.readFile(path)
+	local handle = fs.open(path, "w")
+	local content = fs.read(handle)
 	content ..= text
-	fs.writeFile(path, content)
+	fs.write(handle, content)
+	fs.close(handle)
 end
 
 local apiKey = process.env.ROBLOX_API_KEY
-assert(apiKey, "End-to-end tests can only be run when the ROBLOX_API_KEY envvar is set to a valid Open Cloud API key")
+if not apiKey then
+	error("End-to-end tests can only be run when the ROBLOX_API_KEY envvar is set to a valid Open Cloud API key")
+end
 
 local lockfile = getOrCreateAssetLockfile(ROOT_PATH)
 local assetId = lockfile.assets.package.assetId
@@ -38,7 +40,10 @@ test.case("uploads rbxm to the Creator Store", function()
 	appendTextForTesting(path, `\nprint("New!")`)
 
 	local success, result = pcall(function()
-		run("lune", { "run", "deploy.luau", apiKey }, {
+		return run("lute", { "deploy.luau" }, {
+			env = {
+				ROBLOX_API_KEY = apiKey,
+			},
 			cwd = ROOT_PATH,
 		})
 	end)
@@ -49,7 +54,7 @@ test.case("uploads rbxm to the Creator Store", function()
 
 	assetDetails = getAssetDetailsAsync(assetId, apiKey)
 
-	check.not_equal(assetDetails.revisionId, prevRevisionId)
+	expect.neq(assetDetails.revisionId, prevRevisionId)
 end)
 
 test.case("text fields in rbxasest.toml get mirrored to the asset details", function()
@@ -62,31 +67,43 @@ test.case("text fields in rbxasest.toml get mirrored to the asset details", func
 	manifest.assets.package.name = `{manifest.assets.package.name}\n({id})`
 	manifest.assets.package.description = `{manifest.assets.package.description}\n({id})`
 
-	fs.writeFile(MANIFEST_PATH, serde.encode("toml", manifest))
+	local handle = fs.open(MANIFEST_PATH, "w")
+	fs.write(handle, toml.serialize(manifest))
+	fs.close(handle)
 
-	run("lune", { "run", "deploy.luau", apiKey }, {
-		cwd = ROOT_PATH,
-	})
+	local success, result = pcall(function()
+		return run("lute", { "deploy.luau" }, {
+			env = {
+				ROBLOX_API_KEY = apiKey,
+			},
+			cwd = ROOT_PATH,
+		})
+	end)
 
 	run("git", { "restore", MANIFEST_PATH })
 
+	assert(success, result)
+
 	assetDetails = getAssetDetailsAsync(assetId, apiKey)
 
-	check.equal(assetDetails.displayName, manifest.assets.package.name)
-	check.equal(assetDetails.description, manifest.assets.package.description)
-	check.not_equal(assetDetails.revisionId, prevRevisionId)
+	expect.eq(assetDetails.displayName, manifest.assets.package.name)
+	expect.eq(assetDetails.description, manifest.assets.package.description)
+	expect.neq(assetDetails.revisionId, prevRevisionId)
 end)
 
 test.case("does not publish a new version when there are no changes", function()
 	local assetDetails = getAssetDetailsAsync(assetId, apiKey)
 
 	local prevRevisionId = assetDetails.revisionId
 
-	run("lune", { "run", "deploy.luau", apiKey }, {
+	run("lute", { "deploy.luau" }, {
+		env = {
+			ROBLOX_API_KEY = apiKey,
+		},
 		cwd = ROOT_PATH,
 	})
 
 	assetDetails = getAssetDetailsAsync(assetId, apiKey)
 
-	check.equal(assetDetails.revisionId, prevRevisionId)
+	expect.eq(assetDetails.revisionId, prevRevisionId)
 end)