helm-env-delta 1.8.0 → 1.9.0

package/README.md

@@ -38,6 +38,8 @@ HelmEnvDelta (`hed`) automates environment synchronization for GitOps workflows
 
 🎯 **Path Filtering** - Preserve environment-specific values (namespaces, replicas, secrets) that should never sync.
 
+📌 **Fixed Values** - Set specific fields to constant values regardless of source/destination. Enforce production settings like `debug: false` or `replicas: 3` after every sync.
+
 🔄 **Powerful Transforms** - Regex find/replace for both file content and paths. Load transforms from external YAML files for reusability. Change `uat-db.internal` → `prod-db.internal` automatically.
 
 🛡️ **Safety Rules** - Block major version upgrades, scaling violations, and forbidden patterns. Load validation rules from external files. Scan globally or target specific fields.
@@ -252,6 +254,21 @@ helm-env-delta --config example/5-external-files/config.yaml --dry-run --diff
 - Pattern files (`regexFile`, `regexFileKey`)
 - Global vs targeted regex validation
 
+### 📌 Example 6: Fixed Values
+
+Set specific fields to constant values regardless of source/destination. Perfect for enforcing production settings.
+
+```bash
+helm-env-delta --config example/6-fixed-values/config.yaml --dry-run --diff
+```
+
+**Features shown:**
+
+- Simple path fixed values (`debug: false`, `logLevel: warn`)
+- Nested paths (`spec.replicas`)
+- Array filter operators (`env[name=LOG_LEVEL].value`)
+- Combining with skipPath and transforms
+
 ---
 
 ## 💡 Smart Configuration Suggestions (Heuristic)
@@ -421,6 +438,50 @@ skipPath:
 
 ---
 
+### 📌 Fixed Values (fixedValues)
+
+Set specific JSONPath locations to constant values, regardless of source/destination values. Applied after merge, before formatting.
+
+```yaml
+fixedValues:
+  # Apply to all YAML files
+  '**/*.yaml':
+    - path: 'debug'
+      value: false
+    - path: 'logLevel'
+      value: 'warn'
+
+  # Specific file patterns
+  'deployment.yaml':
+    - path: 'spec.replicas'
+      value: 3
+    - path: 'spec.template.spec.containers[name=app].resources.limits.memory'
+      value: '512Mi'
+
+  # Array filter operators supported
+  'configmap.yaml':
+    - path: 'data.env[name=LOG_LEVEL].value'
+      value: 'info'
+    - path: 'data.env[name^=FEATURE_].value' # startsWith
+      value: 'stable'
+```
+
+**Supported filter operators:** `=` (equals), `^=` (startsWith), `$=` (endsWith), `*=` (contains) - updates ALL matching items
+
+**Value types:** String, number, boolean, null, object, array
+
+**Behavior:**
+
+- **Filter operators update ALL matching items** (e.g., `env[name^=LOG_]` updates every item starting with `LOG_`)
+- Applied during diff computation, so changes are visible in all reports (HTML, console, JSON)
+- Non-existent paths are silently skipped
+- Multiple rules for same path: last one wins
+- Works with skipPath (fixedValues applied after skipPath restoration)
+
+**Use cases:** Enforce production settings (`debug: false`), standardize resource limits, set mandatory environment variables, ensure consistent configuration across syncs.
+
+---
+
 ### 🔄 Transformations
 
 Regex find/replace for content and file paths. Load transforms from external files or define inline.
@@ -780,7 +841,7 @@ git push origin main
 
 ✅ **Flexibility** - Per-file patterns. Config inheritance. Regex transforms.
 
-✅ **Reliability** - 920 tests, 84% coverage. Battle-tested.
+✅ **Reliability** - 1150+ tests, 84% coverage. Battle-tested.
 
 ---
 

package/dist/configFile.d.ts

@@ -77,6 +77,10 @@ declare const arraySortRuleSchema: z.ZodObject<{
         desc: "desc";
     }>>;
 }, z.core.$strip>;
+declare const fixedValueRuleSchema: z.ZodObject<{
+    path: z.ZodString;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
 declare const transformRuleSchema: z.ZodObject<{
     find: z.ZodString;
     replace: z.ZodString;
@@ -159,6 +163,10 @@ declare const baseConfigSchema: z.ZodObject<{
             forbidden: "forbidden";
         }>>;
     }, z.core.$strict>], "type">>>>;
+    fixedValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        value: z.ZodUnknown;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 declare const finalConfigSchema: z.ZodObject<{
     transforms: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -208,6 +216,10 @@ declare const finalConfigSchema: z.ZodObject<{
             forbidden: "forbidden";
         }>>;
     }, z.core.$strict>], "type">>>>;
+    fixedValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        value: z.ZodUnknown;
+    }, z.core.$strip>>>>;
     include: z.ZodDefault<z.ZodArray<z.ZodString>>;
     exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
     prune: z.ZodDefault<z.ZodBoolean>;
@@ -242,6 +254,8 @@ export type TransformRule = z.infer<typeof transformRuleSchema>;
 export type TransformRules = z.infer<typeof transformRulesSchema>;
 export type TransformConfig = Record<string, TransformRules>;
 export type OutputFormat = BaseConfig['outputFormat'];
