helm-env-delta 1.15.2 → 2.0.0

package/dist/commandLine.js

@@ -6,122 +6,309 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCommandLine = void 0;
 const commander_1 = require("commander");
 const package_json_1 = __importDefault(require("../package.json"));
+const exitCodes_1 = require("./exitCodes");
+const exitOverrideFunction = (error) => {
+    if (error.exitCode === 0)
+        process.exit(0);
+    process.exit(exitCodes_1.EXIT_CONFIG_ERROR);
+};
+const validModes = ['new', 'modified', 'deleted', 'all'];
+const parseMode = (mode) => {
+    if (!validModes.includes(mode)) {
+        console.error('Error: --mode must be one of: ' + validModes.join(', '));
+        process.exit(exitCodes_1.EXIT_CONFIG_ERROR);
+    }
+    return mode;
+};
+const parseMyDays = (myRaw) => {
+    if (myRaw === undefined || myRaw === false)
+        return { my: false, myDays: 30 };
+    if (myRaw === true)
+        return { my: true, myDays: 30 };
+    const parsed = Number.parseInt(myRaw, 10);
+    if (Number.isNaN(parsed) || parsed < 1) {
+        console.error('Error: --my days must be a positive integer');
+        process.exit(exitCodes_1.EXIT_CONFIG_ERROR);
+    }
+    return { my: true, myDays: parsed };
+};
+const checkVerboseQuiet = (verbose, quiet) => {
+    if (verbose && quiet) {
+        console.error('Error: --verbose and --quiet flags are mutually exclusive');
+        process.exit(exitCodes_1.EXIT_CONFIG_ERROR);
+    }
+};
+const addGlobalOptions = (cmd) => cmd
+    .option('--verbose', 'Show detailed debug information', false)
+    .option('--quiet', 'Suppress all output except critical errors', false)
+    .option('--no-color', 'Disable colored output');
 const parseCommandLine = (argv) => {
+    let result;
     const program = new commander_1.Command();
     program
         .name('helm-env-delta')
         .description('Environment-aware YAML delta and sync for GitOps workflows')
         .version(package_json_1.default.version)
+        .showSuggestionAfterError(true)
+        .exitOverride(exitOverrideFunction);
+    addGlobalOptions(program
+        .command('run')
+        .description('Sync source YAML changes to destination')
         .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
         .option('-D, --dry-run', 'Preview changes without writing files', false)
         .option('--force', 'Override stop rules and proceed with changes', 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('-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('-f, --filter <string>', 'Filter files by name or content (supports , for OR, + for AND)')
+        .option('-m, --mode <type>', 'Filter by change type: new, modified, deleted, all', 'all')
+        .option('--my [days]', 'Limit to files you modified in the last N days (default: 30)')
+        .addHelpText('after', `
+Examples:
+  $ helm-env-delta run -c config.yaml
+  $ helm-env-delta run -c config.yaml --dry-run
+  $ helm-env-delta run -c config.yaml --force
+  $ helm-env-delta run -c config.yaml --mode new
+  $ helm-env-delta run -c config.yaml -f prod --my 7
+`)
+        .exitOverride(exitOverrideFunction)).action(function (options) {
+        checkVerboseQuiet(options['verbose'], options['quiet']);
+        const { my, myDays } = parseMyDays(options['my']);
+        result = {
+            commandName: 'run',
+            config: options['config'],
+            dryRun: options['dryRun'],
+            force: options['force'],
+            strict: false,
+            html: false,
+            json: false,
+            skipFormat: options['skipFormat'],
+            suggestThreshold: 0.3,
+            filter: options['filter'],
+            mode: parseMode(options['mode']),
+            my,
+            myDays,
+            verbose: options['verbose'],
+            quiet: options['quiet'],
+            noColor: !options['color']
+        };
+    });
+    addGlobalOptions(program
+        .command('validate')
+        .description('Validate configuration and patterns against source files')
+        .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
+        .option('-f, --filter <string>', 'Filter files by name or content')
+        .option('--my [days]', 'Limit to files you modified in the last N days (default: 30)')
+        .option('--strict', 'Exit non-zero if any warnings are found', false)
+        .addHelpText('after', `
+Examples:
+  $ helm-env-delta validate -c config.yaml
+  $ helm-env-delta validate -c config.yaml -f prod
+  $ helm-env-delta validate -c config.yaml --strict
+`)
+        .exitOverride(exitOverrideFunction)).action(function (options) {
+        checkVerboseQuiet(options['verbose'], options['quiet']);
+        const { my, myDays } = parseMyDays(options['my']);
+        result = {
+            commandName: 'validate',
+            config: options['config'],
+            dryRun: false,
+            force: false,
+            strict: options['strict'],
+            html: false,
+            json: false,
+            skipFormat: false,
+            suggestThreshold: 0.3,
+            filter: options['filter'],
+            mode: 'all',
+            my,
+            myDays,
+            verbose: options['verbose'],
+            quiet: options['quiet'],
+            noColor: !options['color']
+        };
+    });
+    addGlobalOptions(program
+        .command('format')
+        .description('Format YAML files in destination without syncing')
+        .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
+        .option('-D, --dry-run', 'Preview formatting changes without writing files', false)
+        .option('-f, --filter <string>', 'Filter files by name or content')
+        .addHelpText('after', `
+Examples:
+  $ helm-env-delta format -c config.yaml
+  $ helm-env-delta format -c config.yaml --dry-run
+  $ helm-env-delta format -c config.yaml -f prod
+`)
+        .exitOverride(exitOverrideFunction)).action(function (options) {
+        checkVerboseQuiet(options['verbose'], options['quiet']);
+        result = {
+            commandName: 'format',
+            config: options['config'],
+            dryRun: options['dryRun'],
+            force: false,
+            strict: false,
+            html: false,
+            json: false,
+            skipFormat: false,
+            suggestThreshold: 0.3,
+            filter: options['filter'],
+            mode: 'all',
+            my: false,
+            myDays: 30,
+            verbose: options['verbose'],
+            quiet: options['quiet'],
+            noColor: !options['color']
+        };
+    });
+    addGlobalOptions(program
+        .command('suggest')
+        .description('Analyze differences and suggest transforms and stop rules')
+        .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
         .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 (supports , for OR, + for AND)')
+        .option('-f, --filter <string>', 'Filter files by name or content')
         .option('-m, --mode <type>', 'Filter by change type: new, modified, deleted, all', 'all')
-        .option('--my [days]', 'Filter source files to those you modified in the last N days (default: 30)')
-        .option('--verbose', 'Show detailed debug information', false)
-        .option('--quiet', 'Suppress all output except critical errors', false)
+        .option('--my [days]', 'Limit to files you modified in the last N days (default: 30)')
         .addHelpText('after', `
 Examples:
-  # Preview changes before syncing
-  $ helm-env-delta --config config.yaml --dry-run --diff
-
-  # Get configuration suggestions
-  $ helm-env-delta --config config.yaml --suggest
-
-  # Sync with HTML diff report
-  $ helm-env-delta --config config.yaml --diff-html
-
-  # Validate stop rules without syncing
-  $ helm-env-delta --config config.yaml --validate
-
-  # 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
-
-  # Filter with OR: files matching 'prod' OR 'staging'
-  $ helm-env-delta --config config.yaml -f prod,staging --diff
-
-  # Filter with AND: files matching 'values' AND 'prod'
-  $ helm-env-delta --config config.yaml -f values+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
-
-  # Sync only files you modified in the last 30 days
-  $ helm-env-delta --config config.yaml --my --dry-run --diff
-
-  # Sync only files you modified in the last 7 days
-  $ helm-env-delta --config config.yaml --my 7 --diff
-
-Documentation: https://github.com/balazscsaba2006/helm-env-delta
-`);
-    program.showSuggestionAfterError(true);
-    program.parse(argv || process.argv);
-    const options = program.opts();
-    if (options['verbose'] && options['quiet']) {
-        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');
-        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);
-    }
-    let myDays = 30;
-    if (options['my'] !== undefined && options['my'] !== true) {
-        const parsed = Number.parseInt(options['my'], 10);
-        if (Number.isNaN(parsed) || parsed < 1) {
-            console.error('Error: --my days must be a positive integer');
-            process.exit(1);
+  $ helm-env-delta suggest -c config.yaml
+  $ helm-env-delta suggest -c config.yaml --suggest-threshold 0.5
+  $ helm-env-delta suggest -c config.yaml -f prod
+`)
+        .exitOverride(exitOverrideFunction)).action(function (options) {
+        checkVerboseQuiet(options['verbose'], options['quiet']);
+        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');
+            process.exit(exitCodes_1.EXIT_CONFIG_ERROR);
         }
-        myDays = parsed;
+        const { my, myDays } = parseMyDays(options['my']);
+        result = {
+            commandName: 'suggest',
+            config: options['config'],
+            dryRun: false,
+            force: false,
+            strict: false,
+            html: false,
+            json: false,
+            skipFormat: false,
+            suggestThreshold: threshold,
+            filter: options['filter'],
+            mode: parseMode(options['mode']),
+            my,
+            myDays,
+            verbose: options['verbose'],
+            quiet: options['quiet'],
+            noColor: !options['color']
+        };
+    });
+    addGlobalOptions(program
+        .command('diff')
+        .description('Show changes between source and destination (read-only)')
+        .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
+        .option('-H, --html', 'Generate and open HTML diff report in browser', false)
+        .option('-J, --json', 'Output diff as JSON to stdout', false)
+        .option('--report-output <path>', 'Save HTML report to a file or directory (suppresses browser auto-open)')
+        .option('-f, --filter <string>', 'Filter files by name or content')
+        .option('-m, --mode <type>', 'Filter by change type: new, modified, deleted, all', 'all')
+        .option('--my [days]', 'Limit to files you modified in the last N days (default: 30)')
+        .addHelpText('after', `
+Examples:
+  $ helm-env-delta diff -c config.yaml
+  $ helm-env-delta diff -c config.yaml --html
+  $ helm-env-delta diff -c config.yaml --json | jq '.summary'
+  $ helm-env-delta diff -c config.yaml --report-output ./reports/
+  $ helm-env-delta diff -c config.yaml -f prod --mode modified
+`)
+        .exitOverride(exitOverrideFunction)).action(function (options) {
+        checkVerboseQuiet(options['verbose'], options['quiet']);
+        const { my, myDays } = parseMyDays(options['my']);
+        result = {
+            commandName: 'diff',
+            config: options['config'],
+            dryRun: false,
+            force: false,
+            strict: false,
+            html: options['html'],
+            json: options['json'],
+            reportOutput: options['reportOutput'],
+            skipFormat: false,
+            suggestThreshold: 0.3,
+            filter: options['filter'],
+            mode: parseMode(options['mode']),
+            my,
+            myDays,
+            verbose: options['verbose'],
+            quiet: options['quiet'],
+            noColor: !options['color']
+        };
+    });
+    addGlobalOptions(program
+        .command('list-files')
+        .description('List files that would be loaded without processing diffs')
+        .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
+        .option('-f, --filter <string>', 'Filter files by name or content')
+        .option('--my [days]', 'Limit to files you modified in the last N days (default: 30)')
+        .addHelpText('after', `
+Examples:
+  $ helm-env-delta list-files -c config.yaml
+  $ helm-env-delta list-files -c config.yaml -f prod
+  $ helm-env-delta list-files -c config.yaml --my 7
+`)
+        .exitOverride(exitOverrideFunction)).action(function (options) {
+        checkVerboseQuiet(options['verbose'], options['quiet']);
+        const { my, myDays } = parseMyDays(options['my']);
+        result = {
+            commandName: 'list-files',
+            config: options['config'],
+            dryRun: false,
+            force: false,
+            strict: false,
+            html: false,
+            json: false,
+            skipFormat: false,
+            suggestThreshold: 0.3,
+            filter: options['filter'],
+            mode: 'all',
+            my,
+            myDays,
+            verbose: options['verbose'],
+            quiet: options['quiet'],
+            noColor: !options['color']
+        };
+    });
+    addGlobalOptions(program
+        .command('show-config')
+        .description('Display resolved configuration after inheritance')
+        .requiredOption('-c, --config <file>', 'Path to YAML configuration file')
+        .addHelpText('after', `
+Examples:
+  $ helm-env-delta show-config -c config.yaml
+`)
+        .exitOverride(exitOverrideFunction)).action(function (options) {
+        checkVerboseQuiet(options['verbose'], options['quiet']);
+        result = {
+            commandName: 'show-config',
+            config: options['config'],
+            dryRun: false,
+            force: false,
+            strict: false,
+            html: false,
+            json: false,
+            skipFormat: false,
+            suggestThreshold: 0.3,
+            filter: undefined,
+            mode: 'all',
+            my: false,
+            myDays: 30,
+            verbose: options['verbose'],
+            quiet: options['quiet'],
+            noColor: !options['color']
+        };
+    });
+    program.parse(argv ?? process.argv);
+    if (!result) {
+        program.help();
+        process.exit(exitCodes_1.EXIT_CONFIG_ERROR);
     }
-    return {
-        config: options['config'],
-        dryRun: options['dryRun'],
-        force: options['force'],
-        diff: options['diff'],
-        diffHtml: options['diffHtml'],
-        diffJson: options['diffJson'],
-        skipFormat: options['skipFormat'],
-        formatOnly: options['formatOnly'],
-        validate: options['validate'],
-        listFiles: options['listFiles'],
-        showConfig: options['showConfig'],
-        noColor: !options['color'],
-        verbose: options['verbose'],
-        quiet: options['quiet'],
-        suggest: options['suggest'],
-        suggestThreshold: threshold,
-        filter: options['filter'],
-        mode: options['mode'],
-        my: options['my'] !== undefined && options['my'] !== false,
-        myDays
-    };
+    return result;
 };
 exports.parseCommandLine = parseCommandLine;

package/dist/config/ZodError.d.ts

@@ -1,8 +1,8 @@
-import { z } from 'zod';
+import { type z } from 'zod';
 export declare class ZodValidationError extends Error {
     readonly zodError: z.ZodError;
     readonly sourcePath?: string | undefined;
     constructor(zodError: z.ZodError, sourcePath?: string | undefined);
-    private static formatError;
+    private static readonly formatError;
 }
 export declare const isZodValidationError: (error: unknown) => error is ZodValidationError;

package/dist/config/configFile.d.ts

@@ -100,7 +100,7 @@ declare const transformRulesSchema: z.ZodObject<{
     contentFile: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     filenameFile: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strip>;
-declare const baseConfigSchema: z.ZodObject<{
+export declare const baseConfigSchema: z.ZodObject<{
     extends: z.ZodOptional<z.ZodString>;
     requiredVersion: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodString>;

package/dist/config/configFile.js

@@ -3,25 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isConfigValidationError = exports.ConfigValidationError = exports.parseConfig = exports.parseFormatOnlyConfig = exports.parseFinalConfig = exports.parseBaseConfig = void 0;
+exports.isConfigValidationError = exports.ConfigValidationError = exports.parseConfig = exports.parseFormatOnlyConfig = exports.parseFinalConfig = exports.parseBaseConfig = exports.baseConfigSchema = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
 const regexSafety_1 = require("../utils/regexSafety");
 const ZodError_1 = require("./ZodError");
 const semverMajorUpgradeRuleSchema = zod_1.z.object({
     type: zod_1.z.literal('semverMajorUpgrade'),
-    path: zod_1.z.string().min(1)
+    path: zod_1.z.string().min(1).describe('JSONPath to the version field to check for major upgrades')
 });
 const semverDowngradeRuleSchema = zod_1.z.object({
     type: zod_1.z.literal('semverDowngrade'),
-    path: zod_1.z.string().min(1)
+    path: zod_1.z.string().min(1).describe('JSONPath to the version field to check for any downgrade')
 });
 const numericRuleSchema = zod_1.z
     .object({
     type: zod_1.z.literal('numeric'),
-    path: zod_1.z.string().min(1),
-    min: zod_1.z.number().optional(),
-    max: zod_1.z.number().optional()
+    path: zod_1.z.string().min(1).describe('JSONPath to the numeric field to validate'),
+    min: zod_1.z.number().optional().describe('Minimum allowed value (inclusive)'),
+    max: zod_1.z.number().optional().describe('Maximum allowed value (inclusive)')
 })
     .refine((data) => {
     if (data.min !== undefined && data.max !== undefined)
@@ -34,8 +34,8 @@ const numericRuleSchema = zod_1.z
 const regexRuleSchema = zod_1.z
     .object({
     type: zod_1.z.literal('regex'),
-    path: zod_1.z.string().min(1).optional(),
-    regex: zod_1.z.string().min(1)
+    path: zod_1.z.string().min(1).optional().describe('JSONPath to check (omit to scan ALL values recursively)'),
+    regex: zod_1.z.string().min(1).describe('Regex pattern that must NOT match (blocks sync if matched)')
 })
     .refine((data) => {
     try {
@@ -55,19 +55,22 @@ const regexRuleSchema = zod_1.z
 });
 const regexFileRuleSchema = zod_1.z.object({
     type: zod_1.z.literal('regexFile'),
-    path: zod_1.z.string().min(1).optional(),
-    file: zod_1.z.string().min(1)
+    path: zod_1.z.string().min(1).optional().describe('JSONPath to check (omit to scan ALL values recursively)'),
+    file: zod_1.z.string().min(1).describe('Path to a YAML file containing an array of regex patterns')
 });
 const regexFileKeyRuleSchema = zod_1.z.object({
     type: zod_1.z.literal('regexFileKey'),
-    path: zod_1.z.string().min(1).optional(),
-    file: zod_1.z.string().min(1)
+    path: zod_1.z.string().min(1).optional().describe('JSONPath to check (omit to scan ALL values recursively)'),
+    file: zod_1.z.string().min(1).describe('Path to a YAML file whose keys are used as regex patterns')
 });
 const versionFormatRuleSchema = zod_1.z
     .object({
     type: zod_1.z.literal('versionFormat'),
-    path: zod_1.z.string().min(1),
-    vPrefix: zod_1.z.enum(['required', 'allowed', 'forbidden']).default('allowed')
+    path: zod_1.z.string().min(1).describe('JSONPath to the version field to validate format'),
+    vPrefix: zod_1.z
+        .enum(['required', 'allowed', 'forbidden'])
+        .default('allowed')
+        .describe('"required" = must start with v, "allowed" = either, "forbidden" = no v (default: "allowed")')
 })
     .strict();
 const stopRuleSchema = zod_1.z.discriminatedUnion('type', [
@@ -80,11 +83,17 @@ const stopRuleSchema = zod_1.z.discriminatedUnion('type', [
     versionFormatRuleSchema
 ]);
 const arraySortRuleSchema = zod_1.z.object({
-    path: zod_1.z.string().min(1),
-    sortBy: zod_1.z.string().min(1).optional(),
-    order: zod_1.z.enum(['asc', 'desc']).default('asc')
+    path: zod_1.z.string().min(1).describe('JSONPath to the array to sort'),
+    sortBy: zod_1.z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Object property to sort by (required for arrays of objects; omit for scalar arrays)'),
+    order: zod_1.z.enum(['asc', 'desc']).default('asc').describe('Sort direction: "asc" or "desc" (default: "asc")')
+});
+const keySortRuleSchema = zod_1.z.object({
+    path: zod_1.z.string().min(1).describe('JSONPath to the object whose keys should be sorted alphabetically')
 });
-const keySortRuleSchema = zod_1.z.object({ path: zod_1.z.string().min(1) });
 const DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 const hasDangerousKeys = (value) => {
     if (value === null || typeof value !== 'object')
@@ -139,37 +148,74 @@ const transformRulesSchema = zod_1.z
     data.filenameFile !== undefined, {
     message: 'At least one of content, filename, contentFile, or filenameFile must be specified'
 });
-const baseConfigSchema = zod_1.z.object({
-    extends: zod_1.z.string().min(1).optional(),
+exports.baseConfigSchema = zod_1.z.object({
+    extends: zod_1.z.string().min(1).optional().describe('Path to a parent config file to inherit from (up to 5 levels deep)'),
     requiredVersion: zod_1.z
         .string()
         .min(1)
         .regex(/^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/, {
         message: 'Must be a valid semver version (e.g., "1.2.3" or "v1.2.3")'
     })
-        .optional(),
-    source: zod_1.z.string().min(1).optional(),
-    destination: zod_1.z.string().min(1).optional(),
-    include: zod_1.z.array(zod_1.z.string().min(1)).optional(),
-    exclude: zod_1.z.array(zod_1.z.string().min(1)).optional(),
-    prune: zod_1.z.boolean().optional(),
-    confirmationDelay: zod_1.z.number().int().min(0).optional(),
-    skipPath: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
+        .optional()
+        .describe('Minimum required hed CLI version (e.g. "1.2.3"); also suppresses auto-update notifications'),
+    source: zod_1.z.string().min(1).optional().describe('Path to the source directory (environment to copy FROM)'),
+    destination: zod_1.z.string().min(1).optional().describe('Path to the destination directory (environment to sync INTO)'),
+    include: zod_1.z.array(zod_1.z.string().min(1)).optional().describe('Glob patterns for files to include (default: ["**/*"])'),
+    exclude: zod_1.z.array(zod_1.z.string().min(1)).optional().describe('Glob patterns for files to exclude from processing'),
+    prune: zod_1.z.boolean().optional().describe('Delete destination files that no longer exist in source (default: false)'),
+    confirmationDelay: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Milliseconds to pause before applying changes (default: 3000; 0 = no delay)'),
+    skipPath: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.array(zod_1.z.string()))
+        .optional()
+        .describe('Per-file-glob map of JSONPath patterns whose destination values are preserved'),
     outputFormat: zod_1.z
         .object({
-        indent: zod_1.z.number().int().min(1).max(10).optional(),
-        keySeparator: zod_1.z.boolean().optional(),
-        quoteValues: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
-        keyOrders: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())).optional(),
-        keySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(keySortRuleSchema)).optional(),
-        arraySort: zod_1.z.record(zod_1.z.string(), zod_1.z.array(arraySortRuleSchema)).optional()
+        indent: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe('Number of spaces for YAML indentation (1–10, default: 2)'),
+        keySeparator: zod_1.z.boolean().optional().describe('Insert a blank line between top-level keys (default: false)'),
+        quoteValues: zod_1.z
+            .record(zod_1.z.string(), zod_1.z.array(zod_1.z.string()))
+            .optional()
+            .describe('Per-file-glob map of JSONPath patterns whose values should be quoted'),
+        keyOrders: zod_1.z
+            .record(zod_1.z.string(), zod_1.z.array(zod_1.z.string()))
+            .optional()
+            .describe('Per-file-glob explicit key ordering arrays'),
+        keySort: zod_1.z
+            .record(zod_1.z.string(), zod_1.z.array(keySortRuleSchema))
+            .optional()
+            .describe('Per-file-glob rules for alphabetically sorting object keys at a path'),
+        arraySort: zod_1.z
+            .record(zod_1.z.string(), zod_1.z.array(arraySortRuleSchema))
+            .optional()
+            .describe('Per-file-glob rules for sorting array elements at a path')
     })
-        .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(),
-    fixedValues: zod_1.z.record(zod_1.z.string(), zod_1.z.array(fixedValueRuleSchema)).optional()
+        .optional()
+        .describe('YAML output formatting rules applied after merge'),
+    transforms: zod_1.z
+        .record(zod_1.z.string(), transformRulesSchema)
+        .optional()
+        .describe('Per-file-glob regex and file-based content/filename transform rules'),
+    stopRules: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.array(stopRuleSchema))
+        .optional()
+        .describe('Per-file-glob validation rules that block sync if triggered (use --force to override)'),
+    fixedValues: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.array(fixedValueRuleSchema))
+        .optional()
+        .describe('Per-file-glob rules that pin specific JSONPath locations to constant values after merge')
 });
-const finalConfigSchema = baseConfigSchema
+const finalConfigSchema = exports.baseConfigSchema
     .omit({ extends: true })
     .required({ source: true, destination: true })
     .extend({
@@ -197,7 +243,7 @@ const finalConfigSchema = baseConfigSchema
     message: 'Source and destination folders cannot be the same',
     path: ['destination']
 });
-const formatOnlyConfigSchema = baseConfigSchema
+const formatOnlyConfigSchema = exports.baseConfigSchema
     .omit({ extends: true })
     .required({ destination: true })
     .extend({
@@ -218,7 +264,7 @@ const formatOnlyConfigSchema = baseConfigSchema
         .default({ indent: 2, keySeparator: false })
 });
 const parseBaseConfig = (data, configPath) => {
-    const result = baseConfigSchema.safeParse(data);
+    const result = exports.baseConfigSchema.safeParse(data);
     if (!result.success)
         throw new ZodError_1.ZodValidationError(result.error, configPath);
     return result.data;

package/dist/config/configLoader.d.ts

@@ -1,3 +1,4 @@
+import type { Logger } from '../logger';
 import { type FinalConfig, type FormatOnlyConfig } from './configFile';
 declare const ConfigLoaderErrorClass: {
     new (message: string, options?: import("../utils").ErrorOptions): {
@@ -21,5 +22,5 @@ export type Config = FinalConfig;
 export type LoadConfigOptions = {
     formatOnly?: boolean;
 };
-export declare const loadConfigFile: (configPath: string, quiet?: boolean, logger?: import("../logger").Logger, options?: LoadConfigOptions) => FinalConfig | FormatOnlyConfig;
+export declare const loadConfigFile: (configPath: string, quiet?: boolean, logger?: Logger, options?: LoadConfigOptions) => FinalConfig | FormatOnlyConfig;
 export {};

package/dist/config/configMerger.d.ts

@@ -1,3 +1,4 @@
+import type { Logger } from '../logger';
 import { type BaseConfig } from './configFile';
 declare const ConfigMergerErrorClass: {
     new (message: string, options?: import("../utils/errors").ErrorOptions): {
@@ -18,5 +19,5 @@ export declare class ConfigMergerError extends ConfigMergerErrorClass {
 }
 export declare const isConfigMergerError: (error: unknown) => error is ConfigMergerError;
 export declare const mergeConfigs: (parent: BaseConfig, child: BaseConfig) => BaseConfig;
-export declare const resolveConfigWithExtends: (configPath: string, visited?: Set<string>, depth?: number, logger?: import("../logger").Logger) => BaseConfig;
+export declare const resolveConfigWithExtends: (configPath: string, visited?: Set<string>, depth?: number, logger?: Logger) => BaseConfig;
 export {};