@futdevpro/dynamo-e2e 1.18.10 → 1.18.12

package/build/_modules/game/game-seam.helper.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_GameSeam_Helper = void 0;
+const DEFAULT_ALLOWED_HOSTS = ['localhost', '127.0.0.1', '::1'];
+const KNOWN_CAPABILITIES = ['seed', 'state', 'clock', 'canvas', 'diagnostics'];
+/**
+ * Capability-gated adapter for an explicitly enabled browser game test seam.
+ *
+ * It never creates business state. Readiness is event-driven; timeout values are hard failure bounds, not fixed
+ * sleeps or polling intervals.
+ */
+class DyE2E_GameSeam_Helper {
+    page;
+    seamKey;
+    readyEventName;
+    optInStorageKey;
+    optInQueryParam;
+    timeoutMs;
+    allowedHosts;
+    requiredCapabilities;
+    constructor(page, options = {}) {
+        this.page = page;
+        this.seamKey = options.seamKey ?? '__dye2eGame';
+        this.readyEventName = options.readyEventName ?? 'dye2e:game-seam-ready';
+        this.optInStorageKey = options.optInStorageKey ?? 'dye2eGame';
+        this.optInQueryParam = options.optInQueryParam ?? 'dye2eGame';
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+        this.allowedHosts = (options.allowedHosts ?? DEFAULT_ALLOWED_HOSTS).map((host) => host.toLowerCase());
+        this.requiredCapabilities = options.requiredCapabilities ?? [];
+        if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
+            throw new Error(`[DyE2E_GameSeam_Helper] timeoutMs must be finite and positive; received ${this.timeoutMs}.`);
+        }
+        if (![this.seamKey, this.readyEventName, this.optInStorageKey, this.optInQueryParam].every(Boolean)) {
+            throw new Error('[DyE2E_GameSeam_Helper] Seam, event and opt-in names must be non-empty.');
+        }
+        if (this.allowedHosts.length === 0 || this.allowedHosts.some((host) => !host.trim())) {
+            throw new Error('[DyE2E_GameSeam_Helper] At least one non-empty allowed host is required.');
+        }
+    }
+    /** Enable the seam before navigation. Non-loopback hosts require an explicit allow-list entry. */
+    async enableForNavigation(targetUrl) {
+        this.assertAllowedHost(targetUrl);
+        await this.page.addInitScript((settings) => {
+            if (!settings.allowedHosts.includes(window.location.hostname.toLowerCase())) {
+                return;
+            }
+            try {
+                window.sessionStorage.setItem(settings.storageKey, '1');
+            }
+            catch {
+                // A query opt-in remains available when browser policy disables session storage.
+            }
+        }, { storageKey: this.optInStorageKey, allowedHosts: this.allowedHosts });
+    }
+    /** Add the explicit query opt-in while preserving existing query parameters. */
+    withOptIn(targetUrl) {
+        this.assertAllowedHost(targetUrl);
+        const parsed = new URL(targetUrl, 'http://localhost');
+        parsed.searchParams.set(this.optInQueryParam, '1');
+        return targetUrl.startsWith('/') ? `${parsed.pathname}${parsed.search}${parsed.hash}` : parsed.toString();
+    }
+    /** Wait for one readiness event, or return immediately if the seam is already installed. */
+    async waitForSeam() {
+        await this.page.evaluate(([key, eventName, timeoutMs]) => new Promise((resolve, reject) => {
+            let timeoutId;
+            const onReady = (event) => {
+                const detail = event.detail;
+                const detailKey = typeof detail === 'object' && detail !== null
+                    ? detail.seamKey
+                    : detail;
+                if (detailKey !== undefined && detailKey !== key) {
+                    return;
+                }
+                window.clearTimeout(timeoutId);
+                window.removeEventListener(eventName, onReady);
+                resolve();
+            };
+            timeoutId = window.setTimeout(() => {
+                window.removeEventListener(eventName, onReady);
+                reject(new Error(`[DyE2E_GameSeam_Helper] '${key}' did not dispatch '${eventName}' within ${timeoutMs}ms. `
+                    + 'Verify host allow-listing, explicit opt-in, seam installation and ready-event dispatch.'));
+            }, timeoutMs);
+            window.addEventListener(eventName, onReady);
+            if (window[key]) {
+                window.clearTimeout(timeoutId);
+                window.removeEventListener(eventName, onReady);
+                resolve();
+            }
+        }), [this.seamKey, this.readyEventName, this.timeoutMs]);
+        await this.requireCapabilities(this.requiredCapabilities);
+    }
+    async capabilities() {
+        return this.page.evaluate((settings) => {
+            const { key, knownCapabilities } = settings;
+            const seam = window[key];
+            if (!seam) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' is not installed.`);
+            }
+            if (!Array.isArray(seam.capabilities)) {
+                return [];
+            }
+            const invalid = seam.capabilities.filter((value) => !knownCapabilities.includes(value));
+            if (invalid.length > 0) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' declares unknown capabilities: ${invalid.join(', ')}.`);
+            }
+            return [...new Set(seam.capabilities)];
+        }, { key: this.seamKey, knownCapabilities: KNOWN_CAPABILITIES });
+    }
+    async snapshot() {
+        return this.invoke('diagnostics', 'getSnapshot');
+    }
+    async installSeed(seed) {
+        if ((typeof seed !== 'string' && typeof seed !== 'number')
+            || (typeof seed === 'string' && !seed.trim())
+            || (typeof seed === 'number' && !Number.isFinite(seed))) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Seed must be a non-empty string or finite number; received '${seed}'.`);
+        }
+        const accepted = await this.invoke('seed', 'installSeed', seed);
+        if (accepted === false) {
+            throw new Error(`[DyE2E_GameSeam_Helper] The game rejected seed '${String(seed)}'.`);
+        }
+        const applied = await this.readSeed();
+        if (String(applied) !== String(seed)) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Seed read-back mismatch: requested '${String(seed)}', `
+                + `received '${String(applied)}'.`);
+        }
+    }
+    async readSeed() {
+        const seed = await this.invoke('seed', 'readSeed');
+        if ((typeof seed !== 'string' && typeof seed !== 'number')
+            || (typeof seed === 'string' && !seed.trim())
+            || (typeof seed === 'number' && !Number.isFinite(seed))) {
+            throw new Error(`[DyE2E_GameSeam_Helper] readSeed returned an invalid seed '${String(seed)}'.`);
+        }
+        return seed;
+    }
+    async exportState() {
+        const state = await this.invoke('state', 'exportState');
+        this.assertVersionedState(state);
+        return state;
+    }
+    async importState(state) {
+        this.assertVersionedState(state);
+        const accepted = await this.invoke('state', 'importState', state);
+        if (accepted === false) {
+            throw new Error('[DyE2E_GameSeam_Helper] The game rejected the imported state.');
+        }
+    }
+    async advanceClock(deltaMs) {
+        if (!Number.isFinite(deltaMs) || deltaMs <= 0) {
+            throw new Error(`[DyE2E_GameSeam_Helper] deltaMs must be finite and positive; received ${deltaMs}.`);
+        }
+        const accepted = await this.invoke('clock', 'advanceClock', deltaMs);
+        if (accepted === false) {
+            throw new Error(`[DyE2E_GameSeam_Helper] The game rejected manual clock advancement by ${deltaMs}ms.`);
+        }
+    }
+    async worldToScreen(point) {
+        if (!point || ![point.x, point.y].every(Number.isFinite)) {
+            throw new Error('[DyE2E_GameSeam_Helper] World coordinates must be finite numbers.');
+        }
+        const screenPoint = await this.invoke('canvas', 'worldToScreen', point);
+        if (!screenPoint || ![screenPoint.x, screenPoint.y].every(Number.isFinite)) {
+            throw new Error('[DyE2E_GameSeam_Helper] worldToScreen returned non-finite screen coordinates.');
+        }
+        return screenPoint;
+    }
+    /** One browser round-trip containing the evidence needed to diagnose deterministic game failures. */
+    async captureFailureArtifact() {
+        return this.page.evaluate(async (key) => {
+            const seam = window[key];
+            if (!seam) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' is not installed.`);
+            }
+            const capabilities = Array.isArray(seam.capabilities)
+                ? [...seam.capabilities]
+                : [];
+            const captureErrors = {};
+            const call = async (name) => {
+                const method = seam[name];
+                if (typeof method !== 'function') {
+                    return undefined;
+                }
+                try {
+                    return await method.call(seam);
+                }
+                catch (error) {
+                    captureErrors[name] = error instanceof Error ? error.message : String(error);
+                    return undefined;
+                }
+            };
+            return {
+                url: window.location.href,
+                viewport: { width: window.innerWidth, height: window.innerHeight },
+                capabilities,
+                seed: capabilities.includes('seed') ? await call('readSeed') : undefined,
+                state: capabilities.includes('state') ? await call('exportState') : undefined,
+                snapshot: capabilities.includes('diagnostics') ? await call('getSnapshot') : undefined,
+                diagnostics: capabilities.includes('diagnostics')
+                    ? await call('getDiagnostics')
+                    : undefined,
+                captureErrors: Object.keys(captureErrors).length > 0 ? captureErrors : undefined,
+            };
+        }, this.seamKey);
+    }
+    assertAllowedHost(targetUrl) {
+        const parsed = new URL(targetUrl, 'http://localhost');
+        if (!this.allowedHosts.includes(parsed.hostname)) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Refusing to enable a game seam on host '${parsed.hostname}'. `
+                + `Allowed hosts: ${this.allowedHosts.join(', ')}. Add a test host explicitly only when its server-side `
+                + 'seam guard is enabled.');
+        }
+    }
+    async requireCapabilities(required) {
+        if (required.length === 0) {
+            return;
+        }
+        const available = await this.capabilities();
+        const missing = required.filter((item) => !available.includes(item));
+        if (missing.length > 0) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Missing required capabilities: ${missing.join(', ')}. `
+                + `Available: ${available.join(', ') || '(none)'}.`);
+        }
+    }
+    assertVersionedState(state) {
+        if (!state || typeof state !== 'object') {
+            throw new Error('[DyE2E_GameSeam_Helper] A state snapshot must be an object with schemaVersion.');
+        }
+        const schemaVersion = state.schemaVersion;
+        if ((typeof schemaVersion !== 'string' && typeof schemaVersion !== 'number')
+            || String(schemaVersion).trim().length === 0
+            || (typeof schemaVersion === 'number' && !Number.isFinite(schemaVersion))) {
+            throw new Error('[DyE2E_GameSeam_Helper] A state snapshot must carry a non-empty schemaVersion.');
+        }
+    }
+    async invoke(capability, methodName, ...args) {
+        return this.page.evaluate(([key, requiredCapability, method, callArgs]) => {
+            const seam = window[key];
+            if (!seam) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' is not installed.`);
+            }
+            if (!Array.isArray(seam.capabilities) || !seam.capabilities.includes(requiredCapability)) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Method '${method}' requires '${requiredCapability}'.`);
+            }
+            const fn = seam[method];
+            if (typeof fn !== 'function') {
+                throw new Error(`[DyE2E_GameSeam_Helper] Capability '${requiredCapability}' declares missing method '${method}'.`);
+            }
+            return fn.apply(seam, callArgs);
+        }, [this.seamKey, capability, methodName, args]);
+    }
+}
+exports.DyE2E_GameSeam_Helper = DyE2E_GameSeam_Helper;
+//# sourceMappingURL=game-seam.helper.js.map

package/build/_modules/game/game-seam.helper.js.map

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

package/build/_modules/game/index.d.ts

@@ -0,0 +1,4 @@
+export * from './_models/game-contracts.interface';
+export * from './game-seam.helper';
+export * from './journey-catalog.validator';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/game/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC"}

package/build/_modules/game/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./_models/game-contracts.interface"), exports);
+__exportStar(require("./game-seam.helper"), exports);
+__exportStar(require("./journey-catalog.validator"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/game/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAmD;AACnD,qDAAmC;AACnC,8DAA4C"}

package/build/_modules/game/journey-catalog.validator.d.ts

@@ -0,0 +1,5 @@
+import { DyE2E_GameJourneyCatalog_Validation_Interface } from './_models/game-contracts.interface';
+/** Validate cross-feature, state-carrying journey evidence without executing or manufacturing business state. */
+export declare function DyE2E_validateGameJourneyCatalog(candidate: unknown): DyE2E_GameJourneyCatalog_Validation_Interface;
+export declare function DyE2E_assertGameJourneyCatalog(catalog: unknown): void;
+//# sourceMappingURL=journey-catalog.validator.d.ts.map

package/build/_modules/game/journey-catalog.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-catalog.validator.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/journey-catalog.validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,6CAA6C,EAC9C,MAAM,oCAAoC,CAAC;AAa5C,iHAAiH;AACjH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,OAAO,GACjB,6CAA6C,CAmJ/C;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQrE"}

package/build/_modules/game/journey-catalog.validator.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_validateGameJourneyCatalog = DyE2E_validateGameJourneyCatalog;
+exports.DyE2E_assertGameJourneyCatalog = DyE2E_assertGameJourneyCatalog;
+const JOURNEY_VARIANTS = [
+    'happy-path',
+    'decline',
+    'partial',
+    'fallback',
+    'interruption-resume',
+    'access-limited',
+];
+const CLEANUP_MODES = ['hard-delete', 'restore-snapshot', 'reset-profile'];
+/** Validate cross-feature, state-carrying journey evidence without executing or manufacturing business state. */
+function DyE2E_validateGameJourneyCatalog(candidate) {
+    const findings = [];
+    const add = (path, code, message) => {
+        findings.push({ path, code, message });
+    };
+    if (!isRecord(candidate)) {
+        add('$', 'invalid-catalog', 'The journey catalog must be an object.');
+        return { valid: false, findings };
+    }
+    if (candidate.schemaVersion !== 1) {
+        add('$.schemaVersion', 'unsupported-schema', 'Only game journey catalog schemaVersion 1 is supported.');
+    }
+    if (!Array.isArray(candidate.features)) {
+        add('$.features', 'invalid-features', 'Features must be an array.');
+    }
+    if (!Array.isArray(candidate.journeys)) {
+        add('$.journeys', 'invalid-journeys', 'Journeys must be an array.');
+    }
+    if (!Array.isArray(candidate.requiredVariants)) {
+        add('$.requiredVariants', 'invalid-required-variants', 'Required variants must be an array.');
+    }
+    if (!Array.isArray(candidate.features)
+        || !Array.isArray(candidate.journeys)
+        || !Array.isArray(candidate.requiredVariants)) {
+        return { valid: false, findings };
+    }
+    const features = candidate.features;
+    const journeys = candidate.journeys;
+    const requiredVariants = candidate.requiredVariants;
+    const featureIds = new Set();
+    const journeyIds = new Set();
+    if (features.length < 2) {
+        add('$.features', 'missing-features', 'At least two journey-linked features are required.');
+    }
+    features.forEach((feature, index) => {
+        if (!isRecord(feature)) {
+            add(`$.features[${index}]`, 'invalid-feature', 'Each feature must be an object.');
+            return;
+        }
+        const featureId = feature.id;
+        if (typeof featureId !== 'string' || !featureId.trim()) {
+            add(`$.features[${index}].id`, 'empty-id', 'Feature id is required.');
+        }
+        else {
+            if (featureIds.has(featureId)) {
+                add(`$.features[${index}].id`, 'duplicate-id', `Duplicate feature id '${featureId}'.`);
+            }
+            featureIds.add(featureId);
+        }
+        if (!Array.isArray(feature.journeyIds) || feature.journeyIds.length === 0) {
+            add(`$.features[${index}].journeyIds`, 'missing-journeys', 'A feature must link to at least one journey.');
+        }
+        else {
+            validateUniqueNonEmptyStrings(feature.journeyIds, `$.features[${index}].journeyIds`, 'journey', add);
+        }
+    });
+    if (journeys.length === 0) {
+        add('$.journeys', 'missing-journeys', 'At least one executable journey is required.');
+    }
+    journeys.forEach((journey, index) => {
+        if (!isRecord(journey)) {
+            add(`$.journeys[${index}]`, 'invalid-journey', 'Each journey must be an object.');
+            return;
+        }
+        const journeyId = journey.id;
+        if (typeof journeyId !== 'string' || !journeyId.trim()) {
+            add(`$.journeys[${index}].id`, 'empty-id', 'Journey id is required.');
+        }
+        else {
+            if (journeyIds.has(journeyId)) {
+                add(`$.journeys[${index}].id`, 'duplicate-id', `Duplicate journey id '${journeyId}'.`);
+            }
+            journeyIds.add(journeyId);
+        }
+        validateJourney(journey, index, add);
+    });
+    if (!journeys.some((journey) => isRecord(journey) && journey.critical === true)) {
+        add('$.journeys', 'missing-critical-journey', 'At least one journey must be marked critical.');
+    }
+    journeys.forEach((journey, journeyIndex) => {
+        if (!isRecord(journey) || typeof journey.id !== 'string' || !Array.isArray(journey.featureIds)) {
+            return;
+        }
+        journey.featureIds.forEach((featureId) => {
+            if (typeof featureId !== 'string') {
+                return;
+            }
+            const feature = features.find((candidateFeature) => isRecord(candidateFeature) && candidateFeature.id === featureId);
+            if (!isRecord(feature)) {
+                add(`$.journeys[${journeyIndex}].featureIds`, 'unknown-feature', `Unknown feature '${featureId}'.`);
+            }
+            else if (!Array.isArray(feature.journeyIds) || !feature.journeyIds.includes(journey.id)) {
+                add(`$.features[${features.indexOf(feature)}].journeyIds`, 'missing-reverse-link', `Feature '${featureId}' does not link back to journey '${journey.id}'.`);
+            }
+        });
+    });
+    features.forEach((feature, featureIndex) => {
+        if (!isRecord(feature) || typeof feature.id !== 'string' || !Array.isArray(feature.journeyIds)) {
+            return;
+        }
+        feature.journeyIds.forEach((journeyId) => {
+            if (typeof journeyId !== 'string') {
+                return;
+            }
+            const journey = journeys.find((candidateJourney) => isRecord(candidateJourney) && candidateJourney.id === journeyId);
+            if (!isRecord(journey)) {
+                add(`$.features[${featureIndex}].journeyIds`, 'unknown-journey', `Unknown journey '${journeyId}'.`);
+            }
+            else if (!Array.isArray(journey.featureIds) || !journey.featureIds.includes(feature.id)) {
+                add(`$.journeys[${journeys.indexOf(journey)}].featureIds`, 'missing-reverse-link', `Journey '${journeyId}' does not link back to feature '${feature.id}'.`);
+            }
+        });
+    });
+    validateUniqueNonEmptyStrings(requiredVariants, '$.requiredVariants', 'required variant', add);
+    const presentVariants = new Set(journeys
+        .filter(isRecord)
+        .map((journey) => journey.variant)
+        .filter((variant) => typeof variant === 'string'));
+    requiredVariants.forEach((variant) => {
+        if (typeof variant !== 'string') {
+            return;
+        }
+        if (!JOURNEY_VARIANTS.includes(variant)) {
+            add('$.requiredVariants', 'unknown-variant', `Unknown required variant '${variant}'.`);
+        }
+        if (!presentVariants.has(variant)) {
+            add('$.requiredVariants', 'missing-variant', `No journey provides required variant '${variant}'.`);
+        }
+    });
+    return { valid: findings.length === 0, findings };
+}
+function DyE2E_assertGameJourneyCatalog(catalog) {
+    const result = DyE2E_validateGameJourneyCatalog(catalog);
+    if (!result.valid) {
+        const details = result.findings
+            .map((finding) => `${finding.path} [${finding.code}] ${finding.message}`)
+            .join('\n');
+        throw new Error(`[DyE2E_GameJourneyCatalog] Invalid catalog:\n${details}`);
+    }
+}
+function validateJourney(journey, index, add) {
+    const root = `$.journeys[${index}]`;
+    if (typeof journey.title !== 'string' || !journey.title.trim()) {
+        add(`${root}.title`, 'missing-title', 'A human-readable journey title is required.');
+    }
+    if (typeof journey.critical !== 'boolean') {
+        add(`${root}.critical`, 'invalid-criticality', 'Journey criticality must be a boolean.');
+    }
+    if (journey.serial !== true) {
+        add(`${root}.serial`, 'not-serial', 'A state-carrying journey must run serially.');
+    }
+    if (!Array.isArray(journey.featureIds)) {
+        add(`${root}.featureIds`, 'invalid-features', 'Journey featureIds must be an array.');
+    }
+    else {
+        validateUniqueNonEmptyStrings(journey.featureIds, `${root}.featureIds`, 'feature', add);
+        const uniqueFeatureIds = new Set(journey.featureIds.filter((value) => typeof value === 'string' && value.trim().length > 0));
+        if (uniqueFeatureIds.size < 2) {
+            add(`${root}.featureIds`, 'not-cross-feature', 'A journey must cross at least two unique features.');
+        }
+    }
+    if (typeof journey.variant !== 'string' || !JOURNEY_VARIANTS.includes(journey.variant)) {
+        add(`${root}.variant`, 'unknown-variant', `Unknown journey variant '${String(journey.variant)}'.`);
+    }
+    if (!Array.isArray(journey.evidenceTestIds) || journey.evidenceTestIds.length === 0) {
+        add(`${root}.evidenceTestIds`, 'missing-evidence', 'At least one executable evidence test id is required.');
+    }
+    else {
+        validateUniqueNonEmptyStrings(journey.evidenceTestIds, `${root}.evidenceTestIds`, 'evidence test', add);
+    }
+    if (!Array.isArray(journey.steps) || journey.steps.length < 2) {
+        add(`${root}.steps`, 'insufficient-steps', 'A journey must contain at least two ordered steps.');
+    }
+    else {
+        const stepIds = new Set();
+        journey.steps.forEach((step, stepIndex) => {
+            if (!isRecord(step) || typeof step.id !== 'string' || !step.id.trim()) {
+                add(`${root}.steps[${stepIndex}].id`, 'empty-step', 'Step id is required.');
+                return;
+            }
+            if (typeof step.businessAssertion !== 'string' || !step.businessAssertion.trim()) {
+                add(`${root}.steps[${stepIndex}].businessAssertion`, 'missing-business-assertion', 'Assertion is required.');
+            }
+            if (stepIds.has(step.id)) {
+                add(`${root}.steps[${stepIndex}].id`, 'duplicate-step', `Duplicate step id '${step.id}'.`);
+            }
+            if (stepIndex === 0 && step.consumesStateFromStepId !== undefined) {
+                add(`${root}.steps[${stepIndex}].consumesStateFromStepId`, 'unexpected-state-source', 'The first journey step cannot consume state from an earlier step.');
+            }
+            else if (stepIndex > 0) {
+                const previousStep = journey.steps[stepIndex - 1];
+                const expectedPrevious = isRecord(previousStep) ? previousStep.id : undefined;
+                if (typeof expectedPrevious !== 'string' || step.consumesStateFromStepId !== expectedPrevious) {
+                    add(`${root}.steps[${stepIndex}].consumesStateFromStepId`, 'broken-state-chain', `Step must consume state from immediately preceding step '${String(expectedPrevious)}'.`);
+                }
+            }
+            stepIds.add(step.id);
+        });
+    }
+    if (typeof journey.valueOutcome !== 'string' || !journey.valueOutcome.trim()) {
+        add(`${root}.valueOutcome`, 'missing-value-outcome', 'The player-value outcome is required.');
+    }
+    if (!isRecord(journey.cleanup)
+        || typeof journey.cleanup.owner !== 'string'
+        || !journey.cleanup.owner.trim()
+        || typeof journey.cleanup.businessAssertion !== 'string'
+        || !journey.cleanup.businessAssertion.trim()) {
+        add(`${root}.cleanup`, 'incomplete-cleanup', 'Cleanup owner and cleanup business assertion are required.');
+    }
+    else if (typeof journey.cleanup.mode !== 'string' || !CLEANUP_MODES.includes(journey.cleanup.mode)) {
+        add(`${root}.cleanup.mode`, 'invalid-cleanup-mode', `Unknown cleanup mode '${String(journey.cleanup.mode)}'.`);
+    }
+}
+function validateUniqueNonEmptyStrings(values, path, label, add) {
+    const unique = new Set();
+    values.forEach((value, index) => {
+        if (typeof value !== 'string' || !value.trim()) {
+            add(`${path}[${index}]`, 'empty-reference', `A non-empty ${label} id is required.`);
+            return;
+        }
+        if (unique.has(value)) {
+            add(`${path}[${index}]`, 'duplicate-reference', `Duplicate ${label} id '${value}'.`);
+        }
+        unique.add(value);
+    });
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=journey-catalog.validator.js.map

package/build/_modules/game/journey-catalog.validator.js.map

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

package/build/_modules/generators/_collections/cli-runner.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-runner.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/generators/_collections/cli-runner.util.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,qBAAa,oBAAoB;IAE/B,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAsBpF,MAAM,CAAC,QAAQ,IAAI,MAAM;IA4DzB;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IA0D/C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QAAE,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,GAAG;QAC9H,YAAY,EAAE,OAAO,CAAC;QACtB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,mBAAmB,EAAE,OAAO,CAAC;QAC7B,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB;IA2CD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM;IAuB9D;;;OAGG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,qBAAqB,GAAG,yBAAyB,GAAG,mBAAmB,EAChF,UAAU,EAAE,MAAM,GACjB,MAAM;CAaV"}
+{"version":3,"file":"cli-runner.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/generators/_collections/cli-runner.util.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,qBAAa,oBAAoB;IAE/B,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAsBpF,MAAM,CAAC,QAAQ,IAAI,MAAM;IAwFzB;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IA0D/C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QAAE,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,GAAG;QAC9H,YAAY,EAAE,OAAO,CAAC;QACtB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,mBAAmB,EAAE,OAAO,CAAC;QAC7B,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB;IA2CD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM;IAuB9D;;;OAGG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,qBAAqB,GAAG,yBAAyB,GAAG,mBAAmB,EAChF,UAAU,EAAE,MAAM,GACjB,MAAM;CAaV"}

package/build/_modules/generators/_collections/cli-runner.util.js

@@ -50,9 +50,37 @@ Commands:
   info                     Show registered field-types + CLI capabilities
   schema                   Print JSON Schema for a config type
   validate-config          Validate a config file against its JSON Schema
+  preset                   List built-in configs, or print one (--name)
   version                  Print package version
   help                     This message
 
+Visual QA (/vqa) commands:
+  validate-manifest        Validate a VQA state-manifest JSON
+  validate-finding         Validate a VQA finding JSON
+  generate-review-bundle   Manifest -> review bundle (capture-spec, README, summary)
+  generate-comparison-bundle  Before/after capture sets -> comparison bundle
+  bundle-summary           Print an existing bundle's summary.md
+
+Flags (preset):
+  --name <preset>          Print this preset as JSON (omit to list all)
+
+Flags (validate-manifest / validate-finding):
+  --manifest <path>        Manifest JSON to validate (validate-manifest)
+  --finding <path>         Finding JSON to validate (validate-finding)
+
+Flags (generate-review-bundle):
+  --manifest <path>        Source state-manifest JSON (required)
+  --out <path>             Output base dir (default: ./review-bundles)
+
+Flags (generate-comparison-bundle):
+  --before <path>          Baseline capture dir (required)
+  --after <path>           Candidate capture dir (required)
+  --manifest <path>        State-manifest JSON (required)
+  --findings <path>        Optional finding-set JSON
+
+Flags (bundle-summary):
+  --bundle <path>          Bundle dir containing manifest.json + summary.md
+
 Flags (generate-form-suite):
   --config <path>          Path to JSON config (formSettings, formRoute, ...)
   --out <path>             Output spec.ts path