@rudderhq/cli 0.4.6-canary.7 → 0.4.6-canary.9

package/dist/index.js

@@ -544,7 +544,7 @@ var init_website_icons = __esm({
       { hostnames: ["docs.google.com"], siteName: "Google Docs", iconDataUrl: googleDocsIcon },
       { hostnames: ["notion.so", "www.notion.so"], siteName: "Notion", iconDataUrl: notionIcon },
       { hostnames: ["linear.app", "linear.com"], siteName: "Linear", iconDataUrl: linearIcon },
-      { hostnames: ["openai.com"], includeSubdomains: true, siteName: "OpenAI", iconDataUrl: openaiIcon },
+      { hostnames: ["openai.com"], includeSubdomains: true, siteName: "OpenAI", iconDataUrl: openaiIcon, darkMode: "invert" },
       { hostnames: ["chatgpt.com", "chat.openai.com"], includeSubdomains: true, siteName: "ChatGPT", iconDataUrl: chatgptIcon },
       { hostnames: ["anthropic.com"], includeSubdomains: true, siteName: "Anthropic", iconDataUrl: anthropicIcon },
       { hostnames: ["claude.ai"], siteName: "Claude", iconDataUrl: claudeIcon },
@@ -1254,7 +1254,8 @@ var init_organization = __esm({
       logoAssetId: logoAssetIdSchema
     }).strict().refine((value) => value.name !== void 0 || value.description !== void 0 || value.brandColor !== void 0 || value.logoAssetId !== void 0, "At least one branding field must be provided");
     updateOrganizationWorkspaceFileSchema = z9.object({
-      content: z9.string()
+      content: z9.string(),
+      expectedContent: z9.string().optional()
     });
     createOrganizationWorkspaceFileSchema = z9.object({
       filePath: z9.string().trim().min(1).max(1e3),
@@ -7872,9 +7873,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.list",
-    command: "rudder runs list --org-id <id> [--used-skill <skill>] [--loaded-skill <skill>]",
+    command: "rudder runs list --org-id <id> [--used-skill <skill>] [--loaded-skill <skill>] [--cursor <cursor>] [--full]",
     category: "runs",
-    description: "List observed agent runs with filters for status, agent, issue, runtime, time, and skill evidence; used-skill means actual usage and loaded-skill is opt-in.",
+    description: "List lightweight run summaries with stable pagination and filters; use --full only for legacy full-row compatibility.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -7884,9 +7885,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.by-skill",
-    command: "rudder runs by-skill <skill> --org-id <id> [--evidence <used-or-loaded>]",
+    command: "rudder runs by-skill <skill> --org-id <id> [--evidence <used-or-loaded>] [--cursor <cursor>] [--full]",
     category: "runs",
-    description: "Build a skill evidence packet from recent runs; defaults to actual usage and returns status counts, agents, issues, common errors, rows, and transcript/errors follow-up commands.",
+    description: "Build a paginated skill evidence packet from lightweight run summaries; use --full only for legacy full-row compatibility.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -7908,9 +7909,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.events",
-    command: "rudder runs events <run-id>",
+    command: "rudder runs events <run-id> [--after-seq <n>] [--limit <n>]",
     category: "runs",
-    description: "List persisted run events.",
+    description: "List a bounded page of persisted run events with a sequence cursor.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -7920,9 +7921,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.log",
-    command: "rudder runs log <run-id>",
+    command: "rudder runs log <run-id> [--offset <bytes>] [--limit-bytes <n>]",
     category: "runs",
-    description: "Read stored run log content with clipped human output.",
+    description: "Read a bounded byte range of stored run log content.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -8169,7 +8170,10 @@ function mcpInputSchemaForCapability(id) {
     turnLimit: "Maximum turns to return.",
     contextTurns: "Number of context turns.",
     maxChars: "Maximum characters.",
-    snippetChars: "Maximum snippet characters."
+    snippetChars: "Maximum snippet characters.",
+    afterSeq: "Return events after this sequence number.",
+    offset: "Byte offset for ranged reads.",
+    limitBytes: "Maximum bytes for ranged reads."
   })) {
     add(key, mcpNumber(description));
   }
@@ -8182,7 +8186,7 @@ function mcpInputSchemaForCapability(id) {
   })) {
     add(key, mcpStringArray(description));
   }
