@fnndsc/brasa 0.1.0

package/dist/builtins/fs/cd.js

@@ -0,0 +1,193 @@
+/**
+ * @file Builtin cd command.
+ * Changes the current working directory, reported as a command envelope.
+ */
+import chalk from 'chalk';
+import { session } from '../../session/index.js';
+import { path_resolve, path_resolveLinks, error_stripDebugPrefix } from '../utils.js';
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+/**
+ * Structural VFS container paths that exist by definition and need no API
+ * validation when `cd`-ing into them.
+ */
+const STRUCTURAL_VFS_PATHS = ['/', '/net', '/net/pacs', '/net/pacs/queries', '/proc', '/proc/jobs'];
+/**
+ * Normalizes a logical path for VFS comparison by stripping a single trailing
+ * slash (except for the root path).
+ *
+ * @param logicalPath - The resolved logical path.
+ * @returns The normalized path.
+ */
+export function vfsPath_normalize(logicalPath) {
+    return logicalPath.endsWith('/') && logicalPath.length > 1 ? logicalPath.slice(0, -1) : logicalPath;
+}
+/**
+ * Reports whether a path is a structural VFS container (always valid).
+ *
+ * @param cleanPath - The normalized path.
+ * @returns True if the path is a known structural VFS container.
+ */
+export function vfsPath_isStructural(cleanPath) {
+    return STRUCTURAL_VFS_PATHS.includes(cleanPath);
+}
+/**
+ * Verifies if a given FileBrowserFolder object exactly matches the validation path.
+ *
+ * @param folder - The FileBrowserFolder object to verify.
+ * @param validationPath - The path to match against.
+ * @returns True if the folder path exactly matches validationPath, false otherwise.
+ */
+export function folder_verifyPathMatch(folder, validationPath) {
+    if (!folder) {
+        return false;
+    }
+    const folderPath = folder.data?.path || folder.path || '';
+    // Normalize both by removing all leading and trailing slashes to be robust against API inconsistencies
+    const cleanFolder = folderPath.replace(/^\/+|\/+$/g, '');
+    const cleanValidation = validationPath.replace(/^\/+|\/+$/g, '');
+    return cleanFolder === cleanValidation;
+}
+/**
+ * Builds the success envelope for a completed directory change.
+ *
+ * @param newCwd - The working directory that is now current.
+ * @param rendered - Any stdout text (debug traces) produced along the way.
+ * @returns An ok envelope carrying the fs.cwd model.
+ */
+function cdSuccess_envelope(newCwd, rendered) {
+    return envelope_ok(rendered, { kind: 'fs.cwd', data: { path: newCwd } });
+}
+/**
+ * Handles `cd` into a virtual (VFS) path: structural containers are accepted
+ * directly, deeper VFS paths are validated and their listing cached.
+ *
+ * @param cleanPath - The normalized virtual path.
+ * @param pathArg - The original user-supplied path (for error messages).
+ * @returns The command envelope for the attempt.
+ */
+async function cdVirtual_handle(cleanPath, pathArg) {
+    if (vfsPath_isStructural(cleanPath)) {
+        await session.setCWD(cleanPath);
+        return cdSuccess_envelope(cleanPath, '');
+    }
+    // For deeper VFS paths (e.g. /net/pacs/queries/<id>), validate and cache the
+    // result so a subsequent `ls` doesn't need to re-fetch.
+    const { vfsDispatcher } = await import('@fnndsc/salsa');
+    const listResult = await vfsDispatcher.list(cleanPath);
+    if (!listResult.ok) {
+        const { errorStack } = await import('@fnndsc/cumin');
+        const lastError = errorStack.stack_pop();
+        const detail = lastError ? error_stripDebugPrefix(lastError.message) : 'No such file or directory';
+        return envelope_error('', undefined, `${chalk.red(`cd: ${pathArg}: ${detail}`)}\n`);
+    }
+    const { listCache_get } = await import('@fnndsc/cumin');
+    listCache_get().cache_set(cleanPath, listResult.value);
+    await session.setCWD(cleanPath);
+    return cdSuccess_envelope(cleanPath, '');
+}
+/**
+ * Handles `cd` into a real (API-backed) ChRIS folder: resolves the validation
+ * path, then confirms the folder exists with an exact path match before setting
+ * the working directory.
+ *
+ * @param logicalPath - The resolved logical path.
+ * @param pathArg - The original user-supplied path (for error messages).
+ * @returns The command envelope for the attempt.
+ */
+async function cdReal_handle(logicalPath, pathArg) {
+    const client = await session.connection.client_get();
+    if (!client) {
+        return envelope_error('', undefined, `${chalk.red('Not connected to ChRIS.')}\n`);
+    }
+    const debugEnabled = session.connection.config?.debug === true;
+    let rendered = '';
+    let validationPath;
+    if (session.physicalMode_get()) {
+        validationPath = await path_resolveLinks(logicalPath);
+    }
+    else {
+        const { logical_toPhysical } = await import('@fnndsc/chili/utils');
+        const physicalResult = await logical_toPhysical(logicalPath);
+        if (!physicalResult.ok) {
+            let renderedErr = `${chalk.red(`cd: ${pathArg}: No such file or directory`)}\n`;
+            if (debugEnabled) {
+                renderedErr += `${chalk.gray(`  Logical path: ${logicalPath}`)}\n`;
+            }
+            return envelope_error('', undefined, renderedErr);
+        }
+        validationPath = physicalResult.value;
+    }
+    if (debugEnabled) {
+        rendered += `${chalk.gray(`cd: ${pathArg} → logical: ${logicalPath} → validation: ${validationPath}`)}\n`;
+    }
+    const cwdPath = session.physicalMode_get() ? validationPath : logicalPath;
+    const currentCwd = await session.getCWD();
+    if (currentCwd === cwdPath) {
+        if (debugEnabled) {
+            rendered += `${chalk.gray(`  Already in target directory, skipping validation`)}\n`;
+        }
+        return cdSuccess_envelope(cwdPath, rendered);
+    }
+    try {
+        const folder = (await client.getFileBrowserFolderByPath(validationPath));
+        if (folder_verifyPathMatch(folder, validationPath)) {
+            await session.setCWD(cwdPath);
+            return cdSuccess_envelope(cwdPath, rendered);
+        }
+        let renderedErr = `${chalk.red(`cd: ${pathArg}: No such file or directory`)}\n`;
+        if (debugEnabled) {
+            if (!folder) {
+                renderedErr += `${chalk.gray(`  API returned null for path: ${validationPath}`)}\n`;
+            }
+            else {
+                const folderPath = folder.data?.path || folder.path;
+                renderedErr += `${chalk.gray(`  API returned mismatched folder path: ${folderPath} (expected: ${validationPath})`)}\n`;
+            }
+        }
+        const envelope = envelope_error(rendered, undefined, renderedErr);
+        return envelope;
+    }
+    catch (apiError) {
+        let renderedErr = `${chalk.red(`cd: ${pathArg}: No such file or directory`)}\n`;
+        if (debugEnabled) {
+            const msg = apiError instanceof Error ? apiError.message : String(apiError);
+            renderedErr += `${chalk.gray(`  API error: ${msg}`)}\n`;
+        }
+        return envelope_error(rendered, undefined, renderedErr);
+    }
+}
+/**
+ * Changes the current working directory in the ChRIS filesystem context.
+ * Validates the existence of the target path before setting it.
+ *
+ * @param args - An array containing the target path as the first element.
+ * @returns An envelope carrying the new working directory on success.
+ */
+export async function builtin_cd(args) {
+    const pathArg = args.length > 0 ? args.join(' ') : undefined;
+    // 'cd' with no args goes to home
+    if (!pathArg) {
+        return builtin_cd(['~']);
+    }
+    try {
+        const logicalPath = await path_resolve(pathArg);
+        const { vfsDispatcher } = await import('@fnndsc/salsa');
+        const cleanPath = vfsPath_normalize(logicalPath);
+        // Treat the path as virtual if it is, or is a parent of, any registered
+        // provider prefix (e.g. /proc is parent of /proc/feeds).
+        const isParentOfVfs = vfsDispatcher.providers_get().some((p) => p.prefix.startsWith(cleanPath + '/'));
+        const isVirtual = cleanPath === '/' ||
+            cleanPath === '/net' ||
+            isParentOfVfs ||
+            vfsDispatcher.provider_get(cleanPath).prefix !== '';
+        if (isVirtual) {
+            return cdVirtual_handle(cleanPath, pathArg);
+        }
+        return cdReal_handle(logicalPath, pathArg);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return envelope_error('', undefined, `${chalk.red(`Failed to cd: ${msg}`)}\n`);
+    }
+}
+//# sourceMappingURL=cd.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cd.js","sourceRoot":"","sources":["../../../src/builtins/fs/cd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAc5D;;;GAGG;AACH,MAAM,oBAAoB,GAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AAE9G;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AACtG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,oBAAoB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA4C,EAAE,cAAsB;IACzG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAW,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAElE,uGAAuG;IACvG,MAAM,WAAW,GAAW,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,eAAe,GAAW,cAAc,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAEzE,OAAO,WAAW,KAAK,eAAe,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,MAAc,EAAE,QAAgB;IAC1D,OAAO,WAAW,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAe;IAChE,IAAI,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,6EAA6E;IAC7E,wDAAwD;IACxD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,UAAU,GAAsB,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1E,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACrD,MAAM,SAAS,GAA6B,UAAU,CAAC,SAAS,EAAE,CAAC;QACnE,MAAM,MAAM,GAAW,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC;QAC3G,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,OAAO,KAAK,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACxD,aAAa,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAEvD,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,OAAe;IAC/D,MAAM,MAAM,GAAkB,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;IACpE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,YAAY,GAAY,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC;IACxE,IAAI,QAAQ,GAAW,EAAE,CAAC;IAE1B,IAAI,cAAsB,CAAC;IAC3B,IAAI,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC/B,cAAc,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACnE,MAAM,cAAc,GAAmB,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC7E,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC;YACvB,IAAI,WAAW,GAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,OAAO,6BAA6B,CAAC,IAAI,CAAC;YACxF,IAAI,YAAY,EAAE,CAAC;gBACjB,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,WAAW,EAAE,CAAC,IAAI,CAAC;YACrE,CAAC;YACD,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACpD,CAAC;QACD,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC;IACxC,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,eAAe,WAAW,kBAAkB,cAAc,EAAE,CAAC,IAAI,CAAC;IAC5G,CAAC;IAED,MAAM,OAAO,GAAW,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC;IAClF,MAAM,UAAU,GAAW,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;IAElD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,IAAI,CAAC;QACtF,CAAC;QACD,OAAO,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAyC,CAAC,MAAM,MAAM,CAAC,0BAA0B,CAAC,cAAc,CAAC,CAAyC,CAAC;QACvJ,IAAI,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;YACnD,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,WAAW,GAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,OAAO,6BAA6B,CAAC,IAAI,CAAC;QACxF,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,iCAAiC,cAAc,EAAE,CAAC,IAAI,CAAC;YACtF,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,GAAuB,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;gBACxE,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,0CAA0C,UAAU,eAAe,cAAc,GAAG,CAAC,IAAI,CAAC;YACzH,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,GAAoB,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACnF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,QAAiB,EAAE,CAAC;QAC3B,IAAI,WAAW,GAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,OAAO,6BAA6B,CAAC,IAAI,CAAC;QACxF,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,GAAG,GAAW,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACpF,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC,IAAI,CAAC;QAC1D,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAc;IAC7C,MAAM,OAAO,GAAuB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,iCAAiC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAW,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAExD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACxD,MAAM,SAAS,GAAW,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACzD,wEAAwE;QACxE,yDAAyD;QACzD,MAAM,aAAa,GAAY,aAAa,CAAC,aAAa,EAAE,CAAC,IAAI,CAC/D,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,CAChE,CAAC;QACF,MAAM,SAAS,GACb,SAAS,KAAK,GAAG;YACjB,SAAS,KAAK,MAAM;YACpB,aAAa;YACb,aAAa,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;QAEtD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAiB,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import { CommandEnvelope } from '@fnndsc/cumin';
+/**
+ * Copies a file or directory.
+ * Supports multiple sources when destination is a directory.
+ *
+ * @param args - [flags, src1, src2, ..., dest]
+ * @returns An envelope whose rendered text reports progress and results and
+ *   whose model carries per-source outcomes.
+ */
+export declare function builtin_cp(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/fs/cp.js

@@ -0,0 +1,86 @@
+/**
+ * @file Builtin cp command.
+ * Copies files or directories, reported as a command envelope.
+ */
+import chalk from 'chalk';
+import path from 'path';
+import { listCache_get, envelope_ok, envelope_error } from '@fnndsc/cumin';
+import { commandArgs_process, path_resolve } from '../utils.js';
+import { files_cp as chefs_cp_cmd } from '@fnndsc/chili/commands/fs/cp.js';
+import { cp_render } from '@fnndsc/chili/views/fs.js';
+/**
+ * Copies a file or directory.
+ * Supports multiple sources when destination is a directory.
+ *
+ * @param args - [flags, src1, src2, ..., dest]
+ * @returns An envelope whose rendered text reports progress and results and
+ *   whose model carries per-source outcomes.
+ */
+export async function builtin_cp(args) {
+    const parsed = commandArgs_process(args);
+    const pathArgs = parsed._;
+    if (pathArgs.length < 2) {
+        return envelope_error(`${chalk.red('Usage: cp [-r] <source...> <dest>')}\n`);
+    }
+    const recursive = !!parsed['r'] || !!parsed['recursive'];
+    // 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;
+    let rendered = '';
+    let renderedErr = '';
+    const outcomes = [];
+    for (const src of sources) {
+        try {
+            const srcPath = await path_resolve(src);
+            // For multiple sources, show which file we're copying
+            if (sources.length > 1) {
+                rendered += `${chalk.gray(`Copying ${srcPath}...`)}\n`;
+            }
+            else {
+                rendered += `Copying ${srcPath} to ${destPath}...\n`;
+            }
+            const success = await chefs_cp_cmd(srcPath, destPath, { recursive });
+            if (sources.length === 1) {
+                rendered += `${cp_render(srcPath, destPath, success)}\n`;
+            }
+            outcomes.push({ source: srcPath, copied: success });
+            if (success) {
+                successCount++;
+            }
+            else {
+                failCount++;
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            renderedErr += `${chalk.red(`cp: ${src}: ${msg}`)}\n`;
+            outcomes.push({ source: src, copied: false });
+            failCount++;
+        }
+    }
+    // Invalidate destination directory (always, since files copied 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) {
+            rendered += `${chalk.green(`✓ Copied ${successCount} file(s) to ${destPath}`)}\n`;
+        }
+        else {
+            rendered += `${chalk.yellow(`⚠ Copied ${successCount} file(s), ${failCount} failed`)}\n`;
+        }
+    }
+    const modelData = { dest: destPath, outcomes, copied: successCount, failed: failCount };
+    if (failCount > 0) {
+        const envelope = envelope_error(rendered, undefined, renderedErr || undefined);
+        envelope.model = { kind: 'fs.cp', data: modelData };
+        return envelope;
+    }
+    return envelope_ok(rendered, { kind: 'fs.cp', data: modelData });
+}
+//# sourceMappingURL=cp.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Downloads a remote ChRIS file or directory to the local filesystem.
+ *
+ * @param args - [remotePath, localPath] plus optional -f/--force to overwrite.
+ */
+export declare function builtin_download(args: string[]): Promise<void>;

