fireflyy 4.0.0-dev.988c93c → 4.0.0-dev.a8aacbe

package/assets/firefly.schema.json

@@ -1,6 +1,5 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "description": "Firefly CLI configuration.",
   "type": "object",
   "properties": {
     "cwd": {
@@ -20,7 +19,6 @@
       "type": "boolean"
     },
     "release": {
-      "description": "Release command configuration.",
       "type": "object",
       "properties": {
         "name": {
@@ -31,9 +29,12 @@
           "description": "Org/user scope without '@'. Auto-detected from package.json.",
           "type": "string"
         },
+        "repository": {
+          "description": "GitHub repository in 'owner/repo' format.",
+          "type": "string"
+        },
         "base": {
           "description": "Relative path from repository root to project root.",
-          "default": "",
           "type": "string"
         },
         "branch": {
@@ -41,13 +42,13 @@
           "type": "string"
         },
         "changelogPath": {
-          "description": "Changelog file path, relative to project root.",
           "default": "CHANGELOG.md",
+          "description": "Changelog file path, relative to project root.",
           "type": "string"
         },
         "bumpStrategy": {
-          "description": "\"auto\" (from commits) or \"manual\" (user-specified).",
           "default": "",
+          "description": "\"auto\" (from commits) or \"manual\" (user-specified).",
           "anyOf": [
             {
               "type": "string",
@@ -95,52 +96,51 @@
         },
         "releaseNotes": {
           "description": "Custom release notes for changelog.",
-          "default": "",
           "type": "string"
         },
         "commitMessage": {
-          "description": "Commit message template with placeholders.",
           "default": "chore(release): release {{name}}@{{version}}",
+          "description": "Commit message template with placeholders.",
           "type": "string"
         },
         "tagName": {
-          "description": "Tag name template with placeholders.",
           "default": "{{name}}@{{version}}",
+          "description": "Tag name template with placeholders.",
           "type": "string"
         },
         "skipBump": {
-          "description": "Skip version bump step.",
           "default": false,
+          "description": "Skip version bump step.",
           "type": "boolean"
         },
         "skipChangelog": {
-          "description": "Skip changelog generation step.",
           "default": false,
+          "description": "Skip changelog generation step.",
           "type": "boolean"
         },
         "skipPush": {
-          "description": "Skip push step.",
           "default": false,
+          "description": "Skip push step.",
           "type": "boolean"
         },
         "skipGitHubRelease": {
-          "description": "Skip GitHub release step.",
           "default": false,
+          "description": "Skip GitHub release step.",
           "type": "boolean"
         },
         "skipGit": {
-          "description": "Skip all git-related steps.",
           "default": false,
+          "description": "Skip all git-related steps.",
           "type": "boolean"
         },
         "skipPreflightCheck": {
-          "description": "Skip preflight checks.",
           "default": false,
+          "description": "Skip preflight checks.",
           "type": "boolean"
         },
         "releaseTitle": {
-          "description": "GitHub release title with placeholders.",
           "default": "{{name}}@{{version}}",
+          "description": "GitHub release title with placeholders.",
           "type": "string"
         },
         "releaseLatest": {
@@ -155,7 +155,9 @@
           "description": "Release as draft version.",
           "type": "boolean"
         }
-      }
+      },
+      "description": "Release command configuration."
     }
-  }
+  },
+  "description": "Firefly CLI configuration."
 }

package/dist/{commit-analysis.service-Ba6hLgsr.js → commit-analysis.service-B2Z128t8.js}

