@camstack/system 1.2.107 → 1.2.109

package/dist/builtins/sqlite-storage/sqlite-settings-backend.d.ts

@@ -20,6 +20,11 @@ interface SettingsUpdateWhereInput {
 interface SettingsUpdateWhereResult {
     readonly updated: number;
 }
+/** What {@link SqliteSettingsBackend.dropRetiredTable} destroyed. */
+export interface DroppedTable {
+    /** Rows the table held at the moment it was dropped. */
+    readonly rows: number;
+}
 /**
  * SQLite implementation of ISettingsBackend.
  *
@@ -213,6 +218,23 @@ export declare class SqliteSettingsBackend implements ISettingsBackend {
     /** Serialise per-column values for SQL binding: objects → JSON, booleans → 0/1. */
     private serializeColumnValue;
     private ensureTable;
+    /**
+     * Drop a table nothing declares any more, reporting what went with it.
+     *
+     * The DDL lives here because the engine owns the handle AND the two memos
+     * that outlive a table: `structuredTables` (schema fingerprint) and
+     * `declaredCollections` (the column set `compileFilter` resolves against).
+     * Dropping behind their backs would leave a ghost — a later declaration of
+     * the same name would be memoised as "already materialised" against a table
+     * that no longer exists.
+     *
+     * WHICH tables are retired, and the logging, are policy: they live in
+     * `retired-collections.ts`. This method knows only how to drop one.
+     *
+     * Answers `null` when the table is not there — the steady state after the
+     * first boot that ran the purge, and the case on a fresh install.
+     */
+    dropRetiredTable(table: string): DroppedTable | null;
     private tableInsert;
     private tableUpdate;
     private tableDelete;

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

@@ -4,6 +4,7 @@ Object.defineProperties(exports, {
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
 const require_dist = require("../../dist-Ctfhlrtl.js");
+const require_retired_settings_keys = require("../../retired-settings-keys-pNmoHPTg.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 let node_module = require("node:module");
@@ -84,174 +85,70 @@ var SQLITE_MMAP_SIZE_BYTES = 268435456;
 */
 var SQLITE_JOURNAL_SIZE_LIMIT_BYTES = 67108864;
 //#endregion
-//#region src/builtins/sqlite-storage/retired-settings-keys.ts
+//#region src/builtins/sqlite-storage/retired-collections.ts
 /**
-* Is THIS node the one whose settings store is the cluster's authority?
+* The dead tables.
 *
-* Mirrors `resolveNodeRole` (server/backend `node-role.ts`) — unset or `'hub'`
-* means hub, which is the launcher's own default. It is duplicated rather than
-* imported because `@camstack/system` is a dependency OF the backend, not the
-* other way round; the parse is four lines and the env var is the contract.
-*
-* Anything else answers `false`. Skipping where the purge should have run is a
-* missed cleanup the next hub boot fixes; running where it should not have is a
-* write to a store this node does not own. Only one of those is recoverable.
+* `devices` / `device_settings_kv` — the device half of the
+* integration-registry ([D183](../../../../../docs/decisions/adr-0183.md)).
+* The registry's INTEGRATION half is live (`integrations`,
+* `integration_settings`); its device half never had a production caller and
+* never had a row. The fleet lives in `device-manager:devices`, under numeric
+* ids, while these tables key on `dev_NNNN` — the two id-spaces could not be
+* reconciled even if something had wanted to.
 */
-function settingsStoreIsAuthoritativeHere(env) {
-	const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
-	return raw === "" || raw === "hub";
-}
-/**
-* The dead keys, per row.
-*
-* `detection-pipeline` / `addon-settings` / `root` — every key in this row is
-* dead; the row itself is kept because the addon writes live keys into it
-* (`pipelineTemplates`, `videoPipelineSteps`).
-*
-*  - `pipelineSteps` / `pipelineEngine`: the persisted GLOBAL step + engine
-*    seed. Removed with `getGlobalSteps` becoming pure — dispatch builds steps
-*    from the orchestrator's `agentSettings` plus per-camera overrides, and
-*    never consulted the seed. See `addon-pipeline/src/detection-pipeline/provider.ts`.
-*  - `engineRuntime` / `engineBackend` / `engineDevice` / `probedBestEngine`:
-*    the per-node engine CASCADE, removed with the operator-facing engine
-*    election. Each node now runs a device-array of inference pools balanced
-*    per session, and the node-default pool derives live from the node's own
-*    hardware (`resolveAutoEngine`). See
-*    `addon-pipeline/src/detection-pipeline/engine-store-keys.ts`.
-*/
-var RETIRED_SETTINGS_KEYS = [{
-	namespace: "detection-pipeline",
-	collection: "addon-settings",
-	row: "root",
-	keys: ["pipelineSteps", "pipelineEngine"],
-	perNodeKeys: [
-		"engineRuntime",
-		"engineBackend",
-		"engineDevice",
-		"probedBestEngine"
-	],
-	reason: "global step/engine seed and the per-node engine cascade — both removed; the live per-camera dispatch path never read either"
+var RETIRED_COLLECTIONS = [{
+	collection: "devices",
+	owner: "integration-registry",
+	reason: "the device half of the integration-registry is deleted; the fleet is `device-manager:devices` and always was (0 rows here against 974 live devices)"
 }, {
-	namespace: "device-manager",
-	collection: "addon-settings",
-	row: "deviceMeta",
-	keys: [],
-	perNodeKeys: [],
-	mapValueKeys: ["deviceLinks"],
-	reason: "cross-device field wiring, deleted 2026-08-08 — 0 links across 302 devices a month after the UI shipped. There is no reader left: the resolver, the overlay, the cycle guard, the fifth binding kind and the tab are gone"
+	collection: "device_settings_kv",
+	owner: "integration-registry",
+	reason: "per-device settings of a device table that never had a row; the live per-camera store is the device-manager row plus `addon-device-settings`"
 }];
 /**
-* Adapt the settings backend to {@link RetiredKeyStore}.
+* Adapt the SQLite engine to {@link RetiredCollectionStore}.
 *
-* `get` answering a non-object (missing row) is a MISS, not a fault: it maps to
-* `null` and the purge skips the row. A backend throw propagates, which is what
-* routes it to the "read failed, row left untouched" branch.
+* The DDL itself is the engine's — it owns the handle and the memos a drop has
+* to evict. This module owns only the list and the reporting.
 */
-function retiredKeyStoreOf(backend) {
-	return {
-		async read(spec) {
-			return require_dist.asJsonObject(await backend.get({
-				namespace: spec.namespace,
-				collection: spec.collection,
-				key: spec.row
-			}));
-		},
-		async write(spec, value) {
-			await backend.set({
-				namespace: spec.namespace,
-				collection: spec.collection,
-				key: spec.row,
-				value
-			});
-		}
-	};
+function retiredCollectionStoreOf(backend) {
+	return { async drop(collection) {
+		return backend.dropRetiredTable(collection);
+	} };
 }
 /**
-* Nested `<mapKey>.<retiredKey>` paths that `spec` retires inside a map-shaped
-* row. Pure. Values that are not plain objects are skipped, never rewritten.
+* Drop every retired table that is still present. Returns one entry per table
+* actually dropped — empty when the schema is already clean, which is the
+* steady state after the first boot that ran it.
 */
-function planNestedRetiredKeyPurge(blob, spec) {
-	const nestedKeys = spec.mapValueKeys ?? [];
-	if (nestedKeys.length === 0) return [];
-	const found = [];
-	for (const [mapKey, value] of Object.entries(blob)) {
-		const inner = require_dist.asJsonObject(value);
-		if (inner === null) continue;
-		for (const retired of nestedKeys) if (retired in inner) found.push(`${mapKey}.${retired}`);
-	}
-	return found;
-}
-/** Keys of `blob` that `spec` retires. Pure. */
-function planRetiredKeyPurge(blob, spec) {
-	const exact = new Set(spec.keys);
-	const found = [];
-	for (const key of Object.keys(blob)) {
-		if (exact.has(key)) {
-			found.push(key);
-			continue;
-		}
-		for (const perNode of spec.perNodeKeys) if (key === perNode || key.startsWith(`${perNode}@`)) {
-			found.push(key);
-			break;
-		}
-	}
-	return found;
-}
-/**
-* Delete every retired key present in the declared rows — on the hub.
-*
-* Off the authoritative node this is a no-op that touches nothing and says
-* nothing (see the module header). Returns one entry per row that actually
-* changed — empty when the store is already clean, which is the steady state
-* after the first boot that ran it.
-*/
-async function purgeRetiredSettingsKeys(store, logger, specs = RETIRED_SETTINGS_KEYS, env = process.env) {
-	if (!settingsStoreIsAuthoritativeHere(env)) return [];
+async function purgeRetiredCollections(store, logger, specs = RETIRED_COLLECTIONS) {
 	const results = [];
 	for (const spec of specs) {
-		let blob;
+		let dropped;
 		try {
-			blob = await store.read(spec);
+			dropped = await store.drop(spec.collection);
 		} catch (err) {
-			logger.warn("retired settings keys — read failed, row left untouched", { meta: {
-				addon: spec.namespace,
+			logger.warn("retired collection — drop failed, table left in place", { meta: {
+				addon: spec.owner,
 				collection: spec.collection,
-				row: spec.row,
 				error: err instanceof Error ? err.message : String(err)
 			} });
 			continue;
 		}
-		if (blob === null) continue;
-		const doomed = planRetiredKeyPurge(blob, spec);
-		const doomedNested = planNestedRetiredKeyPurge(blob, spec);
-		if (doomed.length === 0 && doomedNested.length === 0) continue;
-		const doomedSet = new Set(doomed);
-		const nestedByMapKey = /* @__PURE__ */ new Map();
-		for (const path of doomedNested) {
-			const cut = path.indexOf(".");
-			const mapKey = path.slice(0, cut);
-			const inner = path.slice(cut + 1);
-			const bucket = nestedByMapKey.get(mapKey) ?? /* @__PURE__ */ new Set();
-			bucket.add(inner);
-			nestedByMapKey.set(mapKey, bucket);
-		}
-		const next = Object.fromEntries(Object.entries(blob).filter(([key]) => !doomedSet.has(key)).map(([key, value]) => {
-			const retired = nestedByMapKey.get(key);
-			if (retired === void 0) return [key, value];
-			const inner = require_dist.asJsonObject(value);
-			if (inner === null) return [key, value];
-			return [key, Object.fromEntries(Object.entries(inner).filter(([k]) => !retired.has(k)))];
-		}));
-		await store.write(spec, next);
+		if (dropped === null) continue;
 		const result = {
-			addon: spec.namespace,
 			collection: spec.collection,
-			row: spec.row,
-			keys: doomed,
-			nested: doomedNested
+			owner: spec.owner,
+			rows: dropped.rows
 		};
 		results.push(result);
-		logger.info(`purged ${doomed.length + doomedNested.length} retired settings keys`, { meta: {
+		const line = "dropped a retired collection";
+		if (dropped.rows > 0) logger.warn(`${line} — it still held rows`, { meta: {
+			...result,
+			reason: spec.reason
+		} });
+		else logger.info(line, { meta: {
 			...result,
 			reason: spec.reason
 		} });
@@ -464,6 +361,9 @@ function isImposedBound(source) {
 }
 //#endregion
 //#region src/builtins/sqlite-storage/sqlite-settings-backend.ts
+function isCountRow(raw) {
+	return raw !== null && typeof raw === "object" && typeof Reflect.get(raw, "n") === "number";
+}
 function parseRowData(raw) {
 	return require_dist.asJsonObject(require_dist.parseJsonUnknown(raw)) ?? {};
 }
@@ -1191,6 +1091,31 @@ var SqliteSettingsBackend = class SqliteSettingsBackend {
 		}
 		this.structuredTables.set(table, fingerprint);
 	}
+	/**
+	* Drop a table nothing declares any more, reporting what went with it.
+	*
+	* The DDL lives here because the engine owns the handle AND the two memos
+	* that outlive a table: `structuredTables` (schema fingerprint) and
+	* `declaredCollections` (the column set `compileFilter` resolves against).
+	* Dropping behind their backs would leave a ghost — a later declaration of
+	* the same name would be memoised as "already materialised" against a table
+	* that no longer exists.
+	*
+	* WHICH tables are retired, and the logging, are policy: they live in
+	* `retired-collections.ts`. This method knows only how to drop one.
+	*
+	* Answers `null` when the table is not there — the steady state after the
+	* first boot that ran the purge, and the case on a fresh install.
+	*/
+	dropRetiredTable(table) {
+		if (this.getDb().prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?`).get(table) === void 0) return null;
+		const counted = this.getDb().prepare(`SELECT COUNT(*) AS n FROM "${table}"`).get();
+		const rows = isCountRow(counted) ? counted.n : 0;
+		this.getDb().exec(`DROP TABLE "${table}"`);
+		this.structuredTables.delete(table);
+		this.declaredCollections.delete(table);
+		return { rows };
+	}
 	async tableInsert(table, row) {
 		const keys = Object.keys(row);
 		const cols = keys.map((k) => `"${k}"`).join(", ");
@@ -1823,10 +1748,11 @@ var SqliteSettingsAddon = class extends require_dist.BaseAddon {
 		this.backend = new SqliteSettingsBackend(dbPath, { ...require_dist.RUNTIME_DEFAULTS }, this.ctx.logger.child("Query"));
 		await this.backend.initialize();
 		try {
-			await purgeRetiredSettingsKeys(retiredKeyStoreOf(this.backend), this.ctx.logger.child("RetiredKeys"));
+			await require_retired_settings_keys.purgeRetiredSettingsKeys(require_retired_settings_keys.retiredKeyStoreOf(this.backend), this.ctx.logger.child("RetiredKeys"));
 		} catch (err) {
 			this.ctx.logger.warn("Retired-key purge failed", { meta: { error: require_dist.errMsg(err) } });
 		}
+		await purgeRetiredCollections(retiredCollectionStoreOf(this.backend), this.ctx.logger.child("RetiredCollections"));
 		const vectorIndex = this.createVectorIndex(this.backend);
 		await vectorIndex.loadIndexRegistry();
 		this.vectorIndex = vectorIndex;

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

@@ -1,4 +1,5 @@
 import { A as dataStoreProviderCapability, Bt as parseJsonUnknown, _t as vectorStoreCapability, f as RUNTIME_DEFAULTS, gt as vectorDimFromBase64, j as decodeVectorBase64, kt as asJsonObject, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-_oC_QkQA.mjs";
+import { r as retiredKeyStoreOf, t as purgeRetiredSettingsKeys } from "../../retired-settings-keys-Bsjf7HQ-.mjs";
 import { createRequire } from "node:module";
 import { randomUUID } from "node:crypto";
 import { statSync } from "node:fs";
@@ -78,174 +79,70 @@ var SQLITE_MMAP_SIZE_BYTES = 268435456;
 */
 var SQLITE_JOURNAL_SIZE_LIMIT_BYTES = 67108864;
 //#endregion
-//#region src/builtins/sqlite-storage/retired-settings-keys.ts
+//#region src/builtins/sqlite-storage/retired-collections.ts
 /**
-* Is THIS node the one whose settings store is the cluster's authority?
+* The dead tables.
 *
-* Mirrors `resolveNodeRole` (server/backend `node-role.ts`) — unset or `'hub'`
-* means hub, which is the launcher's own default. It is duplicated rather than
-* imported because `@camstack/system` is a dependency OF the backend, not the
-* other way round; the parse is four lines and the env var is the contract.
-*
-* Anything else answers `false`. Skipping where the purge should have run is a
-* missed cleanup the next hub boot fixes; running where it should not have is a
-* write to a store this node does not own. Only one of those is recoverable.
+* `devices` / `device_settings_kv` — the device half of the
+* integration-registry ([D183](../../../../../docs/decisions/adr-0183.md)).
+* The registry's INTEGRATION half is live (`integrations`,
+* `integration_settings`); its device half never had a production caller and
+* never had a row. The fleet lives in `device-manager:devices`, under numeric
+* ids, while these tables key on `dev_NNNN` — the two id-spaces could not be
+* reconciled even if something had wanted to.
 */
-function settingsStoreIsAuthoritativeHere(env) {
-	const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
-	return raw === "" || raw === "hub";
-}
-/**
-* The dead keys, per row.
-*
-* `detection-pipeline` / `addon-settings` / `root` — every key in this row is
-* dead; the row itself is kept because the addon writes live keys into it
-* (`pipelineTemplates`, `videoPipelineSteps`).
-*
-*  - `pipelineSteps` / `pipelineEngine`: the persisted GLOBAL step + engine
-*    seed. Removed with `getGlobalSteps` becoming pure — dispatch builds steps
-*    from the orchestrator's `agentSettings` plus per-camera overrides, and
-*    never consulted the seed. See `addon-pipeline/src/detection-pipeline/provider.ts`.
-*  - `engineRuntime` / `engineBackend` / `engineDevice` / `probedBestEngine`:
-*    the per-node engine CASCADE, removed with the operator-facing engine
-*    election. Each node now runs a device-array of inference pools balanced
-*    per session, and the node-default pool derives live from the node's own
-*    hardware (`resolveAutoEngine`). See
-*    `addon-pipeline/src/detection-pipeline/engine-store-keys.ts`.
-*/
-var RETIRED_SETTINGS_KEYS = [{
-	namespace: "detection-pipeline",
-	collection: "addon-settings",
-	row: "root",
-	keys: ["pipelineSteps", "pipelineEngine"],
-	perNodeKeys: [
-		"engineRuntime",
-		"engineBackend",
-		"engineDevice",
-		"probedBestEngine"
-	],
-	reason: "global step/engine seed and the per-node engine cascade — both removed; the live per-camera dispatch path never read either"
+var RETIRED_COLLECTIONS = [{
+	collection: "devices",
+	owner: "integration-registry",
+	reason: "the device half of the integration-registry is deleted; the fleet is `device-manager:devices` and always was (0 rows here against 974 live devices)"
 }, {
-	namespace: "device-manager",
-	collection: "addon-settings",
-	row: "deviceMeta",
-	keys: [],
-	perNodeKeys: [],
-	mapValueKeys: ["deviceLinks"],
-	reason: "cross-device field wiring, deleted 2026-08-08 — 0 links across 302 devices a month after the UI shipped. There is no reader left: the resolver, the overlay, the cycle guard, the fifth binding kind and the tab are gone"
+	collection: "device_settings_kv",
+	owner: "integration-registry",
+	reason: "per-device settings of a device table that never had a row; the live per-camera store is the device-manager row plus `addon-device-settings`"
 }];
 /**
-* Adapt the settings backend to {@link RetiredKeyStore}.
+* Adapt the SQLite engine to {@link RetiredCollectionStore}.
 *
-* `get` answering a non-object (missing row) is a MISS, not a fault: it maps to
-* `null` and the purge skips the row. A backend throw propagates, which is what
-* routes it to the "read failed, row left untouched" branch.
+* The DDL itself is the engine's — it owns the handle and the memos a drop has
+* to evict. This module owns only the list and the reporting.
 */
-function retiredKeyStoreOf(backend) {
-	return {
-		async read(spec) {
-			return asJsonObject(await backend.get({
-				namespace: spec.namespace,
-				collection: spec.collection,
-				key: spec.row
-			}));
-		},
-		async write(spec, value) {
-			await backend.set({
-				namespace: spec.namespace,
-				collection: spec.collection,
-				key: spec.row,
-				value
-			});
-		}
-	};
+function retiredCollectionStoreOf(backend) {
+	return { async drop(collection) {
+		return backend.dropRetiredTable(collection);
+	} };
 }
 /**
-* Nested `<mapKey>.<retiredKey>` paths that `spec` retires inside a map-shaped
-* row. Pure. Values that are not plain objects are skipped, never rewritten.
+* Drop every retired table that is still present. Returns one entry per table
+* actually dropped — empty when the schema is already clean, which is the
+* steady state after the first boot that ran it.
 */
-function planNestedRetiredKeyPurge(blob, spec) {
-	const nestedKeys = spec.mapValueKeys ?? [];
-	if (nestedKeys.length === 0) return [];
-	const found = [];
-	for (const [mapKey, value] of Object.entries(blob)) {
-		const inner = asJsonObject(value);
-		if (inner === null) continue;
-		for (const retired of nestedKeys) if (retired in inner) found.push(`${mapKey}.${retired}`);
-	}
-	return found;
-}
-/** Keys of `blob` that `spec` retires. Pure. */
-function planRetiredKeyPurge(blob, spec) {
-	const exact = new Set(spec.keys);
-	const found = [];
-	for (const key of Object.keys(blob)) {
-		if (exact.has(key)) {
-			found.push(key);
-			continue;
-		}
-		for (const perNode of spec.perNodeKeys) if (key === perNode || key.startsWith(`${perNode}@`)) {
-			found.push(key);
-			break;
-		}
-	}
-	return found;
-}
-/**
-* Delete every retired key present in the declared rows — on the hub.
-*
-* Off the authoritative node this is a no-op that touches nothing and says
-* nothing (see the module header). Returns one entry per row that actually
-* changed — empty when the store is already clean, which is the steady state
-* after the first boot that ran it.
-*/
-async function purgeRetiredSettingsKeys(store, logger, specs = RETIRED_SETTINGS_KEYS, env = process.env) {
-	if (!settingsStoreIsAuthoritativeHere(env)) return [];
+async function purgeRetiredCollections(store, logger, specs = RETIRED_COLLECTIONS) {
 	const results = [];
 	for (const spec of specs) {
-		let blob;
+		let dropped;
 		try {
-			blob = await store.read(spec);
+			dropped = await store.drop(spec.collection);
 		} catch (err) {
-			logger.warn("retired settings keys — read failed, row left untouched", { meta: {
-				addon: spec.namespace,
+			logger.warn("retired collection — drop failed, table left in place", { meta: {
+				addon: spec.owner,
 				collection: spec.collection,
-				row: spec.row,
 				error: err instanceof Error ? err.message : String(err)
 			} });
 			continue;
 		}
-		if (blob === null) continue;
-		const doomed = planRetiredKeyPurge(blob, spec);
-		const doomedNested = planNestedRetiredKeyPurge(blob, spec);
-		if (doomed.length === 0 && doomedNested.length === 0) continue;
-		const doomedSet = new Set(doomed);
-		const nestedByMapKey = /* @__PURE__ */ new Map();
-		for (const path of doomedNested) {
-			const cut = path.indexOf(".");
-			const mapKey = path.slice(0, cut);
-			const inner = path.slice(cut + 1);
-			const bucket = nestedByMapKey.get(mapKey) ?? /* @__PURE__ */ new Set();
-			bucket.add(inner);
-			nestedByMapKey.set(mapKey, bucket);
-		}
-		const next = Object.fromEntries(Object.entries(blob).filter(([key]) => !doomedSet.has(key)).map(([key, value]) => {
-			const retired = nestedByMapKey.get(key);
-			if (retired === void 0) return [key, value];
-			const inner = asJsonObject(value);
-			if (inner === null) return [key, value];
-			return [key, Object.fromEntries(Object.entries(inner).filter(([k]) => !retired.has(k)))];
-		}));
-		await store.write(spec, next);
+		if (dropped === null) continue;
 		const result = {
-			addon: spec.namespace,
 			collection: spec.collection,
-			row: spec.row,
-			keys: doomed,
-			nested: doomedNested
+			owner: spec.owner,
+			rows: dropped.rows
 		};
 		results.push(result);
-		logger.info(`purged ${doomed.length + doomedNested.length} retired settings keys`, { meta: {
+		const line = "dropped a retired collection";
+		if (dropped.rows > 0) logger.warn(`${line} — it still held rows`, { meta: {
+			...result,
+			reason: spec.reason
+		} });
+		else logger.info(line, { meta: {
 			...result,
 			reason: spec.reason
 		} });
@@ -458,6 +355,9 @@ function isImposedBound(source) {
 }
 //#endregion
 //#region src/builtins/sqlite-storage/sqlite-settings-backend.ts
+function isCountRow(raw) {
+	return raw !== null && typeof raw === "object" && typeof Reflect.get(raw, "n") === "number";
+}
 function parseRowData(raw) {
 	return asJsonObject(parseJsonUnknown(raw)) ?? {};
 }
@@ -1185,6 +1085,31 @@ var SqliteSettingsBackend = class SqliteSettingsBackend {
 		}
 		this.structuredTables.set(table, fingerprint);
 	}
+	/**
+	* Drop a table nothing declares any more, reporting what went with it.
+	*
+	* The DDL lives here because the engine owns the handle AND the two memos
+	* that outlive a table: `structuredTables` (schema fingerprint) and
+	* `declaredCollections` (the column set `compileFilter` resolves against).
+	* Dropping behind their backs would leave a ghost — a later declaration of
+	* the same name would be memoised as "already materialised" against a table
+	* that no longer exists.
+	*
+	* WHICH tables are retired, and the logging, are policy: they live in
+	* `retired-collections.ts`. This method knows only how to drop one.
+	*
+	* Answers `null` when the table is not there — the steady state after the
+	* first boot that ran the purge, and the case on a fresh install.
+	*/
+	dropRetiredTable(table) {
+		if (this.getDb().prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?`).get(table) === void 0) return null;
+		const counted = this.getDb().prepare(`SELECT COUNT(*) AS n FROM "${table}"`).get();
+		const rows = isCountRow(counted) ? counted.n : 0;
+		this.getDb().exec(`DROP TABLE "${table}"`);
+		this.structuredTables.delete(table);
+		this.declaredCollections.delete(table);
+		return { rows };
+	}
 	async tableInsert(table, row) {
 		const keys = Object.keys(row);
 		const cols = keys.map((k) => `"${k}"`).join(", ");
@@ -1821,6 +1746,7 @@ var SqliteSettingsAddon = class extends BaseAddon {
 		} catch (err) {
 			this.ctx.logger.warn("Retired-key purge failed", { meta: { error: errMsg(err) } });
 		}
+		await purgeRetiredCollections(retiredCollectionStoreOf(this.backend), this.ctx.logger.child("RetiredCollections"));
 		const vectorIndex = this.createVectorIndex(this.backend);
 		await vectorIndex.loadIndexRegistry();
 		this.vectorIndex = vectorIndex;