@alwaysmeticulous/cli 2.304.0 → 2.305.0

package/dist/command-utils/common-options.d.ts

@@ -7,6 +7,11 @@ export declare const OPTIONS: {
     readonly commitSha: {
         readonly string: true;
     };
+    readonly dryRun: {
+        readonly boolean: true;
+        readonly default: false;
+        readonly description: "Print what the command would do without making any changes";
+    };
     readonly headless: {
         readonly boolean: true;
         readonly description: "Start browser in headless mode";

package/dist/command-utils/common-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common-options.d.ts","sourceRoot":"","sources":["../../src/command-utils/common-options.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAGjE,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmIV,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBjC,CAAC"}
+{"version":3,"file":"common-options.d.ts","sourceRoot":"","sources":["../../src/command-utils/common-options.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAGjE,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwIV,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBjC,CAAC"}

package/dist/command-utils/common-options.js

@@ -1,5 +1,5 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4ecb7539-d537-5191-924b-b276cb7eabb3")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="bbd4b813-4f7b-5335-8b4e-e4eae64bcd67")}catch(e){}}();
 
 // We keep all options that are used by multiple commands in one file.
 // This ensures the defaults and descriptions stay in sync. Where we do want
@@ -24,6 +24,11 @@ exports.OPTIONS = {
     commitSha: {
         string: true,
     },
+    dryRun: {
+        boolean: true,
+        default: false,
+        description: "Print what the command would do without making any changes",
+    },
     headless: {
         // Note: when running in CI we default to headless (see DEFAULT_EXECUTION_OPTIONS), but for local runs via the CLI we use headed mode by default
         boolean: true,
@@ -188,4 +193,4 @@ exports.COMMON_RECORD_OPTIONS = {
     },
 };
 //# sourceMappingURL=common-options.js.map
-//# debugId=4ecb7539-d537-5191-924b-b276cb7eabb3
+//# debugId=bbd4b813-4f7b-5335-8b4e-e4eae64bcd67

package/dist/command-utils/common-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"common-options.js","sources":["../../src/command-utils/common-options.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"4ecb7539-d537-5191-924b-b276cb7eabb3"}
+{"version":3,"file":"common-options.js","sources":["../../src/command-utils/common-options.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"bbd4b813-4f7b-5335-8b4e-e4eae64bcd67"}

package/dist/command-utils/json-args.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse the `--jsonArgs` / `--rawJson` value: a JSON object whose keys are
+ * merged onto the parsed argv (the agent/programmatic way to pass options).
+ * Throws a `CliUserError` — rather than letting a raw `SyntaxError` escape as an
+ * uncaught stack trace — so malformed input surfaces as a clean message.
+ *
+ * Every key is validated against `knownKeys` (every option/alias the CLI
+ * declares). This is what would otherwise be yargs' `.strict()` check — the
+ * merge onto argv bypasses it — and, since the merge is a plain
+ * `Object.assign`, rejecting unknown keys also closes off prototype-polluting
+ * ones (`__proto__`, `constructor`, …), which are never option names.
+ */
+export declare const parseJsonArgs: (jsonArgs: string, knownKeys: Set<string>) => Record<string, unknown>;
+//# sourceMappingURL=json-args.d.ts.map

package/dist/command-utils/json-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-args.d.ts","sourceRoot":"","sources":["../../src/command-utils/json-args.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,aACd,MAAM,aACL,GAAG,CAAC,MAAM,CAAC,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAmBxB,CAAC"}

package/dist/command-utils/json-args.js

@@ -0,0 +1,40 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3c85a656-a6bd-5bdc-bc2b-fffe9208a683")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJsonArgs = void 0;
+const cli_user_error_1 = require("../utils/cli-user-error");
+/**
+ * Parse the `--jsonArgs` / `--rawJson` value: a JSON object whose keys are
+ * merged onto the parsed argv (the agent/programmatic way to pass options).
+ * Throws a `CliUserError` — rather than letting a raw `SyntaxError` escape as an
+ * uncaught stack trace — so malformed input surfaces as a clean message.
+ *
+ * Every key is validated against `knownKeys` (every option/alias the CLI
+ * declares). This is what would otherwise be yargs' `.strict()` check — the
+ * merge onto argv bypasses it — and, since the merge is a plain
+ * `Object.assign`, rejecting unknown keys also closes off prototype-polluting
+ * ones (`__proto__`, `constructor`, …), which are never option names.
+ */
+const parseJsonArgs = (jsonArgs, knownKeys) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonArgs);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new cli_user_error_1.CliUserError(`--jsonArgs must be a valid JSON string: ${detail}`);
+    }
+    if (typeof parsed !== "object" || parsed == null || Array.isArray(parsed)) {
+        throw new cli_user_error_1.CliUserError('--jsonArgs must be a JSON object, e.g. \'{"apiToken":"..."}\'.');
+    }
+    for (const key of Object.keys(parsed)) {
+        if (!knownKeys.has(key)) {
+            throw new cli_user_error_1.CliUserError(`--jsonArgs contains an unknown option "${key}".`);
+        }
+    }
+    return parsed;
+};
+exports.parseJsonArgs = parseJsonArgs;
+//# sourceMappingURL=json-args.js.map
+//# debugId=3c85a656-a6bd-5bdc-bc2b-fffe9208a683

package/dist/command-utils/json-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-args.js","sources":["../../src/command-utils/json-args.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAA,4DAAuD;AAEvD;;;;;;;;;;;GAWG;AACI,MAAM,aAAa,GAAG,CAC3B,QAAgB,EAChB,SAAsB,EACG,EAAE;IAC3B,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,6BAAY,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,6BAAY,CACpB,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,6BAAY,CAAC,0CAA0C,GAAG,IAAI,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC,CAAC;AAtBW,QAAA,aAAa,iBAsBxB","debugId":"3c85a656-a6bd-5bdc-bc2b-fffe9208a683"}

package/dist/command-utils/json-args.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json-args.spec.d.ts.map

package/dist/command-utils/json-args.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-args.spec.d.ts","sourceRoot":"","sources":["../../src/command-utils/json-args.spec.ts"],"names":[],"mappings":""}

package/dist/command-utils/json-args.spec.js

@@ -0,0 +1,37 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cdd72ac3-a982-5786-891a-a02e09335d22")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const json_args_1 = require("./json-args");
+const cli_user_error_1 = require("../utils/cli-user-error");
+const KNOWN = new Set(["apiToken", "json"]);
+(0, vitest_1.describe)("parseJsonArgs", () => {
+    (0, vitest_1.it)("parses a JSON object of known keys into a record", () => {
+        (0, vitest_1.expect)((0, json_args_1.parseJsonArgs)('{"apiToken":"abc","json":true}', KNOWN)).toEqual({
+            apiToken: "abc",
+            json: true,
+        });
+    });
+    (0, vitest_1.it)("throws a CliUserError (not a raw SyntaxError) for malformed JSON", () => {
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)("{bad}", KNOWN)).toThrow(cli_user_error_1.CliUserError);
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)("{bad}", KNOWN)).toThrow(/valid JSON string/);
+    });
+    (0, vitest_1.it)("rejects non-object JSON (array, primitive)", () => {
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)("[1,2,3]", KNOWN)).toThrow(cli_user_error_1.CliUserError);
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)('"a string"', KNOWN)).toThrow(/JSON object/);
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)("null", KNOWN)).toThrow(/JSON object/);
+    });
+    (0, vitest_1.it)("rejects any key that is not a known option", () => {
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)('{"notAnOption":1}', KNOWN)).toThrow(/unknown option "notAnOption"/);
+    });
+    (0, vitest_1.it)("rejects prototype-polluting keys (they are never known options)", () => {
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)('{"__proto__":{"polluted":true}}', KNOWN)).toThrow(/unknown option "__proto__"/);
+        (0, vitest_1.expect)(() => (0, json_args_1.parseJsonArgs)('{"constructor":{}}', KNOWN)).toThrow(/unknown option "constructor"/);
+        // A valid object of known keys must still parse and keep a clean prototype.
+        const parsed = (0, json_args_1.parseJsonArgs)('{"apiToken":"abc"}', KNOWN);
+        (0, vitest_1.expect)(Object.getPrototypeOf(parsed)).toBe(Object.prototype);
+    });
+});
+//# sourceMappingURL=json-args.spec.js.map
+//# debugId=cdd72ac3-a982-5786-891a-a02e09335d22

