@openai/codex-security 0.1.31 → 0.2.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 (314) hide show
  1. package/README.md +295 -32
  2. package/_bundled_plugin/.mcp.json +1 -0
  3. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  4. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +4 -4
  5. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  6. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  12. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  13. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  14. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  15. package/_bundled_plugin/references/artifact-storage.md +4 -4
  16. package/_bundled_plugin/references/config-preflight.md +1 -1
  17. package/_bundled_plugin/references/core-scan.md +14 -2
  18. package/_bundled_plugin/references/final-report.md +4 -2
  19. package/_bundled_plugin/references/scan-artifacts.md +2 -2
  20. package/_bundled_plugin/references/scan-contract.md +2 -2
  21. package/_bundled_plugin/references/threat-model.md +2 -2
  22. package/_bundled_plugin/schemas/coverage.schema.json +22 -0
  23. package/_bundled_plugin/schemas/scan-manifest.schema.json +100 -85
  24. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +116 -102
  25. package/_bundled_plugin/scripts/config_preflight.py +4 -8
  26. package/_bundled_plugin/scripts/deep_scan_workbench.py +83 -217
  27. package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
  28. package/_bundled_plugin/scripts/finalize_scan_contract.py +441 -166
  29. package/_bundled_plugin/scripts/finding_preview.py +42 -82
  30. package/_bundled_plugin/scripts/generate_in_scope_files.py +30 -34
  31. package/_bundled_plugin/scripts/generate_rank_input.py +58 -99
  32. package/_bundled_plugin/scripts/launch_codex_security_mcp +5 -1
  33. package/_bundled_plugin/scripts/rank_preview.py +85 -68
  34. package/_bundled_plugin/scripts/report_projection.py +37 -58
  35. package/_bundled_plugin/scripts/threat_model_projection.py +164 -0
  36. package/_bundled_plugin/scripts/windows_scan_local_files.py +11 -6
  37. package/_bundled_plugin/scripts/workbench/storage.py +11 -0
  38. package/_bundled_plugin/scripts/workbench_cli.py +11 -17
  39. package/_bundled_plugin/scripts/workbench_constants.py +6 -14
  40. package/_bundled_plugin/scripts/workbench_db.py +116 -228
  41. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -6
  42. package/_bundled_plugin/scripts/workbench_native_indexes.py +1 -4
  43. package/_bundled_plugin/scripts/workbench_progress.py +12 -34
  44. package/_bundled_plugin/scripts/workbench_publication.py +47 -62
  45. package/_bundled_plugin/scripts/workbench_remediation.py +2 -20
  46. package/_bundled_plugin/scripts/workbench_saved_results.py +1246 -230
  47. package/_bundled_plugin/scripts/workbench_scan_start.py +4 -11
  48. package/_bundled_plugin/scripts/workbench_scan_usage.py +7 -15
  49. package/_bundled_plugin/scripts/workbench_schema.py +86 -271
  50. package/_bundled_plugin/scripts/workbench_severity.py +3 -0
  51. package/_bundled_plugin/scripts/workbench_source_excerpt.py +5 -6
  52. package/_bundled_plugin/scripts/workbench_target.py +98 -10
  53. package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
  54. package/_bundled_plugin/scripts/workbench_validation.py +6 -20
  55. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  56. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +3 -3
  57. package/_bundled_plugin/skills/security-scan/SKILL.md +2 -2
  58. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  59. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
  60. package/dist/api.d.ts +3 -5
  61. package/dist/api.d.ts.map +1 -1
  62. package/dist/api.js +201 -207
  63. package/dist/api.js.map +1 -1
  64. package/dist/artifact-export.d.ts +70 -0
  65. package/dist/artifact-export.d.ts.map +1 -0
  66. package/dist/artifact-export.js +277 -0
  67. package/dist/artifact-export.js.map +1 -0
  68. package/dist/auth.d.ts.map +1 -1
  69. package/dist/auth.js +8 -3
  70. package/dist/auth.js.map +1 -1
  71. package/dist/bulk-scan-discovery.d.ts +1 -0
  72. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  73. package/dist/bulk-scan-discovery.js +8 -9
  74. package/dist/bulk-scan-discovery.js.map +1 -1
  75. package/dist/classify-scan-severity.d.ts.map +1 -1
  76. package/dist/classify-scan-severity.js +2 -5
  77. package/dist/classify-scan-severity.js.map +1 -1
  78. package/dist/classify-severity.d.ts +2 -8
  79. package/dist/classify-severity.d.ts.map +1 -1
  80. package/dist/classify-severity.js +3 -5
  81. package/dist/classify-severity.js.map +1 -1
  82. package/dist/cli-help.d.ts +3 -0
  83. package/dist/cli-help.d.ts.map +1 -0
  84. package/dist/cli-help.js +281 -0
  85. package/dist/cli-help.js.map +1 -0
  86. package/dist/cli.d.ts +19 -22
  87. package/dist/cli.d.ts.map +1 -1
  88. package/dist/cli.js +631 -714
  89. package/dist/cli.js.map +1 -1
  90. package/dist/cloud-publish.d.ts.map +1 -1
  91. package/dist/cloud-publish.js +1 -8
  92. package/dist/cloud-publish.js.map +1 -1
  93. package/dist/codex-prompt.d.ts.map +1 -1
  94. package/dist/codex-prompt.js +1 -2
  95. package/dist/codex-prompt.js.map +1 -1
  96. package/dist/codex-sdk-environment.d.ts +2 -0
  97. package/dist/codex-sdk-environment.d.ts.map +1 -0
  98. package/dist/codex-sdk-environment.js +30 -0
  99. package/dist/codex-sdk-environment.js.map +1 -0
  100. package/dist/component-plan.d.ts.map +1 -1
  101. package/dist/component-plan.js +2 -6
  102. package/dist/component-plan.js.map +1 -1
  103. package/dist/component-scan.d.ts +1 -0
  104. package/dist/component-scan.d.ts.map +1 -1
  105. package/dist/component-scan.js +31 -9
  106. package/dist/component-scan.js.map +1 -1
  107. package/dist/config.d.ts.map +1 -1
  108. package/dist/config.js +32 -33
  109. package/dist/config.js.map +1 -1
  110. package/dist/contract.d.ts +2 -1
  111. package/dist/contract.d.ts.map +1 -1
  112. package/dist/contract.js +63 -122
  113. package/dist/contract.js.map +1 -1
  114. package/dist/cost-model.d.ts.map +1 -1
  115. package/dist/cost-model.js +65 -34
  116. package/dist/cost-model.js.map +1 -1
  117. package/dist/cost.d.ts.map +1 -1
  118. package/dist/cost.js +15 -31
  119. package/dist/cost.js.map +1 -1
  120. package/dist/custom-validation-prompt.js +4 -4
  121. package/dist/custom-validation-prompt.js.map +1 -1
  122. package/dist/custom-validation.d.ts.map +1 -1
  123. package/dist/custom-validation.js +17 -16
  124. package/dist/custom-validation.js.map +1 -1
  125. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  126. package/dist/deduplication/checkpointed-review.js +10 -11
  127. package/dist/deduplication/checkpointed-review.js.map +1 -1
  128. package/dist/deduplication/codex-review.d.ts +2 -0
  129. package/dist/deduplication/codex-review.d.ts.map +1 -1
  130. package/dist/deduplication/codex-review.js +3 -3
  131. package/dist/deduplication/codex-review.js.map +1 -1
  132. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  133. package/dist/deduplication/deduplication-reviewer.js +2 -0
  134. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  135. package/dist/deduplication/deduplication.js +40 -62
  136. package/dist/deduplication/deduplication.js.map +1 -1
  137. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  138. package/dist/deduplication/records-protocol.js +1 -4
  139. package/dist/deduplication/records-protocol.js.map +1 -1
  140. package/dist/deduplication/records.d.ts +2 -1
  141. package/dist/deduplication/records.d.ts.map +1 -1
  142. package/dist/deduplication/records.js +24 -6
  143. package/dist/deduplication/records.js.map +1 -1
  144. package/dist/deduplication/review.d.ts +7 -0
  145. package/dist/deduplication/review.d.ts.map +1 -1
  146. package/dist/deduplication/review.js.map +1 -1
  147. package/dist/deduplication/scan.js +3 -7
  148. package/dist/deduplication/scan.js.map +1 -1
  149. package/dist/deep-config.d.ts.map +1 -1
  150. package/dist/deep-config.js +3 -19
  151. package/dist/deep-config.js.map +1 -1
  152. package/dist/deep-progress.d.ts +0 -1
  153. package/dist/deep-progress.d.ts.map +1 -1
  154. package/dist/deep-progress.js +22 -40
  155. package/dist/deep-progress.js.map +1 -1
  156. package/dist/errors.d.ts +3 -2
  157. package/dist/errors.d.ts.map +1 -1
  158. package/dist/errors.js +5 -7
  159. package/dist/errors.js.map +1 -1
  160. package/dist/finding-catalogue.d.ts.map +1 -1
  161. package/dist/finding-catalogue.js +22 -22
  162. package/dist/finding-catalogue.js.map +1 -1
  163. package/dist/finding-workflow.d.ts.map +1 -1
  164. package/dist/finding-workflow.js +4 -7
  165. package/dist/finding-workflow.js.map +1 -1
  166. package/dist/findings-import.d.ts.map +1 -1
  167. package/dist/findings-import.js +7 -17
  168. package/dist/findings-import.js.map +1 -1
  169. package/dist/github.d.ts.map +1 -1
  170. package/dist/github.js +2 -3
  171. package/dist/github.js.map +1 -1
  172. package/dist/import-scan.js +2 -2
  173. package/dist/import-scan.js.map +1 -1
  174. package/dist/index.d.ts +4 -2
  175. package/dist/index.d.ts.map +1 -1
  176. package/dist/index.js +2 -1
  177. package/dist/index.js.map +1 -1
  178. package/dist/knowledge-base.js +2 -2
  179. package/dist/knowledge-base.js.map +1 -1
  180. package/dist/linear.d.ts.map +1 -1
  181. package/dist/linear.js +2 -3
  182. package/dist/linear.js.map +1 -1
  183. package/dist/models.d.ts +24 -0
  184. package/dist/models.d.ts.map +1 -1
  185. package/dist/models.js.map +1 -1
  186. package/dist/multiscan.d.ts.map +1 -1
  187. package/dist/multiscan.js +36 -31
  188. package/dist/multiscan.js.map +1 -1
  189. package/dist/owner-evidence.d.ts.map +1 -1
  190. package/dist/owner-evidence.js +2 -6
  191. package/dist/owner-evidence.js.map +1 -1
  192. package/dist/patch-tui.d.ts.map +1 -1
  193. package/dist/patch-tui.js +2 -4
  194. package/dist/patch-tui.js.map +1 -1
  195. package/dist/project-config-schema.d.ts +10 -0
  196. package/dist/project-config-schema.d.ts.map +1 -1
  197. package/dist/project-config-schema.js +1 -0
  198. package/dist/project-config-schema.js.map +1 -1
  199. package/dist/project-config.d.ts +1 -0
  200. package/dist/project-config.d.ts.map +1 -1
  201. package/dist/project-config.js +2 -0
  202. package/dist/project-config.js.map +1 -1
  203. package/dist/prompt-files.d.ts +0 -1
  204. package/dist/prompt-files.d.ts.map +1 -1
  205. package/dist/prompt-files.js +2 -4
  206. package/dist/prompt-files.js.map +1 -1
  207. package/dist/publication-events.d.ts.map +1 -1
  208. package/dist/publication-events.js +15 -29
  209. package/dist/publication-events.js.map +1 -1
  210. package/dist/publication-store.d.ts.map +1 -1
  211. package/dist/publication-store.js +9 -13
  212. package/dist/publication-store.js.map +1 -1
  213. package/dist/publication.d.ts.map +1 -1
  214. package/dist/publication.js +11 -14
  215. package/dist/publication.js.map +1 -1
  216. package/dist/publish.d.ts.map +1 -1
  217. package/dist/publish.js +31 -41
  218. package/dist/publish.js.map +1 -1
  219. package/dist/record.d.ts +2 -0
  220. package/dist/record.d.ts.map +1 -0
  221. package/dist/record.js +4 -0
  222. package/dist/record.js.map +1 -0
  223. package/dist/result.d.ts +4 -1
  224. package/dist/result.d.ts.map +1 -1
  225. package/dist/result.js +7 -0
  226. package/dist/result.js.map +1 -1
  227. package/dist/runtime.d.ts +10 -13
  228. package/dist/runtime.d.ts.map +1 -1
  229. package/dist/runtime.js +203 -131
  230. package/dist/runtime.js.map +1 -1
  231. package/dist/saved-scan.d.ts.map +1 -1
  232. package/dist/saved-scan.js +10 -20
  233. package/dist/saved-scan.js.map +1 -1
  234. package/dist/scan-activity.d.ts.map +1 -1
  235. package/dist/scan-activity.js +8 -22
  236. package/dist/scan-activity.js.map +1 -1
  237. package/dist/scan-comparison.d.ts +3 -3
  238. package/dist/scan-comparison.d.ts.map +1 -1
  239. package/dist/scan-comparison.js +38 -73
  240. package/dist/scan-comparison.js.map +1 -1
  241. package/dist/scan-dashboard.d.ts +0 -1
  242. package/dist/scan-dashboard.d.ts.map +1 -1
  243. package/dist/scan-dashboard.js +10 -19
  244. package/dist/scan-dashboard.js.map +1 -1
  245. package/dist/scan-history-renderer.d.ts.map +1 -1
  246. package/dist/scan-history-renderer.js +1 -2
  247. package/dist/scan-history-renderer.js.map +1 -1
  248. package/dist/scan-logs.d.ts.map +1 -1
  249. package/dist/scan-logs.js +2 -6
  250. package/dist/scan-logs.js.map +1 -1
  251. package/dist/scan-sessions.d.ts.map +1 -1
  252. package/dist/scan-sessions.js +1 -3
  253. package/dist/scan-sessions.js.map +1 -1
  254. package/dist/scan-settings.d.ts +5 -0
  255. package/dist/scan-settings.d.ts.map +1 -1
  256. package/dist/scan-settings.js +4 -0
  257. package/dist/scan-settings.js.map +1 -1
  258. package/dist/security-policy-cli.d.ts.map +1 -1
  259. package/dist/security-policy-cli.js +8 -6
  260. package/dist/security-policy-cli.js.map +1 -1
  261. package/dist/security-policy.d.ts +8 -4
  262. package/dist/security-policy.d.ts.map +1 -1
  263. package/dist/security-policy.js +98 -84
  264. package/dist/security-policy.js.map +1 -1
  265. package/dist/server/dashboard/app.js +5 -5
  266. package/dist/server/embeddings.d.ts.map +1 -1
  267. package/dist/server/embeddings.js +1 -0
  268. package/dist/server/embeddings.js.map +1 -1
  269. package/dist/server/routes.d.ts +3 -2
  270. package/dist/server/routes.d.ts.map +1 -1
  271. package/dist/server/routes.js +19 -7
  272. package/dist/server/routes.js.map +1 -1
  273. package/dist/server/server.d.ts.map +1 -1
  274. package/dist/server/server.js +2 -3
  275. package/dist/server/server.js.map +1 -1
  276. package/dist/server/sqlite-store.d.ts.map +1 -1
  277. package/dist/server/sqlite-store.js +4 -14
  278. package/dist/server/sqlite-store.js.map +1 -1
  279. package/dist/severity-store.js +8 -15
  280. package/dist/severity-store.js.map +1 -1
  281. package/dist/suggest-owners.d.ts +2 -3
  282. package/dist/suggest-owners.d.ts.map +1 -1
  283. package/dist/suggest-owners.js +4 -5
  284. package/dist/suggest-owners.js.map +1 -1
  285. package/dist/targets.d.ts +1 -0
  286. package/dist/targets.d.ts.map +1 -1
  287. package/dist/targets.js +24 -21
  288. package/dist/targets.js.map +1 -1
  289. package/dist/trusted-executable.d.ts +5 -0
  290. package/dist/trusted-executable.d.ts.map +1 -1
  291. package/dist/trusted-executable.js +22 -5
  292. package/dist/trusted-executable.js.map +1 -1
  293. package/dist/value.d.ts +2 -0
  294. package/dist/value.d.ts.map +1 -0
  295. package/dist/value.js +20 -0
  296. package/dist/value.js.map +1 -0
  297. package/dist/version.d.ts.map +1 -1
  298. package/dist/version.js +3 -6
  299. package/dist/version.js.map +1 -1
  300. package/dist/windows-path.d.ts.map +1 -1
  301. package/dist/windows-path.js +1 -2
  302. package/dist/windows-path.js.map +1 -1
  303. package/dist/worker-progress.d.ts +1 -0
  304. package/dist/worker-progress.d.ts.map +1 -1
  305. package/dist/worker-progress.js +13 -34
  306. package/dist/worker-progress.js.map +1 -1
  307. package/docs/dedupe-records.md +24 -0
  308. package/package.json +11 -10
  309. package/schemas/project-config.schema.json +5 -0
  310. package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
  311. package/dist/server/findings-service.d.ts +0 -20
  312. package/dist/server/findings-service.d.ts.map +0 -1
  313. package/dist/server/findings-service.js +0 -31
  314. package/dist/server/findings-service.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"security-policy-cli.js","sourceRoot":"","sources":["../src/security-policy-cli.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,wBAAwB,IAAI,OAAO,GAGpC,MAAM,sBAAsB,CAAC;AAoC9B,MAAM,MAAM,GAAwC;IAClD,YAAY,EAAE,4DAA4D;IAC1E,YAAY,EAAE,+CAA+C;IAC7D,MAAM,EAAE,4BAA4B;CACrC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA6B,EAC7B,YAAuC;IAOvC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,WAAW,GACf,CAAC,OAAO,CAAC,QAAQ;QACjB,OAAO,CAAC,MAAM,KAAK,MAAM;QACzB,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS;QAC5C,MAAM,CAAC,aAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC;IACnC,IAAI,QAAoC,CAAC;IACzC,IAAI,SAA6B,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,OAAe,EAAQ,EAAE;QACtC,IAAI,CAAC;YACH,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC,CAAC;IACF,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,EAAE,CAAC,GAAG,EAAE;QAClD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,qEAAqE;YACrE,IACE,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM;gBACnC,YAAY,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,GAAG;gBAExC,OAAO;YACT,qBAAqB,EAAE,CAAC;YACxB,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,aAAa,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC;QACnC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,qBAAqB,GAAG,GAAG,EAAE;QACjC,YAAY,CAAC,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACvD,YAAY,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,YAAY,CAAC,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpD,YAAY,CAAC,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,GACR,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM;YAC5B,CAAC,CAAC,MAAM,YAAY,CAAC,oBAAoB,CACrC,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,UAAU,CAAC,IAAI,EACvB,UAAU,CAAC,MAAM,CAClB;YACH,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACnC,QAAQ,GAAG,YAAY,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,EAAE;gBACnE,GAAG,OAAO,CAAC,UAAU;gBACrB,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACnC,OAAO;gBACL,QAAQ,EAAE,CAAC;gBACX,IAAI,EAAE;oBACJ,GAAG,SAAS;oBACZ,MAAM,EAAE,IAAI;iBACb;aACF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE;YAC9D,GAAG,OAAO,CAAC,UAAU;YACrB,IAAI;YACJ,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,gBAAgB,EAAE,CAAC,SAAS,EAAE,EAAE;gBAC9B,SAAS,GAAG,SAAS,CAAC;gBACtB,KAAK,CAAC,qBAAqB,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,KAAK,CAAC,mBAAmB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,WAAW;gBACb,CAAC,CAAC;oBACE,eAAe,EAAE,KAAK,EACpB,SAA4B,EAC5B,MAAmB,EACnB,EAAE;wBACF,KAAK,CACH,sFAAsF,CACvF,CAAC;wBACF,MAAM,OAAO,GAAa,EAAE,CAAC;wBAC7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;4BACjC,MAAM,CAAC,cAAc,EAAE,CAAC;4BACxB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B,OAAO,CAAC,QAAQ,CAAC,EACjB,SAAS,EACT,MAAM,CACP,CAAC;4BACF,IAAI,MAAM,CAAC,IAAI,EAAE;gCAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC;wBAC5D,CAAC;wBACD,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC9B,CAAC;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,OAAO,CAAC;QACxD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QACzE,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE;oBACzC,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBACnC,IAAI,GAAG,8CAA8C,CAAC;gBACtD,KAAK,CACH,iDAAiD,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CACpF,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG;gBACd,oBAAoB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;gBAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,oCAAoC;gBAChE,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;oBAChC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,iBAAiB;wBACjB,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;qBACzD,CAAC;aACP,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,KAAK,CAAC,OAAO,CAAC,CAAC;QACjB,CAAC;QACD,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;QAC/C,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC9C,KAAK,CAAC,iBAAiB,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;YAC3D,KAAK,CAAC,iBAAiB,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,OAAO;gBACT,KAAK,CACH,kGAAkG,CACnG,CAAC;QACN,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACnE,KAAK,CACH,iCAAiC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,cAAc,CAAC,IAAI,CAAC,GAAG,GAAG,CAC5H,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,IAAI,EAAE;gBACJ,MAAM;gBACN,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,IAAI;aACL;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GACV,UAAU,CAAC,MAAM,CAAC,MAAM;YACxB,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;gBACzD,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,SAAS,CAAC,CAAC;QACjB,MAAM,QAAQ,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,OAAO,GACX,MAAM,KAAK,QAAQ;YACjB,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,0CAA0C;gBAC5C,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;QACpC,IAAI,SAAS,KAAK,SAAS;YACzB,KAAK,CAAC,oBAAoB,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,OAAO;SACf,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,qBAAqB,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CACH,0DAA0D,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAC7F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAyC;IAEzC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAW,EAAE;QAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAC7C,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CACtE,CAAC;QACJ,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,SAAS;QACX,CAAC,CAAE,YAAY,CAAC,IAAI,CAA6B,CAAC;AACtD,CAAC","sourcesContent":["import type { CodexSecurity, ScanAuthMode } from \"./api.js\";\nimport type { BulkScanPrompt } from \"./bulk-scan-discovery.js\";\nimport type { CodexSecurityConfig } from \"./config.js\";\nimport { formatScanCost } from \"./cost-model.js\";\nimport { safeErrorMessage } from \"./errors.js\";\nimport {\n formatSecurityPolicyText as display,\n type SecurityPolicyOptions,\n type SecurityPolicyStage,\n} from \"./security-policy.js\";\n\ntype SignalName = \"SIGINT\" | \"SIGTERM\";\ntype Output = { write(value: string): unknown };\nexport type PolicyPrompt = Pick<BulkScanPrompt, \"isInteractive\" | \"input\">;\nexport type PolicySecurity = Pick<\n CodexSecurity,\n \"generatePolicy\" | \"preflightPolicy\" | \"previewPolicy\" | \"close\"\n>;\n\nexport interface PolicyCommandOptions {\n repository: string;\n config: CodexSecurityConfig;\n generation: SecurityPolicyOptions;\n headless: boolean;\n dryRun: boolean;\n format: string;\n explicitOutput: boolean;\n}\n\nexport interface PolicyCommandDependencies {\n createSecurity(config: CodexSecurityConfig): PolicySecurity;\n chooseAuthentication(\n config: CodexSecurityConfig,\n auth: ScanAuthMode | undefined,\n signal: AbortSignal,\n ): Promise<ScanAuthMode | undefined>;\n prompt: PolicyPrompt;\n environment: NodeJS.ProcessEnv;\n errorOutput: Output;\n now(): number;\n addSignalListener(signal: SignalName, listener: () => void): void;\n removeSignalListener(signal: SignalName, listener: () => void): void;\n forceExit(signal: SignalName): void;\n}\n\nconst STAGES: Record<SecurityPolicyStage, string> = {\n architecture: \"[1/3] Understanding the system and its security boundaries\",\n threat_model: \"[2/3] Building the source-backed threat model\",\n policy: \"[3/3] Drafting SECURITY.md\",\n};\n\nexport async function runPolicyCommand(\n options: PolicyCommandOptions,\n dependencies: PolicyCommandDependencies,\n): Promise<{\n exitCode: number;\n data?: Record<string, unknown>;\n markdown?: string;\n error?: string;\n}> {\n const { errorOutput, prompt } = dependencies;\n const controller = new AbortController();\n const interactive =\n !options.headless &&\n options.format === \"toon\" &&\n dependencies.environment[\"CI\"] === undefined &&\n prompt.isInteractive();\n const started = dependencies.now();\n let security: PolicySecurity | undefined;\n let outputDir: string | undefined;\n const write = (message: string): void => {\n try {\n errorOutput.write(`${message}\\n`);\n } catch {}\n };\n let firstSignalAt = 0;\n const signalListener = (signal: SignalName) => () => {\n if (controller.signal.aborted) {\n // Match scan's handling of duplicate initial signals from launchers.\n if (\n controller.signal.reason === signal &&\n dependencies.now() - firstSignalAt < 500\n )\n return;\n removeSignalListeners();\n dependencies.forceExit(signal);\n return;\n }\n firstSignalAt = dependencies.now();\n controller.abort(signal);\n };\n const interrupt = signalListener(\"SIGINT\");\n const terminate = signalListener(\"SIGTERM\");\n const removeSignalListeners = () => {\n dependencies.removeSignalListener(\"SIGINT\", interrupt);\n dependencies.removeSignalListener(\"SIGTERM\", terminate);\n };\n dependencies.addSignalListener(\"SIGINT\", interrupt);\n dependencies.addSignalListener(\"SIGTERM\", terminate);\n try {\n const auth =\n interactive && !options.dryRun\n ? await dependencies.chooseAuthentication(\n options.config,\n options.generation.auth,\n controller.signal,\n )\n : options.generation.auth;\n controller.signal.throwIfAborted();\n security = dependencies.createSecurity(options.config);\n if (options.dryRun) {\n const preflight = await security.preflightPolicy(options.repository, {\n ...options.generation,\n signal: controller.signal,\n });\n controller.signal.throwIfAborted();\n return {\n exitCode: 0,\n data: {\n ...preflight,\n dryRun: true,\n },\n };\n }\n const draft = await security.generatePolicy(options.repository, {\n ...options.generation,\n auth,\n signal: controller.signal,\n onOutputDirReady: (directory) => {\n outputDir = directory;\n write(`Policy artifacts: ${display(directory)}`);\n },\n onStage: (stage) => write(STAGES[stage]),\n onWarning: (warning) =>\n write(`codex-security: ${display(safeErrorMessage(warning))}`),\n ...(interactive\n ? {\n answerQuestions: async (\n questions: readonly string[],\n signal: AbortSignal,\n ) => {\n write(\n \"A few details could change this policy. Leave an answer blank to keep it unresolved.\",\n );\n const answers: string[] = [];\n for (const question of questions) {\n signal.throwIfAborted();\n const answer = await prompt.input(\n display(question),\n undefined,\n signal,\n );\n if (answer.trim()) answers.push(`${question}\\n${answer}`);\n }\n return answers.join(\"\\n\\n\");\n },\n }\n : {}),\n });\n controller.signal.throwIfAborted();\n const cost = draft.cost;\n const changed = draft.previousContent !== draft.content;\n const humanOutput = options.format === \"toon\" && !options.explicitOutput;\n if (humanOutput) {\n let diff: string;\n try {\n diff = await security.previewPolicy(draft, {\n signal: controller.signal,\n });\n } catch (error) {\n controller.signal.throwIfAborted();\n diff = \"Preview unavailable. Review the saved draft.\";\n write(\n `codex-security: Could not preview the policy: ${display(safeErrorMessage(error))}`,\n );\n }\n const preview = [\n `\\nPolicy target: ${display(draft.targetPath)}`,\n diff.replace(/\\n$/u, \"\") || \"SECURITY.md is already up to date.\",\n ...(draft.reviewNotes.length === 0\n ? []\n : [\n \"\\nOwner review:\",\n ...draft.reviewNotes.map((note) => `- ${display(note)}`),\n ]),\n ].join(\"\\n\");\n write(preview);\n }\n controller.signal.throwIfAborted();\n const status = changed ? \"draft\" : \"unchanged\";\n if (humanOutput) {\n write(`\\nDraft: ${display(draft.draftPath)}`);\n write(`Architecture: ${display(draft.specificationPath)}`);\n write(`Threat model: ${display(draft.threatModelPath)}`);\n if (changed)\n write(\n \"No repository files changed. Review the saved SECURITY.md before copying it into the repository.\",\n );\n }\n const seconds = Math.max(0, (dependencies.now() - started) / 1000);\n write(\n `Policy generation finished in ${seconds.toFixed(1)}s${cost === null ? \"\" : ` (estimated cost: ${formatScanCost(cost)})`}.`,\n );\n return {\n exitCode: 0,\n markdown: draft.content,\n data: {\n status,\n repository: draft.repository,\n scope: draft.scope,\n targetPath: draft.targetPath,\n outputDir: draft.outputDir,\n draftPath: draft.draftPath,\n specificationPath: draft.specificationPath,\n threatModelPath: draft.threatModelPath,\n customPlugin: draft.customPlugin,\n reviewNotes: draft.reviewNotes,\n cost,\n },\n };\n } catch (error) {\n const signal =\n controller.signal.reason ??\n (error instanceof Error && error.name === \"ExitPromptError\"\n ? \"SIGINT\"\n : undefined);\n const exitCode = signal === \"SIGINT\" ? 130 : signal === \"SIGTERM\" ? 143 : 2;\n const message =\n signal === \"SIGINT\"\n ? \"Policy generation canceled by Ctrl-C.\"\n : signal === \"SIGTERM\"\n ? \"Policy generation terminated by SIGTERM.\"\n : display(safeErrorMessage(error));\n write(`codex-security: ${message}`);\n if (outputDir !== undefined)\n write(`Saved artifacts: ${display(outputDir)}`);\n return {\n exitCode,\n error: message,\n };\n } finally {\n removeSignalListeners();\n try {\n await security?.close();\n } catch (error) {\n write(\n `codex-security: Could not clean up the policy runtime: ${display(safeErrorMessage(error))}`,\n );\n }\n }\n}\n\nexport function policyDisplayData(\n data: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n const displayValue = (value: unknown): unknown => {\n if (typeof value === \"string\") return display(value);\n if (Array.isArray(value)) return value.map(displayValue);\n if (value !== null && typeof value === \"object\")\n return Object.fromEntries(\n Object.entries(value).map(([key, item]) => [key, displayValue(item)]),\n );\n return value;\n };\n return data === undefined\n ? undefined\n : (displayValue(data) as Record<string, unknown>);\n}\n"]}
