@memberjunction/cli 5.41.0 → 5.42.0

package/oclif.manifest.json

@@ -1,5 +1,43 @@
 {
   "commands": {
+    "usage": {
+      "aliases": [],
+      "args": {},
+      "description": "List mj command domains (AI-agent-friendly, tier-1 progressive disclosure). Then run `mj <domain> usage`.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --format=json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "usage.js"
+      ]
+    },
     "ai": {
       "aliases": [],
       "args": {},
@@ -338,6 +376,67 @@
         "upgrade.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"
+      ]
+    },
     "baseline:build": {
       "aliases": [],
       "args": {},
@@ -676,67 +775,6 @@
         "roundtrip.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"
-      ]
-    },
     "bump": {
       "aliases": [],
       "args": {},
@@ -865,6 +903,12 @@
           ],
           "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": "Show detailed output",
@@ -1149,7 +1193,7 @@
     "codegen": {
       "aliases": [],
       "args": {},
-      "description": "Run the full MemberJunction code generation pipeline.\n\nAnalyzes your SQL Server database schema, updates MemberJunction metadata, and\ngenerates synchronized code across the entire stack:\n\n  - SQL views, stored procedures, indexes, and permissions\n  - TypeScript entity classes with Zod validation schemas\n  - Angular form components with AI-driven layouts\n  - GraphQL resolvers and type definitions\n  - Action subclasses and DB schema JSON\n\nConfiguration is loaded from mj.config.cjs in the current directory (or parent\ndirectories). Database connection can also be set via environment variables:\nDB_HOST, DB_DATABASE, CODEGEN_DB_USERNAME, CODEGEN_DB_PASSWORD.\n\nUse --skipdb to skip all database operations (metadata sync, SQL object\ngeneration) and only regenerate TypeScript, Angular, and GraphQL output from\nexisting metadata.\n\nUse --skipfiles to skip all file-generation operations (TypeScript entities,\nAngular components, GraphQL resolvers, action subclasses, DB schema JSON) and\nonly run database-side operations (metadata sync, SQL object generation,\npermissions, custom SQL scripts).\n\n--skipdb and --skipfiles are independent and can be combined in any mix.\n\nUse --force-advanced-gen to bypass Pass 2 entity scoping and re-run the LLM-driven\nadvanced generation (smart fields, form layout) for ALL entities. Useful when AI\nprompts have changed and you want unchanged entities re-evaluated.",
+      "description": "Run the full MemberJunction code generation pipeline.\n\nAnalyzes your database schema, updates MemberJunction metadata, and generates\nsynchronized code across the stack: SQL objects, TypeScript entities, Angular\nforms, GraphQL resolvers, Action subclasses, and DB schema JSON.\n\nUse --skipdb to regenerate code from existing metadata only; --skipfiles to run\ndatabase-side operations only. --force-advanced-gen re-runs the LLM-driven\nadvanced generation for ALL entities (bypasses changed-entity scoping).",
       "examples": [
         {
           "command": "<%= config.bin %> <%= command.id %>",
@@ -1160,29 +1204,51 @@
           "description": "Regenerate code files without touching the database"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --skipfiles",
-          "description": "Run database-side operations only, without regenerating any code files"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --force-advanced-gen",
-          "description": "Re-run advanced generation for all entities (bypasses changed-entity scoping)"
+          "command": "<%= config.bin %> <%= command.id %> --format=json",
+          "description": "Emit a machine-readable result for an agent"
         }
       ],
       "flags": {
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced)",
+          "name": "format",
+          "default": "text",
+          "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"
+        },
         "skipdb": {
-          "description": "Skip database operations (metadata sync, SQL generation). Only regenerate TypeScript entities, Angular components, and GraphQL resolvers from existing metadata.",
+          "description": "Skip database operations. Only regenerate TypeScript entities, Angular components, and GraphQL resolvers from existing metadata.",
           "name": "skipdb",
           "allowNo": false,
           "type": "boolean"
         },
         "skipfiles": {
-          "description": "Skip file-generation operations (TypeScript entities, Angular components, GraphQL resolvers, action subclasses, DB schema JSON). Only run database-side operations.",
+          "description": "Skip file-generation operations. Only run database-side operations (metadata sync, SQL object generation).",
           "name": "skipfiles",
           "allowNo": false,
           "type": "boolean"
         },
         "force-advanced-gen": {
-          "description": "Bypass entity scoping in Pass 2 and force advanced generation to re-run for all entities. Used when AI prompts have changed and unchanged entities should be re-evaluated.",
+          "description": "Bypass entity scoping in Pass 2 and force advanced generation to re-run for all entities.",
           "name": "force-advanced-gen",
           "allowNo": false,
           "type": "boolean"
@@ -1196,6 +1262,44 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "Usage": {
+        "domain": "codegen",
+        "command": "codegen",
+        "summary": "Regenerate entities, SQL, and Angular forms from the database schema.",
+        "description": "Runs the full CodeGen pipeline. Scales with entity count — a full run is far slower than a single-entity change. Use --skipdb/--skipfiles to run only one half.",
+        "flags": [
+          {
+            "name": "--skipdb",
+            "type": "boolean",
+            "description": "Regenerate code from existing metadata only (no DB operations)"
+          },
+          {
+            "name": "--skipfiles",
+            "type": "boolean",
+            "description": "Run DB-side operations only (no code files)"
+          },
+          {
+            "name": "--force-advanced-gen",
+            "type": "boolean",
+            "description": "Re-run advanced generation for all entities"
+          },
+          {
+            "name": "--format",
+            "type": "text|json|md",
+            "description": "Output format (json for machine-readable result)"
+          }
+        ],
+        "examples": [
+          "mj codegen",
+          "mj codegen --skipdb",
+          "mj codegen --format=json"
+        ],
+        "runtime": {
+          "class": "slow",
+          "typicalSeconds": 45,
+          "note": "scales with entity count; full run far slower than a single-entity change"
+        }
+      },
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1324,6 +1428,41 @@
         "manifest.js"
       ]
     },
