@memberjunction/cli 4.4.0 → 5.1.0

package/oclif.manifest.json

@@ -22,65 +22,545 @@
         "index.js"
       ]
     },
+    "app:check-updates": {
+      "aliases": [],
+      "args": {},
+      "description": "Check for available upgrades for installed MJ Open Apps",
+      "examples": [
+        "<%= config.bin %> app check-updates"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:check-updates",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "check-updates.js"
+      ]
+    },
+    "app:disable": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Name of the installed app to disable",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Disable an installed MJ Open App without removing it",
+      "examples": [
+        "<%= config.bin %> app disable acme-crm"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:disable",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "disable.js"
+      ]
+    },
+    "app:enable": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Name of the installed app to enable",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Re-enable a disabled MJ Open App",
+      "examples": [
+        "<%= config.bin %> app enable acme-crm"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:enable",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "enable.js"
+      ]
+    },
+    "app:info": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Name of the installed app",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Show detailed information about an installed MJ Open App",
+      "examples": [
+        "<%= config.bin %> app info acme-crm"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:info",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "info.js"
+      ]
+    },
+    "app:install": {
+      "aliases": [],
+      "args": {
+        "source": {
+          "description": "GitHub repository URL of the Open App",
+          "name": "source",
+          "required": true
+        }
+      },
+      "description": "Install an MJ Open App from a GitHub repository",
+      "examples": [
+        "<%= config.bin %> app install https://github.com/acme/mj-crm",
+        "<%= config.bin %> app install https://github.com/acme/mj-crm --version 1.2.0",
+        "<%= config.bin %> app install https://github.com/acme/mj-crm --verbose"
+      ],
+      "flags": {
+        "version": {
+          "description": "Specific version to install (default: latest)",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:install",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "install.js"
+      ]
+    },
+    "app:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all installed MJ Open Apps",
+      "examples": [
+        "<%= config.bin %> app list"
+      ],
+      "flags": {
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:list",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "list.js"
+      ]
+    },
+    "app:remove": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Name of the installed app to remove",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Remove an installed MJ Open App",
+      "examples": [
+        "<%= config.bin %> app remove acme-crm",
+        "<%= config.bin %> app remove acme-crm --keep-data",
+        "<%= config.bin %> app remove acme-crm --force"
+      ],
+      "flags": {
+        "keep-data": {
+          "description": "Keep the database schema and data",
+          "name": "keep-data",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Force removal even if other apps depend on this one",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:remove",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "remove.js"
+      ]
+    },
+    "app:upgrade": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Name of the installed app to upgrade",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Upgrade an installed MJ Open App to a newer version",
+      "examples": [
+        "<%= config.bin %> app upgrade acme-crm",
+        "<%= config.bin %> app upgrade acme-crm --version 1.3.0"
+      ],
+      "flags": {
+        "version": {
+          "description": "Specific version to upgrade to (default: latest)",
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:upgrade",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "upgrade.js"
+      ]
+    },
     "bump": {
       "aliases": [],
       "args": {},
-      "description": "Bumps MemberJunction dependency versions",
+      "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"
+      ]
+    },
+    "clean": {
+      "aliases": [],
+      "args": {},
+      "description": "Resets the MemberJunction database to a pre-installation state",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>\n"
+      ],
+      "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, etc.\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 entries) is built from entity_subclasses.ts @RegisterClass decorators plus\nan embedded rename map for class name prefixes. 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": [
         {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Bump all @memberjunction/* dependencies in the current directory's package.json to the CLI version"
+          "description": "Dry-run scan of Angular templates",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -rdv",
-          "description": "Preview all recursive packages bumps without writing any changes."
+          "description": "Apply fixes to HTML templates",
+          "command": "<%= config.bin %> <%= command.id %> --path packages/Angular/ --fix"
         },
         {
-          "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."
+          "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": {
-        "verbose": {
-          "char": "v",
-          "description": "Enable additional logging",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
         },
-        "recursive": {
-          "char": "r",
-          "description": "Bump version in current directory and all subdirectories",
-          "name": "recursive",
+        "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"
         },
-        "tag": {
-          "char": "t",
-          "description": "Version tag to bump target for bump (e.g. v2.10.0), defaults to the CLI version",
-          "name": "tag",
+        "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": "Only output paths for updated packages",
+          "description": "Suppress detailed per-file output; only show the final summary counts.",
           "name": "quiet",
           "allowNo": false,
           "type": "boolean"
         },
-        "dry": {
-          "char": "d",
-          "description": "Dry run, do not write changes to package.json files",
-          "name": "dry",
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed progress including each file being scanned.",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "bump",
+      "id": "codegen:5-0-fix-html-entity-names",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -90,21 +570,64 @@
       "relativePath": [
         "dist",
         "commands",
-        "bump",
-        "index.js"
+        "codegen",
+        "5-0-fix-html-entity-names.js"
       ]
     },
-    "clean": {
+    "codegen:5-0-fix-metadata-names": {
       "aliases": [],
       "args": {},
-      "description": "Resets the MemberJunction database to a pre-installation state",
+      "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": [
-        "<%= config.bin %> <%= command.id %>\n"
+        {
+          "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": "Enable additional logging",
+          "description": "Show detailed progress including each file being scanned.",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -112,7 +635,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "clean",
+      "id": "codegen:5-0-fix-metadata-names",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -122,20 +645,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "clean",
-        "index.js"
+        "codegen",
+        "5-0-fix-metadata-names.js"
       ]
     },
     "codegen": {
       "aliases": [],
       "args": {},
-      "description": "Run CodeGen to generate code and update metadata for MemberJunction",
+      "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.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>\n"
+        {
+          "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"
+        }
       ],
       "flags": {
         "skipdb": {
-          "description": "Skip database migration",
+          "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"
@@ -160,17 +690,29 @@
     "codegen:manifest": {
       "aliases": [],
       "args": {},
-      "description": "Generate a class registrations manifest to prevent tree-shaking of @RegisterClass decorated classes",
+      "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": [
-        "<%= config.bin %> <%= command.id %> --output ./src/generated/class-registrations-manifest.ts",
-        "<%= config.bin %> <%= command.id %> --appDir ./packages/MJAPI --output ./packages/MJAPI/src/generated/class-registrations-manifest.ts",
-        "<%= config.bin %> <%= command.id %> --filter BaseEngine --filter BaseAction",
-        "<%= config.bin %> <%= command.id %> --verbose"
+        {
+          "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 %> --filter BaseEngine --filter BaseAction --verbose",
+          "description": "Only include specific base classes with detailed progress"
+        }
       ],
       "flags": {
         "output": {
           "char": "o",
-          "description": "Output manifest file path",
+          "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,
@@ -179,7 +721,7 @@
         },
         "appDir": {
           "char": "a",
-          "description": "App directory containing package.json (defaults to current directory)",
+          "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,
@@ -187,7 +729,7 @@
         },
         "filter": {
           "char": "f",
-          "description": "Only include classes with this base class (can be repeated)",
+          "description": "Only include classes extending this base class. Can be repeated (e.g., --filter BaseEngine --filter BaseAction).",
           "name": "filter",
           "hasDynamicHelp": false,
           "multiple": true,
@@ -195,7 +737,7 @@
         },
         "exclude-packages": {
           "char": "e",
-          "description": "Exclude packages matching this prefix from scanning (can be repeated). Example: --exclude-packages @memberjunction",
+          "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,
@@ -203,14 +745,14 @@
         },
         "quiet": {
           "char": "q",
-          "description": "Suppress all output",
+          "description": "Suppress all output except errors.",
           "name": "quiet",
           "allowNo": false,
           "type": "boolean"
         },
         "verbose": {
           "char": "v",
-          "description": "Show detailed progress including skipped classes and per-package info",
+          "description": "Show detailed progress including per-package scanning info and skipped classes.",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -1069,12 +1611,12 @@
       "args": {},
       "description": "Pull metadata from database to local files",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --entity=\"AI Prompts\"",
-        "<%= config.bin %> <%= command.id %> --entity=\"AI Prompts\" --filter=\"CategoryID='customer-service-id'\"",
-        "<%= config.bin %> <%= command.id %> --entity=\"AI Agents\" --merge-strategy=overwrite",
+        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\"",
+        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\" --filter=\"CategoryID='customer-service-id'\"",
+        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Agents\" --merge-strategy=overwrite",
         "<%= config.bin %> <%= command.id %> --entity=\"Actions\" --target-dir=./custom-actions --no-validate",
         "<%= config.bin %> <%= command.id %> --entity=\"Templates\" --dry-run --verbose",
-        "<%= config.bin %> <%= command.id %> --entity=\"AI Prompts\" --exclude-fields=InternalNotes,DebugInfo"
+        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\" --exclude-fields=InternalNotes,DebugInfo"
       ],
       "flags": {
         "entity": {
@@ -1913,192 +2455,70 @@
           "name": "testId",
           "required": false
         }
-      },
-      "description": "Validate test definitions without executing",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <test-id>",
-        "<%= config.bin %> <%= command.id %> --all",
-        "<%= config.bin %> <%= command.id %> --type=agent-eval",
-        "<%= config.bin %> <%= command.id %> --all --save-report",
-        "<%= config.bin %> <%= command.id %> --all --output=validation-report.md"
-      ],
-      "flags": {
-        "all": {
-          "char": "a",
-          "description": "Validate all tests",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "type": {
-          "char": "t",
-          "description": "Validate tests by type",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "save-report": {
-          "description": "Save validation report to file",
-          "name": "save-report",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "console",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "console",
-            "json",
-            "markdown"
-          ],
-          "type": "option"
-        },
-        "output": {
-          "char": "o",
-          "description": "Output file path",
-          "name": "output",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed information",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "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"
+      },
+      "description": "Validate test definitions without executing",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <test-id>",
+        "<%= config.bin %> <%= command.id %> --all",
+        "<%= config.bin %> <%= command.id %> --type=agent-eval",
+        "<%= config.bin %> <%= command.id %> --all --save-report",
+        "<%= config.bin %> <%= command.id %> --all --output=validation-report.md"
       ],
       "flags": {
-        "name": {
-          "char": "n",
-          "description": "Action name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "all": {
+          "char": "a",
+          "description": "Validate all tests",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "param": {
-          "char": "p",
-          "description": "Action parameters in key=value format",
-          "name": "param",
+        "type": {
+          "char": "t",
+          "description": "Validate tests by type",
+          "name": "type",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "description": "Validate without executing",
-          "name": "dry-run",
+        "save-report": {
+          "description": "Save validation report to file",
+          "name": "save-report",
           "allowNo": false,
           "type": "boolean"
         },
-        "output": {
-          "char": "o",
+        "format": {
+          "char": "f",
           "description": "Output format",
-          "name": "output",
-          "default": "compact",
+          "name": "format",
+          "default": "console",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "compact",
+            "console",
             "json",
-            "table"
+            "markdown"
           ],
           "type": "option"
         },
+        "output": {
+          "char": "o",
+          "description": "Output file path",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "verbose": {
           "char": "v",
-          "description": "Show detailed execution information",
+          "description": "Show detailed 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",
+      "id": "test:validate",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -2108,15 +2528,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "ai",
-        "actions",
-        "run.js"
+        "test",
+        "validate.js"
       ]
     },
-    "ai:agents:list": {
+    "ai:actions:list": {
       "aliases": [],
       "args": {},
-      "description": "List available AI agents",
+      "description": "List available AI actions",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --output=table",
@@ -2140,7 +2559,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:list",
+      "id": "ai:actions:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -2151,47 +2570,41 @@
         "dist",
         "commands",
         "ai",
-        "agents",
+        "actions",
         "list.js"
       ]
     },
-    "ai:agents:run": {
+    "ai:actions:run": {
       "aliases": [],
       "args": {},
-      "description": "Execute an AI agent with a prompt or start interactive chat",
+      "description": "Execute an AI action with parameters",
       "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 %> -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": {
-        "agent": {
-          "char": "a",
-          "description": "Agent name",
-          "name": "agent",
+        "name": {
+          "char": "n",
+          "description": "Action name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "prompt": {
+        "param": {
           "char": "p",
-          "description": "Prompt to execute",
-          "exclusive": [
-            "chat"
-          ],
-          "name": "prompt",
+          "description": "Action parameters in key=value format",
+          "name": "param",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "chat": {
-          "char": "c",
-          "description": "Start interactive chat mode",
-          "exclusive": [
-            "prompt"
-          ],
-          "name": "chat",
+        "dry-run": {
+          "description": "Validate without executing",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
@@ -2227,7 +2640,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:run",
+      "id": "ai:actions:run",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -2238,7 +2651,7 @@
         "dist",
         "commands",
         "ai",
-        "agents",
+        "actions",
         "run.js"
       ]
     },
@@ -2458,6 +2871,135 @@
         "index.js"
       ]
     },
+    "ai:agents:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available AI agents",
+      "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:agents:list",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "agents",
+        "list.js"
+      ]
+    },
+    "ai:agents:run": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute an AI agent with a prompt or start interactive chat",
+      "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"
+      ],
+      "flags": {
+        "agent": {
+          "char": "a",
+          "description": "Agent name",
+          "name": "agent",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "prompt": {
+          "char": "p",
+          "description": "Prompt to execute",
+          "exclusive": [
+            "chat"
+          ],
+          "name": "prompt",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "chat": {
+          "char": "c",
+          "description": "Start interactive chat mode",
+          "exclusive": [
+            "prompt"
+          ],
+          "name": "chat",
+          "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:agents:run",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "agents",
+        "run.js"
+      ]
+    },
     "ai:prompts:list": {
       "aliases": [],
       "args": {},
@@ -2598,5 +3140,5 @@
       ]
     }
   },
-  "version": "4.4.0"
+  "version": "5.1.0"
 }