@higherdev/cli 0.25.0 → 0.26.0

package/dist/attachments.js

@@ -0,0 +1,133 @@
+import { readFile, stat } from "node:fs/promises";
+import { isAbsolute, basename, extname } from "node:path";
+import { loadConfig } from "./config.js";
+const MIME = {
+    ".avif": "image/avif", ".bmp": "image/bmp", ".gif": "image/gif", ".heic": "image/heic",
+    ".heif": "image/heif", ".jpeg": "image/jpeg", ".jpg": "image/jpeg", ".png": "image/png",
+    ".tif": "image/tiff", ".tiff": "image/tiff", ".webp": "image/webp", ".pdf": "application/pdf", ".txt": "text/plain",
+    ".text": "text/plain", ".md": "text/markdown", ".markdown": "text/markdown",
+    ".json": "application/json", ".csv": "text/csv",
+};
+export function formatAttachmentBytes(size) {
+    if (size < 1024)
+        return `${size} B`;
+    if (size < 1024 * 1024)
+        return `${Math.round(size / 1024)} KB`;
+    return `${(size / 1024 / 1024).toFixed(1)} MB`;
+}
+export function attachmentChip(file) {
+    return `[${file.mime.startsWith("image/") ? "image" : "file"}: ${file.name} ${formatAttachmentBytes(file.size)}]`;
+}
+function shellWords(text) {
+    const words = [];
+    let word = "";
+    let quote = null;
+    let started = false;
+    for (let at = 0; at < text.length; at += 1) {
+        const char = text[at];
+        if (!quote && /\s/.test(char)) {
+            if (started) {
+                words.push(word);
+                word = "";
+                started = false;
+            }
+            continue;
+        }
+        if (char === "\\" && quote !== "'") {
+            at += 1;
+            if (at >= text.length)
+                return null;
+            word += text[at];
+            started = true;
+            continue;
+        }
+        if (char === "'" || char === '"') {
+            if (!quote) {
+                quote = char;
+                started = true;
+                continue;
+            }
+            if (quote === char) {
+                quote = null;
+                continue;
+            }
+        }
+        word += char;
+        started = true;
+    }
+    if (quote)
+        return null;
+    if (started)
+        words.push(word);
+    return words;
+}
+export function parseAttachArgs(argv) {
+    const rest = [];
+    let ticketKey;
+    let to;
+    for (let at = 0; at < argv.length; at += 1) {
+        const arg = argv[at];
+        if (arg === "--ticket") {
+            ticketKey = argv[++at]?.toUpperCase();
+            continue;
+        }
+        if (arg === "--to") {
+            const role = argv[++at];
+            if (role === "architect" || role === "orchestrator")
+                to = role;
+            else
+                throw new Error("--to must be architect or orchestrator.");
+            continue;
+        }
+        rest.push(arg);
+    }
+    if (rest.length !== 1 || Boolean(ticketKey) === Boolean(to)) {
+        throw new Error("usage: hd attach PATH --ticket KEY | --to architect|orchestrator");
+    }
+    if (ticketKey && !/^HD-[1-9][0-9]*$/i.test(ticketKey))
+        throw new Error("--ticket must be an HD-N key.");
+    return { path: rest[0], ...(ticketKey ? { ticketKey } : {}), ...(to ? { to } : {}) };
+}
+export function parseTuiAttach(text) {
+    const words = shellWords(text.trim());
+    if (!words?.length)
+        return null;
+    const key = words.at(-1)?.match(/^HD-[1-9][0-9]*$/i)?.[0].toUpperCase();
+    const paths = key ? words.slice(0, -1) : words;
+    return paths.length === 1 ? { path: paths[0], ...(key ? { ticketKey: key } : {}) } : null;
+}
+export async function detectDroppedPaths(pasted, isFile = async (path) => (await stat(path)).isFile()) {
+    const text = pasted.trim();
+    if (!text)
+        return [];
+    if (isAbsolute(text) && await isFile(text).catch(() => false))
+        return [text];
+    const words = shellWords(text);
+    if (!words?.length || words.some((path) => !isAbsolute(path)))
+        return [];
+    const checks = await Promise.all(words.map((path) => isFile(path).catch(() => false)));
+    return checks.every(Boolean) ? words : [];
+}
+export async function uploadAttachment(path, target = {}, config = loadConfig()) {
+    const info = await stat(path);
+    if (!info.isFile())
+        throw new Error(`${path} is not a file.`);
+    if (info.size > 20 * 1024 * 1024)
+        throw new Error("Attachments must be 20 MB or smaller.");
+    const mime = MIME[extname(path).toLowerCase()];
+    if (!mime)
+        throw new Error("Use an image, PDF, text, Markdown, JSON, or CSV file.");
+    const form = new FormData();
+    form.set("file", new Blob([await readFile(path)], { type: mime }), basename(path));
+    if (target.ticketKey)
+        form.set("ticket_key", target.ticketKey.toUpperCase());
+    if (target.messageId)
+        form.set("message_id", target.messageId);
+    const response = await fetch(`${config.url}/api/w/${config.slug}/attachments`, {
+        method: "POST", headers: { authorization: `Bearer ${config.api_key}` }, body: form,
+    });
+    const parsed = await response.json().catch(() => null);
+    if (!response.ok || !parsed?.attachment)
+        throw new Error(parsed?.error ?? `hd: ${response.status} Upload failed.`);
+    return parsed.attachment;
+}

