# az-x/pique architecture

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

- Interactive diagram: https://gitdiagram.com/az-x/pique
- Repository: https://github.com/az-x/pique

## Overview

Repique is a cross-platform DNS stub that accepts client queries, routes them through configurable channels and selected upstream nodes, and forwards them over encrypted DNS transports. Configuration builds listener, channel, and node settings; the DNS runtime handles requests and supports DNSCrypt, DoT, and DoH. The README also documents secure bootstrap, persisted server materials, flexible proxying, and ad hoc reloads. Relationships for sampled code are cited to the files showing them; README-only capabilities are retained as documented relationships, not claims of inspected implementation.

Main entry points: [`repique/features/dns/nodes/node_manager.go`](https://github.com/az-x/pique/blob/master/repique/features/dns/nodes/node_manager.go) (Upstream node manager), [`repique/configuration/config.go`](https://github.com/az-x/pique/blob/master/repique/configuration/config.go) (Configuration loader), [`repique/main.go`](https://github.com/az-x/pique/blob/master/repique/main.go) (Program entry), [`repique/features/dns/channels/cp.go`](https://github.com/az-x/pique/blob/master/repique/features/dns/channels/cp.go) (Query channels)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and configuration"]
  node_main["Program entry<br/>[main.go]"]
  node_config["Configuration loader<br/>[config.go]"]
  node_sources["Server sources<br/>[sources.go]"]
  node_watcher["Config reload watcher"]
end

subgraph group_routing["DNS query routing"]
  node_proxy["DNS proxy<br/>[resort_proxy.go]"]
  node_channels["Query channels<br/>[cp.go]"]
  node_channelmgr["Channel manager<br/>[channel_manager.go]"]
  node_session["Query session<br/>[session.go]"]
end

subgraph group_upstreams["Upstream and security"]
  node_nodemgr["Upstream node manager<br/>[node_manager.go]"]
  node_dnscryptnode["DNSCrypt node<br/>[dnscrypt.go]"]
  node_dohdot["DoH and DoT nodes"]
  node_materials["Server materials<br/>[materials.go]"]
  node_dnscrypt["DNSCrypt transport<br/>[dnscrypt.go]"]
  node_tls["TLS transports<br/>[ztransport.go]"]
  node_bootstrap(("Bootstrap resolver"))
end

subgraph group_network["Network and shared services"]
  node_nestedproxy["Nested proxy dialer<br/>[nested_proxy.go]"]
  node_common["Network and DNS utilities<br/>[common.go]"]
  node_regex["Query pattern actions<br/>[regex_actions.go]"]
end

node_operator(("Operator"))
node_upstream(("Encrypted DNS upstream"))

node_operator -->|"starts"| node_main
node_main -->|"loads config"| node_config
node_config -->|"initializes nodes"| node_nodemgr
node_config -->|"initializes channels"| node_channelmgr
node_config -.->|"loads server sources"| node_sources
node_config -.->|"supports reload"| node_watcher
node_main -->|"starts proxy"| node_proxy
node_proxy -->|"dispatches query"| node_channels
node_channels -.->|"uses session"| node_session
node_channels -.->|"queries nodes"| node_nodemgr
node_nodemgr -->|"builds node"| node_dnscryptnode
node_nodemgr -->|"selects transports"| node_dohdot
node_dnscryptnode -->|"uses protocol"| node_dnscrypt
node_nodemgr -->|"dispatches queries"| node_dnscrypt
node_nodemgr -->|"dispatches queries"| node_tls
node_nodemgr -->|"configures proxy"| node_nestedproxy
node_nodemgr -.->|"loads materials"| node_materials
node_materials -.->|"supports bootstrap"| node_bootstrap
node_bootstrap -.->|"resolves bootstrap"| node_upstream
node_dnscrypt -.->|"sends encrypted DNS"| node_upstream
node_tls -.->|"sends encrypted DNS"| node_upstream
node_nodemgr -.->|"uses query patterns"| node_regex
node_nestedproxy -->|"dials through"| node_common

click node_main "https://github.com/az-x/pique/blob/master/repique/main.go"
click node_config "https://github.com/az-x/pique/blob/master/repique/configuration/config.go"
click node_sources "https://github.com/az-x/pique/blob/master/repique/configuration/sources.go"
click node_watcher "https://github.com/az-x/pique/blob/master/repique/behaviors/fswatcher_windows.go"
click node_proxy "https://github.com/az-x/pique/blob/master/repique/features/dns/resort_proxy.go"
click node_channels "https://github.com/az-x/pique/blob/master/repique/features/dns/channels/cp.go"
click node_channelmgr "https://github.com/az-x/pique/blob/master/repique/features/dns/channels/channel_manager.go"
click node_session "https://github.com/az-x/pique/blob/master/repique/features/dns/channels/session.go"
click node_nodemgr "https://github.com/az-x/pique/blob/master/repique/features/dns/nodes/node_manager.go"
click node_dnscryptnode "https://github.com/az-x/pique/blob/master/repique/features/dns/nodes/dnscrypt.go"
click node_dohdot "https://github.com/az-x/pique/tree/master/repique/features/dns/nodes"
click node_materials "https://github.com/az-x/pique/blob/master/repique/features/dns/nodes/materials.go"
click node_dnscrypt "https://github.com/az-x/pique/blob/master/repique/protocols/dnscrypt/dnscrypt.go"
click node_tls "https://github.com/az-x/pique/blob/master/repique/protocols/tls/ztransport.go"
click node_nestedproxy "https://github.com/az-x/pique/blob/master/repique/conceptions/nested_proxy.go"
click node_common "https://github.com/az-x/pique/blob/master/repique/common/common.go"
click node_regex "https://github.com/az-x/pique/blob/master/repique/services/regex_actions.go"

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_main,node_config,node_sources,node_watcher toneBlue
class node_proxy,node_channels,node_channelmgr,node_session toneAmber
class node_nodemgr,node_dnscryptnode,node_dohdot,node_materials,node_dnscrypt,node_tls,node_bootstrap toneMint
class node_nestedproxy,node_common,node_regex toneRose
class node_operator,node_upstream toneIndigo
```

## Components

### Startup and configuration

- [Program entry](https://github.com/az-x/pique/blob/master/repique/main.go): `repique/main.go`
- [Configuration loader](https://github.com/az-x/pique/blob/master/repique/configuration/config.go): `repique/configuration/config.go`
- [Server sources](https://github.com/az-x/pique/blob/master/repique/configuration/sources.go): `repique/configuration/sources.go`
- [Config reload watcher](https://github.com/az-x/pique/blob/master/repique/behaviors/fswatcher_windows.go): `repique/behaviors/fswatcher_windows.go`

### DNS query routing

- [DNS proxy](https://github.com/az-x/pique/blob/master/repique/features/dns/resort_proxy.go): `repique/features/dns/resort_proxy.go`
- [Query channels](https://github.com/az-x/pique/blob/master/repique/features/dns/channels/cp.go): `repique/features/dns/channels/cp.go`
- [Channel manager](https://github.com/az-x/pique/blob/master/repique/features/dns/channels/channel_manager.go): `repique/features/dns/channels/channel_manager.go`
- [Query session](https://github.com/az-x/pique/blob/master/repique/features/dns/channels/session.go): `repique/features/dns/channels/session.go`

### Upstream and security

- [Upstream node manager](https://github.com/az-x/pique/blob/master/repique/features/dns/nodes/node_manager.go): `repique/features/dns/nodes/node_manager.go`
- [DNSCrypt node](https://github.com/az-x/pique/blob/master/repique/features/dns/nodes/dnscrypt.go): `repique/features/dns/nodes/dnscrypt.go`
- [DoH and DoT nodes](https://github.com/az-x/pique/tree/master/repique/features/dns/nodes): `repique/features/dns/nodes`
- [Server materials](https://github.com/az-x/pique/blob/master/repique/features/dns/nodes/materials.go): `repique/features/dns/nodes/materials.go`
- [DNSCrypt transport](https://github.com/az-x/pique/blob/master/repique/protocols/dnscrypt/dnscrypt.go): `repique/protocols/dnscrypt/dnscrypt.go`
- [TLS transports](https://github.com/az-x/pique/blob/master/repique/protocols/tls/ztransport.go): `repique/protocols/tls/ztransport.go`
- **Bootstrap resolver**

### Network and shared services

- [Nested proxy dialer](https://github.com/az-x/pique/blob/master/repique/conceptions/nested_proxy.go): `repique/conceptions/nested_proxy.go`
- [Network and DNS utilities](https://github.com/az-x/pique/blob/master/repique/common/common.go): `repique/common/common.go`
- [Query pattern actions](https://github.com/az-x/pique/blob/master/repique/services/regex_actions.go): `repique/services/regex_actions.go`

### Other components

- **Operator**
- **Encrypted DNS upstream**

## Connections

- Operator → Program entry: starts (evidence: `repique/main.go`)
- Program entry → Configuration loader: loads config (evidence: `repique/main.go`)
- Configuration loader → Upstream node manager: initializes nodes (evidence: `repique/configuration/config.go`)
- Configuration loader → Channel manager: initializes channels (evidence: `repique/configuration/config.go`)
- Configuration loader → Server sources: loads server sources
- Configuration loader → Config reload watcher: supports reload
- Program entry → DNS proxy: starts proxy (evidence: `repique/main.go`)
- DNS proxy → Query channels: dispatches query (evidence: `repique/features/dns/resort_proxy.go`)
- Query channels → Query session: uses session (evidence: `repique/features/dns/channels/cp.go`)
- Query channels → Upstream node manager: queries nodes (evidence: `repique/features/dns/channels/cp.go`)
- Upstream node manager → DNSCrypt node: builds node (evidence: `repique/features/dns/nodes/node_manager.go`)
- Upstream node manager → DoH and DoT nodes: selects transports (evidence: `repique/features/dns/nodes/node_manager.go`)
- DNSCrypt node → DNSCrypt transport: uses protocol (evidence: `repique/features/dns/nodes/dnscrypt.go`)
- Upstream node manager → DNSCrypt transport: dispatches queries (evidence: `repique/features/dns/nodes/node_manager.go`)
- Upstream node manager → TLS transports: dispatches queries (evidence: `repique/features/dns/nodes/node_manager.go`)
- Upstream node manager → Nested proxy dialer: configures proxy (evidence: `repique/features/dns/nodes/node_manager.go`)
- Upstream node manager → Server materials: loads materials
- Server materials → Bootstrap resolver: supports bootstrap
- Bootstrap resolver → Encrypted DNS upstream: resolves bootstrap
- DNSCrypt transport → Encrypted DNS upstream: sends encrypted DNS
- TLS transports → Encrypted DNS upstream: sends encrypted DNS
- Upstream node manager → Query pattern actions: uses query patterns (evidence: `repique/features/dns/nodes/node_manager.go`)
- Nested proxy dialer → Network and DNS utilities: dials through (evidence: `repique/conceptions/nested_proxy.go`)
