@camstack/system 1.2.414 → 1.2.416

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.d.ts

@@ -4,6 +4,7 @@ interface StorageOrchestratorConfig extends Record<string, unknown> {}
 export declare class StorageOrchestratorAddon extends BaseAddon<StorageOrchestratorConfig> {
 	private service;
 	private pressureManager;
+	private readonly locationBandMonitor;
 	/**
 	* How much of each location CamStack itself holds (D388).
 	*
@@ -100,6 +101,11 @@ export declare class StorageOrchestratorAddon extends BaseAddon<StorageOrchestra
 	/** Single-flighted pressure sweep — never overlaps a slow eviction round. */
 	private runPressureSweep;
 	/**
+	* Sample free space for every managed location and emit NC band edges.
+	* A failed capacity read stays `null` (critical) — never folded to 0 (D393).
+	*/
+	private emitLocationBandEvents;
+	/**
 	* locationId → resolved `minFreePercent`. The policy is intrinsic to the
 	* location's provider (`shouldSaveDiskSpace` gates the guard, `minFreePercent`
 	* is the default), overridable per-location via `config.minFreePercent`.

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

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
 const require_hub_cap_forward = require("../../hub-cap-forward-W8oEm4ME.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
@@ -3342,6 +3342,64 @@ var StoragePressureManager = class {
 	}
 };
 //#endregion
+//#region src/builtins/storage-orchestrator/storage-location-band-monitor.ts
+var DEFAULT_STORAGE_LOCATION_BAND_CONFIG = {
+	lowPercent: 15,
+	criticalPercent: 5
+};
+function bandOf(freePercent, config) {
+	if (freePercent === null) return {
+		band: "critical",
+		reason: "capacity-unreadable"
+	};
+	if (freePercent <= config.criticalPercent) return {
+		band: "critical",
+		reason: "free-below-critical"
+	};
+	if (freePercent <= config.lowPercent) return {
+		band: "low",
+		reason: "free-below-warn"
+	};
+	return {
+		band: "ok",
+		reason: "free-ok"
+	};
+}
+var StorageLocationBandMonitor = class {
+	config;
+	band = /* @__PURE__ */ new Map();
+	constructor(config = DEFAULT_STORAGE_LOCATION_BAND_CONFIG) {
+		this.config = config;
+	}
+	/**
+	* Observe one sweep of managed locations. Locations missing from `samples`
+	* drop their episode without emitting `ok` (disabled / removed).
+	*/
+	observe(samples) {
+		const seen = /* @__PURE__ */ new Set();
+		const out = [];
+		for (const sample of samples) {
+			seen.add(sample.locationId);
+			const { band, reason } = bandOf(sample.freePercent, this.config);
+			const previous = this.band.get(sample.locationId) ?? null;
+			if (previous === band) continue;
+			this.band.set(sample.locationId, band);
+			if (previous === null && band === "ok") continue;
+			out.push({
+				locationId: sample.locationId,
+				...sample.nodeId !== void 0 ? { nodeId: sample.nodeId } : {},
+				...sample.locationName !== void 0 ? { locationName: sample.locationName } : {},
+				band,
+				freePercent: sample.freePercent,
+				reason,
+				previous
+			});
+		}
+		for (const id of [...this.band.keys()]) if (!seen.has(id)) this.band.delete(id);
+		return out;
+	}
+};
+//#endregion
 //#region src/builtins/storage-orchestrator/storage-orchestrator.addon.ts
 /**
 * `storage-orchestrator` builtin — singleton owner of the consumer-
@@ -3386,6 +3444,7 @@ var CAP_PROVIDER_REGISTERED_CATEGORY = "capability:provider-registered";
 var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 	service = null;
 	pressureManager = null;
+	locationBandMonitor = new StorageLocationBandMonitor();
 	/**
 	* How much of each location CamStack itself holds (D388).
 	*
@@ -3888,6 +3947,7 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		this.pressureSweepInFlight = true;
 		try {
 			await this.pressureManager.sweep();
+			await this.emitLocationBandEvents();
 		} catch (err) {
 			this.ctxIfReady?.logger.warn("storage pressure sweep failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		} finally {
@@ -3895,6 +3955,57 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		}
 	}
 	/**
+	* Sample free space for every managed location and emit NC band edges.
+	* A failed capacity read stays `null` (critical) — never folded to 0 (D393).
+	*/
+	async emitLocationBandEvents() {
+		const svc = this.service;
+		const ctx = this.ctxIfReady;
+		if (!svc || !ctx) return;
+		const thresholds = await this.resolveLocationThresholds();
+		const byId = new Map(svc.listLocations().map((loc) => [loc.id, loc]));
+		const samples = await Promise.all([...thresholds.keys()].map(async (locationId) => {
+			const loc = byId.get(locationId);
+			if (loc === void 0 || !require_dist.mayReadLocation(loc)) return {
+				locationId,
+				freePercent: null
+			};
+			const capacity = await this.volumeCapacityOf(locationId).catch(() => null);
+			const freePercent = capacity === null ? null : freePercentOf(capacity);
+			return {
+				locationId,
+				nodeId: loc.nodeId,
+				locationName: loc.displayName,
+				freePercent
+			};
+		}));
+		for (const edge of this.locationBandMonitor.observe(samples)) {
+			const category = edge.band === "low" ? require_dist.EventCategory.StorageLocationLow : edge.band === "critical" ? require_dist.EventCategory.StorageLocationCritical : require_dist.EventCategory.StorageLocationOk;
+			ctx.logger.info("storage: location band changed", { meta: {
+				locationId: edge.locationId,
+				band: edge.band,
+				freePercent: edge.freePercent,
+				reason: edge.reason
+			} });
+			ctx.eventBus.emit({
+				id: (0, node_crypto.randomUUID)(),
+				timestamp: /* @__PURE__ */ new Date(),
+				source: {
+					type: "addon",
+					id: this.ctx.id
+				},
+				category,
+				data: {
+					locationId: edge.locationId,
+					...edge.nodeId !== void 0 ? { nodeId: edge.nodeId } : {},
+					...edge.locationName !== void 0 ? { locationName: edge.locationName } : {},
+					freePercent: edge.freePercent,
+					reason: edge.reason
+				}
+			});
+		}
+	}
+	/**
 	* locationId → resolved `minFreePercent`. The policy is intrinsic to the
 	* location's provider (`shouldSaveDiskSpace` gates the guard, `minFreePercent`
 	* is the default), overridable per-location via `config.minFreePercent`.

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

@@ -1,4 +1,4 @@
-import { B as StorageCleanupJobSchema, Fn as storageCapability, Ft as gbToBytes, H as StorageLocationTypeSchema, In as storageMigrationCapability, Jn as withLocationMode, Jr as resolveSecretMarkers, Jt as legacyModeOf, Mn as settingsStoreCapability, O as LegacyStorageLocationDefaultSchema, Ot as evictionPolicyOfLocation, Rr as isSecretMarker, Tn as resolveLocationMode, U as StorageMigrationJobSchema, Ur as parseJsonObject, V as StorageLocationModeSchema, Vt as isLocationEnabled, Zr as secretTreeFromPaths, dr as BaseAddon, hr as REDACTED_SECRET, ni as transformSecretWrite, nn as mayReadLocation, on as modeMayWrite, ri as EventCategory, rn as mayWriteToLocation, wr as collectSecretConfigKeys } from "../../dist-ItJ3qAAA.mjs";
+import { $r as secretTreeFromPaths, A as LegacyStorageLocationDefaultSchema, At as evictionPolicyOfLocation, Br as isSecretMarker, Dn as resolveLocationMode, Er as collectSecretConfigKeys, G as StorageMigrationJobSchema, Gr as parseJsonObject, H as StorageCleanupJobSchema, Ln as storageCapability, Lt as gbToBytes, Pn as settingsStoreCapability, Rn as storageMigrationCapability, U as StorageLocationModeSchema, Ut as isLocationEnabled, W as StorageLocationTypeSchema, Xn as withLocationMode, Xr as resolveSecretMarkers, Xt as legacyModeOf, _r as REDACTED_SECRET, ai as EventCategory, an as mayWriteToLocation, cn as modeMayWrite, ii as transformSecretWrite, in as mayReadLocation, pr as BaseAddon } from "../../dist-DwE9yHdk.mjs";
 import { t as HUB_CAP_FWD_ACTION } from "../../hub-cap-forward-CDiN1p98.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
@@ -3337,6 +3337,64 @@ var StoragePressureManager = class {
 	}
 };
 //#endregion
+//#region src/builtins/storage-orchestrator/storage-location-band-monitor.ts
+var DEFAULT_STORAGE_LOCATION_BAND_CONFIG = {
+	lowPercent: 15,
+	criticalPercent: 5
+};
+function bandOf(freePercent, config) {
+	if (freePercent === null) return {
+		band: "critical",
+		reason: "capacity-unreadable"
+	};
+	if (freePercent <= config.criticalPercent) return {
+		band: "critical",
+		reason: "free-below-critical"
+	};
+	if (freePercent <= config.lowPercent) return {
+		band: "low",
+		reason: "free-below-warn"
+	};
+	return {
+		band: "ok",
+		reason: "free-ok"
+	};
+}
+var StorageLocationBandMonitor = class {
+	config;
+	band = /* @__PURE__ */ new Map();
+	constructor(config = DEFAULT_STORAGE_LOCATION_BAND_CONFIG) {
+		this.config = config;
+	}
+	/**
+	* Observe one sweep of managed locations. Locations missing from `samples`
+	* drop their episode without emitting `ok` (disabled / removed).
+	*/
+	observe(samples) {
+		const seen = /* @__PURE__ */ new Set();
+		const out = [];
+		for (const sample of samples) {
+			seen.add(sample.locationId);
+			const { band, reason } = bandOf(sample.freePercent, this.config);
+			const previous = this.band.get(sample.locationId) ?? null;
+			if (previous === band) continue;
+			this.band.set(sample.locationId, band);
+			if (previous === null && band === "ok") continue;
+			out.push({
+				locationId: sample.locationId,
+				...sample.nodeId !== void 0 ? { nodeId: sample.nodeId } : {},
+				...sample.locationName !== void 0 ? { locationName: sample.locationName } : {},
+				band,
+				freePercent: sample.freePercent,
+				reason,
+				previous
+			});
+		}
+		for (const id of [...this.band.keys()]) if (!seen.has(id)) this.band.delete(id);
+		return out;
+	}
+};
+//#endregion
 //#region src/builtins/storage-orchestrator/storage-orchestrator.addon.ts
 /**
 * `storage-orchestrator` builtin — singleton owner of the consumer-
@@ -3381,6 +3439,7 @@ var CAP_PROVIDER_REGISTERED_CATEGORY = "capability:provider-registered";
 var StorageOrchestratorAddon = class extends BaseAddon {
 	service = null;
 	pressureManager = null;
+	locationBandMonitor = new StorageLocationBandMonitor();
 	/**
 	* How much of each location CamStack itself holds (D388).
 	*
@@ -3883,6 +3942,7 @@ var StorageOrchestratorAddon = class extends BaseAddon {
 		this.pressureSweepInFlight = true;
 		try {
 			await this.pressureManager.sweep();
+			await this.emitLocationBandEvents();
 		} catch (err) {
 			this.ctxIfReady?.logger.warn("storage pressure sweep failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		} finally {
@@ -3890,6 +3950,57 @@ var StorageOrchestratorAddon = class extends BaseAddon {
 		}
 	}
 	/**
+	* Sample free space for every managed location and emit NC band edges.
+	* A failed capacity read stays `null` (critical) — never folded to 0 (D393).
+	*/
+	async emitLocationBandEvents() {
+		const svc = this.service;
+		const ctx = this.ctxIfReady;
+		if (!svc || !ctx) return;
+		const thresholds = await this.resolveLocationThresholds();
+		const byId = new Map(svc.listLocations().map((loc) => [loc.id, loc]));
+		const samples = await Promise.all([...thresholds.keys()].map(async (locationId) => {
+			const loc = byId.get(locationId);
+			if (loc === void 0 || !mayReadLocation(loc)) return {
+				locationId,
+				freePercent: null
+			};
+			const capacity = await this.volumeCapacityOf(locationId).catch(() => null);
+			const freePercent = capacity === null ? null : freePercentOf(capacity);
+			return {
+				locationId,
+				nodeId: loc.nodeId,
+				locationName: loc.displayName,
+				freePercent
+			};
+		}));
+		for (const edge of this.locationBandMonitor.observe(samples)) {
+			const category = edge.band === "low" ? EventCategory.StorageLocationLow : edge.band === "critical" ? EventCategory.StorageLocationCritical : EventCategory.StorageLocationOk;
+			ctx.logger.info("storage: location band changed", { meta: {
+				locationId: edge.locationId,
+				band: edge.band,
+				freePercent: edge.freePercent,
+				reason: edge.reason
+			} });
+			ctx.eventBus.emit({
+				id: randomUUID(),
+				timestamp: /* @__PURE__ */ new Date(),
+				source: {
+					type: "addon",
+					id: this.ctx.id
+				},
+				category,
+				data: {
+					locationId: edge.locationId,
+					...edge.nodeId !== void 0 ? { nodeId: edge.nodeId } : {},
+					...edge.locationName !== void 0 ? { locationName: edge.locationName } : {},
+					freePercent: edge.freePercent,
+					reason: edge.reason
+				}
+			});
+		}
+	}
+	/**
 	* locationId → resolved `minFreePercent`. The policy is intrinsic to the
 	* location's provider (`shouldSaveDiskSpace` gates the guard, `minFreePercent`
 	* is the default), overridable per-location via `config.minFreePercent`.