@proofline/sdk 1.0.4 → 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",
@@ -763,6 +466,47 @@
763
466
  ],
764
467
  "type": "object"
765
468
  },
469
+ "CheckFile": {
470
+ "description": "One file World cited for a check's result.",
471
+ "properties": {
472
+ "path": {
473
+ "allOf": [
474
+ {
475
+ "$ref": "#/components/schemas/UntrustedText"
476
+ }
477
+ ],
478
+ "description": "The repository-relative path. It is repository text."
479
+ },
480
+ "revision": {
481
+ "allOf": [
482
+ {
483
+ "$ref": "#/components/schemas/CheckFileRevision"
484
+ }
485
+ ],
486
+ "description": "The revision World read the file at."
487
+ }
488
+ },
489
+ "required": [
490
+ "revision",
491
+ "path"
492
+ ],
493
+ "type": "object"
494
+ },
495
+ "CheckFileRevision": {
496
+ "description": "The revision a cited file was read at.",
497
+ "oneOf": [
498
+ {
499
+ "const": "PROPOSED_CODE_REVISION",
500
+ "description": "The reviewed commit.",
501
+ "type": "string"
502
+ },
503
+ {
504
+ "const": "BASE_CODE_REVISION",
505
+ "description": "Its merge base.",
506
+ "type": "string"
507
+ }
508
+ ]
509
+ },
766
510
  "CheckLifecycle": {
767
511
  "description": "World's lifecycle disclosure for the evaluator version that answered, as\n the receipt recorded it. A deployment gate counts only `GATING` results\n (`DeterministicCoverage::gate_effective_status`), and only when it\n evaluates a deployment; the lifecycle alone permits or blocks nothing.",
768
512
  "oneOf": [
@@ -793,6 +537,103 @@
793
537
  }
794
538
  ]
795
539
  },
540
+ "CiFailureAttribution": {
541
+ "description": "What the control plane records as a failure's cause.",
542
+ "enum": [
543
+ "CAUSED_BY_CHANGE",
544
+ "PRE_EXISTING_ON_BASE",
545
+ "FLAKY_OR_INFRASTRUCTURE",
546
+ "ENVIRONMENT_STATE",
547
+ "UNKNOWN"
548
+ ],
549
+ "type": "string"
550
+ },
551
+ "CiFailureLine": {
552
+ "description": "One failed CI job as the Check states it.",
553
+ "properties": {
554
+ "attribution": {
555
+ "allOf": [
556
+ {
557
+ "$ref": "#/components/schemas/CiFailureAttribution"
558
+ }
559
+ ],
560
+ "description": "The recorded cause: `CAUSED_BY_CHANGE`, `PRE_EXISTING_ON_BASE`,\n `FLAKY_OR_INFRASTRUCTURE`, `ENVIRONMENT_STATE` or `UNKNOWN`. `UNKNOWN`\n means the failure was not diagnosed, and `undiagnosed` says why."
561
+ },
562
+ "failed_step": {
563
+ "description": "The first failed step's name, admitted the same way. Null when no\n step concluded as failed.",
564
+ "type": [
565
+ "string",
566
+ "null"
567
+ ]
568
+ },
569
+ "job_name": {
570
+ "description": "The job's name as the diagnosis admitted it: masked, or `<withheld>`.\n A protected value of the observing review reads as the withheld\n marker.",
571
+ "type": "string"
572
+ },
573
+ "run_attempt": {
574
+ "description": "The GitHub Actions run attempt the job failed in, from 1. The line\n is the newest diagnosed attempt of its run.",
575
+ "format": "int64",
576
+ "type": "integer"
577
+ },
578
+ "timed_out": {
579
+ "description": "Whether the job timed out rather than failed.",
580
+ "type": "boolean"
581
+ },
582
+ "undiagnosed": {
583
+ "anyOf": [
584
+ {
585
+ "$ref": "#/components/schemas/CiFailureUndiagnosed"
586
+ },
587
+ {
588
+ "type": "null"
589
+ }
590
+ ],
591
+ "description": "Why the failure was not diagnosed. Set exactly when `attribution` is\n `UNKNOWN`."
592
+ }
593
+ },
594
+ "required": [
595
+ "job_name",
596
+ "timed_out",
597
+ "run_attempt",
598
+ "attribution"
599
+ ],
600
+ "type": "object"
601
+ },
602
+ "CiFailureUndiagnosed": {
603
+ "description": "Why a failed job's attribution is `UNKNOWN`.",
604
+ "oneOf": [
605
+ {
606
+ "const": "LOG_UNAVAILABLE",
607
+ "description": "GitHub returned no log for the job.",
608
+ "type": "string"
609
+ },
610
+ {
611
+ "const": "LOG_TOO_LARGE",
612
+ "description": "The complete log exceeds the read bound.",
613
+ "type": "string"
614
+ },
615
+ {
616
+ "const": "LOG_NOT_ADMITTED",
617
+ "description": "The log could not cross the credential mask or protected-value\n admission. The console names which.",
618
+ "type": "string"
619
+ },
620
+ {
621
+ "const": "DECISION_UNAVAILABLE",
622
+ "description": "The attribution decision fell back: Jev was unavailable or refused.",
623
+ "type": "string"
624
+ },
625
+ {
626
+ "const": "SHADOW",
627
+ "description": "The attribution decision runs in shadow mode, so its answer is not\n applied.",
628
+ "type": "string"
629
+ },
630
+ {
631
+ "const": "UNDETERMINED",
632
+ "description": "The decision applied no cause.",
633
+ "type": "string"
634
+ }
635
+ ]
636
+ },
796
637
  "CodeAssessmentStatus": {
797
638
  "description": "A code assessment's recorded execution status. It is never a verdict on\n the change: only `COMPLETED` says the assessment covered what it read.",
798
639
  "oneOf": [
@@ -935,24 +776,6 @@
935
776
  ],
936
777
  "type": "object"
937
778
  },
