tracksiy 0.9.0 → 0.9.1

package/dist/tracksiy.mjs

@@ -4,7 +4,7 @@
 import { readFileSync as readFileSync2 } from "node:fs";
 
 // src/version.ts
-var VERSION = true ? "0.9.0" : "0.0.0-dev";
+var VERSION = true ? "0.9.1" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -822,7 +822,7 @@ var monitorsList = {
     status: { type: "string", enum: ["all", "up", "down", "never"], description: "Filter by state. Default all." },
     type: { type: "string", enum: ["heartbeat", "get", "ping", "ssl", "ingest"], description: "Only this monitor type." }
   },
-  output: "{summary{total, up, down, never, unalertable}, monitors:[{id, name, project, monitorType, url, upNow, lastCheck, overdue, alertable, checkInUrl, downReason, lastCheckDetail{status, expectedStatus, bytes, truncated, expectedTextFound, forbiddenTextFound, error, ms}}], notes[]}",
+  output: "{summary{total, up, down, never, unalertable}, monitors:[{id, name, slug, project, monitorType, url, upNow, lastCheck, overdue, alertable, checkInUrl, downReason, lastCheckDetail{status, expectedStatus, bytes, truncated, expectedTextFound, forbiddenTextFound, error, ms}}], notes[]}",
   text: (d) => `${kv(d.summary ?? {})}
 
 ${table(d.monitors ?? [], [
@@ -1141,6 +1141,22 @@ var BUDGET_KEYS = {
   minSamples: "minSamples"
 };
 var NUMERIC = /* @__PURE__ */ new Set(["max", "windowMinutes", "minSamples"]);
+BUDGET_KEYS["window_minutes"] = "windowMinutes";
+BUDGET_KEYS["min_samples"] = "minSamples";
+function normalizeBudget(raw) {
+  const out = {};
+  for (const [key, value] of Object.entries(raw ?? {})) {
+    out[BUDGET_KEYS[key] ?? key] = value;
+  }
+  return out;
+}
+function budgetsBody(body) {
+  const wrapped = Array.isArray(body) ? { budgets: body } : body;
+  if (!wrapped || !Array.isArray(wrapped.budgets)) {
+    throw usageError("bad_value", '--body must be {"budgets": [...]} or a list of budgets.', `e.g. --body '{"budgets": [{"name": "init", "transaction": "GET /api/v1/init", "metric": "p95", "max": 800, "windowMinutes": 60}]}'`);
+  }
+  return { ...wrapped, budgets: wrapped.budgets.map(normalizeBudget) };
+}
 function parseBudget(raw) {
   const out = {};
   for (const part of String(raw).split(/,(?=\s*[\w-]+=)/)) {
@@ -1192,7 +1208,7 @@ var budgetsGet = {
 var budgetsSet = {
   path: ["budgets", "set"],
   summary: "Declare performance budgets: told once when one is crossed and once when it is met again.",
-  description: `The list replaces the stored one, by name (--merge keeps the others). Metrics: ${METRICS}. max is an upper bound: ms, a 0..1 ratio for failure_rate, unitless for cls. Below min-samples the verdict is unknown, never pass. Alerts go through the project's rules with performance on (the default).`,
+  description: `The list replaces the stored one, by name (--merge keeps the others). Metrics: ${METRICS}. max is an upper bound: ms, a 0..1 ratio for failure_rate, unitless for cls. Below min-samples the verdict is unknown, never pass. Alerts go through the project's rules with performance on (the default). --body takes the API's shape, {"budgets": [{"name", "metric", "max", "transaction"?, "op"?, "monitor"? (slug or id), "windowMinutes"?, "minSamples"?}]}, or a bare list; the flag spellings window and min-samples are accepted there too, and --dry-run and --merge apply to it.`,
   context: "project",
   effect: "write",
   idempotent: true,
@@ -1211,23 +1227,27 @@ var budgetsSet = {
   examples: [
     { command: "tracksiy budgets set --budget 'name=init,transaction=GET /api/v1/init,metric=p95,max=800'", description: "Told when the init call's p95 passes 800 ms over an hour." },
     { command: "tracksiy budgets set --merge --budget 'name=inp,op=ui.interaction,metric=inp,max=200,window=1440'", description: "INP p75 over a day, across every route; keeps the other budgets." },
-    { command: "tracksiy budgets set --merge --budget 'name=backup,monitor=db-backup-s3,metric=duration_p95,max=1200000,window=10080,min-samples=3'", description: "Told before the nightly backup gets near its max runtime." }
+    { command: "tracksiy budgets set --merge --budget 'name=backup,monitor=db-backup-s3,metric=duration_p95,max=1200000,window=10080,min-samples=3'", description: "Told before the nightly backup gets near its max runtime." },
+    { command: "tracksiy budgets set --body @tools/tracksiy/budgets.json --dry-run", description: "The whole declaration from a file; shows the changes, writes nothing." },
+    { command: "tracksiy budgets set --merge --budget 'name=site-ttfb,monitor=41,metric=ttfb_p95,max=800'", description: "A monitor by its id (from `monitors list`), for one whose name has spaces." }
   ],
   output: "The stored budgets and `changes` [{name, action}], same shape as `budgets get`.",
   text: budgetsText,
   async run(ctx) {
     const path = await projectPath(ctx, "budgets");
     const i = ctx.input;
-    if (i.body) return ctx.api.send("PUT", path, i.body);
-    if (!i.budget?.length && !i.merge) throw usageError("missing_flag", "No --budget given.", `Pass --budget ... (repeatable), or --body. To delete every budget: --body '{"budgets": []}'.`);
-    let budgets = (i.budget ?? []).map(parseBudget);
+    if (!i.body && !i.budget?.length && !i.merge) throw usageError("missing_flag", "No --budget given.", `Pass --budget ... (repeatable), or --body. To delete every budget: --body '{"budgets": []}'.`);
+    const fromBody = i.body ? budgetsBody(i.body) : void 0;
+    let budgets = fromBody ? fromBody.budgets : (i.budget ?? []).map(parseBudget);
+    if (fromBody && i.budget?.length) budgets = [...budgets, ...i.budget.map(parseBudget)];
     if (i.merge) {
       const current = await ctx.api.get(path);
       const named = new Set(budgets.map((b) => b.name));
       const kept = (current.budgets ?? []).filter((b) => !named.has(b.name)).map((b) => compact({ name: b.name, transaction: b.transaction ?? void 0, op: b.op ?? void 0, monitor: b.monitor ?? void 0, metric: b.metric, max: b.max, windowMinutes: b.windowMinutes, minSamples: b.minSamples }));
       budgets = [...kept, ...budgets];
     }
-    return ctx.api.send("PUT", path, compact({ budgets, dryRun: i.dryRun }));
+    const dryRun = i.dryRun || fromBody?.dryRun || void 0;
+    return ctx.api.send("PUT", path, compact({ budgets, dryRun }));
   }
 };
 var budgetsCheck = {
@@ -1294,7 +1314,7 @@ var monitorsTiming = {
   context: "project",
   effect: "read",
   endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/monitors/{slug}/timing" },
-  args: [{ name: "slug", required: true, description: "The monitor's slug (its name)." }],
+  args: [{ name: "slug", required: true, description: "The monitor's slug (its name; quote it when it has spaces), or its id from `monitors list`." }],
   flags: { since: { type: "string", value: TIME, description: "Default 24h for HTTP, 7d for jobs; compared with the window before." } },
   examples: [
     { command: "tracksiy monitors timing home", description: "Is the home page slow at the server, or on the wire?" },

package/package.json

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