/**
 * Content Change Prediction Types (GAP-011 + INT-018)
 *
 * Types for learning content update patterns and predicting when content will change.
 * Enables optimal polling intervals to minimize unnecessary fetches.
 *
 * INT-018 enhancements:
 * - Calendar triggers (annual updates on specific dates like Jan 1)
 * - Seasonal patterns (month/day probability with historical counts)
 * - Prediction accuracy tracking (record predicted vs actual)
 * - Urgency levels (0-3 for prioritizing refresh queue)
 *
 * @example
 * ```typescript
 * // Content that updates daily at 9 AM
 * const pattern: ContentChangePattern = {
 *   urlPattern: '/api/news/.*',
 *   domain: 'news.example.com',
 *   detectedPattern: 'daily',
 *   patternConfidence: 0.85,
 *   timesOfDay: [9], // 9 AM
 *   nextPredictedChange: Date.now() + 3600000,
 *   recommendedPollIntervalMs: 3600000, // 1 hour
 * };
 * ```
 */
/**
 * Types of detected change patterns
 */
export type ChangePatternType = 'static' | 'hourly' | 'daily' | 'weekly' | 'workday' | 'monthly' | 'irregular' | 'unknown';
/**
 * Historical snapshot of change observations
 */
export interface ChangeObservation {
    /** When the content was checked */
    checkedAt: number;
    /** Whether content changed since last check */
    changed: boolean;
    /** Hash of content (for deduplication) */
    contentHash?: string;
}
/**
 * Temporal pattern details for periodic changes
 */
export interface TemporalPattern {
    /** Hours of day when changes typically occur (0-23) */
    typicalHoursOfDay: number[];
    /** Days of week when changes occur (0=Sunday, 6=Saturday) */
    typicalDaysOfWeek: number[];
    /** Days of month when changes occur (1-31) */
    typicalDaysOfMonth?: number[];
    /** Timezone for interpretation (default: UTC) */
    timezone: string;
}
/**
 * Statistics about change frequency
 */
export interface ChangeFrequencyStats {
    /** Average hours between changes */
    avgIntervalHours: number;
    /** Minimum hours between changes observed */
    minIntervalHours: number;
    /** Maximum hours between changes observed */
    maxIntervalHours: number;
    /** Standard deviation of change intervals */
    stdDevHours: number;
    /** Number of change observations */
    changeCount: number;
    /** Number of total observations (checks) */
    observationCount: number;
}
/**
 * Prediction for next content change
 */
export interface ChangePrediction {
    /** Timestamp when change is predicted */
    predictedAt: number;
    /** Confidence in prediction (0-1) */
    confidence: number;
    /** Window around prediction (+/- milliseconds) */
    uncertaintyWindowMs: number;
    /** Reason for this prediction */
    reason: string;
}
/**
 * Urgency level for prioritizing refresh queue (INT-018)
 * 0 = Low (static content, check weekly)
 * 1 = Normal (regular patterns, follow schedule)
 * 2 = High (approaching predicted change, check soon)
 * 3 = Critical (calendar trigger imminent, check immediately)
 */
export type UrgencyLevel = 0 | 1 | 2 | 3;
/**
 * Calendar-based trigger for predictable annual updates (INT-018)
 * Examples: Government fee updates on Jan 1, fiscal year changes on Apr 1
 */
export interface CalendarTrigger {
    /** Month (1-12) */
    month: number;
    /** Day of month (1-31) */
    dayOfMonth: number;
    /** Description of what typically changes */
    description?: string;
    /** Historical count of changes on this date */
    historicalCount: number;
    /** Confidence based on historical observations (0-1) */
    confidence: number;
    /** Last year this trigger was observed */
    lastObservedYear?: number;
}
/**
 * Seasonal pattern for month/day probability (INT-018)
 * Tracks which months and days of month see more changes
 */
export interface SeasonalPattern {
    /** Monthly change probability (index 0-11 for Jan-Dec) */
    monthlyProbability: number[];
    /** Day-of-month change probability (index 0-30 for days 1-31) */
    dayOfMonthProbability: number[];
    /** Total observations used to calculate probabilities */
    totalObservations: number;
    /** Months with statistically significant higher change rates */
    highChangeMonths: number[];
    /** Days with statistically significant higher change rates */
    highChangeDays: number[];
}
/**
 * Record of prediction accuracy for learning (INT-018)
 */
