Function command_executeToEnvelope

command_executeToEnvelope(
    trimmedLine: string,
    startTime: number,
    timingEnabled: boolean,
): Promise<
    | {
        errors?: { message: string; type: "error"
        | "warning" }[];
        model?: { data: unknown; kind: string };
        rendered: string;
        renderedErr?: string;
        status: "error" | "ok";
        trace?: {
            executed?: string;
            input: string;
            proposed: string;
            validated: boolean;
        };
    }
    | null,
>
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).
Parameters
- trimmedLine: string
  The trimmed command line.
- startTime: number
  Timing reference from performance.now().
- timingEnabled: boolean
  Whether to print elapsed time after execution.
Returns Promise<
    | {
        errors?: { message: string; type: "error"
        | "warning" }[];
        model?: { data: unknown; kind: string };
        rendered: string;
        renderedErr?: string;
        status: "error" | "ok";
        trace?: {
            executed?: string;
            input: string;
            proposed: string;
            validated: boolean;
        };
    }
    | null,
>
The command's envelope, or null when the line held no tokens.
- Defined in packages/brasa/src/core/dispatch.ts:535

Function command_executeToEnvelope

Parameters

Returns Promise< | { errors?: { message: string; type: "error" | "warning" }[]; model?: { data: unknown; kind: string }; rendered: string; renderedErr?: string; status: "error" | "ok"; trace?: { executed?: string; input: string; proposed: string; validated: boolean; }; } | null,>

Settings

Returns Promise<
| {
errors?: { message: string; type: "error"
| "warning" }[];
model?: { data: unknown; kind: string };
rendered: string;
renderedErr?: string;
status: "error" | "ok";
trace?: {
executed?: string;
input: string;
proposed: string;
validated: boolean;
};
}
| null,
>