local-triage 0.0.0-stage → 0.10.0-dev.32

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 (223) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +90 -2
  3. package/THIRD-PARTY-NOTICES.md +48 -0
  4. package/app/__init__.py +3 -0
  5. package/app/affiliation.py +137 -0
  6. package/app/ask.py +300 -0
  7. package/app/build_info.py +98 -0
  8. package/app/capec.py +168 -0
  9. package/app/capec_view.py +27 -0
  10. package/app/codecmp.py +59 -0
  11. package/app/config.py +411 -0
  12. package/app/context.py +1451 -0
  13. package/app/cvss.py +357 -0
  14. package/app/db.py +6234 -0
  15. package/app/defect.py +670 -0
  16. package/app/defect_check.py +323 -0
  17. package/app/defect_drafts.py +612 -0
  18. package/app/defect_dto.py +149 -0
  19. package/app/defect_fields.py +248 -0
  20. package/app/defect_form.py +124 -0
  21. package/app/defect_links.py +107 -0
  22. package/app/defect_local_text.py +103 -0
  23. package/app/defect_references.py +164 -0
  24. package/app/defect_where.py +147 -0
  25. package/app/ecosystem.py +51 -0
  26. package/app/executors.py +660 -0
  27. package/app/feeds.py +1231 -0
  28. package/app/guard.py +164 -0
  29. package/app/hub_block_builder.py +200 -0
  30. package/app/hub_block_version.py +220 -0
  31. package/app/hub_defects.py +4469 -0
  32. package/app/hub_effects.py +421 -0
  33. package/app/hub_entity_versions.py +108 -0
  34. package/app/hub_import.py +2054 -0
  35. package/app/hub_onboarding.py +114 -0
  36. package/app/hub_ops.py +330 -0
  37. package/app/hub_pull.py +1195 -0
  38. package/app/hub_state.py +255 -0
  39. package/app/hub_status.py +237 -0
  40. package/app/hub_sync.py +619 -0
  41. package/app/hub_sync_api.py +241 -0
  42. package/app/hub_sync_compare.py +1054 -0
  43. package/app/hub_sync_contract.py +75 -0
  44. package/app/hub_template_model.py +74 -0
  45. package/app/hub_text_scale.py +159 -0
  46. package/app/journal.py +250 -0
  47. package/app/llm.py +850 -0
  48. package/app/llm_chat.py +596 -0
  49. package/app/llm_http.py +319 -0
  50. package/app/llm_messages.py +401 -0
  51. package/app/llm_net.py +764 -0
  52. package/app/llm_ollama.py +571 -0
  53. package/app/lockfile.py +505 -0
  54. package/app/logsafe.py +54 -0
  55. package/app/main.py +367 -0
  56. package/app/mask_display.py +132 -0
  57. package/app/masking.py +814 -0
  58. package/app/metrics.py +194 -0
  59. package/app/model_traffic.py +519 -0
  60. package/app/models.py +483 -0
  61. package/app/navigation.py +121 -0
  62. package/app/osv.py +279 -0
  63. package/app/package_identity.py +189 -0
  64. package/app/package_transition.py +824 -0
  65. package/app/profile_gate.py +71 -0
  66. package/app/prompts.py +1108 -0
  67. package/app/provider_keys.py +189 -0
  68. package/app/providers.py +511 -0
  69. package/app/routes/__init__.py +10 -0
  70. package/app/routes/api.py +153 -0
  71. package/app/routes/capec.py +186 -0
  72. package/app/routes/common.py +407 -0
  73. package/app/routes/components.py +1499 -0
  74. package/app/routes/cwe.py +168 -0
  75. package/app/routes/decision_selected.py +153 -0
  76. package/app/routes/defect_add.py +223 -0
  77. package/app/routes/defect_card_routes.py +363 -0
  78. package/app/routes/defect_selected.py +342 -0
  79. package/app/routes/feeds.py +155 -0
  80. package/app/routes/findings.py +2736 -0
  81. package/app/routes/hub.py +402 -0
  82. package/app/routes/hub_bulk.py +288 -0
  83. package/app/routes/hub_defect_routes.py +1945 -0
  84. package/app/routes/hub_status_routes.py +1132 -0
  85. package/app/routes/hub_sync_routes.py +463 -0
  86. package/app/routes/journal.py +132 -0
  87. package/app/routes/projects.py +1601 -0
  88. package/app/routes/providers.py +336 -0
  89. package/app/routes/references.py +26 -0
  90. package/app/routes/runs.py +219 -0
  91. package/app/routes/sca.py +2722 -0
  92. package/app/routes/settings.py +163 -0
  93. package/app/run_errors.py +151 -0
  94. package/app/sca.py +1662 -0
  95. package/app/sca_contract.py +1289 -0
  96. package/app/sca_research.py +1089 -0
  97. package/app/sca_research_net.py +1007 -0
  98. package/app/sca_text.py +965 -0
  99. package/app/serve.py +70 -0
  100. package/app/settings_store.py +262 -0
  101. package/app/static/app.css +2802 -0
  102. package/app/static/app.js +3772 -0
  103. package/app/static/capec-license.txt +9 -0
  104. package/app/static/favicon.svg +1 -0
  105. package/app/static/fonts/Golos-Text_DemiBold.woff2 +0 -0
  106. package/app/static/fonts/Golos-Text_Regular.woff2 +0 -0
  107. package/app/static/fonts/OFL.txt +90 -0
  108. package/app/static/navigation.js +234 -0
  109. package/app/static/observability.js +121 -0
  110. package/app/static/theme.js +49 -0
  111. package/app/storage/__init__.py +16 -0
  112. package/app/storage/local_state.py +246 -0
  113. package/app/storage/migrate.py +110 -0
  114. package/app/storage/migrations/postgresql/0001_baseline.sql +896 -0
  115. package/app/storage/migrations/postgresql/0002_feeds_and_secrets.sql +55 -0
  116. package/app/storage/migrations/postgresql/0003_project_mask_display.sql +5 -0
  117. package/app/storage/migrations/postgresql/0004_package_identity.sql +36 -0
  118. package/app/storage/postgresql.py +573 -0
  119. package/app/storage/schema.py +619 -0
  120. package/app/storage/sql.py +57 -0
  121. package/app/storage/tools.py +254 -0
  122. package/app/telemetry.py +307 -0
  123. package/app/templates/base.html +91 -0
  124. package/app/templates/capec/context.html +3 -0
  125. package/app/templates/capec/detail.html +27 -0
  126. package/app/templates/capec/index.html +128 -0
  127. package/app/templates/components/_archive.html +11 -0
  128. package/app/templates/components/archived.html +19 -0
  129. package/app/templates/components/batch.html +35 -0
  130. package/app/templates/components/detail.html +332 -0
  131. package/app/templates/components/index.html +338 -0
  132. package/app/templates/components/research_preview.html +80 -0
  133. package/app/templates/components/research_run.html +54 -0
  134. package/app/templates/cwe/bdu.html +56 -0
  135. package/app/templates/cwe/detail.html +233 -0
  136. package/app/templates/cwe/index.html +97 -0
  137. package/app/templates/error.html +8 -0
  138. package/app/templates/feeds/index.html +65 -0
  139. package/app/templates/findings/card.html +639 -0
  140. package/app/templates/findings/decision_selected.html +41 -0
  141. package/app/templates/findings/defect_add.html +46 -0
  142. package/app/templates/findings/defect_selected.html +47 -0
  143. package/app/templates/findings/list.html +153 -0
  144. package/app/templates/findings/send_selected.html +53 -0
  145. package/app/templates/findings/trace.html +72 -0
  146. package/app/templates/journal/detail.html +19 -0
  147. package/app/templates/journal/index.html +19 -0
  148. package/app/templates/macros.html +440 -0
  149. package/app/templates/navigation-fields.html +1 -0
  150. package/app/templates/navigation.html +11 -0
  151. package/app/templates/projects/_identity_summary.html +42 -0
  152. package/app/templates/projects/defect_card.html +153 -0
  153. package/app/templates/projects/defect_create_preview.html +17 -0
  154. package/app/templates/projects/defect_fields_diff.html +6 -0
  155. package/app/templates/projects/defect_fields_form.html +40 -0
  156. package/app/templates/projects/defect_references.html +17 -0
  157. package/app/templates/projects/defect_sync_preview.html +28 -0
  158. package/app/templates/projects/defect_update_actions.html +6 -0
  159. package/app/templates/projects/defect_update_preview.html +24 -0
  160. package/app/templates/projects/defects.html +126 -0
  161. package/app/templates/projects/delete.html +31 -0
  162. package/app/templates/projects/external.html +61 -0
  163. package/app/templates/projects/folders.html +64 -0
  164. package/app/templates/projects/hub_accepted.html +10 -0
  165. package/app/templates/projects/hub_assignment.html +50 -0
  166. package/app/templates/projects/hub_pending.html +20 -0
  167. package/app/templates/projects/hub_pending_list.html +17 -0
  168. package/app/templates/projects/hub_state_note.html +23 -0
  169. package/app/templates/projects/hub_step_note.html +5 -0
  170. package/app/templates/projects/hub_sync.html +105 -0
  171. package/app/templates/projects/hub_sync_confirm.html +32 -0
  172. package/app/templates/projects/hub_sync_worker.html +5 -0
  173. package/app/templates/projects/hub_text_rules.html +64 -0
  174. package/app/templates/projects/identity_report.html +74 -0
  175. package/app/templates/projects/list.html +90 -0
  176. package/app/templates/projects/project.html +433 -0
  177. package/app/templates/reference-missing.html +14 -0
  178. package/app/templates/runs/run.html +166 -0
  179. package/app/templates/sca/card.html +476 -0
  180. package/app/templates/sca/index.html +321 -0
  181. package/app/templates/settings/hub_url.html +31 -0
  182. package/app/templates/settings/index.html +216 -0
  183. package/app/templates/settings/provider.html +229 -0
  184. package/app/templates/settings/providers.html +37 -0
  185. package/app/templates/worklists.html +52 -0
  186. package/app/textsafe.py +117 -0
  187. package/app/timing.py +245 -0
  188. package/app/triage.py +1743 -0
  189. package/app/view.py +430 -0
  190. package/app/worklists.py +204 -0
  191. package/examples/demo/demo-hub-report-v2.xlsx +0 -0
  192. package/examples/demo/demo-hub-report.xlsx +0 -0
  193. package/examples/demo/repos/billing-core/pom.xml +30 -0
  194. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/Invoice.java +9 -0
  195. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceRepository.java +51 -0
  196. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceStatus.java +11 -0
  197. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/config/DatabaseSettings.java +18 -0
  198. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/payment/PaymentTokenService.java +35 -0
  199. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/web/InvoiceExportController.java +57 -0
  200. package/examples/demo/repos/catalog-api/catalog_api/__init__.py +1 -0
  201. package/examples/demo/repos/catalog-api/catalog_api/products.py +24 -0
  202. package/examples/demo/repos/catalog-api/catalog_api/tasks.py +24 -0
  203. package/examples/demo/repos/catalog-api/catalog_api/views.py +17 -0
  204. package/examples/demo/repos/catalog-api/requirements.txt +3 -0
  205. package/npm/build.json +5 -0
  206. package/npm/cli.js +346 -0
  207. package/npm/files.manifest +224 -0
  208. package/npm/lib/binding.js +64 -0
  209. package/npm/lib/cluster.js +330 -0
  210. package/npm/lib/env.js +88 -0
  211. package/npm/lib/fsx.js +125 -0
  212. package/npm/lib/http.js +53 -0
  213. package/npm/lib/metrics.js +73 -0
  214. package/npm/lib/paths.js +150 -0
  215. package/npm/lib/pg.js +351 -0
  216. package/npm/lib/proc.js +101 -0
  217. package/npm/lib/python.js +133 -0
  218. package/npm/lib/stand.js +46 -0
  219. package/npm/lib/supervisor.js +1141 -0
  220. package/npm/lib/version.js +21 -0
  221. package/npm/requirements.txt +476 -0
  222. package/npm-shrinkwrap.json +111 -0
  223. package/package.json +37 -4
