qualty 0.1.30 → 0.1.32

package/bin/qualty.js

@@ -9,19 +9,31 @@ import {
   readdirSync,
   writeFileSync,
 } from "node:fs";
-import { gzipSync } from "node:zlib";
 import { spawn, spawnSync } from "node:child_process";
 import { homedir, hostname } from "node:os";
 import { dirname, join } from "node:path";
 import { createInterface } from "node:readline/promises";
 import process from "node:process";
 import { rewriteUrlForLocalRun, runLocalCi, summarizeStorageStateFile, logAuthStateDiagnostics } from "./local-runner.js";
+import {
+  AUTH_PROFILES_VARIABLE,
+  AUTH_SECRET_PRIMARY,
+  AUTH_SHARDS_VARIABLE,
+  authShardSecretName,
+  buildAuthBundleManifest,
+  collectAuthShardPayloadsFromEnv,
+  restoreAuthPayloadsToDisk,
+  shardAuthBundleManifest,
+} from "./auth-ci-bundle.js";
 
 /** CLI backend URL is fixed by Qualty distribution. */
-const DEFAULT_QUALTY_API_URL = "https://qualty-api-production.up.railway.app";
+// const DEFAULT_QUALTY_API_URL = "https://qualty-api-production.up.railway.app";
 // const DEFAULT_QUALTY_API_URL = "http://localhost:8000";
+const DEFAULT_QUALTY_API_URL = "https://qualty-api-development.up.railway.app";
+
 
 const PROJECT_CONFIG_FILENAME = ".qualty.json";
+const DOTENV_FILENAME = ".env";
 const QUALTY_SHARED_CREDS_DIR = join(homedir(), ".qualty");
 const QUALTY_SHARED_CREDS_PATH = join(QUALTY_SHARED_CREDS_DIR, "credentials");
 
@@ -40,6 +52,47 @@ function getProjectConfigWritePath() {
   return findProjectConfigPath() || join(process.cwd(), PROJECT_CONFIG_FILENAME);
 }
 
