@fnndsc/chell 4.2.8

package/dist/builtins/fs/du.d.ts

@@ -0,0 +1,58 @@
+import { ParsedArgs } from '../utils.js';
+import { type ScanRecord } from '@fnndsc/chili/path/pathCommand.js';
+/**
+ * Parsed flags controlling `du` output.
+ */
+export interface DuOptions {
+    humanReadable: boolean;
+    summarize: boolean;
+    showAll: boolean;
+    showTotal: boolean;
+    separateDirs: boolean;
+    maxDepth: number | undefined;
+}
+/**
+ * Formats a byte count for `du` output: human-readable string or KB integer,
+ * right-padded to 12 characters for column alignment.
+ *
+ * @param bytes - Raw byte count.
+ * @param humanReadable - If true, format as human-readable (e.g. `1.2M`).
+ * @returns Right-aligned size string.
+ */
+export declare function duSize_format(bytes: number, humanReadable: boolean): string;
+/**
+ * Extracts `du` flags from parsed command arguments.
+ *
+ * @param parsed - The parsed command arguments.
+ * @returns The resolved du options.
+ */
+export declare function duOptions_parse(parsed: ParsedArgs): DuOptions;
+/**
+ * Accumulates per-directory sizes from a scan result, attributing each file's
+ * size to its ancestor directories up to (and including) the target path.
+ *
+ * @param scanResult - The recursive scan result.
+ * @param targetPath - The directory being measured.
+ * @param opts - The du options (separateDirs / showAll affect attribution).
+ * @returns A map of directory path to accumulated size.
+ */
+export declare function dirSizes_compute(scanResult: ScanRecord, targetPath: string, opts: DuOptions): Map<string, number>;
+/**
+ * Displays disk usage statistics for ChRIS filesystem directories.
+ * Mimics standard Linux du command behavior and flags.
+ * Uses chili's scan_do machinery for recursive filesystem traversal.
+ *
+ * @param args - Command line arguments (optional path and flags).
+ * @returns A Promise that resolves when disk usage is displayed.
+ *
+ * @example
+ * ```
+ * du                      # Disk usage of current directory
+ * du -h                   # Human-readable sizes
+ * du -s /home/user/data   # Summary only
+ * du -a                   # Show all files, not just directories
+ * du -c                   # Show grand total
+ * du -d 2                 # Max depth of 2 levels
+ * ```
+ */
+export declare function builtin_du(args: string[]): Promise<void>;

package/dist/builtins/fs/du.js

