EVIDENCE_PROMOTION_RETENTION

Evidence Promotion and Retention#

Verantwortung#

Engineering Platform orchestriert und Aufbewahrung. Die ausführbare Mechanik liegt in engineering-tools; Runtime bewahrt materialisierte und den Retention-Index, übernimmt aber keine semantische Ownership.

Promotion Gate#

Evidence darf nur promotet werden, wenn sie

automatisch versiegelt wurde,
eine vollständige besitzt,
gegen die aktuellen Repository-Roots als fresh validiert wurde,
Work Item und Realisierungskette ausweist,
ein erfolgreiches Ergebnis enthält.

stale, unverifiable oder fehlgeschlagene Evidence darf nicht als aktiver Nachweis promotet werden.

Retention-Klassen#

active: aktuell verwendbarer, fresh validierter Nachweis einer Evidence-Identität.
superseded: früher aktiver Nachweis, der durch einen neueren aktiven Nachweis ersetzt wurde.
failed: fehlgeschlagener Ausführungsnachweis; niemals promotierbar, aber nachvollziehbar aufzubewahren.

Ersatzregel#

Je Evidence-Identität existiert höchstens ein aktiver Nachweis. Eine neue Promotion ersetzt den bisherigen aktiven Eintrag atomisch; der bisherige Nachweis bleibt als superseded mit Verweis auf seinen Nachfolger erhalten. Historische Dateien werden nicht stillschweigend gelöscht.

Runtime-Materialisierung#

Runtime speichert Evidence unter test/reports/retained/ und führt test/reports/evidence-retention-index.json. Dieser Index ist Betriebszustand und keine kanonische Definition der Evidence-Semantik.

Ausführbare Mechanik#

engineering-tools:40-validation/promote-evidence.py
                engineering-tools:40-validation/evidence_retention.py

Failure and rollback integration#

Fehler- und Rollback-Nachweise werden automatisch versiegelt und als failed bewahrt. Rollback-Erfolg begrenzt Auswirkungen, ändert aber nicht das fehlgeschlagene Ausführungsergebnis. Siehe FAILURE_ROLLBACK_EVIDENCE.md.

End-to-end validation#

Phase-level completion is demonstrated by EXECUTION_LIFECYCLE_END_TO_END_VALIDATION.md.