tracksiy 0.3.0 → 0.5.0

package/README.md

@@ -126,6 +126,7 @@ Labels: `bug`, `feature`, `question`, `blocker`. `npx tracksiy support` prints t
 | `monitors declare` | Declare monitors for a project up front, idempotently: heartbeats for jobs, HTTP checks, TLS, ingest silence. | write | `monitors_declare` |
 | `monitors delete <slug>` | Remove one of a project's monitors by the slug it was declared with. | **destructive** | `monitors_delete` |
 | `performance` | Is this project slow, and did it get slower? Transactions compared with the previous window, plus uptime. | read | `performance` |
+| `queries` | Which database queries and outbound HTTP calls make this project slow, with N+1 detection and the routes that run them. | read | `queries` |
 | `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.3.0" : "0.0.0-dev";
+var VERSION = true ? "0.5.0" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -851,10 +851,16 @@ var monitorsDeclare = {
     ssl: { type: "list", value: "<slug>=<url>", description: "TLS certificate check (expiry is reported on every check)." },
     ingest: { type: "list", value: "<slug>[:<surface>]", description: "Alert when this project (or surface) stops sending events." },
     interval: { type: "integer", value: "<seconds>", description: "Interval for --get/--ping/--ssl/--ingest monitors." },
+    "expect-text": { type: "string", value: "<text>", description: "--get: down unless the body contains this (a 200 with an empty shell is down)." },
+    "expect-no-text": { type: "string", value: "<text>", description: "--get: down if the body contains this, e.g. Whoops or Exception." },
+    "user-agent": { type: "string", value: "<ua>", description: "--get/--ping: ask as this User-Agent, e.g. GPTBot/1.0, to see what crawlers get." },
+    "dry-run": { type: "boolean", description: "Show what would be created, adopted or changed; write nothing." },
     body: { type: "json", value: "<json|@file|->", description: "Raw request body; overrides the shorthand flags." }
   },
   examples: [
-    { command: "tracksiy monitors declare --heartbeat nightly-backup:93600 --get site=https://example.com", description: "A backup heartbeat and a homepage check." }
+    { command: "tracksiy monitors declare --heartbeat nightly-backup:93600 --get site=https://example.com", description: "A backup heartbeat and a homepage check." },
+    { command: "tracksiy monitors declare --get tr-landing=https://example.com/tr --expect-text '<h1' --expect-no-text Whoops --user-agent GPTBot/1.0", description: "The page as an answer engine gets it: real content, no error template." },
+    { command: "tracksiy monitors declare --heartbeat tariff-sync:608400 --dry-run", description: "See the change before making it." }
   ],
   output: "Server result per monitor, including check-in URLs for heartbeats.",
   async run(ctx) {
@@ -870,7 +876,17 @@ var monitorsDeclare = {
         for (const item of i[type] ?? []) {
           const eq = String(item).indexOf("=");
           if (eq < 1) throw usageError("bad_value", `--${type} expects <slug>=<url>, got ${JSON.stringify(item)}`);
-          monitors.push(compact({ slug: item.slice(0, eq), type, url: item.slice(eq + 1), intervalSeconds: i.interval }));
+          monitors.push(
+            compact({
+              slug: item.slice(0, eq),
+              type,
+              url: item.slice(eq + 1),
+              intervalSeconds: i.interval,
+              expectText: type === "get" ? i.expectText : void 0,
+              expectNoText: type === "get" ? i.expectNoText : void 0,
+              userAgent: type !== "ssl" ? i.userAgent : void 0
+            })
+          );
         }
       }
       for (const item of i.ingest ?? []) {
@@ -880,6 +896,7 @@ var monitorsDeclare = {
       if (!monitors.length) throw usageError("missing_flag", "Nothing to declare.", "Add --heartbeat, --get, --ping, --ssl, --ingest, or --body.");
       body = { monitors };
     }
+    if (i.dryRun) body = { ...body, dryRun: true };
     return ctx.api.send("POST", await projectPath(ctx, "monitors"), body);
   }
 };
@@ -904,16 +921,26 @@ var performance = {
   effect: "read",
   endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/performance" },
   flags: {
-    since: { type: "string", value: TIME, description: "Window start (default: server's, 24h)." },
-    op: { type: "string", value: "<op>", description: "Only this operation, e.g. http.server." },
-    sort: { type: "string", value: "<key>", description: "Order (server default: slower first)." },
-    limit: { type: "integer", value: "<n>", description: "How many transactions." }
+    since: { type: "string", value: TIME, description: "Window start (default: server's, 24h; 7d with --release)." },
+    op: { type: "string", value: "<op>", description: "Only this operation, e.g. http.server or pageload." },
+    sort: { type: "string", enum: ["slower", "duration", "p95", "failures"], description: "Order (default: slower first)." },
+    limit: { type: "integer", value: "<n>", description: "How many transactions." },
+    release: { type: "string", value: "<version>", description: "Compare this release's transactions with --against instead of two time windows." },
+    against: { type: "string", value: "<version>", description: "The release to compare with (default: the one before --release)." }
   },
-  output: "{since, until, transactions:[{transaction, op, current{...}, previous{...}, changeRatio, slower}], uptime[...], blindSpots[...]}",
+  examples: [
+    { command: "tracksiy performance --sort p95", description: "The slowest routes by p95." },
+    { command: "tracksiy performance --release web@$(git rev-parse HEAD)", description: "Did this deploy make anything slower or failing?" },
+    { command: "tracksiy performance --op pageload --select transactions.transaction,transactions.current.webVitals", description: "Core Web Vitals (p75) per page." }
+  ],
+  output: "{since, until, release?, againstRelease?, transactions:[{transaction, op, current{count, avgDurationMs, p50Ms, p95Ms, p99Ms, failureRate, failed, status, webVitals}, previous{...}, changeRatio, slower}], uptime[...], blindSpots[...]}",
   text: (d) => `${table(d.transactions ?? [], [
     "transaction",
     "op",
-    ["p95 ms", (r) => r.current?.p95Ms ?? r.current?.p95 ?? "-"],
+    ["p50", (r) => r.current?.p50Ms ?? "-"],
+    ["p95", (r) => r.current?.p95Ms ?? "-"],
+    ["p99", (r) => r.current?.p99Ms ?? "-"],
+    ["fail", (r) => r.current?.failureRate == null ? "-" : `${(r.current.failureRate * 100).toFixed(1)}%`],
     ["count", (r) => r.current?.count ?? "-"],
     ["change", (r) => r.changeRatio == null ? "-" : `${r.changeRatio > 0 ? "+" : ""}${Math.round(r.changeRatio * 100)}%`],
     ["slower", (r) => r.slower]
@@ -926,13 +953,55 @@ ${table(d.uptime, ["name", "url", "upNow", "avgResponseMs", "downChecks"])}` : "
       since: since(ctx.input.since),
       op: ctx.input.op,
       sort: ctx.input.sort,
+      limit: ctx.input.limit,
+      release: ctx.input.release,
+      against: ctx.input.against
+    });
+  }
+};
+var queries = {
+  path: ["queries"],
+  aliases: [["performance", "queries"]],
+  summary: "Which database queries and outbound HTTP calls make this project slow, with N+1 detection and the routes that run them.",
+  description: "Aggregated from the spans of sampled transactions (op db* and http.client), normalized so no literal is stored. Ranked by total time by default: the query that costs the most overall. nPlusOne marks a query one request ran 10+ times.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/queries" },
+  flags: {
+    since: { type: "string", value: TIME, description: "Window start (default 24h)." },
+    op: { type: "string", value: "<db|http.client|op>", description: "db (every db* op), http.client, or an exact op." },
+    transaction: { type: "string", value: "<route>", description: "Only queries run by this transaction, e.g. /orders." },
+    sort: { type: "string", enum: ["total", "avg", "max", "count", "perTransaction"], description: "Order (default total)." },
+    limit: { type: "integer", value: "<n>", description: "How many (max 100)." }
+  },
+  examples: [
+    { command: "tracksiy queries --since 24h", description: "The queries that cost the most time today." },
+    { command: "tracksiy queries --sort perTransaction --select queries.query,queries.maxPerTransaction,queries.routes", description: "N+1 candidates." }
+  ],
+  output: "{since, until, queries:[{fingerprint, op, query, count, transactions, perTransaction, maxPerTransaction, totalMs, avgMs, maxMs, previous{count, avgMs}, changeRatio, nPlusOne, routes[{transaction, count, avgMs}]}], note}",
+  text: (d) => table(d.queries ?? [], [
+    ["total ms", (r) => r.totalMs],
+    ["avg", (r) => r.avgMs ?? "-"],
+    ["max", (r) => r.maxMs],
+    ["count", (r) => r.count],
+    ["per req", (r) => r.perTransaction],
+    ["n+1", (r) => r.nPlusOne ? "yes" : ""],
+    ["query", (r) => String(r.query).slice(0, 90)]
+  ]),
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, "queries"), {
+      since: since(ctx.input.since),
+      op: ctx.input.op,
+      transaction: ctx.input.transaction,
+      sort: ctx.input.sort,
       limit: ctx.input.limit
     });
   }
 };
-var fleet_default = [orgs, projects, overview, changes, health, monitorsList, monitorsDeclare, monitorsDelete, performance];
+var fleet_default = [orgs, projects, overview, changes, health, monitorsList, monitorsDeclare, monitorsDelete, performance, queries];
 
 // src/commands/issues.ts
+import { writeFileSync } from "node:fs";
 var FILTERS = {
   status: { type: "string", enum: ["unresolved", "resolved", "ignored", "regressed", "all"], description: "Issue status. Server default: unresolved." },
   level: { type: "string", enum: ["sample", "debug", "info", "warning", "error", "fatal"], description: "Only this level." },
@@ -942,7 +1011,9 @@ var FILTERS = {
   since: { type: "string", value: TIME, description: "Last seen at or after this (lastSeenSince)." },
   until: { type: "string", value: TIME, description: "Last seen before this (lastSeenBefore)." },
   "first-seen-since": { type: "string", value: TIME, description: "First seen at or after this: new issues only." },
-  "first-seen-until": { type: "string", value: TIME, description: "First seen before this." }
+  "first-seen-until": { type: "string", value: TIME, description: "First seen before this." },
+  "exclude-bots": { type: "boolean", description: "Leave out issues every event of which came from a crawler (ClaudeBot, Googlebot, ...)." },
+  "only-bots": { type: "boolean", description: "Only issues that came entirely from crawlers." }
 };
 var WHY = {
   reason: { type: "string", enum: ["fixed", "duplicate", "third_party", "expected", "wont_fix"], description: "Why, recorded on the issue's activity log." },
@@ -974,7 +1045,8 @@ function filterQuery(input) {
     lastSeenSince: since(input.since),
     lastSeenBefore: since(input.until, "until"),
     firstSeenSince: since(input.firstSeenSince, "first-seen-since"),
-    firstSeenBefore: since(input.firstSeenUntil, "first-seen-until")
+    firstSeenBefore: since(input.firstSeenUntil, "first-seen-until"),
+    bots: input.excludeBots ? "exclude" : input.onlyBots ? "only" : void 0
   });
 }
 var issueRows = (issues) => table(issues ?? [], [
@@ -1202,11 +1274,13 @@ var bulk = {
   effect: "write",
   endpoint: { method: "POST", path: "/api/agent/v1/projects/{org}/{project}/issues/status" },
   flags: {
-    to: { type: "string", required: true, enum: ["resolved", "ignored", "unresolved"], description: "New status." },
+    to: { type: "string", enum: ["resolved", "ignored", "unresolved"], description: "New status (required unless --revert)." },
     ids: { type: "list", value: "<id,...>", description: "Exactly these issues." },
     ...FILTERS,
     all: { type: "boolean", description: "Every issue of the project (required when no other selector is given)." },
     apply: { type: "boolean", description: "Actually change them. Default is a dry run." },
+    out: { type: "string", value: "<file.json>", description: "With --apply: write every changed issue and its previous status here, for --revert." },
+    revert: { type: "string", value: "<file.json>", description: "Undo a saved --out: put each issue back to the status it had." },
     ...FIXED_IN,
     ...WHY
   },
@@ -1216,6 +1290,18 @@ var bulk = {
   ],
   output: "{dryRun, matched, changed, ids, ...} as reported by the server.",
   async run(ctx) {
+    if (ctx.input.revert) {
+      const saved = JSON.parse(textArg(`@${ctx.input.revert}`, "revert") ?? "{}");
+      const changes2 = saved.changed ?? saved;
+      const byStatus = /* @__PURE__ */ new Map();
+      for (const c of changes2) if (c?.id && c.previousStatus) byStatus.set(c.previousStatus, [...byStatus.get(c.previousStatus) ?? [], String(c.id)]);
+      const results = {};
+      for (const [status2, ids] of byStatus) {
+        results[status2] = await ctx.api.send("POST", await projectPath(ctx, "issues/status"), { status: status2, ids, dryRun: !ctx.input.apply, note: textArg(ctx.input.note, "note") ?? `revert of ${ctx.input.revert}` });
+      }
+      return { reverted: changes2.length, dryRun: !ctx.input.apply, results };
+    }
+    if (!ctx.input.to) throw usageError("missing_flag", "--to is required.", "Pass --to resolved|ignored|unresolved, or --revert <file>.");
     const filter = filterQuery(ctx.input);
     const hasFilter = Object.keys(filter).length > 0;
     const body = compact({
@@ -1226,7 +1312,12 @@ var bulk = {
       dryRun: !ctx.input.apply,
       ...whyBody(ctx.input)
     });
-    return ctx.api.send("POST", await projectPath(ctx, "issues/status"), body);
+    const result = await ctx.api.send("POST", await projectPath(ctx, "issues/status"), body);
+    if (ctx.input.out && ctx.input.apply) {
+      writeFileSync(ctx.input.out, JSON.stringify({ at: (/* @__PURE__ */ new Date()).toISOString(), status: ctx.input.to, changed: result?.changed ?? [] }, null, 2));
+      ctx.log(`wrote ${result?.changed?.length ?? 0} change(s) to ${ctx.input.out}; undo with --revert ${ctx.input.out} --apply`);
+    }
+    return result;
   }
 };
 var issues_default = [list, view, resolve2, ignore, unresolve, bulk, comment, activity, verifyFixed, claim, unclaim];
@@ -3101,7 +3192,7 @@ var COMMANDS = [
 ];
 var GROUPS = [
   ["Start", "init auth onboarding describe"],
-  ["Look", "overview changes health orgs projects issues monitors performance releases alerts keys artifacts"],
+  ["Look", "overview changes health orgs projects issues monitors performance queries releases alerts keys artifacts"],
   ["Ship", "sourcemaps proguard"],
   ["Manage", "tokens"],
   ["Talk to us", "support"],

package/package.json

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