@@ -0,0 +1,210 @@
+/**
+ * @file Builtin du command.
+ * Displays disk usage.
+ */
+import chalk from 'chalk';
+import path from 'path';
+import { commandArgs_process, path_resolve } from '../utils.js';
+import { session } from '../../session/index.js';
+import { vfs } from '../../lib/vfs/vfs.js';
+import { spinner } from '../../lib/spinner.js';
+import { scan_do } from '@fnndsc/chili/path/pathCommand.js';
+import { bytes_format } from '@fnndsc/chili/commands/fs/upload.js';
+/**
+ * Formats a byte count for `du` output: human-readable string or KB integer,
+ * right-padded to 12 characters for column alignment.
+ *
+ * @param bytes - Raw byte count.
+ * @param humanReadable - If true, format as human-readable (e.g. `1.2M`).
+ * @returns Right-aligned size string.
+ */
+export function duSize_format(bytes, humanReadable) {
+    const formatted = humanReadable
+        ? bytes_format(bytes)
+        : Math.ceil(bytes / 1024).toString();
+    return formatted.padStart(12, ' ');
+}
+/**
+ * Extracts `du` flags from parsed command arguments.
+ *
+ * @param parsed - The parsed command arguments.
+ * @returns The resolved du options.
+ */
+export function duOptions_parse(parsed) {
+    const maxDepth = parsed['d']
+        ? parseInt(String(parsed['d']), 10)
+        : parsed['max-depth']
+            ? parseInt(String(parsed['max-depth']), 10)
+            : undefined;
+    return {
+        humanReadable: !!parsed['h'] || !!parsed['human-readable'],
+        summarize: !!parsed['s'] || !!parsed['summarize'],
+        showAll: !!parsed['a'] || !!parsed['all'],
+        showTotal: !!parsed['c'] || !!parsed['total'],
+        separateDirs: !!parsed['S'] || !!parsed['separate-dirs'],
+        maxDepth,
+    };
+}
+/**
+ * Resolves whether a target path is a directory or a file (with size).
+ *
+ * @param targetPath - The resolved ChRIS path to stat.
+ * @returns A TargetStat on success, or an error message string on failure.
+ */
+async function targetStat_resolve(targetPath) {
+    try {
+        const result = await vfs.data_get(targetPath, { directory: true });
+        if (result.ok && result.value.length > 0) {
+            const item = result.value[0];
+            if (item.type === 'dir' || item.type === 'vfs') {
+                return { isDirectory: true, fileSize: 0 };
+            }
+            return { isDirectory: false, fileSize: item.size || 0 };
+        }
+        return `du: cannot access '${targetPath}': No such file or directory`;
+    }
+    catch (e) {
+        return `du: cannot access '${targetPath}': ${e}`;
+    }
+}
+/**
+ * Accumulates per-directory sizes from a scan result, attributing each file's
+ * size to its ancestor directories up to (and including) the target path.
+ *
+ * @param scanResult - The recursive scan result.
+ * @param targetPath - The directory being measured.
+ * @param opts - The du options (separateDirs / showAll affect attribution).
+ * @returns A map of directory path to accumulated size.
+ */
+export function dirSizes_compute(scanResult, targetPath, opts) {
+    const dirSizes = new Map();
+    scanResult.fileInfo.forEach((fileInfo) => {
+        const filePath = fileInfo.chrisPath;
+        const fSize = fileInfo.size;
+        if (fileInfo.isDirectory) {
+            if (!dirSizes.has(filePath)) {
+                dirSizes.set(filePath, 0);
+            }
+            return;
+        }
+        // File: add to its parent directory and all ancestor directories,
+        // but only up to the targetPath currently being scanned.
+        let currentPath = path.posix.dirname(filePath);
+        while (currentPath && currentPath.startsWith(targetPath)) {
+            const currentSize = dirSizes.get(currentPath) || 0;
+            dirSizes.set(currentPath, currentSize + fSize);
+            if (currentPath === targetPath)
+                break;
+            if (opts.separateDirs)
+                break;
+            currentPath = path.posix.dirname(currentPath);
+        }
+        if (opts.showAll) {
+            dirSizes.set(filePath, fSize);
+        }
+    });
+    // Ensure the target directory itself exists in the map with total size.
+    if (!dirSizes.has(targetPath)) {
+        dirSizes.set(targetPath, scanResult.totalSize);
+    }
+    return dirSizes;
+}
+/**
+ * Renders accumulated directory sizes to stdout, honouring summary and
+ * max-depth options.
+ *
+ * @param dirSizes - Map of directory path to size.
+ * @param targetPath - The directory being measured.
+ * @param opts - The du options.
+ */
+function dirUsage_render(dirSizes, targetPath, opts) {
+    if (opts.summarize) {
+        const size = dirSizes.get(targetPath) || 0;
+        console.log(`${duSize_format(size, opts.humanReadable)}\t${targetPath}`);
+        return;
+    }
+    const entries = Array.from(dirSizes.entries());
+    entries.sort((a, b) => a[0].localeCompare(b[0]));
+    for (const [dirPath, dirSize] of entries) {
+        if (opts.maxDepth !== undefined) {
+            const rel = path.posix.relative(targetPath, dirPath);
+            const depth = rel === '' ? 0 : rel.split('/').length;
+            if (depth > opts.maxDepth)
+                continue;
+        }
+        console.log(`${duSize_format(dirSize, opts.humanReadable)}\t${dirPath}`);
+    }
+}
+/**
+ * Displays disk usage statistics for ChRIS filesystem directories.
+ * Mimics standard Linux du command behavior and flags.
+ * Uses chili's scan_do machinery for recursive filesystem traversal.
+ *
+ * @param args - Command line arguments (optional path and flags).
+ * @returns A Promise that resolves when disk usage is displayed.
+ *
+ * @example
+ * ```
+ * du                      # Disk usage of current directory
+ * du -h                   # Human-readable sizes
+ * du -s /home/user/data   # Summary only
+ * du -a                   # Show all files, not just directories
+ * du -c                   # Show grand total
+ * du -d 2                 # Max depth of 2 levels
+ * ```
+ */
+export async function builtin_du(args) {
+    const parsed = commandArgs_process(args);
+    const opts = duOptions_parse(parsed);
+    const pathArgs = parsed._;
+    const originalFolder = await session.getCWD();
+    const rawTargets = pathArgs.length > 0 ? pathArgs : ['.'];
+    const resolvedTargets = [];
+    for (const raw of rawTargets) {
+        resolvedTargets.push(await path_resolve(raw));
+    }
+    let grandTotal = 0;
+    try {
+        for (const targetPath of resolvedTargets) {
+            const argLabel = path.basename(targetPath);
+            spinner.start(`Scanning ${argLabel}...`);
+            const stat = await targetStat_resolve(targetPath);
+            if (typeof stat === 'string') {
+                spinner.stop();
+                console.error(chalk.red(stat));
+                continue;
+            }
+            if (!stat.isDirectory) {
+                grandTotal += stat.fileSize;
+                spinner.stop();
+                console.log(`${duSize_format(stat.fileSize, opts.humanReadable)}\t${targetPath}`);
+                continue;
+            }
+            await session.setCWD(targetPath);
+            const scanOptions = {
+                silent: true,
+                tree: false,
+                follow: false,
+                dirsOnly: false,
+            };
+            const scanResult = await scan_do(scanOptions);
+            await session.setCWD(originalFolder);
+            if (!scanResult) {
+                spinner.stop();
+                continue;
+            }
+            const dirSizes = dirSizes_compute(scanResult, targetPath, opts);
+            grandTotal += scanResult.totalSize;
+            spinner.stop();
+            dirUsage_render(dirSizes, targetPath, opts);
+        }
+        if (opts.showTotal && rawTargets.length > 0) {
+            console.log(`${duSize_format(grandTotal, opts.humanReadable)}\ttotal`);
+        }
+    }
+    finally {
+        spinner.stop();
+        await session.setCWD(originalFolder);
+    }
+}
+//# sourceMappingURL=du.js.map

