helm-env-delta 1.9.2 → 1.10.0

package/README.md

@@ -56,7 +56,7 @@ HelmEnvDelta (`hed`) automates environment synchronization for GitOps workflows
 
 📊 **Multiple Reports** - Console, HTML (visual), and JSON (CI/CD) output formats.
 
-🔍 **Discovery Tools** - Preview files (`--list-files`), inspect config (`--show-config`), validate with comprehensive warnings including unused pattern detection.
+🔍 **Discovery Tools** - Preview files (`-l`), inspect config (`--show-config`), filter by filename/content (`-f`), filter by change type (`-m`), validate with comprehensive warnings including unused pattern detection.
 
 💡 **Smart Suggestions** - Heuristic analysis (`--suggest`) detects patterns and recommends transforms and stop rules automatically. Control sensitivity with `--suggest-threshold`.
 
@@ -102,28 +102,28 @@ transforms:
 ### 2️⃣ Preview Changes
 
 ```bash
-helm-env-delta --config config.yaml --dry-run --diff
+hed -c config.yaml -D -d
 ```
 
 ### 3️⃣ Execute Sync
 
 ```bash
-helm-env-delta --config config.yaml
+hed -c config.yaml
 ```
 
 ### 4️⃣ Review in Browser
 
 ```bash
-helm-env-delta --config config.yaml --diff-html
+hed -c config.yaml -H
 ```
 
 ### 5️⃣ Get Smart Suggestions (Optional)
 
 ```bash
-helm-env-delta --config config.yaml --suggest
+hed -c config.yaml --suggest
 
 # Control suggestion sensitivity (0-1, default: 0.3)
-helm-env-delta --config config.yaml --suggest --suggest-threshold 0.7
+hed -c config.yaml --suggest --suggest-threshold 0.7
 ```
 
 Analyzes differences and suggests transforms and stop rules automatically with configurable confidence filtering.
@@ -281,6 +281,28 @@ helm-env-delta --config example/6-fixed-values/config.yaml --dry-run --diff
 - Array filter operators (`env[name=LOG_LEVEL].value`)
 - Combining with skipPath and transforms
 
+### 🎨 Example 7: Format-Only Mode
+
+Format YAML files without syncing. No source directory required - perfect for standardizing existing files.
+
+```bash
+# Preview which files would be formatted
+helm-env-delta --config example/7-format-only/config.yaml --format-only --list-files
+
+# Preview formatting changes
+helm-env-delta --config example/7-format-only/config.yaml --format-only --dry-run
+
+# Apply formatting
+helm-env-delta --config example/7-format-only/config.yaml --format-only
+```
+
+**Features shown:**
+
+- Format-only mode (no source required)
+- Combining `--format-only` with `--list-files` to preview files
+- Key ordering, array sorting, indentation standardization
+- Minimal config for formatting existing files
+
 ---
 
 ## 💡 Smart Configuration Suggestions (Heuristic)
