tracksiy 0.10.0 → 0.11.0

package/README.md

@@ -139,6 +139,10 @@ Labels: `bug`, `feature`, `question`, `blocker`. `npx tracksiy support` prints t
 | `monitors timing <slug>` | Where an HTTP monitor's time goes (DNS, connect, server, TTFB, download, page size); how long a job runs and how close to its max runtime. | read | `monitors_timing` |
 | `storage` | What each project holds on the server (events, transactions, source maps, debug files), largest first, with its retention limits. | read | `storage` |
 | `mobile` | How fast the app is on phones: app start (cold/warm) against the window before, per OS and release, and per screen TTID/TTFD and slow/frozen frames, with checks for what the SDK does not report. | read | `mobile` |
+| `logs list` | What the app logged, newest first: by level, text, trace, release, attribute. --follow keeps printing new lines. | read | `logs_list` |
+| `logs patterns` | The loudest log lines, counted across their values (message template, or the body with numbers and ids blanked). | read | `logs_patterns` |
+| `logs stats` | Log counts per level per minute, hour or day. | read | `logs_stats` |
+| `issues logs <id>` | What the app logged around an error: the logs in the traces of the issue's last events. | read | `issues_logs` |
 | `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.10.0" : "0.0.0-dev";
+var VERSION = true ? "0.11.0" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -508,8 +508,8 @@ function table(rows, columns2) {
     widths[i]--;
   }
   const fit = (s, n) => s.length > n ? s.slice(0, Math.max(1, n - 1)) + "\u2026" : s.padEnd(n);
-  const line = (vals) => vals.map((v, i) => fit(v, widths[i])).join("  ").trimEnd();
-  return [line(cols.map(([n]) => n.toUpperCase())), ...cells.map(line)].join("\n");
+  const line2 = (vals) => vals.map((v, i) => fit(v, widths[i])).join("  ").trimEnd();
+  return [line2(cols.map(([n]) => n.toUpperCase())), ...cells.map(line2)].join("\n");
 }
 function kv(obj, keys) {
   const entries = (keys ?? Object.keys(obj)).filter((k) => k in obj && isScalar(obj[k]));
@@ -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}}",
+  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}}",
   async run(ctx) {
     return ctx.api.get(await projectPath(ctx, "settings"));
   }
@@ -1090,6 +1090,9 @@ var settingsSet = {
     "max-drop-pct": { type: "number", value: "<points>", description: "...or this many points worse than the previous release of the line (default 0.5)." },
     "velocity-pct": { type: "number", value: "<pct>", description: "Velocity alert: one issue's events in 30 minutes reaching this % of the release's sessions in the last hour (default 1)." },
     "velocity-min-events": { type: "integer", value: "<n>", description: "...with at least this many events (default 10)." },
+    logs: { type: "boolean", description: "Store structured logs at all (default on). --no-logs drops them, counted as log:disabled." },
+    "logs-min-level": { type: "string", enum: ["trace", "debug", "info", "warn", "error", "fatal"], description: "Drop log lines below this level at ingest (default trace)." },
+    "logs-daily-limit": { type: "integer", value: "<n>", description: "At most this many log lines a day (default 100000); the rest are dropped and counted as log:daily_limit." },
     body: { type: "json", value: "<json|@file|->", description: "The whole declaration; overrides the flags." }
   },
   examples: [
@@ -1099,7 +1102,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}}",
+  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}}",
   async run(ctx) {
     const path = await projectPath(ctx, "settings");
     const i = ctx.input;
@@ -1118,6 +1121,12 @@ var settingsSet = {
         ...i.sourcemapKeepReleases !== void 0 ? { sourcemapKeepReleases: i.sourcemapKeepReleases } : {},
         ...i.sourcemapKeepUsedDays !== void 0 ? { sourcemapKeepUsedDays: i.sourcemapKeepUsedDays } : {}
       },
+      logs: {
+        ...current.logs ?? {},
+        ...i.logs !== void 0 ? { enabled: i.logs } : {},
+        ...i.logsMinLevel !== void 0 ? { minLevel: i.logsMinLevel } : {},
+        ...i.logsDailyLimit !== void 0 ? { dailyLimit: i.logsDailyLimit } : {}
+      },
       releaseHealth: {
         ...current.releaseHealth ?? {},
         ...i.crashFreeMin !== void 0 ? { crashFreeSessionsMin: i.crashFreeMin } : {},
@@ -1461,6 +1470,137 @@ ${checks}`;
 };
 var mobile_default = [mobile];
 
