tracksiy 0.6.0 → 0.7.0

package/README.md

@@ -125,6 +125,7 @@ Labels: `bug`, `feature`, `question`, `blocker`. `npx tracksiy support` prints t
 | `monitors list` | Every monitor of the organization with its state, including monitors no project owns. | read | `monitors_list` |
 | `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` |
+| `monitors deleted` | Monitors deleted from this project: what each was, its last check, when and by whom. | read | `monitors_deleted` |
 | `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` |
 | `not-found` | Which pages answer 404, and who links to them: broken internal links first. | read | `not_found` |

package/dist/tracksiy.mjs

@@ -4,7 +4,7 @@
 import { readFileSync as readFileSync2 } from "node:fs";
 
 // src/version.ts
-var VERSION = true ? "0.6.0" : "0.0.0-dev";
+var VERSION = true ? "0.7.0" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -846,7 +846,7 @@ var monitorsDeclare = {
   idempotent: true,
   endpoint: { method: "POST", path: "/api/agent/v1/projects/{org}/{project}/monitors" },
   flags: {
-    heartbeat: { type: "list", value: "<slug>[:<interval-seconds>]", description: "A job that must check in at least this often (default 86400 s)." },
+    heartbeat: { type: "list", value: "<slug>[:<interval-seconds>]", description: "A job that must check in at least this often (default 86400 s). `slug=seconds` works too." },
     get: { type: "list", value: "<slug>=<url>", description: "HTTP GET check expecting 200." },
     ping: { type: "list", value: "<slug>=<url>", description: "Reachability check." },
     ssl: { type: "list", value: "<slug>=<url>", description: "TLS certificate check (expiry is reported on every check)." },
@@ -871,8 +871,9 @@ var monitorsDeclare = {
     if (!body) {
       const monitors = [];
       for (const h of i.heartbeat ?? []) {
-        const [slug, interval] = String(h).split(":");
-        monitors.push(compact({ slug, type: "heartbeat", intervalSeconds: interval ? Number(interval) : void 0 }));
+        const m = /^([^:=\s]+)(?:[:=](\d+))?$/.exec(String(h).trim());
+        if (!m) throw usageError("bad_value", `--heartbeat expects <slug>[:<interval-seconds>], got ${JSON.stringify(h)}`, "For example --heartbeat nightly-backup:93600 (or nightly-backup=93600).");
+        monitors.push(compact({ slug: m[1], type: "heartbeat", intervalSeconds: m[2] ? Number(m[2]) : void 0 }));
       }
       for (const type of ["get", "ping", "ssl"]) {
         for (const item of i[type] ?? []) {
@@ -915,6 +916,24 @@ var monitorsDelete = {
   async run(ctx) {
     requireYes(ctx, `This deletes monitor ${ctx.input.slug} and its history.`);
     return ctx.api.send("DELETE", await projectPath(ctx, `monitors/${seg(ctx.input.slug)}${ctx.input.type ? `?type=${seg(ctx.input.type)}` : ""}`));
+  },
+  output: "{id, slug, type, url, intervalSeconds, lastCheck, lastIsUp, deleted, via, actor}: what was deleted; kept in `monitors deleted`."
+};
+var monitorsDeleted = {
+  path: ["monitors", "deleted"],
+  summary: "Monitors deleted from this project: what each was, its last check, when and by whom.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/monitor-deletions" },
+  flags: {
+    since: { type: "string", value: TIME, description: "Only deletions after this." },
+    limit: { type: "integer", value: "<n>", description: "How many (default 50)." }
+  },
+  examples: [{ command: "tracksiy monitors deleted --since 7d", description: "What `--prune`, `monitors delete` or the dashboard removed this week." }],
+  output: "{deleted:[{id, slug, type, url, intervalSeconds, lastCheck, lastIsUp, deleted, via, actor}]}",
+  text: (d) => table(d.deleted ?? [], ["slug", "type", "deleted", ["by", (r) => r.actor ?? r.via ?? ""], ["last check", (r) => r.lastCheck ? `${r.lastCheck}${r.lastIsUp === false ? " (down)" : ""}` : "never"]]),
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, "monitor-deletions"), { since: since(ctx.input.since), limit: ctx.input.limit });
   }
 };
 var performance = {
@@ -1054,15 +1073,16 @@ var settingsSet = {
   flags: {
     environments: { type: "list", value: "<env,...>", description: "The environments this project reports from (empty string: any)." },
     "environment-policy": { type: "string", enum: ["flag", "drop"], description: "What happens to an event from another environment." },
-    "source-root": { type: "list", value: "<path>", description: "A deployed-code prefix to strip from frame paths. Repeatable; replaces the list." },
-    "fingerprint-rule": { type: "list", value: "type=<glob>,message=<glob>,fingerprint=<name>", description: "Group matching events into one issue. Repeatable; replaces the list." },
-    "privacy-rule": { type: "list", value: "dropHeader=<name> | mask=<email|iban|card_number|tckn|jwt>,field=<path|*>", description: "Scrub before storage. Repeatable; replaces the list." },
+    "source-root": { type: "list", split: false, value: "<path> | strip=<path>,prepend=<dir/>[,surface=<surface>]", description: "How frame paths become repo paths: a prefix to strip, or strip + prepend (for an SDK that already sends /app/... of a repo's backend/), optionally for one surface. Repeatable; replaces the list." },
+    "fingerprint-rule": { type: "list", split: false, value: "type=<glob>,message=<glob>,fingerprint=<name>", description: "Group matching events into one issue. Repeatable; replaces the list." },
+    "privacy-rule": { type: "list", split: false, value: "dropHeader=<name> | mask=<email|iban|card_number|tckn|jwt>,field=<path|*>", description: "Scrub before storage. Repeatable; replaces the list." },
     body: { type: "json", value: "<json|@file|->", description: "The whole declaration; overrides the flags." }
   },
   examples: [
     { command: "tracksiy settings set --environments production,staging --environment-policy drop", description: "local and local1 stop reaching Tracksiy." },
     { command: "tracksiy settings set --fingerprint-rule 'type=ViewException,message=syntax error*,fingerprint=blade-syntax'", description: "Every half-written template is one issue." },
-    { command: "tracksiy settings set --source-root /home/admin/web/shop/", description: "Frames carry repoPath." }
+    { command: "tracksiy settings set --source-root /home/admin/web/shop/", description: "Frames carry repoPath." },
+    { command: "tracksiy settings set --source-root 'strip=/,prepend=backend/,surface=backend'", description: "Laravel sends /app/Http/...; the repo has it under backend/." }
   ],
   output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[]}",
   async run(ctx) {
@@ -1071,7 +1091,7 @@ var settingsSet = {
     if (i.body) return ctx.api.send("PUT", path, i.body);
     const current = await ctx.api.get(path);
     const next = {
-      sourceRoots: i.sourceRoot ?? current.sourceRoots ?? [],
+      sourceRoots: i.sourceRoot ? i.sourceRoot.map((r) => /^\s*strip=/.test(r) ? pairs([r], "source-root")[0] : r) : current.sourceRoots ?? [],
       environments: i.environments ? i.environments.filter((e) => e) : current.environments ?? [],
       environmentPolicy: i.environmentPolicy ?? current.environmentPolicy ?? "flag",
       fingerprintRules: pairs(i.fingerprintRule, "fingerprint-rule") ?? current.fingerprintRules ?? [],
@@ -1087,7 +1107,7 @@ var privacyPreview = {
   effect: "read",
   endpoint: { method: "POST", path: "/api/agent/v1/projects/{org}/{project}/settings/privacy-preview" },
   flags: {
-    "privacy-rule": { type: "list", value: "dropHeader=<name> | mask=<shape>,field=<path|*>", description: "Rules to try (default: the saved ones)." }
+    "privacy-rule": { type: "list", split: false, value: "dropHeader=<name> | mask=<shape>,field=<path|*>", description: "Rules to try (default: the saved ones)." }
   },
   examples: [{ command: "tracksiy privacy-preview --privacy-rule 'mask=email,field=request.headers.User-Agent'", description: "Would this clear the PII check?" }],
   output: "{sampled, rules[{rule, events, values}], remaining[{pattern, field, events}]}",
@@ -1096,7 +1116,7 @@ var privacyPreview = {
     return ctx.api.send("POST", await projectPath(ctx, "settings/privacy-preview"), rules ? { privacyRules: rules } : {});
   }
 };
-var fleet_default = [orgs, projects, overview, changes, health, monitorsList, monitorsDeclare, monitorsDelete, performance, queries, notFound, settingsGet, settingsSet, privacyPreview];
+var fleet_default = [orgs, projects, overview, changes, health, monitorsList, monitorsDeclare, monitorsDelete, monitorsDeleted, performance, queries, notFound, settingsGet, settingsSet, privacyPreview];
 
 // src/commands/issues.ts
 import { writeFileSync } from "node:fs";
@@ -1169,15 +1189,17 @@ var list = {
     frames: { type: "integer", value: "<n>", description: "In-app stack frames inlined per issue (default 3, 0 for none)." },
     unclaimed: { type: "boolean", description: "Only issues nobody holds a live claim on: what you can pick up." },
     cursor: { type: "string", value: "<nextCursor>", description: "Continue from the previous page's nextCursor (same filters and sort)." },
-    "claimed-by": { type: "string", value: "<handle>", description: "Only issues claimed by this handle." }
+    "claimed-by": { type: "string", value: "<handle>", description: "Only issues claimed by this handle." },
+    tags: { type: "string", value: "<key,...>", description: "Not a filter: each issue carries these tag keys' most frequent values in topTags (at most 10 keys)." }
   },
   examples: [
     { command: "tracksiy issues list --since 24h", description: "Unresolved issues seen in the last day." },
+    { command: "tracksiy issues list --tags endpoint,client_error_kind --select issues.id,issues.title,issues.topTags", description: "What each mobile issue hit, without opening every one." },
     { command: "tracksiy issues list --unclaimed --limit 5", description: "Five issues no other agent is working on." },
     { command: "tracksiy issues list --status regressed --select issues.id,issues.title", description: "Only regressions, only ids and titles." },
     { command: "tracksiy issues list --first-seen-since 2h --environment production", description: "What is new in production." }
   ],
-  output: "{project, issueCount, total, hasMore, nextCursor, issues:[{id, shortId, title, culprit, level, status, count, firstSeen, lastSeen, regressedAt, timesRegressed, resolution?, staleEvents, claimedBy?, claimedUntil?, permalink, frames?}]}",
+  output: "{project, issueCount, total, hasMore, nextCursor, issues:[{id, shortId, title, culprit, level, status, count, firstSeen, lastSeen, regressedAt, timesRegressed, resolution?, staleEvents, claimedBy?, claimedUntil?, permalink, latestEvent{release, environment, platform, exceptionType}, frames?, topTags?}]}",
   text: (d) => `${d.issueCount ?? d.issues?.length ?? 0} of ${d.total ?? "?"} issues${d.hasMore ? " (more: raise --limit)" : ""}
 ${issueRows(d.issues)}`,
   async run(ctx) {
@@ -1188,7 +1210,8 @@ ${issueRows(d.issues)}`,
       frames: ctx.input.frames,
       unclaimed: ctx.input.unclaimed || void 0,
       claimedBy: ctx.input.claimedBy,
-      cursor: ctx.input.cursor
+      cursor: ctx.input.cursor,
+      tags: ctx.input.tags
     });
   }
 };
@@ -1199,9 +1222,15 @@ var view = {
   effect: "read",
   endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/issues/{issue_id}" },
   args: [{ name: "id", required: true, description: "Issue id (numeric, from `issues list`)." }],
-  flags: { frames: { type: "integer", value: "<n>", description: "How many frames to include." } },
-  examples: [{ command: "tracksiy issues view 4812", description: "Everything needed to start fixing issue 4812." }],
-  output: "{id, title, culprit, level, status, count, firstSeen, lastSeen, resolution?, staleEvents, claimedBy?, latestEvent{release, environment, exceptionType, exceptionValue, contexts}, frames[{filename, function, lineno, contextLine, inApp}], tags[], eventsLast24h, eventsLast7d, activity[], recentComments[], permalink}",
+  flags: {
+    frames: { type: "integer", value: "<n>", description: "How many frames to include." },
+    breadcrumbs: { type: "integer", value: "<n>", description: "Breadcrumbs of the latest event (default 20, at most 50, 0 for none): what happened just before it." }
+  },
+  examples: [
+    { command: "tracksiy issues view 4812", description: "Everything needed to start fixing issue 4812." },
+    { command: "tracksiy issues view 4812 --select latestEvent.breadcrumbs", description: "The requests and navigations that led up to it." }
+  ],
+  output: "{id, title, culprit, level, status, count, firstSeen, lastSeen, resolution?, staleEvents, claimedBy?, latestEvent{release, environment, platform, exceptionType, exceptionValue, commit, contexts, breadcrumbs[{timestamp, type, category, level, message, data}]}, frames[{filename, function, lineno, contextLine, inApp}], tags[], eventsLast24h, eventsLast7d, activity[], recentComments[], permalink}",
   text: (d) => {
     const head = kv(d, ["id", "shortId", "title", "culprit", "level", "status", "count", "eventsLast24h", "eventsLast7d", "firstSeen", "lastSeen", "regressedAt", "permalink"]);
     const ev = d.latestEvent ? `
@@ -1214,14 +1243,17 @@ resolved ${d.resolution.type.replace(/_/g, " ")}: ${d.resolution.release ?? d.re
     const claim2 = d.claimedBy ? `
 claimed by ${d.claimedBy} until ${d.claimedUntil}` : "";
     const act = (d.activity ?? []).slice(0, 5).map((a) => `  ${ago(a.at)} ${a.action}${a.reason ? ` (${a.reason})` : ""} by ${a.actor ?? a.user ?? a.via}${a.note ? `: ${String(a.note).split("\n")[0].slice(0, 100)}` : ""}`).join("\n");
+    const crumbs = (d.latestEvent?.breadcrumbs ?? []).slice(-8).map((b) => `  ${b.category ?? b.type ?? "-"}${b.data?.status_code ? ` ${b.data.status_code}` : ""} ${b.message ?? [b.data?.method, b.data?.url ?? b.data?.to].filter(Boolean).join(" ")}`).join("\n");
     return `${head}${res}${claim2}${ev}${frames ? `
 frames (* = in app):
-${frames}` : ""}${act ? `
+${frames}` : ""}${crumbs ? `
+breadcrumbs (last 8, oldest first):
+${crumbs}` : ""}${act ? `
 activity:
 ${act}` : ""}`;
   },
   async run(ctx) {
-    return ctx.api.get(await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}`), { frames: ctx.input.frames });
+    return ctx.api.get(await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}`), { frames: ctx.input.frames, breadcrumbs: ctx.input.breadcrumbs });
   }
 };
 function statusCommand(name, status2, summary, examples) {
@@ -1547,7 +1579,7 @@ var DECLARE = {
   recipient: {
     type: "list",
     value: "email|<type>:<url>",
-    description: `Who is told. Repeatable. \`email\` alone reaches the members of the project's teams; webhook, discord, googlechat and telegram take a URL: \`<type>:<url>\` (telegram: the Bot API sendMessage URL with chat_id; peerpacket: https://peerpacket.com/channels/<channel>?to=<handle>&as=<author>&key=<pp_live_\u2026> -- each alert becomes a ticket for that agent, closed when its issues are resolved).`
+    description: `Who is told. Repeatable. \`email\` alone reaches the members of the project's teams; webhook, discord, googlechat and telegram take a URL: \`<type>:<url>\` (telegram: the Bot API sendMessage URL with chat_id; peerpacket: \`peerpacket:<channel>?to=<handle>\` has Tracksiy open the ticket with its own key, for a channel opened to your organization; or https://peerpacket.com/channels/<channel>?to=<handle>&as=<author>&key=<pp_live_\u2026> with your own key -- each alert becomes a ticket for that agent, closed when its issues are resolved).`
   },
   delivery: { type: "string", enum: ["immediate", "digest"], description: "For --recipient: send each alert now, or batch into the digest hours. Default immediate." },
   "new-issue": { type: "boolean", description: "Alert on every new issue (default true). --no-new-issue to turn off." },
@@ -1569,6 +1601,9 @@ function recipients(list5, delivery) {
       return compact({ type, delivery });
     }
     if (!target) throw usageError("bad_value", `--recipient ${raw} has no target`, `Format: ${type}:<url>`);
+    if (type === "peerpacket" && !target.includes("://") && !target.startsWith("peerpacket:")) {
+      return compact({ type, url: `peerpacket:${target}`, delivery });
+    }
     return compact({ type, url: target, delivery });
   });
 }
@@ -1625,7 +1660,8 @@ var set = {
   examples: [
     { command: "tracksiy alerts set --recipient email --threshold 50/10", description: "Email the project's team on new issues, on bursts, and on downtime." },
     { command: "tracksiy alerts set --recipient 'telegram:https://api.telegram.org/bot<token>/sendMessage?chat_id=<id>' --delivery digest", description: "Telegram, batched into the digest hours." },
-    { command: "tracksiy alerts set --recipient 'peerpacket:https://peerpacket.com/channels/shop-ops?to=shop-agent&as=tracksiy-alerts&key=pp_live_\u2026'", description: "Alerts land as PeerPacket tickets for the shop's agent." }
+    { command: "tracksiy alerts set --recipient 'peerpacket:shop-ops?to=shop-agent'", description: "Alerts land as PeerPacket tickets for the shop's agent, opened by Tracksiy's own key (no workspace key in the config)." },
+    { command: "tracksiy alerts set --recipient 'peerpacket:https://peerpacket.com/channels/shop-ops?to=shop-agent&as=tracksiy-alerts&key=pp_live_\u2026'", description: "The same with your own PeerPacket key." }
   ],
   output: "The stored alerting state, same shape as `alerts get`.",
   text: rulesText,
@@ -2734,7 +2770,7 @@ function coerce(name, spec, value, previous) {
       return n;
     }
     case "list": {
-      const items = Array.isArray(value) ? value.map(String) : String(value).split(",").map((s) => s.trim()).filter(Boolean);
+      const items = Array.isArray(value) ? value.map(String) : spec.split === false ? [String(value).trim()].filter(Boolean) : String(value).split(",").map((s) => s.trim()).filter(Boolean);
       if (spec.enum) for (const item of items) checkEnum(name, spec, item);
       return [...previous ?? [], ...items];
     }

package/package.json

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