@supercheck/cli 0.1.0-beta.5 → 0.1.0-beta.6

package/dist/bin/supercheck.js

@@ -213,7 +213,7 @@ function requireTriggerKey() {
 }
 
 // src/version.ts
-var CLI_VERSION = true ? "0.1.0-beta.5" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.1.0-beta.6" : "0.0.0-dev";
 
 // src/api/client.ts
 import { ProxyAgent } from "undici";
@@ -1692,9 +1692,12 @@ function parseIntStrict(value, name, opts) {
 var jobCommand = new Command5("job").description("Manage jobs");
 jobCommand.command("list").description("List all jobs").option("--page <page>", "Page number", "1").option("--limit <limit>", "Items per page", "50").action(async (options) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(
-    "/api/jobs",
-    { page: options.page, limit: options.limit }
+  const { data } = await withSpinner(
+    "Fetching jobs",
+    () => client.get(
+      "/api/jobs",
+      { page: options.page, limit: options.limit }
+    )
   );
   output(data.data, {
     columns: [
@@ -1715,8 +1718,11 @@ Page ${data.pagination.page}/${data.pagination.totalPages} (${data.pagination.to
 var keysCommand = jobCommand.command("keys").description("Manage job trigger keys");
 keysCommand.argument("<jobId>", "Job ID").action(async (jobId) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(
-    `/api/jobs/${jobId}/api-keys`
+  const { data } = await withSpinner(
+    "Fetching trigger keys",
+    () => client.get(
+      `/api/jobs/${jobId}/api-keys`
+    )
   );
   output(data.apiKeys ?? [], {
     columns: [
@@ -1735,9 +1741,12 @@ keysCommand.command("create").description("Create a new trigger key for a job").
   if (options.expiresIn !== void 0) {
     body.expiresIn = parseIntStrict(options.expiresIn, "--expires-in", { min: 60 });
   }
-  const { data } = await client.post(
-    `/api/jobs/${jobId}/api-keys`,
-    body
+  const { data } = await withSpinner(
+    "Creating trigger key",
+    () => client.post(
+      `/api/jobs/${jobId}/api-keys`,
+      body
+    )
   );
   logger.success("Trigger key created");
   logger.warn("Save the `key` value now. It will only be shown once.");
@@ -1745,12 +1754,18 @@ keysCommand.command("create").description("Create a new trigger key for a job").
 });
 keysCommand.command("delete").description("Revoke a trigger key").argument("<jobId>", "Job ID").argument("<keyId>", "Key ID").action(async (jobId, keyId) => {
   const client = createAuthenticatedClient();
-  await client.delete(`/api/jobs/${jobId}/api-keys/${keyId}`);
+  await withSpinner(
+    "Revoking trigger key",
+    () => client.delete(`/api/jobs/${jobId}/api-keys/${keyId}`)
+  );
   logger.success(`Trigger key ${keyId} revoked`);
 });
 jobCommand.command("get <id>").description("Get job details").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/jobs/${id}`);
+  const { data } = await withSpinner(
+    "Fetching job details",
+    () => client.get(`/api/jobs/${id}`)
+  );
   outputDetail(data);
 });
 jobCommand.command("create").description("Create a new job").requiredOption("--name <name>", "Job name").option("--description <description>", "Job description", "").option("--type <type>", "Job type (playwright, k6)").option("--schedule <cron>", "Cron schedule expression").option("--timeout <seconds>", "Timeout in seconds", "300").option("--retries <count>", "Retry count on failure", "0").action(async (options) => {
@@ -1765,7 +1780,10 @@ jobCommand.command("create").description("Create a new job").requiredOption("--n
   };
   if (options.type) body.jobType = options.type;
   if (options.schedule) body.cronSchedule = options.schedule;
-  const { data } = await client.post("/api/jobs", body);
+  const { data } = await withSpinner(
+    "Creating job",
+    () => client.post("/api/jobs", body)
+  );
   logger.success(`Job "${options.name}" created (${data.id})`);
   outputDetail(data);
 });
@@ -1782,7 +1800,10 @@ jobCommand.command("update <id>").description("Update job configuration").option
     logger.warn("No fields to update. Use --name, --description, --schedule, --timeout, --retries, or --status.");
     return;
   }
-  const { data } = await client.patch(`/api/jobs/${id}`, body);
+  const { data } = await withSpinner(
+    "Updating job",
+    () => client.patch(`/api/jobs/${id}`, body)
+  );
   logger.success(`Job ${id} updated`);
   outputDetail(data);
 });
@@ -1796,13 +1817,19 @@ jobCommand.command("delete <id>").description("Delete a job").option("--force",
     }
   }
   const client = createAuthenticatedClient();
-  await client.delete(`/api/jobs/${id}`);
+  await withSpinner(
+    "Deleting job",
+    () => client.delete(`/api/jobs/${id}`)
+  );
   logger.success(`Job ${id} deleted`);
 });
 jobCommand.command("run").description("Run a job immediately").requiredOption("--id <id>", "Job ID to run").action(async (options) => {
   const client = createAuthenticatedClient();
-  const { data: jobData } = await client.get(
-    `/api/jobs/${options.id}`
+  const { data: jobData } = await withSpinner(
+    "Fetching job details",
+    () => client.get(
+      `/api/jobs/${options.id}`
+    )
   );
   const tests = Array.isArray(jobData.tests) ? jobData.tests : [];
   if (tests.length === 0) {
@@ -1815,10 +1842,12 @@ jobCommand.command("run").description("Run a job immediately").requiredOption("-
     id: test.id,
     name: test.name ?? test.title ?? ""
   }));
-  logger.info(`Running job ${options.id}...`);
-  const { data } = await client.post(
-    "/api/jobs/run",
-    { jobId: options.id, tests: payloadTests, trigger: "manual" }
+  const { data } = await withSpinner(
+    "Running job",
+    () => client.post(
+      "/api/jobs/run",
+      { jobId: options.id, tests: payloadTests, trigger: "manual" }
+    )
   );
   logger.success(`Job started. Run ID: ${data.runId}`);
   outputDetail(data);
@@ -1828,9 +1857,11 @@ jobCommand.command("trigger <id>").description("Trigger a job run").option("--wa
     token: requireTriggerKey(),
     baseUrl: getStoredBaseUrl() ?? void 0
   });
-  logger.info(`Triggering job ${id}...`);
-  const { data } = await triggerClient.post(
-    `/api/jobs/${id}/trigger`
+  const { data } = await withSpinner(
+    "Triggering job",
+    () => triggerClient.post(
+      `/api/jobs/${id}/trigger`
+    )
   );
   logger.success(`Job triggered. Run ID: ${data.runId}`);
   if (options.wait) {
@@ -1919,17 +1950,19 @@ function getProxyEnv(url) {
   return null;
 }
 var runCommand = new Command6("run").description("Manage runs");
-runCommand.command("list").description("List runs").option("--page <page>", "Page number", "1").option("--limit <limit>", "Items per page", "50").option("--job <jobId>", "Filter by job ID").option("--status <status>", "Filter by status (queued, running, passed, failed, error, blocked)").action(async (options) => {
+runCommand.command("list").description("List runs").option("--page <page>", "Page number", "1").option("--limit <limit>", "Items per page", "50").option("--status <status>", "Filter by status").action(async (options) => {
   const client = createAuthenticatedClient();
   const params = {
     page: options.page,
     limit: options.limit
   };
-  if (options.job) params.jobId = options.job;
   if (options.status) params.status = options.status;
-  const { data } = await client.get(
-    "/api/runs",
-    params
+  const { data } = await withSpinner(
+    "Fetching runs",
+    () => client.get(
+      "/api/runs",
+      params
+    )
   );
   output(data.data, {
     columns: [
@@ -1937,7 +1970,6 @@ runCommand.command("list").description("List runs").option("--page <page>", "Pag
       { key: "jobName", header: "Job" },
       { key: "status", header: "Status" },
       { key: "trigger", header: "Trigger" },
-      { key: "duration", header: "Duration" },
       { key: "startedAt", header: "Started" }
     ]
   });
@@ -1950,22 +1982,18 @@ Page ${data.pagination.page}/${data.pagination.totalPages} (${data.pagination.to
 });
 runCommand.command("get <id>").description("Get run details").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/runs/${id}`);
-  outputDetail(data);
-});
-runCommand.command("permissions <id>").description("Get run access permissions").action(async (id) => {
-  const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/runs/${id}/permissions`);
+  const { data } = await withSpinner(
+    "Fetching run details",
+    () => client.get(`/api/runs/${id}`)
+  );
   outputDetail(data);
 });
-runCommand.command("cancel <id>").description("Cancel a running execution").action(async (id) => {
-  const client = createAuthenticatedClient();
-  await client.post(`/api/runs/${id}/cancel`);
-  logger.success(`Run ${id} cancelled`);
-});
 runCommand.command("status <id>").description("Get run status").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/runs/${id}/status`);
+  const { data } = await withSpinner(
+    "Fetching run status",
+    () => client.get(`/api/runs/${id}/status`)
+  );
   outputDetail(data);
 });
 runCommand.command("stream <id>").description("Stream live console output from a run").option("--idle-timeout <seconds>", "Abort if no data received within this period", "60").action(async (id, options) => {
@@ -2030,18 +2058,13 @@ runCommand.command("stream <id>").description("Stream live console output from a
                   process.stdout.write(parsed.line + "\n");
                 }
                 break;
+              case "status":
+                logger.info(`Status: ${parsed.status ?? JSON.stringify(parsed)}`);
+                break;
               case "complete":
-                logger.newline();
-                if (parsed.status === "completed" || parsed.status === "success") {
-                  logger.success(`Run ${id} ${parsed.status}`);
-                } else {
-                  logger.warn(`Run ${id} finished with status: ${parsed.status}`);
-                }
+                logger.success(`Run complete: ${parsed.status ?? "done"}`);
                 if (idleTimer) clearTimeout(idleTimer);
                 return;
-              case "ready":
-                logger.debug(`Stream ready for run ${parsed.runId ?? id}`);
-                break;
               case "error":
                 logger.error(`Stream error: ${parsed.message ?? JSON.stringify(parsed)}`);
                 break;
@@ -2144,9 +2167,12 @@ testCommand.command("list").description("List all tests").option("--page <page>"
   };
   if (options.search) params.search = options.search;
   if (options.type) params.type = normalizeTestType(options.type);
-  const { data } = await client.get(
-    "/api/tests",
-    params
+  const { data } = await withSpinner(
+    "Fetching tests",
+    () => client.get(
+      "/api/tests",
+      params
+    )
   );
   output(data.data, {
     columns: [
@@ -2167,7 +2193,10 @@ testCommand.command("get <id>").description("Get test details").option("--includ
   const client = createAuthenticatedClient();
   const params = {};
   if (options.includeScript) params.includeScript = "true";
-  const { data } = await client.get(`/api/tests/${id}`, params);
+  const { data } = await withSpinner(
+    "Fetching test details",
+    () => client.get(`/api/tests/${id}`, params)
+  );
   outputDetail(data);
 });
 testCommand.command("create").description("Create a new test").requiredOption("--title <title>", "Test title").requiredOption("--file <path>", "Path to the test script file").option("--type <type>", "Test type (playwright, k6)", "playwright").option("--description <description>", "Test description").action(async (options) => {
@@ -2188,7 +2217,10 @@ testCommand.command("create").description("Create a new test").requiredOption("-
     type: normalizeTestType(options.type)
   };
   if (options.description) body.description = options.description;
-  const { data } = await client.post("/api/tests", body);
+  const { data } = await withSpinner(
+    "Creating test",
+    () => client.post("/api/tests", body)
+  );
   const createdId = data.test?.id ?? data.id;
   logger.success(`Test "${options.title}" created${createdId ? ` (${createdId})` : ""}`);
   outputDetail(data);
@@ -2213,7 +2245,10 @@ testCommand.command("update <id>").description("Update a test").option("--title
     logger.warn("No fields to update. Use --title, --file, or --description.");
     return;
   }
-  const { data } = await client.patch(`/api/tests/${id}`, body);
+  const { data } = await withSpinner(
+    "Updating test",
+    () => client.patch(`/api/tests/${id}`, body)
+  );
   logger.success(`Test ${id} updated`);
   outputDetail(data);
 });
@@ -2227,19 +2262,28 @@ testCommand.command("delete <id>").description("Delete a test").option("--force"
     }
   }
   const client = createAuthenticatedClient();
-  await client.delete(`/api/tests/${id}`);
+  await withSpinner(
+    "Deleting test",
+    () => client.delete(`/api/tests/${id}`)
+  );
   logger.success(`Test ${id} deleted`);
 });
 testCommand.command("execute <id>").description("Execute a test immediately").option("--location <location>", "Execution location (k6 only)").action(async (id, options) => {
   const client = createAuthenticatedClient();
   const body = {};
   if (options.location) body.location = options.location;
-  const { data } = await client.post(`/api/tests/${id}/execute`, body);
+  const { data } = await withSpinner(
+    "Executing test",
+    () => client.post(`/api/tests/${id}/execute`, body)
+  );
   outputDetail(data);
 });
 testCommand.command("tags <id>").description("Get test tags").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/tests/${id}/tags`);
+  const { data } = await withSpinner(
+    "Fetching test tags",
+    () => client.get(`/api/tests/${id}/tags`)
+  );
   output(data, {
     columns: [
       { key: "id", header: "ID" },
@@ -2259,9 +2303,12 @@ testCommand.command("validate").description("Validate a test script").requiredOp
     throw new CLIError(`Cannot read file: ${filePath}`, 1 /* GeneralError */);
   }
   const client = createAuthenticatedClient();
-  const { data } = await client.post(
-    "/api/validate-script",
-    { script, testType: normalizeTestType(options.type) }
+  const { data } = await withSpinner(
+    "Validating script",
+    () => client.post(
+      "/api/validate-script",
+      { script, testType: normalizeTestType(options.type) }
+    )
   );
   if (data.valid) {
     logger.success(`Script is valid (${options.type})`);
@@ -2353,9 +2400,12 @@ import { Command as Command8 } from "commander";
 var monitorCommand = new Command8("monitor").description("Manage monitors");
 monitorCommand.command("list").description("List all monitors").option("--page <page>", "Page number", "1").option("--limit <limit>", "Items per page", "50").action(async (options) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(
-    "/api/monitors",
-    { page: options.page, limit: options.limit }
+  const { data } = await withSpinner(
+    "Fetching monitors",
+    () => client.get(
+      "/api/monitors",
+      { page: options.page, limit: options.limit }
+    )
   );
   output(data.data, {
     columns: [
@@ -2375,14 +2425,20 @@ Page ${data.pagination.page}/${data.pagination.totalPages} (${data.pagination.to
 });
 monitorCommand.command("get <id>").description("Get monitor details").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/monitors/${id}`);
+  const { data } = await withSpinner(
+    "Fetching monitor details",
+    () => client.get(`/api/monitors/${id}`)
+  );
   outputDetail(data);
 });
 monitorCommand.command("results <id>").description("Get monitor check results").option("--limit <limit>", "Number of results", "20").action(async (id, options) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(
-    `/api/monitors/${id}/results`,
-    { limit: options.limit }
+  const { data } = await withSpinner(
+    "Fetching monitor results",
+    () => client.get(
+      `/api/monitors/${id}/results`,
+      { limit: options.limit }
+    )
   );
   output(data.results, {
     columns: [
@@ -2395,12 +2451,18 @@ monitorCommand.command("results <id>").description("Get monitor check results").
 });
 monitorCommand.command("stats <id>").description("Get monitor performance statistics").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/monitors/${id}/stats`);
+  const { data } = await withSpinner(
+    "Fetching monitor statistics",
+    () => client.get(`/api/monitors/${id}/stats`)
+  );
   outputDetail(data);
 });
 monitorCommand.command("status <id>").description("Get current monitor status").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/monitors/${id}`);
+  const { data } = await withSpinner(
+    "Fetching monitor status",
+    () => client.get(`/api/monitors/${id}`)
+  );
   const statusInfo = {
     id: data.id,
     name: data.name,
@@ -2425,7 +2487,10 @@ monitorCommand.command("create").description("Create a new monitor").requiredOpt
       method: options.method
     }
   };
-  const { data } = await client.post("/api/monitors", body);
+  const { data } = await withSpinner(
+    "Creating monitor",
+    () => client.post("/api/monitors", body)
+  );
   logger.success(`Monitor "${options.name}" created (${data.id})`);
   outputDetail(data);
 });
@@ -2447,7 +2512,10 @@ monitorCommand.command("update <id>").description("Update a monitor").option("--
     logger.warn("No fields to update. Use --name, --url, --interval, --timeout, --method, or --active.");
     return;
   }
-  const { data } = await client.patch(`/api/monitors/${id}`, body);
+  const { data } = await withSpinner(
+    "Updating monitor",
+    () => client.patch(`/api/monitors/${id}`, body)
+  );
   logger.success(`Monitor ${id} updated`);
   outputDetail(data);
 });
@@ -2461,7 +2529,10 @@ monitorCommand.command("delete <id>").description("Delete a monitor").option("--
     }
   }
   const client = createAuthenticatedClient();
-  await client.delete(`/api/monitors/${id}`);
+  await withSpinner(
+    "Deleting monitor",
+    () => client.delete(`/api/monitors/${id}`)
+  );
   logger.success(`Monitor ${id} deleted`);
 });
 
@@ -2470,7 +2541,10 @@ import { Command as Command9 } from "commander";
 var varCommand = new Command9("var").description("Manage project variables");
 varCommand.command("list").description("List all variables").action(async () => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get("/api/variables");
+  const { data } = await withSpinner(
+    "Fetching variables",
+    () => client.get("/api/variables")
+  );
   output(data, {
     columns: [
       { key: "id", header: "ID" },
@@ -2482,7 +2556,10 @@ varCommand.command("list").description("List all variables").action(async () =>
 });
 varCommand.command("get <key>").description("Get a variable by key name").action(async (key) => {
   const client = createAuthenticatedClient();
-  const { data: variables } = await client.get("/api/variables");
+  const { data: variables } = await withSpinner(
+    "Fetching variable",
+    () => client.get("/api/variables")
+  );
   const variable = variables.find((v) => v.key === key);
   if (!variable) {
     throw new CLIError(`Variable "${key}" not found`, 1 /* GeneralError */);
@@ -2491,29 +2568,41 @@ varCommand.command("get <key>").description("Get a variable by key name").action
 });
 varCommand.command("set <key> <value>").description("Create or update a variable").option("--secret", "Mark as secret (value will be encrypted)").option("--description <description>", "Variable description").action(async (key, value, options) => {
   const client = createAuthenticatedClient();
-  const { data: variables } = await client.get("/api/variables");
+  const { data: variables } = await withSpinner(
+    "Checking existing variables",
+    () => client.get("/api/variables")
+  );
   const existing = variables.find((v) => v.key === key);
   if (existing) {
-    await client.put(`/api/variables/${existing.id}`, {
-      key,
-      value,
-      isSecret: options.secret ?? existing.isSecret,
-      ...options.description !== void 0 && { description: options.description }
-    });
+    await withSpinner(
+      "Updating variable",
+      () => client.put(`/api/variables/${existing.id}`, {
+        key,
+        value,
+        isSecret: options.secret ?? existing.isSecret,
+        ...options.description !== void 0 && { description: options.description }
+      })
+    );
     logger.success(`Variable "${key}" updated`);
   } else {
-    await client.post("/api/variables", {
-      key,
-      value,
-      isSecret: options.secret ?? false,
-      ...options.description !== void 0 && { description: options.description }
-    });
+    await withSpinner(
+      "Creating variable",
+      () => client.post("/api/variables", {
+        key,
+        value,
+        isSecret: options.secret ?? false,
+        ...options.description !== void 0 && { description: options.description }
+      })
+    );
     logger.success(`Variable "${key}" created`);
   }
 });
 varCommand.command("delete <key>").description("Delete a variable").option("--force", "Skip confirmation").action(async (key, options) => {
   const client = createAuthenticatedClient();
-  const { data: variables } = await client.get("/api/variables");
+  const { data: variables } = await withSpinner(
+    "Fetching variables",
+    () => client.get("/api/variables")
+  );
   const variable = variables.find((v) => v.key === key);
   if (!variable) {
     throw new CLIError(`Variable "${key}" not found`, 1 /* GeneralError */);
@@ -2526,7 +2615,10 @@ varCommand.command("delete <key>").description("Delete a variable").option("--fo
       return;
     }
   }
-  await client.delete(`/api/variables/${variable.id}`);
+  await withSpinner(
+    "Deleting variable",
+    () => client.delete(`/api/variables/${variable.id}`)
+  );
   logger.success(`Variable "${key}" deleted`);
 });
 
@@ -2535,7 +2627,10 @@ import { Command as Command10 } from "commander";
 var tagCommand = new Command10("tag").description("Manage tags");
 tagCommand.command("list").description("List all tags").action(async () => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get("/api/tags");
+  const { data } = await withSpinner(
+    "Fetching tags",
+    () => client.get("/api/tags")
+  );
   output(data, {
     columns: [
       { key: "id", header: "ID" },
@@ -2546,10 +2641,13 @@ tagCommand.command("list").description("List all tags").action(async () => {
 });
 tagCommand.command("create <name>").description("Create a new tag").option("--color <color>", "Tag color (hex)").action(async (name, options) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.post("/api/tags", {
-    name,
-    color: options.color
-  });
+  const { data } = await withSpinner(
+    "Creating tag",
+    () => client.post("/api/tags", {
+      name,
+      color: options.color
+    })
+  );
   logger.success(`Tag "${name}" created (${data.id})`);
 });
 tagCommand.command("delete <id>").description("Delete a tag").option("--force", "Skip confirmation").action(async (id, options) => {
@@ -2562,7 +2660,10 @@ tagCommand.command("delete <id>").description("Delete a tag").option("--force",
     }
   }
   const client = createAuthenticatedClient();
-  await client.delete(`/api/tags/${id}`);
+  await withSpinner(
+    "Deleting tag",
+    () => client.delete(`/api/tags/${id}`)
+  );
   logger.success(`Tag ${id} deleted`);
 });
 
@@ -3266,17 +3367,44 @@ function buildStatusPageDefinitions(pages) {
 }
 function generateConfigContent(opts) {
   const parts = [];
+  parts.push("/**");
+  parts.push(" * Supercheck Configuration");
+  parts.push(" * \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  parts.push(" *");
+  parts.push(" * This file was generated by `supercheck pull`. It is the source of truth");
+  parts.push(" * for your Supercheck project configuration.");
+  parts.push(" *");
+  parts.push(" * Getting Started:");
+  parts.push(" *   1. Review the configuration below and make any changes you need.");
+  parts.push(" *   2. Preview changes:  supercheck diff");
+  parts.push(" *   3. Deploy changes:   supercheck deploy");
+  parts.push(" *   4. Re-sync:          supercheck pull");
+  parts.push(" *");
+  parts.push(" * Useful Commands:");
+  parts.push(" *   supercheck test validate   Validate local test scripts");
+  parts.push(" *   supercheck config validate Validate this config file");
+  parts.push(" *   supercheck health          Check API connectivity");
+  parts.push(" *   supercheck destroy          Remove all managed resources from the cloud");
+  parts.push(" *");
+  parts.push(` * Documentation: https://supercheck.io/docs/app/welcome`);
+  parts.push(" */");
   parts.push(`import { defineConfig } from '@supercheck/cli'`);
   parts.push("");
   parts.push("export default defineConfig({");
   parts.push(`  schemaVersion: '1.0',`);
+  parts.push("");
+  parts.push("  // Project identifiers \u2014 found in Dashboard > Project Settings");
   parts.push("  project: {");
   parts.push(`    organization: '${opts.orgId}',`);
   parts.push(`    project: '${opts.projectId}',`);
   parts.push("  },");
+  parts.push("");
+  parts.push("  // API connection \u2014 set SUPERCHECK_URL env var for self-hosted or staging");
   parts.push("  api: {");
   parts.push(`    baseUrl: process.env.SUPERCHECK_URL ?? '${opts.baseUrl}',`);
   parts.push("  },");
+  parts.push("");
+  parts.push("  // Test file patterns \u2014 Playwright (.pw.ts) and k6 (.k6.ts) scripts");
   parts.push("  tests: {");
   parts.push("    playwright: {");
   parts.push(`      testMatch: '_supercheck_/tests/**/*.pw.ts',`);
@@ -3286,42 +3414,33 @@ function generateConfigContent(opts) {
   parts.push("    },");
   parts.push("  },");
   if (opts.monitors.length > 0) {
+    parts.push("");
+    parts.push("  // Monitors \u2014 uptime checks, HTTP requests, synthetic tests");
     parts.push(`  monitors: ${formatArray(opts.monitors, 2)},`);
   }
   if (opts.jobs.length > 0) {
+    parts.push("");
+    parts.push("  // Jobs \u2014 scheduled or triggered test execution groups");
     parts.push(`  jobs: ${formatArray(opts.jobs, 2)},`);
   }
   if (opts.variables.length > 0) {
+    parts.push("");
+    parts.push("  // Variables \u2014 key-value pairs available to tests at runtime");
+    parts.push("  // Secret values use process.env references \u2014 set them in your shell or CI/CD");
     parts.push(`  variables: ${formatArray(opts.variables, 2)},`);
   }
   if (opts.tags.length > 0) {
+    parts.push("");
+    parts.push("  // Tags \u2014 labels for organizing tests, monitors, and jobs");
     parts.push(`  tags: ${formatArray(opts.tags, 2)},`);
   }
   if (opts.statusPages.length > 0) {
+    parts.push("");
+    parts.push("  // Status Pages \u2014 public dashboards showing monitor health");
     parts.push(`  statusPages: ${formatArray(opts.statusPages, 2)},`);
   }
   parts.push("})");
   parts.push("");
-  parts.push(`/**`);
-  parts.push(` * \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
-  parts.push(` * Getting Started`);
-  parts.push(` * \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
-  parts.push(` *`);
-  parts.push(` * 1. Install dependencies:`);
-  parts.push(` *    npm install`);
-  parts.push(` *    npx playwright install`);
-  parts.push(` *`);
-  parts.push(` * 2. Run tests:`);
-  parts.push(` *    npx supercheck test`);
-  parts.push(` *`);
-  parts.push(` * 3. Useful commands:`);
-  parts.push(` *    supercheck diff    Preview changes against the cloud`);
-  parts.push(` *    supercheck deploy  Push local config to Supercheck`);
-  parts.push(` *    supercheck pull    Sync cloud resources locally`);
-  parts.push(` *`);
-  parts.push(` * Documentation: https://docs.supercheck.io`);
-  parts.push(` */`);
-  parts.push("");
   return parts.join("\n");
 }
 function formatArray(arr, baseIndent) {
@@ -3476,9 +3595,12 @@ var pullCommand = new Command14("pull").description("Pull tests, monitors, jobs,
         fullTests.push(t);
       } else {
         try {
-          const { data } = await client.get(
-            `/api/tests/${t.id}`,
-            { includeScript: "true" }
+          const { data } = await withSpinner(
+            `Fetching script for "${t.title}"`,
+            () => client.get(
+              `/api/tests/${t.id}`,
+              { includeScript: "true" }
+            )
           );
           fullTests.push(data);
         } catch (err) {
@@ -3607,7 +3729,10 @@ import { Command as Command15 } from "commander";
 var notificationCommand = new Command15("notification").alias("notifications").description("Manage notification providers");
 notificationCommand.command("list").description("List notification providers").action(async () => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get("/api/notification-providers");
+  const { data } = await withSpinner(
+    "Fetching notification providers",
+    () => client.get("/api/notification-providers")
+  );
   output(data, {
     columns: [
       { key: "id", header: "ID" },
@@ -3620,7 +3745,10 @@ notificationCommand.command("list").description("List notification providers").a
 });
 notificationCommand.command("get <id>").description("Get notification provider details").action(async (id) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get(`/api/notification-providers/${id}`);
+  const { data } = await withSpinner(
+    "Fetching provider details",
+    () => client.get(`/api/notification-providers/${id}`)
+  );
   outputDetail(data);
 });
 notificationCommand.command("create").description("Create a notification provider").requiredOption("--type <type>", "Provider type (email, slack, webhook, telegram, discord, teams)").requiredOption("--name <name>", "Provider name").option("--config <json>", "Provider config as JSON string").action(async (options) => {
@@ -3640,11 +3768,14 @@ notificationCommand.command("create").description("Create a notification provide
     }
   }
   const client = createAuthenticatedClient();
-  const { data } = await client.post("/api/notification-providers", {
-    name: options.name,
-    type: options.type,
-    config: { name: options.name, ...config }
-  });
+  const { data } = await withSpinner(
+    "Creating notification provider",
+    () => client.post("/api/notification-providers", {
+      name: options.name,
+      type: options.type,
+      config: { name: options.name, ...config }
+    })
+  );
   logger.success(`Notification provider "${options.name}" created (${data.id})`);
   outputDetail(data);
 });
@@ -3654,7 +3785,10 @@ notificationCommand.command("update <id>").description("Update a notification pr
     logger.warn("No fields to update. Use --name, --type, or --config.");
     return;
   }
-  const { data: existing } = await client.get(`/api/notification-providers/${id}`);
+  const { data: existing } = await withSpinner(
+    "Fetching existing provider",
+    () => client.get(`/api/notification-providers/${id}`)
+  );
   let updatedConfig = existing.config ?? {};
   if (options.config) {
     try {
@@ -3671,7 +3805,10 @@ notificationCommand.command("update <id>").description("Update a notification pr
     type: updatedType,
     config: updatedConfig
   };
-  const { data } = await client.put(`/api/notification-providers/${id}`, body);
+  const { data } = await withSpinner(
+    "Updating notification provider",
+    () => client.put(`/api/notification-providers/${id}`, body)
+  );
   logger.success(`Notification provider ${id} updated`);
   outputDetail(data);
 });
@@ -3685,7 +3822,10 @@ notificationCommand.command("delete <id>").description("Delete a notification pr
     }
   }
   const client = createAuthenticatedClient();
-  await client.delete(`/api/notification-providers/${id}`);
+  await withSpinner(
+    "Deleting notification provider",
+    () => client.delete(`/api/notification-providers/${id}`)
+  );
   logger.success(`Notification provider ${id} deleted`);
 });
 notificationCommand.command("test").description("Send a test notification to verify provider configuration").requiredOption("--type <type>", "Provider type (email, slack, webhook, telegram, discord, teams)").requiredOption("--config <json>", "Provider config as JSON string").action(async (options) => {
@@ -3703,9 +3843,12 @@ notificationCommand.command("test").description("Send a test notification to ver
     throw new CLIError("Invalid JSON in --config", 1 /* GeneralError */);
   }
   const client = createAuthenticatedClient();
-  const { data } = await client.post(
-    "/api/notification-providers/test",
-    { type: options.type, config }
+  const { data } = await withSpinner(
+    "Sending test notification",
+    () => client.post(
+      "/api/notification-providers/test",
+      { type: options.type, config }
+    )
   );
   if (data.success) {
     logger.success(data.message ?? "Test notification sent successfully");
@@ -3719,7 +3862,10 @@ import { Command as Command16 } from "commander";
 var alertCommand = new Command16("alert").alias("alerts").description("View alert history");
 alertCommand.command("history").description("Get alert history").option("--page <page>", "Page number", "1").option("--limit <limit>", "Number of results per page", "50").action(async (options) => {
   const client = createAuthenticatedClient();
-  const { data } = await client.get("/api/alerts/history", { page: options.page, limit: options.limit });
+  const { data } = await withSpinner(
+    "Fetching alert history",
+    () => client.get("/api/alerts/history", { page: options.page, limit: options.limit })
+  );
   const items = Array.isArray(data) ? data : data.data;
   const pagination = Array.isArray(data) ? null : data.pagination;
   output(items, {
@@ -3750,7 +3896,10 @@ var auditCommand = new Command17("audit").description("View audit logs (admin)")
   };
   if (options.search) params.search = options.search;
   if (options.action) params.action = options.action;
-  const { data } = await client.get("/api/audit", params);
+  const { data } = await withSpinner(
+    "Fetching audit logs",
+    () => client.get("/api/audit", params)
+  );
   if (!data.success) {
     throw new CLIError("Failed to fetch audit logs", 4 /* ApiError */);
   }