Skip to content

history

history

Failure history store for history-aware prompt generation.

Queries past validation failures from checkpoint state to help avoid repeating the same mistakes across sheets.

Classes

HistoricalFailure dataclass 

HistoricalFailure(sheet_num, rule_type, description, failure_reason=None, failure_category=None, suggested_fix=None)

A single historical validation failure for prompt injection.

FailureHistoryStore 

FailureHistoryStore(state)

Queries past validation failures from checkpoint state.

Enables history-aware prompt generation by extracting validation failures from previous sheets and finding similar failures.

Initialize failure history store.

Source code in src/marianne/execution/validation/history.py 
35
36
37
def __init__(self, state: CheckpointState) -> None:
    """Initialize failure history store."""
    self._state = state
Functions
query_similar_failures 
query_similar_failures(current_sheet, rule_types=None, failure_categories=None, limit=3)

Query past validation failures similar to expected patterns.

Source code in src/marianne/execution/validation/history.py 
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
def query_similar_failures(
    self,
    current_sheet: int,
    rule_types: list[str] | None = None,
    failure_categories: list[str] | None = None,
    limit: int = 3,
) -> list[HistoricalFailure]:
    """Query past validation failures similar to expected patterns."""
    failures: list[HistoricalFailure] = []

    for sheet_num in sorted(self._state.sheets.keys(), reverse=True):
        if sheet_num >= current_sheet:
            continue

        sheet = self._state.sheets.get(sheet_num)
        if not sheet or not sheet.validation_details:
            continue

        for detail in sheet.validation_details:
            if detail.get("passed", False):
                continue

            rule_type = detail.get("rule_type", "")
            failure_category = detail.get("failure_category")

            if rule_types and rule_type not in rule_types:
                continue
            if failure_categories and failure_category not in failure_categories:
                continue

            failures.append(self._detail_to_failure(sheet_num, detail))

            if len(failures) >= limit:
                return failures

    return failures
query_recent_failures 
query_recent_failures(current_sheet, lookback_sheets=3, limit=3)

Query recent validation failures from nearby sheets.

Source code in src/marianne/execution/validation/history.py 
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
def query_recent_failures(
    self,
    current_sheet: int,
    lookback_sheets: int = 3,
    limit: int = 3,
) -> list[HistoricalFailure]:
    """Query recent validation failures from nearby sheets."""
    failures: list[HistoricalFailure] = []

    for offset in range(1, lookback_sheets + 1):
        sheet_num = current_sheet - offset
        if sheet_num <= 0:
            break

        sheet = self._state.sheets.get(sheet_num)
        if not sheet or not sheet.validation_details:
            continue

        for detail in sheet.validation_details:
            if detail.get("passed", False):
                continue

            failures.append(self._detail_to_failure(sheet_num, detail))

            if len(failures) >= limit:
                return failures

    return failures
has_failures 
has_failures(current_sheet)

Check if there are any historical failures to query.

Source code in src/marianne/execution/validation/history.py 
119
120
121
122
123
124
125
126
127
128
129
130
131
def has_failures(self, current_sheet: int) -> bool:
    """Check if there are any historical failures to query."""
    for sheet_num, sheet in self._state.sheets.items():
        if sheet_num >= current_sheet:
            continue

        if not sheet.validation_details:
            continue

        if any(not d.get("passed", False) for d in sheet.validation_details):
            return True

    return False