@proofline/sdk 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,3774 @@
1
+ /**
2
+ * This file was auto-generated by openapi-typescript.
3
+ * Do not make direct changes to the file.
4
+ */
5
+
6
+ export interface paths {
7
+ "/api/v1/organizations/{org_id}/agent-sessions/{session_id}": {
8
+ parameters: {
9
+ query?: never;
10
+ header?: never;
11
+ path?: never;
12
+ cookie?: never;
13
+ };
14
+ /**
15
+ * Get a coding-agent session
16
+ * @description Returns a coding-agent session's latest status, its vendor link, its untrusted vendor summary and the pull request GitHub confirmed it opened in the target repository.
17
+ */
18
+ get: operations["get_agent_session"];
19
+ put?: never;
20
+ post?: never;
21
+ delete?: never;
22
+ options?: never;
23
+ head?: never;
24
+ patch?: never;
25
+ trace?: never;
26
+ };
27
+ "/api/v1/organizations/{org_id}/exports/{dataset}": {
28
+ parameters: {
29
+ query?: never;
30
+ header?: never;
31
+ path?: never;
32
+ cookie?: never;
33
+ };
34
+ /**
35
+ * Export review metadata
36
+ * @description Returns one page of a version-1 export dataset (`reviews`, `finding_outcomes`, `finding_validations`, `spend` or `findings`) for an RFC3339 window of at most 31 days, as NDJSON by default or CSV. Rows respect the token's repository restriction.
37
+ */
38
+ get: operations["export_reviews"];
39
+ put?: never;
40
+ post?: never;
41
+ delete?: never;
42
+ options?: never;
43
+ head?: never;
44
+ patch?: never;
45
+ trace?: never;
46
+ };
47
+ "/api/v1/organizations/{org_id}/findings/{finding_id}": {
48
+ parameters: {
49
+ query?: never;
50
+ header?: never;
51
+ path?: never;
52
+ cookie?: never;
53
+ };
54
+ /**
55
+ * Get a finding
56
+ * @description Returns one finding with its evidence references, validation state and causal graph.
57
+ */
58
+ get: operations["get_finding"];
59
+ put?: never;
60
+ post?: never;
61
+ delete?: never;
62
+ options?: never;
63
+ head?: never;
64
+ patch?: never;
65
+ trace?: never;
66
+ };
67
+ "/api/v1/organizations/{org_id}/findings/{finding_id}/agent-session-prompt": {
68
+ parameters: {
69
+ query?: never;
70
+ header?: never;
71
+ path?: never;
72
+ cookie?: never;
73
+ };
74
+ /**
75
+ * Preview a coding-agent session
76
+ * @description Returns the exact prompt and target a coding-agent session on this pull request finding would send, with every protected value withheld, and the prompt digest a start names. Requires access to every repository in the review.
77
+ */
78
+ get: operations["get_agent_session_prompt"];
79
+ put?: never;
80
+ post?: never;
81
+ delete?: never;
82
+ options?: never;
83
+ head?: never;
84
+ patch?: never;
85
+ trace?: never;
86
+ };
87
+ "/api/v1/organizations/{org_id}/findings/{finding_id}/agent-sessions": {
88
+ parameters: {
89
+ query?: never;
90
+ header?: never;
91
+ path?: never;
92
+ cookie?: never;
93
+ };
94
+ get?: never;
95
+ put?: never;
96
+ /**
97
+ * Start a coding-agent session
98
+ * @description Starts one Cursor Cloud Agents or Devin session on the finding's reviewed pull request through an administrator's vendor connection, with the prompt whose digest the request names. Only a personal token or a browser session may start one, and it requires live GitHub write access to the repository. A repeated request starts another session, up to 3 per finding at one commit.
99
+ */
100
+ post: operations["start_agent_session"];
101
+ delete?: never;
102
+ options?: never;
103
+ head?: never;
104
+ patch?: never;
105
+ trace?: never;
106
+ };
107
+ "/api/v1/organizations/{org_id}/findings/{finding_id}/fix-prompt": {
108
+ parameters: {
109
+ query?: never;
110
+ header?: never;
111
+ path?: never;
112
+ cookie?: never;
113
+ };
114
+ /**
115
+ * Get a finding's fix prompt
116
+ * @description Returns a bounded untrusted prompt for a recorded pull request finding, or an explicit refusal. Requires access to every repository in the review. Each code reference retains its recorded commit; private evidence and diagnostics are omitted.
117
+ */
118
+ get: operations["get_finding_fix_prompt"];
119
+ put?: never;
120
+ post?: never;
121
+ delete?: never;
122
+ options?: never;
123
+ head?: never;
124
+ patch?: never;
125
+ trace?: never;
126
+ };
127
+ "/api/v1/organizations/{org_id}/repositories/{repo_id}/commit-reviews": {
128
+ parameters: {
129
+ query?: never;
130
+ header?: never;
131
+ path?: never;
132
+ cookie?: never;
133
+ };
134
+ get?: never;
135
+ put?: never;
136
+ /**
137
+ * Review pushed commits
138
+ * @description Reviews the change from an exact base commit to an exact head commit, both of which GitHub has in the repository, and returns those commits' review when one exists. The base must be an ancestor of the head. The review reads only those two commits, and is never posted to a pull request. Requires live GitHub read access; the same commits always return the same review.
139
+ */
140
+ post: operations["request_commit_review"];
141
+ delete?: never;
142
+ options?: never;
143
+ head?: never;
144
+ patch?: never;
145
+ trace?: never;
146
+ };
147
+ "/api/v1/organizations/{org_id}/repositories/{repo_id}/patch-reviews": {
148
+ parameters: {
149
+ query?: never;
150
+ header?: never;
151
+ path?: never;
152
+ cookie?: never;
153
+ };
154
+ get?: never;
155
+ put?: never;
156
+ /**
157
+ * Review local changes
158
+ * @description Reviews a unified diff against a commit GitHub has in the repository, and returns that patch's review when one exists. The review reads only that commit and the patch, and is never posted to a pull request. Requires live GitHub read access; the same patch on the same base always returns the same review.
159
+ */
160
+ post: operations["request_patch_review"];
161
+ delete?: never;
162
+ options?: never;
163
+ head?: never;
164
+ patch?: never;
165
+ trace?: never;
166
+ };
167
+ "/api/v1/organizations/{org_id}/repositories/{repo_id}/pull-requests/{number}/review": {
168
+ parameters: {
169
+ query?: never;
170
+ header?: never;
171
+ path?: never;
172
+ cookie?: never;
173
+ };
174
+ get?: never;
175
+ put?: never;
176
+ /**
177
+ * Request a pull request review
178
+ * @description Returns the active or result-bearing review at the pull request's live head, or creates a withheld one. The `FULL` mode creates a new review of the whole change unless one is pending or running. Requires live GitHub write access; a repeated request can create another review, so clients make one attempt.
179
+ */
180
+ post: operations["request_review"];
181
+ delete?: never;
182
+ options?: never;
183
+ head?: never;
184
+ patch?: never;
185
+ trace?: never;
186
+ };
187
+ "/api/v1/organizations/{org_id}/repositories/{repo_id}/review-guidance": {
188
+ parameters: {
189
+ query?: never;
190
+ header?: never;
191
+ path?: never;
192
+ cookie?: never;
193
+ };
194
+ /**
195
+ * Get repository review guidance
196
+ * @description Returns the review guidance configured for a repository, for tools and coding agents that read it before writing code.
197
+ */
198
+ get: operations["get_review_guidance"];
199
+ put?: never;
200
+ post?: never;
201
+ delete?: never;
202
+ options?: never;
203
+ head?: never;
204
+ patch?: never;
205
+ trace?: never;
206
+ };
207
+ "/api/v1/organizations/{org_id}/repository-names": {
208
+ parameters: {
209
+ query?: never;
210
+ header?: never;
211
+ path?: never;
212
+ cookie?: never;
213
+ };
214
+ /**
215
+ * List repository names
216
+ * @description Returns the ID and full name of each connected repository inside the token's repository restriction, including repositories with no review, so a client can resolve `owner/name` to an ID.
217
+ */
218
+ get: operations["list_repositories"];
219
+ put?: never;
220
+ post?: never;
221
+ delete?: never;
222
+ options?: never;
223
+ head?: never;
224
+ patch?: never;
225
+ trace?: never;
226
+ };
227
+ "/api/v1/organizations/{org_id}/reviews": {
228
+ parameters: {
229
+ query?: never;
230
+ header?: never;
231
+ path?: never;
232
+ cookie?: never;
233
+ };
234
+ /**
235
+ * List reviews
236
+ * @description Lists the latest run of each pull request in the organization, with filters and cursor pagination. A `search` equal to a full head commit SHA returns the latest run at that commit instead.
237
+ */
238
+ get: operations["list_reviews"];
239
+ put?: never;
240
+ post?: never;
241
+ delete?: never;
242
+ options?: never;
243
+ head?: never;
244
+ patch?: never;
245
+ trace?: never;
246
+ };
247
+ "/api/v1/organizations/{org_id}/reviews/deployments/{public_key}": {
248
+ parameters: {
249
+ query?: never;
250
+ header?: never;
251
+ path?: never;
252
+ cookie?: never;
253
+ };
254
+ /**
255
+ * Get a deployment review
256
+ * @description Returns the deployment review with the given public key.
257
+ */
258
+ get: operations["get_deployment_review"];
259
+ put?: never;
260
+ post?: never;
261
+ delete?: never;
262
+ options?: never;
263
+ head?: never;
264
+ patch?: never;
265
+ trace?: never;
266
+ };
267
+ "/api/v1/organizations/{org_id}/reviews/pr/{repository}/{pull_request_number}": {
268
+ parameters: {
269
+ query?: never;
270
+ header?: never;
271
+ path?: never;
272
+ cookie?: never;
273
+ };
274
+ /**
275
+ * List a pull request's review runs
276
+ * @description Lists the review runs of one pull request, addressed by repository name and pull request number.
277
+ */
278
+ get: operations["list_pull_request_reviews"];
279
+ put?: never;
280
+ post?: never;
281
+ delete?: never;
282
+ options?: never;
283
+ head?: never;
284
+ patch?: never;
285
+ trace?: never;
286
+ };
287
+ "/api/v1/organizations/{org_id}/reviews/pr/{repository}/{pull_request_number}/runs/{run_number}": {
288
+ parameters: {
289
+ query?: never;
290
+ header?: never;
291
+ path?: never;
292
+ cookie?: never;
293
+ };
294
+ /**
295
+ * Get a pull request review run
296
+ * @description Returns one review run of a pull request, addressed by repository name, pull request number and run number.
297
+ */
298
+ get: operations["get_pull_request_review"];
299
+ put?: never;
300
+ post?: never;
301
+ delete?: never;
302
+ options?: never;
303
+ head?: never;
304
+ patch?: never;
305
+ trace?: never;
306
+ };
307
+ "/api/v1/organizations/{org_id}/reviews/{review_id}": {
308
+ parameters: {
309
+ query?: never;
310
+ header?: never;
311
+ path?: never;
312
+ cookie?: never;
313
+ };
314
+ /**
315
+ * Get a review
316
+ * @description Returns a review with its subjects, assessments and open items. An incomplete assessment reports its gaps; an empty finding list from it says nothing about the change.
317
+ */
318
+ get: operations["get_review"];
319
+ put?: never;
320
+ post?: never;
321
+ delete?: never;
322
+ options?: never;
323
+ head?: never;
324
+ patch?: never;
325
+ trace?: never;
326
+ };
327
+ "/api/v1/organizations/{org_id}/reviews/{review_id}/assessments/{assessment_id}": {
328
+ parameters: {
329
+ query?: never;
330
+ header?: never;
331
+ path?: never;
332
+ cookie?: never;
333
+ };
334
+ /**
335
+ * Get an assessment
336
+ * @description Returns one assessment of a review with its decision, checks and findings.
337
+ */
338
+ get: operations["get_assessment"];
339
+ put?: never;
340
+ post?: never;
341
+ delete?: never;
342
+ options?: never;
343
+ head?: never;
344
+ patch?: never;
345
+ trace?: never;
346
+ };
347
+ "/api/v1/organizations/{org_id}/reviews/{review_id}/rerun": {
348
+ parameters: {
349
+ query?: never;
350
+ header?: never;
351
+ path?: never;
352
+ cookie?: never;
353
+ };
354
+ get?: never;
355
+ put?: never;
356
+ /**
357
+ * Rerun a review
358
+ * @description Creates a new run of the review's original immutable code subject and leaves earlier runs unchanged. A local patch review is not rerun. Requires live GitHub write access; a repeated request can create another run, so clients make one attempt.
359
+ */
360
+ post: operations["rerun_review"];
361
+ delete?: never;
362
+ options?: never;
363
+ head?: never;
364
+ patch?: never;
365
+ trace?: never;
366
+ };
367
+ "/api/v1/organizations/{org_id}/reviews/{review_id}/routing": {
368
+ parameters: {
369
+ query?: never;
370
+ header?: never;
371
+ path?: never;
372
+ cookie?: never;
373
+ };
374
+ /**
375
+ * Get review routing
376
+ * @description Returns the review's validated routing plan and recorded finding placements. It reports retained routing facts, not model output or a deployment recommendation.
377
+ */
378
+ get: operations["get_review_routing"];
379
+ put?: never;
380
+ post?: never;
381
+ delete?: never;
382
+ options?: never;
383
+ head?: never;
384
+ patch?: never;
385
+ trace?: never;
386
+ };
387
+ }
388
+ export type webhooks = Record<string, never>;
389
+ export interface components {
390
+ schemas: {
391
+ /** @enum {string} */
392
+ ActionUnavailability: "READ_ONLY" | "REPOSITORY_UNAVAILABLE" | "REPOSITORY_WRITE_REQUIRED" | "PERMISSION_CHECK_UNAVAILABLE";
393
+ /** @description The person behind an action on a review, as the page names them. */
394
+ ActorView: {
395
+ /**
396
+ * Format: int64
397
+ * @description Stable GitHub identity. The login below is display metadata.
398
+ */
399
+ github_user_id: number;
400
+ /** @description The login they were known by when they acted. Display metadata. */
401
+ login: string;
402
+ /** @description Their profile on the deployment's GitHub host. */
403
+ profile_url?: string | null;
404
+ };
405
+ AgentSession: {
406
+ /**
407
+ * Format: int32
408
+ * @description This session's place among the finding series' sessions at this
409
+ * commit, at most 3.
410
+ */
411
+ attempt: number;
412
+ /** @description Why Proofline ended or refused the session, as a closed code. */
413
+ cause?: string | null;
414
+ /**
415
+ * Format: uuid
416
+ * @description The vendor connection the session was started with.
417
+ */
418
+ connection_id: string;
419
+ /**
420
+ * Format: date-time
421
+ * @description When the session was requested.
422
+ */
423
+ created_at: string;
424
+ /** @description Whether Proofline stopped following the session. */
425
+ done: boolean;
426
+ /**
427
+ * Format: uuid
428
+ * @description The finding the session works on.
429
+ */
430
+ finding_id: string;
431
+ /**
432
+ * Format: uuid
433
+ * @description The session's ID.
434
+ */
435
+ id: string;
436
+ /**
437
+ * @description The pull request's head when it had moved past the reviewed commit,
438
+ * for a `HEAD_MOVED` session.
439
+ */
440
+ observed_head_sha?: string | null;
441
+ /**
442
+ * @description The pull request the vendor opened, once GitHub confirmed it belongs
443
+ * to the target repository.
444
+ */
445
+ pull_request_url?: string | null;
446
+ /**
447
+ * Format: uuid
448
+ * @description The person who started the session.
449
+ */
450
+ requested_by_user_id: string;
451
+ /**
452
+ * Format: uuid
453
+ * @description The review that recorded the finding.
454
+ */
455
+ review_id: string;
456
+ /**
457
+ * @description `REQUESTED` until the workflow records a status, then `STARTING`,
458
+ * `RUNNING`, `FINISHED`, `FAILED`, `REFUSED`, `HEAD_MOVED` or
459
+ * `UNKNOWN`.
460
+ */
461
+ status: string;
462
+ /** @description The pull request and commit the session is pinned to. */
463
+ target: components["schemas"]["AgentSessionTarget"];
464
+ /** @description The vendor's summary: untrusted text, never acted on. */
465
+ untrusted_vendor_summary?: string | null;
466
+ /**
467
+ * Format: date-time
468
+ * @description When the session's latest status was recorded.
469
+ */
470
+ updated_at: string;
471
+ /** @description The coding-agent vendor running the session. */
472
+ vendor: components["schemas"]["AgentVendor"];
473
+ /** @description The vendor's own status token. */
474
+ vendor_status?: string | null;
475
+ /** @description The session in the vendor's console. */
476
+ vendor_url?: string | null;
477
+ };
478
+ AgentSessionPrompt: {
479
+ /**
480
+ * @description SHA-256 of `untrusted_text`. A start names it, so the session
481
+ * sends what the person confirmed.
482
+ */
483
+ prompt_digest: string;
484
+ /** @constant */
485
+ status: "AVAILABLE";
486
+ /** @description The pull request and commit a session would be pinned to. */
487
+ target: components["schemas"]["AgentSessionTarget"];
488
+ /**
489
+ * @description The exact text a vendor receives: untrusted finding data with
490
+ * every protected value withheld.
491
+ */
492
+ untrusted_text: string;
493
+ /**
494
+ * Format: uint
495
+ * @description How many protected values were withheld from the prompt.
496
+ */
497
+ withheld_values: number;
498
+ } | {
499
+ /** @description Why this finding cannot start a session. */
500
+ reason: string;
501
+ /** @constant */
502
+ status: "UNAVAILABLE";
503
+ };
504
+ /** @description What a session is pinned to: the finding's own reviewed pull request. */
505
+ AgentSessionTarget: {
506
+ /**
507
+ * Format: int64
508
+ * @description The repository's stable GitHub ID, which the connection allowlists.
509
+ */
510
+ github_repository_id: number;
511
+ /** @description The exact commit the review read. The session starts from it. */
512
+ head_sha: string;
513
+ /**
514
+ * Format: int64
515
+ * @description The reviewed pull request.
516
+ */
517
+ pull_request_number: number;
518
+ /** @description The repository's `owner/name` on GitHub, as last recorded. */
519
+ repository_full_name: string;
520
+ /**
521
+ * Format: uuid
522
+ * @description The reviewed repository's Proofline ID.
523
+ */
524
+ repository_id: string;
525
+ };
526
+ /** @enum {string} */
527
+ AgentVendor: "CURSOR_CLOUD_AGENTS" | "DEVIN";
528
+ AssessmentProjection: {
529
+ /**
530
+ * Format: uuid
531
+ * @description Assessment that owns this route binding.
532
+ */
533
+ assessment_id: string;
534
+ /**
535
+ * Format: uuid
536
+ * @description Environment that the assessment covers.
537
+ */
538
+ environment_id: string;
539
+ /** @description Whether this assessment retained a generalist output record. */
540
+ pass_output_recorded: boolean;
541
+ /** @description Digest of the immutable generalist output, when the assessment retained one. */
542
+ pass_output_sha256?: string | null;
543
+ /** @description Pass and symbolic model binding retained by the plan. */
544
+ passes: components["schemas"]["PassProjection"][];
545
+ /** @description Environment reach retained by the plan. */
546
+ reach: string;
547
+ };
548
+ /** @description How one condition relates to the review's base revision. */
549
+ AttributedChange: "INTRODUCED" | "CHANGED" | "UNCHANGED" | "RESOLVED" | "UNATTRIBUTED";
550
+ AttributedConditionView: {
551
+ /** @description How this condition relates to the review's base revision. */
552
+ change: components["schemas"]["AttributedChange"];
553
+ /** @description The member that declares the site at each revision that declares it. */
554
+ reviewed_tree_citations: components["schemas"]["ReviewedTreeCitationView"][];
555
+ /**
556
+ * @description The revision that holds the condition: the base for `RESOLVED`, the
557
+ * proposed revision for `INTRODUCED`, `CHANGED` and `UNCHANGED`, and
558
+ * either for `UNATTRIBUTED`.
559
+ */
560
+ revision: components["schemas"]["AttributedRevision"];
561
+ /**
562
+ * @description World's label of the condition's site and what it declares, such as
563
+ * `.github/workflows/ci.yml jobs.test.steps[0].uses: actions/checkout@v4`.
564
+ * It quotes repository text.
565
+ */
566
+ subject: components["schemas"]["UntrustedText"];
567
+ };
568
+ AttributedRevision: "PROPOSED_CODE_REVISION" | "BASE_CODE_REVISION";
569
+ AttributionStatus: "COMPARED" | "UNAVAILABLE" | "UNREADABLE";
570
+ AuthorChoice: {
571
+ /**
572
+ * Format: int64
573
+ * @description The pull request author's GitHub user ID, the value the `author` filter
574
+ * accepts.
575
+ */
576
+ id: number;
577
+ /**
578
+ * @description The author's most recently recorded GitHub login, a display label. Null
579
+ * when none is recorded.
580
+ */
581
+ login?: string | null;
582
+ };
583
+ /** @enum {string} */
584
+ Authority: "ADVISORY" | "DEPLOYMENT_POLICY";
585
+ Availability: ("RECORDED" | "NOT_RECORDED" | "LEGACY" | "OPERATIONAL_FAILURE") | "LIMITED";
586
+ /**
587
+ * @description Which conditions behind a check's result the change brought, and which
588
+ * World found at the review's base revision. It sits beside the result and
589
+ * never changes it: a condition already at the base is still a condition.
590
+ */
591
+ ChangeAttributionView: {
592
+ /**
593
+ * @description Where every condition is recorded when some are omitted. Absent when
594
+ * `conditions` lists them all.
595
+ */
596
+ complete_record?: components["schemas"]["CompleteRecordView"] | null;
597
+ /**
598
+ * Format: uint32
599
+ * @description How many conditions World attributed, listed or not. Zero unless
600
+ * `status` is `COMPARED`.
601
+ */
602
+ condition_count: number;
603
+ /**
604
+ * @description Every condition, each once, in World's order, never netted against
605
+ * another. Empty unless `status` is `COMPARED`, and empty when some are
606
+ * omitted: it never lists only some of them.
607
+ */
608
+ conditions: components["schemas"]["AttributedConditionView"][];
609
+ /**
610
+ * @description How many conditions there are of each change at each revision, over
611
+ * every condition, listed or not. Changes with none are left out.
612
+ */
613
+ counts: components["schemas"]["ChangeCountView"][];
614
+ /**
615
+ * @description World's code for why it could not read that revision, such as
616
+ * `BASE_REVIEWED_TREE_NOT_DECLARED`. Present exactly when `status` is
617
+ * `UNAVAILABLE`.
618
+ */
619
+ detail_code?: string | null;
620
+ /**
621
+ * @description The conditions a summary lists when some are omitted: the first ones
622
+ * in the order `counts` gives, each whole, at most 50 and always fewer
623
+ * than `condition_count`. Present exactly when `omitted_condition_count`
624
+ * is not zero.
625
+ */
626
+ listed_conditions?: components["schemas"]["AttributedConditionView"][] | null;
627
+ /**
628
+ * Format: uint32
629
+ * @description How many of those conditions this response does not list. Zero when
630
+ * the result kept World's attribution whole. Otherwise the result kept a
631
+ * summary: `listed_conditions` lists the first ones, `counts` is still
632
+ * exact, and World's recorded evaluation holds every condition.
633
+ */
634
+ omitted_condition_count: number;
635
+ /**
636
+ * @description The revision World could not read. Present exactly when `status` is
637
+ * `UNAVAILABLE`.
638
+ */
639
+ revision?: components["schemas"]["AttributedRevision"] | null;
640
+ /**
641
+ * @description Whether World compared both revisions, could not read one, or recorded
642
+ * an attribution this build cannot read.
643
+ */
644
+ status: components["schemas"]["AttributionStatus"];
645
+ };
646
+ /** @description How many conditions are of one change at one revision. */
647
+ ChangeCountView: {
648
+ /** @description How the counted conditions relate to the review's base revision. */
649
+ change: components["schemas"]["AttributedChange"];
650
+ /**
651
+ * Format: uint32
652
+ * @description How many conditions have this `change` at this `revision`, over every
653
+ * condition, listed or not.
654
+ */
655
+ count: number;
656
+ /** @description The revision that holds the counted conditions. */
657
+ revision: components["schemas"]["AttributedRevision"];
658
+ };
659
+ /**
660
+ * @description World's lifecycle disclosure for the evaluator version that answered, as
661
+ * the receipt recorded it. A deployment gate counts only `GATING` results
662
+ * (`DeterministicCoverage::gate_effective_status`), and only when it
663
+ * evaluates a deployment; the lifecycle alone permits or blocks nothing.
664
+ */
665
+ CheckLifecycle: "GATING" | "SHADOW" | "QUARANTINED" | "RETIRED" | "UNKNOWN";
666
+ /**
667
+ * @description A code assessment's recorded execution status. It is never a verdict on
668
+ * the change: only `COMPLETED` says the assessment covered what it read.
669
+ */
670
+ CodeAssessmentStatus: ("PENDING" | "RUNNING" | "COMPLETED" | "INCOMPLETE") | "EXCLUDED";
671
+ /** @description One stored post-merge judgment of a finding comment. */
672
+ CommentAddressEvaluationView: {
673
+ /**
674
+ * Format: date-time
675
+ * @description When the evaluation was made.
676
+ */
677
+ evaluated_at: string;
678
+ /** @description `ADDRESSED`, `NOT_ADDRESSED`, or `INCOMPLETE` when the merged code could not be judged. */
679
+ outcome: components["schemas"]["CommentAddressOutcome"];
680
+ /** @description Server-authored reason. Render as text. */
681
+ reason: string;
682
+ };
683
+ /** @enum {string} */
684
+ CommentAddressOutcome: "ADDRESSED" | "NOT_ADDRESSED" | "INCOMPLETE";
685
+ /** @enum {string} */
686
+ CommentReaction: "THUMBS_UP" | "THUMBS_DOWN" | "LAUGH" | "HOORAY" | "CONFUSED" | "HEART" | "ROCKET" | "EYES";
687
+ /** @description One stored reaction on the finding's root comment. */
688
+ CommentReactionView: {
689
+ /**
690
+ * Format: int64
691
+ * @description The stable GitHub identity of whoever reacted.
692
+ */
693
+ actor_github_user_id: number;
694
+ /** @description Provider text. Render as text. */
695
+ actor_login?: string | null;
696
+ /**
697
+ * Format: int64
698
+ * @description The GitHub comment the reaction is on: the finding's root comment.
699
+ */
700
+ github_comment_id: number;
701
+ /** @description The reaction as GitHub names it. */
702
+ reaction: components["schemas"]["CommentReaction"];
703
+ };
704
+ /**
705
+ * @description Pushed commits to review: the exact base the change is compared with and
706
+ * the exact head it ends at.
707
+ */
708
+ CommitReviewRequest: {
709
+ /**
710
+ * @description The full 40-character commit the change is compared with. GitHub must
711
+ * have it in this repository, and it must be an ancestor of the head.
712
+ */
713
+ base_commit_sha: string;
714
+ /**
715
+ * @description The full 40-character commit the change ends at. GitHub must have it
716
+ * in this repository.
717
+ */
718
+ head_commit_sha: string;
719
+ };
720
+ /** @description What a commit review request produced. */
721
+ CommitReviewResponse: {
722
+ /**
723
+ * @description True when these exact commits already had a review and that one is
724
+ * returned. Sending the same commits twice reviews them once.
725
+ */
726
+ existing: boolean;
727
+ /**
728
+ * Format: uuid
729
+ * @description The review of these commits, readable through the review and findings
730
+ * routes.
731
+ */
732
+ review_id: string;
733
+ };
734
+ /**
735
+ * @description World's immutable record of the complete answer an omitted list comes
736
+ * from.
737
+ */
738
+ CompleteRecordView: {
739
+ /** @description The `sha256:` digest of the complete attribution in that record. */
740
+ attribution_digest: string;
741
+ /** @description The evaluation World recorded, which holds every condition. */
742
+ world_evaluation_id: string;
743
+ };
744
+ CustomerAssessment: {
745
+ /** @description The deterministic World checks recorded for this assessment. */
746
+ checks: components["schemas"]["CustomerChecks"];
747
+ /**
748
+ * Format: date-time
749
+ * @description When the assessment completed. Null while it has not.
750
+ */
751
+ completed_at?: string | null;
752
+ /**
753
+ * @description The retained decision disclosure, which grants no deployment
754
+ * authorization. Absent when none is recorded and the review kind
755
+ * records no decision basis.
756
+ */
757
+ decision_presentation?: components["schemas"]["CustomerDecision"] | null;
758
+ /**
759
+ * @description The risk domains the assessment evaluated, each with its status and
760
+ * reason, ordered by domain.
761
+ */
762
+ domains: components["schemas"]["DomainView"][];
763
+ /** @description The display name of the environment this assessment covers. */
764
+ environment_display_name: string;
765
+ /** @description The findings this assessment recorded, `SERIOUS` first. */
766
+ findings: components["schemas"]["CustomerFinding"][];
767
+ /**
768
+ * Format: uuid
769
+ * @description The assessment's ID.
770
+ */
771
+ id: string;
772
+ /**
773
+ * @description Why an `INCOMPLETE` assessment is incomplete: `NOT_CONFIGURED`,
774
+ * `POLICY_EXCLUDED`, `EVIDENCE_UNAVAILABLE`, `HYPOTHESES_UNRESOLVED` or
775
+ * `MODEL_BUDGET_EXHAUSTED`. Absent otherwise; an unclassified gap is not a
776
+ * complete assessment.
777
+ */
778
+ incompleteness_kind?: string | null;
779
+ /**
780
+ * @description Public assessment gap codes. A recorded out-of-credits refusal
781
+ * is projected as `OUT_OF_CREDITS` when no stored code exists. Other
782
+ * historical records may have no codes; private details are not exposed.
783
+ */
784
+ reason_codes?: string[] | null;
785
+ /**
786
+ * @description The typed gap the automatic release-set read recorded. Null when the
787
+ * read is pending, pinned a release, or was never attempted.
788
+ */
789
+ release_evidence_gap?: string | null;
790
+ /**
791
+ * Format: date-time
792
+ * @description When the assessment started. Null until it starts.
793
+ */
794
+ started_at?: string | null;
795
+ /**
796
+ * @description The assessment's recorded status, such as `RUNNING`, `COMPLETED` or
797
+ * `INCOMPLETE`.
798
+ */
799
+ status: string;
800
+ };
801
+ CustomerAssessmentDetail: {
802
+ /** @description The deterministic World checks recorded for this assessment. */
803
+ checks: components["schemas"]["CustomerChecks"];
804
+ /**
805
+ * Format: date-time
806
+ * @description When the assessment completed. Null while it has not.
807
+ */
808
+ completed_at?: string | null;
809
+ /**
810
+ * @description The retained decision disclosure, which grants no deployment
811
+ * authorization. Absent when none is recorded and the review kind
812
+ * records no decision basis.
813
+ */
814
+ decision_presentation?: components["schemas"]["CustomerDecision"] | null;
815
+ /**
816
+ * @description The risk domains the assessment evaluated, each with its status and
817
+ * reason, ordered by domain.
818
+ */
819
+ domains: components["schemas"]["DomainView"][];
820
+ /** @description The display name of the environment this assessment covers. */
821
+ environment_display_name: string;
822
+ /** @description The findings this assessment recorded, `SERIOUS` first. */
823
+ findings: components["schemas"]["CustomerFinding"][];
824
+ /**
825
+ * Format: uuid
826
+ * @description The assessment's ID.
827
+ */
828
+ id: string;
829
+ /**
830
+ * @description Why an `INCOMPLETE` assessment is incomplete: `NOT_CONFIGURED`,
831
+ * `POLICY_EXCLUDED`, `EVIDENCE_UNAVAILABLE`, `HYPOTHESES_UNRESOLVED` or
832
+ * `MODEL_BUDGET_EXHAUSTED`. Absent otherwise; an unclassified gap is not a
833
+ * complete assessment.
834
+ */
835
+ incompleteness_kind?: string | null;
836
+ /**
837
+ * @description Public assessment gap codes. A recorded out-of-credits refusal
838
+ * is projected as `OUT_OF_CREDITS` when no stored code exists. Other
839
+ * historical records may have no codes; private details are not exposed.
840
+ */
841
+ reason_codes?: string[] | null;
842
+ /**
843
+ * @description The typed gap the automatic release-set read recorded. Null when the
844
+ * read is pending, pinned a release, or was never attempted.
845
+ */
846
+ release_evidence_gap?: string | null;
847
+ /**
848
+ * Format: uuid
849
+ * @description The review this assessment belongs to.
850
+ */
851
+ review_id: string;
852
+ /**
853
+ * Format: date-time
854
+ * @description When the assessment started. Null until it starts.
855
+ */
856
+ started_at?: string | null;
857
+ /**
858
+ * @description The assessment's recorded status, such as `RUNNING`, `COMPLETED` or
859
+ * `INCOMPLETE`.
860
+ */
861
+ status: string;
862
+ /**
863
+ * @description The review subjects this assessment's own release set authorized, plus
864
+ * each `PRIMARY` subject that carries no release authorization.
865
+ */
866
+ subjects: components["schemas"]["SubjectView"][];
867
+ };
868
+ CustomerCheck: {
869
+ /**
870
+ * @description Which conditions behind the outcome the change brought and which were
871
+ * already at the review's base revision. It never changes the outcome:
872
+ * a condition already at the base is pre-existing, not safe. Absent for
873
+ * a check whose evaluator does not compare the two revisions.
874
+ */
875
+ change_attribution?: components["schemas"]["ChangeAttributionView"] | null;
876
+ /**
877
+ * @description Why World refused the check, or otherwise World's recorded explanation
878
+ * of the result. Null when neither is recorded.
879
+ */
880
+ detail?: string | null;
881
+ /**
882
+ * @description When World evaluated this answer. A reused answer is evidence from
883
+ * this instant, which can precede the assessment.
884
+ */
885
+ evaluated_at?: string | null;
886
+ /**
887
+ * @description The lifecycle of the evaluator version that answered. It says whether
888
+ * a deployment gate could count this result, not whether one did.
889
+ */
890
+ lifecycle: components["schemas"]["CheckLifecycle"];
891
+ /** @description The check's readable name, derived from its key. */
892
+ name: string;
893
+ /**
894
+ * @description The outcome the receipt recorded, which is the outcome a deployment
895
+ * gate weighed: `READY`, `BLOCKED`, `UNRESOLVED`, `UNAVAILABLE`,
896
+ * `NOT_APPLICABLE` or `NOT_ASKED`. A verdict never rewrites it.
897
+ */
898
+ outcome: string;
899
+ /**
900
+ * @description Why an `UNRESOLVED` check did not settle, as World's verdict gave it.
901
+ * Absent on every other outcome, and on an unresolved receipt whose
902
+ * verdict names none of these reasons.
903
+ */
904
+ unresolved_reason?: components["schemas"]["UnresolvedReason"] | null;
905
+ };
906
+ CustomerChecks: {
907
+ /**
908
+ * @description One entry per recorded check result, ordered by check key and version.
909
+ * Empty when no receipt exists.
910
+ */
911
+ families: components["schemas"]["CustomerCheck"][];
912
+ /**
913
+ * @description Whether these checks come from an immutable deterministic coverage
914
+ * receipt. When false, no check result is recorded.
915
+ */
916
+ receipt_recorded: boolean;
917
+ /**
918
+ * @description The receipt's status, or `PENDING`, `SUPERSEDED`, `STOPPED`,
919
+ * `NOT_ATTEMPTED` or `UNAVAILABLE` when no receipt exists.
920
+ */
921
+ status: string;
922
+ };
923
+ /**
924
+ * @description The review's code assessment as it recorded its run. Its findings
925
+ * rest on the pinned code alone, never on World evidence.
926
+ */
927
+ CustomerCodeAssessment: {
928
+ /** @description The base commit the code assessment compared the head with. */
929
+ base_commit_sha: string;
930
+ /**
931
+ * Format: date-time
932
+ * @description When the code assessment ended. Null while it has not.
933
+ */
934
+ completed_at?: string | null;
935
+ /**
936
+ * @description The code-only findings the code assessment recorded, `SERIOUS` first.
937
+ * An empty list does not establish deployment safety.
938
+ */
939
+ findings: components["schemas"]["CustomerFinding"][];
940
+ /** @description The head commit the code assessment read. */
941
+ head_commit_sha: string;
942
+ /**
943
+ * Format: uuid
944
+ * @description The code assessment's ID.
945
+ */
946
+ id: string;
947
+ /**
948
+ * @description Why an `INCOMPLETE` code assessment is incomplete: `NOT_CONFIGURED`,
949
+ * `POLICY_EXCLUDED`, `EVIDENCE_UNAVAILABLE`, `HYPOTHESES_UNRESOLVED` or
950
+ * `MODEL_BUDGET_EXHAUSTED`. Null otherwise.
951
+ */
952
+ incompleteness_kind?: string | null;
953
+ /**
954
+ * Format: date-time
955
+ * @description When the code assessment started. Null until it starts.
956
+ */
957
+ started_at?: string | null;
958
+ /** @description The code assessment's recorded execution status. */
959
+ status: components["schemas"]["CodeAssessmentStatus"];
960
+ };
961
+ CustomerDecision: {
962
+ /** @description Whether the decision is `ADVISORY` or comes from a `DEPLOYMENT_POLICY`. */
963
+ authority: components["schemas"]["Authority"];
964
+ /**
965
+ * @description Whether a verified decision record is present, absent, legacy, failed,
966
+ * or too large for this projection.
967
+ */
968
+ availability: components["schemas"]["Availability"];
969
+ /**
970
+ * @description The permission, evidence classification and reason code of the
971
+ * verified recorded basis. Null when no verified basis is recorded.
972
+ */
973
+ basis?: components["schemas"]["CustomerDecisionBasis"] | null;
974
+ /**
975
+ * @description The local deployment gate state and any recorded override. Null unless
976
+ * the decision belongs to a deployment gate.
977
+ */
978
+ gate_state?: components["schemas"]["GateState"] | null;
979
+ };
980
+ CustomerDecisionBasis: {
981
+ /** @description How the recorded basis classified its evidence. */
982
+ evidence: components["schemas"]["EvidenceView"];
983
+ /** @description The permission the recorded basis reached: `PERMIT` or `BLOCK`. */
984
+ permission: components["schemas"]["PermissionView"];
985
+ /** @description The reason code the recorded basis gives for its permission. */
986
+ reason_code: string;
987
+ };
988
+ CustomerEvidenceRef: {
989
+ /**
990
+ * @description The commit a file or commit reference reads. Null for other kinds, and
991
+ * for a file reference whose review recorded no head commit.
992
+ */
993
+ commit_sha?: string | null;
994
+ /**
995
+ * @description The repository a `companion_repository_file` reference reads from.
996
+ * Null for every other kind.
997
+ */
998
+ companion_repository?: string | null;
999
+ /**
1000
+ * Format: uint32
1001
+ * @description The last cited line of a file reference. Null when the reference names
1002
+ * no end line or is not a file reference.
1003
+ */
1004
+ end_line?: number | null;
1005
+ /**
1006
+ * @description SHA256 of the complete original file bytes retained by a trusted ENV
1007
+ * or CODE read. Absent on older references and partial reads.
1008
+ */
1009
+ file_sha256?: string | null;
1010
+ /**
1011
+ * @description The reference's kind: `repository_file`, `companion_repository_file`,
1012
+ * `commit`, `workflow_run`, `world_entity`, `deterministic_test`,
1013
+ * `recorded_read`, `sandbox_experiment`, `vendor_documentation` or
1014
+ * `text`.
1015
+ */
1016
+ kind: string;
1017
+ /**
1018
+ * @description The reference's display label, such as a path with its line range. A
1019
+ * recorded read, a vendor documentation read or an unnamed World entity
1020
+ * carries a fixed label, and a deterministic test carries its check's
1021
+ * readable name.
1022
+ */
1023
+ label: string;
1024
+ /**
1025
+ * @description The unstructured text of a `text` reference. Null for structured
1026
+ * references and for recorded reads.
1027
+ */
1028
+ legacy_text?: string | null;
1029
+ /**
1030
+ * @description How the reference was obtained: `VERIFIED_REPOSITORY_READ`,
1031
+ * `PINNED_WORLD_ENTITY`, `EXECUTED_DETERMINISTIC_TEST`,
1032
+ * `EXECUTED_SANDBOX_EXPERIMENT`, `PROVIDER_REFERENCE`, `RECORDED_READ`
1033
+ * or `LEGACY_UNSTRUCTURED`.
1034
+ */
1035
+ provenance_status: string;
1036
+ /** @description The cited file's path for a file reference. Null for every other kind. */
1037
+ repository_path?: string | null;
1038
+ /**
1039
+ * Format: uint32
1040
+ * @description The first cited line of a file reference. Null when the reference cites
1041
+ * no line or is not a file reference.
1042
+ */
1043
+ start_line?: number | null;
1044
+ /**
1045
+ * @description The link the reference resolves to. Null when it resolves to none or
1046
+ * the review's repository or head commit is unknown.
1047
+ */
1048
+ url?: string | null;
1049
+ /**
1050
+ * Format: int32
1051
+ * @description The run attempt of a `workflow_run` reference. Null when the reference
1052
+ * names no attempt or is another kind.
1053
+ */
1054
+ workflow_attempt?: number | null;
1055
+ /**
1056
+ * Format: int64
1057
+ * @description The GitHub Actions run ID of a `workflow_run` reference. Null for every
1058
+ * other kind.
1059
+ */
1060
+ workflow_run_id?: number | null;
1061
+ };
1062
+ CustomerFinding: {
1063
+ /**
1064
+ * @description The typed causal graph the reviewer supplied for an ordering or
1065
+ * reachability finding. Null when the finding carries none.
1066
+ */
1067
+ causal_graph?: components["schemas"]["FindingCausalGraphView"] | null;
1068
+ /** @description What the reviewer states is wrong. */
1069
+ claim: string;
1070
+ /**
1071
+ * @description The post-merge judgment of whether the finding comment was addressed.
1072
+ * It is not a finding decision; null when none is recorded.
1073
+ */
1074
+ comment_evaluation?: components["schemas"]["CommentAddressEvaluationView"] | null;
1075
+ /**
1076
+ * @description Emoji reactions stored on the Proofline finding comment. They are not a
1077
+ * finding decision.
1078
+ */
1079
+ comment_reactions: components["schemas"]["CommentReactionView"][];
1080
+ /**
1081
+ * @description The kind of proof the finding rests on, derived from the typed evidence
1082
+ * it cites. Null on findings recorded before the class existed.
1083
+ */
1084
+ evidence_class?: components["schemas"]["FindingEvidenceClass"] | null;
1085
+ /**
1086
+ * @description The references the finding cites, resolved as the pull request comment
1087
+ * resolves them.
1088
+ */
1089
+ evidence_refs: components["schemas"]["CustomerEvidenceRef"][];
1090
+ /**
1091
+ * @description The retained semantic fingerprint used to correlate findings. It is
1092
+ * opaque and separate from the occurrence ID and reviewed code digest.
1093
+ * Absent when no fingerprint is retained; no replacement is derived.
1094
+ */
1095
+ finding_fingerprint?: string | null;
1096
+ /**
1097
+ * @description The inline GitHub comment published for this occurrence of the finding.
1098
+ * Null when none was published; earlier runs are never used as a fallback.
1099
+ */
1100
+ github_comment_url?: string | null;
1101
+ /**
1102
+ * Format: uuid
1103
+ * @description The finding's ID.
1104
+ */
1105
+ id: string;
1106
+ /** @description The consequence the reviewer states the claim has. */
1107
+ impact: string;
1108
+ /**
1109
+ * @description The latest decision on the finding's series, with who made it, where
1110
+ * and when. Null when no decision is recorded.
1111
+ */
1112
+ latest_validation?: components["schemas"]["CustomerFindingValidation"] | null;
1113
+ /**
1114
+ * @description The finding's recorded lifecycle state: `NEW`, `UNCHANGED`, `RESOLVED`
1115
+ * or `REINTRODUCED`.
1116
+ */
1117
+ lifecycle_state: string;
1118
+ /**
1119
+ * @description Where this review's comment gate placed the finding, as it recorded
1120
+ * the placement. Null when the review recorded none.
1121
+ */
1122
+ placement?: components["schemas"]["FindingPlacementView"] | null;
1123
+ /** @description The reviewer's proposed fix. Null when it proposed none. */
1124
+ remediation?: string | null;
1125
+ /** @description The risk domain the reviewer assigned to the finding. */
1126
+ risk_domain: string;
1127
+ /**
1128
+ * @description The bound review rules the reviewer cited for this finding, by key and
1129
+ * the revisions its assessment showed the reviewer. A finding carried
1130
+ * forward unchanged keeps the citations of the finding it carries. Empty
1131
+ * when it cited none.
1132
+ */
1133
+ rule_refs: components["schemas"]["FindingRuleRefView"][];
1134
+ /** @description `SERIOUS` or `WARNING`. */
1135
+ severity: string;
1136
+ /**
1137
+ * @description The verdict explanation and evidence of the supported hypothesis that
1138
+ * produced this finding. Null when the finding links no supported
1139
+ * hypothesis.
1140
+ */
1141
+ supporting_evidence?: components["schemas"]["FindingSupport"] | null;
1142
+ /**
1143
+ * @description The code identifiers the reviewer declared in the finding's prose, in
1144
+ * declaration order, so a reader can set each as code.
1145
+ */
1146
+ symbols: string[];
1147
+ /**
1148
+ * @description The latest observation of the finding's GitHub thread state. It is not
1149
+ * a finding decision; null when none is recorded.
1150
+ */
1151
+ thread_observation?: components["schemas"]["ThreadObservationView"] | null;
1152
+ /**
1153
+ * @description The latest decision on the finding, the same value `latest_validation`
1154
+ * carries. Null when no decision is recorded.
1155
+ */
1156
+ validation?: string | null;
1157
+ };
1158
+ CustomerFindingValidation: {
1159
+ /**
1160
+ * Format: int64
1161
+ * @description The actor's stable GitHub user ID. Null for the automatic decision.
1162
+ */
1163
+ actor_github_user_id?: number | null;
1164
+ /**
1165
+ * @description The actor's GitHub login, a display label to render as text. Null for
1166
+ * the automatic decision.
1167
+ */
1168
+ actor_login?: string | null;
1169
+ /** @description For `ALREADY_COVERED`, `HUMAN` or `BOT`. Null for every other decision. */
1170
+ covering_author_kind?: string | null;
1171
+ /**
1172
+ * @description For `ALREADY_COVERED`, the login of whoever wrote the covering comment,
1173
+ * to render as text. Null for every other decision.
1174
+ */
1175
+ covering_author_login?: string | null;
1176
+ /**
1177
+ * Format: date-time
1178
+ * @description For `ALREADY_COVERED`, when the covering comment was written. Null for
1179
+ * every other decision.
1180
+ */
1181
+ covering_comment_created_at?: string | null;
1182
+ /**
1183
+ * @description The comment that carried a decision made on GitHub, or, for
1184
+ * `ALREADY_COVERED`, the other reviewer's comment the decision rests on.
1185
+ */
1186
+ github_comment_url?: string | null;
1187
+ /**
1188
+ * Format: date-time
1189
+ * @description When Proofline recorded the decision.
1190
+ */
1191
+ recorded_at: string;
1192
+ /**
1193
+ * @description Where the decision came from: `UI` for the app's assessment controls,
1194
+ * `GITHUB_COMMENT` for a pull request comment, or `PROOFLINE` for the
1195
+ * automatic `ALREADY_COVERED` decision.
1196
+ */
1197
+ source: string;
1198
+ /**
1199
+ * @description The decision: `CONFIRMED`, `DISMISSED`, `FIXED`, `ACCEPTED_RISK` or
1200
+ * `ALREADY_COVERED`.
1201
+ */
1202
+ validation: string;
1203
+ };
1204
+ CustomerReviewDetail: {
1205
+ /** @description Which review actions the caller may take now. */
1206
+ actions: components["schemas"]["ReviewActions"];
1207
+ /**
1208
+ * Format: int64
1209
+ * @description How many environment assessments this review has.
1210
+ */
1211
+ assessment_count: number;
1212
+ /** @description The environment assessments this review recorded. */
1213
+ assessments: components["schemas"]["CustomerAssessment"][];
1214
+ /**
1215
+ * @description The base branch tip GitHub reported when the review was triggered,
1216
+ * display metadata that differs from `base_commit_sha` when the base
1217
+ * branch moved after the branch point.
1218
+ */
1219
+ base_branch_commit_sha?: string | null;
1220
+ /**
1221
+ * @description The base revision the review compares against; for a pull request, the
1222
+ * merge base of its head and base branch. Null until pinned, and for a
1223
+ * first deployment.
1224
+ */
1225
+ base_commit_sha?: string | null;
1226
+ /**
1227
+ * @description The GitHub page for `base_commit_sha`. Null when that commit or the
1228
+ * repository is unknown.
1229
+ */
1230
+ base_commit_url?: string | null;
1231
+ /**
1232
+ * @description The pull request's base branch name as last recorded from GitHub, for
1233
+ * orientation only. Null when no pull request state is recorded.
1234
+ */
1235
+ base_ref?: string | null;
1236
+ /**
1237
+ * @description The GitHub check run Proofline published for this review. Null when
1238
+ * none was published.
1239
+ */
1240
+ check_run_url?: string | null;
1241
+ /**
1242
+ * @description The code assessment this review recorded, apart from its environment
1243
+ * assessments. Null when the review recorded none. It never completes an
1244
+ * environment assessment, and no environment count includes its findings.
1245
+ */
1246
+ code_assessment?: components["schemas"]["CustomerCodeAssessment"] | null;
1247
+ /**
1248
+ * @description The GitHub comparison of the base and head commits. Null unless both
1249
+ * are pinned and the repository is known, and for a patch review, whose
1250
+ * head GitHub does not have.
1251
+ */
1252
+ compare_url?: string | null;
1253
+ /**
1254
+ * Format: date-time
1255
+ * @description When the review reached a terminal status. Absent while it is still pending or running.
1256
+ */
1257
+ completed_at?: string | null;
1258
+ /**
1259
+ * Format: date-time
1260
+ * @description When the review was created.
1261
+ */
1262
+ created_at: string;
1263
+ /** @description The pull request's head commit as the latest provider projection reports it, which can differ from `head_commit_sha`. Set only on a single-review read, and absent for a deployment review or a pull request with no projection. */
1264
+ current_head_commit_sha?: string | null;
1265
+ /**
1266
+ * @description Automatic Deep Review outcome for this exact pinned comparison. Absent
1267
+ * when no sensitive-path evaluation receipt was recorded.
1268
+ */
1269
+ deep_review_escalation?: components["schemas"]["DeepReviewEscalation"] | null;
1270
+ /**
1271
+ * @description Line totals from this run's pinned comparison. Null until recorded, or
1272
+ * when the provider's changed-file list was incomplete.
1273
+ */
1274
+ diff_stats?: components["schemas"]["ReviewDiffStats"] | null;
1275
+ /** @description Display names of this review's assessed environments, not current repository links. */
1276
+ environment_display_names: string[];
1277
+ /**
1278
+ * Format: int64
1279
+ * @description How many findings this review's assessments recorded, across all of them.
1280
+ */
1281
+ finding_count: number;
1282
+ /**
1283
+ * @description The head commit this review is pinned to. For a patch review, the
1284
+ * revision ID Proofline derives from its base commit and patch digest,
1285
+ * which is not a commit. Absent when the review recorded none.
1286
+ */
1287
+ head_commit_sha?: string | null;
1288
+ /**
1289
+ * @description The exact revision reviewed. A commit URL, never a branch URL: the
1290
+ * branch moves, the reviewed input does not. Absent for a patch review.
1291
+ */
1292
+ head_commit_url?: string | null;
1293
+ /**
1294
+ * @description The pull request's head branch name as last recorded from GitHub, for
1295
+ * orientation only. Null when no pull request state is recorded.
1296
+ */
1297
+ head_ref?: string | null;
1298
+ /**
1299
+ * Format: uuid
1300
+ * @description The review's identifier.
1301
+ */
1302
+ id: string;
1303
+ /**
1304
+ * @description `PULL_REQUEST`, `DEPLOYMENT`, `PATCH`, a review of local changes
1305
+ * sent as a patch, or `COMMIT`, a review of pushed commits.
1306
+ */
1307
+ kind: string;
1308
+ /**
1309
+ * @description The deterministic policy for this exact repository/head, when opted in.
1310
+ * Its captured review owner and GitHub bypass remain separate history.
1311
+ */
1312
+ merge_gate?: components["schemas"]["PullRequestMergeGate"] | null;
1313
+ /**
1314
+ * @description What Proofline still has open for the reviewed head, counted from the
1315
+ * current finding decisions. Absent while the review is `PENDING` or
1316
+ * `RUNNING`.
1317
+ */
1318
+ open_items?: components["schemas"]["OpenItemsView"] | null;
1319
+ /**
1320
+ * @description Dated PR counts with head, evaluated-scope and bounded thread proof.
1321
+ * Absent when that observation is unavailable; scalar counts remain separate.
1322
+ */
1323
+ open_items_observation?: components["schemas"]["ReviewOpenItems"] | null;
1324
+ /** @description The review's stable public address: `rev_` followed by its identifier without hyphens. */
1325
+ public_key: string;
1326
+ /**
1327
+ * @description Whether the review reached the pull request: `PUBLISHED`, `WITHHELD`,
1328
+ * `PUBLICATION_REQUESTED` or `PUBLICATION_REFUSED`. A review run from
1329
+ * Proofline is withheld until somebody publishes it.
1330
+ */
1331
+ publication: string;
1332
+ /** @description Why a publication was refused, or how one failed. Server text. */
1333
+ publication_detail?: string | null;
1334
+ /**
1335
+ * @description Provider-supplied avatar URL. Login-derived `.png` URLs do not work for
1336
+ * GitHub App bot accounts and are not portable across GitHub hosts.
1337
+ */
1338
+ pull_request_author_avatar_url?: string | null;
1339
+ /**
1340
+ * Format: int64
1341
+ * @description The author's stable GitHub user id: identity for profile lookups,
1342
+ * never display text. Absent when GitHub named no author.
1343
+ */
1344
+ pull_request_author_github_user_id?: number | null;
1345
+ /** @description Provider display metadata for the pull request author, not the rerun requester. */
1346
+ pull_request_author_login?: string | null;
1347
+ /** @description The author's profile on the deployment's GitHub host. Absent when no author login is known. */
1348
+ pull_request_author_url?: string | null;
1349
+ /**
1350
+ * Format: int64
1351
+ * @description The pull request number. Absent for a deployment or patch review.
1352
+ */
1353
+ pull_request_number?: number | null;
1354
+ /**
1355
+ * @description Current provider state of the pull request: `OPEN`, `CLOSED`, or
1356
+ * `MERGED`. Absent for deployment reviews or a missing projection.
1357
+ */
1358
+ pull_request_state?: string | null;
1359
+ /**
1360
+ * @description The pull request's title as provider state last reported it, so it
1361
+ * names the change rather than only numbering it. Untrusted text:
1362
+ * renderers must treat it as text, never markup.
1363
+ */
1364
+ pull_request_title?: string | null;
1365
+ /** @description The pull request on GitHub. Absent for a deployment review or when the repository is unknown. */
1366
+ pull_request_url?: string | null;
1367
+ /**
1368
+ * @description Every other run for this pull request the caller can see, plus reviews
1369
+ * joined to this one by supersession or rerun.
1370
+ */
1371
+ related_reviews: components["schemas"]["RelatedReview"][];
1372
+ /** @description The repository's `owner/name`. Absent when the review names no repository. */
1373
+ repository_full_name?: string | null;
1374
+ /**
1375
+ * Format: uuid
1376
+ * @description The review's repository. Set only on a single-review read, and absent there when the review names no repository.
1377
+ */
1378
+ repository_id?: string | null;
1379
+ /** @description The repository's name within its owner. Absent when the review names no repository. */
1380
+ repository_name?: string | null;
1381
+ /**
1382
+ * @description The repository on GitHub. Absent when the deployment's web base
1383
+ * cannot be joined with the stored name.
1384
+ */
1385
+ repository_url?: string | null;
1386
+ /**
1387
+ * @description Who asked for this review, for a review a person requested. Null on
1388
+ * automatic reviews and on reviews recorded before requesters were.
1389
+ */
1390
+ requested_by?: components["schemas"]["ActorView"] | null;
1391
+ /**
1392
+ * @description The pull request review Proofline submitted for this review. Null when
1393
+ * it submitted none.
1394
+ */
1395
+ review_comment_url?: string | null;
1396
+ /**
1397
+ * Format: date-time
1398
+ * @description When a submitted pull request review was marked retracted, a marker
1399
+ * only older versions set. Null otherwise.
1400
+ */
1401
+ review_retracted_at?: string | null;
1402
+ /**
1403
+ * Format: int64
1404
+ * @description One-based, append-only ordinal within one repository pull request.
1405
+ */
1406
+ run_number?: number | null;
1407
+ /** @description The review's lifecycle status: `PENDING`, `RUNNING`, `COMPLETED`, `INCOMPLETE`, `FAILED`, `SUPERSEDED`, `STOPPED` or `EXCLUDED`. */
1408
+ status: string;
1409
+ /**
1410
+ * @description Whether the stop action applies: the review is `PENDING` or `RUNNING`
1411
+ * and decides no deployment gate. It says nothing about the caller's
1412
+ * permission.
1413
+ */
1414
+ stoppable: boolean;
1415
+ /**
1416
+ * Format: date-time
1417
+ * @description When the review was stopped. Null unless it was stopped.
1418
+ */
1419
+ stopped_at?: string | null;
1420
+ /**
1421
+ * @description Who stopped this review, for a `STOPPED` review whose stop recorded its
1422
+ * actor. Null otherwise.
1423
+ */
1424
+ stopped_by?: components["schemas"]["ActorView"] | null;
1425
+ /**
1426
+ * @description Where the review was stopped: `PROOFLINE` or `PULL_REQUEST`. Null unless
1427
+ * the stop recorded it.
1428
+ */
1429
+ stopped_from?: string | null;
1430
+ /**
1431
+ * @description What this review covers: the revision under review and any companion
1432
+ * repositories, workflow runs, artifacts or deployments.
1433
+ */
1434
+ subjects: components["schemas"]["SubjectView"][];
1435
+ /**
1436
+ * Format: uuid
1437
+ * @description The newer review that superseded this one. Null when none did or the
1438
+ * caller cannot see it.
1439
+ */
1440
+ superseded_by_review_id?: string | null;
1441
+ /**
1442
+ * @description Who asked for this review: `AUTOMATIC`, `COMMAND`, `RERUN`, `MANUAL`,
1443
+ * or `UNKNOWN` for a trigger key this build does not recognise.
1444
+ */
1445
+ trigger_origin: string;
1446
+ /**
1447
+ * @description The git hook that asked for this patch review: `HOOK_PRE_COMMIT` or
1448
+ * `HOOK_PRE_PUSH`. Null for any other review, and for a patch review
1449
+ * requested without naming a hook.
1450
+ */
1451
+ trigger_source?: components["schemas"]["PatchTriggerSource"] | null;
1452
+ };
1453
+ /** @enum {string} */
1454
+ Dataset: "reviews" | "finding_outcomes" | "finding_validations" | "spend" | "findings";
1455
+ DeepReviewEscalation: {
1456
+ /** @description A fixed customer explanation; internal admission errors are withheld. */
1457
+ reason: string;
1458
+ /**
1459
+ * @description Automatic Deep Review selection for this exact comparison: pending or
1460
+ * unavailable evidence, refused admission, admitted, or not selected.
1461
+ */
1462
+ status: components["schemas"]["DeepReviewEscalationStatus"];
1463
+ };
1464
+ /** @enum {string} */
1465
+ DeepReviewEscalationStatus: "UNEVALUATED" | "REFUSED" | "ADMITTED" | "NOT_SELECTED";
1466
+ DomainView: {
1467
+ /** @description The risk domain this evaluation covers. */
1468
+ domain: string;
1469
+ /** @description Why the domain was considered or skipped, as recorded with the evaluation. */
1470
+ reason: string;
1471
+ /** @description `CONSIDERED` or `SKIPPED`. */
1472
+ status: string;
1473
+ };
1474
+ /** @enum {string} */
1475
+ EvidenceView: "REQUIRED_PROPERTIES_ESTABLISHED" | "INCOMPLETE" | "NO_APPLICABLE_OBLIGATIONS";
1476
+ /** @enum {string} */
1477
+ ExportEvidenceKind: "repository_file" | "repository_file_at_commit" | "companion_repository_file" | "commit" | "workflow_run" | "world_entity" | "deterministic_test" | "recorded_read" | "text";
1478
+ ExportEvidenceRef: {
1479
+ /** @description Stable opaque occurrence-local identity, independent of evidence values. */
1480
+ id: string;
1481
+ /** @description The recorded reference kind, or `text` for a kind this export does not recognize. */
1482
+ kind: components["schemas"]["ExportEvidenceKind"];
1483
+ };
1484
+ /** @enum {string} */
1485
+ ExportFindingLifecycle: "NEW" | "UNCHANGED" | "RESOLVED" | "REINTRODUCED";
1486
+ /** @enum {string} */
1487
+ ExportFindingSeverity: "WARNING" | "SERIOUS";
1488
+ /** @enum {string} */
1489
+ ExportReviewKind: "PULL_REQUEST" | "DEPLOYMENT" | "PATCH" | "COMMIT";
1490
+ /** @enum {string} */
1491
+ ExportReviewStatus: "PENDING" | "RUNNING" | "COMPLETED" | "INCOMPLETE" | "FAILED" | "SUPERSEDED" | "STOPPED" | "EXCLUDED";
1492
+ /** @description The closed row vocabulary of the existing raw-stream export operation. */
1493
+ ExportRow: components["schemas"]["ReviewsExportRow"] | components["schemas"]["FindingOutcomesExportRow"] | components["schemas"]["FindingValidationsExportRow"] | components["schemas"]["SpendExportRow"] | components["schemas"]["FindingsExportRow"];
1494
+ /** @enum {string} */
1495
+ ExportValidation: "UNKNOWN" | "CONFIRMED" | "DISMISSED" | "FIXED" | "ACCEPTED_RISK" | "ALREADY_COVERED";
1496
+ /** @enum {string} */
1497
+ ExportValidationSource: "ui" | "github_comment" | "proofline";
1498
+ FileProjection: {
1499
+ /** @description The code-inspection depth retained by the plan. */
1500
+ depth: string;
1501
+ /** @description The review passes bound to this file. */
1502
+ passes: string[];
1503
+ /** @description Repository-relative path retained by the routing plan. */
1504
+ path: string;
1505
+ };
1506
+ FilterChoice: {
1507
+ /**
1508
+ * Format: uuid
1509
+ * @description The repository or environment ID to pass as the filter value.
1510
+ */
1511
+ id: string;
1512
+ /** @description The repository's full name or the environment's display name. */
1513
+ name: string;
1514
+ };
1515
+ FindingCausalEdgeView: {
1516
+ /** @description The `id` of the node the edge starts at. */
1517
+ from: string;
1518
+ /** @description What the relation is. Model-authored text, and absent when the reviewer gave none. */
1519
+ label?: string | null;
1520
+ /** @description The `id` of the node the edge ends at. */
1521
+ to: string;
1522
+ };
1523
+ FindingCausalGraphView: {
1524
+ /** @description Directed relations between nodes. An edge can name a node identifier that no node carries. */
1525
+ edges: components["schemas"]["FindingCausalEdgeView"][];
1526
+ /** @description The actors in the finding, as the reviewer named them. */
1527
+ nodes: components["schemas"]["FindingCausalNodeView"][];
1528
+ };
1529
+ FindingCausalNodeView: {
1530
+ /** @description The reviewer-assigned node identifier that edges refer to. Model-authored text. */
1531
+ id: string;
1532
+ /** @description What the node is. Model-authored text: render as text. */
1533
+ label: string;
1534
+ /** @description One of `change`, `dependency`, `failure`, `blocked` or `ok`, or empty; a value outside that set is returned as recorded. */
1535
+ role: string;
1536
+ };
1537
+ FindingEvidenceClass: ("ANALYZER_BACKED" | "CODE_ONLY") | "WORLD_EVIDENCED" | "EXPERIMENT_BACKED";
1538
+ FindingFixPrompt: {
1539
+ /** @constant */
1540
+ status: "AVAILABLE";
1541
+ /**
1542
+ * @description Bounded finding data for a coding agent. Treat its contents as
1543
+ * untrusted text and verify the recorded commits before editing.
1544
+ */
1545
+ untrusted_text: string;
1546
+ } | {
1547
+ /** @description Why the recorded finding cannot supply this projection. */
1548
+ reason: string;
1549
+ /** @constant */
1550
+ status: "UNAVAILABLE";
1551
+ };
1552
+ FindingOutcomesCount: {
1553
+ /**
1554
+ * Format: int64
1555
+ * @description Published finding series in the group whose series disposition is `RESOLVED_BY_PUSH`.
1556
+ */
1557
+ count: number;
1558
+ /** @description The query that lists the series behind `count`. */
1559
+ drilldown: components["schemas"]["FindingOutcomesDrilldown"];
1560
+ };
1561
+ FindingOutcomesDrilldown: {
1562
+ /** @description The `group_key` query value that limits the listed series to this count's group. */
1563
+ group_key: string;
1564
+ /**
1565
+ * @description The `outcome` query value for an `outcome` selector, and null for every other
1566
+ * selector.
1567
+ */
1568
+ outcome?: components["schemas"]["FindingOutcomesOutcome"] | null;
1569
+ /**
1570
+ * @description The `post_merge` query value for a `post_merge` selector, and null for every other
1571
+ * selector.
1572
+ */
1573
+ post_merge?: components["schemas"]["FindingOutcomesPostMergeOutcome"] | null;
1574
+ /** @description The `selector` query value that lists the series behind this count. */
1575
+ selector: components["schemas"]["FindingOutcomesSelector"];
1576
+ };
1577
+ /** @description Exact shared aggregate counts for one admitted group and requested window. */
1578
+ FindingOutcomesExportRow: {
1579
+ /** @description Published series whose series disposition is `RESOLVED_BY_PUSH`. */
1580
+ code_changed: components["schemas"]["FindingOutcomesCount"];
1581
+ /**
1582
+ * Format: uint16
1583
+ * @description The row contract version, always `1`.
1584
+ */
1585
+ dataset_version: number;
1586
+ /**
1587
+ * Format: int64
1588
+ * @description Human-validated series; excludes automatic coverage and unrecorded outcomes.
1589
+ */
1590
+ external_validation_denominator: number;
1591
+ /**
1592
+ * Format: date-time
1593
+ * @description The inclusive start of the requested first-publication window.
1594
+ */
1595
+ from: string;
1596
+ /** @description The dimension that defines this row's group. */
1597
+ group_by: components["schemas"]["FindingOutcomesGroupBy"];
1598
+ /**
1599
+ * @description The grouping value: a repository or environment ID, a risk domain, a severity or a
1600
+ * review kind, as `group_by` selects.
1601
+ */
1602
+ key: string;
1603
+ /**
1604
+ * @description Gaps in publication history that keep findings outside these counts; they mean
1605
+ * missing history, not zero findings.
1606
+ */
1607
+ limitations: string[];
1608
+ /**
1609
+ * @description The group's display name: the repository's full name (or `Repository` and its ID when
1610
+ * no name is recorded), the environment's display name, or otherwise `key`.
1611
+ */
1612
+ name: string;
1613
+ /**
1614
+ * Format: uuid
1615
+ * @description The organization whose findings are counted.
1616
+ */
1617
+ organization_id: string;
1618
+ /** @description One count per outcome, always all six `FindingOutcomesOutcome` values in a fixed order. */
1619
+ outcomes: components["schemas"]["FindingOutcomesOutcomeCount"][];
1620
+ /** @description Published series counted by their latest post-merge comment-address evaluation. */
1621
+ post_merge: components["schemas"]["FindingOutcomesPostMergeCounts"];
1622
+ /**
1623
+ * Format: int64
1624
+ * @description Finding series in the group whose first publication falls inside the window.
1625
+ */
1626
+ published: number;
1627
+ /**
1628
+ * Format: date-time
1629
+ * @description The exclusive end of the requested first-publication window.
1630
+ */
1631
+ to: string;
1632
+ };
1633
+ /** @enum {string} */
1634
+ FindingOutcomesGroupBy: "repository" | "environment" | "risk_domain" | "severity" | "subject_kind";
1635
+ /** @enum {string} */
1636
+ FindingOutcomesOutcome: "FIXED" | "CONFIRMED" | "ACCEPTED_RISK" | "DISMISSED" | "ALREADY_COVERED" | "NO_RECORDED_OUTCOME";
1637
+ FindingOutcomesOutcomeCount: {
1638
+ /**
1639
+ * Format: int64
1640
+ * @description Published finding series in the group whose latest qualifying outcome is `outcome`.
1641
+ */
1642
+ count: number;
1643
+ /** @description The query that lists the series behind `count`. */
1644
+ drilldown: components["schemas"]["FindingOutcomesDrilldown"];
1645
+ /**
1646
+ * @description The outcome counted, where `NO_RECORDED_OUTCOME` means the series has no qualifying
1647
+ * validation.
1648
+ */
1649
+ outcome: components["schemas"]["FindingOutcomesOutcome"];
1650
+ /**
1651
+ * @description `count` split by where the outcome was recorded; a `NO_RECORDED_OUTCOME` count has no
1652
+ * source.
1653
+ */
1654
+ validation_sources: components["schemas"]["FindingOutcomesValidationSources"];
1655
+ };
1656
+ FindingOutcomesPostMergeCount: {
1657
+ /**
1658
+ * Format: int64
1659
+ * @description Published finding series in the group whose latest evaluation recorded `outcome`.
1660
+ */
1661
+ count: number;
1662
+ /** @description The query that lists the series behind `count`. */
1663
+ drilldown: components["schemas"]["FindingOutcomesDrilldown"];
1664
+ /** @description The outcome of the series' latest comment-address evaluation. */
1665
+ outcome: components["schemas"]["FindingOutcomesPostMergeOutcome"];
1666
+ };
1667
+ FindingOutcomesPostMergeCounts: {
1668
+ /**
1669
+ * Format: int64
1670
+ * @description Series with a retained evaluation, rather than all published series.
1671
+ */
1672
+ judged: number;
1673
+ /**
1674
+ * @description One count per post-merge outcome, always `ADDRESSED`, `NOT_ADDRESSED` and `INCOMPLETE`
1675
+ * in that order.
1676
+ */
1677
+ outcomes: components["schemas"]["FindingOutcomesPostMergeCount"][];
1678
+ };
1679
+ /** @enum {string} */
1680
+ FindingOutcomesPostMergeOutcome: "ADDRESSED" | "NOT_ADDRESSED" | "INCOMPLETE";
1681
+ /** @enum {string} */
1682
+ FindingOutcomesSelector: "outcome" | "code_changed" | "post_merge";
1683
+ FindingOutcomesValidationSources: {
1684
+ /**
1685
+ * Format: int64
1686
+ * @description Series whose outcome comes from a validation recorded in the console.
1687
+ */
1688
+ console: number;
1689
+ /**
1690
+ * Format: int64
1691
+ * @description Series whose outcome comes from a validation recorded by a GitHub comment reply.
1692
+ */
1693
+ github_reply: number;
1694
+ /**
1695
+ * Format: int64
1696
+ * @description Series whose outcome is `ALREADY_COVERED`, recorded by Proofline itself.
1697
+ */
1698
+ proofline: number;
1699
+ };
1700
+ /**
1701
+ * @description Where the comment gate placed a finding. The placement is what the gate
1702
+ * decided, not proof that a comment was posted.
1703
+ */
1704
+ FindingPlacement: "INLINE" | "CHECK_ONLY" | "WITHHELD";
1705
+ FindingPlacementView: {
1706
+ /** @description The recorded placement. */
1707
+ placement: components["schemas"]["FindingPlacement"];
1708
+ /** @description Why the finding has this placement, in Proofline's own words. */
1709
+ reason: string;
1710
+ };
1711
+ FindingPromotionView: {
1712
+ /**
1713
+ * Format: date-time
1714
+ * @description When the immutable human override was requested.
1715
+ */
1716
+ created_at: string;
1717
+ /** @description Provider refusal, when publication could not proceed. */
1718
+ detail?: string | null;
1719
+ /** @description Display metadata for the person who requested the override. */
1720
+ promoted_by_login: string;
1721
+ /** @description Recorded publication state of the human override. */
1722
+ status: string;
1723
+ };
1724
+ /**
1725
+ * @description One review rule a finding cites. It carries no rule text and no scope
1726
+ * identifier; the review rules page shows those to its readers.
1727
+ */
1728
+ FindingRuleRefView: {
1729
+ /** @description The rule key. */
1730
+ key: string;
1731
+ /**
1732
+ * @description The layers of the key the assessment showed the reviewer, in
1733
+ * precedence order. A team rule is a layer over the key for the files it
1734
+ * matches.
1735
+ */
1736
+ revisions: components["schemas"]["FindingRuleRevisionView"][];
1737
+ };
1738
+ FindingRuleRevisionView: {
1739
+ /**
1740
+ * Format: int32
1741
+ * @description The console revision. Null for a configuration-file or implicit rule.
1742
+ */
1743
+ revision?: number | null;
1744
+ /** @description `ORGANIZATION`, `ENVIRONMENT`, `TEAM` or `REPOSITORY`. */
1745
+ scope: string;
1746
+ /**
1747
+ * @description Where the rule came from: the console, the repository's
1748
+ * configuration file, or the implicit repository and environment
1749
+ * guidance.
1750
+ */
1751
+ source: components["schemas"]["RuleSource"];
1752
+ };
1753
+ FindingSupport: {
1754
+ /** @description The references the hypothesis cites for its verdict. */
1755
+ evidence_refs: components["schemas"]["CustomerEvidenceRef"][];
1756
+ /**
1757
+ * @description Why the hypothesis reached its verdict, as recorded at resolution. Null
1758
+ * when no explanation is recorded.
1759
+ */
1760
+ explanation?: components["schemas"]["UntrustedText"] | null;
1761
+ };
1762
+ /**
1763
+ * @description One append-only validation, including its recorded actor display metadata.
1764
+ * Missing historical actors stay absent; the export does not infer identity.
1765
+ */
1766
+ FindingValidationsExportRow: {
1767
+ /**
1768
+ * Format: int64
1769
+ * @description The GitHub user ID captured as the actor, null when none was captured.
1770
+ */
1771
+ actor_github_user_id?: number | null;
1772
+ /**
1773
+ * @description The GitHub login captured as display metadata at validation time, null when none was
1774
+ * captured.
1775
+ */
1776
+ actor_login?: string | null;
1777
+ /**
1778
+ * Format: uuid
1779
+ * @description The Proofline user captured as the actor, null when none was captured.
1780
+ */
1781
+ actor_user_id?: string | null;
1782
+ /**
1783
+ * Format: date-time
1784
+ * @description When the validation was recorded; the export window filters on this time.
1785
+ */
1786
+ created_at: string;
1787
+ /**
1788
+ * Format: uint16
1789
+ * @description The row contract version, always `1`.
1790
+ */
1791
+ dataset_version: number;
1792
+ /**
1793
+ * Format: uuid
1794
+ * @description The environment of the assessment that recorded the finding.
1795
+ */
1796
+ environment_id: string;
1797
+ /**
1798
+ * Format: date-time
1799
+ * @description When the decision expires, null when it records no expiry.
1800
+ */
1801
+ expires_at?: string | null;
1802
+ /**
1803
+ * Format: uuid
1804
+ * @description The finding occurrence the validation applies to.
1805
+ */
1806
+ finding_id: string;
1807
+ /**
1808
+ * Format: uuid
1809
+ * @description The organization that owns the finding.
1810
+ */
1811
+ organization_id: string;
1812
+ /**
1813
+ * Format: uuid
1814
+ * @description The review's primary repository, null when the review records none.
1815
+ */
1816
+ repository_id?: string | null;
1817
+ /**
1818
+ * Format: uuid
1819
+ * @description The review whose assessment recorded the finding.
1820
+ */
1821
+ review_id: string;
1822
+ /**
1823
+ * @description Where the decision was recorded: `ui` or `github_comment` for a person, `proofline` for
1824
+ * automatic coverage.
1825
+ */
1826
+ source: components["schemas"]["ExportValidationSource"];
1827
+ /** @description The recorded decision, including legacy `UNKNOWN` values. */
1828
+ validation: components["schemas"]["ExportValidation"];
1829
+ /**
1830
+ * Format: uuid
1831
+ * @description The stable ID of this validation record.
1832
+ */
1833
+ validation_id: string;
1834
+ };
1835
+ /** @description One immutable finding occurrence. Reference payloads and evidence values stay private. */
1836
+ FindingsExportRow: {
1837
+ /**
1838
+ * Format: uuid
1839
+ * @description The environment assessment that recorded the finding.
1840
+ */
1841
+ assessment_id: string;
1842
+ /** @description The finding's claim, with supported credential shapes masked as `<REDACTED:kind>`. */
1843
+ claim: string;
1844
+ /**
1845
+ * Format: date-time
1846
+ * @description When the finding was recorded; the export window filters on this time.
1847
+ */
1848
+ created_at: string;
1849
+ /**
1850
+ * Format: uint16
1851
+ * @description The row contract version, always `1`.
1852
+ */
1853
+ dataset_version: number;
1854
+ /**
1855
+ * Format: uuid
1856
+ * @description The environment the assessment covers.
1857
+ */
1858
+ environment_id: string;
1859
+ /**
1860
+ * @description The finding's evidence references in recorded order, each reduced to a kind and an
1861
+ * opaque ID; an empty list means the finding records none.
1862
+ */
1863
+ evidence_refs: components["schemas"]["ExportEvidenceRef"][];
1864
+ /**
1865
+ * Format: uuid
1866
+ * @description The stable ID of this finding occurrence.
1867
+ */
1868
+ finding_id: string;
1869
+ /** @description The finding's stated impact, with supported credential shapes masked. */
1870
+ impact: string;
1871
+ /** @description The occurrence's recorded lifecycle state relative to earlier occurrences. */
1872
+ lifecycle_state: components["schemas"]["ExportFindingLifecycle"];
1873
+ /**
1874
+ * Format: uuid
1875
+ * @description The organization that owns the finding.
1876
+ */
1877
+ organization_id: string;
1878
+ /** @description The suggested remediation with credential shapes masked, null when none is recorded. */
1879
+ remediation?: string | null;
1880
+ /**
1881
+ * Format: uuid
1882
+ * @description The review's primary repository, null when the review records none.
1883
+ */
1884
+ repository_id?: string | null;
1885
+ /**
1886
+ * Format: uuid
1887
+ * @description The review whose assessment recorded the finding.
1888
+ */
1889
+ review_id: string;
1890
+ /** @description The risk domain the finding is recorded under. */
1891
+ risk_domain: string;
1892
+ /**
1893
+ * Format: uuid
1894
+ * @description The finding series this occurrence belongs to, null when it belongs to none.
1895
+ */
1896
+ series_id?: string | null;
1897
+ /** @description The finding's recorded severity. */
1898
+ severity: components["schemas"]["ExportFindingSeverity"];
1899
+ };
1900
+ GateState: {
1901
+ /** @description Recorded override authorization, not confirmation of provider delivery. */
1902
+ override_record?: components["schemas"]["Override"] | null;
1903
+ /**
1904
+ * @description Local gate state. ALLOWED/BLOCKED can precede provider delivery.
1905
+ * This field does not confirm that GitHub released or blocked a run.
1906
+ */
1907
+ status: string;
1908
+ };
1909
+ /** @enum {string} */
1910
+ GateStatus: "REQUESTED" | "EVALUATING" | "ALLOWED" | "BLOCKED" | "BYPASSED" | "SUPERSEDED";
1911
+ NotAssessedView: {
1912
+ /**
1913
+ * @description The display name of the environment whose assessment is not
1914
+ * `COMPLETED`.
1915
+ */
1916
+ environment_display_name: string;
1917
+ /**
1918
+ * @description The assessment's recorded gap class. Absent is an unclassified gap,
1919
+ * never a complete assessment.
1920
+ */
1921
+ incompleteness_kind?: string | null;
1922
+ };
1923
+ OpenFindingCounts: {
1924
+ /**
1925
+ * Format: uint64
1926
+ * @description Finding series with `SERIOUS` severity that are unresolved and not
1927
+ * under an unexpired dismissal or risk acceptance.
1928
+ */
1929
+ serious: number;
1930
+ /**
1931
+ * Format: uint64
1932
+ * @description Finding series with `WARNING` severity that are unresolved and not
1933
+ * under an unexpired dismissal or risk acceptance.
1934
+ */
1935
+ warning: number;
1936
+ };
1937
+ OpenItemEnvironment: {
1938
+ /** @description The environment's display name. */
1939
+ display_name: string;
1940
+ /**
1941
+ * Format: uuid
1942
+ * @description The environment whose assessment is not complete.
1943
+ */
1944
+ environment_id: string;
1945
+ /**
1946
+ * @description Why the assessment is not complete, derived from its status and
1947
+ * recorded gap class; `UNKNOWN` when neither names a cause.
1948
+ */
1949
+ reason: components["schemas"]["OpenItemsGapReason"];
1950
+ /** @description The assessment's recorded status. */
1951
+ status: components["schemas"]["OpenItemsReviewStatus"];
1952
+ };
1953
+ /** @enum {string} */
1954
+ OpenItemsGapReason: "NOT_STARTED" | "IN_PROGRESS" | "NOT_CONFIGURED" | "POLICY_EXCLUDED" | "EVIDENCE_UNAVAILABLE" | "HYPOTHESES_UNRESOLVED" | "MODEL_BUDGET_EXHAUSTED" | "FAILED" | "STOPPED" | "UNKNOWN";
1955
+ /** @enum {string} */
1956
+ OpenItemsHeadState: "CURRENT" | "OUTDATED" | "UNKNOWN";
1957
+ /** @enum {string} */
1958
+ OpenItemsReviewStatus: "PENDING" | "RUNNING" | "COMPLETED" | "INCOMPLETE" | "FAILED" | "SUPERSEDED" | "STOPPED" | "EXCLUDED" | "UNKNOWN";
1959
+ /** @enum {string} */
1960
+ OpenItemsThreadUnknown: "GITHUB_UNAVAILABLE" | "READ_LIMIT_EXCEEDED" | "TRUNCATED" | "RECORDED_THREAD_MISSING" | "REPOSITORY_UNAVAILABLE";
1961
+ OpenItemsThreads: {
1962
+ /** Format: date-time */
1963
+ observed_at: string;
1964
+ /** @constant */
1965
+ status: "KNOWN";
1966
+ /** Format: uint64 */
1967
+ unresolved_count: number;
1968
+ /** @description Root comment URLs for the unresolved Proofline threads in this observation. */
1969
+ unresolved_urls?: string[];
1970
+ } | {
1971
+ reason: components["schemas"]["OpenItemsThreadUnknown"];
1972
+ /** @constant */
1973
+ status: "UNKNOWN";
1974
+ };
1975
+ /**
1976
+ * @description Recorded unresolved findings, accepted risks and assessment gaps.
1977
+ * Coverage and notification suppression do not resolve a finding. These
1978
+ * scalar counts make no claim about current heads, evaluated scope or threads.
1979
+ */
1980
+ OpenItemsView: {
1981
+ /**
1982
+ * Format: uint
1983
+ * @description Finding series whose current decision is an unexpired `ACCEPTED_RISK`.
1984
+ */
1985
+ accepted_risks: number;
1986
+ /** @description Recorded assessment gaps, including explicit policy exclusions. */
1987
+ not_assessed: components["schemas"]["NotAssessedView"][];
1988
+ /**
1989
+ * Format: uint
1990
+ * @description Unresolved recorded finding series, including notification-suppressed
1991
+ * findings, decisions whose dismissal or risk acceptance expired, and
1992
+ * earlier published series of the pull request that this review did not
1993
+ * find again.
1994
+ */
1995
+ open_findings: number;
1996
+ /**
1997
+ * Format: uint
1998
+ * @description The `SERIOUS` findings among `open_findings`.
1999
+ */
2000
+ serious_findings: number;
2001
+ };
2002
+ /** @enum {string} */
2003
+ Outcome: "ALLOW" | "BLOCK";
2004
+ Override: {
2005
+ /**
2006
+ * @description The comment recorded with the approval, truncated past 8000
2007
+ * characters.
2008
+ */
2009
+ comment?: string | null;
2010
+ /**
2011
+ * Format: int64
2012
+ * @description The GitHub environment ID the approval applied to.
2013
+ */
2014
+ github_environment_id: number;
2015
+ /**
2016
+ * Format: int64
2017
+ * @description The GitHub user ID of the person whose GitHub deployment approval
2018
+ * overrode the gate.
2019
+ */
2020
+ github_user_id: number;
2021
+ /**
2022
+ * @description That person's GitHub login as recorded with the approval, a display
2023
+ * label truncated past 128 characters.
2024
+ */
2025
+ github_user_login: string;
2026
+ };
2027
+ PassProjection: {
2028
+ /** @description Symbolic configuration binding, not a historical model identity. */
2029
+ model_binding: string;
2030
+ /** @description Pass name from the closed routing schema. */
2031
+ name: string;
2032
+ };
2033
+ /** @description Local changes to review: a unified diff against a commit GitHub has. */
2034
+ PatchReviewRequest: {
2035
+ /**
2036
+ * @description The full 40-character commit the patch applies to. GitHub must have
2037
+ * it in this repository.
2038
+ */
2039
+ base_commit_sha: string;
2040
+ /**
2041
+ * @description The changes as `git diff --no-ext-diff --no-color <base>` prints them,
2042
+ * at most 5 MiB and 3000 files. Text changes only: binary changes,
2043
+ * symbolic links and submodules are refused.
2044
+ */
2045
+ patch: string;
2046
+ /**
2047
+ * @description The git hook that sent this request, when one did. A review recorded
2048
+ * by an earlier identical request keeps the source it recorded.
2049
+ * @default null
2050
+ */
2051
+ trigger_source: components["schemas"]["PatchTriggerSource"] | null;
2052
+ };
2053
+ /** @description What a patch review request produced. */
2054
+ PatchReviewResponse: {
2055
+ /**
2056
+ * @description True when this patch on this base already had a review and that one
2057
+ * is returned. Sending the same patch twice reviews it once.
2058
+ */
2059
+ existing: boolean;
2060
+ /**
2061
+ * @description SHA-256 of the canonical patch, the identity the review pins with
2062
+ * the repository and base commit.
2063
+ */
2064
+ patch_digest: string;
2065
+ /**
2066
+ * Format: uuid
2067
+ * @description The review of this patch on this base, readable through the review
2068
+ * and findings routes.
2069
+ */
2070
+ review_id: string;
2071
+ };
2072
+ /**
2073
+ * @description The git hook that asked for a patch review. The client declares it; it is
2074
+ * provenance for the reader, never an authority.
2075
+ * @enum {string}
2076
+ */
2077
+ PatchTriggerSource: "HOOK_PRE_COMMIT" | "HOOK_PRE_PUSH";
2078
+ /** @enum {string} */
2079
+ PermissionView: "PERMIT" | "BLOCK";
2080
+ PlanProjection: {
2081
+ /** @description Environment assessment bindings recorded in the plan. */
2082
+ assessments: components["schemas"]["AssessmentProjection"][];
2083
+ /** @description Base commit pinned by the change digest. */
2084
+ base_sha: string;
2085
+ /** @description Digest of the exact retained change input. */
2086
+ change_digest_sha256: string;
2087
+ /** @description Safe codes for fallback causes. Unrecognized values are never echoed. */
2088
+ fallback_causes: string[];
2089
+ /** @description File routing facts recorded in the plan. */
2090
+ files: components["schemas"]["FileProjection"][];
2091
+ /** @description Head commit pinned by the change digest. */
2092
+ head_sha: string;
2093
+ /**
2094
+ * Format: uuid
2095
+ * @description Repository named by the validated immutable plan.
2096
+ */
2097
+ repository_id: string;
2098
+ };
2099
+ /**
2100
+ * Problem
2101
+ * @description RFC 9457 problem-details body. `type` is omitted and therefore
2102
+ * `about:blank`: the `title`/`detail` pair carries the meaning.
2103
+ */
2104
+ Problem: {
2105
+ /**
2106
+ * @description A caller-safe explanation of this occurrence, absent when the cause is an internal
2107
+ * error that is logged rather than returned.
2108
+ */
2109
+ detail?: string | null;
2110
+ /**
2111
+ * Format: uint16
2112
+ * @description The HTTP status code of the response that carries this body.
2113
+ */
2114
+ status: number;
2115
+ /** @description A short, stable summary of the problem class, such as `not found` or `conflict`. */
2116
+ title: string;
2117
+ };
2118
+ PullRequestMergeGate: {
2119
+ /**
2120
+ * Format: int32
2121
+ * @description The number of environment assessments counted by the recorded decision. Null before a decision.
2122
+ */
2123
+ assessment_count?: number | null;
2124
+ /** @description The frozen blocking threshold, either SERIOUS or WARNING; later settings do not restamp it. */
2125
+ blocking_severity: string;
2126
+ /**
2127
+ * Format: date-time
2128
+ * @description When the bypass receipt was recorded. Null when this gate has no recorded bypass.
2129
+ */
2130
+ bypassed_at?: string | null;
2131
+ /** @description The digest of the deterministic coverage used by the decision, or null when no digest was recorded. */
2132
+ coverage_digest?: string | null;
2133
+ /**
2134
+ * Format: date-time
2135
+ * @description When the immutable decision was recorded. Null before a decision.
2136
+ */
2137
+ decided_at?: string | null;
2138
+ /** @description The immutable ALLOW or BLOCK decision. Null until a decision is recorded. */
2139
+ decision?: components["schemas"]["Outcome"] | null;
2140
+ /**
2141
+ * Format: int32
2142
+ * @description The number of blocking findings counted by the recorded decision. Null before a decision.
2143
+ */
2144
+ finding_count?: number | null;
2145
+ /** @description The exact lowercase commit SHA whose captured policy this gate evaluates. */
2146
+ head_sha: string;
2147
+ /**
2148
+ * Format: uuid
2149
+ * @description The immutable identity of the gate captured for this tenant, repository and head.
2150
+ */
2151
+ id: string;
2152
+ /** @description The exact merge commit reported by GitHub for the bypass, or null when none was reported. */
2153
+ merge_commit_sha?: string | null;
2154
+ /**
2155
+ * Format: int64
2156
+ * @description The stable GitHub user ID reported by a merged-close bypass, or null when none was reported.
2157
+ */
2158
+ merged_by_github_user_id?: number | null;
2159
+ /**
2160
+ * Format: int64
2161
+ * @description The actual pull request merged in the recorded bypass, which may differ from the captured PR.
2162
+ */
2163
+ merged_pull_request_number?: number | null;
2164
+ /** @description The deterministic policy version frozen when this gate was captured. */
2165
+ policy_version: string;
2166
+ /**
2167
+ * Format: int64
2168
+ * @description The first pull request that captured this head's gate; a shared-head merge may name another PR.
2169
+ */
2170
+ pull_request_number: number;
2171
+ /** @description The recorded deterministic decision or refusal reason. Null until a decision is recorded. */
2172
+ reason_code?: string | null;
2173
+ /**
2174
+ * Format: uuid
2175
+ * @description The first review captured for this gate. Null when its trigger was refused before a review existed.
2176
+ */
2177
+ review_id?: string | null;
2178
+ /** @description The current gate projection, including a recorded bypass or supersession by a newer head. */
2179
+ status: components["schemas"]["GateStatus"];
2180
+ };
2181
+ /**
2182
+ * @description An environment a refusal names. `external_key` is how its pages are
2183
+ * addressed.
2184
+ */
2185
+ RefusedEnvironment: {
2186
+ /** @description The environment's display name. Tenant free text: render as text. */
2187
+ display_name: string;
2188
+ /** @description The environment's stable machine key, unique within the organization. */
2189
+ external_key: string;
2190
+ /**
2191
+ * Format: uuid
2192
+ * @description The environment's identifier.
2193
+ */
2194
+ id: string;
2195
+ /** @description The environment's lifecycle status, such as `READY`. */
2196
+ status: string;
2197
+ };
2198
+ RelatedReview: {
2199
+ /**
2200
+ * Format: date-time
2201
+ * @description When the related review was created.
2202
+ */
2203
+ created_at: string;
2204
+ /** @description The head commit the related review is pinned to. Absent when it recorded none. */
2205
+ head_commit_sha?: string | null;
2206
+ /** @description The related review's stable public address. */
2207
+ public_key: string;
2208
+ /**
2209
+ * @description A direct lineage relation, `EARLIER_RUN` / `LATER_RUN` when the two
2210
+ * reviews share a pull request without a direct lineage edge, or
2211
+ * `LOCAL_REVIEW` for the pull request author's local review of exactly
2212
+ * the same change.
2213
+ */
2214
+ relation: string;
2215
+ /**
2216
+ * Format: uuid
2217
+ * @description The related review's identifier.
2218
+ */
2219
+ review_id: string;
2220
+ /**
2221
+ * Format: int64
2222
+ * @description The related review's one-based ordinal within its pull request. Absent for a review that is not of a pull request.
2223
+ */
2224
+ run_number?: number | null;
2225
+ /** @description The related review's lifecycle status. */
2226
+ status: string;
2227
+ };
2228
+ RepositoryGuidance: {
2229
+ /** @description The repository-specific reviewer guidance new reviews snapshot, null when none is set. */
2230
+ additional_prompt?: string | null;
2231
+ /**
2232
+ * Format: uuid
2233
+ * @description The repository's stable Proofline ID.
2234
+ */
2235
+ repository_id: string;
2236
+ };
2237
+ RepositoryName: {
2238
+ /**
2239
+ * @description The provider's `owner/name`. Display metadata: it can change on a
2240
+ * rename, so callers keep `id`.
2241
+ */
2242
+ full_name: string;
2243
+ /**
2244
+ * Format: uuid
2245
+ * @description The repository's stable Proofline ID.
2246
+ */
2247
+ id: string;
2248
+ };
2249
+ RepositoryNames: {
2250
+ /**
2251
+ * @description The organization's repositories that are not deleted, ordered by name; a
2252
+ * repository-restricted token sees only its allowlist.
2253
+ */
2254
+ repositories: components["schemas"]["RepositoryName"][];
2255
+ };
2256
+ /**
2257
+ * @description Manual rerun: a new review of the same immutable subjects, under a fresh
2258
+ * trigger key so history accumulates instead of overwriting.
2259
+ */
2260
+ RerunResponse: {
2261
+ /** @description The new review's stable public address. */
2262
+ public_key: string;
2263
+ /**
2264
+ * Format: int64
2265
+ * @description The pull request number. Absent for a deployment review.
2266
+ */
2267
+ pull_request_number?: number | null;
2268
+ /** @description The repository's name within its owner. Absent when the original review names no repository. */
2269
+ repository_name?: string | null;
2270
+ /**
2271
+ * Format: uuid
2272
+ * @description The new review's identifier.
2273
+ */
2274
+ review_id: string;
2275
+ /**
2276
+ * Format: int64
2277
+ * @description The new review's one-based ordinal within its pull request. Absent for a deployment review.
2278
+ */
2279
+ run_number?: number | null;
2280
+ };
2281
+ ReviewActions: {
2282
+ /** @description Whether a browser caller may request publication of a routed finding. */
2283
+ promote_findings: boolean;
2284
+ /**
2285
+ * @description Whether the caller may publish this pull request review's withheld
2286
+ * results, which requires a browser session and repository write access.
2287
+ */
2288
+ publish: boolean;
2289
+ /** @description Whether the caller may rerun this review. */
2290
+ rerun: boolean;
2291
+ /** @description Whether the caller may stop this review from a browser session. */
2292
+ stop: boolean;
2293
+ /**
2294
+ * @description Why an action is unavailable, when a permission or repository check
2295
+ * denied it. Null when no check denied one, which does not mean every
2296
+ * action is allowed.
2297
+ */
2298
+ unavailable_reason?: components["schemas"]["ActionUnavailability"] | null;
2299
+ /**
2300
+ * @description Whether the caller may record decisions on findings from a browser
2301
+ * session.
2302
+ */
2303
+ validate_findings: boolean;
2304
+ };
2305
+ ReviewDiffStats: {
2306
+ /**
2307
+ * Format: int64
2308
+ * @description Lines added across every changed file in the pinned comparison.
2309
+ */
2310
+ additions: number;
2311
+ /**
2312
+ * Format: int64
2313
+ * @description Lines deleted across every changed file in the pinned comparison.
2314
+ */
2315
+ deletions: number;
2316
+ };
2317
+ ReviewFilters: {
2318
+ /** @description Authors of visible pull request reviews, one per GitHub user. */
2319
+ authors: components["schemas"]["AuthorChoice"][];
2320
+ /**
2321
+ * @description Environments assessed by at least one visible review, ordered by
2322
+ * display name.
2323
+ */
2324
+ environments: components["schemas"]["FilterChoice"][];
2325
+ /**
2326
+ * @description Repositories that have at least one visible review, ordered by full
2327
+ * name.
2328
+ */
2329
+ repositories: components["schemas"]["FilterChoice"][];
2330
+ };
2331
+ ReviewOpenItems: {
2332
+ /**
2333
+ * Format: uint64
2334
+ * @description Finding series whose current decision is an unexpired `ACCEPTED_RISK`.
2335
+ */
2336
+ accepted_risk_count: number;
2337
+ /**
2338
+ * Format: date-time
2339
+ * @description GitHub's update time for the recorded pull request state that
2340
+ * `current_head_sha` comes from. Null when none is recorded.
2341
+ */
2342
+ current_head_provider_updated_at?: string | null;
2343
+ /**
2344
+ * @description The pull request's head commit as Proofline last recorded it from
2345
+ * GitHub. Null when no pull request state is recorded.
2346
+ */
2347
+ current_head_sha?: string | null;
2348
+ /**
2349
+ * @description This review's environment assessments that are not `COMPLETED`, ordered
2350
+ * by environment key.
2351
+ */
2352
+ environments: components["schemas"]["OpenItemEnvironment"][];
2353
+ /**
2354
+ * @description Whether the review recorded at least one environment assessment. False
2355
+ * means the evaluated scope is unknown, so an empty `environments` proves
2356
+ * nothing.
2357
+ */
2358
+ evaluated_scope_known: boolean;
2359
+ /**
2360
+ * @description Whether `reviewed_head_sha` matches `current_head_sha`; `UNKNOWN` when
2361
+ * either is missing.
2362
+ */
2363
+ head_state: components["schemas"]["OpenItemsHeadState"];
2364
+ /**
2365
+ * @description Whether this review is the newest review of its pull request the caller
2366
+ * can see.
2367
+ */
2368
+ is_latest_review: boolean;
2369
+ /**
2370
+ * @description The head commit of the newest review of this pull request the caller
2371
+ * can see. Null when that review recorded none.
2372
+ */
2373
+ latest_review_head_sha?: string | null;
2374
+ /**
2375
+ * @description Whether `latest_review_head_sha` matches `current_head_sha`; `UNKNOWN`
2376
+ * when either is missing.
2377
+ */
2378
+ latest_review_head_state: components["schemas"]["OpenItemsHeadState"];
2379
+ /**
2380
+ * Format: date-time
2381
+ * @description When the database facts in this observation were read, all from one
2382
+ * statement.
2383
+ */
2384
+ observed_at: string;
2385
+ /**
2386
+ * @description Unresolved finding series that still demand attention, by severity:
2387
+ * this review's own, and earlier published series of the pull request
2388
+ * that this review did not find again.
2389
+ */
2390
+ open_findings: components["schemas"]["OpenFindingCounts"];
2391
+ /**
2392
+ * @description This review's recorded status; `UNKNOWN` for a status this build does
2393
+ * not recognize.
2394
+ */
2395
+ review_status: components["schemas"]["OpenItemsReviewStatus"];
2396
+ /**
2397
+ * @description The head commit this review evaluated. Null when the review recorded
2398
+ * none.
2399
+ */
2400
+ reviewed_head_sha?: string | null;
2401
+ /**
2402
+ * @description The count of unresolved Proofline review threads on GitHub, or why that
2403
+ * count is unknown.
2404
+ */
2405
+ threads: components["schemas"]["OpenItemsThreads"];
2406
+ };
2407
+ ReviewPage: {
2408
+ /** @description The exact structured query applied before pagination. */
2409
+ applied_query?: string | null;
2410
+ /**
2411
+ * @description The values the review list can be filtered by, drawn from reviews the
2412
+ * caller can see and independent of the current filters.
2413
+ */
2414
+ filters: components["schemas"]["ReviewFilters"];
2415
+ /** @description The reviews on this page, newest first. */
2416
+ items: components["schemas"]["ReviewSummary"][];
2417
+ /** @description The cursor that requests the next page. Null when `truncated` is false. */
2418
+ next_cursor?: string | null;
2419
+ /** @description Whether more reviews match the query beyond this page. */
2420
+ truncated: boolean;
2421
+ };
2422
+ ReviewRoutingView: {
2423
+ /** @constant */
2424
+ status: "NOT_RECORDED";
2425
+ } | {
2426
+ /** @constant */
2427
+ status: "UNSUPPORTED";
2428
+ /** @description Version identifier stored with the plan. */
2429
+ version: string;
2430
+ } | {
2431
+ /** @description Recorded publication decisions, with unrecognized codes masked. */
2432
+ findings: components["schemas"]["RoutingFindingView"][];
2433
+ /** @description Safe routing projection bound to this review's retained inputs. */
2434
+ plan: components["schemas"]["PlanProjection"];
2435
+ /** @description Actual specialist selection and pass receipts for the applied workflow. */
2436
+ specialist_execution?: components["schemas"]["SpecialistExecutionView"] | null;
2437
+ /** @constant */
2438
+ status: "SUPPORTED";
2439
+ /** @description Version of the validated routing plan. */
2440
+ version: string;
2441
+ };
2442
+ ReviewSummary: {
2443
+ /**
2444
+ * Format: int64
2445
+ * @description How many environment assessments this review has.
2446
+ */
2447
+ assessment_count: number;
2448
+ /**
2449
+ * Format: date-time
2450
+ * @description When the review reached a terminal status. Absent while it is still pending or running.
2451
+ */
2452
+ completed_at?: string | null;
2453
+ /**
2454
+ * Format: date-time
2455
+ * @description When the review was created.
2456
+ */
2457
+ created_at: string;
2458
+ /** @description The pull request's head commit as the latest provider projection reports it, which can differ from `head_commit_sha`. Set only on a single-review read, and absent for a deployment review or a pull request with no projection. */
2459
+ current_head_commit_sha?: string | null;
2460
+ /** @description Display names of this review's assessed environments, not current repository links. */
2461
+ environment_display_names: string[];
2462
+ /**
2463
+ * Format: int64
2464
+ * @description How many findings this review's assessments recorded, across all of them.
2465
+ */
2466
+ finding_count: number;
2467
+ /**
2468
+ * @description The head commit this review is pinned to. For a patch review, the
2469
+ * revision ID Proofline derives from its base commit and patch digest,
2470
+ * which is not a commit. Absent when the review recorded none.
2471
+ */
2472
+ head_commit_sha?: string | null;
2473
+ /**
2474
+ * @description The exact revision reviewed. A commit URL, never a branch URL: the
2475
+ * branch moves, the reviewed input does not. Absent for a patch review.
2476
+ */
2477
+ head_commit_url?: string | null;
2478
+ /**
2479
+ * Format: uuid
2480
+ * @description The review's identifier.
2481
+ */
2482
+ id: string;
2483
+ /**
2484
+ * @description `PULL_REQUEST`, `DEPLOYMENT`, `PATCH`, a review of local changes
2485
+ * sent as a patch, or `COMMIT`, a review of pushed commits.
2486
+ */
2487
+ kind: string;
2488
+ /** @description The review's stable public address: `rev_` followed by its identifier without hyphens. */
2489
+ public_key: string;
2490
+ /**
2491
+ * @description Whether the review reached the pull request: `PUBLISHED`, `WITHHELD`,
2492
+ * `PUBLICATION_REQUESTED` or `PUBLICATION_REFUSED`. A review run from
2493
+ * Proofline is withheld until somebody publishes it.
2494
+ */
2495
+ publication: string;
2496
+ /** @description Why a publication was refused, or how one failed. Server text. */
2497
+ publication_detail?: string | null;
2498
+ /**
2499
+ * @description Provider-supplied avatar URL. Login-derived `.png` URLs do not work for
2500
+ * GitHub App bot accounts and are not portable across GitHub hosts.
2501
+ */
2502
+ pull_request_author_avatar_url?: string | null;
2503
+ /**
2504
+ * Format: int64
2505
+ * @description The author's stable GitHub user id: identity for profile lookups,
2506
+ * never display text. Absent when GitHub named no author.
2507
+ */
2508
+ pull_request_author_github_user_id?: number | null;
2509
+ /** @description Provider display metadata for the pull request author, not the rerun requester. */
2510
+ pull_request_author_login?: string | null;
2511
+ /** @description The author's profile on the deployment's GitHub host. Absent when no author login is known. */
2512
+ pull_request_author_url?: string | null;
2513
+ /**
2514
+ * Format: int64
2515
+ * @description The pull request number. Absent for a deployment or patch review.
2516
+ */
2517
+ pull_request_number?: number | null;
2518
+ /**
2519
+ * @description Current provider state of the pull request: `OPEN`, `CLOSED`, or
2520
+ * `MERGED`. Absent for deployment reviews or a missing projection.
2521
+ */
2522
+ pull_request_state?: string | null;
2523
+ /**
2524
+ * @description The pull request's title as provider state last reported it, so it
2525
+ * names the change rather than only numbering it. Untrusted text:
2526
+ * renderers must treat it as text, never markup.
2527
+ */
2528
+ pull_request_title?: string | null;
2529
+ /** @description The pull request on GitHub. Absent for a deployment review or when the repository is unknown. */
2530
+ pull_request_url?: string | null;
2531
+ /** @description The repository's `owner/name`. Absent when the review names no repository. */
2532
+ repository_full_name?: string | null;
2533
+ /**
2534
+ * Format: uuid
2535
+ * @description The review's repository. Set only on a single-review read, and absent there when the review names no repository.
2536
+ */
2537
+ repository_id?: string | null;
2538
+ /** @description The repository's name within its owner. Absent when the review names no repository. */
2539
+ repository_name?: string | null;
2540
+ /**
2541
+ * @description The repository on GitHub. Absent when the deployment's web base
2542
+ * cannot be joined with the stored name.
2543
+ */
2544
+ repository_url?: string | null;
2545
+ /**
2546
+ * Format: int64
2547
+ * @description One-based, append-only ordinal within one repository pull request.
2548
+ */
2549
+ run_number?: number | null;
2550
+ /** @description The review's lifecycle status: `PENDING`, `RUNNING`, `COMPLETED`, `INCOMPLETE`, `FAILED`, `SUPERSEDED`, `STOPPED` or `EXCLUDED`. */
2551
+ status: string;
2552
+ /**
2553
+ * @description Who asked for this review: `AUTOMATIC`, `COMMAND`, `RERUN`, `MANUAL`,
2554
+ * or `UNKNOWN` for a trigger key this build does not recognise.
2555
+ */
2556
+ trigger_origin: string;
2557
+ };
2558
+ /** @description One member of a review's declared tree that World cited. */
2559
+ ReviewedTreeCitationView: {
2560
+ /**
2561
+ * @description The member's content hash. Absent for a member a `REJECTED`
2562
+ * population refused, because such a population keeps no members.
2563
+ */
2564
+ content_sha256?: string | null;
2565
+ /** @description The overlay World read the member from. */
2566
+ overlay_digest: string;
2567
+ /**
2568
+ * @description The member's path in the repository at that revision. Repository
2569
+ * text, so it can hold bidirectional controls that reorder what the
2570
+ * reader sees.
2571
+ */
2572
+ path: components["schemas"]["UntrustedText"];
2573
+ /**
2574
+ * @description The population the member belongs to, such as
2575
+ * `WORKFLOW_DEFINITIONS`.
2576
+ */
2577
+ population_kind: string;
2578
+ /**
2579
+ * @description `PROPOSED_CODE_REVISION` (the reviewed commit) or
2580
+ * `BASE_CODE_REVISION` (its merge base).
2581
+ */
2582
+ role: string;
2583
+ };
2584
+ /**
2585
+ * @description The NDJSON row and CSV column contract. Repository names are display data;
2586
+ * the stable repository ID and recorded commit identify the reviewed input.
2587
+ */
2588
+ ReviewsExportRow: {
2589
+ /** @description The pinned base commit SHA, null when the review records none. */
2590
+ base_commit_sha?: string | null;
2591
+ /**
2592
+ * Format: date-time
2593
+ * @description When the review finished, null while it has not.
2594
+ */
2595
+ completed_at?: string | null;
2596
+ /**
2597
+ * Format: date-time
2598
+ * @description When the review was created; the export window filters on this time.
2599
+ */
2600
+ created_at: string;
2601
+ /**
2602
+ * Format: uint16
2603
+ * @description The row contract version, always `1`.
2604
+ */
2605
+ dataset_version: number;
2606
+ /**
2607
+ * Format: int64
2608
+ * @description GitHub's ID for the repository, null when the organization no longer owns it or the
2609
+ * review records no repository.
2610
+ */
2611
+ github_repository_id?: number | null;
2612
+ /** @description The pinned head commit SHA, null when the review records none. */
2613
+ head_commit_sha?: string | null;
2614
+ /**
2615
+ * @description Whether the review analyzes a pull request, a deployment, a local patch or pushed
2616
+ * commits.
2617
+ */
2618
+ kind: components["schemas"]["ExportReviewKind"];
2619
+ /**
2620
+ * Format: uuid
2621
+ * @description The organization that owns the review.
2622
+ */
2623
+ organization_id: string;
2624
+ /**
2625
+ * Format: int64
2626
+ * @description The pull request number, null when the review records none, as for a deployment.
2627
+ */
2628
+ pull_request_number?: number | null;
2629
+ /**
2630
+ * @description The repository's current `owner/name` display name, null when the organization no
2631
+ * longer owns it or the review records no repository.
2632
+ */
2633
+ repository_full_name?: string | null;
2634
+ /**
2635
+ * Format: uuid
2636
+ * @description The stable ID of the review's primary repository, null when the review records none.
2637
+ */
2638
+ repository_id?: string | null;
2639
+ /**
2640
+ * Format: uuid
2641
+ * @description The review's stable ID.
2642
+ */
2643
+ review_id: string;
2644
+ /**
2645
+ * Format: int64
2646
+ * @description The review's ordinal among the reviews of its pull request, null for a review without
2647
+ * a repository and pull request.
2648
+ */
2649
+ run_number?: number | null;
2650
+ /** @description The review's recorded status. */
2651
+ status: components["schemas"]["ExportReviewStatus"];
2652
+ /**
2653
+ * @description What started the review, derived from its trigger key: `AUTOMATIC`, `COMMAND`,
2654
+ * `RERUN`, `MANUAL`, or `UNKNOWN` for a key this build does not recognize.
2655
+ */
2656
+ trigger_origin: string;
2657
+ };
2658
+ /** @description UTF-8 metadata file. NDJSON contains one ExportRow per line; CSV contains that dataset's named columns and a header. This response is neither a JSON object nor a JSON array. */
2659
+ ReviewsMetadataStream: string;
2660
+ RoutingFindingView: {
2661
+ /** @description Recognized safe fallback cause, when present. */
2662
+ fallback_cause?: string | null;
2663
+ /**
2664
+ * Format: uuid
2665
+ * @description Finding whose retained placement is reported.
2666
+ */
2667
+ finding_id: string;
2668
+ /** @description Recognized safe floor reason, when present. */
2669
+ floor_reason?: string | null;
2670
+ /** @description The original inline choice exceeded this review's inline comment limit. */
2671
+ inline_limit_exceeded: boolean;
2672
+ /** @description Why the recorded publication did not create an inline comment, when retained. */
2673
+ inline_reason?: string | null;
2674
+ /** @description Publication channel recorded for this finding. */
2675
+ placement: string;
2676
+ /** @description Human override beside the original decision, when one was requested. */
2677
+ promotion?: components["schemas"]["FindingPromotionView"] | null;
2678
+ /** @description Recognized safe reason codes; unknown values are represented as `UNRECOGNIZED`. */
2679
+ reason_codes: string[];
2680
+ /** @description Rule that produced the recorded placement. */
2681
+ rule: string;
2682
+ };
2683
+ /** @enum {string} */
2684
+ RuleSource: "CONSOLE" | "CONFIG_FILE" | "IMPLICIT";
2685
+ /**
2686
+ * @description Whether an explicit request may reuse a settled review of the live head.
2687
+ * @enum {string}
2688
+ */
2689
+ RunNowMode: "EXISTING_OR_NEW" | "FULL" | "EXTENDED";
2690
+ /**
2691
+ * @description Why a run-now request created nothing, each reason with what the page
2692
+ * needs to link the setting to change.
2693
+ */
2694
+ RunNowRefusalView: {
2695
+ /** @constant */
2696
+ reason: "TRIGGER_DISABLED";
2697
+ } | {
2698
+ /** @constant */
2699
+ reason: "REPOSITORY_DISABLED";
2700
+ } | {
2701
+ /** @constant */
2702
+ reason: "NO_LINKED_ENVIRONMENT";
2703
+ } | {
2704
+ environment: components["schemas"]["RefusedEnvironment"];
2705
+ /** @constant */
2706
+ reason: "ENVIRONMENT_REVIEWS_OFF";
2707
+ } | {
2708
+ environment: components["schemas"]["RefusedEnvironment"];
2709
+ /** @constant */
2710
+ reason: "ENVIRONMENT_NOT_READY";
2711
+ status_detail?: string | null;
2712
+ } | {
2713
+ environment: components["schemas"]["RefusedEnvironment"];
2714
+ /** @constant */
2715
+ reason: "ENVIRONMENT_EVIDENCE_UNAVAILABLE";
2716
+ } | {
2717
+ detail: string;
2718
+ environment?: components["schemas"]["RefusedEnvironment"] | null;
2719
+ /** @constant */
2720
+ reason: "INVALID_DELIVERY_CONFIGURATION";
2721
+ } | {
2722
+ /** @constant */
2723
+ reason: "PULL_REQUEST_UNKNOWN";
2724
+ } | {
2725
+ /** @constant */
2726
+ reason: "AUTHOR_HAS_NO_SEAT";
2727
+ } | {
2728
+ /** @constant */
2729
+ reason: "PULL_REQUEST_CLOSED";
2730
+ } | {
2731
+ detail: string;
2732
+ /** @constant */
2733
+ reason: "DEEP_REVIEW_UNAVAILABLE";
2734
+ } | {
2735
+ /** @constant */
2736
+ reason: "DEEP_REVIEW_FOCUS_CONFLICT";
2737
+ };
2738
+ /**
2739
+ * @description A run-now request that created nothing, as the 400 it is answered with.
2740
+ *
2741
+ * The refusal is a configuration fact, not a failure, and it is still sent
2742
+ * as an RFC 9457 problem: `title`, `status` and `detail` are what a client
2743
+ * that knows only problems shows, and `repository_name` and `refusal` are
2744
+ * the extension members a client that knows refusals links from. During a
2745
+ * rollout a page loaded from the previous bundle keeps working against
2746
+ * this server, because a refusal was a 400 with a `detail` before too.
2747
+ */
2748
+ RunNowRefused: {
2749
+ /**
2750
+ * @description One sentence naming the condition and the setting to change, for a
2751
+ * reader with no link to follow.
2752
+ */
2753
+ detail: string;
2754
+ /** @description Why nothing was created, with what the page needs to link the setting to change. */
2755
+ refusal: components["schemas"]["RunNowRefusalView"];
2756
+ /** @description The repository's name within its owner, as its pages are addressed. */
2757
+ repository_name: string;
2758
+ /**
2759
+ * Format: uint16
2760
+ * @description Always 400.
2761
+ */
2762
+ status: number;
2763
+ /** @description Always `invalid request`. */
2764
+ title: string;
2765
+ };
2766
+ /** @description An empty body keeps the run-now behavior existing clients request. */
2767
+ RunNowRequest: {
2768
+ /**
2769
+ * @description Optional investigation focus for EXTENDED, trimmed and frozen at admission.
2770
+ * Limited to 500 UTF-16 code units.
2771
+ */
2772
+ focus_text?: string | null;
2773
+ /**
2774
+ * @description `EXISTING_OR_NEW`, the default, returns any review that already owns the live head.
2775
+ * `FULL` returns a pending or running review of that head or starts a new one.
2776
+ * `EXTENDED` admits one funded Deep Review for that head, with optional focus.
2777
+ */
2778
+ mode?: components["schemas"]["RunNowMode"];
2779
+ };
2780
+ /**
2781
+ * @description What a run-now request produced: a review of the live head, created by
2782
+ * this request or found already owning the head.
2783
+ */
2784
+ RunNowResponse: {
2785
+ /**
2786
+ * @description True when automatic reviews are stopped on this pull request. The
2787
+ * review ran anyway; the flag is why the page can say so.
2788
+ */
2789
+ automatic_reviews_paused: boolean;
2790
+ /**
2791
+ * @description True when this head already carried a review and that one is
2792
+ * returned. Clicking twice does not run twice.
2793
+ */
2794
+ existing: boolean;
2795
+ /**
2796
+ * Format: uuid
2797
+ * @description The review that owns the live head, new or existing.
2798
+ */
2799
+ review_id: string;
2800
+ /**
2801
+ * Format: int64
2802
+ * @description The review's one-based ordinal within its pull request, which
2803
+ * completes the run's console address.
2804
+ */
2805
+ run_number: number;
2806
+ };
2807
+ SpecialistAssessmentExecution: {
2808
+ /**
2809
+ * Format: uuid
2810
+ * @description The immutable assessment whose specialist execution is reported.
2811
+ */
2812
+ assessment_id: string;
2813
+ /** @description Selected specialist passes and their retained execution outputs. */
2814
+ passes: components["schemas"]["SpecialistPassExecution"][];
2815
+ };
2816
+ SpecialistExecutionView: {
2817
+ /** @description The applied specialist roster per exact assessment execution. */
2818
+ assessments: components["schemas"]["SpecialistAssessmentExecution"][];
2819
+ /** @description False until the applied parent captures its specialist choices. */
2820
+ selection_recorded: boolean;
2821
+ };
2822
+ /** @description A pass receipt's bounded operational facts, without its proposals or prose. */
2823
+ SpecialistOutputProjection: {
2824
+ /** @description Closed evidence-gap class, absent when the pass produced output. */
2825
+ gap_kind?: string | null;
2826
+ /** @description Verified digest of the retained output bytes. */
2827
+ output_sha256: string;
2828
+ /** @description `PRODUCED`, `UNAVAILABLE`, `INCOMPLETE` or `MALFORMED`. */
2829
+ status: string;
2830
+ };
2831
+ SpecialistPassExecution: {
2832
+ /** @description Exact selected paths from the validated captured change. */
2833
+ files: string[];
2834
+ /** @description Whether captured file facts required this pass. */
2835
+ floor: boolean;
2836
+ /** @description Closed registry key of the selected specialist. */
2837
+ name: string;
2838
+ /** @description Missing means selected, with no retained output. It never means success. */
2839
+ output?: components["schemas"]["SpecialistOutputProjection"] | null;
2840
+ };
2841
+ /** @enum {string} */
2842
+ SpendAccountKind: "DEPLOYMENT" | "TENANT_CREDENTIAL" | "UNATTRIBUTED";
2843
+ /** @description UTC daily debit totals using only the account and transport recorded at charge time. */
2844
+ SpendExportRow: {
2845
+ /** @description Recorded attribution, not a current credential label or inferred account. */
2846
+ account?: string | null;
2847
+ /** @description The account kind recorded at charge time, `UNATTRIBUTED` when the debit records none. */
2848
+ account_kind: components["schemas"]["SpendAccountKind"];
2849
+ /**
2850
+ * Format: uint16
2851
+ * @description The row contract version, always `1`.
2852
+ */
2853
+ dataset_version: number;
2854
+ /**
2855
+ * Format: date-time
2856
+ * @description UTC midnight. The requested window can cover only part of this day.
2857
+ */
2858
+ day: string;
2859
+ /**
2860
+ * Format: int64
2861
+ * @description The number of debits summed into this row.
2862
+ */
2863
+ debits: number;
2864
+ /**
2865
+ * Format: int64
2866
+ * @description Exact integer charge units; one credit contains one million microcredits.
2867
+ */
2868
+ microcredits: number;
2869
+ /**
2870
+ * Format: uuid
2871
+ * @description The organization charged.
2872
+ */
2873
+ organization_id: string;
2874
+ /** @description The model transport recorded at charge time, null when the debit records none. */
2875
+ transport?: string | null;
2876
+ };
2877
+ StartSession: {
2878
+ /**
2879
+ * Format: uuid
2880
+ * @description The vendor connection to start the session with.
2881
+ */
2882
+ connection_id: string;
2883
+ /** @description The `prompt_digest` of the prompt the person confirmed. */
2884
+ prompt_digest: string;
2885
+ };
2886
+ /**
2887
+ * @description One assessment's authorization of one subject, by identity.
2888
+ *
2889
+ * The display name is not the answer on its own: an environment's external key
2890
+ * is unique within its organization and a display name is mutable metadata,
2891
+ * so two environments of one review can carry the same one.
2892
+ * Collapsing to it would leave a reader unable to tell which assessment
2893
+ * authorized the subject and which one gapped, which is the confusion this
2894
+ * field exists to remove.
2895
+ */
2896
+ SubjectAuthorization: {
2897
+ /**
2898
+ * Format: uuid
2899
+ * @description The assessment this authorization belongs to, as `AssessmentView.id`
2900
+ * names it. A reader joins on this, never on the display name.
2901
+ */
2902
+ assessment_id: string;
2903
+ /**
2904
+ * @description What a reader recognizes the environment by. Display metadata, and
2905
+ * tenant free text: a consumer contains it before rendering.
2906
+ */
2907
+ environment_display_name: string;
2908
+ /** @description The environment's stable machine key, unique within the organization. */
2909
+ environment_external_key: string;
2910
+ /**
2911
+ * Format: uuid
2912
+ * @description The environment the authorizing assessment belongs to.
2913
+ */
2914
+ environment_id: string;
2915
+ };
2916
+ SubjectView: {
2917
+ /** @description An immutable OCI digest, never a mutable tag. */
2918
+ artifact_digest?: string | null;
2919
+ /**
2920
+ * @description The pinned commit of a `GIT_REVISION` subject, or the base commit a
2921
+ * `GIT_PATCH` subject applies to. Absent for other kinds.
2922
+ */
2923
+ commit_sha?: string | null;
2924
+ /** @description The GitHub deployment identifier a `GITHUB_WORKFLOW_RUN` subject ran for. Absent when the run was not for a deployment. */
2925
+ deployment_external_id?: string | null;
2926
+ /**
2927
+ * Format: uuid
2928
+ * @description The subject's stable identifier. It holds across a poll refresh even
2929
+ * when a concurrently populated subject shifts this response's
2930
+ * `(kind, id)` order: a client keying its own local UI state (an open
2931
+ * disclosure, a focused control) by array index would otherwise lose
2932
+ * that state to a reorder that changed nothing it owns.
2933
+ */
2934
+ id: string;
2935
+ /** @description `GIT_REVISION`, `GIT_PATCH`, `GITHUB_WORKFLOW_RUN`, `ARTIFACT` or `DEPLOYMENT`. */
2936
+ kind: string;
2937
+ /**
2938
+ * @description The SHA-256 of a `GIT_PATCH` subject's canonical patch. Absent for
2939
+ * other kinds.
2940
+ */
2941
+ patch_digest?: string | null;
2942
+ /**
2943
+ * @description The assessments whose own verified release set authorized this
2944
+ * subject.
2945
+ *
2946
+ * A review with several environments accumulates one subject list, but
2947
+ * authorization is per assessment: an artifact one environment's read
2948
+ * authenticated is not evidence for a neighbour whose own read gapped or
2949
+ * refused. Naming the assessments keeps the union from reading as a
2950
+ * shared fact.
2951
+ *
2952
+ * Empty for a subject no release-set read produced (the reviewed
2953
+ * revision, the workflow run, a deployment), because those are the
2954
+ * review's own coordinates rather than one environment's authenticated
2955
+ * evidence, not because every environment refused them.
2956
+ */
2957
+ release_authorizations: components["schemas"]["SubjectAuthorization"][];
2958
+ /** @description Absent only when the subject's repository record itself is gone. */
2959
+ repository_full_name?: string | null;
2960
+ /**
2961
+ * Format: uuid
2962
+ * @description The immutable repository identity of this subject, including companions.
2963
+ */
2964
+ repository_id?: string | null;
2965
+ /**
2966
+ * @description `PRIMARY` for the revision under review; `COMPANION` for context read
2967
+ * from another authenticated repository.
2968
+ */
2969
+ role: string;
2970
+ /**
2971
+ * @description The subject on GitHub: the commit for a revision, the run for a
2972
+ * workflow run. Absent for kinds GitHub does not address (`GIT_PATCH`,
2973
+ * ARTIFACT, DEPLOYMENT) or when the subject's repository is unknown.
2974
+ */
2975
+ url?: string | null;
2976
+ /**
2977
+ * Format: int32
2978
+ * @description The attempt number of a `GITHUB_WORKFLOW_RUN` subject. Absent for other kinds.
2979
+ */
2980
+ workflow_attempt?: number | null;
2981
+ /**
2982
+ * Format: int64
2983
+ * @description The GitHub Actions run of a `GITHUB_WORKFLOW_RUN` subject. Absent for other kinds.
2984
+ */
2985
+ workflow_run_id?: number | null;
2986
+ };
2987
+ /** @enum {string} */
2988
+ ThreadObservationFreshness: "FRESH" | "STALE";
2989
+ /** @description A read of GitHub's thread state. `observed_at` is when Proofline read it. */
2990
+ ThreadObservationView: {
2991
+ /** @description `STALE` when the pull request is open and this observation is more than 24 hours old, otherwise `FRESH`. */
2992
+ freshness: components["schemas"]["ThreadObservationFreshness"];
2993
+ /** @description The finding's root comment on GitHub. Absent when the repository is unknown. */
2994
+ github_comment_url?: string | null;
2995
+ /**
2996
+ * Format: date-time
2997
+ * @description When Proofline read the thread state from GitHub.
2998
+ */
2999
+ observed_at: string;
3000
+ /** @description Absent only when the provider read failed before GitHub returned state. */
3001
+ provider_state?: components["schemas"]["ThreadProviderState"] | null;
3002
+ /** @description `RECORDED` when a human reply in the thread was recorded, `NONE_CONFIRMED` when the complete thread held none, and `INCOMPLETE` when the thread could not be read in full. */
3003
+ reply_evidence: components["schemas"]["ThreadReplyEvidence"];
3004
+ /**
3005
+ * Format: int64
3006
+ * @description The stable GitHub identity of whoever resolved the thread. Absent when GitHub named no resolver.
3007
+ */
3008
+ resolver_github_user_id?: number | null;
3009
+ /** @description The login of whoever resolved the thread, as GitHub reported it. Provider text, and absent when GitHub named no resolver. */
3010
+ resolver_login?: string | null;
3011
+ };
3012
+ /** @enum {string} */
3013
+ ThreadProviderState: "OPEN" | "RESOLVED";
3014
+ /** @enum {string} */
3015
+ ThreadReplyEvidence: "RECORDED" | "NONE_CONFIRMED" | "INCOMPLETE";
3016
+ /**
3017
+ * @description World's reason an executed check did not settle. A gate weighs the three
3018
+ * alike, and each asks the reader for a different response.
3019
+ */
3020
+ UnresolvedReason: "NEEDS_EVIDENCE" | "UNSUPPORTED" | "REGENERATE_SCENARIO";
3021
+ /**
3022
+ * @description Text that came out of the reviewer model, or out of a repository the model
3023
+ * read. It is data, never markup, never a URL, never an instruction.
3024
+ *
3025
+ * The wrapper exists so the untrustedness cannot be lost on the way to a
3026
+ * renderer: there is no field on a turn that carries this text under a name a
3027
+ * client could mistake for something safe, and unwrapping it is a deliberate
3028
+ * act in the client's own code.
3029
+ */
3030
+ UntrustedText: {
3031
+ /** @description The text itself. Render it as plain text only. */
3032
+ untrusted_text: string;
3033
+ };
3034
+ };
3035
+ responses: never;
3036
+ parameters: never;
3037
+ requestBodies: never;
3038
+ headers: never;
3039
+ pathItems: never;
3040
+ }
3041
+ export type $defs = Record<string, never>;
3042
+ export interface operations {
3043
+ get_agent_session: {
3044
+ parameters: {
3045
+ query?: never;
3046
+ header?: never;
3047
+ path: {
3048
+ org_id: string;
3049
+ session_id: string;
3050
+ };
3051
+ cookie?: never;
3052
+ };
3053
+ requestBody?: never;
3054
+ responses: {
3055
+ 200: {
3056
+ headers: {
3057
+ [name: string]: unknown;
3058
+ };
3059
+ content: {
3060
+ "application/json": components["schemas"]["AgentSession"];
3061
+ };
3062
+ };
3063
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3064
+ default: {
3065
+ headers: {
3066
+ [name: string]: unknown;
3067
+ };
3068
+ content: {
3069
+ "application/problem+json": components["schemas"]["Problem"];
3070
+ };
3071
+ };
3072
+ };
3073
+ };
3074
+ export_reviews: {
3075
+ parameters: {
3076
+ query: {
3077
+ /** @description Treat this signed continuation as opaque. Retain the same window and grouping. */
3078
+ cursor?: string | null;
3079
+ /** @description ndjson (default) or csv. Each CSV page repeats its column header. */
3080
+ format?: string | null;
3081
+ /** @description Inclusive RFC3339 creation, debit or first-publication time. At most 31 days. */
3082
+ from: string;
3083
+ /** @description `finding_outcomes` only; defaults to repository. */
3084
+ group_by?: components["schemas"]["FindingOutcomesGroupBy"] | null;
3085
+ /** @description Exclusive RFC3339 creation, debit or first-publication time. */
3086
+ to: string;
3087
+ };
3088
+ header?: never;
3089
+ path: {
3090
+ dataset: components["schemas"]["Dataset"];
3091
+ org_id: string;
3092
+ };
3093
+ cookie?: never;
3094
+ };
3095
+ requestBody?: never;
3096
+ responses: {
3097
+ /** @description At most 5000 review, finding, validation or daily spend rows, or 1000 finding-outcome groups. NDJSON uses the declared dataset row per line; CSV uses the same named columns, RFC4180 quoting and formula-safe text. Nested count and reference objects are JSON text in CSV cells. The settled horizon and optional opaque continuation are response headers. */
3098
+ 200: {
3099
+ headers: {
3100
+ /** @description Opaque signed continuation. Absent on the last page. */
3101
+ "X-Proofline-Export-Next-Cursor"?: string;
3102
+ /** @description Frozen RFC3339 horizon, five minutes before the first request. */
3103
+ "X-Proofline-Export-Settled-Until": string;
3104
+ /** @description Dataset version 1. */
3105
+ "X-Proofline-Export-Version": string;
3106
+ [name: string]: unknown;
3107
+ };
3108
+ content: {
3109
+ "application/x-ndjson": components["schemas"]["ReviewsMetadataStream"];
3110
+ "text/csv": components["schemas"]["ReviewsMetadataStream"];
3111
+ };
3112
+ };
3113
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3114
+ default: {
3115
+ headers: {
3116
+ [name: string]: unknown;
3117
+ };
3118
+ content: {
3119
+ "application/problem+json": components["schemas"]["Problem"];
3120
+ };
3121
+ };
3122
+ };
3123
+ };
3124
+ get_finding: {
3125
+ parameters: {
3126
+ query?: never;
3127
+ header?: never;
3128
+ path: {
3129
+ finding_id: string;
3130
+ org_id: string;
3131
+ };
3132
+ cookie?: never;
3133
+ };
3134
+ requestBody?: never;
3135
+ responses: {
3136
+ 200: {
3137
+ headers: {
3138
+ [name: string]: unknown;
3139
+ };
3140
+ content: {
3141
+ "application/json": components["schemas"]["CustomerFinding"];
3142
+ };
3143
+ };
3144
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3145
+ default: {
3146
+ headers: {
3147
+ [name: string]: unknown;
3148
+ };
3149
+ content: {
3150
+ "application/problem+json": components["schemas"]["Problem"];
3151
+ };
3152
+ };
3153
+ };
3154
+ };
3155
+ get_agent_session_prompt: {
3156
+ parameters: {
3157
+ query?: never;
3158
+ header?: never;
3159
+ path: {
3160
+ finding_id: string;
3161
+ org_id: string;
3162
+ };
3163
+ cookie?: never;
3164
+ };
3165
+ requestBody?: never;
3166
+ responses: {
3167
+ 200: {
3168
+ headers: {
3169
+ [name: string]: unknown;
3170
+ };
3171
+ content: {
3172
+ "application/json": components["schemas"]["AgentSessionPrompt"];
3173
+ };
3174
+ };
3175
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3176
+ default: {
3177
+ headers: {
3178
+ [name: string]: unknown;
3179
+ };
3180
+ content: {
3181
+ "application/problem+json": components["schemas"]["Problem"];
3182
+ };
3183
+ };
3184
+ };
3185
+ };
3186
+ start_agent_session: {
3187
+ parameters: {
3188
+ query?: never;
3189
+ header?: never;
3190
+ path: {
3191
+ finding_id: string;
3192
+ org_id: string;
3193
+ };
3194
+ cookie?: never;
3195
+ };
3196
+ requestBody: {
3197
+ content: {
3198
+ "application/json": components["schemas"]["StartSession"];
3199
+ };
3200
+ };
3201
+ responses: {
3202
+ 201: {
3203
+ headers: {
3204
+ [name: string]: unknown;
3205
+ };
3206
+ content: {
3207
+ "application/json": components["schemas"]["AgentSession"];
3208
+ };
3209
+ };
3210
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3211
+ default: {
3212
+ headers: {
3213
+ [name: string]: unknown;
3214
+ };
3215
+ content: {
3216
+ "application/problem+json": components["schemas"]["Problem"];
3217
+ };
3218
+ };
3219
+ };
3220
+ };
3221
+ get_finding_fix_prompt: {
3222
+ parameters: {
3223
+ query?: never;
3224
+ header?: never;
3225
+ path: {
3226
+ finding_id: string;
3227
+ org_id: string;
3228
+ };
3229
+ cookie?: never;
3230
+ };
3231
+ requestBody?: never;
3232
+ responses: {
3233
+ 200: {
3234
+ headers: {
3235
+ [name: string]: unknown;
3236
+ };
3237
+ content: {
3238
+ "application/json": components["schemas"]["FindingFixPrompt"];
3239
+ };
3240
+ };
3241
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3242
+ default: {
3243
+ headers: {
3244
+ [name: string]: unknown;
3245
+ };
3246
+ content: {
3247
+ "application/problem+json": components["schemas"]["Problem"];
3248
+ };
3249
+ };
3250
+ };
3251
+ };
3252
+ request_commit_review: {
3253
+ parameters: {
3254
+ query?: never;
3255
+ header?: never;
3256
+ path: {
3257
+ org_id: string;
3258
+ repo_id: string;
3259
+ };
3260
+ cookie?: never;
3261
+ };
3262
+ /**
3263
+ * @description Pushed commits to review: the exact base the change is compared with and
3264
+ * the exact head it ends at.
3265
+ */
3266
+ requestBody: {
3267
+ content: {
3268
+ "application/json": components["schemas"]["CommitReviewRequest"];
3269
+ };
3270
+ };
3271
+ responses: {
3272
+ /** @description What a commit review request produced. */
3273
+ 200: {
3274
+ headers: {
3275
+ [name: string]: unknown;
3276
+ };
3277
+ content: {
3278
+ "application/json": components["schemas"]["CommitReviewResponse"];
3279
+ };
3280
+ };
3281
+ /**
3282
+ * @description A run-now request that created nothing, as the 400 it is answered with.
3283
+ *
3284
+ * The refusal is a configuration fact, not a failure, and it is still sent
3285
+ * as an RFC 9457 problem: `title`, `status` and `detail` are what a client
3286
+ * that knows only problems shows, and `repository_name` and `refusal` are
3287
+ * the extension members a client that knows refusals links from. During a
3288
+ * rollout a page loaded from the previous bundle keeps working against
3289
+ * this server, because a refusal was a 400 with a `detail` before too.
3290
+ */
3291
+ 400: {
3292
+ headers: {
3293
+ [name: string]: unknown;
3294
+ };
3295
+ content: {
3296
+ "application/json": components["schemas"]["RunNowRefused"];
3297
+ };
3298
+ };
3299
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3300
+ default: {
3301
+ headers: {
3302
+ [name: string]: unknown;
3303
+ };
3304
+ content: {
3305
+ "application/problem+json": components["schemas"]["Problem"];
3306
+ };
3307
+ };
3308
+ };
3309
+ };
3310
+ request_patch_review: {
3311
+ parameters: {
3312
+ query?: never;
3313
+ header?: never;
3314
+ path: {
3315
+ org_id: string;
3316
+ repo_id: string;
3317
+ };
3318
+ cookie?: never;
3319
+ };
3320
+ /** @description Local changes to review: a unified diff against a commit GitHub has. */
3321
+ requestBody: {
3322
+ content: {
3323
+ "application/json": components["schemas"]["PatchReviewRequest"];
3324
+ };
3325
+ };
3326
+ responses: {
3327
+ /** @description What a patch review request produced. */
3328
+ 200: {
3329
+ headers: {
3330
+ [name: string]: unknown;
3331
+ };
3332
+ content: {
3333
+ "application/json": components["schemas"]["PatchReviewResponse"];
3334
+ };
3335
+ };
3336
+ /**
3337
+ * @description A run-now request that created nothing, as the 400 it is answered with.
3338
+ *
3339
+ * The refusal is a configuration fact, not a failure, and it is still sent
3340
+ * as an RFC 9457 problem: `title`, `status` and `detail` are what a client
3341
+ * that knows only problems shows, and `repository_name` and `refusal` are
3342
+ * the extension members a client that knows refusals links from. During a
3343
+ * rollout a page loaded from the previous bundle keeps working against
3344
+ * this server, because a refusal was a 400 with a `detail` before too.
3345
+ */
3346
+ 400: {
3347
+ headers: {
3348
+ [name: string]: unknown;
3349
+ };
3350
+ content: {
3351
+ "application/json": components["schemas"]["RunNowRefused"];
3352
+ };
3353
+ };
3354
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3355
+ default: {
3356
+ headers: {
3357
+ [name: string]: unknown;
3358
+ };
3359
+ content: {
3360
+ "application/problem+json": components["schemas"]["Problem"];
3361
+ };
3362
+ };
3363
+ };
3364
+ };
3365
+ request_review: {
3366
+ parameters: {
3367
+ query?: never;
3368
+ header?: never;
3369
+ path: {
3370
+ number: number;
3371
+ org_id: string;
3372
+ repo_id: string;
3373
+ };
3374
+ cookie?: never;
3375
+ };
3376
+ /** @description An empty body keeps the run-now behavior existing clients request. */
3377
+ requestBody?: {
3378
+ content: {
3379
+ "application/json": components["schemas"]["RunNowRequest"];
3380
+ };
3381
+ };
3382
+ responses: {
3383
+ /**
3384
+ * @description What a run-now request produced: a review of the live head, created by
3385
+ * this request or found already owning the head.
3386
+ */
3387
+ 200: {
3388
+ headers: {
3389
+ [name: string]: unknown;
3390
+ };
3391
+ content: {
3392
+ "application/json": components["schemas"]["RunNowResponse"];
3393
+ };
3394
+ };
3395
+ /**
3396
+ * @description A run-now request that created nothing, as the 400 it is answered with.
3397
+ *
3398
+ * The refusal is a configuration fact, not a failure, and it is still sent
3399
+ * as an RFC 9457 problem: `title`, `status` and `detail` are what a client
3400
+ * that knows only problems shows, and `repository_name` and `refusal` are
3401
+ * the extension members a client that knows refusals links from. During a
3402
+ * rollout a page loaded from the previous bundle keeps working against
3403
+ * this server, because a refusal was a 400 with a `detail` before too.
3404
+ */
3405
+ 400: {
3406
+ headers: {
3407
+ [name: string]: unknown;
3408
+ };
3409
+ content: {
3410
+ "application/json": components["schemas"]["RunNowRefused"];
3411
+ };
3412
+ };
3413
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3414
+ default: {
3415
+ headers: {
3416
+ [name: string]: unknown;
3417
+ };
3418
+ content: {
3419
+ "application/problem+json": components["schemas"]["Problem"];
3420
+ };
3421
+ };
3422
+ };
3423
+ };
3424
+ get_review_guidance: {
3425
+ parameters: {
3426
+ query?: never;
3427
+ header?: never;
3428
+ path: {
3429
+ org_id: string;
3430
+ repo_id: string;
3431
+ };
3432
+ cookie?: never;
3433
+ };
3434
+ requestBody?: never;
3435
+ responses: {
3436
+ 200: {
3437
+ headers: {
3438
+ [name: string]: unknown;
3439
+ };
3440
+ content: {
3441
+ "application/json": components["schemas"]["RepositoryGuidance"];
3442
+ };
3443
+ };
3444
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3445
+ default: {
3446
+ headers: {
3447
+ [name: string]: unknown;
3448
+ };
3449
+ content: {
3450
+ "application/problem+json": components["schemas"]["Problem"];
3451
+ };
3452
+ };
3453
+ };
3454
+ };
3455
+ list_repositories: {
3456
+ parameters: {
3457
+ query?: never;
3458
+ header?: never;
3459
+ path: {
3460
+ org_id: string;
3461
+ };
3462
+ cookie?: never;
3463
+ };
3464
+ requestBody?: never;
3465
+ responses: {
3466
+ 200: {
3467
+ headers: {
3468
+ [name: string]: unknown;
3469
+ };
3470
+ content: {
3471
+ "application/json": components["schemas"]["RepositoryNames"];
3472
+ };
3473
+ };
3474
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3475
+ default: {
3476
+ headers: {
3477
+ [name: string]: unknown;
3478
+ };
3479
+ content: {
3480
+ "application/problem+json": components["schemas"]["Problem"];
3481
+ };
3482
+ };
3483
+ };
3484
+ };
3485
+ list_reviews: {
3486
+ parameters: {
3487
+ query?: {
3488
+ /**
3489
+ * @description `needed` lists terminal reviews of open pull requests with active
3490
+ * findings, FAILED/INCOMPLETE/STOPPED execution, or an earlier reviewed commit.
3491
+ */
3492
+ attention?: string | null;
3493
+ author?: string | null;
3494
+ cursor?: string | null;
3495
+ environment?: string | null;
3496
+ findings?: string | null;
3497
+ kind?: string | null;
3498
+ limit?: number | null;
3499
+ /** @description Qualifiers, quoted values, AND/OR, groups and minus exclusions. */
3500
+ query?: string | null;
3501
+ repository?: string | null;
3502
+ search?: string | null;
3503
+ status?: string | null;
3504
+ };
3505
+ header?: never;
3506
+ path: {
3507
+ org_id: string;
3508
+ };
3509
+ cookie?: never;
3510
+ };
3511
+ requestBody?: never;
3512
+ responses: {
3513
+ 200: {
3514
+ headers: {
3515
+ [name: string]: unknown;
3516
+ };
3517
+ content: {
3518
+ "application/json": components["schemas"]["ReviewPage"];
3519
+ };
3520
+ };
3521
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3522
+ default: {
3523
+ headers: {
3524
+ [name: string]: unknown;
3525
+ };
3526
+ content: {
3527
+ "application/problem+json": components["schemas"]["Problem"];
3528
+ };
3529
+ };
3530
+ };
3531
+ };
3532
+ get_deployment_review: {
3533
+ parameters: {
3534
+ query?: never;
3535
+ header?: never;
3536
+ path: {
3537
+ org_id: string;
3538
+ public_key: string;
3539
+ };
3540
+ cookie?: never;
3541
+ };
3542
+ requestBody?: never;
3543
+ responses: {
3544
+ 200: {
3545
+ headers: {
3546
+ [name: string]: unknown;
3547
+ };
3548
+ content: {
3549
+ "application/json": components["schemas"]["CustomerReviewDetail"];
3550
+ };
3551
+ };
3552
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3553
+ default: {
3554
+ headers: {
3555
+ [name: string]: unknown;
3556
+ };
3557
+ content: {
3558
+ "application/problem+json": components["schemas"]["Problem"];
3559
+ };
3560
+ };
3561
+ };
3562
+ };
3563
+ list_pull_request_reviews: {
3564
+ parameters: {
3565
+ query?: {
3566
+ /**
3567
+ * @description `needed` lists terminal reviews of open pull requests with active
3568
+ * findings, FAILED/INCOMPLETE/STOPPED execution, or an earlier reviewed commit.
3569
+ */
3570
+ attention?: string | null;
3571
+ author?: string | null;
3572
+ cursor?: string | null;
3573
+ environment?: string | null;
3574
+ findings?: string | null;
3575
+ kind?: string | null;
3576
+ limit?: number | null;
3577
+ /** @description Qualifiers, quoted values, AND/OR, groups and minus exclusions. */
3578
+ query?: string | null;
3579
+ repository?: string | null;
3580
+ search?: string | null;
3581
+ status?: string | null;
3582
+ };
3583
+ header?: never;
3584
+ path: {
3585
+ org_id: string;
3586
+ pull_request_number: number;
3587
+ repository: string;
3588
+ };
3589
+ cookie?: never;
3590
+ };
3591
+ requestBody?: never;
3592
+ responses: {
3593
+ 200: {
3594
+ headers: {
3595
+ [name: string]: unknown;
3596
+ };
3597
+ content: {
3598
+ "application/json": components["schemas"]["ReviewPage"];
3599
+ };
3600
+ };
3601
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3602
+ default: {
3603
+ headers: {
3604
+ [name: string]: unknown;
3605
+ };
3606
+ content: {
3607
+ "application/problem+json": components["schemas"]["Problem"];
3608
+ };
3609
+ };
3610
+ };
3611
+ };
3612
+ get_pull_request_review: {
3613
+ parameters: {
3614
+ query?: never;
3615
+ header?: never;
3616
+ path: {
3617
+ org_id: string;
3618
+ pull_request_number: number;
3619
+ repository: string;
3620
+ run_number: number;
3621
+ };
3622
+ cookie?: never;
3623
+ };
3624
+ requestBody?: never;
3625
+ responses: {
3626
+ 200: {
3627
+ headers: {
3628
+ [name: string]: unknown;
3629
+ };
3630
+ content: {
3631
+ "application/json": components["schemas"]["CustomerReviewDetail"];
3632
+ };
3633
+ };
3634
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3635
+ default: {
3636
+ headers: {
3637
+ [name: string]: unknown;
3638
+ };
3639
+ content: {
3640
+ "application/problem+json": components["schemas"]["Problem"];
3641
+ };
3642
+ };
3643
+ };
3644
+ };
3645
+ get_review: {
3646
+ parameters: {
3647
+ query?: never;
3648
+ header?: never;
3649
+ path: {
3650
+ org_id: string;
3651
+ review_id: string;
3652
+ };
3653
+ cookie?: never;
3654
+ };
3655
+ requestBody?: never;
3656
+ responses: {
3657
+ 200: {
3658
+ headers: {
3659
+ [name: string]: unknown;
3660
+ };
3661
+ content: {
3662
+ "application/json": components["schemas"]["CustomerReviewDetail"];
3663
+ };
3664
+ };
3665
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3666
+ default: {
3667
+ headers: {
3668
+ [name: string]: unknown;
3669
+ };
3670
+ content: {
3671
+ "application/problem+json": components["schemas"]["Problem"];
3672
+ };
3673
+ };
3674
+ };
3675
+ };
3676
+ get_assessment: {
3677
+ parameters: {
3678
+ query?: never;
3679
+ header?: never;
3680
+ path: {
3681
+ assessment_id: string;
3682
+ org_id: string;
3683
+ review_id: string;
3684
+ };
3685
+ cookie?: never;
3686
+ };
3687
+ requestBody?: never;
3688
+ responses: {
3689
+ 200: {
3690
+ headers: {
3691
+ [name: string]: unknown;
3692
+ };
3693
+ content: {
3694
+ "application/json": components["schemas"]["CustomerAssessmentDetail"];
3695
+ };
3696
+ };
3697
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3698
+ default: {
3699
+ headers: {
3700
+ [name: string]: unknown;
3701
+ };
3702
+ content: {
3703
+ "application/problem+json": components["schemas"]["Problem"];
3704
+ };
3705
+ };
3706
+ };
3707
+ };
3708
+ rerun_review: {
3709
+ parameters: {
3710
+ query?: never;
3711
+ header?: never;
3712
+ path: {
3713
+ org_id: string;
3714
+ review_id: string;
3715
+ };
3716
+ cookie?: never;
3717
+ };
3718
+ requestBody?: never;
3719
+ responses: {
3720
+ /**
3721
+ * @description Manual rerun: a new review of the same immutable subjects, under a fresh
3722
+ * trigger key so history accumulates instead of overwriting.
3723
+ */
3724
+ 200: {
3725
+ headers: {
3726
+ [name: string]: unknown;
3727
+ };
3728
+ content: {
3729
+ "application/json": components["schemas"]["RerunResponse"];
3730
+ };
3731
+ };
3732
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3733
+ default: {
3734
+ headers: {
3735
+ [name: string]: unknown;
3736
+ };
3737
+ content: {
3738
+ "application/problem+json": components["schemas"]["Problem"];
3739
+ };
3740
+ };
3741
+ };
3742
+ };
3743
+ get_review_routing: {
3744
+ parameters: {
3745
+ query?: never;
3746
+ header?: never;
3747
+ path: {
3748
+ org_id: string;
3749
+ review_id: string;
3750
+ };
3751
+ cookie?: never;
3752
+ };
3753
+ requestBody?: never;
3754
+ responses: {
3755
+ 200: {
3756
+ headers: {
3757
+ [name: string]: unknown;
3758
+ };
3759
+ content: {
3760
+ "application/json": components["schemas"]["ReviewRoutingView"];
3761
+ };
3762
+ };
3763
+ /** @description An RFC 9457 problem; the HTTP status remains authoritative. */
3764
+ default: {
3765
+ headers: {
3766
+ [name: string]: unknown;
3767
+ };
3768
+ content: {
3769
+ "application/problem+json": components["schemas"]["Problem"];
3770
+ };
3771
+ };
3772
+ };
3773
+ };
3774
+ }