@@ -647,7 +669,7 @@ Standardize YAML across all environments.
 ```yaml
 outputFormat:
   indent: 2 # Indentation size
-  keySeparator: true # Blank line between top-level keys
+  keySeparator: true # Blank line between top-level keys (or second-level keys when single top-level key)
 
   keyOrders: # Custom key ordering
     'apps/*.yaml':
@@ -731,63 +753,80 @@ hed --config <file> [options]  # Short alias
 
 ### Options
 
-| Flag                        | Description                                         |
-| --------------------------- | --------------------------------------------------- |
-| `--config <path>`           | **Required** - Configuration file                   |
-| `--validate`                | Validate config and pattern usage (shows warnings)  |
-| `--suggest`                 | Analyze differences and suggest config updates      |
-| `--suggest-threshold <0-1>` | Minimum confidence for suggestions (default: 0.3)   |
-| `--dry-run`                 | Preview changes without writing files               |
-| `--force`                   | Override stop rules                                 |
-| `--diff`                    | Show console diff                                   |
-| `--diff-html`               | Generate HTML report (opens in browser)             |
-| `--diff-json`               | Output JSON to stdout (pipe to jq)                  |
-| `--list-files`              | List source/destination files without processing    |
-| `--show-config`             | Display resolved config after inheritance           |
-| `--format-only`             | Format destination files only (source not required) |
-| `--skip-format`             | Skip YAML formatting during sync                    |
-| `--no-color`                | Disable colored output (CI/accessibility)           |
-| `--verbose`                 | Show detailed debug info                            |
-| `--quiet`                   | Suppress output except errors                       |
+| Flag                        | Short | Description                                                         |
+| --------------------------- | ----- | ------------------------------------------------------------------- |
+| `--config <path>`           | `-c`  | **Required** - Configuration file                                   |
+| `--validate`                |       | Validate config and pattern usage (shows warnings)                  |
+| `--suggest`                 |       | Analyze differences and suggest config updates                      |
+| `--suggest-threshold <0-1>` |       | Minimum confidence for suggestions (default: 0.3)                   |
+| `--dry-run`                 | `-D`  | Preview changes without writing files                               |
+| `--force`                   |       | Override stop rules                                                 |
+| `--diff`                    | `-d`  | Show console diff                                                   |
+| `--diff-html`               | `-H`  | Generate HTML report (opens in browser)                             |
+| `--diff-json`               | `-J`  | Output JSON to stdout (pipe to jq)                                  |
+| `--list-files`              | `-l`  | List files without processing (takes precedence over --format-only) |
+| `--show-config`             |       | Display resolved config after inheritance                           |
+| `--format-only`             |       | Format destination files only (source not required)                 |
+| `--skip-format`             | `-S`  | Skip YAML formatting during sync                                    |
+| `--filter <string>`         | `-f`  | Filter files by filename or content (case-insensitive)              |
+| `--mode <type>`             | `-m`  | Filter by change type: new, modified, deleted, all (default: all)   |
+| `--no-color`                |       | Disable colored output (CI/accessibility)                           |
+| `--verbose`                 |       | Show detailed debug info                                            |
+| `--quiet`                   |       | Suppress output except errors                                       |
 
 ### Examples
 
 ```bash
 # Validate configuration (shows warnings)
-hed --config config.yaml --validate
+hed -c config.yaml --validate
 
 # Get smart configuration suggestions
-hed --config config.yaml --suggest
+hed -c config.yaml --suggest
 
 # Get only high-confidence suggestions
-hed --config config.yaml --suggest --suggest-threshold 0.7
+hed -c config.yaml --suggest --suggest-threshold 0.7
 
 # Preview files that will be synced
-hed --config config.yaml --list-files
+hed -c config.yaml -l
 
 # Display resolved config (after inheritance)
-hed --config config.yaml --show-config
+hed -c config.yaml --show-config
 
 # Preview with diff
-hed --config config.yaml --dry-run --diff
+hed -c config.yaml -D -d
 
 # Visual HTML report
-hed --config config.yaml --diff-html
+hed -c config.yaml -H
 
 # CI/CD integration (no colors)
-hed --config config.yaml --diff-json --no-color | jq '.summary'
+hed -c config.yaml -J --no-color | jq '.summary'
 
 # Execute sync
-hed --config config.yaml
+hed -c config.yaml
 
 # Force override stop rules
-hed --config config.yaml --force
+hed -c config.yaml --force
+
+# Filter to only process files matching 'prod'
+hed -c config.yaml -f prod -d
+
+# Sync only new files
+hed -c config.yaml -m new
+
+# Preview modified files only
+hed -c config.yaml -m modified -D -d
+
+# Combine filter and mode
+hed -c config.yaml -f deployment -m modified -D -d
 
 # Format destination files only (no sync, source not required in config)
-hed --config config.yaml --format-only
+hed -c config.yaml --format-only
 
 # Preview format changes
-hed --config config.yaml --format-only --dry-run
+hed -c config.yaml --format-only -D
+
+# List files that would be formatted (--list-files takes precedence)
+hed -c config.yaml --format-only -l
 
 # Format-only config example (no source needed):
 # destination: './prod'
