@pagopa/dx-cli 0.22.4 → 0.23.0

package/dist/domain/spec.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Spec Domain
+ *
+ * Pure types that describe the shape of the CLI spec output.
+ * Technology-agnostic: no dependency on Commander or any CLI framework.
+ * Consumed by the Commander adapter and by agent tooling that parses `dx spec`.
+ */
+export type ArgumentSpec = {
+    /** Allowed values when the argument is constrained to a set */
+    choices: string[];
+    defaultValue: unknown;
+    description: string;
+    name: string;
+    required: boolean;
+    variadic: boolean;
+};
+export type CliSpec = {
+    /** Top-level subcommands with their own options, arguments, and nested commands. */
+    commands: CommandSpec[];
+    description: string;
+    /** Options defined directly on the root `dx` program (global flags). */
+    globalOptions: OptionSpec[];
+    name: string;
+    /** Stable version of the spec JSON shape. Increment on breaking changes. */
+    specVersion: "1";
+    version: string;
+};
+export type CommandSpec = {
+    arguments: ArgumentSpec[];
+    commands: CommandSpec[];
+    description: string;
+    name: string;
+    options: OptionSpec[];
+};
+export type OptionSpec = {
+    /** Allowed values when the option is an enum */
+    choices: string[];
+    defaultValue: unknown;
+    description: string;
+    /** Raw flags string as shown in help, e.g. "-v, --verbose" */
+    flags: string;
+    /** Long flag, e.g. "--verbose" */
+    long: string | undefined;
+    /** True when the option value is optional (e.g. `--output [mode]`) */
+    optional: boolean;
+    /** True when the option value is mandatory (e.g. `--output <mode>`) */
+    required: boolean;
+    /** Short flag, e.g. "-v" (undefined when not present) */
+    short: string | undefined;
+};

package/dist/domain/spec.js

@@ -0,0 +1,8 @@
+/**
+ * Spec Domain
+ *
+ * Pure types that describe the shape of the CLI spec output.
+ * Technology-agnostic: no dependency on Commander or any CLI framework.
+ * Consumed by the Commander adapter and by agent tooling that parses `dx spec`.
+ */
+export {};

package/dist/index.js

@@ -1,6 +1,6 @@
 import "core-js/actual/set/index.js";
 import { configure, getConsoleSink } from "@logtape/logtape";
-import * as assert from "node:assert/strict";
+import { errAsync, okAsync, ResultAsync } from "neverthrow";
 import { Octokit } from "octokit";
 import codemodRegistry from "./adapters/codemods/index.js";
 import { makeCli } from "./adapters/commander/index.js";
@@ -13,7 +13,6 @@ import { getConfig } from "./config.js";
 import { getInfo } from "./domain/info.js";
 import { applyCodemodById } from "./use-cases/apply-codemod.js";
 import { listCodemods } from "./use-cases/list-codemods.js";
-import { requestAuthorization } from "./use-cases/request-authorization.js";
 /**
  * Returns `true` when `-v` or `--verbose` is present in argv.
  *
@@ -50,29 +49,33 @@ const configureLogging = async (verbose) => {
 };
 export const runCli = async (version) => {
     await configureLogging(detectVerboseFromArgv(process.argv));
-    // Creating the adapters
     const repositoryReader = makeRepositoryReader();
     const packageJsonReader = makePackageJsonReader();
     const validationReporter = makeValidationReporter();
-    const auth = await getGitHubPAT();
-    assert.ok(auth, "GitHub PAT is required. Please set the GH_TOKEN environment variable or login using GitHub CLI.");
-    const octokit = new Octokit({
-        auth,
+    /**
+     * Lazily creates GitHub-authenticated services on first call.
+     * Only commands that actually need GitHub (init, add) will trigger this,
+     * so credential-free commands (spec, doctor, info, …) never require a PAT.
+     */
+    const requireGitHubAuth = () => ResultAsync.fromPromise(getGitHubPAT(), (cause) => new Error("Failed to read GitHub PAT", { cause })).andThen((auth) => {
+        if (!auth) {
+            return errAsync(new Error("GitHub PAT is required. Please set the GH_TOKEN environment variable or login using GitHub CLI."));
+        }
+        const octokit = new Octokit({ auth });
+        const gitHubService = new OctokitGitHubService(octokit);
+        const authorizationService = makeAzureAuthorizationService(gitHubService);
+        return okAsync({ authorizationService, gitHubService });
     });
-    const gitHubService = new OctokitGitHubService(octokit);
-    const authorizationService = makeAzureAuthorizationService(gitHubService);
     const deps = {
-        authorizationService,
-        gitHubService,
         packageJsonReader,
         repositoryReader,
+        requireGitHubAuth,
         validationReporter,
     };
     const config = getConfig();
     const useCases = {
         applyCodemodById: applyCodemodById(codemodRegistry, getInfo(deps)),
         listCodemods: listCodemods(codemodRegistry),
-        requestAuthorization: requestAuthorization(authorizationService),
     };
     const program = makeCli(deps, config, useCases, version);
     program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagopa/dx-cli",
-  "version": "0.22.4",
+  "version": "0.23.0",
   "type": "module",
   "description": "A CLI useful to manage DX tools.",
   "repository": {
@@ -48,7 +48,7 @@
     "semver": "^7.7.4",
     "yaml": "^2.8.4",
     "zod": "^4.4.2",
-    "@pagopa/dx-savemoney": "^0.2.6"
+    "@pagopa/dx-savemoney": "^0.3.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "24.0.4",