@lore-co/cli 0.2.25 → 0.2.27

package/dist/terminal-output.js

@@ -0,0 +1,151 @@
+import { homedir } from "node:os";
+import { isAbsolute, relative, sep } from "node:path";
+/**
+ * Set by `lore update` for the refresh it runs in the installed binary, whose
+ * stdout is a pipe: the parent's terminal decides how the child draws.
+ */
+export const OUTPUT_STYLE_ENV = "LORE_OUTPUT_STYLE";
+export const OUTPUT_COLUMNS_ENV = "LORE_OUTPUT_COLUMNS";
+export const OUTPUT_VERBOSE_ENV = "LORE_OUTPUT_VERBOSE";
+const MIN_WIDTH = 40;
+const MAX_WIDTH = 100;
+export const PLAIN_OUTPUT = { rich: false, width: Infinity, verbose: false, home: homedir() };
+export function detectOutputStyle(options = {}) {
+    const environment = options.environment ?? process.env;
+    const stream = options.stream ?? process.stdout;
+    const forced = environment[OUTPUT_STYLE_ENV];
+    const terminal = forced === "rich" ? true : forced === "plain" ? false : stream.isTTY === true;
+    // https://no-color.org: present and not empty disables styling.
+    const noColor = (environment.NO_COLOR ?? "") !== "";
+    const rich = terminal && !noColor && environment.TERM !== "dumb";
+    // A parent Lore process passes its terminal's width with its style.
+    const columns = Number(environment[OUTPUT_COLUMNS_ENV]) || (terminal ? stream.columns || 80 : 0);
+    return {
+        rich,
+        width: columns > 0 ? Math.min(MAX_WIDTH, Math.max(MIN_WIDTH, columns)) : Infinity,
+        verbose: options.verbose === true || environment[OUTPUT_VERBOSE_ENV] === "1",
+        home: options.home ?? homedir(),
+    };
+}
+/** The environment that makes a child Lore process draw like this one. */
+export function outputStyleEnvironment(style) {
+    return {
+        [OUTPUT_STYLE_ENV]: style.rich ? "rich" : "plain",
+        ...(Number.isFinite(style.width) ? { [OUTPUT_COLUMNS_ENV]: String(style.width) } : {}),
+        ...(style.verbose ? { [OUTPUT_VERBOSE_ENV]: "1" } : {}),
+    };
+}
+const ESCAPE = /\u001b\[[0-9;]*m/gu;
+// Joins the words of a command so wrapping never splits it.
+const KEEP = " ";
+const visibleLength = (text) => text.replace(ESCAPE, "").length;
+/** `~/x` for a path inside the home folder; other paths unchanged. */
+export function displayPath(path, home) {
+    const inside = relative(home, path);
+    if (inside === "")
+        return "~";
+    if (inside.startsWith("..") || isAbsolute(inside))
+        return path;
+    return `~${sep}${inside}`;
+}
+/** "A", "A and B", "A, B and C". */
+export function listText(items) {
+    if (items.length <= 1)
+        return items.join("");
+    return `${items.slice(0, -1).join(", ")} and ${items.at(-1)}`;
+}
+/**
+ * Word-wrap `text` to `width`, starting with `prefix` and indenting the lines
+ * after it to the same column. Never breaks inside a word or a kept span.
+ */
+export function wrap(text, width, prefix = "", indent = " ".repeat(visibleLength(prefix))) {
+    const words = text.split(" ").filter((word) => word !== "");
+    const lines = [];
+    let line = prefix;
+    let lineHasWord = false;
+    for (const word of words) {
+        if (lineHasWord && visibleLength(line) + 1 + visibleLength(word) > width) {
+            lines.push(line);
+            line = indent + word;
+        }
+        else {
+            line += (lineHasWord ? " " : "") + word;
+        }
+        lineHasWord = true;
+    }
+    lines.push(line);
+    return lines.map((value) => value.replaceAll(KEEP, " ").trimEnd());
+}
+/** Builds the lines of one command's output in a given style. */
+export class Output {
+    style;
+    lines = [];
+    constructor(style) {
+        this.style = style;
+    }
+    paint(open, close, text) {
+        return this.style.rich && text !== "" ? `\u001b[${open}m${text}\u001b[${close}m` : text;
+    }
+    bold(text) { return this.paint("1", "22", text); }
+    dim(text) { return this.paint("2", "22", text); }
+    /** A command or other text the reader types: bold, and never wrapped apart. */
+    code(text) { return this.bold(text.replaceAll(" ", KEEP)); }
+    path(path) { return displayPath(path, this.style.home).replaceAll(" ", KEEP); }
+    /** " · " between short facts on one line. */
+    get separator() { return this.style.rich ? " · " : ", "; }
+    mark(kind) {
+        if (!this.style.rich)
+            return kind === "ok" ? "" : `${kind}: `;
+        return kind === "ok" ? `${this.paint("32", "39", "✓")} ` : kind === "warning" ? `${this.paint("33", "39", "!")} ` : `${this.paint("31", "39", "✗")} `;
+    }
+    /** An outcome line, flush left: "✓ Lore 0.2.27 is installed". */
+    outcome(kind, text) {
+        const mark = this.mark(kind);
+        // Plain warnings keep their "warning: " prefix; rich marks hang their text.
+        this.lines.push(...wrap(text, this.style.width, mark, this.style.rich ? "  " : " ".repeat(visibleLength(mark))));
+        return this;
+    }
+    /** A secondary line under an outcome, indented and dim. */
+    note(text, indent = 2) {
+        const pad = " ".repeat(indent);
+        this.lines.push(...wrap(text, this.style.width, pad).map((line) => pad + this.dim(line.slice(indent))));
+        return this;
+    }
+    /** An indented line in normal weight. */
+    text(text, indent = 2) {
+        this.lines.push(...wrap(text, this.style.width, " ".repeat(indent)));
+        return this;
+    }
+    /** Two columns: a padded label and wrapped text that hangs under itself, after any mark. */
+    row(label, labelWidth, text, mark = "", indent = 2) {
+        const prefix = `${" ".repeat(indent)}${label.padEnd(labelWidth)}   ${mark}`;
+        this.lines.push(...wrap(text, this.style.width, prefix));
+        return this;
+    }
+    /** A bold heading and its numbered steps; nothing when there are no steps. */
+    steps(heading, items) {
+        const unique = [...new Set(items)];
+        if (unique.length === 0)
+            return this;
+        this.blank().lines.push(this.bold(heading));
+        unique.forEach((item, index) => this.lines.push(...wrap(item, this.style.width, `  ${index + 1}. `)));
+        return this;
+    }
+    /** Lines printed exactly, for blocks the reader copies. */
+    verbatim(text) {
+        this.lines.push(...text.split("\n"));
+        return this;
+    }
+    blank() {
+        if (this.lines.length > 0 && this.lines.at(-1) !== "")
+            this.lines.push("");
+        return this;
+    }
+    get empty() { return this.lines.length === 0; }
+    toString() {
+        while (this.lines.at(-1) === "")
+            this.lines.pop();
+        return this.lines.length === 0 ? "" : `${this.lines.join("\n")}\n`;
+    }
+}
+//# sourceMappingURL=terminal-output.js.map

package/dist/terminal-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-output.js","sourceRoot":"","sources":["../src/terminal-output.ts"],"names":[],"mappings":"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"}

package/dist/uninstall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,+kBAmB1B,CAAC;AAEF,UAAU,gBAAgB;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAqFD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BxG"}
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,+kBAmB1B,CAAC;AAEF,UAAU,gBAAgB;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAsED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BxG"}

package/dist/uninstall.js

@@ -1,9 +1,9 @@
-import { spawn, isWindows, removeAfterExit, renameWindowsBinary } from "./platform.js";
+import { isWindows, removeAfterExit, renameWindowsBinary } from "./platform.js";
+import { assertNpmInstallationWritable, findGlobalNpmInstallation, npm, runningPackageDirectory } from "./npm-installation.js";
 import { constants } from "node:fs";
-import { access, readFile, realpath, stat, unlink } from "node:fs/promises";
-import { basename, dirname, resolve } from "node:path";
+import { access, realpath, stat, unlink } from "node:fs/promises";
+import { dirname } from "node:path";
 import { createInterface } from "node:readline/promises";
-import { fileURLToPath } from "node:url";
 import { IS_STANDALONE_BINARY } from "./version.js";
 export const UNINSTALL_HELP = `lore uninstall
 Disconnect this machine and remove the installed Lore CLI.
@@ -25,18 +25,8 @@ Examples:
   lore uninstall
   lore uninstall --yes
 `;
-async function npm(args) {
-    return new Promise((done, reject) => {
-        const child = spawn("npm", args, { stdio: ["ignore", "pipe", "pipe"], windowsHide: true });
-        let output = "";
-        const timer = setTimeout(() => { child.kill(); reject(new Error("npm timed out")); }, 60_000);
-        child.stdout.on("data", chunk => { output += chunk; if (output.length > 1024 * 1024)
-            child.kill(); });
-        child.stderr.resume();
-        child.once("error", error => { clearTimeout(timer); reject(error); });
-        child.once("close", code => { clearTimeout(timer); code === 0 ? done(output.trim()) : reject(new Error("npm could not complete uninstall")); });
-    });
-}
+/** JSON quoting shows stray control characters, but keeps Windows separators single so the path can be copied. */
+const quotedPath = (path) => JSON.stringify(path).replaceAll("\\\\", "\\");
 async function planUninstall(options) {
     if (options.isStandaloneBinary ?? IS_STANDALONE_BINARY) {
         const target = await realpath(options.execPath ?? process.execPath);
@@ -63,28 +53,20 @@ async function planUninstall(options) {
             },
         };
     }
-    const target = await realpath(options.packageDirectory ?? fileURLToPath(new URL("..", import.meta.url)));
-    const manifest = JSON.parse(await readFile(resolve(target, "package.json"), "utf8"));
-    const modules = dirname(dirname(target));
+    const runNpm = options.runNpm ?? ((args) => npm(args, 60_000, "npm could not complete uninstall"));
+    const installation = await findGlobalNpmInstallation(options.packageDirectory ?? runningPackageDirectory(), runNpm);
     // Never remove a checkout, npx cache, project dependency, or another manager's store.
-    if (manifest.name !== "@lore-co/cli" || basename(target) !== "cli" || basename(dirname(target)) !== "@lore-co" || basename(modules) !== "node_modules" || (!isWindows() && basename(dirname(modules)) !== "lib")) {
+    if (installation.kind === "other") {
         throw new Error("This is not a standalone or global npm installation. Run lore disconnect, then remove Lore with the package manager you used to install it.");
     }
-    const prefix = isWindows() ? dirname(modules) : dirname(dirname(modules));
-    const runNpm = options.runNpm ?? npm;
-    const reportedRoot = (await runNpm(["root", "--global"])).trim();
-    let reportedModules;
-    try {
-        reportedModules = await realpath(reportedRoot);
-    }
-    catch {
-        throw new Error(`Could not verify the npm installation. Nothing was removed. npm's global directory could not be resolved: ${JSON.stringify(reportedRoot)}. Check "npm config get prefix" and retry with the npm configuration used to install Lore.`);
+    if (installation.kind === "unresolved") {
+        throw new Error(`Could not verify the npm installation. Nothing was removed. npm's global directory could not be resolved: ${quotedPath(installation.reportedRoot)}. Check "npm config get prefix" and retry with the npm configuration used to install Lore.`);
     }
-    if (reportedModules !== modules) {
+    if (installation.kind === "mismatch") {
         throw new Error("Could not verify the npm installation. Nothing was removed.");
     }
-    await access(dirname(target), constants.W_OK);
-    await access(isWindows() ? prefix : resolve(prefix, "bin"), constants.W_OK);
+    const { target, prefix } = installation;
+    await assertNpmInstallationWritable(installation);
     return {
         kind: "npm", target,
         remove: async () => {

package/dist/uninstall.js.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"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"}

package/dist/update.d.ts

@@ -1,3 +1,5 @@
+import { type OutputStyle } from "./terminal-output.js";
+import { type RunNpm } from "./npm-installation.js";
 export type UpdateFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
 export interface UpdateCommandOptions {
     platform?: NodeJS.Platform;
@@ -8,7 +10,14 @@ export interface UpdateCommandOptions {
     execPath?: string;
     homeDirectory?: string;
     runVersion?: (path: string, timeoutMs: number) => Promise<string>;
+    /** Runs `internal refresh-integrations` with the installed CLI and returns its report. */
+    runRefresh?: (command: readonly string[], environment: NodeJS.ProcessEnv, timeoutMs: number) => Promise<string>;
+    /** The npm package directory this CLI runs from, when it is not a standalone binary. */
+    packageDirectory?: string;
+    runNpm?: RunNpm;
     writeOutput?: (message: string) => void;
+    /** How to draw the output; detected from stdout when omitted. */
+    style?: OutputStyle;
 }
 export declare function isReleaseTag(value: string): boolean;
 export declare function parseUpdateVersion(args: readonly string[]): string | undefined | null;
@@ -17,6 +26,13 @@ export declare function parseReleaseBaseUrl(repository: string, configuredBase?:
 export declare function buildReleaseAssetUrl(releaseBase: URL, tag: string, asset: string): URL;
 export declare function parseChecksumManifest(manifest: string, expectedAsset: string): string;
 export declare function resolveLatestReleaseTag(repository: string, fetcher?: UpdateFetch): Promise<string>;
-export declare function selectUpdateTarget(environment: NodeJS.ProcessEnv, isStandaloneBinary: boolean, execPath: string, homeDirectory: string, canWriteSystemBin?: () => Promise<boolean>, platform?: NodeJS.Platform): Promise<string>;
+/**
+ * The standalone binary to replace, or null for a CLI installed with a
+ * package manager, which is updated through that package manager instead:
+ * installing a binary beside it would leave two copies, with the agent hooks
+ * on one and `lore` on PATH possibly the other. LORE_BIN_DIR installs a
+ * standalone binary on purpose.
+ */
+export declare function selectUpdateTarget(environment: NodeJS.ProcessEnv, isStandaloneBinary: boolean, execPath: string, platform?: NodeJS.Platform): string | null;
 export declare function updateCommand(args: readonly string[], options?: UpdateCommandOptions): Promise<void>;
 //# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAkDA,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,GAAG,SAAS,GAAG,IAAI,CAgB3B;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzE;AAmBD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,GAAG,CAoCL;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,GAAG,CAQL;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,MAAM,CAqBR;AAwDD,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAcD,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,CAAC,UAAU,EAC9B,kBAAkB,EAAE,OAAO,EAC3B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,iBAAiB,GAAE,MAAM,OAAO,CAAC,OAAO,CAOvC,EACD,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,MAAM,CAAC,CAajB;AAuGD,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAqFf"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,EAAsH,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAmCxK,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,0FAA0F;IAC1F,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChH,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,iEAAiE;IACjE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,GAAG,SAAS,GAAG,IAAI,CAG3B;AAyBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzE;AAmBD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,GAAG,CAoCL;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,GAAG,CAQL;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,MAAM,CAqBR;AAwDD,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAcD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,CAAC,UAAU,EAC9B,kBAAkB,EAAE,OAAO,EAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,GAAG,IAAI,CAMf;AAkND,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAiGf"}

package/dist/update.js

@@ -1,13 +1,13 @@
 import { removeAfterExit, renameWindowsBinary } from "./platform.js";
 import { execFile } from "node:child_process";
 import { createHash, timingSafeEqual } from "node:crypto";
-import { constants } from "node:fs";
-import { access, chmod, mkdir, mkdtemp, readFile, rename, rm, writeFile, } from "node:fs/promises";
-import { homedir } from "node:os";
+import { chmod, mkdir, mkdtemp, readFile, rename, rm, writeFile, } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
 import { IS_STANDALONE_BINARY } from "./version.js";
+import { Output, detectOutputStyle, outputStyleEnvironment } from "./terminal-output.js";
+import { assertNpmInstallationWritable, findGlobalNpmInstallation, npm, runningPackageDirectory } from "./npm-installation.js";
 const DEFAULT_REPOSITORY = "treadiehq/lore-releases";
 const DOWNLOAD_TIMEOUT_MS = 15_000;
 const VERSION_CHECK_TIMEOUT_MS = 10_000;
@@ -20,10 +20,11 @@ const UPDATE_HELP = `lore update
 Install the latest Lore CLI binary, or a specific release.
 
 Usage:
-  lore update [--version <tag>]
+  lore update [--version <tag>] [--verbose]
 
 Options:
-  --version <tag>  Release tag to install, for example v0.2.25
+  --version <tag>  Release tag to install, for example v0.2.27
+  --verbose        Also show where Lore is installed and each file refreshed
   -h, --help       Show this help
 
 Environment:
@@ -31,18 +32,28 @@ Environment:
   LORE_RELEASE_BASE_URL  HTTPS release mirror base
   LORE_BIN_DIR           Directory for the standalone binary
 
+A global npm installation is updated with npm.
+
 Examples:
   lore update
-  lore update --version v0.2.25
+  lore update --version v0.2.27
 `;
 export function isReleaseTag(value) {
     return RELEASE_TAG_PATTERN.test(value);
 }
 export function parseUpdateVersion(args) {
+    const parsed = parseUpdateArguments(args);
+    return parsed === null ? null : parsed.version;
+}
+function parseUpdateArguments(args) {
     if (args.includes("--help") || args.includes("-h")) {
         process.stdout.write(UPDATE_HELP);
         return null;
     }
+    const verbose = args.includes("--verbose");
+    return { version: parseVersionArgument(args.filter((argument) => argument !== "--verbose")), verbose };
+}
+function parseVersionArgument(args) {
     if (args.length === 0) {
         return undefined;
     }
@@ -51,7 +62,7 @@ export function parseUpdateVersion(args) {
         if (version !== undefined && isReleaseTag(version)) {
             return version;
         }
-        throw new Error("--version must be a release tag such as v0.2.25");
+        throw new Error("--version must be a release tag such as v0.2.27");
     }
     throw new Error("Unknown update options. Try: lore update --help");
 }
@@ -215,28 +226,19 @@ async function defaultRunVersion(path, timeoutMs) {
     });
     return result.stdout;
 }
-export async function selectUpdateTarget(environment, isStandaloneBinary, execPath, homeDirectory, canWriteSystemBin = async () => {
-    try {
-        await access("/usr/local/bin", constants.W_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}, platform = process.platform) {
+/**
+ * The standalone binary to replace, or null for a CLI installed with a
+ * package manager, which is updated through that package manager instead:
+ * installing a binary beside it would leave two copies, with the agent hooks
+ * on one and `lore` on PATH possibly the other. LORE_BIN_DIR installs a
+ * standalone binary on purpose.
+ */
+export function selectUpdateTarget(environment, isStandaloneBinary, execPath, platform = process.platform) {
     const configuredDirectory = environment.LORE_BIN_DIR?.trim();
     if (configuredDirectory !== undefined && configuredDirectory !== "") {
         return resolve(configuredDirectory, platform === "win32" ? "lore.exe" : "lore");
     }
-    if (isStandaloneBinary) {
-        return execPath;
-    }
-    if (platform === "win32")
-        return resolve(environment.LOCALAPPDATA || resolve(homeDirectory, "AppData/Local"), "Lore", "bin", "lore.exe");
-    if (await canWriteSystemBin()) {
-        return "/usr/local/bin/lore";
-    }
-    return resolve(homeDirectory, ".local", "bin", "lore");
+    return isStandaloneBinary ? execPath : null;
 }
 async function prepareStagingDirectory(target) {
     try {
@@ -307,52 +309,150 @@ async function replaceTarget(stagedBinary, target, platform) {
         throw new Error("Could not replace the Lore binary");
     }
 }
+/** The first release whose binary has `lore internal refresh-integrations`. */
+const REFRESH_COMMAND_VERSION = [0, 2, 26];
+const REFRESH_TIMEOUT_MS = 120_000;
+function hasRefreshCommand(version) {
+    const parts = /^(\d+)\.(\d+)\.(\d+)/u.exec(version)?.slice(1).map(Number) ?? [];
+    for (let index = 0; index < REFRESH_COMMAND_VERSION.length; index += 1) {
+        const part = parts[index] ?? 0;
+        if (part !== REFRESH_COMMAND_VERSION[index])
+            return part > REFRESH_COMMAND_VERSION[index];
+    }
+    return true;
+}
+async function defaultRunRefresh(command, environment, timeoutMs) {
+    try {
+        const result = await executeFile(command[0], [...command.slice(1), "internal", "refresh-integrations"], {
+            encoding: "utf8",
+            env: environment,
+            maxBuffer: 1024 * 1024,
+            timeout: timeoutMs,
+            windowsHide: true,
+        });
+        return result.stdout;
+    }
+    catch (error) {
+        // Surface the installed binary's own `Error: ...` line, not the exec wrapper's.
+        const stderr = error.stderr;
+        const detail = typeof stderr === "string"
+            ? stderr.trim().split(/\r?\n/u).find((line) => line.startsWith("Error: "))?.slice("Error: ".length)
+            : undefined;
+        throw new Error(detail ?? "the installed binary could not run the refresh");
+    }
+}
 /**
- * Re-apply the Lore hook and MCP entries and the `lore` skill for the agents
- * in the stored connection so the new binary runs with current entries and no
- * reconnect. Skipped silently when nothing is connected.
+ * Re-apply the Lore hook and MCP entries, the skills, and the Lore agent for
+ * the stored connection so the new binary runs with current files and no
+ * reconnect. The refresh runs in the installed binary: this process bundles
+ * the previous version's files, so writing or comparing them here would leave
+ * stale files reported as current. Skipped silently when nothing is connected.
  */
-async function refreshStoredAgentEntries(homeDirectory, environment, version, writeOutput) {
-    // Loaded on demand: cli.ts imports this module, and the refresh is only
+async function refreshWithInstalledBinary(command, homeDirectory, environment, version, writeOutput, runRefresh, style) {
+    // Loaded on demand: cli.ts imports this module, and the check is only
     // needed once a binary has been replaced.
-    const { getLorePaths, refreshAgentEntries } = await import("./cli.js");
-    let refreshed;
+    const { getLorePaths, readConnectorConfig } = await import("./cli.js");
+    const connected = await readConnectorConfig(getLorePaths(homeDirectory, environment)).then((config) => config !== null, () => true);
+    if (!connected)
+        return;
+    if (!hasRefreshCommand(version)) {
+        const out = new Output(style);
+        writeOutput("\n" + out.steps("Next", [`Run ${out.code("lore connect")} once to refresh your agents for Lore ${version}.`]).toString());
+        return;
+    }
+    const childEnvironment = {
+        ...environment,
+        // The child's stdout is a pipe; it draws for this process's terminal instead.
+        ...outputStyleEnvironment(style),
+        ...(homeDirectory === undefined ? {} : { HOME: homeDirectory, USERPROFILE: homeDirectory }),
+    };
+    // A standalone parent may run with these set; they would turn the child into Bun itself.
+    delete childEnvironment.BUN_BE_BUN;
+    delete childEnvironment.BUN_OPTIONS;
+    let report;
     try {
-        refreshed = await refreshAgentEntries(getLorePaths(homeDirectory, environment));
+        report = await runRefresh(command, childEnvironment, REFRESH_TIMEOUT_MS);
     }
     catch (error) {
         const detail = (error instanceof Error ? error.message : String(error)).replace(/\.$/u, "");
-        throw new Error(`Lore ${version} is installed, but its agent entries could not be refreshed: ${detail}. Run lore connect to retry.`);
+        throw new Error(`Lore ${version} is installed, but its agent entries could not be refreshed: ${detail}. Run lore connect to refresh them.`);
     }
-    if (refreshed === null) {
-        return;
+    if (report !== "")
+        writeOutput(report.endsWith("\n") ? report : `${report}\n`);
+}
+const NPM_INSTALL_TIMEOUT_MS = 300_000;
+/**
+ * Update a global npm installation in place with npm, then refresh with the
+ * package npm installed. Anything npm can't safely update for us, such as a
+ * pnpm install or a checkout, gets the command to run instead.
+ */
+async function updateNpmInstallation(version, options, environment, writeOutput, style) {
+    const spec = `@lore-co/cli@${version === undefined ? "latest" : version.slice(1)}`;
+    const runNpm = options.runNpm ?? ((args) => npm(args, NPM_INSTALL_TIMEOUT_MS, `npm could not install ${spec}`));
+    const installation = await findGlobalNpmInstallation(options.packageDirectory ?? runningPackageDirectory(), runNpm)
+        .catch(() => ({ kind: "mismatch" }));
+    if (installation.kind === "other") {
+        throw new Error(`lore update can't update this installation. Update Lore with the package manager you installed it with, for example: pnpm add --global ${spec}`);
+    }
+    if (installation.kind !== "npm") {
+        throw new Error(`Could not verify the npm installation, so nothing was changed. Update Lore with: npm install -g ${spec}`);
+    }
+    try {
+        await assertNpmInstallationWritable(installation);
+    }
+    catch {
+        throw new Error(`Updating Lore needs permission to write to ${installation.prefix}, so nothing was changed. Update Lore with: npm install -g ${spec}`);
     }
-    writeOutput(refreshed.changedFiles.length > 0
-        ? `Refreshed Lore entries in ${refreshed.changedFiles.join(", ")}\n`
-        : `Lore entries already current in ${refreshed.configFiles.join(", ")}\n`);
-    if (refreshed.skillFiles.length > 0) {
-        writeOutput(`Lore ${refreshed.skillFiles.length > 1 ? "skills" : "skill"} current at ${refreshed.skillFiles.join(", ")}\n`);
+    try {
+        await runNpm(["install", "--global", "--prefix", installation.prefix, "--ignore-scripts", spec]);
+    }
+    catch {
+        throw new Error(`npm could not install ${spec}. Run it yourself to see why: npm install -g ${spec}`);
+    }
+    let installed;
+    try {
+        installed = JSON.parse(await readFile(resolve(installation.target, "package.json"), "utf8")).version;
     }
-    if (refreshed.agentFiles.length > 0) {
-        writeOutput(`Lore agent current at ${refreshed.agentFiles.join(", ")}\n`);
+    catch {
+        installed = undefined;
     }
-    for (const warning of refreshed.warnings) {
-        writeOutput(`warning: ${warning}\n`);
+    if (typeof installed !== "string" || !isReleaseTag(`v${installed}`) || (version !== undefined && installed !== version.slice(1))) {
+        throw new Error(`npm finished, but ${spec} is not what is installed at ${installation.target}. Update Lore with: npm install -g ${spec}`);
     }
+    writeOutput(installedMessage(installed, installation.target, style));
+    await refreshWithInstalledBinary([process.execPath, resolve(installation.target, "dist", "cli.js")], options.homeDirectory, environment, installed, writeOutput, options.runRefresh ?? defaultRunRefresh, style);
+}
+/** The outcome line; --verbose adds where the binary or package lives. */
+function installedMessage(version, location, style) {
+    const out = new Output(style).outcome("ok", `Lore ${version} is installed`);
+    if (style.verbose)
+        out.note(`at ${out.path(location)}`);
+    return out.toString();
 }
 export async function updateCommand(args, options = {}) {
-    const version = parseUpdateVersion(args);
-    if (version === null) {
+    const parsed = parseUpdateArguments(args);
+    if (parsed === null) {
         return;
     }
+    const version = parsed.version;
     const environment = options.environment ?? process.env;
+    const style = options.style ?? detectOutputStyle({
+        verbose: parsed.verbose,
+        environment,
+        ...(options.homeDirectory === undefined ? {} : { home: options.homeDirectory }),
+    });
     const platform = options.platform ?? process.platform;
     const repository = parseRepository(environment);
     const releaseBase = parseReleaseBaseUrl(repository, environment.LORE_RELEASE_BASE_URL);
     const asset = selectReleaseAsset(platform, options.arch ?? process.arch);
+    const writeOutput = options.writeOutput ?? ((message) => process.stdout.write(message));
+    const target = selectUpdateTarget(environment, options.isStandaloneBinary ?? IS_STANDALONE_BINARY, options.execPath ?? process.execPath, platform);
+    if (target === null) {
+        await updateNpmInstallation(version, options, environment, writeOutput, style);
+        return;
+    }
     const tag = version ??
         (await resolveLatestReleaseTag(repository, options.fetch ?? fetch));
-    const target = await selectUpdateTarget(environment, options.isStandaloneBinary ?? IS_STANDALONE_BINARY, options.execPath ?? process.execPath, options.homeDirectory ?? homedir(), undefined, platform);
     const directory = await prepareStagingDirectory(target);
     const stagedBinary = resolve(directory, asset);
     try {
@@ -378,9 +478,8 @@ export async function updateCommand(args, options = {}) {
             throw new Error("The staged Lore binary version did not match the release tag");
         }
         await replaceTarget(stagedBinary, target, platform);
-        const writeOutput = options.writeOutput ?? ((message) => process.stdout.write(message));
-        writeOutput(`Updated Lore to ${expectedVersion} at ${target}\n`);
-        await refreshStoredAgentEntries(options.homeDirectory, environment, expectedVersion, writeOutput);
+        writeOutput(installedMessage(expectedVersion, target, style));
+        await refreshWithInstalledBinary([target], options.homeDirectory, environment, expectedVersion, writeOutput, options.runRefresh ?? defaultRunRefresh, style);
     }
     finally {
         await rm(directory, { recursive: true, force: true }).catch(() => undefined);