rename regulatory mapper and genericize compliance framework references

- Rename free_ai_mapper.py to regulatory_mapper.py
- Rename FreeAIMapper class to RegulatoryMapper
- Replace SUTRAS with PRINCIPLES throughout
- Replace free_ai_mapping field with regulatory_mapping
- Remove region-specific framework references from comments
- Re-number recommendations to generic rec_01..rec_10
- 853 tests passing

Author: shivdeep1

airlock/compliance/__init__.py

@@ -1,9 +1,9 @@
 from __future__ import annotations
 
-"""RBI FREE-AI compliance module for the Airlock Protocol."""
+"""Compliance module for the Airlock Protocol."""
 
 from airlock.compliance.bias_detector import BiasDetector
-from airlock.compliance.free_ai_mapper import FreeAIMapper
+from airlock.compliance.regulatory_mapper import RegulatoryMapper
 from airlock.compliance.incident import IncidentStore
 from airlock.compliance.inventory import AgentInventory
 from airlock.compliance.report_generator import ComplianceReportGenerator
@@ -22,7 +22,7 @@
     "BiasDetector",
     "ComplianceReport",
     "ComplianceReportGenerator",
-    "FreeAIMapper",
+    "RegulatoryMapper",
     "IncidentReport",
     "IncidentStore",
     "RiskClassification",

airlock/compliance/free_ai_mapper.py airlock/compliance/regulatory_mapper.pyairlock/compliance/free_ai_mapper.py renamed to airlock/compliance/regulatory_mapper.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-"""Maps Airlock Protocol features to RBI FREE-AI Framework sutras and recommendations."""
+"""Maps Airlock Protocol features to regulatory compliance framework principles."""
 
 import logging
 from typing import Any
@@ -10,93 +10,93 @@
 
 logger = logging.getLogger(__name__)
 