938
- "CompleteRecordView": {
939
- "description": "World's immutable record of the complete answer an omitted list comes\n from.",
940
- "properties": {
941
- "attribution_digest": {
942
- "description": "The `sha256:` digest of the complete attribution in that record.",
943
- "type": "string"
944
- },
945
- "world_evaluation_id": {
946
- "description": "The evaluation World recorded, which holds every condition.",
947
- "type": "string"
948
- }
949
- },
950
- "required": [
951
- "world_evaluation_id",
952
- "attribution_digest"
953
- ],
954
- "type": "object"
955
- },
956
779
  "CoverageRefused": {
957
780
  "description": "An upload refused for its content: a symbolic or unknown commit, or a\n report that cannot be read. Nothing is stored.",
958
781
  "properties": {
@@ -1065,28 +888,6 @@
1065
888
  "null"
1066
889
  ]
1067
890
  },
1068
- "decision_presentation": {
1069
- "anyOf": [
1070
- {
1071
- "$ref": "#/components/schemas/CustomerDecision"
1072
- },
1073
- {
1074
- "type": "null"
1075
- }
1076
- ],
1077
- "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."
1078
- },
1079
- "declared_reach": {
1080
- "anyOf": [
1081
- {
1082
- "$ref": "#/components/schemas/DeclaredReachView"
1083
- },
1084
- {
1085
- "type": "null"
1086
- }
1087
- ],
1088
- "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."
1089
- },
1090
891
  "domains": {
1091
892
  "description": "The risk domains the assessment evaluated, each with its status and\n reason, ordered by domain.",
1092
893
  "items": {
@@ -1175,28 +976,6 @@
1175
976
  "null"
1176
977
  ]
1177
978
  },
