@fnndsc/brasa 0.33.4 → 0.35.0

package/dist/builtins/utils.js

@@ -1,10 +1,4 @@
-/**
- * @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';
+import { path_resolveFrom } from '../core/paths.js';
 /**
  * Bridges POSIX-parsed builtin arguments to chili's CLI option bag.
  *
@@ -112,37 +106,10 @@ export function homePath_of(user) {
     return user ? `/home/${user}` : '/';
 }
 export function path_resolvePure(inputPath, context) {
-    let resolved = inputPath;
-    const { user, cwd } = context;
-    if (inputPath.startsWith('~')) {
-        const home = homePath_of(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 });
+    return path_resolveFrom(inputPath, homePath_of(context.user), context.cwd);
 }
+// A path argument as the session means it: `~` and relative paths resolved.
+export { path_resolve } from '../core/paths.js';
 /**
  * Resolves links in a path without using PathMapper (for physical mode).
  * Checks each component to see if it's a link and follows it.
@@ -183,22 +150,5 @@ export async function path_resolveLinks(targetPath) {
     }
     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*/, '');
-}
+export { error_stripDebugPrefix } from '../core/errorText.js';
 //# sourceMappingURL=utils.js.map

package/dist/builtins/utils.js.map

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

package/dist/builtins/wildcard.d.ts

@@ -1,57 +1,8 @@
-import type { ListingItem } from '@fnndsc/menu';
-import { Result } from '@fnndsc/cumin';
-import { ShellWord } from '../lib/parser.js';
 /**
- * Checks if a string contains wildcard characters.
+ * @file Shell wildcard expansion, for the builtins that expand their own operands.
  *
- * @param arg - The argument to check.
- * @returns True if the argument contains wildcards.
- */
-export declare function string_checkHasWildcard(arg: string): boolean;
-/** A VFS item selected by wildcard expansion. */
-export interface WildcardMatch {
-    path: string;
-    type: ListingItem['type'];
-}
-/**
- * Expands one quote-aware shell word against the ChRIS filesystem.
- *
- * @param word - Parsed shell word.
- * @returns Expanded words, or the original word when it has no match.
- */
-export declare function shellWord_expand(word: ShellWord): Promise<Result<ShellWord[]>>;
-/**
- * Expands selected quote-aware shell words in argument order.
- *
- * @param words - Parsed shell words.
- * @param eligible - Predicate that preserves explicit cross-realm operands.
- * @returns Expanded words, retaining literal words when no path matches.
- */
-export declare function shellWords_expand(words: readonly ShellWord[], eligible: (word: ShellWord, index: number) => boolean): Promise<Result<ShellWord[]>>;
-/**
- * Expands a wildcard pattern against the current directory with item type.
- *
- * @param pattern - The glob pattern (e.g., "*.ts", "test*.json").
- * @returns A Promise resolving to Result<WildcardMatch[]>.
- *          Ok([]) = no matches (not an error).
- *          Err(...) = couldn't expand (API failure, permission denied, etc.).
- */
-export declare function wildcard_expandMatches(pattern: string): Promise<Result<WildcardMatch[]>>;
-/**
- * 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.
+ * The expansion is the core's (`lib/wildcard.ts`).
  *
- * @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.
+ * @module
  */
-export declare function wildcards_expandAll(args: string[]): Promise<Result<string[]>>;
+export * from '../lib/wildcard.js';

package/dist/builtins/wildcard.js

@@ -1,183 +1,9 @@
 /**
- * @file Wildcard expansion for shell commands.
+ * @file Shell wildcard expansion, for the builtins that expand their own operands.
  *
- * Provides glob pattern matching against the ChRIS filesystem.
+ * The expansion is the core's (`lib/wildcard.ts`).
  *
  * @module
  */