+export type FixedValueRule = z.infer<typeof fixedValueRuleSchema>;
+export type FixedValueConfig = Record<string, FixedValueRule[]>;
 export declare const parseBaseConfig: (data: unknown, configPath?: string) => BaseConfig;
 export declare const parseFinalConfig: (data: unknown, configPath?: string) => FinalConfig;
 export declare const parseConfig: (data: unknown, configPath?: string) => FinalConfig;

package/dist/configFile.js

@@ -75,6 +75,10 @@ const arraySortRuleSchema = zod_1.z.object({
     sortBy: zod_1.z.string().min(1),
     order: zod_1.z.enum(['asc', 'desc']).default('asc')
 });
+const fixedValueRuleSchema = zod_1.z.object({
+    path: zod_1.z.string().min(1).describe('JSONPath to the value to set'),
+    value: zod_1.z.unknown().describe('The constant value to set (any type: string, number, boolean, null, object, array)')
+});
 const transformRuleSchema = zod_1.z
     .object({
     find: zod_1.z.string().min(1).describe('Regex pattern to find'),
@@ -123,7 +127,8 @@ const baseConfigSchema = zod_1.z.object({
     })
         .optional(),
     transforms: zod_1.z.record(zod_1.z.string(), transformRulesSchema).optional(),
-    stopRules: zod_1.z.record(zod_1.z.string(), zod_1.z.array(stopRuleSchema)).optional()
+    stopRules: zod_1.z.record(zod_1.z.string(), zod_1.z.array(stopRuleSchema)).optional(),
+    fixedValues: zod_1.z.record(zod_1.z.string(), zod_1.z.array(fixedValueRuleSchema)).optional()
 });
 const finalConfigSchema = baseConfigSchema
     .omit({ extends: true })

package/dist/configWarnings.js