@@ -816,13 +855,13 @@ flowchart LR
 
 ```bash
 # 1. Preview changes
-hed --config config.yaml --dry-run --diff
+hed -c config.yaml -D -d
 
 # 2. Review in browser
-hed --config config.yaml --diff-html
+hed -c config.yaml -H
 
 # 3. Execute sync
-hed --config config.yaml
+hed -c config.yaml
 
 # 4. Git workflow
 git add prod/

package/dist/commandLine.d.ts

@@ -1,3 +1,4 @@
+export type ChangeMode = 'new' | 'modified' | 'deleted' | 'all';
 export type SyncCommand = {
     config: string;
     dryRun: boolean;
@@ -15,5 +16,7 @@ export type SyncCommand = {
     noColor: boolean;
     suggest: boolean;
     suggestThreshold: number;
+    filter?: string;
+    mode: ChangeMode;
 };
 export declare const parseCommandLine: (argv?: string[]) => SyncCommand;

package/dist/commandLine.js

@@ -13,19 +13,21 @@ const parseCommandLine = (argv) => {
         .description('Environment-aware YAML delta and sync for GitOps workflows')
         .version(package_json_1.default.version)
         .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
-        .option('--dry-run', 'Preview changes without writing files', false)
+        .option('-D, --dry-run', 'Preview changes without writing files', false)
         .option('--force', 'Override stop rules and proceed with changes', false)
-        .option('--diff', 'Display console diff for changed files', false)
-        .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('-d, --diff', 'Display console diff for changed files', false)
+        .option('-H, --diff-html', 'Generate and open HTML diff report in browser', false)
+        .option('-J, --diff-json', 'Output diff as JSON to stdout', false)
+        .option('-S, --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('-l, --list-files', 'List files that would be synced without processing diffs', false)
         .option('--show-config', 'Display resolved configuration after inheritance and exit', false)
         .option('--suggest', 'Analyze differences and suggest transforms and stop rules', false)
         .option('--suggest-threshold <number>', 'Minimum confidence for suggestions (0-1, default: 0.3)', '0.3')
         .option('--no-color', 'Disable colored output')
+        .option('-f, --filter <string>', 'Filter files by filename or content (case-insensitive)')
+        .option('-m, --mode <type>', 'Filter by change type: new, modified, deleted, all', 'all')
         .option('--verbose', 'Show detailed debug information', false)
         .option('--quiet', 'Suppress all output except critical errors', false)
         .addHelpText('after', `
@@ -45,6 +47,15 @@ Examples:
   # CI/CD usage with JSON output
   $ helm-env-delta --config config.yaml --diff-json | jq '.summary'
 