package/dist/index.js

@@ -12,6 +12,7 @@ import { banner, c, statusChip, table, truncate, usage } from "./out.js";
 import { ticketNew } from "./ticket-commands.js";
 import { ticketViewLines } from "./tui/ticket-view.js";
 import { agentAdd, AGENT_ADD_USAGE } from "./agent-commands.js";
+import { attachmentChip, parseAttachArgs, uploadAttachment } from "./attachments.js";
 import { WORKSPACE_USAGE, workspaceGrantRunnerAccess, workspaceNew, workspaceRotateKey, workspaceSet, workspaceUse } from "./workspace-commands.js";
 import { defaultGh, hasWriteRepoPermission, HDX_RUNNER_GH_USER, requireAdminRepo, runnerRepoPermission } from "./workspace-preflight.js";
 function fail(message) {
@@ -101,7 +102,7 @@ async function cmdTicket(argv, deps = {}) {
             console.log(JSON.stringify(data));
             return;
         }
-        const { ticket, pr, events, runs, messages, decisions } = data;
+        const { ticket, pr, events, runs, messages, decisions, attachments } = data;
         const width = process.stdout.columns && process.stdout.columns > 0 ? process.stdout.columns : 80;
         for (const line of ticketViewLines({
             ...ticket,
@@ -114,6 +115,7 @@ async function cmdTicket(argv, deps = {}) {
                 summary: run.summary, elapsed_ms: run.elapsed_ms,
             })),
             decisions,
+            attachments,
         }, width)) {
             console.log(line.text);
         }
@@ -276,6 +278,15 @@ async function cmdMsg(argv) {
     });
     console.log(`sent ${message.id}`);
 }
+export async function cmdAttach(argv) {
+    const parsed = parseAttachArgs(argv);
+    const attachment = await uploadAttachment(parsed.path, parsed.ticketKey ? { ticketKey: parsed.ticketKey } : {});
+    if (parsed.to) {
+        await postMessage({ body_md: `Attached ${attachment.name}.`, to_role: parsed.to, delivery: "queue",
+            attachment_ids: [attachment.id] });
+    }
+    console.log(`${attachmentChip(attachment)}${parsed.ticketKey ? ` attached to ${parsed.ticketKey}` : ` sent to ${parsed.to}`}`);
+}
 async function cmdInbox(argv) {
     const { rest, opts, bools } = flags(argv);
     if (rest.length || (bools.has("limit") && !opts.limit))
@@ -627,6 +638,10 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdMsg(rest);
             return;
         }
