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

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,46 +423,211 @@
         "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.",
+      "description": "Show usage, flags, examples, and runtime hints for every `mj app` 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": "app:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "usage.js"
+      ]
+    },
+    "bump": {
+      "aliases": [],
+      "args": {},
+      "description": "Bumps MemberJunction dependency versions",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --apply --limit 50"
+        {
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "Bump all @memberjunction/* dependencies in the current directory's package.json to the CLI version"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -rdv",
+          "description": "Preview all recursive packages bumps without writing any changes."
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -rqt v2.10.0 | xargs -n1 -I{} npm install --prefix {}",
+          "description": "Recursively bump all @memberjunction/* dependencies in all packages to version v2.10.0 and output only the paths containing the updated package.json files. Pipe the output to xargs to run npm install in each directory and update the package-lock.json files as well."
+        }
       ],
       "flags": {
-        "conversation-id": {
-          "description": "Scope to artifacts attached to the given conversation.",
-          "name": "conversation-id",
+        "verbose": {
+          "char": "v",
+          "description": "Enable additional logging",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "recursive": {
+          "char": "r",
+          "description": "Bump version in current directory and all subdirectories",
+          "name": "recursive",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Version tag to bump target for bump (e.g. v2.10.0), defaults to the CLI version",
+          "name": "tag",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "since": {
-          "description": "Scope to artifacts created on/after this ISO date.",
-          "name": "since",
+        "quiet": {
+          "char": "q",
+          "description": "Only output paths for updated packages",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry": {
+          "char": "d",
+          "description": "Dry run, do not write changes to package.json files",
+          "name": "dry",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "bump",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "bump",
+        "index.js"
+      ]
+    },
+    "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": {},
+      "description": "Create a self-contained MemberJunction distribution zip for offline/air-gapped installs",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --tag v5.38.0 --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --source . --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --tag v5.38.0 --with-migrations --out ./mj-install.zip",
+        "<%= config.bin %> <%= command.id %> --with-migrations --db-platform postgresql --out ./mj-install.zip"
+      ],
+      "flags": {
+        "out": {
+          "char": "o",
+          "description": "Output zip path",
+          "name": "out",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "Maximum number of rows to inspect.",
-          "name": "limit",
-          "default": 100,
+        "tag": {
+          "char": "t",
+          "description": "Release tag to bundle (e.g. v5.38.0). Defaults to the latest branch tip.",
+          "name": "tag",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "apply": {
-          "description": "Write changes. Without this flag, this command only reports what it would do.",
-          "name": "apply",
+        "source": {
+          "description": "Bundle from a local working-tree directory instead of fetching from the repo",
+          "name": "source",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "with-migrations": {
+          "description": "Include the migration tree(s) so an air-gapped \"mj migrate\" can run offline. Ships both SQL Server and PostgreSQL trees by default.",
+          "name": "with-migrations",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "db-platform": {
+          "dependsOn": [
+            "with-migrations"
+          ],
+          "description": "With --with-migrations, ship only this platform's migration tree instead of both",
+          "name": "db-platform",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "sqlserver",
+            "postgresql"
+          ],
+          "type": "option"
+        },
+        "no-claude-pack": {
+          "description": "Exclude the Claude Code pack (CLAUDE.md + .claude/) from the bundle. By default the pack is included so air-gapped installs get the same out-of-the-box Claude experience as online installs.",
+          "name": "no-claude-pack",
           "allowNo": false,
           "type": "boolean"
         },
         "verbose": {
           "char": "v",
-          "description": "Print every candidate row, not just the summary.",
+          "description": "Show detailed output",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -437,7 +635,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "artifacts:reclassify",
+      "id": "bundle",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -447,8 +645,108 @@
       "relativePath": [
         "dist",
         "commands",
-        "artifacts",
-        "reclassify.js"
+        "bundle",
+        "index.js"
+      ]
+    },
+    "bundle:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj bundle` 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": "bundle:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "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"
       ]
     },
     "baseline:build": {
@@ -789,65 +1087,27 @@
         "roundtrip.js"
       ]
     },
-    "bump": {
+    "baseline:usage": {
       "aliases": [],
       "args": {},
-      "description": "Bumps MemberJunction dependency versions",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Bump all @memberjunction/* dependencies in the current directory's package.json to the CLI version"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -rdv",
-          "description": "Preview all recursive packages bumps without writing any changes."
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -rqt v2.10.0 | xargs -n1 -I{} npm install --prefix {}",
-          "description": "Recursively bump all @memberjunction/* dependencies in all packages to version v2.10.0 and output only the paths containing the updated package.json files. Pipe the output to xargs to run npm install in each directory and update the package-lock.json files as well."
-        }
-      ],
+      "description": "Show usage, flags, examples, and runtime hints for every `mj baseline` command.",
       "flags": {
-        "verbose": {
-          "char": "v",
-          "description": "Enable additional logging",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "recursive": {
-          "char": "r",
-          "description": "Bump version in current directory and all subdirectories",
-          "name": "recursive",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Version tag to bump target for bump (e.g. v2.10.0), defaults to the CLI version",
-          "name": "tag",
+        "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"
-        },
-        "quiet": {
-          "char": "q",
-          "description": "Only output paths for updated packages",
-          "name": "quiet",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dry": {
-          "char": "d",
-          "description": "Dry run, do not write changes to package.json files",
-          "name": "dry",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "bump",
+      "id": "baseline:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -857,75 +1117,50 @@
       "relativePath": [
         "dist",
         "commands",
-        "bump",
-        "index.js"
+        "baseline",
+        "usage.js"
       ]
     },
-    "bundle": {
+    "artifacts:reclassify": {
       "aliases": [],
       "args": {},
-      "description": "Create a self-contained MemberJunction distribution zip for offline/air-gapped installs",
+      "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 %> --out ./mj-install.zip",
-        "<%= config.bin %> <%= command.id %> --tag v5.38.0 --out ./mj-install.zip",
-        "<%= config.bin %> <%= command.id %> --source . --out ./mj-install.zip",
-        "<%= config.bin %> <%= command.id %> --tag v5.38.0 --with-migrations --out ./mj-install.zip",
-        "<%= config.bin %> <%= command.id %> --with-migrations --db-platform postgresql --out ./mj-install.zip"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --apply --limit 50"
       ],
       "flags": {
-        "out": {
-          "char": "o",
-          "description": "Output zip path",
-          "name": "out",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Release tag to bundle (e.g. v5.38.0). Defaults to the latest branch tip.",
-          "name": "tag",
+        "conversation-id": {
+          "description": "Scope to artifacts attached to the given conversation.",
+          "name": "conversation-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "source": {
-          "description": "Bundle from a local working-tree directory instead of fetching from the repo",
-          "name": "source",
+        "since": {
+          "description": "Scope to artifacts created on/after this ISO date.",
+          "name": "since",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "with-migrations": {
-          "description": "Include the migration tree(s) so an air-gapped \"mj migrate\" can run offline. Ships both SQL Server and PostgreSQL trees by default.",
-          "name": "with-migrations",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "db-platform": {
-          "dependsOn": [
-            "with-migrations"
-          ],
-          "description": "With --with-migrations, ship only this platform's migration tree instead of both",
-          "name": "db-platform",
+        "limit": {
+          "description": "Maximum number of rows to inspect.",
+          "name": "limit",
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "sqlserver",
-            "postgresql"
-          ],
           "type": "option"
         },
-        "no-claude-pack": {
-          "description": "Exclude the Claude Code pack (CLAUDE.md + .claude/) from the bundle. By default the pack is included so air-gapped installs get the same out-of-the-box Claude experience as online installs.",
-          "name": "no-claude-pack",
+        "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": "Show detailed output",
+          "description": "Print every candidate row, not just the summary.",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -933,7 +1168,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "bundle",
+      "id": "artifacts:reclassify",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -943,29 +1178,31 @@
       "relativePath": [
         "dist",
         "commands",
-        "bundle",
-        "index.js"
+        "artifacts",
+        "reclassify.js"
       ]
     },
-    "clean": {
+    "artifacts: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 artifacts` 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": "artifacts:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -975,8 +1212,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "clean",
-        "index.js"
+        "artifacts",
+        "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,18 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "no-app-packages": {
+          "description": "Do not load installed Open App server packages (or the host's generated packages) for this run, so records are written with the generic BaseEntity — no custom Save() logic or lifecycle hooks.",
+          "name": "no-app-packages",
+          "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",
@@ -1266,6 +1517,25 @@
           "name": "force-advanced-gen",
           "allowNo": false,
           "type": "boolean"
+        },
+        "no-ai": {
+          "description": "Disable AI-driven advanced generation (descriptions, categories, search ranking). Overrides config and credential checks. Can also be set with MJ_CODEGEN_NO_AI=1.",
+          "name": "no-ai",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sql-output-dir": {
+          "description": "Directory for CodeGen_Run_*.sql (EntityField INSERTs and other metadata SQL). Open Apps default to ./migrations/codegen. Do not point this at MJ/migrations/v*.",
+          "name": "sql-output-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skip-commands": {
+          "description": "Skip running BEFORE and AFTER shell commands configured in mj.config. Can also be set with MJ_CODEGEN_SKIP_COMMANDS=1.",
+          "name": "skip-commands",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1297,6 +1567,21 @@
             "type": "boolean",
             "description": "Re-run advanced generation for all entities"
           },
+          {
+            "name": "--no-ai",
+            "type": "boolean",
+            "description": "Disable AI-driven advanced generation (same as MJ_CODEGEN_NO_AI=1)"
+          },
+          {
+            "name": "--skip-commands",
+            "type": "boolean",
+            "description": "Skip running BEFORE/AFTER commands (same as MJ_CODEGEN_SKIP_COMMANDS=1)"
+          },
+          {
+            "name": "--sql-output-dir",
+            "type": "string",
+            "description": "Directory for CodeGen_Run metadata SQL (Open Apps: ./migrations/codegen)"
+          },
           {
             "name": "--format",
             "type": "text|json|md",
@@ -1306,6 +1591,7 @@
         "examples": [
           "mj codegen",
           "mj codegen --skipdb",
+          "mj codegen --skip-commands",
           "mj codegen --format=json"
         ],
         "runtime": {
@@ -1454,9 +1740,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 +2205,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 +2267,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 +2352,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 +2620,40 @@
         "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"
+      ]
+    },
     "migrate:convert": {
       "aliases": [],
       "args": {},
@@ -2311,6 +2697,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 +2921,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,6 +2959,40 @@
         "rebake.js"
       ]
     },
+    "migrate:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj migrate` 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": "migrate:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrate",
+        "usage.js"
+      ]
+    },
     "plugin:add": {
       "aliases": [],
       "args": {
@@ -2573,21 +3009,55 @@
       ],
       "flags": {
         "format": {
-          "description": "Output 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",
-          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
             "text",
-            "json"
+            "json",
+            "md"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "plugin:add",
+      "id": "plugin:usage",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -2598,7 +3068,7 @@
         "dist",
         "commands",
         "plugin",
-        "add.js"
+        "usage.js"
       ]
     },
     "querygen:export": {
@@ -2773,6 +3243,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 +3387,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 +3506,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,6 +3728,40 @@
         "list.js"
       ]
     },
+    "standards:usage": {
+      "aliases": [],
+      "args": {},
+      "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"
+      ]
+    },
     "sync:file-reset": {
       "aliases": [],
       "args": {},
@@ -3226,11 +3832,59 @@
     "sync:init": {
       "aliases": [],
       "args": {},
-      "description": "Initialize a directory for metadata synchronization",
+      "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": [
-        "<%= config.bin %> <%= command.id %>"
+        {
+          "command": "<%= config.bin %> <%= command.id %> --setup-entity=no",
+          "description": "Initialize with no entity directory"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --setup-entity=ai-prompts",
+          "description": "Initialize and set up the AI Prompts directory"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --setup-entity=other --entity=\"MJ: AI Models\" --dir=ai-models",
+          "description": "Initialize for an arbitrary entity"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --no-interactive --setup-entity=no",
+          "description": "Never prompt, even at a terminal"
+        }
       ],
-      "flags": {},
+      "flags": {
+        "setup-entity": {
+          "description": "Which entity directory to set up. Use \"no\" to skip.",
+          "name": "setup-entity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ai-prompts",
+            "other",
+            "no"
+          ],
+          "type": "option"
+        },
+        "entity": {
+          "description": "Entity name when --setup-entity=other (e.g. \"MJ: AI Models\").",
+          "name": "entity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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": "sync:init",
@@ -3258,15 +3912,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"
         },
@@ -3283,6 +3939,18 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "no-app-packages": {
+          "description": "Do not load installed Open App server packages (or the host's generated packages) for this run, so records are written with the generic BaseEntity — no custom Save() logic or lifecycle hooks.",
+          "name": "no-app-packages",
+          "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",
@@ -3460,15 +4128,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"
         },
@@ -3485,6 +4155,18 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "no-app-packages": {
+          "description": "Do not load installed Open App server packages (or the host's generated packages) for this run, so records are written with the generic BaseEntity — no custom Save() logic or lifecycle hooks.",
+          "name": "no-app-packages",
+          "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"
+        },
         "dir": {
           "description": "Specific entity directory to push",
           "name": "dir",
@@ -3517,7 +4199,7 @@
           "type": "boolean"
         },
         "parallel-batch-size": {
-          "description": "Number of records to process in parallel (default: 10)",
+          "description": "JSON-root graphs to process in parallel (default: 10, not 1)",
           "name": "parallel-batch-size",
           "default": 10,
           "hasDynamicHelp": false,
@@ -3675,9 +4357,8 @@
       "description": "Show usage, flags, examples, and runtime hints for every `mj sync` 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": [
@@ -3877,15 +4558,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"
         },
@@ -3972,15 +4657,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"
         },
@@ -4095,15 +4784,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"
         },
@@ -4175,15 +4868,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"
         },
@@ -4266,15 +4963,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"
         },
@@ -4355,6 +5056,40 @@
         "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",
+        "test",
+        "usage.js"
+      ]
+    },
     "test:validate": {
       "aliases": [],
       "args": {
@@ -4396,15 +5131,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"
         },
@@ -4539,6 +5278,40 @@
         "index.js"
       ]
     },
+    "translate-sql:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj translate-sql` 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": "translate-sql:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "translate-sql",
+        "usage.js"
+      ]
+    },
     "update:claude": {
       "aliases": [],
       "args": {},
@@ -4677,19 +5450,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 +5528,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:list",
+      "id": "ai:actions:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4715,53 +5539,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 +5626,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:agents:run",
+      "id": "ai:actions:run",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -4802,7 +5637,7 @@
         "dist",
         "commands",
         "ai",
-        "agents",
+        "actions",
         "run.js"
       ]
     },
@@ -4827,9 +5662,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 +5874,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 +5918,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:actions:list",
+      "id": "ai:agents:list",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -5060,47 +5929,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 +6022,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ai:actions:run",
+      "id": "ai:agents:run",
       "pluginAlias": "@memberjunction/cli",
       "pluginName": "@memberjunction/cli",
       "pluginType": "core",
@@ -5141,7 +6033,7 @@
         "dist",
         "commands",
         "ai",
-        "actions",
+        "agents",
         "run.js"
       ]
     },
@@ -5237,9 +6129,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 +6453,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 +6840,5 @@
       ]
     }
   },
-  "version": "6.1.0-edge.4"
+  "version": "6.1.0-edge.6"
 }