commandTimeoutMs: 120_000,

buildTimeoutMs: 600_000,

qaTimeoutMs: 900_000,

allowEmpty: false,

keepRunRoot: process.env.OPENCLAW_PLUGIN_GATEWAY_GAUNTLET_KEEP_RUN_ROOT === "1",

};

const envIds = normalizeCsv(process.env.OPENCLAW_PLUGIN_GATEWAY_GAUNTLET_IDS);

case "--keep-run-root":

options.keepRunRoot = true;

break;

case "--allow-empty":

options.allowEmpty = true;

break;

case "--help":

printHelp();

process.exit(0);

--skip-lifecycle Skip plugin install/inspect/disable/enable/doctor/uninstall

--skip-qa Skip QA Lab RPC conversation runs

--skip-slash-help Skip CLI help probes for plugin-declared command aliases

--allow-empty Allow zero-command runs when every active phase is skipped

--keep-run-root Preserve isolated HOME/state/log temp root after success

`);

}

});

}

export function hasGauntletWorkRows(rows) {

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

}

function runPluginLifecycle(params) {

for (const plugin of params.plugins) {

const commands = [

const failures = rows.filter(

(row) => row.status !== 0 || row.timedOut || row.diagnosticFailure,

);

preserveRunRoot = preserveRunRoot || failures.length > 0;

const guardFailures =

!hasGauntletWorkRows(rows) && !options.allowEmpty

? [

{

kind: "empty-run",

message:

"No lifecycle, slash-help, or QA gauntlet commands ran; remove a skip flag or pass --allow-empty for intentional dry runs.",

},

]

: [];

const hasFailures = failures.length > 0 || guardFailures.length > 0;

preserveRunRoot = preserveRunRoot || hasFailures;

let cleanupError = null;

if (!preserveRunRoot) {

try {

qaScenarios: options.qaScenarios,

qaPluginChunkSize: options.qaPluginChunkSize,

qaBaseline: options.qaBaseline,

allowEmpty: options.allowEmpty,

keepRunRoot: options.keepRunRoot,

skipLifecycle: options.skipLifecycle,

skipQa: options.skipQa,

rows,

observations: [...metricObservations, ...qaBaselineObservations, ...gatewayObservations],

failures,

guardFailures,

};

const summaryPath = path.join(options.outputDir, "plugin-gateway-gauntlet-summary.json");

fs.writeFileSync(summaryPath, `${JSON.stringify(summary, null, 2)}\n`, "utf8");

`[plugin-gauntlet] failure phase=${failure.phase} plugin=${failure.pluginId ?? "<none>"} status=${failure.status} timedOut=${failure.timedOut} diagnostic=${failure.diagnosticFailure ?? ""} wallMs=${Math.round(failure.wallMs)} log=${failure.logPath}\n`,

);

}

for (const failure of guardFailures) {

process.stdout.write(`[plugin-gauntlet] failure ${failure.kind}: ${failure.message}\n`);

}

for (const observation of summary.observations.slice(0, 20)) {

process.stdout.write(`[plugin-gauntlet] observation ${JSON.stringify(observation)}\n`);

}

if (failures.length > 0) {

if (hasFailures) {

process.exitCode = 1;

}

} catch (error) {