agentic-qe 3.6.0 → 3.6.2

package/v3/dist/coordination/federation/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Agentic QE v3 - Cross-Fleet Federation Module
+ * ADR-064 Phase 4B: Multi-Service Communication
+ *
+ * Enables multiple fleet instances (e.g., running in different services or
+ * repositories) to exchange messages through a federation layer. Services
+ * register with the FederationMailbox, which handles routing, health
+ * monitoring, and queue management.
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createFederationMailbox,
+ *   FederationMailbox,
+ * } from '@agentic-qe/v3/coordination/federation';
+ *
+ * const mailbox = createFederationMailbox({ localFleetId: 'fleet-a' });
+ *
+ * // Register a remote fleet service
+ * mailbox.registerService('fleet-b', 'Coverage Service', ['coverage-analysis']);
+ *
+ * // Route and send messages
+ * mailbox.addRoute('test-generation', 'coverage-analysis', 'fleet-b', 10);
+ * mailbox.send('fleet-b', 'test-generation', 'coverage-analysis',
+ *   'task-request', { spec: 'auth-module' });
+ *
+ * // Transport layer drains outbox
+ * const pending = mailbox.drainOutbox();
+ *
+ * // Cleanup
+ * mailbox.dispose();
+ * ```
+ */
+export { FederationMailbox, createFederationMailbox, } from './federation-mailbox.js';
+export type { FederatedMessageHandler } from './federation-mailbox.js';
+export type { FleetId, FederatedService, FederatedMessage, FederatedMessageType, FederationRoute, FederationHealth, FederationConfig, ServiceStatus, } from './types.js';
+export { DEFAULT_FEDERATION_CONFIG } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/coordination/federation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/coordination/federation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAMvE,YAAY,EACV,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}

package/v3/dist/coordination/federation/index.js

@@ -0,0 +1,39 @@
+/**
+ * Agentic QE v3 - Cross-Fleet Federation Module
+ * ADR-064 Phase 4B: Multi-Service Communication
+ *
+ * Enables multiple fleet instances (e.g., running in different services or
+ * repositories) to exchange messages through a federation layer. Services
+ * register with the FederationMailbox, which handles routing, health
+ * monitoring, and queue management.
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createFederationMailbox,
+ *   FederationMailbox,
+ * } from '@agentic-qe/v3/coordination/federation';
+ *
+ * const mailbox = createFederationMailbox({ localFleetId: 'fleet-a' });
+ *
+ * // Register a remote fleet service
+ * mailbox.registerService('fleet-b', 'Coverage Service', ['coverage-analysis']);
+ *
+ * // Route and send messages
+ * mailbox.addRoute('test-generation', 'coverage-analysis', 'fleet-b', 10);
+ * mailbox.send('fleet-b', 'test-generation', 'coverage-analysis',
+ *   'task-request', { spec: 'auth-module' });
+ *
+ * // Transport layer drains outbox
+ * const pending = mailbox.drainOutbox();
+ *
+ * // Cleanup
+ * mailbox.dispose();
+ * ```
+ */
+// ============================================================================
+// Federation Mailbox
+// ============================================================================
+export { FederationMailbox, createFederationMailbox, } from './federation-mailbox.js';
+export { DEFAULT_FEDERATION_CONFIG } from './types.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/coordination/federation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/coordination/federation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAmBjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}

