wfagent Monorepo

This repository contains two independent Python applications:

• agent/ - the wfagent agent for wpa_supplicant
• backend/ - the wfagent_backend HTTP delivery backend

Each application has its own README.md, pyproject.toml, tests, and example configuration.

Layout

• agent/README.md
• agent/pyproject.toml
• agent/wfagent.example.yaml
• backend/README.md
• backend/pyproject.toml
• backend/wfagent_backend.example.yaml

Code Navigation

Agent

• agent/src/wfagent/__main__.py - python -m wfagent entry point
• agent/src/wfagent/cli.py - CLI bootstrap and config loading
• agent/src/wfagent/config.py - YAML config parsing and validation
• agent/src/wfagent/sources.py - D-Bus, ctrl_iface, and runtime sources
• agent/src/wfagent/pipeline.py - filtering, normalization, classification, triggers, runtime orchestration
• agent/src/wfagent/commands.py - command clients for D-Bus and ctrl_iface
• agent/src/wfagent/payloads/ - payload/blob decoding helpers
• agent/src/wfagent/delivery/ - webhook delivery, spool, and retry
• agent/src/wfagent/enrichment.py - optional navigation enrichment
• agent/tests/ - agent unit and integration tests

Backend

• backend/src/wfagent_backend/cli.py - backend CLI bootstrap and config loading
• backend/src/wfagent_backend/server.py - HTTP server and routing
• backend/src/wfagent_backend/app.py - ingest normalization and stdout batch logging
• backend/src/wfagent_backend/mapping.py - event-to-metric mapping
• backend/src/wfagent_backend/queue.py - queueing, TTL, and retry
• backend/src/wfagent_backend/sender.py - zabbix_sender adapter
• backend/src/wfagent_backend/contracts.py - canonical ingest and delivery data models
• backend/tests/ - backend tests

Install

Install the agent:

cd agent
python -m pip install -e .

Install the backend:

cd backend
python -m pip install -e .

Run

Run the agent:

cd agent
wfagent --config wfagent.example.yaml

Run the backend:

cd backend
wfagent_backend --config wfagent_backend.example.yaml

Test

Run the agent tests:

pytest agent/tests

Run the backend tests:

pytest backend/tests

More Information

• Agent architecture and configuration: agent/README.md
• Backend architecture and configuration: backend/README.md
• Backend architecture notes: backend/wfagent_backend_architecture.md