tracksiy 0.12.0 → 0.13.0

package/README.md

@@ -147,6 +147,9 @@ Labels: `bug`, `feature`, `question`, `blocker`. `npx tracksiy support` prints t
 | `issues attachments <id>` | Screenshots, view hierarchies and files of an issue's recent events and of the feedback about it. | read | `issues_attachments` |
 | `attachments get <id>` | Save one attachment (a screenshot, a view hierarchy) to a file -- or print a JSON one. | read | `attachments_get` |
 | `issues flags <id>` | Feature flag values of an issue's events against the rest of the project; `suspect` marks a value far more common in this issue. | read | `issues_flags` |
+| `build upload <path>` | Measure an app build (APK, AAB, IPA, .xcarchive, .app) on this machine and record its size: per category, the largest files, growth against the previous build, size budgets. The binary is not uploaded. | write | `build_upload` |
+| `build list` | Recorded builds newest first, with their growth against the build before. | read | `build_list` |
+| `build view <id>` | One build: size per category, the largest files, what changed against the previous build. | read | `build_view` |
 | `issues list` | Recent issues of a project, newest activity first, with the frames that matter inlined. | read | `issues_list` |
 | `issues view <id>` | One issue in enough depth to act on: latest event, stack frames, tags, recent volume. | read | `issues_view` |
 | `issues resolve <ids...>` | Mark issues resolved, optionally fixed in a release so old clients do not reopen them. Records why. | write | `issues_resolve` |

package/dist/tracksiy.mjs

@@ -4,7 +4,7 @@
 import { readFileSync as readFileSync2 } from "node:fs";
 
 // src/version.ts
-var VERSION = true ? "0.12.0" : "0.0.0-dev";
+var VERSION = true ? "0.13.0" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -1702,6 +1702,304 @@ ${d.notes.join("\n")}` : ""}`,
 };
 var evidence_default = [feedback, issueAttachments, attachmentGet, issueFlags];
 
