# qyvora/qyvora-nzinga architecture

> Architecture diagram of the GitHub repository qyvora/qyvora-nzinga, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qyvora/qyvora-nzinga
- Repository: https://github.com/qyvora/qyvora-nzinga

## Overview

NZINGA is an authorized OSINT framework: operators select and authorize a target, run collection and analysis, then inspect reproducible evidence-backed reports. The graph follows the documented DISCOVER-to-REPORT pipeline and includes the CLI, target gate, source collection, intelligence stages, findings/risk, persistence, and advertised capabilities. Pipeline stage relationships are documented in the README; sampled source and the SOURCE INDEX support the other cited calls. Some source implementations and CLI wiring were not sampled, so uncertain links are omitted.

Main entry points: [`internal/pipeline/pipeline.go`](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/pipeline/pipeline.go) (Stage runner), [`internal/cli`](https://github.com/qyvora/qyvora-nzinga/tree/main/internal/cli) (CLI and console), [`cmd/nzinga/main.go`](https://github.com/qyvora/qyvora-nzinga/blob/main/cmd/nzinga/main.go) (Command entry), [`internal/intelligence/sources`](https://github.com/qyvora/qyvora-nzinga/tree/main/internal/intelligence/sources) (Public-source collectors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator interface"]
  node_entry["Command entry<br/>[main.go]"]
  node_cli["CLI and console"]
  node_capabilities["Capability catalog<br/>[capabilities.go]"]
end

subgraph group_collection["Target and collection"]
  node_target["Target authorization<br/>[manager.go]"]
  node_pipeline["Stage runner<br/>[pipeline.go]"]
  node_collectors["Public-source collectors"]
  node_search["Search collection<br/>[search.go]"]
  node_search_provider["Search providers<br/>[providers.go]"]
end

subgraph group_intelligence["Intelligence pipeline"]
  node_normalize["Normalization<br/>[normalize.go]"]
  node_domain["Domain discovery<br/>[domain.go]"]
  node_relationships["Relationship graph<br/>[relationships.go]"]
  node_correlation["Correlation claims<br/>[correlate.go]"]
end

subgraph group_results["Findings and reports"]
  node_rules["Built-in rules<br/>[builtin.go]"]
  node_risk["Risk scoring<br/>[risk.go]"]
  node_reporting["Report rendering<br/>[reporting.go]"]
end

subgraph group_support["Contracts and state"]
  node_session[("Session persistence<br/>[session.go]")]
  node_models["Shared intelligence models"]
end

node_operator(("Operator"))

node_operator -->|"runs"| node_entry
node_entry -->|"executes"| node_cli
node_cli -->|"authorizes target"| node_target
node_cli -->|"starts assessment"| node_pipeline
node_pipeline -->|"discovers"| node_domain
node_pipeline -->|"collects"| node_collectors
node_collectors -.->|"includes"| node_search
node_search -->|"queries"| node_search_provider
node_pipeline -->|"normalizes"| node_normalize
node_pipeline -->|"builds graph"| node_relationships
node_pipeline -->|"correlates"| node_correlation
node_pipeline -->|"analyzes"| node_rules
node_pipeline -->|"calculates risk"| node_risk
node_pipeline -->|"renders reports"| node_reporting
node_cli -->|"loads and saves"| node_session
node_cli -->|"advertises"| node_capabilities
node_pipeline -->|"updates session"| node_models
node_reporting -->|"renders session"| node_models

click node_entry "https://github.com/qyvora/qyvora-nzinga/blob/main/cmd/nzinga/main.go"
click node_cli "https://github.com/qyvora/qyvora-nzinga/tree/main/internal/cli"
click node_capabilities "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/capabilities/capabilities.go"
click node_target "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/target/manager.go"
click node_pipeline "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/pipeline/pipeline.go"
click node_collectors "https://github.com/qyvora/qyvora-nzinga/tree/main/internal/intelligence/sources"
click node_search "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/sources/search.go"
click node_search_provider "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/search/providers.go"
click node_normalize "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/normalization/normalize.go"
click node_domain "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/domain/domain.go"
click node_relationships "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/relationships/relationships.go"
click node_correlation "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/correlation/correlate.go"
click node_rules "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/rules/builtin/builtin.go"
click node_risk "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/risk/risk.go"
click node_reporting "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/reporting/reporting.go"
click node_session "https://github.com/qyvora/qyvora-nzinga/blob/main/internal/session/session.go"
click node_models "https://github.com/qyvora/qyvora-nzinga/tree/main/pkg/models"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_cli,node_capabilities toneBlue
class node_target,node_pipeline,node_collectors,node_search,node_search_provider toneAmber
class node_normalize,node_domain,node_relationships,node_correlation toneMint
class node_rules,node_risk,node_reporting toneRose
class node_session,node_models,node_operator toneIndigo
```

## Components

### Operator interface

- [Command entry](https://github.com/qyvora/qyvora-nzinga/blob/main/cmd/nzinga/main.go): `cmd/nzinga/main.go`
- [CLI and console](https://github.com/qyvora/qyvora-nzinga/tree/main/internal/cli): `internal/cli`
- [Capability catalog](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/capabilities/capabilities.go): `internal/capabilities/capabilities.go`

### Target and collection

- [Target authorization](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/target/manager.go): `internal/target/manager.go`
- [Stage runner](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/pipeline/pipeline.go): `internal/pipeline/pipeline.go`
- [Public-source collectors](https://github.com/qyvora/qyvora-nzinga/tree/main/internal/intelligence/sources): `internal/intelligence/sources`
- [Search collection](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/sources/search.go): `internal/intelligence/sources/search.go`
- [Search providers](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/search/providers.go): `internal/search/providers.go`

### Intelligence pipeline

- [Normalization](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/normalization/normalize.go): `internal/intelligence/normalization/normalize.go`
- [Domain discovery](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/domain/domain.go): `internal/intelligence/domain/domain.go`
- [Relationship graph](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/relationships/relationships.go): `internal/intelligence/relationships/relationships.go`
- [Correlation claims](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/intelligence/correlation/correlate.go): `internal/intelligence/correlation/correlate.go`

### Findings and reports

- [Built-in rules](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/rules/builtin/builtin.go): `internal/rules/builtin/builtin.go`
- [Risk scoring](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/risk/risk.go): `internal/risk/risk.go`
- [Report rendering](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/reporting/reporting.go): `internal/reporting/reporting.go`

### Contracts and state

- [Session persistence](https://github.com/qyvora/qyvora-nzinga/blob/main/internal/session/session.go): `internal/session/session.go`
- [Shared intelligence models](https://github.com/qyvora/qyvora-nzinga/tree/main/pkg/models): `pkg/models`

### Other components

- **Operator**

## Connections

- Operator → Command entry: runs (evidence: `cmd/nzinga/main.go`)
- Command entry → CLI and console: executes (evidence: `cmd/nzinga/main.go`)
- CLI and console → Target authorization: authorizes target (evidence: `internal/cli/authorization.go`)
- CLI and console → Stage runner: starts assessment (evidence: `internal/cli/assess.go`)
- Stage runner → Domain discovery: discovers
- Stage runner → Public-source collectors: collects (evidence: `internal/pipeline/pipeline.go`)
- Public-source collectors → Search collection: includes
- Search collection → Search providers: queries (evidence: `internal/intelligence/sources/search.go`)
- Stage runner → Normalization: normalizes
- Stage runner → Relationship graph: builds graph (evidence: `internal/pipeline/pipeline.go`)
- Stage runner → Correlation claims: correlates
- Stage runner → Built-in rules: analyzes (evidence: `internal/pipeline/pipeline.go`)
- Stage runner → Risk scoring: calculates risk (evidence: `internal/pipeline/pipeline.go`)
- Stage runner → Report rendering: renders reports (evidence: `internal/pipeline/pipeline.go`)
- CLI and console → Session persistence: loads and saves (evidence: `internal/cli/assess.go`)
- CLI and console → Capability catalog: advertises
- Stage runner → Shared intelligence models: updates session (evidence: `internal/pipeline/pipeline.go`)
- Report rendering → Shared intelligence models: renders session (evidence: `internal/reporting/reporting.go`)