package/dist/builtins/fs/du.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"du.js","sourceRoot":"","sources":["../../../src/builtins/fs/du.ts"],"names":[],"mappings":"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"}

package/dist/builtins/fs/edit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Opens a ChRIS file in $EDITOR. On save, replaces the original via
+ * delete + re-upload. No-ops if content is unchanged.
+ *
+ * @param args - [filePath, ...]
+ */
+export declare function builtin_edit(args: string[]): Promise<void>;

package/dist/builtins/fs/edit.js

@@ -0,0 +1,86 @@
+/**
+ * @file Builtin edit command.
+ * Fetches a ChRIS file, opens it in $EDITOR, then deletes and re-uploads on save.
+ */
+import { spawnSync } from 'child_process';
+import { writeFileSync, readFileSync, unlinkSync, existsSync } from 'fs';
+import { tmpdir } from 'os';
+import { join, extname, posix } from 'path';
+import chalk from 'chalk';
+import { path_resolve, error_stripDebugPrefix } from '../utils.js';
+import { files_cat } from '@fnndsc/chili/commands/fs/cat.js';
+import { file_replaceContent } from '@fnndsc/chili/commands/fs/edit.js';
+import { errorStack, listCache_get } from '@fnndsc/cumin';
+const BINARY_EXTENSIONS = new Set([
+    '.dcm', '.png', '.jpg', '.jpeg', '.gif', '.bmp', '.webp', '.ico',
+    '.pdf', '.zip', '.tar', '.gz', '.bz2', '.xz', '.7z',
+    '.exe', '.dll', '.so', '.bin', '.mp3', '.mp4', '.avi', '.wav',
+]);
+/**
+ * Opens a ChRIS file in $EDITOR. On save, replaces the original via
+ * delete + re-upload. No-ops if content is unchanged.
+ *
+ * @param args - [filePath, ...]
+ */
+export async function builtin_edit(args) {
+    if (args.length === 0) {
+        console.error(chalk.red('Usage: edit <file>'));
+        process.exitCode = 1;
+        return;
+    }
+    const target = await path_resolve(args[0]);
+    const ext = extname(target).toLowerCase();
+    if (BINARY_EXTENSIONS.has(ext)) {
+        console.error(chalk.red(`edit: ${args[0]}: binary file (${ext}), cannot edit as text`));
+        process.exitCode = 1;
+        return;
+    }
+    const catResult = await files_cat(target);
+    if (!catResult.ok) {
+        const err = errorStack.stack_pop();
+        console.error(chalk.red(`edit: ${err ? error_stripDebugPrefix(err.message) : 'Failed to read file'}`));
+        process.exitCode = 1;
+        return;
+    }
+    const originalContent = catResult.value;
+    const tmpPath = join(tmpdir(), `chell-edit-${Date.now()}${ext || '.txt'}`);
+    let keepTmp = false;
+    try {
+        writeFileSync(tmpPath, originalContent, 'utf8');
+        const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
+        const spawn = spawnSync(editor, [tmpPath], { stdio: 'inherit' });
+        if (spawn.error) {
+            console.error(chalk.red(`edit: Failed to launch '${editor}': ${spawn.error.message}`));
+            process.exitCode = 1;
+            return;
+        }
+        const editedContent = readFileSync(tmpPath, 'utf8');
+        if (editedContent === originalContent) {
+            console.log(chalk.gray('(no changes)'));
+            return;
+        }
+        const result = await file_replaceContent(target, tmpPath);
+        listCache_get().cache_invalidate(posix.dirname(target));
+        if (result.success) {
+            console.log(chalk.green(`Saved: ${args[0]}`));
+        }
+        else {
+            const apiErr = errorStack.stack_pop();
+            console.error(chalk.red(`edit: Save failed — ${result.error}`));
+            if (apiErr)
+                console.error(chalk.red(`  API error: ${error_stripDebugPrefix(apiErr.message)}`));
+            console.error(chalk.yellow(`Your edits are preserved at: ${tmpPath}`));
+            keepTmp = true;
+            process.exitCode = 1;
+        }
+    }
+    finally {
+        if (!keepTmp && existsSync(tmpPath)) {
+            try {
+                unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+//# sourceMappingURL=edit.js.map

package/dist/builtins/fs/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/builtins/fs/edit.ts"],"names":[],"mappings":"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"}

package/dist/builtins/fs/ls.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Lists the contents of the current or specified directory/files in the ChRIS filesystem context.
+ * Supports a virtual `/bin` directory for plugins and multiple paths (e.g., from wildcard expansion).
+ *
+ * @param args - An array containing target paths (optional).
+ * @returns A Promise that resolves when the directory contents are listed.
+ */
+export declare function builtin_ls(args: string[]): Promise<void>;

package/dist/builtins/fs/ls.js

@@ -0,0 +1,68 @@
+/**
+ * @file Builtin ls command.
+ * Lists directory contents.
+ */
+import chalk from 'chalk';
+import { commandArgs_process, path_resolve } from '../utils.js';
+import { listCache_get } from '@fnndsc/cumin';
+import { session } from '../../session/index.js';
+import { vfs } from '../../lib/vfs/vfs.js';
+/**
+ * Lists the contents of the current or specified directory/files in the ChRIS filesystem context.
+ * Supports a virtual `/bin` directory for plugins and multiple paths (e.g., from wildcard expansion).
+ *
+ * @param args - An array containing target paths (optional).
+ * @returns A Promise that resolves when the directory contents are listed.
+ */
+export async function builtin_ls(args) {
+    const parsed = commandArgs_process(args);
+    const pathArgsRaw = parsed._;
+    let sortBy = 'name';
+    if (parsed['sort']) {
+        const sortValue = String(parsed['sort']);
+        if (['name', 'size', 'date', 'owner'].includes(sortValue)) {
+            sortBy = sortValue;
+        }
+    }
+    let pathArgs = pathArgsRaw;
+    const shouldRefresh = !!parsed['refresh'] || !!parsed['f'];
+    const options = {
+        long: !!parsed['l'],
+        human: !!parsed['h'],
+        oneColumn: !!parsed['1'],
+        sort: sortBy,
+        reverse: !!parsed['reverse'] || !!parsed['r'],
+        directory: !!parsed['d']
+    };
+    if (shouldRefresh) {
+        const listCache = listCache_get();
+        if (pathArgs.length === 0) {
+            const cwd = await session.getCWD();
+            console.log(chalk.gray(`[Cache] Invalidating: ${cwd}`));
+            listCache.cache_invalidate(cwd);
+            listCache.cache_invalidate();
+        }
+        else {
+            for (const pathArg of pathArgs) {
+                const resolvedPath = await path_resolve(pathArg);
+                console.log(chalk.gray(`[Cache] Invalidating: ${resolvedPath}`));
+                listCache.cache_invalidate(resolvedPath);
+            }
+            listCache.cache_invalidate();
+        }
+    }
+    if (pathArgs.length === 0) {
+        await vfs.list(undefined, options);
+        return;
+    }
+    if (pathArgs.length === 1) {
+        const target = await path_resolve(pathArgs[0]);
+        await vfs.list(target, options);
+        return;
+    }
+    for (const pathArg of pathArgs) {
+        const target = await path_resolve(pathArg);
+        await vfs.list(target, options);
+    }
+}
+//# sourceMappingURL=ls.js.map

package/dist/builtins/fs/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../../src/builtins/fs/ls.ts"],"names":[],"mappings":"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"}

package/dist/builtins/fs/mkdir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates directories.
+ *
+ * @param args - Command line arguments (directory paths).
+ */
+export declare function builtin_mkdir(args: string[]): Promise<void>;

package/dist/builtins/fs/mkdir.js

@@ -0,0 +1,38 @@
+/**
+ * @file Builtin mkdir command.
+ * Creates directories.
+ */
+import chalk from 'chalk';
+import { path_resolve } from '../utils.js';
+import { files_mkdir as chefs_mkdir_cmd } from '@fnndsc/chili/commands/fs/mkdir.js';
+import { mkdir_render } from '@fnndsc/chili/views/fs.js';
+import { listCache_get } from '@fnndsc/cumin';
+/**
+ * Creates directories.
+ *
+ * @param args - Command line arguments (directory paths).
+ */
+export async function builtin_mkdir(args) {
+    if (args.length === 0) {
+        console.error(chalk.red('Usage: mkdir <directory> [directory...]'));
+        return;
+    }
+    for (const pathArg of args) {
+        try {
+            const targetPath = await path_resolve(pathArg);
+            const success = await chefs_mkdir_cmd(targetPath);
+            console.log(mkdir_render(targetPath, success));
+            // Invalidate cache for parent directory
+            if (success) {
+                const parentDir = targetPath.substring(0, targetPath.lastIndexOf('/')) || '/';
+                const listCache = listCache_get();
+                listCache.cache_invalidate(parentDir);
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(chalk.red(`mkdir: ${pathArg}: ${msg}`));
+        }
+    }
+}
+//# sourceMappingURL=mkdir.js.map

package/dist/builtins/fs/mkdir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.js","sourceRoot":"","sources":["../../../src/builtins/fs/mkdir.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAc,MAAM,eAAe,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,UAAU,GAAW,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,OAAO,GAAY,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YAE/C,wCAAwC;YACxC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,SAAS,GAAW,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;gBACtF,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;gBAClC,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,MAAM,GAAG,GAAW,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/builtins/fs/mv.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Moves or renames a file or directory.
+ * Supports multiple sources when destination is a directory.
+ *
+ * @param args - [src1, src2, ..., dest] or [src, dest]
+ */
+export declare function builtin_mv(args: string[]): Promise<void>;

package/dist/builtins/fs/mv.js

@@ -0,0 +1,75 @@
+/**
+ * @file Builtin mv command.
+ * Moves or renames files/directories.
+ */
+import chalk from 'chalk';
+import path from 'path';
+import { commandArgs_process, path_resolve } from '../utils.js';
+import { files_mv as chefs_mv_cmd } from '@fnndsc/chili/commands/fs/mv.js';
+import { mv_render } from '@fnndsc/chili/views/fs.js';
+import { listCache_get } from '@fnndsc/cumin';
+/**
+ * Moves or renames a file or directory.
+ * Supports multiple sources when destination is a directory.
+ *
+ * @param args - [src1, src2, ..., dest] or [src, dest]
+ */
+export async function builtin_mv(args) {
+    const parsed = commandArgs_process(args);
+    const pathArgs = parsed._;
+    if (pathArgs.length < 2) {
+        console.log(chalk.red('Usage: mv <source...> <dest>'));
+        return;
+    }
+    // Last arg is destination, all others are sources
+    const dest = pathArgs[pathArgs.length - 1];
+    const sources = pathArgs.slice(0, -1);
+    const destPath = await path_resolve(dest);
+    const listCache = listCache_get();
+    let successCount = 0;
+    let failCount = 0;
+    for (const src of sources) {
+        try {
+            const srcPath = await path_resolve(src);
+            // For multiple sources, show which file we're moving
+            if (sources.length > 1) {
+                console.log(chalk.gray(`Moving ${srcPath}...`));
+            }
+            else {
+                console.log(`Moving ${srcPath} to ${destPath}...`);
+            }
+            const success = await chefs_mv_cmd(srcPath, destPath);
+            if (sources.length === 1) {
+                console.log(mv_render(srcPath, destPath, success));
+            }
+            if (success) {
+                successCount++;
+                // Invalidate source directory
+                const srcDir = path.posix.dirname(srcPath);
+                listCache.cache_invalidate(srcDir);
+            }
+            else {
+                failCount++;
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(chalk.red(`mv: ${src}: ${msg}`));
+            failCount++;
+        }
+    }
+    // Invalidate destination directory (always, since files moved into it)
+    listCache.cache_invalidate(destPath);
+    const destParent = path.posix.dirname(destPath);
+    listCache.cache_invalidate(destParent);
+    // Summary for multiple files
+    if (sources.length > 1) {
+        if (failCount === 0) {
+            console.log(chalk.green(`✓ Moved ${successCount} file(s) to ${destPath}`));
+        }
+        else {
+            console.log(chalk.yellow(`⚠ Moved ${successCount} file(s), ${failCount} failed`));
+        }
+    }
+}
+//# sourceMappingURL=mv.js.map

package/dist/builtins/fs/mv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mv.js","sourceRoot":"","sources":["../../../src/builtins/fs/mv.ts"],"names":[],"mappings":"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"}

package/dist/builtins/fs/pull.args.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file Pure argument parsing for the `pull` builtin.
+ *
+ * Dependency-free so it is trivially unit-testable.
+ *
+ * @module
+ */
+/**
+ * Parsed `pull` arguments.
+ */
+export interface PullArgs {
+    nowait: boolean;
+    retryMax: number;
+    paths: string[];
+}
+/**
+ * Parses `pull` arguments: the `--nowait` flag, `--retry N`, and path operands.
+ *
+ * @param args - Raw command arguments.
+ * @returns The parsed flags and paths.
+ */
+export declare function pullArgs_parse(args: string[]): PullArgs;