+  # Filter to only process files matching 'prod'
+  $ helm-env-delta --config config.yaml -f prod --diff
+
+  # Sync only new files
+  $ helm-env-delta --config config.yaml --mode new
+
+  # Preview modified files only
+  $ helm-env-delta --config config.yaml --mode modified --dry-run --diff
+
 Documentation: https://github.com/balazscsaba2006/helm-env-delta
 `);
     program.showSuggestionAfterError(true);
@@ -63,6 +74,11 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         console.error('Error: --suggest-threshold must be a number between 0 and 1');
         process.exit(1);
     }
+    const validModes = ['new', 'modified', 'deleted', 'all'];
+    if (!validModes.includes(options['mode'])) {
+        console.error('Error: --mode must be one of: ' + validModes.join(', '));
+        process.exit(1);
+    }
     return {
         config: options['config'],
         dryRun: options['dryRun'],
@@ -79,7 +95,9 @@ Documentation: https://github.com/balazscsaba2006/helm-env-delta
         verbose: options['verbose'],
         quiet: options['quiet'],
         suggest: options['suggest'],
-        suggestThreshold: threshold
+        suggestThreshold: threshold,
+        filter: options['filter'],
+        mode: options['mode']
     };
 };
 exports.parseCommandLine = parseCommandLine;

package/dist/consoleDiffReporter.js

@@ -5,9 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showConsoleDiff = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const yaml_1 = __importDefault(require("yaml"));
 const fileDiff_1 = require("./fileDiff");
-const arrayDiffProcessor_1 = require("./utils/arrayDiffProcessor");
 const diffGenerator_1 = require("./utils/diffGenerator");
 const fileType_1 = require("./utils/fileType");
 const serialization_1 = require("./utils/serialization");
@@ -29,7 +27,7 @@ const formatAddedFiles = (files) => {
     if (files.length === 0)
         return '';
     const header = chalk_1.default.green.bold(`\nAdded Files (${files.length}):`);
-    const fileList = files.map((file) => chalk_1.default.green(`  + ${file}`)).join('\n');
+    const fileList = files.map((file) => chalk_1.default.green(`  + ${file.path}`)).join('\n');
     return `${header}\n${fileList}\n`;
 };
 const formatDeletedFiles = (files) => {
@@ -39,30 +37,6 @@ const formatDeletedFiles = (files) => {
     const fileList = files.map((file) => chalk_1.default.red(`  - ${file}`)).join('\n');
     return `${header}\n${fileList}\n`;
 };
-const formatArrayDiff = (change) => {
-    let output = '';
-    if (change.removed.length > 0) {
-        output += chalk_1.default.red.bold(`\n  Removed (${change.removed.length}):\n`);
-        for (const item of change.removed) {
-            const yaml = yaml_1.default.stringify(item, { indent: 4 });
-            const lines = yaml.split('\n').filter((l) => l.trim());
-            output += lines.map((l) => chalk_1.default.red(`    - ${l}`)).join('\n');
-            output += '\n';
-        }
-    }
-    if (change.added.length > 0) {
-        output += chalk_1.default.green.bold(`\n  Added (${change.added.length}):\n`);
-        for (const item of change.added) {
-            const yaml = yaml_1.default.stringify(item, { indent: 4 });
-            const lines = yaml.split('\n').filter((l) => l.trim());
-            output += lines.map((l) => chalk_1.default.green(`    + ${l}`)).join('\n');
-            output += '\n';
-        }
-    }
-    if (change.unchanged.length > 0)
-        output += chalk_1.default.gray(`\n  Unchanged: ${change.unchanged.length} items\n`);
-    return output;
-};
 const formatChangedFile = (file, config) => {
     const isYaml = (0, fileType_1.isYamlFile)(file.path);
     const separator = chalk_1.default.yellow('━'.repeat(60));
@@ -70,48 +44,21 @@ const formatChangedFile = (file, config) => {
     const skipPathInfo = skipPaths.length > 0
         ? chalk_1.default.dim(`SkipPath patterns applied: ${skipPaths.join(', ')}`)
         : chalk_1.default.dim('No skipPath patterns applied');
-    if (!isYaml) {
-        const destinationContent = String(file.processedDestContent);
-        const sourceContent = String(file.processedSourceContent);
-        const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
-        const colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
-        return `
-${separator}
-${chalk_1.default.yellow.bold(`File: ${file.path}`)}
-${skipPathInfo}
-
-${colorizedDiff}
-`;
-    }
-    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 colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
-        return `
+    const destinationContent = isYaml
+        ? (0, serialization_1.serializeForDiff)(file.processedDestContent, true)
+        : String(file.processedDestContent);
+    const sourceContent = isYaml
+        ? (0, serialization_1.serializeForDiff)(file.processedSourceContent, true)
+        : String(file.processedSourceContent);
+    const unifiedDiff = (0, diffGenerator_1.generateUnifiedDiff)(file.path, destinationContent, sourceContent);
+    const colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
+    return `
 ${separator}
 ${chalk_1.default.yellow.bold(`File: ${file.path}`)}
 ${skipPathInfo}
 
 ${colorizedDiff}
 `;
