@orkestrel/probe 0.0.25 → 0.0.27

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

@@ -1,5 +1,4 @@
 import type { Case } from '@orkestrel/probe';
-import type { Check } from '@orkestrel/probe';
 import type { Claim } from '@orkestrel/probe';
 import type { EmitterInterface } from '@orkestrel/emitter';
 import type { EventEmitter } from 'node:events';
@@ -12,6 +11,7 @@ import type { ProbeInterface } from '@orkestrel/probe';
 import type { ProbeOptions } from '@orkestrel/probe';
 import type { Project } from '@orkestrel/probe';
 import type { Stage } from '@orkestrel/probe';
+import type { StageResult } from '@orkestrel/probe';
 import type { Toolchain } from '@orkestrel/probe';
 import type { Verdict } from '@orkestrel/probe';
 import type * as VitestNode from 'vitest/node';
@@ -86,10 +86,10 @@ export declare function collectWorkspaceFiles(workspace: string): readonly strin
  *
  * @example
  * ```ts
- * computeDigest('/srv/checkout', { strict: true }).length // 32
+ * computeWorkspaceDigest('/srv/checkout', { strict: true }).length // 32
  * ```
  */
-export declare function computeDigest(workspace: string, value: unknown): string;
+export declare function computeWorkspaceDigest(workspace: string, value: unknown): string;
 
 /**
  * Creates the protocol failure returned when the MCP handshake cannot arm the probe.
@@ -397,7 +397,7 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
  *
  * @remarks
  * 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
+ * and hands the conversation to `@orkestrel/lsp`: `createLSPStdioTransport` 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
  * stage owns the workspace, the candidate identity, and the projection from a diagnostic to an
@@ -425,7 +425,7 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
  * @example
  * ```ts
  * const stage = new LintStage('/srv/checkout')
- * const check = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
+ * const result = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
  * await stage.destroy()
  * ```
  */
@@ -441,7 +441,7 @@ export declare class LintStage implements LintStageInterface {
     get progress(): number;
     get exit(): Promise<never>;
     start(): Promise<void>;
-    inspect(subject: Case, options?: InspectionOptions): Promise<Check>;
+    inspect(subject: Case, options?: InspectionOptions): Promise<StageResult>;
     destroy(): Promise<void>;
 }
 
