@geekmidas/cli 10.0.0-alpha.30 → 10.0.0-alpha.31

package/dist/index.mjs

@@ -37,7 +37,7 @@ import { Subscriber } from "@geekmidas/constructs/subscribers";
 import { Topic } from "@geekmidas/constructs/topic";
 import { lookup } from "node:dns/promises";
 //#region package.json
-var version = "10.0.0-alpha.30";
+var version = "10.0.0-alpha.31";
 //#endregion
 //#region src/auth/credentials.ts
 /**
@@ -8459,7 +8459,34 @@ gkm migrate database                  # apply one construct's
 - A deploy migrates before the new version goes live, so the old version runs
   against the new schema until it is replaced. Keep each migration compatible
   with the code before it: add a column in one release, stop using the old one,
-  drop it in a later release.`;
+  drop it in a later release.
+
+**Migrations hold schema, never data.** Tables, columns, constraints, indexes.
+No inserts, updates or deletes against the application's rows.
+
+- **Data the code defines lives in the code.** A permission catalogue, the
+  system roles, a list of statuses — if a constant in the source already says
+  what they are, a table holding them is a copy, and a copy drifts. Keep the
+  constant; store only what users create (a custom role, which permission keys
+  it grants), checked against the constant in code.
+- **Define it once, typed, where every app can import it.** A catalogue in
+  code belongs in a shared package (\`packages/models\`), declared \`as const\`
+  so its keys are a union type. The API's guards, the web app's gates and a
+  mobile app's gates then all name the same keys, and a typo — or a removed
+  permission still checked somewhere — fails to compile instead of failing
+  closed at runtime.
+- **A rule is not a row.** "Every user is a member", "a super admin has every
+  permission" are logic. A row per user, or a grant per permission, is a
+  snapshot of the rule that goes stale the moment the rule's inputs change.
+- **Nothing needs seeding to run.** If the app fails without some rows present,
+  those rows are code in the wrong place. Sample and demo data comes from test
+  factories — never a migration, never a deploy.
+- **A backfill is the one exception.** When a schema change needs existing rows
+  transformed — a new non-null column filled from an old one — do it in the
+  same migration, keyed on the rows it transforms. It never inserts rows that
+  were not there.
+- **A test that only keeps two copies in step is the smell.** Delete a copy,
+  and the test with it.`;
 }
 function queriesSection() {
 	return `## Writing queries and relations
@@ -8716,26 +8743,26 @@ function loadPackageJson() {
 * Run: pnpm --filter @geekmidas/cli sync-versions
 */
 const GEEKMIDAS_VERSIONS = {
-	"@geekmidas/audit": "~10.0.0-alpha.30",
-	"@geekmidas/auth": "~10.0.0-alpha.30",
-	"@geekmidas/cache": "~10.0.0-alpha.30",
-	"@geekmidas/client": "~10.0.0-alpha.30",
-	"@geekmidas/cloud": "~10.0.0-alpha.30",
-	"@geekmidas/constructs": "~10.0.0-alpha.30",
-	"@geekmidas/db": "~10.0.0-alpha.30",
-	"@geekmidas/emailkit": "~10.0.0-alpha.30",
-	"@geekmidas/envkit": "~10.0.0-alpha.30",
-	"@geekmidas/errors": "~10.0.0-alpha.30",
-	"@geekmidas/events": "~10.0.0-alpha.30",
-	"@geekmidas/logger": "~10.0.0-alpha.30",
-	"@geekmidas/manifest": "~10.0.0-alpha.30",
-	"@geekmidas/rate-limit": "~10.0.0-alpha.30",
-	"@geekmidas/schema": "~10.0.0-alpha.30",
-	"@geekmidas/services": "~10.0.0-alpha.30",
-	"@geekmidas/storage": "~10.0.0-alpha.30",
-	"@geekmidas/studio": "~10.0.0-alpha.30",
-	"@geekmidas/telescope": "~10.0.0-alpha.30",
-	"@geekmidas/testkit": "~10.0.0-alpha.30",
+	"@geekmidas/audit": "~10.0.0-alpha.31",
+	"@geekmidas/auth": "~10.0.0-alpha.31",
+	"@geekmidas/cache": "~10.0.0-alpha.31",
+	"@geekmidas/client": "~10.0.0-alpha.31",
+	"@geekmidas/cloud": "~10.0.0-alpha.31",
+	"@geekmidas/constructs": "~10.0.0-alpha.31",
+	"@geekmidas/db": "~10.0.0-alpha.31",
+	"@geekmidas/emailkit": "~10.0.0-alpha.31",
+	"@geekmidas/envkit": "~10.0.0-alpha.31",
+	"@geekmidas/errors": "~10.0.0-alpha.31",
+	"@geekmidas/events": "~10.0.0-alpha.31",
+	"@geekmidas/logger": "~10.0.0-alpha.31",
+	"@geekmidas/manifest": "~10.0.0-alpha.31",
+	"@geekmidas/rate-limit": "~10.0.0-alpha.31",
+	"@geekmidas/schema": "~10.0.0-alpha.31",
+	"@geekmidas/services": "~10.0.0-alpha.31",
+	"@geekmidas/storage": "~10.0.0-alpha.31",
+	"@geekmidas/studio": "~10.0.0-alpha.31",
+	"@geekmidas/telescope": "~10.0.0-alpha.31",
+	"@geekmidas/testkit": "~10.0.0-alpha.31",
 	"@geekmidas/cli": `~${loadPackageJson().version}`
 };
 //#endregion