How qyvora/qyvora-shaka works
SHAKA is a terminal-first framework for authorized, read-only Active Directory assessment. The principal workflow gates and selects a target, runs a configurable assessment through discovery, enumeration, graph correlation, analysis, findings, and risk scoring, then saves and renders the session. The graph also includes live LDAP and offline simulation, evidence-backed rules, events, and reporting. Relationships follow the README and SOURCE INDEX references; unsampled implementation details are represented at their documented subsystem paths rather than inferred as calls.
Main entry points: orchestration.go Stage orchestration · app.go CLI and console · directory.go Directory service · assess.go Assessment runner
Components 22
Operator interface
- CLI and console
internal/cli/app.go - Authorization gate
internal/cli/authorization.go - Target manager
internal/target/manager.go
Assessment workflow
- Assessment runner
internal/assess/assess.go - Stage orchestration
internal/orchestration/orchestration.go - Domain discovery
internal/discovery/discovery.go - Object enumeration
internal/enumeration/enumeration.go - Verification and deepening
internal/deepening/deepening.go - Relationship graph
internal/pipeline/build.go
Directory access
- Directory service
internal/directory/directory.go - Entry normalization
internal/directory/normalize.go - Offline simulator
internal/directory/demo.go - LDAP client
internal/ldap/ldap.go
Security analysis
- Identity and trust analysis
internal/analysis/identity.go - Attack path analysis
internal/analysis/attackpath.go - Built-in detection rules
internal/rules/builtin/builtin.go - Risk scoring
internal/risk/risk.go
Session and output
- Evidence store
internal/evidence/store.go - Session persistence
internal/session/session.go - Report rendering
internal/reporting/reporting.go - JSONL events
internal/events/events.go
Other components
- Operator
Connections 23
- Operator → CLI and console: runs commands
README.md - CLI and console → Authorization gate: confirms scope
internal/cli/authorization.go - CLI and console → Target manager: selects target
internal/cli/app.go - CLI and console → Assessment runner: starts assessment
README.md - Assessment runner → Stage orchestration: builds and runs
internal/assess/assess.go - Stage orchestration → Domain discovery: runs stage
README.md - Stage orchestration → Object enumeration: runs stage
README.md - Stage orchestration → Verification and deepening: runs stage
- Stage orchestration → Relationship graph: runs stage
README.md - Domain discovery → Directory service: queries directory
internal/discovery/discovery.go - Object enumeration → Directory service: searches objects
internal/enumeration/enumeration.go - Directory service → Entry normalization: normalizes entries
internal/directory/normalize.go - Directory service → LDAP client: uses LDAP client
README.md - Offline simulator → Directory service: provides offline service
README.md - Relationship graph → Attack path analysis: supports path analysis
internal/analysis/attackpath.go - Stage orchestration → Identity and trust analysis: runs analysis stage
README.md - Stage orchestration → Built-in detection rules: runs detection
README.md - Stage orchestration → Risk scoring: scores findings
README.md - Assessment runner → Evidence store: creates evidence store
internal/assess/assess.go - Assessment runner → JSONL events: configures event stream
internal/assess/assess.go - CLI and console → Session persistence: persists session
internal/cli/app.go - CLI and console → Report rendering: renders reports
README.md - Session persistence → Report rendering: supplies saved session
README.md