@fnndsc/brasa 0.1.0

package/dist/core/dispatch.js

@@ -0,0 +1,618 @@
+/**
+ * @file Command dispatch for the ChELL shell.
+ *
+ * Turns one parsed command into an executed command with an envelope result:
+ * - the built-in command table and dispatch to built-ins, simulated plugin exec, or `chili`
+ * - output capture for the redirect/pipe paths
+ * - envelope-producing execution used by the engine facade
+ *
+ * Line-level orchestration (shell escape, semicolon batching, redirect and
+ * pipe detection) lives in `./engine.js`; the startup/connection/REPL glue
+ * lives in `./boot.js`.
+ *
+ * @module
+ */
+import { writeFileSync, appendFileSync } from 'fs';
+import chalk from 'chalk';
+import { spawn } from 'child_process';
+import { builtin_cd, builtin_ls, builtin_pwd, builtin_connect, builtin_logout, builtin_cat, builtin_cp, builtin_mv, builtin_upload, builtin_pacs, builtin_pipeline, builtin_pull, builtin_query, builtin_cubepath, builtin_rm, builtin_touch, builtin_mkdir, builtin_plugin, builtin_feed, builtin_compute, builtin_tag, builtin_group, builtin_pluginmeta, builtin_plugininstance, builtin_workflow, builtin_download, builtin_edit, builtin_files, builtin_links, builtin_dirs, builtin_context, builtin_parametersofplugin, builtin_physicalmode, builtin_timing, builtin_whoami, builtin_whereami, builtin_version, builtin_debug, builtin_help, builtin_tree, builtin_du, builtin_store, error_stripDebugPrefix } from '../builtins/index.js';
+import { builtin_executePlugin } from '../builtins/pluginExecute.js';
+import { builtin_proc } from '../builtins/proc.js';
+import { wildcards_expandAll } from '../builtins/wildcard.js';
+import { help_show, args_checkHasHelpFlag } from '../builtins/help.js';
+import { pluginExecutable_handle } from '../builtins/executable.js';
+import { errorStack, Ok, Err } from '@fnndsc/cumin';
+import { envelopeHandler_wrap, printingHandler_wrap, ansi_strip, envelope_deliver, sink_get } from './sink.js';
+import { vfs } from '../lib/vfs/vfs.js';
+import { args_tokenize } from '../lib/parser.js';
+import { surface_get, capability_require } from './surface.js';
+import { redirectTarget_resolve, wildcards_expandCheck, } from './preprocess.js';
+import { chiliCommand_run } from './chiliDelegate.js';
+export { chiliCommand_run };
+/**
+ * Executes a shell command on the host system (shell escape with ! prefix).
+ *
+ * @param shellCommand - The command to execute on the host shell.
+ * @returns A Promise resolving to the command's exit code (1 on spawn failure).
+ */
+export async function shellCommand_execute(shellCommand) {
+    return new Promise((resolve) => {
+        const child = spawn(shellCommand, {
+            shell: true,
+            stdio: 'inherit',
+            env: process.env
+        });
+        child.on('close', (code) => {
+            if (code !== null && code !== 0) {
+                console.error(chalk.red(`Shell command exited with code ${code}`));
+            }
+            resolve(code ?? 0);
+        });
+        child.on('error', (err) => {
+            console.error(chalk.red(`Failed to execute shell command: ${err.message}`));
+            resolve(1);
+        });
+    });
+}
+/**
+ * Captures console output during command execution.
+ *
+ * @param fn - The function to execute while capturing output.
+ * @returns The captured output as a string and buffer.
+ */
+async function output_capture(fn) {
+    const chunks = [];
+    const originalLog = console.log;
+    const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+    // Override console.log and console.error
+    console.log = (...args) => {
+        const text = args.map(arg => typeof arg === 'string' ? arg : JSON.stringify(arg)).join(' ') + '\n';
+        chunks.push(Buffer.from(text, 'utf-8'));
+    };
+    // Override process.stdout.write to capture binary data
+    process.stdout.write = ((chunk) => {
+        if (typeof chunk === 'string') {
+            chunks.push(Buffer.from(chunk, 'utf-8'));
+        }
+        else if (Buffer.isBuffer(chunk)) {
+            chunks.push(chunk);
+        }
+        else if (chunk instanceof Uint8Array) {
+            chunks.push(Buffer.from(chunk));
+        }
+        return true;
+    });
+    try {
+        await fn();
+    }
+    finally {
+        // Restore original console methods and stdout.write
+        console.log = originalLog;
+        process.stdout.write = originalStdoutWrite;
+    }
+    const buffer = Buffer.concat(chunks);
+    const text = buffer.toString('utf-8');
+    return { text, buffer };
+}
+/**
+ * Builtins that have been converted to return envelopes, keyed by command
+ * name. Entries here are also present in COMMAND_HANDLERS in wrapped form;
+ * this registry exists so envelope-aware hosts can bypass the wrapper and
+ * receive the structured result.
+ */
+/**
+ * Composes the capture bridge with envelope delivery, so a legacy printing
+ * handler participates in the dispatch table with envelope semantics and
+ * unchanged observable output.
+ *
+ * @param handler - A legacy printing command handler.
+ * @returns A wrapped handler for the dispatch table.
+ */
+function printingBridge_wrap(handler) {
+    return envelopeHandler_wrap(printingHandler_wrap(handler));
+}
+export const ENVELOPE_HANDLERS = {
+    cat: builtin_cat,
+    cd: builtin_cd,
+    cp: builtin_cp,
+    mv: builtin_mv,
+    rm: builtin_rm,
+    mkdir: builtin_mkdir,
+    touch: builtin_touch,
+    pwd: builtin_pwd,
+    whoami: builtin_whoami,
+    whereami: builtin_whereami,
+    timing: builtin_timing,
+    physicalmode: builtin_physicalmode,
+    debug: builtin_debug,
+    version: builtin_version,
+    // Bridged (captured) handlers: envelope semantics without typed models.
+    // plugin is deliberately absent: its add flow prompts for admin
+    // credentials through readline, which capture would make invisible.
+    ls: printingHandler_wrap(builtin_ls),
+    tree: printingHandler_wrap(builtin_tree),
+    du: printingHandler_wrap(builtin_du),
+    help: printingHandler_wrap(builtin_help),
+    proc: printingHandler_wrap(builtin_proc),
+    logout: printingHandler_wrap(builtin_logout),
+    cubepath: printingHandler_wrap(builtin_cubepath),
+    query: printingHandler_wrap(builtin_query),
+    feed: printingHandler_wrap(builtin_feed),
+    feeds: printingHandler_wrap(builtin_feed),
+    compute: printingHandler_wrap(builtin_compute),
+    computes: printingHandler_wrap(builtin_compute),
+    tag: printingHandler_wrap(builtin_tag),
+    tags: printingHandler_wrap(builtin_tag),
+    group: printingHandler_wrap(builtin_group),
+    groups: printingHandler_wrap(builtin_group),
+    pluginmeta: printingHandler_wrap(builtin_pluginmeta),
+    pluginmetas: printingHandler_wrap(builtin_pluginmeta),
+    meta: printingHandler_wrap(builtin_pluginmeta),
+    metas: printingHandler_wrap(builtin_pluginmeta),
+    plugininstance: printingHandler_wrap(builtin_plugininstance),
+    plugininstances: printingHandler_wrap(builtin_plugininstance),
+    instance: printingHandler_wrap(builtin_plugininstance),
+    instances: printingHandler_wrap(builtin_plugininstance),
+    job: printingHandler_wrap(builtin_plugininstance),
+    jobs: printingHandler_wrap(builtin_plugininstance),
+    workflow: printingHandler_wrap(builtin_workflow),
+    workflows: printingHandler_wrap(builtin_workflow),
+    files: printingHandler_wrap(builtin_files),
+    links: printingHandler_wrap(builtin_links),
+    dirs: printingHandler_wrap(builtin_dirs),
+    context: printingHandler_wrap(builtin_context),
+    parametersofplugin: printingHandler_wrap(builtin_parametersofplugin),
+};
+export const COMMAND_HANDLERS = {
+    connect: builtin_connect,
+    logout: printingBridge_wrap(builtin_logout),
+    cd: envelopeHandler_wrap(builtin_cd),
+    ls: printingBridge_wrap(builtin_ls),
+    pwd: envelopeHandler_wrap(builtin_pwd),
+    cat: envelopeHandler_wrap(builtin_cat),
+    rm: envelopeHandler_wrap(builtin_rm),
+    cp: envelopeHandler_wrap(builtin_cp),
+    mv: envelopeHandler_wrap(builtin_mv),
+    touch: envelopeHandler_wrap(builtin_touch),
+    mkdir: envelopeHandler_wrap(builtin_mkdir),
+    upload: builtin_upload,
+    pacs: builtin_pacs,
+    pipeline: builtin_pipeline,
+    pipelines: builtin_pipeline,
+    pull: builtin_pull,
+    query: printingBridge_wrap(builtin_query),
+    cubepath: printingBridge_wrap(builtin_cubepath),
+    download: builtin_download,
+    edit: builtin_edit,
+    context: printingBridge_wrap(builtin_context),
+    parametersofplugin: printingBridge_wrap(builtin_parametersofplugin),
+    physicalmode: envelopeHandler_wrap(builtin_physicalmode),
+    timing: envelopeHandler_wrap(builtin_timing),
+    whoami: envelopeHandler_wrap(builtin_whoami),
+    whereami: envelopeHandler_wrap(builtin_whereami),
+    debug: envelopeHandler_wrap(builtin_debug),
+    help: printingBridge_wrap(builtin_help),
+    proc: printingBridge_wrap(builtin_proc),
+    tree: printingBridge_wrap(builtin_tree),
+    du: printingBridge_wrap(builtin_du),
+    store: builtin_store,
+    plugin: builtin_plugin,
+    plugins: builtin_plugin,
+    feed: printingBridge_wrap(builtin_feed),
+    feeds: printingBridge_wrap(builtin_feed),
+    compute: printingBridge_wrap(builtin_compute),
+    computes: printingBridge_wrap(builtin_compute),
+    tag: printingBridge_wrap(builtin_tag),
+    tags: printingBridge_wrap(builtin_tag),
+    group: printingBridge_wrap(builtin_group),
+    groups: printingBridge_wrap(builtin_group),
+    pluginmeta: printingBridge_wrap(builtin_pluginmeta),
+    pluginmetas: printingBridge_wrap(builtin_pluginmeta),
+    meta: printingBridge_wrap(builtin_pluginmeta),
+    metas: printingBridge_wrap(builtin_pluginmeta),
+    plugininstance: printingBridge_wrap(builtin_plugininstance),
+    plugininstances: printingBridge_wrap(builtin_plugininstance),
+    instance: printingBridge_wrap(builtin_plugininstance),
+    instances: printingBridge_wrap(builtin_plugininstance),
+    job: printingBridge_wrap(builtin_plugininstance),
+    jobs: printingBridge_wrap(builtin_plugininstance),
+    workflow: printingBridge_wrap(builtin_workflow),
+    workflows: printingBridge_wrap(builtin_workflow),
+    files: printingBridge_wrap(builtin_files),
+    links: printingBridge_wrap(builtin_links),
+    dirs: printingBridge_wrap(builtin_dirs),
+    pacsservers: async (args) => {
+        await chiliCommand_run('pacsservers', ['-s', ...args]);
+    },
+    pacsqueries: async (args) => {
+        await chiliCommand_run('pacsqueries', ['-s', ...args]);
+    },
+    pacsretrieve: async (args) => {
+        await chiliCommand_run('pacsretrieve', ['-s', ...args]);
+    }
+};
+export { COMMAND_HANDLERS_KEYS } from '../command-keys.js';
+/**
+ * Prints elapsed time since startTime if timing is enabled.
+ *
+ * @param startTime - Timestamp from `performance.now()` at command start.
+ * @param enabled - Whether timing display is active.
+ */
+export function command_timingMaybePrint(startTime, enabled) {
+    if (!enabled)
+        return;
+    const elapsed = performance.now() - startTime;
+    console.log(chalk.gray(`[${elapsed.toFixed(2)}ms]`));
+}
+/**
+ * Handles a pipeline name invoked directly as an executable from /bin.
+ * Routes flag combinations to the appropriate pipeline subcommand:
+ *   --nodes / --parameters → pipeline info
+ *   --source / --readme    → pipeline source
+ *   (bare or --compute)    → pipeline run
+ *
+ * @param name - The pipeline name as typed.
+ * @param args - Arguments following the pipeline name.
+ */
+async function pipelineExecutable_handle(name, args) {
+    if (args.includes('--nodes') || args.includes('--parameters')) {
+        await builtin_pipeline(['info', name]);
+    }
+    else if (args.includes('--source') || args.includes('--readme')) {
+        await builtin_pipeline(['source', name]);
+    }
+    else {
+        await builtin_pipeline(['run', name, ...args]);
+    }
+}
+/**
+ * Expands `$NAME` and `${NAME}` environment references in one token.
+ *
+ * Applied per token after parsing, so an expanded value can never inject
+ * command separators, pipes or redirects (the structural characters were
+ * already consumed). References to unset variables are left verbatim —
+ * kinder than the shell's silent empty string when a script forgets an
+ * export. Shell-escape lines (`!...`) never reach this point; bash does
+ * its own expansion there.
+ *
+ * @param token - A single parsed command token.
+ * @returns The token with set environment references substituted.
+ */
+export function envRefs_expand(token) {
+    return token.replace(/\$(?:\{([A-Za-z_][A-Za-z0-9_]*)\}|([A-Za-z_][A-Za-z0-9_]*))/g, (match, braced, bare) => {
+        const value = process.env[braced ?? bare ?? ''];
+        return value !== undefined ? value : match;
+    });
+}
+/**
+ * Reads the current process exit code as a number.
+ *
+ * @returns The exit code, treating an unset code as zero.
+ */
+function exitCode_read() {
+    return typeof process.exitCode === 'number' ? process.exitCode : 0;
+}
+/**
+ * Runs a legacy printing handler uncaptured and derives an envelope from the
+ * exit-code delta.
+ *
+ * This is the passthrough for commands that cannot be captured yet: the
+ * interactive holdouts (their prompts must reach the terminal) and the
+ * progress writers (their live updates must stay live). The handler prints
+ * exactly as it always has; the placeholder envelope records only the
+ * outcome, with no rendered text, so envelope consumers never re-print what
+ * the terminal already showed.
+ *
+ * @param handler - A legacy printing command handler.
+ * @param args - Parsed arguments.
+ * @returns A placeholder envelope carrying the command's outcome.
+ */
+async function handler_runDirect(handler, args) {
+    const exitCodeBefore = exitCode_read();
+    await handler(args);
+    const exitCodeAfter = exitCode_read();
+    const failed = exitCodeAfter !== 0 && exitCodeAfter !== exitCodeBefore;
+    return { status: failed ? 'error' : 'ok', rendered: '' };
+}
+/**
+ * Drains the errorStack from a checkpoint into an envelope's structured
+ * `errors` field, and escalates status to `error` when an error-type message
+ * was drained.
+ *
+ * This is the per-command error boundary: it captures exactly the messages a
+ * command left on the stack, so a remote surface receives full error detail
+ * with each result and stale errors cannot bleed into the next command.
+ * Escalating status from a drained error is a reliable per-command failure
+ * signal, independent of whether the command happened to change
+ * `process.exitCode`.
+ *
+ * @param checkpoint - A checkpoint from `errorStack.checkpoint_mark()`.
+ * @param envelope - The envelope to attach drained errors to.
+ * @returns The same envelope, with errors and possibly status updated.
+ */
+function envelope_drainErrorsInto(checkpoint, envelope) {
+    const drained = errorStack.checkpoint_drain(checkpoint);
+    if (drained.length > 0) {
+        envelope.errors = drained;
+        if (envelope.status === 'ok' && drained.some((message) => message.type === 'error')) {
+            envelope.status = 'error';
+        }
+    }
+    return envelope;
+}
+/**
+ * Dispatches a parsed command to its handler and returns its envelope, with
+ * any errors the command left on the stack drained into the envelope.
+ *
+ * @param command - The command name.
+ * @param args - Parsed arguments.
+ * @returns The envelope of the executed command.
+ */
+export async function command_dispatchEnvelope(command, args) {
+    const checkpoint = errorStack.checkpoint_mark();
+    const envelope = await commandDispatchEnvelope_run(command, args);
+    return envelope_drainErrorsInto(checkpoint, envelope);
+}
+/**
+ * Runs the dispatch itself (without the error drain). Expands environment
+ * references in the arguments, then checks ENVELOPE_HANDLERS, then
+ * unconverted COMMAND_HANDLERS, then /bin plugin/pipeline names, then falls
+ * back to chili through the capture bridge.
+ *
+ * Envelope-speaking handlers are delivered through the active sink here, so
+ * direct execution prints exactly as it always has; unconverted handlers
+ * print for themselves and yield a placeholder envelope.
+ *
+ * @param command - The command name.
+ * @param args - Parsed arguments.
+ * @returns The envelope of the executed command.
+ */
+async function commandDispatchEnvelope_run(command, args) {
+    if (command === 'exit') {
+        process.exit(0);
+    }
+    args = args.map(envRefs_expand);
+    const envelopeHandler = ENVELOPE_HANDLERS[command];
+    if (envelopeHandler) {
+        // A handler that resolves without an envelope (as stubbed handlers in
+        // tests do) is treated as having produced no output.
+        const envelope = await envelopeHandler(args);
+        if (!envelope) {
+            return { status: 'ok', rendered: '' };
+        }
+        envelope_deliver(envelope);
+        return envelope;
+    }
+    const handler = COMMAND_HANDLERS[command];
+    if (handler) {
+        return handler_runDirect(handler, args);
+    }
+    const binResult = await vfs.data_get('/bin');
+    if (binResult.ok) {
+        const pluginItem = binResult.value.find(item => item.name === command && item.type === 'plugin');
+        const pipelineItem = binResult.value.find(item => item.name === command && item.type === 'pipeline');
+        if (pluginItem) {
+            return handler_runDirect((pluginArgs) => builtin_executePlugin(command, pluginArgs), args);
+        }
+        if (pipelineItem) {
+            return handler_runDirect((pipelineArgs) => pipelineExecutable_handle(command, pipelineArgs), args);
+        }
+    }
+    const fallback = printingHandler_wrap(async (fallbackArgs) => {
+        console.log(chalk.yellow(`Unknown chell command '${command}' -- delegating to chili`));
+        await chiliCommand_run(command, ['-s', ...fallbackArgs]);
+    });
+    const envelope = await fallback(args);
+    envelope_deliver(envelope);
+    return envelope;
+}
+/**
+ * Dispatches a parsed command to its handler.
+ *
+ * Compatibility shape over {@link command_dispatchEnvelope} for callers that
+ * do not consume envelopes.
+ *
+ * @param command - The command name.
+ * @param args - Parsed arguments.
+ * @returns A Promise that resolves once the command has been dispatched.
+ */
+export async function command_dispatch(command, args) {
+    await command_dispatchEnvelope(command, args);
+}
+/**
+ * Executes a redirected command (`>` / `>>`): captures the command's output
+ * and writes it to the target file.
+ *
+ * @param redirectInfo - The parsed redirection (command, operator, target).
+ * @returns An envelope recording the outcome; rendered text stays empty
+ *   because the output went to the file, not the terminal.
+ */
+export async function redirect_execute(redirectInfo) {
+    const { buffer } = await chellCommand_executeAndCapture(redirectInfo.command);
+    const targetResult = redirectTarget_resolve(redirectInfo.filePath, redirectInfo.command);
+    if (!targetResult.ok) {
+        const lastError = errorStack.stack_pop();
+        console.error(chalk.red(lastError ? lastError.message : 'Redirect error'));
+        return { status: 'error', rendered: '' };
+    }
+    if (redirectInfo.operator === '>') {
+        writeFileSync(targetResult.value, buffer);
+    }
+    else {
+        appendFileSync(targetResult.value, buffer);
+    }
+    return { status: 'ok', rendered: '' };
+}
+/**
+ * Shows help for a command if `--help` or `-h` is present in args.
+ * Returns Ok(true) if help was displayed, Ok(false) otherwise.
+ *
+ * @param command - The command name (used to look up help text).
+ * @param args - Parsed argument list.
+ */
+function help_showMaybe(command, args) {
+    if (args_checkHasHelpFlag(args, command)) {
+        help_show(command);
+        return Ok(true);
+    }
+    return Ok(false);
+}
+/**
+ * Expands wildcard patterns in args for commands that support it.
+ * Returns Ok(expanded args) or Err if expansion fails.
+ *
+ * @param command - The command name (determines whether expansion applies).
+ * @param args - Raw argument list potentially containing glob patterns.
+ */
+async function wildcards_expand(command, args) {
+    if (!wildcards_expandCheck(command)) {
+        return Ok(args);
+    }
+    const expandResult = await wildcards_expandAll(args);
+    if (!expandResult.ok) {
+        const lastError = errorStack.stack_pop();
+        if (lastError) {
+            console.error(chalk.red(error_stripDebugPrefix(lastError.message)));
+        }
+        return Err();
+    }
+    return Ok(expandResult.value);
+}
+/**
+ * Executes a chell command and captures its output.
+ * Consults COMMAND_HANDLERS — the single source of truth — so the pipe path
+ * is always consistent with the direct-execution path.
+ *
+ * @param commandLine - The command line to execute.
+ * @returns The captured output as text and raw buffer.
+ */
+async function chellCommand_executeAndCapture(commandLine) {
+    const trimmedLine = commandLine.trim();
+    if (!trimmedLine)
+        return { text: '', buffer: Buffer.alloc(0) };
+    const tokens = args_tokenize(trimmedLine);
+    if (tokens.length === 0) {
+        return { text: '', buffer: Buffer.alloc(0) };
+    }
+    let [command, ...args] = tokens;
+    if (wildcards_expandCheck(command)) {
+        const expandResult = await wildcards_expandAll(args);
+        if (!expandResult.ok) {
+            const lastError = errorStack.stack_pop();
+            const errorMsg = lastError ? error_stripDebugPrefix(lastError.message) : 'Unknown error';
+            return { text: chalk.red(`${errorMsg}\n`), buffer: Buffer.from('') };
+        }
+        args = expandResult.value;
+    }
+    if (command === 'exit') {
+        process.exit(0);
+    }
+    // Envelope-speaking commands feed pipes and redirects from their envelope:
+    // rendered text with ANSI stripped (plain pipes, the documented deviation),
+    // error-stream text passed live to stderr exactly as the inherit behavior
+    // always did. Direct stdout writers (binary cat) are still captured; their
+    // bytes precede the envelope's rendered text if a command mixes both.
+    const envelopeHandler = ENVELOPE_HANDLERS[command];
+    if (envelopeHandler) {
+        let envelope;
+        const { buffer: directBuffer } = await output_capture(async () => {
+            envelope = await envelopeHandler(args);
+        });
+        if (!envelope) {
+            return { text: '', buffer: Buffer.alloc(0) };
+        }
+        if (envelope.renderedErr !== undefined && envelope.renderedErr.length > 0) {
+            process.stderr.write(envelope.renderedErr);
+        }
+        const plain = ansi_strip(envelope.rendered);
+        const buffer = Buffer.concat([directBuffer, Buffer.from(plain, 'utf-8')]);
+        return { text: buffer.toString('utf-8'), buffer };
+    }
+    return output_capture(async () => {
+        if (await pluginExecutable_handle(command, args, { piped: true })) {
+            return;
+        }
+        const handler = COMMAND_HANDLERS[command];
+        if (handler) {
+            await handler(args);
+            return;
+        }
+        console.log(chalk.yellow(`Unknown chell command '${command}' -- delegating to chili`));
+        await chiliCommand_run(command, ['-s', ...args]);
+    });
+}
+/**
+ * Executes a pipe chain by running the first command in chell and piping
+ * through local tools, delivering the final output on the data channel.
+ *
+ * @param segments - Array of command segments separated by pipes.
+ * @returns An envelope whose rendered text is the chain's final output.
+ */
+export async function pipe_execute(segments) {
+    if (segments.length === 0) {
+        return { status: 'ok', rendered: '' };
+    }
+    // The first segment is a chell command run in-engine; the rest run through
+    // the surface, so nothing spawns on a daemon host — a surface without the
+    // capability (a browser) fails the pipeline with a clear message.
+    if (segments.length > 1) {
+        capability_require('pipeSegments', 'this surface cannot run pipeline segments');
+    }
+    // Execute first segment in chell and capture output
+    const firstCommand = segments[0];
+    const { buffer } = await chellCommand_executeAndCapture(firstCommand);
+    // Chain remaining segments through the surface's own tools.
+    let currentInput = buffer;
+    for (let i = 1; i < segments.length; i++) {
+        currentInput = await surface_get().pipeSegment(segments[i], currentInput);
+    }
+    // Output final result
+    sink_get().data_write(currentInput);
+    return { status: 'ok', rendered: currentInput.toString('utf-8') };
+}
+/**
+ * Executes one plain command line (no shell escape, batch, redirect or pipe)
+ * and returns its envelope.
+ *
+ * Mirrors the historical direct-execution order exactly: help flag
+ * short-circuit, wildcard expansion, simulated plugin execution, then table
+ * dispatch. Timing is printed at the same points the shell always printed
+ * it (after plugin execution or dispatch; never after help or a wildcard
+ * failure).
+ *
+ * @param trimmedLine - The trimmed command line.
+ * @param startTime - Timing reference from `performance.now()`.
+ * @param timingEnabled - Whether to print elapsed time after execution.
+ * @returns The command's envelope, or null when the line held no tokens.
+ */
+export async function command_executeToEnvelope(trimmedLine, startTime, timingEnabled) {
+    const tokens = args_tokenize(trimmedLine);
+    if (tokens.length === 0)
+        return null;
+    let [command, ...args] = tokens;
+    // Check for --help flag before any processing
+    const helpResult = help_showMaybe(command, args);
+    if (helpResult.ok && helpResult.value) {
+        return { status: 'ok', rendered: '' };
+    }
+    // Expand wildcards for commands that support it
+    const expandResult = await wildcards_expand(command, args);
+    if (!expandResult.ok) {
+        return { status: 'error', rendered: '' };
+    }
+    args = expandResult.value;
+    // Attempt to handle as a simulated plugin execution. This path bypasses
+    // command_dispatchEnvelope, so it drains the errorStack itself.
+    const checkpoint = errorStack.checkpoint_mark();
+    const exitCodeBefore = exitCode_read();
+    if (await pluginExecutable_handle(command, args)) {
+        command_timingMaybePrint(startTime, timingEnabled);
+        const exitCodeAfter = exitCode_read();
+        const failed = exitCodeAfter !== 0 && exitCodeAfter !== exitCodeBefore;
+        return envelope_drainErrorsInto(checkpoint, { status: failed ? 'error' : 'ok', rendered: '' });
+    }
+    const envelope = await command_dispatchEnvelope(command, args);
+    command_timingMaybePrint(startTime, timingEnabled);
+    return envelope;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/core/dispatch.js.map

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