optikit 1.2.5 → 1.3.0

package/dist/commands/version/bump.js

@@ -1,24 +1,55 @@
+import { createInterface } from "readline";
 import { validateFlutterProject } from "../../utils/validators/validation.js";
 import { LoggerHelpers } from "../../utils/services/logger.js";
 import { getCurrentVersion, incrementVersion, formatVersion, getCurrentIosBuildNumber } from "../../utils/helpers/version.js";
+import { handleCommandError } from "../../utils/helpers/error.js";
 import { updateFlutterVersion } from "./update.js";
 import chalk from "chalk";
 export { bumpVersion, bumpIosBuildOnly, bumpAndroidBuildOnly, bumpBothBuilds, showCurrentVersion };
 /**
- * Bumps version with semantic versioning (major, minor, patch)
- * Android build number increments with version
- * iOS build number resets to 1 on version change
- *
- * @param type - Type of version bump (major, minor, patch)
+ * Prompts user for confirmation. Returns true if confirmed.
+ * Skips prompt and returns true if skipConfirm is true (--yes flag).
  */
-async function bumpVersion(type) {
-    // Pre-flight validation
+function confirmAction(message, skipConfirm) {
+    if (skipConfirm)
+        return Promise.resolve(true);
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(chalk.yellow(`${message} (y/n): `), (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y");
+        });
+    });
+}
+/**
+ * Shows a colored diff preview of what will change.
+ */
+function showDiffPreview(oldVersion, newVersion, oldAndroidBuild, newAndroidBuild, oldIosBuild, newIosBuild) {
+    console.log(chalk.cyan("\nFile changes preview:"));
+    if (newAndroidBuild !== "") {
+        console.log(chalk.gray("\n  pubspec.yaml:"));
+        console.log(chalk.red(`    - version: ${oldVersion}+${oldAndroidBuild}`));
+        console.log(chalk.green(`    + version: ${newVersion}+${newAndroidBuild}`));
+    }
+    if (newIosBuild !== "") {
+        console.log(chalk.gray("\n  project.pbxproj:"));
+        console.log(chalk.red(`    - MARKETING_VERSION = ${oldVersion};`));
+        console.log(chalk.green(`    + MARKETING_VERSION = ${newVersion};`));
+        console.log(chalk.red(`    - CURRENT_PROJECT_VERSION = ${oldIosBuild};`));
+        console.log(chalk.green(`    + CURRENT_PROJECT_VERSION = ${newIosBuild};`));
+    }
+    console.log();
+}
+async function bumpVersion(type, skipConfirm = false) {
     if (!validateFlutterProject()) {
         process.exit(1);
     }
     try {
         const current = getCurrentVersion();
+        const currentIosBuild = getCurrentIosBuildNumber();
         const newVersion = incrementVersion(current, type);
+        const currentVersionString = `${current.major}.${current.minor}.${current.patch}`;
+        const newVersionString = `${newVersion.major}.${newVersion.minor}.${newVersion.patch}`;
         LoggerHelpers.info(`Current version: ${formatVersion(current)}`);
         LoggerHelpers.info(`Bumping ${type} version...`);
         console.log(chalk.cyan("\nVersion changes:"));
@@ -26,43 +57,29 @@ async function bumpVersion(type) {
         console.log(chalk.gray("  New:"), chalk.green.bold(formatVersion(newVersion)));
         console.log(chalk.cyan("\nBuild number strategy:"));
         console.log(chalk.gray("  Android:"), chalk.white(`${current.buildNumber} → ${newVersion.buildNumber} (incremented)`));
-        console.log(chalk.gray("  iOS:"), chalk.white(`${current.buildNumber} → 1 (reset for new version)`));
-        console.log();
-        // Update with new version
-        // Android uses the incremented build number from version
-        // iOS gets reset to 1 for new version releases
-        await updateFlutterVersion(`${newVersion.major}.${newVersion.minor}.${newVersion.patch}`, newVersion.buildNumber.toString(), "1" // iOS always starts at 1 for new versions
-        );
+        console.log(chalk.gray("  iOS:"), chalk.white(`${currentIosBuild} → 1 (reset for new version)`));
+        showDiffPreview(currentVersionString, newVersionString, current.buildNumber, newVersion.buildNumber, currentIosBuild, 1);
+        const confirmed = await confirmAction("Proceed with version bump?", skipConfirm);
+        if (!confirmed) {
+            LoggerHelpers.info("Bump cancelled.");
+            return;
+        }
+        await updateFlutterVersion(newVersionString, newVersion.buildNumber.toString(), "1");
         LoggerHelpers.success(`Version bumped to ${formatVersion(newVersion)}`);
         console.log(chalk.gray("\nAndroid build:"), chalk.white(newVersion.buildNumber));
         console.log(chalk.gray("iOS build:"), chalk.white("1"));
     }
     catch (error) {
-        if (error instanceof Error) {
-            LoggerHelpers.error(`Error bumping version: ${error.message}`);
-        }
-        else {
-            LoggerHelpers.error(`Error bumping version: ${error}`);
-        }
-        process.exit(1);
+        handleCommandError(error, "Error bumping version");
     }
 }
-/**
- * Increments ONLY iOS build number (for TestFlight builds)
- * Keeps version and Android build number unchanged
- * Perfect for uploading new iOS builds without changing app version
- *
- * Example: 1.0.2+45 (iOS: 45) → 1.0.2+45 (iOS: 46)
- */
-async function bumpIosBuildOnly() {
-    // Pre-flight validation
+async function bumpIosBuildOnly(skipConfirm = false) {
     if (!validateFlutterProject()) {
         process.exit(1);
     }
     try {
         const current = getCurrentVersion();
         const currentVersionString = `${current.major}.${current.minor}.${current.patch}`;
-        // Read actual iOS build number from project.pbxproj
         const currentIosBuild = getCurrentIosBuildNumber();
         const nextIosBuild = currentIosBuild + 1;
         LoggerHelpers.info(`Current version: ${formatVersion(current)}`);
@@ -71,36 +88,27 @@ async function bumpIosBuildOnly() {
         console.log(chalk.gray("  Version:"), chalk.white(`${currentVersionString} (unchanged)`));
         console.log(chalk.gray("  Android:"), chalk.white(`${current.buildNumber} (unchanged)`));
         console.log(chalk.gray("  iOS:"), chalk.white(`${currentIosBuild} → ${nextIosBuild}`), chalk.green("(incremented)"));
-        console.log();
-        // Update only iOS build number
-        await updateFlutterVersion(currentVersionString, "", // Empty string means don't update Android
-        nextIosBuild.toString());
+        showDiffPreview(currentVersionString, currentVersionString, current.buildNumber, "", currentIosBuild, nextIosBuild);
+        const confirmed = await confirmAction("Proceed?", skipConfirm);
+        if (!confirmed) {
+            LoggerHelpers.info("Bump cancelled.");
+            return;
+        }
+        await updateFlutterVersion(currentVersionString, "", nextIosBuild.toString());
         LoggerHelpers.success(`iOS build number incremented to ${nextIosBuild}`);
-        console.log(chalk.gray("\nResult:"), chalk.white(`${currentVersionString}+${current.buildNumber} (iOS: ${nextIosBuild})`));
-        console.log(chalk.gray("Use this for:"), chalk.white("TestFlight uploads without version changes"));
     }
     catch (error) {
-        if (error instanceof Error) {
-            LoggerHelpers.error(`Error incrementing iOS build: ${error.message}`);
-        }
-        else {
-            LoggerHelpers.error(`Error incrementing iOS build: ${error}`);
-        }
-        process.exit(1);
+        handleCommandError(error, "Error incrementing iOS build");
     }
 }
-/**
- * Increments ONLY Android build number
- * Keeps version and iOS build number unchanged
- */
-async function bumpAndroidBuildOnly() {
-    // Pre-flight validation
+async function bumpAndroidBuildOnly(skipConfirm = false) {
     if (!validateFlutterProject()) {
         process.exit(1);
     }
     try {
         const current = getCurrentVersion();
         const currentVersionString = `${current.major}.${current.minor}.${current.patch}`;
+        const currentIosBuild = getCurrentIosBuildNumber();
         const nextAndroidBuild = current.buildNumber + 1;
         LoggerHelpers.info(`Current version: ${formatVersion(current)}`);
         LoggerHelpers.info("Incrementing Android build number only...");
@@ -108,36 +116,26 @@ async function bumpAndroidBuildOnly() {
         console.log(chalk.gray("  Version:"), chalk.white(`${currentVersionString} (unchanged)`));
         console.log(chalk.gray("  Android:"), chalk.white(`${current.buildNumber} → ${nextAndroidBuild}`), chalk.green("(incremented)"));
         console.log(chalk.gray("  iOS:"), chalk.white("(unchanged)"));
-        console.log();
-        // Update only Android build number
-        await updateFlutterVersion(currentVersionString, nextAndroidBuild.toString(), "" // Empty string means don't update iOS
-        );
+        showDiffPreview(currentVersionString, currentVersionString, current.buildNumber, nextAndroidBuild, currentIosBuild, "");
+        const confirmed = await confirmAction("Proceed?", skipConfirm);
+        if (!confirmed) {
+            LoggerHelpers.info("Bump cancelled.");
+            return;
+        }
+        await updateFlutterVersion(currentVersionString, nextAndroidBuild.toString(), "");
         LoggerHelpers.success(`Android build number incremented to ${nextAndroidBuild}`);
     }
     catch (error) {
-        if (error instanceof Error) {
-            LoggerHelpers.error(`Error incrementing Android build: ${error.message}`);
-        }
-        else {
-            LoggerHelpers.error(`Error incrementing Android build: ${error}`);
-        }
-        process.exit(1);
+        handleCommandError(error, "Error incrementing Android build");
     }
 }
-/**
- * Increments BOTH Android and iOS build numbers
- * Keeps version unchanged
- * Perfect for updating both platforms simultaneously
- */
-async function bumpBothBuilds() {
-    // Pre-flight validation
+async function bumpBothBuilds(skipConfirm = false) {
     if (!validateFlutterProject()) {
         process.exit(1);
     }
     try {
         const current = getCurrentVersion();
         const currentVersionString = `${current.major}.${current.minor}.${current.patch}`;
-        // Read actual iOS build number from project.pbxproj
         const currentIosBuild = getCurrentIosBuildNumber();
         const nextAndroidBuild = current.buildNumber + 1;
         const nextIosBuild = currentIosBuild + 1;
@@ -147,26 +145,19 @@ async function bumpBothBuilds() {
         console.log(chalk.gray("  Version:"), chalk.white(`${currentVersionString} (unchanged)`));
         console.log(chalk.gray("  Android:"), chalk.white(`${current.buildNumber} → ${nextAndroidBuild}`), chalk.green("(incremented)"));
         console.log(chalk.gray("  iOS:"), chalk.white(`${currentIosBuild} → ${nextIosBuild}`), chalk.green("(incremented)"));
-        console.log();
-        // Update both Android and iOS build numbers
+        showDiffPreview(currentVersionString, currentVersionString, current.buildNumber, nextAndroidBuild, currentIosBuild, nextIosBuild);
+        const confirmed = await confirmAction("Proceed?", skipConfirm);
+        if (!confirmed) {
+            LoggerHelpers.info("Bump cancelled.");
+            return;
+        }
         await updateFlutterVersion(currentVersionString, nextAndroidBuild.toString(), nextIosBuild.toString());
         LoggerHelpers.success(`Both build numbers incremented successfully`);
-        console.log(chalk.gray("\nResult:"), chalk.white(`${currentVersionString}+${nextAndroidBuild} (iOS: ${nextIosBuild})`));
-        console.log(chalk.gray("Use this for:"), chalk.white("Simultaneous Android and iOS releases"));
     }
     catch (error) {
-        if (error instanceof Error) {
-            LoggerHelpers.error(`Error incrementing build numbers: ${error.message}`);
-        }
-        else {
-            LoggerHelpers.error(`Error incrementing build numbers: ${error}`);
-        }
-        process.exit(1);
+        handleCommandError(error, "Error incrementing build numbers");
     }
 }
-/**
- * Shows current version information
- */
 async function showCurrentVersion() {
     try {
         const current = getCurrentVersion();
@@ -182,23 +173,6 @@ async function showCurrentVersion() {
         console.log();
     }
     catch (error) {
-        if (error instanceof Error) {
-            LoggerHelpers.error(`Error reading version: ${error.message}`);
-        }
-        else {
-            LoggerHelpers.error(`Error reading version: ${error}`);
-        }
-        process.exit(1);
+        handleCommandError(error, "Error reading version");
     }
 }
-/**
- * Helper to get next iOS build number
- * In the future, this could read from Info.plist or project.pbxproj
- * For now, we'll use a simple increment
- */
-async function getNextIosBuildNumber() {
-    // TODO: Read actual iOS build number from Info.plist or project.pbxproj
-    // For now, we'll just increment based on timestamp or simple counter
-    const current = getCurrentVersion();
-    return current.buildNumber + 1;
-}

package/dist/commands/version/commands.js

@@ -0,0 +1,63 @@
+import { bumpVersion, bumpIosBuildOnly, bumpAndroidBuildOnly, bumpBothBuilds, showCurrentVersion, } from "./bump.js";
+import { updateFlutterVersion } from "./update.js";
+const yesOption = {
+    yes: { alias: "y", type: "boolean", default: false, description: "Skip confirmation prompt" },
+};
+export const versionCommands = [
+    {
+        command: "bump <type>",
+        describe: "Bump version (major, minor, or patch)",
+        builder: (yargs) => {
+            return yargs
+                .positional("type", {
+                describe: "Version bump type (major, minor, patch)",
+                type: "string",
+                choices: ["major", "minor", "patch"],
+            })
+                .option("yes", yesOption.yes);
+        },
+        handler: async (argv) => {
+            await bumpVersion(argv.type, argv.yes);
+        },
+    },
+    {
+        command: "bump-ios",
+        aliases: ["bi"],
+        describe: "Increment iOS build number only (for TestFlight)",
+        builder: yesOption,
+        handler: async (argv) => { await bumpIosBuildOnly(argv.yes); },
+    },
+    {
+        command: "bump-android",
+        aliases: ["ba"],
+        describe: "Increment Android build number only",
+        builder: yesOption,
+        handler: async (argv) => { await bumpAndroidBuildOnly(argv.yes); },
+    },
+    {
+        command: "bump-build",
+        aliases: ["bb"],
+        describe: "Increment both Android and iOS build numbers",
+        builder: yesOption,
+        handler: async (argv) => { await bumpBothBuilds(argv.yes); },
+    },
+    {
+        command: "version",
+        aliases: ["v"],
+        describe: "Show current version information",
+        handler: async () => { await showCurrentVersion(); },
+    },
+    {
+        command: "flutter-update-version",
+        aliases: ["vset"],
+        describe: "Update version and build numbers for both Android and iOS",
+        builder: {
+            "app-version": { type: "string", description: "The version number to set", default: "" },
+            "android-build": { type: "string", description: "The Android build number", default: "" },
+            "ios-build": { type: "string", description: "The iOS build number", default: "" },
+        },
+        handler: async (argv) => {
+            await updateFlutterVersion(argv["app-version"], argv["android-build"], argv["ios-build"]);
+        },
+    },
+];

package/dist/commands/version/update.js

@@ -2,85 +2,97 @@ import fs from "fs";
 import path from "path";
 import { LoggerHelpers } from "../../utils/services/logger.js";
 import { validateFlutterProject } from "../../utils/validators/validation.js";
-import { createBackup } from "../../utils/services/backup.js";
+import { createBackupWithCleanup } from "../../utils/services/backup.js";
+import { handleCommandError } from "../../utils/helpers/error.js";
+import { isDryRunMode, DryRunManager } from "../../utils/helpers/dryRun.js";
+import { PROJECT_PATHS } from "../../constants.js";
 const currentDir = process.cwd();
 export { updateFlutterVersion };
 async function updateFlutterVersion(version, build, iosBuild) {
-    // Pre-flight validation
     if (!validateFlutterProject()) {
         process.exit(1);
     }
     try {
-        // Always update the version since it is required.
         LoggerHelpers.info(`Starting update for version ${version}...`);
-        // Update pubspec.yaml only if an Android build number is provided.
+        // Single dry-run manager for all operations
+        const dryRun = isDryRunMode() ? new DryRunManager() : null;
         if (build.trim().length > 0) {
             LoggerHelpers.info("Updating build number in pubspec.yaml...");
-            await updatePubspecVersionAndBuild(version, build);
+            await updatePubspecVersionAndBuild(version, build, dryRun);
         }
         else {
             LoggerHelpers.info("Android build number not provided. Skipping pubspec.yaml update.");
         }
-        // Update iOS settings only if an iOS build number is provided.
         if (iosBuild.trim().length > 0) {
             LoggerHelpers.info("Updating iOS version and build number...");
-            await updateIosVersionAndBuild(version, iosBuild);
+            await updateIosVersionAndBuild(version, iosBuild, dryRun);
         }
         else {
             LoggerHelpers.info("iOS build number not provided. Skipping iOS update.");
         }
+        // Show dry-run summary once at the end
+        if (dryRun) {
+            dryRun.displaySummary();
+            return;
+        }
         LoggerHelpers.success(`Update complete. Version set to ${version}` +
             (build.trim().length > 0 ? `, Android build set to ${build}` : "") +
             (iosBuild.trim().length > 0 ? `, and iOS build set to ${iosBuild}` : ""));
     }
     catch (error) {
-        LoggerHelpers.error(`Error while updating Flutter version and build: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
+        handleCommandError(error, "Error while updating Flutter version and build");
     }
 }
-async function updatePubspecVersionAndBuild(version, build) {
+async function updatePubspecVersionAndBuild(version, build, dryRun) {
     try {
-        const pubspecPath = path.join(currentDir, "pubspec.yaml");
+        const pubspecPath = path.join(currentDir, PROJECT_PATHS.PUBSPEC);
         if (!fs.existsSync(pubspecPath)) {
             throw new Error(`pubspec.yaml not found at ${pubspecPath}`);
         }
-        // Create backup before modification
-        createBackup(pubspecPath);
+        if (dryRun) {
+            dryRun.logFileOperation("Update pubspec.yaml", pubspecPath, `version: ${version}+${build}`);
+            return;
+        }
+        createBackupWithCleanup(pubspecPath);
         const pubspecContent = fs.readFileSync(pubspecPath, "utf8");
         const updatedPubspec = pubspecContent.replace(/version: \d+\.\d+\.\d+\+\d+/g, `version: ${version}+${build}`);
         fs.writeFileSync(pubspecPath, updatedPubspec);
         LoggerHelpers.success(`Updated pubspec.yaml with version ${version} and build ${build}`);
     }
     catch (error) {
-        LoggerHelpers.error(`Error while updating pubspec.yaml version and build: ${error instanceof Error ? error.message : String(error)}`);
+        LoggerHelpers.error(`Error while updating pubspec.yaml: ${error instanceof Error ? error.message : String(error)}`);
         throw error;
     }
 }
-async function updateIosVersionAndBuild(version, iosBuild) {
+async function updateIosVersionAndBuild(version, iosBuild, dryRun) {
     try {
-        const currentDir = process.cwd();
-        const projectPbxProjPath = path.join(currentDir, "ios/Runner.xcodeproj/project.pbxproj");
+        const projectPbxProjPath = path.join(currentDir, PROJECT_PATHS.IOS_PROJECT_PBXPROJ);
+        const infoPlistPath = path.join(currentDir, PROJECT_PATHS.IOS_INFO_PLIST);
         if (!fs.existsSync(projectPbxProjPath)) {
             throw new Error(`project.pbxproj not found at ${projectPbxProjPath}`);
         }
-        // Create backup before modification
-        createBackup(projectPbxProjPath);
+        if (dryRun) {
+            dryRun.logFileOperation("Update project.pbxproj", projectPbxProjPath, `MARKETING_VERSION = ${version}, CURRENT_PROJECT_VERSION = ${iosBuild}`);
+            dryRun.logFileOperation("Update Info.plist", infoPlistPath, `CFBundleShortVersionString = ${version}, CFBundleVersion = ${iosBuild}`);
+            return;
+        }
+        // Update project.pbxproj
+        createBackupWithCleanup(projectPbxProjPath);
         let projectContent = fs.readFileSync(projectPbxProjPath, 'utf8');
         projectContent = projectContent
             .replace(/MARKETING_VERSION\s*=\s*[^;]+;/g, `MARKETING_VERSION = ${version};`)
             .replace(/CURRENT_PROJECT_VERSION\s*=\s*[^;]+;/g, `CURRENT_PROJECT_VERSION = ${iosBuild};`);
         fs.writeFileSync(projectPbxProjPath, projectContent);
         LoggerHelpers.success(`Updated MARKETING_VERSION to ${version} and CURRENT_PROJECT_VERSION to ${iosBuild}`);
-        const infoPlistPath = path.join(currentDir, "ios/Runner/Info.plist");
+        // Update Info.plist
         if (!fs.existsSync(infoPlistPath)) {
             throw new Error(`Info.plist not found at ${infoPlistPath}`);
         }
-        // Create backup before modification
-        createBackup(infoPlistPath);
+        createBackupWithCleanup(infoPlistPath);
         const infoPlistContent = fs.readFileSync(infoPlistPath, "utf8");
         const updatedPlist = infoPlistContent
-            .replace(/<key>CFBundleShortVersionString<\/key>\s*<string>\$\{MARKETING_VERSION\}<\/string>/, `<key>CFBundleShortVersionString</key><string>${version}</string>`)
-            .replace(/<key>CFBundleVersion<\/key>\s*<string>\$\{CURRENT_PROJECT_VERSION\}<\/string>/, `<key>CFBundleVersion</key><string>${iosBuild}</string>`);
+            .replace(/<key>CFBundleShortVersionString<\/key>\s*<string>[^<]+<\/string>/, `<key>CFBundleShortVersionString</key>\n\t<string>${version}</string>`)
+            .replace(/<key>CFBundleVersion<\/key>\s*<string>[^<]+<\/string>/, `<key>CFBundleVersion</key>\n\t<string>${iosBuild}</string>`);
         fs.writeFileSync(infoPlistPath, updatedPlist);
         LoggerHelpers.success("Updated Info.plist with the new version and iOS build.");
     }

package/dist/constants.js

@@ -44,7 +44,7 @@ export const BACKUP_CONFIG = {
 };
 // Module generation
 export const MODULE_STRUCTURE = {
-    DIRECTORIES: ["bloc", "event", "state", "screen", "import", "factory"],
+    DIRECTORIES: ["bloc", "event", "state", "screen", "import", "factory", "repo"],
     NAME_PATTERN: /^[a-z0-9_]+$/,
 };
 // Flutter commands
@@ -122,6 +122,11 @@ export const ERROR_MESSAGES = {
     MODULE_NAME_EMPTY: "Module name cannot be empty.",
     MODULE_NAME_INVALID: "Module name must contain only lowercase letters, numbers, and underscores.",
 };
+// MCP server configuration
+export const MCP_CONFIG = {
+    SERVER_NAME: "optikit",
+    CLAUDE_SETTINGS_FILE: ".claude.json",
+};
 // Info messages
 export const INFO_MESSAGES = {
     RUN_FROM_PROJECT_ROOT: "Please run this command from the root of a Flutter project.",

package/dist/styles.js

@@ -1,7 +1,44 @@
+import chalk from 'chalk';
 export const boxenOptions = {
-    padding: 1,
-    margin: 1,
-    borderStyle: 'round', // Cast to the proper type
-    borderColor: 'blue',
-    backgroundColor: '#555555',
+    padding: { top: 1, bottom: 1, left: 3, right: 3 },
+    margin: { top: 1, bottom: 0, left: 1, right: 1 },
+    borderStyle: 'round',
+    borderColor: 'cyan',
 };
+export function createBanner(version) {
+    const greeting = chalk.white.bold('Hello ^_^');
+    const logo = chalk.cyan.bold('OptiKit CLI');
+    const ver = chalk.gray(` v${version}`);
+    const tagline = chalk.white('Flutter & Opticore Toolkit');
+    const divider = chalk.gray('─────────────────────────');
+    return `${greeting}\n${divider}\n${logo}${ver}\n${tagline}`;
+}
+export const bannerBoxOptions = {
+    padding: { top: 1, bottom: 1, left: 3, right: 3 },
+    margin: { top: 1, bottom: 0, left: 1, right: 1 },
+    borderStyle: 'round',
+    borderColor: 'cyan',
+    textAlignment: 'center',
+};
+export const icons = {
+    success: chalk.green('✔'),
+    error: chalk.red('✖'),
+    warning: chalk.yellow('⚠'),
+    info: chalk.cyan('ℹ'),
+    arrow: chalk.cyan('→'),
+    dot: chalk.gray('·'),
+    star: chalk.yellow('★'),
+    rocket: '🚀',
+    package: '📦',
+    phone: '📱',
+    wrench: '🔧',
+    check: '✅',
+    cross: '❌',
+    clock: '⏱',
+};
+export const divider = chalk.gray('─'.repeat(50));
+export function sectionHeader(title) {
+    console.log();
+    console.log(chalk.cyan.bold(`  ${title}`));
+    console.log(chalk.gray(`  ${'─'.repeat(title.length + 4)}`));
+}

package/dist/utils/helpers/error.js

@@ -0,0 +1,14 @@
+import { LoggerHelpers } from "../services/logger.js";
+export { handleCommandError };
+/**
+ * Handles command errors with consistent formatting and exits the process.
+ * Replaces the repeated try-catch pattern across all command modules.
+ *
+ * @param error - The caught error (unknown type)
+ * @param context - Description of what was happening (e.g., "Error bumping version")
+ */
+function handleCommandError(error, context) {
+    const message = error instanceof Error ? error.message : String(error);
+    LoggerHelpers.error(`${context}: ${message}`);
+    process.exit(1);
+}

package/dist/utils/helpers/file.js

@@ -13,7 +13,7 @@ function createDirectories(modulePath, directories) {
 function writeFile(filePath, content) {
     fs.writeFileSync(filePath, content);
 }
-function getClassName(moduleName, type) {
+function getClassName(moduleName) {
     // Split module name by underscores and capitalize each part
     const defineItems = moduleName.split("_").filter(item => item.length > 0);
     let className = "";

package/dist/utils/helpers/version.js

@@ -1,6 +1,7 @@
 import fs from "fs";
 import path from "path";
 import { LoggerHelpers } from "../services/logger.js";
+import { PROJECT_PATHS } from "../../constants.js";
 export { parseVersion, incrementVersion, getCurrentVersion, getCurrentIosBuildNumber };
 /**
  * Parses a version string in format "X.Y.Z+B"
@@ -85,7 +86,7 @@ export function getNextBuildNumber() {
  */
 function getCurrentIosBuildNumber() {
     try {
-        const projectPbxProjPath = path.join(process.cwd(), "ios/Runner.xcodeproj/project.pbxproj");
+        const projectPbxProjPath = path.join(process.cwd(), PROJECT_PATHS.IOS_PROJECT_PBXPROJ);
         if (!fs.existsSync(projectPbxProjPath)) {
             LoggerHelpers.warning("iOS project.pbxproj not found. Defaulting to build number 1.");
             return 1;

package/dist/utils/services/backup.js

@@ -1,7 +1,8 @@
 import fs from "fs";
 import path from "path";
 import { LoggerHelpers } from "./logger.js";
-export { createBackup, restoreBackup, cleanupBackups, getBackupPath };
+import { BACKUP_CONFIG } from "../../constants.js";
+export { createBackup, createBackupWithCleanup, restoreBackup, cleanupBackups, getBackupPath };
 /**
  * Creates a backup of a file with timestamp
  * Returns the backup path if successful, null otherwise
@@ -30,6 +31,16 @@ function createBackup(filePath) {
         return null;
     }
 }
+/**
+ * Creates a backup and enforces retention cleanup in one call.
+ */
+function createBackupWithCleanup(filePath, retentionCount = BACKUP_CONFIG.RETENTION_COUNT) {
+    const backupPath = createBackup(filePath);
+    if (backupPath) {
+        cleanupBackups(path.dirname(filePath), retentionCount);
+    }
+    return backupPath;
+}
 /**
  * Restores a file from backup
  */

package/dist/utils/services/command.js

@@ -1,36 +1,4 @@
-import { validateFlutterProject, validateFlutterSdk, validateIosProject, validateAndroidProject } from "../validators/validation.js";
-export { validateBuildEnvironment, getFlutterCommand };
-/**
- * Performs common validation checks for commands
- * Exits with code 1 if any validation fails
- *
- * @param options - Validation options
- * @returns true if all validations pass (won't return false, exits instead)
- */
-function validateBuildEnvironment(options) {
-    const { requireFlutterProject = true, requireFlutterSdk = false, requireIosProject = false, requireAndroidProject = false, useFvm = false, } = options;
-    // Flutter project validation
-    if (requireFlutterProject && !validateFlutterProject()) {
-        process.exit(1);
-    }
-    // Flutter SDK validation (async)
-    if (requireFlutterSdk) {
-        validateFlutterSdk(useFvm).then((isValid) => {
-            if (!isValid) {
-                process.exit(1);
-            }
-        });
-    }
-    // iOS project validation
-    if (requireIosProject && !validateIosProject()) {
-        process.exit(1);
-    }
-    // Android project validation
-    if (requireAndroidProject && !validateAndroidProject()) {
-        process.exit(1);
-    }
-    return true;
-}
+export { getFlutterCommand };
 /**
  * Gets the appropriate Flutter command based on FVM usage
  *
@@ -44,7 +12,6 @@ function validateBuildEnvironment(options) {
  */
 function getFlutterCommand(baseCommand, useFvm) {
     if (useFvm) {
-        // Replace "flutter" with "fvm flutter"
         return baseCommand.replace(/^flutter\s/, "fvm flutter ");
     }
     return baseCommand;