@avi770/testteam 3.0.0 → 3.2.0

package/dist/core/triggers/trigger-bus.js

@@ -0,0 +1,167 @@
+/**
+ * TriggerBus (#27 MVP, Phase 2.2) — an in-process push bus that coalesces bursts, prioritizes,
+ * load-sheds under overload, detects self-re-triggering loops (circuit-breaker), honors a global
+ * freeze (ties the Harness actuation-freeze), and FAILS SAFE when degraded (never fires risky
+ * actuation). Every activation carries a provenance chain. Spec: blueprint/agents/27-*.md.
+ *
+ * Boundary with #26: this layer is reactive event-routing only — it signals; it never acts.
+ */
+import { DEFAULT_TRIGGER_CONFIG, } from './types.js';
+const PRIORITY_RANK = { critical: 0, high: 1, normal: 2, low: 3 };
+export class TriggerBus {
+    subscribers = new Map();
+    buffer = new Map();
+    fireTimes = new Map();
+    tripped = new Set();
+    fired = [];
+    dropped = [];
+    config;
+    now;
+    frozen = false;
+    available = true;
+    constructor(config, options) {
+        this.config = { ...DEFAULT_TRIGGER_CONFIG, ...config };
+        this.now = options?.clock ?? (() => Date.now());
+    }
+    /** Wake `agentId` directly (decentralized-first — survives even if #26 is down). */
+    subscribe(agentId, handler) {
+        this.subscribers.set(agentId, handler);
+    }
+    freeze() {
+        this.frozen = true;
+    }
+    unfreeze() {
+        this.frozen = false;
+    }
+    get isFrozen() {
+        return this.frozen;
+    }
+    /** Degrade the bus (e.g. overwhelmed) — fail-safe blocks all firing. */
+    setAvailable(value) {
+        this.available = value;
+    }
+    get auditTrail() {
+        return this.fired.slice();
+    }
+    get dropLog() {
+        return this.dropped.slice();
+    }
+    get bufferedKeys() {
+        return this.buffer.size;
+    }
+    isCircuitBroken(agentId) {
+        return this.tripped.has(agentId);
+    }
+    /** Queue an event. Identical idempotency keys within the window coalesce into one activation. */
+    submit(event) {
+        const now = event.atMs ?? this.now();
+        if (!this.available) {
+            this.drop(event, 'degraded-failsafe', now);
+            return;
+        }
+        if (this.frozen) {
+            this.drop(event, 'trigger-freeze', now);
+            return;
+        }
+        const priority = event.priority ?? 'normal';
+        // Namespace the dedup by target agent: same key for DIFFERENT agents must NOT merge
+        // (else the wrong agent is woken and the other's trigger is lost).
+        const bufKey = this.coalesceKey(event.targetAgentId, event.idempotencyKey);
+        const existing = this.buffer.get(bufKey);
+        if (existing) {
+            // Coalesce: bump the count, keep the earliest time, escalate to the highest priority seen.
+            const higher = PRIORITY_RANK[priority] < PRIORITY_RANK[existing.priority] ? priority : existing.priority;
+            this.buffer.set(bufKey, { ...existing, count: existing.count + 1, priority: higher });
+        }
+        else {
+            this.buffer.set(bufKey, { event, count: 1, firstAtMs: now, priority });
+        }
+    }
+    coalesceKey(agentId, idempotencyKey) {
+        return `${agentId}::${idempotencyKey}`;
+    }
+    /**
+     * Deliver coalesced activations whose window has elapsed (or all, when `force`). Critical first;
+     * under overload low/normal are shed; looping agents are circuit-broken; degraded fails safe.
+     */
+    flush(force = false) {
+        const now = this.now();
+        if (!this.available) {
+            for (const entry of this.buffer.values())
+                this.drop(entry.event, 'degraded-failsafe', now);
+            this.buffer.clear();
+            return [];
+        }
+        const overloaded = this.buffer.size > this.config.maxQueueDepth;
+        const ready = [];
+        for (const [key, entry] of [...this.buffer]) {
+            if (force || now - entry.firstAtMs >= this.config.coalesceWindowMs) {
+                this.buffer.delete(key);
+                ready.push(entry);
+            }
+        }
+        ready.sort((a, b) => PRIORITY_RANK[a.priority] - PRIORITY_RANK[b.priority]);
+        const activations = [];
+        for (const entry of ready) {
+            if (this.frozen) {
+                this.drop(entry.event, 'trigger-freeze', now);
+                continue;
+            }
+            // Fail-safe: when overwhelmed, never fire risky actuation — regardless of priority.
+            if (overloaded && entry.event.riskyActuation) {
+                this.drop(entry.event, 'risky-actuation-shed', now);
+                continue;
+            }
+            if (overloaded && (entry.priority === 'low' || entry.priority === 'normal')) {
+                this.drop(entry.event, 'load-shed', now);
+                continue;
+            }
+            if (this.tripped.has(entry.event.targetAgentId) || this.isLooping(entry.event.targetAgentId, now)) {
+                this.tripped.add(entry.event.targetAgentId);
+                this.drop(entry.event, 'circuit-open', now);
+                continue;
+            }
+            activations.push(this.fire(entry, now));
+        }
+        return activations;
+    }
+    isLooping(agentId, now) {
+        const recent = (this.fireTimes.get(agentId) ?? []).filter((t) => now - t < this.config.loopWindowMs);
+        return recent.length >= this.config.maxFiresPerLoopWindow;
+    }
+    fire(entry, now) {
+        const recent = (this.fireTimes.get(entry.event.targetAgentId) ?? []).filter((t) => now - t < this.config.loopWindowMs);
+        recent.push(now);
+        this.fireTimes.set(entry.event.targetAgentId, recent);
+        const provenance = [
+            { stage: 'event', detail: `${entry.event.type}:${entry.event.cause ?? 'n/a'}` },
+            { stage: 'coalesce', detail: `${entry.count} event(s) in window` },
+            { stage: 'fire', detail: `agent ${entry.event.targetAgentId}` },
+        ];
+        const activation = {
+            targetAgentId: entry.event.targetAgentId,
+            type: entry.event.type,
+            priority: entry.priority,
+            firedAtMs: now,
+            coalescedCount: entry.count,
+            provenance,
+        };
+        this.fired.push(activation);
+        this.cap(this.fired);
+        const handler = this.subscribers.get(entry.event.targetAgentId);
+        if (handler)
+            handler(activation);
+        return activation;
+    }
+    drop(event, reason, atMs) {
+        this.dropped.push({ idempotencyKey: event.idempotencyKey, targetAgentId: event.targetAgentId, reason, atMs });
+        this.cap(this.dropped);
+    }
+    /** Bound an audit array to maxAuditEntries (keep the most recent) — bounded memory under load. */
+    cap(arr) {
+        const max = this.config.maxAuditEntries;
+        if (arr.length > max)
+            arr.splice(0, arr.length - max);
+    }
+}
+//# sourceMappingURL=trigger-bus.js.map

