@camstack/system 1.2.456 → 1.2.457

package/dist/builtins/platform-probe/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 let node_util = require("node:util");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import { o as __toESM, r as __exportAll } from "../../chunk-CNf5ZN-e.mjs";
-import { $r as BaseAddon, Gi as emitReadiness, Qn as platformProbeCapability, Qr as errMsg, Ta as EventCategory, gr as scoreRuntimes, in as enumerateInferenceDevices } from "../../dist-BSF_C8W2.mjs";
+import { Ji as emitReadiness, Oa as EventCategory, ni as BaseAddon, sn as enumerateInferenceDevices, ti as errMsg, tr as platformProbeCapability, yr as scoreRuntimes } from "../../dist-Dhux90yB.mjs";
 import { promisify } from "node:util";
 import * as os$1 from "node:os";
 import * as fs from "node:fs";

package/dist/builtins/record-entries/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 //#region src/builtins/record-entries/entries-service.ts

package/dist/builtins/record-entries/index.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Oi as UnknownRecordKindError, li as InvalidRecordError, pa as recordSecretRef, ra as mapSecretLeaves, tr as recordEntriesCapability } from "../../dist-BSF_C8W2.mjs";
+import { fi as InvalidRecordError, ga as recordSecretRef, ir as recordEntriesCapability, ji as UnknownRecordKindError, ni as BaseAddon, oa as mapSecretLeaves } from "../../dist-Dhux90yB.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 //#region src/builtins/record-entries/entries-service.ts

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Ta as EventCategory } from "../../dist-BSF_C8W2.mjs";
+import { Oa as EventCategory, ni as BaseAddon } from "../../dist-Dhux90yB.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 const require_snapshot_courtesy = require("../../snapshot-courtesy-D_C5-nC0.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Et as batteryCapability, Or as streamQualityLabel, Qr as errMsg, Ta as EventCategory, Tt as bareAddonId, Vn as memoizePinnedFfmpeg, Yr as DeviceFeature, Yt as deriveBatteryPresence, Zr as DeviceType, br as snapshotCapability, ia as nodePin, s as BatteryStatusSchema } from "../../dist-BSF_C8W2.mjs";
+import { Cr as snapshotCapability, Oa as EventCategory, Ot as bareAddonId, Qr as DeviceFeature, Qt as deriveBatteryPresence, Wn as memoizePinnedFfmpeg, ei as DeviceType, jr as streamQualityLabel, kt as batteryCapability, ni as BaseAddon, s as BatteryStatusSchema, sa as nodePin, ti as errMsg } from "../../dist-Dhux90yB.mjs";
 import { i as renderCourtesyOverlayJpeg, n as courtesyCacheKey, r as renderCourtesyJpeg } from "../../snapshot-courtesy-CyFs1M3I.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

package/dist/builtins/sqlite-storage/filesystem-storage.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-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { $r as BaseAddon, Er as storageProviderCapability, fn as filesystemBrowseCapability } from "../../dist-BSF_C8W2.mjs";
+import { hn as filesystemBrowseCapability, kr as storageProviderCapability, ni as BaseAddon } from "../../dist-Dhux90yB.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/sqlite-storage/index.js

@@ -4,7 +4,7 @@ Object.defineProperties(exports, {
 });
 require("../../chunk-Cek0wNdY.js");
 const require_builtins_sqlite_storage_filesystem_storage_addon = require("./filesystem-storage.addon.js");
