File size: 12,223 Bytes
7b7b417
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
"""Tests for the reflexive engine."""

import pytest
from datetime import datetime
from unittest.mock import Mock, AsyncMock

from fastmcp.reflexive import ReflexiveEngine, ActionContext, DecisionType, RiskLevel
from fastmcp.reflexive.engine import ReflexiveDecision


class TestReflexiveEngine:
    """Test the reflexive engine functionality."""
    
    @pytest.fixture
    def reflexive_engine(self):
        """Create a reflexive engine for testing."""
        return ReflexiveEngine()
    
    @pytest.fixture
    def action_context(self):
        """Create an action context for testing."""
        return ActionContext(
            action_id="test_action_123",
            actor_id="test_user",
            action_type="tool_call",
            resource_id="test_resource",
            metadata={"test": "data"}
        )
    
    def test_engine_initialization(self, reflexive_engine):
        """Test reflexive engine initialization."""
        assert reflexive_engine.policy_engine is None
        assert reflexive_engine.ledger is None
        assert len(reflexive_engine.monitors) == 0
        assert len(reflexive_engine.decision_handlers) == 4
        assert not reflexive_engine.is_running
    
    def test_engine_status(self, reflexive_engine):
        """Test getting engine status."""
        status = reflexive_engine.get_engine_status()
        
        assert "is_running" in status
        assert "monitor_count" in status
        assert "queue_size" in status
        assert "decision_handlers" in status
        
        assert status["is_running"] is False
        assert status["monitor_count"] == 0
        assert len(status["decision_handlers"]) == 4
    
    def test_add_remove_monitor(self, reflexive_engine):
        """Test adding and removing monitors."""
        def test_monitor(context):
            return None
        
        # Add monitor
        reflexive_engine.add_monitor(test_monitor)
        assert len(reflexive_engine.monitors) == 1
        assert test_monitor in reflexive_engine.monitors
        
        # Remove monitor
        reflexive_engine.remove_monitor(test_monitor)
        assert len(reflexive_engine.monitors) == 0
        assert test_monitor not in reflexive_engine.monitors
    
    async def test_submit_action(self, reflexive_engine, action_context):
        """Test submitting an action for evaluation."""
        await reflexive_engine.submit_action(action_context)
        
        # Check that action was added to queue
        assert reflexive_engine.event_queue.qsize() == 1
    
    async def test_evaluate_action_no_violations(self, reflexive_engine, action_context):
        """Test evaluating an action with no violations."""
        decision = await reflexive_engine._evaluate_action(action_context)
        
        assert decision.decision_type == DecisionType.ALLOW
        assert decision.risk_level == RiskLevel.LOW
        assert decision.reason == "No violations or anomalies detected"
        assert decision.action_context == action_context
        assert decision.proof_hash is not None
    
    async def test_evaluate_action_with_violations(self, reflexive_engine, action_context):
        """Test evaluating an action with violations."""
        # Add a monitor that returns violations
        def violation_monitor(context):
            return {
                "type": "violation",
                "severity": "high",
                "violations": [{"rule": "test_rule", "message": "Test violation", "severity": "high"}]
            }
        
        reflexive_engine.add_monitor(violation_monitor)
        
        decision = await reflexive_engine._evaluate_action(action_context)
        
        assert decision.decision_type == DecisionType.HALT
        assert decision.risk_level == RiskLevel.HIGH
        assert "violations" in decision.evidence
        assert len(decision.evidence["violations"]) == 1
    
    async def test_evaluate_action_with_anomalies(self, reflexive_engine, action_context):
        """Test evaluating an action with anomalies."""
        # Add a monitor that returns anomalies
        def anomaly_monitor(context):
            return {
                "type": "anomaly",
                "severity": "medium",
                "anomalies": [{"type": "test_anomaly", "message": "Test anomaly", "severity": "medium"}]
            }
        
        reflexive_engine.add_monitor(anomaly_monitor)
        
        decision = await reflexive_engine._evaluate_action(action_context)
        
        assert decision.decision_type == DecisionType.ESCALATE
        assert decision.risk_level == RiskLevel.MEDIUM
        assert "anomalies" in decision.evidence
        assert len(decision.evidence["anomalies"]) == 1
    
    async def test_evaluate_action_critical_violation(self, reflexive_engine, action_context):
        """Test evaluating an action with critical violations."""
        # Add a monitor that returns critical violations
        def critical_monitor(context):
            return {
                "type": "violation",
                "severity": "critical",
                "violations": [{"rule": "critical_rule", "message": "Critical violation", "severity": "critical"}]
            }
        
        reflexive_engine.add_monitor(critical_monitor)
        
        decision = await reflexive_engine._evaluate_action(action_context)
        
        assert decision.decision_type == DecisionType.HALT
        assert decision.risk_level == RiskLevel.CRITICAL
    
    async def test_simulate_risk(self, reflexive_engine):
        """Test risk simulation."""
        risk_scenario = {
            "action_context": {
                "action_id": "simulation_action",
                "actor_id": "test_actor",
                "action_type": "admin_access",
                "resource_id": "sensitive_data"
            },
            "monitors": [
                lambda ctx: {
                    "type": "violation",
                    "severity": "high",
                    "violations": [{"rule": "admin_restriction", "message": "Unauthorized admin access", "severity": "high"}]
                }
            ]
        }
        
        decision = await reflexive_engine.simulate_risk(risk_scenario)
        
        assert decision.decision_type == DecisionType.HALT
        assert decision.risk_level == RiskLevel.HIGH
        assert decision.action_context.action_id == "simulation_action"
    
    def test_assess_risk_level(self, reflexive_engine):
        """Test risk level assessment."""
        # Test critical risk
        critical_violations = [{"severity": "critical"}]
        assert reflexive_engine._assess_risk_level(critical_violations, []) == RiskLevel.CRITICAL
        
        # Test high risk
        high_violations = [{"severity": "high"}]
        assert reflexive_engine._assess_risk_level(high_violations, []) == RiskLevel.HIGH
        
        # Test medium risk
        medium_violations = [{"severity": "medium"}]
        assert reflexive_engine._assess_risk_level(medium_violations, []) == RiskLevel.MEDIUM
        
        # Test low risk
        low_violations = [{"severity": "low"}]
        assert reflexive_engine._assess_risk_level(low_violations, []) == RiskLevel.LOW
        
        # Test multiple issues
        multiple_issues = [{"severity": "low"}, {"severity": "low"}, {"severity": "low"}]
        assert reflexive_engine._assess_risk_level(multiple_issues, []) == RiskLevel.MEDIUM
    
    def test_determine_escalation_target(self, reflexive_engine):
        """Test escalation target determination."""
        decision = ReflexiveDecision(
            decision_type=DecisionType.ESCALATE,
            risk_level=RiskLevel.CRITICAL,
            action_context=ActionContext(action_id="test", actor_id="test", action_type="test"),
            reason="Test"
        )
        
        target = reflexive_engine._determine_escalation_target(decision)
        assert target == "security_admin"
        
        decision.risk_level = RiskLevel.HIGH
        target = reflexive_engine._determine_escalation_target(decision)
        assert target == "system_admin"
        
        decision.risk_level = RiskLevel.MEDIUM
        target = reflexive_engine._determine_escalation_target(decision)
        assert target == "monitoring_team"


