@orkestrel/probe 0.0.24 → 0.0.26

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

@@ -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
@@ -843,6 +842,8 @@ export declare function parseRevisionOwner(revision: string): number | undefined
  * Answers claims through its type, lint, and runtime stages.
  *
  * @remarks
+ * The workspace peers are TypeScript `^6.0.3 || ^7.0.2` and Vitest `^4.1.12 || ^5.0.5`.
+ * Starting refuses TypeScript majors outside 6 and 7 before a stage starts.
  * 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
@@ -891,7 +892,7 @@ 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.89.0:vitest@4.1.12:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
+ * verdict.receipt?.startsWith(`probe:${verdict.digest}:type:`) // true
  * await probe.destroy()
  * ```
  */
@@ -1183,6 +1184,8 @@ export declare function releaseListeners(emitter: EventEmitter, capture: Listene
  * @remarks
  * A package publishes its binaries under keys of its own choosing, and that key is often not the
  * package name: `typescript` publishes `tsc`. Name the key as `command` wherever the two differ.
+ * Resolution reads `package.json` and its `bin` field, so TypeScript 6 and 7 need no exported
+ * `typescript/bin/tsc` subpath.
  * Default: the package name.
  *
  * @param workspace - The target workspace root
@@ -1247,6 +1250,11 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
  * Inspects tests through one resident Vitest service from the target workspace.
  *
  * @remarks
+ * Vitest 4.1.12 and 5.0.5 share the mode-first `createVitest` overload used by this stage.
+ * Result eviction removes one file from Vitest 4's results cache. Vitest 5 exposes only a full
+ * cache clear, so eviction clears its results, dependency, and filesystem module caches.
+ * Warming removes termination handlers registered within the factory's async context before
+ * signal delivery, while retaining handlers the host registers outside that context.
  * 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
@@ -1447,6 +1455,8 @@ export declare interface StageInterface {
  * Inspects TypeScript source by running the target workspace's own compiler over a mirror of it.
  *
  * @remarks
+ * TypeScript 6 and 7 run through the `tsc` entry in their package manifest; neither a compiler API
+ * nor an exported binary subpath is required.
  * 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. Starting sweeps a
  * mirror an earlier host left behind, copies the workspace into a fresh one under
@@ -1513,6 +1523,8 @@ export declare class TypeStage implements TypeStageInterface {
      * refreshed from the workspace first on a cache miss, so the digest names the configuration the
      * check applies. The reading is cached per project for the life of the stage, so a draft written
      * afterward cannot move it.
+     * Before returning the identity, validates the project with `--noEmit` unless an unoverlaid check
+     * already validated it. TypeScript 7's `--showConfig` can succeed for a malformed project.
      *
      * @param project - The workspace-relative TypeScript project to resolve
      * @returns The resolved workspace-relative path and the digest of its compiler options
@@ -1520,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>;
 }
 
@@ -1559,6 +1579,10 @@ export declare interface TypeStageInterface extends StageInterface {
      * Resolves one project to the path and digest the stage applies for it.
      * Calls `start()` before reading the project.
      *
+     * @remarks
+     * Validates the project with `--noEmit` unless warming or an earlier unoverlaid check already
+     * validated it, because TypeScript 7's `--showConfig` can print partial JSON for a malformed project.
+     *
      * @param project - The workspace-relative TypeScript project to resolve
      * @returns The resolved workspace-relative path and the digest of its compiler options
      * @throws When the project escapes the workspace, when the compiler refuses it, or when the

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

@@ -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
@@ -843,6 +842,8 @@ export declare function parseRevisionOwner(revision: string): number | undefined
  * Answers claims through its type, lint, and runtime stages.
  *
  * @remarks
+ * The workspace peers are TypeScript `^6.0.3 || ^7.0.2` and Vitest `^4.1.12 || ^5.0.5`.
+ * Starting refuses TypeScript majors outside 6 and 7 before a stage starts.
  * 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
@@ -891,7 +892,7 @@ 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.89.0:vitest@4.1.12:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
+ * verdict.receipt?.startsWith(`probe:${verdict.digest}:type:`) // true
  * await probe.destroy()
  * ```
  */
@@ -1183,6 +1184,8 @@ export declare function releaseListeners(emitter: EventEmitter, capture: Listene
  * @remarks
  * A package publishes its binaries under keys of its own choosing, and that key is often not the
  * package name: `typescript` publishes `tsc`. Name the key as `command` wherever the two differ.
+ * Resolution reads `package.json` and its `bin` field, so TypeScript 6 and 7 need no exported
+ * `typescript/bin/tsc` subpath.
  * Default: the package name.
  *
  * @param workspace - The target workspace root
@@ -1247,6 +1250,11 @@ export declare function resolveWorkspaceModule(workspace: string, specifier: str
  * Inspects tests through one resident Vitest service from the target workspace.
  *
  * @remarks
+ * Vitest 4.1.12 and 5.0.5 share the mode-first `createVitest` overload used by this stage.
+ * Result eviction removes one file from Vitest 4's results cache. Vitest 5 exposes only a full
+ * cache clear, so eviction clears its results, dependency, and filesystem module caches.
+ * Warming removes termination handlers registered within the factory's async context before
+ * signal delivery, while retaining handlers the host registers outside that context.
  * 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
@@ -1447,6 +1455,8 @@ export declare interface StageInterface {
  * Inspects TypeScript source by running the target workspace's own compiler over a mirror of it.
  *
  * @remarks
+ * TypeScript 6 and 7 run through the `tsc` entry in their package manifest; neither a compiler API
+ * nor an exported binary subpath is required.
  * 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. Starting sweeps a
  * mirror an earlier host left behind, copies the workspace into a fresh one under
@@ -1513,6 +1523,8 @@ export declare class TypeStage implements TypeStageInterface {
      * refreshed from the workspace first on a cache miss, so the digest names the configuration the
      * check applies. The reading is cached per project for the life of the stage, so a draft written
      * afterward cannot move it.
+     * Before returning the identity, validates the project with `--noEmit` unless an unoverlaid check
+     * already validated it. TypeScript 7's `--showConfig` can succeed for a malformed project.
      *
      * @param project - The workspace-relative TypeScript project to resolve
      * @returns The resolved workspace-relative path and the digest of its compiler options
@@ -1520,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>;
 }
 
@@ -1559,6 +1579,10 @@ export declare interface TypeStageInterface extends StageInterface {
      * Resolves one project to the path and digest the stage applies for it.
      * Calls `start()` before reading the project.
      *
+     * @remarks
+     * Validates the project with `--noEmit` unless warming or an earlier unoverlaid check already
+     * validated it, because TypeScript 7's `--showConfig` can print partial JSON for a malformed project.
+     *
      * @param project - The workspace-relative TypeScript project to resolve
      * @returns The resolved workspace-relative path and the digest of its compiler options
      * @throws When the project escapes the workspace, when the compiler refuses it, or when the