@openai/codex-security 0.1.31 → 0.3.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 (514) hide show
  1. package/README.md +442 -2434
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +3 -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 +7 -214
  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 +563 -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 +5 -5
  25. package/_bundled_plugin/references/config-preflight.md +1 -5
  26. package/_bundled_plugin/references/core-scan.md +34 -10
  27. package/_bundled_plugin/references/final-report.md +13 -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 +3 -4
  31. package/_bundled_plugin/references/scan-contract.md +11 -6
  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 +2 -2
  36. package/_bundled_plugin/schemas/coverage.schema.json +23 -47
  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 +71 -192
  40. package/_bundled_plugin/schemas/scan-manifest.schema.json +83 -95
  41. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  42. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  43. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  44. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  45. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  46. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +245 -356
  47. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  48. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  49. package/_bundled_plugin/scripts/config_preflight.py +29 -69
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
  52. package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
  54. package/_bundled_plugin/scripts/finding_preview.py +81 -91
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
  56. package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +43 -902
  60. package/_bundled_plugin/scripts/report_projection.py +143 -219
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
  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 +59 -9
  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 +21 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +99 -190
  70. package/_bundled_plugin/scripts/workbench_constants.py +6 -14
  71. package/_bundled_plugin/scripts/workbench_db.py +524 -672
  72. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  73. package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
  74. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  75. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  76. package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
  77. package/_bundled_plugin/scripts/workbench_progress.py +26 -92
  78. package/_bundled_plugin/scripts/workbench_publication.py +77 -116
  79. package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
  80. package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
  81. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  82. package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
  83. package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
  84. package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
  85. package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
  86. package/_bundled_plugin/scripts/workbench_target.py +526 -150
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
  88. package/_bundled_plugin/scripts/workbench_validation.py +19 -44
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  90. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  91. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  92. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  93. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  94. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  95. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
  96. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  97. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  98. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  99. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  100. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  104. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  105. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
  106. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  107. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  108. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  109. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  110. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  111. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  112. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  113. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  114. package/bin/codex-security.mjs +9 -2
  115. package/dist/api.d.ts +63 -15
  116. package/dist/api.d.ts.map +1 -1
  117. package/dist/api.js +970 -553
  118. package/dist/api.js.map +1 -1
  119. package/dist/artifact-export.d.ts +70 -0
  120. package/dist/artifact-export.d.ts.map +1 -0
  121. package/dist/artifact-export.js +292 -0
  122. package/dist/artifact-export.js.map +1 -0
  123. package/dist/auth.d.ts +2 -6
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +27 -12
  126. package/dist/auth.js.map +1 -1
  127. package/dist/bulk-scan-discovery.d.ts +1 -0
  128. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  129. package/dist/bulk-scan-discovery.js +9 -9
  130. package/dist/bulk-scan-discovery.js.map +1 -1
  131. package/dist/classify-scan-severity.d.ts.map +1 -1
  132. package/dist/classify-scan-severity.js +2 -5
  133. package/dist/classify-scan-severity.js.map +1 -1
  134. package/dist/classify-severity.d.ts +28 -17
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +16 -35
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli-help.d.ts +3 -0
  139. package/dist/cli-help.d.ts.map +1 -0
  140. package/dist/cli-help.js +285 -0
  141. package/dist/cli-help.js.map +1 -0
  142. package/dist/cli-signals.d.ts +8 -0
  143. package/dist/cli-signals.d.ts.map +1 -0
  144. package/dist/cli-signals.js +28 -0
  145. package/dist/cli-signals.js.map +1 -0
  146. package/dist/cli.d.ts +22 -24
  147. package/dist/cli.d.ts.map +1 -1
  148. package/dist/cli.js +1660 -1556
  149. package/dist/cli.js.map +1 -1
  150. package/dist/cloud-publish.d.ts.map +1 -1
  151. package/dist/cloud-publish.js +11 -17
  152. package/dist/cloud-publish.js.map +1 -1
  153. package/dist/codeowners.d.ts +19 -0
  154. package/dist/codeowners.d.ts.map +1 -0
  155. package/dist/codeowners.js +138 -0
  156. package/dist/codeowners.js.map +1 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +1 -2
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/codex-sdk-environment.d.ts +3 -0
  161. package/dist/codex-sdk-environment.d.ts.map +1 -0
  162. package/dist/codex-sdk-environment.js +68 -0
  163. package/dist/codex-sdk-environment.js.map +1 -0
  164. package/dist/component-plan.d.ts +2 -5
  165. package/dist/component-plan.d.ts.map +1 -1
  166. package/dist/component-plan.js +38 -34
  167. package/dist/component-plan.js.map +1 -1
  168. package/dist/component-scan.d.ts +7 -5
  169. package/dist/component-scan.d.ts.map +1 -1
  170. package/dist/component-scan.js +54 -44
  171. package/dist/component-scan.js.map +1 -1
  172. package/dist/config.d.ts.map +1 -1
  173. package/dist/config.js +93 -104
  174. package/dist/config.js.map +1 -1
  175. package/dist/contract.d.ts +15 -2
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +124 -348
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost-model.d.ts +13 -6
  180. package/dist/cost-model.d.ts.map +1 -1
  181. package/dist/cost-model.js +75 -34
  182. package/dist/cost-model.js.map +1 -1
  183. package/dist/cost.d.ts +10 -2
  184. package/dist/cost.d.ts.map +1 -1
  185. package/dist/cost.js +116 -134
  186. package/dist/cost.js.map +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +7 -6
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/custom-validation.d.ts +1 -2
  191. package/dist/custom-validation.d.ts.map +1 -1
  192. package/dist/custom-validation.js +23 -16
  193. package/dist/custom-validation.js.map +1 -1
  194. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  195. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  196. package/dist/deduplication/checkpointed-review.js +33 -20
  197. package/dist/deduplication/checkpointed-review.js.map +1 -1
  198. package/dist/deduplication/codex-review.d.ts +9 -1
  199. package/dist/deduplication/codex-review.d.ts.map +1 -1
  200. package/dist/deduplication/codex-review.js +129 -20
  201. package/dist/deduplication/codex-review.js.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  203. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  204. package/dist/deduplication/deduplication-prompts.js +18 -4
  205. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  207. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  208. package/dist/deduplication/deduplication-reviewer.js +59 -47
  209. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  210. package/dist/deduplication/deduplication.d.ts.map +1 -1
  211. package/dist/deduplication/deduplication.js +59 -113
  212. package/dist/deduplication/deduplication.js.map +1 -1
  213. package/dist/deduplication/diagnostics.d.ts +17 -0
  214. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  215. package/dist/deduplication/diagnostics.js +5 -0
  216. package/dist/deduplication/diagnostics.js.map +1 -0
  217. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  218. package/dist/deduplication/finding-schema.js +7 -1
  219. package/dist/deduplication/finding-schema.js.map +1 -1
  220. package/dist/deduplication/local.d.ts +31 -0
  221. package/dist/deduplication/local.d.ts.map +1 -0
  222. package/dist/deduplication/local.js +166 -0
  223. package/dist/deduplication/local.js.map +1 -0
  224. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  225. package/dist/deduplication/records-protocol.js +12 -28
  226. package/dist/deduplication/records-protocol.js.map +1 -1
  227. package/dist/deduplication/records.d.ts +188 -12
  228. package/dist/deduplication/records.d.ts.map +1 -1
  229. package/dist/deduplication/records.js +34 -24
  230. package/dist/deduplication/records.js.map +1 -1
  231. package/dist/deduplication/review.d.ts +7 -0
  232. package/dist/deduplication/review.d.ts.map +1 -1
  233. package/dist/deduplication/review.js.map +1 -1
  234. package/dist/deduplication/scan.d.ts +9 -3
  235. package/dist/deduplication/scan.d.ts.map +1 -1
  236. package/dist/deduplication/scan.js +159 -44
  237. package/dist/deduplication/scan.js.map +1 -1
  238. package/dist/deep-config.d.ts +2 -1
  239. package/dist/deep-config.d.ts.map +1 -1
  240. package/dist/deep-config.js +7 -23
  241. package/dist/deep-config.js.map +1 -1
  242. package/dist/deep-progress.d.ts +2 -1
  243. package/dist/deep-progress.d.ts.map +1 -1
  244. package/dist/deep-progress.js +32 -47
  245. package/dist/deep-progress.js.map +1 -1
  246. package/dist/deep-scan.d.ts +20 -0
  247. package/dist/deep-scan.d.ts.map +1 -0
  248. package/dist/deep-scan.js +113 -0
  249. package/dist/deep-scan.js.map +1 -0
  250. package/dist/errors.d.ts +5 -2
  251. package/dist/errors.d.ts.map +1 -1
  252. package/dist/errors.js +7 -7
  253. package/dist/errors.js.map +1 -1
  254. package/dist/feedback.d.ts.map +1 -1
  255. package/dist/feedback.js +53 -21
  256. package/dist/feedback.js.map +1 -1
  257. package/dist/finding-catalogue.d.ts.map +1 -1
  258. package/dist/finding-catalogue.js +26 -30
  259. package/dist/finding-catalogue.js.map +1 -1
  260. package/dist/finding-normalization.d.ts +5 -0
  261. package/dist/finding-normalization.d.ts.map +1 -0
  262. package/dist/finding-normalization.js +120 -0
  263. package/dist/finding-normalization.js.map +1 -0
  264. package/dist/finding-retrieval.d.ts +9 -0
  265. package/dist/finding-retrieval.d.ts.map +1 -1
  266. package/dist/finding-retrieval.js.map +1 -1
  267. package/dist/finding-workflow.d.ts +13 -8
  268. package/dist/finding-workflow.d.ts.map +1 -1
  269. package/dist/finding-workflow.js +18 -13
  270. package/dist/finding-workflow.js.map +1 -1
  271. package/dist/findings-client.d.ts +2 -1
  272. package/dist/findings-client.d.ts.map +1 -1
  273. package/dist/findings-client.js +36 -9
  274. package/dist/findings-client.js.map +1 -1
  275. package/dist/findings-errors.d.ts +16 -0
  276. package/dist/findings-errors.d.ts.map +1 -0
  277. package/dist/findings-errors.js +24 -0
  278. package/dist/findings-errors.js.map +1 -0
  279. package/dist/findings-import.d.ts +1 -1
  280. package/dist/findings-import.d.ts.map +1 -1
  281. package/dist/findings-import.js +16 -44
  282. package/dist/findings-import.js.map +1 -1
  283. package/dist/github.d.ts.map +1 -1
  284. package/dist/github.js +9 -4
  285. package/dist/github.js.map +1 -1
  286. package/dist/import-scan.d.ts.map +1 -1
  287. package/dist/import-scan.js +49 -39
  288. package/dist/import-scan.js.map +1 -1
  289. package/dist/index.d.ts +11 -5
  290. package/dist/index.d.ts.map +1 -1
  291. package/dist/index.js +2 -1
  292. package/dist/index.js.map +1 -1
  293. package/dist/knowledge-base.d.ts +7 -1
  294. package/dist/knowledge-base.d.ts.map +1 -1
  295. package/dist/knowledge-base.js +115 -47
  296. package/dist/knowledge-base.js.map +1 -1
  297. package/dist/linear.d.ts.map +1 -1
  298. package/dist/linear.js +4 -10
  299. package/dist/linear.js.map +1 -1
  300. package/dist/mock-scan.d.ts.map +1 -1
  301. package/dist/mock-scan.js +0 -1
  302. package/dist/mock-scan.js.map +1 -1
  303. package/dist/models.d.ts +24 -2
  304. package/dist/models.d.ts.map +1 -1
  305. package/dist/models.js.map +1 -1
  306. package/dist/multiscan.d.ts +9 -3
  307. package/dist/multiscan.d.ts.map +1 -1
  308. package/dist/multiscan.js +225 -153
  309. package/dist/multiscan.js.map +1 -1
  310. package/dist/owner-evidence.d.ts +10 -2
  311. package/dist/owner-evidence.d.ts.map +1 -1
  312. package/dist/owner-evidence.js +69 -14
  313. package/dist/owner-evidence.js.map +1 -1
  314. package/dist/patch-tui.d.ts.map +1 -1
  315. package/dist/patch-tui.js +5 -6
  316. package/dist/patch-tui.js.map +1 -1
  317. package/dist/project-config-schema.d.ts +10 -0
  318. package/dist/project-config-schema.d.ts.map +1 -1
  319. package/dist/project-config-schema.js +1 -0
  320. package/dist/project-config-schema.js.map +1 -1
  321. package/dist/project-config.d.ts +1 -0
  322. package/dist/project-config.d.ts.map +1 -1
  323. package/dist/project-config.js +5 -3
  324. package/dist/project-config.js.map +1 -1
  325. package/dist/prompt-files.d.ts +0 -1
  326. package/dist/prompt-files.d.ts.map +1 -1
  327. package/dist/prompt-files.js +2 -4
  328. package/dist/prompt-files.js.map +1 -1
  329. package/dist/provider-profile.d.ts +21 -0
  330. package/dist/provider-profile.d.ts.map +1 -0
  331. package/dist/provider-profile.js +133 -0
  332. package/dist/provider-profile.js.map +1 -0
  333. package/dist/publication-events.d.ts +6 -8
  334. package/dist/publication-events.d.ts.map +1 -1
  335. package/dist/publication-events.js +40 -79
  336. package/dist/publication-events.js.map +1 -1
  337. package/dist/publication-store.d.ts.map +1 -1
  338. package/dist/publication-store.js +48 -76
  339. package/dist/publication-store.js.map +1 -1
  340. package/dist/publication.d.ts +1 -2
  341. package/dist/publication.d.ts.map +1 -1
  342. package/dist/publication.js +7 -16
  343. package/dist/publication.js.map +1 -1
  344. package/dist/publish.d.ts +1 -5
  345. package/dist/publish.d.ts.map +1 -1
  346. package/dist/publish.js +138 -199
  347. package/dist/publish.js.map +1 -1
  348. package/dist/record.d.ts +2 -0
  349. package/dist/record.d.ts.map +1 -0
  350. package/dist/record.js +4 -0
  351. package/dist/record.js.map +1 -0
  352. package/dist/request-metadata.d.ts +9 -0
  353. package/dist/request-metadata.d.ts.map +1 -0
  354. package/dist/request-metadata.js +13 -0
  355. package/dist/request-metadata.js.map +1 -0
  356. package/dist/result.d.ts +4 -1
  357. package/dist/result.d.ts.map +1 -1
  358. package/dist/result.js +7 -0
  359. package/dist/result.js.map +1 -1
  360. package/dist/runtime.d.ts +25 -17
  361. package/dist/runtime.d.ts.map +1 -1
  362. package/dist/runtime.js +619 -255
  363. package/dist/runtime.js.map +1 -1
  364. package/dist/saved-scan-bootstrap.d.ts +14 -0
  365. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  366. package/dist/saved-scan-bootstrap.js +261 -0
  367. package/dist/saved-scan-bootstrap.js.map +1 -0
  368. package/dist/saved-scan.d.ts +1 -1
  369. package/dist/saved-scan.d.ts.map +1 -1
  370. package/dist/saved-scan.js +16 -32
  371. package/dist/saved-scan.js.map +1 -1
  372. package/dist/scan-activity.d.ts.map +1 -1
  373. package/dist/scan-activity.js +19 -30
  374. package/dist/scan-activity.js.map +1 -1
  375. package/dist/scan-comparison.d.ts +31 -18
  376. package/dist/scan-comparison.d.ts.map +1 -1
  377. package/dist/scan-comparison.js +307 -347
  378. package/dist/scan-comparison.js.map +1 -1
  379. package/dist/scan-dashboard.d.ts +3 -1
  380. package/dist/scan-dashboard.d.ts.map +1 -1
  381. package/dist/scan-dashboard.js +351 -92
  382. package/dist/scan-dashboard.js.map +1 -1
  383. package/dist/scan-history-renderer.d.ts.map +1 -1
  384. package/dist/scan-history-renderer.js +55 -15
  385. package/dist/scan-history-renderer.js.map +1 -1
  386. package/dist/scan-inputs.d.ts +6 -0
  387. package/dist/scan-inputs.d.ts.map +1 -0
  388. package/dist/scan-inputs.js +71 -0
  389. package/dist/scan-inputs.js.map +1 -0
  390. package/dist/scan-logs.d.ts +2 -3
  391. package/dist/scan-logs.d.ts.map +1 -1
  392. package/dist/scan-logs.js +14 -12
  393. package/dist/scan-logs.js.map +1 -1
  394. package/dist/scan-sessions.d.ts +4 -0
  395. package/dist/scan-sessions.d.ts.map +1 -1
  396. package/dist/scan-sessions.js +18 -3
  397. package/dist/scan-sessions.js.map +1 -1
  398. package/dist/scan-settings.d.ts +5 -0
  399. package/dist/scan-settings.d.ts.map +1 -1
  400. package/dist/scan-settings.js +4 -0
  401. package/dist/scan-settings.js.map +1 -1
  402. package/dist/scan-skill-paths.d.ts +8 -0
  403. package/dist/scan-skill-paths.d.ts.map +1 -0
  404. package/dist/scan-skill-paths.js +47 -0
  405. package/dist/scan-skill-paths.js.map +1 -0
  406. package/dist/security-policy-cli.d.ts.map +1 -1
  407. package/dist/security-policy-cli.js +15 -33
  408. package/dist/security-policy-cli.js.map +1 -1
  409. package/dist/security-policy.d.ts +17 -9
  410. package/dist/security-policy.d.ts.map +1 -1
  411. package/dist/security-policy.js +131 -98
  412. package/dist/security-policy.js.map +1 -1
  413. package/dist/server/api.d.ts +0 -1
  414. package/dist/server/api.d.ts.map +1 -1
  415. package/dist/server/api.js +0 -1
  416. package/dist/server/api.js.map +1 -1
  417. package/dist/server/embeddings.d.ts +3 -1
  418. package/dist/server/embeddings.d.ts.map +1 -1
  419. package/dist/server/embeddings.js +11 -3
  420. package/dist/server/embeddings.js.map +1 -1
  421. package/dist/server/errors.d.ts +5 -2
  422. package/dist/server/errors.d.ts.map +1 -1
  423. package/dist/server/errors.js +7 -0
  424. package/dist/server/errors.js.map +1 -1
  425. package/dist/server/sqlite-store.d.ts +0 -2
  426. package/dist/server/sqlite-store.d.ts.map +1 -1
  427. package/dist/server/sqlite-store.js +55 -55
  428. package/dist/server/sqlite-store.js.map +1 -1
  429. package/dist/server/storage.d.ts +0 -2
  430. package/dist/server/storage.d.ts.map +1 -1
  431. package/dist/server/storage.js.map +1 -1
  432. package/dist/severity-store.js +20 -32
  433. package/dist/severity-store.js.map +1 -1
  434. package/dist/standalone-validation-prompt.d.ts +2 -0
  435. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  436. package/dist/standalone-validation-prompt.js +10 -0
  437. package/dist/standalone-validation-prompt.js.map +1 -0
  438. package/dist/suggest-owners.d.ts +6 -5
  439. package/dist/suggest-owners.d.ts.map +1 -1
  440. package/dist/suggest-owners.js +15 -10
  441. package/dist/suggest-owners.js.map +1 -1
  442. package/dist/targets.d.ts +12 -0
  443. package/dist/targets.d.ts.map +1 -1
  444. package/dist/targets.js +124 -62
  445. package/dist/targets.js.map +1 -1
  446. package/dist/trusted-executable.d.ts +6 -1
  447. package/dist/trusted-executable.d.ts.map +1 -1
  448. package/dist/trusted-executable.js +28 -9
  449. package/dist/trusted-executable.js.map +1 -1
  450. package/dist/value.d.ts +2 -0
  451. package/dist/value.d.ts.map +1 -0
  452. package/dist/value.js +27 -0
  453. package/dist/value.js.map +1 -0
  454. package/dist/version.d.ts.map +1 -1
  455. package/dist/version.js +3 -6
  456. package/dist/version.js.map +1 -1
  457. package/dist/windows-path.d.ts.map +1 -1
  458. package/dist/windows-path.js +1 -2
  459. package/dist/windows-path.js.map +1 -1
  460. package/dist/workbench-arguments.d.ts +3 -0
  461. package/dist/workbench-arguments.d.ts.map +1 -0
  462. package/dist/workbench-arguments.js +15 -0
  463. package/dist/workbench-arguments.js.map +1 -0
  464. package/dist/worker-progress.d.ts +2 -0
  465. package/dist/worker-progress.d.ts.map +1 -1
  466. package/dist/worker-progress.js +40 -46
  467. package/dist/worker-progress.js.map +1 -1
  468. package/docs/cli.md +1778 -0
  469. package/docs/dedupe-records.md +24 -0
  470. package/docs/findings-service.md +402 -0
  471. package/package.json +23 -23
  472. package/schemas/project-config.schema.json +5 -0
  473. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  474. package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
  475. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  476. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  477. package/_bundled_plugin/scripts/workbench_severity.py +0 -119
  478. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  479. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  480. package/dist/server/dashboard/app.css +0 -2
  481. package/dist/server/dashboard/app.js +0 -66
  482. package/dist/server/dashboard/index.html +0 -18
  483. package/dist/server/dashboard-types.d.ts +0 -48
  484. package/dist/server/dashboard-types.d.ts.map +0 -1
  485. package/dist/server/dashboard-types.js +0 -2
  486. package/dist/server/dashboard-types.js.map +0 -1
  487. package/dist/server/dashboard.d.ts +0 -6
  488. package/dist/server/dashboard.d.ts.map +0 -1
  489. package/dist/server/dashboard.js +0 -59
  490. package/dist/server/dashboard.js.map +0 -1
  491. package/dist/server/findings-service.d.ts +0 -20
  492. package/dist/server/findings-service.d.ts.map +0 -1
  493. package/dist/server/findings-service.js +0 -31
  494. package/dist/server/findings-service.js.map +0 -1
  495. package/dist/server/index.d.ts +0 -2
  496. package/dist/server/index.d.ts.map +0 -1
  497. package/dist/server/index.js +0 -6
  498. package/dist/server/index.js.map +0 -1
  499. package/dist/server/routes.d.ts +0 -6
  500. package/dist/server/routes.d.ts.map +0 -1
  501. package/dist/server/routes.js +0 -86
  502. package/dist/server/routes.js.map +0 -1
  503. package/dist/server/serve.d.ts +0 -2
  504. package/dist/server/serve.d.ts.map +0 -1
  505. package/dist/server/serve.js +0 -28
  506. package/dist/server/serve.js.map +0 -1
  507. package/dist/server/server.d.ts +0 -10
  508. package/dist/server/server.d.ts.map +0 -1
  509. package/dist/server/server.js +0 -17
  510. package/dist/server/server.js.map +0 -1
  511. package/dist/server/validation.d.ts +0 -17
  512. package/dist/server/validation.d.ts.map +0 -1
  513. package/dist/server/validation.js +0 -53
  514. package/dist/server/validation.js.map +0 -1