package/dist/core/triggers/trigger-bus.js.map

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

package/dist/core/triggers/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Trigger Management System (#27) MVP — shared types (Phase 2.2).
+ * The suite's reflexes: a push event bus that wakes the right agent at the right moment and never
+ * the wrong one — deliberately not clever (intelligence lives in #26). Spec: blueprint/agents/27-*.md.
+ */
+/** The six unified trigger types on one bus. */
+export type TriggerType = 'event' | 'scheduled' | 'manual' | 'dependency' | 'threshold' | 'orchestrator';
+export type Priority = 'critical' | 'high' | 'normal' | 'low';
+export interface TriggerEvent {
+    readonly type: TriggerType;
+    /** Dedup/coalesce key — identical keys within the window collapse into one activation. */
+    readonly idempotencyKey: string;
+    /** The agent to wake. */
+    readonly targetAgentId: number;
+    readonly priority?: Priority;
+    /** Whether firing leads to production actuation — fail-safe never fires these when degraded. */
+    readonly riskyActuation?: boolean;
+    /** Why this fired (provenance). */
+    readonly cause?: string;
+    /** Optional event timestamp (else the bus clock). */
+    readonly atMs?: number;
+    readonly payload?: Readonly<Record<string, unknown>>;
+}
+export interface ProvenanceLink {
+    readonly stage: 'event' | 'coalesce' | 'fire';
+    readonly detail: string;
+}
+export interface Activation {
+    readonly targetAgentId: number;
+    readonly type: TriggerType;
+    readonly priority: Priority;
+    readonly firedAtMs: number;
+    /** How many events collapsed into this single activation. */
+    readonly coalescedCount: number;
+    readonly provenance: readonly ProvenanceLink[];
+}
+export interface DropRecord {
+    readonly idempotencyKey: string;
+    readonly targetAgentId: number;
+    readonly reason: string;
+    readonly atMs: number;
+}
+export interface TriggerConfig {
+    /** Dedup/coalesce window (default 5s). */
+    readonly coalesceWindowMs: number;
+    /** Sliding window for loop detection. */
+    readonly loopWindowMs: number;
+    /** Fires within the loop window before an agent is circuit-broken. */
+    readonly maxFiresPerLoopWindow: number;
+    /** Buffer depth above which low/normal triggers are shed (overload protection). */
+    readonly maxQueueDepth: number;
+    /** Cap on retained audit/drop records (bounded memory under sustained load). */
+    readonly maxAuditEntries: number;
+}
+export declare const DEFAULT_TRIGGER_CONFIG: TriggerConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/triggers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../core/triggers/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAEzG,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yBAAyB;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,gGAAgG;IAChG,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC"}

package/dist/core/triggers/types.js

@@ -0,0 +1,13 @@
+/**
+ * Trigger Management System (#27) MVP — shared types (Phase 2.2).
+ * The suite's reflexes: a push event bus that wakes the right agent at the right moment and never
+ * the wrong one — deliberately not clever (intelligence lives in #26). Spec: blueprint/agents/27-*.md.
+ */
+export const DEFAULT_TRIGGER_CONFIG = {
+    coalesceWindowMs: 5_000,
+    loopWindowMs: 10_000,
+    maxFiresPerLoopWindow: 5,
+    maxQueueDepth: 100,
+    maxAuditEntries: 10_000,
+};
+//# sourceMappingURL=types.js.map

package/dist/core/triggers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../core/triggers/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0DH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,MAAM;IACpB,qBAAqB,EAAE,CAAC;IACxB,aAAa,EAAE,GAAG;IAClB,eAAe,EAAE,MAAM;CACxB,CAAC"}

package/dist/core/trust.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Trust & Evidence spine — kernel enforcement helpers (Phase 0.4).
+ * Spec: blueprint/rules/trust-evidence-spine.md.
+ */
+import type { TrustClass } from './types.js';
+/** Default trust-class for internally-derived outputs. */
+export declare const DEFAULT_TRUST_CLASS: TrustClass;
+/** Untrusted content may NEVER trigger tool-use / actuation. `undefined` → internally-derived → allowed. */
+export declare function canActuate(trustClass: TrustClass | undefined): boolean;
+/** Untrusted evidence may NEVER be promoted to trusted. Throws on an illegal promotion. */
+export declare function assertNoPromotion(from: TrustClass, to: TrustClass): void;
+//# sourceMappingURL=trust.d.ts.map

package/dist/core/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../core/trust.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,EAAE,UAAsB,CAAC;AAEzD,4GAA4G;AAC5G,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAEtE;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,CAIxE"}

package/dist/core/trust.js

@@ -0,0 +1,13 @@
+/** Default trust-class for internally-derived outputs. */
+export const DEFAULT_TRUST_CLASS = 'trusted';
+/** Untrusted content may NEVER trigger tool-use / actuation. `undefined` → internally-derived → allowed. */
+export function canActuate(trustClass) {
+    return trustClass !== 'untrusted';
+}
+/** Untrusted evidence may NEVER be promoted to trusted. Throws on an illegal promotion. */
+export function assertNoPromotion(from, to) {
+    if (from === 'untrusted' && to === 'trusted') {
+        throw new Error('Trust spine: cannot promote untrusted content to trusted.');
+    }
+}
+//# sourceMappingURL=trust.js.map

package/dist/core/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../core/trust.ts"],"names":[],"mappings":"AAMA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAe,SAAS,CAAC;AAEzD,4GAA4G;AAC5G,MAAM,UAAU,UAAU,CAAC,UAAkC;IAC3D,OAAO,UAAU,KAAK,WAAW,CAAC;AACpC,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,IAAgB,EAAE,EAAc;IAChE,IAAI,IAAI,KAAK,WAAW,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/dist/core/types.d.ts

@@ -1,7 +1,20 @@
-export type Phase = 'alpha' | 'beta' | 'uat' | 'release';
-export type AgentStatus = 'pending' | 'running' | 'passed' | 'failed' | 'skipped';
+/**
+ * Pipeline phases.
+ *
+ * - `alpha`, `beta`, `uat`, `release`: classic 4-phase progression.
+ * - `exploratory` (Sprint 4): opt-in autonomous Browser-Use pass. Runs only on
+ *   staging and is gated by `TF_BROWSER_USE_ENABLED=1`.
+ */
+export type Phase = 'alpha' | 'beta' | 'uat' | 'release' | 'exploratory';
+export type AgentStatus = 'pending' | 'running' | 'passed' | 'failed' | 'skipped' | 'idle';
 export type FindingType = 'test-bug' | 'code-bug-cosmetic' | 'code-bug-logic' | 'code-bug-security' | 'infra-issue';
 export type FindingSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+/**
+ * Trust class for the Trust & Evidence spine (Phase 0.4). `untrusted` = derived from
+ * externally-ingested content (The Net, user feedback, replays, model output over untrusted
+ * input); it can never be promoted to trusted and can never trigger tool-use / actuation.
+ */
+export type TrustClass = 'trusted' | 'untrusted';
 export interface AgentResult {
     agentId: number;
     agentName: string;
@@ -27,11 +40,20 @@ export interface Finding {
     consoleError?: string;
     stackTrace?: string;
     suggestedFix?: string;
+    /** Trust & Evidence spine (Phase 0.4) — optional, additive. */
+    confidence?: number;
+    provenance?: string;
+    trustClass?: TrustClass;
 }
 export interface EvidenceItem {
     type: 'screenshot' | 'log' | 'report' | 'video' | 'snapshot';
     path: string;
     description: string;
+    /** Trust & Evidence spine (Phase 0.4) — optional, additive. */
+    confidence?: number;
+    provenance?: string;
+    trustClass?: TrustClass;
+    capturedAt?: string;
 }
 export interface PhaseGateResult {
     phase: Phase;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAClF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,aAAa,CAAC;AACpH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,KAAK,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,aAAa,CAAC;AAIzE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAC3F,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,aAAa,CAAC;AACpH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAC9E;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,KAAK,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/ui-ux/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * UI/UX Design Sub-Orchestrator (Agent #15 — "The Designer") — public surface.
+ *
+ * Named exports only. Consumers import from this barrel; internal modules
+ * import directly from sibling files.
+ *
+ * Spec: blueprint/agents/15-ui-ux-design.md
+ */
+export type { IssueSeverity, DesignSource, Breakpoint, BrandGuidelines, DesignToken, TokenConformanceResult, OffSystemValue, ScreenSnapshot, DiffGateResult, A11yViolation, VisualIssueCategory, VisualDesignIssue, NielsenHeuristic, HeuristicViolation, UsabilityScore, ResponsiveIssue, ResponsiveResult, MotionVerdict, MotionReview, MockupAlternative, ExperimentHypothesis, DesignQualitySignal, DesignAuditReport, DesignOrchestratorConfig, A11yEngineOutput, UxEngineOutput, ResponsiveEngineOutput, } from './types.js';
+export { evaluateDiffGate, mapSeverity, mapAxeImpact, severityToImpact, toBreakpoint, composeA11yViolations, checkTokenConformance, computeUsabilityScore, composeResponsiveResult, buildBrandConformanceIssues, generateMockupAlternatives, emitExperimentHypothesis, computeDesignQualitySignal, } from './orchestrator.js';
+export { DesignOrchestrator } from './orchestrator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ui-ux/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/ui-ux/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/ui-ux/index.js

@@ -0,0 +1,13 @@
+/**
+ * UI/UX Design Sub-Orchestrator (Agent #15 — "The Designer") — public surface.
+ *
+ * Named exports only. Consumers import from this barrel; internal modules
+ * import directly from sibling files.
+ *
+ * Spec: blueprint/agents/15-ui-ux-design.md
+ */
+// --- Pure helpers (exported for composability and direct test access) ---
+export { evaluateDiffGate, mapSeverity, mapAxeImpact, severityToImpact, toBreakpoint, composeA11yViolations, checkTokenConformance, computeUsabilityScore, composeResponsiveResult, buildBrandConformanceIssues, generateMockupAlternatives, emitExperimentHypothesis, computeDesignQualitySignal, } from './orchestrator.js';
+// --- Stateful orchestrator ---
+export { DesignOrchestrator } from './orchestrator.js';
+//# sourceMappingURL=index.js.map

package/dist/core/ui-ux/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/ui-ux/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiCH,2EAA2E;AAC3E,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,gCAAgC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/ui-ux/orchestrator.d.ts

@@ -0,0 +1,206 @@
+/**
+ * UI/UX Design Sub-Orchestrator (Agent #15 — "The Designer").
+ *
+ * Coordinates the design toolchain: composes engine agents (#8/#67 a11y,
+ * #12 UX Inspector, #29 Responsive, #80 Usability), enforces brand rules,
+ * gates on visual diff (skip unchanged screens), validates design-system
+ * conformance, generates mockup alternatives, and emits A/B hypotheses to
+ * Experiment Runner (#6). Reports a `DesignAuditReport` up to Master
+ * Orchestrator (#26) and a `DesignQualitySignal` to Quality Score (#14).
+ *
+ * Hard rules (enforced here, not just advisory):
+ *   1. A11y violations are BLOCKING — uxScore = 0 and a11yGatePassed = false.
+ *   2. UI changes are NEVER auto-shipped — mockups carry `requiresHumanApproval: true`.
+ *   3. Unchanged screens are SKIPPED (visual-diff gate, improvement #1).
+ *   4. Off-design-system values are FLAGGED (improvement #2).
+ *   5. Every suggestion becomes a testable hypothesis for #6 (improvement #10).
+ *
+ * Pure functions are exported separately so tests can exercise them directly
+ * without constructing the full orchestrator.
+ *
+ * Spec: blueprint/agents/15-ui-ux-design.md
+ */
+import type { A11yEngineOutput, A11yViolation, BrandGuidelines, Breakpoint, DesignAuditReport, DesignOrchestratorConfig, DesignQualitySignal, DesignSource, DesignToken, DiffGateResult, ExperimentHypothesis, IssueSeverity, MockupAlternative, MotionReview, OffSystemValue, ResponsiveEngineOutput, ResponsiveResult, ScreenSnapshot, TokenConformanceResult, UsabilityScore, UxEngineOutput, VisualDesignIssue } from './types.js';
+/**
+ * Visual-diff gate (improvement #1).
+ *
+ * Compares the current content hash to the previous snapshot.
+ * Returns `skipped: true` iff the hash is unchanged.
+ * New screens (no previous snapshot) are NOT skipped.
+ */
+export declare function evaluateDiffGate(current: Readonly<ScreenSnapshot>, previous: Readonly<ScreenSnapshot> | null): DiffGateResult;
+/**
+ * Map severity strings from engine agents to `IssueSeverity`.
+ *
+ * Fail-CLOSED on unknown input: a malformed/unrecognised severity (e.g. a
+ * typo'd 'critcal', or an empty string) is treated conservatively as 'high'
+ * rather than 'info'. Mapping garbage to 'info' would grant it the 0-point
+ * "free pass" deduction in usability/responsive scoring and silently
+ * under-report a finding that may in fact be critical. The five known values
+ * (including 'info') map to themselves.
+ */
+export declare function mapSeverity(raw: string): IssueSeverity;
+/**
+ * Validate an engine-provided breakpoint string against the known set.
+ *
+ * Unknown or absent values fall back to 'desktop' via a REAL membership check —
+ * not a blind `as Breakpoint` cast that would let an invalid runtime value
+ * (e.g. "widescreen") masquerade as a typed Breakpoint and flow downstream.
+ * The cast after the `.has()` guard is sound: the runtime check has already
+ * proven `raw` is one of the three valid breakpoints.
+ */
+export declare function toBreakpoint(raw: string | undefined): Breakpoint;
+/**
+ * Convert axe-core-style impact strings to the `A11yViolation['impact']` enum.
+ * Unknown values default to 'minor' (never silently inflates to critical).
+ */
+export declare function mapAxeImpact(impact: string): 'critical' | 'serious' | 'moderate' | 'minor';
+/**
+ * Map a core `FindingSeverity` to the `A11yViolation['impact']` enum.
+ *
+ * `composeA11yViolations` receives `A11yEngineFinding`s whose `.severity` is a
+ * core `FindingSeverity` (`Pick<Finding, 'severity'>`) — NOT an axe-core impact
+ * string. Engine agents #8/#67 have already mapped axe impact → severity
+ * (agent #8: serious→high, moderate→medium, minor→low). This is the inverse of
+ * that map, so the axe→severity→impact round-trip preserves fidelity: a
+ * serious a11y finding (stored as severity 'high') surfaces as impact 'serious'
+ * rather than collapsing to 'minor'. Unknown → 'minor' (never inflates).
+ *
+ * (Historically the reader/orchestrator called `mapAxeImpact(f.severity)` here,
+ * which only recognises axe strings, so every non-'critical' severity — the
+ * common case — silently degraded to 'minor'. Only the dashboard's S6 posture
+ * view reads `.impact`, so this correction has no other consumer.)
+ */
+export declare function severityToImpact(severity: string): 'critical' | 'serious' | 'moderate' | 'minor';
+/**
+ * Compose engine-agent a11y findings into structured `A11yViolation[]`.
+ *
+ * ALL violations produced here carry `blocking: true` — the type system enforces
+ * this and callers cannot downgrade them (spec: "a11y is a hard floor").
+ */
+export declare function composeA11yViolations(engineOutput: Readonly<A11yEngineOutput>, screenId: string): readonly A11yViolation[];
+/**
+ * Check a computed style map against the token registry (improvement #2).
+ *
+ * `computedStyles` is a map of `cssProperty -> computedValue` for one screen.
+ * Values not present in the registry are returned as `OffSystemValue` entries.
+ *
+ * Must-Fix #6: The `nearestToken` field reports the FIRST color token found in
+ * the registry when the off-system value is a hex color — it is NOT a
+ * color-distance-based nearest match. The field is preserved for callers that
+ * display a "did you mean?" hint; its approximate nature is documented here.
+ * A full chroma-distance implementation is a phase-2 enhancement.
+ */
+export declare function checkTokenConformance(screenId: string, computedStyles: ReadonlyMap<string, string>, tokenRegistry: readonly DesignToken[]): TokenConformanceResult;
+/**
+ * Compute the usability score for one screen (improvement #5).
+ *
+ * Derives a 0..100 score from UX engine findings mapped to Nielsen heuristics,
+ * fused with Watcher friction points (improvement #6 — real-user grounded).
+ * Score is truncated (never rounded up) per Avi's QA standard.
+ *
+ * Math: each heuristic violation deducts points based on severity:
+ *   critical -20, high -10, medium -5, low -2
+ * Watcher friction deduction: frictionPoints.length * 2  (applied ONCE, outside the loop)
+ * Cognitive load = violations.length + friction (clamped 0..10).
+ *
+ * Must-Fix #2: Watcher friction deduction is applied ONCE per screen (outside
+ * the findings loop). The previous implementation applied it inside the loop,
+ * causing it to accumulate N*friction for N findings — inflating deductions by
+ * 2× per additional finding. An empty findings list would also silently ignore
+ * friction entirely.
+ */
+export declare function computeUsabilityScore(screenId: string, uxOutput: Readonly<UxEngineOutput>, watcherFrictionPoints: readonly string[]): UsabilityScore;
+/**
+ * Compose responsive engine output into structured `ResponsiveResult` (improvement #9).
+ */
+export declare function composeResponsiveResult(screenId: string, engineOutput: Readonly<ResponsiveEngineOutput>): ResponsiveResult;
+/**
+ * Build visual design issues from brand conformance check.
+ *
+ * Checks each `OffSystemValue` against `BrandGuidelines` and emits a
+ * `VisualDesignIssue` per violation. The color/font/spacing checks are
+ * deterministic against the provided guidelines (improvement #3 — brand memory).
+ *
+ * Output is RANKED by severity (critical → info) so the most important fixes
+ * surface first regardless of input order — the spec's "ranked fixes" rule is
+ * enforced here, not left to caller input order.
+ */
+export declare function buildBrandConformanceIssues(offSystemValues: readonly OffSystemValue[], brandGuidelines: Readonly<BrandGuidelines>): readonly VisualDesignIssue[];
+/**
+ * Generate mockup alternative stubs for a flagged screen (improvement #4).
+ *
+ * In production the orchestrator would invoke Figma MCP / Canva / image-gen here.
+ * This layer returns deterministic stubs with `requiresHumanApproval: true` so the
+ * type system enforces the "never auto-ships UI" contract.
+ *
+ * `count` must be at least 2 (spec requirement). Callers should pass
+ * `config.minMockupAlternatives ?? 2`.
+ */
+export declare function generateMockupAlternatives(screenId: string, issueDescriptions: readonly string[], source: DesignSource, count: number, now: () => number): readonly MockupAlternative[];
+/**
+ * Emit an Experiment Runner (#6) hypothesis from an accepted mockup (improvement #10).
+ *
+ * Every suggestion is a testable A/B hypothesis. The orchestrator emits one per
+ * accepted mockup alternative; #6 owns the experiment lifecycle from here.
+ */
+export declare function emitExperimentHypothesis(mockup: Readonly<MockupAlternative>, expectedImpact: string, now: () => number): ExperimentHypothesis;
+/**
+ * Compute the design quality signal for #14 (improvement #2 / #7).
+ *
+ * Sub-scores:
+ *   a11y: 0 if any violation, else 1 (hard floor — improvement #7)
+ *   visual: 1 - (criticalIssues * 0.25 + highIssues * 0.10)  clamped [0,1]
+ *   usability: uxScore.score / 100
+ *   responsive: 1 - (failedScreenRatio)
+ *   brandConformance: 1 - (offSystemCount / declarationsChecked), or N/A (null)
+ *                     when nothing was checked
+ *
+ * Overall uxScore = mean of the sub-scores that were actually MEASURED (brand
+ * conformance only participates when there was brand data), then clamped to 0
+ * when any a11y violation exists (a11y = hard floor). Truncated, never rounded up.
+ */
+export declare function computeDesignQualitySignal(componentId: string, a11yViolations: readonly A11yViolation[], visualIssues: readonly VisualDesignIssue[], usabilityScore: number, responsiveResults: readonly ResponsiveResult[], tokenConformanceResults: readonly TokenConformanceResult[], scoredAt: string): DesignQualitySignal;
+/**
+ * Design sub-orchestrator for Agent #15.
+ *
+ * Maintains a snapshot cache for visual-diff gating (improvement #1).
+ * All mutation methods are pure-functional over their inputs; side-effects
+ * (tool invocations, MCP calls) are expected to happen at the *caller* level
+ * (the run engine), keeping this class deterministic and testable.
+ *
+ * Usage pattern:
+ *   const orchestrator = new DesignOrchestrator(config);
+ *   const report = orchestrator.audit(runId, screens, a11yOut, uxOut, responsiveOut);
+ *   // Report is immutable; caller routes to Dashboard, #14, #26.
+ */
+export declare class DesignOrchestrator {
+    private readonly config;
+    /** Snapshot cache: screenId → last known hash. Visual-diff gate (improvement #1). */
+    private readonly snapshotCache;
+    constructor(config?: DesignOrchestratorConfig);
+    /** Update the cached snapshot for a screen (called after each audit). */
+    updateSnapshot(snapshot: Readonly<ScreenSnapshot>): void;
+    /** Return the cached snapshot for a screen, or null if unseen. */
+    getSnapshot(screenId: string): ScreenSnapshot | null;
+    /**
+     * Run a full design audit for one pipeline pass.
+     *
+     * @param runId        - Unique identifier for this pipeline run.
+     * @param screens      - Current screen snapshots (hash = current state).
+     * @param a11yOutput   - Composed output from engine agents #8 / #67.
+     * @param uxOutput     - Composed output from engine agents #12 / #80.
+     * @param responsiveOutput - Composed output from engine agent #29.
+     * @param watcherFriction  - Real-user friction points from Watcher (#2), keyed
+     *                           PER SCREEN (`screenId -> friction descriptions`).
+     *                           A flat global list is wrong: friction recorded on
+     *                           one screen must not penalize every other screen's
+     *                           usability score.
+     * @param computedStyles   - Per-screen CSS computed-style map for token check.
+     * @param motionReviews    - Optional motion/animation reviews (phase-2).
+     *
+     * Returns a fully-immutable `DesignAuditReport`. Never auto-ships anything.
+     */
+    audit(runId: string, screens: readonly Readonly<ScreenSnapshot>[], a11yOutput: Readonly<A11yEngineOutput>, uxOutput: Readonly<UxEngineOutput>, responsiveOutput: Readonly<ResponsiveEngineOutput>, watcherFriction?: ReadonlyMap<string, readonly string[]>, computedStyles?: ReadonlyMap<string, ReadonlyMap<string, string>>, motionReviews?: readonly MotionReview[]): DesignAuditReport;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/core/ui-ux/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../core/ui-ux/orchestrator.ts"],"names":[],"mappings":"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"}