joist-codegen 2.3.0-next.3 → 2.3.0-next.30

package/build/installSkills.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installSkills = installSkills;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/** The bundled skills live at the package root, alongside `build`/`src`. */
+const bundledSkillsDir = (0, path_1.resolve)(__dirname, "../skills");
+/**
+ * Targets that each get a full copy of every skill directory.
+ *
+ * `.claude/skills` is read by Claude Code (and opencode); `.agents/skills` is read
+ * by Codex (and opencode), so writing both gives native coverage across all three.
+ */
+const skillTargets = [".claude/skills", ".agents/skills"];
+/** Joist owns the `joist-` skill namespace, so stale ones there are ours to prune. */
+const skillPrefix = "joist-";
+/**
+ * Copies Joist's bundled Agent Skills into the project so coding agents can
+ * discover them, then prunes any previously-installed Joist skills that no
+ * longer ship with this version.
+ *
+ * The skills are framework-owned and rewritten on every codegen run, so users
+ * should not hand-edit them (re-run codegen to pick up new Joist versions).
+ *
+ * Logs only what actually changed: the added and removed skill names, staying
+ * quiet when nothing changed.
+ */
+async function installSkills(rootDir = ".") {
+    const bundled = await readSkillNames(bundledSkillsDir);
+    if (bundled.length === 0)
+        return;
+    const bundledSet = new Set(bundled);
+    // Snapshot what each target already has before we copy/remove, so we can diff.
+    const existingPerTarget = await Promise.all(skillTargets.map((target) => readSkillNames((0, path_1.join)(rootDir, target))));
+    // Always `cp` the bundled skills into each target, overwriting any existing ones
+    await Promise.all(skillTargets.flatMap((target) => bundled.map((name) => fs_1.promises.cp((0, path_1.join)(bundledSkillsDir, name), (0, path_1.join)(rootDir, target, name), { recursive: true, force: true }))));
+    // Prune stale Joist skills (previously installed here, but no longer bundled).
+    const removed = new Set();
+    await Promise.all(skillTargets.map(async (target, i) => {
+        const stale = existingPerTarget[i].filter((name) => name.startsWith(skillPrefix) && !bundledSet.has(name));
+        await Promise.all(stale.map(async (name) => {
+            removed.add(name);
+            await fs_1.promises.rm((0, path_1.join)(rootDir, target, name), { recursive: true, force: true });
+        }));
+    }));
+    // A skill is "new" if it was missing from at least one target before this run.
+    const added = bundled.filter((name) => existingPerTarget.some((names) => !names.includes(name)));
+    if (added.length > 0) {
+        console.log(`Added ${added.length} Joist skill(s) to ${skillTargets.join(" and ")}:`);
+        for (const name of added)
+            console.log(`  + ${name}`);
+    }
+    if (removed.size > 0) {
+        console.log(`Removed ${removed.size} stale Joist skill(s) from ${skillTargets.join(" and ")}:`);
+        for (const name of removed)
+            console.log(`  - ${name}`);
+    }
+}
+/** Lists the skill directory names in a dir, or `[]` if it's missing. I.e. ["joist-upsert", ...]. */
+async function readSkillNames(dir) {
+    try {
+        const entries = await fs_1.promises.readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=installSkills.js.map

package/build/installSkills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installSkills.js","sourceRoot":"","sources":["../src/installSkills.ts"],"names":[],"mappings":";;;AAAA,2BAAoC;AACpC,+BAAqC;AAErC,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAE1D,sFAAsF;AACtF,MAAM,WAAW,GAAG,QAAQ,CAAC;AAE7B;;;;;;;;;;GAUG;AACI,KAAK,wBAAwB,OAAO,GAAW,GAAG;IACvD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACjC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAEpC,+EAA+E;IAC/E,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,IAAA,WAAI,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjH,iFAAiF;IACjF,MAAM,OAAO,CAAC,GAAG,CACf,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAC9B,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,aAAE,CAAC,EAAE,CAAC,IAAA,WAAI,EAAC,gBAAgB,EAAE,IAAI,CAAC,EAAE,IAAA,WAAI,EAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CACnG,CACF,CACF,CAAC;IAEF,+EAA+E;IAC/E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,OAAO,CAAC,GAAG,CACf,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3G,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM,aAAE,CAAC,EAAE,CAAC,IAAA,WAAI,EAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,+EAA+E;IAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEjG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,MAAM,sBAAsB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtF,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,IAAI,8BAA8B,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChG,KAAK,MAAM,IAAI,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,qGAAqG;AACrG,KAAK,UAAU,cAAc,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/build/keywords.d.ts

@@ -1,2 +1 @@
 export declare const keywords: string[];
-//# sourceMappingURL=keywords.d.ts.map

package/build/loadMetadata.d.ts

@@ -23,4 +23,3 @@ export type EnumRow = {
 };
 export declare function loadEnumMetadata(db: Db, client: Client, config: Config): Promise<EnumMetadata>;
 export declare function loadPgEnumMetadata(db: Db, client: Client, config: Config): Promise<PgEnumMetadata>;
-//# sourceMappingURL=loadMetadata.d.ts.map

package/build/loadMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"loadMetadata.js","sourceRoot":"","sources":["../src/loadMetadata.ts"],"names":[],"mappings":";;AA0BA,4CAsBC;AAED,gDAaC;AA/DD,6CAAyC;AAEzC,+CAAmD;AACnD,mCAAmE;AACnE,mCAAsC;AAsB/B,KAAK,UAAU,gBAAgB,CAAC,EAAM,EAAE,MAAc,EAAE,MAAc;IAC3E,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACrC,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,IAAI,cAAc,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAc,CAAC,CAAC;QACtD,wFAAwF;QACxF,MAAM,eAAe,GAAG,IAAI,wBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,MAAM,CAC3E,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAC/C,CAAC;QACF,OAAO;YACL,KAAK,CAAC,IAAI;YACV;gBACE,KAAK;gBACL,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAC1E,IAAI,EAAE,IAAA,wBAAU,EAAC,KAAK,CAAC,IAAI,CAAC,EAAE,yBAAyB;gBACvD,IAAI;gBACJ,eAAe;aAChB;SACgC,CAAC;IACtC,CAAC,CAAC,CAAC;IACL,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,EAAM,EAAE,MAAc,EAAE,MAAc;IAC7E,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACnC,IAAI,IAAI,YAAY,uBAAQ,EAAE,CAAC;YAC7B,OAAO;gBACL,GAAG,GAAG;gBACN,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACX,IAAI,EAAE,IAAA,wBAAU,EAAC,IAAI,CAAC,IAAI,CAAC;oBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB;aACF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}
+{"version":3,"file":"loadMetadata.js","sourceRoot":"","sources":["../src/loadMetadata.ts"],"names":[],"mappings":";;;;AAAA,6CAAyC;AAEzC,+CAAmD;AACnD,mCAAmE;AACnE,mCAAsC;AAsB/B,KAAK,2BAA2B,EAAM,EAAE,MAAc,EAAE,MAAc;IAC3E,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACrC,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,IAAI,cAAc,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAc,CAAC,CAAC;QACtD,wFAAwF;QACxF,MAAM,eAAe,GAAG,IAAI,wBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,MAAM,CAC3E,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAC/C,CAAC;QACF,OAAO;YACL,KAAK,CAAC,IAAI;YACV;gBACE,KAAK;gBACL,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAC1E,IAAI,EAAE,IAAA,wBAAU,EAAC,KAAK,CAAC,IAAI,CAAC,EAAE,yBAAyB;gBACvD,IAAI;gBACJ,eAAe;aAChB;SACgC,CAAC;IACtC,CAAC,CAAC,CAAC;IACL,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAEM,KAAK,6BAA6B,EAAM,EAAE,MAAc,EAAE,MAAc;IAC7E,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACnC,IAAI,IAAI,YAAY,uBAAQ,EAAE,CAAC;YAC7B,OAAO;gBACL,GAAG,GAAG;gBACN,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACX,IAAI,EAAE,IAAA,wBAAU,EAAC,IAAI,CAAC,IAAI,CAAC;oBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB;aACF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/build/logger.d.ts

@@ -7,4 +7,3 @@ export declare const logger: {
     warn(...args: Parameters<(typeof console)["warn"]>): void;
     error(...args: Parameters<(typeof console)["error"]>): void;
 };
-//# sourceMappingURL=logger.d.ts.map

package/build/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAES,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAE3B,QAAA,MAAM,GAAG;IACpB,IAAI,CAAC,GAAG,IAA0C;QAChD,gCAAwB,GAAG,IAAI,CAAC,GAAG,CAAC,gCAAwB,EAAE,kBAAU,CAAC,IAAI,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,GAAG,IAA2C;QAClD,gCAAwB,GAAG,IAAI,CAAC,GAAG,CAAC,gCAAwB,EAAE,kBAAU,CAAC,KAAK,CAAC,CAAC;QAChF,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;CACF,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAES,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAE3B,QAAA,MAAM,GAAG;IACpB,IAAI,CAAC,GAAG,IAA0C;QAChD,QAAA,wBAAwB,GAAG,IAAI,CAAC,GAAG,CAAC,QAAA,wBAAwB,EAAE,QAAA,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,GAAG,IAA2C;QAClD,QAAA,wBAAwB,GAAG,IAAI,CAAC,GAAG,CAAC,QAAA,wBAAwB,EAAE,QAAA,UAAU,CAAC,KAAK,CAAC,CAAC;QAChF,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;CACF,CAAC"}

package/build/scanEntityFiles.d.ts

@@ -2,4 +2,3 @@ import { DbMetadata } from "./EntityDbMetadata";
 import { Config } from "./config";
 /** Scans the entity files themselves for usage hints (like `setDefault` calls) to drive our codegen output. */
 export declare function scanEntityFiles(config: Config, dbMeta: DbMetadata): Promise<void>;
-//# sourceMappingURL=scanEntityFiles.d.ts.map

package/build/scanEntityFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"scanEntityFiles.js","sourceRoot":"","sources":["../src/scanEntityFiles.ts"],"names":[],"mappings":";;AAiBA,0CAkBC;AAnCD,0CAAuC;AACvC,+BAA4B;AAY5B,mFAAmF;AACnF,MAAM,KAAK,GAAG,2CAA2C,CAAC;AAE1D,+GAA+G;AACxG,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,MAAkB;IACtE,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,0DAA0D;YAC1D,MAAM,MAAM,GAAG,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAA,WAAI,EAAC,MAAM,CAAC,iBAAiB,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChG,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtE,IAAI,KAAK,EAAE,CAAC;oBACV,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,+BAA+B;QACjC,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,0BAA0B,CACjC,MAAkB,EAClB,MAAoC;IAEpC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO;QACL,GAAG,MAAM,CAAC,UAAU;QACpB,GAAG,MAAM,CAAC,KAAK;QACf,GAAG,MAAM,CAAC,OAAO;QACjB,GAAG,MAAM,CAAC,UAAU;QACpB,GAAG,MAAM,CAAC,YAAY;QACtB,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"scanEntityFiles.js","sourceRoot":"","sources":["../src/scanEntityFiles.ts"],"names":[],"mappings":";;;AAAA,0CAAuC;AACvC,+BAA4B;AAY5B,mFAAmF;AACnF,MAAM,KAAK,GAAG,2CAA2C,CAAC;AAE1D,+GAA+G;AACxG,KAAK,0BAA0B,MAAc,EAAE,MAAkB;IACtE,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,0DAA0D;YAC1D,MAAM,MAAM,GAAG,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAA,WAAI,EAAC,MAAM,CAAC,iBAAiB,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChG,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtE,IAAI,KAAK,EAAE,CAAC;oBACV,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,+BAA+B;QACjC,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,0BAA0B,CACjC,MAAkB,EAClB,MAAoC;IAEpC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO;QACL,GAAG,MAAM,CAAC,UAAU;QACpB,GAAG,MAAM,CAAC,KAAK;QACf,GAAG,MAAM,CAAC,OAAO;QACjB,GAAG,MAAM,CAAC,UAAU;QACpB,GAAG,MAAM,CAAC,YAAY;QACtB,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjH,CAAC;AACJ,CAAC"}

package/build/sortForeignKeys.d.ts

@@ -29,4 +29,3 @@ export declare function sortByNonDeferredForeignKeys(entities: EntityDbMetadata[
     nullableCycles: string[];
     notNullCycles: string[];
 };
-//# sourceMappingURL=sortForeignKeys.d.ts.map

package/build/sortForeignKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"sortForeignKeys.js","sourceRoot":"","sources":["../src/sortForeignKeys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sortForeignKeys.js","sourceRoot":"","sources":["../src/sortForeignKeys.ts"],"names":[],"mappings":"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"}

package/build/symbols.d.ts

@@ -18,6 +18,8 @@ export declare const EnumMetadata: import("ts-poet").Import;
 export declare const Lens: import("ts-poet").Import;
 export declare const KeySerde: import("ts-poet").Import;
 export declare const ManyToOneReference: import("ts-poet").Import;
+export declare const LazyField: import("ts-poet").Import;
+export declare const hasLazyField: import("ts-poet").Import;
 export declare const ReadOnlyCollection: import("ts-poet").Import;
 export declare const PolymorphicReference: import("ts-poet").Import;
 export declare const OneToOneReference: import("ts-poet").Import;
@@ -64,6 +66,7 @@ export declare const ToJsonHint: import("ts-poet").Import;
 export declare const JsonPayload: import("ts-poet").Import;
 export declare const configureMetadata: import("ts-poet").Import;
 export declare const newRequiredRule: import("ts-poet").Import;
+export declare const newRequiredLazyFieldRule: import("ts-poet").Import;
 export declare const cannotBeUpdated: import("ts-poet").Import;
 export declare const mustBeSubType: import("ts-poet").Import;
 export declare const cleanStringValue: import("ts-poet").Import;
@@ -105,4 +108,3 @@ export declare const ReactiveManyToManyOtherSide: import("ts-poet").Import;
 export declare const hasReactiveManyToManyOtherSide: import("ts-poet").Import;
 export declare const updatePartial: import("ts-poet").Import;
 export declare const setRuntimeConfig: import("ts-poet").Import;
-//# sourceMappingURL=symbols.d.ts.map

package/build/symbols.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IdOf = exports.RelationsOf = exports.FieldsOf = exports.OptsOf = exports.OrderBy = exports.setField = exports.getField = exports.setOpts = exports.failNoIdYet = exports.fail = exports.DecimalToNumberSerde = exports.CustomSerdeAdapter = exports.ZodSerde = exports.TaggedId = exports.SuperstructSerde = exports.JsonSerde = exports.ZonedDateTimeSerde = exports.PlainDateTimeSerde = exports.PlainTimeSerde = exports.PlainDateSerde = exports.DateSerde = exports.BigIntSerde = exports.PrimitiveSerde = exports.PolymorphicKeySerde = exports.EnumArrayFieldSerde = exports.EnumFieldSerde = exports.ManyToManyCollection = exports.OneToOneReference = exports.PolymorphicReference = exports.ReadOnlyCollection = exports.ManyToOneReference = exports.KeySerde = exports.Lens = exports.EnumMetadata = exports.EntityMetadata = exports.JoistEntityManager = exports.OneToManyCollection = exports.LargeCollection = exports.EnumCollection = exports.Collection = exports.Reference = exports.Flavor = exports.BaseEntity = exports.Entity = exports.FieldStatus = exports.Scope = exports.newScopeFn = exports.ConfigApi = exports.EntityManager = exports.ProjectEntity = void 0;
-exports.toJSON = exports.toIdOf = exports.deTagId = exports.MaybeAbstractEntityConstructor = exports.EntityConstructor = exports.Zod = exports.SSAssert = exports.FactoryOpts = exports.DeepNew = exports.New = exports.newTestInstance = exports.hasLargeManyToMany = exports.hasEnumCollection = exports.hasManyToMany = exports.hasOneToOne = exports.hasOnePolymorphic = exports.hasRecursiveParents = exports.hasRecursiveM2m = exports.hasRecursiveChildren = exports.hasOne = exports.hasLargeMany = exports.hasMany = exports.hasOneThrough = exports.loadLens = exports.isEntity = exports.getInstanceData = exports.isLoaded = exports.Loaded = exports.LoadHint = exports.newChangesProxy = exports.Changes = exports.cleanStringValue = exports.mustBeSubType = exports.cannotBeUpdated = exports.newRequiredRule = exports.configureMetadata = exports.JsonPayload = exports.ToJsonHint = exports.JsonHint = exports.GraphQLFilterOf = exports.FilterOf = exports.ValueGraphQLFilter = exports.EnumGraphQLFilter = exports.EntityGraphQLFilter = exports.BooleanGraphQLFilter = exports.EntityFilter = exports.ValueFilter = exports.BooleanFilter = exports.DeepPartialOrNull = exports.PartialOrNull = void 0;
-exports.setRuntimeConfig = exports.updatePartial = exports.hasReactiveManyToManyOtherSide = exports.ReactiveManyToManyOtherSide = exports.ReactiveManyToMany = exports.ReactiveReference = exports.ReactiveField = void 0;
+exports.FieldsOf = exports.OptsOf = exports.OrderBy = exports.setField = exports.getField = exports.setOpts = exports.failNoIdYet = exports.fail = exports.DecimalToNumberSerde = exports.CustomSerdeAdapter = exports.ZodSerde = exports.TaggedId = exports.SuperstructSerde = exports.JsonSerde = exports.ZonedDateTimeSerde = exports.PlainDateTimeSerde = exports.PlainTimeSerde = exports.PlainDateSerde = exports.DateSerde = exports.BigIntSerde = exports.PrimitiveSerde = exports.PolymorphicKeySerde = exports.EnumArrayFieldSerde = exports.EnumFieldSerde = exports.ManyToManyCollection = exports.OneToOneReference = exports.PolymorphicReference = exports.ReadOnlyCollection = exports.hasLazyField = exports.LazyField = exports.ManyToOneReference = exports.KeySerde = exports.Lens = exports.EnumMetadata = exports.EntityMetadata = exports.JoistEntityManager = exports.OneToManyCollection = exports.LargeCollection = exports.EnumCollection = exports.Collection = exports.Reference = exports.Flavor = exports.BaseEntity = exports.Entity = exports.FieldStatus = exports.Scope = exports.newScopeFn = exports.ConfigApi = exports.EntityManager = exports.ProjectEntity = void 0;
+exports.MaybeAbstractEntityConstructor = exports.EntityConstructor = exports.Zod = exports.SSAssert = exports.FactoryOpts = exports.DeepNew = exports.New = exports.newTestInstance = exports.hasLargeManyToMany = exports.hasEnumCollection = exports.hasManyToMany = exports.hasOneToOne = exports.hasOnePolymorphic = exports.hasRecursiveParents = exports.hasRecursiveM2m = exports.hasRecursiveChildren = exports.hasOne = exports.hasLargeMany = exports.hasMany = exports.hasOneThrough = exports.loadLens = exports.isEntity = exports.getInstanceData = exports.isLoaded = exports.Loaded = exports.LoadHint = exports.newChangesProxy = exports.Changes = exports.cleanStringValue = exports.mustBeSubType = exports.cannotBeUpdated = exports.newRequiredLazyFieldRule = exports.newRequiredRule = exports.configureMetadata = exports.JsonPayload = exports.ToJsonHint = exports.JsonHint = exports.GraphQLFilterOf = exports.FilterOf = exports.ValueGraphQLFilter = exports.EnumGraphQLFilter = exports.EntityGraphQLFilter = exports.BooleanGraphQLFilter = exports.EntityFilter = exports.ValueFilter = exports.BooleanFilter = exports.DeepPartialOrNull = exports.PartialOrNull = exports.IdOf = exports.RelationsOf = void 0;
+exports.setRuntimeConfig = exports.updatePartial = exports.hasReactiveManyToManyOtherSide = exports.ReactiveManyToManyOtherSide = exports.ReactiveManyToMany = exports.ReactiveReference = exports.ReactiveField = exports.toJSON = exports.toIdOf = exports.deTagId = void 0;
 const ts_poet_1 = require("ts-poet");
 exports.ProjectEntity = (0, ts_poet_1.imp)(`t:Entity@./entities.ts`);
 exports.EntityManager = (0, ts_poet_1.imp)("EntityManager@./entities.ts");
@@ -24,6 +24,8 @@ exports.EnumMetadata = (0, ts_poet_1.imp)("t:EnumMetadata@joist-orm");
 exports.Lens = (0, ts_poet_1.imp)("t:Lens@joist-orm");
 exports.KeySerde = (0, ts_poet_1.imp)("KeySerde@joist-orm");
 exports.ManyToOneReference = (0, ts_poet_1.imp)("t:ManyToOneReference@joist-orm");
+exports.LazyField = (0, ts_poet_1.imp)("t:LazyField@joist-orm");
+exports.hasLazyField = (0, ts_poet_1.imp)("hasLazyField@joist-orm");
 exports.ReadOnlyCollection = (0, ts_poet_1.imp)("t:ReadOnlyCollection@joist-orm");
 exports.PolymorphicReference = (0, ts_poet_1.imp)("t:PolymorphicReference@joist-orm");
 exports.OneToOneReference = (0, ts_poet_1.imp)("t:OneToOneReference@joist-orm");
@@ -70,6 +72,7 @@ exports.ToJsonHint = (0, ts_poet_1.imp)("t:ToJsonHint@joist-orm");
 exports.JsonPayload = (0, ts_poet_1.imp)("t:JsonPayload@joist-orm");
 exports.configureMetadata = (0, ts_poet_1.imp)("configureMetadata@joist-orm");
 exports.newRequiredRule = (0, ts_poet_1.imp)("newRequiredRule@joist-orm");
+exports.newRequiredLazyFieldRule = (0, ts_poet_1.imp)("newRequiredLazyFieldRule@joist-orm");
 exports.cannotBeUpdated = (0, ts_poet_1.imp)("cannotBeUpdated@joist-orm");
 exports.mustBeSubType = (0, ts_poet_1.imp)("mustBeSubType@joist-orm");
 exports.cleanStringValue = (0, ts_poet_1.imp)("cleanStringValue@joist-orm");

package/build/symbols.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"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"}

package/build/tsdoc.d.ts

@@ -9,4 +9,3 @@ export declare const tsdocComments: {
         toJSON: string;
     };
 };
-//# sourceMappingURL=tsdoc.d.ts.map

package/build/utils.d.ts

@@ -28,4 +28,3 @@ export declare function parseOrder(order: string | undefined): {
 } | undefined;
 export declare function q(s: string | undefined): string;
 export declare function uncapitalize(s: string): string;
-//# sourceMappingURL=utils.d.ts.map

package/build/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/build/write-json-schema.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=write-json-schema.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joist-codegen",
-  "version": "2.3.0-next.3",
+  "version": "2.3.0-next.30",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -14,10 +14,11 @@
     "format": "prettier --ignore-path ../../.prettierignore --write '{schema,migrations,src}/**/*.{ts,js,tsx,jsx,graphql}'"
   },
   "files": [
-    "build"
+    "build",
+    "skills"
   ],
   "peerDependencies": {
-    "joist-utils": "2.3.0-next.3",
+    "joist-utils": "2.3.0-next.30",
     "knex": "^3.1.0",
     "pg": "^8.22.0"
   },

package/skills/joist-docs/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: entity-docs
+description: Read and write the `src/entities/<Entity>.md` business-docs that sit next to each Joist entity. Use when working on ANY entity in `src/entities/` (its `.ts`, resolvers, jobs, or tests) — read the sibling `.md` first for the business rationale, worked scenarios, and gotchas the code can't show, and record any non-obvious domain knowledge you learn back into it. Also covers the codegen doc-sync: how `## Overview` and `## Fields`/`### fieldName` sections become entity JSDocs via `yarn joist-codegen`, and what belongs in field docs vs. free-form narrative.
+---
+
+# Entity docs (`src/entities/<Entity>.md`)
+
+Many Joist entities have a sibling Markdown doc — `src/entities/Author.ts` ↔
+`src/entities/Author.md` (same basename; enums under `src/entities/enums/` too). These files hold the
+**"why"** that code can't: business rationale, worked scenarios, gotchas, domain vocabulary, and
+cross-entity workflows. They are written for **both humans and agents** — you are a primary audience.
+
+Two jobs, and you should do both as a matter of course:
+
+1. **Read** the sibling `.md` before/while you work on an entity, to get domain context.
+2. **Write** back to it whenever you learn something useful, weird, or non-obvious.
+
+## 1. Read it first
+
+Before editing an entity — its `src/entities/<Entity>.ts`, its resolvers, a job that touches it, or its
+tests — open `src/entities/<Entity>.md` if one exists. It routinely explains things you would otherwise
+have to reverse-engineer or would get subtly wrong:
+
+- **Business rationale** — *why* a field/entity exists and what real-world thing it models
+  (e.g. `PurchaseOrder.md` on tracking "what and why" a project's cost changed).
+- **Worked scenarios** — concrete `I.e.` walkthroughs with real values ("when an `Employee` is termined, the status workflow is...").
+- **Gotchas & edge cases** — footguns, "this looks stale but isn't", exemptions
+- **Domain vocabulary** — statuses, flags, and other "esoteric unless you know it" domain concepts
+
+Follow the cross-links (`[Book](Book.md)`, sometimes with anchors like
+`Book.md#Definitions`) into related docs. If the doc is missing or thin, that's your cue to add
+to it once you've figured things out (job #2).
+
+## 2. How the file maps to code (the codegen doc-sync)
+
+`joist-config.json` has `"docs": true`, so `yarn joist-codegen` keeps these `.md` files and the entity
+JSDocs in sync. Understanding this is what makes your writing land in the right place.
+
+**Only two heading shapes are parsed and synced; everything else is free-form narrative:**
+
+| `.md` section | Syncs to | Notes |
+|---|---|---|
+| `## Overview` (body) | the entity **class** JSDoc | exact heading `## Overview` |
+| `## Fields` → `### <fieldName>` (body) | that field/property/relation's JSDoc | `### ` heading must be the **exact member name** |
+| any other `## Section` (e.g. `## Hard vs. Soft Costs`, `## DB Constraints`, mermaid) | **nothing** | free-form; lives only in the `.md`, preserved verbatim |
+
+Synced JSDocs are tagged `@generated <Entity>.md` in the `.ts` — that tag means "this comment came from
+the `.md`; edit the `.md`, not here."
+
+**Sync is bidirectional, but the `.md` wins.** `yarn joist-codegen`:
+
+1. **Backfills** the `.md` from any hand-written `.ts` JSDoc that isn't in the `.md` yet (so a jsdoc you
+   write directly on a field gets pulled into `## Fields` for you), then
+2. **Writes the `.md` back into the `.ts`** JSDocs — so for anything already in the `.md`, the `.md` is
+   the source of truth and will overwrite a divergent `.ts` comment.
+
+Net rule: **to durably document an entity or field, edit the `.md`.** Hand-editing a `@generated` JSDoc
+in the `.ts` gets stomped on the next codegen.
+
+### Field-heading constraints (easy to get wrong)
+
+- `### <fieldName>` must be a **single word** — the parser matches `\w+` only. `### excludeFromBudget`
+  works; `### is excluded`, `` ### `excludeFromBudget` ``, or `### excludeFromBudget (derived)` are **not**
+  recognized as field docs.
+- It must be the **exact** name of a field, relation, or property on the entity, and must sit **under the
+  `## Fields` heading**. Any other `##` heading ends the fields section — so keep all `### fieldName`
+  entries together under the one `## Fields` section (conventionally at the bottom of the file).
+- **Methods don't sync** — only fields/getters/properties/relations get their JSDoc updated.
+
+## 3. Write back what you learn
+
+When you discover something useful/weird/non-obvious while working — record it. This is the point of the
+files. Good triggers to write:
+
+- You just figured out **why** an entity or field exists, or what it really models.
+- A **non-obvious business rule**, invariant, or "this only applies to X clients" exemption.
+- A **gotcha / footgun** — a value that looks stale but isn't, an ordering requirement, a special-cased
+  type.
+- A **cross-entity interaction** or workflow that isn't visible from one file.
+- **Domain vocabulary** a newcomer (human or agent) wouldn't know.
+- A **worked scenario** that makes an abstract entity concrete.
+
+**Don't** document what the code already says plainly (restating a type, signature, or an obvious
+one-liner), or transient implementation detail that will rot.
+
+**Where to put it:**
+
+- Something specific to one field → a `### <fieldName>` block under `## Fields`. It syncs to that
+  member's JSDoc, so it shows on hover/`@generated` in the `.ts`.
+- Broad rationale, scenarios, diagrams, cross-entity workflows, DB constraints, glossary → a free-form
+  `##` section (`## Overview` for the headline, or a custom section like `## Employee Onboarding Flow`).
+
+**Style** (match the existing docs):
+
+- Lead with business meaning and *why*, not mechanics.
+- Use `I.e. ...` worked examples with concrete values.
+- Cross-link related entities with relative links: `[Book](Book.md)`.
+- Reference field/entity names in backticks.
+
+## 4. Workflow to add or update a doc
+
+1. Edit `src/entities/<Entity>.md` (create it if missing — basename must equal the entity, e.g.
+   `Author.md`). For field docs, use the exact member name as a `### ` heading under `## Fields`.
+2. Sync into the JSDocs:
+   ```bash
+   mise exec -- yarn joist-codegen
+   ```
+   (or `mise exec -- yarn codegen` to also run graphql-codegen.)
+3. Verify the `@generated <Entity>.md` JSDoc now appears on the class / field in `src/entities/<Entity>.ts`.
+4. Commit the `.md` **and** the regenerated `.ts` JSDoc changes together.
+
+Never hand-edit a `@generated <Entity>.md` JSDoc in the `.ts` — edit the `.md` and re-run codegen. Do not
+touch files under `src/entities/codegen/` (see the repo's generated-files rules).
+
+## Skeleton for a new doc
+
+```markdown
+# <Entity>
+
+## Overview
+
+<What this entity models and *why* it exists, in business terms. One short paragraph.>
+
+## <Some Business Concept>   <!-- free-form: rationale, scenarios, gotchas, diagrams; NOT synced -->
+
+<Prose, `I.e.` examples, mermaid, cross-links to [OtherEntity](OtherEntity.md).>
+
+## Fields   <!-- each ### below syncs into that member's JSDoc -->
+
+### someField
+
+<Why it exists / the non-obvious rule or gotcha. Exact field name, single word.>
+```

package/skills/joist-em-basics/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: joist-em-basics
+description: Create, load, find, mutate, and save entities with Joist's EntityManager. Use when writing data-access or business logic in a Joist project — anything using em.create, em.load, em.find, em.flush, or walking the entity graph.
+---
+
+<!-- Managed by joist-codegen. Do not edit by hand; re-run codegen to update. -->
+
+# Joist EntityManager basics
+
+The `EntityManager` (`em`) is how entities are loaded from and saved to the
+database. It is a Unit of Work: each request gets its own `em`, which tracks
+the entities it has loaded/created and writes them all out on `em.flush()`.
+
+Entities are always loaded/created _through_ the `em`, never via static methods
+on the class (Joist is not ActiveRecord). IDs are tagged strings like `"a:1"`.
+
+## Creating
+
+`em.create` is synchronous and returns the new entity immediately:
+
+```ts
+const author = em.create(Author, { firstName: "a1" });
+// Nested/related entities can be created inline
+const author = em.create(Author, { firstName: "a1", address: { street: "123 Main" } });
+```
+
+## Loading by id
+
+Use tagged ids. These throw if the id does not exist (except the `IfExists`
+variants):
+
+```ts
+const a = await em.load(Author, "a:1");
+const as = await em.loadAll(Author, ["a:1", "a:2"]);
+const as = await em.loadAllIfExists(Author, ["a:1", "a:2"]); // skips missing ids
+```
+
+To eagerly load relations, pass a populate hint as the 3rd argument; the
+returned entity is typed as "loaded" so the relations can be read synchronously:
+
+```ts
+const a = await em.load(Author, "a:1", { books: "reviews" });
+a.books.get.flatMap((b) => b.reviews.get);
+```
+
+## Walking the graph
+
+~90% of reads are just navigating relations from an entity you already have.
+These are guaranteed N+1-safe, even in a loop:
+
+```ts
+const author = await book.author.load();        // load a single relation
+const reviews = await publisher.load((p) => p.books.reviews); // lens
+const loaded = await author.populate({ books: "reviews" });   // populate + .get
+```
+
+## Finding (filtered queries)
+
+`em.find` issues a `SELECT` with a "join literal" of nested relations plus
+inline `WHERE` conditions. It is batch/N+1-safe.
+
+```ts
+const books = await em.find(Book, { author: { firstName: "a1" } });
+const recent = await em.find(Book, { publishedAt: { gte: jan1 } });
+const some = await em.find(Author, { firstName: { in: ["a1", "a2"] } });
+
+const one = await em.findOne(Book, { title: "b1" });        // undefined if none
+const one = await em.findOneOrFail(Book, { title: "b1" });  // throws if none
+const one = await em.findOrCreate(Author, { email: "a@b.com" });
+```
+
+`undefined` values are pruned (the condition and any now-unused join are
+dropped), so filters compose cleanly. To filter for null, pass `null`
+explicitly, e.g. `{ firstName: null }`. For `OR` / nested boolean logic, use
+`alias`/`aliases` with a `conditions` argument. For aggregates or group-bys,
+drop down to Knex/Kysely — Joist's `find` only returns whole entities.
+
+## Mutating
+
+Assign fields directly, or use `.set` for a batch of changes:
+
+```ts
+author.firstName = "a2";
+author.set({ firstName: "a2", lastName: "b2" });
+```
+
+For partial/RPC-style updates (treating `null` as "unset"), and for
+incrementally updating children, see the `joist-upsert` skill.
+
+## Deleting
+
+```ts
+const a = await em.load(Author, "a:1");
+em.delete(a);
+```
+
+## Saving with `em.flush()`
+
+`em.flush()` is where everything happens. It is async and:
+
+1. Runs lifecycle hooks and validation rules,
+2. Opens a transaction,
+3. Issues batched `INSERT`/`UPDATE`/`DELETE` (one batch per entity type),
+4. Commits.
+
+You don't write individual SQL statements — let Joist batch them. `flush` can
+be called multiple times as you do more work:
+
+```ts
+const author = em.create(Author, { firstName: "a1" });
+await em.flush();
+author.firstName = "a2";
+await em.flush();
+```