@memberjunction/cli 4.3.1 → 5.0.0

package/README.md

@@ -135,6 +135,136 @@ mj codegen manifest
 mj codegen manifest --exclude-packages @memberjunction --output ./src/generated/manifest.ts
 ```
 
+#### v5.0 Entity Name Migration Commands
+
+Starting in MemberJunction v5.0, all 272 core entity names are being normalized with the `"MJ: "` prefix to prevent naming collisions on client systems (e.g., `"Actions"` becomes `"MJ: Actions"`). The database migration handles the rename automatically, but hardcoded entity name strings in your TypeScript source, Angular HTML templates, and metadata JSON files also need updating. These three commands automate that process.
+
+All three commands share the same workflow:
+1. **Dry-run first** (default) -- scans and reports what would change, without modifying any files.
+2. **Fix mode** (`--fix`) -- applies the changes in place.
+3. **Rename map** -- built dynamically by parsing `@RegisterClass(BaseEntity, 'MJ: XYZ')` decorators from `entity_subclasses.ts`. No hardcoded list to maintain.
+
+> These commands will be kept for 1-2 years to support the v5.0 upgrade window, then removed.
+
+##### mj codegen 5-0-fix-entity-names
+
+Scans **TypeScript source files** (`.ts`) using the TypeScript compiler AST to find hardcoded entity names that need the `"MJ: "` prefix. This is the most comprehensive scanner -- it understands code context, not just string matching.
+
+**Detected patterns:**
+
+| Pattern | Example |
+|---------|---------|
+| `GetEntityObject` calls | `md.GetEntityObject<T>('Actions')` |
+| `OpenEntityRecord` calls | `this.OpenEntityRecord('Entities', id)` |
+| `navigateToEntity` calls | `navigateToEntity('Templates')` |
+| `BuildRelationshipViewParamsByEntityName` calls | `BuildRelationshipViewParamsByEntityName('Roles')` |
+| `NewRecordValues` calls | `NewRecordValues('Users')` |
+| `IsCurrentTab` calls | `IsCurrentTab('Queries')` |
+| `EntityName:` property assignments | `EntityName: 'AI Agent Examples'` |
+| `.Name ===` / `.Entity ===` comparisons | `entity.Name === 'Actions'` |
+| `@RegisterClass` decorator (BaseEntity) | `@RegisterClass(BaseEntity, 'Actions')` |
+
+**Default exclusions:** `node_modules`, `dist`, `build`, `.git`, `__tests__`, `*.d.ts`, `*.spec.ts`, `*.test.ts`, `generated/`, `Demos/`
+
+```bash
+# Dry-run: scan entire packages/ directory
+mj codegen 5-0-fix-entity-names --path packages/
+
+# Dry-run: scan a single file
+mj codegen 5-0-fix-entity-names --path packages/Angular/Explorer/dashboards/src/Actions/components/actions-overview.component.ts
+
+# Apply fixes
+mj codegen 5-0-fix-entity-names --path packages/ --fix
+
+# Custom entity_subclasses.ts location
+mj codegen 5-0-fix-entity-names --path packages/ --entity-subclasses ./path/to/entity_subclasses.ts
+
+# Quiet mode (summary only)
+mj codegen 5-0-fix-entity-names --path packages/ -q
+```
+
+##### mj codegen 5-0-fix-html-entity-names
+
+Scans **Angular HTML template files** (`.html`) using targeted regex patterns for entity name references in template expressions and attribute values.
+
+**Detected patterns:**
+
+| Pattern | Example |
+|---------|---------|
+| Method calls in event/property bindings | `(click)="navigateToEntity('Actions')"` |
+| `OpenEntityRecord` / `openEntityRecord` | `(click)="OpenEntityRecord('Entities', id)"` |
+| `BuildRelationshipViewParamsByEntityName` | `[Params]="BuildRelationshipViewParamsByEntityName('Roles')"` |
+| `RowsEntityName` attribute | `RowsEntityName="Users"` |
+| `JoinEntityName` attribute | `JoinEntityName="Roles"` |
+
+**Default exclusions:** `node_modules`, `dist`, `build`, `.git`, `generated/`, `Demos/`
+
+```bash
+# Dry-run: scan Angular templates
+mj codegen 5-0-fix-html-entity-names --path packages/Angular/
+
+# Apply fixes
+mj codegen 5-0-fix-html-entity-names --path packages/Angular/ --fix
+
+# Verbose output showing individual file progress
+mj codegen 5-0-fix-html-entity-names --path packages/ -v
+```
+
+##### mj codegen 5-0-fix-metadata-names
+
+Scans **metadata JSON files** (including dotfiles like `.mj-sync.json`) for entity name references that need the `"MJ: "` prefix. Targets the `metadata/` directory used by `mj sync`.
+
+**Detected patterns:**
+
+| Pattern | Example |
+|---------|---------|
+| `@lookup:` entity name | `@lookup:Entities.Name=Dashboards` |
+| `@lookup:` value (in Entities lookups) | `@lookup:MJ: Entities.Name=Actions` |
+| Folder config `entity`/`entityName` | `.mj-sync.json` with `"entity": "Dashboards"` |
+| `relatedEntities` object keys | `"relatedEntities": { "Actions": [...] }` |
+| `fields.Name` in Entities folders | Entity record data files where Name is the entity name |
+
+```bash
+# Dry-run: scan metadata directory
+mj codegen 5-0-fix-metadata-names --path metadata/
+
+# Apply fixes
+mj codegen 5-0-fix-metadata-names --path metadata/ --fix
+
+# Scan a specific subdirectory
+mj codegen 5-0-fix-metadata-names --path metadata/resource-types
+
+# Scan and fix a single file
+mj codegen 5-0-fix-metadata-names --path metadata/entities/.audit-related-entities.json --fix
+```
+
+##### Common flags (all three commands)
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--path <dir\|file>` | `-p` | File or directory to scan. Defaults to current directory. |
+| `--fix` | | Apply fixes in place. Without this flag, runs in dry-run mode. |
+| `--entity-subclasses <path>` | | Path to `entity_subclasses.ts`. Auto-detected if omitted. |
+| `--quiet` | `-q` | Suppress detailed output, show summary only. |
+| `--verbose` | `-v` | Show detailed progress for each file scanned. |
+
+##### Recommended migration workflow
+
+```bash
+# 1. Scan everything first (dry-run)
+mj codegen 5-0-fix-entity-names --path packages/
+mj codegen 5-0-fix-html-entity-names --path packages/
+mj codegen 5-0-fix-metadata-names --path metadata/
+
+# 2. Review the output, then apply
+mj codegen 5-0-fix-entity-names --path packages/ --fix
+mj codegen 5-0-fix-html-entity-names --path packages/ --fix
+mj codegen 5-0-fix-metadata-names --path metadata/ --fix
+
+# 3. Build and test
+npm run build
+```
+
 ### mj sync
 
 Metadata synchronization between JSON files and the database.

