threadnote 1.4.4 → 1.4.5

package/dist/threadnote.cjs

@@ -13703,6 +13703,7 @@ function isUpdateNotificationDisabled() {
 }
 
 // src/lifecycle.ts
+var INSTALL_OUTPUT_TAIL_CHARS = 64e3;
 async function runDoctor(config, options) {
   const checks = await collectDoctorChecks(config, options);
   for (const check of checks) {
@@ -14487,32 +14488,169 @@ async function runInstallCommands(config, preferred, force, dryRun) {
       continue;
     }
     console.log(`Running: ${formatShellCommand(installCommand.executable, installCommand.args)}`);
-    const exitCode = await runInteractive(installCommand.executable, installCommand.args);
-    if (exitCode !== 0) {
-      printOpenVikingInstallFailureHelp(installCommand);
-      throw new Error(`${formatShellCommand(installCommand.executable, installCommand.args)} exited with ${exitCode}.`);
+    const result = await runInstallCommand(installCommand);
+    if (result.exitCode !== 0) {
+      const commandOutput = `${result.stderr}
+${result.stdout}`;
+      const retry = openVikingSourceBuildRetryForArchiveFailure(installCommand, commandOutput);
+      if (retry) {
+        console.error("");
+        console.error(
+          "The prebuilt llama-cpp-python wheel failed ZIP archive validation; retrying with a local source build."
+        );
+        console.error("This avoids the rejected wheel and can take 10-20 minutes.");
+        console.log(`Running: ${formatInstallCommand(retry.command, retry.env)}`);
+        const retryResult = await runInstallCommand(retry.command, retry.env);
+        if (retryResult.exitCode === 0) {
+          continue;
+        }
+        printOpenVikingInstallFailureHelp(retry.command, `${retryResult.stderr}
+${retryResult.stdout}`);
+        throw new Error(
+          `${formatInstallCommand(retry.command, retry.env)} exited with ${retryResult.exitCode} after automatic source-build retry.`
+        );
+      }
+      printOpenVikingInstallFailureHelp(installCommand, commandOutput);
+      throw new Error(
+        `${formatShellCommand(installCommand.executable, installCommand.args)} exited with ${result.exitCode}.`
+      );
     }
   }
 }
-function printOpenVikingInstallFailureHelp(failedCommand) {
-  console.error("");
-  console.error("OpenViking install did not complete.");
-  console.error(
-    "openviking[local-embed] includes llama-cpp-python, which compiles from source when no prebuilt wheel matches your Python/platform \u2014 that build can run 10-20 minutes and is memory-heavy, so it may be killed by the OS (out of memory) or look stuck."
-  );
-  console.error("Re-run it directly to see full output without any wrapper timeout:");
-  console.error(`  ${formatShellCommand(failedCommand.executable, failedCommand.args)}`);
-  console.error("Cap memory use during the compile with: CMAKE_BUILD_PARALLEL_LEVEL=2 <command above>");
+async function runInstallCommand(command2, env = {}) {
+  return new Promise((resolvePromise) => {
+    let stdout2 = "";
+    let stderr = "";
+    let settled = false;
+    const child = (0, import_node_child_process4.spawn)(command2.executable, command2.args, {
+      env: Object.keys(env).length === 0 ? process.env : { ...process.env, ...env },
+      stdio: ["inherit", "pipe", "pipe"]
+    });
+    child.stdout?.on("data", (chunk) => {
+      const text = String(chunk);
+      import_node_process4.stdout.write(text);
+      stdout2 = appendInstallOutputTail(stdout2, text);
+    });
+    child.stderr?.on("data", (chunk) => {
+      const text = String(chunk);
+      import_node_process4.stderr.write(text);
+      stderr = appendInstallOutputTail(stderr, text);
+    });
+    child.on("error", (err) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      const message = errorMessage(err);
+      import_node_process4.stderr.write(`${message}
+`);
+      resolvePromise({ exitCode: 1, stderr: appendInstallOutputTail(stderr, message), stdout: stdout2 });
+    });
+    child.on("close", (code) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      resolvePromise({ exitCode: code ?? 1, stderr, stdout: stdout2 });
+    });
+  });
+}
+function appendInstallOutputTail(current, chunk) {
+  const next = `${current}${chunk}`;
+  return next.length <= INSTALL_OUTPUT_TAIL_CHARS ? next : next.slice(next.length - INSTALL_OUTPUT_TAIL_CHARS);
+}
+function printOpenVikingInstallFailureHelp(failedCommand, commandOutput) {
+  for (const line of openVikingInstallFailureHelpLines(failedCommand, commandOutput)) {
+    console.error(line);
+  }
+}
+function openVikingInstallFailureHelpLines(failedCommand, commandOutput = "") {
+  if (isLlamaWheelArchiveExtractionFailure(commandOutput)) {
+    return [
+      "",
+      "OpenViking install did not complete.",
+      "The prebuilt llama-cpp-python wheel failed ZIP archive validation. Threadnote only falls back to a source build automatically when the failed command came from a prebuilt wheel index."
+    ];
+  }
+  const lines = [
+    "",
+    "OpenViking install did not complete.",
+    "openviking[local-embed] includes llama-cpp-python, which compiles from source when no prebuilt wheel matches your Python/platform \u2014 that build can run 10-20 minutes and is memory-heavy, so it may be killed by the OS (out of memory) or look stuck.",
+    "The package-manager output above contains the underlying build or download error."
+  ];
   if (failedCommand.executable === "uv") {
     if (failedCommand.args.includes("--python")) {
-      console.error(
-        "If uv could not fetch a managed CPython (offline or restricted network), drop the version pin and retry: THREADNOTE_OPENVIKING_PYTHON= threadnote install --force"
+      lines.push(
+        "If uv could not fetch managed CPython, Threadnote cannot complete the local install until that Python download is available."
       );
     }
-    console.error("If it was killed mid-build, clear the partial install first, then retry:");
-    console.error("  uv cache clean");
-    console.error('  rm -rf "$(uv tool dir)/openviking"');
   }
+  return lines;
+}
+function isLlamaWheelArchiveExtractionFailure(output2) {
+  const normalized = output2.toLowerCase();
+  return (normalized.includes("llama-cpp-python") || normalized.includes("llama_cpp_python")) && (normalized.includes("failed to extract archive") || normalized.includes("zip file contains trailing contents after the end-of-central-directory record"));
+}
+function openVikingSourceBuildRetryForArchiveFailure(failedCommand, commandOutput) {
+  if (!isLlamaWheelArchiveExtractionFailure(commandOutput)) {
+    return void 0;
+  }
+  const command2 = withoutExtraIndexUrl(failedCommand);
+  if (!command2) {
+    return void 0;
+  }
+  return { command: command2, env: sourceBuildEnvironment(failedCommand) };
+}
+function withoutExtraIndexUrl(command2) {
+  const args = [];
+  let changed = false;
+  for (let index = 0; index < command2.args.length; index += 1) {
+    const arg = command2.args[index];
+    const next = command2.args[index + 1];
+    if (arg === "--extra-index-url" && next !== void 0) {
+      changed = true;
+      index += 1;
+      continue;
+    }
+    if (arg === "--pip-args" && next?.includes("--extra-index-url") === true) {
+      changed = true;
+      index += 1;
+      continue;
+    }
+    args.push(arg);
+  }
+  return changed ? { ...command2, args } : void 0;
+}
+function formatInstallCommand(command2, env = {}) {
+  return [...formatEnvironmentAssignments(env), formatShellCommand(command2.executable, command2.args)].join(" ");
+}
+function formatEnvironmentAssignments(env) {
+  return Object.entries(env).map(
+    ([key, value]) => key === "CMAKE_ARGS" ? `${key}="${value.replaceAll('"', '\\"')}"` : `${key}=${shellQuote(value)}`
+  );
+}
+function sourceBuildEnvironment(command2) {
+  const env = {};
+  if (extraIndexUrl(command2)?.replace(/\/+$/, "").toLowerCase().endsWith("/metal") === true) {
+    env.CMAKE_ARGS = "-DGGML_METAL=on";
+  }
+  env.CMAKE_BUILD_PARALLEL_LEVEL = "2";
+  return env;
+}
+function extraIndexUrl(command2) {
+  for (let index = 0; index < command2.args.length; index += 1) {
+    const arg = command2.args[index];
+    if (arg === "--extra-index-url") {
+      return command2.args[index + 1];
+    }
+    if (arg === "--pip-args") {
+      const match = command2.args[index + 1]?.match(/(?:^|\s)--extra-index-url\s+(\S+)/);
+      if (match) {
+        return match[1];
+      }
+    }
+  }
+  return void 0;
 }
 async function offerToInstallUv() {
   if (import_node_process4.stdin.isTTY !== true || import_node_process4.stdout.isTTY !== true) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "threadnote",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "type": "commonjs",
   "main": "dist/threadnote.cjs",
   "description": "Shared local context and handoffs for development agents",