package/app/cvss.py ADDED
@@ -0,0 +1,357 @@
1
+ """Оценка CVSS: версия, диапазоны, отбор и сортировка для таблицы SCA.
2
+
3
+ Модуль чистый: ни базы, ни запросов, ни шаблонов. Разбирает сохранённые сведения об оценке (балл и прочие
4
+ колонки выгрузки в пакете от app/db.py) и работает со списком пакетов, который собирает app/sca.py.
5
+
6
+ Версия оценки отдельным полем не хранится: у находки есть только балл (Finding.cvss, app/models.py) и
7
+ прочие колонки выгрузки (Finding.extra). Поэтому версия определяется только по тому, что действительно есть
8
+ в этих данных: по вектору оценки («CVSS:3.1/AV:N/AC:L/...», у второй версии вектор идёт без префикса) и по
9
+ отдельной колонке, где версия записана своим значением («CVSS version», «Версия CVSS»). Вектор принимается
10
+ только целиком корректный, а из колонки берётся только значение, целиком равное версии: «3.1» – версия
11
+ оценки, «3.1.5» – версия компонента, а не оценки. Если указания противоречат друг другу или ничего похожего
12
+ нет, версия неизвестна: объявлять 3.1 там, где её нет, нельзя, и пересчитывать 3.1 в 4.0 тоже – метрики
13
+ разных версий считаются по-разным правилам, молчаливая подмена искажает балл. Распознаются 2.0, 3.0, 3.1
14
+ и 4.0; появление новой версии потребует описать её здесь (VERSIONS, _METRICS, _EXTRA) и в списке выбора.
15
+ """
16
+
17
+ from __future__ import annotations
18
+
19
+ import math
20
+ import re
21
+ from typing import Any, Iterable, Mapping
22
+
23
+ UNKNOWN = "" # версия оценки не указана (ключ в сохранённых данных)
24
+ UNKNOWN_CHOICE = "?" # значение параметра cvss_version для отбора «только оценки без версии»
25
+ # Порядок для показа и разбора: 3.1 – основная версия пользователя, дальше остальные известные; в выпадающем
26
+ # списке и в разборе баллов пакета оценки идут именно в таком порядке
27
+ VERSIONS = ("3.1", "3.0", "4.0", "2.0")
28
+ VERSION_LABELS = {UNKNOWN: "версия не указана", UNKNOWN_CHOICE: "версия не указана", "3.1": "CVSS 3.1",
29
+ "3.0": "CVSS 3.0", "4.0": "CVSS 4.0", "2.0": "CVSS 2.0"}
30
+ CHOICES = (*VERSIONS, UNKNOWN_CHOICE) # значения параметра cvss_version; "" – все версии вместе
31
+ SORTS = ("cvss_asc", "cvss_desc")
32
+ SORT_LABELS = {UNKNOWN: "как в отчёте", "cvss_asc": "CVSS: по возрастанию", "cvss_desc": "CVSS: по убыванию"}
33
+ EPS = 1e-9 # балл CVSS – число с одним знаком: сравниваем с допуском, чтобы 3,9 не уехало за границу
34
+
35
+ # Базовые метрики версии и их допустимые значения (FIRST: спецификации 3.1, 4.0 и второй версии). Имя метрики
36
+ # сравнивается без учёта регистра, значение – в верхнем регистре
37
+ _METRICS: dict[str, dict[str, tuple[str, ...]]] = {
38
+ "2.0": {"AV": ("N", "A", "L"), "AC": ("H", "M", "L"), "AU": ("M", "S", "N"),
39
+ "C": ("N", "P", "C"), "I": ("N", "P", "C"), "A": ("N", "P", "C")},
40
+ "3.1": {"AV": ("N", "A", "L", "P"), "AC": ("L", "H"), "PR": ("N", "L", "H"), "UI": ("N", "R"),
41
+ "S": ("U", "C"), "C": ("H", "L", "N"), "I": ("H", "L", "N"), "A": ("H", "L", "N")},
42
+ "4.0": {"AV": ("N", "A", "L", "P"), "AC": ("L", "H"), "AT": ("N", "P"), "PR": ("N", "L", "H"),
43
+ "UI": ("N", "P", "A"), "VC": ("H", "L", "N"), "VI": ("H", "L", "N"), "VA": ("H", "L", "N"),
44
+ "SC": ("H", "L", "N"), "SI": ("H", "L", "N"), "SA": ("H", "L", "N")},
45
+ }
46
+ _METRICS["3.0"] = _METRICS["3.1"] # имена и значения метрик у 3.0 и 3.1 совпадают
47
+ # Дополнительные метрики тоже проверяются по значениям. Это распознавание формата, не расчёт балла.
48
+ # Источники: FIRST CVSS 2, раздел 2.4; CVSS 3.1, раздел 6; CVSS 4.0, раздел 7.
49
+ # https://www.first.org/cvss/v2/guide
50
+ # https://www.first.org/cvss/v3-1/specification-document
51
+ # https://www.first.org/cvss/v4.0/specification-document
52
+ _EXTRA: dict[str, dict[str, tuple[str, ...]]] = {
53
+ "2.0": {
54
+ "E": ("ND", "U", "POC", "F", "H"), "RL": ("ND", "OF", "TF", "W", "U"),
55
+ "RC": ("ND", "UC", "UR", "C"), "CDP": ("ND", "N", "L", "LM", "MH", "H"),
56
+ "TD": ("ND", "N", "L", "M", "H"), "CR": ("ND", "L", "M", "H"),
57
+ "IR": ("ND", "L", "M", "H"), "AR": ("ND", "L", "M", "H"),
58
+ },
59
+ "3.1": {
60
+ "E": tuple("XUPFH"), "RL": tuple("XOTWU"), "RC": tuple("XURC"),
61
+ "CR": tuple("XLMH"), "IR": tuple("XLMH"), "AR": tuple("XLMH"),
62
+ "MAV": tuple("XNALP"), "MAC": tuple("XLH"), "MPR": tuple("XNLH"), "MUI": tuple("XNR"),
63
+ "MS": tuple("XUC"), "MC": tuple("XNLH"), "MI": tuple("XNLH"), "MA": tuple("XNLH"),
64
+ },
65
+ "4.0": {
66
+ "E": tuple("XAPU"), "CR": tuple("XHML"), "IR": tuple("XHML"), "AR": tuple("XHML"),
67
+ "MAV": tuple("XNALP"), "MAC": tuple("XLH"), "MAT": tuple("XNP"), "MPR": tuple("XNLH"),
68
+ "MUI": tuple("XNPA"), "MVC": tuple("XNLH"), "MVI": tuple("XNLH"), "MVA": tuple("XNLH"),
69
+ "MSC": tuple("XNLH"), "MSI": tuple("XNLHS"), "MSA": tuple("XNLHS"),
70
+ "S": tuple("XNP"), "AU": tuple("XNY"), "R": tuple("XAUI"), "V": tuple("XDC"),
71
+ "RE": tuple("XLMH"), "U": ("X", "CLEAR", "GREEN", "AMBER", "RED"),
72
+ },
73
+ }
74
+ _EXTRA["3.0"] = _EXTRA["3.1"]
75
+ # Вектор с префиксом версии: «CVSS:3.1/AV:N/…», «CVSS:4.0/AT:N/…»
76
+ _VECTOR = re.compile(r"^\s*CVSS\s*:\s*v?([234][.][0-9])\s*/", re.IGNORECASE)
77
+ # Одна метрика вектора: «AV:N»
78
+ _METRIC = re.compile(r"^([A-Za-z]{1,3})\s*:\s*([A-Za-z0-9]{1,5})$")
79
+ # Заголовок колонки, где версия оценки записана своим значением: «CVSS version», «Версия CVSS», «CVSS»
80
+ _HEAD_VERSION = re.compile(r"верси|version", re.IGNORECASE)
81
+ _HEAD_CVSS = re.compile(r"cvss", re.IGNORECASE)
82
+ # Чужая версия: версия компонента, библиотеки, пакета и тому подобного – это не версия оценки
83
+ _HEAD_SUBJECT = re.compile(r"компонент|component|библиотек|библиотека|library|пакет|package|модул|module|"
84
+ r"зависимост|dependency|плагин|plugin|приложен|application|сервис|service",
85
+ re.IGNORECASE)
86
+ # Значение, целиком равное версии: «3.1», «v4.0», «CVSS 3.0». Без десятых («3») не берём: 3.0 и 3.1 –
87
+ # разные шкалы, а «3.1.5» – это уже версия компонента
88
+ _VERSION_TEXT = re.compile(r"(?:cvss[\s\-]*)?v?([234])[.](\d)", re.IGNORECASE)
89
+
90
+ # Диапазоны CVSS 3.x и 4.0 совпадают. У второй версии верхняя граница «высокого» – 10, а «критического» нет:
91
+ # пометка «Критический» у оценки 2.0 была бы баллом по чужой шкале
92
+ _BANDS = {
93
+ UNKNOWN: (("zero", "Нулевой", 0.0, 0.0), ("low", "Низкий", 0.1, 3.9), ("medium", "Средний", 4.0, 6.9),
94
+ ("high", "Высокий", 7.0, 8.9), ("critical", "Критический", 9.0, 10.0)),
95
+ UNKNOWN_CHOICE: (("zero", "Нулевой", 0.0, 0.0), ("low", "Низкий", 0.1, 3.9), ("medium", "Средний", 4.0, 6.9),
96
+ ("high", "Высокий", 7.0, 8.9), ("critical", "Критический", 9.0, 10.0)),
97
+ "2.0": (("low", "Низкий", 0.0, 3.9), ("medium", "Средний", 4.0, 6.9), ("high", "Высокий", 7.0, 10.0)),
98
+ }
99
+ _CASES = ("cvss", "cvss_min", "cvss_max", "cvss_version", "sort")
100
+
101
+
102
+ def _supported(value: str) -> str:
103
+ return value if value in VERSIONS else UNKNOWN
104
+
105
+
106
+ def _complete_vector(body: str, version: str) -> str:
107
+ """Версия, если тело вектора этой версии корректно: все базовые метрики на месте со своими значениями,
108
+ дополнительные допустимы, повторов и постороннего текста нет."""
109
+ metrics = _METRICS.get(version) or {}
110
+ extra = _EXTRA.get(version) or {}
111
+ seen: set[str] = set()
112
+ order = {name: i for i, name in enumerate((*metrics, *extra))}
113
+ previous = -1
114
+ for part in body.split("/"):
115
+ pair = _METRIC.match(part.strip())
116
+ if not pair:
117
+ return UNKNOWN
118
+ metric, value = pair.group(1).upper(), pair.group(2).upper()
119
+ if metric in seen:
120
+ return UNKNOWN # повтор метрики: вектор невалиден
121
+ seen.add(metric)
122
+ if value not in metrics.get(metric, extra.get(metric, ())):
123
+ return UNKNOWN
124
+ # В отличие от 3.x, CVSS 4.0 прямо запрещает другой порядок (FIRST, таблица 23).
125
+ if version == "4.0":
126
+ current = order[metric]
127
+ if current <= previous:
128
+ return UNKNOWN
129
+ previous = current
130
+ return version if seen.issuperset(metrics) else UNKNOWN
131
+
132
+
133
+ def _vector_version(text: str) -> str:
134
+ """Версия оценки из вектора – только из вектора, целиком соответствующего своей версии. Обрывок вроде
135
+ «CVSS:3.1garbage», вектор без обязательных метрик и вектор с чужим значением версией не считаются."""
136
+ match = _VECTOR.match(text)
137
+ if match:
138
+ version = _supported(match.group(1))
139
+ return _complete_vector(text[match.end():], version) if version else UNKNOWN
140
+ if text.startswith("(") and text.endswith(")"):
141
+ text = text[1:-1].strip() # распространённая обёртка вектора 2.0 в выгрузках
142
+ return _complete_vector(text, "2.0") # вектор второй версии идёт без префикса CVSS
143
+
144
+
145
+ def clean_version(text: Any) -> str:
146
+ """Версия оценки из текста, если значение целиком версия: «3.1», «v4.0», «CVSS 3.0». «3.1.5» – версия
147
+ компонента, а не оценки; без десятых («3») и несуществующие версии тоже не подходят."""
148
+ match = _VERSION_TEXT.fullmatch(str(text or "").strip())
149
+ return _supported(f"{match.group(1)}.{match.group(2)}") if match else UNKNOWN
150
+
151
+
152
+ def version_from_column(header: Any, value: Any) -> str:
153
+ """Версия только из явно обозначенной колонки CVSS. Голое «Version» и число в «CVSS»
154
+ неоднозначны: это может быть версия компонента или сам балл, поэтому их не используем."""
155
+ head = str(header or "")
156
+ text = str(value or "").strip()
157
+ if _HEAD_SUBJECT.search(head):
158
+ return UNKNOWN
159
+ if _HEAD_CVSS.search(head) and _HEAD_VERSION.search(head):
160
+ return clean_version(text)
161
+ if head.strip().casefold() == "cvss" and text.casefold().startswith("cvss"):
162
+ return clean_version(text) # «CVSS 3.1» явно обозначает версию, число 3.1 – нет
163
+ return UNKNOWN
164
+
165
+
166
+ def version_from_extra(extra: Mapping[str, Any] | None) -> str:
167
+ """Версия оценки по прочим колонкам выгрузки находки: вектор с префиксом версии, вектор второй версии
168
+ или колонка, где версия записана целиком. Порядок колонок в файле ничего не решает: если указания
169
+ противоречат друг другу (версия 3.1 в колонке и корректный вектор 4.0), версия остаётся неизвестной –
170
+ одному сохранённому баллу произвольную версию присваивать нельзя."""
171
+ pairs = [(str(head or ""), str(value or "").strip()) for head, value in (extra or {}).items()]
172
+ found = {version for _, text in pairs for version in (_vector_version(text),) if version}
173
+ found |= {version for head, text in pairs for version in (version_from_column(head, text),) if version}
174
+ return found.pop() if len(found) == 1 else UNKNOWN
175
+
176
+
177
+ def version_of(finding: Mapping[str, Any] | None) -> str:
178
+ """Версия оценки находки (её saved-сведения: extra с прочими колонками выгрузки)."""
179
+ return version_from_extra((finding or {}).get("extra"))
180
+
181
+
182
+ def number(value: float) -> str:
183
+ """Балл в виде подписи: 9.8 -> «9,8», 7.0 -> «7»."""
184
+ return f"{value:g}".replace(".", ",")
185
+
186
+
187
+ def bands(version: str = UNKNOWN) -> list[dict]:
188
+ """Готовые диапазоны для версии: у 2.0 своя разметка, у 3.x и 4.0 – общая. Подпись границ выводится из
189
+ самих границ диапазона, поэтому у второй версии «высокий» – это 7–10, а не 7–8,9 от другой шкалы."""
190
+ return [{"key": key, "label": label, "min": low, "max": high, "title": _band_title(low, high)}
191
+ for key, label, low, high in _BANDS.get(version, _BANDS[UNKNOWN])]
192
+
193
+
194
+ def _band_title(low: float, high: float) -> str:
195
+ return number(low) if low == high else f"{number(low)}–{number(high)}"
196
+
197
+
198
+ def version_title(version: str) -> str:
199
+ """Как подписать версию в подсказке ячейки балла: у известной – «CVSS 3.1», у неизвестной – честно, что
200
+ версия не указана; без выбора версии подписи нет вовсе (балл тогда наибольший из всех версий)."""
201
+ if not version:
202
+ return ""
203
+ return f"CVSS {version}" if version in VERSIONS else "без указания версии"
204
+
205
+
206
+ def presets(version: str = UNKNOWN) -> list[dict]:
207
+ """Готовые отборы: диапазоны версии, «строго больше 7» и «7 и выше» отдельно друг от друга, оценка
208
+ без балла. Пороги организационного правила (строго больше 7) и шкалы (7 и выше) не смешиваются."""
209
+ items = bands(version)
210
+ items.append({"key": "above7", "label": "Строго больше 7", "min": 7.0, "max": 10.0, "open_min": True,
211
+ "title": "больше 7"})
212
+ items.append({"key": "from7", "label": "7 и выше", "min": 7.0, "max": 10.0, "title": "7–10"})
213
+ items.append({"key": "no_score", "label": "Без оценки", "min": None, "max": None, "title": "оценки нет"})
214
+ return items
215
+
216
+
217
+ def preset(version: str, key: str) -> dict | None:
218
+ """Готовый отбор по ключу для версии; None – такого отбора для этой версии нет."""
219
+ for item in presets(version):
220
+ if item["key"] == key:
221
+ return item
222
+ return None
223
+
224
+
225
+ def matches(score: float | None, item: Mapping[str, Any]) -> bool:
226
+ """Балл попадает в отбор: «Без оценки» ловит только отсутствие балла, остальное – границы включительно,
227
+ кроме «строго больше 7», где нижняя граница открыта."""
228
+ if item.get("key") == "no_score":
229
+ return score is None
230
+ if score is None:
231
+ return False
232
+ if item.get("open_min"):
233
+ return score > float(item["min"]) + EPS and score <= float(item["max"]) + EPS
234
+ return float(item["min"]) - EPS <= score <= float(item["max"]) + EPS
235
+
236
+
237
+ def score_of(group: Mapping[str, Any], version: str = UNKNOWN) -> float | None:
238
+ """Балл пакета для выбранной версии: без выбора – наибольший из всех оценок пакета, с выбором – только
239
+ оценки этой версии (у UNKNOWN_CHOICE – оценки с неизвестной версией). Оценки других версий вместо неё не
240
+ подставляются, поэтому под выбранной версией пакет без оценок этой версии не показывается вовсе."""
241
+ scores = group.get("cvss_versions") or {}
242
+ if version:
243
+ return scores.get(UNKNOWN if version == UNKNOWN_CHOICE else version)
244
+ known = [value for value in scores.values() if value is not None]
245
+ return max(known) if known else None
246
+
247
+
248
+ def breakdown(group: Mapping[str, Any]) -> list[dict]:
249
+ """Разбор баллов пакета по версиям: [{version, label, score, count}], известные версии по порядку
250
+ VERSIONS, оценки с неизвестной версией – последними. Пустой список – баллов у пакета нет."""
251
+ counts = group.get("cvss_counts") or {}
252
+ items = [{"version": version, "label": VERSION_LABELS[version], "score": score,
253
+ "count": int(counts.get(version) or 0)}
254
+ for version, score in (group.get("cvss_versions") or {}).items()]
255
+ order = {version: i for i, version in enumerate((*VERSIONS, UNKNOWN))}
256
+ return sorted(items, key=lambda item: order.get(item["version"], len(order)))
257
+
258
+
259
+ def select(views: Iterable[Mapping[str, Any]], version: str = UNKNOWN,
260
+ item: Mapping[str, Any] | None = None) -> list[dict]:
261
+ """Отбор пакетов по баллу выбранной версии. Выбрана версия – отбор идёт по её баллу, и без отбора по баллу
262
+ остаются пакеты, у которых такая оценка есть; «Без оценки» под выбранной версией означает «нет оценки этой
263
+ версии». item – готовый отбор или свои границы, None – отбора по баллу нет."""
264
+ views = list(views)
265
+ if item is None:
266
+ return [view for view in views if score_of(view, version) is not None] if version else views
267
+ return [view for view in views if matches(score_of(view, version), item)]
268
+
269
+
270
+ def sort_views(views: Iterable[Mapping[str, Any]], version: str = UNKNOWN, sort: str = "") -> list[dict]:
271
+ """Числовая сортировка по баллу выбранной версии: пакеты без балла в конце, при равных баллах – по
272
+ названию. Пустой sort – порядок как в отчёте (срочные, затем по баллу, app/db.py)."""
273
+ views = list(views)
274
+ if sort not in SORTS:
275
+ return views
276
+ sign = 1.0 if sort == "cvss_asc" else -1.0
277
+ def key(view: Mapping[str, Any]) -> tuple:
278
+ score = score_of(view, version)
279
+ return (score is None, (score or 0.0) * sign, str(view.get("component") or "").casefold(),
280
+ str(view.get("version") or ""), str(view.get("ecosystem") or ""))
281
+ return sorted(views, key=key)
282
+
283
+
284
+ def bound(value: Any, name: str, label: str) -> tuple[float | None, str]:
285
+ """Граница диапазона из адреса страницы: число от 0 до 10, запятая как в русском Excel тоже; пусто –
286
+ границы нет. Второе значение – сообщение об ошибке, оно пустое, когда всё в порядке."""
287
+ text = str(value or "").strip().replace(",", ".")
288
+ if not text:
289
+ return None, ""
290
+ try:
291
+ score = float(text)
292
+ except ValueError:
293
+ return None, f"«{name}» – {label} должна быть числом от 0 до 10, получено «{text}»."
294
+ if not math.isfinite(score):
295
+ return None, f"«{name}» – {label} должна быть числом от 0 до 10."
296
+ if not 0.0 <= score <= 10.0:
297
+ return None, f"«{name}» – {label} должна быть от 0 до 10, получено {number(score)}."
298
+ if not math.isclose(score, round(score, 1), rel_tol=0, abs_tol=1e-12):
299
+ return None, f"«{name}» – {label} должна задаваться с шагом 0,1."
300
+ return round(score, 1), ""
301
+
302
+
303
+ def parse(params: Mapping[str, str]) -> dict:
304
+ """Разбор адреса страницы SCA: {"preset", "min", "max", "version", "sort", "active", "errors", "raw"}.
305
+ Неверное значение не превращается в молчаливый отбор: параметр отбрасывается, а в errors – что
306
+ показать человеку. Порядок разбора постоянный, поэтому список ошибок не зависит от порядка в адресе."""
307
+ errors: list[str] = []
308
+ raw = {name: str(params.get(name, "") or "").strip() for name in _CASES}
309
+ version = raw["cvss_version"]
310
+ if version and version not in CHOICES:
311
+ errors.append(f"Версия оценки «{version}» неизвестна – доступны: "
312
+ + ", ".join(VERSION_LABELS[v] for v in CHOICES) + ".")
313
+ version = UNKNOWN
314
+ item = None
315
+ preset_key = raw["cvss"]
316
+ if preset_key:
317
+ item = preset(version, preset_key)
318
+ if item is None:
319
+ known = preset(UNKNOWN, preset_key) # отбор, который есть в шкале 3.x и 4.0
320
+ if known:
321
+ errors.append(f"Отбор «{known['label']}» не применим к {VERSION_LABELS[version]} – у этой "
322
+ "версии такой шкалы нет.")
323
+ else:
324
+ errors.append(f"Отбор «{preset_key}» неизвестен – доступны: "
325
+ + ", ".join(band["label"] for band in presets(version)) + ".")
326
+ preset_key = UNKNOWN
327
+ low, low_error = bound(raw["cvss_min"], "cvss_min", "нижняя граница")
328
+ high, high_error = bound(raw["cvss_max"], "cvss_max", "верхняя граница")
329
+ errors.extend(error for error in (low_error, high_error) if error)
330
+ if low_error or high_error:
331
+ # половину неверного диапазона применять нельзя: обе границы и готовый отбор из той же формы
332
+ # отбрасываются, список показывается целиком, а что именно не так – в errors
333
+ low, high, item, preset_key = None, None, None, UNKNOWN
334
+ elif low is not None and high is not None and low > high:
335
+ errors.append(f"Нижняя граница {number(low)} больше верхней {number(high)} – такой отбор ничего "
336
+ "не найдёт.")
337
+ low, high, item, preset_key = None, None, None, UNKNOWN
338
+ sort = raw["sort"]
339
+ if sort and sort not in SORTS:
340
+ errors.append(f"Сортировка «{sort}» неизвестна – доступны: " + ", ".join(SORT_LABELS[s] for s in SORTS) + ".")
341
+ sort = UNKNOWN
342
+ return {"preset": preset_key, "item": item, "min": low, "max": high, "version": version, "sort": sort,
343
+ "active": bool(preset_key or low is not None or high is not None or version), "errors": errors,
344
+ "raw": raw}
345
+
346
+
347
+ def bounds_item(low: float | None, high: float | None) -> dict | None:
348
+ """Свои границы как обычный отбор; ни одной границы – отбора нет."""
349
+ if low is None and high is None:
350
+ return None
351
+ return {"key": "range", "min": 0.0 if low is None else low, "max": 10.0 if high is None else high}
352
+
353
+
354
+ def field_number(text: Any) -> str:
355
+ """Значение границы для поля формы: десятичная запятая меняется на точку. Поле типа number запятую не
356
+ показывает, и введённое значение пропало бы из формы молча, поэтому адрес и форма говорят одно и то же."""
357
+ return str(text or "").strip().replace(",", ".")