@camstack/system 1.2.455 → 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-DjQ8C-ku.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 { $t as enumerateInferenceDevices, Kn as platformProbeCapability, Kr as errMsg, qr as BaseAddon, ur as scoreRuntimes, ya as EventCategory, zi as emitReadiness } from "../../dist-BpSENkRJ.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-DjQ8C-ku.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 { Si as UnknownRecordKindError, Yn as recordEntriesCapability, Zi as mapSecretLeaves, qr as BaseAddon, ri as InvalidRecordError, sa as recordSecretRef } from "../../dist-BpSENkRJ.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-DjQ8C-ku.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 { qr as BaseAddon, ya as EventCategory } from "../../dist-BpSENkRJ.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-DjQ8C-ku.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 { Fn as memoizePinnedFfmpeg, Gr as DeviceType, Kr as errMsg, Qi as nodePin, Sr as streamQualityLabel, Ur as DeviceFeature, Wt as deriveBatteryPresence, bt as bareAddonId, mr as snapshotCapability, qr as BaseAddon, s as BatteryStatusSchema, xt as batteryCapability, ya as EventCategory } from "../../dist-BpSENkRJ.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-DjQ8C-ku.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 { br as storageProviderCapability, qr as BaseAddon, sn as filesystemBrowseCapability } from "../../dist-BpSENkRJ.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-Bl0ZKjVR.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-TyuOEVy1.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/records/records-engine-types.d.ts

