@cosmicdrift/kumiko-framework 0.199.0 → 0.199.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.199.0",
+  "version": "0.199.1",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -186,7 +186,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-types": "0.199.0",
+    "@cosmicdrift/kumiko-types": "0.199.1",
     "bullmq": "^5.76.7",
     "bun-types": "^1.3.13",
     "hono": "^4.13.1",
@@ -202,7 +202,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.199.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.199.1",
     "bun-types": "^1.3.13",
     "pino-pretty": "^13.1.3"
   },

package/src/db/__tests__/rebuild-marker.test.ts

@@ -40,6 +40,14 @@ describe("rebuildTablesFromDiff", () => {
     expect(rebuildTablesFromDiff(diff)).toEqual(["read_b"]);
   });
 
+  test("managed new _bidx column → rebuild (blind index needs plaintext HMAC, SQL can't backfill)", () => {
+    const prev = snapshotFromMetas([meta("read_a")]);
+    const next = snapshotFromMetas([
+      meta("read_a", { name: "invited_by_bidx", pgType: "text", notNull: false }),
+    ]);
+    expect(rebuildTablesFromDiff(diffSnapshots(prev, next))).toEqual(["read_a"]);
+  });
+
   test("no schema change → empty", () => {
     const snap = snapshotFromMetas([meta("read_a")]);
     expect(rebuildTablesFromDiff(diffSnapshots(snap, snap))).toEqual([]);

package/src/db/rebuild-marker.ts

@@ -49,11 +49,19 @@ function markerPathFor(migrationsDir: string, migrationId: string): string {
 // If a NEW additive column genuinely needs value-backfill from historical events
 // (a column DERIVED from existing event fields), opt in explicitly by hand-adding
 // a `NNNN_<name>.rebuild.json` next to the migration (readRebuildMarker reads it).
+//
+// One built-in exception to the additive-column rule: a new `_bidx` column
+// (blind-index for a field that just became `lookupable: true`, naming
+// convention `${snake}_bidx` from entity-table-meta.ts:111) is always
+// additive SQL-wise but still needs a rebuild — the index is an HMAC over
+// the decrypted value, which SQL cannot backfill.
 export function rebuildTablesFromDiff(diff: SchemaDiff): readonly string[] {
   const names = new Set<string>();
   for (const t of diff.changedTables) {
     if (t.nextMeta.source !== "managed") continue;
-    if (managedChangeRequiresRecreate(t)) names.add(t.tableName);
+    if (managedChangeRequiresRecreate(t) || t.newColumns.some((c) => c.name.endsWith("_bidx"))) {
+      names.add(t.tableName);
+    }
   }
   for (const t of diff.newTables) {
     if (t.source === "managed") names.add(t.tableName);