@memberjunction/cli 5.37.0 → 5.38.0

package/dist/commands/test/regression/compare.js

@@ -0,0 +1,66 @@
+import { Command, Flags } from '@oclif/core';
+import { isInsideMonorepo, spawnInherit } from '../../../lib/regression/docker-helpers.js';
+const REGRESSION_RESULTS_DIR = 'docker/regression/test-results';
+const EXTERNAL_RESULTS_DIR = 'test-results';
+export default class TestRegressionCompare extends Command {
+    static { this.description = 'Diff the two most recent regression runs from docker/regression/test-results/. ' +
+        'Thin alias for `mj test compare --from-json <dir>` that handles the path.'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --diff-only',
+        '<%= config.bin %> <%= command.id %> --format=markdown --output=delta.md',
+    ]; }
+    static { this.strict = false; }
+    static { this.flags = {
+        'diff-only': Flags.boolean({
+            description: 'Show only differences.',
+            default: false,
+        }),
+        format: Flags.string({
+            char: 'f',
+            description: 'Output format.',
+            options: ['console', 'json', 'markdown'],
+            default: 'console',
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output file path.',
+        }),
+        verbose: Flags.boolean({
+            description: 'Show detailed information.',
+            default: false,
+        }),
+        tag: Flags.string({
+            description: 'Filter suite runs by tag. Compares the two most recent runs whose Tags array ' +
+                'contains the tag — useful when an archive MJ holds runs from multiple environments.',
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(TestRegressionCompare);
+        // Results live under docker/regression/test-results in the monorepo, or
+        // ./test-results when running externally (where remote/up wrote them).
+        const resultsDir = isInsideMonorepo() ? REGRESSION_RESULTS_DIR : EXTERNAL_RESULTS_DIR;
+        // --tag flips us to DB mode (results.json doesn't carry Tags), so drop
+        // --from-json when the user asks for tag filtering.
+        const args = ['test', 'compare'];
+        if (!flags.tag) {
+            args.push('--from-json', resultsDir);
+        }
+        if (flags.tag)
+            args.push('--tag', flags.tag);
+        if (flags['diff-only'])
+            args.push('--diff-only');
+        if (flags.format && flags.format !== 'console')
+            args.push('--format', flags.format);
+        if (flags.output)
+            args.push('--output', flags.output);
+        if (flags.verbose)
+            args.push('--verbose');
+        // Re-invoke the same `mj` binary. argv[1] is the entry script path.
+        const mjBin = process.argv[1] ?? 'mj';
+        const code = await spawnInherit(process.execPath, [mjBin, ...args]);
+        if (code !== 0)
+            this.exit(code);
+    }
+}
+//# sourceMappingURL=compare.js.map

package/dist/commands/test/regression/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../../../src/commands/test/regression/compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE3F,MAAM,sBAAsB,GAAG,gCAAgC,CAAC;AAChE,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,OAAO;aACjD,gBAAW,GAChB,iFAAiF;QACjF,2EAA2E,CAAC;aAEvE,aAAQ,GAAG;QAChB,qCAAqC;QACrC,iDAAiD;QACjD,yEAAyE;KAC1E,CAAC;aAEK,WAAM,GAAG,KAAK,CAAC;aAEf,UAAK,GAAG;QACb,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC;YACzB,WAAW,EAAE,wBAAwB;YACrC,OAAO,EAAE,KAAK;SACf,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC;YACxC,OAAO,EAAE,SAAS;SACnB,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,mBAAmB;SACjC,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,WAAW,EAAE,4BAA4B;YACzC,OAAO,EAAE,KAAK;SACf,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EACT,+EAA+E;gBAC/E,qFAAqF;SACxF,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAE1D,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAEtF,uEAAuE;QACvE,oDAAoD;QACpD,MAAM,IAAI,GAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,KAAK,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,WAAW,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACpF,IAAI,KAAK,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE1C,oEAAoE;QACpE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC"}

package/dist/commands/test/regression/down.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class TestRegressionDown extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'keep-volumes': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=down.d.ts.map

package/dist/commands/test/regression/down.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../../../../src/commands/test/regression/down.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAO7C,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,MAAM,CAAC,WAAW,SAC0D;IAE5E,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,KAAK;;MAKV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAa3B"}

package/dist/commands/test/regression/down.js

@@ -0,0 +1,29 @@
+import { Command, Flags } from '@oclif/core';
+import { dockerComposeArgs, requireMonorepoRoot, spawnInherit, } from '../../../lib/regression/docker-helpers.js';
+export default class TestRegressionDown extends Command {
+    static { this.description = 'Stop the regression stack and wipe DB volumes (docker compose down -v).'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --keep-volumes',
+    ]; }
+    static { this.flags = {
+        'keep-volumes': Flags.boolean({
+            description: 'Skip the `-v` flag — preserves the ephemeral DB volume.',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(TestRegressionDown);
+        requireMonorepoRoot();
+        // Use `--profile *` so compose tears down services in every profile,
+        // not just the active one. Otherwise `down` leaves orphan containers
+        // from a profile we haven't named.
+        const composeArgs = dockerComposeArgs(undefined, ['--profile', '*', 'down']);
+        if (!flags['keep-volumes'])
+            composeArgs.push('-v');
+        const code = await spawnInherit('docker', composeArgs);
+        if (code !== 0)
+            this.exit(code);
+    }
+}
+//# sourceMappingURL=down.js.map

package/dist/commands/test/regression/down.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.js","sourceRoot":"","sources":["../../../../src/commands/test/regression/down.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACb,MAAM,2CAA2C,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;aAC9C,gBAAW,GAChB,yEAAyE,CAAC;aAErE,aAAQ,GAAG;QAChB,qCAAqC;QACrC,oDAAoD;KACrD,CAAC;aAEK,UAAK,GAAG;QACb,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC;YAC5B,WAAW,EAAE,yDAAyD;YACtE,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACvD,mBAAmB,EAAE,CAAC;QAEtB,qEAAqE;QACrE,qEAAqE;QACrE,mCAAmC;QACnC,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC"}

package/dist/commands/test/regression/export.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class TestRegressionExport extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        run: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        image: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/test/regression/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../src/commands/test/regression/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAY7C,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,OAAO;IACvD,MAAM,CAAC,WAAW,SAGsC;IAExD,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;;MAUV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC3B"}

package/dist/commands/test/regression/export.js

@@ -0,0 +1,56 @@
+import { Command, Flags } from '@oclif/core';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { AGENTIC_TEST_RUNNER_IMAGE, dockerRunArgs, INLINE_REPORT_SCRIPT, isInsideMonorepo, RESULTS_DIR, spawnInherit, } from '../../../lib/regression/docker-helpers.js';
+export default class TestRegressionExport extends Command {
+    static { this.description = 'Export a regression run\'s HTML report as a single self-contained file ' +
+        '(screenshots inlined as base64), producing report.standalone.html. ' +
+        'Portable for sharing or attaching as a CI artifact.'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --run=run-20260526T220118Z',
+        '<%= config.bin %> <%= command.id %> --run=./some/other/run-dir',
+    ]; }
+    static { this.flags = {
+        run: Flags.string({
+            char: 'r',
+            description: 'Which run to export. A folder name (under test-results/) or a path. Defaults to the latest run.',
+        }),
+        image: Flags.string({
+            description: '(external) Published image used to inline reports. Default: ' + AGENTIC_TEST_RUNNER_IMAGE + '.',
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(TestRegressionExport);
+        if (isInsideMonorepo()) {
+            // On-disk inline-report.cjs against docker/regression/test-results.
+            if (!existsSync(INLINE_REPORT_SCRIPT))
+                this.error(`✗ Exporter missing: ${INLINE_REPORT_SCRIPT}`);
+            const args = [INLINE_REPORT_SCRIPT];
+            if (flags.run) {
+                const runDir = flags.run.includes('/') || path.isAbsolute(flags.run)
+                    ? path.resolve(flags.run)
+                    : path.resolve(RESULTS_DIR, flags.run);
+                if (!existsSync(runDir))
+                    this.error(`✗ Run directory not found: ${runDir}`);
+                args.push(runDir);
+            }
+            const code = await spawnInherit(process.execPath, args);
+            if (code !== 0)
+                this.exit(code);
+            return;
+        }
+        // External: run the image's `export` subcommand against the mounted run dir.
+        // Results live under ./test-results; mount it and resolve the run inside the container.
+        const image = flags.image ?? AGENTIC_TEST_RUNNER_IMAGE;
+        const resultsDir = path.resolve('test-results');
+        if (!existsSync(resultsDir))
+            this.error(`✗ No ./test-results directory found to export from.`);
+        const runArg = flags.run ? `/app/test-results/${path.basename(flags.run)}` : '/app/test-results/latest';
+        this.log(`▶ docker run ${image} export ${runArg}`);
+        const code = await spawnInherit('docker', dockerRunArgs(image, ['export', runArg], { mounts: [[resultsDir, '/app/test-results']] }));
+        if (code !== 0)
+            this.exit(code);
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/test/regression/export.js.map

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

package/dist/commands/test/regression/gen-forms.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@oclif/core';
+export default class TestRegressionGenForms extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=gen-forms.d.ts.map

package/dist/commands/test/regression/gen-forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-forms.d.ts","sourceRoot":"","sources":["../../../../src/commands/test/regression/gen-forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQtC,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,OAAO;IACzD,MAAM,CAAC,WAAW,SAEiD;IAEnE,MAAM,CAAC,QAAQ,WAA2C;IAEpD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAS3B"}

package/dist/commands/test/regression/gen-forms.js

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+import { existsSync } from 'node:fs';
+import { GEN_FORMS_SCRIPT, requireMonorepoRoot, spawnInherit, } from '../../../lib/regression/docker-helpers.js';
+export default class TestRegressionGenForms extends Command {
+    static { this.description = 'Regenerate Angular entity forms used by the regression MJExplorer image. ' +
+        'Slow (~5 min) — only required after schema or codegen changes.'; }
+    static { this.examples = ['<%= config.bin %> <%= command.id %>']; }
+    async run() {
+        requireMonorepoRoot();
+        if (!existsSync(GEN_FORMS_SCRIPT)) {
+            this.error(`✗ ${GEN_FORMS_SCRIPT} not found. Verify the docker/regression/ directory is intact.`);
+        }
+        const code = await spawnInherit('bash', [GEN_FORMS_SCRIPT]);
+        if (code !== 0)
+            this.exit(code);
+    }
+}
+//# sourceMappingURL=gen-forms.js.map

package/dist/commands/test/regression/gen-forms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-forms.js","sourceRoot":"","sources":["../../../../src/commands/test/regression/gen-forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACb,MAAM,2CAA2C,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,OAAO;aAClD,gBAAW,GAChB,2EAA2E;QAC3E,gEAAgE,CAAC;aAE5D,aAAQ,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAE1D,KAAK,CAAC,GAAG;QACP,mBAAmB,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,KAAK,gBAAgB,gEAAgE,CAAC,CAAC;QACpG,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC5D,IAAI,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC"}

package/dist/commands/test/regression/index.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@oclif/core';
+export default class TestRegression extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/test/regression/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/test/regression/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,MAAM,CAAC,WAAW,SAC4D;IAE9E,MAAM,CAAC,QAAQ,WASb;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB3B"}

package/dist/commands/test/regression/index.js

@@ -0,0 +1,33 @@
+import { Command } from '@oclif/core';
+export default class TestRegression extends Command {
+    static { this.description = 'MJ Explorer regression test suite — Docker-based LLM-driven browser tests'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %> build      # Build images (incl. gen-forms on first run)',
+        '<%= config.bin %> <%= command.id %> up         # Run the full self-contained MJ stack (Mode A)',
+        '<%= config.bin %> <%= command.id %> down       # Tear down + wipe DB volumes',
+        '<%= config.bin %> <%= command.id %> gen-forms  # Regenerate Angular entity forms',
+        '<%= config.bin %> <%= command.id %> compare    # Diff the two most recent runs',
+        '<%= config.bin %> <%= command.id %> export     # Export a run as a portable standalone HTML',
+        '<%= config.bin %> <%= command.id %> remote --target=staging-mj  # Mode B/C/D against a remote URL',
+        '<%= config.bin %> <%= command.id %> init generic-web            # Scaffold one of the example dirs',
+    ]; }
+    async run() {
+        this.log('MJ Explorer Regression Test Suite\n');
+        this.log('Available subcommands:');
+        this.log('  mj test regression build              Build Docker images for the regression stack');
+        this.log('  mj test regression up                 Run the self-contained MJ stack (Mode A)');
+        this.log('  mj test regression down               Stop the stack and wipe DB volumes');
+        this.log('  mj test regression gen-forms          One-shot: regenerate Angular entity forms');
+        this.log('  mj test regression compare            Compare the two most recent run-*/results.json');
+        this.log('  mj test regression export             Export a run as a portable standalone HTML report');
+        this.log('  mj test regression remote --target=X  Run against a remote URL (Mode B/C/D)');
+        this.log('  mj test regression init <name>        Scaffold a starter example into the cwd');
+        this.log('');
+        this.log('Most subcommands shell out to docker compose using the regression stack at');
+        this.log('docker/regression/. `init` works both inside the monorepo (copies locally) and');
+        this.log('outside (shells out to the published memberjunction/agentic-test-runner image).');
+        this.log('');
+        this.log('Run "mj test regression COMMAND --help" for details on each subcommand.');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/test/regression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/test/regression/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;aAC1C,gBAAW,GAChB,2EAA2E,CAAC;aAEvE,aAAQ,GAAG;QAChB,8FAA8F;QAC9F,gGAAgG;QAChG,8EAA8E;QAC9E,kFAAkF;QAClF,gFAAgF;QAChF,6FAA6F;QAC7F,mGAAmG;QACnG,oGAAoG;KACrG,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,sFAAsF,CAAC,CAAC;QACjG,IAAI,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;QAC7F,IAAI,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;QACvF,IAAI,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;QAC9F,IAAI,CAAC,GAAG,CAAC,wFAAwF,CAAC,CAAC;QACnG,IAAI,CAAC,GAAG,CAAC,2FAA2F,CAAC,CAAC;QACtG,IAAI,CAAC,GAAG,CAAC,+EAA+E,CAAC,CAAC;QAC1F,IAAI,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;QAC5F,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;QACvF,IAAI,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;QAC3F,IAAI,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;QAC5F,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;IACtF,CAAC"}

package/dist/commands/test/regression/init.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+export default class TestRegressionInit extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        list: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private listTemplates;
+    /**
+     * Pluck the first non-heading line from a README.md to use as a one-line
+     * description in the inventory. Returns undefined when the README is
+     * missing or only contains headings.
+     */
+    private firstNonHeadingLine;
+    private scaffold;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/test/regression/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/commands/test/regression/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAcnD,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,MAAM,CAAC,WAAW,SAG+E;IAEjG,MAAM,CAAC,QAAQ,WAMb;IAEF,MAAM,CAAC,IAAI;;MAKT;IAEF,MAAM,CAAC,KAAK;;MAKV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAe1B,OAAO,CAAC,aAAa;IAqBrB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,QAAQ;CA+BjB"}

package/dist/commands/test/regression/init.js

@@ -0,0 +1,111 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { existsSync, readdirSync, readFileSync, statSync, mkdirSync, cpSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Templates live at the package root (not under src/commands/, which oclif
+// recursively scans as commands).
+//   dev:  packages/MJCLI/src/init-templates/<name>/
+//   dist: packages/MJCLI/dist/init-templates/<name>/   (copy-regression-assets.mjs)
+// From this command file at <pkg>/{src,dist}/commands/test/regression/init.{ts,js},
+// the package's {src,dist}/ root is three directories up.
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.join(__dirname, '..', '..', '..', 'init-templates');
+export default class TestRegressionInit extends Command {
+    static { this.description = 'Scaffold one of the bundled regression-suite mode templates into the current directory. ' +
+        'Adapt the generated files (target profile + optional compose overlay + tests) to point at ' +
+        'your app, then run `mj test regression remote --target=...` to execute the suite against it.'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %> generic-web',
+        '<%= config.bin %> <%= command.id %> static-file-server',
+        '<%= config.bin %> <%= command.id %> remote-mj',
+        '<%= config.bin %> <%= command.id %> bring-your-own-app',
+        '<%= config.bin %> <%= command.id %> --list',
+    ]; }
+    static { this.args = {
+        name: Args.string({
+            description: 'Template name to scaffold (run with --list to see available).',
+            required: false,
+        }),
+    }; }
+    static { this.flags = {
+        list: Flags.boolean({
+            description: 'List available templates and exit.',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { args, flags } = await this.parse(TestRegressionInit);
+        if (flags.list) {
+            this.listTemplates();
+            return;
+        }
+        if (!args.name) {
+            this.error('✗ Missing template name. Run with --list to see available templates.');
+        }
+        this.scaffold(args.name);
+    }
+    listTemplates() {
+        if (!existsSync(TEMPLATES_DIR)) {
+            this.error(`✗ Templates directory missing at ${TEMPLATES_DIR}. ` +
+                `Reinstall @memberjunction/cli — published bundles include init-templates/.`);
+        }
+        const entries = readdirSync(TEMPLATES_DIR, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name)
+            .sort();
+        this.log(`Available templates (${entries.length}):`);
+        for (const name of entries) {
+            const readme = path.join(TEMPLATES_DIR, name, 'README.md');
+            const oneLiner = this.firstNonHeadingLine(readme);
+            this.log(`  ${name.padEnd(24)} ${oneLiner ?? ''}`);
+        }
+        this.log('');
+        this.log(`Scaffold one with: mj test regression init <name>`);
+    }
+    /**
+     * Pluck the first non-heading line from a README.md to use as a one-line
+     * description in the inventory. Returns undefined when the README is
+     * missing or only contains headings.
+     */
+    firstNonHeadingLine(readmePath) {
+        if (!existsSync(readmePath))
+            return undefined;
+        try {
+            const content = readFileSync(readmePath, 'utf8');
+            for (const raw of content.split('\n')) {
+                const line = raw.trim();
+                if (!line || line.startsWith('#') || line.startsWith('```'))
+                    continue;
+                return line.replace(/[*_`]/g, '').slice(0, 80);
+            }
+        }
+        catch {
+            // ignore
+        }
+        return undefined;
+    }
+    scaffold(name) {
+        const src = path.join(TEMPLATES_DIR, name);
+        if (!existsSync(src) || !statSync(src).isDirectory()) {
+            this.error(`✗ Template '${name}' not found at ${src}. Run with --list to see available templates.`);
+        }
+        const dest = path.resolve(name);
+        if (existsSync(dest)) {
+            this.error(`✗ Destination already exists: ${dest}\n  Remove or rename it first.`);
+        }
+        mkdirSync(path.dirname(dest), { recursive: true });
+        cpSync(src, dest, { recursive: true });
+        this.log(`✓ Scaffolded ./${name}/ from bundled '${name}' template`);
+        this.log('');
+        this.log('Next steps:');
+        this.log(`  1. Edit ${name}/target.json — point baseUrl + auth at your app.`);
+        const hasMeta = existsSync(path.join(src, 'byo-metadata')) || existsSync(path.join(src, 'metadata'));
+        if (hasMeta) {
+            this.log(`  2. Adjust the tests + suite under ${name}/ to match your app's workflows.`);
+        }
+        const hasOverlay = existsSync(path.join(src, 'docker-compose.app.yml'));
+        this.log(`  3. Run: mj test regression remote --target=./${name}/target.json` +
+            (hasOverlay ? ` --overlay=./${name}/docker-compose.app.yml` : ''));
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/test/regression/init.js.map

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

package/dist/commands/test/regression/remote.d.ts

@@ -0,0 +1,23 @@
+import { Command } from '@oclif/core';
+export default class TestRegressionRemote extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        target: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'no-local-stack': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        overlay: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        image: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'env-file': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        detach: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /** Inside the monorepo: load the target host-side, drive the compose stack. */
+    private runInMonorepo;
+    /**
+     * Outside the monorepo: run the published image. Mode B/C → `docker run`
+     * (the image loads --target itself). Mode D (--overlay) → `docker compose`
+     * with the bundled standalone compose + the user's app overlay.
+     */
+    private runExternal;
+}
+//# sourceMappingURL=remote.d.ts.map

package/dist/commands/test/regression/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../../src/commands/test/regression/remote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAgB7C,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,OAAO;IACvD,MAAM,CAAC,WAAW,SAGkC;IAEpD,MAAM,CAAC,QAAQ,WAKb;IAEF,MAAM,CAAC,KAAK;;;;;;;MA8BV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAS1B,+EAA+E;YACjE,aAAa;IAoC3B;;;;OAIG;YACW,WAAW;CAgD1B"}

package/dist/commands/test/regression/remote.js

@@ -0,0 +1,140 @@
+import { Command, Flags } from '@oclif/core';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { AGENTIC_TEST_RUNNER_IMAGE, dockerComposeArgs, dockerRunArgs, isInsideMonorepo, LOAD_TARGET_SCRIPT, resolveStandaloneCompose, resolveTargetPath, spawnCapture, spawnInherit, STANDALONE_COMPOSE, } from '../../../lib/regression/docker-helpers.js';
+export default class TestRegressionRemote extends Command {
+    static { this.description = 'Run the regression suite against a remote URL (Mode B/C/D). Inside the MJ ' +
+        'monorepo it drives the local compose stack; outside it runs the published ' +
+        'agentic-test-runner image (no monorepo needed).'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %> --target=staging-mj',
+        '<%= config.bin %> <%= command.id %> --target=./my/custom.target.json',
+        '<%= config.bin %> <%= command.id %> --target=./app/target.json --overlay=./app/docker-compose.app.yml',
+        '<%= config.bin %> <%= command.id %> --target=./t.json --image=memberjunction/agentic-test-runner:v5.30.0 --env-file=./.env',
+    ]; }
+    static { this.flags = {
+        target: Flags.string({
+            char: 't',
+            description: 'Target profile. Bare name (monorepo: docker/regression/targets/<name>.target.json) or a path.',
+            required: true,
+        }),
+        'no-local-stack': Flags.boolean({
+            description: '(monorepo only) Use the lean `remote-target` profile (test-runner only) instead of the full local stack.',
+            default: false,
+        }),
+        overlay: Flags.string({
+            description: 'docker-compose overlay (Mode D) that boots your app alongside the runner on the same network. May repeat.',
+            multiple: true,
+        }),
+        image: Flags.string({
+            description: '(external) Published image tag to run. Default: ' + AGENTIC_TEST_RUNNER_IMAGE + '. Pin for reproducibility.',
+        }),
+        'env-file': Flags.string({
+            description: '(external) Path to a .env injected into the runner (DB_*, AI_VENDOR_API_KEY__GeminiLLM, auth env: refs).',
+        }),
+        detach: Flags.boolean({
+            char: 'd',
+            description: '(monorepo) Run in the background (docker compose up -d).',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(TestRegressionRemote);
+        if (isInsideMonorepo()) {
+            await this.runInMonorepo(flags);
+        }
+        else {
+            await this.runExternal(flags);
+        }
+    }
+    /** Inside the monorepo: load the target host-side, drive the compose stack. */
+    async runInMonorepo(flags) {
+        if (!existsSync(LOAD_TARGET_SCRIPT))
+            this.error(`✗ Loader missing: ${LOAD_TARGET_SCRIPT}`);
+        const targetPath = resolveTargetPath(flags.target);
+        if (!existsSync(targetPath))
+            this.error(`✗ Target profile not found: ${targetPath}`);
+        this.log(`▶ Loading target profile: ${targetPath}`);
+        const loaded = await spawnCapture(process.execPath, [LOAD_TARGET_SCRIPT, '--format=json', targetPath]);
+        if (loaded.code !== 0)
+            this.error(`✗ Target profile loader failed (exit ${loaded.code})`);
+        let envFromProfile;
+        try {
+            envFromProfile = JSON.parse(loaded.stdout);
+        }
+        catch (err) {
+            this.error(`✗ Target loader returned malformed JSON: ${err.message}`);
+        }
+        this.log(`  Profile: ${envFromProfile.TARGET_PROFILE_NAME ?? '(unnamed)'} (${envFromProfile.TARGET_PROFILE_KIND ?? 'unknown'})`);
+        this.log(`  Base URL: ${envFromProfile.MJ_TEST_VAR_baseUrl ?? '(not set)'}`);
+        const childEnv = { ...process.env, ...envFromProfile };
+        const composeProfile = flags['no-local-stack'] ? 'remote-target' : 'full';
+        const overlays = (flags.overlay ?? []).map((p) => {
+            if (!existsSync(p))
+                this.error(`✗ Overlay file not found: ${p}`);
+            return p;
+        });
+        if (overlays.length > 0)
+            this.log(`  Overlays: ${overlays.join(', ')}`);
+        const composeArgs = dockerComposeArgs(composeProfile, ['up'], overlays);
+        if (flags.detach)
+            composeArgs.push('-d');
+        this.log(`▶ docker compose --profile ${composeProfile} up`);
+        const code = await spawnInherit('docker', composeArgs, { env: childEnv });
+        if (code !== 0)
+            this.exit(code);
+    }
+    /**
+     * Outside the monorepo: run the published image. Mode B/C → `docker run`
+     * (the image loads --target itself). Mode D (--overlay) → `docker compose`
+     * with the bundled standalone compose + the user's app overlay.
+     */
+    async runExternal(flags) {
+        const targetPath = resolveTargetPath(flags.target);
+        if (!existsSync(targetPath)) {
+            this.error(`✗ Target profile not found: ${targetPath}\n  Outside the monorepo, pass a path (e.g. --target=./my-suite/target.json).`);
+        }
+        const image = flags.image ?? AGENTIC_TEST_RUNNER_IMAGE;
+        const envFile = flags['env-file'] ? path.resolve(flags['env-file']) : undefined;
+        const targetDir = path.dirname(targetPath);
+        const targetFile = path.basename(targetPath);
+        const resultsDir = path.resolve('test-results');
+        const overlays = (flags.overlay ?? []).map((p) => {
+            if (!existsSync(p))
+                this.error(`✗ Overlay file not found: ${p}`);
+            return path.resolve(p);
+        });
+        if (overlays.length > 0) {
+            // Mode D — boot the app overlay alongside the runner via the standalone compose.
+            const standalone = resolveStandaloneCompose(STANDALONE_COMPOSE);
+            if (!existsSync(standalone)) {
+                this.error(`✗ Standalone compose not found (${standalone}). Reinstall @memberjunction/cli or run from the monorepo.`);
+            }
+            const childEnv = {
+                ...process.env,
+                MJ_IMAGE: image,
+                TARGET_DIR: targetDir,
+                TARGET_FILE: targetFile,
+                USER_ENV_FILE: envFile ?? '/dev/null',
+            };
+            const args = ['compose', '-f', standalone];
+            for (const o of overlays)
+                args.push('-f', o);
+            args.push('up', '--abort-on-container-exit', '--exit-code-from', 'test-runner');
+            this.log(`▶ docker compose (standalone + ${overlays.length} overlay) — image ${image}`);
+            const code = await spawnInherit('docker', args, { env: childEnv });
+            if (code !== 0)
+                this.exit(code);
+            return;
+        }
+        // Mode B/C — single `docker run` against the published image.
+        this.log(`▶ docker run ${image} run --target=/work/${targetFile}`);
+        const code = await spawnInherit('docker', dockerRunArgs(image, ['run', `--target=/work/${targetFile}`], {
+            mounts: [[targetDir, '/work'], [resultsDir, '/app/test-results']],
+            envFile,
+        }));
+        if (code !== 0)
+            this.exit(code);
+    }
+}
+//# sourceMappingURL=remote.js.map

package/dist/commands/test/regression/remote.js.map

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