Upload README.md

README.md

@@ -1,3 +1,22 @@
----
-license: mit
----
+# viet-robot-security-escalation
+
+A tiny rule-based model that decides how to escalate basic security events.
+
+Function:
+
+```python
+decide_escalation(event_type: str, is_night: bool, human_confirmed: bool) -> EscalationDecision
+```
+
+Returns an escalation `level`:
+
+- `ignore`
+- `log_only`
+- `notify_user`
+- `alarm`
+
+and a short English `reason`.
+
+## License
+
+MIT