From 41b423cc14cd8493347581a55c7efdc19d527b2f Mon Sep 17 00:00:00 2001
From: Christopher Hiller <boneskull@boneskull.com>
Date: Mon, 31 Jul 2023 20:57:02 -0700
Subject: [PATCH] feat: new --add flag

This flag allows extra dependencies to be installed to help run smoke tests.  It's recommended not to be used, but it will certainly make things easier for some use cases.

Further info is in `README.md`
---
 README.md                                     |  24 +-
 __snapshots__/cli.spec.ts.js                  |  95 +++-
 package-lock.json                             | 492 ++++--------------
 package.json                                  |  15 +-
 src/cli.ts                                    | 481 ++++++++---------
 src/pm/npm.ts                                 |  57 +-
 src/pm/pm.ts                                  |  17 +-
 src/smoker.ts                                 |  52 +-
 src/stubs.d.ts                                |   0
 src/types.ts                                  |  15 +-
 src/util.ts                                   | 166 ++++++
 test/assertions.ts                            |  51 ++
 test/e2e/cli.spec.ts                          | 203 +++++---
 test/e2e/fixture/add/package.json             |  10 +
 test/e2e/fixture/add/smoke.js                 |   3 +
 test/e2e/fixture/failure/package.json         |   7 +
 .../dev-peer/package.json                     |   8 +
 .../optional-peer/package.json                |   8 +
 .../pick-package-version/peer/package.json    |   5 +
 .../prod-peer/package.json                    |   8 +
 test/e2e/helpers.ts                           |  35 ++
 test/e2e/util.spec.ts                         |  87 ++++
 test/unit/mocks.ts                            |   1 +
 test/unit/pm/npm.spec.ts                      |  77 ++-
 test/unit/smoker.spec.ts                      |  49 +-
 test/unit/util.spec.ts                        | 144 +++++
 26 files changed, 1262 insertions(+), 848 deletions(-)
 create mode 100644 src/stubs.d.ts
 create mode 100644 src/util.ts
 create mode 100644 test/assertions.ts
 create mode 100644 test/e2e/fixture/add/package.json
 create mode 100644 test/e2e/fixture/add/smoke.js
 create mode 100644 test/e2e/fixture/failure/package.json
 create mode 100644 test/e2e/fixture/pick-package-version/dev-peer/package.json
 create mode 100644 test/e2e/fixture/pick-package-version/optional-peer/package.json
 create mode 100644 test/e2e/fixture/pick-package-version/peer/package.json
 create mode 100644 test/e2e/fixture/pick-package-version/prod-peer/package.json
 create mode 100644 test/e2e/helpers.ts
 create mode 100644 test/e2e/util.spec.ts
 create mode 100644 test/unit/util.spec.ts

diff --git a/README.md b/README.md
index f3387cac2..f3c07f653 100644
--- a/README.md
+++ b/README.md
@@ -92,7 +92,7 @@ Feeling lucky? Run `npm run test:smoke`.
 
 ### Wait—What Should My Script Do?
 
-In many cases, executing the package's entry point is sufficient:
+In many cases, executing the package's entry point might be enough:
 
 ```json
 {
@@ -109,9 +109,27 @@ Otherwise:
 - If your package distributes an executable, you might want to run that instead, and give it some common arguments (assuming it depends on your entry point). _Or_ you could go BUCK WILD and run it a bunch of different ways.
 - If your package is lazy-loading its dependencies--like if you have a `require()` or `await import()` within some function that isn't called at startup--you may need to do more work than this.
 
-**If you find yourself needing a dev tool to run your script, you are missing the point.** Again: you want to load/run your package as a consumer would--that means _running your distfiles_ **without** dev deps.
+### But I Need a Dev Tool To Run My Script
 
-That's it. That's the project.
+OK--_fine_--but this is not necessarily recommended, because the result is not what a consumer would get. How much does that matter? You decide.
+
+Provide the `--add <thing>` option to `midnight-smoker`, where `thing` is anything `npm install <thing>` could install:
+
+```json
+{
+  "scripts": {
+    "test:smoke": "smoker --add ts-node smoke",
+    "smoke": "ts-node ./some-script.ts"
+  },
+  "devDependencies": {
+    "ts-node": "10.9.1"
+  }
+}
+```
+
+If unspecified in `--add`, `midnight-smoker` will use the version of the dependency in the package's `devDependencies`/`dependencies`/`optionalDependencies`/`peerDepedenencies` (in that order). If it does not appear in any of these fields, it will just pull down the `latest` tag of the dependency.
+
+`--add` can be provided multiple times.
 
 ## Installation
 
diff --git a/__snapshots__/cli.spec.ts.js b/__snapshots__/cli.spec.ts.js
index ec22b38a7..f6b5a5b47 100644
--- a/__snapshots__/cli.spec.ts.js
+++ b/__snapshots__/cli.spec.ts.js
@@ -1,11 +1,94 @@
-exports['midnight-smoker CLI should show help text 1'] = {
-  "stdout": "smoker <script> [scripts..]\n\nRun tests against a package as it would be published\n\nPositionals:\n  script                                                                [string]\n  scripts                                                               [string]\n\nBehavior:\n  -r, --require       Package identifier for extra dependency needed by smoke\n                      tests                                              [array]\n      --workspace     One or more npm workspaces to test                 [array]\n      --all           Test all workspaces                              [boolean]\n      --include-root  Include the workspace root; must provide '--all' [boolean]\n      --install-args  Extra arguments to pass to `npm install`           [array]\n      --dir           Working directory to use  [string] [default: new temp dir]\n      --force         Overwrite working directory if it exists         [boolean]\n      --clean         Truncate working directory; must provide '--force'\n                                                                       [boolean]\n      --npm           Path to `npm` executable [string] [default: `npm` in PATH]\n      --verbose       Print output from npm                            [boolean]\n      --bail          When running scripts, halt on first error        [boolean]\n      --json          Output JSON only                                 [boolean]\n\nOptions:\n      --version  Show version number                                   [boolean]\n      --help     Show help                                             [boolean]",
+exports['midnight-smoker CLI flag --help should show help text 1'] = {
+  "stdout": "smoker <script> [scripts..]\n\nRun tests against a package as it would be published\n\nPositionals:\n  script                                                                [string]\n  scripts                                                               [string]\n\nBehavior:\n  --add           Additional dependency to provide to smoke tests        [array]\n  --workspace     One or more npm workspaces to test                     [array]\n  --all           Test all workspaces                                  [boolean]\n  --include-root  Include the workspace root; must provide '--all'     [boolean]\n  --install-args  Extra arguments to pass to `npm install`               [array]\n  --dir           Working directory to use      [string] [default: new temp dir]\n  --force         Overwrite working directory if it exists             [boolean]\n  --clean         Truncate working directory; must provide '--force'   [boolean]\n  --npm           Path to `npm` executable     [string] [default: `npm` in PATH]\n  --verbose       Print output from npm                                [boolean]\n  --bail          When running scripts, halt on first error            [boolean]\n  --json          Output JSON only                                     [boolean]\n\nOptions:\n  --version  Show version number                                       [boolean]\n  --help     Show help                                                 [boolean]\n\nFor more info, see https://github.com/boneskull/midnight-smoker",
   "stderr": "",
   "exitCode": 0
 }
 
-exports['midnight-smoker CLI should smoke test this and produce JSON output 1'] = {
-  "stdout": "{\n  \"results\": [\n    {\n      \"pkgName\": \"midnight-smoker\",\n      \"script\": \"smoke\",\n      \"rawResult\": {\n        \"command\": \"<path/to>/bin/npm run-script smoke\",\n        \"escapedCommand\": \"<path/to>/bin/npm\\\" run-script smoke\",\n        \"exitCode\": 0,\n        \"stdout\": \"\\n> midnight-smoker@<version> smoke\\n> <path/to/>smoker.js --version\\n\\n<version>\",\n        \"stderr\": \"\",\n        \"failed\": false,\n        \"timedOut\": false,\n        \"isCanceled\": false,\n        \"killed\": false\n      }\n    }\n  ],\n  \"total\": 1,\n  \"executed\": 1,\n  \"scripts\": [\n    \"smoke\"\n  ]\n}",
-  "stderr": "",
-  "exitCode": 0
+exports['midnight-smoker CLI flag --json when the test fails should provide helpful result 1'] = `
+{
+  "results": [
+    {
+      "pkgName": "fail",
+      "script": "smoke",
+      "error": {},
+      "rawResult": {
+        "shortMessage": "Command failed with exit code 1: <path/to/>/bin/node <path/to/>/bin/npm run-script smoke",
+        "command": <path/to/>/bin/node <path/to/>/bin/npm run-script smoke",
+        "escapedCommand": <path/to/>/bin/node\\" <path/to/>/bin/npm\\" run-script smoke",
+        "exitCode": 1,
+        "stdout": "\\n> fail@1.0.0 smoke\\n> exit 1\\n",
+        "stderr": "",
+        "failed": true,
+        "timedOut": false,
+        "isCanceled": false,
+        "killed": false
+      },
+      "cwd": "<cwd>"
+    }
+  ],
+  "scripts": [
+    "smoke"
+  ],
+  "total": 1,
+  "failures": 1,
+  "executed": 1
+}
+`
+
+exports['midnight-smoker CLI flag when the test passes should produce expected output 1'] = `
+💨 midnight-smoker v3.0.4
+- Packing current project...
+✔ Packed 1 package
+- Installing from 1 tarball...
+✔ Installed 1 package from tarball
+- Running script 0/1...
+✔ Successfully ran 1 script
+✔ Lovey-dovey! 💖
+`
+
+exports['midnight-smoker CLI flag when the test fails should produce expected output 1'] = `
+💨 midnight-smoker v3.0.4
+- Packing current project...
+✔ Packed 1 package
+- Installing from 1 tarball...
+✔ Installed 1 package from tarball
+- Running script 0/1...
+✖ 1 of 1 script failed
+
+Error details for failed package fail:
+
+(runScript) Script "smoke" in package "fail" failed: Command failed with exit code 1: /home/boneskull/.nvm/versions/node/v20.5.0/bin/node /home/boneskull/.nvm/versions/node/v20.5.0/bin/npm run-script smoke
+
+> fail@1.0.0 smoke
+> exit 1
+
+✖ 🤮 Maurice!
+`
+
+exports['midnight-smoker CLI flag --json when the test passes should produce expected output 1'] = `
+{
+  "results": [
+    {
+      "pkgName": "midnight-smoker",
+      "script": "smoke:js",
+      "rawResult": {
+        "command": <path/to/>/bin/node <path/to/>/bin/npm run-script smoke:js",
+        "escapedCommand": <path/to/>/bin/node\\" <path/to/>/bin/npm\\" run-script \\"smoke:js\\"",
+        "exitCode": 0,
+        "stdout": "\\n> midnight-smoker@<version> smoke:js\\n> <path/to/>smoker.js --version\\n\\n<version>",
+        "stderr": "",
+        "failed": false,
+        "timedOut": false,
+        "isCanceled": false,
+        "killed": false
+      },
+      "cwd": "<cwd>"
+    }
+  ],
+  "total": 1,
+  "executed": 1,
+  "scripts": [
+    "smoke:js"
+  ]
 }
