probe-research 0.13.1 → 0.14.0

package/bin/probe-research.js

@@ -233,6 +233,32 @@ function cliArgs(args) {
   return args;
 }
 
+/**
+ * Commands that never run on the installed `probe`: they repair it, so they
+ * must not depend on it starting. `npx probe-research repair` runs the newest
+ * release from a throwaway environment, which rebuilds the installed one
+ * (`probe repair`: the install pipeline in repair mode).
+ */
+const REPAIR_VERBS = Object.freeze(["repair"]);
+
+/** Whether a call may be handed to the installed `probe` (else: the newest, throwaway). */
+function mayUseInstalled(forwarded) {
+  return !REPAIR_VERBS.includes(forwarded[0]);
+}
+
+/**
+ * Extra `uv tool run` flags for a call. A repair runs `--isolated`: without
+ * it uv reuses the INSTALLED tool environment whenever it satisfies the
+ * requirement -- the corrupted one the repair is for (reproduced with uv
+ * 0.12.5).
+ */
+function uvRunFlags(forwarded) {
+  return mayUseInstalled(forwarded) ? [] : ["--isolated"];
+}
+
+/** What a repair says when the newest release cannot be read. */
+const REPAIR_NEEDS_NETWORK = "probe repair needs the network to fetch a working CLI";
+
 async function main() {
   const args = process.argv.slice(2);
   // `npx probe-research` with no arguments runs the wizard — that is the entire
@@ -250,7 +276,15 @@ async function main() {
   // serving whatever it resolved on day one -- in the other branch. It was
   // fixed there and left standing here.
   let latest = null;
-  if (has("probe")) {
+  if (!mayUseInstalled(forwarded)) {
+    // A repair runs the NEWEST release, never the floor: the floor predates
+    // `probe repair`, and would hand the job to a CLI that cannot do it.
+    latest = await latestVersion();
+    if (!latest) {
+      console.error(`probe-research: ${REPAIR_NEEDS_NETWORK}`);
+      process.exit(1);
+    }
+  } else if (has("probe")) {
     const found = installedVersion();
     if (found && atLeast(found, wanted)) {
       latest = await latestVersion();
@@ -289,8 +323,9 @@ async function main() {
   // kept returning 0.10.0 after 0.10.1 was published). The full refresh costs
   // ~100ms, which is nothing for a command that only runs when there is no
   // usable local install.
+  const isolated = uvRunFlags(forwarded);
   if (has("uv")) {
-    return run("uv", ["tool", "run", "--refresh", "--from", spec, "probe", ...forwarded]);
+    return run("uv", ["tool", "run", ...isolated, "--refresh", "--from", spec, "probe", ...forwarded]);
   }
   if (has("pipx")) {
     return run("pipx", ["run", "--no-cache", "--spec", spec, "probe", ...forwarded]);
@@ -316,7 +351,7 @@ async function main() {
   // because it was resolved before the install ran.
   const uv = `${os.homedir()}/.local/bin/uv`;
   return run(uv, [
-    "tool", "run", "--refresh", "--from", spec, "probe", ...forwarded,
+    "tool", "run", ...isolated, "--refresh", "--from", spec, "probe", ...forwarded,
   ]);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "probe-research",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Setup wizard for Probe Research in your coding agents. Runs from zero with npx.",
   "bin": {
     "probe-research": "bin/probe-research.js"