@higherdev/cli 0.23.0 → 0.24.0

package/dist/host.js

@@ -171,6 +171,7 @@ export function hostRollCommand(checkout) {
         "git pull --ff-only",
         "pnpm install",
         "systemctl --user restart hdx-runner.service",
+        "npm i -g @higherdev/cli@latest",
     ].join(" && ");
 }
 async function defaultSsh(address, command) {

package/dist/index.js

@@ -5,6 +5,7 @@ import { approveEpic, answerDecision, cancelTicket, mergeTicket, createEpic, del
 import { formatDrainStatus, hostRoll, initHost, parseHostFlags, parseHostRollFlags } from "./host.js";
 import { login, parseLoginFlags } from "./login.js";
 import { loadConfig } from "./config.js";
+import { beginUpdateCheck, pendingUpdateNotice, runUpdate, shouldUpdateCheck, } from "./update-check.js";
 import { epicProgressRows, readEpicSpec } from "./epics.js";
 import { roadmapText } from "./roadmap.js";
 import { banner, c, statusChip, table, truncate, usage } from "./out.js";
@@ -569,11 +570,20 @@ async function cmdHost(argv, deps = {}) {
     fail(usage);
 }
 export async function main(argv = process.argv.slice(2), deps = {}) {
-    const [cmd, ...rest] = argv;
+    const args = argv.filter((arg) => arg !== "--no-update-check");
+    const [cmd, ...rest] = args;
+    const checking = shouldUpdateCheck({
+        argv, env: deps.env, isTTY: deps.isTTY,
+    });
+    if (checking)
+        beginUpdateCheck(deps);
+    let launchedTui = false;
+    let skipNotice = cmd === "update";
     try {
         if (!cmd) {
             const { canLaunchApp } = await import("./tui/capability.js");
             if (canLaunchApp()) {
+                launchedTui = true;
                 const { launchApp } = await import("./tui/launch.js");
                 await launchApp();
                 return;
@@ -658,6 +668,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
         if (cmd === "login") {
             const config = login(parseLoginFlags(rest));
             console.log(`logged in to ${config.slug}`);
+            launchedTui = true;
             const { launchApp } = await import("./tui/launch.js");
             await launchApp(config.slug);
             return;
@@ -667,11 +678,23 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             console.log(report);
             return;
         }
+        if (cmd === "update") {
+            const { canLaunchApp } = await import("./tui/capability.js");
+            await runUpdate(rest, { ...deps, tuiRunning: deps.tuiRunning ?? canLaunchApp() });
+            return;
+        }
         fail(usage());
     }
     catch (error) {
         fail(error instanceof Error ? error.message : String(error));
     }
+    finally {
+        if (checking && !launchedTui && !skipNotice) {
+            const line = pendingUpdateNotice(deps);
+            if (line)
+                (deps.error ?? console.error)(line);
+        }
+    }
 }
 if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href)
     void main();

package/dist/out.js

@@ -81,5 +81,6 @@ export function usage() {
         `  ${c.blue("hd login --url URL --api-key KEY")}  client setup`,
         `  ${c.blue("hd init --host HOST [options]")}     host setup`,
         `  ${c.blue("hd upgrade --host HOST [options]")}  refresh host setup`,
+        `  ${c.blue("hd update")}                         install the latest CLI`,
     ].join("\n");
 }

package/dist/tui/App.js

@@ -2,6 +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 { epicProgressRows } from "../epics.js";
 import { promptOnStdin } from "../prompt.js";
 import { ticketNew } from "../ticket-commands.js";
@@ -35,7 +36,7 @@ import { WorkspaceLoads } from "./workspace-load.js";
 let messageSeq = 0;
 const nextId = () => `m${messageSeq++}`;
 const tuiPrompt = (question) => promptOnStdin(question, true);
-export function App({ initial }) {
+export function App({ initial, updateNotice = null }) {
     const { exit, suspendTerminal } = useApp();
     const { stdout } = useStdout();
     const columns = stdout?.columns && stdout.columns > 0 ? stdout.columns : 80;
@@ -55,6 +56,7 @@ export function App({ initial }) {
     const [draft, setDraft] = useState("");
     const [busy, setBusy] = useState(false);
     const [notice, setNotice] = useState(null);
+    const [updateLine, setUpdateLine] = useState(updateNotice);
     const [ticketKey, setTicketKey] = useState(null);
     const [ticketOffset, setTicketOffset] = useState(0);
     const [roadmapOffset, setRoadmapOffset] = useState(0);
@@ -83,6 +85,10 @@ export function App({ initial }) {
     const acknowledgedMessages = useRef(new Set());
     const loads = useRef(new WorkspaceLoads(initial.workspace.id));
     editingRef.current = editing;
+    useEffect(() => {
+        setUpdateLine((current) => current ?? pendingUpdateNotice());
+        return subscribeUpdateNotice(setUpdateLine);
+    }, []);
     useEffect(() => {
         if (messages.length > 0 || view !== "home")
             setStarted(true);
@@ -877,7 +883,7 @@ export function App({ initial }) {
                     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` : ""] })] }), _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, 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) => {
                                 setDraft(next);
                                 if (editingRef.current)
                                     setEditing({ key: editingRef.current.key, draft: next });

package/dist/tui/launch.js

@@ -1,4 +1,5 @@
 import { loadConfig } from "../config.js";
+import { pendingUpdateNotice } 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`. */
@@ -15,6 +16,7 @@ export async function launchApp(slug) {
     ]);
     const instance = render(React.createElement(App, {
         initial,
+        updateNotice: pendingUpdateNotice(),
     }), { exitOnCtrlC: false });
     await instance.waitUntilExit();
 }

package/dist/update-check.js

@@ -0,0 +1,165 @@
+import { execFile, spawn } from "node:child_process";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { promisify } from "node:util";
+import { configPath } from "./config.js";
+const execFileAsync = promisify(execFile);
+const require = createRequire(import.meta.url);
+export const CLI_PACKAGE = "@higherdev/cli";
+export const CLI_REGISTRY_LATEST = `https://registry.npmjs.org/${CLI_PACKAGE}/latest`;
+export const UPDATE_CHECK_TIMEOUT_MS = 2_000;
+export const UPDATE_USAGE = "usage: hd update";
+const listeners = new Set();
+let inFlight = Promise.resolve();
+export function runningVersion() {
+    return require("../package.json").version;
+}
+export function updateCheckPath(configFile = configPath()) {
+    return join(dirname(configFile), "update-check.json");
+}
+/** Dotted numeric versions. Pre-release suffixes sort before a release. */
+export function isNewer(candidate, current) {
+    const parts = (value) => value
+        .split("-")[0]
+        .split(".")
+        .map((part) => Number.parseInt(part, 10) || 0);
+    const a = parts(candidate);
+    const b = parts(current);
+    for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
+        const left = a[i] ?? 0;
+        const right = b[i] ?? 0;
+        if (left !== right)
+            return left > right;
+    }
+    return false;
+}
+export function updateNoticeLine(latest, current) {
+    return `hd ${latest} is available, you have ${current}. Run hd update.`;
+}
+export function shouldUpdateCheck(opts = {}) {
+    const argv = opts.argv ?? [];
+    const env = opts.env ?? process.env;
+    if (argv.includes("--no-update-check"))
+        return false;
+    if (env.HD_NO_UPDATE_CHECK === "1")
+        return false;
+    if (argv.includes("--json"))
+        return false;
+    return (opts.isTTY ?? process.stdout.isTTY) === true;
+}
+export function readUpdateCheck(path = updateCheckPath()) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (typeof parsed.latest !== "string" || !parsed.latest)
+            return null;
+        return {
+            latest: parsed.latest,
+            checked_at: typeof parsed.checked_at === "number" ? parsed.checked_at : 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function writeUpdateCheck(state, path = updateCheckPath()) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(state, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+}
+export function pendingUpdateNotice(deps = {}) {
+    const stored = readUpdateCheck(deps.path ?? updateCheckPath());
+    const current = deps.version ?? runningVersion();
+    if (!stored || !isNewer(stored.latest, current))
+        return null;
+    return updateNoticeLine(stored.latest, current);
+}
+export function subscribeUpdateNotice(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+function emitNotice(deps = {}) {
+    const notice = pendingUpdateNotice(deps);
+    for (const listener of listeners)
+        listener(notice);
+}
+export async function fetchLatest(deps = {}) {
+    const fetchFn = deps.fetch ?? globalThis.fetch;
+    const timeout = deps.timeoutMs ?? UPDATE_CHECK_TIMEOUT_MS;
+    // A real timer, not AbortSignal.timeout: on Node 22 that signal's timer does
+    // not keep the event loop alive, so a pending check could be abandoned with
+    // its promise unresolved (which is exactly what the CI test run reported).
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error("update check timed out")), timeout);
+    try {
+        const response = await fetchFn(CLI_REGISTRY_LATEST, { signal: controller.signal });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        return typeof data.version === "string" && data.version ? data.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Fire-and-forget registry check. Never throws. The process may stay up to 2s to store the result. */
+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());
+        }
+        catch {
+            // Offline, timed out, or unwritable cache: the command still succeeds.
+        }
+        finally {
+            emitNotice(deps);
+        }
+    })();
+    return inFlight;
+}
+export function updateCheckDone() {
+    return inFlight;
+}
+async function defaultInstall() {
+    await execFileAsync("npm", ["i", "-g", `${CLI_PACKAGE}@latest`]);
+}
+async function defaultVersionAfter() {
+    try {
+        const { stdout } = await execFileAsync("npm", ["view", CLI_PACKAGE, "version"]);
+        const version = stdout.trim();
+        return version || runningVersion();
+    }
+    catch {
+        return runningVersion();
+    }
+}
+export function relaunchHd() {
+    const child = spawn("hd", [], { stdio: "inherit" });
+    child.on("exit", (code, signal) => {
+        if (signal)
+            process.kill(process.pid, signal);
+        else
+            process.exit(code ?? 0);
+    });
+}
+export async function runUpdate(argv, deps = {}) {
+    if (argv.length)
+        throw new Error(UPDATE_USAGE);
+    const before = deps.version ?? runningVersion();
+    const log = deps.log ?? ((line) => console.log(line));
+    const lines = [`hd ${before}`];
+    log(lines[0]);
+    await (deps.install ?? defaultInstall)();
+    const after = await (deps.versionAfter ?? defaultVersionAfter)();
+    lines.push(`hd ${after}`);
+    log(lines[1]);
+    if (deps.tuiRunning)
+        (deps.relaunch ?? relaunchHd)();
+    return lines;
+}

package/package.json

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