retold 1.0.6 → 4.0.1

package/docs/utility.md

@@ -0,0 +1,63 @@
+# Utility — Build & Documentation Tools
+
+The utility group provides supporting tools for building, documenting, testing, and supervising Retold applications.
+
+## Modules
+
+### [Indoctrinate](/utility/indoctrinate/)
+
+Documentation scaffolding and generation. Scans source trees, catalogs content with automatic label-based metadata, and generates structured output in multiple formats. Powers the Retold documentation hub by generating cross-module catalogs and keyword search indexes.
+
+**Key features:** Content cataloging with label-based filtering, multi-format output (HTML, LaTeX, text), Retold catalog generation for cross-repo documentation, lunr-based keyword index for cross-module search.
+
+**npm:** `indoctrinate` · **Version:** 1.0.x
+
+---
+
+### [Manyfest](/utility/manyfest/)
+
+JSON manifest for consistent data description and parsing across all application layers — database, API, frontend, and UI. Provides address-based access patterns for reading and writing nested object properties with validation and type coercion.
+
+**Key features:** Address-based data access (dot notation and array indexing), type validation and coercion, manifest-driven form generation, schema description for data layers.
+
+**npm:** `manyfest` · **Version:** 1.0.x
+
+---
+
+### [Quackage](/utility/quackage/)
+
+Standardized build tool for Retold modules. Handles browser bundling (Browserify), transpilation, unit testing, file management, JSON view assembly, and documentation generation from a single CLI.
+
+```bash
+npx quack build          # Build browser bundle
+npx quack test           # Run Mocha tests
+npx quack coverage       # Generate coverage report
+```
+
+**npm:** `quackage` · **Version:** 1.0.x
+
+---
+
+### [Choreographic](/utility/choreographic/)
+
+Scaffolding for single-run data processing scripts. Provides pre-packaged application services — file reading/writing, logging, and organized output folders — for tasks like data migration, report generation, and batch processing.
+
+**npm:** `choreographic` · **Version:** 1.0.x
+
+---
+
+### [Ultravisor](/utility/ultravisor/)
+
+Process supervision tool for running commands on schedule with LLM integration. Supports distributed nodes, global state, and flexible task types (shell, browser, HTTP, database).
+
+**npm:** `ultravisor` · **Version:** 1.0.x
+
+## All Utility Modules
+
+| Module | Description |
+|--------|-------------|
+| [indoctrinate](/utility/indoctrinate/) | Documentation scaffolding with content cataloging and cross-module search |
+| [manyfest](/utility/manyfest/) | JSON manifest for data description, validation, and address-based access |
+| [quackage](/utility/quackage/) | Build tool for browser bundles, testing, and packaging |
+| [choreographic](/utility/choreographic/) | Scaffolding for single-run data processing scripts |
+| [ultravisor](/utility/ultravisor/) | Process supervision with scheduled tasks and LLM integration |

package/examples/quickstart/README.md

@@ -0,0 +1,47 @@
+# Retold Quickstart Examples
+
+Working examples for each part of the Retold stack, corresponding to the
+[Getting Started](../../docs/getting-started.md) documentation.
+
+Retold applications are assembled from a layered architecture (see
+[Architecture](../../docs/architecture.md)):
+
+```
+Layer 5 — Your Application (business logic, custom endpoints)
+Layer 4 — Orator (HTTP server, middleware, static files)
+Layer 3 — Meadow-Endpoints (auto-generated CRUD routes)
+Layer 2 — Meadow + FoxHound + Stricture (data broker, SQL, schemas)
+Layer 1 — Fable (DI, configuration, logging, UUID, expressions)
+
+Pict   — Browser MVC (views, templates, providers, application lifecycle)
+Utility — Build tools, manifest management, documentation, process supervision
+```
+
+## Examples
+
+| Folder | Retold Layer | Module | Description |
+|--------|-------------|--------|-------------|
+| [layer1](layer1/) | Layer 1 — Fable | **Fable** | Core DI, configuration, logging, service provider pattern |
+| [layer2](layer2/) | Layer 2 — Meadow | **Meadow** | Data access with MySQL (CRUD, schemas, FoxHound queries) |
+| [layer3](layer3/) | Layer 4 — Orator | **Orator** | REST API server with Restify |
+| [layer4](layer4/) | Pict | **Pict** | Browser MVC with views, templates, and routing |
+| [layer5](layer5/) | Utility | **Manyfest** | Object navigation and schema validation |
+
+## Running
+
+Each example is self-contained. Enter any directory and run:
+
+```bash
+npm install
+npm start        # or npm run demo for examples that need setup
+```
+
+The Meadow example (layer2) requires a running MySQL server on localhost:3306.
+Run `npm run setup` first to create the database and tables.
+
+The Pict example (layer4) requires a build step before serving:
+
+```bash
+npm install
+npm run demo     # builds then serves on http://localhost:8086
+```

