@memberjunction/cli 6.1.3 → 6.2.0-edge.0

package/dist/init-templates/citizen-builder/scripts/query-run-history.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# ==============================================================================
+# Citizen Agent Builder - Execution Trace & Diagnostic Tool
+# Inspects recent agent runs, step traces, and action execution errors via the
+# native MemberJunction CLI (mj ai audit agent-run).
+# ==============================================================================
+set -e
+
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$DIR"
+
+# Ensure MJ container is running
+if ! docker compose ps --status running --format "{{.Service}}" 2>/dev/null | grep -q "mj"; then
+  echo "Error: MemberJunction container ('mj') is not running." >&2
+  echo "Start the workspace services with: docker compose up -d" >&2
+  exit 1
+fi
+
+# If specific arguments or flags are passed:
+# - If first arg starts with '-' (e.g. --list, --format json, --errors), pass through directly
+# - If first arg matches a UUID format, treat as RunID and pass through directly
+# - If first arg is non-empty string, treat as agent name filter: --list --agent "$1"
+# - If no args, list recent runs
+if [ $# -eq 0 ]; then
+  docker compose exec -T mj mj ai audit agent-run --list
+elif [[ "$1" == -* ]]; then
+  docker compose exec -T mj mj ai audit agent-run "$@"
+elif [[ "$1" =~ ^[0-9a-fA-F-]{36}$ ]]; then
+  docker compose exec -T mj mj ai audit agent-run "$@"
+else
+  AGENT_NAME="$1"
+  shift
+  docker compose exec -T mj mj ai audit agent-run --list --agent "$AGENT_NAME" "$@"
+fi

package/dist/init-templates/citizen-builder/scripts/sync-metadata.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# ==============================================================================
+# Citizen Agent Builder - Metadata Sync Script
+# Pushes metadata from local ./metadata directory to the running container instance
+# ==============================================================================
+set -e
+
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$DIR"
+
+echo "Pushing metadata changes to MemberJunction database..."
+docker compose exec -T mj mj sync push --dir /work/metadata
+
+echo "Metadata sync complete!"

package/dist/init-templates/remote-mj/README.md

@@ -27,8 +27,8 @@ remote-mj/
 ```
 
 No tests/, no oracles/, no metadata/ — this example reuses the canonical MJ
-suite that ships in `metadata/test-suites/.regression-suite.json` and the 25
-test JSONs in `metadata/tests/regression/`.
+suite that ships in `metadata-optional/regression-test/test-suites/.regression-suite.json`
+and the 155 test JSONs in `metadata-optional/regression-test/tests/regression/`.
 
 ## Running it (inside the MJ monorepo)
 
@@ -61,8 +61,8 @@ Behind the scenes:
 
 ## ⚠️ Prerequisite — variable substitution
 
-For Mode B to actually retarget the canonical MJ suite, the 25 test JSONs in
-`metadata/tests/regression/` need to use `{{baseUrl}}` / `{{authUsername}}` /
+For Mode B to actually retarget the canonical MJ suite, the 155 test JSONs in
+`metadata-optional/regression-test/tests/regression/` need to use `{{baseUrl}}` / `{{authUsername}}` /
 `{{authPassword}}` / `{{allowedDomains}}` placeholders instead of hardcoded
 `http://localhost:4200`. This was Phase 1A's deliverable; the substitution
 **code** ships and is fully tested, but the **JSON conversion** is a follow-up

package/oclif.manifest.json

@@ -37,6 +37,70 @@
         "usage.js"
       ]
     },
+    "agent:init": {
+      "aliases": [
+        "ai:agents:init"
+      ],
+      "args": {
+        "dir": {
+          "default": ".",
+          "description": "Target directory for the agent builder environment (default: current directory).",
+          "name": "dir",
+          "required": false
+        }
+      },
+      "description": "Initialize a MemberJunction Citizen Agent Builder environment in the current or specified directory, including Docker setup.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> ./my-agent-workspace",
+        "<%= config.bin %> <%= command.id %> --no-start",
+        "<%= config.bin %> <%= command.id %> --app https://github.com/BlueCypress/bc-sampledata"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Overwrite existing files in target directory if they already exist.",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "start": {
+          "char": "s",
+          "description": "Start Docker containers and run bootstrap immediately after initialization (pass --no-start to skip).",
+          "name": "start",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "Open App Git URL to install for business context (default: More Cheese).",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skip-docker-check": {
+          "description": "Skip verifying whether Docker Desktop is currently running.",
+          "name": "skip-docker-check",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agent:init",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agent",
+        "init.js"
+      ]
+    },
     "ai": {
       "aliases": [],
       "args": {},
@@ -457,101 +521,6 @@
         "usage.js"
       ]
     },
