sentinel-qa 0.0.1

package/dist/event-validation/validator.js

@@ -0,0 +1,97 @@
+/**
+ * Check if a value matches the expected type string.
+ */
+function matchesType(value, expectedType) {
+    switch (expectedType) {
+        case 'string':
+            return typeof value === 'string';
+        case 'number':
+            return typeof value === 'number';
+        case 'boolean':
+            return typeof value === 'boolean';
+        default:
+            return true; // unknown type = allow
+    }
+}
+/**
+ * Validate captured events against an event spec.
+ *
+ * For each expected event in the spec:
+ * - Check if a matching captured event exists (by event_name)
+ * - If found, validate required_params (presence + type)
+ * - If not found, mark as missing
+ *
+ * Any captured events not in the spec are listed as unexpected.
+ */
+export function validateEvents(spec, captured) {
+    const results = [];
+    const matchedCapturedIndices = new Set();
+    for (const expected of spec) {
+        // Find the first matching captured event by event_name
+        const capturedIndex = captured.findIndex((c, i) => c.event_name === expected.event_name && !matchedCapturedIndices.has(i));
+        if (capturedIndex === -1) {
+            // Missing event
+            results.push({
+                event_name: expected.event_name,
+                trigger: expected.trigger,
+                status: 'missing',
+            });
+            continue;
+        }
+        matchedCapturedIndices.add(capturedIndex);
+        const capturedEvent = captured[capturedIndex];
+        // Validate required params
+        const paramErrors = [];
+        if (expected.required_params) {
+            for (const [paramName, expectedType] of Object.entries(expected.required_params)) {
+                if (!(paramName in capturedEvent.params)) {
+                    paramErrors.push({
+                        param: paramName,
+                        expected: expectedType,
+                        got: 'missing',
+                    });
+                }
+                else if (!matchesType(capturedEvent.params[paramName], expectedType)) {
+                    paramErrors.push({
+                        param: paramName,
+                        expected: expectedType,
+                        got: typeof capturedEvent.params[paramName],
+                    });
+                }
+            }
+        }
+        if (paramErrors.length > 0) {
+            results.push({
+                event_name: expected.event_name,
+                trigger: expected.trigger,
+                status: 'param_error',
+                param_errors: paramErrors,
+            });
+        }
+        else {
+            results.push({
+                event_name: expected.event_name,
+                trigger: expected.trigger,
+                status: 'matched',
+            });
+        }
+    }
+    // Find unexpected events (captured but not in spec)
+    const specEventNames = new Set(spec.map((s) => s.event_name));
+    const unexpected = captured
+        .filter((c, i) => !matchedCapturedIndices.has(i) && !specEventNames.has(c.event_name))
+        .map((c) => ({ event_name: c.event_name, params: c.params }));
+    const matched = results.filter((r) => r.status === 'matched').length;
+    const missing = results.filter((r) => r.status === 'missing').length;
+    const paramErrorCount = results.filter((r) => r.status === 'param_error').length;
+    return {
+        total_expected: spec.length,
+        matched,
+        missing,
+        param_errors: paramErrorCount,
+        unexpected_count: unexpected.length,
+        results,
+        unexpected,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/event-validation/validator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { AppRegistry } from './registry/registry.js';
+import { TestStore } from './store/test-store.js';
+import { TestStatusStore } from './store/test-status-store.js';
+import { ReportStore } from './report/report-store.js';
+import { logger } from './utils/logger.js';
+import { registerListApps } from './tools/list-apps.js';
+import { registerGetSelectors } from './tools/get-selectors.js';
+import { registerSaveTests } from './tools/save-tests.js';
+import { registerRunTests } from './tools/run-tests.js';
+import { registerGetReport } from './tools/get-report.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function main() {
+    const registryDir = process.env.SENTINEL_REGISTRY_DIR ?? resolve(__dirname, '..', '..', '..', 'registry');
+    const registry = new AppRegistry(registryDir);
+    await registry.load();
+    const store = new TestStore();
+    const reportsDir = process.env.SENTINEL_REPORTS_DIR ?? resolve(__dirname, '..', '..', '..', 'reports');
+    const reportStore = new ReportStore(reportsDir);
+    const testsDir = process.env.SENTINEL_TESTS_DIR ?? resolve(__dirname, '..', '..', '..', 'tests');
+    const statusStore = new TestStatusStore(testsDir);
+    const server = new McpServer({
+        name: 'sentinel-qa',
+        version: '0.1.0',
+    });
+    registerListApps(server, registry);
+    registerGetSelectors(server, registry);
+    registerSaveTests(server, store);
+    registerRunTests(server, store, registry, reportStore, statusStore);
+    registerGetReport(server, reportStore);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('sentinel-qa MCP server started (stdio)');
+}
+main().catch((err) => {
+    logger.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GACf,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAExF,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEtB,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;IAE9B,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACtF,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,CAAC;IAEhD,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClF,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACpE,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/registry/registry.d.ts

@@ -0,0 +1,12 @@
+import type { AppEntry, SelectorMap, EventSpecConfig } from './types.js';
+export declare class AppRegistry {
+    private apps;
+    private registryDir;
+    constructor(registryDir: string);
+    load(): Promise<void>;
+    listApps(): AppEntry[];
+    getApp(appId: string): AppEntry | undefined;
+    getSelectors(appId: string): Promise<SelectorMap | null>;
+    getEventSpec(appId: string): Promise<EventSpecConfig | null>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErF,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAIzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,QAAQ,IAAI,QAAQ,EAAE;IAItB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIrC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAYxD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAWnE"}

package/dist/registry/registry.js

@@ -0,0 +1,51 @@
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { loadYaml } from '../utils/yaml-loader.js';
+import { logger } from '../utils/logger.js';
+export class AppRegistry {
+    apps = [];
+    registryDir;
+    constructor(registryDir) {
+        this.registryDir = registryDir;
+    }
+    async load() {
+        const appsPath = resolve(this.registryDir, 'apps.yaml');
+        if (!existsSync(appsPath)) {
+            logger.warn(`apps.yaml not found at ${appsPath}`);
+            this.apps = [];
+            return;
+        }
+        const config = await loadYaml(appsPath);
+        this.apps = config.apps ?? [];
+        logger.info(`Loaded ${this.apps.length} app(s) from registry`);
+    }
+    listApps() {
+        return this.apps;
+    }
+    getApp(appId) {
+        return this.apps.find((a) => a.id === appId);
+    }
+    async getSelectors(appId) {
+        const app = this.getApp(appId);
+        if (!app?.context?.selectors)
+            return null;
+        const selectorPath = resolve(this.registryDir, app.context.selectors);
+        if (!existsSync(selectorPath)) {
+            logger.warn(`Selector file not found: ${selectorPath}`);
+            return null;
+        }
+        return loadYaml(selectorPath);
+    }
+    async getEventSpec(appId) {
+        const app = this.getApp(appId);
+        if (!app?.context?.event_spec)
+            return null;
+        const specPath = resolve(this.registryDir, app.context.event_spec);
+        if (!existsSync(specPath)) {
+            logger.warn(`Event spec file not found: ${specPath}`);
+            return null;
+        }
+        return loadYaml(specPath);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,MAAM,OAAO,WAAW;IACd,IAAI,GAAe,EAAE,CAAC;IACtB,WAAW,CAAS;IAE5B,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAa,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM,uBAAuB,CAAC,CAAC;IACjE,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,QAAQ,CAAc,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU;YAAE,OAAO,IAAI,CAAC;QAE3C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,QAAQ,CAAkB,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/registry/types.d.ts

@@ -0,0 +1,28 @@
+export interface AppEntry {
+    id: string;
+    type: 'flutter' | 'web';
+    repo?: string;
+    url?: string;
+    prd?: string;
+    context?: {
+        selectors?: string;
+        event_spec?: string;
+    };
+}
+export interface AppsConfig {
+    apps: AppEntry[];
+}
+export type SelectorMap = Record<string, string>;
+export interface EventParam {
+    [paramName: string]: string;
+}
+export interface EventSpecEntry {
+    trigger: string;
+    event_name: string;
+    required_params?: EventParam;
+    optional_params?: EventParam;
+}
+export interface EventSpecConfig {
+    events: EventSpecEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,eAAe,CAAC,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B"}

package/dist/registry/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":""}

package/dist/report/markdown.d.ts

@@ -0,0 +1,13 @@
+import type { RunResult } from '@sentinel-qa/playwright-runner';
+import type { EventValidationResult } from '../event-validation/types.js';
+export interface ReportMeta {
+    appId: string;
+    suite: string;
+    platform: string;
+    timestamp: string;
+}
+/**
+ * Convert a RunResult into a Markdown report string.
+ */
+export declare function generateMarkdownReport(result: RunResult, meta: ReportMeta, eventValidation?: EventValidationResult): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/report/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/report/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,qBAAqB,GACtC,MAAM,CA2IR"}

package/dist/report/markdown.js

@@ -0,0 +1,137 @@
+function statusIcon(status) {
+    switch (status) {
+        case 'passed': return 'PASS';
+        case 'failed': return 'FAIL';
+        case 'timedOut': return 'TIMEOUT';
+        case 'skipped': return 'SKIP';
+    }
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(2)}s`;
+}
+/**
+ * Convert a RunResult into a Markdown report string.
+ */
+export function generateMarkdownReport(result, meta, eventValidation) {
+    const lines = [];
+    // Header
+    lines.push(`# Test Report: ${meta.appId}`);
+    lines.push('');
+    lines.push(`| Field | Value |`);
+    lines.push(`|-------|-------|`);
+    lines.push(`| App | ${meta.appId} |`);
+    lines.push(`| Suite | ${meta.suite} |`);
+    lines.push(`| Platform | ${meta.platform} |`);
+    lines.push(`| Timestamp | ${meta.timestamp} |`);
+    lines.push(`| Duration | ${formatDuration(result.duration)} |`);
+    lines.push('');
+    // Summary
+    lines.push('## Summary');
+    lines.push('');
+    lines.push(`| Total | Passed | Failed | Timed Out | Skipped |`);
+    lines.push(`|-------|--------|--------|-----------|---------|`);
+    lines.push(`| ${result.total} | ${result.passed} | ${result.failed} | ${result.timedOut} | ${result.skipped} |`);
+    lines.push('');
+    // Overall result
+    if (result.failed === 0 && result.timedOut === 0) {
+        lines.push('**Result: ALL PASSED**');
+    }
+    else {
+        lines.push(`**Result: ${result.failed + result.timedOut} FAILURE(S)**`);
+    }
+    lines.push('');
+    // Test details
+    lines.push('## Test Details');
+    lines.push('');
+    lines.push('| # | ID | Title | Status | Duration |');
+    lines.push('|---|-----|-------|--------|----------|');
+    result.tests.forEach((test, i) => {
+        lines.push(`| ${i + 1} | ${test.id} | ${test.title} | ${statusIcon(test.status)} | ${formatDuration(test.duration)} |`);
+    });
+    lines.push('');
+    // Failures detail
+    const failures = result.tests.filter((t) => t.status === 'failed' || t.status === 'timedOut');
+    if (failures.length > 0) {
+        lines.push('## Failures');
+        lines.push('');
+        for (const test of failures) {
+            lines.push(`### ${test.id}: ${test.title}`);
+            lines.push('');
+            lines.push(`- **Status**: ${statusIcon(test.status)}`);
+            lines.push(`- **Duration**: ${formatDuration(test.duration)}`);
+            if (test.error) {
+                lines.push(`- **Error**:`);
+                lines.push('```');
+                lines.push(test.error);
+                lines.push('```');
+            }
+            if (test.screenshotPath) {
+                lines.push(`- **Screenshot**: \`${test.screenshotPath}\``);
+            }
+            lines.push('');
+        }
+    }
+    // Event Validation (Data Log QA)
+    if (eventValidation) {
+        lines.push('## Event Validation (Data Log QA)');
+        lines.push('');
+        lines.push('| Expected | Matched | Missing | Param Errors | Unexpected |');
+        lines.push('|----------|---------|---------|--------------|------------|');
+        lines.push(`| ${eventValidation.total_expected} | ${eventValidation.matched} | ${eventValidation.missing} | ${eventValidation.param_errors} | ${eventValidation.unexpected_count} |`);
+        lines.push('');
+        if (eventValidation.missing === 0 && eventValidation.param_errors === 0 && eventValidation.unexpected_count === 0) {
+            lines.push('**Event Validation: ALL MATCHED**');
+        }
+        else {
+            lines.push('**Event Validation: ISSUES FOUND**');
+        }
+        lines.push('');
+        // Event details table
+        lines.push('### Event Results');
+        lines.push('');
+        lines.push('| Event | Trigger | Status |');
+        lines.push('|-------|---------|--------|');
+        for (const ev of eventValidation.results) {
+            const statusLabel = ev.status === 'matched' ? 'MATCHED'
+                : ev.status === 'missing' ? 'MISSING'
+                    : 'PARAM_ERROR';
+            lines.push(`| ${ev.event_name} | ${ev.trigger} | ${statusLabel} |`);
+        }
+        lines.push('');
+        // Param errors detail
+        const paramErrorResults = eventValidation.results.filter((r) => r.status === 'param_error');
+        if (paramErrorResults.length > 0) {
+            lines.push('### Parameter Errors');
+            lines.push('');
+            for (const ev of paramErrorResults) {
+                lines.push(`**${ev.event_name}**:`);
+                lines.push('');
+                lines.push('| Parameter | Expected | Got |');
+                lines.push('|-----------|----------|-----|');
+                for (const err of ev.param_errors ?? []) {
+                    lines.push(`| ${err.param} | ${err.expected} | ${err.got} |`);
+                }
+                lines.push('');
+            }
+        }
+        // Unexpected events
+        if (eventValidation.unexpected.length > 0) {
+            lines.push('### Unexpected Events');
+            lines.push('');
+            lines.push('| Event | Params |');
+            lines.push('|-------|--------|');
+            for (const ev of eventValidation.unexpected) {
+                lines.push(`| ${ev.event_name} | ${JSON.stringify(ev.params)} |`);
+            }
+            lines.push('');
+        }
+    }
+    // Footer
+    lines.push('---');
+    lines.push(`*Generated by sentinel-qa at ${meta.timestamp}*`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=markdown.js.map

package/dist/report/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/report/markdown.ts"],"names":[],"mappings":"AAUA,SAAS,UAAU,CAAC,MAA4B;IAC9C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC;QAC7B,KAAK,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC;QAC7B,KAAK,UAAU,CAAC,CAAC,OAAO,SAAS,CAAC;QAClC,KAAK,SAAS,CAAC,CAAC,OAAO,MAAM,CAAC;IAChC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,EAAU;IAChC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,IAAgB,EAChB,eAAuC;IAEvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS;IACT,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,gBAAgB,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;IACjH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,iBAAiB;IACjB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,eAAe,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,eAAe;IACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAEtD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC/B,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAC5G,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kBAAkB;IAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CACxD,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,mBAAmB,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YAC7D,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,cAAc,MAAM,eAAe,CAAC,OAAO,MAAM,eAAe,CAAC,OAAO,MAAM,eAAe,CAAC,YAAY,MAAM,eAAe,CAAC,gBAAgB,IAAI,CAAC,CAAC;QACtL,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,eAAe,CAAC,OAAO,KAAK,CAAC,IAAI,eAAe,CAAC,YAAY,KAAK,CAAC,IAAI,eAAe,CAAC,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAClH,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,sBAAsB;QACtB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAE3C,KAAK,MAAM,EAAE,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;gBACrD,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;oBACrC,CAAC,CAAC,aAAa,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,MAAM,EAAE,CAAC,OAAO,MAAM,WAAW,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,sBAAsB;QACtB,MAAM,iBAAiB,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;QAC5F,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEf,KAAK,MAAM,EAAE,IAAI,iBAAiB,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,KAAK,CAAC,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;gBAC7C,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;gBAC7C,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;gBAChE,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,eAAe,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACjC,KAAK,MAAM,EAAE,IAAI,eAAe,CAAC,UAAU,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,SAAS;IACT,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/report/report-store.d.ts

@@ -0,0 +1,28 @@
+import type { RunResult } from '@sentinel-qa/playwright-runner';
+import type { ReportMeta } from './markdown.js';
+import type { EventValidationResult } from '../event-validation/types.js';
+/**
+ * Manages report storage on disk.
+ * Reports are saved to: <reportsDir>/<appId>/<timestamp>/report.md
+ */
+export declare class ReportStore {
+    private reportsDir;
+    constructor(reportsDir: string);
+    /**
+     * Save a test run result as a Markdown report.
+     * Returns the absolute path to the saved report file.
+     */
+    save(result: RunResult, meta: Omit<ReportMeta, 'timestamp'>, eventValidation?: EventValidationResult): Promise<string>;
+    /**
+     * Get the latest report for an app.
+     * Returns the Markdown content and path, or null if no reports exist.
+     */
+    getLatest(appId: string): Promise<{
+        markdown: string;
+        path: string;
+        jsonResult: RunResult & {
+            meta: ReportMeta;
+        };
+    } | null>;
+}
+//# sourceMappingURL=report-store.d.ts.map

package/dist/report/report-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-store.d.ts","sourceRoot":"","sources":["../../src/report/report-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAG1E;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACG,IAAI,CACR,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EACnC,eAAe,CAAC,EAAE,qBAAqB,GACtC,OAAO,CAAC,MAAM,CAAC;IAwBlB;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,SAAS,GAAG;YAAE,IAAI,EAAE,UAAU,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CA8BjI"}

package/dist/report/report-store.js

@@ -0,0 +1,69 @@
+import { mkdir, writeFile, readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { generateMarkdownReport } from './markdown.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Manages report storage on disk.
+ * Reports are saved to: <reportsDir>/<appId>/<timestamp>/report.md
+ */
+export class ReportStore {
+    reportsDir;
+    constructor(reportsDir) {
+        this.reportsDir = reportsDir;
+    }
+    /**
+     * Save a test run result as a Markdown report.
+     * Returns the absolute path to the saved report file.
+     */
+    async save(result, meta, eventValidation) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const fullMeta = { ...meta, timestamp };
+        const reportDir = join(this.reportsDir, meta.appId, timestamp);
+        await mkdir(reportDir, { recursive: true });
+        // Save Markdown report
+        const markdown = generateMarkdownReport(result, fullMeta, eventValidation);
+        const mdPath = join(reportDir, 'report.md');
+        await writeFile(mdPath, markdown, 'utf-8');
+        // Save raw JSON alongside for programmatic access
+        const jsonPath = join(reportDir, 'result.json');
+        const jsonData = { ...result, meta: fullMeta };
+        if (eventValidation) {
+            jsonData.event_validation = eventValidation;
+        }
+        await writeFile(jsonPath, JSON.stringify(jsonData, null, 2), 'utf-8');
+        logger.info(`Report saved: ${mdPath}`);
+        return mdPath;
+    }
+    /**
+     * Get the latest report for an app.
+     * Returns the Markdown content and path, or null if no reports exist.
+     */
+    async getLatest(appId) {
+        const appDir = join(this.reportsDir, appId);
+        if (!existsSync(appDir))
+            return null;
+        const entries = await readdir(appDir);
+        if (entries.length === 0)
+            return null;
+        // Sort by name (timestamp-based, so alphabetical = chronological)
+        entries.sort();
+        const latest = entries[entries.length - 1];
+        const reportDir = join(appDir, latest);
+        const mdPath = join(reportDir, 'report.md');
+        const jsonPath = join(reportDir, 'result.json');
+        if (!existsSync(mdPath))
+            return null;
+        const markdown = await readFile(mdPath, 'utf-8');
+        let jsonResult;
+        try {
+            const raw = await readFile(jsonPath, 'utf-8');
+            jsonResult = JSON.parse(raw);
+        }
+        catch {
+            jsonResult = null;
+        }
+        return { markdown, path: mdPath, jsonResult };
+    }
+}
+//# sourceMappingURL=report-store.js.map

package/dist/report/report-store.js.map

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

package/dist/schemas/tools.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export declare const getSelectorsSchema: {
+    app_id: z.ZodString;
+};
+export declare const saveTestsSchema: {
+    app_id: z.ZodString;
+    test_cases: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        confidence: z.ZodNumber;
+        status: z.ZodEnum<["approved", "pending"]>;
+        platform: z.ZodArray<z.ZodEnum<["flutter", "web"]>, "many">;
+        code: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        status: "approved" | "pending";
+        platform: ("flutter" | "web")[];
+        title: string;
+        code: string;
+        confidence: number;
+    }, {
+        id: string;
+        status: "approved" | "pending";
+        platform: ("flutter" | "web")[];
+        title: string;
+        code: string;
+        confidence: number;
+    }>, "many">;
+};
+export declare const runTestsSchema: {
+    app_id: z.ZodString;
+    suite: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
+    validate_events: z.ZodOptional<z.ZodBoolean>;
+    include_quarantine: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const getReportSchema: {
+    app_id: z.ZodString;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/schemas/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/schemas/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;CAY3B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;CAM1B,CAAC;AAEF,eAAO,MAAM,eAAe;;CAE3B,CAAC"}

package/dist/schemas/tools.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export const getSelectorsSchema = {
+    app_id: z.string().describe('App ID from registry'),
+};
+export const saveTestsSchema = {
+    app_id: z.string().describe('App ID'),
+    test_cases: z.array(z.object({
+        id: z.string(),
+        title: z.string(),
+        confidence: z.number(),
+        status: z.enum(['approved', 'pending']),
+        platform: z.array(z.enum(['flutter', 'web'])),
+        code: z.string().describe('Executable test code'),
+    })),
+};
+export const runTestsSchema = {
+    app_id: z.string().describe('App ID'),
+    suite: z.string().optional().describe('Test suite name'),
+    platform: z.enum(['web', 'ios', 'android']).optional().describe('Target platform'),
+    validate_events: z.boolean().optional().describe('Enable data log QA — validate analytics events against spec (default: false)'),
+    include_quarantine: z.boolean().optional().describe('Include quarantined tests in execution (default: false)'),
+};
+export const getReportSchema = {
+    app_id: z.string().describe('App ID'),
+};
+//# sourceMappingURL=tools.js.map

package/dist/schemas/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/schemas/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACpD,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,KAAK,CACjB,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACvC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAClD,CAAC,CACH;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAClF,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IAChI,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CAC/G,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;CACtC,CAAC"}