@warlock.js/cascade 5.29.0 → 5.31.0

package/skills/search-by-vector/SKILL.md

@@ -96,7 +96,10 @@ async function answer(question: string) {
   // optional: drop low-similarity hits in code
   const relevant = context.filter((document) => document.score >= 0.75);
 
-  const prompt = buildPrompt(question, relevant.map((document) => document.body));
+  const prompt = buildPrompt(
+    question,
+    relevant.map((document) => document.body),
+  );
   return ai.complete(prompt);
 }
 ```
@@ -105,11 +108,11 @@ A score threshold isn't a query option — filter on the `score` column in code
 
 ## Driver support
 
-| Driver | Vector |
-| --- | --- |
-| Postgres (with `CREATE EXTENSION vector`) | ✅ pgvector + IVFFlat index |
+| Driver                                         | Vector                               |
+| ---------------------------------------------- | ------------------------------------ |
+| Postgres (with `CREATE EXTENSION vector`)      | ✅ pgvector + IVFFlat index          |
 | MongoDB Atlas (paid tier + Atlas Search index) | ✅ `$vectorSearch` aggregation stage |
-| MongoDB community / self-hosted / local | ❌ Atlas-only |
+| MongoDB community / self-hosted / local        | ❌ Atlas-only                        |
 
 For local dev with MongoDB, develop the vector path against Postgres + pgvector.
 

package/skills/subscribe-to-model-events/SKILL.md

@@ -25,18 +25,18 @@ Listeners are async-aware — the model's persistence awaits the listener before
 
 The events fire in this order. The **gerund** form (`saving`, `creating`) is the "before" hook — there is no `beforeSave` alias.
 
-| Event | Fires |
-| --- | --- |
-| `saving` | Before validation, on every `save()` (both insert and update paths) |
-| `validating` / `validated` | Around schema validation |
-| `creating` | Before a new record is inserted (first save) |
-| `updating` | Before an existing record's update is written |
-| `saved` | After a successful write (any branch — insert or update) |
-| `created` | After a new record is inserted |
-| `updated` | After an existing record's update is written |
-| `deleting` / `deleted` | Before / after the delete strategy runs |
-| `restoring` / `restored` | Before / after a soft-deleted or trashed record is restored |
-| `fetching` / `fetched` / `hydrating` | Around reads / instance hydration |
+| Event                                | Fires                                                               |
+| ------------------------------------ | ------------------------------------------------------------------- |
+| `saving`                             | Before validation, on every `save()` (both insert and update paths) |
+| `validating` / `validated`           | Around schema validation                                            |
+| `creating`                           | Before a new record is inserted (first save)                        |
+| `updating`                           | Before an existing record's update is written                       |
+| `saved`                              | After a successful write (any branch — insert or update)            |
+| `created`                            | After a new record is inserted                                      |
+| `updated`                            | After an existing record's update is written                        |
+| `deleting` / `deleted`               | Before / after the delete strategy runs                             |
+| `restoring` / `restored`             | Before / after a soft-deleted or trashed record is restored         |
+| `fetching` / `fetched` / `hydrating` | Around reads / instance hydration                                   |
 
 `saving` fires for both inserts and updates; `creating` / `updating` narrow to the branch. So `saved` always fires; exactly one of `created` / `updated` follows.
 
@@ -67,17 +67,17 @@ Pair with `isDirty()` from the `track-changes` topic so the listener only runs i
 
 ## Global listeners — across all models
 
-For framework-level concerns (audit log, observability, cache invalidation), subscribe on the base `Model` — the listener runs for every model:
+For framework-level concerns (audit log, observability, cache invalidation), subscribe through `Model.globalEvents()` — the listener runs for every model:
 
 ```ts
 import { Model } from "@warlock.js/cascade";
 
