krz/domain-dig

 1┌──────────────────────────────────────────────────────────────┐
 2│  D O M A I N D I G                         [ KRZ ]   krz.sh  │
 3└──────────────────────────────────────────────────────────────┘
 4
 5WHAT
 6  local-first ios domain inspection toolkit. dns, web, ownership,
 7  monitoring, reporting, audit. takes a point-in-time snapshot of a
 8  domain, normalizes it into a DomainReport, and keeps data on device
 9  unless you export, share, or sync it.
10
11DOES
12  - inspects dns records, email security, tls certs, http headers,
13    redirects, ip geolocation, reachability, open ports, rdap,
14    ownership, subdomains, availability
15  - DomainReport output used by the ui and exports
16  - history snapshots with change summaries, risk scoring, notes
17  - dashboard, watchlist, monitoring, workflows, batch results,
18    integrations, data portability
19  - audit mode: sessions, checklists, reviewer notes, findings,
20    evidence snapshots, timelines, markdown/json/pdf export
21  - backup and restore for tracked domains, history, audit sessions,
22    workflows, monitoring, settings, feature metadata
23  - optional local api for automation-compatible output
24
25PRIVACY
26  app data lives in on-device storage. network requests go out only
27  to run the checks you asked for or the resolver you configured. no
28  hosted backend required.
29
30BUILD
31  needs xcode with a current ios sdk and a simulator or device.
32
33      git clone https://github.com/krazywarez/domain-dig.git
34
35  open DomainDig.xcodeproj, pick the DomainDig scheme, build and run.
36
37  build check:
38
39      xcodebuild -project DomainDig.xcodeproj -scheme DomainDig \
40        -destination 'platform=iOS Simulator,name=iPhone 16' build
41
42TESTS
43  deterministic core coverage lives in DomainDigTests:
44
45      xcodebuild test -project DomainDig.xcodeproj -scheme DomainDig \
46        -destination 'platform=iOS Simulator,name=iPhone 16' \
47        -only-testing:DomainDigTests
48
49  the scheme's test action also runs the DomainDigUITests
50  accessibility audit.
51
52      ./Scripts/audit-a11y.sh          # oldest supported + newest
53      ./Scripts/audit-a11y.sh floor    # oldest only (~85s)
54
55  findings are reported, not enforced. optional pre-push hook:
56
57      git config core.hooksPath .githooks
58
59DOCS
60  local api:      Docs/local-api.txt
61  data migration: Docs/data-migration.txt
62  accessibility:  Docs/ACCESSIBILITY.txt
63  releases:       RELEASE_ROADMAP.txt  (v4.4.1 -> v5.0.0)
64  security:       SECURITY.txt
65
66LICENSE
67  0bsd. see LICENSE.
68
69CONTACT
70  root@krz.sh
71
72┌──────────────────────────────────────────────────────────────┐
73│  krz.sh                                                      │
74└──────────────────────────────────────────────────────────────┘