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,1945 @@
1
+ """Дефект в Hub из карточки (этап 3, ADR-0120): «Создать дефект в Hub» в карточке SAST («Подтверждаю дефект» –
2
+ находка и её группа «та же строка, категория и код» с тем же решением и текстом) и SCA (дефект набора). Цепочка
3
+ операций через исполнителя (ADR-0114): заготовка `GET /defects/blank` → предпросмотр в карточке → `POST /defects` →
4
+ подтверждение чтением `GET /defects/{id}` (при расхождении – `POST /defects/{id}/link` и чтение снова). Статусы
5
+ находок не меняются; отметку «Внесено в Hub» (часть «тело дефекта») ставит подтверждённое чтение (app/hub_defects.py).
6
+
7
+ POST /projects/{id}/findings/{finding_id}/hub-defect – SAST: заготовка (операция defect_blank, при первом
8
+ обращении – и справочник serviceInfo)
9
+ POST /projects/{id}/sca/findings/{finding_id}/hub-defect – SCA
10
+ POST /projects/{id}/hub/defects/{defect_id}/create – «Создать» из предпросмотра (приоритет, серьёзность)
11
+ POST /projects/{id}/hub/defects/{defect_id}/verify – «Сверить» «результат неизвестен»
12
+ POST /projects/{id}/findings/{finding_id}/hub-defect-link – SAST: новая находка группы – «Привязать к дефекту №…»
13
+ (ADR-0121 п. 5, операция defect_link)
14
+ POST /projects/{id}/hub/defects/{defect_id}/recheck – «Проверить в Hub» у созданного дефекта (ADR-0121 п. 6)
15
+ GET /projects/{id}/hub/defects/{defect_id} – состояние для опроса из карточки (JSON)
16
+ GET /projects/{id}/defects – вкладка «Дефекты» проекта
17
+
18
+ «Занести из Hub» и «Pull из Hub» (ADR-0124) – только чтение `GET /defects/{id}`, вкладка «Дефекты»:
19
+
20
+ POST /projects/{id}/defects/import – номера или ссылки дефектов Hub: строки чтения
21
+ POST /projects/{id}/hub/defects/{defect_id}/import – «Занести» из предпросмотра (одна транзакция)
22
+ POST /projects/{id}/hub/defects/{defect_id}/import-cancel – «Отменить» предпросмотр занесения
23
+ POST /projects/{id}/hub/defects/{defect_id}/import-retry – «Повторить чтение» у не удавшегося или отменённого
24
+ POST /projects/{id}/hub/defects/{defect_id}/sync – «Pull из Hub» у занесённого дефекта
25
+ POST /projects/{id}/hub/defects/{defect_id}/sync-apply – «Применить» предпросмотр сверки (только добавление)
26
+ POST /projects/{id}/hub/defects/{defect_id}/sync-cancel – «Отменить» предпросмотр сверки
27
+
28
+ «Push в Hub» (ADR-0125) – заголовок и описание занесённого дефекта запросом `PUT /defects/{id}`:
29
+
30
+ POST /projects/{id}/hub/defects/{defect_id}/update – «Подготовить обновление»: чтение для предпросмотра
31
+ POST /projects/{id}/hub/defects/{defect_id}/update-put – «Push в Hub»: второе чтение, затем PUT и подтверждение
32
+ POST /projects/{id}/hub/defects/{defect_id}/update-cancel – «Отменить» предпросмотр обновления
33
+ POST /projects/{id}/hub/defects/{defect_id}/update-verify – «Сверить» при неизвестном исходе PUT (только чтение)
34
+ POST /projects/{id}/hub/defects/{defect_id}/update-reread – «Повторить чтение» подтверждения
35
+ """
36
+
37
+ from __future__ import annotations
38
+
39
+ import dataclasses
40
+ import json
41
+
42
+ from fastapi import APIRouter, HTTPException, Request
43
+ from starlette.concurrency import run_in_threadpool
44
+
45
+ from app import defect, defect_check, defect_drafts, defect_where, hub_defects, hub_onboarding, hub_ops, hub_status, hub_sync
46
+ from app.db import Database, finding_data_sig, hub_verdict, loads, text_hash
47
+ from app.models import Finding
48
+ from app.routes.common import db_of, project_or_404, redirect, register_messages, render, settings_of, web_of
49
+ from app.routes.feeds import store_of
50
+ from app.routes.hub_status_routes import (
51
+ NOT_REVIEWED,
52
+ STALE_REVISION,
53
+ TEXT_CHANGED,
54
+ TEXT_NOT_SHOWN,
55
+ StaleTarget,
56
+ _finding_of,
57
+ _json_error,
58
+ _refused,
59
+ _target,
60
+ hub_target_check,
61
+ send_blocker,
62
+ wants_json,
63
+ )
64
+
65
+ router = APIRouter()
66
+
67
+ PREVIEW_OPEN = ("Предпросмотр дефекта уже открыт: создайте дефект кнопкой «Создать» или нажмите «Отменить "
68
+ "предпросмотр» и запросите заготовку заново.")
69
+ # предпросмотр собран для прежних приложения или адреса Hub (KIMI-12): дефект туда не создаётся, обновление карточки
70
+ # предпросмотр не пересобирает – нужна новая заготовка
71
+ PREVIEW_TARGET_CHANGED = ("Приложение Hub или адрес Hub изменились после предпросмотра («Параметры проекта» или "
72
+ "«Настройки»): дефект не создаётся – обновите карточку, нажмите «Отменить предпросмотр» и "
73
+ "запросите заготовку заново.")
74
+
75
+ register_messages({
76
+ "hub_defect_cancelled": "Предпросмотр отменён: заготовку дефекта можно запросить заново.",
77
+ "hub_defect_queued": "Поставлено в очередь исполнителю: заготовка дефекта – состояние в блоке «Создать дефект в Hub».",
78
+ "hub_defect_create_queued": "Поставлено в очередь исполнителю: создание дефекта – состояние в блоке «Создать дефект в Hub».",
79
+ "hub_defect_verify_queued": "Сверка поставлена в очередь исполнителю: итог – в блоке «Создать дефект в Hub».",
80
+ "hub_defect_link_queued": "Поставлено в очередь исполнителю: привязка к дефекту – состояние в блоке «Создать дефект в "
81
+ "Hub».",
82
+ "hub_defect_recheck_queued": "Проверка поставлена в очередь исполнителю: итог – в блоке дефекта и во вкладке "
83
+ "«Дефекты».",
84
+ # «Занести из Hub» и «Pull из Hub» (ADR-0124)
85
+ "hub_import_queued": "Поставлено в очередь исполнителю: чтение дефектов из Hub – состояние в строках таблицы.",
86
+ "hub_import_done": "Дефект занесён из Hub: его находки защищены, как у созданного в приложении; номер ID<n> – резерв.",
87
+ "hub_import_cancelled": "Предпросмотр занесения отменён: в Hub ничего не уходило.",
88
+ "hub_import_retry": "Чтение дефекта из Hub поставлено в очередь исполнителю заново.",
89
+ "hub_sync_queued": "Сверка с Hub поставлена в очередь исполнителю: итог – в строке дефекта.",
90
+ "hub_sync_applied": "Сверка применена: находки добавлены в дефект, заголовок и текст – из Hub.",
91
+ "hub_sync_cancelled": "Предпросмотр сверки отменён: дефект в приложении прежний.",
92
+ })
93
+
94
+ # занесение и сверка читают дефект из приложения и адреса Hub строки (KIMI-12): их сменили – отказ до записи
95
+ IMPORT_START_TARGET_CHANGED = ("Приложение Hub или адрес Hub изменились, пока собирался запрос (в другой вкладке – "
96
+ "«Параметры проекта» или «Настройки»): чтение не поставлено – обновите вкладку и повторите.")
97
+ IMPORT_TARGET_CHANGED = ("Приложение Hub или адрес Hub изменились после чтения («Параметры проекта» или «Настройки»): "
98
+ "дефект не заносится – нажмите «Отменить», затем «Синхронизировать» на вкладке «Дефекты» и «Принять состояние Hub».")
99
+ IMPORT_RETRY_TARGET_CHANGED = ("Приложение Hub или адрес Hub изменились после первого чтения («Параметры проекта» или "
100
+ "«Настройки»): повторное чтение не ставится – дефект занесёт «Синхронизировать» на вкладке «Дефекты» и «Принять состояние Hub».")
101
+ SYNC_TARGET_CHANGED = ("Приложение Hub или адрес Hub изменились после занесения («Параметры проекта» или «Настройки»): "
102
+ "сверка с Hub этого дефекта не ставится и не применяется.")
103
+
104
+ TEXT_SHOWN_HINT = "Карточка не показала текст дефекта (решение не сохранено или не готово): сохраните решение и обновите карточку."
105
+ SCA_CHANGED = ("Набор SCA изменился после предпросмотра (текст, исследование или состав): нажмите «Отменить "
106
+ "предпросмотр» и запросите заготовку заново.")
107
+
108
+
109
+ DefectRefused = hub_defects.DefectRefused
110
+
111
+
112
+ # ============================================================================ требования команды к тексту (ADR-0123)
113
+
114
+
115
+ def _finding_ids(db: Database, project_id: int, text: str, c=None) -> set[str]:
116
+ """Номера находок Hub проекта среди чисел, на которые текст ссылается реквизитом или перечнем (п. 3.7); c –
117
+ транзакция постановки, которая повторяет проверку."""
118
+ wanted = defect_check.number_candidates(text)
119
+ if not wanted:
120
+ return set()
121
+ return Database.hub_ids_among_in(c, project_id, wanted) if c is not None else db.hub_ids_among(project_id, wanted)
122
+
123
+
124
+ def sast_text_problems(db: Database, settings, project_id: int, text: str, c=None) -> list[str]:
125
+ """Нарушения требований команды в теле дефекта SAST (ADR-0123 п. 3): стандартная фраза – из настройки названия
126
+ команды (defect.sast_phrase), номера находок – проекта."""
127
+ return defect_check.sast_problems(text, team_phrase=defect.sast_phrase(settings.team_name),
128
+ finding_ids=_finding_ids(db, project_id, text, c))
129
+
130
+
131
+ def sca_expect(view: dict, component: str) -> dict:
132
+ """Ожидания проверки текста SCA из представления набора (sca_defect) того же снимка, по которому собран текст:
133
+ строки «Описания», компонент, целевая версия, режим «Исправленной версии нет» (ADR-0123 п. 4)."""
134
+ description = view.get("description") or {}
135
+ return {"expected_hub": list(description.get("hub") or []),
136
+ "expected_research": list(description.get("research") or []),
137
+ "component": str(component or ""), "target": str(view.get("target") or ""),
138
+ "no_fix": bool(view.get("no_fix"))}
139
+
140
+
141
+ def sca_text_problems(db: Database, project_id: int, text: str, expect: dict, c=None) -> list[str]:
142
+ """Нарушения требований команды в тексте дефекта SCA (ADR-0123 п. 4); expect – sca_expect."""
143
+ return defect_check.sca_problems(text, **expect, finding_ids=_finding_ids(db, project_id, text, c))
144
+
145
+
146
+ def text_problems(db: Database, settings, project_id: int, kind: str, text: str, expect: dict | None,
147
+ c=None) -> list[str]:
148
+ return (sast_text_problems(db, settings, project_id, text, c) if kind == "SAST"
149
+ else sca_text_problems(db, project_id, text, expect or {}, c))
150
+
151
+
152
+ def _text_check(request: Request, db: Database, settings, project_id: int, kind: str, text: str, expect: dict | None,
153
+ at_create: bool = False):
154
+ """Повтор проверки текста внутри транзакции постановки (ADR-0123 п. 5): номера находок и название команды
155
+ (стандартная фраза SAST) читаются на её соединении – название сменили в «Настройках» между проверкой до
156
+ транзакции и постановкой – отказ S2. Действующее название – как у settings_of: сохранённое в базе поверх значения
157
+ из окружения. at_create – отказ «Создать» (defect_check.refusal)."""
158
+ base = web_of(request).base
159
+
160
+ def check(c) -> None:
161
+ current = settings
162
+ if kind == "SAST":
163
+ team = base.with_stored(Database.settings_in(c, ("team_name",))).team_name
164
+ current = dataclasses.replace(settings, team_name=team)
165
+ problems = text_problems(db, current, project_id, kind, text, expect, c)
166
+ if problems:
167
+ raise DefectRefused(defect_check.refusal(problems, at_create))
168
+ return check
169
+
170
+
171
+ # ============================================================================ блок карточки и вкладка
172
+
173
+
174
+ def _card_url_of(db: Database, project_id: int, hub_id: str) -> str:
175
+ row = db.get_finding_by_hub_id(project_id, str(hub_id)) if hub_id else None
176
+ return _finding_url(project_id, row)
177
+
178
+
179
+ def _finding_url(project_id: int, row: dict | None) -> str:
180
+ """Адрес карточки находки по строке {id, kind}; нет строки – ""."""
181
+ if row is None:
182
+ return ""
183
+ section = "findings" if row["kind"] == "SAST" else "sca/findings"
184
+ return f"/projects/{project_id}/{section}/{int(row['id'])}"
185
+
186
+
187
+ def _context(db: Database, settings, project: dict, row: dict | None) -> dict:
188
+ pid = int(project["id"])
189
+ view = hub_defects.view(row)
190
+ # признак восстановления закрывает начало новой записи: строку о готовом дефекте показывать надо
191
+ blocker = send_blocker(settings, project) or (hub_sync.resync_blocker(db, pid) if not row or row["state"] == "failed" else "")
192
+ return {"blocker": blocker, "row": row, "view": view,
193
+ "preview": hub_defects.preview(db, row, lambda h: _card_url_of(db, pid, h)) if row else None,
194
+ "poll_url": f"/projects/{pid}/hub/defects/{row['id']}" if row and not view["final"] else ""}
195
+
196
+
197
+ def card_context(request: Request, project: dict, hub_id: str, current_hash: str = "") -> dict:
198
+ """Блок «Создать дефект в Hub» карточки: доступна ли отправка, последняя строка дефекта по этой находке (в том числе
199
+ созданного из карточки соседа по группе), её состояние и предпросмотр. С 0.9.23 (ADR-0121): дефект, к которому
200
+ привязана находка (bound, bound_label), текст подтверждения снятия отметки (unenter), пометка «решение изменено
201
+ после создания дефекта» (decision_changed; current_hash – отпечаток текста по сохранённому решению, как у отметки
202
+ «Внесено в Hub») и для новой находки группы – «Привязать к дефекту» (link)."""
203
+ db = db_of(request)
204
+ db.hub_expire_leases()
205
+ pid = int(project["id"])
206
+ settings = settings_of(request)
207
+ row = db.hub_defect_for(pid, [str(hub_id)])
208
+ if row is not None:
209
+ row = hub_defects.sync(db, row, update_preparer(request))
210
+ context = _context(db, settings, project, row)
211
+ bound = db.hub_defect_bound(pid, str(hub_id))
212
+ from app import defect_links
213
+ context.update(bound=bound, bound_label=hub_defects.bound_label(bound) if bound else "",
214
+ bound_summary=defect_links.summary(bound, pid) if bound else None,
215
+ unenter=hub_defects.bound_text(bound, hub_defects.UNENTER_QUESTION) if bound else "",
216
+ decision_changed=decision_changed(db, pid, str(hub_id), bound, current_hash), link=None)
217
+ if bound is None and not context["blocker"] and (row is None or row["state"] == "failed"):
218
+ context["link"] = link_offer(db, settings, pid, str(hub_id), project.get("hub_app_id"))
219
+ found = db.get_finding_by_hub_id(pid, str(hub_id))
220
+ review = db.get_review(pid, str(hub_id)) or {}
221
+ if (found is not None and found["kind"] == "SAST" and not found.get("missing") and review.get("reviewed")
222
+ and hub_verdict(review.get("decision") or "", review.get("final_verdict") or "") == "true_positive"):
223
+ from urllib.parse import urlencode
224
+ context["add_url"] = f"/projects/{pid}/hub/add-to-defect?" + urlencode({"hub_id": str(hub_id)})
225
+ return context
226
+
227
+
228
+ def decision_changed(db: Database, project_id: int, hub_id: str, bound: dict | None, current_hash: str) -> bool:
229
+ """Решение изменено после создания дефекта (ADR-0121 п. 2): редакция решения новее редакции этой находки в строке
230
+ дефекта, и текст по сохранённому решению (current_hash) другой, чем у цели: повторное сохранение того же и отметка
231
+ «Проверено» (редакция растёт, текст тот же) пометку не ставят."""
232
+ if bound is None or not current_hash:
233
+ # у занесённого из Hub дефекта цели без отпечатка текста: текст в Hub – прежний, его обновляет ADR-0125
234
+ return False
235
+ target = next((t for t in loads(bound.get("targets_json"), []) if str(t.get("hub_id") or "") == hub_id), None)
236
+ review = db.get_review(project_id, hub_id)
237
+ if target is None or not review:
238
+ return False
239
+ expected = str(target.get("decision_hash", target.get("entered_hash")) or "")
240
+ return (bool(expected) and int(review.get("revision") or 0) > int(target.get("revision") or 0)
241
+ and current_hash != expected)
242
+
243
+
244
+ DEFECT_PAGE_SIZES = (25, 50, 100, 200) # как у таблицы находок (worklists.SIZES), по умолчанию 200
245
+
246
+
247
+ @router.get("/projects/{project_id}/defects")
248
+ def defects_page(request: Request, project_id: int, page: int = 1, q: str = "", sort: str = "", kind: str = "",
249
+ state: str = "", origin: str = "", page_size: int = 200):
250
+ """Вкладка «Дефекты»: дефекты, созданные из карточек запросом, их состояние, находки, ссылка на дефект в Hub; с
251
+ 0.9.23.dev3 – и занесённые из Hub (ADR-0124): предпросмотр занесения и сверки; с 0.10.0.dev13 дефекты Hub заносит
252
+ синхронизация («Синхронизировать», «Принять состояние Hub»), формы номеров на вкладке нет."""
253
+ project = project_or_404(request, project_id)
254
+ db = db_of(request)
255
+ settings = settings_of(request)
256
+ db.hub_expire_leases()
257
+ from urllib.parse import urlencode
258
+ sort = sort if sort in Database.HUB_DEFECT_ORDERS else ""
259
+ size = page_size if page_size in DEFECT_PAGE_SIZES else 200
260
+ # закрытые операции доводятся до отбора: иначе фильтр по состоянию видел бы прежнее (ревью 31.10)
261
+ preparer = update_preparer(request)
262
+ for row in db.hub_defects_to_sync(project_id, hub_defects.OPEN_STATES):
263
+ hub_defects.sync(db, row, preparer)
264
+ facets = db.hub_defect_facets(project_id)
265
+ kind = kind if kind in facets["kind"] else ""
266
+ state = state if state in hub_defects.STATE_LABELS else ""
267
+ origin = origin if origin in ("app", "import") else ""
268
+ rows = db.hub_defects_total(project_id, q, kind=kind, state=state, origin=origin) # строки таблицы – для страниц
269
+
270
+ # «Всего» – дефекты, а не строки: семья из нескольких строк – один дефект, как в Hub (бэклог 106).
271
+ # Неудавшиеся попытки в таблице остаются (с них повторяют), но в «Всего» не считаются: число на вкладке их тоже не считает
272
+ total = db.hub_defect_families(project_id, q, kind=kind, state=state, origin=origin, live=not state)
273
+ attempts = db.hub_defects_total(project_id, q, kind=kind, state="failed", origin=origin) if state == "" else 0
274
+ last = max(1, (rows + size - 1) // size)
275
+ page = min(max(1, page), last)
276
+ base = f"/projects/{project_id}/defects?"
277
+
278
+ def keep(**values) -> dict:
279
+ """Параметры адреса вкладки: страница, поиск, порядок, отборы и размер страницы; пустые не пишутся."""
280
+ params = {"page": page, "q": q, "sort": sort, "kind": kind, "state": state, "origin": origin,
281
+ "page_size": size, **values}
282
+ return {k: v for k, v in params.items()
283
+ if v not in ("", None) and not (k == "page" and v == 1) and not (k == "page_size" and v == 200)}
284
+
285
+ def chips(key: str, label: str, values: list[tuple[str, str]]) -> dict:
286
+ # число у фишки – с учётом остальных отборов и поиска; значения самих фишек – по всем дефектам проекта.
287
+ # Считаются дефекты (семьи строк), вместе с неудавшимися попытками: они есть в таблице под этим отбором
288
+ current = {"kind": kind, "state": state, "origin": origin}[key]
289
+ others = {"kind": kind, "state": state, "origin": origin}
290
+ return {"key": key, "label": label, "chips": [
291
+ {"label": text, "href": base + urlencode(keep(page=1, **{key: value})), "active": value == current,
292
+ "count": db.hub_defect_families(project_id, q, **{**others, key: value}) if value else None}
293
+ for value, text in values]}
294
+
295
+ filter_groups = [
296
+ chips("kind", "Вид", [("", "все")] + [(k, k) for k in sorted(facets["kind"]) if k]),
297
+ chips("state", "Состояние", [("", "все")] + [(k, hub_defects.STATE_LABELS.get(k, k))
298
+ for k in sorted(facets["state"],
299
+ key=lambda k: hub_defects.STATE_LABELS.get(k, k))]),
300
+ chips("origin", "Происхождение", [("", "все"), ("app", "создан в приложении"), ("import", "занесён из Hub")]),
301
+ ]
302
+ active_filters = sum(1 for v in (kind, state, origin) if v)
303
+ pagination = {"page": page, "last": last, "total": total, "attempts": attempts,
304
+ "attempts_url": base + urlencode(keep(page=1, state="failed")), "query": q, "sort": sort, "size": size,
305
+ "sizes": DEFECT_PAGE_SIZES, "hidden": [(k, v) for k, v in keep(page=1).items() if k != "page_size"],
306
+ "previous": base + urlencode(keep(page=page - 1)),
307
+ "next": base + urlencode(keep(page=page + 1)),
308
+ "sort_url": {key: base + urlencode(keep(page=1, sort=f"{key}_{'asc' if sort == key + '_desc' else 'desc'}"))
309
+ for key in ("number", "kind")},
310
+ "reset": base + urlencode(keep(page=1, kind="", state="", origin="")),
311
+ # пустой отбор: кнопка снимает и отборы, и поиск (ревью dev22)
312
+ "reset_all": base + urlencode(keep(page=1, q="", kind="", state="", origin=""))}
313
+ items = []
314
+ rows = db.hub_defects(project_id, limit=size, offset=(page - 1) * size, query=q, order=sort, kind=kind,
315
+ state=state, origin=origin)
316
+ # адреса карточек якорей и целей всей страницы – одним запросом, а не по запросу на цель (бэклог 123)
317
+ refs = db.finding_refs(project_id, [h for row in rows for h in (
318
+ str(row.get("anchor_hub_id") or ""), *(str(t.get("hub_id") or "") for t in loads(row.get("targets_json"), [])))])
319
+
320
+ def card_url(hub_id: str) -> str:
321
+ return _finding_url(project_id, refs.get(hub_id)) if hub_id else ""
322
+ for row in rows:
323
+ targets = loads(row.get("targets_json"), [])
324
+ retry = retry_context(db, project_id, row)
325
+ items.append({"row": row, "view": hub_defects.view(row), "note": "", # итог «Проверить в Hub» не выводится (dev33)
326
+ "retry": retry,
327
+ "card_url": f"/projects/{project_id}/defects/{row['id']}"
328
+ + ("?" + urlencode(keep()) if keep() else ""),
329
+ # строка привязки – история дефекта: действия у владельца (ADR-0136)
330
+ "owner_url": (f"/projects/{project_id}/defects/{row['draft_owner_id']}"
331
+ if row.get("draft_owner_id") and int(row["draft_owner_id"]) != int(row["id"]) else ""),
332
+ "label": ("заменена" if retry and retry.get("superseded")
333
+ else hub_defects.STATE_LABELS.get(row["state"], row["state"])),
334
+ "anchor_url": card_url(str(row.get("anchor_hub_id") or "")),
335
+ "targets": [{"hub_id": str(t.get("hub_id") or ""),
336
+ "url": card_url(str(t.get("hub_id") or ""))} for t in targets],
337
+ "hub_update": update_context(db, row, not send_blocker(settings, project)
338
+ and _same_hub(row, settings.hub_url, project.get("hub_app_id")),
339
+ bool(loads(row.get("sync_json"), {}).get("read"))),
340
+ "imported": import_context(db, settings, project, row)})
341
+ return render(request, "projects/defects.html", {
342
+ "project": project, "items": items, "labels": hub_defects.STATE_LABELS, "pagination": pagination,
343
+ "filter_groups": filter_groups, "active_filters": active_filters,
344
+ "dropped_total": len(db.dropped_findings(project_id)),
345
+ "sync_runs": db._all("SELECT id,state,created_at FROM hub_defect_sync_runs WHERE project_id=? ORDER BY id DESC", (project_id,)),
346
+ "resync_note": hub_sync.resync_blocker(db, project_id),
347
+ "hub_step": hub_onboarding.state(db, project, settings.hub_url, light=True), # напоминание (0.10.0.dev13)
348
+ "counts": db.count_findings(project_id), "review_stats": db.review_stats(project_id)})
349
+
350
+
351
+ # ============================================================================ «Занести из Hub» и «Pull из Hub» (ADR-0124)
352
+
353
+
354
+ def import_form_problems(db: Database, settings, project_id: int, kind: str, text: str) -> list[str]:
355
+ """Проверка формы ADR-0123 выделенного текста команды – справочно (занесение текст в Hub не отправляет): SAST –
356
+ полная (sast_problems); SCA – только то, что не требует данных набора (разделы, ничего до «Описания», «Объяснение»
357
+ не пусто, адреса «Источников», номера AST, служебные строки прежнего формата): строки уязвимостей и строку обновления
358
+ сверять не с чем – снимка набора у занесённого дефекта нет."""
359
+ if not str(text or "").strip():
360
+ return []
361
+ if kind == "SAST":
362
+ return sast_text_problems(db, settings, project_id, text)
363
+ if kind == "SCA":
364
+ problems = defect_check.sca_problems(text, expected_hub=[], expected_research=[], component="", target="",
365
+ no_fix=False, finding_ids=_finding_ids(db, project_id, text))
366
+ return [p for p in problems if p.split(":", 1)[0] in ("A1", "A4", "A8") or "внутренний номер уязвимости" in p]
367
+ return []
368
+
369
+
370
+ def _with_urls(db: Database, project_id: int, entries: list[dict]) -> list[dict]:
371
+ return [{**e, "url": _card_url_of(db, project_id, str(e.get("hub_id") or ""))} for e in entries or []]
372
+
373
+
374
+ def import_context(db: Database, settings, project: dict, row: dict) -> dict | None:
375
+ """Строка, занесённая из Hub, для вкладки «Дефекты»: предпросмотр занесения (import_preview – снимок, показанный
376
+ отпечаток shown, операция чтения op, проверка формы и занятость номера ID<n> другим – справочно; ключи
377
+ собственных находок – own_number_keys – не в счёт) и предпросмотр сверки
378
+ (sync_json у done); у остальных строк – None. «Повторить чтение» и «Pull из Hub» – только когда чтение можно
379
+ поставить: нет блокировки отправки (send_blocker) и строка того же Hub и приложения, что сейчас у проекта
380
+ (_same_hub); «Повторить чтение» – ещё и когда у того же Hub, приложения и номера нет другой живой строки
381
+ (hub_defect_live, своя не в счёт) – иначе маршрут всё равно откажет."""
382
+ # контекст сверки – у занесённых строк и у строк-владельцев дефектов из приложения (dev34: Pull и у них)
383
+ if row.get("origin") != "import" and not hub_defects.pull_allowed(row):
384
+ return None
385
+ project_id = int(project["id"])
386
+ can_read = (not send_blocker(settings, project)
387
+ and _same_hub(row, settings.hub_url, project.get("hub_app_id")))
388
+ retry = can_read and row["state"] in ("failed", "cancelled")
389
+ if retry and db.hub_defect_live(str(row.get("hub_url") or ""), row.get("app_id"),
390
+ str(row.get("hub_defect_id") or ""), exclude_id=int(row["id"])) is not None:
391
+ retry = False # тот же дефект уже занесён или читается другой строкой: повтор откажет «уже есть в приложении»
392
+ out: dict = {"preview": None, "sync": None, "sync_error": "", "sync_matches": "", "retry": retry,
393
+ "can_sync": can_read and row["state"] == "done" and not row.get("sync_op_id")}
394
+ if row["state"] == "import_preview":
395
+ snap = loads(row.get("import_json"), {}) or {}
396
+ out["preview"] = {**snap, "shown": text_hash(str(row.get("import_json") or "")), "op": row.get("read_op_id"),
397
+ "accepted": _with_urls(db, project_id, snap.get("accepted")),
398
+ "conflicts": _with_urls(db, project_id, snap.get("conflicts")),
399
+ "form_problems": import_form_problems(db, settings, project_id, str(snap.get("kind") or ""),
400
+ str(snap.get("command_text") or "")),
401
+ "number_taken": hub_defects.number_note(
402
+ db, row, snap.get("number") if isinstance(snap.get("number"), int) else None,
403
+ hub_defects.own_number_keys(db, row, snap.get("accepted"), snap.get("absent")))}
404
+ if row["state"] == "done" and not row.get("sync_op_id"):
405
+ state = loads(row.get("sync_json"), {}) or {}
406
+ if isinstance(state, dict) and state.get("read"):
407
+ read = state["read"]
408
+ out["sync"] = {**state, "shown": text_hash(str(row.get("sync_json") or "")),
409
+ "added": _with_urls(db, project_id, state.get("added")),
410
+ "unobserved": _with_urls(db, project_id, state.get("unobserved")),
411
+ "unobserved_diff": _with_urls(db, project_id, state.get("unobserved_diff", state.get("unobserved"))),
412
+ "form_problems": import_form_problems(db, settings, project_id, str(row.get("kind") or ""),
413
+ str(read.get("command_text") or ""))}
414
+ elif isinstance(state, dict) and state.get("matches"):
415
+ out["sync_matches"] = state.get("read_at") or ""
416
+ out["sync_extra"] = int(state.get("extra_lines") or 0)
417
+ elif isinstance(state, dict) and state.get("error"):
418
+ out["sync_error"] = str(state["error"])
419
+ # ключ – не «update»: в шаблоне imp.update – метод словаря
420
+ out["hub_update"] = update_context(db, row, can_read, bool(out["sync"]))
421
+ # идёт «Push в Hub» или запись принята без подтверждения (unconfirmed, ADR-0125 п. 2): «Pull из Hub» отказала бы
422
+ if out["hub_update"]["busy"] or hub_defects.update_unconfirmed(row):
423
+ out["can_sync"] = False
424
+ return out
425
+
426
+
427
+ def update_context(db: Database, row: dict, can_read: bool, sync_preview: bool) -> dict:
428
+ """«Push в Hub» (ADR-0125) для строки вкладки: фаза, поколение и показанный отпечаток (shown – text_hash
429
+ update_json: формы предпросмотра сверяют их в транзакции), кнопки по таблице п. 3 – «Подготовить обновление» (не
430
+ идёт, предпросмотр не открыт, сверка не идёт и не ждёт «Применить»), «Сверить» (неизвестный исход), «Повторить
431
+ чтение» (запись принята, подтверждение не прочитано) – и предпросмотр: новый заголовок и текст, предупреждения,
432
+ находки. Кнопки – только когда чтение можно поставить (can_read, как у «Pull из Hub»)."""
433
+ state = hub_defects.update_state(row)
434
+ phase = str(state.get("phase") or "")
435
+ busy = hub_defects.update_busy(row)
436
+ idle = row["state"] == "done" and not row.get("update_op_id")
437
+ # у строки привязки своего Push и Pull нет: действия – у владельца (ADR-0136), старая форма получит отказ сервера
438
+ can_read = can_read and int(row.get("draft_owner_id") or row["id"]) == int(row["id"])
439
+ out = {"phase": phase, "busy": busy, "generation": int(state.get("generation") or 0),
440
+ "shown": text_hash(str(row.get("update_json") or "")), "preview": None,
441
+ # конфликт состава – обновление откажет «неразрешённые конфликты»: кнопки нет ни во вкладке, ни в карточке
442
+ "can_prepare": (can_read and idle and not busy and phase != "preview" and not row.get("sync_op_id")
443
+ and not sync_preview and bool(row.get("hub_defect_id"))
444
+ and not loads(row.get("conflicts_json"), [])
445
+ # место целей в наборах ждёт выбора после слияния пакетов (план dev17, п. 4.5): тот же
446
+ # предикат, что у сервера перед шагами обновления; без базы (разбор строки в тестах
447
+ # таблицы действий) – ожидания нет
448
+ and not (db is not None
449
+ and db.on_connection(lambda c: hub_defects.pending_place_problem(c, row)))),
450
+ "can_verify": can_read and idle and phase == "unknown",
451
+ "can_reread": can_read and idle and phase in ("confirming", "unconfirmed")}
452
+ if idle and phase == "preview":
453
+ new, first = state.get("new") or {}, state.get("first") or {}
454
+ out["preview"] = {"summary": str(new.get("summary") or ""), "command_text": str(new.get("command_text") or ""),
455
+ "old_summary": str(first.get("summary") or ""), "note": str(state.get("note") or ""),
456
+ "warnings": [str(w) for w in state.get("warnings") or []],
457
+ "field_diff": state.get("field_diff", []), "candidate": state.get("candidate"),
458
+ # предпросмотр без признака (до правки подписи) – по сохранённому кандидату PUT
459
+ "kept_description": bool(state.get("kept_description", str(
460
+ (state.get("candidate") or {}).get("description") or "")
461
+ == str((state.get("first") or {}).get("description") or ""))),
462
+ "block_mode": str(state.get("block_mode") or ""), # что будет с блоком Hub (dev30)
463
+ "block_version": state.get("block_version") or {}, # замена версии в блоке (dev7)
464
+ "where_added": bool(state.get("where_added")), # дописан раздел «Где исправлять» (dev7)
465
+ "block_built": bool(state.get("block_built")), # блок собран приложением (ADR-0139)
466
+ "blank_fetched": bool(state.get("blank_fetched")), # заготовка запрошена шагом blank (dev31)
467
+ "references": state.get("references", {}), "hub_url": row["hub_url"], "app_id": row["app_id"],
468
+ "targets": _with_urls(db, int(row["project_id"]),
469
+ [{"hub_id": str(t.get("hub_id") or "")} for t in new.get("targets") or []]),
470
+ "can_put": can_read}
471
+ return out
472
+
473
+
474
+ def _pull_row(request: Request, project_id: int, defect_id: int) -> tuple[dict, dict]:
475
+ """Строка для «Pull из Hub», «Применить» и «Отменить» сверки: занесённая из Hub или созданная приложением
476
+ строка-владелец «создан» с номером в Hub (dev34)."""
477
+ project, row = _project_row(request, project_id, defect_id)
478
+ if not hub_defects.pull_allowed(row):
479
+ raise LookupError(hub_defects.PULL_ONLY)
480
+ return project, row
481
+
482
+
483
+ def _import_row(request: Request, project_id: int, defect_id: int) -> tuple[dict, dict]:
484
+ project, row = _project_row(request, project_id, defect_id)
485
+ if row.get("origin") != "import":
486
+ raise LookupError("Дефект, занесённый из Hub, не найден.")
487
+ return project, row
488
+
489
+
490
+ async def _card_refused(request: Request, project_id: int, detail: str, status: int = 409):
491
+ """Отказ действия, начатого в карточке дефекта: карточка с сообщением и прежними кнопками, а не страница ошибки
492
+ с одной кнопкой «К проектам»."""
493
+ from app.routes import defect_card_routes
494
+ defect_id = int(request.path_params.get("defect_id") or 0)
495
+
496
+ def page():
497
+ context = defect_card_routes.page_context(request, project_id, defect_id)
498
+ context["error"] = detail
499
+ return render(request, "projects/defect_card.html", context, status_code=status)
500
+
501
+ try:
502
+ return await run_in_threadpool(page)
503
+ except (HTTPException, ValueError, LookupError): # карточку не собрать (строку удалили и т. п.) – прежний отказ
504
+ return await _refused(request, False, detail, status)
505
+
506
+
507
+ async def _tab_action(request: Request, project_id: int, apply, ok: str, message: str):
508
+ """Действие вкладки «Дефекты» (занесение и сверка): без скрипта – возврат во вкладку с сообщением, со скриптом – JSON
509
+ с перезагрузкой; отказы – как у остальных действий дефекта."""
510
+ as_json = wants_json(request)
511
+ # предпросмотр занесения и его кнопки есть только во вкладке – отказы занесения остаются прежними (ревью 31.10)
512
+ to_card = (not as_json and bool(request.path_params.get("defect_id"))
513
+ and not request.url.path.endswith(("/import", "/import-cancel", "/import-retry")))
514
+ try:
515
+ result = await run_in_threadpool(apply)
516
+ except HTTPException as e:
517
+ return await _refused(request, as_json, str(e.detail), e.status_code)
518
+ except hub_status.StatusRefused as e:
519
+ if to_card:
520
+ return await _card_refused(request, project_id, str(e), 400) # и из вкладки: карточка объясняет
521
+ return await _refused(request, as_json, str(e), 400)
522
+ except LookupError as e:
523
+ return await _refused(request, as_json, str(e), 404)
524
+ except ValueError as e: # состояние или состав изменились, очередь отказала, дефект уже есть
525
+ if to_card:
526
+ # отказ действия над дефектом – его карточка с сообщением, не страница ошибки
527
+ return await _card_refused(request, project_id, str(e))
528
+ return await _refused(request, as_json, str(e), 409)
529
+ if not as_json:
530
+ form = await request.form()
531
+ if form.get("back") == "defect-card" and isinstance(result, dict) and result.get("id"):
532
+ owner_id = result.get("draft_owner_id") or result["id"]
533
+ return redirect(_card_url(project_id, owner_id, form, ok=ok))
534
+ return redirect(f"/projects/{project_id}/defects?ok={ok}")
535
+ return {"ok": True, "done": True, "reload": True, "message": message}
536
+
537
+
538
+ @router.post("/projects/{project_id}/defects/import")
539
+ async def import_start(request: Request, project_id: int):
540
+ """«Занести из Hub» (ADR-0124 п. 3): до 20 номеров или ссылок дефектов Hub – на каждый строка «чтение из Hub» и
541
+ операция `GET /defects/{id}` одной транзакцией (нет другой живой строки этого Hub, приложения и номера; приложение
542
+ и адрес Hub – те же, что прочитаны здесь)."""
543
+ form = await request.form(max_fields=5, max_files=0)
544
+ text = str(form.get("numbers") or "")
545
+
546
+ def apply():
547
+ project = project_or_404(request, project_id)
548
+ settings, db = settings_of(request), db_of(request)
549
+ blocker = send_blocker(settings, project)
550
+ if blocker:
551
+ raise DefectRefused(blocker)
552
+ try:
553
+ numbers = hub_defects.import_numbers(text)
554
+ except ValueError as e:
555
+ raise DefectRefused(str(e)) from None
556
+ app_id = int(project["hub_app_id"])
557
+ return db.hub_defect_import_start(
558
+ project_id, numbers=numbers, hub_url=settings.hub_url, app_id=app_id,
559
+ item_of=hub_defects.import_item, link_of=lambda n: hub_defects.defect_link(settings.hub_url, app_id, n),
560
+ check=hub_target_check(request, project_id, settings.hub_url, app_id, IMPORT_START_TARGET_CHANGED),
561
+ label_of=hub_defects.STATE_LABELS.get)
562
+
563
+ return await _tab_action(request, project_id, apply, "hub_import_queued",
564
+ "Поставлено в очередь исполнителю: чтение дефектов из Hub.")
565
+
566
+
567
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/import")
568
+ async def import_accept(request: Request, project_id: int, defect_id: int):
569
+ """«Занести» (ADR-0124 п. 5): поля op – операция чтения и shown – отпечаток снимка, которые показал предпросмотр."""
570
+ form = await request.form(max_fields=5, max_files=0)
571
+ shown_op, shown = str(form.get("op") or ""), str(form.get("shown") or "")
572
+
573
+ def apply():
574
+ project, row = _import_row(request, project_id, defect_id)
575
+ if not shown_op.isdigit():
576
+ raise DefectRefused("Предпросмотр не передал операцию чтения: обновите страницу.")
577
+ if not _same_hub(row, settings_of(request).hub_url, project.get("hub_app_id")):
578
+ raise StaleTarget(IMPORT_TARGET_CHANGED)
579
+ return hub_defects.accept_import(db_of(request), row, op_id=int(shown_op), shown=shown,
580
+ target_check=hub_target_check(request, project_id, str(row.get("hub_url") or ""),
581
+ row.get("app_id"), IMPORT_TARGET_CHANGED))
582
+
583
+ return await _tab_action(request, project_id, apply, "hub_import_done", "Дефект занесён из Hub.")
584
+
585
+
586
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/import-cancel")
587
+ async def import_cancel(request: Request, project_id: int, defect_id: int):
588
+ """«Отменить» предпросмотр занесения: строка отменена, в Hub ничего не уходило."""
589
+ def apply():
590
+ _, row = _import_row(request, project_id, defect_id)
591
+ return hub_defects.cancel_import(db_of(request), row)
592
+
593
+ return await _tab_action(request, project_id, apply, "hub_import_cancelled", "Предпросмотр занесения отменён.")
594
+
595
+
596
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/import-retry")
597
+ async def import_retry(request: Request, project_id: int, defect_id: int):
598
+ """«Повторить чтение» у не удавшегося или отменённого занесения (ADR-0124 п. 3)."""
599
+ def apply():
600
+ project, row = _import_row(request, project_id, defect_id)
601
+ blocker = send_blocker(settings_of(request), project)
602
+ if blocker:
603
+ raise DefectRefused(blocker)
604
+ if not _same_hub(row, settings_of(request).hub_url, project.get("hub_app_id")):
605
+ raise StaleTarget(IMPORT_RETRY_TARGET_CHANGED)
606
+ return hub_defects.retry_import(db_of(request), row, hub_target_check(
607
+ request, project_id, str(row.get("hub_url") or ""), row.get("app_id"), IMPORT_RETRY_TARGET_CHANGED))
608
+
609
+ return await _tab_action(request, project_id, apply, "hub_import_retry", "Чтение поставлено в очередь заново.")
610
+
611
+
612
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/sync")
613
+ async def import_sync(request: Request, project_id: int, defect_id: int):
614
+ """«Pull из Hub» у занесённого или созданного приложением дефекта (ADR-0124 п. 6, dev34): чтение
615
+ `GET /defects/{id}`, состояние строки не меняется."""
616
+ def apply():
617
+ project, row = _pull_row(request, project_id, defect_id)
618
+ blocker = send_blocker(settings_of(request), project)
619
+ if blocker:
620
+ raise DefectRefused(blocker)
621
+ if not _same_hub(row, settings_of(request).hub_url, project.get("hub_app_id")):
622
+ raise StaleTarget(SYNC_TARGET_CHANGED)
623
+ return hub_defects.start_import_sync(db_of(request), row, hub_target_check(
624
+ request, project_id, str(row.get("hub_url") or ""), row.get("app_id"), SYNC_TARGET_CHANGED))
625
+
626
+ return await _tab_action(request, project_id, apply, "hub_sync_queued", "Сверка с Hub поставлена в очередь.")
627
+
628
+
629
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/sync-apply")
630
+ async def import_sync_apply(request: Request, project_id: int, defect_id: int):
631
+ """«Применить» предпросмотр сверки (ADR-0124 п. 6): поле shown – отпечаток показанного снимка сверки."""
632
+ form = await request.form(max_fields=5, max_files=0)
633
+ shown = str(form.get("shown") or "")
634
+
635
+ def apply():
636
+ project, row = _pull_row(request, project_id, defect_id)
637
+ if not _same_hub(row, settings_of(request).hub_url, project.get("hub_app_id")):
638
+ raise StaleTarget(SYNC_TARGET_CHANGED)
639
+ return hub_defects.apply_import_sync(db_of(request), row, shown=shown, target_check=hub_target_check(
640
+ request, project_id, str(row.get("hub_url") or ""), row.get("app_id"), SYNC_TARGET_CHANGED))
641
+
642
+ return await _tab_action(request, project_id, apply, "hub_sync_applied", "Сверка применена.")
643
+
644
+
645
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/sync-cancel")
646
+ async def import_sync_cancel(request: Request, project_id: int, defect_id: int):
647
+ """«Отменить» предпросмотр сверки: поле shown – отпечаток показанного снимка сверки; тот же – sync_json очищается,
648
+ другой (новая сверка из другой вкладки) – отказ, новый предпросмотр цел."""
649
+ form = await request.form(max_fields=5, max_files=0)
650
+ shown = str(form.get("shown") or "")
651
+
652
+ def apply():
653
+ _, row = _pull_row(request, project_id, defect_id)
654
+ return hub_defects.cancel_import_sync(db_of(request), row, shown=shown)
655
+
656
+ return await _tab_action(request, project_id, apply, "hub_sync_cancelled", "Предпросмотр сверки отменён.")
657
+
658
+
659
+ # ============================================================================ «Push в Hub» (ADR-0125)
660
+
661
+ UPDATE_TARGET_CHANGED = ("Приложение Hub или адрес Hub изменились после занесения («Параметры проекта» или «Настройки»): "
662
+ "обновление этого дефекта не ставится.")
663
+ SCA_UPDATE_CHANGED = ("Набор SCA изменился после подготовки обновления (текст, исследование или состав): снова "
664
+ "нажмите «Push в Hub».")
665
+
666
+ register_messages({
667
+ "hub_update_queued": "Поставлено в очередь исполнителю: чтение дефекта для предпросмотра обновления – состояние в "
668
+ "строке дефекта.",
669
+ "hub_update_put_queued": "Поставлено в очередь исполнителю: дефект перечитывается и записывается в Hub – состояние в "
670
+ "строке дефекта.",
671
+ "hub_update_cancelled": "Подготовка обновления отменена: в Hub ничего не уходило.",
672
+ "hub_update_verify_queued": "Сверка поставлена в очередь исполнителю: итог – в строке дефекта.",
673
+ "hub_update_reread_queued": "Подтверждающее чтение поставлено в очередь исполнителю: итог – в строке дефекта.",
674
+ })
675
+
676
+
677
+ def _update_target(request: Request, project_id: int, row: dict):
678
+ """Приложение и адрес Hub строки – те же, что у проекта сейчас (KIMI-12): сверка в транзакции каждой постановки."""
679
+ return hub_target_check(request, project_id, str(row.get("hub_url") or ""), row.get("app_id"),
680
+ UPDATE_TARGET_CHANGED)
681
+
682
+
683
+ def _update_sast(request: Request, db: Database, settings, project_id: int, row: dict, targets: list[dict],
684
+ same_text: bool = True) -> dict:
685
+ """Подготовка дефекта SAST (п. 2): все цели – «Подтверждаю дефект» с «Проверено», карточка готова (как
686
+ _prepare_sast: решение действует по текущему коду, обоснование, рекомендация, название команды, происхождение
687
+ комментария); при явной сборке текст решения у всех один. Заголовок – sast_title опорной находки с номером строки."""
688
+ from app.routes import findings as card
689
+ refusals: list[str] = []
690
+ warnings: list[str] = []
691
+ ready: list[tuple] = []
692
+ hub_targets: list[dict] = [] # цели с решением «из Hub»: текст – черновик как есть
693
+ old_hash = {str(t.get("hub_id") or ""): str(t.get("decision_hash", t.get("entered_hash")) or "") for t in targets}
694
+ number = row.get("number") if isinstance(row.get("number"), int) and not isinstance(row.get("number"), bool) else None
695
+ defect_lines: dict[str, set[int] | None] = {} # срезы всех находок дефекта – один обход на подготовку
696
+ for target in targets:
697
+ hub_id = str(target.get("hub_id") or "")
698
+ source = db.case_input(project_id, hub_id)
699
+ if source is None or source.get("missing"):
700
+ refusals.append(f"находки {hub_id} нет в текущей выгрузке")
701
+ continue
702
+ sig = db.finding_sig(project_id, hub_id) # до чтения данных: обновление выгрузки поймает транзакция
703
+ f = Finding.from_dict(source["data"])
704
+ review = db.get_review(project_id, hub_id)
705
+ if (not review or not review.get("decision")
706
+ or hub_verdict(review["decision"], review.get("final_verdict") or "") != "true_positive"):
707
+ refusals.append(f"у находки {hub_id} нет решения «Подтверждаю дефект»")
708
+ continue
709
+ if str(review.get("decision") or "") == defect_drafts.HUB_DECISION:
710
+ # решение «из Hub»: без «Проверено» и сверки кода – «Push в Hub» отправляет текст
711
+ # черновика как есть; «Текст из решений» по нему не собрать – обоснования и рекомендации оператора нет
712
+ if same_text:
713
+ refusals.append(f"у находки {hub_id} решение принято из Hub, обоснования и рекомендации оператора нет – "
714
+ "сохраните решение в карточке или отправьте текст как есть («Push в Hub»)")
715
+ continue
716
+ hub_targets.append({"hub_id": hub_id, "issue_id": hub_status.issue_id(hub_id),
717
+ "issue_type": hub_status.issue_type(f.kind), "revision": int(review.get("revision") or 0),
718
+ "decision_hash": old_hash.get(hub_id, ""), "entered_hash": "", "entered_parts": "",
719
+ "sig": sig})
720
+ continue
721
+ if not review.get("reviewed"):
722
+ refusals.append(f"у находки {hub_id} нет отметки «Проверено»")
723
+ continue
724
+ case = db.get_case(project_id, hub_id)
725
+ assessment = card.sast_assess(request, project_id, review, case, source)
726
+ if assessment["state"] != "ok":
727
+ refusals.append(f"находка {hub_id}: "
728
+ + card.sast_state_hint(assessment["state"], review, card.SAST_DEFECT_NOT_READY))
729
+ continue
730
+ if "all" not in defect_lines:
731
+ defect_lines["all"] = card.defect_shown_lines(request, project_id, f, case, also=[str(t.get("hub_id") or "") for t in targets])
732
+ view = card.sast_defect(db, settings, store_of(request), project_id, f, review, None, number=number,
733
+ shown=defect_lines["all"], state="ok", source=source)
734
+ if not view["ready"]:
735
+ refusals.append(f"находка {hub_id}: {view['hint']}")
736
+ continue
737
+ origin = card.comment_origin(db, case, review, review.get("final_comment") or "", project_id=project_id,
738
+ hub_id=hub_id)
739
+ if origin and origin != "true_positive":
740
+ refusals.append(f"находка {hub_id}: обоснование – текст модели к другому вердикту (поправьте комментарий в "
741
+ "карточке и сохраните решение)")
742
+ continue
743
+ warnings += [f"находка {hub_id}: {w}" for w in view.get("warnings") or []]
744
+ ready.append((f, review, view, sig))
745
+ if refusals:
746
+ return {"refusals": refusals}
747
+ if same_text and len({text_hash(view["body"]) for _, _, view, _ in ready}) > 1:
748
+ return {"refusals": ["у находок дефекта разный текст решения (обоснование или рекомендация): "
749
+ + ", ".join(f.hub_id for f, _, _, _ in ready) + " – сделайте решения одинаковыми"]}
750
+ new_targets = [_defect_target(f, review, view["body"], defect_parts(settings, review), sig) for f, review, view, sig in ready]
751
+ if ready:
752
+ anchor = next((x for x in ready if x[0].hub_id == str(row.get("anchor_hub_id") or "")), ready[0])
753
+ summary, body, anchor_id = anchor[2]["title"], anchor[2]["body"], anchor[0].hub_id
754
+ else: # все решения – «из Hub»: заголовок и текст – черновик владельца (prepare_update)
755
+ summary, body, anchor_id = "", "", str(hub_targets[0]["hub_id"])
756
+ new_targets += hub_targets
757
+ return {"kind": "SAST", "summary": summary, "command_text": body, "targets": new_targets,
758
+ "number_keys": [defect.defect_key_sast(str(t["hub_id"])) for t in new_targets], "warnings": warnings,
759
+ "anchor": anchor_id, "fingerprint": "", "expect": None, "require_reviewed": True}
760
+
761
+
762
+ def _update_sca(request: Request, db: Database, project_id: int, row: dict, targets: list[dict],
763
+ strict: bool = True) -> dict:
764
+ """Подготовка дефекта SCA (п. 2): цели – находки одной версии одного компонента («разные версии» – отказ, бэклог
765
+ 49), набор готов (sca_defect: view["ready"]) и его участники равны целям; заголовок и подпись – с номером строки."""
766
+ from app.routes import sca as sca_card
767
+ hub_ids = [str(t.get("hub_id") or "") for t in targets]
768
+ found = db.import_findings(project_id, hub_ids)
769
+ gone = [h for h in hub_ids if h not in found or found[h]["missing"]]
770
+ if gone:
771
+ return {"refusals": ["находок " + ", ".join(gone) + " нет в текущей выгрузке"]}
772
+ versions = list(dict.fromkeys(f"{found[h]['component']} {found[h]['version']}".strip() for h in hub_ids))
773
+ if len(versions) > 1:
774
+ return {"refusals": ["находки разных версий: " + ", ".join(versions) + " – решение по такому дефекту – за "
775
+ "владельцем после синхронизации (бэклог 49)"]}
776
+ anchor = str(row.get("anchor_hub_id") or "") if str(row.get("anchor_hub_id") or "") in hub_ids else hub_ids[0]
777
+ snap = db.sca_snapshot(project_id, anchor)
778
+ if snap.row is None:
779
+ return {"refusals": [f"находки {anchor} нет в текущей выгрузке"]}
780
+ f = Finding.from_dict(snap.row["data"])
781
+ review = snap.review
782
+ if not review or not (review.get("decision") or review.get("final_verdict")):
783
+ return {"refusals": [f"у находки {anchor} нет решения «Обновить»"]}
784
+ number = row.get("number") if isinstance(row.get("number"), int) and not isinstance(row.get("number"), bool) else None
785
+ view = sca_card.sca_defect(snap, store_of(request), project_id, f, review, number=number)
786
+ warnings: list[str] = []
787
+ # решение «из Hub»: заготовка набора по нему не собирается – «Push в Hub» отправляет
788
+ # текст черновика как есть, «Текст из решений» отказывает
789
+ # (ревью dev23, круг 1: decision 'hub' пишет и Pull статусов – с итогом «ложное срабатывание» или «риск принят»)
790
+ from_hub = (str(review.get("decision") or "") == defect_drafts.HUB_DECISION
791
+ and hub_verdict(review.get("decision") or "", review.get("final_verdict") or "") == "true_positive")
792
+ if from_hub and strict:
793
+ return {"refusals": [f"у находки {anchor} решение принято из Hub, обоснования оператора нет – сохраните "
794
+ "решение в карточке или отправьте текст как есть («Push в Hub»)"]}
795
+ # «Push в Hub» отправляет текст дефекта, который сейчас в приложении, как есть (если
796
+ # ничего не меняли – никаких разниц): заготовка набора, не доведённая до шаблона (Объяснение не сохранено,
797
+ # остаточный риск не отмечен), и комментарии находок к другому выводу – предупреждение; отказ – только при
798
+ # «Тексте из решений» (strict) и если набор не собран вовсе
799
+ lenient = not strict and (view.get("state") == "text" or from_hub)
800
+ if not view["ready"] and not lenient:
801
+ return {"refusals": [f"дефект набора не готов: {view['hint'] or 'набор SCA не готов'}"]}
802
+ if not view["ready"]:
803
+ warnings.append(f"заготовка набора не готова, уйдёт текст дефекта как есть: {view['hint']}")
804
+ if view.get("comment_stale") and strict:
805
+ return {"refusals": ["в наборе находки, где комментарий – текст агента к другому выводу: "
806
+ + ", ".join(str(x) for x in view["comment_stale"][:10])
807
+ + " (поправьте комментарий в их карточках и сохраните)"]}
808
+ members = [str(x) for x in view.get("members") or []]
809
+ by_row = not members or (from_hub and not view["ready"])
810
+ if by_row:
811
+ members = hub_ids # заготовка не собрана: состав – цели строки, как в Hub; решение каждой проверяется ниже
812
+ extra, lacking = sorted(set(hub_ids) - set(members)), sorted(set(members) - set(hub_ids))
813
+ if extra or lacking:
814
+ parts = ([f"в дефекте, но не в наборе: {', '.join(extra)}"] if extra else []) + (
815
+ [f"в наборе, но не в дефекте: {', '.join(lacking)}"] if lacking else [])
816
+ return {"refusals": ["состав набора не равен находкам дефекта (" + "; ".join(parts) + ")"]}
817
+ new_targets = []
818
+ # заготовка не готова – отметки находок не переписываются отпечатком неготовой заготовки: прежний отпечаток цели
819
+ old_hash = {str(t.get("hub_id") or ""): str(t.get("decision_hash", t.get("entered_hash")) or "") for t in targets}
820
+ for hub_id in members:
821
+ member_review = review if hub_id == f.hub_id else db.get_review(project_id, hub_id)
822
+ member_sig = db.finding_sig(project_id, hub_id)
823
+ member = _finding_of(db, project_id, hub_id)
824
+ if member is None or not member_review:
825
+ return {"refusals": [f"находка {hub_id} набора изменилась: обновите вкладку"]}
826
+ if by_row and hub_verdict(member_review.get("decision") or "", member_review.get("final_verdict") or "") != "true_positive":
827
+ # состав взят из строки, а не из готового набора: отложенное, ложное срабатывание и принятый риск в дефект
828
+ # не уходят (ревью dev23, круг 1)
829
+ return {"refusals": [f"у находки {hub_id} решение не «Обновить»"]}
830
+ new_targets.append({"hub_id": hub_id, "issue_id": hub_status.issue_id(hub_id),
831
+ "issue_type": hub_status.issue_type(member.kind),
832
+ "revision": int(member_review.get("revision") or 0),
833
+ "decision_hash": str(view["text_sig"]) if view["ready"] else old_hash.get(hub_id, ""),
834
+ "entered_hash": "", "entered_parts": "", "sig": member_sig})
835
+ return {"kind": "SCA", "summary": view["title"], "command_text": view["body"], "targets": new_targets,
836
+ "number_keys": [sca_card.set_key(f, view["set_no"])],
837
+ "warnings": warnings + list(view.get("warnings") or []),
838
+ "anchor": f.hub_id, "fingerprint": snap.fingerprint, "expect": sca_expect(view, f.package_display_name),
839
+ "require_reviewed": False}
840
+
841
+
842
+ def prepare_update(request: Request, row: dict, *, from_decisions: bool = False) -> dict:
843
+ """Подготовка «Push в Hub» из черновика (ADR-0126, dev1): {refusals, warnings, kind, summary,
844
+ command_text, targets (с новыми редакциями и отпечатками, как при создании – ADR-0120), number_keys, fingerprint,
845
+ anchor, tx_check}. Текст берётся у владельца; from_decisions=True явно собирает его генератором.
846
+ Нарушение формы ADR-0123 даёт отказ. tx_check(c) –
847
+ повтор в транзакции постановки `PUT`: приложение и адрес Hub, редакции решений и данные целей (у SAST – и
848
+ «Проверено»), отпечаток набора SCA, ADR-0123 по тому же тексту (название команды и номера находок – на соединении
849
+ транзакции)."""
850
+ db, settings = db_of(request), settings_of(request)
851
+ project_id = int(row["project_id"])
852
+ targets = loads(row.get("targets_json"), [])
853
+ if not targets:
854
+ return {"refusals": ["в дефекте нет находок – обновлять нечего"]}
855
+ kind = str(row.get("kind") or "")
856
+ if kind == "SAST":
857
+ prep = _update_sast(request, db, settings, project_id, row, targets, same_text=from_decisions)
858
+ elif kind == "SCA":
859
+ prep = _update_sca(request, db, project_id, row, targets, strict=from_decisions)
860
+ else:
861
+ return {"refusals": [f"вид дефекта «{kind or '–'}» не поддерживается"]}
862
+ if prep.get("refusals"):
863
+ return prep
864
+ owner = db.on_connection(lambda c: defect_drafts.owner_in(c, row))
865
+ members = db.on_connection(lambda c: defect_drafts.members_in(c, row))
866
+ draft_state = {k: owner[k] for k in ("draft_revision", "draft_fields_json", "draft_fields_basis_json", "conflicts_json")}
867
+ if not from_decisions:
868
+ prep.update(summary=owner["draft_summary"], command_text=owner["draft_command_text"])
869
+ number, why = hub_defects.title_number(prep["summary"])
870
+ if not str(prep["summary"] or "").strip():
871
+ return {**prep, "refusals": ["Заголовок черновика пуст: заполните его."]}
872
+ # номера в заголовке нет – его вернёт подготовка Push (ADR-0138)
873
+ if why != hub_defects.NO_NUMBER and (why or number != row.get("number")):
874
+ return {**prep, "refusals": ["Заголовок черновика должен содержать ровно один ID, равный резерву дефекта."]}
875
+ prep.update(**draft_state, members_snapshot=members)
876
+ # собрать текст из решений («Текст из решений») – строго по требованиям команды; «Push в Hub» отправляет текст,
877
+ # который сейчас в приложении, как есть, формат – предупреждение (всё взято из Hub,
878
+ # изменённое сохраняется обратно в Hub)
879
+ strict = from_decisions
880
+ if not str(prep.get("command_text") or "").strip(): # пустое описание запись в Hub не подтвердит – отказ сразу
881
+ return {**prep, "refusals": ["текст дефекта пуст – заполните его или соберите «Текст из решений»"]}
882
+ problems = text_problems(db, settings, project_id, kind, prep["command_text"], prep.get("expect"))
883
+ listed = ("; ".join(problems[:3]) + (f"; и ещё {len(problems) - 3}" if len(problems) > 3 else "")) if problems else ""
884
+ if problems and strict:
885
+ return {**prep, "refusals": ["текст не по требованиям команды (ADR-0123): " + listed]}
886
+ if problems:
887
+ prep["warnings"] = [*(prep.get("warnings") or []), "текст не по шаблону команды (ADR-0123), отправится как есть: "
888
+ + listed]
889
+ hub_target = _update_target(request, project_id, row)
890
+ fresh_targets = _fresh_check(project_id, prep["targets"], prep["require_reviewed"])
891
+ text_ok = (_text_check(request, db, settings, project_id, kind, prep["command_text"], prep.get("expect"))
892
+ if strict else (lambda c: None))
893
+ anchor, fingerprint = str(prep.get("anchor") or ""), str(prep.get("fingerprint") or "")
894
+
895
+ def tx_check(c) -> None:
896
+ current = defect_drafts.owner_in(c, row)
897
+ if (any(current[k] != v for k, v in draft_state.items())
898
+ or defect_drafts.members_in(c, row) != members):
899
+ raise StaleTarget("Черновик, конфликты или состав дефекта изменились: обновите страницу.")
900
+ from app import defect_fields, defect_references
901
+ defect_references.check_selected(c, current, defect_fields.basis_of(current)["references"])
902
+ hub_target(c)
903
+ fresh_targets(c)
904
+ if kind == "SCA" and db._sca_defect_fingerprint(c, project_id, anchor) != fingerprint:
905
+ raise StaleTarget(SCA_UPDATE_CHANGED)
906
+ text_ok(c)
907
+
908
+ return {**prep, "tx_check": tx_check}
909
+
910
+
911
+ def update_preparer(request: Request):
912
+ """Подготовка обновления для последствий ответа исполнителя и показа вкладки (hub_defects.after_op, sync)."""
913
+ return lambda row: prepare_update(request, row)
914
+
915
+
916
+ def _update_row(request: Request, project_id: int, defect_id: int) -> tuple[dict, dict]:
917
+ project, row = _project_row(request, project_id, defect_id)
918
+ blocker = send_blocker(settings_of(request), project)
919
+ if blocker:
920
+ raise DefectRefused(blocker)
921
+ if not _same_hub(row, settings_of(request).hub_url, project.get("hub_app_id")):
922
+ raise StaleTarget(UPDATE_TARGET_CHANGED)
923
+ return project, row
924
+
925
+
926
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/update")
927
+ async def update_start(request: Request, project_id: int, defect_id: int):
928
+ """«Подготовить обновление» (ADR-0125 п. 3, шаг 1): чтение `GET /defects/{id}` для предпросмотра; только у дефекта,
929
+ занесённого из Hub (дефект приложения – отказ «обновляются только занесённые»)."""
930
+ def apply():
931
+ _, row = _update_row(request, project_id, defect_id)
932
+ return hub_defects.start_update(db_of(request), row, _update_target(request, project_id, row))
933
+
934
+ return await _tab_action(request, project_id, apply, "hub_update_queued",
935
+ "Поставлено в очередь исполнителю: чтение дефекта для обновления.")
936
+
937
+
938
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/update-put")
939
+ async def update_put(request: Request, project_id: int, defect_id: int):
940
+ """«Push в Hub» (п. 3, шаг 2): поля generation и shown – поколение и отпечаток показанного предпросмотра;
941
+ подготовка по текущим решениям сверяется с предпросмотром, затем второе чтение (запись `PUT` ставит ответ на него)."""
942
+ form = await request.form(max_fields=5, max_files=0)
943
+ generation, shown = str(form.get("generation") or ""), str(form.get("shown") or "")
944
+
945
+ def apply():
946
+ _, row = _update_row(request, project_id, defect_id)
947
+ blocker = hub_sync.resync_blocker(db_of(request), project_id)
948
+ if blocker:
949
+ raise DefectRefused(blocker)
950
+ return hub_defects.request_put(db_of(request), row, generation=generation, shown=shown,
951
+ prep=prepare_update(request, row),
952
+ target_check=_update_target(request, project_id, row))
953
+
954
+ return await _tab_action(request, project_id, apply, "hub_update_put_queued",
955
+ "Поставлено в очередь исполнителю: проверка дефекта и запись в Hub.")
956
+
957
+
958
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/update-cancel")
959
+ async def update_cancel(request: Request, project_id: int, defect_id: int):
960
+ """«Отменить» предпросмотр обновления (п. 3, шаг 1а): поля generation и shown; в Hub ничего не уходило."""
961
+ form = await request.form(max_fields=5, max_files=0)
962
+ generation, shown = str(form.get("generation") or ""), str(form.get("shown") or "")
963
+
964
+ def apply():
965
+ _, row = _project_row(request, project_id, defect_id)
966
+ return hub_defects.cancel_update(db_of(request), row, generation=generation, shown=shown)
967
+
968
+ return await _tab_action(request, project_id, apply, "hub_update_cancelled", "Подготовка обновления отменена.")
969
+
970
+
971
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/update-verify")
972
+ async def update_verify(request: Request, project_id: int, defect_id: int):
973
+ """«Сверить» при неизвестном исходе `PUT` (п. 3, шаг 5): чтение `GET /defects/{id}`; повторно запрос не уходит."""
974
+ def apply():
975
+ _, row = _update_row(request, project_id, defect_id)
976
+ return hub_defects.verify_update(db_of(request), row, _update_target(request, project_id, row))
977
+
978
+ return await _tab_action(request, project_id, apply, "hub_update_verify_queued", "Сверка поставлена в очередь.")
979
+
980
+
981
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/update-reread")
982
+ async def update_reread(request: Request, project_id: int, defect_id: int):
983
+ """«Повторить чтение» (п. 3, шаг 4): подтверждающее чтение снова – запись принята Hub, подтверждения ещё нет."""
984
+ def apply():
985
+ _, row = _update_row(request, project_id, defect_id)
986
+ return hub_defects.reread_update(db_of(request), row, _update_target(request, project_id, row))
987
+
988
+ return await _tab_action(request, project_id, apply, "hub_update_reread_queued",
989
+ "Подтверждающее чтение поставлено в очередь.")
990
+
991
+
992
+ # ============================================================================ состав дефекта
993
+
994
+
995
+ def _defect_target(f, review, text, parts="", sig=""):
996
+ target = _target(f, review, text, parts, sig)
997
+ return {**target, "decision_hash": target["entered_hash"], "entered_hash": ""}
998
+
999
+
1000
+ def defect_parts(settings, review: dict | None) -> str:
1001
+ """Части отметки «Внесено в Hub» у дефекта, созданного запросом: как у карточки (entered_parts – обоснование,
1002
+ рекомендация, команда, версия) с признаком defect (часть «тело дефекта»)."""
1003
+ from app.routes import findings as card
1004
+ parts = json.loads(card.entered_parts(settings, review))
1005
+ parts["defect"] = 1
1006
+ return json.dumps(parts, sort_keys=True)
1007
+
1008
+
1009
+ def _busy_reason(db: Database, project_id: int, hub_id: str, own_row_id: int | None = None) -> str:
1010
+ """Находка уже занята другим дефектом из карточки: почему; «» – свободна."""
1011
+ other = db.hub_defect_for(project_id, [hub_id])
1012
+ if other is None or (own_row_id is not None and int(other["id"]) == own_row_id):
1013
+ return ""
1014
+ if other["state"] == "done":
1015
+ return f"дефект уже создан в Hub (№{other['hub_defect_id']})"
1016
+ if other["state"] in hub_defects.BUSY_STATES:
1017
+ return f"уже в другом дефекте из карточки ({hub_defects.STATE_LABELS.get(other['state'], other['state'])})"
1018
+ return ""
1019
+
1020
+
1021
+ def sast_defect_targets(db: Database, settings, project_id: int, f: Finding, review: dict, sig: str, body: str
1022
+ ) -> tuple[list[dict], list[dict]]:
1023
+ """Цели дефекта SAST: эта находка и находки её группы «та же строка, категория и код» с тем же сохранённым
1024
+ решением «Подтверждаю дефект» и тем же итоговым текстом (обоснование и пункты рекомендации – как сравнивает выдача
1025
+ дефекта). Второе значение – соседи, которые не вошли, с причиной (предпросмотр показывает окончательный состав)."""
1026
+ from app.routes import findings as card
1027
+ mine = defect.sast_effective("true_positive", review.get("final_comment") or "", str(review.get("final_fix") or ""))
1028
+ targets = [_defect_target(f, review, body, defect_parts(settings, review), sig)]
1029
+ left_out: list[dict] = []
1030
+ mine_cmp = card.own_code_cmp(db, project_id, f.hub_id)
1031
+ for row in card.same_code(db.group_rows(project_id, card.group_key(f), f.hub_id), mine_cmp):
1032
+ hub_id = str(row["hub_id"])
1033
+ if row.get("missing"):
1034
+ left_out.append({"hub_id": hub_id, "why": "нет в текущей выгрузке"})
1035
+ continue
1036
+ other_review = db.get_review(project_id, hub_id)
1037
+ if not other_review or other_review.get("decision") not in ("agree", "disagree"):
1038
+ left_out.append({"hub_id": hub_id, "why": "решения нет"})
1039
+ continue
1040
+ if hub_verdict(other_review["decision"], other_review.get("final_verdict") or "") != "true_positive":
1041
+ left_out.append({"hub_id": hub_id, "why": "решение – не «Подтверждаю дефект»"})
1042
+ continue
1043
+ if not other_review.get("reviewed"):
1044
+ left_out.append({"hub_id": hub_id, "why": "нет отметки «Проверено»"})
1045
+ continue
1046
+ # то же правило, что у опорной находки и Push: иначе дефект создастся, а Push откажет из-за этого соседа
1047
+ origin = card.comment_origin(db, db.get_case(project_id, hub_id), other_review, other_review.get("final_comment") or "",
1048
+ project_id=project_id, hub_id=hub_id)
1049
+ if origin and origin != "true_positive":
1050
+ left_out.append({"hub_id": hub_id, "why": "обоснование – текст модели к другому вердикту"})
1051
+ continue
1052
+ theirs = defect.sast_effective("true_positive", other_review.get("final_comment") or "",
1053
+ str(other_review.get("final_fix") or ""))
1054
+ if theirs != mine:
1055
+ left_out.append({"hub_id": hub_id, "why": "другой текст решения (обоснование или рекомендация)"})
1056
+ continue
1057
+ if other_review.get("entered_hub") and other_review.get("entered_text_hash") == text_hash(body):
1058
+ left_out.append({"hub_id": hub_id, "why": "дефект с этим текстом уже внесён в Hub (отметка стоит)"})
1059
+ continue
1060
+ busy = _busy_reason(db, project_id, hub_id)
1061
+ if busy:
1062
+ left_out.append({"hub_id": hub_id, "why": busy})
1063
+ continue
1064
+ other_sig = db.finding_sig(project_id, hub_id) # до чтения данных: обновление выгрузки поймает транзакция
1065
+ other = _finding_of(db, project_id, hub_id)
1066
+ if other is None:
1067
+ left_out.append({"hub_id": hub_id, "why": "нет в текущей выгрузке"})
1068
+ continue
1069
+ targets.append(_defect_target(other, other_review, body, defect_parts(settings, other_review), other_sig))
1070
+ return targets, left_out
1071
+
1072
+
1073
+ def retry_context(db: Database, project_id: int, row: dict) -> dict | None:
1074
+ """Попытка создания, которую Hub не принял: если тот же номер потом создан другой
1075
+ строкой – «заменена» со ссылкой на неё; иначе – куда пойти, чтобы подготовить дефект заново (у «Дефекта из
1076
+ выбранных» – та же форма с тем же составом, у карточки – карточка опорной находки). Запросов к Hub нет."""
1077
+ if row.get("state") != "failed" or row.get("origin") == "import":
1078
+ return None
1079
+ if row.get("number"):
1080
+ # «заменена» – только созданием, подтверждённым чтением (номер Hub есть), в том же Hub и приложении Hub
1081
+ # (ревью dev12): незавершённая попытка или дефект другого приложения – не замена
1082
+ newer = next((r for r in db._all(
1083
+ "SELECT id, state, hub_defect_id, hub_url, app_id FROM hub_defects WHERE project_id=? AND number=?"
1084
+ " AND kind=? AND id>? AND state IN ('done','mismatch') AND hub_defect_id != ''"
1085
+ " AND id = COALESCE(draft_owner_id, id) ORDER BY id",
1086
+ (project_id, row["number"], row["kind"], int(row["id"])))
1087
+ if _same_hub(r, row.get("hub_url") or "", row.get("app_id"))), None)
1088
+ if newer:
1089
+ number = str(newer.get("hub_defect_id") or "")
1090
+ return {"superseded": {"id": newer["id"], "hub_defect_id": number,
1091
+ "card_url": f"/projects/{project_id}/defects/{newer['id']}"}}
1092
+ from app.routes import defect_selected
1093
+ targets = [str(t.get("hub_id") or "") for t in loads(row.get("targets_json"), []) if t.get("hub_id")]
1094
+ if defect_selected.attempt(row) and targets:
1095
+ from urllib.parse import urlencode
1096
+ return {"retry_url": f"/projects/{project_id}/hub/defect-selected?"
1097
+ + urlencode([("hub_id", h) for h in targets])}
1098
+ anchor = str(row.get("anchor_hub_id") or "") or (targets[0] if targets else "")
1099
+ url = _card_url_of(db, project_id, anchor) if anchor else ""
1100
+ return {"retry_url": url} if url else None
1101
+
1102
+
1103
+ def _same_hub(row: dict, hub_url: str, app_id) -> bool:
1104
+ """Строка дефекта – того же Hub и того же приложения Hub (как область ключа операции и IN_HUB_SQL): дефект,
1105
+ созданный в другом приложении (номер приложения проекта сменили), в запрете второго дефекта не учитывается и к
1106
+ привязке не предлагается (номер ID<n> группы он держит по-прежнему – бэклог 42)."""
1107
+ return (str(row.get("hub_url") or "") == hub_ops.hub_base(hub_url)
1108
+ and int(row.get("app_id") or 0) == int(app_id or 0))
1109
+
1110
+
1111
+ def shown_targets(targets: list[dict]) -> str:
1112
+ """Состав привязки так, как его видит оператор и передаёт форма «Привязать» (поле targets): номера находок через
1113
+ запятую по порядку."""
1114
+ return ",".join(sorted(str(t["hub_id"]) for t in targets))
1115
+
1116
+
1117
+ def link_parent(db: Database, settings, project_id: int, f: Finding, review: dict, app_id) -> dict | None:
1118
+ """Готовый дефект группы для находки (ADR-0121 п. 5): у соседа «та же строка, категория и код» – строка дефекта
1119
+ SAST того же Hub и приложения Hub (app_id – номер приложения проекта) с известным номером в Hub в состоянии
1120
+ «создан» или «привязка неполная», и её текст команды (command_text – тело, ушедшее в Hub) тот же, что тело дефекта
1121
+ этой находки по её сохранённому решению (тело от находки не зависит). Текущее решение соседа не сравнивается: его
1122
+ могли сменить после создания дефекта. Несколько – самая ранняя строка; нет – None. Дефект, занесённый из Hub
1123
+ (origin 'import', ADR-0124 п. 7), не выбирается никогда, и после «Push в Hub» тоже (ADR-0125 п. 4, вариант
1124
+ A): находки к нему привязывают в Hub и добавляют «Pull из Hub»."""
1125
+ from app.routes import findings as card
1126
+ mine = text_hash(defect_where.body_of(card.sast_entered_text(db, settings, project_id, f, review)))
1127
+ found = None
1128
+ for row in card.same_code(db.group_rows(project_id, card.group_key(f), f.hub_id),
1129
+ card.own_code_cmp(db, project_id, f.hub_id)):
1130
+ if row.get("missing"):
1131
+ continue
1132
+ bound = db.hub_defect_bound(project_id, str(row["hub_id"]))
1133
+ if (bound is None or bound.get("origin") == "import" or db.imported_defect(project_id, bound)
1134
+ or hub_defects.update_unconfirmed(bound) or hub_defects.update_busy(bound)
1135
+ or bound["state"] not in ("done", "mismatch")
1136
+ or bound["kind"] != "SAST"
1137
+ or not bound.get("hub_defect_id") or not _same_hub(bound, settings.hub_url, app_id)
1138
+ or text_hash(defect_where.body_of(bound.get("command_text"))) != mine):
1139
+ continue
1140
+ if found is None or int(bound["id"]) < int(found["id"]):
1141
+ found = bound
1142
+ return found
1143
+
1144
+
1145
+ def group_defect_check(db: Database, project_id: int, hub_id: str, body: str, exclude=(), *, hub_url: str, app_id,
1146
+ in_preview: bool = False, selected_owner: int | None = None):
1147
+ """Проверка в транзакции заготовки и «Создать» дефекта SAST (ADR-0121 п. 5): соседи находки hub_id по подгруппе
1148
+ «та же строка, категория и код» читаются на соединении транзакции (Database._group_neighbor_ids); сосед, кроме
1149
+ exclude (свои цели), привязан к строке дефекта того же Hub и приложения Hub (hub_url, app_id – куда уйдёт этот
1150
+ дефект) с тем же текстом команды, что тело этого дефекта, – второй дефект по группе не ставится: «создан» и
1151
+ «привязка неполная» – «привяжите к дефекту №…», «результат неизвестен» – «сверьте дефект №… в карточке …» (без
1152
+ номера в Hub – и ручной путь, если сверка дефект не нашла: бэклог 41), «создаётся», «проверка привязки», «привязка
1153
+ находок» – «дождитесь итога дефекта №…». in_preview – проверка из «Создать» (у находки открыт предпросмотр, кнопки
1154
+ «Привязать» нет): отказ советует «Отменить предпросмотр». Готовый дефект мог быть удалён в Hub – в отказе назван
1155
+ ручной путь (бэклог 39). Дефект, занесённый из Hub (ADR-0124 п. 7), текстом не сравнивается: достаточно членства в
1156
+ группе – «привяжите находку к нему в Hub и нажмите «Pull из Hub» во вкладке «Дефекты» – находка добавится»; при
1157
+ открытом предпросмотре (in_preview) – сначала «Отменить предпросмотр»: предпросмотр держит находку целью, и сверка её
1158
+ не добавит. Так и после «Push в Hub» (ADR-0125 п. 4, вариант A); пока по дефекту идёт обновление или запись
1159
+ ждёт подтверждения, отказ называет сначала его итог: «Pull из Hub» в это время сама отказывает. selected_owner –
1160
+ оператор сам выбрал дефект («Добавить в дефект», ADR-0136): сосед в этой семье не мешает и текст с ним не
1161
+ сравнивается, сосед в другом дефекте – отказ с названием этого дефекта."""
1162
+ expected = text_hash(defect_where.body_of(body)) # раздел «Где исправлять» – не текст решения
1163
+ skip = {str(h or "") for h in exclude}
1164
+
1165
+ def check(c) -> None:
1166
+ for neighbor in db._group_neighbor_ids(c, project_id, hub_id):
1167
+ if neighbor in skip:
1168
+ continue
1169
+ row = Database.hub_defect_bound_in(c, project_id, neighbor)
1170
+ if row is None or row["kind"] != "SAST" or not _same_hub(row, hub_url, app_id):
1171
+ continue
1172
+ if selected_owner is not None:
1173
+ if int(row.get("draft_owner_id") or row["id"]) != int(selected_owner):
1174
+ raise DefectRefused(f"Находка {neighbor} той же строки и категории уже в дефекте "
1175
+ f"{hub_defects.bound_label(row) or 'из карточки'}: добавьте находку в него.")
1176
+ continue
1177
+ if (row.get("origin") != "import" and not Database.imported_defect_in(c, project_id, row)
1178
+ and (hub_defects.update_unconfirmed(row) or hub_defects.update_busy(row))):
1179
+ raise DefectRefused("В группе есть дефект: обновление не подтверждено или ещё выполняется. "
1180
+ "Сначала завершите его; второй дефект по группе не создаётся.")
1181
+ if row.get("origin") == "import" or Database.imported_defect_in(c, project_id, row):
1182
+ name = hub_defects.bound_label(row) or "из Hub"
1183
+ # «Pull из Hub» сама отказывает, пока идёт обновление или запись ждёт подтверждения (ADR-0125 п. 2)
1184
+ if hub_defects.update_unconfirmed(row):
1185
+ raise DefectRefused(f"В группе есть дефект {name} (занесён из Hub), запись в Hub по нему принята, "
1186
+ "но не подтверждена: во вкладке «Дефекты» сначала «Повторить чтение» или "
1187
+ "заново «Push в Hub»; второй дефект по группе не создаётся.")
1188
+ if (not row.get("update_op_id")
1189
+ and hub_defects.update_state(row).get("phase") == "unknown"): # ждать нечего – нужна сверка
1190
+ raise DefectRefused(f"В группе есть дефект {name} (занесён из Hub), результат «Push в Hub» по "
1191
+ "нему неизвестен: во вкладке «Дефекты» нажмите «Сверить» в его строке; второй "
1192
+ "дефект по группе не создаётся.")
1193
+ if hub_defects.update_busy(row):
1194
+ raise DefectRefused(f"В группе есть дефект {name} (занесён из Hub), по нему идёт «Push в Hub»: "
1195
+ "дождитесь его итога во вкладке «Дефекты»; второй дефект по группе не "
1196
+ "создаётся.")
1197
+ first = "нажмите «Отменить предпросмотр», затем привяжите" if in_preview else "привяжите"
1198
+ raise DefectRefused(f"В группе есть дефект {name} (занесён из Hub): "
1199
+ f"{first} находку к нему в Hub и нажмите «Pull из Hub» во вкладке «Дефекты» – "
1200
+ "находка добавится; второй дефект по группе не создаётся.")
1201
+ if text_hash(defect_where.body_of(row.get("command_text"))) != expected:
1202
+ continue
1203
+ name = hub_defects.bound_label(row) or "из карточки"
1204
+ if row["state"] in ("done", "mismatch") and row.get("hub_defect_id"):
1205
+ how = ("нажмите «Отменить предпросмотр», затем «Привязать к дефекту»" if in_preview
1206
+ else "кнопка «Привязать к дефекту»")
1207
+ raise DefectRefused(f"В группе уже есть дефект {name} с тем же текстом решения: привяжите к дефекту "
1208
+ f"{name} ({how}) – второй дефект не создаётся. Если дефект {name} удалён в Hub "
1209
+ "(проверьте его в Hub или «Синхронизировать» во вкладке «Дефекты»), привязка не пройдёт: создайте дефект вручную по "
1210
+ "панели «Дефект для Hub» и нажмите «Отметить: дефект создан в Hub».")
1211
+ if row["state"] in ("unknown", "unconfirmed"):
1212
+ # без номера в Hub «Сверить» может не найти дефект – строка остаётся «результат неизвестен», кнопки
1213
+ # привязки не будет (бэклог 41): называется ручной путь, который есть в карточке
1214
+ manual = ("" if row.get("hub_defect_id") else
1215
+ " Если «Сверить» дефект в Hub не нашла, исход остаётся неизвестным и привязки в приложении "
1216
+ "не будет: проверьте дефект в Hub сами, привяжите к нему находку там или создайте дефект "
1217
+ "вручную по панели «Дефект для Hub» и нажмите «Отметить: дефект создан в Hub» – отметка этот "
1218
+ "запрет не снимает.")
1219
+ raise DefectRefused(f"В группе есть дефект {name} с тем же текстом решения и неясным исходом: сверьте "
1220
+ f"дефект {name} в карточке находки {row.get('anchor_hub_id')} («Сверить»), затем "
1221
+ "привяжите к нему находку – второй дефект не создаётся." + manual)
1222
+ raise DefectRefused(f"В группе уже идёт дефект {name} с тем же текстом решения (состояние «"
1223
+ f"{hub_defects.STATE_LABELS.get(row['state'], row['state'])}»): дождитесь итога "
1224
+ f"дефекта {name} и привяжите к нему находку – второй дефект не создаётся.")
1225
+ return check
1226
+
1227
+
1228
+ def link_group_check(db: Database, project_id: int, hub_id: str, parent_id: int):
1229
+ """Проверка в транзакции привязки (ADR-0121 п. 5): строка готового дефекта – дефект группы находки hub_id, то есть
1230
+ среди её целей есть сосед по подгруппе «та же строка, категория и код», прочитанный на соединении транзакции."""
1231
+ def check(c) -> None:
1232
+ row = c.execute("SELECT targets_json FROM hub_defects WHERE id = ?", (int(parent_id),)).fetchone()
1233
+ own = {str(t.get("hub_id") or "") for t in loads(row["targets_json"] if row else "", [])}
1234
+ if not own & set(db._group_neighbor_ids(c, project_id, hub_id)):
1235
+ raise StaleTarget("Состав группы изменился, пока карточка была открыта: готовый дефект уже не дефект группы "
1236
+ "этой находки – обновите карточку.")
1237
+ return check
1238
+
1239
+
1240
+ def _in_defect(db: Database, project_id: int, hub_id: str, defect_id: str) -> bool:
1241
+ """Находка уже привязана к дефекту defect_id (номер в Hub) – в «не войдут» привязки она не называется."""
1242
+ bound = db.hub_defect_bound(project_id, str(hub_id))
1243
+ return bound is not None and str(bound.get("hub_defect_id") or "") == defect_id
1244
+
1245
+
1246
+ def link_offer(db: Database, settings, project_id: int, hub_id: str, app_id) -> dict | None:
1247
+ """«Привязать к дефекту №…» для новой находки группы (ADR-0121 п. 5): находка SAST не привязана, сохранено
1248
+ «Подтверждаю дефект» с «Проверено», у соседа того же кода – созданный дефект того же Hub и приложения Hub (app_id)
1249
+ с тем же текстом решения (link_parent). Кто войдёт – эта находка и непривязанные соседи с тем же текстом,
1250
+ «Проверено», без занятости (как у заготовки, sast_defect_targets); кто нет – с причиной; уже привязанные к этому
1251
+ дефекту не перечисляются; shown – состав для формы (shown_targets: маршрут сверяет его с собранным заново). Нет –
1252
+ None."""
1253
+ from app.routes import findings as card
1254
+ found = db.get_finding_by_hub_id(project_id, hub_id)
1255
+ if found is None or found["kind"] != "SAST" or found.get("missing"):
1256
+ return None
1257
+ review = db.get_review(project_id, hub_id)
1258
+ if (not review or not review.get("reviewed")
1259
+ or hub_verdict(review.get("decision") or "", review.get("final_verdict") or "") != "true_positive"):
1260
+ return None
1261
+ f = _finding_of(db, project_id, hub_id)
1262
+ parent = link_parent(db, settings, project_id, f, review, app_id) if f is not None else None
1263
+ if parent is None:
1264
+ return None
1265
+ try:
1266
+ targets, left_out = sast_defect_targets(db, settings, project_id, f, review,
1267
+ db.finding_sig(project_id, hub_id),
1268
+ card.sast_entered_text(db, settings, project_id, f, review))
1269
+ except hub_status.StatusRefused:
1270
+ # нечисловой номер Hub у находки или соседа: при показе карточки предложения нет (не 500); отправка такой
1271
+ # группы получает отказ 400, как и до изменения (круг 4 ревью 0.9.23.dev1)
1272
+ return None
1273
+ defect_id = str(parent["hub_defect_id"])
1274
+ return {"parent": parent, "label": hub_defects.bound_label(parent), "shown": shown_targets(targets),
1275
+ "targets": [{"hub_id": str(t["hub_id"]), "url": _card_url_of(db, project_id, str(t["hub_id"]))}
1276
+ for t in targets],
1277
+ "left_out": [e for e in left_out if not _in_defect(db, project_id, e["hub_id"], defect_id)]}
1278
+
1279
+
1280
+ def _fresh_check(project_id: int, targets: list[dict], require_reviewed: bool, row_id: int | None = None,
1281
+ expect_state: str = ""):
1282
+ """Проверка в транзакции постановки: у всех целей та же редакция решения, те же данные находки, находка в выгрузке
1283
+ (у SAST – и отметка «Проверено»); строка дефекта ещё в ожидаемом состоянии."""
1284
+ def check(c) -> None:
1285
+ if row_id is not None:
1286
+ state = c.execute("SELECT state FROM hub_defects WHERE id = ?", (row_id,)).fetchone()
1287
+ if state is None or state["state"] != expect_state:
1288
+ raise StaleTarget("Состояние дефекта изменилось в другой вкладке: обновите карточку.")
1289
+ for target in targets:
1290
+ review = c.execute("SELECT revision, reviewed, decision FROM reviews WHERE project_id = ? AND hub_id = ?",
1291
+ (project_id, str(target["hub_id"]))).fetchone()
1292
+ data = c.execute("SELECT data_json, missing FROM findings WHERE project_id = ? AND hub_id = ?",
1293
+ (project_id, str(target["hub_id"]))).fetchone()
1294
+ # «Проверено» – у решений оператора; у решения «из Hub» отметки нет
1295
+ fresh = (review is not None and int(review["revision"] or 0) == int(target["revision"])
1296
+ and (review["reviewed"] or not require_reviewed or review["decision"] == defect_drafts.HUB_DECISION)
1297
+ and data is not None and not data["missing"]
1298
+ and finding_data_sig(data["data_json"]) == target.get("sig"))
1299
+ if not fresh:
1300
+ raise StaleTarget(f"Решение или данные находки {target['hub_id']} изменились, пока собирался запрос: "
1301
+ "обновите карточку и повторите.")
1302
+ return check
1303
+
1304
+
1305
+ # ============================================================================ заготовка
1306
+
1307
+
1308
+ def _answer(project_id: int, row: dict, message: str = "", reload: bool = False) -> dict:
1309
+ view = hub_defects.view(row)
1310
+ return {"ok": True, "defect_id": row["id"], "status_url": f"/projects/{project_id}/hub/defects/{row['id']}",
1311
+ "done": view["final"], "text": {"hub-defect-status": view["text"]},
1312
+ "show": ["hub-defect-status"] + (["hub-defect-verify-form"] if view["verify"] else []),
1313
+ "hide": ([] if view["verify"] else ["hub-defect-verify-form"]),
1314
+ **({"message": message} if message else {}), **({"reload": True} if reload else {})}
1315
+
1316
+
1317
+ def _back(request: Request, suffix: str, ok: str) -> str:
1318
+ path = request.url.path[: -len(suffix)] if request.url.path.endswith(suffix) else request.url.path
1319
+ query = "&".join(p for p in request.url.query.split("&") if p and not p.startswith("ok="))
1320
+ return f"{path}?{query + '&' if query else ''}ok={ok}#hub-defect"
1321
+
1322
+
1323
+ def _prepare_sast(request: Request, project: dict, finding_id: int, shown_revision: str, shown_hash: str) -> dict:
1324
+ """Состав и текст дефекта SAST по сохранённому решению карточки (как выдача «Скопировать полный текст дефекта»)."""
1325
+ from app.routes import findings as card
1326
+ db, settings, pid = db_of(request), settings_of(request), int(project["id"])
1327
+ row = db.get_finding(pid, finding_id)
1328
+ if row is None or row["kind"] != "SAST":
1329
+ raise LookupError("Находка не найдена.")
1330
+ source = db.case_input(pid, row["hub_id"])
1331
+ if source is None or source.get("missing"):
1332
+ raise DefectRefused("Находки нет в текущей выгрузке: дефект по ней не готовится.")
1333
+ sig = db.finding_sig(pid, row["hub_id"])
1334
+ f = Finding.from_dict(source["data"])
1335
+ review = db.get_review(pid, f.hub_id)
1336
+ if not review or not review.get("decision"):
1337
+ raise DefectRefused("Сначала сохраните решение «Подтверждаю дефект» с обоснованием и рекомендацией.")
1338
+ if not shown_revision.isdigit() or int(shown_revision) != int(review.get("revision") or 0):
1339
+ raise DefectRefused(STALE_REVISION)
1340
+ if not review.get("reviewed"):
1341
+ raise DefectRefused(NOT_REVIEWED)
1342
+ case = db.get_case(pid, f.hub_id)
1343
+ assessment = card.sast_assess(request, pid, review, case, source)
1344
+ if assessment["state"] != "ok":
1345
+ raise DefectRefused(card.sast_state_hint(assessment["state"], review, card.SAST_DEFECT_NOT_READY))
1346
+ view = card.sast_defect(db, settings, store_of(request), pid, f, review, None,
1347
+ shown=card.defect_shown_lines(request, pid, f, case), state="ok", source=source)
1348
+ if not view["ready"]:
1349
+ raise DefectRefused(view["hint"])
1350
+ if not shown_hash:
1351
+ raise DefectRefused(TEXT_NOT_SHOWN)
1352
+ if shown_hash != text_hash(view["body"]):
1353
+ raise DefectRefused(TEXT_CHANGED)
1354
+ origin = card.comment_origin(db, case, review, review.get("final_comment") or "", project_id=pid, hub_id=f.hub_id)
1355
+ if origin and origin != "true_positive":
1356
+ raise DefectRefused("Обоснование – текст модели к другому вердикту: поправьте комментарий в карточке, "
1357
+ "сохраните решение и создавайте дефект.")
1358
+ targets, left_out = sast_defect_targets(db, settings, pid, f, review, sig, view["body"])
1359
+ return {"kind": "SAST", "f": f, "number": int(view["number"]), "summary": view["title"], "body": view["body"],
1360
+ "targets": targets, "left_out": left_out, "warnings": list(view.get("warnings") or []),
1361
+ "number_keys": [defect.defect_key_sast(str(t["hub_id"])) for t in targets], "require_reviewed": True}
1362
+
1363
+
1364
+ def _prepare_sca(request: Request, project: dict, finding_id: int, shown_revision: str, shown_hash: str) -> dict:
1365
+ """Состав и текст дефекта SCA по набору находки (sca_defect): участники набора – цели."""
1366
+ from app.routes import sca as sca_card
1367
+ db, pid = db_of(request), int(project["id"])
1368
+ row = db.get_finding(pid, finding_id)
1369
+ if row is None or row["kind"] != "SCA":
1370
+ raise LookupError("Находка не найдена.")
1371
+ snap = db.sca_snapshot(pid, row["hub_id"])
1372
+ if snap.row is None:
1373
+ raise DefectRefused("Находки нет в текущей выгрузке: дефект по ней не готовится.")
1374
+ f = Finding.from_dict(snap.row["data"])
1375
+ review = snap.review
1376
+ if not review or not (review.get("decision") or review.get("final_verdict")):
1377
+ raise DefectRefused("Сначала сохраните решение «Обновить» по находке набора.")
1378
+ if not shown_revision.isdigit() or int(shown_revision) != int(review.get("revision") or 0):
1379
+ raise DefectRefused(STALE_REVISION)
1380
+ view = sca_card.sca_defect(snap, store_of(request), pid, f, review)
1381
+ if not view["ready"]:
1382
+ raise DefectRefused(view["hint"] or "Дефект SCA не готов.")
1383
+ if view.get("comment_stale"):
1384
+ raise DefectRefused("В дефект входят находки, где комментарий – текст агента к другому выводу: "
1385
+ + ", ".join(str(x) for x in view["comment_stale"][:10])
1386
+ + ". Поправьте комментарий в их карточках и сохраните.")
1387
+ if not shown_hash:
1388
+ raise DefectRefused(TEXT_NOT_SHOWN)
1389
+ if shown_hash != str(view.get("text_sig") or ""):
1390
+ raise DefectRefused(TEXT_CHANGED)
1391
+ targets: list[dict] = []
1392
+ for hub_id in view.get("members") or []:
1393
+ member_review = review if hub_id == f.hub_id else db.get_review(pid, hub_id)
1394
+ member_sig = db.finding_sig(pid, hub_id)
1395
+ member = _finding_of(db, pid, hub_id)
1396
+ if member is None or not member_review:
1397
+ raise DefectRefused(f"Находка {hub_id} набора изменилась: обновите карточку и повторите.")
1398
+ targets.append({"hub_id": hub_id, "issue_id": hub_status.issue_id(hub_id),
1399
+ "issue_type": hub_status.issue_type(member.kind),
1400
+ "revision": int(member_review.get("revision") or 0),
1401
+ "decision_hash": str(view["text_sig"]), "entered_hash": "", "entered_parts": "", "sig": member_sig})
1402
+ if not any(t["hub_id"] == f.hub_id for t in targets):
1403
+ raise DefectRefused("Находки нет в наборе дефекта: обновите карточку.")
1404
+ left_out = [{"hub_id": str(x.get("hub_id") or ""), "why": str(x.get("reason") or "")}
1405
+ for x in view.get("excluded") or []]
1406
+ for t in targets:
1407
+ busy = _busy_reason(db, pid, str(t["hub_id"]))
1408
+ if busy and t["hub_id"] != f.hub_id:
1409
+ raise DefectRefused(f"Находка {t['hub_id']} набора {busy}: сначала закройте тот дефект.")
1410
+ return {"kind": "SCA", "f": f, "number": int(view["number"]), "summary": view["title"], "body": view["body"],
1411
+ "targets": targets, "left_out": left_out, "warnings": list(view.get("warnings") or []),
1412
+ "number_keys": [sca_card.set_key(f, view["set_no"])], "require_reviewed": False,
1413
+ "fingerprint": snap.fingerprint, "expect": sca_expect(view, f.package_display_name)}
1414
+
1415
+
1416
+
1417
+ def _card_url(project_id: int, defect_id: int, params, ok: str = "") -> str:
1418
+ """Адрес карточки дефекта с адресом возврата к списку (back из запроса или back_to из формы карточки), если он
1419
+ был: отборы списка переживают заготовку, «Создать» и «Отменить» (ревью dev28). Сам адрес
1420
+ возврата карточка проверяет через worklists.return_url."""
1421
+ from urllib.parse import quote
1422
+ back = str(params.get("back_to") or params.get("back") or "")[:2000]
1423
+ if back == "defect-card":
1424
+ back = ""
1425
+ query = [("ok", ok)] if ok else []
1426
+ if back:
1427
+ query.append(("back", back))
1428
+ return f"/projects/{project_id}/defects/{defect_id}" + ("?" + "&".join(f"{k}={quote(v, safe='')}" for k, v in query) if query else "")
1429
+
1430
+ async def _blank(request: Request, project_id: int, finding_id: int, kind: str):
1431
+ form = await request.form(max_fields=10, max_files=0)
1432
+ shown_revision = str(form.get("review_revision") or "")
1433
+ shown_hash = str(form.get("text_hash") or "")
1434
+
1435
+ def apply():
1436
+ project = project_or_404(request, project_id)
1437
+ settings, db = settings_of(request), db_of(request)
1438
+ blocker = send_blocker(settings, project) or hub_sync.resync_blocker(db, project_id)
1439
+ if blocker:
1440
+ raise DefectRefused(blocker)
1441
+ db.hub_expire_leases()
1442
+ found = db.get_finding(project_id, finding_id)
1443
+ if found is None:
1444
+ raise LookupError("Находка не найдена.")
1445
+ # прежний дефект находки – до сборки состава: открытый предпросмотр не заменяется (отказ раньше подготовки),
1446
+ # дефект в работе или созданный – отказ
1447
+ current = db.hub_defect_for(project_id, [str(found["hub_id"])])
1448
+ if current is not None:
1449
+ current = hub_defects.sync(db, current, update_preparer(request))
1450
+ if current["state"] == "done":
1451
+ raise DefectRefused(f"Дефект по этой находке уже создан в Hub (№{current['hub_defect_id']}): "
1452
+ "см. вкладку «Дефекты».")
1453
+ if current["state"] in hub_defects.OPEN_STATES:
1454
+ raise ValueError("Операция по этому дефекту уже идёт: дождитесь её итога.")
1455
+ if current["state"] in ("unknown", "mismatch"):
1456
+ raise ValueError("У этой находки есть дефект с неясным исходом: сверьте его или проверьте в Hub.")
1457
+ if current["state"] == "preview": # открытый предпросмотр не заменяется
1458
+ raise ValueError(PREVIEW_OPEN)
1459
+ prepared = (_prepare_sast if kind == "SAST" else _prepare_sca)(request, project, finding_id, shown_revision,
1460
+ shown_hash)
1461
+ f = prepared["f"]
1462
+ # текст не по требованиям команды в Hub не уходит (ADR-0123 п. 5): отказ до записи операций и ещё раз в
1463
+ # транзакции постановки; «Привязать к дефекту» текст не отправляет и не проверяется
1464
+ problems = text_problems(db, settings, project_id, kind, prepared["body"], prepared.get("expect"))
1465
+ if problems:
1466
+ raise DefectRefused(defect_check.refusal(problems))
1467
+ text_ok = _text_check(request, db, settings, project_id, kind, prepared["body"], prepared.get("expect"))
1468
+ fresh_targets = _fresh_check(project_id, prepared["targets"], prepared["require_reviewed"])
1469
+ app_id = int(project["hub_app_id"])
1470
+ # строка дефекта запоминает приложение и адрес Hub предпросмотра – те, что прочитаны здесь (KIMI-12)
1471
+ hub_target = hub_target_check(request, project_id, settings.hub_url, app_id)
1472
+ # сосед группы с тем же текстом уже в дефекте того же Hub и приложения – привязка к нему, второго нет (ADR-0121
1473
+ # п. 5): в транзакции
1474
+ group = (group_defect_check(db, project_id, f.hub_id, prepared["body"],
1475
+ [t["hub_id"] for t in prepared["targets"]], hub_url=settings.hub_url,
1476
+ app_id=app_id) if kind == "SAST" else None)
1477
+
1478
+ def check(c) -> None:
1479
+ hub_target(c)
1480
+ fresh_targets(c)
1481
+ if group is not None:
1482
+ group(c)
1483
+ text_ok(c)
1484
+
1485
+ issue_type = hub_status.issue_type(f.kind)
1486
+ requests = [dict(purpose="defect_blank", request=hub_defects.blank_request(app_id, prepared["targets"], issue_type),
1487
+ hub_url=settings.hub_url, app_id=app_id, project_id=project_id, targets=prepared["targets"],
1488
+ text=prepared["summary"])]
1489
+ if not hub_defects.service_info(db, settings.hub_url): # справочник – один раз, дальше переиспользуется
1490
+ requests.append(dict(purpose="read", request=hub_defects.service_info_request(), hub_url=settings.hub_url,
1491
+ app_id=app_id, project_id=project_id, targets=[]))
1492
+ # строка дефекта, проверка занятости целей и номера, заготовка – одной транзакцией (находки 1 и 6)
1493
+ row, _ = db.hub_defect_start(project_id, items=requests, check=check,
1494
+ kind=prepared["kind"], number=prepared["number"], summary=prepared["summary"],
1495
+ anchor_hub_id=f.hub_id, targets=prepared["targets"],
1496
+ number_keys=prepared["number_keys"], command_text=prepared["body"],
1497
+ hub_url=settings.hub_url, app_id=app_id, left_out=prepared["left_out"],
1498
+ warnings=prepared["warnings"], source_fingerprint=prepared.get("fingerprint", ""))
1499
+ return row
1500
+
1501
+ as_json = wants_json(request)
1502
+ try:
1503
+ row = await run_in_threadpool(apply)
1504
+ except HTTPException as e:
1505
+ return await _refused(request, as_json, str(e.detail), e.status_code)
1506
+ except hub_status.StatusRefused as e:
1507
+ return await _refused(request, as_json, str(e), 400)
1508
+ except LookupError as e:
1509
+ return await _refused(request, as_json, str(e), 404)
1510
+ except ValueError as e: # очередь: такая операция уже есть или у находки есть незакрытая
1511
+ return await _refused(request, as_json, str(e), 409)
1512
+ # логика оператора: «Создать дефект» сразу открывает карточку дефекта – там заголовок,
1513
+ # текст, состав и «Создать»; карточка сама дождётся заготовки Hub (опрос состояния)
1514
+ card = _card_url(project_id, row["id"], request.query_params)
1515
+ if not as_json:
1516
+ return redirect(card)
1517
+ count = len(loads(row.get("targets_json"), []))
1518
+ return {**_answer(project_id, row, f"Поставлено в очередь исполнителю: заготовка дефекта по находкам – {count}."),
1519
+ "redirect": card}
1520
+
1521
+
1522
+ @router.post("/projects/{project_id}/findings/{finding_id}/hub-defect")
1523
+ async def blank_sast(request: Request, project_id: int, finding_id: int):
1524
+ """«Создать дефект в Hub» в карточке SAST: заготовка по находке и её группе."""
1525
+ return await _blank(request, project_id, finding_id, "SAST")
1526
+
1527
+
1528
+ @router.post("/projects/{project_id}/sca/findings/{finding_id}/hub-defect")
1529
+ async def blank_sca(request: Request, project_id: int, finding_id: int):
1530
+ """«Создать дефект в Hub» в карточке SCA: заготовка по набору находки."""
1531
+ return await _blank(request, project_id, finding_id, "SCA")
1532
+
1533
+
1534
+ @router.post("/projects/{project_id}/findings/{finding_id}/hub-defect-link")
1535
+ async def link_sast(request: Request, project_id: int, finding_id: int):
1536
+ """«Привязать к дефекту №…» в карточке SAST (ADR-0121 п. 5): новая находка группы и её непривязанные соседи с тем
1537
+ же текстом решения – строка дефекта сразу «привязываю» (номер ID<n>, заголовок, текст команды, номер и ссылка в
1538
+ Hub – как у готового дефекта, цели – новые находки) и операция `POST /defects/{id}/link` одной транзакцией;
1539
+ дальше – чтение `GET /defects/{id}`, отметки «Внесено в Hub» и номер ID<n>, как у созданного дефекта. Заготовки Hub
1540
+ и предпросмотра нет: дефект уже есть. Поле targets – состав, который видел оператор (shown_targets): состав,
1541
+ собранный заново, другой – отказ, как у устаревшей цели. groupId – из заготовки готового дефекта (строка привязки
1542
+ хранит заготовку родителя, Database.hub_defect_link_start; назначение поля уточнить)."""
1543
+ form = await request.form(max_fields=10, max_files=0)
1544
+ shown_revision = str(form.get("review_revision") or "")
1545
+ shown_hash = str(form.get("text_hash") or "")
1546
+ shown_parent = str(form.get("defect") or "")
1547
+ shown_composition = str(form.get("targets") or "")
1548
+
1549
+ def apply():
1550
+ project = project_or_404(request, project_id)
1551
+ settings, db = settings_of(request), db_of(request)
1552
+ blocker = send_blocker(settings, project) or hub_sync.resync_blocker(db, project_id)
1553
+ if blocker:
1554
+ raise DefectRefused(blocker)
1555
+ db.hub_expire_leases()
1556
+ found = db.get_finding(project_id, finding_id)
1557
+ if found is None or found["kind"] != "SAST":
1558
+ raise LookupError("Находка не найдена.")
1559
+ current = db.hub_defect_for(project_id, [str(found["hub_id"])])
1560
+ if current is not None and hub_defects.sync(db, current, update_preparer(request))["state"] != "failed":
1561
+ raise ValueError("У этой находки уже есть дефект из карточки: обновите карточку.")
1562
+ prepared = _prepare_sast(request, project, finding_id, shown_revision, shown_hash)
1563
+ f = prepared["f"]
1564
+ app_id = int(project["hub_app_id"])
1565
+ # готовый дефект – только того же Hub и приложения Hub (link_parent)
1566
+ parent = link_parent(db, settings, project_id, f, db.get_review(project_id, f.hub_id) or {}, app_id)
1567
+ if parent is None or str(parent["id"]) != shown_parent:
1568
+ raise StaleTarget("Дефект группы изменился, пока карточка была открыта (решения соседей другие или "
1569
+ "дефект ещё не подтверждён): обновите карточку.")
1570
+ defect_id, targets = str(parent["hub_defect_id"]), prepared["targets"]
1571
+ # состав – тот, что видел оператор: сосед получил или потерял «Проверено» в другой вкладке – отказ, ничего не
1572
+ # ставится (свежесть каждой цели проверяет транзакция)
1573
+ if shown_targets(targets) != shown_composition:
1574
+ raise StaleTarget("Состав привязки изменился, пока карточка была открыта (у соседа по группе сменились "
1575
+ "решение или отметка «Проверено»): обновите карточку – она покажет, кто привяжется.")
1576
+ blank_body = loads(parent.get("blank_json"), {}) or {}
1577
+ item = dict(purpose="defect_link",
1578
+ request=hub_defects.link_request(defect_id, targets, blank_body.get("groupId")),
1579
+ hub_url=settings.hub_url, app_id=app_id, project_id=project_id, targets=targets,
1580
+ text=str(parent.get("summary") or ""))
1581
+ fresh_targets = _fresh_check(project_id, targets, True)
1582
+ in_group = link_group_check(db, project_id, f.hub_id, int(parent["id"]))
1583
+ # готовый дефект выбран по приложению и адресу Hub, прочитанным здесь, и операция уходит туда же (KIMI-12)
1584
+ hub_target = hub_target_check(request, project_id, settings.hub_url, app_id)
1585
+
1586
+ def check(c) -> None:
1587
+ hub_target(c)
1588
+ fresh_targets(c)
1589
+ in_group(c)
1590
+
1591
+ # строка «привязываю», проверка свежести целей, свободы, текста и состава группы, привязка – одной транзакцией
1592
+ return db.hub_defect_link_start(
1593
+ project_id, int(parent["id"]), defect_id, item=item, body_hash=text_hash(defect_where.body_of(prepared["body"])),
1594
+ hub_link=str(parent.get("hub_link") or ""), check=check, kind="SAST", number=parent.get("number"),
1595
+ summary=str(parent.get("summary") or ""), anchor_hub_id=f.hub_id, targets=targets,
1596
+ number_keys=prepared["number_keys"], command_text=str(parent.get("command_text") or ""),
1597
+ hub_url=settings.hub_url, app_id=app_id,
1598
+ left_out=[e for e in prepared["left_out"] if not _in_defect(db, project_id, e["hub_id"], defect_id)],
1599
+ warnings=prepared["warnings"])
1600
+
1601
+ as_json = wants_json(request)
1602
+ try:
1603
+ row = await run_in_threadpool(apply)
1604
+ except HTTPException as e:
1605
+ return await _refused(request, as_json, str(e.detail), e.status_code)
1606
+ except hub_status.StatusRefused as e:
1607
+ return await _refused(request, as_json, str(e), 400)
1608
+ except LookupError as e:
1609
+ return await _refused(request, as_json, str(e), 404)
1610
+ except ValueError as e: # очередь или занятость: такая операция уже есть, находка в другом дефекте
1611
+ return await _refused(request, as_json, str(e), 409)
1612
+ if not as_json:
1613
+ return redirect(_back(request, "/hub-defect-link", "hub_defect_link_queued"))
1614
+ count = len(loads(row.get("targets_json"), []))
1615
+ return _answer(project_id, row, f"Поставлено в очередь исполнителю: привязка к дефекту "
1616
+ f"{hub_defects.bound_label(row)} – находок {count}.")
1617
+
1618
+
1619
+ # ============================================================================ создание, состояние, сверка
1620
+
1621
+
1622
+ def _project_row(request: Request, project_id: int, defect_id: int) -> tuple[dict, dict]:
1623
+ project = project_or_404(request, project_id)
1624
+ db = db_of(request)
1625
+ db.hub_expire_leases()
1626
+ row = db.hub_defect(defect_id)
1627
+ if row is None or int(row["project_id"]) != project_id:
1628
+ raise LookupError("Дефект не найден.")
1629
+ return project, hub_defects.sync(db, row, update_preparer(request))
1630
+
1631
+
1632
+ def _sca_expect_at_create(request: Request, project_id: int, row: dict) -> dict:
1633
+ """Ожидания проверки текста набора SCA при «Создать» (ADR-0123 п. 4): из снимка набора, по которому собран
1634
+ предпросмотр. Снимок с другим отпечатком – тот же отказ, что в транзакции постановки (SCA_CHANGED): текст собран
1635
+ по другим данным. Отпечаток тот же, а набор по нему уже не готов или без цели (ни целевой версии, ни «Исправленной
1636
+ версии нет») или тело по снимку уже другое (например, истёк срок пересмотра решения по компоненту – цель взята из
1637
+ исследования, а дата в отпечаток не входит) – тот же отказ до проверки формы: нарушение «строки обновления» ввело
1638
+ бы в заблуждение."""
1639
+ from app.routes import sca as sca_card
1640
+ db = db_of(request)
1641
+ snap = db.sca_snapshot(project_id, str(row.get("anchor_hub_id") or ""))
1642
+ if snap.row is None or (row.get("source_fingerprint") and snap.fingerprint != row["source_fingerprint"]):
1643
+ raise StaleTarget(SCA_CHANGED)
1644
+ f = Finding.from_dict(snap.row["data"])
1645
+ view = sca_card.sca_defect(snap, store_of(request), project_id, f, snap.review)
1646
+ if not view.get("description") or not view.get("ready") or not (view.get("target") or view.get("no_fix")):
1647
+ raise StaleTarget(SCA_CHANGED)
1648
+ # тело по снимку другое (например, истёк срок пересмотра решения по компоненту и цель взята из исследования):
1649
+ # текст предпросмотра собран по другой цели – «набор изменился», а не нарушение строки обновления
1650
+ if text_hash(defect_where.body_of(view.get("body"))) != text_hash(defect_where.body_of(row.get("command_text"))):
1651
+ raise StaleTarget(SCA_CHANGED)
1652
+ return sca_expect(view, f.package_display_name)
1653
+
1654
+
1655
+ def _anchor_url(db: Database, row: dict) -> str:
1656
+ return _card_url_of(db, int(row["project_id"]), str(row.get("anchor_hub_id") or "")) or f"/projects/{row['project_id']}/defects"
1657
+
1658
+
1659
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/create")
1660
+ async def create_defect(request: Request, project_id: int, defect_id: int):
1661
+ """«Создать» из предпросмотра: `POST /defects` с телом заготовки и правками (заголовок, описание – текст команды в
1662
+ HTML и блок Hub, приоритет и серьёзность из формы); подтверждение – чтением (hub_defects)."""
1663
+ form = await request.form(max_fields=10, max_files=0)
1664
+ priority_name = str(form.get("priority") or "")
1665
+ severity_name = str(form.get("severity") or "")
1666
+ shown_create = str(form.get("create_snapshot") or "")
1667
+
1668
+ def apply():
1669
+ project, row = _project_row(request, project_id, defect_id)
1670
+ db, settings = db_of(request), settings_of(request)
1671
+ blocker = send_blocker(settings, project)
1672
+ if blocker:
1673
+ raise DefectRefused(blocker)
1674
+ if row["state"] != "preview":
1675
+ raise ValueError("Предпросмотра нет: дефект уже создаётся, создан или заготовка не получена.")
1676
+ from app.routes import defect_selected
1677
+ signature = hub_defects.creation_signature(row)
1678
+ if (shown_create or defect_selected.attempt(row)) and shown_create != signature:
1679
+ raise DefectRefused("Предпросмотр создания изменился: обновите карточку дефекта.")
1680
+ # POST уходит по приложению и адресу Hub предпросмотра (строка дефекта): их сменили после предпросмотра – отказ
1681
+ # здесь и ещё раз в транзакции постановки (KIMI-12)
1682
+ if not _same_hub(row, settings.hub_url, project.get("hub_app_id")):
1683
+ raise StaleTarget(PREVIEW_TARGET_CHANGED)
1684
+ hub_target = hub_target_check(request, project_id, str(row.get("hub_url") or ""), row.get("app_id"),
1685
+ PREVIEW_TARGET_CHANGED)
1686
+ # сохранённый текст команды, из которого собирается запрос, – по требованиям команды (ADR-0123 п. 5): отказ
1687
+ # до постановки и ещё раз в её транзакции (название команды – перечитанное в ней); у SCA ожидания – из того же
1688
+ # снимка набора, что и предпросмотр. Отказ советует «Отменить предпросмотр»: заготовка заново – только после него
1689
+ command_text = str(row.get("command_text") or "")
1690
+ expect = _sca_expect_at_create(request, project_id, row) if row["kind"] == "SCA" else None
1691
+ problems = text_problems(db, settings, project_id, row["kind"], command_text, expect)
1692
+ if problems:
1693
+ raise DefectRefused(defect_check.refusal(problems, at_create=True))
1694
+ text_ok = _text_check(request, db, settings, project_id, row["kind"], command_text, expect, at_create=True)
1695
+ blank = loads(row.get("blank_json"), {}) or {}
1696
+ service = hub_defects.service_info(db, row["hub_url"])
1697
+ try:
1698
+ priority = hub_defects.pick_level(service.get("priorities"), priority_name, blank.get("priority"))
1699
+ severity = hub_defects.pick_level(service.get("severities"), severity_name, blank.get("severity"))
1700
+ except ValueError as e:
1701
+ raise DefectRefused(str(e)) from None
1702
+ # описание – текст приложения и следом блок заготовки Hub как есть (dev30, требование команды:
1703
+ # сведения об объекте сканирования остаются; с dev6 по dev29 уходил только текст)
1704
+ description = hub_defects.description_html(str(row.get("command_text") or ""), hub_defects.blank_for_send(row).block)
1705
+ body = hub_defects.create_body(blank, int(row["app_id"] or 0), str(row["summary"]), description, priority,
1706
+ severity)
1707
+ def level_codes(c) -> dict: # соответствие уровня коду, данное Hub в прочитанных дефектах (ADR-0126 п. 6)
1708
+ return hub_defects.level_codes(loads(r["confirmed_object_json"], None) for r in c.execute(
1709
+ "SELECT hub_url, app_id, confirmed_object_json FROM hub_defects WHERE project_id=?"
1710
+ " AND confirmed_object_json != ''", (project_id,)) if _same_hub(dict(r), row["hub_url"], row.get("app_id")))
1711
+
1712
+ try:
1713
+ used_codes = hub_defects.fill_level_codes(body, db.on_connection(level_codes), blank)
1714
+ except ValueError as e:
1715
+ raise DefectRefused(str(e)) from None
1716
+ targets = loads(row.get("targets_json"), [])
1717
+ hub_defects.create_composition_check(body, targets)
1718
+ fresh_targets = _fresh_check(project_id, targets, row["kind"] == "SAST")
1719
+ group = (group_defect_check(db, project_id, str(row.get("anchor_hub_id") or ""),
1720
+ str(row.get("command_text") or ""), [t.get("hub_id") for t in targets],
1721
+ hub_url=row["hub_url"], app_id=row.get("app_id"), in_preview=True)
1722
+ if row["kind"] == "SAST" and not defect_selected.attempt(row) else None)
1723
+
1724
+ def check(c) -> None:
1725
+ current = dict(c.execute("SELECT * FROM hub_defects WHERE id=?", (row["id"],)).fetchone())
1726
+ if hub_defects.creation_signature(current) != signature:
1727
+ raise DefectRefused("Предпросмотр создания изменился: обновите карточку дефекта.")
1728
+ hub_defects.create_composition_check(body, loads(current["targets_json"], []))
1729
+ if hub_defects.level_codes_changed(used_codes, level_codes(c)):
1730
+ raise DefectRefused("Соответствие кодов приоритета и серьёзности в Hub изменилось: обновите карточку.")
1731
+ hub_target(c)
1732
+ fresh_targets(c)
1733
+ defect_selected.create_check(request, c, current)
1734
+ if group is not None: # сосед группы с тем же текстом попал в дефект после предпросмотра (ADR-0121 п. 5)
1735
+ group(c)
1736
+ # набор SCA: текст набора, исследование, состав – тот же снимок, по которому собран предпросмотр (находка 4)
1737
+ if row["kind"] == "SCA" and row.get("source_fingerprint") and db._sca_defect_fingerprint(
1738
+ c, project_id, str(row["anchor_hub_id"])) != row["source_fingerprint"]:
1739
+ raise StaleTarget(SCA_CHANGED)
1740
+ text_ok(c)
1741
+
1742
+ # проверка строки, постановка POST и переход в «создаётся» – одной транзакцией (находка 1): вторая вкладка
1743
+ # со старым предпросмотром второй POST не поставит
1744
+ fresh, _ = db.hub_defect_advance(
1745
+ int(row["id"]), expect_state="preview", check=check, op_field="create_op_id",
1746
+ item=dict(purpose="defect_create", request=hub_defects.create_request(body), hub_url=row["hub_url"],
1747
+ app_id=row.get("app_id"), project_id=project_id, targets=targets, text=str(row["summary"]),
1748
+ key_extra=f"defect-row:{int(row['id'])}"), # новая строка – новое действие (ADR-0121)
1749
+ state="creating", body_html=description, priority=hub_defects.level_name(priority),
1750
+ severity=hub_defects.level_name(severity), error="")
1751
+ if fresh is None:
1752
+ raise ValueError("Состояние дефекта изменилось в другой вкладке: обновите карточку.")
1753
+ return fresh
1754
+
1755
+ as_json = wants_json(request)
1756
+ try:
1757
+ row = await run_in_threadpool(apply)
1758
+ except HTTPException as e:
1759
+ return await _refused(request, as_json, str(e.detail), e.status_code)
1760
+ except hub_status.StatusRefused as e:
1761
+ if form.get("back") == "defect-card" and not as_json:
1762
+ from app.routes.defect_card_routes import page_context
1763
+ context = await run_in_threadpool(page_context, request, project_id, defect_id)
1764
+ context["error"] = str(e)
1765
+ return render(request, "projects/defect_card.html", context, status_code=400)
1766
+ return await _refused(request, as_json, str(e), 400)
1767
+ except LookupError as e:
1768
+ return await _refused(request, as_json, str(e), 404)
1769
+ except ValueError as e:
1770
+ return await _refused(request, as_json, str(e), 409)
1771
+ if not as_json:
1772
+ if form.get("back") == "defect-card":
1773
+ return redirect(_card_url(project_id, row["id"], form))
1774
+ url = await run_in_threadpool(lambda: _anchor_url(db_of(request), row))
1775
+ return redirect(url + "?ok=hub_defect_create_queued#hub-defect")
1776
+ return _answer(project_id, row, "Поставлено в очередь исполнителю: создание дефекта.")
1777
+
1778
+
1779
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/cancel")
1780
+ async def cancel_preview(request: Request, project_id: int, defect_id: int):
1781
+ """«Отменить предпросмотр»: заготовка больше не нужна (состав, текст или номер поменялись) – строка отменена, номер
1782
+ ID<n> освобождён, «Создать дефект в Hub» снова доступна. Только из предпросмотра: в Hub ничего не уходило."""
1783
+ form = await request.form(max_fields=2, max_files=0)
1784
+
1785
+ def apply():
1786
+ _, row = _project_row(request, project_id, defect_id)
1787
+ fresh = db_of(request).hub_defect_update(int(row["id"]), expect_state="preview", state="cancelled")
1788
+ if fresh is None:
1789
+ raise ValueError("Предпросмотра уже нет: дефект создаётся, создан или заготовка отменена – обновите "
1790
+ "карточку.")
1791
+ return fresh
1792
+
1793
+ as_json = wants_json(request)
1794
+ try:
1795
+ row = await run_in_threadpool(apply)
1796
+ except HTTPException as e:
1797
+ return await _refused(request, as_json, str(e.detail), e.status_code)
1798
+ except LookupError as e:
1799
+ return await _refused(request, as_json, str(e), 404)
1800
+ except ValueError as e:
1801
+ return await _refused(request, as_json, str(e), 409)
1802
+ if not as_json:
1803
+ if form.get("back") == "defect-card":
1804
+ return redirect(_card_url(project_id, row["id"], form))
1805
+ url = await run_in_threadpool(lambda: _anchor_url(db_of(request), row))
1806
+ return redirect(url + "?ok=hub_defect_cancelled#hub-defect")
1807
+ return {"ok": True, "defect_id": row["id"], "done": True, "reload": True,
1808
+ "message": "Предпросмотр отменён: заготовку можно запросить заново."}
1809
+
1810
+
1811
+ @router.get("/projects/{project_id}/hub/defects/{defect_id}")
1812
+ def defect_state(request: Request, project_id: int, defect_id: int):
1813
+ """Состояние дефекта для опроса из карточки (раз в 2 с); конечное состояние – перезагрузка карточки (предпросмотр,
1814
+ итог, отметка)."""
1815
+ try:
1816
+ _, row = _project_row(request, project_id, defect_id)
1817
+ except HTTPException as e:
1818
+ return _json_error(str(e.detail), e.status_code)
1819
+ except LookupError as e:
1820
+ return _json_error(str(e), 404)
1821
+ view = hub_defects.view(row)
1822
+ return _answer(project_id, row, reload=view["final"])
1823
+
1824
+
1825
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/verify")
1826
+ async def verify_defect(request: Request, project_id: int, defect_id: int):
1827
+ """«Сверить»: у дефекта с известным номером – чтение `GET /defects/{id}` снова; без номера – постранично
1828
+ `GET /defects?appId` → кандидаты с тем же заголовком и автором → чтение каждого → совпадение находок и текста."""
1829
+ from app.routes.hub import worker_summary
1830
+ form = await request.form(max_fields=5, max_files=0)
1831
+
1832
+ def apply():
1833
+ _, row = _project_row(request, project_id, defect_id)
1834
+ db = db_of(request)
1835
+ if row["state"] not in ("unknown", "unconfirmed") and not hub_defects.link_rereadable(row):
1836
+ raise DefectRefused("Сверка нужна только при результате «неизвестен» или неподтверждённом содержимом.")
1837
+ if row.get("hub_defect_id"):
1838
+ fresh = hub_defects.restart_read(db, row) # отказ очереди – ValueError с её причиной
1839
+ if fresh is None:
1840
+ raise ValueError("Состояние дефекта изменилось: обновите карточку.")
1841
+ return fresh
1842
+ login = str(worker_summary(request).get("hub_login") or "")
1843
+ hub_defects.start_verify(db, row, login) # идущая сверка или отказ очереди – ValueError с причиной
1844
+ return db.hub_defect(int(row["id"])) or row
1845
+
1846
+ as_json = wants_json(request)
1847
+ try:
1848
+ row = await run_in_threadpool(apply)
1849
+ except HTTPException as e:
1850
+ return await _refused(request, as_json, str(e.detail), e.status_code)
1851
+ except hub_status.StatusRefused as e:
1852
+ return await _refused(request, as_json, str(e), 400)
1853
+ except LookupError as e:
1854
+ return await _refused(request, as_json, str(e), 404)
1855
+ except ValueError as e:
1856
+ return await _refused(request, as_json, str(e), 409)
1857
+ if not as_json:
1858
+ if form.get("back") == "defect-card":
1859
+ owner_id = row.get("draft_owner_id") or row["id"]
1860
+ return redirect(_card_url(project_id, owner_id, form, ok="hub_defect_verify_queued"))
1861
+ url = await run_in_threadpool(lambda: _anchor_url(db_of(request), row))
1862
+ return redirect(url + "?ok=hub_defect_verify_queued#hub-defect")
1863
+ return _answer(project_id, row, "Сверка поставлена в очередь исполнителю.")
1864
+
1865
+
1866
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/recheck")
1867
+ async def recheck_defect(request: Request, project_id: int, defect_id: int):
1868
+ """«Проверить в Hub» у созданного дефекта (ADR-0121 п. 6): чтение `GET /defects/{id}` – только сверка, итог –
1869
+ пояснением в строке (404 – «дефект в Hub не найден», состав linkedIssues – о находках, которых в нём нет); состояние
1870
+ строки и находки не меняются, снятие привязки – следующая сборка (бэклог 39). Ручного «отвязать» нет: связь живёт
1871
+ в Hub. Поле back=defects – ответ без скрипта во вкладку «Дефекты»."""
1872
+ form = await request.form(max_fields=5, max_files=0)
1873
+ to_tab = str(form.get("back") or "") == "defects"
1874
+
1875
+ def apply():
1876
+ project, row = _project_row(request, project_id, defect_id)
1877
+ blocker = send_blocker(settings_of(request), project)
1878
+ if blocker:
1879
+ raise DefectRefused(blocker)
1880
+ return hub_defects.start_recheck(db_of(request), row) # не «создан», идущая проверка, очередь – ValueError
1881
+
1882
+ as_json = wants_json(request)
1883
+ try:
1884
+ row = await run_in_threadpool(apply)
1885
+ except HTTPException as e:
1886
+ return await _refused(request, as_json, str(e.detail), e.status_code)
1887
+ except hub_status.StatusRefused as e:
1888
+ return await _refused(request, as_json, str(e), 400)
1889
+ except LookupError as e:
1890
+ return await _refused(request, as_json, str(e), 404)
1891
+ except ValueError as e:
1892
+ return await _refused(request, as_json, str(e), 409)
1893
+ if not as_json:
1894
+ if to_tab:
1895
+ return redirect(f"/projects/{project_id}/defects?ok=hub_defect_recheck_queued")
1896
+ url = await run_in_threadpool(lambda: _anchor_url(db_of(request), row))
1897
+ return redirect(url + "?ok=hub_defect_recheck_queued#hub-defect")
1898
+ return _answer(project_id, row, "Проверка поставлена в очередь исполнителю: чтение дефекта из Hub.")
1899
+
1900
+
1901
+ @router.post("/projects/{project_id}/hub/defects/{defect_id}/template-model")
1902
+ async def template_model_read(request: Request, project_id: int, defect_id: int):
1903
+ """Явно подтверждённый сбор ответа для уточнения контракта, без подготовки Push."""
1904
+ from app import hub_template_model
1905
+ form = await request.form(max_fields=3, max_files=0)
1906
+ if form.get("confirm") != "1":
1907
+ raise HTTPException(400, "Подтвердите чтение модели шаблона Hub.")
1908
+ issue_id = str(form.get("issue_id") or "")
1909
+
1910
+ def apply():
1911
+ project, row = _template_model_row(request, project_id, defect_id)
1912
+ settings = settings_of(request)
1913
+ blocker = send_blocker(settings, project)
1914
+ if blocker:
1915
+ raise HTTPException(400, blocker)
1916
+ if not _same_hub(row, settings.hub_url, project.get("hub_app_id")):
1917
+ raise HTTPException(409, UPDATE_TARGET_CHANGED)
1918
+ try:
1919
+ op = hub_template_model.enqueue(db_of(request), row, issue_id,
1920
+ _update_target(request, project_id, row))
1921
+ except ValueError as exc:
1922
+ raise HTTPException(409, str(exc)) from exc
1923
+ return {"ok": True, "op_id": op["id"], "state": op["state"]}
1924
+
1925
+ return await run_in_threadpool(apply)
1926
+
1927
+
1928
+ @router.get("/projects/{project_id}/hub/defects/{defect_id}/template-model/{op_id}")
1929
+ def template_model_result(request: Request, project_id: int, defect_id: int, op_id: int):
1930
+ """Транспортный ответ из PostgreSQL; GET не ставит запросов в Hub."""
1931
+ from app import hub_template_model
1932
+ _, row = _template_model_row(request, project_id, defect_id)
1933
+ try:
1934
+ return hub_template_model.saved(db_of(request), row, op_id)
1935
+ except ValueError as exc:
1936
+ raise HTTPException(404, str(exc)) from exc
1937
+
1938
+
1939
+ def _template_model_row(request: Request, project_id: int, defect_id: int) -> tuple[dict, dict]:
1940
+ # Чтение результата не продвигает цепочки Push и не ставит следующие операции.
1941
+ project = project_or_404(request, project_id)
1942
+ row = db_of(request).hub_defect(defect_id)
1943
+ if row is None or row["project_id"] != project_id:
1944
+ raise HTTPException(404, "Дефект не найден.")
1945
+ return project, row