@harperfast/harper 5.2.13 → 5.3.0-beta.1

package/dist/components/status/ComponentStatusRegistry.js

@@ -7,6 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ComponentStatusRegistry = void 0;
+const deployValidationState_ts_1 = require("../../server/serverHelpers/deployValidationState.js");
 const ComponentStatus_ts_1 = require("./ComponentStatus.js");
 const types_ts_1 = require("./types.js");
 const crossThread_ts_1 = require("./crossThread.js");
@@ -15,6 +16,39 @@ const errors_ts_1 = require("./errors.js");
  * Component Status Registry Class
  * Provides a centralized registry for managing component health status
  */
+/**
+ * A status copy handed to a validation must share nothing mutable with the live entry. `Error` is reachable
+ * through the public `statusForComponent(...).get()` path, so candidate code could otherwise edit
+ * `message`, `cause` or a custom field on the serving component's own error object. Own enumerable
+ * properties are carried across; `cause` is flattened to a message, because an error graph of unknown depth
+ * is not worth cloning to hand a throwaway load its own read.
+ */
+function detachError(error) {
+    if (!(error instanceof Error))
+        return error;
+    const detached = new Error(error.message);
+    detached.name = error.name;
+    detached.stack = error.stack;
+    for (const [key, value] of Object.entries(error)) {
+        if (key === 'cause')
+            continue;
+        // Detached too where it can be: copying an object property by reference would leave the candidate a
+        // mutable handle into the live error after all. Anything unclonable (a function, a class instance) is
+        // replaced by its string form rather than shared.
+        let detachedValue;
+        try {
+            detachedValue = structuredClone(value);
+        }
+        catch {
+            detachedValue = typeof value === 'object' && value !== null ? String(value) : value;
+        }
+        detached[key] = detachedValue;
+    }
+    if (error.cause !== undefined) {
+        detached.cause = error.cause instanceof Error ? `${error.cause.name}: ${error.cause.message}` : error.cause;
+    }
+    return detached;
+}
 class ComponentStatusRegistry {
     statusMap = new Map();
     /**
@@ -35,12 +69,41 @@ class ComponentStatusRegistry {
         if (!Object.values(types_ts_1.COMPONENT_STATUS_LEVELS).includes(status)) {
             throw new errors_ts_1.ComponentStatusOperationError(componentName, 'setStatus', `Invalid status level: ${status}. Must be one of: ${Object.values(types_ts_1.COMPONENT_STATUS_LEVELS).join(', ')}`);
         }
+        // A deploy's pre-flight validation loads the CANDIDATE's code under the real component's name, so its
+        // writes would land on the live component. They go to the validation's own throwaway map instead —
+        // which is why this cannot simply be reverted afterwards: the live component keeps serving through
+        // that window, and `statusForComponent()` is a public API its own code may call at any time, so
+        // reverting would silently discard a genuine report from it.
+        const sink = (0, deployValidationState_ts_1.deployValidationStatusSink)();
+        if (sink) {
+            sink.set(componentName, new ComponentStatus_ts_1.ComponentStatus(status, message, error));
+            return;
+        }
         this.statusMap.set(componentName, new ComponentStatus_ts_1.ComponentStatus(status, message, error));
     }
     /**
      * Get the current status of a component
      */
     getStatus(componentName) {
+        // Inside a validation the candidate reads its OWN writes, and never the live object: the returned
+        // `ComponentStatus` is mutable, so handing back the live one would let candidate code edit the
+        // serving component's status in place and bypass the diversion entirely. A component the candidate
+        // has not written yet is copied into the sink on first read for the same reason.
+        const sink = (0, deployValidationState_ts_1.deployValidationStatusSink)();
+        if (sink) {
+            const diverted = sink.get(componentName);
+            if (diverted)
+                return diverted;
+            const live = this.statusMap.get(componentName);
+            if (!live)
+                return undefined;
+            const copy = new ComponentStatus_ts_1.ComponentStatus(live.status, live.message, detachError(live.error));
+            // A new Date, not the live one: `Date` is mutable, so sharing it would let candidate code reach
+            // back into the serving component's status through the copy.
+            copy.lastChecked = new Date(live.lastChecked);
+            sink.set(componentName, copy);
+            return copy;
+        }
         return this.statusMap.get(componentName);
     }
     /**

package/dist/components/status/ComponentStatusRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentStatusRegistry.js","sourceRoot":"","sources":["../../../components/status/ComponentStatusRegistry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6DAAuD;AACvD,yCAKoB;AACpB,qDAA0E;AAC1E,2CAA4D;AAO5D;;;GAGG;AACH,MAAa,uBAAuB;IAC3B,SAAS,GAAuB,IAAI,GAAG,EAAE,CAAC;IAElD;;;OAGG;IACI,KAAK;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,SAAS,CACf,aAAqB,EACrB,MAA4B,EAC5B,OAAgB,EAChB,KAAsB;QAEtB,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,yCAA6B,CACtC,MAAM,CAAC,aAAa,CAAC,EACrB,WAAW,EACX,2CAA2C,CAC3C,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kCAAuB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,yCAA6B,CACtC,aAAa,EACb,WAAW,EACX,yBAAyB,MAAM,qBAAqB,MAAM,CAAC,MAAM,CAAC,kCAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvG,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,oCAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,aAAqB;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,cAAc;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,aAAqB,EAAE,OAAgB;QAC3D,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,aAAqB,EAAE,KAAqB,EAAE,OAAgB;QAChF,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,kCAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,aAAqB,EAAE,OAAe;QAC1D,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IAEH;;OAEG;IACI,iBAAiB,CAAC,aAAqB,EAAE,OAAgB;QAC/D,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,IAAI,sBAAsB,CAAC,CAAC;IACnG,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,aAAqB,EAAE,OAAgB;QACxD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,IAAI,+BAA+B,CAAC,CAAC;IAC5G,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,aAAqB,EAAE,KAAqB,EAAE,OAAgB;QAC/E,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,kCAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACI,qBAAqB,CAAC,WAAiC;QAC7D,MAAM,MAAM,GAAqD,EAAE,CAAC;QACpE,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/B,CAAC;QACF,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;OAEG;IACI,gBAAgB;QACtB,MAAM,OAAO,GAAyC;YACrD,CAAC,kCAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,CAAC,kCAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,CAAC,kCAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,CAAC,kCAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,CAAC,kCAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;SACpC,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAC9C,QAAiC;QAEjC,MAAM,WAAW,GAAG,MAAM,qCAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,OAAO,iCAAgB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,sBAAsB,CAClC,aAAqB,EACrB,oBAA6D;QAE7D,6DAA6D;QAC7D,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3B,oBAAoB,GAAG,MAAM,uBAAuB,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;QACxF,CAAC;QAED,iDAAiD;QACjD,MAAM,WAAW,GAAG,EAAE,CAAC;QACvB,MAAM,eAAe,GAAG,aAAa,GAAG,GAAG,CAAC;QAE5C,4BAA4B;QAC5B,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3D,IAAI,UAAU,EAAE,CAAC;YAChB,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,6BAA6B;QAC7B,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,oBAAoB,EAAE,CAAC;YAC7D,IAAI,SAAS,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC3C,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;YACtD,CAAC;QACF,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,yBAAyB;YACzB,OAAO;gBACN,MAAM,EAAE,kCAAuB,CAAC,OAAO;gBACvC,OAAO,EAAE,4DAA4D;gBACrE,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;aAC5B,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,kCAAuB,CAAC,KAAK,CAAC,CAAC;QACtF,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,kCAAuB,CAAC,OAAO,CAAC,CAAC;QAEzF,MAAM,aAAa,GAAG,SAAS;YAC9B,CAAC,CAAC,kCAAuB,CAAC,KAAK;YAC/B,CAAC,CAAC,UAAU;gBACX,CAAC,CAAC,kCAAuB,CAAC,OAAO;gBACjC,CAAC,CAAC,kCAAuB,CAAC,OAAO,CAAC;QAEpC,0CAA0C;QAC1C,IAAI,cAAc,GAAG,oCAAoC,CAAC;QAC1D,MAAM,OAAO,GAAuE,EAAE,CAAC;QAEvF,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,kCAAuB,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,kCAAuB,CAAC,OAAO,CACjG,CAAC;YACF,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEnG,gCAAgC;YAChC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBAClC,IAAI,MAAM,CAAC,MAAM,KAAK,kCAAuB,CAAC,OAAO,EAAE,CAAC;oBACvD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG;wBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,OAAO,EAAE,MAAM,CAAC,aAAa;qBAC7B,CAAC;gBACH,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO;YACN,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,cAAc;YACvB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACnD,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;SAC3D,CAAC;IACH,CAAC;CACD;AAhOD,0DAgOC"}
+{"version":3,"file":"ComponentStatusRegistry.js","sourceRoot":"","sources":["../../../components/status/ComponentStatusRegistry.ts"],"names":[],"mappings":"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"}

package/dist/config/RootConfigWatcher.d.ts

@@ -1,11 +1,19 @@
 import { EventEmitter } from 'node:events';
+/**
+ * The isolate-wide watcher for the root config file. Consumers (logging, models) subscribe to this
+ * one instance instead of each opening their own native watcher — per-worker duplicates double the
+ * inotify/FD footprint and the synchronous read+parse work on every config write.
+ */
+export declare function getSharedRootConfigWatcher(): RootConfigWatcher;
 export declare class RootConfigWatcher extends EventEmitter {
     #private;
     ready: Promise<any[]>;
-    constructor();
+    constructor(configFilePath?: string);
     _simulateWatcherErrorForTests(error: unknown): void;
     get _usingPollingForTests(): boolean;
     get _openCountForTests(): number;
+    get _readCountForTests(): number;
+    get _armedForTests(): boolean;
     handleError(error: unknown): void;
     handleChange(): void;
     close(): this;

package/dist/config/RootConfigWatcher.js

@@ -1,41 +1,115 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RootConfigWatcher = void 0;
-const chokidar_1 = __importDefault(require("chokidar"));
-const promises_1 = require("node:fs/promises");
+exports.getSharedRootConfigWatcher = getSharedRootConfigWatcher;
 const configUtils_ts_1 = require("./configUtils.js");
+const readConfigFileSync_ts_1 = require("./readConfigFileSync.js");
 const node_events_1 = require("node:events");
-const yaml_1 = require("yaml");
+const parseConfigFile_ts_1 = require("./parseConfigFile.js");
 const watcherFallback_ts_1 = require("../utility/watcherFallback.js");
+const watchPath_ts_1 = require("../utility/watchPath.js");
+const harper_logger_ts_1 = require("../utility/logging/harper_logger.js");
+const configReadRetry_ts_1 = require("./configReadRetry.js");
+const watcherArming_ts_1 = require("./watcherArming.js");
+function isMissingFile(error) {
+    return !!error && typeof error === 'object' && error.code === 'ENOENT';
+}
+// `harper_logger` imports this module at its own bottom to break their cycle, so a tagged logger
+// built at module scope would run `loggerWithTag()` before `mainLogger` is initialized.
+let taggedLogger;
+function logger() {
+    return (taggedLogger ??= (0, harper_logger_ts_1.loggerWithTag)('config-watcher'));
+}
+let sharedWatcher;
+/**
+ * The isolate-wide watcher for the root config file. Consumers (logging, models) subscribe to this
+ * one instance instead of each opening their own native watcher — per-worker duplicates double the
+ * inotify/FD footprint and the synchronous read+parse work on every config write.
+ */
+function getSharedRootConfigWatcher() {
+    return (sharedWatcher ??= new RootConfigWatcher());
+}
 class RootConfigWatcher extends node_events_1.EventEmitter {
     #configFilePath;
+    #watchPath;
     #watcher;
     #config;
     #usingPolling;
     #closed;
     #openCount = 0;
+    #readCount = 0;
+    #readRetry = new configReadRetry_ts_1.ConfigReadRetry();
+    #armGate = new watcherArming_ts_1.ArmGate();
+    // The gate above is chokidar's scan finishing; this is the barrier's gate. A terminal outcome
+    // opens it without claiming the watch is armed, so the arming re-read still runs afterwards.
+    #barrierOpen = false;
+    #configLoaded = false;
+    #readyStaged = false;
+    #readyEmitted = false;
     ready;
-    constructor() {
+    constructor(configFilePath = (0, configUtils_ts_1.getConfigFilePath)()) {
         super();
-        this.#configFilePath = (0, configUtils_ts_1.getConfigFilePath)();
-        this.#usingPolling = false;
+        this.#configFilePath = configFilePath;
+        const watchTarget = (0, watchPath_ts_1.resolveWatchTarget)(this.#configFilePath);
+        this.#watchPath = watchTarget.path;
+        this.#usingPolling = watchTarget.mustPoll;
         this.#closed = false;
         this.ready = (0, node_events_1.once)(this, 'ready');
         this.#openWatcher();
     }
     #openWatcher() {
-        this.#openCount++;
-        this.#watcher = chokidar_1.default
-            .watch(this.#configFilePath, {
+        const generation = ++this.#openCount;
+        this.#watcher = (0, watcherFallback_ts_1.guardedWatch)(this.#watchPath, {
             persistent: false,
             ...(this.#usingPolling ? watcherFallback_ts_1.POLLING_FALLBACK_OPTIONS : {}),
         })
             .on('add', this.handleChange.bind(this))
             .on('change', this.handleChange.bind(this))
-            .on('error', this.handleError.bind(this));
+            .on('error', this.handleError.bind(this))
+            // Generation-bound: `#armGate.reset()` runs before the failed watcher is closed, so a
+            // `ready` still queued on it would arm the gate on the replacement's behalf and the
+            // replacement's own `ready` would then be a no-op — leaving its scan window unre-read.
+            .on('ready', () => this.#handleArmed(generation));
+    }
+    #handleArmed(generation) {
+        if (this.#closed || generation !== this.#openCount)
+            return;
+        this.#armGate.arm(() => this.#markArmed());
+    }
+    #markArmed() {
+        this.#barrierOpen = true;
+        // A write that landed while the watch was unarmed was never reported, and a scan that found
+        // no file at all reported nothing either, so arming always re-reads rather than publishing
+        // what an earlier read staged — or, with no file, staying pending forever.
+        this.#read(true);
+        // A read that armed the ladder settles `ready` itself, with the newer config.
+        if (!this.#readRetry.pending)
+            this.#emitReady();
+    }
+    #emitReady() {
+        if (this.#readyEmitted || !this.#barrierOpen || !this.#readyStaged || this.#closed)
+            return;
+        this.#readyEmitted = true;
+        try {
+            this.emit('ready', this.#config);
+        }
+        catch (error) {
+            logger().warn('A Harper configuration listener failed', (0, harper_logger_ts_1.errorForLog)(error));
+        }
+    }
+    // `harper_logger.start()` awaits `ready` with no timeout, so every terminal outcome has to
+    // settle the barrier. A failed read discards an earlier staged value, but a watcher error keeps
+    // it because no later read superseded it. No config is represented by `undefined`, not `{}`:
+    // an empty object is a configuration that turns logging off.
+    #stageBootFallback(discardStaged = true) {
+        if (this.#readyEmitted)
+            return;
+        if (discardStaged) {
+            this.#config = undefined;
+            this.#configLoaded = false;
+        }
+        this.#readyStaged = true;
+        this.#emitReady();
     }
     // Test-only: simulate the underlying chokidar watcher emitting an error.
     // Exposed so the polling-fallback path can be exercised without triggering a
@@ -43,15 +117,27 @@ class RootConfigWatcher extends node_events_1.EventEmitter {
     _simulateWatcherErrorForTests(error) {
         this.handleError(error);
     }
-    // Test-only: whether the watcher has fallen back to polling.
     get _usingPollingForTests() {
         return this.#usingPolling;
     }
-    // Test-only: number of times the underlying watcher has been (re)opened.
     get _openCountForTests() {
         return this.#openCount;
     }
+    // Distinguishes a ladder rung from a watcher event.
+    get _readCountForTests() {
+        return this.#readCount;
+    }
+    get _armedForTests() {
+        return this.#armGate.armed;
+    }
     handleError(error) {
+        // A queued chokidar error can land after close(), which has dropped every listener.
+        if (this.#closed)
+            return;
+        // See EntryHandler.#handleWatcherError: a lost native watch handle is benign
+        // and must not be surfaced to consumers as a config-watch failure.
+        if ((0, watcherFallback_ts_1.claimLostNativeWatchError)(error))
+            return;
         if ((0, watcherFallback_ts_1.isWatcherExhaustionError)(error)) {
             // Swallow every exhaustion error — chokidar can emit several before the
             // failed native watcher closes, and we don't want a flurry of ENOSPC to
@@ -59,44 +145,149 @@ class RootConfigWatcher extends node_events_1.EventEmitter {
             if (!this.#usingPolling) {
                 (0, watcherFallback_ts_1.warnWatcherFallback)(this.#configFilePath);
                 this.#usingPolling = true;
-                // Guard against reopen-after-close: the caller may have invoked
-                // close() while this teardown was in flight. The .catch is required
-                // because `finally` would re-raise a teardown rejection as an
-                // unhandled one.
-                this.#watcher
-                    .close()
+                // The generation that just failed no longer speaks for the watch; the replacement
+                // arms on its own scan, and re-reads then as the first one did.
+                this.#armGate.reset();
+                // Start close() from a microtask, not directly here, so a synchronous throw
+                // can't escape this 'error' listener as an uncaught exception.
+                Promise.resolve()
+                    .then(() => this.#watcher.close())
                     .catch(() => {
                     // Teardown errors on an already-failed watcher are not actionable.
                 })
-                    .finally(() => {
+                    .then(() => {
                     if (!this.#closed)
                         this.#openWatcher();
-                });
+                })
+                    .catch((error) => logger().warn(`Could not reopen the ${this.#configFilePath} watch on polling`, (0, harper_logger_ts_1.errorForLog)(error)));
+            }
+            else {
+                // Already polling — the replacement failed too, or the watch was polling from
+                // construction (`mustPoll`) and never had a fallback to take. Either way the branch
+                // above reopens only once, so this is the watch's terminal outcome and the barrier
+                // has to settle or `harper_logger.start()` awaits it forever.
+                this.#barrierOpen = true;
+                this.#stageBootFallback(false);
             }
             return;
         }
-        this.emit('error', error);
+        // chokidar may never reach its own `ready` after a scan error, and nothing else would
+        // settle the barrier: the error is this read's terminal outcome. The scan is not over
+        // though, so the arm gate stays closed and a later `ready` still takes the arming re-read.
+        this.#barrierOpen = true;
+        this.#stageBootFallback(false);
+        // Settling the barrier removed the `error` listener `once(this, 'ready')` attached, and an
+        // emit with none left throws the error back into chokidar's dispatch — as does a consumer
+        // that throws from its own handler.
+        if (this.listenerCount('error') === 0) {
+            logger().warn(`The Harper configuration watcher at ${this.#configFilePath} failed`, (0, harper_logger_ts_1.errorForLog)(error));
+            return;
+        }
+        try {
+            this.emit('error', error);
+        }
+        catch (listenerError) {
+            logger().warn('A Harper configuration error listener failed', (0, harper_logger_ts_1.errorForLog)(listenerError));
+        }
     }
     handleChange() {
-        (0, promises_1.readFile)(this.#configFilePath, 'utf-8')
-            .then((data) => {
-            if (!data)
+        this.#read(true);
+    }
+    // `harper_logger.start()` awaits `ready` with no timeout and the ladder may be the only thing
+    // left to settle it, so until then its timer keeps the thread alive rather than letting it
+    // drain and exit mid-boot.
+    #schedule() {
+        return this.#readRetry.schedule(() => this.#read(false), !this.#readyEmitted);
+    }
+    #read(waitForLock) {
+        // A queued chokidar callback can still land after close(), which has already discarded the
+        // config and dropped every listener.
+        if (this.#closed)
+            return;
+        this.#readCount++;
+        let data;
+        try {
+            data = (0, readConfigFileSync_ts_1.readConfigFileSync)(this.#configFilePath, waitForLock);
+        }
+        catch (error) {
+            // A missing file is not a lock — `readConfigFileSync` does not retry it either, and
+            // `OptionsWatcher` settles it immediately as the install window. Taking the ladder here
+            // would disagree with that and cost `harper_logger.start()` the whole budget on every
+            // boot that has no config file (an env-var-only deployment, an empty mounted rootPath).
+            if (!isMissingFile(error) && this.#schedule())
                 return;
-            const config = (0, yaml_1.parse)(data);
-            if (!this.#config) {
-                this.#config = config;
-                this.emit('ready', this.#config);
+            // A ladder armed by an earlier empty read is spent by the time a rung lands on ENOENT,
+            // and every other terminal path clears its deadline.
+            this.#readRetry.reset();
+            logger().warn(`Unable to read the Harper configuration file at ${this.#configFilePath}` +
+                (this.#configLoaded ? ', continuing with the previously loaded configuration' : '; none has been loaded yet'), (0, harper_logger_ts_1.errorForLog)(error));
+            this.#stageBootFallback();
+            return;
+        }
+        // See DESIGN.md, "An empty read is a writer mid-write, not an empty config".
+        if (!data) {
+            if (this.#schedule())
                 return;
-            }
+            logger().warn(`The Harper configuration file at ${this.#configFilePath} is empty`);
+            this.#stageBootFallback();
+            return;
+        }
+        let config;
+        try {
+            config = (0, parseConfigFile_ts_1.parseConfigFile)(data, this.#configFilePath);
+        }
+        catch (error) {
+            // A read taken mid-write is untrustworthy, not only an empty one: the writer's first
+            // `write(2)` can land a prefix of the document, and the event carrying the rest is the one
+            // chokidar throttles away. So an unparseable read rides out the same ladder as an empty
+            // one, and only a read that parses releases it.
+            if (this.#schedule())
+                return;
+            logger().warn(error.message);
+            this.#stageBootFallback();
+            return;
+        }
+        // The third shape a mid-write read takes, and the only one that parses: a truncated
+        // document, a lone `\n`, a file that is nothing but comments all yield `null` rather than
+        // throwing, and adopting one hands every consumer a config with nothing in it. Same ladder
+        // as the two above, and past it the file is empty rather than mid-write.
+        if (!config || typeof config !== 'object') {
+            if (this.#schedule())
+                return;
+            logger().warn(`The Harper configuration file at ${this.#configFilePath} is empty`);
+            this.#stageBootFallback();
+            return;
+        }
+        this.#readRetry.reset();
+        // Before `ready` goes out there is no prior state to have changed *since*.
+        this.#configLoaded = true;
+        this.#readyStaged = true;
+        if (!this.#readyEmitted) {
+            this.#config = config;
+            this.#emitReady();
+            return;
+        }
+        try {
             this.emit('change', (this.#config = config));
-        })
-            .catch((_error) => {
-            // if yaml parse error ignore?
-        });
+        }
+        catch (error) {
+            logger().warn('A Harper configuration change listener failed', (0, harper_logger_ts_1.errorForLog)(error));
+        }
     }
     close() {
+        // Closing is a terminal outcome too: leaving `ready` pending would hang anything still
+        // awaiting the barrier. Through `#emitReady`, so a listener that throws cannot skip the
+        // teardown below it and leave the watcher and its arm timer running.
+        this.#barrierOpen = true;
+        this.#readyStaged = true;
+        this.#emitReady();
         this.#closed = true;
-        this.#watcher.close();
+        this.#readRetry.cancel();
+        this.#armGate.cancel();
+        // chokidar's close() is a promise; an unhandled teardown rejection would reach Node as one,
+        // on the path whose whole job is to stop caring about this watcher. Same shape as the
+        // exhaustion-recovery close above, and as `OptionsWatcher.close`.
+        Promise.resolve(this.#watcher.close()).catch(() => { });
         this.#config = undefined;
         this.emit('close');
         this.removeAllListeners();

package/dist/config/RootConfigWatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"RootConfigWatcher.js","sourceRoot":"","sources":["../../config/RootConfigWatcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RootConfigWatcher.js","sourceRoot":"","sources":["../../config/RootConfigWatcher.ts"],"names":[],"mappings":"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"}

package/dist/config/configReadRetry.d.ts

@@ -0,0 +1,8 @@
+export declare function _setRetryBudgetForTests(ms?: number): void;
+export declare class ConfigReadRetry {
+    #private;
+    schedule(retry: () => void, holdEventLoop?: boolean): boolean;
+    get pending(): boolean;
+    reset(): void;
+    cancel(): void;
+}

package/dist/config/configReadRetry.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigReadRetry = void 0;
+exports._setRetryBudgetForTests = _setRetryBudgetForTests;
+// Why a lock that outlives the reader's budget is retried from a timer, and why both the bound and
+// the backoff are wall clock rather than an attempt count: see "Root config watchers must read
+// synchronously" in DESIGN.md (harper#2191).
+const RETRY_BUDGET_MS = 3_100;
+const INITIAL_DELAY_MS = 100;
+const MAX_DELAY_MS = 1_600;
+let retryBudgetMs = RETRY_BUDGET_MS;
+// Test-only, the read-side twin of `atomicWriteFile`'s `retryBudgetMs` option. A case that only
+// needs the ladder *spent* has no way to get there but wall clock, so without this each one sits
+// out the shipped 3.1 s; a dozen of them cost the unit job 40 s. Called with no argument it
+// restores the shipped value, and `configReadRetry.test.js` still spends that value in full, so
+// shortening it elsewhere cannot hide a change to what ships.
+function _setRetryBudgetForTests(ms = RETRY_BUDGET_MS) {
+    retryBudgetMs = ms;
+}
+class ConfigReadRetry {
+    #timer;
+    #deadline;
+    // Captured with the deadline: the backoff is a fraction of the budget the deadline came from,
+    // so reading the module value again mid-ladder would mis-scale it if a test had changed it.
+    #budgetMs = retryBudgetMs;
+    // `holdEventLoop` is for a caller whose boot barrier this ladder is the only thing left to
+    // settle: an unref'd timer would let the thread drain and exit mid-boot instead.
+    schedule(retry, holdEventLoop = false) {
+        this.cancel();
+        const now = performance.now();
+        if (this.#deadline === undefined) {
+            this.#budgetMs = retryBudgetMs;
+            this.#deadline = now + this.#budgetMs;
+        }
+        const remainingMs = this.#deadline - now;
+        if (remainingMs <= 0) {
+            this.reset();
+            return false;
+        }
+        const elapsedMs = this.#budgetMs - remainingMs;
+        const delayMs = Math.min(Math.max(elapsedMs, INITIAL_DELAY_MS), MAX_DELAY_MS, remainingMs);
+        this.#timer = setTimeout(retry, delayMs);
+        if (!holdEventLoop)
+            this.#timer.unref();
+        return true;
+    }
+    get pending() {
+        return this.#timer !== undefined;
+    }
+    reset() {
+        this.cancel();
+        this.#deadline = undefined;
+    }
+    cancel() {
+        if (this.#timer) {
+            clearTimeout(this.#timer);
+            this.#timer = undefined;
+        }
+    }
+}
+exports.ConfigReadRetry = ConfigReadRetry;
+//# sourceMappingURL=configReadRetry.js.map

package/dist/config/configReadRetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configReadRetry.js","sourceRoot":"","sources":["../../config/configReadRetry.ts"],"names":[],"mappings":";;;AAcA,0DAEC;AAhBD,mGAAmG;AACnG,+FAA+F;AAC/F,6CAA6C;AAC7C,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,YAAY,GAAG,KAAK,CAAC;AAE3B,IAAI,aAAa,GAAG,eAAe,CAAC;AAEpC,gGAAgG;AAChG,iGAAiG;AACjG,4FAA4F;AAC5F,gGAAgG;AAChG,8DAA8D;AAC9D,SAAgB,uBAAuB,CAAC,KAAa,eAAe;IACnE,aAAa,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,MAAa,eAAe;IAC3B,MAAM,CAAkB;IACxB,SAAS,CAAU;IACnB,8FAA8F;IAC9F,4FAA4F;IAC5F,SAAS,GAAW,aAAa,CAAC;IAElC,2FAA2F;IAC3F,iFAAiF;IACjF,QAAQ,CAAC,KAAiB,EAAE,gBAAyB,KAAK;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC;YAC/B,IAAI,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACvC,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACzC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,aAAa;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IAClC,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,MAAM;QACL,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACzB,CAAC;IACF,CAAC;CACD;AA3CD,0CA2CC"}

package/dist/config/configUtils.d.ts

@@ -5,11 +5,19 @@ export declare function resolvePath(relativePath: string): string;
  * @param param
  */
 export declare function getConfigPath(param: string): any;
-export declare function atomicWriteFile(filePath: any, content: any, { maxRetries, initialDelayMs, maxDelayMs, }?: {
+type RenameRetryOptions = {
+    retryBudgetMs?: number;
     maxRetries?: number;
     initialDelayMs?: number;
     maxDelayMs?: number;
-}): void;
+};
+type AtomicWriteOptions = RenameRetryOptions & {
+    skipIfUnchanged?: boolean;
+};
+export declare function isStorageExhausted(error: any): boolean;
+export declare function persistConfigDuringBoot(artifactPath: string, write: () => void): boolean;
+export declare function atomicWriteFile(filePath: any, content: any, { retryBudgetMs, maxRetries, initialDelayMs, maxDelayMs, skipIfUnchanged, }?: AtomicWriteOptions): boolean;
+export declare function renameWithRetry(fromPath: any, toPath: any, { retryBudgetMs, maxRetries, initialDelayMs, maxDelayMs, }?: RenameRetryOptions): void;
 /**
  * Builds the Harper config file using user inputs and default values from defaultConfig.yaml
  * @param args - any args that the user provided.
@@ -129,3 +137,4 @@ export declare function addConfig(topLevelElement: any, values: any): Promise<vo
 export declare function deleteConfigFromFile(param: string): void;
 export declare function getConfigObj(): any;
 export declare function getFlatConfigObj(): any;
+export {};