qualty 0.1.22 → 0.1.26

package/bin/auth-ci-bundle.js

@@ -0,0 +1,348 @@
+import { gunzipSync, gzipSync } from "node:zlib";
+import { mkdirSync, readFileSync, writeFileSync, chmodSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export const AUTH_BUNDLE_VERSION = 2;
+export const GITHUB_SECRET_MAX_BYTES = 64 * 1024;
+export const GITHUB_SECRET_SAFE_BYTES = GITHUB_SECRET_MAX_BYTES - 1024;
+export const AUTH_SECRET_PRIMARY = "QUALTY_AUTH_STATE_B64";
+export const AUTH_SHARDS_VARIABLE = "QUALTY_AUTH_SHARDS";
+export const AUTH_PROFILES_VARIABLE = "QUALTY_AUTH_PROFILES";
+export const MAX_AUTH_SHARDS = 10;
+
+const QUALTY_SHARED_CREDS_DIR = join(homedir(), ".qualty");
+
+export function safePathSegment(value, fallback = "default") {
+  const out = String(value || "")
+    .trim()
+    .replace(/[^a-zA-Z0-9._-]+/g, "_")
+    .replace(/^_+|_+$/g, "");
+  return out || fallback;
+}
+
+export function localAuthStatePath({ orgId, projectId, profile }) {
+  const orgSeg = safePathSegment(orgId || "default-org", "default-org");
+  const projectSeg = safePathSegment(projectId || "default-project", "default-project");
+  const profileSeg = safePathSegment(profile || "default", "default");
+  return join(QUALTY_SHARED_CREDS_DIR, "local-contexts", orgSeg, projectSeg, `${profileSeg}.json`);
+}
+
+export function authShardSecretName(shardIndex) {
+  const index = Number(shardIndex);
+  if (!Number.isInteger(index) || index < 1) {
+    throw new Error(`Invalid auth shard index: ${shardIndex}`);
+  }
+  return index === 1 ? AUTH_SECRET_PRIMARY : `${AUTH_SECRET_PRIMARY}_${index}`;
+}
+
+export function loadStorageStateFromPath(statePath) {
+  const raw = readFileSync(statePath, "utf8");
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`Invalid auth JSON at ${statePath}: ${err.message}`);
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`Invalid auth JSON at ${statePath}: expected an object`);
+  }
+  return parsed;
+}
+
+export function buildAuthBundleManifest({ orgId, projectId, profileEntries }) {
+  const profiles = {};
+  for (const entry of profileEntries) {
+    const name = String(entry.name || "").trim();
+    if (!name) continue;
+    const localProfileName =
+      String(entry.localProfileName || entry.local_profile_name || name).trim() || name;
+    const state =
+      entry.state && typeof entry.state === "object"
+        ? entry.state
+        : loadStorageStateFromPath(entry.statePath);
+    profiles[name] = {
+      local_profile_name: localProfileName,
+      state,
+    };
+  }
+  if (Object.keys(profiles).length === 0) {
+    throw new Error("No auth profiles to export.");
+  }
+  return {
+    version: AUTH_BUNDLE_VERSION,
+    org_id: String(orgId || "").trim(),
+    project_id: String(projectId || "").trim(),
+    profiles,
+  };
+}
+
+export function encodeAuthBundleManifest(manifest) {
+  const raw = Buffer.from(JSON.stringify(manifest), "utf8");
+  return {
+    encoding: "gzip+base64",
+    payload: gzipSync(raw).toString("base64"),
+    rawBytes: raw.length,
+  };
+}
+
+function isPlaywrightStorageState(value) {
+  return (
+    value &&
+    typeof value === "object" &&
+    !Array.isArray(value) &&
+    (Array.isArray(value.cookies) || Array.isArray(value.origins))
+  );
+}
+
+export function decodeAuthPayload(payloadB64) {
+  const trimmed = String(payloadB64 || "").trim();
+  if (!trimmed) {
+    throw new Error("Empty auth payload.");
+  }
+  let decoded;
+  try {
+    decoded = Buffer.from(trimmed, "base64");
+  } catch (err) {
+    throw new Error(`Invalid base64 auth payload: ${err.message}`);
+  }
+
+  let jsonText;
+  try {
+    jsonText = gunzipSync(decoded).toString("utf8");
+  } catch {
+    jsonText = decoded.toString("utf8");
+  }
+
+  let parsed;
+  try {
+    parsed = JSON.parse(jsonText);
+  } catch (err) {
+    throw new Error(`Auth payload is not valid JSON: ${err.message}`);
+  }
+
+  if (parsed?.version === AUTH_BUNDLE_VERSION && parsed?.profiles && typeof parsed.profiles === "object") {
+    return { format: "bundle", manifest: parsed };
+  }
+  if (isPlaywrightStorageState(parsed)) {
+    return { format: "legacy-single", state: parsed };
+  }
+  throw new Error("Unrecognized auth payload format.");
+}
+
+function manifestSubset(manifest, profileNames) {
+  const profiles = {};
+  for (const name of profileNames) {
+    if (manifest.profiles?.[name]) {
+      profiles[name] = manifest.profiles[name];
+    }
+  }
+  return {
+    version: AUTH_BUNDLE_VERSION,
+    org_id: manifest.org_id,
+    project_id: manifest.project_id,
+    profiles,
+  };
+}
+
+export function shardAuthBundleManifest(manifest) {
+  const profileNames = Object.keys(manifest.profiles || {});
+  if (profileNames.length === 0) {
+    throw new Error("Auth bundle has no profiles.");
+  }
+
+  const singles = profileNames.map((name) => {
+    const encoded = encodeAuthBundleManifest(manifestSubset(manifest, [name]));
+    return { name, encoded, bytes: Buffer.byteLength(encoded.payload, "utf8") };
+  });
+
+  const allEncoded = encodeAuthBundleManifest(manifest);
+  if (Buffer.byteLength(allEncoded.payload, "utf8") <= GITHUB_SECRET_SAFE_BYTES) {
+    return [
+      {
+        secretName: AUTH_SECRET_PRIMARY,
+        payload: allEncoded.payload,
+        encoding: allEncoded.encoding,
+        rawBytes: allEncoded.rawBytes,
+        profileNames,
+      },
+    ];
+  }
+
+  const shards = [];
+  let currentNames = [];
+  let currentBytes = 0;
+
+  const flush = () => {
+    if (currentNames.length === 0) return;
+    const encoded = encodeAuthBundleManifest(manifestSubset(manifest, currentNames));
+    const bytes = Buffer.byteLength(encoded.payload, "utf8");
+    if (bytes > GITHUB_SECRET_SAFE_BYTES) {
+      throw new Error(
+        `Profile "${currentNames.join(", ")}" is too large for a GitHub secret on its own ` +
+          `(${bytes} bytes; limit ~${GITHUB_SECRET_SAFE_BYTES}). Try a shorter-lived session.`
+      );
+    }
+    shards.push({
+      secretName: authShardSecretName(shards.length + 1),
+      payload: encoded.payload,
+      encoding: encoded.encoding,
+      rawBytes: encoded.rawBytes,
+      profileNames: [...currentNames],
+    });
+    currentNames = [];
+    currentBytes = 0;
+  };
+
+  for (const row of singles) {
+    if (row.bytes > GITHUB_SECRET_SAFE_BYTES) {
+      throw new Error(
+        `Profile "${row.name}" is too large for a GitHub secret (${row.bytes} bytes; limit ~${GITHUB_SECRET_SAFE_BYTES}).`
+      );
+    }
+    const nextNames = [...currentNames, row.name];
+    const nextEncoded = encodeAuthBundleManifest(manifestSubset(manifest, nextNames));
+    const nextBytes = Buffer.byteLength(nextEncoded.payload, "utf8");
+    if (nextBytes > GITHUB_SECRET_SAFE_BYTES && currentNames.length > 0) {
+      flush();
+    }
+    currentNames.push(row.name);
+    currentBytes = Buffer.byteLength(
+      encodeAuthBundleManifest(manifestSubset(manifest, currentNames)).payload,
+      "utf8"
+    );
+  }
+  flush();
+
+  if (shards.length > MAX_AUTH_SHARDS) {
+    throw new Error(
+      `Auth bundle requires ${shards.length} GitHub secrets (max ${MAX_AUTH_SHARDS}). ` +
+        "Export fewer profiles with --profiles or --suite-id / --ids."
+    );
+  }
+  return shards;
+}
+
+export function collectAuthShardPayloadsFromEnv(env = process.env) {
+  const payloads = [];
+  for (let index = 1; index <= MAX_AUTH_SHARDS; index += 1) {
+    const secretName = authShardSecretName(index);
+    const value = String(env[secretName] || "").trim();
+    if (!value) break;
+    payloads.push({ secretName, payload: value });
+  }
+  return payloads;
+}
+
+export function mergeAuthManifests(manifests) {
+  const mergedProfiles = {};
+  let orgId = "";
+  let projectId = "";
+  for (const manifest of manifests) {
+    orgId = orgId || String(manifest.org_id || "").trim();
+    projectId = projectId || String(manifest.project_id || "").trim();
+    for (const [name, entry] of Object.entries(manifest.profiles || {})) {
+      mergedProfiles[name] = entry;
+    }
+  }
+  return {
+    version: AUTH_BUNDLE_VERSION,
+    org_id: orgId,
+    project_id: projectId,
+    profiles: mergedProfiles,
+  };
+}
+
+export function restoreAuthBundleToDisk({
+  orgId,
+  projectId,
+  manifest,
+  fallbackProfile = "",
+}) {
+  const restored = [];
+  for (const [name, entry] of Object.entries(manifest.profiles || {})) {
+    const localProfileName =
+      String(entry?.local_profile_name || name).trim() || name;
+    const state = entry?.state;
+    if (!isPlaywrightStorageState(state)) {
+      throw new Error(`Profile "${name}" has invalid storage state in auth bundle.`);
+    }
+    const authFile = localAuthStatePath({
+      orgId,
+      projectId,
+      profile: localProfileName,
+    });
+    mkdirSync(join(authFile, ".."), { recursive: true });
+    writeFileSync(authFile, `${JSON.stringify(state)}\n`, "utf8");
+    try {
+      chmodSync(authFile, 0o600);
+    } catch {
+      // ignore
+    }
+    restored.push({ name, localProfileName, path: authFile });
+  }
+  return restored;
+}
+
+export function restoreLegacySingleAuthToDisk({ orgId, projectId, state, fallbackProfile }) {
+  const profile = String(fallbackProfile || "").trim();
+  if (!profile) {
+    throw new Error(
+      "Legacy single-profile auth payload requires QUALTY_AUTH_PROFILE (or --profile)."
+    );
+  }
+  const authFile = localAuthStatePath({ orgId, projectId, profile });
+  mkdirSync(join(authFile, ".."), { recursive: true });
+  writeFileSync(authFile, `${JSON.stringify(state)}\n`, "utf8");
+  try {
+    chmodSync(authFile, 0o600);
+  } catch {
+    // ignore
+  }
+  return [{ name: profile, localProfileName: profile, path: authFile }];
+}
+
+export function restoreAuthPayloadsToDisk({
+  payloads,
+  orgId,
+  projectId,
+  fallbackProfile = "",
+}) {
+  const manifests = [];
+  let legacySingle = null;
+
+  for (const row of payloads) {
+    const decoded = decodeAuthPayload(row.payload);
+    if (decoded.format === "bundle") {
+      manifests.push(decoded.manifest);
+      continue;
+    }
+    if (legacySingle) {
+      throw new Error("Multiple legacy single-profile auth payloads are not supported.");
+    }
+    legacySingle = decoded.state;
+  }
+
+  if (manifests.length > 0) {
+    const merged = mergeAuthManifests(manifests);
+    const effectiveOrgId = String(orgId || merged.org_id || "").trim();
+    const effectiveProjectId = String(projectId || merged.project_id || "").trim();
+    return restoreAuthBundleToDisk({
+      orgId: effectiveOrgId,
+      projectId: effectiveProjectId,
+      manifest: merged,
+      fallbackProfile,
+    });
+  }
+
+  if (legacySingle) {
+    return restoreLegacySingleAuthToDisk({
+      orgId,
+      projectId,
+      state: legacySingle,
+      fallbackProfile,
+    });
+  }
+
+  throw new Error("No auth payloads to restore.");
+}

