# AI Remediation Plan Attestation

## Module
Attestor

## Status
VERIFIED

## Description
Predicate types for AI-generated remediation plans, including remediation steps, risk assessment, classifier authority decisions, and in-toto statement wrapping as signed attestation artifacts.

## Implementation Details
- **Remediation Predicate Contract**: `src/Attestor/__Libraries/StellaOps.Attestor.ProofChain/Predicates/AI/AIRemediationPlanPredicate.cs` defines remediation-specific fields on top of `AIArtifactBasePredicate`.
- **Remediation Step Models**: `src/Attestor/__Libraries/StellaOps.Attestor.ProofChain/Predicates/AI/RemediationStep.cs`, `RemediationActionType.cs`, and `RemediationStepStatus.cs` model step intent and execution lifecycle.
- **Risk and Verification Models**: `src/Attestor/__Libraries/StellaOps.Attestor.ProofChain/Predicates/AI/RemediationRiskAssessment.cs` and `RemediationVerificationStatus.cs` capture risk deltas and remediation verification state.
- **Classifier Integration**: `src/Attestor/__Libraries/StellaOps.Attestor.ProofChain/Predicates/AI/AIAuthorityClassifier.Remediation.cs` and `AIAuthorityClassifier.RemediationScore.cs` classify remediation plan authority from evidence resolvability, risk delta, automation coverage, and verification status.
- **Statement Wrapper**: `src/Attestor/__Libraries/StellaOps.Attestor.ProofChain/Statements/AI/AIRemediationPlanStatement.cs` wraps remediation predicates in in-toto statement shape (`predicateType: ai-remediation.stella/v1`).
- **Behavioral Tests**: `src/Attestor/__Tests/StellaOps.Attestor.ProofChain.Tests/AI/AIRemediationPlanAttestationBehaviorTests.cs` and `src/Attestor/__Tests/StellaOps.Attestor.ProofChain.Tests/AI/AIAuthorityClassifierTests.cs` verify serialization, classifier outcomes, and statement contract behavior.

## E2E Test Plan
- [x] Create an `AIRemediationPlanPredicate` with multiple `RemediationStep` entries of different `RemediationActionType` values and verify JSON serialization.
- [x] Create a remediation plan with `RemediationRiskAssessment` and verify risk level fields are preserved.
- [x] Classify a remediation plan with high resolvable evidence and sufficient confidence threshold inputs and verify `EvidenceBacked` authority.
- [x] Classify a remediation plan with low evidence backing and verify `Suggestion` authority.
- [x] Wrap the predicate in `AIRemediationPlanStatement` and verify valid in-toto statement shape and predicate type.
- [x] Verify `RemediationStepStatus` progression persists through serialization.
- [x] Verify `RemediationVerificationStatus` persists through serialization.

## Verification
- Verified on 2026-02-11 with `run-001`.
- Tier 0 source checks passed for remediation predicate/models, classifier partials, statement wrapper, and targeted test classes.
- Tier 1 passed after resolving one remediation fixture threshold mismatch (`17/17` scoped class tests pass on retest).
- Tier 2 behavioral verification passed using class-scoped xUnit execution covering remediation serialization, high/low evidence classification outcomes, statement wrapping, and status persistence.
- Evidence:
  - `docs/qa/feature-checks/runs/attestor/ai-remediation-plan-attestation/run-001/tier0-source-check.json`
  - `docs/qa/feature-checks/runs/attestor/ai-remediation-plan-attestation/run-001/tier1-build-check.json`
  - `docs/qa/feature-checks/runs/attestor/ai-remediation-plan-attestation/run-001/triage.json`
  - `docs/qa/feature-checks/runs/attestor/ai-remediation-plan-attestation/run-001/fix-summary.json`
  - `docs/qa/feature-checks/runs/attestor/ai-remediation-plan-attestation/run-001/retest-result.json`
  - `docs/qa/feature-checks/runs/attestor/ai-remediation-plan-attestation/run-001/tier2-integration-check.json`