@@ -0,0 +1,239 @@
1
+ import { spawn } from "node:child_process";
2
+ import { mkdtemp, rm, writeFile } from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { createInterface } from "node:readline";
6
+
7
+ // Native startup needs provider identity and auth selection, while exec reads
8
+ // the full provider configuration from its private profile file.
9
+ export function preflightProviderDefinitions(providers) {
10
+ return Object.fromEntries(
11
+ Object.entries(providers)
12
+ .filter(([, provider]) => provider != null)
13
+ .map(([id, provider]) => [
14
+ id,
15
+ Object.fromEntries(
16
+ ["name", "wire_api", "requires_openai_auth"]
17
+ .filter((key) => Object.hasOwn(provider, key))
18
+ .map((key) => [key, provider[key]]),
19
+ ),
20
+ ]),
21
+ );
22
+ }
23
+
24
+ export function isPermissionProfileFallbackWarning(message, profileId) {
25
+ if (typeof message !== "string") return false;
26
+ const prefix =
27
+ "Configured value for `permission_profile` is disallowed by requirements; " +
28
+ `falling back from \`${profileId}\` to required value \``;
29
+ const warning = message.trim();
30
+ return warning.startsWith(prefix) && warning.endsWith("`.");
31
+ }
32
+
33
+ export function profileConfigOverrides(config) {
34
+ return Object.entries(config)
35
+ .filter(([, value]) => value != null)
36
+ .map(([key, value]) => `${key}=${toml(value)}`);
37
+ }
38
+
39
+ // Native profile files keep provider configuration off process arguments while
40
+ // retaining the existing CODEX_HOME credential store.
41
+ export function createCodexProfileClient(options) {
42
+ return {
43
+ startThread: (threadOptions = {}) =>
44
+ new ProfileThread(options, threadOptions),
45
+ resumeThread: (id, threadOptions = {}) =>
46
+ new ProfileThread(options, threadOptions, id),
47
+ };
48
+ }
49
+
50
+ class ProfileThread {
51
+ constructor(options, threadOptions, id = null) {
52
+ this.options = options;
53
+ this.threadOptions = threadOptions;
54
+ this.id = id;
55
+ }
56
+
57
+ async runStreamed(input, turnOptions = {}) {
58
+ return { events: this.events(input, turnOptions) };
59
+ }
60
+
61
+ async run(input, turnOptions = {}) {
62
+ const items = [];
63
+ let finalResponse = "";
64
+ let usage = null;
65
+ for await (const event of this.events(input, turnOptions)) {
66
+ if (event.type === "item.completed") {
67
+ items.push(event.item);
68
+ if (event.item.type === "agent_message")
69
+ finalResponse = event.item.text;
70
+ } else if (event.type === "turn.completed") {
71
+ usage = event.usage;
72
+ } else if (event.type === "turn.failed") {
73
+ throw new Error(event.error.message);
74
+ }
75
+ }
76
+ return { items, finalResponse, usage };
77
+ }
78
+
79
+ async *events(input, turnOptions) {
80
+ let schemaDirectory;
81
+ try {
82
+ let schemaPath;
83
+ if (turnOptions.outputSchema !== undefined) {
84
+ const schema = turnOptions.outputSchema;
85
+ if (
86
+ schema === null ||
87
+ typeof schema !== "object" ||
88
+ Array.isArray(schema)
89
+ ) {
90
+ throw new Error("outputSchema must be a plain JSON object");
91
+ }
92
+ schemaDirectory = await mkdtemp(join(tmpdir(), "codex-output-schema-"));
93
+ schemaPath = join(schemaDirectory, "schema.json");
94
+ await writeFile(schemaPath, JSON.stringify(schema), "utf8");
95
+ }
96
+ const args = nativeArguments(
97
+ this.options,
98
+ this.threadOptions,
99
+ this.id,
100
+ turnOptions,
101
+ schemaPath,
102
+ );
103
+ for await (const line of execute(
104
+ this.options,
105
+ args,
106
+ input,
107
+ turnOptions.signal,
108
+ )) {
109
+ let event;
110
+ try {
111
+ event = JSON.parse(line);
112
+ } catch (cause) {
113
+ throw new Error(`Failed to parse item: ${line}`, { cause });
114
+ }
115
+ const item = event.type === "item.completed" ? event.item : event;
116
+ if (
117
+ this.options.requestedPermissionProfile !== undefined &&
118
+ item.type === "error" &&
119
+ isPermissionProfileFallbackWarning(
120
+ item.message,
121
+ this.options.requestedPermissionProfile,
122
+ )
123
+ ) {
124
+ throw new Error(
125
+ "Read-only Codex helper stopped because organization policy changed its permission profile. Its results were discarded.\n" +
126
+ item.message,
127
+ );
128
+ }
129
+ if (event.type === "thread.started") this.id = event.thread_id;
130
+ if (event.type === "turn.completed" && event.usage != null)
131
+ event.usage.cache_write_input_tokens ??= 0;
132
+ yield event;
133
+ }
134
+ } finally {
135
+ if (schemaDirectory) {
136
+ await rm(schemaDirectory, { recursive: true, force: true }).catch(
137
+ () => {},
138
+ );
139
+ }
140
+ }
141
+ }
142
+ }
143
+
144
+ function nativeArguments(options, thread, id, turn, schemaPath) {
145
+ const args = [
146
+ "exec",
147
+ "--experimental-json",
148
+ "--profile",
149
+ options.profileName,
150
+ ];
151
+ const config = (key, value) => args.push("--config", `${key}=${toml(value)}`);
152
+ for (const override of profileConfigOverrides(options.config ?? {}))
153
+ args.push("--config", override);
154
+ for (const override of options.configOverrides ?? [])
155
+ args.push("--config", override);
156
+ if (options.baseUrl) config("openai_base_url", options.baseUrl);
157
+ if (thread.model) args.push("--model", thread.model);
158
+ if (thread.threadSource !== undefined && !id)
159
+ args.push("--thread-source", thread.threadSource);
160
+ if (thread.sandboxMode) args.push("--sandbox", thread.sandboxMode);
161
+ if (thread.workingDirectory) args.push("--cd", thread.workingDirectory);
162
+ for (const directory of thread.additionalDirectories ?? [])
163
+ args.push("--add-dir", directory);
164
+ if (thread.skipGitRepoCheck) args.push("--skip-git-repo-check");
165
+ if (schemaPath) args.push("--output-schema", schemaPath);
166
+ if (turn.cyberAccessProgram !== undefined)
167
+ args.push("--cyber-access-program", turn.cyberAccessProgram);
168
+ if (thread.modelReasoningEffort)
169
+ config("model_reasoning_effort", thread.modelReasoningEffort);
170
+ if (thread.networkAccessEnabled !== undefined)
171
+ config(
172
+ "sandbox_workspace_write.network_access",
173
+ thread.networkAccessEnabled,
174
+ );
175
+ if (thread.webSearchMode) config("web_search", thread.webSearchMode);
176
+ else if (thread.webSearchEnabled !== undefined)
177
+ config("web_search", thread.webSearchEnabled ? "live" : "disabled");
178
+ if (thread.approvalPolicy) config("approval_policy", thread.approvalPolicy);
179
+ if (id) args.push("resume", id);
180
+ return args;
181
+ }
182
+
183
+ function toml(value) {
184
+ if (typeof value === "string" || typeof value === "boolean")
185
+ return JSON.stringify(value).replace(/\u007f/g, "\\u007f");
186
+ if (typeof value === "number" && Number.isFinite(value)) return String(value);
187
+ if (Array.isArray(value)) return `[${value.map(toml).join(", ")}]`;
188
+ if (value !== null && typeof value === "object") {
189
+ return `{${Object.entries(value)
190
+ .filter(([, child]) => child != null)
191
+ .map(
192
+ ([key, child]) =>
193
+ `${/^[A-Za-z0-9_-]+$/.test(key) ? key : toml(key)} = ${toml(child)}`,
194
+ )
195
+ .join(", ")}}`;
196
+ }
197
+ throw new Error("Codex config overrides must contain finite TOML values");
198
+ }
199
+
200
+ async function* execute(options, args, input, signal) {
201
+ const env = { ...(options.env ?? process.env) };
202
+ env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE ||= "codex_sdk_ts";
203
+ if (options.apiKey) env.CODEX_API_KEY = options.apiKey;
204
+ const child = spawn(options.codexPathOverride, args, {
205
+ env,
206
+ signal,
207
+ windowsHide: true,
208
+ });
209
+ let processError;
210
+ let inputError;
211
+ child.on("error", (error) => {
212
+ processError = error;
213
+ });
214
+ child.stdin.on("error", (error) => {
215
+ inputError = error;
216
+ });
217
+ const closed = new Promise((resolve) => {
218
+ child.once("close", (code, exitSignal) => resolve({ code, exitSignal }));
219
+ });
220
+ const stderr = [];
221
+ child.stderr.on("data", (chunk) => stderr.push(chunk));
222
+ const lines = createInterface({ input: child.stdout, crlfDelay: Infinity });
223
+ child.stdin.end(input);
224
+ try {
225
+ for await (const line of lines) yield line;
226
+ const { code, exitSignal } = await closed;
227
+ if (processError) throw processError;
228
+ if (code !== 0 || exitSignal) {
229
+ const detail = exitSignal ? `signal ${exitSignal}` : `code ${code ?? 1}`;
230
+ throw new Error(
231
+ `Codex Exec exited with ${detail}: ${Buffer.concat(stderr).toString("utf8")}`,
232
+ );
233
+ }
234
+ if (inputError) throw inputError;
235
+ } finally {
236
+ lines.close();
237
+ if (child.exitCode === null && child.signalCode === null) child.kill();
238
+ }
239
+ }
@@ -0,0 +1,53 @@
1
+ /** Reduce a single stream; callers retain error, retry and acceptance policy. */
2
+ export async function readCodexSessionTurn(options) {
3
+ let threadId = options.thread.id;
4
+ let status = "in_progress";
5
+ let finalResponse = "";
6
+ let usage = null;
7
+ let lastStreamError = null;
8
+ for await (const event of eventsWithOptionalUsage(options.events)) {
9
+ await options.onEvent(event);
10
+ if (
11
+ event.type === "thread.started" &&
12
+ typeof event["thread_id"] === "string"
13
+ ) {
14
+ threadId = event["thread_id"];
15
+ } else if (
16
+ event.type === "item.completed" &&
17
+ isRecord(event["item"]) &&
18
+ event["item"]["type"] === "agent_message" &&
19
+ typeof event["item"]["text"] === "string"
20
+ ) {
21
+ finalResponse = event["item"]["text"];
22
+ } else if (event.type === "turn.completed") {
23
+ status = "completed";
24
+ usage = event["usage"] ?? null;
25
+ if (options.stopOnCompletion) break;
26
+ } else if (event.type === "error" && typeof event["message"] === "string") {
27
+ lastStreamError = event["message"];
28
+ }
29
+ }
30
+ return { threadId, status, finalResponse, usage, lastStreamError };
31
+ }
32
+
33
+ async function* eventsWithOptionalUsage(events) {
34
+ try {
35
+ yield* events;
36
+ } catch (error) {
37
+ // The pinned SDK accesses this field before yielding a completion with
38
+ // absent usage. Preserve completion without inventing a zero-token receipt.
39
+ if (
40
+ error instanceof TypeError &&
41
+ /\b(?:null|undefined)\b/u.test(error.message) &&
42
+ /\bcache_write_input_tokens\b/u.test(error.message)
43
+ ) {
44
+ yield { type: "turn.completed", usage: null };
45
+ return;
46
+ }
47
+ throw error;
48
+ }
49
+ }
50
+
51
+ function isRecord(value) {
52
+ return typeof value === "object" && value !== null;
53
+ }
@@ -12,14 +12,16 @@ from collections.abc import Iterator
12
12
  from pathlib import Path
