#!/usr/bin/env node // Checks or refreshes generated release artifacts before a release publish. import { runManagedCommand } from "./lib/managed-child-process.mjs"; const parsedArgs = parseArgs(process.argv.slice(2)); const fix = parsedArgs.fix; const fixCommands = [ { name: "plugin versions", args: ["plugins:sync"] }, { name: "npm shrinkwraps", args: ["deps:shrinkwrap:changed:generate"] }, { name: "plugin inventory", args: ["plugins:inventory:gen"] }, { name: "base config schema", args: ["config:schema:gen"] }, { name: "bundled channel config metadata", args: ["config:channels:gen"] }, { name: "config docs baseline", args: ["config:docs:gen"] }, { name: "plugin SDK exports", args: ["plugin-sdk:sync-exports"] }, { name: "plugin SDK API baseline", args: ["plugin-sdk:api:gen"] }, ]; const checkCommands = [ { name: "root dependency ownership", args: ["deps:root-ownership:check"] }, { name: "npm shrinkwraps", args: ["deps:shrinkwrap:check"] }, { name: "plugin versions", args: ["plugins:sync:check"] }, { name: "plugin inventory", args: ["plugins:inventory:check"] }, { name: "base config schema", args: ["config:schema:check"] }, { name: "bundled channel config metadata", args: ["config:channels:check"] }, { name: "config docs baseline", args: ["config:docs:check"] }, { name: "plugin SDK exports", args: ["plugin-sdk:check-exports"] }, { name: "plugin SDK API baseline", args: ["plugin-sdk:api:check"] }, { name: "plugin SDK surface budget", args: ["plugin-sdk:surface:check"] }, ]; if (fix) { console.log("[release-preflight] refreshing generated release artifacts"); const failed = await runSerial(fixCommands); if (failed.length !== 0) { printFailures("release preflight refresh failed", failed); process.exit(1); } } console.log("[release-preflight] checking release generated artifacts and manifests"); const failed = await runAll(checkCommands); if (failed.length !== 0) { printFailures("release preflight found drift", failed); console.error( "\nRun `pnpm release:prep` if the version/config/API changes are intentional, then commit the generated files.", ); process.exit(1); } console.log("[release-preflight] OK"); async function runSerial(commands) { const failedValue = []; for (const command of commands) { const status = await runCommand(command); if (status !== 0) { failedValue.push({ ...command, status }); break; } } return failedValue; } async function runAll(commands) { const failedLocal = []; for (const command of commands) { const status = await runCommand(command); if (status !== 0) { failedLocal.push({ ...command, status }); } } return failedLocal; } async function runCommand(command) { console.log(`\n[release-preflight] ${command.name}: pnpm ${command.args.join(" ")}`); try { return await runManagedCommand({ args: command.args, bin: "pnpm", }); } catch (error) { console.error(error); return 1; } } function printFailures(title, failures) { console.error(`\n${title}:`); for (const failure of failures) { console.error(`- ${failure.name}: exit ${failure.status} (pnpm ${failure.args.join(" ")})`); } } function parseArgs(argv) { let check = false; let wantsFix = false; for (const arg of argv) { if (arg === "--help") { printUsage(console.log); process.exit(0); } if (arg === "--check") { check = true; continue; } if (arg === "--fix") { wantsFix = true; continue; } console.error(`Unknown release preflight argument: ${arg}`); printUsage(console.error); process.exit(1); } if (wantsFix && check) { console.error("Use either --fix or --check, not both."); process.exit(1); } return { fix: wantsFix }; } function printUsage(writeLine) { writeLine("Usage: node scripts/release-preflight.mjs [--check|--fix]"); writeLine(""); writeLine(" --check verify generated release artifacts without writing changes (default)"); writeLine(" --fix refresh generated release artifacts, then verify them"); }