@fnndsc/brasa 0.1.0

package/dist/lib/vfs/vfs.js

@@ -0,0 +1,202 @@
+/**
+ * @file Virtual File System Router.
+ *
+ * Handles path resolution and dispatching to appropriate file system providers
+ * (native ChRIS or virtual overlays like /bin).
+ *
+ * @module
+ */
+import { vfsDispatcher } from '@fnndsc/salsa';
+import { session } from '../../session/index.js';
+import chalk from 'chalk';
+import * as path from 'path';
+import { grid_render, long_render } from '@fnndsc/chili/views/ls.js';
+import { list_applySort } from '@fnndsc/chili/utils/sort.js';
+import { listCache_get, Ok, Err, errorStack } from '@fnndsc/cumin';
+import { spinner } from '../spinner.js';
+import { error_stripDebugPrefix } from '../../builtins/utils.js';
+/**
+ * Virtual File System Router.
+ * Dispatches operations to Virtual or Native providers.
+ */
+export class VFS {
+    /**
+     * Gets data for a directory (Virtual or Native).
+     * Separated from rendering to allow Result<T> pattern.
+     *
+     * @param targetPath - The path to get data for. If empty, uses CWD.
+     * @param options - Options including directory flag and sort.
+     * @returns Result<ListingItem[]> - Ok with items or Err with error message.
+     */
+    async data_get(targetPath, options = {}) {
+        try {
+            const cwd = await session.getCWD();
+            const effectivePath = targetPath
+                ? path.posix.resolve(cwd, targetPath)
+                : cwd;
+            // -d: show the target entry itself rather than descending into it
+            if (options.directory && targetPath) {
+                return this.directoryEntry_get(effectivePath, options);
+            }
+            // /proc paths are backed by ProcCache which manages its own freshness —
+            // skip listCache entirely so proc refresh and live status reads are visible.
+            const isProcPath = effectivePath.startsWith('/proc');
+            // Check cache first (not for /proc paths)
+            const listCache = listCache_get();
+            if (!isProcPath) {
+                const cached = listCache.cache_get(effectivePath);
+                if (cached) {
+                    const sortField = options.sort || 'name';
+                    const sortedItems = list_applySort(cached.data, sortField, options.reverse);
+                    return Ok(sortedItems);
+                }
+            }
+            // Delegate path queries to the unified vfsDispatcher (which handles both virtual and native paths)
+            const vfsResult = await vfsDispatcher.list(effectivePath, options);
+            if (vfsResult.ok) {
+                const items = vfsResult.value;
+                // Cache the results (not for /proc paths)
+                if (!isProcPath) {
+                    listCache.cache_set(effectivePath, items);
+                }
+                return Ok(items);
+            }
+            return Err();
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            errorStack.stack_push("error", `Failed to get directory data: ${errorMsg}`);
+            return Err();
+        }
+    }
+    /**
+     * Returns the directory entry for `absolutePath` itself (not its contents).
+     * Looks up the entry in the parent's listing — used to implement `ls -d`.
+     *
+     * @param absolutePath - The fully resolved path of the target.
+     * @param options - Sort options forwarded to the parent listing.
+     */
+    async directoryEntry_get(absolutePath, options) {
+        const baseName = path.posix.basename(absolutePath);
+        const parentPath = path.posix.dirname(absolutePath);
+        if (!baseName || absolutePath === '/') {
+            return Ok([{ name: '/', type: 'vfs', size: 0, owner: 'root', date: '' }]);
+        }
+        // Fetch parent listing (use cache when available)
+        const listCache = listCache_get();
+        let parentItems = null;
+        const cached = listCache.cache_get(parentPath);
+        if (cached) {
+            parentItems = cached.data;
+        }
+        else {
+            const parentResult = await vfsDispatcher.list(parentPath, options);
+            if (parentResult.ok) {
+                parentItems = parentResult.value;
+                listCache.cache_set(parentPath, parentItems);
+            }
+        }
+        if (parentItems) {
+            const match = parentItems.find((item) => item.name === baseName);
+            if (match)
+                return Ok([match]);
+        }
+        // Fallback: synthesize an entry from the path name
+        return Ok([{ name: baseName, type: 'dir', size: 0, owner: 'system', date: '' }]);
+    }
+    /**
+     * List contents of a directory (Virtual or Native).
+     * Convenience method that fetches data and renders it.
+     * Implements optimistic rendering with progress feedback:
+     * - Stale cache: serve immediately with "(cached, refreshing...)" indicator
+     * - Cache miss: show "Fetching..." after 500ms if still loading
+     *
+     * @param targetPath - The path to list. If empty, uses CWD.
+     * @param options - Listing options (long, human, sort, reverse, directory).
+     */
+    async list(targetPath, options = {}) {
+        // Resolve effective path for cache checking
+        const cwd = await session.getCWD();
+        const effectivePath = targetPath
+            ? path.posix.resolve(cwd, targetPath)
+            : cwd;
+        // Check if we're serving from stale cache BEFORE fetching
+        const listCache = listCache_get();
+        const cached = listCache.cache_get(effectivePath);
+        const wasStale = cached && !cached.fresh;
+        const isCacheMiss = !cached;
+        // For cache miss, show loading indicator after 500ms timeout
+        let spinnerStarted = false; // Flag to track if spinner was actually started
+        let spinnerDelayTimeout = null;
+        if (isCacheMiss) {
+            spinnerDelayTimeout = setTimeout(() => {
+                spinner.start('Fetching directory from remote', true); // The spinner message with timing
+                spinnerStarted = true;
+            }, 500);
+        }
+        // Fetch data (may be from cache)
+        const result = await this.data_get(targetPath, options);
+        // Clear loading timeout and indicator
+        if (spinnerDelayTimeout) {
+            clearTimeout(spinnerDelayTimeout);
+        }
+        if (spinnerStarted) {
+            spinner.stop();
+        }
+        if (!result.ok) {
+            const lastError = errorStack.stack_pop();
+            if (lastError) {
+                console.error(chalk.red(error_stripDebugPrefix(lastError.message)));
+            }
+            return;
+        }
+        if (result.value.length === 0) {
+            return;
+        }
+        // Render based on options
+        if (options.long) {
+            console.log(long_render(result.value, { human: !!options.human }));
+        }
+        else {
+            console.log(grid_render(result.value, { oneColumn: !!options.oneColumn }));
+        }
+        // If we served stale cache, show indicator and refresh in background
+        if (wasStale) {
+            console.log(chalk.gray('(cached, refreshing...)'));
+            // Trigger background refresh - don't await. Fenced in its own error-stack
+            // scope so its pushes/pops cannot corrupt a concurrent foreground
+            // command's error-drain window.
+            errorStack.scope_run(() => {
+                this.refreshInBackground(effectivePath, options).catch(() => {
+                    // Silently ignore refresh errors - user has moved on
+                });
+            });
+        }
+    }
+    /**
+     * Refreshes cache in the background without blocking or updating display.
+     * Used for optimistic rendering - fetch fresh data after serving stale cache.
+     *
+     * @param targetPath - The path to refresh.
+     * @param options - Options including sort and reverse.
+     */
+    async refreshInBackground(targetPath, options) {
+        try {
+            // Invalidate cache to force fresh fetch
+            const listCache = listCache_get();
+            listCache.cache_invalidate(targetPath);
+            // Fetch fresh data - this will repopulate cache
+            await this.data_get(targetPath, options);
+            // Don't update display - user has moved on
+            // Fresh data is now cached for next access
+        }
+        catch (_error) {
+            // Silently fail - background refresh is best-effort
+        }
+    }
+}
+/**
+ * Shared VFS singleton.
+ */
+export const vfs = new VFS();
+//# sourceMappingURL=vfs.js.map