package/examples/quickstart/layer1/README.md

@@ -0,0 +1,21 @@
+# Layer 1: Fable - The Foundation
+
+> Retold Layer 1 — Core Ecosystem: dependency injection, configuration, logging,
+> UUID generation, expressions
+
+Fable is the foundation of every Retold application. All other modules depend on
+it and register as services through the Fable service provider pattern.
+
+## Run
+
+```bash
+npm install
+npm start
+```
+
+## What This Demonstrates
+
+- Creating a Fable instance with configuration
+- Logging at different levels
+- UUID generation
+- The service provider pattern (creating and using custom services)

package/examples/quickstart/layer1/index.js

@@ -0,0 +1,49 @@
+const libFable = require('fable');
+
+// 1. Create a Fable instance with configuration
+let _Fable = new libFable(
+	{
+		Product: 'BookStore',
+		ProductVersion: '1.0.0'
+	});
+
+// 2. Logging
+_Fable.log.info('BookStore starting up...');
+_Fable.log.info(`Product: ${_Fable.settings.Product} v${_Fable.settings.ProductVersion}`);
+
+// 3. UUID generation
+_Fable.log.info(`Generated UUID: ${_Fable.getUUID()}`);
+
+// 4. Service Provider pattern: create a custom service
+class BookService extends libFable.ServiceProviderBase
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		super(pFable, pOptions, pServiceHash);
+		this.serviceType = 'BookService';
+		this._Books = [];
+	}
+
+	addBook(pTitle, pAuthor)
+	{
+		let tmpBook = { id: this.fable.getUUID(), title: pTitle, author: pAuthor };
+		this._Books.push(tmpBook);
+		this.fable.log.info(`Added book: "${pTitle}" by ${pAuthor}`);
+		return tmpBook;
+	}
+
+	listBooks()
+	{
+		return this._Books;
+	}
+}
+
+// 5. Register and use the service
+_Fable.serviceManager.addServiceType('BookService', BookService);
+_Fable.serviceManager.instantiateServiceProvider('BookService');
+
+_Fable.BookService.addBook('The Hobbit', 'J.R.R. Tolkien');
+_Fable.BookService.addBook('Dune', 'Frank Herbert');
+
+_Fable.log.info(`Total books: ${_Fable.BookService.listBooks().length}`);
+_Fable.log.info('Layer 1 example complete.');

package/examples/quickstart/layer1/package-lock.json

