Index

Top-level package for foreman.

MODULE	DESCRIPTION
`__main__`	Foreman CLI entrypoint.
`config`	YAML config loader and Pydantic validation for Foreman.
`containers`	Docker container lifecycle management for agent containers.
`credentials`	Credential injection and environment variable resolution.
`executor`	Translates DecisionMessage actions into GitHub API calls.
`llm`	LLM backend abstraction layer.
`logging_info`	Logging processors for structlog.
`memory`	SQLite-backed memory: action_log and memory_summary.
`middleware`	Custom middleware for foreman.
`otel`	Open Telemetry configuration.
`poller`	Asyncio polling loop for GitHub repositories.
`protocol`	Pydantic models for the harness↔agent message protocol.
`router`	Routes GitHub events (repo + event_type) to agent URLs.
`routers`	Router submodule.
`server`	Foreman FastAPI application and dispatch loop.
`settings`	Configuration for Foreman.