package/dist/lib/vfs/vfs.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Manages the shell session state (Connection, Context).
+ */
+export declare class Session {
+    private static instance;
+    private _connection;
+    private _offline;
+    private _physicalMode;
+    private _timingEnabled;
+    /**
+     * Private constructor for Singleton.
+     */
+    private constructor();
+    /**
+     * Returns the singleton instance of the Session.
+     */
+    static getInstance(): Session;
+    /**
+     * Initialize the session (load config/token).
+     */
+    init(): Promise<void>;
+    /**
+     * Get Current Working Directory from Context.
+     */
+    getCWD(): Promise<string>;
+    /**
+     * Set Current Working Directory.
+     * Cache invalidation is handled automatically by cumin's chrisContext.
+     */
+    setCWD(path: string): Promise<void>;
+    /**
+     * Access the underlying ChRIS Connection singleton.
+     */
+    get connection(): import("@fnndsc/cumin").ChRISConnection;
+    /**
+     * Get offline status.
+     */
+    get offline(): boolean;
+    /**
+     * Set offline status.
+     */
+    set offline(value: boolean);
+    /**
+     * Gets physical filesystem mode status.
+     *
+     * When true, path operations work directly with physical paths
+     * without logical-to-physical mapping.
+     *
+     * @returns True if in physical mode, false if using logical paths.
+     */
+    physicalMode_get(): boolean;
+    /**
+     * Sets physical filesystem mode.
+     *
+     * @param enabled - True to enable physical mode, false for logical mode.
+     */
+    physicalMode_set(enabled: boolean): void;
+    /**
+     * Gets timing mode status.
+     *
+     * When true, command execution times are displayed after each command.
+     *
+     * @returns True if timing is enabled, false otherwise.
+     */
+    timingEnabled_get(): boolean;
+    /**
+     * Sets timing mode.
+     *
+     * @param enabled - True to enable timing display, false to disable.
+     */
+    timingEnabled_set(enabled: boolean): void;
+}
+/**
+ * Shared Session singleton.
+ */
+export declare const session: Session;

package/dist/session/index.js

