agentic-qe 3.6.0 → 3.6.2

package/v3/dist/agents/devils-advocate/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Agentic QE v3 - Devil's Advocate Agent Types
+ * ADR-064, Phase 2C: Type definitions for the Devil's Advocate agent
+ *
+ * The Devil's Advocate agent challenges other agents' outputs by reviewing
+ * test completeness, questioning security scan results, and identifying
+ * coverage gaps in claimed results.
+ *
+ * @module agents/devils-advocate
+ */
+/**
+ * The kind of output being challenged by the Devil's Advocate.
+ * Each target type maps to specific challenge strategies that know
+ * how to inspect and critique that category of output.
+ */
+export type ChallengeTargetType = 'test-generation' | 'coverage-analysis' | 'security-scan' | 'quality-assessment' | 'defect-prediction' | 'contract-validation' | 'requirements';
+/**
+ * All valid challenge target types, for runtime validation.
+ */
+export declare const ALL_CHALLENGE_TARGET_TYPES: readonly ChallengeTargetType[];
+/**
+ * The output being challenged by the Devil's Advocate.
+ * Represents the concrete artifact produced by another agent
+ * that will be subjected to critical review.
+ */
+export interface ChallengeTarget {
+    /** What kind of output is being challenged */
+    readonly type: ChallengeTargetType;
+    /** ID of the agent that produced this output */
+    readonly agentId: string;
+    /** Domain this output belongs to */
+    readonly domain: string;
+    /** The actual output data to be challenged */
+    readonly output: Record<string, unknown>;
+    /** When this output was produced (epoch ms) */
+    readonly timestamp: number;
+    /** Optional task ID for traceability */
+    readonly taskId?: string;
+}
+/**
+ * Severity of a challenge finding. Determines the urgency
+ * and impact assessment of a discovered gap or weakness.
+ */
+export type ChallengeSeverity = 'critical' | 'high' | 'medium' | 'low' | 'informational';
+/**
+ * All valid challenge severities in descending order of importance.
+ * Used for filtering and sorting challenges.
+ */
+export declare const SEVERITY_ORDER: readonly ChallengeSeverity[];
+/**
+ * Numeric weight for each severity level, used in score computation.
+ * Higher weight means greater negative impact on the overall score.
+ */
+export declare const SEVERITY_WEIGHTS: Readonly<Record<ChallengeSeverity, number>>;
+/**
+ * A specific challenge raised against an agent's output.
+ * Each challenge documents a gap, weakness, or questionable aspect
+ * found during the Devil's Advocate review.
+ */
+export interface Challenge {
+    /** Unique identifier for this challenge */
+    readonly id: string;
+    /** How severe this gap or weakness is */
+    readonly severity: ChallengeSeverity;
+    /** Category of the challenge (e.g., 'missing-edge-case', 'false-positive') */
+    readonly category: string;
+    /** Short descriptive title */
+    readonly title: string;
+    /** Detailed description of the challenge */
+    readonly description: string;
+    /** Evidence supporting this challenge */
+    readonly evidence: string;
+    /** What should be done to address this challenge */
+    readonly recommendation: string;
+    /** Confidence in this challenge being valid (0-1) */
+    readonly confidence: number;
+}
+/**
+ * Result of a Devil's Advocate review of an agent's output.
+ * Aggregates all challenges found and provides an overall assessment.
+ */
+export interface ChallengeResult {
+    /** What type of output was reviewed */
+    readonly targetType: ChallengeTargetType;
+    /** ID of the agent whose output was reviewed */
+    readonly targetAgentId: string;
+    /** All challenges found during the review */
+    readonly challenges: readonly Challenge[];
+    /** Overall score (0-1), where 1 means no challenges found */
+    readonly overallScore: number;
+    /** Human-readable summary of the review */
+    readonly summary: string;
+    /** When the review was completed (epoch ms) */
+    readonly timestamp: number;
+    /** How long the review took (ms) */
+    readonly reviewDuration: number;
+}
+/**
+ * Types of challenge strategies the Devil's Advocate can employ.
+ * Each strategy focuses on a specific category of potential weakness.
+ */
+export type ChallengeStrategyType = 'missing-edge-cases' | 'false-positive-detection' | 'coverage-gap-critique' | 'security-blind-spots' | 'assumption-questioning' | 'boundary-value-gaps' | 'error-handling-gaps';
+/**
+ * All valid challenge strategy types, for runtime validation.
+ */
+export declare const ALL_CHALLENGE_STRATEGY_TYPES: readonly ChallengeStrategyType[];
+/**
+ * Interface that all challenge strategies must implement.
+ * Each strategy inspects a target output and produces challenges.
+ */
+export interface ChallengeStrategy {
+    /** Which strategy type this implements */
+    readonly type: ChallengeStrategyType;
+    /** Which target types this strategy can be applied to */
+    readonly applicableTo: readonly ChallengeTargetType[];
+    /**
+     * Analyze the target output and produce challenges.
+     *
+     * @param target - The output being challenged
+     * @returns Array of challenges found
+     */
+    challenge(target: ChallengeTarget): Challenge[];
+}
+/**
+ * Configuration for Devil's Advocate behavior.
+ * Controls which strategies run, how sensitive the review is,
+ * and what gets included in the final result.
+ */
+export interface DevilsAdvocateConfig {
+    /** Minimum confidence to report a challenge (0-1). @default 0.3 */
+    readonly minConfidence: number;
+    /** Maximum challenges to report per review. @default 20 */
+    readonly maxChallengesPerReview: number;
+    /** Which challenge strategies to enable */
+    readonly enabledStrategies: readonly ChallengeStrategyType[];
+    /** Only include challenges at or above this severity. @default 'informational' */
+    readonly minSeverity: ChallengeSeverity;
+}
+/**
+ * Default configuration for the Devil's Advocate agent.
+ */
+export declare const DEFAULT_DEVILS_ADVOCATE_CONFIG: DevilsAdvocateConfig;
+/**
+ * Accumulated statistics from Devil's Advocate reviews.
+ * Provides insight into the kinds of gaps being found across reviews.
+ */
+export interface DevilsAdvocateStats {
+    /** Total number of reviews performed */
+    readonly totalReviews: number;
+    /** Total number of challenges raised across all reviews */
+    readonly totalChallenges: number;
+    /** Challenge count broken down by severity */
+    readonly challengesBySeverity: Readonly<Record<ChallengeSeverity, number>>;
+    /** Challenge count broken down by category */
+    readonly challengesByCategory: Readonly<Record<string, number>>;
+    /** Average number of challenges per review */
+    readonly averageChallengesPerReview: number;
+    /** Average overall score across all reviews */
+    readonly averageScore: number;
+}
+/**
+ * Check if a string is a valid ChallengeTargetType.
+ *
+ * @param value - String to check
+ * @returns True if value is a valid ChallengeTargetType
+ */
+export declare function isChallengeTargetType(value: string): value is ChallengeTargetType;
+/**
+ * Check if a string is a valid ChallengeStrategyType.
+ *
+ * @param value - String to check
+ * @returns True if value is a valid ChallengeStrategyType
+ */
+export declare function isChallengeStrategyType(value: string): value is ChallengeStrategyType;
+/**
+ * Check if a string is a valid ChallengeSeverity.
+ *
+ * @param value - String to check
+ * @returns True if value is a valid ChallengeSeverity
+ */
+export declare function isChallengeSeverity(value: string): value is ChallengeSeverity;
+//# sourceMappingURL=types.d.ts.map

