feat(clean-release): complete and verify backend test suite (33 passing tests)

- Relocated and standardized tests for clean_release subsystem into __tests__ sub-packages.
- Implemented missing unit tests for preparation_service, audit_service, and stages.
- Enhanced API contract tests for candidate preparation and compliance reporting.
- Updated 023-clean-repo-enterprise coverage matrix with final verification results.
- Fixed relative import issues and model validation mismatches during test migration.

backend/src/services/clean_release/__tests__/test_audit_service.py

@@ -0,0 +1,24 @@
+# [DEF:backend.tests.services.clean_release.test_audit_service:Module]
+# @TIER: STANDARD
+# @SEMANTICS: tests, clean-release, audit, logging
+# @PURPOSE: Validate audit hooks emit expected log patterns for clean release lifecycle.
+# @LAYER: Infra
+# @RELATION: TESTS -> backend.src.services.clean_release.audit_service
+
+from unittest.mock import patch
+from src.services.clean_release.audit_service import audit_preparation, audit_check_run, audit_report
+
+@patch("src.services.clean_release.audit_service.logger")
+def test_audit_preparation(mock_logger):
+    audit_preparation("cand-1", "PREPARED")
+    mock_logger.info.assert_called_with("[REASON] clean-release preparation candidate=cand-1 status=PREPARED")
+
+@patch("src.services.clean_release.audit_service.logger")
+def test_audit_check_run(mock_logger):
+    audit_check_run("check-1", "COMPLIANT")
+    mock_logger.info.assert_called_with("[REFLECT] clean-release check_run=check-1 final_status=COMPLIANT")
+
+@patch("src.services.clean_release.audit_service.logger")
+def test_audit_report(mock_logger):
+    audit_report("rep-1", "cand-1")
+    mock_logger.info.assert_called_with("[EXPLORE] clean-release report_id=rep-1 candidate=cand-1")

backend/src/services/clean_release/__tests__/test_manifest_builder.py

@@ -0,0 +1,41 @@
+# [DEF:backend.tests.services.clean_release.test_manifest_builder:Module]
+# @TIER: CRITICAL
+# @SEMANTICS: tests, clean-release, manifest, deterministic
+# @PURPOSE: Validate deterministic manifest generation behavior for US1.
+# @LAYER: Domain
+# @RELATION: VERIFIES -> backend.src.services.clean_release.manifest_builder
+# @INVARIANT: Same input artifacts produce identical deterministic hash.
+
+from src.services.clean_release.manifest_builder import build_distribution_manifest
+
+
+# [DEF:test_manifest_deterministic_hash_for_same_input:Function]
+# @PURPOSE: Ensure hash is stable for same candidate/policy/artifact input.
+# @PRE: Same input lists are passed twice.
+# @POST: Hash and summary remain identical.
+def test_manifest_deterministic_hash_for_same_input():
+    artifacts = [
+        {"path": "a.yaml", "category": "system-init", "classification": "required-system", "reason": "required"},
+        {"path": "b.yaml", "category": "test-data", "classification": "excluded-prohibited", "reason": "prohibited"},
+    ]
+
+    manifest1 = build_distribution_manifest(
+        manifest_id="m1",
+        candidate_id="2026.03.03-rc1",
+        policy_id="policy-enterprise-clean-v1",
+        generated_by="tester",
+        artifacts=artifacts,
+    )
+    manifest2 = build_distribution_manifest(
+        manifest_id="m2",
+        candidate_id="2026.03.03-rc1",
+        policy_id="policy-enterprise-clean-v1",
+        generated_by="tester",
+        artifacts=artifacts,
+    )
+
+    assert manifest1.deterministic_hash == manifest2.deterministic_hash
+    assert manifest1.summary.included_count == manifest2.summary.included_count
+    assert manifest1.summary.excluded_count == manifest2.summary.excluded_count
+# [/DEF:test_manifest_deterministic_hash_for_same_input:Function]
+# [/DEF:backend.tests.services.clean_release.test_manifest_builder:Module]

backend/src/services/clean_release/__tests__/test_policy_engine.py