@@ -14,6 +14,7 @@ export interface RecordsEngineOps extends OwnedOps {
 	/** Every kind this file holds, with rows and a size estimate (System -> Data). */
 	listKinds(input: {
 		readonly owner?: string | undefined;
+		readonly counts?: boolean | undefined;
 	}): Promise<readonly StorageKind[]>;
 	/** Delete rows past `expires_at`, in batches. */
 	sweepExpired(input: {

package/dist/builtins/sqlite-storage/records/records-provider.d.ts

@@ -29,6 +29,19 @@ export declare class RecordsProvider implements IRecordsProvider, AdminRecords {
 	init(): Promise<void>;
 	private fileOf;
 	declareKinds(input: Parameters<IRecordsProvider["declareKinds"]>[0]): ReturnType<IRecordsProvider["declareKinds"]>;
+	/**
+	* Rows of a legacy table in EVERY open records-capable file. A legacy table lives
+	* in one file, but which one is the layout's business: the phase-3 NC ledgers moved
+	* to `events.db` with the P5 split, and a guard that asked `camstack.db` alone
+	* answered "no legacy rows" for 522 outbox rows (2026-10-20 audit).
+	*/
+	private legacyRowsAnywhere;
+	/**
+	* `transactFamily` (plan risk 8): kinds that must agree through one `transact` sit
+	* in ONE file. A family split across files is refused whole, whether the split is
+	* inside this declaration or against a kind of the same owner declared before.
+	*/
+	private assertFamiliesInOneFile;
 	/** The boot guard: empty kind + a legacy table that still has rows = adoption pending. */
 	private withAdoption;
 	get(input: Parameters<IRecordsProvider["get"]>[0]): ReturnType<IRecordsProvider["get"]>;

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-DjQ8C-ku.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-Bl0ZKjVR.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");
@@ -1349,8 +1349,10 @@ var RecordsProvider = class {
 	async declareKinds(input) {
 		const owner = recordsCallerOf(input);
 		const byDatabase = /* @__PURE__ */ new Map();
-		for (const [kind, raw] of Object.entries(input.kinds)) {
-			const declaration = require_dist.RecordKindDeclarationSchema.parse(raw);
+		const parsed = /* @__PURE__ */ new Map();
+		for (const [kind, raw] of Object.entries(input.kinds)) parsed.set(kind, require_dist.RecordKindDeclarationSchema.parse(raw));
+		await this.assertFamiliesInOneFile(owner, parsed);
+		for (const [kind, declaration] of parsed) {
 			const known = this.placement.get(keyOf(owner, kind));
 			if (known !== void 0 && known !== declaration.database) throw new require_dist.DeclarationRefusedError(`kind "${kind}" of "${owner}" lives in "${known}", declared for "${declaration.database}" - the engine never moves data`);
 			const group = byDatabase.get(declaration.database) ?? {};
@@ -1372,6 +1374,50 @@ var RecordsProvider = class {
 		}
 		return { kinds: await this.withAdoption(owner, input.kinds, merged) };
 	}
+	/**
+	* Rows of a legacy table in EVERY open records-capable file. A legacy table lives
+	* in one file, but which one is the layout's business: the phase-3 NC ledgers moved
+	* to `events.db` with the P5 split, and a guard that asked `camstack.db` alone
+	* answered "no legacy rows" for 522 outbox rows (2026-10-20 audit).
+	*/
+	async legacyRowsAnywhere(table) {
+		let total = 0;
+		for (const file of this.router.openFiles()) {
+			if (file.databaseId === "history") continue;
+			const rows = await file.records("legacyRowCount", { table });
+			if (rows !== null) total += rows;
+		}
+		return total;
+	}
+	/**
+	* `transactFamily` (plan risk 8): kinds that must agree through one `transact` sit
+	* in ONE file. A family split across files is refused whole, whether the split is
+	* inside this declaration or against a kind of the same owner declared before.
+	*/
+	async assertFamiliesInOneFile(owner, declared) {
+		const families = /* @__PURE__ */ new Map();
+		const note = (family, kind, database) => {
+			const members = families.get(family) ?? /* @__PURE__ */ new Map();
+			members.set(kind, database);
+			families.set(family, members);
+		};
+		for (const file of this.router.openFiles()) {
+			if (file.databaseId === "history") continue;
+			for (const k of await file.records("listKinds", {
+				owner,
+				counts: false
+			})) {
+				if (k.state === "dropped" || declared.has(k.kind)) continue;
+				const family = k.declaration.transactFamily;
+				if (family !== void 0) note(family, k.kind, file.databaseId);
+			}
+		}
+		for (const [kind, declaration] of declared) if (declaration.transactFamily !== void 0) note(declaration.transactFamily, kind, declaration.database);
+		for (const [family, members] of families) {
+			if (new Set(members.values()).size <= 1) continue;
+			throw new require_dist.DeclarationRefusedError(`transactFamily "${family}" of "${owner}" is split across files (${[...members.entries()].map(([k, db]) => `${k}@${db}`).join(", ")}); a family lives in ONE file`);
+		}
+	}
 	/** The boot guard: empty kind + a legacy table that still has rows = adoption pending. */
 	async withAdoption(owner, declared, results) {
 		const out = { ...results };
@@ -1407,8 +1453,8 @@ var RecordsProvider = class {
 				};
 				continue;
 			}
-			const legacyRows = await (await this.router.recordsFileFor("settings")).records("legacyRowCount", { table: legacy });
-			if (legacyRows !== null && legacyRows > 0) out[kind] = {
+			const legacyRows = await this.legacyRowsAnywhere(legacy);
+			if (legacyRows > 0) out[kind] = {
 				...result,
 				adoptionPending: {
 					legacyTable: legacy,

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

@@ -1,6 +1,6 @@
-import { $ as STORAGE_ADMIN_MOVED_COLLECTIONS, $r as DeclarationRefusedError, Bt as databaseSnapshotCapability, C as DATA_STORE_DATABASES, Kr as errMsg, S as DATABASE_SNAPSHOT_TIMEOUT_MS, Si as UnknownRecordKindError, Xn as recordsCapability, aa as parseSettingsBrokersAdoptsFrom, b as DATABASE_SNAPSHOT_PARTIAL_SUFFIX, bt as bareAddonId, ea as normalizeSecretOwner, et as STORAGE_ADMIN_SCOPED_BASES, fi as RUNTIME_DEFAULTS, gr as storageAdminCapability, hi as RecordKindDeclarationSchema, ia as parseSettingsArrayAdoptsFrom, ii as NoCallerError, kr as vectorStoreCapability, li as RECORD_SWEEP_INTERVAL_MS, qr as BaseAddon, x as DATABASE_SNAPSHOT_SUFFIX, zt as dataStoreProviderCapability } from "../../dist-BpSENkRJ.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-TyuOEVy1.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";
@@ -1343,8 +1343,10 @@ var RecordsProvider = class {
 	async declareKinds(input) {
 		const owner = recordsCallerOf(input);
 		const byDatabase = /* @__PURE__ */ new Map();
-		for (const [kind, raw] of Object.entries(input.kinds)) {
-			const declaration = RecordKindDeclarationSchema.parse(raw);
+		const parsed = /* @__PURE__ */ new Map();
+		for (const [kind, raw] of Object.entries(input.kinds)) parsed.set(kind, RecordKindDeclarationSchema.parse(raw));
+		await this.assertFamiliesInOneFile(owner, parsed);
+		for (const [kind, declaration] of parsed) {
 			const known = this.placement.get(keyOf(owner, kind));
 			if (known !== void 0 && known !== declaration.database) throw new DeclarationRefusedError(`kind "${kind}" of "${owner}" lives in "${known}", declared for "${declaration.database}" - the engine never moves data`);
 			const group = byDatabase.get(declaration.database) ?? {};
@@ -1366,6 +1368,50 @@ var RecordsProvider = class {
 		}
 		return { kinds: await this.withAdoption(owner, input.kinds, merged) };
 	}
+	/**
+	* Rows of a legacy table in EVERY open records-capable file. A legacy table lives
+	* in one file, but which one is the layout's business: the phase-3 NC ledgers moved
+	* to `events.db` with the P5 split, and a guard that asked `camstack.db` alone
+	* answered "no legacy rows" for 522 outbox rows (2026-10-20 audit).
+	*/
+	async legacyRowsAnywhere(table) {
+		let total = 0;
+		for (const file of this.router.openFiles()) {
+			if (file.databaseId === "history") continue;
+			const rows = await file.records("legacyRowCount", { table });
+			if (rows !== null) total += rows;
+		}
+		return total;
+	}
+	/**
+	* `transactFamily` (plan risk 8): kinds that must agree through one `transact` sit
+	* in ONE file. A family split across files is refused whole, whether the split is
+	* inside this declaration or against a kind of the same owner declared before.
+	*/
+	async assertFamiliesInOneFile(owner, declared) {
+		const families = /* @__PURE__ */ new Map();
+		const note = (family, kind, database) => {
+			const members = families.get(family) ?? /* @__PURE__ */ new Map();
+			members.set(kind, database);
+			families.set(family, members);
+		};
+		for (const file of this.router.openFiles()) {
+			if (file.databaseId === "history") continue;
+			for (const k of await file.records("listKinds", {
+				owner,
+				counts: false
+			})) {
+				if (k.state === "dropped" || declared.has(k.kind)) continue;
+				const family = k.declaration.transactFamily;
+				if (family !== void 0) note(family, k.kind, file.databaseId);
+			}
+		}
+		for (const [kind, declaration] of declared) if (declaration.transactFamily !== void 0) note(declaration.transactFamily, kind, declaration.database);
+		for (const [family, members] of families) {
+			if (new Set(members.values()).size <= 1) continue;
+			throw new DeclarationRefusedError(`transactFamily "${family}" of "${owner}" is split across files (${[...members.entries()].map(([k, db]) => `${k}@${db}`).join(", ")}); a family lives in ONE file`);
+		}
+	}
 	/** The boot guard: empty kind + a legacy table that still has rows = adoption pending. */
 	async withAdoption(owner, declared, results) {
 		const out = { ...results };
@@ -1401,8 +1447,8 @@ var RecordsProvider = class {
 				};
 				continue;
 			}
-			const legacyRows = await (await this.router.recordsFileFor("settings")).records("legacyRowCount", { table: legacy });
-			if (legacyRows !== null && legacyRows > 0) out[kind] = {
+			const legacyRows = await this.legacyRowsAnywhere(legacy);
+			if (legacyRows > 0) out[kind] = {
 				...result,
 				adoptionPending: {
 					legacyTable: legacy,

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-DjQ8C-ku.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).
 	*/