fix(cli): make the scan command npx compatible

README.md

@@ -17,10 +17,10 @@ npm i
 
 ### Running a local scan
 
-To run a scan on a host, a command line script `scan` is available. It returns the a JSON of the form described below. For example, to scan `mdn.dev`:
+To run a scan on a host, a command line script is available. It returns the a JSON of the form described below. For example, to scan `mdn.dev`:
 
 ```sh
-./scan mdn.dev
+npx mdn-http-observatory-scan mdn.dev
 
 {
   "scan": {
@@ -47,9 +47,10 @@ To run a scan on a host, a command line script `scan` is available. It returns t
     ...
   }
 }
-
 ```
 
+To install the CLI script globally on your machine, run `npm install -g .` from the project root. `mdn-http-observatory-scan` is then available in your shell.
+
 ### Running a local API server
 
 This needs a [postgres](https://www.postgresql.org/) database for the API to use as a persistence layer. All scans and results initiated via the API are stored in the database.

src/cli/index.js → bin/scan.js

@@ -1,16 +1,16 @@
+#!/usr/bin/env node
+
 import { Command } from "commander";
-import { scan } from "../scanner/index.js";
-const program = new Command();
+import { scan } from "../src/scanner/index.js";
 
-program
-  .name("observatory")
-  .description("CLI for the MDN HTTP Observatory")
-  .version("1.0.0");
+const name = "mdn-http-observatory-scan";
+const program = new Command();
 
 program
-  .command("scan")
-  .description("Scan a host")
-  .argument("<string>", "hostname to scan")
+  .name(name)
+  .description("CLI for the MDN HTTP Observatory scan functionality")
+  .version("1.0.0")
+  .argument("<hostname>", "hostname to scan")
   .action(async (hostname, _options) => {
     try {
       const result = await scan(hostname);