@@ -0,0 +1,114 @@
+# [DEF:__tests__/test_policy_engine:Module]
+# @RELATION: VERIFIES -> ../policy_engine.py
+# @PURPOSE: Contract testing for CleanPolicyEngine
+# [/DEF:__tests__/test_policy_engine:Module]
+
+import pytest
+from datetime import datetime
+from src.models.clean_release import (
+    CleanProfilePolicy, 
+    ResourceSourceRegistry, 
+    ResourceSourceEntry, 
+    ProfileType, 
+    RegistryStatus
+)
+from src.services.clean_release.policy_engine import CleanPolicyEngine
+
+# @TEST_FIXTURE: policy_enterprise_clean
+@pytest.fixture
+def enterprise_clean_setup():
+    policy = CleanProfilePolicy(
+        policy_id="POL-1",
+        policy_version="1",
+        active=True,
+        prohibited_artifact_categories=["demo", "test"],
+        required_system_categories=["core"],
+        internal_source_registry_ref="REG-1",
+        effective_from=datetime.now(),
+        profile=ProfileType.ENTERPRISE_CLEAN
+    )
+    registry = ResourceSourceRegistry(
+        registry_id="REG-1",
+        name="Internal Registry",
+        entries=[
+            ResourceSourceEntry(source_id="S1", host="internal.com", protocol="https", purpose="p1", enabled=True)
+        ],
+        updated_at=datetime.now(),
+        updated_by="admin",
+        status=RegistryStatus.ACTIVE
+    )
+    return policy, registry
+
+# @TEST_SCENARIO: policy_valid
+def test_policy_valid(enterprise_clean_setup):
+    policy, registry = enterprise_clean_setup
+    engine = CleanPolicyEngine(policy, registry)
+    result = engine.validate_policy()
+    assert result.ok is True
+    assert not result.blocking_reasons
+
+# @TEST_EDGE: missing_registry_ref
+def test_missing_registry_ref(enterprise_clean_setup):
+    policy, registry = enterprise_clean_setup
+    policy.internal_source_registry_ref = "  "
+    engine = CleanPolicyEngine(policy, registry)
+    result = engine.validate_policy()
+    assert result.ok is False
+    assert "Policy missing internal_source_registry_ref" in result.blocking_reasons
+
+# @TEST_EDGE: conflicting_registry
+def test_conflicting_registry(enterprise_clean_setup):
+    policy, registry = enterprise_clean_setup
+    registry.registry_id = "WRONG-REG"
+    engine = CleanPolicyEngine(policy, registry)
+    result = engine.validate_policy()
+    assert result.ok is False
+    assert "Policy registry ref does not match provided registry" in result.blocking_reasons
+
+# @TEST_INVARIANT: deterministic_classification
+def test_classify_artifact(enterprise_clean_setup):
+    policy, registry = enterprise_clean_setup
+    engine = CleanPolicyEngine(policy, registry)
+    
+    # Required
+    assert engine.classify_artifact({"category": "core", "path": "p1"}) == "required-system"
+    # Prohibited
+    assert engine.classify_artifact({"category": "demo", "path": "p2"}) == "excluded-prohibited"
+    # Allowed
+    assert engine.classify_artifact({"category": "others", "path": "p3"}) == "allowed"
+
+# @TEST_EDGE: external_endpoint
+def test_validate_resource_source(enterprise_clean_setup):
+    policy, registry = enterprise_clean_setup
+    engine = CleanPolicyEngine(policy, registry)
+    
+    # Internal (OK)
+    res_ok = engine.validate_resource_source("internal.com")
+    assert res_ok.ok is True
+    
+    # External (Blocked)
+    res_fail = engine.validate_resource_source("external.evil")
+    assert res_fail.ok is False
+    assert res_fail.violation["category"] == "external-source"
+    assert res_fail.violation["blocked_release"] is True
+
+def test_evaluate_candidate(enterprise_clean_setup):
+    policy, registry = enterprise_clean_setup
+    engine = CleanPolicyEngine(policy, registry)
+    
+    artifacts = [
+        {"path": "core.js", "category": "core"},
+        {"path": "demo.sql", "category": "demo"}
+    ]
+    sources = ["internal.com", "google.com"]
+    
+    classified, violations = engine.evaluate_candidate(artifacts, sources)
+    
+    assert len(classified) == 2
+    assert classified[0]["classification"] == "required-system"
+    assert classified[1]["classification"] == "excluded-prohibited"
+    
+    # 1 violation for demo artifact + 1 for google.com source
+    assert len(violations) == 2
+    assert violations[0]["category"] == "data-purity"
+    assert violations[1]["category"] == "external-source"

backend/src/services/clean_release/__tests__/test_preparation_service.py

