# 86cloudyun-afk/dsh-gungnir architecture

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

- Interactive diagram: https://gitdiagram.com/86cloudyun-afk/dsh-gungnir
- Repository: https://github.com/86cloudyun-afk/dsh-gungnir

## Overview

GUNGNIR is an authorized red-team campaign orchestration framework, not an exploit toolkit. The operator starts a campaign and runs waves through the CLI or DSH tools; the host broker enforces execution and campaign gates, delegates to an adapter, and supports monitoring, evidence capture, and delivery. The README documents additional campaign lifecycle capabilities. Source excerpts show key host, adapter, tool, and reporting connections; links to less-sampled capabilities are included only where the README describes the workflow.

Main entry points: [`packages/warroom-core/src/broker.js`](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/broker.js) (Campaign broker), [`packages/warroom-plugin/src/service.js`](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-plugin/src/service.js) (Host service), [`packages/warroom-core/src/adapters/redteam-mode.js`](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/adapters/redteam-mode.js) (Execution adapters), [`bin/warroom.mjs`](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/bin/warroom.mjs) (Campaign CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Operator interfaces"]
  node_cli["Campaign CLI<br/>[warroom.mjs]"]
  node_dsh(("DSH host"))
  node_plugin["Host service<br/>[service.js]"]
  node_toolwrap["DSH tool wrapper<br/>[tools.js]"]
  node_tools["Agent tools<br/>[index.js]"]
end

subgraph group_execution["Execution and control"]
  node_broker["Campaign broker<br/>[broker.js]"]
  node_contracts["Shared contracts<br/>[index.js]"]
  node_adapter["Execution adapters<br/>[redteam-mode.js]"]
  node_fake["Offline adapter<br/>[fake.js]"]
  node_bridge["DSH bridge driver<br/>[dsh-bridge.js]"]
end

subgraph group_campaign["Campaign operations"]
  node_config["Campaign config<br/>[config.js]"]
  node_jumps["Jump host pool<br/>[jumphosts.js]"]
  node_preflight["Preflight gates<br/>[preflight.js]"]
  node_waves["Wave execution<br/>[wave.js]"]
  node_watch["Campaign watch<br/>[watch.js]"]
  node_knowledge["Knowledge base<br/>[knowledge.js]"]
end

subgraph group_delivery["Evidence and delivery"]
  node_facts[("Campaign fact store<br/>[store.js]")]
  node_checklist["Delivery checklist<br/>[checklist.js]"]
  node_report["Report exporter<br/>[report.js]"]
  node_html["HTML renderer<br/>[html.js]"]
  node_evidence["Evidence export<br/>[evidence.js]"]
  node_archive["Archive and backup<br/>[weekly.js]"]
  node_aggregate["Cross-campaign view<br/>[aggregate.js]"]
end

node_operator(("Operator"))

node_operator -->|"runs commands"| node_cli
node_cli -->|"invokes"| node_broker
node_dsh -->|"loads service"| node_plugin
node_plugin -->|"creates"| node_broker
node_plugin -->|"creates"| node_jumps
node_plugin -->|"selects adapter"| node_adapter
node_plugin -->|"exposes view"| node_aggregate
node_dsh -->|"registers tools"| node_toolwrap
node_toolwrap -->|"wraps definitions"| node_tools
node_tools -->|"invokes operations"| node_broker
node_broker -->|"validates against"| node_contracts
node_broker -->|"dispatches tasks"| node_adapter
node_adapter -.->|"selects offline mode"| node_fake
node_adapter -.->|"uses bridge driver"| node_bridge
node_broker -->|"loads settings"| node_config
node_broker -.->|"records campaign facts"| node_facts
node_broker -->|"exports reports"| node_report
node_broker -->|"exports evidence"| node_evidence
node_broker -->|"checks delivery"| node_checklist
node_broker -->|"archives weekly"| node_archive
node_broker -.->|"manages routes"| node_jumps
node_operator -->|"runs preflight"| node_preflight
node_operator -->|"runs waves"| node_waves
node_operator -->|"monitors campaign"| node_watch
node_operator -.->|"records knowledge"| node_knowledge
node_report -->|"renders HTML"| node_html
node_operator -->|"reviews campaigns"| node_aggregate

click node_cli "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/bin/warroom.mjs"
click node_plugin "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-plugin/src/service.js"
click node_toolwrap "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-plugin/src/tools.js"
click node_tools "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-tools/src/index.js"
click node_broker "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/broker.js"
click node_contracts "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/shared-types/src/index.js"
click node_adapter "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/adapters/redteam-mode.js"
click node_fake "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/adapters/fake.js"
click node_bridge "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/adapters/dsh-bridge.js"
click node_config "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/config.js"
click node_jumps "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/jumphosts.js"
click node_preflight "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/preflight.js"
click node_waves "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/wave.js"
click node_watch "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/watch.js"
click node_knowledge "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/knowledge.js"
click node_facts "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/store.js"
click node_checklist "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/checklist.js"
click node_report "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/report.js"
click node_html "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/html.js"
click node_evidence "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/evidence.js"
click node_archive "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/weekly.js"
click node_aggregate "https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/aggregate.js"

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_cli,node_dsh,node_plugin,node_toolwrap,node_tools toneBlue
class node_broker,node_contracts,node_adapter,node_fake,node_bridge toneAmber
class node_config,node_jumps,node_preflight,node_waves,node_watch,node_knowledge toneMint
class node_facts,node_checklist,node_report,node_html,node_evidence,node_archive,node_aggregate toneRose
class node_operator toneIndigo
```

## Components

### Operator interfaces

- [Campaign CLI](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/bin/warroom.mjs): `bin/warroom.mjs`
- **DSH host**
- [Host service](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-plugin/src/service.js): `packages/warroom-plugin/src/service.js`
- [DSH tool wrapper](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-plugin/src/tools.js): `packages/warroom-plugin/src/tools.js`
- [Agent tools](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-tools/src/index.js): `packages/warroom-tools/src/index.js`

### Execution and control

- [Campaign broker](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/broker.js): `packages/warroom-core/src/broker.js`
- [Shared contracts](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/shared-types/src/index.js): `packages/shared-types/src/index.js`
- [Execution adapters](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/adapters/redteam-mode.js): `packages/warroom-core/src/adapters/redteam-mode.js`
- [Offline adapter](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/adapters/fake.js): `packages/warroom-core/src/adapters/fake.js`
- [DSH bridge driver](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/adapters/dsh-bridge.js): `packages/warroom-core/src/adapters/dsh-bridge.js`

### Campaign operations

- [Campaign config](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/config.js): `packages/warroom-core/src/config.js`
- [Jump host pool](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/jumphosts.js): `packages/warroom-core/src/jumphosts.js`
- [Preflight gates](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/preflight.js): `packages/warroom-core/src/preflight.js`
- [Wave execution](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/wave.js): `packages/warroom-core/src/wave.js`
- [Campaign watch](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/watch.js): `packages/warroom-core/src/watch.js`
- [Knowledge base](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/knowledge.js): `packages/warroom-core/src/knowledge.js`

### Evidence and delivery

- [Campaign fact store](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/store.js): `packages/warroom-core/src/store.js`
- [Delivery checklist](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/checklist.js): `packages/warroom-core/src/checklist.js`
- [Report exporter](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/report.js): `packages/warroom-core/src/report.js`
- [HTML renderer](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/html.js): `packages/warroom-core/src/html.js`
- [Evidence export](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/evidence.js): `packages/warroom-core/src/evidence.js`
- [Archive and backup](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/weekly.js): `packages/warroom-core/src/weekly.js`
- [Cross-campaign view](https://github.com/86cloudyun-afk/dsh-gungnir/blob/main/packages/warroom-core/src/aggregate.js): `packages/warroom-core/src/aggregate.js`

### Other components

- **Operator**

## Connections

- Operator → Campaign CLI: runs commands (evidence: `README.md`)
- Campaign CLI → Campaign broker: invokes (evidence: `bin/warroom.mjs`)
- DSH host → Host service: loads service (evidence: `packages/warroom-plugin/src/service.js`)
- Host service → Campaign broker: creates (evidence: `packages/warroom-plugin/src/service.js`)
- Host service → Jump host pool: creates (evidence: `packages/warroom-plugin/src/service.js`)
- Host service → Execution adapters: selects adapter (evidence: `packages/warroom-plugin/src/service.js`)
- Host service → Cross-campaign view: exposes view (evidence: `packages/warroom-plugin/src/service.js`)
- DSH host → DSH tool wrapper: registers tools
- DSH tool wrapper → Agent tools: wraps definitions (evidence: `packages/warroom-plugin/src/tools.js`)
- Agent tools → Campaign broker: invokes operations (evidence: `packages/warroom-tools/src/index.js`)
- Campaign broker → Shared contracts: validates against (evidence: `packages/warroom-core/src/broker.js`)
- Campaign broker → Execution adapters: dispatches tasks (evidence: `README.md`)
- Execution adapters → Offline adapter: selects offline mode
- Execution adapters → DSH bridge driver: uses bridge driver
- Campaign broker → Campaign config: loads settings (evidence: `packages/warroom-core/src/broker.js`)
- Campaign broker → Campaign fact store: records campaign facts (evidence: `packages/warroom-core/src/broker.js`)
- Campaign broker → Report exporter: exports reports (evidence: `packages/warroom-core/src/broker.js`)
- Campaign broker → Evidence export: exports evidence (evidence: `packages/warroom-core/src/broker.js`)
- Campaign broker → Delivery checklist: checks delivery (evidence: `packages/warroom-core/src/broker.js`)
- Campaign broker → Archive and backup: archives weekly (evidence: `README.md`)
- Campaign broker → Jump host pool: manages routes
- Operator → Preflight gates: runs preflight (evidence: `README.md`)
- Operator → Wave execution: runs waves (evidence: `README.md`)
- Operator → Campaign watch: monitors campaign (evidence: `README.md`)
- Operator → Knowledge base: records knowledge
- Report exporter → HTML renderer: renders HTML (evidence: `packages/warroom-core/src/report.js`)
- Operator → Cross-campaign view: reviews campaigns (evidence: `README.md`)