@@ -461,7 +461,7 @@ export declare class LintStage implements LintStageInterface {
  *
  * @example
  * ```ts
- * const check = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
+ * const result = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
  * ```
  */
 export declare interface LintStageInterface extends StageInterface {
@@ -478,10 +478,10 @@ export declare interface LintStageInterface extends StageInterface {
      *
      * @example
      * ```ts
-     * const check = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
+     * const result = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
      * ```
      */
-    inspect(subject: Case, options?: InspectionOptions): Promise<Check>;
+    inspect(subject: Case, options?: InspectionOptions): Promise<StageResult>;
 }
 
 /**
@@ -524,13 +524,11 @@ export declare type ListenerCapture = ReadonlyMap<string, readonly Function[]>;
 export declare function loadWorkspaceVitest(workspace: string): typeof VitestNode;
 
 /**
- * Reports whether the host that wrote one file is still running.
+ * Reports whether a file's owning host is running or cannot be judged.
  *
  * @remarks
- * Signal 0 delivers nothing and reports reachability alone. A process this one may not signal
- * reports `EPERM` and reads as running, and a non-positive identity names a process group rather
- * than a process, so both answer true: the safe direction is to keep a file this package cannot
- * account for.
+ * Keeps a file when its identity is invalid or `inspectProcess` reports existence, denied
+ * permission, or an indeterminate host failure. Only a confirmed absent process answers false.
  *
  * @param id - The process id a file's own revision names
  * @returns True if that process is running or cannot be judged; false otherwise
@@ -586,7 +584,8 @@ export declare function normalizePath(path: string): string;
  * its relative form keeps one commit checked out at two roots reading to one digest. A path that
  * escapes the workspace is left as it stands, because rewriting it would name a file outside the
  * tree by a relative spelling. Key order is the compiler's own and it differs between the supported
- * majors, so sorting removes a difference that means nothing.
+ * majors, so sorting removes a difference that means nothing. A `__proto__` key is dropped, as
+ * the earlier assignment-built record dropped it, so a digest stays the same across releases.
  *
  * @param workspace - The target workspace root
  * @param value - The value to rewrite
@@ -1308,7 +1307,7 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
  * @example
  * ```ts
  * const stage = new RuntimeStage('/srv/checkout')
- * const check = await stage.inspect(subject)
+ * const result = await stage.inspect(subject)
  * await stage.destroy()
  * ```
  */
@@ -1336,7 +1335,7 @@ export declare class RuntimeStage implements StageInterface {
      * @returns One outcome for this stage
      * @throws When the workspace's own tool cannot start or has already been destroyed
      */
-    inspect(subject: Case): Promise<Check>;
+    inspect(subject: Case): Promise<StageResult>;
     /**
      * Tears down the resident tool or the mirror and releases its resources.
      *
@@ -1396,8 +1395,8 @@ export declare function scanDiagnostics(text: string): readonly Diagnostic[];
  *
  * @example
  * ```ts
- * const check = await stage.inspect(subject)
- * console.log(check.stage)
+ * const result = await stage.inspect(subject)
+ * console.log(result.stage)
  * await stage.destroy()
  * ```
  */
@@ -1431,11 +1430,11 @@ export declare interface StageInterface {
      *
      * @example
      * ```ts
-     * const check = await stage.inspect(subject)
-     * console.log(check.stage, check.elapsed, check.issues.length)
+     * const result = await stage.inspect(subject)
+     * console.log(result.stage, result.elapsed, result.issues.length)
      * ```
      */
-    inspect(subject: Case): Promise<Check>;
+    inspect(subject: Case): Promise<StageResult>;
     /**
      * Tears down the resident tool or the mirror and releases its resources.
      *
@@ -1485,7 +1484,7 @@ export declare interface StageInterface {
  * @example
  * ```ts
  * const stage = new TypeStage('/srv/checkout')
- * const check = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
+ * const result = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
  * await stage.destroy()
  * ```
  */
@@ -1515,7 +1514,7 @@ export declare class TypeStage implements TypeStageInterface {
      * @throws When the workspace refuses the mirror, when a project the run reads is malformed, or
      * when the stage has already been destroyed
      */
-    inspect(subject: Case, project?: string): Promise<Check>;
+    inspect(subject: Case, project?: string): Promise<StageResult>;
     /**
      * Resolves one project to the path and digest this stage applies for it.
      *
@@ -1533,6 +1532,14 @@ export declare class TypeStage implements TypeStageInterface {
      * stage has already been destroyed
      */
     resolve(project: string): Promise<Project>;
+    /**
+     * Tears down the compiler processes and releases the mirror without awaiting inspections.
+     *
+     * @remarks
+     * On Windows, awaits each tree termination attempt before removing the mirror. Each attempt
+     * uses `PROBE_DEADLINE`, the existing default inspection budget, as its utility timeout.
+     * On POSIX, sends `SIGTERM` to each compiler. Warming settles before the mirror is removed.
+     */
     destroy(): Promise<void>;
 }
 
@@ -1548,7 +1555,7 @@ export declare class TypeStage implements TypeStageInterface {
  * @example
  * ```ts
  * const project = await stage.resolve('configs/src/tsconfig.core.json')
- * const check = await stage.inspect(subject, project.path)
+ * const result = await stage.inspect(subject, project.path)
  * ```
  */
 export declare interface TypeStageInterface extends StageInterface {
@@ -1564,10 +1571,10 @@ export declare interface TypeStageInterface extends StageInterface {
      *
      * @example
      * ```ts
-     * const check = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
+     * const result = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
      * ```
      */
-    inspect(subject: Case, project?: string): Promise<Check>;
+    inspect(subject: Case, project?: string): Promise<StageResult>;
     /**
      * Resolves one project to the path and digest the stage applies for it.
      * Calls `start()` before reading the project.

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

@@ -1,5 +1,4 @@
 import type { Case } from '@orkestrel/probe';
-import type { Check } from '@orkestrel/probe';
 import type { Claim } from '@orkestrel/probe';
 import type { EmitterInterface } from '@orkestrel/emitter';
 import type { EventEmitter } from 'node:events';
@@ -12,6 +11,7 @@ import type { ProbeInterface } from '@orkestrel/probe';
 import type { ProbeOptions } from '@orkestrel/probe';
 import type { Project } from '@orkestrel/probe';
 import type { Stage } from '@orkestrel/probe';
+import type { StageResult } from '@orkestrel/probe';
 import type { Toolchain } from '@orkestrel/probe';
 import type { Verdict } from '@orkestrel/probe';
 import type * as VitestNode from 'vitest/node';
@@ -86,10 +86,10 @@ export declare function collectWorkspaceFiles(workspace: string): readonly strin
  *
  * @example
  * ```ts
- * computeDigest('/srv/checkout', { strict: true }).length // 32
+ * computeWorkspaceDigest('/srv/checkout', { strict: true }).length // 32
  * ```
  */
-export declare function computeDigest(workspace: string, value: unknown): string;
+export declare function computeWorkspaceDigest(workspace: string, value: unknown): string;
 
 /**
  * Creates the protocol failure returned when the MCP handshake cannot arm the probe.
@@ -397,7 +397,7 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
  *
  * @remarks
  * 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
+ * and hands the conversation to `@orkestrel/lsp`: `createLSPStdioTransport` 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
  * stage owns the workspace, the candidate identity, and the projection from a diagnostic to an
@@ -425,7 +425,7 @@ export declare function isRefusedName(file: string, error: unknown): boolean;
  * @example
  * ```ts
  * const stage = new LintStage('/srv/checkout')
- * const check = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
+ * const result = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
  * await stage.destroy()
  * ```
  */
@@ -441,7 +441,7 @@ export declare class LintStage implements LintStageInterface {
     get progress(): number;
     get exit(): Promise<never>;
     start(): Promise<void>;
-    inspect(subject: Case, options?: InspectionOptions): Promise<Check>;
+    inspect(subject: Case, options?: InspectionOptions): Promise<StageResult>;
     destroy(): Promise<void>;
 }
 
@@ -461,7 +461,7 @@ export declare class LintStage implements LintStageInterface {
  *
  * @example
  * ```ts
- * const check = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
+ * const result = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
  * ```
  */
 export declare interface LintStageInterface extends StageInterface {
@@ -478,10 +478,10 @@ export declare interface LintStageInterface extends StageInterface {
      *
      * @example
      * ```ts
-     * const check = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
+     * const result = await stage.inspect(subject, { signal: AbortSignal.timeout(30_000) })
      * ```
      */
-    inspect(subject: Case, options?: InspectionOptions): Promise<Check>;
+    inspect(subject: Case, options?: InspectionOptions): Promise<StageResult>;
 }
 
 /**
@@ -524,13 +524,11 @@ export declare type ListenerCapture = ReadonlyMap<string, readonly Function[]>;
 export declare function loadWorkspaceVitest(workspace: string): typeof VitestNode;
 
 /**
- * Reports whether the host that wrote one file is still running.
+ * Reports whether a file's owning host is running or cannot be judged.
  *
  * @remarks
- * Signal 0 delivers nothing and reports reachability alone. A process this one may not signal
- * reports `EPERM` and reads as running, and a non-positive identity names a process group rather
- * than a process, so both answer true: the safe direction is to keep a file this package cannot
- * account for.
+ * Keeps a file when its identity is invalid or `inspectProcess` reports existence, denied
+ * permission, or an indeterminate host failure. Only a confirmed absent process answers false.
  *
  * @param id - The process id a file's own revision names
  * @returns True if that process is running or cannot be judged; false otherwise
@@ -586,7 +584,8 @@ export declare function normalizePath(path: string): string;
  * its relative form keeps one commit checked out at two roots reading to one digest. A path that
  * escapes the workspace is left as it stands, because rewriting it would name a file outside the
  * tree by a relative spelling. Key order is the compiler's own and it differs between the supported
- * majors, so sorting removes a difference that means nothing.
+ * majors, so sorting removes a difference that means nothing. A `__proto__` key is dropped, as
+ * the earlier assignment-built record dropped it, so a digest stays the same across releases.
  *
  * @param workspace - The target workspace root
  * @param value - The value to rewrite
@@ -1308,7 +1307,7 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
  * @example
  * ```ts
  * const stage = new RuntimeStage('/srv/checkout')
- * const check = await stage.inspect(subject)
+ * const result = await stage.inspect(subject)
  * await stage.destroy()
  * ```
  */
@@ -1336,7 +1335,7 @@ export declare class RuntimeStage implements StageInterface {
      * @returns One outcome for this stage
      * @throws When the workspace's own tool cannot start or has already been destroyed
      */
-    inspect(subject: Case): Promise<Check>;
+    inspect(subject: Case): Promise<StageResult>;
     /**
      * Tears down the resident tool or the mirror and releases its resources.
      *
@@ -1396,8 +1395,8 @@ export declare function scanDiagnostics(text: string): readonly Diagnostic[];
  *
  * @example
  * ```ts
- * const check = await stage.inspect(subject)
- * console.log(check.stage)
+ * const result = await stage.inspect(subject)
+ * console.log(result.stage)
  * await stage.destroy()
  * ```
  */
@@ -1431,11 +1430,11 @@ export declare interface StageInterface {
      *
      * @example
      * ```ts
-     * const check = await stage.inspect(subject)
-     * console.log(check.stage, check.elapsed, check.issues.length)
+     * const result = await stage.inspect(subject)
+     * console.log(result.stage, result.elapsed, result.issues.length)
      * ```
      */
-    inspect(subject: Case): Promise<Check>;
+    inspect(subject: Case): Promise<StageResult>;
     /**
      * Tears down the resident tool or the mirror and releases its resources.
      *
@@ -1485,7 +1484,7 @@ export declare interface StageInterface {
  * @example
  * ```ts
  * const stage = new TypeStage('/srv/checkout')
- * const check = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
+ * const result = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
  * await stage.destroy()
  * ```
  */
@@ -1515,7 +1514,7 @@ export declare class TypeStage implements TypeStageInterface {
      * @throws When the workspace refuses the mirror, when a project the run reads is malformed, or
      * when the stage has already been destroyed
      */
-    inspect(subject: Case, project?: string): Promise<Check>;
+    inspect(subject: Case, project?: string): Promise<StageResult>;
     /**
      * Resolves one project to the path and digest this stage applies for it.
      *
@@ -1533,6 +1532,14 @@ export declare class TypeStage implements TypeStageInterface {
      * stage has already been destroyed
      */
     resolve(project: string): Promise<Project>;
+    /**
+     * Tears down the compiler processes and releases the mirror without awaiting inspections.
+     *
+     * @remarks
+     * On Windows, awaits each tree termination attempt before removing the mirror. Each attempt
+     * uses `PROBE_DEADLINE`, the existing default inspection budget, as its utility timeout.
+     * On POSIX, sends `SIGTERM` to each compiler. Warming settles before the mirror is removed.
+     */
     destroy(): Promise<void>;
 }
 
@@ -1548,7 +1555,7 @@ export declare class TypeStage implements TypeStageInterface {
  * @example
  * ```ts
  * const project = await stage.resolve('configs/src/tsconfig.core.json')
- * const check = await stage.inspect(subject, project.path)
+ * const result = await stage.inspect(subject, project.path)
  * ```
  */
 export declare interface TypeStageInterface extends StageInterface {
@@ -1564,10 +1571,10 @@ export declare interface TypeStageInterface extends StageInterface {
      *
      * @example
      * ```ts
-     * const check = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
+     * const result = await stage.inspect(subject, 'configs/src/tsconfig.core.json')
      * ```
      */
-    inspect(subject: Case, project?: string): Promise<Check>;
+    inspect(subject: Case, project?: string): Promise<StageResult>;
     /**
      * Resolves one project to the path and digest the stage applies for it.
      * Calls `start()` before reading the project.