@fnndsc/chell 4.2.8

package/dist/builtins/sys/timing.js

@@ -0,0 +1,41 @@
+/**
+ * @file Builtin timing command.
+ * Toggles execution timing.
+ */
+import chalk from 'chalk';
+import { session } from '../../session/index.js';
+/**
+ * Toggles or displays command timing mode.
+ *
+ * @param args - Command line arguments: 'on', 'off', or empty to display status.
+ */
+export async function builtin_timing(args) {
+    const subcommand = args[0];
+    if (!subcommand) {
+        const status = session.timingEnabled_get() ? 'enabled' : 'disabled';
+        console.log(`Command timing: ${chalk.yellow(status)}`);
+        if (session.timingEnabled_get()) {
+            console.log(chalk.gray('  Execution times will be displayed after each command.'));
+        }
+        else {
+            console.log(chalk.gray('  Execution times are hidden.'));
+        }
+        console.log(chalk.gray('\nUsage: timing [on|off]'));
+        return;
+    }
+    if (subcommand === 'on') {
+        session.timingEnabled_set(true);
+        console.log(chalk.green('[+] Command timing enabled'));
+        console.log(chalk.gray('    Execution times will be displayed after each command.'));
+    }
+    else if (subcommand === 'off') {
+        session.timingEnabled_set(false);
+        console.log(chalk.gray('[-] Command timing disabled'));
+        console.log(chalk.gray('    Execution times will no longer be displayed.'));
+    }
+    else {
+        console.log(chalk.red(`Unknown argument: ${subcommand}`));
+        console.log(chalk.gray('Usage: timing [on|off]'));
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/builtins/sys/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../src/builtins/sys/timing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,MAAM,UAAU,GAAuB,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,MAAM,GAAW,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC,CAAC;IACvF,CAAC;SAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/builtins/sys/whoami.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Prints the current authenticated ChRIS username.
+ *
+ * @param _args - Unused.
+ */
+export declare function builtin_whoami(_args: string[]): Promise<void>;
+/**
+ * Prints the current CUBE URI.
+ *
+ * @param _args - Unused.
+ */
+export declare function builtin_whereami(_args: string[]): Promise<void>;

package/dist/builtins/sys/whoami.js

@@ -0,0 +1,37 @@
+/**
+ * @file Builtins whoami and whereami.
+ * Quick single-line identity queries.
+ */
+import chalk from 'chalk';
+import { context_getSingle } from '@fnndsc/salsa';
+/**
+ * Prints the current authenticated ChRIS username.
+ *
+ * @param _args - Unused.
+ */
+export async function builtin_whoami(_args) {
+    const context = await context_getSingle();
+    if (context.user) {
+        console.log(chalk.cyan(context.user));
+    }
+    else {
+        console.log(chalk.gray('(not connected)'));
+        process.exitCode = 1;
+    }
+}
+/**
+ * Prints the current CUBE URI.
+ *
+ * @param _args - Unused.
+ */
+export async function builtin_whereami(_args) {
+    const context = await context_getSingle();
+    if (context.URL) {
+        console.log(chalk.blue(context.URL));
+    }
+    else {
+        console.log(chalk.gray('(not connected)'));
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=whoami.js.map

package/dist/builtins/sys/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../../src/builtins/sys/whoami.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAe;IAClD,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IACzD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAe;IACpD,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IACzD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/builtins/utils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Structure for parsed command line arguments.
+ */
+export interface ParsedArgs {
+    _: string[];
+    [key: string]: string | boolean | string[];
+}
+/**
+ * Parses raw argument strings into a structured object.
+ * Supports `--` as an end-of-options marker (everything after is treated as positional args).
+ */
+export declare function commandArgs_process(args: string[]): ParsedArgs;
+/**
+ * Context required for path resolution.
+ */
+export interface PathContext {
+    user: string | null;
+    cwd: string;
+}
+/**
+ * Resolves a path argument, handling `~` expansion and relative paths.
+ * Pure function version that takes context as argument.
+ *
+ * @param inputPath - The path to resolve.
+ * @param context - User and CWD context.
+ * @returns The absolute path.
+ */
+export declare function path_resolvePure(inputPath: string, context: PathContext): string;
+/**
+ * Resolves a path argument, handling `~` expansion and relative paths.
+ * @param inputPath - The path to resolve.
+ * @returns The absolute path.
+ */
+export declare function path_resolve(inputPath: string): Promise<string>;
+/**
+ * Resolves links in a path without using PathMapper (for physical mode).
+ * Checks each component to see if it's a link and follows it.
+ *
+ * @param targetPath - The path to resolve.
+ * @returns The resolved path with links followed.
+ */
+export declare function path_resolveLinks(targetPath: string): Promise<string>;
+/**
+ * Strips the function name padding prefix from an error message if debug mode is disabled.
+ *
+ * @param message - The raw/enhanced error message from the ErrorStack.
+ * @returns The cleaned or original error message based on the debug configuration.
+ *
+ * @example
+ * ```
+ * const cleaned = error_stripDebugPrefix("[PacsVfsProvider.list                    ] | ls: error");
+ * // cleaned will be "ls: error" if debug mode is disabled
+ * ```
+ */
+export declare function error_stripDebugPrefix(message: string): string;

package/dist/builtins/utils.js

@@ -0,0 +1,145 @@
+/**
+ * @file Builtin Utilities
+ * Pure functions for argument parsing and path resolution logic.
+ */
+import * as path from 'path';
+import { context_getSingle } from '@fnndsc/salsa';
+import { session } from '../session/index.js';
+/**
+ * Parses raw argument strings into a structured object.
+ * Supports `--` as an end-of-options marker (everything after is treated as positional args).
+ */
+export function commandArgs_process(args) {
+    const result = { _: [] };
+    let endOfOptions = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        // Check for -- (end of options marker)
+        if (arg === '--') {
+            endOfOptions = true;
+            continue; // Skip the -- itself
+        }
+        // After --, everything is a positional argument
+        if (endOfOptions) {
+            result._.push(arg);
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            const key = arg.substring(2);
+            if (args[i + 1] && !args[i + 1].startsWith('-')) {
+                result[key] = args[i + 1];
+                i++;
+            }
+            else {
+                result[key] = true;
+            }
+        }
+        else if (arg.startsWith('-') && arg.length > 1) {
+            const flags = arg.substring(1).split('');
+            flags.forEach(flag => result[flag] = true);
+        }
+        else {
+            result._.push(arg);
+        }
+    }
+    return result;
+}
+/**
+ * Resolves a path argument, handling `~` expansion and relative paths.
+ * Pure function version that takes context as argument.
+ *
+ * @param inputPath - The path to resolve.
+ * @param context - User and CWD context.
+ * @returns The absolute path.
+ */
+export function path_resolvePure(inputPath, context) {
+    let resolved = inputPath;
+    const { user, cwd } = context;
+    if (inputPath.startsWith('~')) {
+        const home = user ? `/home/${user}` : '/';
+        if (inputPath === '~' || inputPath === '~/') {
+            resolved = home;
+        }
+        else if (inputPath.startsWith('~/')) {
+            resolved = path.posix.join(home, inputPath.substring(2));
+        }
+    }
+    if (!resolved.startsWith('/')) {
+        resolved = path.posix.resolve(cwd, resolved);
+    }
+    // Normalize
+    if (resolved.length > 1 && resolved.endsWith('/')) {
+        resolved = resolved.slice(0, -1);
+    }
+    return resolved;
+}
+/**
+ * Resolves a path argument, handling `~` expansion and relative paths.
+ * @param inputPath - The path to resolve.
+ * @returns The absolute path.
+ */
+export async function path_resolve(inputPath) {
+    const context = await context_getSingle();
+    const user = context.user;
+    const cwd = await session.getCWD();
+    return path_resolvePure(inputPath, { user, cwd });
+}
+/**
+ * Resolves links in a path without using PathMapper (for physical mode).
+ * Checks each component to see if it's a link and follows it.
+ *
+ * @param targetPath - The path to resolve.
+ * @returns The resolved path with links followed.
+ */
+export async function path_resolveLinks(targetPath) {
+    // We need to dynamically import files_list to avoid circular dependency
+    // because builtins/fs/ls.ts imports path_resolve from here
+    const { files_list } = await import('@fnndsc/chili/commands/fs/ls.js');
+    const components = targetPath.split('/').filter(c => c);
+    let currentPath = '';
+    for (const component of components) {
+        const parentPath = currentPath || '/';
+        currentPath = `${currentPath}/${component}`;
+        try {
+            // List parent directory to check if component is a link
+            const items = await files_list({ path: parentPath }, parentPath);
+            // Find the component in the listing
+            const item = items.find((i) => i.name === component);
+            if (item && item.type === 'link' && item.target) {
+                // Component is a link - resolve it
+                if (item.target.startsWith('/')) {
+                    // Absolute link target
+                    currentPath = item.target;
+                }
+                else {
+                    // Relative link target
+                    currentPath = `${parentPath}/${item.target}`.replace('//', '/');
+                }
+            }
+        }
+        catch (_error) {
+            // If we can't list the directory, continue with the current path
+            continue;
+        }
+    }
+    return currentPath || '/';
+}
+/**
+ * Strips the function name padding prefix from an error message if debug mode is disabled.
+ *
+ * @param message - The raw/enhanced error message from the ErrorStack.
+ * @returns The cleaned or original error message based on the debug configuration.
+ *
+ * @example
+ * ```
+ * const cleaned = error_stripDebugPrefix("[PacsVfsProvider.list                    ] | ls: error");
+ * // cleaned will be "ls: error" if debug mode is disabled
+ * ```
+ */
+export function error_stripDebugPrefix(message) {
+    if (session.connection?.config?.debug) {
+        return message;
+    }
+    return message.replace(/^\[[^\]]+\]\s*\|\s*/, '');
+}
+//# sourceMappingURL=utils.js.map

package/dist/builtins/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/builtins/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAa9C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,MAAM,MAAM,GAAe,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACrC,IAAI,YAAY,GAAY,KAAK,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;QAE5B,uCAAuC;QACvC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,YAAY,GAAG,IAAI,CAAC;YACpB,SAAS,CAAC,qBAAqB;QACjC,CAAC;QAED,gDAAgD;QAChD,IAAI,YAAY,EAAE,CAAC;YAChB,MAAM,CAAC,CAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAW,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1B,CAAC,EAAE,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAa,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACL,MAAM,CAAC,CAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAoB;IACtE,IAAI,QAAQ,GAAW,SAAS,CAAC;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAE9B,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAW,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5C,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,YAAY;IACZ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IACzD,MAAM,IAAI,GAAkB,OAAO,CAAC,IAAI,CAAC;IACzC,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;IAC3C,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IACxD,wEAAwE;IACxE,2DAA2D;IAC3D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAa,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,WAAW,GAAW,EAAE,CAAC;IAE7B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,UAAU,GAAW,WAAW,IAAI,GAAG,CAAC;QAC9C,WAAW,GAAG,GAAG,WAAW,IAAI,SAAS,EAAE,CAAC;QAE5C,IAAI,CAAC;YACH,wDAAwD;YACxD,MAAM,KAAK,GAAkB,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;YAEhF,oCAAoC;YACpC,MAAM,IAAI,GAA4B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YAE3F,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChD,mCAAmC;gBACnC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,uBAAuB;oBACvB,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,uBAAuB;oBACvB,WAAW,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,MAAe,EAAE,CAAC;YACzB,iEAAiE;YACjE,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,WAAW,IAAI,GAAG,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/builtins/wildcard.d.ts

@@ -0,0 +1,26 @@
+import { Result } from '@fnndsc/cumin';
+/**
+ * Checks if a string contains wildcard characters.
+ *
+ * @param arg - The argument to check.
+ * @returns True if the argument contains wildcards.
+ */
+export declare function string_checkHasWildcard(arg: string): boolean;
+/**
+ * Expands a wildcard pattern against the current directory.
+ *
+ * @param pattern - The glob pattern (e.g., "*.ts", "test*.json").
+ * @returns A Promise resolving to Result<string[]>.
+ *          Ok([]) = no matches (not an error).
+ *          Err(...) = couldn't expand (API failure, permission denied, etc.).
+ */
+export declare function wildcard_expand(pattern: string): Promise<Result<string[]>>;
+/**
+ * Expands all wildcards in an argument list.
+ *
+ * @param args - The argument list potentially containing wildcards.
+ * @returns A Promise resolving to Result<string[]>.
+ *          On error expanding any pattern, returns the error.
+ *          Empty matches return the original pattern.
+ */
+export declare function wildcards_expandAll(args: string[]): Promise<Result<string[]>>;

package/dist/builtins/wildcard.js

@@ -0,0 +1,120 @@
+/**
+ * @file Wildcard expansion for shell commands.
+ *
+ * Provides glob pattern matching against the ChRIS filesystem.
+ *
+ * @module
+ */
+import { minimatch } from 'minimatch';
+import { session } from '../session/index.js';
+import { vfsDispatcher } from '@fnndsc/salsa';
+import { listCache_get, Ok, Err, errorStack } from '@fnndsc/cumin';
+/**
+ * Checks if a string contains wildcard characters.
+ *
+ * @param arg - The argument to check.
+ * @returns True if the argument contains wildcards.
+ */
+export function string_checkHasWildcard(arg) {
+    return /[*?[\]]/.test(arg);
+}
+/**
+ * Expands a wildcard pattern against the current directory.
+ *
+ * @param pattern - The glob pattern (e.g., "*.ts", "test*.json").
+ * @returns A Promise resolving to Result<string[]>.
+ *          Ok([]) = no matches (not an error).
+ *          Err(...) = couldn't expand (API failure, permission denied, etc.).
+ */
+export async function wildcard_expand(pattern) {
+    // If no wildcard, return as-is
+    if (!string_checkHasWildcard(pattern)) {
+        return Ok([pattern]);
+    }
+    try {
+        // Get current directory
+        const cwd = await session.getCWD();
+        // Handle patterns with directory components (e.g., "data/*.txt")
+        let searchDir = cwd;
+        let matchPattern = pattern;
+        // Check if pattern has directory separator
+        if (pattern.includes('/')) {
+            const parts = pattern.split('/');
+            const lastPart = parts.pop() || '*';
+            const dirPart = parts.join('/');
+            // Resolve directory part (could be relative)
+            if (dirPart.startsWith('/')) {
+                searchDir = dirPart;
+            }
+            else if (dirPart === '.') {
+                searchDir = cwd;
+            }
+            else {
+                // Relative path - append to cwd
+                searchDir = `${cwd}/${dirPart}`.replace(/\/+/g, '/');
+            }
+            matchPattern = lastPart;
+        }
+        // List files in the directory (check cache first)
+        let items = [];
+        const listCache = listCache_get();
+        const cached = listCache.cache_get(searchDir);
+        if (cached) {
+            items = cached.data;
+        }
+        else {
+            const vfsResult = await vfsDispatcher.list(searchDir);
+            if (vfsResult.ok) {
+                items = vfsResult.value;
+                listCache.cache_set(searchDir, items);
+            }
+            else {
+                return Err();
+            }
+        }
+        // Filter items by pattern
+        const matches = items
+            .filter((item) => minimatch(item.name, matchPattern))
+            .map((item) => {
+            // Return full path if we searched a different directory
+            if (searchDir !== cwd) {
+                return `${searchDir}/${item.name}`.replace(/\/+/g, '/');
+            }
+            return item.name;
+        });
+        // Ok([]) for no matches (not an error)
+        return Ok(matches);
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        errorStack.stack_push("error", `Failed to expand wildcard '${pattern}': ${errorMsg}`);
+        return Err();
+    }
+}
+/**
+ * Expands all wildcards in an argument list.
+ *
+ * @param args - The argument list potentially containing wildcards.
+ * @returns A Promise resolving to Result<string[]>.
+ *          On error expanding any pattern, returns the error.
+ *          Empty matches return the original pattern.
+ */
+export async function wildcards_expandAll(args) {
+    const expanded = [];
+    for (const arg of args) {
+        const result = await wildcard_expand(arg);
+        if (!result.ok) {
+            // Propagate error up
+            return result;
+        }
+        // If no matches, use original pattern (let command handle "not found")
+        if (result.value.length === 0) {
+            expanded.push(arg);
+        }
+        else {
+            expanded.push(...result.value);
+        }
+    }
+    return Ok(expanded);
+}
+//# sourceMappingURL=wildcard.js.map

package/dist/builtins/wildcard.js.map

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

package/dist/chell.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Spawns the `chili` CLI as a child process.
+ *
+ * @param command - The command to run (e.g., "feeds").
+ * @param args - The arguments to pass to the command.
+ * @returns A Promise resolving when the child process exits.
+ */
+export declare function chiliCommand_run(command: string, args: string[]): Promise<void>;
+export { COMMAND_HANDLERS_KEYS } from './command-keys.js';
+/**
+ * Starts the ChELL REPL.
+ * Initializes connection and enters the command loop.
+ *
+ * @returns A Promise that resolves when the shell exits.
+ */
+export declare function chell_start(): Promise<void>;