+        if (cmd === "attach") {
+            await cmdAttach(rest);
+            return;
+        }
         if (cmd === "inbox") {
             await cmdInbox(rest);
             return;

package/dist/out.js

@@ -75,6 +75,7 @@ export function usage() {
         `  ${c.blue("hd host roll | env ls | set | rm")}   roll a host or edit host env`,
         `  ${c.blue("hd logs KEY [-f]")}                  run events`,
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,
+        `  ${c.blue("hd attach PATH --ticket KEY | --to ROLE")} attach a file`,
         `  ${c.blue("hd inbox [--all] [--limit N] [--json]")} inbox messages`,
         `  ${c.blue("hd decide [ID --answer TEXT]")}      decisions`,
         `  ${c.blue("hd on | hd off")}                    workspace switch`,

package/dist/ticket-commands.js

@@ -139,6 +139,8 @@ export async function ticketNew(argv, deps = {}) {
     else {
         throw new Error(TICKET_NEW_USAGE);
     }
+    if (deps.attachmentIds?.length)
+        fields.attachment_ids = deps.attachmentIds;
     const created = await (deps.createTicket ?? createTicket)(fields, deps.config);
     let queued = false;
     if (offerQueue && queueNow(await (deps.prompt ?? promptOnStdin)("Queue it now? [y/N] "))) {

package/dist/tui/App.js

@@ -33,6 +33,7 @@ import { editFor, editableKeys, nextValue, seedFor, settingsRows } from "./setti
 import { appendLines, runLabels, toStreamLines } from "./stream.js";
 import { UI } from "./theme.js";
 import { WorkspaceLoads } from "./workspace-load.js";
+import { attachmentChip, detectDroppedPaths, uploadAttachment } from "../attachments.js";
 let messageSeq = 0;
 const nextId = () => `m${messageSeq++}`;
 const tuiPrompt = (question) => promptOnStdin(question, true);
@@ -54,6 +55,7 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
     const [chatOffset, setChatOffset] = useState(0);
     const [now, setNow] = useState(Date.now());
     const [draft, setDraft] = useState("");
+    const [pendingAttachments, setPendingAttachments] = useState([]);
     const [busy, setBusy] = useState(false);
     const [notice, setNotice] = useState(null);
     const [availableUpdate, setAvailableUpdate] = useState(initialUpdate);
@@ -394,6 +396,7 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
         const key = threadKey(workspace.id, role);
         const since = new Date().toISOString();
         const youTurn = { id: nextId(), speaker: "you", body: text, at: since };
+        const attachmentIds = pendingAttachments.map((attachment) => attachment.id);
         setMode(role);
         setView("chat");
         setChatOffset(10_000);
@@ -406,7 +409,9 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
         }));
         void (async () => {
             try {
-                const posted = await postAgentMessage(role, text, config);
+                const posted = await postAgentMessage(role, text, config, attachmentIds);
+                if (attachmentIds.length)
+                    setPendingAttachments([]);
                 const deadline = Date.now() + REPLY_WAIT_MS;
                 while (Date.now() <= deadline) {
                     const follow = await followChat(config, role, posted.id, since);
@@ -450,7 +455,32 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                 }));
             }
         })();
