fireflyy 4.0.0-dev.df58d2b → 4.0.0-dev.fc28987

package/assets/firefly.schema.json

@@ -1,5 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
+  "description": "Firefly CLI configuration.",
   "type": "object",
   "properties": {
     "cwd": {
@@ -30,9 +31,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": {
@@ -94,7 +98,6 @@
         },
         "releaseNotes": {
           "description": "Custom release notes for changelog.",
-          "default": "",
           "type": "string"
         },
         "commitMessage": {
@@ -144,17 +147,14 @@
         },
         "releaseLatest": {
           "description": "Mark as latest release.",
-          "default": true,
           "type": "boolean"
         },
         "releasePreRelease": {
           "description": "Mark as pre-release.",
-          "default": false,
           "type": "boolean"
         },
         "releaseDraft": {
           "description": "Release as draft version.",
-          "default": false,
           "type": "boolean"
         }
       }

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

@@ -1,6 +1,6 @@
-import { t as logger } from "./main.js";
-import { g as invalidError, i as FireflyOkAsync, r as FireflyOk, t as FireflyErr } from "./result.constructors-D9jmQ0uj.js";
-import { n as TRANSITION_KEYWORDS } from "./version-strategy.service-vh5KeNCA.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

@@ -0,0 +1,130 @@
+import z from "zod";
+
+//#region src/commands/release/release.config.d.ts
+
+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.
+ */
+declare const FireflyConfigSchema: z.ZodObject<{
+  release: z.ZodOptional<z.ZodObject<{
+    name: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    scope: z.ZodOptional<z.ZodOptional<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<{
+      auto: "auto";
+      manual: "manual";
+    }>, z.ZodLiteral<"">]>>>;
+    releaseType: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+      major: "major";
+      minor: "minor";
+      patch: "patch";
+      prerelease: "prerelease";
+      premajor: "premajor";
+      preminor: "preminor";
+      prepatch: "prepatch";
+      graduate: "graduate";
+    }>>>;
+    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.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>>>;
+    skipChangelog: z.ZodOptional<z.ZodDefault<z.ZodCoercedBoolean<unknown>>>;
+    skipPush: z.ZodOptional<z.ZodDefault<z.ZodCoercedBoolean<unknown>>>;
+    skipGitHubRelease: z.ZodOptional<z.ZodDefault<z.ZodCoercedBoolean<unknown>>>;
+    skipGit: z.ZodOptional<z.ZodDefault<z.ZodCoercedBoolean<unknown>>>;
+    skipPreflightCheck: z.ZodOptional<z.ZodDefault<z.ZodCoercedBoolean<unknown>>>;
+    releaseTitle: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    releaseLatest: z.ZodOptional<z.ZodOptional<z.ZodCoercedBoolean<unknown>>>;
+    releasePreRelease: z.ZodOptional<z.ZodOptional<z.ZodCoercedBoolean<unknown>>>;
+    releaseDraft: z.ZodOptional<z.ZodOptional<z.ZodCoercedBoolean<unknown>>>;
+  }, z.core.$strip>>;
+  cwd: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  dryRun: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+  verbose: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+  enableRollback: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * 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> & {
+  release?: Partial<Omit<ReleaseConfig, ReleaseFlagKeys>> & ExclusiveReleaseFlags;
+};
+//#endregion
+//#region src/config/index.d.ts
+/**
+ * Helper function to define a type-safe Firefly configuration.
+ *
+ * Provides IntelliSense autocompletion and type checking for config files.
+ *
+ * @param options - The configuration options
+ * @returns The same options (identity function for type inference)
+ */
+declare function defineConfig<T extends FireflyConfig>(options: T): T;
+//#endregion
+export { defineConfig };

package/dist/{index.js → config.js}

@@ -6,17 +6,6 @@
 *
 * @param options - The configuration options
 * @returns The same options (identity function for type inference)