package/v3/dist/coordination/federation/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Agentic QE v3 - Cross-Fleet Federation Types
+ * ADR-064 Phase 4B: Multi-Service Communication
+ *
+ * Defines the type contracts for cross-fleet federation, enabling multiple
+ * fleet instances (e.g., running in different services/repos) to exchange
+ * messages through a federation layer.
+ *
+ * Types are intentionally readonly to enforce immutability at public API
+ * boundaries. Mutable counterparts live inside the FederationMailbox class.
+ */
+/** Unique identifier for a fleet instance in the federation */
+export type FleetId = string;
+/** Service registration in the federation */
+export interface FederatedService {
+    /** Unique fleet identifier for this service */
+    readonly fleetId: FleetId;
+    /** Human-readable service name */
+    readonly name: string;
+    /** QE domains this service handles (e.g., 'test-generation', 'coverage-analysis') */
+    readonly domains: string[];
+    /** Optional transport endpoint for remote communication */
+    readonly endpoint?: string;
+    /** Current health status of the service */
+    readonly status: ServiceStatus;
+    /** Epoch timestamp when the service was registered */
+    readonly registeredAt: number;
+    /** Epoch timestamp of the last heartbeat received */
+    readonly lastHeartbeat: number;
+    /** Arbitrary metadata attached to the service */
+    readonly metadata?: Record<string, string>;
+}
+/** Health status of a federated service */
+export type ServiceStatus = 'active' | 'degraded' | 'unreachable' | 'deregistered';
+/** Message routed between fleet instances */
+export interface FederatedMessage {
+    /** Unique message identifier */
+    readonly id: string;
+    /** Fleet that originated this message */
+    readonly sourceFleetId: FleetId;
+    /** Target fleet ID, or 'any' for route-based resolution */
+    readonly targetFleetId: FleetId | 'any';
+    /** Domain context of the sender */
+    readonly sourceDomain: string;
+    /** Domain context the message is intended for */
+    readonly targetDomain: string;
+    /** Classification of the message */
+    readonly type: FederatedMessageType;
+    /** Message payload (type depends on message type) */
+    readonly payload: unknown;
+    /** Epoch timestamp when the message was created */
+    readonly timestamp: number;
+    /** Time-to-live in milliseconds (message expires after this duration) */
+    readonly ttl?: number;
+    /** Correlation ID for tracking related messages across fleets */
+    readonly correlationId?: string;
+}
+/** Types of messages exchanged between federated fleets */
+export type FederatedMessageType = 'task-request' | 'task-response' | 'finding-share' | 'pattern-share' | 'health-report' | 'capability-query' | 'capability-response';
+/** Route definition for cross-fleet message routing */
+export interface FederationRoute {
+    /** Source domain that sends messages via this route */
+    readonly sourceDomain: string;
+    /** Target domain that receives messages via this route */
+    readonly targetDomain: string;
+    /** Fleet ID this route delivers to */
+    readonly targetFleetId: FleetId;
+    /** Priority for route selection (higher = preferred) */
+    readonly priority: number;
+    /** Whether this route is currently active */
+    readonly active: boolean;
+}
+/** Federation health summary */
+export interface FederationHealth {
+    /** This fleet's identifier */
+    readonly localFleetId: FleetId;
+    /** Number of services currently in 'active' status */
+    readonly connectedServices: number;
+    /** Number of active routing rules */
+    readonly activeRoutes: number;
+    /** Total pending messages in inbox + outbox */
+    readonly pendingMessages: number;
+    /** Total messages sent since creation */
+    readonly messagesSent: number;
+    /** Total messages received since creation */
+    readonly messagesReceived: number;
+}
+/** Configuration for the federation mailbox */
+export interface FederationConfig {
+    /** This fleet's unique identifier in the federation */
+    readonly localFleetId: FleetId;
+    /** Interval between heartbeat checks in milliseconds */
+    readonly heartbeatIntervalMs: number;
+    /** Time after last heartbeat before a service is marked unreachable */
+    readonly serviceTimeoutMs: number;
+    /** Maximum number of pending messages (inbox + outbox each) */
+    readonly maxPendingMessages: number;
+    /** Maximum number of routing rules */
+    readonly maxRoutes: number;
+}
+/** Sensible defaults for federation configuration */
+export declare const DEFAULT_FEDERATION_CONFIG: FederationConfig;
+//# sourceMappingURL=types.d.ts.map

package/v3/dist/coordination/federation/types.d.ts.map

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

package/v3/dist/coordination/federation/types.js

@@ -0,0 +1,20 @@
+/**
+ * Agentic QE v3 - Cross-Fleet Federation Types
+ * ADR-064 Phase 4B: Multi-Service Communication
+ *
+ * Defines the type contracts for cross-fleet federation, enabling multiple
+ * fleet instances (e.g., running in different services/repos) to exchange
+ * messages through a federation layer.
+ *
+ * Types are intentionally readonly to enforce immutability at public API
+ * boundaries. Mutable counterparts live inside the FederationMailbox class.
+ */
+/** Sensible defaults for federation configuration */
+export const DEFAULT_FEDERATION_CONFIG = {
+    localFleetId: 'local',
+    heartbeatIntervalMs: 30_000,
+    serviceTimeoutMs: 90_000,
+    maxPendingMessages: 5000,
+    maxRoutes: 100,
+};
+//# sourceMappingURL=types.js.map

