refactor(web): report service ping memory/disk stats in MiB

Report the systemInfo memory and disk fields in whole MiB (binary,
1024-based units) instead of raw bytes, so the values are directly
human-readable when diagnosing resource issues (e.g. a 16Gi container
limit reads as 16384). Converts at the collection boundary via a
bytesToMiB helper and updates the mirrored docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: brendan-kellam

docs/docs/misc/service-ping.mdx

@@ -36,12 +36,12 @@ The `systemInfo` object contains a best-effort snapshot of the resources the dep
 | `cpuCores` | `integer` | Number of logical CPU cores visible to the host. |
 | `cpuQuota` | `number \| null` | Effective cgroup CPU limit in cores, or `null` if unlimited. |
 | `loadAverage1m` | `number \| null` | 1-minute load average. |
-| `totalMemoryBytes` | `integer` | Total host memory, in bytes. |
-| `freeMemoryBytes` | `integer` | Free host memory, in bytes. |
-| `memoryLimitBytes` | `integer \| null` | cgroup memory limit in bytes, or `null` if unlimited. |
-| `memoryUsedBytes` | `integer \| null` | Current cgroup memory usage, in bytes. |
-| `diskTotalBytes` | `integer \| null` | Total disk space for the data volume, in bytes. |
-| `diskFreeBytes` | `integer \| null` | Free disk space for the data volume, in bytes. |
+| `totalMemoryMiB` | `number` | Total host memory, in MiB. |
+| `freeMemoryMiB` | `number` | Free host memory, in MiB. |
+| `memoryLimitMiB` | `number \| null` | cgroup memory limit in MiB, or `null` if unlimited. |
+| `memoryUsedMiB` | `number \| null` | Current cgroup memory usage, in MiB. |
+| `diskTotalMiB` | `number \| null` | Total disk space for the data volume, in MiB. |
+| `diskFreeMiB` | `number \| null` | Free disk space for the data volume, in MiB. |
 
 
 You can fetch the schema for the Service Ping by submitting a GET request to `https://deployments.sourcebot.dev/schema`
@@ -82,12 +82,12 @@ body: {
     "cpuCores": 8,
     "cpuQuota": 4,
     "loadAverage1m": 1.24,
-    "totalMemoryBytes": 16777216000,
-    "freeMemoryBytes": 4194304000,
-    "memoryLimitBytes": 8589934592,
-    "memoryUsedBytes": 3221225472,
-    "diskTotalBytes": 107374182400,
-    "diskFreeBytes": 53687091200
+    "totalMemoryMiB": 16000,
+    "freeMemoryMiB": 4000,
+    "memoryLimitMiB": 8192,
+    "memoryUsedMiB": 3072,
+    "diskTotalMiB": 102400,
+    "diskFreeMiB": 54968
   },
   "activationCode": "sb_act_3a925f51...."
 }

packages/web/src/features/billing/systemInfo.ts

@@ -42,15 +42,21 @@ export const getSystemInfo = async (): Promise<SystemInfo> => {
         cpuQuota,
         // os.loadavg() returns [0, 0, 0] on unsupported platforms (e.g. Windows).
         loadAverage1m: os.platform() === 'win32' ? null : os.loadavg()[0],
-        totalMemoryBytes: os.totalmem(),
-        freeMemoryBytes: os.freemem(),
-        memoryLimitBytes,
-        memoryUsedBytes,
-        diskTotalBytes: disk.totalBytes,
-        diskFreeBytes: disk.freeBytes,
+        totalMemoryMiB: bytesToMiB(os.totalmem()),
+        freeMemoryMiB: bytesToMiB(os.freemem()),
+        memoryLimitMiB: memoryLimitBytes === null ? null : bytesToMiB(memoryLimitBytes),
+        memoryUsedMiB: memoryUsedBytes === null ? null : bytesToMiB(memoryUsedBytes),
+        diskTotalMiB: disk.totalBytes === null ? null : bytesToMiB(disk.totalBytes),
+        diskFreeMiB: disk.freeBytes === null ? null : bytesToMiB(disk.freeBytes),
     };
 };
 
+const BYTES_PER_MIB = 1024 * 1024;
+
+// Memory and disk are both reported in whole MiB (binary, 1024-based units),
+// matching how RAM and container/k8s volumes are sized.
+const bytesToMiB = (bytes: number): number => Math.round(bytes / BYTES_PER_MIB);
+
 const readFileTrimmed = async (path: string): Promise<string | null> => {
     try {
         const contents = await fs.readFile(path, 'utf8');

packages/web/src/features/billing/types.ts

@@ -17,17 +17,17 @@ export const systemInfoSchema = z.object({
     cpuQuota: z.number().nonnegative().nullable(),
     loadAverage1m: z.number().nonnegative().nullable(),
 
-    // Memory, in bytes. `total`/`free` are host-level (os.totalmem / os.freemem);
+    // Memory, in MiB. `total`/`free` are host-level (os.totalmem / os.freemem);
     // `limit`/`used` come from the cgroup and reflect the container's actual RAM
     // allocation and current usage (null when unset or unreadable).
-    totalMemoryBytes: z.number().nonnegative(),
-    freeMemoryBytes: z.number().nonnegative(),
-    memoryLimitBytes: z.number().nonnegative().nullable(),
-    memoryUsedBytes: z.number().nonnegative().nullable(),
-
-    // Disk, in bytes, for the DATA_CACHE_DIR volume (where repos are indexed).
-    diskTotalBytes: z.number().nonnegative().nullable(),
-    diskFreeBytes: z.number().nonnegative().nullable(),
+    totalMemoryMiB: z.number().nonnegative(),
+    freeMemoryMiB: z.number().nonnegative(),
+    memoryLimitMiB: z.number().nonnegative().nullable(),
+    memoryUsedMiB: z.number().nonnegative().nullable(),
+
+    // Disk, in MiB, for the DATA_CACHE_DIR volume (where repos are indexed).
+    diskTotalMiB: z.number().nonnegative().nullable(),
+    diskFreeMiB: z.number().nonnegative().nullable(),
 });
 export type SystemInfo = z.infer<typeof systemInfoSchema>;