genesis-compiler 1.2.0 → 1.2.2

package/src/index.js

@@ -7,6 +7,7 @@ import { generateProjectPrompt } from './index/prompt.js';
 import { initializeProject } from './index/init.js';
 import { installCodexPlugin } from './index/codex-plugin.js';
 import { inspectProjectEnvironment } from './index/environment-files.js';
+import { inspectProjectDeployment } from './index/deployment.js';
 import { inspectProjectLaunch } from './index/launch.js';
 import { listBuiltinStackPieces } from './index/stack-catalog.js';
 import { addStackPieces } from './index/stack.js';
@@ -77,6 +78,10 @@ export function inspectEnvironment(options) {
   return inspectProjectEnvironment(options);
 }
 
+export function inspectDeployment(options) {
+  return inspectProjectDeployment(options);
+}
+
 export function inspectWorkspaceSetup(options) {
   return inspectProjectWorkspaceSetup(options);
 }

package/stacks/pieces/jskit-mysql.md

@@ -9,17 +9,26 @@ JSKIT MySQL runtime, live-schema CRUD generation, and persistence conventions.
 - `jskit`
 - `mysql`
 
+## Conflicts
+
+- `jskit-postgresql`
+
+## Environment defaults
+
+- Default `DB_CLIENT`: `mysql2`
+
 ## Resources
 
 ```json genesis-resource
 {
   "id": "database",
+  "kind": "mysql",
   "environmentAlternatives": [
     {
       "required": ["DATABASE_URL"]
     },
     {
-      "required": ["DB_CLIENT", "DB_HOST", "DB_PORT", "DB_NAME", "DB_USER", "DB_PASSWORD"],
+      "required": ["DB_HOST", "DB_PORT", "DB_NAME", "DB_USER", "DB_PASSWORD"],
       "allowEmpty": ["DB_PASSWORD"]
     }
   ]

package/stacks/pieces/jskit-postgresql.md

@@ -0,0 +1,46 @@
+# Stack piece: jskit-postgresql
+
+## Description
+
+JSKIT PostgreSQL runtime, live-schema CRUD generation, and persistence conventions.
+
+## Requires
+
+- `jskit`
+- `postgresql`
+
+## Conflicts
+
+- `jskit-mysql`
+
+## Environment defaults
+
+- Default `DB_CLIENT`: `pg`
+
+## Resources
+
+```json genesis-resource
+{
+  "id": "database",
+  "kind": "postgresql",
+  "environmentAlternatives": [
+    {
+      "required": ["DATABASE_URL"]
+    },
+    {
+      "required": ["DB_HOST", "DB_PORT", "DB_NAME", "DB_USER", "DB_PASSWORD"],
+      "allowEmpty": ["DB_PASSWORD"]
+    }
+  ]
+}
+```
+
+## Deslop
+
+- Use the installed JSKIT database runtime and generated resource/repository
+  seams; do not add a second client, connection factory, CRUD transport, or
+  file-persistence fallback.
+- Keep environment normalization, transactions, row mapping, and database
+  error translation at one established persistence boundary.
+- Never compete with or rewrite a generator-owned baseline migration. Preserve
+  retained migration history and data semantics.

package/stacks/pieces/jskit.md

@@ -2,8 +2,8 @@
 
 ## Description
 
-JSKIT application creation, package generators, Vue surfaces, app-owned
-generated files, and runtime composition.
+AI-first JSKIT runtime capabilities, tested source patterns, Vue surfaces, and
+application-owned composition.
 
 ## Requires
 
@@ -18,7 +18,7 @@ generated files, and runtime composition.
 
 - Before creating or modifying JSKIT Vue/Vuetify UI, load the installed
   `jskit` Agent Skill and read its `references/material-3.md` completely.
-- Implement Material 3 through JSKIT generators, shared screens, shell and
+- Implement Material 3 through JSKIT patterns, shared screens, shell and
   placement seams, app-owned theme configuration, and supported Vuetify APIs.
 - Use geometry-preserving Material skeletons for all user-visible loading;
   never use a generic spinner or circular progress indicator, or let content
@@ -30,6 +30,7 @@ generated files, and runtime composition.
 ## Workspace setup
 
 - Prepare `Install dependencies` with `nodejs` when `package.json` exists: `npm` `install`
+- Prepare `Prepare database` with `nodejs` if `scripts/prepare-database.js` exists: `npm` `run` `db:prepare`
 
 ## Environment files
 
@@ -42,21 +43,30 @@ generated files, and runtime composition.
 - Default.
 - Preferred port: `3000`
 - URL path: `/`
+- Ready when: `GET` `/api/health` returns `200`
 - Runtimes: `nodejs`
-- Prepare `Build`: `npm` `run` `build`
+- Serve `Develop`: `npm` `run` `develop`
+
+## Deployment
+
+- Runtimes: `nodejs`
+- Ready when: `GET` `/api/health` returns `200`
+- Prepare `Install dependencies`: `npm` `install`
+- Build `Build`: `npm` `run` `build`
+- Migrate `Prepare database`: `npm` `run` `db:prepare`
 - Serve `Start`: `npm` `start`
 
 ## Deslop
 
 - For every affected JSKIT screen, load the installed `jskit` Agent Skill,
   read `references/material-3.md`, and execute its Material 3 audit.
-- Use JSKIT generators, packages, resources, composables, screens, and
-  placement seams instead of parallel framework plumbing.
-- Treat generated output as app-owned and customizable. Adapt routes,
-  placements, and infrastructure tests coherently; when replacing a starter
+- Use JSKIT patterns, packages, resources, composables, screens, and placement
+  seams instead of parallel framework plumbing.
+- Treat copied pattern source as app-owned and customizable. Adapt routes,
+  placements, and infrastructure tests coherently; when replacing a foundation
   route, update its baseline browser coverage instead of deleting it.
 - Consolidate repeated validation, pending/error state, API access, and page
-  behavior at the generated shared resource or established JSKIT seam.
+  behavior at the shared resource or established JSKIT seam.
 - Replace transient command-error alerts that shift page content with the
   established JSKIT action feedback/snackbar seam; preserve stable in-page
   resource-load errors, retry states, and field validation.

package/stacks/pieces/postgresql.md

@@ -0,0 +1,18 @@
+# Stack piece: postgresql
+
+## Description
+
+PostgreSQL persistence and migration conventions.
+
+## Requires
+
+- Nothing.
+
+## Deslop
+
+- Keep connection configuration, transaction ownership, and database error
+  translation at one persistence boundary.
+- Use the selected integration's client and migration lifecycle instead of
+  adding parallel connection factories or schema-management code.
+- Preserve migration history and data semantics. Deslop is not permission for
+  destructive schema changes.