mintree 0.4.2 → 0.4.3

package/dist/commands/update.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const description = "Update mintree to the latest version (npm i -g mintree)";
+export declare const options: z.ZodObject<{
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+export default function Update({ options: opts }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/update.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import Spinner from "ink-spinner";
+import { option } from "pastel";
+import { z } from "zod";
+import { createRequire } from "module";
+import { getLatestVersion, isNewerVersion } from "../lib/version.js";
+import { installLatest, PACKAGE_NAME } from "../lib/update.js";
+const require = createRequire(import.meta.url);
+const { version: currentVersion } = require("../../package.json");
+export const description = "Update mintree to the latest version (npm i -g mintree)";
+export const options = z.object({
+    force: z
+        .boolean()
+        .default(false)
+        .describe(option({
+        description: "Reinstall even when you're already on the latest version",
+        alias: "f",
+    })),
+});
+export default function Update({ options: opts }) {
+    const [phase, setPhase] = useState({ kind: "checking" });
+    useEffect(() => {
+        let cancelled = false;
+        (async () => {
+            const latest = await getLatestVersion(PACKAGE_NAME);
+            if (cancelled)
+                return;
+            // Skip the reinstall only when we're provably current and the user
+            // didn't force it. A null probe (offline/private registry) falls
+            // through to the install so `mt update` still does something useful.
+            if (!opts.force && latest && !isNewerVersion(currentVersion, latest)) {
+                setPhase({ kind: "uptodate", latest });
+                return;
+            }
+            setPhase({ kind: "installing", latest });
+            const result = await installLatest();
+            if (cancelled)
+                return;
+            setPhase({ kind: "done", result, latest });
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [opts.force]);
+    if (phase.kind === "checking") {
+        return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" Checking for updates... (current v", currentVersion, ")"] })] }));
+    }
+    if (phase.kind === "uptodate") {
+        return (_jsxs(Box, { flexDirection: "column", paddingY: 0, children: [_jsxs(Text, { color: "green", children: ["\u2713 mintree is already up to date (v", phase.latest, ")."] }), _jsx(Text, { dimColor: true, children: "Run with --force to reinstall anyway." })] }));
+    }
+    if (phase.kind === "installing") {
+        const target = phase.latest ? `v${phase.latest}` : "latest";
+        return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", "Updating mintree from v", currentVersion, " to ", target, "..."] })] }));
+    }
+    // done
+    const { result, latest } = phase;
+    if (result.ok) {
+        const target = latest ? `v${latest}` : "the latest version";
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "green", children: ["\u2713 mintree updated to ", target, "."] }), _jsx(Text, { dimColor: true, children: "Open a new shell (or re-run your command) to use it." })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "red", children: "\u2717 Update failed." }), _jsx(Text, { children: result.message }), result.hint ? _jsx(Text, { dimColor: true, children: result.hint }) : null] }));
+}

package/dist/lib/update.d.ts

@@ -0,0 +1,16 @@
+export declare const PACKAGE_NAME = "mintree";
+export type UpdateResult = {
+    ok: true;
+    output: string;
+} | {
+    ok: false;
+    message: string;
+    hint?: string;
+};
+/**
+ * Reinstalls `mintree@latest` globally via npm. Returns a discriminated result
+ * so the command can render a precise message instead of dumping a raw stack.
+ * The common failure — EACCES on a root-owned global prefix — gets a targeted
+ * hint pointing at the usual fixes.
+ */
+export declare function installLatest(): Promise<UpdateResult>;

package/dist/lib/update.js

@@ -0,0 +1,43 @@
+// Self-update: reinstall the globally-installed mintree from npm. The CLI is
+// distributed via `npm i -g mintree`, so updating is just re-running that
+// install for the `@latest` tag. We shell out to `npm` rather than reuse the
+// registry probe in version.ts because npm owns the global prefix, perms, and
+// bin-linking we can't replicate reliably here.
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+// npm global installs can be slow on a cold cache; give them room before we
+// give up. 2 minutes mirrors what a fresh `npm i -g` typically needs.
+const INSTALL_TIMEOUT_MS = 120_000;
+export const PACKAGE_NAME = "mintree";
+/**
+ * Reinstalls `mintree@latest` globally via npm. Returns a discriminated result
+ * so the command can render a precise message instead of dumping a raw stack.
+ * The common failure — EACCES on a root-owned global prefix — gets a targeted
+ * hint pointing at the usual fixes.
+ */
+export async function installLatest() {
+    try {
+        const { stdout, stderr } = await execAsync(`npm install -g ${PACKAGE_NAME}@latest`, {
+            timeout: INSTALL_TIMEOUT_MS,
+        });
+        return { ok: true, output: (stdout || stderr || "").trim() };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, message, hint: hintForError(message) };
+    }
+}
+function hintForError(message) {
+    const m = message.toLowerCase();
+    if (m.includes("eacces") || m.includes("permission denied")) {
+        return "npm couldn't write to its global prefix. Either fix the prefix ownership (npm docs: 'resolving EACCES permissions errors') or re-run with sudo.";
+    }
+    if (m.includes("command not found") || m.includes("not recognized")) {
+        return "npm wasn't found on your PATH. Install Node.js (which bundles npm) and try again.";
+    }
+    if (m.includes("etimedout") || m.includes("network") || m.includes("enotfound")) {
+        return "Looks like a network problem reaching the npm registry. Check your connection and retry.";
+    }
+    return undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mintree",
-	"version": "0.4.2",
+	"version": "0.4.3",
 	"description": "Issue-driven git worktrees + Claude Code sessions for repos with an opinionated SDD+TDD flow.",
 	"license": "MIT",
 	"author": "Martin Mineo <mmineo@canarytechnologies.com>",