package/v3/dist/agents/devils-advocate/types.d.ts.map

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

package/v3/dist/agents/devils-advocate/types.js

@@ -0,0 +1,96 @@
+/**
+ * Agentic QE v3 - Devil's Advocate Agent Types
+ * ADR-064, Phase 2C: Type definitions for the Devil's Advocate agent
+ *
+ * The Devil's Advocate agent challenges other agents' outputs by reviewing
+ * test completeness, questioning security scan results, and identifying
+ * coverage gaps in claimed results.
+ *
+ * @module agents/devils-advocate
+ */
+/**
+ * All valid challenge target types, for runtime validation.
+ */
+export const ALL_CHALLENGE_TARGET_TYPES = [
+    'test-generation',
+    'coverage-analysis',
+    'security-scan',
+    'quality-assessment',
+    'defect-prediction',
+    'contract-validation',
+    'requirements',
+];
+/**
+ * All valid challenge severities in descending order of importance.
+ * Used for filtering and sorting challenges.
+ */
+export const SEVERITY_ORDER = [
+    'critical',
+    'high',
+    'medium',
+    'low',
+    'informational',
+];
+/**
+ * Numeric weight for each severity level, used in score computation.
+ * Higher weight means greater negative impact on the overall score.
+ */
+export const SEVERITY_WEIGHTS = {
+    critical: 0.25,
+    high: 0.15,
+    medium: 0.08,
+    low: 0.03,
+    informational: 0.01,
+};
+/**
+ * All valid challenge strategy types, for runtime validation.
+ */
+export const ALL_CHALLENGE_STRATEGY_TYPES = [
+    'missing-edge-cases',
+    'false-positive-detection',
+    'coverage-gap-critique',
+    'security-blind-spots',
+    'assumption-questioning',
+    'boundary-value-gaps',
+    'error-handling-gaps',
+];
+/**
+ * Default configuration for the Devil's Advocate agent.
+ */
+export const DEFAULT_DEVILS_ADVOCATE_CONFIG = {
+    minConfidence: 0.3,
+    maxChallengesPerReview: 20,
+    enabledStrategies: ALL_CHALLENGE_STRATEGY_TYPES,
+    minSeverity: 'informational',
+};
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if a string is a valid ChallengeTargetType.
+ *
+ * @param value - String to check
+ * @returns True if value is a valid ChallengeTargetType
+ */
+export function isChallengeTargetType(value) {
+    return ALL_CHALLENGE_TARGET_TYPES.includes(value);
+}
+/**
+ * Check if a string is a valid ChallengeStrategyType.
+ *
+ * @param value - String to check
+ * @returns True if value is a valid ChallengeStrategyType
+ */
+export function isChallengeStrategyType(value) {
+    return ALL_CHALLENGE_STRATEGY_TYPES.includes(value);
+}
+/**
+ * Check if a string is a valid ChallengeSeverity.
+ *
+ * @param value - String to check
+ * @returns True if value is a valid ChallengeSeverity
+ */
+export function isChallengeSeverity(value) {
+    return SEVERITY_ORDER.includes(value);
+}
+//# sourceMappingURL=types.js.map

