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
@@ -0,0 +1,2736 @@
1
+ """Раздел «Находки»: список с фильтрами и готовыми отборами, карточка находки, решение человека, текст для Hub,
2
+ отметки «скопировано», «Проверено» и «Внесено в Hub», вопрос к модели («Спросить модель») и повторный разбор
3
+ находки («Пересмотреть вердикт»).
4
+
5
+ Шаблоны – templates/findings/: list.html (список), card.html (карточка). Поведение карточки в браузере –
6
+ static/app.js; без скрипта каждое действие работает обычной формой с переходом обратно на карточку.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ import json
12
+ import re
13
+ from collections.abc import Callable, Iterable
14
+ from typing import Any
15
+ from urllib.parse import parse_qs, urlencode, urlsplit
16
+
17
+ from fastapi import APIRouter, HTTPException, Request
18
+ from fastapi.responses import HTMLResponse, JSONResponse
19
+ from starlette.concurrency import run_in_threadpool
20
+
21
+ from app import __version__, ask, defect, defect_drafts, hub_defects, hub_onboarding, hub_state, mask_display, worklists
22
+ from app.config import VERDICTS
23
+ from app.context import (build_context, display_context, export_fragment_scope, export_fragment_shift,
24
+ export_fragment_view, shift_code_lines, window_code_lines)
25
+ from app.db import (DECISIONS, NO_EXPECT, Database, StaleReview, hub_verdict, loads, source_signature, source_version,
26
+ text_hash)
27
+ from app.masking import PLACEHOLDER_RE, is_credential_finding, mask_line, mask_text
28
+ from app.models import UNCONFIRMED_EXPORT_CHECKS, CodeContext, Finding, Verdict
29
+ from app.hub_import import group_key2 as group_key # ключ группы второй редакции (ADR-0095)
30
+ from app.routes import hub_defect_routes, hub_status_routes
31
+ from app.prompts import (DIFFERS_CAP_VERSIONS, DIFFERS_CONFIDENCE_MAX, PROMPT_VERSION, SHORT_EXPLANATION_VERSIONS, hub_text, hub_text_v1, hub_text_v2, invisible_lines,
32
+ steering_fields, steering_lines)
33
+ from app.feeds import FeedStore
34
+ from app.executors import executor_label, same_model
35
+ from app.routes.common import (COUNT, MAX_NAME, CommentNeedsCheck, client_of, comment_check_text, # noqa: F401
36
+ comment_confirm_valid, copy_missing_message, db_of, default_model, entered_check_text,
37
+ form_int, mask_key_of, models_of, project_or_404, query, redirect, register_messages,
38
+ profile_for, render, runner_of, settings_of, web_of)
39
+ from app.routes.feeds import store_of
40
+ from app.triage import (CONTEXT_CHARS, MIN_CONTEXT_CHARS, TriageError, case_hash, current_code, repo_dir_for,
41
+ snapshot_code, source_codebases)
42
+ from app.view import DECISION_LABELS, KIND_LABELS, VERDICT_LABELS, fmt_ts, missing_line_refs, review_json
43
+
44
+ router = APIRouter()
45
+
46
+ PAGE_SIZE = 200
47
+ # Второе мнение («Пересмотреть вердикт»): проверенные модели из README – раньше прочих по списку
48
+ SECOND_OPINION_MODELS = ("gpt-oss:20b", "mistral-small3.2:24b", "qwen2.5-coder:14b")
49
+ MAX_COMMENT = 20000 # знаков в комментарии для Hub
50
+
51
+ # Почему решение не сохранено (StaleReview.reason) – текст для человека
52
+ STALE_MESSAGES = {
53
+ "source": "Находка или папка с её кодом изменились, пока карточка была открыта (новая выгрузка или другой "
54
+ "клон). Решение не сохранено: проверьте карточку ещё раз.",
55
+ "verdict": "Вердикт модели изменился, пока карточка была открыта (новый прогон). Решение не сохранено: "
56
+ "проверьте карточку ещё раз.",
57
+ "revision": "Решение по этой находке уже изменили в другой вкладке или окне. Ваше решение не сохранено, чтобы "
58
+ "не затереть более новое: сверьте карточку и сохраните ещё раз.",
59
+ "code": "Код находки в клоне изменился, пока карточка была открыта (правки в рабочей копии или git pull). "
60
+ "Решение не сохранено: посмотрите код ещё раз.",
61
+ "stale_verdict": "Код изменился после разбора – согласиться с прежним ответом нельзя: "
62
+ "разберите находку заново или выберите «Не согласен»",
63
+ "number": "Номер дефекта изменили в другой вкладке, пока карточка была открыта: номер не перезаписан. "
64
+ "Обновите карточку и проверьте номер.",
65
+ }
66
+ # Срез кода разбора не совпадает с текущим (изменился код в клоне или построение среза в новой версии): вердикт
67
+ # модели – про прежний срез. Это предупреждение, а не запрет: решение человека по текущему коду сохраняется
68
+ # с отметкой «Проверено» (ADR-0145; ADR-0147). Текст – для прежних ссылок ?ok=code_changed
69
+ CODE_CHANGED_REVIEW = ("Решение сохранено. Срез кода, который разбирала модель, не совпадает с текущим: её вердикт "
70
+ "относится к прежнему срезу. Чтобы модель посмотрела текущий код, нажмите «Разобрать заново».")
71
+ ENTERED_STALE = ("Решение по находке изменили в другой вкладке или окне: отметка «Внесено в Hub» не поставлена. "
72
+ "Обновите карточку и отметьте ещё раз.")
73
+ ENTERED_NO_DECISION = ("Сначала сохраните решение по находке: отметка «Внесено в Hub» – о тексте этого "
74
+ "решения.")
75
+ RISK_NEEDS_REASON = ("«Риск принят» сохраняется только с обоснованием: напишите в комментарии для Hub, почему риск "
76
+ "принимается и при каком условии решение пересматривается (например, срок или событие).")
77
+ NEED_VERDICT = "Выберите итоговый вердикт"
78
+ # Текст для Hub – решение человека: предложенный моделью вердикт без выбранного решения не выдаётся (R092-03)
79
+ NEED_DECISION = ("Выберите решение: «Ложное срабатывание», «Подтверждаю дефект» или «Отложить». Ответ модели ещё не "
80
+ "принят – без решения текст для Hub не выдаётся.")
81
+ # SAST с 0.9.6 (ADR-0089): два исхода – ложное срабатывание (короткий комментарий) и подтверждённый дефект (полный
82
+ # текст); «Отложить» – вернуться позже. «Неясно» и «Риск принят» для SAST не выбираются
83
+ SAST_OUTCOMES = ("false_positive", "true_positive")
84
+ SAST_TWO_OUTCOMES = ("Для находки SAST два решения: «Ложное срабатывание» – короткий комментарий в Hub, или "
85
+ "«Подтверждаю дефект» – дефект в Hub. «Отложить» – вернуться к находке позже.")
86
+ SAST_NEED_REASON = {"false_positive": "Напишите комментарий для Hub: одной-двумя фразами, почему срабатывание ложное.",
87
+ "true_positive": "Напишите обоснование дефекта: откуда приходят данные, что за ошибка и чем она "
88
+ "опасна."}
89
+ SAST_ENTER_ONLY = ("Отметка «Внесено в Hub» – только для решений «Ложное срабатывание» и «Подтверждаю дефект»: "
90
+ "отложенная находка в Hub не переносится.")
91
+ ENTERED_TEXT_MOVED = ("Текст для Hub изменился после того, как вы его скопировали (например, название команды или "
92
+ "решение): скопируйте текст заново, вставьте его в Hub и отметьте ещё раз.")
93
+ ENTERED_RELOAD = "Обновите карточку: отметка «Внесено в Hub» сверяет текст, который вы видите, а страница открыта раньше."
94
+ ENTERED_NEEDS_REASON = ("Отметка «Внесено в Hub» не поставлена: у решения нет обоснования. Допишите его, сохраните "
95
+ "решение и перенесите текст в Hub.")
96
+ DEFECT_NEEDS_REASON = ("Дефект не выдан: нет обоснования. Напишите, откуда приходят данные, что за ошибка и чем она "
97
+ "опасна, и сохраните решение.")
98
+ # рекомендация дефекта – пункты оператора словами (ADR-0092): код модели и общий пункт в текст не подставляются
99
+ # отказ сервера не знает, что показала карточка, поэтому о кнопке не говорит; подсказка у поля – по факту (need_fix_text)
100
+ SAST_NEED_FIX = "Напишите рекомендацию: что исправить и как, по пункту в строке. Без рекомендации дефект не выдаётся."
101
+
102
+
103
+ def steering_of(f: Finding, stored: dict, ctx: CodeContext) -> tuple[list[int], list[str]]:
104
+ """Строки и поля, похожие на указания для модели: сохранённые вместе со срезом при прогоне (с невидимыми знаками –
105
+ и у срезов, сохранённых до этой проверки) или посчитанные по срезу прежней версии."""
106
+ if "steering_lines" in stored:
107
+ lines = [int(n) for n in stored.get("steering_lines") or [] if str(n).isdigit()]
108
+ fields = [str(x) for x in stored.get("steering_fields") or []]
109
+ return sorted(set(lines) | set(invisible_lines(ctx))), fields
110
+ return steering_lines(ctx), steering_fields(f, ctx)
111
+
112
+
113
+ def model_suggestion(f: Finding, case: dict | None) -> dict:
114
+ """Обоснование и пункты рекомендации модели для «Дефекта из выбранных» – по правилам кнопок карточки (ADR-0092):
115
+ только вердикт «Подтверждаю дефект» и без текста, похожего на указания для модели, в коде; поле само не
116
+ заполняется – только кнопкой оператора."""
117
+ row = (case or {}).get("verdict")
118
+ stored = (case or {}).get("context")
119
+ if not row or not stored:
120
+ return {}
121
+ verdict = Verdict.from_dict(row["data"])
122
+ if verdict.verdict != "true_positive":
123
+ return {}
124
+ lines, fields = steering_of(f, stored, export_fragment_view(f, CodeContext.from_dict(stored)))
125
+ if lines or fields:
126
+ return {}
127
+ points, dropped = defect.recommendation_points(verdict.fix, clean=True) # заготовка из ответа модели
128
+ comment = verdict.hub_comment.strip() # текст о ложном срабатывании к дефекту не предлагается (план dev9, п. 1)
129
+ return {"comment": comment if model_comment_verdict(comment, verdict.verdict) == "true_positive" else "",
130
+ "points": "\n".join(points), "code_dropped": dropped}
131
+
132
+
133
+ def need_fix_text(model_fix: str, model_points: list[str], history_points: bool = False) -> str:
134
+ """Подсказка у поля рекомендации – по тому, что есть в карточке (У2): кнопка «Взять пункты» есть только при
135
+ пунктах словами в рекомендации модели; у рекомендации из одного кода и при её отсутствии кнопки нет; пункты
136
+ прежнего разбора берутся в истории разборов (history_points, ADR-0097)."""
137
+ if model_points:
138
+ return ("Напишите рекомендацию: что исправить и как, по пункту в строке. Пункты модели можно взять за основу "
139
+ "кнопкой «Взять пункты из рекомендации модели» под полем – пример кода в пункты не переносится.")
140
+ if history_points:
141
+ return ("Напишите рекомендацию словами: что исправить и как, по пункту в строке. У текущего разбора пунктов "
142
+ "словами нет, у прежнего – есть: возьмите их кнопкой «Взять пункты из этого разбора» в истории "
143
+ "разборов (шаг 2).")
144
+ if model_fix.strip():
145
+ return ("Напишите рекомендацию словами: что исправить и как, по пункту в строке. У модели в рекомендации "
146
+ "только пример кода – в пункты дефекта он не переносится.")
147
+ return ("Напишите рекомендацию словами: что исправить и как, по пункту в строке. Пунктов рекомендации модели "
148
+ "нет.")
149
+ DEFECT_NEEDS_TEAM = ("Дефект не выдан: не указано название команды для первой фразы дефекта. Укажите его на "
150
+ "странице «Настройки» (раздел «Дефект для Hub»).")
151
+ DEFECT_NEEDS_FIX = ("Дефект не выдан: нет рекомендации. Напишите, что исправить и как (по пункту в строке), и сохраните "
152
+ "решение.")
153
+ ENTERED_NEEDS_FIX = ("Отметка «Внесено в Hub» не поставлена: у дефекта нет рекомендации. Допишите её, сохраните решение "
154
+ "и перенесите текст в Hub.")
155
+ DEFECT_OTHER_REVISION = ("Решение по находке изменили в другой вкладке или окне: обновите карточку, сверьте решение и "
156
+ "скопируйте текст дефекта заново.")
157
+ SAST_COPY_DEFECT = ("Комментарий для Hub копируется только при решении «Ложное срабатывание». Для подтверждённого "
158
+ "дефекта сохраните решение и скопируйте заголовок и текст дефекта; отложенная находка в Hub не "
159
+ "переносится.")
160
+ MAX_FIX = 20000 # знаков в рекомендации дефекта SAST
161
+ FIX_TOO_LONG = (f"Рекомендация длиннее {MAX_FIX} знаков и не сохранена: сократите её – текст в поле остался "
162
+ "как есть.")
163
+
164
+ # Отбор списка находок, внутри которого карточка ведёт к следующей находке (параметры адреса)
165
+ SELECTION_KEYS = ("kind", "verdict", "decision", "cb", "urgent", "steering", "reviewed", "copied", "entered",
166
+ "missing", "run_error", "dropped", "group", "hub_status", "hubsync", "hub_live",
167
+ "hub_model_diff", "no_code")
168
+ MAX_HUB_STATUSES = 20 # значений «Статус Hub» в одном отборе
169
+
170
+ # отбор по состоянию относительно Hub (dev15, бэклог 88): то же состояние, что в строках списка и в синхронизации
171
+ HUB_SYNC_FILTERS = {"unsent": "не отправлено в Hub", "differs": "есть отличия от Hub"}
172
+
173
+ # Готовые отборы над фильтрами списка находок: (подпись, параметры)
174
+ PRESETS = (("Непроверенные", {"kind": "SAST", "reviewed": "no"}), ("Срочные", {"urgent": "1"}),
175
+ ("Неясно", {"verdict": "uncertain"}), ("Hub и модель разошлись", {"hub_model_diff": "1"}),
176
+ ("Живые в Hub", {"hub_live": "1"}), ("Отложенные", {"decision": "later"}),
177
+ ("Не внесены в Hub", {"reviewed": "yes", "entered": "no"}), ("С указаниями для модели", {"steering": "1"}))
178
+
179
+ # Фильтры списка находок чипами: группы с одним выбранным значением – (параметр, подпись, ((значение, подпись), …)),
180
+ # "" – без фильтра; флажки – (параметр, значение, подпись)
181
+ FILTER_GROUPS = (
182
+ ("kind", "Вид", (("", "все"), *KIND_LABELS.items())),
183
+ ("verdict", "Вердикт модели", (("", "любой"), *VERDICT_LABELS.items(), ("none", "нет вердикта"))),
184
+ ("decision", "Моё решение", (("", "любое"), *DECISION_LABELS.items(), ("none", "нет решения"))),
185
+ ("reviewed", "Проверено", (("", "все"), ("no", "нет"), ("yes", "да"))),
186
+ ("entered", "Внесено в Hub", (("", "все"), ("no", "нет"), ("yes", "да"))),
187
+ ("missing", "В выгрузке", (("", "все"), ("no", "есть"), ("yes", "нет в новой выгрузке"))),
188
+ ("hubsync", "Синхронизация с Hub", (("", "все"), *HUB_SYNC_FILTERS.items())),
189
+ )
190
+ # «Срочные» и «С указаниями для модели» – среди готовых отборов, здесь их не повторяем
191
+ FILTER_FLAGS = (("copied", "no", "проверены, но не скопированы в Hub"),
192
+ ("run_error", "1", "с ошибкой в последнем прогоне"),
193
+ ("dropped", "1", "выбыли из дефекта"),
194
+ ("no_code", "1", "без кода в клоне"))
195
+
196
+ # Уверенность модели словами: (нижняя граница, слово)
197
+ CONFIDENCE_WORDS = ((80, "высокая"), (50, "средняя"), (0, "низкая"))
198
+
199
+ register_messages({
200
+ "saved": "Решение сохранено.",
201
+ "all_reviewed": "Непроверенных находок SAST больше нет.",
202
+ "no_other": "Решение сохранено. Других непроверенных находок SAST нет – осталась только эта.",
203
+ "selection_done": "Решение сохранено. В этой выборке больше нечего проверять.",
204
+ "selection_end": "Решение сохранено. Это была последняя находка выборки.",
205
+ "code_changed": CODE_CHANGED_REVIEW,
206
+ "reviewed": "Находка отмечена как проверенная.",
207
+ "unreviewed": "Отметка «Проверено» снята.",
208
+ "entered": "Отмечено: внесено в Hub.",
209
+ "unentered": "Отметка «Внесено в Hub» снята.",
210
+ "reanalyze": "Находка поставлена на повторный разбор: карточка обновится, когда модель ответит.",
211
+ "asked": "Модель ответила – ответ ниже, в разделе «Вопросы к модели».",
212
+ "ask_failed": "Модель не ответила – причина ниже, в разделе «Вопросы к модели».", # плашка ошибки (НТ12)
213
+ }, errors=("ask_failed",))
214
+
215
+
216
+ class ReviewRejected(ValueError):
217
+ """Решение не сохраняется по существу (например, «Риск принят» без обоснования). Текст – для человека; форма
218
+ возвращается с тем, что он ввёл."""
219
+
220
+
221
+ # ============================================================================ отбор
222
+
223
+ def multi_values(q, key: str) -> tuple[str, ...]:
224
+ """Повторяющийся параметр адреса (`hub_status=A&hub_status=B`, бэклог 99): упорядоченный кортеж без пустых и
225
+ повторов, не больше MAX_HUB_STATUSES значений по MAX_NAME знаков."""
226
+ raw = q.getlist(key) if hasattr(q, "getlist") else [q.get(key, "")]
227
+ values = tuple(dict.fromkeys(v for v in (str(x)[:MAX_NAME] for x in raw) if v))
228
+ return values[:MAX_HUB_STATUSES]
229
+
230
+
231
+ def read_selection(q) -> dict[str, Any]:
232
+ """Отбор списка находок из параметров адреса (только допустимые значения): по нему карточка ведёт
233
+ к следующей непроверенной находке этого же отбора."""
234
+ selection = {
235
+ "kind": q.get("kind", "") if q.get("kind", "") in KIND_LABELS else "",
236
+ "verdict": q.get("verdict", "") if q.get("verdict", "") in (*VERDICTS, "none") else "",
237
+ "decision": q.get("decision", "") if q.get("decision", "") in (*DECISIONS, "hub", "none") else "",
238
+ "cb": q.get("cb", "")[:MAX_NAME],
239
+ "urgent": "1" if q.get("urgent") == "1" else "",
240
+ "steering": "1" if q.get("steering") == "1" else "",
241
+ "reviewed": q.get("reviewed", "") if q.get("reviewed", "") in ("yes", "no") else "",
242
+ "copied": "no" if q.get("copied") == "no" else "",
243
+ "entered": q.get("entered", "") if q.get("entered", "") in ("yes", "no") else "",
244
+ "missing": q.get("missing", "") if q.get("missing", "") in ("yes", "no") else "",
245
+ "run_error": "1" if q.get("run_error") == "1" else "",
246
+ "dropped": "1" if q.get("dropped") == "1" else "",
247
+ "hub_status": multi_values(q, "hub_status"),
248
+ "hub_live": "1" if q.get("hub_live") == "1" else "",
249
+ "hub_model_diff": "1" if q.get("hub_model_diff") == "1" else "",
250
+ "no_code": "1" if q.get("no_code") == "1" else "",
251
+ "hubsync": q.get("hubsync", "") if q.get("hubsync", "") in HUB_SYNC_FILTERS else "",
252
+ # группа SAST находки с этим id (точный ключ группы, ADR-0095): «Вся группа в списке» из карточки
253
+ # переданный, но негодный (0, не число) – "0": отбор пуст, а не весь проект
254
+ "group": "" if "group" not in q else (group if ((group := str(q.get("group", ""))).isascii()
255
+ and group.isdigit() and len(group) <= 12) else "0"),
256
+ }
257
+ # Сортировка и группа относятся к той же очереди, что предметные фильтры.
258
+ for key in ("sort", "group_by", "family"):
259
+ if q.get(key):
260
+ selection[key] = str(q[key])[:120]
261
+ back = q.get("back", "")[:2000]
262
+ try:
263
+ back_parts = urlsplit(back)
264
+ except ValueError:
265
+ back_parts = urlsplit("")
266
+ if back.startswith("/projects/") and back_parts.path.endswith("/findings") and not back_parts.netloc:
267
+ selection["back"] = back
268
+ for key, values in parse_qs(back_parts.query).items():
269
+ if key in ("sort", "group_by", "family") and key not in selection:
270
+ selection[key] = values[-1][:120]
271
+ return {k: v for k, v in selection.items() if v}
272
+
273
+
274
+ def queue_neighbor(db, project_id, anchor, selection, direction="next", *, wrap=True, descriptors=None, hub_ids=None):
275
+ """Обход той же отсортированной группы, что видна в таблице, через границы страниц. descriptors – уже прочитанные
276
+ дескрипторы отбора selection (страница списка читает их для таблицы): второй раз база не читается, из них
277
+ берутся те же строки, что дал бы запрос с kind=SAST и missing=no по умолчанию (PERF-03: на 50 000 находок второе
278
+ чтение стоило 0,5 с из 1,4 с страницы)."""
279
+ filters = selection_filters(selection)
280
+ defaults = {}
281
+ if not filters.get("kind"):
282
+ filters["kind"] = defaults["kind"] = "SAST"
283
+ if not filters.get("missing"):
284
+ filters["missing"] = defaults["missing"] = "no"
285
+ if descriptors is None:
286
+ rows = db.finding_descriptors(project_id, filters)
287
+ else:
288
+ rows = [r for r in descriptors
289
+ if ("kind" not in defaults or r["kind"] == "SAST")
290
+ and ("missing" not in defaults or r["missing"] == 0)] # ровно как f.missing = 0 в SQL
291
+ if hub_ids is not None: # отбор «Синхронизация с Hub» (dev15): тот же набор, что в списке
292
+ rows = [r for r in rows if r["hub_id"] in hub_ids]
293
+ # После сохранения текущая строка могла выйти из фильтра «непроверенные»; позиция обхода остаётся её.
294
+ if anchor and not any(r["id"] == anchor["id"] for r in rows):
295
+ rows.append(anchor)
296
+ rows.sort(key=lambda r: (r["pos"], r["id"]))
297
+ rows = worklists.sort_findings(rows, selection.get("sort", ""))
298
+ family = selection.get("family", "")
299
+ if family:
300
+ rows = [r for r in rows if worklists.family(r, "findings")[0] == family]
301
+ if not rows:
302
+ return None
303
+ index = next((i for i, r in enumerate(rows) if anchor and r["id"] == anchor["id"]), -1)
304
+ candidates = rows[index + 1:] + (rows[:index] if wrap and index >= 0 else [])
305
+ if direction == "prev":
306
+ candidates = list(reversed(rows[:index])) + (list(reversed(rows[index + 1:])) if wrap else [])
307
+ return next((r["id"] for r in candidates if (not anchor or r["id"] != anchor["id"])
308
+ and (walks_all(selection) or not r["reviewed"])), None)
309
+
310
+
311
+ def walks_all(selection: dict[str, str]) -> bool:
312
+ """Выборка проверенных находок («не скопированы в Hub», «проверено: да», «внесены в Hub»): карточка ведёт
313
+ по всем находкам выборки, а не только по непроверенным."""
314
+ return (selection.get("copied") == "no" or selection.get("reviewed") == "yes"
315
+ or selection.get("entered") == "yes" or selection.get("dropped") == "1")
316
+
317
+
318
+ def selection_filters(selection: dict[str, str]) -> dict[str, Any]:
319
+ """Отбор из адреса -> фильтры Database.list_findings / neighbor_unreviewed («~» – находки без кодовой базы)."""
320
+ cb = selection.get("cb", "")
321
+ return {"kind": selection.get("kind", ""), "verdict": selection.get("verdict", ""),
322
+ "decision": selection.get("decision", ""), "codebase": None if not cb else ("" if cb == "~" else cb),
323
+ "urgent": bool(selection.get("urgent")), "steering": bool(selection.get("steering")),
324
+ "reviewed": selection.get("reviewed", ""), "copied": selection.get("copied", ""),
325
+ "entered": selection.get("entered", ""), "missing": selection.get("missing", ""),
326
+ "run_error": bool(selection.get("run_error")), "dropped": bool(selection.get("dropped")),
327
+ "group": int(selection["group"]) if selection.get("group") else None,
328
+ "hub_status": tuple(selection.get("hub_status") or ()), "hub_live": bool(selection.get("hub_live")),
329
+ "hub_model_diff": bool(selection.get("hub_model_diff")), "no_code": bool(selection.get("no_code"))}
330
+
331
+
332
+ def selection_labels(selection: dict[str, str]) -> list[str]:
333
+ """Отбор словами – для строки «В выборке: …» в карточке."""
334
+ labels = []
335
+ if selection.get("urgent"):
336
+ labels.append("срочные")
337
+ if selection.get("cb"):
338
+ labels.append("без кодовой базы" if selection["cb"] == "~" else selection["cb"])
339
+ if selection.get("kind"):
340
+ labels.append(KIND_LABELS.get(selection["kind"], selection["kind"]))
341
+ verdict = selection.get("verdict", "")
342
+ if verdict:
343
+ labels.append("модель: " + ("нет вердикта" if verdict == "none" else VERDICT_LABELS.get(verdict, verdict)))
344
+ decision = selection.get("decision", "")
345
+ if decision:
346
+ labels.append("решение: " + ("нет" if decision == "none" else DECISION_LABELS.get(decision, decision)))
347
+ if selection.get("hub_status"):
348
+ statuses = selection["hub_status"]
349
+ labels.append("статус Hub: " + (", ".join(statuses) if isinstance(statuses, (list, tuple)) else str(statuses)))
350
+ if selection.get("hub_live"):
351
+ labels.append("живые в Hub")
352
+ if selection.get("hub_model_diff"):
353
+ labels.append("Hub и модель разошлись")
354
+ if selection.get("no_code"):
355
+ labels.append("без кода в клоне")
356
+ if selection.get("steering"):
357
+ labels.append("с текстом-указанием для модели")
358
+ if selection.get("reviewed"):
359
+ labels.append("проверенные" if selection["reviewed"] == "yes" else "непроверенные")
360
+ if selection.get("copied"):
361
+ labels.append("не скопированы в Hub")
362
+ if selection.get("dropped"):
363
+ labels.append("выбыли из дефекта")
364
+ if selection.get("group"):
365
+ labels.append("одна группа SAST")
366
+ if selection.get("entered"):
367
+ labels.append("внесены в Hub" if selection["entered"] == "yes" else "не внесены в Hub")
368
+ if selection.get("missing"):
369
+ labels.append("нет в новой выгрузке" if selection["missing"] == "yes" else "есть в выгрузке")
370
+ if selection.get("run_error"):
371
+ labels.append("с ошибкой в последнем прогоне")
372
+ if selection.get("hubsync"):
373
+ labels.append(HUB_SYNC_FILTERS[selection["hubsync"]])
374
+ return labels
375
+
376
+
377
+ def hub_sync_ids(request, project, selection, states=None):
378
+ """hub_id находок отбора «Синхронизация с Hub» (dev15): то же состояние, что в строках списка; без отбора – None."""
379
+ choice = selection.get("hubsync")
380
+ if choice not in HUB_SYNC_FILTERS:
381
+ return None
382
+ states = states or hub_state.project_states(db_of(request), project, settings_of(request).hub_url)
383
+ field = "unsent" if choice == "unsent" else "differs"
384
+ return {hub_id for hub_id, st in states["by_hub_id"].items() if st[field]}
385
+
386
+
387
+ def card_url(project_id: int, finding_id: int, selection: dict[str, str], **params: Any) -> str:
388
+ """Адрес карточки с отбором списка и параметрами (?ok=…)."""
389
+ q = query(selection, **params)
390
+ return f"/projects/{project_id}/findings/{finding_id}" + (f"?{q}" if q else "")
391
+
392
+
393
+ # ============================================================================ карточка
394
+
395
+ def masked_extra(f: Finding, key: bytes) -> dict[str, str]:
396
+ """Прочие колонки выгрузки для карточки – маскированными, как код. У находки о секрете в коде каждая строка
397
+ значения скрывается целиком (здесь правило ADR-0117 не действует): в такой колонке может оказаться копия кода
398
+ с секретом, в том числе многострочный литерал, который по частям не распознать."""
399
+ credential = is_credential_finding(f.rule, f.cwe)
400
+ result = {}
401
+ for name, value in f.extra.items():
402
+ text = str(value)
403
+ if credential:
404
+ result[name] = "\n".join(mask_line(part, key)[0] if part.strip() else part for part in text.split("\n"))
405
+ else:
406
+ result[name] = mask_text(text, key)[0]
407
+ return result
408
+
409
+
410
+ def card_note(ctx: CodeContext) -> str:
411
+ """Заметка к срезу без прежнего предположения о смене коммита по несовпадению строки."""
412
+ parts = [p for p in str(ctx.note or "").split("; ") if p.strip()]
413
+ parts = [p for p in parts if "не совпадает со строкой из выгрузки" not in p]
414
+ return "; ".join(parts)
415
+
416
+
417
+ # что делать оператору – по ключу общей классификации причин (view.code_reason_key, бэклог 103)
418
+ CODE_REASON_ADVICE = {
419
+ "file_missing": "Разбор и решение – по сведениям из выгрузки Hub: правило, путь и строка кода.",
420
+ "no_file": "Разбор и решение – по сведениям из выгрузки Hub.",
421
+ "ambiguous": "Код не показан: уточните путь или оставьте клон до разбора.",
422
+ "line_out_of_range": "Причина – клон, похоже, не на коммите скана.",
423
+ "too_large": "Файл в клоне есть, но больше 2 МБ.",
424
+ "binary": "Файл в клоне есть, но двоичный.",
425
+ "unreadable": "Файл в клоне есть, но не читается.",
426
+ "empty": "Файл в клоне есть, но пуст.",
427
+ }
428
+
429
+
430
+ def code_reason(ctx: CodeContext) -> str:
431
+ """Почему карточка показывает сведения выгрузки вместо кода из файла клона (ADR-0073): причина – общей
432
+ классификацией списка и сводок (view.code_reason, бэклог 103), с тем, что делать; без клона и прежние срезы – пояснение
433
+ среза (например, «клон отвязан»). Тексты для модели (ctx.note) не меняются."""
434
+ from app.view import code_reason as reason_label, code_reason_key
435
+ if ctx.status == "ok":
436
+ return ""
437
+ key = code_reason_key(ctx.status, ctx.reason, ctx.file)
438
+ if key not in CODE_REASON_ADVICE:
439
+ return ctx.note
440
+ label = reason_label(ctx.status, ctx.reason, ctx.file, len(ctx.lines or []))
441
+ return f"{label[:1].upper()}{label[1:]}. {CODE_REASON_ADVICE[key]}"
442
+
443
+
444
+ def confidence_label(value: Any) -> str:
445
+ """Уверенность словами: высокая (от 80), средняя (от 50), низкая."""
446
+ try:
447
+ number = int(value)
448
+ except (TypeError, ValueError):
449
+ number = 0
450
+ return next(word for bound, word in CONFIDENCE_WORDS if number >= bound)
451
+
452
+
453
+ def model_comment_verdict(text: str, verdict: str) -> str:
454
+ """Исход, к которому на деле написан текст модели: начало «Ложное срабатывание» важнее вердикта ответа: при вердикте
455
+ «истинная» такой текст подставлялся в обоснование дефекта и спорил с решением (план dev9, часть 2, п. 1)."""
456
+ return "false_positive" if str(text or "").lstrip().casefold().startswith("ложное срабатывание") else str(verdict or "")
457
+
458
+
459
+ def target_line_hidden(f: Finding, ctx: CodeContext | None) -> bool:
460
+ """Находка о секрете, у которой в срезе модели строка срабатывания – только метка: кроме меток и знаков препинания в ней ничего нет
461
+ (срез до ADR-0117, содержимое многострочного литерала). Модель такую строку не видела, вердикт ненадёжен. Только показ."""
462
+ if ctx is None or not is_credential_finding(f.rule, f.cwe):
463
+ return False
464
+ text = next((line for _, line, target in ctx.rows() if target), "")
465
+ return bool(PLACEHOLDER_RE.search(text)) and not re.search(r"\w", PLACEHOLDER_RE.sub("", text))
466
+
467
+
468
+ def comment_origin(db: Database, case: dict | None, review: dict | None, comment: str, *,
469
+ project_id: int | None = None, hub_id: str = "", known: list[dict] | None = None) -> str:
470
+ """Вердикт, к которому модель написала этот комментарий, если человек его не правил: текущий ответ модели
471
+ по находке, ответ, по которому человек принимал прежнее решение (review.verdict_id), и – по project_id и hub_id –
472
+ все прежние ответы по находке (db.finding_verdicts): после повторного разбора и обычного сохранения ссылка на
473
+ прежний ответ из решения уходит, а его комментарий остаётся. "" – комментарий написан или поправлен человеком
474
+ (или пуст)."""
475
+ text = str(comment or "").strip()
476
+ if not text:
477
+ return ""
478
+ candidates = []
479
+ if case and case.get("verdict"):
480
+ candidates.append(case["verdict"])
481
+ old_id = (review or {}).get("verdict_id")
482
+ if old_id and (not case or old_id != case.get("verdict_id")):
483
+ old = db.get_verdict(int(old_id))
484
+ if old is not None:
485
+ candidates.append(old)
486
+ if known is not None: # ответы по находке уже выбраны этим же запросом (карточка: две сверки – одна выборка)
487
+ candidates += known
488
+ elif project_id is not None and hub_id:
489
+ candidates += db.finding_verdicts(project_id, hub_id)
490
+ for v in candidates:
491
+ if text == str((v.get("data") or {}).get("hub_comment") or "").strip():
492
+ return model_comment_verdict(text, v.get("verdict"))
493
+ return ""
494
+
495
+
496
+ def saved_hub_text(f: Finding, review: dict | None, status_map: dict) -> str:
497
+ """Текст для Hub по сохранённому решению – тот, что человек вносит в Hub (по нему считается отпечаток отметки
498
+ «Внесено в Hub»). Решения нет – ""."""
499
+ if not review:
500
+ return ""
501
+ return hub_text(f, hub_verdict(review["decision"], review["final_verdict"]), review["final_comment"], status_map)
502
+
503
+
504
+ def entered_text_changed(review: dict | None, text: str) -> bool:
505
+ """Отметка «Внесено в Hub» стоит, а текст для Hub с тех пор другой (например, сменились статусы Hub
506
+ в настройках). Отметки без отпечатка (поставлены до этапа 3) – entered_unconfirmed."""
507
+ expected = (review.get("entered_decision_hash") if review.get("entered_origin") == "defect"
508
+ else review.get("entered_text_hash")) if review else ""
509
+ return bool(review and review.get("entered_hub") and expected and text_hash(text) != expected)
510
+
511
+
512
+ # составляющие текста SAST для Hub (О8): (ключ, что называет карточка, если изменилось). Статусы Hub в текст SAST
513
+ # не входят (prompts.hub_text): их смена причиной не называется
514
+ ENTERED_PARTS = (("comment", "текст решения"), ("fix", "рекомендация"), ("team", "название команды в настройках"))
515
+
516
+
517
+ def entered_parts(settings, review: dict | None) -> str:
518
+ """Из чего собран текст SAST для Hub сейчас (О8) – только то, что в него входит: у подтверждённого дефекта тело –
519
+ обоснование, рекомендация и название команды (sast_entered_text), у ложного срабатывания – комментарий; плюс
520
+ версия приложения (формат текста). Запоминается при отметке «Внесено в Hub»."""
521
+ review = review or {}
522
+ parts = {"comment": text_hash(review.get("final_comment") or ""), "app": __version__}
523
+ if defect.sast_ready(hub_verdict(review.get("decision") or "", review.get("final_verdict") or "")):
524
+ parts.update(fix=text_hash(review.get("final_fix") or ""), team=text_hash(settings.team_name or ""))
525
+ return json.dumps(parts, sort_keys=True)
526
+
527
+
528
+ def entered_by_bulk(review: dict | None) -> bool:
529
+ """Отметка «Внесено в Hub» поставлена массовой отправкой из списка (ADR-0119): в частях отметки – признак bulk, а
530
+ отпечаток – общего комментария, не текста решения."""
531
+ try:
532
+ was = json.loads((review or {}).get("entered_parts") or "")
533
+ except ValueError:
534
+ return False
535
+ return isinstance(was, dict) and bool(was.get("bulk"))
536
+
537
+
538
+ def entered_change_reasons(settings, review: dict | None) -> list[str] | None:
539
+ """Что изменилось в тексте для Hub после отметки «Внесено в Hub» (О8). None – отметка поставлена до 0.9.9 и
540
+ составляющих не помнит; [] – составляющие те же (текст изменился иначе). Если изменилась только версия
541
+ приложения – причина в формате текста."""
542
+ try:
543
+ was = json.loads((review or {}).get("entered_parts") or "")
544
+ except ValueError:
545
+ return None
546
+ if not isinstance(was, dict):
547
+ return None
548
+ now = json.loads(entered_parts(settings, review))
549
+ reasons = [label for key, label in ENTERED_PARTS if key in was and was[key] != now.get(key)]
550
+ if not reasons and was.get("app") and was["app"] != now["app"]:
551
+ fix = str((review or {}).get("final_fix") or "")
552
+ comment = str((review or {}).get("final_comment") or "")
553
+ if (app_before(was["app"], "0.9.11")
554
+ and defect.sast_reason(comment, legacy=True) != defect.reason_text(comment, clean=True)):
555
+ # с 0.9.11 первая буква обоснования – заглавная (ADR-0101): текст изменился из-за этого
556
+ reasons.append(f"первая буква обоснования теперь заглавная (версия {now['app']}, отметка поставлена в "
557
+ f"{was['app']})")
558
+ if app_before(was["app"], "0.10.0.dev21") and defect.as_written_changed(comment, fix if "fix" in now else ""):
559
+ # с 0.10.0.dev21 текст оператора уходит как написан: без среза вводного слова,
560
+ # тегов, схем, невидимых знаков, замены тире и схлопывания пустых строк
561
+ reasons.append(f"текст оператора теперь уходит в Hub как написан, без правок приложения (версия "
562
+ f"{now['app']}, отметка поставлена в {was['app']})")
563
+ if "fix" in now and app_before(was["app"], "0.9.11") and defect.marker_rule_changed(fix):
564
+ # с 0.9.11 маркер «N)» снимается и без пробела: «2)мера» больше не пункт «2) 2)мера»
565
+ reasons.append(f"маркер пункта «N)» без пробела больше не остаётся в тексте пункта (версия {now['app']}, "
566
+ f"отметка поставлена в {was['app']})")
567
+ if "fix" in now and app_before(was["app"], "0.9.10") and defect.recommendation_points(fix)[1]:
568
+ # с 0.9.10 пример кода в рекомендацию дефекта не переносится (ADR-0098): текст изменился из-за этого
569
+ reasons.append(f"пример кода в рекомендации больше не переносится в Hub (версия {now['app']}, отметка "
570
+ f"поставлена в {was['app']})")
571
+ if not reasons:
572
+ reasons.append(f"формат текста в версии приложения {now['app']} (отметка поставлена в {was['app']})")
573
+ return reasons
574
+
575
+
576
+ def app_before(version: str, release: str) -> bool:
577
+ """Версия приложения version раньше выпуска release (по числам версии; без чисел – раньше)."""
578
+ def key(value: str) -> tuple[int, ...]:
579
+ return tuple(int(x) for x in re.findall(r"\d+", str(value or "")))
580
+ return key(version) < key(release)
581
+
582
+
583
+ def entered_format_updated(review: dict | None, text: str, legacy) -> bool:
584
+ """Отметка «Внесено в Hub» поставлена по тексту прежнего формата (до 0.9.0 или 0.9.0–0.9.5), решение с тех пор
585
+ прежнее: текст для Hub изменился только из-за нового формата. Карточка показывает спокойную пометку вместо «текст
586
+ изменился» и предлагает подтвердить отметку заново, если человек обновит комментарий в Hub. legacy – текст
587
+ прежнего формата или список таких текстов."""
588
+ texts = [legacy] if isinstance(legacy, str) else list(legacy or [])
589
+ # отпечаток, с которым сверяется отметка: у отметки от дефекта – текста решения (entered_decision_hash), как в
590
+ # entered_text_changed; у остальных – текста, внесённого в Hub
591
+ expected = {review.get("entered_text_hash") or ""} if review else set()
592
+ if review and review.get("entered_origin") == "defect":
593
+ expected.add(review.get("entered_decision_hash") or "")
594
+ expected.discard("")
595
+ return bool(entered_text_changed(review, text) and review
596
+ and any(t and text_hash(t) in expected for t in texts))
597
+
598
+
599
+ def saved_hub_text_v1(f: Finding, review: dict | None, status_map: dict) -> str:
600
+ """Текст для Hub прежнего формата по сохранённому решению – для распознавания отметок до 0.9.0."""
601
+ if not review:
602
+ return ""
603
+ return hub_text_v1(f, hub_verdict(review["decision"], review["final_verdict"]), review["final_comment"],
604
+ status_map)
605
+
606
+
607
+ def saved_hub_text_v2(f: Finding, review: dict | None, status_map: dict) -> str:
608
+ """Текст для Hub формата 0.9.0–0.9.5 по сохранённому решению – для распознавания отметок до 0.9.6."""
609
+ if not review:
610
+ return ""
611
+ return hub_text_v2(f, hub_verdict(review["decision"], review["final_verdict"]), review["final_comment"],
612
+ status_map)
613
+
614
+
615
+ def saved_legacy_texts(f: Finding, review: dict | None, status_map: dict, team: str = "") -> list[str]:
616
+ """Тексты прежних форматов по сохранённому решению: до 0.9.0, 0.9.0–0.9.5, 0.9.6–0.9.10 (обоснование без
617
+ поднятой первой буквы, ADR-0101) и 0.9.11–0.10.0.dev20 (прежняя чистка и срез вводного слова); team – название
618
+ команды для тела дефекта."""
619
+ return [saved_hub_text_v1(f, review, status_map), saved_hub_text_v2(f, review, status_map),
620
+ saved_hub_text_v3(f, review, team), saved_hub_text_v4(f, review, team)]
621
+
622
+
623
+ def saved_hub_text_v4(f: Finding, review: dict | None, team: str = "") -> str:
624
+ """Текст для Hub формата 0.9.11–0.10.0.dev20 по сохранённому решению: вводное «Подтверждено:» и подобное снято,
625
+ теги, схемы, невидимые знаки и лишние пустые строки убраны, длинное тире заменено. Совпал с текущим – "" (тот же
626
+ текст, не прежний формат). Только SAST: у DAST и SCA-license прежний текст до 0.10.0.dev21 – hub_text_v1
627
+ (saved_hub_text_v1)."""
628
+ if not review or not review.get("decision") or f.kind != "SAST":
629
+ return ""
630
+ comment = str(review.get("final_comment") or "")
631
+ outcome = hub_verdict(review["decision"], review["final_verdict"])
632
+ if not defect.sast_ready(outcome):
633
+ old = defect.sast_comment_v4(f, outcome, comment)
634
+ return old if old != defect.sast_comment(f, outcome, comment) else ""
635
+ fix = str(review.get("final_fix") or "")
636
+ if not defect.has_recommendation(fix) or not defect.fix_items(fix, clean=True):
637
+ return "" # по прежним правилам рекомендации словами не было – дефекта по ним тоже
638
+ old = defect.sast_body(f, outcome, comment, fix, team, legacy_0911=True)
639
+ return old if old != defect.sast_body(f, outcome, comment, fix, team) else ""
640
+
641
+
642
+ def saved_hub_text_v3(f: Finding, review: dict | None, team: str = "") -> str:
643
+ """Текст для Hub формата 0.9.6–0.9.10 по сохранённому решению: первая буква обоснования как у оператора, маркер
644
+ «N)» только с пробелом – собирается прежними правилами, а не заменой в очищенном тексте (ревью шага 10). Совпал с
645
+ текущим – "" (это не прежний формат, а тот же текст)."""
646
+ if not review or not review.get("decision"):
647
+ return ""
648
+ comment = str(review.get("final_comment") or "")
649
+ outcome = hub_verdict(review["decision"], review["final_verdict"])
650
+ if not defect.sast_ready(outcome):
651
+ old = defect.sast_comment_v3(f, outcome, comment)
652
+ return old if old != defect.sast_comment(f, outcome, comment) else ""
653
+ fix = str(review.get("final_fix") or "")
654
+ if not defect.has_recommendation(fix):
655
+ return ""
656
+ old = defect.sast_body(f, outcome, comment, fix, team, legacy_0910=True)
657
+ return old if old != defect.sast_body(f, outcome, comment, fix, team) else ""
658
+
659
+
660
+ def entered_unconfirmed(review: dict | None) -> bool:
661
+ """Отметка «Внесено в Hub» поставлена до этапа 3 и отпечатка текста не имеет: после обновления (например,
662
+ статусы Hub стали русскими) неизвестно, тот ли текст лежит в Hub. Карточка просит подтвердить отметку заново."""
663
+ # отметка, принятая синхронизацией, подтверждена чтением Hub: её текст – принятый из Hub
664
+ return bool(review and review.get("entered_hub") and not review.get("entered_text_hash")
665
+ and review.get("entered_origin") != "hub_sync")
666
+
667
+
668
+ def line_warnings(comment: str, fix: str, shown: set[int] | None) -> list[str]:
669
+ """Ссылки «строка N» в обосновании (комментарий человека) и рекомендациях (поле модели «Как исправить») на строки,
670
+ которых нет в показанном коде: такой довод не подтверждён. shown=None – показанного кода нет, и не подтверждена
671
+ ни одна ссылка."""
672
+ known = shown if shown is not None else set()
673
+ result = []
674
+ for label, text in (("Обоснование", defect.reason_text(comment)), ("Рекомендации модели", fix)):
675
+ missing = missing_line_refs(text, known)
676
+ if missing:
677
+ numbers = ", ".join(str(n) for n in missing[:10]) + (" и другие" if len(missing) > 10 else "")
678
+ where = "в показанном коде" if shown else "– показанного кода нет"
679
+ verb = "ссылается" if label == "Обоснование" else "ссылаются"
680
+ result.append(f"{label} {verb} на строки, которых нет {where}: {numbers}. Сверьте с кодом.")
681
+ return result
682
+
683
+
684
+ def shown_lines(request: Request, project_id: int, f: Finding, case: dict | None) -> set[int] | None:
685
+ """Номера строк кода, которые видит человек в карточке: срез, разобранный моделью, а без вердикта – срез
686
+ из клона сейчас. Кода нет – None."""
687
+ if case and case.get("verdict") and case.get("context"):
688
+ ctx = CodeContext.from_dict(case["context"])
689
+ else:
690
+ source = db_of(request).case_input(project_id, f.hub_id)
691
+ if source is None:
692
+ return None
693
+ snapshot = snapshot_code(settings_of(request), source, case)
694
+ if snapshot is not None:
695
+ ctx = snapshot[0]
696
+ else:
697
+ repo_dir, _ = repo_dir_for(settings_of(request), {"repos_dir": source["repos_dir"]},
698
+ source_codebases(source, f), f)
699
+ ctx = build_context(repo_dir, f, max_chars=CONTEXT_CHARS, mask_key=mask_key_of(request))
700
+ lines = {n for n, _, _ in ctx.rows() if n}
701
+ return lines or None
702
+
703
+
704
+ def defect_shown_lines(request: Request, project_id: int, f: Finding, case: dict | None, own: set[int] | None = None,
705
+ also: Iterable[str] = ()) -> set[int] | None:
706
+ """Строки кода, на которые может ссылаться текст дефекта: срезы всех его находок (план dev7, раздел 11). Текст у дефекта
707
+ общий, обоснование может ссылаться на строку другой находки – сверка только со своим срезом давала ложное предупреждение
708
+ на каждую находку. Дефект – все физические строки семьи: при последовательной привязке их несколько. Находка не в дефекте
709
+ – только её срез. own – свой срез, если уже получен; also – ещё находки того же дефекта (цели подготовки)."""
710
+ db = db_of(request)
711
+ lines = set(own if own is not None else shown_lines(request, project_id, f, case) or ())
712
+ bound = db.hub_defect_bound(project_id, f.hub_id)
713
+ family = db.on_connection(lambda c: defect_drafts.family_in(c, bound)) if bound else []
714
+ others = {str(t.get("hub_id") or "") for member in family for t in loads(member.get("targets_json"), [])} | set(also)
715
+ for hub_id in sorted(others - {"", f.hub_id}):
716
+ row = db.get_finding_by_hub_id(project_id, hub_id)
717
+ if row is not None and row["kind"] == "SAST":
718
+ lines |= shown_lines(request, project_id, Finding.from_dict(row["data"]), db.get_case(project_id, hub_id)) or set()
719
+ return lines or None
720
+
721
+
722
+ DEFECT_RACE = "Дефект не выдан: пока готовился текст, данные изменились."
723
+
724
+ SAST_OUTCOME_LABELS = {"true_positive": "истинная", "false_positive": "ложная", "uncertain": "неясно",
725
+ "risk_accepted": "риск принят"}
726
+
727
+
728
+ RUN_ORIGIN_LABELS = {"project": "прогон проекта", "card": "пересмотр из карточки", "retry": "повтор ошибок",
729
+ "": "вид запуска не записан"}
730
+ ATTEMPT_LABELS = {"error": "ошибка разбора", "skipped": "пропуск", "pending": "в очереди"}
731
+
732
+
733
+ def history_view(history: dict, current_id: int | None, decided_id: int | None, case_hash: str, own_outcome: str,
734
+ steering: bool) -> dict:
735
+ """История разборов моделью для карточки (ADR-0097): строки ответов с метками и пунктами рекомендации словами,
736
+ «модели расходятся» – только среди ответов по тем же входным данным и той же версии промпта; попытки без ответа –
737
+ сводкой. Пункты под влиянием указаний в коде не предлагаются (как кнопка у текущего разбора)."""
738
+ rows = []
739
+ for a in history.get("answers") or []:
740
+ data = a.get("data") or {}
741
+ comparable = a.get("case_hash") == case_hash and a.get("prompt_version") == PROMPT_VERSION
742
+ points = [] if steering else defect.recommendation_points(str(data.get("fix") or ""), clean=True)[0]
743
+ uses = a.get("uses") or []
744
+ rows.append({
745
+ "id": a["id"], "model": a.get("model") or "", "verdict": a.get("verdict") or "",
746
+ "confidence": a.get("confidence"), "created_at": a.get("created_at") or "", "stats": a.get("stats") or {},
747
+ "summary": str(data.get("summary") or ""), "why": [str(x) for x in data.get("why") or []][:6],
748
+ "fix": str(data.get("fix") or ""), "points": points,
749
+ "current": a["id"] == current_id, "decided": a["id"] == decided_id,
750
+ "disagrees": own_outcome in SAST_OUTCOMES and a.get("verdict") in SAST_OUTCOMES
751
+ and a.get("verdict") != own_outcome,
752
+ "note": "" if comparable else ("по другим входным данным" if a.get("case_hash") != case_hash
753
+ else "другая версия промпта"),
754
+ "comparable": comparable,
755
+ "runs": [{"run_id": u["run_id"], "origin": RUN_ORIGIN_LABELS.get(u.get("origin") or "",
756
+ RUN_ORIGIN_LABELS[""])}
757
+ for u in uses if u.get("state") == "done"],
758
+ "cached": sum(1 for u in uses if u.get("state") == "cached")})
759
+ verdicts = {r["verdict"] for r in rows if r["comparable"] and r["verdict"]}
760
+ attempts = history.get("attempts") or []
761
+ card = [r for r in rows if any(run["origin"] == RUN_ORIGIN_LABELS["card"] for run in r["runs"])]
762
+ return {"rows": rows, "count": len(rows), "disagree": len(verdicts) > 1, "tally": verdict_tally(rows),
763
+ "attempts": [{**x, "label": ATTEMPT_LABELS.get(x["state"], x["state"]),
764
+ "origin": RUN_ORIGIN_LABELS.get(x.get("origin") or "", RUN_ORIGIN_LABELS[""])}
765
+ for x in attempts][-5:],
766
+ "attempts_total": len(attempts),
767
+ "show": len(rows) > 1 or bool(attempts) or any(not r["current"] for r in rows),
768
+ "reanalyzed": len(card), "last_card": card[0] if card else None,
769
+ "earlier_points": any(r["points"] for r in rows if not r["current"])}
770
+
771
+
772
+ def verdict_tally(rows: list[dict]) -> dict:
773
+ """Сводка разборов моделью для шага 5: сколько разборов с каждым вердиктом и их
774
+ уверенность – по всем ответам истории, как в списке шага 2; последний – самый поздний по времени ответа; «модели
775
+ расходятся» – только среди ответов по тем же входным данным и той же версии промпта (comparable, как
776
+ model_history.disagree, ADR-0097). Подсказка, решает человек."""
777
+ groups: dict[str, list] = {}
778
+ for r in rows:
779
+ if r["verdict"]:
780
+ groups.setdefault(r["verdict"], []).append(r["confidence"])
781
+ order = ("true_positive", "false_positive", "uncertain")
782
+ parts = [{"verdict": v, "count": len(groups[v]),
783
+ "confidences": [c for c in groups[v] if c is not None]}
784
+ for v in sorted(groups, key=lambda v: (order.index(v) if v in order else len(order), v))]
785
+ latest = max(rows, key=lambda r: r["created_at"]) if rows else None
786
+ split = len({r["verdict"] for r in rows if r.get("comparable", True) and r["verdict"]}) > 1
787
+ return {"parts": parts, "latest": latest, "split": split}
788
+
789
+
790
+ def sast_decision_state(review: dict | None, source: dict | None = None, case: dict | None = None,
791
+ code_now: str = "") -> tuple[str, str]:
792
+ """Состояние решения человека по находке SAST для выдачи в Hub и его итог (hub_verdict).
793
+
794
+ "none" – решения нет: принятое решение – непустое допустимое поле decision, а подставленный моделью вердикт
795
+ или один комментарий его не заменяют; "later" – отложено; "missing" – находки нет в текущей выгрузке;
796
+ "changed" – решение принято по другой версии находки (после решения сменились правило, файл, строка, код из
797
+ выгрузки, папка клона или его последняя увиденная ревизия – то, что входит в отпечаток решения finding_sig);
798
+ (новый ответ модели при той же находке и том же коде решение не ослабляет, ADR-0097); "code_changed" – код в клоне уже не тот, который видел
799
+ человек при сохранении решения (его собственные code_hash и code_chars; решение без отпечатка кода тоже не
800
+ доказано); "not_ready" – итог, для которого дефект не готовится (неясно, «Риск принят»); "ok" – итог «истинная»
801
+ или «ложная» по действующему решению.
802
+
803
+ source – снимок находки и источника её кода (case_input): по нему решение сверяется с текущей версией находки;
804
+ без source сверка версии и кода не делается. case – сохранённая привязка находки к вердикту модели. code_now –
805
+ отпечаток кода, который в клоне сейчас, при том же размере среза code_chars, что у решения."""
806
+ if not review or review.get("decision") not in DECISIONS or not review.get("decision"):
807
+ return "none", ""
808
+ if review["decision"] == "later":
809
+ return "later", ""
810
+ outcome = hub_verdict(review["decision"], review["final_verdict"])
811
+ if source is not None:
812
+ if source.get("missing"):
813
+ return "missing", outcome
814
+ if review.get("finding_sig") != source_signature(source):
815
+ return "changed", outcome
816
+ # новый ответ модели при той же находке и том же коде решение не ослабляет (ADR-0097): «verdict_changed» больше не
817
+ # выставляется – находку и код решения сверяют finding_sig и code_hash
818
+ if source is not None and (not review.get("code_hash") or review["code_hash"] != code_now):
819
+ return "code_changed", outcome
820
+ return ("ok" if defect.sast_ready(outcome) else "not_ready"), outcome
821
+
822
+
823
+ def sast_choice(decision: str, final_verdict: str, model_verdict: dict | None, stale_verdict: bool,
824
+ old: dict | None = None, current_verdict_id: int | None = None) -> tuple[str, str]:
825
+ """Два исхода SAST (ADR-0089): «Ложное срабатывание» и «Подтверждаю дефект» приходят как значения false_positive
826
+ и true_positive поля decision; в базе они хранятся прежней парой: «Согласен», если вердикт модели тот же и относится
827
+ к текущему коду, иначе «Не согласен» с итоговым вердиктом. Сохранённое «Не согласен» с тем же исходом по тому же
828
+ ответу модели остаётся «Не согласен»: совпадение итога с моделью не означает согласия с её рекомендацией
829
+ (ADR-0088), и пересохранение не должно подменить общий пункт рекомендацией модели. Пришёл новый ответ модели
830
+ (его показывает карточка) – вид решения определяется заново. Остальные значения – как пришли."""
831
+ if decision in SAST_OUTCOMES:
832
+ if (old and old.get("decision") == "disagree"
833
+ and hub_verdict(old["decision"], old.get("final_verdict") or "") == decision
834
+ and old.get("verdict_id") == current_verdict_id):
835
+ return "disagree", decision
836
+ same = bool(model_verdict) and model_verdict.get("verdict") == decision and not stale_verdict
837
+ return ("agree" if same else "disagree"), decision
838
+ return decision, final_verdict
839
+
840
+
841
+ def sast_outcome(decision: str, final_verdict: str) -> str:
842
+ """Выбранный в карточке исход SAST: false_positive, true_positive, later или "" (решения нет). Прежние итоги
843
+ («неясно», «Риск принят») – как есть: карточка просит выбрать решение заново."""
844
+ if not decision or decision == "later":
845
+ return decision or ""
846
+ if decision in SAST_OUTCOMES: # черновик после отказа: значение кнопки карточки, ещё не переведённое в пару
847
+ return decision
848
+ return hub_verdict(decision, final_verdict)
849
+
850
+
851
+ def sast_state_text(state: str, outcome: str) -> str:
852
+ """Почему дефект не готовится – одной строкой (для списков и журнала)."""
853
+ return {"none": "решения нет", "later": "отложено", "missing": "нет в текущей выгрузке",
854
+ "changed": "решение принято по прежней версии находки",
855
+ "verdict_changed": "вердикт модели, по которому принято решение, уже не текущий",
856
+ "code_changed": "код в клоне изменился после решения",
857
+ "not_ready": ("ложное срабатывание – дефект не создаётся" if outcome == "false_positive"
858
+ else f"прежнее решение «{SAST_OUTCOME_LABELS.get(outcome, outcome)}»")}.get(state, state)
859
+
860
+
861
+ SAST_STATE_HINTS = {
862
+ "missing": "Находки нет в текущей выгрузке: дефект по ней не готовится.",
863
+ "changed": "Решение принято по прежней версии находки: после него сменились правило, файл, строка, код из "
864
+ "выгрузки или папка клона. Сверьте решение и сохраните ещё раз – тогда дефект станет доступен.",
865
+ "verdict_changed": "Вердикт модели, по которому принято решение, уже не текущий (находку разобрали заново или "
866
+ "новый разбор ещё идёт). Сверьте решение с текущим вердиктом и сохраните ещё раз – тогда "
867
+ "дефект станет доступен.",
868
+ "code_changed": "Код в клоне не тот, который вы видели при решении: текст дефекта ссылался бы на прежние "
869
+ "строки. Сверьте решение с текущим кодом и сохраните ещё раз – тогда дефект станет доступен.",
870
+ }
871
+ SAST_BLOCKED_STATES = tuple(SAST_STATE_HINTS)
872
+ # решение записано без отпечатка кода (прежняя версия приложения): «код не тот» было бы неправдой (НТ17)
873
+ SAST_CODE_UNKNOWN = ("При решении отпечаток кода не сохранён (решение записано прежней версией приложения): какой код "
874
+ "вы видели, неизвестно. Сверьте решение с текущим кодом и сохраните ещё раз – тогда дефект станет "
875
+ "доступен.")
876
+
877
+
878
+ def sast_state_hint(state: str, review: dict | None, default: str = "") -> str:
879
+ """Почему дефект не выдаётся – для панели дефекта и отказа выдачи (SAST_STATE_HINTS); у решения без отпечатка
880
+ кода – SAST_CODE_UNKNOWN."""
881
+ if state == "code_changed" and review and not review.get("code_hash"):
882
+ return SAST_CODE_UNKNOWN
883
+ return SAST_STATE_HINTS.get(state, default)
884
+ # Состояния, при которых сохранённый текст для Hub – исторический: решение относится к другому состоянию находки
885
+ SAST_HISTORIC_STATES = ("missing", "changed", "verdict_changed", "code_changed")
886
+
887
+
888
+ class DefectBlocked(ReviewRejected):
889
+ """Дефект не готовится: решение по находке не действует (ответ 409, в том числе в разметке страницы)."""
890
+
891
+
892
+ class DefectReload(DefectBlocked):
893
+ """Дефект не готовится, и открытая карточка устарела: находка, её код, вердикт или само решение изменились после
894
+ открытия – скрипт предлагает обновить карточку (reload)."""
895
+
896
+
897
+ def sast_assess(request: Request, project_id: int, review: dict | None, case: dict | None,
898
+ source: dict | None) -> dict:
899
+ """Состояние решения SAST по одному снимку источника: {state, outcome, use_verdict}. Код читается из клона здесь
900
+ же, при размере среза самого решения; use_verdict – рекомендации модели ("Как исправить") применимы к тексту
901
+ дефекта: вердикт привязан к самому решению (человек его видел) и относится к коду, который в клоне сейчас."""
902
+ if source is None:
903
+ return {"state": "missing", "outcome": "", "use_verdict": False}
904
+ settings, mask_key = settings_of(request), mask_key_of(request)
905
+ hashes: dict[int, str] = {}
906
+
907
+ chars = int((review or {}).get("code_chars") or 0)
908
+
909
+ def code_at(size: int) -> str:
910
+ if size not in hashes:
911
+ hashes[size] = current_code(settings, source, mask_key, size, case=case)[2]
912
+ return hashes[size]
913
+
914
+ # Клона нет – код сейчас это срез из базы (ADR-0072, current_code): решение действует, если принято по нему же
915
+ code_now = code_at(chars) if chars and (review or {}).get("code_hash") else ""
916
+ state, outcome = sast_decision_state(review, source, case, code_now)
917
+ use_verdict = False
918
+ if state == "ok" and case and case.get("verdict_id") and review.get("verdict_id") == case["verdict_id"]:
919
+ case_chars = int((case.get("context") or {}).get("max_chars") or CONTEXT_CHARS)
920
+ use_verdict = code_at(case_chars) == case.get("case_hash")
921
+ return {"state": state, "outcome": outcome, "use_verdict": use_verdict}
922
+
923
+
924
+ def capec_names(store: FeedStore, catalog: dict) -> dict[str, str]:
925
+ """Названия шаблонов атак CAPEC, связанных с классами CWE каталога catalog: общий снимок каталога CAPEC без
926
+ копирования (как на странице CAPEC); каталог не загружен – {}."""
927
+ wanted = {p for info in catalog.values() for p in (info.get("attack_patterns") or [])}
928
+ if not wanted:
929
+ return {}
930
+ with store.snapshot():
931
+ records = (store.capec_data(shared=True) or {}).get("records") or {}
932
+ return {p: str((records.get(p) or {}).get("name") or "") for p in wanted if records.get(p)}
933
+
934
+
935
+ def sast_defect(db: Database, settings, store: FeedStore, project_id: int, f: Finding, review: dict | None,
936
+ verdict: Verdict | None, number: int | None = None, shown: set[int] | None = None,
937
+ state: str = "", source: dict | None = None) -> dict:
938
+ """Дефект для Hub по сохранённому решению SAST: {ready, number, stored, title, body, team, hint, subject,
939
+ warnings, note, state}. ready – решение действует (state "ok"): «Подтверждаю дефект» с обоснованием, решение
940
+ принято по текущей версии находки и текущему коду; ложное срабатывание закрывается комментарием (ADR-0089). Текст –
941
+ исход, обоснование и своя рекомендация оператора (ADR-0092): «Как исправить» модели и вид решения («Согласен»
942
+ или «Не согласен») в него не входят; verdict остался от прежних вызовов. Справки по CWE в тексте нет.
943
+ warnings – ссылки на строки в обосновании и рекомендациях, которых нет в показанном коде shown: такой текст
944
+ копируется только после подтверждения человека."""
945
+ # состояние решения: без него (вызов из старого кода или теста) – только вид решения и итог
946
+ state = state or (("ok" if sast_defect_ready(review) else "none") if review else "none")
947
+ key = defect.defect_key_sast(f.hub_id)
948
+ stored = db.defect_number(project_id, key)
949
+ saved_number = stored # номер в базе как есть: форма сверяет с ним выдачу (number_shown, Б9)
950
+ # та же строка, категория и тот же код в другой кодовой базе уже получили номер – это тот же дефект (ADR-0092)
951
+ mine_cmp = own_code_cmp(db, project_id, f.hub_id)
952
+ all_rows = db.group_rows(project_id, group_key(f), f.hub_id)
953
+ rows, foreign = number_rows(all_rows, mine_cmp, stored, db.defect_assigned_at(project_id, key), f.hub_id)
954
+ foreign_own = stored if stored is not None and stored in foreign else None
955
+ if foreign_own is not None: # прежний номер находки теперь принадлежит находкам с другим кодом (ADR-0092 п. 8)
956
+ stored = None
957
+ merge = db.group_merge(project_id, group_key(f)) # группа слилась при обновлении схемы (ADR-0095 п. 4)
958
+ if merge:
959
+ plan = merged_number_plan(merged_members(all_rows, mine_cmp, f.hub_id, stored, foreign), f.hub_id,
960
+ merge["numbers"], None)
961
+ plan = (plan[0], plan[1], " ".join(x for x in (MERGE_NOTICE.format(date=fmt_ts(merge["merged_at"])),
962
+ plan[2]) if x))
963
+ else:
964
+ plan = group_number_plan(rows, None, stored)
965
+ sibling = plan[0]
966
+ number = number or sibling or db.next_defect_number(project_id)
967
+ outcome_now = hub_verdict(review["decision"], review["final_verdict"]) if review and review.get("decision") else ""
968
+ result = {"ready": state == "ok", "number": number, "stored": stored is not None, "title": "",
969
+ "body": "", "needs_team": not settings.team_name, "subject": "находки", "warnings": [], "note": "",
970
+ "state": state, "sibling_number": sibling if sibling is not None and sibling != stored else None,
971
+ "saved_number": saved_number, "merge_split": bool(merge and plan[2] and "могли быть два дефекта" in plan[2]),
972
+ "group_note": " ".join(x for x in (plan[2], FOREIGN_NUMBER.format(n=foreign_own)
973
+ if foreign_own is not None else "") if x),
974
+ "hint": sast_state_hint(state, review,
975
+ "Ложное срабатывание закрывается коротким комментарием в Hub, дефект не создаётся."
976
+ if outcome_now == "false_positive" else
977
+ "Дефект – только для решения «Подтверждаю дефект»: обоснование и рекомендация – ваши, "
978
+ "рекомендацию модели можно взять за основу.")}
979
+ # ложное срабатывание с номером, оставшимся от прежней выдачи текста, и без дефекта в приложении – номер можно снять:
980
+ # дефект не создаётся, а номер занимает чужой заголовок Hub (db.release_defect_number)
981
+ result["can_release"] = (saved_number is not None and outcome_now == "false_positive"
982
+ and db.hub_defect_bound(project_id, f.hub_id) is None)
983
+ if result["ready"] and not defect.reason_text(review.get("final_comment") or ""):
984
+ # прежнее решение без обоснования: в Hub ушло бы «Обоснование: Нет информации» (ADR-0089)
985
+ result["ready"] = False
986
+ result["state"] = "no_reason"
987
+ result["hint"] = DEFECT_NEEDS_REASON
988
+ if result["ready"] and not str(settings.team_name or "").strip():
989
+ # стандартная фраза команды – с названием (ADR-0092 п. 11)
990
+ result["ready"] = False
991
+ result["state"] = "no_team"
992
+ result["hint"] = DEFECT_NEEDS_TEAM
993
+ if result["ready"] and not defect.has_recommendation(str(review.get("final_fix") or "")):
994
+ # решение без своей рекомендации (в том числе прежнее «Согласен»): кода модели и общего пункта в Hub нет
995
+ result["ready"] = False
996
+ result["state"] = "no_fix"
997
+ result["hint"] = DEFECT_NEEDS_FIX
998
+ if result["ready"]:
999
+ outcome = hub_verdict(review["decision"], review["final_verdict"])
1000
+ fix = str(review.get("final_fix") or "") # рекомендация – только своими словами оператора (ADR-0092)
1001
+ result["title"] = defect.sast_title(number, f)
1002
+ result["body"] = defect.sast_body(f, outcome, review["final_comment"], fix, settings.team_name)
1003
+ result["warnings"] = line_warnings(review["final_comment"], fix, shown)
1004
+ return result
1005
+
1006
+
1007
+ def defect_view(view: dict, review: dict | None, origin: str) -> dict:
1008
+ """Дефект для карточки: comment_check – обоснование сохранённого решения написано моделью к другому вердикту и не
1009
+ проверено: полный текст в карточке не показывается (выдаётся по отметке «Текст проверен», R092-02);
1010
+ review_revision – редакция решения, к которой относится отметка."""
1011
+ target = hub_verdict(review["decision"], review["final_verdict"]) if review and review.get("decision") else ""
1012
+ view["comment_check"] = bool(view.get("ready") and origin and origin != target)
1013
+ view["comment_others"] = []
1014
+ view["review_revision"] = int((review or {}).get("revision") or 0)
1015
+ return view
1016
+
1017
+
1018
+ def defect_form_problems(db: Database, settings, project_id: int, view: dict) -> dict:
1019
+ """Панель «Дефект для Hub» (ручной путь): текст не по требованиям команды – предупреждение с перечнем
1020
+ (form_problems), без запрета копирования (ADR-0123 п. 5). Не warnings: те требуют «Предупреждения проверены»."""
1021
+ view["form_problems"] = (hub_defect_routes.sast_text_problems(db, settings, project_id, view["body"])
1022
+ if view.get("ready") and view.get("body") else [])
1023
+ return view
1024
+
1025
+
1026
+ DEFECT_CONFIRM = "Есть спорные места – проверьте и отметьте «Предупреждения проверены», затем скопируйте ещё раз."
1027
+
1028
+
1029
+ class DefectNeedsConfirm(ValueError):
1030
+ """Текст дефекта со спорными местами: копируется только после явного подтверждения человека (confirm=1)."""
1031
+
1032
+ def __init__(self, warnings: list[str]) -> None:
1033
+ self.warnings = list(warnings)
1034
+ super().__init__(DEFECT_CONFIRM + " " + " ".join(self.warnings))
1035
+
1036
+
1037
+ def defect_error_response(e: ValueError, rejected: type) -> JSONResponse:
1038
+ """Ответ JSON на отказ выдать дефект: спорные места – 409 с reason=confirm и списком; решение не готово – 409;
1039
+ неверный номер – 400."""
1040
+ if isinstance(e, DefectNeedsConfirm):
1041
+ return JSONResponse({"ok": False, "detail": str(e), "reason": "confirm", "warnings": e.warnings},
1042
+ status_code=409)
1043
+ if isinstance(e, DefectReload): # карточка устарела: её нужно обновить
1044
+ return JSONResponse({"ok": False, "detail": str(e), "reload": True}, status_code=409)
1045
+ return JSONResponse({"ok": False, "detail": str(e)}, status_code=409 if isinstance(e, rejected) else 400)
1046
+
1047
+
1048
+ def row_effective(row: dict) -> tuple:
1049
+ """Итоговый текст решения находки группы (строка group_rows/group_siblings): обоснование и своя рекомендация
1050
+ (ADR-0092 – «Как исправить» модели в текст не подставляется)."""
1051
+ outcome = hub_verdict(row["decision"], row["final_verdict"])
1052
+ return defect.sast_effective(outcome, row.get("final_comment") or "", row.get("final_fix") or "")
1053
+
1054
+
1055
+ def group_conflict_rows(rows: list[dict], mine: tuple) -> str:
1056
+ """Находки той же строки и категории (ADR-0089) – в Hub один дефект или одно решение: итоговое решение и итоговый
1057
+ текст (обоснование, у дефекта – и пункты рекомендации, после нормализации) должны совпадать. Сравниваются находки
1058
+ текущей выгрузки с действующим решением. mine – defect.sast_effective этой находки. Пояснение для отказа или ""."""
1059
+ differ, other = [], []
1060
+ for row in rows:
1061
+ if row.get("missing") or row.get("decision") not in ("agree", "disagree"):
1062
+ continue
1063
+ theirs = row_effective(row)
1064
+ if theirs[0] != mine[0]:
1065
+ other.append(row["hub_id"])
1066
+ elif theirs != mine:
1067
+ differ.append(row["hub_id"])
1068
+ if not (differ or other):
1069
+ return ""
1070
+ parts = []
1071
+ if other:
1072
+ parts.append(f"другое решение – у {', '.join(other[:5])}{' и других' if len(other) > 5 else ''}")
1073
+ if differ:
1074
+ parts.append(f"другой текст – у {', '.join(differ[:5])}{' и других' if len(differ) > 5 else ''}")
1075
+ return ("Та же строка и та же категория – в Hub один дефект или одно решение, решение и текст должны совпадать: "
1076
+ + "; ".join(parts) + ". Возьмите решение и текст соседней находки (кнопка в карточке) или поправьте её.")
1077
+
1078
+
1079
+ def same_code(rows: list[dict], mine_cmp: str) -> list[dict]:
1080
+ """Подгруппа одинакового кода (ADR-0092, п. 3): соседи с тем же отпечатком сравнения code_cmp; находки без
1081
+ достоверного отпечатка (пусто) – своя подгруппа «код не сравнивался»."""
1082
+ return [r for r in rows if str(r.get("code_cmp") or "") == (mine_cmp or "")]
1083
+
1084
+
1085
+ def own_code_cmp(db: Database, project_id: int, hub_id: str) -> str:
1086
+ """Отпечаток сравнения кода самой находки (cases.code_cmp) или "" – среза нет или сравнение недостоверно."""
1087
+ return str((db.get_case(project_id, hub_id) or {}).get("code_cmp") or "")
1088
+
1089
+
1090
+ def sibling_states(request: Request, db: Database, project_id: int, rows: list[dict]) -> dict[str, tuple]:
1091
+ """Состояние решений соседей той же оценкой, что у своей карточки (ADR-0092, п. 5; sast_assess: версия находки,
1092
+ текущий код, при «Согласен» – привязанный вердикт): {hub_id: (state, редакция решения, code_cmp)}. Считается до
1093
+ транзакции записи (читает клоны); в транзакции сверяется, что редакции и отпечатки соседей те же."""
1094
+ out: dict[str, tuple] = {}
1095
+ for r in rows:
1096
+ if r.get("missing") or r.get("decision") not in ("agree", "disagree"):
1097
+ continue
1098
+ hub_id = r["hub_id"]
1099
+ review, case = db.get_review(project_id, hub_id), db.get_case(project_id, hub_id)
1100
+ source = db.case_input(project_id, hub_id)
1101
+ assessed = sast_assess(request, project_id, review, case, source)
1102
+ # действующее – по текущей версии находки, коду и вердикту, с исходом SAST и с обоснованием (ADR-0092 п. 5)
1103
+ if assessed["state"] in ("ok", "not_ready") and assessed["outcome"] in SAST_OUTCOMES:
1104
+ state = "ok" if defect.reason_text((review or {}).get("final_comment") or "") else "no_reason"
1105
+ else:
1106
+ state = assessed["state"]
1107
+ # отпечаток – из тех же прочитанных данных, по которым считалась оценка
1108
+ seen = {**r, "revision": (review or {}).get("revision") or 0, "code_cmp": (case or {}).get("code_cmp") or "",
1109
+ "case_hash": (case or {}).get("case_hash") or "", "case_verdict_id": (case or {}).get("verdict_id"),
1110
+ "review_verdict_id": (review or {}).get("verdict_id"),
1111
+ "finding_sig": (review or {}).get("finding_sig") or ""}
1112
+ out[hub_id] = (state, *state_print(seen, source_sig(source)))
1113
+ return out
1114
+
1115
+
1116
+ def source_sig(source: dict | None) -> str:
1117
+ """Текущая версия находки и источника её кода (source_signature) или ""."""
1118
+ return source_signature(source) if source else ""
1119
+
1120
+
1121
+ def state_print(row: dict, current_source: str = "") -> tuple:
1122
+ """Что определяет оценку соседа: редакция решения, отпечатки кода и среза, привязка вердикта, версия находки, по
1123
+ которой принято решение, и текущая версия находки и источника её кода."""
1124
+ return (int(row.get("revision") or 0), str(row.get("code_cmp") or ""), str(row.get("case_hash") or ""),
1125
+ row.get("case_verdict_id"), row.get("review_verdict_id"), str(row.get("finding_sig") or ""),
1126
+ current_source)
1127
+
1128
+
1129
+ GROUP_MOVED = ("Находка с той же строкой и категорией изменилась, пока вы работали с карточкой (решение, код или ответ "
1130
+ "модели): обновите карточку и повторите.")
1131
+
1132
+
1133
+ def current_rows(rows: list[dict], states: dict[str, tuple],
1134
+ source_of: Callable[[str], str] | None = None) -> list[dict]:
1135
+ """Решения подгруппы, с которыми сверяется своё (ADR-0092, п. 5): все решения «ложное срабатывание» и «дефект»,
1136
+ кроме тех, что оценка states признала недействующими (другая версия находки, другой код, другой вердикт) и что с
1137
+ оценки не менялись. Соседку, решение которой появилось или изменилось после оценки (её не оценивали в этом
1138
+ снимке), проверка в транзакции сравнивает – как раньше: устаревшим её назвать нельзя. Соседка, которую оценили, а
1139
+ с тех пор у неё сменились решение, код, срез, привязка вердикта или версия находки, – отказ GROUP_MOVED."""
1140
+ keep = []
1141
+ for r in rows:
1142
+ if r.get("missing") or r.get("decision") not in ("agree", "disagree"):
1143
+ continue
1144
+ st = states.get(r["hub_id"])
1145
+ if st is None: # решение появилось после оценки: сравнивается, устаревшим его назвать нельзя
1146
+ keep.append(r)
1147
+ continue
1148
+ now = state_print(r, source_of(r["hub_id"]) if source_of else st[-1])
1149
+ if tuple(st[1:]) != now: # оценённое состояние изменилось – оценка недействительна
1150
+ raise ReviewRejected(GROUP_MOVED)
1151
+ if st[0] == "ok":
1152
+ keep.append(r)
1153
+ return keep
1154
+
1155
+
1156
+ def number_rows(rows: list[dict], mine_cmp: str, own: int | None,
1157
+ own_at: str = "", own_hub: str = "") -> tuple[list[dict], set[int]]:
1158
+ """Строки для плана номера подгруппы (ADR-0092, пп. 7–8) и номера, которые принадлежат другим подгруппам. Номер
1159
+ принадлежит подгруппе, где его держит больше находок (с этой находкой, если own – её номер); при равенстве –
1160
+ подгруппе находки, получившей его раньше всех. Номера других подгрупп в план не входят."""
1161
+ holders: dict[int, dict[str, list]] = {} # номер -> подгруппа -> [держателей, раньше всех, наименьший номер Hub]
1162
+ for r in rows:
1163
+ if r.get("defect_number") is not None:
1164
+ entry = holders.setdefault(int(r["defect_number"]), {}).setdefault(str(r.get("code_cmp") or ""),
1165
+ [0, "~", "~"])
1166
+ entry[0] += 1
1167
+ entry[1] = min(entry[1], str(r.get("defect_at") or "~"))
1168
+ entry[2] = min(entry[2], str(r.get("hub_id") or "~"))
1169
+ if own is not None:
1170
+ entry = holders.setdefault(int(own), {}).setdefault(mine_cmp or "", [0, "~", "~"])
1171
+ entry[0] += 1
1172
+ entry[1] = min(entry[1], own_at or "~")
1173
+ entry[2] = min(entry[2], own_hub or "~")
1174
+ foreign = set()
1175
+ for number, by_cmp in holders.items():
1176
+ # одинаково из любой карточки: больше держателей, затем раньше получен, затем наименьший номер находки Hub
1177
+ owner = min(by_cmp, key=lambda k: (-by_cmp[k][0], by_cmp[k][1], by_cmp[k][2], k))
1178
+ if owner != (mine_cmp or ""):
1179
+ foreign.add(number)
1180
+ mine = [r for r in same_code(rows, mine_cmp)
1181
+ if r.get("defect_number") is None or int(r["defect_number"]) not in foreign]
1182
+ return mine, foreign
1183
+
1184
+
1185
+ FOREIGN_NUMBER = ("Номер ID{n} принадлежит находкам той же строки и категории с другим кодом: в Hub это другой "
1186
+ "дефект. Выдайте дефект с новым номером.")
1187
+
1188
+
1189
+ def group_conflict(db: Database, project_id: int, f: Finding, outcome: str, comment: str, fix: str) -> str:
1190
+ """group_conflict_rows по текущему состоянию группы; fix – рекомендация, которая уйдёт в текст этой находки."""
1191
+ mine = defect.sast_effective(outcome, comment, fix)
1192
+ return group_conflict_rows(db.group_rows(project_id, group_key(f), f.hub_id), mine)
1193
+
1194
+
1195
+ def sibling_take_fix(row: dict) -> str:
1196
+ """Рекомендация для «Взять решение и текст»: своя рекомендация соседки (ADR-0092); у ложного срабатывания
1197
+ рекомендации нет."""
1198
+ if hub_verdict(row.get("decision") or "", row.get("final_verdict") or "") != "true_positive":
1199
+ return ""
1200
+ return row.get("final_fix") or ""
1201
+
1202
+
1203
+ def group_take_all(siblings: list[dict], total: int) -> dict | None:
1204
+ """«Взять решение и текст у всех» (ADR-0090): показана вся группа (total – число других находок группы), у каждой
1205
+ действующее решение «ложное срабатывание» или «дефект» с обоснованием, и итоговые тексты совпадают так же, как их
1206
+ сравнивает выдача дефекта (row_effective). Иначе None."""
1207
+ if len(siblings) < 2 or len(siblings) != total:
1208
+ return None
1209
+ for s in siblings:
1210
+ if (s.get("decision") not in ("agree", "disagree") or not (s.get("final_comment") or "").strip()
1211
+ or hub_verdict(s["decision"], s.get("final_verdict") or "") not in SAST_OUTCOMES):
1212
+ return None
1213
+ if len({row_effective(s) for s in siblings}) != 1:
1214
+ return None
1215
+ first = siblings[0]
1216
+ return {"outcome": hub_verdict(first["decision"], first.get("final_verdict") or ""),
1217
+ "comment": first.get("final_comment") or "", "fix": sibling_take_fix(first)}
1218
+
1219
+
1220
+ def group_number_plan(rows: list[dict], requested: int | None,
1221
+ own: int | None = None) -> tuple[int | None, str, str]:
1222
+ """Номер дефекта группы (ADR-0089): (номер, отказ, пометка). rows – остальные находки группы, в том числе
1223
+ пропавшие из выгрузки; own – номер, уже сохранённый у этой находки. Пока номера нет ни у одной другой находки
1224
+ группы, номер этой находки свободен. Иначе номер группы один: самый частый по всей группе вместе с этой находкой
1225
+ (при равенстве – меньший), и выдача допускает только его – так разные номера сходятся к одному. Если в группе
1226
+ разные номера, пометка называет, где выдать дефект заново."""
1227
+ counts: dict[int, int] = {}
1228
+ owners: dict[int, list[str]] = {}
1229
+ for row in rows:
1230
+ if row.get("defect_number") is not None:
1231
+ n = int(row["defect_number"])
1232
+ counts[n] = counts.get(n, 0) + 1
1233
+ owners.setdefault(n, []).append(row["hub_id"])
1234
+ if not counts:
1235
+ return (requested if requested is not None else own), "", ""
1236
+ if own is not None:
1237
+ counts[own] = counts.get(own, 0) + 1
1238
+ owners.setdefault(own, []).append("эта находка")
1239
+ canonical = max(counts, key=lambda n: (counts[n], -n))
1240
+ note = ""
1241
+ if len(counts) > 1:
1242
+ note = ("У находок той же строки и категории разные номера дефекта: "
1243
+ + "; ".join(f"ID{n} – {', '.join(owners[n][:5])}" for n in sorted(counts))
1244
+ + f". В Hub это один дефект: выдайте его заново с номером ID{canonical} там, где номер другой.")
1245
+ if requested is None or requested == canonical:
1246
+ return canonical, "", note
1247
+ return None, (f"У находок той же строки и категории номер дефекта ID{canonical}: в Hub это один дефект. "
1248
+ f"Укажите ID{canonical}."), note
1249
+
1250
+
1251
+ MERGE_NOTICE = ("Группа объединена при обновлении приложения {date}: раньше это были разные группы. Номера дефектов "
1252
+ "не сводились.")
1253
+
1254
+
1255
+ def merged_number_plan(members: list[dict], own_hub_id: str, history: list[int],
1256
+ requested: int | None) -> tuple[int | None, str, str]:
1257
+ """Номер дефекта подгруппы группы, слившейся при обновлении схемы (ADR-0095 п. 4): (номер, отказ, предупреждение).
1258
+
1259
+ members – все участники подгруппы вместе с текущей находкой (own_hub_id) ровно один раз: {hub_id, number}; номер,
1260
+ принадлежащий другой подгруппе, сюда уже не передан. history – номера группы на момент слияния. Если подгруппа
1261
+ держит два исторических номера и больше – номера не сводятся: допустимы только они, предлагается собственный
1262
+ номер находки, иначе самый частый (при равенстве – меньший). Иначе – обычное правило по тому же полному составу:
1263
+ номеров нет – номер свободен; есть – допустим только самый частый (при равенстве – меньший)."""
1264
+ counts: dict[int, int] = {}
1265
+ owners: dict[int, list[str]] = {}
1266
+ own = None
1267
+ for m in members:
1268
+ if m.get("number") is None:
1269
+ continue
1270
+ n = int(m["number"])
1271
+ counts[n] = counts.get(n, 0) + 1
1272
+ owners.setdefault(n, []).append("эта находка" if m.get("hub_id") == own_hub_id else str(m.get("hub_id")))
1273
+ if m.get("hub_id") == own_hub_id:
1274
+ own = n
1275
+ kept = sorted(set(counts) & {int(x) for x in history})
1276
+ if len(kept) >= 2:
1277
+ proposed = own if own in kept else max(kept, key=lambda n: (counts[n], -n))
1278
+ warning = ("В Hub могли быть два дефекта – " + "; ".join(f"ID{n} ({', '.join(owners[n])})" for n in kept)
1279
+ + ". Оставьте номер, под которым находка уже заведена в Hub.")
1280
+ if requested is None or requested in kept:
1281
+ return (proposed if requested is None else requested), "", warning
1282
+ return None, ("В этой группе после обновления приложения номера " + ", ".join(f"ID{n}" for n in kept)
1283
+ + ": выберите один из них."), warning
1284
+ if not counts:
1285
+ return requested, "", ""
1286
+ canonical = max(counts, key=lambda n: (counts[n], -n))
1287
+ if requested is None or requested == canonical:
1288
+ return canonical, "", ""
1289
+ return None, (f"У находок той же строки и категории номер дефекта ID{canonical}: в Hub это один дефект. "
1290
+ f"Укажите ID{canonical}."), ""
1291
+
1292
+
1293
+ def merged_members(rows: list[dict], mine_cmp: str, own_hub_id: str, own: int | None,
1294
+ foreign: set[int]) -> list[dict]:
1295
+ """Участники подгруппы для merged_number_plan: соседи с тем же кодом и текущая находка; номер другой подгруппы –
1296
+ без номера (ADR-0095 п. 4)."""
1297
+ members = [{"hub_id": r["hub_id"], "number": None if r.get("defect_number") is None
1298
+ or int(r["defect_number"]) in foreign else int(r["defect_number"])}
1299
+ for r in same_code(rows, mine_cmp)]
1300
+ members.append({"hub_id": own_hub_id, "number": None if own is None or own in foreign else own})
1301
+ return members
1302
+
1303
+
1304
+ def sast_entered_text(db: Database, settings, project_id: int, f: Finding, review: dict | None) -> str:
1305
+ """Текст, который подтверждает отметка «Внесено в Hub» по находке SAST: у подтверждённого дефекта – тело дефекта
1306
+ (команда, обоснование, рекомендация: смена любой части – уже другой текст в Hub), у остальных – текст для Hub по
1307
+ сохранённому решению (saved_hub_text)."""
1308
+ if not review or not review.get("decision"):
1309
+ return ""
1310
+ outcome = hub_verdict(review["decision"], review["final_verdict"])
1311
+ if f.kind != "SAST" or not defect.sast_ready(outcome):
1312
+ return saved_hub_text(f, review, settings.hub_status_map)
1313
+ fix = str(review.get("final_fix") or "")
1314
+ if not defect.has_recommendation(fix): # без своей рекомендации текста дефекта нет (ADR-0092)
1315
+ return ""
1316
+ return defect.sast_body(f, outcome, review["final_comment"], fix, settings.team_name)
1317
+
1318
+
1319
+ def sast_defect_ready(review: dict | None) -> bool:
1320
+ """По сохранённому решению SAST можно готовить дефект: решение есть, итог – «истинная» (ADR-0089)."""
1321
+ return bool(review and review.get("decision") in DECISIONS and review.get("decision")
1322
+ and defect.sast_ready(hub_verdict(review["decision"], review["final_verdict"])))
1323
+
1324
+
1325
+ def defect_ready(review: dict | None) -> bool:
1326
+ """По сохранённому решению можно готовить дефект: решение есть, итог – «истинная» или «ложная»."""
1327
+ return bool(review and review.get("decision") in DECISIONS and review.get("decision")
1328
+ and defect.ready(hub_verdict(review["decision"], review["final_verdict"])))
1329
+
1330
+
1331
+ def pending_run_for(db: Database, project_id: int, hub_id: str) -> dict | None:
1332
+ """Незавершённый прогон, в очереди которого эта находка ещё ждёт разбора: {id, state, model} или None."""
1333
+ for run in db.active_runs(project_id):
1334
+ if hub_id in db.pending_hub_ids(run["id"]):
1335
+ return {"id": run["id"], "state": run["state"], "model": run["model"]}
1336
+ return None
1337
+
1338
+
1339
+ def question_view(q: dict, verdict_id: Any) -> dict:
1340
+ """Вопрос к модели для карточки и для ответа JSON: текст ответа – как есть (оформляет шаблон или скрипт)."""
1341
+ stats = q.get("stats") or {}
1342
+ data = q.get("answer_data") or {}
1343
+ return {"id": q["id"], "question": q.get("question") or "", "answer": q.get("answer") or "",
1344
+ "state": q.get("state") or "", "error": q.get("error") or "", "model": q.get("model") or "",
1345
+ "created_at": q.get("created_at") or "", "answered_at": q.get("answered_at") or "",
1346
+ "verdict_changes": str(data.get("verdict_changes") or ""),
1347
+ "tps": stats.get("eval_tps") or None, "seconds": stats.get("total_s") or None,
1348
+ "tokens": stats.get("output_tokens") or None, "attempts": stats.get("attempts") or None,
1349
+ "old": verdict_id is None or q.get("verdict_id") != verdict_id}
1350
+
1351
+
1352
+ def finding_view(request: Request, project: dict, row: dict, selection: dict[str, str],
1353
+ draft: dict | None = None, ask_draft: str = "") -> dict:
1354
+ db = db_of(request)
1355
+ settings = settings_of(request)
1356
+ pid = project["id"]
1357
+ mask_key = mask_key_of(request)
1358
+ # Находка и папка с её кодом – одним снимком (их могут поменять параллельно): из него строятся и срез,
1359
+ # и версия формы, поэтому решение по показанному коду не сохранится, если источник с тех пор сменился.
1360
+ source = db.case_input(pid, row["hub_id"]) or {
1361
+ "data": row["data"], "repos_dir": project.get("repos_dir") or "", "folder": ""}
1362
+ f = Finding.from_dict(source["data"])
1363
+ case = db.get_case(pid, f.hub_id)
1364
+ verdict_row = case["verdict"] if case else None
1365
+ ctx: CodeContext | None = None
1366
+ current_ctx: CodeContext | None = None # срез текущего клона, когда он сверяется со срезом разбора
1367
+ model_ctx: CodeContext | None = None
1368
+ stored: dict = {}
1369
+ code_changed = False
1370
+ # Отпечаток кода, который сейчас в клоне (code_hash, с размером среза code_chars): уходит с формой решения,
1371
+ # и решение не сохранится, если к моменту сохранения код снова изменился
1372
+ code_hash, code_chars = "", 0
1373
+ repo_dir, why = repo_dir_for(settings, {"repos_dir": source["repos_dir"]}, source_codebases(source, f), f)
1374
+ # Клона (или файла в нём) нет, а срез сохранён в базе – код находки берётся из базы и не сверяется (ADR-0072)
1375
+ snapshot = snapshot_code(settings, source, case) if f.kind == "SAST" else None
1376
+ if case and verdict_row:
1377
+ stored = case["context"]
1378
+ ctx = model_ctx = CodeContext.from_dict(stored) # ровно то, что видела модель
1379
+ # Код в клоне мог измениться после разбора (правки в рабочей копии без смены ревизии): тогда вердикт
1380
+ # относится к прежнему коду – карточка предупреждает, а «Проверено» не ставится, пока код не разобран заново
1381
+ code_chars = int(stored.get("max_chars") or CONTEXT_CHARS)
1382
+ if snapshot is not None:
1383
+ code_hash = snapshot[1]
1384
+ else:
1385
+ current_ctx = build_context(repo_dir, f, max_chars=code_chars, mask_key=mask_key, no_repo_note=why)
1386
+ code_hash = case_hash(f, current_ctx)
1387
+ code_changed = code_hash != case["case_hash"]
1388
+ elif f.kind == "SAST" and snapshot is not None:
1389
+ stored = case["context"]
1390
+ ctx = snapshot[0]
1391
+ code_chars = int(stored.get("max_chars") or CONTEXT_CHARS)
1392
+ code_hash = snapshot[1]
1393
+ elif f.kind == "SAST":
1394
+ code_chars = CONTEXT_CHARS
1395
+ ctx = build_context(repo_dir, f, max_chars=code_chars, mask_key=mask_key, no_repo_note=why)
1396
+ code_hash = case_hash(f, ctx)
1397
+ # Текст, похожий на указания для модели: сохранён вместе со срезом при прогоне; карточка без вердикта
1398
+ # (или срез прежней версии) – считается здесь же
1399
+ steer_lines: list[int] = []
1400
+ steer_fields: list[str] = []
1401
+ if ctx is not None:
1402
+ ctx = export_fragment_view(f, ctx) # только представление: отпечатки выше посчитаны по исходному срезу
1403
+ steer_lines, steer_fields = steering_of(f, stored, ctx)
1404
+ steering = bool(steer_lines or steer_fields)
1405
+ verdict = Verdict.from_dict(verdict_row["data"]) if verdict_row else None
1406
+ evidence = set(verdict.evidence_lines) if verdict else set()
1407
+ # строка, где нашёлся фрагмент из выгрузки (рядом, в комментарии или частично), – своя подсветка; при совпадении
1408
+ # на строке срабатывания подсвечена она сама
1409
+ # окно показа до 400 строк из клона (ADR-0087): только если оно совпадает с окном модели; отпечатки, сверка и
1410
+ # ответ модели – по окну модели
1411
+ wide = (display_context(repo_dir, f, ctx, mask_key=mask_key, no_repo_note=why)
1412
+ if f.kind == "SAST" and snapshot is None and ctx is not None and not code_changed else None)
1413
+ display = wide.ctx if wide is not None else None
1414
+ # фрагмент найден дальше ±5 в показанном коде – только для показа: модель разбирала окно вокруг строки сканера
1415
+ export_shift_at = None
1416
+ if wide is not None:
1417
+ export_shift_at = export_fragment_shift(f, display, wide.code)
1418
+ elif ctx is not None and ctx.export_line_check == "differs" and not code_changed:
1419
+ # код после разбора не менялся. Клон есть – исполняемый код строк по разбору текущего файла с начала; срез
1420
+ # из базы без клона – по разбору самого среза, без строк со скрытыми значениями (ограничение ADR-0087)
1421
+ code_lines = shift_code_lines(repo_dir, ctx) if snapshot is None else window_code_lines(ctx)
1422
+ export_shift_at = export_fragment_shift(f, ctx, code_lines)
1423
+ export_at = (ctx.export_line_at if ctx and ctx.export_line_check in ("near", "commented", "partial")
1424
+ else export_shift_at)
1425
+ seen = {n for n, _, _ in (ctx.rows() if ctx else []) if n} # строки, которые видела модель
1426
+ # указания и невидимые знаки в строках, которых модель не видела: только подсветка и пояснение – на подстановку
1427
+ # её комментария (steering) они не влияют
1428
+ steer_outside = sorted(set(steering_lines(display)) - seen) if display is not None else []
1429
+ invis_outside = sorted(set(invisible_lines(display)) - seen) if display is not None else []
1430
+ code_rows = [{"n": n, "text": text, "target": target, "evidence": bool(n) and n in evidence,
1431
+ "export": bool(n) and n == export_at,
1432
+ "steering": bool(n) and (n in steer_lines or n in steer_outside),
1433
+ "outside": display is not None and n not in seen}
1434
+ for n, text, target in ((display or ctx).rows() if ctx else [])]
1435
+ # ссылки на строки в ответе модели и комментарии – по окну модели: строк вне его модель не видела
1436
+ shown = set(seen)
1437
+ # Под влиянием указаний в коде модель могла написать что угодно: её комментарий не подставляется
1438
+ model_comment = verdict.hub_comment if verdict and not steering else ""
1439
+ model_comment_for = model_comment_verdict(model_comment, verdict.verdict) if model_comment else ""
1440
+ review = db.get_review(pid, f.hub_id)
1441
+ assessment = sast_assess(request, pid, review, case, source) if f.kind == "SAST" else \
1442
+ {"state": "ok" if defect_ready(review) else "none", "outcome": "", "use_verdict": False}
1443
+ reviewed_checked = bool(review and review["reviewed"])
1444
+ # рекомендация модели – только основа для кнопки «Взять пункты из рекомендации модели» (ADR-0092): поле само не
1445
+ # заполняется, переносятся пункты словами без кода; под влиянием указаний в коде – нет
1446
+ model_fix = verdict.fix if verdict and not steering else ""
1447
+ # заготовка из ответа модели – с прежней чисткой (ADR-0101: правила заготовок); утверждённые оператором пункты
1448
+ # уходят в Hub как написаны
1449
+ model_points, model_code_dropped = defect.recommendation_points(model_fix, clean=True)
1450
+ if draft is not None: # решение не сохранилось (страница устарела): форма – с тем, что ввёл человек
1451
+ decision, final_verdict, comment = draft["decision"], draft["final_verdict"], draft["comment"]
1452
+ final_fix = str(draft.get("fix") or "")
1453
+ reviewed_checked = bool(draft["reviewed"])
1454
+ elif review is not None:
1455
+ decision, final_verdict, comment = review["decision"], review["final_verdict"], review["final_comment"]
1456
+ final_fix = str(review.get("final_fix") or "")
1457
+ # у SAST исход выбирает человек (ADR-0089, ADR-0097): форма показывает сохранённый итог, новый ответ модели
1458
+ # его не меняет; у SCA «Согласен» – это текущий вывод
1459
+ if decision == "agree" and verdict and f.kind != "SAST":
1460
+ final_verdict = verdict.verdict
1461
+ else:
1462
+ decision, final_verdict = "", verdict.verdict if verdict else ""
1463
+ # в заготовку – только текст, который подходит к вердикту модели; к другому исходу его подставит выбор этого исхода (app.js)
1464
+ comment = model_comment if verdict and model_comment_for == verdict.verdict else ""
1465
+ final_fix = ""
1466
+ preview = hub_text(f, hub_verdict(decision, final_verdict), comment, settings.hub_status_map)
1467
+ if draft is None and review and review.get("decision"): # ровно тот текст, что подтверждает отметка «внесено»
1468
+ preview = saved_hub_text(f, review, settings.hub_status_map)
1469
+ # Комментарий модели к другому вердикту (смена итогового вердикта, отложено, новый разбор): поле подсвечено,
1470
+ # копирование для Hub требует правки или явного подтверждения. «Согласен» – это вердикт модели, даже если
1471
+ # в сохранённом решении стоит прежний
1472
+ known_verdicts = db.finding_verdicts(pid, f.hub_id) # Э6: одна выборка на обе сверки комментария
1473
+ comment_for = comment_origin(db, case, review, comment, known=known_verdicts)
1474
+ # Два признака «комментарий модели к другому вердикту». Для формы – по тому, что уйдёт при сохранении как есть
1475
+ # («Согласен» у SCA – это текущий вердикт, у SAST – сохранённый исход). Для предпросмотра и отметки «внесено» – по
1476
+ # сохранённому решению: именно его текст подтверждает отметка; у черновика и формы без решения они совпадают
1477
+ effective = verdict.verdict if decision == "agree" and verdict and f.kind != "SAST" else final_verdict
1478
+ comment_stale = bool(comment_for) and comment_for != hub_verdict(decision, effective)
1479
+ if draft is None and review and review.get("decision"):
1480
+ saved_stale = bool(comment_for) and comment_for != hub_verdict(review["decision"], review["final_verdict"])
1481
+ else:
1482
+ saved_stale = comment_stale
1483
+ # Предпросмотр – только текст, который можно нести в Hub (ADR-0088): без решения или с обоснованием модели к другому
1484
+ # вердикту вместо текста – пояснение (сам текст даёт только копирование после решения или отметки «Текст проверен»)
1485
+ preview_note = ""
1486
+ if draft is not None:
1487
+ preview_note = "Решение не сохранено: текст появится после сохранения."
1488
+ preview = ""
1489
+ elif not decision:
1490
+ preview_note = "Текст появится после выбора и сохранения решения: без решения ответ модели в Hub не уходит."
1491
+ preview = ""
1492
+ elif saved_stale:
1493
+ preview_note = ("Текст не показан: обоснование написано моделью к другому вердикту. Поправьте комментарий и "
1494
+ "сохраните решение или отметьте «Текст проверен» и скопируйте текст.")
1495
+ preview = ""
1496
+ # Решение принято по прежнему ответу модели (новый разбор после решения): решение остаётся в силе (ADR-0097),
1497
+ # карточка говорит, что разбор новый и совпадает ли он с решением человека
1498
+ current_verdict_id = case["verdict_id"] if case and case.get("verdict_id") else None
1499
+ verdict_changed = bool(review and review.get("verdict_id") and current_verdict_id
1500
+ and review["verdict_id"] != current_verdict_id)
1501
+ own_outcome = sast_outcome(review["decision"], review["final_verdict"]) if review and review.get("decision") else ""
1502
+ verdict_disagrees = bool(f.kind == "SAST" and verdict and own_outcome in SAST_OUTCOMES
1503
+ and verdict.verdict in SAST_OUTCOMES and verdict.verdict != own_outcome)
1504
+ model_history = history_view(db.finding_model_history(pid, f.hub_id), current_verdict_id,
1505
+ (review or {}).get("verdict_id"), str((case or {}).get("case_hash") or ""),
1506
+ own_outcome, steering) if f.kind == "SAST" else None
1507
+ for h in (model_history or {}).get("rows", []): # чей это ответ: профиль исполнителя (ADR-0102)
1508
+ h["executor"] = executor_label(db, db.verdict_execution(h["id"]))
1509
+ filters = selection_filters(selection)
1510
+ total, reviewed = db.count_unreviewed(pid, filters)
1511
+ sel_query = urlencode(selection, doseq=True)
1512
+ saved_row = None
1513
+ saved = request.query_params.get("saved", "")
1514
+ if COUNT.fullmatch(saved) and int(saved) != row["id"]:
1515
+ saved_row = db.get_finding(pid, int(saved))
1516
+ sast = f.kind == "SAST"
1517
+ # модели – того профиля, которым пойдёт запрос (ADR-0102): вопрос – профилем разбора (иначе профилем проекта),
1518
+ # разбор и пересмотр – новым прогоном на профиле проекта
1519
+ verdict_execution = db.verdict_execution(case.get("verdict_id")) if case else None
1520
+ # профиль вопроса – по тому же правилу, что и его обработка (ask.answer_execution): ответ сборки образа ВМ и ответ
1521
+ # до 0.9.12 – профилем проекта
1522
+ asked_execution = ask.answer_execution(db, case.get("verdict_id")) if case else None
1523
+ verdict_profile = db.get_provider(asked_execution["provider_id"]) if asked_execution else None
1524
+ project_profile = profile_for(request, project)
1525
+ run_models = models_of(request, profile=project_profile)["models"] if sast else []
1526
+ models = (models_of(request, profile=verdict_profile)["models"]
1527
+ if verdict_profile and sast else run_models)
1528
+ verdict_model = verdict_row["model"] if verdict_row else ""
1529
+ # сервер не отдаёт список моделей (Messages API, 404/405/501) – в списке только имя из профиля: модель прежнего
1530
+ # разбора добавляется с пометкой, иначе после смены имени в профиле её не выбрать (ревью Codex, круг 17)
1531
+ if verdict_model and models and all(m.get("source") == "profile" for m in models) \
1532
+ and verdict_model not in [m["name"] for m in models]:
1533
+ models = [*models, {"name": verdict_model, "source": "verdict"}]
1534
+ names = [m["name"] for m in models]
1535
+ run_names = [m["name"] for m in run_models]
1536
+ ask_model = verdict_model if verdict_model in names else default_model(
1537
+ settings, models, project, verdict_profile if verdict_profile else project_profile)
1538
+ analyze_model = default_model(settings, run_models, project, project_profile)
1539
+ # «Пересмотреть вердикт»: та же модель на том же коде ответит так же – по умолчанию предлагается другая:
1540
+ # модель проекта, из настроек, затем проверенные модели из README и лишь потом остальные по списку
1541
+ # имя модели: у удалённых API – как есть, у Ollama – без регистра и «:latest» (ADR-0106 п. 7)
1542
+ name_of = same_model(str((project_profile or {}).get("kind") or "ollama"))
1543
+ second = next((n for n in (project.get("model") or "", settings.default_model, *SECOND_OPINION_MODELS,
1544
+ *run_names)
1545
+ if n in run_names and name_of(n) != name_of(verdict_model)), "")
1546
+ reanalyze_model = second or (verdict_model if verdict_model in run_names else analyze_model)
1547
+ questions = [question_view(q, current_verdict_id) for q in db.list_questions(pid, f.hub_id)] if sast else []
1548
+ # та же строка и категория в других местах (ADR-0089): соседки с текстом для «Взять решение и текст»
1549
+ # подгруппа одинакового кода (ADR-0092): одно решение, один текст, общий номер; соседи с другим кодом –
1550
+ # отдельным списком, на выдачу не влияют
1551
+ all_siblings = db.group_siblings(pid, group_key(f), f.hub_id, limit=1_000_000) if sast else []
1552
+ mine_cmp = str((case or {}).get("code_cmp") or "") if sast else ""
1553
+ states = sibling_states(request, db, pid, all_siblings) if sast else {}
1554
+ shown_siblings = [{**s, "take_fix": sibling_take_fix(s), "state": (states.get(s["hub_id"]) or ("none",))[0]}
1555
+ for s in all_siblings if not s.get("missing")]
1556
+ siblings = [s for s in shown_siblings if str(s.get("code_cmp") or "") == mine_cmp][:50]
1557
+ group_other = [s for s in shown_siblings if str(s.get("code_cmp") or "") != mine_cmp][:50]
1558
+ group_total = len([s for s in shown_siblings if str(s.get("code_cmp") or "") == mine_cmp])
1559
+ group_other_total = len(shown_siblings) - group_total
1560
+ near, near_total = db.near_category(pid, f.to_dict(), mine_cmp) if sast else ([], 0)
1561
+ # Подставляется только действующее решение оператора; номер и группа не переносятся.
1562
+ for neighbor in near:
1563
+ review_fields = db.get_review(pid, neighbor["hub_id"]) or {}
1564
+ for key in ("decision", "final_verdict", "final_comment", "final_fix"):
1565
+ neighbor[key] = review_fields.get(key) or ""
1566
+ near_states = sibling_states(request, db, pid, near) if sast else {}
1567
+ for neighbor in near:
1568
+ neighbor["state"] = (near_states.get(neighbor["hub_id"]) or ("none",))[0]
1569
+ neighbor["take_fix"] = sibling_take_fix(neighbor)
1570
+ defect_lines = defect_shown_lines(request, pid, f, case, own=shown) if sast else shown
1571
+ return {
1572
+ "project": project, "row": row, "f": f, "ctx": ctx, "code_rows": code_rows, "shown_lines": shown,
1573
+ "verdict": verdict, "verdict_meta": verdict_row, "review": review, "decision": decision,
1574
+ "final_verdict": final_verdict, "comment": comment, "model_comment": model_comment,
1575
+ "model_comment_for": model_comment_for, "target_hidden": target_line_hidden(f, ctx),
1576
+ "reviewed_checked": reviewed_checked, "is_draft": draft is not None,
1577
+ "hub_preview": preview, "hub_preview_note": preview_note, "saved_stale": saved_stale, "steer_lines": steer_lines, "steer_fields": steer_fields,
1578
+ "invis_lines": invisible_lines(ctx) if ctx is not None else [],
1579
+ "ctx_note": card_note(ctx) if ctx else "", "code_changed": code_changed,
1580
+ "code_reason": code_reason(ctx) if ctx else "",
1581
+ # код из файла – из базы приложения вместо клона (ADR-0072): клона или файла в нём нет, срез сохранён
1582
+ "code_from_db": snapshot is not None and snapshot[0].status == "ok",
1583
+ "no_clone": bool(verdict and ctx is not None and ctx.status != "ok"),
1584
+ # строка из выгрузки – так же, как в промпте (у находки о секрете в коде скрыта целиком); при снятом флажке
1585
+ # проекта «маскировать при показе» – исходная (dev14, ADR-0141: модели – всегда с маской)
1586
+ "export_line": mask_display.export_line(f, mask_key, project),
1587
+ # состояние относительно Hub (dev15, бэклог 88): та же функция, что у синхронизации; считается одна находка
1588
+ "hub_state": hub_state.project_states(db, project, settings.hub_url,
1589
+ keys=[hub_state.issue_key(row)])["by_hub_id"].get(f.hub_id),
1590
+ # разбор устарел: текущий срез клона (с масками) вторым блоком и строки, которые отличаются (бэклог 112)
1591
+ "current_code": mask_display.current_slice(model_ctx, current_ctx) if code_changed else None,
1592
+ "mask_shown": mask_display.masked(project),
1593
+ "plain_ctx": mask_display.plain_context(project, repo_dir, f, why),
1594
+ # при снятом флажке метки в текстах модели – значениями из текущего файла клона и выгрузки (бэклог 111)
1595
+ "label_values": (label_values := mask_display.label_values(
1596
+ project, repo_dir, f, mask_key, why, also=[lambda: masked_extra(f, mask_key)])),
1597
+ "labels_note": mask_display.labels_note(project, verdict, label_values),
1598
+ # ADR-0080: уверенность при differs ограничена с sast-v6 – у прежних вердиктов ограничения нет. ADR-0082: при
1599
+ # commented/partial – только если ограничение действительно применено к этому вердикту (вердикт, полученный
1600
+ # до уточнённой сверки, его не получал)
1601
+ "confidence_capped": capped_confidence(verdict, verdict_row, ctx),
1602
+ "export_scope": (export_fragment_scope(str(f.snippet or ""), ctx.text_at(ctx.export_line_at))
1603
+ if ctx is not None and ctx.export_line_check in ("match", "near") and ctx.export_line_at
1604
+ else ""),
1605
+ "export_shift_at": export_shift_at,
1606
+ "display_wide": display is not None, "steer_outside": steer_outside, "invis_outside": invis_outside,
1607
+ "confidence_max": DIFFERS_CONFIDENCE_MAX,
1608
+ "confidence_raw": (verdict_row.get("raw") or {}).get("confidence") if verdict_row else None,
1609
+ "extra": masked_extra(f, mask_key) if mask_display.masked(project) else {k: str(v) for k, v in f.extra.items()},
1610
+ "prev_id": queue_neighbor(db, pid, row, selection, "prev", hub_ids=(hub_ids := hub_sync_ids(request, project, selection))),
1611
+ "next_id": queue_neighbor(db, pid, row, selection, hub_ids=hub_ids),
1612
+ "walk_all": walks_all(selection),
1613
+ "progress": {"total": total, "reviewed": reviewed},
1614
+ "selection": selection, "sel_query": sel_query, "selection_labels": selection_labels(selection),
1615
+ "saved_row": saved_row,
1616
+ "need_texts": {"reason": RISK_NEEDS_REASON, "verdict": NEED_VERDICT,
1617
+ "reason_fp": SAST_NEED_REASON["false_positive"], "reason_tp": SAST_NEED_REASON["true_positive"],
1618
+ "fix": need_fix_text(model_fix, model_points,
1619
+ bool(model_history and model_history["earlier_points"]))},
1620
+ "status_map": settings.hub_status_map,
1621
+ # «Отправить в Hub» (ADR-0115): доступна ли отправка статуса, последняя операция, быстрые сроки
1622
+ # отпечаток – только у карточки, показавшей сохранённое решение: у черновика (ответ 409 на устаревшую форму)
1623
+ # в форме введённое, а не сохранённое – отпечатка нет, отправка откажет
1624
+ "hub_status_now": (status_now := hub_status_routes.status_now(db, project, settings, f)),
1625
+ "entered_scope_note": hub_status_routes.entered_scope_note(review, status_now),
1626
+ "hub_send": (hub_status_routes.card_context(
1627
+ request, project, f.hub_id, saved_hub_text(f, review, settings.hub_status_map) if draft is None else "",
1628
+ note=hub_status_routes.DRAFT_NOTE if draft is not None else "") if f.kind == "SAST" else None),
1629
+ # «Создать дефект в Hub» (ADR-0120): состояние дефекта из карточки по этой находке и предпросмотр
1630
+ # с 0.9.23 (ADR-0121) – и привязка находки к дефекту, пометка «решение изменено после создания дефекта» (по
1631
+ # отпечатку текста сохранённого решения, как у отметки «Внесено в Hub»), «Привязать к дефекту»
1632
+ "hub_defect": hub_defect_routes.card_context(
1633
+ request, project, f.hub_id,
1634
+ current_hash=text_hash(sast_entered_text(db, settings, pid, f, review)) if review and review.get("decision")
1635
+ else "") if sast else None,
1636
+ # версия находки и папки с её кодом из того же снимка, по которому построен срез
1637
+ "finding_version": source_version(source),
1638
+ "shown_verdict_id": current_verdict_id or "",
1639
+ # редакция решения, которую видел человек: решение из устаревшей вкладки не затрёт более новое
1640
+ "review_revision": int(review["revision"]) if review else 0,
1641
+ "code_hash": code_hash, "code_chars": code_chars,
1642
+ # объяснение для человека: версия ответа модели, уверенность словами
1643
+ "is_v3": bool(verdict and (verdict.why or verdict.what_code_does or verdict.check_by_eye or verdict.terms)),
1644
+ "confidence_words": confidence_label(verdict.confidence) if verdict else "",
1645
+ "comment_for": comment_for, "comment_stale": comment_stale, "verdict_changed": verdict_changed,
1646
+ "verdict_disagrees": verdict_disagrees, "model_history": model_history,
1647
+ "verdict_executor": executor_label(db, verdict_execution) if verdict_row else "",
1648
+ "decision_in_force": assessment["state"] in ("ok", "not_ready", "later"),
1649
+ # ссылки «строка N» в комментарии для Hub на строки, которых нет в показанном коде (выдуманный довод)
1650
+ "comment_missing_lines": missing_line_refs(comment, defect_lines) if sast else [],
1651
+ # вопросы к модели и повторный разбор
1652
+ "questions": questions, "models": models, "ask_model": ask_model, "ask_draft": ask_draft,
1653
+ "reanalyze_model": reanalyze_model, "run_models": run_models, "analyze_model": analyze_model,
1654
+ # внешний провайдер: разбор, пересмотр и вопрос – платные запросы (ADR-0104); профиль вопроса – профиль ответа
1655
+ "code_profile_external": str((project_profile or {}).get("trust") or "") == "external",
1656
+ "code_profile_name": str((project_profile or {}).get("name") or ""),
1657
+ "ask_profile_external": str(((verdict_profile or project_profile) or {}).get("trust") or "") == "external",
1658
+ "ask_profile_name": str(((verdict_profile or project_profile) or {}).get("name") or ""),
1659
+ **ask_busy_flags(db, settings_of(request), pid, (case or {}).get("verdict_id") if sast else None),
1660
+ "pending_run": pending_run_for(db, pid, f.hub_id) if sast else None,
1661
+ "prompt_version": PROMPT_VERSION, "short_explanation_versions": SHORT_EXPLANATION_VERSIONS,
1662
+ "entered": bool(review and review.get("entered_hub")),
1663
+ # что изменилось в тексте после отметки (О8): None – отметка до 0.9.9, состав неизвестен
1664
+ "entered_reasons": entered_change_reasons(settings, review) if sast else None,
1665
+ # отметка общим комментарием из списка (ADR-0119): текст в Hub другой по замыслу, это не «текст изменился»
1666
+ "entered_bulk": bool(review and review.get("entered_hub")) and entered_by_bulk(review),
1667
+ "entered_changed": (entered_text_changed(review, sast_entered_text(db, settings, pid, f, review))
1668
+ and not entered_by_bulk(review)
1669
+ and not entered_format_updated(review, sast_entered_text(db, settings, pid, f, review),
1670
+ saved_legacy_texts(f, review, settings.hub_status_map, settings.team_name))),
1671
+ "entered_format_updated": entered_format_updated(review, sast_entered_text(db, settings, pid, f, review),
1672
+ saved_legacy_texts(f, review, settings.hub_status_map, settings.team_name)),
1673
+ "group_total": group_total, "group_other_total": group_other_total,
1674
+ # прежние редакции текста решения (О5): что было в комментарии и рекомендации до последней правки
1675
+ "text_history": (history := db.review_text_history(pid, f.hub_id) if sast else ([], 0))[0],
1676
+ "text_history_total": history[1],
1677
+ # вся группа (с этой находкой и находками с другим кодом) – в списке находок отбором по ключу группы
1678
+ "group_list_url": f"/projects/{pid}/findings?group={row['id']}&missing=no",
1679
+ "group_size": len(shown_siblings) + (0 if row.get("missing") else 1), # как в списке по ссылке (missing=no)
1680
+ # подсказка «Рядом та же категория» (ADR-0095 п. 6): сведения, а не группа – решение и номер не меняет
1681
+ "near": near,
1682
+ "near_total": near_total,
1683
+ # два исхода SAST (ADR-0089): выбранный исход, рекомендация дефекта, та же строка и категория в других местах
1684
+ "sast_outcome": sast_outcome(decision, final_verdict) if sast else "",
1685
+ "legacy_outcome": (sast and decision not in ("", "later")
1686
+ and sast_outcome(decision, final_verdict) not in SAST_OUTCOMES),
1687
+ "final_fix": final_fix, "model_fix": model_fix, "model_points": "\n".join(model_points),
1688
+ "model_code_dropped": model_code_dropped,
1689
+ "siblings": siblings, "group_other": group_other, "group_compared": bool(mine_cmp),
1690
+ # группа слилась при обновлении схемы 20 (ADR-0095 п. 4): уведомление – в карточке всегда
1691
+ "group_merge_notice": (MERGE_NOTICE.format(date=fmt_ts(group_merge["merged_at"]))
1692
+ if sast and (group_merge := db.group_merge(pid, group_key(f))) else ""),
1693
+ "group_take_all": group_take_all([s for s in siblings if s["state"] == "ok"], group_total) if sast else None,
1694
+ "entered_hash": (text_hash(sast_entered_text(db, settings, pid, f, review))
1695
+ if sast and review and review.get("decision") else ""),
1696
+ "entered_unconfirmed": entered_unconfirmed(review),
1697
+ # класс уязвимости из каталога CWE (страница «Справочники») и дефект для Hub
1698
+ "cwe_info": store_of(request).cwe_info(f.cwe) if sast else {},
1699
+ "defect": defect_form_problems(db, settings, pid, defect_view(
1700
+ sast_defect(db, settings, store_of(request), pid, f, review,
1701
+ verdict if assessment["use_verdict"] else None, shown=defect_lines or None,
1702
+ state=assessment["state"], source=source),
1703
+ review, comment_for if draft is None else comment_origin(
1704
+ db, case, review, (review or {}).get("final_comment") or "", known=known_verdicts)))
1705
+ if sast else None,
1706
+ # сохранённый текст для Hub относится к другому состоянию находки: показывается как исторический
1707
+ "hub_historic": bool(assessment["state"] in SAST_HISTORIC_STATES and review and review.get("decision")),
1708
+ "has_decision": bool(review and review.get("decision")),
1709
+ # числа на вкладках проекта
1710
+ "counts": db.count_findings(pid), "review_stats": db.review_stats(pid),
1711
+ }
1712
+
1713
+
1714
+ _form_int = form_int
1715
+
1716
+
1717
+ def check_code(request: Request, project_id: int, f: Finding, case: dict | None, shown_hash: str,
1718
+ shown_chars: int | None) -> dict:
1719
+ """Сверка кода находки с тем, что видел человек, перед сохранением решения.
1720
+
1721
+ Код в клоне читается заново (так же, как его строит прогон) и сравнивается с отпечатком shown_hash со страницы:
1722
+ другой – код изменился, пока карточка была открыта (StaleReview, reason="code"). Отпечаток считается при том же
1723
+ размере среза, что на странице (shown_chars), иначе – как у среза модели. stale_verdict – код уже не тот,
1724
+ что разбирала модель (её вердикт – про прежний код): «Согласен» не сохраняется, два исхода SAST сохраняются
1725
+ «Не согласен», отметку «Проверено» это не снимает (ADR-0147).
1726
+ Возвращает {"hash", "chars", "stale_verdict"}; у находки без кода (не SAST) hash – None."""
1727
+ if f.kind != "SAST":
1728
+ return {"hash": None, "chars": 0, "stale_verdict": False}
1729
+ source = db_of(request).case_input(project_id, f.hub_id)
1730
+ if source is None:
1731
+ raise StaleReview("находки нет", "source")
1732
+ settings, mask_key = settings_of(request), mask_key_of(request)
1733
+ case_chars = int((case or {}).get("context", {}).get("max_chars") or CONTEXT_CHARS)
1734
+ chars = shown_chars if shown_chars is not None and MIN_CONTEXT_CHARS <= shown_chars <= CONTEXT_CHARS \
1735
+ else case_chars
1736
+ _, _, current = current_code(settings, source, mask_key, chars, case=case)
1737
+ if shown_hash and current != shown_hash:
1738
+ raise StaleReview("код изменился", "code")
1739
+ stale_verdict = False
1740
+ if case and case.get("verdict_id"):
1741
+ at_case = current if chars == case_chars else current_code(settings, source, mask_key, case_chars,
1742
+ case=case)[2]
1743
+ stale_verdict = at_case != case["case_hash"]
1744
+ return {"hash": current, "chars": chars, "stale_verdict": stale_verdict}
1745
+
1746
+
1747
+ def check_shown(db: Database, project_id: int, f: Finding, case: dict | None, shown_version: str,
1748
+ shown_verdict: int | None, shown_revision: int | None) -> None:
1749
+ """Что видел человек – находка, вердикт модели и редакция решения – не устарело (иначе StaleReview).
1750
+ Страница без редакции (открытая до обновления приложения) проверяется по версии находки и вердикту."""
1751
+ if db.review_version(project_id, f.hub_id) != shown_version:
1752
+ raise StaleReview("страница устарела", "source")
1753
+ current_verdict = case["verdict_id"] if case and case.get("verdict_id") else None
1754
+ if current_verdict != shown_verdict:
1755
+ raise StaleReview("страница устарела", "verdict")
1756
+ old = db.get_review(project_id, f.hub_id)
1757
+ if shown_revision is not None and (int(old["revision"]) if old else 0) != shown_revision:
1758
+ raise StaleReview("страница устарела", "revision")
1759
+
1760
+
1761
+ def card_response(request: Request, project_id: int, finding_id: int, error: str = "",
1762
+ status_code: int = 200, draft: dict | None = None, ask_draft: str = "",
1763
+ reveal_revision: int | None = None, defect_extra: dict | None = None,
1764
+ defect_bound: str = "") -> HTMLResponse:
1765
+ project = project_or_404(request, project_id)
1766
+ row = db_of(request).get_finding(project_id, finding_id)
1767
+ if row is None:
1768
+ raise HTTPException(status_code=404, detail="Находка не найдена: возможно, её нет в новой выгрузке.")
1769
+ view = finding_view(request, project, row, read_selection(request.query_params), draft, ask_draft)
1770
+ # текст выдан по отметке «Текст проверен» (форма без скрипта): раскрывается, только если решение в карточке – та же
1771
+ # редакция, по которой текст выдан (между выдачей и чтением карточки его могли сохранить заново в другой вкладке)
1772
+ defect_now = view.get("defect")
1773
+ if reveal_revision is not None and defect_now and defect_now.get("review_revision") == reveal_revision:
1774
+ defect_now["comment_check"] = False
1775
+ if defect_extra and defect_now: # отказ выдачи без скрипта: предупреждения и введённый номер – в форме дефекта
1776
+ defect_now.update(defect_extra)
1777
+ from app.routes.capec import related_context, cwe_values
1778
+ view['capec_context'] = related_context(request, cwe_values(row['data'].get('cwe',[])), project_id)
1779
+ # отказ «находка в дефекте, созданном в Hub» без скрипта (ADR-0121 п. 2): флажок подтверждения в форме решения открыт
1780
+ return render(request, "findings/card.html", {**view, "error": error, "defect_bound_open": defect_bound, "back_url": worklists.return_url(request, f"/projects/{project_id}/findings")}, status_code)
1781
+
1782
+
1783
+ def finding_or_404(request: Request, project_id: int, finding_id: int) -> dict:
1784
+ project_or_404(request, project_id)
1785
+ row = db_of(request).get_finding(project_id, finding_id)
1786
+ if row is None:
1787
+ raise HTTPException(status_code=404, detail="Находка не найдена.")
1788
+ return row
1789
+
1790
+
1791
+ def wants_json(request: Request) -> bool:
1792
+ return "application/json" in request.headers.get("accept", "")
1793
+
1794
+
1795
+ def progress_of(db: Database, project_id: int, selection: dict[str, str]) -> dict:
1796
+ total, done = db.count_unreviewed(project_id, selection_filters(selection))
1797
+ return {"total": total, "reviewed": done}
1798
+
1799
+
1800
+ def capped_confidence(verdict: Verdict | None, verdict_row: dict | None, ctx: CodeContext | None) -> bool:
1801
+ """Показать «уверенность ограничена»: вердикт версии с потолком уверенности (sast-v6 и после, ADR-0080) и сверка,
1802
+ не подтверждающая фрагмент. По версии сохранённого ответа, а не по текущему промпту приложения (ревью dev20)."""
1803
+ if not (verdict and verdict_row and ctx is not None
1804
+ and verdict_row.get("prompt_version") in DIFFERS_CAP_VERSIONS):
1805
+ return False
1806
+ if ctx.export_line_check == "differs":
1807
+ return True
1808
+ if ctx.export_line_check in UNCONFIRMED_EXPORT_CHECKS:
1809
+ try:
1810
+ raw = float((verdict_row.get("raw") or {}).get("confidence"))
1811
+ except (TypeError, ValueError):
1812
+ return False
1813
+ return raw > verdict.confidence
1814
+ return False
1815
+
1816
+ # ============================================================================ адреса: список и карточка
1817
+
1818
+
1819
+
1820
+ def ask_busy_flags(db, settings, project_id: int, verdict_id) -> dict:
1821
+ """Подсказки занятости модели в карточке – по группе права исполнителя вопроса (ADR-0104 п. 6)."""
1822
+ executor = ask.card_executor(db, settings, project_id, verdict_id)
1823
+ return {"ask_busy": ask.busy(executor), "ask_run_busy": ask.run_busy(executor)}
1824
+
1825
+ @router.get("/projects/{project_id}/findings", response_class=HTMLResponse)
1826
+ def findings_page(request: Request, project_id: int, error: str = ""):
1827
+ project = project_or_404(request, project_id)
1828
+ q = request.query_params
1829
+ selection = read_selection(q)
1830
+ filters = {k: selection.get(k, "") for k in SELECTION_KEYS}
1831
+ filters["hub_status"] = tuple(selection.get("hub_status") or ())
1832
+ try:
1833
+ page = max(1, int(q.get("page", "1")))
1834
+ except ValueError:
1835
+ page = 1
1836
+ db = db_of(request)
1837
+ sel = selection_filters(selection)
1838
+ presentation = worklists.options(q, ("severity_asc", "severity_desc"))
1839
+ filters.update(presentation)
1840
+ descriptors = db.finding_descriptors(project_id, sel)
1841
+ # состояние относительно Hub (dev15, бэклог 88): значок в строке и отбор – одним расчётом на страницу
1842
+ hub_states = hub_state.project_states(db, project, settings_of(request).hub_url)
1843
+ hub_ids = hub_sync_ids(request, project, selection, hub_states)
1844
+ if hub_ids is not None:
1845
+ descriptors = [d for d in descriptors if d["hub_id"] in hub_ids]
1846
+ from app import defect_links
1847
+ defect_by_hub = defect_links.by_hub_id(db, project_id) # дефекты приложения – строкам и группам
1848
+ defect_links.attach(descriptors, defect_by_hub)
1849
+ for row in descriptors: # столбцы обзора групп (план dev7, раздел 3)
1850
+ row["buckets"] = {worklists.finding_bucket(row.get("decision"), row.get("final_verdict"),
1851
+ defect_links.in_defect(row.get("defects") or [])): 1}
1852
+ row["entered"] = int(bool(row.get("entered_hub")))
1853
+ w = worklists.table(worklists.sort_findings(descriptors, presentation["sort"]), filters,
1854
+ path=f"/projects/{project_id}/findings", default_size=PAGE_SIZE, kind="findings",
1855
+ sorts={"": "Как в отчёте", "severity_desc": "Критичность ↓", "severity_asc": "Критичность ↑"})
1856
+ ids = tuple(r["id"] for r in w["rows"])
1857
+ shown, _ = db.list_findings(project_id, ids=ids, limit=w["size"])
1858
+ order = {fid: n for n, fid in enumerate(ids)}
1859
+ rows = sorted(shown, key=lambda row: order[row["id"]])
1860
+ defect_links.attach(rows, defect_by_hub)
1861
+ # разборы моделью по текущему срезу: сколько ответов и расходятся ли модели (ADR-0097) – одной выборкой
1862
+ answer_counts = db.model_answer_counts(project_id, [r["hub_id"] for r in rows if r.get("kind") == "SAST"],
1863
+ PROMPT_VERSION)
1864
+ total, page, pages = w["total"], w["page"], w["pages"]
1865
+ if worklists.integer(q.get("page"), 1) > pages:
1866
+ clean = {k: v for k, v in {**selection, **presentation}.items() if v and k != "page"}
1867
+ return redirect(f"/projects/{project_id}/findings?{query(clean, page=pages)}")
1868
+ models = models_of(request, profile=profile_for(request, project))
1869
+ card_query = "?" + query({**selection, **presentation, "back": w["url"](page=page)})
1870
+ active_preset = next((label for label, params in PRESETS
1871
+ if selection == params), "")
1872
+ base = f"/projects/{project_id}/findings"
1873
+
1874
+ def link(**changes: str) -> str:
1875
+ """Адрес списка с текущими фильтрами и заменой части из них (страница – первая)."""
1876
+ q = query(filters, page="", **changes)
1877
+ return f"{base}?{q}" if q else base
1878
+
1879
+ filter_groups = [{"key": key, "label": label,
1880
+ "chips": [{"label": text, "href": link(**{key: value}), "active": filters[key] == value}
1881
+ for value, text in options]}
1882
+ for key, label, options in FILTER_GROUPS]
1883
+ # Тот же действующий статус, что в карточке: подтверждение, принятая сверка, выгрузка.
1884
+ statuses = db.finding_statuses(project_id)
1885
+ chosen = filters["hub_status"]
1886
+ if statuses or chosen:
1887
+ # чипы переключают значение по одному: выбранное снимается, новое добавляется (бэклог 99)
1888
+ def toggled(value: str) -> tuple[str, ...]:
1889
+ return tuple(s for s in chosen if s != value) if value in chosen else (*chosen, value)
1890
+ filter_groups.insert(1, {"key": "hub_status", "label": "Статус Hub", "chips": [
1891
+ {"label": "любой", "href": link(hub_status=()), "active": not chosen},
1892
+ *({"label": s, "href": link(hub_status=toggled(s)), "active": s in chosen}
1893
+ for s in dict.fromkeys((*statuses, *chosen)))]})
1894
+ filter_flags = [{"label": text, "href": link(**{key: "" if filters[key] else value}), "active": bool(filters[key])}
1895
+ for key, value, text in FILTER_FLAGS]
1896
+ stats = db.review_stats(project_id)
1897
+ # отбор «одна группа»: находка, по ключу которой отобран список, – для строки над таблицей
1898
+ group_anchor = db.get_finding(project_id, int(selection["group"])) if selection.get("group") else None
1899
+ # непроверенных SAST нет, а в SCA есть: путь «продолжить разбор» ведёт дальше, на SCA
1900
+ sca_left = max(0, int(stats.get("sca") or 0) - int(stats.get("sca_reviewed") or 0))
1901
+ sca_unreviewed = (db.neighbor_unreviewed(project_id, -1, "next", kinds=("SCA",)) if sca_left else None)
1902
+ return render(request, "findings/list.html", {
1903
+ "error": error, "group_anchor": group_anchor, "group_lost": bool(selection.get("group")) and not group_anchor,
1904
+ "group_clear": link(group=""),
1905
+ "sca_unreviewed": sca_unreviewed, "sca_left": sca_left,
1906
+ "project": project, "rows": rows, "total": total, "page": page, "pages": pages, "filters": filters, "worklist": w,
1907
+ "answer_counts": answer_counts,
1908
+ "codebases": [c for c in db.codebase_counts(project_id)], "models": models["models"],
1909
+ "default_model": default_model(settings_of(request), models["models"], project),
1910
+ "prev_url": f"?{query(filters, page=page - 1)}" if page > 1 else "",
1911
+ "next_url": f"?{query(filters, page=page + 1)}" if page < pages else "",
1912
+ "active_runs": db.active_runs(project_id), "review_stats": stats,
1913
+ "counts": db.count_findings(project_id), # числа на вкладках проекта
1914
+ "hub_step": hub_onboarding.state(db, project, settings_of(request).hub_url, light=True),
1915
+ "hub_states": hub_states["by_hub_id"], "hub_summary": hub_states["summary"],
1916
+ "card_query": card_query, "queue_query": card_query, "presets": [(label, query(presentation, **params, page=""), label == active_preset)
1917
+ for label, params in PRESETS],
1918
+ "first_unreviewed": queue_neighbor(db, project_id, None, {**selection, **presentation},
1919
+ descriptors=descriptors),
1920
+ "walk_all": walks_all(selection), "selection_labels": selection_labels(selection),
1921
+ "has_filters": bool(selection), "filter_groups": filter_groups, "filter_flags": filter_flags,
1922
+ # подробные фильтры свёрнуты; открыты, когда что-то выбрано, – так видно, что действует
1923
+ "filters_open": bool(selection), "active_filters": sum(1 for v in filters.values() if v),
1924
+ # для формы кодовой базы: прочие фильтры – скрытыми полями
1925
+ "other_filters": [(k, item) for k, v in filters.items() if v and k not in ("cb", "page")
1926
+ for item in (v if isinstance(v, (list, tuple)) else (v,))],
1927
+ })
1928
+
1929
+
1930
+ @router.get("/projects/{project_id}/findings/by-id")
1931
+ def finding_by_hub_id(request: Request, project_id: int, hub_id: str = ""):
1932
+ project_or_404(request, project_id)
1933
+ row = db_of(request).get_finding_by_hub_id(project_id, hub_id.strip())
1934
+ if row is None:
1935
+ return findings_page(request, project_id, "Находка с таким ID не найдена.")
1936
+ section = "sca/findings" if row["kind"] == "SCA" else "findings"
1937
+ return redirect(f"/projects/{project_id}/{section}/{row['id']}")
1938
+
1939
+
1940
+ @router.get("/projects/{project_id}/findings/{finding_id}", response_class=HTMLResponse)
1941
+ def finding_page(request: Request, project_id: int, finding_id: int):
1942
+ row = db_of(request).get_finding(project_id, finding_id)
1943
+ if row is not None and row["kind"] == "SCA": # у находки SCA своя карточка – в разделе SCA
1944
+ return redirect(f"/projects/{project_id}/sca/findings/{finding_id}")
1945
+ return card_response(request, project_id, finding_id)
1946
+
1947
+
1948
+ @router.get("/projects/{project_id}/findings/{finding_id}/state")
1949
+ def finding_state(request: Request, project_id: int, finding_id: int):
1950
+ """Состояние карточки для скрипта: вердикт модели, ожидание в очереди прогона, отметки решения, занята ли
1951
+ модель вопросом. Открытая карточка опрашивает его, пока находка ждёт разбора (data-poll): done и reload –
1952
+ разбор закончен, карточку пора обновить."""
1953
+ row = finding_or_404(request, project_id, finding_id)
1954
+ db = db_of(request)
1955
+ case = db.get_case(project_id, row["hub_id"])
1956
+ pending = pending_run_for(db, project_id, row["hub_id"])
1957
+ return {"verdict_id": case["verdict_id"] if case and case.get("verdict_id") else None,
1958
+ "pending_run": pending, "review": review_json(db.get_review(project_id, row["hub_id"])),
1959
+ **ask_busy_flags(db, settings_of(request), project_id, case.get("verdict_id") if case else None),
1960
+ "done": pending is None, "reload": pending is None}
1961
+
1962
+
1963
+ # ============================================================================ адреса: решение и отметки
1964
+
1965
+ @router.post("/projects/{project_id}/findings/{finding_id}/review")
1966
+ async def save_review(request: Request, project_id: int, finding_id: int):
1967
+ form = await request.form()
1968
+ decision = str(form.get("decision") or "")
1969
+ final_verdict = str(form.get("final_verdict") or "")
1970
+ comment = str(form.get("comment") or "").replace("\r\n", "\n")[:MAX_COMMENT]
1971
+ # рекомендация подтверждённого дефекта SAST (поле есть только в карточке SAST; нет поля – не менять)
1972
+ fix_field = form.get("fix")
1973
+ final_fix = str(fix_field).replace("\r\n", "\n") if fix_field is not None else None
1974
+ fix_too_long = final_fix is not None and len(final_fix) > MAX_FIX # не обрезать молча – отказ с причиной
1975
+ reviewed = str(form.get("reviewed") or "") == "1"
1976
+ action = str(form.get("action") or "save")
1977
+ shown_version = str(form.get("finding_version") or "")
1978
+ shown_verdict = str(form.get("verdict_id") or "").strip()
1979
+ # редакция решения и отпечаток кода, которые видел человек; страница без этих полей (открытая до обновления
1980
+ # приложения) проверяется только по версии находки и вердикту
1981
+ shown_revision = _form_int(form.get("review_revision"))
1982
+ shown_code = str(form.get("code_hash") or "").strip()[:64]
1983
+ shown_chars = _form_int(form.get("code_chars"))
1984
+ json_answer = action == "copy" or wants_json(request)
1985
+ defect_confirmed = str(form.get("defect_confirm") or "") == "1" # «дефект в Hub останется прежним» (ADR-0121)
1986
+ selection = read_selection(request.query_params) # отбор списка, внутри которого идёт обход
1987
+ sel_query = urlencode(selection, doseq=True)
1988
+
1989
+ def apply():
1990
+ nonlocal decision, final_verdict, final_fix
1991
+ project_or_404(request, project_id)
1992
+ if fix_too_long:
1993
+ raise ReviewRejected(FIX_TOO_LONG)
1994
+ db = db_of(request)
1995
+ settings = settings_of(request)
1996
+ row = db.get_finding(project_id, finding_id)
1997
+ if row is None:
1998
+ raise HTTPException(status_code=404, detail="Находка не найдена.")
1999
+ if (decision not in ("", *DECISIONS, *SAST_OUTCOMES) or final_verdict not in ("", *VERDICTS)
2000
+ or (shown_verdict and not shown_verdict.isdigit())):
2001
+ raise HTTPException(status_code=400, detail="Неверное решение или вердикт.")
2002
+ f = Finding.from_dict(row["data"])
2003
+ if decision in SAST_OUTCOMES and f.kind != "SAST":
2004
+ raise HTTPException(status_code=400, detail="Неверное решение или вердикт.")
2005
+ case = db.get_case(project_id, f.hub_id)
2006
+ model_verdict = case["verdict"] if case else None
2007
+ expected_verdict = int(shown_verdict) if shown_verdict else None
2008
+ # раньше проверок решения: сначала – что видел человек (находка, вердикт, решение, код)
2009
+ check_shown(db, project_id, f, case, shown_version, expected_verdict, shown_revision)
2010
+ old = db.get_review(project_id, f.hub_id)
2011
+ code = check_code(request, project_id, f, case, shown_code, shown_chars)
2012
+ if f.kind == "SAST":
2013
+ # два исхода SAST (ADR-0089): кнопка карточки -> прежняя пара «согласен/не согласен» и итоговый вердикт
2014
+ outcome_key = decision if decision in SAST_OUTCOMES else ""
2015
+ decision, final_verdict = sast_choice(decision, final_verdict, model_verdict, code["stale_verdict"], old,
2016
+ case["verdict_id"] if case and case.get("verdict_id") else None)
2017
+ if decision == "risk_accepted":
2018
+ raise ReviewRejected(SAST_TWO_OUTCOMES)
2019
+ # рекомендация – только у подтверждённого дефекта; у остальных исходов она не сохраняется
2020
+ if outcome_key and outcome_key != "true_positive":
2021
+ final_fix = ""
2022
+ else:
2023
+ final_fix = None
2024
+ chosen = final_verdict
2025
+ group_check = None
2026
+ if action == "copy" and not decision:
2027
+ raise ReviewRejected(NEED_DECISION)
2028
+ if decision == "disagree" and not final_verdict:
2029
+ raise ReviewRejected(NEED_VERDICT)
2030
+ if decision == "agree":
2031
+ if model_verdict is None:
2032
+ raise HTTPException(status_code=400, detail="«Согласен» можно выбрать, только когда есть вердикт "
2033
+ "модели.")
2034
+ if code["stale_verdict"]:
2035
+ raise StaleReview("код изменился после разбора", "stale_verdict")
2036
+ chosen = model_verdict["verdict"]
2037
+ if decision == "risk_accepted" and not comment.strip():
2038
+ raise ReviewRejected(RISK_NEEDS_REASON)
2039
+ if f.kind == "SAST" and decision in ("agree", "disagree"):
2040
+ outcome = hub_verdict(decision, chosen)
2041
+ if outcome not in SAST_OUTCOMES:
2042
+ raise ReviewRejected(SAST_TWO_OUTCOMES)
2043
+ # обоснование обязательно: одно вводное «Ложное срабатывание:» его не заменяет (ADR-0089 п. 6); в Hub
2044
+ # комментарий уходит как написан (ADR-0149), вводное слово снимается только для этой проверки
2045
+ if not defect.reason_text(comment):
2046
+ raise ReviewRejected(SAST_NEED_REASON[outcome])
2047
+ # подтверждённый дефект – с рекомендацией оператора (ADR-0092); поля нет (страница до обновления) –
2048
+ # проверяется сохранённая
2049
+ if outcome == "true_positive" and not defect.has_recommendation(
2050
+ final_fix if final_fix is not None else str((old or {}).get("final_fix") or "")):
2051
+ raise ReviewRejected(SAST_NEED_FIX)
2052
+ # короткий текст копируется только для ложного срабатывания: у дефекта в Hub уходит полный текст, отложенная
2053
+ # находка в Hub не переносится
2054
+ if f.kind == "SAST" and action == "copy":
2055
+ if hub_verdict(decision, chosen) != "false_positive":
2056
+ raise ReviewRejected(SAST_COPY_DEFECT)
2057
+ mine = defect.sast_effective("false_positive", comment, "")
2058
+ mine_cmp = str((case or {}).get("code_cmp") or "") # срез, по которому проверен код выше
2059
+ near = same_code(db.group_rows(project_id, group_key(f), f.hub_id), mine_cmp)
2060
+ states = sibling_states(request, db, project_id, near)
2061
+
2062
+ def source_now(hub_id: str) -> str: # текущая версия соседки – тем же соединением, в транзакции
2063
+ return source_sig(db.case_input(project_id, hub_id))
2064
+ conflict = group_conflict_rows(current_rows(near, states, source_now), mine)
2065
+ if conflict:
2066
+ raise ReviewRejected(conflict)
2067
+
2068
+ own_case = (case or {}).get("case_hash")
2069
+
2070
+ def copy_group_check(rows: list[dict]) -> None:
2071
+ now = db.get_case(project_id, f.hub_id) or {} # то же соединение, внутри транзакции записи
2072
+ if now.get("case_hash") != own_case or str(now.get("code_cmp") or "") != mine_cmp:
2073
+ raise ReviewRejected(GROUP_MOVED)
2074
+ found = group_conflict_rows(current_rows(same_code(rows, mine_cmp), states, source_now), mine)
2075
+ if found:
2076
+ raise ReviewRejected(found)
2077
+ group_check = copy_group_check
2078
+ # Текст для Hub с комментарием модели к другому вердикту не копируется молча: нужна правка или «Текст
2079
+ # проверен» (п. 10 проверки этапа 1)
2080
+ # человек подтвердил, что комментарий модели к другому вердикту подходит и так: «Текст проверен» действует только
2081
+ # с редакцией решения, которую он видел (BUG-01) – без неё короткий текст не выдаётся, сохранение – да
2082
+ if action == "copy":
2083
+ origin = comment_origin(db, case, old, comment, project_id=project_id, hub_id=f.hub_id)
2084
+ target = hub_verdict(decision, chosen)
2085
+ if origin and origin != target and not comment_confirm_valid(form, old):
2086
+ raise CommentNeedsCheck(comment_check_text(origin, target))
2087
+ comment_confirmed = comment_confirm_valid(form, old, strict=False)
2088
+ if action == "copy":
2089
+ current = db.case_input(project_id, f.hub_id)
2090
+ if current is None or current.get("missing"):
2091
+ raise ReviewRejected(copy_missing_message(old))
2092
+ if f.kind == "SAST":
2093
+ # находка в дефекте, созданном в Hub (ADR-0121 п. 2): смена решения – только с подтверждением; привязка и
2094
+ # прежнее решение читаются в транзакции записи (проверка группы вызывается внутри неё)
2095
+ group_check = hub_defects.save_check(db, project_id, f.hub_id, decision, chosen, comment, final_fix,
2096
+ defect_confirmed, group_check)
2097
+ expect = {"version": shown_version, "verdict_id": expected_verdict, "revision": shown_revision}
2098
+ # «Отложить» – вернуться позже: находка остаётся непроверенной. Вердикт модели про прежний срез кода
2099
+ # отметку не снимает (ADR-0147): решение – оператора, карточка предупреждает. check_code выше доказывает только,
2100
+ # что код не менялся, пока карточка была открыта; review.code_hash – отпечаток текущего кода
2101
+ mark = reviewed and decision != "later"
2102
+ try:
2103
+ review = db.save_review(project_id, f.hub_id, decision=decision, final_verdict=chosen,
2104
+ final_comment=comment, reviewed=mark, verdict_id=expect["verdict_id"],
2105
+ expect=expect, code_hash=code["hash"], code_chars=code["chars"],
2106
+ require_present=action == "copy", final_fix=final_fix,
2107
+ group_key=group_key(f), group_check=group_check, recheck=action != "copy")
2108
+ except StaleReview as e:
2109
+ if e.reason == "missing": # находка исчезла из выгрузки между проверкой и записью: текст не копируется
2110
+ raise ReviewRejected(copy_missing_message(old)) from e
2111
+ raise
2112
+ text = hub_text(f, hub_verdict(decision, chosen), comment, settings.hub_status_map)
2113
+ # Сохранить черновик можно всегда, а текст в ответе – только по решению с обоснованием человека (ADR-0088):
2114
+ # без решения или с комментарием модели к другому вердикту без «Текст проверен» текст не выдаётся
2115
+ origin = comment_origin(db, case, old, comment, project_id=project_id, hub_id=f.hub_id)
2116
+ text_ok = bool(decision) and not (origin and origin != hub_verdict(decision, chosen) and not comment_confirmed)
2117
+ filters = selection_filters(selection)
2118
+ # обход всех находок выборки («не скопированы», «проверенные») – без возврата к началу: сохранение
2119
+ # без копирования выборку не меняет, и «Дальше» по кругу водило бы по тем же находкам
2120
+ walk = walks_all(selection)
2121
+ next_id = queue_neighbor(db, project_id, row, selection, wrap=not walk,
2122
+ hub_ids=hub_sync_ids(request, project_or_404(request, project_id), selection))
2123
+ total, done = db.count_unreviewed(project_id, filters)
2124
+ notice = "" # предупреждение о прежнем срезе – в карточке (шаг 3), сохранение его не повторяет
2125
+ # готовность дефекта – по тому же правилу, что в карточке и при выдаче текста, а не по виду решения
2126
+ ready = sast_assess(request, project_id, review, db.get_case(project_id, f.hub_id),
2127
+ db.case_input(project_id, f.hub_id))["state"] == "ok" if f.kind == "SAST" \
2128
+ else defect_ready(review)
2129
+ # отпечаток текста для «Отправить в Hub» – того же текста, что выдан в ответе, и только если он совпадает с
2130
+ # текстом сохранённого решения, который соберёт отправка
2131
+ send_hash = (text_hash(text) if text_ok and review and text
2132
+ and text == saved_hub_text(f, review, settings.hub_status_map) else "")
2133
+ # режим панели «Отправить в Hub» после сохранения (dev29): статус уже в Hub – «Обновить комментарий в Hub»
2134
+ replace = (hub_status_routes.replace_answer(request, project_id, f.hub_id, review, text) if send_hash
2135
+ else {"active": False, "note": "", "check": ""})
2136
+ return (review, text if text_ok else "", next_id, {"total": total, "reviewed": done}, notice, ready, text_ok,
2137
+ send_hash, replace)
2138
+
2139
+ try:
2140
+ review, text, next_id, progress, notice, ready, text_ok, send_hash, replace = await run_in_threadpool(apply)
2141
+ except CommentNeedsCheck as e:
2142
+ return JSONResponse({"ok": False, "detail": str(e), "reason": "comment"}, status_code=409)
2143
+ except hub_defects.DefectBound as e: # находка в дефекте, созданном в Hub: нужно подтверждение (ADR-0121 п. 2)
2144
+ if json_answer:
2145
+ return JSONResponse({"ok": False, "detail": str(e), "reason": "defect"}, status_code=409)
2146
+ # без скрипта – карточка с текстом отказа, черновиком и открытым флажком подтверждения
2147
+ draft = {"decision": decision, "final_verdict": final_verdict if final_verdict in VERDICTS else "",
2148
+ "comment": comment, "reviewed": reviewed, "fix": final_fix or ""}
2149
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409, draft,
2150
+ defect_bound=str(e))
2151
+ except ReviewRejected as e:
2152
+ if json_answer:
2153
+ return JSONResponse({"ok": False, "detail": str(e), "reason": "rejected"}, status_code=400)
2154
+ draft = {"decision": decision, "final_verdict": final_verdict if final_verdict in VERDICTS else "",
2155
+ "comment": comment, "reviewed": reviewed, "fix": final_fix or ""}
2156
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 400, draft)
2157
+ except StaleReview as e:
2158
+ message = STALE_MESSAGES.get(e.reason, STALE_MESSAGES["source"])
2159
+ if json_answer:
2160
+ return JSONResponse({"ok": False, "detail": message, "reason": e.reason}, status_code=409)
2161
+ # введённое человеком не теряется: черновик подставляется в форму для повторной сверки, но не пишется
2162
+ draft = {"decision": decision if decision in (*DECISIONS, *SAST_OUTCOMES) else "",
2163
+ "final_verdict": final_verdict if final_verdict in VERDICTS else "", "comment": comment,
2164
+ "reviewed": False, "fix": final_fix or ""}
2165
+ return await run_in_threadpool(card_response, request, project_id, finding_id,
2166
+ message + " Ваш вариант решения подставлен в форму – сверьте его с "
2167
+ "находкой и сохраните ещё раз. Отметка «Проверено» снята: после сверки "
2168
+ "установите её заново.", 409, draft)
2169
+ if json_answer:
2170
+ return JSONResponse({"ok": True, "hub_text": text, "copy_allowed": text_ok,
2171
+ # отпечаток выданного текста: отметка «Внесено в Hub» сверит его с текущим
2172
+ "entered_hash": text_hash(text) if text_ok and text else "",
2173
+ "hub_send_hash": send_hash, # «Отправить в Hub» сверит отпечаток показанного текста
2174
+ "hub_replace": replace, # режим панели «Отправить в Hub» (dev29)
2175
+ "final_verdict": review.get("final_verdict", ""),
2176
+ "defect_ready": ready,
2177
+ "reviewed": bool(review.get("reviewed")), "revision": review.get("revision"),
2178
+ "reviewed_at": review.get("reviewed_at"), "progress": progress, "notice": notice,
2179
+ "entered": bool(review.get("entered_hub")), "entered_at": review.get("entered_hub_at"),
2180
+ "copied_at": review.get("copied_at")})
2181
+ sel = f"&{sel_query}" if sel_query else ""
2182
+ if action == "next":
2183
+ if next_id is not None: # на следующей карточке – строка «Сохранено: … · вернуться»
2184
+ return redirect(f"/projects/{project_id}/findings/{next_id}?saved={finding_id}{sel}")
2185
+ if walks_all(selection): # последняя находка выборки – обратно к ней же
2186
+ return redirect(f"/projects/{project_id}/findings?{sel_query}&ok=selection_end")
2187
+ if not review.get("reviewed"):
2188
+ return redirect(f"/projects/{project_id}/findings/{finding_id}?ok=no_other{sel}")
2189
+ if selection: # выборка пройдена – обратно к ней же, а не ко всему списку
2190
+ return redirect(f"/projects/{project_id}/findings?{sel_query}&ok=selection_done")
2191
+ return redirect(f"/projects/{project_id}/findings?ok=all_reviewed")
2192
+ # после сохранения – к следующему шагу маршрута (У1): перенос в Hub, у отложенной – «Дальше»; не к началу карточки
2193
+ step = "#step-7" if decision == "later" else ("#step-6" if ready else "#decision")
2194
+ return redirect(f"/projects/{project_id}/findings/{finding_id}?ok=saved{sel}{step}")
2195
+
2196
+
2197
+ @router.post("/projects/{project_id}/findings/{finding_id}/copied")
2198
+ async def mark_copied(request: Request, project_id: int, finding_id: int):
2199
+ """Браузер подтвердил, что текст для Hub попал в буфер обмена (revision – редакция скопированного решения)."""
2200
+ form = await request.form()
2201
+ raw = str(form.get("revision") or "").strip()
2202
+ if not raw.isdigit() or int(raw) < 1:
2203
+ raise HTTPException(status_code=400, detail="Не указана редакция решения.")
2204
+
2205
+ def apply():
2206
+ row = finding_or_404(request, project_id, finding_id)
2207
+ return db_of(request).mark_copied(project_id, row["hub_id"], int(raw))
2208
+
2209
+ copied_at = await run_in_threadpool(apply)
2210
+ if copied_at is None:
2211
+ raise HTTPException(status_code=409, detail="Решение не сохранено или изменилось после копирования: "
2212
+ "скопируйте текст ещё раз.")
2213
+ return {"ok": True, "copied_at": copied_at}
2214
+
2215
+
2216
+ @router.post("/projects/{project_id}/findings/{finding_id}/reviewed")
2217
+ async def mark_reviewed(request: Request, project_id: int, finding_id: int):
2218
+ """Отметка «Проверено» отдельно от решения (клавиша v): решение и комментарий не меняются, редакция решения
2219
+ растёт – ответ сообщает новую. Проверки – как при сохранении решения: что видел человек и код в клоне."""
2220
+ form = await request.form()
2221
+ reviewed = str(form.get("reviewed") or "") == "1"
2222
+ shown_version = str(form.get("finding_version") or "")
2223
+ shown_verdict = str(form.get("verdict_id") or "").strip()
2224
+ shown_revision = _form_int(form.get("review_revision"))
2225
+ shown_code = str(form.get("code_hash") or "").strip()[:64]
2226
+ shown_chars = _form_int(form.get("code_chars"))
2227
+ selection = read_selection(request.query_params)
2228
+
2229
+ def apply():
2230
+ row = finding_or_404(request, project_id, finding_id)
2231
+ db = db_of(request)
2232
+ if shown_verdict and not shown_verdict.isdigit():
2233
+ raise HTTPException(status_code=400, detail="Неверный вердикт.")
2234
+ f = Finding.from_dict(row["data"])
2235
+ case = db.get_case(project_id, f.hub_id)
2236
+ expected_verdict = int(shown_verdict) if shown_verdict else None
2237
+ check_shown(db, project_id, f, case, shown_version, expected_verdict, shown_revision)
2238
+ code = check_code(request, project_id, f, case, shown_code, shown_chars)
2239
+ expect = {"version": shown_version, "verdict_id": expected_verdict, "revision": shown_revision}
2240
+ # Отметка снимок решения не меняет. Если решение есть, код сверяется с отпечатком самого решения (при его
2241
+ # размере среза); если решения нет, отметка запоминает код, который видел человек
2242
+ own = db.get_review(project_id, f.hub_id)
2243
+ if own and own.get("decision"):
2244
+ current = db.case_input(project_id, f.hub_id)
2245
+ same = (current_code(settings_of(request), current, mask_key_of(request), int(own["code_chars"]),
2246
+ case=case)[2]
2247
+ if current is not None and own.get("code_chars") else "")
2248
+ review = db.set_reviewed(project_id, f.hub_id, reviewed, expect=expect, code_hash=same)
2249
+ else:
2250
+ review = db.set_reviewed(project_id, f.hub_id, reviewed, expect=expect, code_hash=code["hash"],
2251
+ code_chars=code["chars"])
2252
+ return review, progress_of(db, project_id, selection)
2253
+
2254
+ try:
2255
+ review, progress = await run_in_threadpool(apply)
2256
+ except StaleReview as e:
2257
+ message = STALE_MESSAGES.get(e.reason, STALE_MESSAGES["source"])
2258
+ if wants_json(request):
2259
+ return JSONResponse({"ok": False, "detail": message, "reason": e.reason}, status_code=409)
2260
+ return await run_in_threadpool(card_response, request, project_id, finding_id, message, 409)
2261
+ except ValueError as e: # отложенная находка
2262
+ if wants_json(request):
2263
+ return JSONResponse({"ok": False, "detail": str(e)}, status_code=400)
2264
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 400)
2265
+ if wants_json(request):
2266
+ marks = review_json(review)
2267
+ return {"ok": True, **marks, "progress": progress, "checked": {"reviewed-box": marks["reviewed"]},
2268
+ "show" if marks["reviewed"] else "hide": ["reviewed-badge"],
2269
+ "text": {"progress-label": f"Проверено {progress['reviewed']} из {progress['total']} · осталось "
2270
+ f"{max(0, progress['total'] - progress['reviewed'])}"}}
2271
+ return redirect(card_url(project_id, finding_id, selection, ok="reviewed" if reviewed else "unreviewed"))
2272
+
2273
+
2274
+ @router.post("/projects/{project_id}/findings/{finding_id}/entered")
2275
+ async def mark_entered(request: Request, project_id: int, finding_id: int):
2276
+ """Отметка «Внесено в Hub» (клавиша h): человек сам вставил статус и комментарий в Hub. Редакция решения
2277
+ не меняется: отметка подтверждает текст редакции review_revision; если решение с тех пор сохранили заново
2278
+ (другая вкладка), отметка не ставится."""
2279
+ form = await request.form()
2280
+ entered = str(form.get("entered") or "1") == "1"
2281
+ revision = _form_int(form.get("review_revision"))
2282
+ selection = read_selection(request.query_params)
2283
+ defect_confirmed = str(form.get("defect_confirm") or "") == "1" # снять отметку у находки в дефекте (ADR-0121)
2284
+
2285
+ def apply():
2286
+ row = finding_or_404(request, project_id, finding_id)
2287
+ db = db_of(request)
2288
+ review = db.get_review(project_id, row["hub_id"])
2289
+ if entered and not (review and review.get("decision")):
2290
+ raise ValueError(ENTERED_NO_DECISION)
2291
+ if entered and revision is None: # страница до обновления приложения: без редакции отметка не ставится
2292
+ return None
2293
+ f = Finding.from_dict(row["data"])
2294
+ if (entered and f.kind == "SAST"
2295
+ and sast_outcome(review["decision"], review["final_verdict"]) not in SAST_OUTCOMES):
2296
+ raise ValueError(SAST_ENTER_ONLY)
2297
+ if entered and f.kind == "SAST" and not defect.reason_text(review.get("final_comment") or ""):
2298
+ raise ValueError(ENTERED_NEEDS_REASON) # прежнее решение без обоснования: в Hub такого текста нет
2299
+ if (entered and f.kind == "SAST" and sast_outcome(review["decision"], review["final_verdict"]) == "true_positive"
2300
+ and not defect.has_recommendation(str(review.get("final_fix") or ""))):
2301
+ raise ValueError(ENTERED_NEEDS_FIX) # дефект без рекомендации оператора не готовится (ADR-0092)
2302
+ if entered: # отметка – о тексте с обоснованием человека, не модели к другому вердикту (ADR-0088)
2303
+ origin = comment_origin(db, db.get_case(project_id, f.hub_id), review, review.get("final_comment") or "",
2304
+ project_id=project_id, hub_id=f.hub_id)
2305
+ target = hub_verdict(review["decision"], review["final_verdict"])
2306
+ if origin and origin != target and not comment_confirm_valid(form, review):
2307
+ raise CommentNeedsCheck(entered_check_text(origin, target))
2308
+ settings = settings_of(request) # один снимок: отпечаток текста и его составляющие – по одним настройкам
2309
+ text = sast_entered_text(db, settings, project_id, f, review)
2310
+ # отпечаток текста, который человек скопировал или видел в карточке: если текст с тех пор другой (например,
2311
+ # сменилось название команды), отметка подтвердила бы то, чего в Hub нет
2312
+ shown_hash = str(form.get("text_hash") or "").strip()
2313
+ if entered and f.kind == "SAST" and not shown_hash: # страница до 0.9.6: что показано – неизвестно
2314
+ raise ValueError(ENTERED_RELOAD)
2315
+ if entered and shown_hash and shown_hash != text_hash(text):
2316
+ raise ValueError(ENTERED_TEXT_MOVED)
2317
+ parts = entered_parts(settings, review) if entered and f.kind == "SAST" else ""
2318
+ # снять отметку у находки в дефекте, созданном в Hub, – только с подтверждением; Hub не трогается (ADR-0121 п. 4)
2319
+ check = None if entered or defect_confirmed else hub_defects.unenter_check(project_id, row["hub_id"])
2320
+ return db.mark_entered(project_id, row["hub_id"], entered, revision=revision, entered_hash=text_hash(text),
2321
+ entered_parts=parts, check=check)
2322
+
2323
+ try:
2324
+ review = await run_in_threadpool(apply)
2325
+ except CommentNeedsCheck as e:
2326
+ if wants_json(request):
2327
+ return JSONResponse({"ok": False, "detail": str(e), "reason": "comment"}, status_code=409)
2328
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409)
2329
+ except hub_defects.DefectBound as e: # находка в дефекте, созданном в Hub (ADR-0121 п. 4)
2330
+ if wants_json(request):
2331
+ return JSONResponse({"ok": False, "detail": str(e), "reason": "defect"}, status_code=409)
2332
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409)
2333
+ except ValueError as e:
2334
+ if wants_json(request):
2335
+ return JSONResponse({"ok": False, "detail": str(e)}, status_code=400)
2336
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 400)
2337
+ if review is None:
2338
+ if wants_json(request):
2339
+ return JSONResponse({"ok": False, "detail": ENTERED_STALE, "reason": "revision"}, status_code=409)
2340
+ return await run_in_threadpool(card_response, request, project_id, finding_id, ENTERED_STALE, 409)
2341
+ if wants_json(request):
2342
+ marks = review_json(review)
2343
+ # Редакция решения не меняется и в ответ не входит: иначе скрипт записал бы её в форму решения, и форма
2344
+ # из устаревшей вкладки перестала бы считаться устаревшей
2345
+ marks.pop("revision")
2346
+ shown, hidden = ["entered-badge", "entered-note"], ["mark-entered", "entered-changed", "entered-unconfirmed",
2347
+ "entered-format-updated", "entered-bulk"]
2348
+ return {"ok": True, **marks,
2349
+ "message": "Отмечено: внесено в Hub." if entered else "Отметка «Внесено в Hub» снята.",
2350
+ "times": {"entered-at": {"prefix": "Внесено в Hub " if entered else "",
2351
+ "datetime": marks['entered_at'] if entered else "", "suffix": "."}},
2352
+ "show": shown if entered else ["mark-entered"],
2353
+ # пометка «общим комментарием из списка» относится к снятой или заменённой отметке
2354
+ "hide": hidden if entered else shown + ["entered-bulk"]}
2355
+ return redirect(card_url(project_id, finding_id, selection, ok="entered" if entered else "unentered"))
2356
+
2357
+
2358
+ DEFECT_NOT_READY = ("Дефект готовится только по сохранённому решению с итогом «истинная» или «ложная»: сохраните "
2359
+ "решение и попробуйте ещё раз.")
2360
+ SAST_DEFECT_NOT_READY = ("Дефект готовится только по сохранённому решению «Подтверждаю дефект»: сохраните решение и "
2361
+ "попробуйте ещё раз. Для ложного срабатывания в Hub уходит короткий комментарий.")
2362
+ DEFECT_BAD_NUMBER = "Номер дефекта – целое число от 1 до 999999 (число после «ID» в Hub)."
2363
+ NUMBER_CHANGED = ("Номер дефекта изменили в другой вкладке, пока карточка была открыта: номер не перезаписан. "
2364
+ "Обновите карточку и проверьте номер.")
2365
+
2366
+
2367
+ def expected_number(form) -> object:
2368
+ """Номер, который был сохранён при открытии карточки (поле number_shown): None – номера не было; без поля или с
2369
+ неверным значением – NO_EXPECT (не сверяется в транзакции)."""
2370
+ shown = form.get("number_shown")
2371
+ if shown is None:
2372
+ return NO_EXPECT
2373
+ text = str(shown).strip()
2374
+ if not text:
2375
+ return None
2376
+ return int(text) if text.isdigit() else NO_EXPECT
2377
+
2378
+
2379
+ def foreign_number_check(allowed: set[str], confirmed: bool):
2380
+ """Проверка чужих держателей номера в транзакции записи (Б9, К3): номер у ключей вне allowed без подтверждения –
2381
+ DefectNeedsConfirm (запись откатывается)."""
2382
+ def check(keys: list[str]) -> None:
2383
+ warning = duplicate_number_warning([k for k in keys if k not in allowed])
2384
+ if warning and not confirmed:
2385
+ raise DefectNeedsConfirm(warning)
2386
+ return check
2387
+
2388
+
2389
+ def confirm_extra(form, e: DefectNeedsConfirm) -> dict:
2390
+ """Форма дефекта после отказа «нужно подтверждение» без скрипта (К5): предупреждения (флажок открыт) и номер,
2391
+ который ввёл человек."""
2392
+ extra = {"warnings": list(e.warnings)}
2393
+ raw = str(form.get("number") or "").strip()
2394
+ if raw: # введённый номер – только в поле ввода; сохранённый (number_shown) остаётся прежним (К5)
2395
+ extra["entered_number"] = raw
2396
+ return extra
2397
+
2398
+
2399
+ def number_shown_changed(form, stored: int | None) -> bool:
2400
+ """Форма прислала номер, который был сохранён при открытии карточки (number_shown; пусто – номера не было), а
2401
+ сейчас сохранён другой: выдача из устаревшей вкладки номер не перезаписывает (Б9). Без поля – не проверяется."""
2402
+ shown = form.get("number_shown")
2403
+ return shown is not None and str(shown).strip() != ("" if stored is None else str(stored))
2404
+
2405
+
2406
+ def duplicate_number_warning(keys: list[str]) -> list[str]:
2407
+ """Предупреждение до записи: этот номер уже у других находок или пакетов проекта (не той же группы)."""
2408
+ return [f"Номер уже дан ещё {len(keys)} {'находке или пакету' if len(keys) == 1 else 'находкам или пакетам'} "
2409
+ "проекта: если в Hub это другой дефект, укажите другой номер."] if keys else []
2410
+
2411
+ register_messages({"defect_saved": "Номер дефекта сохранён: заголовок и текст – в разделе «Дефект для Hub»."})
2412
+
2413
+
2414
+ def read_defect_number(form) -> int | None:
2415
+ """Номер дефекта из формы; пусто – None (возьмётся сохранённый или следующий); неверный – ValueError."""
2416
+ raw = str(form.get("number") or "").strip().removeprefix("ID").removeprefix("id").strip()
2417
+ if not raw:
2418
+ return None
2419
+ number = _form_int(raw)
2420
+ if number is None or not 1 <= number <= 999_999:
2421
+ raise ValueError(DEFECT_BAD_NUMBER)
2422
+ return number
2423
+
2424
+
2425
+ GROUP_NUMBER_NOTE = ("Тот же номер – у находок с той же строкой и категорией: в Hub это один дефект, создайте его "
2426
+ "сразу из всех этих находок.")
2427
+
2428
+
2429
+ def defect_duplicates_note(keys: list[str]) -> str:
2430
+ if not keys:
2431
+ return ""
2432
+ return (f"Этот номер уже дан ещё {len(keys)} "
2433
+ f"{'находке' if len(keys) == 1 else 'находкам'} проекта – проверьте, что в Hub это один дефект.")
2434
+
2435
+
2436
+ @router.post("/projects/{project_id}/findings/{finding_id}/defect")
2437
+ async def copy_defect(request: Request, project_id: int, finding_id: int):
2438
+ """Заголовок и текст дефекта для Hub (JSON: number, title, body, note): номер из формы запоминается за находкой.
2439
+ Без скрипта – переход обратно на карточку, где текст виден в разделе «Дефект для Hub»."""
2440
+ form = await request.form(max_fields=10, max_files=0)
2441
+ selection = read_selection(request.query_params)
2442
+ confirmed = str(form.get("confirm") or "") == "1"
2443
+ stale_confirmed = [] # комментарий модели к другому вердикту выдан по отметке «Текст проверен»
2444
+
2445
+ def apply():
2446
+ project_or_404(request, project_id)
2447
+ row = finding_or_404(request, project_id, finding_id)
2448
+ db = db_of(request)
2449
+ number = read_defect_number(form)
2450
+ shown_revision = _form_int(form.get("review_revision"))
2451
+ # Один снимок: находка, источник её кода, решение и привязка к вердикту читаются здесь же, текст строится
2452
+ # из этой находки, а перед записью номера снимок проверяется заново в короткой транзакции (CWE-367)
2453
+ source = db.case_input(project_id, row["hub_id"])
2454
+ if source is None:
2455
+ raise DefectBlocked(SAST_STATE_HINTS["missing"])
2456
+ f = Finding.from_dict(source["data"])
2457
+ if f.kind != "SAST":
2458
+ raise ValueError("Дефект SCA готовится в карточке SCA.")
2459
+ review = db.get_review(project_id, f.hub_id)
2460
+ case = db.get_case(project_id, f.hub_id)
2461
+ # актуальность решения проверяется при каждой выдаче текста, а не только при открытии карточки:
2462
+ # пропавшая находка, новая выгрузка, новый разбор и правка кода в клоне закрывают выдачу (409)
2463
+ assessment = sast_assess(request, project_id, review, case, source)
2464
+ # находка, её код или вердикт изменились: точная причина и обновление карточки
2465
+ if assessment["state"] in SAST_HISTORIC_STATES:
2466
+ raise DefectReload(sast_state_hint(assessment["state"], review))
2467
+ # карточка показывает другую редакцию решения (его сохранили в другой вкладке): текст выдаётся только к той,
2468
+ # которую человек видит, иначе «скопировано» и «Внесено в Hub» разошлись бы с формой. Проверяется до
2469
+ # остальных отказов: другая вкладка могла сменить и само решение (на «Отложить» или ложное срабатывание)
2470
+ if shown_revision is not None and shown_revision != int((review or {}).get("revision") or 0):
2471
+ raise DefectReload(DEFECT_OTHER_REVISION)
2472
+ if assessment["state"] != "ok":
2473
+ raise DefectBlocked(sast_state_hint(assessment["state"], review, SAST_DEFECT_NOT_READY))
2474
+ if not defect.reason_text(review.get("final_comment") or ""):
2475
+ raise DefectBlocked(DEFECT_NEEDS_REASON)
2476
+ if not defect.has_recommendation(str(review.get("final_fix") or "")):
2477
+ raise DefectBlocked(DEFECT_NEEDS_FIX)
2478
+ if not str(settings_of(request).team_name or "").strip():
2479
+ raise DefectBlocked(DEFECT_NEEDS_TEAM)
2480
+ # комментарий модели к другому вердикту не выдаётся молча ни коротким, ни полным текстом (R092-02)
2481
+ origin = comment_origin(db, case, review, review.get("final_comment") or "", project_id=project_id,
2482
+ hub_id=f.hub_id)
2483
+ target = hub_verdict(review["decision"], review["final_verdict"])
2484
+ if origin and origin != target:
2485
+ # отметка «Текст проверен» – к той редакции решения, которую человек видел (не к изменённой в другой вкладке)
2486
+ if not comment_confirm_valid(form, review):
2487
+ raise CommentNeedsCheck(comment_check_text(origin, target))
2488
+ stale_confirmed.append(int(review["revision"]))
2489
+ # та же строка и категория – один дефект: тот же номер, то же решение и тот же текст (ADR-0089)
2490
+ key = group_key(f)
2491
+ verdict = Verdict.from_dict(case["verdict"]["data"]) if assessment["use_verdict"] else None
2492
+ mine = defect.sast_effective("true_positive", review.get("final_comment") or "",
2493
+ str(review.get("final_fix") or ""))
2494
+
2495
+ own_number = db.defect_number(project_id, defect.defect_key_sast(f.hub_id))
2496
+ if number_shown_changed(form, own_number):
2497
+ raise DefectReload(NUMBER_CHANGED)
2498
+ own_at = db.defect_assigned_at(project_id, defect.defect_key_sast(f.hub_id))
2499
+ mine_cmp = own_code_cmp(db, project_id, f.hub_id)
2500
+ own_case = (case or {}).get("case_hash")
2501
+ states = sibling_states(request, db, project_id, same_code(db.group_rows(project_id, key, f.hub_id), mine_cmp))
2502
+
2503
+ merge = db.group_merge(project_id, key) # не меняется после шага 20: читать вне транзакции можно
2504
+
2505
+ def defect_group_check(rows: list[dict], issued: int | None, own: int | None, at: str | None = None) -> None:
2506
+ now = db.get_case(project_id, f.hub_id) or {} # собственный срез – тот же, что при оценке (ADR-0092 п. 6)
2507
+ if now.get("case_hash") != own_case or str(now.get("code_cmp") or "") != mine_cmp:
2508
+ raise DefectReload(GROUP_MOVED)
2509
+ try:
2510
+ near = current_rows(same_code(rows, mine_cmp), states,
2511
+ lambda hub_id: source_sig(db.case_input(project_id, hub_id)))
2512
+ except ReviewRejected as e:
2513
+ raise DefectReload(str(e)) from e
2514
+ conflict = group_conflict_rows(near, mine)
2515
+ if conflict:
2516
+ raise DefectBlocked(conflict)
2517
+ plan_rows, foreign = number_rows(rows, mine_cmp, own, own_at if at is None else at, f.hub_id)
2518
+ if issued is not None and issued in foreign:
2519
+ raise ValueError(FOREIGN_NUMBER.format(n=issued))
2520
+ if merge: # группа слилась при обновлении схемы: номера не сводятся (ADR-0095 п. 4)
2521
+ error = merged_number_plan(merged_members(rows, mine_cmp, f.hub_id, own, foreign), f.hub_id,
2522
+ merge["numbers"], issued)[1]
2523
+ else:
2524
+ error = group_number_plan(plan_rows, issued, own if own not in foreign else None)[1]
2525
+ if error:
2526
+ raise ValueError(error)
2527
+ defect_group_check(db.group_rows(project_id, key, f.hub_id), number, own_number)
2528
+ view = sast_defect(db, settings_of(request), store_of(request), project_id, f, review, verdict, number,
2529
+ shown=defect_shown_lines(request, project_id, f, case), state="ok", source=source)
2530
+ # тот же номер у находок с той же строкой и категорией – ожидаемо: в Hub это один дефект (ADR-0089)
2531
+ group = {defect.defect_key_sast(r["hub_id"])
2532
+ for r in same_code(db.group_rows(project_id, key, f.hub_id), mine_cmp)} | {
2533
+ defect.defect_key_sast(f.hub_id)}
2534
+ # ссылки на строки, которых нет в показанном коде, и чужой номер проверяются перед каждой выдачей текста
2535
+ warnings = view["warnings"] + duplicate_number_warning(
2536
+ [k for k in db.defect_keys_with_number(project_id, view["number"]) if k not in group])
2537
+ if warnings and not confirmed:
2538
+ raise DefectNeedsConfirm(warnings)
2539
+ duplicates = db.set_defect_number_checked(
2540
+ project_id, defect.defect_key_sast(f.hub_id), view["number"], f.hub_id, source_sig=source_signature(source),
2541
+ revision=int(review["revision"]), case_verdict_id=case["verdict_id"] if case else None,
2542
+ export=defect.export_label(source.get("import_filename", ""), source.get("import_at", "")),
2543
+ group_key=key, group_check=lambda rows, own, at=None: defect_group_check(rows, view["number"], own, at),
2544
+ expect_number=expected_number(form), foreign_check=foreign_number_check(group, confirmed))
2545
+ note = defect_duplicates_note([k for k in duplicates if k not in group])
2546
+ if any(k in group for k in duplicates):
2547
+ note = (note + " " if note else "") + GROUP_NUMBER_NOTE
2548
+ if view.get("group_note"):
2549
+ note = (note + " " if note else "") + view["group_note"]
2550
+ # редакция и отпечаток выданного текста: «скопировано» и «Внесено в Hub» относятся к ним
2551
+ # entered_current – отметка «Внесено в Hub» поставлена именно по этому тексту (иначе её нужно подтвердить)
2552
+ body_hash = text_hash(view["body"])
2553
+ entered_hash = review.get("entered_decision_hash") if review.get("entered_origin") == "defect" else review.get("entered_text_hash")
2554
+ return {**view, "stored": True, "note": note, "revision": int(review["revision"]),
2555
+ "entered": bool(review.get("entered_hub")), "entered_hash": body_hash,
2556
+ "entered_current": bool(review.get("entered_hub")) and entered_hash == body_hash}
2557
+
2558
+ try:
2559
+ view = await run_in_threadpool(apply)
2560
+ except CommentNeedsCheck as e:
2561
+ if wants_json(request):
2562
+ return JSONResponse({"ok": False, "detail": str(e), "reason": "comment"}, status_code=409)
2563
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409)
2564
+ except StaleReview as e: # снимок изменился между проверкой и записью номера
2565
+ message = DEFECT_RACE + " " + STALE_MESSAGES.get(e.reason, STALE_MESSAGES["source"])
2566
+ if wants_json(request):
2567
+ return JSONResponse({"ok": False, "detail": message, "reason": e.reason, "reload": True}, status_code=409)
2568
+ return await run_in_threadpool(card_response, request, project_id, finding_id, message, 409)
2569
+ except (ValueError, ReviewRejected) as e:
2570
+ if wants_json(request):
2571
+ return defect_error_response(e, ReviewRejected)
2572
+ if isinstance(e, DefectNeedsConfirm): # без скрипта (К5): флажок подтверждения открыт, введённый номер сохранён
2573
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409, None, "",
2574
+ None, confirm_extra(form, e))
2575
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e),
2576
+ 409 if isinstance(e, DefectBlocked) else 400)
2577
+ if wants_json(request):
2578
+ return {"ok": True, "number": view["number"], "title": view["title"], "body": view["body"],
2579
+ "note": view["note"], "revision": view.get("revision"), "entered": view.get("entered", False),
2580
+ "entered_hash": view.get("entered_hash", ""), "entered_current": view.get("entered_current", False)}
2581
+ if stale_confirmed: # без скрипта: карточка показывает выданный по отметке текст (после перехода он снова скрыт)
2582
+ return await run_in_threadpool(card_response, request, project_id, finding_id, "", 200, None, "",
2583
+ stale_confirmed[0])
2584
+ return redirect(card_url(project_id, finding_id, selection, ok="defect_saved") + "#defect-panel")
2585
+
2586
+
2587
+ register_messages({"defect_number_released": "Номер дефекта снят: находка – ложное срабатывание, дефект не создаётся.",
2588
+ "defect_number_released_others": "Номер дефекта снят у этой находки, но он остаётся у других находок проекта (например, у соседа по группе с решением «Подтверждаю дефект»): дефект с этим номером в заголовке Hub по-прежнему считает его занятым."})
2589
+ RELEASE_NOT_FALSE = "Номер снимается только у находки с решением «Ложное срабатывание»: обновите карточку."
2590
+
2591
+
2592
+ register_messages({"defect_dropped_cleared": "Пометка «выбыла из дефекта» снята: находка остаётся без дефекта."})
2593
+
2594
+
2595
+ @router.post("/projects/{project_id}/findings/{finding_id}/defect-dropped/clear")
2596
+ async def clear_defect_dropped(request: Request, project_id: int, finding_id: int):
2597
+ """«Оставить как есть» у находки, выбывшей из дефекта: оператор решил, что дефект ей не
2598
+ нужен. Решение и отметки не меняются; пометка снимается, только если она та же, что показана в карточке."""
2599
+ form = await request.form(max_fields=4, max_files=0)
2600
+ selection = read_selection(request.query_params)
2601
+
2602
+ def apply():
2603
+ row = finding_or_404(request, project_id, finding_id)
2604
+ if not db_of(request).clear_defect_dropped(project_id, str(row["hub_id"]), str(form.get("dropped_shown") or "")):
2605
+ raise ValueError("Пометка изменилась или уже снята: обновите карточку.")
2606
+ return row
2607
+
2608
+ try:
2609
+ row = await run_in_threadpool(apply)
2610
+ except ValueError as e:
2611
+ current = db_of(request).get_finding(project_id, finding_id)
2612
+ if current is not None and current["kind"] == "SCA": # отказ – карточкой своего раздела
2613
+ from app.routes import sca as sca_routes
2614
+ return await run_in_threadpool(sca_routes.card_response, request, project_id, finding_id, str(e), 409)
2615
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409)
2616
+ section = "sca/findings" if row["kind"] == "SCA" else "findings"
2617
+ q = query(selection, ok="defect_dropped_cleared")
2618
+ return redirect(f"/projects/{project_id}/{section}/{finding_id}?{q}")
2619
+
2620
+
2621
+ @router.post("/projects/{project_id}/findings/{finding_id}/defect-number/release")
2622
+ async def release_defect_number(request: Request, project_id: int, finding_id: int):
2623
+ """«Снять номер» у ложного срабатывания (ADR-0125 «Уточнения»): номер, показанный в карточке (number_shown),
2624
+ удаляется одной транзакцией, если решение всё ещё «Ложное срабатывание» и находка не входит в дефект приложения
2625
+ (Database.release_defect_number). Номер, оставшийся от прежней выдачи текста, перестаёт занимать номер из
2626
+ заголовка Hub у настоящего дефекта."""
2627
+ form = await request.form(max_fields=4, max_files=0)
2628
+ selection = read_selection(request.query_params)
2629
+
2630
+ def apply():
2631
+ project_or_404(request, project_id)
2632
+ row = finding_or_404(request, project_id, finding_id)
2633
+ number = _form_int(form.get("number_shown"))
2634
+ if number is None:
2635
+ raise ValueError("Номера у находки нет: обновите карточку.")
2636
+ hub_id = str(row["hub_id"])
2637
+
2638
+ def still_false(c) -> None:
2639
+ review = c.execute("SELECT decision, final_verdict FROM reviews WHERE project_id = ? AND hub_id = ?",
2640
+ (project_id, hub_id)).fetchone()
2641
+ if review is None or not review["decision"] or hub_verdict(
2642
+ review["decision"], review["final_verdict"]) != "false_positive":
2643
+ raise ValueError(RELEASE_NOT_FALSE)
2644
+
2645
+ return db_of(request).release_defect_number(project_id, defect.defect_key_sast(hub_id), hub_id, number,
2646
+ check=still_false)
2647
+
2648
+ try:
2649
+ others = await run_in_threadpool(apply)
2650
+ except ValueError as e:
2651
+ if wants_json(request):
2652
+ return JSONResponse({"ok": False, "detail": str(e)}, status_code=409)
2653
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409)
2654
+ if wants_json(request):
2655
+ return {"ok": True, "others": others}
2656
+ done = "defect_number_released_others" if others else "defect_number_released"
2657
+ return redirect(card_url(project_id, finding_id, selection, ok=done) + "#step-6")
2658
+
2659
+
2660
+ # ============================================================================ адреса: модель
2661
+
2662
+ @router.post("/projects/{project_id}/findings/{finding_id}/ask")
2663
+ async def ask_model(request: Request, project_id: int, finding_id: int):
2664
+ """«Спросить модель»: вопрос по находке и ответ локальной модели (app/ask.py). Ответ ждёт модели – до
2665
+ нескольких минут на медленной модели; вопрос и ответ сохраняются, даже если человек ушёл со страницы."""
2666
+ form = await request.form()
2667
+ question = str(form.get("question") or "")[:ask.MAX_QUESTION * 2]
2668
+ model = str(form.get("model") or "").strip()[:MAX_NAME]
2669
+ selection = read_selection(request.query_params)
2670
+
2671
+ def apply():
2672
+ row = finding_or_404(request, project_id, finding_id)
2673
+ # фабрика клиента: адрес и срок – из снимка исполнителя вопроса (ADR-0102), а не из текущих настроек
2674
+ return ask.ask_question(db_of(request), settings_of(request), web_of(request).make_client,
2675
+ mask_key_of(request), project_id, row["hub_id"], question, model)
2676
+
2677
+ try:
2678
+ answered = await run_in_threadpool(apply)
2679
+ except ask.AskError as e:
2680
+ if wants_json(request):
2681
+ return JSONResponse({"ok": False, "detail": str(e)}, status_code=e.status)
2682
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), e.status, None,
2683
+ ask.clean_question(question))
2684
+ # ответ (или ошибка модели) сохранён у находки: карточка открывается заново на этом вопросе
2685
+ ok = "asked" if answered.get("state") == "done" else "ask_failed"
2686
+ url = card_url(project_id, finding_id, selection, ok=ok, asked=answered.get("id", "")) + \
2687
+ f"#q{answered.get('id', '')}"
2688
+ if wants_json(request):
2689
+ case = db_of(request).get_case(project_id, answered.get("hub_id", ""))
2690
+ verdict_id = case["verdict_id"] if case else None
2691
+ return {"ok": True, "answered": answered.get("state") == "done", "redirect": url,
2692
+ "question": question_view(answered, verdict_id)}
2693
+ return redirect(url)
2694
+
2695
+
2696
+ @router.get("/projects/{project_id}/findings/{finding_id}/questions/{question_id}")
2697
+ def question_state(request: Request, project_id: int, finding_id: int, question_id: int):
2698
+ """Вопрос к модели по находке (JSON): открытая карточка ждёт так ответа, заданного из другой вкладки."""
2699
+ row = finding_or_404(request, project_id, finding_id)
2700
+ db = db_of(request)
2701
+ q = db.get_question(question_id)
2702
+ if q is None or q["project_id"] != project_id or q["hub_id"] != row["hub_id"]:
2703
+ raise HTTPException(status_code=404, detail="Вопрос не найден.")
2704
+ case = db.get_case(project_id, row["hub_id"])
2705
+ done = q["state"] != "pending"
2706
+ return {"question": question_view(q, case["verdict_id"] if case else None), "done": done, "reload": done}
2707
+
2708
+
2709
+ @router.post("/projects/{project_id}/findings/{finding_id}/reanalyze")
2710
+ async def reanalyze(request: Request, project_id: int, finding_id: int):
2711
+ """«Пересмотреть вердикт»: повторный разбор этой находки моделью (можно другой) отдельным прогоном. Готовый
2712
+ вердикт из кэша не берётся (fresh): та же модель на том же коде ответит так же, а другая – по-своему."""
2713
+ form = await request.form()
2714
+ model = str(form.get("model") or "").strip()[:MAX_NAME]
2715
+ fresh = str(form.get("fresh") or "1") == "1"
2716
+ selection = read_selection(request.query_params)
2717
+
2718
+ def apply():
2719
+ row = finding_or_404(request, project_id, finding_id)
2720
+ if row["kind"] != "SAST":
2721
+ raise TriageError("Моделью разбираются только находки SAST.")
2722
+ if row.get("missing"):
2723
+ raise TriageError("Находки нет в текущей выгрузке: разбирать нечего.")
2724
+ if any(ord(ch) < 32 for ch in model):
2725
+ raise TriageError("Не выбрана модель.")
2726
+ return runner_of(request).enqueue(project_id, model, "selected", [row["hub_id"]], fresh=fresh, origin="card")
2727
+
2728
+ try:
2729
+ run_id = await run_in_threadpool(apply)
2730
+ except TriageError as e:
2731
+ if wants_json(request):
2732
+ return JSONResponse({"ok": False, "detail": str(e)}, status_code=409)
2733
+ return await run_in_threadpool(card_response, request, project_id, finding_id, str(e), 409)
2734
+ if wants_json(request):
2735
+ return {"ok": True, "run_id": run_id, "run_url": f"/runs/{run_id}"}
2736
+ return redirect(card_url(project_id, finding_id, selection, ok="reanalyze"))