13
13
  from typing import Any
14
14
 
15
- try:
16
- import tomllib
17
- except ModuleNotFoundError: # pragma: no cover - Python 3.10 only
18
- import tomli as tomllib
15
+ # Some plugin hosts launch Python with safe-path isolation enabled.
16
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
17
+ from workbench.runtime_toml import tomllib
18
+ from workbench_constants import positive_int
19
19
 
20
20
  PLUGIN_ROOT = Path(__file__).resolve().parents[1]
21
21
  DEFAULT_REGISTRY = PLUGIN_ROOT / "preflight" / "capability-profiles.toml"
22
- DEFAULT_CODEX_HOME = Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser()
22
+ DEFAULT_CODEX_HOME = Path(
23
+ os.environ["CODEX_HOME"] if os.environ.get("CODEX_HOME", "").strip() else "~/.codex"
24
+ ).expanduser()
23
25
 
24
26
 
25
27
  def default_system_config() -> Path:
@@ -147,13 +149,6 @@ def parse_bool(value: str) -> bool:
147
149
  raise ValueError(f"expected true or false, got {value!r}")
148
150
 
149
151
 
150
- def positive_int(value: str) -> int:
151
- parsed = int(value)
152
- if parsed < 1:
153
- raise argparse.ArgumentTypeError("expected a positive integer")
154
- return parsed
155
-
156
-
157
152
  def parse_assignment(raw: str) -> tuple[str, str]:
