patterns_quarantine

patterns_quarantine

Pattern quarantine lifecycle mixin for GlobalLearningStore.

Provides quarantine lifecycle management methods: - quarantine_pattern: Move to QUARANTINED status - validate_pattern: Move to VALIDATED status - retire_pattern: Move to RETIRED status - get_quarantined_patterns: Get patterns needing review

Classes

PatternQuarantineMixin

Bases: _QuarantineBase

Mixin providing pattern quarantine lifecycle methods.

This mixin requires that the composed class provides: - _get_connection(): Context manager yielding sqlite3.Connection - get_patterns(): For querying quarantined patterns (from PatternQueryMixin)

Functions

quarantine_pattern

quarantine_pattern(pattern_id, reason=None)

Move a pattern to QUARANTINED status.

Quarantined patterns are excluded from automatic application but retained for investigation and historical reference.

Parameters:

Name	Type	Description	Default
pattern_id	str	The pattern ID to quarantine.	required
reason	str | None	Optional reason for quarantine.	None

Returns:

Type	Description
bool	True if pattern was quarantined, False if pattern not found.

Source code in src/marianne/learning/store/patterns_quarantine.py

def quarantine_pattern(
    self,
    pattern_id: str,
    reason: str | None = None,
) -> bool:
    """Move a pattern to QUARANTINED status.

    Quarantined patterns are excluded from automatic application but
    retained for investigation and historical reference.

    Args:
        pattern_id: The pattern ID to quarantine.
        reason: Optional reason for quarantine.

    Returns:
        True if pattern was quarantined, False if pattern not found.
    """
    now = datetime.now().isoformat()

    with self._get_connection() as conn:
        cursor = conn.execute(
            "SELECT id FROM patterns WHERE id = ?",
            (pattern_id,),
        )
        if not cursor.fetchone():
            _logger.warning("pattern_not_found", pattern_id=pattern_id, operation="quarantine")
            return False

        conn.execute(
            """
            UPDATE patterns SET
                quarantine_status = ?,
                quarantined_at = ?,
                quarantine_reason = ?
            WHERE id = ?
            """,
            (
                QuarantineStatus.QUARANTINED.value,
                now,
                reason,
                pattern_id,
            ),
        )

    _logger.info(
        "pattern_quarantined",
        pattern_id=pattern_id,
        reason=reason or "no reason given",
    )
    return True

validate_pattern

validate_pattern(pattern_id)

Move a pattern to VALIDATED status.

Validated patterns are trusted for autonomous application and receive a trust bonus in relevance scoring.

Parameters:

Name	Type	Description	Default
pattern_id	str	The pattern ID to validate.	required

Returns:

Type	Description
bool	True if pattern was validated, False if pattern not found.

Source code in src/marianne/learning/store/patterns_quarantine.py

def validate_pattern(self, pattern_id: str) -> bool:
    """Move a pattern to VALIDATED status.

    Validated patterns are trusted for autonomous application and
    receive a trust bonus in relevance scoring.

    Args:
        pattern_id: The pattern ID to validate.

    Returns:
        True if pattern was validated, False if pattern not found.
    """
    now = datetime.now().isoformat()

    with self._get_connection() as conn:
        cursor = conn.execute(
            "SELECT id FROM patterns WHERE id = ?",
            (pattern_id,),
        )
        if not cursor.fetchone():
            _logger.warning("pattern_not_found", pattern_id=pattern_id, operation="validation")
            return False

        conn.execute(
            """
            UPDATE patterns SET
                quarantine_status = ?,
                validated_at = ?,
                quarantine_reason = NULL
            WHERE id = ?
            """,
            (
                QuarantineStatus.VALIDATED.value,
                now,
                pattern_id,
            ),
        )

    _logger.info("pattern_validated", pattern_id=pattern_id)
    return True

retire_pattern

retire_pattern(pattern_id)

Move a pattern to RETIRED status.

Retired patterns are no longer in active use but retained for historical reference and trend analysis.

Parameters:

Name	Type	Description	Default
pattern_id	str	The pattern ID to retire.	required

Returns:

Type	Description
bool	True if pattern was retired, False if pattern not found.

Source code in src/marianne/learning/store/patterns_quarantine.py

def retire_pattern(self, pattern_id: str) -> bool:
    """Move a pattern to RETIRED status.

    Retired patterns are no longer in active use but retained for
    historical reference and trend analysis.

    Args:
        pattern_id: The pattern ID to retire.

    Returns:
        True if pattern was retired, False if pattern not found.
    """
    with self._get_connection() as conn:
        cursor = conn.execute(
            "SELECT id FROM patterns WHERE id = ?",
            (pattern_id,),
        )
        if not cursor.fetchone():
            _logger.warning("pattern_not_found", pattern_id=pattern_id, operation="retirement")
            return False

        conn.execute(
            """
            UPDATE patterns SET
                quarantine_status = ?
            WHERE id = ?
            """,
            (
                QuarantineStatus.RETIRED.value,
                pattern_id,
            ),
        )

    _logger.info("pattern_retired", pattern_id=pattern_id)
    return True

get_quarantined_patterns

get_quarantined_patterns(limit=50)

Get all patterns currently in QUARANTINED status.

Parameters:

Name	Type	Description	Default
limit	int	Maximum number of patterns to return.	50

Returns:

Type	Description
list[PatternRecord]	List of quarantined PatternRecord objects.

Source code in src/marianne/learning/store/patterns_quarantine.py

def get_quarantined_patterns(self, limit: int = 50) -> list[PatternRecord]:
    """Get all patterns currently in QUARANTINED status.

    Args:
        limit: Maximum number of patterns to return.

    Returns:
        List of quarantined PatternRecord objects.
    """
    return self.get_patterns(
        quarantine_status=QuarantineStatus.QUARANTINED,
        min_priority=0.0,
        limit=limit,
    )