@memberjunction/cli 6.1.0-edge.4 → 6.1.0-edge.5

package/oclif.manifest.json

@@ -10,9 +10,8 @@
       ],
       "flags": {
         "format": {
-          "description": "Output format",
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
           "name": "format",
-          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -60,6 +59,40 @@
         "index.js"
       ]
     },
+    "ai:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj ai` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "usage.js"
+      ]
+    },
     "app:check-updates": {
       "aliases": [],
       "args": {},
@@ -390,54 +423,27 @@
         "upgrade.js"
       ]
     },
-    "artifacts:reclassify": {
+    "app:usage": {
       "aliases": [],
       "args": {},
-      "description": "Upgrade-recovery utility for v5.35 artifact unification. Re-evaluates rows whose TypeID is the deleted JSON fallback but whose actual content does not parse as JSON. Normally a no-op: the v5.35 backfill migration handles this automatically. This command is only relevant when the migration ran BEFORE the artifact-type metadata (Generic Text / Generic Binary) was pushed via `mj sync push`, in which case the migration prints a notice telling you to run this. Reports \"no candidates\" once everything is reconciled. Dry-run by default; --apply writes through Record Changes.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --apply --limit 50"
-      ],
+      "description": "Show usage, flags, examples, and runtime hints for every `mj app` command.",
       "flags": {
-        "conversation-id": {
-          "description": "Scope to artifacts attached to the given conversation.",
-          "name": "conversation-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "since": {
-          "description": "Scope to artifacts created on/after this ISO date.",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "description": "Maximum number of rows to inspect.",
-          "name": "limit",
-          "default": 100,
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
           "type": "option"
-        },
-        "apply": {
-          "description": "Write changes. Without this flag, this command only reports what it would do.",
-          "name": "apply",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Print every candidate row, not just the summary.",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "artifacts:reclassify",
+      "id": "app:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -447,8 +453,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "artifacts",
-        "reclassify.js"
+        "app",
+        "usage.js"
       ]
     },
     "baseline:build": {
@@ -789,6 +795,135 @@
         "roundtrip.js"
       ]
     },
+    "baseline:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj baseline` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "baseline:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "baseline",
+        "usage.js"
+      ]
+    },
+    "artifacts:reclassify": {
+      "aliases": [],
+      "args": {},
+      "description": "Upgrade-recovery utility for v5.35 artifact unification. Re-evaluates rows whose TypeID is the deleted JSON fallback but whose actual content does not parse as JSON. Normally a no-op: the v5.35 backfill migration handles this automatically. This command is only relevant when the migration ran BEFORE the artifact-type metadata (Generic Text / Generic Binary) was pushed via `mj sync push`, in which case the migration prints a notice telling you to run this. Reports \"no candidates\" once everything is reconciled. Dry-run by default; --apply writes through Record Changes.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --apply --limit 50"
+      ],
+      "flags": {
+        "conversation-id": {
+          "description": "Scope to artifacts attached to the given conversation.",
+          "name": "conversation-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "since": {
+          "description": "Scope to artifacts created on/after this ISO date.",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of rows to inspect.",
+          "name": "limit",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "apply": {
+          "description": "Write changes. Without this flag, this command only reports what it would do.",
+          "name": "apply",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Print every candidate row, not just the summary.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "artifacts:reclassify",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "artifacts",
+        "reclassify.js"
+      ]
+    },
+    "artifacts:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj artifacts` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "artifacts:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "artifacts",
+        "usage.js"
+      ]
+    },
     "bump": {
       "aliases": [],
       "args": {},
@@ -861,6 +996,40 @@
         "index.js"
       ]
     },
+    "bump:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj bump` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "bump:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "bump",
+        "usage.js"
+      ]
+    },
     "bundle": {
       "aliases": [],
       "args": {},
@@ -947,25 +1116,27 @@
         "index.js"
       ]
     },
-    "clean": {
+    "bundle:usage": {
       "aliases": [],
       "args": {},
-      "description": "Resets the MemberJunction database to a pre-installation state",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>\n"
-      ],
+      "description": "Show usage, flags, examples, and runtime hints for every `mj bundle` command.",
       "flags": {
-        "verbose": {
-          "char": "v",
-          "description": "Enable additional logging",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "clean",
+      "id": "bundle:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -975,8 +1146,74 @@
       "relativePath": [
         "dist",
         "commands",
-        "clean",
-        "index.js"
+        "bundle",
+        "usage.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"
+      ]
+    },
+    "clean:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj clean` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "clean:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "clean",
+        "usage.js"
       ]
     },
     "codegen:5-0-fix-entity-names": {
@@ -1224,15 +1461,17 @@
       ],
       "flags": {
         "format": {
-          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced)",
+          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced). Defaults to text on a terminal and json when stdout is piped.",
           "name": "format",
-          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
             "text",
             "json",
-            "md"
+            "md",
+            "human",
+            "console",
+            "markdown"
           ],
           "type": "option"
         },
@@ -1249,6 +1488,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "interactive": {
+          "description": "Allow interactive prompts. Defaults to on at a terminal and off when piped, spawned, or in CI, so an agent never hangs on a question. Use --no-interactive to force it off.",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
         "skipdb": {
           "description": "Skip database operations. Only regenerate TypeScript entities, Angular components, and GraphQL resolvers from existing metadata.",
           "name": "skipdb",
@@ -1454,9 +1699,8 @@
       "description": "Show usage, flags, examples, and runtime hints for `mj codegen`.",
       "flags": {
         "format": {
-          "description": "Output format",
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
           "name": "format",
-          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -1920,6 +2164,40 @@
         "status.js"
       ]
     },
+    "dbdoc:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj dbdoc` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "dbdoc:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "dbdoc",
+        "usage.js"
+      ]
+    },
     "dev": {
       "aliases": [],
       "args": {},
@@ -1948,9 +2226,8 @@
       "description": "Show usage, flags, examples, and runtime hints for every `mj dev` command.",
       "flags": {
         "format": {
-          "description": "Output format",
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
           "name": "format",
-          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -2034,6 +2311,40 @@
         "index.js"
       ]
     },
+    "doctor:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj doctor` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "doctor:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "doctor",
+        "usage.js"
+      ]
+    },
     "install:claude": {
       "aliases": [],
       "args": {},
@@ -2268,6 +2579,118 @@
         "index.js"
       ]
     },
