@openai/codex-security 0.9.1 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (444) hide show
  1. package/README.md +37 -788
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +3 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  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 +0 -0
  14. package/_bundled_plugin/references/access-advisory.md +1 -1
  15. package/_bundled_plugin/references/artifact-storage.md +1 -1
  16. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  17. package/_bundled_plugin/references/core-scan.md +5 -42
  18. package/_bundled_plugin/references/final-report.md +1 -1
  19. package/_bundled_plugin/references/focused-investigator.md +13 -0
  20. package/_bundled_plugin/references/scan-prologue.md +2 -2
  21. package/_bundled_plugin/references/scan-runtime.md +4 -2
  22. package/_bundled_plugin/references/security-guidance.md +14 -1
  23. package/_bundled_plugin/references/threat-model.md +1 -0
  24. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  25. package/_bundled_plugin/scripts/deep_scan_workbench.py +30 -12
  26. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  27. package/_bundled_plugin/scripts/finalize_scan_contract.py +47 -9
  28. package/_bundled_plugin/scripts/launch_codex_security_mcp +54 -16
  29. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +2 -0
  30. package/_bundled_plugin/scripts/posix_scan_local_files.py +26 -1
  31. package/_bundled_plugin/scripts/snapshot_sqlite.py +8 -2
  32. package/_bundled_plugin/scripts/windows_scan_local_files.py +216 -25
  33. package/_bundled_plugin/scripts/workbench/handoff.py +55 -25
  34. package/_bundled_plugin/scripts/workbench/storage.py +25 -5
  35. package/_bundled_plugin/scripts/workbench_cli.py +24 -2
  36. package/_bundled_plugin/scripts/workbench_constants.py +2 -0
  37. package/_bundled_plugin/scripts/workbench_db.py +257 -268
  38. package/_bundled_plugin/scripts/workbench_feedback.py +49 -4
  39. package/_bundled_plugin/scripts/workbench_native_indexes.py +226 -29
  40. package/_bundled_plugin/scripts/workbench_progress.py +159 -3
  41. package/_bundled_plugin/scripts/workbench_publication.py +2 -3
  42. package/_bundled_plugin/scripts/workbench_remediation.py +142 -2
  43. package/_bundled_plugin/scripts/workbench_saved_results.py +48 -8
  44. package/_bundled_plugin/scripts/workbench_scan_history.py +291 -134
  45. package/_bundled_plugin/scripts/workbench_scan_start.py +208 -11
  46. package/_bundled_plugin/scripts/workbench_scan_usage.py +36 -10
  47. package/_bundled_plugin/scripts/workbench_schema.py +220 -14
  48. package/_bundled_plugin/scripts/workbench_setup.py +1 -1
  49. package/_bundled_plugin/scripts/workbench_source_scopes.py +8 -0
  50. package/_bundled_plugin/scripts/workbench_target.py +486 -85
  51. package/_bundled_plugin/scripts/workbench_target_state.py +1108 -22
  52. package/_bundled_plugin/shared/workbench-history-repairs.json +64 -14
  53. package/_bundled_plugin/shared/workbench-migrations.json +66 -0
  54. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +4 -2
  55. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +2 -2
  56. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -0
  57. package/_bundled_plugin/skills/publish-findings/SKILL.md +26 -160
  58. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  59. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +2 -2
  60. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +3 -58
  61. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  62. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  63. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  64. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  65. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  66. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  67. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  68. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  69. package/bin/codex-security.mjs +2 -2
  70. package/dist/api.d.ts +7 -1
  71. package/dist/api.d.ts.map +1 -1
  72. package/dist/api.js +459 -157
  73. package/dist/api.js.map +1 -1
  74. package/dist/armorcode-findings.d.ts +9 -0
  75. package/dist/armorcode-findings.d.ts.map +1 -0
  76. package/dist/armorcode-findings.js +145 -0
  77. package/dist/armorcode-findings.js.map +1 -0
  78. package/dist/artifact-export.d.ts +2 -0
  79. package/dist/artifact-export.d.ts.map +1 -1
  80. package/dist/artifact-export.js +29 -13
  81. package/dist/artifact-export.js.map +1 -1
  82. package/dist/auth.d.ts +6 -2
  83. package/dist/auth.d.ts.map +1 -1
  84. package/dist/auth.js +33 -12
  85. package/dist/auth.js.map +1 -1
  86. package/dist/batch-cost.d.ts +18 -0
  87. package/dist/batch-cost.d.ts.map +1 -0
  88. package/dist/batch-cost.js +41 -0
  89. package/dist/batch-cost.js.map +1 -0
  90. package/dist/blackduck-findings.d.ts +1 -1
  91. package/dist/blackduck-findings.d.ts.map +1 -1
  92. package/dist/blackduck-findings.js +5 -18
  93. package/dist/blackduck-findings.js.map +1 -1
  94. package/dist/bundled-plugin.d.ts +4 -0
  95. package/dist/bundled-plugin.d.ts.map +1 -0
  96. package/dist/bundled-plugin.js +23 -0
  97. package/dist/bundled-plugin.js.map +1 -0
  98. package/dist/classify-scan-severity.d.ts +1 -1
  99. package/dist/classify-scan-severity.d.ts.map +1 -1
  100. package/dist/classify-scan-severity.js +11 -3
  101. package/dist/classify-scan-severity.js.map +1 -1
  102. package/dist/classify-severity-diagnostics.d.ts +10 -0
  103. package/dist/classify-severity-diagnostics.d.ts.map +1 -0
  104. package/dist/classify-severity-diagnostics.js +57 -0
  105. package/dist/classify-severity-diagnostics.js.map +1 -0
  106. package/dist/classify-severity-records.d.ts +4 -0
  107. package/dist/classify-severity-records.d.ts.map +1 -1
  108. package/dist/classify-severity-records.js +35 -8
  109. package/dist/classify-severity-records.js.map +1 -1
  110. package/dist/classify-severity.d.ts.map +1 -1
  111. package/dist/classify-severity.js +9 -6
  112. package/dist/classify-severity.js.map +1 -1
  113. package/dist/cli-argument.d.ts +4 -0
  114. package/dist/cli-argument.d.ts.map +1 -0
  115. package/dist/cli-argument.js +17 -0
  116. package/dist/cli-argument.js.map +1 -0
  117. package/dist/cli-help.d.ts +1 -1
  118. package/dist/cli-help.d.ts.map +1 -1
  119. package/dist/cli-help.js +71 -29
  120. package/dist/cli-help.js.map +1 -1
  121. package/dist/cli-hook.d.ts +3 -0
  122. package/dist/cli-hook.d.ts.map +1 -0
  123. package/dist/cli-hook.js +87 -0
  124. package/dist/cli-hook.js.map +1 -0
  125. package/dist/cli-integrations.d.ts +13 -0
  126. package/dist/cli-integrations.d.ts.map +1 -0
  127. package/dist/cli-integrations.js +333 -0
  128. package/dist/cli-integrations.js.map +1 -0
  129. package/dist/cli-mcp.d.ts +15 -0
  130. package/dist/cli-mcp.d.ts.map +1 -0
  131. package/dist/cli-mcp.js +178 -0
  132. package/dist/cli-mcp.js.map +1 -0
  133. package/dist/cli-token-view.d.ts +10 -0
  134. package/dist/cli-token-view.d.ts.map +1 -0
  135. package/dist/cli-token-view.js +41 -0
  136. package/dist/cli-token-view.js.map +1 -0
  137. package/dist/cli.d.ts +8 -3
  138. package/dist/cli.d.ts.map +1 -1
  139. package/dist/cli.js +1860 -903
  140. package/dist/cli.js.map +1 -1
  141. package/dist/cloud-publish.d.ts.map +1 -1
  142. package/dist/cloud-publish.js +33 -31
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/codex-sdk-environment.d.ts +6 -0
  145. package/dist/codex-sdk-environment.d.ts.map +1 -1
  146. package/dist/codex-sdk-environment.js +19 -0
  147. package/dist/codex-sdk-environment.js.map +1 -1
  148. package/dist/command-words.d.ts +3 -0
  149. package/dist/command-words.d.ts.map +1 -0
  150. package/dist/command-words.js +46 -0
  151. package/dist/command-words.js.map +1 -0
  152. package/dist/component-plan.d.ts.map +1 -1
  153. package/dist/component-plan.js +3 -3
  154. package/dist/component-plan.js.map +1 -1
  155. package/dist/component-scan.d.ts +3 -1
  156. package/dist/component-scan.d.ts.map +1 -1
  157. package/dist/component-scan.js +40 -7
  158. package/dist/component-scan.js.map +1 -1
  159. package/dist/config.d.ts +1 -1
  160. package/dist/config.d.ts.map +1 -1
  161. package/dist/config.js +30 -1
  162. package/dist/config.js.map +1 -1
  163. package/dist/continuum-aws.d.ts +6 -0
  164. package/dist/continuum-aws.d.ts.map +1 -0
  165. package/dist/continuum-aws.js +202 -0
  166. package/dist/continuum-aws.js.map +1 -0
  167. package/dist/continuum-collector.d.ts +44 -0
  168. package/dist/continuum-collector.d.ts.map +1 -0
  169. package/dist/continuum-collector.js +266 -0
  170. package/dist/continuum-collector.js.map +1 -0
  171. package/dist/continuum-findings.d.ts +31 -2
  172. package/dist/continuum-findings.d.ts.map +1 -1
  173. package/dist/continuum-findings.js +497 -59
  174. package/dist/continuum-findings.js.map +1 -1
  175. package/dist/contract.d.ts +1 -0
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +3 -0
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost.d.ts.map +1 -1
  180. package/dist/cost.js +1 -45
  181. package/dist/cost.js.map +1 -1
  182. package/dist/crowdstrike-findings.d.ts +7 -0
  183. package/dist/crowdstrike-findings.d.ts.map +1 -0
  184. package/dist/crowdstrike-findings.js +210 -0
  185. package/dist/crowdstrike-findings.js.map +1 -0
  186. package/dist/custom-validation-prompt.d.ts +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +29 -19
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/deduplication/local.d.ts +3 -1
  191. package/dist/deduplication/local.d.ts.map +1 -1
  192. package/dist/deduplication/local.js +8 -1
  193. package/dist/deduplication/local.js.map +1 -1
  194. package/dist/deduplication/refusal.d.ts.map +1 -1
  195. package/dist/deduplication/refusal.js +2 -1
  196. package/dist/deduplication/refusal.js.map +1 -1
  197. package/dist/deduplication/scan.d.ts +2 -0
  198. package/dist/deduplication/scan.d.ts.map +1 -1
  199. package/dist/deduplication/scan.js +24 -7
  200. package/dist/deduplication/scan.js.map +1 -1
  201. package/dist/deep-scan.d.ts.map +1 -1
  202. package/dist/deep-scan.js +16 -15
  203. package/dist/deep-scan.js.map +1 -1
  204. package/dist/endor-findings.d.ts +2 -2
  205. package/dist/endor-findings.d.ts.map +1 -1
  206. package/dist/endor-findings.js +6 -23
  207. package/dist/endor-findings.js.map +1 -1
  208. package/dist/errors.d.ts +3 -1
  209. package/dist/errors.d.ts.map +1 -1
  210. package/dist/errors.js +7 -3
  211. package/dist/errors.js.map +1 -1
  212. package/dist/executable-path.d.ts +3 -0
  213. package/dist/executable-path.d.ts.map +1 -1
  214. package/dist/executable-path.js +26 -0
  215. package/dist/executable-path.js.map +1 -1
  216. package/dist/external-findings-import.d.ts.map +1 -1
  217. package/dist/external-findings-import.js +12 -1
  218. package/dist/external-findings-import.js.map +1 -1
  219. package/dist/external-findings-local.d.ts +66 -4
  220. package/dist/external-findings-local.d.ts.map +1 -1
  221. package/dist/external-findings-local.js +258 -59
  222. package/dist/external-findings-local.js.map +1 -1
  223. package/dist/external-findings-publish.d.ts +6 -1
  224. package/dist/external-findings-publish.d.ts.map +1 -1
  225. package/dist/external-findings-publish.js +330 -1633
  226. package/dist/external-findings-publish.js.map +1 -1
  227. package/dist/external-findings-read.d.ts +11 -2
  228. package/dist/external-findings-read.d.ts.map +1 -1
  229. package/dist/external-findings-read.js +56 -53
  230. package/dist/external-findings-read.js.map +1 -1
  231. package/dist/external-findings.d.ts +1 -1
  232. package/dist/external-findings.d.ts.map +1 -1
  233. package/dist/external-findings.js +12 -1
  234. package/dist/external-findings.js.map +1 -1
  235. package/dist/external-import-contract.d.ts +6 -11
  236. package/dist/external-import-contract.d.ts.map +1 -1
  237. package/dist/external-import-contract.js +35 -177
  238. package/dist/external-import-contract.js.map +1 -1
  239. package/dist/external-import-models.d.ts +1 -1
  240. package/dist/external-import-models.d.ts.map +1 -1
  241. package/dist/external-import-models.js.map +1 -1
  242. package/dist/finding-prompt.d.ts.map +1 -1
  243. package/dist/finding-prompt.js +2 -2
  244. package/dist/finding-prompt.js.map +1 -1
  245. package/dist/github-dependabot-findings.d.ts.map +1 -1
  246. package/dist/github-dependabot-findings.js +3 -4
  247. package/dist/github-dependabot-findings.js.map +1 -1
  248. package/dist/github-findings.d.ts.map +1 -1
  249. package/dist/github-findings.js +19 -287
  250. package/dist/github-findings.js.map +1 -1
  251. package/dist/host-protocol.d.ts +6 -0
  252. package/dist/host-protocol.d.ts.map +1 -1
  253. package/dist/host-protocol.js +11 -1
  254. package/dist/host-protocol.js.map +1 -1
  255. package/dist/host-records-protocol.d.ts +2 -0
  256. package/dist/host-records-protocol.d.ts.map +1 -1
  257. package/dist/host-records-protocol.js +4 -0
  258. package/dist/host-records-protocol.js.map +1 -1
  259. package/dist/hosted-remediation.d.ts +1 -0
  260. package/dist/hosted-remediation.d.ts.map +1 -1
  261. package/dist/hosted-remediation.js +23 -3
  262. package/dist/hosted-remediation.js.map +1 -1
  263. package/dist/index.d.ts +5 -3
  264. package/dist/index.d.ts.map +1 -1
  265. package/dist/index.js +3 -1
  266. package/dist/index.js.map +1 -1
  267. package/dist/inspector-findings.d.ts.map +1 -1
  268. package/dist/inspector-findings.js +19 -35
  269. package/dist/inspector-findings.js.map +1 -1
  270. package/dist/knowledge-base.d.ts +1 -1
  271. package/dist/knowledge-base.d.ts.map +1 -1
  272. package/dist/knowledge-base.js +34 -27
  273. package/dist/knowledge-base.js.map +1 -1
  274. package/dist/linear.d.ts +11 -0
  275. package/dist/linear.d.ts.map +1 -1
  276. package/dist/linear.js.map +1 -1
  277. package/dist/local-git-metadata.d.ts +5 -2
  278. package/dist/local-git-metadata.d.ts.map +1 -1
  279. package/dist/local-git-metadata.js +8 -4
  280. package/dist/local-git-metadata.js.map +1 -1
  281. package/dist/multiscan.d.ts +4 -0
  282. package/dist/multiscan.d.ts.map +1 -1
  283. package/dist/multiscan.js +83 -39
  284. package/dist/multiscan.js.map +1 -1
  285. package/dist/opengrep-findings.d.ts +4 -2
  286. package/dist/opengrep-findings.d.ts.map +1 -1
  287. package/dist/opengrep-findings.js +39 -22
  288. package/dist/opengrep-findings.js.map +1 -1
  289. package/dist/private-finding-import.d.ts +8 -13
  290. package/dist/private-finding-import.d.ts.map +1 -1
  291. package/dist/private-finding-import.js +69 -129
  292. package/dist/private-finding-import.js.map +1 -1
  293. package/dist/project-config-schema.d.ts +2 -0
  294. package/dist/project-config-schema.d.ts.map +1 -1
  295. package/dist/project-config-schema.js +1 -0
  296. package/dist/project-config-schema.js.map +1 -1
  297. package/dist/project-config.d.ts +1 -0
  298. package/dist/project-config.d.ts.map +1 -1
  299. package/dist/project-config.js +56 -13
  300. package/dist/project-config.js.map +1 -1
  301. package/dist/prompt-files.d.ts +7 -2
  302. package/dist/prompt-files.d.ts.map +1 -1
  303. package/dist/prompt-files.js +42 -20
  304. package/dist/prompt-files.js.map +1 -1
  305. package/dist/provider-profile.d.ts.map +1 -1
  306. package/dist/provider-profile.js +4 -9
  307. package/dist/provider-profile.js.map +1 -1
  308. package/dist/publication.d.ts +1 -1
  309. package/dist/publication.d.ts.map +1 -1
  310. package/dist/publication.js.map +1 -1
  311. package/dist/record.d.ts +1 -5
  312. package/dist/record.d.ts.map +1 -1
  313. package/dist/record.js +3 -51
  314. package/dist/record.js.map +1 -1
  315. package/dist/remediation.d.ts.map +1 -1
  316. package/dist/remediation.js +3 -1
  317. package/dist/remediation.js.map +1 -1
  318. package/dist/runtime.d.ts +35 -7
  319. package/dist/runtime.d.ts.map +1 -1
  320. package/dist/runtime.js +782 -153
  321. package/dist/runtime.js.map +1 -1
  322. package/dist/saved-scan-bootstrap.d.ts +6 -1
  323. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  324. package/dist/saved-scan-bootstrap.js +267 -115
  325. package/dist/saved-scan-bootstrap.js.map +1 -1
  326. package/dist/scan-archive-path.d.ts +2 -0
  327. package/dist/scan-archive-path.d.ts.map +1 -0
  328. package/dist/scan-archive-path.js +5 -0
  329. package/dist/scan-archive-path.js.map +1 -0
  330. package/dist/scan-comparison.d.ts +20 -2
  331. package/dist/scan-comparison.d.ts.map +1 -1
  332. package/dist/scan-comparison.js +26 -5
  333. package/dist/scan-comparison.js.map +1 -1
  334. package/dist/scan-dashboard.d.ts +1 -0
  335. package/dist/scan-dashboard.d.ts.map +1 -1
  336. package/dist/scan-dashboard.js +18 -2
  337. package/dist/scan-dashboard.js.map +1 -1
  338. package/dist/scan-executor.d.ts.map +1 -1
  339. package/dist/scan-executor.js +4 -2
  340. package/dist/scan-executor.js.map +1 -1
  341. package/dist/scan-history-renderer.d.ts +1 -0
  342. package/dist/scan-history-renderer.d.ts.map +1 -1
  343. package/dist/scan-history-renderer.js +25 -9
  344. package/dist/scan-history-renderer.js.map +1 -1
  345. package/dist/scan-logs.d.ts.map +1 -1
  346. package/dist/scan-logs.js +28 -4
  347. package/dist/scan-logs.js.map +1 -1
  348. package/dist/scan-settings.d.ts +1 -0
  349. package/dist/scan-settings.d.ts.map +1 -1
  350. package/dist/scan-settings.js +1 -0
  351. package/dist/scan-settings.js.map +1 -1
  352. package/dist/scanner-import.d.ts +5 -11
  353. package/dist/scanner-import.d.ts.map +1 -1
  354. package/dist/scanner-import.js +16 -89
  355. package/dist/scanner-import.js.map +1 -1
  356. package/dist/security-policy.d.ts.map +1 -1
  357. package/dist/security-policy.js +26 -6
  358. package/dist/security-policy.js.map +1 -1
  359. package/dist/semgrep-findings.d.ts.map +1 -1
  360. package/dist/semgrep-findings.js +14 -48
  361. package/dist/semgrep-findings.js.map +1 -1
  362. package/dist/semgrep-platform-findings.d.ts +20 -70
  363. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  364. package/dist/semgrep-platform-findings.js +116 -333
  365. package/dist/semgrep-platform-findings.js.map +1 -1
  366. package/dist/severity-review.d.ts.map +1 -1
  367. package/dist/severity-review.js +1 -0
  368. package/dist/severity-review.js.map +1 -1
  369. package/dist/snyk-findings.d.ts +2 -0
  370. package/dist/snyk-findings.d.ts.map +1 -1
  371. package/dist/snyk-findings.js +5 -8
  372. package/dist/snyk-findings.js.map +1 -1
  373. package/dist/snyk-rest-findings.d.ts +3 -20
  374. package/dist/snyk-rest-findings.d.ts.map +1 -1
  375. package/dist/snyk-rest-findings.js +45 -217
  376. package/dist/snyk-rest-findings.js.map +1 -1
  377. package/dist/sonar-findings.d.ts +1 -1
  378. package/dist/sonar-findings.d.ts.map +1 -1
  379. package/dist/sonar-findings.js +2 -4
  380. package/dist/sonar-findings.js.map +1 -1
  381. package/dist/sonar-import.d.ts +3 -0
  382. package/dist/sonar-import.d.ts.map +1 -1
  383. package/dist/sonar-import.js +28 -30
  384. package/dist/sonar-import.js.map +1 -1
  385. package/dist/stored-finding-projection.d.ts +6 -0
  386. package/dist/stored-finding-projection.d.ts.map +1 -0
  387. package/dist/stored-finding-projection.js +129 -0
  388. package/dist/stored-finding-projection.js.map +1 -0
  389. package/dist/stored-findings-publication.d.ts +23 -0
  390. package/dist/stored-findings-publication.d.ts.map +1 -0
  391. package/dist/stored-findings-publication.js +169 -0
  392. package/dist/stored-findings-publication.js.map +1 -0
  393. package/dist/targets.d.ts +8 -1
  394. package/dist/targets.d.ts.map +1 -1
  395. package/dist/targets.js +103 -23
  396. package/dist/targets.js.map +1 -1
  397. package/dist/tenable-findings.d.ts +1 -4
  398. package/dist/tenable-findings.d.ts.map +1 -1
  399. package/dist/tenable-findings.js.map +1 -1
  400. package/dist/trivy-findings.d.ts.map +1 -1
  401. package/dist/trivy-findings.js +0 -11
  402. package/dist/trivy-findings.js.map +1 -1
  403. package/dist/trusted-executable.d.ts +7 -0
  404. package/dist/trusted-executable.d.ts.map +1 -1
  405. package/dist/trusted-executable.js +148 -37
  406. package/dist/trusted-executable.js.map +1 -1
  407. package/dist/value.js +3 -1
  408. package/dist/value.js.map +1 -1
  409. package/dist/veracode-findings.d.ts +1 -3
  410. package/dist/veracode-findings.d.ts.map +1 -1
  411. package/dist/veracode-findings.js +13 -38
  412. package/dist/veracode-findings.js.map +1 -1
  413. package/dist/version.d.ts +3 -1
  414. package/dist/version.d.ts.map +1 -1
  415. package/dist/version.js +184 -32
  416. package/dist/version.js.map +1 -1
  417. package/dist/wiz-findings.d.ts +2 -2
  418. package/dist/wiz-findings.d.ts.map +1 -1
  419. package/dist/wiz-findings.js +14 -92
  420. package/dist/wiz-findings.js.map +1 -1
  421. package/docs/classify-severity-records.md +30 -0
  422. package/docs/cli.md +537 -124
  423. package/docs/findings-service.md +22 -9
  424. package/docs/hosted-remediation.md +13 -4
  425. package/docs/sdk.md +918 -0
  426. package/package.json +15 -6
  427. package/schemas/external-findings.schema.json +2 -1
  428. package/schemas/project-config.schema.json +5 -0
  429. package/dist/hosted-scanner-v1.d.ts +0 -6
  430. package/dist/hosted-scanner-v1.d.ts.map +0 -1
  431. package/dist/hosted-scanner-v1.js +0 -60
  432. package/dist/hosted-scanner-v1.js.map +0 -1
  433. package/dist/reader-selection.d.ts +0 -15
  434. package/dist/reader-selection.d.ts.map +0 -1
  435. package/dist/reader-selection.js +0 -89
  436. package/dist/reader-selection.js.map +0 -1
  437. package/dist/semgrep-platform-v1.d.ts +0 -6
  438. package/dist/semgrep-platform-v1.d.ts.map +0 -1
  439. package/dist/semgrep-platform-v1.js +0 -83
  440. package/dist/semgrep-platform-v1.js.map +0 -1
  441. package/dist/snyk-rest-v1.d.ts +0 -28
  442. package/dist/snyk-rest-v1.d.ts.map +0 -1
  443. package/dist/snyk-rest-v1.js +0 -132
  444. package/dist/snyk-rest-v1.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAKhF,MAAM,cAAc,GAAqB;IACvC,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IACvE;QACE,kBAAkB;QAClB;YACE,OAAO;YACP,UAAU;YACV,mBAAmB;YACnB,QAAQ;YACR,gBAAgB;YAChB,QAAQ;YACR,QAAQ;YACR,SAAS;SACV;KACF;IACD,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;IAC9D,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;CACvE,CAAC;AAEF,MAAM,WAAW,GAAqB;IACpC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrE;QACE,WAAW;QACX,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,AAAD,EAAG,AAAD,EAAG,IAAI,CAAC,EAAE,EAAE,CAC1C,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACrC;KACF;IACD;QACE,+BAA+B;QAC/B;YACE,YAAY;YACZ,kBAAkB;YAClB,mBAAmB;YACnB,UAAU;YACV,UAAU;YACV,WAAW;YACX,kBAAkB;YAClB,UAAU;YACV,SAAS;SACV;KACF;IACD,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACvC;QACE,QAAQ;QACR;YACE,aAAa;YACb,gBAAgB;YAChB,iBAAiB;YACjB,gBAAgB;YAChB,SAAS;SACV;KACF;IACD,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,YAAY,GAA2B;IAC3C,OAAO,EAAE,MAAM;IACf,cAAc,EAAE,MAAM;IACtB,eAAe,EAAE,MAAM;IACvB,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,MAAM;IACZ,gBAAgB,EAAE,MAAM;IACxB,kBAAkB,EAAE,MAAM;IAC1B,wBAAwB,EAAE,MAAM;IAChC,uBAAuB,EAAE,MAAM;IAC/B,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,OAAO;IACd,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,MAAM;IAClB,aAAa,EAAE,MAAM;IACrB,aAAa,EAAE,MAAM;IACrB,eAAe,EAAE,MAAM;IACvB,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,WAAW;IAClB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,SAAS;IACrB,gBAAgB,EAAE,OAAO;IACzB,kBAAkB,EAAE,OAAO;IAC3B,gBAAgB,EAAE,OAAO;IACzB,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,SAAS;IACf,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,KAAK;IACrB,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,eAAe,EAAE,QAAQ;IACzB,eAAe,EAAE,MAAM;IACvB,aAAa,EAAE,OAAO;IACtB,cAAc,EAAE,OAAO;IACvB,EAAE,EAAE,aAAa;CAClB,CAAC;AAEF,MAAM,aAAa,GAAqB;IACtC,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;CAC/D,CAAC;AAEF,SAAS,OAAO,CAAC,GAAQ;IACvB,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACtD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,KAAa,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,MAAM;IACnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;IACtD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,IAAW,EAAE,KAAa;IAC3D,4EAA4E;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,EAAE,EACF,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EACrB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CACrD,CAAC;IACF,OAAO;QACL,GAAG,KAAK,GAAG;QACX,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;YACrC,IAAI,CAAC,WAAW;gBAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;gBAC9B,OAAO,KAAK,KAAK,KAAK,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC3D,CAAC;YACD,OAAO,IAAI,CACT,WAAW,EACX,KAAK,EACL,KAAK,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EACpD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CACnB,CAAC;QACJ,CAAC,CAAC;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAClB,IAAW,EACX,MAAwB,EACxB,cAAsB,EACtB,KAAa;IAEb,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,GAAQ,EAAE,OAAe;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IACjC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,WAAW,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3F,CAAC;QACD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;IACzD,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,AAAD,EAAG,AAAD,EAAG,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,IAAI,EAAE,CACvC,CAAC;QACF,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GACT,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,KAAK,KAAK,SAAS;gBAAE,WAAW,IAAI,cAAc,KAAK,GAAG,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,IAAW,EAAE,OAAe;IAC9C,MAAM,IAAI,GAAG,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,aAAa,CAAC;IAC7D,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CACpE,OAAO,CACR,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACxC,IAAI,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9D,OAAO,CAAC,CACN,WAAW;YACX,wDAAwD,CAAC,IAAI,CAAC,KAAK,CAAC,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC;IACjE,IAAI,OAAO,IAAI,CAAC,IAAI,IAAI,OAAO,KAAK,aAAa,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,8BAA8B;SAC5C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACzB,SAAS,CACP,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,GAAG,EAC9D,OAAO,CACR,CACF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAO,GAAG,EAAE;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,+EAA+E,CAChF,CAAC;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IACzE,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,QAAQ,CAAC,IAAI,CACX,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;iBAC7C,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO,CACvB,kBAAkB,EAClB,CAAC,CAAC,EAAE,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CACvE,CAAC;YACF,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClD,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;gBAChD,KAAK,IAAI,yBAAyB,CAAC;YACrC,CAAC;YACD,QAAQ,CAAC,IAAI,CACX,KAAK;iBACF,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;iBAC/C,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;YACF,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBACnB,QAAQ,CAAC,IAAI,CACX;oBACE,cAAc;oBACd,wBAAwB;oBACxB,EAAE;oBACF,IAAI,CACF,mDAAmD,EACnD,KAAK,EACL,IAAI,EACJ,IAAI,CACL;oBACD,2BAA2B;oBAC3B,IAAI,CACF,mGAAmG,EACnG,KAAK,EACL,IAAI,EACJ,IAAI,CACL;oBACD,IAAI,CACF,kEAAkE,EAClE,KAAK,EACL,IAAI,EACJ,IAAI,CACL;oBACD,EAAE;oBACF,yBAAyB;oBACzB,2BAA2B;iBAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;YACJ,CAAC;iBAAM,IAAI,QAAQ,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;aAAM,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9B,QAAQ,CAAC,IAAI,CACX,GAAG,CAAC,OAAO,KAAK,EAAE;gBAChB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,CAAC;gBAC5D,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAC3C,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;YACpE,QAAQ,CAAC,IAAI,CACX,GAAG,CAAC,OAAO,KAAK,MAAM;gBACpB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC;gBACnD,CAAC,CAAC,OAAO,KAAK,cAAc;oBAC1B,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,CAAC;oBACrD,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAC5C,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,KAAK,iBAAiB,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CACX,GAAG,WAAW,CACZ,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EACrC,aAAa,EACb,eAAe,EACf,KAAK,CACN,CACF,CAAC;QACJ,CAAC;aAAM,IACL,CAAC,YAAY,EAAE,eAAe,EAAE,wBAAwB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EACzE,CAAC;YACD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1C,GAAG,GAAG;gBACN,KAAK,EACH,KAAK,KAAK,YAAY;oBACpB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE;oBAC9D,CAAC,CAAC,GAAG,CAAC,KAAK;aAChB,CAAC,CAAC,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CACX,KAAK;iBACF,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;iBACjE,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CACX,IAAI,CACF,+DAA+D,EAC/D,KAAK,CACN,CACF,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACtC,CAAC","sourcesContent":["import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from \"./scan-settings.js\";\n\ntype Row = { label: string; description: string };\ntype Group = readonly [title: string, names: readonly string[]];\n\nconst COMMAND_GROUPS: readonly Group[] = [\n [\"Scan and fix\", [\"scan\", \"policy\", \"validate\", \"patch\", \"verify-fix\"]],\n [\n \"Review and share\",\n [\n \"scans\",\n \"findings\",\n \"classify-severity\",\n \"dedupe\",\n \"suggest-owners\",\n \"export\",\n \"import\",\n \"publish\",\n ],\n ],\n [\"Automate\", [\"bulk-scan\", \"scan-components\", \"install-hook\"]],\n [\"Setup and support\", [\"login\", \"logout\", \"init\", \"info\", \"feedback\"]],\n];\n\nconst SCAN_GROUPS: readonly Group[] = [\n [\"Scope\", [\"path\", \"diff\", \"head\", \"working-tree\", \"base\"]],\n [\"Configuration\", [\"config\", \"mode\", \"knowledge-base\", \"dry-run\"]],\n [\"Model and authentication\", [\"auth\", \"model\", \"effort\", \"provider\"]],\n [\n \"Deep Scan\",\n DEEP_SCAN_SETTINGS.flatMap(([, , , flag]) =>\n flag === null ? [] : [flag.slice(2)],\n ),\n ],\n [\n \"Results, progress, and limits\",\n [\n \"output-dir\",\n \"archive-existing\",\n \"owner-suggestions\",\n \"max-cost\",\n \"max-time\",\n \"show-cost\",\n \"fail-on-severity\",\n \"headless\",\n \"verbose\",\n ],\n ],\n [\"Patch after scanning\", [\"patch\", \"patch-severity\", \"create-pr\"]],\n];\n\nconst PUBLISH_GROUPS: readonly Group[] = [\n [\"Input\", [\"scan\", \"scan-dir\", \"csv\", \"finding-id\", \"workflow-id\"]],\n [\"Destination\", [\"to\", \"findings-url\"]],\n [\n \"Linear\",\n [\n \"linear-team\",\n \"linear-project\",\n \"linear-assignee\",\n \"linear-api-key\",\n \"project\",\n ],\n ],\n [\"Publishing\", [\"dry-run\", \"skip-existing\"]],\n];\n\nconst VALUE_LABELS: Record<string, string> = {\n context: \"text\",\n \"context-file\": \"file\",\n \"output-schema\": \"file\",\n config: \"file\",\n path: \"path\",\n \"knowledge-base\": \"path\",\n \"scan-prompt-file\": \"file\",\n \"validation-prompt-file\": \"file\",\n \"post-scan-prompt-file\": \"file\",\n diff: \"ref\",\n head: \"ref\",\n base: \"ref\",\n model: \"model\",\n \"output-dir\": \"path\",\n \"scan-dir\": \"path\",\n \"plugin-path\": \"path\",\n \"source-root\": \"path\",\n \"avit-template\": \"file\",\n python: \"path\",\n codex: \"key=value\",\n \"max-cost\": \"usd\",\n \"max-time\": \"minutes\",\n \"max-time-hours\": \"hours\",\n \"fail-on-severity\": \"level\",\n \"patch-severity\": \"level\",\n severity: \"level\",\n scan: \"scan-id\",\n \"finding-id\": \"id\",\n \"findings-url\": \"url\",\n output: \"file\",\n csv: \"file\",\n json: \"file\",\n rubric: \"file\",\n \"export-format\": \"format\",\n \"filter-output\": \"keys\",\n \"token-limit\": \"count\",\n \"token-offset\": \"count\",\n to: \"destination\",\n};\n\nconst OUTPUT_GROUPS: readonly Group[] = [\n [\"Help and updates\", [\"help\", \"version\", \"update\"]],\n [\"Output\", [\"format\", \"json\", \"filter-output\", \"full-output\"]],\n];\n\nfunction rowName(row: Row): string {\n return row.label.match(/--([\\w-]+)/u)?.[1] ?? row.label;\n}\n\nfunction parseRows(lines: string[]): Row[] {\n return lines.map((line) => {\n const match = line.trim().match(/^(.*?)\\s{2,}(.*)$/u);\n return { label: match?.[1] ?? line.trim(), description: match?.[2] ?? \"\" };\n });\n}\n\nfunction wrap(text: string, width: number, prefix = \"\", next = prefix): string {\n const lines: string[] = [];\n let line = prefix;\n let indent = prefix.length;\n for (const word of text.split(/\\s+/u)) {\n if (line.length > indent && line.length + 1 + word.length > width) {\n lines.push(line);\n line = next;\n indent = next.length;\n }\n line += `${line.length > indent ? \" \" : \"\"}${word}`;\n }\n lines.push(line);\n return lines.join(\"\\n\");\n}\n\nfunction renderRows(title: string, rows: Row[], width: number): string {\n // Keep long option names from moving every description across the terminal.\n const column = Math.min(\n 30,\n Math.floor(width / 2),\n Math.max(...rows.map((row) => row.label.length)) + 4,\n );\n return [\n `${title}:`,\n ...rows.map(({ label, description }) => {\n if (!description) return ` ${label}`;\n if (label.length + 4 > column) {\n return ` ${label}\\n${wrap(description, width, \" \")}`;\n }\n return wrap(\n description,\n width,\n ` ${label}${\" \".repeat(column - label.length - 2)}`,\n \" \".repeat(column),\n );\n }),\n ].join(\"\\n\");\n}\n\nfunction groupedRows(\n rows: Row[],\n groups: readonly Group[],\n remainingTitle: string,\n width: number,\n): string[] {\n const remaining = new Map(rows.map((row) => [rowName(row), row]));\n const sections: string[] = [];\n for (const [title, names] of groups) {\n const selected = names.flatMap((name) => {\n const row = remaining.get(name);\n remaining.delete(name);\n return row === undefined ? [] : [row];\n });\n if (selected.length) sections.push(renderRows(title, selected, width));\n }\n if (remaining.size) {\n sections.push(renderRows(remainingTitle, [...remaining.values()], width));\n }\n return sections;\n}\n\nfunction optionRow(row: Row, command: string): Row {\n const name = rowName(row);\n let { label, description } = row;\n label = label.replace(/<([^>]+)>/u, (_, type: string) => {\n const choices = type.split(\"|\");\n if (choices.length > 1) {\n description += `${description.endsWith(\".\") ? \"\" : \".\"} Choices: ${choices.join(\", \")}.`;\n }\n return `<${VALUE_LABELS[name] ?? (type === \"number\" ? \"count\" : name)}>`;\n });\n label = label.replace(/^--([\\w-]+), (-\\w)/u, \"$2, --$1\");\n if (command === \"scan\" && !/default:/iu.test(description)) {\n const setting = DEEP_SCAN_SETTINGS.find(\n ([, , , flag]) => flag === `--${name}`,\n );\n if (setting) {\n const value =\n DeepScanSettingsSchema.shape[setting[0]].meta()?.[\"default\"];\n if (value !== undefined) description += ` (default: ${value})`;\n }\n }\n return { label, description };\n}\n\nfunction globalRows(rows: Row[], command: string): Row[] {\n const scan = command === \"scan\" || command === \"scan import\";\n const plainOutput = [\"validate\", \"login\", \"logout\", \"export\"].includes(\n command,\n );\n const visible = rows.filter(({ label }) => {\n if (scan && label.startsWith(\"--filter-output\")) return false;\n return !(\n plainOutput &&\n /^(--format |--filter-output |--full-output$|--token-)/u.test(label)\n );\n });\n const formats = visible.find((row) => rowName(row) === \"format\");\n if (formats && (scan || command === \"scans rerun\")) {\n formats.label = formats.label.replace(\"|md\", \"\");\n }\n if (formats && command !== \"scan import\") {\n visible.push({\n label: \"--json\",\n description: \"Shorthand for --format json.\",\n });\n }\n return visible.map((row) =>\n optionRow(\n row.label === \"--help\" ? { ...row, label: \"-h, --help\" } : row,\n command,\n ),\n );\n}\n\n/** Present Incur's generated help without changing its routing or command output. */\nexport function formatCliHelp(text: string, columns = 80): string {\n const header = text.match(\n /^(codex-security(?:@[^\\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\\n]*))?\\n\\nUsage: /u,\n );\n if (!header) return text;\n const command = header[2]!.trim();\n const sections: string[] = [];\n // Presentation width only; long paths and copyable commands remain intact.\n const width = columns > 0 ? columns : 80;\n const blocks = text.trimEnd().split(/\\n\\n/u);\n const examples = blocks.find((block) => block.startsWith(\"Examples:\\n\"));\n for (const [index, block] of blocks.entries()) {\n const [title = \"\", ...lines] = block.split(\"\\n\");\n if (index === 0) {\n sections.push(\n [header[1], header[3] && wrap(header[3], width)]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n } else if (title.startsWith(\"Usage: \")) {\n let usage = block.replace(\n /([a-z])([A-Z])/gu,\n (_, lower: string, upper: string) => `${lower}-${upper.toLowerCase()}`,\n );\n if (command === \"scans\" || command === \"findings\") {\n usage = usage.replace(\"<command>\", \"[command]\");\n usage += \"\\nDefault command: list\";\n }\n sections.push(\n usage\n .split(\"\\n\")\n .map((line) => wrap(line, width, \"\", \" \"))\n .join(\"\\n\"),\n );\n if (command === \"\") {\n sections.push(\n [\n \"Get started:\",\n \" codex-security login\",\n \"\",\n wrap(\n \"In your repository, draft SECURITY.md (optional):\",\n width,\n \" \",\n \" \",\n ),\n \" codex-security policy .\",\n wrap(\n \"Review the diff and notes. Edit the draft, then copy only SECURITY.md to the Policy target shown.\",\n width,\n \" \",\n \" \",\n ),\n wrap(\n \"Skip this step to keep your existing policy or scan without one.\",\n width,\n \" \",\n \" \",\n ),\n \"\",\n \" codex-security scan .\",\n \" codex-security findings\",\n ].join(\"\\n\"),\n );\n } else if (examples) {\n sections.push(examples);\n }\n } else if (title === \"Examples:\") {\n continue;\n } else if (title === \"Commands:\") {\n const rows = parseRows(lines);\n sections.push(\n ...(command === \"\"\n ? groupedRows(rows, COMMAND_GROUPS, \"Other commands\", width)\n : [renderRows(\"Commands\", rows, width)]),\n );\n } else if (title === \"Options:\") {\n const rows = parseRows(lines).map((row) => optionRow(row, command));\n sections.push(\n ...(command === \"scan\"\n ? groupedRows(rows, SCAN_GROUPS, \"Advanced\", width)\n : command === \"publish scan\"\n ? groupedRows(rows, PUBLISH_GROUPS, \"Options\", width)\n : [renderRows(\"Options\", rows, width)]),\n );\n } else if (title === \"Global Options:\") {\n sections.push(\n ...groupedRows(\n globalRows(parseRows(lines), command),\n OUTPUT_GROUPS,\n \"Agent options\",\n width,\n ),\n );\n } else if (\n [\"Arguments:\", \"Integrations:\", \"Environment Variables:\"].includes(title)\n ) {\n const rows = parseRows(lines).map((row) => ({\n ...row,\n label:\n title === \"Arguments:\"\n ? row.label.replace(/([a-z])([A-Z])/gu, \"$1-$2\").toLowerCase()\n : row.label,\n }));\n sections.push(renderRows(title.slice(0, -1), rows, width));\n } else {\n sections.push(\n block\n .split(\"\\n\")\n .map((line) => (line.startsWith(\" \") ? line : wrap(line, width)))\n .join(\"\\n\"),\n );\n }\n }\n if (command === \"\") {\n sections.push(\n wrap(\n \"Use codex-security <command> --help for options and examples.\",\n width,\n ),\n );\n sections.push(\"Docs: https://learn.chatgpt.com/docs/security/cli\");\n }\n return `${sections.join(\"\\n\\n\")}\\n`;\n}\n"]}