@@ -24,6 +24,18 @@ const validateConfigWarnings = (config) => {
         for (const [pattern, rules] of Object.entries(config.transforms))
             if ((rules.content?.length ?? 0) === 0 && (rules.filename?.length ?? 0) === 0)
                 warnings.push(`Transform pattern '${pattern}' has empty content and filename arrays (will have no effect)`);
+    if (config.fixedValues)
+        for (const [pattern, rules] of Object.entries(config.fixedValues))
+            if (rules.length === 0)
+                warnings.push(`fixedValues pattern '${pattern}' has empty array (will have no effect)`);
+    if (config.fixedValues && config.skipPath)
+        for (const [fixedPattern, fixedRules] of Object.entries(config.fixedValues))
+            for (const [skipPattern, skipPaths] of Object.entries(config.skipPath))
+                if (fixedPattern === skipPattern || fixedPattern === '**/*' || skipPattern === '**/*')
+                    for (const rule of fixedRules)
+                        for (const skipPath of skipPaths)
+                            if (rule.path === skipPath || rule.path.startsWith(skipPath + '.'))
+                                warnings.push(`fixedValues path '${rule.path}' overlaps with skipPath '${skipPath}' (fixedValues wins after skipPath restored)`);
     return {
         warnings,
         hasWarnings: warnings.length > 0

package/dist/fileDiff.d.ts

@@ -1,4 +1,4 @@
-import { Config, TransformConfig } from './configFile';
+import { Config, FixedValueConfig, TransformConfig } from './configFile';
 import { FileMap } from './fileLoader';
 export interface FileDiffResult {
     addedFiles: string[];
@@ -27,6 +27,7 @@ export interface ProcessYamlOptions {
     destinationContent: string;
     skipPath?: Record<string, string[]>;
     transforms?: TransformConfig;
+    fixedValues?: FixedValueConfig;
 }
 declare const FileDiffErrorClass: {
     new (message: string, options?: import("./utils/errors").ErrorOptions): {

package/dist/fileDiff.js

@@ -8,6 +8,7 @@ const yaml_1 = __importDefault(require("yaml"));
 const deepEqual_1 = require("./utils/deepEqual");
 const errors_1 = require("./utils/errors");
 const fileType_1 = require("./utils/fileType");
+const fixedValues_1 = require("./utils/fixedValues");
 const jsonPath_1 = require("./utils/jsonPath");
 const patternMatcher_1 = require("./utils/patternMatcher");
 const serialization_1 = require("./utils/serialization");
@@ -105,7 +106,7 @@ const getSkipPathsForFile = (filePath, skipPath) => {
 };
 exports.getSkipPathsForFile = getSkipPathsForFile;
 const processYamlFile = (options) => {
-    const { filePath, sourceContent, destinationContent, skipPath, transforms } = options;
+    const { filePath, sourceContent, destinationContent, skipPath, transforms, fixedValues } = options;
     let sourceParsed;
     let destinationParsed;
     try {
@@ -143,6 +144,9 @@ const processYamlFile = (options) => {
         throw parseError;
     }
     const sourceTransformed = (0, transformer_1.applyTransforms)(sourceParsed, filePath, transforms);
+    const fixedValueRules = (0, fixedValues_1.getFixedValuesForFile)(filePath, fixedValues);
+    if (fixedValueRules.length > 0)
+        (0, fixedValues_1.applyFixedValues)(sourceTransformed, fixedValueRules);
     const pathsToSkip = (0, exports.getSkipPathsForFile)(filePath, skipPath);
     const sourceFiltered = pathsToSkip.length > 0 ? applySkipPaths(sourceTransformed, pathsToSkip) : sourceTransformed;
     const destinationFiltered = pathsToSkip.length > 0 ? applySkipPaths(destinationParsed, pathsToSkip) : destinationParsed;
@@ -166,7 +170,7 @@ const processYamlFile = (options) => {
         parsedDest: destinationParsed
     };
 };
-const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms, originalPaths) => {
+const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms, fixedValues, originalPaths) => {
     const changedFiles = [];
     const unchangedFiles = [];
     for (const [path, sourceContent] of sourceFiles.entries()) {
@@ -181,7 +185,8 @@ const processChangedFiles = (sourceFiles, destinationFiles, skipPath, transforms
                 sourceContent,
                 destinationContent,
                 skipPath,
-                transforms
+                transforms,
+                fixedValues
             });
             if (changed) {
                 if (originalPath)
@@ -222,7 +227,7 @@ const computeFileDiff = (sourceFiles, destinationFiles, config, logger, original
     }
     const addedFiles = detectAddedFiles(sourceFiles, destinationFiles);
     const deletedFiles = config.prune ? detectDeletedFiles(sourceFiles, destinationFiles) : [];
-    const { changedFiles, unchangedFiles } = processChangedFiles(sourceFiles, destinationFiles, config.skipPath, config.transforms, originalPaths);
+    const { changedFiles, unchangedFiles } = processChangedFiles(sourceFiles, destinationFiles, config.skipPath, config.transforms, config.fixedValues, originalPaths);
     return { addedFiles, deletedFiles, changedFiles, unchangedFiles };
 };
 exports.computeFileDiff = computeFileDiff;

package/dist/fileUpdater.js

@@ -8,8 +8,10 @@ const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 const yaml_1 = __importDefault(require("yaml"));
 const consoleFormatter_1 = require("./consoleFormatter");
+const arrayMerger_1 = require("./utils/arrayMerger");
 const errors_1 = require("./utils/errors");
 const fileType_1 = require("./utils/fileType");
+const fixedValues_1 = require("./utils/fixedValues");
 const transformer_1 = require("./utils/transformer");
 const yamlFormatter_1 = require("./yamlFormatter");
 const FileUpdaterErrorClass = (0, errors_1.createErrorClass)('File Updater Error', {
@@ -61,15 +63,40 @@ const ensureParentDirectory = async (filePath) => {
         });
     }
 };
-const deepMerge = (fullTarget, filteredSource, filteredTarget) => {
+const deepMerge = (fullTarget, filteredSource, filteredTarget, currentPath = [], skipPaths = []) => {
     if (filteredSource === null || filteredSource === undefined)
         return fullTarget;
     if (fullTarget === null || fullTarget === undefined)
         return filteredSource;
     if (typeof fullTarget !== typeof filteredSource)
         return filteredSource;
-    if (Array.isArray(filteredSource))
-        return filteredSource;
+    if (Array.isArray(filteredSource)) {
+        const fullTargetArray = Array.isArray(fullTarget) ? fullTarget : [];
+        const filteredTargetArray = Array.isArray(filteredTarget) ? filteredTarget : [];
+        const applicableFilters = (0, arrayMerger_1.getApplicableArrayFilters)(currentPath, skipPaths);
+        if (applicableFilters.length === 0)
+            return filteredSource;
+        const hasNestedFilters = applicableFilters.some((f) => f.remainingPath.length > 0);
+        const result = [];
+        for (const sourceItem of filteredSource) {
+            if (hasNestedFilters && sourceItem && typeof sourceItem === 'object') {
+                const { matches, matchedFilter } = (0, arrayMerger_1.itemMatchesAnyFilter)(sourceItem, applicableFilters);
+                if (matches && matchedFilter && matchedFilter.remainingPath.length > 0) {
+                    const matchingTargetItem = (0, arrayMerger_1.findMatchingTargetItem)(sourceItem, fullTargetArray, applicableFilters);
+                    const matchingFilteredTargetItem = (0, arrayMerger_1.findMatchingTargetItem)(sourceItem, filteredTargetArray, applicableFilters);
+                    if (matchingTargetItem) {
+                        result.push(deepMerge(matchingTargetItem, sourceItem, matchingFilteredTargetItem, currentPath, skipPaths));
+                        continue;
+                    }
+                }
+            }
+            result.push(sourceItem);
+        }
+        for (const item of fullTargetArray)
+            if ((0, arrayMerger_1.shouldPreserveItem)(item, applicableFilters, result))
+                result.push(item);
+        return result;
+    }
     if (typeof filteredSource === 'object' && typeof fullTarget === 'object') {
         const sourceObject = filteredSource;
         const fullTargetObject = fullTarget;
@@ -80,12 +107,12 @@ const deepMerge = (fullTarget, filteredSource, filteredTarget) => {
                 result[key] = value;
         for (const [key, value] of Object.entries(sourceObject))
             if (key in fullTargetObject)
-                result[key] = deepMerge(fullTargetObject[key], value, filteredTargetObject[key]);
+                result[key] = deepMerge(fullTargetObject[key], value, filteredTargetObject[key], [...currentPath, key], skipPaths);
         return result;
     }
     return filteredSource;
 };
-const mergeYamlContent = (destinationContent, processedSourceContent, filteredDestinationContent, filePath) => {
+const mergeYamlContent = (destinationContent, processedSourceContent, filteredDestinationContent, filePath, skipPaths = []) => {
     let destinationParsed;
     try {
         destinationParsed = yaml_1.default.parse(destinationContent);
@@ -104,7 +131,7 @@ const mergeYamlContent = (destinationContent, processedSourceContent, filteredDe
     }
     let merged;
     try {
-        merged = deepMerge(destinationParsed, processedSourceContent, filteredDestinationContent);
+        merged = deepMerge(destinationParsed, processedSourceContent, filteredDestinationContent, [], skipPaths);
     }
     catch (error) {
         throw new FileUpdaterError('Failed to merge YAML content', {
@@ -136,6 +163,9 @@ const addFile = async (options) => {
         try {
             const parsed = yaml_1.default.parse(content);
             const transformed = (0, transformer_1.applyTransforms)(parsed, relativePath, config.transforms);
+            const fixedValueRules = (0, fixedValues_1.getFixedValuesForFile)(relativePath, config.fixedValues);
+            if (fixedValueRules.length > 0)
+                (0, fixedValues_1.applyFixedValues)(transformed, fixedValueRules);
             contentToWrite = yaml_1.default.stringify(transformed);
             const effectiveOutputFormat = skipFormat ? undefined : config.outputFormat;
             contentToWrite = (0, yamlFormatter_1.formatYaml)(contentToWrite, relativePath, effectiveOutputFormat);
@@ -168,9 +198,15 @@ const updateFile = async (options) => {
         return;
     }
     let contentToWrite = (0, fileType_1.isYamlFile)(changedFile.path)
-        ? mergeYamlContent(changedFile.destinationContent, changedFile.rawParsedSource, changedFile.rawParsedDest, changedFile.path)
+        ? mergeYamlContent(changedFile.destinationContent, changedFile.rawParsedSource, changedFile.rawParsedDest, changedFile.path, changedFile.skipPaths)
         : changedFile.sourceContent;
     if ((0, fileType_1.isYamlFile)(changedFile.path)) {
+        const fixedValueRules = (0, fixedValues_1.getFixedValuesForFile)(changedFile.path, config.fixedValues);
+        if (fixedValueRules.length > 0) {
+            const parsed = yaml_1.default.parse(contentToWrite);
+            (0, fixedValues_1.applyFixedValues)(parsed, fixedValueRules);
+            contentToWrite = yaml_1.default.stringify(parsed);
+        }
         const effectiveOutputFormat = skipFormat ? undefined : config.outputFormat;
         contentToWrite = (0, yamlFormatter_1.formatYaml)(contentToWrite, changedFile.path, effectiveOutputFormat);
     }

package/dist/htmlReporter.js

@@ -9,10 +9,8 @@ const promises_1 = require("node:fs/promises");
 const node_os_1 = require("node:os");
 const node_path_1 = __importDefault(require("node:path"));
 const diff2html_1 = require("diff2html");
-const yaml_1 = __importDefault(require("yaml"));
 const browserLauncher_1 = require("./reporters/browserLauncher");
 const htmlTemplate_1 = require("./reporters/htmlTemplate");
-const arrayDiffProcessor_1 = require("./utils/arrayDiffProcessor");
 const diffGenerator_1 = require("./utils/diffGenerator");
 const errors_1 = require("./utils/errors");
 const fileType_1 = require("./utils/fileType");
@@ -33,103 +31,29 @@ const generateTemporaryFilePath = () => {
     const filename = `helm-env-delta-${timestamp}-${randomName}.html`;
     return node_path_1.default.join((0, node_os_1.tmpdir)(), filename);
 };
-const escapeHtml = (text) => text
-    .replaceAll('&', '&')
-    .replaceAll('<', '&lt;')
-    .replaceAll('>', '&gt;')
-    .replaceAll('"', '&quot;')
-    .replaceAll("'", '&#039;');
 const DIFF2HTML_OPTIONS = {
     drawFileList: false,
     matching: 'lines',
     outputFormat: 'side-by-side'
 };
 const generateDiffHtml = (unifiedDiff) => (0, diff2html_1.html)(unifiedDiff, DIFF2HTML_OPTIONS);
-const generateArrayDiffHtml = (change) => {
-    let html = '<div class="array-diff">';
-    if (change.removed.length > 0) {
-        html += '<div class="removed-items">';
-        html += `<h4>Removed (${change.removed.length})</h4>`;
-        html += '<ul>';
-        for (const item of change.removed) {
-            const yaml = yaml_1.default.stringify(item, { indent: 2 });
-            html += `<li class="removed"><pre>${escapeHtml(yaml)}</pre></li>`;
-        }
-        html += '</ul></div>';
-    }
-    if (change.added.length > 0) {
-        html += '<div class="added-items">';
-        html += `<h4>Added (${change.added.length})</h4>`;
-        html += '<ul>';
-        for (const item of change.added) {
-            const yaml = yaml_1.default.stringify(item, { indent: 2 });
-            html += `<li class="added"><pre>${escapeHtml(yaml)}</pre></li>`;
-        }
-        html += '</ul></div>';
-    }
-    if (change.unchanged.length > 0)
-        html += `<div class="unchanged-count">Unchanged: ${change.unchanged.length} items</div>`;
-    html += '</div>';
-    return html;
-};
 const generateFileSummary = (file) => {
     if (!file.originalPath)
         return file.path;
     return `<span class="filename-transform">${file.originalPath} → ${file.path}</span>`;
 };
-const generateChangedFileSection = (file) => {
+const generateChangedFileSection = (file, fileId) => {
     const isYaml = (0, fileType_1.isYamlFile)(file.path);
     const summary = generateFileSummary(file);
-    if (!isYaml) {
-        const destinationContent = (0, serialization_1.serializeForDiff)(file.processedDestContent, false);
-        const sourceContent = (0, serialization_1.serializeForDiff)(file.processedSourceContent, false);
-        const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
-        const diffHtml = generateDiffHtml(unifiedDiff);
-        return `
-    <details class="file-section" open>
-      <summary>${summary}</summary>
-      <div class="diff-container">
-        ${diffHtml}
-      </div>
-    </details>
-  `;
-    }
-    const arrayInfo = (0, arrayDiffProcessor_1.detectArrayChanges)(file);
-    if (!arrayInfo.hasArrays) {
-        const destinationContent = (0, serialization_1.serializeForDiff)(file.processedDestContent, true);
-        const sourceContent = (0, serialization_1.serializeForDiff)(file.processedSourceContent, true);
-        const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
-        const diffHtml = generateDiffHtml(unifiedDiff);
-        return `
-    <details class="file-section" open>
-      <summary>${summary}</summary>
-      <div class="diff-container">
-        ${diffHtml}
-      </div>
-    </details>
-  `;
-    }
-    const destinationContent = (0, serialization_1.serializeForDiff)(file.processedDestContent, true);
-    const sourceContent = (0, serialization_1.serializeForDiff)(file.processedSourceContent, true);
+    const destinationContent = (0, serialization_1.serializeForDiff)(file.processedDestContent, isYaml);
+    const sourceContent = (0, serialization_1.serializeForDiff)(file.processedSourceContent, isYaml);
     const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
     const diffHtml = generateDiffHtml(unifiedDiff);
-    let arrayDiffsHtml = '';
-    if (arrayInfo.hasChanges) {
-        arrayDiffsHtml = '<details class="array-details"><summary>Array-specific details:</summary>';
-        for (const change of arrayInfo.changes) {
-            const pathString = change.path.join('.');
-            arrayDiffsHtml += `<div class="array-section"><h4>${pathString}:</h4>`;
-            arrayDiffsHtml += generateArrayDiffHtml(change);
-            arrayDiffsHtml += '</div>';
-        }
-        arrayDiffsHtml += '</details>';
-    }
     return `
-    <details class="file-section" open>
+    <details class="file-section" id="${fileId}" data-file-id="${fileId}" open>
       <summary>${summary}</summary>
       <div class="diff-container">
         ${diffHtml}
-        ${arrayDiffsHtml}
       </div>
     </details>
   `;
@@ -163,8 +87,11 @@ const generateHtmlReport = async (diffResult, formattedFiles, config, dryRun, lo
     };
     const formattedSet = new Set(formattedFiles);
     const trulyUnchangedFiles = diffResult.unchangedFiles.filter((file) => !formattedSet.has(file));
-    const changedSections = diffResult.changedFiles.map((file) => generateChangedFileSection(file));
-    const htmlContent = (0, htmlTemplate_1.generateHtmlTemplate)(diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections);
+    const changedFileIds = new Map();
+    for (const [index, file] of diffResult.changedFiles.entries())
+        changedFileIds.set(file.path, `file-${index}`);
+    const changedSections = diffResult.changedFiles.map((file, index) => generateChangedFileSection(file, `file-${index}`));
+    const htmlContent = (0, htmlTemplate_1.generateHtmlTemplate)(diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds);
     await writeHtmlFile(htmlContent, reportPath);
     logger?.log(`✓ HTML report generated: ${reportPath}, opening in browser...`);
     try {

package/dist/patternUsageValidator.d.ts

@@ -5,7 +5,7 @@ export interface PatternUsageResult {
     hasWarnings: boolean;
 }
 export interface PatternUsageWarning {
-    type: 'unused-exclude' | 'unused-skipPath' | 'unused-skipPath-jsonpath' | 'unused-stopRule-glob' | 'unused-stopRule-path';
+    type: 'unused-exclude' | 'unused-skipPath' | 'unused-skipPath-jsonpath' | 'unused-stopRule-glob' | 'unused-stopRule-path' | 'unused-fixedValues' | 'unused-fixedValues-jsonpath';
     pattern: string;
     message: string;
     context?: string;

package/dist/patternUsageValidator.js

@@ -11,7 +11,8 @@ const validatePatternUsage = (config, sourceFiles, destinationFiles) => {
     const warnings = [
         ...validateExcludePatterns(config, sourceFiles, destinationFiles),
         ...validateSkipPathPatterns(config, sourceFiles, destinationFiles),
-        ...validateStopRulePatterns(config, sourceFiles, destinationFiles)
+        ...validateStopRulePatterns(config, sourceFiles, destinationFiles),
+        ...validateFixedValuesPatterns(config, sourceFiles, destinationFiles)
     ];
     return {
         warnings,
@@ -99,6 +100,38 @@ const validateStopRulePatterns = (config, sourceFiles, destinationFiles) => {
     return warnings;
 };
 const hasPathField = (rule) => 'path' in rule && typeof rule.path === 'string';
+const validateFixedValuesPatterns = (config, sourceFiles, destinationFiles) => {
+    const warnings = [];
+    if (!config.fixedValues)
+        return warnings;
+    const allFiles = new Set([...sourceFiles.keys(), ...destinationFiles.keys()]);
+    for (const [pattern, rules] of Object.entries(config.fixedValues)) {
+        const matchedFiles = [...allFiles].filter((filePath) => patternMatcher_1.globalMatcher.match(filePath, pattern));
+        if (matchedFiles.length === 0) {
+            warnings.push({
+                type: 'unused-fixedValues',
+                pattern,
+                message: `fixedValues pattern '${pattern}' matches no files`,
+                context: `${rules.length} rule(s) defined`
+            });
+            continue;
+        }
+        const yamlFiles = matchedFiles.filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'));
+        if (yamlFiles.length === 0)
+            continue;
+        for (const rule of rules) {
+            const pathExistsInAny = validateJsonPathInFiles(rule.path, yamlFiles, sourceFiles, destinationFiles);
+            if (!pathExistsInAny)
+                warnings.push({
+                    type: 'unused-fixedValues-jsonpath',
+                    pattern,
+                    message: `fixedValues JSONPath '${rule.path}' not found in any matched files`,
+                    context: `Pattern: ${pattern}, matches ${yamlFiles.length} file(s)`
+                });
+        }
+    }
+    return warnings;
+};
 const pathCouldMatch = (object, pathParts) => {
     let current = object;
     for (const part of pathParts) {

package/dist/reporters/htmlStyles.d.ts

@@ -1,2 +1,2 @@
-export declare const HTML_STYLES = "\n  /* Custom styles */\n  body {\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    margin: 0;\n    padding: 20px;\n    background: #f6f8fa;\n  }\n\n  header {\n    background: white;\n    padding: 20px;\n    border-radius: 6px;\n    margin-bottom: 20px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  h1 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n  }\n\n  .metadata {\n    display: flex;\n    gap: 20px;\n    margin: 10px 0;\n    color: #586069;\n    font-size: 14px;\n  }\n\n  .dry-run-badge {\n    display: inline-block;\n    padding: 4px 8px;\n    background: #cfe2ff;\n    color: #084298;\n    border-radius: 4px;\n    font-weight: bold;\n    font-size: 12px;\n  }\n\n  .summary {\n    display: flex;\n    gap: 12px;\n    margin: 15px 0;\n  }\n\n  .stat {\n    padding: 8px 16px;\n    border-radius: 6px;\n    font-weight: 600;\n    font-size: 14px;\n  }\n\n  .stat.added { background: #d4edda; color: #155724; }\n  .stat.changed { background: #fff3cd; color: #856404; }\n  .stat.deleted { background: #f8d7da; color: #721c24; }\n  .stat.formatted { background: #d1ecf1; color: #0c5460; }\n  .stat.unchanged { background: #e2e3e5; color: #383d41; }\n\n  .tabs {\n    display: flex;\n    background: white;\n    border-radius: 6px 6px 0 0;\n    border-bottom: 1px solid #d0d7de;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab {\n    padding: 12px 24px;\n    border: none;\n    background: transparent;\n    cursor: pointer;\n    font-size: 14px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .tab:hover {\n    color: #24292e;\n  }\n\n  .tab.active {\n    border-bottom: 2px solid #0969da;\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  main {\n    background: white;\n    padding: 20px;\n    border-radius: 0 0 6px 6px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab-content {\n    display: none;\n  }\n\n  .tab-content.active {\n    display: block;\n  }\n\n  .file-section {\n    margin: 12px 0;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n  }\n\n  .file-section summary {\n    padding: 12px 16px;\n    background: #f6f8fa;\n    cursor: pointer;\n    font-weight: 600;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #24292e;\n  }\n\n  .file-section summary:hover {\n    background: #eaeef2;\n  }\n\n  .filename-transform {\n    color: #0969da;\n  }\n\n  .diff-container {\n    padding: 0;\n  }\n\n  /* Hide diff2html file header with rename badge */\n  .d2h-file-header {\n    display: none;\n  }\n\n  .file-list {\n    margin: 20px 0;\n  }\n\n  .file-list ul {\n    list-style: none;\n    padding: 0;\n    margin: 10px 0;\n  }\n\n  .file-list li {\n    padding: 8px 16px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #586069;\n    border-bottom: 1px solid #f6f8fa;\n  }\n\n  .file-list li:hover {\n    background: #f6f8fa;\n  }\n\n  .array-details {\n    margin: 20px 0;\n    background: #f6f8fa;\n    border-radius: 6px;\n    border-left: 3px solid #0969da;\n  }\n\n  .array-details summary {\n    padding: 12px 15px;\n    cursor: pointer;\n    color: #0969da;\n    font-size: 13px;\n    font-weight: 600;\n  }\n\n  .array-details summary:hover {\n    background: #eaeef2;\n  }\n\n  .array-details > .array-section {\n    margin: 0 15px 15px 15px;\n  }\n\n  .array-section {\n    margin: 15px 0;\n    padding: 10px;\n    background: white;\n    border-radius: 4px;\n    border: 1px solid #d0d7de;\n  }\n\n  .array-section h4 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n    font-size: 14px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n  }\n\n  .array-unchanged {\n    padding: 8px;\n    color: #586069;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .added-items, .removed-items {\n    margin: 10px 0;\n  }\n\n  .added-items h4 {\n    color: #1a7f37;\n    margin: 0 0 8px 0;\n    font-size: 13px;\n  }\n\n  .removed-items h4 {\n    color: #cf222e;\n    margin: 0 0 8px 0;\n    font-size: 13px;\n  }\n\n  .added-items ul, .removed-items ul {\n    list-style: none;\n    padding: 0;\n    margin: 0;\n  }\n\n  .added-items li {\n    padding: 6px 10px;\n    background: #dafbe1;\n    border-left: 3px solid #1a7f37;\n    margin: 4px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .removed-items li {\n    padding: 6px 10px;\n    background: #ffebe9;\n    border-left: 3px solid #cf222e;\n    margin: 4px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 12px;\n  }\n\n  .added-items pre, .removed-items pre {\n    margin: 0;\n    white-space: pre-wrap;\n    word-wrap: break-word;\n  }\n\n  .unchanged-count {\n    padding: 8px 10px;\n    color: #586069;\n    font-size: 12px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    background: #f6f8fa;\n    border-radius: 4px;\n    margin: 10px 0;\n  }\n";
-export declare const TAB_SCRIPT = "\n  // Tab switching\n  document.querySelectorAll('.tab').forEach(tab => {\n    tab.addEventListener('click', () => {\n      const tabName = tab.getAttribute('data-tab');\n\n      // Update tabs\n      document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));\n      tab.classList.add('active');\n\n      // Update content\n      document.querySelectorAll('.tab-content').forEach(content => {\n        content.classList.remove('active');\n      });\n      document.getElementById(tabName).classList.add('active');\n    });\n  });\n";
+export declare const HTML_STYLES = "\n  /* Custom styles */\n  body {\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    margin: 0;\n    padding: 20px;\n    background: #f6f8fa;\n  }\n\n  header {\n    background: white;\n    padding: 20px;\n    border-radius: 6px;\n    margin-bottom: 20px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  h1 {\n    margin: 0 0 10px 0;\n    color: #24292e;\n  }\n\n  .metadata {\n    display: flex;\n    gap: 20px;\n    margin: 10px 0;\n    color: #586069;\n    font-size: 14px;\n  }\n\n  .dry-run-badge {\n    display: inline-block;\n    padding: 4px 8px;\n    background: #cfe2ff;\n    color: #084298;\n    border-radius: 4px;\n    font-weight: bold;\n    font-size: 12px;\n  }\n\n  .summary {\n    display: flex;\n    gap: 12px;\n    margin: 15px 0;\n  }\n\n  .stat {\n    padding: 8px 16px;\n    border-radius: 6px;\n    font-weight: 600;\n    font-size: 14px;\n  }\n\n  .stat.added { background: #d4edda; color: #155724; }\n  .stat.changed { background: #fff3cd; color: #856404; }\n  .stat.deleted { background: #f8d7da; color: #721c24; }\n  .stat.formatted { background: #d1ecf1; color: #0c5460; }\n  .stat.unchanged { background: #e2e3e5; color: #383d41; }\n\n  .tabs {\n    display: flex;\n    background: white;\n    border-radius: 6px 6px 0 0;\n    border-bottom: 1px solid #d0d7de;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab {\n    padding: 12px 24px;\n    border: none;\n    background: transparent;\n    cursor: pointer;\n    font-size: 14px;\n    color: #586069;\n    transition: all 0.2s;\n  }\n\n  .tab:hover {\n    color: #24292e;\n  }\n\n  .tab.active {\n    border-bottom: 2px solid #0969da;\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  main {\n    background: white;\n    padding: 20px;\n    border-radius: 0 0 6px 6px;\n    box-shadow: 0 1px 3px rgba(0,0,0,0.12);\n  }\n\n  .tab-content {\n    display: none;\n  }\n\n  .tab-content.active {\n    display: block;\n  }\n\n  .file-section {\n    margin: 12px 0;\n    border: 1px solid #d0d7de;\n    border-radius: 6px;\n  }\n\n  .file-section summary {\n    padding: 12px 16px;\n    background: #f6f8fa;\n    cursor: pointer;\n    font-weight: 600;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #24292e;\n  }\n\n  .file-section summary:hover {\n    background: #eaeef2;\n  }\n\n  .filename-transform {\n    color: #0969da;\n  }\n\n  .diff-container {\n    padding: 0;\n  }\n\n  /* Hide diff2html file header with rename badge */\n  .d2h-file-header {\n    display: none;\n  }\n\n  .file-list {\n    margin: 20px 0;\n  }\n\n  .file-list ul {\n    list-style: none;\n    padding: 0;\n    margin: 10px 0;\n  }\n\n  .file-list li {\n    padding: 8px 16px;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n    color: #586069;\n    border-bottom: 1px solid #f6f8fa;\n  }\n\n  .file-list li:hover {\n    background: #f6f8fa;\n  }\n\n  /* Treeview styles */\n  .tree-root {\n    list-style: none;\n    padding: 0;\n    margin: 10px 0;\n    font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n    font-size: 13px;\n  }\n\n  .tree-root ul {\n    list-style: none;\n    padding-left: 20px;\n    margin: 0;\n  }\n\n  .tree-folder,\n  .tree-file {\n    padding: 4px 8px;\n    border-radius: 4px;\n    cursor: default;\n  }\n\n  .tree-folder:hover,\n  .tree-file:hover {\n    background: #f6f8fa;\n  }\n\n  .tree-toggle {\n    display: inline-block;\n    width: 16px;\n    cursor: pointer;\n    color: #586069;\n    font-size: 10px;\n    user-select: none;\n  }\n\n  .tree-folder.collapsed > .tree-toggle {\n    transform: rotate(-90deg);\n  }\n\n  .tree-folder.collapsed > .tree-children {\n    display: none;\n  }\n\n  .tree-folder-name {\n    color: #0969da;\n    font-weight: 500;\n  }\n\n  .tree-file-name {\n    color: #586069;\n    padding-left: 16px;\n  }\n\n  /* Sidebar styles */\n  .sidebar-container {\n    display: flex;\n    gap: 0;\n  }\n\n  .sidebar {\n    width: 280px;\n    min-width: 280px;\n    border-right: 1px solid #d0d7de;\n    background: #f6f8fa;\n    transition: width 0.2s, min-width 0.2s, padding 0.2s, opacity 0.2s;\n  }\n\n  .sidebar.collapsed {\n    width: 0;\n    min-width: 0;\n    padding: 0;\n    overflow: hidden;\n    border-right: none;\n  }\n\n  .sidebar-header {\n    display: flex;\n    justify-content: space-between;\n    align-items: center;\n    padding: 12px 16px;\n    border-bottom: 1px solid #d0d7de;\n    background: #fff;\n    font-weight: 600;\n    font-size: 14px;\n    color: #24292e;\n    position: sticky;\n    top: 0;\n    z-index: 1;\n  }\n\n  .sidebar-toggle {\n    background: none;\n    border: 1px solid #d0d7de;\n    border-radius: 4px;\n    cursor: pointer;\n    padding: 4px 8px;\n    color: #586069;\n    font-size: 12px;\n  }\n\n  .sidebar-toggle:hover {\n    background: #f6f8fa;\n    color: #24292e;\n  }\n\n  .sidebar-content {\n    padding: 8px;\n  }\n\n  .sidebar-tree .tree-file-link {\n    color: #586069;\n    text-decoration: none;\n    padding-left: 16px;\n    display: block;\n  }\n\n  .sidebar-tree .tree-file-link:hover {\n    color: #0969da;\n  }\n\n  .sidebar-tree .tree-file.active .tree-file-link {\n    color: #0969da;\n    font-weight: 600;\n  }\n\n  .changed-content {\n    flex: 1;\n    min-width: 0;\n    padding-left: 20px;\n  }\n\n  .sidebar-expand-btn {\n    display: none;\n    position: fixed;\n    left: 0;\n    top: 50%;\n    transform: translateY(-50%);\n    background: #f6f8fa;\n    border: 1px solid #d0d7de;\n    border-left: none;\n    border-radius: 0 4px 4px 0;\n    padding: 8px 4px;\n    cursor: pointer;\n    color: #586069;\n    z-index: 100;\n  }\n\n  .sidebar-expand-btn:hover {\n    background: #eaeef2;\n    color: #24292e;\n  }\n\n  .sidebar.collapsed ~ .sidebar-expand-btn {\n    display: block;\n  }\n";
+export declare const TAB_SCRIPT: string;