@@ -0,0 +1,127 @@
+# [DEF:backend.tests.services.clean_release.test_preparation_service:Module]
+# @TIER: STANDARD
+# @SEMANTICS: tests, clean-release, preparation, flow
+# @PURPOSE: Validate release candidate preparation flow, including policy evaluation and manifest persisting.
+# @LAYER: Domain
+# @RELATION: TESTS -> backend.src.services.clean_release.preparation_service
+# @INVARIANT: Candidate preparation always persists manifest and candidate status deterministically.
+
+import pytest
+from unittest.mock import MagicMock, patch
+from datetime import datetime, timezone
+
+from src.models.clean_release import (
+    CleanProfilePolicy,
+    ResourceSourceRegistry,
+    ResourceSourceEntry,
+    ReleaseCandidate,
+    ReleaseCandidateStatus,
+    ProfileType,
+    DistributionManifest
+)
+from src.services.clean_release.preparation_service import prepare_candidate
+
+def _mock_policy() -> CleanProfilePolicy:
+    return CleanProfilePolicy(
+        policy_id="pol-1",
+        policy_version="1.0.0",
+        active=True,
+        prohibited_artifact_categories=["prohibited"],
+        required_system_categories=["system"],
+        external_source_forbidden=True,
+        internal_source_registry_ref="reg-1",
+        effective_from=datetime.now(timezone.utc),
+        profile=ProfileType.ENTERPRISE_CLEAN,
+    )
+
+def _mock_registry() -> ResourceSourceRegistry:
+    return ResourceSourceRegistry(
+        registry_id="reg-1",
+        name="Reg",
+        entries=[ResourceSourceEntry(source_id="s1", host="nexus.internal", protocol="https", purpose="pkg", enabled=True)],
+        updated_at=datetime.now(timezone.utc),
+        updated_by="tester"
+    )
+
+def _mock_candidate(candidate_id: str) -> ReleaseCandidate:
+    return ReleaseCandidate(
+        candidate_id=candidate_id,
+        version="1.0.0",
+        profile=ProfileType.ENTERPRISE_CLEAN,
+        created_at=datetime.now(timezone.utc),
+        status=ReleaseCandidateStatus.DRAFT,
+        created_by="tester",
+        source_snapshot_ref="v1.0.0-snapshot"
+    )
+
+def test_prepare_candidate_success():
+    # Setup
+    repository = MagicMock()
+    candidate_id = "cand-1"
+    candidate = _mock_candidate(candidate_id)
+    repository.get_candidate.return_value = candidate
+    repository.get_active_policy.return_value = _mock_policy()
+    repository.get_registry.return_value = _mock_registry()
+    
+    artifacts = [{"path": "file1.txt", "category": "system"}]
+    sources = ["nexus.internal"]
+    
+    # Execute
+    with patch("src.services.clean_release.preparation_service.CleanPolicyEngine") as MockEngine:
+        mock_engine_instance = MockEngine.return_value
+        mock_engine_instance.validate_policy.return_value.ok = True
+        mock_engine_instance.evaluate_candidate.return_value = (
+            [{"path": "file1.txt", "category": "system", "classification": "required-system", "reason": "system-core"}],
+            []
+        )
+        
+        result = prepare_candidate(repository, candidate_id, artifacts, sources, "operator-1")
+        
+    # Verify
+    assert result["status"] == ReleaseCandidateStatus.PREPARED.value
+    assert candidate.status == ReleaseCandidateStatus.PREPARED
+    repository.save_manifest.assert_called_once()
+    repository.save_candidate.assert_called_with(candidate)
+
+def test_prepare_candidate_with_violations():
+    # Setup
+    repository = MagicMock()
+    candidate_id = "cand-1"
+    candidate = _mock_candidate(candidate_id)
+    repository.get_candidate.return_value = candidate
+    repository.get_active_policy.return_value = _mock_policy()
+    repository.get_registry.return_value = _mock_registry()
+    
+    artifacts = [{"path": "bad.txt", "category": "prohibited"}]
+    sources = []
+    
+    # Execute
+    with patch("src.services.clean_release.preparation_service.CleanPolicyEngine") as MockEngine:
+        mock_engine_instance = MockEngine.return_value
+        mock_engine_instance.validate_policy.return_value.ok = True
+        mock_engine_instance.evaluate_candidate.return_value = (
+            [{"path": "bad.txt", "category": "prohibited", "classification": "excluded-prohibited", "reason": "test-data"}],
+            [{"category": "data-purity", "blocked_release": True}]
+        )
+        
+        result = prepare_candidate(repository, candidate_id, artifacts, sources, "operator-1")
+        
+    # Verify
+    assert result["status"] == ReleaseCandidateStatus.BLOCKED.value
+    assert candidate.status == ReleaseCandidateStatus.BLOCKED
+    assert len(result["violations"]) == 1
+
+def test_prepare_candidate_not_found():
+    repository = MagicMock()
+    repository.get_candidate.return_value = None
+    
+    with pytest.raises(ValueError, match="Candidate not found"):
+        prepare_candidate(repository, "non-existent", [], [], "op")
+
+def test_prepare_candidate_no_active_policy():
+    repository = MagicMock()
+    repository.get_candidate.return_value = _mock_candidate("cand-1")
+    repository.get_active_policy.return_value = None
+    
+    with pytest.raises(ValueError, match="Active clean policy not found"):
+        prepare_candidate(repository, "cand-1", [], [], "op")