1
+ {"version":3,"file":"security-policy-cli.js","sourceRoot":"","sources":["../src/security-policy-cli.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CodexSecurity, ScanAuthMode } from \"./api.js\";\nimport type { BulkScanPrompt } from \"./bulk-scan-discovery.js\";\nimport type { CodexSecurityConfig } from \"./config.js\";\nimport { formatScanCost } from \"./cost-model.js\";\nimport { errorMessage } from \"./errors.js\";\nimport {\n formatSecurityPolicyText as display,\n type SecurityPolicyOptions,\n type SecurityPolicyStage,\n} from \"./security-policy.js\";\n\ntype SignalName = \"SIGINT\" | \"SIGTERM\";\ntype Output = { write(value: string): unknown };\nexport type PolicyPrompt = Pick<BulkScanPrompt, \"isInteractive\" | \"input\">;\nexport type PolicySecurity = Pick<\n CodexSecurity,\n \"generatePolicy\" | \"preflightPolicy\" | \"previewPolicy\" | \"close\"\n>;\n\nexport interface PolicyCommandOptions {\n repository: string;\n config: CodexSecurityConfig;\n generation: SecurityPolicyOptions;\n headless: boolean;\n dryRun: boolean;\n format: string;\n explicitOutput: boolean;\n}\n\nexport interface PolicyCommandDependencies {\n createSecurity(config: CodexSecurityConfig): PolicySecurity;\n chooseAuthentication(\n config: CodexSecurityConfig,\n auth: ScanAuthMode | undefined,\n signal: AbortSignal,\n ): Promise<ScanAuthMode | undefined>;\n prompt: PolicyPrompt;\n environment: NodeJS.ProcessEnv;\n errorOutput: Output;\n now(): number;\n addSignalListener(signal: SignalName, listener: () => void): void;\n removeSignalListener(signal: SignalName, listener: () => void): void;\n forceExit(signal: SignalName): void;\n}\n\nconst STAGES: Record<SecurityPolicyStage, string> = {\n architecture: \"[1/3] Understanding the system and its security boundaries\",\n threat_model: \"[2/3] Building the source-backed threat model\",\n policy: \"[3/3] Drafting SECURITY.md\",\n};\n\nexport async function runPolicyCommand(\n options: PolicyCommandOptions,\n dependencies: PolicyCommandDependencies,\n): Promise<{\n exitCode: number;\n data?: Record<string, unknown>;\n markdown?: string;\n error?: string;\n}> {\n const { errorOutput, prompt } = dependencies;\n const controller = new AbortController();\n const interactive =\n !options.headless &&\n options.format === \"toon\" &&\n dependencies.environment[\"CI\"] === undefined &&\n prompt.isInteractive();\n const started = dependencies.now();\n let security: PolicySecurity | undefined;\n let outputDir: string | undefined;\n const write = (message: string): void => {\n try {\n errorOutput.write(`${message}\\n`);\n } catch {}\n };\n let firstSignalAt = 0;\n const signalListener = (signal: SignalName) => () => {\n if (controller.signal.aborted) {\n // Match scan's handling of duplicate initial signals from launchers.\n if (\n controller.signal.reason === signal &&\n dependencies.now() - firstSignalAt < 500\n )\n return;\n removeSignalListeners();\n dependencies.forceExit(signal);\n return;\n }\n firstSignalAt = dependencies.now();\n controller.abort(signal);\n };\n const interrupt = signalListener(\"SIGINT\");\n const terminate = signalListener(\"SIGTERM\");\n const removeSignalListeners = () => {\n dependencies.removeSignalListener(\"SIGINT\", interrupt);\n dependencies.removeSignalListener(\"SIGTERM\", terminate);\n };\n dependencies.addSignalListener(\"SIGINT\", interrupt);\n dependencies.addSignalListener(\"SIGTERM\", terminate);\n try {\n const auth =\n interactive && !options.dryRun\n ? await dependencies.chooseAuthentication(\n options.config,\n options.generation.auth,\n controller.signal,\n )\n : options.generation.auth;\n controller.signal.throwIfAborted();\n security = dependencies.createSecurity(options.config);\n if (options.dryRun) {\n const preflight = await security.preflightPolicy(options.repository, {\n ...options.generation,\n signal: controller.signal,\n });\n controller.signal.throwIfAborted();\n return {\n exitCode: 0,\n data: {\n ...preflight,\n dryRun: true,\n },\n };\n }\n const draft = await security.generatePolicy(options.repository, {\n ...options.generation,\n auth,\n signal: controller.signal,\n onOutputDirReady: (directory) => {\n outputDir = directory;\n write(`Policy artifacts: ${display(directory)}`);\n },\n onStage: (stage) => write(STAGES[stage]),\n onWarning: (warning) =>\n write(`codex-security: ${display(errorMessage(warning))}`),\n ...(interactive\n ? {\n answerQuestions: async (\n questions: readonly string[],\n signal: AbortSignal,\n ) => {\n write(\n \"A few details could change this policy. Leave an answer blank to keep it unresolved.\",\n );\n const answers: string[] = [];\n for (const question of questions) {\n signal.throwIfAborted();\n const answer = await prompt.input(\n display(question),\n undefined,\n signal,\n );\n if (answer.trim()) answers.push(`${question}\\n${answer}`);\n }\n return answers.join(\"\\n\\n\");\n },\n }\n : {}),\n });\n controller.signal.throwIfAborted();\n const cost = draft.cost;\n const changed = draft.previousContent !== draft.content;\n const humanOutput = options.format === \"toon\" && !options.explicitOutput;\n if (humanOutput) {\n let diff: string;\n try {\n diff = await security.previewPolicy(draft, {\n signal: controller.signal,\n });\n } catch (error) {\n controller.signal.throwIfAborted();\n diff = \"Preview unavailable. Review the saved draft.\";\n write(\n `codex-security: Could not preview the policy: ${display(errorMessage(error))}`,\n );\n }\n const preview = [\n `\\nPolicy target: ${display(draft.targetPath)}`,\n diff.replace(/\\n$/u, \"\") || \"SECURITY.md is already up to date.\",\n ...(draft.reviewNotes.length === 0\n ? []\n : [\n \"\\nOwner review:\",\n ...draft.reviewNotes.map((note) => `- ${display(note)}`),\n ]),\n ].join(\"\\n\");\n write(preview);\n }\n controller.signal.throwIfAborted();\n const status = changed ? \"draft\" : \"unchanged\";\n if (humanOutput) {\n write(`\\nDraft: ${display(draft.draftPath)}`);\n write(`Architecture: ${display(draft.specificationPath)}`);\n if (draft.threatModelPath !== null)\n write(`Threat model: ${display(draft.threatModelPath)}`);\n if (changed)\n write(\n \"No repository files changed. Review the saved SECURITY.md before copying it into the repository.\",\n );\n }\n const seconds = Math.max(0, (dependencies.now() - started) / 1000);\n write(\n `Policy generation finished in ${seconds.toFixed(1)}s${cost === null ? \"\" : ` (estimated cost: ${formatScanCost(cost)})`}.`,\n );\n return {\n exitCode: 0,\n markdown: draft.content,\n data: {\n status,\n repository: draft.repository,\n scope: draft.scope,\n targetPath: draft.targetPath,\n outputDir: draft.outputDir,\n draftPath: draft.draftPath,\n specificationPath: draft.specificationPath,\n threatModelPath: draft.threatModelPath,\n threatModel: draft.threatModel,\n customPlugin: draft.customPlugin,\n reviewNotes: draft.reviewNotes,\n cost,\n },\n };\n } catch (error) {\n const signal =\n controller.signal.reason ??\n (error instanceof Error && error.name === \"ExitPromptError\"\n ? \"SIGINT\"\n : undefined);\n const exitCode = signal === \"SIGINT\" ? 130 : signal === \"SIGTERM\" ? 143 : 2;\n const message =\n signal === \"SIGINT\"\n ? \"Policy generation canceled by Ctrl-C.\"\n : signal === \"SIGTERM\"\n ? \"Policy generation terminated by SIGTERM.\"\n : display(errorMessage(error));\n write(`codex-security: ${message}`);\n if (outputDir !== undefined)\n write(`Saved artifacts: ${display(outputDir)}`);\n return {\n exitCode,\n error: message,\n };\n } finally {\n removeSignalListeners();\n try {\n await security?.close();\n } catch (error) {\n write(\n `codex-security: Could not clean up the policy runtime: ${display(errorMessage(error))}`,\n );\n }\n }\n}\n\nexport function policyDisplayData(\n data: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n const displayValue = (value: unknown): unknown => {\n if (typeof value === \"string\") return display(value);\n if (Array.isArray(value)) return value.map(displayValue);\n if (value !== null && typeof value === \"object\")\n return Object.fromEntries(\n Object.entries(value).map(([key, item]) => [key, displayValue(item)]),\n );\n return value;\n };\n return data === undefined\n ? undefined\n : (displayValue(data) as Record<string, unknown>);\n}\n"]}
@@ -1,5 +1,7 @@
1
1
  import type { ScanAuthentication, ScanOptions } from "./api.js";