158
153
  key, separator, value = raw.partition("=")
159
154
  if not separator or not key or not value:
@@ -273,12 +268,10 @@ def project_trust_level(
273
268
 
274
269
  def project_config_paths(project_root: Path, cwd: Path) -> list[Path]:
275
270
  relative = cwd.relative_to(project_root)
276
- directories = [project_root]
277
- current = project_root
278
- for part in relative.parts:
279
- current /= part
280
- directories.append(current)
281
- return [directory / ".codex" / "config.toml" for directory in directories]
271
+ return [
272
+ project_root / directory / ".codex" / "config.toml"
273
+ for directory in reversed((relative, *relative.parents))
274
+ ]
282
275
 
283
276
 
284
277
  def discover_config_paths(
@@ -377,28 +370,6 @@ def config_profile_layer_path(profile: str | None) -> Path | None:
377
370
  return path if path.is_file() else None
378
371
 
379
372
 
380
- def parse_multi_agent_v2_enabled(feature_config: Any) -> bool | None:
381
- if isinstance(feature_config, bool):
382
- return feature_config
383
- if not isinstance(feature_config, dict):
384
- raise ValueError("features.multi_agent_v2 must be a boolean or table")
385
- if "enabled" not in feature_config:
386
- return None
387
- enabled = feature_config["enabled"]
388
- if not isinstance(enabled, bool):
389
- raise ValueError("features.multi_agent_v2.enabled must be a boolean")
390
- return enabled
391
-
392
-
393
- def merge_toml_value(base: Any, overlay: Any) -> Any:
394
- if isinstance(base, dict) and isinstance(overlay, dict):
395
- merged = dict(base)
396
- for key, value in overlay.items():
397
- merged[key] = merge_toml_value(merged[key], value) if key in merged else value
398
- return merged
399
- return overlay
400
-
401
-
402
373
  def lookup_multi_agent_v2_enabled(
403
374
  *,
404
375
  config_layers: list[tuple[Path, dict[str, Any]]],
@@ -412,38 +383,28 @@ def lookup_multi_agent_v2_enabled(
412
383
  return True, enabled, "effective-config"
413
384
 
414
385
  v2_configs = []
415
- config_views = list(iter_config_views(config_layers, config_profile))
416
- for source, config in reversed(config_views):
386
+ if "features.multi_agent_v2" in effective_config:
387
+ v2_configs.append(("effective-config", effective_config["features.multi_agent_v2"]))
388
+ for source, config in iter_config_views(config_layers, config_profile):
417
389
  found, feature_config = lookup_dotted(config, "features.multi_agent_v2")
418
390
  if found:
419
391
  v2_configs.append((source, feature_config))
420
392
 
421
- if "features.multi_agent_v2" in effective_config:
422
- v2_configs.append(("effective-config", effective_config["features.multi_agent_v2"]))
423
-
424
- if not v2_configs:
425
- return False, None, None
426
-
427
- merged_v2_config: Any = None
428
- enabled_source: str | None = None
429
- for index, (source, feature_config) in enumerate(v2_configs):
430
- tables_merge = isinstance(merged_v2_config, dict) and isinstance(feature_config, dict)
431
- if index and not tables_merge:
432
- enabled_source = None
433
- merged_v2_config = (
434
- merge_toml_value(merged_v2_config, feature_config) if index else feature_config
435
- )
436
- if isinstance(feature_config, bool) or (
437
- isinstance(feature_config, dict) and "enabled" in feature_config
438
- ):
439
- enabled_source = source
440
-
441
- enabled = parse_multi_agent_v2_enabled(merged_v2_config)
442
- return (
443
- (True, enabled, enabled_source)
444
- if enabled is not None
445
- else (True, False, "documented-default")
446
- )
393
+ table_override = False
394
+ for source, feature_config in v2_configs:
395
+ if table_override and not isinstance(feature_config, (dict, bool)):
396
+ break
397
+ if isinstance(feature_config, bool):
398
+ return True, feature_config, source
399
+ if not isinstance(feature_config, dict):
400
+ raise ValueError("features.multi_agent_v2 must be a boolean or table")
401
+ if "enabled" in feature_config:
402
+ enabled = feature_config["enabled"]
403
+ if not isinstance(enabled, bool):
404
+ raise ValueError("features.multi_agent_v2.enabled must be a boolean")
405
+ return True, enabled, source
406
+ table_override = True
407
+ return (True, False, "documented-default") if table_override else (False, None, None)
447
408
 
448
409
 
449
410
  def resolve_multi_agent_context(
@@ -865,7 +826,6 @@ def evaluate(args: argparse.Namespace) -> dict[str, Any]:
865
826
  if path in project_config_paths_set:
866
827
  # Codex strips project-local profile selection and definitions before
867
828
  # resolving the merged config. Mirror that denylist here.
868
- config = dict(config)
869
829
  config.pop("profile", None)
870
830
  config.pop("profiles", None)
871
831
  config_layers.append((path, config))
@@ -4,15 +4,13 @@ from __future__ import annotations
4
4
 
5
5
  import argparse
6
6
  import json
7
- import math
8
7
  import os
8
+ import sys
9
9
  from pathlib import Path
10
10
  from typing import Any
11
11
 
12
- try:
13
- import tomllib
14
- except ModuleNotFoundError: # pragma: no cover - Python 3.10 only
15
- import tomli as tomllib
12
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
13
+ from workbench.runtime_toml import tomllib
16
14
 
17
15
  DEFAULTS = json.loads(
18
16
  Path(__file__).with_name("deep_scan_defaults.json").read_text(encoding="utf-8")
@@ -35,7 +33,9 @@ CONFIG_KEYS = {
35
33
 
36
34
 
37
35
  def codex_home() -> Path:
38
- return Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser()
36
+ return Path(
37
+ os.environ["CODEX_HOME"] if os.environ.get("CODEX_HOME", "").strip() else "~/.codex"
38
+ ).expanduser()
39
39
 
40
40
 
41
41
  def config_path() -> Path:
@@ -106,6 +106,8 @@ def resolve_deep_scan_config(available_parallelism: int) -> dict[str, int | floa
106
106
 
107
107
 
108
108
  def require_integer(value: object, label: str, *, minimum: int) -> int:
109
+ if isinstance(value, float) and value.is_integer():
110
+ value = int(value)
109
111
  if isinstance(value, bool) or not isinstance(value, int) or value < minimum:
110
112
  qualifier = (
111
113
  "a non-negative integer"
@@ -121,11 +123,7 @@ def require_integer(value: object, label: str, *, minimum: int) -> int:
121
123
  def require_positive_number(value: object, label: str) -> int | float:
122
124
  if isinstance(value, bool) or not isinstance(value, (int, float)):
123
125
  raise SystemExit(f"{label} must be a positive finite number no greater than 96.")
124
- try:
125
- finite = math.isfinite(value)
126
- except OverflowError:
127
- finite = False
128
- if not finite or value <= 0 or value > MAX_TIME_HOURS:
126
+ if not 0 < value <= MAX_TIME_HOURS:
129
127
  raise SystemExit(f"{label} must be a positive finite number no greater than 96.")
130
128
  return value
131
129