@@ -1,6 +1,6 @@
-import { h as invalidError, i as FireflyOkAsync, r as FireflyOk, t as FireflyErr } from "./result.constructors-BMtOWD2-.js";
-import { t as logger } from "./logging-BuIkRrn1.js";
-import { TRANSITION_KEYWORDS } from "./version-strategy.service-CmfeZLYC.js";
+import { g as invalidError, i as FireflyOkAsync, r as FireflyOk, t as FireflyErr } from "./result.constructors-DoAoYdfF.js";
+import { t as logger } from "./logging-Bpk2RzGc.js";
+import { TRANSITION_KEYWORDS } from "./version-strategy.service-Dln42gxC.js";
 
 //#region src/domain/commits/commit-types.ts
 /**

package/dist/config.d.ts

@@ -1,7 +1,70 @@
 import z from "zod";
 
-//#region src/cli/config/config.schema.d.ts
+//#region src/commands/release/release.config.d.ts
 
+/**
+ * Release configuration schema with runtime validation refinements.
+ * Use this schema for parsing and validating user input.
+ */
+declare const ReleaseConfigSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  scope: z.ZodOptional<z.ZodString>;
+  repository: z.ZodOptional<z.ZodString>;
+  base: z.ZodOptional<z.ZodString>;
+  branch: z.ZodOptional<z.ZodString>;
+  changelogPath: z.ZodDefault<z.ZodString>;
+  bumpStrategy: z.ZodDefault<z.ZodUnion<[z.ZodEnum<{
+    auto: "auto";
+    manual: "manual";
+  }>, z.ZodLiteral<"">]>>;
+  releaseType: z.ZodOptional<z.ZodEnum<{
+    major: "major";
+    minor: "minor";
+    patch: "patch";
+    prerelease: "prerelease";
+    premajor: "premajor";
+    preminor: "preminor";
+    prepatch: "prepatch";
+    graduate: "graduate";
+  }>>;
+  preReleaseId: z.ZodOptional<z.ZodString>;
+  preReleaseBase: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"0">, z.ZodLiteral<"1">]>>;
+  releaseNotes: z.ZodOptional<z.ZodString>;
+  commitMessage: z.ZodDefault<z.ZodString>;
+  tagName: z.ZodDefault<z.ZodString>;
+  skipBump: z.ZodDefault<z.ZodCoercedBoolean<unknown>>;
+  skipChangelog: z.ZodDefault<z.ZodCoercedBoolean<unknown>>;
+  skipPush: z.ZodDefault<z.ZodCoercedBoolean<unknown>>;
+  skipGitHubRelease: z.ZodDefault<z.ZodCoercedBoolean<unknown>>;
+  skipGit: z.ZodDefault<z.ZodCoercedBoolean<unknown>>;
+  skipPreflightCheck: z.ZodDefault<z.ZodCoercedBoolean<unknown>>;
+  releaseTitle: z.ZodDefault<z.ZodString>;
+  releaseLatest: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+  releasePreRelease: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+  releaseDraft: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+}, z.core.$strip>;
+type BaseRelease = z.infer<typeof ReleaseConfigSchema>;
+type ReleaseFlagKeys = "releaseLatest" | "releasePreRelease" | "releaseDraft";
+type ExclusiveReleaseFlags = {
+  releaseLatest: true;
+  releasePreRelease?: false | undefined;
+  releaseDraft?: false | undefined;
+} | {
+  releasePreRelease: true;
+  releaseLatest?: false | undefined;
+  releaseDraft?: false | undefined;
+} | {
+  releaseDraft: true;
+  releaseLatest?: false | undefined;
+  releasePreRelease?: false | undefined;
+} | {
+  releaseLatest?: false | undefined;
+  releasePreRelease?: false | undefined;
+  releaseDraft?: false | undefined;
+};
+type ReleaseConfig = Omit<BaseRelease, ReleaseFlagKeys> & ExclusiveReleaseFlags;
+//#endregion
+//#region src/cli/config/config.schema.d.ts
 /**
  * Complete Firefly configuration schema.
  * Combines global options with command-specific configuration sections.
@@ -10,7 +73,8 @@ declare const FireflyConfigSchema: z.ZodObject<{
   release: z.ZodOptional<z.ZodObject<{
     name: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     scope: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-    base: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    repository: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    base: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     branch: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     changelogPath: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     bumpStrategy: z.ZodOptional<z.ZodDefault<z.ZodUnion<[z.ZodEnum<{
@@ -29,7 +93,7 @@ declare const FireflyConfigSchema: z.ZodObject<{
     }>>>;
     preReleaseId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     preReleaseBase: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"0">, z.ZodLiteral<"1">]>>>;
-    releaseNotes: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    releaseNotes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     commitMessage: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     tagName: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     skipBump: z.ZodOptional<z.ZodDefault<z.ZodCoercedBoolean<unknown>>>;
@@ -52,7 +116,9 @@ declare const FireflyConfigSchema: z.ZodObject<{
  * TypeScript type for Firefly configuration.
  * Use this type when you need to reference the configuration shape without runtime validation.
  */
