tracksiy 0.3.0 → 0.4.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.4.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,11 +953,52 @@ ${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
 var FILTERS = {
@@ -3101,7 +3169,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.4.0",
   "description": "Agent-first CLI and MCP server for Tracksiy: errors, uptime, alerts, releases and source maps, from one token.",
   "type": "module",
   "bin": {