@camstack/system 1.2.360 → 1.2.361

package/dist/builtins/native-metrics/native-metrics.addon.d.ts

@@ -151,6 +151,22 @@ export default class NativeMetricsAddon extends BaseAddon<NativeMetricsConfig> {
      * is why the retention default is six hours rather than three days.
      */
     private startProcessSnapshotTimer;
+    /**
+     * Run one periodic tick so that it can NEVER become an unhandled rejection.
+     *
+     * `clearInterval` in `onShutdown` stops FUTURE ticks; it cannot recall one
+     * already in flight. A process tick awaits a `/proc` read and a
+     * `$process.list` broker call, and a graceful stop shuts this addon down
+     * (nulling `ctx`) while the agent goes on to stop its other addons and the
+     * broker — so the tick resumed with no context, its catch block reached for
+     * `this.ctx.logger`, threw again, and the rejection of the timer callback
+     * killed `docker stop CamStack-Agent` with exit code 1 (little-unraid,
+     * 2026-10-07 04:22Z). The ticks themselves now capture their context once
+     * and stand down when it is gone; this wrapper is the backstop.
+     *
+     * A tick before `initialize()` or after `shutdown()` is a no-op.
+     */
+    private runTick;
     protected onShutdown(): Promise<void>;
     /**
      * Resolve this node's short id (strips any `nodeId/addonId` suffix).

package/dist/builtins/native-metrics/native-metrics.addon.js

@@ -3014,7 +3014,8 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 		}
 		this.memoryProbe = new ContainerMemoryProbe({ logger: this.ctx.logger.child("ContainerMemory") });
 		this.pidsProbe = new ContainerPidsProbe({ logger: this.ctx.logger.child("ContainerPids") });
-		this.snapshotTimer = setInterval(() => this.emitResourcesSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
+		if (this.snapshotTimer) clearInterval(this.snapshotTimer);
+		this.snapshotTimer = setInterval(() => this.runTick("resources snapshot", () => this.emitResourcesSnapshot()), METRICS_SNAPSHOT_INTERVAL_MS);
 		this.startProcessSnapshotTimer();
 		this.ctx.addDisposer(this.ctx.eventBus.subscribe({ category: require_dist.EventCategory.MetricsNodeProcessesSnapshot }, (event) => this.retainSnapshot(event.data.nodeId, event.data.timestamp, event.data.processes, event.data.containerMemory)));
 		return [{
@@ -3179,7 +3180,33 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 	*/
 	startProcessSnapshotTimer() {
 		if (this.processSnapshotTimer) clearInterval(this.processSnapshotTimer);
-		this.processSnapshotTimer = setInterval(() => this.emitProcessesSnapshot(), this.loadConfig.cadenceSec * 1e3);
+		this.processSnapshotTimer = null;
+		if (!this.ctxIfReady) return;
+		this.processSnapshotTimer = setInterval(() => this.runTick("process snapshot", () => this.emitProcessesSnapshot()), this.loadConfig.cadenceSec * 1e3);
+	}
+	/**
+	* Run one periodic tick so that it can NEVER become an unhandled rejection.
+	*
+	* `clearInterval` in `onShutdown` stops FUTURE ticks; it cannot recall one
+	* already in flight. A process tick awaits a `/proc` read and a
+	* `$process.list` broker call, and a graceful stop shuts this addon down
+	* (nulling `ctx`) while the agent goes on to stop its other addons and the
+	* broker — so the tick resumed with no context, its catch block reached for
+	* `this.ctx.logger`, threw again, and the rejection of the timer callback
+	* killed `docker stop CamStack-Agent` with exit code 1 (little-unraid,
+	* 2026-10-07 04:22Z). The ticks themselves now capture their context once
+	* and stand down when it is gone; this wrapper is the backstop.
+	*
+	* A tick before `initialize()` or after `shutdown()` is a no-op.
+	*/
+	runTick(name, tick) {
+		if (!this.ctxIfReady) return;
+		tick().catch((err) => {
+			this.ctxIfReady?.logger.warn("native-metrics tick failed — this interval will be missing", { meta: {
+				tick: name,
+				error: err instanceof Error ? err.message : String(err)
+			} });
+		});
 	}
 	async onShutdown() {
 		if (this.snapshotTimer) {
@@ -3197,9 +3224,9 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 	* Resolve this node's short id (strips any `nodeId/addonId` suffix).
 	* Returns null when the provider or event bus isn't available yet.
 	*/
-	resolveSnapshotNodeId() {
-		if (!this.provider || !this.ctx.eventBus) return null;
-		const rawNodeId = this.ctx.kernel.localNodeId ?? this.ctx.id;
+	resolveSnapshotNodeId(ctx) {
+		if (!this.provider || !ctx.eventBus) return null;
+		const rawNodeId = ctx.kernel.localNodeId ?? ctx.id;
 		return rawNodeId.includes("/") ? rawNodeId.split("/")[0] : rawNodeId;
 	}
 	/**
@@ -3208,13 +3235,16 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 	* runs at samplingIntervalMs). Fires on METRICS_SNAPSHOT_INTERVAL_MS.
 	*/
 	async emitResourcesSnapshot() {
+		const ctx = this.ctxIfReady;
+		if (!ctx) return;
 		const provider = this.provider;
-		const eventBus = this.ctx.eventBus;
-		const nodeId = this.resolveSnapshotNodeId();
+		const eventBus = ctx.eventBus;
+		const nodeId = this.resolveSnapshotNodeId(ctx);
 		if (!provider || !eventBus || !nodeId) return;
 		const timestamp = Date.now();
 		try {
 			const snapshot = await provider.getCached() ?? await provider.collectSnapshot();
+			if (this.ctxIfReady !== ctx) return;
 			const coarse = coarsenResourcesSnapshot(snapshot);
 			const prev = this.lastResourcesEmit;
 			const heartbeatDue = !prev || timestamp - prev.emittedAt >= METRICS_SNAPSHOT_HEARTBEAT_MS;
@@ -3247,12 +3277,18 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 	* A failed scan emits nothing, which is the same signal: nobody reported.
 	*/
 	async emitProcessesSnapshot() {
-		const eventBus = this.ctx.eventBus;
-		const nodeId = this.resolveSnapshotNodeId();
+		const ctx = this.ctxIfReady;
+		if (!ctx) return;
+		const eventBus = ctx.eventBus;
+		const nodeId = this.resolveSnapshotNodeId(ctx);
 		if (!this.provider || !eventBus || !nodeId) return;
 		const timestamp = Date.now();
 		try {
 			const processes = await this.listNodeProcesses();
+			if (this.ctxIfReady !== ctx) {
+				ctx.logger.debug("process snapshot dropped — addon shut down mid-tick", { meta: { nodeId } });
+				return;
+			}
 			const containerMemory = this.memoryProbe?.sample() ?? null;
 			this.pidsProbe?.sample();
 			eventBus.emit(require_dist.createEvent(require_dist.EventCategory.MetricsNodeProcessesSnapshot, {
@@ -3266,20 +3302,21 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 				containerMemory
 			}));
 		} catch (err) {
-			this.ctx.logger.warn("process snapshot skipped — this interval will be missing", { meta: {
+			ctx.logger.warn("process snapshot skipped — this interval will be missing", { meta: {
 				nodeId,
 				error: err instanceof Error ? err.message : String(err)
 			} });
 		}
 	}
 	async onConfigChanged() {
+		if (!this.ctxIfReady) return;
 		this.provider?.stopSampling();
 		this.provider?.startSampling(this.config.samplingIntervalMs);
 		this.applyLoadSeriesConfig();
 		this.startProcessSnapshotTimer();
 	}
 	async listWorkerInstances() {
-		const broker = this.ctx.kernel.cluster?.broker;
+		const broker = this.ctxIfReady?.kernel.cluster?.broker;
 		if (!broker) return [];
 		try {
 			return await broker.call("$process.list");
@@ -3326,6 +3363,7 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 	* walk behind them — live in `process-classification.ts`.
 	*/
 	async listNodeProcesses() {
+		const selfNodeId = this.ctx.kernel.cluster?.broker?.nodeID ?? "hub";
 		const ps = await this.runPs();
 		if (ps.length === 0) return [];
 		const managed = /* @__PURE__ */ new Map();
@@ -3339,7 +3377,7 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 		return buildNodeProcesses({
 			psRows: ps,
 			selfPid: process.pid,
-			selfNodeId: this.ctx.kernel.cluster?.broker?.nodeID ?? "hub",
+			selfNodeId,
 			managed,
 			cpuSplits
 		});
@@ -3355,7 +3393,7 @@ var NativeMetricsAddon = class NativeMetricsAddon extends require_dist.BaseAddon
 		try {
 			return await readProcessTable();
 		} catch (err) {
-			this.ctx.logger.warn("process table read failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			this.ctxIfReady?.logger.warn("process table read failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 			return [];
 		}
 	}

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -3009,7 +3009,8 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 		}
 		this.memoryProbe = new ContainerMemoryProbe({ logger: this.ctx.logger.child("ContainerMemory") });
 		this.pidsProbe = new ContainerPidsProbe({ logger: this.ctx.logger.child("ContainerPids") });
-		this.snapshotTimer = setInterval(() => this.emitResourcesSnapshot(), METRICS_SNAPSHOT_INTERVAL_MS);
+		if (this.snapshotTimer) clearInterval(this.snapshotTimer);
+		this.snapshotTimer = setInterval(() => this.runTick("resources snapshot", () => this.emitResourcesSnapshot()), METRICS_SNAPSHOT_INTERVAL_MS);
 		this.startProcessSnapshotTimer();
 		this.ctx.addDisposer(this.ctx.eventBus.subscribe({ category: EventCategory.MetricsNodeProcessesSnapshot }, (event) => this.retainSnapshot(event.data.nodeId, event.data.timestamp, event.data.processes, event.data.containerMemory)));
 		return [{
@@ -3174,7 +3175,33 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 	*/
 	startProcessSnapshotTimer() {
 		if (this.processSnapshotTimer) clearInterval(this.processSnapshotTimer);
-		this.processSnapshotTimer = setInterval(() => this.emitProcessesSnapshot(), this.loadConfig.cadenceSec * 1e3);
+		this.processSnapshotTimer = null;
+		if (!this.ctxIfReady) return;
+		this.processSnapshotTimer = setInterval(() => this.runTick("process snapshot", () => this.emitProcessesSnapshot()), this.loadConfig.cadenceSec * 1e3);
+	}
+	/**
+	* Run one periodic tick so that it can NEVER become an unhandled rejection.
+	*
+	* `clearInterval` in `onShutdown` stops FUTURE ticks; it cannot recall one
+	* already in flight. A process tick awaits a `/proc` read and a
+	* `$process.list` broker call, and a graceful stop shuts this addon down
+	* (nulling `ctx`) while the agent goes on to stop its other addons and the
+	* broker — so the tick resumed with no context, its catch block reached for
+	* `this.ctx.logger`, threw again, and the rejection of the timer callback
+	* killed `docker stop CamStack-Agent` with exit code 1 (little-unraid,
+	* 2026-10-07 04:22Z). The ticks themselves now capture their context once
+	* and stand down when it is gone; this wrapper is the backstop.
+	*
+	* A tick before `initialize()` or after `shutdown()` is a no-op.
+	*/
+	runTick(name, tick) {
+		if (!this.ctxIfReady) return;
+		tick().catch((err) => {
+			this.ctxIfReady?.logger.warn("native-metrics tick failed — this interval will be missing", { meta: {
+				tick: name,
+				error: err instanceof Error ? err.message : String(err)
+			} });
+		});
 	}
 	async onShutdown() {
 		if (this.snapshotTimer) {
@@ -3192,9 +3219,9 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 	* Resolve this node's short id (strips any `nodeId/addonId` suffix).
 	* Returns null when the provider or event bus isn't available yet.
 	*/
-	resolveSnapshotNodeId() {
-		if (!this.provider || !this.ctx.eventBus) return null;
-		const rawNodeId = this.ctx.kernel.localNodeId ?? this.ctx.id;
+	resolveSnapshotNodeId(ctx) {
+		if (!this.provider || !ctx.eventBus) return null;
+		const rawNodeId = ctx.kernel.localNodeId ?? ctx.id;
 		return rawNodeId.includes("/") ? rawNodeId.split("/")[0] : rawNodeId;
 	}
 	/**
@@ -3203,13 +3230,16 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 	* runs at samplingIntervalMs). Fires on METRICS_SNAPSHOT_INTERVAL_MS.
 	*/
 	async emitResourcesSnapshot() {
+		const ctx = this.ctxIfReady;
+		if (!ctx) return;
 		const provider = this.provider;
-		const eventBus = this.ctx.eventBus;
-		const nodeId = this.resolveSnapshotNodeId();
+		const eventBus = ctx.eventBus;
+		const nodeId = this.resolveSnapshotNodeId(ctx);
 		if (!provider || !eventBus || !nodeId) return;
 		const timestamp = Date.now();
 		try {
 			const snapshot = await provider.getCached() ?? await provider.collectSnapshot();
+			if (this.ctxIfReady !== ctx) return;
 			const coarse = coarsenResourcesSnapshot(snapshot);
 			const prev = this.lastResourcesEmit;
 			const heartbeatDue = !prev || timestamp - prev.emittedAt >= METRICS_SNAPSHOT_HEARTBEAT_MS;
@@ -3242,12 +3272,18 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 	* A failed scan emits nothing, which is the same signal: nobody reported.
 	*/
 	async emitProcessesSnapshot() {
-		const eventBus = this.ctx.eventBus;
-		const nodeId = this.resolveSnapshotNodeId();
+		const ctx = this.ctxIfReady;
+		if (!ctx) return;
+		const eventBus = ctx.eventBus;
+		const nodeId = this.resolveSnapshotNodeId(ctx);
 		if (!this.provider || !eventBus || !nodeId) return;
 		const timestamp = Date.now();
 		try {
 			const processes = await this.listNodeProcesses();
+			if (this.ctxIfReady !== ctx) {
+				ctx.logger.debug("process snapshot dropped — addon shut down mid-tick", { meta: { nodeId } });
+				return;
+			}
 			const containerMemory = this.memoryProbe?.sample() ?? null;
 			this.pidsProbe?.sample();
 			eventBus.emit(createEvent(EventCategory.MetricsNodeProcessesSnapshot, {
@@ -3261,20 +3297,21 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 				containerMemory
 			}));
 		} catch (err) {
-			this.ctx.logger.warn("process snapshot skipped — this interval will be missing", { meta: {
+			ctx.logger.warn("process snapshot skipped — this interval will be missing", { meta: {
 				nodeId,
 				error: err instanceof Error ? err.message : String(err)
 			} });
 		}
 	}
 	async onConfigChanged() {
+		if (!this.ctxIfReady) return;
 		this.provider?.stopSampling();
 		this.provider?.startSampling(this.config.samplingIntervalMs);
 		this.applyLoadSeriesConfig();
 		this.startProcessSnapshotTimer();
 	}
 	async listWorkerInstances() {
-		const broker = this.ctx.kernel.cluster?.broker;
+		const broker = this.ctxIfReady?.kernel.cluster?.broker;
 		if (!broker) return [];
 		try {
 			return await broker.call("$process.list");
@@ -3321,6 +3358,7 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 	* walk behind them — live in `process-classification.ts`.
 	*/
 	async listNodeProcesses() {
+		const selfNodeId = this.ctx.kernel.cluster?.broker?.nodeID ?? "hub";
 		const ps = await this.runPs();
 		if (ps.length === 0) return [];
 		const managed = /* @__PURE__ */ new Map();
@@ -3334,7 +3372,7 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 		return buildNodeProcesses({
 			psRows: ps,
 			selfPid: process.pid,
-			selfNodeId: this.ctx.kernel.cluster?.broker?.nodeID ?? "hub",
+			selfNodeId,
 			managed,
 			cpuSplits
 		});
@@ -3350,7 +3388,7 @@ var NativeMetricsAddon = class NativeMetricsAddon extends BaseAddon {
 		try {
 			return await readProcessTable();
 		} catch (err) {
-			this.ctx.logger.warn("process table read failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			this.ctxIfReady?.logger.warn("process table read failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 			return [];
 		}
 	}

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3886,7 +3886,7 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		try {
 			await this.pressureManager.sweep();
 		} catch (err) {
-			this.ctx.logger.warn("storage pressure sweep failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			this.ctxIfReady?.logger.warn("storage pressure sweep failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		} finally {
 			this.pressureSweepInFlight = false;
 		}

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -3881,7 +3881,7 @@ var StorageOrchestratorAddon = class extends BaseAddon {
 		try {
 			await this.pressureManager.sweep();
 		} catch (err) {
-			this.ctx.logger.warn("storage pressure sweep failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			this.ctxIfReady?.logger.warn("storage pressure sweep failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		} finally {
 			this.pressureSweepInFlight = false;
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.360",
+  "version": "1.2.361",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",