@openai/codex-security 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/README.md +45 -9
  2. package/_bundled_plugin/.codex-plugin/plugin.json +5 -5
  3. package/_bundled_plugin/.mcp.json +1 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  5. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  6. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  7. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +13 -20
  8. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  9. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  10. package/_bundled_plugin/references/core-scan.md +2 -0
  11. package/_bundled_plugin/references/final-report.md +5 -1
  12. package/_bundled_plugin/references/investigation-time-budget.md +11 -0
  13. package/_bundled_plugin/references/sarif-adapter.md +1 -0
  14. package/_bundled_plugin/references/scan-prologue.md +2 -6
  15. package/_bundled_plugin/references/scan-runtime.md +15 -0
  16. package/_bundled_plugin/references/threat-model.md +2 -0
  17. package/_bundled_plugin/schemas/coverage.schema.json +45 -126
  18. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +5 -1
  19. package/_bundled_plugin/schemas/findings.schema.json +140 -427
  20. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  21. package/_bundled_plugin/schemas/scan-manifest.schema.json +73 -188
  22. package/_bundled_plugin/scripts/deep_scan_workbench.py +7 -0
  23. package/_bundled_plugin/scripts/finalize_scan_contract.py +87 -49
  24. package/_bundled_plugin/scripts/finding_preview.py +5 -3
  25. package/_bundled_plugin/scripts/generate_rank_input.py +26 -106
  26. package/_bundled_plugin/scripts/launch_codex_security_mcp +39 -4
  27. package/_bundled_plugin/scripts/report_projection.py +35 -13
  28. package/_bundled_plugin/scripts/snapshot_sqlite.py +7 -0
  29. package/_bundled_plugin/scripts/windows_scan_local_files.py +43 -1
  30. package/_bundled_plugin/scripts/workbench_cli.py +9 -9
  31. package/_bundled_plugin/scripts/workbench_constants.py +4 -0
  32. package/_bundled_plugin/scripts/workbench_db.py +103 -45
  33. package/_bundled_plugin/scripts/workbench_progress.py +0 -50
  34. package/_bundled_plugin/scripts/workbench_publication.py +216 -247
  35. package/_bundled_plugin/scripts/workbench_scan_history.py +3 -2
  36. package/_bundled_plugin/scripts/workbench_scan_start.py +12 -4
  37. package/_bundled_plugin/scripts/workbench_scan_usage.py +360 -37
  38. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  39. package/_bundled_plugin/scripts/workbench_source_excerpt.py +74 -51
  40. package/_bundled_plugin/scripts/workbench_source_scopes.py +388 -0
  41. package/_bundled_plugin/scripts/workbench_target.py +7 -5
  42. package/_bundled_plugin/scripts/workbench_validation.py +52 -2
  43. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -0
  44. package/_bundled_plugin/shared/workbench-migrations.json +22 -0
  45. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +1 -1
  46. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  47. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +4 -2
  48. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  49. package/_bundled_plugin/skills/security-scan/SKILL.md +4 -2
  50. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  51. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -3
  52. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +2 -0
  53. package/_bundled_plugin/skills/track-findings/SKILL.md +8 -4
  54. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  55. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +1 -1
  56. package/dist/api.d.ts +6 -2
  57. package/dist/api.d.ts.map +1 -1
  58. package/dist/api.js +266 -39
  59. package/dist/api.js.map +1 -1
  60. package/dist/artifact-export.d.ts +2 -1
  61. package/dist/artifact-export.d.ts.map +1 -1
  62. package/dist/artifact-export.js +38 -23
  63. package/dist/artifact-export.js.map +1 -1
  64. package/dist/classify-severity-records.d.ts +76 -0
  65. package/dist/classify-severity-records.d.ts.map +1 -0
  66. package/dist/classify-severity-records.js +141 -0
  67. package/dist/classify-severity-records.js.map +1 -0
  68. package/dist/classify-severity.d.ts +1 -23
  69. package/dist/classify-severity.d.ts.map +1 -1
  70. package/dist/classify-severity.js +3 -24
  71. package/dist/classify-severity.js.map +1 -1
  72. package/dist/cli-help.d.ts.map +1 -1
  73. package/dist/cli-help.js +2 -0
  74. package/dist/cli-help.js.map +1 -1
  75. package/dist/cli.d.ts +4 -2
  76. package/dist/cli.d.ts.map +1 -1
  77. package/dist/cli.js +148 -149
  78. package/dist/cli.js.map +1 -1
  79. package/dist/cloud-publish.js +1 -1
  80. package/dist/cloud-publish.js.map +1 -1
  81. package/dist/codex-sdk-environment.js +1 -1
  82. package/dist/codex-sdk-environment.js.map +1 -1
  83. package/dist/component-plan.js +1 -1
  84. package/dist/component-plan.js.map +1 -1
  85. package/dist/component-scan.d.ts.map +1 -1
  86. package/dist/component-scan.js +5 -4
  87. package/dist/component-scan.js.map +1 -1
  88. package/dist/config.d.ts +12 -0
  89. package/dist/config.d.ts.map +1 -1
  90. package/dist/config.js +10 -4
  91. package/dist/config.js.map +1 -1
  92. package/dist/contract.d.ts +6 -0
  93. package/dist/contract.d.ts.map +1 -1
  94. package/dist/contract.js +69 -20
  95. package/dist/contract.js.map +1 -1
  96. package/dist/cost-model.d.ts.map +1 -1
  97. package/dist/cost-model.js +7 -2
  98. package/dist/cost-model.js.map +1 -1
  99. package/dist/custom-validation-prompt.js +3 -3
  100. package/dist/custom-validation-prompt.js.map +1 -1
  101. package/dist/deduplication/codex-review.d.ts +1 -5
  102. package/dist/deduplication/codex-review.d.ts.map +1 -1
  103. package/dist/deduplication/codex-review.js +2 -2
  104. package/dist/deduplication/codex-review.js.map +1 -1
  105. package/dist/deduplication/deduplication-prompts.d.ts +1 -1
  106. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  107. package/dist/deduplication/deduplication-prompts.js +2 -2
  108. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  109. package/dist/deduplication/deduplication-reviewer.d.ts +1 -1
  110. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  111. package/dist/deduplication/deduplication-reviewer.js +1 -1
  112. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  113. package/dist/deduplication/records-protocol.d.ts +3 -8
  114. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  115. package/dist/deduplication/records-protocol.js +11 -171
  116. package/dist/deduplication/records-protocol.js.map +1 -1
  117. package/dist/deduplication/records.js +1 -1
  118. package/dist/deduplication/records.js.map +1 -1
  119. package/dist/deduplication/scan.d.ts.map +1 -1
  120. package/dist/deduplication/scan.js +10 -9
  121. package/dist/deduplication/scan.js.map +1 -1
  122. package/dist/deep-config.d.ts +4 -1
  123. package/dist/deep-config.d.ts.map +1 -1
  124. package/dist/deep-config.js +21 -1
  125. package/dist/deep-config.js.map +1 -1
  126. package/dist/deep-progress.d.ts +15 -1
  127. package/dist/deep-progress.d.ts.map +1 -1
  128. package/dist/deep-progress.js +15 -16
  129. package/dist/deep-progress.js.map +1 -1
  130. package/dist/executable-path.d.ts +2 -0
  131. package/dist/executable-path.d.ts.map +1 -0
  132. package/dist/executable-path.js +12 -0
  133. package/dist/executable-path.js.map +1 -0
  134. package/dist/feedback.d.ts +1 -4
  135. package/dist/feedback.d.ts.map +1 -1
  136. package/dist/feedback.js +1 -1
  137. package/dist/feedback.js.map +1 -1
  138. package/dist/findings-import.d.ts +1 -1
  139. package/dist/findings-import.d.ts.map +1 -1
  140. package/dist/findings-import.js +3 -3
  141. package/dist/findings-import.js.map +1 -1
  142. package/dist/git-remote.d.ts +10 -0
  143. package/dist/git-remote.d.ts.map +1 -0
  144. package/dist/git-remote.js +24 -0
  145. package/dist/git-remote.js.map +1 -0
  146. package/dist/github.d.ts.map +1 -1
  147. package/dist/github.js +5 -7
  148. package/dist/github.js.map +1 -1
  149. package/dist/host-protocol.d.ts +19 -0
  150. package/dist/host-protocol.d.ts.map +1 -0
  151. package/dist/host-protocol.js +270 -0
  152. package/dist/host-protocol.js.map +1 -0
  153. package/dist/host-records-protocol.d.ts +15 -0
  154. package/dist/host-records-protocol.d.ts.map +1 -0
  155. package/dist/host-records-protocol.js +15 -0
  156. package/dist/host-records-protocol.js.map +1 -0
  157. package/dist/hosted-scan-protocol.d.ts +4 -0
  158. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  159. package/dist/hosted-scan-protocol.js +25 -0
  160. package/dist/hosted-scan-protocol.js.map +1 -0
  161. package/dist/hosted-scan.d.ts +112 -0
  162. package/dist/hosted-scan.d.ts.map +1 -0
  163. package/dist/hosted-scan.js +260 -0
  164. package/dist/hosted-scan.js.map +1 -0
  165. package/dist/index.d.ts +7 -0
  166. package/dist/index.d.ts.map +1 -1
  167. package/dist/index.js +3 -0
  168. package/dist/index.js.map +1 -1
  169. package/dist/knowledge-base.d.ts.map +1 -1
  170. package/dist/knowledge-base.js +87 -7
  171. package/dist/knowledge-base.js.map +1 -1
  172. package/dist/multiscan.d.ts.map +1 -1
  173. package/dist/multiscan.js +108 -36
  174. package/dist/multiscan.js.map +1 -1
  175. package/dist/patch-publication.d.ts +26 -0
  176. package/dist/patch-publication.d.ts.map +1 -0
  177. package/dist/patch-publication.js +105 -0
  178. package/dist/patch-publication.js.map +1 -0
  179. package/dist/patch-tui.d.ts.map +1 -1
  180. package/dist/patch-tui.js +4 -1
  181. package/dist/patch-tui.js.map +1 -1
  182. package/dist/project-config-schema.d.ts +2 -0
  183. package/dist/project-config-schema.d.ts.map +1 -1
  184. package/dist/project-config-schema.js +1 -0
  185. package/dist/project-config-schema.js.map +1 -1
  186. package/dist/project-config.d.ts +1 -0
  187. package/dist/project-config.d.ts.map +1 -1
  188. package/dist/project-config.js +16 -6
  189. package/dist/project-config.js.map +1 -1
  190. package/dist/publication-store.d.ts.map +1 -1
  191. package/dist/publication-store.js +73 -63
  192. package/dist/publication-store.js.map +1 -1
  193. package/dist/publication.d.ts +0 -2
  194. package/dist/publication.d.ts.map +1 -1
  195. package/dist/publication.js +135 -24
  196. package/dist/publication.js.map +1 -1
  197. package/dist/publish.d.ts.map +1 -1
  198. package/dist/publish.js +39 -25
  199. package/dist/publish.js.map +1 -1
  200. package/dist/runtime.d.ts +5 -2
  201. package/dist/runtime.d.ts.map +1 -1
  202. package/dist/runtime.js +86 -58
  203. package/dist/runtime.js.map +1 -1
  204. package/dist/scan-executor.d.ts +104 -0
  205. package/dist/scan-executor.d.ts.map +1 -0
  206. package/dist/scan-executor.js +62 -0
  207. package/dist/scan-executor.js.map +1 -0
  208. package/dist/scan-settings.d.ts +1 -0
  209. package/dist/scan-settings.d.ts.map +1 -1
  210. package/dist/scan-settings.js +7 -1
  211. package/dist/scan-settings.js.map +1 -1
  212. package/dist/scan-time-budget.d.ts +9 -0
  213. package/dist/scan-time-budget.d.ts.map +1 -0
  214. package/dist/scan-time-budget.js +16 -0
  215. package/dist/scan-time-budget.js.map +1 -0
  216. package/dist/severity-review.d.ts +29 -0
  217. package/dist/severity-review.d.ts.map +1 -0
  218. package/dist/severity-review.js +47 -0
  219. package/dist/severity-review.js.map +1 -0
  220. package/dist/targets.d.ts.map +1 -1
  221. package/dist/targets.js +17 -25
  222. package/dist/targets.js.map +1 -1
  223. package/dist/validation-records.d.ts +38 -0
  224. package/dist/validation-records.d.ts.map +1 -0
  225. package/dist/validation-records.js +76 -0
  226. package/dist/validation-records.js.map +1 -0
  227. package/dist/version.d.ts.map +1 -1
  228. package/dist/version.js +4 -2
  229. package/dist/version.js.map +1 -1
  230. package/dist/worker-progress.d.ts +43 -15
  231. package/dist/worker-progress.d.ts.map +1 -1
  232. package/dist/worker-progress.js +22 -80
  233. package/dist/worker-progress.js.map +1 -1
  234. package/docs/classify-severity-records.md +89 -0
  235. package/docs/cli.md +281 -35
  236. package/docs/hosted-scans.md +242 -0
  237. package/docs/validate-records.md +69 -0
  238. package/package.json +18 -14
  239. package/schemas/hosted-scan-v2.fixture.json +145 -0
  240. package/schemas/project-config.schema.json +7 -1
  241. package/_bundled_plugin/preflight/capability-profiles.toml +0 -76
  242. package/_bundled_plugin/references/config-preflight.md +0 -93
  243. package/_bundled_plugin/references/desktop-config-preflight.md +0 -11
  244. package/_bundled_plugin/scripts/config_preflight.py +0 -911