-import { minimatch } from 'minimatch';
-import { listingItemsFromVfs_make } from '../lib/vfs/listing.js';
-import { session } from '../session/index.js';
-import { path_resolveChrisFs } from '@fnndsc/chili/utils/cli.js';
-import { vfsDispatcher } from '@fnndsc/salsa';
-import { listCache_get, Ok, Err, errorStack } from '@fnndsc/cumin';
-import { shellWord_literal, shellWord_unquoted } from '../lib/parser.js';
-import { path_resolve } from './utils.js';
-/**
- * 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 rendered pattern and its quote-aware minimatch pattern.
- *
- * @param value - Rendered shell-word value.
- * @param globPattern - Quote-aware minimatch pattern.
- * @returns A Promise resolving to Result<WildcardMatch[]>.
- *          Ok([]) = no matches (not an error).
- *          Err(...) = couldn't expand (API failure, permission denied, etc.).
- */
-async function wildcardMatches_expand(value, globPattern) {
-    try {
-        // Get current directory
-        const cwd = await session.getCWD();
-        const resolvedValue = await path_resolve(value);
-        const resolvedPattern = await path_resolve(globPattern);
-        // Handle patterns with directory components (e.g., "data/*.txt")
-        let searchDir = cwd;
-        let physicalSearchDir = cwd;
-        let matchPattern = resolvedPattern;
-        // Resolve the non-wildcard parent directory before listing. This gives
-        // `~/...` its normal meaning and follows a CFS `.chrislink` parent while
-        // retaining the caller's logical spelling in the expanded result.
-        if (resolvedValue.includes('/')) {
-            const valueParts = resolvedValue.split('/');
-            const patternParts = resolvedPattern.split('/');
-            const lastPart = patternParts.pop() || '*';
-            valueParts.pop();
-            const dirPart = valueParts.join('/');
-            searchDir = dirPart || '/';
-            physicalSearchDir = await path_resolveChrisFs(searchDir, {});
-            matchPattern = lastPart;
-        }
-        // List files in the directory (check cache first)
-        let items = [];
-        const listCache = listCache_get();
-        const cached = listCache.cache_get(physicalSearchDir);
-        if (cached) {
-            items = cached.data;
-        }
-        else {
-            const vfsResult = await vfsDispatcher.list(physicalSearchDir);
-            if (vfsResult.ok) {
-                items = listingItemsFromVfs_make(vfsResult.value);
-                listCache.cache_set(physicalSearchDir, items);
-            }
-            else {
-                return Err();
-            }
-        }
-        // Filter items by pattern
-        const matches = items
-            .filter((item) => minimatch(item.name, matchPattern))
-            .map((item) => {
-            // Return a full path if we searched a different directory.
-            const itemPath = searchDir !== cwd
-                ? `${searchDir}/${item.name}`.replace(/\/+/g, '/')
-                : item.name;
-            return {
-                path: itemPath,
-                type: item.type,
-            };
-        });
-        // 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 '${value}': ${errorMsg}`);
-        return Err();
-    }
-}
-/**
- * Expands one quote-aware shell word against the ChRIS filesystem.
- *
- * @param word - Parsed shell word.
- * @returns Expanded words, or the original word when it has no match.
- */
-export async function shellWord_expand(word) {
-    if (!word.pathnameExpansion)
-        return Ok([word]);
-    const result = await wildcardMatches_expand(word.value, word.globPattern);
-    if (!result.ok)
-        return result;
-    if (result.value.length === 0)
-        return Ok([word]);
-    return Ok(result.value.map((match) => ({
-        ...shellWord_literal(match.path),
-        pathnameExpanded: true,
-    })));
-}
-/**
- * Expands selected quote-aware shell words in argument order.
- *
- * @param words - Parsed shell words.
- * @param eligible - Predicate that preserves explicit cross-realm operands.
- * @returns Expanded words, retaining literal words when no path matches.
- */
-export async function shellWords_expand(words, eligible) {
-    const expanded = [];
-    for (const [index, word] of words.entries()) {
-        if (!eligible(word, index)) {
-            expanded.push(word);
-            continue;
-        }
-        const result = await shellWord_expand(word);
-        if (!result.ok)
-            return result;
-        expanded.push(...result.value);
-    }
-    return Ok(expanded);
-}
-/**
- * Expands a wildcard pattern against the current directory with item type.
- *
- * @param pattern - The glob pattern (e.g., "*.ts", "test*.json").
- * @returns A Promise resolving to Result<WildcardMatch[]>.
- *          Ok([]) = no matches (not an error).
- *          Err(...) = couldn't expand (API failure, permission denied, etc.).
- */
-export async function wildcard_expandMatches(pattern) {
-    if (!string_checkHasWildcard(pattern))
-        return Ok([{ path: pattern, type: 'file' }]);
-    return wildcardMatches_expand(pattern, pattern);
-}
-/**
- * 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 (!string_checkHasWildcard(pattern))
-        return Ok([pattern]);
-    const word = shellWord_unquoted(pattern);
-    const result = await shellWord_expand(word);
-    if (!result.ok)
-        return result;
-    if (result.value.length === 1 && result.value[0] === word)
-        return Ok([]);
-    return Ok(result.value.map((match) => match.value));
-}
-/**
- * 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 words = args.map((arg) => shellWord_unquoted(arg));
-    const result = await shellWords_expand(words, () => true);
-    if (!result.ok)
-        return result;
-    return Ok(result.value.map((word) => word.value));
-}
+export * from '../lib/wildcard.js';
 //# sourceMappingURL=wildcard.js.map

package/dist/builtins/wildcard.js.map

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

package/dist/chris/backend.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file The ChRIS backend's descriptor: a session over a CUBE.
+ *
+ * The identity's context (cumin's per-user, per-CUBE configuration) names
+ * the session (the CUBE user and URL) and holds the working directory; the
+ * home is the CUBE user's home. The CUBE connection the ChRIS commands use is
+ * reached as `session.connection`, which this module adds to the session.
+ * The prompt and the daemon's heartbeat read the user, the CUBE, PACS and
+ * the /proc index (`promptContext.ts`).
+ *
+ * @module
+ */
+import { chrisConnection } from '@fnndsc/cumin';
+import type { Backend } from '../core/backend.js';
+declare module '../session/index.js' {
+    interface Session {
+        /** The CUBE connection the ChRIS commands use. */
+        readonly connection: typeof chrisConnection;
+    }
+}
+/** The ChRIS backend: a session over a CUBE. */
+export declare const chrisBackend: Backend;

