@orkestrel/probe 0.0.4 → 0.0.6

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

@@ -863,9 +863,12 @@ export declare interface ProbeErrorOptions {
  *
  * @remarks
  * `arm` fires when the boot control has reported red and the service will answer calls; a probe
- * arriving before it awaits that step rather than starting a second one. `expire` fires when the
- * coordinator's own deadline destroyed a stage and a replacement took its place, which is the only
- * way a synchronous infinite loop is ever reported.
+ * arriving before it awaits that step rather than starting a second one. An arming attempt that
+ * rejects fires `error` instead, as it rejects, so a host waiting on `arm` reads the refusal rather
+ * than waiting on a state no event describes. The rejected attempt is still retained for retry, and
+ * the next `prove` runs the boot controls again, so a workspace that cannot arm surfaces one `error`
+ * per attempt. `expire` fires when the coordinator's own deadline destroyed a stage and a
+ * replacement took its place, which is the only way a synchronous infinite loop is ever reported.
  *
  * @example
  * ```ts
@@ -879,7 +882,7 @@ export declare type ProbeEventMap = {
     readonly prove: readonly [verdict: Verdict];
     /** The coordinator's deadline fired at one stage and that stage was replaced before this event. */
     readonly expire: readonly [claim: Claim];
-    /** A fault surfaced for observation. */
+    /** A fault surfaced for observation, once per fault, including a rejected arming attempt. */
     readonly error: readonly [error: unknown];
 };
 

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

@@ -863,9 +863,12 @@ export declare interface ProbeErrorOptions {
  *
  * @remarks
  * `arm` fires when the boot control has reported red and the service will answer calls; a probe
- * arriving before it awaits that step rather than starting a second one. `expire` fires when the
- * coordinator's own deadline destroyed a stage and a replacement took its place, which is the only
- * way a synchronous infinite loop is ever reported.
+ * arriving before it awaits that step rather than starting a second one. An arming attempt that
+ * rejects fires `error` instead, as it rejects, so a host waiting on `arm` reads the refusal rather
+ * than waiting on a state no event describes. The rejected attempt is still retained for retry, and
+ * the next `prove` runs the boot controls again, so a workspace that cannot arm surfaces one `error`
+ * per attempt. `expire` fires when the coordinator's own deadline destroyed a stage and a
+ * replacement took its place, which is the only way a synchronous infinite loop is ever reported.
  *
  * @example
  * ```ts
@@ -879,7 +882,7 @@ export declare type ProbeEventMap = {
     readonly prove: readonly [verdict: Verdict];
     /** The coordinator's deadline fired at one stage and that stage was replaced before this event. */
     readonly expire: readonly [claim: Claim];
-    /** A fault surfaced for observation. */
+    /** A fault surfaced for observation, once per fault, including a rejected arming attempt. */
     readonly error: readonly [error: unknown];
 };
 

package/dist/src/server/index.cjs

@@ -806,7 +806,7 @@ var Overlay = class {
 };
 //#endregion
 //#region package.json
-var version = "0.0.4";
+var version = "0.0.6";
 var peerDependencies = {
 	"oxlint": "^1.77.0",
 	"typescript": "^6.0.0",
@@ -2180,6 +2180,7 @@ var Probe = class {
 	#lintQueue;
 	#runtimeQueue;
 	#deadlines = /* @__PURE__ */ new WeakSet();
+	#surfaced = /* @__PURE__ */ new WeakSet();
 	#typeTail = Promise.resolve();
 	#arming;
 	#closing;
@@ -2261,7 +2262,7 @@ var Probe = class {
 			this.#emitter.emit("prove", verdict);
 			return verdict;
 		} catch (error) {
-			this.#emitter.emit("error", error);
+			if (!(error instanceof _src_core.ProbeError) || !this.#surfaced.has(error)) this.#emitter.emit("error", error);
 			throw error;
 		}
 	}
@@ -2286,18 +2287,30 @@ var Probe = class {
 		await this.#arming;
 	}
 	async #arm() {
-		const created = this.#workbench();
+		let created;
+		try {
+			created = this.#workbench();
+		} catch (error) {
+			this.#surface(error);
+			throw error;
+		}
 		try {
 			await this.#boot(created);
 		} catch (error) {
-			throw new _src_core.ProbeError(`The probe could not arm: ${describeUnknown(error)}`, {
+			const failure = new _src_core.ProbeError(`The probe could not arm: ${describeUnknown(error)}`, {
 				origin: "instrument",
 				code: "malformed",
 				cause: error
 			});
+			this.#surface(failure);
+			throw failure;
 		}
 		this.#emitter.emit("arm", this.#toolchain);
 	}
+	#surface(error) {
+		if (error instanceof _src_core.ProbeError) this.#surfaced.add(error);
+		this.#emitter.emit("error", error);
+	}
 	#workbench() {
 		const path = "tmp/probe";
 		const directory = resolveWorkspaceFile(this.#workspace, path);