dino-spec 17.4.2 → 17.5.0

package/dist/core/agents/gap-detector.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Gap Detector - v17.5.0
+ *
+ * Detects gaps between expected and delivered outputs in multi-agent systems.
+ * Monitors agent health, acceptance criteria completion, and dependency satisfaction.
+ *
+ * Features:
+ * - Specification matching (delivered vs expected)
+ * - Dependency graph tracking
+ * - Acceptance criteria monitoring
+ * - Stuck agent detection
+ * - Gap report generation
+ * - Automatic re-routing on failure
+ *
+ * @module gap-detector
+ */
+import { type DependencyAnalysis, DependencyGraph } from './dependency-graph.js';
+/**
+ * Expected output specification
+ */
+export interface OutputSpec {
+    /** Unique identifier */
+    id: string;
+    /** Description of expected output */
+    description: string;
+    /** Type of output */
+    type: 'file' | 'artifact' | 'state' | 'message';
+    /** Path or identifier for the output */
+    target: string;
+    /** Validation function or pattern */
+    validation?: {
+        pattern?: string;
+        minLength?: number;
+        required?: boolean;
+    };
+}
+/**
+ * Acceptance criterion
+ */
+export interface AcceptanceCriterion {
+    /** Unique identifier */
+    id: string;
+    /** Description of the criterion */
+    description: string;
+    /** Whether it's been met */
+    met: boolean;
+    /** Evidence that it's been met */
+    evidence?: string;
+    /** Priority */
+    priority: 'required' | 'optional';
+}
+/**
+ * Agent health status
+ */
+export interface AgentHealth {
+    /** Agent identifier */
+    agentId: string;
+    /** Current status */
+    status: 'healthy' | 'degraded' | 'unhealthy' | 'stuck' | 'unknown';
+    /** Last heartbeat timestamp */
+    lastHeartbeat: Date;
+    /** Time since last activity (ms) */
+    idleTime: number;
+    /** Current task if any */
+    currentTask?: string;
+    /** Error count */
+    errorCount: number;
+    /** Circuit breaker state */
+    circuitState: 'closed' | 'open' | 'half-open';
+}
+/**
+ * Gap report entry
+ */
+export interface GapReportEntry {
+    /** Type of gap */
+    type: 'output' | 'dependency' | 'criteria' | 'health';
+    /** Severity */
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    /** Description */
+    description: string;
+    /** Affected entity ID */
+    entityId: string;
+    /** Suggested action */
+    suggestedAction: string;
+    /** Whether auto-recovery was attempted */
+    autoRecoveryAttempted: boolean;
+    /** Recovery result if attempted */
+    recoveryResult?: 'success' | 'failed' | 'pending';
+}
+/**
+ * Full gap report
+ */
+export interface GapReport {
+    /** Report timestamp */
+    timestamp: Date;
+    /** Summary statistics */
+    summary: {
+        totalGaps: number;
+        criticalGaps: number;
+        highGaps: number;
+        mediumGaps: number;
+        lowGaps: number;
+        autoRecovered: number;
+    };
+    /** Individual gap entries */
+    entries: GapReportEntry[];
+    /** Dependency analysis */
+    dependencyAnalysis: DependencyAnalysis;
+    /** Acceptance criteria status */
+    criteriaStatus: {
+        total: number;
+        met: number;
+        unmet: number;
+        percentComplete: number;
+    };
+    /** Agent health summary */
+    agentHealth: AgentHealth[];
+    /** Recommended actions */
+    recommendations: string[];
+}
+/**
+ * Re-routing decision
+ */
+export interface RerouteDecision {
+    /** Whether to re-route */
+    shouldReroute: boolean;
+    /** Reason for the decision */
+    reason: string;
+    /** Original agent */
+    fromAgent: string;
+    /** Target agent (if re-routing) */
+    toAgent?: string;
+    /** Task to transfer */
+    taskId: string;
+    /** Priority of re-routing */
+    priority: 'immediate' | 'next_available' | 'low';
+}
+/**
+ * Gap detector configuration
+ */
+export interface GapDetectorConfig {
+    /** Threshold for stuck agent detection (ms) */
+    stuckThresholdMs: number;
+    /** Enable auto-recovery */
+    enableAutoRecovery: boolean;
+    /** Max recovery attempts per task */
+    maxRecoveryAttempts: number;
+    /** Health check interval (ms) */
+    healthCheckIntervalMs: number;
+}
+export declare const DEFAULT_GAP_DETECTOR_CONFIG: GapDetectorConfig;
+/**
+ * Detects and reports gaps in multi-agent execution
+ */
+export declare class GapDetector {
+    private config;
+    private dependencyGraph;
+    private outputSpecs;
+    private deliveredOutputs;
+    private acceptanceCriteria;
+    private agentHealth;
+    private recoveryAttempts;
+    constructor(config?: Partial<GapDetectorConfig>);
+    /**
+     * Register an expected output
+     */
+    registerOutput(spec: OutputSpec): void;
+    /**
+     * Mark an output as delivered
+     */
+    markOutputDelivered(specId: string, value?: unknown): void;
+    /**
+     * Check if an output matches its specification
+     */
+    checkOutputMatch(specId: string): {
+        matches: boolean;
+        gaps: string[];
+    };
+    /**
+     * Get all output gaps
+     */
+    getOutputGaps(): GapReportEntry[];
+    /**
+     * Register acceptance criteria
+     */
+    registerCriteria(criteria: AcceptanceCriterion[]): void;
+    /**
+     * Mark a criterion as met
+     */
+    markCriterionMet(criterionId: string, evidence?: string): void;
+    /**
+     * Get criteria status
+     */
+    getCriteriaStatus(): {
+        total: number;
+        met: number;
+        unmet: number;
+        percentComplete: number;
+        required: {
+            met: number;
+            total: number;
+        };
+        optional: {
+            met: number;
+            total: number;
+        };
+    };
+    /**
+     * Get criteria gaps
+     */
+    getCriteriaGaps(): GapReportEntry[];
+    /**
+     * Get the dependency graph
+     */
+    getDependencyGraph(): DependencyGraph;
+    /**
+     * Set the dependency graph
+     */
+    setDependencyGraph(graph: DependencyGraph): void;
+    /**
+     * Get dependency gaps
+     */
+    getDependencyGaps(): GapReportEntry[];
+    /**
+     * Update agent health status
+     */
+    updateAgentHealth(agentId: string, update: Partial<Omit<AgentHealth, 'agentId'>>): void;
+    /**
+     * Record agent heartbeat
+     */
+    recordHeartbeat(agentId: string): void;
+    /**
+     * Record agent error
+     */
+    recordAgentError(agentId: string): void;
+    /**
+     * Check for stuck agents
+     */
+    checkStuckAgents(): AgentHealth[];
+    /**
+     * Get agent health gaps
+     */
+    getHealthGaps(): GapReportEntry[];
+    /**
+     * Get all agent health statuses
+     */
+    getAllAgentHealth(): AgentHealth[];
+    /**
+     * Determine if a task should be re-routed
+     */
+    shouldReroute(taskId: string, currentAgent: string, availableAgents: string[]): RerouteDecision;
+    /**
+     * Generate a comprehensive gap report
+     */
+    generateReport(): GapReport;
+    /**
+     * Reset the detector state
+     */
+    reset(): void;
+}
+/**
+ * Create a gap detector with default configuration
+ */
+export declare function createGapDetector(config?: Partial<GapDetectorConfig>): GapDetector;
+/**
+ * Format gap report for display
+ */
+export declare function formatGapReport(report: GapReport): string;
+/**
+ * Check if a report has critical issues
+ */
+export declare function hasCriticalIssues(report: GapReport): boolean;
+/**
+ * Check if a report has blocking issues
+ */
+export declare function hasBlockingIssues(report: GapReport): boolean;
+//# sourceMappingURL=gap-detector.d.ts.map

package/dist/core/agents/gap-detector.d.ts.map

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