@orkestrel/probe 0.0.20 → 0.0.21

package/dist/src/server/index.d.cts

@@ -5,6 +5,8 @@ import type { EmitterInterface } from '@orkestrel/emitter';
 import type { EventEmitter } from 'node:events';
 import type { Issue } from '@orkestrel/probe';
 import type { LSPRange } from '@orkestrel/lsp';
+import { MCPError } from '@orkestrel/mcp';
+import type { ProbeError } from '@orkestrel/probe';
 import type { ProbeEventMap } from '@orkestrel/probe';
 import type { ProbeInterface } from '@orkestrel/probe';
 import type { ProbeOptions } from '@orkestrel/probe';
@@ -89,6 +91,19 @@ export declare function collectWorkspaceFiles(workspace: string): readonly strin
  */
 export declare function computeDigest(workspace: string, value: unknown): string;
 
+/**
+ * Creates the protocol failure returned when the MCP handshake cannot arm the probe.
+ *
+ * @param error - The classified probe failure that ended initialization
+ * @returns An MCP server error carrying the probe failure's origin and code as protocol data
+ *
+ * @example
+ * ```ts
+ * createHandshakeError(createDestroyedError('probe server')).code // -32000
+ * ```
+ */
+export declare function createHandshakeError(error: ProbeError): MCPError;
+
 /**
  * Normalizes a caught or foreign error into readable text.
  *
@@ -381,7 +396,7 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
  * Inspects virtual documents through one resident Oxlint language server.
  *
  * @remarks
- * Construction starts the target workspace's Oxlint binary with its Language Server Protocol mode
+ * Starting launches the target workspace's Oxlint binary with its Language Server Protocol mode
  * and hands the conversation to `@orkestrel/lsp`: `createStdioClientTransport` owns the child
  * process and its bytes, and `createLSPClient` owns the framing, the request correlation, the
  * capabilities this stage advertises, and the choice between pulled and pushed diagnostics. This
@@ -417,13 +432,15 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
 export declare class LintStage implements LintStageInterface {
     #private;
     /**
-     * Starts warming the target workspace's Oxlint language server.
+     * Records the target workspace without starting its language server.
      *
      * @param workspace - The target workspace root. Default: the current working directory
      */
     constructor(workspace?: string);
     get stage(): Stage;
     get progress(): number;
+    get exit(): Promise<never>;
+    start(): Promise<void>;
     inspect(subject: Case, options?: InspectionOptions): Promise<Check>;
     destroy(): Promise<void>;
 }
