# Execution context
Maligator 0.1.0-alpha.35 ยท Experimental
Source revision: c27b6cae5dcbe612a78ebe5388652738e35f229f
Canonical: https://maligator.ddv.tools/api/process
Read the compile-time command, target, and resolved application configuration. No surface flag is required. Runtime arguments, environment, working directory, and PID are separate process values.
Import from `maligator:process`. This API is experimental. Load declarations as described in [Use TypeScript](/guides/typescript). Platform imports do not require a surface flag.
`execution` is a deeply immutable snapshot of the command and resolved configuration used to compile the application. It is not the launched process's current arguments, environment, working directory, or PID. Use supported Node process APIs for runtime values.
```typescript context.ts
import { execution } from "maligator:process";
console.log(execution.command);
console.log(execution.production);
console.log(execution.config.engine.regexp);
```
Run `maligator run context.ts` to observe `run`, `false`, and the configured RegExp policy. `build --production` records production intent; profiling uses production optimizations without changing the original command's intent. Snapshot values remain fixed when a built executable is launched with different arguments or environment variables.
See [CLI options](/api/cli) for the commands that populate the snapshot and [production builds](/guides/production) for the difference between build-time and runtime settings.
## execution
An immutable snapshot of the workflow, target, and resolved configuration, fixed before compilation. Known property reads can specialize application branches. Runtime arguments, environment, working directory, and PID are outside this snapshot. Profiling does not change production intent. Static and dynamic imports share its identity, and reflection sees the complete deeply frozen shape.
```typescript
export const execution: Execution;
```
Types: [`Execution`](/api/process#Execution)
```typescript
import { execution } from "maligator:process";
if (execution.compiled && execution.production) {
console.log("native production application");
}
```
```typescript
import { execution } from "maligator:process";
if (execution.command === "test") {
console.log(execution.options.repeat);
}
```
## ExecutionProfile
Profiling instrumentation: none by default; sampling for --profile; compiler for --profile=compiler. Both profiling modes select full optimization without selecting production application behavior.
```typescript
type ExecutionProfile = "none" | "sampling" | "compiler";
```
## ExecutionTarget
The fixed platform contract of the application image.
Full TypeScript declaration
```typescript
type ExecutionTarget = {
/**
* Application operating-system target, not the compiler host. Native builds use
* darwin or linux; WebAssembly uses wasi.
*/
readonly platform: "darwin" | "linux" | "wasi";
/**
* Application architecture. Cross builds report the destination architecture.
*/
readonly arch: "arm64" | "x64" | "wasm32";
/**
* Resolved target triple, including when --target was omitted; for example
* aarch64-apple-darwin.
*/
readonly triple: string;
};
```
Full TypeScript declaration
```typescript
type ExecutionOptions = {
/**
* Selected application profiling instrumentation. Defaults to none; does not imply
* execution.production.
*/
readonly profile: ExecutionProfile;
};
```
Types: [`ExecutionProfile`](/api/process#ExecutionProfile)
Full TypeScript declaration
```typescript
type TestExecutionOptions = {
/**
* Selected test profiling instrumentation. Defaults to none; profiling preserves
* command: test.
*/
readonly profile: ExecutionProfile;
/**
* Hierarchical test-name filter from --run, or null when all discovered names are
* eligible.
*/
readonly nameFilter: string | null;
/**
* Number of requested test repetitions from --repeat; defaults to 1. This is not the
* currently executing repetition.
*/
readonly repeat: number;
/**
* Whether --bail stops the test run after its first failure. Defaults to false.
*/
readonly bail: boolean;
/**
* Test callback timeout in milliseconds from --timeout. Defaults to 5000.
*/
readonly timeoutMs: number;
/**
* Resolved positive shuffle seed, or null when shuffling is disabled. --shuffle
* without a seed chooses it once before compilation; the same seed drives execution
* and cache identity.
*/
readonly shuffleSeed: number | null;
};
```
Types: [`ExecutionProfile`](/api/process#ExecutionProfile)
Full TypeScript declaration
```typescript
type ExecutionEngineConfig = {
/**
* Requested primordial mutation policy. Defaults to locked. The execution snapshot
* itself is immutable in either policy.
*/
readonly primordials: "locked" | "mutable";
/**
* Dynamic compilation policy. false (default) rejects eval/Function execution at
* runtime; true enables the runtime compiler; compile-check additionally rejects
* statically visible dynamic compilation calls.
*/
readonly eval: boolean | "compile-check";
/**
* Whether additional realms are enabled. Defaults to false.
*/
readonly realms: boolean;
/**
* Whether regular expressions are enabled. Defaults to true.
*/
readonly regexp: boolean;
/**
* Whether Temporal and its required data are enabled. Defaults to false.
*/
readonly temporal: boolean;
/**
* Requested Intl policy after applying configuration defaults.
*/
readonly intl: {
/**
* Whether Intl is enabled. Defaults to false.
*/
readonly enabled: boolean;
/**
* Requested Intl service names. An empty array selects the default complete service
* set when Intl is enabled; it does not mean every service survived tree shaking.
*/
readonly features: ReadonlyArray;
/**
* Requested locale selection. Defaults to an empty array. Unsupported locale
* selections are rejected by configuration validation.
*/
readonly languages: ReadonlyArray;
};
};
```
Full TypeScript declaration
```typescript
readonly intl: {
/**
* Whether Intl is enabled. Defaults to false.
*/
readonly enabled: boolean;
/**
* Requested Intl service names. An empty array selects the default complete service
* set when Intl is enabled; it does not mean every service survived tree shaking.
*/
readonly features: ReadonlyArray;
/**
* Requested locale selection. Defaults to an empty array. Unsupported locale
* selections are rejected by configuration validation.
*/
readonly languages: ReadonlyArray;
};
```
Full TypeScript declaration
```typescript
type ExecutionConfig = {
/**
* Engine configuration after validation and default resolution.
*/
readonly engine: ExecutionEngineConfig;
/**
* Global and compatibility surface policy. maligator:process requires no enable
* flag.
*/
readonly surface: {
/**
* Whether Web globals are requested. Defaults to false; native module imports are
* independent of this global installation policy.
*/
readonly webPlatform: boolean;
/**
* Whether Node compatibility, globals, and node: module resolution are requested.
* Defaults to false.
*/
readonly node: boolean;
};
/**
* Resolved module-resolution policy.
*/
readonly modules: {
/**
* Exact module-specifier replacements from configuration. Defaults to an empty
* object. Alias entries are immutable own data properties.
*/
readonly aliases: Readonly>;
};
};
```
Types: [`ExecutionEngineConfig`](/api/process#ExecutionEngineConfig)
Full TypeScript declaration
```typescript
readonly surface: {
/**
* Whether Web globals are requested. Defaults to false; native module imports are
* independent of this global installation policy.
*/
readonly webPlatform: boolean;
/**
* Whether Node compatibility, globals, and node: module resolution are requested.
* Defaults to false.
*/
readonly node: boolean;
};
```
Full TypeScript declaration
```typescript
readonly modules: {
/**
* Exact module-specifier replacements from configuration. Defaults to an empty
* object. Alias entries are immutable own data properties.
*/
readonly aliases: Readonly>;
};
```
Full TypeScript declaration
```typescript
type ExecutionCommon = {
/**
* Explicit production application intent. True only when production was selected for
* the application; independent of NODE_ENV, profiling, and optimization. Currently
* --production is a build option. Defaults to false.
*/
readonly production: boolean;
/**
* Whether the application image executes as native compiled code. A native
* executable hosting an interpreted image reports false. This is fixed for the
* image, not a query about the current stack frame or an eval-created function.
*/
readonly compiled: boolean;
/**
* Actual selected frontend optimization policy. Ordinary commands currently use
* development; production builds and profiling use full. Backend choice is
* independent.
*/
readonly optimization: "development" | "full";
/**
* Resolved application target. The compiler's host platform is not substituted
* during a cross build.
*/
readonly target: ExecutionTarget;
/**
* Validated configuration policies with defaults applied, captured before
* compilation.
*/
readonly config: ExecutionConfig;
};
```
Types: [`ExecutionTarget`](/api/process#ExecutionTarget), [`ExecutionConfig`](/api/process#ExecutionConfig)