@proofline/sdk 2.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -263,24 +263,6 @@
263
263
  ],
264
264
  "type": "string"
265
265
  },
266
- "ApprovalGap": {
267
- "properties": {
268
- "assessment_id": {
269
- "description": "Assessment whose approval could not supply deferred occurrence questions.",
270
- "format": "uuid",
271
- "type": "string"
272
- },
273
- "code": {
274
- "description": "Reason the assessment's approval could not supply deferred occurrence questions.",
275
- "type": "string"
276
- }
277
- },
278
- "required": [
279
- "assessment_id",
280
- "code"
281
- ],
282
- "type": "object"
283
- },
284
266
  "AssessmentProjection": {
285
267
  "properties": {
286
268
  "assessment_id": {
@@ -325,111 +307,6 @@
325
307
  ],
326
308
  "type": "object"
327
309
  },
328
- "AttributedChange": {
329
- "description": "How one condition relates to the review's base revision.",
330
- "oneOf": [
331
- {
332
- "const": "INTRODUCED",
333
- "description": "The proposed revision holds the condition and the base did not.",
334
- "type": "string"
335
- },
336
- {
337
- "const": "CHANGED",
338
- "description": "The site held a different condition at the base.",
339
- "type": "string"
340
- },
341
- {
342
- "const": "UNCHANGED",
343
- "description": "The base already held this condition at this site. Pre-existing,\n not safe.",
344
- "type": "string"
345
- },
346
- {
347
- "const": "RESOLVED",
348
- "description": "The base held this condition and the proposed revision no longer does.",
349
- "type": "string"
350
- },
351
- {
352
- "const": "UNATTRIBUTED",
353
- "description": "World could not match the condition with its predecessor, such as a\n declaration that may have moved; its origin is unknown.",
354
- "type": "string"
355
- }
356
- ]
357
- },
358
- "AttributedConditionView": {
359
- "properties": {
360
- "change": {
361
- "allOf": [
362
- {
363
- "$ref": "#/components/schemas/AttributedChange"
364
- }
365
- ],
366
- "description": "How this condition relates to the review's base revision."
367
- },
368
- "reviewed_tree_citations": {
369
- "description": "The member that declares the site at each revision that declares it.",
370
- "items": {
371
- "$ref": "#/components/schemas/ReviewedTreeCitationView"
372
- },
373
- "type": "array"
374
- },
375
- "revision": {
376
- "allOf": [
377
- {
378
- "$ref": "#/components/schemas/AttributedRevision"
379
- }
380
- ],
381
- "description": "The revision that holds the condition: the base for `RESOLVED`, the\n proposed revision for `INTRODUCED`, `CHANGED` and `UNCHANGED`, and\n either for `UNATTRIBUTED`."
382
- },
383
- "subject": {
384
- "allOf": [
385
- {
386
- "$ref": "#/components/schemas/UntrustedText"
387
- }
388
- ],
389
- "description": "World's label of the condition's site and what it declares, such as\n `.github/workflows/ci.yml jobs.test.steps[0].uses: actions/checkout@v4`.\n It quotes repository text."
390
- }
391
- },
392
- "required": [
393
- "change",
394
- "revision",
395
- "subject",
396
- "reviewed_tree_citations"
397
- ],
398
- "type": "object"
399
- },
400
- "AttributedRevision": {
401
- "oneOf": [
402
- {
403
- "const": "PROPOSED_CODE_REVISION",
404
- "description": "The reviewed commit.",
405
- "type": "string"
406
- },
407
- {
408
- "const": "BASE_CODE_REVISION",
409
- "description": "Its merge base.",
410
- "type": "string"
411
- }
412
- ]
413
- },
414
- "AttributionStatus": {
415
- "oneOf": [
416
- {
417
- "const": "COMPARED",
418
- "description": "World read the complete set of conditions at both revisions.",
419
- "type": "string"
420
- },
421
- {
422
- "const": "UNAVAILABLE",
423
- "description": "World could not read one revision's conditions, so no condition is\n called new or old.",
424
- "type": "string"
425
- },
426
- {
427
- "const": "UNREADABLE",
428
- "description": "The receipt carries an attribution this build cannot read. No\n condition is called new or old.",
429
- "type": "string"
430
- }
431
- ]
432
- },
433
310
  "AuthorChoice": {
434
311
  "properties": {
435
312
  "id": {
@@ -450,180 +327,6 @@
450
327
  ],
451
328
  "type": "object"
452
329
  },
453
- "Authority": {
454
- "enum": [
455
- "ADVISORY",
456
- "DEPLOYMENT_POLICY"
457
- ],
458
- "type": "string"
459
- },
460
- "Availability": {
461
- "oneOf": [
462
- {
463
- "enum": [
464
- "RECORDED",
465
- "NOT_RECORDED",
466
- "LEGACY",
467
- "OPERATIONAL_FAILURE"
468
- ],
469
- "type": "string"
470
- },
471
- {
472
- "const": "LIMITED",
473
- "description": "The record is verified but too large for this projection to carry.\n Siblings still render; nothing is inferred from the omitted detail.",
474
- "type": "string"
475
- }
476
- ]
477
- },
478
- "CaptureState": {
479
- "description": "How the capture ended.",
480
- "oneOf": [
481
- {
482
- "const": "PENDING",
483
- "description": "Still waiting for an authorized execution or a decidable look.",
484
- "type": "string"
485
- },
486
- {
487
- "const": "RECORDED",
488
- "description": "World recorded every deferred question.",
489
- "type": "string"
490
- },
491
- {
492
- "const": "UNBOUND",
493
- "description": "At least one deferred question is not bound to the execution.",
494
- "type": "string"
495
- },
496
- {
497
- "const": "NOT_EXECUTED",
498
- "description": "The gate never authorized the execution.",
499
- "type": "string"
500
- },
501
- {
502
- "const": "INCOMPLETE",
503
- "description": "The capture failed before it wrote its receipt. The gate is\n unchanged; nothing is inferred about the deferred questions.",
504
- "type": "string"
505
- }
506
- ]
507
- },
508
- "ChangeAttributionView": {
509
- "description": "Which conditions behind a check's result the change brought, and which\n World found at the review's base revision. It sits beside the result and\n never changes it: a condition already at the base is still a condition.",
510
- "properties": {
511
- "complete_record": {
512
- "anyOf": [
513
- {
514
- "$ref": "#/components/schemas/CompleteRecordView"
515
- },
516
- {
517
- "type": "null"
518
- }
519
- ],
520
- "description": "Where every condition is recorded when some are omitted. Absent when\n `conditions` lists them all."
521
- },
522
- "condition_count": {
523
- "description": "How many conditions World attributed, listed or not. Zero unless\n `status` is `COMPARED`.",
524
- "format": "uint32",
525
- "minimum": 0,
526
- "type": "integer"
527
- },
528
- "conditions": {
529
- "description": "Every condition, each once, in World's order, never netted against\n another. Empty unless `status` is `COMPARED`, and empty when some are\n omitted: it never lists only some of them.",
530
- "items": {
531
- "$ref": "#/components/schemas/AttributedConditionView"
532
- },
533
- "type": "array"
534
- },
535
- "counts": {
536
- "description": "How many conditions there are of each change at each revision, over\n every condition, listed or not. Changes with none are left out.",
537
- "items": {
538
- "$ref": "#/components/schemas/ChangeCountView"
539
- },
540
- "type": "array"
541
- },
542
- "detail_code": {
543
- "description": "World's code for why it could not read that revision, such as\n `BASE_REVIEWED_TREE_NOT_DECLARED`. Present exactly when `status` is\n `UNAVAILABLE`.",
544
- "type": [
545
- "string",
546
- "null"
547
- ]
548
- },
549
- "listed_conditions": {
550
- "description": "The conditions a summary lists when some are omitted: the first ones\n in the order `counts` gives, each whole, at most 50 and always fewer\n than `condition_count`. Present exactly when `omitted_condition_count`\n is not zero.",
551
- "items": {
552
- "$ref": "#/components/schemas/AttributedConditionView"
553
- },
554
- "type": [
555
- "array",
556
- "null"
557
- ]
558
- },
559
- "omitted_condition_count": {
560
- "description": "How many of those conditions this response does not list. Zero when\n the result kept World's attribution whole. Otherwise the result kept a\n summary: `listed_conditions` lists the first ones, `counts` is still\n exact, and World's recorded evaluation holds every condition.",
561
- "format": "uint32",
562
- "minimum": 0,
563
- "type": "integer"
564
- },
565
- "revision": {
566
- "anyOf": [
567
- {
568
- "$ref": "#/components/schemas/AttributedRevision"
569
- },
570
- {
571
- "type": "null"
572
- }
573
- ],
574
- "description": "The revision World could not read. Present exactly when `status` is\n `UNAVAILABLE`."
575
- },
576
- "status": {
577
- "allOf": [
578
- {
579
- "$ref": "#/components/schemas/AttributionStatus"
580
- }
581
- ],
582
- "description": "Whether World compared both revisions, could not read one, or recorded\n an attribution this build cannot read."
583
- }
584
- },
585
- "required": [
586
- "status",
587
- "condition_count",
588
- "omitted_condition_count",
589
- "counts",
590
- "conditions"
591
- ],
592
- "type": "object"
593
- },
594
- "ChangeCountView": {
595
- "description": "How many conditions are of one change at one revision.",
596
- "properties": {
597
- "change": {
598
- "allOf": [
599
- {
600
- "$ref": "#/components/schemas/AttributedChange"
601
- }
602
- ],
603
- "description": "How the counted conditions relate to the review's base revision."
604
- },
605
- "count": {
606
- "description": "How many conditions have this `change` at this `revision`, over every\n condition, listed or not.",
607
- "format": "uint32",
608
- "minimum": 0,
609
- "type": "integer"
610
- },
611
- "revision": {
612
- "allOf": [
613
- {
614
- "$ref": "#/components/schemas/AttributedRevision"
615
- }
616
- ],
617
- "description": "The revision that holds the counted conditions."
618
- }
619
- },
620
- "required": [
621
- "change",
622
- "revision",
623
- "count"
624
- ],
625
- "type": "object"
626
- },
627
330
  "ChangeDiagramKindView": {
628
331
  "enum": [
629
332
  "FLOWCHART",
@@ -1073,24 +776,6 @@
1073
776
  ],
1074
777
  "type": "object"
1075
778
  },
1076
- "CompleteRecordView": {
1077
- "description": "World's immutable record of the complete answer an omitted list comes\n from.",
1078
- "properties": {
1079
- "attribution_digest": {
1080
- "description": "The `sha256:` digest of the complete attribution in that record.",
1081
- "type": "string"
1082
- },
1083
- "world_evaluation_id": {
1084
- "description": "The evaluation World recorded, which holds every condition.",
1085
- "type": "string"
1086
- }
1087
- },
1088
- "required": [
1089
- "world_evaluation_id",
1090
- "attribution_digest"
1091
- ],
1092
- "type": "object"
1093
- },
1094
779
  "CoverageRefused": {
1095
780
  "description": "An upload refused for its content: a symbolic or unknown commit, or a\n report that cannot be read. Nothing is stored.",
1096
781
  "properties": {
@@ -1203,28 +888,6 @@
1203
888
  "null"
1204
889
  ]
1205
890
  },
1206
- "decision_presentation": {
1207
- "anyOf": [
1208
- {
1209
- "$ref": "#/components/schemas/CustomerDecision"
1210
- },
1211
- {
1212
- "type": "null"
1213
- }
1214
- ],
1215
- "description": "The retained decision disclosure, which grants no deployment\n authorization. Absent when none is recorded and the review kind\n records no decision basis."
1216
- },
1217
- "declared_reach": {
1218
- "anyOf": [
1219
- {
1220
- "$ref": "#/components/schemas/DeclaredReachView"
1221
- },
1222
- {
1223
- "type": "null"
1224
- }
1225
- ],
1226
- "description": "What World declares depends on what this change deploys in this\n environment, at the assessment's pinned snapshot. Absent when the\n assessment's kind records no declared reach."
1227
- },
1228
891
  "domains": {
1229
892
  "description": "The risk domains the assessment evaluated, each with its status and\n reason, ordered by domain.",
1230
893
  "items": {
@@ -1313,28 +976,6 @@
1313
976
  "null"
1314
977
  ]
1315
978
  },
1316
- "decision_presentation": {
1317
- "anyOf": [
1318
- {
1319
- "$ref": "#/components/schemas/CustomerDecision"
1320
- },
1321
- {
1322
- "type": "null"
1323
- }
1324
- ],
1325
- "description": "The retained decision disclosure, which grants no deployment\n authorization. Absent when none is recorded and the review kind\n records no decision basis."
1326
- },
1327
- "declared_reach": {
1328
- "anyOf": [
1329
- {
1330
- "$ref": "#/components/schemas/DeclaredReachView"
1331
- },
1332
- {
1333
- "type": "null"
1334
- }
1335
- ],
1336
- "description": "What World declares depends on what this change deploys in this\n environment, at the assessment's pinned snapshot. Absent when the\n assessment's kind records no declared reach."
1337
- },
1338
979
  "domains": {
1339
980
  "description": "The risk domains the assessment evaluated, each with its status and\n reason, ordered by domain.",
1340
981
  "items": {
@@ -1421,17 +1062,6 @@
1421
1062
  },
1422
1063
  "CustomerCheck": {
1423
1064
  "properties": {
1424
- "change_attribution": {
1425
- "anyOf": [
1426
- {
1427
- "$ref": "#/components/schemas/ChangeAttributionView"
1428
- },
1429
- {
1430
- "type": "null"
1431
- }
1432
- ],
1433
- "description": "Which conditions behind the outcome the change brought and which were\n already at the review's base revision. It never changes the outcome:\n a condition already at the base is pre-existing, not safe. Absent for\n a check whose evaluator does not compare the two revisions."
1434
- },
1435
1065
  "detail": {
1436
1066
  "description": "Why World refused the check, or otherwise World's recorded explanation\n of the result. Null when neither is recorded.",
1437
1067
  "type": [
@@ -1585,83 +1215,6 @@
1585
1215
  ],
1586
1216
  "type": "object"
1587
1217
  },
1588
- "CustomerDecision": {
1589
- "properties": {
1590
- "authority": {
1591
- "allOf": [
1592
- {
1593
- "$ref": "#/components/schemas/Authority"
1594
- }
1595
- ],
1596
- "description": "Whether the decision is `ADVISORY` or comes from a `DEPLOYMENT_POLICY`."
1597
- },
1598
- "availability": {
1599
- "allOf": [
1600
- {
1601
- "$ref": "#/components/schemas/Availability"
1602
- }
1603
- ],
1604
- "description": "Whether a verified decision record is present, absent, legacy, failed,\n or too large for this projection."
1605
- },
1606
- "basis": {
1607
- "anyOf": [
1608
- {
1609
- "$ref": "#/components/schemas/CustomerDecisionBasis"
1610
- },
1611
- {
1612
- "type": "null"
1613
- }
1614
- ],
1615
- "description": "The permission, evidence classification and reason code of the\n verified recorded basis. Null when no verified basis is recorded."
1616
- },
1617
- "gate_state": {
1618
- "anyOf": [
1619
- {
1620
- "$ref": "#/components/schemas/GateState"
1621
- },
1622
- {
1623
- "type": "null"
1624
- }
1625
- ],
1626
- "description": "The local deployment gate state and any recorded override. Null unless\n the decision belongs to a deployment gate."
1627
- }
1628
- },
1629
- "required": [
1630
- "availability",
1631
- "authority"
1632
- ],
1633
- "type": "object"
1634
- },
1635
- "CustomerDecisionBasis": {
1636
- "properties": {
1637
- "evidence": {
1638
- "allOf": [
1639
- {
1640
- "$ref": "#/components/schemas/EvidenceView"
1641
- }
1642
- ],
1643
- "description": "How the recorded basis classified its evidence."
1644
- },
1645
- "permission": {
1646
- "allOf": [
1647
- {
1648
- "$ref": "#/components/schemas/PermissionView"
1649
- }
1650
- ],
1651
- "description": "The permission the recorded basis reached: `PERMIT` or `BLOCK`."
1652
- },
1653
- "reason_code": {
1654
- "description": "The reason code the recorded basis gives for its permission.",
1655
- "type": "string"
1656
- }
1657
- },
1658
- "required": [
1659
- "permission",
1660
- "evidence",
1661
- "reason_code"
1662
- ],
1663
- "type": "object"
1664
- },
1665
1218
  "CustomerEvidenceRef": {
1666
1219
  "properties": {
1667
1220
  "commit_sha": {
@@ -1959,6 +1512,13 @@
1959
1512
  "null"
1960
1513
  ]
1961
1514
  },
1515
+ "actor_name": {
1516
+ "description": "The actor's GitHub profile name, when known. Lead with it; the login\n is the fallback. Null for the automatic decision.",
1517
+ "type": [
1518
+ "string",
1519
+ "null"
1520
+ ]
1521
+ },
1962
1522
  "covering_author_kind": {
1963
1523
  "description": "For `ALREADY_COVERED`, `HUMAN` or `BOT`. Null for every other decision.",
1964
1524
  "type": [
@@ -2195,7 +1755,7 @@
2195
1755
  "type": "boolean"
2196
1756
  },
2197
1757
  "kind": {
2198
- "description": "`PULL_REQUEST`, `DEPLOYMENT`, `PATCH`, a review of local changes\n sent as a patch, `COMMIT`, a review of pushed commits, or `FILES`,\n complete selected files at one pushed commit.",
1758
+ "description": "`PULL_REQUEST`, `DEPLOYMENT`, `PATCH`, a review of local changes\n sent as a patch, `COMMIT`, a review of pushed commits, `FILES`,\n complete selected files at one pushed commit, or `MERGE_GROUP`, the\n commit GitHub's merge queue built for a group of pull requests.",
2199
1759
  "type": "string"
2200
1760
  },
2201
1761
  "local_reverifications": {
@@ -2216,6 +1776,14 @@
2216
1776
  ],
2217
1777
  "description": "The deterministic policy for this exact repository/head, when opted in.\n Its captured review owner and GitHub bypass remain separate history."
2218
1778
  },
1779
+ "merge_group_pull_request_numbers": {
1780
+ "description": "For a `MERGE_GROUP` review, the pull requests GitHub queued in the\n group, in number order. Absent for every other kind, and until\n Proofline has read the group's members.",
1781
+ "items": {
1782
+ "format": "int64",
1783
+ "type": "integer"
1784
+ },
1785
+ "type": "array"
1786
+ },
2219
1787
  "open_items": {
2220
1788
  "anyOf": [
2221
1789
  {
@@ -2275,6 +1843,13 @@
2275
1843
  "null"
2276
1844
  ]
2277
1845
  },
1846
+ "pull_request_author_name": {
1847
+ "description": "The author's GitHub profile name, when known. Lead with it; the login\n is the fallback. Display metadata, never identity.",
1848
+ "type": [
1849
+ "string",
1850
+ "null"
1851
+ ]
1852
+ },
2278
1853
  "pull_request_author_url": {
2279
1854
  "description": "The author's profile on the deployment's GitHub host. Absent when no author login is known.",
2280
1855
  "type": [
@@ -2497,79 +2072,6 @@
2497
2072
  ],
2498
2073
  "type": "string"
2499
2074
  },
2500
- "DeclaredReachOutcome": {
2501
- "enum": [
2502
- "READ",
2503
- "NO_ROOTS",
2504
- "ROOTS_UNKNOWN",
2505
- "UNAVAILABLE"
2506
- ],
2507
- "type": "string"
2508
- },
2509
- "DeclaredReachView": {
2510
- "description": "One assessment's declared reach receipt. A reached entity declares a\n dependency on what the change deploys; it is never a claim that the change\n breaks it.",
2511
- "properties": {
2512
- "complete": {
2513
- "description": "Whether World's walk ended with no gap. An empty, incomplete reach\n says nothing about what depends on the change.",
2514
- "type": "boolean"
2515
- },
2516
- "entities": {
2517
- "description": "Every reached entity, shorter paths first, then by kind.",
2518
- "items": {
2519
- "$ref": "#/components/schemas/ReachedEntityView"
2520
- },
2521
- "type": "array"
2522
- },
2523
- "gaps": {
2524
- "description": "Where World's walk or its evidence stopped.",
2525
- "items": {
2526
- "$ref": "#/components/schemas/ReachGapView"
2527
- },
2528
- "type": "array"
2529
- },
2530
- "outcome": {
2531
- "allOf": [
2532
- {
2533
- "$ref": "#/components/schemas/DeclaredReachOutcome"
2534
- }
2535
- ],
2536
- "description": "`READ` when World answered, `NO_ROOTS` when no evidence bound a\n deployed artifact or workload to the repository, `ROOTS_UNKNOWN` when\n World's evidence does not establish which revision runs, and\n `UNAVAILABLE` when World gave no answer. Only `READ` carries entities or gaps."
2537
- },
2538
- "receipt_digest": {
2539
- "description": "World's digest of its full answer. Null unless `READ`.",
2540
- "type": [
2541
- "string",
2542
- "null"
2543
- ]
2544
- },
2545
- "snapshot_id": {
2546
- "description": "The World snapshot the reach was read at. Null unless `READ`.",
2547
- "format": "uuid",
2548
- "type": [
2549
- "string",
2550
- "null"
2551
- ]
2552
- },
2553
- "terraform": {
2554
- "anyOf": [
2555
- {
2556
- "$ref": "#/components/schemas/TerraformRootsView"
2557
- },
2558
- {
2559
- "type": "null"
2560
- }
2561
- ],
2562
- "description": "The Terraform addresses the reach also started from, or why it took\n none. Absent when the assessment read reach only from the deployed\n revision."
2563
- }
2564
- },
2565
- "required": [
2566
- "outcome",
2567
- "complete",
2568
- "entities",
2569
- "gaps"
2570
- ],
2571
- "type": "object"
2572
- },
2573
2075
  "DeepReviewEscalation": {
2574
2076
  "properties": {
2575
2077
  "reason": {
@@ -2659,14 +2161,6 @@
2659
2161
  ],
2660
2162
  "type": "object"
2661
2163
  },
2662
- "EvidenceView": {
2663
- "enum": [
2664
- "REQUIRED_PROPERTIES_ESTABLISHED",
2665
- "INCOMPLETE",
2666
- "NO_APPLICABLE_OBLIGATIONS"
2667
- ],
2668
- "type": "string"
2669
- },
2670
2164
  "ExportEvidenceKind": {
2671
2165
  "enum": [
2672
2166
  "repository_file",
@@ -3749,37 +3243,6 @@
3749
3243
  ],
3750
3244
  "type": "object"
3751
3245
  },
3752
- "GateState": {
3753
- "properties": {
3754
- "occurrence_captures": {
3755
- "description": "The occurrence questions the gate's approval deferred, as each\n observed execution of its deployment answered them. Outcome-only\n records: none of them changes the gate or grades a prediction.",
3756
- "items": {
3757
- "$ref": "#/components/schemas/OccurrenceCapture"
3758
- },
3759
- "type": "array"
3760
- },
3761
- "override_record": {
3762
- "anyOf": [
3763
- {
3764
- "$ref": "#/components/schemas/Override"
3765
- },
3766
- {
3767
- "type": "null"
3768
- }
3769
- ],
3770
- "description": "Recorded override authorization, not confirmation of provider delivery."
3771
- },
3772
- "status": {
3773
- "description": "Local gate state. ALLOWED/BLOCKED can precede provider delivery.\n This field does not confirm that GitHub released or blocked a run.",
3774
- "type": "string"
3775
- }
3776
- },
3777
- "required": [
3778
- "status",
3779
- "occurrence_captures"
3780
- ],
3781
- "type": "object"
3782
- },
3783
3246
  "GateStatus": {
3784
3247
  "enum": [
3785
3248
  "REQUESTED",
@@ -3861,123 +3324,21 @@
3861
3324
  "type": "object"
3862
3325
  },
3863
3326
  "NotAssessedView": {
3864
- "properties": {
3865
- "environment_display_name": {
3866
- "description": "The display name of the environment whose assessment is not\n `COMPLETED`.",
3867
- "type": "string"
3868
- },
3869
- "incompleteness_kind": {
3870
- "description": "The assessment's recorded gap class. Absent is an unclassified gap,\n never a complete assessment.",
3871
- "type": [
3872
- "string",
3873
- "null"
3874
- ]
3875
- }
3876
- },
3877
- "required": [
3878
- "environment_display_name"
3879
- ],
3880
- "type": "object"
3881
- },
3882
- "OccurrenceCapture": {
3883
- "description": "The capture of one observed execution of a gate's deployment.",
3884
- "properties": {
3885
- "approval_gaps": {
3886
- "description": "Assessments whose approval could defer nothing, with the reason.",
3887
- "items": {
3888
- "$ref": "#/components/schemas/ApprovalGap"
3889
- },
3890
- "type": "array"
3891
- },
3892
- "detail": {
3893
- "description": "Explanation of the capture's outcome, when available.",
3894
- "type": [
3895
- "string",
3896
- "null"
3897
- ]
3898
- },
3899
- "occurrence_key": {
3900
- "description": "Retained identity of the deployment occurrence, when available.",
3901
- "type": [
3902
- "string",
3903
- "null"
3904
- ]
3905
- },
3906
- "questions": {
3907
- "description": "Deferred questions and their binding or observed results for this occurrence.",
3908
- "items": {
3909
- "$ref": "#/components/schemas/OccurrenceQuestion"
3910
- },
3911
- "type": "array"
3912
- },
3913
- "state": {
3914
- "allOf": [
3915
- {
3916
- "$ref": "#/components/schemas/CaptureState"
3917
- }
3918
- ],
3919
- "description": "Whether the capture is pending, recorded, unbound, not executed, or incomplete."
3920
- }
3921
- },
3922
- "required": [
3923
- "state",
3924
- "approval_gaps",
3925
- "questions"
3926
- ],
3927
- "type": "object"
3928
- },
3929
- "OccurrenceQuestion": {
3930
- "description": "One deferred question as the gate presents it.",
3931
- "properties": {
3932
- "assessment_id": {
3933
- "description": "Assessment whose approval deferred this question.",
3934
- "format": "uuid",
3935
- "type": "string"
3936
- },
3937
- "code": {
3938
- "description": "World's binding or refusal code, or the control plane's own gap.",
3939
- "type": [
3940
- "string",
3941
- "null"
3942
- ]
3943
- },
3944
- "family_key": {
3945
- "description": "Hypothesis family key for the deferred question.",
3327
+ "properties": {
3328
+ "environment_display_name": {
3329
+ "description": "The display name of the environment whose assessment is not\n `COMPLETED`.",
3946
3330
  "type": "string"
3947
3331
  },
3948
- "family_version": {
3949
- "description": "Hypothesis family version for the deferred question.",
3950
- "format": "int32",
3951
- "type": "integer"
3952
- },
3953
- "observed_result": {
3954
- "description": "World's observed result once it recorded the question.",
3955
- "type": [
3956
- "string",
3957
- "null"
3958
- ]
3959
- },
3960
- "outcome_id": {
3961
- "description": "World outcome record identifier, when an observed result was recorded.",
3332
+ "incompleteness_kind": {
3333
+ "description": "The assessment's recorded gap class. Absent is an unclassified gap,\n never a complete assessment.",
3962
3334
  "type": [
3963
3335
  "string",
3964
3336
  "null"
3965
3337
  ]
3966
- },
3967
- "state": {
3968
- "allOf": [
3969
- {
3970
- "$ref": "#/components/schemas/QuestionState"
3971
- }
3972
- ],
3973
- "description": "Whether the question is pending, recorded, unbound, or not executed."
3974
3338
  }
3975
3339
  },
3976
3340
  "required": [
3977
- "assessment_id",
3978
- "family_key",
3979
- "family_version",
3980
- "state"
3341
+ "environment_display_name"
3981
3342
  ],
3982
3343
  "type": "object"
3983
3344
  },
@@ -4186,37 +3547,6 @@
4186
3547
  ],
4187
3548
  "type": "string"
4188
3549
  },
4189
- "Override": {
4190
- "properties": {
4191
- "comment": {
4192
- "description": "The comment recorded with the approval, truncated past 8000\n characters.",
4193
- "type": [
4194
- "string",
4195
- "null"
4196
- ]
4197
- },
4198
- "github_environment_id": {
4199
- "description": "The GitHub environment ID the approval applied to.",
4200
- "format": "int64",
4201
- "type": "integer"
4202
- },
4203
- "github_user_id": {
4204
- "description": "The GitHub user ID of the person whose GitHub deployment approval\n overrode the gate.",
4205
- "format": "int64",
4206
- "type": "integer"
4207
- },
4208
- "github_user_login": {
4209
- "description": "That person's GitHub login as recorded with the approval, a display\n label truncated past 128 characters.",
4210
- "type": "string"
4211
- }
4212
- },
4213
- "required": [
4214
- "github_user_id",
4215
- "github_user_login",
4216
- "github_environment_id"
4217
- ],
4218
- "type": "object"
4219
- },
4220
3550
  "PassProjection": {
4221
3551
  "properties": {
4222
3552
  "model_binding": {
@@ -4334,13 +3664,6 @@
4334
3664
  ],
4335
3665
  "type": "object"
4336
3666
  },
4337
- "PermissionView": {
4338
- "enum": [
4339
- "PERMIT",
4340
- "BLOCK"
4341
- ],
4342
- "type": "string"
4343
- },
4344
3667
  "PlanProjection": {
4345
3668
  "properties": {
4346
3669
  "assessments": {
@@ -4623,105 +3946,6 @@
4623
3946
  ],
4624
3947
  "type": "object"
4625
3948
  },
4626
- "QuestionState": {
4627
- "description": "Where one deferred question stands.",
4628
- "oneOf": [
4629
- {
4630
- "const": "PENDING",
4631
- "description": "World has stored no record yet: the execution is not yet decidable\n inside the question's window.",
4632
- "type": "string"
4633
- },
4634
- {
4635
- "const": "RECORDED",
4636
- "description": "World recorded what the execution was observed to do.",
4637
- "type": "string"
4638
- },
4639
- {
4640
- "const": "UNBOUND",
4641
- "description": "The question is not bound to the execution: World's binding code, its\n refusal of the replay, or the control plane's own gap says why.",
4642
- "type": "string"
4643
- },
4644
- {
4645
- "const": "NOT_EXECUTED",
4646
- "description": "The gate never authorized the execution, so nothing ran to observe.",
4647
- "type": "string"
4648
- }
4649
- ]
4650
- },
4651
- "ReachGapView": {
4652
- "properties": {
4653
- "code": {
4654
- "description": "`COVERAGE_INCOMPLETE`, `SOURCE_CAPABILITY_MISSING` or `BOUND_REACHED`.",
4655
- "type": "string"
4656
- }
4657
- },
4658
- "required": [
4659
- "code"
4660
- ],
4661
- "type": "object"
4662
- },
4663
- "ReachStepView": {
4664
- "properties": {
4665
- "assertion_id": {
4666
- "description": "The World relation assertion behind this step.",
4667
- "format": "uuid",
4668
- "type": "string"
4669
- },
4670
- "direction": {
4671
- "description": "`OUT` when the step follows the relation from its subject, `IN` when\n it follows it back to the subject.",
4672
- "type": "string"
4673
- },
4674
- "relation": {
4675
- "description": "The relation key, such as `proofline.relation.consumes_api`.",
4676
- "type": "string"
4677
- }
4678
- },
4679
- "required": [
4680
- "assertion_id",
4681
- "relation",
4682
- "direction"
4683
- ],
4684
- "type": "object"
4685
- },
4686
- "ReachedEntityView": {
4687
- "properties": {
4688
- "entity_id": {
4689
- "description": "World's entity ID.",
4690
- "format": "uuid",
4691
- "type": "string"
4692
- },
4693
- "kind": {
4694
- "description": "The entity's kind, such as `service` or `queue`.",
4695
- "type": "string"
4696
- },
4697
- "label": {
4698
- "description": "World's display label for the entity: environment evidence for\n readers of this organization, never published to GitHub.",
4699
- "type": "string"
4700
- },
4701
- "path": {
4702
- "description": "The recorded relation assertions from the deployed root to the entity.",
4703
- "items": {
4704
- "$ref": "#/components/schemas/ReachStepView"
4705
- },
4706
- "type": "array"
4707
- },
4708
- "type_keys": {
4709
- "description": "World's registry type keys for the entity.",
4710
- "items": {
4711
- "type": "string"
4712
- },
4713
- "type": "array"
4714
- }
4715
- },
4716
- "required": [
4717
- "entity_id",
4718
- "kind",
4719
- "type_keys",
4720
- "label",
4721
- "path"
4722
- ],
4723
- "type": "object"
4724
- },
4725
3949
  "RefreshView": {
4726
3950
  "description": "A recorded refresh decision, as the console shows it.",
4727
3951
  "properties": {
@@ -5268,17 +4492,6 @@
5268
4492
  ],
5269
4493
  "description": "Safe routing projection bound to this review's retained inputs."
5270
4494
  },
5271
- "specialist_execution": {
5272
- "anyOf": [
5273
- {
5274
- "$ref": "#/components/schemas/SpecialistExecutionView"
5275
- },
5276
- {
5277
- "type": "null"
5278
- }
5279
- ],
5280
- "description": "Actual specialist selection and pass receipts for the applied workflow."
5281
- },
5282
4495
  "status": {
5283
4496
  "const": "SUPPORTED",
5284
4497
  "type": "string"
@@ -5357,9 +4570,17 @@
5357
4570
  "type": "string"
5358
4571
  },
5359
4572
  "kind": {
5360
- "description": "`PULL_REQUEST`, `DEPLOYMENT`, `PATCH`, a review of local changes\n sent as a patch, `COMMIT`, a review of pushed commits, or `FILES`,\n complete selected files at one pushed commit.",
4573
+ "description": "`PULL_REQUEST`, `DEPLOYMENT`, `PATCH`, a review of local changes\n sent as a patch, `COMMIT`, a review of pushed commits, `FILES`,\n complete selected files at one pushed commit, or `MERGE_GROUP`, the\n commit GitHub's merge queue built for a group of pull requests.",
5361
4574
  "type": "string"
5362
4575
  },
4576
+ "merge_group_pull_request_numbers": {
4577
+ "description": "For a `MERGE_GROUP` review, the pull requests GitHub queued in the\n group, in number order. Absent for every other kind, and until\n Proofline has read the group's members.",
4578
+ "items": {
4579
+ "format": "int64",
4580
+ "type": "integer"
4581
+ },
4582
+ "type": "array"
4583
+ },
5363
4584
  "public_key": {
5364
4585
  "description": "The review's stable public address: `rev_` followed by its identifier without hyphens.",
5365
4586
  "type": "string"
@@ -5397,6 +4618,13 @@
5397
4618
  "null"
5398
4619
  ]
5399
4620
  },
4621
+ "pull_request_author_name": {
4622
+ "description": "The author's GitHub profile name, when known. Lead with it; the login\n is the fallback. Display metadata, never identity.",
4623
+ "type": [
4624
+ "string",
4625
+ "null"
4626
+ ]
4627
+ },
5400
4628
  "pull_request_author_url": {
5401
4629
  "description": "The author's profile on the deployment's GitHub host. Absent when no author login is known.",
5402
4630
  "type": [
@@ -5504,45 +4732,6 @@
5504
4732
  ],
5505
4733
  "type": "object"
5506
4734
  },
5507
- "ReviewedTreeCitationView": {
5508
- "description": "One member of a review's declared tree that World cited.",
5509
- "properties": {
5510
- "content_sha256": {
5511
- "description": "The member's content hash. Absent for a member a `REJECTED`\n population refused, because such a population keeps no members.",
5512
- "type": [
5513
- "string",
5514
- "null"
5515
- ]
5516
- },
5517
- "overlay_digest": {
5518
- "description": "The overlay World read the member from.",
5519
- "type": "string"
5520
- },
5521
- "path": {
5522
- "allOf": [
5523
- {
5524
- "$ref": "#/components/schemas/UntrustedText"
5525
- }
5526
- ],
5527
- "description": "The member's path in the repository at that revision. Repository\n text, so it can hold bidirectional controls that reorder what the\n reader sees."
5528
- },
5529
- "population_kind": {
5530
- "description": "The population the member belongs to, such as\n `WORKFLOW_DEFINITIONS`.",
5531
- "type": "string"
5532
- },
5533
- "role": {
5534
- "description": "`PROPOSED_CODE_REVISION` (the reviewed commit) or\n `BASE_CODE_REVISION` (its merge base).",
5535
- "type": "string"
5536
- }
5537
- },
5538
- "required": [
5539
- "role",
5540
- "population_kind",
5541
- "path",
5542
- "overlay_digest"
5543
- ],
5544
- "type": "object"
5545
- },
5546
4735
  "ReviewsExportRow": {
5547
4736
  "description": "The NDJSON row and CSV column contract. Repository names are display data;\n the stable repository ID and recorded commit identify the reviewed input.",
5548
4737
  "properties": {
@@ -6047,108 +5236,6 @@
6047
5236
  ],
6048
5237
  "type": "object"
6049
5238
  },
6050
- "SpecialistAssessmentExecution": {
6051
- "properties": {
6052
- "assessment_id": {
6053
- "description": "The immutable assessment whose specialist execution is reported.",
6054
- "format": "uuid",
6055
- "type": "string"
6056
- },
6057
- "passes": {
6058
- "description": "Selected specialist passes and their retained execution outputs.",
6059
- "items": {
6060
- "$ref": "#/components/schemas/SpecialistPassExecution"
6061
- },
6062
- "type": "array"
6063
- }
6064
- },
6065
- "required": [
6066
- "assessment_id",
6067
- "passes"
6068
- ],
6069
- "type": "object"
6070
- },
6071
- "SpecialistExecutionView": {
6072
- "properties": {
6073
- "assessments": {
6074
- "description": "The applied specialist roster per exact assessment execution.",
6075
- "items": {
6076
- "$ref": "#/components/schemas/SpecialistAssessmentExecution"
6077
- },
6078
- "type": "array"
6079
- },
6080
- "selection_recorded": {
6081
- "description": "False until the applied parent captures its specialist choices.",
6082
- "type": "boolean"
6083
- }
6084
- },
6085
- "required": [
6086
- "selection_recorded",
6087
- "assessments"
6088
- ],
6089
- "type": "object"
6090
- },
6091
- "SpecialistOutputProjection": {
6092
- "description": "A pass receipt's bounded operational facts, without its proposals or prose.",
6093
- "properties": {
6094
- "gap_kind": {
6095
- "description": "Closed evidence-gap class, absent when the pass produced output.",
6096
- "type": [
6097
- "string",
6098
- "null"
6099
- ]
6100
- },
6101
- "output_sha256": {
6102
- "description": "Verified digest of the retained output bytes.",
6103
- "type": "string"
6104
- },
6105
- "status": {
6106
- "description": "`PRODUCED`, `UNAVAILABLE`, `INCOMPLETE` or `MALFORMED`.",
6107
- "type": "string"
6108
- }
6109
- },
6110
- "required": [
6111
- "status",
6112
- "output_sha256"
6113
- ],
6114
- "type": "object"
6115
- },
6116
- "SpecialistPassExecution": {
6117
- "properties": {
6118
- "files": {
6119
- "description": "Exact selected paths from the validated captured change.",
6120
- "items": {
6121
- "type": "string"
6122
- },
6123
- "type": "array"
6124
- },
6125
- "floor": {
6126
- "description": "Whether captured file facts required this pass.",
6127
- "type": "boolean"
6128
- },
6129
- "name": {
6130
- "description": "Closed registry key of the selected specialist.",
6131
- "type": "string"
6132
- },
6133
- "output": {
6134
- "anyOf": [
6135
- {
6136
- "$ref": "#/components/schemas/SpecialistOutputProjection"
6137
- },
6138
- {
6139
- "type": "null"
6140
- }
6141
- ],
6142
- "description": "Missing means selected, with no retained output. It never means success."
6143
- }
6144
- },
6145
- "required": [
6146
- "name",
6147
- "files",
6148
- "floor"
6149
- ],
6150
- "type": "object"
6151
- },
6152
5239
  "SpendAccountKind": {
6153
5240
  "enum": [
6154
5241
  "DEPLOYMENT",
@@ -6419,48 +5506,6 @@
6419
5506
  ],
6420
5507
  "type": "string"
6421
5508
  },
6422
- "TerraformPlanView": {
6423
- "enum": [
6424
- "TAKEN",
6425
- "NOT_DECLARED",
6426
- "NOT_PINNED",
6427
- "HEAD_DIFFERS",
6428
- "ADDRESSES_UNREPORTED"
6429
- ],
6430
- "type": "string"
6431
- },
6432
- "TerraformRootsView": {
6433
- "description": "The Terraform roots of one declared reach read.",
6434
- "properties": {
6435
- "addresses": {
6436
- "description": "The changed resource instance addresses taken as roots.",
6437
- "items": {
6438
- "type": "string"
6439
- },
6440
- "type": "array"
6441
- },
6442
- "omitted": {
6443
- "description": "Changed addresses left out at World's limit of 100 roots per read.",
6444
- "format": "uint",
6445
- "minimum": 0,
6446
- "type": "integer"
6447
- },
6448
- "plan": {
6449
- "allOf": [
6450
- {
6451
- "$ref": "#/components/schemas/TerraformPlanView"
6452
- }
6453
- ],
6454
- "description": "`TAKEN` when the plan pinned for the reviewed commit named the roots,\n `NOT_DECLARED` when the environment captures no Terraform plan for this\n review, `NOT_PINNED` when it declares one and none was pinned,\n `HEAD_DIFFERS` when the pinned plan is for another commit, and\n `ADDRESSES_UNREPORTED` when the pinned plan records no changed\n addresses because it was pinned before World reported them."
6455
- }
6456
- },
6457
- "required": [
6458
- "plan",
6459
- "addresses",
6460
- "omitted"
6461
- ],
6462
- "type": "object"
6463
- },
6464
5509
  "ThreadObservationFreshness": {
6465
5510
  "enum": [
6466
5511
  "FRESH",
@@ -6724,7 +5769,7 @@
6724
5769
  },
6725
5770
  "info": {
6726
5771
  "title": "Proofline Review API",
6727
- "version": "2.0.0"
5772
+ "version": "3.1.0"
6728
5773
  },
6729
5774
  "openapi": "3.1.0",
6730
5775
  "paths": {