@fnndsc/brasa 0.1.0

package/dist/lib/completer/index.js

@@ -0,0 +1,212 @@
+/**
+ * @file REPL Autocompletion.
+ *
+ * Provides tab-completion logic for the REPL, including built-in commands
+ * and path completion.
+ *
+ * @module
+ */
+import { session } from '../../session/index.js';
+import { plugins_listAll, vfsDispatcher, context_getSingle } from '@fnndsc/salsa';
+import { partialPath_split, completions_build } from './pathComplete.helpers.js';
+import { listCache_get } from '@fnndsc/cumin';
+import * as path from 'path';
+import { builtinCommands_list } from '../../builtins/help.js';
+import { args_tokenize } from '../parser.js';
+function completionWord_get(line) {
+    let start = 0;
+    let quote = null;
+    let escapeNext = false;
+    for (let index = 0; index < line.length; index++) {
+        const char = line[index];
+        if (escapeNext) {
+            escapeNext = false;
+            continue;
+        }
+        if (char === '\\' && quote !== "'") {
+            escapeNext = true;
+            continue;
+        }
+        if ((char === "'" || char === '"') && (!quote || quote === char)) {
+            quote = quote ? null : char;
+            continue;
+        }
+        if (!quote && /\s/.test(char)) {
+            start = index + 1;
+        }
+    }
+    const raw = line.substring(start);
+    const tokens = args_tokenize(raw);
+    const value = tokens.length > 0 ? tokens[0] : '';
+    const openingQuote = raw.startsWith("'") ? "'" : raw.startsWith('"') ? '"' : null;
+    return { raw, value, quote: openingQuote };
+}
+function completion_format(completion, word) {
+    if (word.quote === "'") {
+        return `'${completion.replace(/'/g, `'\\''`)}`;
+    }
+    if (word.quote === '"') {
+        return `"${completion.replace(/(["\\])/g, '\\$1')}`;
+    }
+    return completion.replace(/([\\\s'"`])/g, '\\$1');
+}
+/**
+ * Fetches available plugin names from /bin in the format: name-vVersion.
+ * This matches the display format used in /bin listings.
+ * Uses cache first for fast completion.
+ * @returns Array of plugin names with version suffixes.
+ */
+async function plugins_getNames() {
+    try {
+        // Check cache first for /bin
+        const listCache = listCache_get();
+        const cached = listCache.cache_get('/bin');
+        if (cached && cached.data) {
+            // Return cached plugin names immediately
+            return cached.data.map((item) => item.name);
+        }
+        // Cache miss - fetch from API (only on first tab completion)
+        const plugins = await plugins_listAll({});
+        if (plugins && plugins.tableData) {
+            const pluginNames = plugins.tableData.map((p) => {
+                const name = typeof p.name === 'string' ? p.name : String(p.name ?? '');
+                const version = typeof p.version === 'string' ? p.version : String(p.version ?? '');
+                // Format as name-vVersion to match /bin display format
+                return version ? `${name}-v${version}` : name;
+            });
+            // Cache it for next time
+            const lsItems = plugins.tableData.map((p) => {
+                const name = typeof p.name === 'string' ? p.name : String(p.name ?? '');
+                const version = typeof p.version === 'string' ? p.version : String(p.version ?? '');
+                return {
+                    name: version ? `${name}-v${version}` : name,
+                    type: 'plugin',
+                    size: 0,
+                    owner: 'system',
+                    date: p.creation_date ? String(p.creation_date) : '',
+                };
+            });
+            listCache.cache_set('/bin', lsItems);
+            return pluginNames;
+        }
+    }
+    catch (e) {
+        // Silently fail if plugins cannot be fetched
+    }
+    return [];
+}
+/**
+ * Computes autocomplete suggestions for a given input line.
+ * Uses the callback style to support asynchronous operations (fetching files).
+ *
+ * @param line - The current input line.
+ * @param callback - The callback function to return results.
+ */
+export function input_complete(line, callback) {
+    const trimmed = line.trimStart();
+    const args = args_tokenize(trimmed);
+    // Case 1: Command Completion (First word)
+    // If we have only one token and the line doesn't end with space, we are typing the command
+    // Or if line is empty
+    const isCommandCompletion = args.length === 0 || (args.length === 1 && !line.endsWith(' '));
+    if (isCommandCompletion) {
+        // Check builtins first (instant, no async)
+        const builtinHits = builtinCommands_list().filter((c) => c.startsWith(trimmed));
+        // Always check plugins and combine results
+        plugins_getNames().then((pluginNames) => {
+            const pluginHits = pluginNames.filter((c) => c.startsWith(trimmed));
+            // Combine both builtins and plugins
+            const allHits = [...builtinHits, ...pluginHits];
+            callback(null, [allHits, trimmed]);
+        }).catch(() => {
+            // On error, return only builtin matches
+            callback(null, [builtinHits, trimmed]);
+        });
+        return;
+    }
+    // Case 2: Path Completion (Argument to specific commands)
+    const cmd = args[0];
+    if (['cd', 'ls', 'mkdir', 'touch', 'cat', 'edit', 'cp', 'mv', 'rm', 'upload', 'download', 'du', 'tree', 'pull', 'cubepath', 'query'].includes(cmd)) {
+        const word = completionWord_get(line);
+        path_complete(word.value).then((matches) => {
+            callback(null, [matches.map((match) => completion_format(match, word)), word.raw]);
+        }).catch((err) => {
+            // On error, return no matches, don't crash REPL
+            callback(null, [[], word.raw]);
+        });
+        return;
+    }
+    // Default: no completion
+    callback(null, [[], line]);
+}
+/**
+ * Resolves directory contents for completion.
+ * @param partial - The partial path string typed so far.
+ */
+async function path_complete(partial) {
+    // 1. Handle ~ expansion for the partial path base
+    let effectivePartial = partial;
+    if (partial.startsWith('~')) {
+        const context = await context_getSingle();
+        const user = context.user;
+        const home = user ? `/home/${user}` : '/';
+        if (partial === '~' || partial === '~/') {
+            effectivePartial = home + (partial.endsWith('/') ? '/' : '');
+        }
+        else if (partial.startsWith('~/')) {
+            effectivePartial = path.posix.join(home, partial.substring(2));
+        }
+    }
+    // Resolve the directory to list and the prefix to match
+    const { dirToList, prefix } = partialPath_split(effectivePartial);
+    // 2. Resolve absolute path for listing
+    let absDirToList;
+    if (dirToList.startsWith('/')) {
+        absDirToList = dirToList;
+    }
+    else {
+        const cwd = await session.getCWD();
+        absDirToList = dirToList ? path.posix.resolve(cwd, dirToList) : cwd;
+    }
+    // 3. Fetch contents (check cache first)
+    let items = [];
+    const listCache = listCache_get();
+    // Check cache first
+    const cached = listCache.cache_get(absDirToList);
+    if (cached) {
+        items = cached.data;
+    }
+    else {
+        try {
+            // Use vfsDispatcher for all path types — handles /pacs, /bin, native, etc.
+            const vfsResult = await vfsDispatcher.list(absDirToList);
+            if (vfsResult.ok) {
+                items = vfsResult.value;
+            }
+            // Inject virtual directories at root if missing
+            if (absDirToList === '/' || absDirToList === '') {
+                const hasItem = (name) => items.some((i) => i.name === name);
+                if (!hasItem('bin')) {
+                    items.push({ name: 'bin', type: 'vfs', size: 0, owner: 'root', date: new Date().toISOString() });
+                }
+                if (!hasItem('usr')) {
+                    items.push({ name: 'usr', type: 'vfs', size: 0, owner: 'root', date: new Date().toISOString() });
+                }
+                if (!hasItem('pacs')) {
+                    items.push({ name: 'pacs', type: 'vfs', size: 0, owner: 'root', date: new Date().toISOString() });
+                }
+            }
+            // Cache the results
+            if (items.length > 0) {
+                listCache.cache_set(absDirToList, items);
+            }
+        }
+        catch (e) {
+            // Ignore errors (e.g., perms, not a dir)
+        }
+    }
+    // 4. Filter and format matches, preserving the original partial's style
+    // (tilde/relative) and appending "/" to directory-like entries.
+    return completions_build(items, prefix, partial);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/completer/index.js.map

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

package/dist/lib/completer/pathComplete.helpers.d.ts

@@ -0,0 +1,22 @@
+import type { ListingItem } from '@fnndsc/chili/models/listing.js';
+/**
+ * Splits an (already tilde-expanded) partial path into the directory to list
+ * and the basename prefix to match against.
+ *
+ * @param effectivePartial - The tilde-expanded partial path.
+ * @returns The directory to list (empty = cwd) and the prefix.
+ */
+export declare function partialPath_split(effectivePartial: string): {
+    dirToList: string;
+    prefix: string;
+};
+/**
+ * Builds completion strings from listing items, preserving the original
+ * partial's style (tilde/relative) and appending `/` to directory-like entries.
+ *
+ * @param items - The listing items in the target directory.
+ * @param prefix - The basename prefix being completed.
+ * @param partial - The original (unexpanded) partial the user typed.
+ * @returns The completion strings for matching items.
+ */
+export declare function completions_build(items: ListingItem[], prefix: string, partial: string): string[];

package/dist/lib/completer/pathComplete.helpers.js

@@ -0,0 +1,49 @@
+/**
+ * @file Pure helpers for filesystem path tab-completion.
+ *
+ * Splits a partial path into the directory to list and the prefix to match, and
+ * reconstructs completion strings from matching listing items. Dependency-free
+ * (path module only) for easy unit testing.
+ *
+ * @module
+ */
+import path from 'path';
+/**
+ * Splits an (already tilde-expanded) partial path into the directory to list
+ * and the basename prefix to match against.
+ *
+ * @param effectivePartial - The tilde-expanded partial path.
+ * @returns The directory to list (empty = cwd) and the prefix.
+ */
+export function partialPath_split(effectivePartial) {
+    if (effectivePartial.endsWith('/')) {
+        return { dirToList: effectivePartial, prefix: '' };
+    }
+    let dirToList = path.posix.dirname(effectivePartial);
+    const prefix = path.posix.basename(effectivePartial);
+    if (dirToList === '.')
+        dirToList = ''; // Relative current dir
+    return { dirToList, prefix };
+}
+/**
+ * Builds completion strings from listing items, preserving the original
+ * partial's style (tilde/relative) and appending `/` to directory-like entries.
+ *
+ * @param items - The listing items in the target directory.
+ * @param prefix - The basename prefix being completed.
+ * @param partial - The original (unexpanded) partial the user typed.
+ * @returns The completion strings for matching items.
+ */
+export function completions_build(items, prefix, partial) {
+    return items
+        .filter((i) => i.name.startsWith(prefix))
+        .map((hit) => {
+        const remainingSegment = hit.name.substring(prefix.length);
+        let completion = partial + remainingSegment;
+        if (hit.type === 'dir' || hit.type === 'vfs' || hit.type === 'link') {
+            completion += '/';
+        }
+        return completion;
+    });
+}
+//# sourceMappingURL=pathComplete.helpers.js.map

package/dist/lib/completer/pathComplete.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathComplete.helpers.js","sourceRoot":"","sources":["../../../src/lib/completer/pathComplete.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,gBAAwB;IACxD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,SAAS,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,SAAS,KAAK,GAAG;QAAE,SAAS,GAAG,EAAE,CAAC,CAAC,uBAAuB;IAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAE,MAAc,EAAE,OAAe;IACrF,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAgB,EAAE,EAAE;QACxB,MAAM,gBAAgB,GAAW,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,UAAU,GAAW,OAAO,GAAG,gBAAgB,CAAC;QACpD,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACpE,UAAU,IAAI,GAAG,CAAC;QACpB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/lib/parser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file Command line argument tokenizer.
+ *
+ * Splits a command line into tokens while respecting single/double quotes
+ * and backslash escapes. Quotes are stripped from the resulting tokens.
+ */
+/**
+ * Tokenizes a command line preserving quoted segments with spaces.
+ *
+ * @param line - Raw command line input.
+ * @returns Array of tokens with quotes removed.
+ */
+export declare function args_tokenize(line: string): string[];

package/dist/lib/parser.js

@@ -0,0 +1,52 @@
+/**
+ * @file Command line argument tokenizer.
+ *
+ * Splits a command line into tokens while respecting single/double quotes
+ * and backslash escapes. Quotes are stripped from the resulting tokens.
+ */
+/**
+ * Tokenizes a command line preserving quoted segments with spaces.
+ *
+ * @param line - Raw command line input.
+ * @returns Array of tokens with quotes removed.
+ */
+export function args_tokenize(line) {
+    const tokens = [];
+    let current = '';
+    let inSingle = false;
+    let inDouble = false;
+    let escapeNext = false;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        if (escapeNext) {
+            current += char;
+            escapeNext = false;
+            continue;
+        }
+        if (char === '\\') {
+            escapeNext = true;
+            continue;
+        }
+        if (char === "'" && !inDouble) {
+            inSingle = !inSingle;
+            continue;
+        }
+        if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+            continue;
+        }
+        if (!inSingle && !inDouble && /\s/.test(char)) {
+            if (current.length > 0) {
+                tokens.push(current);
+                current = '';
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (current.length > 0) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+//# sourceMappingURL=parser.js.map

package/dist/lib/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAW,EAAE,CAAC;IACzB,IAAI,QAAQ,GAAY,KAAK,CAAC;IAC9B,IAAI,QAAQ,GAAY,KAAK,CAAC;IAC9B,IAAI,UAAU,GAAY,KAAK,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7B,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,IAAI,CAAC;YAChB,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;YACD,SAAS;QACX,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/pipe.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pipes an input buffer through a spawned shell command and captures its stdout.
+ *
+ * Writes the input to the child's stdin with drain-aware backpressure handling,
+ * tolerates early-close EPIPE, and rejects on non-zero exit or spawn error.
+ *
+ * @param segment - The shell command to run (executed with `shell: true`).
+ * @param input - The data to write to the command's stdin.
+ * @returns The command's captured stdout.
+ */
+export declare function segment_pipeThrough(segment: string, input: Buffer): Promise<Buffer>;

package/dist/lib/pipe.js

@@ -0,0 +1,90 @@
+/**
+ * @file Process piping helper for shell command chains.
+ *
+ * Spawns a single shell segment, feeds it an input buffer (with backpressure
+ * handling), and resolves with its captured stdout.
+ *
+ * @module
+ */
+import { spawn } from 'child_process';
+/**
+ * Pipes an input buffer through a spawned shell command and captures its stdout.
+ *
+ * Writes the input to the child's stdin with drain-aware backpressure handling,
+ * tolerates early-close EPIPE, and rejects on non-zero exit or spawn error.
+ *
+ * @param segment - The shell command to run (executed with `shell: true`).
+ * @param input - The data to write to the command's stdin.
+ * @returns The command's captured stdout.
+ */
+export function segment_pipeThrough(segment, input) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        // When using shell: true, pass the entire command as a single string
+        const child = spawn(segment, {
+            stdio: ['pipe', 'pipe', 'inherit'],
+            shell: true,
+        });
+        child.stdout.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+        child.on('close', (code) => {
+            if (code !== 0 && code !== null) {
+                reject(new Error(`Command '${segment}' exited with code ${code}`));
+            }
+            else {
+                resolve(Buffer.concat(chunks));
+            }
+        });
+        child.on('error', (err) => {
+            reject(err);
+        });
+        // Handle EPIPE errors when child closes stdin early
+        child.stdin.on('error', (err) => {
+            if (err.code === 'EPIPE') {
+                // Child closed stdin, this is normal if it exits early — handled by 'close'.
+            }
+            else {
+                reject(err);
+            }
+        });
+        /**
+         * Writes all buffered data to child stdin with backpressure handling.
+         * Splits large buffers into chunks and waits for drain events when needed.
+         */
+        const data_writeAll = async () => {
+            if (input.length === 0) {
+                child.stdin.end();
+                return;
+            }
+            return new Promise((resolveWrite, rejectWrite) => {
+                let offset = 0;
+                const chunkSize = 64 * 1024; // 64KB chunks
+                const chunk_writeNext = () => {
+                    try {
+                        while (offset < input.length) {
+                            const end = Math.min(offset + chunkSize, input.length);
+                            const chunk = input.subarray(offset, end);
+                            offset = end;
+                            const canContinue = child.stdin.write(chunk);
+                            if (!canContinue) {
+                                child.stdin.once('drain', chunk_writeNext);
+                                return;
+                            }
+                        }
+                        child.stdin.end();
+                        resolveWrite();
+                    }
+                    catch (err) {
+                        rejectWrite(err);
+                    }
+                };
+                chunk_writeNext();
+            });
+        };
+        // Start writing in parallel with reading output; ignore write errors if the
+        // child already closed (EPIPE is handled by the stdin error handler).
+        data_writeAll().catch(() => { });
+    });
+}
+//# sourceMappingURL=pipe.js.map

package/dist/lib/pipe.js.map

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

package/dist/lib/prefetch.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Outcome of a prefetch operation (counts and status).
+ */
+export interface PrefetchResult {
+    ok: boolean;
+    count?: number;
+    pipelineCount?: number;
+    message?: string;
+}
+/**
+ * Prefetch a VFS path into the list cache.
+ *
+ * @param target - Absolute VFS path to prefetch.
+ * @returns Count of items cached on success, error message on failure.
+ */
+export declare function prefetch_path(target: string): Promise<PrefetchResult>;
+/**
+ * Run a prefetch action behind a spinner (interactive) or plain log (non-interactive).
+ *
+ * @param label        - Short label shown in the spinner column (padded to 12 chars).
+ * @param message      - Descriptive message shown next to the label.
+ * @param isInteractive - Whether the session is interactive (controls spinner vs plain log).
+ * @param action       - Async work to run; returns a PrefetchResult.
+ */
+export declare function prefetch_withSpinner(label: string, message: string, isInteractive: boolean, action: () => Promise<PrefetchResult>): Promise<PrefetchResult>;

package/dist/lib/prefetch.js

@@ -0,0 +1,64 @@
+/**
+ * @file Boot-time prefetch helpers for warming the VFS cache.
+ *
+ * Extracted from chell_start() to keep that fn focused on orchestration.
+ * All functions are pure top-level — no closure over session state.
+ *
+ * @module
+ */
+import { errorStack } from '@fnndsc/cumin';
+import { vfs } from './vfs/vfs.js';
+import { spinner } from './spinner.js';
+import { error_stripDebugPrefix } from '../builtins/index.js';
+/**
+ * Prefetch a VFS path into the list cache.
+ *
+ * @param target - Absolute VFS path to prefetch.
+ * @returns Count of items cached on success, error message on failure.
+ */
+export async function prefetch_path(target) {
+    try {
+        const result = await vfs.data_get(target);
+        if (result.ok) {
+            return { ok: true, count: result.value.length };
+        }
+        const err = errorStack.stack_pop();
+        return { ok: false, message: err ? error_stripDebugPrefix(err.message) : `Prefetch failed for ${target}` };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { ok: false, message: msg };
+    }
+}
+/**
+ * Run a prefetch action behind a spinner (interactive) or plain log (non-interactive).
+ *
+ * @param label        - Short label shown in the spinner column (padded to 12 chars).
+ * @param message      - Descriptive message shown next to the label.
+ * @param isInteractive - Whether the session is interactive (controls spinner vs plain log).
+ * @param action       - Async work to run; returns a PrefetchResult.
+ */
+export async function prefetch_withSpinner(label, message, isInteractive, action) {
+    const paddedLabel = label.padEnd(12);
+    // Spinner adds its own glyph and a following space. Pad so the label column
+    // aligns with the fixed-width status logs (e.g., "[ OK ] " = 7 chars).
+    const spinnerPrefix = ' '.repeat(5); // 1 glyph + 1 space + 5 = 7
+    const spinnerMessage = `${spinnerPrefix}${paddedLabel} ${message}`;
+    const showSpinner = isInteractive && process.stdout.isTTY;
+    if (showSpinner) {
+        spinner.start(spinnerMessage, true);
+    }
+    else {
+        console.log(spinnerMessage);
+    }
+    try {
+        return await action();
+    }
+    finally {
+        if (showSpinner) {
+            spinner.stop();
+            process.stdout.write('\r\x1b[K');
+        }
+    }
+}
+//# sourceMappingURL=prefetch.js.map

package/dist/lib/prefetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.js","sourceRoot":"","sources":["../../src/lib/prefetch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAY9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClD,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,uBAAuB,MAAM,EAAE,EAAE,CAAC;IAC7G,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,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAa,EACb,OAAe,EACf,aAAsB,EACtB,MAAqC;IAErC,MAAM,WAAW,GAAW,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,uEAAuE;IACvE,MAAM,aAAa,GAAW,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B;IACzE,MAAM,cAAc,GAAW,GAAG,aAAa,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAY,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAEnE,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lib/semicolonParser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file Semicolon command parser
+ *
+ * Parses semicolon-separated commands while respecting quotes.
+ *
+ * @module
+ */
+/**
+ * Parses a command line for semicolon separators and returns individual commands.
+ * Respects quoted strings - semicolons inside quotes are not treated as separators.
+ *
+ * @param line - The full command line.
+ * @returns An array of individual commands.
+ *
+ * @example
+ * ```typescript
+ * semicolons_parse("ls; pwd")                    // Returns: ["ls", "pwd"]
+ * semicolons_parse("echo 'a;b'; pwd")            // Returns: ["echo 'a;b'", "pwd"]
+ * semicolons_parse("cd /tmp; ls; cat file.txt")  // Returns: ["cd /tmp", "ls", "cat file.txt"]
+ * ```
+ */
+export declare function semicolons_parse(line: string): string[];

package/dist/lib/semicolonParser.js

@@ -0,0 +1,53 @@
+/**
+ * @file Semicolon command parser
+ *
+ * Parses semicolon-separated commands while respecting quotes.
+ *
+ * @module
+ */
+/**
+ * Parses a command line for semicolon separators and returns individual commands.
+ * Respects quoted strings - semicolons inside quotes are not treated as separators.
+ *
+ * @param line - The full command line.
+ * @returns An array of individual commands.
+ *
+ * @example
+ * ```typescript
+ * semicolons_parse("ls; pwd")                    // Returns: ["ls", "pwd"]
+ * semicolons_parse("echo 'a;b'; pwd")            // Returns: ["echo 'a;b'", "pwd"]
+ * semicolons_parse("cd /tmp; ls; cat file.txt")  // Returns: ["cd /tmp", "ls", "cat file.txt"]
+ * ```
+ */
+export function semicolons_parse(line) {
+    const commands = [];
+    let currentCommand = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            currentCommand += char;
+        }
+        else if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            currentCommand += char;
+        }
+        else if (char === ';' && !inSingleQuote && !inDoubleQuote) {
+            const trimmed = currentCommand.trim();
+            if (trimmed)
+                commands.push(trimmed);
+            currentCommand = '';
+        }
+        else {
+            currentCommand += char;
+        }
+    }
+    // Add final command
+    const trimmed = currentCommand.trim();
+    if (trimmed)
+        commands.push(trimmed);
+    return commands;
+}
+//# sourceMappingURL=semicolonParser.js.map