@quenty/nevermore-cli 4.41.1 → 4.42.1-canary.783.30683193716.0

package/dist/utils/testing/parsers/traceback-parser.d.ts

@@ -0,0 +1,31 @@
+export interface AttributedTraceback {
+    /** First line of the error, before the stack. */
+    message: string;
+    /** Roblox instance path of the topmost frame, e.g. "ServerScriptService.Foo.Bar". */
+    source?: string;
+    /** Root of that path, which names the package the frame belongs to. */
+    owner?: string;
+    /** Frames kept for display, topmost first. */
+    frames: string[];
+    /** How many times this same traceback appeared. */
+    count: number;
+}
+/**
+ * Pull tracebacks out of log output and attribute each to its owning package.
+ *
+ * Attribution reads the script path in the frames rather than the position of
+ * the traceback in the log. Position is unreliable: a deferred callback can
+ * fire during a later package's section, which is why batch mode previously
+ * gave up on tracebacks entirely.
+ */
+export declare function parseTracebacks(rawOutput: string): AttributedTraceback[];
+/**
+ * Name the package a script path belongs to.
+ *
+ * Batch places hold each package under its own root, so the segment below the
+ * service is the package.
+ */
+export declare function ownerOf(scriptPath: string): string | undefined;
+/** Render tracebacks for a human, newest information first and bounded. */
+export declare function formatTracebacks(tracebacks: AttributedTraceback[], maxShown?: number): string;
+//# sourceMappingURL=traceback-parser.d.ts.map

package/dist/utils/testing/parsers/traceback-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceback-parser.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/traceback-parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmDxE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,mBAAmB,EAAE,EACjC,QAAQ,SAAI,GACX,MAAM,CAuBR"}

package/dist/utils/testing/parsers/traceback-parser.js