@@ -1,72 +1,50 @@
1
1
  import { z } from "zod";
2
- import { findingEntry } from "./value.js";
3
2
  import { stat } from "node:fs/promises";
4
3
  import { join } from "node:path";
5
4
  import { isRecord } from "./record.js";
6
5
  import { CodexSecurityError } from "./errors.js";
7
6
  import { codexSecurityStateDirectory, resolveWorkbenchRuntime, runWorkbench, } from "./runtime.js";
8
7
  export async function inspectPublicationStore(publication, environment, signal) {
9
- const result = await runPublicationWorkbench("inspect-linear-publication", publication, environment, undefined, signal);
10
- const recorded = publicationRecordsSchema.safeParse(result["recorded"]);
11
- if (!matchesPublication(result, publication) ||
12
- result["findingCount"] !==
13
- (publication.sourceFindings ?? publication.issues).length ||
14
- !recorded.success) {
15
- throw invalidPublicationRecords();
16
- }
17
- const expected = new Map((publication.sourceFindings ?? publication.issues).map((issue) => [
18
- issue.findingId,
19
- issue.occurrenceId,
20
- ]));
21
- const found = new Map();
22
- for (const issue of recorded.data) {
23
- if (expected.get(issue.findingId) !== issue.occurrenceId ||
24
- found.has(issue.findingId)) {
25
- throw invalidPublicationRecords();
26
- }
27
- found.set(issue.findingId, issue);
28
- }
29
- return publication.issues.flatMap(({ findingId }) => {
30
- const issue = found.get(findingId);
31
- return issue === undefined ? [] : [issue];
8
+ const receipts = await findingIssues("inspect", publication, environment, [], signal);
9
+ return publication.issues.flatMap(({ findingId, occurrenceId }) => {
10
+ // Tracking can reuse an issue across scans. CLI skipping remains specific to
11
+ // the selected occurrence, irrespective of which workflow recorded it.
12
+ const receipt = receipts.find((issue) => issue.scanId === publication.scanId &&
13
+ issue.findingId === findingId &&
14
+ issue.occurrenceId === occurrenceId);
15
+ return receipt === undefined ? [] : [publishedIssue(receipt)];
32
16
  });
33
17
  }
34
18
  export async function preparePublicationStore(publication, environment) {
35
- const result = await runPublicationWorkbench("prepare-linear-publication", publication, environment);
36
- if (result["scanId"] !== publication.scanId ||
37
- result["findingCount"] !==
38
- (publication.sourceFindings ?? publication.issues).length) {
39
- throw new CodexSecurityError("The workbench could not verify every finding selected for publication.");
40
- }
19
+ await findingIssues("prepare", publication, environment);
41
20
  }
42
21
  export async function recordPublishedIssues(publication, issues, environment) {
43
- const result = await runPublicationWorkbench("record-linear-publications", publication, environment, issues);
44
- const created = publicationRecordsSchema.safeParse(result["created"]);
45
- if (!matchesPublication(result, publication) ||
46
- !created.success ||
47
- created.data.length !== issues.length) {
22
+ const receipts = await findingIssues("record", publication, environment, issues);
23
+ if (receipts.length !== issues.length) {
48
24
  throw invalidPublicationRecords();
49
25
  }
50
- const expected = new Map(issues.map(findingEntry));
51
- const ordered = publication.issues.flatMap((issue) => {
52
- const record = expected.get(issue.findingId);
53
- return record === undefined ? [] : [record];
54
- });
55
- if (expected.size !== issues.length || ordered.length !== issues.length) {
56
- throw invalidPublicationRecords();
57
- }
58
- return created.data.map((issue, index) => {
59
- const expectedIssue = ordered[index];
60
- if (issue.findingId !== expectedIssue.findingId ||
61
- issue.occurrenceId !== expectedIssue.occurrenceId ||
62
- issue.issueIdentifier !== expectedIssue.issueIdentifier ||
63
- (expectedIssue.url !== undefined && issue.url !== expectedIssue.url)) {
26
+ const recorded = new Map();
27
+ for (const [index, receipt] of receipts.entries()) {
28
+ const expectedIssue = issues[index];
29
+ if (receipt.scanId !== publication.scanId ||
30
+ receipt.findingId !== expectedIssue.findingId ||
31
+ receipt.occurrenceId !== expectedIssue.occurrenceId ||
32
+ receipt.issueIdentifier !== expectedIssue.issueIdentifier ||
33
+ (expectedIssue.url !== undefined && receipt.url !== expectedIssue.url) ||
34
+ recorded.has(receipt.findingId)) {
64
35
  throw invalidPublicationRecords();
65
36
  }
66
- return issue;
37
+ recorded.set(receipt.findingId, receipt);
38
+ }
39
+ const ordered = publication.issues.flatMap(({ findingId }) => {
40
+ const receipt = recorded.get(findingId);
41
+ return receipt === undefined ? [] : [publishedIssue(receipt)];
67
42
  });
43
+ if (ordered.length !== issues.length)
44
+ throw invalidPublicationRecords();
45
+ return ordered;
68
46
  }
69
- async function runPublicationWorkbench(command, publication, environment, issues, signal) {
47
+ async function findingIssues(action, publication, environment, issues = [], signal) {
70
48
  signal?.throwIfAborted();
71
49
  const stateDirectory = codexSecurityStateDirectory(environment);
72
50
  const database = join(stateDirectory, "workbench.sqlite3");
@@ -81,28 +59,59 @@ async function runPublicationWorkbench(command, publication, environment, issues
81
59
  const [python, pluginRoot] = await resolveWorkbenchRuntime({
82
60
  environment,
83
61
  protectedRoot: publication.scanDirectory,
84
- ...(signal === undefined ? {} : { signal }),
62
+ signal,
85
63
  });
86
64
  signal?.throwIfAborted();
87
- const findings = (publication.sourceFindings ?? publication.issues).map(({ findingId, occurrenceId }) => ({
88
- findingId,
89
- occurrenceId,
90
- }));
91
- return await runWorkbench({
65
+ const result = await runWorkbench({
92
66
  python,
93
67
  pluginRoot,
94
68
  environment,
95
- ...(signal === undefined ? {} : { signal }),
96
- failureMessage: command === "record-linear-publications"
69
+ signal,
70
+ failureMessage: action === "record"
97
71
  ? "Could not persist created Linear issues in the local Codex Security scan history"
98
72
  : "Cannot publish findings without their existing local Codex Security scan history",
99
- }, [command], JSON.stringify({
100
- scanId: publication.scanId,
73
+ }, ["finding-issues"], JSON.stringify({
74
+ action,
101
75
  scanDirectory: publication.scanDirectory,
76
+ expectedScanId: publication.scanId,
102
77
  destination: publication.destination,
103
- findings,
104
- ...(issues === undefined ? {} : { publications: issues }),
78
+ findingIds: publication.issues.map(({ findingId }) => findingId),
79
+ requireHistory: true,
80
+ ...(action === "record"
81
+ ? {
82
+ receipts: issues.map((issue) => ({
83
+ ...issue,
84
+ operation: "create",
85
+ })),
86
+ }
87
+ : {}),
105
88
  }));
89
+ const receipts = publicationRecordsSchema.safeParse(result["receipts"]);
90
+ if (!matchesPublication(result, publication) ||
91
+ result["findingCount"] !== publication.issues.length ||
92
+ !receipts.success) {
93
+ throw invalidPublicationRecords();
94
+ }
95
+ const selected = new Map(publication.issues.map(({ findingId, occurrenceId }) => [
96
+ findingId,
97
+ occurrenceId,
98
+ ]));
99
+ for (const receipt of receipts.data) {
100
+ if (!selected.has(receipt.findingId) ||
101
+ (receipt.scanId === publication.scanId &&
102
+ selected.get(receipt.findingId) !== receipt.occurrenceId)) {
103
+ throw invalidPublicationRecords();
104
+ }
105
+ }
106
+ return receipts.data;
107
+ }
108
+ function publishedIssue(issue) {
109
+ return {
110
+ findingId: issue.findingId,
111
+ occurrenceId: issue.occurrenceId,
112
+ issueIdentifier: issue.issueIdentifier,
113
+ ...(issue.url === undefined ? {} : { url: issue.url }),
114
+ };
106
115
  }
107
116
  function matchesPublication(result, publication) {
108
117
  const destination = result["destination"];
@@ -114,6 +123,7 @@ function matchesPublication(result, publication) {
114
123
  }
115
124
  const publicationRecordsSchema = z
116
125
  .object({
126
+ scanId: z.string(),
117
127
  findingId: z.string(),
118
128
  occurrenceId: z.string(),
119
129
  issueIdentifier: z.string().refine((value) => Boolean(value.trim())),
@@ -1 +1 @@
1
- {"version":3,"file":"publication-store.js","sourceRoot":"","sources":["../src/publication-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { findingEntry } from \"./value.js\";\nimport { stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { isRecord } from \"./record.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type { PreparedScanPublication } from \"./publication.js\";\nimport type { PublishedScanIssue } from \"./publish.js\";\nimport {\n codexSecurityStateDirectory,\n resolveWorkbenchRuntime,\n runWorkbench,\n} from \"./runtime.js\";\n\nexport async function inspectPublicationStore(\n publication: PreparedScanPublication,\n environment: NodeJS.ProcessEnv,\n signal?: AbortSignal,\n): Promise<PublishedScanIssue[]> {\n const result = await runPublicationWorkbench(\n \"inspect-linear-publication\",\n publication,\n environment,\n undefined,\n signal,\n );\n const recorded = publicationRecordsSchema.safeParse(result[\"recorded\"]);\n if (\n !matchesPublication(result, publication) ||\n result[\"findingCount\"] !==\n (publication.sourceFindings ?? publication.issues).length ||\n !recorded.success\n ) {\n throw invalidPublicationRecords();\n }\n const expected = new Map(\n (publication.sourceFindings ?? publication.issues).map((issue) => [\n issue.findingId,\n issue.occurrenceId,\n ]),\n );\n const found = new Map<string, PublishedScanIssue>();\n for (const issue of recorded.data) {\n if (\n expected.get(issue.findingId) !== issue.occurrenceId ||\n found.has(issue.findingId)\n ) {\n throw invalidPublicationRecords();\n }\n found.set(issue.findingId, issue);\n }\n return publication.issues.flatMap(({ findingId }) => {\n const issue = found.get(findingId);\n return issue === undefined ? [] : [issue];\n });\n}\n\nexport async function preparePublicationStore(\n publication: PreparedScanPublication,\n environment: NodeJS.ProcessEnv,\n): Promise<void> {\n const result = await runPublicationWorkbench(\n \"prepare-linear-publication\",\n publication,\n environment,\n );\n if (\n result[\"scanId\"] !== publication.scanId ||\n result[\"findingCount\"] !==\n (publication.sourceFindings ?? publication.issues).length\n ) {\n throw new CodexSecurityError(\n \"The workbench could not verify every finding selected for publication.\",\n );\n }\n}\n\nexport async function recordPublishedIssues(\n publication: PreparedScanPublication,\n issues: readonly PublishedScanIssue[],\n environment: NodeJS.ProcessEnv,\n): Promise<PublishedScanIssue[]> {\n const result = await runPublicationWorkbench(\n \"record-linear-publications\",\n publication,\n environment,\n issues,\n );\n const created = publicationRecordsSchema.safeParse(result[\"created\"]);\n if (\n !matchesPublication(result, publication) ||\n !created.success ||\n created.data.length !== issues.length\n ) {\n throw invalidPublicationRecords();\n }\n\n const expected = new Map(issues.map(findingEntry));\n const ordered = publication.issues.flatMap((issue) => {\n const record = expected.get(issue.findingId);\n return record === undefined ? [] : [record];\n });\n if (expected.size !== issues.length || ordered.length !== issues.length) {\n throw invalidPublicationRecords();\n }\n\n return created.data.map((issue, index) => {\n const expectedIssue = ordered[index]!;\n if (\n issue.findingId !== expectedIssue.findingId ||\n issue.occurrenceId !== expectedIssue.occurrenceId ||\n issue.issueIdentifier !== expectedIssue.issueIdentifier ||\n (expectedIssue.url !== undefined && issue.url !== expectedIssue.url)\n ) {\n throw invalidPublicationRecords();\n }\n return issue;\n });\n}\n\nasync function runPublicationWorkbench(\n command:\n | \"inspect-linear-publication\"\n | \"prepare-linear-publication\"\n | \"record-linear-publications\",\n publication: PreparedScanPublication,\n environment: NodeJS.ProcessEnv,\n issues?: readonly PublishedScanIssue[],\n signal?: AbortSignal,\n): Promise<Record<string, unknown>> {\n signal?.throwIfAborted();\n const stateDirectory = codexSecurityStateDirectory(environment);\n const database = join(stateDirectory, \"workbench.sqlite3\");\n const metadata = await stat(database).catch((error: unknown) => {\n if (!isRecord(error) || error[\"code\"] !== \"ENOENT\") throw error;\n throw new CodexSecurityError(\n \"Cannot publish findings because the local Codex Security scan-history database does not exist. Use the state directory where this scan was completed.\",\n { cause: error },\n );\n });\n if (!metadata.isFile()) {\n throw new CodexSecurityError(\n \"Cannot publish findings because the local Codex Security scan-history database is not a regular file.\",\n );\n }\n const [python, pluginRoot] = await resolveWorkbenchRuntime({\n environment,\n protectedRoot: publication.scanDirectory,\n ...(signal === undefined ? {} : { signal }),\n });\n signal?.throwIfAborted();\n const findings = (publication.sourceFindings ?? publication.issues).map(\n ({ findingId, occurrenceId }) => ({\n findingId,\n occurrenceId,\n }),\n );\n return await runWorkbench(\n {\n python,\n pluginRoot,\n environment,\n ...(signal === undefined ? {} : { signal }),\n failureMessage:\n command === \"record-linear-publications\"\n ? \"Could not persist created Linear issues in the local Codex Security scan history\"\n : \"Cannot publish findings without their existing local Codex Security scan history\",\n },\n [command],\n JSON.stringify({\n scanId: publication.scanId,\n scanDirectory: publication.scanDirectory,\n destination: publication.destination,\n findings,\n ...(issues === undefined ? {} : { publications: issues }),\n }),\n );\n}\n\nfunction matchesPublication(\n result: Record<string, unknown>,\n publication: PreparedScanPublication,\n): boolean {\n const destination = result[\"destination\"];\n return (\n result[\"scanId\"] === publication.scanId &&\n isRecord(destination) &&\n destination[\"type\"] === publication.destination.type &&\n destination[\"teamId\"] === publication.destination.teamId &&\n destination[\"projectId\"] === publication.destination.projectId\n );\n}\n\nconst publicationRecordsSchema = z\n .object({\n findingId: z.string(),\n occurrenceId: z.string(),\n issueIdentifier: z.string().refine((value) => Boolean(value.trim())),\n url: z.string().optional(),\n })\n .array();\n\nfunction invalidPublicationRecords(): CodexSecurityError {\n return new CodexSecurityError(\n \"The workbench returned invalid persisted Linear publication records.\",\n );\n}\n"]}
1
+ {"version":3,"file":"publication-store.js","sourceRoot":"","sources":["../src/publication-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { isRecord } from \"./record.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type { PreparedScanPublication } from \"./publication.js\";\nimport type { PublishedScanIssue } from \"./publish.js\";\nimport {\n codexSecurityStateDirectory,\n resolveWorkbenchRuntime,\n runWorkbench,\n} from \"./runtime.js\";\n\ntype StoredIssue = PublishedScanIssue & { scanId: string };\n\nexport async function inspectPublicationStore(\n publication: PreparedScanPublication,\n environment: NodeJS.ProcessEnv,\n signal?: AbortSignal,\n): Promise<PublishedScanIssue[]> {\n const receipts = await findingIssues(\n \"inspect\",\n publication,\n environment,\n [],\n signal,\n );\n return publication.issues.flatMap(({ findingId, occurrenceId }) => {\n // Tracking can reuse an issue across scans. CLI skipping remains specific to\n // the selected occurrence, irrespective of which workflow recorded it.\n const receipt = receipts.find(\n (issue) =>\n issue.scanId === publication.scanId &&\n issue.findingId === findingId &&\n issue.occurrenceId === occurrenceId,\n );\n return receipt === undefined ? [] : [publishedIssue(receipt)];\n });\n}\n\nexport async function preparePublicationStore(\n publication: PreparedScanPublication,\n environment: NodeJS.ProcessEnv,\n): Promise<void> {\n await findingIssues(\"prepare\", publication, environment);\n}\n\nexport async function recordPublishedIssues(\n publication: PreparedScanPublication,\n issues: readonly PublishedScanIssue[],\n environment: NodeJS.ProcessEnv,\n): Promise<PublishedScanIssue[]> {\n const receipts = await findingIssues(\n \"record\",\n publication,\n environment,\n issues,\n );\n if (receipts.length !== issues.length) {\n throw invalidPublicationRecords();\n }\n const recorded = new Map<string, StoredIssue>();\n for (const [index, receipt] of receipts.entries()) {\n const expectedIssue = issues[index]!;\n if (\n receipt.scanId !== publication.scanId ||\n receipt.findingId !== expectedIssue.findingId ||\n receipt.occurrenceId !== expectedIssue.occurrenceId ||\n receipt.issueIdentifier !== expectedIssue.issueIdentifier ||\n (expectedIssue.url !== undefined && receipt.url !== expectedIssue.url) ||\n recorded.has(receipt.findingId)\n ) {\n throw invalidPublicationRecords();\n }\n recorded.set(receipt.findingId, receipt);\n }\n const ordered = publication.issues.flatMap(({ findingId }) => {\n const receipt = recorded.get(findingId);\n return receipt === undefined ? [] : [publishedIssue(receipt)];\n });\n if (ordered.length !== issues.length) throw invalidPublicationRecords();\n return ordered;\n}\n\nasync function findingIssues(\n action: \"inspect\" | \"prepare\" | \"record\",\n publication: PreparedScanPublication,\n environment: NodeJS.ProcessEnv,\n issues: readonly PublishedScanIssue[] = [],\n signal?: AbortSignal,\n): Promise<StoredIssue[]> {\n signal?.throwIfAborted();\n const stateDirectory = codexSecurityStateDirectory(environment);\n const database = join(stateDirectory, \"workbench.sqlite3\");\n const metadata = await stat(database).catch((error: unknown) => {\n if (!isRecord(error) || error[\"code\"] !== \"ENOENT\") throw error;\n throw new CodexSecurityError(\n \"Cannot publish findings because the local Codex Security scan-history database does not exist. Use the state directory where this scan was completed.\",\n { cause: error },\n );\n });\n if (!metadata.isFile()) {\n throw new CodexSecurityError(\n \"Cannot publish findings because the local Codex Security scan-history database is not a regular file.\",\n );\n }\n const [python, pluginRoot] = await resolveWorkbenchRuntime({\n environment,\n protectedRoot: publication.scanDirectory,\n signal,\n });\n signal?.throwIfAborted();\n const result = await runWorkbench(\n {\n python,\n pluginRoot,\n environment,\n signal,\n failureMessage:\n action === \"record\"\n ? \"Could not persist created Linear issues in the local Codex Security scan history\"\n : \"Cannot publish findings without their existing local Codex Security scan history\",\n },\n [\"finding-issues\"],\n JSON.stringify({\n action,\n scanDirectory: publication.scanDirectory,\n expectedScanId: publication.scanId,\n destination: publication.destination,\n findingIds: publication.issues.map(({ findingId }) => findingId),\n requireHistory: true,\n ...(action === \"record\"\n ? {\n receipts: issues.map((issue) => ({\n ...issue,\n operation: \"create\",\n })),\n }\n : {}),\n }),\n );\n const receipts = publicationRecordsSchema.safeParse(result[\"receipts\"]);\n if (\n !matchesPublication(result, publication) ||\n result[\"findingCount\"] !== publication.issues.length ||\n !receipts.success\n ) {\n throw invalidPublicationRecords();\n }\n const selected = new Map(\n publication.issues.map(({ findingId, occurrenceId }) => [\n findingId,\n occurrenceId,\n ]),\n );\n for (const receipt of receipts.data) {\n if (\n !selected.has(receipt.findingId) ||\n (receipt.scanId === publication.scanId &&\n selected.get(receipt.findingId) !== receipt.occurrenceId)\n ) {\n throw invalidPublicationRecords();\n }\n }\n return receipts.data;\n}\n\nfunction publishedIssue(issue: StoredIssue): PublishedScanIssue {\n return {\n findingId: issue.findingId,\n occurrenceId: issue.occurrenceId,\n issueIdentifier: issue.issueIdentifier,\n ...(issue.url === undefined ? {} : { url: issue.url }),\n };\n}\n\nfunction matchesPublication(\n result: Record<string, unknown>,\n publication: PreparedScanPublication,\n): boolean {\n const destination = result[\"destination\"];\n return (\n result[\"scanId\"] === publication.scanId &&\n isRecord(destination) &&\n destination[\"type\"] === publication.destination.type &&\n destination[\"teamId\"] === publication.destination.teamId &&\n destination[\"projectId\"] === publication.destination.projectId\n );\n}\n\nconst publicationRecordsSchema = z\n .object({\n scanId: z.string(),\n findingId: z.string(),\n occurrenceId: z.string(),\n issueIdentifier: z.string().refine((value) => Boolean(value.trim())),\n url: z.string().optional(),\n })\n .array();\n\nfunction invalidPublicationRecords(): CodexSecurityError {\n return new CodexSecurityError(\n \"The workbench returned invalid persisted Linear publication records.\",\n );\n}\n"]}
@@ -30,8 +30,6 @@ export interface PreparedScanPublication {
30
30
  scanDirectory: string;
31
31
  destination: LinearPublicationDestination;
32
32
  issues: PreparedPublicationIssue[];
33
- /** Complete sealed membership, retained when only some findings become issues. */
34
- sourceFindings?: Pick<PreparedPublicationIssue, "findingId" | "occurrenceId">[];
35
33
  }
36
34
  export declare function linearPublicationArguments(destination: LinearPublicationDestination, issue: PreparedPublicationIssue): Pick<PreparedPublicationIssue, "title" | "description" | "priority"> & {
37
35
  team: string;
@@ -1 +1 @@
1
- {"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../src/publication.ts"],"names":[],"mappings":"AAcA,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,QAAQ,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+GAA+G;IAC/G,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,uFAAuF;IACvF,cAAc,CAAC,EAAE,sBAAsB,GAAG,0BAA0B,CAAC;CACtE;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,4BAA4B,CAAC;IAC1C,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,kFAAkF;IAClF,cAAc,CAAC,EAAE,IAAI,CACnB,wBAAwB,EACxB,WAAW,GAAG,cAAc,CAC7B,EAAE,CAAC;CACL;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,4BAA4B,EACzC,KAAK,EAAE,wBAAwB,GAC9B,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC,GAAG;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAUA;AAUD,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAkFlC"}
1
+ {"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../src/publication.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,QAAQ,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+GAA+G;IAC/G,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,uFAAuF;IACvF,cAAc,CAAC,EAAE,sBAAsB,GAAG,0BAA0B,CAAC;CACtE;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,4BAA4B,CAAC;IAC1C,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACpC;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,4BAA4B,EACzC,KAAK,EAAE,wBAAwB,GAC9B,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC,GAAG;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAUA;AAUD,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CA2ElC"}
@@ -1,4 +1,6 @@
1
1
  import { findingEntry } from "./value.js";
2
+ import { isGitHubCloudHost } from "./git-remote.js";
3
+ import { isRecord } from "./record.js";
2
4
  import { loadContractWithScanDirectory, } from "./contract.js";
3
5
  import { bundledPluginRoot } from "./runtime.js";
4
6
  import { CodexSecurityError } from "./errors.js";
@@ -51,11 +53,6 @@ export async function prepareScanPublication(scanDirectory, options) {
51
53
  return {
52
54
  scanId,
53
55
  scanDirectory: canonicalScanDirectory,
54
- ...(classification === undefined && options.findingIds === undefined
55
- ? {}
56
- : {
57
- sourceFindings: contract.findings.findings.map(({ findingId, occurrenceId }) => ({ findingId, occurrenceId })),
58
- }),
59
56
  destination: {
60
57
  type: options.destination,
61
58
  teamId: options.teamId,
@@ -93,12 +90,15 @@ function renderFindingDescription(contract, finding, uploadedAt, assessment) {
93
90
  if (finding.attackPath?.summary !== undefined) {
94
91
  lines.push("", "## Reproduction summary", "", finding.attackPath.summary);
95
92
  }
96
- const rootCause = finding.rootCause;
93
+ const rootCause = publicationRootCause(finding);
97
94
  if (typeof rootCause === "string") {
98
95
  lines.push("", "## Root cause", "", rootCause);
99
96
  }
100
- else if (rootCause !== undefined) {
101
- lines.push("", "## Root cause", "", rootCause.summary);
97
+ else if (rootCause !== undefined &&
98
+ (rootCause.summary !== undefined || rootCause.code !== undefined)) {
99
+ lines.push("", "## Root cause");
100
+ if (rootCause.summary !== undefined)
101
+ lines.push("", rootCause.summary);
102
102
  if (rootCause.code !== undefined) {
103
103
  lines.push("", fencedCode(rootCause.code, rootCause.language));
104
104
  }
@@ -120,10 +120,11 @@ function renderFindingDescription(contract, finding, uploadedAt, assessment) {
120
120
  lines.push(`**Method:** ${validation.method}`, "");
121
121
  lines.push(...limits.map((limit) => `- ${limit}`));
122
122
  }
123
- if (finding.codeEvidence !== undefined && finding.codeEvidence.length > 0) {
123
+ const codeEvidence = publicationCodeEvidence(finding);
124
+ if (codeEvidence.length > 0) {
124
125
  lines.push("", "## Source-code evidence");
125
- for (const evidence of finding.codeEvidence) {
126
- lines.push("", ...renderCodeEvidence(scan.target, evidence));
126
+ for (const [index, evidence] of codeEvidence.entries()) {
127
+ lines.push("", ...renderCodeEvidence(scan.target, evidence, index));
127
128
  }
128
129
  }
129
130
  lines.push("", "---", "", "## Codex Security finding", "", `**Scan ID:** ${scan.id}`, `**Finding ID:** ${finding.findingId}`, `**Occurrence ID:** ${finding.occurrenceId}`, `**Fingerprint:** ${finding.fingerprints.primary}`, `**Severity:** ${finding.severity.level.toUpperCase()}`, `**Confidence:** ${finding.confidence.level.toUpperCase()}`, ...(finding.taxonomy.cwe.length === 0
@@ -165,23 +166,134 @@ function renderLocation(target, location) {
165
166
  ? ""
166
167
  : `-${location.endLine}`}`;
167
168
  const sourceUrl = immutableSourceUrl(target, location);
168
- return `- **${role}:** ${sourceUrl === undefined ? `\`${label}\`` : `[\`${label}\`](${sourceUrl})`}`;
169
+ const formattedLabel = inlineCode(label);
170
+ return `- **${role}:** ${sourceUrl === undefined ? formattedLabel : `[${formattedLabel}](${sourceUrl})`}`;
169
171
  }
170
- function renderCodeEvidence(target, evidence) {
171
- return [
172
- `### ${evidence.label}`,
173
- "",
174
- renderLocation(target, evidence),
175
- "",
176
- fencedCode(evidence.code, evidence.language),
177
- "",
178
- evidence.explanation,
179
- ];
172
+ function renderCodeEvidence(target, evidence, index) {
173
+ const lines = [`### ${evidence.label ?? `Code evidence ${index + 1}`}`, ""];
174
+ if (typeof evidence["location"] === "string") {
175
+ lines.push(`- **${evidence.role === undefined ? "Location" : humanizeRole(evidence.role)}:** ${inlineCode(evidence["location"])}`, "");
176
+ }
177
+ else if (evidence.path !== undefined) {
178
+ lines.push(evidence.startLine === undefined
179
+ ? `- **${evidence.role === undefined ? "Location" : humanizeRole(evidence.role)}:** ${inlineCode(evidence.path)}`
180
+ : renderLocation(target, {
181
+ ...evidence,
182
+ path: evidence.path,
183
+ startLine: evidence.startLine,
184
+ }), "");
185
+ }
186
+ lines.push(fencedCode(evidence.code, evidence.language));
187
+ if (evidence.explanation !== undefined)
188
+ lines.push("", evidence.explanation);
189
+ return lines;
190
+ }
191
+ function publicationRootCause(finding) {
192
+ const canonical = finding.rootCause;
193
+ const legacy = finding.root_cause;
194
+ if (canonical === undefined)
195
+ return legacy ?? undefined;
196
+ if (legacy === undefined || legacy === null)
197
+ return canonical;
198
+ const details = [canonical, legacy].map((detail) => typeof detail === "string" ? { summary: detail } : detail);
199
+ const summary = details.find((detail) => detail.summary?.trim())?.summary;
200
+ const code = details.find((detail) => detail.code?.trim())?.code;
201
+ const language = details.find((detail) => detail.code === code && detail.language?.trim())?.language;
202
+ return summary === undefined && code === undefined
203
+ ? undefined
204
+ : { summary, code, language };
205
+ }
206
+ function publicationCodeEvidence(finding) {
207
+ const evidence = (finding.codeEvidence ?? []).map((item) => typeof item["location"] === "string" || isRecord(item["location"])
208
+ ? publicationEvidenceEntry(item, item.code)
209
+ : item);
210
+ const ids = new Set(evidence.filter((item) => item.code.trim()).map((item) => item.id));
211
+ for (const item of finding.code_evidence ?? []) {
212
+ if (ids.has(item.id))
213
+ continue;
214
+ if (item.code.trim())
215
+ ids.add(item.id);
216
+ evidence.push(publicationEvidenceEntry(item, item.code));
217
+ }
218
+ const snippets = new Set(evidence.map((item) => JSON.stringify([item.id ?? "", item.code])));
219
+ const attackPath = finding.attackPath;
220
+ for (const section of [
221
+ finding.rootCause,
222
+ finding.root_cause,
223
+ finding.validation,
224
+ attackPath,
225
+ attackPath?.dataFlow,
226
+ attackPath?.["dataflow"],
227
+ attackPath?.data_flow,
228
+ attackPath?.reachability,
229
+ ]) {
230
+ if (!isRecord(section))
231
+ continue;
232
+ for (const key of ["codeEvidence", "code_evidence"]) {
233
+ const embedded = section[key];
234
+ if (!Array.isArray(embedded))
235
+ continue;
236
+ for (const item of embedded) {
237
+ if (!isRecord(item))
238
+ continue;
239
+ const code = item["code"];
240
+ if (typeof code !== "string" || !code.trim())
241
+ continue;
242
+ const identity = JSON.stringify([item["id"] ?? "", code]);
243
+ if (snippets.has(identity))
244
+ continue;
245
+ snippets.add(identity);
246
+ evidence.push(publicationEvidenceEntry(item, code));
247
+ }
248
+ }
249
+ }
250
+ return evidence;
251
+ }
252
+ function publicationEvidenceEntry(item, code) {
253
+ const entry = { code };
254
+ for (const key of [
255
+ "id",
256
+ "label",
257
+ "language",
258
+ "role",
259
+ "explanation",
260
+ ]) {
261
+ const value = item[key];
262
+ if (typeof value === "string" && value.length > 0)
263
+ entry[key] = value;
264
+ }
265
+ if (typeof item["location"] === "string") {
266
+ const label = item["location"].trim().replace(/\s+/g, " ");
267
+ if (label)
268
+ entry["location"] = label;
269
+ return entry;
270
+ }
271
+ const location = isRecord(item["location"]) ? item["location"] : item;
272
+ const path = location["path"];
273
+ if (typeof path === "string" && path.length > 0)
274
+ entry.path = path;
275
+ const start = location["startLine"];
276
+ if (typeof start === "number" && Number.isInteger(start) && start > 0) {
277
+ entry.startLine = start;
278
+ const end = location["endLine"];
279
+ if (typeof end === "number" && Number.isInteger(end) && end >= start)
280
+ entry.endLine = end;
281
+ }
282
+ return entry;
180
283
  }
181
284
  function humanizeRole(role) {
182
285
  const words = role.replaceAll("_", " ");
183
286
  return `${words.slice(0, 1).toUpperCase()}${words.slice(1)}`;
184
287
  }
288
+ function inlineCode(label) {
289
+ let fenceLength = 1;
290
+ for (const match of label.matchAll(/`+/g)) {
291
+ fenceLength = Math.max(fenceLength, match[0].length + 1);
292
+ }
293
+ const fence = "`".repeat(fenceLength);
294
+ const padding = label.startsWith("`") || label.endsWith("`") ? " " : "";
295
+ return `${fence}${padding}${label}${padding}${fence}`;
296
+ }
185
297
  function fencedCode(code, language) {
186
298
  let fenceLength = 3;
187
299
  for (const match of code.matchAll(/`+/g)) {
@@ -208,8 +320,7 @@ function immutableSourceUrl(target, location) {
208
320
  catch {
209
321
  return undefined;
210
322
  }
211
- if (remote.protocol !== "https:" ||
212
- (remote.hostname !== "github.com" && !remote.hostname.endsWith(".ghe.com"))) {
323
+ if (remote.protocol !== "https:" || !isGitHubCloudHost(remote.hostname)) {
213
324
  return undefined;
214
325
  }
215
326
  const repository = remote.pathname
@@ -1 +1 @@
1
- {"version":3,"file":"publication.js","sourceRoot":"","sources":["../src/publication.ts"],"names":[],"mappings":"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","sourcesContent":["import { findingEntry } from \"./value.js\";\nimport {\n loadContractWithScanDirectory,\n type LoadedContract,\n} from \"./contract.js\";\nimport type {\n Finding,\n FindingCodeEvidence,\n FindingLocation,\n ScanTargetRecord,\n SeverityLevel,\n} from \"./models.js\";\nimport { bundledPluginRoot } from \"./runtime.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport {\n severityClassificationSchema,\n validateSeverityClassification,\n type SeverityClassification,\n type SeverityAssessment,\n} from \"./classify-severity.js\";\nimport {\n readScanSeverityClassification,\n selectClassificationFindings,\n type ScanSeverityClassification,\n} from \"./classify-scan-severity.js\";\n\nexport interface LinearPublicationDestination {\n type: \"linear\";\n teamId: string;\n projectId?: string;\n}\n\nexport interface PrepareScanPublicationOptions {\n destination: \"linear\";\n teamId: string;\n projectId?: string;\n uploadedAt?: string;\n environment?: NodeJS.ProcessEnv;\n signal?: AbortSignal;\n expectedScanId?: string;\n /** Publish only these finding IDs from the supplied scan; dedupe representatives may belong to other scans. */\n findingIds?: readonly string[];\n /** Use this assessment; otherwise use the scan's saved classification when present. */\n classification?: SeverityClassification | ScanSeverityClassification;\n}\n\nexport interface PreparedPublicationIssue {\n findingId: string;\n occurrenceId: string;\n title: string;\n description: string;\n priority?: 1 | 2 | 3 | 4;\n}\n\nexport interface PreparedScanPublication {\n scanId: string;\n scanDirectory: string;\n destination: LinearPublicationDestination;\n issues: PreparedPublicationIssue[];\n /** Complete sealed membership, retained when only some findings become issues. */\n sourceFindings?: Pick<\n PreparedPublicationIssue,\n \"findingId\" | \"occurrenceId\"\n >[];\n}\n\nexport function linearPublicationArguments(\n destination: LinearPublicationDestination,\n issue: PreparedPublicationIssue,\n): Pick<PreparedPublicationIssue, \"title\" | \"description\" | \"priority\"> & {\n team: string;\n project?: string;\n} {\n return {\n team: destination.teamId,\n ...(destination.projectId === undefined\n ? {}\n : { project: destination.projectId }),\n title: issue.title,\n description: issue.description,\n ...(issue.priority === undefined ? {} : { priority: issue.priority }),\n };\n}\n\nconst LINEAR_PRIORITIES = {\n critical: 1,\n high: 2,\n medium: 3,\n low: 4,\n informational: undefined,\n} as const satisfies Record<SeverityLevel, 1 | 2 | 3 | 4 | undefined>;\n\nexport async function prepareScanPublication(\n scanDirectory: string,\n options: PrepareScanPublicationOptions,\n): Promise<PreparedScanPublication> {\n const { contract, scanDirectory: canonicalScanDirectory } =\n await loadContractWithScanDirectory(scanDirectory, {\n pluginRoot: await bundledPluginRoot(),\n ...(options.signal === undefined ? {} : { signal: options.signal }),\n expectedScanId: options.expectedScanId,\n });\n const uploadedAt = options.uploadedAt ?? new Date().toISOString();\n const scanId = contract.manifest.scan.id;\n let classification: SeverityClassification | undefined;\n if (options.classification !== undefined) {\n const { scanId: assessedScanId, ...assessment } =\n options.classification as ScanSeverityClassification;\n if (assessedScanId !== undefined && assessedScanId !== scanId) {\n throw new CodexSecurityError(\n \"Severity classification belongs to a different scan.\",\n );\n }\n classification = validateSeverityClassification(\n severityClassificationSchema.parse(assessment),\n contract.findings.findings,\n );\n } else {\n classification = await readScanSeverityClassification(\n canonicalScanDirectory,\n scanId,\n contract.findings.findings,\n options.signal,\n options.environment,\n );\n }\n const assessments = new Map(classification?.assessments.map(findingEntry));\n const selected = selectClassificationFindings(\n contract.findings.findings,\n options.findingIds ??\n classification?.assessments.map(({ findingId }) => findingId),\n );\n if (\n classification &&\n selected.some(({ findingId }) => !assessments.has(findingId))\n ) {\n throw new CodexSecurityError(\n \"Selected findings are missing from the severity classification. Classify the selection before publishing.\",\n );\n }\n\n return {\n scanId,\n scanDirectory: canonicalScanDirectory,\n ...(classification === undefined && options.findingIds === undefined\n ? {}\n : {\n sourceFindings: contract.findings.findings.map(\n ({ findingId, occurrenceId }) => ({ findingId, occurrenceId }),\n ),\n }),\n destination: {\n type: options.destination,\n teamId: options.teamId,\n ...(options.projectId === undefined\n ? {}\n : { projectId: options.projectId }),\n },\n issues: selected.flatMap((finding) => {\n const assessment = assessments.get(finding.findingId);\n if (assessment?.decision === \"excluded\") return [];\n const level = assessment?.level ?? finding.severity.level;\n const priority = LINEAR_PRIORITIES[level];\n return {\n findingId: finding.findingId,\n occurrenceId: finding.occurrenceId,\n title: `[Codex Security][${level.toUpperCase()}] ${finding.title}`,\n description: renderFindingDescription(\n contract,\n finding,\n uploadedAt,\n assessment,\n ),\n ...(priority === undefined ? {} : { priority }),\n };\n }),\n };\n}\n\nfunction renderFindingDescription(\n contract: LoadedContract,\n finding: Finding,\n uploadedAt: string,\n assessment?: SeverityAssessment,\n): string {\n const { coverage } = contract;\n const { scan } = contract.manifest;\n const lines = [\"## Summary\", \"\", finding.summary];\n if (assessment?.source === \"rubric\") {\n lines.push(\n \"\",\n \"\",\n \"## Severity classification\",\n \"\",\n `**Assessed severity:** ${assessment.level}`,\n `**Rubric label:** ${assessment.rubricLabel}`,\n \"\",\n assessment.rationale,\n );\n if (assessment.confidence !== null)\n lines.push(\"\", `**Classification confidence:** ${assessment.confidence}`);\n if (assessment.reviewTrigger !== null)\n lines.push(\"\", `**Review trigger:** ${assessment.reviewTrigger}`);\n }\n\n if (finding.attackPath?.summary !== undefined) {\n lines.push(\"\", \"## Reproduction summary\", \"\", finding.attackPath.summary);\n }\n\n const rootCause = finding.rootCause;\n if (typeof rootCause === \"string\") {\n lines.push(\"\", \"## Root cause\", \"\", rootCause);\n } else if (rootCause !== undefined) {\n lines.push(\"\", \"## Root cause\", \"\", rootCause.summary);\n if (rootCause.code !== undefined) {\n lines.push(\"\", fencedCode(rootCause.code, rootCause.language));\n }\n }\n\n lines.push(\"\", \"## Remediation\", \"\", finding.remediation);\n\n const validation = finding.validation;\n const limits = [\n ...new Set([\n ...(validation?.limitations ?? []),\n ...(validation?.counterEvidence ?? []),\n ...(finding.attackPath?.limitations ?? []),\n ]),\n ];\n if (validation?.summary || validation?.method || limits.length > 0) {\n lines.push(\"\", \"## Validation\", \"\");\n if (validation?.summary) lines.push(validation.summary, \"\");\n if (validation?.method) lines.push(`**Method:** ${validation.method}`, \"\");\n lines.push(...limits.map((limit) => `- ${limit}`));\n }\n\n if (finding.codeEvidence !== undefined && finding.codeEvidence.length > 0) {\n lines.push(\"\", \"## Source-code evidence\");\n for (const evidence of finding.codeEvidence) {\n lines.push(\"\", ...renderCodeEvidence(scan.target, evidence));\n }\n }\n\n lines.push(\n \"\",\n \"---\",\n \"\",\n \"## Codex Security finding\",\n \"\",\n `**Scan ID:** ${scan.id}`,\n `**Finding ID:** ${finding.findingId}`,\n `**Occurrence ID:** ${finding.occurrenceId}`,\n `**Fingerprint:** ${finding.fingerprints.primary}`,\n `**Severity:** ${finding.severity.level.toUpperCase()}`,\n `**Confidence:** ${finding.confidence.level.toUpperCase()}`,\n ...(finding.taxonomy.cwe.length === 0\n ? []\n : [`**CWE:** ${finding.taxonomy.cwe.join(\", \")}`]),\n \"\",\n \"## Scanned code\",\n \"\",\n `**Repository:** ${scan.target.displayName}`,\n ...(scan.target.remote === undefined\n ? []\n : [`**Remote:** ${scan.target.remote}`]),\n ...renderTargetIdentity(scan.target),\n `**Scanned scope:** ${scan.scope.includePaths.join(\", \") || \"entire repository\"}`,\n ...(scan.scope.excludePaths.length === 0\n ? []\n : [`**Excluded scope:** ${scan.scope.excludePaths.join(\", \")}`]),\n `**Coverage mode:** ${coverage.mode}`,\n `**Scan mode:** ${scanMode(coverage.mode)}`,\n `**Started:** ${scan.startedAt}`,\n `**Completed:** ${scan.completedAt}`,\n `**Uploaded:** ${uploadedAt}`,\n \"\",\n \"### Affected locations\",\n \"\",\n ...finding.locations.map((location) =>\n renderLocation(scan.target, location),\n ),\n );\n return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction renderTargetIdentity(target: ScanTargetRecord): string[] {\n const lines: string[] = [];\n if (target.revision !== undefined) {\n const label = target.kind === \"git_revision\" ? \"Revision\" : \"Base revision\";\n lines.push(`**${label}:** ${target.revision}`);\n }\n if (target.baseRevision !== undefined) {\n lines.push(`**Diff base revision:** ${target.baseRevision}`);\n }\n if (target.headRevision !== undefined) {\n lines.push(`**Diff head revision:** ${target.headRevision}`);\n }\n if (target.snapshotDigest !== undefined) {\n lines.push(`**Snapshot digest:** ${target.snapshotDigest}`);\n }\n return lines;\n}\n\nfunction scanMode(mode: LoadedContract[\"coverage\"][\"mode\"]): string {\n if (mode === \"deep_repository\") return \"deep\";\n if (mode === \"repository\") return \"standard\";\n return mode;\n}\n\nfunction renderLocation(\n target: ScanTargetRecord,\n location: FindingLocation,\n): string {\n const role =\n location.role === undefined ? \"Location\" : humanizeRole(location.role);\n const label = `${location.path}:${location.startLine}${\n location.endLine === undefined || location.endLine === location.startLine\n ? \"\"\n : `-${location.endLine}`\n }`;\n const sourceUrl = immutableSourceUrl(target, location);\n return `- **${role}:** ${sourceUrl === undefined ? `\\`${label}\\`` : `[\\`${label}\\`](${sourceUrl})`}`;\n}\n\nfunction renderCodeEvidence(\n target: ScanTargetRecord,\n evidence: FindingCodeEvidence,\n): string[] {\n return [\n `### ${evidence.label}`,\n \"\",\n renderLocation(target, evidence),\n \"\",\n fencedCode(evidence.code, evidence.language),\n \"\",\n evidence.explanation,\n ];\n}\n\nfunction humanizeRole(role: string): string {\n const words = role.replaceAll(\"_\", \" \");\n return `${words.slice(0, 1).toUpperCase()}${words.slice(1)}`;\n}\n\nfunction fencedCode(code: string, language?: string): string {\n let fenceLength = 3;\n for (const match of code.matchAll(/`+/g)) {\n fenceLength = Math.max(fenceLength, match[0].length + 1);\n }\n const fence = \"`\".repeat(fenceLength);\n const tag =\n language !== undefined && /^[A-Za-z0-9_+.-]+$/.test(language)\n ? language\n : \"\";\n return `${fence}${tag}\\n${code}\\n${fence}`;\n}\n\nfunction immutableSourceUrl(\n target: ScanTargetRecord,\n location: FindingLocation,\n): string | undefined {\n if (\n target.kind !== \"git_revision\" ||\n target.remote === undefined ||\n target.revision === undefined ||\n !/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/i.test(target.revision) ||\n !isSafeRepositoryPath(location.path)\n ) {\n return undefined;\n }\n\n let remote: URL;\n try {\n remote = new URL(target.remote);\n } catch {\n return undefined;\n }\n if (\n remote.protocol !== \"https:\" ||\n (remote.hostname !== \"github.com\" && !remote.hostname.endsWith(\".ghe.com\"))\n ) {\n return undefined;\n }\n\n const repository = remote.pathname\n .replace(/\\.git\\/?$/, \"\")\n .replace(/\\/$/, \"\");\n const path = location.path.split(\"/\").map(encodeURIComponent).join(\"/\");\n remote.pathname = `${repository}/blob/${target.revision}/${path}`;\n remote.hash = `L${location.startLine}${\n location.endLine === undefined || location.endLine === location.startLine\n ? \"\"\n : `-L${location.endLine}`\n }`;\n return remote.toString();\n}\n\nfunction isSafeRepositoryPath(path: string): boolean {\n if (\n path.includes(\"\\\\\") ||\n /^[A-Za-z]:/.test(path) ||\n /[\\u0000-\\u001f\\u007f]/.test(path)\n ) {\n return false;\n }\n\n return path\n .split(\"/\")\n .every(\n (segment) =>\n segment.length > 0 &&\n segment !== \".\" &&\n segment !== \"..\" &&\n !/%(?:2e|2f|5c)/i.test(segment),\n );\n}\n"]}
1
+ {"version":3,"file":"publication.js","sourceRoot":"","sources":["../src/publication.ts"],"names":[],"mappings":"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","sourcesContent":["import { findingEntry } from \"./value.js\";\nimport { isGitHubCloudHost } from \"./git-remote.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n loadContractWithScanDirectory,\n type LoadedContract,\n} from \"./contract.js\";\nimport type {\n Finding,\n FindingCodeEvidence,\n FindingLocation,\n ScanTargetRecord,\n SeverityLevel,\n} from \"./models.js\";\nimport { bundledPluginRoot } from \"./runtime.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport {\n severityClassificationSchema,\n validateSeverityClassification,\n type SeverityClassification,\n type SeverityAssessment,\n} from \"./classify-severity.js\";\nimport {\n readScanSeverityClassification,\n selectClassificationFindings,\n type ScanSeverityClassification,\n} from \"./classify-scan-severity.js\";\n\nexport interface LinearPublicationDestination {\n type: \"linear\";\n teamId: string;\n projectId?: string;\n}\n\nexport interface PrepareScanPublicationOptions {\n destination: \"linear\";\n teamId: string;\n projectId?: string;\n uploadedAt?: string;\n environment?: NodeJS.ProcessEnv;\n signal?: AbortSignal;\n expectedScanId?: string;\n /** Publish only these finding IDs from the supplied scan; dedupe representatives may belong to other scans. */\n findingIds?: readonly string[];\n /** Use this assessment; otherwise use the scan's saved classification when present. */\n classification?: SeverityClassification | ScanSeverityClassification;\n}\n\nexport interface PreparedPublicationIssue {\n findingId: string;\n occurrenceId: string;\n title: string;\n description: string;\n priority?: 1 | 2 | 3 | 4;\n}\n\nexport interface PreparedScanPublication {\n scanId: string;\n scanDirectory: string;\n destination: LinearPublicationDestination;\n issues: PreparedPublicationIssue[];\n}\n\nexport function linearPublicationArguments(\n destination: LinearPublicationDestination,\n issue: PreparedPublicationIssue,\n): Pick<PreparedPublicationIssue, \"title\" | \"description\" | \"priority\"> & {\n team: string;\n project?: string;\n} {\n return {\n team: destination.teamId,\n ...(destination.projectId === undefined\n ? {}\n : { project: destination.projectId }),\n title: issue.title,\n description: issue.description,\n ...(issue.priority === undefined ? {} : { priority: issue.priority }),\n };\n}\n\nconst LINEAR_PRIORITIES = {\n critical: 1,\n high: 2,\n medium: 3,\n low: 4,\n informational: undefined,\n} as const satisfies Record<SeverityLevel, 1 | 2 | 3 | 4 | undefined>;\n\nexport async function prepareScanPublication(\n scanDirectory: string,\n options: PrepareScanPublicationOptions,\n): Promise<PreparedScanPublication> {\n const { contract, scanDirectory: canonicalScanDirectory } =\n await loadContractWithScanDirectory(scanDirectory, {\n pluginRoot: await bundledPluginRoot(),\n ...(options.signal === undefined ? {} : { signal: options.signal }),\n expectedScanId: options.expectedScanId,\n });\n const uploadedAt = options.uploadedAt ?? new Date().toISOString();\n const scanId = contract.manifest.scan.id;\n let classification: SeverityClassification | undefined;\n if (options.classification !== undefined) {\n const { scanId: assessedScanId, ...assessment } =\n options.classification as ScanSeverityClassification;\n if (assessedScanId !== undefined && assessedScanId !== scanId) {\n throw new CodexSecurityError(\n \"Severity classification belongs to a different scan.\",\n );\n }\n classification = validateSeverityClassification(\n severityClassificationSchema.parse(assessment),\n contract.findings.findings,\n );\n } else {\n classification = await readScanSeverityClassification(\n canonicalScanDirectory,\n scanId,\n contract.findings.findings,\n options.signal,\n options.environment,\n );\n }\n const assessments = new Map(classification?.assessments.map(findingEntry));\n const selected = selectClassificationFindings(\n contract.findings.findings,\n options.findingIds ??\n classification?.assessments.map(({ findingId }) => findingId),\n );\n if (\n classification &&\n selected.some(({ findingId }) => !assessments.has(findingId))\n ) {\n throw new CodexSecurityError(\n \"Selected findings are missing from the severity classification. Classify the selection before publishing.\",\n );\n }\n\n return {\n scanId,\n scanDirectory: canonicalScanDirectory,\n destination: {\n type: options.destination,\n teamId: options.teamId,\n ...(options.projectId === undefined\n ? {}\n : { projectId: options.projectId }),\n },\n issues: selected.flatMap((finding) => {\n const assessment = assessments.get(finding.findingId);\n if (assessment?.decision === \"excluded\") return [];\n const level = assessment?.level ?? finding.severity.level;\n const priority = LINEAR_PRIORITIES[level];\n return {\n findingId: finding.findingId,\n occurrenceId: finding.occurrenceId,\n title: `[Codex Security][${level.toUpperCase()}] ${finding.title}`,\n description: renderFindingDescription(\n contract,\n finding,\n uploadedAt,\n assessment,\n ),\n ...(priority === undefined ? {} : { priority }),\n };\n }),\n };\n}\n\nfunction renderFindingDescription(\n contract: LoadedContract,\n finding: Finding,\n uploadedAt: string,\n assessment?: SeverityAssessment,\n): string {\n const { coverage } = contract;\n const { scan } = contract.manifest;\n const lines = [\"## Summary\", \"\", finding.summary];\n if (assessment?.source === \"rubric\") {\n lines.push(\n \"\",\n \"\",\n \"## Severity classification\",\n \"\",\n `**Assessed severity:** ${assessment.level}`,\n `**Rubric label:** ${assessment.rubricLabel}`,\n \"\",\n assessment.rationale,\n );\n if (assessment.confidence !== null)\n lines.push(\"\", `**Classification confidence:** ${assessment.confidence}`);\n if (assessment.reviewTrigger !== null)\n lines.push(\"\", `**Review trigger:** ${assessment.reviewTrigger}`);\n }\n\n if (finding.attackPath?.summary !== undefined) {\n lines.push(\"\", \"## Reproduction summary\", \"\", finding.attackPath.summary);\n }\n\n const rootCause = publicationRootCause(finding);\n if (typeof rootCause === \"string\") {\n lines.push(\"\", \"## Root cause\", \"\", rootCause);\n } else if (\n rootCause !== undefined &&\n (rootCause.summary !== undefined || rootCause.code !== undefined)\n ) {\n lines.push(\"\", \"## Root cause\");\n if (rootCause.summary !== undefined) lines.push(\"\", rootCause.summary);\n if (rootCause.code !== undefined) {\n lines.push(\"\", fencedCode(rootCause.code, rootCause.language));\n }\n }\n\n lines.push(\"\", \"## Remediation\", \"\", finding.remediation);\n\n const validation = finding.validation;\n const limits = [\n ...new Set([\n ...(validation?.limitations ?? []),\n ...(validation?.counterEvidence ?? []),\n ...(finding.attackPath?.limitations ?? []),\n ]),\n ];\n if (validation?.summary || validation?.method || limits.length > 0) {\n lines.push(\"\", \"## Validation\", \"\");\n if (validation?.summary) lines.push(validation.summary, \"\");\n if (validation?.method) lines.push(`**Method:** ${validation.method}`, \"\");\n lines.push(...limits.map((limit) => `- ${limit}`));\n }\n\n const codeEvidence = publicationCodeEvidence(finding);\n if (codeEvidence.length > 0) {\n lines.push(\"\", \"## Source-code evidence\");\n for (const [index, evidence] of codeEvidence.entries()) {\n lines.push(\"\", ...renderCodeEvidence(scan.target, evidence, index));\n }\n }\n\n lines.push(\n \"\",\n \"---\",\n \"\",\n \"## Codex Security finding\",\n \"\",\n `**Scan ID:** ${scan.id}`,\n `**Finding ID:** ${finding.findingId}`,\n `**Occurrence ID:** ${finding.occurrenceId}`,\n `**Fingerprint:** ${finding.fingerprints.primary}`,\n `**Severity:** ${finding.severity.level.toUpperCase()}`,\n `**Confidence:** ${finding.confidence.level.toUpperCase()}`,\n ...(finding.taxonomy.cwe.length === 0\n ? []\n : [`**CWE:** ${finding.taxonomy.cwe.join(\", \")}`]),\n \"\",\n \"## Scanned code\",\n \"\",\n `**Repository:** ${scan.target.displayName}`,\n ...(scan.target.remote === undefined\n ? []\n : [`**Remote:** ${scan.target.remote}`]),\n ...renderTargetIdentity(scan.target),\n `**Scanned scope:** ${scan.scope.includePaths.join(\", \") || \"entire repository\"}`,\n ...(scan.scope.excludePaths.length === 0\n ? []\n : [`**Excluded scope:** ${scan.scope.excludePaths.join(\", \")}`]),\n `**Coverage mode:** ${coverage.mode}`,\n `**Scan mode:** ${scanMode(coverage.mode)}`,\n `**Started:** ${scan.startedAt}`,\n `**Completed:** ${scan.completedAt}`,\n `**Uploaded:** ${uploadedAt}`,\n \"\",\n \"### Affected locations\",\n \"\",\n ...finding.locations.map((location) =>\n renderLocation(scan.target, location),\n ),\n );\n return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction renderTargetIdentity(target: ScanTargetRecord): string[] {\n const lines: string[] = [];\n if (target.revision !== undefined) {\n const label = target.kind === \"git_revision\" ? \"Revision\" : \"Base revision\";\n lines.push(`**${label}:** ${target.revision}`);\n }\n if (target.baseRevision !== undefined) {\n lines.push(`**Diff base revision:** ${target.baseRevision}`);\n }\n if (target.headRevision !== undefined) {\n lines.push(`**Diff head revision:** ${target.headRevision}`);\n }\n if (target.snapshotDigest !== undefined) {\n lines.push(`**Snapshot digest:** ${target.snapshotDigest}`);\n }\n return lines;\n}\n\nfunction scanMode(mode: LoadedContract[\"coverage\"][\"mode\"]): string {\n if (mode === \"deep_repository\") return \"deep\";\n if (mode === \"repository\") return \"standard\";\n return mode;\n}\n\nfunction renderLocation(\n target: ScanTargetRecord,\n location: FindingLocation,\n): string {\n const role =\n location.role === undefined ? \"Location\" : humanizeRole(location.role);\n const label = `${location.path}:${location.startLine}${\n location.endLine === undefined || location.endLine === location.startLine\n ? \"\"\n : `-${location.endLine}`\n }`;\n const sourceUrl = immutableSourceUrl(target, location);\n const formattedLabel = inlineCode(label);\n return `- **${role}:** ${sourceUrl === undefined ? formattedLabel : `[${formattedLabel}](${sourceUrl})`}`;\n}\n\nfunction renderCodeEvidence(\n target: ScanTargetRecord,\n evidence: PublicationCodeEvidence,\n index: number,\n): string[] {\n const lines = [`### ${evidence.label ?? `Code evidence ${index + 1}`}`, \"\"];\n if (typeof evidence[\"location\"] === \"string\") {\n lines.push(\n `- **${evidence.role === undefined ? \"Location\" : humanizeRole(evidence.role)}:** ${inlineCode(evidence[\"location\"])}`,\n \"\",\n );\n } else if (evidence.path !== undefined) {\n lines.push(\n evidence.startLine === undefined\n ? `- **${evidence.role === undefined ? \"Location\" : humanizeRole(evidence.role)}:** ${inlineCode(evidence.path)}`\n : renderLocation(target, {\n ...evidence,\n path: evidence.path,\n startLine: evidence.startLine,\n }),\n \"\",\n );\n }\n lines.push(fencedCode(evidence.code, evidence.language));\n if (evidence.explanation !== undefined) lines.push(\"\", evidence.explanation);\n return lines;\n}\n\nfunction publicationRootCause(finding: Finding) {\n const canonical = finding.rootCause;\n const legacy = finding.root_cause;\n if (canonical === undefined) return legacy ?? undefined;\n if (legacy === undefined || legacy === null) return canonical;\n const details: Array<{ summary?: string; code?: string; language?: string }> =\n [canonical, legacy].map((detail) =>\n typeof detail === \"string\" ? { summary: detail } : detail,\n );\n const summary = details.find((detail) => detail.summary?.trim())?.summary;\n const code = details.find((detail) => detail.code?.trim())?.code;\n const language = details.find(\n (detail) => detail.code === code && detail.language?.trim(),\n )?.language;\n return summary === undefined && code === undefined\n ? undefined\n : { summary, code, language };\n}\n\ntype PublicationCodeEvidence = Partial<FindingCodeEvidence> &\n Pick<FindingCodeEvidence, \"code\">;\n\nfunction publicationCodeEvidence(finding: Finding): PublicationCodeEvidence[] {\n const evidence: PublicationCodeEvidence[] = (finding.codeEvidence ?? []).map(\n (item) =>\n typeof item[\"location\"] === \"string\" || isRecord(item[\"location\"])\n ? publicationEvidenceEntry(item, item.code)\n : item,\n );\n const ids = new Set(\n evidence.filter((item) => item.code.trim()).map((item) => item.id),\n );\n for (const item of finding.code_evidence ?? []) {\n if (ids.has(item.id)) continue;\n if (item.code.trim()) ids.add(item.id);\n evidence.push(publicationEvidenceEntry(item, item.code));\n }\n const snippets = new Set(\n evidence.map((item) => JSON.stringify([item.id ?? \"\", item.code])),\n );\n const attackPath = finding.attackPath;\n for (const section of [\n finding.rootCause,\n finding.root_cause,\n finding.validation,\n attackPath,\n attackPath?.dataFlow,\n attackPath?.[\"dataflow\"],\n attackPath?.data_flow,\n attackPath?.reachability,\n ]) {\n if (!isRecord(section)) continue;\n for (const key of [\"codeEvidence\", \"code_evidence\"]) {\n const embedded = section[key];\n if (!Array.isArray(embedded)) continue;\n for (const item of embedded) {\n if (!isRecord(item)) continue;\n const code = item[\"code\"];\n if (typeof code !== \"string\" || !code.trim()) continue;\n const identity = JSON.stringify([item[\"id\"] ?? \"\", code]);\n if (snippets.has(identity)) continue;\n snippets.add(identity);\n evidence.push(publicationEvidenceEntry(item, code));\n }\n }\n }\n return evidence;\n}\n\nfunction publicationEvidenceEntry(\n item: Record<string, unknown>,\n code: string,\n): PublicationCodeEvidence {\n const entry: PublicationCodeEvidence = { code };\n for (const key of [\n \"id\",\n \"label\",\n \"language\",\n \"role\",\n \"explanation\",\n ] as const) {\n const value = item[key];\n if (typeof value === \"string\" && value.length > 0) entry[key] = value;\n }\n if (typeof item[\"location\"] === \"string\") {\n const label = item[\"location\"].trim().replace(/\\s+/g, \" \");\n if (label) entry[\"location\"] = label;\n return entry;\n }\n const location = isRecord(item[\"location\"]) ? item[\"location\"] : item;\n const path = location[\"path\"];\n if (typeof path === \"string\" && path.length > 0) entry.path = path;\n const start = location[\"startLine\"];\n if (typeof start === \"number\" && Number.isInteger(start) && start > 0) {\n entry.startLine = start;\n const end = location[\"endLine\"];\n if (typeof end === \"number\" && Number.isInteger(end) && end >= start)\n entry.endLine = end;\n }\n return entry;\n}\n\nfunction humanizeRole(role: string): string {\n const words = role.replaceAll(\"_\", \" \");\n return `${words.slice(0, 1).toUpperCase()}${words.slice(1)}`;\n}\n\nfunction inlineCode(label: string): string {\n let fenceLength = 1;\n for (const match of label.matchAll(/`+/g)) {\n fenceLength = Math.max(fenceLength, match[0].length + 1);\n }\n const fence = \"`\".repeat(fenceLength);\n const padding = label.startsWith(\"`\") || label.endsWith(\"`\") ? \" \" : \"\";\n return `${fence}${padding}${label}${padding}${fence}`;\n}\n\nfunction fencedCode(code: string, language?: string): string {\n let fenceLength = 3;\n for (const match of code.matchAll(/`+/g)) {\n fenceLength = Math.max(fenceLength, match[0].length + 1);\n }\n const fence = \"`\".repeat(fenceLength);\n const tag =\n language !== undefined && /^[A-Za-z0-9_+.-]+$/.test(language)\n ? language\n : \"\";\n return `${fence}${tag}\\n${code}\\n${fence}`;\n}\n\nfunction immutableSourceUrl(\n target: ScanTargetRecord,\n location: FindingLocation,\n): string | undefined {\n if (\n target.kind !== \"git_revision\" ||\n target.remote === undefined ||\n target.revision === undefined ||\n !/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/i.test(target.revision) ||\n !isSafeRepositoryPath(location.path)\n ) {\n return undefined;\n }\n\n let remote: URL;\n try {\n remote = new URL(target.remote);\n } catch {\n return undefined;\n }\n if (remote.protocol !== \"https:\" || !isGitHubCloudHost(remote.hostname)) {\n return undefined;\n }\n\n const repository = remote.pathname\n .replace(/\\.git\\/?$/, \"\")\n .replace(/\\/$/, \"\");\n const path = location.path.split(\"/\").map(encodeURIComponent).join(\"/\");\n remote.pathname = `${repository}/blob/${target.revision}/${path}`;\n remote.hash = `L${location.startLine}${\n location.endLine === undefined || location.endLine === location.startLine\n ? \"\"\n : `-L${location.endLine}`\n }`;\n return remote.toString();\n}\n\nfunction isSafeRepositoryPath(path: string): boolean {\n if (\n path.includes(\"\\\\\") ||\n /^[A-Za-z]:/.test(path) ||\n /[\\u0000-\\u001f\\u007f]/.test(path)\n ) {\n return false;\n }\n\n return path\n .split(\"/\")\n .every(\n (segment) =>\n segment.length > 0 &&\n segment !== \".\" &&\n segment !== \"..\" &&\n !/%(?:2e|2f|5c)/i.test(segment),\n );\n}\n"]}