Skip to content

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.js
index 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.rs
index 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 it
diff --git a/tests/cli-shim.test.mjs b/tests/cli-shim.test.mjs
index 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.md
index 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.json
index 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,