@alwaysmeticulous/cli 2.313.1 → 2.316.0

package/dist/commands/record/backend-sidecar.utils.js

@@ -0,0 +1,273 @@
+"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]="d54ed918-653d-5c03-aa56-431d0e23e8f4")}catch(e){}}();
+
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startSidecar = exports.resolveSidecarPort = exports.DEFAULT_SIDECAR_PORT = void 0;
+const child_process_1 = require("child_process");
+const net = __importStar(require("net"));
+const readline = __importStar(require("readline"));
+const common_1 = require("@alwaysmeticulous/common");
+const chalk_1 = __importDefault(require("chalk"));
+const cli_user_error_1 = require("../../utils/cli-user-error");
+exports.DEFAULT_SIDECAR_PORT = 9670;
+const HEALTH_POLL_INTERVAL_MS = 250;
+const HEALTH_TIMEOUT_MS = 15_000;
+const FLUSH_TIMEOUT_MS = 10_000;
+const STOP_SIGTERM_TIMEOUT_MS = 5_000;
+const STDERR_TAIL_LINES = 20;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const canBind = (port) => new Promise((resolve) => {
+    const probe = net.createServer();
+    probe.once("error", () => resolve(false));
+    probe.listen(port, "127.0.0.1", () => {
+        probe.close(() => resolve(true));
+    });
+});
+const findEphemeralPort = () => new Promise((resolve, reject) => {
+    const probe = net.createServer();
+    probe.once("error", reject);
+    probe.listen(0, "127.0.0.1", () => {
+        const address = probe.address();
+        if (address === null || typeof address !== "object") {
+            probe.close(() => reject(new Error("Could not resolve a free port")));
+            return;
+        }
+        const port = address.port;
+        probe.close(() => resolve(port));
+    });
+});
+/**
+ * Resolves the port the sidecar will listen on. `requested === 0` always
+ * picks an ephemeral port. A busy requested port falls back to an ephemeral
+ * one in wrapped mode (the CLI controls the URL injected into the worker) but
+ * is a hard error in sidecar-only mode, where the user is about to configure
+ * the printed URL by hand and needs it predictable.
+ */
+const resolveSidecarPort = async (requested, mode) => {
+    if (requested === 0) {
+        return findEphemeralPort();
+    }
+    if (await canBind(requested)) {
+        return requested;
+    }
+    if (mode === "wrapped") {
+        const fallback = await findEphemeralPort();
+        (0, common_1.initLogger)().warn(`Port ${requested} is in use — using port ${fallback} for the Meticulous sidecar instead.`);
+        return fallback;
+    }
+    throw new cli_user_error_1.CliUserError(`Port ${requested} is already in use. Pass --port to choose a different sidecar port.`);
+};
+exports.resolveSidecarPort = resolveSidecarPort;
+const prefixPipe = (stream, onLine) => {
+    readline.createInterface({ input: stream }).on("line", onLine);
+};
+const fetchWithTimeout = async (url, init, timeoutMs) => {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+const spawnSidecarProcess = (options) => {
+    const logger = (0, common_1.initLogger)();
+    const child = (0, child_process_1.spawn)(process.execPath, [options.bundlePath], {
+        env: {
+            ...process.env,
+            ...options.env,
+            METICULOUS_SIDECAR_PORT: String(options.port),
+        },
+        stdio: ["ignore", "pipe", "pipe"],
+        // Own process group (POSIX) so terminal Ctrl-C reaches the CLI and the
+        // wrapped dev command but NOT the sidecar — the CLI drains the dev
+        // command first, flushes, and only then stops the sidecar, so capture
+        // events emitted during the dev server's teardown are not lost.
+        detached: process.platform !== "win32",
+    });
+    const stderrTail = [];
+    const prefix = chalk_1.default.dim("[meticulous sidecar]");
+    if (child.stdout) {
+        prefixPipe(child.stdout, (line) => logger.info(`${prefix} ${line}`));
+    }
+    if (child.stderr) {
+        prefixPipe(child.stderr, (line) => {
+            stderrTail.push(line);
+            if (stderrTail.length > STDERR_TAIL_LINES) {
+                stderrTail.shift();
+            }
+            logger.warn(`${prefix} ${line}`);
+        });
+    }
+    return { child, stderrTail };
+};
+const awaitHealthy = async (spawned, url) => {
+    const deadline = Date.now() + HEALTH_TIMEOUT_MS;
+    let exited = false;
+    let exitCode = null;
+    spawned.child.once("exit", (code) => {
+        exited = true;
+        exitCode = code;
+    });
+    while (Date.now() < deadline) {
+        if (exited) {
+            throw new cli_user_error_1.CliUserError(`The Meticulous sidecar exited during startup (exit code ${String(exitCode)}).${spawned.stderrTail.length > 0
+                ? `\n${spawned.stderrTail.join("\n")}`
+                : ""}`);
+        }
+        try {
+            const response = await fetchWithTimeout(`${url}/v1/health`, { method: "GET" }, 1_000);
+            if (response.ok) {
+                return;
+            }
+        }
+        catch {
+            // Not up yet — keep polling.
+        }
+        await sleep(HEALTH_POLL_INTERVAL_MS);
+    }
+    throw new cli_user_error_1.CliUserError(`The Meticulous sidecar did not become healthy within ${HEALTH_TIMEOUT_MS / 1000}s.${spawned.stderrTail.length > 0 ? `\n${spawned.stderrTail.join("\n")}` : ""}`);
+};
+const terminateChild = async (child) => {
+    if (child.exitCode !== null || child.signalCode !== null) {
+        return;
+    }
+    const exited = new Promise((resolve) => child.once("exit", () => resolve()));
+    child.kill("SIGTERM");
+    const timedOut = await Promise.race([
+        exited.then(() => false),
+        sleep(STOP_SIGTERM_TIMEOUT_MS).then(() => true),
+    ]);
+    if (timedOut) {
+        child.kill("SIGKILL");
+        await Promise.race([exited, sleep(2_000)]);
+    }
+};
+/**
+ * Spawns the sidecar bundle as a detached child process, waits for it to
+ * become healthy, and supervises it: one automatic restart on the same port
+ * if it dies unexpectedly (the worker holds the old URL, so the port must be
+ * reused), after which recording is declared stopped without affecting the
+ * wrapped dev command.
+ */
+const startSidecar = async (options) => {
+    const logger = (0, common_1.initLogger)();
+    const url = `http://127.0.0.1:${options.port}`;
+    let current = spawnSidecarProcess(options);
+    let restarted = false;
+    let stopping = false;
+    const watchExit = (spawned) => {
+        spawned.child.once("exit", (code) => {
+            if (stopping) {
+                return;
+            }
+            if (!restarted) {
+                restarted = true;
+                logger.warn(`The Meticulous sidecar exited unexpectedly (exit code ${String(code)}) — restarting it once...`);
+                void (async () => {
+                    try {
+                        current = spawnSidecarProcess(options);
+                        await awaitHealthy(current, url);
+                        // Only supervise the restarted process once it is healthy — an
+                        // exit during its startup is handled by awaitHealthy rejecting.
+                        watchExit(current);
+                        logger.warn("Meticulous sidecar restarted.");
+                    }
+                    catch (error) {
+                        current.child.kill("SIGKILL");
+                        logger.error(`Could not restart the Meticulous sidecar — backend recording has stopped. Your dev server is unaffected. ${String(error)}`);
+                        options.onRecordingStopped?.();
+                    }
+                })();
+            }
+            else {
+                logger.error("The Meticulous sidecar exited again — backend recording has stopped. Your dev server is unaffected.");
+                options.onRecordingStopped?.();
+            }
+        });
+    };
+    try {
+        await awaitHealthy(current, url);
+    }
+    catch (error) {
+        // Never leave a half-started detached sidecar behind — it would outlive
+        // the failed CLI run and hold the port. (No-op if it already exited.)
+        current.child.kill("SIGKILL");
+        throw error;
+    }
+    // Supervision starts only once the sidecar is healthy: an exit during
+    // startup is a startup failure (reported above), not a crash to restart.
+    watchExit(current);
+    // Don't let a crashed CLI orphan the detached sidecar.
+    process.once("exit", () => {
+        try {
+            current.child.kill("SIGTERM");
+        }
+        catch {
+            // Already gone.
+        }
+    });
+    const flush = async () => {
+        try {
+            await fetchWithTimeout(`${url}/v1/flush`, { method: "POST" }, FLUSH_TIMEOUT_MS);
+        }
+        catch (error) {
+            logger.warn(`Could not flush the Meticulous sidecar — some captured requests may not have been uploaded. ${String(error)}`);
+        }
+    };
+    return {
+        url,
+        port: options.port,
+        flush,
+        stop: async () => {
+            if (stopping) {
+                return;
+            }
+            stopping = true;
+            await flush();
+            // The sidecar's own SIGTERM handler also flushes before exiting, so
+            // this is belt-and-braces.
+            await terminateChild(current.child);
+        },
+    };
+};
+exports.startSidecar = startSidecar;
+//# sourceMappingURL=backend-sidecar.utils.js.map
+//# debugId=d54ed918-653d-5c03-aa56-431d0e23e8f4

package/dist/commands/record/backend-sidecar.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-sidecar.utils.js","sources":["../../../src/commands/record/backend-sidecar.utils.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"d54ed918-653d-5c03-aa56-431d0e23e8f4"}

