@memberjunction/testing-integration 0.0.0 → 5.50.0

package/dist/IntegrationTestDriver.d.ts

@@ -0,0 +1,63 @@
+import { BaseTestDriver, DriverExecutionContext, DriverExecutionResult, SuiteFixtureContext } from '@memberjunction/testing-engine';
+import type { UserInfo } from '@memberjunction/core';
+export declare class IntegrationTestDriver extends BaseTestDriver {
+    /** The driver arms its own timeout and breaks the check loop when it fires. */
+    supportsCancellation(): boolean;
+    /**
+     * Suite-scoped setup (D6). Discovers the two-user RLS fixture ONCE per suite run and
+     * stashes it on the shared SuiteFixtureContext so every test of the suite (and the
+     * `rls-isolation` bundle's checks) reads the same pair. Best-effort: discovery has
+     * nothing to delete, so failures are non-fatal — Execute lazily re-discovers when the
+     * fixture is absent (e.g. the `mj test run` path has no suite). Only meaningful on the
+     * server transport (the user cache is a SQLServerDataProvider concept).
+     */
+    SetupSuite(context: SuiteFixtureContext, _contextUser: UserInfo): Promise<void>;
+    /**
+     * Suite-scoped teardown (D6). No-op: the RLS fixture is DISCOVERED (not created), so
+     * there is nothing to delete — the safest possible teardown. Present so the engine's
+     * suite-hook lifecycle is exercised end-to-end by this driver.
+     */
+    TeardownSuite(_context: SuiteFixtureContext, _contextUser: UserInfo): Promise<void>;
+    /**
+     * The two-user RLS fixture for the current run: the one discovered in SetupSuite when
+     * available, otherwise discovered lazily here (the no-suite `mj test run` path) and
+     * cached back onto the suite context for sibling tests.
+     */
+    private ensureRlsFixture;
+    Execute(context: DriverExecutionContext): Promise<DriverExecutionResult>;
+    /**
+     * Resolve a bundle and run its ordered checks. A bundle that registers a BundleLifecycle
+     * (runquery-cache, field-rules-bulk-update, …) has its Setup + Teardown wrapped in ONE
+     * try/finally so Teardown is guaranteed even on a mid-Setup crash (R4). Mutation-gated
+     * checks run only when `runMutation` is set.
+     */
+    private runBundle;
+    /**
+     * C6: run a single check but bound it by the remaining run budget. The between-checks `timedOut`
+     * flag can only stop the loop between checks — a check that hangs forever would otherwise run
+     * past the deadline unbounded. Racing the check against a per-check timeout makes a hang surface
+     * as a failed check with a clear message (caught by runCheck's try/catch) instead of a wedged
+     * run. The check's own promise may keep running after we move on, but the process is dedicated
+     * and short-lived (D1), so a dangling promise on the timeout path is harmless.
+     */
+    private runWithDeadline;
+    /** Run one check in try/catch and append one OracleResult + one TestOutcome. */
+    private runCheck;
+    /** client-cache / rls-isolation-client run on the GraphQL client transport; others on SQL server. */
+    private bundleTransport;
+    /**
+     * Obtain the run-scoped instrumented provider stack for the chosen transport.
+     * Prefers a stack already installed first-caller (CLI's installInstrumentedCacheFirst,
+     * or a prior bootstrap in this process); falls back to owning the process. Throws
+     * (caught upstream) when a client bundle is requested but the cache was already claimed
+     * by a SQL provider, or vice-versa.
+     */
+    private buildCheckContext;
+    /** Map the OracleResult[] to the framework result (one OracleResult per check). */
+    private buildResult;
+    /** Gated/skipped run: one passing 'gate' OracleResult, never 'Running', never thrown. */
+    private buildSkipResult;
+    /** Bootstrap/config error: one failing 'error' OracleResult, status 'Error', never thrown. */
+    private buildErrorResult;
+}
+//# sourceMappingURL=IntegrationTestDriver.d.ts.map