-Model.on("saved", async (instance) => {
-  await audit.log("save", instance.constructor.name, instance.id, instance.getDirtyColumns());
+Model.globalEvents().on("saved", (instance) => {
+  console.info("save", instance.constructor.name, instance.id, instance.getDirtyColumns());
 });
 ```
 
-Filter by `instance.constructor.name === "User"` when you only care about specific models, or register per-model handlers when the scope is narrow. (`Model.globalEvents()` returns the underlying global emitter if you need direct access.)
+Filter by `instance.constructor.name === "User"` when you only care about specific models, or register per-model handlers when the scope is narrow. The base `Model` is abstract; its per-model `on()` shortcut expects a concrete subclass.
 
 ## `off()` to unsubscribe
 
@@ -115,7 +115,7 @@ Model.on("updated", async (instance) => {
 });
 ```
 
-Use `updated` (not `saved`) when you only want change diffs — `getDirtyColumnsWithValues()` is still populated in the post-write events because the tracker resets *after* they fire.
+Use `updated` (not `saved`) when you only want change diffs — `getDirtyColumnsWithValues()` is still populated in the post-write events because the tracker resets _after_ they fire.
 
 ### Cache invalidation
 

package/skills/track-changes/SKILL.md

@@ -10,11 +10,11 @@ Every Cascade model carries a dirty tracker that records which fields you've cha
 ## The main reads
 
 ```ts
-user.hasChanges();           // boolean — any field changed (or removed)?
-user.isDirty("email");       // boolean — specifically this column?
+user.hasChanges(); // boolean — any field changed (or removed)?
+user.isDirty("email"); // boolean — specifically this column?
 
-user.getDirtyColumns();      // string[] — names of changed columns
-user.getRemovedColumns();    // string[] — columns explicitly unset since load
+user.getDirtyColumns(); // string[] — names of changed columns
+user.getRemovedColumns(); // string[] — columns explicitly unset since load
 
 user.getDirtyColumnsWithValues();
 // Record<string, { oldValue, newValue }> — the full diff, old + new per column
@@ -59,9 +59,9 @@ await AuditLog.create({
 
 ```ts
 user.set("name", "Augusta");
-user.isDirty("name");        // true
+user.isDirty("name"); // true
 await user.save();
-user.isDirty("name");        // false — tracker reset to the just-saved state
+user.isDirty("name"); // false — tracker reset to the just-saved state
 ```
 
 `save()` resets the tracker's baseline to the persisted state. Subsequent `isDirty()` checks measure changes since the last `save()`, not since the original load.
@@ -103,12 +103,12 @@ for (const [field, { oldValue, newValue }] of Object.entries(dirty)) {
 
 ```ts
 // plain object → merged key-by-key, siblings survive
-user.merge({ profile: { age: 26 } });     // profile.city untouched
-user.getDirtyColumns();                    // ["profile.age"]
+user.merge({ profile: { age: 26 } }); // profile.city untouched
+user.getDirtyColumns(); // ["profile.age"]
 
 // Date → replaced, not merged
 conversation.merge({ lastOutboundAt: new Date() });
-conversation.getDirtyColumns();            // ["lastOutboundAt"]
+conversation.getDirtyColumns(); // ["lastOutboundAt"]
 ```
 
 :::note[Fixed in 4.9.1]

package/skills/write-migration/SKILL.md

@@ -129,10 +129,10 @@ Class-form builders include `createTable()` / `createTableIfNotExists()`, `dropT
 `this.foreignId(name)` (5.8+) derives the column's type from `migrationDefaults.primaryKey` so a foreign-key column always matches the type of the `id` it points at, instead of hardcoding one:
 
 | `migrationDefaults.primaryKey` | `foreignId` produces |
-| --- | --- |
-| `uuid` | `uuid` column |
-| `bigInt` | `bigInteger` column |
-| anything else (default) | `integer` column |
+| ------------------------------ | -------------------- |
+| `uuid`                         | `uuid` column        |
+| `bigInt`                       | `bigInteger` column  |
+| anything else (default)        | `integer` column     |
 
 ```ts
 import { Migration } from "@warlock.js/cascade";