@pagopa/dx-cli 0.24.0 → 0.25.1

package/README.md

@@ -66,6 +66,20 @@ npm run build
 node ./apps/cli/bin/index.js --help
 ```
 
+## 🔐 Authentication
+
+The CLI requires GitHub authentication for every command **except** `--version`
+and `--help`. Authenticate using one of the following (checked in this order):
+
+1. The `GH_TOKEN` environment variable
+2. The `GITHUB_TOKEN` environment variable
+3. The [GitHub CLI](https://cli.github.com/) — run `gh auth login`
+
+If no credential is found, the CLI exits with an error asking you to log in.
+
+> Telemetry is emitted only for members of the `pagopa` GitHub organization;
+> all other users can use the CLI normally with telemetry disabled.
+
 ## 🛠️ Usage
 
 ### Available Commands

package/bin/index.js

@@ -1,6 +1,16 @@
 #!/usr/bin/env node
 
-import { runCli } from "../dist/index.js";
-import packageJson from "../package.json" with { type: "json" };
+// The instrumentation module must be loaded first so that the OpenTelemetry
+// module hook (import-in-the-middle) is registered before any of the CLI's
+// modules are imported. Static imports are always hoisted before code runs, so
+// sequential dynamic imports are the only way to guarantee this load order.
+await import("../dist/adapters/azure-monitor/instrumentation.js");
 
-runCli(packageJson.version).catch((error) => console.error(error.message));
+const { runCli } = await import("../dist/index.js");
+const { default: packageJson } = await import("../package.json", {
+  with: { type: "json" },
+});
+
+await runCli(packageJson.version).catch((error) =>
+  console.error(error.message),
+);