tracksiy 0.13.0 → 0.14.0

package/README.md

@@ -150,6 +150,14 @@ Labels: `bug`, `feature`, `question`, `blocker`. `npx tracksiy support` prints t
 | `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` |
+| `metrics list` | Metrics the app sent (Sentry.metrics.*, sentry-php traceMetrics, the server agent): name, type, unit, series and tag keys. | read | `metrics_list` |
+| `metrics query <name>` | One metric as a time series: sum, count, avg, min, max, last or p50..p99 per interval, grouped by a tag. | read | `metrics_query` |
+| `profiles functions` | Where the CPU time goes: functions by self or total time, with file and line, per transaction or overall. | read | `profiles_functions` |
+| `profiles list` | Stored profiles newest first. | read | `profiles_list` |
+| `profiles flamegraph <id>` | One profile's call tree, root to leaf, in ms (text: the heaviest paths). | read | `profiles_flamegraph` |
+| `replays list` | Session replays newest first (kept only when the project turned replays on). | read | `replays_list` |
+| `replays view <id>` | One replay: what the user did, in order (navigations, clicks / taps, console, network), and its segments. | read | `replays_view` |
+| `issues replays <id>` | Replays that recorded this issue's events. | read | `issues_replays` |
 | `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.13.0" : "0.0.0-dev";
+var VERSION = true ? "0.14.0" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -1050,7 +1050,7 @@ var settingsGet = {
   context: "project",
   effect: "read",
   endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/settings" },
-  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}, attachments{store, maxKb, quotaMb, retentionDays}}",
+  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}, attachments{store, maxKb, quotaMb, retentionDays}, profiles{enabled, quotaMb, retentionDays}, replays{enabled, quotaMb, retentionDays}}",
   async run(ctx) {
     return ctx.api.get(await projectPath(ctx, "settings"));
   }
@@ -1097,6 +1097,12 @@ var settingsSet = {
     "attachment-max-kb": { type: "integer", value: "<kb>", description: "Largest attachment kept (default 5120)." },
     "attachments-quota-mb": { type: "integer", value: "<mb>", description: "The project's attachment budget (default 500); past it new files are dropped (attachment:quota)." },
     "attachments-retention-days": { type: "integer", value: "<days>", description: "Keep attachments this long (default 30)." },
+    profiles: { type: "boolean", description: "Keep profiles (default on); --no-profiles drops them (profile:disabled)." },
+    "profiles-quota-mb": { type: "integer", value: "<mb>", description: "Raw profiles' budget (default 500)." },
+    "profiles-retention-days": { type: "integer", value: "<days>", description: "Keep raw profiles this long (default 7)." },
+    replays: { type: "boolean", description: "Keep session replays (default OFF: a replay records the screen). --replays turns them on." },
+    "replays-quota-mb": { type: "integer", value: "<mb>", description: "Replays' budget (default 1000)." },
+    "replays-retention-days": { type: "integer", value: "<days>", description: "Keep replays this long (default 14)." },
     body: { type: "json", value: "<json|@file|->", description: "The whole declaration; overrides the flags." }
   },
   examples: [
@@ -1106,7 +1112,7 @@ var settingsSet = {
     { command: "tracksiy settings set --source-root 'strip=/var/www/shop/,prepend=backend/,surface=backend'", description: "The server checkout is only the repo's backend/ directory." },
     { command: "tracksiy settings set --max-events-per-issue 500 --sourcemap-keep-releases 5", description: "A noisy project keeps less on disk." }
   ],
-  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}, attachments{store, maxKb, quotaMb, retentionDays}}",
+  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}, attachments{store, maxKb, quotaMb, retentionDays}, profiles{enabled, quotaMb, retentionDays}, replays{enabled, quotaMb, retentionDays}}",
   async run(ctx) {
     const path = await projectPath(ctx, "settings");
     const i = ctx.input;
@@ -1138,6 +1144,18 @@ var settingsSet = {
         ...i.attachmentsQuotaMb !== void 0 ? { quotaMb: i.attachmentsQuotaMb } : {},
         ...i.attachmentsRetentionDays !== void 0 ? { retentionDays: i.attachmentsRetentionDays } : {}
       },
+      profiles: {
+        ...current.profiles ?? {},
+        ...i.profiles !== void 0 ? { enabled: i.profiles } : {},
+        ...i.profilesQuotaMb !== void 0 ? { quotaMb: i.profilesQuotaMb } : {},
+        ...i.profilesRetentionDays !== void 0 ? { retentionDays: i.profilesRetentionDays } : {}
+      },
+      replays: {
+        ...current.replays ?? {},
+        ...i.replays !== void 0 ? { enabled: i.replays } : {},
+        ...i.replaysQuotaMb !== void 0 ? { quotaMb: i.replaysQuotaMb } : {},
+        ...i.replaysRetentionDays !== void 0 ? { retentionDays: i.replaysRetentionDays } : {}
+      },
       releaseHealth: {
         ...current.releaseHealth ?? {},
         ...i.crashFreeMin !== void 0 ? { crashFreeSessionsMin: i.crashFreeMin } : {},
@@ -2000,6 +2018,162 @@ var view = {
 };
 var builds_default = [upload, list2, view];
 
+// src/commands/telemetry.ts
+var metricsList = {
+  path: ["metrics", "list"],
+  aliases: [["metrics"]],
+  summary: "Metrics the app sent (Sentry.metrics.*, sentry-php traceMetrics, the server agent): name, type, unit, series and tag keys.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/metrics" },
+  flags: { since: { type: "string", value: TIME, description: "Default 24h." } },
+  output: "{since, metrics:[{name, type, unit, source, series, points, lastSeen, tagKeys[]}]}",
+  text: (d) => table(d.metrics ?? [], ["name", "type", "unit", "series", "points", ["last", (r) => ago(r.lastSeen)], ["tags", (r) => (r.tagKeys ?? []).join(",")]]),
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, "metrics"), { since: since(ctx.input.since) });
+  }
+};
+var metricsQuery = {
+  path: ["metrics", "query"],
+  summary: "One metric as a time series: sum, count, avg, min, max, last or p50..p99 per interval, grouped by a tag.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/metrics/query" },
+  args: [{ name: "name", required: true, description: "The metric name." }],
+  flags: {
+    agg: { type: "string", enum: ["sum", "count", "avg", "min", "max", "last", "p50", "p75", "p90", "p95", "p99"], description: "Default sum." },
+    since: { type: "string", value: TIME, description: "Default 24h." },
+    until: { type: "string", value: TIME, description: "Default now." },
+    "group-by": { type: "string", value: "<tag>", description: "One series per value of this tag (top 20)." },
+    filter: { type: "string", value: "<key:value>", description: "Only points with this tag value." },
+    interval: { type: "integer", value: "<seconds>", description: "Seconds per point (default by window)." }
+  },
+  examples: [{ command: "tracksiy metrics query checkout.duration --agg p95 --group-by route --since 6h", description: "p95 per route." }],
+  output: "{name, type, unit, agg, interval, series:[{group, total, points:[{t, v, count}]}]}",
+  text: (d) => `${kv({ name: d.name, type: d.type, unit: d.unit, agg: d.agg, interval: `${d.interval}s` })}
+
+${table(d.series ?? [], [["group", (r) => r.group ?? "(all)"], ["total", (r) => r.total ?? "-"], ["points", (r) => (r.points ?? []).length], ["last", (r) => (r.points ?? []).at(-1)?.v ?? "-"]])}`,
+  async run(ctx) {
+    const i = ctx.input;
+    return ctx.api.get(await projectPath(ctx, "metrics/query"), { name: i.name, agg: i.agg, since: since(i.since), until: since(i.until, "until"), groupBy: i.groupBy, filter: i.filter, interval: i.interval });
+  }
+};
+var profileFunctions = {
+  path: ["profiles", "functions"],
+  aliases: [["profiles"]],
+  summary: "Where the CPU time goes: functions by self or total time, with file and line, per transaction or overall.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/profiles/functions" },
+  flags: {
+    since: { type: "string", value: TIME, description: "Default 7d." },
+    transaction: { type: "string", value: "<name>", description: "Only profiles of this route / screen." },
+    "application-only": { type: "boolean", description: "Only your own code (in_app frames)." },
+    sort: { type: "string", enum: ["self", "total"], description: "Default self." },
+    limit: { type: "integer", value: "<n>", description: "At most 200 (default 50)." }
+  },
+  examples: [{ command: "tracksiy profiles functions --transaction 'GET /cart' --application-only", description: "Our hottest code on one route." }],
+  output: "{since, sampledMs, functions:[{function, module, file, line, isApplication, selfMs, totalMs, selfPct, totalPct, samples, profiles, transactions}], notes[]}",
+  text: (d) => `${table(d.functions ?? [], [["self %", (r) => r.selfPct], ["total %", (r) => r.totalPct], "function", ["where", (r) => `${r.file ?? r.module ?? ""}${r.line ? ":" + r.line : ""}`], ["app", (r) => r.isApplication ? "yes" : ""]])}${(d.notes ?? []).length ? `
+
+${d.notes.join("\n")}` : ""}`,
+  async run(ctx) {
+    const i = ctx.input;
+    return ctx.api.get(await projectPath(ctx, "profiles/functions"), { since: since(i.since), transaction: i.transaction, applicationOnly: i.applicationOnly || void 0, sort: i.sort, limit: i.limit });
+  }
+};
+var profileList = {
+  path: ["profiles", "list"],
+  summary: "Stored profiles newest first.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/profiles" },
+  flags: {
+    since: { type: "string", value: TIME, description: "Only since then." },
+    transaction: { type: "string", value: "<name>", description: "Only this transaction." },
+    trace: { type: "string", value: "<trace id>", description: "Only this trace." },
+    limit: { type: "integer", value: "<n>", description: "At most 200." }
+  },
+  output: "[{id, received, kind, platform, transaction, traceId, release, durationMs, samples, analyzed}]",
+  text: (d) => table(d ?? [], ["id", ["when", (r) => ago(r.received)], "kind", "platform", "transaction", "durationMs", "samples", "analyzed"]),
+  async run(ctx) {
+    const i = ctx.input;
+    return ctx.api.get(await projectPath(ctx, "profiles"), { since: since(i.since), transaction: i.transaction, trace: i.trace, limit: i.limit });
+  }
+};
+var profileFlamegraph = {
+  path: ["profiles", "flamegraph"],
+  summary: "One profile's call tree, root to leaf, in ms (text: the heaviest paths).",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/profiles/{id}/flamegraph" },
+  args: [{ name: "id", required: true, description: "The profile id (from `profiles list`)." }],
+  output: "{name, value, children[...]}",
+  text: (d) => {
+    const lines = [];
+    const walk3 = (node, depth) => {
+      if (depth > 12 || lines.length > 60) return;
+      lines.push(`${"  ".repeat(depth)}${Math.round(node.value)} ms  ${node.name}`);
+      for (const child of (node.children ?? []).slice(0, 3)) walk3(child, depth + 1);
+    };
+    walk3(d, 0);
+    return lines.join("\n");
+  },
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, `profiles/${encodeURIComponent(ctx.input.id)}/flamegraph`));
+  }
+};
+var replayList = {
+  path: ["replays", "list"],
+  aliases: [["replays"]],
+  summary: "Session replays newest first (kept only when the project turned replays on).",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/replays" },
+  flags: {
+    since: { type: "string", value: TIME, description: "Only since then." },
+    url: { type: "string", value: "<text>", description: "Only replays that visited a URL containing this." },
+    limit: { type: "integer", value: "<n>", description: "At most 200." }
+  },
+  output: "[{replayId, started, durationMs, segments, platform, release, browser, os, device, urls[], errorIds[], hasVideo}]",
+  text: (d) => table(d ?? [], ["replayId", ["when", (r) => ago(r.lastSeen)], ["length", (r) => `${Math.round(r.durationMs / 1e3)}s`], "platform", ["errors", (r) => (r.errorIds ?? []).length], ["first url", (r) => (r.urls ?? [])[0] ?? "-"]]),
+  async run(ctx) {
+    const i = ctx.input;
+    return ctx.api.get(await projectPath(ctx, "replays"), { since: since(i.since), url: i.url, limit: i.limit });
+  }
+};
+var replayView = {
+  path: ["replays", "view"],
+  summary: "One replay: what the user did, in order (navigations, clicks / taps, console, network), and its segments.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/replays/{replay_id}" },
+  args: [{ name: "id", required: true, description: "The replay id (32 hex)." }],
+  output: "{replayId, ..., segmentList[{segmentId, kind, recordingUrl, videoUrl}], timeline[{offsetMs, category, message, status?, durationMs?, level?}]}",
+  text: (d) => `${kv({ replay: d.replayId, platform: d.platform, release: d.release ?? "-", length: `${Math.round((d.durationMs ?? 0) / 1e3)}s`, segments: d.segments })}
+
+${(d.timeline ?? []).map((l) => `${String(Math.round((l.offsetMs ?? 0) / 1e3)).padStart(5)}s  ${String(l.category).padEnd(18)} ${l.message ?? ""}${l.status ? ` [${l.status}]` : ""}`).join("\n")}`,
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, `replays/${encodeURIComponent(ctx.input.id)}`));
+  }
+};
+var issueReplays = {
+  path: ["issues", "replays"],
+  summary: "Replays that recorded this issue's events.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/issues/{id}/replays" },
+  args: [{ name: "id", required: true, description: "The issue id." }],
+  output: "{issueId, replays[...], notes[]}",
+  text: (d) => `${table(d.replays ?? [], ["replayId", ["length", (r) => `${Math.round(r.durationMs / 1e3)}s`], "platform", ["first url", (r) => (r.urls ?? [])[0] ?? "-"]])}${(d.notes ?? []).length ? `
+
+${d.notes.join("\n")}` : ""}`,
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}/replays`));
+  }
+};
+var telemetry_default = [metricsList, metricsQuery, profileFunctions, profileList, profileFlamegraph, replayList, replayView, issueReplays];
+
 // src/commands/issues.ts
 import { writeFileSync as writeFileSync2 } from "node:fs";
 var FILTERS = {
@@ -4324,6 +4498,7 @@ var COMMANDS = [
   ...logs_default,
   ...evidence_default,
   ...builds_default,
+  ...telemetry_default,
   ...issues_default,
   ...projects_default,
   ...alerts_default,
@@ -4337,7 +4512,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"],
+  ["Look", "overview changes health storage orgs projects issues monitors performance mobile logs metrics profiles replays user-feedback attachments queries not-found releases alerts keys artifacts settings privacy-preview"],
   ["Ship", "sourcemaps proguard build builds"],
   ["Manage", "tokens"],
   ["Talk to us", "support"],

package/package.json

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