-type FireflyConfig = z.infer<typeof FireflyConfigSchema>;
+type FireflyConfig = z.infer<typeof FireflyConfigSchema> & {
+  release?: Partial<Omit<ReleaseConfig, ReleaseFlagKeys>> & ExclusiveReleaseFlags;
+};
 //#endregion
 //#region src/config/index.d.ts
 /**

package/dist/debug-flags-K3yK5B6O.js

@@ -0,0 +1,74 @@
+//#region src/core/environment/debug-flags.ts
+/**
+* Debug flags are environment variables prefixed with `FIREFLY_DEBUG_` that
+* enable diagnostic features during development and troubleshooting.
+*
+* @example
+* ```typescript
+* if (DebugFlags.showRawError) {
+*     logger.error(parseResult.error);
+* }
+* ```
+*/
+var DebugFlags = class {
+	constructor() {}
+	/**
+	* When enabled, displays raw Zod validation errors for configuration parsing.
+	*
+	* Useful for debugging configuration schema issues and understanding
+	* why validation failed at a granular level.
+	*/
+	static get showRawError() {
+		return Boolean(process.env.FIREFLY_DEBUG_SHOW_RAW_ERROR);
+	}
+	/**
+	* When enabled, logs the loaded configuration file contents.
+	*
+	* Useful for debugging configuration loading and understanding
+	* what values are being read from config files.
+	*/
+	static get showFileConfig() {
+		return Boolean(process.env.FIREFLY_DEBUG_SHOW_FILE_CONFIG);
+	}
+	/**
+	* When enabled, displays task graph statistics during release execution.
+	*
+	* Shows information about task dependencies, execution order,
+	* and graph structure for debugging workflow issues.
+	*/
+	static get showTaskGraphStats() {
+		return Boolean(process.env.FIREFLY_DEBUG_SHOW_TASK_GRAPH_STATS);
+	}
+	/**
+	* When enabled, prevents truncation of release notes in GitHub CLI logs.
+	*
+	* By default, release notes are truncated in logs to avoid pollution.
+	* Enable this flag to see full release notes content during debugging.
+	*/
+	static get dontTruncateReleaseNotes() {
+		return Boolean(process.env.FIREFLY_DEBUG_DONT_TRUNCATE_RELEASE_NOTES?.trim());
+	}
+	/**
+	* When enabled, prevents redaction of sensitive GitHub CLI arguments in logs.
+	*
+	* By default, sensitive values (tokens, passwords, etc.) are redacted.
+	* Enable this flag to see full argument values during debugging.
+	*
+	* WARNING: Use with caution as this may expose sensitive information.
+	*/
+	static get dontRedactGithubCliArgs() {
+		return Boolean(process.env.FIREFLY_DEBUG_DONT_REDACT_GITHUB_CLI_ARGS?.trim());
+	}
+	/**
+	* When enabled, logs verbose details for git commit operations.
+	*
+	* By default, the verbose log of the git show command is disabled to reduce noise, if commits are many.
+	* Enable this flag to see detailed commit information during debugging.
+	*/
+	static get showVerboseGitCommitDetails() {
+		return Boolean(process.env.FIREFLY_DEBUG_SHOW_VERBOSE_GIT_COMMIT_DETAILS?.trim());
+	}
+};
+
+//#endregion
+export { DebugFlags as t };

package/dist/{dry-run-Cdg-c0EP.js → dry-run-C7RaPEq8.js}