@@ -0,0 +1,344 @@
+{
+	"name": "retold-quickstart-layer1-fable",
+	"version": "1.0.0",
+	"lockfileVersion": 3,
+	"requires": true,
+	"packages": {
+		"": {
+			"name": "retold-quickstart-layer1-fable",
+			"version": "1.0.0",
+			"dependencies": {
+				"fable": "^3.1.51"
+			}
+		},
+		"node_modules/async.eachlimit": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.eachlimit/-/async.eachlimit-0.5.2.tgz",
+			"integrity": "sha512-emWKSFjCbXnrCJfM2NBMyriJQrdem+LrchiMQtCavBQnJ80N2C7IBhUz8vXnjYYh+aAkY0zZSofNxVYJMTDMIw==",
+			"license": "MIT",
+			"dependencies": {
+				"async.util.eachoflimit": "0.5.2",
+				"async.util.withoutindex": "0.5.2"
+			}
+		},
+		"node_modules/async.iterator": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.iterator/-/async.iterator-0.5.2.tgz",
+			"integrity": "sha512-Ryg+D9tPYvcHbI3HknGfd6cgQaevwv/9lBpa3KbFrNWDcpsvc4BbpQLGpvaLNCJXM0Uzty/GDKuI2XktiIe0Ng==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.eachoflimit": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.eachoflimit/-/async.util.eachoflimit-0.5.2.tgz",
+			"integrity": "sha512-oZksH0sBW0AEOJKgBCQ79io9DZruoRBLTAea/Ik36pejR7pDpByvtXeuJsoZdPwSVslsrQcsUfucbUaiXYBnAQ==",
+			"license": "MIT",
+			"dependencies": {
+				"async.util.keyiterator": "0.5.2",
+				"async.util.noop": "0.5.2",
+				"async.util.once": "0.5.2",
+				"async.util.onlyonce": "0.5.2"
+			}
+		},
+		"node_modules/async.util.ensureasync": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.ensureasync/-/async.util.ensureasync-0.5.2.tgz",
+			"integrity": "sha512-sQufNz4JYLHO/7ZUklaTGJtiX36gCp28McNNcMZfVYPm/wqi1pKk4xRCPr2DOZDM6KfA54zjG36jQjBU2mLzXg==",
+			"license": "MIT",
+			"dependencies": {
+				"async.util.restparam": "0.5.2",
+				"async.util.setimmediate": "0.5.2"
+			}
+		},
+		"node_modules/async.util.isarray": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.isarray/-/async.util.isarray-0.5.2.tgz",
+			"integrity": "sha512-wbUzlrwON8RUgi+v/rhF0U99Ce8Osjcn+JP/mFNg6ymvShcobAOvE6cvLajSY5dPqKCOE1xfdhefgBif11zZgw==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.isarraylike": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.isarraylike/-/async.util.isarraylike-0.5.2.tgz",
+			"integrity": "sha512-DbFpsz3ZFNkohAW8IpGTlm8gotU32zpqe3Y2XkEA/G3XNO6rmUTKPpo7XgXUruoI+AsGi8+0zWpJHe7t1sLiAg==",
+			"license": "MIT",
+			"dependencies": {
+				"async.util.isarray": "0.5.2"
+			}
+		},
+		"node_modules/async.util.keyiterator": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.keyiterator/-/async.util.keyiterator-0.5.2.tgz",
+			"integrity": "sha512-cktrETawCwgu13y3KZs2uMGFnNHc+IjKPZsavtRaoCjLELkePb2co4zrr+ghPvEqLXZIJPTKqC2HFZgJTssMVw==",
+			"license": "MIT",
+			"dependencies": {
+				"async.util.isarraylike": "0.5.2",
+				"async.util.keys": "0.5.2"
+			}
+		},
+		"node_modules/async.util.keys": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.keys/-/async.util.keys-0.5.2.tgz",
+			"integrity": "sha512-umCOCRCRYwIC2Ho3fbuhKwIIe7OhQsVoVKGoF5GoQiGJUmjP4TG0Bmmcdpm7yW/znoIGKpnjKzVQz0niH4tfqw==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.noop": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.noop/-/async.util.noop-0.5.2.tgz",
+			"integrity": "sha512-AdwShXwE0KoskgqVJAck8zcM32nIHj3AC8ZN62ZaR5srhrY235Nw18vOJZWxcOfhxdVM0hRVKM8kMx7lcl7cCQ==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.once": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.once/-/async.util.once-0.5.2.tgz",
+			"integrity": "sha512-YQ5WPzDTt2jlblUDkq2I5RV/KiAJErJ4/0cEFhYPaZzqIuF/xDzdGvnEKe7UeuoMszsVPeajzcpKgkbwdb9MUA==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.onlyonce": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.onlyonce/-/async.util.onlyonce-0.5.2.tgz",
+			"integrity": "sha512-UgQvkU9JZ+I0Cm1f56XyGXcII+J3d/5XWUuHpcevlItuA3WFSJcqZrsyAUck2FkRSD8BwYQX1zUTDp3SJMVESg==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.restparam": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.restparam/-/async.util.restparam-0.5.2.tgz",
+			"integrity": "sha512-Q9Z+zgmtMxFX5i7CnBvNOkgrL5hptztCqwarQluyNudUUk4iCmyjmsQl8MuQEjNh3gGqP5ayvDaextL1VXXgIg==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.setimmediate": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.setimmediate/-/async.util.setimmediate-0.5.2.tgz",
+			"integrity": "sha512-aCYF85ZFCQ9Xn0106GcOVx+LvFguIIzfbfRTOlQoie3G4KeSjURfA6f7CfpFAF09FNP2A1MtdjeFdvYeTGDebw==",
+			"license": "MIT"
+		},
+		"node_modules/async.util.withoutindex": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.util.withoutindex/-/async.util.withoutindex-0.5.2.tgz",
+			"integrity": "sha512-CTHbQc+1kHkK6izoXIVIiYjePgmAzvXecETn/eVuzhwL9BDC3oFLNiIrr57fKwyarZyy8PedVIpQNrqgA9KzNA==",
+			"license": "MIT"
+		},
+		"node_modules/async.waterfall": {
+			"version": "0.5.2",
+			"resolved": "https://registry.npmjs.org/async.waterfall/-/async.waterfall-0.5.2.tgz",
+			"integrity": "sha512-3eC5jwgBF0/CNTAwBQYCMybqd6ResDwsdyl3+i5qf1L7fYekVR5gbMzpBca7VoZj1W0BFsHcvjW3UeJstEt2kQ==",
+			"license": "MIT",
+			"dependencies": {
+				"async.iterator": "0.5.2",
+				"async.util.ensureasync": "0.5.2",
+				"async.util.isarray": "0.5.2",
+				"async.util.noop": "0.5.2",
+				"async.util.once": "0.5.2",
+				"async.util.restparam": "0.5.2"
+			}
+		},
+		"node_modules/big.js": {
+			"version": "7.0.1",
+			"resolved": "https://registry.npmjs.org/big.js/-/big.js-7.0.1.tgz",
+			"integrity": "sha512-iFgV784tD8kq4ccF1xtNMZnXeZzVuXWWM+ERFzKQjv+A5G9HC8CY3DuV45vgzFFcW+u2tIvmF95+AzWgs6BjCg==",
+			"license": "MIT",
+			"engines": {
+				"node": "*"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/bigjs"
+			}
+		},
+		"node_modules/cachetrax": {
+			"version": "1.0.4",
+			"resolved": "https://registry.npmjs.org/cachetrax/-/cachetrax-1.0.4.tgz",
+			"integrity": "sha512-VoqtXp+tEdcbmiR0eJcdERsaBKhmdeVjpZ2jeVadDq25iM7hvZAFu+BCKMHitWzpkgb/Dw4RAouQBGnXbADPBg==",
+			"license": "MIT",
+			"dependencies": {
+				"fable-serviceproviderbase": "^3.0.7"
+			}
+		},
+		"node_modules/cookie": {
+			"version": "1.1.1",
+			"resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz",
+			"integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=18"
+			},
+			"funding": {
+				"type": "opencollective",
+				"url": "https://opencollective.com/express"
+			}
+		},
+		"node_modules/data-arithmatic": {
+			"version": "1.0.7",
+			"resolved": "https://registry.npmjs.org/data-arithmatic/-/data-arithmatic-1.0.7.tgz",
+			"integrity": "sha512-Z1SBuORrjrlCx9AAx2Cy4yBYrsqtKEz7BzdcLWLMT/t78q3N5/4qjA+63zeMYUAvp9EsIKfQ8X0++Ls9xwaLag==",
+			"license": "MIT",
+			"dependencies": {
+				"fable-serviceproviderbase": "^3.0.2"
+			}
+		},
+		"node_modules/dayjs": {
+			"version": "1.11.19",
+			"resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.19.tgz",
+			"integrity": "sha512-t5EcLVS6QPBNqM2z8fakk/NKel+Xzshgt8FFKAn+qwlD1pzZWxh0nVCrvFK7ZDb6XucZeF9z8C7CBWTRIVApAw==",
+			"license": "MIT"
+		},
+		"node_modules/decompress-response": {
+			"version": "6.0.0",
+			"resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
+			"integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==",
+			"license": "MIT",
+			"dependencies": {
+				"mimic-response": "^3.1.0"
+			},
+			"engines": {
+				"node": ">=10"
+			},
+			"funding": {
+				"url": "https://github.com/sponsors/sindresorhus"
+			}
+		},
+		"node_modules/fable": {
+			"version": "3.1.53",
+			"resolved": "https://registry.npmjs.org/fable/-/fable-3.1.53.tgz",
+			"integrity": "sha512-2b7sWs1K3Bl9V8biZ5VSy36YvojanAAKvOZM7hGMg+opLLt/Pk/lIEvucz4m16Vz+C3UDLWf7WKJqdBoEj8A1w==",
+			"license": "MIT",
+			"dependencies": {
+				"async.eachlimit": "^0.5.2",
+				"async.waterfall": "^0.5.2",
+				"big.js": "^7.0.1",
+				"cachetrax": "^1.0.4",
+				"cookie": "^1.0.2",
+				"data-arithmatic": "^1.0.7",
+				"dayjs": "^1.11.19",
+				"fable-log": "^3.0.16",
+				"fable-serviceproviderbase": "^3.0.16",
+				"fable-settings": "^3.0.12",
+				"fable-uuid": "^3.0.11",
+				"manyfest": "^1.0.43",
+				"simple-get": "^4.0.1"
+			}
+		},
+		"node_modules/fable-log": {
+			"version": "3.0.16",
+			"resolved": "https://registry.npmjs.org/fable-log/-/fable-log-3.0.16.tgz",
+			"integrity": "sha512-o9/eIdak/iDy8Cc+Q8NeYUf7AwqYZvr3EaeeGmVd6X7+Ao/c1y5u9x5I54WZmwcYcySukmf2BEiQvS/itoliVw==",
+			"license": "MIT",
+			"dependencies": {
+				"fable-serviceproviderbase": "^3.0.15"
+			}
+		},
+		"node_modules/fable-serviceproviderbase": {
+			"version": "3.0.16",
+			"resolved": "https://registry.npmjs.org/fable-serviceproviderbase/-/fable-serviceproviderbase-3.0.16.tgz",
+			"integrity": "sha512-jvv1MO/xSNTInRwCFZz56ON4UNVwcOnLuLJlkfzqKXSbN9O8M6E7TYFExkM/UsG35dzDnApilz6Zmg3FvES4Cg==",
+			"license": "MIT"
+		},
+		"node_modules/fable-settings": {
+			"version": "3.0.12",
+			"resolved": "https://registry.npmjs.org/fable-settings/-/fable-settings-3.0.12.tgz",
+			"integrity": "sha512-zzvoLcsIp06vNu5dXYV5FSQD1V1APj2IaYbhj8SJ3IHmb9pUrQm63ejGEC4fEEk+jBznHHe+RH6OEwtx6plh+g==",
+			"license": "MIT",
+			"dependencies": {
+				"fable-serviceproviderbase": "^3.0.15",
+				"precedent": "^1.0.15"
+			}
+		},
+		"node_modules/fable-uuid": {
+			"version": "3.0.11",
+			"resolved": "https://registry.npmjs.org/fable-uuid/-/fable-uuid-3.0.11.tgz",
+			"integrity": "sha512-ZNFmcc2HI16J6rqiLfkShzzNgeHjbInM0Ur70tAgXlQm/jWqIpU3OFAyTesrz4dVQ5+wCxjp7PQadF7YJ0hNIw==",
+			"license": "MIT",
+			"dependencies": {
+				"fable-serviceproviderbase": "^3.0.15"
+			}
+		},
+		"node_modules/manyfest": {
+			"version": "1.0.44",
+			"resolved": "https://registry.npmjs.org/manyfest/-/manyfest-1.0.44.tgz",
+			"integrity": "sha512-8sI1zQ5lysMW879Lb5VtksmpOy4M2vZIl2IjIzMo5lOWu1MmLZGX/MQxdBu0Klnf4fJwscainclMYs9/P3JXUQ==",
+			"license": "MIT",
+			"dependencies": {
+				"fable-serviceproviderbase": "^3.0.15"
+			}
+		},
+		"node_modules/mimic-response": {
+			"version": "3.1.0",
+			"resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz",
+			"integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=10"
+			},
+			"funding": {
+				"url": "https://github.com/sponsors/sindresorhus"
+			}
+		},
+		"node_modules/once": {
+			"version": "1.4.0",
+			"resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+			"integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+			"license": "ISC",
+			"dependencies": {
+				"wrappy": "1"
+			}
+		},
+		"node_modules/precedent": {
+			"version": "1.0.15",
+			"resolved": "https://registry.npmjs.org/precedent/-/precedent-1.0.15.tgz",
+			"integrity": "sha512-tidXY4JvTudvJ/Jmb8OzHFpX6qUSPwmS7K/BChA7xDb7eqmfHjH3AAO+IhCz3k7k+bh31YNdblSIEkYnCIYelw==",
+			"license": "MIT",
+			"bin": {
+				"precedent": "bin/Precedent"
+			}
+		},
+		"node_modules/simple-concat": {
+			"version": "1.0.1",
+			"resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz",
+			"integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==",
+			"funding": [
+				{
+					"type": "github",
+					"url": "https://github.com/sponsors/feross"
+				},
+				{
+					"type": "patreon",
+					"url": "https://www.patreon.com/feross"
+				},
+				{
+					"type": "consulting",
+					"url": "https://feross.org/support"
+				}
+			],
+			"license": "MIT"
+		},
+		"node_modules/simple-get": {
+			"version": "4.0.1",
+			"resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz",
+			"integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==",
+			"funding": [
+				{
+					"type": "github",
+					"url": "https://github.com/sponsors/feross"
+				},
+				{
+					"type": "patreon",
+					"url": "https://www.patreon.com/feross"
+				},
+				{
+					"type": "consulting",
+					"url": "https://feross.org/support"
+				}
+			],
+			"license": "MIT",
+			"dependencies": {
+				"decompress-response": "^6.0.0",
+				"once": "^1.3.1",
+				"simple-concat": "^1.0.0"
+			}
+		},
+		"node_modules/wrappy": {
+			"version": "1.0.2",
+			"resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+			"integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+			"license": "ISC"
+		}
+	}
+}

