genesis-stack 1.1.3 → 1.1.5

package/README.md

@@ -49,6 +49,11 @@ Do not add technology-specific knowledge or dependencies to
 `genesis-compiler`, and do not create one catalog package per framework unless
 the single-catalog model becomes genuinely unworkable.
 
+The `sqlite` piece covers persistent filenames, transactions, migrations and
+consistent backups. `laravel-sqlite` adds Laravel's `DB_DATABASE` filename
+binding and `DB_CONNECTION=sqlite` default. Hosts own provisioning; applications
+own schema changes and preservation of existing data during adoption.
+
 ## Resource-estimate proposals
 
 JSKIT proposes Vibe64's optional `Resource estimates` section for its concrete

package/genesis.templates.json

@@ -4,16 +4,24 @@
     {
       "id": "jskit/public",
       "technology": "jskit",
-      "name": "JSKIT · Public app",
-      "description": "Fastify and Vue with an adaptive shell. No accounts or database.",
+      "name": "JSKIT · Basic app",
+      "description": "Adaptive shell and ready unit, client and browser tests. No accounts or database.",
       "repository": "https://github.com/vibe64-dev/seed-jskit.git",
       "branch": "public"
     },
+    {
+      "id": "jskit/database",
+      "technology": "jskit",
+      "name": "JSKIT · Database app",
+      "description": "Adaptive shell, MySQL migrations and isolated database/browser tests. No accounts.",
+      "repository": "https://github.com/vibe64-dev/seed-jskit.git",
+      "branch": "database"
+    },
     {
       "id": "jskit/accounts",
       "technology": "jskit",
-      "name": "JSKIT · Accounts and database",
-      "description": "Adaptive shell, sign-up and login, a private home, and MySQL persistence.",
+      "name": "JSKIT · Accounts app",
+      "description": "Sign-up, login, a private home, MySQL persistence and isolated database/browser tests.",
       "repository": "https://github.com/vibe64-dev/seed-jskit.git",
       "branch": "accounts"
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genesis-stack",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "The optional curated technology Stack catalog for Genesis projects.",
   "type": "module",
   "repository": {

package/stacks/pieces/jskit.md

@@ -111,6 +111,18 @@ https://mobily-enterprises.github.io/jskit-ai/
 
 - Dotenv `.env`
 
+## UI discovery
+
+### Discovery `vue-pages`: Application pages
+
+- Adapter: `jskit`
+- Surface: `app`
+- Mode: `filesystem`
+- Page root: `src/pages`
+- Registration: `vite.config.mjs`
+- Component root: `src/components`
+- Component root: `packages`
+
 ## City regions
 
 - Ignore `**/test/**`

package/stacks/pieces/laravel-mysql.md

@@ -12,6 +12,7 @@ Laravel MySQL connection, migration, Eloquent, and database environment conventi
 ## Conflicts
 
 - `laravel-postgresql`
+- `laravel-sqlite`
 
 ## Environment defaults
 

package/stacks/pieces/laravel-postgresql.md

@@ -12,6 +12,7 @@ Laravel PostgreSQL connection, migration, Eloquent, and database environment con
 ## Conflicts
 
 - `laravel-mysql`
+- `laravel-sqlite`
 
 ## Environment defaults
 

package/stacks/pieces/laravel-sqlite.md

@@ -0,0 +1,57 @@
+# Stack piece: laravel-sqlite
+
+## Description
+
+Laravel SQLite connection, migration, and database filename conventions.
+
+## Requires
+
+- `laravel`
+- `sqlite`
+
+## Conflicts
+
+- `laravel-mysql`
+- `laravel-postgresql`
+
+## Environment defaults
+
+- Default `DB_CONNECTION`: `sqlite`
+
+## Resources
+
+```json genesis-resource
+{
+  "id": "database",
+  "kind": "sqlite",
+  "environmentAlternatives": [
+    {
+      "bindings": {
+        "database": "DB_DATABASE"
+      },
+      "preferred": true
+    }
+  ]
+}
+```
+
+## Guidance
+
+- Confirm `config/database.php` uses `DB_DATABASE` for the SQLite filename and
+  `DB_CONNECTION` for the driver. Keep the project Resource contract aligned
+  with any application-specific names. Laravel expects an absolute filename;
+  preserve a host-supplied value. For standalone setup, create the selected file
+  only if absent and configure its absolute path before migration.
+- Verify the selected PHP runtime includes `pdo_sqlite`. Use the application's
+  migrations and seeders, and declare their exact commands in the project setup
+  and deployment contracts. Repeated setup must preserve records, the migration
+  ledger, and the existing application key; do not use `migrate:fresh` or
+  regenerate keys as routine preparation.
+- Consult the installed Laravel version's SQLite configuration documentation at
+  `https://laravel.com/docs/database#sqlite-configuration`.
+
+## Adoption
+
+- Read the database configuration and existing environment before declaring
+  readiness. Preserve any existing SQLite data when adopting managed storage.
+  Verify migrations on the configured file and keep test connections separate.

package/stacks/pieces/laravel.md

@@ -55,7 +55,7 @@ conventions. Authoritative framework documentation: https://laravel.com/docs/
 - Record actual Composer and frontend installation, test, build, development,
   queue, scheduler, migration, and production operations. Do not assume the
   catalog proposal matches an older application.
-- When the app uses MySQL or PostgreSQL, select the matching Laravel database
+- When the app uses MySQL, PostgreSQL or SQLite, select the matching Laravel database
   integration so its conventional environment names become explicit.
 
 ## Environment files

package/stacks/pieces/nodejs.md

@@ -34,6 +34,18 @@ Node.js package, command, module, dependency, and test conventions.
 - Identify the package manager from the lockfile and preserve the existing
   module system, supported Node.js version, package entrypoints, and executable
   commands.
+- For optional architecture package boundaries, propose a project-owned
+  `## Package discovery` section with `### Discovery \`npm\`: Direct dependencies`,
+  `- Adapter: \`npm\``, `- Manifest: \`package.json\`` and
+  `- Package root: \`node_modules\``. These are npm's usual project defaults,
+  not a scan of every manifest or dependency tree. Declare additional manifests
+  explicitly for independent packages, relative to the project; the package root
+  is relative to each manifest's directory. Preserve an existing declaration.
+  Only direct declarations and declared public entry files are inspected.
+  Project-owned `file:` dependencies remain inspectable source; installed
+  external packages are opaque. Linked or unavailable entries, runtime exports,
+  re-exports and unsupported parsers retain explicit partial coverage. Do not
+  install dependencies just to open an architecture view.
 - Record the source's real dependency installation, build, verification,
   development, and production commands. Do not assume `npm run develop`,
   `npm test`, or `npm start` exists merely because a current foundation uses it.

package/stacks/pieces/sqlite.md

@@ -0,0 +1,44 @@
+# Stack piece: sqlite
+
+## Description
+
+SQLite file-backed persistence, migrations, and backup conventions.
+
+## Requires
+
+- Nothing.
+
+## Guidance
+
+- For application integrations and payments, `integrations.json` remains the
+  configuration authority; SQLite stores app-owned connections, provider mappings,
+  event receipts, subscriptions and credit records only when the app needs them.
+  Keep provider secrets under the application's secret-storage policy.
+- Provider calls, signature verification and authorization belong to the app's
+  runtime. Database configuration alone does not implement a provider, and the
+  editor does not acquire ownership of application billing records.
+- Use the application's existing SQLite driver and migration owner. Declare a
+  persistent database filename through the `database` resource semantic and
+  the environment name the application actually reads. A driver selector such
+  as `DB_CONNECTION=sqlite` is configuration, not a database filename.
+- Keep durable database files outside disposable build and release directories.
+  A host may supply a persistent filename; do not replace that value with a
+  repository-relative default or recreate an existing database during setup.
+- Use transactions, foreign-key enforcement, and bounded busy handling. Prove
+  concurrent writes using SQLite itself; a different engine does not establish
+  SQLite's locking behavior.
+- Use SQLite's online backup API or `VACUUM INTO` for a consistent backup of a
+  running database, including committed WAL data. Do not copy only the main file
+  while writers are active. Validate backups and prove restoration before
+  removing the original. See `https://www.sqlite.org/backup.html`.
+- Keep test databases separate from development and production. In-memory
+  databases are useful for tests but are not persistent application resources.
+
+## Adoption
+
+- Identify the configured database filename, driver, migration ledger, journal
+  mode, and any existing data before changing configuration. Preserve a verified
+  snapshot before moving data to a host-managed filename. Do not silently switch
+  an existing application to an empty database.
+- Distinguish fresh creation from migrations of retained data. Record app-owned
+  migration and optional seed commands without resetting the database.