probe-research 0.12.0 → 0.13.0

package/README.md

@@ -16,7 +16,10 @@ 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
+your agents, select past coding sessions and/or a folder to backfill, then
+confirm the capabilities before anything is installed. Imports run after setup
+and show what they found for review before uploading. Both imports are optional;
+choosing only a folder leaves session history out. Each
 selected agent receives its own capture credential when capture is enabled.
 
 `npx probe-research ABCD234567` also signs in, then opens the main menu.

package/bin/probe-research.js

@@ -174,13 +174,61 @@ 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. */
+/**
+ * The words the launcher itself interprets. Everything else is a CLI command of
+ * its own and is forwarded untouched.
+ *
+ * Every device setup goes through the wizard (Richard, 2026-09-29), so every
+ * setup spelling this package has ever advertised lands on `probe wizard`, and
+ * the launcher never forwards a retired setup command such as `probe install`:
+ * a later CLI deletes those, and a copied `npx probe-research install CODE` has
+ * to keep working across that release.
+ */
+const LauncherVerb = Object.freeze({
+  WIZARD: "wizard",
+  /** Launcher-only: "straight into the guided install", skipping the menu. */
+  INSTALL: "install",
+});
+/** What `install` means -- exactly what `probe install` always ran (`main.py`). */
+const INSTALL_ACTION = Object.freeze(["--action", "configure"]);
+/** The website's one-time sign-in code; the CLI enforces the same shape. */
+const SIGN_IN_CODE = /^[A-Z0-9]{10}$/;
+/** The CLI root's own options: a call that starts with one names its own
+ *  command (`--base-url X doctor`, `--base-url=X doctor`) and reaches `probe`
+ *  untouched. */
+const ROOT_ONLY_FLAGS = Object.freeze(["--version", "--help", "--base-url", "--spool-dir", "--async", "--sync"]);
+
+/**
+ * `probe` arguments for what was typed after `npx probe-research`.
+ *
+ *   (nothing)                  -> wizard
+ *   CODE [flags]               -> wizard CODE [flags]
+ *   install [CODE] [flags]     -> wizard [CODE] --action configure [flags]
+ *   CODE install [flags]       -> wizard CODE --action configure [flags]
+ *   --flag ...                 -> wizard --flag ...   (the CLI root's own excepted)
+ *   anything else              -> unchanged (`doctor`, `backfill`, `wizard ...`)
+ *
+ * A sign-in code keeps its meaning either way: bare, it signs in and opens the
+ * menu; with `install`, the one-time exchange waits for the agent selection so
+ * it grants exactly what the user chose.
+ */
 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];
+  const [first, ...rest] = args;
+  if (first === undefined) return [LauncherVerb.WIZARD];
+  if (SIGN_IN_CODE.test(first)) {
+    if (rest[0] === LauncherVerb.INSTALL) {
+      return [LauncherVerb.WIZARD, first, ...INSTALL_ACTION, ...rest.slice(1)];
+    }
+    return [LauncherVerb.WIZARD, first, ...rest];
+  }
+  if (first === LauncherVerb.INSTALL) {
+    const code = rest.length && SIGN_IN_CODE.test(rest[0]) ? rest.slice(0, 1) : [];
+    return [LauncherVerb.WIZARD, ...code, ...INSTALL_ACTION, ...rest.slice(code.length)];
+  }
+  // Flags alone (`npx probe-research --agent codex`) used to reach the CLI's
+  // root as `probe --agent codex`, which is not a command at all.
+  if (first.startsWith("-") && !ROOT_ONLY_FLAGS.includes(first.split("=")[0])) {
+    return [LauncherVerb.WIZARD, ...args];
   }
   return args;
 }
@@ -228,7 +276,9 @@ async function main() {
   // "fetching the latest" and then change nothing. Measured exactly that before
   // this line existed.
   const target = latest && atLeast(latest, wanted) ? latest : wanted;
-  const spec = `${DIST}>=${target}`;
+  // `[all]`: the CLI's dependencies are an extra from the release after
+  // 0.188 (plan 2.11); asking for it is harmless while core still has them.
+  const spec = `${DIST}[all]>=${target}`;
   // REFRESH. uv caches the ENVIRONMENT it built for a requirement, so a range
   // like `>=0.10.0` keeps serving whatever it resolved the FIRST time — every
   // user frozen on the version they happened to run on day one, with the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "probe-research",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Setup wizard for Probe Research in Claude Code and Codex. Runs from zero with npx.",
   "bin": {
     "probe-research": "bin/probe-research.js"