@openai/codex-security 0.2.0 → 0.4.0

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 (484) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  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/permission-profile-preflight.mjs +556 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +11 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +43 -170
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +159 -567
  40. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  41. package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
  42. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  43. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  44. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  45. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  46. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  47. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  48. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  49. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  50. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  51. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  52. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
  54. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  56. package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  60. package/_bundled_plugin/scripts/report_projection.py +150 -183
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +102 -184
  70. package/_bundled_plugin/scripts/workbench_db.py +463 -464
  71. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  74. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  75. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  76. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  77. package/_bundled_plugin/scripts/workbench_publication.py +234 -289
  78. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  79. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  80. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  81. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  82. package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
  83. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  85. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  86. package/_bundled_plugin/scripts/workbench_validation.py +31 -28
  87. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  88. package/_bundled_plugin/shared/workbench-migrations.json +414 -0
  89. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  90. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  92. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  93. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  98. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  99. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
  100. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  101. package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
  102. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  103. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  104. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  105. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  106. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  107. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  108. package/bin/codex-security.mjs +9 -2
  109. package/dist/api.d.ts +63 -10
  110. package/dist/api.d.ts.map +1 -1
  111. package/dist/api.js +1015 -383
  112. package/dist/api.js.map +1 -1
  113. package/dist/artifact-export.d.ts +1 -1
  114. package/dist/artifact-export.d.ts.map +1 -1
  115. package/dist/artifact-export.js +28 -13
  116. package/dist/artifact-export.js.map +1 -1
  117. package/dist/auth.d.ts +2 -6
  118. package/dist/auth.d.ts.map +1 -1
  119. package/dist/auth.js +19 -9
  120. package/dist/auth.js.map +1 -1
  121. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  122. package/dist/bulk-scan-discovery.js +1 -0
  123. package/dist/bulk-scan-discovery.js.map +1 -1
  124. package/dist/classify-severity.d.ts +26 -9
  125. package/dist/classify-severity.d.ts.map +1 -1
  126. package/dist/classify-severity.js +13 -30
  127. package/dist/classify-severity.js.map +1 -1
  128. package/dist/cli-help.d.ts.map +1 -1
  129. package/dist/cli-help.js +17 -13
  130. package/dist/cli-help.js.map +1 -1
  131. package/dist/cli-signals.d.ts +8 -0
  132. package/dist/cli-signals.d.ts.map +1 -0
  133. package/dist/cli-signals.js +28 -0
  134. package/dist/cli-signals.js.map +1 -0
  135. package/dist/cli.d.ts +4 -3
  136. package/dist/cli.d.ts.map +1 -1
  137. package/dist/cli.js +1102 -905
  138. package/dist/cli.js.map +1 -1
  139. package/dist/cloud-publish.d.ts.map +1 -1
  140. package/dist/cloud-publish.js +10 -9
  141. package/dist/cloud-publish.js.map +1 -1
  142. package/dist/codeowners.d.ts +19 -0
  143. package/dist/codeowners.d.ts.map +1 -0
  144. package/dist/codeowners.js +138 -0
  145. package/dist/codeowners.js.map +1 -0
  146. package/dist/codex-sdk-environment.d.ts +1 -0
  147. package/dist/codex-sdk-environment.d.ts.map +1 -1
  148. package/dist/codex-sdk-environment.js +40 -2
  149. package/dist/codex-sdk-environment.js.map +1 -1
  150. package/dist/component-plan.d.ts +2 -5
  151. package/dist/component-plan.d.ts.map +1 -1
  152. package/dist/component-plan.js +39 -31
  153. package/dist/component-plan.js.map +1 -1
  154. package/dist/component-scan.d.ts +6 -5
  155. package/dist/component-scan.d.ts.map +1 -1
  156. package/dist/component-scan.js +25 -36
  157. package/dist/component-scan.js.map +1 -1
  158. package/dist/config.d.ts.map +1 -1
  159. package/dist/config.js +64 -74
  160. package/dist/config.js.map +1 -1
  161. package/dist/contract.d.ts +16 -3
  162. package/dist/contract.d.ts.map +1 -1
  163. package/dist/contract.js +91 -255
  164. package/dist/contract.js.map +1 -1
  165. package/dist/cost-model.d.ts +13 -6
  166. package/dist/cost-model.d.ts.map +1 -1
  167. package/dist/cost-model.js +14 -4
  168. package/dist/cost-model.js.map +1 -1
  169. package/dist/cost.d.ts +10 -2
  170. package/dist/cost.d.ts.map +1 -1
  171. package/dist/cost.js +102 -104
  172. package/dist/cost.js.map +1 -1
  173. package/dist/custom-validation-prompt.d.ts.map +1 -1
  174. package/dist/custom-validation-prompt.js +6 -5
  175. package/dist/custom-validation-prompt.js.map +1 -1
  176. package/dist/custom-validation.d.ts +1 -2
  177. package/dist/custom-validation.d.ts.map +1 -1
  178. package/dist/custom-validation.js +9 -3
  179. package/dist/custom-validation.js.map +1 -1
  180. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  181. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  182. package/dist/deduplication/checkpointed-review.js +23 -9
  183. package/dist/deduplication/checkpointed-review.js.map +1 -1
  184. package/dist/deduplication/codex-review.d.ts +8 -6
  185. package/dist/deduplication/codex-review.d.ts.map +1 -1
  186. package/dist/deduplication/codex-review.js +128 -19
  187. package/dist/deduplication/codex-review.js.map +1 -1
  188. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  189. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  190. package/dist/deduplication/deduplication-prompts.js +18 -4
  191. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  192. package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
  193. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  194. package/dist/deduplication/deduplication-reviewer.js +58 -48
  195. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  196. package/dist/deduplication/deduplication.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication.js +19 -51
  198. package/dist/deduplication/deduplication.js.map +1 -1
  199. package/dist/deduplication/diagnostics.d.ts +17 -0
  200. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  201. package/dist/deduplication/diagnostics.js +5 -0
  202. package/dist/deduplication/diagnostics.js.map +1 -0
  203. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  204. package/dist/deduplication/finding-schema.js +7 -1
  205. package/dist/deduplication/finding-schema.js.map +1 -1
  206. package/dist/deduplication/local.d.ts +31 -0
  207. package/dist/deduplication/local.d.ts.map +1 -0
  208. package/dist/deduplication/local.js +166 -0
  209. package/dist/deduplication/local.js.map +1 -0
  210. package/dist/deduplication/records-protocol.d.ts +3 -8
  211. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  212. package/dist/deduplication/records-protocol.js +11 -184
  213. package/dist/deduplication/records-protocol.js.map +1 -1
  214. package/dist/deduplication/records.d.ts +186 -11
  215. package/dist/deduplication/records.d.ts.map +1 -1
  216. package/dist/deduplication/records.js +10 -18
  217. package/dist/deduplication/records.js.map +1 -1
  218. package/dist/deduplication/scan.d.ts +9 -3
  219. package/dist/deduplication/scan.d.ts.map +1 -1
  220. package/dist/deduplication/scan.js +158 -39
  221. package/dist/deduplication/scan.js.map +1 -1
  222. package/dist/deep-config.d.ts +2 -1
  223. package/dist/deep-config.d.ts.map +1 -1
  224. package/dist/deep-config.js +4 -4
  225. package/dist/deep-config.js.map +1 -1
  226. package/dist/deep-progress.d.ts +17 -1
  227. package/dist/deep-progress.d.ts.map +1 -1
  228. package/dist/deep-progress.js +19 -17
  229. package/dist/deep-progress.js.map +1 -1
  230. package/dist/deep-scan.d.ts +20 -0
  231. package/dist/deep-scan.d.ts.map +1 -0
  232. package/dist/deep-scan.js +113 -0
  233. package/dist/deep-scan.js.map +1 -0
  234. package/dist/errors.d.ts +2 -0
  235. package/dist/errors.d.ts.map +1 -1
  236. package/dist/errors.js +2 -0
  237. package/dist/errors.js.map +1 -1
  238. package/dist/executable-path.d.ts +2 -0
  239. package/dist/executable-path.d.ts.map +1 -0
  240. package/dist/executable-path.js +12 -0
  241. package/dist/executable-path.js.map +1 -0
  242. package/dist/feedback.d.ts +1 -4
  243. package/dist/feedback.d.ts.map +1 -1
  244. package/dist/feedback.js +54 -22
  245. package/dist/feedback.js.map +1 -1
  246. package/dist/finding-catalogue.d.ts.map +1 -1
  247. package/dist/finding-catalogue.js +4 -8
  248. package/dist/finding-catalogue.js.map +1 -1
  249. package/dist/finding-normalization.d.ts +5 -0
  250. package/dist/finding-normalization.d.ts.map +1 -0
  251. package/dist/finding-normalization.js +120 -0
  252. package/dist/finding-normalization.js.map +1 -0
  253. package/dist/finding-retrieval.d.ts +9 -0
  254. package/dist/finding-retrieval.d.ts.map +1 -1
  255. package/dist/finding-retrieval.js.map +1 -1
  256. package/dist/finding-workflow.d.ts +13 -8
  257. package/dist/finding-workflow.d.ts.map +1 -1
  258. package/dist/finding-workflow.js +14 -6
  259. package/dist/finding-workflow.js.map +1 -1
  260. package/dist/findings-client.d.ts +2 -1
  261. package/dist/findings-client.d.ts.map +1 -1
  262. package/dist/findings-client.js +36 -9
  263. package/dist/findings-client.js.map +1 -1
  264. package/dist/findings-errors.d.ts +16 -0
  265. package/dist/findings-errors.d.ts.map +1 -0
  266. package/dist/findings-errors.js +24 -0
  267. package/dist/findings-errors.js.map +1 -0
  268. package/dist/findings-import.d.ts +1 -1
  269. package/dist/findings-import.d.ts.map +1 -1
  270. package/dist/findings-import.js +12 -30
  271. package/dist/findings-import.js.map +1 -1
  272. package/dist/github.d.ts.map +1 -1
  273. package/dist/github.js +7 -1
  274. package/dist/github.js.map +1 -1
  275. package/dist/host-protocol.d.ts +19 -0
  276. package/dist/host-protocol.d.ts.map +1 -0
  277. package/dist/host-protocol.js +270 -0
  278. package/dist/host-protocol.js.map +1 -0
  279. package/dist/hosted-scan-protocol.d.ts +4 -0
  280. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  281. package/dist/hosted-scan-protocol.js +25 -0
  282. package/dist/hosted-scan-protocol.js.map +1 -0
  283. package/dist/hosted-scan.d.ts +117 -0
  284. package/dist/hosted-scan.d.ts.map +1 -0
  285. package/dist/hosted-scan.js +260 -0
  286. package/dist/hosted-scan.js.map +1 -0
  287. package/dist/import-scan.d.ts.map +1 -1
  288. package/dist/import-scan.js +48 -38
  289. package/dist/import-scan.js.map +1 -1
  290. package/dist/index.d.ts +11 -4
  291. package/dist/index.d.ts.map +1 -1
  292. package/dist/index.js +2 -1
  293. package/dist/index.js.map +1 -1
  294. package/dist/knowledge-base.d.ts +7 -1
  295. package/dist/knowledge-base.d.ts.map +1 -1
  296. package/dist/knowledge-base.js +114 -46
  297. package/dist/knowledge-base.js.map +1 -1
  298. package/dist/linear.d.ts.map +1 -1
  299. package/dist/linear.js +2 -7
  300. package/dist/linear.js.map +1 -1
  301. package/dist/mock-scan.d.ts.map +1 -1
  302. package/dist/mock-scan.js +0 -1
  303. package/dist/mock-scan.js.map +1 -1
  304. package/dist/models.d.ts +0 -2
  305. package/dist/models.d.ts.map +1 -1
  306. package/dist/models.js.map +1 -1
  307. package/dist/multiscan.d.ts +9 -3
  308. package/dist/multiscan.d.ts.map +1 -1
  309. package/dist/multiscan.js +240 -135
  310. package/dist/multiscan.js.map +1 -1
  311. package/dist/owner-evidence.d.ts +10 -2
  312. package/dist/owner-evidence.d.ts.map +1 -1
  313. package/dist/owner-evidence.js +67 -8
  314. package/dist/owner-evidence.js.map +1 -1
  315. package/dist/patch-tui.d.ts.map +1 -1
  316. package/dist/patch-tui.js +3 -2
  317. package/dist/patch-tui.js.map +1 -1
  318. package/dist/project-config.js +3 -3
  319. package/dist/project-config.js.map +1 -1
  320. package/dist/provider-profile.d.ts +21 -0
  321. package/dist/provider-profile.d.ts.map +1 -0
  322. package/dist/provider-profile.js +133 -0
  323. package/dist/provider-profile.js.map +1 -0
  324. package/dist/publication-events.d.ts +6 -8
  325. package/dist/publication-events.d.ts.map +1 -1
  326. package/dist/publication-events.js +25 -50
  327. package/dist/publication-events.js.map +1 -1
  328. package/dist/publication-store.d.ts.map +1 -1
  329. package/dist/publication-store.js +95 -109
  330. package/dist/publication-store.js.map +1 -1
  331. package/dist/publication.d.ts +1 -4
  332. package/dist/publication.d.ts.map +1 -1
  333. package/dist/publication.js +2 -13
  334. package/dist/publication.js.map +1 -1
  335. package/dist/publish.d.ts +1 -5
  336. package/dist/publish.d.ts.map +1 -1
  337. package/dist/publish.js +109 -160
  338. package/dist/publish.js.map +1 -1
  339. package/dist/request-metadata.d.ts +9 -0
  340. package/dist/request-metadata.d.ts.map +1 -0
  341. package/dist/request-metadata.js +13 -0
  342. package/dist/request-metadata.js.map +1 -0
  343. package/dist/runtime.d.ts +20 -6
  344. package/dist/runtime.d.ts.map +1 -1
  345. package/dist/runtime.js +407 -148
  346. package/dist/runtime.js.map +1 -1
  347. package/dist/saved-scan-bootstrap.d.ts +14 -0
  348. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  349. package/dist/saved-scan-bootstrap.js +261 -0
  350. package/dist/saved-scan-bootstrap.js.map +1 -0
  351. package/dist/saved-scan.d.ts +1 -1
  352. package/dist/saved-scan.d.ts.map +1 -1
  353. package/dist/saved-scan.js +6 -12
  354. package/dist/saved-scan.js.map +1 -1
  355. package/dist/scan-activity.js +11 -8
  356. package/dist/scan-activity.js.map +1 -1
  357. package/dist/scan-comparison.d.ts +28 -15
  358. package/dist/scan-comparison.d.ts.map +1 -1
  359. package/dist/scan-comparison.js +276 -281
  360. package/dist/scan-comparison.js.map +1 -1
  361. package/dist/scan-dashboard.d.ts +3 -0
  362. package/dist/scan-dashboard.d.ts.map +1 -1
  363. package/dist/scan-dashboard.js +345 -77
  364. package/dist/scan-dashboard.js.map +1 -1
  365. package/dist/scan-executor.d.ts +104 -0
  366. package/dist/scan-executor.d.ts.map +1 -0
  367. package/dist/scan-executor.js +62 -0
  368. package/dist/scan-executor.js.map +1 -0
  369. package/dist/scan-history-renderer.d.ts.map +1 -1
  370. package/dist/scan-history-renderer.js +54 -13
  371. package/dist/scan-history-renderer.js.map +1 -1
  372. package/dist/scan-inputs.d.ts +6 -0
  373. package/dist/scan-inputs.d.ts.map +1 -0
  374. package/dist/scan-inputs.js +71 -0
  375. package/dist/scan-inputs.js.map +1 -0
  376. package/dist/scan-logs.d.ts +2 -3
  377. package/dist/scan-logs.d.ts.map +1 -1
  378. package/dist/scan-logs.js +12 -6
  379. package/dist/scan-logs.js.map +1 -1
  380. package/dist/scan-sessions.d.ts +4 -0
  381. package/dist/scan-sessions.d.ts.map +1 -1
  382. package/dist/scan-sessions.js +17 -0
  383. package/dist/scan-sessions.js.map +1 -1
  384. package/dist/scan-skill-paths.d.ts +8 -0
  385. package/dist/scan-skill-paths.d.ts.map +1 -0
  386. package/dist/scan-skill-paths.js +47 -0
  387. package/dist/scan-skill-paths.js.map +1 -0
  388. package/dist/security-policy-cli.d.ts.map +1 -1
  389. package/dist/security-policy-cli.js +7 -27
  390. package/dist/security-policy-cli.js.map +1 -1
  391. package/dist/security-policy.d.ts +9 -5
  392. package/dist/security-policy.d.ts.map +1 -1
  393. package/dist/security-policy.js +33 -14
  394. package/dist/security-policy.js.map +1 -1
  395. package/dist/server/api.d.ts +0 -1
  396. package/dist/server/api.d.ts.map +1 -1
  397. package/dist/server/api.js +0 -1
  398. package/dist/server/api.js.map +1 -1
  399. package/dist/server/embeddings.d.ts +3 -1
  400. package/dist/server/embeddings.d.ts.map +1 -1
  401. package/dist/server/embeddings.js +10 -3
  402. package/dist/server/embeddings.js.map +1 -1
  403. package/dist/server/errors.d.ts +5 -2
  404. package/dist/server/errors.d.ts.map +1 -1
  405. package/dist/server/errors.js +7 -0
  406. package/dist/server/errors.js.map +1 -1
  407. package/dist/server/sqlite-store.d.ts +0 -2
  408. package/dist/server/sqlite-store.d.ts.map +1 -1
  409. package/dist/server/sqlite-store.js +54 -44
  410. package/dist/server/sqlite-store.js.map +1 -1
  411. package/dist/server/storage.d.ts +0 -2
  412. package/dist/server/storage.d.ts.map +1 -1
  413. package/dist/server/storage.js.map +1 -1
  414. package/dist/severity-store.js +19 -24
  415. package/dist/severity-store.js.map +1 -1
  416. package/dist/standalone-validation-prompt.d.ts +2 -0
  417. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  418. package/dist/standalone-validation-prompt.js +10 -0
  419. package/dist/standalone-validation-prompt.js.map +1 -0
  420. package/dist/suggest-owners.d.ts +4 -2
  421. package/dist/suggest-owners.d.ts.map +1 -1
  422. package/dist/suggest-owners.js +11 -5
  423. package/dist/suggest-owners.js.map +1 -1
  424. package/dist/targets.d.ts +11 -0
  425. package/dist/targets.d.ts.map +1 -1
  426. package/dist/targets.js +123 -72
  427. package/dist/targets.js.map +1 -1
  428. package/dist/trusted-executable.d.ts +2 -2
  429. package/dist/trusted-executable.d.ts.map +1 -1
  430. package/dist/trusted-executable.js +8 -6
  431. package/dist/trusted-executable.js.map +1 -1
  432. package/dist/value.js +7 -0
  433. package/dist/value.js.map +1 -1
  434. package/dist/version.js.map +1 -1
  435. package/dist/workbench-arguments.d.ts +3 -0
  436. package/dist/workbench-arguments.d.ts.map +1 -0
  437. package/dist/workbench-arguments.js +15 -0
  438. package/dist/workbench-arguments.js.map +1 -0
  439. package/dist/worker-progress.d.ts +44 -11
  440. package/dist/worker-progress.d.ts.map +1 -1
  441. package/dist/worker-progress.js +48 -49
  442. package/dist/worker-progress.js.map +1 -1
  443. package/docs/cli.md +1788 -0
  444. package/docs/findings-service.md +402 -0
  445. package/docs/hosted-scans.md +242 -0
  446. package/package.json +23 -22
  447. package/schemas/hosted-scan-v2.fixture.json +145 -0
  448. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  449. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  450. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  451. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  452. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  453. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  454. package/dist/server/dashboard/app.css +0 -2
  455. package/dist/server/dashboard/app.js +0 -66
  456. package/dist/server/dashboard/index.html +0 -18
  457. package/dist/server/dashboard-types.d.ts +0 -48
  458. package/dist/server/dashboard-types.d.ts.map +0 -1
  459. package/dist/server/dashboard-types.js +0 -2
  460. package/dist/server/dashboard-types.js.map +0 -1
  461. package/dist/server/dashboard.d.ts +0 -6
  462. package/dist/server/dashboard.d.ts.map +0 -1
  463. package/dist/server/dashboard.js +0 -59
  464. package/dist/server/dashboard.js.map +0 -1
  465. package/dist/server/index.d.ts +0 -2
  466. package/dist/server/index.d.ts.map +0 -1
  467. package/dist/server/index.js +0 -6
  468. package/dist/server/index.js.map +0 -1
  469. package/dist/server/routes.d.ts +0 -7
  470. package/dist/server/routes.d.ts.map +0 -1
  471. package/dist/server/routes.js +0 -98
  472. package/dist/server/routes.js.map +0 -1
  473. package/dist/server/serve.d.ts +0 -2
  474. package/dist/server/serve.d.ts.map +0 -1
  475. package/dist/server/serve.js +0 -28
  476. package/dist/server/serve.js.map +0 -1
  477. package/dist/server/server.d.ts +0 -10
  478. package/dist/server/server.d.ts.map +0 -1
  479. package/dist/server/server.js +0 -16
  480. package/dist/server/server.js.map +0 -1
  481. package/dist/server/validation.d.ts +0 -17
  482. package/dist/server/validation.d.ts.map +0 -1
  483. package/dist/server/validation.js +0 -53
  484. package/dist/server/validation.js.map +0 -1
