@versu/cli 0.11.0 → 0.13.0

package/README.md

@@ -8,6 +8,8 @@
 
 Command-line interface for Versu. This CLI provides all the power of Versu's semantic versioning engine through an easy-to-use command-line tool, perfect for local development and custom CI/CD systems.
 
+For comprehensive documentation, examples, and configuration options, please refer to the our website <https://versuhq.github.io/>.
+
 ## Installation
 
 ### Global Installation
@@ -25,7 +27,7 @@ npm install --save-dev @versu/cli
 ### Using npx (no installation)
 
 ```bash
-px @versu/cli
+npx @versu/cli run
 ```
 
 ## Usage
@@ -35,7 +37,7 @@ px @versu/cli
 Navigate to your project root and run:
 
 ```bash
-versu
+versu run
 ```
 
 This will:
@@ -53,13 +55,13 @@ This will:
 Preview what would happen without making changes:
 
 ```bash
-versu --dry-run
+versu run --dry-run
 ```
 
 ### Specify Project Root
 
 ```bash
-versu /path/to/project
+versu run /path/to/project
 ```
 
 ### Specify Adapter
@@ -67,39 +69,38 @@ versu /path/to/project
 If auto-detection fails or you want to be explicit:
 
 ```bash
-versu --adapter gradle
+versu run --adapter gradle
 ```
 
 ## Command Reference
 
-### `versu [REPOSITORYROOT]`
+### `versu run <repositoryRoot> [options]`
 
 Calculate and apply semantic version changes.
 
 **Arguments:**
 
-- `REPOSITORYROOT` - Path to the repository root (default: `.`)
+- `<repositoryRoot>` - Path to the repository root (default: `.`)
 
 **Flags:**
 
 | Flag | Description | Default |
 | ------ | ------------- | --------- |
-| `--dry-run` | Run without writing or pushing changes | `false` |
-| `--adapter <value>` | Language adapter (e.g., gradle). Auto-detected if not provided | - |
-| `--push-tags` | Push tags to origin | `true` |
-| `--no-push-tags` | Don't push tags to origin | - |
 | `--prerelease-mode` | Generate pre-release versions instead of final versions | `false` |
 | `--prerelease-id <value>` | Pre-release identifier (e.g., alpha, beta, rc) | `alpha` |
 | `--bump-unchanged` | In prerelease mode, bump modules even when no changes are detected | `false` |
 | `--add-build-metadata` | Add build metadata with short SHA to all versions | `false` |
 | `--timestamp-versions` | Use timestamp-based prerelease identifiers (requires prerelease-mode) | `false` |
 | `--append-snapshot` | Add -SNAPSHOT suffix to all versions if supported by adapter | `false` |
-| `--push-changes` | Commit and push version changes and changelogs to remote | `true` |
-| `--no-push-changes` | Don't commit and push changes | - |
+| `--create-tags` | Create git tags for new versions | `true` |
 | `--generate-changelog` | Generate or update changelog files for changed modules | `true` |
-| `--no-generate-changelog` | Don't generate changelogs | - |
-
-> 📖 **Detailed Pre-release Documentation**: See [@versu/core PRERELEASE.md](../core/PRERELEASE.md) for comprehensive examples and use cases.
+| `--push-changes` | Commit and push version changes and changelogs to remote | `true` |
+| `--dry-run` | Run without writing or pushing changes | `false` |
+| `--adapter <value>` | Language adapter (e.g., gradle). Auto-detected if not provided | - |
+| `--changelog-filename <value>` | Filename for generated changelog | `CHANGELOG.md` |
+| `--release-notes-filename <value>` | Filename for generated release notes | `RELEASE.md` |
+| `--from-ref <value>` | Git ref to compare from (e.g., previous tag or commit SHA) | - |
+| `--provider <value>` | Version control provider (e.g., github, gitlab) | - |
 
 ## Examples
 
@@ -108,7 +109,7 @@ Calculate and apply semantic version changes.
 Apply semantic versions based on commits:
 
 ```bash
-versu
+versu run
 ```
 
 ### Pre-release Versions
