threadnote 1.1.3 → 1.1.4

package/dist/mcp_server.cjs

@@ -33081,7 +33081,6 @@ var StreamableHTTPClientTransport = class {
 
 // src/mcp_server.ts
 var import_promises5 = require("node:fs/promises");
-var import_node_os3 = require("node:os");
 var import_node_path5 = require("node:path");
 
 // src/constants.ts
@@ -35724,6 +35723,7 @@ var jsYaml = {
 // src/utils.ts
 var import_node_child_process = require("node:child_process");
 var import_node_crypto = require("node:crypto");
+var import_node_fs = require("node:fs");
 var import_promises = require("node:fs/promises");
 var import_node_os = require("node:os");
 var import_node_path = require("node:path");
@@ -35778,18 +35778,57 @@ function redactText(content) {
   ).replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/gi, "Bearer [REDACTED]").replace(/sk-[A-Za-z0-9_-]{16,}/g, "sk-[REDACTED]").replace(/gh[pousr]_[A-Za-z0-9_]{16,}/g, "gh_[REDACTED]");
 }
 async function requiredOpenVikingCli() {
-  const command2 = await findExecutable(["ov", "openviking"]);
+  const command2 = await findOpenVikingCli();
   if (!command2) {
-    throw new Error("Neither ov nor openviking was found in PATH. Run threadnote install first.");
+    throw new Error(
+      "Neither ov nor openviking was found in PATH, uv tool bin dir, $UV_TOOL_BIN_DIR, or ~/.local/bin. Run threadnote install first."
+    );
   }
   return command2;
 }
 async function openVikingCliForMode(dryRun) {
   if (dryRun) {
-    return await findExecutable(["ov", "openviking"]) ?? "ov";
+    return await findOpenVikingCli() ?? "ov";
   }
   return requiredOpenVikingCli();
 }