package/dist/contract.js CHANGED
@@ -1,9 +1,11 @@
1
+ import { isDeepStrictEqual as sameArray } from "node:util";
1
2
  import { createHash, hash } from "node:crypto";
2
- import { isNonEmptyString } from "./value.js";
3
+ import { normalizePersistedFindingDetails } from "./finding-normalization.js";
3
4
  import { constants } from "node:fs";
4
5
  import { lstat, open, readFile, realpath, } from "node:fs/promises";
5
6
  import { isAbsolute, join, posix, resolve } from "node:path";
6
7
  import Ajv2020 from "ajv/dist/2020.js";
8
+ import { regexes } from "zod";
7
9
  import { ContractValidationError, abortReason } from "./errors.js";
8
10
  import { isRecord } from "./record.js";
9
11
  import { requirePrivateOutputDirectory, requireSecureOutputAncestry, } from "./runtime.js";
@@ -15,17 +17,6 @@ const DOCUMENTS = {
15
17
  "coverage.json": "coverage.schema.json",
16
18
  };
17
19
  const PRODUCER_NAME = "codex-security-plugin";
18
- const SAFE_SCHEMA_ERROR_PROPERTIES = new Set([
19
- "scan",
20
- "target",
21
- "remote",
22
- "completedAt",
23
- "sealedAt",
24
- "artifacts",
25
- "findings",
26
- "coverage",
27
- "scope",
28
- ]);
29
20
  export async function loadContract(scanDirectory, options) {
30
21
  return (await loadContractWithScanDirectory(scanDirectory, options)).contract;
31
22
  }
