context-carwash 0.1.1 → 0.1.3

package/README.md

@@ -5,7 +5,7 @@ A small, local-first utility for Claude Code.
 - **Meter:** a quiet estimate of the active context window in the status line.
 - **Wash:** when you ask, Claude writes a short handoff brief, and your next `/clear` starts a fresh session that begins with it.
 
-Nothing happens automatically, and nothing leaves your machine.
+Nothing happens automatically, and nothing leaves your machine. The one exception: the installer asks npm whether a newer version is out.
 
 **Status:** pre-release. The meter and the typed `/wash` command work today. Clickable links in the status line and the one-step restart are not built yet. See [plan-3.md](plan-3.md) for the design.
 
@@ -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.
+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:
 
@@ -76,7 +76,7 @@ Things worth knowing:
 
 ## Where things are kept
 
-Briefs are stored in `~/.carwash`, readable only by you, and never inside your project. Nothing is uploaded, and there is no telemetry.
+Briefs are stored in `~/.carwash`, readable only by you, and never inside your project. Nothing is uploaded, and there is no telemetry. The installer reads the newest version number from npm, and nothing else goes online; set `CARWASH_NO_UPDATE_CHECK=1` to skip even that.
 
 If a hook fails it stays silent and writes the error to `~/.carwash/errors.log`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-carwash",
-  "version": "0.1.1",
+  "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,6 +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 { 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';
@@ -24,7 +25,7 @@ Inside Claude Code, once installed:
   /wash load [id]                  Make a waiting brief the one /clear will use
   /wash help                       Explain the meter and the options
 
-Nothing happens automatically, and nothing leaves this machine.`;
+Nothing happens automatically. Only install goes online, to ask npm for the newest version.`;
 
 async function readAll(stream) {
   if (stream.isTTY) return '';
@@ -87,7 +88,7 @@ function logError(env, error) {
   }
 }
 
-export async function main(argv, { env = process.env, stdin = process.stdin, stdout = process.stdout, stderr = process.stderr } = {}) {
+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 {
@@ -106,6 +107,19 @@ 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');
         if (!(await confirm('Proceed?', { yes, stdin, stdout }))) {

package/src/install/update.mjs

@@ -0,0 +1,53 @@
+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';
+const TIMEOUT_MS = 3000;
+
+const parse = (version) => {
+  const found = /^(\d+)\.(\d+)\.(\d+)$/.exec(String(version ?? '').trim());
+  return found ? found.slice(1).map(Number) : null;
+};
+
+// True when `latest` is a later release than `current`. Anything unreadable is
+// not newer.
+export function isNewer(latest, current) {
+  const a = parse(latest);
+  const b = parse(current);
+  if (!a || !b) return false;
+  for (let i = 0; i < 3; i++) if (a[i] !== b[i]) return a[i] > b[i];
+  return false;
+}
+
+// The version npm calls latest, or null when it cannot say in time. Offline,
+// slow or opted out (CARWASH_NO_UPDATE_CHECK) all mean no answer, never an error.
+export async function latestVersion({ env = process.env, timeoutMs = TIMEOUT_MS } = {}) {
+  if (env.CARWASH_NO_UPDATE_CHECK) return null;
+  try {
+    const response = await fetch(LATEST_URL, { signal: AbortSignal.timeout(timeoutMs), headers: { accept: 'application/json' } });
+    if (!response.ok) return null;
+    const { version } = await response.json();
+    return parse(version) ? version : null;
+  } catch {
+    return null;
+  }
+}
+
+// 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;
+}