How aaa1234fdja/ely-soe-harness works
ELY Security Lab & SOE is an audit and release-readiness platform for agentic software. Users start scheduled, on-demand, or pre-release audits through the CLI or web command center; the SOE lifecycle scopes and analyzes a target, runs isolated security exercises, independently validates findings, and produces maturity and release-gate results. Its documented capabilities also include frontier research tools, broad cyber-domain auditing, untrusted-agent simulation, signed evidence, history, and verified remediation. Relationships among unsampled subsystems are included only where the README documents the workflow; source excerpts and the index support the other cited links.
Main entry points: lifecycle.py Audit Lifecycle · engine.py SOE Engine · auditor.py Independent Auditor · cli.py CLI
Components 23
User Interfaces
- CLI
ely_soe/cli.py - Web Command Center
ely_soe/web/api_handlers.py
Audit Orchestration
- SOE Engine
ely_soe/soe/engine.py - Audit Lifecycle
ely_soe/soe/lifecycle.py - Audit Scheduler
ely_soe/soe/scheduler.py - Audit History
ely_soe/soe/store.py - Scope and Config
ely_soe/core/scope_guard.py
Discovery and Research
- Repository Analysis
ely_soe/analyzers/repo_analyzer.py - Cyber Domain Audits
ely_soe/cyber - Taint Analysis
ely_soe/analyzers/taint_engine.py - Frontier Research
ely_soe/frontier - Hypothesis Planning
ely_soe/harness_squared/hypothesis_engine.py
Isolated Security Lab
- Snapshot and Scrubbing
ely_soe/lab/snapshot.py - Sandbox Exercises
ely_soe/lab/sandbox.py - Adversarial Campaigns
ely_soe/lab/red_team.py - Untrusted Agents
ely_soe/lab/untrusted_agents.py
Validation and Assurance
- Independent Auditor
ely_soe/lab/auditor.py - Finding Models
ely_soe/core/models.py - Signed Evidence Ledger
ely_soe/core/crypto_ledger.py - Maturity Gate
ely_soe/soe/maturity.py - Reports and Remediation
ely_soe/harness/reporter.py - Verified Autopatching
ely_soe/harness/verified_autopatch_engine.py
Other components
- Audit Operator
Connections 24
- Audit Operator → CLI: invokes
- Audit Operator → Web Command Center: uses
- CLI → SOE Engine: starts audits
ely_soe/cli.py - Web Command Center → SOE Engine: starts audits
ely_soe/web/api_handlers.py - SOE Engine → Audit Lifecycle: runs lifecycle
ely_soe/soe/engine.py - SOE Engine → Audit Scheduler: registers schedules
ely_soe/soe/engine.py - SOE Engine → Audit History: stores history
ely_soe/soe/engine.py - Audit Scheduler → Audit History: reads and writes
ely_soe/soe/scheduler.py - Audit Lifecycle → Scope and Config: checks scope
ely_soe/soe/lifecycle.py - Audit Lifecycle → Repository Analysis: analyzes target
ely_soe/soe/lifecycle.py - Audit Lifecycle → Cyber Domain Audits: runs domain audits
- Audit Lifecycle → Taint Analysis: runs static analysis
- Audit Lifecycle → Frontier Research: runs research tools
ely_soe/soe/lifecycle.py - Audit Lifecycle → Snapshot and Scrubbing: creates snapshot
ely_soe/soe/lifecycle.py - Audit Lifecycle → Sandbox Exercises: runs isolated tests
- Audit Lifecycle → Adversarial Campaigns: runs campaigns
ely_soe/soe/lifecycle.py - Audit Lifecycle → Untrusted Agents: runs simulation
ely_soe/soe/lifecycle.py - Audit Lifecycle → Independent Auditor: requests validation
ely_soe/soe/lifecycle.py - Independent Auditor → Finding Models: certifies findings
ely_soe/core/models.py - Independent Auditor → Signed Evidence Ledger: signs evidence
- Audit Lifecycle → Maturity Gate: evaluates release gate
ely_soe/soe/lifecycle.py - Audit Lifecycle → Reports and Remediation: produces results
ely_soe/soe/lifecycle.py - Reports and Remediation → Verified Autopatching: offers remediation
- Audit Lifecycle → Hypothesis Planning: plans verification