+// src/commands/builds.ts
+import { existsSync as existsSync2 } from "node:fs";
+import { basename as basename2 } from "node:path";
+
+// src/lib/appsize.ts
+import { readFileSync as readFileSync4, readdirSync, statSync } from "node:fs";
+import { basename, join as join2, relative, sep } from "node:path";
+import { deflateRawSync } from "node:zlib";
+var EOCD = 101010256;
+var ZIP64_LOCATOR = 117853008;
+var ZIP64_EOCD = 101075792;
+var CENTRAL = 33639248;
+function zipEntries(buf) {
+  let eocd = -1;
+  for (let i = buf.length - 22; i >= Math.max(0, buf.length - 65557); i--) {
+    if (buf.readUInt32LE(i) === EOCD) {
+      eocd = i;
+      break;
+    }
+  }
+  if (eocd < 0) throw new Error("not a ZIP archive (no end of central directory)");
+  let count = buf.readUInt16LE(eocd + 10);
+  let offset = buf.readUInt32LE(eocd + 16);
+  if (count === 65535 || offset === 4294967295) {
+    const locator = eocd - 20;
+    if (locator >= 0 && buf.readUInt32LE(locator) === ZIP64_LOCATOR) {
+      const record = Number(buf.readBigUInt64LE(locator + 8));
+      if (buf.readUInt32LE(record) === ZIP64_EOCD) {
+        count = Number(buf.readBigUInt64LE(record + 32));
+        offset = Number(buf.readBigUInt64LE(record + 48));
+      }
+    }
+  }
+  const out = [];
+  let p = offset;
+  for (let n = 0; n < count && p + 46 <= buf.length; n++) {
+    if (buf.readUInt32LE(p) !== CENTRAL) break;
+    let compressed = buf.readUInt32LE(p + 20);
+    let uncompressed = buf.readUInt32LE(p + 24);
+    const nameLen = buf.readUInt16LE(p + 28);
+    const extraLen = buf.readUInt16LE(p + 30);
+    const commentLen = buf.readUInt16LE(p + 32);
+    const name = buf.toString("utf8", p + 46, p + 46 + nameLen);
+    if (compressed === 4294967295 || uncompressed === 4294967295) {
+      let e = p + 46 + nameLen;
+      const end = e + extraLen;
+      while (e + 4 <= end) {
+        const id = buf.readUInt16LE(e);
+        const size = buf.readUInt16LE(e + 2);
+        if (id === 1) {
+          let q = e + 4;
+          if (uncompressed === 4294967295) {
+            uncompressed = Number(buf.readBigUInt64LE(q));
+            q += 8;
+          }
+          if (compressed === 4294967295) compressed = Number(buf.readBigUInt64LE(q));
+          break;
+        }
+        e += 4 + size;
+      }
+    }
+    if (!name.endsWith("/")) out.push({ path: name, download: compressed, install: uncompressed });
+    p += 46 + nameLen + extraLen + commentLen;
+  }
+  return out;
+}
+function walk(dir) {
+  const out = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join2(dir, entry.name);
+    if (entry.isDirectory()) out.push(...walk(full));
+    else if (entry.isFile()) out.push(full);
+  }
+  return out;
+}
+function dirEntries(dir) {
+  return walk(dir).map((file) => {
+    const size = statSync(file).size;
+    let download = size;
+    if (size > 0 && size <= 64 * 1024 * 1024) {
+      try {
+        download = Math.min(size, deflateRawSync(readFileSync4(file), { level: 6 }).length);
+      } catch {
+        download = size;
+      }
+    }
+    return { path: relative(dir, file).split(sep).join("/"), download, install: size };
+  });
+}
+function androidCategory(path, aab) {
+  let p = path;
+  if (aab) {
+    if (p === "BundleConfig.pb" || p.startsWith("BUNDLE-METADATA/") || p.startsWith("META-INF/")) return "bundle metadata";
+    const slash = p.indexOf("/");
+    const module = slash > 0 ? p.slice(0, slash) : "";
+    if (module && module !== "base") return `module:${module}`;
+    p = slash > 0 ? p.slice(slash + 1) : p;
+    if (p.startsWith("dex/")) return "dex";
+    if (p === "resources.pb") return "resources";
+    if (p.startsWith("manifest/")) return "manifest";
+    if (p.startsWith("root/")) p = p.slice(5);
+  }
+  if (/^classes\d*\.dex$/.test(p)) return "dex";
+  const lib = /^lib\/([^/]+)\/([^/]+)$/.exec(p);
+  if (lib) {
+    const [, abi, file] = lib;
+    if (file === "libapp.so") return `dart code (${abi})`;
+    if (file === "libflutter.so") return `flutter engine (${abi})`;
+    if (/^lib(hermes|jsc|reactnative)/.test(file)) return `js engine (${abi})`;
+    return `native (${abi})`;
+  }
+  if (p === "assets/index.android.bundle") return "js bundle";
+  if (p.startsWith("assets/flutter_assets/")) return "flutter assets";
+  if (p.startsWith("assets/")) return "assets";
+  if (p.startsWith("res/") || p === "resources.arsc") return "resources";
+  if (p.startsWith("META-INF/")) return "signing";
+  if (p.startsWith("kotlin/")) return "kotlin metadata";
+  if (p === "AndroidManifest.xml") return "manifest";
+  return "other";
+}
+function iosCategory(path, appName) {
+  if (path === appName) return "binary";
+  if (path.startsWith("Frameworks/Flutter.framework/")) return "flutter engine";
+  if (path.startsWith("Frameworks/App.framework/")) return "dart code";
+  if (path.startsWith("Frameworks/")) return "frameworks";
+  if (path.startsWith("PlugIns/") || path.startsWith("Extensions/")) return "extensions";
+  if (path.startsWith("Watch/")) return "watch app";
+  if (path.endsWith(".car")) return "asset catalog";
+  if (path === "main.jsbundle") return "js bundle";
+  if (/(^|\/)[^/]+\.lproj\//.test(path)) return "localizations";
+  if (path.startsWith("_CodeSignature/") || path === "embedded.mobileprovision") return "signing";
+  if (/\.bundle\//.test(path)) return "bundles";
+  return "resources";
+}
+function appRelative(entries) {
+  const first = entries.map((e) => /^(.*?\/)?([^/]+)\.app\//.exec(e.path)).find(Boolean);
+  if (!first) return { entries, appName: "" };
+  const prefix = (first[1] ?? "") + first[2] + ".app/";
+  return {
+    entries: entries.filter((e) => e.path.startsWith(prefix)).map((e) => ({ ...e, path: e.path.slice(prefix.length) })),
+    appName: first[2]
+  };
+}
+function analyze(path) {
+  const isDir = statSync(path).isDirectory();
+  const lower = path.toLowerCase().replace(/\/+$/, "");
+  let kind = "other";
+  if (lower.endsWith(".apk")) kind = "apk";
+  else if (lower.endsWith(".aab")) kind = "aab";
+  else if (lower.endsWith(".ipa")) kind = "ipa";
+  else if (lower.endsWith(".xcarchive")) kind = "xcarchive";
+  else if (lower.endsWith(".app")) kind = "app";
+  const platform = kind === "apk" || kind === "aab" ? "android" : kind === "other" ? "other" : "ios";
+  let entries;
+  if (isDir) {
+    const root = kind === "xcarchive" ? join2(path, "Products", "Applications") : path;
+    entries = dirEntries(root);
+    if (kind === "app") entries = entries.map((e) => ({ ...e, path: `${basename(path)}/${e.path}` }));
+  } else {
+    entries = zipEntries(readFileSync4(path));
+  }
+  let appName = "";
+  if (platform === "ios") ({ entries, appName } = appRelative(entries));
+  const categories = {};
+  let download = 0;
+  let install = 0;
+  for (const e of entries) {
+    const name = platform === "android" ? androidCategory(e.path, kind === "aab") : platform === "ios" ? iosCategory(e.path, appName) : e.path.split("/")[0] || "other";
+    const c = categories[name] ??= { download: 0, install: 0, files: 0 };
+    c.download += e.download;
+    c.install += e.install;
+    c.files += 1;
+    download += e.download;
+    install += e.install;
+  }
+  const largest = [...entries].sort((a, b) => b.download - a.download).slice(0, 50);
+  return { kind, platform, downloadBytes: download, installBytes: install, fileCount: entries.length, categories, largest };
+}
+
+// src/commands/builds.ts
+var mb2 = (n) => n === null || n === void 0 ? "-" : `${(Number(n) / 1e6).toFixed(2)} MB`;
+var signed = (n) => `${n > 0 ? "+" : ""}${(n / 1e6).toFixed(2)} MB`;
+function render(d) {
+  const c = d.comparison;
+  const head = kv({
+    release: d.release,
+    platform: `${d.platform} (${d.kind})`,
+    download: mb2(d.downloadBytes),
+    install: mb2(d.installBytes),
+    files: d.fileCount,
+    ...c ? { "vs previous": `${c.previousRelease}: download ${signed(c.downloadDelta)} (${c.downloadDeltaPct ?? "-"}%), install ${signed(c.installDelta)}` } : {},
+    ...d.verdict ? { budgets: d.verdict } : {}
+  });
+  const categories = Object.entries(d.categories ?? {}).map(([category, v]) => ({ category, ...v })).sort((a, b) => b.download - a.download).slice(0, 15);
+  const cats = categories.length ? `
+
+${table(categories, ["category", ["download", (r) => mb2(r.download)], ["install", (r) => mb2(r.install)], "files"])}` : "";
+  const deltas = c?.categories?.length ? `
+
+Changed:
+${table(c.categories, ["category", ["download \u0394", (r) => signed(r.downloadDelta)], ["install \u0394", (r) => signed(r.installDelta)]])}` : "";
+  const budgets = (d.budgets ?? []).length ? `
+
+${table(d.budgets, ["name", "metric", "max", ["value", (r) => r.value ?? "-"], "status"])}` : "";
+  return head + cats + deltas + budgets;
+}
+var upload = {
+  path: ["build", "upload"],
+  summary: "Measure an app build (APK, AAB, IPA, .xcarchive, .app) on this machine and record its size: per category, the largest files, growth against the previous build, size budgets. The binary is not uploaded.",
+  description: "Download size = the archive's compressed sizes (for an AAB an upper bound of what Play serves a device); install size = uncompressed. Categories: dex, native per ABI, resources, assets, the JS bundle and engine, Dart code and the Flutter engine, frameworks, the main binary, asset catalogs, localizations... Exits 10 when a size budget (`budgets set --budget 'name=size,metric=app_download_mb,max=40,op=android'`) is crossed, or the download grew more than --max-growth. An upload token (project:releases) is enough.",
+  context: "project",
+  effect: "write",
+  endpoint: { method: "POST", path: "/api/agent/v1/projects/{org}/{project}/builds" },
+  scopes: ["project:releases", "project:write", "project:admin"],
+  args: [{ name: "path", required: true, description: "app-release.aab, app.apk, App.ipa, App.xcarchive or App.app." }],
+  flags: {
+    release: { type: "string", value: "<version>", description: "The release as the SDK names it: shop-android@1.4.2+57. Required." },
+    commit: { type: "string", value: "<sha>", description: "The commit it was built from." },
+    "build-configuration": { type: "string", value: "<name>", description: "Release, Debug, a flavor..." },
+    "app-id": { type: "string", value: "<id>", description: "Package name / bundle id." },
+    "max-growth": { type: "number", value: "<pct>", description: "Fail (exit 10) when the download grew more than this % against the previous build." },
+    "dry-run": { type: "boolean", description: "Measure and print; record nothing." }
+  },
+  examples: [
+    { command: "tracksiy build upload app/build/outputs/bundle/release/app-release.aab --release shop-android@1.4.2+57 --max-growth 5", description: "In CI after bundleRelease: record and stop on a 5 % jump." },
+    { command: "tracksiy build upload build/Shop.xcarchive --release shop-ios@1.4.2+57 --dry-run", description: "Where the weight is, without recording." }
+  ],
+  output: "{id, release, platform, kind, downloadBytes, installBytes, fileCount, categories{...}, largest[...], comparison{previousRelease, downloadDelta, downloadDeltaPct, categories[...], newLargeFiles[...]}, budgets[...], verdict}",
+  text: render,
+  async run(ctx) {
+    const i = ctx.input;
+    if (!existsSync2(i.path)) throw usageError("not_found", `No such file or directory: ${i.path}`);
+    let size;
+    try {
+      size = analyze(i.path);
+    } catch (err) {
+      throw usageError("bad_value", `Could not read ${i.path}: ${err.message}`, "Pass an .apk, .aab, .ipa, .xcarchive or .app.");
+    }
+    const body = {
+      release: i.release,
+      platform: size.platform,
+      kind: size.kind,
+      downloadBytes: size.downloadBytes,
+      installBytes: size.installBytes,
+      fileCount: size.fileCount,
+      categories: size.categories,
+      largest: size.largest,
+      commit: i.commit ?? "",
+      buildConfiguration: i.buildConfiguration ?? "",
+      appId: i.appId ?? "",
+      artifact: basename2(String(i.path).replace(/\/+$/, ""))
+    };
+    if (i.dryRun) return { dryRun: true, ...body, largest: body.largest.slice(0, 15) };
+    if (!i.release) throw usageError("missing_flag", "--release is required to record a build.", "Name it as the SDK does: shop-android@1.4.2+57.");
+    const data = await ctx.api.send("POST", await projectPath(ctx, "builds"), body);
+    const growth = data.comparison?.downloadDeltaPct;
+    if (data.verdict === "fail") {
+      const names = (data.budgets ?? []).filter((b) => b.status === "fail").map((b) => `${b.name} ${b.value} > ${b.max}`).join(", ");
+      throw new CheckFailed(`Size budget crossed: ${names}.`, data, "See `build view <id>` for what grew.");
+    }
+    if (i.maxGrowth !== void 0 && growth !== null && growth !== void 0 && growth > i.maxGrowth) {
+      throw new CheckFailed(`Download grew ${growth}% against ${data.comparison.previousRelease} (max ${i.maxGrowth}%).`, data, "See the `Changed` categories and `comparison.newLargeFiles`.");
+    }
+    return data;
+  }
+};
+var list2 = {
+  path: ["build", "list"],
+  aliases: [["builds"]],
+  summary: "Recorded builds newest first, with their growth against the build before.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/builds" },
+  flags: {
+    platform: { type: "string", enum: ["android", "ios", "other"], description: "Only this platform." },
+    limit: { type: "integer", value: "<n>", description: "At most 100 (default 20)." }
+  },
+  output: "[{id, created, release, platform, kind, downloadBytes, installBytes, comparison{...}}]",
+  text: (d) => table(d ?? [], ["id", ["when", (r) => ago(r.created)], "release", "platform", ["download", (r) => mb2(r.downloadBytes)], ["\u0394", (r) => r.comparison ? signed(r.comparison.downloadDelta) : "-"], ["install", (r) => mb2(r.installBytes)]]),
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, "builds"), { platform: ctx.input.platform, limit: ctx.input.limit });
+  }
+};
+var view = {
+  path: ["build", "view"],
+  summary: "One build: size per category, the largest files, what changed against the previous build.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/builds/{id}" },
+  args: [{ name: "id", required: true, description: "The build id (from `build list`)." }],
+  output: "{id, release, categories{...}, largest[...], comparison{...}}",
+  text: render,
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, `builds/${encodeURIComponent(ctx.input.id)}`));
+  }
+};
+var builds_default = [upload, list2, view];
+
 // src/commands/issues.ts
 import { writeFileSync as writeFileSync2 } from "node:fs";
 var FILTERS = {
@@ -1759,7 +2057,7 @@ var issueRows = (issues) => table(issues ?? [], [
   ["status", (r) => r.regressedAt && r.status === "unresolved" ? "regressed" : r.status],
   ["title", (r) => r.title]
 ]);
-var list2 = {
+var list3 = {
   path: ["issues", "list"],
   aliases: [["issues"]],
   summary: "Recent issues of a project, newest activity first, with the frames that matter inlined.",
@@ -1799,7 +2097,7 @@ ${issueRows(d.issues)}`,
     });
   }
 };
-var view = {
+var view2 = {
   path: ["issues", "view"],
   summary: "One issue in enough depth to act on: latest event, stack frames, tags, recent volume.",
   context: "project",
@@ -2059,7 +2357,7 @@ var bulk = {
     return result;
   }
 };
-var issues_default = [list2, view, resolve2, ignore, unresolve, bulk, merge, comment, activity, verifyFixed, claim, unclaim];
+var issues_default = [list3, view2, resolve2, ignore, unresolve, bulk, merge, comment, activity, verifyFixed, claim, unclaim];
 
 // src/commands/projects.ts
 var create = {
@@ -2174,8 +2472,8 @@ var DECLARE = {
   "replace-recipients": { type: "boolean", description: "Make the recipient list exactly this one (default: add to it)." },
   body: { type: "json", value: "<json|@file|->", description: "Raw request body; overrides the other flags." }
 };
-function recipients(list6, delivery) {
-  return (list6 ?? []).map((raw) => {
+function recipients(list7, delivery) {
+  return (list7 ?? []).map((raw) => {
     const i = raw.indexOf(":");
     const type = i > 0 ? raw.slice(0, i) : raw;
     if (!RECIPIENT_TYPES.includes(type)) {
@@ -2356,7 +2654,7 @@ var settingsSet2 = {
 var alerts_default = [get, set, test, coverage, defaults, settingsGet2, settingsSet2];
 
 // src/commands/keys.ts
-var list3 = {
+var list4 = {
   path: ["keys", "list"],
   aliases: [["keys"]],
   summary: "Every ingest key of the project: its surface, whether ingest accepts it, its rate limit and volume.",
@@ -2413,11 +2711,11 @@ var rotate = {
     return ctx.api.send("POST", await projectPath(ctx, `keys/${seg(ctx.input.name)}/rotate`));
   }
 };
-var keys_default = [list3, set2, rotate];
+var keys_default = [list4, set2, rotate];
 
 // src/commands/releases.ts
 import { execFileSync } from "node:child_process";
-var list4 = {
+var list5 = {
   path: ["releases", "list"],
   aliases: [["releases"]],
   summary: "What did the last deploys break? Recent releases with their events, issues and the issues they introduced.",
@@ -2563,25 +2861,25 @@ ${table(d.newIssues, ["short_id", "count", "title"])}` : ""}`,
     return data;
   }
 };
-var releases_default = [list4, health2, declare, verdict];
+var releases_default = [list5, health2, declare, verdict];
 
 // src/commands/artifacts.ts
 import { readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
-import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync5 } from "node:fs";
 
 // src/lib/sourcemaps.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync2 } from "node:fs";
+import { existsSync as existsSync3 } from "node:fs";
 import { readdir, readFile, stat } from "node:fs/promises";
-import { dirname as dirname2, join as join2, relative, resolve as resolve3, sep } from "node:path";
+import { dirname as dirname2, join as join3, relative as relative2, resolve as resolve3, sep as sep2 } from "node:path";
 var JS = /\.(m?js|cjs)$/i;
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".svn", ".hg"]);
-async function walk(dir) {
+async function walk2(dir) {
   const out = [];
   for (const entry of await readdir(dir, { withFileTypes: true })) {
-    const full = join2(dir, entry.name);
+    const full = join3(dir, entry.name);
     if (entry.isDirectory()) {
-      if (!SKIP_DIRS.has(entry.name)) out.push(...await walk(full));
+      if (!SKIP_DIRS.has(entry.name)) out.push(...await walk2(full));
     } else if (entry.isFile()) out.push(full);
   }
   return out.sort();
@@ -2641,7 +2939,7 @@ async function findPairs(paths) {
     const st = await stat(abs).catch(() => void 0);
     if (!st) throw new Error(`No such file or directory: ${p}`);
     const root = st.isDirectory() ? abs : dirname2(abs);
-    const files = st.isDirectory() ? await walk(abs) : [abs];
+    const files = st.isDirectory() ? await walk2(abs) : [abs];
     for (const js of files.filter((f) => JS.test(f))) {
       if (seen.has(js)) continue;
       seen.add(js);
@@ -2650,16 +2948,16 @@ async function findPairs(paths) {
       let map;
       if (url && !url.startsWith("data:")) {
         const candidate = resolve3(dirname2(js), decodeURIComponent(url.split(/[?#]/)[0]));
-        if (existsSync2(candidate)) map = candidate;
+        if (existsSync3(candidate)) map = candidate;
       }
-      if (!map && existsSync2(`${js}.map`)) map = `${js}.map`;
+      if (!map && existsSync3(`${js}.map`)) map = `${js}.map`;
       pairs2.push({ js, map, root });
     }
   }
   return pairs2;
 }
 function artifactName(file, root, prefix) {
-  const rel = relative(root, file).split(sep).join("/");
+  const rel = relative2(root, file).split(sep2).join("/");
   const p = prefix.endsWith("/") ? prefix : `${prefix}/`;
   return `${p}${rel}`;
 }
@@ -2941,8 +3239,8 @@ skipped, no source map: ${d.skipped.join(", ")}` : ""}`,
   }
 };
 function uuidFromDebugMeta(path) {
-  if (!existsSync3(path)) throw usageError("bad_path", `No such file: ${path}`);
-  const m = /ProguardUuids\s*[=:]\s*([0-9a-fA-F-]{36})/.exec(readFileSync4(path, "utf8"));
+  if (!existsSync4(path)) throw usageError("bad_path", `No such file: ${path}`);
+  const m = /ProguardUuids\s*[=:]\s*([0-9a-fA-F-]{36})/.exec(readFileSync5(path, "utf8"));
   if (!m) throw usageError("bad_value", `No ProguardUuids entry in ${path}`);
   return m[1].toLowerCase();
 }
@@ -2967,7 +3265,7 @@ var proguardUpload = {
   output: "{id, state, files[{name, kind, state}], chunks{}, bytes{}, uuid}",
   async run(ctx) {
     const i = ctx.input;
-    if (!existsSync3(i.mapping)) throw usageError("bad_path", `No such file: ${i.mapping}`);
+    if (!existsSync4(i.mapping)) throw usageError("bad_path", `No such file: ${i.mapping}`);
     const data = await readFile2(i.mapping);
     if (!data.length) throw usageError("bad_value", `${i.mapping} is empty.`);
     const uuid = (i.uuid ?? (i.debugMeta ? uuidFromDebugMeta(i.debugMeta) : proguardUuid(data))).toLowerCase();
@@ -3004,7 +3302,7 @@ var artifacts_default = [sourcemapsInject, sourcemapsUpload, proguardUpload, art
 
 // src/commands/tokens.ts
 var SCOPE_HINT = "e.g. org:read,project:read,event:read,event:write,project:write,project:releases,project:admin";
-var list5 = {
+var list6 = {
   path: ["tokens", "list"],
   aliases: [["tokens"]],
   summary: "Your tokens, newest first, without their values.",
@@ -3117,7 +3415,7 @@ var self = {
     return ctx.api.get("tokens/self");
   }
 };
-var tokens_default = [list5, self, create2, update, remove, rotate2];
+var tokens_default = [list6, self, create2, update, remove, rotate2];
 
 // src/commands/support.ts
 var SUPPORT = {
@@ -3154,33 +3452,33 @@ var support = {
 var support_default = [support];
 
 // src/commands/init.ts
-import { existsSync as existsSync5, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync7 } from "node:fs";
 import { appendFile, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join4, resolve as resolve4 } from "node:path";
+import { join as join5, resolve as resolve4 } from "node:path";
 
 // src/lib/detect.ts
-import { existsSync as existsSync4, readFileSync as readFileSync5, readdirSync } from "node:fs";
-import { basename, join as join3 } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync6, readdirSync as readdirSync2 } from "node:fs";
+import { basename as basename3, join as join4 } from "node:path";
 function readJson(path) {
   try {
-    return JSON.parse(readFileSync5(path, "utf8"));
+    return JSON.parse(readFileSync6(path, "utf8"));
   } catch {
     return void 0;
   }
 }
 function has(dir, ...names) {
-  return names.find((n) => existsSync4(join3(dir, n)));
+  return names.find((n) => existsSync5(join4(dir, n)));
 }
 function slugify(s) {
   return s.toLowerCase().replace(/^@[^/]+\//, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 50);
 }
 function detect(dir, guideBase) {
   const evidence = [];
-  const composer = readJson(join3(dir, "composer.json"));
-  const pkg = readJson(join3(dir, "package.json"));
+  const composer = readJson(join4(dir, "composer.json"));
+  const pkg = readJson(join4(dir, "package.json"));
   const deps = { ...pkg?.dependencies ?? {}, ...pkg?.devDependencies ?? {} };
   const hasDep = (d) => d in deps;
-  const name = slugify(pkg?.name ?? composer?.name?.split("/").pop() ?? basename(dir)) || "app";
+  const name = slugify(pkg?.name ?? composer?.name?.split("/").pop() ?? basename3(dir)) || "app";
   const guide = (slug) => `${guideBase}/${slug}.md`;
   if (composer?.require?.["laravel/framework"]) {
     evidence.push("composer.json requires laravel/framework");
@@ -3235,8 +3533,8 @@ function detect(dir, guideBase) {
   }
   const py = has(dir, "pyproject.toml", "requirements.txt", "Pipfile", "manage.py");
   if (py) {
-    const text = ["pyproject.toml", "requirements.txt", "Pipfile"].map((f) => existsSync4(join3(dir, f)) ? readFileSync5(join3(dir, f), "utf8") : "").join("\n").toLowerCase();
-    const fw = existsSync4(join3(dir, "manage.py")) || text.includes("django") ? "django" : text.includes("fastapi") ? "fastapi" : text.includes("flask") ? "flask" : "python";
+    const text = ["pyproject.toml", "requirements.txt", "Pipfile"].map((f) => existsSync5(join4(dir, f)) ? readFileSync6(join4(dir, f), "utf8") : "").join("\n").toLowerCase();
+    const fw = existsSync5(join4(dir, "manage.py")) || text.includes("django") ? "django" : text.includes("fastapi") ? "fastapi" : text.includes("flask") ? "flask" : "python";
     evidence.push(`${py} (${fw})`);
     return { platform: fw === "python" ? "python" : `python-${fw}`, framework: fw, surfaces: ["backend"], env: { backend: "SENTRY_DSN" }, guide: guide("python-sentry-sdk"), name, evidence };
   }
@@ -3245,7 +3543,7 @@ function detect(dir, guideBase) {
     evidence.push(gradle);
     return { platform: "android", framework: "android", surfaces: ["mobile"], env: {}, guide: guide("mobile"), name, evidence };
   }
-  const apple = has(dir, "Podfile", "Package.swift") ?? readdirSync(dir).find((f) => f.endsWith(".xcodeproj"));
+  const apple = has(dir, "Podfile", "Package.swift") ?? readdirSync2(dir).find((f) => f.endsWith(".xcodeproj"));
   if (apple) {
     evidence.push(apple);
     return { platform: "apple-ios", framework: "ios", surfaces: ["mobile"], env: {}, guide: guide("mobile"), name, evidence };
@@ -3296,14 +3594,14 @@ ${d.steps.map((s, i) => `${i + 1}. ${s.detail}${s.run ? `
   async run(ctx) {
     const i = ctx.input;
     const dir = resolve4(i.dir);
-    if (!existsSync5(dir)) throw usageError("bad_path", `No such directory: ${i.dir}`);
+    if (!existsSync6(dir)) throw usageError("bad_path", `No such directory: ${i.dir}`);
     const found = detect(dir, ctx.config.url);
     const platform = i.platform ?? found.platform;
     const surfaces = i.surfaces ?? found.surfaces;
     const name = i.name ?? found.name;
     const detected = { platform, framework: found.framework, surfaces, evidence: found.evidence, name };
     const steps = [];
-    const upload = found.buildDir ? `tracksiy sourcemaps upload ${found.buildDir} --inject` : void 0;
+    const upload2 = found.buildDir ? `tracksiy sourcemaps upload ${found.buildDir} --inject` : void 0;
     if (i.dryRun) {
       steps.push({ id: "create", run: `tracksiy init${i.writeEnv ? " --write-env" : ""}`, detail: "Create the project and keys." });
       return { dryRun: true, detected, guide: found.guide, steps };
@@ -3315,7 +3613,7 @@ ${d.steps.map((s, i) => `${i + 1}. ${s.detail}${s.run ? `
       compact({ name, platform, surfaces, sameHost: i.sameHost })
     );
     const project2 = prov.project;
-    const pfPath = join4(dir, PROJECT_FILE);
+    const pfPath = join5(dir, PROJECT_FILE);
     const pf = { org: project2.organization, project: project2.slug };
     if (ctx.config.url !== DEFAULT_URL) pf.url = ctx.config.url;
     await writeFile3(pfPath, JSON.stringify(pf, null, 2) + "\n");
@@ -3327,11 +3625,11 @@ ${d.steps.map((s, i) => `${i + 1}. ${s.detail}${s.run ? `
     }));
     let env;
     if (i.writeEnv) {
-      const envPath = join4(dir, ".env");
-      if (!existsSync5(envPath)) {
+      const envPath = join5(dir, ".env");
+      if (!existsSync6(envPath)) {
         throw usageError("no_env_file", `${envPath} does not exist; nothing was written to it.`, "Create it (and make sure it is gitignored), or set the variables yourself from `keys` in the output.");
       }
-      const current = readFileSync6(envPath, "utf8");
+      const current = readFileSync7(envPath, "utf8");
       const added = [];
       const kept = [];
       let block = "";
@@ -3353,7 +3651,7 @@ ${block}`);
     if (!i.writeEnv && keys.some((k) => k.env)) {
       steps.push({ id: "env", detail: `Set ${keys.filter((k) => k.env).map((k) => k.env).join(", ")} from \`keys\` (or re-run with --write-env).` });
     }
-    if (upload) steps.push({ id: "sourcemaps", detail: "After each production build, upload source maps (uses project:releases).", run: upload });
+    if (upload2) steps.push({ id: "sourcemaps", detail: "After each production build, upload source maps (uses project:releases).", run: upload2 });
     steps.push({ id: "alerts", detail: "Decide who is told. A project without a recipient notifies nobody.", run: "tracksiy alerts set --recipient email && tracksiy alerts test" });
     steps.push({ id: "verify", detail: "Deploy, trigger one error, then prove it arrived.", run: "tracksiy projects verify --wait 120" });
     return {
@@ -3386,7 +3684,7 @@ function camel(name) {
 }
 
 // src/core/args.ts
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync8 } from "node:fs";
 var GLOBAL_FLAGS = {
   org: { type: "string", value: "<slug>", description: "Organization slug. Env: TRACKSIY_ORG. Default: .tracksiy.json, saved login, or your only organization." },
   project: { type: "string", value: "<slug>", description: "Project slug, or org/project. Env: TRACKSIY_PROJECT. Default: .tracksiy.json." },
@@ -3403,7 +3701,7 @@ var GLOBAL_FLAGS = {
 };
 var stdinCache;
 function readStdin() {
-  stdinCache ??= readFileSync7(0, "utf8");
+  stdinCache ??= readFileSync8(0, "utf8");
   return stdinCache;
 }
 function parseJsonValue(name, raw) {
@@ -3411,7 +3709,7 @@ function parseJsonValue(name, raw) {
   if (raw === "-") text = readStdin();
   else if (raw.startsWith("@")) {
     try {
-      text = readFileSync7(raw.slice(1), "utf8");
+      text = readFileSync8(raw.slice(1), "utf8");
     } catch (err) {
       throw usageError("bad_value", `--${name}: cannot read ${raw.slice(1)}: ${err.message}`);
     }
@@ -3781,15 +4079,15 @@ function makeContext(spec, input, globals, surface, io) {
   const org = () => {
     orgPromise ??= (async () => {
       if (config.org) return config.org;
-      const list6 = await visible();
-      if (list6.length === 1) {
-        log(`using organization ${list6[0].slug}`);
-        return list6[0].slug;
+      const list7 = await visible();
+      if (list7.length === 1) {
+        log(`using organization ${list7[0].slug}`);
+        return list7[0].slug;
       }
       throw usageError(
         "missing_org",
-        list6.length ? "Which organization? This token can see several." : "This token cannot see any organization.",
-        list6.length ? `Pass --org <slug>, set TRACKSIY_ORG, or add "org" to ${".tracksiy.json"}. Visible: ${list6.map((o) => o.slug).join(", ")}` : "Check the token with `tracksiy auth status`."
+        list7.length ? "Which organization? This token can see several." : "This token cannot see any organization.",
+        list7.length ? `Pass --org <slug>, set TRACKSIY_ORG, or add "org" to ${".tracksiy.json"}. Visible: ${list7.map((o) => o.slug).join(", ")}` : "Check the token with `tracksiy auth status`."
       );
     })();
     return orgPromise;
@@ -3799,8 +4097,8 @@ function makeContext(spec, input, globals, surface, io) {
     projectPromise ??= (async () => {
       const o = await org();
       if (config.project) return { org: o, project: config.project };
-      const list6 = await visible();
-      const projects2 = list6.find((x) => x.slug === o)?.projects ?? [];
+      const list7 = await visible();
+      const projects2 = list7.find((x) => x.slug === o)?.projects ?? [];
       if (projects2.length === 1) {
         log(`using project ${o}/${projects2[0].slug}`);
         return { org: o, project: projects2[0].slug };
@@ -4025,6 +4323,7 @@ var COMMANDS = [
   ...mobile_default,
   ...logs_default,
   ...evidence_default,
+  ...builds_default,
   ...issues_default,
   ...projects_default,
   ...alerts_default,
@@ -4039,7 +4338,7 @@ var COMMANDS = [
 var GROUPS = [
   ["Start", "init auth onboarding describe"],
   ["Look", "overview changes health storage orgs projects issues monitors performance mobile logs user-feedback attachments queries not-found releases alerts keys artifacts settings privacy-preview"],
-  ["Ship", "sourcemaps proguard"],
+  ["Ship", "sourcemaps proguard build builds"],
   ["Manage", "tokens"],
   ["Talk to us", "support"],
   ["Other", "api mcp"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracksiy",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Agent-first CLI and MCP server for Tracksiy: errors, uptime, alerts, releases and source maps, from one token.",
   "type": "module",
   "bin": {