Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT&CK investigation, and a replayable decision ledger for every agent step. Self-hostable, runs with no API keys, MIT licensed. Ships an MCP server for Claude, Cursor and Continue.
Python agentic-aiai-securityalert-triageblue-teamcybersecuritydetection-engineeringincident-responselanggraphllm-agentsmcpmitre-attackmodel-context-protocolpurple-teamsecurity-operationsself-hostedsiemsoarsocthreat-detectionthreat-intelligence
"""Unit tests for the Investigation Swarm (v8 P3)."""
from __future__ import annotations
from app.swarm.complexity import assess_complexity
from app.swarm.debate import hold_debate
from app.swarm.hypotheses import HYPOTHESES
from app.swarm.swarm import run_swarm_sync
RANSOMWARE = {
"alert_summary": "Ransomware encrypting files on host; vssadmin deleted shadow copies; ransom note dropped",
"raw": "lockbit .lockbit lateral movement via smb, credential dump with mimikatz",
"techniques": ["T1486", "T1490", "T1021.002", "T1003"],
"iocs": {"src_ip": "10.0.0.5", "dst_ip": "10.0.0.9", "file_hash": "abc"},
"hostname": "WIN-FIN-DB01",
"username": "svc-backup",
}
BENIGN = {
"alert_summary": "Scheduled backup completed nominal",
"raw": "veeam backup finished, service account svc-backup, maintenance window",
"techniques": [],
}
def test_complexity_gate_fires_on_multi_entity_multi_technique():
a = assess_complexity(RANSOMWARE)
assert a.is_complex
assert a.entity_count >= 3
assert a.technique_count >= 3
# A simple benign alert should not trip the swarm.
assert not assess_complexity(BENIGN).is_complex
def test_swarm_fans_out_and_scores_hypotheses():
results = run_swarm_sync(RANSOMWARE)
assert len(results) == min(5, len(HYPOTHESES))
by_key = {r.key: r for r in results}
# Ransomware + lateral-movement should score well; the FP-backup hypothesis low.
assert by_key["ransomware_staging"].support_score > 0.3
assert by_key["lateral_movement"].support_score > 0.3
assert by_key["false_positive_backup"].support_score <= by_key["ransomware_staging"].support_score
# Cost is bounded per agent.
assert all(r.tokens_spent <= 1500 for r in results)
def test_debate_ranks_ransomware_first_on_a_ransomware_alert():
results = run_swarm_sync(RANSOMWARE)
outcome = hold_debate(results)
assert outcome.winner is not None
assert outcome.winner.key in {"ransomware_staging", "lateral_movement", "c2_beacon"}
assert not outcome.winner.benign
# Ranked list is sorted by score descending with bounded confidence.
scores = [h.score for h in outcome.ranked]
assert scores == sorted(scores, reverse=True)
assert 0.05 <= outcome.winner.confidence <= 0.95
# Ledger payload is a first-class debate step.
assert outcome.ledger_payload["step_type"] == "debate"
assert len(outcome.ledger_payload["hypotheses"]) == len(results)
def test_memory_prior_can_shift_the_ranking():
results = run_swarm_sync(BENIGN)
# With a strong prior that this signature is historically a backup FP,
# the benign hypothesis should be competitive.
outcome = hold_debate(results, memory_priors={"false_positive_backup": 1.0})
keys = [h.key for h in outcome.ranked]
assert keys[0] == "false_positive_backup"