package/bin/qualty.js

@@ -9,13 +9,22 @@ 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";
@@ -178,11 +187,15 @@ 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 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]",
@@ -529,12 +542,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" });
@@ -600,7 +611,8 @@ function syncGithubCiConfig({
   orgId,
   projectId,
   profile,
-  authPayload,
+  profileNames,
+  authShards,
   apiUrl,
   token,
   suiteId,
@@ -612,8 +624,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 }));
@@ -631,7 +644,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 }));
@@ -727,7 +754,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()})`;
@@ -743,12 +770,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) {
@@ -767,7 +804,7 @@ function resolveExportCiConfig(args) {
 
   if (!orgId) {
     throw new Error(
-      missingExportCiField("org ID", {
+      missingCiSetupField("org ID", {
         flag: "--org",
         configKey: "default_org_id",
         configPath,
@@ -777,7 +814,7 @@ function resolveExportCiConfig(args) {
   }
   if (!projectId) {
     throw new Error(
-      missingExportCiField("project ID", {
+      missingCiSetupField("project ID", {
         flag: "--project",
         configKey: "default_project_id",
         configPath,
@@ -785,9 +822,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,
@@ -803,43 +843,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));
+}
+
+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 encodeAuthStateForGithubSecret(statePath, { gzip = false } = {}) {
-  const raw = readFileSync(statePath);
-  if (gzip) {
-    return {
-      encoding: "gzip+base64",
-      payload: gzipSync(raw).toString("base64"),
-      rawBytes: raw.length,
-    };
+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];
+  }
+
+  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."
+    );
   }
-  return {
-    encoding: "base64",
-    payload: raw.toString("base64"),
-    rawBytes: raw.length,
-  };
+
+  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:`,
@@ -850,84 +1010,120 @@ 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)) {
-    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")
-    );
+  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 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 payloads = collectAuthShardPayloadsFromEnv(process.env);
+  if (payloads.length === 0) {
     throw new Error(
-      `Could not read auth state at ${statePath}: ${err.message}`
+      `Missing ${AUTH_SECRET_PRIMARY}. Run qualty ci setup --set-github from your app repo.`
     );
   }
