How ohlesl1e/doo works
DoO is a black-box web application security-testing copilot. Its principal workflow stages passive HAR intake, extraction and graph construction, read-only coverage analysis, test proposal and human review, then policy-gated dispatch, interpretation, and finding review. The graph preserves these documented stages and major capabilities, including identity resolution, boundary coverage, and token rotation. Relationships are grounded in the README and shown source/index references; unsampled modules are represented at their existing paths, and uncertain links are omitted.
Main entry points: service.py Proposal orchestration · l2_worker.py L2 extraction · run.py Dispatch orchestration · cli_worker.py Pipeline worker
Components 32
Ingestion and graph
- HAR intake CLI
src/doo/ingestion/cli_ingest.py - Intake staging
src/doo/ingestion/intake.py - Pipeline worker
src/doo/cli_worker.py - L2 extraction
src/doo/ingestion/l2_worker.py - HAR parser
src/doo/extraction/har.py - L3 commit worker
src/doo/ontology/l3_worker.py - Graph commit
src/doo/ontology/commit.py - Identity resolution
src/doo/ontology/identity_reconcile.py
Coverage and planning
- Coverage analysis
src/doo/coverage/queries.py - Proposal orchestration
src/doo/planner/service.py - Candidate generation
src/doo/planner/generators.py - Structured proposer
src/doo/planner/llm.py - Proposal validation
src/doo/planner/validator.py - Human review queue
src/doo/planner/review.py
Bounded execution
- Dispatch orchestration
src/doo/dispatch/run.py - Dispatch gate
src/doo/dispatch/executor/dispatcher.py - Request executor
src/doo/dispatch/executor/constructors.py - Result interpreter
src/doo/dispatch/interpreter/loop.py - Finding review
src/doo/dispatch/finding.py - Token rotation
src/doo/dispatch/auth_helper.py
Shared foundation
- Blob storage
src/doo/infra/blobs.py - Redis streams
src/doo/infra/streams.py - Layer contracts
src/doo/events/observation.py - Engagement graph
src/doo/infra/neo4j_driver.py - Scope policy
src/doo/policy/scope.py - Engagement config
src/doo/setup/config.py - Correlation logging
src/doo/observability/logging.py
Other components
- Security tester
- HAR capture
- OPA policy service
- Test target
- LLM service
Connections 38
- Security tester → HAR intake CLI: uploads capture
README.md - HAR capture → HAR intake CLI: supplies HAR
README.md - HAR intake CLI → Intake staging: calls intake
src/doo/ingestion/cli_ingest.py - Intake staging → Blob storage: stores capture
src/doo/ingestion/cli_ingest.py - Intake staging → Redis streams: publishes envelope
src/doo/ingestion/cli_ingest.py - Security tester → Pipeline worker: runs workers
README.md - Pipeline worker → L2 extraction: runs L2
src/doo/cli_worker.py - L2 extraction → Blob storage: fetches capture
src/doo/ingestion/l2_worker.py - L2 extraction → Redis streams: consumes and publishes
src/doo/ingestion/l2_worker.py - L2 extraction → HAR parser: dispatches parser
src/doo/ingestion/l2_worker.py - HAR parser → Layer contracts: emits observations
src/doo/extraction/har.py - Pipeline worker → L3 commit worker: runs L3
src/doo/cli_worker.py - L3 commit worker → Redis streams: consumes events
src/doo/ontology/l3_worker.py - L3 commit worker → Graph commit: commits events
src/doo/ontology/l3_worker.py - Graph commit → Engagement graph: writes graph
README.md - Identity resolution → Engagement graph: resolves entities
README.md - Security tester → Coverage analysis: queries coverage
README.md - Coverage analysis → Engagement graph: reads graph
src/doo/coverage/queries.py - Coverage analysis → Scope policy: checks scope
src/doo/coverage/queries.py - Security tester → Proposal orchestration: proposes tests
README.md - Proposal orchestration → Coverage analysis: reads gaps
src/doo/planner/service.py - Proposal orchestration → Candidate generation: generates candidates
src/doo/planner/service.py - Proposal orchestration → Structured proposer: requests proposal
src/doo/planner/service.py - Structured proposer → LLM service: requests completion
- Proposal orchestration → Proposal validation: validates proposals
src/doo/planner/service.py - Proposal orchestration → Human review queue: commits proposals
src/doo/planner/service.py - Security tester → Human review queue: reviews proposals
README.md - Security tester → Dispatch orchestration: arms run
README.md - Dispatch orchestration → Dispatch gate: routes tests
README.md - Dispatch gate → OPA policy service: checks policy
- Dispatch gate → Request executor: authorizes sending
README.md - Request executor → Test target: sends request
README.md - Dispatch orchestration → Result interpreter: judges results
README.md - Dispatch orchestration → Finding review: commits vulnerable finding
README.md - Security tester → Finding review: reviews finding
README.md - Security tester → Token rotation: rotates tokens
README.md - Engagement config → Proposal orchestration: configures engagement
- Correlation logging → Pipeline worker: correlates logs
src/doo/cli_worker.py