@@ -116,7 +117,7 @@ versu
 Generate beta pre-release versions:
 
 ```bash
-versu --prerelease-mode --prerelease-id beta
+versu run --prerelease-mode --prerelease-id beta
 ```
 
 ### Timestamp Versions
@@ -124,7 +125,7 @@ versu --prerelease-mode --prerelease-id beta
 Generate timestamp-based pre-release versions for CI builds:
 
 ```bash
-versu --prerelease-mode --prerelease-id alpha --timestamp-versions --add-build-metadata
+versu run --prerelease-mode --prerelease-id alpha --timestamp-versions --add-build-metadata
 ```
 
 This generates versions like: `1.2.3-alpha.20251208.1530+abc1234`
@@ -134,7 +135,7 @@ This generates versions like: `1.2.3-alpha.20251208.1530+abc1234`
 Generate Gradle SNAPSHOT versions:
 
 ```bash
-versu --append-snapshot
+versu run --append-snapshot
 ```
 
 ### Development Workflow
@@ -142,7 +143,7 @@ versu --append-snapshot
 Bump all modules (even unchanged) for development:
 
 ```bash
-versu --prerelease-mode --bump-unchanged
+versu run --prerelease-mode --bump-unchanged
 ```
 
 ### Local Testing
@@ -150,7 +151,7 @@ versu --prerelease-mode --bump-unchanged
 Test without committing or pushing:
 
 ```bash
-versu --dry-run --no-push-changes --no-push-tags
+versu run --dry-run --no-push-changes --no-push-tags
 ```
 
 ### Manual Git Operations
@@ -158,7 +159,7 @@ versu --dry-run --no-push-changes --no-push-tags
 Calculate versions without automatic git operations:
 
 ```bash
-versu --no-push-changes --no-push-tags
+versu run --no-push-changes --no-push-tags
 ```
 
 Then manually review, commit, and push.
@@ -167,14 +168,7 @@ Then manually review, commit, and push.
 
 Versu CLI uses the same configuration system as the core library. Configuration files are automatically detected in your repository root.
 
