@openai/codex-security 0.1.27 → 0.1.29

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 (214) hide show
  1. package/README.md +328 -59
  2. package/_bundled_plugin/examples/completed-scan/report.md +0 -1
  3. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  4. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  5. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  6. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  7. package/_bundled_plugin/references/artifact-storage.md +56 -0
  8. package/_bundled_plugin/references/config-preflight.md +7 -1
  9. package/_bundled_plugin/references/final-report.md +2 -0
  10. package/_bundled_plugin/references/scan-artifacts.md +6 -14
  11. package/_bundled_plugin/references/scan-prologue.md +2 -0
  12. package/_bundled_plugin/references/security-guidance.md +2 -0
  13. package/_bundled_plugin/scripts/deep_scan_config.py +10 -8
  14. package/_bundled_plugin/scripts/deep_scan_defaults.json +8 -0
  15. package/_bundled_plugin/scripts/finalize_scan_contract.py +2 -0
  16. package/_bundled_plugin/scripts/generate_in_scope_files.py +12 -2
  17. package/_bundled_plugin/scripts/generate_rank_input.py +1 -6
  18. package/_bundled_plugin/scripts/rank_preview.py +8 -7
  19. package/_bundled_plugin/scripts/report_projection.py +0 -1
  20. package/_bundled_plugin/scripts/reserved_artifact_paths.json +6 -0
  21. package/_bundled_plugin/scripts/windows_scan_local_files.py +1 -3
  22. package/_bundled_plugin/scripts/workbench/storage.py +18 -0
  23. package/_bundled_plugin/scripts/workbench_cli.py +13 -0
  24. package/_bundled_plugin/scripts/workbench_dashboard.py +24 -3
  25. package/_bundled_plugin/scripts/workbench_db.py +13 -13
  26. package/_bundled_plugin/scripts/workbench_saved_results.py +77 -1
  27. package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -10
  28. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +2 -0
  29. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +2 -0
  30. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +5 -1
  31. package/_bundled_plugin/skills/finding-discovery/SKILL.md +2 -0
  32. package/_bundled_plugin/skills/fix-finding/SKILL.md +3 -1
  33. package/_bundled_plugin/skills/fix-finding/agents/openai.yaml +1 -1
  34. package/_bundled_plugin/skills/propose-security-hardening/SKILL.md +2 -0
  35. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +5 -1
  36. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -0
  37. package/_bundled_plugin/skills/validation/SKILL.md +2 -0
  38. package/_bundled_plugin/skills/vulnerability-writeup/SKILL.md +2 -0
  39. package/dist/api.d.ts +7 -23
  40. package/dist/api.d.ts.map +1 -1
  41. package/dist/api.js +109 -113
  42. package/dist/api.js.map +1 -1
  43. package/dist/auth.d.ts.map +1 -1
  44. package/dist/auth.js.map +1 -1
  45. package/dist/bulk-scan-discovery.d.ts +1 -1
  46. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  47. package/dist/bulk-scan-discovery.js +2 -2
  48. package/dist/bulk-scan-discovery.js.map +1 -1
  49. package/dist/classify-scan-severity.js.map +1 -1
  50. package/dist/classify-severity.d.ts.map +1 -1
  51. package/dist/classify-severity.js.map +1 -1
  52. package/dist/cli-scan-logs-json.d.ts +3 -0
  53. package/dist/cli-scan-logs-json.d.ts.map +1 -0
  54. package/dist/cli-scan-logs-json.js +22 -0
  55. package/dist/cli-scan-logs-json.js.map +1 -0
  56. package/dist/cli.d.ts +6 -2
  57. package/dist/cli.d.ts.map +1 -1
  58. package/dist/cli.js +802 -394
  59. package/dist/cli.js.map +1 -1
  60. package/dist/cloud-publish.js.map +1 -1
  61. package/dist/component-plan.js.map +1 -1
  62. package/dist/component-scan.d.ts +4 -2
  63. package/dist/component-scan.d.ts.map +1 -1
  64. package/dist/component-scan.js +7 -1
  65. package/dist/component-scan.js.map +1 -1
  66. package/dist/config-path.d.ts +6 -0
  67. package/dist/config-path.d.ts.map +1 -0
  68. package/dist/config-path.js +6 -0
  69. package/dist/config-path.js.map +1 -0
  70. package/dist/config.d.ts +2 -0
  71. package/dist/config.d.ts.map +1 -1
  72. package/dist/config.js +13 -3
  73. package/dist/config.js.map +1 -1
  74. package/dist/contract.js.map +1 -1
  75. package/dist/cost-model.d.ts +20 -6
  76. package/dist/cost-model.d.ts.map +1 -1
  77. package/dist/cost-model.js +73 -8
  78. package/dist/cost-model.js.map +1 -1
  79. package/dist/cost.d.ts.map +1 -1
  80. package/dist/custom-publish.js.map +1 -1
  81. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  82. package/dist/deduplication/checkpointed-review.js.map +1 -1
  83. package/dist/deduplication/codex-review.d.ts.map +1 -1
  84. package/dist/deduplication/codex-review.js +26 -4
  85. package/dist/deduplication/codex-review.js.map +1 -1
  86. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  87. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  88. package/dist/deduplication/deduplication.d.ts +12 -1
  89. package/dist/deduplication/deduplication.d.ts.map +1 -1
  90. package/dist/deduplication/deduplication.js +41 -7
  91. package/dist/deduplication/deduplication.js.map +1 -1
  92. package/dist/deduplication/refusal.d.ts +3 -0
  93. package/dist/deduplication/refusal.d.ts.map +1 -0
  94. package/dist/deduplication/refusal.js +16 -0
  95. package/dist/deduplication/refusal.js.map +1 -0
  96. package/dist/deduplication/scan.d.ts.map +1 -1
  97. package/dist/deduplication/scan.js.map +1 -1
  98. package/dist/deep-config.d.ts +17 -0
  99. package/dist/deep-config.d.ts.map +1 -0
  100. package/dist/deep-config.js +145 -0
  101. package/dist/deep-config.js.map +1 -0
  102. package/dist/deep-progress.d.ts.map +1 -1
  103. package/dist/deep-scan-defaults.d.ts +9 -0
  104. package/dist/deep-scan-defaults.d.ts.map +1 -0
  105. package/dist/deep-scan-defaults.js +10 -0
  106. package/dist/deep-scan-defaults.js.map +1 -0
  107. package/dist/errors.d.ts +1 -1
  108. package/dist/errors.d.ts.map +1 -1
  109. package/dist/errors.js +2 -2
  110. package/dist/errors.js.map +1 -1
  111. package/dist/feedback.d.ts.map +1 -1
  112. package/dist/feedback.js +21 -7
  113. package/dist/feedback.js.map +1 -1
  114. package/dist/finding-catalogue.js.map +1 -1
  115. package/dist/finding-workflow.d.ts.map +1 -1
  116. package/dist/finding-workflow.js.map +1 -1
  117. package/dist/findings-client.d.ts.map +1 -1
  118. package/dist/findings-client.js.map +1 -1
  119. package/dist/findings-import.d.ts +6 -6
  120. package/dist/github.d.ts +625 -7
  121. package/dist/github.d.ts.map +1 -1
  122. package/dist/github.js.map +1 -1
  123. package/dist/import-scan.js.map +1 -1
  124. package/dist/index.d.ts +6 -0
  125. package/dist/index.d.ts.map +1 -1
  126. package/dist/index.js +1 -0
  127. package/dist/index.js.map +1 -1
  128. package/dist/knowledge-base.d.ts.map +1 -1
  129. package/dist/knowledge-base.js +17 -6
  130. package/dist/knowledge-base.js.map +1 -1
  131. package/dist/models.d.ts.map +1 -1
  132. package/dist/models.js.map +1 -1
  133. package/dist/multiscan.d.ts +6 -6
  134. package/dist/multiscan.d.ts.map +1 -1
  135. package/dist/multiscan.js +69 -4
  136. package/dist/multiscan.js.map +1 -1
  137. package/dist/patch-tui.d.ts.map +1 -1
  138. package/dist/patch-tui.js.map +1 -1
  139. package/dist/project-config-schema.d.ts +191 -0
  140. package/dist/project-config-schema.d.ts.map +1 -0
  141. package/dist/project-config-schema.js +85 -0
  142. package/dist/project-config-schema.js.map +1 -0
  143. package/dist/project-config.d.ts +50 -0
  144. package/dist/project-config.d.ts.map +1 -0
  145. package/dist/project-config.js +220 -0
  146. package/dist/project-config.js.map +1 -0
  147. package/dist/prompt-files.d.ts +13 -0
  148. package/dist/prompt-files.d.ts.map +1 -0
  149. package/dist/prompt-files.js +74 -0
  150. package/dist/prompt-files.js.map +1 -0
  151. package/dist/publication-events.d.ts.map +1 -1
  152. package/dist/publication-events.js.map +1 -1
  153. package/dist/publish.d.ts.map +1 -1
  154. package/dist/publish.js +1 -1
  155. package/dist/publish.js.map +1 -1
  156. package/dist/result.d.ts +2 -1
  157. package/dist/result.d.ts.map +1 -1
  158. package/dist/result.js +5 -0
  159. package/dist/result.js.map +1 -1
  160. package/dist/runtime.js +4 -4
  161. package/dist/runtime.js.map +1 -1
  162. package/dist/scan-comparison.d.ts.map +1 -1
  163. package/dist/scan-comparison.js.map +1 -1
  164. package/dist/scan-dashboard.d.ts +1 -0
  165. package/dist/scan-dashboard.d.ts.map +1 -1
  166. package/dist/scan-dashboard.js +34 -22
  167. package/dist/scan-dashboard.js.map +1 -1
  168. package/dist/scan-history-renderer.d.ts.map +1 -1
  169. package/dist/scan-history-renderer.js.map +1 -1
  170. package/dist/scan-logs.d.ts +12 -5
  171. package/dist/scan-logs.d.ts.map +1 -1
  172. package/dist/scan-logs.js +76 -19
  173. package/dist/scan-logs.js.map +1 -1
  174. package/dist/scan-modes.d.ts +3 -0
  175. package/dist/scan-modes.d.ts.map +1 -0
  176. package/dist/scan-modes.js +2 -0
  177. package/dist/scan-modes.js.map +1 -0
  178. package/dist/scan-settings.d.ts +81 -0
  179. package/dist/scan-settings.d.ts.map +1 -0
  180. package/dist/scan-settings.js +123 -0
  181. package/dist/scan-settings.js.map +1 -0
  182. package/dist/security-policy-cli.js +2 -2
  183. package/dist/security-policy-cli.js.map +1 -1
  184. package/dist/security-policy.d.ts.map +1 -1
  185. package/dist/security-policy.js.map +1 -1
  186. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +3 -3
  187. package/dist/server/dashboard/app.css +1 -1
  188. package/dist/server/dashboard/app.js +7 -7
  189. package/dist/server/dashboard-types.d.ts +4 -1
  190. package/dist/server/dashboard-types.d.ts.map +1 -1
  191. package/dist/server/dashboard-types.js.map +1 -1
  192. package/dist/server/dashboard.d.ts.map +1 -1
  193. package/dist/server/dashboard.js +18 -4
  194. package/dist/server/dashboard.js.map +1 -1
  195. package/dist/server/embeddings.d.ts.map +1 -1
  196. package/dist/server/embeddings.js.map +1 -1
  197. package/dist/server/errors.d.ts.map +1 -1
  198. package/dist/server/errors.js.map +1 -1
  199. package/dist/server/findings-service.d.ts.map +1 -1
  200. package/dist/server/findings-service.js.map +1 -1
  201. package/dist/server/serve.js.map +1 -1
  202. package/dist/server/sqlite-store.d.ts.map +1 -1
  203. package/dist/server/sqlite-store.js.map +1 -1
  204. package/dist/severity-store.js.map +1 -1
  205. package/dist/targets.d.ts +2 -1
  206. package/dist/targets.d.ts.map +1 -1
  207. package/dist/targets.js +4 -4
  208. package/dist/targets.js.map +1 -1
  209. package/dist/thread-source.d.ts.map +1 -1
  210. package/dist/version.js.map +1 -1
  211. package/dist/worker-progress.d.ts.map +1 -1
  212. package/dist/worker-progress.js.map +1 -1
  213. package/package.json +31 -28
  214. package/schemas/project-config.schema.json +211 -0
