@quenty/nevermore-cli 4.32.0 → 4.33.0

package/src/utils/job-context/batch-script-job-context.ts

@@ -282,9 +282,18 @@ export class BatchScriptJobContext implements JobContext {
     const rawLogs = await this._inner.getLogsAsync(deployment);
 
     if (!result.success) {
+      const stateInfo = result.taskState ? ` (state: ${result.taskState})` : '';
       OutputHelper.warn(
-        'Batch execution task did not complete successfully — parsing partial results'
+        `Batch execution task did not complete successfully${stateInfo} — parsing partial results`
       );
+      if (result.errorMessage) {
+        OutputHelper.error(result.errorMessage);
+      }
+      if (!rawLogs || rawLogs.trim().length === 0) {
+        OutputHelper.warn(
+          'No logs were returned from the execution — the script may not have started'
+        );
+      }
       OutputHelper.verbose(`Raw batch logs:\n${rawLogs || '(empty)'}`);
     }
 

package/src/utils/job-context/cloud-job-context.ts

@@ -112,7 +112,24 @@ export class CloudJobContext extends BaseJobContext {
     cloudDeployment.taskPath = task.path;
     cloudDeployment.taskState = completedTask.state;
 
-    return { success: completedTask.state === 'COMPLETE' };
+    // Surface error details from the Roblox API when the task didn't complete
+    let errorMessage: string | undefined;
+    if (completedTask.state !== 'COMPLETE') {
+      const parts: string[] = [`Task ended with state: ${completedTask.state}`];
+      if (completedTask.error?.message) {
+        parts.push(`Error: ${completedTask.error.message}`);
+      }
+      if (completedTask.error?.code) {
+        parts.push(`Code: ${completedTask.error.code}`);
+      }
+      errorMessage = parts.join('. ');
+    }
+
+    return {
+      success: completedTask.state === 'COMPLETE',
+      taskState: completedTask.state,
+      errorMessage,
+    };
   }
 
   async getLogsAsync(deployment: Deployment): Promise<string> {

package/src/utils/job-context/job-context.ts

@@ -24,6 +24,10 @@ export interface ScriptRunResult {
    * wall-clock measurement.
    */
   durationMs?: number;
+  /** Final task state (e.g. 'COMPLETE', 'FAILED', 'CANCELLED'). */
+  taskState?: string;
+  /** Error message from the execution backend, if any. */
+  errorMessage?: string;
 }
 
 /**

package/src/utils/open-cloud/open-cloud-client.ts

@@ -20,6 +20,10 @@ export interface LuauTask {
     | 'FAILED';
   script: string;
   timeout?: string;
+  /** Script return value (populated on COMPLETE). */
+  output?: { results?: Array<{ value?: string }> };
+  /** Error details (populated on FAILED). */
+  error?: { code?: string; message?: string };
 }
 
 export interface OpenCloudClientOptions {

package/src/utils/testing/parsers/batch-log-parser.ts

@@ -134,10 +134,24 @@ export function parseBatchTestLogs(
     }
   }
 
+  // ── Warn when the batch produced no recognizable output ──
+
+  const noOutputAtAll = logSections.size === 0 && summaryResults.size === 0;
+  if (noOutputAtAll) {
+    OutputHelper.warn(
+      `[batch-log-parser] No batch markers or summary found in logs (${lines.length} lines, ${rawLogs.length} chars). ` +
+        'The batch script may not have started or produced output.'
+    );
+  }
+
   // ── Pass 3: Combine log sections with summary results ──
 
+  // When the batch produced zero output, surface the raw error in every
+  // package's logs so reporters show the actual failure instead of "(no output)".
+  const fallbackLogs = noOutputAtAll ? rawLogs.trim() : '';
+
   for (const [packageName, slug] of slugMap) {
-    const sectionLogs = logSections.get(slug) ?? '';
+    const sectionLogs = logSections.get(slug) ?? fallbackLogs;
     const summarySuccess = summaryResults.get(slug);
 
     // The JSON summary (pcall result) is the primary success signal.
@@ -150,7 +164,7 @@ export function parseBatchTestLogs(
       }
     }
 
-    if (!success) {
+    if (!success && !noOutputAtAll) {
       console.error(
         `[batch-log-parser] ${slug}: summarySuccess=${summarySuccess} hasLogs=${
           sectionLogs.length > 0

package/templates/batch-test-runner.luau

@@ -19,7 +19,7 @@ for _, slug in packageSlugs do
 	if inst then
 		scriptSources[slug] = inst.Source
 	else
-		error(`Failed to find script source for {slug}`)
+		warn(`[BatchTest] Failed to find script source for {slug}`)
 	end
 end
 
@@ -41,8 +41,8 @@ local results: { Result } = {}
 for _, slug in packageSlugs do
 	local scriptSource = scriptSources[slug]
 	if not scriptSource then
-		warn(`[BatchTest] No script for {slug}`)
 		print("===BATCH_TEST_BEGIN " .. slug .. "===")
+		warn(`[BatchTest] {slug}: No test script found for {slug}. Is it tagged with _BatchTest_{slug}?`)
 		print("===BATCH_TEST_END " .. slug .. " FAIL 0===")
 		table.insert(results, { slug = slug, success = false, durationMs = 0, error = "No test script found" })
 		continue
@@ -93,14 +93,14 @@ for _, slug in packageSlugs do
 
 	-- CLEANUP: restore service state
 	allPackages[slug].Parent = nil
-	for _, c in workspace:GetChildren() do
-		if not preWorkspace[c] and not c:IsA("Terrain") and not c:IsA("Camera") then
-			pcall(c.Destroy, c)
+	for _, child in workspace:GetChildren() do
+		if not preWorkspace[child] and not child:IsA("Terrain") and not child:IsA("Camera") then
+			pcall(child.Destroy, child)
 		end
 	end
-	for _, c in ReplicatedStorage:GetChildren() do
-		if not preRunService[c] then
-			pcall(c.Destroy, c)
+	for _, child in ReplicatedStorage:GetChildren() do
+		if not preRunService[child] then
+			pcall(child.Destroy, child)
 		end
 	end
 	-- Destroy injected LoaderLinks (non-archivable, created by LoaderLinkCreator)

package/templates/nevermore-library-package-template/package.json

@@ -28,7 +28,9 @@
     "Quenty"
   ],
   "dependencies": {
-    "@quenty/loader": "workspace:*"
+    "@quenty/loader": "workspace:*",
+    "@quenty/nevermore-test-runner": "workspace:*",
+    "@quentystudios/jest-lua": "3.10.0-quenty.2"
   },
   "publishConfig": {
     "access": "public"

package/templates/nevermore-library-package-template/src/jest.config.lua

@@ -0,0 +1,3 @@
+return {
+	testMatch = { "**/*.spec" },
+}

package/templates/nevermore-library-package-template/test/default.project.json

@@ -11,8 +11,14 @@
   "tree": {
     "$className": "DataModel",
     "ServerScriptService": {
+      "$properties": {
+        "LoadStringEnabled": true
+      },
       "{{packageName}}": {
         "$path": ".."
+      },
+      "Script": {
+        "$path": "scripts/Server"
       }
     }
   }

package/templates/nevermore-library-package-template/test/scripts/Server/ServerMain.server.lua

@@ -0,0 +1,13 @@
+--[[
+	@class ServerMain
+]]
+local ServerScriptService = game:GetService("ServerScriptService")
+
+local root = ServerScriptService.{{packageName}}
+local loader = root:FindFirstChild("LoaderUtils", true).Parent
+local require = require(loader).bootstrapGame(root)
+
+local NevermoreTestRunnerUtils = require("NevermoreTestRunnerUtils")
+if NevermoreTestRunnerUtils.runTestsIfNeededAsync(root) then
+	return
+end