class TestActionContext:
    """Test the ActionContext class."""
    
    def test_action_context_creation(self):
        """Test creating an action context."""
        context = ActionContext(
            action_id="test_action",
            actor_id="test_actor",
            action_type="test_type"
        )
        
        assert context.action_id == "test_action"
        assert context.actor_id == "test_actor"
        assert context.action_type == "test_type"
        assert context.resource_id is None
        assert context.metadata == {}
        assert isinstance(context.timestamp, datetime)
    
    def test_action_context_hash(self):
        """Test action context hash generation."""
        context1 = ActionContext(
            action_id="test_action",
            actor_id="test_actor",
            action_type="test_type",
            metadata={"key": "value"}
        )
        
        context2 = ActionContext(
            action_id="test_action",
            actor_id="test_actor",
            action_type="test_type",
            metadata={"key": "value"}
        )
        
        # Same content should produce same hash
        assert context1.get_context_hash() == context2.get_context_hash()
        
        # Different content should produce different hash
        context3 = ActionContext(
            action_id="different_action",
            actor_id="test_actor",
            action_type="test_type",
            metadata={"key": "value"}
        )
        
        assert context1.get_context_hash() != context3.get_context_hash()


class TestReflexiveDecision:
    """Test the ReflexiveDecision class."""
    
    def test_decision_creation(self):
        """Test creating a reflexive decision."""
        action_context = ActionContext(
            action_id="test_action",
            actor_id="test_actor",
            action_type="test_type"
        )
        
        decision = ReflexiveDecision(
            decision_type=DecisionType.HALT,
            risk_level=RiskLevel.HIGH,
            action_context=action_context,
            reason="Test reason"
        )
        
        assert decision.decision_type == DecisionType.HALT
        assert decision.risk_level == RiskLevel.HIGH
        assert decision.action_context == action_context
        assert decision.reason == "Test reason"
        assert decision.evidence == {}
        assert decision.escalated_to is None
        assert decision.proof_hash is None
        assert isinstance(decision.timestamp, datetime)
    
    def test_decision_hash(self):
        """Test decision hash generation."""
        from uuid import uuid4
        
        action_context = ActionContext(
            action_id="test_action",
            actor_id="test_actor",
            action_type="test_type"
        )
        
        # Use the same decision_id for both decisions
        decision_id = uuid4()
        
        decision1 = ReflexiveDecision(
            decision_id=decision_id,
            decision_type=DecisionType.HALT,
            risk_level=RiskLevel.HIGH,
            action_context=action_context,
            reason="Test reason"
        )
        
        decision2 = ReflexiveDecision(
            decision_id=decision_id,
            decision_type=DecisionType.HALT,
            risk_level=RiskLevel.HIGH,
            action_context=action_context,
            reason="Test reason"
        )
        
        # Same content should produce same hash
        assert decision1.get_decision_hash() == decision2.get_decision_hash()
        
        # Different content should produce different hash
        decision3 = ReflexiveDecision(
            decision_type=DecisionType.ESCALATE,
            risk_level=RiskLevel.HIGH,
            action_context=action_context,
            reason="Test reason"
        )
        
        assert decision1.get_decision_hash() != decision3.get_decision_hash()