package/dist/commands/record/backend.command.d.ts

@@ -0,0 +1,14 @@
+import type { CommandModule } from "yargs";
+interface Options {
+    apiToken: string | null | undefined;
+    recordingToken: string | null | undefined;
+    port: number;
+    exportMode: string;
+    localOutputDir: string | null | undefined;
+    injectSidecarVar: boolean;
+    /** Positional tokens yargs collected — only valid when passed after `--`. */
+    devCommand: (string | number)[] | undefined;
+}
+export declare const recordBackendCommand: CommandModule<unknown, Options>;
+export {};
+//# sourceMappingURL=backend.command.d.ts.map

package/dist/commands/record/backend.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.command.d.ts","sourceRoot":"","sources":["../../../src/commands/record/backend.command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAoB3C,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC;CAC7C;AAqLD,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAqChE,CAAC"}

package/dist/commands/record/backend.command.js

@@ -0,0 +1,189 @@
+"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]="92c2f965-765b-58d4-bf09-9eeac162ecee")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordBackendCommand = void 0;
+const child_process_1 = require("child_process");
+const client_1 = require("@alwaysmeticulous/client");
+const common_1 = require("@alwaysmeticulous/common");
+const downloading_helpers_1 = require("@alwaysmeticulous/downloading-helpers");
+const common_options_1 = require("../../command-utils/common-options");
+const sentry_utils_1 = require("../../command-utils/sentry.utils");
+const cli_user_error_1 = require("../../utils/cli-user-error");
+const constants_1 = require("../../utils/constants");
+const resolve_project_identifier_1 = require("../../utils/resolve-project-identifier");
+const backend_dev_command_utils_1 = require("./backend-dev-command.utils");
+const backend_sidecar_utils_1 = require("./backend-sidecar.utils");
+const DEV_COMMAND_SIGTERM_TIMEOUT_MS = 10_000;
+const resolveRecordingTarget = async (options) => {
+    const logger = (0, common_1.initLogger)();
+    if (options.recordingToken) {
+        return { recordingToken: options.recordingToken, projectName: undefined };
+    }
+    const apiToken = await (0, client_1.resolveApiTokenWithOAuth)({
+        apiToken: options.apiToken,
+        enableOAuthLogin: true,
+    });
+    const { projectId } = await (0, resolve_project_identifier_1.resolveProjectIdentifier)(apiToken);
+    const client = await (0, client_1.createClientWithOAuth)({
+        apiToken: options.apiToken,
+        enableOAuthLogin: true,
+    });
+    const project = await (0, client_1.getProject)(client, projectId);
+    if (!project) {
+        throw new cli_user_error_1.CliUserError("Could not retrieve project data. Is the API token correct?");
+    }
+    if (!project.recordingToken) {
+        throw new cli_user_error_1.CliUserError("Could not retrieve recording token.");
+    }
+    logger.info(`Recording backend sessions for ${project.organization.name}/${project.name}`);
+    return {
+        recordingToken: project.recordingToken,
+        projectName: project.name,
+    };
+};
+const printWorkerInstructions = (sidecarUrl) => {
+    const logger = (0, common_1.initLogger)();
+    logger.info("");
+    logger.info(`Meticulous sidecar running at ${sidecarUrl}. To record your worker:`);
+    logger.info("  1. Wrap your handler with withMeticulous from @alwaysmeticulous/backend-recorder-workerd");
+    logger.info('  2. Enable the "nodejs_als" (or "nodejs_compat") compatibility flag');
+    logger.info("  3. Expose the sidecar URL to the worker (workerd cannot see host environment variables):");
+    logger.info(`       npx wrangler dev --var ${backend_dev_command_utils_1.SIDECAR_URL_VAR_NAME}:${sidecarUrl}`);
+    logger.info(`     or add to .dev.vars: ${backend_dev_command_utils_1.SIDECAR_URL_VAR_NAME}=${sidecarUrl}`);
+    logger.info("");
+};
+const handler = async (options) => {
+    const logger = (0, common_1.initLogger)();
+    const devCommand = (0, backend_dev_command_utils_1.extractPassthroughCommand)(process.argv);
+    if (!devCommand && (options.devCommand?.length ?? 0) > 0) {
+        // Without the separator, yargs would swallow the dev command's own flags
+        // (e.g. its --port) as our options — refuse rather than silently starting
+        // in sidecar-only mode.
+        throw new cli_user_error_1.CliUserError("Pass the dev command after a -- separator, e.g.: meticulous record backend -- npx wrangler dev");
+    }
+    const mode = devCommand ? "wrapped" : "sidecar-only";
+    // Fail fast on auth before spawning anything.
+    const { recordingToken, projectName } = await resolveRecordingTarget(options);
+    logger.info("Fetching the Meticulous backend recorder sidecar...");
+    const bundlePath = await (0, downloading_helpers_1.fetchAsset)(constants_1.BACKEND_SIDECAR_BUNDLE_PATH);
+    const port = await (0, backend_sidecar_utils_1.resolveSidecarPort)(options.port, mode);
+    const done = (0, common_1.defer)();
+    const sidecar = await (0, backend_sidecar_utils_1.startSidecar)({
+        bundlePath,
+        port,
+        env: {
+            METICULOUS_RECORDING_TOKEN: recordingToken,
+            METICULOUS_EXPORT_MODE: options.exportMode,
+            ...(options.localOutputDir
+                ? { METICULOUS_LOCAL_OUTPUT_DIR: options.localOutputDir }
+                : {}),
+            ...(projectName ? { METICULOUS_PROJECT_NAME: projectName } : {}),
+        },
+        // Recording stopping is not fatal to the user's dev loop — keep the dev
+        // command (or the wait in sidecar-only mode) running.
+        onRecordingStopped: () => { },
+    });
+    let shuttingDown = false;
+    const shutdown = async (exitCode) => {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        await sidecar.stop();
+        done.resolve(exitCode);
+    };
+    if (devCommand) {
+        const kind = (0, backend_dev_command_utils_1.classifyDevCommand)(devCommand);
+        const argv = options.injectSidecarVar && kind !== "unknown"
+            ? (0, backend_dev_command_utils_1.injectSidecarVar)(devCommand, kind, sidecar.url)
+            : devCommand;
+        if (options.injectSidecarVar && kind !== "unknown") {
+            logger.info(`Passing ${backend_dev_command_utils_1.SIDECAR_URL_VAR_NAME}=${sidecar.url} to ${kind === "wrangler-dev" ? "wrangler dev" : "wrangler pages dev"}`);
+        }
+        else {
+            printWorkerInstructions(sidecar.url);
+        }
+        const child = (0, child_process_1.spawn)(argv[0], argv.slice(1), {
+            stdio: "inherit",
+            env: {
+                ...process.env,
+                // Harmless for workerd (host env is invisible inside the isolate) but
+                // lets non-workerd tooling in the dev command see the URL.
+                [backend_dev_command_utils_1.SIDECAR_URL_VAR_NAME]: sidecar.url,
+            },
+            // npx/pnpm/yarn shims on Windows are .cmd files, which require a shell.
+            shell: process.platform === "win32",
+        });
+        child.on("error", (error) => {
+            logger.error(`Could not start dev command: ${String(error)}`);
+            void shutdown(1);
+        });
+        child.on("exit", (code, signal) => {
+            // Wrangler teardown may still emit late waitUntil capture events; the
+            // sidecar is flushed and stopped only now, after the dev command exited.
+            void shutdown(code ?? (signal ? 1 : 0));
+        });
+        const forwardSignal = (signal) => {
+            // On terminal Ctrl-C the child receives SIGINT alongside us (same
+            // process group); forwarding covers direct kills of the CLI process.
+            // The dev command's own exit then drives the shutdown path above.
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill(signal);
+                setTimeout(() => {
+                    if (child.exitCode === null && child.signalCode === null) {
+                        child.kill("SIGKILL");
+                    }
+                }, DEV_COMMAND_SIGTERM_TIMEOUT_MS).unref();
+            }
+        };
+        process.on("SIGINT", () => forwardSignal("SIGINT"));
+        process.on("SIGTERM", () => forwardSignal("SIGTERM"));
+    }
+    else {
+        printWorkerInstructions(sidecar.url);
+        logger.info("Press Ctrl-C to stop recording.");
+        process.on("SIGINT", () => void shutdown(0));
+        process.on("SIGTERM", () => void shutdown(0));
+    }
+    const exitCode = await done.promise;
+    if (exitCode !== 0) {
+        process.exit(exitCode);
+    }
+};
+exports.recordBackendCommand = {
+    command: "backend [devCommand...]",
+    describe: "Record backend sessions from a Cloudflare Workers (workerd) app during local development. " +
+        "Starts the Meticulous recorder sidecar and optionally wraps your dev command: " +
+        "meticulous record backend -- npx wrangler dev",
+    builder: {
+        apiToken: common_options_1.OPTIONS.apiToken,
+        recordingToken: {
+            string: true,
+            description: "Recording token to upload with (skips API authentication). Defaults to the project's recording token resolved via the API token.",
+        },
+        port: {
+            number: true,
+            default: backend_sidecar_utils_1.DEFAULT_SIDECAR_PORT,
+            description: `Port for the sidecar to listen on (0 picks a free port; default ${backend_sidecar_utils_1.DEFAULT_SIDECAR_PORT})`,
+        },
+        exportMode: {
+            string: true,
+            choices: ["s3", "local"],
+            default: "s3",
+            description: 'Where the sidecar exports recorded sessions: "s3" uploads to Meticulous, "local" writes to disk for debugging',
+        },
+        localOutputDir: {
+            string: true,
+            description: "Directory for exported sessions when --exportMode is local",
+        },
+        injectSidecarVar: {
+            boolean: true,
+            default: true,
+            description: "Automatically pass the sidecar URL to a recognized wrangler dev command via --var/--binding",
+        },
+    },
+    handler: (0, sentry_utils_1.wrapHandler)(handler),
+};
+//# sourceMappingURL=backend.command.js.map
+//# debugId=92c2f965-765b-58d4-bf09-9eeac162ecee