-    }, [agentName, config, setThread, workspace.id]);
+    }, [agentName, config, pendingAttachments, setThread, workspace.id]);
+    const receiveDrop = useCallback((pasted) => {
+        if (!/^(?:\/|'\/|"\/)/.test(pasted.trim()))
+            return false;
+        void (async () => {
+            const paths = await detectDroppedPaths(pasted);
+            if (!paths.length) {
+                setDraft((current) => current + pasted.replace(/[\r\n]+/g, " "));
+                return;
+            }
+            setBusy(true);
+            try {
+                const uploaded = [];
+                for (const path of paths)
+                    uploaded.push(await uploadAttachment(path, {}, config));
+                setPendingAttachments((current) => [...current, ...uploaded]);
+            }
+            catch (error) {
+                setNotice(error instanceof Error ? error.message : String(error));
+            }
+            finally {
+                setBusy(false);
+            }
+        })();
+        return true;
+    }, [config]);
     const openTicket = useCallback(async (key) => {
         setTicketKey(key);
         setView("ticket");
@@ -632,10 +662,12 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                 try {
                     let result;
                     await suspendTerminal(async () => {
-                        result = await ticketNew(action.args, { config, isTTY: true, prompt: tuiPrompt });
+                        result = await ticketNew(action.args, { config, isTTY: true, prompt: tuiPrompt,
+                            attachmentIds: pendingAttachments.map((attachment) => attachment.id) });
                     });
                     if (!result)
                         throw new Error("Ticket creation did not finish.");
+                    setPendingAttachments([]);
                     say("system", `Created ${result.ticket.key}: ${result.ticket.title}${result.queued ? " and queued it" : ""}.`);
                     await refresh();
                 }
@@ -820,6 +852,23 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                     setBusy(false);
                 }
                 return;
+            case "attach":
+                setBusy(true);
+                try {
+                    const key = action.key ?? ticketKey;
+                    if (!key)
+                        throw new Error("Open a ticket or include its HD-N key.");
+                    const attachment = await uploadAttachment(action.path, { ticketKey: key }, config);
+                    say("system", `${attachmentChip(attachment)} attached to ${key}.`);
+                    await refresh();
+                }
+                catch (error) {
+                    setNotice(error instanceof Error ? error.message : String(error));
+                }
+                finally {
+                    setBusy(false);
+                }
+                return;
             case "logs":
                 setLogsFilter(action.key);
                 setRawLogs(action.raw);
@@ -876,7 +925,7 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
         }
     }, [view, settings, applyEdit, board, browsing, mode, say, askAgent, openAgentChat, order, settingsOrder,
         changeWorkspace, config, refresh, suspendTerminal, exit, inbox, inboxFocus, openTicket, answering,
-        selectedDecisionId, submitDecision, ticketKey, ticketCollapsed, ticketOffset, width]);
+        selectedDecisionId, submitDecision, ticketKey, ticketCollapsed, ticketOffset, width, pendingAttachments]);
     useInput((input, key) => {
         if (key.ctrl && input === "c") {
             exit();
@@ -934,7 +983,7 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                     return _jsx(Bubble, { message: item.message, width: width }, item.key);
                 } }), splash ? (_jsx(Splash, { columns: columns, rows: rows, width: width, ready: ready, helpFull: plan.helpFull, animate: plan.fits, onDone: () => setReady(true) })) : null, _jsxs(Box, { flexDirection: "column", width: width, children: [view === "board" && plan.panels > 0 ? _jsx(BoardPanel, { board: board, width: width, rows: plan.panels, cursor: cursor }) : null, view === "roadmap" && plan.panels > 0 ? (_jsx(RoadmapPanel, { board: board, width: width, rows: plan.panels, offset: roadmapOffset })) : null, view === "agents" && plan.panels > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(AgentsPanel, { board: board, width: width, rows: agentsView.top }), agentsView.bottom > 0 ? _jsxs(_Fragment, { children: [_jsx(Box, { height: 1 }), _jsx(StreamPanel, { lines: stream, width: width, rows: agentsView.bottom, live: running > 0 })] }) : null] })) : null, view === "feed" && plan.panels > 0 ? _jsx(FeedPanel, { entries: feed, width: width, rows: plan.panels }) : null, view === "settings" && plan.panels > 0 ? _jsx(SettingsPanel, { entries: settings, width: width, rows: plan.panels, title: "Settings", cursor: field, editing: editing }) : null, view === "inbox" && plan.panels > 0 ? _jsx(InboxPanel, { board: board, width: width, rows: plan.panels, focus: inboxFocus, selectedId: selectedDecisionId, answeringId: answering }) : null, view === "ticket" && plan.panels > 0 ? ticket
                         ? _jsx(TicketPanel, { ticket: ticket, width: width, rows: plan.panels, offset: ticketOffset, collapsed: ticketCollapsed })
