@avi770/testteam 3.0.0 → 3.2.0

package/dist/core/loop-engine/kernel.js

@@ -0,0 +1,196 @@
+import { CORE_LOOPS, } from './types.js';
+import { CircuitBreaker } from './circuit-breaker.js';
+import { InMemoryTraceSink } from './tracing.js';
+/** Safe defaults: gate escalation at 0.5 confidence; unbudgeted; trip after 3 fails, cool 2 cycles. */
+export const DEFAULT_KERNEL_CONFIG = {
+    confidenceThreshold: 0.5,
+    budgets: {},
+    circuitBreaker: { failureThreshold: 3, cooldownCycles: 2 },
+};
+/** Clamp any number into [0,1]; NaN -> 0 (a NaN confidence must never read as "high"). */
+function clamp01(n) {
+    if (Number.isNaN(n))
+        return 0;
+    if (n < 0)
+        return 0;
+    if (n > 1)
+        return 1;
+    return n;
+}
+/**
+ * The Loop Engine kernel (Phase 1.1) — the shared cognitive substrate every agent inherits.
+ *
+ * Runs the seven core-cognition loops as one cycle, wrapping each with: a per-loop invocation
+ * budget (frugality), a circuit-breaker (stability), confidence-gated escalation, an
+ * OpenTelemetry-shaped trace span (observability), and an immutable event append (replay).
+ * State is a pure fold over the event stream, so {@link replayState} reconstructs it exactly.
+ *
+ * Additive + reuse-first: agents opt in via `BaseAgent.loopKernel(...)`; the 84 engine agents are
+ * untouched. Spec: blueprint/loops/00-LOOP-ENGINE.md.
+ *
+ * Immutability contract (required for the replay invariant): `reduce` MUST return a NEW state
+ * rather than mutating its argument, and loop-handler outputs MUST be treated as immutable. The
+ * kernel never mutates `state` in place; callers must not mutate the values returned by `state`,
+ * `events`, or a handler — doing so would diverge live state from replayed state.
+ */
+export class LoopKernel {
+    handlers;
+    reduce;
+    currentState;
+    log = [];
+    breakers;
+    remainingBudget = new Map();
+    config;
+    sink;
+    now;
+    onEvent;
+    seq = 0;
+    nextCycle = 0;
+    running = false;
+    constructor(initialState, handlers, reduce, config, options) {
+        this.handlers = handlers;
+        this.reduce = reduce;
+        this.currentState = initialState;
+        this.config = {
+            confidenceThreshold: config?.confidenceThreshold ?? DEFAULT_KERNEL_CONFIG.confidenceThreshold,
+            budgets: config?.budgets ?? DEFAULT_KERNEL_CONFIG.budgets,
+            circuitBreaker: config?.circuitBreaker ?? DEFAULT_KERNEL_CONFIG.circuitBreaker,
+        };
+        this.sink = options?.trace ?? new InMemoryTraceSink();
+        this.now = options?.clock ?? (() => Date.now());
+        this.onEvent = options?.onEvent;
+        const breakers = {};
+        for (const loop of CORE_LOOPS) {
+            breakers[loop] = new CircuitBreaker(this.config.circuitBreaker);
+            const budget = this.config.budgets[loop];
+            if (budget)
+                this.remainingBudget.set(loop, budget.maxInvocations);
+        }
+        this.breakers = breakers;
+    }
+    /** Current event-sourced state (a pure fold of {@link events}). */
+    get state() {
+        return this.currentState;
+    }
+    /** A snapshot of the event stream — the source of truth for replay (copied to defend the log). */
+    get events() {
+        return this.log.slice();
+    }
+    /** The trace sink (default in-memory) for observing spans. */
+    get trace() {
+        return this.sink;
+    }
+    /**
+     * Run one full cognitive cycle: Observe -> Decide -> Execute -> Reflect -> Learn -> Predict ->
+     * Correct. Each loop is budget-checked, breaker-guarded, traced, and recorded as an event.
+     * Returns the events produced and the loops that gated an escalation this cycle.
+     */
+    async runCycle() {
+        // Re-entrancy guard: the kernel mutates shared state (log/seq/budgets/breakers), so a cycle
+        // is atomic. Overlapping calls would interleave events and corrupt the replay invariant.
+        if (this.running) {
+            throw new Error('LoopKernel.runCycle: a cycle is already in progress (concurrent runCycle is not allowed).');
+        }
+        this.running = true;
+        try {
+            const cycle = this.nextCycle++;
+            const firstIndex = this.log.length;
+            const escalated = [];
+            for (const loop of CORE_LOOPS) {
+                const breaker = this.breakers[loop];
+                const startMs = this.now();
+                if (!breaker.canExecute(cycle)) {
+                    this.append(cycle, loop, 'circuit-open', startMs, {});
+                    continue;
+                }
+                if (this.isBudgetExhausted(loop)) {
+                    this.append(cycle, loop, 'budget-exhausted', startMs, {});
+                    continue;
+                }
+                const handler = this.handlers[loop];
+                if (!handler) {
+                    this.append(cycle, loop, 'skipped', startMs, {});
+                    continue;
+                }
+                this.spendBudget(loop);
+                try {
+                    const output = await handler({ loop, cycle, state: this.currentState, prior: this.collectPrior(firstIndex) });
+                    const confidence = clamp01(output.confidence);
+                    const escalate = confidence < this.config.confidenceThreshold;
+                    if (escalate)
+                        escalated.push(loop);
+                    breaker.recordSuccess();
+                    this.append(cycle, loop, 'ok', startMs, { confidence, escalate, output: output.value });
+                }
+                catch (err) {
+                    breaker.recordFailure(cycle);
+                    this.append(cycle, loop, 'failed', startMs, {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            return { cycle, state: this.currentState, events: this.log.slice(firstIndex), escalated };
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /**
+     * Prior outputs from earlier `ok` loops in the CURRENT cycle. Scans only from `fromIndex`
+     * (the cycle's first event) — bounded to <=7 events, not the whole history (frugality).
+     */
+    collectPrior(fromIndex) {
+        const prior = {};
+        for (let i = fromIndex; i < this.log.length; i++) {
+            const event = this.log[i];
+            if (event && event.status === 'ok' && event.confidence !== undefined) {
+                prior[event.loop] = { value: event.output, confidence: event.confidence };
+            }
+        }
+        return prior;
+    }
+    isBudgetExhausted(loop) {
+        const remaining = this.remainingBudget.get(loop);
+        return remaining !== undefined && remaining <= 0;
+    }
+    spendBudget(loop) {
+        const remaining = this.remainingBudget.get(loop);
+        if (remaining !== undefined)
+            this.remainingBudget.set(loop, remaining - 1);
+    }
+    append(cycle, loop, status, startMs, extra) {
+        const endMs = this.now();
+        const event = {
+            seq: this.seq++,
+            cycle,
+            loop,
+            status,
+            durationMs: Math.max(0, endMs - startMs),
+            at: new Date(endMs).toISOString(),
+            ...(extra.confidence !== undefined ? { confidence: extra.confidence } : {}),
+            ...(extra.escalate !== undefined ? { escalate: extra.escalate } : {}),
+            ...(extra.output !== undefined ? { output: extra.output } : {}),
+            ...(extra.error !== undefined ? { error: extra.error } : {}),
+        };
+        this.log.push(event);
+        this.currentState = this.reduce(this.currentState, event);
+        const attributes = { cycle, status };
+        if (event.confidence !== undefined)
+            attributes['confidence'] = event.confidence;
+        if (event.escalate !== undefined)
+            attributes['escalate'] = event.escalate;
+        this.sink.span({ name: `loop.${loop}`, startMs, endMs, attributes });
+        // Live telemetry observer — LAST, after the event is recorded, reduced, and traced. Wrapped
+        // so a throwing observer (e.g. a dropped SSE socket) can never break the cycle or corrupt the
+        // replay invariant. Fires post-reduce, so it always observes settled, replay-consistent state.
+        if (this.onEvent) {
+            try {
+                this.onEvent(event);
+            }
+            catch {
+                /* isolate a faulty observer — the run must continue (mirrors the sink fan-out contract) */
+            }
+        }
+    }
+}
+//# sourceMappingURL=kernel.js.map

package/dist/core/loop-engine/kernel.js.map

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

package/dist/core/loop-engine/tracing.d.ts

@@ -0,0 +1,12 @@
+import type { TraceSink, TraceSpan } from './types.js';
+/**
+ * Zero-dependency, OpenTelemetry-shaped span collector (Phase 1.1). Keeps the kernel observable
+ * ("watch the agents think") without pulling the OTel SDK — a deliberate frugality choice. Swap
+ * for a real exporter by implementing {@link TraceSink}. Spec: blueprint/loops/00-LOOP-ENGINE.md.
+ */
+export declare class InMemoryTraceSink implements TraceSink {
+    private readonly collected;
+    span(span: TraceSpan): void;
+    get spans(): readonly TraceSpan[];
+}
+//# sourceMappingURL=tracing.d.ts.map

package/dist/core/loop-engine/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../core/loop-engine/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAE7C,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI3B,IAAI,KAAK,IAAI,SAAS,SAAS,EAAE,CAEhC;CACF"}

package/dist/core/loop-engine/tracing.js

@@ -0,0 +1,15 @@
+/**
+ * Zero-dependency, OpenTelemetry-shaped span collector (Phase 1.1). Keeps the kernel observable
+ * ("watch the agents think") without pulling the OTel SDK — a deliberate frugality choice. Swap
+ * for a real exporter by implementing {@link TraceSink}. Spec: blueprint/loops/00-LOOP-ENGINE.md.
+ */
+export class InMemoryTraceSink {
+    collected = [];
+    span(span) {
+        this.collected.push(span);
+    }
+    get spans() {
+        return this.collected;
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/core/loop-engine/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../core/loop-engine/tracing.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACX,SAAS,GAAgB,EAAE,CAAC;IAE7C,IAAI,CAAC,IAAe;QAClB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/core/loop-engine/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Loop Engine kernel — shared types (Phase 1.1).
+ * Spec: blueprint/loops/00-LOOP-ENGINE.md.
+ *
+ * Every agent inherits ONE loop runtime (not 18 re-implementations). The seven
+ * core-cognition loops run as a single cycle:
+ *   Observe -> Decide -> Execute -> Reflect -> Learn -> Predict -> Correct
+ * around which the kernel layers per-loop budgets, confidence-gated escalation,
+ * circuit-breakers, OpenTelemetry-shaped tracing, and event-sourced replay.
+ */
+/** The seven core-cognition loops, in cycle order. */
+export declare const CORE_LOOPS: readonly ["observe", "decide", "execute", "reflect", "learn", "predict", "correct"];
+export type CoreLoop = (typeof CORE_LOOPS)[number];
+/** Terminal status of a single loop step within a cycle. */
+export type LoopStatus = 'ok' | 'skipped' | 'failed' | 'budget-exhausted' | 'circuit-open';
+/** Every loop handler returns a value plus a calibrated 0..1 confidence. */
+export interface LoopOutput<T = unknown> {
+    readonly value: T;
+    /** 0..1; clamped by the kernel. Drives confidence-gated escalation. */
+    readonly confidence: number;
+}
+/** Read-only context handed to each loop handler. */
+export interface LoopContext<S> {
+    readonly loop: CoreLoop;
+    readonly cycle: number;
+    readonly state: S;
+    /** Outputs produced by earlier loops in THIS cycle (observe is first -> empty). */
+    readonly prior: Readonly<Partial<Record<CoreLoop, LoopOutput>>>;
+}
+export type LoopHandler<S> = (ctx: LoopContext<S>) => Promise<LoopOutput> | LoopOutput;
+/** The seven optional handlers; a missing handler => that loop is `skipped`. */
+export type LoopHandlers<S> = Partial<Record<CoreLoop, LoopHandler<S>>>;
+/**
+ * Pure fold: state is derived from the event stream. The SAME reducer reconstructs
+ * identical state on replay — this is what makes the kernel event-sourced.
+ */
+export type LoopReducer<S> = (state: S, event: LoopEvent) => S;
+/** Per-loop invocation budget (lifetime of the kernel). The frugality lever. */
+export interface LoopBudget {
+    readonly maxInvocations: number;
+}
+export interface CircuitBreakerConfig {
+    /** Consecutive failures that trip the breaker OPEN. */
+    readonly failureThreshold: number;
+    /** Cycles the breaker stays OPEN before a HALF-OPEN trial. */
+    readonly cooldownCycles: number;
+}
+export interface KernelConfig {
+    /** Record `escalate:true` when a loop's confidence < this. */
+    readonly confidenceThreshold: number;
+    /** Per-loop invocation budgets. Omitted loops are unbudgeted. */
+    readonly budgets: Partial<Record<CoreLoop, LoopBudget>>;
+    /** Circuit-breaker config (shared shape across all loops). */
+    readonly circuitBreaker: CircuitBreakerConfig;
+}
+/** One immutable, event-sourced record of a single loop step. */
+export interface LoopEvent {
+    readonly seq: number;
+    readonly cycle: number;
+    readonly loop: CoreLoop;
+    readonly status: LoopStatus;
+    /** Present for `ok` steps. */
+    readonly confidence?: number;
+    /** True when confidence < threshold (signals heavier model / council / human). */
+    readonly escalate?: boolean;
+    readonly durationMs: number;
+    /** The loop output value, for `ok` steps. */
+    readonly output?: unknown;
+    /** The error message, for `failed` steps. */
+    readonly error?: string;
+    /** ISO 8601 timestamp of completion. */
+    readonly at: string;
+}
+/** Result of running one full cognitive cycle. */
+export interface CycleResult<S> {
+    readonly cycle: number;
+    readonly state: S;
+    readonly events: readonly LoopEvent[];
+    /** Loops whose low confidence gated an escalation this cycle. */
+    readonly escalated: readonly CoreLoop[];
+}
+export interface TraceSpan {
+    readonly name: string;
+    readonly startMs: number;
+    readonly endMs: number;
+    readonly attributes: Readonly<Record<string, string | number | boolean>>;
+}
+/** Span sink — default is in-memory; swap for a real OTel exporter without touching the kernel. */
+export interface TraceSink {
+    span(span: TraceSpan): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/loop-engine/types.d.ts.map

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

package/dist/core/loop-engine/types.js

@@ -0,0 +1,21 @@
+/**
+ * Loop Engine kernel — shared types (Phase 1.1).
+ * Spec: blueprint/loops/00-LOOP-ENGINE.md.
+ *
+ * Every agent inherits ONE loop runtime (not 18 re-implementations). The seven
+ * core-cognition loops run as a single cycle:
+ *   Observe -> Decide -> Execute -> Reflect -> Learn -> Predict -> Correct
+ * around which the kernel layers per-loop budgets, confidence-gated escalation,
+ * circuit-breakers, OpenTelemetry-shaped tracing, and event-sourced replay.
+ */
+/** The seven core-cognition loops, in cycle order. */
+export const CORE_LOOPS = [
+    'observe',
+    'decide',
+    'execute',
+    'reflect',
+    'learn',
+    'predict',
+    'correct',
+];
+//# sourceMappingURL=types.js.map

package/dist/core/loop-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../core/loop-engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sDAAsD;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC"}

package/dist/core/messages.d.ts

@@ -1,4 +1,4 @@
-import type { LicenseTier } from './license';
+import type { LicenseTier } from './license.js';
 /** Look up the display name for an agent number. */
 export declare function getAgentDisplayName(agentNumber: number): string;
 /** Message shown when an agent is gated by license tier. */

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

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../core/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA+B7C,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,WAAW,EACzB,WAAW,EAAE,WAAW,GACvB,MAAM,CAER;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,WAAW,EACzB,WAAW,EAAE,WAAW,GACvB,MAAM,CAER;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAChB,MAAM,CAER"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../core/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAmI7C,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,WAAW,EACzB,WAAW,EAAE,WAAW,GACvB,MAAM,CAER;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,WAAW,EACzB,WAAW,EAAE,WAAW,GACvB,MAAM,CAER;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAChB,MAAM,CAER"}

package/dist/core/messages.js

@@ -22,8 +22,108 @@ const AGENT_NAMES = {
     19: 'Tenant Isolation Auditor',
     20: 'Workflow Completion Tester',
     21: 'State & Session Tester',
-    22: 'Email Notification Verifier',
+    22: 'Email & Notification Verifier',
     23: 'Migration Tester',
+    24: 'Signup & Onboarding Tester',
+    25: 'CRUD Flow Tester',
+    26: 'Form Validator',
+    27: 'Search & Filter Tester',
+    28: 'Navigation & Routing Tester',
+    29: 'Responsive Interaction Tester',
+    30: 'Multi-User Scenario Tester',
+    31: 'Load Tester',
+    32: 'Memory Leak Detector',
+    33: 'Bundle Analyzer',
+    34: 'XSS Scanner',
+    35: 'CSRF Tester',
+    36: 'Auth Fuzzer',
+    37: 'Dependency Scanner',
+    38: 'Secrets Scanner',
+    39: 'API Contract Tester',
+    40: 'Rate Limit Tester',
+    41: 'API Pagination Tester',
+    42: 'GraphQL Tester',
+    43: 'Data Consistency Checker',
+    44: 'Backup Recovery Tester',
+    45: 'Data Privacy Scanner',
+    46: 'SEO Auditor',
+    47: 'Social Preview Tester',
+    48: 'Lighthouse Auditor',
+    49: 'i18n Tester',
+    50: 'Timezone Tester',
+    51: 'Error Recovery Tester',
+    52: 'Offline Mode Tester',
+    53: 'Graceful Degradation Tester',
+    54: 'WebSocket Tester',
+    55: 'Realtime Sync Tester',
+    56: 'File Upload Tester',
+    57: 'Export Tester',
+    58: 'Payment Flow Tester',
+    59: 'SSL/TLS Auditor',
+    60: 'DNS & CDN Tester',
+    61: 'Docker Health Checker',
+    62: 'Env Config Validator',
+    63: 'Log Quality Auditor',
+    64: 'Analytics Tracker Tester',
+    65: 'GDPR Compliance Tester',
+    66: 'SOC2 Control Validator',
+    67: 'WCAG AAA Tester',
+    68: 'Dead Code Detector',
+    69: 'Type Safety Auditor',
+    70: 'Complexity Analyzer',
+    71: 'Unit Testing Agent',
+    72: 'Integration Testing Agent',
+    73: 'System Testing Agent',
+    74: 'Acceptance Testing Agent',
+    75: 'Sanity Testing Agent',
+    76: 'Regression Testing Agent',
+    77: 'Browser Load Testing Agent',
+    78: 'Stress Testing Agent',
+    79: 'Endurance Testing Agent',
+    80: 'Usability Testing Agent',
+    81: 'Compatibility Testing Agent',
+    82: 'Exploratory Testing Agent',
+    83: 'Static Analysis Agent',
+    84: 'Governance Testing Agent',
+    // Sprint 4+ — browser-agent layers + the static-analysis expansion (85–120).
+    // Keep in sync with agents/*.ts `agentName` and bridge/agent-registry.ts;
+    // the agent-names coverage test fails if any registered agent is missing here.
+    85: 'Stagehand Agent',
+    86: 'Browser-Use Agent',
+    87: 'Connection Mapper',
+    88: 'Localhost Walkthrough',
+    89: 'Repair & Retest',
+    90: 'Response Shape Validator',
+    91: 'Boundary Fuzzer',
+    92: 'Repair Simulator',
+    93: 'Env Var Auditor',
+    94: 'Schema Validator',
+    95: 'API Contract Drift',
+    96: 'Cookie Security Auditor',
+    97: 'Healthcheck Validator',
+    98: 'CORS / CSP Auditor',
+    99: 'Logging Hygiene Auditor',
+    100: 'Error-Handling Auditor',
+    101: 'Rate-Limit Auditor',
+    102: 'Dockerfile Auditor',
+    103: 'CI Workflow Auditor',
+    104: 'N+1 Query Detector',
+    105: 'Unbounded Query Auditor',
+    106: 'Hardcoded Config Auditor',
+    107: 'Open-Redirect Detector',
+    108: 'SQL Injection Detector',
+    109: 'Path Traversal Detector',
+    110: 'Mass-Assignment Detector',
+    111: 'Dynamic Code Execution Detector',
+    112: 'Cross-File Taint Tracker',
+    113: 'Response Contract Auditor',
+    114: 'Static A11y Auditor',
+    115: 'Multi-Hop Taint Tracker',
+    116: 'Runtime Contract Capture',
+    117: 'ARIA Rule Engine',
+    118: 'Insecure Crypto Auditor',
+    119: 'Hardcoded Secrets Scanner',
+    120: 'Async Safety Auditor',
 };
 /** Look up the display name for an agent number. */
 export function getAgentDisplayName(agentNumber) {

package/dist/core/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../core/messages.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,8BAA8B,CAAC;AAEnD,yCAAyC;AACzC,MAAM,WAAW,GAA2B;IAC1C,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,gBAAgB;IACnB,CAAC,EAAE,gBAAgB;IACnB,CAAC,EAAE,aAAa;IAChB,CAAC,EAAE,iBAAiB;IACpB,CAAC,EAAE,eAAe;IAClB,CAAC,EAAE,gBAAgB;IACnB,CAAC,EAAE,eAAe;IAClB,CAAC,EAAE,QAAQ;IACX,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,cAAc;IAClB,EAAE,EAAE,sBAAsB;IAC1B,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,yBAAyB;IAC7B,EAAE,EAAE,sBAAsB;IAC1B,EAAE,EAAE,0BAA0B;IAC9B,EAAE,EAAE,4BAA4B;IAChC,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,6BAA6B;IACjC,EAAE,EAAE,kBAAkB;CACvB,CAAC;AAEF,oDAAoD;AACpD,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,WAAW,CAAC,WAAW,CAAC,IAAI,SAAS,WAAW,EAAE,CAAC;AAC5D,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,SAAiB,EACjB,YAAyB,EACzB,WAAwB;IAExB,OAAO,UAAU,WAAW,KAAK,SAAS,cAAc,UAAU,CAAC,YAAY,CAAC,6BAA6B,WAAW,GAAG,CAAC;AAC9H,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,YAAyB,EACzB,WAAwB;IAExB,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,mBAAmB,UAAU,CAAC,YAAY,CAAC,sBAAsB,WAAW,cAAc,WAAW,GAAG,CAAC;AACtI,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAa,EACb,IAAiB;IAEjB,OAAO,sBAAsB,IAAI,IAAI,KAAK,iBAAiB,UAAU,CAAC,IAAI,CAAC,sBAAsB,WAAW,EAAE,CAAC;AACjH,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../core/messages.ts"],"names":[],"mappings":"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"}

package/dist/core/orchestrator.d.ts

@@ -1,10 +1,16 @@
-import type { Phase, AgentResult, PhaseGateResult } from './types';
-import type { ValidatedConfig } from './config';
-import type { BaseAgent } from '../agents/base-agent';
-import type { HealthCheck } from './health-check';
-import { CostTracker } from './cost-tracker';
-import type { LicenseTier } from './license';
-import type { AgentMvpClient } from '../clients/agent-mvp';
+import type { Phase, AgentResult, PhaseGateResult } from './types.js';
+import type { ValidatedConfig } from './config.js';
+import type { BaseAgent } from '../agents/base-agent.js';
+import type { HealthCheck } from './health-check.js';
+import type { PauseGate } from './escalation/pause-gate.js';
+import type { Calibrator } from './governance/index.js';
+import { CostTracker } from './cost-tracker.js';
+import type { CorrelationResult } from './finding-correlation.js';
+import type { LicenseTier } from './license.js';
+import type { AgentMvpClient } from '../clients/agent-mvp.js';
+import { RunEventEmitter } from './run-events/index.js';
+/** Agent IDs to dispatch per phase, in execution order. */
+export declare const PHASE_DISPATCH: Record<Phase, readonly number[]>;
 export interface DispatchPlanEntry {
     agentId: number;
     status: 'scheduled' | 'disabled' | 'unregistered';
@@ -14,27 +20,78 @@ export interface PhaseRunResult {
     agentResults: Record<number, AgentResult>;
     skippedAgents: number[];
     costTracker: CostTracker;
+    /** Cross-agent correlation of every finding produced this phase. */
+    correlation: CorrelationResult;
+}
+/**
+ * Optional heal-vs-ask escalation wiring (Phase 3.4 track (a)). When supplied, the
+ * fix loop routes each code-bug finding through {@link decideHealOrAsk}: simple, safe,
+ * confident findings auto-heal (the Fixer runs); complex/risky/low-confidence ones
+ * PAUSE on `gate.ask(...)` until the human answers, and the run resumes on that answer.
+ * Omitted ⇒ legacy behaviour (the Fixer always runs for code-bugs), so every existing
+ * caller is byte-for-byte unaffected — this is an additive seam, like the run-event sink.
+ */
+export interface EscalationConfig {
+    /** The inline pause-and-ask gate the run pauses on (the Bridge wires it to the Cockpit). */
+    readonly gate: PauseGate;
+    /** Auto-heal confidence bar for a simple, safe finding (default 0.8 inside decideHealOrAsk). */
+    readonly threshold?: number;
+    /** Optional Calibration tie-in — tightens the bar when the agent has been overconfident. */
+    readonly calibrator?: Calibrator;
 }
 export declare class Orchestrator {
     private readonly config;
     private readonly agents;
+    /** SDK custom-agent IDs registered on this instance, dispatched alongside PHASE_DISPATCH. */
+    private readonly customAgentIds;
     private readonly healthChecks;
     private runDir;
     private readonly agentMvpClient;
+    /**
+     * Live run-event stream (Phase 3.3 Cockpit foundation). Additive seam: defaults to a
+     * no-op-sink emitter so an orchestrator constructed without one behaves exactly as before
+     * and emits nothing observable. The Bridge SSE layer injects a real sink to stream a run.
+     */
+    private readonly runEvents;
+    /**
+     * Optional heal-vs-ask escalation (Phase 3.4 track (a)). Undefined ⇒ the fix loop
+     * behaves exactly as before (the Fixer auto-runs for code-bugs).
+     */
+    private readonly escalation?;
     /**
      * License tier resolver — injectable for testing.
      * Defaults to `getLicenseTier()` from the license module.
      */
     _getLicenseTier: () => LicenseTier;
-    constructor(config: ValidatedConfig, runDir?: string, agentMvpClient?: AgentMvpClient);
+    constructor(config: ValidatedConfig, runDir?: string, agentMvpClient?: AgentMvpClient, runEvents?: RunEventEmitter, escalation?: EscalationConfig);
+    /** The live run-event emitter for this orchestrator (no-op sink unless one was injected). */
+    getRunEvents(): RunEventEmitter;
     /** Register an agent instance for a given agent ID. */
     registerAgent(agentId: number, agent: BaseAgent): void;
+    /**
+     * Register an SDK custom agent (ID >= 100). Unlike built-ins, custom agents
+     * are not in PHASE_DISPATCH, so they're tracked here and appended to the
+     * dispatch for whatever phase this orchestrator runs.
+     */
+    registerCustomAgent(agentId: number, agent: BaseAgent): void;
     /** Register health checks to run before agent dispatch. */
     registerHealthChecks(checks: HealthCheck[]): void;
     /** Return the dispatch plan for a phase without executing anything. */
     dryRun(phase: Phase): DispatchPlanEntry[];
     /** Execute all agents for the given phase, evaluate the gate, and return results. */
     runPhase(phase: Phase): Promise<PhaseRunResult>;
+    /**
+     * Run a SINGLE registered agent by id, end to end, and return its AgentResult.
+     *
+     * This is the real "run agent #N as the product defines it" path — it invokes
+     * the agent's own `run()` (the same call the phase batch loop makes), so the
+     * agent's full cognition executes, not the generic /execute executor primitive.
+     * The caller must have registered the agent first (registerAllAgents). Emits the
+     * agent-started/finished run-events and persists the result to the run dir.
+     *
+     * Throws if the agent id is not registered on this orchestrator.
+     */
+    runSingleAgent(agentId: number, phase?: Phase): Promise<AgentResult>;
     /**
      * After all phase agents complete, classify findings and dispatch cross-phase
      * agents on demand:
@@ -44,6 +101,20 @@ export declare class Orchestrator {
      * Iterates up to MAX_FIX_LOOP_ITERATIONS times to prevent infinite heal/fix loops.
      */
     private runFixLoop;
+    /**
+     * Track (a) heal-vs-ask: route each code-bug finding through {@link decideHealOrAsk}.
+     * Auto-heal findings clear immediately; pause-and-ask findings suspend on
+     * `gate.ask(...)` until the human answers (the run resumes on that answer). A
+     * `reject` answer leaves the finding uncleared; `approve`/`modify` clears it.
+     *
+     * Returns `true` only when EVERY code-bug is cleared — a single human rejection
+     * vetoes the whole auto-fix pass (first-do-no-harm: don't auto-touch code the human
+     * said no to, since the coarse Fixer cannot selectively skip one finding).
+     *
+     * `decisionCache` (keyed by `finding.id`) makes each finding asked at most once per
+     * run even across fix-loop iterations.
+     */
+    private resolveHealOrAsk;
     /**
      * After a phase completes, send scoring events to Agent-MVP for each agent
      * that produced results. Passed agents receive +1.0, failed agents receive -0.5.

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

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAW,MAAM,SAAS,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAwB5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAiBD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IAEvD;;;OAGG;IACH,eAAe,EAAE,MAAM,WAAW,CAA0B;gBAEhD,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc;IAMrF,uDAAuD;IACvD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAItD,2DAA2D;IAC3D,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAIjD,uEAAuE;IACvE,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,iBAAiB,EAAE;IAazC,qFAAqF;IAC/E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC;IAyLrD;;;;;;;OAOG;YACW,UAAU;IAwDxB;;;OAGG;YACW,gBAAgB;IAmC9B,sEAAsE;IACtE,OAAO,CAAC,iBAAiB;IAyBzB,kCAAkC;IAClC,SAAS,IAAI,MAAM;CAGpB"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../core/orchestrator.ts"],"names":[],"mappings":"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"}