expect(hints.join("\n")).toContain("npm config set prefix ~/.local");

});

it("returns EACCES hint for staged package permission failures", () => {

const result = makeResult(

"global install stage",

"EACCES: permission denied, mkdtemp '/usr/local/lib/node_modules/.openclaw-update-stage-'",

);

const hints = inferUpdateFailureHints(result);

expect(hints.join("\n")).toContain("EACCES");

expect(hints.join("\n")).toContain("npm config set prefix ~/.local");

});

it("returns native optional dependency hint for node-gyp failures", () => {

const result = makeResult("global update", "node-pre-gyp ERR!\nnode-gyp rebuild failed");

const hints = inferUpdateFailureHints(result);

const stderr = normalizeLowercaseStringOrEmpty(failedStep.stderrTail);

const hints: string[] = [];

const isGlobalPackageInstallStep =

failedStep.name.startsWith("global update") || failedStep.name.startsWith("global install");

if (failedStep.name.startsWith("global update") && stderr.includes("eacces")) {

if (isGlobalPackageInstallStep && stderr.includes("eacces")) {

hints.push(

"Detected permission failure (EACCES). Re-run with a writable global prefix or sudo (for system-managed Node installs).",

);

if (!stagePrefix) {

throw new Error("missing staged prefix");

}

expect(path.dirname(stagePrefix)).toBe(globalRoot);

await writePackageRoot(

path.join(stagePrefix, "lib", "node_modules", "openclaw"),

"2.0.0",

if (!targetLayout) {

return null;

}

const prefix = await fs.mkdtemp(path.join(targetLayout.prefix, ".openclaw-update-stage-"));

await fs.mkdir(targetLayout.globalRoot, { recursive: true });

const prefix = await fs.mkdtemp(path.join(targetLayout.globalRoot, ".openclaw-update-stage-"));

const layout = resolveNpmGlobalPrefixLayoutFromPrefix(prefix);

return {

prefix,