chore(semantic): checkpoint remediation progress

backend/src/models/clean_release.py

@@ -3,6 +3,10 @@
 # @SEMANTICS: clean-release, models, lifecycle, compliance, evidence, immutability
 # @PURPOSE: Define canonical clean release domain entities and lifecycle guards.
 # @LAYER: Domain
+# @PRE: Base mapping model and release enums are available.
+# @POST: Provides SQLAlchemy and dataclass definitions for governance domain.
+# @SIDE_EFFECT: None (schema definition).
+# @DATA_CONTRACT: Model[ReleaseCandidate, CandidateArtifact, DistributionManifest, ComplianceRun, ComplianceReport]
 # @INVARIANT: Immutable snapshots are never mutated; forbidden lifecycle transitions are rejected.
 
 from datetime import datetime

backend/src/models/report.py

@@ -3,7 +3,11 @@
 # @SEMANTICS: reports, models, pydantic, normalization, pagination
 # @PURPOSE: Canonical report schemas for unified task reporting across heterogeneous task types.
 # @LAYER: Domain
-# @RELATION: DEPENDS_ON -> backend.src.core.task_manager.models
+# @PRE: Pydantic library and task manager models are available.
+# @POST: Provides validated schemas for cross-plugin reporting and UI consumption.
+# @SIDE_EFFECT: None (schema definition).
+# @DATA_CONTRACT: Model[TaskReport, ReportCollection, ReportDetailView]
+# @RELATION: [DEPENDS_ON] ->[backend.src.core.task_manager.models]
 # @INVARIANT: Canonical report fields are always present for every report item.
 
 # [SECTION: IMPORTS]