package/dist/chris/backend.js

@@ -0,0 +1,102 @@
+/**
+ * @file The ChRIS backend's descriptor: a session over a CUBE.
+ *
+ * The identity's context (cumin's per-user, per-CUBE configuration) names
+ * the session (the CUBE user and URL) and holds the working directory; the
+ * home is the CUBE user's home. The CUBE connection the ChRIS commands use is
+ * reached as `session.connection`, which this module adds to the session.
+ * The prompt and the daemon's heartbeat read the user, the CUBE, PACS and
+ * the /proc index (`promptContext.ts`).
+ *
+ * @module
+ */
+import { chrisConnection, chrisConnection_init, NodeStorageProvider, chrisContext, Context } from '@fnndsc/cumin';
+import { Session } from '../session/index.js';
+import { homePath_of } from '../builtins/utils.js';
+import { runtimeOutput_set } from '@fnndsc/cumin/runtime-output';
+import { sink_get } from '../core/sink.js';
+import { procIndex_snapshot, sessionPromptContext_build } from './promptContext.js';
+import { chrisAnswerKinds, chrisReferences, chrisVerbTakes } from './references.js';
+import { chrisFallback } from './commandFallback.js';
+import { chrisFiles } from './files.js';
+import { elevation_run } from '@fnndsc/chili/commands/connect/elevation.js';
+import { chrisWatch } from './watch.js';
+import { chrisJobsSource } from './tasks.js';
+import { chrisListingLook } from '@fnndsc/chili/views/ls.js';
+import { chrisFilesystem } from './filesystem.js';
+import { chrisMounts_register } from './mounts.js';
+import { chrisCompletion } from './completion.js';
+import { chrisDebug_get, chrisDebug_set } from './debug.js';
+let connection;
+// cumin reports operational notices through a narrow port. The callback
+// resolves the sink at write time, preserving each invocation's
+// AsyncLocalStorage scope rather than pinning output to one terminal.
+runtimeOutput_set({
+    data_write: (chunk) => { sink_get().data_write(chunk); },
+    err_write: (chunk) => { sink_get().err_write(chunk); },
+});
+Object.defineProperty(Session.prototype, 'connection', {
+    get() {
+        return connection || chrisConnection;
+    },
+    configurable: true,
+});
+/** A ChRIS session with no restored CUBE login: its berth name is `disconnected@no-cube`. */
+const CHRIS_DISCONNECTED = { user: 'disconnected', where: 'no-cube', connected: false };
+/** The ChRIS backend: a session over a CUBE. */
+export const chrisBackend = {
+    id: 'chris',
+    session: {
+        async init() {
+            chrisMounts_register();
+            const nodeStorageProvider = new NodeStorageProvider();
+            // Initialize the connection singleton which also initializes config
+            connection = await chrisConnection_init(nodeStorageProvider);
+            try {
+                // Also initialize chili's duplicate copy of the connection singleton to align monorepo package boundaries
+                const { chrisConnection_init: chiliConnection_init } = await import('@fnndsc/chili/utils');
+                await chiliConnection_init(nodeStorageProvider);
+            }
+            catch (e) {
+                // Deliberate absorption, adjudicated 2026-08: chili's connection init
+                // is an optional secondary wiring (cumin's own init is the required
+                // one); when it is absent or fails, chili paths fall back to cumin's
+                // connection at call time.
+            }
+        },
+        async identity_get() {
+            const where = await chrisContext.ChRISURL_get();
+            const user = await chrisContext.ChRISuser_get();
+            return user && where ? { user, where, connected: true } : CHRIS_DISCONNECTED;
+        },
+        async user_get() {
+            return chrisContext.ChRISuser_get();
+        },
+        async home_get() {
+            return homePath_of(await chrisContext.current_get(Context.ChRISuser));
+        },
+        async cwd_load() {
+            return chrisContext.current_get(Context.ChRISfolder);
+        },
+        async cwd_save(path) {
+            // Cache invalidation is handled automatically by cumin's chrisContext.
+            await chrisContext.current_set(Context.ChRISfolder, path);
+        },
+    },
+    prompt: sessionPromptContext_build,
+    telemetry: procIndex_snapshot,
+    references: chrisReferences,
+    answerKinds: chrisAnswerKinds,
+    verbTakes: chrisVerbTakes,
+    fallback: chrisFallback,
+    elevate: elevation_run,
+    watch: chrisWatch,
+    tasks: [chrisJobsSource],
+    files: chrisFiles,
+    vfs: chrisFilesystem,
+    completion: chrisCompletion,
+    listingLook: chrisListingLook,
+    debug_get: chrisDebug_get,
+    debug_set: chrisDebug_set,
+};
+//# sourceMappingURL=backend.js.map