@@ -0,0 +1,91 @@
+import { OutputHelper } from '@quenty/cli-output-helpers';
+const STACK_BEGIN = /^\s*Stack Begin\s*$/;
+const STACK_END = /^\s*Stack End\s*$/;
+// Script 'ServerScriptService.EggHunt2026.game.Server.Foo', Line 365 - function bar
+const FRAME = /Script\s+'(?:\[string\s+")?([^'"\]]+)/;
+const MAX_FRAMES = 4;
+/**
+ * Pull tracebacks out of log output and attribute each to its owning package.
+ *
+ * Attribution reads the script path in the frames rather than the position of
+ * the traceback in the log. Position is unreliable: a deferred callback can
+ * fire during a later package's section, which is why batch mode previously
+ * gave up on tracebacks entirely.
+ */
+export function parseTracebacks(rawOutput) {
+    if (!rawOutput) {
+        return [];
+    }
+    const lines = OutputHelper.stripAnsi(rawOutput).split('\n');
+    const bySignature = new Map();
+    for (let i = 0; i < lines.length; i++) {
+        if (!STACK_BEGIN.test(lines[i])) {
+            continue;
+        }
+        // The error text sits on the line above "Stack Begin".
+        const message = (lines[i - 1] ?? '').trim();
+        const frames = [];
+        let source;
+        for (let j = i + 1; j < lines.length && !STACK_END.test(lines[j]); j++) {
+            const frame = lines[j].trim();
+            if (!frame) {
+                continue;
+            }
+            if (frames.length < MAX_FRAMES) {
+                frames.push(frame);
+            }
+            if (!source) {
+                source = FRAME.exec(frame)?.[1];
+            }
+        }
+        // One bug fires per player and per frame, so the same traceback can appear
+        // hundreds of times. Collapse by signature and count instead of printing
+        // every copy.
+        const signature = `${message}::${frames[0] ?? ''}`;
+        const existing = bySignature.get(signature);
+        if (existing) {
+            existing.count++;
+            continue;
+        }
+        bySignature.set(signature, {
+            message,
+            source,
+            owner: source ? ownerOf(source) : undefined,
+            frames,
+            count: 1,
+        });
+    }
+    return [...bySignature.values()];
+}
+/**
+ * Name the package a script path belongs to.
+ *
+ * Batch places hold each package under its own root, so the segment below the
+ * service is the package.
+ */
+export function ownerOf(scriptPath) {
+    const parts = scriptPath.split('.');
+    return parts.length >= 2 ? parts[1] : undefined;
+}
+/** Render tracebacks for a human, newest information first and bounded. */
+export function formatTracebacks(tracebacks, maxShown = 5) {
+    if (tracebacks.length === 0) {
+        return '';
+    }
+    const lines = [];
+    const shown = tracebacks.slice(0, maxShown);
+    for (const traceback of shown) {
+        const where = traceback.source ? ` (${traceback.source})` : '';
+        const times = traceback.count > 1 ? ` ×${traceback.count}` : '';
+        lines.push(`  ${traceback.message}${where}${times}`);
+        for (const frame of traceback.frames) {
+            lines.push(`      ${frame}`);
+        }
+    }
+    const hidden = tracebacks.length - shown.length;
+    if (hidden > 0) {
+        lines.push(`  ...and ${hidden} more distinct traceback(s)`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=traceback-parser.js.map

package/dist/utils/testing/parsers/traceback-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceback-parser.js","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/traceback-parser.ts"],"names":[],"mappings":"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"}

package/dist/utils/testing/parsers/traceback-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=traceback-parser.test.d.ts.map

package/dist/utils/testing/parsers/traceback-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceback-parser.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/traceback-parser.test.ts"],"names":[],"mappings":""}

package/dist/utils/testing/parsers/traceback-parser.test.js

@@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest';
+import { formatTracebacks, ownerOf, parseTracebacks, } from './traceback-parser.js';
+const TRACEBACK = [
+    'PlayerBadgeHelper: attempt to index nil with UserId',
+    'Stack Begin',
+    'Script \'[string "ServerScriptService.egghunt2026.game.Server.PlayerBadgeHelper"]\', Line 365 - function _awardBadge',
+    'Script \'[string "ServerScriptService.egghunt2026.game.Server.PlayerBadgeHelper"]\', Line 138',
+    'Stack End',
+].join('\n');
+describe('parseTracebacks', () => {
+    it('attributes a traceback to the package that owns the failing script', () => {
+        const [traceback] = parseTracebacks(TRACEBACK);
+        expect(traceback.owner).toBe('egghunt2026');
+        expect(traceback.source).toContain('PlayerBadgeHelper');
+        expect(traceback.message).toContain('attempt to index nil');
+    });
+    it('collapses repeats of the same crash into one entry with a count', () => {
+        // One bug fires per player per frame, so raw output can hold hundreds of
+        // identical copies. Printing them all is what makes logs unreadable.
+        const repeated = [TRACEBACK, TRACEBACK, TRACEBACK].join('\n');
+        const tracebacks = parseTracebacks(repeated);
+        expect(tracebacks).toHaveLength(1);
+        expect(tracebacks[0].count).toBe(3);
+    });
+    it('keeps distinct crashes apart', () => {
+        const other = TRACEBACK.replace('PlayerBadgeHelper', 'TrainHelper');
+        expect(parseTracebacks([TRACEBACK, other].join('\n'))).toHaveLength(2);
+    });
+    it('finds nothing in clean output', () => {
+        expect(parseTracebacks('Tests: 10 passed, 10 total')).toEqual([]);
+    });
+});
+describe('ownerOf', () => {
+    it('names the package below the service', () => {
+        expect(ownerOf('ServerScriptService.brio.Foo.Bar')).toBe('brio');
+    });
+});
+describe('formatTracebacks', () => {
+    it('bounds how many it prints and says how many it withheld', () => {
+        const many = Array.from({ length: 8 }, (_, i) => TRACEBACK.replace('PlayerBadgeHelper:', `Helper${i}:`)).join('\n');
+        const formatted = formatTracebacks(parseTracebacks(many), 5);
+        expect(formatted).toContain('and 3 more distinct traceback(s)');
+    });
+});
+//# sourceMappingURL=traceback-parser.test.js.map

package/dist/utils/testing/parsers/traceback-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceback-parser.test.js","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/traceback-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,SAAS,GAAG;IAChB,qDAAqD;IACrD,aAAa;IACb,sHAAsH;IACtH,+FAA+F;IAC/F,WAAW;CACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAE/C,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACxD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,yEAAyE;QACzE,qEAAqE;QACrE,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE7C,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;QAEpE,MAAM,CAAC,eAAe,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,eAAe,CAAC,4BAA4B,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC9C,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAAG,CAAC,CACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,SAAS,GAAG,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAE7D,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/testing/runner/combined-project-generator.d.ts

@@ -1,5 +1,5 @@
 import { BuildContext } from '@quenty/nevermore-template-helpers';
-import { type DeployTarget } from '../../build/deploy-config.js';
+import { type DeployTarget } from '@quenty/nevermore-deploy';
 import { type BatchTarget } from '../../batch/changed-packages-utils.js';
 export interface CombinedProjectResult {
     /** Absolute path to the combined .rbxl file. */

package/dist/utils/testing/runner/combined-project-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combined-project-generator.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/runner/combined-project-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EAEb,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mFAAmF;IACnF,aAAa,EAAE,YAAY,CAAC;IAC5B,sFAAsF;IACtF,YAAY,EAAE,YAAY,CAAC;CAC5B;AAMD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,sBAAsB,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,cAAc,CAAC,IAAI,IAAI,CAAC;IACxB,cAAc,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/C;AASD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyGjC"}
+{"version":3,"file":"combined-project-generator.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/runner/combined-project-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EAEb,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mFAAmF;IACnF,aAAa,EAAE,YAAY,CAAC;IAC5B,sFAAsF;IACtF,YAAY,EAAE,YAAY,CAAC;CAC5B;AAMD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,sBAAsB,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,cAAc,CAAC,IAAI,IAAI,CAAC;IACxB,cAAc,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/C;AASD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyGjC"}

package/dist/utils/testing/runner/test-runner.d.ts

@@ -1,4 +1,4 @@
-import { type DeployTarget } from '../../build/deploy-config.js';
+import { type DeployTarget } from '@quenty/nevermore-deploy';
 import { type JobContext } from '../../job-context/job-context.js';
 import { type ParsedTestCounts } from '../test-log-parser.js';
 export interface SingleTestResult {
@@ -14,6 +14,14 @@ export interface SingleTestResult {
     /** Why the run failed, when the runner can say more than "it failed". */
     error?: string;
 }
+/**
+ * Combine failure reasons from the job context with those read from the logs.
+ *
+ * In batch mode the context has already evaluated these same logs, so the two
+ * sources overlap. Merging on the individual reason keeps the overlap from
+ * reading as double the failures.
+ */
+export declare function mergeFailureReasons(contextError: string | undefined, logReasons: string[]): string[];
 export interface SingleTestOptions {
     packagePath: string;
     packageName: string;

package/dist/utils/testing/runner/test-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,uBAAuB,CAAC;AAS/B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAgE3B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,MAAM,CAAC,CAajB"}
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,uBAAuB,CAAC;AAS/B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,EAAE,CAOV;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA6E3B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/utils/testing/runner/test-runner.js

@@ -4,6 +4,21 @@ import { randomUUID } from 'crypto';
 import { parseTestLogs, parseTestCounts, } from '../test-log-parser.js';
 import { buildDeployMetadataAttributes, gatherGitDeployInfo, injectDeployMetadataInPlaceAsync, packageUsesManifestAsync, } from '../../deploy/deploy-metadata.js';
 import { readPackageVersionAsync } from '../../nevermore-cli-utils.js';
+/**
+ * Combine failure reasons from the job context with those read from the logs.
+ *
+ * In batch mode the context has already evaluated these same logs, so the two
+ * sources overlap. Merging on the individual reason keeps the overlap from
+ * reading as double the failures.
+ */
+export function mergeFailureReasons(contextError, logReasons) {
+    return [
+        ...new Set([
+            ...(contextError ? contextError.split('; ') : []),
+            ...logReasons,
+        ]),
+    ];
+}
 /**
  * Build, deploy, and run a test for a single package using the provided
  * JobContext. The context determines the execution environment (cloud or local).
@@ -11,7 +26,11 @@ import { readPackageVersionAsync } from '../../nevermore-cli-utils.js';
  * Creates and releases its own deployment handle — the caller owns the context lifetime.
  */
 export async function runSingleTestAsync(context, options) {
-    const { packagePath, packageName, timeoutMs = 120_000, scriptText, target, } = options;
+    const { packagePath, packageName, 
+    // 300s is the Open Cloud maximum. The old 120s default failed real suites
+    // with no jest summary at all, so "--timeout 300" had become folklore
+    // everyone had to know before their first useful run.
+    timeoutMs = 300_000, scriptText, target, } = options;
     const sessionId = randomUUID();
     const builtPlace = await context.buildPlaceAsync({
         target,
@@ -46,13 +65,19 @@ export async function runSingleTestAsync(context, options) {
             timeoutMs,
         });
         const rawLogs = await context.getLogsAsync(deployment);
-        const parsed = parseTestLogs(rawLogs);
+        // A probe script is arbitrary Luau with no jest in it, so demanding a test
+        // report would fail every --script-text run. Everything else must prove a
+        // runner spoke before it can pass.
+        const parsed = parseTestLogs(rawLogs, {
+            requireTestReport: scriptText === undefined,
+        });
+        const reasons = mergeFailureReasons(result.errorMessage, parsed.failureReasons);
         return {
             success: result.success && parsed.success,
             logs: parsed.logs,
             testCounts: parseTestCounts(parsed.logs),
             durationMs: result.durationMs,
-            error: result.errorMessage,
+            error: reasons.length > 0 ? reasons.join('; ') : undefined,
         };
     }
     finally {

package/dist/utils/testing/runner/test-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-runner.js","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"test-runner.js","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.ts"],"names":[],"mappings":"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"}

package/dist/utils/testing/runner/test-runner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-runner.test.d.ts.map

package/dist/utils/testing/runner/test-runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.test.ts"],"names":[],"mappings":""}

package/dist/utils/testing/runner/test-runner.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { mergeFailureReasons } from './test-runner.js';
+describe('mergeFailureReasons', () => {
+    it('does not repeat reasons the context already reported', () => {
+        // Batch mode evaluates the same logs upstream, so both sources describe the
+        // same failures. Concatenating them read as double the failures.
+        const merged = mergeFailureReasons('3 test suite(s) failed; 19 test(s) failed', ['3 test suite(s) failed', '19 test(s) failed']);
+        expect(merged).toEqual(['3 test suite(s) failed', '19 test(s) failed']);
+    });
+    it('keeps reasons only one side knows about', () => {
+        const merged = mergeFailureReasons('the batch runner reported a Luau error', ['19 test(s) failed']);
+        expect(merged).toHaveLength(2);
+    });
+    it('is empty when nothing failed', () => {
+        expect(mergeFailureReasons(undefined, [])).toEqual([]);
+    });
+});
+//# sourceMappingURL=test-runner.test.js.map

package/dist/utils/testing/runner/test-runner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.test.js","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,4EAA4E;QAC5E,iEAAiE;QACjE,MAAM,MAAM,GAAG,mBAAmB,CAChC,2CAA2C,EAC3C,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAChD,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,mBAAmB,CAChC,wCAAwC,EACxC,CAAC,mBAAmB,CAAC,CACtB,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/testing/test-log-parser.d.ts

@@ -7,12 +7,43 @@ export interface ParsedTestLogs {
     success: boolean;
     logs: string;
     testCounts?: ParsedTestCounts;
+    /** Why the run is not a pass. Empty when it is. */
+    failureReasons: string[];
 }
+export interface TestOutcomeOptions {
+    /**
+     * Require proof the runner ran. Off for probe scripts (--script-text), which
+     * legitimately produce no jest report.
+     */
+    requireTestReport?: boolean;
+}
+/**
+ * Decide whether test output represents a pass, and say why when it does not.
+ *
+ * The single definition of the rule. Both the single-package path and the batch
+ * path route through here — they previously carried divergent copies that
+ * disagreed about tracebacks, so the same commit could pass one and fail the
+ * other.
+ */
+export declare function evaluateTestOutcome(rawOutput: string, options?: TestOutcomeOptions): {
+    success: boolean;
+    failureReasons: string[];
+};
+/**
+ * True when jest reported at all, including reporting that it found nothing.
+ *
+ * "Ran and found no tests" is a legitimate answer for packages that ship
+ * without specs; "we never heard from jest" is not. Keying on the report
+ * rather than on a test count keeps `passWithNoTests` working.
+ */
+export declare function hasTestReport(rawOutput: string): boolean;
+/** Count Luau tracebacks in output. */
+export declare function countTracebacks(rawOutput: string): number;
 /**
  * Analyze test output for Jest failures and Luau runtime errors.
  * Shared by both Open Cloud log fetching and local run-in-roblox output.
  */
-export declare function parseTestLogs(rawOutput: string): ParsedTestLogs;
+export declare function parseTestLogs(rawOutput: string, options?: TestOutcomeOptions): ParsedTestLogs;
 /**
  * Parse Jest "Tests: N failed, N passed, N total" line into structured counts.
  * Returns undefined if no test summary line is found.

package/dist/utils/testing/test-log-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-log-parser.d.ts","sourceRoot":"","sources":["../../../src/utils/testing/test-log-parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAkB/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,SAAS,CAmB9B"}
+{"version":3,"file":"test-log-parser.d.ts","sourceRoot":"","sources":["../../../src/utils/testing/test-log-parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,mDAAmD;IACnD,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CA6BhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAOxD;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAShB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,SAAS,CAmB9B"}

package/dist/utils/testing/test-log-parser.js

@@ -1,19 +1,63 @@
 import { OutputHelper } from '@quenty/cli-output-helpers';
 /**
- * Analyze test output for Jest failures and Luau runtime errors.
- * Shared by both Open Cloud log fetching and local run-in-roblox output.
+ * Decide whether test output represents a pass, and say why when it does not.
+ *
+ * The single definition of the rule. Both the single-package path and the batch
+ * path route through here — they previously carried divergent copies that
+ * disagreed about tracebacks, so the same commit could pass one and fail the
+ * other.
  */
-export function parseTestLogs(rawOutput) {
+export function evaluateTestOutcome(rawOutput, options = {}) {
     const cleanLogs = OutputHelper.stripAnsi(rawOutput);
-    // Check for Jest-style test failures
+    const failureReasons = [];
     const failedSuites = cleanLogs.match(/Test Suites:\s*(\d+)\s+failed/);
     const failedTests = cleanLogs.match(/Tests:\s*(\d+)\s+failed/);
-    const hasJestFailures = (failedSuites && parseInt(failedSuites[1], 10) > 0) ||
-        (failedTests && parseInt(failedTests[1], 10) > 0);
-    // Check for Luau runtime errors (stack traces)
-    const hasRuntimeError = /Stack Begin\s/.test(cleanLogs);
+    if (failedSuites && parseInt(failedSuites[1], 10) > 0) {
+        failureReasons.push(`${failedSuites[1]} test suite(s) failed`);
+    }
+    if (failedTests && parseInt(failedTests[1], 10) > 0) {
+        failureReasons.push(`${failedTests[1]} test(s) failed`);
+    }
+    // Tracebacks always fail. They catch use-after-free bugs that jest cannot
+    // see, since a deferred-callback crash fires outside any test.
+    const tracebacks = countTracebacks(cleanLogs);
+    if (tracebacks > 0) {
+        failureReasons.push(`${tracebacks} Luau traceback(s) — see attributed errors below`);
+    }
+    if (options.requireTestReport && !hasTestReport(cleanLogs)) {
+        failureReasons.push('no jest report in output — nothing proves any test ran');
+    }
+    return { success: failureReasons.length === 0, failureReasons };
+}
+/**
+ * True when jest reported at all, including reporting that it found nothing.
+ *
+ * "Ran and found no tests" is a legitimate answer for packages that ship
+ * without specs; "we never heard from jest" is not. Keying on the report
+ * rather than on a test count keeps `passWithNoTests` working.
+ */
+export function hasTestReport(rawOutput) {
+    const clean = OutputHelper.stripAnsi(rawOutput);
+    return (/Tests:\s+/.test(clean) ||
+        /Test Suites:\s+/.test(clean) ||
+        /No tests found/i.test(clean));
+}
+/** Count Luau tracebacks in output. */
+export function countTracebacks(rawOutput) {
+    if (!rawOutput) {
+        return 0;
+    }
+    return OutputHelper.stripAnsi(rawOutput).match(/Stack Begin\s/g)?.length ?? 0;
+}
+/**
+ * Analyze test output for Jest failures and Luau runtime errors.
+ * Shared by both Open Cloud log fetching and local run-in-roblox output.
+ */
+export function parseTestLogs(rawOutput, options = {}) {
+    const outcome = evaluateTestOutcome(rawOutput, options);
     return {
-        success: !hasJestFailures && !hasRuntimeError,
+        success: outcome.success,
+        failureReasons: outcome.failureReasons,
         logs: rawOutput,
         testCounts: parseTestCounts(rawOutput),
     };

package/dist/utils/testing/test-log-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-log-parser.js","sourceRoot":"","sources":["../../../src/utils/testing/test-log-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAc1D;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAEpD,qCAAqC;IACrC,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/D,MAAM,eAAe,GACnB,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpD,+CAA+C;IAC/C,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExD,OAAO;QACL,OAAO,EAAE,CAAC,eAAe,IAAI,CAAC,eAAe;QAC7C,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,eAAe,CAAC,SAAS,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB;IAEjB,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAEhD,iFAAiF;IACjF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"test-log-parser.js","sourceRoot":"","sources":["../../../src/utils/testing/test-log-parser.ts"],"names":[],"mappings":"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"}

package/dist/utils/testing/test-log-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-log-parser.test.d.ts.map

package/dist/utils/testing/test-log-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-log-parser.test.d.ts","sourceRoot":"","sources":["../../../src/utils/testing/test-log-parser.test.ts"],"names":[],"mappings":""}

package/dist/utils/testing/test-log-parser.test.js

@@ -0,0 +1,56 @@
+import { describe, expect, it } from 'vitest';
+import { evaluateTestOutcome, hasTestReport } from './test-log-parser.js';
+describe('evaluateTestOutcome', () => {
+    it('passes a clean jest report', () => {
+        const outcome = evaluateTestOutcome('Tests: 275 passed, 275 total', {
+            requireTestReport: true,
+        });
+        expect(outcome.success).toBe(true);
+        expect(outcome.failureReasons).toEqual([]);
+    });
+    it('refuses to pass output with no jest report in it', () => {
+        // Absence of failure was previously read as success, so an empty log passed.
+        const outcome = evaluateTestOutcome('some unrelated chatter', {
+            requireTestReport: true,
+        });
+        expect(outcome.success).toBe(false);
+        expect(outcome.failureReasons.join()).toContain('no jest report');
+    });
+    it('exempts probe runs, which have no jest in them at all', () => {
+        const outcome = evaluateTestOutcome('hello from a probe script');
+        expect(outcome.success).toBe(true);
+    });
+    it('fails on a traceback even when every test passed', () => {
+        // Jest cannot see a deferred-callback crash: it fires outside any test.
+        const logs = [
+            'Tests: 155 passed, 155 total',
+            'attempt to index nil',
+            'Stack Begin',
+            "Script 'ServerScriptService.egghunt2026.Foo', Line 12",
+            'Stack End',
+        ].join('\n');
+        const outcome = evaluateTestOutcome(logs, { requireTestReport: true });
+        expect(outcome.success).toBe(false);
+        expect(outcome.failureReasons.join()).toContain('traceback');
+    });
+    it('reports every reason a run failed, not just the first', () => {
+        const logs = [
+            'Tests: 19 failed, 470 passed, 516 total',
+            'Stack Begin',
+            "Script 'ServerScriptService.egghunt2026.Foo', Line 12",
+            'Stack End',
+        ].join('\n');
+        const outcome = evaluateTestOutcome(logs, { requireTestReport: true });
+        expect(outcome.failureReasons).toHaveLength(2);
+    });
+});
+describe('hasTestReport', () => {
+    it('accepts a runner that ran and found nothing', () => {
+        // Packages without specs are legitimate; passWithNoTests depends on this.
+        expect(hasTestReport('No tests found, exiting with code 0')).toBe(true);
+    });
+    it('rejects silence', () => {
+        expect(hasTestReport('')).toBe(false);
+    });
+});
+//# sourceMappingURL=test-log-parser.test.js.map

package/dist/utils/testing/test-log-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-log-parser.test.js","sourceRoot":"","sources":["../../../src/utils/testing/test-log-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1E,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,mBAAmB,CAAC,8BAA8B,EAAE;YAClE,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,6EAA6E;QAC7E,MAAM,OAAO,GAAG,mBAAmB,CAAC,wBAAwB,EAAE;YAC5D,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,OAAO,GAAG,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;QAEjE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,wEAAwE;QACxE,MAAM,IAAI,GAAG;YACX,8BAA8B;YAC9B,sBAAsB;YACtB,aAAa;YACb,uDAAuD;YACvD,WAAW;SACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG;YACX,yCAAyC;YACzC,aAAa;YACb,uDAAuD;YACvD,WAAW;SACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,0EAA0E;QAC1E,MAAM,CAAC,aAAa,CAAC,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/watch/github-context.d.ts

@@ -0,0 +1,50 @@
+/** Everything the watch service needs to dispatch a workflow back at us. */
+export interface GithubDispatchContext {
+    /** `owner/repo`. */
+    repository: string;
+    /** Git ref the dispatched workflow should run on. */
+    ref: string;
+    /** Token the service dispatches with; absent when none was provided. */
+    token?: string;
+}
+export interface GithubContextOptions {
+    /**
+     * Read the token from the GitHub CLI when no environment variable supplies
+     * one.
+     *
+     * Off unless asked for, and that is the whole point. Registering sends a PAT
+     * to the watch service and creates a monitor against the repository, so the
+     * credential has to be one the user handed over — an env var is handing it
+     * over, reading whatever `gh` happens to be holding is not. Nearly every
+     * developer machine has a logged-in `gh`, so defaulting this on would turn a
+     * command that used to watch locally into one that quietly ships a token.
+     */
+    useGhAuth?: boolean;
+}
+export type GithubContextResult = {
+    success: true;
+    context: GithubDispatchContext;
+} | {
+    success: false;
+    reason: 'no_repository' | 'no_ref' | 'undispatchable_ref';
+};
+/**
+ * Work out which repo and ref a watch should dispatch.
+ *
+ * Prefers the Actions environment, which is authoritative when we are already
+ * running inside the workflow being registered, and falls back to the git
+ * remote so `--watch <url>` also works from a developer's machine. Best-effort:
+ * outside a git repo with no Actions env there is simply nothing to dispatch.
+ */
+export declare function tryResolveGithubDispatchContext(options?: GithubContextOptions): GithubContextResult;
+/** Human-facing explanation for a failed context resolution. */
+export declare function describeGithubContextFailure(reason: 'no_repository' | 'no_ref' | 'undispatchable_ref'): string;
+/** Hint printed when a cloud registration has no credential to hand over. */
+export declare function describeMissingWatchToken(): string;
+/**
+ * Pull `owner/repo` out of a git remote URL. Handles the HTTPS, SCP-style, and
+ * ssh:// spellings git hands out, and ignores non-GitHub hosts — a watch
+ * registration names a GitHub workflow, so anything else is not dispatchable.
+ */
+export declare function parseGithubRepository(remoteUrl: string): string | undefined;
+//# sourceMappingURL=github-context.d.ts.map

package/dist/utils/watch/github-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-context.d.ts","sourceRoot":"","sources":["../../../src/utils/watch/github-context.ts"],"names":[],"mappings":"AAUA,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GACjD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,eAAe,GAAG,QAAQ,GAAG,oBAAoB,CAAC;CAC3D,CAAC;AAqBN;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAsBrB;AAED,gEAAgE;AAChE,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,eAAe,GAAG,QAAQ,GAAG,oBAAoB,GACxD,MAAM,CAoBR;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,IAAI,MAAM,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU3E"}