@memberjunction/cli 5.37.0 → 5.39.0

package/dist/lib/db-version.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Reads the highest migration version already applied to the target database from
+ * Skyway's history table.
+ *
+ * Returns `null` when there is no history (a fresh database) — which tells the fetch
+ * layer to use `baseline + tail`. A non-null version means "existing database, upgrade
+ * from here", so the fetch returns only the versioned migrations after it (no baseline,
+ * which Skyway never applies to a database that already has history).
+ *
+ * @module lib/db-version
+ */
+/** Minimal shape of a Skyway history record we read (the real record carries more fields). */
+interface HistoryRecordLike {
+    Version: string | null;
+    Type: string;
+    Success?: boolean;
+}
+/** Minimal shape of the Skyway provider we use to read history (structurally compatible with the real one). */
+export interface MigrationHistoryProvider {
+    Connect(): Promise<void>;
+    Disconnect(): Promise<void>;
+    History: {
+        Exists(schema: string, tableName: string): Promise<boolean>;
+        GetAllRecords(schema: string, tableName: string): Promise<readonly HistoryRecordLike[]>;
+    };
+}
+/**
+ * SIDE EFFECTS: connects to the database to read the history table, then disconnects
+ * (on every exit path).
+ *
+ * @returns the highest applied version (Skyway's `<timestamp>` key), or `null` if the
+ *   history table does not exist yet (fresh database).
+ */
+export declare function readCurrentDbVersion(provider: MigrationHistoryProvider, schema: string, historyTable: string): Promise<string | null>;
+export {};
+//# sourceMappingURL=db-version.d.ts.map

package/dist/lib/db-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-version.d.ts","sourceRoot":"","sources":["../../src/lib/db-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8FAA8F;AAC9F,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,+GAA+G;AAC/G,MAAM,WAAW,wBAAwB;IACvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE;QACP,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;KACzF,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW3I"}

package/dist/lib/db-version.js

@@ -0,0 +1,45 @@
+/**
+ * Reads the highest migration version already applied to the target database from
+ * Skyway's history table.
+ *
+ * Returns `null` when there is no history (a fresh database) — which tells the fetch
+ * layer to use `baseline + tail`. A non-null version means "existing database, upgrade
+ * from here", so the fetch returns only the versioned migrations after it (no baseline,
+ * which Skyway never applies to a database that already has history).
+ *
+ * @module lib/db-version
+ */
+/**
+ * SIDE EFFECTS: connects to the database to read the history table, then disconnects
+ * (on every exit path).
+ *
+ * @returns the highest applied version (Skyway's `<timestamp>` key), or `null` if the
+ *   history table does not exist yet (fresh database).
+ */
+export async function readCurrentDbVersion(provider, schema, historyTable) {
+    await provider.Connect();
+    try {
+        if (!(await provider.History.Exists(schema, historyTable))) {
+            return null;
+        }
+        const records = await provider.History.GetAllRecords(schema, historyTable);
+        return highestAppliedVersion(records);
+    }
+    finally {
+        await provider.Disconnect();
+    }
+}
+/** Highest successful, non-schema-marker version among history records (mirrors Skyway's own rule). */
+function highestAppliedVersion(records) {
+    let highest = null;
+    for (const record of records) {
+        if (record.Version === null || record.Type === 'SCHEMA' || record.Success === false) {
+            continue;
+        }
+        if (highest === null || record.Version > highest) {
+            highest = record.Version;
+        }
+    }
+    return highest;
+}
+//# sourceMappingURL=db-version.js.map

package/dist/lib/db-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-version.js","sourceRoot":"","sources":["../../src/lib/db-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmBH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAkC,EAAE,MAAc,EAAE,YAAoB;IACjH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3E,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,uGAAuG;AACvG,SAAS,qBAAqB,CAAC,OAAqC;IAClE,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACpF,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;YACjD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/migration-fetch.d.ts