-# RBI FREE-AI Framework: 7 Sutras
-SUTRAS: dict[str, str] = {
-    "sutra_1": "Governance & Oversight",
-    "sutra_2": "Risk Management",
-    "sutra_3": "Data Governance",
-    "sutra_4": "Model Development & Validation",
-    "sutra_5": "Fairness & Bias",
-    "sutra_6": "Transparency & Explainability",
-    "sutra_7": "Accountability & Audit",
+# Compliance framework: 7 core principles
+PRINCIPLES: dict[str, str] = {
+    "principle_1": "Governance & Oversight",
+    "principle_2": "Risk Management",
+    "principle_3": "Data Governance",
+    "principle_4": "Model Development & Validation",
+    "principle_5": "Fairness & Bias",
+    "principle_6": "Transparency & Explainability",
+    "principle_7": "Accountability & Audit",
 }
 
-# Selected RBI FREE-AI recommendations mapped to Airlock features
+# Regulatory recommendations mapped to Airlock features
 RECOMMENDATION_MAP: dict[str, dict[str, str]] = {
-    "rec_14": {
+    "rec_01": {
         "title": "AI Model Inventory",
         "airlock_feature": "agent_inventory",
-        "sutra": "sutra_1",
+        "principle": "principle_1",
     },
-    "rec_15": {
+    "rec_02": {
         "title": "Risk Classification",
         "airlock_feature": "risk_classifier",
-        "sutra": "sutra_2",
+        "principle": "principle_2",
     },
-    "rec_16": {
+    "rec_03": {
         "title": "Incident Reporting",
         "airlock_feature": "incident_store",
-        "sutra": "sutra_2",
+        "principle": "principle_2",
     },
-    "rec_17": {
+    "rec_04": {
         "title": "Audit Trail",
         "airlock_feature": "audit_trail",
-        "sutra": "sutra_7",
+        "principle": "principle_7",
     },
-    "rec_18": {
+    "rec_05": {
         "title": "Bias Detection",
         "airlock_feature": "bias_detector",
-        "sutra": "sutra_5",
+        "principle": "principle_5",
     },
-    "rec_19": {
+    "rec_06": {
         "title": "Trust Scoring Transparency",
         "airlock_feature": "trust_scoring",
-        "sutra": "sutra_6",
+        "principle": "principle_6",
     },
-    "rec_20": {
+    "rec_07": {
         "title": "Identity Verification",
         "airlock_feature": "did_verification",
-        "sutra": "sutra_1",
+        "principle": "principle_1",
     },
-    "rec_21": {
+    "rec_08": {
         "title": "Capability Assessment",
         "airlock_feature": "vc_capability",
-        "sutra": "sutra_4",
+        "principle": "principle_4",
     },
-    "rec_22": {
+    "rec_09": {
         "title": "Data Privacy Controls",
         "airlock_feature": "privacy_mode",
-        "sutra": "sutra_3",
+        "principle": "principle_3",
     },
-    "rec_23": {
+    "rec_10": {
         "title": "Compliance Reporting",
         "airlock_feature": "compliance_reports",
-        "sutra": "sutra_7",
+        "principle": "principle_7",
     },
 }
 
 
-class FreeAIMapper:
-    """Maps Airlock compliance status to RBI FREE-AI framework."""
+class RegulatoryMapper:
+    """Maps Airlock compliance status to regulatory framework principles."""
 
     def map_compliance_status(
         self,
         inventory: AgentInventory,
         incident_store: IncidentStore,
     ) -> dict[str, Any]:
-        """Map current compliance state to FREE-AI sutras and recommendations."""
+        """Map current compliance state to framework principles and recommendations."""
         agents = inventory.list_all()
         incidents = incident_store.list_all()
 
-        sutra_status: dict[str, dict[str, Any]] = {}
-        for sutra_id, sutra_name in SUTRAS.items():
+        principle_status: dict[str, dict[str, Any]] = {}
+        for principle_id, principle_name in PRINCIPLES.items():
             mapped_recs = [
                 rec_id
                 for rec_id, rec_data in RECOMMENDATION_MAP.items()
-                if rec_data["sutra"] == sutra_id
+                if rec_data["principle"] == principle_id
             ]
-            sutra_status[sutra_id] = {
-                "name": sutra_name,
+            principle_status[principle_id] = {
+                "name": principle_name,
                 "recommendation_count": len(mapped_recs),
                 "recommendations": mapped_recs,
                 "status": "active" if agents else "pending",
@@ -111,8 +111,8 @@ def map_compliance_status(
             )
 
         return {
-            "framework": "RBI FREE-AI",
-            "sutras": sutra_status,
+            "framework": "airlock-compliance",
+            "principles": principle_status,
             "recommendations": recommendation_status,
             "total_agents_tracked": len(agents),
             "total_incidents": len(incidents),
@@ -130,7 +130,7 @@ def get_recommendation_status(
             return {"error": f"Unknown recommendation: {rec_id}"}
 
         feature = rec_data["airlock_feature"]
-        implemented = True  # All mapped features exist in the codebase
+        implemented = True
         active = False
 
         if feature == "agent_inventory" and inventory is not None:
@@ -147,12 +147,12 @@ def get_recommendation_status(
             "audit_trail",
             "compliance_reports",
         ):
-            active = True  # Core features are always active
+            active = True
 
         return {
             "rec_id": rec_id,
             "title": rec_data["title"],
-            "sutra": rec_data["sutra"],
+            "principle": rec_data["principle"],
             "airlock_feature": feature,
             "implemented": implemented,
             "active": active,

airlock/compliance/report_generator.py

@@ -1,12 +1,12 @@
 from __future__ import annotations
 
-"""Compliance report generation for RBI FREE-AI."""
+"""Compliance report generation."""
 
 import logging
 import uuid
 from datetime import UTC, datetime
 
-from airlock.compliance.free_ai_mapper import FreeAIMapper
+from airlock.compliance.regulatory_mapper import RegulatoryMapper
 from airlock.compliance.incident import IncidentStore
 from airlock.compliance.inventory import AgentInventory
 from airlock.compliance.schemas import ComplianceReport
@@ -24,7 +24,7 @@ def __init__(
     ) -> None:
         self._inventory = inventory
         self._incident_store = incident_store
-        self._mapper = FreeAIMapper()
+        self._mapper = RegulatoryMapper()
 
     def generate(
         self,
@@ -52,7 +52,7 @@ def generate(
             incidents_by_severity=incidents_by_severity,
         )
 
-        free_ai_mapping = self._mapper.map_compliance_status(
+        regulatory_mapping = self._mapper.map_compliance_status(
             self._inventory,
             self._incident_store,
         )
@@ -72,7 +72,7 @@ def generate(
             total_incidents=len(period_incidents),
             incidents_by_severity=incidents_by_severity,
             compliance_score=compliance_score,
-            free_ai_mapping=free_ai_mapping,
+            regulatory_mapping=regulatory_mapping,
             recommendations=recommendations,
             audit_summary=self.generate_audit_summary(),
         )
@@ -118,7 +118,7 @@ def generate_for_agent(
             total_incidents=len(period_incidents),
             incidents_by_severity=incidents_by_severity,
             compliance_score=compliance_score,
-            free_ai_mapping={},
+            regulatory_mapping={},
             recommendations=[],
             audit_summary={},
         )

airlock/compliance/schemas.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-"""Pydantic models for the RBI FREE-AI compliance module."""
+"""Pydantic models for the compliance module."""
 
 import logging
 from datetime import UTC, datetime
@@ -77,6 +77,6 @@ class ComplianceReport(BaseModel):
     total_incidents: int = 0
     incidents_by_severity: dict[str, int] = Field(default_factory=dict)
     compliance_score: float = 0.0
-    free_ai_mapping: dict[str, object] = Field(default_factory=dict)
+    regulatory_mapping: dict[str, object] = Field(default_factory=dict)
     recommendations: list[str] = Field(default_factory=list)
     audit_summary: dict[str, object] = Field(default_factory=dict)

airlock/config.py

@@ -218,7 +218,7 @@ class AirlockConfig(BaseSettings):
     oauth_dynamic_registration: bool = True
 
     # -----------------------------------------------------------------------
-    # Compliance (RBI FREE-AI)
+    # Compliance
     # -----------------------------------------------------------------------
     compliance_enabled: bool = True
     compliance_risk_auto_classify: bool = True

airlock/gateway/compliance_routes.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-"""FastAPI routes for the RBI FREE-AI compliance module."""
+"""FastAPI routes for the compliance module."""
 
 import logging
 from datetime import UTC, datetime

tests/test_compliance_reports.py

@@ -1,14 +1,14 @@
 from __future__ import annotations
 
-"""Tests for compliance report generation and FREE-AI mapping."""
+"""Tests for compliance report generation and regulatory mapping."""
 
 from datetime import UTC, datetime
 
 import pytest
 from asgi_lifespan import LifespanManager
 from httpx import ASGITransport, AsyncClient
 
-from airlock.compliance.free_ai_mapper import RECOMMENDATION_MAP, SUTRAS, FreeAIMapper
+from airlock.compliance.regulatory_mapper import RECOMMENDATION_MAP, PRINCIPLES, RegulatoryMapper
 from airlock.compliance.incident import IncidentStore
 from airlock.compliance.inventory import AgentInventory
 from airlock.compliance.report_generator import ComplianceReportGenerator
@@ -130,51 +130,51 @@ def test_recommendations_with_critical_agents(self) -> None:
 
 
 # ---------------------------------------------------------------------------
-# FREE-AI Mapper tests
+# Regulatory Mapper tests
 # ---------------------------------------------------------------------------
 
 
-class TestFreeAIMapper:
-    def test_sutras_defined(self) -> None:
-        assert len(SUTRAS) == 7
-        assert "sutra_1" in SUTRAS
+class TestRegulatoryMapper:
+    def test_principles_defined(self) -> None:
+        assert len(PRINCIPLES) == 7
+        assert "principle_1" in PRINCIPLES
 
     def test_recommendation_map_has_entries(self) -> None:
         assert len(RECOMMENDATION_MAP) > 0
         for rec_id, rec_data in RECOMMENDATION_MAP.items():
             assert "title" in rec_data
             assert "airlock_feature" in rec_data
-            assert "sutra" in rec_data
+            assert "principle" in rec_data
 
     def test_map_compliance_status(self) -> None:
         inv = _populated_inventory()
         store = _populated_incident_store()
-        mapper = FreeAIMapper()
+        mapper = RegulatoryMapper()
 
         result = mapper.map_compliance_status(inv, store)
-        assert result["framework"] == "RBI FREE-AI"
-        assert "sutras" in result
+        assert result["framework"] == "airlock-compliance"
+        assert "principles" in result
         assert "recommendations" in result
         assert result["total_agents_tracked"] == 3
 
     def test_map_compliance_status_empty(self) -> None:
         inv = AgentInventory()
         store = IncidentStore()
-        mapper = FreeAIMapper()
+        mapper = RegulatoryMapper()
 
         result = mapper.map_compliance_status(inv, store)
         assert result["total_agents_tracked"] == 0
 
     def test_get_recommendation_status(self) -> None:
-        mapper = FreeAIMapper()
+        mapper = RegulatoryMapper()
         inv = _populated_inventory()
 
-        status = mapper.get_recommendation_status("rec_14", inventory=inv)
+        status = mapper.get_recommendation_status("rec_01", inventory=inv)
         assert status["implemented"] is True
         assert status["active"] is True
 
     def test_get_recommendation_status_unknown(self) -> None:
-        mapper = FreeAIMapper()
+        mapper = RegulatoryMapper()
         status = mapper.get_recommendation_status("rec_999")
         assert "error" in status
 

tests/test_vc_capability.py

@@ -206,7 +206,7 @@ def test_extract_capabilities_happy_path() -> None:
         "id": "did:key:z6MkTest",
         "capabilities": [
             {"name": "crypto_security", "version": "1.0", "description": "Ed25519 signing"},
-            {"name": "payments", "version": "2.1", "description": "NPCI UPI processing"},
+            {"name": "payments", "version": "2.1", "description": "Payment processing"},
         ],
     }
     result = extract_capabilities([subject])