package/dist/commands/record/backend.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.command.js","sources":["../../../src/commands/record/backend.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"92c2f965-765b-58d4-bf09-9eeac162ecee"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/record/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,eAAO,MAAM,aAAa,EAAE,aAY3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/record/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAK3C,eAAO,MAAM,aAAa,EAAE,aAa3B,CAAC"}

package/dist/commands/record/index.js

@@ -1,8 +1,9 @@
 "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]="93d2232d-990c-5aaf-904d-4b5d1f75b086")}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]="2abf8c2d-a23f-51b5-8af9-09241c9b4b8d")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.recordCommand = void 0;
+const backend_command_1 = require("./backend.command");
 const login_command_1 = require("./login.command");
 const session_command_1 = require("./session.command");
 exports.recordCommand = {
@@ -11,6 +12,7 @@ exports.recordCommand = {
     builder: (yargs) => yargs
         .command(session_command_1.recordSessionCommand)
         .command(login_command_1.recordLoginCommand)
+        .command(backend_command_1.recordBackendCommand)
         .demandCommand()
         .help(),
     handler: () => {
@@ -18,4 +20,4 @@ exports.recordCommand = {
     },
 };
 //# sourceMappingURL=index.js.map
-//# debugId=93d2232d-990c-5aaf-904d-4b5d1f75b086
+//# debugId=2abf8c2d-a23f-51b5-8af9-09241c9b4b8d

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/commands/record/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,mDAAqD;AACrD,uDAAyD;AAE5C,QAAA,aAAa,GAAkB;IAC1C,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,sCAAoB,CAAC;SAC7B,OAAO,CAAC,kCAAkB,CAAC;SAC3B,aAAa,EAAE;SACf,IAAI,EAAE;IACX,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"93d2232d-990c-5aaf-904d-4b5d1f75b086"}
+{"version":3,"file":"index.js","sources":["../../../src/commands/record/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,uDAAyD;AACzD,mDAAqD;AACrD,uDAAyD;AAE5C,QAAA,aAAa,GAAkB;IAC1C,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,sCAAoB,CAAC;SAC7B,OAAO,CAAC,kCAAkB,CAAC;SAC3B,OAAO,CAAC,sCAAoB,CAAC;SAC7B,aAAa,EAAE;SACf,IAAI,EAAE;IACX,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"2abf8c2d-a23f-51b5-8af9-09241c9b4b8d"}

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,IAAI,QAAa,OAAO,CAAC,IAAI,CA6FzC,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,IAAI,QAAa,OAAO,CAAC,IAAI,CAgGzC,CAAC"}

package/dist/main.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]="2bdd198d-b8de-5529-aca1-898e94712e3a")}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]="72c07600-77ed-5fec-b3e2-13959f392538")}catch(e){}}();
 
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = void 0;
 const path_1 = require("path");
 const common_1 = require("@alwaysmeticulous/common");
