@fnndsc/brasa 0.1.0

package/dist/builtins/fs/edit.js

@@ -0,0 +1,104 @@
+/**
+ * @file Builtin edit command.
+ * Fetches a ChRIS file, opens it in the surface's local editor, then
+ * re-uploads on save. The editor mechanics live in the surface, so this
+ * builtin knows nothing of processes or terminals — it fetches, hands the
+ * content to the surface, and uploads the result.
+ */
+import { writeFileSync, 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 { surface_get, capability_require, CapabilityError } from '../../core/surface.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 the surface's local 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;
+    }
+    // Editing needs a surface that can open a local editor. A surface without
+    // the capability (a headless or browser host) fails here with a clear
+    // message instead of assuming a terminal exists.
+    try {
+        capability_require('localEdit', 'edit: this surface cannot open a local editor.');
+    }
+    catch (err) {
+        const message = err instanceof CapabilityError ? err.message : String(err);
+        console.error(chalk.red(message));
+        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;
+    }
+    // Hand the content to the surface's editor.
+    let edit;
+    try {
+        edit = await surface_get().localEdit({ content: catResult.value, extension: ext || '.txt' });
+    }
+    catch (err) {
+        console.error(chalk.red(`edit: ${err instanceof Error ? err.message : String(err)}`));
+        process.exitCode = 1;
+        return;
+    }
+    if (!edit.changed) {
+        console.log(chalk.gray('(no changes)'));
+        return;
+    }
+    // Upload the edited content: write it to a temp file the replace command
+    // reads, and preserve that file (reporting its path) if the save fails.
+    const tmpPath = join(tmpdir(), `chell-edit-${Date.now()}${ext || '.txt'}`);
+    let keepTmp = false;
+    try {
+        writeFileSync(tmpPath, edit.content, 'utf8');
+        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,9 @@
+import { CommandEnvelope } from '@fnndsc/cumin';
+/**
+ * Creates directories.
+ *
+ * @param args - Command line arguments (directory paths).
+ * @returns An envelope whose rendered text reports each directory and whose
+ *   model lists per-target outcomes.
+ */
+export declare function builtin_mkdir(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/fs/mkdir.js

@@ -0,0 +1,52 @@
+/**
+ * @file Builtin mkdir command.
+ * Creates directories, reported as a command envelope.
+ */
+import chalk from 'chalk';
+import { listCache_get, envelope_ok, envelope_error } from '@fnndsc/cumin';
+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';
+/**
+ * Creates directories.
+ *
+ * @param args - Command line arguments (directory paths).
+ * @returns An envelope whose rendered text reports each directory and whose
+ *   model lists per-target outcomes.
+ */
+export async function builtin_mkdir(args) {
+    if (args.length === 0) {
+        return envelope_error('', undefined, `${chalk.red('Usage: mkdir <directory> [directory...]')}\n`);
+    }
+    let rendered = '';
+    let renderedErr = '';
+    const outcomes = [];
+    for (const pathArg of args) {
+        try {
+            const targetPath = await path_resolve(pathArg);
+            const success = await chefs_mkdir_cmd(targetPath);
+            rendered += `${mkdir_render(targetPath, success)}\n`;
+            outcomes.push({ path: targetPath, created: 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);
+            renderedErr += `${chalk.red(`mkdir: ${pathArg}: ${msg}`)}\n`;
+            outcomes.push({ path: pathArg, created: false });
+        }
+    }
+    const anyFailed = outcomes.some((outcome) => !outcome.created);
+    const model = { kind: 'fs.mkdir', data: outcomes };
+    if (anyFailed) {
+        const envelope = envelope_error(rendered, undefined, renderedErr || undefined);
+        envelope.model = model;
+        return envelope;
+    }
+    return envelope_ok(rendered, model);
+}
+//# 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;AAC1B,OAAO,EAAmB,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE5F,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;AAQzD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,IAAI,CAAC,CAAC;IACpG,CAAC;IAED,IAAI,QAAQ,GAAW,EAAE,CAAC;IAC1B,IAAI,WAAW,GAAW,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,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,QAAQ,IAAI,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC;YACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAEtD,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,GAAc,aAAa,EAAE,CAAC;gBAC7C,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,WAAW,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,OAAO,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAY,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAqB,EAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/F,MAAM,KAAK,GAA2C,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC3F,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAoB,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,IAAI,SAAS,CAAC,CAAC;QAChG,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,10 @@
+import { CommandEnvelope } 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]
+ * @returns An envelope whose rendered text reports progress and results and
+ *   whose model carries per-source outcomes.
+ */
+export declare function builtin_mv(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/fs/mv.js

@@ -0,0 +1,88 @@
+/**
+ * @file Builtin mv command.
+ * Moves or renames files/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_mv as chefs_mv_cmd } from '@fnndsc/chili/commands/fs/mv.js';
+import { mv_render } from '@fnndsc/chili/views/fs.js';
+/**
+ * Moves or renames a file or directory.
+ * Supports multiple sources when destination is a directory.
+ *
+ * @param args - [src1, src2, ..., dest] or [src, dest]
+ * @returns An envelope whose rendered text reports progress and results and
+ *   whose model carries per-source outcomes.
+ */
+export async function builtin_mv(args) {
+    const parsed = commandArgs_process(args);
+    const pathArgs = parsed._;
+    if (pathArgs.length < 2) {
+        return envelope_error(`${chalk.red('Usage: mv <source...> <dest>')}\n`);
+    }
+    // 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 moving
+            if (sources.length > 1) {
+                rendered += `${chalk.gray(`Moving ${srcPath}...`)}\n`;
+            }
+            else {
+                rendered += `Moving ${srcPath} to ${destPath}...\n`;
+            }
+            const success = await chefs_mv_cmd(srcPath, destPath);
+            if (sources.length === 1) {
+                rendered += `${mv_render(srcPath, destPath, success)}\n`;
+            }
+            outcomes.push({ source: srcPath, moved: 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);
+            renderedErr += `${chalk.red(`mv: ${src}: ${msg}`)}\n`;
+            outcomes.push({ source: src, moved: false });
+            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) {
+            rendered += `${chalk.green(`✓ Moved ${successCount} file(s) to ${destPath}`)}\n`;
+        }
+        else {
+            rendered += `${chalk.yellow(`⚠ Moved ${successCount} file(s), ${failCount} failed`)}\n`;
+        }
+    }
+    const modelData = { dest: destPath, outcomes, moved: successCount, failed: failCount };
+    if (failCount > 0) {
+        const envelope = envelope_error(rendered, undefined, renderedErr || undefined);
+        envelope.model = { kind: 'fs.mv', data: modelData };
+        return envelope;
+    }
+    return envelope_ok(rendered, { kind: 'fs.mv', data: modelData });
+}
+//# 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;

package/dist/builtins/fs/pull.args.js

@@ -0,0 +1,30 @@
+/**
+ * @file Pure argument parsing for the `pull` builtin.
+ *
+ * Dependency-free so it is trivially unit-testable.
+ *
+ * @module
+ */
+/**
+ * Parses `pull` arguments: the `--nowait` flag, `--retry N`, and path operands.
+ *
+ * @param args - Raw command arguments.
+ * @returns The parsed flags and paths.
+ */
+export function pullArgs_parse(args) {
+    const nowait = args.includes('--nowait');
+    let retryMax = 0;
+    const paths = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--retry' && i + 1 < args.length) {
+            const n = parseInt(args[++i], 10);
+            if (!isNaN(n) && n >= 0)
+                retryMax = n;
+        }
+        else if (!args[i].startsWith('--')) {
+            paths.push(args[i]);
+        }
+    }
+    return { nowait, retryMax, paths };
+}
+//# sourceMappingURL=pull.args.js.map