+`
diff --git a/package-lock.json b/package-lock.json
index 686edf63f..0df9cada7 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -14,6 +14,7 @@
         "execa": "5.1.1",
         "ora": "5.4.1",
         "pluralize": "8.0.0",
+        "read-pkg-up": "7.0.1",
         "source-map-support": "0.5.21",
         "strict-event-emitter-types": "2.0.0",
         "which": "3.0.1",
@@ -57,8 +58,7 @@
         "typescript": "5.1.6",
         "unexpected": "13.2.1",
         "unexpected-eventemitter": "2.4.0",
-        "unexpected-sinon": "11.1.0",
-        "unexpected-snapshot": "2.1.0"
+        "unexpected-sinon": "11.1.0"
       },
       "engines": {
         "node": "^16.13.0 || ^18.0.0 || ^20.0.0",
@@ -74,30 +74,30 @@
       }
     },
     "node_modules/@babel/code-frame": {
-      "version": "7.18.6",
-      "dev": true,
-      "license": "MIT",
+      "version": "7.22.5",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.22.5.tgz",
+      "integrity": "sha512-Xmwn266vad+6DAqEB2A6V/CcZVp62BbwVmcOJc2RPuwih1kw02TjQvWVWlcKGbBPd+8/0V5DEkOcizRGYsspYQ==",
       "dependencies": {
-        "@babel/highlight": "^7.18.6"
+        "@babel/highlight": "^7.22.5"
       },
       "engines": {
         "node": ">=6.9.0"
       }
     },
     "node_modules/@babel/helper-validator-identifier": {
-      "version": "7.19.1",
-      "dev": true,
-      "license": "MIT",
+      "version": "7.22.5",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.22.5.tgz",
+      "integrity": "sha512-aJXu+6lErq8ltp+JhkJUfk1MTGyuA4v7f3pA+BJ5HLfNC6nAQ0Cpi9uOquUj8Hehg0aUiHzWQbOVJGao6ztBAQ==",
       "engines": {
         "node": ">=6.9.0"
       }
     },
     "node_modules/@babel/highlight": {
-      "version": "7.18.6",
-      "dev": true,
-      "license": "MIT",
+      "version": "7.22.5",
+      "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.22.5.tgz",
+      "integrity": "sha512-BSKlD1hgnedS5XRnGOljZawtag7H1yPfQp0tdNJCHoH6AZ+Pcm9VvkrK59/Yy593Ypg0zMxH2BxD1VPYUQ7UIw==",
       "dependencies": {
-        "@babel/helper-validator-identifier": "^7.18.6",
+        "@babel/helper-validator-identifier": "^7.22.5",
         "chalk": "^2.0.0",
         "js-tokens": "^4.0.0"
       },
@@ -107,8 +107,8 @@
     },
     "node_modules/@babel/highlight/node_modules/ansi-styles": {
       "version": "3.2.1",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
       "dependencies": {
         "color-convert": "^1.9.0"
       },
@@ -118,8 +118,8 @@
     },
     "node_modules/@babel/highlight/node_modules/chalk": {
       "version": "2.4.2",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
       "dependencies": {
         "ansi-styles": "^3.2.1",
         "escape-string-regexp": "^1.0.5",
@@ -131,37 +131,37 @@
     },
     "node_modules/@babel/highlight/node_modules/color-convert": {
       "version": "1.9.3",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
       "dependencies": {
         "color-name": "1.1.3"
       }
     },
     "node_modules/@babel/highlight/node_modules/color-name": {
       "version": "1.1.3",
-      "dev": true,
-      "license": "MIT"
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw=="
     },
     "node_modules/@babel/highlight/node_modules/escape-string-regexp": {
       "version": "1.0.5",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
       "engines": {
         "node": ">=0.8.0"
       }
     },
     "node_modules/@babel/highlight/node_modules/has-flag": {
       "version": "3.0.0",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
       "engines": {
         "node": ">=4"
       }
     },
     "node_modules/@babel/highlight/node_modules/supports-color": {
       "version": "5.5.0",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
       "dependencies": {
         "has-flag": "^3.0.0"
       },
@@ -525,28 +525,6 @@
         "node": "^12.0.0 || ^14.0.0 || >=16.0.0"
       }
     },
-    "node_modules/@eslint/eslintrc": {
-      "version": "1.4.1",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ajv": "^6.12.4",
-        "debug": "^4.3.2",
-        "espree": "^9.4.0",
-        "globals": "^13.19.0",
-        "ignore": "^5.2.0",
-        "import-fresh": "^3.2.1",
-        "js-yaml": "^4.1.0",
-        "minimatch": "^3.1.2",
-        "strip-json-comments": "^3.1.1"
-      },
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
     "node_modules/@eslint/js": {
       "version": "8.46.0",
       "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.46.0.tgz",
@@ -557,24 +535,6 @@
         "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
       }
     },
-    "node_modules/@gustavnikolaj/string-utils": {
-      "version": "2.0.0",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/@humanwhocodes/config-array": {
-      "version": "0.9.5",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@humanwhocodes/object-schema": "^1.2.1",
-        "debug": "^4.1.1",
-        "minimatch": "^3.0.4"
-      },
-      "engines": {
-        "node": ">=10.10.0"
-      }
-    },
     "node_modules/@humanwhocodes/module-importer": {
       "version": "1.0.1",
       "dev": true,
@@ -748,8 +708,8 @@
     },
     "node_modules/@types/normalize-package-data": {
       "version": "2.4.1",
-      "dev": true,
-      "license": "MIT"
+      "resolved": "https://registry.npmjs.org/@types/normalize-package-data/-/normalize-package-data-2.4.1.tgz",
+      "integrity": "sha512-Gj7cI7z+98M282Tqmp2K5EIsoouUEzbBJhQQzDE3jSIRk6r9gsz0oUokqIUR4u1R3dMHo0pDHM7sNOHyhulypw=="
     },
     "node_modules/@types/pluralize": {
       "version": "0.0.30",
@@ -1535,11 +1495,6 @@
         "node": ">= 6"
       }
     },
-    "node_modules/bluebird": {
-      "version": "3.7.2",
-      "dev": true,
-      "license": "MIT"
-    },
     "node_modules/bn.js": {
       "version": "5.2.1",
       "dev": true,
@@ -1712,14 +1667,6 @@
         "semver": "^7.0.0"
       }
     },
-    "node_modules/byline": {
-      "version": "5.0.0",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/call-bind": {
       "version": "1.0.2",
       "dev": true,
@@ -1965,9 +1912,10 @@
       "license": "MIT"
     },
     "node_modules/colorette": {
-      "version": "2.0.19",
-      "dev": true,
-      "license": "MIT"
+      "version": "2.0.20",
+      "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz",
+      "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==",
+      "dev": true
     },
     "node_modules/commander": {
       "version": "10.0.0",
@@ -2296,14 +2244,6 @@
         "minimalistic-assert": "^1.0.0"
       }
     },
-    "node_modules/detect-indent": {
-      "version": "6.1.0",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
     "node_modules/diff": {
       "version": "5.0.0",
       "dev": true,
@@ -2435,7 +2375,6 @@
     },
     "node_modules/error-ex": {
       "version": "1.3.2",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "is-arrayish": "^0.2.1"
@@ -3030,7 +2969,8 @@
     },
     "node_modules/execa": {
       "version": "5.1.1",
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
+      "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
       "dependencies": {
         "cross-spawn": "^7.0.3",
         "get-stream": "^6.0.0",
@@ -3049,17 +2989,6 @@
         "url": "https://github.com/sindresorhus/execa?sponsor=1"
       }
     },
-    "node_modules/expand-tilde": {
-      "version": "2.0.2",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "homedir-polyfill": "^1.0.1"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/fast-deep-equal": {
       "version": "3.1.3",
       "dev": true,
@@ -3131,17 +3060,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/find-file-up": {
-      "version": "2.0.1",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "resolve-dir": "^1.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
     "node_modules/find-up": {
       "version": "5.0.0",
       "dev": true,
@@ -3217,7 +3135,6 @@
     },
     "node_modules/function-bind": {
       "version": "1.1.1",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/function.prototype.name": {
@@ -3237,11 +3154,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/functional-red-black-tree": {
-      "version": "1.0.1",
-      "dev": true,
-      "license": "MIT"
-    },
     "node_modules/functions-have-names": {
       "version": "1.2.3",
       "dev": true,
@@ -3364,45 +3276,6 @@
         "node": ">=4"
       }
     },
-    "node_modules/global-modules": {
-      "version": "1.0.0",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "global-prefix": "^1.0.1",
-        "is-windows": "^1.0.1",
-        "resolve-dir": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/global-prefix": {
-      "version": "1.0.2",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "expand-tilde": "^2.0.2",
-        "homedir-polyfill": "^1.0.1",
-        "ini": "^1.3.4",
-        "is-windows": "^1.0.1",
-        "which": "^1.2.14"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/global-prefix/node_modules/which": {
-      "version": "1.3.1",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "isexe": "^2.0.0"
-      },
-      "bin": {
-        "which": "bin/which"
-      }
-    },
     "node_modules/globals": {
       "version": "13.19.0",
       "dev": true,
@@ -3496,7 +3369,6 @@
     },
     "node_modules/has": {
       "version": "1.0.3",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "function-bind": "^1.1.1"
@@ -3669,17 +3541,6 @@
         "minimalistic-crypto-utils": "^1.0.1"
       }
     },
-    "node_modules/homedir-polyfill": {
-      "version": "1.0.3",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "parse-passwd": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/hosted-git-info": {
       "version": "4.1.0",
       "dev": true,
@@ -3709,7 +3570,8 @@
     },
     "node_modules/human-signals": {
       "version": "2.1.0",
-      "license": "Apache-2.0",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
+      "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
       "engines": {
         "node": ">=10.17.0"
       }
@@ -3833,7 +3695,6 @@
     },
     "node_modules/is-arrayish": {
       "version": "0.2.1",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/is-bigint": {
@@ -3900,7 +3761,6 @@
       "version": "2.12.1",
       "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.12.1.tgz",
       "integrity": "sha512-Q4ZuBAe2FUsKtyQJoQHlvP8OvBERxO3jEmy1I7hcRXcJBGGHFh/aJBswbXuS9sgrDH2QUO8ilkwNPHvHMd8clg==",
-      "dev": true,
       "dependencies": {
         "has": "^1.0.3"
       },
@@ -3977,14 +3837,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/is-node": {
-      "version": "1.0.2",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.10"
-      }
-    },
     "node_modules/is-number": {
       "version": "7.0.0",
       "dev": true,
@@ -4059,7 +3911,8 @@
     },
     "node_modules/is-stream": {
       "version": "2.0.1",
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
       "engines": {
         "node": ">=8"
       },
@@ -4145,14 +3998,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/is-windows": {
-      "version": "1.0.2",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/isarray": {
       "version": "0.0.1",
       "dev": true,
@@ -4173,8 +4018,8 @@
     },
     "node_modules/js-tokens": {
       "version": "4.0.0",
-      "dev": true,
-      "license": "MIT"
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="
     },
     "node_modules/js-yaml": {
       "version": "4.1.0",
@@ -4207,7 +4052,6 @@
     },
     "node_modules/json-parse-even-better-errors": {
       "version": "2.3.1",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/json-schema-traverse": {
@@ -4310,7 +4154,6 @@
     },
     "node_modules/lines-and-columns": {
       "version": "1.2.4",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/linkify-it": {
@@ -4362,9 +4205,10 @@
       }
     },
     "node_modules/lint-staged/node_modules/execa": {
-      "version": "7.1.1",
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-7.2.0.tgz",
+      "integrity": "sha512-UduyVP7TLB5IcAQl+OzLyLcS/l32W/GLg+AhHJ+ow40FOk2U3SAllPwR44v4vmdFwIWqpdwxxpQbF1n5ta9seA==",
       "dev": true,
-      "license": "MIT",
       "dependencies": {
         "cross-spawn": "^7.0.3",
         "get-stream": "^6.0.1",
@@ -4385,16 +4229,18 @@
     },
     "node_modules/lint-staged/node_modules/human-signals": {
       "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-4.3.1.tgz",
+      "integrity": "sha512-nZXjEF2nbo7lIw3mgYjItAfgQXog3OjJogSbKa2CQIIvSGWcKgeJnQlNXip6NglNzYH45nSRiEVimMvYL8DDqQ==",
       "dev": true,
-      "license": "Apache-2.0",
       "engines": {
         "node": ">=14.18.0"
       }
     },
     "node_modules/lint-staged/node_modules/is-stream": {
       "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz",
+      "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==",
       "dev": true,
-      "license": "MIT",
       "engines": {
         "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
       },
@@ -4404,8 +4250,9 @@
     },
     "node_modules/lint-staged/node_modules/mimic-fn": {
       "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz",
+      "integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==",
       "dev": true,
-      "license": "MIT",
       "engines": {
         "node": ">=12"
       },
@@ -4415,8 +4262,9 @@
     },
     "node_modules/lint-staged/node_modules/npm-run-path": {
       "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-5.1.0.tgz",
+      "integrity": "sha512-sJOdmRGrY2sjNTRMbSvluQqg+8X7ZK61yvzBEIDhz4f8z1TZFYABsqjjCBd/0PUNE9M6QDgHJXQkGUEm7Q+l9Q==",
       "dev": true,
-      "license": "MIT",
       "dependencies": {
         "path-key": "^4.0.0"
       },
@@ -4429,8 +4277,9 @@
     },
     "node_modules/lint-staged/node_modules/onetime": {
       "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/onetime/-/onetime-6.0.0.tgz",
+      "integrity": "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==",
       "dev": true,
-      "license": "MIT",
       "dependencies": {
         "mimic-fn": "^4.0.0"
       },
@@ -4443,8 +4292,9 @@
     },
     "node_modules/lint-staged/node_modules/path-key": {
       "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+      "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
       "dev": true,
-      "license": "MIT",
       "engines": {
         "node": ">=12"
       },
@@ -4454,8 +4304,9 @@
     },
     "node_modules/lint-staged/node_modules/strip-final-newline": {
       "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-3.0.0.tgz",
+      "integrity": "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==",
       "dev": true,
-      "license": "MIT",
       "engines": {
         "node": ">=12"
       },
@@ -4648,7 +4499,8 @@
     },
     "node_modules/log-symbols": {
       "version": "4.1.0",
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-4.1.0.tgz",
+      "integrity": "sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==",
       "dependencies": {
         "chalk": "^4.1.0",
         "is-unicode-supported": "^0.1.0"
@@ -4706,11 +4558,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/lru-cache": {
-      "version": "2.3.1",
-      "dev": true,
-      "license": "MIT"
-    },
     "node_modules/magicpen": {
       "version": "6.2.4",
       "dev": true,
@@ -4834,14 +4681,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/memoizesync": {
-      "version": "1.1.1",
-      "dev": true,
-      "license": "BSD",
-      "dependencies": {
-        "lru-cache": "=2.3.1"
-      }
-    },
     "node_modules/memorystream": {
       "version": "0.3.1",
       "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
@@ -4875,6 +4714,18 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/meow/node_modules/type-fest": {
+      "version": "0.18.1",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.18.1.tgz",
+      "integrity": "sha512-OIAYXk8+ISY+qTOwkHtKqzAuxchoMiD9Udx+FSGQDuiRR+PJKJHc2NJAXlbhkGwTt/4/nKZxELY1w3ReWOL8mw==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/merge-stream": {
       "version": "2.0.0",
       "license": "MIT"
@@ -5397,7 +5248,8 @@
     },
     "node_modules/npm-run-path": {
       "version": "4.0.1",
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
+      "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
       "dependencies": {
         "path-key": "^3.0.0"
       },
@@ -5596,6 +5448,14 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/p-try": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
+      "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/pako": {
       "version": "1.0.11",
       "dev": true,
@@ -5626,7 +5486,6 @@
     },
     "node_modules/parse-json": {
       "version": "5.2.0",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/code-frame": "^7.0.0",
@@ -5641,14 +5500,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/parse-passwd": {
-      "version": "1.0.0",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/path-browserify": {
       "version": "0.0.1",
       "dev": true,
@@ -5656,7 +5507,6 @@
     },
     "node_modules/path-exists": {
       "version": "4.0.0",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=8"
@@ -5679,7 +5529,6 @@
     },
     "node_modules/path-parse": {
       "version": "1.0.7",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/path-to-regexp": {
@@ -5775,15 +5624,6 @@
         "url": "https://github.com/prettier/prettier?sponsor=1"
       }
     },
-    "node_modules/pretty-maybe": {
-      "version": "1.2.1",
-      "dev": true,
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "find-file-up": "^2.0.1",
-        "memoizesync": "^1.1.1"
-      }
-    },
     "node_modules/process": {
       "version": "0.11.10",
       "dev": true,
@@ -5908,8 +5748,8 @@
     },
     "node_modules/read-pkg": {
       "version": "5.2.0",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-5.2.0.tgz",
+      "integrity": "sha512-Ug69mNOpfvKDAc2Q8DRpMjjzdtrnv9HcSMX+4VsZxD1aZ6ZzrIE7rlzXBtWTyhULSMKg076AW6WR5iZpD0JiOg==",
       "dependencies": {
         "@types/normalize-package-data": "^2.4.0",
         "normalize-package-data": "^2.5.0",
@@ -5922,8 +5762,8 @@
     },
     "node_modules/read-pkg-up": {
       "version": "7.0.1",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-7.0.1.tgz",
+      "integrity": "sha512-zK0TB7Xd6JpCLmlLmufqykGE+/TlOePD6qKClNW7hHDKFh/J7/7gCWGR7joEQEW1bKq3a3yUZSObOoWLFQ4ohg==",
       "dependencies": {
         "find-up": "^4.1.0",
         "read-pkg": "^5.2.0",
@@ -5938,8 +5778,8 @@
     },
     "node_modules/read-pkg-up/node_modules/find-up": {
       "version": "4.1.0",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
+      "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
       "dependencies": {
         "locate-path": "^5.0.0",
         "path-exists": "^4.0.0"
@@ -5950,8 +5790,8 @@
     },
     "node_modules/read-pkg-up/node_modules/locate-path": {
       "version": "5.0.0",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
+      "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
       "dependencies": {
         "p-locate": "^4.1.0"
       },
@@ -5961,8 +5801,8 @@
     },
     "node_modules/read-pkg-up/node_modules/p-limit": {
       "version": "2.3.0",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
+      "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
       "dependencies": {
         "p-try": "^2.0.0"
       },
@@ -5975,8 +5815,8 @@
     },
     "node_modules/read-pkg-up/node_modules/p-locate": {
       "version": "4.1.0",
-      "dev": true,
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
+      "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
       "dependencies": {
         "p-limit": "^2.2.0"
       },
@@ -5984,31 +5824,23 @@
         "node": ">=8"
       }
     },
-    "node_modules/read-pkg-up/node_modules/p-try": {
-      "version": "2.2.0",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
     "node_modules/read-pkg-up/node_modules/type-fest": {
       "version": "0.8.1",
-      "dev": true,
-      "license": "(MIT OR CC0-1.0)",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.8.1.tgz",
+      "integrity": "sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA==",
       "engines": {
         "node": ">=8"
       }
     },
     "node_modules/read-pkg/node_modules/hosted-git-info": {
       "version": "2.8.9",
-      "dev": true,
-      "license": "ISC"
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz",
+      "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw=="
     },
     "node_modules/read-pkg/node_modules/normalize-package-data": {
       "version": "2.5.0",
-      "dev": true,
-      "license": "BSD-2-Clause",
+      "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz",
+      "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==",
       "dependencies": {
         "hosted-git-info": "^2.1.4",
         "resolve": "^1.10.0",
@@ -6018,16 +5850,16 @@
     },
     "node_modules/read-pkg/node_modules/semver": {
       "version": "5.7.2",
-      "dev": true,
-      "license": "ISC",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz",
+      "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==",
       "bin": {
         "semver": "bin/semver"
       }
     },
     "node_modules/read-pkg/node_modules/type-fest": {
       "version": "0.6.0",
-      "dev": true,
-      "license": "(MIT OR CC0-1.0)",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.6.0.tgz",
+      "integrity": "sha512-q+MB8nYR1KDLrgr4G5yemftpMC7/QLqVndBmEEdqzmNj5dcFOO4Oo8qlwZE3ULT3+Zim1F8Kq4cBnikNhlCMlg==",
       "engines": {
         "node": ">=8"
       }
@@ -6148,7 +5980,6 @@
       "version": "1.22.3",
       "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.3.tgz",
       "integrity": "sha512-P8ur/gp/AmbEzjr729bZnLjXK5Z+4P0zhIJgBgzqRih7hL7BOukHGtSTA3ACMY467GRFz3duQsi0bDZdR7DKdw==",
-      "dev": true,
       "dependencies": {
         "is-core-module": "^2.12.0",
         "path-parse": "^1.0.7",
@@ -6161,18 +5992,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/resolve-dir": {
-      "version": "1.0.1",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "expand-tilde": "^2.0.0",
-        "global-modules": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/resolve-from": {
       "version": "4.0.0",
       "dev": true,
@@ -6657,7 +6476,6 @@
     },
     "node_modules/spdx-correct": {
       "version": "3.1.1",
-      "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
         "spdx-expression-parse": "^3.0.0",
@@ -6666,12 +6484,10 @@
     },
     "node_modules/spdx-exceptions": {
       "version": "2.3.0",
-      "dev": true,
       "license": "CC-BY-3.0"
     },
     "node_modules/spdx-expression-parse": {
       "version": "3.0.1",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "spdx-exceptions": "^2.1.0",
@@ -6680,7 +6496,6 @@
     },
     "node_modules/spdx-license-ids": {
       "version": "3.0.12",
-      "dev": true,
       "license": "CC0-1.0"
     },
     "node_modules/split2": {
@@ -6855,7 +6670,8 @@
     },
     "node_modules/strip-final-newline": {
       "version": "2.0.0",
-      "license": "MIT",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
+      "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
       "engines": {
         "node": ">=6"
       }
@@ -6894,7 +6710,6 @@
     },
     "node_modules/supports-preserve-symlinks-flag": {
       "version": "1.0.0",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.4"
@@ -7084,17 +6899,6 @@
         "node": ">=4"
       }
     },
-    "node_modules/type-fest": {
-      "version": "0.18.1",
-      "dev": true,
-      "license": "(MIT OR CC0-1.0)",
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
     "node_modules/typed-array-buffer": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.0.tgz",
@@ -7240,84 +7044,6 @@
         "unexpected": "^10.8.0 || ^11.0.0-4 || ^12.0.0 || ^13.0.0"
       }
     },
-    "node_modules/unexpected-snapshot": {
-      "version": "2.1.0",
-      "dev": true,
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "@gustavnikolaj/string-utils": "^2.0.0",
-        "bluebird": "^3.5.0",
-        "byline": "^5.0.0",
-        "detect-indent": "^6.0.0",
-        "eslint": "8.15.0",
-        "is-node": "^1.0.2",
-        "lodash.camelcase": "^4.3.0",
-        "memoizesync": "^1.1.1",
-        "pretty-maybe": "^1.0.0"
-      },
-      "peerDependencies": {
-        "unexpected": "^10.27.0 || ^11.0.0 || ^12.0.0 || ^13.0.0"
-      }
-    },
-    "node_modules/unexpected-snapshot/node_modules/eslint": {
-      "version": "8.15.0",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@eslint/eslintrc": "^1.2.3",
-        "@humanwhocodes/config-array": "^0.9.2",
-        "ajv": "^6.10.0",
-        "chalk": "^4.0.0",
-        "cross-spawn": "^7.0.2",
-        "debug": "^4.3.2",
-        "doctrine": "^3.0.0",
-        "escape-string-regexp": "^4.0.0",
-        "eslint-scope": "^7.1.1",
-        "eslint-utils": "^3.0.0",
-        "eslint-visitor-keys": "^3.3.0",
-        "espree": "^9.3.2",
-        "esquery": "^1.4.0",
-        "esutils": "^2.0.2",
-        "fast-deep-equal": "^3.1.3",
-        "file-entry-cache": "^6.0.1",
-        "functional-red-black-tree": "^1.0.1",
-        "glob-parent": "^6.0.1",
-        "globals": "^13.6.0",
-        "ignore": "^5.2.0",
-        "import-fresh": "^3.0.0",
-        "imurmurhash": "^0.1.4",
-        "is-glob": "^4.0.0",
-        "js-yaml": "^4.1.0",
-        "json-stable-stringify-without-jsonify": "^1.0.1",
-        "levn": "^0.4.1",
-        "lodash.merge": "^4.6.2",
-        "minimatch": "^3.1.2",
-        "natural-compare": "^1.4.0",
-        "optionator": "^0.9.1",
-        "regexpp": "^3.2.0",
-        "strip-ansi": "^6.0.1",
-        "strip-json-comments": "^3.1.0",
-        "text-table": "^0.2.0",
-        "v8-compile-cache": "^2.0.3"
-      },
-      "bin": {
-        "eslint": "bin/eslint.js"
-      },
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/eslint"
-      }
-    },
-    "node_modules/unexpected-snapshot/node_modules/eslint-visitor-keys": {
-      "version": "3.3.0",
-      "dev": true,
-      "license": "Apache-2.0",
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      }
-    },
     "node_modules/unexpected/node_modules/detect-indent": {
       "version": "3.0.1",
       "dev": true,
@@ -7381,11 +7107,6 @@
       "dev": true,
       "license": "ISC"
     },
-    "node_modules/v8-compile-cache": {
-      "version": "2.3.0",
-      "dev": true,
-      "license": "MIT"
-    },
     "node_modules/v8-compile-cache-lib": {
       "version": "3.0.1",
       "dev": true,
@@ -7393,7 +7114,6 @@
     },
     "node_modules/validate-npm-package-license": {
       "version": "3.0.4",
-      "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
         "spdx-correct": "^3.0.0",
diff --git a/package.json b/package.json
index 9f7df6b25..6df00f7c3 100644
--- a/package.json
+++ b/package.json
@@ -21,6 +21,10 @@
     "type": "git",
     "url": "https://github.com/boneskull/midnight-smoker"
   },
+  "bugs": {
+    "url": "https://github.com/boneskull/midnight-smoker/issues"
+  },
+  "homepage": "https://github.com/boneskull/midnight-smoker",
   "license": "Apache-2.0",
   "author": "Christopher Hiller <boneskull@boneskull.com> (https://boneskull.com/)",
   "main": "./dist/index.js",
@@ -46,14 +50,15 @@
     "husky-install": "husky install",
     "prepare": "run-p husky-install rebuild",
     "rebuild": "run-s clean build",
-    "smoke": "node ./bin/smoker.js --version",
+    "smoke:ts": "ts-node -D ./src/cli.ts --version",
+    "smoke:js": "node ./bin/smoker.js --version",
     "test": "run-s test:unit test:smoke",
     "test:ci": "run-s test:unit test:smoke test:e2e",
     "test:unit": "mocha \"test/unit/**/*.spec.ts\"",
     "pretest:e2e": "run-s build",
     "test:e2e": "mocha --timeout 20s --slow 10s \"test/e2e/**/*.spec.ts\"",
-    "test:smoke": "node ./bin/smoker.js smoke",
-    "test:snapshots": "cross-env SNAPSHOT_UPDATE=1 run-s test:e2e"
+    "test:smoke": "node ./bin/smoker.js smoke:ts smoke:js --add ts-node --add @tsconfig/node16",
+    "test:update-snapshots": "cross-env SNAPSHOT_UPDATE=1 run-s test:e2e"
   },
   "lint-staged": {
     "*.{js,ts}": [
@@ -79,6 +84,7 @@
     "execa": "5.1.1",
     "ora": "5.4.1",
     "pluralize": "8.0.0",
+    "read-pkg-up": "7.0.1",
     "source-map-support": "0.5.21",
     "strict-event-emitter-types": "2.0.0",
     "which": "3.0.1",
@@ -119,8 +125,7 @@
     "typescript": "5.1.6",
     "unexpected": "13.2.1",
     "unexpected-eventemitter": "2.4.0",
-    "unexpected-sinon": "11.1.0",
-    "unexpected-snapshot": "2.1.0"
+    "unexpected-sinon": "11.1.0"
   },
   "engines": {
     "node": "^16.13.0 || ^18.0.0 || ^20.0.0",
diff --git a/src/cli.ts b/src/cli.ts
index 9955e5861..435fc7481 100755
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -1,12 +1,12 @@
 import {blue, red, white, yellow} from 'chalk';
-import {readFile} from 'node:fs/promises';
 import ora from 'ora';
 import pluralize from 'pluralize';
 import {hideBin} from 'yargs/helpers';
 import yargs from 'yargs/yargs';
-import {events} from './index.js';
-import {Smoker} from './smoker.js';
+import {events} from './index';
+import {Smoker} from './smoker';
 import type {Events} from './types';
+import {readPackageJson} from './util';
 
 const BEHAVIOR_GROUP = 'Behavior:';
 
@@ -15,233 +15,239 @@ const BEHAVIOR_GROUP = 'Behavior:';
  */
 type SmokerJsonOutput = Events['RunScriptsFailed'] | Events['RunScriptsOk'];
 
+/**
+ * Main entry point for the CLI script
+ * @param args Raw command-line arguments array
+ */
 async function main(args: string[]): Promise<void> {
   const y = yargs(args);
-  const {version} = JSON.parse(
-    await readFile(require.resolve('../package.json'), 'utf8'),
-  );
-  await y
-    .scriptName('smoker')
-    .command(
-      '* <script> [scripts..]',
-      'Run tests against a package as it would be published',
-      (yargs) =>
-        yargs
-          .positional('script', {type: 'string'})
-          .positional('scripts', {type: 'string'})
-          .options({
-            require: {
-              alias: 'r',
-              type: 'string',
-              array: true,
-              group: BEHAVIOR_GROUP,
-              requiresArg: true,
-              describe:
-                'Package identifier for extra dependency needed by smoke tests',
-            },
-            workspace: {
-              requiresArg: true,
-              type: 'string',
-              describe: 'One or more npm workspaces to test',
-              group: BEHAVIOR_GROUP,
-              array: true,
-            },
-            all: {
-              type: 'boolean',
-              describe: 'Test all workspaces',
-              group: BEHAVIOR_GROUP,
-            },
-            'include-root': {
-              type: 'boolean',
-              describe: "Include the workspace root; must provide '--all'",
-              group: BEHAVIOR_GROUP,
-              implies: 'all',
-            },
-            'install-args': {
-              requiresArg: true,
-              describe: 'Extra arguments to pass to `npm install`',
-              type: 'string',
-              array: true,
-              group: BEHAVIOR_GROUP,
-            },
-            dir: {
-              requiresArg: true,
-              type: 'string',
-              describe: 'Working directory to use',
-              defaultDescription: 'new temp dir',
-              group: BEHAVIOR_GROUP,
-            },
-            force: {
-              type: 'boolean',
-              group: BEHAVIOR_GROUP,
-              describe: 'Overwrite working directory if it exists',
-            },
-            clean: {
-              type: 'boolean',
-              group: BEHAVIOR_GROUP,
-              describe: "Truncate working directory; must provide '--force'",
-              implies: 'force',
-            },
-            npm: {
-              type: 'string',
-              requiresArg: true,
-              describe: 'Path to `npm` executable',
-              defaultDescription: '`npm` in PATH',
-              group: BEHAVIOR_GROUP,
-              normalize: true,
-            },
-            verbose: {
-              type: 'boolean',
-              describe: 'Print output from npm',
-              group: BEHAVIOR_GROUP,
-            },
-            bail: {
-              type: 'boolean',
-              describe: 'When running scripts, halt on first error',
-              group: BEHAVIOR_GROUP,
-            },
-            linger: {
-              type: 'boolean',
-              describe: 'Do not clean up working dir after completion',
-              hidden: true,
-              group: BEHAVIOR_GROUP,
-            },
-            json: {
-              type: 'boolean',
-              describe: 'Output JSON only',
-              group: BEHAVIOR_GROUP,
-            },
-          })
-          .check((argv) => {
-            if (
-              Array.isArray(argv['install-args']) &&
-              argv['install-args'].length > 1
-            ) {
-              throw new Error('--install-args can only be provided once');
-            }
-            return true;
-          }),
-      async (argv) => {
-        const scripts = [argv.script as string, ...(argv.scripts ?? [])];
 
-        // squelch some output if `json` is true
-        argv.verbose = argv.json ? false : argv.verbose;
+  const result = await readPackageJson({cwd: __dirname});
+  if (!result) {
+    throw new Error(
+      'midnight-smoker could not find its own package.json! bogus',
+    );
+  }
+  const {packageJson} = result;
+  const {version, homepage} = packageJson;
+  try {
+    await y
+      .scriptName('smoker')
+      .command(
+        '* <script> [scripts..]',
+        'Run tests against a package as it would be published',
+        (yargs) =>
+          yargs
+            .positional('script', {type: 'string'})
+            .positional('scripts', {type: 'string'})
+            .options({
+              add: {
+                type: 'string',
+                array: true,
+                group: BEHAVIOR_GROUP,
+                requiresArg: true,
+                describe: 'Additional dependency to provide to smoke tests',
+              },
+              workspace: {
+                requiresArg: true,
+                type: 'string',
+                describe: 'One or more npm workspaces to test',
+                group: BEHAVIOR_GROUP,
+                array: true,
+              },
+              all: {
+                type: 'boolean',
+                describe: 'Test all workspaces',
+                group: BEHAVIOR_GROUP,
+              },
+              'include-root': {
+                type: 'boolean',
+                describe: "Include the workspace root; must provide '--all'",
+                group: BEHAVIOR_GROUP,
+                implies: 'all',
+              },
+              'install-args': {
+                requiresArg: true,
+                describe: 'Extra arguments to pass to `npm install`',
+                type: 'string',
+                array: true,
+                group: BEHAVIOR_GROUP,
+              },
+              dir: {
+                requiresArg: true,
+                type: 'string',
+                describe: 'Working directory to use',
+                defaultDescription: 'new temp dir',
+                group: BEHAVIOR_GROUP,
+              },
+              force: {
+                type: 'boolean',
+                group: BEHAVIOR_GROUP,
+                describe: 'Overwrite working directory if it exists',
+              },
+              clean: {
+                type: 'boolean',
+                group: BEHAVIOR_GROUP,
+                describe: "Truncate working directory; must provide '--force'",
+                implies: 'force',
+              },
+              npm: {
+                type: 'string',
+                requiresArg: true,
+                describe: 'Path to `npm` executable',
+                defaultDescription: '`npm` in PATH',
+                group: BEHAVIOR_GROUP,
+                normalize: true,
+              },
+              verbose: {
+                type: 'boolean',
+                describe: 'Print output from npm',
+                group: BEHAVIOR_GROUP,
+              },
+              bail: {
+                type: 'boolean',
+                describe: 'When running scripts, halt on first error',
+                group: BEHAVIOR_GROUP,
+              },
+              linger: {
+                type: 'boolean',
+                describe: 'Do not clean up working dir after completion',
+                hidden: true,
+                group: BEHAVIOR_GROUP,
+              },
+              json: {
+                type: 'boolean',
+                describe: 'Output JSON only',
+                group: BEHAVIOR_GROUP,
+              },
+            })
+            .epilog(`For more info, see ${homepage}`)
+            .check((argv) => {
+              if (
+                Array.isArray(argv['install-args']) &&
+                argv['install-args'].length > 1
+              ) {
+                throw new Error('--install-args can only be provided once');
+              }
+              return true;
+            }),
+        async (argv) => {
+          const scripts = [argv.script as string, ...(argv.scripts ?? [])];
+
+          // squelch some output if `json` is true
+          argv.verbose = argv.json ? false : argv.verbose;
 
-        const smoker = Smoker.withNpm(scripts, argv);
+          const smoker = Smoker.withNpm(scripts, argv);
 
-        if (argv.json) {
-          let output: SmokerJsonOutput;
-          const setResult = (result: SmokerJsonOutput) => {
-            smoker
-              .removeAllListeners(events.RUN_SCRIPTS_OK)
-              .removeAllListeners(events.RUN_SCRIPTS_FAILED);
-            output = result;
-          };
+          if (argv.json) {
+            let output: SmokerJsonOutput;
+            const setResult = (result: SmokerJsonOutput) => {
+              smoker
+                .removeAllListeners(events.RUN_SCRIPTS_OK)
+                .removeAllListeners(events.RUN_SCRIPTS_FAILED);
+              output = result;
+            };
           const writeResult = () => {
+              smoker
+                .removeAllListeners(events.SMOKE_OK)
+                .removeAllListeners(events.SMOKE_FAILED);
+              console.log(JSON.stringify(output, null, 2));
+            };
             smoker
-              .removeAllListeners(events.SMOKE_OK)
-              .removeAllListeners(events.SMOKE_FAILED);
-            console.log(JSON.stringify(output, null, 2));
-          };
-          smoker
-            .once(events.RUN_SCRIPTS_OK, setResult)
-            .once(events.RUN_SCRIPTS_FAILED, setResult)
+              .once(events.RUN_SCRIPTS_OK, setResult)
+              .once(events.RUN_SCRIPTS_FAILED, setResult)
             .once(events.SMOKE_FAILED, writeResult)
             .once(events.SMOKE_OK, writeResult);
-          await smoker.smoke();
-        } else {
-          const spinner = ora();
-          const scriptFailedEvts: Events['RunScriptFailed'][] = [];
-          smoker
-            .on(events.SMOKE_BEGIN, () => {
-              console.error(
-                `💨 ${blue('midnight-smoker')} ${white(`v${version}`)}`,
-              );
-            })
-            // .on(events.FIND_NPM_BEGIN, () => {
-            //   spinner.start('Looking for npm...');
-            // })
-            // .on(events.FIND_NPM_OK, (path) => {
-            //   spinner.succeed(`Found npm at ${path}`);
-            // })
-            // .on(events.FIND_NPM_FAILED, (err) => {
-            //   spinner.fail(`Could not find npm: ${err.message}`);
-            //   process.exitCode = 1;
-            // })
-            .on(events.PACK_BEGIN, () => {
-              let what: string;
-              if (argv.workspace?.length) {
-                what = pluralize('workspace', argv.workspace.length, true);
-              } else if (argv.all) {
-                what = 'all workspaces';
-                if (argv.includeRoot) {
-                  what += ' (and the workspace root)';
+            await smoker.smoke();
+          } else {
+            const spinner = ora();
+            const scriptFailedEvts: Events['RunScriptFailed'][] = [];
+            smoker
+              .on(events.SMOKE_BEGIN, () => {
+                console.error(
+                  `💨 ${blue('midnight-smoker')} ${white(`v${version}`)}`,
+                );
+              })
+              .on(events.PACK_BEGIN, () => {
+                let what: string;
+                if (argv.workspace?.length) {
+                  what = pluralize('workspace', argv.workspace.length, true);
+                } else if (argv.all) {
+                  what = 'all workspaces';
+                  if (argv.includeRoot) {
+                    what += ' (and the workspace root)';
+                  }
+                } else {
+                  what = 'current project';
                 }
-              } else {
-                what = 'current project';
-              }
-              spinner.start(`Packing ${what}...`);
-            })
-            .on(events.PACK_OK, (manifest) => {
-              spinner.succeed(
-                `Packed ${pluralize(
-                  'package',
-                  manifest.packedPkgs.length,
-                  true,
-                )}`,
-              );
-            })
-            .on(events.PACK_FAILED, (err) => {
-              spinner.fail(err.message);
-              process.exitCode = 1;
-            })
-            .on(events.INSTALL_BEGIN, (manifest) => {
-              spinner.start(
-                `Installing from ${pluralize(
-                  'tarball',
-                  manifest.packedPkgs.length,
-                  true,
-                )}...`,
-              );
-            })
-            .on(events.INSTALL_FAILED, (err) => {
-              spinner.fail(err.message);
-              process.exitCode = 1;
-            })
-            .on(events.INSTALL_OK, (manifest) => {
-              spinner.succeed(
-                `Installed ${pluralize(
-                  'package',
-                  manifest.packedPkgs.length,
-                  true,
-                )}`,
-              );
-            })
-            .on(events.RUN_SCRIPTS_BEGIN, ({total}) => {
-              spinner.start(`Running script 0/${total}...`);
-            })
-            .on(events.RUN_SCRIPT_BEGIN, ({current, total}) => {
-              spinner.text = `Running script ${current}/${total}...`;
-            })
-            .on(events.RUN_SCRIPT_FAILED, (evt) => {
-              scriptFailedEvts.push(evt);
-              process.exitCode = 1;
-            })
-            .on(events.RUN_SCRIPTS_OK, ({total}) => {
-              spinner.succeed(
-                `Successfully ran ${pluralize('script', total, true)}`,
-              );
-            })
-            .on(events.RUN_SCRIPTS_FAILED, ({total, failures}) => {
-              spinner.fail(
-                `${failures} of ${total} ${pluralize('script', total)} failed`,
-              );
-              process.exitCode = 1;
-            })
-            .on(events.SMOKE_FAILED, (err) => {
-              spinner.fail(err?.message ?? err);
-
-              if (scriptFailedEvts.length) {
+                spinner.start(`Packing ${what}...`);
+              })
+              .on(events.PACK_OK, (manifest) => {
+                spinner.succeed(
+                  `Packed ${pluralize(
+                    'package',
+                    manifest.packedPkgs.length,
+                    true,
+                  )}`,
+                );
+              })
+              .on(events.PACK_FAILED, (err) => {
+                spinner.fail(err.message);
+                process.exitCode = 1;
+              })
+              .on(events.INSTALL_BEGIN, (manifest) => {
+                const msg = manifest.additionalDeps?.length
+                  ? `Installing from ${pluralize(
+                      'tarball',
+                      manifest.packedPkgs.length,
+                      true,
+                    )} with ${pluralize(
+                      'additional dependency',
+                      manifest.additionalDeps.length,
+                      true,
+                    )}...`
+                  : `Installing from ${pluralize(
+                      'tarball',
+                      manifest.packedPkgs.length,
+                      true,
+                    )}...`;
+                spinner.start(msg);
+              })
+              .on(events.INSTALL_FAILED, (err) => {
+                spinner.fail(err.message);
+                process.exitCode = 1;
+              })
+              .on(events.INSTALL_OK, (manifest) => {
+                spinner.succeed(
+                  `Installed ${pluralize(
+                    'package',
+                    manifest.packedPkgs.length,
+                    true,
+                  )} from tarball`,
+                );
+              })
+              .on(events.RUN_SCRIPTS_BEGIN, ({total}) => {
+                spinner.start(`Running script 0/${total}...`);
+              })
+              .on(events.RUN_SCRIPT_BEGIN, ({current, total}) => {
+                spinner.text = `Running script ${current}/${total}...`;
+              })
+              .on(events.RUN_SCRIPT_FAILED, (evt) => {
+                scriptFailedEvts.push(evt);
+                process.exitCode = 1;
+              })
+              .on(events.RUN_SCRIPTS_OK, ({total}) => {
+                spinner.succeed(
+                  `Successfully ran ${pluralize('script', total, true)}`,
+                );
+              })
+              .on(events.RUN_SCRIPTS_FAILED, ({total, failures}) => {
+                spinner.fail(
+                  `${failures} of ${total} ${pluralize(
+                    'script',
+                    total,
+                  )} failed`,
+                );
                 for (const evt of scriptFailedEvts) {
                   console.error(
                     `\n${red('Error details')} for failed package ${yellow(
@@ -250,20 +256,27 @@ async function main(args: string[]): Promise<void> {
                   );
                   console.error(evt.error.message);
                 }
-              }
-              process.exitCode = 1;
-            })
-            .on(events.SMOKE_OK, () => {
-              spinner.succeed('Lovey-dovey! 💖');
-            });
-          await smoker.smoke();
-        }
-      },
-    )
-    .showHelpOnFail(false)
-    .help()
-    .strict()
-    .parseAsync();
+                process.exitCode = 1;
+              })
+              .on(events.SMOKE_FAILED, (err) => {
+                spinner.fail(err?.message ?? err);
+                process.exitCode = 1;
+              })
+              .on(events.SMOKE_OK, () => {
+                spinner.succeed('Lovey-dovey! 💖');
+              });
+            await smoker.smoke();
+          }
+        },
+      )
+      .showHelpOnFail(false)
+      .help()
+      .strict()
+      .parseAsync();
+  } catch (err) {
+    console.error(red(err));
+    process.exitCode = 1;
+  }
 }
 
 main(hideBin(process.argv));