+function findProjectDotenvPath() {
+  let current = process.cwd();
+  for (;;) {
+    const candidate = join(current, DOTENV_FILENAME);
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+
+function parseDotenvText(text) {
+  const out = {};
+  for (const raw of String(text || "").split("\n")) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#") || !line.includes("=")) continue;
+    const eq = line.indexOf("=");
+    const key = line.slice(0, eq).trim();
+    let value = line.slice(eq + 1).trim();
+    if (
+      (value.startsWith('"') && value.endsWith('"'))
+      || (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    }
+    if (key) out[key] = value;
+  }
+  return out;
+}
+
+/** Project .env walked up from cwd (same resolution as Qualty MCP). */
+function loadProjectDotenv() {
+  const path = findProjectDotenvPath();
+  if (!path) return {};
+  try {
+    return parseDotenvText(readFileSync(path, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
 function readSharedCredentials() {
   if (!existsSync(QUALTY_SHARED_CREDS_PATH)) return {};
   try {
@@ -74,6 +127,11 @@ function authProfileFromConfig(projectCfg, fallback = "") {
   return String(fallback || projectCfg.default_auth_profile || "").trim();
 }
 
+/** Only --auth-profile on the CLI; config default is not a run-wide override. */
+function explicitAuthProfileFromArgs(args) {
+  return String(args["auth-profile"] || "").trim();
+}
+
 function readProjectConfig() {
   const configPath = findProjectConfigPath();
   if (!configPath) return {};
@@ -116,7 +174,14 @@ function normalizeApiUrl(raw, { label = "API URL" } = {}) {
 }
 
 function qualtyBaseUrlFromEnv() {
-  return String(process.env.QUALTY_BASE_URL || process.env.QUALTY_API_URL || "").trim();
+  const dotenv = loadProjectDotenv();
+  return String(
+    dotenv.QUALTY_BASE_URL
+      || dotenv.QUALTY_API_URL
+      || process.env.QUALTY_BASE_URL
+      || process.env.QUALTY_API_URL
+      || ""
+  ).trim();
 }
 
 function resolveApiUrl(args = {}) {
@@ -134,8 +199,14 @@ function resolveApiUrl(args = {}) {
 }
 
 function resolveToken(args = {}) {
+  if (args.token) return String(args.token).trim();
+  const dotenv = loadProjectDotenv();
+  const fromDotenv = String(dotenv.QUALTY_API_TOKEN || "").trim();
+  if (fromDotenv) return fromDotenv;
+  const fromProcessEnv = String(process.env.QUALTY_API_TOKEN || "").trim();
+  if (fromProcessEnv) return fromProcessEnv;
   const creds = readSharedCredentials();
-  return args.token || process.env.QUALTY_API_TOKEN || creds.api_token || "";
+  return String(creds.api_token || "").trim();
 }
 
 function resolveOrgId(args = {}) {
@@ -179,11 +250,19 @@ function usage() {
       "Usage:",
       "  qualty setup [--token <bearer-token>] [--org <org-id>]",
       "  qualty auth setup [--project <project-id>] [--profile <profile-name>] [--headed]",
-      "  qualty auth export-ci [--project <project-id>] [--profile <profile-name>] [--org <org-id>]",
-      "                   [--url <api-base-url>] [--suite-id <suite-uuid>] [--repo <owner/repo>]",
-      "                   [--output <path>] [--no-file] [--copy] [--gzip] [--include-token]",
-      "                   [--set-secret | --set-github]  gh: secrets (token, API URL, auth) + variables (org, project, profile, …)",
-      "                   [--cli-repo <owner/repo>] [--cli-ref <branch>]  Optional CI variables",
+      "  qualty auth export [--project <project-id>] [--profile <profile-name>] [--org <org-id>]",
+      "               [--profiles <name1,name2>] [--repo <owner/repo>]",
+      "               [--output <path>] [--no-file] [--copy] [--set-secret | --set-github]",
+      "               Push login profile state to GitHub only (not API token, org, or project vars).",
+      "  qualty ci setup [--project <project-id>] [--profile <profile-name>] [--org <org-id>]",
+      "               [--all-profiles] [--profiles <name1,name2>]",
+      "               [--suite-id <suite-uuid>] [--ids <id1,id2>]  bundle login profiles required by tests",
+      "               [--url <api-base-url>] [--repo <owner/repo>]",
+      "               [--output <path>] [--no-file] [--copy] [--gzip] [--include-token]",
+      "               [--set-secret | --set-github]  gh: secrets (token, API URL, auth bundle) + variables",
+      "               [--cli-repo <owner/repo>] [--cli-ref <branch>]  Optional CI variables",
+      "  qualty auth restore-ci [--org <org-id>] [--project <project-id>] [--profile <fallback-profile>]",
+      "                   Reads QUALTY_AUTH_STATE_B64 (+ _2, _3, … shards) and writes ~/.qualty/local-contexts/…",
       "  qualty connect --project <project-id> [--port 3000] [--token <bearer-token>] [--org <org-id>]",
       "  qualty run --project <project-id> [--suite-id <suite-id>] [--ids <id1,id2>] [--local] [--token <bearer-token>] [--org <org-id>]",
       "             [--poll-interval 5] [--timeout 30] [--fail-on-failure true] [--no-view-logs]",
@@ -194,11 +273,11 @@ function usage() {
       "  qualty resolve --project <project-id> [--suite-id <suite-id>] [--ids <id1,id2>] [--json] [--token <bearer-token>]",
       "",
       "Env vars:",
-      "  QUALTY_API_TOKEN  Bearer token used for auth",
+      "  QUALTY_API_TOKEN  Project .env first (same as MCP), then process env, then ~/.qualty/credentials",
       "  QUALTY_BASE_URL   API base URL when --url is not set (default: production)",
       "  QUALTY_LOCAL_CONCURRENCY  Local parallel workers for --local runs (default: 4)",
       "",
-      "Config (.qualty.json): default_org_id, default_project_id, default_auth_profile",
+      "Config (.qualty.json): default_org_id, default_project_id, default_auth_profile (ci/auth setup only; local runs use each test's saved login profile unless --auth-profile is set)",
       "  CLI flags (--org, --project, --profile, --url) override config values.",
     ].join("\n")
   );
@@ -381,9 +460,7 @@ async function runSetup(args) {
 
   try {
     const currentOrgId = String(args.org || projectCfg.default_org_id || "");
-    const currentToken = String(
-      args.token || process.env.QUALTY_API_TOKEN || sharedCreds.api_token || ""
-    );
+    const currentToken = resolveToken(args);
 
     let token = "";
     if (args.token) {
@@ -530,12 +607,10 @@ function localAuthStatePath({ orgId, projectId, profile }) {
   return join(QUALTY_SHARED_CREDS_DIR, "local-contexts", orgSeg, projectSeg, `${profileSeg}.json`);
 }
 
-function authExportCiOutputPath(statePath) {
+function ciSetupAuthBundleOutputPath(statePath) {
   return statePath.replace(/\.json$/i, ".b64");
 }
 
-const GITHUB_SECRET_MAX_BYTES = 64 * 1024;
-
 function copyToClipboard(text) {
   if (process.platform === "darwin") {
     const result = spawnSync("pbcopy", { input: text, encoding: "utf8" });
@@ -601,7 +676,8 @@ function syncGithubCiConfig({
   orgId,
   projectId,
   profile,
-  authPayload,
+  profileNames,
+  authShards,
   apiUrl,
   token,
   suiteId,
@@ -613,8 +689,9 @@ function syncGithubCiConfig({
     results.push({ kind, name, ...outcome });
   };
 
-  const authResult = setGithubSecret("QUALTY_AUTH_STATE_B64", authPayload, { repo });
-  record("secret", "QUALTY_AUTH_STATE_B64", authResult);
+  for (const shard of authShards || []) {
+    record("secret", shard.secretName, setGithubSecret(shard.secretName, shard.payload, { repo }));
+  }
 
   if (token) {
     record("secret", "QUALTY_API_TOKEN", setGithubSecret("QUALTY_API_TOKEN", token, { repo }));
@@ -632,7 +709,21 @@ function syncGithubCiConfig({
 
   record("variable", "QUALTY_ORG_ID", setGithubVariable("QUALTY_ORG_ID", orgId, { repo }));
   record("variable", "QUALTY_PROJECT_ID", setGithubVariable("QUALTY_PROJECT_ID", String(projectId), { repo }));
-  record("variable", "QUALTY_AUTH_PROFILE", setGithubVariable("QUALTY_AUTH_PROFILE", profile, { repo }));
+
+  const names = (profileNames || []).filter(Boolean);
+  if (names.length > 0) {
+    record("variable", AUTH_PROFILES_VARIABLE, setGithubVariable(AUTH_PROFILES_VARIABLE, names.join(","), { repo }));
+  }
+  if (profile) {
+    record("variable", "QUALTY_AUTH_PROFILE", setGithubVariable("QUALTY_AUTH_PROFILE", profile, { repo }));
+  }
+  if ((authShards || []).length > 1) {
+    record(
+      "variable",
+      AUTH_SHARDS_VARIABLE,
+      setGithubVariable(AUTH_SHARDS_VARIABLE, String(authShards.length), { repo })
+    );
+  }
 
   if (suiteId) {
     record("variable", "QUALTY_SUITE_ID", setGithubVariable("QUALTY_SUITE_ID", String(suiteId), { repo }));
@@ -648,6 +739,37 @@ function syncGithubCiConfig({
   return results;
 }
 
+/**
+ * Push only auth bundle secrets and auth-related repository variables (no API token or org/project).
+ */
+function syncGithubAuthProfileOnly({ repo, profile, profileNames, authShards }) {
+  const results = [];
+  const record = (kind, name, outcome) => {
+    results.push({ kind, name, ...outcome });
+  };
+
+  for (const shard of authShards || []) {
+    record("secret", shard.secretName, setGithubSecret(shard.secretName, shard.payload, { repo }));
+  }
+
+  const names = (profileNames || []).filter(Boolean);
+  if (names.length > 0) {
+    record("variable", AUTH_PROFILES_VARIABLE, setGithubVariable(AUTH_PROFILES_VARIABLE, names.join(","), { repo }));
+  }
+  if (profile) {
+    record("variable", "QUALTY_AUTH_PROFILE", setGithubVariable("QUALTY_AUTH_PROFILE", profile, { repo }));
+  }
+  if ((authShards || []).length > 1) {
+    record(
+      "variable",
+      AUTH_SHARDS_VARIABLE,
+      setGithubVariable(AUTH_SHARDS_VARIABLE, String(authShards.length), { repo })
+    );
+  }
+
+  return results;
+}
+
 function printGithubSyncResults(results, { repo }) {
   const target = repo ? ` (repo ${repo})` : "";
   const printGroup = (title, rows) => {
@@ -728,7 +850,7 @@ function configStringValue(projectCfg, key, configPath) {
   );
 }
 
-function missingExportCiField(fieldLabel, { flag, configKey, configPath, hasFlag }) {
+function missingCiSetupField(fieldLabel, { flag, configKey, configPath, hasFlag }) {
   const configHint = configPath
     ? `${PROJECT_CONFIG_FILENAME} at ${configPath} (${configKey})`
     : `${PROJECT_CONFIG_FILENAME} (not found walking up from ${process.cwd()})`;
@@ -744,12 +866,22 @@ function missingExportCiField(fieldLabel, { flag, configKey, configPath, hasFlag
   ].join(" ");
 }
 
-function resolveExportCiConfig(args) {
+function resolveCiSetupConfig(args, { requireProfile = true } = {}) {
   const { configPath, config: projectCfg } = readProjectConfigStrict();
 
   const orgFromFlag = String(args.org || "").trim();
   const projectFromFlag = String(args.project || "").trim();
   const profileFromFlag = String(args.profile || args["auth-profile"] || "").trim();
+  const allProfiles = parseBoolean(args["all-profiles"], false);
+  const profilesList = String(args.profiles || "")
+    .split(",")
+    .map((part) => part.trim())
+    .filter(Boolean);
+  const suiteId = String(args["suite-id"] || args.suite || "").trim();
+  const explicitIds = String(args.ids || "")
+    .split(",")
+    .map((part) => part.trim())
+    .filter(Boolean);
 
   let orgId = orgFromFlag;
   if (!orgId) {
@@ -768,7 +900,7 @@ function resolveExportCiConfig(args) {
 
   if (!orgId) {
     throw new Error(
-      missingExportCiField("org ID", {
+      missingCiSetupField("org ID", {
         flag: "--org",
         configKey: "default_org_id",
         configPath,
@@ -778,7 +910,7 @@ function resolveExportCiConfig(args) {
   }
   if (!projectId) {
     throw new Error(
-      missingExportCiField("project ID", {
+      missingCiSetupField("project ID", {
         flag: "--project",
         configKey: "default_project_id",
         configPath,
@@ -786,9 +918,12 @@ function resolveExportCiConfig(args) {
       })
     );
   }
-  if (!profile) {
+
+  const hasMultiProfileMode =
+    allProfiles || profilesList.length > 0 || Boolean(suiteId) || explicitIds.length > 0;
+  if (requireProfile && !profile && !hasMultiProfileMode) {
     throw new Error(
-      missingExportCiField("auth profile", {
+      missingCiSetupField("auth profile", {
         flag: "--profile",
         configKey: "default_auth_profile",
         configPath,
@@ -804,43 +939,163 @@ function resolveExportCiConfig(args) {
     throw new Error(`Invalid API URL: ${err.message}`);
   }
 
-  return { orgId, projectId, profile, apiUrl, configPath };
+  return {
+    orgId,
+    projectId,
+    profile,
+    apiUrl,
+    configPath,
+    allProfiles,
+    profilesList,
+    suiteId,
+    explicitIds,
+  };
+}
+
+function jobUsesSavedLogin(job) {
+  if (!job) return false;
+  if (job.use_saved_login) return true;
+  if (job.saved_login_profile_id) return true;
+  const profile = job.saved_login_profile;
+  return Boolean(profile && typeof profile === "object" && (profile.id || profile.name));
 }
 
-function encodeAuthStateForGithubSecret(statePath, { gzip = false } = {}) {
-  const raw = readFileSync(statePath);
-  if (gzip) {
-    return {
-      encoding: "gzip+base64",
-      payload: gzipSync(raw).toString("base64"),
-      rawBytes: raw.length,
-    };
+async function fetchSavedLoginProfilesForProject({ apiUrl, token, orgId, projectId }) {
+  const payload = await apiRequest({
+    apiUrl,
+    token,
+    orgId,
+    path: `/api/v1/projects/${encodeURIComponent(String(projectId))}/saved-login-profiles`,
+  }).catch(() => []);
+  return Array.isArray(payload) ? payload : [];
+}
+
+function localProfileLabelFromApiRow(row, fallbackName = "") {
+  return String(row?.local_profile_name || row?.name || fallbackName || "").trim();
+}
+
+async function resolveRequiredProfileNamesFromTests({
+  apiUrl,
+  token,
+  orgId,
+  projectId,
+  suiteId,
+  explicitIds,
+}) {
+  const jobsPayload = await resolveSavedJobs({
+    apiUrl,
+    token,
+    orgId,
+    projectId,
+    suiteId,
+    explicitIds,
+  });
+  const jobs = Array.isArray(jobsPayload)
+    ? jobsPayload
+    : Array.isArray(jobsPayload?.results)
+      ? jobsPayload.results
+      : Array.isArray(jobsPayload?.jobs)
+        ? jobsPayload.jobs
+        : [];
+  const names = new Set();
+  for (const job of jobs) {
+    if (!jobUsesSavedLogin(job)) continue;
+    const name = String(job?.saved_login_profile?.name || "").trim();
+    if (name) names.add(name);
+  }
+  return [...names];
+}
+
+async function resolveCiSetupProfileEntries({
+  orgId,
+  projectId,
+  profile,
+  allProfiles,
+  profilesList,
+  suiteId,
+  explicitIds,
+  apiUrl,
+  token,
+}) {
+  const apiProfiles = token
+    ? await fetchSavedLoginProfilesForProject({ apiUrl, token, orgId, projectId })
+    : [];
+
+  let requestedNames = [];
+  if (allProfiles) {
+    requestedNames = apiProfiles.map((row) => String(row?.name || "").trim()).filter(Boolean);
+    if (requestedNames.length === 0) {
+      requestedNames = listLocalAuthProfiles({ orgId, projectId });
+    }
+  } else if (profilesList.length > 0) {
+    requestedNames = profilesList;
+  } else if (suiteId || explicitIds.length > 0) {
+    if (!token) {
+      throw new Error("QUALTY_API_TOKEN is required to resolve profiles from --suite-id or --ids.");
+    }
+    requestedNames = await resolveRequiredProfileNamesFromTests({
+      apiUrl,
+      token,
+      orgId,
+      projectId,
+      suiteId,
+      explicitIds,
+    });
+    if (requestedNames.length === 0 && profile) {
+      requestedNames = [profile];
+    }
+  } else if (profile) {
+    requestedNames = [profile];
   }
-  return {
-    encoding: "base64",
-    payload: raw.toString("base64"),
-    rawBytes: raw.length,
-  };
+
+  requestedNames = [...new Set(requestedNames.filter(Boolean))];
+  if (requestedNames.length === 0) {
+    throw new Error(
+      "No auth profiles selected. Pass --profile, --profiles, --all-profiles, or --suite-id / --ids."
+    );
+  }
+
+  const entries = [];
+  const missing = [];
+  for (const dashboardName of requestedNames) {
+    const apiRow = apiProfiles.find((row) => String(row?.name || "").trim() === dashboardName);
+    const localProfileName = localProfileLabelFromApiRow(apiRow, dashboardName) || dashboardName;
+    const statePath = localAuthStatePath({ orgId, projectId, profile: localProfileName });
+    if (!existsSync(statePath)) {
+      missing.push({ dashboardName, localProfileName, statePath });
+      continue;
+    }
+    entries.push({
+      name: dashboardName,
+      localProfileName,
+      statePath,
+    });
+  }
+
+  if (missing.length > 0) {
+    const lines = missing.map(
+      (row) =>
+        `  - "${row.dashboardName}" → ${row.statePath}\n    qualty auth setup --project ${projectId} --profile "${row.dashboardName}"`
+    );
+    throw new Error(["Local auth state missing for:", ...lines].join("\n"));
+  }
+
+  return entries;
 }
 
-function githubAuthRestoreShell({ orgId, projectId, profile }) {
+function githubAuthRestoreShell({ shardCount = 1 } = {}) {
+  const shardEnvLines = [];
+  for (let index = 1; index <= Math.max(1, shardCount); index += 1) {
+    const secretName = authShardSecretName(index);
+    shardEnvLines.push(`    ${secretName}: \${{ secrets.${secretName} }}`);
+  }
   return [
-    `- name: Restore Qualty login state`,
+    `- name: Restore Qualty login states`,
     `  env:`,
-    `    QUALTY_AUTH_STATE_B64: \${{ secrets.QUALTY_AUTH_STATE_B64 }}`,
-    `  run: |`,
-    `    set -euo pipefail`,
-    `    slug_segment() {`,
-    `      printf '%s' "$1" | sed -E 's/^[[:space:]]+|[[:space:]]+$//g; s/[^a-zA-Z0-9._-]+/_/g; s/^_+|_+$//g'`,
-    `    }`,
-    `    org_seg=$(slug_segment "$QUALTY_ORG_ID"); [ -n "$org_seg" ] || org_seg="default-org"`,
-    `    project_seg=$(slug_segment "$QUALTY_PROJECT_ID"); [ -n "$project_seg" ] || project_seg="default-project"`,
-    `    profile_seg=$(slug_segment "$QUALTY_AUTH_PROFILE"); [ -n "$profile_seg" ] || profile_seg="default"`,
-    `    auth_dir="$HOME/.qualty/local-contexts/\${org_seg}/\${project_seg}"`,
-    `    auth_file="\${auth_dir}/\${profile_seg}.json"`,
-    `    mkdir -p "$auth_dir"`,
-    `    echo "$QUALTY_AUTH_STATE_B64" | base64 -d | gunzip > "$auth_file"`,
-    `    test -s "$auth_file"`,
+    ...shardEnvLines,
+    `    QUALTY_ORG_ID: \${{ vars.QUALTY_ORG_ID }}`,
+    `    QUALTY_PROJECT_ID: \${{ vars.QUALTY_PROJECT_ID }}`,
+    `  run: npx --yes qualty auth restore-ci`,
     ``,
     `- name: Run Qualty tests (local)`,
     `  env:`,
@@ -851,84 +1106,311 @@ function githubAuthRestoreShell({ orgId, projectId, profile }) {
     `      --org "$QUALTY_ORG_ID" \\`,
     `      --project "$QUALTY_PROJECT_ID" \\`,
     `      --suite-id "YOUR-SUITE-UUID" \\`,
-    `      --auth-profile "$QUALTY_AUTH_PROFILE" \\`,
     `      --fail-on-failure true`,
+    `    # Omit --auth-profile when tests use different saved login profiles.`,
+    `    # Add --auth-profile "Profile Name" only to force one profile for the whole run.`,
   ].join("\n");
 }
 
-async function runAuthExportCi(args) {
-  const { orgId, projectId, profile, apiUrl, configPath } = resolveExportCiConfig(args);
-  const token = resolveToken(args);
+async function runAuthRestoreCi(args) {
+  const orgId = String(args.org || process.env.QUALTY_ORG_ID || "").trim();
+  const projectId = String(args.project || process.env.QUALTY_PROJECT_ID || "").trim();
+  const fallbackProfile = String(
+    args.profile || args["auth-profile"] || process.env.QUALTY_AUTH_PROFILE || ""
+  ).trim();
 
-  const statePath = localAuthStatePath({ orgId, projectId, profile });
-  if (!existsSync(statePath)) {
+  if (!orgId) {
+    throw new Error("Missing org ID. Set QUALTY_ORG_ID or pass --org.");
+  }
+  if (!projectId) {
+    throw new Error("Missing project ID. Set QUALTY_PROJECT_ID or pass --project.");
+  }
+
+  const payloads = collectAuthShardPayloadsFromEnv(process.env);
+  if (payloads.length === 0) {
     throw new Error(
-      [
-        "Local auth state not found:",
-        `  ${statePath}`,
-        "",
-        "Create it first:",
-        `  qualty auth setup --project ${projectId} --profile "${profile}"`,
-        configPath ? `  (org/project/profile from ${configPath})` : "",
-      ]
-        .filter(Boolean)
-        .join("\n")
+      `Missing ${AUTH_SECRET_PRIMARY}. Run qualty ci setup --set-github (first time) or qualty auth export --set-github (profile refresh).`
     );
   }
 
-  const setGithubFlag =
-    parseBoolean(args["set-github"], false) || parseBoolean(args["set-secret"], false);
-  // CI path: one format only — gzip then base64 in QUALTY_AUTH_STATE_B64 (no separate gzip flag).
-  let gzip = parseBoolean(args.gzip, false) || setGithubFlag;
-  let encoded;
-  try {
-    encoded = encodeAuthStateForGithubSecret(statePath, { gzip });
-  } catch (err) {
+  const restored = restoreAuthPayloadsToDisk({
+    payloads,
+    orgId,
+    projectId,
+    fallbackProfile,
+  });
+
+  for (const row of restored) {
+    // eslint-disable-next-line no-console
+    console.log(`Restored login state: ${row.path} (profile "${row.name}")`);
+  }
+  // eslint-disable-next-line no-console
+  console.log(`Restored ${restored.length} login profile(s).`);
+}
+
+async function runAuthExport(args) {
+  if (
+    parseBoolean(args["all-profiles"], false) ||
+    String(args["suite-id"] || args.suite || "").trim() ||
+    String(args.ids || "")
+      .split(",")
+      .map((part) => part.trim())
+      .filter(Boolean).length > 0
+  ) {
     throw new Error(
-      `Could not read auth state at ${statePath}: ${err.message}`
+      "qualty auth export only updates login profile secrets. For full CI bootstrap use: qualty ci setup"
     );
   }
-  let secretBytes = Buffer.byteLength(encoded.payload, "utf8");
-  if (!gzip && secretBytes > GITHUB_SECRET_MAX_BYTES - 1024) {
-    gzip = true;
-    try {
-      encoded = encodeAuthStateForGithubSecret(statePath, { gzip: true });
-    } catch (err) {
-      throw new Error(
-        `Could not gzip auth state at ${statePath}: ${err.message}`
+
+  const profilesList = String(args.profiles || "")
+    .split(",")
+    .map((part) => part.trim())
+    .filter(Boolean);
+  const { orgId, projectId, profile, apiUrl, configPath } = resolveCiSetupConfig(args, {
+    requireProfile: profilesList.length === 0,
+  });
+  const token = resolveToken(args);
+
+  const profileEntries = await resolveCiSetupProfileEntries({
+    orgId,
+    projectId,
+    profile,
+    allProfiles: false,
+    profilesList,
+    suiteId: "",
+    explicitIds: [],
+    apiUrl,
+    token,
+  });
+  const profileNames = profileEntries.map((entry) => entry.name);
+  const primaryProfile = profile || profileNames[0] || "";
+
+  const manifest = buildAuthBundleManifest({ orgId, projectId, profileEntries });
+  const authShards = shardAuthBundleManifest(manifest);
+  const primaryShard = authShards[0];
+
+  const setGithubFlag =
+    parseBoolean(args["set-github"], false) || parseBoolean(args["set-secret"], false);
+  const noFile = parseBoolean(args["no-file"], false);
+  const outputPath = noFile
+    ? String(args.output || "").trim()
+    : String(args.output || "").trim() ||
+      ciSetupAuthBundleOutputPath(
+        localAuthStatePath({ orgId, projectId, profile: profileEntries[0].localProfileName })
       );
+  const copyToClipboardFlag = parseBoolean(args.copy, false);
+  const githubRepo = String(args.repo || "").trim();
+
+  if (outputPath) {
+    writeFileSync(outputPath, primaryShard.payload, "utf8");
+    try {
+      chmodSync(outputPath, 0o600);
+    } catch {
+      // ignore platforms that do not support chmod
+    }
+    for (let index = 1; index < authShards.length; index += 1) {
+      const shard = authShards[index];
+      const shardPath = outputPath.replace(/(\.[^./]+)?$/, `_${index + 1}$1`);
+      writeFileSync(shardPath, shard.payload, "utf8");
+      try {
+        chmodSync(shardPath, 0o600);
+      } catch {
+        // ignore
+      }
     }
-    secretBytes = Buffer.byteLength(encoded.payload, "utf8");
   }
-  if (secretBytes > GITHUB_SECRET_MAX_BYTES - 1024) {
-    throw new Error(
-      `Auth state is too large for a GitHub secret (${secretBytes} bytes; limit ~64 KB). ` +
-        "Try a shorter-lived session, fewer cookies, or contact Qualty support."
+
+  const skipPayloadPrint = Boolean(outputPath || copyToClipboardFlag || setGithubFlag);
+  const totalSecretBytes = authShards.reduce(
+    (sum, shard) => sum + Buffer.byteLength(shard.payload, "utf8"),
+    0
+  );
+
+  // eslint-disable-next-line no-console
+  console.log("");
+  // eslint-disable-next-line no-console
+  console.log("=== Qualty → GitHub Actions (login profiles only) ===");
+  // eslint-disable-next-line no-console
+  console.log("");
+  // eslint-disable-next-line no-console
+  console.log(
+    `Auth bundle: ${profileNames.length} profile(s), ${authShards.length} secret shard(s), ${totalSecretBytes} bytes total`
+  );
+  for (const shard of authShards) {
+    // eslint-disable-next-line no-console
+    console.log(
+      `  - ${shard.secretName}: ${shard.profileNames.join(", ")} (${Buffer.byteLength(shard.payload, "utf8")} bytes)`
+    );
+  }
+  // eslint-disable-next-line no-console
+  console.log("");
+  if (outputPath) {
+    // eslint-disable-next-line no-console
+    console.log(`Wrote ${AUTH_SECRET_PRIMARY} to ${outputPath}`);
+    for (let index = 1; index < authShards.length; index += 1) {
+      const shard = authShards[index];
+      const shardPath = outputPath.replace(/(\.[^./]+)?$/, `_${index + 1}$1`);
+      // eslint-disable-next-line no-console
+      console.log(`Wrote ${shard.secretName} to ${shardPath}`);
+    }
+    // eslint-disable-next-line no-console
+    console.log("");
+  }
+  if (setGithubFlag) {
+    const syncResults = syncGithubAuthProfileOnly({
+      repo: githubRepo,
+      profile: primaryProfile,
+      profileNames,
+      authShards,
+    });
+    printGithubSyncResults(syncResults, { repo: githubRepo });
+    const failedAuth = syncResults.filter((row) => row.kind === "secret" && !row.ok);
+    if (failedAuth.length > 0 && outputPath) {
+      // eslint-disable-next-line no-console
+      console.log("  Manual auth secrets:");
+      authShards.forEach((shard, index) => {
+        const shardPath =
+          index === 0 ? outputPath : outputPath.replace(/(\.[^./]+)?$/, `_${index + 1}$1`);
+        // eslint-disable-next-line no-console
+        console.log(`    gh secret set ${shard.secretName} < ${shardPath}`);
+      });
+      // eslint-disable-next-line no-console
+      console.log("");
+    }
+  } else {
+    // eslint-disable-next-line no-console
+    console.log("GitHub secrets (login state only — does not update QUALTY_API_TOKEN or org/project):");
+    // eslint-disable-next-line no-console
+    console.log("");
+    for (const shard of authShards) {
+      // eslint-disable-next-line no-console
+      console.log("---");
+      // eslint-disable-next-line no-console
+      console.log(`Name:  ${shard.secretName}`);
+      if (skipPayloadPrint) {
+        // eslint-disable-next-line no-console
+        console.log(
+          `Value: (see file above${copyToClipboardFlag && shard.secretName === AUTH_SECRET_PRIMARY ? " or clipboard" : ""})`
+        );
+      } else {
+        // eslint-disable-next-line no-console
+        console.log("Value:");
+        // eslint-disable-next-line no-console
+        console.log(shard.payload);
+      }
+    }
+    // eslint-disable-next-line no-console
+    console.log("---");
+    // eslint-disable-next-line no-console
+    console.log("");
+    // eslint-disable-next-line no-console
+    console.log(
+      "Re-run with --set-github from this repo's git root to push via gh (after qualty ci setup for first-time CI)."
     );
+    // eslint-disable-next-line no-console
+    console.log("");
+  }
+  if (copyToClipboardFlag) {
+    if (copyToClipboard(primaryShard.payload)) {
+      // eslint-disable-next-line no-console
+      console.log(`✓ Copied ${AUTH_SECRET_PRIMARY} to clipboard.`);
+    } else {
+      // eslint-disable-next-line no-console
+      console.log("Could not copy to clipboard on this machine.");
+    }
+    // eslint-disable-next-line no-console
+    console.log("");
+  }
+  for (const entry of profileEntries) {
+    // eslint-disable-next-line no-console
+    console.log(`Profile "${entry.name}" → ${entry.statePath}`);
   }
+  if (configPath) {
+    // eslint-disable-next-line no-console
+    console.log(`Config: ${configPath}`);
+  }
+  // eslint-disable-next-line no-console
+  console.log("");
+  // eslint-disable-next-line no-console
+  console.log(
+    "When login expires, re-run qualty auth setup then qualty auth export --set-github (or qualty ci setup for a full refresh)."
+  );
+  // eslint-disable-next-line no-console
+  console.log("");
+}
+
+async function runCiSetup(args) {
+  const {
+    orgId,
+    projectId,
+    profile,
+    apiUrl,
+    configPath,
+    allProfiles,
+    profilesList,
+    suiteId: configSuiteId,
+    explicitIds,
+  } = resolveCiSetupConfig(args);
+  const token = resolveToken(args);
 
+  const profileEntries = await resolveCiSetupProfileEntries({
+    orgId,
+    projectId,
+    profile,
+    allProfiles,
+    profilesList,
+    suiteId: configSuiteId,
+    explicitIds,
+    apiUrl,
+    token,
+  });
+  const profileNames = profileEntries.map((entry) => entry.name);
+  const primaryProfile = profile || profileNames[0] || "";
+
+  const manifest = buildAuthBundleManifest({ orgId, projectId, profileEntries });
+  const authShards = shardAuthBundleManifest(manifest);
+  const primaryShard = authShards[0];
+
+  const setGithubFlag =
+    parseBoolean(args["set-github"], false) || parseBoolean(args["set-secret"], false);
   const noFile = parseBoolean(args["no-file"], false);
   const outputPath = noFile
     ? String(args.output || "").trim()
-    : String(args.output || "").trim() || authExportCiOutputPath(statePath);
+    : String(args.output || "").trim() ||
+      ciSetupAuthBundleOutputPath(
+        localAuthStatePath({ orgId, projectId, profile: profileEntries[0].localProfileName })
+      );
   const copyToClipboardFlag = parseBoolean(args.copy, false);
   const githubRepo = String(args.repo || "").trim();
-  const suiteId = String(args["suite-id"] || args.suite || "").trim();
+  const suiteId = String(args["suite-id"] || args.suite || configSuiteId || "").trim();
   const cliRepo = String(args["cli-repo"] || "").trim();
   const cliRef = String(args["cli-ref"] || "").trim();
 
   if (outputPath) {
-    writeFileSync(outputPath, encoded.payload, "utf8");
+    writeFileSync(outputPath, primaryShard.payload, "utf8");
     try {
       chmodSync(outputPath, 0o600);
     } catch {
       // ignore platforms that do not support chmod
     }
+    for (let index = 1; index < authShards.length; index += 1) {
+      const shard = authShards[index];
+      const shardPath = outputPath.replace(/(\.[^./]+)?$/, `_${index + 1}$1`);
+      writeFileSync(shardPath, shard.payload, "utf8");
+      try {
+        chmodSync(shardPath, 0o600);
+      } catch {
+        // ignore
+      }
+    }
   }
 
   const includeToken = parseBoolean(args["include-token"], false);
-  const profileSeg = safePathSegment(profile, "default");
   const skipPayloadPrint = Boolean(outputPath || copyToClipboardFlag || setGithubFlag);
+  const totalSecretBytes = authShards.reduce(
+    (sum, shard) => sum + Buffer.byteLength(shard.payload, "utf8"),
+    0
+  );
 
   // eslint-disable-next-line no-console
   console.log("");
@@ -936,20 +1418,29 @@ async function runAuthExportCi(args) {
   console.log("=== Qualty → GitHub Actions (secrets & variables) ===");
   // eslint-disable-next-line no-console
   console.log("");
-  if (encoded.encoding === "gzip+base64") {
-    // eslint-disable-next-line no-console
-    console.log(`Auth state: gzip+base64 (${encoded.rawBytes} bytes raw → ${secretBytes} bytes secret)`);
-  } else {
+  // eslint-disable-next-line no-console
+  console.log(
+    `Auth bundle: ${profileNames.length} profile(s), ${authShards.length} secret shard(s), ${totalSecretBytes} bytes total`
+  );
+  for (const shard of authShards) {
     // eslint-disable-next-line no-console
-    console.log(`Auth state: base64 (${encoded.rawBytes} bytes raw → ${secretBytes} bytes secret)`);
+    console.log(
+      `  - ${shard.secretName}: ${shard.profileNames.join(", ")} (${Buffer.byteLength(shard.payload, "utf8")} bytes)`
+    );
   }
   // eslint-disable-next-line no-console
   console.log("");
   if (outputPath) {
     // eslint-disable-next-line no-console
-    console.log(`Wrote QUALTY_AUTH_STATE_B64 to ${outputPath}`);
+    console.log(`Wrote ${AUTH_SECRET_PRIMARY} to ${outputPath}`);
+    for (let index = 1; index < authShards.length; index += 1) {
+      const shard = authShards[index];
+      const shardPath = outputPath.replace(/(\.[^./]+)?$/, `_${index + 1}$1`);
+      // eslint-disable-next-line no-console
+      console.log(`Wrote ${shard.secretName} to ${shardPath}`);
+    }
     // eslint-disable-next-line no-console
-    console.log(`  gh secret set QUALTY_AUTH_STATE_B64 < ${outputPath}`);
+    console.log(`  gh secret set ${AUTH_SECRET_PRIMARY} < ${outputPath}`);
     // eslint-disable-next-line no-console
     console.log("");
   }
@@ -958,8 +1449,9 @@ async function runAuthExportCi(args) {
       repo: githubRepo,
       orgId,
       projectId,
-      profile,
-      authPayload: encoded.payload,
+      profile: primaryProfile,
+      profileNames,
+      authShards,
       apiUrl,
       token,
       suiteId,
@@ -967,25 +1459,27 @@ async function runAuthExportCi(args) {
       cliRef,
     });
     printGithubSyncResults(syncResults, { repo: githubRepo });
-    const authRow = syncResults.find((r) => r.name === "QUALTY_AUTH_STATE_B64");
-    if (!authRow?.ok && outputPath) {
+    const failedAuth = syncResults.filter((row) => row.kind === "secret" && !row.ok);
+    if (failedAuth.length > 0 && outputPath) {
       // eslint-disable-next-line no-console
-      console.log(`  Manual auth secret: gh secret set QUALTY_AUTH_STATE_B64 < ${outputPath}`);
+      console.log("  Manual auth secrets:");
+      authShards.forEach((shard, index) => {
+        const shardPath =
+          index === 0 ? outputPath : outputPath.replace(/(\.[^./]+)?$/, `_${index + 1}$1`);
+        // eslint-disable-next-line no-console
+        console.log(`    gh secret set ${shard.secretName} < ${shardPath}`);
+      });
       // eslint-disable-next-line no-console
       console.log("");
     }
   }
   if (copyToClipboardFlag) {
-    if (copyToClipboard(encoded.payload)) {
+    if (copyToClipboard(primaryShard.payload)) {
       // eslint-disable-next-line no-console
-      console.log("✓ Copied QUALTY_AUTH_STATE_B64 to clipboard. Paste into GitHub → Settings → Secrets.");
+      console.log(`✓ Copied ${AUTH_SECRET_PRIMARY} to clipboard.`);
     } else {
       // eslint-disable-next-line no-console
       console.log("Could not copy to clipboard on this machine.");
-      if (outputPath) {
-        // eslint-disable-next-line no-console
-        console.log(`  Use the file instead: ${outputPath}`);
-      }
     }
     // eslint-disable-next-line no-console
     console.log("");
@@ -995,10 +1489,16 @@ async function runAuthExportCi(args) {
     console.log(
       "1. GitHub Actions config was pushed via gh (secrets + repository variables — see sync above). Fix any ✗ manually."
     );
-    if (!suiteId) {
+    if (!suiteId && !configSuiteId && explicitIds.length === 0) {
       // eslint-disable-next-line no-console
       console.log(
-        "   Tip: hardcode --suite-id or --ids in your workflow (see templates/github-actions/qualty-local-pr.yml)."
+        "   Tip: pass --suite-id or --ids to bundle only login profiles required by those tests."
+      );
+    }
+    if (authShards.length > 1) {
+      // eslint-disable-next-line no-console
+      console.log(
+        `   Auth was split across ${authShards.length} secrets. Add optional shard env vars to your workflow restore step.`
       );
     }
     // eslint-disable-next-line no-console
@@ -1033,13 +1533,35 @@ async function runAuthExportCi(args) {
     // eslint-disable-next-line no-console
     console.log("---");
     // eslint-disable-next-line no-console
-    console.log("Name:  QUALTY_AUTH_PROFILE");
+    console.log(`Name:  ${AUTH_PROFILES_VARIABLE}`);
     // eslint-disable-next-line no-console
     console.log("Value:");
     // eslint-disable-next-line no-console
-    console.log(profile);
+    console.log(profileNames.join(","));
     // eslint-disable-next-line no-console
-    console.log(`  gh variable set QUALTY_AUTH_PROFILE --body "${profile}"`);
+    console.log(`  gh variable set ${AUTH_PROFILES_VARIABLE} --body "${profileNames.join(",")}"`);
+    if (primaryProfile) {
+      // eslint-disable-next-line no-console
+      console.log("---");
+      // eslint-disable-next-line no-console
+      console.log("Name:  QUALTY_AUTH_PROFILE");
+      // eslint-disable-next-line no-console
+      console.log("Value:");
+      // eslint-disable-next-line no-console
+      console.log(primaryProfile);
+      // eslint-disable-next-line no-console
+      console.log(`  gh variable set QUALTY_AUTH_PROFILE --body "${primaryProfile}"`);
+    }
+    if (authShards.length > 1) {
+      // eslint-disable-next-line no-console
+      console.log("---");
+      // eslint-disable-next-line no-console
+      console.log(`Name:  ${AUTH_SHARDS_VARIABLE}`);
+      // eslint-disable-next-line no-console
+      console.log("Value:");
+      // eslint-disable-next-line no-console
+      console.log(String(authShards.length));
+    }
     // eslint-disable-next-line no-console
     console.log("---");
     // eslint-disable-next-line no-console
@@ -1080,20 +1602,20 @@ async function runAuthExportCi(args) {
       // eslint-disable-next-line no-console
       console.log("(create in Qualty → Account → API tokens; must start with qlty_ci_)");
     }
-    // eslint-disable-next-line no-console
-    console.log("---");
-    // eslint-disable-next-line no-console
-    console.log("Name:  QUALTY_AUTH_STATE_B64");
-    if (skipPayloadPrint) {
+    for (const shard of authShards) {
       // eslint-disable-next-line no-console
-      console.log(
-        `Value: (see file above${copyToClipboardFlag ? " or clipboard" : ""})`
-      );
-    } else {
+      console.log("---");
       // eslint-disable-next-line no-console
-      console.log("Value:");
-      // eslint-disable-next-line no-console
-      console.log(encoded.payload);
+      console.log(`Name:  ${shard.secretName}`);
+      if (skipPayloadPrint) {
+        // eslint-disable-next-line no-console
+        console.log(`Value: (see file above${copyToClipboardFlag && shard.secretName === AUTH_SECRET_PRIMARY ? " or clipboard" : ""})`);
+      } else {
+        // eslint-disable-next-line no-console
+        console.log("Value:");
+        // eslint-disable-next-line no-console
+        console.log(shard.payload);
+      }
     }
     // eslint-disable-next-line no-console
     console.log("---");
@@ -1107,17 +1629,26 @@ async function runAuthExportCi(args) {
   // eslint-disable-next-line no-console
   console.log("");
   // eslint-disable-next-line no-console
-  console.log(githubAuthRestoreShell({ orgId, projectId, profile }));
+  console.log(githubAuthRestoreShell({ shardCount: authShards.length }));
   // eslint-disable-next-line no-console
   console.log("");
-  // eslint-disable-next-line no-console
-  console.log(`Local file: ${statePath}`);
-  // eslint-disable-next-line no-console
-  console.log(`Profile flag: --auth-profile "${profile}" (file on disk: ${profileSeg}.json)`);
+  for (const entry of profileEntries) {
+    // eslint-disable-next-line no-console
+    console.log(`Profile "${entry.name}" → ${entry.statePath}`);
+  }
+  if (profileNames.length === 1) {
+    // eslint-disable-next-line no-console
+    console.log(`Optional override: --auth-profile "${profileNames[0]}"`);
+  } else {
+    // eslint-disable-next-line no-console
+    console.log("Omit --auth-profile in CI so each test uses its dashboard saved login profile.");
+  }
   // eslint-disable-next-line no-console
   console.log("");
   // eslint-disable-next-line no-console
-  console.log("When login expires, re-run qualty auth setup and qualty auth export-ci to refresh the secret.");
+  console.log(
+    "When login expires, re-run qualty auth setup and qualty auth export --set-github (or qualty ci setup --set-github for a full refresh)."
+  );
   // eslint-disable-next-line no-console
   console.log("");
 }
@@ -1605,8 +2136,20 @@ async function runCi(args) {
 async function resolveSavedJobs({ apiUrl, token, orgId, projectId, suiteId, explicitIds }) {
   const query = new URLSearchParams();
   if (projectId) query.set("project_id", String(projectId));
-  if (suiteId) query.set("suite_id", String(suiteId));
-  if (explicitIds.length > 0) query.set("ids", explicitIds.join(","));
+
+  let effectiveSuiteId = suiteId;
+  let ids = [...explicitIds];
+  // Suite M2M jobs exclude sequence members; expand so ci setup and profile resolution see all tests.
+  if (suiteId && ids.length === 0) {
+    const suiteJobIds = await collectSuiteJobIds({ apiUrl, token, orgId, suiteId });
+    if (suiteJobIds.length > 0) {
+      ids = suiteJobIds;
+      effectiveSuiteId = "";
+    }
+  }
+
+  if (effectiveSuiteId) query.set("suite_id", String(effectiveSuiteId));
+  if (ids.length > 0) query.set("ids", ids.join(","));
   return apiRequest({
     apiUrl,
     token,
@@ -1696,6 +2239,20 @@ async function resolveLocalSuitePlan({ apiUrl, token, orgId, suiteId }) {
   };
 }
 
+async function collectSuiteJobIds({ apiUrl, token, orgId, suiteId }) {
+  const plan = await resolveLocalSuitePlan({ apiUrl, token, orgId, suiteId });
+  const ids = new Set(plan.standaloneJobIds || []);
+  for (const sequence of plan.sequences || []) {
+    for (const stage of sequence.stages || []) {
+      for (const job of stage.jobs || []) {
+        const jobId = String(job.id || "").trim();
+        if (jobId) ids.add(jobId);
+      }
+    }
+  }
+  return [...ids];
+}
+
 async function runLocalSuiteWithSequences({
   apiUrl,
   token,
@@ -1975,8 +2532,7 @@ async function maybePromptProjectIdForLocalRun({ args, apiUrl, token, orgId }) {
 
 function resolveLocalAuthStateForRun({ args, orgId, projectId }) {
   if (parseBoolean(args["no-auth-state"], false)) return null;
-  const projectCfg = readProjectConfig();
-  const profile = authProfileFromConfig(projectCfg, args["auth-profile"]);
+  const profile = explicitAuthProfileFromArgs(args);
   if (!profile) return null;
   const path = localAuthStatePath({ orgId, projectId, profile });
   const summary = summarizeStorageStateFile(path);
@@ -1990,12 +2546,10 @@ function resolveLocalAuthStateForRun({ args, orgId, projectId }) {
 
 async function maybePromptAuthProfileForLocalRun({ args, orgId, projectId }) {
   const projectCfg = readProjectConfig();
-  const requestedProfile = authProfileFromConfig(projectCfg, args["auth-profile"]);
+  const requestedProfile = explicitAuthProfileFromArgs(args);
   if (requestedProfile) return { authProfile: requestedProfile, noAuthState: false };
   if (parseBoolean(args["no-auth-state"], false)) return { authProfile: "", noAuthState: true };
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    const defaultProfile = authProfileFromConfig(projectCfg);
-    if (defaultProfile) return { authProfile: defaultProfile, noAuthState: false };
     return { authProfile: "", noAuthState: false };
   }
   if (!projectId) return { authProfile: "", noAuthState: false };
@@ -2230,8 +2784,8 @@ async function runAuthSetup(args) {
     console.log("");
     // eslint-disable-next-line no-console
     console.log(
-      `[qualty][auth] For GitHub Actions secrets, run:\n` +
-        `  qualty auth export-ci --project ${project.id} --profile "${profile}"`
+      `[qualty][auth] Push this profile to GitHub Actions:\n` +
+        `  qualty auth export --project ${project.id} --profile "${profile}" --set-github`
     );
   } finally {
     rl.close();
@@ -2253,17 +2807,29 @@ async function main() {
     await runSetup(args);
     return;
   }
+  if (command === "ci") {
+    const sub = args._[1];
+    if (sub === "setup") {
+      await runCiSetup(args);
+      return;
+    }
+    throw new Error("Unknown ci subcommand. Use: qualty ci setup");
+  }
   if (command === "auth") {
     const sub = args._[1];
     if (sub === "setup") {
       await runAuthSetup(args);
       return;
     }
-    if (sub === "export-ci") {
-      await runAuthExportCi(args);
+    if (sub === "export") {
+      await runAuthExport(args);
+      return;
+    }
+    if (sub === "restore-ci") {
+      await runAuthRestoreCi(args);
       return;
     }
-    throw new Error("Unknown auth subcommand. Use: qualty auth setup | qualty auth export-ci");
+    throw new Error("Unknown auth subcommand. Use: qualty auth setup | qualty auth export | qualty auth restore-ci");
   }
   if (command === "run") {
     if (parseBoolean(args.local, false)) {
@@ -2296,7 +2862,7 @@ async function main() {
             projectId,
           })
         : {
-            authProfile: String(args["auth-profile"] || "").trim(),
+            authProfile: explicitAuthProfileFromArgs(args),
             noAuthState: parseBoolean(args["no-auth-state"], false),
           };
       const localAuthArgs = {
@@ -2319,9 +2885,9 @@ async function main() {
         device: args.device ? String(args.device).trim() : undefined,
         headless: !parseBoolean(args.headed, false),
         localConcurrency: resolveLocalConcurrency(args),
-        authProfile: localAuth?.profile || authChoice.authProfile || "",
+        authProfile: authChoice.authProfile || "",
         noAuthState: Boolean(authChoice.noAuthState || parseBoolean(args["no-auth-state"], false)),
-        storageStatePath: localAuth?.path,
+        storageStatePath: authChoice.authProfile ? localAuth?.path : undefined,
       };
       if (suiteId && explicitIds.length === 0) {
         await runLocalSuiteWithSequences(localRunArgs);