-*
-* @example
-* ```ts
-* export default defineConfig({
-*     verbose: true,
-*     release: {
-*         bumpStrategy: "conventional",
-*         releaseType: "github",
-*     },
-* });
-* ```
 */
 function defineConfig(options) {
 	return options;

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-korHDlWr.js → dry-run-C7RaPEq8.js}

@@ -1,5 +1,5 @@
-import { t as logger } from "./main.js";
-import { i as FireflyOkAsync } from "./result.constructors-D9jmQ0uj.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-BcQtLzfl.js → filesystem.service-DS2AQGNq.js}

@@ -1,7 +1,7 @@
-import { t as logger } from "./main.js";
-import { l as notFoundErrAsync } from "./result.constructors-D9jmQ0uj.js";
-import { n as wrapPromise } from "./result.utilities-CdBL5noX.js";
-import { t as withDryRun } from "./dry-run-korHDlWr.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-D1Mf6LZ0.js → git.service-B6RdTilO.js}

@@ -1,6 +1,7 @@
-import { t as logger } from "./main.js";
-import { h as failedError, i as FireflyOkAsync, o as failedErrAsync } from "./result.constructors-D9jmQ0uj.js";
-import { t as withDryRun } from "./dry-run-korHDlWr.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/logging-Bpk2RzGc.js

@@ -0,0 +1,20 @@
+import { createConsola } from "consola";
+import { colors } from "consola/utils";
+
+//#region src/infrastructure/logging/index.ts
+const opts = {
+	date: false,
+	compact: true,
+	columns: 0
+};
+const _logger = createConsola({ formatOptions: opts });
+const logger = createConsola({
+	formatOptions: opts,
+	reporters: [{ log(logObj) {
+		if (logObj.type === "verbose") console.log(colors.gray(logObj.args.join(" ")));
+		else _logger.log(logObj);
+	} }]
+});
+
+//#endregion
+export { logger as t };

package/dist/main.js

@@ -1,7 +1,4 @@
 #!/usr/bin/env bun
-import { createConsola } from "consola";
-import { colors } from "consola/utils";
-
 //#region src/core/environment/runtime-env.ts
 /**
 * These are set during CLI initialization in main.ts and provide
@@ -53,25 +50,9 @@ var RuntimeEnv = class {
 	}
 };
 
-//#endregion
-//#region src/infrastructure/logging/index.ts
-const opts = {
-	date: false,
-	compact: true,
-	columns: 0
-};
-const _logger = createConsola({ formatOptions: opts });
-const logger = createConsola({
-	formatOptions: opts,
-	reporters: [{ log(logObj) {
-		if (logObj.type === "verbose") console.log(colors.gray(logObj.args.join(" ")));
-		else _logger.log(logObj);
-	} }]
-});
-
 //#endregion
 //#region package.json
-var version = "4.0.0-dev.df58d2b";
+var version = "4.0.0-dev.fc28987";
 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",
@@ -99,13 +80,10 @@ async function main() {
 		description,
 		gitCliffVersion: dependencies["git-cliff"]?.replace("^", "") || "unknown"
 	});
-	const { createFireflyCLI } = await import("./program-CW3hIbzh.js");
-	createFireflyCLI().parseAsync(process.argv).catch((error) => {
-		logger.error("Fatal error:", error);
-		process.exit(1);
-	});
+	const { createFireflyCLI } = await import("./program-d3d_c7Hx.js");
+	createFireflyCLI().parseAsync(process.argv).catch(() => process.exit(1));
 }
 main();
 
 //#endregion
-export { RuntimeEnv as n, logger as t };
+export { RuntimeEnv as t };

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

@@ -1,6 +1,6 @@
-import { t as logger } from "./main.js";
-import { d as validationErr, f as validationErrAsync, i as FireflyOkAsync, v as toFireflyError } from "./result.constructors-D9jmQ0uj.js";
-import { n as parseSchema } from "./schema.utilities-BOJqWEey.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";