@@ -0,0 +1,211 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "type": "object",
4
+ "properties": {
5
+ "$schema": {
6
+ "description": "Editor schema URI or relative path. The CLI does not fetch or select a validator from this value.",
7
+ "type": "string",
8
+ "minLength": 1
9
+ },
10
+ "auth": {
11
+ "default": "auto",
12
+ "description": "Credential-source choice only; never a credential value.",
13
+ "type": "string",
14
+ "enum": ["auto", "chatgpt", "api-key"]
15
+ },
16
+ "scan": {
17
+ "type": "object",
18
+ "properties": {
19
+ "mode": {
20
+ "default": "standard",
21
+ "type": "string",
22
+ "enum": ["standard", "deep"]
23
+ },
24
+ "scope": {
25
+ "description": "One scope variant. Omit for the whole repository. Mode compatibility is checked after overrides.",
26
+ "anyOf": [
27
+ {
28
+ "type": "object",
29
+ "properties": {
30
+ "paths": {
31
+ "minItems": 1,
32
+ "type": "array",
33
+ "items": { "type": "string", "minLength": 1 },
34
+ "description": "Literal paths relative to the selected repository."
35
+ }
36
+ },
37
+ "required": ["paths"],
38
+ "additionalProperties": false
39
+ },
40
+ {
41
+ "type": "object",
42
+ "properties": {
43
+ "diff": {
44
+ "type": "object",
45
+ "properties": {
46
+ "base": { "type": "string", "minLength": 1 },
47
+ "head": {
48
+ "default": "HEAD",
49
+ "type": "string",
50
+ "minLength": 1
51
+ }
52
+ },
53
+ "required": ["base"],
54
+ "additionalProperties": false
55
+ }
56
+ },
57
+ "required": ["diff"],
58
+ "additionalProperties": false
59
+ },
60
+ {
61
+ "type": "object",
62
+ "properties": {
63
+ "working_tree": {
64
+ "type": "object",
65
+ "properties": {
66
+ "base": {
67
+ "default": "HEAD",
68
+ "type": "string",
69
+ "minLength": 1
70
+ }
71
+ },
72
+ "additionalProperties": false
73
+ }
74
+ },
75
+ "required": ["working_tree"],
76
+ "additionalProperties": false
77
+ }
78
+ ]
79
+ },
80
+ "knowledge_base": {
81
+ "description": "Context files or directories, relative to this file. An empty list selects no additional context.",
82
+ "type": "array",
83
+ "items": { "type": "string", "minLength": 1 }
84
+ },
85
+ "instructions_file": {
86
+ "description": "Additional scan instructions, relative to this file.",
87
+ "type": "string",
88
+ "minLength": 1
89
+ },
90
+ "validation_file": {
91
+ "description": "Custom validation instructions, relative to this file; not supported in active deep scans.",
92
+ "type": "string",
93
+ "minLength": 1
94
+ },
95
+ "deep": {
96
+ "description": "Deep defaults; a valid block may be retained while standard mode is selected.",
97
+ "type": "object",
98
+ "properties": {
99
+ "workers": {
100
+ "default": 4,
101
+ "description": "Maximum concurrent deep-scan discovery workers.",
102
+ "type": "integer",
103
+ "exclusiveMinimum": 0,
104
+ "maximum": 9007199254740991
105
+ },
106
+ "subagents_per_worker": {
107
+ "default": 3,
108
+ "description": "Subagents available to each deep-scan worker. Zero is valid.",
109
+ "type": "integer",
110
+ "minimum": 0,
111
+ "maximum": 9007199254740991
112
+ },
113
+ "stop_after_no_new": {
114
+ "default": 4,
115
+ "description": "Stop after this many runs find no new issues.",
116
+ "type": "integer",
117
+ "exclusiveMinimum": 0,
118
+ "maximum": 9007199254740991
119
+ },
120
+ "stop_after_consecutive_errors": {
121
+ "default": 3,
122
+ "description": "Stop after this many consecutive discovery errors.",
123
+ "type": "integer",
124
+ "exclusiveMinimum": 0,
125
+ "maximum": 9007199254740991
126
+ },
127
+ "max_discovery_runs": {
128
+ "default": 40,
129
+ "description": "Maximum deep-scan discovery runs.",
130
+ "type": "integer",
131
+ "exclusiveMinimum": 0,
132
+ "maximum": 9007199254740991
133
+ },
134
+ "max_time_hours": {
135
+ "default": 96,
136
+ "description": "Maximum deep-scan discovery hours (default: 96; maximum: 96).",
137
+ "type": "number",
138
+ "exclusiveMinimum": 0,
139
+ "maximum": 96
140
+ }
141
+ },
142
+ "additionalProperties": false
143
+ }
144
+ },
145
+ "additionalProperties": false
146
+ },
147
+ "codex": {
148
+ "description": "Native Codex overrides. Common key types are checked here; existing native and wrapper restrictions still apply.",
149
+ "type": "object",
150
+ "properties": {
151
+ "model": { "type": "string", "minLength": 1 },
152
+ "model_reasoning_effort": { "type": "string", "minLength": 1 },
153
+ "model_provider": { "type": "string", "minLength": 1 }
154
+ },
155
+ "additionalProperties": { "$ref": "#/definitions/__schema0" }
156
+ },
157
+ "limits": {
158
+ "type": "object",
159
+ "properties": {
160
+ "max_cost_usd_per_scan": {
161
+ "description": "Estimated USD limit per launched scan attempt, not a total batch budget. Omit for no limit.",
162
+ "type": "number",
163
+ "exclusiveMinimum": 0
164
+ }
165
+ },
166
+ "additionalProperties": false
167
+ },
168
+ "policy": {
169
+ "type": "object",
170
+ "properties": {
171
+ "fail_on_severity": {
172
+ "description": "Exit threshold; does not filter retained findings. Omit for report-only behavior.",
173
+ "type": "string",
174
+ "enum": ["critical", "high", "medium", "low"]
175
+ }
176
+ },
177
+ "additionalProperties": false
178
+ },
179
+ "output": {
180
+ "type": "object",
181
+ "properties": {
182
+ "directory": {
183
+ "description": "Artifact directory relative to this file; existing outside-worktree checks still apply.",
184
+ "type": "string",
185
+ "minLength": 1
186
+ }
187
+ },
188
+ "additionalProperties": false
189
+ }
190
+ },
191
+ "additionalProperties": false,
192
+ "definitions": {
193
+ "__schema0": {
194
+ "anyOf": [
195
+ { "type": "string" },
196
+ { "type": "number" },
197
+ { "type": "boolean" },
198
+ { "type": "null" },
199
+ { "type": "array", "items": { "$ref": "#/definitions/__schema0" } },
200
+ {
201
+ "type": "object",
202
+ "propertyNames": { "type": "string" },
203
+ "additionalProperties": { "$ref": "#/definitions/__schema0" }
204
+ }
205
+ ]
206
+ }
207
+ },
208
+ "title": "Codex Security project configuration",
209
+ "description": "Input schema for explicitly selected YAML or JSON project files. Filesystem, active scan combinations, native configuration, and runtime availability are checked separately.",
210
+ "$comment": "Generated from ProjectConfigInputSchema. Defaults are annotations; apply defaults only after merging input layers."
211
+ }