package/bin/dev.cmd

@@ -1,3 +1,3 @@
-@echo off
-
+@echo off
+
 node "%~dp0\dev" %*

package/bin/run.cmd

@@ -1,3 +1,3 @@
-@echo off
-
-node "%~dp0\run" %*
+@echo off
+
+node "%~dp0\run" %*

package/dist/commands/clean/index.d.ts

@@ -1,12 +1,10 @@
 import { Command } from '@oclif/core';
-import type { ParserOutput } from '@oclif/core/lib/interfaces/parser';
 export default class Clean extends Command {
     static description: string;
     static examples: string[];
     static flags: {
         verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
-    flags: ParserOutput<Clean>['flags'];
     run(): Promise<void>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/clean/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/clean/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAKtE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAC,WAAW,SAAoE;IAEtF,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,KAAK;;MAEV;IAEF,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;IAE9B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+B3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/clean/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAC,WAAW,SAAoE;IAEtF,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,KAAK;;MAEV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyC3B"}

package/dist/commands/clean/index.js

@@ -1,7 +1,7 @@
 import { Command, Flags } from '@oclif/core';
-import { Flyway } from 'node-flyway';
-import { getValidatedConfig, getFlywayConfig } from '../../config.js';
+import { Skyway } from '@memberjunction/skyway-core';
 import ora from 'ora-classic';
+import { getValidatedConfig, getSkywayConfig } from '../../config.js';
 export default class Clean extends Command {
     static { this.description = 'Resets the MemberJunction database to a pre-installation state'; }
     static { this.examples = [
@@ -12,30 +12,42 @@ export default class Clean extends Command {
         verbose: Flags.boolean({ char: 'v', description: 'Enable additional logging' }),
     }; }
     async run() {
-        const parsed = await this.parse(Clean);
-        this.flags = parsed.flags;
+        const { flags } = await this.parse(Clean);
         const config = getValidatedConfig();
-        const flywayConfig = await getFlywayConfig(config);
-        const flyway = new Flyway(flywayConfig);
+        if (config.cleanDisabled !== false) {
+            this.error('Clean is disabled. Set cleanDisabled: false in mj.config.cjs to enable.');
+        }
+        const skywayConfig = await getSkywayConfig(config);
+        const skyway = new Skyway(skywayConfig);
         this.log('Resetting MJ database to pre-installation state');
         this.log('Note that users and roles have not been dropped');
         const spinner = ora('Cleaning up...');
         spinner.start();
-        const result = await flyway.clean();
-        if (result.success) {
-            spinner.succeed();
-            this.log(`The database has been reset. Schemas dropped:\n\t- ${result.flywayResponse?.schemasDropped.join('\n\t- ')}`);
-        }
-        else {
-            spinner.fail();
-            if (result.error) {
-                this.logToStderr(result.error.message);
-                if (this.flags.verbose) {
-                    this.logToStderr(`ERROR CODE: ${result.error.errorCode}`);
-                    this.logToStderr(result.error.stackTrace);
+        try {
+            const result = await skyway.Clean();
+            if (result.Success) {
+                spinner.succeed();
+                this.log(`The database has been reset. ${result.ObjectsDropped} objects dropped.`);
+                if (result.DroppedObjects.length > 0) {
+                    this.log(`Objects dropped:\n\t- ${result.DroppedObjects.join('\n\t- ')}`);
+                }
+            }
+            else {
+                spinner.fail();
+                this.logToStderr(`\nClean failed: ${result.ErrorMessage ?? 'unknown error'}`);
+                if (flags.verbose && result.DroppedObjects.length > 0) {
+                    this.logToStderr(`Partial cleanup:\n\t- ${result.DroppedObjects.join('\n\t- ')}`);
                 }
+                this.error('Command failed');
             }
-            this.error('Command failed');
+        }
+        catch (err) {
+            spinner.fail();
+            const message = err instanceof Error ? err.message : String(err);
+            this.error(`Clean error: ${message}`);
+        }
+        finally {
+            await skyway.Close();
         }
     }
 }

package/dist/commands/clean/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/clean/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,GAAG,MAAM,aAAa,CAAC;AAE9B,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;aACjC,gBAAW,GAAG,gEAAgE,CAAC;aAE/E,aAAQ,GAAG;QAChB;CACH;KACE,CAAC;aAEK,UAAK,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;KAChF,CAAC;IAIF,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE1B,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAEpC,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QAExC,IAAI,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACtC,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAEpC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,sDAAsD,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACvB,IAAI,CAAC,WAAW,CAAC,eAAe,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;oBAC1D,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/clean/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;aACjC,gBAAW,GAAG,gEAAgE,CAAC;aAE/E,aAAQ,GAAG;QAChB;CACH;KACE,CAAC;aAEK,UAAK,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;KAChF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAEpC,IAAI,MAAM,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QAExC,IAAI,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACtC,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YAEpC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,GAAG,CAAC,gCAAgC,MAAM,CAAC,cAAc,mBAAmB,CAAC,CAAC;gBACnF,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrC,IAAI,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,WAAW,CAAC,mBAAmB,MAAM,CAAC,YAAY,IAAI,eAAe,EAAE,CAAC,CAAC;gBAC9E,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtD,IAAI,CAAC,WAAW,CAAC,yBAAyB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACpF,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC"}

package/dist/commands/codegen/5-0-fix-entity-names.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class V50FixEntityNames extends Command {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        path: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        fix: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'entity-subclasses': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=5-0-fix-entity-names.d.ts.map

package/dist/commands/codegen/5-0-fix-entity-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"5-0-fix-entity-names.d.ts","sourceRoot":"","sources":["../../../src/commands/codegen/5-0-fix-entity-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,OAAO;IAClD,MAAM,CAAC,WAAW,SASgF;IAElG,MAAM,CAAC,QAAQ;;;QAiBb;IAEF,MAAM,CAAC,KAAK;;;;;;MAsBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAsD7B"}

package/dist/commands/codegen/5-0-fix-entity-names.js

@@ -0,0 +1,104 @@
+import { Command, Flags } from '@oclif/core';
+export default class V50FixEntityNames extends Command {
+    static { this.description = `[v5.0 Migration] Scan TypeScript files for entity names AND class names that need updating.
+
+Three strategies are applied:
+  1. Class name renames (regex) — ActionEntity -> MJActionEntity, ActionSchema -> MJActionSchema, etc.
+  2. Multi-word entity name renames (regex) — 'AI Models' -> 'MJ: AI Models'
+  3. Single-word entity name renames (AST) — 'Actions' -> 'MJ: Actions' in GetEntityObject, OpenEntityRecord,
+     navigateToEntity, EntityName: assignments, .Name === comparisons, @RegisterClass decorators.
+
+The rename map (272 entries) is built from entity_subclasses.ts @RegisterClass decorators plus
+an embedded rename map for class name prefixes. Runs in dry-run mode by default; use --fix to apply.`; }
+    static { this.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',
+        },
+    ]; }
+    static { this.flags = {
+        path: Flags.string({
+            char: 'p',
+            description: 'File or directory to scan. Accepts a single .ts file or a directory (scanned recursively). Defaults to the current working directory.',
+        }),
+        fix: Flags.boolean({
+            description: 'Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.',
+            default: false,
+        }),
+        'entity-subclasses': Flags.string({
+            description: 'Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.',
+        }),
+        quiet: Flags.boolean({
+            char: 'q',
+            description: 'Suppress detailed per-file output; only show the final summary counts.',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed progress including each file being scanned.',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { scanEntityNames } = await import('@memberjunction/codegen-lib');
+        const { flags } = await this.parse(V50FixEntityNames);
+        const result = await scanEntityNames({
+            TargetPath: flags.path || process.cwd(),
+            Fix: flags.fix,
+            EntitySubclassesPath: flags['entity-subclasses'],
+            Verbose: flags.verbose,
+        });
+        if (!result.Success) {
+            this.error(`Scan failed:\n${result.Errors.map((e) => `  - ${e}`).join('\n')}`);
+        }
+        if (!flags.quiet) {
+            this.log(`\nScanned ${result.FilesScanned} files, found ${result.Findings.length} reference(s) needing update`);
+            this.log(`Rename map: ${result.RenameMapSize} entity name mappings loaded`);
+            if (result.Findings.length > 0) {
+                // Strategy breakdown
+                const classNameCount = result.Findings.filter((f) => f.PatternKind === 'ClassName').length;
+                const multiWordCount = result.Findings.filter((f) => f.PatternKind === 'MultiWordEntityName').length;
+                const astCount = result.Findings.length - classNameCount - multiWordCount;
+                this.log(`\n  Strategy breakdown:`);
+                if (classNameCount > 0)
+                    this.log(`    Class name renames:          ${classNameCount}`);
+                if (multiWordCount > 0)
+                    this.log(`    Multi-word entity names:     ${multiWordCount}`);
+                if (astCount > 0)
+                    this.log(`    Single-word entity names:    ${astCount}`);
+                // Group by file for readable output
+                const byFile = new Map();
+                for (const f of result.Findings) {
+                    if (!byFile.has(f.FilePath))
+                        byFile.set(f.FilePath, []);
+                    byFile.get(f.FilePath).push(f);
+                }
+                for (const [file, findings] of byFile) {
+                    this.log(`\n  ${file}:`);
+                    for (const f of findings) {
+                        this.log(`    Line ${f.Line}: '${f.OldName}' -> '${f.NewName}' [${f.PatternKind}]`);
+                    }
+                }
+            }
+            if (flags.fix) {
+                this.log(`\nFixed ${result.FixedFiles.length} file(s)`);
+            }
+            else if (result.Findings.length > 0) {
+                this.log(`\nRun with --fix to apply these changes`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=5-0-fix-entity-names.js.map

package/dist/commands/codegen/5-0-fix-entity-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"5-0-fix-entity-names.js","sourceRoot":"","sources":["../../../src/commands/codegen/5-0-fix-entity-names.ts"],"names":[],"mappings":"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"}

package/dist/commands/codegen/5-0-fix-html-entity-names.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class V50FixHtmlEntityNames extends Command {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        path: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        fix: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'entity-subclasses': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=5-0-fix-html-entity-names.d.ts.map

package/dist/commands/codegen/5-0-fix-html-entity-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"5-0-fix-html-entity-names.d.ts","sourceRoot":"","sources":["../../../src/commands/codegen/5-0-fix-html-entity-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,OAAO;IACtD,MAAM,CAAC,WAAW,SAQ4C;IAE9D,MAAM,CAAC,QAAQ;;;QAiBb;IAEF,MAAM,CAAC,KAAK;;;;;;MAsBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C7B"}

package/dist/commands/codegen/5-0-fix-html-entity-names.js

@@ -0,0 +1,92 @@
+import { Command, Flags } from '@oclif/core';
+export default class V50FixHtmlEntityNames extends Command {
+    static { this.description = `[v5.0 Migration] Scan Angular HTML template files for hardcoded entity names that need "MJ: " prefix updates.
+
+Uses targeted regex patterns to find entity name references in template expressions
+and attribute values. Detects method calls like navigateToEntity('Actions'),
+OpenEntityRecord('Entities', id), and attribute values like RowsEntityName="Users".
+Runs in dry-run mode by default; use --fix to apply.
+
+The rename map is built dynamically from entity_subclasses.ts by parsing all
+@RegisterClass(BaseEntity, 'MJ: XYZ') decorators (~272 entries).`; }
+    static { this.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',
+        },
+    ]; }
+    static { this.flags = {
+        path: Flags.string({
+            char: 'p',
+            description: 'File or directory to scan. Accepts a single .html file or a directory (scanned recursively). Defaults to the current working directory.',
+        }),
+        fix: Flags.boolean({
+            description: 'Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.',
+            default: false,
+        }),
+        'entity-subclasses': Flags.string({
+            description: 'Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.',
+        }),
+        quiet: Flags.boolean({
+            char: 'q',
+            description: 'Suppress detailed per-file output; only show the final summary counts.',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed progress including each file being scanned.',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { scanHtmlEntityNames } = await import('@memberjunction/codegen-lib');
+        const { flags } = await this.parse(V50FixHtmlEntityNames);
+        const result = await scanHtmlEntityNames({
+            TargetPath: flags.path || process.cwd(),
+            Fix: flags.fix,
+            EntitySubclassesPath: flags['entity-subclasses'],
+            Verbose: flags.verbose,
+        });
+        if (!result.Success) {
+            this.error(`Scan failed:\n${result.Errors.map((e) => `  - ${e}`).join('\n')}`);
+        }
+        if (!flags.quiet) {
+            this.log(`\nScanned ${result.FilesScanned} files, found ${result.Findings.length} entity name(s) needing update`);
+            this.log(`Rename map: ${result.RenameMapSize} entity name mappings loaded`);
+            if (result.Findings.length > 0) {
+                // Group by file for readable output
+                const byFile = new Map();
+                for (const f of result.Findings) {
+                    if (!byFile.has(f.FilePath))
+                        byFile.set(f.FilePath, []);
+                    byFile.get(f.FilePath).push(f);
+                }
+                for (const [file, findings] of byFile) {
+                    this.log(`\n  ${file}:`);
+                    for (const f of findings) {
+                        this.log(`    Line ${f.Line}: '${f.OldName}' -> '${f.NewName}' [${f.PatternKind}]`);
+                    }
+                }
+            }
+            if (flags.fix) {
+                this.log(`\nFixed ${result.FixedFiles.length} file(s)`);
+            }
+            else if (result.Findings.length > 0) {
+                this.log(`\nRun with --fix to apply these changes`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=5-0-fix-html-entity-names.js.map

package/dist/commands/codegen/5-0-fix-html-entity-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"5-0-fix-html-entity-names.js","sourceRoot":"","sources":["../../../src/commands/codegen/5-0-fix-html-entity-names.ts"],"names":[],"mappings":"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"}

package/dist/commands/codegen/5-0-fix-metadata-names.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class V50FixMetadataNames extends Command {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        path: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        fix: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'entity-subclasses': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=5-0-fix-metadata-names.d.ts.map

package/dist/commands/codegen/5-0-fix-metadata-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"5-0-fix-metadata-names.d.ts","sourceRoot":"","sources":["../../../src/commands/codegen/5-0-fix-metadata-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;IACpD,MAAM,CAAC,WAAW,SAS4C;IAE9D,MAAM,CAAC,QAAQ;;;QAiBb;IAEF,MAAM,CAAC,KAAK;;;;;;MAsBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C7B"}

package/dist/commands/codegen/5-0-fix-metadata-names.js

@@ -0,0 +1,93 @@
+import { Command, Flags } from '@oclif/core';
+export default class V50FixMetadataNames extends Command {
+    static { this.description = `[v5.0 Migration] Scan metadata JSON files for entity names that need "MJ: " prefix updates.
+
+Targets the metadata/ directory used by "mj sync". Detects entity name references in
+@lookup: directives (both the entity name and lookup value), .mj-sync.json and
+.mj-folder.json config files (entity/entityName fields), relatedEntities object keys,
+and fields.Name values in Entities-managing folders. Runs in dry-run mode by default;
+use --fix to apply.
+
+The rename map is built dynamically from entity_subclasses.ts by parsing all
+@RegisterClass(BaseEntity, 'MJ: XYZ') decorators (~272 entries).`; }
+    static { this.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',
+        },
+    ]; }
+    static { this.flags = {
+        path: Flags.string({
+            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.',
+        }),
+        fix: Flags.boolean({
+            description: 'Apply fixes in place. Without this flag, the command runs in dry-run mode and only reports findings.',
+            default: false,
+        }),
+        'entity-subclasses': Flags.string({
+            description: 'Explicit path to entity_subclasses.ts for building the rename map. If omitted, the tool searches common locations relative to the target path.',
+        }),
+        quiet: Flags.boolean({
+            char: 'q',
+            description: 'Suppress detailed per-file output; only show the final summary counts.',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed progress including each file being scanned.',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { scanMetadataNames } = await import('@memberjunction/codegen-lib');
+        const { flags } = await this.parse(V50FixMetadataNames);
+        const result = await scanMetadataNames({
+            TargetPath: flags.path || process.cwd(),
+            Fix: flags.fix,
+            EntitySubclassesPath: flags['entity-subclasses'],
+            Verbose: flags.verbose,
+        });
+        if (!result.Success) {
+            this.error(`Scan failed:\n${result.Errors.map((e) => `  - ${e}`).join('\n')}`);
+        }
+        if (!flags.quiet) {
+            this.log(`\nScanned ${result.FilesScanned} files, found ${result.Findings.length} entity name(s) needing update`);
+            this.log(`Rename map: ${result.RenameMapSize} entity name mappings loaded`);
+            if (result.Findings.length > 0) {
+                // Group by file for readable output
+                const byFile = new Map();
+                for (const f of result.Findings) {
+                    if (!byFile.has(f.FilePath))
+                        byFile.set(f.FilePath, []);
+                    byFile.get(f.FilePath).push(f);
+                }
+                for (const [file, findings] of byFile) {
+                    this.log(`\n  ${file}:`);
+                    for (const f of findings) {
+                        this.log(`    Line ${f.Line}: '${f.OldName}' -> '${f.NewName}' [${f.PatternKind}]`);
+                    }
+                }
+            }
+            if (flags.fix) {
+                this.log(`\nFixed ${result.FixedFiles.length} file(s)`);
+            }
+            else if (result.Findings.length > 0) {
+                this.log(`\nRun with --fix to apply these changes`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=5-0-fix-metadata-names.js.map

package/dist/commands/codegen/5-0-fix-metadata-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"5-0-fix-metadata-names.js","sourceRoot":"","sources":["../../../src/commands/codegen/5-0-fix-metadata-names.ts"],"names":[],"mappings":"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"}