@higherdev/cli 0.24.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))
@@ -585,7 +596,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             if (canLaunchApp()) {
                 launchedTui = true;
                 const { launchApp } = await import("./tui/launch.js");
-                await launchApp();
+                await launchApp(undefined, deps);
                 return;
             }
             console.log(banner());
@@ -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;
@@ -670,7 +685,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             console.log(`logged in to ${config.slug}`);
             launchedTui = true;
             const { launchApp } = await import("./tui/launch.js");
-            await launchApp(config.slug);
+            await launchApp(config.slug, deps);
             return;
         }
         if (cmd === "init" || cmd === "upgrade") {

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

@@ -2,7 +2,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Box, Static, Text, useApp, useInput, useStdout } from "ink";
 import { loadConfig } from "../config.js";
-import { pendingUpdateNotice, subscribeUpdateNotice } from "../update-check.js";
+import { pendingTuiUpdate, relaunchHd, runPromptedUpdate, skipUpdate, subscribeUpdateNotice, tuiUpdatePrompt, updatePromptAction, } from "../update-check.js";
 import { epicProgressRows } from "../epics.js";
 import { promptOnStdin } from "../prompt.js";
 import { ticketNew } from "../ticket-commands.js";
@@ -33,10 +33,11 @@ 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);
-export function App({ initial, updateNotice = null }) {
+export function App({ initial, availableUpdate: initialUpdate = null, updateDeps = {}, onRelaunch, }) {
     const { exit, suspendTerminal } = useApp();
     const { stdout } = useStdout();
     const columns = stdout?.columns && stdout.columns > 0 ? stdout.columns : 80;
@@ -54,9 +55,12 @@ export function App({ initial, updateNotice = null }) {
     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 [updateLine, setUpdateLine] = useState(updateNotice);
+    const [availableUpdate, setAvailableUpdate] = useState(initialUpdate);
+    const [updateProgress, setUpdateProgress] = useState(null);
+    const [updating, setUpdating] = useState(false);
     const [ticketKey, setTicketKey] = useState(null);
     const [ticketOffset, setTicketOffset] = useState(0);
     const [roadmapOffset, setRoadmapOffset] = useState(0);
@@ -86,9 +90,48 @@ export function App({ initial, updateNotice = null }) {
     const loads = useRef(new WorkspaceLoads(initial.workspace.id));
     editingRef.current = editing;
     useEffect(() => {
-        setUpdateLine((current) => current ?? pendingUpdateNotice());
-        return subscribeUpdateNotice(setUpdateLine);
+        return subscribeUpdateNotice(() => setAvailableUpdate(pendingTuiUpdate(updateDeps)));
     }, []);
+    const dismissUpdate = useCallback(() => {
+        if (!availableUpdate)
+            return;
+        try {
+            skipUpdate(availableUpdate, updateDeps);
+            setAvailableUpdate(pendingTuiUpdate(updateDeps));
+        }
+        catch (error) {
+            setNotice(`Could not remember skipped update: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }, [availableUpdate, updateDeps]);
+    const acceptUpdate = useCallback(async () => {
+        if (!availableUpdate || updating)
+            return;
+        setUpdating(true);
+        setUpdateProgress(`Updating hd ${availableUpdate.current}...`);
+        try {
+            await runPromptedUpdate(availableUpdate, {
+                ...updateDeps,
+                log: (line) => {
+                    updateDeps.log?.(line);
+                    if (line !== `hd ${availableUpdate.current}`) {
+                        setUpdateProgress(`Installed ${line}. Relaunching...`);
+                    }
+                },
+                relaunch: () => {
+                    exit();
+                    if (onRelaunch)
+                        onRelaunch();
+                    else
+                        setTimeout(updateDeps.relaunch ?? relaunchHd, 0);
+                },
+            });
+        }
+        catch (error) {
+            setNotice(`Update failed: ${error instanceof Error ? error.message : String(error)}`);
+            setUpdateProgress(null);
+            setUpdating(false);
+        }
+    }, [availableUpdate, exit, onRelaunch, updateDeps, updating]);
     useEffect(() => {
         if (messages.length > 0 || view !== "home")
             setStarted(true);
@@ -353,6 +396,7 @@ export function App({ initial, updateNotice = null }) {
         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);
@@ -365,7 +409,9 @@ export function App({ initial, updateNotice = null }) {
         }));
         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);
@@ -409,7 +455,32 @@ export function App({ initial, updateNotice = null }) {
                 }));
             }
         })();
-    }, [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");
@@ -591,10 +662,12 @@ export function App({ initial, updateNotice = null }) {
                 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();
                 }
@@ -779,6 +852,23 @@ export function App({ initial, updateNotice = null }) {
                     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);
@@ -835,10 +925,20 @@ export function App({ initial, updateNotice = null }) {
         }
     }, [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")
+        if (key.ctrl && input === "c") {
             exit();
+            return;
+        }
+        if (availableUpdate && !updating) {
+            const action = updatePromptAction(input, key.escape);
+            if (action === "skip")
+                dismissUpdate();
+            else if (action === "accept")
+                void acceptUpdate();
+            return;
+        }
     });
     const decisions = board.decisions;
     const answeringDecision = answering ? decisions.find((decision) => decision.id === answering) : null;
@@ -870,7 +970,7 @@ export function App({ initial, updateNotice = null }) {
     const plan = planLayout({
         rows, columns, width, splash, ready, decision: chatting ? 0 : decisionRows(decisions),
         inFlight: chatting ? 0 : inFlight.reduce((total, message) => total + bubbleRows(message, width), 0),
-        notice: Boolean(notice), home: view === "home",
+        notice: Boolean(notice || availableUpdate || updateProgress), home: view === "home",
     });
     const agentsView = splitPanels(plan.panels);
     const running = board.runs.filter((run) => run.status === "running").length;
@@ -883,11 +983,11 @@ export function App({ initial, updateNotice = null }) {
                     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, updateLine ? _jsxs(Text, { color: UI.warn, children: [updateLine, " "] }) : 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` : ""] })] }), _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 });