1178
- "decision_presentation": {
1179
- "anyOf": [
1180
- {
1181
- "$ref": "#/components/schemas/CustomerDecision"
1182
- },
1183
- {
1184
- "type": "null"
1185
- }
1186
- ],
1187
- "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."
1188
- },
1189
- "declared_reach": {
1190
- "anyOf": [
1191
- {
1192
- "$ref": "#/components/schemas/DeclaredReachView"
1193
- },
1194
- {
1195
- "type": "null"
1196
- }
1197
- ],
1198
- "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."
1199
- },
1200
979
  "domains": {
1201
980
  "description": "The risk domains the assessment evaluated, each with its status and\n reason, ordered by domain.",
1202
981
  "items": {
@@ -1282,18 +1061,7 @@
1282
1061
  "type": "object"
1283
1062
  },
1284
1063
  "CustomerCheck": {
1285
- "properties": {
1286
- "change_attribution": {
1287
- "anyOf": [
1288
- {
1289
- "$ref": "#/components/schemas/ChangeAttributionView"
1290
- },
1291
- {
1292
- "type": "null"
1293
- }
1294
- ],
1295
- "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."
1296
- },
1064
+ "properties": {
1297
1065
  "detail": {
1298
1066
  "description": "Why World refused the check, or otherwise World's recorded explanation\n of the result. Null when neither is recorded.",
1299
1067
  "type": [
@@ -1308,6 +1076,13 @@
1308
1076
  "null"
1309
1077
  ]
1310
1078
  },
1079
+ "files": {
1080
+ "description": "The files World cited as evidence for this result, once each in\n World's order, with the revision World read each at. Empty when World\n cited no file, and on results recorded before World cited files.",
1081
+ "items": {
1082
+ "$ref": "#/components/schemas/CheckFile"
1083
+ },
1084
+ "type": "array"
1085
+ },
1311
1086
  "lifecycle": {
1312
1087
  "allOf": [
1313
1088
  {
@@ -1339,7 +1114,8 @@
1339
1114
  "required": [
1340
1115
  "name",
1341
1116
  "outcome",
1342
- "lifecycle"
1117
+ "lifecycle",
1118
+ "files"
1343
1119
  ],
1344
1120
  "type": "object"
1345
1121
  },
@@ -1383,6 +1159,13 @@
1383
1159
  "null"
1384
1160
  ]
1385
1161
  },
1162
+ "coverage_details": {
1163
+ "description": "Recorded check coverage counts and fixed cancellation causes, without source text.\n Absent coverage does not establish that every check ran.",
1164
+ "items": {
1165
+ "type": "string"
1166
+ },
1167
+ "type": "array"
1168
+ },
1386
1169
  "findings": {
1387
1170
  "description": "The code-only findings the code assessment recorded, `SERIOUS` first.\n An empty list does not establish deployment safety.",
1388
1171
  "items": {
@@ -1432,83 +1215,6 @@
1432
1215
  ],
1433
1216
  "type": "object"
1434
1217
  },
1435
- "CustomerDecision": {
1436
- "properties": {
1437
- "authority": {
1438
- "allOf": [
1439
- {
1440
- "$ref": "#/components/schemas/Authority"
1441
- }
1442
- ],
1443
- "description": "Whether the decision is `ADVISORY` or comes from a `DEPLOYMENT_POLICY`."
1444
- },
1445
- "availability": {
1446
- "allOf": [
1447
- {
1448
- "$ref": "#/components/schemas/Availability"
1449
- }
1450
- ],
1451
- "description": "Whether a verified decision record is present, absent, legacy, failed,\n or too large for this projection."
1452
- },
1453
- "basis": {
1454
- "anyOf": [
1455
- {
1456
- "$ref": "#/components/schemas/CustomerDecisionBasis"
1457
- },
1458
- {
1459
- "type": "null"
1460
- }
1461
- ],
1462
- "description": "The permission, evidence classification and reason code of the\n verified recorded basis. Null when no verified basis is recorded."
1463
- },
1464
- "gate_state": {
1465
- "anyOf": [
1466
- {
1467
- "$ref": "#/components/schemas/GateState"
1468
- },
1469
- {
1470
- "type": "null"
1471
- }
1472
- ],
1473
- "description": "The local deployment gate state and any recorded override. Null unless\n the decision belongs to a deployment gate."
1474
- }
1475
- },
1476
- "required": [
1477
- "availability",
1478
- "authority"
1479
- ],
1480
- "type": "object"
1481
- },
1482
- "CustomerDecisionBasis": {
1483
- "properties": {
1484
- "evidence": {
1485
- "allOf": [
1486
- {
1487
- "$ref": "#/components/schemas/EvidenceView"
1488
- }
1489
- ],
1490
- "description": "How the recorded basis classified its evidence."
1491
- },
1492
- "permission": {
1493
- "allOf": [
1494
- {
1495
- "$ref": "#/components/schemas/PermissionView"
1496
- }
1497
- ],
1498
- "description": "The permission the recorded basis reached: `PERMIT` or `BLOCK`."
1499
- },
1500
- "reason_code": {
1501
- "description": "The reason code the recorded basis gives for its permission.",
1502
- "type": "string"
1503
- }
1504
- },
1505
- "required": [
1506
- "permission",
1507
- "evidence",
1508
- "reason_code"
1509
- ],
1510
- "type": "object"
1511
- },
1512
1218
  "CustomerEvidenceRef": {
1513
1219
  "properties": {
1514
1220
  "commit_sha": {
@@ -1698,6 +1404,13 @@
1698
1404
  "description": "The finding's recorded lifecycle state: `NEW`, `UNCHANGED`, `RESOLVED`\n or `REINTRODUCED`.",
1699
1405
  "type": "string"
1700
1406
  },
1407
+ "local_findings": {
1408
+ "description": "Earlier occurrences in the author's local reviews linked by exact patch\n identity. These links carry no verdict or finding decision.",
1409
+ "items": {
1410
+ "$ref": "#/components/schemas/MatchedLocalFinding"
1411
+ },
1412
+ "type": "array"
1413
+ },
1701
1414
  "placement": {
1702
1415
  "anyOf": [
1703
1416
  {
@@ -1799,6 +1512,13 @@
1799
1512
  "null"
1800
1513
  ]
1801
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
+ },
1802
1522
  "covering_author_kind": {
1803
1523
  "description": "For `ALREADY_COVERED`, `HUMAN` or `BOT`. Null for every other decision.",
1804
1524
  "type": [
@@ -2115,6 +1835,13 @@
2115
1835
  "null"
2116
1836
  ]
2117
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
+ },
2118
1845
  "pull_request_author_url": {
2119
1846
  "description": "The author's profile on the deployment's GitHub host. Absent when no author login is known.",
2120
1847
  "type": [
@@ -2337,79 +2064,6 @@
2337
2064
  ],
2338
2065
  "type": "string"
2339
2066
  },
2340
- "DeclaredReachOutcome": {
2341
- "enum": [
2342
- "READ",
2343
- "NO_ROOTS",
2344
- "ROOTS_UNKNOWN",
2345
- "UNAVAILABLE"
2346
- ],
2347
- "type": "string"
2348
- },
2349
- "DeclaredReachView": {
2350
- "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.",
2351
- "properties": {
2352
- "complete": {
2353
- "description": "Whether World's walk ended with no gap. An empty, incomplete reach\n says nothing about what depends on the change.",
2354
- "type": "boolean"
2355
- },
2356
- "entities": {
2357
- "description": "Every reached entity, shorter paths first, then by kind.",
2358
- "items": {
2359
- "$ref": "#/components/schemas/ReachedEntityView"
2360
- },
2361
- "type": "array"
2362
- },
2363
- "gaps": {
2364
- "description": "Where World's walk or its evidence stopped.",
2365
- "items": {
2366
- "$ref": "#/components/schemas/ReachGapView"
2367
- },
2368
- "type": "array"
2369
- },
2370
- "outcome": {
2371
- "allOf": [
2372
- {
2373
- "$ref": "#/components/schemas/DeclaredReachOutcome"
2374
- }
2375
- ],
2376
- "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."
2377
- },
2378
- "receipt_digest": {
2379
- "description": "World's digest of its full answer. Null unless `READ`.",
2380
- "type": [
2381
- "string",
2382
- "null"
2383
- ]
2384
- },
2385
- "snapshot_id": {
2386
- "description": "The World snapshot the reach was read at. Null unless `READ`.",
2387
- "format": "uuid",
2388
- "type": [
2389
- "string",
2390
- "null"
2391
- ]
2392
- },
2393
- "terraform": {
2394
- "anyOf": [
2395
- {
2396
- "$ref": "#/components/schemas/TerraformRootsView"
2397
- },
2398
- {
2399
- "type": "null"
2400
- }
2401
- ],
2402
- "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."
2403
- }
2404
- },
2405
- "required": [
2406
- "outcome",
2407
- "complete",
2408
- "entities",
2409
- "gaps"
2410
- ],
2411
- "type": "object"
2412
- },
2413
2067
  "DeepReviewEscalation": {
2414
2068
  "properties": {
2415
2069
  "reason": {
@@ -2462,13 +2116,42 @@
2462
2116
  ],
2463
2117
  "type": "object"
2464
2118
  },
2465
- "EvidenceView": {
2466
- "enum": [
2467
- "REQUIRED_PROPERTIES_ESTABLISHED",
2468
- "INCOMPLETE",
2469
- "NO_APPLICABLE_OBLIGATIONS"
2119
+ "EarlierOpenFinding": {
2120
+ "description": "A published occurrence of an unresolved series absent from the current run.",
2121
+ "properties": {
2122
+ "finding_id": {
2123
+ "description": "The occurrence in the series' first published review.",
2124
+ "format": "uuid",
2125
+ "type": "string"
2126
+ },
2127
+ "finding_series_id": {
2128
+ "description": "The unresolved environment finding series counted for this run.",
2129
+ "format": "uuid",
2130
+ "type": "string"
2131
+ },
2132
+ "review_id": {
2133
+ "description": "The first published review containing this occurrence.",
2134
+ "format": "uuid",
2135
+ "type": "string"
2136
+ },
2137
+ "run_number": {
2138
+ "description": "The earlier pull-request run that contains this occurrence.",
2139
+ "format": "int64",
2140
+ "type": "integer"
2141
+ },
2142
+ "severity": {
2143
+ "description": "Severity used by the series count; the linked occurrence may be less severe.",
2144
+ "type": "string"
2145
+ }
2146
+ },
2147
+ "required": [
2148
+ "finding_series_id",
2149
+ "finding_id",
2150
+ "review_id",
2151
+ "run_number",
2152
+ "severity"
2470
2153
  ],
2471
- "type": "string"
2154
+ "type": "object"
2472
2155
  },
2473
2156
  "ExportEvidenceKind": {
2474
2157
  "enum": [
@@ -3552,37 +3235,6 @@
3552
3235
  ],
3553
3236
  "type": "object"
3554
3237
  },
3555
- "GateState": {
3556
- "properties": {
3557
- "occurrence_captures": {
3558
- "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.",
3559
- "items": {
3560
- "$ref": "#/components/schemas/OccurrenceCapture"
3561
- },
3562
- "type": "array"
3563
- },
3564
- "override_record": {
3565
- "anyOf": [
3566
- {
3567
- "$ref": "#/components/schemas/Override"
3568
- },
3569
- {
3570
- "type": "null"
3571
- }
3572
- ],
3573
- "description": "Recorded override authorization, not confirmation of provider delivery."
3574
- },
3575
- "status": {
3576
- "description": "Local gate state. ALLOWED/BLOCKED can precede provider delivery.\n This field does not confirm that GitHub released or blocked a run.",
3577
- "type": "string"
3578
- }
3579
- },
3580
- "required": [
3581
- "status",
3582
- "occurrence_captures"
3583
- ],
3584
- "type": "object"
3585
- },
3586
3238
  "GateStatus": {
3587
3239
  "enum": [
3588
3240
  "REQUESTED",
@@ -3637,124 +3289,48 @@
3637
3289
  ],
3638
3290
  "type": "string"
3639
3291
  },
3640
- "NotAssessedView": {
3292
+ "MatchedLocalFinding": {
3293
+ "description": "A local occurrence with the same semantic fingerprint as this finding.",
3641
3294
  "properties": {
3642
- "environment_display_name": {
3643
- "description": "The display name of the environment whose assessment is not\n `COMPLETED`.",
3295
+ "created_at": {
3296
+ "description": "When the local review was requested.",
3297
+ "format": "date-time",
3644
3298
  "type": "string"
3645
3299
  },
3646
- "incompleteness_kind": {
3647
- "description": "The assessment's recorded gap class. Absent is an unclassified gap,\n never a complete assessment.",
3648
- "type": [
3649
- "string",
3650
- "null"
3651
- ]
3652
- }
3653
- },
3654
- "required": [
3655
- "environment_display_name"
3656
- ],
3657
- "type": "object"
3658
- },
3659
- "OccurrenceCapture": {
3660
- "description": "The capture of one observed execution of a gate's deployment.",
3661
- "properties": {
3662
- "approval_gaps": {
3663
- "description": "Assessments whose approval could defer nothing, with the reason.",
3664
- "items": {
3665
- "$ref": "#/components/schemas/ApprovalGap"
3666
- },
3667
- "type": "array"
3668
- },
3669
- "detail": {
3670
- "description": "Explanation of the capture's outcome, when available.",
3671
- "type": [
3672
- "string",
3673
- "null"
3674
- ]
3675
- },
3676
- "occurrence_key": {
3677
- "description": "Retained identity of the deployment occurrence, when available.",
3678
- "type": [
3679
- "string",
3680
- "null"
3681
- ]
3682
- },
3683
- "questions": {
3684
- "description": "Deferred questions and their binding or observed results for this occurrence.",
3685
- "items": {
3686
- "$ref": "#/components/schemas/OccurrenceQuestion"
3687
- },
3688
- "type": "array"
3300
+ "finding_id": {
3301
+ "description": "The occurrence in that local review.",
3302
+ "format": "uuid",
3303
+ "type": "string"
3689
3304
  },
3690
- "state": {
3691
- "allOf": [
3692
- {
3693
- "$ref": "#/components/schemas/CaptureState"
3694
- }
3695
- ],
3696
- "description": "Whether the capture is pending, recorded, unbound, not executed, or incomplete."
3305
+ "review_id": {
3306
+ "description": "The author's local review, linked by exact patch identity.",
3307
+ "format": "uuid",
3308
+ "type": "string"
3697
3309
  }
3698
3310
  },
3699
3311
  "required": [
3700
- "state",
3701
- "approval_gaps",
3702
- "questions"
3312
+ "review_id",
3313
+ "finding_id",
3314
+ "created_at"
3703
3315
  ],
3704
3316
  "type": "object"
3705
3317
  },
3706
- "OccurrenceQuestion": {
3707
- "description": "One deferred question as the gate presents it.",
3318
+ "NotAssessedView": {
3708
3319
  "properties": {
3709
- "assessment_id": {
3710
- "description": "Assessment whose approval deferred this question.",
3711
- "format": "uuid",
3712
- "type": "string"
3713
- },
3714
- "code": {
3715
- "description": "World's binding or refusal code, or the control plane's own gap.",
3716
- "type": [
3717
- "string",
3718
- "null"
3719
- ]
3720
- },
3721
- "family_key": {
3722
- "description": "Hypothesis family key for the deferred question.",
3320
+ "environment_display_name": {
3321
+ "description": "The display name of the environment whose assessment is not\n `COMPLETED`.",
3723
3322
  "type": "string"
3724
3323
  },
3725
- "family_version": {
3726
- "description": "Hypothesis family version for the deferred question.",
3727
- "format": "int32",
3728
- "type": "integer"
3729
- },
3730
- "observed_result": {
3731
- "description": "World's observed result once it recorded the question.",
3732
- "type": [
3733
- "string",
3734
- "null"
3735
- ]
3736
- },
3737
- "outcome_id": {
3738
- "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.",
3739
3326
  "type": [
3740
3327
  "string",
3741
3328
  "null"
3742
3329
  ]
3743
- },
3744
- "state": {
3745
- "allOf": [
3746
- {
3747
- "$ref": "#/components/schemas/QuestionState"
3748
- }
3749
- ],
3750
- "description": "Whether the question is pending, recorded, unbound, or not executed."
3751
3330
  }
3752
3331
  },
3753
3332
  "required": [
3754
- "assessment_id",
3755
- "family_key",
3756
- "family_version",
3757
- "state"
3333
+ "environment_display_name"
3758
3334
  ],
3759
3335
  "type": "object"
3760
3336
  },
@@ -3921,6 +3497,13 @@
3921
3497
  "minimum": 0,
3922
3498
  "type": "integer"
3923
3499
  },
3500
+ "earlier_findings": {
3501
+ "description": "Exact published occurrences of earlier unresolved environment findings.",
3502
+ "items": {
3503
+ "$ref": "#/components/schemas/EarlierOpenFinding"
3504
+ },
3505
+ "type": "array"
3506
+ },
3924
3507
  "not_assessed": {
3925
3508
  "description": "Recorded assessment gaps, including explicit policy exclusions.",
3926
3509
  "items": {
@@ -3956,37 +3539,6 @@
3956
3539
  ],
3957
3540
  "type": "string"
3958
3541
  },
3959
- "Override": {
3960
- "properties": {
3961
- "comment": {
3962
- "description": "The comment recorded with the approval, truncated past 8000\n characters.",
3963
- "type": [
3964
- "string",
3965
- "null"
3966
- ]
3967
- },
3968
- "github_environment_id": {
3969
- "description": "The GitHub environment ID the approval applied to.",
3970
- "format": "int64",
3971
- "type": "integer"
3972
- },
3973
- "github_user_id": {
3974
- "description": "The GitHub user ID of the person whose GitHub deployment approval\n overrode the gate.",
3975
- "format": "int64",
3976
- "type": "integer"
3977
- },
3978
- "github_user_login": {
3979
- "description": "That person's GitHub login as recorded with the approval, a display\n label truncated past 128 characters.",
3980
- "type": "string"
3981
- }
3982
- },
3983
- "required": [
3984
- "github_user_id",
3985
- "github_user_login",
3986
- "github_environment_id"
3987
- ],
3988
- "type": "object"
3989
- },
3990
3542
  "PassProjection": {
3991
3543
  "properties": {
3992
3544
  "model_binding": {
@@ -4104,13 +3656,6 @@
4104
3656
  ],
4105
3657
  "type": "object"
4106
3658
  },
4107
- "PermissionView": {
4108
- "enum": [
4109
- "PERMIT",
4110
- "BLOCK"
4111
- ],
4112
- "type": "string"
4113
- },
4114
3659
  "PlanProjection": {
4115
3660
  "properties": {
4116
3661
  "assessments": {
@@ -4393,105 +3938,6 @@
4393
3938
  ],
4394
3939
  "type": "object"
4395
3940
  },
4396
- "QuestionState": {
4397
- "description": "Where one deferred question stands.",
4398
- "oneOf": [
4399
- {
4400
- "const": "PENDING",
4401
- "description": "World has stored no record yet: the execution is not yet decidable\n inside the question's window.",
4402
- "type": "string"
4403
- },
4404
- {
4405
- "const": "RECORDED",
4406
- "description": "World recorded what the execution was observed to do.",
4407
- "type": "string"
4408
- },
4409
- {
4410
- "const": "UNBOUND",
4411
- "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.",
4412
- "type": "string"
4413
- },
4414
- {
4415
- "const": "NOT_EXECUTED",
4416
- "description": "The gate never authorized the execution, so nothing ran to observe.",
4417
- "type": "string"
4418
- }
4419
- ]
4420
- },
4421
- "ReachGapView": {
4422
- "properties": {
4423
- "code": {
4424
- "description": "`COVERAGE_INCOMPLETE`, `SOURCE_CAPABILITY_MISSING` or `BOUND_REACHED`.",
4425
- "type": "string"
4426
- }
4427
- },
4428
- "required": [
4429
- "code"
4430
- ],
4431
- "type": "object"
4432
- },
4433
- "ReachStepView": {
4434
- "properties": {
4435
- "assertion_id": {
4436
- "description": "The World relation assertion behind this step.",
4437
- "format": "uuid",
4438
- "type": "string"
4439
- },
4440
- "direction": {
4441
- "description": "`OUT` when the step follows the relation from its subject, `IN` when\n it follows it back to the subject.",
4442
- "type": "string"
4443
- },
4444
- "relation": {
4445
- "description": "The relation key, such as `proofline.relation.consumes_api`.",
4446
- "type": "string"
4447
- }
4448
- },
4449
- "required": [
4450
- "assertion_id",
4451
- "relation",
4452
- "direction"
4453
- ],
4454
- "type": "object"
4455
- },
4456
- "ReachedEntityView": {
4457
- "properties": {
4458
- "entity_id": {
4459
- "description": "World's entity ID.",
4460
- "format": "uuid",
4461
- "type": "string"
4462
- },
4463
- "kind": {
4464
- "description": "The entity's kind, such as `service` or `queue`.",
4465
- "type": "string"
4466
- },
4467
- "label": {
4468
- "description": "World's display label for the entity: environment evidence for\n readers of this organization, never published to GitHub.",
4469
- "type": "string"
4470
- },
4471
- "path": {
4472
- "description": "The recorded relation assertions from the deployed root to the entity.",
4473
- "items": {
4474
- "$ref": "#/components/schemas/ReachStepView"
4475
- },
4476
- "type": "array"
4477
- },
4478
- "type_keys": {
4479
- "description": "World's registry type keys for the entity.",
4480
- "items": {
4481
- "type": "string"
4482
- },
4483
- "type": "array"
4484
- }
4485
- },
4486
- "required": [
4487
- "entity_id",
4488
- "kind",
4489
- "type_keys",
4490
- "label",
4491
- "path"
4492
- ],
4493
- "type": "object"
4494
- },
4495
3941
  "RefreshView": {
4496
3942
  "description": "A recorded refresh decision, as the console shows it.",
4497
3943
  "properties": {
@@ -4808,6 +4254,31 @@
4808
4254
  "minimum": 0,
4809
4255
  "type": "integer"
4810
4256
  },
4257
+ "ci_failures": {
4258
+ "description": "Failed CI jobs diagnosed on the reviewed head, the newest diagnosed\n attempt of each run, in diagnosis order. The Check states each one;\n none is a Proofline open item. Absent when no job was diagnosed.",
4259
+ "items": {
4260
+ "$ref": "#/components/schemas/CiFailureLine"
4261
+ },
4262
+ "type": "array"
4263
+ },
4264
+ "ci_failures_omitted": {
4265
+ "description": "Diagnosed failed CI jobs on the reviewed head beyond `ci_failures`.",
4266
+ "format": "uint64",
4267
+ "minimum": 0,
4268
+ "type": "integer"
4269
+ },
4270
+ "ci_runs_pending": {
4271
+ "description": "Failed CI run attempts on the reviewed head whose diagnosis is queued\n or running, so none of their jobs has a line yet.",
4272
+ "format": "uint64",
4273
+ "minimum": 0,
4274
+ "type": "integer"
4275
+ },
4276
+ "ci_runs_unfinished": {
4277
+ "description": "Failed CI run attempts on the reviewed head whose diagnosis failed or\n was cancelled, so none of their jobs has a line.",
4278
+ "format": "uint64",
4279
+ "minimum": 0,
4280
+ "type": "integer"
4281
+ },
4811
4282
  "current_head_provider_updated_at": {
4812
4283
  "description": "GitHub's update time for the recorded pull request state that\n `current_head_sha` comes from. Null when none is recorded.",
4813
4284
  "format": "date-time",
@@ -4823,6 +4294,13 @@
4823
4294
  "null"
4824
4295
  ]
4825
4296
  },
4297
+ "earlier_findings": {
4298
+ "description": "Exact published occurrences of earlier unresolved environment findings.\n Absent from observations recorded before destinations were captured.",
4299
+ "items": {
4300
+ "$ref": "#/components/schemas/EarlierOpenFinding"
4301
+ },
4302
+ "type": "array"
4303
+ },
4826
4304
  "environments": {
4827
4305
  "description": "This review's environment assessments that are not `COMPLETED`, ordered\n by environment key.",
4828
4306
  "items": {
@@ -5006,17 +4484,6 @@
5006
4484
  ],
5007
4485
  "description": "Safe routing projection bound to this review's retained inputs."
5008
4486
  },
5009
- "specialist_execution": {
5010
- "anyOf": [
5011
- {
5012
- "$ref": "#/components/schemas/SpecialistExecutionView"
5013
- },
5014
- {
5015
- "type": "null"
5016
- }
5017
- ],
5018
- "description": "Actual specialist selection and pass receipts for the applied workflow."
5019
- },
5020
4487
  "status": {
5021
4488
  "const": "SUPPORTED",
5022
4489
  "type": "string"
@@ -5135,6 +4602,13 @@
5135
4602
  "null"
5136
4603
  ]
5137
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
+ },
5138
4612
  "pull_request_author_url": {
5139
4613
  "description": "The author's profile on the deployment's GitHub host. Absent when no author login is known.",
5140
4614
  "type": [
@@ -5242,45 +4716,6 @@
5242
4716
  ],
5243
4717
  "type": "object"
5244
4718
  },
5245
- "ReviewedTreeCitationView": {
5246
- "description": "One member of a review's declared tree that World cited.",
5247
- "properties": {
5248
- "content_sha256": {
5249
- "description": "The member's content hash. Absent for a member a `REJECTED`\n population refused, because such a population keeps no members.",
5250
- "type": [
5251
- "string",
5252
- "null"
5253
- ]
5254
- },
5255
- "overlay_digest": {
5256
- "description": "The overlay World read the member from.",
5257
- "type": "string"
5258
- },
5259
- "path": {
5260
- "allOf": [
5261
- {
5262
- "$ref": "#/components/schemas/UntrustedText"
5263
- }
5264
- ],
5265
- "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."
5266
- },
5267
- "population_kind": {
5268
- "description": "The population the member belongs to, such as\n `WORKFLOW_DEFINITIONS`.",
5269
- "type": "string"
5270
- },
5271
- "role": {
5272
- "description": "`PROPOSED_CODE_REVISION` (the reviewed commit) or\n `BASE_CODE_REVISION` (its merge base).",
5273
- "type": "string"
5274
- }
5275
- },
5276
- "required": [
5277
- "role",
5278
- "population_kind",
5279
- "path",
5280
- "overlay_digest"
5281
- ],
5282
- "type": "object"
5283
- },
5284
4719
  "ReviewsExportRow": {
5285
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.",
5286
4721
  "properties": {
@@ -5450,6 +4885,14 @@
5450
4885
  ],
5451
4886
  "description": "Human override beside the original decision, when one was requested."
5452
4887
  },
4888
+ "publication_group": {
4889
+ "description": "The finding that represents this finding's publication group, when an\n applied group publishes it in one comment with other findings. Every\n member names the same finding, the representative included.",
4890
+ "format": "uuid",
4891
+ "type": [
4892
+ "string",
4893
+ "null"
4894
+ ]
4895
+ },
5453
4896
  "reason_codes": {
5454
4897
  "description": "Recognized safe reason codes; unknown values are represented as `UNRECOGNIZED`.",
5455
4898
  "items": {
@@ -5777,108 +5220,6 @@
5777
5220
  ],
5778
5221
  "type": "object"
5779
5222
  },
5780
- "SpecialistAssessmentExecution": {
5781
- "properties": {
5782
- "assessment_id": {
5783
- "description": "The immutable assessment whose specialist execution is reported.",
5784
- "format": "uuid",
5785
- "type": "string"
5786
- },
5787
- "passes": {
5788
- "description": "Selected specialist passes and their retained execution outputs.",
5789
- "items": {
5790
- "$ref": "#/components/schemas/SpecialistPassExecution"
5791
- },
5792
- "type": "array"
5793
- }
5794
- },
5795
- "required": [
5796
- "assessment_id",
5797
- "passes"
5798
- ],
5799
- "type": "object"
5800
- },
5801
- "SpecialistExecutionView": {
5802
- "properties": {
5803
- "assessments": {
5804
- "description": "The applied specialist roster per exact assessment execution.",
5805
- "items": {
5806
- "$ref": "#/components/schemas/SpecialistAssessmentExecution"
5807
- },
5808
- "type": "array"
5809
- },
5810
- "selection_recorded": {
5811
- "description": "False until the applied parent captures its specialist choices.",
5812
- "type": "boolean"
5813
- }
5814
- },
5815
- "required": [
5816
- "selection_recorded",
5817
- "assessments"
5818
- ],
5819
- "type": "object"
5820
- },
5821
- "SpecialistOutputProjection": {
5822
- "description": "A pass receipt's bounded operational facts, without its proposals or prose.",
5823
- "properties": {
5824
- "gap_kind": {
5825
- "description": "Closed evidence-gap class, absent when the pass produced output.",
5826
- "type": [
5827
- "string",
5828
- "null"
5829
- ]
5830
- },
5831
- "output_sha256": {
5832
- "description": "Verified digest of the retained output bytes.",
5833
- "type": "string"
5834
- },
5835
- "status": {
5836
- "description": "`PRODUCED`, `UNAVAILABLE`, `INCOMPLETE` or `MALFORMED`.",
5837
- "type": "string"
5838
- }
5839
- },
5840
- "required": [
5841
- "status",
5842
- "output_sha256"
5843
- ],
5844
- "type": "object"
5845
- },
5846
- "SpecialistPassExecution": {
5847
- "properties": {
5848
- "files": {
5849
- "description": "Exact selected paths from the validated captured change.",
5850
- "items": {
5851
- "type": "string"
5852
- },
5853
- "type": "array"
5854
- },
5855
- "floor": {
5856
- "description": "Whether captured file facts required this pass.",
5857
- "type": "boolean"
5858
- },
5859
- "name": {
5860
- "description": "Closed registry key of the selected specialist.",
5861
- "type": "string"
5862
- },
5863
- "output": {
5864
- "anyOf": [
5865
- {
5866
- "$ref": "#/components/schemas/SpecialistOutputProjection"
5867
- },
5868
- {
5869
- "type": "null"
5870
- }
5871
- ],
5872
- "description": "Missing means selected, with no retained output. It never means success."
5873
- }
5874
- },
5875
- "required": [
5876
- "name",
5877
- "files",
5878
- "floor"
5879
- ],
5880
- "type": "object"
5881
- },
5882
5223
  "SpendAccountKind": {
5883
5224
  "enum": [
5884
5225
  "DEPLOYMENT",
@@ -6149,48 +5490,6 @@
6149
5490
  ],
6150
5491
  "type": "string"
6151
5492
  },
6152
- "TerraformPlanView": {
6153
- "enum": [
6154
- "TAKEN",
6155
- "NOT_DECLARED",
6156
- "NOT_PINNED",
6157
- "HEAD_DIFFERS",
6158
- "ADDRESSES_UNREPORTED"
6159
- ],
6160
- "type": "string"
6161
- },
6162
- "TerraformRootsView": {
6163
- "description": "The Terraform roots of one declared reach read.",
6164
- "properties": {
6165
- "addresses": {
6166
- "description": "The changed resource instance addresses taken as roots.",
6167
- "items": {
6168
- "type": "string"
6169
- },
6170
- "type": "array"
6171
- },
6172
- "omitted": {
6173
- "description": "Changed addresses left out at World's limit of 100 roots per read.",
6174
- "format": "uint",
6175
- "minimum": 0,
6176
- "type": "integer"
6177
- },
6178
- "plan": {
6179
- "allOf": [
6180
- {
6181
- "$ref": "#/components/schemas/TerraformPlanView"
6182
- }
6183
- ],
6184
- "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."
6185
- }
6186
- },
6187
- "required": [
6188
- "plan",
6189
- "addresses",
6190
- "omitted"
6191
- ],
6192
- "type": "object"
6193
- },
6194
5493
  "ThreadObservationFreshness": {
6195
5494
  "enum": [
6196
5495
  "FRESH",
@@ -6454,7 +5753,7 @@
6454
5753
  },
6455
5754
  "info": {
6456
5755
  "title": "Proofline Review API",
6457
- "version": "1.0.0"
5756
+ "version": "3.0.0"
6458
5757
  },
6459
5758
  "openapi": "3.1.0",
6460
5759
  "paths": {