+    "codegen:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for `mj codegen`.",
+      "flags": {
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "codegen:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "codegen",
+        "usage.js"
+      ]
+    },
     "dbdoc:analyze": {
       "aliases": [],
       "args": {},
@@ -1818,88 +1957,201 @@
         "index.js"
       ]
     },
-    "install": {
+    "install:claude": {
       "aliases": [],
       "args": {},
-      "description": "Install MemberJunction from a GitHub release",
+      "description": "Install or refresh the Claude Code pack in the current directory.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> -t v4.3.0",
-        "<%= config.bin %> <%= command.id %> --dry-run",
-        "<%= config.bin %> <%= command.id %> --yes"
+        "<%= config.bin %> install:claude",
+        "<%= config.bin %> install:claude --dry-run",
+        "<%= config.bin %> install:claude --from ./local-pack",
+        "<%= config.bin %> install:claude --json"
       ],
       "flags": {
-        "tag": {
-          "char": "t",
-          "description": "Release tag to install (e.g. v4.3.0). If omitted, shows a version picker.",
-          "name": "tag",
+        "dir": {
+          "description": "Target directory for the install",
+          "name": "dir",
+          "default": ".",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dir": {
-          "description": "Target directory for the installation",
-          "name": "dir",
-          "default": ".",
+        "major": {
+          "description": "Force a specific MJ major (default: detected from package.json)",
+          "name": "major",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config": {
-          "char": "c",
-          "description": "Path to JSON config file with install settings (database, auth, ports, etc.)",
-          "name": "config",
+        "ref": {
+          "description": "Git ref to fetch from (branch or tag). Default: main.",
+          "name": "ref",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "legacy": {
-          "description": "Use the legacy interactive installer (ZIP-only distribution)",
-          "hidden": true,
-          "name": "legacy",
+        "from": {
+          "description": "Use a local pack source instead of fetching from GitHub",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offline": {
+          "description": "Forbid network; requires --from <path>",
+          "name": "offline",
           "allowNo": false,
           "type": "boolean"
         },
         "dry-run": {
-          "description": "Show the install plan without executing it",
+          "description": "Print what would be written; change nothing",
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         },
         "yes": {
           "char": "y",
-          "description": "Non-interactive mode: auto-select latest version and accept defaults",
+          "description": "Don't prompt (reserved for future interactive paths; currently no-op)",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed output",
-          "name": "verbose",
+        "force": {
+          "description": "Overwrite user-customized commands/skills (saves .bak files)",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
-        "skip-db": {
-          "description": "Skip database provisioning phases",
-          "name": "skip-db",
+        "skip-commands": {
+          "description": "Skip seeding .claude/commands/",
+          "name": "skip-commands",
           "allowNo": false,
           "type": "boolean"
         },
-        "skip-start": {
-          "description": "Skip service startup and smoke tests",
-          "name": "skip-start",
+        "skip-skills": {
+          "description": "Skip seeding .claude/skills/",
+          "name": "skip-skills",
           "allowNo": false,
           "type": "boolean"
         },
-        "no-resume": {
-          "description": "Ignore any existing checkpoint and start fresh",
-          "name": "no-resume",
+        "skip-settings": {
+          "description": "Skip merging .claude/settings.json",
+          "name": "skip-settings",
           "allowNo": false,
           "type": "boolean"
         },
-        "fast": {
-          "description": "Fast mode: skip smoke test and optimize post-codegen steps. Re-run without --fast if you encounter issues.",
+        "json": {
+          "description": "Output as JSON (matches plan §7.5 schema)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show progress messages from the fetcher and merger",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "install:claude",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "install",
+        "claude.js"
+      ]
+    },
+    "install": {
+      "aliases": [],
+      "args": {},
+      "description": "Install MemberJunction from a GitHub release",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> -t v4.3.0",
+        "<%= config.bin %> <%= command.id %> --dry-run",
+        "<%= config.bin %> <%= command.id %> --yes"
+      ],
+      "flags": {
+        "tag": {
+          "char": "t",
+          "description": "Release tag to install (e.g. v4.3.0). If omitted, shows a version picker.",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dir": {
+          "description": "Target directory for the installation",
+          "name": "dir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "char": "c",
+          "description": "Path to JSON config file with install settings (database, auth, ports, etc.)",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "legacy": {
+          "description": "Use the legacy interactive installer (ZIP-only distribution)",
+          "hidden": true,
+          "name": "legacy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Show the install plan without executing it",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Non-interactive mode: auto-select latest version and accept defaults",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-db": {
+          "description": "Skip database provisioning phases",
+          "name": "skip-db",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-start": {
+          "description": "Skip service startup and smoke tests",
+          "name": "skip-start",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-resume": {
+          "description": "Ignore any existing checkpoint and start fresh",
+          "name": "no-resume",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "fast": {
+          "description": "Fast mode: skip smoke test and optimize post-codegen steps. Re-run without --fast if you encounter issues.",
           "name": "fast",
           "allowNo": false,
           "type": "boolean"
@@ -1915,6 +2167,12 @@
           "name": "monorepo",
           "allowNo": false,
           "type": "boolean"
+        },
+        "no-claude-pack": {
+          "description": "Exclude the Claude Code pack (CLAUDE.md + .claude/ tree) from the scaffold. By default the pack ships with the install so opening Claude Code in your new MJ project gives you the curated MJ-aware experience immediately.",
+          "name": "no-claude-pack",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1936,11 +2194,11 @@
     "migrate:convert": {
       "aliases": [],
       "args": {},
-      "description": "Convert T-SQL migrations to PostgreSQL using the BatchConverter pipeline",
+      "description": "Convert T-SQL migrations to PostgreSQL",
       "examples": [
-        "<%= config.bin %> migrate convert",
-        "<%= config.bin %> migrate convert --dry-run",
-        "<%= config.bin %> migrate convert --file V202604060452__v5.24.x__KnowledgeHub.sql",
+        "<%= config.bin %> migrate convert --split",
+        "<%= config.bin %> migrate convert --split --dry-run",
+        "<%= config.bin %> migrate convert --split --file V202604060452__v5.24.x__KnowledgeHub.sql",
         "<%= config.bin %> migrate convert --source-dir ./migrations/v5 --output-dir ./migrations-pg/v5",
         "<%= config.bin %> migrate convert --verbose"
       ],
@@ -1994,6 +2252,24 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "split": {
+          "description": "Split-and-regenerate (the standard path): transpile only hand-written DDL via the AST dialect; CodeGen objects are regenerated by `mj codegen` and mj-sync metadata re-seeded by `mj sync push`; every conversion gap is surfaced and fails the run unless --allow-gaps.",
+          "name": "split",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "allow-gaps": {
+          "description": "With --split: exit 0 even when migrations have conversion gaps (hand-authoring needed or unhandled statements). Gaps are still embedded as comments and listed in the summary.",
+          "name": "allow-gaps",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "bake-codegen": {
+          "description": "With --split: bake native PG CodeGen objects inline per migration (Path C), so the set deploys with `mj migrate` alone — no `mj codegen` step. Requires a LIVE working PG database (DB_PLATFORM=postgresql + PG_* env, same as `mj codegen`) seeded to the state just BEFORE the migrations being converted (typically the latest baseline); the converter brings it forward in committed order as it bakes. Not compatible with --dry-run.",
+          "name": "bake-codegen",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -2141,6 +2417,113 @@
         "index.js"
       ]
     },
+    "migrate:rebake": {
+      "aliases": [],
+      "args": {},
+      "description": "Re-bake the post-baseline PG migration set with inline native CodeGen",
+      "examples": [
+        "<%= config.bin %> migrate rebake",
+        "<%= config.bin %> migrate rebake --baseline-floor V202605291452 --dry-run"
+      ],
+      "flags": {
+        "source-dir": {
+          "description": "Source T-SQL migrations directory",
+          "name": "source-dir",
+          "default": "./migrations/v5",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
+          "description": "PG migrations directory (committed files read here + baked output written here)",
+          "name": "output-dir",
+          "default": "./migrations-pg/v5",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "schema": {
+          "description": "Target schema name",
+          "name": "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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Report what would be re-baked without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrate:rebake",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrate",
+        "rebake.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"
+      ]
+    },
     "querygen:export": {
       "aliases": [],
       "args": {},
@@ -2605,13 +2988,36 @@
       "description": "Pull metadata from database to local files",
       "examples": [
         "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\"",
-        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\" --filter=\"CategoryID='customer-service-id'\"",
         "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Agents\" --merge-strategy=overwrite",
-        "<%= config.bin %> <%= command.id %> --entity=\"Actions\" --target-dir=./custom-actions --no-validate",
-        "<%= config.bin %> <%= command.id %> --entity=\"Templates\" --dry-run --verbose",
-        "<%= config.bin %> <%= command.id %> --entity=\"MJ: AI Prompts\" --exclude-fields=InternalNotes,DebugInfo"
+        "<%= config.bin %> <%= command.id %> --entity=\"Templates\" --dry-run --verbose"
       ],
       "flags": {
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced)",
+          "name": "format",
+          "default": "text",
+          "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",
@@ -2640,13 +3046,6 @@
           "multiple": false,
           "type": "option"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed output",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "no-validate": {
           "description": "Skip validation before pull",
           "name": "no-validate",
@@ -2719,7 +3118,7 @@
           "type": "boolean"
         },
         "since": {
-          "description": "Only pull records updated after this ISO 8601 timestamp (e.g., 2026-04-07T10:00:00Z)",
+          "description": "Only pull records updated after this ISO 8601 timestamp",
           "name": "since",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2734,6 +3133,48 @@
       "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",
@@ -2750,9 +3191,35 @@
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --dry-run",
         "<%= config.bin %> <%= command.id %> --dir=\"ai-prompts\"",
-        "<%= config.bin %> <%= command.id %> --ci"
+        "<%= config.bin %> <%= command.id %> --ci --format=json"
       ],
       "flags": {
+        "format": {
+          "description": "Output format: text (human), json (machine-readable), md (Markdown-fenced)",
+          "name": "format",
+          "default": "text",
+          "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"
+        },
         "dir": {
           "description": "Specific entity directory to push",
           "name": "dir",
@@ -2772,13 +3239,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show detailed field-level output",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "no-validate": {
           "description": "Skip validation before push",
           "name": "no-validate",
@@ -2834,6 +3294,53 @@
       "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",
@@ -2897,6 +3404,41 @@
         "status.js"
       ]
     },
+    "sync:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj sync` command.",
+      "flags": {
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sync:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sync",
+        "usage.js"
+      ]
+    },
     "sync:validate": {
       "aliases": [],
       "args": {},
@@ -3718,6 +4260,144 @@
         "index.js"
       ]
     },
+    "update:claude": {
+      "aliases": [],
+      "args": {},
+      "description": "Update the Claude Code pack in the current directory.",
+      "examples": [
+        "<%= config.bin %> update:claude",
+        "<%= config.bin %> update:claude --check",
+        "<%= config.bin %> update:claude --refresh-commands",
+        "<%= config.bin %> update:claude --allow-major",
+        "<%= config.bin %> update:claude --json"
+      ],
+      "flags": {
+        "dir": {
+          "description": "Target directory",
+          "name": "dir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "major": {
+          "description": "Force a specific MJ major (default: detected from package.json)",
+          "name": "major",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ref": {
+          "description": "Git ref to fetch from (branch or tag). Default: main.",
+          "name": "ref",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from": {
+          "description": "Use a local pack source instead of fetching from GitHub",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offline": {
+          "description": "Forbid network; requires --from <path>",
+          "name": "offline",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Print what would be written; change nothing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Don't prompt (reserved for future interactive paths; currently no-op)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Overwrite user-customized commands/skills (saves .bak files)",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-commands": {
+          "description": "Skip seeding .claude/commands/",
+          "name": "skip-commands",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-skills": {
+          "description": "Skip seeding .claude/skills/",
+          "name": "skip-skills",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-settings": {
+          "description": "Skip merging .claude/settings.json",
+          "name": "skip-settings",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "check": {
+          "description": "Compare local pack version to remote without writing anything",
+          "name": "check",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "refresh-commands": {
+          "description": "Force-resync .claude/commands/* from the pack (saves .bak files)",
+          "name": "refresh-commands",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "refresh-skills": {
+          "description": "Force-resync .claude/skills/** from the pack (saves .bak files)",
+          "name": "refresh-skills",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "allow-major": {
+          "description": "Allow the remote pack's major to differ from local MJ's major",
+          "name": "allow-major",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output as JSON (matches plan §7.5 schema)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show progress messages",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "update:claude",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "update",
+        "claude.js"
+      ]
+    },
     "ai:actions:list": {
       "aliases": [],
       "args": {},
@@ -4766,5 +5446,5 @@
       ]
     }
   },
-  "version": "5.41.0"
+  "version": "5.42.0"
 }