stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
822a92faeebbceea6fa005b7eddb7572a8b29b41
git.stella-ops.org/docs/features/checked/attestor/ai-remediation-plan-attestation.md
master 5bca406787 save checkpoint: save features
2026-02-12 10:27:23 +02:00

3.7 KiB
Raw Blame History

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

  • Create an AIRemediationPlanPredicate with multiple RemediationStep entries of different RemediationActionType values and verify JSON serialization.
  • Create a remediation plan with RemediationRiskAssessment and verify risk level fields are preserved.
  • Classify a remediation plan with high resolvable evidence and sufficient confidence threshold inputs and verify EvidenceBacked authority.
  • Classify a remediation plan with low evidence backing and verify Suggestion authority.
  • Wrap the predicate in AIRemediationPlanStatement and verify valid in-toto statement shape and predicate type.
  • Verify RemediationStepStatus progression persists through serialization.
  • 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