package/v3/dist/coordination/federation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/coordination/federation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+JH,qDAAqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,YAAY,EAAE,OAAO;IACrB,mBAAmB,EAAE,MAAM;IAC3B,gBAAgB,EAAE,MAAM;IACxB,kBAAkB,EAAE,IAAI;IACxB,SAAS,EAAE,GAAG;CACf,CAAC"}

package/v3/dist/coordination/fleet-tiers/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Agentic QE v3 - Fleet Tier Activation System
+ * ADR-064 Phase 1D: Tiered Fleet Activation Configuration
+ *
+ * Controls how many agents activate based on task complexity, balancing
+ * cost against validation thoroughness. Four tiers from lightweight smoke
+ * runs (every commit) through full crisis mode (production incidents).
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createTierSelector,
+ *   getDefaultTierConfig,
+ *   DEFAULT_TIER_CONFIGS,
+ * } from './coordination/fleet-tiers';
+ *
+ * // Create a selector with default configs
+ * const selector = createTierSelector();
+ *
+ * // Select tier based on context
+ * const result = selector.selectTier({
+ *   trigger: 'pr',
+ *   changedFiles: 5,
+ *   affectedDomains: ['test-generation', 'coverage-analysis'],
+ * });
+ *
+ * console.log(result.selectedTier); // 'standard'
+ * console.log(result.agentAllocation);
+ *
+ * // Escalate if needed
+ * const escalated = selector.escalate('standard', 'Flaky test detected');
+ * console.log(escalated.selectedTier); // 'deep'
+ * ```
+ */
+export type { FleetTier, TierCostLevel, TierTriggerType, TierTrigger, TierConfig, TierSelectionContext, AgentAllocation, TierSelectionResult, TierSelectionRecord, TierSelectionStats, } from './types';
+export { FLEET_TIER_ORDER } from './types';
+export { ALL_USER_FACING_DOMAINS, CORE_PRIORITY_DOMAINS, DEFAULT_DOMAIN_AGENT_MAP, DEFAULT_TIER_CONFIGS, getDefaultTierConfig, validateTierConfig, } from './tier-config';
+export { TierSelector, createTierSelector } from './tier-selector';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/coordination/fleet-tiers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/coordination/fleet-tiers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH,YAAY,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAM3C,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/v3/dist/coordination/fleet-tiers/index.js

@@ -0,0 +1,44 @@
+/**
+ * Agentic QE v3 - Fleet Tier Activation System
+ * ADR-064 Phase 1D: Tiered Fleet Activation Configuration
+ *
+ * Controls how many agents activate based on task complexity, balancing
+ * cost against validation thoroughness. Four tiers from lightweight smoke
+ * runs (every commit) through full crisis mode (production incidents).
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createTierSelector,
+ *   getDefaultTierConfig,
+ *   DEFAULT_TIER_CONFIGS,
+ * } from './coordination/fleet-tiers';
+ *
+ * // Create a selector with default configs
+ * const selector = createTierSelector();
+ *
+ * // Select tier based on context
+ * const result = selector.selectTier({
+ *   trigger: 'pr',
+ *   changedFiles: 5,
+ *   affectedDomains: ['test-generation', 'coverage-analysis'],
+ * });
+ *
+ * console.log(result.selectedTier); // 'standard'
+ * console.log(result.agentAllocation);
+ *
+ * // Escalate if needed
+ * const escalated = selector.escalate('standard', 'Flaky test detected');
+ * console.log(escalated.selectedTier); // 'deep'
+ * ```
+ */
+export { FLEET_TIER_ORDER } from './types';
+// ============================================================================
+// Configuration
+// ============================================================================
+export { ALL_USER_FACING_DOMAINS, CORE_PRIORITY_DOMAINS, DEFAULT_DOMAIN_AGENT_MAP, DEFAULT_TIER_CONFIGS, getDefaultTierConfig, validateTierConfig, } from './tier-config';
+// ============================================================================
+// Selector
+// ============================================================================
+export { TierSelector, createTierSelector } from './tier-selector';
+//# sourceMappingURL=index.js.map