+    "install:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj install` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "install:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "install",
+        "usage.js"
+      ]
+    },
+    "plugin:add": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Plugin entry-point specifier (package name, subpath, or relative path)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Register a CLI plugin package in mj-cli-plugins.json so `mj` loads it at startup.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> @my-org/mj-plugin/plugins",
+        "<%= config.bin %> <%= command.id %> ./local-plugins/my-tool"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:add",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "add.js"
+      ]
+    },
+    "plugin:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj plugin` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "plugin:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "plugin",
+        "usage.js"
+      ]
+    },
     "migrate:convert": {
       "aliases": [],
       "args": {},
@@ -2311,6 +2734,14 @@
           "multiple": false,
           "type": "option"
         },
+        "core-schema": {
+          "description": "MJ core schema substituted for ${mjSchema} (default __mj). Distinct from --schema, which is the app's OWN schema: an Open App migration references core as ${mjSchema} and itself as ${flyway:defaultSchema}, and for every app those differ.",
+          "name": "core-schema",
+          "default": "__mj",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "dry-run": {
           "description": "Show what would be converted without writing files",
           "name": "dry-run",
@@ -2527,6 +2958,14 @@
           "multiple": false,
           "type": "option"
         },
+        "core-schema": {
+          "description": "MJ core schema substituted for ${mjSchema} (default __mj). Distinct from --schema, which is the app's OWN schema: an Open App migration references core as ${mjSchema} and itself as ${flyway:defaultSchema}, and for every app those differ.",
+          "name": "core-schema",
+          "default": "__mj",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "baseline-floor": {
           "description": "Re-bake migrations strictly AFTER this version key (default: the latest B* in output-dir)",
           "name": "baseline-floor",
@@ -2557,37 +2996,27 @@
         "rebake.js"
       ]
     },
-    "plugin:add": {
+    "migrate:usage": {
       "aliases": [],
-      "args": {
-        "package": {
-          "description": "Plugin entry-point specifier (package name, subpath, or relative path)",
-          "name": "package",
-          "required": true
-        }
-      },
-      "description": "Register a CLI plugin package in mj-cli-plugins.json so `mj` loads it at startup.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> @my-org/mj-plugin/plugins",
-        "<%= config.bin %> <%= command.id %> ./local-plugins/my-tool"
-      ],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj migrate` command.",
       "flags": {
         "format": {
-          "description": "Output format",
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
           "name": "format",
-          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
             "text",
-            "json"
+            "json",
+            "md"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:add",
+      "id": "migrate:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -2597,8 +3026,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "plugin",
-        "add.js"
+        "migrate",
+        "usage.js"
       ]
     },
     "querygen:export": {
@@ -2773,6 +3202,40 @@
         "generate.js"
       ]
     },
+    "querygen:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj querygen` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "querygen:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "querygen",
+        "usage.js"
+      ]
+    },
     "querygen:validate": {
       "aliases": [],
       "args": {},
@@ -2883,6 +3346,40 @@
         "index.js"
       ]
     },
+    "sql-audit:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj sql-audit` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sql-audit:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sql-audit",
+        "usage.js"
+      ]
+    },
     "sql-convert": {
       "aliases": [],
       "args": {
@@ -2968,6 +3465,40 @@
         "index.js"
       ]
     },
+    "sql-convert:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj sql-convert` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sql-convert:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sql-convert",
+        "usage.js"
+      ]
+    },
     "standards:adopt": {
       "aliases": [],
       "args": {},
@@ -3156,60 +3687,144 @@
         "list.js"
       ]
     },