@@ -33,14 +24,15 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
33
24
  const scanRoot = await requireScanRoot(scanDirectory, options.signal);
34
25
  const scanDir = scanRoot.path;
35
26
  const documentDigests = new Map();
36
- const payloads = {
37
- "scan-manifest.json": await readScanJson(scanDir, "scan-manifest.json", documentDigests, options.signal, scanRoot),
38
- "findings.json": await readScanJson(scanDir, "findings.json", documentDigests, options.signal, scanRoot),
39
- "coverage.json": await readScanJson(scanDir, "coverage.json", documentDigests, options.signal, scanRoot),
40
- };
27
+ const payloads = {};
28
+ for (const filename of Object.keys(DOCUMENTS)) {
29
+ payloads[filename] = await readScanJson(scanDir, filename, documentDigests, options.signal, scanRoot);
30
+ }
41
31
  throwIfAborted(options.signal);
42
- let findingsPayload = payloads["findings.json"];
43
- const ajv = createValidator();
32
+ // The plugin schemas are the immutable v0 contract. They are valid Draft
33
+ // 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
34
+ // optional strict-schema linter requires.
35
+ const ajv = new Ajv2020({ allErrors: false, strict: false }).addFormat("date-time", { type: "string", validate: validRfc3339DateTime });
44
36
  for (const [filename, schemaName] of Object.entries(DOCUMENTS)) {
45
37
  const schema = await readJson(join(options.pluginRoot, "schemas", schemaName), options.signal);
46
38
  let validate;
@@ -48,10 +40,7 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
48
40
  let valid;
49
41
  try {
50
42
  validate = ajv.compile(schema);
51
- payload =
52
- filename === "findings.json"
53
- ? findingsPayload
54
- : payloads[filename];
43
+ payload = payloads[filename];
55
44
  const validatePayload = (payload) => {
56
45
  const result = validate(payload);
57
46
  if (typeof result !== "boolean") {
@@ -71,12 +60,11 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
71
60
  if (!valid) {
72
61
  throw schemaError(filename, validate.errors ?? []);
73
62
  }
74
- if (filename === "findings.json")
75
- findingsPayload = payload;
63
+ payloads[filename] = payload;
76
64
  throwIfAborted(options.signal);
77
65
  }
78
66
  const manifest = payloads["scan-manifest.json"];
79
- const findings = findingsPayload;
67
+ const findings = payloads["findings.json"];
80
68
  const coverage = payloads["coverage.json"];
81
69
  if (options.expectedScanId !== undefined &&
82
70
  manifest.scan.id !== options.expectedScanId) {
@@ -104,7 +92,7 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
104
92
  };
105
93
  }
106
94
  /** Normalize optional legacy details on a copy, without changing saved artifacts. */
107
- export function normalizePersistedFindings(payload) {
95
+ function normalizePersistedFindings(payload) {
108
96
  const compatible = structuredClone(payload);
109
97
  if (!isRecord(compatible) || !Array.isArray(compatible["findings"])) {
110
98
  return compatible;
@@ -112,149 +100,10 @@ export function normalizePersistedFindings(payload) {
112
100
  for (const finding of compatible["findings"]) {
113
101
  if (!isRecord(finding))
114
102
  continue;
115
- const legacyEvidence = finding["code_evidence"];
116
- if (Array.isArray(legacyEvidence)) {
117
- const compatibleEvidence = [];
118
- for (const evidence of legacyEvidence) {
119
- if (!isRecord(evidence))
120
- continue;
121
- const id = evidence["id"];
122
- const code = evidence["code"];
123
- if (!isNonEmptyString(id) || !isNonEmptyString(code)) {
124
- continue;
125
- }
126
- compatibleEvidence.push(evidence);
127
- }
128
- finding["code_evidence"] = compatibleEvidence;
129
- }
130
- else if ("code_evidence" in finding && legacyEvidence !== null) {
131
- delete finding["code_evidence"];
132
- }
133
- for (const [sectionName, listFields] of [
134
- ["root_cause", ["evidenceRefs", "evidence_refs"]],
135
- [
136
- "validation",
137
- [
138
- "assertions",
139
- "counterEvidence",
140
- "evidenceRefs",
141
- "evidence_refs",
142
- "limitations",
143
- ],
144
- ],
145
- [
146
- "attackPath",
147
- [
148
- "assumptions",
149
- "blindspots",
150
- "controls",
151
- "evidenceRefs",
152
- "evidence_refs",
153
- "limitations",
154
- "preconditions",
155
- "steps",
156
- ],
157
- ],
158
- ]) {
159
- const section = finding[sectionName];
160
- if (!isRecord(section))
161
- continue;
162
- normalizeLegacyStringLists(section, listFields);
163
- }
164
- const legacyRootCause = finding["root_cause"];
165
- if (isRecord(legacyRootCause)) {
166
- removeUnsupportedLegacyStrings(legacyRootCause, [
167
- "summary",
168
- "code",
169
- "language",
170
- ]);
171
- }
172
- else if ("root_cause" in finding &&
173
- legacyRootCause !== null &&
174
- typeof legacyRootCause !== "string") {
175
- delete finding["root_cause"];
176
- }
177
- const validation = finding["validation"];
178
- if (isRecord(validation)) {
179
- if (typeof validation["evidence"] !== "string" ||
180
- validation["evidence"].length === 0) {
181
- normalizeLegacyStringLists(validation, ["evidence"]);
182
- }
183
- removeUnsupportedLegacyStrings(validation, ["method", "summary"]);
184
- removeUnsupportedLegacyStrings(validation, ["status", "disposition", "result"].filter((field) => validation[field] !== null));
185
- }
186
- const attackPath = finding["attackPath"];
187
- if (!isRecord(attackPath))
188
- continue;
189
- removeUnsupportedLegacyStrings(attackPath, ["summary"]);
190
- for (const field of ["dataFlow", "data_flow", "dataflow", "reachability"]) {
191
- const detail = attackPath[field];
192
- if (detail === null) {
193
- delete attackPath[field];
194
- continue;
195
- }
196
- if (typeof detail === "string") {
197
- if (detail.length === 0)
198
- delete attackPath[field];
199
- continue;
200
- }
201
- if (!isRecord(detail)) {
202
- if (field in attackPath)
203
- delete attackPath[field];
204
- continue;
205
- }
206
- removeUnsupportedLegacyStrings(detail, [
207
- "summary",
208
- "source",
209
- "sink",
210
- "outcome",
211
- ...(field === "reachability" ? ["attacker", "entrypoint"] : []),
212
- ]);
213
- normalizeLegacyStringLists(detail, [
214
- "evidenceRefs",
215
- "evidence_refs",
216
- "transformations",
217
- ...(field === "reachability" ? ["preconditions"] : []),
218
- ]);
219
- }
220
- for (const field of ["impact", "likelihood"]) {
221
- const detail = attackPath[field];
222
- if (isRecord(detail)) {
223
- removeUnsupportedLegacyStrings(detail, ["level", "rationale", "why"]);
224
- }
225
- else if (detail !== undefined &&
226
- detail !== null &&
227
- !isNonEmptyString(detail)) {
228
- delete attackPath[field];
229
- }
230
- }
103
+ normalizePersistedFindingDetails(finding);
231
104
  }
232
105
  return compatible;
233
106
  }
234
- function normalizeLegacyStringLists(section, fields) {
235
- for (const field of fields) {
236
- if (!(field in section))
237
- continue;
238
- const value = section[field];
239
- if (Array.isArray(value)) {
240
- section[field] = value.filter(isNonEmptyString);
241
- }
242
- else if (isNonEmptyString(value)) {
243
- section[field] = [value];
244
- }
245
- else {
246
- delete section[field];
247
- }
248
- }
249
- }
250
- function removeUnsupportedLegacyStrings(section, fields) {
251
- for (const field of fields) {
252
- if (field in section &&
253
- (typeof section[field] !== "string" || section[field].length === 0)) {
254
- delete section[field];
255
- }
256
- }
257
- }
258
107
  function validateCanonicalContract(manifest, findings) {
259
108
  const remote = manifest.scan.target.remote;
260
109
  if (remote !== undefined) {
@@ -292,8 +141,29 @@ function validateCanonicalContract(manifest, findings) {
292
141
  }
293
142
  }
294
143
  }
144
+ const findingIds = new Set();
295
145
  for (const [findingIndex, finding] of findings.findings.entries()) {
296
146
  const context = `findings.findings[${findingIndex}]`;
147
+ if (findingIds.has(finding.findingId)) {
148
+ throw new ContractValidationError(`${context}: duplicate finding id.`);
149
+ }
150
+ findingIds.add(finding.findingId);
151
+ for (const [field, value] of [
152
+ ["title", finding.title],
153
+ ["summary", finding.summary],
154
+ ["remediation", finding.remediation],
155
+ ["confidence.rationale", finding.confidence.rationale],
156
+ ["taxonomy.category", finding.taxonomy.category],
157
+ ["provenance.source", finding.provenance.source],
158
+ ...(finding.severity.score === undefined
159
+ ? []
160
+ : [["severity.scoringSystem", finding.severity.scoringSystem]]),
161
+ ]) {
162
+ // Match the producer's Python str.strip without changing saved text.
163
+ if (/^[\p{White_Space}\u001c-\u001f]*$/u.test(value ?? "")) {
164
+ throw new ContractValidationError(`${context}.${field}: expected a non-empty string.`);
165
+ }
166
+ }
297
167
  for (const [locationIndex, location] of finding.locations.entries()) {
298
168
  const locationContext = `${context}.locations[${locationIndex}]`;
299
169
  try {
@@ -302,23 +172,18 @@ function validateCanonicalContract(manifest, findings) {
302
172
  catch (error) {
303
173
  throw new ContractValidationError(`${locationContext}.path: expected a safe repository-relative POSIX path.`, { cause: error });
304
174
  }
175
+ if ((location.endLine ?? location.startLine) < location.startLine) {
176
+ throw new ContractValidationError(`${locationContext}.endLine: expected an integer >= startLine.`);
177
+ }
305
178
  }
306
- const fingerprint = `codex-security/v1:sha256:${hash("sha256", [
307
- "codex-security/v1",
308
- manifest.scan.target.targetId,
309
- finding.ruleId,
310
- finding.identity.anchor,
311
- finding.identity.instance ?? "",
312
- ].join("\0"))}`;
313
- const findingId = `csf_${hash("sha256", fingerprint).slice(0, 24)}`;
314
- const occurrenceId = `occ_${hash("sha256", [manifest.scan.id, fingerprint].join("\0")).slice(0, 24)}`;
179
+ const { findingId, occurrenceId, fingerprints } = deriveFindingIdentity(manifest.scan.id, manifest.scan.target.targetId, finding.ruleId, finding.identity);
315
180
  if (finding.findingId !== findingId) {
316
181
  throw new ContractValidationError(`${context}.findingId: does not match derived fingerprint identity.`);
317
182
  }
318
183
  if (finding.occurrenceId !== occurrenceId) {
319
184
  throw new ContractValidationError(`${context}.occurrenceId: does not match scan occurrence identity.`);
320
185
  }
321
- if (finding.fingerprints.primary !== fingerprint) {
186
+ if (finding.fingerprints.primary !== fingerprints.primary) {
322
187
  throw new ContractValidationError(`${context}.fingerprints: does not match derived fingerprint.`);
323
188
  }
324
189
  }
@@ -407,18 +272,29 @@ async function validateSeal(scanDir, manifest, findings, coverage, documentDiges
407
272
  throw new ContractValidationError(`${context}: sealed artifact changed or is missing.`);
408
273
  }
409
274
  }
275
+ const requireSealedReference = (reference, context) => {
276
+ throwIfAborted(signal);
277
+ if (typeof reference !== "string") {
278
+ throw new ContractValidationError(`${context}: expected a string.`);
279
+ }
280
+ const normalized = portableRelativePath(reference, context.toLowerCase());
281
+ if (!normalized.startsWith("artifacts/")) {
282
+ throw new ContractValidationError(`${context} must be under artifacts/: ${reference}`);
283
+ }
284
+ if (!artifactPaths.has(normalized)) {
285
+ throw new ContractValidationError(`${context} is missing from sealed artifacts: ${reference}`);
286
+ }
287
+ };
410
288
  for (const surface of coverage.surfaces) {
411
289
  for (const receipt of surface.receiptRefs) {
412
- throwIfAborted(signal);
413
- const normalized = portableRelativePath(receipt, "coverage receipt");
414
- if (!normalized.startsWith("artifacts/")) {
415
- throw new ContractValidationError(`Coverage receipt must be under artifacts/: ${receipt}`);
416
- }
417
- if (!artifactPaths.has(normalized)) {
418
- throw new ContractValidationError(`Coverage receipt is missing from sealed artifacts: ${receipt}`);
419
- }
290
+ requireSealedReference(receipt, "Coverage receipt");
420
291
  }
421
292
  }
293
+ const extensions = scan["extensions"];
294
+ const imported = isRecord(extensions) ? extensions["import"] : undefined;
295
+ if (isRecord(imported) && "sourceRef" in imported) {
296
+ requireSealedReference(imported["sourceRef"], "Import source");
297
+ }
422
298
  for (const [index, finding] of findings.findings.entries()) {
423
299
  const writeup = finding.writeup;
424
300
  if (writeup === undefined)
@@ -545,7 +421,7 @@ async function verifyScanRoot(root, signal) {
545
421
  }
546
422
  function safeRelativePath(value, context) {
547
423
  const parts = value.split("/");
548
- if (value.trim().length === 0 ||
424
+ if (value.length === 0 ||
549
425
  Buffer.from(value, "utf8").toString("utf8") !== value ||
550
426
  value === "." ||
551
427
  value.startsWith("/") ||
@@ -565,12 +441,13 @@ function safeRelativePath(value, context) {
565
441
  }
566
442
  function portableRelativePath(value, context) {
567
443
  const normalized = safeRelativePath(value, context);
568
- if (value.split("/").some(isWindowsUnsafePathComponent)) {
444
+ if (value.trim().length === 0 ||
445
+ value.split("/").some(isWindowsUnsafePathComponent)) {
569
446
  throw new ContractValidationError(`${context}: expected a safe scan-relative POSIX path.`);
570
447
  }
571
448
  return normalized;
572
449
  }
573
- function safeScopePath(value) {
450
+ export function safeScopePath(value) {
574
451
  return value === "."
575
452
  ? value
576
453
  : safeRelativePath(value, "manifest scope include path");
@@ -658,21 +535,10 @@ function validateParsedJson(value, context) {
658
535
  if (!key.isWellFormed()) {
659
536
  throw new ContractValidationError(`${context}: expected well-formed Unicode JSON keys.`);
660
537
  }
661
- validateParsedJson(item, `${context}.<property>`);
538
+ validateParsedJson(item, `${context}[${JSON.stringify(key)}]`);
662
539
  }
663
540
  }
664
541
  }
665
- function createValidator() {
666
- // The plugin schemas are the immutable v0 contract. They are valid Draft
667
- // 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
668
- // optional strict-schema linter requires.
669
- const ajv = new Ajv2020({ allErrors: false, strict: false });
670
- ajv.addFormat("date-time", {
671
- type: "string",
672
- validate: validRfc3339DateTime,
673
- });
674
- return ajv;
675
- }
676
542
  async function sha256ScanFile(scanDir, relativePath, context, signal, expectedRoot) {
677
543
  const file = await openCheckedScanFile(scanDir, relativePath, context, signal, expectedRoot);
678
544
  try {
@@ -763,67 +629,18 @@ function throwIfAborted(signal) {
763
629
  return;
764
630
  throw abortReason(signal);
765
631
  }
632
+ const RFC3339_DATE_TIME = new RegExp(regexes.datetime({ offset: true }).source, "i");
766
633
  function validRfc3339DateTime(value) {
767
- const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:Z|[+-](\d{2}):(\d{2}))$/i.exec(value);
768
- if (match === null)
769
- return false;
770
- const year = Number(match[1]);
771
- const month = Number(match[2]);
772
- const day = Number(match[3]);
773
- const hour = Number(match[4]);
774
- const minute = Number(match[5]);
775
- const second = Number(match[6]);
776
- const offsetHour = Number(match[7] ?? 0);
777
- const offsetMinute = Number(match[8] ?? 0);
778
- if (year < 1 ||
779
- month < 1 ||
780
- month > 12 ||
781
- day < 1 ||
782
- hour > 23 ||
783
- minute > 59 ||
784
- second > 59 ||
785
- offsetHour > 23 ||
786
- offsetMinute > 59) {
787
- return false;
788
- }
789
- const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
790
- const daysInMonth = [
791
- 31,
792
- leapYear ? 29 : 28,
793
- 31,
794
- 30,
795
- 31,
796
- 30,
797
- 31,
798
- 31,
799
- 30,
800
- 31,
801
- 30,
802
- 31,
803
- ][month - 1];
804
- return day <= daysInMonth;
634
+ return !value.startsWith("0000") && RFC3339_DATE_TIME.test(value);
805
635
  }
806
636
  function schemaError(filename, errors) {
807
637
  const first = errors[0];
808
- const segments = first?.instancePath.split("/").filter(Boolean) ?? [];
809
- const location = segments.length === 0
810
- ? "<root>"
811
- : segments
812
- .map((segment) => {
813
- if (/^(?:0|[1-9]\d{0,9})$/.test(segment))
814
- return segment;
815
- return SAFE_SCHEMA_ERROR_PROPERTIES.has(segment)
816
- ? segment
817
- : "<property>";
818
- })
819
- .join(".");
638
+ const location = first?.instancePath
639
+ ? JSON.stringify(first.instancePath)
640
+ : "<root>";
820
641
  const keyword = first?.keyword ?? "unknown";
821
642
  const count = errors.length;
822
- return new ContractValidationError(`${filename}:${location}: schema validation failed (${keyword}${keyword === "format" && first?.params["format"] === "date-time" ? "; date-time" : ""}; ${count} ${count === 1 ? "error" : "errors"}).`);
823
- }
824
- function sameArray(left, right) {
825
- return (left.length === right.length &&
826
- left.every((value, index) => value === right[index]));
643
+ return new ContractValidationError(`${filename}:${location}: schema validation failed (${keyword}${keyword === "format" && first?.params["format"] === "date-time" ? "; date-time" : ""}; ${count} ${count === 1 ? "error" : "errors"})${first?.message ? `: ${first.message}` : ""}.`);
827
644
  }
828
645
  function nodeErrorCode(error) {
829
646
  return typeof error === "object" && error !== null && "code" in error
@@ -834,4 +651,23 @@ function nodeErrorCode(error) {
834
651
  export function sha256Text(value) {
835
652
  return hash("sha256", value);
836
653
  }
654
+ export function deriveFindingIdentity(scanId, targetId, ruleId, identity) {
655
+ const fingerprint = `codex-security/v1:sha256:${sha256Text([
656
+ "codex-security/v1",
657
+ targetId,
658
+ ruleId,
659
+ identity.anchor,
660
+ identity.instance ?? "",
661
+ ].join("\0"))}`;
662
+ return {
663
+ findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,
664
+ occurrenceId: `occ_${sha256Text([scanId, fingerprint].join("\0")).slice(0, 24)}`,
665
+ ruleId,
666
+ identity,
667
+ fingerprints: {
668
+ algorithm: "codex-security/v1",
669
+ primary: fingerprint,
670
+ },
671
+ };
672
+ }
837
673
  //# sourceMappingURL=contract.js.map