package/v3/dist/coordination/fleet-tiers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/coordination/fleet-tiers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAmBH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/v3/dist/coordination/fleet-tiers/tier-config.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Agentic QE v3 - Fleet Tier Configuration Defaults
+ * ADR-064 Phase 1D: Tiered Fleet Activation Configuration
+ *
+ * Provides the default tier configurations for all four fleet tiers.
+ * These defaults can be overridden by passing custom configs to the
+ * TierSelector constructor.
+ */
+import type { DomainName } from '../../shared/types';
+import type { FleetTier, TierConfig } from './types';
+/**
+ * All 13 user-facing domain names (excludes 'coordination' which is internal).
+ * Used when a tier specifies `['all']` or needs the full domain list.
+ */
+export declare const ALL_USER_FACING_DOMAINS: readonly DomainName[];
+/**
+ * Core domains that receive priority allocation when agents are limited.
+ * These domains cover the most critical quality engineering activities.
+ */
+export declare const CORE_PRIORITY_DOMAINS: readonly DomainName[];
+/**
+ * Maps each domain to the agent types that operate within it.
+ * Used by the TierSelector when allocating agents to domains.
+ */
+export declare const DEFAULT_DOMAIN_AGENT_MAP: Readonly<Record<string, readonly string[]>>;
+/**
+ * Default configurations for all four fleet tiers.
+ * Keyed by FleetTier for O(1) lookup.
+ */
+export declare const DEFAULT_TIER_CONFIGS: Readonly<Record<FleetTier, TierConfig>>;
+/**
+ * Retrieve the default configuration for a given fleet tier.
+ *
+ * @param tier - The fleet tier to look up
+ * @returns The default TierConfig for the requested tier
+ *
+ * @example
+ * ```typescript
+ * const config = getDefaultTierConfig('standard');
+ * console.log(config.maxAgents); // 7
+ * ```
+ */
+export declare function getDefaultTierConfig(tier: FleetTier): TierConfig;
+/**
+ * Validate a tier configuration and return a list of validation errors.
+ * Returns an empty array if the configuration is valid.
+ *
+ * @param config - The TierConfig to validate
+ * @returns Array of human-readable validation error strings
+ *
+ * @example
+ * ```typescript
+ * const errors = validateTierConfig(myConfig);
+ * if (errors.length > 0) {
+ *   console.error('Invalid tier config:', errors);
+ * }
+ * ```
+ */
+export declare function validateTierConfig(config: TierConfig): string[];
+//# sourceMappingURL=tier-config.d.ts.map

package/v3/dist/coordination/fleet-tiers/tier-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-config.d.ts","sourceRoot":"","sources":["../../../src/coordination/fleet-tiers/tier-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AAMpE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,UAAU,EAc/C,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,UAAU,EAI7C,CAAC;AAMX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAcvE,CAAC;AAyFX;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAK/D,CAAC;AAMX;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAEhE;AAwBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAwD/D"}

package/v3/dist/coordination/fleet-tiers/tier-config.js