package/dist/command-utils/json-args.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-args.spec.js","sources":["../../src/command-utils/json-args.spec.ts"],"sourceRoot":"","names":[],"mappings":";;;;AAAA,mCAA8C;AAC9C,2CAA4C;AAC5C,4DAAuD;AAEvD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5C,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAA,WAAE,EAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,IAAA,eAAM,EAAC,IAAA,yBAAa,EAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YACrE,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,6BAAY,CAAC,CAAC;QAClE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,6BAAY,CAAC,CAAC;QACpE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACxE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAC7D,8BAA8B,CAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,IAAA,eAAM,EAAC,GAAG,EAAE,CACV,IAAA,yBAAa,EAAC,iCAAiC,EAAE,KAAK,CAAC,CACxD,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAC9D,8BAA8B,CAC/B,CAAC;QACF,4EAA4E;QAC5E,MAAM,MAAM,GAAG,IAAA,yBAAa,EAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAA,eAAM,EAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","debugId":"cdd72ac3-a982-5786-891a-a02e09335d22"}

package/dist/command-utils/print-json.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prints a value as pretty-printed JSON on stdout — the single formatting
+ * decision (2-space indent, trailing newline) shared by every command's
+ * `--json` output, so machine-readable output stays consistent.
+ */
+export declare const printJson: (value: unknown) => void;
+//# sourceMappingURL=print-json.d.ts.map