1
+ {"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from \"./scan-settings.js\";\n\ntype Row = { label: string; description: string };\ntype Group = readonly [title: string, names: readonly string[]];\n\nconst COMMAND_GROUPS: readonly Group[] = [\n [\"Scan and remediate\", [\"scan\", \"policy\", \"validate\", \"patch\", \"verify-fix\"]],\n [\n \"Review results\",\n [\"scans\", \"findings\", \"classify-severity\", \"dedupe\", \"suggest-owners\"],\n ],\n [\"Import and share\", [\"import\", \"publish\", \"export\"]],\n [\"Automate\", [\"bulk-scan\", \"scan-components\", \"install-hook\"]],\n [\n \"Configure and troubleshoot\",\n [\"login\", \"logout\", \"init\", \"info\", \"feedback\", \"update\"],\n ],\n];\n\nconst SCAN_GROUPS: readonly Group[] = [\n [\"Scope\", [\"path\", \"diff\", \"head\", \"working-tree\", \"base\"]],\n [\"Configuration\", [\"config\", \"mode\", \"knowledge-base\", \"dry-run\"]],\n [\"Model and authentication\", [\"auth\", \"model\", \"effort\", \"provider\"]],\n [\n \"Deep Scan\",\n DEEP_SCAN_SETTINGS.flatMap(([, , , flag]) =>\n flag === null ? [] : [flag.slice(2)],\n ),\n ],\n [\n \"Results, progress, and limits\",\n [\n \"output-dir\",\n \"archive-existing\",\n \"owner-suggestions\",\n \"max-cost\",\n \"max-time\",\n \"show-cost\",\n \"fail-on-severity\",\n \"headless\",\n \"verbose\",\n ],\n ],\n [\"Patch after scanning\", [\"patch\", \"patch-severity\", \"create-pr\"]],\n];\n\nconst PUBLISH_GROUPS: readonly Group[] = [\n [\"Input\", [\"scan\", \"scan-dir\", \"finding-id\", \"workflow-id\"]],\n [\"Destination\", [\"to\", \"findings-url\"]],\n [\n \"Linear\",\n [\n \"linear-team\",\n \"linear-project\",\n \"linear-assignee\",\n \"linear-api-key\",\n \"project\",\n ],\n ],\n [\"Publishing\", [\"dry-run\", \"skip-existing\"]],\n];\n\nconst VALUE_LABELS: Record<string, string> = {\n context: \"text\",\n \"context-file\": \"file\",\n \"output-schema\": \"file\",\n config: \"file\",\n path: \"path\",\n \"knowledge-base\": \"path\",\n \"scan-prompt-file\": \"file\",\n \"validation-prompt-file\": \"file\",\n \"post-scan-prompt-file\": \"file\",\n diff: \"ref\",\n head: \"ref\",\n base: \"ref\",\n model: \"model\",\n \"output-dir\": \"path\",\n \"scan-dir\": \"path\",\n \"plugin-path\": \"path\",\n \"source-root\": \"path\",\n \"avit-template\": \"file\",\n python: \"path\",\n codex: \"key=value\",\n \"max-cost\": \"usd\",\n \"max-total-cost\": \"usd\",\n \"max-time\": \"minutes\",\n \"max-time-hours\": \"hours\",\n \"fail-on-severity\": \"level\",\n \"patch-severity\": \"level\",\n severity: \"level\",\n scan: \"scan-id\",\n \"finding-id\": \"id\",\n \"findings-url\": \"url\",\n output: \"file\",\n csv: \"file\",\n json: \"file\",\n rubric: \"file\",\n \"export-format\": \"format\",\n \"filter-output\": \"keys\",\n \"token-limit\": \"count\",\n \"token-offset\": \"count\",\n to: \"destination\",\n};\n\nconst OUTPUT_FLAGS = [\"format\", \"json\", \"filter-output\", \"full-output\"];\n\nconst OUTPUT_GROUPS: readonly Group[] = [\n [\"Help and version\", [\"help\", \"version\"]],\n [\"Output\", OUTPUT_FLAGS],\n];\n\nfunction rowName(row: Row): string {\n return row.label.match(/--([\\w-]+)/u)?.[1] ?? row.label;\n}\n\nfunction parseRows(lines: string[]): Row[] {\n return lines.map((line) => {\n const match = line.trim().match(/^(.*?)\\s{2,}(.*)$/u);\n return { label: match?.[1] ?? line.trim(), description: match?.[2] ?? \"\" };\n });\n}\n\nfunction wrap(text: string, width: number, prefix = \"\", next = prefix): string {\n const lines: string[] = [];\n let line = prefix;\n let indent = prefix.length;\n for (const word of text.split(/\\s+/u)) {\n if (line.length > indent && line.length + 1 + word.length > width) {\n lines.push(line);\n line = next;\n indent = next.length;\n }\n line += `${line.length > indent ? \" \" : \"\"}${word}`;\n }\n lines.push(line);\n return lines.join(\"\\n\");\n}\n\nfunction renderRows(title: string, rows: Row[], width: number): string {\n // Keep long option names from moving every description across the terminal.\n const column = Math.min(\n 30,\n Math.floor(width / 2),\n Math.max(...rows.map((row) => row.label.length)) + 4,\n );\n return [\n `${title}:`,\n ...rows.map(({ label, description }) => {\n if (!description) return ` ${label}`;\n if (label.length + 4 > column) {\n return ` ${label}\\n${wrap(description, width, \" \")}`;\n }\n return wrap(\n description,\n width,\n ` ${label}${\" \".repeat(column - label.length - 2)}`,\n \" \".repeat(column),\n );\n }),\n ].join(\"\\n\");\n}\n\nfunction groupedRows(\n rows: Row[],\n groups: readonly Group[],\n remainingTitle: string,\n width: number,\n): string[] {\n const remaining = new Map(rows.map((row) => [rowName(row), row]));\n const sections: string[] = [];\n for (const [title, names] of groups) {\n const selected = names.flatMap((name) => {\n const row = remaining.get(name);\n remaining.delete(name);\n return row === undefined ? [] : [row];\n });\n if (selected.length) sections.push(renderRows(title, selected, width));\n }\n if (remaining.size) {\n sections.push(renderRows(remainingTitle, [...remaining.values()], width));\n }\n return sections;\n}\n\nfunction optionRow(row: Row, command: string): Row {\n const name = rowName(row);\n let { label, description } = row;\n label = label.replace(/<([^>]+)>/u, (_, type: string) => {\n const choices = type.split(\"|\");\n if (choices.length > 1) {\n description += `${description.endsWith(\".\") ? \"\" : \".\"} Choices: ${choices.join(\", \")}.`;\n }\n return `<${VALUE_LABELS[name] ?? (type === \"number\" ? \"count\" : name)}>`;\n });\n if (name === \"token-limit\")\n description = \"Maximum tokens in the text view (nonnegative integer).\";\n if (name === \"token-offset\")\n description = \"Start the text view at this token (nonnegative integer).\";\n label = label.replace(/^--([\\w-]+), (-\\w)/u, \"$2, --$1\");\n if (command === \"scan\" && !/default:/iu.test(description)) {\n const setting = DEEP_SCAN_SETTINGS.find(\n ([, , , flag]) => flag === `--${name}`,\n );\n if (setting) {\n const value =\n DeepScanSettingsSchema.shape[setting[0]].meta()?.[\"default\"];\n if (value !== undefined) description += ` (default: ${value})`;\n }\n }\n return { label, description };\n}\n\nfunction globalRows(rows: Row[], command: string): Row[] {\n const scan = command === \"scan\" || command === \"scan import\";\n const plainOutput = [\"validate\", \"login\", \"logout\", \"export\"].includes(\n command,\n );\n const visible = rows.filter(({ label }) => {\n if (label === \"--update\") return false;\n if (scan && label.startsWith(\"--filter-output\")) return false;\n return !(\n plainOutput &&\n /^(--format |--filter-output |--full-output$|--token-)/u.test(label)\n );\n });\n const formats = visible.find((row) => rowName(row) === \"format\");\n if (\n formats &&\n (scan || command === \"scans rerun\" || command === \"scans resume\")\n ) {\n formats.label = formats.label.replace(\"|md\", \"\");\n }\n if (formats) {\n visible.push({\n label: \"--json\",\n description: \"Shorthand for --format json.\",\n });\n }\n return visible.map((row) =>\n optionRow(\n row.label === \"--help\" ? { ...row, label: \"-h, --help\" } : row,\n command,\n ),\n );\n}\n\n/** Present Incur's generated help without changing its routing or command output. */\nexport function formatCliHelp(text: string, columns = 80): string | undefined {\n const header = text.match(\n /^(codex-security(?:@[^\\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\\n]*))?\\n\\nUsage: /u,\n );\n if (!header) return undefined;\n const command = header[2]!.trim();\n const sections: string[] = [];\n // Presentation width only; long paths and copyable commands remain intact.\n const width = columns > 0 ? columns : 80;\n const blocks = text.trimEnd().split(/\\n\\n/u);\n const examples = blocks.find((block) => block.startsWith(\"Examples:\\n\"));\n for (const [index, block] of blocks.entries()) {\n const [title = \"\", ...lines] = block.split(\"\\n\");\n if (index === 0) {\n sections.push(\n [header[1], header[3] && wrap(header[3], width)]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n } else if (title.startsWith(\"Usage: \")) {\n let usage = block.replace(\n /([a-z])([A-Z])/gu,\n (_, lower: string, upper: string) => `${lower}-${upper.toLowerCase()}`,\n );\n if (command === \"scans\" || command === \"findings\") {\n usage = usage.replace(\"<command>\", \"[command]\");\n usage += \"\\nDefault command: list\";\n }\n sections.push(\n usage\n .split(\"\\n\")\n .map((line) =>\n wrap(\n line.trimStart(),\n width,\n line.startsWith(\" \") ? \" \" : \"\",\n \" \",\n ),\n )\n .join(\"\\n\"),\n );\n if (command === \"\") {\n sections.push(\n [\n \"Get started:\",\n \" codex-security scan . --dry-run\",\n \" codex-security login\",\n \" codex-security scan .\",\n \" codex-security scans show\",\n ].join(\"\\n\"),\n );\n } else if (command === \"import\") {\n sections.push(\n renderRows(\n \"Choose your input\",\n [\n {\n label: \"Live provider\",\n description: \"Choose a collector below.\",\n },\n {\n label: \"CLI, API, or MCP source\",\n description:\n \"Ask Codex to import it using the publish-findings skill.\",\n },\n {\n label: \"Workbench findings\",\n description:\n \"Ask Codex to publish a stored import or selected finding versions.\",\n },\n {\n label: \"Saved vendor report\",\n description:\n \"See codex-security publish findings --help for local storage and publication.\",\n },\n {\n label: \"Codex Security CSV or JSON\",\n description:\n \"See codex-security scan import --help to add the export to local scan history.\",\n },\n ],\n width,\n ),\n );\n } else if (examples) {\n sections.push(examples);\n }\n } else if (title === \"Examples:\") {\n continue;\n } else if (title === \"Commands:\") {\n const rows = parseRows(lines);\n sections.push(\n ...(command === \"\"\n ? groupedRows(rows, COMMAND_GROUPS, \"Other commands\", width)\n : [renderRows(\"Commands\", rows, width)]),\n );\n } else if (title === \"Options:\") {\n const options = parseRows(lines)\n .filter(\n (row) =>\n !(command === \"publish scan\" && rowName(row) === \"csv\") &&\n !(command === \"publish check\" && rowName(row) === \"to\"),\n )\n .map((row) => optionRow(row, command));\n const rows = options.filter(\n (row) => !row.description.startsWith(\"[deprecated]\"),\n );\n sections.push(\n ...(command === \"scan\"\n ? groupedRows(rows, SCAN_GROUPS, \"Advanced\", width)\n : command === \"publish scan\"\n ? groupedRows(rows, PUBLISH_GROUPS, \"Options\", width)\n : [renderRows(\"Options\", rows, width)]),\n );\n const deprecated = options.filter((row) =>\n row.description.startsWith(\"[deprecated]\"),\n );\n if (deprecated.length)\n sections.push(renderRows(\"Deprecated options\", deprecated, width));\n } else if (title === \"Global Options:\") {\n const rows = globalRows(parseRows(lines), command);\n if (command === \"\") {\n sections.push(\n ...groupedRows(rows, OUTPUT_GROUPS, \"Agent options\", width),\n );\n } else {\n const outputRows = rows.filter((row) =>\n OUTPUT_FLAGS.includes(rowName(row)),\n );\n if (outputRows.length)\n sections.push(renderRows(\"Output\", outputRows, width));\n sections.push(\n wrap(\n \"See codex-security --help for shared help and agent options.\",\n width,\n ),\n );\n }\n } else if (\n [\"Arguments:\", \"Integrations:\", \"Environment Variables:\"].includes(title)\n ) {\n const rows = parseRows(lines).map((row) => ({\n ...row,\n label:\n title === \"Arguments:\"\n ? row.label.replace(/([a-z])([A-Z])/gu, \"$1-$2\").toLowerCase()\n : row.label,\n }));\n sections.push(renderRows(title.slice(0, -1), rows, width));\n } else {\n sections.push(\n block\n .split(\"\\n\")\n .map((line) => (line.startsWith(\" \") ? line : wrap(line, width)))\n .join(\"\\n\"),\n );\n }\n }\n if (command === \"completions\") {\n sections.push(\n wrap(\n \"Shell setup: https://github.com/openai/codex-security/blob/main/sdk/typescript/docs/cli.md#shell-completions\",\n width,\n ),\n );\n }\n if (command === \"\") {\n sections.push(\n wrap(\n \"Use codex-security <command> --help for options and examples.\",\n width,\n ),\n );\n sections.push(\"Docs: https://learn.chatgpt.com/docs/security/cli\");\n }\n return `${sections.join(\"\\n\\n\")}\\n`;\n}\n"]}
@@ -0,0 +1,3 @@
1
+ import { type FailureSeverity } from "./scan-settings.js";
2
+ export declare function installManagedHook(hook: string, command: string, threshold: FailureSeverity): Promise<void>;
3
+ //# sourceMappingURL=cli-hook.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-hook.d.ts","sourceRoot":"","sources":["../src/cli-hook.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAiFf"}
@@ -0,0 +1,87 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { constants } from "node:fs";
3
+ import { access, lstat, mkdir, open, rename, rm, writeFile, } from "node:fs/promises";
4
+ import { dirname } from "node:path";
5
+ import { REPORTABLE_SEVERITIES, } from "./scan-settings.js";
6
+ import { UNSUPPORTED_GIT_ENVIRONMENT } from "./targets.js";
7
+ export async function installManagedHook(hook, command, threshold) {
8
+ const header = "#!/bin/sh\nset -eu\n";
9
+ const unset = `unset ${[...UNSUPPORTED_GIT_ENVIRONMENT].join(" ")}\n`;
10
+ const scan = (launcher, level) => `exec ${launcher} scan . --working-tree --fail-on-severity ${level}\n`;
11
+ const contents = header + unset + scan(command, threshold);
12
+ await mkdir(dirname(hook), { recursive: true });
13
+ try {
14
+ await writeFile(hook, contents, { flag: "wx", mode: 0o755 });
15
+ }
16
+ catch (error) {
17
+ if (error.code !== "EEXIST")
18
+ throw error;
19
+ }
20
+ const refuse = () => new Error(`A pre-commit hook already exists at ${hook}.`);
21
+ const templates = REPORTABLE_SEVERITIES.flatMap((level) => [
22
+ header + unset + scan(command, level),
23
+ header +
24
+ "unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE\n" +
25
+ scan(command, level),
26
+ header + scan(command, level),
27
+ header + scan("npx --no-install codex-security", level),
28
+ ]);
29
+ const selected = await lstat(hook, { bigint: true });
30
+ if (!selected.isFile())
31
+ throw refuse();
32
+ const file = await open(hook, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
33
+ try {
34
+ const opened = await file.stat({ bigint: true });
35
+ if (!opened.isFile() ||
36
+ opened.dev !== selected.dev ||
37
+ opened.ino !== selected.ino ||
38
+ opened.nlink !== 1n ||
39
+ opened.size > Math.max(...templates.map((t) => Buffer.byteLength(t))))
40
+ throw refuse();
41
+ const previous = await file.readFile("utf8");
42
+ if (!templates.includes(previous))
43
+ throw refuse();
44
+ if (previous === contents) {
45
+ if (process.platform !== "win32") {
46
+ try {
47
+ await access(hook, constants.X_OK);
48
+ }
49
+ catch {
50
+ await file.chmod((Number(opened.mode) & 0o777) | 0o100);
51
+ await access(hook, constants.X_OK);
52
+ }
53
+ }
54
+ return;
55
+ }
56
+ }
57
+ finally {
58
+ // Windows can deny replacement while the destination is open.
59
+ await file.close();
60
+ }
61
+ const staged = `${hook}.${randomUUID()}.tmp`;
62
+ const replacement = await open(staged, "wx", 0o600);
63
+ try {
64
+ try {
65
+ await replacement.writeFile(contents);
66
+ if (process.platform !== "win32")
67
+ await replacement.chmod((Number(selected.mode) & 0o777) | 0o100);
68
+ }
69
+ finally {
70
+ await replacement.close();
71
+ }
72
+ const current = await lstat(hook, { bigint: true });
73
+ if (!current.isFile() ||
74
+ current.dev !== selected.dev ||
75
+ current.ino !== selected.ino ||
76
+ current.ctimeNs !== selected.ctimeNs ||
77
+ current.nlink !== selected.nlink)
78
+ throw refuse();
79
+ await rename(staged, hook);
80
+ if (process.platform !== "win32")
81
+ await access(hook, constants.X_OK);
82
+ }
83
+ finally {
84
+ await rm(staged, { force: true });
85
+ }
86
+ }
87
+ //# sourceMappingURL=cli-hook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-hook.js","sourceRoot":"","sources":["../src/cli-hook.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { constants } from \"node:fs\";\nimport {\n access,\n lstat,\n mkdir,\n open,\n rename,\n rm,\n writeFile,\n} from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\nimport {\n REPORTABLE_SEVERITIES,\n type FailureSeverity,\n} from \"./scan-settings.js\";\nimport { UNSUPPORTED_GIT_ENVIRONMENT } from \"./targets.js\";\n\nexport async function installManagedHook(\n hook: string,\n command: string,\n threshold: FailureSeverity,\n): Promise<void> {\n const header = \"#!/bin/sh\\nset -eu\\n\";\n const unset = `unset ${[...UNSUPPORTED_GIT_ENVIRONMENT].join(\" \")}\\n`;\n const scan = (launcher: string, level: FailureSeverity) =>\n `exec ${launcher} scan . --working-tree --fail-on-severity ${level}\\n`;\n const contents = header + unset + scan(command, threshold);\n await mkdir(dirname(hook), { recursive: true });\n try {\n await writeFile(hook, contents, { flag: \"wx\", mode: 0o755 });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n }\n\n const refuse = () =>\n new Error(`A pre-commit hook already exists at ${hook}.`);\n const templates = REPORTABLE_SEVERITIES.flatMap((level) => [\n header + unset + scan(command, level),\n header +\n \"unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE\\n\" +\n scan(command, level),\n header + scan(command, level),\n header + scan(\"npx --no-install codex-security\", level),\n ]);\n const selected = await lstat(hook, { bigint: true });\n if (!selected.isFile()) throw refuse();\n const file = await open(\n hook,\n constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK,\n );\n try {\n const opened = await file.stat({ bigint: true });\n if (\n !opened.isFile() ||\n opened.dev !== selected.dev ||\n opened.ino !== selected.ino ||\n opened.nlink !== 1n ||\n opened.size > Math.max(...templates.map((t) => Buffer.byteLength(t)))\n )\n throw refuse();\n const previous = await file.readFile(\"utf8\");\n if (!templates.includes(previous)) throw refuse();\n if (previous === contents) {\n if (process.platform !== \"win32\") {\n try {\n await access(hook, constants.X_OK);\n } catch {\n await file.chmod((Number(opened.mode) & 0o777) | 0o100);\n await access(hook, constants.X_OK);\n }\n }\n return;\n }\n } finally {\n // Windows can deny replacement while the destination is open.\n await file.close();\n }\n\n const staged = `${hook}.${randomUUID()}.tmp`;\n const replacement = await open(staged, \"wx\", 0o600);\n try {\n try {\n await replacement.writeFile(contents);\n if (process.platform !== \"win32\")\n await replacement.chmod((Number(selected.mode) & 0o777) | 0o100);\n } finally {\n await replacement.close();\n }\n const current = await lstat(hook, { bigint: true });\n if (\n !current.isFile() ||\n current.dev !== selected.dev ||\n current.ino !== selected.ino ||\n current.ctimeNs !== selected.ctimeNs ||\n current.nlink !== selected.nlink\n )\n throw refuse();\n await rename(staged, hook);\n if (process.platform !== \"win32\") await access(hook, constants.X_OK);\n } finally {\n await rm(staged, { force: true });\n }\n}\n"]}
@@ -0,0 +1,13 @@
1
+ import { Cli, z } from "incur";
2
+ export declare const completionShell: z.ZodEnum<{
3
+ bash: "bash";
4
+ fish: "fish";
5
+ nushell: "nushell";
6
+ zsh: "zsh";
7
+ }>;
8
+ /** Complete shell words without dispatching or validating any command. */
9
+ export declare function completeCli(cli: Cli.Cli, cliOptions: Cli.create.Options, shell: z.infer<typeof completionShell>, argv: readonly string[]): string;
10
+ /** Incur dispatches its built-in writers before schema and version. Serve
11
+ * ordinary command groups so its normal parser and metadata handling run first. */
12
+ export declare function serveIntegration(argv: string[], cli: Cli.Cli, cliOptions: Cli.create.Options, output: Cli.serve.Options, command: string | undefined, literalArgs: readonly string[]): Promise<boolean>;
13
+ //# sourceMappingURL=cli-integrations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-integrations.d.ts","sourceRoot":"","sources":["../src/cli-integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAiC,CAAC,EAAE,MAAM,OAAO,CAAC;AAQ9D,eAAO,MAAM,eAAe;;;;;EAA6C,CAAC;AA8O1E,0EAA0E;AAC1E,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,EACtC,IAAI,EAAE,SAAS,MAAM,EAAE,UAuBxB;AAED;mFACmF;AACnF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAC9B,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,OAAO,CAAC,CA4HlB"}
@@ -0,0 +1,333 @@
1
+ import { Cli, Completions, Help, SyncSkills, z } from "incur";
2
+ import { statSync } from "node:fs";
3
+ import { homedir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { parseArgs } from "node:util";
6
+ import { registerMcp } from "./cli-mcp.js";
7
+ const cliName = "codex-security";
8
+ export const completionShell = z.enum(["bash", "fish", "nushell", "zsh"]);
9
+ const depth = z
10
+ .number()
11
+ .int()
12
+ .nonnegative()
13
+ .optional()
14
+ .describe("Grouping depth for generated skill files (default: 1).");
15
+ const scope = z
16
+ .enum(["project", "user"])
17
+ .optional()
18
+ .describe("Installation scope (default: user).");
19
+ const noGlobal = z
20
+ .boolean()
21
+ .optional()
22
+ .describe("Compatibility spelling for --scope project.");
23
+ function projectScope(options) {
24
+ if (options.noGlobal && options.scope === "user")
25
+ throw new Error("--scope user conflicts with --no-global.");
26
+ return options.noGlobal === true || options.scope === "project";
27
+ }
28
+ const descriptions = {
29
+ skills: "Manage generated CLI command guidance. The Codex Security plugin provides scan and remediation workflows.",
30
+ mcp: "Register the read-only info tool or check its server startup and catalog.",
31
+ };
32
+ // Node's tokenizer rejects surplus positionals and missing values such as
33
+ // --command --no-global before an installer can consume the scope switch.
34
+ const boolean = { type: "boolean" };
35
+ const string = { type: "string" };
36
+ const formatOptions = {
37
+ json: boolean,
38
+ format: string,
39
+ "full-output": boolean,
40
+ "filter-output": string,
41
+ "token-count": boolean,
42
+ "token-limit": string,
43
+ "token-offset": string,
44
+ };
45
+ const outputOptions = {
46
+ ...formatOptions,
47
+ help: { ...boolean, short: "h" },
48
+ schema: boolean,
49
+ version: boolean,
50
+ llms: boolean,
51
+ "llms-full": boolean,
52
+ };
53
+ const options = {
54
+ ...outputOptions,
55
+ depth: string,
56
+ scope: string,
57
+ all: boolean,
58
+ exec: string,
59
+ package: string,
60
+ arg: { ...string, multiple: true },
61
+ "no-global": boolean,
62
+ command: { ...string, short: "c" },
63
+ agent: { ...string, multiple: true },
64
+ };
65
+ function integrationGroups(cli, cliOptions, invocation) {
66
+ const { output, plain, full } = invocation ?? {};
67
+ const commands = Cli.toCommands.get(cli);
68
+ const config = {
69
+ sync: false,
70
+ update: false,
71
+ version: cliOptions.version,
72
+ };
73
+ const prefix = invocation ? cliName + " " : "";
74
+ async function builtin(args) {
75
+ let text = "";
76
+ await cli.serve(args, {
77
+ ...output,
78
+ stdout: (chunk) => {
79
+ text += chunk;
80
+ },
81
+ });
82
+ return text.trimEnd();
83
+ }
84
+ const skills = Cli.create(prefix + "skills", {
85
+ ...config,
86
+ description: descriptions.skills,
87
+ aliases: ["skill"],
88
+ })
89
+ .command("add", {
90
+ description: "Install generated CLI command guidance in the user profile or current project.",
91
+ options: z.object({ depth, scope, noGlobal }),
92
+ async run({ options }) {
93
+ const { depth } = options;
94
+ const local = projectScope(options);
95
+ if (plain)
96
+ return builtin([
97
+ "skills",
98
+ "add",
99
+ ...(local ? ["--no-global"] : []),
100
+ ...(depth === undefined ? [] : ["--depth", String(depth)]),
101
+ ]);
102
+ const result = await SyncSkills.sync(cliName, commands, {
103
+ depth,
104
+ global: !local,
105
+ description: cliOptions.description,
106
+ });
107
+ return {
108
+ skills: result.paths,
109
+ ...(full ? { agents: result.agents } : {}),
110
+ };
111
+ },
112
+ })
113
+ .command("list", {
114
+ aliases: ["ls"],
115
+ description: "List generated CLI guidance for one grouping depth. Use the same depth as skills add to check an installation.",
116
+ options: z.object({ depth }),
117
+ async run({ options: { depth } }) {
118
+ const entries = await SyncSkills.list(cliName, commands, {
119
+ depth,
120
+ description: cliOptions.description,
121
+ });
122
+ const roots = { project: process.cwd(), user: homedir() };
123
+ const skills = entries.map((skill) => {
124
+ const locations = Object.entries(roots).flatMap(([scope, root]) => {
125
+ const path = join(root, ".agents", "skills", skill.name, "SKILL.md");
126
+ return statSync(path, { throwIfNoEntry: false })?.isFile()
127
+ ? [{ scope, path }]
128
+ : [];
129
+ });
130
+ return { ...skill, installed: locations.length > 0, locations };
131
+ });
132
+ if (!plain)
133
+ return skills;
134
+ return [
135
+ `Skill grouping depth: ${depth ?? 1}`,
136
+ ...skills.map(({ name, installed, description, locations }) => [
137
+ ` ${installed ? "✓" : "✗"} ${name} ${description ?? ""}`,
138
+ ...locations.map(({ scope, path }) => ` ${scope}: ${path}`),
139
+ ].join("\n")),
140
+ "",
141
+ `${skills.length} skill${skills.length === 1 ? "" : "s"} (${skills.filter((skill) => skill.installed).length} installed)`,
142
+ ].join("\n");
143
+ },
144
+ });
145
+ const mcp = Cli.create(prefix + "mcp", {
146
+ ...config,
147
+ description: descriptions.mcp,
148
+ })
149
+ .command("doctor", {
150
+ description: "Check the current CLI's MCP startup and tool catalog. Connect from your client to test its registered launcher.",
151
+ run: async () => JSON.parse(await builtin(["mcp", "doctor", "--json"])),
152
+ })
153
+ .command("add", {
154
+ description: "Register the read-only info tool with detected clients. Use --agent NAME or --all when no clients are detected. Amp supports user scope only.",
155
+ options: z.object({
156
+ agent: z
157
+ .array(z.string().min(1))
158
+ .optional()
159
+ .describe("Target a specific agent. Repeat to select more agents."),
160
+ all: z
161
+ .boolean()
162
+ .optional()
163
+ .describe("Register all compatible clients in the selected scope."),
164
+ exec: z
165
+ .string()
166
+ .min(1)
167
+ .optional()
168
+ .describe("Literal executable name or path."),
169
+ package: z
170
+ .string()
171
+ .min(1)
172
+ .optional()
173
+ .describe("Run this npm package with npx."),
174
+ arg: z
175
+ .array(z.string())
176
+ .optional()
177
+ .describe("Literal argument to --exec or --package. Repeat in order. Use --arg=VALUE for flags."),
178
+ command: z
179
+ .string()
180
+ .min(1)
181
+ .optional()
182
+ .describe("Launcher command line or HTTP(S) URL. For literal arguments use --exec and --arg."),
183
+ scope,
184
+ noGlobal,
185
+ }),
186
+ alias: { command: "c" },
187
+ async run({ options }) {
188
+ const result = await registerMcp(cliName, options, cliOptions.mcp.command, projectScope(options));
189
+ if (plain)
190
+ return [
191
+ `✓ Registered ${cliName} as MCP server`,
192
+ ...(result.agents.length
193
+ ? [` Agents: ${result.agents.join(", ")}`]
194
+ : []),
195
+ ].join("\n");
196
+ return { name: cliName, ...result };
197
+ },
198
+ });
199
+ if (!invocation) {
200
+ cli
201
+ .command(skills)
202
+ .command(mcp)
203
+ .command("completions", {
204
+ description: "Generate a shell completion script.",
205
+ args: z.object({ shell: completionShell }),
206
+ run: () => undefined,
207
+ });
208
+ // Incur mounts aliases for leaf commands, but not for a whole group.
209
+ commands.set("skill", { _alias: true, target: "skills" });
210
+ }
211
+ return { skills, mcp };
212
+ }
213
+ /** Complete shell words without dispatching or validating any command. */
214
+ export function completeCli(cli, cliOptions, shell, argv) {
215
+ const words = argv[0] === "--" ? argv.slice(1) : [...argv];
216
+ if (words.length === 0)
217
+ return [cliName, ...(cliOptions.aliases ?? [])]
218
+ .map((name) => Completions.register(shell, name))
219
+ .join("\n");
220
+ const index = Number(process.env["_COMPLETE_INDEX"] ?? words.length - 1);
221
+ if (!Number.isSafeInteger(index) || index < 0 || index > words.length)
222
+ return "";
223
+ integrationGroups(cli, cliOptions);
224
+ const candidates = Completions.complete(Cli.toCommands.get(cli), undefined, words, index, {
225
+ schema: z.object({
226
+ format: z.enum(["toon", "json", "yaml", "md", "jsonl"]),
227
+ }),
228
+ });
229
+ return Completions.format(shell, candidates);
230
+ }
231
+ /** Incur dispatches its built-in writers before schema and version. Serve
232
+ * ordinary command groups so its normal parser and metadata handling run first. */
233
+ export async function serveIntegration(argv, cli, cliOptions, output, command, literalArgs) {
234
+ const manifest = (argv.includes("--llms") || argv.includes("--llms-full")) &&
235
+ !argv.some((arg) => ["--help", "-h", "--version", "--schema"].includes(arg));
236
+ const group = command === "skill" ? "skills" : command;
237
+ const integration = group === "mcp" || group === "skills";
238
+ if (!integration && !manifest && group !== "completions")
239
+ return false;
240
+ if (group === "completions") {
241
+ const [, shell, ...extra] = [
242
+ ...parseArgs({
243
+ args: argv,
244
+ options: outputOptions,
245
+ allowPositionals: true,
246
+ }).positionals,
247
+ ...literalArgs,
248
+ ];
249
+ if (extra.length)
250
+ throw new Error("Unexpected positional argument for completions.");
251
+ if (shell !== undefined && !completionShell.safeParse(shell).success)
252
+ throw new Error(`Unknown shell. Supported: ${completionShell.options.join(", ")}.`);
253
+ if (argv.includes("--schema") || argv.includes("--version")) {
254
+ const section = Cli.create(cliName + " completions", {
255
+ version: cliOptions.version,
256
+ update: false,
257
+ sync: false,
258
+ args: z.object({ shell: completionShell }),
259
+ run: () => undefined,
260
+ });
261
+ await section.serve(argv.filter((arg) => arg !== group && arg !== shell), output);
262
+ return true;
263
+ }
264
+ if (!manifest) {
265
+ await cli.serve([...argv, ...literalArgs], output);
266
+ return true;
267
+ }
268
+ }
269
+ const { tokens, positionals, values } = parseArgs({
270
+ args: argv,
271
+ options,
272
+ allowPositionals: true,
273
+ tokens: true,
274
+ strict: integration,
275
+ });
276
+ const plain = !Object.keys(formatOptions).some((key) => Object.hasOwn(values, key));
277
+ const full = values["full-output"] === true;
278
+ const { skills, mcp } = integrationGroups(cli, cliOptions, manifest ? undefined : { output, plain, full });
279
+ if (integration) {
280
+ const section = group === "mcp" ? mcp : skills;
281
+ const [, verb, ...extra] = positionals;
282
+ if (literalArgs.length || extra.length)
283
+ throw new Error(`Unexpected positional argument for ${group}${verb ? " " + verb : ""}.`);
284
+ if (verb && !Cli.toCommands.get(section).has(verb)) {
285
+ await cli.serve([group, verb, "--help"], output);
286
+ return true;
287
+ }
288
+ }
289
+ if (manifest) {
290
+ // Put the mode first so a missing format/filter operand cannot consume it
291
+ // and fall through to a command handler.
292
+ const flag = argv.includes("--llms-full") ? "--llms-full" : "--llms";
293
+ await cli.serve([
294
+ flag,
295
+ ...argv.filter((arg) => !["--llms", "--llms-full", "--update"].includes(arg)),
296
+ ], output);
297
+ return true;
298
+ }
299
+ if (!integration)
300
+ return false;
301
+ const section = group === "mcp" ? mcp : skills;
302
+ const [, verb] = positionals;
303
+ if (!verb && !values.version) {
304
+ const invalid = tokens.find((token) => token.kind === "option" && !Object.hasOwn(outputOptions, token.name));
305
+ if (invalid?.kind === "option")
306
+ throw new Error(`Unknown option for ${group}: ${invalid.rawName}`);
307
+ const children = Array.from(Cli.toCommands.get(section)).flatMap(([name, entry]) => "description" in entry
308
+ ? [{ name, description: entry.description }]
309
+ : []);
310
+ output.stdout?.(Help.formatRoot(`${cliName} ${group}`, {
311
+ aliases: section === skills ? ["skill"] : [],
312
+ description: descriptions[group],
313
+ commands: children,
314
+ }) + "\n");
315
+ return true;
316
+ }
317
+ // The public flag names a scope directly. Incur reserves --no-* for
318
+ // negation; pass its schema's field name after Node tokenizes the CLI flag.
319
+ const args = argv.slice();
320
+ const groupToken = tokens.find((token) => token.kind === "positional");
321
+ for (const token of tokens) {
322
+ if (token.kind !== "option")
323
+ continue;
324
+ if (token.name === "depth" && !token.value?.trim())
325
+ throw new Error("--depth requires a nonnegative integer.");
326
+ if (token.name === "no-global")
327
+ args[token.index] = "--noGlobal";
328
+ }
329
+ args.splice(groupToken.index, 1);
330
+ await section.serve(args, output);
331
+ return true;
332
+ }
333
+ //# sourceMappingURL=cli-integrations.js.map