+const client_1 = require("@alwaysmeticulous/client");
 const sentry_1 = require("@alwaysmeticulous/sentry");
 const yargs_1 = __importDefault(require("yargs"));
 const json_args_1 = require("./command-utils/json-args");
@@ -20,6 +21,9 @@ const handleDataDir = (dataDir) => {
     (0, common_1.setMeticulousLocalDataDir)(dataDir);
 };
 const main = async () => {
+    // Before any client is created, so requests from a CLI command are
+    // distinguishable from direct use of @alwaysmeticulous/client as a library.
+    (0, client_1.declareClientAppInfo)("cli");
     (0, common_1.initLogger)();
     const packageJsonPath = (0, path_1.normalize)((0, path_1.join)(__dirname, "../package.json"));
     const meticulousVersion = await (0, common_1.getMeticulousVersion)(packageJsonPath);
@@ -101,4 +105,4 @@ const main = async () => {
 exports.main = main;
 void (0, exports.main)();
 //# sourceMappingURL=main.js.map
-//# debugId=2bdd198d-b8de-5529-aca1-898e94712e3a
+//# debugId=72c07600-77ed-5fec-b3e2-13959f392538

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sources":["../src/main.ts"],"sourceRoot":"","names":[],"mappings":";;;;;;;;AAAA,+BAAuC;AACvC,qDAMkC;AAClC,qDAAsD;AACtD,kDAA0B;AAC1B,yDAA0D;AAC1D,+DAA0D;AAC1D,0DAAuE;AACvE,sEAAkE;AAClE,8DAGmC;AACnC,2DAAsD;AAEtD,MAAM,aAAa,GAAG,CAAC,OAAkC,EAAQ,EAAE;IACjE,IAAA,kCAAyB,EAAC,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC;AAEK,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IAC5C,IAAA,mBAAU,GAAE,CAAC;IACb,MAAM,eAAe,GAAG,IAAA,gBAAS,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACtE,MAAM,iBAAiB,GAAG,MAAM,IAAA,6BAAoB,EAAC,eAAe,CAAC,CAAC;IACtE,MAAM,IAAA,mBAAU,EAAC,iBAAiB,CAAC,CAAC;IAEpC,MAAM,GAAG,GAAG,eAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,KAAK,CAC9C;;qBAEiB,CAClB,CAAC;IAEF,0EAA0E;IAC1E,0EAA0E;IAC1E,KAAK,MAAM,OAAO,IAAI;QACpB,GAAG,2BAAY;QACf,8BAAa;QACb,GAAG,sCAAiB;KACrB,EAAE,CAAC;QACF,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,GAAG;SACN,IAAI,EAAE;SACN,MAAM,EAAE;SACR,aAAa,EAAE;QAChB,0EAA0E;QAC1E,4EAA4E;QAC5E,6EAA6E;QAC7E,yEAAyE;QACzE,gEAAgE;QAChE,EAAE;QACF,wEAAwE;QACxE,yEAAyE;QACzE,qEAAqE;QACrE,2EAA2E;QAC3E,4EAA4E;QAC5E,wDAAwD;SACvD,MAAM,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC7D,KAAK,CAAC,CAAC,oBAAoB,CAAC,EAAE,UAAU,CAAC;SACzC,MAAM,CAAC,6BAAc,CAAC;SACtB,KAAK,CACJ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,6BAAc,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EACnD,iBAAiB,CAClB;SACA,UAAU,CACT;QACE,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;gBACzB,IAAA,kBAAS,EAAC,kDAAkD,CAAC,CAAC;YAChE,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC;YAC/C,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC;oBACH,oEAAoE;oBACpE,kEAAkE;oBAClE,wCAAwC;oBACxC,MAAM,MAAM,GAAG,IAAA,sCAAqB,EAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;oBACzD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBAC3B,gEAAgE;wBAChE,4DAA4D;wBAC5D,MAAM,IAAI,6BAAY,CACpB,MAAM,CAAC,IAAI,KAAK,OAAO;4BACrB,CAAC,CAAC,4DAA4D,MAAM,CAAC,IAAI,wCAAwC;4BACjH,CAAC,CAAC,4DAA4D,CACjE,CAAC;oBACJ,CAAC;oBACD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAA,yBAAa,EAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,oEAAoE;oBACpE,oEAAoE;oBACpE,qDAAqD;oBACrD,IAAI,KAAK,YAAY,6BAAY,EAAE,CAAC;wBAClC,IAAA,mBAAU,GAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBAC5C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBAC/B,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;KACF,EACD,IAAI,CACL;SACA,UAAU,CAAC;QACV,uEAAuE;QACvE,2EAA2E;QAC3E,CAAC,IAAI,EAAE,EAAE,CACP,IAAA,oBAAW,EACT,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAC/D;QACH,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QACrC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,yBAAU,EAAC,IAAI,CAAC;KAC3B,CAAC,CAAC,IAAI,CAAC;AACZ,CAAC,CAAC;AA7FW,QAAA,IAAI,QA6Ff;AAEF,KAAK,IAAA,YAAI,GAAE,CAAC","debugId":"2bdd198d-b8de-5529-aca1-898e94712e3a"}
+{"version":3,"file":"main.js","sources":["../src/main.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"72c07600-77ed-5fec-b3e2-13959f392538"}

package/dist/utils/__tests__/resolve-test-run-from-commit.spec.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]="caa44dc4-2935-5280-9da0-9a8830aae76f")}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]="cafa0aa8-de2b-5cc7-8b74-36cc15ac2a08")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 const vitest_1 = require("vitest");
@@ -53,13 +53,16 @@ const resolve_test_run_from_commit_1 = require("../resolve-test-run-from-commit"
         (0, vitest_1.expect)(() => (0, resolve_test_run_from_commit_1.assertTestRunComplete)("tr-1", "Running")).toThrow(cli_user_error_1.CliUserError);
         (0, vitest_1.expect)(() => (0, resolve_test_run_from_commit_1.assertTestRunComplete)("tr-1", "Running")).toThrow(/is not complete/);
     });
