@memberjunction/cli 5.37.0 → 5.39.0

package/oclif.manifest.json

@@ -338,78 +338,6 @@
         "upgrade.js"
       ]
     },
-    "bump": {
-      "aliases": [],
-      "args": {},
-      "description": "Bumps MemberJunction dependency versions",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Bump all @memberjunction/* dependencies in the current directory's package.json to the CLI version"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -rdv",
-          "description": "Preview all recursive packages bumps without writing any changes."
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -rqt v2.10.0 | xargs -n1 -I{} npm install --prefix {}",
-          "description": "Recursively bump all @memberjunction/* dependencies in all packages to version v2.10.0 and output only the paths containing the updated package.json files. Pipe the output to xargs to run npm install in each directory and update the package-lock.json files as well."
-        }
-      ],
-      "flags": {
-        "verbose": {
-          "char": "v",
-          "description": "Enable additional logging",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "recursive": {
-          "char": "r",
-          "description": "Bump version in current directory and all subdirectories",
-          "name": "recursive",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Version tag to bump target for bump (e.g. v2.10.0), defaults to the CLI version",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "quiet": {
-          "char": "q",
-          "description": "Only output paths for updated packages",
-          "name": "quiet",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dry": {
-          "char": "d",
-          "description": "Dry run, do not write changes to package.json files",
-          "name": "dry",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "bump",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "bump",
-        "index.js"
-      ]
-    },
     "artifacts:reclassify": {
       "aliases": [],
       "args": {},
@@ -471,100 +399,92 @@
         "reclassify.js"
       ]
     },
-    "clean": {
+    "baseline:build": {
       "aliases": [],
       "args": {},
-      "description": "Resets the MemberJunction database to a pre-installation state",
+      "description": "Generate a deterministic baseline SQL script from the END-STATE of a migrated MSSQL database.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>\n"
+        "<%= config.bin %> <%= command.id %> --out ./migrations/v5/                          # auto: within-major rebaseline",
+        "<%= config.bin %> <%= command.id %> --source-dir ./migrations/v5 --out ./migrations/v5/",
+        "<%= config.bin %> <%= command.id %> --baseline-version 6.0 --out ./migrations/v6/  # explicit major-boundary",
+        "<%= config.bin %> <%= command.id %> --baseline-version 5.32 --database MJ_BL_Stack --out /tmp/baseline/"
       ],
       "flags": {
-        "verbose": {
-          "char": "v",
-          "description": "Enable additional logging",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "clean",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "clean",
-        "index.js"
-      ]
-    },
-    "codegen:5-0-fix-entity-names": {
-      "aliases": [],
-      "args": {},
-      "description": "[v5.0 Migration] Scan TypeScript files for entity names AND class names that need updating.\n\nThree strategies are applied:\n  1. Class name renames (regex) — ActionEntity -> MJActionEntity, ActionSchema -> MJActionSchema,\n     ActionEntityExtended -> MJActionEntityExtended (extended subclasses),\n     ActionEntityServerEntity -> MJActionEntityServer (server subclass suffix standardization),\n     ActionFormComponentExtended -> MJActionFormComponentExtended (Angular form components).\n     Explicit subclass mappings (57 entries from subclass-rename-map.json) take priority over\n     auto-generated suffix rules, enabling suffix changes (e.g., _Server -> Server, ServerEntity -> Server).\n  2. Multi-word entity name renames (regex) — 'AI Models' -> 'MJ: AI Models'\n  3. Single-word entity name renames (AST) — 'Actions' -> 'MJ: Actions' in GetEntityObject, OpenEntityRecord,\n     navigateToEntity, EntityName: assignments, .Name === comparisons, @RegisterClass decorators.\n\nThe rename map (272 entity entries + 57 subclass entries) is built from entity_subclasses.ts @RegisterClass\ndecorators plus embedded rename maps. Runs in dry-run mode by default; use --fix to apply.",
-      "examples": [
-        {
-          "description": "Dry-run scan of the packages directory",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/"
+        "baseline-version": {
+          "description": "Baseline version stamp in Major.Minor format (literal x is appended for patch, matching the V-file convention). Omit to auto-detect from --source-dir (within-major rebaseline mode).",
+          "name": "baseline-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        {
-          "description": "Scan a single file",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/Explorer/dashboards/src/Actions/components/actions-overview.component.ts"
+        "source-dir": {
+          "description": "Migrations source directory (e.g. ./migrations/v5). Used to auto-detect the next baseline version + timestamp when --baseline-version is omitted. Defaults to the highest migrations/v*/ directory walked up from cwd.",
+          "name": "source-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        {
-          "description": "Apply fixes across the codebase",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/ --fix"
+        "description": {
+          "description": "Human-readable description embedded in the file header.",
+          "name": "description",
+          "default": "MemberJunction Baseline",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        {
-          "description": "Quiet mode (summary only)",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/ -q"
-        }
-      ],
-      "flags": {
-        "path": {
-          "char": "p",
-          "description": "File or directory to scan. Accepts a single .ts file or a directory (scanned recursively). Defaults to the current working directory.",
-          "name": "path",
+        "database": {
+          "description": "Override database name (host/user/password come from MJ config).",
+          "name": "database",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "fix": {
-          "description": "Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
+        "out": {
+          "description": "Output directory. Filename is auto-generated.",
+          "name": "out",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "entity-subclasses": {
-          "description": "Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.",
-          "name": "entity-subclasses",
+        "exclude-data": {
+          "description": "Comma-separated list of tables (schema-qualified or not) to skip data dump for.",
+          "name": "exclude-data",
+          "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "quiet": {
-          "char": "q",
-          "description": "Suppress detailed per-file output; only show the final summary counts.",
-          "name": "quiet",
+        "batch-size": {
+          "description": "Rows per INSERT batch.",
+          "name": "batch-size",
+          "default": 1000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-data": {
+          "description": "Emit schema only, no data inserts.",
+          "name": "no-data",
           "allowNo": false,
           "type": "boolean"
         },
         "verbose": {
-          "char": "v",
-          "description": "Show detailed progress including each file being scanned.",
+          "description": "Print per-object progress.",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Print to stdout instead of writing a file.",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "codegen:5-0-fix-entity-names",
+      "id": "baseline:build",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -574,64 +494,106 @@
       "relativePath": [
         "dist",
         "commands",
-        "codegen",
-        "5-0-fix-entity-names.js"
+        "baseline",
+        "build.js"
       ]
     },
-    "codegen:5-0-fix-html-entity-names": {
+    "baseline:compare": {
       "aliases": [],
       "args": {},
-      "description": "[v5.0 Migration] Scan Angular HTML template files for hardcoded entity names that need \"MJ: \" prefix updates.\n\nUses targeted regex patterns to find entity name references in template expressions\nand attribute values. Detects method calls like navigateToEntity('Actions'),\nOpenEntityRecord('Entities', id), and attribute values like RowsEntityName=\"Users\".\nRuns in dry-run mode by default; use --fix to apply.\n\nThe rename map is built dynamically from entity_subclasses.ts by parsing all\n@RegisterClass(BaseEntity, 'MJ: XYZ') decorators (~272 entries).",
+      "description": "Deterministically compare two databases object-by-object and row-by-row.",
       "examples": [
-        {
-          "description": "Dry-run scan of Angular templates",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/"
+        "<%= config.bin %> <%= command.id %> --left MJ_BL_Stack --right MJ_BL_New",
+        "<%= config.bin %> <%= command.id %> --left A --right B --row-compare counts",
+        "<%= config.bin %> <%= command.id %> --left A --right B --fail-on-diff --out ./diffs/"
+      ],
+      "flags": {
+        "left": {
+          "description": "Left database name (override).",
+          "name": "left",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        {
-          "description": "Apply fixes to HTML templates",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/ --fix"
+        "right": {
+          "description": "Right database name (override).",
+          "name": "right",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        {
-          "description": "Scan with verbose output",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/ -v"
+        "dialect": {
+          "description": "Dialect of both DBs (must match).",
+          "name": "dialect",
+          "default": "mssql",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "mssql",
+            "postgres"
+          ],
+          "type": "option"
         },
-        {
-          "description": "Scan a single template file",
-          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/Explorer/dashboards/src/Actions/actions-dashboard.component.html"
-        }
-      ],
-      "flags": {
-        "path": {
-          "char": "p",
-          "description": "File or directory to scan. Accepts a single .html file or a directory (scanned recursively). Defaults to the current working directory.",
-          "name": "path",
+        "row-compare": {
+          "description": "Row comparison mode.",
+          "name": "row-compare",
+          "default": "full",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "full",
+            "hash",
+            "counts",
+            "none"
+          ],
           "type": "option"
         },
-        "fix": {
-          "description": "Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
+        "row-hash-algo": {
+          "description": "Hash algorithm when --row-compare hash.",
+          "name": "row-hash-algo",
+          "default": "sha256",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "sha256",
+            "md5",
+            "checksum_agg"
+          ],
+          "type": "option"
         },
-        "entity-subclasses": {
-          "description": "Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.",
-          "name": "entity-subclasses",
+        "ignore": {
+          "description": "Regex of object names to skip.",
+          "name": "ignore",
+          "default": "^flyway_schema_history$",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "quiet": {
-          "char": "q",
-          "description": "Suppress detailed per-file output; only show the final summary counts.",
-          "name": "quiet",
+        "sample-limit": {
+          "description": "Maximum row diffs to capture per table.",
+          "name": "sample-limit",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "out": {
+          "description": "Directory to write JSON + Markdown reports.",
+          "name": "out",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fail-on-diff": {
+          "description": "Exit non-zero if any diff is found.",
+          "name": "fail-on-diff",
           "allowNo": false,
           "type": "boolean"
         },
         "verbose": {
-          "char": "v",
-          "description": "Show detailed progress including each file being scanned.",
+          "description": "Print per-phase progress.",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -639,7 +601,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "codegen:5-0-fix-html-entity-names",
+      "id": "baseline:compare",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -649,64 +611,111 @@
       "relativePath": [
         "dist",
         "commands",
-        "codegen",
-        "5-0-fix-html-entity-names.js"
+        "baseline",
+        "compare.js"
       ]
     },
-    "codegen:5-0-fix-metadata-names": {
+    "baseline:roundtrip": {
       "aliases": [],
       "args": {},
-      "description": "[v5.0 Migration] Scan metadata JSON files for entity names that need \"MJ: \" prefix updates.\n\nTargets the metadata/ directory used by \"mj sync\". Detects entity name references in\n@lookup: directives (both the entity name and lookup value), .mj-sync.json and\n.mj-folder.json config files (entity/entityName fields), relatedEntities object keys,\nand fields.Name values in Entities-managing folders. Runs in dry-run mode by default;\nuse --fix to apply.\n\nThe rename map is built dynamically from entity_subclasses.ts by parsing all\n@RegisterClass(BaseEntity, 'MJ: XYZ') decorators (~272 entries).",
+      "description": "Build a baseline from a V-stack database, apply it to a fresh DB, and prove byte-equivalence.",
       "examples": [
-        {
-          "description": "Dry-run scan of the metadata directory",
-          "command": "<%= config.bin %> <%= command.id %> --path metadata/"
-        },
-        {
-          "description": "Apply fixes to metadata files",
-          "command": "<%= config.bin %> <%= command.id %> --path metadata/ --fix"
-        },
-        {
-          "description": "Scan a specific subdirectory",
-          "command": "<%= config.bin %> <%= command.id %> --path metadata/resource-types"
-        },
-        {
-          "description": "Scan and fix a single metadata file",
-          "command": "<%= config.bin %> <%= command.id %> --path metadata/entities/.audit-related-entities.json --fix"
-        }
+        "<%= config.bin %> <%= command.id %> --source MJ_BL_Stack --target MJ_BL_New                          # auto: within-major",
+        "<%= config.bin %> <%= command.id %> --baseline-version 6.0 --source MJ_BL_Stack --target MJ_BL_New   # explicit major-boundary",
+        "<%= config.bin %> <%= command.id %> --source-dir ./migrations/v5 --source MJ_BL_Stack --target MJ_BL_New"
       ],
       "flags": {
-        "path": {
-          "char": "p",
-          "description": "File or directory to scan. Accepts a single .json file or a directory (scanned recursively, including dotfiles like .mj-sync.json). Defaults to the current working directory.",
-          "name": "path",
+        "baseline-version": {
+          "description": "Major.Minor version stamp. Omit to auto-detect from --source-dir (within-major rebaseline).",
+          "name": "baseline-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "fix": {
-          "description": "Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
+        "source-dir": {
+          "description": "Migrations source directory used to auto-detect baseline version + timestamp when --baseline-version is omitted. Defaults to the highest migrations/v*/ near cwd.",
+          "name": "source-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "entity-subclasses": {
-          "description": "Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.",
-          "name": "entity-subclasses",
+        "description": {
+          "description": "Header description.",
+          "name": "description",
+          "default": "MemberJunction Baseline",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "quiet": {
-          "char": "q",
-          "description": "Suppress detailed per-file output; only show the final summary counts.",
-          "name": "quiet",
+        "dialect": {
+          "description": "Dialect to test. PG path runs the converter via /pg-migrate first.",
+          "name": "dialect",
+          "default": "mssql",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "mssql",
+            "postgres"
+          ],
+          "type": "option"
+        },
+        "source": {
+          "description": "Database name with the V-stack already applied (used as comparison gold standard).",
+          "name": "source",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target": {
+          "description": "Empty database name to apply the new baseline to.",
+          "name": "target",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "out": {
+          "description": "Output directory for baseline file + reports.",
+          "name": "out",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "apply-cmd": {
+          "description": "Command template to apply the baseline. Tokens: {file} {database}. Defaults to sqlcmd.",
+          "name": "apply-cmd",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "row-compare": {
+          "description": "Row compare mode passed to the comparator.",
+          "name": "row-compare",
+          "default": "full",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "full",
+            "hash",
+            "counts",
+            "none"
+          ],
+          "type": "option"
+        },
+        "fail-on-diff": {
+          "name": "fail-on-diff",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "keep-target": {
+          "description": "Do not drop the target database after run (useful for debugging diffs).",
+          "name": "keep-target",
           "allowNo": false,
           "type": "boolean"
         },
         "verbose": {
-          "char": "v",
-          "description": "Show detailed progress including each file being scanned.",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -714,7 +723,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "codegen:5-0-fix-metadata-names",
+      "id": "baseline:roundtrip",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -724,55 +733,69 @@
       "relativePath": [
         "dist",
         "commands",
-        "codegen",
-        "5-0-fix-metadata-names.js"
+        "baseline",
+        "roundtrip.js"
       ]
     },
-    "codegen": {
+    "bump": {
       "aliases": [],
       "args": {},
-      "description": "Run the full MemberJunction code generation pipeline.\n\nAnalyzes your SQL Server database schema, updates MemberJunction metadata, and\ngenerates synchronized code across the entire stack:\n\n  - SQL views, stored procedures, indexes, and permissions\n  - TypeScript entity classes with Zod validation schemas\n  - Angular form components with AI-driven layouts\n  - GraphQL resolvers and type definitions\n  - Action subclasses and DB schema JSON\n\nConfiguration is loaded from mj.config.cjs in the current directory (or parent\ndirectories). Database connection can also be set via environment variables:\nDB_HOST, DB_DATABASE, CODEGEN_DB_USERNAME, CODEGEN_DB_PASSWORD.\n\nUse --skipdb to skip all database operations (metadata sync, SQL object\ngeneration) and only regenerate TypeScript, Angular, and GraphQL output from\nexisting metadata.\n\nUse --skipfiles to skip all file-generation operations (TypeScript entities,\nAngular components, GraphQL resolvers, action subclasses, DB schema JSON) and\nonly run database-side operations (metadata sync, SQL object generation,\npermissions, custom SQL scripts).\n\n--skipdb and --skipfiles are independent and can be combined in any mix.\n\nUse --force-advanced-gen to bypass Pass 2 entity scoping and re-run the LLM-driven\nadvanced generation (smart fields, form layout) for ALL entities. Useful when AI\nprompts have changed and you want unchanged entities re-evaluated.",
+      "description": "Bumps MemberJunction dependency versions",
       "examples": [
         {
           "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Run the full code generation pipeline"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --skipdb",
-          "description": "Regenerate code files without touching the database"
+          "description": "Bump all @memberjunction/* dependencies in the current directory's package.json to the CLI version"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --skipfiles",
-          "description": "Run database-side operations only, without regenerating any code files"
+          "command": "<%= config.bin %> <%= command.id %> -rdv",
+          "description": "Preview all recursive packages bumps without writing any changes."
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --force-advanced-gen",
-          "description": "Re-run advanced generation for all entities (bypasses changed-entity scoping)"
+          "command": "<%= config.bin %> <%= command.id %> -rqt v2.10.0 | xargs -n1 -I{} npm install --prefix {}",
+          "description": "Recursively bump all @memberjunction/* dependencies in all packages to version v2.10.0 and output only the paths containing the updated package.json files. Pipe the output to xargs to run npm install in each directory and update the package-lock.json files as well."
         }
       ],
       "flags": {
-        "skipdb": {
-          "description": "Skip database operations (metadata sync, SQL generation). Only regenerate TypeScript entities, Angular components, and GraphQL resolvers from existing metadata.",
-          "name": "skipdb",
+        "verbose": {
+          "char": "v",
+          "description": "Enable additional logging",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         },
-        "skipfiles": {
-          "description": "Skip file-generation operations (TypeScript entities, Angular components, GraphQL resolvers, action subclasses, DB schema JSON). Only run database-side operations.",
-          "name": "skipfiles",
+        "recursive": {
+          "char": "r",
+          "description": "Bump version in current directory and all subdirectories",
+          "name": "recursive",
           "allowNo": false,
           "type": "boolean"
         },
-        "force-advanced-gen": {
-          "description": "Bypass entity scoping in Pass 2 and force advanced generation to re-run for all entities. Used when AI prompts have changed and unchanged entities should be re-evaluated.",
-          "name": "force-advanced-gen",
+        "tag": {
+          "char": "t",
+          "description": "Version tag to bump target for bump (e.g. v2.10.0), defaults to the CLI version",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Only output paths for updated packages",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry": {
+          "char": "d",
+          "description": "Dry run, do not write changes to package.json files",
+          "name": "dry",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "codegen",
+      "id": "bump",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -782,117 +805,77 @@
       "relativePath": [
         "dist",
         "commands",
-        "codegen",
+        "bump",
         "index.js"
       ]
     },
-    "codegen:manifest": {
+    "bundle": {
       "aliases": [],
       "args": {},
-      "description": "Generate a class registration manifest to prevent tree-shaking.\n\nMemberJunction uses @RegisterClass decorators with a dynamic class factory.\nModern bundlers (ESBuild, Vite) cannot detect dynamic instantiation and will\ntree-shake these classes out of production builds. This command scans the\ndependency tree for all @RegisterClass-decorated classes and emits a manifest\nfile with static imports that the bundler cannot eliminate.\n\nTypically used as a prebuild/prestart script for MJAPI and MJExplorer. For\nMJ distribution users, pre-built manifests ship inside @memberjunction/server-bootstrap\nand @memberjunction/ng-bootstrap -- use --exclude-packages @memberjunction to\ngenerate a supplemental manifest covering only your own application classes.",
+      "description": "Create a self-contained MemberJunction distribution zip for offline/air-gapped installs",
       "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Generate manifest with default output path"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --appDir ./packages/MJAPI --output ./packages/MJAPI/src/generated/class-registrations-manifest.ts",
-          "description": "Generate manifest for a specific application directory"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --exclude-packages @memberjunction",
-          "description": "Exclude MJ packages (use pre-built bootstrap manifests instead)"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --exclude-packages @memberjunction --no-sync-deps",
-          "description": "Exclude MJ packages and skip dependency reconciliation"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --filter BaseEngine --filter BaseAction --verbose",
-          "description": "Only include specific base classes with detailed progress"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --scan-dist",
-          "description": "Include dist/ scanning for npm-published packages without src/"
-        }
+        "<%= config.bin %> <%= command.id %> --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --tag v5.38.0 --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --source . --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --tag v5.38.0 --with-migrations --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --with-migrations --db-platform postgresql --out ./mj-install.zip"
       ],
       "flags": {
-        "output": {
+        "out": {
           "char": "o",
-          "description": "Output file path for the generated manifest. The file will contain named imports and a CLASS_REGISTRATIONS array.",
-          "name": "output",
-          "default": "./src/generated/class-registrations-manifest.ts",
+          "description": "Output zip path",
+          "name": "out",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "appDir": {
-          "char": "a",
-          "description": "Root directory of the application whose package.json dependency tree will be scanned. Defaults to the current working directory.",
-          "name": "appDir",
+        "tag": {
+          "char": "t",
+          "description": "Release tag to bundle (e.g. v5.38.0). Defaults to the latest branch tip.",
+          "name": "tag",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "filter": {
-          "char": "f",
-          "description": "Only include classes extending this base class. Can be repeated (e.g., --filter BaseEngine --filter BaseAction).",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "exclude-packages": {
-          "char": "e",
-          "description": "Skip packages whose name starts with this prefix. Useful for excluding @memberjunction packages when using pre-built bootstrap manifests. Can be repeated.",
-          "name": "exclude-packages",
+        "source": {
+          "description": "Bundle from a local working-tree directory instead of fetching from the repo",
+          "name": "source",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "no-sync-deps": {
-          "description": "Skip automatic dependency reconciliation. By default, the manifest generator adds any manifest-imported packages that are missing from package.json dependencies. Use this flag when generating supplemental manifests with --exclude-packages, where excluded packages are already covered by a pre-built bootstrap manifest.",
-          "name": "no-sync-deps",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "quiet": {
-          "char": "q",
-          "description": "Suppress all output except errors.",
-          "name": "quiet",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed progress including per-package scanning info and skipped classes.",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "scan-dist": {
-          "description": "Scan compiled JavaScript files in dist/ directories for packages without src/. Use this when your dependency tree includes npm-published packages that contain @RegisterClass decorators. Without this flag, only TypeScript source in src/ is scanned.",
-          "name": "scan-dist",
+        "with-migrations": {
+          "description": "Include the migration tree(s) so an air-gapped \"mj migrate\" can run offline. Ships both SQL Server and PostgreSQL trees by default.",
+          "name": "with-migrations",
           "allowNo": false,
           "type": "boolean"
         },
-        "lazy-config": {
-          "description": "Output path for a generated lazy-loading feature config file. Maps @RegisterClass keys from excluded packages to dynamic import() loaders based on package.json subpath exports. Only packages with subpath exports in their package.json are included. Requires --exclude-packages.",
-          "name": "lazy-config",
+        "db-platform": {
+          "dependsOn": [
+            "with-migrations"
+          ],
+          "description": "With --with-migrations, ship only this platform's migration tree instead of both",
+          "name": "db-platform",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "sqlserver",
+            "postgresql"
+          ],
           "type": "option"
         },
-        "strict": {
-          "description": "Treat coverage audit gaps as fatal errors. A gap is a @RegisterClass class in an excluded package that is not reachable from any lazy chunk subpath export. Use in CI to catch tree-shaking issues before merge.",
-          "name": "strict",
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "codegen:manifest",
+      "id": "bundle",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -902,42 +885,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "codegen",
-        "manifest.js"
+        "bundle",
+        "index.js"
       ]
     },
-    "dbdoc:analyze": {
+    "clean": {
       "aliases": [],
       "args": {},
-      "description": "Analyze database and generate documentation (delegates to db-auto-doc analyze)",
+      "description": "Resets the MemberJunction database to a pre-installation state",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --resume ./output/run-6/state.json",
-        "<%= config.bin %> <%= command.id %> --config ./my-config.json"
+        "<%= config.bin %> <%= command.id %>\n"
       ],
       "flags": {
-        "resume": {
-          "char": "r",
-          "description": "Resume from an existing state file",
-          "name": "resume",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "config": {
-          "char": "c",
-          "description": "Path to config file",
-          "name": "config",
-          "default": "./config.json",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "verbose": {
+          "char": "v",
+          "description": "Enable additional logging",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "dbdoc:analyze",
+      "id": "clean",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -947,8 +917,456 @@
       "relativePath": [
         "dist",
         "commands",
-        "dbdoc",
-        "analyze.js"
+        "clean",
+        "index.js"
+      ]
+    },
+    "codegen:5-0-fix-entity-names": {
+      "aliases": [],
+      "args": {},
+      "description": "[v5.0 Migration] Scan TypeScript files for entity names AND class names that need updating.\n\nThree strategies are applied:\n  1. Class name renames (regex) — ActionEntity -> MJActionEntity, ActionSchema -> MJActionSchema,\n     ActionEntityExtended -> MJActionEntityExtended (extended subclasses),\n     ActionEntityServerEntity -> MJActionEntityServer (server subclass suffix standardization),\n     ActionFormComponentExtended -> MJActionFormComponentExtended (Angular form components).\n     Explicit subclass mappings (57 entries from subclass-rename-map.json) take priority over\n     auto-generated suffix rules, enabling suffix changes (e.g., _Server -> Server, ServerEntity -> Server).\n  2. Multi-word entity name renames (regex) — 'AI Models' -> 'MJ: AI Models'\n  3. Single-word entity name renames (AST) — 'Actions' -> 'MJ: Actions' in GetEntityObject, OpenEntityRecord,\n     navigateToEntity, EntityName: assignments, .Name === comparisons, @RegisterClass decorators.\n\nThe rename map (272 entity entries + 57 subclass entries) is built from entity_subclasses.ts @RegisterClass\ndecorators plus embedded rename maps. Runs in dry-run mode by default; use --fix to apply.",
+      "examples": [
+        {
+          "description": "Dry-run scan of the packages directory",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/"
+        },
+        {
+          "description": "Scan a single file",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/Explorer/dashboards/src/Actions/components/actions-overview.component.ts"
+        },
+        {
+          "description": "Apply fixes across the codebase",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/ --fix"
+        },
+        {
+          "description": "Quiet mode (summary only)",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/ -q"
+        }
+      ],
+      "flags": {
+        "path": {
+          "char": "p",
+          "description": "File or directory to scan. Accepts a single .ts file or a directory (scanned recursively). Defaults to the current working directory.",
+          "name": "path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fix": {
+          "description": "Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "entity-subclasses": {
+          "description": "Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.",
+          "name": "entity-subclasses",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress detailed per-file output; only show the final summary counts.",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed progress including each file being scanned.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "codegen:5-0-fix-entity-names",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "codegen",
+        "5-0-fix-entity-names.js"
+      ]
+    },
+    "codegen:5-0-fix-html-entity-names": {
+      "aliases": [],
+      "args": {},
+      "description": "[v5.0 Migration] Scan Angular HTML template files for hardcoded entity names that need \"MJ: \" prefix updates.\n\nUses targeted regex patterns to find entity name references in template expressions\nand attribute values. Detects method calls like navigateToEntity('Actions'),\nOpenEntityRecord('Entities', id), and attribute values like RowsEntityName=\"Users\".\nRuns in dry-run mode by default; use --fix to apply.\n\nThe rename map is built dynamically from entity_subclasses.ts by parsing all\n@RegisterClass(BaseEntity, 'MJ: XYZ') decorators (~272 entries).",
+      "examples": [
+        {
+          "description": "Dry-run scan of Angular templates",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/"
+        },
+        {
+          "description": "Apply fixes to HTML templates",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/ --fix"
+        },
+        {
+          "description": "Scan with verbose output",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/ -v"
+        },
+        {
+          "description": "Scan a single template file",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/Explorer/dashboards/src/Actions/actions-dashboard.component.html"
+        }
+      ],
+      "flags": {
+        "path": {
+          "char": "p",
+          "description": "File or directory to scan. Accepts a single .html file or a directory (scanned recursively). Defaults to the current working directory.",
+          "name": "path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fix": {
+          "description": "Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "entity-subclasses": {
+          "description": "Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.",
+          "name": "entity-subclasses",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress detailed per-file output; only show the final summary counts.",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed progress including each file being scanned.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "codegen:5-0-fix-html-entity-names",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "codegen",
+        "5-0-fix-html-entity-names.js"
+      ]
+    },
+    "codegen:5-0-fix-metadata-names": {
+      "aliases": [],
+      "args": {},
+      "description": "[v5.0 Migration] Scan metadata JSON files for entity names that need \"MJ: \" prefix updates.\n\nTargets the metadata/ directory used by \"mj sync\". Detects entity name references in\n@lookup: directives (both the entity name and lookup value), .mj-sync.json and\n.mj-folder.json config files (entity/entityName fields), relatedEntities object keys,\nand fields.Name values in Entities-managing folders. Runs in dry-run mode by default;\nuse --fix to apply.\n\nThe rename map is built dynamically from entity_subclasses.ts by parsing all\n@RegisterClass(BaseEntity, 'MJ: XYZ') decorators (~272 entries).",
+      "examples": [
+        {
+          "description": "Dry-run scan of the metadata directory",
+          "command": "<%= config.bin %> <%= command.id %> --path metadata/"
+        },
+        {
+          "description": "Apply fixes to metadata files",
+          "command": "<%= config.bin %> <%= command.id %> --path metadata/ --fix"
+        },
+        {
+          "description": "Scan a specific subdirectory",
+          "command": "<%= config.bin %> <%= command.id %> --path metadata/resource-types"
+        },
+        {
+          "description": "Scan and fix a single metadata file",
+          "command": "<%= config.bin %> <%= command.id %> --path metadata/entities/.audit-related-entities.json --fix"
+        }
+      ],
+      "flags": {
+        "path": {
+          "char": "p",
+          "description": "File or directory to scan. Accepts a single .json file or a directory (scanned recursively, including dotfiles like .mj-sync.json). Defaults to the current working directory.",
+          "name": "path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fix": {
+          "description": "Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "entity-subclasses": {
+          "description": "Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.",
+          "name": "entity-subclasses",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress detailed per-file output; only show the final summary counts.",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed progress including each file being scanned.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "codegen:5-0-fix-metadata-names",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "codegen",
+        "5-0-fix-metadata-names.js"
+      ]
+    },
+    "codegen": {
+      "aliases": [],
+      "args": {},
+      "description": "Run the full MemberJunction code generation pipeline.\n\nAnalyzes your SQL Server database schema, updates MemberJunction metadata, and\ngenerates synchronized code across the entire stack:\n\n  - SQL views, stored procedures, indexes, and permissions\n  - TypeScript entity classes with Zod validation schemas\n  - Angular form components with AI-driven layouts\n  - GraphQL resolvers and type definitions\n  - Action subclasses and DB schema JSON\n\nConfiguration is loaded from mj.config.cjs in the current directory (or parent\ndirectories). Database connection can also be set via environment variables:\nDB_HOST, DB_DATABASE, CODEGEN_DB_USERNAME, CODEGEN_DB_PASSWORD.\n\nUse --skipdb to skip all database operations (metadata sync, SQL object\ngeneration) and only regenerate TypeScript, Angular, and GraphQL output from\nexisting metadata.\n\nUse --skipfiles to skip all file-generation operations (TypeScript entities,\nAngular components, GraphQL resolvers, action subclasses, DB schema JSON) and\nonly run database-side operations (metadata sync, SQL object generation,\npermissions, custom SQL scripts).\n\n--skipdb and --skipfiles are independent and can be combined in any mix.\n\nUse --force-advanced-gen to bypass Pass 2 entity scoping and re-run the LLM-driven\nadvanced generation (smart fields, form layout) for ALL entities. Useful when AI\nprompts have changed and you want unchanged entities re-evaluated.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "Run the full code generation pipeline"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --skipdb",
+          "description": "Regenerate code files without touching the database"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --skipfiles",
+          "description": "Run database-side operations only, without regenerating any code files"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --force-advanced-gen",
+          "description": "Re-run advanced generation for all entities (bypasses changed-entity scoping)"
+        }
+      ],
+      "flags": {
+        "skipdb": {
+          "description": "Skip database operations (metadata sync, SQL generation). Only regenerate TypeScript entities, Angular components, and GraphQL resolvers from existing metadata.",
+          "name": "skipdb",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skipfiles": {
+          "description": "Skip file-generation operations (TypeScript entities, Angular components, GraphQL resolvers, action subclasses, DB schema JSON). Only run database-side operations.",
+          "name": "skipfiles",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force-advanced-gen": {
+          "description": "Bypass entity scoping in Pass 2 and force advanced generation to re-run for all entities. Used when AI prompts have changed and unchanged entities should be re-evaluated.",
+          "name": "force-advanced-gen",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "codegen",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "codegen",
+        "index.js"
+      ]
+    },
+    "codegen:manifest": {
+      "aliases": [],
+      "args": {},
+      "description": "Generate a class registration manifest to prevent tree-shaking.\n\nMemberJunction uses @RegisterClass decorators with a dynamic class factory.\nModern bundlers (ESBuild, Vite) cannot detect dynamic instantiation and will\ntree-shake these classes out of production builds. This command scans the\ndependency tree for all @RegisterClass-decorated classes and emits a manifest\nfile with static imports that the bundler cannot eliminate.\n\nTypically used as a prebuild/prestart script for MJAPI and MJExplorer. For\nMJ distribution users, pre-built manifests ship inside @memberjunction/server-bootstrap\nand @memberjunction/ng-bootstrap -- use --exclude-packages @memberjunction to\ngenerate a supplemental manifest covering only your own application classes.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "Generate manifest with default output path"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --appDir ./packages/MJAPI --output ./packages/MJAPI/src/generated/class-registrations-manifest.ts",
+          "description": "Generate manifest for a specific application directory"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --exclude-packages @memberjunction",
+          "description": "Exclude MJ packages (use pre-built bootstrap manifests instead)"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --exclude-packages @memberjunction --no-sync-deps",
+          "description": "Exclude MJ packages and skip dependency reconciliation"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --filter BaseEngine --filter BaseAction --verbose",
+          "description": "Only include specific base classes with detailed progress"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --scan-dist",
+          "description": "Include dist/ scanning for npm-published packages without src/"
+        }
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output file path for the generated manifest. The file will contain named imports and a CLASS_REGISTRATIONS array.",
+          "name": "output",
+          "default": "./src/generated/class-registrations-manifest.ts",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "appDir": {
+          "char": "a",
+          "description": "Root directory of the application whose package.json dependency tree will be scanned. Defaults to the current working directory.",
+          "name": "appDir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "char": "f",
+          "description": "Only include classes extending this base class. Can be repeated (e.g., --filter BaseEngine --filter BaseAction).",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "exclude-packages": {
+          "char": "e",
+          "description": "Skip packages whose name starts with this prefix. Useful for excluding @memberjunction packages when using pre-built bootstrap manifests. Can be repeated.",
+          "name": "exclude-packages",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "no-sync-deps": {
+          "description": "Skip automatic dependency reconciliation. By default, the manifest generator adds any manifest-imported packages that are missing from package.json dependencies. Use this flag when generating supplemental manifests with --exclude-packages, where excluded packages are already covered by a pre-built bootstrap manifest.",
+          "name": "no-sync-deps",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress all output except errors.",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed progress including per-package scanning info and skipped classes.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "scan-dist": {
+          "description": "Scan compiled JavaScript files in dist/ directories for packages without src/. Use this when your dependency tree includes npm-published packages that contain @RegisterClass decorators. Without this flag, only TypeScript source in src/ is scanned.",
+          "name": "scan-dist",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "lazy-config": {
+          "description": "Output path for a generated lazy-loading feature config file. Maps @RegisterClass keys from excluded packages to dynamic import() loaders based on package.json subpath exports. Only packages with subpath exports in their package.json are included. Requires --exclude-packages.",
+          "name": "lazy-config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "strict": {
+          "description": "Treat coverage audit gaps as fatal errors. A gap is a @RegisterClass class in an excluded package that is not reachable from any lazy chunk subpath export. Use in CI to catch tree-shaking issues before merge.",
+          "name": "strict",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "codegen:manifest",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "codegen",
+        "manifest.js"
+      ]
+    },
+    "dbdoc:analyze": {
+      "aliases": [],
+      "args": {},
+      "description": "Analyze database and generate documentation (delegates to db-auto-doc analyze)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --resume ./output/run-6/state.json",
+        "<%= config.bin %> <%= command.id %> --config ./my-config.json"
+      ],
+      "flags": {
+        "resume": {
+          "char": "r",
+          "description": "Resume from an existing state file",
+          "name": "resume",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "char": "c",
+          "description": "Path to config file",
+          "name": "config",
+          "default": "./config.json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "dbdoc:analyze",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "dbdoc",
+        "analyze.js"
       ]
     },
     "dbdoc:export-sample-queries": {
@@ -1318,75 +1736,18 @@
         "<%= config.bin %> <%= command.id %> --state-file ./custom-state.json"
       ],
       "flags": {
-        "state-file": {
-          "char": "s",
-          "description": "Path to state JSON file",
-          "name": "state-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "dbdoc:status",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "dbdoc",
-        "status.js"
-      ]
-    },
-    "doctor": {
-      "aliases": [],
-      "args": {},
-      "description": "Diagnose a MemberJunction installation",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dir ./my-mj-project",
-        "<%= config.bin %> <%= command.id %> --verbose",
-        "<%= config.bin %> <%= command.id %> --report",
-        "<%= config.bin %> <%= command.id %> --report_extended"
-      ],
-      "flags": {
-        "dir": {
-          "description": "Target directory to diagnose",
-          "name": "dir",
-          "default": ".",
+        "state-file": {
+          "char": "s",
+          "description": "Path to state JSON file",
+          "name": "state-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed output including suggested fixes inline",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "report": {
-          "char": "r",
-          "description": "Generate a diagnostic report file (mj-diagnostic-report.md) for sharing with support",
-          "name": "report",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "report_extended": {
-          "description": "Generate an extended report with config file snapshots and service startup log capture (~60s longer)",
-          "name": "report_extended",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "doctor",
+      "id": "dbdoc:status",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -1396,8 +1757,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "doctor",
-        "index.js"
+        "dbdoc",
+        "status.js"
       ]
     },
     "install": {
@@ -1699,6 +2060,12 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "check-connection": {
+          "description": "Verify the database connection (including TLS) and exit without migrating",
+          "name": "check-connection",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1932,6 +2299,63 @@
         "validate.js"
       ]
     },
+    "doctor": {
+      "aliases": [],
+      "args": {},
+      "description": "Diagnose a MemberJunction installation",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dir ./my-mj-project",
+        "<%= config.bin %> <%= command.id %> --verbose",
+        "<%= config.bin %> <%= command.id %> --report",
+        "<%= config.bin %> <%= command.id %> --report_extended"
+      ],
+      "flags": {
+        "dir": {
+          "description": "Target directory to diagnose",
+          "name": "dir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output including suggested fixes inline",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "report": {
+          "char": "r",
+          "description": "Generate a diagnostic report file (mj-diagnostic-report.md) for sharing with support",
+          "name": "report",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "report_extended": {
+          "description": "Generate an extended report with config file snapshots and service startup log capture (~60s longer)",
+          "name": "report_extended",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "doctor",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "doctor",
+        "index.js"
+      ]
+    },
     "sql-audit": {
       "aliases": [],
       "args": {},
@@ -2692,10 +3116,13 @@
       },
       "description": "Compare test runs for regression detection",
       "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --latest",
         "<%= config.bin %> <%= command.id %> <run-id-1> <run-id-2>",
-        "<%= config.bin %> <%= command.id %> --baseline=<run-id> --current=<run-id>",
-        "<%= config.bin %> <%= command.id %> --suite=<suite-id> --since=\"2024-01-01\"",
-        "<%= config.bin %> <%= command.id %> <run-id-1> <run-id-2> --format=json"
+        "<%= config.bin %> <%= command.id %> -v 5.17.0 -v 5.18.0",
+        "<%= config.bin %> <%= command.id %> -c abc1234 -c def5678",
+        "<%= config.bin %> <%= command.id %> --from-json baseline.json latest.json",
+        "<%= config.bin %> <%= command.id %> --latest --format=markdown --output=report.md"
       ],
       "flags": {
         "version": {
@@ -2720,6 +3147,20 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "latest": {
+          "char": "l",
+          "description": "Compare the two most recent completed suite runs",
+          "name": "latest",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "from-json": {
+          "description": "Compare two results.json files directly (no DB). Pass twice: --from-json PREV --from-json CURR",
+          "name": "from-json",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "format": {
           "char": "f",
           "description": "Output format",
@@ -2747,6 +3188,13 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "tag": {
+          "description": "Filter suite runs by tag (matches against MJTestSuiteRunEntity.Tags). Useful for isolating runs from a specific source environment in an archive MJ. DB mode only — --from-json ignores this flag.",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -3045,6 +3493,13 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "oracles-module": {
+          "description": "Path to a JS/TS module that exports custom IOracle classes or instances. Each export is registered on the engine before the test runs — used by non-MJ adopters to plug app-specific oracle types without modifying TestingFramework.",
+          "name": "oracles-module",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -3116,6 +3571,44 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "delay": {
+          "char": "d",
+          "description": "Delay in milliseconds between test executions (avoids Auth0 rate limits)",
+          "name": "delay",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "parallel": {
+          "char": "p",
+          "description": "Run tests in parallel with shared browser sessions",
+          "name": "parallel",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "max-parallel": {
+          "description": "Maximum number of parallel workers (default 4)",
+          "name": "max-parallel",
+          "default": 4,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "flaky-check": {
+          "description": "Run each test N times to detect flakiness (variance > 0.3 or mixed pass/fail = flaky). Recommended: 3 or 5",
+          "name": "flaky-check",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oracles-module": {
+          "description": "Path to a JS/TS module that exports custom IOracle classes or instances. Each export is registered on the engine before the suite runs — used by non-MJ adopters to plug app-specific oracle types without modifying TestingFramework.",
+          "name": "oracles-module",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -3205,7 +3698,129 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "test:validate",
+      "id": "test:validate",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "validate.js"
+      ]
+    },
+    "ai:actions:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available AI actions",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --output=table",
+        "<%= config.bin %> <%= command.id %> --output=json"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:actions:list",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "actions",
+        "list.js"
+      ]
+    },
+    "ai:actions:run": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute an AI action with parameters",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -n \"Get Weather\" --param \"Location=Boston\"",
+        "<%= config.bin %> <%= command.id %> -n \"Get Stock Price\" --param \"Ticker=AAPL\"",
+        "<%= config.bin %> <%= command.id %> -n \"Send Single Message\" --param \"To=user@example.com\" --param \"Subject=Test\" --param \"Body=Hello\" --param \"MessageType=Email\" --param \"Provider=SendGrid\"",
+        "<%= config.bin %> <%= command.id %> -n \"Calculate Expression\" --param \"Expression=2+2*3\" --dry-run"
+      ],
+      "flags": {
+        "name": {
+          "char": "n",
+          "description": "Action name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "param": {
+          "char": "p",
+          "description": "Action parameters in key=value format",
+          "name": "param",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Validate without executing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table"
+          ],
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed execution information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Execution timeout in milliseconds",
+          "name": "timeout",
+          "default": 300000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:actions:run",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3215,14 +3830,15 @@
       "relativePath": [
         "dist",
         "commands",
-        "test",
-        "validate.js"
+        "ai",
+        "actions",
+        "run.js"
       ]
     },
-    "ai:actions:list": {
+    "ai:agents:list": {
       "aliases": [],
       "args": {},
-      "description": "List available AI actions",
+      "description": "List available AI agents",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --output=table",
@@ -3246,7 +3862,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:actions:list",
+      "id": "ai:agents:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3257,41 +3873,47 @@
         "dist",
         "commands",
         "ai",
-        "actions",
+        "agents",
         "list.js"
       ]
     },
-    "ai:actions:run": {
+    "ai:agents:run": {
       "aliases": [],
       "args": {},
-      "description": "Execute an AI action with parameters",
+      "description": "Execute an AI agent with a prompt or start interactive chat",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -n \"Get Weather\" --param \"Location=Boston\"",
-        "<%= config.bin %> <%= command.id %> -n \"Get Stock Price\" --param \"Ticker=AAPL\"",
-        "<%= config.bin %> <%= command.id %> -n \"Send Single Message\" --param \"To=user@example.com\" --param \"Subject=Test\" --param \"Body=Hello\" --param \"MessageType=Email\" --param \"Provider=SendGrid\"",
-        "<%= config.bin %> <%= command.id %> -n \"Calculate Expression\" --param \"Expression=2+2*3\" --dry-run"
+        "<%= config.bin %> <%= command.id %> -a \"Skip: Requirements Expert\" -p \"Create a dashboard for sales metrics\"",
+        "<%= config.bin %> <%= command.id %> -a \"Child Component Generator Sub-agent\" --chat",
+        "<%= config.bin %> <%= command.id %> -a \"Skip: Technical Design Expert\" -p \"Build a React component\" --verbose --timeout=600000"
       ],
       "flags": {
-        "name": {
-          "char": "n",
-          "description": "Action name",
-          "name": "name",
+        "agent": {
+          "char": "a",
+          "description": "Agent name",
+          "name": "agent",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "param": {
+        "prompt": {
           "char": "p",
-          "description": "Action parameters in key=value format",
-          "name": "param",
+          "description": "Prompt to execute",
+          "exclusive": [
+            "chat"
+          ],
+          "name": "prompt",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "description": "Validate without executing",
-          "name": "dry-run",
+        "chat": {
+          "char": "c",
+          "description": "Start interactive chat mode",
+          "exclusive": [
+            "prompt"
+          ],
+          "name": "chat",
           "allowNo": false,
           "type": "boolean"
         },
@@ -3327,7 +3949,223 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:actions:run",
+      "id": "ai:agents:run",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "agents",
+        "run.js"
+      ]
+    },
+    "ai:audit:agent-run": {
+      "aliases": [],
+      "args": {
+        "runId": {
+          "description": "AI Agent Run ID to audit (UUID)",
+          "name": "runId",
+          "required": false
+        }
+      },
+      "description": "Audit and analyze AI agent execution runs for debugging and performance analysis",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> abc-123-def-456",
+        "<%= config.bin %> <%= command.id %> abc-123-def-456 --output=markdown",
+        "<%= config.bin %> <%= command.id %> abc-123-def-456 --step 3",
+        "<%= config.bin %> <%= command.id %> abc-123-def-456 --step 3 --detail full",
+        "<%= config.bin %> <%= command.id %> abc-123-def-456 --errors",
+        "<%= config.bin %> <%= command.id %> --list --agent \"Skip: Requirements Expert\"",
+        "<%= config.bin %> <%= command.id %> --list --status failed --days 7",
+        "<%= config.bin %> <%= command.id %> abc-123-def-456 --export full --file report.json"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "Output format",
+          "name": "output",
+          "default": "compact",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "compact",
+            "json",
+            "table",
+            "markdown"
+          ],
+          "type": "option"
+        },
+        "step": {
+          "char": "s",
+          "description": "Show details for specific step number (1-based index)",
+          "exclusive": [
+            "list",
+            "errors"
+          ],
+          "name": "step",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "detail": {
+          "char": "d",
+          "dependsOn": [
+            "step"
+          ],
+          "description": "Detail level for step output (default: standard)",
+          "name": "detail",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "minimal",
+            "standard",
+            "detailed",
+            "full"
+          ],
+          "type": "option"
+        },
+        "errors": {
+          "char": "e",
+          "description": "Show only error details and context",
+          "exclusive": [
+            "step",
+            "list"
+          ],
+          "name": "errors",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "list": {
+          "char": "l",
+          "description": "List recent agent runs",
+          "exclusive": [
+            "step",
+            "errors"
+          ],
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "agent": {
+          "char": "a",
+          "dependsOn": [
+            "list"
+          ],
+          "description": "Filter by agent name",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "dependsOn": [
+            "list"
+          ],
+          "description": "Filter by run status",
+          "name": "status",
+          "default": "all",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "success",
+            "failed",
+            "running",
+            "all"
+          ],
+          "type": "option"
+        },
+        "days": {
+          "dependsOn": [
+            "list"
+          ],
+          "description": "Number of days to look back",
+          "name": "days",
+          "default": 7,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "dependsOn": [
+            "list"
+          ],
+          "description": "Maximum number of runs to return",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "export": {
+          "dependsOn": [
+            "file"
+          ],
+          "description": "Export full data to file",
+          "name": "export",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "full",
+            "summary",
+            "steps"
+          ],
+          "type": "option"
+        },
+        "file": {
+          "char": "f",
+          "description": "Output file path for export",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-tokens": {
+          "description": "Maximum tokens per field (0 = no limit)",
+          "name": "max-tokens",
+          "default": 5000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed diagnostic information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:audit:agent-run",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "audit",
+        "agent-run.js"
+      ]
+    },
+    "ai:audit": {
+      "aliases": [],
+      "args": {},
+      "description": "Analyze and audit AI agent runs, prompts, and actions for debugging and performance analysis",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "ai:audit",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3338,38 +4176,29 @@
         "dist",
         "commands",
         "ai",
-        "actions",
-        "run.js"
+        "audit",
+        "index.js"
       ]
     },
-    "ai:agents:list": {
+    "ai:prompts:list": {
       "aliases": [],
       "args": {},
-      "description": "List available AI agents",
+      "description": "List available models for prompt execution",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --output=table",
-        "<%= config.bin %> <%= command.id %> --output=json"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
-        "output": {
-          "char": "o",
-          "description": "Output format",
-          "name": "output",
-          "default": "compact",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "compact",
-            "json",
-            "table"
-          ],
-          "type": "option"
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed model information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:list",
+      "id": "ai:prompts:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3380,49 +4209,68 @@
         "dist",
         "commands",
         "ai",
-        "agents",
+        "prompts",
         "list.js"
       ]
     },
-    "ai:agents:run": {
+    "ai:prompts:run": {
       "aliases": [],
       "args": {},
-      "description": "Execute an AI agent with a prompt or start interactive chat",
+      "description": "Execute a direct prompt with an AI model",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -a \"Skip: Requirements Expert\" -p \"Create a dashboard for sales metrics\"",
-        "<%= config.bin %> <%= command.id %> -a \"Child Component Generator Sub-agent\" --chat",
-        "<%= config.bin %> <%= command.id %> -a \"Skip: Technical Design Expert\" -p \"Build a React component\" --verbose --timeout=600000"
+        "<%= config.bin %> <%= command.id %> -p \"Explain quantum computing in simple terms\"",
+        "<%= config.bin %> <%= command.id %> -p \"Write a Python function to sort a list\" --model \"gpt-4\"",
+        "<%= config.bin %> <%= command.id %> -p \"Translate to French: Hello world\" --temperature 0.3",
+        "<%= config.bin %> <%= command.id %> -p \"Generate a haiku\" --system \"You are a poet\" --max-tokens 100"
       ],
       "flags": {
-        "agent": {
-          "char": "a",
-          "description": "Agent name",
-          "name": "agent",
+        "prompt": {
+          "char": "p",
+          "description": "The prompt to execute",
+          "name": "prompt",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "prompt": {
-          "char": "p",
-          "description": "Prompt to execute",
-          "exclusive": [
-            "chat"
-          ],
-          "name": "prompt",
+        "model": {
+          "char": "m",
+          "description": "AI model to use (e.g., gpt-4, claude-3-opus)",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "chat": {
+        "system": {
+          "char": "s",
+          "description": "System prompt to set context",
+          "name": "system",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "temperature": {
+          "char": "t",
+          "description": "Temperature for response creativity (0.0-2.0)",
+          "name": "temperature",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-tokens": {
+          "description": "Maximum tokens for the response",
+          "name": "max-tokens",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "configuration": {
           "char": "c",
-          "description": "Start interactive chat mode",
-          "exclusive": [
-            "prompt"
-          ],
-          "name": "chat",
-          "allowNo": false,
-          "type": "boolean"
+          "description": "AI Configuration ID to use",
+          "name": "configuration",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "output": {
           "char": "o",
@@ -3456,7 +4304,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:run",
+      "id": "ai:prompts:run",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3467,189 +4315,181 @@
         "dist",
         "commands",
         "ai",
-        "agents",
+        "prompts",
         "run.js"
       ]
     },
-    "ai:audit:agent-run": {
+    "test:regression:build": {
       "aliases": [],
       "args": {
-        "runId": {
-          "description": "AI Agent Run ID to audit (UUID)",
-          "name": "runId",
+        "service": {
+          "description": "Optional service name(s) to rebuild (e.g. mjexplorer, test-runner).",
+          "name": "service",
           "required": false
         }
       },
-      "description": "Audit and analyze AI agent execution runs for debugging and performance analysis",
+      "description": "Build Docker images for the regression stack. On first run (or whenever .docker-generated/ is empty) this also invokes `gen-forms` to generate Angular entity forms — that step takes ~5 minutes but only happens when the form output is missing.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> abc-123-def-456",
-        "<%= config.bin %> <%= command.id %> abc-123-def-456 --output=markdown",
-        "<%= config.bin %> <%= command.id %> abc-123-def-456 --step 3",
-        "<%= config.bin %> <%= command.id %> abc-123-def-456 --step 3 --detail full",
-        "<%= config.bin %> <%= command.id %> abc-123-def-456 --errors",
-        "<%= config.bin %> <%= command.id %> --list --agent \"Skip: Requirements Expert\"",
-        "<%= config.bin %> <%= command.id %> --list --status failed --days 7",
-        "<%= config.bin %> <%= command.id %> abc-123-def-456 --export full --file report.json"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> mjexplorer  # rebuild a specific service",
+        "<%= config.bin %> <%= command.id %> --skip-gen-forms"
       ],
       "flags": {
-        "output": {
-          "char": "o",
-          "description": "Output format",
-          "name": "output",
-          "default": "compact",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "compact",
-            "json",
-            "table",
-            "markdown"
-          ],
-          "type": "option"
-        },
-        "step": {
-          "char": "s",
-          "description": "Show details for specific step number (1-based index)",
-          "exclusive": [
-            "list",
-            "errors"
-          ],
-          "name": "step",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "detail": {
-          "char": "d",
-          "dependsOn": [
-            "step"
-          ],
-          "description": "Detail level for step output (default: standard)",
-          "name": "detail",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "minimal",
-            "standard",
-            "detailed",
-            "full"
-          ],
-          "type": "option"
-        },
-        "errors": {
-          "char": "e",
-          "description": "Show only error details and context",
-          "exclusive": [
-            "step",
-            "list"
-          ],
-          "name": "errors",
+        "skip-gen-forms": {
+          "description": "Skip the gen-forms guard, even when .docker-generated/ is empty. Use when you know the entity forms are already generated.",
+          "name": "skip-gen-forms",
           "allowNo": false,
           "type": "boolean"
-        },
-        "list": {
-          "char": "l",
-          "description": "List recent agent runs",
-          "exclusive": [
-            "step",
-            "errors"
-          ],
-          "name": "list",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:regression:build",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "regression",
+        "build.js"
+      ]
+    },
+    "test:regression:compare": {
+      "aliases": [],
+      "args": {},
+      "description": "Diff the two most recent regression runs from docker/regression/test-results/. Thin alias for `mj test compare --from-json <dir>` that handles the path.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --diff-only",
+        "<%= config.bin %> <%= command.id %> --format=markdown --output=delta.md"
+      ],
+      "flags": {
+        "diff-only": {
+          "description": "Show only differences.",
+          "name": "diff-only",
           "allowNo": false,
           "type": "boolean"
         },
-        "agent": {
-          "char": "a",
-          "dependsOn": [
-            "list"
-          ],
-          "description": "Filter by agent name",
-          "name": "agent",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "dependsOn": [
-            "list"
-          ],
-          "description": "Filter by run status",
-          "name": "status",
-          "default": "all",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "success",
-            "failed",
-            "running",
-            "all"
-          ],
-          "type": "option"
-        },
-        "days": {
-          "dependsOn": [
-            "list"
-          ],
-          "description": "Number of days to look back",
-          "name": "days",
-          "default": 7,
+        "format": {
+          "char": "f",
+          "description": "Output format.",
+          "name": "format",
+          "default": "console",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "console",
+            "json",
+            "markdown"
+          ],
           "type": "option"
         },
-        "limit": {
-          "dependsOn": [
-            "list"
-          ],
-          "description": "Maximum number of runs to return",
-          "name": "limit",
-          "default": 50,
+        "output": {
+          "char": "o",
+          "description": "Output file path.",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "export": {
-          "dependsOn": [
-            "file"
-          ],
-          "description": "Export full data to file",
-          "name": "export",
+        "verbose": {
+          "description": "Show detailed information.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "tag": {
+          "description": "Filter suite runs by tag. Compares the two most recent runs whose Tags array contains the tag — useful when an archive MJ holds runs from multiple environments.",
+          "name": "tag",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "full",
-            "summary",
-            "steps"
-          ],
           "type": "option"
-        },
-        "file": {
-          "char": "f",
-          "description": "Output file path for export",
-          "name": "file",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:regression:compare",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "regression",
+        "compare.js"
+      ]
+    },
+    "test:regression:down": {
+      "aliases": [],
+      "args": {},
+      "description": "Stop the regression stack and wipe DB volumes (docker compose down -v).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --keep-volumes"
+      ],
+      "flags": {
+        "keep-volumes": {
+          "description": "Skip the `-v` flag — preserves the ephemeral DB volume.",
+          "name": "keep-volumes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:regression:down",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "regression",
+        "down.js"
+      ]
+    },
+    "test:regression:export": {
+      "aliases": [],
+      "args": {},
+      "description": "Export a regression run's HTML report as a single self-contained file (screenshots inlined as base64), producing report.standalone.html. Portable for sharing or attaching as a CI artifact.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --run=run-20260526T220118Z",
+        "<%= config.bin %> <%= command.id %> --run=./some/other/run-dir"
+      ],
+      "flags": {
+        "run": {
+          "char": "r",
+          "description": "Which run to export. A folder name (under test-results/) or a path. Defaults to the latest run.",
+          "name": "run",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "max-tokens": {
-          "description": "Maximum tokens per field (0 = no limit)",
-          "name": "max-tokens",
-          "default": 5000,
+        "image": {
+          "description": "(external) Published image used to inline reports. Default: memberjunction/agentic-test-runner:latest.",
+          "name": "image",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed diagnostic information",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:audit:agent-run",
+      "id": "test:regression:export",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3659,20 +4499,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "ai",
-        "audit",
-        "agent-run.js"
+        "test",
+        "regression",
+        "export.js"
       ]
     },
-    "ai:audit": {
+    "test:regression:gen-forms": {
       "aliases": [],
       "args": {},
-      "description": "Analyze and audit AI agent runs, prompts, and actions for debugging and performance analysis",
+      "description": "Regenerate Angular entity forms used by the regression MJExplorer image. Slow (~5 min) — only required after schema or codegen changes.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
       "flags": {},
       "hasDynamicHelp": false,
-      "hidden": false,
       "hiddenAliases": [],
-      "id": "ai:audit",
+      "id": "test:regression:gen-forms",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3682,30 +4524,71 @@
       "relativePath": [
         "dist",
         "commands",
-        "ai",
-        "audit",
-        "index.js"
+        "test",
+        "regression",
+        "gen-forms.js"
       ]
     },
-    "ai:prompts:list": {
+    "test:regression": {
       "aliases": [],
       "args": {},
-      "description": "List available models for prompt execution",
+      "description": "MJ Explorer regression test suite — Docker-based LLM-driven browser tests",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> build      # Build images (incl. gen-forms on first run)",
+        "<%= config.bin %> <%= command.id %> up         # Run the full self-contained MJ stack (Mode A)",
+        "<%= config.bin %> <%= command.id %> down       # Tear down + wipe DB volumes",
+        "<%= config.bin %> <%= command.id %> gen-forms  # Regenerate Angular entity forms",
+        "<%= config.bin %> <%= command.id %> compare    # Diff the two most recent runs",
+        "<%= config.bin %> <%= command.id %> export     # Export a run as a portable standalone HTML",
+        "<%= config.bin %> <%= command.id %> remote --target=staging-mj  # Mode B/C/D against a remote URL",
+        "<%= config.bin %> <%= command.id %> init generic-web            # Scaffold one of the example dirs"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:regression",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "regression",
+        "index.js"
+      ]
+    },
+    "test:regression:init": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Template name to scaffold (run with --list to see available).",
+          "name": "name",
+          "required": false
+        }
+      },
+      "description": "Scaffold one of the bundled regression-suite mode templates into the current directory. Adapt the generated files (target profile + optional compose overlay + tests) to point at your app, then run `mj test regression remote --target=...` to execute the suite against it.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> generic-web",
+        "<%= config.bin %> <%= command.id %> static-file-server",
+        "<%= config.bin %> <%= command.id %> remote-mj",
+        "<%= config.bin %> <%= command.id %> bring-your-own-app",
+        "<%= config.bin %> <%= command.id %> --list"
       ],
       "flags": {
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed model information",
-          "name": "verbose",
+        "list": {
+          "description": "List available templates and exit.",
+          "name": "list",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:prompts:list",
+      "id": "test:regression:init",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3715,95 +4598,145 @@
       "relativePath": [
         "dist",
         "commands",
-        "ai",
-        "prompts",
-        "list.js"
+        "test",
+        "regression",
+        "init.js"
       ]
     },
-    "ai:prompts:run": {
+    "test:regression:remote": {
       "aliases": [],
       "args": {},
-      "description": "Execute a direct prompt with an AI model",
+      "description": "Run the regression suite against a remote URL (Mode B/C/D). Inside the MJ monorepo it drives the local compose stack; outside it runs the published agentic-test-runner image (no monorepo needed).",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -p \"Explain quantum computing in simple terms\"",
-        "<%= config.bin %> <%= command.id %> -p \"Write a Python function to sort a list\" --model \"gpt-4\"",
-        "<%= config.bin %> <%= command.id %> -p \"Translate to French: Hello world\" --temperature 0.3",
-        "<%= config.bin %> <%= command.id %> -p \"Generate a haiku\" --system \"You are a poet\" --max-tokens 100"
+        "<%= config.bin %> <%= command.id %> --target=staging-mj",
+        "<%= config.bin %> <%= command.id %> --target=./my/custom.target.json",
+        "<%= config.bin %> <%= command.id %> --target=./app/target.json --overlay=./app/docker-compose.app.yml",
+        "<%= config.bin %> <%= command.id %> --target=./t.json --image=memberjunction/agentic-test-runner:v5.30.0 --env-file=./.env"
       ],
       "flags": {
-        "prompt": {
-          "char": "p",
-          "description": "The prompt to execute",
-          "name": "prompt",
+        "target": {
+          "char": "t",
+          "description": "Target profile. Bare name (monorepo: docker/regression/targets/<name>.target.json) or a path.",
+          "name": "target",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "char": "m",
-          "description": "AI model to use (e.g., gpt-4, claude-3-opus)",
-          "name": "model",
+        "no-local-stack": {
+          "description": "(monorepo only) Use the lean `remote-target` profile (test-runner only) instead of the full local stack.",
+          "name": "no-local-stack",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "overlay": {
+          "description": "docker-compose overlay (Mode D) that boots your app alongside the runner on the same network. May repeat.",
+          "name": "overlay",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "image": {
+          "description": "(external) Published image tag to run. Default: memberjunction/agentic-test-runner:latest. Pin for reproducibility.",
+          "name": "image",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "system": {
-          "char": "s",
-          "description": "System prompt to set context",
-          "name": "system",
+        "env-file": {
+          "description": "(external) Path to a .env injected into the runner (DB_*, AI_VENDOR_API_KEY__GeminiLLM, auth env: refs).",
+          "name": "env-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "temperature": {
-          "char": "t",
-          "description": "Temperature for response creativity (0.0-2.0)",
-          "name": "temperature",
+        "detach": {
+          "char": "d",
+          "description": "(monorepo) Run in the background (docker compose up -d).",
+          "name": "detach",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:regression:remote",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "regression",
+        "remote.js"
+      ]
+    },
+    "test:regression:up": {
+      "aliases": [],
+      "args": {},
+      "description": "Run the self-contained MJ regression stack (Mode A). With --bacpac, the DB is imported from a .bacpac. Inside the monorepo this builds from source; outside, --bacpac runs the published-image stack (plain `up` is monorepo-only).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --detach",
+        "<%= config.bin %> <%= command.id %> --bacpac=./db.bacpac --suite=\"My Suite\" --metadata=./my-suite-metadata",
+        "<%= config.bin %> <%= command.id %> --bacpac=./db.bacpac --bacpac-no-upgrade"
+      ],
+      "flags": {
+        "detach": {
+          "char": "d",
+          "description": "Run containers in the background (docker compose up -d).",
+          "name": "detach",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "bacpac": {
+          "description": "Path to a .bacpac of a real MJ database to import and test against.",
+          "name": "bacpac",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "max-tokens": {
-          "description": "Maximum tokens for the response",
-          "name": "max-tokens",
+        "bacpac-no-upgrade": {
+          "description": "Import the bacpac as-is — skip migrate/codegen. Only safe at the current MJ version. Requires --bacpac.",
+          "name": "bacpac-no-upgrade",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "suite": {
+          "description": "Test suite to run (TEST_SUITE_NAME). Use with --bacpac + --metadata.",
+          "name": "suite",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "configuration": {
-          "char": "c",
-          "description": "AI Configuration ID to use",
-          "name": "configuration",
+        "metadata": {
+          "description": "Directory of your test + test-suite metadata (pushed before the run). Requires --bacpac.",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "Output format",
-          "name": "output",
-          "default": "compact",
+        "image": {
+          "description": "(external) Published agentic-test-runner image. Default: memberjunction/agentic-test-runner:latest.",
+          "name": "image",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "compact",
-            "json",
-            "table"
-          ],
           "type": "option"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed execution information",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
+        "explorer-image": {
+          "description": "(external bacpac) Published Explorer image (prerequisite). Default: memberjunction/explorer:latest.",
+          "name": "explorer-image",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "timeout": {
-          "description": "Execution timeout in milliseconds",
-          "name": "timeout",
-          "default": 300000,
+        "env-file": {
+          "description": "(external) .env injected into the runner (auth env: refs).",
+          "name": "env-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3811,7 +4744,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:prompts:run",
+      "id": "test:regression:up",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3821,11 +4754,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "ai",
-        "prompts",
-        "run.js"
+        "test",
+        "regression",
+        "up.js"
       ]
     }
   },
-  "version": "5.37.0"
+  "version": "5.39.0"
 }