tracksiy 0.2.0 → 0.3.0

package/README.md

@@ -134,6 +134,7 @@ Labels: `bug`, `feature`, `question`, `blocker`. `npx tracksiy support` prints t
 | `issues bulk-status` | Change the status of every issue matching a filter. Dry run unless --apply. | write | `issues_bulk_status` |
 | `issues comment <id>` | Leave a comment on an issue for the next agent or human: what you found, what you tried. | write | `issues_comment` |
 | `issues activity <id>` | Who did what to an issue and why: resolutions (and in which release), regressions, comments, claims. | read | `issues_activity` |
+| `issues verify-fixed <id>` | Did the fix hold? Judged by the fix release's own traffic: fixed, regressed or undetermined. Exit 10 unless fixed. | read | `issues_verify_fixed` |
 | `issues claim <id>` | Take a lease on an issue so no other agent works on it meanwhile. Lapses on its own. | write | `issues_claim` |
 | `issues unclaim <id>` | Give back your lease on an issue. | write | `issues_unclaim` |
 | `projects create <name>` | Everything a new app needs in one idempotent call: the project, an ingest key per surface, an upload token, and the next steps. | write | `projects_create` |

package/dist/tracksiy.mjs

@@ -4,7 +4,7 @@
 import { readFileSync as readFileSync2 } from "node:fs";
 
 // src/version.ts
-var VERSION = true ? "0.2.0" : "0.0.0-dev";
+var VERSION = true ? "0.3.0" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -1122,6 +1122,40 @@ var activity = {
     return ctx.api.get(await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}/activity`), { limit: ctx.input.limit });
   }
 };
+var verifyFixed = {
+  path: ["issues", "verify-fixed"],
+  summary: "Did the fix hold? Judged by the fix release's own traffic: fixed, regressed or undetermined. Exit 10 unless fixed.",
+  description: "regressed: the issue has an event from the fix release or a newer one. undetermined: the fix release has had too little traffic (--min-traffic), or the issue's old rate predicts fewer than 3 occurrences in that traffic. fixed otherwise. The fix release defaults to the one the issue was resolved in. --wait polls until the verdict is not undetermined.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/issues/{issue_id}/verify" },
+  args: [{ name: "id", required: true, description: "Issue id." }],
+  flags: {
+    release: { type: "string", value: "<version>", description: "The fix release. Default: the one it was resolved in." },
+    "min-traffic": { type: "integer", value: "<n>", description: "Transactions + errors + sessions from the fix release needed before silence counts (default 100)." },
+    wait: { type: "integer", value: "<seconds>", description: "Poll every 30 s until fixed or regressed, up to this long." }
+  },
+  examples: [
+    { command: "tracksiy issues verify-fixed 4812", description: "Verdict now." },
+    { command: "tracksiy issues verify-fixed 4812 --wait 1800", description: "In a deploy script: wait up to 30 min for enough traffic." }
+  ],
+  output: "{verdict, reason, release, since, eventsSince, staleEvents, traffic{transactions, errors, sessions, total}, baselinePer1000, expectedEvents, latestEvent?}",
+  text: (d) => kv(d, ["verdict", "reason", "release", "since", "eventsSince", "staleEvents", "expectedEvents"]) + `
+traffic: ${d.traffic?.total ?? 0} (${d.traffic?.transactions ?? 0} transactions, ${d.traffic?.errors ?? 0} errors, ${d.traffic?.sessions ?? 0} sessions)`,
+  async run(ctx) {
+    const path = await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}/verify`);
+    const query = { release: ctx.input.release, minTraffic: ctx.input.minTraffic };
+    const deadline = Date.now() + (ctx.input.wait ?? 0) * 1e3;
+    let data = await ctx.api.get(path, query);
+    while (data?.verdict === "undetermined" && Date.now() + 3e4 <= deadline) {
+      ctx.log(`undetermined: ${data.reason} -- checking again in 30 s`);
+      await new Promise((r) => setTimeout(r, 3e4));
+      data = await ctx.api.get(path, query);
+    }
+    if (data?.verdict !== "fixed") throw new CheckFailed(`${data?.verdict ?? "unknown"}: ${data?.reason ?? ""}`, data, data?.verdict === "regressed" ? "Reopened by its own release: look at latestEvent." : "Wait for traffic (--wait), or lower --min-traffic.");
+    return data;
+  }
+};
 var claim = {
   path: ["issues", "claim"],
   summary: "Take a lease on an issue so no other agent works on it meanwhile. Lapses on its own.",
@@ -1195,7 +1229,7 @@ var bulk = {
     return ctx.api.send("POST", await projectPath(ctx, "issues/status"), body);
   }
 };
-var issues_default = [list, view, resolve2, ignore, unresolve, bulk, comment, activity, claim, unclaim];
+var issues_default = [list, view, resolve2, ignore, unresolve, bulk, comment, activity, verifyFixed, claim, unclaim];
 
 // src/commands/projects.ts
 var create = {
@@ -1294,12 +1328,12 @@ var onboarding = {
 var projects_default = [create, verify, onboarding];
 
 // src/commands/alerts.ts
-var RECIPIENT_TYPES = ["email", "webhook", "discord", "googlechat", "telegram"];
+var RECIPIENT_TYPES = ["email", "webhook", "discord", "googlechat", "telegram", "peerpacket"];
 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).`
+    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).`
   },
   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." },
@@ -1376,7 +1410,8 @@ var set = {
   flags: DECLARE,
   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 '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." }
   ],
   output: "The stored alerting state, same shape as `alerts get`.",
   text: rulesText,

package/package.json

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