@@ -0,0 +1,242 @@
+/**
+ * Agentic QE v3 - Fleet Tier Configuration Defaults
+ * ADR-064 Phase 1D: Tiered Fleet Activation Configuration
+ *
+ * Provides the default tier configurations for all four fleet tiers.
+ * These defaults can be overridden by passing custom configs to the
+ * TierSelector constructor.
+ */
+// ============================================================================
+// Domain Constants
+// ============================================================================
+/**
+ * All 13 user-facing domain names (excludes 'coordination' which is internal).
+ * Used when a tier specifies `['all']` or needs the full domain list.
+ */
+export const ALL_USER_FACING_DOMAINS = [
+    'test-generation',
+    'test-execution',
+    'coverage-analysis',
+    'quality-assessment',
+    'defect-intelligence',
+    'requirements-validation',
+    'code-intelligence',
+    'security-compliance',
+    'contract-testing',
+    'visual-accessibility',
+    'chaos-resilience',
+    'learning-optimization',
+    'enterprise-integration',
+];
+/**
+ * Core domains that receive priority allocation when agents are limited.
+ * These domains cover the most critical quality engineering activities.
+ */
+export const CORE_PRIORITY_DOMAINS = [
+    'test-generation',
+    'coverage-analysis',
+    'quality-assessment',
+];
+// ============================================================================
+// Domain-to-Agent-Type Mapping
+// ============================================================================
+/**
+ * Maps each domain to the agent types that operate within it.
+ * Used by the TierSelector when allocating agents to domains.
+ */
+export const DEFAULT_DOMAIN_AGENT_MAP = {
+    'test-generation': ['generator', 'specialist'],
+    'test-execution': ['tester', 'coordinator'],
+    'coverage-analysis': ['analyzer', 'specialist'],
+    'quality-assessment': ['analyzer', 'validator'],
+    'defect-intelligence': ['analyzer', 'specialist'],
+    'requirements-validation': ['validator', 'reviewer'],
+    'code-intelligence': ['analyzer', 'specialist'],
+    'security-compliance': ['analyzer', 'validator'],
+    'contract-testing': ['tester', 'validator'],
+    'visual-accessibility': ['tester', 'validator'],
+    'chaos-resilience': ['tester', 'specialist'],
+    'learning-optimization': ['optimizer', 'specialist'],
+    'enterprise-integration': ['coordinator', 'validator'],
+};
+// ============================================================================
+// Smoke Tier (every commit)
+// ============================================================================
+/** Smoke tier: lightweight validation on every commit */
+const SMOKE_TIER_CONFIG = {
+    tier: 'smoke',
+    maxAgents: 3,
+    agentTeamsEnabled: false,
+    domains: ['test-execution', 'quality-assessment'],
+    estimatedCost: 'minimal',
+    description: 'Lightweight smoke test on every commit. Runs core test execution and quality assessment with minimal agent count to catch obvious regressions quickly.',
+    triggers: [
+        { type: 'commit' },
+        { type: 'schedule', conditions: { interval: 'hourly' } },
+    ],
+};
+// ============================================================================
+// Standard Tier (PR opened)
+// ============================================================================
+/** Standard tier: comprehensive PR validation */
+const STANDARD_TIER_CONFIG = {
+    tier: 'standard',
+    maxAgents: 7,
+    agentTeamsEnabled: false,
+    domains: [
+        'test-generation',
+        'test-execution',
+        'coverage-analysis',
+        'quality-assessment',
+        'security-compliance',
+    ],
+    estimatedCost: 'moderate',
+    description: 'Standard validation for pull requests. Covers test generation, execution, coverage, quality, and security across up to 7 agents. Agent teams are optional.',
+    triggers: [
+        { type: 'pr' },
+        { type: 'manual' },
+    ],
+};
+// ============================================================================
+// Deep Tier (pre-release, critical path)
+// ============================================================================
+/** Deep tier: thorough pre-release validation across all domains */
+const DEEP_TIER_CONFIG = {
+    tier: 'deep',
+    maxAgents: 15,
+    agentTeamsEnabled: true,
+    domains: [...ALL_USER_FACING_DOMAINS],
+    estimatedCost: 'high',
+    description: 'Deep validation for pre-release and critical path changes. Activates all 13 domains with up to 15 agents and full agent team collaboration.',
+    triggers: [
+        { type: 'release' },
+        { type: 'pr', conditions: { criticalPath: true } },
+        { type: 'manual', conditions: { requestedTier: 'deep' } },
+    ],
+};
+// ============================================================================
+// Crisis Tier (production incident)
+// ============================================================================
+/** Crisis tier: full activation with competing hypotheses for incidents */
+const CRISIS_TIER_CONFIG = {
+    tier: 'crisis',
+    maxAgents: 15,
+    agentTeamsEnabled: true,
+    domains: [...ALL_USER_FACING_DOMAINS],
+    estimatedCost: 'unlimited',
+    description: 'Crisis response for production incidents. All domains active with competing hypotheses enabled. Unlimited cost budget to resolve incidents as fast as possible.',
+    triggers: [
+        { type: 'incident' },
+        { type: 'manual', conditions: { requestedTier: 'crisis' } },
+    ],
+};
+// ============================================================================
+// Default Tier Config Map
+// ============================================================================
+/**
+ * Default configurations for all four fleet tiers.
+ * Keyed by FleetTier for O(1) lookup.
+ */
+export const DEFAULT_TIER_CONFIGS = {
+    smoke: SMOKE_TIER_CONFIG,
+    standard: STANDARD_TIER_CONFIG,
+    deep: DEEP_TIER_CONFIG,
+    crisis: CRISIS_TIER_CONFIG,
+};
+// ============================================================================
+// Accessor Functions
+// ============================================================================
+/**
+ * Retrieve the default configuration for a given fleet tier.
+ *
+ * @param tier - The fleet tier to look up
+ * @returns The default TierConfig for the requested tier
+ *
+ * @example
+ * ```typescript
+ * const config = getDefaultTierConfig('standard');
+ * console.log(config.maxAgents); // 7
+ * ```
+ */
+export function getDefaultTierConfig(tier) {
+    return DEFAULT_TIER_CONFIGS[tier];
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/** Valid cost levels for validation */
+const VALID_COST_LEVELS = [
+    'minimal',
+    'moderate',
+    'high',
+    'unlimited',
+];
+/** Valid trigger types for validation */
+const VALID_TRIGGER_TYPES = new Set([
+    'commit',
+    'pr',
+    'release',
+    'incident',
+    'manual',
+    'schedule',
+]);
+/**
+ * Validate a tier configuration and return a list of validation errors.
+ * Returns an empty array if the configuration is valid.
+ *
+ * @param config - The TierConfig to validate
+ * @returns Array of human-readable validation error strings
+ *
+ * @example
+ * ```typescript
+ * const errors = validateTierConfig(myConfig);
+ * if (errors.length > 0) {
+ *   console.error('Invalid tier config:', errors);
+ * }
+ * ```
+ */
+export function validateTierConfig(config) {
+    const errors = [];
+    // Validate tier name
+    const validTiers = ['smoke', 'standard', 'deep', 'crisis'];
+    if (!validTiers.includes(config.tier)) {
+        errors.push(`Invalid tier name: "${config.tier}". Must be one of: ${validTiers.join(', ')}`);
+    }
+    // Validate maxAgents
+    if (!Number.isInteger(config.maxAgents) || config.maxAgents < 1) {
+        errors.push(`maxAgents must be a positive integer, got: ${config.maxAgents}`);
+    }
+    if (config.maxAgents > 15) {
+        errors.push(`maxAgents exceeds fleet maximum of 15, got: ${config.maxAgents}`);
+    }
+    // Validate domains
+    if (!Array.isArray(config.domains) || config.domains.length === 0) {
+        errors.push('domains must be a non-empty array');
+    }
+    // Validate estimatedCost
+    if (!VALID_COST_LEVELS.includes(config.estimatedCost)) {
+        errors.push(`Invalid estimatedCost: "${config.estimatedCost}". Must be one of: ${VALID_COST_LEVELS.join(', ')}`);
+    }
+    // Validate description
+    if (!config.description || config.description.trim().length === 0) {
+        errors.push('description must be a non-empty string');
+    }
+    // Validate triggers
+    if (!Array.isArray(config.triggers) || config.triggers.length === 0) {
+        errors.push('triggers must be a non-empty array');
+    }
+    else {
+        for (let i = 0; i < config.triggers.length; i++) {
+            const trigger = config.triggers[i];
+            if (!trigger || !VALID_TRIGGER_TYPES.has(trigger.type)) {
+                errors.push(`triggers[${i}] has invalid type: "${trigger?.type}". Must be one of: ${[...VALID_TRIGGER_TYPES].join(', ')}`);
+            }
+        }
+    }
+    // Validate agentTeamsEnabled consistency
+    if (config.agentTeamsEnabled && config.maxAgents < 3) {
+        errors.push('agentTeamsEnabled requires maxAgents >= 3 for meaningful team collaboration');
+    }
+    return errors;
+}
+//# sourceMappingURL=tier-config.js.map

package/v3/dist/coordination/fleet-tiers/tier-config.js.map

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