The design language that makes your AI harness better at design.
JavaScript
CLI: --version reports the npm package version (#731)
Paul Bakaus641ff955020e
diff --git a/cli/bin/cli.js b/cli/bin/cli.jsindex f63e677f9..6164db271 100755--- a/cli/bin/cli.js+++ b/cli/bin/cli.js@@ -68,6 +68,14 @@ async function locate() {return download().catch((err) => { process.stderr.write(`impeccable: ${err.message}\n`); return null; });}+// `--version` / `-v` is answered by the shim itself: the number users mean+// is this npm package's version, not the engine's (docs/CLI-CONTRACT.md).+const argv = process.argv.slice(2);+if (argv[0] === '--version' || argv[0] === '-v') {+ process.stdout.write(`${pkg.version}\n`);+ process.exit(0);+}+const bin = await locate();if (!bin) {process.stderr.write(@@ -76,7 +84,7 @@ if (!bin) {);process.exit(127);}-const result = spawnSync(bin, process.argv.slice(2), {+const result = spawnSync(bin, argv, {stdio: 'inherit',env: { IMPECCABLE_SELF: 'npx impeccable', ...process.env },});diff --git a/crates/cli/src/main.rs b/crates/cli/src/main.rsindex 99aa0a5cc..e38c6a5d8 100644--- a/crates/cli/src/main.rs+++ b/crates/cli/src/main.rs@@ -108,7 +108,7 @@ fn run(args: &[String], io: &mut Io) -> i32 {/// The npm `impeccable` package version `cli.js --version` prints (its/// `package.json`), tracked separately from the crate version.-pub const CLI_VERSION: &str = "3.6.0";+pub const CLI_VERSION: &str = "4.0.0";/// The engines wired into `impeccable detect`: the static HTML engine/// (crates/html). The browser engine (crates/browser) plugs in here once itdiff --git a/tests/cli-shim.test.mjs b/tests/cli-shim.test.mjsindex 777e60103..2ef5e4616 100644--- a/tests/cli-shim.test.mjs+++ b/tests/cli-shim.test.mjs@@ -174,6 +174,17 @@ describe('npm shim download verification', { skip: process.platform === 'win32'assert.deepEqual(cacheEntries(res.home), []);});+ it('answers --version and -v from its own package.json without touching a binary', async () => {+ const expected = JSON.parse(fs.readFileSync(PKG_PATH, 'utf-8')).version;+ for (const args of [['--version'], ['-v'], ['--version', 'extra']]) {+ const flag = args.join(' ');+ const res = await runShim(args);+ assert.equal(res.status, 0, `${flag} exits 0`);+ assert.equal(res.stdout, `${expected}\n`);+ assert.deepEqual(requests, [], 'no download was attempted');+ }+ });+it('prefers IMPECCABLE_BIN and never downloads', async () => {sidecar = { status: 404, body: '' };const { dir, shim } = stageShim();diff --git a/tests/oracle/DELTAS.md b/tests/oracle/DELTAS.mdindex d77b4e3ec..d0b74dc01 100644--- a/tests/oracle/DELTAS.md+++ b/tests/oracle/DELTAS.md@@ -155,3 +155,12 @@ file, the file set, or the printed lines differs from the JS.- `pin-opencode-project`, `pin-opencode-user-scope`, `pin-opencode-skips-foreign-command`, `pin-opencode-then-unpin`, `pin-opencode-unpin-skips-foreign`.++## Recorded 2026-09-04: `--version` follows the npm package to 4.0.0++The npm shim answers `--version` / `-v` itself from its own `package.json`+(docs/CLI-CONTRACT.md), so the number users see tracks the package they+installed. The binary's `CLI_VERSION` moves from `3.6.0` to `4.0.0` with the+CLI 4.0.0 release; it is what the binary prints when run directly.++- `cli-version`.diff --git a/tests/oracle/golden/cli-version.json b/tests/oracle/golden/cli-version.jsonindex 6080c9090..7c958a359 100644--- a/tests/oracle/golden/cli-version.json+++ b/tests/oracle/golden/cli-version.json@@ -1,5 +1,5 @@{- "stdout": "3.6.0\n",+ "stdout": "4.0.0\n","stderr": "","exit": 0,"signal": null,