realitydb 0.4.0 → 0.4.1

package/README.md

@@ -2,64 +2,70 @@
 
 > Production-like data before production exists.
 
-RealityDB is a developer tool that instantly populates your database with
-realistic, schema-aware data. One command, realistic environments.
-
-## Install
-
-```bash
-npm install -g realitydb
-```
+RealityDB populates your PostgreSQL database with realistic, schema-aware data. Point it at your schema, pick a domain template, and get thousands of rows that look like they came from a real application. Deterministic seeds mean the same command always produces the same data.
 
 ## Quick Start
 
 ```bash
-realitydb scan              # Understand your schema
-realitydb seed --seed 42    # Populate with realistic data
-realitydb reset --confirm   # Clear and start fresh
-```
-
-Or use npx without installing:
+npm install -g realitydb
 
-```bash
-npx realitydb scan
-npx realitydb seed --template saas --records 1000 --seed 42
+realitydb scan                                    # Inspect your schema
+realitydb seed --template saas --seed 42          # Populate with realistic data
+realitydb reset --confirm                         # Clear and start fresh
 ```
 
-## Features
-
-- **Schema Intelligence** — Automatically understands your database structure
-- **Domain Templates** — SaaS, e-commerce, education with realistic distributions
-- **Timeline Generation** — Datasets spanning months with growth curves
-- **Scenario Injection** — Payment failures, churn spikes, fraud patterns
-- **Reality Packs** — Portable, shareable environment packages
-- **Deterministic** — Same seed = same data, every time
+## Domain Templates
 
-## Templates
+| Template | Description | Tables |
+|----------|-------------|--------|
+| `saas` | Subscription business | users, plans, subscriptions, payments |
+| `ecommerce` | Online store | customers, products, orders, order_items |
+| `education` | School system | teachers, classes, students, enrollments, grades, attendance |
+| `fintech` | Financial services | accounts, transactions, fraud_alerts, settlements, chargebacks |
+| `healthcare` | Medical system | patients, providers, encounters, diagnoses, billing |
 
 ```bash
-realitydb seed --template saas --records 1000 --seed 42
-realitydb seed --template ecommerce --records 1000 --seed 42
-realitydb seed --template education --records 1000 --seed 42
+realitydb seed --template fintech --records 200 --seed 42
 ```
 
-## Timeline & Scenarios
+Each template includes weighted distributions matching real-world data.
+
+## Key Features
 
 ```bash
+# Timeline generation -- data spanning months
 realitydb seed --template saas --timeline 12-months --seed 42
+
+# Scenario injection -- controlled anomalies
 realitydb seed --template saas --scenario payment-failures --scenario-intensity high
-```
 
-## Reality Packs
+# Environment reproduction -- capture and share
+realitydb capture --name bug-4821
+realitydb load bug-4821.realitydb-pack.json --confirm
 
-```bash
-realitydb pack export --template saas --name my-saas-env --seed 42
-realitydb pack import ./my-saas-env.databox-pack.json --confirm
+# CI mode -- JSON output, proper exit codes
+npx realitydb seed --ci --template saas --records 500 --seed 42
 ```
 
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `realitydb scan` | Inspect database schema |
+| `realitydb seed` | Generate and insert realistic data |
+| `realitydb reset` | Clear seeded data |
+| `realitydb export` | Export data to JSON/CSV/SQL files |
+| `realitydb capture` | Snapshot live database into a Reality Pack |
+| `realitydb load` | Load a Reality Pack into the database |
+| `realitydb share` | Display Reality Pack info for sharing |
+| `realitydb pack export` | Generate and export as Reality Pack |
+| `realitydb pack import` | Import a Reality Pack |
+| `realitydb templates` | List available domain templates |
+| `realitydb scenarios` | List available scenarios |
+
 ## Configuration
 
-Create `realitydb.config.json` (also reads `seedforge.config.json` and `databox.config.json` for backward compatibility):
+Create `realitydb.config.json`:
 
 ```json
 {
@@ -68,7 +74,7 @@ Create `realitydb.config.json` (also reads `seedforge.config.json` and `databox.
     "connectionString": "postgres://user:pass@localhost:5432/mydb"
   },
   "seed": {
-    "defaultRecords": 5000,
+    "defaultRecords": 1000,
     "batchSize": 1000,
     "randomSeed": 42
   },