-  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}`
-      );
-    }
-    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 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 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("");
@@ -935,20 +1131,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("");
   }
@@ -957,8 +1162,9 @@ async function runAuthExportCi(args) {
       repo: githubRepo,
       orgId,
       projectId,
-      profile,
-      authPayload: encoded.payload,
+      profile: primaryProfile,
+      profileNames,
+      authShards,
       apiUrl,
       token,
       suiteId,
@@ -966,25 +1172,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("");
@@ -994,10 +1202,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: 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(
-        "   Tip: hardcode --suite-id or --ids in your workflow (see templates/github-actions/qualty-local-pr.yml)."
+        `   Auth was split across ${authShards.length} secrets. Add optional shard env vars to your workflow restore step.`
       );
     }
     // eslint-disable-next-line no-console
@@ -1032,13 +1246,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
@@ -1079,20 +1315,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) {
-      // eslint-disable-next-line no-console
-      console.log(
-        `Value: (see file above${copyToClipboardFlag ? " or clipboard" : ""})`
-      );
-    } else {
+    for (const shard of authShards) {
       // eslint-disable-next-line no-console
-      console.log("Value:");
+      console.log("---");
       // 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("---");
@@ -1106,17 +1342,24 @@ 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 ci setup --set-github to refresh secrets.");
   // eslint-disable-next-line no-console
   console.log("");
 }
@@ -2230,7 +2473,7 @@ async function runAuthSetup(args) {
     // 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 ci setup --project ${project.id} --profile "${profile}"`
     );
   } finally {
     rl.close();
@@ -2252,17 +2495,25 @@ 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 === "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 restore-ci");
   }
   if (command === "run") {
     if (parseBoolean(args.local, false)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qualty",
-  "version": "0.1.22",
+  "version": "0.1.26",
   "description": "Qualty CLI for localhost and CI test runs",
   "bin": {
     "qualty": "bin/qualty.js"