-    "sync:file-reset": {
+    "standards:usage": {
       "aliases": [],
       "args": {},
-      "description": "Reset file metadata sections",
+      "description": "Show usage, flags, examples, and runtime hints for every `mj standards` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "standards:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "standards",
+        "usage.js"
+      ]
+    },
+    "test:compare": {
+      "aliases": [],
+      "args": {
+        "runId1": {
+          "description": "First test run ID to compare",
+          "name": "runId1",
+          "required": false
+        },
+        "runId2": {
+          "description": "Second test run ID to compare",
+          "name": "runId2",
+          "required": false
+        }
+      },
+      "description": "Compare test runs for regression detection",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
-        "<%= config.bin %> <%= command.id %> --sections=\"dependencies,references\"",
-        "<%= config.bin %> <%= command.id %> --all"
+        "<%= config.bin %> <%= command.id %> --latest",
+        "<%= config.bin %> <%= command.id %> <run-id-1> <run-id-2>",
+        "<%= 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": {
-        "dir": {
-          "description": "Specific entity directory to reset",
-          "name": "dir",
+        "version": {
+          "char": "v",
+          "description": "Compare runs by version",
+          "name": "version",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "sections": {
-          "description": "Comma-separated list of sections to reset (dependencies,references,related,lookup)",
-          "name": "sections",
+        "commit": {
+          "char": "c",
+          "description": "Compare runs by git commit",
+          "name": "commit",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "all": {
-          "description": "Reset all metadata sections",
-          "name": "all",
+        "diff-only": {
+          "description": "Show only differences",
+          "name": "diff-only",
           "allowNo": false,
           "type": "boolean"
         },
-        "dry-run": {
-          "description": "Show what would be reset without actually resetting",
-          "name": "dry-run",
+        "latest": {
+          "char": "l",
+          "description": "Compare the two most recent completed suite runs",
+          "name": "latest",
           "allowNo": false,
           "type": "boolean"
         },
-        "force": {
-          "description": "Skip confirmation prompts",
-          "name": "force",
-          "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: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output file path",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "verbose": {
-          "char": "v",
-          "description": "Show detailed output",
+          "description": "Show detailed information",
           "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,
       "hiddenAliases": [],
-      "id": "sync:file-reset",
+      "id": "test:compare",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3219,443 +3834,564 @@
       "relativePath": [
         "dist",
         "commands",
-        "sync",
-        "file-reset.js"
+        "test",
+        "compare.js"
       ]
     },
-    "sync:init": {
+    "test:history": {
       "aliases": [],
       "args": {},
-      "description": "Initialize a directory for metadata synchronization",
+      "description": "View test execution history",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sync:init",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "sync",
-        "init.js"
-      ]
-    },
-    "sync:pull": {
-      "aliases": [],
-      "args": {},
-      "description": "Pull metadata from database to local files",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\"",
-        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Agents\" --merge-strategy=overwrite",
-        "<%= config.bin %> <%= command.id %> --entity=\"Templates\" --dry-run --verbose"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --test=<test-id>",
+        "<%= config.bin %> <%= command.id %> --suite=<suite-id>",
+        "<%= config.bin %> <%= command.id %> --since=\"2024-01-01\"",
+        "<%= config.bin %> <%= command.id %> --limit=50"
       ],
       "flags": {
-        "format": {
-          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced)",
-          "name": "format",
-          "default": "text",
+        "test": {
+          "char": "t",
+          "description": "Filter by test ID",
+          "name": "test",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "json",
-            "md"
-          ],
           "type": "option"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed output",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-banner": {
-          "description": "Suppress the startup banner and runtime advisory",
-          "name": "no-banner",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "entity": {
-          "description": "Entity name to pull",
-          "name": "entity",
-          "required": true,
+        "recent": {
+          "char": "r",
+          "description": "Number of recent runs to show",
+          "name": "recent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "filter": {
-          "description": "Additional filter for pulling specific records",
-          "name": "filter",
+        "from": {
+          "description": "Show history from date (YYYY-MM-DD)",
+          "name": "from",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "description": "Show what would be pulled without actually pulling",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
+        "status": {
+          "char": "s",
+          "description": "Filter by status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "multi-file": {
-          "description": "Create a single file with multiple records (provide filename)",
-          "name": "multi-file",
+        "format": {
+          "char": "f",
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
           "type": "option"
         },
-        "no-validate": {
-          "description": "Skip validation before pull",
-          "name": "no-validate",
-          "allowNo": false,
-          "type": "boolean"
+        "output": {
+          "char": "o",
+          "description": "Output file path",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "update-existing": {
-          "description": "Update existing records during pull",
-          "name": "update-existing",
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed information",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "create-new": {
-          "description": "Create new files for records not found locally",
-          "name": "create-new",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:history",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "history.js"
+      ]
+    },
+    "test": {
+      "aliases": [],
+      "args": {},
+      "description": "MemberJunction Testing Framework - Execute and manage tests",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> run <test-id>",
+        "<%= config.bin %> <%= command.id %> run --name=\"Active Members Count\"",
+        "<%= config.bin %> <%= command.id %> suite <suite-id>",
+        "<%= config.bin %> <%= command.id %> list",
+        "<%= config.bin %> <%= command.id %> list --suites",
+        "<%= config.bin %> <%= command.id %> validate --all"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "index.js"
+      ]
+    },
+    "test:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List available tests, suites, and types",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --suites",
+        "<%= config.bin %> <%= command.id %> --types",
+        "<%= config.bin %> <%= command.id %> --type=agent-eval",
+        "<%= config.bin %> <%= command.id %> --tag=smoke",
+        "<%= config.bin %> <%= command.id %> --status=active --verbose"
+      ],
+      "flags": {
+        "suites": {
+          "description": "List test suites instead of tests",
+          "name": "suites",
           "allowNo": false,
           "type": "boolean"
         },
-        "backup-before-update": {
-          "description": "Create backups before updating files",
-          "name": "backup-before-update",
+        "types": {
+          "description": "List test types",
+          "name": "types",
           "allowNo": false,
           "type": "boolean"
         },
-        "merge-strategy": {
-          "description": "Merge strategy for updates",
-          "name": "merge-strategy",
-          "default": "merge",
+        "type": {
+          "char": "t",
+          "description": "Filter by test type",
+          "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "merge",
-            "overwrite",
-            "skip"
-          ],
           "type": "option"
         },
-        "backup-directory": {
-          "description": "Custom backup directory (default: .backups)",
-          "name": "backup-directory",
+        "tag": {
+          "description": "Filter by tag",
+          "name": "tag",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "preserve-fields": {
-          "description": "Comma-separated list of fields to preserve during updates",
-          "name": "preserve-fields",
+        "status": {
+          "char": "s",
+          "description": "Filter by status",
+          "name": "status",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "exclude-fields": {
-          "description": "Comma-separated list of fields to exclude from pull",
-          "name": "exclude-fields",
+        "format": {
+          "char": "f",
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
           "type": "option"
         },
-        "target-dir": {
-          "description": "Specific target directory (overrides auto-discovery)",
-          "name": "target-dir",
+        "output": {
+          "char": "o",
+          "description": "Output file path",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "incremental": {
-          "description": "Only pull records updated since last successful pull",
-          "name": "incremental",
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed information",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "since": {
-          "description": "Only pull records updated after this ISO 8601 timestamp",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sync:pull",
+      "id": "test:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "Usage": {
-        "domain": "sync",
-        "command": "sync:pull",
-        "summary": "Pull database records into local metadata files.",
-        "description": "Writes records of --entity into the matching entity directory, creating or updating files per the merge strategy.",
-        "flags": [
-          {
-            "name": "--entity",
-            "type": "string",
-            "description": "Entity name to pull (required)"
-          },
-          {
-            "name": "--filter",
-            "type": "string",
-            "description": "Extra SQL filter for which records to pull"
-          },
-          {
-            "name": "--merge-strategy",
-            "type": "merge|overwrite|skip",
-            "description": "How to reconcile existing files"
-          },
-          {
-            "name": "--dry-run",
-            "type": "boolean",
-            "description": "Report what would be pulled without writing"
-          },
-          {
-            "name": "--format",
-            "type": "text|json|md",
-            "description": "Output format (json for machine-readable result)"
-          }
-        ],
-        "examples": [
-          "mj sync pull --entity=\"MJ: AI Prompts\"",
-          "mj sync pull --entity=\"Actions\" --format=json"
-        ],
-        "runtime": {
-          "class": "variable",
-          "typicalSeconds": 15,
-          "note": "scales with number of records matched for --entity"
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "list.js"
+      ]
+    },
+    "test:run": {
+      "aliases": [],
+      "args": {
+        "testId": {
+          "description": "Test ID to execute",
+          "name": "testId",
+          "required": false
+        }
+      },
+      "description": "Execute a single test by ID or name",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> <test-id>",
+        "<%= config.bin %> <%= command.id %> --name=\"Active Members Count\"",
+        "<%= config.bin %> <%= command.id %> <test-id> --environment=staging",
+        "<%= config.bin %> <%= command.id %> <test-id> --format=json --output=results.json",
+        "<%= config.bin %> <%= command.id %> <test-id> --dry-run"
+      ],
+      "flags": {
+        "name": {
+          "char": "n",
+          "description": "Test name to execute",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "char": "e",
+          "description": "Environment context (dev, staging, prod)",
+          "name": "environment",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "char": "f",
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output file path",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Validate without executing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed execution information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "checks-module": {
+          "description": "Module specifier (package name or path) side-effect-imported before the run so its integration check bundles register on the IntegrationCheckRegistry. Durable form: mj.config.cjs `testing.checkModules` (this repo loads '@memberjunction/integration-test-suite' that way).",
+          "name": "checks-module",
+          "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 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,
+      "hiddenAliases": [],
+      "id": "test:run",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "sync",
-        "pull.js"
+        "test",
+        "run.js"
       ]
     },
-    "sync:push": {
+    "test:suite": {
       "aliases": [],
-      "args": {},
-      "description": "Push local file changes to the database",
+      "args": {
+        "suiteId": {
+          "description": "Test suite ID to execute",
+          "name": "suiteId",
+          "required": false
+        }
+      },
+      "description": "Execute a test suite",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dry-run",
-        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
-        "<%= config.bin %> <%= command.id %> --ci --format=json"
+        "<%= config.bin %> <%= command.id %> <suite-id>",
+        "<%= config.bin %> <%= command.id %> --name=\"Agent Quality Suite\"",
+        "<%= config.bin %> <%= command.id %> <suite-id> --format=json",
+        "<%= config.bin %> <%= command.id %> <suite-id> --output=suite-results.json"
       ],
       "flags": {
+        "name": {
+          "char": "n",
+          "description": "Test suite name to execute",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "format": {
-          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced)",
+          "char": "f",
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
           "name": "format",
-          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
             "text",
             "json",
-            "md"
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
           ],
           "type": "option"
         },
+        "output": {
+          "char": "o",
+          "description": "Output file path",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "verbose": {
           "char": "v",
-          "description": "Show detailed output",
+          "description": "Show detailed execution information",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         },
-        "no-banner": {
-          "description": "Suppress the startup banner and runtime advisory",
-          "name": "no-banner",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dir": {
-          "description": "Specific entity directory to push",
-          "name": "dir",
+        "delay": {
+          "char": "d",
+          "description": "Delay in milliseconds between test executions (avoids Auth0 rate limits)",
+          "name": "delay",
+          "default": 0,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "description": "Show what would be pushed without actually pushing",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "ci": {
-          "description": "CI mode - no prompts, fail on issues",
-          "name": "ci",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-validate": {
-          "description": "Skip validation before push",
-          "name": "no-validate",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "delete-db-only": {
-          "description": "Delete database-only records that reference records being deleted (prevents FK errors)",
-          "name": "delete-db-only",
+        "parallel": {
+          "char": "p",
+          "description": "Run tests in parallel with shared browser sessions",
+          "name": "parallel",
           "allowNo": false,
           "type": "boolean"
         },
-        "parallel-batch-size": {
-          "description": "Number of records to process in parallel (default: 10)",
-          "name": "parallel-batch-size",
-          "default": 10,
+        "max-parallel": {
+          "description": "Maximum number of parallel workers (default 4)",
+          "name": "max-parallel",
+          "default": 4,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "include": {
-          "description": "Only process these directories (comma-separated, supports patterns)",
-          "name": "include",
+        "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"
         },
-        "exclude": {
-          "description": "Skip these directories (comma-separated, supports patterns)",
-          "name": "exclude",
+        "checks-module": {
+          "description": "Module specifier (package name or path) side-effect-imported before the run so its integration check bundles register on the IntegrationCheckRegistry. Durable form: mj.config.cjs `testing.checkModules` (this repo loads '@memberjunction/integration-test-suite' that way).",
+          "name": "checks-module",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "incremental": {
-          "description": "Skip unchanged files using stored checksums from last push",
-          "name": "incremental",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "change-detail": {
-          "description": "Write a detailed per-record change report (primary keys + field diffs) to a file",
-          "name": "change-detail",
-          "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 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,
       "hiddenAliases": [],
-      "id": "sync:push",
+      "id": "test:suite",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "Usage": {
-        "domain": "sync",
-        "command": "sync:push",
-        "summary": "Push local metadata files to the database (upsert).",
-        "description": "Reads entity directories under --dir and creates/updates matching records. Runs validation first unless --no-validate.",
-        "flags": [
-          {
-            "name": "--dir",
-            "type": "string",
-            "description": "Entity directory to push"
-          },
-          {
-            "name": "--dry-run",
-            "type": "boolean",
-            "description": "Report what would change without writing"
-          },
-          {
-            "name": "--ci",
-            "type": "boolean",
-            "description": "No prompts; non-zero exit on error"
-          },
-          {
-            "name": "--no-validate",
-            "type": "boolean",
-            "description": "Skip pre-push validation"
-          },
-          {
-            "name": "--incremental",
-            "type": "boolean",
-            "description": "Skip unchanged files using stored checksums"
-          },
-          {
-            "name": "--format",
-            "type": "text|json|md",
-            "description": "Output format (json for machine-readable result)"
-          }
-        ],
-        "examples": [
-          "mj sync push --dir=ai-agents",
-          "mj sync push --ci --format=json"
-        ],
-        "runtime": {
-          "class": "variable",
-          "typicalSeconds": 20,
-          "note": "scales with number of records in --dir"
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "suite.js"
+      ]
+    },
+    "test:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj test` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
         }
       },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "sync",
-        "push.js"
+        "test",
+        "usage.js"
       ]
     },
-    "sync:status": {
+    "test:validate": {
       "aliases": [],
-      "args": {},
-      "description": "Show status of local files vs database",
+      "args": {
+        "testId": {
+          "description": "Test ID to validate",
+          "name": "testId",
+          "required": false
+        }
+      },
+      "description": "Validate test definitions without executing",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
-        "<%= config.bin %> <%= command.id %> --verbose"
+        "<%= 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": {
-        "dir": {
-          "description": "Specific entity directory to check status",
-          "name": "dir",
+        "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"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed field-level differences",
-          "name": "verbose",
+        "save-report": {
+          "description": "Save validation report to file",
+          "name": "save-report",
           "allowNo": false,
           "type": "boolean"
         },
-        "include": {
-          "description": "Only process these directories (comma-separated, supports patterns)",
-          "name": "include",
+        "format": {
+          "char": "f",
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
           "type": "option"
         },
-        "exclude": {
-          "description": "Skip these directories (comma-separated, supports patterns)",
-          "name": "exclude",
+        "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": "sync:status",
+      "id": "test:validate",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3665,32 +4401,96 @@
       "relativePath": [
         "dist",
         "commands",
-        "sync",
-        "status.js"
+        "test",
+        "validate.js"
       ]
     },
-    "sync:usage": {
+    "translate-sql": {
       "aliases": [],
       "args": {},
-      "description": "Show usage, flags, examples, and runtime hints for every `mj sync` command.",
+      "description": "Translate SQL fragments between database dialects (SQL Server ↔ PostgreSQL)",
+      "examples": [
+        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --dry-run",
+        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --scope queries",
+        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --sql \"SELECT TOP 10 [Name] FROM [Users]\"",
+        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --scope all --output ./reports"
+      ],
       "flags": {
-        "format": {
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
+        "from": {
+          "description": "Source SQL dialect",
+          "name": "from",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "text",
-            "json",
-            "md"
+            "sqlserver",
+            "postgresql"
           ],
           "type": "option"
+        },
+        "to": {
+          "description": "Target SQL dialect",
+          "name": "to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "sqlserver",
+            "postgresql"
+          ],
+          "type": "option"
+        },
+        "scope": {
+          "description": "What to scan for translation",
+          "name": "scope",
+          "default": "all",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "queries",
+            "views",
+            "filters",
+            "all"
+          ],
+          "type": "option"
+        },
+        "sql": {
+          "description": "Translate a single SQL fragment (inline mode)",
+          "name": "sql",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Show what would be translated without making changes",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "review": {
+          "description": "Generate review report only (no writes to database)",
+          "name": "review",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output directory for the translation report",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "description": "Re-translate even if platform variants already exist",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sync:usage",
+      "id": "translate-sql",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3700,52 +4500,31 @@
       "relativePath": [
         "dist",
         "commands",
-        "sync",
-        "usage.js"
+        "translate-sql",
+        "index.js"
       ]
     },
-    "sync:validate": {
+    "translate-sql:usage": {
       "aliases": [],
       "args": {},
-      "description": "Validate metadata files",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
-        "<%= config.bin %> <%= command.id %> --save-report",
-        "<%= config.bin %> <%= command.id %> --verbose"
-      ],
+      "description": "Show usage, flags, examples, and runtime hints for every `mj translate-sql` command.",
       "flags": {
-        "dir": {
-          "description": "Specific entity directory to validate",
-          "name": "dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed validation output",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "save-report": {
-          "description": "Save validation report as markdown file",
-          "name": "save-report",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "output": {
-          "description": "Output file path for validation report (default: validation-report.md)",
-          "name": "output",
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sync:validate",
+      "id": "translate-sql:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3755,38 +4534,50 @@
       "relativePath": [
         "dist",
         "commands",
-        "sync",
-        "validate.js"
+        "translate-sql",
+        "usage.js"
       ]
     },
-    "sync:watch": {
+    "sync:file-reset": {
       "aliases": [],
       "args": {},
-      "description": "Watch for file changes and sync automatically",
+      "description": "Reset file metadata sections",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
-        "<%= config.bin %> <%= command.id %> --debounce=1000",
-        "<%= config.bin %> <%= command.id %> --no-validate"
+        "<%= config.bin %> <%= command.id %> --sections=\"dependencies,references\"",
+        "<%= config.bin %> <%= command.id %> --all"
       ],
       "flags": {
         "dir": {
-          "description": "Specific entity directory to watch",
+          "description": "Specific entity directory to reset",
           "name": "dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "debounce": {
-          "description": "Debounce delay in milliseconds (default: 500)",
-          "name": "debounce",
+        "sections": {
+          "description": "Comma-separated list of sections to reset (dependencies,references,related,lookup)",
+          "name": "sections",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-validate": {
-          "description": "Skip validation before sync",
-          "name": "no-validate",
+        "all": {
+          "description": "Reset all metadata sections",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Show what would be reset without actually resetting",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Skip confirmation prompts",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
@@ -3800,7 +4591,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sync:watch",
+      "id": "sync:file-reset",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3811,109 +4602,68 @@
         "dist",
         "commands",
         "sync",
-        "watch.js"
+        "file-reset.js"
       ]
     },
-    "test:compare": {
-      "aliases": [],
-      "args": {
-        "runId1": {
-          "description": "First test run ID to compare",
-          "name": "runId1",
-          "required": false
-        },
-        "runId2": {
-          "description": "Second test run ID to compare",
-          "name": "runId2",
-          "required": false
-        }
-      },
-      "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 %> -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": {
-          "char": "v",
-          "description": "Compare runs by version",
-          "name": "version",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "commit": {
-          "char": "c",
-          "description": "Compare runs by git commit",
-          "name": "commit",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "diff-only": {
-          "description": "Show only differences",
-          "name": "diff-only",
-          "allowNo": false,
-          "type": "boolean"
+    "sync:init": {
+      "aliases": [],
+      "args": {},
+      "description": "Initialize a directory for metadata synchronization.\n\nPrompts at a terminal; runs unattended when piped, spawned, or in CI. To script it,\npass --setup-entity (and --entity/--dir when setting up \"other\").",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --setup-entity=no",
+          "description": "Initialize with no entity directory"
         },
-        "latest": {
-          "char": "l",
-          "description": "Compare the two most recent completed suite runs",
-          "name": "latest",
-          "allowNo": false,
-          "type": "boolean"
+        {
+          "command": "<%= config.bin %> <%= command.id %> --setup-entity=ai-prompts",
+          "description": "Initialize and set up the AI Prompts directory"
         },
-        "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"
+        {
+          "command": "<%= config.bin %> <%= command.id %> --setup-entity=other --entity=\"MJ: AI Models\" --dir=ai-models",
+          "description": "Initialize for an arbitrary entity"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "console",
+        {
+          "command": "<%= config.bin %> <%= command.id %> --no-interactive --setup-entity=no",
+          "description": "Never prompt, even at a terminal"
+        }
+      ],
+      "flags": {
+        "setup-entity": {
+          "description": "Which entity directory to set up. Use \"no\" to skip.",
+          "name": "setup-entity",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "console",
-            "json",
-            "markdown"
+            "ai-prompts",
+            "other",
+            "no"
           ],
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "Output file path",
-          "name": "output",
+        "entity": {
+          "description": "Entity name when --setup-entity=other (e.g. \"MJ: AI Models\").",
+          "name": "entity",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "description": "Show detailed information",
-          "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",
+        "dir": {
+          "description": "Directory name when --setup-entity=other. Defaults to a slug of --entity.",
+          "name": "dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "overwrite": {
+          "description": "Overwrite an existing configuration. Without this, an initialized directory is left untouched.",
+          "name": "overwrite",
+          "allowNo": true,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "test:compare",
+      "id": "sync:init",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -3923,301 +4673,427 @@
       "relativePath": [
         "dist",
         "commands",
-        "test",
-        "compare.js"
+        "sync",
+        "init.js"
       ]
     },
-    "test:history": {
+    "sync:pull": {
       "aliases": [],
       "args": {},
-      "description": "View test execution history",
+      "description": "Pull metadata from database to local files",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --test=<test-id>",
-        "<%= config.bin %> <%= command.id %> --suite=<suite-id>",
-        "<%= config.bin %> <%= command.id %> --since=\"2024-01-01\"",
-        "<%= config.bin %> <%= command.id %> --limit=50"
+        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\"",
+        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Agents\" --merge-strategy=overwrite",
+        "<%= config.bin %> <%= command.id %> --entity=\"Templates\" --dry-run --verbose"
       ],
       "flags": {
-        "test": {
-          "char": "t",
-          "description": "Filter by test ID",
-          "name": "test",
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced). Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown"
+          ],
           "type": "option"
         },
-        "recent": {
-          "char": "r",
-          "description": "Number of recent runs to show",
-          "name": "recent",
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-banner": {
+          "description": "Suppress the startup banner and runtime advisory",
+          "name": "no-banner",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Allow interactive prompts. Defaults to on at a terminal and off when piped, spawned, or in CI, so an agent never hangs on a question. Use --no-interactive to force it off.",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "entity": {
+          "description": "Entity name to pull",
+          "name": "entity",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "from": {
-          "description": "Show history from date (YYYY-MM-DD)",
-          "name": "from",
+        "filter": {
+          "description": "Additional filter for pulling specific records",
+          "name": "filter",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "status": {
-          "char": "s",
-          "description": "Filter by status",
-          "name": "status",
+        "dry-run": {
+          "description": "Show what would be pulled without actually pulling",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "multi-file": {
+          "description": "Create a single file with multiple records (provide filename)",
+          "name": "multi-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "console",
+        "no-validate": {
+          "description": "Skip validation before pull",
+          "name": "no-validate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "update-existing": {
+          "description": "Update existing records during pull",
+          "name": "update-existing",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "create-new": {
+          "description": "Create new files for records not found locally",
+          "name": "create-new",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "backup-before-update": {
+          "description": "Create backups before updating files",
+          "name": "backup-before-update",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "merge-strategy": {
+          "description": "Merge strategy for updates",
+          "name": "merge-strategy",
+          "default": "merge",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "console",
-            "json",
-            "markdown"
+            "merge",
+            "overwrite",
+            "skip"
           ],
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "Output file path",
-          "name": "output",
+        "backup-directory": {
+          "description": "Custom backup directory (default: .backups)",
+          "name": "backup-directory",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed information",
-          "name": "verbose",
+        "preserve-fields": {
+          "description": "Comma-separated list of fields to preserve during updates",
+          "name": "preserve-fields",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "exclude-fields": {
+          "description": "Comma-separated list of fields to exclude from pull",
+          "name": "exclude-fields",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "target-dir": {
+          "description": "Specific target directory (overrides auto-discovery)",
+          "name": "target-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "incremental": {
+          "description": "Only pull records updated since last successful pull",
+          "name": "incremental",
           "allowNo": false,
           "type": "boolean"
+        },
+        "since": {
+          "description": "Only pull records updated after this ISO 8601 timestamp",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "test:history",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "test",
-        "history.js"
-      ]
-    },
-    "test": {
-      "aliases": [],
-      "args": {},
-      "description": "MemberJunction Testing Framework - Execute and manage tests",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> run <test-id>",
-        "<%= config.bin %> <%= command.id %> run --name=\"Active Members Count\"",
-        "<%= config.bin %> <%= command.id %> suite <suite-id>",
-        "<%= config.bin %> <%= command.id %> list",
-        "<%= config.bin %> <%= command.id %> list --suites",
-        "<%= config.bin %> <%= command.id %> validate --all"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "test",
+      "id": "sync:pull",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "Usage": {
+        "domain": "sync",
+        "command": "sync:pull",
+        "summary": "Pull database records into local metadata files.",
+        "description": "Writes records of --entity into the matching entity directory, creating or updating files per the merge strategy.",
+        "flags": [
+          {
+            "name": "--entity",
+            "type": "string",
+            "description": "Entity name to pull (required)"
+          },
+          {
+            "name": "--filter",
+            "type": "string",
+            "description": "Extra SQL filter for which records to pull"
+          },
+          {
+            "name": "--merge-strategy",
+            "type": "merge|overwrite|skip",
+            "description": "How to reconcile existing files"
+          },
+          {
+            "name": "--dry-run",
+            "type": "boolean",
+            "description": "Report what would be pulled without writing"
+          },
+          {
+            "name": "--format",
+            "type": "text|json|md",
+            "description": "Output format (json for machine-readable result)"
+          }
+        ],
+        "examples": [
+          "mj sync pull --entity=\"MJ: AI Prompts\"",
+          "mj sync pull --entity=\"Actions\" --format=json"
+        ],
+        "runtime": {
+          "class": "variable",
+          "typicalSeconds": 15,
+          "note": "scales with number of records matched for --entity"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "test",
-        "index.js"
+        "sync",
+        "pull.js"
       ]
     },
-    "test:list": {
+    "sync:push": {
       "aliases": [],
       "args": {},
-      "description": "List available tests, suites, and types",
+      "description": "Push local file changes to the database",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --suites",
-        "<%= config.bin %> <%= command.id %> --types",
-        "<%= config.bin %> <%= command.id %> --type=agent-eval",
-        "<%= config.bin %> <%= command.id %> --tag=smoke",
-        "<%= config.bin %> <%= command.id %> --status=active --verbose"
+        "<%= config.bin %> <%= command.id %> --dry-run",
+        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
+        "<%= config.bin %> <%= command.id %> --ci --format=json"
       ],
       "flags": {
-        "suites": {
-          "description": "List test suites instead of tests",
-          "name": "suites",
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced). Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown"
+          ],
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         },
-        "types": {
-          "description": "List test types",
-          "name": "types",
+        "no-banner": {
+          "description": "Suppress the startup banner and runtime advisory",
+          "name": "no-banner",
           "allowNo": false,
           "type": "boolean"
         },
-        "type": {
-          "char": "t",
-          "description": "Filter by test type",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "interactive": {
+          "description": "Allow interactive prompts. Defaults to on at a terminal and off when piped, spawned, or in CI, so an agent never hangs on a question. Use --no-interactive to force it off.",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
         },
-        "tag": {
-          "description": "Filter by tag",
-          "name": "tag",
+        "dir": {
+          "description": "Specific entity directory to push",
+          "name": "dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "status": {
-          "char": "s",
-          "description": "Filter by status",
-          "name": "status",
+        "dry-run": {
+          "description": "Show what would be pushed without actually pushing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ci": {
+          "description": "CI mode - no prompts, fail on issues",
+          "name": "ci",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-validate": {
+          "description": "Skip validation before push",
+          "name": "no-validate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "delete-db-only": {
+          "description": "Delete database-only records that reference records being deleted (prevents FK errors)",
+          "name": "delete-db-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "parallel-batch-size": {
+          "description": "Number of records to process in parallel (default: 10)",
+          "name": "parallel-batch-size",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "console",
+        "include": {
+          "description": "Only process these directories (comma-separated, supports patterns)",
+          "name": "include",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "console",
-            "json",
-            "markdown"
-          ],
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "Output file path",
-          "name": "output",
+        "exclude": {
+          "description": "Skip these directories (comma-separated, supports patterns)",
+          "name": "exclude",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed information",
-          "name": "verbose",
+        "incremental": {
+          "description": "Skip unchanged files using stored checksums from last push",
+          "name": "incremental",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "change-detail": {
+          "description": "Write a detailed per-record change report (primary keys + field diffs) to a file",
+          "name": "change-detail",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "test:list",
+      "id": "sync:push",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "Usage": {
+        "domain": "sync",
+        "command": "sync:push",
+        "summary": "Push local metadata files to the database (upsert).",
+        "description": "Reads entity directories under --dir and creates/updates matching records. Runs validation first unless --no-validate.",
+        "flags": [
+          {
+            "name": "--dir",
+            "type": "string",
+            "description": "Entity directory to push"
+          },
+          {
+            "name": "--dry-run",
+            "type": "boolean",
+            "description": "Report what would change without writing"
+          },
+          {
+            "name": "--ci",
+            "type": "boolean",
+            "description": "No prompts; non-zero exit on error"
+          },
+          {
+            "name": "--no-validate",
+            "type": "boolean",
+            "description": "Skip pre-push validation"
+          },
+          {
+            "name": "--incremental",
+            "type": "boolean",
+            "description": "Skip unchanged files using stored checksums"
+          },
+          {
+            "name": "--format",
+            "type": "text|json|md",
+            "description": "Output format (json for machine-readable result)"
+          }
+        ],
+        "examples": [
+          "mj sync push --dir=ai-agents",
+          "mj sync push --ci --format=json"
+        ],
+        "runtime": {
+          "class": "variable",
+          "typicalSeconds": 20,
+          "note": "scales with number of records in --dir"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "test",
-        "list.js"
+        "sync",
+        "push.js"
       ]
     },
-    "test:run": {
+    "sync:status": {
       "aliases": [],
-      "args": {
-        "testId": {
-          "description": "Test ID to execute",
-          "name": "testId",
-          "required": false
-        }
-      },
-      "description": "Execute a single test by ID or name",
+      "args": {},
+      "description": "Show status of local files vs database",
       "examples": [
-        "<%= config.bin %> <%= command.id %> <test-id>",
-        "<%= config.bin %> <%= command.id %> --name=\"Active Members Count\"",
-        "<%= config.bin %> <%= command.id %> <test-id> --environment=staging",
-        "<%= config.bin %> <%= command.id %> <test-id> --format=json --output=results.json",
-        "<%= config.bin %> <%= command.id %> <test-id> --dry-run"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
+        "<%= config.bin %> <%= command.id %> --verbose"
       ],
       "flags": {
-        "name": {
-          "char": "n",
-          "description": "Test name to execute",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "environment": {
-          "char": "e",
-          "description": "Environment context (dev, staging, prod)",
-          "name": "environment",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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",
+        "dir": {
+          "description": "Specific entity directory to check status",
+          "name": "dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "description": "Validate without executing",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "verbose": {
           "char": "v",
-          "description": "Show detailed execution information",
+          "description": "Show detailed field-level differences",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         },
-        "checks-module": {
-          "description": "Module specifier (package name or path) side-effect-imported before the run so its integration check bundles register on the IntegrationCheckRegistry. Durable form: mj.config.cjs `testing.checkModules` (this repo loads '@memberjunction/integration-test-suite' that way).",
-          "name": "checks-module",
+        "include": {
+          "description": "Only process these directories (comma-separated, supports patterns)",
+          "name": "include",
           "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 test runs — used by non-MJ adopters to plug app-specific oracle types without modifying TestingFramework.",
-          "name": "oracles-module",
+        "exclude": {
+          "description": "Skip these directories (comma-separated, supports patterns)",
+          "name": "exclude",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4225,7 +5101,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "test:run",
+      "id": "sync:status",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4235,113 +5111,31 @@
       "relativePath": [
         "dist",
         "commands",
-        "test",
-        "run.js"
+        "sync",
+        "status.js"
       ]
     },
-    "test:suite": {
+    "sync:usage": {
       "aliases": [],
-      "args": {
-        "suiteId": {
-          "description": "Test suite ID to execute",
-          "name": "suiteId",
-          "required": false
-        }
-      },
-      "description": "Execute a test suite",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> <suite-id>",
-        "<%= config.bin %> <%= command.id %> --name=\"Agent Quality Suite\"",
-        "<%= config.bin %> <%= command.id %> <suite-id> --format=json",
-        "<%= config.bin %> <%= command.id %> <suite-id> --output=suite-results.json"
-      ],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj sync` command.",
       "flags": {
-        "name": {
-          "char": "n",
-          "description": "Test suite name to execute",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
           "name": "format",
-          "default": "console",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "console",
+            "text",
             "json",
-            "markdown"
+            "md"
           ],
           "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",
-          "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"
-        },
-        "checks-module": {
-          "description": "Module specifier (package name or path) side-effect-imported before the run so its integration check bundles register on the IntegrationCheckRegistry. Durable form: mj.config.cjs `testing.checkModules` (this repo loads '@memberjunction/integration-test-suite' that way).",
-          "name": "checks-module",
-          "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,
       "hiddenAliases": [],
-      "id": "test:suite",
+      "id": "sync:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4351,82 +5145,52 @@
       "relativePath": [
         "dist",
         "commands",
-        "test",
-        "suite.js"
+        "sync",
+        "usage.js"
       ]
     },
-    "test:validate": {
+    "sync:validate": {
       "aliases": [],
-      "args": {
-        "testId": {
-          "description": "Test ID to validate",
-          "name": "testId",
-          "required": false
-        }
-      },
-      "description": "Validate test definitions without executing",
+      "args": {},
+      "description": "Validate metadata files",
       "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"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
+        "<%= config.bin %> <%= command.id %> --save-report",
+        "<%= config.bin %> <%= command.id %> --verbose"
       ],
       "flags": {
-        "all": {
-          "char": "a",
-          "description": "Validate all tests",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "type": {
-          "char": "t",
-          "description": "Validate tests by type",
-          "name": "type",
+        "dir": {
+          "description": "Specific entity directory to validate",
+          "name": "dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed validation output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "save-report": {
-          "description": "Save validation report to file",
+          "description": "Save validation report as markdown 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",
+          "description": "Output file path for validation report (default: validation-report.md)",
           "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",
+      "id": "sync:validate",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4436,96 +5200,52 @@
       "relativePath": [
         "dist",
         "commands",
-        "test",
+        "sync",
         "validate.js"
       ]
     },
-    "translate-sql": {
+    "sync:watch": {
       "aliases": [],
       "args": {},
-      "description": "Translate SQL fragments between database dialects (SQL Server ↔ PostgreSQL)",
+      "description": "Watch for file changes and sync automatically",
       "examples": [
-        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --dry-run",
-        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --scope queries",
-        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --sql \"SELECT TOP 10 [Name] FROM [Users]\"",
-        "<%= config.bin %> translate-sql --from sqlserver --to postgresql --scope all --output ./reports"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
+        "<%= config.bin %> <%= command.id %> --debounce=1000",
+        "<%= config.bin %> <%= command.id %> --no-validate"
       ],
       "flags": {
-        "from": {
-          "description": "Source SQL dialect",
-          "name": "from",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "sqlserver",
-            "postgresql"
-          ],
-          "type": "option"
-        },
-        "to": {
-          "description": "Target SQL dialect",
-          "name": "to",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "sqlserver",
-            "postgresql"
-          ],
-          "type": "option"
-        },
-        "scope": {
-          "description": "What to scan for translation",
-          "name": "scope",
-          "default": "all",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "queries",
-            "views",
-            "filters",
-            "all"
-          ],
-          "type": "option"
-        },
-        "sql": {
-          "description": "Translate a single SQL fragment (inline mode)",
-          "name": "sql",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dry-run": {
-          "description": "Show what would be translated without making changes",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "review": {
-          "description": "Generate review report only (no writes to database)",
-          "name": "review",
-          "allowNo": false,
-          "type": "boolean"
+        "dir": {
+          "description": "Specific entity directory to watch",
+          "name": "dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "Output directory for the translation report",
-          "name": "output",
+        "debounce": {
+          "description": "Debounce delay in milliseconds (default: 500)",
+          "name": "debounce",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "description": "Re-translate even if platform variants already exist",
-          "name": "force",
+        "no-validate": {
+          "description": "Skip validation before sync",
+          "name": "no-validate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "translate-sql",
+      "id": "sync:watch",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4535,8 +5255,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "translate-sql",
-        "index.js"
+        "sync",
+        "watch.js"
       ]
     },
     "update:claude": {
@@ -4677,19 +5397,70 @@
         "claude.js"
       ]
     },
-    "ai:agents:list": {
+    "update:usage": {
       "aliases": [],
       "args": {},
-      "description": "List available AI agents",
+      "description": "Show usage, flags, examples, and runtime hints for every `mj update` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "update:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "update",
+        "usage.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": {
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
         "output": {
           "char": "o",
-          "description": "Output format",
+          "description": "Output format (legacy alias for --format in the 'mj ai' family; elsewhere -o is an output FILE path). Prefer --format.",
           "name": "output",
           "default": "compact",
           "hasDynamicHelp": false,
@@ -4704,7 +5475,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:list",
+      "id": "ai:actions:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4715,53 +5486,64 @@
         "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"
         },
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
         "output": {
           "char": "o",
-          "description": "Output format",
+          "description": "Output format (legacy alias for --format in the 'mj ai' family; elsewhere -o is an output FILE path). Prefer --format.",
           "name": "output",
           "default": "compact",
           "hasDynamicHelp": false,
@@ -4791,7 +5573,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:run",
+      "id": "ai:actions:run",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4802,7 +5584,7 @@
         "dist",
         "commands",
         "ai",
-        "agents",
+        "actions",
         "run.js"
       ]
     },
@@ -4827,9 +5609,26 @@
         "<%= config.bin %> <%= command.id %> abc-123-def-456 --export full --file report.json"
       ],
       "flags": {
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
         "output": {
           "char": "o",
-          "description": "Output format",
+          "description": "Output format (legacy alias for --format in the 'mj ai' family; elsewhere -o is an output FILE path). Prefer --format.",
           "name": "output",
           "default": "compact",
           "hasDynamicHelp": false,
@@ -5022,19 +5821,36 @@
         "index.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",
         "<%= config.bin %> <%= command.id %> --output=json"
       ],
       "flags": {
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
         "output": {
           "char": "o",
-          "description": "Output format",
+          "description": "Output format (legacy alias for --format in the 'mj ai' family; elsewhere -o is an output FILE path). Prefer --format.",
           "name": "output",
           "default": "compact",
           "hasDynamicHelp": false,
@@ -5049,7 +5865,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:actions:list",
+      "id": "ai:agents:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -5060,47 +5876,70 @@
         "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"
         },
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
         "output": {
           "char": "o",
-          "description": "Output format",
+          "description": "Output format (legacy alias for --format in the 'mj ai' family; elsewhere -o is an output FILE path). Prefer --format.",
           "name": "output",
           "default": "compact",
           "hasDynamicHelp": false,
@@ -5130,7 +5969,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:actions:run",
+      "id": "ai:agents:run",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -5141,7 +5980,7 @@
         "dist",
         "commands",
         "ai",
-        "actions",
+        "agents",
         "run.js"
       ]
     },
@@ -5237,9 +6076,26 @@
           "multiple": false,
           "type": "option"
         },
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
+          ],
+          "type": "option"
+        },
         "output": {
           "char": "o",
-          "description": "Output format",
+          "description": "Output format (legacy alias for --format in the 'mj ai' family; elsewhere -o is an output FILE path). Prefer --format.",
           "name": "output",
           "default": "compact",
           "hasDynamicHelp": false,
@@ -5544,15 +6400,19 @@
         },
         "format": {
           "char": "f",
-          "description": "Output format.",
+          "description": "Output format: text (human), json (machine-readable), md (Markdown). Defaults to human output on a terminal and json when stdout is piped. Legacy spellings (console/markdown/compact/table) are accepted.",
           "name": "format",
-          "default": "console",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "console",
+            "text",
             "json",
-            "markdown"
+            "md",
+            "human",
+            "console",
+            "markdown",
+            "compact",
+            "table"
           ],
           "type": "option"
         },
@@ -5927,5 +6787,5 @@
       ]
     }
   },
-  "version": "6.1.0-edge.4"
+  "version": "6.1.0-edge.5"
 }