@memberjunction/cli 6.1.2 → 6.2.0-edge.0

package/README.md

@@ -526,13 +526,24 @@ mj app check-updates
 
 #### Internal / dangerous flags
 
-Intentionally omitted from `--help`. Only for MJ-internal apps that own a
-reserved-looking schema (e.g. `__bcsaas`). Do not use on third-party apps.
-
-- `--dangerously-ignore-dbl-underscore-schema-rule` — available on `mj app install`
-  and `mj app upgrade`. Bypasses the rule that blocks schema names starting with
-  `__` (reserved for MJ internals). Exact-match reserved names (`__mj`, `dbo`,
-  `sys`, `guest`, `INFORMATION_SCHEMA`) remain hard-blocked regardless.
+Intentionally omitted from `--help`. Almost never needed: MJ's own Open Apps use the
+`__mj_<AppName>` schema namespace (`__mj_BizAppsCommon`, `__mj_BizAppsForms`, …), which
+installs on the default path with no flag at all.
+
+- `--dangerously-ignore-dbl-underscore-schema-rule` — available on `mj app install`,
+  `mj app upgrade` and `mj app remove`. Allows a `__`-prefixed schema name *outside* the
+  `__mj_` app namespace (e.g. `__bcsaas`). Reserved schemas remain hard-blocked regardless,
+  on both supported platforms: every schema the **database** owns — `dbo`, `sys`, `guest`,
+  SQL Server's nine `db_*` fixed database-role schemas, `public`, anything starting `pg_`,
+  and `information_schema` — plus every schema **MJ** owns: `__mj` and `__mj_UDT`. Each of
+  these already exists in a stock database, so naming one would not create it, it would
+  *adopt* it — and `mj app remove` would then drop it.
+
+  Removing an app installed under one of those `__`-outside-namespace names (e.g. `__bcsaas`)
+  needs the same flag again: `mj app remove <app> --dangerously-ignore-dbl-underscore-schema-rule`
+  drops the schema. `--keep-data` is the exit for the platform- and MJ-reserved names above, which MJ
+  must never drop: `mj app remove <app> --keep-data` unregisters the app and leaves the
+  schema in place.
 
 ```bash
 mj app install https://github.com/BlueCypress/SaaS \

package/dist/commands/agent/init.d.ts

@@ -0,0 +1,23 @@
+import { Command } from '@oclif/core';
+export default class AgentInit extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: string[];
+    static args: {
+        dir: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        start: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        app: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'skip-docker-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private resolveTemplateDir;
+    private ensureDockerRunning;
+    private startEnvironment;
+    private printDockerInstallInstructions;
+    private printNextSteps;
+    private printCodingAgentInstructions;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/agent/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAUnD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAC+G;IAEjI,MAAM,CAAC,OAAO,WAAsB;IAEpC,MAAM,CAAC,QAAQ,WAKb;IAEF,MAAM,CAAC,IAAI;;MAMT;IAEF,MAAM,CAAC,KAAK;;;;;MAmBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA0E1B,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,8BAA8B;IActC,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,4BAA4B;CAcrC"}

package/dist/commands/agent/init.js

@@ -0,0 +1,222 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { existsSync, mkdirSync, cpSync, copyFileSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import ora from 'ora-classic';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export default class AgentInit extends Command {
+    static { this.description = 'Initialize a MemberJunction Citizen Agent Builder environment in the current or specified directory, including Docker setup.'; }
+    static { this.aliases = ['ai:agents:init']; }
+    static { this.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',
+    ]; }
+    static { this.args = {
+        dir: Args.string({
+            description: 'Target directory for the agent builder environment (default: current directory).',
+            required: false,
+            default: '.',
+        }),
+    }; }
+    static { this.flags = {
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Overwrite existing files in target directory if they already exist.',
+            default: false,
+        }),
+        start: Flags.boolean({
+            char: 's',
+            description: 'Start Docker containers and run bootstrap immediately after initialization (pass --no-start to skip).',
+            default: true,
+            allowNo: true,
+        }),
+        app: Flags.string({
+            description: 'Open App Git URL to install for business context (default: More Cheese).',
+        }),
+        'skip-docker-check': Flags.boolean({
+            description: 'Skip verifying whether Docker Desktop is currently running.',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { args, flags } = await this.parse(AgentInit);
+        const targetDir = path.resolve(process.cwd(), args.dir);
+        this.log(chalk.bold.cyan('\n🚀 MemberJunction Citizen Agent Builder\n'));
+        // 1. Resolve template directory
+        const templateDir = this.resolveTemplateDir();
+        if (!templateDir) {
+            this.error(chalk.red('✗ Citizen Agent Builder template assets could not be located.\n') +
+                'Please ensure @memberjunction/cli is properly installed.');
+        }
+        // 2. Check Docker availability & attempt auto-launch if stopped on macOS
+        const dockerAvailable = flags['skip-docker-check'] ? false : this.ensureDockerRunning();
+        // 3. Ensure target directory exists
+        if (!existsSync(targetDir)) {
+            mkdirSync(targetDir, { recursive: true });
+        }
+        // 4. Check for existing files
+        const agentsMdPath = path.join(targetDir, 'AGENTS.md');
+        if (existsSync(agentsMdPath) && !flags.force) {
+            this.log(chalk.yellow(`Target directory '${targetDir}' already contains AGENTS.md.\nUse --force to overwrite existing files.\n`));
+            return;
+        }
+        // 5. Scaffold files
+        const spinner = ora('Scaffolding agent builder workspace...').start();
+        try {
+            cpSync(templateDir, targetDir, { recursive: true });
+            // Create .env from .env.example if missing
+            const envExamplePath = path.join(targetDir, '.env.example');
+            const envPath = path.join(targetDir, '.env');
+            if (existsSync(envExamplePath) && !existsSync(envPath)) {
+                copyFileSync(envExamplePath, envPath);
+            }
+            // If custom app URL was supplied, update .env
+            if (flags.app && existsSync(envPath)) {
+                let envContent = readFileSync(envPath, 'utf8');
+                envContent = envContent.replace(/OPEN_APP_INSTALL_URL=.*/, `OPEN_APP_INSTALL_URL=${flags.app}`);
+                writeFileSync(envPath, envContent, 'utf8');
+            }
+            spinner.succeed(chalk.green('Workspace scaffolded successfully!'));
+        }
+        catch (err) {
+            spinner.fail(chalk.red('Failed to scaffold workspace.'));
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            this.error(errorMsg);
+        }
+        // 6. Start Docker and bootstrap if requested and available
+        if (flags.start && dockerAvailable) {
+            this.startEnvironment(targetDir);
+        }
+        else {
+            if (!dockerAvailable && !flags['skip-docker-check']) {
+                this.printDockerInstallInstructions();
+            }
+            this.printNextSteps(targetDir, dockerAvailable);
+        }
+    }
+    resolveTemplateDir() {
+        // 1. Check bundled template ({src,dist}/init-templates/citizen-builder)
+        const bundledPath = path.join(__dirname, '..', '..', 'init-templates', 'citizen-builder');
+        if (existsSync(bundledPath)) {
+            return bundledPath;
+        }
+        // 2. Check src template when running from dist in dev mode
+        const bundledSrcPath = path.join(__dirname, '..', '..', '..', 'src', 'init-templates', 'citizen-builder');
+        if (existsSync(bundledSrcPath)) {
+            return bundledSrcPath;
+        }
+        // 3. Check monorepo root fallback (5 levels up from commands/agent)
+        const monorepoRootPath = path.resolve(__dirname, '../../../../../citizen-builder');
+        if (existsSync(monorepoRootPath)) {
+            return monorepoRootPath;
+        }
+        return null;
+    }
+    ensureDockerRunning() {
+        // Step 1: Check if docker daemon is already responsive
+        try {
+            execSync('docker info', { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            // Daemon not answering
+        }
+        // Step 2: If macOS and Docker.app exists, try launching it automatically
+        if (process.platform === 'darwin' && existsSync('/Applications/Docker.app')) {
+            const launchSpinner = ora('Docker Desktop is installed but not running. Launching Docker Desktop...').start();
+            try {
+                execSync('open -a Docker', { stdio: 'ignore' });
+                // Poll for up to 20 seconds for the daemon socket
+                for (let i = 0; i < 20; i++) {
+                    try {
+                        execSync('docker info', { stdio: 'ignore' });
+                        launchSpinner.succeed(chalk.green('Docker Desktop started!'));
+                        return true;
+                    }
+                    catch {
+                        execSync('sleep 1');
+                    }
+                }
+                launchSpinner.warn(chalk.yellow('Docker Desktop is still initializing in the background.'));
+                return false;
+            }
+            catch {
+                launchSpinner.fail(chalk.yellow('Could not launch Docker Desktop automatically.'));
+                return false;
+            }
+        }
+        return false;
+    }
+    startEnvironment(targetDir) {
+        const spinner = ora('Starting MemberJunction container stack (docker compose up -d)...').start();
+        try {
+            execSync('docker compose up -d', { cwd: targetDir, stdio: 'pipe' });
+            spinner.succeed(chalk.green('Containers started!'));
+        }
+        catch (err) {
+            spinner.fail(chalk.red('Failed to start containers.'));
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            this.error(errorMsg);
+        }
+        let apiPort = '4000';
+        let dbPort = '1433';
+        let explorerPort = '4202';
+        const envPath = path.join(targetDir, '.env');
+        if (existsSync(envPath)) {
+            const content = readFileSync(envPath, 'utf8');
+            const apiMatch = content.match(/^API_PORT=(\d+)/m);
+            if (apiMatch)
+                apiPort = apiMatch[1];
+            const dbMatch = content.match(/^DB_PORT=(\d+)/m);
+            if (dbMatch)
+                dbPort = dbMatch[1];
+            const explorerMatch = content.match(/^EXPLORER_PORT=(\d+)/m);
+            if (explorerMatch)
+                explorerPort = explorerMatch[1];
+        }
+        this.log(chalk.bold.cyan('\n🎉 Your MemberJunction local instance is running!'));
+        this.log(`   API Endpoint:    ${chalk.green(`http://localhost:${apiPort}`)}`);
+        this.log(`   Explorer UI:     ${chalk.green(`http://localhost:${explorerPort}`)}`);
+        this.log(`   Database:        ${chalk.green(`localhost:${dbPort}`)} (DB: MemberJunction)`);
+        this.log(`   Healthcheck:     ${chalk.gray(`http://localhost:${apiPort}/healthcheck`)}\n`);
+        this.printCodingAgentInstructions();
+    }
+    printDockerInstallInstructions() {
+        this.log(chalk.yellow('\n⚠️  Docker Desktop is not installed or not running.'));
+        this.log('MemberJunction Agent Builder requires Docker Desktop to run your local database and API.\n');
+        this.log(chalk.bold('To install Docker Desktop:'));
+        if (process.platform === 'darwin') {
+            this.log('  • Download: ' + chalk.cyan('https://www.docker.com/products/docker-desktop'));
+            this.log('  • Or install via Homebrew: ' + chalk.cyan('brew install --cask docker'));
+        }
+        else if (process.platform === 'win32') {
+            this.log('  • Download: ' + chalk.cyan('https://www.docker.com/products/docker-desktop'));
+        }
+        else {
+            this.log('  • Install Docker Engine: ' + chalk.cyan('https://docs.docker.com/engine/install/'));
+        }
+    }
+    printNextSteps(targetDir, dockerAvailable) {
+        this.log(chalk.bold.white('\n📋 Next Steps:'));
+        this.log(`1. Navigate to your workspace:\n   ${chalk.cyan(`cd ${path.relative(process.cwd(), targetDir) || '.'}`)}`);
+        this.log(`2. Add your LLM API keys in ${chalk.yellow('.env')}`);
+        if (dockerAvailable) {
+            this.log(`3. Start your local environment:\n   ${chalk.cyan('docker compose up -d')}`);
+        }
+        else {
+            this.log(`3. Launch Docker Desktop and run:\n   ${chalk.cyan('docker compose up -d')}`);
+        }
+        this.printCodingAgentInstructions();
+    }
+    printCodingAgentInstructions() {
+        this.log(chalk.bold.green('\n🤖 Ready to Build with your Coding Agent:'));
+        this.log('Open your coding agent (Claude Code, Antigravity, Cursor, etc.) in this folder and simply say:');
+        this.log(chalk.italic.white('  "Build me an agent that scans for overdue invoices and prepares reminder emails."'));
+        this.log(chalk.gray('Your coding agent will read AGENTS.md, author the declarative metadata, and test it against your local database!\n'));
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/agent/init.js.map

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

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

@@ -3,10 +3,12 @@ export default class Doctor extends Command {
     static description: string;
     static examples: string[];
     static flags: {
-        dir: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        report: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        report_extended: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        report: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        report_extended: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
     private formatStatusIcon;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAU7C,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,MAAM,CAAC,WAAW,SAA4C;IAE9D,MAAM,CAAC,QAAQ,WAMb;IAEF,MAAM,CAAC,KAAK;;;;;MAgBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAqE1B,OAAO,CAAC,gBAAgB;CASzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAY7C,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,MAAM,CAAC,WAAW,SAA4C;IAE9D,MAAM,CAAC,QAAQ,WAQb;IAEF,MAAM,CAAC,KAAK;;;;;;;MAqBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAuF1B,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/commands/doctor/index.js

@@ -2,11 +2,15 @@ import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
 import path from 'node:path';
 import { InstallerEngine, } from '@memberjunction/installer';
+import { ResolveOutputFormat } from '@memberjunction/cli-core';
+import { CANONICAL_FORMAT_FLAG } from '../../lib/format-compat.js';
 export default class Doctor extends Command {
     static { this.description = 'Diagnose a MemberJunction installation'; }
     static { this.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',
@@ -16,6 +20,11 @@ export default class Doctor extends Command {
             description: 'Target directory to diagnose',
             default: '.',
         }),
+        scope: Flags.string({
+            description: 'Diagnostic scope to filter by (install, runtime, ai, metadata, agent)',
+            options: ['install', 'runtime', 'ai', 'metadata', 'agent'],
+        }),
+        format: CANONICAL_FORMAT_FLAG,
         verbose: Flags.boolean({
             char: 'v',
             description: 'Show detailed output including suggested fixes inline',
@@ -32,29 +41,42 @@ export default class Doctor extends Command {
         const { flags } = await this.parse(Doctor);
         const engine = new InstallerEngine();
         const targetDir = path.resolve(flags.dir);
-        this.log('');
-        this.log(chalk.bold('MJ Doctor'));
-        this.log('─────────');
-        engine.On('diagnostic', (event) => {
-            const icon = this.formatStatusIcon(event.Status);
-            this.log(`${icon} ${event.Message}`);
-            if (event.SuggestedFix && flags.verbose) {
-                this.log(chalk.dim(`     Fix: ${event.SuggestedFix}`));
-            }
-        });
-        // Capture log events for report path notification
-        engine.On('log', (event) => {
-            if (event.Message.startsWith('Diagnostic report saved to:')) {
-                this.log('');
-                this.log(chalk.cyan(event.Message));
-                this.log(chalk.dim('Share this file when requesting installation support. Passwords are redacted.'));
-            }
-        });
+        const { format } = ResolveOutputFormat({ formatFlag: flags.format });
+        const isJson = format === 'json';
+        if (!isJson) {
+            this.log('');
+            this.log(chalk.bold('MJ Doctor'));
+            this.log('─────────');
+            engine.On('diagnostic', (event) => {
+                const icon = this.formatStatusIcon(event.Status);
+                this.log(`${icon} ${event.Message}`);
+                if (event.SuggestedFix && flags.verbose) {
+                    this.log(chalk.dim(`     Fix: ${event.SuggestedFix}`));
+                }
+            });
+            // Capture log events for report path notification
+            engine.On('log', (event) => {
+                if (event.Message.startsWith('Diagnostic report saved to:')) {
+                    this.log('');
+                    this.log(chalk.cyan(event.Message));
+                    this.log(chalk.dim('Share this file when requesting installation support. Passwords are redacted.'));
+                }
+            });
+        }
         const result = await engine.Doctor(targetDir, {
             Verbose: flags.verbose,
             Report: flags.report,
             ReportExtended: flags.report_extended,
+            Scope: flags.scope,
+            Format: format,
         });
+        if (isJson) {
+            this.log(JSON.stringify(result.toJSON(), null, 2));
+            if (result.HasFailures) {
+                this.exit(1);
+            }
+            return;
+        }
         this.log('');
         if (result.HasFailures) {
             this.log(chalk.red.bold('Issues found:'));
@@ -88,6 +110,9 @@ export default class Doctor extends Command {
                 this.log(chalk.dim('Extended report includes config file snapshots and service startup logs.'));
             }
         }
+        if (result.HasFailures) {
+            this.exit(1);
+        }
     }
     formatStatusIcon(status) {
         switch (status) {

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

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

package/dist/commands/test/scripts.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class TestScripts extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        test: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        promote: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        discard: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=scripts.d.ts.map

package/dist/commands/test/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../../src/commands/test/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,MAAM,CAAC,WAAW,SAGkE;IAEpF,MAAM,CAAC,QAAQ,WAMb;IAEF,MAAM,CAAC,KAAK;;;;;MAmBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB3B"}

package/dist/commands/test/scripts.js

@@ -0,0 +1,50 @@
+import { Command, Flags } from '@oclif/core';
+export default class TestScripts extends Command {
+    static { this.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.'; }
+    static { this.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"',
+    ]; }
+    static { this.flags = {
+        test: Flags.string({
+            description: 'Limit to one test, by name or ID',
+        }),
+        promote: Flags.boolean({
+            description: 'Promote the pending script(s) into the slot replay uses',
+            default: false,
+            exclusive: ['discard'],
+        }),
+        discard: Flags.boolean({
+            description: 'Drop the pending script(s), keeping the promoted one',
+            default: false,
+            exclusive: ['promote'],
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm a bulk --promote/--discard that was not narrowed with --test',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(TestScripts);
+        const { ScriptsCommand } = await import('@memberjunction/testing-cli');
+        try {
+            const scriptsCommand = new ScriptsCommand();
+            await scriptsCommand.execute({
+                test: flags.test,
+                promote: flags.promote,
+                discard: flags.discard,
+                yes: flags.yes,
+            });
+        }
+        catch (error) {
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=scripts.js.map

package/dist/commands/test/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../../src/commands/test/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;aACvC,gBAAW,GAChB,+FAA+F;QAC/F,8FAA8F;QAC9F,iFAAiF,CAAC;aAE7E,aAAQ,GAAG;QAChB,qCAAqC;QACrC,iEAAiE;QACjE,2EAA2E;QAC3E,qDAAqD;QACrD,2EAA2E;KAC5E,CAAC;aAEK,UAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,kCAAkC;SAChD,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,WAAW,EAAE,yDAAyD;YACtE,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,CAAC,SAAS,CAAC;SACvB,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,WAAW,EAAE,sDAAsD;YACnE,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,CAAC,SAAS,CAAC;SACvB,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,sEAAsE;YACnF,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;YAC5C,MAAM,cAAc,CAAC,OAAO,CAAC;gBAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,EAAE,KAAK,CAAC,GAAG;aACf,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC"}

package/dist/init-templates/citizen-builder/.agents/skills/new-agent/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: new-agent
+description: Guides the coding agent to author a new MemberJunction agent and prompt metadata from user business intent.
+---
+
+# Skill: `new-agent` (Authoring Declarative Agents)
+
+Use this skill whenever the user asks to build, create, or modify a MemberJunction AI Agent.
+
+## Step 1: Elicit & Scope Business Intent
+Ask clarifying questions if the requirement is ambiguous:
+1. **Goal**: What specific business problem does the agent solve?
+2. **Inputs & Subjects**: What input does the user provide (e.g. an account ID, order number, or topic)?
+3. **Data Sources**: Which entities does it read or check? (Cross-reference against `CAPABILITIES.md`).
+4. **Output / Action**: Does it produce an answer, a formatted summary, a notification, or trigger a downstream action?
+
+## Step 2: Determine Tier & Agent Type
+- **Tier 1 (Preferred)**:
+  - If the agent follows a predictable sequence of steps, use **`TypeID: "@lookup:MJ: AI Agent Types.Name=Flow"`**.
+  - If the agent needs dynamic problem solving or open-ended tool calling, use **`TypeID: "@lookup:MJ: AI Agent Types.Name=Loop"`**.
+  - Always keep **`ModelSelectionMode: "Agent Type"`** and **`ExposeAsAction: false`**.
+- **Tier 2 (Only if custom code is strictly necessary)**:
+  - If custom JavaScript formatting or computation is required that no existing action supports, create a sandboxed Runtime Action.
+  - Define an explicit `allowedEntities` list (never wildcards).
+
+## Step 3: Author Prompt Template & Metadata
+1. **Markdown Prompt Template**:
+   Save to: `metadata/prompts/templates/<agent-slug>.template.md`
+   Structure:
+   - Clear persona and objective.
+   - Exact instructions and step sequence.
+   - Business rules and edge-case handling.
+   - Explicit Markdown output formatting guidelines.
+
+2. **Prompt Metadata JSON**:
+   Save to: `metadata/prompts/.<agent-slug>-prompt.json`
+   ```json
+   [
+     {
+       "fields": {
+         "Name": "<Agent Name> Prompt",
+         "Description": "...",
+         "CategoryID": "@lookup:MJ: AI Prompt Categories.Name=Agent Type System Prompts",
+         "TypeID": "@lookup:MJ: AI Prompt Types.Name=Chat",
+         "Status": "Active",
+         "TemplateText": "@file:templates/<agent-slug>.template.md"
+       },
+       "primaryKey": { "ID": "<GENERATE-UUID-UPPERCASE>" }
+     }
+   ]
+   ```
+
+3. **Agent Metadata JSON**:
+   Save to: `metadata/agents/.<agent-slug>-agent.json`
+   Wire `MJ: AI Agent Prompts`, `MJ: AI Agent Steps`, and optional `MJ: AI Agent Actions`.
+
+## Step 4: Sync to Database
+Run:
+```bash
+./scripts/sync-metadata.sh
+```
+Verify that the sync command outputs success.
+
+## Step 5: Hand off to Testing
+Inform the user that the agent has been created and synced:
+*"I've created your agent '**<Agent Name>**' and synced it to your local environment. You can test it now in Explorer or ask me to run a test execution."*