@marktiderman/genesis-cli 1.23.0 → 1.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -2
- package/dist/cli.js +382 -45
- package/dist/cli.js.map +1 -1
- package/dist/{config-HOmiOLQc.d.ts → config-DRHg7V3Z.d.ts} +17 -0
- package/dist/doctor.d.ts +73 -6
- package/dist/doctor.js +309 -12
- package/dist/doctor.js.map +1 -1
- package/dist/expo.d.ts +2 -2
- package/dist/expo.js +20 -0
- package/dist/expo.js.map +1 -1
- package/dist/genesis-catalog.json +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +229 -17
- package/dist/index.js.map +1 -1
- package/dist/templates/ci/claude-review.yml +26 -0
- package/dist/templates/vercel/ignore-build.sh +131 -0
- package/dist/templates/vercel/vercel.json +4 -0
- package/dist/vite.js +221 -9
- package/dist/vite.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -900,7 +900,7 @@ result on its own):
|
|
|
900
900
|
"doctor": {
|
|
901
901
|
"packs": ["native", "supabase"],
|
|
902
902
|
"native": { "routerRoot": "app" },
|
|
903
|
-
"supabase": { "migrations": "supabase/migrations", "base": "origin/main", "exposedSchemas": ["public"], "since": "20260101000000" }
|
|
903
|
+
"supabase": { "migrations": "supabase/migrations", "base": "origin/main", "exposedSchemas": ["public"], "since": "20260101000000", "automaticBranching": false }
|
|
904
904
|
}
|
|
905
905
|
}
|
|
906
906
|
```
|
|
@@ -908,6 +908,8 @@ result on its own):
|
|
|
908
908
|
Pack rule ids are built-in ids, so `rules` and `allow` work on them as on any other rule.
|
|
909
909
|
Folder settings (`routerRoot`, `migrations`) are app-relative: `./app/` is read as `app`, and
|
|
910
910
|
an absolute path or one leaving the app is a config error. `exposedSchemas` compares lowercased.
|
|
911
|
+
`automaticBranching` (true or false; unset counts as true) says whether Supabase makes a branch
|
|
912
|
+
per pull request; `exposed-schema-created-later` reads it.
|
|
911
913
|
|
|
912
914
|
**`native`**, for Expo apps on `@marktiderman/genesis-ui-native`. With the pack on, the core
|
|
913
915
|
rules read the native package (unless `uiPackage` says otherwise) and the default scan is
|
|
@@ -943,6 +945,7 @@ bodies blanked, so text inside a function body never matches; the one exception
|
|
|
943
945
|
| `migration-testing-kit` | error | A migration that uses `genesis_testing`, genesis-supabase's pgTAP kit for test databases only (it signs in as anyone and resets roles). Keep it in `supabase/tests/database/000_genesis_testing.test.sql`. |
|
|
944
946
|
| `contracts-stale` | error | With `doctor.contracts` (`{ out, schemas, databaseEnv }`, defaults `resources.genesis.ts`, the schemas the contract's own `// Source: Postgres (…)` line names (else `["public"]`), `DATABASE_URL`): the contract on disk isn't what `genesis introspect` would write from the database now (the same comparison as `introspect --check`). Without the environment variable it reports one `info` ("not checked") and never fails; a database it can't read is a warning, and a contract it can't generate (an invalid `labelField`, two tables with one name) is an error. The advice names the schemas and, when it isn't `DATABASE_URL`, `--database-env`. A contract whose `// Source:` line isn't Postgres (one written with `--openapi`) is reported as `info` ("not checked"); check it with `genesis introspect --openapi … --check`. Line endings don't count. The Vite plugin skips it in builds and the dev server, so a build never reads a live database: run it with `genesis doctor` in CI. |
|
|
945
947
|
| `migration-view-rls` | error | A view in an exposed schema that runs as its owner once every migration has run: created without `with (security_invoker = true)`, replaced without it, or reset by `alter view … reset (security_invoker)`. A plain view reads past row level security on every table it selects from. `alter view … set (security_invoker = true)`, renames and drops are followed. A view that runs as its owner on purpose (it filters rows itself) takes an `allow` entry: `{ "rule": "migration-view-rls", "match": "public.profile_cards", "reason": "…" }`. |
|
|
948
|
+
| `exposed-schema-created-later` | warn | A schema the Data API serves (`supabase/config.toml` `[api] schemas`, beside the migrations folder, or `exposedSchemas`) that a new Supabase database doesn't have before migrations run: anything but `public`, `graphql_public` and the platform's own schemas (`auth`, `storage`, `extensions`, `graphql`, `realtime`, `vault`). A Supabase branch applies `[api]` before it runs migrations, so a fresh preview branch's Data API points at a schema that doesn't exist yet and fails its health check; the message names the migration that creates it, or says none does. The fix is the Genesis preview standard: turn automatic branching off ([APP-CI.md, "Previews"](../../docs/APP-CI.md#previews)), then record that with `"supabase": { "automaticBranching": false }`, which quiets the migration-created case (a schema no migration creates still warns). Use that, not an `allow` entry: under `--base` a new `allow` entry fails `allow-grew`. The doctor can't see the Supabase dashboard, so `automaticBranching: false` is the app's word, not a check: review a change to it as you would an `allow` entry. It doesn't cover on-demand branches, which run the same steps; check one serves the schema after it migrates. Quiet when `[api] enabled = false`. |
|
|
946
949
|
|
|
947
950
|
**Which migrations are new.** In a git repo with the base ref, a migration is new when it was
|
|
948
951
|
added, modified or is untracked since the merge base. `since` (a file name or timestamp prefix)
|
|
@@ -1143,7 +1146,7 @@ genesis doctor --strict --base origin/main
|
|
|
1143
1146
|
| --- | --- | --- |
|
|
1144
1147
|
| `packs` | | Opt-in rule packs: `"native"`, `"supabase"`. See [Rule packs](#rule-packs). |
|
|
1145
1148
|
| `native` | | `{ routerRoot }` for the native pack. |
|
|
1146
|
-
| `supabase` | | `{ migrations, base, exposedSchemas, since }` for the supabase pack. |
|
|
1149
|
+
| `supabase` | | `{ migrations, base, exposedSchemas, since, automaticBranching }` for the supabase pack. |
|
|
1147
1150
|
| `src` | `["src"]` (`["app", "src", "components"]` with the native pack) | Folders (or files) to scan. |
|
|
1148
1151
|
| `extensions` | `.ts .tsx .js .jsx .mts .cts .css` | |
|
|
1149
1152
|
| `ignore` | | Globs to skip, added to the defaults. `*` stays in a folder, `**` crosses folders, a trailing `/` means the whole folder. |
|
|
@@ -1253,6 +1256,46 @@ if (!result.ok) throw new Error(formatReport(result));
|
|
|
1253
1256
|
the local Vite plugin import with `@marktiderman/genesis-cli/vite`.
|
|
1254
1257
|
4. Run `genesis doctor`, fix or `allow` what it reports (it checks `raw-color` in code as well
|
|
1255
1258
|
as CSS, and `raw-tag` only in JSX files), then delete the old script.
|
|
1259
|
+
|
|
1260
|
+
## genesis agents
|
|
1261
|
+
|
|
1262
|
+
Writes the agent guide from the installed Genesis packages, so every coding agent and reviewer in
|
|
1263
|
+
the app reads the same rules, matched to the versions the app has:
|
|
1264
|
+
|
|
1265
|
+
- **The AGENTS.md block** between `<!-- genesis-primitives:start -->` and
|
|
1266
|
+
`<!-- genesis-primitives:end -->`: the rules, the catalog of what to use for each need, and the
|
|
1267
|
+
path to each installed package's own `SKILL.md` at `node_modules/<package>/SKILL.md`, so it
|
|
1268
|
+
matches the installed version (a package reached only through the umbrella, inside pnpm's store,
|
|
1269
|
+
is left out: that path changes with unrelated dependency bumps). Text outside the markers is the
|
|
1270
|
+
app's own and is never touched.
|
|
1271
|
+
- **`.claude/skills/genesis/SKILL.md`**: the same rules and catalog as a skill.
|
|
1272
|
+
- **`CLAUDE.md`** holding `@AGENTS.md`, only when the app has no `CLAUDE.md`. Reviewers and cloud
|
|
1273
|
+
project threads read CLAUDE.md, not AGENTS.md.
|
|
1274
|
+
|
|
1275
|
+
`genesis agents --hooks` also writes two things into `.claude/settings.json`, keeping everything
|
|
1276
|
+
else there: a `SubagentStart` hook that hands Claude Code's Explore and Plan subagents the same
|
|
1277
|
+
rules and package guides (they start without CLAUDE.md or AGENTS.md), and `permissions.deny`
|
|
1278
|
+
rules for `.env` files, which apply in cloud sessions too. The hook runs
|
|
1279
|
+
`genesis agents --hook subagent-start`, which prints the rules and guides and never fails a
|
|
1280
|
+
session: with no local `genesis` binary (before an install), the subagent simply starts without
|
|
1281
|
+
them. Settings are written only with `--hooks`, so a plain run never touches them; an older hook
|
|
1282
|
+
command is flagged instead (below), and `genesis agents --hooks` updates it.
|
|
1283
|
+
|
|
1284
|
+
Package guides are listed only at paths that stay put: a local package's folder, or
|
|
1285
|
+
`node_modules/<package>/SKILL.md` at the app or a workspace folder above it, up to the repo root,
|
|
1286
|
+
and only when that copy is the one the app resolved.
|
|
1287
|
+
A package reached only through the umbrella lives in pnpm's store, so its guide is left out, and
|
|
1288
|
+
the doctor names it (an info): add the package as a direct dependency to list its guide.
|
|
1289
|
+
|
|
1290
|
+
`genesis agents --check` writes nothing and exits 1 when any of them is missing or stale (for CI);
|
|
1291
|
+
the doctor's `agent-guide-stale` rule warns the same way, and also for an older hook command
|
|
1292
|
+
(fix it with `--hooks`). A
|
|
1293
|
+
CLAUDE.md the app keeps without the import, or a link to AGENTS.md, passes (the doctor notes a
|
|
1294
|
+
missing import as info). A CLAUDE.md that's blocked, by another case of the name such as
|
|
1295
|
+
`claude.md`, a dangling link or a folder, fails until it's fixed by hand, since `genesis agents`
|
|
1296
|
+
never writes over it. `genesis agents --rules` checks the repo against the agent rules of
|
|
1297
|
+
engagement a script can check. Run `genesis agents` after every Genesis upgrade.
|
|
1298
|
+
|
|
1256
1299
|
## genesis figma:routes
|
|
1257
1300
|
|
|
1258
1301
|
A read-only check that an app's Figma app file covers its routes, so CI reports the drift and an
|