@@ -76,23 +82,12 @@ Create `realitydb.config.json` (also reads `seedforge.config.json` and `databox.
 }
 ```
 
-## Prerequisites
+## Requirements
 
 - Node.js 20+
-- PostgreSQL database
+- PostgreSQL
 
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `realitydb scan` | Scan and display database schema |
-| `realitydb seed` | Generate and insert realistic data |
-| `realitydb reset` | Clear seeded data |
-| `realitydb export` | Export dataset to JSON/CSV/SQL files |
-| `realitydb templates` | List available domain templates |
-| `realitydb scenarios` | List available scenarios |
-| `realitydb pack export` | Export environment as Reality Pack |
-| `realitydb pack import` | Import Reality Pack into database |
+Full documentation: [github.com/emkwambe/databox](https://github.com/emkwambe/databox)
 
 ## License
 

package/dist/index.js

@@ -5154,7 +5154,7 @@ function matchesAnyPattern(tableName, patterns) {
 var import_promises5 = require("fs/promises");
 var import_node_path5 = require("path");
 function exportRealityPack(dataset, plan, schema, options) {
-  const name = options?.name ?? plan.config.templateName ?? "databox-pack";
+  const name = options?.name ?? plan.config.templateName ?? "realitydb-pack";
   const packSchema = {
     tables: schema.tables.map((t) => ({
       name: t.name,
@@ -5182,7 +5182,7 @@ function exportRealityPack(dataset, plan, schema, options) {
     };
   }
   return {
-    format: "databox-reality-pack",
+    format: "realitydb-pack",
     version: "1.0",
     metadata: {
       name,
@@ -5199,7 +5199,7 @@ function exportRealityPack(dataset, plan, schema, options) {
   };
 }
 async function saveRealityPack(pack, outputPath) {
-  const filePath = outputPath.endsWith(".databox-pack.json") ? outputPath : `${outputPath}/${pack.metadata.name}.databox-pack.json`;
+  const filePath = outputPath.endsWith(".realitydb-pack.json") || outputPath.endsWith(".databox-pack.json") ? outputPath : `${outputPath}/${pack.metadata.name}.realitydb-pack.json`;
   await (0, import_promises5.mkdir)((0, import_node_path5.dirname)(filePath), { recursive: true });
   await (0, import_promises5.writeFile)(filePath, JSON.stringify(pack, null, 2), "utf-8");
   return filePath;
@@ -5219,8 +5219,8 @@ async function loadRealityPack(filePath) {
     throw new Error(`Invalid Reality Pack file: not valid JSON`);
   }
   const pack = parsed;
-  if (pack.format !== "databox-reality-pack") {
-    throw new Error(`Invalid Reality Pack: expected format "databox-reality-pack", got "${String(pack.format)}"`);
+  if (pack.format !== "realitydb-pack" && pack.format !== "databox-reality-pack") {
+    throw new Error(`Invalid Reality Pack: expected format "realitydb-pack", got "${String(pack.format)}"`);
   }
   if (!pack.version) {
     throw new Error("Invalid Reality Pack: missing version field");
@@ -7297,7 +7297,7 @@ async function captureDatabase(config, options) {
     };
     const masked = maskConnection(config.database.connectionString);
     const pack = {
-      format: "databox-reality-pack",
+      format: "realitydb-pack",
       version: "1.0",
       metadata: {
         name: options.name,
@@ -7390,7 +7390,7 @@ function maskConnectionString(connectionString) {
 }
 
 // src/commands/scan.ts
-var VERSION2 = "0.4.0";
+var VERSION2 = "0.4.1";
 async function scanCommand(options) {
   const start = performance.now();
   try {
@@ -7481,7 +7481,7 @@ async function scanCommand(options) {
 }
 
 // src/commands/seed.ts
-var VERSION3 = "0.4.0";
+var VERSION3 = "0.4.1";
 async function seedCommand(options) {
   const start = performance.now();
   try {
@@ -7659,7 +7659,7 @@ async function seedCommand(options) {
 }
 
 // src/commands/reset.ts
-var VERSION4 = "0.4.0";
+var VERSION4 = "0.4.1";
 async function resetCommand(options) {
   const start = performance.now();
   if (!options.ci && !options.confirm) {
@@ -7729,7 +7729,7 @@ async function resetCommand(options) {
 }
 
 // src/commands/export.ts
-var VERSION5 = "0.4.0";
+var VERSION5 = "0.4.1";
 async function exportCommand(options) {
   const start = performance.now();
   try {
@@ -8081,7 +8081,7 @@ async function packImportCommand(filePath, options) {
 
 // src/commands/capture.ts
 var import_promises8 = require("fs/promises");
-var VERSION6 = "0.4.0";
+var VERSION6 = "0.4.1";
 async function captureCommand(options) {
   const start = performance.now();
   try {
@@ -8181,7 +8181,7 @@ async function captureCommand(options) {
 }
 
 // src/commands/share.ts
-var VERSION7 = "0.4.0";
+var VERSION7 = "0.4.1";
 async function shareCommand(filePath, options) {
   const start = performance.now();
   try {
@@ -8256,7 +8256,7 @@ async function shareCommand(filePath, options) {
 }
 
 // src/commands/load.ts
-var VERSION8 = "0.4.0";
+var VERSION8 = "0.4.1";
 async function loadCommand(filePath, options) {
   const start = performance.now();
   try {
@@ -8399,7 +8399,7 @@ async function loadCommand(filePath, options) {
 }
 
 // src/cli.ts
-var VERSION9 = "0.4.0";
+var VERSION9 = "0.4.1";
 function run(argv) {
   const program2 = new Command();
   program2.name("realitydb").description("RealityDB \u2014 Developer Reality Platform").version(VERSION9).option("--config <path>", "Path to config file").option("--ci", "CI mode: JSON output, no prompts, proper exit codes", false).option("--verbose", "Enable verbose output", false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realitydb",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Developer Reality Platform - realistic database environments from your schema",
   "license": "MIT",
   "keywords": [