@openai/codex-security 0.8.2 → 0.9.1

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 (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -5,6 +5,7 @@ from __future__ import annotations
5
5
  import copy
6
6
  import hashlib
7
7
  import json
8
+ from collections.abc import Iterator
8
9
  from pathlib import Path
9
10
  from typing import Any
10
11
 
@@ -95,16 +96,18 @@ def _coverage_comparison_row(row: Any, field: str) -> Any:
95
96
  return row
96
97
 
97
98
 
98
- def _aggregate_worker_coverage_rows(rows: list[Any], worker_id: str, field: str) -> list[Any]:
99
+ def _worker_coverage_sources(
100
+ rows: list[Any], worker_id: str, field: str
101
+ ) -> Iterator[tuple[Any, Any]]:
99
102
  """Match accepted aggregate IDs without changing raw recovery identities."""
100
103
  reserved = {
101
104
  row["id"] for row in rows if isinstance(row, dict) and isinstance(row.get("id"), str)
102
105
  }
103
106
  emitted: set[str] = set()
104
- projected = []
105
107
  for index, original in enumerate(rows):
106
- row = copy.deepcopy(original)
108
+ row = original
107
109
  if isinstance(row, dict) and field != "openQuestions":
110
+ row = row.copy()
108
111
  generated = not isinstance(row.get("id"), str)
109
112
  identity = str(index) if generated else row["id"]
110
113
  base = identity
@@ -116,23 +119,28 @@ def _aggregate_worker_coverage_rows(rows: list[Any], worker_id: str, field: str)
116
119
  reserved.add(identity)
117
120
  emitted.add(identity)
118
121
  row["id"] = identity
119
- projected.append(
120
- _coverage_comparison_row(_project_worker_coverage_row(row, worker_id, field), field)
121
- )
122
- return projected
122
+ qualified = _project_worker_coverage_row(row, worker_id, field)
123
+ yield _coverage_comparison_row(qualified, field), original
124
+
123
125
 
126
+ _Row = dict[str, Any]
127
+ _LegacySurfaceLink = tuple[_Row, str, _Row, _Row, _Row | None]
124
128
 
125
- def _prepare_worker_coverage_recovery(
129
+
130
+ def prepare_saved_coverage_projection(
126
131
  sources: list[tuple[str, dict[str, Any], str | None]],
127
132
  parent: dict[str, Any] | None,
128
133
  source_order: dict[str, tuple[int, int]],
129
134
  *,
130
- enabled: bool,
131
- receipt_resolver=None,
132
- ) -> tuple[
133
- bool, list[tuple[dict[str, Any], str, dict[str, Any], dict[str, Any], dict[str, Any] | None]]
134
- ]:
135
+ project_worker_coverage: bool,
136
+ receipt_resolver,
137
+ preserve_canonical_parent=False,
138
+ ) -> tuple[bool, list[_LegacySurfaceLink]]:
135
139
  """Put bound worker evidence in parent coordinates without changing source files."""
140
+ if preserve_canonical_parent:
141
+ return False, []
142
+ # Older parent publications use worker/id identities. Reconcile those copies
143
+ # against their bound sources before projecting accepted attempt provenance.
136
144
  workers = {owner for _, _, owner in sources if owner is not None}
137
145
  parents = [
138
146
  draft
@@ -145,8 +153,8 @@ def _prepare_worker_coverage_recovery(
145
153
  # Prefer the selected parent over historical copies of a task's surface.
146
154
  parents.insert(0, parent)
147
155
  fields = ("surfaces", "explicitExclusions", "deferred", "openQuestions")
148
- if not enabled:
149
- enabled = any(
156
+ if not project_worker_coverage:
157
+ project_worker_coverage = any(
150
158
  isinstance(row, dict)
151
159
  and isinstance(row.get("workerId"), str)
152
160
  and row["workerId"] in workers
@@ -156,135 +164,105 @@ def _prepare_worker_coverage_recovery(
156
164
  )
157
165
  for draft in parents
158
166
  for field in fields
159
- for row in (
160
- draft["reviewState"].get(field, [])
161
- if isinstance(draft["reviewState"].get(field, []), list)
162
- else []
163
- )
167
+ for row in _coverage_rows(draft["reviewState"], field)
164
168
  )
165
- if not enabled:
169
+ if not project_worker_coverage:
166
170
  return False, []
167
- projected: dict[str, list[Any]] = {field: [] for field in fields}
168
- surface_sources: list[tuple[dict[str, Any], dict[str, Any]]] = []
169
- task_sources: list[tuple[dict[str, Any], dict[str, Any]]] = []
170
- surface_links: list[
171
- tuple[dict[str, Any], str, dict[str, Any], dict[str, Any], dict[str, Any] | None]
172
- ] = []
171
+ missing = object()
172
+ original_owners = {}
173
+ projected: dict[str, list[tuple[Any, Any]]] = {field: [] for field in fields}
174
+ surface_links: list[_LegacySurfaceLink] = []
173
175
  for relative, draft, owner in sources:
174
176
  if owner is None:
175
177
  continue
176
- directory = Path(relative).parent
177
- if directory.name == "checkpoints":
178
- directory = directory.parent
179
178
  for field in fields:
180
- rows = draft["reviewState"].get(field, [])
181
- if not isinstance(rows, list):
182
- continue
179
+ rows = _coverage_rows(draft["reviewState"], field)
183
180
  for index, row in enumerate(rows):
184
181
  if field == "openQuestions" and isinstance(row, str):
185
182
  row = {"question": row}
186
183
  rows[index] = row
187
184
  if not isinstance(row, dict):
188
185
  continue
186
+ original_owners.setdefault(id(row), row.get("workerId", missing))
189
187
  row["workerId"] = owner
190
- if field == "surfaces" and receipt_resolver is not None:
191
- row["receiptRefs"] = receipt_resolver(relative, row, owner)
192
- elif field == "surfaces" and isinstance(row.get("receiptRefs"), list):
193
- refs = []
194
- for ref in row["receiptRefs"]:
195
- if isinstance(ref, str):
196
- try:
197
- normalized = _require_portable_relative_path(
198
- ref, "Worker coverage receipt"
199
- )
200
- except ContractError:
201
- pass # Leave malformed refs to the existing per-record recovery.
202
- else:
203
- if normalized.startswith("artifacts/"):
204
- ref = f"{directory.as_posix()}/{normalized}"
205
- refs.append(ref)
206
- row["receiptRefs"] = refs
207
188
  if field == "surfaces":
208
- row.setdefault("receiptRefs", [])
209
- aggregate_rows = _aggregate_worker_coverage_rows(rows, owner, field)
210
- projected[field].extend(aggregate_rows)
211
- if field in {"surfaces", "deferred"}:
212
- originals = surface_sources if field == "surfaces" else task_sources
213
- originals.extend(
214
- (aggregate, row)
215
- for aggregate, row in zip(aggregate_rows, rows)
216
- if isinstance(aggregate, dict) and isinstance(row, dict)
217
- )
189
+ row["receiptRefs"] = receipt_resolver(relative, row, owner)
190
+ projected[field].extend(_worker_coverage_sources(rows, owner, field))
191
+
192
+ def originals(field: str, row: Any):
193
+ comparison = _coverage_comparison_row(row, field)
194
+ return (
195
+ original
196
+ for aggregate, original in projected[field]
197
+ if aggregate is comparison or aggregate == comparison
198
+ )
199
+
218
200
  # A canonical aggregate contains copies of the same worker evidence. Let
219
201
  # the existing per-worker chronology reconcile those originals exactly once.
220
202
  # Keep parent-only evidence when its bound worker source is unavailable.
221
203
  for draft in parents:
222
- if not draft["reviewState"]:
204
+ review = draft["reviewState"]
205
+ if not review:
223
206
  continue
224
207
  for field in fields:
225
- rows = draft["reviewState"].get(field, [])
226
- if isinstance(rows, list):
227
- if field == "surfaces":
228
- tasks = draft["reviewState"].get("deferred", [])
229
- for row in rows:
230
- if not isinstance(row, dict) or not isinstance(row.get("id"), str):
231
- continue
232
- matching_sources = [
233
- original
234
- for aggregate, original in surface_sources
235
- if aggregate == _coverage_comparison_row(row, field)
236
- ]
237
- if not matching_sources:
238
- continue
239
- for task in tasks if isinstance(tasks, list) else []:
240
- if (
241
- isinstance(task, dict)
242
- and isinstance(task.get("surfaceIds"), list)
243
- and row["id"] in task["surfaceIds"]
244
- ):
245
- surface_links.extend(
246
- (
247
- task,
248
- row["id"],
249
- source,
250
- row,
251
- next(
252
- (
253
- original
254
- for aggregate, original in task_sources
255
- if aggregate == task
256
- ),
257
- None,
258
- ),
259
- )
260
- for source in matching_sources
261
- )
262
- draft["reviewState"][field] = [
263
- row
264
- for row in rows
265
- if _coverage_comparison_row(row, field) not in projected[field]
266
- ]
208
+ rows = review.get(field, [])
209
+ if not isinstance(rows, list):
210
+ continue
211
+ remaining = []
212
+ for row in rows:
213
+ matches = originals(field, row)
214
+ first = next(matches, missing)
215
+ if first is missing:
216
+ remaining.append(row)
217
+ continue
218
+ if (
219
+ field != "surfaces"
220
+ or not isinstance(row, dict)
221
+ or not isinstance(row.get("id"), str)
222
+ ):
223
+ continue
224
+ surface_sources = [first, *matches]
225
+ for task in _coverage_rows(review, "deferred"):
226
+ if (
227
+ isinstance(task, dict)
228
+ and isinstance(task.get("surfaceIds"), list)
229
+ and row["id"] in task["surfaceIds"]
230
+ ):
231
+ source_task = next(originals("deferred", task), None)
232
+ surface_links.extend(
233
+ (task, row["id"], source, row, source_task)
234
+ for source in surface_sources
235
+ )
236
+ review[field] = remaining
237
+ # A selected parent may also be the result registered for a worker.
238
+ # Restore the retained input rows after comparing the published worker IDs.
239
+ for _, draft, owner in sources:
240
+ if owner is not None:
241
+ for field in fields:
242
+ for row in _coverage_rows(draft["reviewState"], field):
243
+ if isinstance(row, dict):
244
+ previous = original_owners[id(row)]
245
+ if previous is missing:
246
+ row.pop("workerId", None)
247
+ else:
248
+ row["workerId"] = previous
267
249
  return True, surface_links
268
250
 
269
251
 
270
252
  class SavedCoverageProjection:
271
- """Keep worker source links stable while legacy and accepted rows converge."""
253
+ """Track which worker supplied a coverage row so reconstructed links can resolve to the retained surface."""
272
254
 
273
- def __init__(self, project_worker_coverage, legacy_surface_links, sources):
255
+ def __init__(self, project_worker_coverage, legacy_surface_links, projection_origins):
274
256
  self.project_worker_coverage = project_worker_coverage
275
257
  self.legacy_surface_links = legacy_surface_links
276
258
  self.legacy_source_outputs: dict[int, dict[str, Any]] = {}
277
259
  self.worker_row_owners: dict[int, str] = {}
278
260
  self.worker_surface_outputs: dict[tuple[str, str], dict[int, dict[str, Any]]] = {}
279
- self.source_owner_by_id = {
280
- id(row): owner
281
- for _, draft, owner in sources
282
- for field in ("surfaces", "deferred")
283
- for rows in (draft["reviewState"].get(field, []),)
284
- if isinstance(rows, list)
285
- for row in rows
286
- if isinstance(row, dict)
287
- }
261
+ self.projection_origins = projection_origins
262
+
263
+ def source_owner(self, row, fallback=None):
264
+ origin = self.projection_origins.get(id(row))
265
+ return origin[0] if origin is not None else fallback
288
266
 
289
267
  def record_coverage_owner(self, retained, original, owner, field):
290
268
  if self.project_worker_coverage and owner is not None and isinstance(retained, dict):
@@ -315,8 +293,7 @@ class SavedCoverageProjection:
315
293
  if field == "surfaces":
316
294
  # Canonical IDs can change while source content and ownership stay the same.
317
295
  item = {key: value for key, value in item.items() if key != "id"}
318
- records = coverage.get(field, [])
319
- for record in records if isinstance(records, list) else []:
296
+ for record in _coverage_rows(coverage, field):
320
297
  if not isinstance(record, dict):
321
298
  continue
322
299
  original = dict(canonical_record(field, record))
@@ -335,8 +312,8 @@ class SavedCoverageProjection:
335
312
  return None
336
313
 
337
314
  def linked_surface(self, surface, outputs, named_outputs):
315
+ owner = self.source_owner(surface, surface.get("workerId"))
338
316
  retained = outputs.get(id(surface))
339
- owner = self.source_owner_by_id.get(id(surface), surface.get("workerId"))
340
317
  if retained is None and isinstance(owner, str) and isinstance(surface.get("id"), str):
341
318
  matches = named_outputs.get((owner, surface["id"]), {})
342
319
  if len(matches) == 1:
@@ -351,12 +328,11 @@ class SavedCoverageProjection:
351
328
  or worker["merge_state"] != "merged"
352
329
  ):
353
330
  return False
354
- reviews = canonical.get("reviews", [])
355
331
  return any(
356
332
  isinstance(review, dict)
357
333
  and review.get("workerId") == worker["id"]
358
334
  and review.get("attempt") == worker["attempt"]
359
- for review in (reviews if isinstance(reviews, list) else [])
335
+ for review in _coverage_rows(canonical, "reviews")
360
336
  )
361
337
 
362
338
  def repair_reviewed_surface(self, coverage, canonical, worker, source, surface):
@@ -395,32 +371,29 @@ class SavedCoverageProjection:
395
371
  coverage["surfaces"], retained, worker["id"], "surfaces", source, True
396
372
  )
397
373
 
398
- def linked_tasks(self, task, published_id, source_task, candidates):
399
- expected = None
400
- if source_task is not None:
401
- expected = self.legacy_source_outputs.get(id(source_task))
402
- if expected is None:
403
- expected = _project_worker_coverage_row(
404
- source_task, self.source_owner_by_id.get(id(source_task)), "deferred"
405
- )
406
- return [
407
- retained
408
- for owner, retained in candidates
409
- if retained == task
410
- or (
411
- expected is not None
412
- and (
413
- retained is expected
414
- or (
415
- owner == self.source_owner_by_id.get(id(source_task))
416
- and isinstance(retained, dict)
417
- and retained.get("id") == expected.get("id")
418
- and isinstance(retained.get("surfaceIds"), list)
419
- and published_id in retained["surfaceIds"]
374
+ def task_surface_links(self, candidates):
375
+ for task, published_id, surface, parent_surface, task_source in self.legacy_surface_links:
376
+ expected = None
377
+ if task_source is not None:
378
+ task_owner = self.source_owner(task_source)
379
+ expected = self.legacy_source_outputs.get(id(task_source))
380
+ if expected is None:
381
+ expected = _project_worker_coverage_row(task_source, task_owner, "deferred")
382
+ for owner, retained in candidates:
383
+ if retained == task or (
384
+ expected is not None
385
+ and (
386
+ retained is expected
387
+ or (
388
+ owner == task_owner
389
+ and isinstance(retained, dict)
390
+ and retained.get("id") == expected.get("id")
391
+ and isinstance(retained.get("surfaceIds"), list)
392
+ and published_id in retained["surfaceIds"]
393
+ )
420
394
  )
421
- )
422
- )
423
- ]
395
+ ):
396
+ yield retained, published_id, surface, parent_surface
424
397
 
425
398
  def finalize(
426
399
  self,
@@ -471,52 +444,39 @@ class SavedCoverageProjection:
471
444
  retained_legacy_surface_links: dict[
472
445
  int, tuple[dict[str, Any], dict[str, dict[str, Any]]]
473
446
  ] = {}
474
- output_tasks = coverage.get("deferred", [])
475
- task_candidates = [
476
- (self.worker_row_owners.get(id(row)), row)
477
- for row in (output_tasks if isinstance(output_tasks, list) else [])
478
- ]
479
- for task, published_id, surface, _, task_source in self.legacy_surface_links:
447
+ output_tasks = _coverage_rows(coverage, "deferred")
448
+ task_candidates = [(self.worker_row_owners.get(id(row)), row) for row in output_tasks]
449
+ for task, published_id, surface, _ in self.task_surface_links(task_candidates):
480
450
  retained_surface = self.linked_surface(
481
- surface, self.legacy_source_outputs, self.worker_surface_outputs
451
+ surface,
452
+ self.legacy_source_outputs,
453
+ self.worker_surface_outputs,
482
454
  )
483
- if retained_surface is None or not isinstance(retained_surface.get("id"), str):
484
- continue
485
- for retained_task in self.linked_tasks(
486
- task, published_id, task_source, task_candidates
487
- ):
488
- _, links = retained_legacy_surface_links.setdefault(
489
- id(retained_task), (retained_task, {})
490
- )
455
+ if retained_surface is not None and isinstance(retained_surface.get("id"), str):
456
+ _, links = retained_legacy_surface_links.setdefault(id(task), (task, {}))
491
457
  links.setdefault(published_id, retained_surface)
492
458
  # A newer worker checkpoint may omit a surface still needed by a retained
493
459
  # task. Restore its parent copy only when no worker replacement survived.
494
- for task, published_id, surface, parent_surface, task_source in self.legacy_surface_links:
495
- for retained_task in self.linked_tasks(
496
- task, published_id, task_source, task_candidates
497
- ):
498
- _, links = retained_legacy_surface_links.setdefault(
499
- id(retained_task), (retained_task, {})
460
+ for task, published_id, surface, parent_surface in self.task_surface_links(task_candidates):
461
+ _, links = retained_legacy_surface_links.setdefault(id(task), (task, {}))
462
+ if published_id not in links and isinstance(coverage.get("surfaces"), list):
463
+ retained_surface = self.retain_coverage_row(
464
+ coverage["surfaces"], parent_surface, None, "surfaces"
500
465
  )
501
- if published_id not in links and isinstance(coverage.get("surfaces"), list):
502
- retained_surface = self.retain_coverage_row(
503
- coverage["surfaces"], parent_surface, None, "surfaces"
504
- )
505
- self.record_coverage_owner(
506
- retained_surface,
507
- surface,
508
- self.source_owner_by_id.get(id(surface), surface.get("workerId")),
509
- "surfaces",
510
- )
511
- _inherit_coverage_sources(retained_surface, [parent_surface], coverage_sources)
512
- links[published_id] = retained_surface
466
+ self.record_coverage_owner(
467
+ retained_surface,
468
+ surface,
469
+ self.source_owner(surface, surface.get("workerId")),
470
+ "surfaces",
471
+ )
472
+ _inherit_coverage_sources(retained_surface, [parent_surface], coverage_sources)
473
+ links[published_id] = retained_surface
513
474
  if self.project_worker_coverage:
514
475
  worker_surfaces: dict[tuple[str, str], dict[str, Any]] = {}
515
476
  named_surface_outputs = {
516
477
  identity for outputs in self.worker_surface_outputs.values() for identity in outputs
517
478
  }
518
- surfaces = coverage.get("surfaces", [])
519
- for surface in surfaces if isinstance(surfaces, list) else []:
479
+ for surface in _coverage_rows(coverage, "surfaces"):
520
480
  if not isinstance(surface, dict):
521
481
  continue
522
482
  owner, identity = self.worker_row_owners.get(id(surface)), surface.get("id")
@@ -530,7 +490,7 @@ class SavedCoverageProjection:
530
490
  and id(existing) not in named_surface_outputs
531
491
  ):
532
492
  worker_surfaces[key] = surface
533
- for task in output_tasks if isinstance(output_tasks, list) else []:
493
+ for task in output_tasks:
534
494
  if (
535
495
  not isinstance(task, dict)
536
496
  or (owner := self.worker_row_owners.get(id(task))) is None
@@ -644,8 +604,7 @@ class SavedCoverageProjection:
644
604
  # tasks. Preserve their original links, even when the outcome changes ID
645
605
  # or a distinct retained surface shares the old source-local ID.
646
606
  for relative, draft, owner in all_sources:
647
- originals = draft["reviewState"].get("surfaces", [])
648
- for original in originals if isinstance(originals, list) else []:
607
+ for original in _coverage_rows(draft["reviewState"], "surfaces"):
649
608
  if (
650
609
  not isinstance(original, dict)
651
610
  or id(original) in retained_surface_rows
@@ -686,8 +645,7 @@ class SavedCoverageProjection:
686
645
  prospective_surfaces = {}
687
646
  prospective_named = {}
688
647
  for relative, draft, owner in all_sources:
689
- rows = draft["reviewState"].get("surfaces", [])
690
- for row in rows if isinstance(rows, list) else []:
648
+ for row in _coverage_rows(draft["reviewState"], "surfaces"):
691
649
  if owner is None or not isinstance(row, dict):
692
650
  continue
693
651
  emitted = surface_is_retained(relative, owner, row)
@@ -711,73 +669,19 @@ class SavedCoverageProjection:
711
669
  prospective_surfaces[id(row)] = projected
712
670
  bound = {
713
671
  (id(retained), published_id)
714
- for task, published_id, surface, _, task_source in self.legacy_surface_links
672
+ for retained, published_id, surface, _ in self.task_surface_links(prospective_tasks)
715
673
  if self.linked_surface(surface, prospective_surfaces, prospective_named) is not None
716
- for retained in self.linked_tasks(
717
- task, published_id, task_source, prospective_tasks
718
- )
719
674
  }
720
- for task, published_id, _, parent_surface, task_source in self.legacy_surface_links:
721
- for retained in self.linked_tasks(
722
- task, published_id, task_source, prospective_tasks
723
- ):
724
- key = (id(retained), published_id)
725
- if key not in bound:
726
- fallback_surfaces.append(parent_surface)
727
- bound.add(key)
675
+ for retained, published_id, _, parent_surface in self.task_surface_links(
676
+ prospective_tasks
677
+ ):
678
+ key = (id(retained), published_id)
679
+ if key not in bound:
680
+ fallback_surfaces.append(parent_surface)
681
+ bound.add(key)
728
682
  return fallback_surfaces
729
683
 
730
684
 
731
- def prepare_saved_coverage_projection(
732
- sources,
733
- parent,
734
- source_order,
735
- *,
736
- project_worker_coverage,
737
- receipt_resolver,
738
- preserve_canonical_parent=False,
739
- ):
740
- if preserve_canonical_parent:
741
- return SavedCoverageProjection(False, [], sources)
742
- # Older parent publications use worker/id identities. Reconcile those copies
743
- # against their bound sources before projecting accepted attempt provenance.
744
- projected_metadata = {
745
- id(row): ("workerId" in row, row.get("workerId"))
746
- for relative, draft, _ in sources
747
- for field in ("surfaces", "explicitExclusions", "deferred", "openQuestions")
748
- for rows in (draft["reviewState"].get(field, []),)
749
- if isinstance(rows, list)
750
- for row in rows
751
- if isinstance(row, dict)
752
- }
753
- project_worker_coverage, legacy_surface_links = _prepare_worker_coverage_recovery(
754
- sources,
755
- parent,
756
- source_order,
757
- enabled=project_worker_coverage,
758
- receipt_resolver=receipt_resolver,
759
- )
760
- for _, draft, _ in sources:
761
- for field in ("surfaces", "explicitExclusions", "deferred", "openQuestions"):
762
- rows = draft["reviewState"].get(field, [])
763
- if not isinstance(rows, list):
764
- continue
765
- for row in rows:
766
- if not isinstance(row, dict):
767
- continue
768
- present, value = projected_metadata.get(id(row), (False, None))
769
- if present:
770
- row["workerId"] = value
771
- else:
772
- row.pop("workerId", None)
773
- return SavedCoverageProjection(project_worker_coverage, legacy_surface_links, sources)
774
-
775
-
776
- def _deferred_rows(coverage: dict[str, Any]) -> list[Any]:
777
- rows = coverage.get("deferred", [])
778
- return rows if isinstance(rows, list) else []
779
-
780
-
781
685
  def _resolved_deferred_rows(draft: dict[str, Any], schema: dict[str, Any]) -> list[dict[str, Any]]:
782
686
  if draft.get("complete") is False:
783
687
  return []
@@ -786,7 +690,7 @@ def _resolved_deferred_rows(draft: dict[str, Any], schema: dict[str, Any]) -> li
786
690
  try:
787
691
  # Invalid closure metadata cannot discard the evidence it names.
788
692
  _validate_schema_node(rows, schema, "coverage.resolvedDeferred")
789
- _validate_resolved_deferred({**coverage, "deferred": _deferred_rows(coverage)})
693
+ _validate_resolved_deferred({**coverage, "deferred": _coverage_rows(coverage, "deferred")})
790
694
  except ContractError:
791
695
  return []
792
696
  return rows
@@ -855,7 +759,7 @@ def _merge_tied_parent_observations(
855
759
  output.append(copy.deepcopy(row))
856
760
  pending_ids = {
857
761
  identity
858
- for row in _deferred_rows(coverage)
762
+ for row in _coverage_rows(coverage, "deferred")
859
763
  if isinstance(row, dict)
860
764
  for identity in (row.get("id"), row.get("candidateId"))
861
765
  if isinstance(identity, str)
@@ -26,6 +26,11 @@ _PUBLISHED_OUTPUTS = (
26
26
  def _snapshot_published_outputs(
27
27
  scan_dir: Path, relative_paths: tuple[str, ...] = _PUBLISHED_OUTPUTS
28
28
  ) -> dict[str, tuple[bytes, os.stat_result] | None]:
29
+ """Capture each artifact's bytes and stat metadata before publication.
30
+
31
+ A None entry records an absent artifact. An unsafe optional threatmodel.md is
32
+ omitted so rollback leaves it alone. Other unreadable existing outputs raise ContractError.
33
+ """
29
34
  snapshots: dict[str, tuple[bytes, os.stat_result] | None] = {}
30
35
  for relative in relative_paths:
31
36
  descriptor = -1
@@ -56,6 +61,10 @@ def _restore_published_outputs(
56
61
  snapshots: dict[str, tuple[bytes, os.stat_result] | None],
57
62
  created_paths: set[str] | None = None,
58
63
  ) -> None:
64
+ """Restore the captured bytes and timestamps after a publication failure.
65
+
66
+ Remove outputs that were originally absent and paths journaled as newly created by the caller.
67
+ """
59
68
  for relative, snapshot in snapshots.items():
60
69
  if snapshot is None:
61
70
  path = scan_dir / relative