-const require_wal_maintenance = require("../../wal-maintenance-CNEs_I94.js");
+const require_wal_maintenance = require("../../wal-maintenance-DVN-DiVP.js");
 const require_builtins_sqlite_storage_sqlite_settings_addon = require("./sqlite-settings.addon.js");
 //#region src/builtins/sqlite-storage/config-store.ts
 var ConfigStore = class {

package/dist/builtins/sqlite-storage/index.mjs

@@ -1,5 +1,5 @@
 import { FilesystemStorageAddon, t as FilesystemStorageProvider } from "./filesystem-storage.addon.mjs";
-import { A as SQLITE_MMAP_CEILING_BYTES, B as SQLITE_SLOW_CALL_MS, F as sqlitePageCacheKibFor, H as sqliteEngineStorm, I as SQLITE_ENGINE_STORM_WALL_SHARE, L as SQLITE_PROFILE_REPORT_FLOOR_MS, M as SQLITE_PAGE_CACHE_CEILING_KIB, N as SQLITE_PAGE_CACHE_FLOOR_KIB, P as sqliteMmapSizeFor, R as SQLITE_PROFILE_REPORT_INTERVAL_MS, V as SqliteOpProfiler, a as WalMaintenance, i as WAL_MAINTENANCE_INTERVAL_MS, j as SQLITE_MMAP_FLOOR_BYTES, k as SQLITE_JOURNAL_SIZE_LIMIT_BYTES, l as SqliteSettingsBackend, n as WAL_HIGH_WATER_BYTES, r as WAL_IDLE_QUIET_MS, t as WAL_CHECKPOINT_BUSY_TIMEOUT_MS, z as SQLITE_PROFILE_TOP_N } from "../../wal-maintenance-AerF4XE6.mjs";
+import { A as SQLITE_MMAP_CEILING_BYTES, B as SQLITE_SLOW_CALL_MS, F as sqlitePageCacheKibFor, H as sqliteEngineStorm, I as SQLITE_ENGINE_STORM_WALL_SHARE, L as SQLITE_PROFILE_REPORT_FLOOR_MS, M as SQLITE_PAGE_CACHE_CEILING_KIB, N as SQLITE_PAGE_CACHE_FLOOR_KIB, P as sqliteMmapSizeFor, R as SQLITE_PROFILE_REPORT_INTERVAL_MS, V as SqliteOpProfiler, a as WalMaintenance, i as WAL_MAINTENANCE_INTERVAL_MS, j as SQLITE_MMAP_FLOOR_BYTES, k as SQLITE_JOURNAL_SIZE_LIMIT_BYTES, l as SqliteSettingsBackend, n as WAL_HIGH_WATER_BYTES, r as WAL_IDLE_QUIET_MS, t as WAL_CHECKPOINT_BUSY_TIMEOUT_MS, z as SQLITE_PROFILE_TOP_N } from "../../wal-maintenance-BMiX6UIa.mjs";
 import { SqliteSettingsAddon } from "./sqlite-settings.addon.mjs";
 //#region src/builtins/sqlite-storage/config-store.ts
 var ConfigStore = class {

package/dist/builtins/sqlite-storage/sqlite-settings.addon.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 const require_retired_settings_keys = require("../../retired-settings-keys-D_VwZiDt.js");
-const require_wal_maintenance = require("../../wal-maintenance-CNEs_I94.js");
+const require_wal_maintenance = require("../../wal-maintenance-DVN-DiVP.js");
 const require_sqlite_snapshot_protocol = require("../../sqlite-snapshot-protocol-B9OndqZv.js");
 const require_wal_checkpoint_policy = require("../../wal-checkpoint-policy-d2z2qPqx.js");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/sqlite-storage/sqlite-settings.addon.mjs

@@ -1,6 +1,6 @@
-import { $r as BaseAddon, C as DATABASE_SNAPSHOT_TIMEOUT_MS, Fr as vectorStoreCapability, Gt as databaseSnapshotCapability, Oi as UnknownRecordKindError, Qr as errMsg, S as DATABASE_SNAPSHOT_SUFFIX, Sr as storageAdminCapability, Tt as bareAddonId, Wt as dataStoreProviderCapability, ai as DeclarationRefusedError, at as STORAGE_ADMIN_SCOPED_BASES, da as parseSettingsBrokersAdoptsFrom, hi as RECORD_SWEEP_INTERVAL_MS, it as STORAGE_ADMIN_MOVED_COLLECTIONS, nr as recordsCapability, oa as normalizeSecretOwner, ua as parseSettingsArrayAdoptsFrom, ui as NoCallerError, vi as RUNTIME_DEFAULTS, w as DATA_STORE_DATABASES, x as DATABASE_SNAPSHOT_PARTIAL_SUFFIX, xi as RecordKindDeclarationSchema } from "../../dist-BSF_C8W2.mjs";
+import { C as DATABASE_SNAPSHOT_TIMEOUT_MS, Jt as databaseSnapshotCapability, Ot as bareAddonId, Rr as vectorStoreCapability, S as DATABASE_SNAPSHOT_SUFFIX, Tr as storageAdminCapability, ar as recordsCapability, ci as DeclarationRefusedError, ji as UnknownRecordKindError, la as normalizeSecretOwner, ma as parseSettingsBrokersAdoptsFrom, ni as BaseAddon, ot as STORAGE_ADMIN_MOVED_COLLECTIONS, pa as parseSettingsArrayAdoptsFrom, pi as NoCallerError, qt as dataStoreProviderCapability, st as STORAGE_ADMIN_SCOPED_BASES, ti as errMsg, vi as RECORD_SWEEP_INTERVAL_MS, w as DATA_STORE_DATABASES, wi as RecordKindDeclarationSchema, x as DATABASE_SNAPSHOT_PARTIAL_SUFFIX, xi as RUNTIME_DEFAULTS } from "../../dist-Dhux90yB.mjs";
 import { i as retiredKeyStoreOf, n as purgeRetiredSettingsKeys } from "../../retired-settings-keys-Bhwe4ymb.mjs";
-import { C as RecordsEngine, D as callVector, E as callRecords, O as controlTargetOf, S as trustResult, T as callData, _ as collectTransferables, a as WalMaintenance, c as vectorProviderOfOwnedFile, d as CrossDatabaseTransactError, f as DatabaseBusyError, l as SqliteSettingsBackend, m as rehydrateError, o as createVectorIndex, p as DuplicatePlacementError, s as vectorProviderOf, u as CollectionPlacementError, v as isFileHostMessage, w as callControl } from "../../wal-maintenance-AerF4XE6.mjs";
+import { C as RecordsEngine, D as callVector, E as callRecords, O as controlTargetOf, S as trustResult, T as callData, _ as collectTransferables, a as WalMaintenance, c as vectorProviderOfOwnedFile, d as CrossDatabaseTransactError, f as DatabaseBusyError, l as SqliteSettingsBackend, m as rehydrateError, o as createVectorIndex, p as DuplicatePlacementError, s as vectorProviderOf, u as CollectionPlacementError, v as isFileHostMessage, w as callControl } from "../../wal-maintenance-BMiX6UIa.mjs";
 import { r as isSnapshotWorkerMessage } from "../../sqlite-snapshot-protocol-2QaTouWV.mjs";
 import { a as isWorkerMessage, t as WAL_CHECKPOINT_LARGE_PASS_FRAMES } from "../../wal-checkpoint-policy-BahrTtyD.mjs";
 import { createRequire } from "node:module";

package/dist/builtins/storage-orchestrator/location-history-recorder.d.ts

@@ -0,0 +1,76 @@
+/**
+* Storage-location occupancy over time, through device-history (D850).
+*
+* The figures are the ones `listLocations` already serves, from their own
+* authorities — nothing is measured twice:
+*  - the VOLUME (`location-used-percent`, `location-free-bytes`) from the same
+*    statfs probe the UI's capacity reads (`readLocalVolumeCapacity`), which
+*    answers only for a location THIS node can measure;
+*  - what CamStack HOLDS there (`location-owned-bytes`) from the
+*    `storage-occupancy` slice (D388).
+*
+* A figure that is unknown is NO point, never 0 (D393, D315): a failed statfs,
+* a remote provider, a location nobody reports owned bytes for.
+*
+* Subject: the node the location lives on (`nodeId`), else the node that
+* measured it. Scope: the location id, so a location keeps one series for life.
+*/
+import type { DeviceHistoryIngestResult, IScopedLogger } from "@camstack/types";
+export declare const LOCATION_HISTORY_NAMES: {
+	readonly usedPercent: "location-used-percent";
+	readonly freeBytes: "location-free-bytes";
+	readonly ownedBytes: "location-owned-bytes";
+};
+/** One location's sweep reading. */
+export interface LocationReading {
+	readonly locationId: string;
+	readonly nodeId: string;
+	/** `null` when this node cannot take a measurement that is about the location. */
+	readonly capacity: {
+		readonly totalBytes: number;
+		readonly availableBytes: number;
+	} | null;
+	/** `undefined` when no provider reports what CamStack holds there. */
+	readonly ownedBytes: number | undefined;
+}
+export interface LocationHistoryPoint {
+	readonly key: string;
+	readonly subject: {
+		readonly kind: "node";
+		readonly nodeId: string;
+	};
+	readonly scope: string;
+	readonly ts: number;
+	readonly value: number;
+}
+export interface LocationHistoryClient {
+	declareSeries(input: {
+		name: string;
+		subjectKind: "node";
+		kind: "gauge";
+		displayName: string;
+		ingest: "points";
+		unit: string;
+	}): Promise<{
+		key: string;
+	}>;
+	record(input: {
+		points: readonly LocationHistoryPoint[];
+	}): Promise<DeviceHistoryIngestResult>;
+}
+export interface LocationHistoryRecorderDeps {
+	readonly deviceHistory: LocationHistoryClient;
+	readonly logger: IScopedLogger;
+}
+/** One reading per location per this many ms at most (the sweep runs every minute). */
+export declare const LOCATION_HISTORY_MIN_INTERVAL_MS = 6e4;
+export declare class LocationHistoryRecorder {
+	private readonly deps;
+	private readonly keys;
+	private readonly lastAt;
+	constructor(deps: LocationHistoryRecorderDeps);
+	private ensureDeclared;
+	/** The points of one sweep; pure apart from the per-location rate memory. */
+	pointsOf(readings: readonly LocationReading[], at: number): readonly LocationHistoryPoint[];
+	record(readings: readonly LocationReading[], at: number): Promise<void>;
+}

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

@@ -18,6 +18,9 @@ export declare class StorageOrchestratorAddon extends BaseAddon<StorageOrchestra
 	private occupancySlice;
 	private get occupancy();
 	private pressureTimer;
+	/** Occupancy over time (device-history). Created with the timer that feeds it. */
+	private locationHistory;
+	private locationHistoryInFlight;
 	private pressureSweepInFlight;
 	private migration;
 	/** Guards every single-location repoint and arbitrates movers per physical root. */
@@ -108,6 +111,12 @@ export declare class StorageOrchestratorAddon extends BaseAddon<StorageOrchestra
 	/** Single-flighted pressure sweep — never overlaps a slow eviction round. */
 	private runPressureSweep;
 	/**
+	* One occupancy reading per location this node can read, into device-history.
+	* The volume figures come from the same probe `listLocations` serves, the
+	* held bytes from the occupancy slice; an unknown figure is no point (D393).
+	*/
+	private recordLocationHistory;
+	/**
 	* Sample free space for every managed location and emit NC band edges.
 	* A failed capacity read stays `null` and changes no band — never folded to 0 (D393).
 	*/

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-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
@@ -3957,6 +3957,107 @@ var StorageLocationBandMonitor = class {
 	}
 };
 //#endregion
+//#region src/builtins/storage-orchestrator/location-history-recorder.ts
+var LOCATION_HISTORY_NAMES = {
+	usedPercent: "location-used-percent",
+	freeBytes: "location-free-bytes",
+	ownedBytes: "location-owned-bytes"
+};
+var DECLARATIONS = [
+	{
+		name: LOCATION_HISTORY_NAMES.usedPercent,
+		displayName: "Location volume used %",
+		unit: "%"
+	},
+	{
+		name: LOCATION_HISTORY_NAMES.freeBytes,
+		displayName: "Location volume free",
+		unit: "bytes"
+	},
+	{
+		name: LOCATION_HISTORY_NAMES.ownedBytes,
+		displayName: "Location held by CamStack",
+		unit: "bytes"
+	}
+];
+var LocationHistoryRecorder = class {
+	deps;
+	keys = /* @__PURE__ */ new Map();
+	lastAt = /* @__PURE__ */ new Map();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	async ensureDeclared() {
+		if (this.keys.size === DECLARATIONS.length) return true;
+		try {
+			for (const d of DECLARATIONS) {
+				const { key } = await this.deps.deviceHistory.declareSeries({
+					name: d.name,
+					subjectKind: "node",
+					kind: "gauge",
+					displayName: d.displayName,
+					ingest: "points",
+					unit: d.unit
+				});
+				this.keys.set(d.name, key);
+			}
+			return true;
+		} catch (err) {
+			this.keys.clear();
+			this.deps.logger.warn("storage: location history declare failed — retried next sweep", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			return false;
+		}
+	}
+	/** The points of one sweep; pure apart from the per-location rate memory. */
+	pointsOf(readings, at) {
+		const points = [];
+		for (const r of readings) {
+			const last = this.lastAt.get(r.locationId);
+			if (last !== void 0 && at >= last && at - last < 6e4) continue;
+			const add = (name, value) => {
+				const key = this.keys.get(name);
+				if (key === void 0 || !Number.isFinite(value)) return;
+				points.push({
+					key,
+					subject: {
+						kind: "node",
+						nodeId: r.nodeId
+					},
+					scope: r.locationId,
+					ts: at,
+					value
+				});
+			};
+			const before = points.length;
+			if (r.capacity !== null && r.capacity.totalBytes > 0) {
+				const used = r.capacity.totalBytes - r.capacity.availableBytes;
+				add(LOCATION_HISTORY_NAMES.usedPercent, Math.round(used / r.capacity.totalBytes * 1e3) / 10);
+				add(LOCATION_HISTORY_NAMES.freeBytes, r.capacity.availableBytes);
+			}
+			if (r.ownedBytes !== void 0) add(LOCATION_HISTORY_NAMES.ownedBytes, r.ownedBytes);
+			if (points.length > before) this.lastAt.set(r.locationId, at);
+		}
+		return points;
+	}
+	async record(readings, at) {
+		if (readings.length === 0 || !await this.ensureDeclared()) return;
+		const points = this.pointsOf(readings, at);
+		if (points.length === 0) return;
+		try {
+			const result = await this.deps.deviceHistory.record({ points });
+			if (result.refused.length > 0) {
+				if (result.refused.some((r) => r.reason === "undeclared")) this.keys.clear();
+				this.deps.logger.warn("storage: location history points refused", { meta: {
+					accepted: result.accepted,
+					refused: result.refused
+				} });
+			}
+		} catch (err) {
+			this.deps.logger.warn("storage: location history not stored", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+};
+//#endregion
 //#region src/builtins/storage-orchestrator/storage-orchestrator.addon.ts
 /**
 * `storage-orchestrator` builtin — singleton owner of the consumer-
@@ -4024,6 +4125,9 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		return this.occupancySlice;
 	}
 	pressureTimer = null;
+	/** Occupancy over time (device-history). Created with the timer that feeds it. */
+	locationHistory = null;
+	locationHistoryInFlight = false;
 	pressureSweepInFlight = false;
 	migration = null;
 	/** Guards every single-location repoint and arbitrates movers per physical root. */
@@ -4440,8 +4544,16 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 				}
 			}
 		});
+		this.locationHistory = new LocationHistoryRecorder({
+			deviceHistory: {
+				declareSeries: (input) => this.ctx.api.deviceHistory.declareSeries.mutate(input),
+				record: (input) => this.ctx.api.deviceHistory.record.mutate({ points: [...input.points] })
+			},
+			logger: this.ctx.logger
+		});
 		this.pressureTimer = setInterval(() => {
 			this.runPressureSweep();
+			this.recordLocationHistory();
 		}, PRESSURE_SWEEP_INTERVAL_MS);
 		this.ctx.logger.info("Storage orchestrator initialized");
 		return [
@@ -4588,6 +4700,37 @@ var StorageOrchestratorAddon = class extends require_dist.BaseAddon {
 		}
 	}
 	/**
+	* One occupancy reading per location this node can read, into device-history.
+	* The volume figures come from the same probe `listLocations` serves, the
+	* held bytes from the occupancy slice; an unknown figure is no point (D393).
+	*/
+	async recordLocationHistory() {
+		const svc = this.service;
+		const recorder = this.locationHistory;
+		if (!svc || !recorder || this.locationHistoryInFlight) return;
+		this.locationHistoryInFlight = true;
+		try {
+			this.occupancy.serveAndRevalidate();
+			const localNode = svc.getLocalNodeId();
+			const readings = [];
+			for (const loc of svc.listLocations()) {
+				if (!require_dist.mayReadLocation(loc) || (loc.nodeId ?? HUB_NODE_ID) !== localNode) continue;
+				const capacity = await this.localCapacityOf(loc).catch(() => null);
+				readings.push({
+					locationId: loc.id,
+					nodeId: localNode,
+					capacity,
+					ownedBytes: this.occupancy.ownedFor(loc.id)?.bytes
+				});
+			}
+			await recorder.record(readings, Date.now());
+		} catch (err) {
+			this.ctxIfReady?.logger.warn("storage: location history pass failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		} finally {
+			this.locationHistoryInFlight = false;
+		}
+	}
+	/**
 	* Sample free space for every managed location and emit NC band edges.
 	* A failed capacity read stays `null` and changes no band — never folded to 0 (D393).
 	*/

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

@@ -1,4 +1,4 @@
-import { $i as isSecretMarker, $r as BaseAddon, Bn as mayWriteToLocation, Cr as storageCapability, Fi as collectSecretConfigKeys, Ir as withLocationMode, K as LegacyStorageLocationDefaultSchema, Mn as legacyModeOf, Sa as transformSecretWrite, Ta as EventCategory, Tn as isLocationEnabled, Ui as defineRecordKinds, Un as modeMayWrite, _a as secretTreeFromPaths, _r as settingsStoreCapability, aa as normalizeNodeId, cn as evictionPolicyOfLocation, dt as StorageLocationModeSchema, ft as StorageLocationTypeSchema, gi as REDACTED_SECRET, gn as gbToBytes, ha as resolveSecretMarkers, pt as StorageMigrationJobSchema, sa as parseJsonObject, ur as resolveLocationMode, ut as StorageCleanupJobSchema, wr as storageMigrationCapability, zn as mayReadLocation } from "../../dist-BSF_C8W2.mjs";
+import { Dr as storageMigrationCapability, Er as storageCapability, Fn as legacyModeOf, Hn as mayReadLocation, Ki as defineRecordKinds, Kn as modeMayWrite, Oa as EventCategory, On as isLocationEnabled, Ri as collectSecretConfigKeys, Ta as transformSecretWrite, Un as mayWriteToLocation, ba as secretTreeFromPaths, br as settingsStoreCapability, ca as normalizeNodeId, dn as evictionPolicyOfLocation, ft as StorageCleanupJobSchema, ht as StorageMigrationJobSchema, mt as StorageLocationTypeSchema, na as isSecretMarker, ni as BaseAddon, pr as resolveLocationMode, pt as StorageLocationModeSchema, q as LegacyStorageLocationDefaultSchema, ua as parseJsonObject, va as resolveSecretMarkers, yi as REDACTED_SECRET, yn as gbToBytes, zr as withLocationMode } from "../../dist-Dhux90yB.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
@@ -3952,6 +3952,107 @@ var StorageLocationBandMonitor = class {
 	}
 };
 //#endregion
+//#region src/builtins/storage-orchestrator/location-history-recorder.ts
+var LOCATION_HISTORY_NAMES = {
+	usedPercent: "location-used-percent",
+	freeBytes: "location-free-bytes",
+	ownedBytes: "location-owned-bytes"
+};
+var DECLARATIONS = [
+	{
+		name: LOCATION_HISTORY_NAMES.usedPercent,
+		displayName: "Location volume used %",
+		unit: "%"
+	},
+	{
+		name: LOCATION_HISTORY_NAMES.freeBytes,
+		displayName: "Location volume free",
+		unit: "bytes"
+	},
+	{
+		name: LOCATION_HISTORY_NAMES.ownedBytes,
+		displayName: "Location held by CamStack",
+		unit: "bytes"
+	}
+];
+var LocationHistoryRecorder = class {
+	deps;
+	keys = /* @__PURE__ */ new Map();
+	lastAt = /* @__PURE__ */ new Map();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	async ensureDeclared() {
+		if (this.keys.size === DECLARATIONS.length) return true;
+		try {
+			for (const d of DECLARATIONS) {
+				const { key } = await this.deps.deviceHistory.declareSeries({
+					name: d.name,
+					subjectKind: "node",
+					kind: "gauge",
+					displayName: d.displayName,
+					ingest: "points",
+					unit: d.unit
+				});
+				this.keys.set(d.name, key);
+			}
+			return true;
+		} catch (err) {
+			this.keys.clear();
+			this.deps.logger.warn("storage: location history declare failed — retried next sweep", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			return false;
+		}
+	}
+	/** The points of one sweep; pure apart from the per-location rate memory. */
+	pointsOf(readings, at) {
+		const points = [];
+		for (const r of readings) {
+			const last = this.lastAt.get(r.locationId);
+			if (last !== void 0 && at >= last && at - last < 6e4) continue;
+			const add = (name, value) => {
+				const key = this.keys.get(name);
+				if (key === void 0 || !Number.isFinite(value)) return;
+				points.push({
+					key,
+					subject: {
+						kind: "node",
+						nodeId: r.nodeId
+					},
+					scope: r.locationId,
+					ts: at,
+					value
+				});
+			};
+			const before = points.length;
+			if (r.capacity !== null && r.capacity.totalBytes > 0) {
+				const used = r.capacity.totalBytes - r.capacity.availableBytes;
+				add(LOCATION_HISTORY_NAMES.usedPercent, Math.round(used / r.capacity.totalBytes * 1e3) / 10);
+				add(LOCATION_HISTORY_NAMES.freeBytes, r.capacity.availableBytes);
+			}
+			if (r.ownedBytes !== void 0) add(LOCATION_HISTORY_NAMES.ownedBytes, r.ownedBytes);
+			if (points.length > before) this.lastAt.set(r.locationId, at);
+		}
+		return points;
+	}
+	async record(readings, at) {
+		if (readings.length === 0 || !await this.ensureDeclared()) return;
+		const points = this.pointsOf(readings, at);
+		if (points.length === 0) return;
+		try {
+			const result = await this.deps.deviceHistory.record({ points });
+			if (result.refused.length > 0) {
+				if (result.refused.some((r) => r.reason === "undeclared")) this.keys.clear();
+				this.deps.logger.warn("storage: location history points refused", { meta: {
+					accepted: result.accepted,
+					refused: result.refused
+				} });
+			}
+		} catch (err) {
+			this.deps.logger.warn("storage: location history not stored", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+};
+//#endregion
 //#region src/builtins/storage-orchestrator/storage-orchestrator.addon.ts
 /**
 * `storage-orchestrator` builtin — singleton owner of the consumer-
@@ -4019,6 +4120,9 @@ var StorageOrchestratorAddon = class extends BaseAddon {
 		return this.occupancySlice;
 	}
 	pressureTimer = null;
+	/** Occupancy over time (device-history). Created with the timer that feeds it. */
+	locationHistory = null;
+	locationHistoryInFlight = false;
 	pressureSweepInFlight = false;
 	migration = null;
 	/** Guards every single-location repoint and arbitrates movers per physical root. */
@@ -4435,8 +4539,16 @@ var StorageOrchestratorAddon = class extends BaseAddon {
 				}
 			}
 		});
+		this.locationHistory = new LocationHistoryRecorder({
+			deviceHistory: {
+				declareSeries: (input) => this.ctx.api.deviceHistory.declareSeries.mutate(input),
+				record: (input) => this.ctx.api.deviceHistory.record.mutate({ points: [...input.points] })
+			},
+			logger: this.ctx.logger
+		});
 		this.pressureTimer = setInterval(() => {
 			this.runPressureSweep();
+			this.recordLocationHistory();
 		}, PRESSURE_SWEEP_INTERVAL_MS);
 		this.ctx.logger.info("Storage orchestrator initialized");
 		return [
@@ -4583,6 +4695,37 @@ var StorageOrchestratorAddon = class extends BaseAddon {
 		}
 	}
 	/**
+	* One occupancy reading per location this node can read, into device-history.
+	* The volume figures come from the same probe `listLocations` serves, the
+	* held bytes from the occupancy slice; an unknown figure is no point (D393).
+	*/
+	async recordLocationHistory() {
+		const svc = this.service;
+		const recorder = this.locationHistory;
+		if (!svc || !recorder || this.locationHistoryInFlight) return;
+		this.locationHistoryInFlight = true;
+		try {
+			this.occupancy.serveAndRevalidate();
+			const localNode = svc.getLocalNodeId();
+			const readings = [];
+			for (const loc of svc.listLocations()) {
+				if (!mayReadLocation(loc) || (loc.nodeId ?? HUB_NODE_ID) !== localNode) continue;
+				const capacity = await this.localCapacityOf(loc).catch(() => null);
+				readings.push({
+					locationId: loc.id,
+					nodeId: localNode,
+					capacity,
+					ownedBytes: this.occupancy.ownedFor(loc.id)?.bytes
+				});
+			}
+			await recorder.record(readings, Date.now());
+		} catch (err) {
+			this.ctxIfReady?.logger.warn("storage: location history pass failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		} finally {
+			this.locationHistoryInFlight = false;
+		}
+	}
+	/**
 	* Sample free space for every managed location and emit NC band edges.
 	* A failed capacity read stays `null` and changes no band — never folded to 0 (D393).
 	*/

package/dist/builtins/system-config/system-config.addon.js

@@ -3,11 +3,11 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BpqA2CT0.js");
+const require_dist = require("../../dist-C89nqNnn.js");
 const require_safe_buffer$1 = require("../../safe-buffer-D3aoa-7X.js");
 const require_x509_es = require("../../x509.es-C4cOo48M.js");
-const require_constants$8 = require("../../constants-CavyKfHZ.js");
-const require_agent_https = require("../../agent-https-yjxdfJDA.js");
+const require_constants$8 = require("../../constants-B_X9cWEK.js");
+const require_agent_https = require("../../agent-https-CoyOZ3pC.js");
 const require_src$1 = require("../../src-CnAqG6EF.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,9 +1,9 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM, r as __exportAll, t as __commonJSMin } from "../../chunk-CNf5ZN-e.mjs";
-import { $r as BaseAddon, Bi as customAction, Hi as defineCustomActions, Ji as hydrateSchema, Qr as errMsg, ct as ServerNameSchema, vr as shortHostname } from "../../dist-BSF_C8W2.mjs";
+import { Gi as defineCustomActions, Ui as customAction, Zi as hydrateSchema, ni as BaseAddon, ti as errMsg, ut as ServerNameSchema, xr as shortHostname } from "../../dist-Dhux90yB.mjs";
 import { t as require_safe_buffer } from "../../safe-buffer-B1OjL1I9.mjs";
 import { c as Pkcs10CertificateRequest } from "../../x509.es-DK__ETIe.mjs";
-import { a as MESH_CA_KEY_REF, i as MESH_CA_FIELD, n as DEFAULT_HUB_TLS_TCP_PORT, o as MESH_CA_SETTINGS_KEY } from "../../constants-i5oD_gLB.mjs";
-import { $ as generateMeshCa, B as setProcessAgentHttpsNames, H as MESH_NODE_CERTIFICATES_COLLECTION, I as AGENT_HTTPS_NAMES_COLLECTION, J as setProcessMeshCertificateRegistry, K as describeMeshLeaf, L as AGENT_HTTPS_NAMES_COLUMNS, M as isLocalOnlyHostname, Q as exportMeshPrivateKeyPem, R as AgentHttpsNames, U as MESH_NODE_CERTIFICATES_COLUMNS, V as systemConfigRecordKinds, W as MeshCertificateRegistry, X as caFingerprintCompact, Z as createMeshCsrPem, at as subjectCn, et as generateMeshKeyPair, it as loadMeshCa, nt as issueMeshLeafForNode, rt as issueMeshLeafFromCsr, tt as isValidAgentNodeId, u as isPrivateAddress, z as getProcessAgentHttpsNames } from "../../agent-https-fm4AR8XL.mjs";
+import { a as MESH_CA_KEY_REF, i as MESH_CA_FIELD, n as DEFAULT_HUB_TLS_TCP_PORT, o as MESH_CA_SETTINGS_KEY } from "../../constants-cxKcZRMi.mjs";
+import { $ as generateMeshCa, B as setProcessAgentHttpsNames, H as MESH_NODE_CERTIFICATES_COLLECTION, I as AGENT_HTTPS_NAMES_COLLECTION, J as setProcessMeshCertificateRegistry, K as describeMeshLeaf, L as AGENT_HTTPS_NAMES_COLUMNS, M as isLocalOnlyHostname, Q as exportMeshPrivateKeyPem, R as AgentHttpsNames, U as MESH_NODE_CERTIFICATES_COLUMNS, V as systemConfigRecordKinds, W as MeshCertificateRegistry, X as caFingerprintCompact, Z as createMeshCsrPem, at as subjectCn, et as generateMeshKeyPair, it as loadMeshCa, nt as issueMeshLeafForNode, rt as issueMeshLeafFromCsr, tt as isValidAgentNodeId, u as isPrivateAddress, z as getProcessAgentHttpsNames } from "../../agent-https-CK9Z4sSR.mjs";
 import { t as require_src } from "../../src-hG4grMU4.mjs";
 import { z } from "zod";
 import { X509Certificate, createHash, createPrivateKey, randomBytes, randomInt, sign, timingSafeEqual, verify, webcrypto } from "node:crypto";