← Security Shallots overview
01 / Architecture

Evidence moves through deliberate layers.

Collection, enrichment, correlation, and interpretation are separated so every conclusion can be traced back to observed evidence.

INGEST

Wazuh + event sources

Collect host and network telemetry without asking the reasoning layer to guess what happened.

ENRICH

Threat intelligence

Attach reputation and vulnerability context from configured feeds and lookup providers.

CORRELATE

Clusters and rules

Group related events by meaningful entities and apply deterministic detection policy.

REASON

Scout + Granite

Use local model context to explain significance, uncertainty, and missed-signal risk.

Why the separation matters

Raw events, source identity, timestamps, and rule evidence are preserved before a bounded context is sent to the AI layer. The explanation can be reviewed against those facts.

Operational design

  • Async workers coordinate ingestion, enrichment, correlation, and health reporting.
  • Configuration is explicit and inspectable rather than embedded in model prompts.
  • APIs expose health, rules, TLS status, vulnerability correlation, and alert views.
  • De-duplication operates on alert clusters, because clusters are the meaningful review unit.
Portfolio takeaway: observability, provenance, and failure behavior are part of the feature.

Representative pipeline

event → normalize → reputation lookup → correlate by host/IP/time
      → policy assessment → bounded context → analyst-facing explanation