diff --git a/src/pm/npm.ts b/src/pm/npm.ts
index b062a322d..71d0d4e2e 100644
--- a/src/pm/npm.ts
+++ b/src/pm/npm.ts
@@ -22,8 +22,9 @@ const debug = createDebug('midnight-smoker:npm');
 
 /**
  * Type of item in the {@linkcode NpmPackItem.files} array.
+ * @internal
  */
-interface NpmPackItemFileEntry {
+export interface NpmPackItemFileEntry {
   path: string;
   size: number;
   mode: number;
@@ -48,20 +49,17 @@ export interface NpmPackItem {
 }
 
 export class Npm implements PackageManager {
-  private cachedBinPath?: string;
-  private cachedVersion?: string;
-
   public readonly name = 'npm';
 
-  constructor(private readonly opts?: PackageManagerOpts) {}
+  constructor(private readonly opts: PackageManagerOpts = {}) {}
 
   public async exec(args: string[], execaOpts: ExecaOptions = {}) {
-    const binPath = await this.getBinPath();
+    const binPath = await Npm.getBinPath(this.opts.binPath);
     const command = `${binPath} ${args.join(' ')}`;
     debug(`Executing: ${command}`);
     const proc = execa(binPath, args, execaOpts);
 
-    if (this.opts?.verbose) {
+    if (this.opts.verbose) {
       proc.stdout?.pipe(process.stdout);
       proc.stderr?.pipe(process.stderr);
     }
@@ -69,30 +67,25 @@ export class Npm implements PackageManager {
     return await proc;
   }
 
-  public async getBinPath(): Promise<string> {
+  public static async getBinPath(binPath?: string): Promise<string> {
+    if (binPath) {
+      return binPath;
+    }
     try {
-      if (!this.cachedBinPath) {
-        this.cachedBinPath = this.opts?.binPath
-          ? this.opts.binPath
-          : await which(this.name);
-      }
+      return await which('npm');
     } catch (err) {
       throw new SmokerError(
         `Failed to find "${this.name}" in PATH: ${(err as Error).message}`,
       );
     }
-    return this.cachedBinPath;
   }
 
-  public async getVersion(): Promise<string> {
-    if (this.cachedVersion) {
-      return this.cachedVersion;
+  public static async getVersion(binPath: string): Promise<string> {
+    if (!binPath) {
+      throw new TypeError('(getVersion) "binPath" arg is required');
     }
-    const {stdout: version} = await execa(await this.getBinPath(), [
-      '--version',
-    ]);
-    this.cachedVersion = version.trim();
-    return this.cachedVersion;
+    const {stdout: version} = await execa(binPath, ['--version']);
+    return version.trim();
   }
 
   public async install(
@@ -104,11 +97,13 @@ export class Npm implements PackageManager {
       throw new TypeError('(install) Non-empty "packedPkgs" arg is required');
     }
 
-    await Promise.resolve();
-
     const extraArgs = opts.extraArgs ?? [];
+    const additionalDeps = manifest.additionalDeps ?? [];
+
+    const version = await Npm.getVersion(
+      await Npm.getBinPath(this.opts?.binPath),
+    );
 
-    const version = await this.getVersion();
     // otherwise we get a deprecation warning
     const globalStyleFlag =
       version.startsWith('7') || version.startsWith('8')
@@ -119,9 +114,10 @@ export class Npm implements PackageManager {
       globalStyleFlag,
       ...extraArgs,
       ...packedPkgs.map(({tarballFilepath}) => tarballFilepath),
+      ...additionalDeps,
     ];
 
-    let installResult: ExecaReturnValue<string>;
+    let installResult: InstallResult;
     try {
       installResult = await this.exec(installArgs, {
         cwd: tarballRootDir,
@@ -219,21 +215,22 @@ export class Npm implements PackageManager {
       throw new TypeError('(runScript) "packedPkg" arg is required');
     }
     const npmArgs = ['run-script', script];
-    const {pkgName, installPath} = packedPkg;
+    const {pkgName, installPath: cwd} = packedPkg;
 
     let result: RunScriptResult;
     try {
-      const value = await this.exec(npmArgs, {cwd: installPath});
-      result = {pkgName, script, rawResult: value};
+      const rawResult = await this.exec(npmArgs, {cwd});
+      result = {pkgName, script, rawResult, cwd};
     } catch (err) {
       const error = err as ExecaError;
       result = {
         pkgName,
         script,
         error: new SmokerError(
-          `(runScript) ${this.name} failed to spawn: ${error.message}`,
+          `(runScript) Script "${script}" in package "${pkgName}" failed: ${error.message}`,
         ),
         rawResult: error,
+        cwd,
       };
     }
 
diff --git a/src/pm/pm.ts b/src/pm/pm.ts
index 106d46361..406cd915e 100644
--- a/src/pm/pm.ts
+++ b/src/pm/pm.ts
@@ -1,4 +1,3 @@
-import type {ExecaReturnValue} from 'execa';
 import type {InstallManifest, PackedPackage, RunScriptResult} from '../types';
 
 export interface InstallOpts {
@@ -6,7 +5,13 @@ export interface InstallOpts {
 }
 
 export interface PackageManagerOpts {
+  /**
+   * If `true`, show STDERR/STDOUT from the package manager
+   */
   verbose?: boolean;
+  /**
+   * Explicit path to package manager executable
+   */
   binPath?: string;
 }
 
@@ -35,10 +40,12 @@ export interface RunScriptOpts {
 /**
  * @todo make this more useful
  */
-export type InstallResult = Pick<
-  ExecaReturnValue<string>,
-  'stdout' | 'stderr' | 'command' | 'exitCode'
->;
+export interface InstallResult {
+  stdout: string;
+  stderr: string;
+  command: string;
+  exitCode: number;
+}
 
 export interface PackageManager {
   /**
diff --git a/src/smoker.ts b/src/smoker.ts
index 01b35b587..dd1418785 100644
--- a/src/smoker.ts
+++ b/src/smoker.ts
@@ -12,8 +12,10 @@ import type {
   InstallManifest,
   PackedPackage,
   RunScriptResult,
+  SmokeOptions,
   SmokerOptions,
 } from './types';
+import {castArray, normalizeStringArray} from './util';
 
 const debug = createDebug('midnight-smoker');
 
@@ -21,14 +23,6 @@ export const TMP_DIR_PREFIX = 'midnight-smoker-';
 
 type TSmokerEmitter = StrictEventEmitter<EventEmitter, Events>;
 
-/**
- * Trims all strings in an array and removes empty strings.
- * Returns empty array if input is falsy.
- */
-function normalizeArray(array?: string[]): string[] {
-  return array ? array.map((item) => item.trim()).filter(Boolean) : [];
-}
-
 function createStrictEventEmitterClass() {
   const TypedEmitter: {new (): TSmokerEmitter} = EventEmitter as any;
   return TypedEmitter;
@@ -50,6 +44,7 @@ export const events = {
   RUN_SCRIPT_BEGIN: 'RunScriptBegin',
   RUN_SCRIPT_FAILED: 'RunScriptFailed',
   RUN_SCRIPT_OK: 'RunScriptOk',
+  LINGERED: 'Lingered',
 } as const;
 
 const {
@@ -68,6 +63,7 @@ const {
   RUN_SCRIPT_BEGIN,
   RUN_SCRIPT_FAILED,
   RUN_SCRIPT_OK,
+  LINGERED,
 } = events;
 
 export class Smoker extends createStrictEventEmitterClass() {
@@ -78,9 +74,9 @@ export class Smoker extends createStrictEventEmitterClass() {
   private readonly force: boolean;
   private readonly includeWorkspaceRoot;
   private readonly linger: boolean;
-  private readonly verbose: boolean;
   private readonly workspaces: string[];
 
+  private readonly add: string[];
   private cwd?: string;
 
   public readonly opts: Readonly<SmokerOptions>;
@@ -92,29 +88,27 @@ export class Smoker extends createStrictEventEmitterClass() {
     opts: SmokerOptions = {},
   ) {
     super();
-    if (typeof scripts === 'string') {
-      scripts = [scripts];
-    }
-    this.scripts = normalizeArray(scripts);
+    this.scripts = normalizeStringArray(castArray(scripts));
     opts = {...opts};
 
     this.linger = Boolean(opts.linger);
     this.force = Boolean(opts.force);
     this.clean = Boolean(opts.clean);
-    this.verbose = Boolean(opts.verbose);
     this.includeWorkspaceRoot = Boolean(opts.includeRoot);
     if (this.includeWorkspaceRoot) {
       opts.all = true;
     }
+    this.add = normalizeStringArray(opts.add);
     this.bail = Boolean(opts.bail);
     this.allWorkspaces = Boolean(opts.all);
-    this.workspaces = normalizeArray(opts.workspace);
+    this.workspaces = normalizeStringArray(opts.workspace);
     if (this.allWorkspaces && this.workspaces.length) {
       throw new SmokerError(
         'Option "workspace" is mutually exclusive with "all" and/or "includeRoot"',
       );
     }
-    this.extraArgs = normalizeArray(opts.installArgs);
+    this.extraArgs = normalizeStringArray(opts.installArgs);
+
     this.opts = Object.freeze(opts);
   }
 
@@ -125,13 +119,13 @@ export class Smoker extends createStrictEventEmitterClass() {
    */
   public static async smoke(
     scripts: string | string[],
-    opts: SmokerOptions = {},
+    opts: SmokeOptions = {},
   ): Promise<RunScriptResult[]> {
     const smoker = Smoker.withNpm(scripts, opts);
     return smoker.smoke();
   }
 
-  public static withNpm(scripts: string | string[], opts: SmokerOptions = {}) {
+  public static withNpm(scripts: string | string[], opts: SmokeOptions = {}) {
     return new Smoker(
       scripts,
       new Npm({binPath: opts.npm, verbose: opts.verbose}),
@@ -179,18 +173,20 @@ export class Smoker extends createStrictEventEmitterClass() {
   /**
    * Installs from tarball in a temp dir
    */
-  public async install(manifest: InstallManifest): Promise<void> {
-    if (!manifest) {
+  public async install(originalManifest: InstallManifest): Promise<void> {
+    if (!originalManifest) {
       throw new TypeError('(install) "manifest" arg is required');
     }
 
-    const pkgCount = manifest.packedPkgs.length;
+    const pkgCount = originalManifest.packedPkgs.length;
     if (!pkgCount) {
       throw new TypeError(
         '(install) "manifest" arg must contain non-empty list of packed packages',
       );
     }
 
+    const manifest = {...originalManifest, additionalDeps: this.add};
+
     // ensure we emit asynchronously
     await Promise.resolve();
     this.emit(INSTALL_BEGIN, manifest);
@@ -211,7 +207,7 @@ export class Smoker extends createStrictEventEmitterClass() {
    * Creates a tarball for one or more packages
    */
   public async pack(): Promise<InstallManifest> {
-    const dest = await this.createWorkingDir();
+    const dest = await this.createWorkingDirectory();
     this.emit(PACK_BEGIN);
 
     let manifest: InstallManifest;
@@ -313,17 +309,25 @@ export class Smoker extends createStrictEventEmitterClass() {
     await Promise.resolve();
     this.emit(SMOKE_BEGIN);
 
+    let results: RunScriptResult[] | undefined;
     try {
       const manifest = await this.pack();
       debug('(smoke) Received %d packed packages', manifest.packedPkgs.length);
       await this.install(manifest);
-      const results = await this.runScripts(manifest.packedPkgs);
-      this.emit(SMOKE_OK);
+      results = await this.runScripts(manifest.packedPkgs);
+      if (!results.some((result) => result.error)) {
+        this.emit(SMOKE_OK);
+      } else {
+        this.emit(SMOKE_FAILED, new SmokerError('🤮 Maurice!'));
+      }
       return results;
     } catch (err) {
       this.emit(SMOKE_FAILED, err as Error);
       throw err;
     } finally {
+      if (this.linger && this.cwd) {
+        this.emit(LINGERED, [this.cwd]);
+      }
       await this.cleanup();
     }
   }
diff --git a/src/stubs.d.ts b/src/stubs.d.ts
new file mode 100644
index 000000000..e69de29bb
diff --git a/src/types.ts b/src/types.ts
index 63fc741d0..cf0d7bf8e 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -24,10 +24,11 @@ export interface PackedPackage {
 
 export interface InstallManifest {
   packedPkgs: PackedPackage[];
+  additionalDeps?: string[];
   tarballRootDir: string;
 }
 
-export interface SmokerOptions {
+export interface SmokeOptions {
   /**
    * List of workspaces to use
    */
@@ -61,7 +62,7 @@ export interface SmokerOptions {
    */
   npm?: string;
   /**
-   * If `true`, show output from `npm`
+   * If `true`, show STDERR/STDOUT from the package manager
    */
   verbose?: boolean;
   /**
@@ -77,8 +78,15 @@ export interface SmokerOptions {
    * If `true`, output JSON instead of human-readable text
    */
   json?: boolean;
+
+  /**
+   * Additional deps to install
+   */
+  add?: string[];
 }
 
+export type SmokerOptions = Omit<SmokeOptions, 'verbose'>;
+
 export type RunScriptValue = Pick<
   ExecaReturnValue<string>,
   'stdout' | 'stderr' | 'command' | 'exitCode' | 'failed' | 'all'
@@ -89,6 +97,7 @@ export interface RunScriptResult {
   script: string;
   error?: SmokerError;
   rawResult: RunScriptValue | ExecaError;
+  cwd: string;
 }
 
 export interface Events {
@@ -134,4 +143,6 @@ export interface Events {
     total: number;
     current: number;
   };
+
+  Lingered: string[];
 }
diff --git a/src/util.ts b/src/util.ts
new file mode 100644
index 000000000..2bf777740
--- /dev/null
+++ b/src/util.ts
@@ -0,0 +1,166 @@
+/**
+ * Gotta have a "util" module
+ * @module
+ */
+
+import readPkgUp from 'read-pkg-up';
+import {SmokerError} from './error';
+
+/**
+ * Trims all strings in an array and removes empty strings.
+ * Returns empty array if input is falsy.
+ */
+export function normalizeStringArray(array?: string[]): string[] {
+  return array ? array.map((item) => item.trim()).filter(Boolean) : [];
+}
+
+export function castArray<T>(value: T | T[]): T[] {
+  return Array.isArray(value) ? value : [value];
+}
+
+/**
+ * Regex string to match a package name.
+ *
+ * Used by {@linkcode PKG_NAME_REGEX} and {@linkcode PKG_NAME_WITH_SPEC_REGEX}.
+ */
+const PKG_NAME_REGEX_STR =
+  '^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*';
+
+/**
+ * Regex to match a package name without a spec
+ */
+const PKG_NAME_REGEX = new RegExp(`${PKG_NAME_REGEX_STR}$`);
+
+/**
+ * Regex to match a package name with a spec.
+ *
+ * @remarks This does not attempt to validate a semver string, though it could.
+ * If it did, it'd also need to allow any valid package tag.  I'm not sure what
+ * the latter is, but the former can be found on
+ * {@link https://stackoverflow.com/a/72900791|StackOverflow}.
+ */
+const PKG_NAME_WITH_SPEC_REGEX = new RegExp(`${PKG_NAME_REGEX_STR}@.+$`);
+
+/**
+ * Fields in `package.json` that might have a dependency we want to install as
+ * an isolated package to help run smoke tests.
+ *
+ * @remarks Order is important; changing this should be a breaking change
+ */
+const DEP_FIELDS = [
+  'devDependencies',
+  'dependencies',
+  'optionalDependencies',
+  'peerDependencies',
+] as const;
+
+/**
+ * Try to pick a version for a package to install.
+ *
+ * Given an `installable` which is both a) a valid npm package name and b) has
+ * no version specifier, determine the version to install.
+ *
+ * If the `package.json` within `cwd` contains the package of the same name, we
+ * will use that version; otherwise we will use the `latest` tag. If
+ * `installable` is not a package name at all, it passes thru verbatim.
+ *
+ * @param installable The `thing` in `npm install <thing>`
+ * @param cwd Where the command would be run
+ */
+export async function pickPackageVersion(
+  installable: string,
+  cwd = process.cwd(),
+): Promise<string> {
+  if (PKG_NAME_WITH_SPEC_REGEX.test(installable)) {
+    // we were given a package name with a version spec. just use it
+    return installable;
+  }
+
+  if (PKG_NAME_REGEX.test(installable)) {
+    // we were given a package name, no version.
+    // try to see if it's in the package.json
+    const pkgName = installable;
+
+    const {packageJson} = (await readPackageJson({cwd})) ?? {};
+    if (packageJson) {
+      for (const field of DEP_FIELDS) {
+        const deps = packageJson[field];
+        if (deps && pkgName in deps) {
+          return `${pkgName}@${deps[pkgName]}`;
+        }
+      }
+    }
+    return `${pkgName}@latest`;
+  }
+
+  // could be a path or url
+  return installable;
+}
+
+/**
+ * Options for {@linkcode readPackageJson}
+ */
+export interface ReadPackageJsonOpts {
+  /**
+   * Defaults to `process.cwd()`
+   */
+  cwd?: string;
+  /**
+   * Normalize the `package.json`
+   */
+  normalize?: boolean;
+
+  /**
+   * Reject if not found
+   */
+  strict?: boolean;
+}
+
+/**
+ * Reads closest `package.json` from some dir
+ * @param cwd Dir to read from
+ * @param Options
+ * @returns Object with `packageJson` and `path` properties or `undefined` if not in `strict` mode
+ */
+export async function readPackageJson(
+  opts: ReadPackageJsonOpts & {strict: true},
+): Promise<readPkgUp.ReadResult>;
+export async function readPackageJson(
+  opts?: ReadPackageJsonOpts,
+): Promise<readPkgUp.ReadResult | undefined>;
+export async function readPackageJson({
+  cwd,
+  normalize,
+  strict,
+}: ReadPackageJsonOpts = {}): Promise<readPkgUp.ReadResult | undefined> {
+  const result = readPkgUp({cwd, normalize});
+  if (!result && strict) {
+    throw new SmokerError(`Could not find a package.json near ${cwd}`);
+  }
+  return result;
+}
+
+/**
+ * Reads closest `package.json` from some dir (synchronously)
+ * @param cwd Dir to read from
+ * @param Options
+ * @returns Object with `packageJson` and `path` properties or `undefined` if not in `strict` mode
+ * @remarks Use {@linkcode readPackageJson} instead if possible
+ */
+export function readPackageJsonSync(
+  opts: ReadPackageJsonOpts & {strict: true},
+): readPkgUp.ReadResult;
+export function readPackageJsonSync(
+  opts?: ReadPackageJsonOpts,
+): readPkgUp.ReadResult | undefined;
+export function readPackageJsonSync({
+  cwd,
+  normalize,
+  strict,
+}: ReadPackageJsonOpts = {}) {
+  const result = readPkgUp.sync({cwd, normalize});
+  if (!result && strict) {
+    throw new SmokerError(`Could not find a package.json near ${cwd}`);
+  }
+  return result;
+}
diff --git a/test/assertions.ts b/test/assertions.ts
new file mode 100644
index 000000000..dbd34d0cc
--- /dev/null
+++ b/test/assertions.ts
@@ -0,0 +1,51 @@
+import type {ExecaReturnValue} from 'execa';
+import {readPackageJsonSync} from '../src/util';
+import type unexpected from 'unexpected';
+
+const {packageJson} = readPackageJsonSync({cwd: __dirname, strict: true});
+export default {
+  name: 'unexpected-midnight-smoker-internal',
+  version: packageJson.version,
+  installInto(expect: typeof unexpected) {
+    expect
+      .addType({
+        name: 'ExecaReturnValue',
+        base: 'object',
+        identify(v: any): v is ExecaReturnValue {
+          return (
+            v &&
+            typeof v === 'object' &&
+            typeof v.command === 'string' &&
+            typeof v.exitCode === 'number' &&
+            typeof v.stdout === 'string' &&
+            typeof v.stderr === 'string' &&
+            typeof v.failed === 'boolean'
+          );
+        },
+      })
+      .addAssertion(
+        '<ExecaReturnValue> [not] to have failed',
+        (expect: typeof unexpected, result: ExecaReturnValue) => {
+          expect(result.failed, '[not] to be true');
+        },
+      )
+      .addAssertion(
+        '<ExecaReturnValue> [not] to have succeeded',
+        (expect: typeof unexpected, result: ExecaReturnValue) => {
+          expect(result.failed, '[not] to be false');
+        },
+      )
+      .addAssertion(
+        '<ExecaReturnValue> to output valid JSON',
+        (expect: typeof unexpected, result: ExecaReturnValue) => {
+          expect(() => JSON.parse(result.stdout), 'not to throw');
+        },
+      )
+      .addAssertion(
+        '<ExecaReturnValue> to output <string>',
+        (expect: typeof unexpected, result: ExecaReturnValue, str: string) => {
+          expect(result.stdout, 'to equal', str);
+        },
+      );
+  },
+};
diff --git a/test/e2e/cli.spec.ts b/test/e2e/cli.spec.ts
index a0c1e3c1a..a391101f7 100644
--- a/test/e2e/cli.spec.ts
+++ b/test/e2e/cli.spec.ts
@@ -1,75 +1,158 @@
-import {node as execa, type NodeOptions} from 'execa';
-import {readFileSync} from 'node:fs';
+import fs from 'node:fs/promises';
 import path from 'node:path';
-import unexpected from 'unexpected';
 import snapshot from 'snap-shot-it';
+import unexpected from 'unexpected';
+import {readPackageJson} from '../../src/util';
+import assertions from '../assertions';
+import {dump, execSmoker} from './helpers';
+import {ExecaReturnValue} from 'execa';
 
-const {version} = JSON.parse(
-  readFileSync(require.resolve('../../package.json'), 'utf8'),
-);
-
-const expect = unexpected.clone();
-
-let CLI_PATH: string;
-let CWD: string;
+const expect = unexpected.clone().use(assertions);
 
-if (process.env.WALLABY_PROJECT_DIR) {
-  CLI_PATH = path.join(process.env.WALLABY_PROJECT_DIR, 'bin', 'smoker.js');
-  CWD = process.env.WALLABY_PROJECT_DIR;
-} else {
-  CLI_PATH = require.resolve('../../bin/smoker.js');
-  CWD = path.join(__dirname, '..', '..');
+function fixupStdout(stdout: string) {
+  return (
+    stdout
+      // strip the paths to npm/node in command
+      .replace(/(?:\S+?)(\/bin\/(node|npm)(?:\.exe|\.cmd)?)/g, '<path/to/>$1')
+      // strip the versions since it will change
+      .replace(/midnight-smoker@\d+\.\d+\.\d+/, 'midnight-smoker@<version>')
+      .replace(/--version\\n\\n\d+\.\d+\.\d+/, '--version\\n\\n<version>')
+      // strip the path to `cli.js` since it differs per platform
+      .replace(/node(\.exe)?\s+\S+?smoker\.js/, '<path/to/>smoker.js')
+      .replace(/"cwd":\s+"[^"]+"/, '"cwd": "<cwd>"')
+  );
 }
 
-async function run(args: string[], opts: NodeOptions = {}) {
-  const {stdout, stderr, exitCode} = await execa(CLI_PATH, args, {
-    cwd: CWD,
-    ...opts,
-    env: opts.env ? opts.env : {DEBUG: ''},
+describe('midnight-smoker CLI', function () {
+  let version: string;
+  let cwd: string;
+
+  before(async function () {
+    const {packageJson, path: packageJsonPath} = await readPackageJson({
+      cwd: __dirname,
+      strict: true,
+    });
+    version = packageJson.version!;
+    cwd = path.dirname(packageJsonPath);
   });
-  return {stdout, stderr, exitCode};
-}
 
-describe('midnight-smoker CLI', function () {
-  describe('--version', function () {
-    it('should print version and exit', async function () {
-      const actual = await run(['--version']);
-      expect(actual, 'to equal', {
-        stdout: version,
-        stderr: '',
-        exitCode: 0,
+  describe('flag', function () {
+    describe('--version', function () {
+      it('should print version and exit', async function () {
+        expect(await execSmoker(['--version'], {cwd}), 'to output', version);
       });
     });
-  });
 
-  it('should show help text', async function () {
-    snapshot(await run(['test:smoke', '--help']));
-  });
+    describe('--help', function () {
+      it('should show help text', async function () {
+        const {stdout, stderr, exitCode} = await execSmoker(['--help'], {cwd});
+        snapshot({stdout, stderr, exitCode});
+      });
+    });
 
-  it('should smoke test this and produce JSON output', async function () {
-    const {stdout, stderr, exitCode} = await execa(
-      CLI_PATH,
-      ['smoke', '--json'],
-      {
-        cwd: CWD,
-        env: {
-          DEBUG: '',
-        },
-      },
-    );
-    const result = {stdout, stderr, exitCode};
-    result.stdout = result.stdout
-      // strip the path to npm from the `command` & `escapedCommand` since it could differ depending where this is run
-      .replace(
-        /(?<="(escaped)?[cC]ommand":\s*?")(.+?)(?=\/bin\/npm)/g,
-        '<path/to>',
-      )
-      // strip the versions since it could change
-      .replace(/midnight-smoker@\d+\.\d+\.\d+/, 'midnight-smoker@<version>')
-      .replace(/--version\\n\\n\d+\.\d+\.\d+/, '--version\\n\\n<version>')
-      // strip the path to `cli.js` since it differs per platform
-      .replace(/node(\.cmd)?\s+.+?smoker\.js/, '<path/to/>smoker.js');
+    describe('when the test passes', function () {
+      it('should produce expected output', async function () {
+        const {stderr} = await execSmoker(['smoke:js'], {cwd});
+        snapshot(stderr);
+      });
+    });
+
+    describe('when the test fails', function () {
+      const cwd = path.join(__dirname, 'fixture', 'failure');
+
+      let result: ExecaReturnValue;
+
+      before(async function () {
+        try {
+          await execSmoker(['smoke'], {
+            cwd,
+          });
+        } catch (e) {
+          result = e as ExecaReturnValue;
+        }
+      });
 
-    snapshot(result);
+      it('should produce expected output', async function () {
+        snapshot(result.stderr);
+      });
+
+      it('should fail', async function () {
+        expect(result, 'to have failed');
+      });
+    });
+
+    describe('--json', function () {
+      describe('when the test passes', function () {
+        let result: ExecaReturnValue;
+
+        before(async function () {
+          result = await execSmoker(['smoke:js', '--json'], {cwd});
+        });
+
+        it('should produce JSON output', function () {
+          expect(result, 'to output valid JSON');
+        });
+
+        it('should produce expected output', async function () {
+          snapshot(fixupStdout(result.stdout));
+        });
+      });
+
+      describe('when the test fails', function () {
+        const cwd = path.join(__dirname, 'fixture', 'failure');
+
+        let result: ExecaReturnValue;
+
+        before(async function () {
+          try {
+            await execSmoker(['smoke', '--json'], {cwd});
+          } catch (e) {
+            result = e as ExecaReturnValue;
+          }
+        });
+
+        it('should fail', function () {
+          expect(result, 'to have failed');
+        });
+
+        it('should produce JSON output', async function () {
+          expect(result, 'to output valid JSON');
+        });
+
+        it('should provide helpful result', async function () {
+          snapshot(fixupStdout(result.stdout));
+        });
+      });
+    });
+
+    describe('--add', function () {
+      const cwd = path.join(__dirname, 'fixture', 'add');
+      let lingeringTempDir: string;
+
+      it('should add a package to the smoke test', async function () {
+        const {stderr, failed} = await execSmoker(
+          ['smoke', '--add=cross-env', '--linger'],
+          {
+            cwd,
+          },
+        );
+        const lines = stderr.trim().split(/\r?\n/);
+        lingeringTempDir = lines[lines.length - 1].trim();
+
+        expect(failed, 'to be false');
+        // this is probably brittle. could use something like `resolve-from`
+        // or even invoke `npm ls` or `npm exec` to check for its existence
+        await expect(
+          fs.stat(path.join(lingeringTempDir, 'node_modules', 'cross-env')),
+          'to be fulfilled',
+        );
+      });
+
+      after(async function () {
+        if (lingeringTempDir) {
+          await fs.rm(lingeringTempDir, {recursive: true, force: true});
+        }
+      });
+    });
   });
 });
diff --git a/test/e2e/fixture/add/package.json b/test/e2e/fixture/add/package.json
new file mode 100644
index 000000000..1ddcf2693
--- /dev/null
+++ b/test/e2e/fixture/add/package.json
@@ -0,0 +1,10 @@
+{
+  "name": "midnight-smoker-add-test",
+  "version": "1.0.0",
+  "devDependencies": {
+    "cross-env": "7.0.3"
+  },
+  "scripts": {
+    "smoke": "cross-env FOO=1 node ./smoke.js"
+  }
+}
diff --git a/test/e2e/fixture/add/smoke.js b/test/e2e/fixture/add/smoke.js
new file mode 100644
index 000000000..ca3979bfc
--- /dev/null
+++ b/test/e2e/fixture/add/smoke.js
@@ -0,0 +1,3 @@
+if (!process.env.FOO) {
+  throw new Error('FOO env var not set');
+}
diff --git a/test/e2e/fixture/failure/package.json b/test/e2e/fixture/failure/package.json
new file mode 100644
index 000000000..a5474dcc7
--- /dev/null
+++ b/test/e2e/fixture/failure/package.json
@@ -0,0 +1,7 @@
+{
+  "name": "fail",
+  "version": "1.0.0",
+  "scripts": {
+    "smoke": "exit 1"
+  }
+}
diff --git a/test/e2e/fixture/pick-package-version/dev-peer/package.json b/test/e2e/fixture/pick-package-version/dev-peer/package.json
new file mode 100644
index 000000000..1496cd23e
--- /dev/null
+++ b/test/e2e/fixture/pick-package-version/dev-peer/package.json
@@ -0,0 +1,8 @@
+{
+  "devDependencies": {
+    "mocha": "10.2.0"
+  },
+  "peerDependencies": {
+    "mocha": "^10.0.0"
+  }
+}
diff --git a/test/e2e/fixture/pick-package-version/optional-peer/package.json b/test/e2e/fixture/pick-package-version/optional-peer/package.json
new file mode 100644
index 000000000..e78e2838c
--- /dev/null
+++ b/test/e2e/fixture/pick-package-version/optional-peer/package.json
@@ -0,0 +1,8 @@
+{
+  "optionalDependencies": {
+    "mocha": "10.2.0"
+  },
+  "peerDependencies": {
+    "mocha": "^10.0.0"
+  }
+}
diff --git a/test/e2e/fixture/pick-package-version/peer/package.json b/test/e2e/fixture/pick-package-version/peer/package.json
new file mode 100644
index 000000000..483a2513d
--- /dev/null
+++ b/test/e2e/fixture/pick-package-version/peer/package.json
@@ -0,0 +1,5 @@
+{
+  "peerDependencies": {
+    "mocha": "^10.0.0"
+  }
+}
diff --git a/test/e2e/fixture/pick-package-version/prod-peer/package.json b/test/e2e/fixture/pick-package-version/prod-peer/package.json
new file mode 100644
index 000000000..018e12d46
--- /dev/null
+++ b/test/e2e/fixture/pick-package-version/prod-peer/package.json
@@ -0,0 +1,8 @@
+{
+  "dependencies": {
+    "mocha": "10.2.0"
+  },
+  "peerDependencies": {
+    "mocha": "^10.0.0"
+  }
+}
diff --git a/test/e2e/helpers.ts b/test/e2e/helpers.ts
new file mode 100644
index 000000000..29608328e
--- /dev/null
+++ b/test/e2e/helpers.ts
@@ -0,0 +1,35 @@
+/**
+ * E2E test harness helpers
+ * @module
+ */
+import {node as execa, type ExecaReturnValue, type NodeOptions} from 'execa';
+import path from 'node:path';
+import {inspect} from 'node:util';
+
+/**
+ * If running in Wallaby, we'll need this
+ */
+export const CWD = process.env.WALLABY_PROJECT_DIR
+  ? process.env.WALLABY_PROJECT_DIR
+  : path.resolve(__dirname, '..', '..');
+
+export const CLI_PATH = path.join(CWD, 'bin', 'smoker.js');
+
+export async function execSmoker(
+  args: string[],
+  opts: NodeOptions = {},
+): Promise<ExecaReturnValue> {
+  return execa(CLI_PATH, args, {
+    cwd: CWD,
+    env: {DEBUG: ''},
+    ...opts,
+  });
+}
+
+/**
+ * For debugging
+ * @param obj A thing to dump
+ */
+export function dump(obj: any): void {
+  console.error(inspect(obj, {depth: null, colors: true}));
+}
diff --git a/test/e2e/util.spec.ts b/test/e2e/util.spec.ts
new file mode 100644
index 000000000..1b5ecd9e9
--- /dev/null
+++ b/test/e2e/util.spec.ts
@@ -0,0 +1,87 @@
+import path from 'node:path';
+import unexpected from 'unexpected';
+import {pickPackageVersion} from '../../src/util';
+const expect = unexpected.clone();
+
+const FIXTURE_DIR = path.join(__dirname, 'fixture', 'pick-package-version');
+
+describe('midnight-smoker', function () {
+  describe('additional package version picker', function () {
+    describe('when provided a package name and spec', function () {
+      it('should return the package name and spec', async function () {
+        await expect(
+          pickPackageVersion('foo@1.0.0'),
+          'to be fulfilled with',
+          'foo@1.0.0',
+        );
+      });
+    });
+
+    describe('when provided a url to a git repo', function () {
+      it('should return the url', async function () {
+        await expect(
+          pickPackageVersion(
+            'https://github.com/boneskull/midnight-smoker.git',
+          ),
+          'to be fulfilled with',
+          'https://github.com/boneskull/midnight-smoker.git',
+        );
+      });
+    });
+
+    describe('when provided a package name w/o a spec', function () {
+      describe('when the package does not appear in the local package.json', function () {
+        it('should return the package name and "latest" tag', async function () {
+          await expect(
+            pickPackageVersion('foo'),
+            'to be fulfilled with',
+            'foo@latest',
+          );
+        });
+      });
+
+      describe('when the package appears in the local package.json in the "devDependencies" and "peerDependencies" fields', function () {
+        it('should return the package and spec from the "devDependencies" field', async function () {
+          await expect(
+            pickPackageVersion('mocha', path.join(FIXTURE_DIR, 'dev-peer')),
+            'to be fulfilled with',
+            'mocha@10.2.0',
+          );
+        });
+      });
+
+      describe('when the package appears in the local package.json in the "dependencies" and "peerDependencies" fields', function () {
+        it('should return the package and spec from the "dependencies" field', async function () {
+          await expect(
+            pickPackageVersion('mocha', path.join(FIXTURE_DIR, 'prod-peer')),
+            'to be fulfilled with',
+            'mocha@10.2.0',
+          );
+        });
+      });
+
+      describe('when the package appears in the local package.json in the "optionalDependencies" and "peerDependencies" fields', function () {
+        it('should return the package and spec from the "optionalDependencies" field', async function () {
+          await expect(
+            pickPackageVersion(
+              'mocha',
+              path.join(FIXTURE_DIR, 'optional-peer'),
+            ),
+            'to be fulfilled with',
+            'mocha@10.2.0',
+          );
+        });
+      });
+
+      describe('when the package appears in the local package.json in the "peerDependencies" field only', function () {
+        it('should return the package and spec from the "peerDependencies" field', async function () {
+          await expect(
+            pickPackageVersion('mocha', path.join(FIXTURE_DIR, 'peer')),
+            'to be fulfilled with',
+            'mocha@^10.0.0',
+          );
+        });
+      });
+    });
+  });
+});
diff --git a/test/unit/mocks.ts b/test/unit/mocks.ts
index b2de53228..80cb27ef9 100644
--- a/test/unit/mocks.ts
+++ b/test/unit/mocks.ts
@@ -118,6 +118,7 @@ export class NullPm implements MS.PackageManager {
         exitCode: 0,
         failed: false,
       },
+      cwd: '',
     };
   }
 }
diff --git a/test/unit/pm/npm.spec.ts b/test/unit/pm/npm.spec.ts
index 39aec2a88..446b8582f 100644
--- a/test/unit/pm/npm.spec.ts
+++ b/test/unit/pm/npm.spec.ts
@@ -75,46 +75,30 @@ describe('midnight-smoker', function () {
           });
         });
 
-        describe('method', function () {
-          let npm: NPM.Npm;
-
-          beforeEach(function () {
-            npm = new Npm();
-          });
-
+        describe('static method', function () {
           describe('getBinPath()', function () {
             beforeEach(function () {
               mocks.execa.node.resolves({exitCode: 0, stdout: '1.2.3'});
             });
 
-            describe('when the "path" option was provided to the constructor', function () {
-              beforeEach(function () {
-                npm = new Npm({binPath: MOCK_NPM_PATH});
-              });
-
-              it('should not look in the PATH for an executable', async function () {
-                await npm.getBinPath();
+            describe('when the "binPath" argument is provided', function () {
+              it('should not query the environment for the path', async function () {
+                await Npm.getBinPath(MOCK_NPM_PATH);
                 expect(mocks.which, 'was not called');
               });
 
               it('should resolve with the value of the "path" option', async function () {
                 await expect(
-                  npm.getBinPath(),
+                  Npm.getBinPath(MOCK_NPM_PATH),
                   'to be fulfilled with',
                   MOCK_NPM_PATH,
                 );
               });
             });
 
-            describe('when the "path" option was not provided to the constructor', function () {
-              let npm: NPM.Npm;
-
-              beforeEach(function () {
-                npm = new Npm();
-              });
-
+            describe('when the "binPath" option is not provided', function () {
               it('should look in the PATH for an executable', async function () {
-                await npm.getBinPath();
+                await Npm.getBinPath();
                 expect(mocks.which, 'to have a call satisfying', ['npm']);
               });
 
@@ -125,7 +109,7 @@ describe('midnight-smoker', function () {
 
                 it('should reject', async function () {
                   await expect(
-                    npm.getBinPath(),
+                    Npm.getBinPath(),
                     'to be rejected with',
                     /not found/,
                   );
@@ -135,48 +119,51 @@ describe('midnight-smoker', function () {
               describe('when the executable is found', function () {
                 it('should resolve with the path', async function () {
                   await expect(
-                    npm.getBinPath(),
+                    Npm.getBinPath(),
                     'to be fulfilled with',
                     MOCK_NPM_PATH,
                   );
                 });
-
-                describe('when called multiple times', function () {
-                  it('should cache the value', async function () {
-                    await npm.getBinPath();
-                    await npm.getBinPath();
-                    expect(mocks.which, 'was called once');
-                  });
-                });
               });
             });
           });
 
           describe('getVersion()', function () {
-            beforeEach(function () {
-              sandbox.stub(Npm.prototype, 'getBinPath').resolves(MOCK_NPM_PATH);
-            });
-
             it('should return a version number', function () {
-              expect(npm.getVersion(), 'to be fulfilled with', '9.8.1');
+              expect(
+                Npm.getVersion(MOCK_NPM_PATH),
+                'to be fulfilled with',
+                '9.8.1',
+              );
             });
 
             it('should execute "npm --version"', async function () {
-              await npm.getVersion();
+              await Npm.getVersion(MOCK_NPM_PATH);
               expect(mocks.execa.node, 'to have a call satisfying', [
                 MOCK_NPM_PATH,
                 ['--version'],
               ]);
             });
 
-            describe('when called multiple times', function () {
-              it('should cache the value', async function () {
-                await npm.getVersion();
-                await npm.getVersion();
-                expect(mocks.execa.node, 'was called once');
+            describe('when called without a "binPath" arg', function () {
+              it('should reject', async function () {
+                await expect(
+                  // @ts-expect-error invalid args
+                  Npm.getVersion(),
+                  'to be rejected with error satisfying',
+                  new TypeError('(getVersion) "binPath" arg is required'),
+                );
               });
             });
           });
+        });
+
+        describe('method', function () {
+          let npm: NPM.Npm;
+
+          beforeEach(function () {
+            npm = new Npm();
+          });
 
           describe('pack()', function () {
             const npmPackItems: NPM.NpmPackItem[] = [
@@ -480,7 +467,7 @@ describe('midnight-smoker', function () {
                   'to be fulfilled with value satisfying',
                   {
                     error: new SmokerError(
-                      '(runScript) npm failed to spawn: no such npm',
+                      '(runScript) Script "some-script" in package "foo" failed: no such npm',
                     ),
                   },
                 );
diff --git a/test/unit/smoker.spec.ts b/test/unit/smoker.spec.ts
index 5bf5fc6ac..047b5700d 100644
--- a/test/unit/smoker.spec.ts
+++ b/test/unit/smoker.spec.ts
@@ -559,6 +559,7 @@ describe('midnight-smoker', function () {
                     error: err,
                     script,
                     rawResult: {} as MS.RunScriptValue,
+                    cwd: '/some/path',
                   };
                 });
             });
@@ -652,53 +653,5 @@ describe('midnight-smoker', function () {
         });
       });
     });
-
-    // describe('static method', function () {
-    //   describe('smoke()', function () {
-    //     let globalStyleFlag: string;
-
-    //     beforeEach(async function () {
-    //       // const smoker = new Smoker('foo');
-    //       // const {version} = await smoker.findNpm();
-    //       // globalStyleFlag =
-    //       //   version.startsWith('7') || version.startsWith('8')
-    //       //     ? '--global-style'
-    //       //     : '--install-strategy=shallow';
-    //       // mocks.execa.resetHistory();
-    //       sandbox
-    //         .stub(Smoker, 'withNpm')
-    //         .callsFake((scripts: string[] | string, opts?: SmokerOptions) => {
-    //           return new Smoker(scripts, mockPm, opts);
-    //         });
-    //     });
-
-    //     it('should pack, install, and run scripts', async function () {
-    //       await smoke('foo');
-    //       expect(mocks.execa, 'to have calls satisfying', [
-    //         [MOCK_PM, ['--version']],
-    //         [
-    //           MOCK_PM,
-    //           [
-    //             'pack',
-    //             '--json',
-    //             `--pack-destination=${MOCK_TMPDIR}`,
-    //             '--foreground-scripts=false',
-    //           ],
-    //           {},
-    //         ],
-    //         [
-    //           MOCK_PM,
-    //           ['install', globalStyleFlag, `${MOCK_TMPDIR}/tarball.tgz`],
-    //           {cwd: MOCK_TMPDIR},
-    //         ],
-    //         [
-    //           MOCK_PM,
-    //           ['run-script', 'foo'],
-    //           {cwd: `${MOCK_TMPDIR}/node_modules/bar`},
-    //         ],
-    //       ]);
-    //     });
-    //   });
-    // });
   });
 });
diff --git a/test/unit/util.spec.ts b/test/unit/util.spec.ts
new file mode 100644
index 000000000..75f8e5ad7
--- /dev/null
+++ b/test/unit/util.spec.ts
@@ -0,0 +1,144 @@
+import rewiremock from 'rewiremock/node';
+import unexpected from 'unexpected';
+import sinon from 'sinon';
+import type * as _Util from '../../src/util';
+
+const expect = unexpected.clone();
+
+describe('midnight-smoker', function () {
+  let Util: typeof _Util;
+  let pickPackageVersion: typeof _Util.pickPackageVersion;
+  let readPkgUpStub: sinon.SinonStub;
+
+  beforeEach(function () {
+    readPkgUpStub = sinon.stub().resolves({
+      packageJson: {
+        devDependencies: {
+          mocha: '10.2.0',
+        },
+        dependencies: {
+          mocha: '10.0.0',
+        },
+        optionalDependencies: {
+          mocha: '10.1.0',
+        },
+        peerDependencies: {mocha: '^10.0.0'},
+      },
+    });
+    Util = rewiremock.proxy(() => require('../../src/util'), {
+      'read-pkg-up': readPkgUpStub,
+    });
+    ({pickPackageVersion} = Util);
+  });
+
+  describe('util', function () {
+    describe('pickPackageVersion()', function () {
+      describe('when provided a package name and spec', function () {
+        it('should return the package name and spec', async function () {
+          await expect(
+            pickPackageVersion('foo@1.0.0'),
+            'to be fulfilled with',
+            'foo@1.0.0',
+          );
+        });
+      });
+
+      describe('when provided a url to a git repo', function () {
+        it('should return the url', async function () {
+          await expect(
+            pickPackageVersion(
+              'https://github.com/boneskull/midnight-smoker.git',
+            ),
+            'to be fulfilled with',
+            'https://github.com/boneskull/midnight-smoker.git',
+          );
+        });
+      });
+
+      describe('when provided a package name w/o a spec', function () {
+        describe('when the package does not appear in the local package.json', function () {
+          it('should return the package name and "latest" tag', async function () {
+            await expect(
+              pickPackageVersion('foo'),
+              'to be fulfilled with',
+              'foo@latest',
+            );
+          });
+        });
+
+        describe('when the package appears in the local package.json in the "devDependencies" and "peerDependencies" fields', function () {
+          it('should return the package and spec from the "devDependencies" field', async function () {
+            await expect(
+              pickPackageVersion('mocha'),
+              'to be fulfilled with',
+              'mocha@10.2.0',
+            );
+          });
+        });
+
+        describe('when the package appears in the local package.json in the "dependencies" and "peerDependencies" fields', function () {
+          beforeEach(function () {
+            readPkgUpStub.resolves({
+              packageJson: {
+                dependencies: {
+                  mocha: '10.0.0',
+                },
+                optionalDependencies: {
+                  mocha: '10.1.0',
+                },
+                peerDependencies: {mocha: '^10.0.0'},
+              },
+            });
+          });
+
+          it('should return the package and spec from the "dependencies" field', async function () {
+            await expect(
+              pickPackageVersion('mocha'),
+              'to be fulfilled with',
+              'mocha@10.0.0',
+            );
+          });
+        });
+
+        describe('when the package appears in the local package.json in the "optionalDependencies" and "peerDependencies" fields', function () {
+          beforeEach(function () {
+            readPkgUpStub.resolves({
+              packageJson: {
+                optionalDependencies: {
+                  mocha: '10.1.0',
+                },
+                peerDependencies: {mocha: '^10.0.0'},
+              },
+            });
+          });
+
+          it('should return the package and spec from the "optionalDependencies" field', async function () {
+            await expect(
+              pickPackageVersion('mocha'),
+              'to be fulfilled with',
+              'mocha@10.1.0',
+            );
+          });
+        });
+
+        describe('when the package appears in the local package.json in the "peerDependencies" field only', function () {
+          beforeEach(function () {
+            readPkgUpStub.resolves({
+              packageJson: {
+                peerDependencies: {mocha: '^10.0.0'},
+              },
+            });
+          });
+
+          it('should return the package and spec from the "peerDependencies" field', async function () {
+            await expect(
+              pickPackageVersion('mocha'),
+              'to be fulfilled with',
+              'mocha@^10.0.0',
+            );
+          });
+        });
+      });
+    });
+  });
+});