@camstack/system 1.2.457 → 1.2.458

package/dist/builtins/device-history/device-history.addon.mjs

@@ -1,4 +1,236 @@
-import { B as HISTORY_CATALOG, O as DEVICE_HISTORY_ENERGY_KEY, Oa as EventCategory, Tt as armRemovalReconcile, di as HISTORY_DEFAULT_MIN_INTERVAL_MS, ei as DeviceType, in as deviceRemovalHookCapability, ni as BaseAddon, nn as deviceHistoryCapability } from "../../dist-Dhux90yB.mjs";
+import { B as HISTORY_CATALOG, Ji as emitReadiness, O as DEVICE_HISTORY_ENERGY_KEY, Oa as EventCategory, Tt as armRemovalReconcile, di as HISTORY_DEFAULT_MIN_INTERVAL_MS, ei as DeviceType, in as deviceRemovalHookCapability, ni as BaseAddon, nn as deviceHistoryCapability } from "../../dist-B_GRPhnY.mjs";
+//#region src/builtins/device-history/time/bucket-time.ts
+/**
+* Bucket arithmetic for the three rollup tiers (D850, plan §4/§5.5).
+*
+* 5m and 1h buckets are aligned to UTC; a 1d bucket starts at HUB-LOCAL
+* midnight, so a day is 23, 24 or 25 hours long across a DST change (operator
+* answer Q4). Pure: the zone is the process zone (`TZ`), nothing is read from
+* the environment here.
+*/
+var FIVE_MINUTES_MS = 5 * 6e4;
+var HOUR_MS = 60 * 6e4;
+var DAY_MS = 24 * HOUR_MS;
+function floorTo(ts, widthMs) {
+	return Math.floor(ts / widthMs) * widthMs;
+}
+/** Hub-local midnight at or before `ts`. */
+function startOfLocalDay(ts) {
+	const d = new Date(ts);
+	d.setHours(0, 0, 0, 0);
+	return d.getTime();
+}
+/** The local midnight following the local midnight `dayStart`. */
+function nextLocalDayStart(dayStart) {
+	const d = new Date(dayStart);
+	d.setDate(d.getDate() + 1);
+	d.setHours(0, 0, 0, 0);
+	return d.getTime();
+}
+/** Start of the `tier` bucket containing `ts`. */
+function bucketStartOf(tier, ts) {
+	if (tier === "5m") return floorTo(ts, FIVE_MINUTES_MS);
+	if (tier === "1h") return floorTo(ts, HOUR_MS);
+	return startOfLocalDay(ts);
+}
+/** Exclusive end of the `tier` bucket that starts at `start`. */
+function bucketEndOf(tier, start) {
+	if (tier === "5m") return start + FIVE_MINUTES_MS;
+	if (tier === "1h") return start + HOUR_MS;
+	return nextLocalDayStart(start);
+}
+/** Quiet time after a bucket closes before it is rolled up (late writers). */
+var ROLLUP_GRACE_MS = {
+	"5m": 3e4,
+	"1h": 5 * 6e4,
+	"1d": 15 * 6e4
+};
+//#endregion
+//#region src/builtins/device-history/retention/departure-tracker.ts
+var DEPARTED_ABSENCE_MS = 7 * DAY_MS;
+var DepartureTracker = class {
+	store;
+	registry;
+	logger;
+	missing = /* @__PURE__ */ new Map();
+	constructor(store, registry, logger) {
+		this.store = store;
+		this.registry = registry;
+		this.logger = logger;
+	}
+	async load() {
+		this.missing = await this.store.loadDepartures();
+	}
+	missingSince(deviceId) {
+		return this.missing.get(deviceId);
+	}
+	/** Forget a device's clock — its series were removed because it was DELETED (D865). */
+	async forget(deviceId) {
+		await this.store.clearMissing([deviceId]);
+		const next = new Map(this.missing);
+		next.delete(deviceId);
+		this.missing = next;
+	}
+	/** Feed one SUCCESSFUL listing. A failed read never reaches here. */
+	async observe(listed, now) {
+		const withSeries = new Set(this.registry.all().flatMap((s) => s.deviceId === null ? [] : [s.deviceId]));
+		const back = [...this.missing.keys()].filter((id) => listed.has(id));
+		const gone = [...withSeries].filter((id) => !listed.has(id) && !this.missing.has(id));
+		try {
+			await this.store.clearMissing(back);
+			await this.store.markMissing(gone, now);
+		} catch (err) {
+			this.logger.warn("device-history: departure clock not written", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			return;
+		}
+		const next = new Map(this.missing);
+		for (const id of back) next.delete(id);
+		for (const id of gone) next.set(id, now);
+		this.missing = next;
+	}
+};
+//#endregion
+//#region src/builtins/device-history/retention/retention.ts
+var DEFAULT_RETENTION = {
+	rawDays: 7,
+	fiveMinuteDays: 30,
+	hourDays: 365,
+	dayDays: null
+};
+/** Cutoff per tier: rows strictly older are deleted. `null` = keep forever. */
+function retentionCutoffs(policy, now) {
+	return {
+		raw: now - policy.rawDays * DAY_MS,
+		"5m": now - policy.fiveMinuteDays * DAY_MS,
+		"1h": now - policy.hourDays * DAY_MS,
+		"1d": policy.dayDays === null || policy.dayDays <= 0 ? null : now - policy.dayDays * DAY_MS
+	};
+}
+var TIERS = [
+	"raw",
+	"5m",
+	"1h",
+	"1d"
+];
+var RETENTION_STEP_MS = {
+	raw: HOUR_MS,
+	"5m": HOUR_MS,
+	"1h": DAY_MS,
+	"1d": DAY_MS
+};
+var MAX_PURGES_PER_RUN = 20;
+/** Width of one delete statement's time range, per tier. */
+var SLICE_MS = {
+	raw: DAY_MS,
+	"5m": DAY_MS,
+	"1h": 30 * DAY_MS,
+	"1d": 30 * DAY_MS
+};
+/** A bucket's start may precede the series' first point by up to a day. */
+var BUCKET_LEAD_MS = 2 * DAY_MS;
+/** The short tiers hold nothing older than this unless the operator configured more. */
+var SHORT_TIER_LOOKBACK_MS = 400 * DAY_MS;
+var yieldToEventLoop = () => new Promise((resolve) => setImmediate(resolve));
+var RetentionJob = class {
+	deps;
+	appliedUpTo = /* @__PURE__ */ new Map();
+	running = null;
+	constructor(deps) {
+		this.deps = deps;
+	}
+	run(policy, now) {
+		if (this.running !== null) return this.running;
+		const run = this.doRun(policy, now).finally(() => {
+			this.running = null;
+		});
+		this.running = run;
+		return run;
+	}
+	async doRun(policy, now) {
+		const { registry, counters, logger } = this.deps;
+		const cutoffs = retentionCutoffs(policy, now);
+		try {
+			for (const tier of TIERS) {
+				const cutoff = cutoffs[tier];
+				if (cutoff === null) continue;
+				for (const series of registry.all()) {
+					if (series.firstTs - 864e5 >= cutoff) continue;
+					if (tier === "raw" && registry.metric(series.key)?.ingest === "buckets") continue;
+					const marker = `${tier}:${series.id}`;
+					const applied = this.appliedUpTo.get(marker);
+					if (applied !== void 0 && cutoff - applied < RETENTION_STEP_MS[tier]) continue;
+					const lo = Math.max(0, applied === void 0 ? series.firstTs - BUCKET_LEAD_MS : applied - RETENTION_STEP_MS[tier]);
+					counters.addDeleted(tier, await this.deleteSliced(tier, series.id, lo, cutoff - 1));
+					this.appliedUpTo.set(marker, cutoff);
+				}
+			}
+			await this.purgeDeparted(now);
+			counters.retentionLastRunAt = now;
+		} catch (err) {
+			logger.warn("device-history: retention pass failed — retried at the next run", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+	/** Delete `[lo, hiInclusive]` of one tier in time slices, yielding between them. */
+	/** Drop the visit markers of a purged series. */
+	forgetSeries(seriesId) {
+		for (const tier of TIERS) this.appliedUpTo.delete(`${tier}:${seriesId}`);
+	}
+	async deleteSliced(tier, seriesId, lo, hiInclusive) {
+		const yieldNow = this.deps.yieldNow ?? yieldToEventLoop;
+		let deleted = 0;
+		for (let from = lo; from <= hiInclusive; from += SLICE_MS[tier]) {
+			const to = Math.min(from + SLICE_MS[tier] - 1, hiInclusive);
+			deleted += await this.deps.store.deleteRange(tier, seriesId, from, to);
+			await yieldNow();
+		}
+		return deleted;
+	}
+	/** Tier by tier in slices, then the series row (and whatever the slices missed). */
+	async purgeSeries(series, now) {
+		for (const tier of TIERS) {
+			const lo = tier === "raw" || tier === "5m" ? Math.max(series.firstTs - BUCKET_LEAD_MS, now - SHORT_TIER_LOOKBACK_MS) : series.firstTs - BUCKET_LEAD_MS;
+			await this.deleteSliced(tier, series.id, Math.max(0, lo), now + DAY_MS);
+		}
+		await this.deps.store.deleteSeries(series.id);
+	}
+	/**
+	* Delete every series of a DELETED device now (D865). Driven by a tombstone
+	* through the `device-removal-hook`, never by a listing: the week-long
+	* absence clock above remains the backstop for a device removed before
+	* tombstones existed.
+	*/
+	async purgeDevice(deviceId, now) {
+		const { registry, counters } = this.deps;
+		let purged = 0;
+		for (const series of registry.all()) {
+			if (series.deviceId !== deviceId) continue;
+			await this.purgeSeries(series, now);
+			registry.remove(series.id);
+			counters.purgedSeries += 1;
+			purged += 1;
+		}
+		return purged;
+	}
+	async purgeDeparted(now) {
+		const { registry, departures, counters, logger } = this.deps;
+		let purged = 0;
+		for (const series of registry.all()) {
+			if (purged >= MAX_PURGES_PER_RUN) break;
+			if (series.deviceId === null) continue;
+			const since = departures.missingSince(series.deviceId);
+			if (since === void 0 || now - since < DEPARTED_ABSENCE_MS) continue;
+			await this.purgeSeries(series, now);
+			registry.remove(series.id);
+			counters.purgedSeries += 1;
+			purged += 1;
+			logger.info("device-history: purged the series of an unregistered device", {
+				tags: { deviceId: series.deviceId },
+				meta: { key: series.key }
+			});
+		}
+	}
+};
+//#endregion
 //#region src/builtins/device-history/store/series-registry.ts
 function subjectIdOf(subject) {
 	return subject.kind === "device" ? `d:${subject.deviceId}` : `n:${subject.nodeId}`;
@@ -730,52 +962,27 @@ var PointWriter = class {
 	}
 };
 //#endregion
-//#region src/builtins/device-history/time/bucket-time.ts
+//#region src/builtins/device-history/ingest/producer-ingest.ts
+/** One point per series per this many ms, sustained. */
+var RECORD_MIN_INTERVAL_MS = 1e4;
 /**
-* Bucket arithmetic for the three rollup tiers (D850, plan §4/§5.5).
-*
-* 5m and 1h buckets are aligned to UTC; a 1d bucket starts at HUB-LOCAL
-* midnight, so a day is 23, 24 or 25 hours long across a DST change (operator
-* answer Q4). Pure: the zone is the process zone (`TZ`), nothing is read from
-* the environment here.
+* The slot after accepting a point at `ts`. A point older than the newest
+* accepted one (a late arrival) moves nothing. Otherwise the consumed slot is
+* the later of the one that was due and `ts` itself: an early point uses the
+* due slot (the grid holds, so slack never compounds into a higher rate), a
+* late one restarts the grid at `ts` (no credit is banked for a gap).
 */
-var FIVE_MINUTES_MS = 5 * 6e4;
-var HOUR_MS = 60 * 6e4;
-var DAY_MS = 24 * HOUR_MS;
-function floorTo(ts, widthMs) {
-	return Math.floor(ts / widthMs) * widthMs;
-}
-/** Hub-local midnight at or before `ts`. */
-function startOfLocalDay(ts) {
-	const d = new Date(ts);
-	d.setHours(0, 0, 0, 0);
-	return d.getTime();
-}
-/** The local midnight following the local midnight `dayStart`. */
-function nextLocalDayStart(dayStart) {
-	const d = new Date(dayStart);
-	d.setDate(d.getDate() + 1);
-	d.setHours(0, 0, 0, 0);
-	return d.getTime();
-}
-/** Start of the `tier` bucket containing `ts`. */
-function bucketStartOf(tier, ts) {
-	if (tier === "5m") return floorTo(ts, FIVE_MINUTES_MS);
-	if (tier === "1h") return floorTo(ts, HOUR_MS);
-	return startOfLocalDay(ts);
-}
-/** Exclusive end of the `tier` bucket that starts at `start`. */
-function bucketEndOf(tier, start) {
-	if (tier === "5m") return start + FIVE_MINUTES_MS;
-	if (tier === "1h") return start + HOUR_MS;
-	return nextLocalDayStart(start);
+function nextSlot(slot, ts) {
+	if (slot === void 0) return {
+		lastTs: ts,
+		nextDue: ts + RECORD_MIN_INTERVAL_MS
+	};
+	if (ts < slot.lastTs) return slot;
+	return {
+		lastTs: ts,
+		nextDue: Math.max(slot.nextDue, ts) + RECORD_MIN_INTERVAL_MS
+	};
 }
-/** Quiet time after a bucket closes before it is rolled up (late writers). */
-var ROLLUP_GRACE_MS = {
-	"5m": 3e4,
-	"1h": 5 * 6e4,
-	"1d": 15 * 6e4
-};
 function addRefusal(refusals, key, reason) {
 	const byReason = refusals.get(key) ?? /* @__PURE__ */ new Map();
 	byReason.set(reason, (byReason.get(reason) ?? 0) + 1);
@@ -793,7 +1000,7 @@ function toResult(accepted, refusals) {
 }
 var ProducerIngest = class {
 	deps;
-	/** Last accepted point time per series, for the sustained-rate bound. */
+	/** Rate state per series identity, for the sustained-rate bound. */
 	lastAccepted = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deps = deps;
@@ -852,13 +1059,13 @@ var ProducerIngest = class {
 				continue;
 			}
 			const identity = identityOf(point.key, subjectIdOf(point.subject), point.scope);
-			const last = this.lastAccepted.get(identity);
-			if (last !== void 0 && point.ts >= last && point.ts - last < 1e4) {
+			const slot = this.lastAccepted.get(identity);
+			if (slot !== void 0 && point.ts >= slot.lastTs && point.ts < slot.nextDue - 1e3) {
 				addRefusal(refusals, point.key, "rate");
 				counters.refuse("rate");
 				continue;
 			}
-			this.lastAccepted.set(identity, Math.max(last ?? point.ts, point.ts));
+			this.lastAccepted.set(identity, nextSlot(slot, point.ts));
 			this.deps.writer.enqueue({
 				key: point.key,
 				subject: point.subject,
@@ -1319,191 +1526,6 @@ function withoutRaw(tiers) {
 	return rollups.length > 0 ? rollups : ["5m"];
 }
 //#endregion
-//#region src/builtins/device-history/retention/departure-tracker.ts
-var DEPARTED_ABSENCE_MS = 7 * DAY_MS;
-var DepartureTracker = class {
-	store;
-	registry;
-	logger;
-	missing = /* @__PURE__ */ new Map();
-	constructor(store, registry, logger) {
-		this.store = store;
-		this.registry = registry;
-		this.logger = logger;
-	}
-	async load() {
-		this.missing = await this.store.loadDepartures();
-	}
-	missingSince(deviceId) {
-		return this.missing.get(deviceId);
-	}
-	/** Forget a device's clock — its series were removed because it was DELETED (D865). */
-	async forget(deviceId) {
-		await this.store.clearMissing([deviceId]);
-		const next = new Map(this.missing);
-		next.delete(deviceId);
-		this.missing = next;
-	}
-	/** Feed one SUCCESSFUL listing. A failed read never reaches here. */
-	async observe(listed, now) {
-		const withSeries = new Set(this.registry.all().flatMap((s) => s.deviceId === null ? [] : [s.deviceId]));
-		const back = [...this.missing.keys()].filter((id) => listed.has(id));
-		const gone = [...withSeries].filter((id) => !listed.has(id) && !this.missing.has(id));
-		try {
-			await this.store.clearMissing(back);
-			await this.store.markMissing(gone, now);
-		} catch (err) {
-			this.logger.warn("device-history: departure clock not written", { meta: { error: err instanceof Error ? err.message : String(err) } });
-			return;
-		}
-		const next = new Map(this.missing);
-		for (const id of back) next.delete(id);
-		for (const id of gone) next.set(id, now);
-		this.missing = next;
-	}
-};
-//#endregion
-//#region src/builtins/device-history/retention/retention.ts
-var DEFAULT_RETENTION = {
-	rawDays: 7,
-	fiveMinuteDays: 30,
-	hourDays: 365,
-	dayDays: null
-};
-/** Cutoff per tier: rows strictly older are deleted. `null` = keep forever. */
-function retentionCutoffs(policy, now) {
-	return {
-		raw: now - policy.rawDays * DAY_MS,
-		"5m": now - policy.fiveMinuteDays * DAY_MS,
-		"1h": now - policy.hourDays * DAY_MS,
-		"1d": policy.dayDays === null || policy.dayDays <= 0 ? null : now - policy.dayDays * DAY_MS
-	};
-}
-var TIERS = [
-	"raw",
-	"5m",
-	"1h",
-	"1d"
-];
-var RETENTION_STEP_MS = {
-	raw: HOUR_MS,
-	"5m": HOUR_MS,
-	"1h": DAY_MS,
-	"1d": DAY_MS
-};
-var MAX_PURGES_PER_RUN = 20;
-/** Width of one delete statement's time range, per tier. */
-var SLICE_MS = {
-	raw: DAY_MS,
-	"5m": DAY_MS,
-	"1h": 30 * DAY_MS,
-	"1d": 30 * DAY_MS
-};
-/** A bucket's start may precede the series' first point by up to a day. */
-var BUCKET_LEAD_MS = 2 * DAY_MS;
-/** The short tiers hold nothing older than this unless the operator configured more. */
-var SHORT_TIER_LOOKBACK_MS = 400 * DAY_MS;
-var yieldToEventLoop = () => new Promise((resolve) => setImmediate(resolve));
-var RetentionJob = class {
-	deps;
-	appliedUpTo = /* @__PURE__ */ new Map();
-	running = null;
-	constructor(deps) {
-		this.deps = deps;
-	}
-	run(policy, now) {
-		if (this.running !== null) return this.running;
-		const run = this.doRun(policy, now).finally(() => {
-			this.running = null;
-		});
-		this.running = run;
-		return run;
-	}
-	async doRun(policy, now) {
-		const { registry, counters, logger } = this.deps;
-		const cutoffs = retentionCutoffs(policy, now);
-		try {
-			for (const tier of TIERS) {
-				const cutoff = cutoffs[tier];
-				if (cutoff === null) continue;
-				for (const series of registry.all()) {
-					if (series.firstTs - 864e5 >= cutoff) continue;
-					if (tier === "raw" && registry.metric(series.key)?.ingest === "buckets") continue;
-					const marker = `${tier}:${series.id}`;
-					const applied = this.appliedUpTo.get(marker);
-					if (applied !== void 0 && cutoff - applied < RETENTION_STEP_MS[tier]) continue;
-					const lo = Math.max(0, applied === void 0 ? series.firstTs - BUCKET_LEAD_MS : applied - RETENTION_STEP_MS[tier]);
-					counters.addDeleted(tier, await this.deleteSliced(tier, series.id, lo, cutoff - 1));
-					this.appliedUpTo.set(marker, cutoff);
-				}
-			}
-			await this.purgeDeparted(now);
-			counters.retentionLastRunAt = now;
-		} catch (err) {
-			logger.warn("device-history: retention pass failed — retried at the next run", { meta: { error: err instanceof Error ? err.message : String(err) } });
-		}
-	}
-	/** Delete `[lo, hiInclusive]` of one tier in time slices, yielding between them. */
-	/** Drop the visit markers of a purged series. */
-	forgetSeries(seriesId) {
-		for (const tier of TIERS) this.appliedUpTo.delete(`${tier}:${seriesId}`);
-	}
-	async deleteSliced(tier, seriesId, lo, hiInclusive) {
-		const yieldNow = this.deps.yieldNow ?? yieldToEventLoop;
-		let deleted = 0;
-		for (let from = lo; from <= hiInclusive; from += SLICE_MS[tier]) {
-			const to = Math.min(from + SLICE_MS[tier] - 1, hiInclusive);
-			deleted += await this.deps.store.deleteRange(tier, seriesId, from, to);
-			await yieldNow();
-		}
-		return deleted;
-	}
-	/** Tier by tier in slices, then the series row (and whatever the slices missed). */
-	async purgeSeries(series, now) {
-		for (const tier of TIERS) {
-			const lo = tier === "raw" || tier === "5m" ? Math.max(series.firstTs - BUCKET_LEAD_MS, now - SHORT_TIER_LOOKBACK_MS) : series.firstTs - BUCKET_LEAD_MS;
-			await this.deleteSliced(tier, series.id, Math.max(0, lo), now + DAY_MS);
-		}
-		await this.deps.store.deleteSeries(series.id);
-	}
-	/**
-	* Delete every series of a DELETED device now (D865). Driven by a tombstone
-	* through the `device-removal-hook`, never by a listing: the week-long
-	* absence clock above remains the backstop for a device removed before
-	* tombstones existed.
-	*/
-	async purgeDevice(deviceId, now) {
-		const { registry, counters } = this.deps;
-		let purged = 0;
-		for (const series of registry.all()) {
-			if (series.deviceId !== deviceId) continue;
-			await this.purgeSeries(series, now);
-			registry.remove(series.id);
-			counters.purgedSeries += 1;
-			purged += 1;
-		}
-		return purged;
-	}
-	async purgeDeparted(now) {
-		const { registry, departures, counters, logger } = this.deps;
-		let purged = 0;
-		for (const series of registry.all()) {
-			if (purged >= MAX_PURGES_PER_RUN) break;
-			if (series.deviceId === null) continue;
-			const since = departures.missingSince(series.deviceId);
-			if (since === void 0 || now - since < DEPARTED_ABSENCE_MS) continue;
-			await this.purgeSeries(series, now);
-			registry.remove(series.id);
-			counters.purgedSeries += 1;
-			purged += 1;
-			logger.info("device-history: purged the series of an unregistered device", {
-				tags: { deviceId: series.deviceId },
-				meta: { key: series.key }
-			});
-		}
-	}
-};
-//#endregion
 //#region src/builtins/device-history/store/history-schema.ts
 var HISTORY_NAMESPACE = "device-history";
 var COLLECTIONS = {
@@ -2966,6 +2988,13 @@ var HistoryRuntime = class {
 * are hub capabilities, and a forked runner cannot call them from
 * `onInitialize`. Until then the provider answers "starting" rather than an
 * empty history (an unanswered query is not an empty one, D315).
+*
+* Readiness follows the STORE, not the registration: the provider registers at
+* `onInitialize`, but `ready` is emitted only once the runtime is open in
+* `onHubReachable` (`autoEmitReadiness` is off). Producers declare their
+* series on `ready`; the automatic emit at registration sent every one of
+* them into "device-history is starting" on each boot (`.50`, 1.2.607:
+* metrics-native and pipeline-analytics).
 */
 var DEFAULT_CONFIG = {
 	rawDays: DEFAULT_RETENTION.rawDays,
@@ -2989,9 +3018,40 @@ var DeviceHistoryAddon = class extends BaseAddon {
 	runtime = null;
 	unsubscribe = null;
 	removalHook = null;
+	/** This instance's readiness generation (the base class keeps its own private). */
+	readinessGeneration = `device-history-${Date.now().toString(36)}`;
 	constructor() {
 		super({ ...DEFAULT_CONFIG });
 	}
+	/** `ready` is the store being open, emitted by {@link emitStoreReadiness}. */
+	get autoEmitReadiness() {
+		return false;
+	}
+	/** Readiness of both provided caps, on the bare node this runner belongs to. */
+	emitStoreReadiness(state) {
+		const ctx = this.ctxIfReady;
+		if (ctx === null) return;
+		const raw = ctx.kernel?.localNodeId ?? "hub";
+		const nodeId = raw.includes("/") ? raw.split("/")[0] ?? raw : raw;
+		for (const capName of [deviceHistoryCapability.name, deviceRemovalHookCapability.name]) try {
+			emitReadiness(ctx.eventBus, {
+				capName,
+				scope: {
+					type: "node",
+					nodeId
+				},
+				state,
+				generation: this.readinessGeneration,
+				sourceNodeId: nodeId
+			});
+		} catch (err) {
+			ctx.logger.warn("device-history: readiness not emitted", { meta: {
+				capName,
+				state,
+				error: err instanceof Error ? err.message : String(err)
+			} });
+		}
+	}
 	retention() {
 		const c = this.config;
 		return {
@@ -3037,6 +3097,7 @@ var DeviceHistoryAddon = class extends BaseAddon {
 			setDeviceEnabled: async (input) => ({ enabled: await this.requireRuntime().setEnabled(input.deviceId, input.enabled) }),
 			getStatus: async () => this.requireRuntime().status()
 		};
+		this.emitStoreReadiness("starting");
 		this.ctx.logger.info("Initialized — device-history provider registered (store opens on hub link)");
 		const removalHook = {
 			onDeviceRemoved: async (input) => {
@@ -3113,6 +3174,7 @@ var DeviceHistoryAddon = class extends BaseAddon {
 			logger: this.ctx.logger,
 			remove: (input) => removalHook.onDeviceRemoved(input)
 		}));
+		this.emitStoreReadiness("ready");
 		this.ctx.logger.info("device-history: capturing", { meta: {
 			series: runtime.status().series,
 			metrics: runtime.status().metrics
@@ -3124,6 +3186,7 @@ var DeviceHistoryAddon = class extends BaseAddon {
 		await this.runtime?.stop();
 	}
 	async onShutdown() {
+		this.emitStoreReadiness("down");
 		await this.stopRuntime();
 		this.runtime = null;
 	}

package/dist/builtins/device-history/ingest/producer-ingest.d.ts

@@ -21,6 +21,16 @@ import type { HistoryStore } from "../store/history-store.js";
 import { type SeriesRegistry } from "../store/series-registry.js";
 /** One point per series per this many ms, sustained. */
 export declare const RECORD_MIN_INTERVAL_MS: number;
+/**
+* How early a point may land against its series' next slot. A producer on a
+* `setInterval` at exactly {@link RECORD_MIN_INTERVAL_MS} stamps `Date.now()`
+* on each tick, and a tick lands a few ms EARLY as often as late; a bare
+* `ts - last < interval` refused every early tick's whole batch (`.50`:
+* `accepted: 0, refused: { rate: 141 }`). The slack is borrowed from the slot
+* grid, never added to the rate: the next slot advances from the slot this
+* point consumed, so a faster producer is still held to one point per interval.
+*/
+export declare const RECORD_RATE_SLACK_MS: number;
 /** A point or bucket may be at most this far in the future (clock skew). */
 export declare const FUTURE_TOLERANCE_MS: number;
 export interface DeclareSeriesInput {
@@ -68,7 +78,7 @@ export interface IngestDeps {
 }
 export declare class ProducerIngest {
 	private readonly deps;
-	/** Last accepted point time per series, for the sustained-rate bound. */
+	/** Rate state per series identity, for the sustained-rate bound. */
 	private readonly lastAccepted;
 	constructor(deps: IngestDeps);
 	/** A purged series leaves no rate-limit state behind. */

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-C89nqNnn.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
 const require_prefix_range = require("../../prefix-range-D_KueXbQ.js");
 const require_prefix_walk = require("../../prefix-walk-Dv6MLZlM.js");

package/dist/builtins/device-manager/device-manager.addon.mjs

@@ -1,4 +1,4 @@
-import { $r as DeviceRole, Ea as userError, F as DeviceStatusSchema, I as DeviceTombstoneSchema, It as canonicalIconKey, Ki as defineRecordKinds, Kt as createDeviceExtensionProvider, Mi as WELL_KNOWN_TAB_MAP, Nt as buildStreamParamsConfigSchema, Oa as EventCategory, Pn as legacyAutoLinkIds, Qi as isDeviceConfigCap, Qn as parseStreamParamsFormPatch, Qr as DeviceFeature, R as FieldClaimModeSchema, Rn as locationIconKey, Sa as sleep$1, Sr as siteZoneKey, T as DAY_NAMES, Ta as transformSecretWrite, Vi as collectZodSecretPaths, Y as MINUTES_PER_DAY, Yn as normalizeUnit, Zt as defineExtensionSlotProvider, an as deviceStateCapability, ba as secretTreeFromPaths, c as CAMERA_SWITCH_ORDER, cn as enumerateItemArrayFields, ct as STREAM_PROFILE_META, ea as isKeychainStoredField, ei as DeviceType, fn as expandContainer, gr as runtimeStatePolicyFor, ki as SECRET_CLEAR, ln as enumerateSchemaFields, na as isSecretMarker, ni as BaseAddon, on as deviceStatusCapability, r as ALL_CAPABILITY_DEFINITIONS, ra as isSecretMarkerLike, rn as deviceManagerCapability, ta as isSecretClear, ti as errMsg, tn as deviceExtensionCapability, u as CAP_NAMES_WITH_STATUS, va as resolveSecretMarkers, vn as formatMinutes, wa as toSecretFieldView, z as FieldClaimSchema } from "../../dist-Dhux90yB.mjs";
+import { $r as DeviceRole, Ea as userError, F as DeviceStatusSchema, I as DeviceTombstoneSchema, It as canonicalIconKey, Ki as defineRecordKinds, Kt as createDeviceExtensionProvider, Mi as WELL_KNOWN_TAB_MAP, Nt as buildStreamParamsConfigSchema, Oa as EventCategory, Pn as legacyAutoLinkIds, Qi as isDeviceConfigCap, Qn as parseStreamParamsFormPatch, Qr as DeviceFeature, R as FieldClaimModeSchema, Rn as locationIconKey, Sa as sleep$1, Sr as siteZoneKey, T as DAY_NAMES, Ta as transformSecretWrite, Vi as collectZodSecretPaths, Y as MINUTES_PER_DAY, Yn as normalizeUnit, Zt as defineExtensionSlotProvider, an as deviceStateCapability, ba as secretTreeFromPaths, c as CAMERA_SWITCH_ORDER, cn as enumerateItemArrayFields, ct as STREAM_PROFILE_META, ea as isKeychainStoredField, ei as DeviceType, fn as expandContainer, gr as runtimeStatePolicyFor, ki as SECRET_CLEAR, ln as enumerateSchemaFields, na as isSecretMarker, ni as BaseAddon, on as deviceStatusCapability, r as ALL_CAPABILITY_DEFINITIONS, ra as isSecretMarkerLike, rn as deviceManagerCapability, ta as isSecretClear, ti as errMsg, tn as deviceExtensionCapability, u as CAP_NAMES_WITH_STATUS, va as resolveSecretMarkers, vn as formatMinutes, wa as toSecretFieldView, z as FieldClaimSchema } from "../../dist-B_GRPhnY.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
 import { t as prefixRange } from "../../prefix-range-Dl0znowN.mjs";
 import { t as loadPrefixed } from "../../prefix-walk-DAOBSyH1.mjs";

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-C89nqNnn.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { ni as BaseAddon, zn as logDestinationCapability } from "../../dist-Dhux90yB.mjs";
+import { ni as BaseAddon, zn as logDestinationCapability } from "../../dist-B_GRPhnY.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/keychain/index.js

@@ -3,11 +3,11 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-C89nqNnn.js");
+const require_dist = require("../../dist-BZQjLPiz.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
-const require_device_ca = require("../../device-ca-CVK3YcR_.js");
-const require_phase6_declare_gate = require("../../phase6-declare-gate-BO-_jLh_.js");
-const require_constants = require("../../constants-B_X9cWEK.js");
+const require_device_ca = require("../../device-ca-BrVK_5s3.js");
+const require_phase6_declare_gate = require("../../phase6-declare-gate-Dag1_WR2.js");
+const require_constants = require("../../constants-Njka8Cv6.js");
 const require_platform_key_source = require("../../platform-key-source-Di7HrlGR.js");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");