-                        : _jsxs(Text, { color: UI.warn, children: ["No ticket ", ticketKey, " here."] }) : null, view === "home" && plan.cockpit > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Cockpit, { board: board, width: width, rows: plan.cockpit, cursor: cursor }), _jsx(Box, { height: 1 }), _jsx(StreamPanel, { lines: stream, width: width, rows: plan.stream, live: running > 0 })] })) : null, chatting && plan.panels > 0 && activeThread ? (_jsx(ChatPanel, { thread: activeThread, width: width, rows: plan.panels, offset: chatOffset, label: chatLabel, now: now })) : null, chatting ? null : _jsx(DecisionPanel, { decisions: decisions, board: board, width: width, rows: plan.decision, selectedId: selectedDecisionId }), notice ? _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: UI.warn, children: notice }) }) : null, _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: UI.text, bold: true, children: workspace.slug }), _jsxs(Text, { color: UI.dim, children: [" ", workspace.repo, " "] }), _jsx(Text, { color: live === "live" ? UI.accent : UI.dim, children: "\u25CF " }), _jsxs(Text, { color: UI.dim, children: [live === "live" ? "5s poll" : live, " "] }), _jsx(Text, { color: UI.dim, children: running ? `${running} running ` : "" }), board.decisions.length ? _jsxs(Text, { color: UI.warn, children: [board.decisions.length, " decisions "] }) : null, workspace.paused ? _jsx(Text, { color: UI.warn, children: "paused " }) : null, logsFilter || rawLogs ? _jsxs(Text, { color: UI.warn, children: ["logs ", rawLogs ? "raw " : "", logsFilter ?? "all", " "] }) : null, _jsxs(Text, { color: UI.dim, wrap: "truncate", children: ["\u00B7 ", chatting ? chatLabel : mode, answering ? " esc cancels" : chatting ? " ↑↓ scroll · pgup/pgdn · esc hides" : view === "ticket" ? " ↑↓ scroll · pgup/pgdn · enter folds" : view === "roadmap" ? " ↑↓ scroll · pgup/pgdn" : view === "inbox" ? " ↑↓ decisions · enter answers" : cursor && selected ? ` ${selected.key} ↑↓ move · enter opens · esc leaves` : ""] })] }), availableUpdate || updateProgress ? (_jsx(Box, { children: _jsx(Text, { color: UI.warn, children: updateProgress ?? tuiUpdatePrompt(availableUpdate) }) })) : null, _jsx(Box, { children: _jsx(TextInput, { value: draft, onChange: (next) => {
+                        : _jsxs(Text, { color: UI.warn, children: ["No ticket ", ticketKey, " here."] }) : null, view === "home" && plan.cockpit > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Cockpit, { board: board, width: width, rows: plan.cockpit, cursor: cursor }), _jsx(Box, { height: 1 }), _jsx(StreamPanel, { lines: stream, width: width, rows: plan.stream, live: running > 0 })] })) : null, chatting && plan.panels > 0 && activeThread ? (_jsx(ChatPanel, { thread: activeThread, width: width, rows: plan.panels, offset: chatOffset, label: chatLabel, now: now })) : null, chatting ? null : _jsx(DecisionPanel, { decisions: decisions, board: board, width: width, rows: plan.decision, selectedId: selectedDecisionId }), notice ? _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: UI.warn, children: notice }) }) : null, _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: UI.text, bold: true, children: workspace.slug }), _jsxs(Text, { color: UI.dim, children: [" ", workspace.repo, " "] }), _jsx(Text, { color: live === "live" ? UI.accent : UI.dim, children: "\u25CF " }), _jsxs(Text, { color: UI.dim, children: [live === "live" ? "5s poll" : live, " "] }), _jsx(Text, { color: UI.dim, children: running ? `${running} running ` : "" }), board.decisions.length ? _jsxs(Text, { color: UI.warn, children: [board.decisions.length, " decisions "] }) : null, workspace.paused ? _jsx(Text, { color: UI.warn, children: "paused " }) : null, logsFilter || rawLogs ? _jsxs(Text, { color: UI.warn, children: ["logs ", rawLogs ? "raw " : "", logsFilter ?? "all", " "] }) : null, _jsxs(Text, { color: UI.dim, wrap: "truncate", children: ["\u00B7 ", chatting ? chatLabel : mode, answering ? " esc cancels" : chatting ? " ↑↓ scroll · pgup/pgdn · esc hides" : view === "ticket" ? " ↑↓ scroll · pgup/pgdn · enter folds" : view === "roadmap" ? " ↑↓ scroll · pgup/pgdn" : view === "inbox" ? " ↑↓ decisions · enter answers" : cursor && selected ? ` ${selected.key} ↑↓ move · enter opens · esc leaves` : ""] })] }), availableUpdate || updateProgress ? (_jsx(Box, { children: _jsx(Text, { color: UI.warn, children: updateProgress ?? tuiUpdatePrompt(availableUpdate) }) })) : null, pendingAttachments.map((attachment) => (_jsx(Text, { color: UI.accent, children: attachmentChip(attachment) }, attachment.id))), _jsx(Box, { children: _jsx(TextInput, { value: draft, onChange: (next) => {
                                 setDraft(next);
                                 if (editingRef.current)
                                     setEditing({ key: editingRef.current.key, draft: next });
@@ -968,7 +1017,7 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                                 }
                                 setCursor(null);
                                 selectedRef.current = null;
-                            }, onUp: () => {
+                            }, onPasteText: receiveDrop, onUp: () => {
                                 if (chatting && !draft) {
                                     const overflow = chatLines.length > plan.panels;
                                     const inner = overflow ? Math.max(0, plan.panels - 1) : Math.max(1, plan.panels);

package/dist/tui/Help.js

@@ -13,6 +13,7 @@ export const COMMANDS = [
     { name: "/cancel", args: "HD-12", help: "cancel a ticket" },
     { name: "/merge", args: "HD-12", help: "approve a reviewed PR over the reviewer's objections" },
     { name: "/msg", args: "HD-12 TEXT", help: "message a ticket's builder" },
+    { name: "/attach", args: "PATH [HD-12]", help: "attach a file to the open or named ticket" },
     { name: "/logs", args: "[raw] [HD-12]", help: "filter activity; raw reveals event JSON" },
     { name: "/epic", args: "new PATH | approve ID | rm ID", help: "create, approve, or remove a draft epic" },
     { name: "/epics", help: "list epics and ticket progress" },

package/dist/tui/TextInput.js

@@ -19,7 +19,7 @@ function printableOf(text) {
     // eslint-disable-next-line no-control-regex
     return text.replace(/[\x00-\x1f\x7f]/g, "");
 }
-export default function TextInput({ value, onChange, onSubmit, onCancel, onUp, onDown, onPageUp, onPageDown, isActive = true, placeholder = "", prompt, color, }) {
+export default function TextInput({ value, onChange, onSubmit, onCancel, onUp, onDown, onPageUp, onPageDown, isActive = true, placeholder = "", prompt, color, onPasteText, }) {
     const [cursor, setCursor] = useState(value.length);
     // The last value this component produced. Anything else arriving in `value`
     // was swapped in by the caller.
@@ -47,6 +47,8 @@ export default function TextInput({ value, onChange, onSubmit, onCancel, onUp, o
         setCursor(cursor + text.length);
     };
     usePaste((text) => {
+        if (onPasteText?.(text))
+            return;
         // Newlines would break a single-line field, so flatten them to spaces.
         insert(text.replace(/[\r\n]+/g, " "));
     }, { isActive });

package/dist/tui/data.js

@@ -123,8 +123,9 @@ export async function switchWorkspace(slug, config = loadConfig()) {
     selectWorkspace(slug);
     return snapshot;
 }
-export async function postAgentMessage(role, body, config) {
-    const { message } = await sendMessage({ body_md: body, to_role: role, delivery: "queue" }, config);
+export async function postAgentMessage(role, body, config, attachmentIds = []) {
+    const { message } = await sendMessage({ body_md: body, to_role: role, delivery: "queue",
+        attachment_ids: attachmentIds }, config);
     return message;
 }
 export async function loadChatMessages(config, role) {
@@ -157,7 +158,7 @@ export async function followChat(config, role, messageId, since) {
     return { run, events, reply: reply?.body_md ?? null };
 }
 export async function loadTicketDetail(config, key) {
-    const { ticket, pr, events, runs, messages, decisions } = await showTicket(key, config);
+    const { ticket, pr, events, runs, messages, decisions, attachments } = await showTicket(key, config);
     return {
         ticket: {
             ...ticket,
@@ -167,6 +168,7 @@ export async function loadTicketDetail(config, key) {
             messages,
             runs,
             decisions,
+            attachments,
         },
     };
 }

package/dist/tui/parse.js

@@ -1,3 +1,4 @@
+import { parseTuiAttach } from "../attachments.js";
 /**
  * What a typed line means. Kept separate from the component so the behaviour
  * can be tested without a terminal, a database, or a render.
@@ -97,6 +98,11 @@ export function parseLine(raw) {
         case "msg":
             return rest.length >= 2 ? { kind: "message", key: rest[0].toUpperCase(), text: rest.slice(1).join(" ") }
                 : { kind: "unknown", command: "msg needs KEY TEXT" };
+        case "attach": {
+            const parsed = parseTuiAttach(argument);
+            return parsed ? { kind: "attach", path: parsed.path, key: parsed.ticketKey ?? null }
+                : { kind: "unknown", command: "attach needs PATH and an optional HD-N key" };
+        }
         case "logs":
             if (rest[0]?.toLowerCase() === "raw" && rest.length <= 2) {
                 return { kind: "logs", key: rest[1]?.toUpperCase() ?? null, raw: true };

package/dist/tui/ticket-view.js

@@ -1,4 +1,4 @@
-export const TICKET_SECTIONS = ["body", "acceptance", "timeline", "messages", "pr", "runs", "decisions"];
+export const TICKET_SECTIONS = ["body", "acceptance", "attachments", "timeline", "messages", "pr", "runs", "decisions"];
 export function ticketPr(ticket) {
     if (!ticket.pr_url && ticket.pr_number == null)
         return null;
@@ -121,6 +121,17 @@ export function ticketViewLines(ticket, width, collapsed = []) {
         }
         pushWrapped(lines, "acceptance", "  ", ticket.acceptance_md.trim(), width);
     });
+    const attachments = ticket.attachments ?? [];
+    if (attachments.length)
+        addSection("attachments", "Attachments", () => {
+            for (const attachment of attachments) {
+                const size = attachment.size < 1024 ? `${attachment.size} B`
+                    : attachment.size < 1024 * 1024 ? `${Math.round(attachment.size / 1024)} KB`
+                        : `${(attachment.size / 1024 / 1024).toFixed(1)} MB`;
+                lines.push({ key: attachment.id, kind: "line", section: "attachments",
+                    text: `  [${attachment.mime.startsWith("image/") ? "image" : "file"}: ${attachment.name} ${size}]` });
+            }
+        }, attachments.length);
     addSection("timeline", "Timeline", () => {
         if (!ticket.timeline?.length) {
             lines.push({ key: "timeline:empty", kind: "line", section: "timeline", text: "  No completed runs yet." });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "type": "module",
   "repository": {
     "type": "git",