export interface PredictionAccuracyRecord {
    /** When the prediction was made */
    predictedAt: number;
    /** When we predicted the change would occur */
    predictedChangeAt: number;
    /** When the change actually occurred (null if no change detected) */
    actualChangeAt: number | null;
    /** Whether prediction was accurate within the uncertainty window */
    wasAccurate: boolean;
    /** Error in milliseconds (actual - predicted), null if no change */
    errorMs: number | null;
    /** The pattern type at time of prediction */
    patternType: ChangePatternType;
    /** Confidence at time of prediction */
    confidenceAtPrediction: number;
}
/**
 * Full content change pattern with learning data
 */
export interface ContentChangePattern {
    /** Unique ID for this pattern */
    id: string;
    /** URL pattern (regex) this applies to */
    urlPattern: string;
    /** Domain for this pattern */
    domain: string;
    /** Type of pattern detected */
    detectedPattern: ChangePatternType;
    /** Confidence in pattern detection (0-1) */
    patternConfidence: number;
    /** Temporal pattern details (for periodic patterns) */
    temporalPattern?: TemporalPattern;
    /** Change frequency statistics */
    frequencyStats: ChangeFrequencyStats;
    /** Current prediction for next change */
    nextPrediction?: ChangePrediction;
    /** Recommended polling interval in milliseconds */
    recommendedPollIntervalMs: number;
    /** Recent observations (limited to avoid unbounded growth) */
    recentObservations: ChangeObservation[];
    /** Change timestamps (when content actually changed) */
    changeTimestamps: number[];
    /** When this pattern was created */
    createdAt: number;
    /** When pattern was last analyzed */
    lastAnalyzedAt: number;
    /** When pattern was last verified correct */
    lastVerifiedAt?: number;
    /** How many times prediction was correct */
    predictionSuccessCount: number;
    /** How many times prediction was made */
    predictionAttemptCount: number;
    /** Calendar-based triggers (annual dates that typically see changes) */
    calendarTriggers?: CalendarTrigger[];
    /** Seasonal patterns (month/day probability distributions) */
    seasonalPattern?: SeasonalPattern;
    /** Current urgency level for refresh prioritization (0-3) */
    urgencyLevel?: UrgencyLevel;
    /** Recent prediction accuracy records for learning */
    accuracyHistory?: PredictionAccuracyRecord[];
}
/**
 * Configuration for content change prediction
 */
export interface ContentChangePredictionConfig {
    /** Minimum observations before pattern detection (default: 5) */
    minObservationsForPattern: number;
    /** Minimum changes before pattern detection (default: 3) */
    minChangesForPattern: number;
    /** Maximum observations to keep in history (default: 100) */
    maxObservationsToKeep: number;
    /** Maximum change timestamps to keep (default: 50) */
    maxChangeTimestamps: number;
    /** Pattern confidence threshold to enable predictions (default: 0.5) */
    confidenceThresholdForPrediction: number;
    /** Hours before predicted change to start checking (default: 1) */
    earlyCheckWindowHours: number;
    /** Maximum recommended poll interval in ms (default: 24h) */
    maxPollIntervalMs: number;
    /** Minimum recommended poll interval in ms (default: 5 min) */
    minPollIntervalMs: number;
    /** Static content threshold: days without change (default: 30) */
    staticContentDaysThreshold: number;
    /** Tolerance for time-of-day matching in hours (default: 2) */
    timeOfDayToleranceHours: number;
    /** Maximum accuracy records to keep per pattern (default: 50) */
    maxAccuracyRecords: number;
    /** Days before calendar trigger to start urgent polling (default: 7) */
    calendarTriggerLeadDays: number;
    /** Minimum observations to detect calendar trigger (default: 2) */
    minCalendarTriggerObservations: number;
    /** Threshold for "high change" month/day detection (default: 1.5x average) */
    seasonalHighChangeThreshold: number;
}
/**
 * Default configuration values
 */
export declare const DEFAULT_CHANGE_PREDICTION_CONFIG: ContentChangePredictionConfig;
/**
 * Analysis result from content change predictor
 */
export interface ContentChangeAnalysis {
    /** The analyzed pattern */
    pattern: ContentChangePattern;
    /** Whether there's enough data for reliable prediction */
    hasEnoughData: boolean;
    /** Summary of what was learned */
    summary: string;
    /** Recommended actions */
    recommendations: string[];
}
/**
 * Result of shouldCheckNow() query
 */
export interface PollRecommendation {
    /** Whether to poll now */
    shouldPoll: boolean;
    /** Reason for recommendation */
    reason: string;
    /** When to check next (timestamp) */
    nextCheckAt: number;
    /** Confidence in recommendation (0-1) */
    confidence: number;
}
//# sourceMappingURL=content-change.d.ts.map