fix(ops): make recording exporters honor --help without writing artifacts

scripts/export-recording-cockpit.mjs

@@ -7,6 +7,11 @@ import { sendChannelGuidance } from "./lib/send-channel-guidance.mjs";
 import { routedContactPlan } from "./lib/contact-route.mjs";
 import { listOutboundProspectFolders } from "./lib/outbound-prospects.mjs";
 
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  console.log("Usage: npm run prospect:cockpit -- [--limit=5] [--output=prospects/recording-cockpit.html]");
+  process.exit(0);
+}
+
 const limitArg = process.argv.find((arg) => arg.startsWith("--limit="));
 const limit = limitArg ? Number(limitArg.split("=")[1]) : 5;
 const outputArg = process.argv.find((arg) => arg.startsWith("--output="));

scripts/export-recording-queue.mjs

@@ -4,6 +4,11 @@ import { join } from "node:path";
 import { listOutboundProspectFolders } from "./lib/outbound-prospects.mjs";
 import { checkProspectReadiness, prospectWarningWeight } from "./lib/prospect-readiness.mjs";
 
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  console.log("Usage: npm run prospect:queue -- [--limit=5] [--output=prospects/recording-queue.md]");
+  process.exit(0);
+}
+
 const limitArg = process.argv.find((arg) => arg.startsWith("--limit="));
 const limit = limitArg ? Number(limitArg.split("=")[1]) : 5;
 const outputArg = process.argv.find((arg) => arg.startsWith("--output="));

scripts/export-recording-rehearsal-check.mjs

@@ -7,6 +7,11 @@ import { routedContactPlan } from "./lib/contact-route.mjs";
 import { localIsoDate } from "./date-utils.mjs";
 import { listOutboundProspectFolders } from "./lib/outbound-prospects.mjs";
 
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  console.log("Usage: npm run prospect:rehearsal -- [--limit=5] [--include-smoke] [--output=prospects/recording-rehearsal-check.md] [--html=prospects/recording-rehearsal-check.html]");
+  process.exit(0);
+}
+
 const args = process.argv.slice(2);
 const limitArg = args.find((arg) => arg.startsWith("--limit="));
 const outputArg = args.find((arg) => arg.startsWith("--output="));

scripts/export-recording-teleprompter.mjs

@@ -6,6 +6,11 @@ import { sendChannelGuidance } from "./lib/send-channel-guidance.mjs";
 import { routedContactPlan } from "./lib/contact-route.mjs";
 import { listOutboundProspectFolders } from "./lib/outbound-prospects.mjs";
 
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  console.log("Usage: npm run prospect:teleprompter -- [--limit=5] [--output=prospects/recording-teleprompter.html]");
+  process.exit(0);
+}
+
 const limitArg = process.argv.find((arg) => arg.startsWith("--limit="));
 const limit = limitArg ? Number(limitArg.split("=")[1]) : 5;
 const outputArg = process.argv.find((arg) => arg.startsWith("--output="));

scripts/test-active-operator-surfaces.mjs

@@ -117,6 +117,25 @@ try {
 	}
 	for (const path of privateRuntimeArtifacts) eq(existsSync(join(T, path)), true, `Private runtime artifact is missing: ${path}`)
 
+	// Recording exporters must honor --help/-h before doing any work: print
+	// usage, exit 0, and never write or overwrite a recording artifact.
+	const recordingHelpSurface = [
+		["export-recording-queue.mjs", ["prospects/recording-queue.md"]],
+		["export-recording-cockpit.mjs", ["prospects/recording-cockpit.html"]],
+		["export-recording-teleprompter.mjs", ["prospects/recording-teleprompter.html"]],
+		["export-recording-rehearsal-check.mjs", ["prospects/recording-rehearsal-check.md", "prospects/recording-rehearsal-check.html"]]
+	]
+	for (const [name, artifactPaths] of recordingHelpSurface) {
+		for (const path of artifactPaths) writeFileSync(join(T, path), "help sentinel\n")
+		const helped = run([`scripts/${name}`, "--help"])
+		eq(helped.status, 0, `${name} --help must exit 0: ${helped.stderr || helped.stdout}`)
+		mat(helped.stdout, /Usage:/, `${name} --help must print usage`)
+		for (const path of artifactPaths) {
+			deq(readFileSync(join(T, path), "utf8"), "help sentinel\n", `${name} --help must not overwrite ${path}`)
+			unlinkSync(join(T, path))
+		}
+	}
+
 	const application = JSON.parse(readFileSync(join(T, "contracts/fixtures/sprint-application.v1.json"), "utf8"))
 	const importResult = run(["scripts/import-sprint-application.mjs", "contracts/fixtures/sprint-application.v1.json"])
 	eq(importResult.status, 0)