@openai/codex-security 0.1.26 → 0.1.28

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 (253) hide show
  1. package/README.md +637 -74
  2. package/_bundled_plugin/.mcp.json +1 -0
  3. package/_bundled_plugin/mcp/helpers.mjs +24 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  5. package/_bundled_plugin/mcp/native/COPYRIGHT-library.html +5556 -0
  6. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +5989 -0
  7. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/licenses/Apache-2.0.txt +73 -0
  10. package/_bundled_plugin/mcp/native/licenses/BSD-2-Clause.txt +9 -0
  11. package/_bundled_plugin/mcp/native/licenses/MIT.txt +9 -0
  12. package/_bundled_plugin/mcp/native/licenses/Unicode-3.0.txt +39 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  20. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  21. package/_bundled_plugin/references/artifact-storage.md +56 -0
  22. package/_bundled_plugin/references/config-preflight.md +9 -1
  23. package/_bundled_plugin/references/core-scan.md +1 -1
  24. package/_bundled_plugin/references/final-report.md +2 -0
  25. package/_bundled_plugin/references/scan-artifacts.md +6 -14
  26. package/_bundled_plugin/references/scan-contract.md +35 -35
  27. package/_bundled_plugin/references/scan-prologue.md +2 -0
  28. package/_bundled_plugin/references/security-guidance.md +9 -1
  29. package/_bundled_plugin/scripts/deep_scan_config.py +10 -8
  30. package/_bundled_plugin/scripts/deep_scan_defaults.json +8 -0
  31. package/_bundled_plugin/scripts/generate_in_scope_files.py +2 -2
  32. package/_bundled_plugin/scripts/generate_rank_input.py +8 -1
  33. package/_bundled_plugin/scripts/launch_codex_security_mcp +6 -0
  34. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +43 -9
  35. package/_bundled_plugin/scripts/rank_preview.py +4 -1
  36. package/_bundled_plugin/scripts/reserved_artifact_paths.json +6 -0
  37. package/_bundled_plugin/scripts/windows_scan_local_files.py +1 -3
  38. package/_bundled_plugin/scripts/workbench/storage.py +18 -0
  39. package/_bundled_plugin/scripts/workbench_cli.py +17 -0
  40. package/_bundled_plugin/scripts/workbench_db.py +46 -42
  41. package/_bundled_plugin/scripts/workbench_saved_results.py +72 -1
  42. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -2
  43. package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -10
  44. package/_bundled_plugin/scripts/workbench_validation.py +4 -0
  45. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +2 -0
  46. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +2 -0
  47. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +5 -1
  48. package/_bundled_plugin/skills/define-security-policy/SKILL.md +3 -3
  49. package/_bundled_plugin/skills/finding-discovery/SKILL.md +2 -0
  50. package/_bundled_plugin/skills/fix-finding/SKILL.md +3 -1
  51. package/_bundled_plugin/skills/fix-finding/agents/openai.yaml +1 -1
  52. package/_bundled_plugin/skills/propose-security-hardening/SKILL.md +2 -0
  53. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +5 -1
  54. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -0
  55. package/_bundled_plugin/skills/validation/SKILL.md +2 -0
  56. package/_bundled_plugin/skills/vulnerability-writeup/SKILL.md +2 -0
  57. package/dist/api.d.ts +14 -24
  58. package/dist/api.d.ts.map +1 -1
  59. package/dist/api.js +585 -168
  60. package/dist/api.js.map +1 -1
  61. package/dist/auth.d.ts.map +1 -1
  62. package/dist/auth.js +10 -0
  63. package/dist/auth.js.map +1 -1
  64. package/dist/bulk-scan-discovery.d.ts +1 -1
  65. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  66. package/dist/bulk-scan-discovery.js +2 -2
  67. package/dist/bulk-scan-discovery.js.map +1 -1
  68. package/dist/classify-scan-severity.js.map +1 -1
  69. package/dist/classify-severity.d.ts.map +1 -1
  70. package/dist/classify-severity.js.map +1 -1
  71. package/dist/cli.d.ts +24 -4
  72. package/dist/cli.d.ts.map +1 -1
  73. package/dist/cli.js +1577 -610
  74. package/dist/cli.js.map +1 -1
  75. package/dist/cloud-publish.d.ts.map +1 -1
  76. package/dist/cloud-publish.js +2 -207
  77. package/dist/cloud-publish.js.map +1 -1
  78. package/dist/component-plan.d.ts.map +1 -1
  79. package/dist/component-plan.js +116 -32
  80. package/dist/component-plan.js.map +1 -1
  81. package/dist/component-scan.d.ts +4 -2
  82. package/dist/component-scan.d.ts.map +1 -1
  83. package/dist/component-scan.js +7 -1
  84. package/dist/component-scan.js.map +1 -1
  85. package/dist/config-path.d.ts +6 -0
  86. package/dist/config-path.d.ts.map +1 -0
  87. package/dist/config-path.js +6 -0
  88. package/dist/config-path.js.map +1 -0
  89. package/dist/config.d.ts +3 -0
  90. package/dist/config.d.ts.map +1 -1
  91. package/dist/config.js +30 -5
  92. package/dist/config.js.map +1 -1
  93. package/dist/contract.d.ts +5 -10
  94. package/dist/contract.d.ts.map +1 -1
  95. package/dist/contract.js.map +1 -1
  96. package/dist/cost-model.d.ts +30 -0
  97. package/dist/cost-model.d.ts.map +1 -1
  98. package/dist/cost-model.js +123 -4
  99. package/dist/cost-model.js.map +1 -1
  100. package/dist/cost.d.ts.map +1 -1
  101. package/dist/cost.js +18 -3
  102. package/dist/cost.js.map +1 -1
  103. package/dist/custom-publish.js.map +1 -1
  104. package/dist/custom-validation-prompt.js +1 -1
  105. package/dist/custom-validation-prompt.js.map +1 -1
  106. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  107. package/dist/deduplication/checkpointed-review.js.map +1 -1
  108. package/dist/deduplication/codex-review.d.ts +6 -1
  109. package/dist/deduplication/codex-review.d.ts.map +1 -1
  110. package/dist/deduplication/codex-review.js +72 -17
  111. package/dist/deduplication/codex-review.js.map +1 -1
  112. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  113. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  114. package/dist/deduplication/deduplication.d.ts +2 -0
  115. package/dist/deduplication/deduplication.d.ts.map +1 -1
  116. package/dist/deduplication/deduplication.js +99 -26
  117. package/dist/deduplication/deduplication.js.map +1 -1
  118. package/dist/deduplication/retry.d.ts +3 -0
  119. package/dist/deduplication/retry.d.ts.map +1 -0
  120. package/dist/deduplication/retry.js +15 -0
  121. package/dist/deduplication/retry.js.map +1 -0
  122. package/dist/deduplication/scan.d.ts +2 -0
  123. package/dist/deduplication/scan.d.ts.map +1 -1
  124. package/dist/deduplication/scan.js +4 -2
  125. package/dist/deduplication/scan.js.map +1 -1
  126. package/dist/deep-config.d.ts +17 -0
  127. package/dist/deep-config.d.ts.map +1 -0
  128. package/dist/deep-config.js +145 -0
  129. package/dist/deep-config.js.map +1 -0
  130. package/dist/deep-progress.d.ts.map +1 -1
  131. package/dist/deep-scan-defaults.d.ts +9 -0
  132. package/dist/deep-scan-defaults.d.ts.map +1 -0
  133. package/dist/deep-scan-defaults.js +10 -0
  134. package/dist/deep-scan-defaults.js.map +1 -0
  135. package/dist/errors.d.ts.map +1 -1
  136. package/dist/errors.js +2 -2
  137. package/dist/errors.js.map +1 -1
  138. package/dist/feedback.d.ts +20 -0
  139. package/dist/feedback.d.ts.map +1 -0
  140. package/dist/feedback.js +135 -0
  141. package/dist/feedback.js.map +1 -0
  142. package/dist/finding-catalogue.js.map +1 -1
  143. package/dist/finding-workflow.d.ts.map +1 -1
  144. package/dist/finding-workflow.js.map +1 -1
  145. package/dist/findings-client.d.ts +7 -1
  146. package/dist/findings-client.d.ts.map +1 -1
  147. package/dist/findings-client.js +55 -10
  148. package/dist/findings-client.js.map +1 -1
  149. package/dist/findings-import.d.ts +44 -0
  150. package/dist/findings-import.d.ts.map +1 -0
  151. package/dist/findings-import.js +302 -0
  152. package/dist/findings-import.js.map +1 -0
  153. package/dist/github.d.ts +625 -7
  154. package/dist/github.d.ts.map +1 -1
  155. package/dist/github.js.map +1 -1
  156. package/dist/import-scan.d.ts +27 -0
  157. package/dist/import-scan.d.ts.map +1 -0
  158. package/dist/import-scan.js +236 -0
  159. package/dist/import-scan.js.map +1 -0
  160. package/dist/index.d.ts +7 -0
  161. package/dist/index.d.ts.map +1 -1
  162. package/dist/index.js +2 -0
  163. package/dist/index.js.map +1 -1
  164. package/dist/knowledge-base.d.ts +1 -1
  165. package/dist/knowledge-base.d.ts.map +1 -1
  166. package/dist/knowledge-base.js +19 -8
  167. package/dist/knowledge-base.js.map +1 -1
  168. package/dist/models.d.ts.map +1 -1
  169. package/dist/models.js.map +1 -1
  170. package/dist/multiscan.d.ts +7 -5
  171. package/dist/multiscan.d.ts.map +1 -1
  172. package/dist/multiscan.js +212 -55
  173. package/dist/multiscan.js.map +1 -1
  174. package/dist/patch-tui.d.ts.map +1 -1
  175. package/dist/patch-tui.js.map +1 -1
  176. package/dist/project-config-schema.d.ts +191 -0
  177. package/dist/project-config-schema.d.ts.map +1 -0
  178. package/dist/project-config-schema.js +85 -0
  179. package/dist/project-config-schema.js.map +1 -0
  180. package/dist/project-config.d.ts +50 -0
  181. package/dist/project-config.d.ts.map +1 -0
  182. package/dist/project-config.js +220 -0
  183. package/dist/project-config.js.map +1 -0
  184. package/dist/prompt-files.d.ts +13 -0
  185. package/dist/prompt-files.d.ts.map +1 -0
  186. package/dist/prompt-files.js +74 -0
  187. package/dist/prompt-files.js.map +1 -0
  188. package/dist/publication-events.d.ts.map +1 -1
  189. package/dist/publication-events.js +7 -2
  190. package/dist/publication-events.js.map +1 -1
  191. package/dist/publish.d.ts.map +1 -1
  192. package/dist/publish.js +1 -1
  193. package/dist/publish.js.map +1 -1
  194. package/dist/result.d.ts +2 -1
  195. package/dist/result.d.ts.map +1 -1
  196. package/dist/result.js +5 -0
  197. package/dist/result.js.map +1 -1
  198. package/dist/runtime.d.ts +5 -1
  199. package/dist/runtime.d.ts.map +1 -1
  200. package/dist/runtime.js +12 -6
  201. package/dist/runtime.js.map +1 -1
  202. package/dist/scan-comparison.d.ts.map +1 -1
  203. package/dist/scan-comparison.js.map +1 -1
  204. package/dist/scan-dashboard.d.ts +1 -0
  205. package/dist/scan-dashboard.d.ts.map +1 -1
  206. package/dist/scan-dashboard.js +45 -20
  207. package/dist/scan-dashboard.js.map +1 -1
  208. package/dist/scan-history-renderer.d.ts.map +1 -1
  209. package/dist/scan-history-renderer.js.map +1 -1
  210. package/dist/scan-logs.d.ts +39 -3
  211. package/dist/scan-logs.d.ts.map +1 -1
  212. package/dist/scan-logs.js +77 -15
  213. package/dist/scan-logs.js.map +1 -1
  214. package/dist/scan-modes.d.ts +3 -0
  215. package/dist/scan-modes.d.ts.map +1 -0
  216. package/dist/scan-modes.js +2 -0
  217. package/dist/scan-modes.js.map +1 -0
  218. package/dist/scan-settings.d.ts +81 -0
  219. package/dist/scan-settings.d.ts.map +1 -0
  220. package/dist/scan-settings.js +123 -0
  221. package/dist/scan-settings.js.map +1 -0
  222. package/dist/security-policy-cli.d.ts +39 -0
  223. package/dist/security-policy-cli.d.ts.map +1 -0
  224. package/dist/security-policy-cli.js +193 -0
  225. package/dist/security-policy-cli.js.map +1 -0
  226. package/dist/security-policy.d.ts +80 -0
  227. package/dist/security-policy.d.ts.map +1 -0
  228. package/dist/security-policy.js +672 -0
  229. package/dist/security-policy.js.map +1 -0
  230. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +2 -2
  231. package/dist/server/dashboard/app.js +2 -2
  232. package/dist/server/dashboard.js.map +1 -1
  233. package/dist/server/embeddings.d.ts.map +1 -1
  234. package/dist/server/embeddings.js.map +1 -1
  235. package/dist/server/errors.d.ts.map +1 -1
  236. package/dist/server/errors.js.map +1 -1
  237. package/dist/server/findings-service.d.ts.map +1 -1
  238. package/dist/server/findings-service.js.map +1 -1
  239. package/dist/server/serve.js.map +1 -1
  240. package/dist/server/sqlite-store.d.ts.map +1 -1
  241. package/dist/server/sqlite-store.js.map +1 -1
  242. package/dist/severity-store.js.map +1 -1
  243. package/dist/targets.d.ts +10 -2
  244. package/dist/targets.d.ts.map +1 -1
  245. package/dist/targets.js +243 -14
  246. package/dist/targets.js.map +1 -1
  247. package/dist/thread-source.d.ts.map +1 -1
  248. package/dist/version.js.map +1 -1
  249. package/dist/worker-progress.d.ts.map +1 -1
  250. package/dist/worker-progress.js.map +1 -1
  251. package/package.json +36 -29
  252. package/schemas/project-config.schema.json +211 -0
  253. package/_bundled_plugin/scripts/resolve_security_md.py +0 -158
