@alwaysmeticulous/cli 2.292.1 → 2.293.0

package/dist/commands/agent/index.js

@@ -1,12 +1,15 @@
 "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]="8bd4e484-ad21-53f2-97d9-b51c7dc7986a")}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]="c6fd7be6-1c99-540f-91e8-a1e4aa24d9db")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.agentCommand = void 0;
+const js_coverage_diff_command_1 = require("./js-coverage-diff.command");
+const js_coverage_command_1 = require("./js-coverage.command");
 const screenshot_dom_diff_command_1 = require("./screenshot-dom-diff.command");
 const screenshot_image_files_command_1 = require("./screenshot-image-files.command");
 const screenshot_image_command_1 = require("./screenshot-image.command");
 const test_run_diffs_command_1 = require("./test-run-diffs.command");
+const test_run_for_commit_command_1 = require("./test-run-for-commit.command");
 const timeline_command_1 = require("./timeline.command");
 exports.agentCommand = {
     command: "agent",
@@ -14,6 +17,9 @@ exports.agentCommand = {
     builder: (yargs) => yargs
         .command(test_run_diffs_command_1.testRunDiffsCommand)
         .command(screenshot_dom_diff_command_1.domDiffCommand)
+        .command(test_run_for_commit_command_1.testRunForCommitCommand)
+        .command(js_coverage_command_1.jsCoverageCommand)
+        .command(js_coverage_diff_command_1.jsCoverageDiffCommand)
         .command(screenshot_image_files_command_1.imageFilesCommand)
         .command(screenshot_image_command_1.imageUrlsCommand)
         .command(timeline_command_1.timelineDiffCommand)
@@ -24,4 +30,4 @@ exports.agentCommand = {
     },
 };
 //# sourceMappingURL=index.js.map
-//# debugId=8bd4e484-ad21-53f2-97d9-b51c7dc7986a
+//# debugId=c6fd7be6-1c99-540f-91e8-a1e4aa24d9db

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/commands/agent/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,+EAA+D;AAC/D,qFAAqE;AACrE,yEAA8D;AAC9D,qEAA+D;AAC/D,yDAAyD;AAE5C,QAAA,YAAY,GAAkB;IACzC,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,4CAAmB,CAAC;SAC5B,OAAO,CAAC,4CAAc,CAAC;SACvB,OAAO,CAAC,kDAAiB,CAAC;SAC1B,OAAO,CAAC,2CAAgB,CAAC;SACzB,OAAO,CAAC,sCAAmB,CAAC;SAC5B,aAAa,EAAE;SACf,IAAI,EAAE;IACX,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"8bd4e484-ad21-53f2-97d9-b51c7dc7986a"}
+{"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;AAE5C,QAAA,YAAY,GAAkB;IACzC,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,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,aAAa,EAAE;SACf,IAAI,EAAE;IACX,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"c6fd7be6-1c99-540f-91e8-a1e4aa24d9db"}

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

@@ -0,0 +1,9 @@
+import { CommandModule } from "yargs";
+interface Options {
+    apiToken?: string | null | undefined;
+    replayDiffId: string;
+    screenshotName: string | undefined;
+    json: boolean;
+}
+export declare const jsCoverageDiffCommand: CommandModule<unknown, Options>;
+export {};

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

@@ -0,0 +1,72 @@
+"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]="7d6dd7d6-e567-56ed-a00a-fb1b0fbbcb09")}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 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, json, }) => {
+    (0, common_1.initLogger)();
+    const client = await (0, client_1.createClientWithOAuth)({
+        apiToken,
+        enableOAuthLogin: true,
+    });
+    const result = await (0, client_1.getReplayDiffJsCoverage)(client, replayDiffId, screenshotName);
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    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 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 ` +
+        `(${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",
+    builder: {
+        apiToken: { string: true, description: "Meticulous API token" },
+        replayDiffId: {
+            string: true,
+            description: "The replay diff ID",
+            demandOption: true,
+        },
+        screenshotName: {
+            string: true,
+            description: 'Screenshot name (e.g. "after-event-5" or "end-state"). Omit for the whole-replay 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=7d6dd7d6-e567-56ed-a00a-fb1b0fbbcb09

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

@@ -0,0 +1 @@
+{"version":3,"file":"js-coverage-diff.command.js","sources":["../../../src/commands/agent/js-coverage-diff.command.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAA,qDAGkC;AAClC,qDAAsD;AAEtD,mEAA+D;AAC/D,+EAA0E;AAS1E,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AAEhF,MAAM,OAAO,GAAG,KAAK,EAAE,EACrB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,IAAI,GACI,EAAiB,EAAE;IAC3B,IAAA,mBAAU,GAAE,CAAC;IACb,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAqB,EAAC;QACzC,QAAQ;QACR,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAuB,EAC1C,MAAM,EACN,YAAY,EACZ,cAAc,CACf,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YACzB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACnC,QAAQ,EAAE,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG;YACb,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,MAAM;YACR,IAAA,6CAAoB,EAAC,CAAC,CAAC,UAAU,CAAC;YAClC,IAAA,6CAAoB,EAAC,CAAC,CAAC,UAAU,CAAC;SACnC,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CACD,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,iCAAiC;QACpD,IAAI,KAAK,WAAW,OAAO,aAAa,QAAQ,cAAc;QAC9D,QAAQ,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,kBAAkB,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,UAAU,CACvF,CAAC;AACJ,CAAC,CAAC;AAEW,QAAA,qBAAqB,GAAoC;IACpE,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EACN,wGAAwG;IAC1G,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE;QAC/D,YAAY,EAAE;YACZ,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,oBAAoB;YACjC,YAAY,EAAE,IAAI;SACnB;QACD,cAAc,EAAE;YACd,MAAM,EAAE,IAAI;YACZ,WAAW,EACT,wFAAwF;SAC3F;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,0CAA0C;YACvD,OAAO,EAAE,KAAK;SACf;KACF;IACD,OAAO,EAAE,IAAA,0BAAW,EAAC,OAAO,CAAC;CAC9B,CAAC","debugId":"7d6dd7d6-e567-56ed-a00a-fb1b0fbbcb09"}

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

@@ -0,0 +1,11 @@
+import { CommandModule } from "yargs";
+interface Options {
+    apiToken?: string | null | undefined;
+    replayId: string | undefined;
+    testRunId: string | undefined;
+    commitSha: string | undefined;
+    screenshotName: string | undefined;
+    json: boolean;
+}
+export declare const jsCoverageCommand: CommandModule<unknown, Options>;
+export {};

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

@@ -0,0 +1,168 @@
+"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]="8ab59c0a-1e32-51df-a4a5-0bf5ab020386")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsCoverageCommand = void 0;
+const client_1 = require("@alwaysmeticulous/client");
+const common_1 = require("@alwaysmeticulous/common");
+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");
+const resolve_test_run_from_commit_1 = require("../../utils/resolve-test-run-from-commit");
+const log = (...args) => process.stderr.write(args.join(" ") + "\n");
+const handler = async ({ apiToken, replayId, testRunId, commitSha, screenshotName, json, }) => {
+    (0, common_1.initLogger)();
+    if (screenshotName != null && replayId == null) {
+        throw new cli_user_error_1.CliUserError("--screenshotName only applies to --replayId.");
+    }
+    const apiToken_ = await (0, client_1.resolveApiTokenWithOAuth)({
+        apiToken,
+        enableOAuthLogin: true,
+    });
+    const client = (0, client_1.createClient)({ apiToken: apiToken_ });
+    // --replayId takes precedence: repo file paths are resolved against the run
+    // that executed the replay, and a --testRunId / --commitSha passed alongside
+    // it acts as a membership gate / disambiguator (see below) rather than
+    // selecting test-run coverage.
+    if (replayId != null) {
+        await printReplayCoverage(client, apiToken_, {
+            replayId,
+            screenshotName,
+            testRunId,
+            commitSha,
+            json,
+        });
+    }
+    else {
+        if (testRunId != null && commitSha != null) {
+            throw new cli_user_error_1.CliUserError("Pass either --testRunId or --commitSha, not both.");
+        }
+        // Test-run coverage: use --testRunId, else resolve the run from --commitSha
+        // or, when neither is given, from the local checkout's HEAD. Either way the
+        // run must have finished for coverage to exist.
+        if (testRunId != null) {
+            await (0, resolve_test_run_from_commit_1.throwIfTestRunCoverageNotReady)(client, testRunId);
+            await printTestRunCoverage(client, testRunId, json);
+        }
+        else {
+            const resolvedTestRunId = await resolveCompletedTestRunIdForCommit(client, apiToken_, commitSha);
+            await printTestRunCoverage(client, resolvedTestRunId, json);
+        }
+    }
+};
+// Resolves a commit to a test run for coverage. Coverage only exists once a run
+// has finished, so an in-progress run is reported as not-yet-available rather
+// than queried.
+const resolveCompletedTestRunIdForCommit = async (client, apiToken, commitSha) => {
+    const { testRunId, status } = await (0, resolve_test_run_from_commit_1.resolveTestRunForCommitOrThrow)(client, apiToken, commitSha);
+    if ((0, resolve_test_run_from_commit_1.isTestRunInProgress)(status)) {
+        throw new cli_user_error_1.CliUserError(`Test run ${testRunId} for this commit is still in progress (status: ${status}); coverage is not available yet.`);
+    }
+    return testRunId;
+};
+const printReplayCoverage = async (client, apiToken, { replayId, screenshotName, testRunId, commitSha, json, }) => {
+    // An explicit --commitSha selects the run client-side (the endpoint only
+    // understands testRunId); --testRunId is passed through as-is.
+    const effectiveTestRunId = testRunId ??
+        (commitSha != null
+            ? await resolveCompletedTestRunIdForCommit(client, apiToken, commitSha)
+            : undefined);
+    try {
+        const result = await (0, client_1.getReplayJsCoverage)(client, replayId, {
+            screenshotName,
+            testRunId: effectiveTestRunId,
+        });
+        printReplayResult(result, json);
+    }
+    catch (error) {
+        // When the caller gave us no run to anchor on and the replay is the head of
+        // several runs, the endpoint can't pick one. Fall back to the run for the
+        // local checkout's HEAD and retry; if that can't be resolved, surface the
+        // original (actionable "pass testRunId") error unchanged.
+        if (effectiveTestRunId == null && isAmbiguousTestRunError(error)) {
+            const fallback = await (0, resolve_test_run_from_commit_1.tryResolveTestRunForCommit)(client, apiToken, undefined);
+            // Only retry against a finished run — an in-progress one has no coverage.
+            if (fallback != null && !(0, resolve_test_run_from_commit_1.isTestRunInProgress)(fallback.status)) {
+                try {
+                    const result = await (0, client_1.getReplayJsCoverage)(client, replayId, {
+                        screenshotName,
+                        testRunId: fallback.testRunId,
+                    });
+                    // 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.`);
+                    printReplayResult(result, json);
+                    return;
+                }
+                catch {
+                    // The local-HEAD run doesn't contain this replay (e.g. inspecting a
+                    // replay from a different commit), so it can't disambiguate. Surface
+                    // the original, actionable "pass --testRunId" error instead.
+                    throw error;
+                }
+            }
+        }
+        throw error;
+    }
+};
+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"));
+    }
+    log(`${files.length} file(s) with coverage`);
+};
+const printTestRunCoverage = async (client, testRunId, json) => {
+    const result = await (0, client_1.getTestRunJsCoverage)(client, testRunId);
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(["repoFilePath", "executedRanges"].join("\t"));
+    // Test-run coverage is the precomputed repo-mapped coverage, keyed by repo paths.
+    for (const [filePath, ranges] of result.files) {
+        console.log([filePath, (0, format_coverage_ranges_1.formatCoverageRanges)(ranges)].join("\t"));
+    }
+    log(`${result.files.length} file(s) with coverage`);
+};
+const isAmbiguousTestRunError = (error) => (0, client_1.isFetchError)(error) &&
+    error.response?.data?.reason ===
+        "ambiguous-test-run";
+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)",
+    builder: {
+        apiToken: { string: true, description: "Meticulous API token" },
+        replayId: {
+            string: true,
+            description: "The replay ID. Pass the base or head replay to get each side's coverage. Repo file paths are resolved against the run that executed the replay; --testRunId / --commitSha may be combined to disambiguate when the replay was the head of more than one run.",
+        },
+        testRunId: {
+            string: true,
+            description: "The test run ID. On its own, returns coverage for the whole test run. Combined with --replayId, the replay must belong to this run (head or base); if it was this run's head, paths resolve against this run, otherwise against the replay's own execution run.",
+        },
+        commitSha: {
+            string: true,
+            description: "A commit SHA, used as an alternative to --testRunId: the latest test run for the commit is resolved and used. For whole-test-run coverage, defaults to the local git HEAD when neither --testRunId nor --commitSha is given.",
+        },
+        screenshotName: {
+            string: true,
+            description: 'Screenshot name (e.g. "after-event-5" or "end-state"), for use with --replayId. Omit for the whole replay.',
+        },
+        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=8ab59c0a-1e32-51df-a4a5-0bf5ab020386

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

@@ -0,0 +1 @@
+{"version":3,"file":"js-coverage.command.js","sources":["../../../src/commands/agent/js-coverage.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"8ab59c0a-1e32-51df-a4a5-0bf5ab020386"}

package/dist/commands/agent/test-run-diffs.command.d.ts

@@ -1,7 +1,9 @@
 import { CommandModule } from "yargs";
 interface Options {
     apiToken?: string | null | undefined;
-    testRunId: string;
+    testRunId: string | undefined;
+    commitSha: string | undefined;
+    waitForTestRunToComplete: boolean;
     includeMatches: boolean;
     includeReplayIds: boolean;
     verbose: boolean;

package/dist/commands/agent/test-run-diffs.command.js

@@ -1,23 +1,53 @@
 "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]="3eb8fec4-bccd-5f49-818f-8564a21113f8")}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]="799834e7-f63d-5e41-94e9-921895a4d6a9")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.testRunDiffsCommand = void 0;
 const client_1 = require("@alwaysmeticulous/client");
 const common_1 = require("@alwaysmeticulous/common");
 const sentry_utils_1 = require("../../command-utils/sentry.utils");
+const cli_user_error_1 = require("../../utils/cli-user-error");
+const resolve_test_run_from_commit_1 = require("../../utils/resolve-test-run-from-commit");
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 const fmtMismatch = (v) => v != null ? v.toFixed(5) : "";
 const log = (...args) => process.stderr.write(args.join(" ") + "\n");
-const handler = async ({ apiToken, testRunId, includeMatches, includeReplayIds, verbose, }) => {
+const handler = async ({ apiToken, testRunId, commitSha, waitForTestRunToComplete, includeMatches, includeReplayIds, verbose, }) => {
     (0, common_1.initLogger)();
-    const client = await (0, client_1.createClientWithOAuth)({
+    if (testRunId != null && commitSha != null) {
+        throw new cli_user_error_1.CliUserError("Pass either --testRunId or --commitSha, not both.");
+    }
+    const apiToken_ = await (0, client_1.resolveApiTokenWithOAuth)({
         apiToken,
         enableOAuthLogin: true,
     });
+    const client = (0, client_1.createClient)({ apiToken: apiToken_ });
+    // Use --testRunId, else resolve the run from --commitSha or, when neither is
+    // given, from the local checkout's HEAD.
+    let resolvedTestRunId;
+    let status;
+    if (testRunId != null) {
+        resolvedTestRunId = testRunId;
+        status = (await (0, client_1.getTestRun)({ client, testRunId })).status;
+    }
+    else {
+        const run = await (0, resolve_test_run_from_commit_1.resolveTestRunForCommitOrThrow)(client, apiToken_, commitSha);
+        resolvedTestRunId = run.testRunId;
+        status = run.status;
+    }
+    // Diffs are only meaningful once the run has finished. If it is still running
+    // and the caller didn't opt to wait, report it and stop — regardless of how
+    // the run was selected.
+    if ((0, resolve_test_run_from_commit_1.isTestRunInProgress)(status) && !waitForTestRunToComplete) {
+        log(`Test run ${resolvedTestRunId} is still in progress (status: ${status}); ` +
+            "pass --waitForTestRunToComplete to block until it finishes and then show diffs.");
+        return;
+    }
+    if (waitForTestRunToComplete) {
+        await (0, resolve_test_run_from_commit_1.awaitTestRunCompletion)(client, resolvedTestRunId);
+    }
     const t0 = performance.now();
-    log(`Fetching diffs summary for test run ${testRunId}...`);
-    let response = await (0, client_1.getTestRunDiffsSummary)(client, testRunId, {
+    log(`Fetching diffs summary for test run ${resolvedTestRunId}...`);
+    let response = await (0, client_1.getTestRunDiffsSummary)(client, resolvedTestRunId, {
         includeReplayIds,
         includeMatches,
     });
@@ -26,7 +56,7 @@ const handler = async ({ apiToken, testRunId, includeMatches, includeReplayIds,
         if (verbose)
             log(`Status: ${response.status}`);
         await sleep(2000);
-        response = await (0, client_1.getTestRunDiffsSummary)(client, testRunId, {
+        response = await (0, client_1.getTestRunDiffsSummary)(client, resolvedTestRunId, {
             includeReplayIds,
             includeMatches,
         });
@@ -83,8 +113,16 @@ exports.testRunDiffsCommand = {
         apiToken: { string: true, description: "Meticulous API token" },
         testRunId: {
             string: true,
-            description: "The test run ID",
-            demandOption: true,
+            description: "The test run ID. When omitted, the run is resolved from --commitSha, or from the local git HEAD when that is also omitted.",
+        },
+        commitSha: {
+            string: true,
+            description: "A commit SHA, used as an alternative to --testRunId: the latest test run for the commit is resolved and used. Defaults to the local git HEAD when neither --testRunId nor --commitSha is given.",
+        },
+        waitForTestRunToComplete: {
+            boolean: true,
+            default: false,
+            description: "If the test run is still in progress, block until it finishes before fetching diffs (otherwise an in-progress run is reported and the command exits).",
         },
         includeMatches: {
             boolean: true,
@@ -105,4 +143,4 @@ exports.testRunDiffsCommand = {
     handler: (0, sentry_utils_1.wrapHandler)(handler),
 };
 //# sourceMappingURL=test-run-diffs.command.js.map
-//# debugId=3eb8fec4-bccd-5f49-818f-8564a21113f8
+//# debugId=799834e7-f63d-5e41-94e9-921895a4d6a9

package/dist/commands/agent/test-run-diffs.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-run-diffs.command.js","sources":["../../../src/commands/agent/test-run-diffs.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"3eb8fec4-bccd-5f49-818f-8564a21113f8"}
+{"version":3,"file":"test-run-diffs.command.js","sources":["../../../src/commands/agent/test-run-diffs.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"799834e7-f63d-5e41-94e9-921895a4d6a9"}

package/dist/commands/agent/test-run-for-commit.command.d.ts

@@ -0,0 +1,9 @@
+import { CommandModule } from "yargs";
+interface Options {
+    apiToken?: string | null | undefined;
+    commitSha: string | undefined;
+    waitForTestRunToComplete: boolean;
+    json: boolean;
+}
+export declare const testRunForCommitCommand: CommandModule<unknown, Options>;
+export {};

package/dist/commands/agent/test-run-for-commit.command.js

@@ -0,0 +1,76 @@
+"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]="6ee01030-17bf-51f5-8c85-eb1bd6a1fb1e")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testRunForCommitCommand = void 0;
+const client_1 = require("@alwaysmeticulous/client");
+const common_1 = require("@alwaysmeticulous/common");
+const sentry_utils_1 = require("../../command-utils/sentry.utils");
+const cli_user_error_1 = require("../../utils/cli-user-error");
+const resolve_project_identifier_1 = require("../../utils/resolve-project-identifier");
+const resolve_test_run_from_commit_1 = require("../../utils/resolve-test-run-from-commit");
+const log = (...args) => process.stderr.write(args.join(" ") + "\n");
+const handler = async ({ apiToken, commitSha, waitForTestRunToComplete, json, }) => {
+    (0, common_1.initLogger)();
+    // Default to the current checkout's HEAD so the command can be run with no
+    // arguments to auto-infer the test run for the working tree.
+    const resolvedCommitSha = await (0, common_1.getCommitSha)(commitSha);
+    if (!resolvedCommitSha) {
+        throw new cli_user_error_1.CliUserError("Could not determine a commit SHA. Pass --commitSha or run inside a git repository.");
+    }
+    const apiToken_ = await (0, client_1.resolveApiTokenWithOAuth)({
+        apiToken,
+        enableOAuthLogin: true,
+    });
+    // Project-scoped tokens pin the project (resolves to `{}`); OAuth tokens use
+    // the project chosen via `meticulous auth set-project`.
+    const { projectId } = (0, resolve_project_identifier_1.resolveProjectIdentifier)(apiToken_);
+    const client = (0, client_1.createClient)({ apiToken: apiToken_ });
+    let result = await (0, client_1.getTestRunForCommit)(client, resolvedCommitSha, {
+        projectId,
+    });
+    if (result.testRunId != null &&
+        result.status != null &&
+        waitForTestRunToComplete &&
+        (0, resolve_test_run_from_commit_1.isTestRunInProgress)(result.status)) {
+        const status = await (0, resolve_test_run_from_commit_1.awaitTestRunCompletion)(client, result.testRunId);
+        result = { ...result, status };
+    }
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    if (result.testRunId == null) {
+        log(`No test run found for commit ${resolvedCommitSha}`);
+        return;
+    }
+    console.log(result.testRunId);
+    if (result.status != null && (0, resolve_test_run_from_commit_1.isTestRunInProgress)(result.status)) {
+        log(`Test run is still in progress (status: ${result.status}); ` +
+            "pass --waitForTestRunToComplete to block until it finishes.");
+    }
+};
+exports.testRunForCommitCommand = {
+    command: "test-run-for-commit",
+    describe: "Look up the latest test run for a commit (defaults to the current git HEAD)",
+    builder: {
+        apiToken: { string: true, description: "Meticulous API token" },
+        commitSha: {
+            string: true,
+            description: "Commit SHA to look up. Defaults to the current git HEAD when omitted.",
+        },
+        waitForTestRunToComplete: {
+            boolean: true,
+            default: false,
+            description: "If the matched test run is still in progress, block until it finishes before returning.",
+        },
+        json: {
+            boolean: true,
+            description: "Output the raw response as JSON",
+            default: false,
+        },
+    },
+    handler: (0, sentry_utils_1.wrapHandler)(handler),
+};
+//# sourceMappingURL=test-run-for-commit.command.js.map
+//# debugId=6ee01030-17bf-51f5-8c85-eb1bd6a1fb1e

package/dist/commands/agent/test-run-for-commit.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-run-for-commit.command.js","sources":["../../../src/commands/agent/test-run-for-commit.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"6ee01030-17bf-51f5-8c85-eb1bd6a1fb1e"}

package/dist/utils/format-coverage-ranges.d.ts

@@ -0,0 +1,7 @@
+import { CompactRange } from "@alwaysmeticulous/client";
+/**
+ * Formats compact line ranges for TSV output, e.g. `[[1, 1], [4, 9]]` becomes
+ * `"1;4-9"`. A single-line range (`start === end`) is rendered as just the line
+ * number.
+ */
+export declare const formatCoverageRanges: (ranges: CompactRange[]) => string;

package/dist/utils/format-coverage-ranges.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]="113db5c7-d290-522f-ae19-a67ddabc8608")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCoverageRanges = void 0;
+/**
+ * Formats compact line ranges for TSV output, e.g. `[[1, 1], [4, 9]]` becomes
+ * `"1;4-9"`. A single-line range (`start === end`) is rendered as just the line
+ * number.
+ */
+const formatCoverageRanges = (ranges) => ranges
+    .map(([start, end]) => (start === end ? `${start}` : `${start}-${end}`))
+    .join(";");
+exports.formatCoverageRanges = formatCoverageRanges;
+//# sourceMappingURL=format-coverage-ranges.js.map
+//# debugId=113db5c7-d290-522f-ae19-a67ddabc8608

package/dist/utils/format-coverage-ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-coverage-ranges.js","sources":["../../src/utils/format-coverage-ranges.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAEA;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,CAAC,MAAsB,EAAU,EAAE,CACrE,MAAM;KACH,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;KACvE,IAAI,CAAC,GAAG,CAAC,CAAC;AAHF,QAAA,oBAAoB,wBAGlB","debugId":"113db5c7-d290-522f-ae19-a67ddabc8608"}

package/dist/utils/resolve-test-run-from-commit.d.ts

@@ -0,0 +1,33 @@
+import { TestRunStatus } from "@alwaysmeticulous/api";
+import { MeticulousClient } from "@alwaysmeticulous/client";
+export interface ResolvedTestRun {
+    testRunId: string;
+    status: TestRunStatus;
+}
+/** Whether a status means the run is still running (not yet usable). */
+export declare const isTestRunInProgress: (status: TestRunStatus) => boolean;
+/**
+ * Resolves the latest test run (including one in progress) from a commit (an
+ * explicit `commitSha`, or the local checkout's HEAD when omitted), throwing a
+ * `CliUserError` when the commit can't be determined or no run matches it.
+ */
+export declare const resolveTestRunForCommitOrThrow: (client: MeticulousClient, apiToken: string, commitSha: string | undefined) => Promise<ResolvedTestRun>;
+/**
+ * Best-effort variant for auto-retry paths: returns `null` (rather than
+ * throwing) when the commit can't be determined, no project is selected, or no
+ * run matches, so the caller can fall back to its original behaviour.
+ */
+export declare const tryResolveTestRunForCommit: (client: MeticulousClient, apiToken: string, commitSha: string | undefined) => Promise<ResolvedTestRun | null>;
+/**
+ * Throws a `CliUserError` if the given test run is still in progress, since
+ * coverage only exists once a run has finished. Used to guard an explicitly
+ * passed `testRunId`, mirroring the in-progress check applied to runs resolved
+ * from a commit.
+ */
+export declare const throwIfTestRunCoverageNotReady: (client: MeticulousClient, testRunId: string) => Promise<void>;
+/**
+ * Polls a (possibly in-progress) test run until it reaches a terminal status,
+ * logging each transition. Throws a `CliUserError` if the run finishes
+ * unsuccessfully (`ExecutionError`/`Aborted`). Returns the final status.
+ */
+export declare const awaitTestRunCompletion: (client: MeticulousClient, testRunId: string) => Promise<TestRunStatus>;

package/dist/utils/resolve-test-run-from-commit.js

@@ -0,0 +1,101 @@
+"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]="caa70eb2-71ac-5c1c-ada9-44e904ea061a")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.awaitTestRunCompletion = exports.throwIfTestRunCoverageNotReady = exports.tryResolveTestRunForCommit = exports.resolveTestRunForCommitOrThrow = exports.isTestRunInProgress = void 0;
+const client_1 = require("@alwaysmeticulous/client");
+const common_1 = require("@alwaysmeticulous/common");
+const cli_user_error_1 = require("./cli-user-error");
+const resolve_project_identifier_1 = require("./resolve-project-identifier");
+const POLL_INTERVAL_MS = 10_000;
+const log = (...args) => process.stderr.write(args.join(" ") + "\n");
+/** Whether a status means the run is still running (not yet usable). */
+const isTestRunInProgress = (status) => client_1.IN_PROGRESS_TEST_RUN_STATUS.includes(status);
+exports.isTestRunInProgress = isTestRunInProgress;
+/**
+ * Resolves the latest test run (including one in progress) from a commit (an
+ * explicit `commitSha`, or the local checkout's HEAD when omitted), throwing a
+ * `CliUserError` when the commit can't be determined or no run matches it.
+ */
+const resolveTestRunForCommitOrThrow = async (client, apiToken, commitSha) => {
+    const sha = await (0, common_1.getCommitSha)(commitSha);
+    if (!sha) {
+        throw new cli_user_error_1.CliUserError("Could not determine a commit SHA. Pass --commitSha or --testRunId, or run inside a git repository.");
+    }
+    const { projectId } = (0, resolve_project_identifier_1.resolveProjectIdentifier)(apiToken);
+    const { testRunId, status } = await (0, client_1.getTestRunForCommit)(client, sha, {
+        projectId,
+    });
+    if (testRunId == null || status == null) {
+        throw new cli_user_error_1.CliUserError(`No test run found for commit ${sha}.`);
+    }
+    log(`Resolved test run ${testRunId} for commit ${sha} (status: ${status}).`);
+    return { testRunId, status };
+};
+exports.resolveTestRunForCommitOrThrow = resolveTestRunForCommitOrThrow;
+/**
+ * Best-effort variant for auto-retry paths: returns `null` (rather than
+ * throwing) when the commit can't be determined, no project is selected, or no
+ * run matches, so the caller can fall back to its original behaviour.
+ */
+const tryResolveTestRunForCommit = async (client, apiToken, commitSha) => {
+    try {
+        const sha = await (0, common_1.getCommitSha)(commitSha);
+        if (!sha) {
+            return null;
+        }
+        const { projectId } = (0, resolve_project_identifier_1.resolveProjectIdentifier)(apiToken);
+        const { testRunId, status } = await (0, client_1.getTestRunForCommit)(client, sha, {
+            projectId,
+        });
+        return testRunId != null && status != null
+            ? { testRunId, status }
+            : null;
+    }
+    catch (error) {
+        // A CliUserError (e.g. no project selected for an OAuth caller) is an
+        // actionable configuration problem the user must address, not a reason to
+        // silently skip the fallback — let it propagate so its message surfaces.
+        if (error instanceof cli_user_error_1.CliUserError) {
+            throw error;
+        }
+        return null;
+    }
+};
+exports.tryResolveTestRunForCommit = tryResolveTestRunForCommit;
+/**
+ * Throws a `CliUserError` if the given test run is still in progress, since
+ * coverage only exists once a run has finished. Used to guard an explicitly
+ * passed `testRunId`, mirroring the in-progress check applied to runs resolved
+ * from a commit.
+ */
+const throwIfTestRunCoverageNotReady = async (client, testRunId) => {
+    const testRun = await (0, client_1.getTestRun)({ client, testRunId });
+    if ((0, exports.isTestRunInProgress)(testRun.status)) {
+        throw new cli_user_error_1.CliUserError(`Test run ${testRunId} is still in progress (status: ${testRun.status}); coverage is not available yet.`);
+    }
+};
+exports.throwIfTestRunCoverageNotReady = throwIfTestRunCoverageNotReady;
+/**
+ * Polls a (possibly in-progress) test run until it reaches a terminal status,
+ * logging each transition. Throws a `CliUserError` if the run finishes
+ * unsuccessfully (`ExecutionError`/`Aborted`). Returns the final status.
+ */
+const awaitTestRunCompletion = async (client, testRunId) => {
+    let testRun = await (0, client_1.getTestRun)({ client, testRunId });
+    if ((0, exports.isTestRunInProgress)(testRun.status)) {
+        log(`Waiting for test run ${testRunId} to complete...`);
+    }
+    while ((0, exports.isTestRunInProgress)(testRun.status)) {
+        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+        testRun = await (0, client_1.getTestRun)({ client, testRunId });
+        log(`Test run status: ${testRun.status}`);
+    }
+    if (testRun.status === "ExecutionError" || testRun.status === "Aborted") {
+        throw new cli_user_error_1.CliUserError(`Test run ${testRunId} finished unsuccessfully (status: ${testRun.status}).`);
+    }
+    return testRun.status;
+};
+exports.awaitTestRunCompletion = awaitTestRunCompletion;
+//# sourceMappingURL=resolve-test-run-from-commit.js.map
+//# debugId=caa70eb2-71ac-5c1c-ada9-44e904ea061a

package/dist/utils/resolve-test-run-from-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-test-run-from-commit.js","sources":["../../src/utils/resolve-test-run-from-commit.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"caa70eb2-71ac-5c1c-ada9-44e904ea061a"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwaysmeticulous/cli",
-  "version": "2.292.1",
+  "version": "2.293.0",
   "description": "The Meticulous CLI",
   "license": "ISC",
   "main": "dist/index.js",
@@ -23,18 +23,18 @@
     "puppeteer-core": "24.14.0",
     "tar": "^7.5.8",
     "yargs": "^17.5.1",
-    "@alwaysmeticulous/api": "2.292.1",
-    "@alwaysmeticulous/client": "2.292.1",
-    "@alwaysmeticulous/common": "2.290.3",
-    "@alwaysmeticulous/debug-workspace": "2.292.1",
-    "@alwaysmeticulous/downloading-helpers": "2.292.1",
-    "@alwaysmeticulous/record": "2.292.1",
-    "@alwaysmeticulous/remote-replay-launcher": "2.292.1",
+    "@alwaysmeticulous/api": "2.293.0",
+    "@alwaysmeticulous/client": "2.293.0",
+    "@alwaysmeticulous/common": "2.293.0",
+    "@alwaysmeticulous/debug-workspace": "2.293.0",
+    "@alwaysmeticulous/downloading-helpers": "2.293.0",
+    "@alwaysmeticulous/record": "2.293.0",
+    "@alwaysmeticulous/remote-replay-launcher": "2.293.0",
     "@alwaysmeticulous/replay-debugger-ui": "2.283.1",
-    "@alwaysmeticulous/replay-orchestrator-launcher": "2.292.1",
-    "@alwaysmeticulous/sdk-bundles-api": "2.292.1",
-    "@alwaysmeticulous/sentry": "2.290.3",
-    "@alwaysmeticulous/tunnels-client": "2.290.3"
+    "@alwaysmeticulous/replay-orchestrator-launcher": "2.293.0",
+    "@alwaysmeticulous/sdk-bundles-api": "2.293.0",
+    "@alwaysmeticulous/sentry": "2.293.0",
+    "@alwaysmeticulous/tunnels-client": "2.293.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.5",