package/dist/IntegrationTestDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntegrationTestDriver.d.ts","sourceRoot":"","sources":["../src/IntegrationTestDriver.ts"],"names":[],"mappings":"AAyBA,OAAO,EACH,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EAErB,mBAAmB,EACtB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,sBAAsB,CAAC;AA2BxE,qBACa,qBAAsB,SAAQ,cAAc;IACrD,+EAA+E;IAC/D,oBAAoB,IAAI,OAAO;IAI/C;;;;;;;OAOG;IACmB,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrG;;;;OAIG;IACmB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzG;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAYX,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+FrF;;;;;OAKG;YACW,SAAS;IAoFvB;;;;;;;OAOG;YACW,eAAe;IA0B7B,gFAAgF;YAClE,QAAQ;IAgCtB,qGAAqG;IACrG,OAAO,CAAC,eAAe;IAIvB;;;;;;OAMG;YACW,iBAAiB;IAqD/B,mFAAmF;IACnF,OAAO,CAAC,WAAW;IA8BnB,yFAAyF;IACzF,OAAO,CAAC,eAAe;IAcvB,8FAA8F;IAC9F,OAAO,CAAC,gBAAgB;CAe3B"}

package/dist/IntegrationTestDriver.js

@@ -0,0 +1,425 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * IntegrationTestDriver.ts — the TestType driver for the "Integration Test" type.
+ *
+ * Resolved by TestEngine.getDriver() from TestType.DriverClass via
+ * MJGlobal.ClassFactory.CreateInstance(BaseTestDriver, 'IntegrationTestDriver').
+ *
+ * Execute():
+ *   1) parse Configuration.checks (an ordered list of check BUNDLES) off MJTestEntity;
+ *   2) honor an optional env gate (skip-as-Passed with a note);
+ *   3) infer the transport (client-cache ⇒ GraphQL client, else SQL server) and obtain
+ *      the run-scoped instrumented provider stack (installed first-caller by the CLI,
+ *      or self-bootstrapped in a dedicated process);
+ *   4) for each selected bundle, run its registered NamedCheck[] in array order against
+ *      ONE shared IntegrationCheckContext — skipping RequiresMutation checks unless the
+ *      selector opts in — converting a thrown check into a failing OracleResult (never
+ *      re-throwing; a re-throw would leave the TestRun stuck 'Running'). A bundle that
+ *      registers a BundleLifecycle (e.g. runquery-cache, field-rules-bulk-update) has its
+ *      Setup run and Teardown GUARANTEED inside one try/finally, so a mid-Setup crash still
+ *      tears down whatever the Setup accumulated (R4);
+ *   5) map the OracleResult[] onto a DriverExecutionResult (counts computed exactly
+ *      like AgentEvalDriver). The engine persists oracleResults verbatim to
+ *      TestRun.ResultDetails as a BARE ARRAY. When EMIT_OUTCOMES is set, also write a
+ *      {name,passed,durationMs,error}[] sidecar for the golden-equivalence diff.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { BaseTestDriver } from '@memberjunction/testing-engine';
+import { Metadata, ProviderType } from '@memberjunction/core';
+import { UserCache } from '@memberjunction/sqlserver-dataprovider';
+import { getActiveIntegrationStorage, getActiveIntegrationBootstrap, getActiveIntegrationClientBootstrap, bootstrapIntegrationServer, serverProcessAlreadyClaimed } from './bootstrap.js';
+import { bootstrapIntegrationClient } from './bootstrap-client.js';
+import { IntegrationCheckRegistry } from './check-registry.js';
+import { TIER_ENV_GATE, IsTierEnabled } from './tiers.js';
+import { writeOutcomesFile } from './test-runner.js';
+import { discoverRlsFixture } from './rls-fixture.js';
+const TARGET_TYPE = 'Integration Check Bundle';
+/** Bundles that run against the GraphQL client transport (everything else: SQL server). */
+const CLIENT_BUNDLES = new Set(['client-cache', 'rls-isolation-client', 'remote-op-wire-progress']);
+/** Bundles that need the discovered two-user RLS fixture threaded into the context. */
+const RLS_BUNDLES = new Set(['rls-isolation', 'rls-isolation-client']);
+/** Key under SuiteFixtureContext.Data where the discovered RLS fixture is stashed. */
+const RLS_FIXTURE_KEY = 'rlsFixture';
+let IntegrationTestDriver = class IntegrationTestDriver extends BaseTestDriver {
+    /** The driver arms its own timeout and breaks the check loop when it fires. */
+    supportsCancellation() {
+        return true;
+    }
+    /**
+     * Suite-scoped setup (D6). Discovers the two-user RLS fixture ONCE per suite run and
+     * stashes it on the shared SuiteFixtureContext so every test of the suite (and the
+     * `rls-isolation` bundle's checks) reads the same pair. Best-effort: discovery has
+     * nothing to delete, so failures are non-fatal — Execute lazily re-discovers when the
+     * fixture is absent (e.g. the `mj test run` path has no suite). Only meaningful on the
+     * server transport (the user cache is a SQLServerDataProvider concept).
+     */
+    async SetupSuite(context, _contextUser) {
+        try {
+            const users = UserCache.Instance.Users;
+            if (users && users.length > 0) {
+                context.Data[RLS_FIXTURE_KEY] = discoverRlsFixture(this.Provider, users);
+            }
+        }
+        catch (e) {
+            this.log(`SetupSuite RLS discovery skipped: ${e.message}`);
+        }
+    }
+    /**
+     * Suite-scoped teardown (D6). No-op: the RLS fixture is DISCOVERED (not created), so
+     * there is nothing to delete — the safest possible teardown. Present so the engine's
+     * suite-hook lifecycle is exercised end-to-end by this driver.
+     */
+    async TeardownSuite(_context, _contextUser) {
+        // no-op — discovery-based fixture has nothing to clean up
+    }
+    /**
+     * The two-user RLS fixture for the current run: the one discovered in SetupSuite when
+     * available, otherwise discovered lazily here (the no-suite `mj test run` path) and
+     * cached back onto the suite context for sibling tests.
+     */
+    ensureRlsFixture(context) {
+        const cached = context.fixtures?.Data?.[RLS_FIXTURE_KEY];
+        if (cached) {
+            return cached;
+        }
+        const fx = discoverRlsFixture(this.Provider, UserCache.Instance.Users);
+        if (context.fixtures) {
+            context.fixtures.Data[RLS_FIXTURE_KEY] = fx;
+        }
+        return fx;
+    }
+    async Execute(context) {
+        const startTime = Date.now();
+        this.logToTestRun(context, 'info', 'Starting integration test execution');
+        // 1) Parse Configuration. parseConfig throws on missing/bad JSON — convert to a
+        //    Failed/Error result rather than re-throwing (re-throw would leave TestRun 'Running').
+        let config;
+        try {
+            config = this.parseConfig(context.test);
+        }
+        catch (err) {
+            return this.buildErrorResult(context, startTime, err.message);
+        }
+        // 2) Whole-test tier gate (gated-tier / local-dev safety net). The tier decides the
+        //    env var via TIER_ENV_GATE; an explicit `requiresEnv` overrides it. When the gate
+        //    is unmet, skip-as-Passed with a gate note — the driver result enum has no 'Skipped'.
+        const tier = config.tier ?? 'deterministic';
+        const explicitGate = config.requiresEnv;
+        const gated = explicitGate ? process.env[explicitGate] !== '1' : !IsTierEnabled(tier);
+        if (gated) {
+            const gateVar = explicitGate ?? TIER_ENV_GATE[tier];
+            const note = `Skipped: ${gateVar} not set (tier '${tier}')`;
+            this.logToTestRun(context, 'warn', note);
+            return this.buildSkipResult(context, startTime, note);
+        }
+        const selectors = Array.isArray(config.checks) ? config.checks : [];
+        const transport = config.transport ?? (selectors.some(s => this.bundleTransport(s.type) === 'client') ? 'client' : 'server');
+        // 2b) D1 host check. These suites must own their process — install the instrumented
+        //     cache as the FIRST caller of LocalCacheManager.Initialize. Inside a live MJAPI
+        //     the cache is already initialized, so they cannot run here. Fail fast with an
+        //     actionable message (run via the CLI) instead of a confusing bootstrap stack.
+        if (transport === 'server' && serverProcessAlreadyClaimed()) {
+            return this.buildErrorResult(context, startTime, 'Integration cache suites must run in a dedicated process: run `npm run test:integration`, ' +
+                'or `MJ_INTEGRATION_TEST=1 mj test suite --name "<suite>"`. They cannot run inside a live ' +
+                'MJAPI — the cache is already initialized, so the instrumented cache cannot be installed ' +
+                'first (plan decision D1).');
+        }
+        // 3) Arm a driver-side timeout (the engine never applies one). The timer flips `timedOut`
+        //    to abort the loop BETWEEN checks; the `deadline` additionally bounds EACH check via a
+        //    per-check race (C6), so a single hung check can't run past the budget forever.
+        const effectiveTimeout = this.getEffectiveTimeout(context.test);
+        const deadline = Date.now() + effectiveTimeout;
+        let timedOut = false;
+        const timer = setTimeout(() => { timedOut = true; }, effectiveTimeout);
+        const oracleResults = [];
+        const outcomes = []; // parallel array for the EMIT_OUTCOMES sidecar
+        try {
+            const checkCtx = await this.buildCheckContext(context, transport);
+            // 4) Run each selected bundle's checks IN ORDER against ONE shared context.
+            for (const sel of selectors) {
+                if (timedOut) {
+                    break;
+                }
+                await this.runBundle(context, checkCtx, sel.type, sel.config, oracleResults, outcomes, () => timedOut, deadline);
+            }
+        }
+        catch (bootErr) {
+            clearTimeout(timer);
+            const msg = bootErr.message ?? String(bootErr);
+            // ENVIRONMENT GAP, not a product defect: client-transport bundles need a live MJAPI.
+            // When the preflight says the server is simply absent (CI runs no MJAPI), skip-as-pass
+            // loudly — the same contract the old per-bundle tsx dispatchers honored with exit 0.
+            // Any OTHER bootstrap failure (bad credentials, cache ownership, config) stays a
+            // hard error.
+            if (transport === 'client' && /MJAPI is not reachable/i.test(msg)) {
+                return this.buildSkipResult(context, startTime, `SKIPPED (environment gap): ${msg} Client-transport checks need a live MJAPI; start it and re-run for full coverage.`);
+            }
+            return this.buildErrorResult(context, startTime, `Bootstrap failed: ${msg}`);
+        }
+        clearTimeout(timer);
+        // 5a) Optional golden-diff sidecar — same shape the tsx scripts emit via EmitOutcomes.
+        const emitPath = process.env.EMIT_OUTCOMES;
+        if (emitPath) {
+            try {
+                await writeOutcomesFile(emitPath, outcomes);
+            }
+            catch (e) {
+                this.logToTestRun(context, 'warn', `EMIT_OUTCOMES write failed: ${e.message}`);
+            }
+        }
+        // 5b) Assemble the DriverExecutionResult (counts mirror AgentEvalDriver).
+        return this.buildResult(context, startTime, oracleResults, timedOut);
+    }
+    /**
+     * Resolve a bundle and run its ordered checks. A bundle that registers a BundleLifecycle
+     * (runquery-cache, field-rules-bulk-update, …) has its Setup + Teardown wrapped in ONE
+     * try/finally so Teardown is guaranteed even on a mid-Setup crash (R4). Mutation-gated
+     * checks run only when `runMutation` is set.
+     */
+    async runBundle(context, checkCtx, bundleType, selConfig, oracleResults, outcomes, isTimedOut, deadline) {
+        const bundle = IntegrationCheckRegistry.Instance.GetBundle(bundleType);
+        if (bundle.length === 0) {
+            const message = `Unknown integration check bundle '${bundleType}'. ` +
+                `Check bundles register via import side effects — MJ's own bundles live in the private ` +
+                `@memberjunction/integration-test-suite package, loaded through mj.config.cjs ` +
+                `\`testing.checkModules\` (or the --checks-module flag). If this bundle should exist, ` +
+                `verify that config key is present, the module is built, and the bundle name matches.`;
+            oracleResults.push({ oracleType: bundleType, passed: false, score: 0, message, details: { DurationMs: 0 } });
+            outcomes.push({ Name: bundleType, Passed: false, DurationMs: 0, Error: message });
+            this.logToTestRun(context, 'error', `✗ ${message}`);
+            return;
+        }
+        // Expose the selector's opaque config bag to the bundle's checks (e.g. dataset-cache
+        // reads `datasetName`, aggregates-cache reads `entityName`). Set per-bundle since the
+        // check context is shared and reused across bundles within one Execute.
+        checkCtx.Config = selConfig;
+        // The rls-isolation bundles need the discovered two-user fixture (suite-scoped via
+        // SetupSuite, or lazily discovered for the no-suite `mj test run` path).
+        if (RLS_BUNDLES.has(bundleType)) {
+            checkCtx.RlsFixture = this.ensureRlsFixture(context);
+        }
+        const runMutation = selConfig?.runMutationTests === true;
+        // Per-check tier gating routed through the shared IsTierEnabled predicate (the same
+        // one the tsx scripts use) so the env gate is honored identically. A selector may also
+        // opt mutation checks in explicitly via config.runMutationTests, independent of env.
+        const mutationEnabled = IsTierEnabled('mutation') || runMutation;
+        const liveModelEnabled = IsTierEnabled('live-model');
+        // A mutating bundle registers a lifecycle (setup creates a shared fixture on the context,
+        // teardown removes it). R4: run Setup INSIDE the same try whose finally guarantees Teardown,
+        // so a mid-Setup crash still runs Teardown against whatever the Setup accumulated onto the
+        // context so far (lifecycle Setups publish their fixture handle up-front and append created
+        // IDs as they go). A Setup failure short-circuits the bundle with one failing 'fixtures'
+        // oracle and skips the checks — but never re-throws and never leaves the fixture orphaned.
+        const lifecycle = IntegrationCheckRegistry.Instance.GetLifecycle(bundleType);
+        try {
+            if (lifecycle) {
+                await lifecycle.Setup(checkCtx);
+            }
+            for (const check of bundle) {
+                if (isTimedOut()) {
+                    break;
+                }
+                if (check.RequiresMutation && !mutationEnabled) {
+                    continue;
+                }
+                if (check.RequiresLiveModel && !liveModelEnabled) {
+                    continue;
+                }
+                await this.runCheck(context, checkCtx, check.Id, check.Name, check.Fn, oracleResults, outcomes, deadline);
+            }
+        }
+        catch (fxErr) {
+            // The only throw reachable here is from lifecycle.Setup — runCheck swallows per-check
+            // errors into results. Record it as a failing 'fixtures' oracle (never re-thrown).
+            const message = `${bundleType} fixture setup failed: ${fxErr.message}`;
+            oracleResults.push({ oracleType: `${bundleType}.fixtures`, passed: false, score: 0, message, details: { DurationMs: 0 } });
+            outcomes.push({ Name: `${bundleType}.fixtures`, Passed: false, DurationMs: 0, Error: message });
+            this.logToTestRun(context, 'error', message);
+        }
+        finally {
+            if (lifecycle) {
+                // Best-effort — a teardown failure must never mask a check result or leave TestRun 'Running'.
+                try {
+                    await lifecycle.Teardown(checkCtx);
+                }
+                catch (tdErr) {
+                    this.logToTestRun(context, 'warn', `${bundleType} teardown warning: ${tdErr.message}`);
+                }
+            }
+        }
+    }
+    /**
+     * C6: run a single check but bound it by the remaining run budget. The between-checks `timedOut`
+     * flag can only stop the loop between checks — a check that hangs forever would otherwise run
+     * past the deadline unbounded. Racing the check against a per-check timeout makes a hang surface
+     * as a failed check with a clear message (caught by runCheck's try/catch) instead of a wedged
+     * run. The check's own promise may keep running after we move on, but the process is dedicated
+     * and short-lived (D1), so a dangling promise on the timeout path is harmless.
+     */
+    async runWithDeadline(id, fn, checkCtx, deadline) {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) {
+            throw new Error(`integration run budget exhausted before check '${id}' started`);
+        }
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(`check '${id}' exceeded the ${remaining}ms remaining run budget (hung check)`)), remaining);
+        });
+        try {
+            await Promise.race([fn(checkCtx), timeout]);
+        }
+        finally {
+            if (timer) {
+                clearTimeout(timer);
+            }
+        }
+    }
+    /** Run one check in try/catch and append one OracleResult + one TestOutcome. */
+    async runCheck(context, checkCtx, id, name, fn, oracleResults, outcomes, deadline) {
+        const checkStart = Date.now();
+        try {
+            await this.runWithDeadline(id, fn, checkCtx, deadline);
+            const durationMs = Date.now() - checkStart;
+            oracleResults.push({
+                oracleType: id,
+                passed: true,
+                score: 1,
+                message: name,
+                details: { DurationMs: durationMs, runViewCacheSets: checkCtx.Storage.SetCount('RunViewCache') }
+            });
+            outcomes.push({ Name: name, Passed: true, DurationMs: durationMs });
+            this.logToTestRun(context, 'info', `✓ ${id}`);
+        }
+        catch (checkErr) {
+            const durationMs = Date.now() - checkStart;
+            const message = checkErr.message;
+            oracleResults.push({ oracleType: id, passed: false, score: 0, message, details: { DurationMs: durationMs } });
+            outcomes.push({ Name: name, Passed: false, DurationMs: durationMs, Error: message });
+            this.logToTestRun(context, 'error', `✗ ${id}: ${message}`);
+        }
+    }
+    /** client-cache / rls-isolation-client run on the GraphQL client transport; others on SQL server. */
+    bundleTransport(bundleType) {
+        return CLIENT_BUNDLES.has(bundleType) ? 'client' : 'server';
+    }
+    /**
+     * Obtain the run-scoped instrumented provider stack for the chosen transport.
+     * Prefers a stack already installed first-caller (CLI's installInstrumentedCacheFirst,
+     * or a prior bootstrap in this process); falls back to owning the process. Throws
+     * (caught upstream) when a client bundle is requested but the cache was already claimed
+     * by a SQL provider, or vice-versa.
+     */
+    async buildCheckContext(context, transport) {
+        if (transport === 'client') {
+            const client = getActiveIntegrationClientBootstrap() ?? await bootstrapIntegrationClient();
+            return {
+                User: context.contextUser,
+                Provider: this.Provider,
+                Storage: client.Storage,
+                Pool: undefined,
+                Schema: process.env.MJ_CORE_SCHEMA ?? '__mj'
+            };
+        }
+        let storage = getActiveIntegrationStorage();
+        const activeBootstrap = getActiveIntegrationBootstrap();
+        let pool = activeBootstrap?.Pool;
+        let schema = activeBootstrap?.Db.Schema;
+        // The REAL database provider (a DatabaseProviderBase): the bootstrap's own provider when a
+        // bootstrap ran in-process, else the global one installed by the CLI's initializeMJProvider.
+        // NOT `this.Provider` — its getter returns a `new Metadata()` FACADE when the engine injected
+        // no provider, and the facade lacks IRemoteOperationProvider.RouteOperation (so remote-op
+        // checks would fail with "No remote-operation-capable provider"). Dedicated single-provider
+        // process (D1), so the global is unambiguous and matches what the tsx dispatcher passes.
+        let provider = activeBootstrap?.Provider ?? Metadata.Provider;
+        if (!storage) {
+            const ic = await bootstrapIntegrationServer();
+            storage = ic.Storage;
+            pool = ic.Pool;
+            schema = ic.Db.Schema;
+            provider = ic.Provider;
+        }
+        // #3251: a server-transport bundle MUST resolve a DATABASE provider. If the process-global
+        // provider was rebound to a client (GraphQL/Network) provider — because a client-transport
+        // bundle ran earlier in this same process (setupGraphQLClient calls SetProvider) — then a
+        // server bundle would silently execute over the wire and its checks would fail in
+        // product-shaped ways. Fail loudly instead of degrading silently. The throw is caught by
+        // Execute's bootstrap try/catch → an 'Error' result, never a wedged 'Running' run. Guarded on
+        // ProviderType being present so a facade/unset global provider (e.g. in unit tests) is a no-op.
+        if (provider?.ProviderType && provider.ProviderType !== ProviderType.Database) {
+            throw new Error(`transport 'server' resolved a '${provider.ProviderType}' provider — the process-global ` +
+                `provider was rebound (a client-transport bundle ran earlier in this process). ` +
+                `Server-transport bundles must be sequenced BEFORE all client-transport bundles in a ` +
+                `suite, or run in their own process. (issue #3251)`);
+        }
+        return {
+            User: context.contextUser,
+            Provider: provider,
+            Storage: storage,
+            Pool: pool,
+            Schema: schema ?? (process.env.MJ_CORE_SCHEMA ?? '__mj')
+        };
+    }
+    /** Map the OracleResult[] to the framework result (one OracleResult per check). */
+    buildResult(context, startTime, oracleResults, timedOut) {
+        const passedChecks = oracleResults.filter(r => r.passed).length;
+        const totalChecks = oracleResults.length;
+        const failedChecks = totalChecks - passedChecks;
+        const status = timedOut ? 'Timeout' : (failedChecks === 0 ? 'Passed' : 'Failed');
+        const result = {
+            targetType: TARGET_TYPE,
+            // No external MJ log entity to link; point TargetLogID at the TestRun itself.
+            targetLogId: context.testRun.ID,
+            status,
+            score: totalChecks === 0 ? 0 : passedChecks / totalChecks,
+            oracleResults,
+            passedChecks,
+            failedChecks,
+            totalChecks,
+            durationMs: Date.now() - startTime
+        };
+        if (timedOut) {
+            result.errorMessage = `Integration run timed out after ${this.getEffectiveTimeout(context.test)}ms`;
+        }
+        return result;
+    }
+    /** Gated/skipped run: one passing 'gate' OracleResult, never 'Running', never thrown. */
+    buildSkipResult(context, startTime, note) {
+        return {
+            targetType: TARGET_TYPE,
+            targetLogId: context.testRun.ID,
+            status: 'Passed',
+            score: 1,
+            oracleResults: [{ oracleType: 'gate', passed: true, score: 1, message: note, details: { DurationMs: 0 } }],
+            passedChecks: 1,
+            failedChecks: 0,
+            totalChecks: 1,
+            durationMs: Date.now() - startTime
+        };
+    }
+    /** Bootstrap/config error: one failing 'error' OracleResult, status 'Error', never thrown. */
+    buildErrorResult(context, startTime, message) {
+        this.logToTestRun(context, 'error', message);
+        return {
+            targetType: TARGET_TYPE,
+            targetLogId: context.testRun.ID,
+            status: 'Error',
+            score: 0,
+            oracleResults: [{ oracleType: 'error', passed: false, score: 0, message, details: { DurationMs: 0 } }],
+            passedChecks: 0,
+            failedChecks: 1,
+            totalChecks: 1,
+            durationMs: Date.now() - startTime,
+            errorMessage: message
+        };
+    }
+};
+IntegrationTestDriver = __decorate([
+    RegisterClass(BaseTestDriver, 'IntegrationTestDriver')
+], IntegrationTestDriver);
+export { IntegrationTestDriver };
+//# sourceMappingURL=IntegrationTestDriver.js.map

