# nidusvespae/jing architecture

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

- Interactive diagram: https://gitdiagram.com/nidusvespae/jing
- Repository: https://github.com/nidusvespae/jing

## Overview

Jing is a standard-library Python self-audit tool that checks whether public evidence links identities the user intended to keep separate. The user supplies identity clusters, private identifiers, and an owned-asset registry; the run checks scope, gathers evidence from public sources, classifies links, and emits a Markdown or JSON report with failures and manual checks. The implementation is a single file, so its domain stages are represented as components sharing that path. Some wiring is unsampled; uncertain dispatch links are marked dashed.

Main entry points: [`mirror.py`](https://github.com/nidusvespae/jing/blob/main/mirror.py) (Audit runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Audit setup"]
  node_inputs["Identity and asset inputs<br/>[mirror.py]"]
  node_scope["Scope gate<br/>[mirror.py]"]
  node_runner["Audit runner<br/>[mirror.py]"]
end

subgraph group_checks["Evidence checks"]
  node_github["GitHub audit<br/>[mirror.py]"]
  node_github_api{{"GitHub API"}}
  node_rdap["RDAP / WHOIS audit<br/>[mirror.py]"]
  node_rdap_service{{"RDAP and WHOIS"}}
  node_dns["DNS audit<br/>[mirror.py]"]
  node_dns_service{{"DNS resolvers"}}
  node_ct["Certificate audit<br/>[mirror.py]"]
  node_crtsh{{"crt.sh"}}
  node_pages["Webpage audit<br/>[mirror.py]"]
  node_owned_pages{{"Owned web pages"}}
end

subgraph group_analysis["Link analysis"]
  node_evidence["Evidence collection<br/>[mirror.py]"]
  node_classification["Link classification<br/>[mirror.py]"]
end

subgraph group_results["Audit results"]
  node_report["Report assembly<br/>[mirror.py]"]
  node_manual["Manual checklist<br/>[mirror.py]"]
  node_output["Markdown or JSON result"]
end

node_user(("Asset owner"))

node_user -->|"defines identities"| node_inputs
node_user -->|"starts audit"| node_runner
node_inputs -->|"sets asset scope"| node_scope
node_scope -->|"permits run"| node_runner
node_runner -.->|"dispatches check"| node_github
node_runner -.->|"dispatches check"| node_rdap
node_runner -.->|"dispatches check"| node_dns
node_runner -.->|"dispatches check"| node_ct
node_runner -.->|"dispatches check"| node_pages
node_github -->|"fetches profiles"| node_github_api
node_rdap -->|"queries records"| node_rdap_service
node_dns -->|"resolves records"| node_dns_service
node_ct -->|"queries certificates"| node_crtsh
node_pages -->|"checks content"| node_owned_pages
node_github -->|"records findings"| node_evidence
node_rdap -->|"records findings"| node_evidence
node_dns -->|"records findings"| node_evidence
node_ct -->|"records findings"| node_evidence
node_pages -->|"records findings"| node_evidence
node_inputs -->|"provides clusters"| node_classification
node_evidence -->|"classifies links"| node_classification
node_classification -->|"supplies findings"| node_report
node_inputs -->|"supplies manual checks"| node_report
node_report -->|"includes checklist"| node_manual
node_report -->|"renders result"| node_output

click node_inputs "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_scope "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_runner "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_github "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_rdap "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_dns "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_ct "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_pages "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_evidence "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_classification "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_report "https://github.com/nidusvespae/jing/blob/main/mirror.py"
click node_manual "https://github.com/nidusvespae/jing/blob/main/mirror.py"

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_inputs,node_scope,node_runner toneBlue
class node_github,node_github_api,node_rdap,node_rdap_service,node_dns,node_dns_service,node_ct,node_crtsh,node_pages,node_owned_pages toneAmber
class node_evidence,node_classification toneMint
class node_report,node_manual,node_output toneRose
class node_user toneIndigo
```

## Components

### Audit setup

- [Identity and asset inputs](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- [Scope gate](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- [Audit runner](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`

### Evidence checks

- [GitHub audit](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- **GitHub API**
- [RDAP / WHOIS audit](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- **RDAP and WHOIS**
- [DNS audit](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- **DNS resolvers**
- [Certificate audit](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- **crt.sh**
- [Webpage audit](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- **Owned web pages**

### Link analysis

- [Evidence collection](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- [Link classification](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`

### Audit results

- [Report assembly](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- [Manual checklist](https://github.com/nidusvespae/jing/blob/main/mirror.py): `mirror.py`
- **Markdown or JSON result**

### Other components

- **Asset owner**

## Connections

- Asset owner → Identity and asset inputs: defines identities (evidence: `README.md`)
- Asset owner → Audit runner: starts audit (evidence: `README.md`)
- Identity and asset inputs → Scope gate: sets asset scope (evidence: `README.md`)
- Scope gate → Audit runner: permits run (evidence: `README.md`)
- Audit runner → GitHub audit: dispatches check (evidence: `mirror.py`)
- Audit runner → RDAP / WHOIS audit: dispatches check (evidence: `mirror.py`)
- Audit runner → DNS audit: dispatches check (evidence: `mirror.py`)
- Audit runner → Certificate audit: dispatches check (evidence: `mirror.py`)
- Audit runner → Webpage audit: dispatches check (evidence: `mirror.py`)
- GitHub audit → GitHub API: fetches profiles (evidence: `mirror.py`)
- RDAP / WHOIS audit → RDAP and WHOIS: queries records (evidence: `mirror.py`)
- DNS audit → DNS resolvers: resolves records (evidence: `mirror.py`)
- Certificate audit → crt.sh: queries certificates (evidence: `README.md`)
- Webpage audit → Owned web pages: checks content (evidence: `README.md`)
- GitHub audit → Evidence collection: records findings (evidence: `mirror.py`)
- RDAP / WHOIS audit → Evidence collection: records findings (evidence: `mirror.py`)
- DNS audit → Evidence collection: records findings (evidence: `README.md`)
- Certificate audit → Evidence collection: records findings (evidence: `mirror.py`)
- Webpage audit → Evidence collection: records findings (evidence: `README.md`)
- Identity and asset inputs → Link classification: provides clusters (evidence: `mirror.py`)
- Evidence collection → Link classification: classifies links (evidence: `mirror.py`)
- Link classification → Report assembly: supplies findings (evidence: `mirror.py`)
- Identity and asset inputs → Report assembly: supplies manual checks (evidence: `README.md`)
- Report assembly → Manual checklist: includes checklist (evidence: `mirror.py`)
- Report assembly → Markdown or JSON result: renders result (evidence: `mirror.py`)