package/dist/chris/backend.js.map

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

package/dist/chris/binEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binEntry.js","sourceRoot":"","sources":["../../src/chris/binEntry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,SAAS,CAAC;AAW3C;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,MAAM,OAAO,GAA4B,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC,SAAS,CAAmB,MAAM,CAAC,CAAC;IACnE,MAAM,KAAK,GAA+B,MAAM,EAAE,IAAI,CAAC,IAAI,CACzD,CAAC,SAAyB,EAAW,EAAE,CACrC,SAAS,CAAC,IAAI,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW,CAClE,CAAC;IACF,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAExD,OAAO;QACL,OAAO,EAAE,WAAW;QACpB,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,EAAE,KAAK,EAAE,KAAK;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA2B;IACnE,OAAO,QAAQ,CAAC;QACd,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7D,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,qBAAqB,OAAO,CAAC,OAAO,EAAE;KACjD,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/chris/binMount.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @file `/bin` in a ChRIS session: CUBE's plugins and pipelines, as executables.
+ *
+ * Listing it reads the plugins and pipelines CUBE holds; reading an entry
+ * gives a plugin's manual or a pipeline's summary. Nothing here writes or
+ * copies.
+ *
+ * @module
+ */
+import { type VfsOutcome } from '@fnndsc/fond';
+import { Result, type VFSProvider, type VFSItem, type CpOptions } from '@fnndsc/fond';
+/** `/bin`: CUBE's plugins and pipelines. */
+export declare class BinVfsProvider implements VFSProvider {
+    /** The prefix this provider handles. */
+    prefix: string;
+    /**
+     * Lists the plugins (as `name-vVERSION`) and the pipelines (by slug).
+     *
+     * @param pathStr - The absolute path.
+     * @param options - Sort controls.
+     * @returns The executables.
+     */
+    list(pathStr: string, options?: {
+        sort?: "name" | "size" | "date" | "owner";
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /** @inheritdoc */
+    cp(src: string, dest: string, options: CpOptions): Promise<VfsOutcome>;
+    /**
+     * Refuses to copy from `/bin`.
+     *
+     * @param src - Source path.
+     * @param dest - Destination path.
+     * @param options - Copy options.
+     * @returns False, always.
+     */
+    private copy_run;
+    /** @inheritdoc */
+    rm(): Promise<VfsOutcome>;
+    /** @inheritdoc */
+    rmTree(): Promise<VfsOutcome>;
+    /** @inheritdoc */
+    read(pathStr: string): Promise<VfsOutcome<string>>;
+    /**
+     * Reads an entry: a pipeline's summary, or a plugin's manual.
+     *
+     * @param pathStr - The absolute path of the entry.
+     * @returns The text.
+     */
+    private text_read;
+    /** @inheritdoc */
+    readBinary(pathStr: string): Promise<VfsOutcome<Buffer>>;
+    /**
+     * Reads an entry as bytes.
+     *
+     * @param pathStr - The absolute path of the entry.
+     * @returns The text's bytes.
+     */
+    private bytes_read;
+}