package/v3/dist/agents/devils-advocate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/devils-advocate/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAmC;IACxE,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,oBAAoB;IACpB,mBAAmB;IACnB,qBAAqB;IACrB,cAAc;CACN,CAAC;AAqCX;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,UAAU;IACV,MAAM;IACN,QAAQ;IACR,KAAK;IACL,eAAe;CACP,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,IAAI;IACT,aAAa,EAAE,IAAI;CACX,CAAC;AAwEX;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAqC;IAC5E,oBAAoB;IACpB,0BAA0B;IAC1B,uBAAuB;IACvB,sBAAsB;IACtB,wBAAwB;IACxB,qBAAqB;IACrB,qBAAqB;CACb,CAAC;AAwCX;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IAClE,aAAa,EAAE,GAAG;IAClB,sBAAsB,EAAE,EAAE;IAC1B,iBAAiB,EAAE,4BAA4B;IAC/C,WAAW,EAAE,eAAe;CACpB,CAAC;AAyBX,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAQ,0BAAgD,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAQ,4BAAkD,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/v3/dist/agents/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agentic QE v3 - Agents Layer
+ * Specialized QE agents (Devil's Advocate, Claim Verifier)
+ *
+ * Re-exported as namespaces to avoid name collisions with generic names
+ * like "Evidence", "Claim", "Challenge" etc.
+ *
+ * @module agents
+ *
+ * @example
+ * ```typescript
+ * import { DevilsAdvocate, ClaimVerifier } from '@agentic-qe/v3/agents';
+ *
+ * const da = DevilsAdvocate.createDevilsAdvocate();
+ * const cv = ClaimVerifier.createClaimVerifierService();
+ * ```
+ */
+export * as DevilsAdvocate from './devils-advocate/index.js';
+export * as ClaimVerifier from './claim-verifier/index.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC"}

package/v3/dist/agents/index.js

@@ -0,0 +1,20 @@
+/**
+ * Agentic QE v3 - Agents Layer
+ * Specialized QE agents (Devil's Advocate, Claim Verifier)
+ *
+ * Re-exported as namespaces to avoid name collisions with generic names
+ * like "Evidence", "Claim", "Challenge" etc.
+ *
+ * @module agents
+ *
+ * @example
+ * ```typescript
+ * import { DevilsAdvocate, ClaimVerifier } from '@agentic-qe/v3/agents';
+ *
+ * const da = DevilsAdvocate.createDevilsAdvocate();
+ * const cv = ClaimVerifier.createClaimVerifierService();
+ * ```
+ */
+export * as DevilsAdvocate from './devils-advocate/index.js';
+export * as ClaimVerifier from './claim-verifier/index.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC"}