@@ -0,0 +1,120 @@
+/**
+ * @file Session Management.
+ *
+ * Maintains the global state of the shell, including connection and context.
+ *
+ * @module
+ */
+import { chrisConnection, chrisConnection_init, NodeStorageProvider, chrisContext, Context } from '@fnndsc/cumin';
+/**
+ * Manages the shell session state (Connection, Context).
+ */
+export class Session {
+    static instance;
+    _connection;
+    _offline = false;
+    _physicalMode = false;
+    _timingEnabled = false;
+    /**
+     * Private constructor for Singleton.
+     */
+    constructor() { }
+    /**
+     * Returns the singleton instance of the Session.
+     */
+    static getInstance() {
+        if (!Session.instance) {
+            Session.instance = new Session();
+        }
+        return Session.instance;
+    }
+    /**
+     * Initialize the session (load config/token).
+     */
+    async init() {
+        const nodeStorageProvider = new NodeStorageProvider();
+        // Initialize the connection singleton which also initializes config
+        this._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) {
+            // Fail silently if chili utilities connection initialization is not needed/available
+        }
+    }
+    /**
+     * Get Current Working Directory from Context.
+     */
+    async getCWD() {
+        return await chrisContext.current_get(Context.ChRISfolder) || '/';
+    }
+    /**
+     * Set Current Working Directory.
+     * Cache invalidation is handled automatically by cumin's chrisContext.
+     */
+    async setCWD(path) {
+        await chrisContext.current_set(Context.ChRISfolder, path);
+    }
+    /**
+     * Access the underlying ChRIS Connection singleton.
+     */
+    get connection() {
+        return this._connection || chrisConnection;
+    }
+    /**
+     * Get offline status.
+     */
+    get offline() {
+        return this._offline;
+    }
+    /**
+     * Set offline status.
+     */
+    set offline(value) {
+        this._offline = value;
+    }
+    /**
+     * Gets physical filesystem mode status.
+     *
+     * When true, path operations work directly with physical paths
+     * without logical-to-physical mapping.
+     *
+     * @returns True if in physical mode, false if using logical paths.
+     */
+    physicalMode_get() {
+        return this._physicalMode;
+    }
+    /**
+     * Sets physical filesystem mode.
+     *
+     * @param enabled - True to enable physical mode, false for logical mode.
+     */
+    physicalMode_set(enabled) {
+        this._physicalMode = enabled;
+    }
+    /**
+     * Gets timing mode status.
+     *
+     * When true, command execution times are displayed after each command.
+     *
+     * @returns True if timing is enabled, false otherwise.
+     */
+    timingEnabled_get() {
+        return this._timingEnabled;
+    }
+    /**
+     * Sets timing mode.
+     *
+     * @param enabled - True to enable timing display, false to disable.
+     */
+    timingEnabled_set(enabled) {
+        this._timingEnabled = enabled;
+    }
+}
+/**
+ * Shared Session singleton.
+ */
+export const session = Session.getInstance();
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAElH;;GAEG;AACH,MAAM,OAAO,OAAO;IACV,MAAM,CAAC,QAAQ,CAAU;IACzB,WAAW,CAAqC;IAChD,QAAQ,GAAY,KAAK,CAAC;IAC1B,aAAa,GAAY,KAAK,CAAC;IAC/B,cAAc,GAAY,KAAK,CAAC;IAExC;;OAEG;IACH,gBAAuB,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,mBAAmB,GAAwB,IAAI,mBAAmB,EAAE,CAAC;QAC3E,oEAAoE;QACpE,IAAI,CAAC,WAAW,GAAG,MAAM,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,0GAA0G;YAC1G,MAAM,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC3F,MAAM,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,qFAAqF;QACvF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,MAAM,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,IAAI,eAAe,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,KAAc;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAgB;QAC/B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,OAAgB;QAChC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,OAAO,CAAC,WAAW,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@fnndsc/brasa",
+  "version": "0.1.0",
+  "description": "BRASA Runs Abstracted Shell Actions - the hostable ChRIS shell engine (kernel)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FNNDSC/mise.git",
+    "directory": "packages/brasa"
+  },
+  "homepage": "https://github.com/FNNDSC/mise/tree/main/packages/brasa#readme",
+  "bugs": {
+    "url": "https://github.com/FNNDSC/mise/issues"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "rm -fr dist && tsc",
+    "test": "NODE_OPTIONS='--experimental-vm-modules --disable-warning=ExperimentalWarning' jest --forceExit --passWithNoTests --coverage"
+  },
+  "keywords": [
+    "chris",
+    "fnndsc",
+    "shell",
+    "engine",
+    "kernel"
+  ],
+  "author": "FNNDSC <dev@babyMRI.org>",
+  "license": "MIT",
+  "dependencies": {
+    "@fnndsc/chili": "^3.3.0",
+    "@fnndsc/cumin": "^3.5.0",
+    "@fnndsc/salsa": "^3.2.6",
+    "chalk": "^4.1.2",
+    "minimatch": "^10.1.1",
+    "ws": "^8.21.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/minimatch": "^5.1.2",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.5.2"
+  }
+}