-    "artifacts:reclassify": {
-      "aliases": [],
-      "args": {},
-      "description": "Upgrade-recovery utility for v5.35 artifact unification. Re-evaluates rows whose TypeID is the deleted JSON fallback but whose actual content does not parse as JSON. Normally a no-op: the v5.35 backfill migration handles this automatically. This command is only relevant when the migration ran BEFORE the artifact-type metadata (Generic Text / Generic Binary) was pushed via `mj sync push`, in which case the migration prints a notice telling you to run this. Reports \"no candidates\" once everything is reconciled. Dry-run by default; --apply writes through Record Changes.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --apply --limit 50"
-      ],
-      "flags": {
-        "conversation-id": {
-          "description": "Scope to artifacts attached to the given conversation.",
-          "name": "conversation-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "since": {
-          "description": "Scope to artifacts created on/after this ISO date.",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "description": "Maximum number of rows to inspect.",
-          "name": "limit",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "apply": {
-          "description": "Write changes. Without this flag, this command only reports what it would do.",
-          "name": "apply",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Print every candidate row, not just the summary.",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "artifacts:reclassify",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "artifacts",
-        "reclassify.js"
-      ]
-    },
-    "artifacts:usage": {
-      "aliases": [],
-      "args": {},
-      "description": "Show usage, flags, examples, and runtime hints for every `mj artifacts` command.",
-      "flags": {
-        "format": {
-          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
-          "name": "format",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json",
-            "md"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "artifacts:usage",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "artifacts",
-        "usage.js"
-      ]
-    },
     "baseline:build": {
       "aliases": [],
       "args": {},
@@ -924,6 +893,101 @@
         "usage.js"
       ]
     },
+    "artifacts:reclassify": {
+      "aliases": [],
+      "args": {},
+      "description": "Upgrade-recovery utility for v5.35 artifact unification. Re-evaluates rows whose TypeID is the deleted JSON fallback but whose actual content does not parse as JSON. Normally a no-op: the v5.35 backfill migration handles this automatically. This command is only relevant when the migration ran BEFORE the artifact-type metadata (Generic Text / Generic Binary) was pushed via `mj sync push`, in which case the migration prints a notice telling you to run this. Reports \"no candidates\" once everything is reconciled. Dry-run by default; --apply writes through Record Changes.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --apply --limit 50"
+      ],
+      "flags": {
+        "conversation-id": {
+          "description": "Scope to artifacts attached to the given conversation.",
+          "name": "conversation-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "since": {
+          "description": "Scope to artifacts created on/after this ISO date.",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of rows to inspect.",
+          "name": "limit",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "apply": {
+          "description": "Write changes. Without this flag, this command only reports what it would do.",
+          "name": "apply",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Print every candidate row, not just the summary.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "artifacts:reclassify",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "artifacts",
+        "reclassify.js"
+      ]
+    },
+    "artifacts:usage": {
+      "aliases": [],
+      "args": {},
+      "description": "Show usage, flags, examples, and runtime hints for every `mj artifacts` command.",
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to text on a terminal and json when stdout is piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "artifacts:usage",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "artifacts",
+        "usage.js"
+      ]
+    },
     "bump": {
       "aliases": [],
       "args": {},
@@ -2302,6 +2366,8 @@
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --dir ./my-mj-project",
+        "<%= config.bin %> <%= command.id %> --format json",
+        "<%= config.bin %> <%= command.id %> --scope ai",
         "<%= config.bin %> <%= command.id %> --verbose",
         "<%= config.bin %> <%= command.id %> --report",
         "<%= config.bin %> <%= command.id %> --report_extended"
@@ -2315,6 +2381,37 @@
           "multiple": false,
           "type": "option"
         },
+        "scope": {
+          "description": "Diagnostic scope to filter by (install, runtime, ai, metadata, agent)",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "install",
+            "runtime",
+            "ai",
+            "metadata",
+            "agent"
+          ],
+          "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"
+        },
         "verbose": {
           "char": "v",
           "description": "Show detailed output including suggested fixes inline",
@@ -3071,107 +3168,6 @@
         "usage.js"
       ]
     },