package/examples/quickstart/layer1/package.json

@@ -0,0 +1,12 @@
+{
+	"name": "retold-quickstart-layer1-fable",
+	"version": "1.0.0",
+	"description": "Retold Quickstart: Layer 1 - Fable (Core DI, Configuration, Logging)",
+	"main": "index.js",
+	"scripts": {
+		"start": "node index.js"
+	},
+	"dependencies": {
+		"fable": "^3.1.51"
+	}
+}

package/examples/quickstart/layer2/README.md

@@ -0,0 +1,34 @@
+# Layer 2: Meadow - Data Access
+
+> Retold Layer 2 — Data broker / ORM: Meadow + FoxHound (query DSL) + Stricture
+> (schema DDL), with pluggable database connections (MySQL, MSSQL, SQLite)
+
+Meadow provides provider-agnostic CRUD operations with automatic audit columns,
+soft deletes, and schema-driven query generation through FoxHound.
+
+## Prerequisites
+
+A MySQL server running locally on port 3306 with root access.
+
+## Run
+
+```bash
+npm install
+npm run setup   # Creates the database and table
+npm start       # Runs CRUD operations
+```
+
+Or run both steps together:
+
+```bash
+npm install
+npm run demo
+```
+
+## What This Demonstrates
+
+- Connecting to MySQL via the Meadow connection provider
+- Defining entity schemas (Meadow schema + JSON schema)
+- Full CRUD operations: Create, Read, Reads, Update, Delete
+- FoxHound query builder with filters, sorting, and pagination
+- Audit columns (CreateDate, UpdateDate) and soft deletes