package/dist/builtins/fs/pull.args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.args.js","sourceRoot":"","sources":["../../../src/builtins/fs/pull.args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,MAAM,GAAY,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,QAAQ,GAAW,CAAC,CAAC;IACzB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACjD,MAAM,CAAC,GAAW,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,QAAQ,GAAG,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * @file Builtin pull command.
+ *
+ * Blocking PACS series retrieve with parallel execution and per-series structured progress.
+ * Accepts one or more `/net/pacs/queries/...` VFS paths (query, study, or series level)
+ * and materialises the matching DICOM series into ChRIS storage.
+ *
+ * Progress is driven by LONK WebSocket push notifications (api/v1/pacs/ws/).
+ * Use `--retry N` to automatically re-fire retrieves for series that received no LONK activity.
+ *
+ * @module
+ */
+/**
+ * Pulls one or more `/net/pacs/queries/...` VFS paths into ChRIS storage.
+ *
+ * Blocking by default: emits per-series structured progress via LONK WebSocket,
+ * exits non-zero on partial failure.
+ * With `--nowait`: fires retrieves and prints `<seriesUID> <retrieveId>` per line, then returns.
+ * With `--retry N`: re-fires retrieves for [NO LONK] series up to N additional times.
+ *
+ * @param args - Command arguments (VFS paths, optional flags).
+ * @example
+ * pull /net/pacs/queries/42_AccessionNumber:12345678
+ * pull --retry 3 /net/pacs/queries/42_AccessionNumber:12345678/Study_1.2.3_US-Hips
+ */
+export declare function builtin_pull(args: string[]): Promise<void>;