How m-sec-org/breachweave works
BreachWeave is a multi-agent penetration-testing system. A user launches a challenge through the web interface or CLI; the Manager coordinates Solver sessions, which explore and submit results, while Observer extensions supervise execution. The web app also manages configuration and presents challenge progress, statistics and attack-flow history. The README documents project/asset management, Planner scheduling, Idea/Memory collaboration, reporting and context reduction; the supplied excerpts do not show every implementation link, so uncertain relationships are omitted.
Main entry points: session.ts Solver sessions · manager.ts Challenge Manager · server.ts Web API · index.ts Config manager
Components 26
Challenge orchestration
- API client
packages/core/src/challenge/api-client.ts - Challenge Manager
packages/core/src/challenge/manager.ts - Attack timeline
packages/core/src/challenge/attack-timeline.ts - Challenge store
packages/core/src/challenge/store.ts - Challenge stats
packages/core/src/challenge/stats.ts - Challenge memory
packages/core/src/challenge/memory.ts
Agent execution
- Solver sessions
packages/core/src/solver/session.ts - Solver board
packages/core/src/solver/board-store.ts - Observer
packages/core/src/solver/extension/challenge-observer/observer-loop.ts - Solver extensions
packages/core/src/solver/extension/pentest-compaction.ts - Agent tools
packages/core/src/config/tools/subagent.ts - Output ingestion
packages/core/src/config/tools/ingest-sub-agent-output.ts - Runtime types
packages/core/src/runtime/types.ts
Agent configuration
- Config manager
packages/core/src/config/index.ts - Prompt library
packages/core/src/config/prompts/index.ts - Skills
packages/core/src/config/skills/index.ts - MCP config
packages/core/src/config/mcp/index.ts - MCP adapter
packages/libs/pi-mcp-adapter/server-manager.ts
Web management
- Challenge console
packages/ui-web/src/components/challenge/page.tsx - Attack flow
packages/ui-web/src/components/challenge/attack-flow.tsx - Config pages
packages/ui-web/src/components/config/page.tsx - Web API
packages/ui-web/src/server.ts
Other components
- Operator
- Challenge service
Connections 33
- Operator → CLI: launches
apps/cli/src/main.ts - Operator → Web app: opens
packages/ui-web/src/app.tsx - CLI → Solver sessions: starts solver
apps/cli/src/main.ts - Web app → Challenge console: routes to
packages/ui-web/src/app.tsx - Web app → Attack flow: routes to
packages/ui-web/src/app.tsx - Web app → Config pages: routes to
packages/ui-web/src/app.tsx - Challenge console → Web API: requests data
packages/ui-web/src/components/challenge/page.tsx - Attack flow → Web API: requests data
- Config pages → Web API: configures via
- Web API → Challenge Manager: dispatches
packages/ui-web/src/server.ts - Web API → Attack timeline: reads flow
packages/ui-web/src/server.ts - Web API → Challenge stats: reads stats
packages/ui-web/src/server.ts - Web API → Solver board: reads snapshot
packages/ui-web/src/server.ts - Challenge Manager → API client: submits flags
packages/core/src/challenge/manager.ts - Challenge Manager → Challenge store: persists records
packages/core/src/challenge/manager.ts - Challenge Manager → Solver sessions: creates sessions
packages/core/src/challenge/manager.ts - Challenge Manager → Config manager: uses settings
packages/core/src/challenge/manager.ts - Challenge Manager → Attack timeline: records activity
- Challenge Manager → Challenge stats: updates metrics
packages/core/src/challenge/manager.ts - API client → Challenge service: calls service
- Solver sessions → Config manager: loads session config
packages/core/src/solver/session.ts - Solver sessions → Prompt library: loads prompts
packages/core/src/solver/session.ts - Solver sessions → Observer: installs observer
packages/core/src/solver/session.ts - Solver sessions → Solver extensions: installs extensions
packages/core/src/solver/session.ts - Solver sessions → Runtime types: uses types
packages/core/src/solver/session.ts - Solver sessions → Agent tools: invokes tools
- Agent tools → Output ingestion: accepts output
- Output ingestion → Challenge memory: updates hypotheses
- Solver board → Challenge memory: reads memory
packages/core/src/solver/board-store.ts - Config manager → Prompt library: manages prompts
packages/core/src/config/index.ts - Config manager → Skills: loads skills
packages/core/src/config/index.ts - Config manager → MCP config: loads MCP settings
packages/core/src/config/index.ts - MCP config → MCP adapter: configures servers