@@ -0,0 +1,49 @@
+export type MigrationDialect = 'sqlserver' | 'postgresql';
+export interface MigrationFetchResult {
+    /** Temp clone root to hand to Skyway as the migration location. */
+    dir: string;
+    /** Repo-relative migration paths checked out (empty when the full-history fallback was used). */
+    selected: string[];
+    /** True when partial clone was unavailable and the full `migrations/` dir was fetched instead. */
+    usedFallback: boolean;
+    /** Removes the temp clone. Callers MUST invoke this in a finally on every exit path. */
+    cleanup: () => Promise<void>;
+}
+/**
+ * Resolves a user-supplied tag/branch into a git ref.
+ * A semantic version (`2.123.0` / `v2.123.0`) maps to the `vX.Y.Z` release tag;
+ * anything else (e.g. `main`) is treated as a branch name unchanged.
+ */
+export declare function resolveGitRef(tagOrBranch: string): string;
+/**
+ * Pure selector: given the repo-relative migration paths present at a ref, return
+ * the minimal slice Skyway needs. Repeatable migrations are always included.
+ *
+ * Two modes, keyed on `currentVersion` (the highest migration already applied to the
+ * target database, or `null` for a fresh one):
+ *
+ * - **Fresh install** (`currentVersion == null`): `baseline + tail` — the highest `B`
+ *   baseline plus every `V` after it. Skyway applies the baseline (consolidated schema)
+ *   then the tail. This is the bandwidth-optimal path for a brand-new database.
+ * - **Existing-DB upgrade** (`currentVersion` set): every `V` strictly after the current
+ *   version, with **no baseline**. Skyway never applies a `B` file to a database that
+ *   already has history, and the baseline floor would wrongly skip the intermediate
+ *   versioned migrations the DB still needs (e.g. a v5.36 file below a v5.37 baseline
+ *   when upgrading a v5.35 database).
+ *
+ * With no baseline present (e.g. legacy v2) the fresh path returns the full versioned history.
+ */
+export declare function selectMigrationSlice(paths: readonly string[], currentVersion?: string | null): string[];
+/**
+ * SIDE EFFECTS: clones from `repoUrl` over the network into a temp dir and checks out
+ * only the selected migration slice. Returns the temp dir plus a `cleanup` the caller
+ * MUST run in a finally. On any internal failure the temp dir is removed before throwing.
+ */
+export declare function fetchMigrationSlice(opts: {
+    repoUrl: string;
+    ref: string;
+    dialect: MigrationDialect;
+    /** Highest version already applied to the target DB; `null`/omitted = fresh install (baseline + tail). */
+    currentVersion?: string | null;
+}): Promise<MigrationFetchResult>;
+//# sourceMappingURL=migration-fetch.d.ts.map

package/dist/lib/migration-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-fetch.d.ts","sourceRoot":"","sources":["../../src/lib/migration-fetch.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kGAAkG;IAClG,YAAY,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAcvG;AA4BD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,gBAAgB,CAAC;IAC1B,0GAA0G;IAC1G,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2BhC"}

package/dist/lib/migration-fetch.js

