context-carwash 0.1.2 → 0.1.3

package/README.md

@@ -18,7 +18,7 @@ npx context-carwash preview     # sample meters in your terminal, nothing instal
 npx context-carwash install     # lists what it will change, then asks
 ```
 
-To update later, run `npx context-carwash@latest install` again. Waiting briefs are kept. The `@latest` matters: without it npx may rerun the copy it downloaded last time. If it does, the installer says a newer version is out before asking to go ahead.
+To update later, run `npx context-carwash install` again. Waiting briefs are kept. If npx reruns an older copy it downloaded before, the installer notices that npm has a newer version and installs that one instead.
 
 The installer copies itself to `~/.carwash/app` and makes three changes to Claude Code, all listed before you confirm:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-carwash",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A quiet context meter and deliberate fresh-session handoff for Claude Code.",
   "license": "MIT",
   "repository": {

package/src/cli.mjs

@@ -2,7 +2,7 @@ import { appendFileSync, existsSync, statSync, writeFileSync } from 'node:fs';
 import { createInterface } from 'node:readline';
 import { applyInstall, applyUninstall, describeInstall, describeUninstall, packageVersion, planInstall, planUninstall } from './install/install.mjs';
 import { UserError } from './install/settings.mjs';
-import { latestVersion, updateNotice } from './install/update.mjs';
+import { isNewer, latestVersion, runRelease } from './install/update.mjs';
 import { errorLogPath, welcomedPath } from './paths.mjs';
 import { render } from './statusline/render.mjs';
 import { statusline } from './statusline/run.mjs';
@@ -88,7 +88,7 @@ function logError(env, error) {
   }
 }
 
-export async function main(argv, { env = process.env, stdin = process.stdin, stdout = process.stdout, stderr = process.stderr, latest = latestVersion } = {}) {
+export async function main(argv, { env = process.env, stdin = process.stdin, stdout = process.stdout, stderr = process.stderr, latest = latestVersion, handOff = runRelease } = {}) {
   const [command, ...rest] = argv;
   const yes = rest.includes('--yes') || rest.includes('-y');
   try {
@@ -107,11 +107,21 @@ export async function main(argv, { env = process.env, stdin = process.stdin, std
         return 0;
       }
       case 'install': {
+        // npx may be rerunning an old download. If npm has something newer,
+        // that release does the install. Once only: the newer copy is not
+        // asked to check again.
+        if (!env.CARWASH_HANDED_OFF) {
+          const current = packageVersion();
+          const newest = await latest({ env });
+          if (isNewer(newest, current)) {
+            stdout.write(`This is Context Carwash ${current}, and ${newest} is out. Installing ${newest} instead.\n\n`);
+            const status = handOff(newest, argv, { env });
+            if (status !== null) return status;
+            stdout.write(`Could not start ${newest}, so continuing with ${current}. For the newer one: npx context-carwash@latest install\n\n`);
+          }
+        }
         const plan = planInstall({ env });
         stdout.write(describeInstall(plan) + '\n\n');
-        // Last, so it sits right above the question it changes the answer to.
-        const notice = updateNotice(packageVersion(), await latest({ env }));
-        if (notice) stdout.write(notice + '\n\n');
         if (!(await confirm('Proceed?', { yes, stdin, stdout }))) {
           stdout.write('Nothing was changed.\n');
           return 1;

package/src/install/update.mjs

@@ -1,5 +1,8 @@
-// Whether a newer Context Carwash is on npm. Only the installer asks, since
-// npx can quietly rerun a copy it downloaded earlier. The meter and /wash never
+import { spawnSync } from 'node:child_process';
+
+// Whether a newer Context Carwash is on npm, and handing over to it. Only the
+// installer asks, since npx can quietly rerun a copy it downloaded earlier, and
+// people should not have to know to type @latest. The meter and /wash never
 // use the network.
 
 const LATEST_URL = 'https://registry.npmjs.org/context-carwash/latest';
@@ -34,11 +37,17 @@ export async function latestVersion({ env = process.env, timeoutMs = TIMEOUT_MS
   }
 }
 
-// What the installer says before asking, or null when this is the latest.
-export function updateNotice(current, latest) {
-  if (!isNewer(latest, current)) return null;
-  return [
-    `A newer Context Carwash is out: ${latest}. This installer is ${current}.`,
-    'To install the newer one, answer no and run:  npx context-carwash@latest install',
-  ].join('\n');
+// Run `carwash <args>` from the given release instead of this one, in this
+// terminal, so its questions reach the person. Pinned to the exact version, so
+// the newer copy finds itself up to date and does not hand off again. Resolves
+// to its exit code, or null if npx could not be started.
+export function runRelease(version, args, { env = process.env, platform = process.platform } = {}) {
+  const npx = platform === 'win32' ? 'npx.cmd' : 'npx';
+  // npx.cmd is a batch file, which Windows only runs through a shell.
+  const result = spawnSync(npx, ['--yes', `context-carwash@${version}`, ...args], {
+    stdio: 'inherit',
+    env: { ...env, CARWASH_HANDED_OFF: version },
+    shell: platform === 'win32',
+  });
+  return result.error || result.status === null ? null : result.status;
 }