-    }
-    let output = `\n${separator}\n${chalk_1.default.yellow.bold(`File: ${file.path}`)}\n${skipPathInfo}\n`;
-    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 colorizedDiff = colorizeUnifiedDiff(unifiedDiff);
-    output += `\n${colorizedDiff}\n`;
-    if (arrayInfo.hasChanges) {
-        output += chalk_1.default.cyan.bold('\nArray-specific details:\n');
-        for (const change of arrayInfo.changes) {
-            const pathString = change.path.join('.');
-            output += chalk_1.default.cyan(`\n  ${pathString}:\n`);
-            output += formatArrayDiff(change);
-        }
-    }
-    return output;
 };
 const formatChangedFiles = (files, config) => {
     if (files.length === 0)

package/dist/fileDiff.d.ts

@@ -1,7 +1,7 @@
 import { Config, FixedValueConfig, TransformConfig } from './configFile';
 import { FileMap } from './fileLoader';
 export interface FileDiffResult {
-    addedFiles: string[];
+    addedFiles: AddedFile[];
     deletedFiles: string[];
     changedFiles: ChangedFile[];
     unchangedFiles: string[];
@@ -21,6 +21,12 @@ export interface ChangedFile {
     parsedSource?: unknown;
     parsedDest?: unknown;
 }
+export interface AddedFile {
+    path: string;
+    originalPath?: string;
+    content: string;
+    processedContent: string;
+}
 export interface ProcessYamlOptions {
     filePath: string;
     sourceContent: string;

package/dist/fileDiff.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.computeFileDiff = exports.getSkipPathsForFile = exports.isFileDiffError = exports.FileDiffError = void 0;
 const yaml_1 = __importDefault(require("yaml"));
+const commentOnlyDetector_1 = require("./utils/commentOnlyDetector");
 const deepEqual_1 = require("./utils/deepEqual");
 const errors_1 = require("./utils/errors");
 const fileType_1 = require("./utils/fileType");
@@ -13,6 +14,7 @@ const jsonPath_1 = require("./utils/jsonPath");
 const patternMatcher_1 = require("./utils/patternMatcher");
 const serialization_1 = require("./utils/serialization");
 const transformer_1 = require("./utils/transformer");
+const yamlFormatter_1 = require("./yamlFormatter");
 const FileDiffErrorClass = (0, errors_1.createErrorClass)('File Diff Error', {
     YAML_PARSE_ERROR: 'YAML file could not be parsed'
 });
@@ -20,11 +22,36 @@ class FileDiffError extends FileDiffErrorClass {
 }
 exports.FileDiffError = FileDiffError;
 exports.isFileDiffError = (0, errors_1.createErrorTypeGuard)(FileDiffError);
-const detectAddedFiles = (sourceFiles, destinationFiles) => {
+const processAddedFileContent = (filePath, content, transforms, fixedValues, outputFormat) => {
+    if (!(0, fileType_1.isYamlFile)(filePath))
+        return content;
+    try {
+        const parsed = yaml_1.default.parse(content);
+        const transformed = (0, transformer_1.applyTransforms)(parsed, filePath, transforms);
+        const fixedValueRules = (0, fixedValues_1.getFixedValuesForFile)(filePath, fixedValues);
+        if (fixedValueRules.length > 0)
+            (0, fixedValues_1.applyFixedValues)(transformed, fixedValueRules);
+        let processed = yaml_1.default.stringify(transformed);
+        processed = (0, yamlFormatter_1.formatYaml)(processed, filePath, outputFormat);
+        return processed;
+    }
+    catch {
+        return content;
+    }
+};
+const detectAddedFiles = (sourceFiles, destinationFiles, config, originalPaths) => {
     const addedFiles = [];
-    for (const path of sourceFiles.keys())
-        if (!destinationFiles.has(path))
-            addedFiles.push(path);
+    for (const [path, content] of sourceFiles.entries())
+        if (!destinationFiles.has(path)) {
+            const originalPath = originalPaths?.get(path);
+            const processedContent = processAddedFileContent(path, content, config.transforms, config.fixedValues, config.outputFormat);
+            addedFiles.push({
+                path,
+                originalPath,
+                content,
+                processedContent
+            });
+        }
     return addedFiles;
 };
 const detectDeletedFiles = (sourceFiles, destinationFiles) => {
@@ -143,6 +170,8 @@ const processYamlFile = (options) => {
         parseError.message += destinationHints;
         throw parseError;
     }
+    if ((0, commentOnlyDetector_1.isCommentOnlyContent)(destinationContent))
+        return undefined;
     const sourceTransformed = (0, transformer_1.applyTransforms)(sourceParsed, filePath, transforms);
     const fixedValueRules = (0, fixedValues_1.getFixedValuesForFile)(filePath, fixedValues);
     if (fixedValueRules.length > 0)
@@ -225,7 +254,7 @@ const computeFileDiff = (sourceFiles, destinationFiles, config, logger, original
         if (skipPathCount > 0)
             logger.debug(`  SkipPath patterns: ${skipPathCount}`);
     }
-    const addedFiles = detectAddedFiles(sourceFiles, destinationFiles);
+    const addedFiles = detectAddedFiles(sourceFiles, destinationFiles, config, originalPaths);
     const deletedFiles = config.prune ? detectDeletedFiles(sourceFiles, destinationFiles) : [];
     const { changedFiles, unchangedFiles } = processChangedFiles(sourceFiles, destinationFiles, config.skipPath, config.transforms, config.fixedValues, originalPaths);
     return { addedFiles, deletedFiles, changedFiles, unchangedFiles };

package/dist/fileUpdater.js

@@ -9,6 +9,7 @@ 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 commentOnlyDetector_1 = require("./utils/commentOnlyDetector");
 const errors_1 = require("./utils/errors");
 const fileType_1 = require("./utils/fileType");
 const fixedValues_1 = require("./utils/fixedValues");
@@ -248,11 +249,11 @@ const deleteFile = async (relativePath, absoluteDestinationDirectory, dryRun, lo
 const addNewFiles = async (files, sourceFiles, context) => {
     if (context.logger.shouldShow('debug'))
         context.logger.debug(`Processing ${files.length} new files`);
-    for (const relativePath of files)
+    for (const addedFile of files)
         try {
-            const content = sourceFiles.get(relativePath);
+            const content = sourceFiles.get(addedFile.path);
             await addFile({
-                relativePath,
+                relativePath: addedFile.path,
                 content,
                 absoluteDestinationDirectory: context.absoluteDestinationDirectory,
                 config: context.config,
@@ -262,7 +263,7 @@ const addNewFiles = async (files, sourceFiles, context) => {
             });
         }
         catch (error) {
-            context.errors.push({ operation: 'add', path: relativePath, error: error });
+            context.errors.push({ operation: 'add', path: addedFile.path, error: error });
         }
 };
 const updateChangedFiles = async (files, context) => {
@@ -289,6 +290,8 @@ const formatUnchangedFiles = async (files, destinationFiles, context) => {
         if ((0, fileType_1.isYamlFile)(relativePath))
             try {
                 const content = destinationFiles.get(relativePath);
+                if ((0, commentOnlyDetector_1.isCommentOnlyContent)(content))
+                    continue;
                 const effectiveOutputFormat = context.skipFormat ? undefined : context.config.outputFormat;
                 const formatted = (0, yamlFormatter_1.formatYaml)(content, relativePath, effectiveOutputFormat);
                 if (formatted !== content) {

package/dist/htmlReporter.js

@@ -11,6 +11,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const diff2html_1 = require("diff2html");
 const browserLauncher_1 = require("./reporters/browserLauncher");
 const htmlTemplate_1 = require("./reporters/htmlTemplate");
+const treeRenderer_1 = require("./reporters/treeRenderer");
 const diffGenerator_1 = require("./utils/diffGenerator");
 const errors_1 = require("./utils/errors");
 const fileType_1 = require("./utils/fileType");
@@ -42,6 +43,28 @@ const generateFileSummary = (file) => {
         return file.path;
     return `<span class="filename-transform">${file.originalPath} → ${file.path}</span>`;
 };
+const generateAddedFileSummary = (file) => {
+    if (!file.originalPath)
+        return file.path;
+    return `<span class="filename-transform">${file.originalPath} → ${file.path}</span>`;
+};
+const generateAddedFileSection = (file, fileId) => {
+    const summary = generateAddedFileSummary(file);
+    const escapedContent = (0, treeRenderer_1.escapeHtml)(file.processedContent);
+    const filename = file.path.split('/').pop() || file.path;
+    return `
+    <details class="file-section" id="${fileId}" data-file-id="${fileId}" open>
+      <summary>${summary}</summary>
+      <div class="content-container">
+        <div class="content-actions">
+          <button class="copy-btn" data-file-id="${fileId}" title="Copy to clipboard">📋 Copy</button>
+          <button class="download-btn" data-file-id="${fileId}" data-filename="${(0, treeRenderer_1.escapeHtml)(filename)}" title="Download file">⬇ Download</button>
+        </div>
+        <pre class="file-content"><code>${escapedContent}</code></pre>
+      </div>
+    </details>
+  `;
+};
 const generateChangedFileSection = (file, fileId) => {
     const isYaml = (0, fileType_1.isYamlFile)(file.path);
     const summary = generateFileSummary(file);
@@ -91,7 +114,11 @@ const generateHtmlReport = async (diffResult, formattedFiles, config, dryRun, lo
     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);
+    const addedFileIds = new Map();
+    for (const [index, file] of diffResult.addedFiles.entries())
+        addedFileIds.set(file.path, `added-file-${index}`);
+    const addedSections = diffResult.addedFiles.map((file, index) => generateAddedFileSection(file, `added-file-${index}`));
+    const htmlContent = (0, htmlTemplate_1.generateHtmlTemplate)(diffResult, formattedFiles, trulyUnchangedFiles, metadata, changedSections, changedFileIds, addedSections, addedFileIds);
     await writeHtmlFile(htmlContent, reportPath);
     logger?.log(`✓ HTML report generated: ${reportPath}, opening in browser...`);
     try {