npmdata 0.11.0 → 0.13.0

package/dist/runner.js

@@ -1,812 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildCheckCommand = buildCheckCommand;
-exports.buildListCommand = buildListCommand;
-exports.buildPurgeCommand = buildPurgeCommand;
-exports.collectAllTags = collectAllTags;
-exports.printHelp = printHelp;
-exports.parseOutputFromArgv = parseOutputFromArgv;
-exports.parseDryRunFromArgv = parseDryRunFromArgv;
-exports.parseSilentFromArgv = parseSilentFromArgv;
-exports.parseVerboseFromArgv = parseVerboseFromArgv;
-exports.parseNoGitignoreFromArgv = parseNoGitignoreFromArgv;
-exports.parseUnmanagedFromArgv = parseUnmanagedFromArgv;
-exports.parseTagsFromArgv = parseTagsFromArgv;
-exports.filterEntriesByTags = filterEntriesByTags;
-exports.applySymlinks = applySymlinks;
-exports.applyContentReplacements = applyContentReplacements;
-exports.checkContentReplacements = checkContentReplacements;
-exports.runEntries = runEntries;
-exports.run = run;
-/* eslint-disable no-restricted-syntax */
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const minimatch_1 = require("minimatch");
-const utils_1 = require("./utils");
-/**
- * Extract just the package name (without version specifier) from a package spec string.
- * Delegates to the shared parsePackageSpec utility.
- */
-function parseEntryPackageName(spec) {
-    const { name } = (0, utils_1.parsePackageSpec)(spec);
-    return { name };
-}
-function buildExtractCommand(cliPath, entry, cwd = process.cwd()) {
-    const outputFlag = ` --output "${node_path_1.default.resolve(cwd, entry.outputDir)}"`;
-    const forceFlag = entry.force ? ' --force' : '';
-    const keepExistingFlag = entry.keepExisting ? ' --keep-existing' : '';
-    const gitignoreFlag = entry.gitignore === false ? ' --no-gitignore' : '';
-    const unmanagedFlag = entry.unmanaged ? ' --unmanaged' : '';
-    const silentFlag = entry.silent ? ' --silent' : '';
-    const verboseFlag = entry.verbose ? ' --verbose' : '';
-    const dryRunFlag = entry.dryRun ? ' --dry-run' : '';
-    const upgradeFlag = entry.upgrade ? ' --upgrade' : '';
-    const filesFlag = entry.files && entry.files.length > 0 ? ` --files "${entry.files.join(',')}"` : '';
-    const contentRegexFlag = entry.contentRegexes && entry.contentRegexes.length > 0
-        ? ` --content-regex "${entry.contentRegexes.join(',')}"`
-        : '';
-    return `node "${cliPath}" extract --packages "${entry.package}"${outputFlag}${forceFlag}${keepExistingFlag}${gitignoreFlag}${unmanagedFlag}${silentFlag}${verboseFlag}${dryRunFlag}${upgradeFlag}${filesFlag}${contentRegexFlag}`;
-}
-/**
- * Build a CLI command string that checks whether local files are in sync with the entry's package.
- */
-function buildCheckCommand(cliPath, entry, cwd = process.cwd()) {
-    const outputFlag = ` --output "${node_path_1.default.resolve(cwd, entry.outputDir)}"`;
-    const verboseFlag = entry.verbose ? ' --verbose' : '';
-    const filesFlag = entry.files && entry.files.length > 0 ? ` --files "${entry.files.join(',')}"` : '';
-    const contentRegexFlag = entry.contentRegexes && entry.contentRegexes.length > 0
-        ? ` --content-regex "${entry.contentRegexes.join(',')}"`
-        : '';
-    return `node "${cliPath}" check --packages "${entry.package}"${outputFlag}${verboseFlag}${filesFlag}${contentRegexFlag}`;
-}
-/**
- * Build a CLI command string that lists all managed files in the given output directory.
- */
-function buildListCommand(cliPath, outputDir, cwd = process.cwd(), verbose = false) {
-    const resolvedOutput = node_path_1.default.resolve(cwd, outputDir);
-    const verboseFlag = verbose ? ' --verbose' : '';
-    return `node "${cliPath}" list --output "${resolvedOutput}"${verboseFlag}`;
-}
-/**
- * Build a CLI command string that purges (removes) all managed files for the entry's package
- * from its output directory. No package installation is required.
- */
-function buildPurgeCommand(cliPath, entry, cwd = process.cwd()) {
-    const { name } = parseEntryPackageName(entry.package);
-    const outputFlag = ` --output "${node_path_1.default.resolve(cwd, entry.outputDir)}"`;
-    // Propagate silent/dry-run/verbose settings from the entry if present.
-    const silentFlag = entry.silent ? ' --silent' : '';
-    const verboseFlag = entry.verbose ? ' --verbose' : '';
-    const dryRunFlag = entry.dryRun ? ' --dry-run' : '';
-    return `node "${cliPath}" purge --packages "${name}"${outputFlag}${silentFlag}${verboseFlag}${dryRunFlag}`;
-}
-/**
- * Collects all unique tags that appear across the given npmdata entries, sorted alphabetically.
- */
-function collectAllTags(entries) {
-    const tagSet = new Set();
-    for (const entry of entries) {
-        if (entry.tags) {
-            for (const tag of entry.tags) {
-                tagSet.add(tag);
-            }
-        }
-    }
-    return Array.from(tagSet).sort();
-}
-/**
- * Prints a help message to stdout, listing the extract action, all options, and available tags.
- */
-function printHelp(packageName, availableTags) {
-    const tagsLine = availableTags.length > 0 ? availableTags.join(', ') : '(none defined in package.json)';
-    const exampleTag = availableTags.length > 0 ? availableTags[0] : 'my-tag';
-    process.stdout.write([
-        `Usage: ${packageName} <action> [options]`,
-        '',
-        'Actions:',
-        '  extract  Extract files from the source package(s) defined in package.json',
-        '  check    Verify local files are in sync with the source package(s)',
-        '  list     List all files managed by npmdata in the output directories',
-        '  purge    Remove all managed files previously extracted',
-        '',
-        'Options:',
-        '  --help              Show this help message',
-        '  --output, -o <dir>  Base directory for resolving all outputDir paths (default: cwd)',
-        '  --dry-run           Simulate changes without writing or deleting any files',
-        '  --tags <tag1,tag2>  Limit to entries whose tags overlap (comma-separated)',
-        '  --no-gitignore      Disable .gitignore management for every entry (overrides per-entry setting)',
-        '  --unmanaged         Run every entry in unmanaged mode (overrides per-entry setting)',
-        '  --verbose, -v       Print detailed progress information for each step',
-        '',
-        `Available tags: ${tagsLine}`,
-        '',
-        'Examples:',
-        `  ${packageName} extract`,
-        '    Extract files for all entries defined in package.json',
-        '',
-        `  ${packageName} extract --output <dir>`,
-        '    Extract files, resolving all outputDir paths relative to <dir> instead of cwd',
-        '',
-        `  ${packageName} extract --dry-run`,
-        '    Preview what would be extracted without writing any files',
-        '',
-        `  ${packageName} extract --tags ${exampleTag}`,
-        `    Extract files only for entries tagged "${exampleTag}"`,
-        '',
-        `  ${packageName} check`,
-        '    Check if local files are in sync with the source packages',
-        '',
-        `  ${packageName} list`,
-        '    List all files managed by npmdata in the output directories',
-        '',
-        `  ${packageName} purge`,
-        '    Remove all managed files from the output directories',
-        '',
-    ].join('\n'));
-}
-/**
- * Parses --output (or -o) from an argv array and returns the path string.
- * Returns undefined when the flag is not present.
- */
-function parseOutputFromArgv(argv) {
-    const idx = argv.findIndex((a) => a === '--output' || a === '-o');
-    if (idx === -1 || idx + 1 >= argv.length) {
-        // eslint-disable-next-line no-undefined
-        return undefined;
-    }
-    return argv[idx + 1];
-}
-/**
- * Returns true when --dry-run appears in the argv array.
- */
-function parseDryRunFromArgv(argv) {
-    return argv.includes('--dry-run');
-}
-/**
- * Returns true when --silent appears in the argv array.
- */
-function parseSilentFromArgv(argv) {
-    return argv.includes('--silent');
-}
-/**
- * Returns true when --verbose or -v appears in the argv array.
- */
-function parseVerboseFromArgv(argv) {
-    return argv.includes('--verbose') || argv.includes('-v');
-}
-/**
- * Returns true when --no-gitignore appears in the argv array.
- * When true, overrides the gitignore setting of every entry to false.
- */
-function parseNoGitignoreFromArgv(argv) {
-    return argv.includes('--no-gitignore');
-}
-/**
- * Returns true when --unmanaged appears in the argv array.
- * When true, overrides the unmanaged setting of every entry to true.
- */
-function parseUnmanagedFromArgv(argv) {
-    return argv.includes('--unmanaged');
-}
-/**
- * Parses --tags from an argv array and returns the list of requested tags (split by comma).
- * Returns an empty array when --tags is not present.
- */
-function parseTagsFromArgv(argv) {
-    const idx = argv.indexOf('--tags');
-    if (idx === -1 || idx + 1 >= argv.length) {
-        return [];
-    }
-    return argv[idx + 1]
-        .split(',')
-        .map((t) => t.trim())
-        .filter(Boolean);
-}
-/**
- * Filter entries by requested tags. When no tags are requested all entries pass through.
- * When tags are requested only entries that share at least one tag with the requested list
- * are included.
- */
-function filterEntriesByTags(entries, requestedTags) {
-    if (requestedTags.length === 0) {
-        return entries;
-    }
-    return entries.filter((entry) => entry.tags && entry.tags.some((t) => requestedTags.includes(t)));
-}
-// ─── Managed path helpers ──────────────────────────────────────────────────────
-/**
- * From the flat list of managed file paths (relative to outputDir) recorded in
- * the .npmdata marker, derive every unique path that can be symlinked: each
- * file itself plus every intermediate ancestor directory.
- *
- * Example: 'skills/skill-a/README.md' yields
- *   'skills', 'skills/skill-a', 'skills/skill-a/README.md'
- */
-function managedPathsWithAncestors(managedFiles) {
-    const paths = new Set();
-    for (const mf of managedFiles) {
-        // eslint-disable-next-line functional/immutable-data
-        paths.add(mf.path);
-        const parts = mf.path.split('/');
-        // Add each ancestor directory by accumulating path segments.
-        parts.slice(0, -1).reduce((prefix, seg) => {
-            const ancestor = prefix ? `${prefix}/${seg}` : seg;
-            // eslint-disable-next-line functional/immutable-data
-            paths.add(ancestor);
-            return ancestor;
-        }, '');
-    }
-    return Array.from(paths);
-}
-/**
- * Read the .npmdata marker from outputDir and return managed file metadata.
- * Returns an empty array when the marker does not exist.
- */
-function readManagedFiles(outputDir) {
-    const markerPath = node_path_1.default.join(outputDir, '.npmdata');
-    return node_fs_1.default.existsSync(markerPath) ? (0, utils_1.readCsvMarker)(markerPath) : [];
-}
-/**
- * Collect all existing symlinks in `targetDir` whose resolved (or as-written)
- * link target starts with `outputDir`.  Returns a map of basename → resolved
- * target path.  Dead symlinks that still point into outputDir are included so
- * that they can be cleaned up.
- */
-function collectManagedSymlinks(targetDir, outputDir) {
-    const owned = new Map();
-    if (!node_fs_1.default.existsSync(targetDir))
-        return owned;
-    // Resolve outputDir through any intermediate symlinks (e.g. /var → /private/var on macOS)
-    // so prefix comparisons work correctly on all platforms.
-    // eslint-disable-next-line functional/no-let, functional/no-try-statements
-    let resolvedOutputDir = outputDir;
-    // eslint-disable-next-line functional/no-try-statements
-    try {
-        resolvedOutputDir = node_fs_1.default.realpathSync(outputDir);
-    }
-    catch {
-        // If outputDir does not exist, fall back to the raw path.
-    }
-    const normalizedOutput = resolvedOutputDir.endsWith(node_path_1.default.sep)
-        ? resolvedOutputDir
-        : `${resolvedOutputDir}${node_path_1.default.sep}`;
-    for (const name of node_fs_1.default.readdirSync(targetDir)) {
-        const symlinkPath = node_path_1.default.join(targetDir, name);
-        const lstat = node_fs_1.default.lstatSync(symlinkPath);
-        if (lstat.isSymbolicLink()) {
-            // Try to resolve (handles live symlinks).
-            // eslint-disable-next-line functional/no-try-statements
-            try {
-                const resolved = node_fs_1.default.realpathSync(symlinkPath);
-                if (resolved === resolvedOutputDir || resolved.startsWith(normalizedOutput)) {
-                    owned.set(name, resolved);
-                }
-            }
-            catch {
-                // Dead symlink – read the raw link target to see if it points into outputDir.
-                const rawTarget = node_fs_1.default.readlinkSync(symlinkPath);
-                const absTarget = node_path_1.default.resolve(targetDir, rawTarget);
-                const resolvedAbsTarget = absTarget; // raw path is enough for dead-link check
-                if (resolvedAbsTarget === outputDir ||
-                    resolvedAbsTarget.startsWith(`${outputDir}${node_path_1.default.sep}`)) {
-                    owned.set(name, absTarget);
-                }
-            }
-        }
-    }
-    return owned;
-}
-/**
- * Determine the symlink action for a single target path.
- * Returns 'create' when the path does not exist, 'update' when an out-of-date
- * managed symlink exists, or 'skip' when nothing should be done.
- */
-function symlinkAction(symlinkPath, sourcePath, isManaged) {
-    // eslint-disable-next-line functional/no-try-statements
-    try {
-        const lstat = node_fs_1.default.lstatSync(symlinkPath);
-        if (!lstat.isSymbolicLink())
-            return 'skip'; // Non-symlink – never clobber.
-        if (!isManaged)
-            return 'skip'; // Not managed by npmdata – leave alone.
-        // Managed symlink: only recreate if the target has drifted.
-        // eslint-disable-next-line functional/no-try-statements
-        try {
-            return node_fs_1.default.realpathSync(symlinkPath) === sourcePath ? 'skip' : 'update';
-        }
-        catch {
-            return 'update'; // Dead link – recreate.
-        }
-    }
-    catch {
-        return 'create'; // Path does not exist.
-    }
-}
-// ─── Post-extract operations ───────────────────────────────────────────────────
-/**
- * Apply the symlink configs from an extraction entry.
- *
- * For each config:
- *  1. Expands the `source` glob inside the resolved `outputDir`.
- *  2. Ensures the `target` directory exists.
- *  3. Removes stale symlinks from the target dir that previously pointed into
- *     outputDir but are no longer matched by the current glob result.
- *  4. Creates (or updates) symlinks for every matched file/directory.
- *
- * Only symlinks whose targets live inside outputDir are managed; any other
- * symlinks in the target directory are left untouched.
- */
-function applySymlinks(entry, cwd = process.cwd()) {
-    if (!entry.symlinks || entry.symlinks.length === 0)
-        return;
-    const outputDir = node_path_1.default.resolve(cwd, entry.outputDir);
-    const allManagedPaths = managedPathsWithAncestors(readManagedFiles(outputDir));
-    for (const cfg of entry.symlinks) {
-        const targetDir = node_path_1.default.resolve(cwd, cfg.target);
-        node_fs_1.default.mkdirSync(targetDir, { recursive: true });
-        // Build desired symlink map from managed paths (files + ancestor dirs) matching the source pattern.
-        const desired = new Map();
-        for (const relPath of allManagedPaths) {
-            if ((0, minimatch_1.minimatch)(relPath, cfg.source, { dot: true })) {
-                const absMatch = node_path_1.default.join(outputDir, relPath);
-                desired.set(node_path_1.default.basename(absMatch), absMatch);
-            }
-        }
-        // Remove stale managed symlinks that are no longer in the desired set.
-        const existing = collectManagedSymlinks(targetDir, outputDir);
-        for (const [basename] of existing) {
-            if (!desired.has(basename)) {
-                const symlinkPath = node_path_1.default.join(targetDir, basename);
-                node_fs_1.default.unlinkSync(symlinkPath);
-                if (!entry.silent) {
-                    // eslint-disable-next-line no-console
-                    console.log(`D\t${node_path_1.default.relative(cwd, symlinkPath)}`);
-                }
-            }
-        }
-        // Create or update symlinks.
-        for (const [basename, sourcePath] of desired) {
-            const symlinkPath = node_path_1.default.join(targetDir, basename);
-            const action = symlinkAction(symlinkPath, sourcePath, existing.has(basename));
-            if (action === 'update') {
-                node_fs_1.default.unlinkSync(symlinkPath);
-                node_fs_1.default.symlinkSync(sourcePath, symlinkPath);
-                if (!entry.silent) {
-                    // eslint-disable-next-line no-console
-                    console.log(`M\t${node_path_1.default.relative(cwd, symlinkPath)}`);
-                }
-            }
-            else if (action === 'create') {
-                node_fs_1.default.symlinkSync(sourcePath, symlinkPath);
-                if (!entry.silent) {
-                    // eslint-disable-next-line no-console
-                    console.log(`A\t${node_path_1.default.relative(cwd, symlinkPath)}`);
-                }
-            }
-            // 'skip' → do nothing
-        }
-    }
-}
-/**
- * Apply the content-replacement configs from an extraction entry.
- *
- * For each config:
- *  1. Expands the `files` glob inside `cwd`.
- *  2. Reads each matched file.
- *  3. Applies the regex replacement (global, multiline).
- *  4. Writes the file back only when the content changed.
- */
-function applyContentReplacements(entry, cwd = process.cwd()) {
-    if (!entry.contentReplacements || entry.contentReplacements.length === 0)
-        return;
-    const outputDir = node_path_1.default.resolve(cwd, entry.outputDir);
-    const managedFiles = readManagedFiles(outputDir);
-    for (const cfg of entry.contentReplacements) {
-        const regex = new RegExp(cfg.match, 'gm');
-        for (const mf of managedFiles) {
-            if ((0, minimatch_1.minimatch)(mf.path, cfg.files, { dot: true })) {
-                const filePath = node_path_1.default.join(outputDir, mf.path);
-                if (node_fs_1.default.existsSync(filePath)) {
-                    const original = node_fs_1.default.readFileSync(filePath, 'utf8');
-                    const updated = original.replace(regex, cfg.replace);
-                    if (updated !== original) {
-                        node_fs_1.default.writeFileSync(filePath, updated, 'utf8');
-                    }
-                }
-            }
-        }
-    }
-}
-/**
- * Check whether the content-replacement configs from an extraction entry are
- * currently in effect in the workspace.
- *
- * Returns a list of file paths where the replacement pattern still matches
- * (i.e. the replacement has not been applied or has drifted).  An empty list
- * means everything is in sync.
- */
-function checkContentReplacements(entry, cwd = process.cwd()) {
-    if (!entry.contentReplacements || entry.contentReplacements.length === 0)
-        return [];
-    const outputDir = node_path_1.default.resolve(cwd, entry.outputDir);
-    const managedFiles = readManagedFiles(outputDir);
-    const outOfSync = [];
-    for (const cfg of entry.contentReplacements) {
-        const regex = new RegExp(cfg.match, 'gm');
-        for (const mf of managedFiles) {
-            if ((0, minimatch_1.minimatch)(mf.path, cfg.files, { dot: true })) {
-                const filePath = node_path_1.default.join(outputDir, mf.path);
-                if (node_fs_1.default.existsSync(filePath)) {
-                    const content = node_fs_1.default.readFileSync(filePath, 'utf8');
-                    // A file is out of sync when applying the replacement would change it.
-                    const expected = content.replace(regex, cfg.replace);
-                    if (expected !== content) {
-                        // eslint-disable-next-line functional/immutable-data
-                        outOfSync.push(filePath);
-                    }
-                }
-            }
-        }
-    }
-    return outOfSync;
-}
-// ─── Action handlers ───────────────────────────────────────────────────────────
-/**
- * Run a shell command, capturing its stdout while inheriting stderr.
- * The captured stdout is immediately written to process.stdout so the caller
- * sees it in real time (well, after the child exits).  Returns the full
- * captured stdout string and the child's exit code.  Non-zero exit codes do
- * NOT throw; callers are responsible for checking exitCode.
- */
-function runCommandCapture(command, cwd) {
-    // eslint-disable-next-line functional/no-try-statements
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
-        const stdout = (0, node_child_process_1.execSync)(command, {
-            encoding: 'utf8',
-            cwd,
-            stdio: ['inherit', 'pipe', 'inherit'],
-        }) ?? '';
-        process.stdout.write(stdout);
-        return { stdout, exitCode: 0 };
-    }
-    catch (error) {
-        const err = error;
-        const stdout = err.stdout ?? '';
-        process.stdout.write(stdout);
-        return { stdout, exitCode: err.status ?? 1 };
-    }
-}
-// eslint-disable-next-line complexity
-function runExtract(entries, excludedEntries, cliPath, runCwd, dryRunFromArgv, silentFromArgv, verboseFromArgv, noGitignoreFromArgv, unmanagedFromArgv) {
-    if (verboseFromArgv) {
-        // eslint-disable-next-line no-console
-        console.log(`[verbose] extract: processing ${entries.length} entr${entries.length === 1 ? 'y' : 'ies'} (cwd: ${runCwd})`);
-    }
-    // eslint-disable-next-line functional/no-let
-    let totalAdded = 0;
-    // eslint-disable-next-line functional/no-let
-    let totalModified = 0;
-    // eslint-disable-next-line functional/no-let
-    let totalDeleted = 0;
-    // eslint-disable-next-line functional/no-let
-    let totalSkipped = 0;
-    // eslint-disable-next-line functional/no-let
-    let entryIndex = 0;
-    for (const entry of entries) {
-        const effectiveSilent = entry.silent || silentFromArgv;
-        if (entryIndex > 0 && !effectiveSilent) {
-            process.stdout.write('\n');
-        }
-        entryIndex += 1;
-        const effectiveEntry = {
-            ...entry,
-            dryRun: entry.dryRun || dryRunFromArgv,
-            silent: effectiveSilent,
-            verbose: entry.verbose || verboseFromArgv,
-            ...(noGitignoreFromArgv ? { gitignore: false } : {}),
-            ...(unmanagedFromArgv ? { unmanaged: true } : {}),
-        };
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] extract: entry package=${entry.package} outputDir=${entry.outputDir}`);
-        }
-        node_fs_1.default.mkdirSync(node_path_1.default.resolve(runCwd, entry.outputDir), { recursive: true });
-        const command = buildExtractCommand(cliPath, effectiveEntry, runCwd);
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] extract: running command: ${command}`);
-        }
-        const { stdout: extractStdout, exitCode: extractExitCode } = runCommandCapture(command, runCwd);
-        if (extractExitCode !== 0) {
-            throw Object.assign(new Error('extract failed'), { status: extractExitCode });
-        }
-        const extractMatch = extractStdout.match(/Extraction complete:\s*(\d+) added,\s*(\d+) modified,\s*(\d+) deleted,\s*(\d+) skipped/);
-        if (extractMatch) {
-            totalAdded += Number.parseInt(extractMatch[1], 10);
-            totalModified += Number.parseInt(extractMatch[2], 10);
-            totalDeleted += Number.parseInt(extractMatch[3], 10);
-            totalSkipped += Number.parseInt(extractMatch[4], 10);
-        }
-        if (!effectiveEntry.dryRun) {
-            if (verboseFromArgv) {
-                // eslint-disable-next-line no-console
-                console.log(`[verbose] extract: applying symlinks for ${entry.package}`);
-            }
-            applySymlinks(effectiveEntry, runCwd);
-            if (verboseFromArgv) {
-                // eslint-disable-next-line no-console
-                console.log(`[verbose] extract: applying content replacements for ${entry.package}`);
-            }
-            applyContentReplacements(entry, runCwd);
-        }
-    }
-    // When a tag filter is active, purge managed files from excluded entries so that
-    // the output directory contains only files from the currently active tag group.
-    // Suppress the "Purging managed files..." banner for these implicit purges.
-    for (const entry of excludedEntries) {
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] extract: purging excluded entry ${entry.package} (tag filter active)`);
-        }
-        const effectiveEntry = {
-            ...entry,
-            dryRun: entry.dryRun || dryRunFromArgv,
-            silent: true,
-        };
-        const command = buildPurgeCommand(cliPath, effectiveEntry, runCwd);
-        (0, node_child_process_1.execSync)(command, { stdio: 'inherit', cwd: runCwd });
-    }
-    if (!silentFromArgv && entries.length > 1) {
-        process.stdout.write(`\nTotal extracted: ${totalAdded} added, ${totalModified} modified, ${totalDeleted} deleted, ${totalSkipped} skipped${dryRunFromArgv ? ' (dry run)' : ''}\n`);
-    }
-}
-function runCheck(entries, cliPath, runCwd, verboseFromArgv, unmanagedFromArgv) {
-    const managedEntries = entries.filter((entry) => {
-        const isUnmanaged = entry.unmanaged || unmanagedFromArgv;
-        if (isUnmanaged && verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] check: skipping unmanaged entry package=${entry.package} outputDir=${entry.outputDir}`);
-        }
-        return !isUnmanaged;
-    });
-    if (verboseFromArgv) {
-        // eslint-disable-next-line no-console
-        console.log(`[verbose] check: verifying ${managedEntries.length} entr${managedEntries.length === 1 ? 'y' : 'ies'} (cwd: ${runCwd})`);
-    }
-    // eslint-disable-next-line functional/no-let
-    let outOfSyncFiles = [];
-    // eslint-disable-next-line functional/no-let
-    let checkIndex = 0;
-    for (const entry of managedEntries) {
-        if (checkIndex > 0) {
-            process.stdout.write('\n');
-        }
-        checkIndex += 1;
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] check: checking package=${entry.package} outputDir=${entry.outputDir}`);
-        }
-        const effectiveEntry = {
-            ...entry,
-            verbose: entry.verbose || verboseFromArgv,
-        };
-        const command = buildCheckCommand(cliPath, effectiveEntry, runCwd);
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] check: running command: ${command}`);
-        }
-        const { exitCode: checkExitCode } = runCommandCapture(command, runCwd);
-        if (checkExitCode !== 0) {
-            throw Object.assign(new Error('check failed'), { status: checkExitCode });
-        }
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] check: checking content replacements for ${entry.package}`);
-        }
-        const entryOutOfSync = checkContentReplacements(entry, runCwd);
-        for (const f of entryOutOfSync) {
-            process.stderr.write(`content-replacement out of sync: ${f}\n`);
-        }
-        // eslint-disable-next-line functional/immutable-data
-        outOfSyncFiles = [...outOfSyncFiles, ...entryOutOfSync];
-    }
-    if (outOfSyncFiles.length > 0) {
-        throw Object.assign(new Error('content-replacements out of sync'), { status: 1 });
-    }
-    if (managedEntries.length > 1) {
-        process.stdout.write(`\nTotal checked: ${managedEntries.length} packages\n`);
-    }
-}
-function runList(allEntries, cliPath, runCwd, verboseFromArgv) {
-    // Collect unique resolved output dirs (tag filter not applied; list is informational).
-    const seenDirs = new Set();
-    if (verboseFromArgv) {
-        // eslint-disable-next-line no-console
-        console.log(`[verbose] list: listing managed files across ${allEntries.length} entr${allEntries.length === 1 ? 'y' : 'ies'} (cwd: ${runCwd})`);
-    }
-    for (const entry of allEntries) {
-        const resolvedDir = node_path_1.default.resolve(runCwd, entry.outputDir);
-        if (!seenDirs.has(resolvedDir)) {
-            seenDirs.add(resolvedDir);
-            if (verboseFromArgv) {
-                // eslint-disable-next-line no-console
-                console.log(`[verbose] list: scanning directory ${resolvedDir}`);
-            }
-            const command = buildListCommand(cliPath, entry.outputDir, runCwd, verboseFromArgv);
-            (0, node_child_process_1.execSync)(command, { stdio: 'inherit', cwd: runCwd });
-        }
-    }
-}
-// eslint-disable-next-line complexity
-function runPurge(entries, cliPath, runCwd, dryRunFromArgv, silentFromArgv, verboseFromArgv) {
-    if (verboseFromArgv) {
-        // eslint-disable-next-line no-console
-        console.log(`[verbose] purge: processing ${entries.length} entr${entries.length === 1 ? 'y' : 'ies'} (cwd: ${runCwd})`);
-    }
-    // eslint-disable-next-line functional/no-let
-    let totalDeleted = 0;
-    // eslint-disable-next-line functional/no-let
-    let purgeIndex = 0;
-    for (const entry of entries) {
-        const effectiveSilent = entry.silent || silentFromArgv;
-        if (purgeIndex > 0 && !effectiveSilent) {
-            process.stdout.write('\n');
-        }
-        purgeIndex += 1;
-        const effectiveEntry = {
-            ...entry,
-            dryRun: entry.dryRun || dryRunFromArgv,
-            silent: effectiveSilent,
-            verbose: entry.verbose || verboseFromArgv,
-        };
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] purge: entry package=${entry.package} outputDir=${entry.outputDir}`);
-        }
-        const command = buildPurgeCommand(cliPath, effectiveEntry, runCwd);
-        if (verboseFromArgv) {
-            // eslint-disable-next-line no-console
-            console.log(`[verbose] purge: running command: ${command}`);
-        }
-        const { stdout: purgeStdout, exitCode: purgeExitCode } = runCommandCapture(command, runCwd);
-        if (purgeExitCode !== 0) {
-            throw Object.assign(new Error('purge failed'), { status: purgeExitCode });
-        }
-        const purgeMatch = purgeStdout.match(/Purge complete:\s*(\d+) deleted/);
-        if (purgeMatch) {
-            totalDeleted += Number.parseInt(purgeMatch[1], 10);
-        }
-        if (!effectiveEntry.dryRun) {
-            if (verboseFromArgv) {
-                // eslint-disable-next-line no-console
-                console.log(`[verbose] purge: cleaning up symlinks for ${entry.package}`);
-            }
-            applySymlinks(effectiveEntry, runCwd);
-        }
-    }
-    if (!silentFromArgv && entries.length > 1) {
-        process.stdout.write(`\nTotal purged: ${totalDeleted}${dryRunFromArgv ? ' (dry run)' : ''}\n`);
-    }
-}
-/**
- * Run a given action for a list of pre-loaded npmdata entries.
- * Parses common flags (--tags, --output, --dry-run, --silent, --verbose, --no-gitignore,
- * --unmanaged) from argv and delegates to the appropriate action handler.
- *
- * Called from the CLI when a cosmiconfig configuration file is found and --packages is not
- * provided, so the same runner logic used by embedded data-package runners is reused.
- *
- * @param allEntries - Array of NpmdataExtractEntry loaded from the configuration.
- * @param action     - One of 'extract', 'check', 'list', 'purge'.
- * @param argv       - Full process.argv (or equivalent); [0] and [1] are the node binary and
- *                     script path which are sliced off internally.
- * @param cliPath    - Absolute path to the npmdata CLI main.js that sub-processes will invoke.
- */
-function runEntries(allEntries, action, argv, cliPath) {
-    const userArgs = argv.slice(2);
-    const requestedTags = parseTagsFromArgv(argv);
-    const entries = filterEntriesByTags(allEntries, requestedTags);
-    const excludedEntries = requestedTags.length > 0 ? allEntries.filter((e) => !entries.includes(e)) : [];
-    const parsedOutput = parseOutputFromArgv(userArgs);
-    const runCwd = parsedOutput ? node_path_1.default.resolve(process.cwd(), parsedOutput) : process.cwd();
-    const dryRunFromArgv = parseDryRunFromArgv(userArgs);
-    const silentFromArgv = parseSilentFromArgv(userArgs);
-    const verboseFromArgv = parseVerboseFromArgv(userArgs);
-    const noGitignoreFromArgv = parseNoGitignoreFromArgv(userArgs);
-    const unmanagedFromArgv = parseUnmanagedFromArgv(userArgs);
-    if (verboseFromArgv) {
-        // eslint-disable-next-line no-console
-        console.log(`[verbose] runner: action=${action} entries=${entries.length} cwd=${runCwd}`);
-    }
-    // eslint-disable-next-line functional/no-try-statements
-    try {
-        if (action === 'extract') {
-            runExtract(entries, excludedEntries, cliPath, runCwd, dryRunFromArgv, silentFromArgv, verboseFromArgv, noGitignoreFromArgv, unmanagedFromArgv);
-        }
-        else if (action === 'check') {
-            runCheck(entries, cliPath, runCwd, verboseFromArgv, unmanagedFromArgv);
-        }
-        else if (action === 'list') {
-            runList(allEntries, cliPath, runCwd, verboseFromArgv);
-        }
-        else if (action === 'purge') {
-            runPurge(entries, cliPath, runCwd, dryRunFromArgv, silentFromArgv, verboseFromArgv);
-        }
-    }
-    catch (error) {
-        // The child process already printed the error via stdio:inherit.
-        // Exit with the child's exit code to suppress the Node.js stack trace.
-        const status = error?.status;
-        // eslint-disable-next-line unicorn/no-process-exit
-        process.exit(status ?? 1);
-    }
-}
-/**
- * Runs extraction for each entry defined in the publishable package's package.json "npmdata" array.
- * Invokes the npmdata CLI once per entry so that all CLI output and error handling is preserved.
- * Called from the minimal generated bin script with its own __dirname as binDir.
- *
- * Pass --tags <tag1,tag2> to limit processing to entries whose tags overlap with the given list.
- */
-function run(binDir, argv = process.argv) {
-    const pkgJsonPath = node_path_1.default.join(binDir, '../package.json');
-    const pkg = JSON.parse(node_fs_1.default.readFileSync(pkgJsonPath).toString());
-    const allEntries = pkg.npmdata?.sets && pkg.npmdata.sets.length > 0
-        ? pkg.npmdata.sets
-        : [{ package: pkg.name, outputDir: '.' }];
-    const userArgs = argv.slice(2);
-    if (userArgs.includes('--help')) {
-        printHelp(pkg.name, collectAllTags(allEntries));
-        return;
-    }
-    // Default to 'extract' when no action is provided or the first arg is a flag.
-    const action = userArgs.length === 0 || userArgs[0].startsWith('-') ? 'extract' : userArgs[0];
-    if (!['extract', 'check', 'list', 'purge'].includes(action)) {
-        process.stderr.write(`Error: unknown action '${action}'. Use 'extract', 'check', 'list', or 'purge'.\n\n`);
-        printHelp(pkg.name, collectAllTags(allEntries));
-        return;
-    }
-    const requestedTags = parseTagsFromArgv(argv);
-    const entries = filterEntriesByTags(allEntries, requestedTags);
-    const excludedEntries = requestedTags.length > 0 ? allEntries.filter((e) => !entries.includes(e)) : [];
-    const cliPath = require.resolve('npmdata/dist/main.js', { paths: [binDir] });
-    const parsedOutput = parseOutputFromArgv(userArgs);
-    const runCwd = parsedOutput ? node_path_1.default.resolve(process.cwd(), parsedOutput) : process.cwd();
-    const dryRunFromArgv = parseDryRunFromArgv(userArgs);
-    const silentFromArgv = parseSilentFromArgv(userArgs);
-    const verboseFromArgv = parseVerboseFromArgv(userArgs);
-    const noGitignoreFromArgv = parseNoGitignoreFromArgv(userArgs);
-    const unmanagedFromArgv = parseUnmanagedFromArgv(userArgs);
-    if (verboseFromArgv) {
-        // eslint-disable-next-line no-console
-        console.log(`[verbose] runner: action=${action} entries=${entries.length} cwd=${runCwd}`);
-    }
-    // eslint-disable-next-line functional/no-try-statements
-    try {
-        if (action === 'extract') {
-            runExtract(entries, excludedEntries, cliPath, runCwd, dryRunFromArgv, silentFromArgv, verboseFromArgv, noGitignoreFromArgv, unmanagedFromArgv);
-        }
-        else if (action === 'check') {
-            runCheck(entries, cliPath, runCwd, verboseFromArgv, unmanagedFromArgv);
-        }
-        else if (action === 'list') {
-            runList(allEntries, cliPath, runCwd, verboseFromArgv);
-        }
-        else if (action === 'purge') {
-            runPurge(entries, cliPath, runCwd, dryRunFromArgv, silentFromArgv, verboseFromArgv);
-        }
-    }
-    catch (error) {
-        // The child process already printed the error via stdio:inherit.
-        // Exit with the child's exit code to suppress the Node.js stack trace.
-        const status = error?.status;
-        // eslint-disable-next-line unicorn/no-process-exit
-        process.exit(status ?? 1);
-    }
-}
-//# sourceMappingURL=runner.js.map