@uic-coe-connect/cli 0.8.0 → 0.9.0

package/dist/commands/reports.js

@@ -1,3 +1,5 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { basename } from "node:path";
 import { CliError } from "../client.js";
 import { details, emit, info, table } from "../output.js";
 import { register } from "../registry.js";
@@ -14,6 +16,31 @@ import { register } from "../registry.js";
  */
 const STATUSES = ["open", "planned", "in-progress", "done", "declined"];
 const CLOSED = ["done", "declined"];
+function humanSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/** Every file on the thread, wherever it hangs — the whole list is what you search. */
+function allAttachments(report) {
+    return [...(report.attachments ?? []), ...(report.comments ?? []).flatMap((c) => c.attachments ?? [])];
+}
+/** Match an attachment by id or by filename, the way `files download` matches. */
+function findAttachment(report, ref) {
+    const all = allAttachments(report);
+    const byId = all.find((a) => a.id === ref);
+    if (byId)
+        return byId;
+    const matches = all.filter((a) => a.name.toLowerCase().includes(ref.toLowerCase()));
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        throw new CliError(`"${ref}" matches ${matches.length} attachments: ${matches.map((a) => a.name).join(", ")}`, 4, "Use the exact attachment id.");
+    }
+    throw new CliError(`No attachment "${ref}" on that report.`, 4, all.length === 0 ? "It has no attachments." : `It has: ${all.map((a) => a.name).join(", ")}`);
+}
 function assertStatus(value) {
     if (!STATUSES.includes(value)) {
         throw new CliError(`Unknown status "${value}".`, 6, `Use one of: ${STATUSES.join(", ")}`);
@@ -120,10 +147,21 @@ export function registerReportCommands() {
                     ...(r.pageUrl ? [["Page", r.pageUrl]] : []),
                 ]);
                 process.stdout.write(`\n${r.body}\n`);
+                for (const a of r.attachments ?? []) {
+                    process.stdout.write(`  [attachment] ${a.name} (${humanSize(a.size)}) ${a.id}\n`);
+                }
                 for (const comment of r.comments ?? []) {
                     const change = comment.statusTo ? ` [→ ${comment.statusTo}]` : "";
                     process.stdout.write(`\n--- ${comment.authorName ?? comment.authorNetid} · ${comment.createdAt}${change}\n` +
                         (comment.body ? `${comment.body}\n` : ""));
+                    for (const a of comment.attachments ?? []) {
+                        process.stdout.write(`  [attachment] ${a.name} (${humanSize(a.size)}) ${a.id}\n`);
+                    }
+                }
+                const files = allAttachments(r);
+                if (files.length > 0) {
+                    info("");
+                    info(`${files.length} attachment(s) — fetch one with: coe reports download ${r.id} <name>`);
                 }
                 if (!data.canRespond) {
                     info("");
@@ -162,14 +200,51 @@ export function registerReportCommands() {
             const { report } = await client().request("POST", `/reports/${id}/comments`, { body: args.flag("note") ?? "", status });
             emit({ report }, () => info(`✓ ${report.id} is now ${report.status}`));
         },
+    }, {
+        name: "reports attach",
+        summary: "Attach a file to a report",
+        usage: "reports attach <id> <path>",
+        details: [
+            "Screenshots, logs, spreadsheets — anything that shows the problem.",
+            "Up to 10 MB each, 20 per report. It lands on the report itself; use the",
+            "web UI to attach a file to one particular reply.",
+        ],
+        async run({ args, client }) {
+            const id = args.arg(0, "id");
+            const filePath = args.arg(1, "path");
+            let bytes;
+            try {
+                bytes = readFileSync(filePath);
+            }
+            catch (error) {
+                throw new CliError(`Can't read ${filePath}: ${error instanceof Error ? error.message : String(error)}`, 4);
+            }
+            const file = await client().upload(`/reports/${id}/attachments`, basename(filePath), bytes);
+            emit({ attachment: file }, () => info(`✓ Attached ${file.name} (${humanSize(file.size)}) to ${id}`));
+        },
+    }, {
+        name: "reports download",
+        summary: "Download an attachment from a report",
+        usage: "reports download <id> <name|attachment-id> [--out <path>]",
+        async run({ args, client }) {
+            const c = client();
+            const id = args.arg(0, "id");
+            const { report } = await c.request("GET", `/reports/${id}`);
+            const file = findAttachment(report, args.arg(1, "name"));
+            const bytes = await c.download(`/reports/${id}/attachments/${file.id}`);
+            const out = args.flag("out") ?? file.name;
+            writeFileSync(out, bytes);
+            emit({ reportId: id, attachment: file.name, out, bytes: bytes.length }, () => info(`✓ Wrote ${out} (${humanSize(bytes.length)})`));
+        },
     }, {
         name: "reports file",
         summary: "File a bug report or feature request",
-        usage: "reports file <app> <title> [--details <text>] [--request]",
+        usage: "reports file <app> <title> [--details <text>] [--request] [--attach <path>]",
         details: [
             "  <app>       The app it's about, or `coeconnect` for the portal itself",
             "  --details   The body of the report (defaults to the title)",
             "  --request   File it as a feature request rather than a bug",
+            "  --attach    A file to attach — a screenshot, a log excerpt",
         ],
         async run({ args, client }) {
             const c = client();
@@ -182,7 +257,22 @@ export function registerReportCommands() {
                 title,
                 body: args.flag("details") ?? title,
             });
-            emit({ report }, () => info(`✓ Filed ${report.id} — ${report.title}`));
+            // Attached after the report exists, because that is what it hangs off.
+            // A failure here must not read as "the report wasn't filed" — it was.
+            const attach = args.flag("attach");
+            let attachment = null;
+            if (attach) {
+                try {
+                    attachment = await c.upload(`/reports/${report.id}/attachments`, basename(attach), readFileSync(attach));
+                }
+                catch (error) {
+                    info(`✓ Filed ${report.id} — ${report.title}`);
+                    throw new CliError(`The report was filed, but ${attach} did not attach: ` +
+                        (error instanceof Error ? error.message : String(error)), 1, `Try again with: coe reports attach ${report.id} ${attach}`);
+                }
+            }
+            emit({ report, attachment }, () => info(`✓ Filed ${report.id} — ${report.title}` +
+                (attachment ? ` (attached ${attachment.name})` : "")));
         },
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uic-coe-connect/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "The coe CLI — manage COEConnect apps (pipelines, deploys, access, env) from a terminal, with browser-approved auth. Designed to be driven by an AI agent.",
   "type": "module",
   "bin": {