@klum-db/lobby 0.2.0-pre.28 → 0.2.0-pre.30

package/README.md

@@ -67,7 +67,7 @@ lobby.withVaultTemplate('client', { version: 1, configure: v => v.collection('in
 const group = await lobby.openVaultGroup('clients', { registry, sharding: { keyOf, vaultTemplate: 'client', autoCreate: true } })
 await group.shard('acme-co').collection('invoices').put('i1', { id: 'i1', total: '1200.00' })
 const all = await group.queryAcross(/* … */)          // fan-out read across shards
-await group.migrateFleet({ batchSize: 4 })             // resumable, registry-tracked
+await group.rolloutSchema({ batchSize: 4 })             // resumable, registry-tracked
 ```
 
 ### 2 · Interchange — move data between vaults, safely
@@ -137,11 +137,11 @@ await lobby.applySurface('tax-vault', surface, bundleBytes, transferKey)
 
 - **Depends on `@noy-db/hub`**, binds to the stable **`@noy-db/hub/kernel`** subpath — never reaches into hub internals.
 - **Custody is a vault-level concern** and lives *in* hub (keyring/CEK/consent primitives); the Lobby **re-exports** it (`createDeedOwner`, `liberateVault`, `CustodyApi`) so consumers have one import surface.
-- **Federation** was extracted *out of* hub into the Lobby (a breaking pre-1.0 change): `Noydb.openVaultGroup` now throws `FederationMovedError` — use `lobby.openVaultGroup`.
+- **Federation** lives in the Lobby, not in hub — open fleets with `lobby.openVaultGroup` (`@noy-db/hub` no longer ships the `openVaultGroup` / `openStateManagementVault` / `withVaultTemplate` fleet methods).
 - The dependency is enforced one-way at build time; an `@noy-db` package importing `@klum-db` fails the architecture check.
 
 ## Status
 
-Preview, developed inside the noy-db monorepo while the kernel boundary stabilizes (it graduates to its own repo once proven). Versions track noy-db in lockstep. Pilot-1 epic (FR-1…FR-9) complete.
+Preview. `@klum-db/lobby` is its own repository and the sole publisher of `@klum-db/*` to npm. It depends on the **published** `@noy-db/*` packages through the stable `@noy-db/hub/kernel` boundary and versions **independently** (`0.2.0-pre.N`, decoupled from noy-db). Pilot-1 (FR-1…FR-9), the dock tier, and `Lobby.graduate()` are complete.
 
-Design spec: [`docs/superpowers/specs/2026-06-16-lobby-framework-design.md`](../../docs/superpowers/specs/2026-06-16-lobby-framework-design.md). Runnable showcases: [`showcases/src/12x-klum-*`](../../showcases/src).
+See [`PROVENANCE.md`](./PROVENANCE.md) for origin and build history.

package/dist/bin/klum.d.cts

@@ -1,4 +1,4 @@
-import { V as VaultGroup } from '../vault-group-DeBoCFT9.cjs';
+import { V as VaultGroup } from '../vault-group-BXjO5kHB.cjs';
 import '@noy-db/hub/kernel';
 import '@noy-db/hub';
 import '@noy-db/hub/bundle';

package/dist/bin/klum.d.ts

@@ -1,4 +1,4 @@
-import { V as VaultGroup } from '../vault-group-DeBoCFT9.js';
+import { V as VaultGroup } from '../vault-group-BXjO5kHB.js';
 import '@noy-db/hub/kernel';
 import '@noy-db/hub';
 import '@noy-db/hub/bundle';

package/dist/index.cjs

@@ -1415,13 +1415,13 @@ var init_vault_group = __esm({
     SHARD_SEPARATOR = "--";
     SAFE_PARTITION_KEY = /^[A-Za-z0-9._-]+$/;
     VaultGroup = class {
-      constructor(db, name, registry, sharding, template, migrateOnOpen = false) {
+      constructor(db, name, registry, sharding, template, cutoverOnOpen = false) {
         this.db = db;
         this.name = name;
         this.registry = registry;
         this.sharding = sharding;
         this.template = template;
-        this.migrateOnOpen = migrateOnOpen;
+        this.cutoverOnOpen = cutoverOnOpen;
         if (name.includes(SHARD_SEPARATOR)) {
           throw new import_kernel10.ValidationError(
             `VaultGroup name "${name}" must not contain "--" (reserved shard vault-id separator).`
@@ -1433,7 +1433,7 @@ var init_vault_group = __esm({
       registry;
       sharding;
       template;
-      migrateOnOpen;
+      cutoverOnOpen;
       /** @internal — set when the group is managed (no explicit registry). */
       stateVault;
       /** @internal */
@@ -1468,20 +1468,20 @@ var init_vault_group = __esm({
         return rows.filter((r) => r.group === this.name);
       }
       /**
-       * Open an existing shard and apply the template. When `migrateOnOpen` is set
+       * Open an existing shard and apply the template. When `cutoverOnOpen` is set
        * (#271) and the shard's registry version is behind the template, its cutover
        * runs inline first — so a behind shard never surfaces a stale handle.
        */
       async openShard(partitionKey) {
-        if (this.migrateOnOpen) {
+        if (this.cutoverOnOpen) {
           const row = await this.registry.get(this.registryId(partitionKey));
           if (row && row.schemaVersion < this.template.version) {
-            await this.migrateShard(partitionKey);
+            await this.cutoverShard(partitionKey);
           }
         }
         return this._openShardRaw(partitionKey);
       }
-      /** @internal — open + configure with no migrate-on-open hook (used by the migration path itself to avoid recursion). */
+      /** @internal — open + configure with no cutover-on-open hook (used by the migration path itself to avoid recursion). */
       async _openShardRaw(partitionKey) {
         const vault = await this.db.openVault(this.shardVaultId(partitionKey), { create: false });
         this.template.configure(vault);
@@ -1703,7 +1703,7 @@ var init_vault_group = __esm({
        * Never throws on a cutover failure — it records `status: 'failed'` and
        * returns the row, so a fleet run continues past a bad shard.
        */
-      async migrateShard(partitionKey) {
+      async cutoverShard(partitionKey) {
         const vaultId = this.shardVaultId(partitionKey);
         const row = await this.registry.get(this.registryId(partitionKey));
         if (!row) throw new import_kernel10.UnknownShardError(partitionKey, this.name);
@@ -1754,7 +1754,7 @@ var init_vault_group = __esm({
        * - `batchSize` — max shards migrated concurrently per batch (back-pressure).
        *   Default 4. Batches run sequentially; shards within a batch run in parallel.
        */
-      async migrateFleet(options = {}) {
+      async rolloutSchema(options = {}) {
         const target = this.template.version;
         const rows = await this.allRows();
         const cohort = options.cohort;
@@ -1766,7 +1766,7 @@ var init_vault_group = __esm({
         const failed = [];
         for (let i = 0; i < todo.length; i += batchSize) {
           const batch = todo.slice(i, i + batchSize);
-          const settled = await Promise.all(batch.map((r) => this.migrateShard(r.partitionKey)));
+          const settled = await Promise.all(batch.map((r) => this.cutoverShard(r.partitionKey)));
           for (const res of settled) {
             if (res.status === "done") migrated.push(res.vaultId);
             else failed.push({ vaultId: res.vaultId, error: res.error ?? "unknown" });
@@ -2214,7 +2214,7 @@ var Lobby = class {
     const { StateManagementVault: StateManagementVault2 } = await Promise.resolve().then(() => (init_state_vault(), state_vault_exports));
     const stateVault = opts.registry ? void 0 : await StateManagementVault2.open(db);
     const registry = opts.registry ?? stateVault.registry;
-    const group = new VaultGroup2(db, name, registry, opts.sharding, template, opts.migrateOnOpen ?? false);
+    const group = new VaultGroup2(db, name, registry, opts.sharding, template, opts.cutoverOnOpen ?? false);
     if (stateVault) {
       group._attachStateVault(stateVault);
       await stateVault.recordManifest(opts.sharding.vaultTemplate, template);