+// src/commands/logs.ts
+var LEVELS = ["trace", "debug", "info", "warn", "error", "fatal"];
+var line = (l) => `${String(l.timestamp).slice(11, 23)} ${String(l.level).toUpperCase().padEnd(5)} ${l.body}${l.traceId ? `  [trace ${String(l.traceId).slice(0, 8)}]` : ""}`;
+function filters(i) {
+  return {
+    since: since(i.since),
+    until: since(i.until, "until"),
+    level: i.level,
+    query: i.query,
+    trace: i.trace,
+    release: i.release,
+    environment: i.environment,
+    logger: i.logger,
+    attribute: i.attribute,
+    pattern: i.pattern,
+    limit: i.limit,
+    cursor: i.cursor
+  };
+}
+var FILTER_FLAGS = {
+  since: { type: "string", value: TIME, description: "Window start (default 1h ago; at most 31 days)." },
+  until: { type: "string", value: TIME, description: "Window end (default now)." },
+  level: { type: "string", enum: LEVELS, description: "The lowest level shown." },
+  query: { type: "string", value: "<text>", description: "Case-insensitive text in the line." },
+  trace: { type: "string", value: "<trace id>", description: "Only this trace (32 hex)." },
+  release: { type: "string", value: "<version>", description: "Only this release." },
+  environment: { type: "string", value: "<name>", description: "Only this environment." },
+  logger: { type: "string", value: "<name>", description: "Only this logger / origin (sentry.origin, logger.name)." },
+  attribute: { type: "string", value: "<key=value>", description: "Only lines with this attribute value." },
+  pattern: { type: "integer", value: "<n>", description: "Only this pattern (from `logs patterns`)." }
+};
+var list = {
+  path: ["logs", "list"],
+  aliases: [["logs"]],
+  summary: "What the app logged, newest first: by level, text, trace, release, attribute. --follow keeps printing new lines.",
+  description: "Structured logs from the SDKs (Sentry.logger.*, sentry-laravel's sentry_logs channel, the mobile loggers). `next` pages older lines (--cursor). --follow 10m polls every 3 s and prints new lines as they arrive (stderr), then returns them all. Per-project limits: `settings set --logs/--logs-min-level/--logs-daily-limit`.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/logs" },
+  flags: {
+    ...FILTER_FLAGS,
+    limit: { type: "integer", value: "<n>", description: "Lines per page (default 100, at most 500)." },
+    cursor: { type: "string", value: "<id>", description: "The `next` of the previous page." },
+    follow: { type: "string", value: "<duration>", description: "Keep polling for new lines this long: 5m, 1h." }
+  },
+  examples: [
+    { command: "tracksiy logs --level warn --since 30m", description: "Warnings and errors of the last half hour." },
+    { command: "tracksiy logs --trace 5b8efff798038103d269b633813fc60c", description: "Everything one request logged." },
+    { command: "tracksiy logs --query checkout --follow 10m", description: "Watch a deploy." }
+  ],
+  output: "{since, until, logs:[{id, timestamp, level, severity, body, traceId, spanId, release, environment, logger, source, pattern, attributes}], next}",
+  text: (d) => `${(d.logs ?? []).slice().reverse().map(line).join("\n") || "(no lines)"}${d.next ? `
+
+older: --cursor ${d.next}` : ""}`,
+  async run(ctx) {
+    const path = await projectPath(ctx, "logs");
+    const query = filters(ctx.input);
+    const followSeconds = duration(ctx.input.follow, "follow") ?? 0;
+    let data = await ctx.api.get(path, query);
+    if (!followSeconds) return data;
+    const seen = new Set((data.logs ?? []).map((l) => l.id));
+    const all = [...data.logs ?? []];
+    let lastTime = all.length ? all[0].timestamp : (/* @__PURE__ */ new Date()).toISOString();
+    const deadline = Date.now() + followSeconds * 1e3;
+    while (Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, 3e3));
+      const page = await ctx.api.get(path, { ...query, since: lastTime, cursor: void 0, limit: 500 });
+      const fresh = (page.logs ?? []).filter((l) => !seen.has(l.id)).reverse();
+      for (const l of fresh) {
+        seen.add(l.id);
+        all.unshift(l);
+        ctx.log(line(l));
+        lastTime = l.timestamp;
+      }
+    }
+    return { ...data, logs: all, next: null };
+  }
+};
+var patterns = {
+  path: ["logs", "patterns"],
+  summary: "The loudest log lines, counted across their values (message template, or the body with numbers and ids blanked).",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/logs/patterns" },
+  flags: {
+    since: FILTER_FLAGS.since,
+    until: FILTER_FLAGS.until,
+    level: FILTER_FLAGS.level,
+    limit: { type: "integer", value: "<n>", description: "Patterns (default 100, at most 200)." }
+  },
+  examples: [{ command: "tracksiy logs patterns --since 24h --level warn", description: "Which warnings repeat; then `logs --pattern <n>`." }],
+  output: "{patterns:[{pattern, count, level, lastSeen, template, sample}]}",
+  text: (d) => table(d.patterns ?? [], ["count", "level", ["line", (r) => (r.template ?? r.sample ?? "").slice(0, 100)], "pattern"]),
+  async run(ctx) {
+    const i = ctx.input;
+    return ctx.api.get(await projectPath(ctx, "logs/patterns"), { since: since(i.since), until: since(i.until, "until"), level: i.level, limit: i.limit });
+  }
+};
+var stats = {
+  path: ["logs", "stats"],
+  summary: "Log counts per level per minute, hour or day.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/logs/stats" },
+  flags: { since: FILTER_FLAGS.since, until: FILTER_FLAGS.until },
+  output: "{bucketSeconds, totals{level: n}, buckets:[{start, counts}]}",
+  text: (d) => `${kv(d.totals ?? {})}
+
+${table(d.buckets ?? [], ["start", ...LEVELS.map((lvl) => [lvl, (r) => r.counts?.[lvl] ?? ""])])}`,
+  async run(ctx) {
+    const i = ctx.input;
+    return ctx.api.get(await projectPath(ctx, "logs/stats"), { since: since(i.since), until: since(i.until, "until") });
+  }
+};
+var issueLogs = {
+  path: ["issues", "logs"],
+  summary: "What the app logged around an error: the logs in the traces of the issue's last events.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/issues/{id}/logs" },
+  args: [{ name: "id", required: true, description: "The issue id." }],
+  output: "{issueId, traces[], logs[...], notes[]}",
+  text: (d) => `${(d.logs ?? []).slice().reverse().map(line).join("\n") || "(no lines)"}${(d.notes ?? []).length ? `
+
+${d.notes.join("\n")}` : ""}`,
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}/logs`));
+  }
+};
+var logs_default = [list, patterns, stats, issueLogs];
+
 // src/commands/issues.ts
 import { writeFileSync } from "node:fs";
 var FILTERS = {
@@ -1518,7 +1658,7 @@ var issueRows = (issues) => table(issues ?? [], [
   ["status", (r) => r.regressedAt && r.status === "unresolved" ? "regressed" : r.status],
   ["title", (r) => r.title]
 ]);
-var list = {
+var list2 = {
   path: ["issues", "list"],
   aliases: [["issues"]],
   summary: "Recent issues of a project, newest activity first, with the frames that matter inlined.",
@@ -1818,7 +1958,7 @@ var bulk = {
     return result;
   }
 };
-var issues_default = [list, view, resolve2, ignore, unresolve, bulk, merge, comment, activity, verifyFixed, claim, unclaim];
+var issues_default = [list2, view, resolve2, ignore, unresolve, bulk, merge, comment, activity, verifyFixed, claim, unclaim];
 
 // src/commands/projects.ts
 var create = {
@@ -1933,8 +2073,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(list5, delivery) {
-  return (list5 ?? []).map((raw) => {
+function recipients(list6, delivery) {
+  return (list6 ?? []).map((raw) => {
     const i = raw.indexOf(":");
     const type = i > 0 ? raw.slice(0, i) : raw;
     if (!RECIPIENT_TYPES.includes(type)) {
@@ -2115,7 +2255,7 @@ var settingsSet2 = {
 var alerts_default = [get, set, test, coverage, defaults, settingsGet2, settingsSet2];
 
 // src/commands/keys.ts
-var list2 = {
+var list3 = {
   path: ["keys", "list"],
   aliases: [["keys"]],
   summary: "Every ingest key of the project: its surface, whether ingest accepts it, its rate limit and volume.",
@@ -2172,11 +2312,11 @@ var rotate = {
     return ctx.api.send("POST", await projectPath(ctx, `keys/${seg(ctx.input.name)}/rotate`));
   }
 };
-var keys_default = [list2, set2, rotate];
+var keys_default = [list3, set2, rotate];
 
 // src/commands/releases.ts
 import { execFileSync } from "node:child_process";
-var list3 = {
+var list4 = {
   path: ["releases", "list"],
   aliases: [["releases"]],
   summary: "What did the last deploys break? Recent releases with their events, issues and the issues they introduced.",
@@ -2322,7 +2462,7 @@ ${table(d.newIssues, ["short_id", "count", "title"])}` : ""}`,
     return data;
   }
 };
-var releases_default = [list3, health2, declare, verdict];
+var releases_default = [list4, health2, declare, verdict];
 
 // src/commands/artifacts.ts
 import { readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
@@ -2763,7 +2903,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 list4 = {
+var list5 = {
   path: ["tokens", "list"],
   aliases: [["tokens"]],
   summary: "Your tokens, newest first, without their values.",
@@ -2876,7 +3016,7 @@ var self = {
     return ctx.api.get("tokens/self");
   }
 };
-var tokens_default = [list4, self, create2, update, remove, rotate2];
+var tokens_default = [list5, self, create2, update, remove, rotate2];
 
 // src/commands/support.ts
 var SUPPORT = {
@@ -3540,15 +3680,15 @@ function makeContext(spec, input, globals, surface, io) {
   const org = () => {
     orgPromise ??= (async () => {
       if (config.org) return config.org;
-      const list5 = await visible();
-      if (list5.length === 1) {
-        log(`using organization ${list5[0].slug}`);
-        return list5[0].slug;
+      const list6 = await visible();
+      if (list6.length === 1) {
+        log(`using organization ${list6[0].slug}`);
+        return list6[0].slug;
       }
       throw usageError(
         "missing_org",
-        list5.length ? "Which organization? This token can see several." : "This token cannot see any organization.",
-        list5.length ? `Pass --org <slug>, set TRACKSIY_ORG, or add "org" to ${".tracksiy.json"}. Visible: ${list5.map((o) => o.slug).join(", ")}` : "Check the token with `tracksiy auth status`."
+        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`."
       );
     })();
     return orgPromise;
