helm-env-delta 1.7.1 → 1.7.2

package/README.md

@@ -642,7 +642,8 @@ hed --config <file> [options]  # Short alias
 | `--diff-json`               | Output JSON to stdout (pipe to jq)                 |
 | `--list-files`              | List source/destination files without processing   |
 | `--show-config`             | Display resolved config after inheritance          |
-| `--skip-format`             | Skip YAML formatting                               |
+| `--format-only`             | Format destination files without syncing           |
+| `--skip-format`             | Skip YAML formatting during sync                   |
 | `--no-color`                | Disable colored output (CI/accessibility)          |
 | `--verbose`                 | Show detailed debug info                           |
 | `--quiet`                   | Suppress output except errors                      |
@@ -679,6 +680,12 @@ hed --config config.yaml
 
 # Force override stop rules
 hed --config config.yaml --force
+
+# Format destination files only (no sync)
+hed --config config.yaml --format-only
+
+# Preview format changes
+hed --config config.yaml --format-only --dry-run
 ```
 
 ---
@@ -749,7 +756,7 @@ git push origin main
 
 ✅ **Flexibility** - Per-file patterns. Config inheritance. Regex transforms.
 
-✅ **Reliability** - 917 tests, 84% coverage. Battle-tested.
+✅ **Reliability** - 920 tests, 84% coverage. Battle-tested.
 
 ---
 

package/dist/commandLine.d.ts

@@ -6,6 +6,7 @@ export type SyncCommand = {
     diffHtml: boolean;
     diffJson: boolean;
     skipFormat: boolean;
+    formatOnly: boolean;
     validate: boolean;
     verbose: boolean;
     quiet: boolean;

package/dist/commandLine.js

@@ -19,6 +19,7 @@ const parseCommandLine = (argv) => {
         .option('--diff-html', 'Generate and open HTML diff report in browser', false)
         .option('--diff-json', 'Output diff as JSON to stdout', false)
         .option('--skip-format', 'Skip YAML formatting (outputFormat section)', false)
+        .option('--format-only', 'Format YAML files in destination without syncing', false)
         .option('--validate', 'Validate configuration file and exit', false)
         .option('--list-files', 'List files that would be synced without processing diffs', false)
         .option('--show-config', 'Display resolved configuration after inheritance and exit', false)
@@ -53,6 +54,10 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         console.error('Error: --verbose and --quiet flags are mutually exclusive');
         process.exit(1);
     }
+    if (options['formatOnly'] && options['skipFormat']) {
+        console.error('Error: --format-only and --skip-format flags are mutually exclusive');
+        process.exit(1);
+    }
     const threshold = Number.parseFloat(options['suggestThreshold']);
     if (Number.isNaN(threshold) || threshold < 0 || threshold > 1) {
         console.error('Error: --suggest-threshold must be a number between 0 and 1');
@@ -66,6 +71,7 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         diffHtml: options['diffHtml'],
         diffJson: options['diffJson'],
         skipFormat: options['skipFormat'],
+        formatOnly: options['formatOnly'],
         validate: options['validate'],
         listFiles: options['listFiles'],
         showConfig: options['showConfig'],

package/dist/fileLoader.d.ts

@@ -4,6 +4,7 @@ export interface FileLoaderOptions {
     include: string[];
     exclude: string[];
     transforms?: TransformConfig;
+    skipExclude?: boolean;
 }
 export type FileMap = Map<string, string>;
 export interface FileLoaderResult {

package/dist/fileLoader.js

@@ -67,10 +67,12 @@ const validateAndResolveBaseDirectory = async (baseDirectory) => {
         throw accessError;
     }
 };
-const findMatchingFiles = async (baseDirectory, includePatterns, excludePatterns, transforms) => {
+const findMatchingFiles = async (baseDirectory, includePatterns, excludePatterns, transforms, skipExclude) => {
     try {
         if (!transforms) {
-            const allPatterns = [...includePatterns, ...excludePatterns.map((pattern) => `!${pattern}`)];
+            const allPatterns = skipExclude
+                ? [...includePatterns]
+                : [...includePatterns, ...excludePatterns.map((pattern) => `!${pattern}`)];
             const matchedFiles = await (0, tinyglobby_1.glob)(allPatterns, {
                 cwd: baseDirectory,
                 absolute: true,
@@ -94,9 +96,11 @@ const findMatchingFiles = async (baseDirectory, includePatterns, excludePatterns
             const included = includePatterns.some((pattern) => patternMatcher_1.globalMatcher.match(transformedPath, pattern));
             if (!included)
                 continue;
-            const excluded = excludePatterns.some((pattern) => patternMatcher_1.globalMatcher.match(transformedPath, pattern));
-            if (excluded)
-                continue;
+            if (!skipExclude) {
+                const excluded = excludePatterns.some((pattern) => patternMatcher_1.globalMatcher.match(transformedPath, pattern));
+                if (excluded)
+                    continue;
+            }
             filtered.push(absolutePath);
         }
         return filtered;
@@ -153,7 +157,7 @@ const loadFiles = async (options, logger) => {
     const absoluteBaseDirectory = await validateAndResolveBaseDirectory(options.baseDirectory);
     const includePatterns = options.include ?? ['**/*'];
     const excludePatterns = options.exclude ?? [];
-    const files = await findMatchingFiles(absoluteBaseDirectory, includePatterns, excludePatterns, options.transforms);
+    const files = await findMatchingFiles(absoluteBaseDirectory, includePatterns, excludePatterns, options.transforms, options.skipExclude);
     if (logger?.shouldShow('debug')) {
         logger.debug('Glob matching:');
         logger.debug(`  Directory: ${absoluteBaseDirectory}`);

package/dist/index.js

@@ -37,6 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
 const node_os_1 = require("node:os");
 const node_path_1 = __importDefault(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
@@ -60,7 +61,9 @@ const stopRulesValidator_1 = require("./stopRulesValidator");
 const suggestionEngine_1 = require("./suggestionEngine");
 const collisionDetector_1 = require("./utils/collisionDetector");
 const filenameTransformer_1 = require("./utils/filenameTransformer");
+const fileType_1 = require("./utils/fileType");
 const versionChecker_1 = require("./utils/versionChecker");
+const yamlFormatter_1 = require("./yamlFormatter");
 const ZodError_1 = require("./ZodError");
 const main = async () => {
     const command = (0, commandLine_1.parseCommandLine)();
@@ -102,13 +105,15 @@ const main = async () => {
             baseDirectory: config.source,
             include: config.include,
             exclude: config.exclude,
-            transforms: config.transforms
+            transforms: config.transforms,
+            skipExclude: true
         }, logger);
         const sourceFiles = sourceResult.fileMap;
         const destinationResult = await (0, fileLoader_1.loadFiles)({
             baseDirectory: config.destination,
             include: config.include,
-            exclude: config.exclude
+            exclude: config.exclude,
+            skipExclude: true
         }, logger);
         const destinationFiles = destinationResult.fileMap;
         logger.progress(`Loaded ${sourceFiles.size} source, ${destinationFiles.size} destination file(s)`, 'success');
@@ -171,6 +176,46 @@ const main = async () => {
             console.log(`  ${chalk_1.default.dim(file)}`);
         return;
     }
+    if (command.formatOnly) {
+        if (!config.outputFormat) {
+            logger.log(chalk_1.default.yellow('\n⚠️  No outputFormat configured. Nothing to format.'));
+            return;
+        }
+        logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Formatting files...', 'info'));
+        let formattedCount = 0;
+        const errors = [];
+        for (const [relativePath, content] of destinationFiles) {
+            if (!(0, fileType_1.isYamlFile)(relativePath))
+                continue;
+            try {
+                const formatted = (0, yamlFormatter_1.formatYaml)(content, relativePath, config.outputFormat);
+                if (formatted !== content) {
+                    const absolutePath = node_path_1.default.join(config.destination, relativePath);
+                    if (command.dryRun)
+                        logger.fileOp('format', relativePath, true);
+                    else {
+                        await (0, promises_1.writeFile)(absolutePath, formatted, 'utf8');
+                        logger.fileOp('format', relativePath, false);
+                    }
+                    formattedCount++;
+                }
+            }
+            catch (error) {
+                errors.push({ path: relativePath, error: error });
+            }
+        }
+        if (command.dryRun)
+            logger.log(`\n[DRY RUN] Would format ${formattedCount} file(s)`);
+        else
+            logger.log(`\n✓ Formatted ${formattedCount} file(s)`);
+        if (errors.length > 0) {
+            logger.error(`\n❌ Encountered ${errors.length} error(s):`, 'critical');
+            for (const { path: errorPath, error } of errors)
+                logger.error(`  ${errorPath}: ${error.message}`, 'critical');
+            process.exit(1);
+        }
+        return;
+    }
     logger.log('\n' + (0, consoleFormatter_1.formatProgressMessage)('Computing differences...', 'info'));
     const diffResult = (0, fileDiff_1.computeFileDiff)(sourceFiles, destinationFiles, config, logger, originalPaths);
     if (logger.shouldShow('debug'))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helm-env-delta",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "HelmEnvDelta – environment-aware YAML delta and sync for GitOps",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -62,16 +62,16 @@
   },
   "devDependencies": {
     "@types/hogan.js": "^3.0.5",
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.0.10",
     "@types/picomatch": "^4.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.53.0",
-    "@typescript-eslint/parser": "^8.53.0",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
     "@vitest/coverage-v8": "^4.0.17",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unicorn": "^62.0.0",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.17"