@@ -1,5 +1,5 @@
-import { i as FireflyOkAsync } from "./result.constructors-BMtOWD2-.js";
-import { t as logger } from "./logging-BuIkRrn1.js";
+import { i as FireflyOkAsync } from "./result.constructors-DoAoYdfF.js";
+import { t as logger } from "./logging-Bpk2RzGc.js";
 
 //#region src/infrastructure/dry-run/index.ts
 /**

package/dist/{filesystem.service-B8qg87n-.js → filesystem.service-DS2AQGNq.js}

@@ -1,7 +1,7 @@
-import { c as notFoundErrAsync } from "./result.constructors-BMtOWD2-.js";
-import { n as wrapPromise } from "./result.utilities-BTVU-GsT.js";
-import { t as logger } from "./logging-BuIkRrn1.js";
-import { t as withDryRun } from "./dry-run-Cdg-c0EP.js";
+import { l as notFoundErrAsync } from "./result.constructors-DoAoYdfF.js";
+import { n as wrapPromise } from "./result.utilities-DXSJU70_.js";
+import { t as logger } from "./logging-Bpk2RzGc.js";
+import { t as withDryRun } from "./dry-run-C7RaPEq8.js";
 
 //#region src/services/implementations/filesystem.service.ts
 /**

package/dist/{git.service-BBqDH7qx.js → git.service-B6RdTilO.js}

@@ -1,6 +1,7 @@
-import { i as FireflyOkAsync, m as failedError, o as failedErrAsync } from "./result.constructors-BMtOWD2-.js";
-import { t as logger } from "./logging-BuIkRrn1.js";
-import { t as withDryRun } from "./dry-run-Cdg-c0EP.js";
+import { t as DebugFlags } from "./debug-flags-K3yK5B6O.js";
+import { h as failedError, i as FireflyOkAsync, o as failedErrAsync } from "./result.constructors-DoAoYdfF.js";
+import { t as logger } from "./logging-Bpk2RzGc.js";
+import { t as withDryRun } from "./dry-run-C7RaPEq8.js";
 import { ResultAsync } from "neverthrow";
 import { z } from "zod";
 
@@ -397,7 +398,7 @@ var DefaultGitService = class {
 			"--no-patch",
 			`--format=${format}`,
 			hash
-		]);
+		], { verbose: DebugFlags.showVerboseGitCommitDetails });
 	}
 	getUnpushedCommits() {
 		return this.getCurrentBranch().andThen((branch) => {

package/dist/main.js

@@ -52,16 +52,16 @@ var RuntimeEnv = class {
 
 //#endregion
 //#region package.json
-var version = "4.0.0-dev.988c93c";
+var version = "4.0.0-dev.a8aacbe";
 var description = " CLI orchestrator for automatic semantic versioning, changelog generation, and creating releases. Built for my own use cases.";
 var dependencies = {
-	"c12": "^3.3.2",
+	"c12": "^3.3.3",
 	"commander": "^14.0.2",
 	"consola": "^3.4.2",
-	"git-cliff": "^2.10.1",
+	"git-cliff": "^2.11.0",
 	"neverthrow": "^8.2.0",
 	"semver": "^7.7.3",
-	"zod": "^4.1.13"
+	"zod": "^4.3.4"
 };
 
 //#endregion
@@ -80,7 +80,7 @@ async function main() {
 		description,
 		gitCliffVersion: dependencies["git-cliff"]?.replace("^", "") || "unknown"
 	});
-	const { createFireflyCLI } = await import("./program-Dqo9sQjU.js");
+	const { createFireflyCLI } = await import("./program-BOk_0Q6Q.js");
 	createFireflyCLI().parseAsync(process.argv).catch(() => process.exit(1));
 }
 main();

package/dist/{package-json.service-CHmtIoQQ.js → package-json.service-BlMNgPGQ.js}

@@ -1,6 +1,6 @@
-import { _ as toFireflyError, d as validationErrAsync, i as FireflyOkAsync, u as validationErr } from "./result.constructors-BMtOWD2-.js";
-import { t as logger } from "./logging-BuIkRrn1.js";
-import { n as parseSchema } from "./schema.utilities-BxiRR-GI.js";
+import { d as validationErr, f as validationErrAsync, i as FireflyOkAsync, v as toFireflyError } from "./result.constructors-DoAoYdfF.js";
+import { t as logger } from "./logging-Bpk2RzGc.js";
+import { n as parseSchema } from "./schema.utilities-C1yimTtB.js";
 import { Result } from "neverthrow";
 import z$1 from "zod";