@@ -448,6 +465,8 @@ export declare class LintStage implements LintStageInterface {
  * ```
  */
 export declare interface LintStageInterface extends StageInterface {
+    /** Rejects with the instrument fault on an exit before teardown; never fulfills. */
+    readonly exit: Promise<never>;
     /**
      * Inspects one case, under the bound the caller supplies.
      *
@@ -824,9 +843,10 @@ export declare function parseRevisionOwner(revision: string): number | undefined
  * Answers claims through its type, lint, and runtime stages.
  *
  * @remarks
- * Construction resolves the target workspace's toolchain and begins warming every stage. The boot
+ * Construction resolves the target workspace's toolchain. Starting warms every stage and waits
+ * for lint and runtime; type warming and the boot controls continue behind that gate. The boot
  * controls mutate imported dependencies and refuse service unless the type and runtime stages
- * report their respective changes. One queue per stage admits inspections in arrival order, one at
+ * report their respective changes. One pool per stage admits inspections in arrival order, one at
  * a time, so a stage never serves two claims at once and the deadline covers active work rather
  * than queue wait. Each active stage inspection has a coordinator-owned deadline. An expiry at any
  * stage abandons that stage and replaces it before the next queued inspection begins, so one slow
@@ -871,33 +891,35 @@ export declare function parseRevisionOwner(revision: string): number | undefined
  * const probe = new Probe({ workspace: process.cwd() })
  * const verdict = await probe.prove(claim)
  * verdict.digest // 'bdf03e5dfd6bd413ead671c7a2940fcf'
- * verdict.receipt // 'probe:bdf03e5dfd6bd413ead671c7a2940fcf:type:typescript@6.0.3:oxlint@1.86.0:vitest@4.1.11:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
+ * verdict.receipt // 'probe:bdf03e5dfd6bd413ead671c7a2940fcf:type:typescript@6.0.3:oxlint@1.87.0:vitest@4.1.11:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
  * await probe.destroy()
  * ```
  */
 export declare class Probe implements ProbeInterface {
     #private;
     /**
-     * Resolves the target toolchain and starts warming every stage.
+     * Resolves the target toolchain and constructs the stage pools without warming them.
      *
-     * @param options - Workspace, deadline, and initial observation hooks
+     * @param options - Workspace, inspection and warm bounds, and initial observation hooks
      */
     constructor(options?: ProbeOptions);
     get emitter(): EmitterInterface<ProbeEventMap>;
     get toolchain(): Toolchain;
     prove(claim: Claim): Promise<Verdict>;
     destroy(): Promise<void>;
+    start(): Promise<void>;
 }
 
 /**
  * Implements `ProbeServerInterface` over a `PassThrough` stream this server owns, binding the
  * published `prove` tool and the dual-era dispatcher to this process's Model Context Protocol
- * stdio transport.
+ * stdio transport. Starting creates the probe and awaits its lint and runtime onset; type warming
+ * and the boot controls continue behind it.
  *
  * @remarks
  * Construction snapshots the probe options, publishes the `prove` tool, and binds the dual-era
- * dispatcher to the stdio transport. An admitted `prove` call creates the probe and begins
- * workspace arming, so discovery does not depend on the workspace toolchain. Construction is held
+ * dispatcher to the stdio transport.
+ * Discovery remains available while the legacy handshake awaits that onset. Construction is held
  * before it begins, so teardown entered through a construction callback waits for the resulting
  * probe and releases it. A constructor refusal clears that held operation for a later retry.
  *
@@ -907,7 +929,8 @@ export declare class Probe implements ProbeInterface {
  * serving is still attached and still fires afterwards. The transport reads a stream this server
  * owns rather than this process's standard input, which is what makes that possible: the
  * transport's own listeners land on that stream, and the only listeners this server ever puts on
- * `process.stdin` are the `data`, `close`, and `error` forwarders into it. `destroy` pauses the
+ * `process.stdin` are the `data`, `close`, and `error` forwarders and the input-end teardown.
+ * `destroy` pauses the
  * stream only when this server is what set it flowing and nothing else is reading it, so a process
  * that outlives this server reads its own standard input again and receives its own signals.
  * Teardown removes the signal handlers first: it takes seconds when a boot is in flight, and a
@@ -916,7 +939,7 @@ export declare class Probe implements ProbeInterface {
  * @example
  * ```ts
  * const server = new ProbeServer({ workspace: process.cwd() })
- * server.start()
+ * await server.start()
  * await server.destroy()
  * ```
  */
@@ -924,12 +947,12 @@ export declare class ProbeServer implements ProbeServerInterface {
     #private;
     /**
      * Snapshots the probe options this server will use and binds the published schema to this
-     * process's stdio transport. An admitted `prove` call creates the probe.
+     * process's stdio transport without warming the workspace.
      *
-     * @param options - Workspace, deadline, and initial observation hooks for the deferred probe
+     * @param options - Workspace, deadline, and initial observation hooks for the probe
      */
     constructor(options?: ProbeOptions);
-    start(): void;
+    start(): Promise<void>;
     destroy(): Promise<void>;
 }
 
@@ -938,43 +961,45 @@ export declare class ProbeServer implements ProbeServerInterface {
  *
  * @remarks
  * Construction snapshots the options and resolves the workspace against the current working
- * directory without loading its toolchain. Discovery can therefore answer before an admitted
- * `prove` call creates the real probe and starts arming. Invalid claims do not create it.
+ * directory without loading its toolchain. Starting creates the probe and awaits its lint and
+ * runtime onset; type warming and the boot controls continue behind it.
+ * Discovery answers during onset; legacy initialization waits for that onset's settlement.
  *
  * The server owns the process it runs in. `start` seizes standard input and standard output for
  * the transport and registers the termination handlers a harness signals, so a host that starts one
  * has already given the process to it. `destroy` reverses all of that and tears the probe down with
- * it when an admitted call created it. When teardown begins during admitted construction, it waits
- * for that construction and releases the resulting probe before it settles. Destruction before
- * admission loads no workspace tools, which is why there is no verb that stops serving and leaves
+ * it. When teardown begins during construction, it waits for that construction and releases the
+ * resulting probe before it settles. Destruction before starting loads no workspace tools,
+ * which is why there is no verb that stops serving and leaves
  * the stages standing: a probe nothing is reading from holds its tools and its mirror for nobody.
  *
  * @example
  * ```ts
  * const server = new ProbeServer({ workspace: process.cwd() })
- * server.start()
+ * await server.start()
  * await server.destroy()
  * ```
  */
 export declare interface ProbeServerInterface {
     /**
-     * Serves the probe over this process's standard input and output.
+     * Begins serving and awaits the workspace probe's lint and runtime onset.
      *
      * @remarks
      * Reads newline-delimited JSON requests from standard input, and answers a `SIGINT` or a
-     * `SIGTERM` by destroying the server. Calling this on a server already serving does nothing.
-     * Calling it after teardown begins throws a claimant-owned `destroyed` failure.
+     * `SIGTERM` or input end by destroying the server. Repeated calls join the same setup promise.
+     * A refused onset keeps discovery serving and permits a later tool call to retry the probe.
+     * Teardown during setup is absorbed; calling after teardown rejects with `destroyed`.
      *
-     * @returns Nothing
-     * @throws When this call comes after teardown begins
+     * @returns The shared setup promise
+     * @throws A workspace onset refusal, or `destroyed` after teardown begins
      *
      * @example
      * ```ts
      * const server = new ProbeServer({ workspace: process.cwd() })
-     * server.start()
+     * await server.start()
      * ```
      */
-    start(): void;
+    start(): Promise<void>;
     /**
      * Releases the transport, the process listeners, and the probe behind them.
      *
@@ -1222,7 +1247,7 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
  * Inspects tests through one resident Vitest service from the target workspace.
  *
  * @remarks
- * Construction starts Vitest with the threads pool and instruments each inline or function-declared
+ * Starting launches Vitest with the threads pool and instruments each inline or function-declared
  * project with a Vite plugin that reads the active inspection's candidate overlay. A selected
  * string-declared project reports a workspace issue because its configuration carries no runtime
  * overlay plugin. Every inspection writes one fresh sibling specification, invalidates each
@@ -1281,16 +1306,20 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
 export declare class RuntimeStage implements StageInterface {
     #private;
     /**
-     * Starts warming the target workspace's Vitest service.
-     *
-     * @remarks Loading starts during this call. A loader refusal rejects the owned warm operation
-     * rather than construction, so `inspect` reports it and `destroy` remains available.
+     * Records the target workspace without loading its Vitest service.
      *
      * @param workspace - The target workspace root. Default: the current working directory
      */
     constructor(workspace?: string);
     get stage(): Stage;
     get progress(): number;
+    /**
+     * Begins the warm or joins the warm already begun.
+     *
+     * @returns A promise that resolves after the resident Vitest service is ready
+     * @throws When warming fails or teardown has begun
+     */
+    start(): Promise<void>;
     /**
      * Inspects one case.
      *
@@ -1347,10 +1376,10 @@ export declare function scanDiagnostics(text: string): readonly Diagnostic[];
  * Inspects one case with the workspace's own tool.
  *
  * @remarks
- * Warming begins at construction. The `inspect` method awaits that one warm operation, which
+ * Warming begins at `start()`. The `inspect` method calls it and awaits the warm operation, which
  * builds the resident tool or the mirror it reuses across calls. A stage serves one inspection at
  * a time and admits none itself. Await an inspection before starting the next one, or admit
- * through one queue per stage the way `Probe` does: a second concurrent call reaches the same
+ * through the coordinator's admission: a second concurrent call reaches the same
  * resident tool or mirror and the same overlay, document, and specification state the first is
  * still using. A stage never holds a later inspection behind an earlier one, so a caller that
  * abandons an inspection at its own deadline can still use the stage. The `destroy` method
@@ -1377,6 +1406,13 @@ export declare interface StageInterface {
      * instrument rather than to the claimant.
      */
     readonly progress: number;
+    /**
+     * Begins the warm or joins the warm already begun.
+     *
+     * @returns A promise that resolves after the resident tool or mirror is ready
+     * @throws When warming fails or teardown has begun
+     */
+    start(): Promise<void>;
     /**
      * Inspects one case.
      *
@@ -1412,7 +1448,7 @@ export declare interface StageInterface {
  *
  * @remarks
  * The compiler is a process this stage spawns rather than a module it loads, so nothing here holds
- * a resident program and the host's event loop is free for the whole check. Construction sweeps a
+ * a resident program and the host's event loop is free for the whole check. Starting sweeps a
  * mirror an earlier host left behind, copies the workspace into a fresh one under
  * {@link TYPE_MIRROR}, and builds each declared project's incremental state there, so the first
  * inspection is warm.
@@ -1445,13 +1481,14 @@ export declare interface StageInterface {
 export declare class TypeStage implements TypeStageInterface {
     #private;
     /**
-     * Resolves the target workspace's compiler and starts warming its mirror.
+     * Records the workspace and the mirror path without starting its compiler.
      *
      * @param workspace - The target workspace root. Default: the current working directory
      */
     constructor(workspace?: string);
     get stage(): Stage;
     get progress(): number;
+    start(): Promise<void>;
     /**
      * Inspects one case, against a caller-named project where the caller names one.
      *
@@ -1520,6 +1557,7 @@ export declare interface TypeStageInterface extends StageInterface {
     inspect(subject: Case, project?: string): Promise<Check>;
     /**
      * Resolves one project to the path and digest the stage applies for it.
+     * Calls `start()` before reading the project.
      *
      * @param project - The workspace-relative TypeScript project to resolve
      * @returns The resolved workspace-relative path and the digest of its compiler options

package/dist/src/server/index.d.ts

@@ -5,6 +5,8 @@ import type { EmitterInterface } from '@orkestrel/emitter';
 import type { EventEmitter } from 'node:events';
 import type { Issue } from '@orkestrel/probe';
 import type { LSPRange } from '@orkestrel/lsp';
+import { MCPError } from '@orkestrel/mcp';
+import type { ProbeError } from '@orkestrel/probe';
 import type { ProbeEventMap } from '@orkestrel/probe';
 import type { ProbeInterface } from '@orkestrel/probe';
 import type { ProbeOptions } from '@orkestrel/probe';
@@ -89,6 +91,19 @@ export declare function collectWorkspaceFiles(workspace: string): readonly strin
  */
 export declare function computeDigest(workspace: string, value: unknown): string;
 
+/**
+ * Creates the protocol failure returned when the MCP handshake cannot arm the probe.
+ *
+ * @param error - The classified probe failure that ended initialization
+ * @returns An MCP server error carrying the probe failure's origin and code as protocol data
+ *
+ * @example
+ * ```ts
+ * createHandshakeError(createDestroyedError('probe server')).code // -32000
+ * ```
+ */
+export declare function createHandshakeError(error: ProbeError): MCPError;
+
 /**
  * Normalizes a caught or foreign error into readable text.
  *
@@ -381,7 +396,7 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
  * Inspects virtual documents through one resident Oxlint language server.
  *
  * @remarks
- * Construction starts the target workspace's Oxlint binary with its Language Server Protocol mode
+ * Starting launches the target workspace's Oxlint binary with its Language Server Protocol mode
  * and hands the conversation to `@orkestrel/lsp`: `createStdioClientTransport` owns the child
  * process and its bytes, and `createLSPClient` owns the framing, the request correlation, the
  * capabilities this stage advertises, and the choice between pulled and pushed diagnostics. This
@@ -417,13 +432,15 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
 export declare class LintStage implements LintStageInterface {
     #private;
     /**
-     * Starts warming the target workspace's Oxlint language server.
+     * Records the target workspace without starting its language server.
      *
      * @param workspace - The target workspace root. Default: the current working directory
      */
     constructor(workspace?: string);
     get stage(): Stage;
     get progress(): number;
+    get exit(): Promise<never>;
+    start(): Promise<void>;
     inspect(subject: Case, options?: InspectionOptions): Promise<Check>;
     destroy(): Promise<void>;
 }
@@ -448,6 +465,8 @@ export declare class LintStage implements LintStageInterface {
  * ```
  */
 export declare interface LintStageInterface extends StageInterface {
+    /** Rejects with the instrument fault on an exit before teardown; never fulfills. */
+    readonly exit: Promise<never>;
     /**
      * Inspects one case, under the bound the caller supplies.
      *
@@ -824,9 +843,10 @@ export declare function parseRevisionOwner(revision: string): number | undefined
  * Answers claims through its type, lint, and runtime stages.
  *
  * @remarks
- * Construction resolves the target workspace's toolchain and begins warming every stage. The boot
+ * Construction resolves the target workspace's toolchain. Starting warms every stage and waits
+ * for lint and runtime; type warming and the boot controls continue behind that gate. The boot
  * controls mutate imported dependencies and refuse service unless the type and runtime stages
- * report their respective changes. One queue per stage admits inspections in arrival order, one at
+ * report their respective changes. One pool per stage admits inspections in arrival order, one at
  * a time, so a stage never serves two claims at once and the deadline covers active work rather
  * than queue wait. Each active stage inspection has a coordinator-owned deadline. An expiry at any
  * stage abandons that stage and replaces it before the next queued inspection begins, so one slow
@@ -871,33 +891,35 @@ export declare function parseRevisionOwner(revision: string): number | undefined
  * const probe = new Probe({ workspace: process.cwd() })
  * const verdict = await probe.prove(claim)
  * verdict.digest // 'bdf03e5dfd6bd413ead671c7a2940fcf'
- * verdict.receipt // 'probe:bdf03e5dfd6bd413ead671c7a2940fcf:type:typescript@6.0.3:oxlint@1.86.0:vitest@4.1.11:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
+ * verdict.receipt // 'probe:bdf03e5dfd6bd413ead671c7a2940fcf:type:typescript@6.0.3:oxlint@1.87.0:vitest@4.1.11:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
  * await probe.destroy()
  * ```
  */
 export declare class Probe implements ProbeInterface {
     #private;
     /**
-     * Resolves the target toolchain and starts warming every stage.
+     * Resolves the target toolchain and constructs the stage pools without warming them.
      *
-     * @param options - Workspace, deadline, and initial observation hooks
+     * @param options - Workspace, inspection and warm bounds, and initial observation hooks
      */
     constructor(options?: ProbeOptions);
     get emitter(): EmitterInterface<ProbeEventMap>;
     get toolchain(): Toolchain;
     prove(claim: Claim): Promise<Verdict>;
     destroy(): Promise<void>;
+    start(): Promise<void>;
 }
 
 /**
  * Implements `ProbeServerInterface` over a `PassThrough` stream this server owns, binding the
  * published `prove` tool and the dual-era dispatcher to this process's Model Context Protocol
- * stdio transport.
+ * stdio transport. Starting creates the probe and awaits its lint and runtime onset; type warming
+ * and the boot controls continue behind it.
  *
  * @remarks
  * Construction snapshots the probe options, publishes the `prove` tool, and binds the dual-era
- * dispatcher to the stdio transport. An admitted `prove` call creates the probe and begins
- * workspace arming, so discovery does not depend on the workspace toolchain. Construction is held
+ * dispatcher to the stdio transport.
+ * Discovery remains available while the legacy handshake awaits that onset. Construction is held
  * before it begins, so teardown entered through a construction callback waits for the resulting
  * probe and releases it. A constructor refusal clears that held operation for a later retry.
  *
@@ -907,7 +929,8 @@ export declare class Probe implements ProbeInterface {
  * serving is still attached and still fires afterwards. The transport reads a stream this server
  * owns rather than this process's standard input, which is what makes that possible: the
  * transport's own listeners land on that stream, and the only listeners this server ever puts on
- * `process.stdin` are the `data`, `close`, and `error` forwarders into it. `destroy` pauses the
+ * `process.stdin` are the `data`, `close`, and `error` forwarders and the input-end teardown.
+ * `destroy` pauses the
  * stream only when this server is what set it flowing and nothing else is reading it, so a process
  * that outlives this server reads its own standard input again and receives its own signals.
  * Teardown removes the signal handlers first: it takes seconds when a boot is in flight, and a
@@ -916,7 +939,7 @@ export declare class Probe implements ProbeInterface {
  * @example
  * ```ts
  * const server = new ProbeServer({ workspace: process.cwd() })
- * server.start()
+ * await server.start()
  * await server.destroy()
  * ```
  */
@@ -924,12 +947,12 @@ export declare class ProbeServer implements ProbeServerInterface {
     #private;
     /**
      * Snapshots the probe options this server will use and binds the published schema to this
-     * process's stdio transport. An admitted `prove` call creates the probe.
+     * process's stdio transport without warming the workspace.
      *
-     * @param options - Workspace, deadline, and initial observation hooks for the deferred probe
+     * @param options - Workspace, deadline, and initial observation hooks for the probe
      */
     constructor(options?: ProbeOptions);
-    start(): void;
+    start(): Promise<void>;
     destroy(): Promise<void>;
 }
 
@@ -938,43 +961,45 @@ export declare class ProbeServer implements ProbeServerInterface {
  *
  * @remarks
  * Construction snapshots the options and resolves the workspace against the current working
- * directory without loading its toolchain. Discovery can therefore answer before an admitted
- * `prove` call creates the real probe and starts arming. Invalid claims do not create it.
+ * directory without loading its toolchain. Starting creates the probe and awaits its lint and
+ * runtime onset; type warming and the boot controls continue behind it.
+ * Discovery answers during onset; legacy initialization waits for that onset's settlement.
  *
  * The server owns the process it runs in. `start` seizes standard input and standard output for
  * the transport and registers the termination handlers a harness signals, so a host that starts one
  * has already given the process to it. `destroy` reverses all of that and tears the probe down with
- * it when an admitted call created it. When teardown begins during admitted construction, it waits
- * for that construction and releases the resulting probe before it settles. Destruction before
- * admission loads no workspace tools, which is why there is no verb that stops serving and leaves
+ * it. When teardown begins during construction, it waits for that construction and releases the
+ * resulting probe before it settles. Destruction before starting loads no workspace tools,
+ * which is why there is no verb that stops serving and leaves
  * the stages standing: a probe nothing is reading from holds its tools and its mirror for nobody.
  *
  * @example
  * ```ts
  * const server = new ProbeServer({ workspace: process.cwd() })
- * server.start()
+ * await server.start()
  * await server.destroy()
  * ```
  */
 export declare interface ProbeServerInterface {
     /**
-     * Serves the probe over this process's standard input and output.
+     * Begins serving and awaits the workspace probe's lint and runtime onset.
      *
      * @remarks
      * Reads newline-delimited JSON requests from standard input, and answers a `SIGINT` or a
-     * `SIGTERM` by destroying the server. Calling this on a server already serving does nothing.
-     * Calling it after teardown begins throws a claimant-owned `destroyed` failure.
+     * `SIGTERM` or input end by destroying the server. Repeated calls join the same setup promise.
+     * A refused onset keeps discovery serving and permits a later tool call to retry the probe.
+     * Teardown during setup is absorbed; calling after teardown rejects with `destroyed`.
      *
-     * @returns Nothing
-     * @throws When this call comes after teardown begins
+     * @returns The shared setup promise
+     * @throws A workspace onset refusal, or `destroyed` after teardown begins
      *
      * @example
      * ```ts
      * const server = new ProbeServer({ workspace: process.cwd() })
-     * server.start()
+     * await server.start()
      * ```
      */
-    start(): void;
+    start(): Promise<void>;
     /**
      * Releases the transport, the process listeners, and the probe behind them.
      *
@@ -1222,7 +1247,7 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
  * Inspects tests through one resident Vitest service from the target workspace.
  *
  * @remarks
- * Construction starts Vitest with the threads pool and instruments each inline or function-declared
+ * Starting launches Vitest with the threads pool and instruments each inline or function-declared
  * project with a Vite plugin that reads the active inspection's candidate overlay. A selected
  * string-declared project reports a workspace issue because its configuration carries no runtime
  * overlay plugin. Every inspection writes one fresh sibling specification, invalidates each
@@ -1281,16 +1306,20 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
 export declare class RuntimeStage implements StageInterface {
     #private;
     /**
-     * Starts warming the target workspace's Vitest service.
-     *
-     * @remarks Loading starts during this call. A loader refusal rejects the owned warm operation
-     * rather than construction, so `inspect` reports it and `destroy` remains available.
+     * Records the target workspace without loading its Vitest service.
      *
      * @param workspace - The target workspace root. Default: the current working directory
      */
     constructor(workspace?: string);
     get stage(): Stage;
     get progress(): number;
+    /**
+     * Begins the warm or joins the warm already begun.
+     *
+     * @returns A promise that resolves after the resident Vitest service is ready
+     * @throws When warming fails or teardown has begun
+     */
+    start(): Promise<void>;
     /**
      * Inspects one case.
      *
@@ -1347,10 +1376,10 @@ export declare function scanDiagnostics(text: string): readonly Diagnostic[];
  * Inspects one case with the workspace's own tool.
  *
  * @remarks
- * Warming begins at construction. The `inspect` method awaits that one warm operation, which
+ * Warming begins at `start()`. The `inspect` method calls it and awaits the warm operation, which
  * builds the resident tool or the mirror it reuses across calls. A stage serves one inspection at
  * a time and admits none itself. Await an inspection before starting the next one, or admit
- * through one queue per stage the way `Probe` does: a second concurrent call reaches the same
+ * through the coordinator's admission: a second concurrent call reaches the same
  * resident tool or mirror and the same overlay, document, and specification state the first is
  * still using. A stage never holds a later inspection behind an earlier one, so a caller that
  * abandons an inspection at its own deadline can still use the stage. The `destroy` method
@@ -1377,6 +1406,13 @@ export declare interface StageInterface {
      * instrument rather than to the claimant.
      */
     readonly progress: number;
+    /**
+     * Begins the warm or joins the warm already begun.
+     *
+     * @returns A promise that resolves after the resident tool or mirror is ready
+     * @throws When warming fails or teardown has begun
+     */
+    start(): Promise<void>;
     /**
      * Inspects one case.
      *
@@ -1412,7 +1448,7 @@ export declare interface StageInterface {
  *
  * @remarks
  * The compiler is a process this stage spawns rather than a module it loads, so nothing here holds
- * a resident program and the host's event loop is free for the whole check. Construction sweeps a
+ * a resident program and the host's event loop is free for the whole check. Starting sweeps a
  * mirror an earlier host left behind, copies the workspace into a fresh one under
  * {@link TYPE_MIRROR}, and builds each declared project's incremental state there, so the first
  * inspection is warm.
@@ -1445,13 +1481,14 @@ export declare interface StageInterface {
 export declare class TypeStage implements TypeStageInterface {
     #private;
     /**
-     * Resolves the target workspace's compiler and starts warming its mirror.
+     * Records the workspace and the mirror path without starting its compiler.
      *
      * @param workspace - The target workspace root. Default: the current working directory
      */
     constructor(workspace?: string);
     get stage(): Stage;
     get progress(): number;
+    start(): Promise<void>;
     /**
      * Inspects one case, against a caller-named project where the caller names one.
      *
@@ -1520,6 +1557,7 @@ export declare interface TypeStageInterface extends StageInterface {
     inspect(subject: Case, project?: string): Promise<Check>;
     /**
      * Resolves one project to the path and digest the stage applies for it.
+     * Calls `start()` before reading the project.
      *
      * @param project - The workspace-relative TypeScript project to resolve
      * @returns The resolved workspace-relative path and the digest of its compiler options