-    "sql-audit": {
-      "aliases": [],
-      "args": {},
-      "description": "Compare source and target databases for migration verification",
-      "examples": [
-        "<%= config.bin %> sql-audit --source \"mssql://sa:pass@host/db\" --target \"postgres://user:pass@host:5432/db\"",
-        "<%= config.bin %> sql-audit --source \"mssql://sa:pass@host/db\" --target \"postgres://user:pass@host:5432/db\" --output report.txt",
-        "<%= config.bin %> sql-audit --source \"mssql://sa:pass@host/db\" --target \"postgres://user:pass@host:5432/db\" --source-schema __mj --target-schema __mj"
-      ],
-      "flags": {
-        "source": {
-          "description": "Source database connection string (mssql://... or postgres://...)",
-          "name": "source",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target": {
-          "description": "Target database connection string (mssql://... or postgres://...)",
-          "name": "target",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-schema": {
-          "description": "Source schema name",
-          "name": "source-schema",
-          "default": "__mj",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-schema": {
-          "description": "Target schema name",
-          "name": "target-schema",
-          "default": "__mj",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output": {
-          "char": "o",
-          "description": "Save report to file",
-          "name": "output",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sql-audit",
-      "pluginAlias": "@memberjunction/cli",
-      "pluginName": "@memberjunction/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "sql-audit",
-        "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"
-      ]
-    },
     "querygen:export": {
       "aliases": [],
       "args": {},
@@ -3421,6 +3417,107 @@
         "validate.js"
       ]
     },
+    "sql-audit": {
+      "aliases": [],
+      "args": {},
+      "description": "Compare source and target databases for migration verification",
+      "examples": [
+        "<%= config.bin %> sql-audit --source \"mssql://sa:pass@host/db\" --target \"postgres://user:pass@host:5432/db\"",
+        "<%= config.bin %> sql-audit --source \"mssql://sa:pass@host/db\" --target \"postgres://user:pass@host:5432/db\" --output report.txt",
+        "<%= config.bin %> sql-audit --source \"mssql://sa:pass@host/db\" --target \"postgres://user:pass@host:5432/db\" --source-schema __mj --target-schema __mj"
+      ],
+      "flags": {
+        "source": {
+          "description": "Source database connection string (mssql://... or postgres://...)",
+          "name": "source",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target": {
+          "description": "Target database connection string (mssql://... or postgres://...)",
+          "name": "target",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-schema": {
+          "description": "Source schema name",
+          "name": "source-schema",
+          "default": "__mj",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-schema": {
+          "description": "Target schema name",
+          "name": "target-schema",
+          "default": "__mj",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Save report to file",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sql-audit",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sql-audit",
+        "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": {
@@ -4951,6 +5048,67 @@
         "run.js"
       ]
     },
+    "test:scripts": {
+      "aliases": [],
+      "args": {},
+      "description": "Review and promote recorded replay scripts. A run that re-derives a test which already had a script stores the new one as pending rather than replacing what replay uses, so a UI change never rewrites the suite unnoticed. This is where you see the drift and decide.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --test \"T042 - Filter Grid\"",
+        "<%= config.bin %> <%= command.id %> --promote --test \"T042 - Filter Grid\"",
+        "<%= config.bin %> <%= command.id %> --promote --yes",
+        "<%= config.bin %> <%= command.id %> --discard --test \"T042 - Filter Grid\""
+      ],
+      "flags": {
+        "test": {
+          "description": "Limit to one test, by name or ID",
+          "name": "test",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "promote": {
+          "description": "Promote the pending script(s) into the slot replay uses",
+          "exclusive": [
+            "discard"
+          ],
+          "name": "promote",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "discard": {
+          "description": "Drop the pending script(s), keeping the promoted one",
+          "exclusive": [
+            "promote"
+          ],
+          "name": "discard",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm a bulk --promote/--discard that was not narrowed with --test",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test:scripts",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test",
+        "scripts.js"
+      ]
+    },
     "test:suite": {
       "aliases": [],
       "args": {
@@ -6862,5 +7020,5 @@
       ]
     }
   },
-  "version": "6.1.3"
+  "version": "6.2.0-edge.0"
 }