genesis-compiler 1.2.0 → 1.2.1

package/README.md

@@ -98,7 +98,7 @@ that, use Codex normally. No technology is assumed until you explicitly select
 Stack components:
 
 ```bash
-genesis stack add nodejs         # or jskit jskit-mysql
+genesis stack add nodejs         # or jskit jskit-mysql / jskit-postgresql
 ```
 
 Genesis does not install substitute generic `nodejs`, `vue`, `php`, or similar
@@ -300,13 +300,13 @@ List and select the built-in Stack components:
 
 ```bash
 genesis stack list
-genesis stack add jskit jskit-mysql
+genesis stack add jskit jskit-mysql      # or jskit-postgresql
 ```
 
 `genesis/stack.md` records component ids and optional project verification
 commands. Selecting no components is valid. Built-in components include the
-eleven common language families listed above, plus Vue, MySQL, JSKIT, and JSKIT
-with MySQL. Components may contribute:
+eleven common language families listed above, plus Vue, MySQL, PostgreSQL,
+JSKIT, and JSKIT database integrations. Components may contribute:
 
 - a concise description and supplemental Guidance used across relevant tasks;
 - one authoritative Agent Skill directory when the component owns one;
@@ -321,7 +321,7 @@ cleanup tasks; `Deslop` adds cleanup-only rules. Neither shadows an official
 generic technology skill nor assumes that an upstream skill contains every rule
 Genesis needs.
 
-Genesis core contains no MySQL, JSKIT, Vue, Laravel, or other platform-specific
+Genesis core contains no database, framework, language, or platform-specific
 controller behavior. See [Stack components](docs/stack-components.md).
 
 ## Verification

package/docs/stack-components.md

@@ -29,6 +29,7 @@ What this component contributes.
 ```json genesis-resource
 {
   "id": "service",
+  "kind": "example-service",
   "environmentAlternatives": [
     { "required": ["SERVICE_URL"] },
     { "required": ["SERVICE_HOST", "SERVICE_PORT"] }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis-compiler",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "An agent-independent prompt, multi-language code-index, cleanup, and verification companion with optional Codex hooks.",
   "repository": {

package/plugins/genesis/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Makes Codex aware of optional Genesis adoption for existing projects.",
   "author": {
     "name": "Mobily Enterprises"

package/src/index/stack-piece.js

@@ -165,10 +165,12 @@ function resources(all, piecePath) {
       !resource
       || typeof resource.id !== 'string'
       || !STACK_PIECE_ID_PATTERN.test(resource.id)
+      || typeof resource.kind !== 'string'
+      || !STACK_PIECE_ID_PATTERN.test(resource.kind)
       || !Array.isArray(resource.environmentAlternatives)
       || resource.environmentAlternatives.length === 0
     ) {
-      invalid(piecePath, 'A Stack resource needs an id and at least one environment alternative.');
+      invalid(piecePath, 'A Stack resource needs an id, kind, and at least one environment alternative.');
     }
     const environmentAlternatives = resource.environmentAlternatives.map((alternative) => {
       const required = alternative?.required;
@@ -189,7 +191,7 @@ function resources(all, piecePath) {
       ) invalid(piecePath, `Stack resource ${resource.id} has an invalid environment alternative.`);
       return { required: [...required], allowEmpty: [...allowEmpty] };
     });
-    return { id: resource.id, environmentAlternatives };
+    return { id: resource.id, kind: resource.kind, environmentAlternatives };
   });
   if (new Set(parsed.map(({ id }) => id)).size !== parsed.length) {
     invalid(piecePath, '## Resources contains a duplicate resource id.');

package/stacks/pieces/jskit-mysql.md

@@ -9,11 +9,16 @@ JSKIT MySQL runtime, live-schema CRUD generation, and persistence conventions.
 - `jskit`
 - `mysql`
 
+## Conflicts
+
+- `jskit-postgresql`
+
 ## Resources
 
 ```json genesis-resource
 {
   "id": "database",
+  "kind": "mysql",
   "environmentAlternatives": [
     {
       "required": ["DATABASE_URL"]

package/stacks/pieces/jskit-postgresql.md

@@ -0,0 +1,42 @@
+# Stack piece: jskit-postgresql
+
+## Description
+
+JSKIT PostgreSQL runtime, live-schema CRUD generation, and persistence conventions.
+
+## Requires
+
+- `jskit`
+- `postgresql`
+
+## Conflicts
+
+- `jskit-mysql`
+
+## Resources
+
+```json genesis-resource
+{
+  "id": "database",
+  "kind": "postgresql",
+  "environmentAlternatives": [
+    {
+      "required": ["DATABASE_URL"]
+    },
+    {
+      "required": ["DB_CLIENT", "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/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.