package/dist/command-utils/print-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-json.d.ts","sourceRoot":"","sources":["../../src/command-utils/print-json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,IAE1C,CAAC"}

package/dist/command-utils/print-json.js

@@ -0,0 +1,16 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ce55db0d-3eb9-5c20-9ce0-365273d93dae")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printJson = void 0;
+/**
+ * Prints a value as pretty-printed JSON on stdout — the single formatting
+ * decision (2-space indent, trailing newline) shared by every command's
+ * `--json` output, so machine-readable output stays consistent.
+ */
+const printJson = (value) => {
+    console.log(JSON.stringify(value, null, 2));
+};
+exports.printJson = printJson;
+//# sourceMappingURL=print-json.js.map
+//# debugId=ce55db0d-3eb9-5c20-9ce0-365273d93dae

package/dist/command-utils/print-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-json.js","sources":["../../src/command-utils/print-json.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAA;;;;GAIG;AACI,MAAM,SAAS,GAAG,CAAC,KAAc,EAAQ,EAAE;IAChD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB","debugId":"ce55db0d-3eb9-5c20-9ce0-365273d93dae"}

package/dist/commands/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAY3C,eAAO,MAAM,YAAY,EAAE,aA0B1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAY3C,eAAO,MAAM,YAAY,EAAE,aAmC1B,CAAC"}

package/dist/commands/agent/index.js