-    (0, vitest_1.test)("throws 'session-pool base run' for Partial", () => {
+    // Deliberately not special-cased here: whether a base run is usable depends
+    // on what's being fetched, so each command intercepts Partial with its own
+    // policy and wording first (test-run-diffs rejects, js-coverage accepts).
+    (0, vitest_1.test)("does not special-case Partial", () => {
         (0, vitest_1.expect)(() => (0, resolve_test_run_from_commit_1.assertTestRunComplete)("tr-1", "Partial")).toThrow(cli_user_error_1.CliUserError);
-        (0, vitest_1.expect)(() => (0, resolve_test_run_from_commit_1.assertTestRunComplete)("tr-1", "Partial")).toThrow(/session-pool base run/);
+        (0, vitest_1.expect)(() => (0, resolve_test_run_from_commit_1.assertTestRunComplete)("tr-1", "Partial")).toThrow(/is not complete \(status: Partial\)/);
     });
     (0, vitest_1.test)("uses the resultName in the not-yet-available message", () => {
         (0, vitest_1.expect)(() => (0, resolve_test_run_from_commit_1.assertTestRunComplete)("tr-1", "Running", { resultName: "coverage" })).toThrow(/coverage not yet available/);
     });
 });
 //# sourceMappingURL=resolve-test-run-from-commit.spec.js.map
-//# debugId=caa44dc4-2935-5280-9da0-9a8830aae76f
+//# debugId=cafa0aa8-de2b-5cc7-8b74-36cc15ac2a08