@@ -0,0 +1,123 @@
1
+ import { z } from "zod";
2
+ import { DEFAULT_DEEP_SCAN_SETTINGS } from "./deep-scan-defaults.js";
3
+ import { ConfigurationError } from "./errors.js";
4
+ import { SCAN_MODES } from "./scan-modes.js";
5
+ export const SCAN_AUTH_MODES = ["auto", "chatgpt", "api-key"];
6
+ export const DEFAULT_SCAN_AUTH = "auto";
7
+ export const DEFAULT_SCAN_MODE = "standard";
8
+ export const REPORTABLE_SEVERITIES = [
9
+ "critical",
10
+ "high",
11
+ "medium",
12
+ "low",
13
+ ];
14
+ export const SCAN_SEVERITIES = [
15
+ ...REPORTABLE_SEVERITIES,
16
+ "informational",
17
+ ];
18
+ export const FailureSeveritySchema = z.enum(REPORTABLE_SEVERITIES);
19
+ // SDK name, legacy TOML key, project key, and CLI flag (when exposed).
20
+ export const DEEP_SCAN_SETTINGS = [
21
+ ["workers", "workers", "workers", "--workers"],
22
+ ["subagents", "subagents", "subagents_per_worker", "--subagents"],
23
+ [
24
+ "stopAfterNoNew",
25
+ "stop_after_no_new",
26
+ "stop_after_no_new",
27
+ "--stop-after-no-new",
28
+ ],
29
+ [
30
+ "stopAfterConsecutiveErrors",
31
+ "stop_after_consecutive_errors",
32
+ "stop_after_consecutive_errors",
33
+ null,
34
+ ],
35
+ [
36
+ "maxDiscoveryRuns",
37
+ "max_discovery_runs",
38
+ "max_discovery_runs",
39
+ "--max-discovery-runs",
40
+ ],
41
+ ["maxTimeHours", "max_time_hours", "max_time_hours", "--max-time-hours"],
42
+ ];
43
+ const positiveIntegerError = "must be a positive integer";
44
+ const positiveInteger = z
45
+ .number({ error: positiveIntegerError })
46
+ .int({ error: positiveIntegerError })
47
+ .positive({ error: positiveIntegerError });
48
+ const nonnegativeIntegerError = "must be a non-negative integer";
49
+ const nonnegativeInteger = z
50
+ .number({ error: nonnegativeIntegerError })
51
+ .int({ error: nonnegativeIntegerError })
52
+ .nonnegative({ error: nonnegativeIntegerError });
53
+ const maximumHours = 96;
54
+ const hoursError = `must be a positive number no greater than ${maximumHours}`;
55
+ export const DeepScanSettingsSchema = z.strictObject({
56
+ workers: positiveInteger.optional().meta({
57
+ default: DEFAULT_DEEP_SCAN_SETTINGS.workers,
58
+ description: "Maximum concurrent deep-scan discovery workers.",
59
+ }),
60
+ subagents: nonnegativeInteger.optional().meta({
61
+ default: DEFAULT_DEEP_SCAN_SETTINGS.subagents,
62
+ description: "Subagents available to each deep-scan worker. Zero is valid.",
63
+ }),
64
+ stopAfterNoNew: positiveInteger.optional().meta({
65
+ default: DEFAULT_DEEP_SCAN_SETTINGS.stopAfterNoNew,
66
+ description: "Stop after this many runs find no new issues.",
67
+ }),
68
+ stopAfterConsecutiveErrors: positiveInteger.optional().meta({
69
+ default: DEFAULT_DEEP_SCAN_SETTINGS.stopAfterConsecutiveErrors,
70
+ description: "Stop after this many consecutive discovery errors.",
71
+ }),
72
+ maxDiscoveryRuns: positiveInteger.optional().meta({
73
+ default: DEFAULT_DEEP_SCAN_SETTINGS.maxDiscoveryRuns,
74
+ description: "Maximum deep-scan discovery runs.",
75
+ }),
76
+ maxTimeHours: z
77
+ .number({ error: hoursError })
78
+ .positive({ error: hoursError })
79
+ .max(maximumHours, { error: hoursError })
80
+ .optional()
81
+ .meta({
82
+ default: DEFAULT_DEEP_SCAN_SETTINGS.maxTimeHours,
83
+ description: "Maximum deep-scan discovery hours (default: 96; maximum: 96).",
84
+ }),
85
+ });
86
+ const inputPath = z.string().min(1);
87
+ export const ScanSettingsSchema = DeepScanSettingsSchema.extend({
88
+ auth: z.enum(SCAN_AUTH_MODES).optional().meta({ default: DEFAULT_SCAN_AUTH }),
89
+ mode: z.enum(SCAN_MODES).optional().meta({ default: DEFAULT_SCAN_MODE }),
90
+ knowledgeBasePaths: z.array(inputPath).optional(),
91
+ scanPrompt: z.string().optional(),
92
+ scanPromptFile: inputPath.optional(),
93
+ validationPrompt: z.string().optional(),
94
+ validationPromptFile: inputPath.optional(),
95
+ postScanPrompt: z.string().optional(),
96
+ postScanPromptFile: inputPath.optional(),
97
+ outputDir: inputPath.optional(),
98
+ failureSeverity: z.enum(SCAN_SEVERITIES).optional(),
99
+ maxCostUsd: z.number().positive().optional(),
100
+ });
101
+ /** Pick defined scan settings without copying callbacks or workflow controls. */
102
+ export function pickScanSettings(settings) {
103
+ const keys = [
104
+ "target",
105
+ ...Object.keys(ScanSettingsSchema.shape),
106
+ ];
107
+ return Object.fromEntries(keys
108
+ .filter((key) => settings[key] !== undefined)
109
+ .map((key) => [key, settings[key]]));
110
+ }
111
+ export function meetsSeverity(finding, threshold) {
112
+ const thresholdRank = severityThresholdRank(threshold);
113
+ const severity = SCAN_SEVERITIES.indexOf(finding.severity.level);
114
+ return severity >= 0 && severity <= thresholdRank;
115
+ }
116
+ export function severityThresholdRank(threshold) {
117
+ const rank = SCAN_SEVERITIES.indexOf(threshold);
118
+ if (rank < 0) {
119
+ throw new ConfigurationError(`Unknown severity threshold: ${String(threshold)}.`);
120
+ }
121
+ return rank;
122
+ }
123
+ //# sourceMappingURL=scan-settings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scan-settings.js","sourceRoot":"","sources":["../src/scan-settings.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { DEFAULT_DEEP_SCAN_SETTINGS } from \"./deep-scan-defaults.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport type { Finding, SeverityLevel } from \"./models.js\";\nimport type { AbsolutePath } from \"./config-path.js\";\nimport { SCAN_MODES, type ScanMode } from \"./scan-modes.js\";\nimport type { ScanTarget } from \"./targets.js\";\n\nexport const SCAN_AUTH_MODES = [\"auto\", \"chatgpt\", \"api-key\"] as const;\nexport type ScanAuthMode = (typeof SCAN_AUTH_MODES)[number];\nexport const DEFAULT_SCAN_AUTH = \"auto\";\nexport const DEFAULT_SCAN_MODE = \"standard\";\nexport const REPORTABLE_SEVERITIES = [\n \"critical\",\n \"high\",\n \"medium\",\n \"low\",\n] as const;\nexport const SCAN_SEVERITIES = [\n ...REPORTABLE_SEVERITIES,\n \"informational\",\n] as const;\nexport const FailureSeveritySchema = z.enum(REPORTABLE_SEVERITIES);\nexport type FailureSeverity = z.infer<typeof FailureSeveritySchema>;\n\n// SDK name, legacy TOML key, project key, and CLI flag (when exposed).\nexport const DEEP_SCAN_SETTINGS = [\n [\"workers\", \"workers\", \"workers\", \"--workers\"],\n [\"subagents\", \"subagents\", \"subagents_per_worker\", \"--subagents\"],\n [\n \"stopAfterNoNew\",\n \"stop_after_no_new\",\n \"stop_after_no_new\",\n \"--stop-after-no-new\",\n ],\n [\n \"stopAfterConsecutiveErrors\",\n \"stop_after_consecutive_errors\",\n \"stop_after_consecutive_errors\",\n null,\n ],\n [\n \"maxDiscoveryRuns\",\n \"max_discovery_runs\",\n \"max_discovery_runs\",\n \"--max-discovery-runs\",\n ],\n [\"maxTimeHours\", \"max_time_hours\", \"max_time_hours\", \"--max-time-hours\"],\n] as const;\n\nconst positiveIntegerError = \"must be a positive integer\";\nconst positiveInteger = z\n .number({ error: positiveIntegerError })\n .int({ error: positiveIntegerError })\n .positive({ error: positiveIntegerError });\nconst nonnegativeIntegerError = \"must be a non-negative integer\";\nconst nonnegativeInteger = z\n .number({ error: nonnegativeIntegerError })\n .int({ error: nonnegativeIntegerError })\n .nonnegative({ error: nonnegativeIntegerError });\nconst maximumHours = 96;\nconst hoursError = `must be a positive number no greater than ${maximumHours}`;\n\nexport const DeepScanSettingsSchema = z.strictObject({\n workers: positiveInteger.optional().meta({\n default: DEFAULT_DEEP_SCAN_SETTINGS.workers,\n description: \"Maximum concurrent deep-scan discovery workers.\",\n }),\n subagents: nonnegativeInteger.optional().meta({\n default: DEFAULT_DEEP_SCAN_SETTINGS.subagents,\n description: \"Subagents available to each deep-scan worker. Zero is valid.\",\n }),\n stopAfterNoNew: positiveInteger.optional().meta({\n default: DEFAULT_DEEP_SCAN_SETTINGS.stopAfterNoNew,\n description: \"Stop after this many runs find no new issues.\",\n }),\n stopAfterConsecutiveErrors: positiveInteger.optional().meta({\n default: DEFAULT_DEEP_SCAN_SETTINGS.stopAfterConsecutiveErrors,\n description: \"Stop after this many consecutive discovery errors.\",\n }),\n maxDiscoveryRuns: positiveInteger.optional().meta({\n default: DEFAULT_DEEP_SCAN_SETTINGS.maxDiscoveryRuns,\n description: \"Maximum deep-scan discovery runs.\",\n }),\n maxTimeHours: z\n .number({ error: hoursError })\n .positive({ error: hoursError })\n .max(maximumHours, { error: hoursError })\n .optional()\n .meta({\n default: DEFAULT_DEEP_SCAN_SETTINGS.maxTimeHours,\n description:\n \"Maximum deep-scan discovery hours (default: 96; maximum: 96).\",\n }),\n});\n\nexport type DeepScanOptions = z.infer<typeof DeepScanSettingsSchema>;\n\nconst inputPath = z.string().min(1);\n\nexport const ScanSettingsSchema = DeepScanSettingsSchema.extend({\n auth: z.enum(SCAN_AUTH_MODES).optional().meta({ default: DEFAULT_SCAN_AUTH }),\n mode: z.enum(SCAN_MODES).optional().meta({ default: DEFAULT_SCAN_MODE }),\n knowledgeBasePaths: z.array(inputPath).optional(),\n scanPrompt: z.string().optional(),\n scanPromptFile: inputPath.optional(),\n validationPrompt: z.string().optional(),\n validationPromptFile: inputPath.optional(),\n postScanPrompt: z.string().optional(),\n postScanPromptFile: inputPath.optional(),\n outputDir: inputPath.optional(),\n failureSeverity: z.enum(SCAN_SEVERITIES).optional(),\n maxCostUsd: z.number().positive().optional(),\n});\n\n/** Scan settings shared by SDK calls, CLI flags, and project files. */\nexport interface ScanSettings extends z.infer<typeof ScanSettingsSchema> {\n target?: ScanTarget;\n}\n\nexport interface ResolvedScanSettings extends ScanSettings {\n auth: ScanAuthMode;\n mode: ScanMode;\n target: ScanTarget;\n knowledgeBasePaths: AbsolutePath[];\n scanPromptFile?: AbsolutePath;\n validationPromptFile?: AbsolutePath;\n postScanPromptFile?: AbsolutePath;\n outputDir?: AbsolutePath;\n}\n\nexport type ScanPromptSettings = Pick<\n ScanSettings,\n | \"scanPrompt\"\n | \"scanPromptFile\"\n | \"validationPrompt\"\n | \"validationPromptFile\"\n | \"postScanPrompt\"\n | \"postScanPromptFile\"\n>;\n\n/** Pick defined scan settings without copying callbacks or workflow controls. */\nexport function pickScanSettings(settings: ScanSettings): ScanSettings {\n const keys = [\n \"target\",\n ...Object.keys(ScanSettingsSchema.shape),\n ] as (keyof ScanSettings)[];\n return Object.fromEntries(\n keys\n .filter((key) => settings[key] !== undefined)\n .map((key) => [key, settings[key]]),\n ) as ScanSettings;\n}\n\nexport function meetsSeverity(\n finding: Pick<Finding, \"severity\">,\n threshold: SeverityLevel,\n): boolean {\n const thresholdRank = severityThresholdRank(threshold);\n const severity = SCAN_SEVERITIES.indexOf(finding.severity.level);\n return severity >= 0 && severity <= thresholdRank;\n}\n\nexport function severityThresholdRank(threshold: SeverityLevel): number {\n const rank = SCAN_SEVERITIES.indexOf(threshold);\n if (rank < 0) {\n throw new ConfigurationError(\n `Unknown severity threshold: ${String(threshold)}.`,\n );\n }\n return rank;\n}\n"]}
@@ -0,0 +1,39 @@
1
+ import type { CodexSecurity, ScanAuthMode } from "./api.js";
2
+ import type { BulkScanPrompt } from "./bulk-scan-discovery.js";
3
+ import type { CodexSecurityConfig } from "./config.js";
4
+ import { type SecurityPolicyOptions } from "./security-policy.js";
5
+ type SignalName = "SIGINT" | "SIGTERM";
6
+ type Output = {
7
+ write(value: string): unknown;
8
+ };
9
+ export type PolicyPrompt = Pick<BulkScanPrompt, "isInteractive" | "input">;
10
+ export type PolicySecurity = Pick<CodexSecurity, "generatePolicy" | "preflightPolicy" | "previewPolicy" | "close">;
11
+ export interface PolicyCommandOptions {
12
+ repository: string;
13
+ config: CodexSecurityConfig;
14
+ generation: SecurityPolicyOptions;
15
+ headless: boolean;
16
+ dryRun: boolean;
17
+ format: string;
18
+ explicitOutput: boolean;
19
+ }
20
+ export interface PolicyCommandDependencies {
21
+ createSecurity(config: CodexSecurityConfig): PolicySecurity;
22
+ chooseAuthentication(config: CodexSecurityConfig, auth: ScanAuthMode | undefined, signal: AbortSignal): Promise<ScanAuthMode | undefined>;
23
+ prompt: PolicyPrompt;
24
+ environment: NodeJS.ProcessEnv;
25
+ errorOutput: Output;
26
+ now(): number;
27
+ addSignalListener(signal: SignalName, listener: () => void): void;
28
+ removeSignalListener(signal: SignalName, listener: () => void): void;
29
+ forceExit(signal: SignalName): void;
30
+ }
31
+ export declare function runPolicyCommand(options: PolicyCommandOptions, dependencies: PolicyCommandDependencies): Promise<{
32
+ exitCode: number;
33
+ data?: Record<string, unknown>;
34
+ markdown?: string;
35
+ error?: string;
36
+ }>;
37
+ export declare function policyDisplayData(data: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
38
+ export {};
39
+ //# sourceMappingURL=security-policy-cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"security-policy-cli.d.ts","sourceRoot":"","sources":["../src/security-policy-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,sBAAsB,CAAC;AAE9B,KAAK,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AACvC,KAAK,MAAM,GAAG;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,aAAa,EACb,gBAAgB,GAAG,iBAAiB,GAAG,eAAe,GAAG,OAAO,CACjE,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAAC;IAC5D,oBAAoB,CAClB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,IAAI,MAAM,CAAC;IACd,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClE,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACrE,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CACrC;AAQD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA+LD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAarC"}
@@ -0,0 +1,193 @@
1
+ import { formatScanCost } from "./cost-model.js";
2
+ import { safeErrorMessage } from "./errors.js";
3
+ import { formatSecurityPolicyText as display, } from "./security-policy.js";
4
+ const STAGES = {
5
+ architecture: "[1/3] Understanding the system and its security boundaries",
6
+ threat_model: "[2/3] Building the source-backed threat model",
7
+ policy: "[3/3] Drafting SECURITY.md",
8
+ };
9
+ export async function runPolicyCommand(options, dependencies) {
10
+ const { errorOutput, prompt } = dependencies;
11
+ const controller = new AbortController();
12
+ const interactive = !options.headless &&
13
+ options.format === "toon" &&
14
+ dependencies.environment["CI"] === undefined &&
15
+ prompt.isInteractive();
16
+ const started = dependencies.now();
17
+ let security;
18
+ let outputDir;
19
+ const write = (message) => {
20
+ try {
21
+ errorOutput.write(`${message}\n`);
22
+ }
23
+ catch { }
24
+ };
25
+ let firstSignalAt = 0;
26
+ const signalListener = (signal) => () => {
27
+ if (controller.signal.aborted) {
28
+ // Match scan's handling of duplicate initial signals from launchers.
29
+ if (controller.signal.reason === signal &&
30
+ dependencies.now() - firstSignalAt < 500)
31
+ return;
32
+ removeSignalListeners();
33
+ dependencies.forceExit(signal);
34
+ return;
35
+ }
36
+ firstSignalAt = dependencies.now();
37
+ controller.abort(signal);
38
+ };
39
+ const interrupt = signalListener("SIGINT");
40
+ const terminate = signalListener("SIGTERM");
41
+ const removeSignalListeners = () => {
42
+ dependencies.removeSignalListener("SIGINT", interrupt);
43
+ dependencies.removeSignalListener("SIGTERM", terminate);
44
+ };
45
+ dependencies.addSignalListener("SIGINT", interrupt);
46
+ dependencies.addSignalListener("SIGTERM", terminate);
47
+ try {
48
+ const auth = interactive && !options.dryRun
49
+ ? await dependencies.chooseAuthentication(options.config, options.generation.auth, controller.signal)
50
+ : options.generation.auth;
51
+ controller.signal.throwIfAborted();
52
+ security = dependencies.createSecurity(options.config);
53
+ if (options.dryRun) {
54
+ const preflight = await security.preflightPolicy(options.repository, {
55
+ ...options.generation,
56
+ signal: controller.signal,
57
+ });
58
+ controller.signal.throwIfAborted();
59
+ return {
60
+ exitCode: 0,
61
+ data: {
62
+ ...preflight,
63
+ dryRun: true,
64
+ },
65
+ };
66
+ }
67
+ const draft = await security.generatePolicy(options.repository, {
68
+ ...options.generation,
69
+ auth,
70
+ signal: controller.signal,
71
+ onOutputDirReady: (directory) => {
72
+ outputDir = directory;
73
+ write(`Policy artifacts: ${display(directory)}`);
74
+ },
75
+ onStage: (stage) => write(STAGES[stage]),
76
+ onWarning: (warning) => write(`codex-security: ${display(safeErrorMessage(warning))}`),
77
+ ...(interactive
78
+ ? {
79
+ answerQuestions: async (questions, signal) => {
80
+ write("A few details could change this policy. Leave an answer blank to keep it unresolved.");
81
+ const answers = [];
82
+ for (const question of questions) {
83
+ signal.throwIfAborted();
84
+ const answer = await prompt.input(display(question), undefined, signal);
85
+ if (answer.trim())
86
+ answers.push(`${question}\n${answer}`);
87
+ }
88
+ return answers.join("\n\n");
89
+ },
90
+ }
91
+ : {}),
92
+ });
93
+ controller.signal.throwIfAborted();
94
+ const cost = draft.cost;
95
+ const changed = draft.previousContent !== draft.content;
96
+ const humanOutput = options.format === "toon" && !options.explicitOutput;
97
+ if (humanOutput) {
98
+ let diff;
99
+ try {
100
+ diff = await security.previewPolicy(draft, {
101
+ signal: controller.signal,
102
+ });
103
+ }
104
+ catch (error) {
105
+ controller.signal.throwIfAborted();
106
+ diff = "Preview unavailable. Review the saved draft.";
107
+ write(`codex-security: Could not preview the policy: ${display(safeErrorMessage(error))}`);
108
+ }
109
+ const preview = [
110
+ `\nPolicy target: ${display(draft.targetPath)}`,
111
+ diff.replace(/\n$/u, "") || "SECURITY.md is already up to date.",
112
+ ...(draft.reviewNotes.length === 0
113
+ ? []
114
+ : [
115
+ "\nOwner review:",
116
+ ...draft.reviewNotes.map((note) => `- ${display(note)}`),
117
+ ]),
118
+ ].join("\n");
119
+ write(preview);
120
+ }
121
+ controller.signal.throwIfAborted();
122
+ const status = changed ? "draft" : "unchanged";
123
+ if (humanOutput) {
124
+ write(`\nDraft: ${display(draft.draftPath)}`);
125
+ write(`Architecture: ${display(draft.specificationPath)}`);
126
+ write(`Threat model: ${display(draft.threatModelPath)}`);
127
+ if (changed)
128
+ write("No repository files changed. Review the saved SECURITY.md before copying it into the repository.");
129
+ }
130
+ const seconds = Math.max(0, (dependencies.now() - started) / 1000);
131
+ write(`Policy generation finished in ${seconds.toFixed(1)}s${cost === null ? "" : ` (estimated cost: ${formatScanCost(cost)})`}.`);
132
+ return {
133
+ exitCode: 0,
134
+ markdown: draft.content,
135
+ data: {
136
+ status,
137
+ repository: draft.repository,
138
+ scope: draft.scope,
139
+ targetPath: draft.targetPath,
140
+ outputDir: draft.outputDir,
141
+ draftPath: draft.draftPath,
142
+ specificationPath: draft.specificationPath,
143
+ threatModelPath: draft.threatModelPath,
144
+ customPlugin: draft.customPlugin,
145
+ reviewNotes: draft.reviewNotes,
146
+ cost,
147
+ },
148
+ };
149
+ }
150
+ catch (error) {
151
+ const signal = controller.signal.reason ??
152
+ (error instanceof Error && error.name === "ExitPromptError"
153
+ ? "SIGINT"
154
+ : undefined);
155
+ const exitCode = signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : 2;
156
+ const message = signal === "SIGINT"
157
+ ? "Policy generation canceled by Ctrl-C."
158
+ : signal === "SIGTERM"
159
+ ? "Policy generation terminated by SIGTERM."
160
+ : display(safeErrorMessage(error));
161
+ write(`codex-security: ${message}`);
162
+ if (outputDir !== undefined)
163
+ write(`Saved artifacts: ${display(outputDir)}`);
164
+ return {
165
+ exitCode,
166
+ error: message,
167
+ };
168
+ }
169
+ finally {
170
+ removeSignalListeners();
171
+ try {
172
+ await security?.close();
173
+ }
174
+ catch (error) {
175
+ write(`codex-security: Could not clean up the policy runtime: ${display(safeErrorMessage(error))}`);
176
+ }
177
+ }
178
+ }
179
+ export function policyDisplayData(data) {
180
+ const displayValue = (value) => {
181
+ if (typeof value === "string")
182
+ return display(value);
183
+ if (Array.isArray(value))
184
+ return value.map(displayValue);
185
+ if (value !== null && typeof value === "object")
186
+ return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, displayValue(item)]));
187
+ return value;
188
+ };
189
+ return data === undefined
190
+ ? undefined
191
+ : displayValue(data);
192
+ }
193
+ //# sourceMappingURL=security-policy-cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"security-policy-cli.js","sourceRoot":"","sources":["../src/security-policy-cli.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CodexSecurity, ScanAuthMode } from \"./api.js\";\nimport type { BulkScanPrompt } from \"./bulk-scan-discovery.js\";\nimport type { CodexSecurityConfig } from \"./config.js\";\nimport { formatScanCost } from \"./cost-model.js\";\nimport { safeErrorMessage } from \"./errors.js\";\nimport {\n formatSecurityPolicyText as display,\n type SecurityPolicyOptions,\n type SecurityPolicyStage,\n} from \"./security-policy.js\";\n\ntype SignalName = \"SIGINT\" | \"SIGTERM\";\ntype Output = { write(value: string): unknown };\nexport type PolicyPrompt = Pick<BulkScanPrompt, \"isInteractive\" | \"input\">;\nexport type PolicySecurity = Pick<\n CodexSecurity,\n \"generatePolicy\" | \"preflightPolicy\" | \"previewPolicy\" | \"close\"\n>;\n\nexport interface PolicyCommandOptions {\n repository: string;\n config: CodexSecurityConfig;\n generation: SecurityPolicyOptions;\n headless: boolean;\n dryRun: boolean;\n format: string;\n explicitOutput: boolean;\n}\n\nexport interface PolicyCommandDependencies {\n createSecurity(config: CodexSecurityConfig): PolicySecurity;\n chooseAuthentication(\n config: CodexSecurityConfig,\n auth: ScanAuthMode | undefined,\n signal: AbortSignal,\n ): Promise<ScanAuthMode | undefined>;\n prompt: PolicyPrompt;\n environment: NodeJS.ProcessEnv;\n errorOutput: Output;\n now(): number;\n addSignalListener(signal: SignalName, listener: () => void): void;\n removeSignalListener(signal: SignalName, listener: () => void): void;\n forceExit(signal: SignalName): void;\n}\n\nconst STAGES: Record<SecurityPolicyStage, string> = {\n architecture: \"[1/3] Understanding the system and its security boundaries\",\n threat_model: \"[2/3] Building the source-backed threat model\",\n policy: \"[3/3] Drafting SECURITY.md\",\n};\n\nexport async function runPolicyCommand(\n options: PolicyCommandOptions,\n dependencies: PolicyCommandDependencies,\n): Promise<{\n exitCode: number;\n data?: Record<string, unknown>;\n markdown?: string;\n error?: string;\n}> {\n const { errorOutput, prompt } = dependencies;\n const controller = new AbortController();\n const interactive =\n !options.headless &&\n options.format === \"toon\" &&\n dependencies.environment[\"CI\"] === undefined &&\n prompt.isInteractive();\n const started = dependencies.now();\n let security: PolicySecurity | undefined;\n let outputDir: string | undefined;\n const write = (message: string): void => {\n try {\n errorOutput.write(`${message}\\n`);\n } catch {}\n };\n let firstSignalAt = 0;\n const signalListener = (signal: SignalName) => () => {\n if (controller.signal.aborted) {\n // Match scan's handling of duplicate initial signals from launchers.\n if (\n controller.signal.reason === signal &&\n dependencies.now() - firstSignalAt < 500\n )\n return;\n removeSignalListeners();\n dependencies.forceExit(signal);\n return;\n }\n firstSignalAt = dependencies.now();\n controller.abort(signal);\n };\n const interrupt = signalListener(\"SIGINT\");\n const terminate = signalListener(\"SIGTERM\");\n const removeSignalListeners = () => {\n dependencies.removeSignalListener(\"SIGINT\", interrupt);\n dependencies.removeSignalListener(\"SIGTERM\", terminate);\n };\n dependencies.addSignalListener(\"SIGINT\", interrupt);\n dependencies.addSignalListener(\"SIGTERM\", terminate);\n try {\n const auth =\n interactive && !options.dryRun\n ? await dependencies.chooseAuthentication(\n options.config,\n options.generation.auth,\n controller.signal,\n )\n : options.generation.auth;\n controller.signal.throwIfAborted();\n security = dependencies.createSecurity(options.config);\n if (options.dryRun) {\n const preflight = await security.preflightPolicy(options.repository, {\n ...options.generation,\n signal: controller.signal,\n });\n controller.signal.throwIfAborted();\n return {\n exitCode: 0,\n data: {\n ...preflight,\n dryRun: true,\n },\n };\n }\n const draft = await security.generatePolicy(options.repository, {\n ...options.generation,\n auth,\n signal: controller.signal,\n onOutputDirReady: (directory) => {\n outputDir = directory;\n write(`Policy artifacts: ${display(directory)}`);\n },\n onStage: (stage) => write(STAGES[stage]),\n onWarning: (warning) =>\n write(`codex-security: ${display(safeErrorMessage(warning))}`),\n ...(interactive\n ? {\n answerQuestions: async (\n questions: readonly string[],\n signal: AbortSignal,\n ) => {\n write(\n \"A few details could change this policy. Leave an answer blank to keep it unresolved.\",\n );\n const answers: string[] = [];\n for (const question of questions) {\n signal.throwIfAborted();\n const answer = await prompt.input(\n display(question),\n undefined,\n signal,\n );\n if (answer.trim()) answers.push(`${question}\\n${answer}`);\n }\n return answers.join(\"\\n\\n\");\n },\n }\n : {}),\n });\n controller.signal.throwIfAborted();\n const cost = draft.cost;\n const changed = draft.previousContent !== draft.content;\n const humanOutput = options.format === \"toon\" && !options.explicitOutput;\n if (humanOutput) {\n let diff: string;\n try {\n diff = await security.previewPolicy(draft, {\n signal: controller.signal,\n });\n } catch (error) {\n controller.signal.throwIfAborted();\n diff = \"Preview unavailable. Review the saved draft.\";\n write(\n `codex-security: Could not preview the policy: ${display(safeErrorMessage(error))}`,\n );\n }\n const preview = [\n `\\nPolicy target: ${display(draft.targetPath)}`,\n diff.replace(/\\n$/u, \"\") || \"SECURITY.md is already up to date.\",\n ...(draft.reviewNotes.length === 0\n ? []\n : [\n \"\\nOwner review:\",\n ...draft.reviewNotes.map((note) => `- ${display(note)}`),\n ]),\n ].join(\"\\n\");\n write(preview);\n }\n controller.signal.throwIfAborted();\n const status = changed ? \"draft\" : \"unchanged\";\n if (humanOutput) {\n write(`\\nDraft: ${display(draft.draftPath)}`);\n write(`Architecture: ${display(draft.specificationPath)}`);\n write(`Threat model: ${display(draft.threatModelPath)}`);\n if (changed)\n write(\n \"No repository files changed. Review the saved SECURITY.md before copying it into the repository.\",\n );\n }\n const seconds = Math.max(0, (dependencies.now() - started) / 1000);\n write(\n `Policy generation finished in ${seconds.toFixed(1)}s${cost === null ? \"\" : ` (estimated cost: ${formatScanCost(cost)})`}.`,\n );\n return {\n exitCode: 0,\n markdown: draft.content,\n data: {\n status,\n repository: draft.repository,\n scope: draft.scope,\n targetPath: draft.targetPath,\n outputDir: draft.outputDir,\n draftPath: draft.draftPath,\n specificationPath: draft.specificationPath,\n threatModelPath: draft.threatModelPath,\n customPlugin: draft.customPlugin,\n reviewNotes: draft.reviewNotes,\n cost,\n },\n };\n } catch (error) {\n const signal =\n controller.signal.reason ??\n (error instanceof Error && error.name === \"ExitPromptError\"\n ? \"SIGINT\"\n : undefined);\n const exitCode = signal === \"SIGINT\" ? 130 : signal === \"SIGTERM\" ? 143 : 2;\n const message =\n signal === \"SIGINT\"\n ? \"Policy generation canceled by Ctrl-C.\"\n : signal === \"SIGTERM\"\n ? \"Policy generation terminated by SIGTERM.\"\n : display(safeErrorMessage(error));\n write(`codex-security: ${message}`);\n if (outputDir !== undefined)\n write(`Saved artifacts: ${display(outputDir)}`);\n return {\n exitCode,\n error: message,\n };\n } finally {\n removeSignalListeners();\n try {\n await security?.close();\n } catch (error) {\n write(\n `codex-security: Could not clean up the policy runtime: ${display(safeErrorMessage(error))}`,\n );\n }\n }\n}\n\nexport function policyDisplayData(\n data: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n const displayValue = (value: unknown): unknown => {\n if (typeof value === \"string\") return display(value);\n if (Array.isArray(value)) return value.map(displayValue);\n if (value !== null && typeof value === \"object\")\n return Object.fromEntries(\n Object.entries(value).map(([key, item]) => [key, displayValue(item)]),\n );\n return value;\n };\n return data === undefined\n ? undefined\n : (displayValue(data) as Record<string, unknown>);\n}\n"]}
@@ -0,0 +1,80 @@
1
+ import type { ScanAuthentication, ScanOptions } from "./api.js";
2
+ import type { ScanCost } from "./cost.js";
3
+ import { type ProcessEnvironment } from "./runtime.js";
4
+ export type SecurityPolicyStage = "architecture" | "threat_model" | "policy";
5
+ export interface SecurityPolicyOptions extends Pick<ScanOptions, "auth" | "knowledgeBasePaths" | "outputDir" | "maxCostUsd" | "signal" | "onAuthentication" | "onOutputDirReady" | "onCost" | "onWarning" | "onObserverError"> {
6
+ path?: string;
7
+ onStage?: (stage: SecurityPolicyStage) => void;
8
+ answerQuestions?: (questions: readonly string[], signal: AbortSignal) => Promise<string | undefined>;
9
+ }
10
+ export interface SecurityPolicyTarget {
11
+ repository: string;
12
+ scope: string;
13
+ targetPath: string;
14
+ }
15
+ export declare function requireSecurityPolicyRepositoryBinding(target: SecurityPolicyTarget, signal?: AbortSignal): Promise<void>;
16
+ export declare function securityPolicyProtectedRoots(target: SecurityPolicyTarget, signal?: AbortSignal): Promise<string[]>;
17
+ export interface SecurityPolicyPreflight extends SecurityPolicyTarget {
18
+ outputDir: string | null;
19
+ authentication: ScanAuthentication;
20
+ model: string;
21
+ reasoningEffort: string;
22
+ maxCostUsd?: number;
23
+ }
24
+ export interface SecurityPolicyStageResult {
25
+ markdown: string;
26
+ questions: string[];
27
+ reviewNotes: string[];
28
+ blockedReason: string | null;
29
+ }
30
+ export declare function securityPolicyStageOutputSchema(): Record<string, unknown>;
31
+ export declare function parseSecurityPolicyStageResult(value: unknown): SecurityPolicyStageResult;
32
+ export interface SecurityPolicySnapshot {
33
+ previousContent: string | null;
34
+ inheritedPolicySha256: string;
35
+ }
36
+ export interface SecurityPolicyDraft extends SecurityPolicyTarget, SecurityPolicySnapshot {
37
+ outputDir: string;
38
+ draftPath: string;
39
+ specificationPath: string;
40
+ threatModelPath: string;
41
+ content: string;
42
+ customPlugin: boolean;
43
+ pluginPath?: string;
44
+ reviewNotes: string[];
45
+ cost: Readonly<ScanCost> | null;
46
+ }
47
+ export declare function resolveSecurityPolicyTarget(repository: string, path?: string, signal?: AbortSignal): Promise<SecurityPolicyTarget>;
48
+ export declare function readSecurityPolicy(path: string): Promise<string | null>;
49
+ export declare function readSecurityPolicySnapshot(target: SecurityPolicyTarget, signal?: AbortSignal, gitMetadataPaths?: readonly string[]): Promise<SecurityPolicySnapshot>;
50
+ export declare function inspectSecurityPolicySources(target: SecurityPolicyTarget, signal?: AbortSignal): Promise<{
51
+ policyPaths: string[];
52
+ gitMetadataPaths: string[];
53
+ }>;
54
+ export declare function requireUnchangedSecurityPolicy(target: SecurityPolicyTarget, snapshot: SecurityPolicySnapshot, signal?: AbortSignal, gitMetadataPaths?: readonly string[]): Promise<void>;
55
+ export declare function resolveSecurityPolicyGuidance(target: SecurityPolicyTarget, pluginRoot: string, environment?: ProcessEnvironment, signal?: AbortSignal, policyPaths?: readonly string[], gitMetadataPaths?: readonly string[]): Promise<string>;
56
+ export declare function runSecurityPolicyStages(options: {
57
+ target: SecurityPolicyTarget;
58
+ snapshot: SecurityPolicySnapshot;
59
+ policyPaths: readonly string[];
60
+ gitMetadataPaths: readonly string[];
61
+ outputDir: string;
62
+ pluginRoot: string;
63
+ pluginPath?: string;
64
+ guidance: string;
65
+ knowledgeBasePath?: string;
66
+ revision: string | null;
67
+ model: string;
68
+ reasoningEffort: string;
69
+ pluginVersion: string;
70
+ signal: AbortSignal;
71
+ onStage?: SecurityPolicyOptions["onStage"];
72
+ answerQuestions?: SecurityPolicyOptions["answerQuestions"];
73
+ run(stage: SecurityPolicyStage, prompt: string): Promise<SecurityPolicyStageResult>;
74
+ cost(): Readonly<ScanCost> | null;
75
+ }): Promise<SecurityPolicyDraft>;
76
+ /** Raw unified diff. A Python resolver is called only when there is a change.
77
+ * Use CodexSecurity.previewPolicy() for terminal output. */
78
+ export declare function securityPolicyDiff(draft: SecurityPolicyDraft, python?: string | (() => Promise<string>), signal?: AbortSignal): Promise<string>;
79
+ export declare function formatSecurityPolicyText(value: string, multiline?: boolean): string;
80
+ //# sourceMappingURL=security-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"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"}