@@ -1,5 +1,5 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="62add581-6176-55db-91f7-9c921c7f11e2")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="aef0683f-1816-539c-ae2a-39b450a18844")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.agentCommand = void 0;
@@ -15,7 +15,7 @@ const trigger_test_run_command_1 = require("./trigger-test-run.command");
 const upload_build_command_1 = require("./upload-build.command");
 exports.agentCommand = {
     command: "agent",
-    describe: "Agent commands for triggering and analysing test runs",
+    describe: "Agent commands for retrieving data from and interacting with Meticulous",
     builder: (yargs) => yargs
         .command(upload_build_command_1.uploadBuildCommand)
         .command(trigger_test_run_command_1.triggerTestRunCommand)
@@ -30,7 +30,14 @@ exports.agentCommand = {
         .option("verbose", {
         boolean: true,
         default: false,
-        description: "Print progress logs. Defaults to false for agent commands — without it only essential output (e.g. the deploymentId) is printed.",
+        description: "Print additional logs like progress updates. Without it, only the actual output value or table is printed.",
+    })
+        .option("json", {
+        boolean: true,
+        default: false,
+        description: "Output the result as JSON. Only stdout is affected — progress and " +
+            "notices still go to stderr — and stdout is always valid JSON, " +
+            "including an empty array/object when there is no result.",
     })
         .demandCommand()
         .help(),
@@ -39,4 +46,4 @@ exports.agentCommand = {
     },
 };
 //# sourceMappingURL=index.js.map
-//# debugId=62add581-6176-55db-91f7-9c921c7f11e2
+//# debugId=aef0683f-1816-539c-ae2a-39b450a18844

package/dist/commands/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/commands/agent/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,yEAAmE;AACnE,+DAA0D;AAC1D,+EAA+D;AAC/D,qFAAqE;AACrE,yEAA8D;AAC9D,qEAA+D;AAC/D,+EAAwE;AACxE,yDAAyD;AACzD,yEAAmE;AACnE,iEAA4D;AAE/C,QAAA,YAAY,GAAkB;IACzC,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,uDAAuD;IACjE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,yCAAkB,CAAC;SAC3B,OAAO,CAAC,gDAAqB,CAAC;SAC9B,OAAO,CAAC,4CAAmB,CAAC;SAC5B,OAAO,CAAC,4CAAc,CAAC;SACvB,OAAO,CAAC,qDAAuB,CAAC;SAChC,OAAO,CAAC,uCAAiB,CAAC;SAC1B,OAAO,CAAC,gDAAqB,CAAC;SAC9B,OAAO,CAAC,kDAAiB,CAAC;SAC1B,OAAO,CAAC,2CAAgB,CAAC;SACzB,OAAO,CAAC,sCAAmB,CAAC;SAC5B,MAAM,CAAC,SAAS,EAAE;QACjB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EACT,kIAAkI;KACrI,CAAC;SACD,aAAa,EAAE;SACf,IAAI,EAAE;IACX,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"62add581-6176-55db-91f7-9c921c7f11e2"}
+{"version":3,"file":"index.js","sources":["../../../src/commands/agent/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,yEAAmE;AACnE,+DAA0D;AAC1D,+EAA+D;AAC/D,qFAAqE;AACrE,yEAA8D;AAC9D,qEAA+D;AAC/D,+EAAwE;AACxE,yDAAyD;AACzD,yEAAmE;AACnE,iEAA4D;AAE/C,QAAA,YAAY,GAAkB;IACzC,OAAO,EAAE,OAAO;IAChB,QAAQ,EACN,yEAAyE;IAC3E,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,yCAAkB,CAAC;SAC3B,OAAO,CAAC,gDAAqB,CAAC;SAC9B,OAAO,CAAC,4CAAmB,CAAC;SAC5B,OAAO,CAAC,4CAAc,CAAC;SACvB,OAAO,CAAC,qDAAuB,CAAC;SAChC,OAAO,CAAC,uCAAiB,CAAC;SAC1B,OAAO,CAAC,gDAAqB,CAAC;SAC9B,OAAO,CAAC,kDAAiB,CAAC;SAC1B,OAAO,CAAC,2CAAgB,CAAC;SACzB,OAAO,CAAC,sCAAmB,CAAC;SAC5B,MAAM,CAAC,SAAS,EAAE;QACjB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EACT,4GAA4G;KAC/G,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EACT,oEAAoE;YACpE,gEAAgE;YAChE,0DAA0D;KAC7D,CAAC;SACD,aAAa,EAAE;SACf,IAAI,EAAE;IACX,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"aef0683f-1816-539c-ae2a-39b450a18844"}

package/dist/commands/agent/js-coverage-diff.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"js-coverage-diff.command.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/js-coverage-diff.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,UAAU,OAAO;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AA+DD,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAkCjE,CAAC"}
+{"version":3,"file":"js-coverage-diff.command.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/js-coverage-diff.command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAK3C,UAAU,OAAO;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AA6DD,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CA6BjE,CAAC"}

package/dist/commands/agent/js-coverage-diff.command.js

@@ -1,13 +1,13 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="60e94b8d-4609-5c30-86c1-5132de3a03cc")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="aaff74c8-4b9c-5cc4-9df3-c8c20b83b491")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.jsCoverageDiffCommand = void 0;
 const client_1 = require("@alwaysmeticulous/client");
 const common_1 = require("@alwaysmeticulous/common");
+const print_json_1 = require("../../command-utils/print-json");
 const sentry_utils_1 = require("../../command-utils/sentry.utils");
 const format_coverage_ranges_1 = require("../../utils/format-coverage-ranges");