package/dist/IntegrationTestDriver.js.map

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

package/dist/ai-verify.d.ts

@@ -0,0 +1,27 @@
+import type { UserInfo } from '@memberjunction/core';
+type Row = Record<string, unknown>;
+/**
+ * Verifies an `MJ: AI Prompt Runs` row finalized correctly: terminal Status, **CompletedAt set** (the
+ * "stuck at Running" guard the save queue prevents), and on success a non-empty Result + recorded timing.
+ */
+export declare function verifyPromptRun(promptRunID: string, user: UserInfo): Promise<Row>;
+/** Verifies an `MJ: Action Execution Logs` row finalized: **EndedAt set** + a ResultCode recorded. */
+export declare function verifyActionLog(logID: string, user: UserInfo): Promise<Row>;
+export interface AgentRunVerification {
+    run: Row;
+    stepCount: number;
+    promptRunsVerified: number;
+    actionLogsVerified: number;
+    subAgentRunsVerified: number;
+}
+/**
+ * Deep-verifies an agent run end to end: the `MJ: AI Agent Runs` header, every `MJ: AI Agent Run Steps`
+ * row (each terminal + CompletedAt set — never stuck at Running), and the records each step points at via
+ * TargetLogID — Prompt steps → AI Prompt Runs, Actions/Tool steps → Action Execution Logs, Sub-Agent steps
+ * → child AI Agent Runs (recursively). `expectSuccess` asserts the run reached 'Completed'.
+ */
+export declare function verifyAgentRun(agentRunID: string, user: UserInfo, expectSuccess?: boolean, opts?: {
+    skipActionLogs?: boolean;
+}): Promise<AgentRunVerification>;
+export {};
+//# sourceMappingURL=ai-verify.d.ts.map

package/dist/ai-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-verify.d.ts","sourceRoot":"","sources":["../src/ai-verify.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA8CnC;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CASvF;AAED,sGAAsG;AACtG,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAKjF;AAED,MAAM,WAAW,oBAAoB;IACjC,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,UAAO,EAAE,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqDrK"}