backend/src/services/clean_release/__tests__/test_source_isolation.py

@@ -0,0 +1,58 @@
+# [DEF:backend.tests.services.clean_release.test_source_isolation:Module]
+# @TIER: STANDARD
+# @SEMANTICS: tests, clean-release, source-isolation, internal-only
+# @PURPOSE: Verify internal source registry validation behavior.
+# @LAYER: Domain
+# @RELATION: TESTS -> backend.src.services.clean_release.source_isolation
+# @INVARIANT: External endpoints always produce blocking violations.
+
+from datetime import datetime, timezone
+
+from src.models.clean_release import ResourceSourceEntry, ResourceSourceRegistry
+from src.services.clean_release.source_isolation import validate_internal_sources
+
+
+def _registry() -> ResourceSourceRegistry:
+    return ResourceSourceRegistry(
+        registry_id="registry-internal-v1",
+        name="Internal Sources",
+        entries=[
+            ResourceSourceEntry(
+                source_id="src-1",
+                host="repo.intra.company.local",
+                protocol="https",
+                purpose="artifact-repo",
+                enabled=True,
+            ),
+            ResourceSourceEntry(
+                source_id="src-2",
+                host="pypi.intra.company.local",
+                protocol="https",
+                purpose="package-mirror",
+                enabled=True,
+            ),
+        ],
+        updated_at=datetime.now(timezone.utc),
+        updated_by="tester",
+        status="active",
+    )
+
+
+def test_validate_internal_sources_all_internal_ok():
+    result = validate_internal_sources(
+        registry=_registry(),
+        endpoints=["repo.intra.company.local", "pypi.intra.company.local"],
+    )
+    assert result["ok"] is True
+    assert result["violations"] == []
+
+
+def test_validate_internal_sources_external_blocked():
+    result = validate_internal_sources(
+        registry=_registry(),
+        endpoints=["repo.intra.company.local", "pypi.org"],
+    )
+    assert result["ok"] is False
+    assert len(result["violations"]) == 1
+    assert result["violations"][0]["category"] == "external-source"
+    assert result["violations"][0]["blocked_release"] is True

backend/src/services/clean_release/__tests__/test_stages.py

@@ -0,0 +1,27 @@
+# [DEF:backend.tests.services.clean_release.test_stages:Module]
+# @TIER: STANDARD
+# @SEMANTICS: tests, clean-release, compliance, stages
+# @PURPOSE: Validate final status derivation logic from stage results.
+# @LAYER: Domain
+# @RELATION: TESTS -> backend.src.services.clean_release.stages
+
+from src.models.clean_release import CheckFinalStatus, CheckStageName, CheckStageResult, CheckStageStatus
+from src.services.clean_release.stages import derive_final_status, MANDATORY_STAGE_ORDER
+
+def test_derive_final_status_compliant():
+    results = [CheckStageResult(stage=s, status=CheckStageStatus.PASS, details="ok") for s in MANDATORY_STAGE_ORDER]
+    assert derive_final_status(results) == CheckFinalStatus.COMPLIANT
+
+def test_derive_final_status_blocked():
+    results = [CheckStageResult(stage=s, status=CheckStageStatus.PASS, details="ok") for s in MANDATORY_STAGE_ORDER]
+    results[1].status = CheckStageStatus.FAIL
+    assert derive_final_status(results) == CheckFinalStatus.BLOCKED
+
+def test_derive_final_status_failed_missing():
+    results = [CheckStageResult(stage=MANDATORY_STAGE_ORDER[0], status=CheckStageStatus.PASS, details="ok")]
+    assert derive_final_status(results) == CheckFinalStatus.FAILED
+
+def test_derive_final_status_failed_skipped():
+    results = [CheckStageResult(stage=s, status=CheckStageStatus.PASS, details="ok") for s in MANDATORY_STAGE_ORDER]
+    results[2].status = CheckStageStatus.SKIPPED
+    assert derive_final_status(results) == CheckFinalStatus.FAILED