-const log = (...args) => process.stderr.write(args.join(" ") + "\n");
 const handler = async ({ apiToken, replayDiffId, screenshotName, includeAllFiles, globFilter, json, }) => {
     (0, common_1.initLogger)();
     const client = await (0, client_1.createClientWithOAuth)({
@@ -18,40 +18,38 @@ const handler = async ({ apiToken, replayDiffId, screenshotName, includeAllFiles
         includeAllFiles,
         globFilter,
     });
+    const added = result.diff.filter((d) => d.status === "added").length;
+    const removed = result.diff.filter((d) => d.status === "removed").length;
+    const modified = result.diff.filter((d) => d.status === "modified").length;
     if (json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
+        (0, print_json_1.printJson)(result.diff.map((d) => ({
+            repoFilePath: d.filePath,
+            status: d.status,
+            baseRanges: d.baseRanges,
+            headRanges: d.headRanges,
+        })));
     }
-    const header = ["repoFilePath", "status", "baseRanges", "headRanges"];
-    console.log(header.join("\t"));
-    let added = 0;
-    let removed = 0;
-    let modified = 0;
-    for (const d of result.diff) {
-        if (d.status === "added") {
-            added++;
+    else {
+        const header = ["repoFilePath", "status", "baseRanges", "headRanges"];
+        console.log(header.join("\t"));
+        for (const d of result.diff) {
+            const fields = [
+                d.filePath,
+                d.status,
+                (0, format_coverage_ranges_1.formatCoverageRanges)(d.baseRanges),
+                (0, format_coverage_ranges_1.formatCoverageRanges)(d.headRanges),
+            ];
+            console.log(fields.join("\t"));
         }
-        else if (d.status === "removed") {
-            removed++;
-        }
-        else if (d.status === "modified") {
-            modified++;
-        }
-        const fields = [
-            d.filePath,
-            d.status,
-            (0, format_coverage_ranges_1.formatCoverageRanges)(d.baseRanges),
-            (0, format_coverage_ranges_1.formatCoverageRanges)(d.headRanges),
-        ];
-        console.log(fields.join("\t"));
     }
-    log(`${result.diff.length} file(s) with coverage changes ` +
+    // Summary on stderr regardless of --json (which only changes stdout).
+    (0, common_1.logNotice)(`${result.diff.length} file(s) with coverage changes ` +
         `(${added} added, ${removed} removed, ${modified} modified); ` +
         `base ${result.base?.length ?? 0} file(s), head ${result.head?.length ?? 0} file(s)`);
 };
 exports.jsCoverageDiffCommand = {
     command: "js-coverage-diff",
-    describe: "Get the JS coverage diff (base vs head) for a replay diff, for a single screenshot or the whole replay",
+    describe: "Get the JS coverage diff for a replay diff. Outputs TSV, one row per changed file: repoFilePath, status, baseRanges, headRanges (or JSON with --json).",
     builder: {
         apiToken: { string: true, description: "Meticulous API token" },
         replayDiffId: {
@@ -72,13 +70,8 @@ exports.jsCoverageDiffCommand = {
             string: true,
             description: 'Keep only repo file paths matching this gitignore-style glob, e.g. "src/components/**". Scopes base, head, and the diff.',
         },
-        json: {
-            boolean: true,
-            description: "Output the raw coverage response as JSON",
-            default: false,
-        },
     },
     handler: (0, sentry_utils_1.wrapHandler)(handler),
 };
 //# sourceMappingURL=js-coverage-diff.command.js.map
-//# debugId=60e94b8d-4609-5c30-86c1-5132de3a03cc
+//# debugId=aaff74c8-4b9c-5cc4-9df3-c8c20b83b491

package/dist/commands/agent/js-coverage-diff.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"js-coverage-diff.command.js","sources":["../../../src/commands/agent/js-coverage-diff.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"60e94b8d-4609-5c30-86c1-5132de3a03cc"}
+{"version":3,"file":"js-coverage-diff.command.js","sources":["../../../src/commands/agent/js-coverage-diff.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"aaff74c8-4b9c-5cc4-9df3-c8c20b83b491"}

package/dist/commands/agent/js-coverage.command.d.ts

@@ -1,3 +1,4 @@
+import type { CompactRange, TestRunCoverageFile } from "@alwaysmeticulous/client";
 import type { CommandModule } from "yargs";
 export interface Options {
     apiToken?: string | null | undefined;
@@ -18,6 +19,8 @@ export interface Options {
 type CoverageColumn = "executedRanges" | "executableRanges" | "uncoveredRanges" | "coveragePercentage";
 export declare const assertTestRunOnlyFlagsUnsetForReplay: (options: Options) => void;
 export declare const determineColumns: (options: Options) => CoverageColumn[];
+export declare const coverageFileToJson: (file: TestRunCoverageFile, columns: CoverageColumn[]) => Record<string, unknown>;
+export declare const coverageColumnValue: (file: TestRunCoverageFile, column: CoverageColumn) => CompactRange[] | number | null;
 export declare const isAmbiguousTestRunError: (error: unknown) => boolean;
 export declare const jsCoverageCommand: CommandModule<unknown, Options>;
 export {};

package/dist/commands/agent/js-coverage.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"js-coverage.command.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/js-coverage.command.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAY3C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,4BAA4B,EAAE,OAAO,CAAC;IACtC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uBAAuB,EAAE,OAAO,CAAC;IACjC,sBAAsB,EAAE,OAAO,CAAC;IAChC,yBAAyB,EAAE,OAAO,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAMD,KAAK,cAAc,GACf,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,oBAAoB,CAAC;AAgHzB,eAAO,MAAM,oCAAoC,YACtC,OAAO,KACf,IAgBF,CAAC;AAKF,eAAO,MAAM,gBAAgB,YAAa,OAAO,KAAG,cAAc,EAoBjE,CAAC;AAuLF,eAAO,MAAM,uBAAuB,UAAW,OAAO,KAAG,OAGjC,CAAC;AAEzB,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAgF7D,CAAC"}
+{"version":3,"file":"js-coverage.command.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/js-coverage.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAGZ,mBAAmB,EAEpB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAa3C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,4BAA4B,EAAE,OAAO,CAAC;IACtC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uBAAuB,EAAE,OAAO,CAAC;IACjC,sBAAsB,EAAE,OAAO,CAAC;IAChC,yBAAyB,EAAE,OAAO,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAMD,KAAK,cAAc,GACf,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,oBAAoB,CAAC;AAsHzB,eAAO,MAAM,oCAAoC,YACtC,OAAO,KACf,IAgBF,CAAC;AAKF,eAAO,MAAM,gBAAgB,YAAa,OAAO,KAAG,cAAc,EAoBjE,CAAC;AAwKF,eAAO,MAAM,kBAAkB,SACvB,mBAAmB,WAChB,cAAc,EAAE,KACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAMxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,SACxB,mBAAmB,UACjB,cAAc,KACrB,YAAY,EAAE,GAAG,MAAM,GAAG,IAa5B,CAAC;AA2BF,eAAO,MAAM,uBAAuB,UAAW,OAAO,KAAG,OAGjC,CAAC;AAEzB,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CA2E7D,CAAC"}

package/dist/commands/agent/js-coverage.command.js

@@ -1,10 +1,11 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="22f8ecf6-63eb-52da-8d14-cd9b32b8c54d")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7c46427f-0bd8-5b44-89b2-acad6e9443bb")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.jsCoverageCommand = exports.isAmbiguousTestRunError = exports.determineColumns = exports.assertTestRunOnlyFlagsUnsetForReplay = void 0;
+exports.jsCoverageCommand = exports.isAmbiguousTestRunError = exports.coverageColumnValue = exports.coverageFileToJson = exports.determineColumns = exports.assertTestRunOnlyFlagsUnsetForReplay = void 0;
 const client_1 = require("@alwaysmeticulous/client");
 const common_1 = require("@alwaysmeticulous/common");
+const print_json_1 = require("../../command-utils/print-json");
 const sentry_utils_1 = require("../../command-utils/sentry.utils");
 const cli_user_error_1 = require("../../utils/cli-user-error");
 const format_coverage_ranges_1 = require("../../utils/format-coverage-ranges");
@@ -17,7 +18,6 @@ const COVERAGE_COLUMN_FLAG = {
     uncoveredRanges: "includeUncoveredRanges",
     coveragePercentage: "includeCoveragePercentage",
 };
-const log = (...args) => process.stderr.write(args.join(" ") + "\n");
 const handler = async (options) => {
     const { apiToken, testRunId, commitSha, dontWaitForTestRunToComplete, replayId, screenshotName, globFilter, json, } = options;
     (0, common_1.initLogger)();
@@ -73,6 +73,15 @@ const handler = async (options) => {
         }
         const finishedStatus = await (0, resolve_test_run_from_commit_1.ensureTestRunFinished)(client, resolvedTestRunId, status, { dontWait: dontWaitForTestRunToComplete });
         if (finishedStatus == null) {
+            // Keep stdout's shape stable: an unfinished run has no coverage yet, so
+            // emit the empty JSON array / a header-only TSV (matching a finished run
+            // with zero files) rather than nothing — the notice went to stderr.
+            if (json) {
+                console.log("[]");
+            }
+            else {
+                console.log(["repoFilePath", ...columns].join("\t"));
+            }
             return;
         }
         // Reject session-pool bases (Partial); fatal failures already threw.
@@ -166,7 +175,7 @@ const printReplayCoverage = async (client, apiToken, { testRunId, commitSha, rep
                     });
                     // Only announce the fallback once it has actually worked, so a doomed
                     // retry doesn't leave a misleading "retrying against run X" line.
-                    log(`Replay is the head of multiple test runs; resolved coverage against test run ${fallback.testRunId} from the local commit.`);
+                    (0, common_1.logNotice)(`Replay is the head of multiple test runs; resolved coverage against test run ${fallback.testRunId} from the local commit.`);
                     printReplayResult(result, json);
                     return;
                 }
@@ -182,18 +191,23 @@ const printReplayCoverage = async (client, apiToken, { testRunId, commitSha, rep
     }
 };
 const printReplayResult = (result, json) => {
-    if (json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    console.log(["repoFilePath", "executedRanges"].join("\t"));
     // Replay coverage is keyed by repo path (source-map paths that don't resolve
     // are dropped), matching the test-run shape.
     const files = result.files ?? [];
-    for (const [filePath, ranges] of files) {
-        console.log([filePath, (0, format_coverage_ranges_1.formatCoverageRanges)(ranges)].join("\t"));
+    if (json) {
+        (0, print_json_1.printJson)(files.map(([repoFilePath, executedRanges]) => ({
+            repoFilePath,
+            executedRanges,
+        })));
+    }
+    else {
+        console.log(["repoFilePath", "executedRanges"].join("\t"));
+        for (const [filePath, ranges] of files) {
+            console.log([filePath, (0, format_coverage_ranges_1.formatCoverageRanges)(ranges)].join("\t"));
+        }
     }
-    log(`${files.length} file(s) with coverage`);
+    // Summary on stderr regardless of --json (which only changes stdout).
+    (0, common_1.logNotice)(`${files.length} file(s) with coverage`);
 };
 const printTestRunCoverage = async (client, testRunId, options, columns, json) => {
     // Send the resolved columns as explicit flags (the default-to-executed rule
@@ -210,47 +224,76 @@ const printTestRunCoverage = async (client, testRunId, options, columns, json) =
     requestOptions.prDiffOnly = options.prDiffOnly;
     const result = await (0, client_1.getTestRunJsCoverage)(client, testRunId, requestOptions);
     if (json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
+        (0, print_json_1.printJson)(result.files.map((file) => (0, exports.coverageFileToJson)(file, columns)));
     }
-    // Test-run coverage is the precomputed repo-mapped coverage, keyed by repo
-    // paths. Emit `repoFilePath` then the requested columns in fixed order.
-    console.log(["repoFilePath", ...columns].join("\t"));
-    for (const file of result.files) {
-        const fields = [
-            file.repoFilePath,
-            ...columns.map((column) => formatCoverageColumn(file, column)),
-        ];
-        console.log(fields.join("\t"));
+    else {
+        // Test-run coverage is the precomputed repo-mapped coverage, keyed by repo
+        // paths. Emit `repoFilePath` then the requested columns in fixed order.
+        console.log(["repoFilePath", ...columns].join("\t"));
+        for (const file of result.files) {
+            const fields = [
+                file.repoFilePath,
+                ...columns.map((column) => formatCoverageColumn(file, column)),
+            ];
+            console.log(fields.join("\t"));
+        }
     }
-    log(`${result.files.length} file(s)`);
+    // Summary on stderr regardless of --json (which only changes stdout).
+    (0, common_1.logNotice)(`${result.files.length} file(s)`);
 };
-const formatCoverageColumn = (file, column) => {
+// The JSON equivalent of a TSV row: `repoFilePath` plus the requested columns,
+// with structured values (raw ranges / numeric percentage) rather than the
+// TSV-formatted strings.
+const coverageFileToJson = (file, columns) => {
+    const row = { repoFilePath: file.repoFilePath };
+    for (const column of columns) {
+        row[column] = (0, exports.coverageColumnValue)(file, column);
+    }
+    return row;
+};
+exports.coverageFileToJson = coverageFileToJson;
+const coverageColumnValue = (file, column) => {
     switch (column) {
         case "executedRanges":
-            return (0, format_coverage_ranges_1.formatCoverageRanges)(file.executedRanges ?? []);
+            return file.executedRanges ?? [];
         case "executableRanges":
-            return (0, format_coverage_ranges_1.formatCoverageRanges)(file.executableRanges ?? []);
+            return file.executableRanges ?? [];
         case "uncoveredRanges":
-            return (0, format_coverage_ranges_1.formatCoverageRanges)(file.uncoveredRanges ?? []);
+            return file.uncoveredRanges ?? [];
         case "coveragePercentage":
-            return file.coveragePercentage == null
-                ? "n/a"
-                : file.coveragePercentage.toFixed(1);
-        default: {
-            // Exhaustiveness guard: a new CoverageColumn must be handled above.
-            const exhaustive = column;
-            throw new Error(`Unhandled coverage column: ${String(exhaustive)}`);
-        }
+            return file.coveragePercentage ?? null;
+        default:
+            return assertNever(column);
     }
 };
+exports.coverageColumnValue = coverageColumnValue;
+// The TSV rendering of a column: the same structured value as the JSON output,
+// formatted as a string (ranges joined, percentage to 1dp, absent percentage as
+// "n/a"). Delegating to `coverageColumnValue` keeps a single switch over the
+// column union.
+const formatCoverageColumn = (file, column) => {
+    const value = (0, exports.coverageColumnValue)(file, column);
+    if (typeof value === "number") {
+        return value.toFixed(1);
+    }
+    if (value == null) {
+        return "n/a";
+    }
+    return (0, format_coverage_ranges_1.formatCoverageRanges)(value);
+};
+// Exhaustiveness guard for the CoverageColumn switch in `coverageColumnValue`.
+// Local to this package since the public CLI can't depend on the internal
+// common-utils helper.
+const assertNever = (value) => {
+    throw new Error(`Unhandled coverage column: ${String(value)}`);
+};
 const isAmbiguousTestRunError = (error) => (0, client_1.isFetchError)(error) &&
     error.response?.data?.reason ===
         "ambiguous-test-run";
 exports.isAmbiguousTestRunError = isAmbiguousTestRunError;
 exports.jsCoverageCommand = {
     command: "js-coverage",
-    describe: "Get JS coverage for a single replay or a whole test run (use js-coverage-diff for base vs head)",
+    describe: "Get JS coverage for a whole test run or a single replay. Outputs TSV, one row per repo file: repoFilePath plus the requested coverage columns (or JSON with --json).",
     builder: {
         apiToken: { string: true, description: "Meticulous API token" },
         testRunId: {
@@ -308,13 +351,8 @@ exports.jsCoverageCommand = {
             default: false,
             description: "Return only coverage for files changed in the PR diff (from coverage.pr.json). Whole-test-run coverage only.",
         },
-        json: {
-            boolean: true,
-            description: "Output the raw coverage response as JSON",
-            default: false,
-        },
     },
     handler: (0, sentry_utils_1.wrapHandler)(handler),
 };
 //# sourceMappingURL=js-coverage.command.js.map
-//# debugId=22f8ecf6-63eb-52da-8d14-cd9b32b8c54d
+//# debugId=7c46427f-0bd8-5b44-89b2-acad6e9443bb