@north-light/api 0.3.591 → 0.3.592

package/dist/daemon/manage.d.ts

@@ -122,6 +122,11 @@ export declare class DaemonExitedBeforeReadyError extends Error {
     readonly stderrTail: string;
     constructor(message: string, stderrTail: string);
 }
+/** The daemon's launch command could not be resolved, so no child was ever
+ *  started — a standing failure that waiting longer cannot fix. */
+export declare class DaemonLaunchError extends Error {
+    constructor(cause: unknown);
+}
 /** A live daemon has bound its repair socket but cannot serve normal work
  *  until its corpus migration succeeds. */
 export declare class DaemonStartupBlockedError extends Error {
@@ -200,7 +205,8 @@ export interface EnsureDaemonDeps {
     spawnDaemon?: () => Promise<SpawnDaemonResult>;
     now?: () => number;
 }
-/** Why the daemon this process autostarted died before becoming ready, or
+/** Why the daemon this process autostarted died before becoming ready, or why
+ *  its launch command could not be resolved (no daemon was started), or
  *  undefined while it is starting, running, or exited cleanly (a clean exit may
  *  be a lost singleton race, so only a non-zero/signal exit counts). A client
  *  waiting for that daemon polls this so a startup failure ends the wait now
@@ -210,6 +216,7 @@ export declare function daemonAutostartStartupFailure(): string | undefined;
  *  autostart is suppressed for this invocation, while `crtr sys join` holds
  *  the join lock (see core/directory/join-lock.ts), while an attempt is in flight,
  *  or while backing off from a recent failure.
- *  Silently swallows spawn errors (the canvas still works without the daemon;
- *  nodes just won't be auto-revived). */
+ *  Does not throw: a spawn error is recorded, and a launch or early-exit failure
+ *  is reported through `daemonAutostartStartupFailure()` so a waiting client
+ *  fails with it. */
 export declare function ensureDaemon(deps?: EnsureDaemonDeps): void;

package/dist/daemon/manage.js

@@ -290,6 +290,14 @@ export class DaemonExitedBeforeReadyError extends Error {
         this.stderrTail = stderrTail;
     }
 }
+/** The daemon's launch command could not be resolved, so no child was ever
+ *  started — a standing failure that waiting longer cannot fix. */
+export class DaemonLaunchError extends Error {
+    constructor(cause) {
+        super(cause instanceof Error ? cause.message : String(cause), { cause });
+        this.name = 'DaemonLaunchError';
+    }
+}
 /** A live daemon has bound its repair socket but cannot serve normal work
  *  until its corpus migration succeeds. */
 export class DaemonStartupBlockedError extends Error {
@@ -544,7 +552,9 @@ export async function spawnDaemon(opts = {}) {
     // in macOS Full Disk Access, not "node" (see branded-host). NOTE: when crtrd
     // is launchd-owned, the plist's ProgramArguments must point at the branded
     // binary too — this path only covers a manual `crtr sys daemon start`.
-    const launchArgs = await resolveDaemonLaunch();
+    const launchArgs = await resolveDaemonLaunch().catch((error) => {
+        throw new DaemonLaunchError(error);
+    });
     // The one spawn point every start reaches (autostart, `sys daemon start`, a handover successor): an
     // autostart begun before a join took its lock lands here after it, and must not start a daemon.
     if (opts.waitForJoinLock === true)
@@ -671,7 +681,8 @@ export function resetDaemonAutostart() {
     autostartFailures = 0;
     autostartNextAttemptAt = 0;
 }
-/** Why the daemon this process autostarted died before becoming ready, or
+/** Why the daemon this process autostarted died before becoming ready, or why
+ *  its launch command could not be resolved (no daemon was started), or
  *  undefined while it is starting, running, or exited cleanly (a clean exit may
  *  be a lost singleton race, so only a non-zero/signal exit counts). A client
  *  waiting for that daemon polls this so a startup failure ends the wait now
@@ -683,8 +694,9 @@ export function daemonAutostartStartupFailure() {
  *  autostart is suppressed for this invocation, while `crtr sys join` holds
  *  the join lock (see core/directory/join-lock.ts), while an attempt is in flight,
  *  or while backing off from a recent failure.
- *  Silently swallows spawn errors (the canvas still works without the daemon;
- *  nodes just won't be auto-revived). */
+ *  Does not throw: a spawn error is recorded, and a launch or early-exit failure
+ *  is reported through `daemonAutostartStartupFailure()` so a waiting client
+ *  fails with it. */
 export function ensureDaemon(deps = {}) {
     const running = deps.isDaemonRunning ?? isDaemonRunning;
     const spawn = deps.spawnDaemon ?? spawnDaemon;
@@ -711,11 +723,9 @@ export function ensureDaemon(deps = {}) {
         autostartFailures = 0;
         autostartNextAttemptAt = 0;
     }, (error) => {
-        if (error instanceof DaemonExitedBeforeReadyError) {
+        if (error instanceof DaemonExitedBeforeReadyError || error instanceof DaemonLaunchError) {
             autostartStartupFailure = error.message;
         }
-        // Intentionally silent — a missing dist/daemon/crtrd-cli.js (dev mode,
-        // pre-build) must not break the calling command.
         autostartFailures += 1;
         autostartNextAttemptAt = now() + autostartBackoffMs(autostartFailures);
     }).finally(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.591",
+  "version": "0.3.592",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",