fix: add 'up to N' to all spinner messages, consolidate hex-id normalization

- All withProgress messages now show '(up to N)...' matching issue list
- Extract normalizeHexId() in hex-id.ts, use in both validateHexId and
  isTraceId to eliminate duplicated normalization logic
- validateTraceId now delegates through isTraceId's normalization path

Author: BYK

src/commands/log/list.ts

@@ -764,7 +764,10 @@ export const listCommand = buildListCommand("log", {
       }
 
       const { result, hint } = await withProgress(
-        { message: "Fetching logs...", json: flags.json },
+        {
+          message: `Fetching logs (up to ${flags.limit})...`,
+          json: flags.json,
+        },
         () => executeTraceSingleFetch(org, traceId, flags)
       );
       yield new CommandOutput(result);
@@ -805,7 +808,10 @@ export const listCommand = buildListCommand("log", {
       }
 
       const { result, hint } = await withProgress(
-        { message: "Fetching logs...", json: flags.json },
+        {
+          message: `Fetching logs (up to ${flags.limit})...`,
+          json: flags.json,
+        },
         () => executeSingleFetch(org, project, flags)
       );
       yield new CommandOutput(result);

src/commands/org/list.ts

@@ -132,7 +132,10 @@ export const listCommand = buildCommand({
     applyFreshFlag(flags);
 
     const orgs = await withProgress(
-      { message: "Fetching organizations...", json: flags.json },
+      {
+        message: `Fetching organizations (up to ${flags.limit})...`,
+        json: flags.json,
+      },
       () => listOrganizationsUncached()
     );
     const limitedOrgs = orgs.slice(0, flags.limit);

src/commands/project/list.ts

@@ -335,7 +335,10 @@ export async function handleAutoDetect(
   } = await resolveOrgsForAutoDetect(cwd);
 
   const { projects: allProjects, nextCursor } = await withProgress(
-    { message: "Fetching projects...", json: flags.json },
+    {
+      message: `Fetching projects (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () => fetchAutoDetectProjects(orgsToFetch, flags)
   );
 
@@ -392,7 +395,10 @@ export async function handleExplicit(
   flags: ListFlags
 ): Promise<ListResult<ProjectWithOrg>> {
   const projectResult = await withProgress(
-    { message: "Fetching projects...", json: flags.json },
+    {
+      message: `Fetching projects (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () => withAuthGuard(() => getProject(org, projectSlug))
   );
   if (!projectResult.ok) {
@@ -442,7 +448,10 @@ export async function handleOrgAll(
 ): Promise<ListResult<ProjectWithOrg>> {
   const { org, flags, contextKey, cursor } = options;
   const response: PaginatedResponse<SentryProject[]> = await withProgress(
-    { message: "Fetching projects...", json: flags.json },
+    {
+      message: `Fetching projects (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () =>
       listProjectsPaginated(org, {
         cursor,
@@ -506,7 +515,10 @@ export async function handleProjectSearch(
   flags: ListFlags
 ): Promise<ListResult<ProjectWithOrg>> {
   const { projects } = await withProgress(
-    { message: "Fetching projects...", json: flags.json },
+    {
+      message: `Fetching projects (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () => findProjectsBySlug(projectSlug)
   );
   const filtered = filterByPlatform(projects, flags.platform);

src/commands/span/list.ts

@@ -262,7 +262,7 @@ export const listCommand = buildCommand({
 
     // Fetch spans from EAP endpoint
     const { data: spanItems, nextCursor } = await withProgress(
-      { message: "Fetching spans...", json: flags.json },
+      { message: `Fetching spans (up to ${flags.limit})...`, json: flags.json },
       () =>
         listSpans(org, project, {
           query: apiQuery,

src/commands/trace/list.ts

@@ -247,7 +247,10 @@ export const listCommand = buildListCommand("trace", {
     const cursor = resolveOrgCursor(flags.cursor, PAGINATION_KEY, contextKey);
 
     const { data: traces, nextCursor } = await withProgress(
-      { message: "Fetching traces...", json: flags.json },
+      {
+        message: `Fetching traces (up to ${flags.limit})...`,
+        json: flags.json,
+      },
       () =>
         listTransactions(org, project, {
           query: flags.query,

src/commands/trace/logs.ts

@@ -175,7 +175,10 @@ export const logsCommand = buildCommand({
     }
 
     const logs = await withProgress(
-      { message: "Fetching trace logs...", json: flags.json },
+      {
+        message: `Fetching trace logs (up to ${flags.limit})...`,
+        json: flags.json,
+      },
       () =>
         listTraceLogs(org, traceId, {
           statsPeriod: flags.period,

src/lib/hex-id.ts

@@ -24,6 +24,24 @@ export const UUID_DASH_RE =
 /** Max display length for invalid IDs in error messages before truncation */
 const MAX_DISPLAY_LENGTH = 40;
 
+/**
+ * Normalize a potential hex ID: trim, lowercase, strip UUID dashes.
+ * Does NOT validate — call this before checking {@link HEX_ID_RE}.
+ *
+ * Extracted so that both {@link validateHexId} and non-throwing predicates
+ * (like `isTraceId`) share identical normalization logic.
+ *
+ * @param value - The raw string to normalize
+ * @returns The trimmed, lowercased string with UUID dashes stripped if applicable
+ */
+export function normalizeHexId(value: string): string {
+  let trimmed = value.trim().toLowerCase();
+  if (UUID_DASH_RE.test(trimmed)) {
+    trimmed = trimmed.replace(/-/g, "");
+  }
+  return trimmed;
+}
+
 /**
  * Validate that a string is a 32-character hexadecimal ID.
  * Trims whitespace and normalizes to lowercase before validation.
@@ -44,25 +62,20 @@ const MAX_DISPLAY_LENGTH = 40;
  * @throws {ValidationError} If the format is invalid
  */
 export function validateHexId(value: string, label: string): string {
-  let trimmed = value.trim().toLowerCase();
-
-  // Auto-correct UUID format: strip dashes (8-4-4-4-12 → 32 hex chars)
-  if (UUID_DASH_RE.test(trimmed)) {
-    trimmed = trimmed.replace(/-/g, "");
-  }
+  const normalized = normalizeHexId(value);
 
-  if (!HEX_ID_RE.test(trimmed)) {
+  if (!HEX_ID_RE.test(normalized)) {
     const display =
-      trimmed.length > MAX_DISPLAY_LENGTH
-        ? `${trimmed.slice(0, MAX_DISPLAY_LENGTH - 3)}...`
-        : trimmed;
+      normalized.length > MAX_DISPLAY_LENGTH
+        ? `${normalized.slice(0, MAX_DISPLAY_LENGTH - 3)}...`
+        : normalized;
     throw new ValidationError(
       `Invalid ${label} "${display}". Expected a 32-character hexadecimal string.\n\n` +
         "Example: abc123def456abc123def456abc123de"
     );
   }
 
-  return trimmed;
+  return normalized;
 }
 
 /**

src/lib/org-list.ts

@@ -347,7 +347,10 @@ export async function handleOrgAll<TEntity, TWithOrg>(
   const { config, org, flags, contextKey, cursor } = options;
 
   const response = await withProgress(
-    { message: `Fetching ${config.entityPlural}...`, json: flags.json },
+    {
+      message: `Fetching ${config.entityPlural} (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () =>
       config.listPaginated(org, {
         cursor,
@@ -408,7 +411,10 @@ export async function handleAutoDetect<TEntity, TWithOrg>(
   } = await resolveOrgsForListing(undefined, cwd);
 
   const allItems = await withProgress(
-    { message: `Fetching ${config.entityPlural}...`, json: flags.json },
+    {
+      message: `Fetching ${config.entityPlural} (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     async () => {
       if (orgsToFetch.length > 0) {
         const results = await Promise.all(
@@ -536,7 +542,10 @@ export async function handleExplicitOrg<TEntity, TWithOrg>(
 ): Promise<ListResult<TWithOrg>> {
   const { config, org, flags, noteOrgScoped = false } = options;
   const items = await withProgress(
-    { message: `Fetching ${config.entityPlural}...`, json: flags.json },
+    {
+      message: `Fetching ${config.entityPlural} (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () => fetchOrgSafe(config, org)
   );
 
@@ -588,7 +597,10 @@ export async function handleExplicitProject<TEntity, TWithOrg>(
     );
   }
   const raw = await withProgress(
-    { message: `Fetching ${config.entityPlural}...`, json: flags.json },
+    {
+      message: `Fetching ${config.entityPlural} (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () => listForProject(org, project)
   );
   const items = raw.map((entity) => config.withOrg(entity, org));
@@ -637,7 +649,10 @@ export async function handleProjectSearch<TEntity, TWithOrg>(
 ): Promise<ListResult<TWithOrg>> {
   const { flags, orgAllFallback } = options;
   const { projects: matches, orgs } = await withProgress(
-    { message: `Fetching ${config.entityPlural}...`, json: flags.json },
+    {
+      message: `Fetching ${config.entityPlural} (up to ${flags.limit})...`,
+      json: flags.json,
+    },
     () => findProjectsBySlug(projectSlug)
   );
 

src/lib/trace-id.ts

@@ -5,7 +5,7 @@
  * Used by `trace logs`, `log list`, and `span list` commands.
  */
 
-import { HEX_ID_RE, UUID_DASH_RE, validateHexId } from "./hex-id.js";
+import { HEX_ID_RE, normalizeHexId, validateHexId } from "./hex-id.js";
 
 /**
  * Regex for a valid 32-character hexadecimal trace ID.
@@ -25,11 +25,7 @@ export const TRACE_ID_RE = HEX_ID_RE;
  * @returns `true` if the value would pass {@link validateTraceId}
  */
 export function isTraceId(value: string): boolean {
-  let trimmed = value.trim().toLowerCase();
-  if (UUID_DASH_RE.test(trimmed)) {
-    trimmed = trimmed.replace(/-/g, "");
-  }
-  return HEX_ID_RE.test(trimmed);
+  return HEX_ID_RE.test(normalizeHexId(value));
 }
 
 /**