@memberjunction/react-test-harness 6.2.0-edge.0 → 6.2.0-edge.1

package/dist/lib/component-runner.d.ts

@@ -2,6 +2,175 @@ import { BrowserManager } from './browser-context.js';
 import type { UserInfo } from '@memberjunction/core';
 import { Violation, type LinterOptions } from '@memberjunction/react-linter';
 import { ComponentSpec, SimpleAITools } from '@memberjunction/interactive-component-types';
+/**
+ * Row ceilings applied to the data bridges the component under test calls through
+ * (`__mjRunView`, `__mjRunViews`, `__mjRunQuery`).
+ *
+ * A test run only needs enough rows to render and be looked at, so the harness does not
+ * honour an unbounded request. `MaxRows` is applied at the SQL level by the provider, so
+ * the surplus is never produced rather than fetched and discarded — which matters because
+ * a bridge result is serialized in Node, shipped over CDP and rehydrated in Chromium,
+ * leaving several resident copies of the same data.
+ */
+export interface DataCapOptions {
+    /** Ceiling for `RunView` / `RunViews`. @default 1000 */
+    runViewMaxRows?: number;
+    /** Ceiling for `RunQuery`. @default 1000 */
+    runQueryMaxRows?: number;
+}
+/**
+ * One data call made by the component under test, recorded by the harness bridges.
+ *
+ * Lets a caller tell apart failure modes that a screenshot alone cannot: a component
+ * showing no data because its query returned zero rows is an upstream data or parameter
+ * problem, while one showing no data after rows *were* returned is a render or binding
+ * bug.
+ */
+/**
+ * Machine-readable identity of what a data call resolved to.
+ *
+ * Field names mirror `ComponentSpec.dataRequirements` (`ComponentQueryDataRequirement.name`
+ * / `.categoryPath`, `ComponentEntityDataRequirement.name`) so a caller can correlate what
+ * a component declared against what it actually called, without parsing a display string.
+ *
+ * It mirrors that vocabulary rather than referencing the spec, because a record must be
+ * able to describe a call that appears nowhere in `dataRequirements`.
+ */
+export interface DataAccessIdentity {
+    /** Entity name — corresponds to `ComponentEntityDataRequirement.name`. */
+    entityName?: string;
+    /** Query name — corresponds to `ComponentQueryDataRequirement.name`. Not unique alone. */
+    queryName?: string;
+    /** Category path that disambiguates `queryName` — `ComponentQueryDataRequirement.categoryPath`. */
+    categoryPath?: string;
+    /** Present when the call named a query by ID, which takes precedence over name. */
+    queryId?: string;
+    /** Present when the call named a saved view by ID. */
+    viewId?: string;
+    /** Present when the call named a saved view by name. */
+    viewName?: string;
+}
+export interface DataAccessRecord {
+    kind: 'RunView' | 'RunViews' | 'RunQuery';
+    /**
+     * Human/LLM-readable rendering of {@link identity} — a category-qualified query path,
+     * or the view/entity a `RunView` resolved to. For display and prompts; use `identity`
+     * for matching.
+     */
+    target: string;
+    /** Structured identity, for correlating against declared data requirements. */
+    identity: DataAccessIdentity;
+    /** Rows actually handed to the component. */
+    rowsReturned: number;
+    /**
+     * Rows the query would have produced without the harness ceiling, when the provider
+     * reports it (`TotalRowCount`). Equal to `rowsReturned` when nothing was capped.
+     */
+    totalRowCount?: number;
+    /** True when the harness ceiling reduced the result below what the source held. */
+    capped: boolean;
+    /** Ceiling actually applied to this call. */
+    appliedMaxRows?: number;
+    /** `MaxRows` the component asked for, when it asked for one. */
+    requestedMaxRows?: number;
+    /** Wall-clock duration of the call, in milliseconds. */
+    durationMs: number;
+    /** Present when the call failed; the bridge returns an empty result set in that case. */
+    error?: string;
+}
+/** Default row ceiling for `RunView` / `RunViews`. @see DataCapOptions */
+export declare const DEFAULT_RUN_VIEW_MAX_ROWS = 1000;
+/** Default row ceiling for `RunQuery`. @see DataCapOptions */
+export declare const DEFAULT_RUN_QUERY_MAX_ROWS = 1000;
+/**
+ * Resolves the `MaxRows` to send for one data call.
+ *
+ * Clamps downward only: a component asking for 50 rows still gets 50, while one asking for
+ * nothing or for more than the ceiling gets the ceiling. A nonsensical request (zero,
+ * negative, non-numeric) is treated as absent.
+ *
+ * Returns the requested value alongside the applied one, so a capped call can report what
+ * the component wanted.
+ *
+ * Pure (no I/O) so it can be unit-tested without launching a browser.
+ */
+export declare function ResolveDataCapMaxRows(requested: number | undefined, ceiling: number): {
+    applied: number;
+    requested?: number;
+};
+/**
+ * Builds a {@link DataAccessRecord} from a completed provider call.
+ *
+ * `TotalRowCount` is the provider's count of rows the query would have produced without
+ * paging, making it the denominator for "capped at N of M". Providers that omit it, or
+ * leave it equal to `RowCount`, yield `capped: false` rather than a guess.
+ *
+ * Pure (no I/O) so it can be unit-tested without launching a browser.
+ */
+export declare function BuildDataAccessRecord(kind: DataAccessRecord['kind'], resolved: {
+    target: string;
+    identity: DataAccessIdentity;
+}, result: {
+    Results?: any[];
+    TotalRowCount?: number;
+} | undefined, maxRows: {
+    applied: number;
+    requested?: number;
+}, durationMs: number): DataAccessRecord;
+/** Debug-log suffix naming the cap, e.g. ` (capped at 1000 of 205802)`. Empty when uncapped. */
+export declare function DescribeDataCap(record: DataAccessRecord): string;
+/**
+ * Names the query a `RunQuery` call resolved to, as both a display string and a structured
+ * {@link DataAccessIdentity}.
+ *
+ * A query name is not unique on its own — name and category path identify a query together
+ * — so the display form is category-qualified.
+ *
+ * Precedence mirrors how `RunQuery` itself resolves: `QueryID` wins and `QueryName` is
+ * ignored when both are supplied, so the ID is reported as the identity and the supplied
+ * name is kept only as a label. `identity` retains every part the caller passed, so a
+ * correlation by name and path still works when an ID drove the resolution.
+ */
+export declare function ResolveQueryTarget(params: {
+    QueryID?: string;
+    QueryName?: string;
+    CategoryPath?: string;
+    CategoryID?: string;
+}): {
+    target: string;
+    identity: DataAccessIdentity;
+};
+/** Display-only form of {@link ResolveQueryTarget}. */
+export declare function DescribeQueryTarget(params: {
+    QueryID?: string;
+    QueryName?: string;
+    CategoryPath?: string;
+    CategoryID?: string;
+}): string;
+/**
+ * Names the view a `RunView` call resolved to, as both a display string and a structured
+ * {@link DataAccessIdentity}.
+ *
+ * Follows `RunViewParams`' own precedence — `ViewEntity` → `ViewID` → `ViewName` →
+ * `EntityName` — where each earlier field causes the later ones to be ignored. Reporting
+ * `EntityName` regardless would name something the call did not resolve by.
+ */
+export declare function ResolveViewTarget(params: {
+    ViewEntity?: unknown;
+    ViewID?: string;
+    ViewName?: string;
+    EntityName?: string;
+}): {
+    target: string;
+    identity: DataAccessIdentity;
+};
+/** Display-only form of {@link ResolveViewTarget}. */
+export declare function DescribeViewTarget(params: {
+    ViewEntity?: unknown;
+    ViewID?: string;
+    ViewName?: string;
+    EntityName?: string;
+}): string;
 /**
  * Browser-execution options for {@link ComponentRunner}. Extends {@link LinterOptions}
  * (which carries `componentSpec`, `contextUser`, `entityMetadata`, `utilities` —
@@ -94,6 +263,15 @@ export interface ComponentExecutionOptions extends LinterOptions {
      * @default 15000
      */
     dataIdleTimeoutMs?: number;
