tracksiy 0.11.0 → 0.12.0

package/README.md

@@ -143,6 +143,10 @@ Labels: `bug`, `feature`, `question`, `blocker`. `npx tracksiy support` prints t
 | `logs patterns` | The loudest log lines, counted across their values (message template, or the body with numbers and ids blanked). | read | `logs_patterns` |
 | `logs stats` | Log counts per level per minute, hour or day. | read | `logs_stats` |
 | `issues logs <id>` | What the app logged around an error: the logs in the traces of the issue's last events. | read | `issues_logs` |
+| `user-feedback` | What users wrote through the feedback widget or API: message, page or screen, release, device, the issue it is about and its screenshots. | read | `user_feedback` |
+| `issues attachments <id>` | Screenshots, view hierarchies and files of an issue's recent events and of the feedback about it. | read | `issues_attachments` |
+| `attachments get <id>` | Save one attachment (a screenshot, a view hierarchy) to a file -- or print a JSON one. | read | `attachments_get` |
+| `issues flags <id>` | Feature flag values of an issue's events against the rest of the project; `suspect` marks a value far more common in this issue. | read | `issues_flags` |
 | `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.11.0" : "0.0.0-dev";
+var VERSION = true ? "0.12.0" : "0.0.0-dev";
 var USER_AGENT = `tracksiy-cli/${VERSION} (node ${process.versions.node}; ${process.platform})`;
 
 // src/core/errors.ts
@@ -149,7 +149,7 @@ var Api = class {
           continue;
         }
       }
-      const data = await readBody(res);
+      const data = opts.binary && res.ok ? new Uint8Array(await res.arrayBuffer()) : await readBody(res);
       const ok = opts.accept ? opts.accept.includes(res.status) : res.ok;
       if (ok) return { status: res.status, data, headers: res.headers };
       throw await this.httpError(method, path, res, data);
@@ -1050,7 +1050,7 @@ var settingsGet = {
   context: "project",
   effect: "read",
   endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/settings" },
-  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}}",
+  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}, attachments{store, maxKb, quotaMb, retentionDays}}",
   async run(ctx) {
     return ctx.api.get(await projectPath(ctx, "settings"));
   }
@@ -1093,6 +1093,10 @@ var settingsSet = {
     logs: { type: "boolean", description: "Store structured logs at all (default on). --no-logs drops them, counted as log:disabled." },
     "logs-min-level": { type: "string", enum: ["trace", "debug", "info", "warn", "error", "fatal"], description: "Drop log lines below this level at ingest (default trace)." },
     "logs-daily-limit": { type: "integer", value: "<n>", description: "At most this many log lines a day (default 100000); the rest are dropped and counted as log:daily_limit." },
+    attachments: { type: "string", enum: ["off", "feedback", "all"], description: "Which attachments are kept: off, feedback (default: only what a user sent with their feedback), all (also crash screenshots, view hierarchies, files)." },
+    "attachment-max-kb": { type: "integer", value: "<kb>", description: "Largest attachment kept (default 5120)." },
+    "attachments-quota-mb": { type: "integer", value: "<mb>", description: "The project's attachment budget (default 500); past it new files are dropped (attachment:quota)." },
+    "attachments-retention-days": { type: "integer", value: "<days>", description: "Keep attachments this long (default 30)." },
     body: { type: "json", value: "<json|@file|->", description: "The whole declaration; overrides the flags." }
   },
   examples: [
@@ -1102,7 +1106,7 @@ var settingsSet = {
     { command: "tracksiy settings set --source-root 'strip=/var/www/shop/,prepend=backend/,surface=backend'", description: "The server checkout is only the repo's backend/ directory." },
     { command: "tracksiy settings set --max-events-per-issue 500 --sourcemap-keep-releases 5", description: "A noisy project keeps less on disk." }
   ],
-  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}}",
+  output: "{sourceRoots[], environments[], environmentPolicy, fingerprintRules[], privacyRules[], performanceIssues, storage{maxEventsPerIssue, sourcemapKeepReleases, sourcemapKeepUsedDays}, releaseHealth{crashFreeSessionsMin, minSessions, maxDropPct, velocityPct, velocityMinEvents}, logs{enabled, minLevel, dailyLimit}, attachments{store, maxKb, quotaMb, retentionDays}}",
   async run(ctx) {
     const path = await projectPath(ctx, "settings");
     const i = ctx.input;
@@ -1127,6 +1131,13 @@ var settingsSet = {
         ...i.logsMinLevel !== void 0 ? { minLevel: i.logsMinLevel } : {},
         ...i.logsDailyLimit !== void 0 ? { dailyLimit: i.logsDailyLimit } : {}
       },
+      attachments: {
+        ...current.attachments ?? {},
+        ...i.attachments !== void 0 ? { store: i.attachments } : {},
+        ...i.attachmentMaxKb !== void 0 ? { maxKb: i.attachmentMaxKb } : {},
+        ...i.attachmentsQuotaMb !== void 0 ? { quotaMb: i.attachmentsQuotaMb } : {},
+        ...i.attachmentsRetentionDays !== void 0 ? { retentionDays: i.attachmentsRetentionDays } : {}
+      },
       releaseHealth: {
         ...current.releaseHealth ?? {},
         ...i.crashFreeMin !== void 0 ? { crashFreeSessionsMin: i.crashFreeMin } : {},
@@ -1601,8 +1612,98 @@ ${d.notes.join("\n")}` : ""}`,
 };
 var logs_default = [list, patterns, stats, issueLogs];
 
-// src/commands/issues.ts
+// src/commands/evidence.ts
 import { writeFileSync } from "node:fs";
+var feedback = {
+  path: ["user-feedback"],
+  aliases: [["feedback", "list"]],
+  summary: "What users wrote through the feedback widget or API: message, page or screen, release, device, the issue it is about and its screenshots.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/feedback" },
+  flags: {
+    since: { type: "string", value: TIME, description: "Default 30 days." },
+    limit: { type: "integer", value: "<n>", description: "At most 200 (default 50)." }
+  },
+  examples: [{ command: "tracksiy user-feedback --since 7d", description: "This week's feedback; `attachments get <id>` saves a screenshot." }],
+  output: "{feedback:[{id, created, message, name, email, url, issueId, release, environment, source, os, device, attachments[{id, kind, name, contentType, size, url}]}]}",
+  text: (d) => table(d.feedback ?? [], [
+    ["when", (r) => ago(r.created)],
+    ["message", (r) => String(r.message ?? "").slice(0, 80)],
+    ["url", (r) => r.url ?? "-"],
+    ["release", (r) => r.release ?? "-"],
+    ["issue", (r) => r.issueId ?? "-"],
+    ["files", (r) => (r.attachments ?? []).map((a) => a.id).join(",") || "-"]
+  ]),
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, "feedback"), { since: since(ctx.input.since), limit: ctx.input.limit });
+  }
+};
+var issueAttachments = {
+  path: ["issues", "attachments"],
+  summary: "Screenshots, view hierarchies and files of an issue's recent events and of the feedback about it.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/issues/{id}/attachments" },
+  args: [{ name: "id", required: true, description: "The issue id." }],
+  output: "{issueId, attachments:[{id, eventId, kind, name, contentType, size, created, url}], notes[]}",
+  text: (d) => `${table(d.attachments ?? [], ["id", "kind", "name", "contentType", "size", ["when", (r) => ago(r.created)]])}${(d.notes ?? []).length ? `
+
+${d.notes.join("\n")}` : ""}`,
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}/attachments`));
+  }
+};
+var attachmentGet = {
+  path: ["attachments", "get"],
+  summary: "Save one attachment (a screenshot, a view hierarchy) to a file -- or print a JSON one.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/attachments/{id}" },
+  args: [{ name: "id", required: true, description: "The attachment id (from `feedback` or `issues attachments`)." }],
+  flags: { out: { type: "string", value: "<file>", description: "Where to write it. Without it, JSON and text are printed; binary needs --out." } },
+  examples: [{ command: "tracksiy attachments get 812 --out /tmp/screenshot.png", description: "Then look at the screenshot." }],
+  output: "{id, bytes, out} or the JSON / text content",
+  async run(ctx) {
+    if (!/^\d+$/.test(String(ctx.input.id ?? ""))) {
+      throw usageError("bad_value", `attachments get expects a numeric attachment id, got ${JSON.stringify(ctx.input.id)}.`, "Ids come from `user-feedback` or `issues attachments`.");
+    }
+    const path = await projectPath(ctx, `attachments/${encodeURIComponent(ctx.input.id)}`);
+    const bytes = await ctx.api.get(path, void 0, { binary: true });
+    if (ctx.input.out) {
+      writeFileSync(ctx.input.out, bytes);
+      return { id: ctx.input.id, bytes: bytes.length, out: ctx.input.out };
+    }
+    const text = new TextDecoder("utf-8", { fatal: false }).decode(bytes);
+    if (/[\u0000-\u0008\u000e-\u001f]/.test(text.slice(0, 512))) {
+      throw usageError("binary", `Attachment ${ctx.input.id} is binary (${bytes.length} bytes).`, "Pass --out <file> to save it.");
+    }
+    try {
+      return JSON.parse(text);
+    } catch {
+      return { id: ctx.input.id, text };
+    }
+  }
+};
+var issueFlags = {
+  path: ["issues", "flags"],
+  summary: "Feature flag values of an issue's events against the rest of the project; `suspect` marks a value far more common in this issue.",
+  context: "project",
+  effect: "read",
+  endpoint: { method: "GET", path: "/api/agent/v1/projects/{org}/{project}/issues/{id}/flags" },
+  args: [{ name: "id", required: true, description: "The issue id." }],
+  output: "{issueId, issueEvents, baselineEvents, flags:[{flag, suspect, suspectValue, values:[{result, issueShare, baselineShare}]}], notes[]}",
+  text: (d) => `${table(d.flags ?? [], ["flag", ["suspect", (r) => r.suspect ? `YES (${r.suspectValue})` : ""], ["values", (r) => (r.values ?? []).map((v) => `${v.result}: ${Math.round(v.issueShare * 100)}% vs ${v.baselineShare == null ? "-" : Math.round(v.baselineShare * 100) + "%"}`).join("  ")]])}${(d.notes ?? []).length ? `
+
+${d.notes.join("\n")}` : ""}`,
+  async run(ctx) {
+    return ctx.api.get(await projectPath(ctx, `issues/${encodeURIComponent(ctx.input.id)}/flags`));
+  }
+};
+var evidence_default = [feedback, issueAttachments, attachmentGet, issueFlags];
+
+// src/commands/issues.ts
+import { writeFileSync as writeFileSync2 } 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." },
@@ -1952,7 +2053,7 @@ var bulk = {
     });
     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));
+      writeFileSync2(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;
@@ -3923,6 +4024,7 @@ var COMMANDS = [
   ...storage_default,
   ...mobile_default,
   ...logs_default,
+  ...evidence_default,
   ...issues_default,
   ...projects_default,
   ...alerts_default,
@@ -3936,7 +4038,7 @@ var COMMANDS = [
 ];
 var GROUPS = [
   ["Start", "init auth onboarding describe"],
-  ["Look", "overview changes health storage orgs projects issues monitors performance mobile logs queries not-found releases alerts keys artifacts settings privacy-preview"],
+  ["Look", "overview changes health storage orgs projects issues monitors performance mobile logs user-feedback attachments queries not-found releases alerts keys artifacts settings privacy-preview"],
   ["Ship", "sourcemaps proguard"],
   ["Manage", "tokens"],
   ["Talk to us", "support"],

package/package.json

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