#!/usr/bin/env node

// Runs plugin lifecycle and gateway QA gauntlet probes with timing metrics.

import { spawn } from "node:child_process";

import fs from "node:fs";

import os from "node:os";

const COMMAND_OUTPUT_MAX_BUFFER_BYTES = 16 * 1024 * 1024;

const ANSI_PATTERN = new RegExp(String.raw`\u001B\[[0-9;]*m`, "gu");

/**

* Parses plugin gateway gauntlet CLI arguments and env defaults.

*/

export function parseArgs(argv) {

const args = stripLeadingPackageManagerSeparator(argv);

const options = {

return raw ? parseNonNegativeInt(raw, name) : undefined;

}

/**

* Builds the command that prepares QA runtime artifacts before gauntlet probes.

*/

export function createGauntletPrebuildCommand(repoRoot) {

return {

command: process.execPath,

return chunks;

}

/**

* Converts an output path to a repo-relative path, rejecting paths outside the repo.

*/

export function toRepoRelativePath(repoRoot, absolutePath) {

const relativePath = path.relative(repoRoot, absolutePath);

if (!relativePath || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {

return { command: "/usr/bin/time", args: ["-v", command, ...args], mode: "gnu" };

}

/**

* Parses `/usr/bin/time` output into wall, CPU, and RSS metrics.

*/

export function parseTimedMetrics(stderr, wallMs, mode) {

let userSeconds = null;

let systemSeconds = null;

return logPath;

}

/**

* Runs a measured command through the live process implementation.

*/

export async function runMeasuredCommand(params) {

return await runMeasuredCommandLive(params);

}

/**

* Runs one command with optional timing wrapper, bounded output, and log capture.

*/

export function runMeasuredCommandLive(params) {

const { command, args, mode } =

params.timeMode === "none"

});

}

/**

* Reports whether gauntlet result rows contain work beyond the prebuild step.

*/

export function hasGauntletWorkRows(rows) {

return rows.some((row) => row.phase !== "prebuild");

}