+    /**
+     * Row ceilings for the data bridges. Omitted fields fall back to
+     * {@link DEFAULT_RUN_VIEW_MAX_ROWS} /
+     * {@link DEFAULT_RUN_QUERY_MAX_ROWS} (1000).
+     *
+     * A component asking for fewer rows than the ceiling keeps its own smaller number;
+     * the ceiling only ever clamps downward.
+     */
+    dataCaps?: DataCapOptions;
 }
 export interface ComponentExecutionResult {
     success: boolean;
@@ -134,6 +312,13 @@ export interface ComponentExecutionResult {
      * This field gives you the "did the code work?" answer directly.
      */
     codeExecutionSuccess?: boolean;
+    /**
+     * Every data call the component made, in the order the bridges served them.
+     *
+     * Empty when the component fetched nothing — itself a useful signal, and distinct from
+     * a component whose calls all returned zero rows.
+     */
+    dataAccess?: DataAccessRecord[];
 }
 /**
  * ComponentRunner that uses the actual React runtime via Playwright UMD bundle
@@ -157,10 +342,17 @@ export declare class ComponentRunner {
     /**
      * Lint component code before execution
      */
+    LintComponent(componentCode: string, componentName: string, componentSpec?: any, isRootComponent?: boolean, contextUser?: UserInfo, options?: any): Promise<{
+        violations: Violation[];
+        hasErrors: boolean;
+    }>;
+    /** @deprecated Use {@link LintComponent}. */
     lintComponent(componentCode: string, componentName: string, componentSpec?: any, isRootComponent?: boolean, contextUser?: UserInfo, options?: any): Promise<{
         violations: Violation[];
         hasErrors: boolean;
     }>;
+    ExecuteComponent(options: ComponentExecutionOptions): Promise<ComponentExecutionResult>;
+    /** @deprecated Use {@link ExecuteComponent}. */
     executeComponent(options: ComponentExecutionOptions): Promise<ComponentExecutionResult>;
     /**
      * Load core runtime libraries into the page (React, ReactDOM, Babel, MJRuntime)

package/dist/lib/component-runner.d.ts.map

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

package/dist/lib/component-runner.js

@@ -28,6 +28,141 @@ async function preResolveComponentSpec(spec, contextUser) {
     // For other types, return as-is
     return spec;
 }
+/** Default row ceiling for `RunView` / `RunViews`. @see DataCapOptions */
+export const DEFAULT_RUN_VIEW_MAX_ROWS = 1000;
+/** Default row ceiling for `RunQuery`. @see DataCapOptions */
+export const DEFAULT_RUN_QUERY_MAX_ROWS = 1000;
+/**
+ * Resolves the `MaxRows` to send for one data call.
+ *
+ * Clamps downward only: a component asking for 50 rows still gets 50, while one asking for
+ * nothing or for more than the ceiling gets the ceiling. A nonsensical request (zero,
+ * negative, non-numeric) is treated as absent.
+ *
+ * Returns the requested value alongside the applied one, so a capped call can report what
+ * the component wanted.
+ *
+ * Pure (no I/O) so it can be unit-tested without launching a browser.
+ */
+export function ResolveDataCapMaxRows(requested, ceiling) {
+    const validRequest = typeof requested === 'number' && Number.isFinite(requested) && requested > 0 ? requested : undefined;
+    return {
+        applied: validRequest === undefined ? ceiling : Math.min(validRequest, ceiling),
+        requested: validRequest,
+    };
+}
+/**
+ * Builds a {@link DataAccessRecord} from a completed provider call.
+ *
+ * `TotalRowCount` is the provider's count of rows the query would have produced without
+ * paging, making it the denominator for "capped at N of M". Providers that omit it, or
+ * leave it equal to `RowCount`, yield `capped: false` rather than a guess.
+ *
+ * Pure (no I/O) so it can be unit-tested without launching a browser.
+ */
+export function BuildDataAccessRecord(kind, resolved, result, maxRows, durationMs) {
+    const rowsReturned = result?.Results?.length ?? 0;
+    const total = typeof result?.TotalRowCount === 'number' ? result.TotalRowCount : undefined;
+    return {
+        kind,
+        target: resolved.target,
+        identity: resolved.identity,
+        rowsReturned,
+        totalRowCount: total,
+        capped: total !== undefined && total > rowsReturned,
+        appliedMaxRows: maxRows.applied,
+        requestedMaxRows: maxRows.requested,
+        durationMs,
+    };
+}
+/** Debug-log suffix naming the cap, e.g. ` (capped at 1000 of 205802)`. Empty when uncapped. */
+export function DescribeDataCap(record) {
+    return record.capped ? ` (capped at ${record.rowsReturned} of ${record.totalRowCount})` : '';
+}
+/**
+ * Normalizes a category path and appends a leaf name, e.g. (`/MJ/AI/Agents/`, `Foo`) →
+ * `/MJ/AI/Agents/Foo`. Tolerates missing or doubled slashes on either side.
+ */
+function joinCategoryPath(categoryPath, name) {
+    const trimmed = categoryPath.replace(/^\/+|\/+$/g, '');
+    return trimmed.length === 0 ? `/${name}` : `/${trimmed}/${name}`;
+}
+/**
+ * Names the query a `RunQuery` call resolved to, as both a display string and a structured
+ * {@link DataAccessIdentity}.
+ *
+ * A query name is not unique on its own — name and category path identify a query together
+ * — so the display form is category-qualified.
+ *
+ * Precedence mirrors how `RunQuery` itself resolves: `QueryID` wins and `QueryName` is
+ * ignored when both are supplied, so the ID is reported as the identity and the supplied
+ * name is kept only as a label. `identity` retains every part the caller passed, so a
+ * correlation by name and path still works when an ID drove the resolution.
+ */
+export function ResolveQueryTarget(params) {
+    // `identity` records what the caller supplied, so a correlation against declared
+    // requirements can match on name+categoryPath even when an ID drove the resolution.
+    const identity = {};
+    if (params.QueryID)
+        identity.queryId = params.QueryID;
+    if (params.QueryName)
+        identity.queryName = params.QueryName;
+    if (params.CategoryPath)
+        identity.categoryPath = params.CategoryPath;
+    if (params.QueryID) {
+        return {
+            target: params.QueryName
+                ? `${params.QueryName} (resolved by QueryID ${params.QueryID})`
+                : `QueryID ${params.QueryID}`,
+            identity,
+        };
+    }
+    if (params.QueryName) {
+        if (params.CategoryPath) {
+            return { target: joinCategoryPath(params.CategoryPath, params.QueryName), identity };
+        }
+        if (params.CategoryID) {
+            return { target: `${params.QueryName} (CategoryID ${params.CategoryID})`, identity };
+        }
+        // Neither qualifier given: the name is all the caller supplied, so it is all we can
+        // report — flagged, because this is the ambiguous case rather than a resolved identity.
+        return { target: `${params.QueryName} (uncategorized)`, identity };
+    }
+    return { target: 'unknown', identity };
+}
+/** Display-only form of {@link ResolveQueryTarget}. */
+export function DescribeQueryTarget(params) {
+    return ResolveQueryTarget(params).target;
+}
+/**
+ * Names the view a `RunView` call resolved to, as both a display string and a structured
+ * {@link DataAccessIdentity}.
+ *
+ * Follows `RunViewParams`' own precedence — `ViewEntity` → `ViewID` → `ViewName` →
+ * `EntityName` — where each earlier field causes the later ones to be ignored. Reporting
+ * `EntityName` regardless would name something the call did not resolve by.
+ */
+export function ResolveViewTarget(params) {
+    const identity = {};
+    if (params.EntityName)
+        identity.entityName = params.EntityName;
+    if (params.ViewID)
+        identity.viewId = params.ViewID;
+    if (params.ViewName)
+        identity.viewName = params.ViewName;
+    const entitySuffix = params.EntityName ? ` on ${params.EntityName}` : '';
+    if (params.ViewEntity)
+        return { target: `saved view via ViewEntity${entitySuffix}`, identity };
+    if (params.ViewID)
+        return { target: `ViewID ${params.ViewID}${entitySuffix}`, identity };
+    if (params.ViewName)
+        return { target: `view "${params.ViewName}"${entitySuffix}`, identity };
+    return { target: params.EntityName || 'unknown', identity };
+}
+/** Display-only form of {@link ResolveViewTarget}. */
+export function DescribeViewTarget(params) {
+    return ResolveViewTarget(params).target;
+}
 /**
  * ComponentRunner that uses the actual React runtime via Playwright UMD bundle
  */
@@ -94,7 +229,7 @@ export class ComponentRunner {
     /**
      * Lint component code before execution
      */
-    async lintComponent(componentCode, componentName, componentSpec, isRootComponent, contextUser, options) {
+    async LintComponent(componentCode, componentName, componentSpec, isRootComponent, contextUser, options) {
         const lintResult = await ComponentLinter.lintComponent(componentCode, componentName, componentSpec, isRootComponent, contextUser, false, // debugMode
         options);
         const hasErrors = lintResult.violations.some(v => v.severity === 'critical' || v.severity === 'high');
@@ -103,12 +238,17 @@ export class ComponentRunner {
             hasErrors
         };
     }
-    async executeComponent(options) {
+    /** @deprecated Use {@link LintComponent}. */
+    async lintComponent(componentCode, componentName, componentSpec, isRootComponent, contextUser, options) {
+        return this.LintComponent(componentCode, componentName, componentSpec, isRootComponent, contextUser, options);
+    }
+    async ExecuteComponent(options) {
         const startTime = Date.now();
         const errors = [];
         const warnings = [];
         const consoleLogs = [];
         const dataErrors = []; // Track data access errors from RunView/RunQuery
+        const dataAccess = []; // Track every data call: target, rows, cap state
         let renderCount = 0;
         const debug = options.debug !== false; // Default to true for debugging
         const globalTimeout = options.timeout || 30000; // Default 30 seconds total timeout
@@ -178,7 +318,7 @@ export class ComponentRunner {
             // Set up console logging
             this.setupConsoleLogging(page, consoleLogs, warnings);
             // Expose MJ utilities to the page
-            await this.exposeMJUtilities(page, options, dataErrors, debug);
+            await this.exposeMJUtilities(page, options, dataErrors, dataAccess, debug);
             if (debug) {
                 console.log('📤 NODE: About to call page.evaluate with:');
                 console.log('  - spec.name:', options.componentSpec.name);
@@ -682,6 +822,10 @@ export class ComponentRunner {
                             super(props);
                             this.state = { hasError: false, error: null };
                         }
+                        // React reads this static into a local and calls it UNBOUND
+                        // (`var f = fiber.type.getDerivedStateFromError; f(error)`), so a stub
+                        // that forwards through `this` throws before the capture below can run —
+                        // the harness would then miss the user component's error entirely.
                         static getDerivedStateFromError(error) {
                             // Capture the actual error message IMMEDIATELY
                             window.__testHarnessRuntimeErrors = window.__testHarnessRuntimeErrors || [];
@@ -907,9 +1051,13 @@ export class ComponentRunner {
             try {
                 // Try to get HTML content with a reasonable size limit
                 html = await page.content();
-                // Check if HTML is excessively large (>100MB is suspicious)
+                // Backstop only — the row ceilings on the data bridges (see DataCapOptions) stop a
+                // runaway result set before it reaches the DOM. Deliberately far below Node's ~536MB
+                // string limit: the harness shares a heap with the host process, so by the time a
+                // page serializes to tens of megabytes the run is pathological whether or not the
+                // string itself fits.
                 const htmlSizeEstimate = Buffer.byteLength(html, 'utf8');
-                const maxSafeSize = 100 * 1024 * 1024; // 100MB
+                const maxSafeSize = 25 * 1024 * 1024; // 25MB
                 if (htmlSizeEstimate > maxSafeSize) {
                     console.warn(`⚠️ HTML content is very large (${Math.round(htmlSizeEstimate / 1024 / 1024)}MB). Truncating to prevent crashes.`);
                     // Truncate to a safe size
@@ -1047,23 +1195,40 @@ export class ComponentRunner {
             // Medium, low, and warning severity don't affect this metric
             const nonCrashCriticalHighErrors = allErrorViolations.filter(e => (e.severity === 'critical' || e.severity === 'high') && e.rule !== 'browser-crash');
             const codeExecutionSuccess = nonCrashCriticalHighErrors.length === 0;
+            // Surface capped data calls as their own warnings, so a downstream evaluator does not
+            // read a deliberately truncated render as a defect.
+            const capWarnings = dataAccess
+                .filter(d => d.capped)
+                .map(d => ({
+                message: `Data capped: ${d.kind} "${d.target}" returned ${d.rowsReturned} of ${d.totalRowCount} rows ` +
+                    `(harness ceiling ${d.appliedMaxRows}). Values aggregated in the component from this ` +
+                    `result are computed over partial data.`,
+                severity: 'medium',
+                rule: 'data-row-cap',
+                line: 0,
+                column: 0
+            }));
             const result = {
                 success: success && dataErrors.length === 0 && criticalWarningViolations.length === 0, // Fail on critical warnings too
                 html,
                 errors: allErrorViolations,
                 browserCrash: hasBrowserCrash,
-                warnings: regularWarnings.map(w => ({
-                    message: w,
-                    severity: 'low',
-                    rule: 'warning',
-                    line: 0,
-                    column: 0
-                })),
+                warnings: [
+                    ...regularWarnings.map(w => ({
+                        message: w,
+                        severity: 'low',
+                        rule: 'warning',
+                        line: 0,
+                        column: 0
+                    })),
+                    ...capWarnings,
+                ],
                 console: consoleLogs,
                 screenshot,
                 executionTime: Date.now() - startTime,
                 renderCount,
                 codeExecutionSuccess,
+                dataAccess,
                 sourceMaps: this._lastSourceMaps,
             };
             if (debug) {
@@ -1134,7 +1299,9 @@ export class ComponentRunner {
                 executionTime: Date.now() - startTime,
                 renderCount,
                 browserCrash: hasBrowserCrash,
-                codeExecutionSuccess
+                codeExecutionSuccess,
+                // Data calls made before the failure still describe what the component reached for.
+                dataAccess,
             };
             if (debug) {
                 if (hasBrowserCrash && codeExecutionSuccess) {
@@ -1163,6 +1330,10 @@ export class ComponentRunner {
             }
         }
     }
+    /** @deprecated Use {@link ExecuteComponent}. */
+    async executeComponent(options) {
+        return this.ExecuteComponent(options);
+    }
     /**
      * Load core runtime libraries into the page (React, ReactDOM, Babel, MJRuntime)
      * Component-specific libraries are loaded by the runtime's ComponentCompiler
@@ -1880,7 +2051,10 @@ export class ComponentRunner {
     /**
      * Expose MJ utilities to the browser context
      */
-    async exposeMJUtilities(page, options, dataErrors, debug = false) {
+    async exposeMJUtilities(page, options, dataErrors, dataAccess, debug = false) {
+        // Row ceilings for this run, resolved once rather than per call.
+        const viewCeiling = options.dataCaps?.runViewMaxRows ?? DEFAULT_RUN_VIEW_MAX_ROWS;
+        const queryCeiling = options.dataCaps?.runQueryMaxRows ?? DEFAULT_RUN_QUERY_MAX_ROWS;
         // Don't check if already exposed - we always start fresh after goto('about:blank')
         // The page.exposeFunction calls need to be made for each new page instance
         // Serialize contextUser to pass to the browser context
@@ -1966,12 +2140,16 @@ export class ComponentRunner {
             }
         });
         await page.exposeFunction('__mjRunView', async (params) => {
+            const viewTarget = ResolveViewTarget(params);
+            const maxRows = ResolveDataCapMaxRows(params.MaxRows, viewCeiling);
+            const startedAt = Date.now();
             try {
-                const result = await util.rv.RunView(params, options.contextUser);
+                const result = await util.rv.RunView({ ...params, MaxRows: maxRows.applied }, options.contextUser);
+                const record = BuildDataAccessRecord('RunView', viewTarget, result, maxRows, Date.now() - startedAt);
+                dataAccess.push(record);
                 // Debug logging for successful calls
                 if (debug) {
-                    const rowCount = result.Results?.length || 0;
-                    console.log(`💾 RunView SUCCESS: Entity="${params.EntityName}" Rows=${rowCount}`);
+                    console.log(`💾 RunView SUCCESS: View="${viewTarget.target}" Rows=${record.rowsReturned}${DescribeDataCap(record)}`);
                     if (params.ExtraFilter) {
                         console.log(`   Filter: ${params.ExtraFilter}`);
                     }
@@ -1980,36 +2158,53 @@ export class ComponentRunner {
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);
+                dataAccess.push({
+                    kind: 'RunView', target: viewTarget.target, identity: viewTarget.identity, rowsReturned: 0, capped: false,
+                    appliedMaxRows: maxRows.applied, requestedMaxRows: maxRows.requested,
+                    durationMs: Date.now() - startedAt, error: errorMessage,
+                });
                 // Debug logging for errors
                 if (debug) {
-                    console.log(`❌ RunView FAILED: Entity="${params.EntityName || 'unknown'}"`);
+                    console.log(`❌ RunView FAILED: View="${viewTarget.target}"`);
                     console.log(`   Error: ${errorMessage}`);
                 }
                 else {
                     console.error('Error in __mjRunView:', errorMessage);
                 }
                 // Collect this error for the test report
-                dataErrors.push(`RunView error: ${errorMessage} (Entity: ${params.EntityName || 'unknown'})`);
+                dataErrors.push(`RunView error: ${errorMessage} (View: ${viewTarget.target})`);
                 // Return error result that won't crash the component
                 return { Success: false, ErrorMessage: errorMessage, Results: [] };
             }
         });
         await page.exposeFunction('__mjRunViews', async (params) => {
+            const perCallMaxRows = params.map(p => ResolveDataCapMaxRows(p.MaxRows, viewCeiling));
+            const startedAt = Date.now();
             try {
-                const results = await util.rv.RunViews(params, options.contextUser);
+                const results = await util.rv.RunViews(params.map((p, i) => ({ ...p, MaxRows: perCallMaxRows[i].applied })), options.contextUser);
+                // One record per view in the batch — a batch that partially returns data is a
+                // meaningfully different signal from one that returns none.
+                const elapsed = Date.now() - startedAt;
+                const records = params.map((p, i) => BuildDataAccessRecord('RunViews', ResolveViewTarget(p), results[i], perCallMaxRows[i], elapsed));
+                records.forEach(r => dataAccess.push(r));
                 // Debug logging for successful calls
                 if (debug) {
                     console.log(`💾 RunViews SUCCESS: ${params.length} queries executed`);
-                    params.forEach((p, i) => {
-                        const rowCount = results[i]?.Results?.length || 0;
-                        console.log(`   [${i + 1}] Entity="${p.EntityName}" Rows=${rowCount}`);
+                    records.forEach((r, i) => {
+                        console.log(`   [${i + 1}] Entity="${r.target}" Rows=${r.rowsReturned}${DescribeDataCap(r)}`);
                     });
                 }
                 return results;
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                const entities = params.map(p => p.EntityName || 'unknown').join(', ');
+                const entities = params.map(p => DescribeViewTarget(p)).join(', ');
+                // RunViews fails as a batch, so every view in it failed.
+                params.forEach((p, i) => dataAccess.push({
+                    kind: 'RunViews', ...ResolveViewTarget(p), rowsReturned: 0, capped: false,
+                    appliedMaxRows: perCallMaxRows[i].applied, requestedMaxRows: perCallMaxRows[i].requested,
+                    durationMs: Date.now() - startedAt, error: errorMessage,
+                }));
                 // Debug logging for errors
                 if (debug) {
                     console.log(`❌ RunViews FAILED: Entities=[${entities}]`);
@@ -2025,13 +2220,16 @@ export class ComponentRunner {
             }
         });
         await page.exposeFunction('__mjRunQuery', async (params) => {
+            const queryIdentifier = ResolveQueryTarget(params);
+            const maxRows = ResolveDataCapMaxRows(params.MaxRows, queryCeiling);
+            const startedAt = Date.now();
             try {
-                const result = await util.rq.RunQuery(params, options.contextUser);
+                const result = await util.rq.RunQuery({ ...params, MaxRows: maxRows.applied }, options.contextUser);
+                const record = BuildDataAccessRecord('RunQuery', queryIdentifier, result, maxRows, Date.now() - startedAt);
+                dataAccess.push(record);
                 // Debug logging for successful calls
                 if (debug) {
-                    const queryIdentifier = params.QueryName || params.QueryID || 'unknown';
-                    const rowCount = result.Results?.length || 0;
-                    console.log(`💾 RunQuery SUCCESS: Query="${queryIdentifier}" Rows=${rowCount}`);
+                    console.log(`💾 RunQuery SUCCESS: Query="${queryIdentifier.target}" Rows=${record.rowsReturned}${DescribeDataCap(record)}`);
                     if (params.Parameters && Object.keys(params.Parameters).length > 0) {
                         console.log(`   Parameters:`, params.Parameters);
                     }
@@ -2040,17 +2238,21 @@ export class ComponentRunner {
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                const queryIdentifier = params.QueryName || params.QueryID || 'unknown';
+                dataAccess.push({
+                    kind: 'RunQuery', target: queryIdentifier.target, identity: queryIdentifier.identity, rowsReturned: 0, capped: false,
+                    appliedMaxRows: maxRows.applied, requestedMaxRows: maxRows.requested,
+                    durationMs: Date.now() - startedAt, error: errorMessage,
+                });
                 // Debug logging for errors
                 if (debug) {
-                    console.log(`❌ RunQuery FAILED: Query="${queryIdentifier}"`);
+                    console.log(`❌ RunQuery FAILED: Query="${queryIdentifier.target}"`);
                     console.log(`   Error: ${errorMessage}`);
                 }
                 else {
                     console.error('Error in __mjRunQuery:', errorMessage);
                 }
                 // Collect this error for the test report
-                dataErrors.push(`RunQuery error: ${errorMessage} (Query: ${queryIdentifier})`);
+                dataErrors.push(`RunQuery error: ${errorMessage} (Query: ${queryIdentifier.target})`);
                 // Return error result that won't crash the component
                 return { Success: false, ErrorMessage: errorMessage, Results: [] };
             }
@@ -2116,7 +2318,11 @@ export class ComponentRunner {
             const VectorService = window.MJReactRuntime?.SimpleVectorService ||
                 class {
                     // Stub implementation if not available
-                    cosineSimilarity(_a, _b) { return 0; }
+                    CosineSimilarity(_a, _b) { return 0; }
+                    /** @deprecated Use {@link CosineSimilarity}. */
+                    cosineSimilarity(_a, _b) {
+                        return this.CosineSimilarity(_a, _b);
+                    }
                 };
             window.__mjUtilities = {
                 md: {