@proofline/sdk 2.0.0 → 3.0.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": [
@@ -2275,6 +1835,13 @@
2275
1835
  "null"
2276
1836
  ]
2277
1837
  },
1838
+ "pull_request_author_name": {
1839
+ "description": "The author's GitHub profile name, when known. Lead with it; the login\n is the fallback. Display metadata, never identity.",
1840
+ "type": [
1841
+ "string",
1842
+ "null"
1843
+ ]
1844
+ },
2278
1845
  "pull_request_author_url": {
2279
1846
  "description": "The author's profile on the deployment's GitHub host. Absent when no author login is known.",
2280
1847
  "type": [
@@ -2497,79 +2064,6 @@
2497
2064
  ],
2498
2065
  "type": "string"
2499
2066
  },
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
2067
  "DeepReviewEscalation": {
2574
2068
  "properties": {
2575
2069
  "reason": {
@@ -2659,14 +2153,6 @@
2659
2153
  ],
2660
2154
  "type": "object"
2661
2155
  },
2662
- "EvidenceView": {
2663
- "enum": [
2664
- "REQUIRED_PROPERTIES_ESTABLISHED",
2665
- "INCOMPLETE",
2666
- "NO_APPLICABLE_OBLIGATIONS"
2667
- ],
2668
- "type": "string"
2669
- },
2670
2156
  "ExportEvidenceKind": {
2671
2157
  "enum": [
2672
2158
  "repository_file",
@@ -3749,37 +3235,6 @@
3749
3235
  ],
3750
3236
  "type": "object"
3751
3237
  },
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
3238
  "GateStatus": {
3784
3239
  "enum": [
3785
3240
  "REQUESTED",
@@ -3855,129 +3310,27 @@
3855
3310
  },
3856
3311
  "required": [
3857
3312
  "review_id",
3858
- "finding_id",
3859
- "created_at"
3860
- ],
3861
- "type": "object"
3862
- },
3863
- "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.",
3313
+ "finding_id",
3314
+ "created_at"
3315
+ ],
3316
+ "type": "object"
3317
+ },
3318
+ "NotAssessedView": {
3319
+ "properties": {
3320
+ "environment_display_name": {
3321
+ "description": "The display name of the environment whose assessment is not\n `COMPLETED`.",
3946
3322
  "type": "string"
3947
3323
  },
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.",
3324
+ "incompleteness_kind": {
3325
+ "description": "The assessment's recorded gap class. Absent is an unclassified gap,\n never a complete assessment.",
3962
3326
  "type": [
3963
3327
  "string",
3964
3328
  "null"
3965
3329
  ]
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
3330
  }
3975
3331
  },
3976
3332
  "required": [
3977
- "assessment_id",
3978
- "family_key",
3979
- "family_version",
3980
- "state"
3333
+ "environment_display_name"
3981
3334
  ],
3982
3335
  "type": "object"
3983
3336
  },
@@ -4186,37 +3539,6 @@
4186
3539
  ],
4187
3540
  "type": "string"
4188
3541
  },
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
3542
  "PassProjection": {
4221
3543
  "properties": {
4222
3544
  "model_binding": {
@@ -4334,13 +3656,6 @@
4334
3656
  ],
4335
3657
  "type": "object"
4336
3658
  },
4337
- "PermissionView": {
4338
- "enum": [
4339
- "PERMIT",
4340
- "BLOCK"
4341
- ],
4342
- "type": "string"
4343
- },
4344
3659
  "PlanProjection": {
4345
3660
  "properties": {
4346
3661
  "assessments": {
@@ -4623,105 +3938,6 @@
4623
3938
  ],
4624
3939
  "type": "object"
4625
3940
  },
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
3941
  "RefreshView": {
4726
3942
  "description": "A recorded refresh decision, as the console shows it.",
4727
3943
  "properties": {
@@ -5268,17 +4484,6 @@
5268
4484
  ],
5269
4485
  "description": "Safe routing projection bound to this review's retained inputs."
5270
4486
  },
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
4487
  "status": {
5283
4488
  "const": "SUPPORTED",
5284
4489
  "type": "string"
@@ -5397,6 +4602,13 @@
5397
4602
  "null"
5398
4603
  ]
5399
4604
  },
4605
+ "pull_request_author_name": {
4606
+ "description": "The author's GitHub profile name, when known. Lead with it; the login\n is the fallback. Display metadata, never identity.",
4607
+ "type": [
4608
+ "string",
4609
+ "null"
4610
+ ]
4611
+ },
5400
4612
  "pull_request_author_url": {
5401
4613
  "description": "The author's profile on the deployment's GitHub host. Absent when no author login is known.",
5402
4614
  "type": [
@@ -5504,45 +4716,6 @@
5504
4716
  ],
5505
4717
  "type": "object"
5506
4718
  },
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
4719
  "ReviewsExportRow": {
5547
4720
  "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
4721
  "properties": {
@@ -6047,108 +5220,6 @@
6047
5220
  ],
6048
5221
  "type": "object"
6049
5222
  },
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
5223
  "SpendAccountKind": {
6153
5224
  "enum": [
6154
5225
  "DEPLOYMENT",
@@ -6419,48 +5490,6 @@
6419
5490
  ],
6420
5491
  "type": "string"
6421
5492
  },
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
5493
  "ThreadObservationFreshness": {
6465
5494
  "enum": [
6466
5495
  "FRESH",
@@ -6724,7 +5753,7 @@
6724
5753
  },
6725
5754
  "info": {
6726
5755
  "title": "Proofline Review API",
6727
- "version": "2.0.0"
5756
+ "version": "3.0.0"
6728
5757
  },
6729
5758
  "openapi": "3.1.0",
6730
5759
  "paths": {