-### Supported Configuration Files
-
-1. `package.json` (in a `"versu"` property)
-2. `.versurc` (JSON or YAML)
-3. `.versurc.json`
-4. `.versurc.yaml` / `.versurc.yml`
-5. `.versurc.js` (JavaScript)
-6. `versu.config.js` (JavaScript)
+You can provide configuration in any of the supported config files (e.g., `.versurc`, `versu.config.js`, etc.) or via `package.json` under the `versu` key. For the full list please refer to [cosmiconfig search places documentation](https://github.com/cosmiconfig/cosmiconfig?tab=readme-ov-file#searchplaces).
 
 ### Configuration Example
 
@@ -182,32 +176,47 @@ Versu CLI uses the same configuration system as the core library. Configuration
 
 ```json
 {
-  "versionRules": {
-    "defaultBump": "patch",
-    "commitTypeBumps": {
-      "feat": "minor",
-      "fix": "patch",
-      "perf": "patch",
-      "refactor": "patch",
-      "docs": "ignore",
-      "test": "ignore",
-      "chore": "ignore"
+  "versioning": {
+    "breakingChange": {
+      "stable": "major",
+      "prerelease": "premajor"
+    },
+    "unknownCommitType": {
+      "stable": "patch",
+      "prerelease": "prepatch"
+    },
+    "commitTypes": {
+      "feat": {
+        "stable": "minor",
+        "prerelease": "preminor"
+      },
+      "fix": {
+        "stable": "patch",
+        "prerelease": "prepatch"
+      }
     },
-    "dependencyBumps": {
-      "major": "major",
-      "minor": "minor",
-      "patch": "patch"
+    "cascadeRules": {
+      "stable": {
+        "major": "major",
+        "minor": "minor",
+        "patch": "patch"
+      },
+      "prerelease": {
+        "major": "premajor",
+        "minor": "preminor",
+        "patch": "prepatch"
+      }
     }
   },
   "changelog": {
     "root": {
       "context": {
-        "prependPlaceholder": "<!-- CHANGELOG -->"
+        "prependPlaceholder": "<!-- Next Version Placeholder -->"
       }
     },
     "module": {
       "context": {
-        "prependPlaceholder": "<!-- CHANGELOG -->"
+        "prependPlaceholder": "<!-- Next Version Placeholder -->"
       }
     }
   }
@@ -223,7 +232,7 @@ Versu supports [conventional-changelog-writer](https://github.com/conventional-c
 ```javascript
 // versu.config.js
 module.exports = {
-  versionRules: {
+  versioning: {
     // ... version rules
   },
   changelog: {
@@ -236,7 +245,8 @@ module.exports = {
         },
         transform: (commit, context) => {
           // Custom commit transformation
-          return commit;
+          const commitPatch = {};
+          return commitPatch;
         }
       }
     }
@@ -246,38 +256,7 @@ module.exports = {
 
 ## Gradle Project Support
 
-Gradle support is provided by the **[@versu/plugin-gradle][plugin-gradle]** package.
-
-The CLI supports Gradle projects with:
-
-- **Multi-module projects** via `settings.gradle(.kts)`
-- **Version management** through root `gradle.properties` file
-- **Dependency detection** via custom Gradle init script
-- **Both DSLs**: Groovy and Kotlin
-
-### Example Project Structure
-
-```text
-myproject/
-├── settings.gradle.kts
-├── build.gradle.kts
-├── gradle.properties      # All module versions defined here
-├── core/
-│   └── build.gradle.kts
-└── api/
-    └── build.gradle.kts
-```
-
-### Example `gradle.properties`
-
-```properties
-# Root module version
-version=1.0.0
-
-# Submodule versions
-core.version=2.1.0
-api.version=1.5.0
-```
+Gradle support is provided by the **[@versu/plugin-gradle][plugin-gradle]** package. For more details please refer to the [plugin documentation][plugin-gradle].
 
 ## Commit Message Format
 
@@ -356,8 +335,8 @@ Add to your `package.json`:
 ```json
 {
   "scripts": {
-    "version": "versu --dry-run",
-    "version:release": "versu"
+    "version": "versu run --dry-run",
+    "version:release": "versu run"
   }
 }
 ```
@@ -423,7 +402,7 @@ npm run build
 
 ```bash
 # After building
-node dist/index.js --dry-run
+bin/dev.js --dry-run
 ```
 
 ### Publishing

package/dist/commands/run.d.ts

@@ -17,11 +17,14 @@ export default class Run extends Command {
         "append-snapshot": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "create-tags": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "generate-changelog": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "generate-release-notes": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "push-changes": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "dry-run": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         adapter: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "changelog-filename": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         "release-notes-filename": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "from-ref": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        provider: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAInD,MAAM,CAAC,OAAO,OAAO,GAAI,SAAQ,OAAO;IACtC,OAAgB,WAAW,SAAkD;IAE7E,OAAgB,QAAQ,WAKtB;IAEF,MAAM,CAAC,IAAI;;;;MAMT;IAEF,OAAgB,KAAK;;;;;;;;;;;;;;;MA6DnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+B3B"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAInD,MAAM,CAAC,OAAO,OAAO,GAAI,SAAQ,OAAO;IACtC,OAAgB,WAAW,SAAkD;IAE7E,OAAgB,QAAQ,WAKtB;IAEF,MAAM,CAAC,IAAI;;;;MAMT;IAEF,OAAgB,KAAK;;;;;;;;;;;;;;;;;;MA2EnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkC3B"}

package/dist/commands/run.js

@@ -52,6 +52,11 @@ export default class Run extends Command {
             default: true,
             allowNo: true,
         }),
+        "generate-release-notes": Flags.boolean({
+            description: "Generate release notes summarizing all changes",
+            default: true,
+            allowNo: true,
+        }),
         "push-changes": Flags.boolean({
             description: "Commit and push version changes and changelogs to remote",
             default: true,
@@ -73,6 +78,14 @@ export default class Run extends Command {
             description: "Filename for generated release notes (default: RELEASE.md)",
             default: "RELEASE.md",
         }),
+        "from-ref": Flags.string({
+            description: "Git reference to compare from (e.g., previous tag or commit SHA)",
+            required: false,
+        }),
+        provider: Flags.string({
+            description: "Version control provider (e.g., github, gitlab)",
+            required: false,
+        }),
     };
     async run() {
         const { flags, args } = await this.parse(Run);
@@ -88,11 +101,14 @@ export default class Run extends Command {
                 appendSnapshot: flags["append-snapshot"],
                 createTags: flags["create-tags"],
                 generateChangelog: flags["generate-changelog"],
+                generateReleaseNotes: flags["generate-release-notes"],
                 pushChanges: flags["push-changes"],
                 adapter: flags.adapter,
                 dryRun: flags["dry-run"],
                 changelogFilename: flags["changelog-filename"],
                 releaseNotesFilename: flags["release-notes-filename"],
+                fromRef: flags["from-ref"],
+                provider: flags["provider"],
             };
             const runner = new VersuRunner(options);
             await runner.run();

package/dist/commands/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -1,8 +1,14 @@
 import { Command } from "@oclif/core";
 import type { Logger } from "@versu/core";
 /**
- * CLI Logger implementation with beautiful formatting using chalk and ora
- * Implements the core Logger interface for presentation in the CLI
+ * A {@link Logger}-compatible class that renders structured log output to
+ * the terminal using chalk for colours and ora for animated spinners.
+ * Context objects are automatically formatted either inline (short, flat payloads)
+ * or as indented multi-line / bulleted lists (complex or array-valued payloads).
+ *
+ * Debug output is routed through the `debug` package under the `"versu"`
+ * namespace and is only visible when the `DEBUG` environment variable includes
+ * `"versu"` (e.g. `DEBUG=versu versu <command>`).
  */
 export declare class OclifLogger implements Logger {
     private readonly cmd;
@@ -10,17 +16,50 @@ export declare class OclifLogger implements Logger {
     private spinner;
     private groupDepth;
     constructor(cmd: Command, context?: Record<string, unknown>);
+    /**
+     * Emits a debug-level message via the `debug` package.
+     * Only visible when `DEBUG=versu` (or a matching glob) is set in the environment.
+     */
     debug(message: string, context?: Record<string, unknown>): void;
     /**
      * Helper method to handle spinner-aware logging with consistent formatting
      */
     private logWithSpinner;
+    /** Logs an informational message with a blue `ℹ` icon. */
     info(message: string, context?: Record<string, unknown>): void;
+    /** Logs a warning with a yellow `⚠` icon via oclif's `warn`. */
     warning(message: string | Error, context?: Record<string, unknown>): void;
+    /**
+     * Logs an error with a red `✖` icon via oclif's `error`.
+     * Any active spinner is failed and cleared before the message is printed.
+     */
     error(message: string | Error, context?: Record<string, unknown>): void;
+    /**
+     * Returns a new `OclifLogger` that merges `context` into every subsequent
+     * log call, useful for attaching a shared set of fields (e.g. a request ID)
+     * to a sub-flow without polluting the parent logger.
+     */
     child(context: Record<string, unknown>): Logger;
+    /**
+     * Prints a bold cyan group header and increases the indentation depth.
+     * Any active spinner is finished (succeeded) before the header is printed.
+     * Pair with {@link endGroup} or prefer the auto-closing {@link group}.
+     */
     startGroup(name: string): void;
+    /**
+     * Runs `fn` inside a named log group with an animated spinner.
+     *
+     * - Prints the group header via {@link startGroup}.
+     * - Starts an ora spinner for the duration of `fn`.
+     * - On success: marks the spinner as succeeded with "Complete".
+     * - On failure: marks the spinner as failed with "Failed", then re-throws.
+     * - Always calls {@link endGroup} in the `finally` block.
+     */
     group<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Decreases the indentation depth and cleans up any lingering spinner
+     * once the depth returns to zero.
+     */
     endGroup(): void;
 }
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiH1C;;;GAGG;AACH,qBAAa,WAAY,YAAW,MAAM;IAKtC,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,UAAU,CAAK;gBAGJ,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAGxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAU9D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUzE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWvE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAI/C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWxB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6B9D,QAAQ,IAAI,IAAI;CAWjB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAsH1C;;;;;;;;;GASG;AACH,qBAAa,WAAY,YAAW,MAAM;IAKtC,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,UAAU,CAAK;gBAGJ,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAGxD;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB,0DAA0D;IAC1D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAU9D,gEAAgE;IAChE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUzE;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWvE;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAI/C;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW9B;;;;;;;;OAQG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6B9D;;;OAGG;IACH,QAAQ,IAAI,IAAI;CAWjB"}

package/dist/logger.js

@@ -2,10 +2,15 @@ import Debug from "debug";
 import chalk from "chalk";
 import ora from "ora";
 const debug = Debug("versu");
+/** Prepends `spaces` space characters to `str`. */
 function indent(str, spaces) {
     const indentation = " ".repeat(spaces);
     return indentation + str;
 }
+/**
+ * Converts a single context value to a display string.
+ * Objects and arrays are JSON-serialised; primitives use `String()`.
+ */
 function formatElement(element) {
     if (typeof element === "object" && element !== null) {
         return JSON.stringify(element);
@@ -77,8 +82,14 @@ function formatMessage(message, context, baseIndent = 0) {
     return `${result}${contextString}`;
 }
 /**
- * CLI Logger implementation with beautiful formatting using chalk and ora
- * Implements the core Logger interface for presentation in the CLI
+ * A {@link Logger}-compatible class that renders structured log output to
+ * the terminal using chalk for colours and ora for animated spinners.
+ * Context objects are automatically formatted either inline (short, flat payloads)
+ * or as indented multi-line / bulleted lists (complex or array-valued payloads).
+ *
+ * Debug output is routed through the `debug` package under the `"versu"`
+ * namespace and is only visible when the `DEBUG` environment variable includes
+ * `"versu"` (e.g. `DEBUG=versu versu <command>`).
  */
 export class OclifLogger {
     cmd;
@@ -89,6 +100,10 @@ export class OclifLogger {
         this.cmd = cmd;
         this.context = context;
     }
+    /**
+     * Emits a debug-level message via the `debug` package.
+     * Only visible when `DEBUG=versu` (or a matching glob) is set in the environment.
+     */
     debug(message, context) {
         const baseIndent = this.groupDepth * 2;
         debug(formatMessage(message, { ...this.context, ...context }, baseIndent));
@@ -114,18 +129,34 @@ export class OclifLogger {
             this.spinner.start();
         }
     }
+    /** Logs an informational message with a blue `ℹ` icon. */
     info(message, context) {
         this.logWithSpinner((msg) => this.cmd.log(msg), "ℹ", chalk.blue, message, context);
     }
+    /** Logs a warning with a yellow `⚠` icon via oclif's `warn`. */
     warning(message, context) {
         this.logWithSpinner((msg) => this.cmd.warn(msg), "⚠", chalk.yellow, message, context);
     }
+    /**
+     * Logs an error with a red `✖` icon via oclif's `error`.
+     * Any active spinner is failed and cleared before the message is printed.
+     */
     error(message, context) {
         this.logWithSpinner((msg) => this.cmd.error(msg), "✖", chalk.red, message, context, true);
     }
+    /**
+     * Returns a new `OclifLogger` that merges `context` into every subsequent
+     * log call, useful for attaching a shared set of fields (e.g. a request ID)
+     * to a sub-flow without polluting the parent logger.
+     */
     child(context) {
         return new OclifLogger(this.cmd, { ...this.context, ...context });
     }
+    /**
+     * Prints a bold cyan group header and increases the indentation depth.
+     * Any active spinner is finished (succeeded) before the header is printed.
+     * Pair with {@link endGroup} or prefer the auto-closing {@link group}.
+     */
     startGroup(name) {
         // Stop any active spinner before starting a group
         if (this.spinner) {
@@ -135,6 +166,15 @@ export class OclifLogger {
         this.cmd.log(indent(chalk.bold.cyan(name), this.groupDepth));
         this.groupDepth++;
     }
+    /**
+     * Runs `fn` inside a named log group with an animated spinner.
+     *
+     * - Prints the group header via {@link startGroup}.
+     * - Starts an ora spinner for the duration of `fn`.
+     * - On success: marks the spinner as succeeded with "Complete".
+     * - On failure: marks the spinner as failed with "Failed", then re-throws.
+     * - Always calls {@link endGroup} in the `finally` block.
+     */
     async group(name, fn) {
         this.startGroup(name);
         try {
@@ -162,6 +202,10 @@ export class OclifLogger {
             this.endGroup();
         }
     }
+    /**
+     * Decreases the indentation depth and cleans up any lingering spinner
+     * once the depth returns to zero.
+     */
     endGroup() {
         if (this.groupDepth > 0) {
             this.groupDepth--;

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAY,MAAM,KAAK,CAAC;AAE/B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAE7B,mDAAmD;AACnD,SAAS,MAAM,CAAC,GAAW,EAAE,MAAc;IACzC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,WAAW,GAAG,GAAG,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,OAAgB;IACrC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,OAAiC,EACjC,UAAU,GAAG,CAAC;IAEd,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC,8BAA8B;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAC5B,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CACzD,CAAC;IAEF,kEAAkE;IAClE,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;QAClC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,CAC/D,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;oBACrD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;wBACrB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;wBACpC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAC/D,CAAC;oBACJ,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBACtC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CACjE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpD,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,EAAE,CACpC,CAAC;IAEF,4EAA4E;IAC5E,IAAI,gBAAgB,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACtE,MAAM,MAAM,GAAG,gBAAgB;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC;aACjE,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,0CAA0C;IAC1C,sDAAsD;IACtD,MAAM,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,gBAAgB;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,MAAM,CACJ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,EACtD,UAAU,CACX,CACF;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,IAAI,GAAG,SAAS,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,OAAuB,EACvB,OAAiC,EACjC,UAAU,GAAG,CAAC;IAEd,MAAM,MAAM,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACzD,OAAO,GAAG,MAAM,GAAG,aAAa,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IAKH;IACA;IALX,OAAO,GAAe,IAAI,CAAC;IAC3B,UAAU,GAAG,CAAC,CAAC;IAEvB,YACmB,GAAY,EACZ,UAAmC,EAAE;QADrC,QAAG,GAAH,GAAG,CAAS;QACZ,YAAO,GAAP,OAAO,CAA8B;IACrD,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACvC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,KAAgC,EAChC,IAAY,EACZ,KAA+B,EAC/B,OAAuB,EACvB,OAAiC,EACjC,OAAO,GAAG,KAAK;QAEf,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,aAAa,CAC7B,OAAO,EACP,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,EAC/B,UAAU,CACX,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;QAEjE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,IAAI,CAAC,cAAc,CACjB,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAC1B,GAAG,EACH,KAAK,CAAC,IAAI,EACV,OAAO,EACP,OAAO,CACR,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,OAAO,CAAC,OAAuB,EAAE,OAAiC;QAChE,IAAI,CAAC,cAAc,CACjB,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAC3B,GAAG,EACH,KAAK,CAAC,MAAM,EACZ,OAAO,EACP,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAuB,EAAE,OAAiC;QAC9D,IAAI,CAAC,cAAc,CACjB,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAC5B,GAAG,EACH,KAAK,CAAC,GAAG,EACT,OAAO,EACP,OAAO,EACP,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAgC;QACpC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,IAAY;QACrB,kDAAkD;QAClD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,EAAoB;QAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,wCAAwC;YACxC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;gBACjB,MAAM,EAAE,IAAI,CAAC,UAAU;gBACvB,KAAK,EAAE,MAAM;aACd,CAAC,CAAC,KAAK,EAAE,CAAC;YAEX,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAE1B,gCAAgC;YAChC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@versu/cli",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Versu (CLI)",
   "type": "module",
   "main": "dist/index.js",
@@ -39,7 +39,7 @@
   "types": "dist/index.d.ts",
   "dependencies": {
     "@oclif/core": "^4.8.0",
-    "@versu/core": "^0.11.0",
+    "@versu/core": "^0.13.0",
     "chalk": "^5.6.2",
     "oclif": "^4.14.0",
     "ora": "^9.3.0"