inspectra-cli 2.0.0__tar.gz → 2.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. inspectra_cli-2.1.0/.github/ISSUE_TEMPLATE/bug_report.yml +55 -0
  2. inspectra_cli-2.1.0/.github/ISSUE_TEMPLATE/feature_request.yml +39 -0
  3. inspectra_cli-2.1.0/.github/PULL_REQUEST_TEMPLATE.md +23 -0
  4. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/CHANGELOG.md +39 -19
  5. inspectra_cli-2.1.0/PKG-INFO +201 -0
  6. inspectra_cli-2.1.0/README.md +161 -0
  7. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/RELEASE_NOTES.md +1 -1
  8. inspectra_cli-2.1.0/THREAT_MODEL.md +223 -0
  9. inspectra_cli-2.1.0/assets/architecture.svg +68 -0
  10. inspectra_cli-2.1.0/assets/banner-dark.svg +22 -0
  11. inspectra_cli-2.1.0/assets/banner-light.svg +22 -0
  12. inspectra_cli-2.1.0/assets/favicon.svg +7 -0
  13. inspectra_cli-2.1.0/assets/logo-mark.svg +11 -0
  14. inspectra_cli-2.1.0/assets/palette.md +47 -0
  15. inspectra_cli-2.1.0/assets/social-preview.png +0 -0
  16. inspectra_cli-2.1.0/assets/social-preview.svg +23 -0
  17. inspectra_cli-2.1.0/assets/terminal-demo.svg +53 -0
  18. inspectra_cli-2.1.0/assets/wordmark.svg +21 -0
  19. inspectra_cli-2.1.0/docs/assets/make_social_png.py +43 -0
  20. inspectra_cli-2.1.0/docs/assets/make_terminal_svg.py +103 -0
  21. inspectra_cli-2.1.0/docs/benchmark.md +48 -0
  22. inspectra_cli-2.1.0/docs/reports/README.md +19 -0
  23. inspectra_cli-2.1.0/docs/reports/target1.html +159 -0
  24. inspectra_cli-2.1.0/docs/reports/target1.json +69 -0
  25. inspectra_cli-2.1.0/docs/reports/target1.sarif +172 -0
  26. inspectra_cli-2.1.0/docs/reports/target2.html +159 -0
  27. inspectra_cli-2.1.0/docs/reports/target2.json +69 -0
  28. inspectra_cli-2.1.0/docs/reports/target2.sarif +172 -0
  29. inspectra_cli-2.1.0/docs/reports/target3.html +159 -0
  30. inspectra_cli-2.1.0/docs/reports/target3.json +69 -0
  31. inspectra_cli-2.1.0/docs/reports/target3.sarif +172 -0
  32. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/roadmap.md +3 -1
  33. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/usage.md +3 -1
  34. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/pyproject.toml +12 -1
  35. inspectra_cli-2.1.0/run_benchmark.py +145 -0
  36. inspectra_cli-2.1.0/site/banner.svg +22 -0
  37. inspectra_cli-2.1.0/site/favicon.svg +7 -0
  38. inspectra_cli-2.1.0/site/logo-mark.svg +11 -0
  39. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/__init__.py +1 -1
  40. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/baseline.py +16 -15
  41. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/context.py +9 -0
  42. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/dns.py +32 -11
  43. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/http.py +3 -4
  44. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/tls.py +30 -1
  45. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/cli.py +41 -6
  46. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/models.py +6 -3
  47. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/network.py +71 -0
  48. inspectra_cli-2.1.0/src/inspectra/orchestrator.py +281 -0
  49. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/replay.py +13 -3
  50. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/json_report.py +6 -4
  51. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/sarif_report.py +8 -8
  52. inspectra_cli-2.1.0/tests/test_concurrency.py +388 -0
  53. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_replay.py +11 -2
  54. inspectra_cli-2.0.0/PKG-INFO +0 -468
  55. inspectra_cli-2.0.0/README.md +0 -433
  56. inspectra_cli-2.0.0/docs/benchmark.md +0 -95
  57. inspectra_cli-2.0.0/run_benchmark.py +0 -126
  58. inspectra_cli-2.0.0/src/inspectra/orchestrator.py +0 -145
  59. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.dockerignore +0 -0
  60. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  61. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  62. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/ISSUE_TEMPLATE/new_check.md +0 -0
  63. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/ci.yml +0 -0
  64. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/docker.yml +0 -0
  65. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/pages.yml +0 -0
  66. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/release.yml +0 -0
  67. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.gitignore +0 -0
  68. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/CODE_OF_CONDUCT.md +0 -0
  69. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/CONTRIBUTING.md +0 -0
  70. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/Dockerfile +0 -0
  71. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/LICENSE +0 -0
  72. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/PUBLISH-TESTPYPI.bat +0 -0
  73. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/SECURITY.md +0 -0
  74. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/action.yml +0 -0
  75. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/demo/index.html +0 -0
  76. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/demo/server.py +0 -0
  77. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/architecture.md +0 -0
  78. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/architecture.png +0 -0
  79. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/banner.png +0 -0
  80. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/cli-demo.png +0 -0
  81. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/dashboard-demo.png +0 -0
  82. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/findings.png +0 -0
  83. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/html-report.png +0 -0
  84. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/logo.png +0 -0
  85. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/logo.svg +0 -0
  86. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/report-summary.png +0 -0
  87. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/workflow.png +0 -0
  88. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/safety.md +0 -0
  89. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/examples/sample-report/report.html +0 -0
  90. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/examples/sample-report/report.json +0 -0
  91. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/examples/sample-report/report.md +0 -0
  92. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/docker-compose.yml +0 -0
  93. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/expected.json +0 -0
  94. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/benchmark_results.json +0 -0
  95. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target1.json +0 -0
  96. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target10.json +0 -0
  97. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target11.json +0 -0
  98. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target12.json +0 -0
  99. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target2.json +0 -0
  100. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target3.json +0 -0
  101. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target4.json +0 -0
  102. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target5.json +0 -0
  103. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target6.json +0 -0
  104. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target7.json +0 -0
  105. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target8.json +0 -0
  106. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target9.json +0 -0
  107. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target1/server.py +0 -0
  108. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target10/server.py +0 -0
  109. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target11/server.py +0 -0
  110. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target12/server.py +0 -0
  111. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target2/server.py +0 -0
  112. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target3/server.py +0 -0
  113. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target4/server.py +0 -0
  114. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target5/server.py +0 -0
  115. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target6/server.py +0 -0
  116. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target7/server.py +0 -0
  117. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target8/server.py +0 -0
  118. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target9/server.py +0 -0
  119. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/scripts/benchmark.py +0 -0
  120. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/scripts/generate_sample_report.py +0 -0
  121. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/scripts/publish-testpypi.ps1 +0 -0
  122. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/.nojekyll +0 -0
  123. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/index.html +0 -0
  124. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/report.html +0 -0
  125. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/report.json +0 -0
  126. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/report.md +0 -0
  127. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/__main__.py +0 -0
  128. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/analysis/__init__.py +0 -0
  129. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/analysis/recommendations.py +0 -0
  130. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/analysis/risk.py +0 -0
  131. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/__init__.py +0 -0
  132. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/directories.py +0 -0
  133. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/fingerprint.py +0 -0
  134. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/headers.py +0 -0
  135. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/ports.py +0 -0
  136. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/robots.py +0 -0
  137. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/data/directory_wordlist.txt +0 -0
  138. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/data/fingerprints.json +0 -0
  139. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/data/header_rules.json +0 -0
  140. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/py.typed +0 -0
  141. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/redact.py +0 -0
  142. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/__init__.py +0 -0
  143. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/html_report.py +0 -0
  144. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/markdown_report.py +0 -0
  145. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/templates/report.html.j2 +0 -0
  146. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/safety.py +0 -0
  147. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/utils.py +0 -0
  148. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/conftest.py +0 -0
  149. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/fixtures/replay/107b5723ce35838ea43887ffc9376a0ec84f2fe57bdd5f9a7f125061ccf63ecc.json +0 -0
  150. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/fixtures/replay/60e8ee63d1b6b15b2ae35f9f6f5bd15eebbede57e329131f98d28edae4dfd34d.json +0 -0
  151. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/fixtures/replay/index.json +0 -0
  152. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_benchmark_spec.py +0 -0
  153. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_cli.py +0 -0
  154. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_directories.py +0 -0
  155. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_dns.py +0 -0
  156. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_fingerprint.py +0 -0
  157. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_headers.py +0 -0
  158. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_http.py +0 -0
  159. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_models.py +0 -0
  160. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_orchestrator.py +0 -0
  161. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_ports.py +0 -0
  162. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_redact.py +0 -0
  163. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_reports.py +0 -0
  164. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_risk.py +0 -0
  165. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_robots.py +0 -0
  166. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_safety.py +0 -0
  167. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_sarif.py +0 -0
  168. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_tls.py +0 -0
  169. {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_utils.py +0 -0
@@ -0,0 +1,55 @@
1
+ name: Bug Report
2
+ description: File a bug report for Inspectra
3
+ title: "[Bug] "
4
+ labels: ["bug", "triage"]
5
+ body:
6
+ - type: markdown
7
+ attributes:
8
+ value: |
9
+ Thanks for reporting! Please confirm you are scanning targets you own or are
10
+ explicitly authorized to test.
11
+ - type: input
12
+ id: version
13
+ attributes:
14
+ label: Inspectra version
15
+ description: Run `inspectra --version` and paste the output.
16
+ placeholder: "2.1.0"
17
+ validations:
18
+ required: true
19
+ - type: input
20
+ id: target
21
+ attributes:
22
+ label: Target (only targets you own/authorize)
23
+ description: Hostname, IP, or URL you scanned.
24
+ placeholder: "http://127.0.0.1:9999"
25
+ validations:
26
+ required: true
27
+ - type: textarea
28
+ id: steps
29
+ attributes:
30
+ label: Steps to reproduce
31
+ description: Exact commands and flags used.
32
+ placeholder: |
33
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format json
34
+ validations:
35
+ required: true
36
+ - type: textarea
37
+ id: expected
38
+ attributes:
39
+ label: Expected behavior
40
+ validations:
41
+ required: true
42
+ - type: textarea
43
+ id: actual
44
+ attributes:
45
+ label: Actual behavior
46
+ description: Include any error output or report excerpts.
47
+ validations:
48
+ required: true
49
+ - type: checkboxes
50
+ id: authorization
51
+ attributes:
52
+ label: Authorization
53
+ options:
54
+ - label: "I confirm I scanned only targets I own or am authorized to test."
55
+ required: true
@@ -0,0 +1,39 @@
1
+ name: Feature Request
2
+ description: Suggest a new check or improvement for Inspectra
3
+ title: "[Feature] "
4
+ labels: ["enhancement", "triage"]
5
+ body:
6
+ - type: markdown
7
+ attributes:
8
+ value: |
9
+ Feature requests must align with Inspectra's founding promise:
10
+ **observe, assess, explain, report — never exploit.** Exploitation,
11
+ brute-forcing, or payload-delivery features will be declined.
12
+ - type: textarea
13
+ id: problem
14
+ attributes:
15
+ label: Problem or gap
16
+ description: What limitation are you hitting?
17
+ placeholder: "I'd like Inspectra to also check ..."
18
+ validations:
19
+ required: true
20
+ - type: textarea
21
+ id: proposal
22
+ attributes:
23
+ label: Proposed solution
24
+ description: How should it work, and what output should it produce?
25
+ validations:
26
+ required: true
27
+ - type: input
28
+ id: target-example
29
+ attributes:
30
+ label: Example target (authorized only)
31
+ description: A target you own where this check would apply.
32
+ placeholder: "http://127.0.0.1:9999"
33
+ - type: checkboxes
34
+ id: authorization
35
+ attributes:
36
+ label: Authorization
37
+ options:
38
+ - label: "I confirm any example target is one I own or am authorized to test."
39
+ required: true
@@ -0,0 +1,23 @@
1
+ ## Description
2
+ Briefly describe the change.
3
+
4
+ ## Related issue
5
+ Link to the issue this addresses (if any).
6
+
7
+ ## Type of change
8
+ - [ ] Bug fix
9
+ - [ ] New check
10
+ - [ ] Documentation
11
+ - [ ] Refactor / cleanup
12
+
13
+ ## Authorization reminder
14
+ Inspectra is a passive assessment tool. Confirm:
15
+ - [ ] Any target used for testing is owned by me or explicitly authorized
16
+ - [ ] No exploitation, brute-forcing, or payload delivery is added
17
+
18
+ ## Checklist
19
+ - [ ] `ruff check .` passes
20
+ - [ ] `ruff format --check .` passes
21
+ - [ ] `mypy src --strict` passes
22
+ - [ ] `pytest` passes
23
+ - [ ] Docs updated (README / docs / CHANGELOG as needed)
@@ -4,40 +4,60 @@ All notable changes to Inspectra are documented here. The format follows
4
4
  [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions
5
5
  follow [Semantic Versioning](https://semver.org/).
6
6
 
7
- ## [Unreleased]
7
+ ## [2.1.0] - 2026-11-16
8
+
9
+ ### Added
10
+
11
+ - **Bounded concurrency:** `--concurrency` (default 4) runs checks
12
+ concurrently with a bounded thread pool; `--delay` (default 0.2s)
13
+ applies per-host spacing between requests so sleeping never holds
14
+ another host's slot.
15
+ - **Per-host politeness:** max 2 in-flight requests per host regardless
16
+ of global concurrency, enforced with a per-host semaphore keyed by
17
+ hostname.
18
+ - **Per-run DNS/TLS caches:** DNS resolution and TLS handshake results
19
+ are cached per run keyed by host (and host+port), so each host is
20
+ resolved/hand-shaken at most once per scan.
21
+ - **Replay `skipped` reporting:** replayed scans now emit a `skipped`
22
+ array (`dns`, `ports`, `tls` with reason "requires live network; not
23
+ available in replay") and the CLI prints one line listing them,
24
+ instead of silently omitting raw-socket checks.
25
+
26
+ ## [2.0.0] - 2026-11-14
8
27
 
9
28
  ### Added
10
29
 
11
30
  - **Deterministic replay (M4):** `--save-fixtures DIR` records every HTTP
12
- request/response to disk; `--replay DIR` replays scans entirely from disk
13
- with zero network I/O. Two runs against the same fixtures produce
31
+ request/response to disk; `--replay DIR` replays scans entirely from
32
+ disk with zero network I/O. Two runs against the same fixtures produce
14
33
  byte-identical JSON reports (modulo timestamps).
15
34
  - **`evidence_hash` on findings:** `sha256` of canonical JSON evidence
16
35
  (truncated to 16 chars), stored on every `Finding` and emitted in JSON
17
36
  reports and SARIF `properties.evidenceHash`.
18
- - **SARIF output:** `--format sarif` produces SARIF 2.1.0 compatible output
19
- consumable by GitHub Code Scanning.
20
- - **Baseline diff:** `--save-baseline` / `--baseline` compare scans against
21
- a previous run; `--fail-on` applies only to new findings.
37
+ - **SARIF output:** `--format sarif` produces SARIF 2.1.0 compatible
38
+ output consumable by GitHub Code Scanning.
39
+ - **Baseline diff:** `--save-baseline` / `--baseline` compare scans
40
+ against a previous run; `--fail-on` applies only to new findings.
22
41
  - **SSRF hardening:** validated IP pinning (DNS rebinding protection),
23
42
  explicit blocked-network list including CGNAT (100.64/10), HTTPS→HTTP
24
43
  downgrade rejection, per-redirect-hop re-validation.
25
- - **Evidence redaction:** header lines, URL userinfo/query tokens, and JWTs
26
- are redacted before any reporter serializes them. `--no-redact` disables
27
- with a stderr warning.
28
- - **Hosted sample report:** a static report and supporting files are hosted on
29
- GitHub Pages at https://shashu123456.github.io/Inspectra/ for recruiter
30
- review without installing anything.
44
+ - **Evidence redaction:** header lines, URL userinfo/query tokens, and
45
+ JWTs are redacted before any reporter serializes them.
46
+ `--no-redact` disables with a stderr warning.
47
+ - **Hosted sample report:** a static report and supporting files are
48
+ hosted on GitHub Pages at
49
+ https://shashu123456.github.io/Inspectra/ for recruiter review without
50
+ installing anything.
31
51
 
32
52
  ### Changed
33
53
 
34
54
  - **CLI:** `--format` now accepts `sarif` and comma-separated lists
35
- (`sarif,json,markdown`); `-o/--output` writes a single-format report to
36
- an exact path; `--fail-on` accepts `none|low|medium|high` and works
37
- without a baseline.
38
- - **Reports:** JSON includes `evidence_hash` per finding plus `scope` and
39
- `redaction` metadata; SARIF includes `evidenceHash` in result properties
40
- and scope/redaction in run properties.
55
+ (`sarif,json,markdown`); `-o/--output` writes a single-format report
56
+ to an exact path; `--fail-on` accepts `none|low|medium|high` and
57
+ works without a baseline.
58
+ - **Reports:** JSON includes `evidence_hash` per finding plus `scope`
59
+ and `redaction` metadata; SARIF includes `evidenceHash` in result
60
+ properties and scope/redaction in run properties.
41
61
 
42
62
  ## [1.0.0] — 2026-09-08
43
63
 
@@ -0,0 +1,201 @@
1
+ Metadata-Version: 2.5
2
+ Name: inspectra-cli
3
+ Version: 2.1.0
4
+ Summary: An open-source, explainable security assessment framework for safe and authorized security analysis.
5
+ Project-URL: Homepage, https://github.com/shashu123456/Inspectra
6
+ Project-URL: Repository, https://github.com/shashu123456/Inspectra
7
+ Project-URL: Changelog, https://github.com/shashu123456/Inspectra/blob/main/CHANGELOG.md
8
+ Project-URL: Documentation, https://shashu123456.github.io/Inspectra/
9
+ Project-URL: Issues, https://github.com/shashu123456/Inspectra/issues
10
+ Author: Inspectra contributors
11
+ License: MIT
12
+ License-File: LICENSE
13
+ Keywords: cli,python,security,security-audit,vulnerability-assessment
14
+ Classifier: Development Status :: 5 - Production/Stable
15
+ Classifier: Environment :: Console
16
+ Classifier: Intended Audience :: Developers
17
+ Classifier: Intended Audience :: Information Technology
18
+ Classifier: Intended Audience :: System Administrators
19
+ Classifier: License :: OSI Approved :: MIT License
20
+ Classifier: Operating System :: OS Independent
21
+ Classifier: Programming Language :: Python :: 3
22
+ Classifier: Programming Language :: Python :: 3.11
23
+ Classifier: Programming Language :: Python :: 3.12
24
+ Classifier: Topic :: Security
25
+ Classifier: Topic :: System :: Networking :: Monitoring
26
+ Requires-Python: >=3.10
27
+ Requires-Dist: cryptography>=42.0
28
+ Requires-Dist: dnspython>=2.4.0
29
+ Requires-Dist: httpx>=0.27.0
30
+ Requires-Dist: jinja2>=3.1.0
31
+ Requires-Dist: python-nmap>=0.7.1
32
+ Requires-Dist: rich>=13.7.0
33
+ Provides-Extra: dev
34
+ Requires-Dist: mypy>=1.8.0; extra == 'dev'
35
+ Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
36
+ Requires-Dist: pytest-httpserver>=1.0.0; extra == 'dev'
37
+ Requires-Dist: pytest>=8.0.0; extra == 'dev'
38
+ Requires-Dist: ruff>=0.2.0; extra == 'dev'
39
+ Description-Content-Type: text/markdown
40
+
41
+ <div align="center">
42
+
43
+ <img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/wordmark.svg" alt="Inspectra wordmark" width="560"/>
44
+
45
+ </div>
46
+
47
+ One command, passive security assessment for authorized targets — and nothing more.
48
+
49
+ **What it does:** scans a target you own or are authorized to test; runs DNS, TLS, HTTP, headers, robots, directories, ports, and fingerprint checks; scores posture and emits JSON/Markdown/HTML/SARIF reports.
50
+
51
+ **What it does NOT do:** it is not an offensive tool, brute-forcer, or vulnerability database. It assesses what a target willingly exposes and explains what that means. No exploitation code anywhere in the codebase.
52
+
53
+ **Safe by design:** GET-only requests, timeouts everywhere, rate-limited opt-in directory checks, first-run authorization gate (`--authorized`), and private-IP blocking unless explicitly allowed (`--allow-private`).
54
+
55
+ ---
56
+
57
+ [![CI](https://img.shields.io/badge/CI-github--actions-blue?logo=github-actions)](.github/workflows/ci.yml)
58
+ [![Python](https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white)](pyproject.toml)
59
+ [![License: MIT](https://img.shields.io/badge/license-MIT-green?logo=opensource&logoColor=white)](LICENSE)
60
+ [![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-261230?logo=ruff&logoColor=white)](pyproject.toml)
61
+ [![Types: mypy strict](https://img.shields.io/badge/types-mypy--strict-blue?logo=python&logoColor=white)](pyproject.toml)
62
+ [![Coverage: 80%+](https://img.shields.io/badge/coverage-80%25+-green)](pyproject.toml)
63
+ [![Live Sample Report](https://img.shields.io/badge/sample%20report-GitHub%20Pages-blue)](https://shashu123456.github.io/Inspectra/)
64
+
65
+ ---
66
+
67
+ ## Terminal demo
68
+
69
+ <img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/terminal-demo.svg" alt="Inspectra CLI terminal demo" width="100%"/>
70
+
71
+ *Real output from `inspectra scan` against the committed replay fixtures — not a mockup.*
72
+
73
+ ---
74
+
75
+ ## Quick start
76
+
77
+ ```bash
78
+ # 1. Install
79
+ pip install -e ".[dev]"
80
+
81
+ # 2. Scan an authorized target (first run shows the authorization agreement)
82
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format html
83
+
84
+ # 3. Open the self-contained HTML report
85
+ start inspectra-report/report.html # Windows
86
+ # open inspectra-report/report.html # macOS/Linux
87
+ ```
88
+
89
+ Reports land in `./inspectra-report/` (`report.json` always, plus your chosen format).
90
+
91
+ ---
92
+
93
+ ## Output formats
94
+
95
+ | Format | Description |
96
+ |--------|-------------|
97
+ | **JSON** | Always written. Machine-readable, stable schema, timezone-safe timestamps. |
98
+ | **Markdown** | Default human-readable format: severity headers, summary table, posture score. |
99
+ | **HTML** | Self-contained, polished report with inline CSS — no external assets. |
100
+ | **SARIF** | SARIF 2.1.0 for CI pipelines (GitHub Code Scanning compatible). |
101
+
102
+ ```bash
103
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format sarif -o report.sarif
104
+ ```
105
+
106
+ ---
107
+
108
+ ## GitHub Action
109
+
110
+ Run Inspectra in CI and fail on new findings:
111
+
112
+ ```yaml
113
+ name: inspectra
114
+ on: [push, pull_request]
115
+ jobs:
116
+ scan:
117
+ runs-on: ubuntu-latest
118
+ steps:
119
+ - uses: actions/checkout@v4
120
+ - uses: actions/setup-python@v5
121
+ with: { python-version: "3.11" }
122
+ - run: pip install -e ".[dev]"
123
+ - run: |
124
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
125
+ --format sarif -o inspectra.sarif
126
+ - uses: github/codeql-action/upload-sarif@v3
127
+ with: { sarif_file: inspectra.sarif }
128
+ ```
129
+
130
+ ---
131
+
132
+ ## Baseline diff (fail on new)
133
+
134
+ Save a baseline, then compare future scans against it — `--fail-on` exits non-zero only when new findings appear:
135
+
136
+ ```bash
137
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
138
+ --save-baseline baseline.json
139
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
140
+ --baseline baseline.json --fail-on new
141
+ ```
142
+
143
+ ---
144
+
145
+ ## Safety model
146
+
147
+ - Private-IP blocking: private/loopback/link-local/CGNAT addresses are rejected unless `--allow-private --authorized` is both present.
148
+ - SSRF safety: DNS resolved once, IP pinned per connection, per-redirect-hop re-validation, HTTPS→HTTP downgrade rejected, metadata endpoints blocked (`src/inspectra/safety.py`).
149
+ - Redaction: secrets, JWTs, and header values redacted before any report serializes (`--no-redact` to disable, with a warning).
150
+ - Evidence integrity: every finding carries an `evidence_hash`; replayed scans are deterministic and report skipped raw-socket checks (`dns`, `ports`, `tls`).
151
+
152
+ See [docs/safety.md](docs/safety.md) and [THREAT_MODEL.md](THREAT_MODEL.md).
153
+
154
+ ---
155
+
156
+ ## Benchmark
157
+
158
+ Measured on committed replay fixtures (no network — report assembly only, not network politeness or real-target wall time):
159
+
160
+ | Mode | Runs | Avg wall (s) | Findings | Identical? | False positives |
161
+ |------|------|--------------|----------|------------|-----------------|
162
+ | Serial (`--concurrency 1 --delay 0`) | 5 | 0.103 | 9 | yes | 0 |
163
+ | Concurrent (`--concurrency 8 --delay 0`) | 5 | 0.023 | 9 | yes | 0 |
164
+
165
+ Concurrency changes timing, not findings — the same rule-ID set is produced at `--concurrency 1` and `--concurrency 8`. See [docs/benchmark.md](docs/benchmark.md).
166
+
167
+ ---
168
+
169
+ ## What it does not do
170
+
171
+ - No exploitation, payload delivery, or post-exploitation.
172
+ - No authentication bypass, credential cracking, or fuzzing.
173
+ - No vulnerability chaining or active attack simulation.
174
+ - No scanning of targets you do not own or are not authorized to test.
175
+
176
+ ---
177
+
178
+ ## Contributing
179
+
180
+ Contributions are welcome. The founding rule: **inspect, observe, assess, explain, report — never exploit.** Any contribution adding exploitation, brute-forcing, or payload delivery is declined.
181
+
182
+ See [CONTRIBUTING.md](CONTRIBUTING.md) for how to add a check.
183
+
184
+ ---
185
+
186
+ ## License
187
+
188
+ [MIT](LICENSE) — © 2026 Inspectra contributors.
189
+
190
+ ---
191
+
192
+ ## Docs & footer
193
+
194
+ - [Usage](docs/usage.md) — CLI reference, options, examples
195
+ - [Safety](docs/safety.md) — ethics, legal guidance, authorized-use checklist
196
+ - [Roadmap](docs/roadmap.md) — release history and future direction
197
+ - [Benchmark](docs/benchmark.md) — serial vs concurrent measurement
198
+ - [Threat Model](THREAT_MODEL.md) — SSRF, rebinding, authorization, redaction, evidence integrity
199
+ - [CHANGELOG.md](CHANGELOG.md) — notable changes per release
200
+
201
+ Replay covers HTTP-based checks. Raw-socket checks (DNS, ports, TLS handshake) are skipped because they cannot be served from fixtures.
@@ -0,0 +1,161 @@
1
+ <div align="center">
2
+
3
+ <img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/wordmark.svg" alt="Inspectra wordmark" width="560"/>
4
+
5
+ </div>
6
+
7
+ One command, passive security assessment for authorized targets — and nothing more.
8
+
9
+ **What it does:** scans a target you own or are authorized to test; runs DNS, TLS, HTTP, headers, robots, directories, ports, and fingerprint checks; scores posture and emits JSON/Markdown/HTML/SARIF reports.
10
+
11
+ **What it does NOT do:** it is not an offensive tool, brute-forcer, or vulnerability database. It assesses what a target willingly exposes and explains what that means. No exploitation code anywhere in the codebase.
12
+
13
+ **Safe by design:** GET-only requests, timeouts everywhere, rate-limited opt-in directory checks, first-run authorization gate (`--authorized`), and private-IP blocking unless explicitly allowed (`--allow-private`).
14
+
15
+ ---
16
+
17
+ [![CI](https://img.shields.io/badge/CI-github--actions-blue?logo=github-actions)](.github/workflows/ci.yml)
18
+ [![Python](https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white)](pyproject.toml)
19
+ [![License: MIT](https://img.shields.io/badge/license-MIT-green?logo=opensource&logoColor=white)](LICENSE)
20
+ [![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-261230?logo=ruff&logoColor=white)](pyproject.toml)
21
+ [![Types: mypy strict](https://img.shields.io/badge/types-mypy--strict-blue?logo=python&logoColor=white)](pyproject.toml)
22
+ [![Coverage: 80%+](https://img.shields.io/badge/coverage-80%25+-green)](pyproject.toml)
23
+ [![Live Sample Report](https://img.shields.io/badge/sample%20report-GitHub%20Pages-blue)](https://shashu123456.github.io/Inspectra/)
24
+
25
+ ---
26
+
27
+ ## Terminal demo
28
+
29
+ <img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/terminal-demo.svg" alt="Inspectra CLI terminal demo" width="100%"/>
30
+
31
+ *Real output from `inspectra scan` against the committed replay fixtures — not a mockup.*
32
+
33
+ ---
34
+
35
+ ## Quick start
36
+
37
+ ```bash
38
+ # 1. Install
39
+ pip install -e ".[dev]"
40
+
41
+ # 2. Scan an authorized target (first run shows the authorization agreement)
42
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format html
43
+
44
+ # 3. Open the self-contained HTML report
45
+ start inspectra-report/report.html # Windows
46
+ # open inspectra-report/report.html # macOS/Linux
47
+ ```
48
+
49
+ Reports land in `./inspectra-report/` (`report.json` always, plus your chosen format).
50
+
51
+ ---
52
+
53
+ ## Output formats
54
+
55
+ | Format | Description |
56
+ |--------|-------------|
57
+ | **JSON** | Always written. Machine-readable, stable schema, timezone-safe timestamps. |
58
+ | **Markdown** | Default human-readable format: severity headers, summary table, posture score. |
59
+ | **HTML** | Self-contained, polished report with inline CSS — no external assets. |
60
+ | **SARIF** | SARIF 2.1.0 for CI pipelines (GitHub Code Scanning compatible). |
61
+
62
+ ```bash
63
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format sarif -o report.sarif
64
+ ```
65
+
66
+ ---
67
+
68
+ ## GitHub Action
69
+
70
+ Run Inspectra in CI and fail on new findings:
71
+
72
+ ```yaml
73
+ name: inspectra
74
+ on: [push, pull_request]
75
+ jobs:
76
+ scan:
77
+ runs-on: ubuntu-latest
78
+ steps:
79
+ - uses: actions/checkout@v4
80
+ - uses: actions/setup-python@v5
81
+ with: { python-version: "3.11" }
82
+ - run: pip install -e ".[dev]"
83
+ - run: |
84
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
85
+ --format sarif -o inspectra.sarif
86
+ - uses: github/codeql-action/upload-sarif@v3
87
+ with: { sarif_file: inspectra.sarif }
88
+ ```
89
+
90
+ ---
91
+
92
+ ## Baseline diff (fail on new)
93
+
94
+ Save a baseline, then compare future scans against it — `--fail-on` exits non-zero only when new findings appear:
95
+
96
+ ```bash
97
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
98
+ --save-baseline baseline.json
99
+ inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
100
+ --baseline baseline.json --fail-on new
101
+ ```
102
+
103
+ ---
104
+
105
+ ## Safety model
106
+
107
+ - Private-IP blocking: private/loopback/link-local/CGNAT addresses are rejected unless `--allow-private --authorized` is both present.
108
+ - SSRF safety: DNS resolved once, IP pinned per connection, per-redirect-hop re-validation, HTTPS→HTTP downgrade rejected, metadata endpoints blocked (`src/inspectra/safety.py`).
109
+ - Redaction: secrets, JWTs, and header values redacted before any report serializes (`--no-redact` to disable, with a warning).
110
+ - Evidence integrity: every finding carries an `evidence_hash`; replayed scans are deterministic and report skipped raw-socket checks (`dns`, `ports`, `tls`).
111
+
112
+ See [docs/safety.md](docs/safety.md) and [THREAT_MODEL.md](THREAT_MODEL.md).
113
+
114
+ ---
115
+
116
+ ## Benchmark
117
+
118
+ Measured on committed replay fixtures (no network — report assembly only, not network politeness or real-target wall time):
119
+
120
+ | Mode | Runs | Avg wall (s) | Findings | Identical? | False positives |
121
+ |------|------|--------------|----------|------------|-----------------|
122
+ | Serial (`--concurrency 1 --delay 0`) | 5 | 0.103 | 9 | yes | 0 |
123
+ | Concurrent (`--concurrency 8 --delay 0`) | 5 | 0.023 | 9 | yes | 0 |
124
+
125
+ Concurrency changes timing, not findings — the same rule-ID set is produced at `--concurrency 1` and `--concurrency 8`. See [docs/benchmark.md](docs/benchmark.md).
126
+
127
+ ---
128
+
129
+ ## What it does not do
130
+
131
+ - No exploitation, payload delivery, or post-exploitation.
132
+ - No authentication bypass, credential cracking, or fuzzing.
133
+ - No vulnerability chaining or active attack simulation.
134
+ - No scanning of targets you do not own or are not authorized to test.
135
+
136
+ ---
137
+
138
+ ## Contributing
139
+
140
+ Contributions are welcome. The founding rule: **inspect, observe, assess, explain, report — never exploit.** Any contribution adding exploitation, brute-forcing, or payload delivery is declined.
141
+
142
+ See [CONTRIBUTING.md](CONTRIBUTING.md) for how to add a check.
143
+
144
+ ---
145
+
146
+ ## License
147
+
148
+ [MIT](LICENSE) — © 2026 Inspectra contributors.
149
+
150
+ ---
151
+
152
+ ## Docs & footer
153
+
154
+ - [Usage](docs/usage.md) — CLI reference, options, examples
155
+ - [Safety](docs/safety.md) — ethics, legal guidance, authorized-use checklist
156
+ - [Roadmap](docs/roadmap.md) — release history and future direction
157
+ - [Benchmark](docs/benchmark.md) — serial vs concurrent measurement
158
+ - [Threat Model](THREAT_MODEL.md) — SSRF, rebinding, authorization, redaction, evidence integrity
159
+ - [CHANGELOG.md](CHANGELOG.md) — notable changes per release
160
+
161
+ Replay covers HTTP-based checks. Raw-socket checks (DNS, ports, TLS handshake) are skipped because they cannot be served from fixtures.
@@ -1,4 +1,4 @@
1
- # EcoMind Inspectra v2.0.0
1
+ # Inspectra v2.0.0
2
2
 
3
3
  ## What's New
4
4