probe-research 0.11.0 → 0.12.0

package/README.md

@@ -6,14 +6,33 @@ The Probe Research setup wizard.
 npx probe-research
 ```
 
-Installs and configures [Probe Research](https://research.prbe.ai) for Claude Code.
-It asks which capabilities you want, installs only those plugins, and finishes
-with a single browser approval.
+Signs in to [Probe Research](https://research.prbe.ai) through your browser and
+opens the main wizard menu. If you create an account, finish onboarding on the
+website first. Its final step gives you a command like:
+
+```bash
+npx probe-research install ABCD234567
+```
+
+The 10-character code signs you in once without another browser approval, and
+`install` opens the guided tooling setup for Claude Code, Codex, or pi. Choose
+your agents and confirm the capabilities before anything is installed. Each
+selected agent receives its own capture credential when capture is enabled.
+
+`npx probe-research ABCD234567` also signs in, then opens the main menu.
+`npx probe-research install` runs guided setup with browser sign-in. Expired or
+already-used codes need to be replaced on the website.
 
 This package is a thin launcher. Probe Research is a Python CLI; this exists so
 the entry point matches the `npx <tool>` shape people already expect. It resolves
 a real `probe` (via an existing install, `uv`, or `pipx`) and hands over — there
 is no reimplementation here that could drift from the CLI.
 
-Re-run it any time to change what's enabled, diagnose a problem, update, print
-the manual steps, or remove Probe from the device.
+The main menu requires a signed-in account. Choose **Sign out** to clear this
+device's credentials, stop capture, and exit the wizard. Run the command again
+to sign in to another account. You can also change what's enabled, diagnose a
+problem, update, print the manual steps, or remove Probe from the device.
+
+Publishing this launcher requires `probe-research>=0.147.0` to be available on
+PyPI first. That CLI version introduces website sign-in codes; older installed
+CLIs are upgraded before the launcher forwards the new commands.

package/bin/probe-research.js

@@ -63,14 +63,37 @@ const MANIFEST_TIMEOUT_MS = 1500;
  * to repair the thing it installed. A healthy 0.26.x install pays one refetch,
  * which is the right trade against a broken one staying broken forever.
  *
- * (1) is why it is now 0.36.0. The dashboard's last onboarding step hands out
+ * (1) was why it was 0.36.0. The dashboard's last onboarding step hands out
  * `npx probe-research backfill`, and `probe backfill` does not exist before
  * 0.36.0. Arguments are forwarded to whatever `probe` this launcher resolves,
  * so under the old floor a user with 0.35.0 on PATH gets `No such command
  * 'backfill'` from a command the product just told them to run. A floor is the
  * only thing that can catch it: the copied command is identical either way.
+ *
+ * (1) also raised the floor to 0.56.0, and the failure is quieter. 0.56.0 adds the
+ * BULK verbs an automated caller reaches for rather than a human:
+ *
+ *   probe artifact add --from-manifest FILE   import many files in one process
+ *   probe artifact move ID --to LEVEL         promote/demote/lateral
+ *   probe metrics backfill RUN --key K        a whole derived curve, one request
+ *
+ * The first of those is the one that makes a floor load-bearing. It exists
+ * because per-file `artifact add` costs a process start and a slug resolution
+ * each, so 200k files is tens of CPU-hours -- which means whatever issues it is
+ * importing at that scale, unattended. Against a pre-0.56.0 `probe` on PATH,
+ * `--from-manifest` is an unknown OPTION: the CLI exits 2 having queued
+ * nothing, and there is no operator watching to read it. The old floor is
+ * satisfied by every one of those installs.
+ *
+ * PUBLISHING ORDER MATTERS. `${DIST}>=${target}` must resolve, so this package
+ * may only be `npm publish`ed once a CLI at or above the floor is live on PyPI.
+ * That ordering is not enforced anywhere: the PyPI release is automated and
+ * `npm publish` is manual, so it is a human who has to get it right. Raising
+ * the floor ahead of the release strands the from-zero entry point.
  */
-const MIN_CLI = "0.36.0";
+// 0.147.0 adds positional website sign-in codes to wizard/install. Publish this
+// launcher only after that CLI release is available on PyPI.
+const MIN_CLI = "0.147.0";
 const UV_INSTALL = "curl -LsSf https://astral.sh/uv/install.sh | sh";
 
 /** Compare dotted numeric versions. Returns true when `a` >= `b`. */
@@ -151,11 +174,22 @@ function run(cmd, args) {
   process.exit(r.status === null ? 1 : r.status);
 }
 
+/** The optional one-time sign-in code is independent of the install action. */
+function cliArgs(args) {
+  if (!args.length) return ["wizard"];
+  if (/^[A-Z0-9]{10}$/.test(args[0])) {
+    // `code install` and `install code` both retain the same two arguments.
+    if (args[1] === "install") return ["install", args[0], ...args.slice(2)];
+    return ["wizard", ...args];
+  }
+  return args;
+}
+
 async function main() {
   const args = process.argv.slice(2);
   // `npx probe-research` with no arguments runs the wizard — that is the entire
   // reason this package exists, so it should not require remembering a verb.
-  const forwarded = args.length ? args : ["wizard"];
+  const forwarded = cliArgs(args);
   const wanted = MIN_CLI;
 
   // Hand off to an existing install only when it is BOTH above the floor and

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "probe-research",
-  "version": "0.11.0",
-  "description": "Setup wizard for Probe Research in Claude Code. Runs from zero with npx.",
+  "version": "0.12.0",
+  "description": "Setup wizard for Probe Research in Claude Code and Codex. Runs from zero with npx.",
   "bin": {
     "probe-research": "bin/probe-research.js"
   },
@@ -19,6 +19,7 @@
   "homepage": "https://research.prbe.ai/connect",
   "keywords": [
     "claude-code",
+    "codex",
     "mlops",
     "experiment-tracking",
     "probe-research"