2
+ import type { ScanModelConfiguration } from "./config.js";
2
3
  import type { ScanCost } from "./cost.js";
4
+ import type { ThreatModel } from "./models.js";
3
5
  import { type ProcessEnvironment } from "./runtime.js";
4
6
  export type SecurityPolicyStage = "architecture" | "threat_model" | "policy";
5
7
  export interface SecurityPolicyOptions extends Pick<ScanOptions, "auth" | "knowledgeBasePaths" | "outputDir" | "maxCostUsd" | "signal" | "onAuthentication" | "onOutputDirReady" | "onCost" | "onWarning" | "onObserverError"> {
@@ -14,11 +16,9 @@ export interface SecurityPolicyTarget {
14
16
  }
15
17
  export declare function requireSecurityPolicyRepositoryBinding(target: SecurityPolicyTarget, signal?: AbortSignal): Promise<void>;
16
18
  export declare function securityPolicyProtectedRoots(target: SecurityPolicyTarget, signal?: AbortSignal): Promise<string[]>;
17
- export interface SecurityPolicyPreflight extends SecurityPolicyTarget {
19
+ export interface SecurityPolicyPreflight extends SecurityPolicyTarget, ScanModelConfiguration {
18
20
  outputDir: string | null;
19
21
  authentication: ScanAuthentication;
20
- model: string;
21
- reasoningEffort: string;
22
22
  maxCostUsd?: number;
23
23
  }
24
24
  export interface SecurityPolicyStageResult {
@@ -37,7 +37,8 @@ export interface SecurityPolicyDraft extends SecurityPolicyTarget, SecurityPolic
37
37
  outputDir: string;
38
38
  draftPath: string;
39
39
  specificationPath: string;
40
- threatModelPath: string;
40
+ threatModelPath: string | null;
41
+ threatModel: ThreatModel;
41
42
  content: string;
42
43
  customPlugin: boolean;
43
44
  pluginPath?: string;
@@ -67,7 +68,10 @@ export declare function runSecurityPolicyStages(options: {
67
68
  model: string;
68
69
  reasoningEffort: string;
69
70
  pluginVersion: string;
71
+ pythonPath?: string;
72
+ protectedRoot?: string;
70
73
  signal: AbortSignal;
74
+ onWarning?: (message: string) => void;
71
75
  onStage?: SecurityPolicyOptions["onStage"];
72
76
  answerQuestions?: SecurityPolicyOptions["answerQuestions"];
73
77
  run(stage: SecurityPolicyStage, prompt: string): Promise<SecurityPolicyStageResult>;
@@ -1 +1 @@
1
- {"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"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"}
@@ -1,14 +1,16 @@
1
1
  import { execFile } from "node:child_process";
2
- import { createHash } from "node:crypto";
2
+ import { randomUUID } from "node:crypto";
3
+ import { sha256Text as digest } from "./contract.js";
3
4
  import { constants } from "node:fs";
4
- import { lstat, open, readdir, readFile, readlink, realpath, stat, } from "node:fs/promises";
5
+ import { lstat, open, readdir, readFile, readlink, realpath, rename, rm, stat, } from "node:fs/promises";
5
6
  import { basename, dirname, isAbsolute, join, relative, resolve, sep, } from "node:path";
6
7
  import { promisify } from "node:util";
7
8
  import { z } from "incur";
8
9
  import { jsonForPrompt } from "./codex-prompt.js";
10
+ import { writeThreatModel } from "./artifact-export.js";
9
11
  import { CodexSecurityError, InvalidTargetError } from "./errors.js";
10
12
  import { resolvePluginPython } from "./runtime.js";
11
- import { abortable, enclosingGitWorktreeRoot, enclosingGitWorktreeRoots, gitMetadataDirectories, gitObjectDirectories, isGitMetadataDirectory, normalizeRepository, normalizeTarget, relativePathIsOutside, } from "./targets.js";
13
+ import { nullIfMissingFile, nullIfMissingPath, abortable, enclosingGitWorktreeRoot, enclosingGitWorktreeRoots, gitMetadataDirectories, gitObjectDirectories, isGitMetadataDirectory, normalizeRepository, normalizeTarget, relativePathIsOutside, } from "./targets.js";
12
14
  const securityPolicyRepositoryBindings = new WeakMap();
13
15
  export async function requireSecurityPolicyRepositoryBinding(target, signal) {
14
16
  const binding = securityPolicyRepositoryBindings.get(target);
@@ -90,11 +92,7 @@ export async function resolveSecurityPolicyTarget(repository, path = ".", signal
90
92
  return target;
91
93
  }
92
94
  export async function readSecurityPolicy(path) {
93
- const metadata = await lstat(path).catch((error) => {
94
- if (error.code === "ENOENT")
95
- return null;
96
- throw error;
97
- });
95
+ const metadata = await lstat(path).catch(nullIfMissingFile);
98
96
  if (metadata === null)
99
97
  return null;
100
98
  if (!metadata.isFile()) {
@@ -132,22 +130,14 @@ async function readPolicyFile(path, options = {}) {
132
130
  export async function readSecurityPolicySnapshot(target, signal, gitMetadataPaths = []) {
133
131
  await requirePolicyOutsideGitMetadata(target.targetPath, signal, gitMetadataPaths);
134
132
  const previousContent = await readSecurityPolicy(target.targetPath);
135
- const canonicalTarget = await realpath(target.targetPath).catch((error) => {
136
- if (error.code === "ENOENT")
137
- return null;
138
- throw error;
139
- });
133
+ const canonicalTarget = await realpath(target.targetPath).catch(nullIfMissingFile);
140
134
  const inherited = [];
141
135
  let directory = target.repository;
142
136
  for (const part of target.scope === "." ? [] : target.scope.split("/")) {
143
137
  signal?.throwIfAborted();
144
138
  const path = join(directory, "SECURITY.md");
145
139
  const policyPath = relative(target.repository, path).split(sep).join("/");
146
- let metadata = await lstat(path).catch((error) => {
147
- if (error.code === "ENOENT" || error.code === "ENOTDIR")
148
- return null;
149
- throw error;
150
- });
140
+ let metadata = await lstat(path).catch(nullIfMissingPath);
151
141
  if (metadata?.isSymbolicLink()) {
152
142
  const alias = await policyLinkSnapshot(path, target.repository, signal, gitMetadataPaths);
153
143
  if (alias.status === "cycle") {
@@ -159,11 +149,7 @@ export async function readSecurityPolicySnapshot(target, signal, gitMetadataPath
159
149
  throw new CodexSecurityError(`SECURITY.md ${JSON.stringify(policyPath)} points to the selected policy and would change guidance outside the selected component. Fix the link before drafting a policy.`);
160
150
  const links = { links: alias.links, destination: alias.destination };
161
151
  inherited.push([policyPath, `link:${digest(JSON.stringify(links))}`]);
162
- metadata = await stat(path).catch((error) => {
163
- if (error.code === "ENOENT" || error.code === "ENOTDIR")
164
- return null;
165
- throw error;
166
- });
152
+ metadata = await stat(path).catch(nullIfMissingPath);
167
153
  }
168
154
  if (metadata?.isFile()) {
169
155
  const normalized = await normalizeTarget(target.repository, [path], signal);
@@ -204,11 +190,7 @@ async function policyLinkSnapshot(path, repository, signal, gitMetadataPaths = [
204
190
  const relativePath = policyRelativePath(repository, canonical);
205
191
  if (!(await stat(parent)).isDirectory())
206
192
  return { links, destination: null, status: "missing" };
207
- const metadata = await lstat(canonical).catch((error) => {
208
- if (error.code === "ENOENT" || error.code === "ENOTDIR")
209
- return null;
210
- throw error;
211
- });
193
+ const metadata = await lstat(canonical).catch(nullIfMissingPath);
212
194
  if (metadata !== null || links.length > 0)
213
195
  await requirePolicyOutsideGitMetadata(canonical, signal, gitMetadataPaths);
214
196
  if (!metadata?.isSymbolicLink())
@@ -262,13 +244,8 @@ async function securityPolicyPaths(root, repository, signal) {
262
244
  }
263
245
  for (const name of [".github", "docs"]) {
264
246
  let directory = join(repository, name);
265
- const metadata = await lstat(directory).catch((error) => {
266
- if (error.code === "ENOENT" || error.code === "ENOTDIR")
267
- return null;
268
- throw error;
269
- });
270
247
  // Keep directory links distinct from their destinations.
271
- if (metadata?.isDirectory()) {
248
+ if ((await lstat(directory).catch(nullIfMissingPath))?.isDirectory()) {
272
249
  directory = await realpath(directory);
273
250
  policyRelativePath(repository, directory);
274
251
  }
@@ -285,30 +262,18 @@ async function securityPolicyPaths(root, repository, signal) {
285
262
  const entries = await readdir(directory, { withFileTypes: true });
286
263
  if (await isGitMetadataDirectory(directory, signal)) {
287
264
  gitDirectories.add(directory);
288
- const common = await readFile(join(directory, "commondir"), "utf8").catch((error) => {
289
- if (error.code === "ENOENT")
290
- return null;
291
- throw error;
292
- });
265
+ const common = await readFile(join(directory, "commondir"), "utf8").catch(nullIfMissingFile);
293
266
  if (common !== null)
294
267
  gitDirectories.add(await realpath(resolve(directory, common.replace(/[\r\n]+$/u, ""))));
295
268
  continue;
296
269
  }
297
270
  if (!knownRoots.has(directory) &&
298
271
  entries.some((entry) => entry.name.toLowerCase() === ".git") &&
299
- (await lstat(join(directory, ".git")).catch((error) => {
300
- if (error.code === "ENOENT")
301
- return null;
302
- throw error;
303
- })) !== null) {
272
+ (await lstat(join(directory, ".git")).catch(nullIfMissingFile)) !== null) {
304
273
  await addRoot(directory);
305
274
  }
306
275
  const path = join(directory, "SECURITY.md");
307
- const metadata = await lstat(path).catch((error) => {
308
- if (error.code === "ENOENT" || error.code === "ENOTDIR")
309
- return null;
310
- throw error;
311
- });
276
+ const metadata = await lstat(path).catch(nullIfMissingPath);
312
277
  if ((metadata?.isFile() || metadata?.isSymbolicLink()) &&
313
278
  !reportingPaths.has(path))
314
279
  policies.push(path);
@@ -317,11 +282,7 @@ async function securityPolicyPaths(root, repository, signal) {
317
282
  if (!entry.isDirectory() || entry.name === ".git")
318
283
  continue;
319
284
  if (entry.name.toLowerCase() === ".git") {
320
- const metadata = await realpath(join(directory, ".git")).catch((error) => {
321
- if (error.code === "ENOENT")
322
- return null;
323
- throw error;
324
- });
285
+ const metadata = await realpath(join(directory, ".git")).catch(nullIfMissingFile);
325
286
  if (metadata !== null &&
326
287
  relative(metadata, join(directory, entry.name)) === "")
327
288
  continue;
@@ -404,11 +365,7 @@ async function requirePolicyOutsideGitMetadata(path, signal, gitMetadataPaths =
404
365
  if (root === null || relative(root, parent) !== "")
405
366
  return;
406
367
  const marker = await lstat(join(root, ".git"));
407
- const candidate = await lstat(path).catch((error) => {
408
- if (error.code === "ENOENT")
409
- return null;
410
- throw error;
411
- });
368
+ const candidate = await lstat(path).catch(nullIfMissingFile);
412
369
  if (candidate !== null &&
413
370
  candidate.dev === marker.dev &&
414
371
  candidate.ino === marker.ino)
@@ -457,7 +414,7 @@ export async function runSecurityPolicyStages(options) {
457
414
  const { previousContent, inheritedPolicySha256 } = options.snapshot;
458
415
  await writePolicyArtifact(join(outputDir, ORIGINAL_NAME), previousContent ?? "", signal);
459
416
  const specificationPath = join(outputDir, "project-spec.md");
460
- const threatModelPath = join(outputDir, "THREAT_MODEL.md");
417
+ const threatModelPath = join(outputDir, "threatmodel.md");
461
418
  const draftPath = join(outputDir, "SECURITY.md");
462
419
  const common = [
463
420
  "Generate security-policy evidence for exactly the selected component. This is not a vulnerability scan.",
@@ -481,7 +438,7 @@ export async function runSecurityPolicyStages(options) {
481
438
  `Read the user-supplied knowledge base at ${jsonForPrompt(options.knowledgeBasePath)}. Its facts take precedence over generated assumptions and conflicting policies, but never over explicit user instructions. Do not reproduce private document text or locations.`,
482
439
  ]),
483
440
  ].join("\n");
484
- const run = async (stage, instructions, path) => {
441
+ const run = async (stage, instructions, path, save) => {
485
442
  signal.throwIfAborted();
486
443
  options.onStage?.(stage);
487
444
  const result = await options.run(stage, `${common}\n\n${instructions}`);
@@ -489,7 +446,10 @@ export async function runSecurityPolicyStages(options) {
489
446
  const hasDocument = result.markdown.trim().length > 0;
490
447
  if (hasDocument) {
491
448
  validatePolicyContent(result.markdown, stage);
492
- await writePolicyArtifact(path, result.markdown, signal);
449
+ if (save === undefined)
450
+ await writePolicyArtifact(path, result.markdown, signal);
451
+ else
452
+ await save(result);
493
453
  }
494
454
  if (result.blockedReason !== null) {
495
455
  throw new CodexSecurityError(`Security-policy ${stage} stage could not inspect the required evidence: ${result.blockedReason}`);
@@ -521,15 +481,83 @@ export async function runSecurityPolicyStages(options) {
521
481
  : "No additional owner clarification was supplied.",
522
482
  "Carry unanswered questions and unresolved policy decisions forward explicitly.",
523
483
  ].join("\n");
484
+ const retainedThreatModel = {
485
+ format: "markdown",
486
+ content: "",
487
+ scope: { includePaths: [target.scope], excludePaths: [] },
488
+ origin: "generated",
489
+ };
490
+ const manifest = {
491
+ documentType: "codex-security.policy-draft",
492
+ schemaVersion: "1.0",
493
+ repository: target.repository,
494
+ scope: target.scope,
495
+ createdAt: new Date().toISOString(),
496
+ revision: options.revision,
497
+ previousPolicySha256: previousContent === null ? null : digest(previousContent),
498
+ inheritedPolicySha256,
499
+ model: options.model,
500
+ reasoningEffort: options.reasoningEffort,
501
+ pluginVersion: options.pluginVersion,
502
+ customPlugin: options.pluginPath !== undefined,
503
+ status: "threat_model_ready",
504
+ threatModel: retainedThreatModel,
505
+ reviewNotes: [],
506
+ };
507
+ const saveManifest = async () => {
508
+ const temporary = join(outputDir, `.policy-draft-${randomUUID()}.json`);
509
+ try {
510
+ await writePolicyArtifact(temporary, `${JSON.stringify(manifest, null, 2)}\n`, signal);
511
+ await rename(temporary, join(outputDir, MANIFEST_NAME));
512
+ }
513
+ finally {
514
+ await rm(temporary, { force: true }).catch(() => undefined);
515
+ }
516
+ };
517
+ const saveModelDocument = async () => {
518
+ let warning;
519
+ try {
520
+ warning = await writeThreatModel(outputDir, {
521
+ pluginRoot: options.pluginRoot,
522
+ pythonPath: options.pythonPath,
523
+ protectedRoot: options.protectedRoot,
524
+ signal,
525
+ });
526
+ }
527
+ catch (error) {
528
+ signal.throwIfAborted();
529
+ warning = `Could not save threatmodel.md; the retained threat model remains exportable: ${error instanceof Error ? error.message : String(error)}`;
530
+ }
531
+ if (warning) {
532
+ try {
533
+ options.onWarning?.(warning);
534
+ }
535
+ catch { }
536
+ }
537
+ signal.throwIfAborted();
538
+ return warning ? null : threatModelPath;
539
+ };
524
540
  const threatModel = await run("threat_model", [
525
541
  `Read the completed project specification at ${jsonForPrompt(specificationPath)}. Preserve it as the architecture inventory.`,
526
542
  "Retain its full repository-relative citations and verify any new source references.",
527
543
  ownerContext,
528
544
  "Produce the full standalone Markdown model described by the shared threat-model guide. Derive realistic attacker stories from the established boundaries, including starting capabilities, meaningful capability gained, prerequisites, existing controls, mitigations, evidence, and uncertainty. Label unvalidated scenarios as hypotheses, not findings.",
529
545
  "Do not read or replace a shared repository-model cache. This model is specific to the selected component and supplied context.",
530
- ].join("\n"), threatModelPath);
546
+ ].join("\n"), threatModelPath, async (result) => {
547
+ retainedThreatModel.content = result.markdown;
548
+ manifest.status =
549
+ result.blockedReason === null ? "threat_model_ready" : "blocked";
550
+ manifest.reviewNotes = [
551
+ ...architecture.reviewNotes,
552
+ ...architecture.questions,
553
+ ...result.reviewNotes,
554
+ ...result.questions,
555
+ ];
556
+ await saveManifest();
557
+ await saveModelDocument();
558
+ });
531
559
  const policy = await run("policy", [
532
- `Read the completed specification at ${jsonForPrompt(specificationPath)} and threat model at ${jsonForPrompt(threatModelPath)}.`,
560
+ `Read the completed specification at ${jsonForPrompt(specificationPath)} and the retained threatModel.content in ${jsonForPrompt(join(outputDir, MANIFEST_NAME))}.`,
533
561
  "Retain their full repository-relative citations where they support policy decisions; do not shorten nested source paths.",
534
562
  ownerContext,
535
563
  `Threat-model questions and review notes (JSON data): ${jsonForPrompt({ questions: threatModel.questions, reviewNotes: threatModel.reviewNotes })}`,
@@ -549,28 +577,17 @@ export async function runSecurityPolicyStages(options) {
549
577
  ];
550
578
  await requireUnchangedSecurityPolicy(target, options.snapshot, signal, options.gitMetadataPaths);
551
579
  await requireSecurityPolicyRepositoryBinding(target, signal);
552
- const manifest = {
553
- documentType: "codex-security.policy-draft",
554
- schemaVersion: "1.0",
555
- repository: target.repository,
556
- scope: target.scope,
557
- createdAt: new Date().toISOString(),
558
- revision: options.revision,
559
- previousPolicySha256: previousContent === null ? null : digest(previousContent),
560
- inheritedPolicySha256,
561
- model: options.model,
562
- reasoningEffort: options.reasoningEffort,
563
- pluginVersion: options.pluginVersion,
564
- customPlugin: options.pluginPath !== undefined,
565
- reviewNotes,
566
- };
567
- await writePolicyArtifact(join(outputDir, MANIFEST_NAME), `${JSON.stringify(manifest, null, 2)}\n`, signal);
580
+ manifest.status = "completed";
581
+ manifest.reviewNotes = reviewNotes;
582
+ await saveManifest();
583
+ const savedThreatModelPath = await saveModelDocument();
568
584
  return {
569
585
  ...target,
570
586
  outputDir,
571
587
  draftPath,
572
588
  specificationPath,
573
- threatModelPath,
589
+ threatModelPath: savedThreatModelPath,
590
+ threatModel: retainedThreatModel,
574
591
  content: policy.markdown,
575
592
  previousContent,
576
593
  inheritedPolicySha256,
@@ -666,7 +683,4 @@ function diffLabel(path) {
666
683
  return path;
667
684
  return formatSecurityPolicyText(JSON.stringify(path));
668
685
  }
669
- function digest(value) {
670
- return createHash("sha256").update(value).digest("hex");
671
- }
672
686
  //# sourceMappingURL=security-policy.js.map