@fnndsc/chell 4.2.8

package/dist/builtins/fs/rm.js

@@ -0,0 +1,148 @@
+/**
+ * @file Builtin rm command.
+ * Removes files or directories.
+ */
+import chalk from 'chalk';
+import path from 'path';
+import * as readline from 'readline';
+import { path_resolve } from '../utils.js';
+import { files_rm as chefs_rm_cmd } from '@fnndsc/chili/commands/fs/rm.js';
+import { rm_render } from '@fnndsc/chili/views/fs.js';
+import { listCache_get } from '@fnndsc/cumin';
+/**
+ * Prompts the user for confirmation.
+ *
+ * @param message - The prompt message.
+ * @returns A Promise resolving to true if user confirms (y/Y), false otherwise.
+ */
+async function prompt_confirm(message) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        rl.question(message, (answer) => {
+            rl.close();
+            const confirmed = answer.trim().toLowerCase() === 'y';
+            resolve(confirmed);
+        });
+    });
+}
+/**
+ * Parses `rm` arguments, supporting combined short flags (`-rf`, `-rfi`) and the
+ * `--` end-of-options separator.
+ *
+ * @param args - Raw command arguments.
+ * @returns The parsed flags and path operands.
+ */
+export function rmArgs_parse(args) {
+    let recursive = false;
+    let force = false;
+    let interactive = false;
+    const paths = [];
+    let endOfOptions = false;
+    for (const arg of args) {
+        if (arg === '--') {
+            endOfOptions = true;
+            continue;
+        }
+        if (endOfOptions) {
+            paths.push(arg);
+            continue;
+        }
+        if (arg.startsWith('-') && arg.length > 1) {
+            for (const ch of arg.substring(1)) {
+                if (ch === 'r' || ch === 'R')
+                    recursive = true;
+                else if (ch === 'f')
+                    force = true;
+                else if (ch === 'i')
+                    interactive = true;
+            }
+        }
+        else if (!arg.startsWith('-')) {
+            paths.push(arg);
+        }
+    }
+    return { recursive, force, interactive, paths };
+}
+/**
+ * Formats the multi-target removal summary line.
+ *
+ * @param successCount - Number of items removed successfully.
+ * @param failCount - Number of items that failed to remove.
+ * @returns The summary string, or null if there is nothing to summarise.
+ */
+export function rmSummary_format(successCount, failCount) {
+    if (!(successCount > 0 || failCount > 0))
+        return null;
+    if (successCount > 0 && failCount === 0) {
+        return chalk.green(`Successfully removed ${successCount} item${successCount !== 1 ? 's' : ''}`);
+    }
+    if (successCount > 0 && failCount > 0) {
+        return chalk.yellow(`Removed ${successCount} item${successCount !== 1 ? 's' : ''}, failed ${failCount}`);
+    }
+    return chalk.red(`Failed to remove ${failCount} item${failCount !== 1 ? 's' : ''}`);
+}
+/**
+ * Removes one or more files or directories.
+ *
+ * @param args - Command line arguments (flags and paths).
+ */
+export async function builtin_rm(args) {
+    const { recursive, force, interactive, paths } = rmArgs_parse(args);
+    if (paths.length === 0) {
+        console.error(chalk.red('Usage: rm [-rf] <path> [path...]'));
+        return;
+    }
+    const options = { recursive, force };
+    let successCount = 0;
+    let failCount = 0;
+    for (const pathArg of paths) {
+        try {
+            const target = await path_resolve(pathArg);
+            if (target.startsWith('/bin/')) {
+                console.error(chalk.red(`rm: cannot remove '${pathArg}': virtual /bin directory`));
+                failCount++;
+                continue;
+            }
+            if (interactive) {
+                const confirmed = await prompt_confirm(`rm: remove '${pathArg}'? (y/n): `);
+                if (!confirmed) {
+                    console.log(chalk.gray(`skipped '${pathArg}'`));
+                    continue;
+                }
+            }
+            const result = await chefs_rm_cmd(target, options);
+            if (result.success) {
+                if (paths.length > 1) {
+                    console.log(chalk.gray(`removed '${pathArg}'`));
+                }
+                else {
+                    console.log(rm_render(result));
+                }
+                successCount++;
+                const listCache = listCache_get();
+                const parentDir = path.posix.dirname(target);
+                listCache.cache_invalidate(parentDir);
+            }
+            else {
+                console.error(chalk.red(`rm: cannot remove '${pathArg}': ${result.error || 'unknown error'}`));
+                failCount++;
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(chalk.red(`rm: cannot remove '${pathArg}': ${msg}`));
+            failCount++;
+        }
+    }
+    if (paths.length > 1) {
+        const summary = rmSummary_format(successCount, failCount);
+        if (summary) {
+            console.log('');
+            console.log(summary);
+        }
+    }
+}
+//# sourceMappingURL=rm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rm.js","sourceRoot":"","sources":["../../../src/builtins/fs/rm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAuB,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;GAKG;AACH,KAAK,UAAU,cAAc,CAAC,OAAe;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAuB,QAAQ,CAAC,eAAe,CAAC;YACtD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAc,EAAE,EAAE;YACtC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,SAAS,GAAY,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;YAC/D,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,IAAI,SAAS,GAAY,KAAK,CAAC;IAC/B,IAAI,KAAK,GAAY,KAAK,CAAC;IAC3B,IAAI,WAAW,GAAY,KAAK,CAAC;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,YAAY,GAAY,KAAK,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,YAAY,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;oBAAE,SAAS,GAAG,IAAI,CAAC;qBAC1C,IAAI,EAAE,KAAK,GAAG;oBAAE,KAAK,GAAG,IAAI,CAAC;qBAC7B,IAAI,EAAE,KAAK,GAAG;oBAAE,WAAW,GAAG,IAAI,CAAC;YAC1C,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAE,SAAiB;IACtE,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,YAAY,GAAG,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC,KAAK,CAAC,wBAAwB,YAAY,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,MAAM,CAAC,WAAW,YAAY,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,SAAS,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,oBAAoB,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtF,CAAC;AAGD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAc;IAC7C,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAW,YAAY,CAAC,IAAI,CAAC,CAAC;IAE5E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAChD,IAAI,YAAY,GAAW,CAAC,CAAC;IAC7B,IAAI,SAAS,GAAW,CAAC,CAAC;IAE1B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAW,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAEnD,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,OAAO,2BAA2B,CAAC,CAAC,CAAC;gBACnF,SAAS,EAAE,CAAC;gBACZ,SAAS;YACX,CAAC;YAED,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,SAAS,GAAY,MAAM,cAAc,CAAC,eAAe,OAAO,YAAY,CAAC,CAAC;gBACpF,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,GAAG,CAAC,CAAC,CAAC;oBAChD,SAAS;gBACX,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAa,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAE7D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,GAAG,CAAC,CAAC,CAAC;gBAClD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjC,CAAC;gBACD,YAAY,EAAE,CAAC;gBAEf,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACrD,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,OAAO,MAAM,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC;gBAC/F,SAAS,EAAE,CAAC;YACd,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,sBAAsB,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;YACnE,SAAS,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,OAAO,GAAkB,gBAAgB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACzE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Creates empty files or updates timestamps.
+ *
+ * @param args - Command line arguments (file paths).
+ */
+export declare function builtin_touch(args: string[]): Promise<void>;

package/dist/builtins/fs/touch.js

@@ -0,0 +1,64 @@
+/**
+ * @file Builtin touch command.
+ * Creates files.
+ */
+import chalk from 'chalk';
+import path from 'path';
+import { commandArgs_process, path_resolve, error_stripDebugPrefix } from '../utils.js';
+import { files_touch as chefs_touch_cmd } from '@fnndsc/chili/commands/fs/touch.js';
+import { touch_render } from '@fnndsc/chili/views/fs.js';
+import { listCache_get, errorStack } from '@fnndsc/cumin';
+/**
+ * Creates empty files or updates timestamps.
+ *
+ * @param args - Command line arguments (file paths).
+ */
+export async function builtin_touch(args) {
+    const parsed = commandArgs_process(args);
+    const pathArgs = parsed._;
+    if (pathArgs.length === 0) {
+        console.error(chalk.red('Usage: touch [--withContents <string>] [--withContentsFromFile <file>] <file>'));
+        return;
+    }
+    // Build options from parsed flags
+    const options = {};
+    if (parsed['withContents']) {
+        options.withContents = String(parsed['withContents']);
+    }
+    if (parsed['withContentsFromFile']) {
+        options.withContentsFromFile = String(parsed['withContentsFromFile']);
+    }
+    // Only process the first file argument when using content options
+    const filesToTouch = (options.withContents || options.withContentsFromFile)
+        ? [pathArgs[0]] // Only one file when injecting content
+        : pathArgs; // Multiple files allowed for empty touch
+    for (const pathArg of filesToTouch) {
+        try {
+            const targetPath = await path_resolve(pathArg);
+            const success = await chefs_touch_cmd(targetPath, options);
+            if (success) {
+                console.log(touch_render(targetPath, success));
+                // Invalidate cache for parent directory
+                const listCache = listCache_get();
+                const parentDir = path.posix.dirname(targetPath);
+                listCache.cache_invalidate(parentDir);
+            }
+            else {
+                // Touch failed, display error from errorStack
+                const lastError = errorStack.stack_pop();
+                if (lastError) {
+                    console.error(chalk.red(`Failed to create file: ${targetPath}`));
+                    console.error(chalk.gray(`  ${error_stripDebugPrefix(lastError.message)}`));
+                }
+                else {
+                    console.error(chalk.red(`Failed to create file: ${targetPath}`));
+                }
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(chalk.red(`touch: ${pathArg}: ${msg}`));
+        }
+    }
+}
+//# sourceMappingURL=touch.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Displays a directory tree of the ChRIS filesystem.
+ * 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 the tree is displayed.
+ *
+ * @example
+ * ```
+ * tree                    # Tree of current directory
+ * tree /home/user/data    # Tree of specific path
+ * tree --follow           # Follow symbolic links
+ * ```
+ */
+export declare function builtin_tree(args: string[]): Promise<void>;

package/dist/builtins/fs/tree.js

@@ -0,0 +1,84 @@
+/**
+ * @file Builtin tree command.
+ * Displays directory structure.
+ */
+import chalk from 'chalk';
+import { commandArgs_process, path_resolve, error_stripDebugPrefix } from '../utils.js';
+import { session } from '../../session/index.js';
+import { spinner } from '../../lib/spinner.js';
+import { errorStack } from '@fnndsc/cumin';
+import { scan_do, archyTree_create } from '@fnndsc/chili/path/pathCommand.js';
+import { bytes_format } from '@fnndsc/chili/commands/fs/upload.js';
+/**
+ * Displays a directory tree of the ChRIS filesystem.
+ * 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 the tree is displayed.
+ *
+ * @example
+ * ```
+ * tree                    # Tree of current directory
+ * tree /home/user/data    # Tree of specific path
+ * tree --follow           # Follow symbolic links
+ * ```
+ */
+export async function builtin_tree(args) {
+    const parsed = commandArgs_process(args);
+    const pathArgs = parsed._;
+    const pathMode = !!parsed['path'];
+    // Determine target path
+    let targetPath;
+    if (pathArgs.length > 0) {
+        targetPath = await path_resolve(pathArgs[0]);
+    }
+    // Build scan options
+    const scanOptions = {
+        silent: true,
+        tree: false, // We'll format it ourselves
+        follow: !!parsed['follow'],
+        dirsOnly: false,
+    };
+    // If path specified, temporarily set context
+    const originalFolder = await session.getCWD();
+    if (targetPath) {
+        await session.setCWD(targetPath);
+    }
+    try {
+        spinner.start(`Scanning ${targetPath || 'current directory'}...`);
+        const scanResult = await scan_do(scanOptions);
+        if (!scanResult) {
+            spinner.stop();
+            const lastError = errorStack.stack_pop();
+            if (lastError) {
+                console.error(chalk.red(error_stripDebugPrefix(lastError.message)));
+            }
+            else {
+                console.error(chalk.red('Failed to scan directory tree.'));
+            }
+            return;
+        }
+        spinner.stop();
+        if (pathMode) {
+            // --path: emit one full chrisPath per entry — grep-friendly
+            for (const item of scanResult.fileInfo) {
+                console.log(item.chrisPath);
+            }
+        }
+        else {
+            // Default: ASCII tree
+            const treeOutput = archyTree_create(scanResult.fileInfo);
+            console.log(treeOutput);
+        }
+        // Display summary
+        console.log(chalk.green(`Total size: ${bytes_format(scanResult.totalSize)}`));
+        console.log(chalk.gray(`${scanResult.fileInfo.length} items`));
+    }
+    finally {
+        // Restore original path
+        if (targetPath) {
+            await session.setCWD(originalFolder);
+        }
+    }
+}
+//# sourceMappingURL=tree.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Uploads a local file or directory to ChRIS.
+ *
+ * @param args - [localPath, remotePath]
+ */
+export declare function builtin_upload(args: string[]): Promise<void>;

package/dist/builtins/fs/upload.js

@@ -0,0 +1,45 @@
+/**
+ * @file Builtin upload command.
+ * Uploads files to ChRIS.
+ */
+import chalk from 'chalk';
+import { path_resolve } from '../utils.js';
+import { files_uploadWithProgress as chefs_upload_cmd, bytes_format } from '@fnndsc/chili/commands/fs/upload.js';
+import { listCache_get } from '@fnndsc/cumin';
+/**
+ * Uploads a local file or directory to ChRIS.
+ *
+ * @param args - [localPath, remotePath]
+ */
+export async function builtin_upload(args) {
+    if (args.length < 2) {
+        console.log(chalk.red('Usage: upload <local_path> <remote_path>'));
+        return;
+    }
+    const localPath = args[0];
+    const remotePath = args[1];
+    const targetRemote = await path_resolve(remotePath);
+    try {
+        const summary = await chefs_upload_cmd(localPath, targetRemote);
+        console.log('');
+        if (summary.failedCount === 0) {
+            console.log(chalk.green(`✓ Successfully uploaded ${summary.transferredCount} file(s)`));
+        }
+        else {
+            console.log(chalk.yellow(`⚠ Uploaded ${summary.transferredCount} file(s), ${summary.failedCount} failed`));
+        }
+        console.log(chalk.gray(`  Total: ${bytes_format(summary.transferSize)} in ${summary.duration.toFixed(1)}s (${bytes_format(summary.speed)}/s)`));
+        // Invalidate cache for actual target directory where files were uploaded
+        if (summary.transferredCount > 0) {
+            const listCache = listCache_get();
+            listCache.cache_invalidate(summary.actualTargetPath);
+            // Also invalidate parent to refresh its listing
+            listCache.cache_invalidate(targetRemote);
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(chalk.red(`Upload error: ${msg}`));
+    }
+}
+//# sourceMappingURL=upload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../src/builtins/fs/upload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,wBAAwB,IAAI,gBAAgB,EAAiB,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAChI,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,UAAU,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;IAEnC,MAAM,YAAY,GAAW,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,OAAO,GAAkB,MAAM,gBAAgB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAE/E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,IAAI,OAAO,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,2BAA2B,OAAO,CAAC,gBAAgB,UAAU,CAAC,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,OAAO,CAAC,gBAAgB,aAAa,OAAO,CAAC,WAAW,SAAS,CAAC,CAAC,CAAC;QAC7G,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhJ,yEAAyE;QACzE,IAAI,OAAO,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;YAClC,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YACrD,gDAAgD;YAChD,SAAS,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAW,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/builtins/help.d.ts

@@ -0,0 +1,74 @@
+interface CommandHelp {
+    usage: string;
+    summary?: string;
+    description: string;
+    subcommands?: string[];
+    options?: string[];
+    examples?: string[];
+}
+/**
+ * Standard subcommands and options injected into every resource help entry.
+ * Captures the Resource Contract documented in CONTEXT.md.
+ */
+export declare const RESOURCE_LIST_OPTIONS: string[];
+/**
+ * Help-text registry keyed by builtin command name.
+ */
+export declare const helpText: Record<string, CommandHelp>;
+/**
+ * Displays help text for a command.
+ *
+ * @param command - The command to display help for.
+ */
+/**
+ * Formats and returns the detailed help text for a specific command as a string.
+ *
+ * @param command - The command name to retrieve help for.
+/**
+ * Word-wraps a flat string to fit within a given width, with uniform indentation.
+ *
+ * @param str    - Input text (single line or freeform).
+ * @param width  - Total line width including indent (default 78).
+ * @param indent - Leading spaces on every line (default 2).
+ * @returns Multi-line string, each line at most `width` chars wide.
+ */
+export declare function text_boxFormat(str: string, width?: number, indent?: number): string;
+/**
+ * @returns The formatted help text string, or undefined if no help exists.
+ */
+export declare function commandHelp_get(command: string): string | undefined;
+/**
+ * Displays help text for a command.
+ *
+ * @param command - The command to display help for.
+ */
+export declare function help_show(command: string): void;
+/**
+ * Checks if arguments contain --help flag.
+ * -h is treated as help unless the command uses it for "human-readable" (ls, du).
+ *
+ * @param args - Command arguments.
+ * @param command - The command name (optional).
+ * @returns True if help is requested.
+ */
+export declare function args_checkHasHelpFlag(args: string[], command?: string): boolean;
+/**
+ * Builtin help command - displays command list or specific command help.
+ *
+ * @param args - Command arguments (optional command name).
+ */
+export declare function builtin_help(args: string[]): Promise<void>;
+/**
+ * Gets the list of all builtin command names.
+ *
+ * @returns Array of builtin command names.
+ */
+export declare function builtinCommands_list(): string[];
+/**
+ * Gets the description for a builtin command.
+ *
+ * @param command - The command name.
+ * @returns The command description, or undefined if not found.
+ */
+export declare function builtinCommand_descriptionGet(command: string): string | undefined;
+export {};