-  for (const key of ["clearTitle", "clearCapabilities", "clearDescription", "clearReportsTo", "enable", "enabled", "disabled", "reopen", "planMode", "includeTranscript", "includeOutput", "includeOutputs", "notifyOnIssueCreated", "errorsOnly", "chronological", "narrative", "submit"]) {
+  for (const key of ["clearTitle", "clearCapabilities", "clearDescription", "clearReportsTo", "enable", "enabled", "disabled", "reopen", "planMode", "includeTranscript", "includeOutput", "includeOutputs", "notifyOnIssueCreated", "errorsOnly", "chronological", "narrative", "submit", "full"]) {
     add(key, mcpBoolean(`Boolean option ${key}.`));
   }
   return {
@@ -9118,7 +9122,9 @@ function cliArgsForCapability(capabilityId, input, tempFiles, env) {
       pushOptional(args, "--used-skill", input.usedSkill);
       pushOptional(args, "--loaded-skill", input.loadedSkill);
       pushOptional(args, "--created-before", input.createdBefore);
+      pushOptional(args, "--cursor", input.cursor);
       pushOptional(args, "--limit", input.limit);
+      pushBoolean(args, "--full", input.full);
       return args;
     }
     case "runs.by-skill": {
@@ -9129,16 +9135,24 @@ function cliArgsForCapability(capabilityId, input, tempFiles, env) {
       pushOptional(args, "--runtime", input.runtime);
       pushOptional(args, "--issue-id", input.issueId);
       pushOptional(args, "--created-before", input.createdBefore);
+      pushOptional(args, "--cursor", input.cursor);
       pushOptional(args, "--limit", input.limit);
+      pushBoolean(args, "--full", input.full);
       return args;
     }
     case "runs.get":
       return ["runs", "get", requiredString(input, "run")];
-    case "runs.events":
-      return ["runs", "events", requiredString(input, "run")];
+    case "runs.events": {
+      const args = ["runs", "events", requiredString(input, "run")];
+      pushOptional(args, "--after-seq", input.afterSeq);
+      pushOptional(args, "--limit", input.limit);
+      return args;
+    }
     case "runs.log": {
       const args = ["runs", "log", requiredString(input, "run")];
       pushOptional(args, "--max-chars", input.maxChars);
+      pushOptional(args, "--offset", input.offset);
+      pushOptional(args, "--limit-bytes", input.limitBytes);
       return args;
     }
     case "runs.transcript": {
@@ -14140,7 +14154,7 @@ function projectPath(projectRef, orgId) {
 function registerRunsCommands(program) {
   const runs = program.command("runs").description("Run debugging operations");
   addCommonClientOptions(
-    runs.command("list").description(getAgentCliCapabilityById("runs.list").description).option("-O, --org-id <id>", "Organization ID").option("--updated-after <iso>", "Only runs updated after this timestamp").option("--run-id-prefix <prefix>", "Filter by run ID prefix").option("--agent-id <id>", "Filter by agent ID").option("--status <status>", "Filter by run status").option("--runtime <type>", "Filter by runtime type").option("--issue-id <id>", "Filter by linked issue ID").option("--used-skill <key-or-name>", "Filter by skill actually used during the run").option("--loaded-skill <key-or-name>", "Filter by skill loaded for the run").option("--created-before <iso>", "Only runs created before this timestamp").option("--limit <n>", "Maximum rows", "200").addHelpText("after", formatExamplesAndCautions({
+    runs.command("list").description(getAgentCliCapabilityById("runs.list").description).option("-O, --org-id <id>", "Organization ID").option("--updated-after <iso>", "Only runs updated after this timestamp").option("--run-id-prefix <prefix>", "Filter by run ID prefix").option("--agent-id <id>", "Filter by agent ID").option("--status <status>", "Filter by run status").option("--runtime <type>", "Filter by runtime type").option("--issue-id <id>", "Filter by linked issue ID").option("--used-skill <key-or-name>", "Filter by skill actually used during the run").option("--loaded-skill <key-or-name>", "Filter by skill loaded for the run").option("--created-before <iso>", "Only runs created before this timestamp").option("--cursor <cursor>", "Stable summary cursor returned in page.nextCursor").option("--limit <n>", "Maximum rows; defaults to 50 summaries or 200 full rows").option("--full", "Use the legacy full-row list response for compatibility").addHelpText("after", formatExamplesAndCautions({
       examples: [
         {
           description: "Find recent failures for one agent before opening transcripts:",
@@ -14159,8 +14173,13 @@ function registerRunsCommands(program) {
       try {
         assertSingleSkillFilter(opts);
         const ctx = resolveCommandContext(opts, { requireCompany: true });
-        const rows = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${buildRunsListQuery(opts)}`) ?? [];
-        printOutput(ctx.json ? rows : rows.map(formatRunListRow), { json: ctx.json });
+        if (opts.full) {
+          const rows = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${buildRunsListQuery(opts)}`) ?? [];
+          printOutput(ctx.json ? rows : rows.map(formatRunListRow), { json: ctx.json });
+          return;
+        }
+        const page = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${buildRunsListQuery(opts)}`);
+        printOutput(ctx.json ? page : formatRunSummaryPage(page), { json: ctx.json });
       } catch (err) {
         handleCommandError(err);
       }
@@ -14168,13 +14187,19 @@ function registerRunsCommands(program) {
     { includeCompany: false }
   );
   addCommonClientOptions(
-    runs.command("by-skill").description(getAgentCliCapabilityById("runs.by-skill").description).argument("<skill>", "Skill key or display name").option("-O, --org-id <id>", "Organization ID").option("--evidence <used|loaded>", "Evidence type to match; defaults to used", "used").option("--agent-id <id>", "Filter by agent ID").option("--status <status>", "Filter by run status").option("--runtime <type>", "Filter by runtime type").option("--issue-id <id>", "Filter by linked issue ID").option("--created-before <iso>", "Only runs created before this timestamp").option("--limit <n>", "Maximum rows", "50").action(async (skill, opts) => {
+    runs.command("by-skill").description(getAgentCliCapabilityById("runs.by-skill").description).argument("<skill>", "Skill key or display name").option("-O, --org-id <id>", "Organization ID").option("--evidence <used|loaded>", "Evidence type to match; defaults to used", "used").option("--agent-id <id>", "Filter by agent ID").option("--status <status>", "Filter by run status").option("--runtime <type>", "Filter by runtime type").option("--issue-id <id>", "Filter by linked issue ID").option("--created-before <iso>", "Only runs created before this timestamp").option("--cursor <cursor>", "Stable summary cursor returned in page.nextCursor").option("--limit <n>", "Maximum rows", "50").option("--full", "Use the legacy full-row list response for compatibility").action(async (skill, opts) => {
       try {
         const evidenceType = parseSkillEvidenceType(opts.evidence);
         const ctx = resolveCommandContext(opts, { requireCompany: true });
         const params = buildRunsBySkillQuery(skill, opts, evidenceType);
-        const rows = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${params}`) ?? [];
-        const report = buildSkillRunReport(skill, evidenceType, rows);
+        if (opts.full) {
+          const rows = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${params}`) ?? [];
+          const report2 = buildSkillRunReport(skill, evidenceType, rows);
+          printOutput(ctx.json ? report2 : formatSkillRunReport(report2), { json: ctx.json });
+          return;
+        }
+        const page = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${params}`);
+        const report = buildSkillRunReport(skill, evidenceType, page?.items ?? [], page?.page);
         printOutput(ctx.json ? report : formatSkillRunReport(report), { json: ctx.json });
       } catch (err) {
         handleCommandError(err);
@@ -14194,21 +14219,33 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID or short run ID").action(async (runId, opts) => {
+    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID or short run ID").option("--after-seq <n>", "Return events after this sequence number", "0").option("--limit <n>", "Maximum events to return", "200").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
-        const rows = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/events`) ?? [];
-        printOutput(ctx.json ? rows : rows.map(formatRunEvent), { json: ctx.json });
+        const params = new URLSearchParams({
+          afterSeq: String(parseNonNegativeInteger(opts.afterSeq, 0)),
+          limit: String(parseLimit2(opts.limit, 200))
+        });
+        const page = await ctx.api.get(
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/events?${params}`
+        );
+        printOutput(ctx.json ? page : (page?.items ?? []).map(formatRunEvent), { json: ctx.json });
       } catch (err) {
         handleCommandError(err);
       }
     })
   );
   addCommonClientOptions(
-    runs.command("log").description(getAgentCliCapabilityById("runs.log").description).argument("<runId>", "Run ID or short run ID").option("--max-chars <n>", "Maximum log characters for human output", "12000").action(async (runId, opts) => {
+    runs.command("log").description(getAgentCliCapabilityById("runs.log").description).argument("<runId>", "Run ID or short run ID").option("--max-chars <n>", "Maximum log characters for human output", "12000").option("--offset <n>", "Start reading at this byte offset", "0").option("--limit-bytes <n>", "Maximum log bytes to return", "256000").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
-        const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/log`);
+        const params = new URLSearchParams({
+          offset: String(parseNonNegativeInteger(opts.offset, 0)),
+          limitBytes: String(parseLimit2(opts.limitBytes, 256e3))
+        });
+        const row = await ctx.api.get(
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/log?${params}`
+        );
         if (ctx.json) {
           printOutput(row, { json: true });
         } else {
@@ -14308,6 +14345,7 @@ function registerRunsCommands(program) {
 }
 function buildRunsListQuery(opts) {
   const params = new URLSearchParams();
+  params.set("projection", opts.full ? "full" : "summary");
   if (opts.updatedAfter) params.set("updatedAfter", opts.updatedAfter);
   if (opts.runIdPrefix) params.set("runIdPrefix", opts.runIdPrefix);
   if (opts.agentId) params.set("agentId", opts.agentId);
@@ -14317,18 +14355,21 @@ function buildRunsListQuery(opts) {
   if (opts.usedSkill) params.set("usedSkill", opts.usedSkill);
   if (opts.loadedSkill) params.set("loadedSkill", opts.loadedSkill);
   if (opts.createdBefore) params.set("createdBefore", opts.createdBefore);
-  if (opts.limit) params.set("limit", opts.limit);
+  if (!opts.full && opts.cursor) params.set("cursor", opts.cursor);
+  params.set("limit", opts.limit ?? (opts.full ? "200" : "50"));
   return params.toString();
 }
 function buildRunsBySkillQuery(skill, opts, evidenceType) {
   const params = new URLSearchParams();
+  params.set("projection", opts.full ? "full" : "summary");
   params.set(evidenceType === "used" ? "usedSkill" : "loadedSkill", skill);
   if (opts.agentId) params.set("agentId", opts.agentId);
   if (opts.status) params.set("status", opts.status);
   if (opts.runtime) params.set("runtime", opts.runtime);
   if (opts.issueId) params.set("issueId", opts.issueId);
   if (opts.createdBefore) params.set("createdBefore", opts.createdBefore);
-  if (opts.limit) params.set("limit", opts.limit);
+  if (!opts.full && opts.cursor) params.set("cursor", opts.cursor);
+  params.set("limit", opts.limit ?? "50");
   return params.toString();
 }
 function assertSingleSkillFilter(opts) {
@@ -14356,22 +14397,22 @@ function buildTranscriptQuery(opts, output) {
   return params.toString();
 }
 function formatRunListRow(row) {
-  const runId = formatCliRunId(row.run.id);
+  const runId = formatCliRunId(runIdOf(row));
   return {
     id: runId,
-    status: row.run.status,
-    agent: row.agentName ?? row.run.agentId,
-    runtime: row.bundle.agentRuntimeType,
+    status: runStatusOf(row),
+    agent: row.agentName ?? runAgentIdOf(row),
+    runtime: runRuntimeOf(row),
     issue: formatIssueRef(row.issue),
-    createdAt: row.run.createdAt,
-    finishedAt: row.run.finishedAt ?? "-",
+    createdAt: runCreatedAtOf(row),
+    finishedAt: runFinishedAtOf(row) ?? "-",
     evidence: row.skillEvidence?.evidenceType ?? "-",
     skill: row.skillEvidence?.matchedSkillKey ?? "-",
-    error: row.errorSummary ?? "-",
-    next: row.run.status === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`
+    error: runErrorOf(row) ?? "-",
+    next: runStatusOf(row) === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`
   };
 }
-function buildSkillRunReport(skill, evidenceType, rows) {
+function buildSkillRunReport(skill, evidenceType, rows, page) {
   const statusCounts = {
     succeeded: 0,
     failed: 0,
@@ -14385,7 +14426,7 @@ function buildSkillRunReport(skill, evidenceType, rows) {
   const issues = /* @__PURE__ */ new Map();
   const errors = /* @__PURE__ */ new Map();
   for (const row of rows) {
-    const status = row.run.status;
+    const status = runStatusOf(row);
     if (status === "succeeded") statusCounts.succeeded += 1;
     else if (status === "failed") statusCounts.failed += 1;
     else if (status === "cancelled") statusCounts.cancelled += 1;
@@ -14393,7 +14434,8 @@ function buildSkillRunReport(skill, evidenceType, rows) {
     else if (status === "running") statusCounts.running += 1;
     else if (status === "queued") statusCounts.queued += 1;
     else statusCounts.other += 1;
-    const agent = agents.get(row.run.agentId) ?? { id: row.run.agentId, name: row.agentName, count: 0 };
+    const agentId = runAgentIdOf(row);
+    const agent = agents.get(agentId) ?? { id: agentId, name: row.agentName, count: 0 };
     agent.count += 1;
     agents.set(agent.id, agent);
     if (row.issue) {
@@ -14401,7 +14443,7 @@ function buildSkillRunReport(skill, evidenceType, rows) {
       issue.count += 1;
       issues.set(issue.id, issue);
     }
-    const error = row.errorSummary?.trim();
+    const error = runErrorOf(row)?.trim();
     if (error) errors.set(error, (errors.get(error) ?? 0) + 1);
   }
   return {
@@ -14414,9 +14456,10 @@ function buildSkillRunReport(skill, evidenceType, rows) {
       commonErrors: [...errors.entries()].map(([summary, count]) => ({ summary, count })).sort((a, b) => b.count - a.count).slice(0, 5)
     },
     rows,
+    ...page ? { page } : {},
     nextCommands: rows.slice(0, 5).map((row) => {
-      const runId = formatCliRunId(row.run.id);
-      return row.run.status === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`;
+      const runId = formatCliRunId(runIdOf(row));
+      return runStatusOf(row) === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`;
     })
   };
 }
@@ -14434,34 +14477,68 @@ function formatSkillRunReport(report) {
     lines.push(`commonErrors=${report.summary.commonErrors.map((error) => `${clip2(error.summary, 80)}:${error.count}`).join(" | ")}`);
   }
   lines.push(...report.rows.map((row) => formatInlineSkillRun(row)));
+  if (report.page?.hasMore && report.page.nextCursor) {
+    lines.push(`more: hasMore=true nextCursor=${report.page.nextCursor}`);
+  }
   if (report.nextCommands.length > 0) {
     lines.push("next:");
     lines.push(...report.nextCommands.map((command) => `  ${command}`));
   }
   return lines;
 }
+function formatRunSummaryPage(page) {
+  const lines = (page?.items ?? []).map(formatRunListRow);
+  if (page?.page.hasMore && page.page.nextCursor) {
+    lines.push(`more: hasMore=true nextCursor=${page.page.nextCursor}`);
+  }
+  return lines;
+}
 function formatInlineSkillRun(row) {
-  const runId = formatCliRunId(row.run.id);
+  const runId = formatCliRunId(runIdOf(row));
   const issue = formatIssueRef(row.issue);
   const label = row.skillEvidence?.matchedSkillLabel && row.skillEvidence.matchedSkillLabel !== row.skillEvidence.matchedSkillKey ? ` label=${row.skillEvidence.matchedSkillLabel}` : "";
   return [
     `id=${runId}`,
-    `status=${row.run.status}`,
-    `agent=${row.agentName ?? row.run.agentId}`,
+    `status=${runStatusOf(row)}`,
+    `agent=${row.agentName ?? runAgentIdOf(row)}`,
     `issue=${issue}`,
-    `runtime=${row.bundle.agentRuntimeType}`,
-    `createdAt=${row.run.createdAt}`,
-    `finishedAt=${row.run.finishedAt ?? "-"}`,
+    `runtime=${runRuntimeOf(row)}`,
+    `createdAt=${runCreatedAtOf(row)}`,
+    `finishedAt=${runFinishedAtOf(row) ?? "-"}`,
     `evidence=${row.skillEvidence?.evidenceType ?? "-"}`,
     `skill=${row.skillEvidence?.matchedSkillKey ?? "-"}${label}`,
-    `error=${row.errorSummary ?? "-"}`,
-    `next=${row.run.status === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`}`
+    `error=${runErrorOf(row) ?? "-"}`,
+    `next=${runStatusOf(row) === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`}`
   ].join(" ");
 }
 function formatIssueRef(issue) {
   if (!issue) return "-";
   return issue.identifier && issue.title ? `${issue.identifier} ${issue.title}` : issue.identifier ?? issue.title ?? issue.id;
 }
+function isRunSummary(row) {
+  return "id" in row;
+}
+function runIdOf(row) {
+  return isRunSummary(row) ? row.id : row.run.id;
+}
+function runAgentIdOf(row) {
+  return isRunSummary(row) ? row.agentId : row.run.agentId;
+}
+function runStatusOf(row) {
+  return isRunSummary(row) ? row.status : row.run.status;
+}
+function runRuntimeOf(row) {
+  return isRunSummary(row) ? row.runtime : row.bundle.agentRuntimeType;
+}
+function runCreatedAtOf(row) {
+  return isRunSummary(row) ? row.createdAt : row.run.createdAt;
+}
+function runFinishedAtOf(row) {
+  return isRunSummary(row) ? row.finishedAt : row.run.finishedAt;
+}
+function runErrorOf(row) {
+  return isRunSummary(row) ? row.error : row.errorSummary;
+}
 function formatRunEvent(row) {
   return {
     seq: row.seq,
@@ -14502,6 +14579,11 @@ function parseLimit2(value, fallback) {
   if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
   return Math.floor(parsed);
 }
+function parseNonNegativeInteger(value, fallback) {
+  const parsed = Number(value ?? fallback);
+  if (!Number.isFinite(parsed) || parsed < 0) return fallback;
+  return Math.floor(parsed);
+}
 function clip2(value, maxChars) {
   if (value.length <= maxChars) return value;
   return `${value.slice(0, Math.max(0, maxChars - 1))}\u2026`;