+async function findOpenVikingCli() {
+  const override = process.env.THREADNOTE_OV?.trim();
+  if (override) {
+    return override;
+  }
+  const onPath = await findExecutable(["ov", "openviking"]);
+  if (onPath) {
+    return onPath;
+  }
+  for (const candidateDir of await openVikingToolCandidateDirs()) {
+    for (const command2 of ["ov", "openviking"]) {
+      const candidate = (0, import_node_path.join)(candidateDir, command2);
+      if (await isExecutable(candidate)) {
+        return candidate;
+      }
+    }
+  }
+  return void 0;
+}
+async function openVikingToolCandidateDirs() {
+  const dirs = [];
+  const uv = await findExecutable(["uv"]);
+  if (uv) {
+    const result = await runCommand(uv, ["tool", "dir", "--bin"], { allowFailure: true });
+    if (result.exitCode === 0) {
+      const dir = result.stdout.trim();
+      if (dir) {
+        dirs.push(dir);
+      }
+    }
+  }
+  if (process.env.UV_TOOL_BIN_DIR) {
+    dirs.push(process.env.UV_TOOL_BIN_DIR);
+  }
+  dirs.push((0, import_node_path.join)((0, import_node_os.homedir)(), ".local", "bin"));
+  return Array.from(new Set(dirs));
+}
 async function requiredExecutable(command2) {
   const executable = await findExecutable([command2]);
   if (!executable) {
@@ -35946,6 +35985,14 @@ async function exists(path) {
     return false;
   }
 }
+async function isExecutable(path) {
+  try {
+    await (0, import_promises.access)(path, import_node_fs.constants.X_OK);
+    return true;
+  } catch (_err) {
+    return false;
+  }
+}
 async function isFile(path) {
   try {
     return (await (0, import_promises.stat)(path)).isFile();
@@ -40006,23 +40053,12 @@ function withIdentity2(config2, args) {
   return [...args, "--account", config2.account, "--user", config2.user, "--agent-id", config2.agentId];
 }
 async function requiredOpenVikingCli2() {
-  const command2 = process.env.THREADNOTE_OV ?? await findExecutable(["ov", "openviking"]) ?? await firstExistingPath([(0, import_node_path5.join)((0, import_node_os3.homedir)(), ".local", "bin", "ov"), (0, import_node_path5.join)((0, import_node_os3.homedir)(), ".local", "bin", "openviking")]);
+  const command2 = await findOpenVikingCli();
   if (!command2) {
     throw new Error("Neither ov nor openviking was found. Run threadnote install first.");
   }
   return command2;
 }
-async function firstExistingPath(paths) {
-  for (const path of paths) {
-    try {
-      await (0, import_promises5.access)(path);
-      return await (0, import_promises5.realpath)(path);
-    } catch (_err) {
-      continue;
-    }
-  }
-  return void 0;
-}
 main().catch((err) => {
   process.stderr.write(`${errorMessage(err)}
 `);

package/dist/threadnote.cjs

@@ -3484,7 +3484,7 @@ var PYTHON_SYSTEM_CERTS_PACKAGE = "pip-system-certs";
 var LAUNCHD_LABEL = "io.threadnote.openviking";
 var MAX_SECRET_MATCHES_TO_PRINT = 5;
 var START_HEALTH_POLL_INTERVAL_MS = 500;
-var START_HEALTH_TIMEOUT_MS = 15e3;
+var START_HEALTH_TIMEOUT_MS = 6e4;
 var SHIM_MARKER = "Generated by threadnote";
 var USER_INSTRUCTIONS_START_MARKER = "<!-- BEGIN THREADNOTE USER INSTRUCTIONS -->";
 var USER_INSTRUCTIONS_END_MARKER = "<!-- END THREADNOTE USER INSTRUCTIONS -->";
@@ -3743,18 +3743,57 @@ function escapeRegExp(value) {
   return value.replace(/[\\^$+?.()|[\]{}]/g, "\\$&");
 }
 async function requiredOpenVikingCli() {
-  const command2 = await findExecutable(["ov", "openviking"]);
+  const command2 = await findOpenVikingCli();
   if (!command2) {
-    throw new Error("Neither ov nor openviking was found in PATH. Run threadnote install first.");
+    throw new Error(
+      "Neither ov nor openviking was found in PATH, uv tool bin dir, $UV_TOOL_BIN_DIR, or ~/.local/bin. Run threadnote install first."
+    );
   }
   return command2;
 }
 async function openVikingCliForMode(dryRun) {
   if (dryRun) {
-    return await findExecutable(["ov", "openviking"]) ?? "ov";
+    return await findOpenVikingCli() ?? "ov";
   }
   return requiredOpenVikingCli();
 }
+async function findOpenVikingCli() {
+  const override = process.env.THREADNOTE_OV?.trim();
+  if (override) {
+    return override;
+  }
+  const onPath = await findExecutable(["ov", "openviking"]);
+  if (onPath) {
+    return onPath;
+  }
+  for (const candidateDir of await openVikingToolCandidateDirs()) {
+    for (const command2 of ["ov", "openviking"]) {
+      const candidate = (0, import_node_path.join)(candidateDir, command2);
+      if (await isExecutable(candidate)) {
+        return candidate;
+      }
+    }
+  }
+  return void 0;
+}
+async function openVikingToolCandidateDirs() {
+  const dirs = [];
+  const uv = await findExecutable(["uv"]);
+  if (uv) {
+    const result = await runCommand(uv, ["tool", "dir", "--bin"], { allowFailure: true });
+    if (result.exitCode === 0) {
+      const dir = result.stdout.trim();
+      if (dir) {
+        dirs.push(dir);
+      }
+    }
+  }
+  if (process.env.UV_TOOL_BIN_DIR) {
+    dirs.push(process.env.UV_TOOL_BIN_DIR);
+  }
+  dirs.push((0, import_node_path.join)((0, import_node_os.homedir)(), ".local", "bin"));
+  return Array.from(new Set(dirs));
+}
 async function requiredExecutable(command2) {
   const executable = await findExecutable([command2]);
   if (!executable) {
@@ -12381,7 +12420,7 @@ async function maybeRunPostUpdateAfterRepair(config, options) {
   });
 }
 async function ensurePinnedOpenVikingInstalled(config, options) {
-  const ov = await findExecutable(["ov", "openviking"]);
+  const ov = await findOpenVikingCli();
   if (!ov) {
     return;
   }
@@ -12813,7 +12852,7 @@ async function collectDoctorChecks(config, options = {}) {
   checks.push(await commandCheck("node", ["--version"]));
   checks.push(await commandCheck("python3", ["--version"]));
   checks.push(await openVikingServerCheck());
-  checks.push(await firstCommandCheck("openviking cli", ["ov", "openviking"], ["--help"]));
+  checks.push(await openVikingCliCheck());
   checks.push(await localEmbeddingCheck());
   checks.push(await pythonSystemCertificatesCheck());
   checks.push(await firstCommandCheck("python installer", ["pipx", "uv", "pip3"], ["--version"]));
@@ -13018,9 +13057,9 @@ async function repairManifest(config, dryRun) {
 }
 async function repairRecallIndex(config, dryRun) {
   console.log("\nRepairing recall index freshness.");
-  const ov = dryRun ? await findExecutable(["ov", "openviking"]) ?? "ov" : await findExecutable(["ov", "openviking"]);
+  const ov = dryRun ? await findOpenVikingCli() ?? "ov" : await findOpenVikingCli();
   if (!ov) {
-    console.log("Skipping recall index repair: neither ov nor openviking was found in PATH.");
+    console.log("Skipping recall index repair: neither ov nor openviking was found.");
     return;
   }
   const progress = startProgress("Scanning recall index freshness across memories and seeded resources.");
@@ -13071,7 +13110,7 @@ async function repairRecallIndex(config, dryRun) {
   }
 }
 async function configureOpenVikingCliLanguage(config, dryRun) {
-  const ov = dryRun ? await findExecutable(["ov", "openviking"]) ?? "ov" : await findExecutable(["ov", "openviking"]);
+  const ov = dryRun ? await findOpenVikingCli() ?? "ov" : await findOpenVikingCli();
   if (!ov) {
     return;
   }
@@ -13197,7 +13236,11 @@ async function runStart(config, options) {
   child.unref();
   await (0, import_promises12.writeFile)((0, import_node_path13.join)(config.agentContextHome, "openviking-server.pid"), `${child.pid}
 `, "utf8");
-  const health = await waitForOpenVikingHealth(config, START_HEALTH_TIMEOUT_MS);
+  const health = await waitForOpenVikingHealth(
+    config,
+    START_HEALTH_TIMEOUT_MS,
+    `Waiting for OpenViking health at ${healthUrl}.`
+  );
   if (health) {
     console.log(`Started OpenViking with pid ${child.pid}. Health OK at ${healthUrl}. Logs: ${logPath}`);
     return;
@@ -13308,6 +13351,20 @@ async function firstCommandCheck(name, commands, args) {
   }
   return { name, status: "fail", detail: `none found: ${commands.join(", ")}` };
 }
+async function openVikingCliCheck() {
+  const executable = await findOpenVikingCli();
+  if (!executable) {
+    return { name: "openviking cli", status: "fail", detail: "none found: ov, openviking" };
+  }
+  const result = await runCommand(executable, ["--help"], { allowFailure: true });
+  const onPath = await findExecutable(["ov", "openviking"]);
+  const detail = onPath ? executable : `${executable} (found outside PATH; add ${(0, import_node_path13.dirname)(executable)} to PATH)`;
+  return {
+    name: "openviking cli",
+    status: result.exitCode === 0 ? "ok" : "warn",
+    detail: result.exitCode === 0 ? detail : firstLine(result.stderr || result.stdout) || detail
+  };
+}
 async function localEmbeddingCheck() {
   const serverPath = await findOpenVikingServer();
   if (!serverPath) {
@@ -13475,21 +13532,26 @@ async function readOpenVikingHealthIfAvailable(config, timeoutMs) {
     return void 0;
   }
 }
-async function waitForOpenVikingHealth(config, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() <= deadline) {
-    const requestTimeoutMs = Math.max(100, Math.min(1e3, deadline - Date.now()));
-    const health = await readOpenVikingHealthIfAvailable(config, requestTimeoutMs);
-    if (health) {
-      return health;
-    }
-    const remainingMs = deadline - Date.now();
-    if (remainingMs <= 0) {
-      break;
+async function waitForOpenVikingHealth(config, timeoutMs, progressMessage) {
+  const progress = progressMessage ? startProgress(progressMessage) : void 0;
+  try {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() <= deadline) {
+      const requestTimeoutMs = Math.max(100, Math.min(1e3, deadline - Date.now()));
+      const health = await readOpenVikingHealthIfAvailable(config, requestTimeoutMs);
+      if (health) {
+        return health;
+      }
+      const remainingMs = deadline - Date.now();
+      if (remainingMs <= 0) {
+        break;
+      }
+      await sleep(Math.min(START_HEALTH_POLL_INTERVAL_MS, remainingMs));
     }
-    await sleep(Math.min(START_HEALTH_POLL_INTERVAL_MS, remainingMs));
+    return void 0;
+  } finally {
+    progress?.stop();
   }
-  return void 0;
 }
 async function runInstallCommands(config, preferred, force, dryRun) {
   let manager = preferred;
@@ -13950,7 +14012,11 @@ async function installLaunchAgent(config, dryRun) {
   await maybeRun(false, "launchctl", ["load", destination]);
   await maybeRun(false, "launchctl", ["start", LAUNCHD_LABEL]);
   const healthUrl = openVikingHealthUrl(config);
-  const health = await waitForOpenVikingHealth(config, START_HEALTH_TIMEOUT_MS);
+  const health = await waitForOpenVikingHealth(
+    config,
+    START_HEALTH_TIMEOUT_MS,
+    `Waiting for OpenViking health at ${healthUrl}.`
+  );
   if (health) {
     console.log(`Installed and started ${LAUNCHD_LABEL}. Health OK at ${healthUrl}`);
     return;

package/docs/troubleshooting.md

@@ -8,7 +8,9 @@ Run:
 threadnote install
 ```
 
-The installer prefers `uv`, then `pipx`, then `python3 -m pip install --user`.
+The installer prefers `uv`, then `pipx`, then `python3 -m pip install --user`. For `curl | sh` installs, the wrapper
+reattaches `threadnote install` to your terminal when possible so it can prompt to install `uv` and continue instead of
+falling straight through to the pip fallback.
 
 ## `uv` Fails With `UnknownIssuer`
 
@@ -83,8 +85,14 @@ For detached starts, logs are written to:
 ~/.openviking/logs/server.log
 ```
 
-If `start` reports that OpenViking did not become healthy, open that log. Certificate failures during the first embedding
-model download are covered above.
+If `start` reports that OpenViking did not become healthy, first check whether it finished shortly after the timeout:
+
+```bash
+threadnote doctor --dry-run
+```
+
+If it still is not healthy, open that log. Certificate failures during the first embedding model download are covered
+above.
 
 ## Port Already In Use
 

package/package.json

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

package/scripts/install.sh

@@ -116,7 +116,11 @@ install_package "$runtime"
 threadnote_bin="$(find_threadnote "$runtime")" || die "Installed $PACKAGE, but could not find the threadnote command."
 
 say "Running threadnote install"
-"$threadnote_bin" install "$@"
+if { true </dev/tty; } 2>/dev/null; then
+  "$threadnote_bin" install "$@" </dev/tty
+else
+  "$threadnote_bin" install "$@"
+fi
 
 if ! have threadnote; then
   say ""