@@ -0,0 +1,152 @@
+/**
+ * @module lib/migration-fetch
+ *
+ * Fetches the *minimal* slice of migration files needed to bring a database to a
+ * target version, instead of cloning the entire `migrations/` history.
+ *
+ * The selection depends on whether the target database is fresh or existing, because
+ * Skyway only ever applies baselines to a fresh (no-history) database:
+ *
+ *   fresh install   →  [ highest `B` baseline ] + [ every `V` after it ] + [ all `R` repeatables ]
+ *   existing upgrade →  [ every `V` after the DB's current version ]      + [ all `R` repeatables ]   (no baseline)
+ *
+ * The existing-upgrade path is what makes incremental upgrades correct: a baseline floor
+ * would skip the intermediate versioned migrations a behind-the-baseline DB still needs.
+ * The git ref bounds the top of the range (only migrations at/below the target are in the
+ * tree). Selection uses the numeric `<timestamp>` filename token — Skyway's version key —
+ * via the shared {@link parseMigrationFilename}.
+ */
+import { mkdtempSync } from 'node:fs';
+import { rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { parseMigrationFilename } from '../baseline/util.js';
+/** Matches Flyway/Skyway repeatable migrations (`R__<desc>.sql`), which always run. */
+const REPEATABLE_PATTERN = /^R__.+\.sql$/i;
+/**
+ * Resolves a user-supplied tag/branch into a git ref.
+ * A semantic version (`2.123.0` / `v2.123.0`) maps to the `vX.Y.Z` release tag;
+ * anything else (e.g. `main`) is treated as a branch name unchanged.
+ */
+export function resolveGitRef(tagOrBranch) {
+    const isSemver = /^v?\d+\.\d+\.\d+$/.test(tagOrBranch);
+    if (!isSemver)
+        return tagOrBranch;
+    return tagOrBranch.startsWith('v') ? tagOrBranch : `v${tagOrBranch}`;
+}
+/**
+ * Pure selector: given the repo-relative migration paths present at a ref, return
+ * the minimal slice Skyway needs. Repeatable migrations are always included.
+ *
+ * Two modes, keyed on `currentVersion` (the highest migration already applied to the
+ * target database, or `null` for a fresh one):
+ *
+ * - **Fresh install** (`currentVersion == null`): `baseline + tail` — the highest `B`
+ *   baseline plus every `V` after it. Skyway applies the baseline (consolidated schema)
+ *   then the tail. This is the bandwidth-optimal path for a brand-new database.
+ * - **Existing-DB upgrade** (`currentVersion` set): every `V` strictly after the current
+ *   version, with **no baseline**. Skyway never applies a `B` file to a database that
+ *   already has history, and the baseline floor would wrongly skip the intermediate
+ *   versioned migrations the DB still needs (e.g. a v5.36 file below a v5.37 baseline
+ *   when upgrading a v5.35 database).
+ *
+ * With no baseline present (e.g. legacy v2) the fresh path returns the full versioned history.
+ */
+export function selectMigrationSlice(paths, currentVersion) {
+    const sqlPaths = paths.filter((p) => p.toLowerCase().endsWith('.sql'));
+    const repeatables = sqlPaths.filter((p) => REPEATABLE_PATTERN.test(path.basename(p)));
+    if (currentVersion != null) {
+        // Existing DB: upgrade with versioned migrations after the current version only.
+        const versioned = sqlPaths.filter((p) => isVersionedAfter(p, currentVersion));
+        return Array.from(new Set([...versioned, ...repeatables]));
+    }
+    // Fresh DB: baseline + everything after it.
+    const floorTimestamp = highestBaselineTimestamp(sqlPaths);
+    const versioned = sqlPaths.filter((p) => isInVersionedSlice(p, floorTimestamp));
+    return Array.from(new Set([...versioned, ...repeatables]));
+}
+/** True if `filePath` is a versioned (`V`) migration whose timestamp is strictly after `currentVersion`. */
+function isVersionedAfter(filePath, currentVersion) {
+    const parsed = parseMigrationFilename(path.basename(filePath));
+    return parsed?.kind === 'V' && parsed.timestamp > currentVersion;
+}
+/** Returns the timestamp of the latest `B` baseline among the paths, or null if none. */
+function highestBaselineTimestamp(sqlPaths) {
+    let floor = null;
+    for (const p of sqlPaths) {
+        const parsed = parseMigrationFilename(path.basename(p));
+        if (!parsed || parsed.kind !== 'B')
+            continue;
+        if (floor === null || parsed.timestamp > floor)
+            floor = parsed.timestamp;
+    }
+    return floor;
+}
+/** True if a versioned/baseline path belongs in the slice given the baseline floor. */
+function isInVersionedSlice(filePath, floorTimestamp) {
+    const parsed = parseMigrationFilename(path.basename(filePath));
+    if (!parsed)
+        return false; // repeatables and non-migration files handled elsewhere
+    if (floorTimestamp === null)
+        return parsed.kind === 'V'; // no baseline → all versioned
+    if (parsed.kind === 'B')
+        return parsed.timestamp === floorTimestamp; // only the floor baseline
+    return parsed.timestamp > floorTimestamp; // versioned migrations strictly after the baseline
+}
+/**
+ * SIDE EFFECTS: clones from `repoUrl` over the network into a temp dir and checks out
+ * only the selected migration slice. Returns the temp dir plus a `cleanup` the caller
+ * MUST run in a finally. On any internal failure the temp dir is removed before throwing.
+ */
+export async function fetchMigrationSlice(opts) {
+    const migrationsRoot = opts.dialect === 'postgresql' ? 'migrations-pg' : 'migrations';
+    const dir = mkdtempSync(path.join(tmpdir(), 'mj-migrations-'));
+    const cleanup = async () => {
+        await rm(dir, { recursive: true, force: true });
+    };
+    try {
+        // Deferred load: the pure selector (selectMigrationSlice/resolveGitRef) carries no
+        // runtime dependency on simple-git — only an actual fetch pulls it in.
+        const { simpleGit } = await import('simple-git');
+        const git = simpleGit(dir);
+        const partialOk = await tryPartialClone(git, opts.repoUrl, opts.ref, dir);
+        if (!partialOk) {
+            await fullSparseClone(git, opts.repoUrl, opts.ref, dir, migrationsRoot);
+            return { dir, selected: [], usedFallback: true, cleanup };
+        }
+        const allPaths = await listTreePaths(git, migrationsRoot);
+        const selected = selectMigrationSlice(allPaths, opts.currentVersion);
+        const checkoutTargets = selected.length > 0 ? selected : [migrationsRoot];
+        await git.raw(['sparse-checkout', 'set', '--no-cone', ...checkoutTargets]);
+        await git.raw(['checkout']);
+        return { dir, selected, usedFallback: false, cleanup };
+    }
+    catch (err) {
+        await cleanup();
+        throw err;
+    }
+}
+/** Attempts a blobless, no-checkout shallow clone. Returns false if the server/git rejects the filter. */
+async function tryPartialClone(git, repoUrl, ref, dir) {
+    try {
+        await git.clone(repoUrl, dir, ['--no-checkout', '--filter=blob:none', '--depth=1', '--branch', ref]);
+        return true;
+    }
+    catch {
+        return false; // caller falls back to a full sparse clone
+    }
+}
+/** Fallback path: full shallow sparse clone of the whole migrations dir (today's behavior). */
+async function fullSparseClone(git, repoUrl, ref, dir, migrationsRoot) {
+    await git.clone(repoUrl, dir, ['--sparse', '--depth=1', '--branch', ref]);
+    await git.raw(['sparse-checkout', 'set', migrationsRoot]);
+}
+/** Lists repo-relative file paths under `migrationsRoot` at HEAD without downloading blobs. */
+async function listTreePaths(git, migrationsRoot) {
+    const out = await git.raw(['ls-tree', '-r', '--name-only', 'HEAD', '--', migrationsRoot]);
+    return out
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+//# sourceMappingURL=migration-fetch.js.map

package/dist/lib/migration-fetch.js.map

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

package/dist/lib/regression/docker-helpers.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Shared helpers for `mj test regression *` subcommands.
+ *
+ * The CLI commands themselves are thin oclif wrappers — they just spawn
+ * `docker compose` / `bash` with the right flags. All the wiring (path
+ * resolution, profile selection, error reporting) lives here so the same
+ * conventions apply across every subcommand.
+ */
+import { type SpawnOptions } from 'node:child_process';
+export declare const REGRESSION_DIR = "docker/regression";
+export declare const COMPOSE_FILE = "docker/regression/docker-compose.test.yml";
+export declare const BACPAC_OVERLAY = "docker/regression/docker-compose.bacpac.yml";
+export declare const STANDALONE_COMPOSE = "docker/regression/docker-compose.standalone.yml";
+export declare const BACPAC_STANDALONE_COMPOSE = "docker/regression/docker-compose.bacpac-standalone.yml";
+/**
+ * Resolve a standalone compose file. Prefers the monorepo copy (cwd-relative
+ * `docker/regression/<name>`); falls back to the copy bundled into this CLI
+ * package at build time (`<pkg>/regression-compose/<name>`) so external users
+ * who only `npm i -g @memberjunction/cli` still have it. Returns the first path
+ * that exists, or the bundled path (so the caller can surface a clear error).
+ */
+export declare function resolveStandaloneCompose(monorepoRelPath: string): string;
+export declare const ENV_FILE = "docker/regression/.env.test";
+export declare const TARGETS_DIR = "docker/regression/targets";
+export declare const LOAD_TARGET_SCRIPT = "docker/regression/scripts/load-target-profile.cjs";
+export declare const GEN_FORMS_SCRIPT = "docker/regression/gen-forms.sh";
+export declare const RESULTS_DIR = "docker/regression/test-results";
+export declare const INLINE_REPORT_SCRIPT = "docker/regression/scripts/inline-report.cjs";
+/**
+ * The pinned runner image tag used when `init` (and future external invocations)
+ * shell out to `docker run memberjunction/agentic-test-runner …`. Kept here so
+ * a single bump updates every CLI command that consumes the image. The
+ * version is pinned to the most recent release that includes Phase 8.
+ */
+export declare const AGENTIC_TEST_RUNNER_IMAGE = "memberjunction/agentic-test-runner:latest";
+/**
+ * Verify the current working directory is the MJ monorepo root. If it isn't,
+ * print a helpful message and exit. Phase 4 still requires the user to be in
+ * the monorepo; Phase 8 will publish the docker image and lift this guard.
+ */
+export declare function requireMonorepoRoot(): void;
+/**
+ * Soft check — returns true when there's an MJ monorepo at-or-above cwd.
+ * Used by commands (compare, up, export, remote) to pick monorepo-relative
+ * paths over external/published-image paths. Unlike `requireMonorepoRoot()`,
+ * this does NOT exit on failure.
+ *
+ * The sentinel is the regression base compose file: it lives in every
+ * monorepo checkout and is never present in an external `npm i -g` install.
+ */
+export declare function isInsideMonorepo(startDir?: string): boolean;
+/** Returns true when `<cwd>/<ENV_FILE>` exists (e.g. user copied .env.test.example). */
+export declare function envFileExists(): boolean;
+/**
+ * Spawn a child process inheriting stdio. Resolves with the exit code.
+ * The promise NEVER rejects on a non-zero exit code — callers inspect the
+ * resolved number and propagate it to the user.
+ */
+export declare function spawnInherit(command: string, args: string[], options?: SpawnOptions): Promise<number>;
+/**
+ * Capture stdout from a child process (stderr inherited so errors surface).
+ * Resolves with { code, stdout }. Used by the remote subcommand to read the
+ * target-profile loader's JSON output without printing it to the user.
+ */
+export declare function spawnCapture(command: string, args: string[], options?: SpawnOptions): Promise<{
+    code: number;
+    stdout: string;
+}>;
+/**
+ * Build the base `docker compose -f <file> --env-file <file>` argument list.
+ * Optionally prepends a profile and additional overlay files (Mode D).
+ *
+ * Overlays are passed as additional `-f` flags AFTER the base compose file —
+ * compose merges them in order, so later overlays override earlier ones.
+ * Relative paths inside an overlay resolve against the FIRST `-f` file's
+ * directory (the base compose file at `docker/regression/`), NOT against the
+ * overlay's own location.
+ */
+export declare function dockerComposeArgs(profile?: string, extra?: string[], overlays?: string[]): string[];
+/**
+ * Resolve a target-profile argument to an absolute path. Accepts:
+ *   - "staging-mj"                  → docker/regression/targets/staging-mj.target.json
+ *   - "staging-mj.target.json"      → docker/regression/targets/staging-mj.target.json
+ *   - "./my/elsewhere.target.json"  → ./my/elsewhere.target.json (passthrough)
+ *   - absolute path                 → unchanged
+ */
+export declare function resolveTargetPath(input: string): string;
+/**
+ * Build a `docker run …` argument list for the published image (external,
+ * no-monorepo path). Mounts are [hostPath, containerPath] pairs; envFile is
+ * injected with `--env-file`; `host.docker.internal` is always mapped so a DB
+ * published on the host is reachable on Linux too.
+ */
+export declare function dockerRunArgs(image: string, subArgs: string[], opts?: {
+    mounts?: Array<[string, string]>;
+    envFile?: string;
+}): string[];
+//# sourceMappingURL=docker-helpers.d.ts.map

package/dist/lib/regression/docker-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/regression/docker-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK9D,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,eAAO,MAAM,YAAY,8CAA8C,CAAC;AACxE,eAAO,MAAM,cAAc,gDAAgD,CAAC;AAC5E,eAAO,MAAM,kBAAkB,oDAAoD,CAAC;AACpF,eAAO,MAAM,yBAAyB,2DAA2D,CAAC;AASlG;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAKxE;AACD,eAAO,MAAM,QAAQ,gCAAgC,CAAC;AACtD,eAAO,MAAM,WAAW,8BAA8B,CAAC;AACvD,eAAO,MAAM,kBAAkB,sDAAsD,CAAC;AACtF,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AACjE,eAAO,MAAM,WAAW,mCAAmC,CAAC;AAC5D,eAAO,MAAM,oBAAoB,gDAAgD,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,8CAA8C,CAAC;AAErF;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAU1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAQ1E;AAED,wFAAwF;AACxF,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,GAAE,MAAM,EAAO,EACpB,QAAQ,GAAE,MAAM,EAAO,GACtB,MAAM,EAAE,CAYV;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAChE,MAAM,EAAE,CAUV"}

package/dist/lib/regression/docker-helpers.js

@@ -0,0 +1,184 @@
+/**
+ * Shared helpers for `mj test regression *` subcommands.
+ *
+ * The CLI commands themselves are thin oclif wrappers — they just spawn
+ * `docker compose` / `bash` with the right flags. All the wiring (path
+ * resolution, profile selection, error reporting) lives here so the same
+ * conventions apply across every subcommand.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+export const REGRESSION_DIR = 'docker/regression';
+export const COMPOSE_FILE = `${REGRESSION_DIR}/docker-compose.test.yml`;
+export const BACPAC_OVERLAY = `${REGRESSION_DIR}/docker-compose.bacpac.yml`;
+export const STANDALONE_COMPOSE = `${REGRESSION_DIR}/docker-compose.standalone.yml`;
+export const BACPAC_STANDALONE_COMPOSE = `${REGRESSION_DIR}/docker-compose.bacpac-standalone.yml`;
+/**
+ * Package root of @memberjunction/cli (resolved from this compiled module at
+ * dist/lib/regression/docker-helpers.js → up 3). Used to locate compose assets
+ * bundled into the published package for external (no-monorepo) use.
+ */
+const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+/**
+ * Resolve a standalone compose file. Prefers the monorepo copy (cwd-relative
+ * `docker/regression/<name>`); falls back to the copy bundled into this CLI
+ * package at build time (`<pkg>/regression-compose/<name>`) so external users
+ * who only `npm i -g @memberjunction/cli` still have it. Returns the first path
+ * that exists, or the bundled path (so the caller can surface a clear error).
+ */
+export function resolveStandaloneCompose(monorepoRelPath) {
+    const monorepo = path.resolve(monorepoRelPath);
+    if (existsSync(monorepo))
+        return monorepo;
+    const bundled = path.join(PKG_ROOT, 'regression-compose', path.basename(monorepoRelPath));
+    return existsSync(bundled) ? bundled : monorepo;
+}
+export const ENV_FILE = `${REGRESSION_DIR}/.env.test`;
+export const TARGETS_DIR = `${REGRESSION_DIR}/targets`;
+export const LOAD_TARGET_SCRIPT = `${REGRESSION_DIR}/scripts/load-target-profile.cjs`;
+export const GEN_FORMS_SCRIPT = `${REGRESSION_DIR}/gen-forms.sh`;
+export const RESULTS_DIR = `${REGRESSION_DIR}/test-results`;
+export const INLINE_REPORT_SCRIPT = `${REGRESSION_DIR}/scripts/inline-report.cjs`;
+/**
+ * The pinned runner image tag used when `init` (and future external invocations)
+ * shell out to `docker run memberjunction/agentic-test-runner …`. Kept here so
+ * a single bump updates every CLI command that consumes the image. The
+ * version is pinned to the most recent release that includes Phase 8.
+ */
+export const AGENTIC_TEST_RUNNER_IMAGE = 'memberjunction/agentic-test-runner:latest';
+/**
+ * Verify the current working directory is the MJ monorepo root. If it isn't,
+ * print a helpful message and exit. Phase 4 still requires the user to be in
+ * the monorepo; Phase 8 will publish the docker image and lift this guard.
+ */
+export function requireMonorepoRoot() {
+    if (!existsSync(COMPOSE_FILE)) {
+        process.stderr.write(`✗ Expected to find ${COMPOSE_FILE} relative to the current directory.\n` +
+            `  'mj test regression *' commands must be run from the MemberJunction\n` +
+            `  monorepo root. (Phase 8 will lift this requirement by publishing the\n` +
+            `  test-runner image; for now, cd into the MJ repo first.)\n`);
+        process.exit(1);
+    }
+}
+/**
+ * Soft check — returns true when there's an MJ monorepo at-or-above cwd.
+ * Used by commands (compare, up, export, remote) to pick monorepo-relative
+ * paths over external/published-image paths. Unlike `requireMonorepoRoot()`,
+ * this does NOT exit on failure.
+ *
+ * The sentinel is the regression base compose file: it lives in every
+ * monorepo checkout and is never present in an external `npm i -g` install.
+ */
+export function isInsideMonorepo(startDir = process.cwd()) {
+    let dir = path.resolve(startDir);
+    const root = path.parse(dir).root;
+    while (dir !== root) {
+        if (existsSync(path.join(dir, COMPOSE_FILE)))
+            return true;
+        dir = path.dirname(dir);
+    }
+    return false;
+}
+/** Returns true when `<cwd>/<ENV_FILE>` exists (e.g. user copied .env.test.example). */
+export function envFileExists() {
+    return existsSync(ENV_FILE);
+}
+/**
+ * Spawn a child process inheriting stdio. Resolves with the exit code.
+ * The promise NEVER rejects on a non-zero exit code — callers inspect the
+ * resolved number and propagate it to the user.
+ */
+export function spawnInherit(command, args, options = {}) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            stdio: 'inherit',
+            ...options,
+        });
+        child.on('exit', (code) => resolve(code ?? 1));
+        child.on('error', (err) => {
+            process.stderr.write(`✗ failed to spawn ${command}: ${err.message}\n`);
+            resolve(1);
+        });
+    });
+}
+/**
+ * Capture stdout from a child process (stderr inherited so errors surface).
+ * Resolves with { code, stdout }. Used by the remote subcommand to read the
+ * target-profile loader's JSON output without printing it to the user.
+ */
+export function spawnCapture(command, args, options = {}) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            stdio: ['inherit', 'pipe', 'inherit'],
+            ...options,
+        });
+        let stdout = '';
+        child.stdout?.setEncoding('utf8');
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk;
+        });
+        child.on('exit', (code) => resolve({ code: code ?? 1, stdout }));
+        child.on('error', (err) => {
+            process.stderr.write(`✗ failed to spawn ${command}: ${err.message}\n`);
+            resolve({ code: 1, stdout: '' });
+        });
+    });
+}
+/**
+ * Build the base `docker compose -f <file> --env-file <file>` argument list.
+ * Optionally prepends a profile and additional overlay files (Mode D).
+ *
+ * Overlays are passed as additional `-f` flags AFTER the base compose file —
+ * compose merges them in order, so later overlays override earlier ones.
+ * Relative paths inside an overlay resolve against the FIRST `-f` file's
+ * directory (the base compose file at `docker/regression/`), NOT against the
+ * overlay's own location.
+ */
+export function dockerComposeArgs(profile, extra = [], overlays = []) {
+    const args = ['compose', '-f', COMPOSE_FILE];
+    for (const overlay of overlays) {
+        args.push('-f', overlay);
+    }
+    if (envFileExists()) {
+        args.push('--env-file', ENV_FILE);
+    }
+    if (profile) {
+        args.push('--profile', profile);
+    }
+    return args.concat(extra);
+}
+/**
+ * Resolve a target-profile argument to an absolute path. Accepts:
+ *   - "staging-mj"                  → docker/regression/targets/staging-mj.target.json
+ *   - "staging-mj.target.json"      → docker/regression/targets/staging-mj.target.json
+ *   - "./my/elsewhere.target.json"  → ./my/elsewhere.target.json (passthrough)
+ *   - absolute path                 → unchanged
+ */
+export function resolveTargetPath(input) {
+    if (path.isAbsolute(input))
+        return input;
+    if (input.includes('/'))
+        return path.resolve(input);
+    const withSuffix = input.endsWith('.target.json') ? input : `${input}.target.json`;
+    return path.resolve(TARGETS_DIR, withSuffix);
+}
+/**
+ * Build a `docker run …` argument list for the published image (external,
+ * no-monorepo path). Mounts are [hostPath, containerPath] pairs; envFile is
+ * injected with `--env-file`; `host.docker.internal` is always mapped so a DB
+ * published on the host is reachable on Linux too.
+ */
+export function dockerRunArgs(image, subArgs, opts = {}) {
+    const args = ['run', '--rm', '--add-host', 'host.docker.internal:host-gateway'];
+    if (opts.envFile && existsSync(opts.envFile)) {
+        args.push('--env-file', opts.envFile);
+    }
+    for (const [hostPath, containerPath] of opts.mounts ?? []) {
+        args.push('-v', `${hostPath}:${containerPath}`);
+    }
+    args.push(image, ...subArgs);
+    return args;
+}
+//# sourceMappingURL=docker-helpers.js.map

package/dist/lib/regression/docker-helpers.js.map

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

package/dist/light-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAsC7C,CAAC"}
+{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAyC7C,CAAC"}

package/dist/light-commands.js

@@ -28,6 +28,8 @@ export const LIGHT_COMMANDS = new Set([
     'install',
     // Doctor - uses @memberjunction/installer engine (lightweight, no bootstrap)
     'doctor',
+    // Bundle - uses @memberjunction/installer distribution assembly (lightweight, no bootstrap)
+    'bundle',
     // Topic index commands (just display help text, no heavy imports)
     'ai',
     'ai audit',

package/dist/light-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,sCAAsC;IACtC,MAAM;IAEN,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,UAAU;IACV,MAAM;IACN,OAAO;IAEP,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,0DAA0D;IAC1D,YAAY;IACZ,eAAe;IACf,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,aAAa;IACb,cAAc;CACf,CAAC,CAAC"}
+{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,sCAAsC;IACtC,MAAM;IAEN,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,4FAA4F;IAC5F,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,UAAU;IACV,MAAM;IACN,OAAO;IAEP,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,0DAA0D;IAC1D,YAAY;IACZ,eAAe;IACf,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,aAAa;IACb,cAAc;CACf,CAAC,CAAC"}