@@ -3558,8 +3698,8 @@ function makeContext(spec, input, globals, surface, io) {
     projectPromise ??= (async () => {
       const o = await org();
       if (config.project) return { org: o, project: config.project };
-      const list5 = await visible();
-      const projects2 = list5.find((x) => x.slug === o)?.projects ?? [];
+      const list6 = await visible();
+      const projects2 = list6.find((x) => x.slug === o)?.projects ?? [];
       if (projects2.length === 1) {
         log(`using project ${o}/${projects2[0].slug}`);
         return { org: o, project: projects2[0].slug };
@@ -3724,11 +3864,11 @@ async function serve(io, defaults2) {
   const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
   io.stderr(`tracksiy mcp ${VERSION}: ${server.toolCount} tools on stdio
 `);
-  for await (const line of rl) {
-    if (!line.trim()) continue;
+  for await (const line2 of rl) {
+    if (!line2.trim()) continue;
     let msg;
     try {
-      msg = JSON.parse(line);
+      msg = JSON.parse(line2);
     } catch {
       write({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } });
       continue;
@@ -3782,6 +3922,7 @@ var COMMANDS = [
   ...perf_default,
   ...storage_default,
   ...mobile_default,
+  ...logs_default,
   ...issues_default,
   ...projects_default,
   ...alerts_default,
@@ -3795,7 +3936,7 @@ var COMMANDS = [
 ];
 var GROUPS = [
   ["Start", "init auth onboarding describe"],
-  ["Look", "overview changes health storage orgs projects issues monitors performance mobile queries not-found releases alerts keys artifacts settings privacy-preview"],
+  ["Look", "overview changes health storage orgs projects issues monitors performance mobile logs queries not-found releases alerts keys artifacts settings privacy-preview"],
   ["Ship", "sourcemaps proguard"],
   ["Manage", "tokens"],
   ["Talk to us", "support"],

package/package.json

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