-                            }, onSubmit: (value) => void run(value), isActive: inputActive({ busy, pendingChats: inFlight.length }), placeholder: answering
+                            }, onSubmit: (value) => void run(value), isActive: !availableUpdate && !updating && inputActive({ busy, pendingChats: inFlight.length }), placeholder: answering
                                 ? (answeringOptions.length ? `1-${answeringOptions.length} or your answer` : "your answer")
                                 : promptPlaceholder({ busy, pendingChats: inFlight.length }), prompt: _jsx(Text, { color: answering || chatting || mode !== "browse" ? UI.cream : UI.dim, children: answering ? `answer ${answeringNumber}> ` : chatting ? `${chatLabel}> ` : mode === "browse" ? "> " : `${mode}> ` }), color: UI.text, onCancel: () => {
                                 if (answering) {
@@ -917,7 +1017,7 @@ export function App({ initial, updateNotice = null }) {
                                 }
                                 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/launch.js

@@ -1,9 +1,9 @@
 import { loadConfig } from "../config.js";
-import { pendingUpdateNotice } from "../update-check.js";
+import { pendingTuiUpdate, relaunchHd } from "../update-check.js";
 import { canLaunchApp } from "./capability.js";
 import { loadSnapshot } from "./data.js";
 /** Opens HigherDEV. Shared by `hd` and by the end of `hd login`. */
-export async function launchApp(slug) {
+export async function launchApp(slug, updateDeps = {}) {
     // Keep this guard here as well as at command call sites. Ink cannot enter raw
     // mode unless both streams are terminals.
     if (!canLaunchApp())
@@ -14,9 +14,14 @@ export async function launchApp(slug) {
         import("react"),
         import("./App.js"),
     ]);
+    let shouldRelaunch = false;
     const instance = render(React.createElement(App, {
         initial,
-        updateNotice: pendingUpdateNotice(),
+        availableUpdate: pendingTuiUpdate(updateDeps),
+        updateDeps,
+        onRelaunch: () => { shouldRelaunch = true; },
     }), { exitOnCtrlC: false });
     await instance.waitUntilExit();
+    if (shouldRelaunch)
+        (updateDeps.relaunch ?? relaunchHd)();
 }

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/dist/update-check.js

@@ -56,6 +56,9 @@ export function readUpdateCheck(path = updateCheckPath()) {
         return {
             latest: parsed.latest,
             checked_at: typeof parsed.checked_at === "number" ? parsed.checked_at : 0,
+            ...(typeof parsed.skipped_version === "string" && parsed.skipped_version
+                ? { skipped_version: parsed.skipped_version }
+                : {}),
         };
     }
     catch {
@@ -73,6 +76,34 @@ export function pendingUpdateNotice(deps = {}) {
         return null;
     return updateNoticeLine(stored.latest, current);
 }
+export function pendingTuiUpdate(deps = {}) {
+    const stored = readUpdateCheck(deps.path ?? updateCheckPath());
+    const current = deps.version ?? runningVersion();
+    if (!stored || !isNewer(stored.latest, current))
+        return null;
+    if (stored.skipped_version && !isNewer(stored.latest, stored.skipped_version))
+        return null;
+    return { latest: stored.latest, current };
+}
+export function tuiUpdatePrompt(update) {
+    return `hd ${update.latest} is available, you have ${update.current}. Update now? (y/n)`;
+}
+export function updatePromptAction(input, escape = false) {
+    if (escape || input.toLowerCase() === "n")
+        return "skip";
+    if (input.toLowerCase() === "y")
+        return "accept";
+    return null;
+}
+export function skipUpdate(update, deps = {}) {
+    const path = deps.path ?? updateCheckPath();
+    const stored = readUpdateCheck(path);
+    writeUpdateCheck({
+        latest: stored?.latest ?? update.latest,
+        checked_at: stored?.checked_at ?? (deps.now ?? Date.now)(),
+        skipped_version: update.latest,
+    }, path);
+}
 export function subscribeUpdateNotice(listener) {
     listeners.add(listener);
     return () => {
@@ -111,8 +142,15 @@ export function beginUpdateCheck(deps = {}) {
     inFlight = (async () => {
         try {
             const latest = await fetchLatest(deps);
-            if (latest)
-                writeUpdateCheck({ latest, checked_at: (deps.now ?? Date.now)() }, deps.path ?? updateCheckPath());
+            if (latest) {
+                const path = deps.path ?? updateCheckPath();
+                const stored = readUpdateCheck(path);
+                writeUpdateCheck({
+                    latest,
+                    checked_at: (deps.now ?? Date.now)(),
+                    ...(stored?.skipped_version ? { skipped_version: stored.skipped_version } : {}),
+                }, path);
+            }
         }
         catch {
             // Offline, timed out, or unwritable cache: the command still succeeds.
@@ -163,3 +201,6 @@ export async function runUpdate(argv, deps = {}) {
         (deps.relaunch ?? relaunchHd)();
     return lines;
 }
+export function runPromptedUpdate(update, deps = {}) {
+    return runUpdate([], { ...deps, version: update.current, tuiRunning: true });
+}

package/package.json

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