package/dist/builtins/fs/download.js

@@ -0,0 +1,45 @@
+/**
+ * @file Builtin download command.
+ * Downloads files from ChRIS to the local filesystem with progress.
+ */
+import chalk from 'chalk';
+import path from 'path';
+import { path_resolve } from '../utils.js';
+import { files_downloadWithProgress as chefs_download_cmd, bytes_format } from '@fnndsc/chili/commands/fs/download.js';
+import { sink_get } from '../../core/sink.js';
+/**
+ * Downloads a remote ChRIS file or directory to the local filesystem.
+ *
+ * @param args - [remotePath, localPath] plus optional -f/--force to overwrite.
+ */
+export async function builtin_download(args) {
+    const force = args.includes('-f') || args.includes('--force');
+    const cleanArgs = args.filter(arg => arg !== '-f' && arg !== '--force');
+    if (cleanArgs.length < 2) {
+        console.log(chalk.red('Usage: download <remote_path> <local_path> [-f|--force]'));
+        return;
+    }
+    const remotePathArg = cleanArgs[0];
+    const localPathArg = cleanArgs[1];
+    const targetRemote = await path_resolve(remotePathArg);
+    const targetLocal = path.resolve(localPathArg);
+    try {
+        const summary = await chefs_download_cmd(targetRemote, targetLocal, {
+            force,
+            onProgress: event => sink_get().progress_write(event),
+        });
+        console.log('');
+        if (summary.failedCount === 0) {
+            console.log(chalk.green(`✓ Successfully downloaded ${summary.transferredCount} file(s)`));
+        }
+        else {
+            console.log(chalk.yellow(`⚠ Downloaded ${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)`));
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(chalk.red(`Download error: ${msg}`));
+    }
+}
+//# sourceMappingURL=download.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/builtins/fs/download.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,0BAA0B,IAAI,kBAAkB,EAEhD,YAAY,EACb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,KAAK,GAAY,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvE,MAAM,SAAS,GAAa,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC;IAElF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC,CAAC;QAClF,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAW,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAW,SAAS,CAAC,CAAC,CAAC,CAAC;IAE1C,MAAM,YAAY,GAAW,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAW,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAoB,MAAM,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE;YACnF,KAAK;YACL,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC;SACtD,CAAC,CAAC;QAEH,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,6BAA6B,OAAO,CAAC,gBAAgB,UAAU,CAAC,CAAC,CAAC;QAC5F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,OAAO,CAAC,gBAAgB,aAAa,OAAO,CAAC,WAAW,SAAS,CAAC,CAAC,CAAC;QAC/G,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;IAClJ,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,mBAAmB,GAAG,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

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 the surface's local 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>;