@proofline/sdk 7.1.0 → 7.3.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.
@@ -798,6 +798,154 @@
798
798
  ],
799
799
  "type": "object"
800
800
  },
801
+ "CommitDeploy": {
802
+ "description": "One deploy of the commit and where its verification stands.",
803
+ "properties": {
804
+ "checkpoints": {
805
+ "description": "The four checks in order, each with its recorded result, if any, and\n when a missing one becomes overdue. Empty when no verification of\n the deploy exists.",
806
+ "items": {
807
+ "$ref": "#/components/schemas/DeployCoverageCheckpoint"
808
+ },
809
+ "type": "array"
810
+ },
811
+ "deploy_url": {
812
+ "description": "The deploy's console page.",
813
+ "type": [
814
+ "string",
815
+ "null"
816
+ ]
817
+ },
818
+ "deployment_task": {
819
+ "description": "The GitHub deployment's task, such as `deploy` or `deploy:web`.",
820
+ "type": [
821
+ "string",
822
+ "null"
823
+ ]
824
+ },
825
+ "environment_id": {
826
+ "description": "The Proofline environment that holds the deploy.",
827
+ "format": "uuid",
828
+ "type": "string"
829
+ },
830
+ "gaps": {
831
+ "description": "What the checks that leave the deploy unproven name.",
832
+ "items": {
833
+ "$ref": "#/components/schemas/DeployVerificationGap"
834
+ },
835
+ "type": "array"
836
+ },
837
+ "github_environment": {
838
+ "description": "The GitHub Environment the deployment named.",
839
+ "type": [
840
+ "string",
841
+ "null"
842
+ ]
843
+ },
844
+ "regressed": {
845
+ "description": "Whether any check recorded `REGRESSED`, whatever its gaps.",
846
+ "type": "boolean"
847
+ },
848
+ "rollback": {
849
+ "anyOf": [
850
+ {
851
+ "$ref": "#/components/schemas/CommitDeployRollback"
852
+ },
853
+ {
854
+ "type": "null"
855
+ }
856
+ ],
857
+ "description": "Present when the deploy is a rollback: the previous deploy of the same\n task ran a commit that a recorded merge into this commit's branch made\n after this commit, as the deploy's console page reads it. Absent for a\n forward deploy and when either merge is unrecorded."
858
+ },
859
+ "state": {
860
+ "allOf": [
861
+ {
862
+ "$ref": "#/components/schemas/DeployCoverageState"
863
+ }
864
+ ],
865
+ "description": "Where the deploy's verification stands."
866
+ },
867
+ "workflow_run_attempt": {
868
+ "description": "The attempt of that run that created the deployment addressing the\n deploy; above 1 for a rerun.",
869
+ "format": "int64",
870
+ "type": [
871
+ "integer",
872
+ "null"
873
+ ]
874
+ },
875
+ "workflow_run_attempts": {
876
+ "description": "Each distinct attempt of that run that created one of the deploy's\n deployments, ascending. A retry of a job that failed belongs to the\n deploy it retried, and a re-run of a job that had already landed is a\n deploy of its own. Absent outside Actions and when no recorded\n deployment of the deploy names its attempt.",
877
+ "items": {
878
+ "format": "int64",
879
+ "type": "integer"
880
+ },
881
+ "type": "array"
882
+ },
883
+ "workflow_run_id": {
884
+ "description": "The Actions run that created the deploy's deployments; absent outside\n Actions.",
885
+ "format": "int64",
886
+ "type": [
887
+ "integer",
888
+ "null"
889
+ ]
890
+ }
891
+ },
892
+ "required": [
893
+ "environment_id",
894
+ "state",
895
+ "regressed",
896
+ "checkpoints",
897
+ "gaps"
898
+ ],
899
+ "type": "object"
900
+ },
901
+ "CommitDeployRollback": {
902
+ "description": "What a rollback deploy rolled back, and what it restored.",
903
+ "properties": {
904
+ "restores": {
905
+ "anyOf": [
906
+ {
907
+ "$ref": "#/components/schemas/CommitRollbackDeploy"
908
+ },
909
+ {
910
+ "type": "null"
911
+ }
912
+ ],
913
+ "description": "The latest earlier deploy of this commit by the same task, before the\n deploys this one rolls back, within 30 days. Absent when the ledger\n holds none."
914
+ },
915
+ "rolls_back": {
916
+ "description": "Each deploy of the same task that landed a commit merged into this\n commit's branch after it, after `restores` and before this deploy,\n newest first.",
917
+ "items": {
918
+ "$ref": "#/components/schemas/CommitRollbackDeploy"
919
+ },
920
+ "type": "array"
921
+ }
922
+ },
923
+ "required": [
924
+ "rolls_back"
925
+ ],
926
+ "type": "object"
927
+ },
928
+ "CommitDeployVerifications": {
929
+ "description": "The deploys of one commit that Proofline recorded, across the\n organization's environments.",
930
+ "properties": {
931
+ "deploys": {
932
+ "description": "Each recorded deploy, earliest landing first.",
933
+ "items": {
934
+ "$ref": "#/components/schemas/CommitDeploy"
935
+ },
936
+ "type": "array"
937
+ },
938
+ "recorded": {
939
+ "description": "Whether the ledger holds any deploy of the commit. `false` says only\n that none was recorded, never anything about a deploy.",
940
+ "type": "boolean"
941
+ }
942
+ },
943
+ "required": [
944
+ "recorded",
945
+ "deploys"
946
+ ],
947
+ "type": "object"
948
+ },
801
949
  "CommitReviewRequest": {
802
950
  "additionalProperties": false,
803
951
  "description": "Pushed commits to review: the exact base the change is compared with and\n the exact head it ends at.",
@@ -836,6 +984,32 @@
836
984
  ],
837
985
  "type": "object"
838
986
  },
987
+ "CommitRollbackDeploy": {
988
+ "description": "One deploy a rollback names.",
989
+ "properties": {
990
+ "commit_sha": {
991
+ "description": "The commit that deploy ran.",
992
+ "type": "string"
993
+ },
994
+ "deploy_url": {
995
+ "description": "The deploy's console page.",
996
+ "type": [
997
+ "string",
998
+ "null"
999
+ ]
1000
+ },
1001
+ "landed_at": {
1002
+ "description": "When its last deployment first succeeded, or its AWS run ended.",
1003
+ "format": "date-time",
1004
+ "type": "string"
1005
+ }
1006
+ },
1007
+ "required": [
1008
+ "commit_sha",
1009
+ "landed_at"
1010
+ ],
1011
+ "type": "object"
1012
+ },
839
1013
  "CountedCause": {
840
1014
  "anyOf": [
841
1015
  {
@@ -1960,7 +2134,7 @@
1960
2134
  "type": "null"
1961
2135
  }
1962
2136
  ],
1963
- "description": "What Proofline still has open for the reviewed head, counted from the\n current finding decisions. Absent while the review is `PENDING` or\n `RUNNING`."
2137
+ "description": "What Proofline still has open for the reviewed head, counted from the\n current finding decisions. Absent while the review is `PENDING` or\n `RUNNING`, and for a repository audit, whose findings are in its\n report."
1964
2138
  },
1965
2139
  "open_items_observation": {
1966
2140
  "anyOf": [
@@ -2147,6 +2321,14 @@
2147
2321
  "null"
2148
2322
  ]
2149
2323
  },
2324
+ "review_cost_microcredits": {
2325
+ "description": "The review work within the total, excluding the separately billed PR\n walkthrough. Visible to the same callers as the total.",
2326
+ "format": "int64",
2327
+ "type": [
2328
+ "integer",
2329
+ "null"
2330
+ ]
2331
+ },
2150
2332
  "review_retracted_at": {
2151
2333
  "description": "When a submitted pull request review was marked retracted, a marker\n only older versions set. Null otherwise.",
2152
2334
  "format": "date-time",
@@ -2215,6 +2397,13 @@
2215
2397
  },
2216
2398
  "type": "array"
2217
2399
  },
2400
+ "submitted_reviews": {
2401
+ "description": "Every distinct review Proofline submitted on the pull request for this\n run, including the early code publisher's, oldest first. Absent when it\n submitted none.",
2402
+ "items": {
2403
+ "$ref": "#/components/schemas/SubmittedReview"
2404
+ },
2405
+ "type": "array"
2406
+ },
2218
2407
  "superseded_by_review_id": {
2219
2408
  "description": "The newer review that superseded this one. Null when none did or the\n caller cannot see it.",
2220
2409
  "format": "uuid",
@@ -2309,6 +2498,297 @@
2309
2498
  ],
2310
2499
  "type": "string"
2311
2500
  },
2501
+ "DeployCheckResult": {
2502
+ "oneOf": [
2503
+ {
2504
+ "const": "HEALTHY",
2505
+ "description": "The deployed revision runs, a completed change check covered it, and\n every signal the deploy compares was read in full and stayed within\n tolerance. A deploy whose task the delivery target maps to services\n compares only the signals that name no service and those that name\n one of its services in the signal's Cloud Run project, and in its\n location when it names one, or in the signal's ECS account and region,\n and in its cluster when it names one. Every other deploy compares\n every watched signal. With none watched, every ECS service's rollout\n completed instead.",
2506
+ "type": "string"
2507
+ },
2508
+ {
2509
+ "const": "REGRESSED",
2510
+ "description": "The deploy stopped running after it landed, its own ECS rollout\n failed, or a signal moved past its tolerance in the worse direction.",
2511
+ "type": "string"
2512
+ },
2513
+ {
2514
+ "const": "SUPERSEDED",
2515
+ "description": "A later deploy of another revision replaced this one.",
2516
+ "type": "string"
2517
+ },
2518
+ {
2519
+ "const": "INCOMPLETE",
2520
+ "description": "Nothing regressed, and at least one gap leaves the check unproven.",
2521
+ "type": "string"
2522
+ }
2523
+ ]
2524
+ },
2525
+ "DeployCheckpoint": {
2526
+ "description": "One of the four checks of a deploy.",
2527
+ "enum": [
2528
+ "LANDING",
2529
+ "MINUTES_20",
2530
+ "HOUR_1",
2531
+ "DAY_1"
2532
+ ],
2533
+ "type": "string"
2534
+ },
2535
+ "DeployCoverageCheckpoint": {
2536
+ "description": "One checkpoint of a verified deploy.",
2537
+ "properties": {
2538
+ "checkpoint": {
2539
+ "$ref": "#/components/schemas/DeployCheckpoint"
2540
+ },
2541
+ "due_at": {
2542
+ "description": "When a missing check becomes overdue, allowing the workflow's read\n delay, landing inventory reread, successor wait and transient-read retries.",
2543
+ "format": "date-time",
2544
+ "type": "string"
2545
+ },
2546
+ "gaps": {
2547
+ "default": [],
2548
+ "description": "The gaps this window's check recorded, beside its recorded result;\n empty while no check of this window is recorded. The deploy's `gaps`\n unite those that leave it unproven.",
2549
+ "items": {
2550
+ "$ref": "#/components/schemas/DeployVerificationGap"
2551
+ },
2552
+ "type": "array"
2553
+ },
2554
+ "result": {
2555
+ "anyOf": [
2556
+ {
2557
+ "$ref": "#/components/schemas/DeployCheckResult"
2558
+ },
2559
+ {
2560
+ "type": "null"
2561
+ }
2562
+ ],
2563
+ "description": "The recorded result; absent while no check of this window is recorded."
2564
+ }
2565
+ },
2566
+ "required": [
2567
+ "checkpoint",
2568
+ "due_at"
2569
+ ],
2570
+ "type": "object"
2571
+ },
2572
+ "DeployCoverageState": {
2573
+ "description": "Where one deploy's verification stands. Each deploy has exactly one, so\n the counts add up to the population.",
2574
+ "oneOf": [
2575
+ {
2576
+ "const": "VERIFIED",
2577
+ "description": "All four checks recorded `HEALTHY` or `REGRESSED` and none names a\n gap, a change-check gap included.",
2578
+ "type": "string"
2579
+ },
2580
+ {
2581
+ "const": "VERIFIED_UNTIL_SUPERSEDED",
2582
+ "description": "A later deploy of the same task replaced this one after its landing\n check, and every check before then recorded `HEALTHY` or `REGRESSED`\n and names no gap, a change-check gap included.\n The verification observed the deploy for as long as it\n ran; the next deploy's own verification covers the time after.",
2583
+ "type": "string"
2584
+ },
2585
+ {
2586
+ "const": "SUPERSEDED",
2587
+ "description": "A later deploy replaced this one at its landing check, or a check\n before the replacement has no recorded result.",
2588
+ "type": "string"
2589
+ },
2590
+ {
2591
+ "const": "INCOMPLETE",
2592
+ "description": "A check recorded `INCOMPLETE`, or a check other than `SUPERSEDED`\n names a gap, a change-check gap included, whatever it recorded.",
2593
+ "type": "string"
2594
+ },
2595
+ {
2596
+ "const": "UNRECORDED",
2597
+ "description": "A check came due, or the verification run ended, with no result\n recorded for it.",
2598
+ "type": "string"
2599
+ },
2600
+ {
2601
+ "const": "NOT_YET_DUE",
2602
+ "description": "The checks recorded so far established the revision and signals, and\n the next one is not due yet.",
2603
+ "type": "string"
2604
+ },
2605
+ {
2606
+ "const": "UNVERIFIED",
2607
+ "description": "The deploy landed and no verification of it exists in this\n environment, as when it landed while deploy checks were off. A GitHub\n deploy with no verification whose deployments were all first received\n before the environment's link to its repository existed is not in the\n population at all.",
2608
+ "type": "string"
2609
+ },
2610
+ {
2611
+ "const": "FAILED",
2612
+ "description": "The latest status of one of the deploy's GitHub deployments is\n `failure` or `error`, even after it landed; in an Actions run, the\n deployment of the latest attempt of one of its jobs.",
2613
+ "type": "string"
2614
+ },
2615
+ {
2616
+ "const": "INACTIVE",
2617
+ "description": "The ledger holds only `inactive` statuses of the deploy's GitHub\n deployments: it never saw them land or fail.",
2618
+ "type": "string"
2619
+ }
2620
+ ]
2621
+ },
2622
+ "DeployVerificationGap": {
2623
+ "description": "A named reason a check could not establish part of what it compares.",
2624
+ "oneOf": [
2625
+ {
2626
+ "const": "CHANGE_CHECK_MISSING",
2627
+ "description": "No review covered the deployed revision.",
2628
+ "type": "string"
2629
+ },
2630
+ {
2631
+ "const": "CHANGE_CHECK_INCOMPLETE",
2632
+ "description": "The change check that covered it did not complete.",
2633
+ "type": "string"
2634
+ },
2635
+ {
2636
+ "const": "ENVIRONMENT_NOT_CHECKED",
2637
+ "description": "A completed review covered the deployed revision but did not assess\n this environment, as a pull request review does while environment\n checks are off. The review is cited; the environment stays unchecked.",
2638
+ "type": "string"
2639
+ },
2640
+ {
2641
+ "const": "RUNNING_REVISION_UNKNOWN",
2642
+ "description": "The ledger shows no running revision for the deploy, or a late check's\n runtime read shows a later deployment of the same task that landed\n after the check came due, so it shows the present and not the window.",
2643
+ "type": "string"
2644
+ },
2645
+ {
2646
+ "const": "RUNTIME_TARGET_UNAVAILABLE",
2647
+ "description": "The check found no runtime to read: the environment names no Cloud\n Run service, the deploy's task is mapped to no approved service, or\n the delivery target's ECS runtime has no connected AWS account. An\n AWS run whose delivery target names no ECS runtime records it too.",
2648
+ "type": "string"
2649
+ },
2650
+ {
2651
+ "const": "RUNTIME_CAPABILITY_UNQUALIFIED",
2652
+ "description": "The AWS runtime was not read, because no serving artifact could yet\n be bound to a repository commit. Checks before AWS serving bindings\n recorded this for every AWS deploy; no check records it now.",
2653
+ "type": "string"
2654
+ },
2655
+ {
2656
+ "const": "AWS_TELEMETRY_CONNECTION_UNAVAILABLE",
2657
+ "description": "No active AWS connection of the environment can read the `CloudWatch`\n signal, or, when every watched signal is a `CloudWatch` signal, any of\n them.",
2658
+ "type": "string"
2659
+ },
2660
+ {
2661
+ "const": "RUNTIME_INVENTORY_UNAVAILABLE",
2662
+ "description": "The check could not read an inventory of the connection's Cloud Run\n services or ECS tasks: Kian retains none, or the read failed or timed\n out. Nothing shows what runs.",
2663
+ "type": "string"
2664
+ },
2665
+ {
2666
+ "const": "RUNTIME_INVENTORY_STALE",
2667
+ "description": "The newest inventory is older than the reader accepts, or was\n observed before the deploy landed, so nothing is read from it.",
2668
+ "type": "string"
2669
+ },
2670
+ {
2671
+ "const": "RUNTIME_INVENTORY_INCOMPLETE",
2672
+ "description": "The newest inventory's collection did not read every table the\n runtime read needs in full, so nothing is read from it.",
2673
+ "type": "string"
2674
+ },
2675
+ {
2676
+ "const": "RUNTIME_SERVICE_UNKNOWN",
2677
+ "description": "The inventory holds no single record of a service the check reads.",
2678
+ "type": "string"
2679
+ },
2680
+ {
2681
+ "const": "RUNTIME_TRAFFIC_UNKNOWN",
2682
+ "description": "A Cloud Run service's traffic shares do not add up to 100 percent,\n so what serves it is unknown.",
2683
+ "type": "string"
2684
+ },
2685
+ {
2686
+ "const": "RUNTIME_REVISION_UNKNOWN",
2687
+ "description": "A serving Cloud Run route names no revision the inventory holds, or\n an ECS service has no running task, more tasks than the reader\n reads, or a running container without an image digest.",
2688
+ "type": "string"
2689
+ },
2690
+ {
2691
+ "const": "RUNTIME_ROLLOUT_UNSETTLED",
2692
+ "description": "An ECS service's rollout has not settled: its primary deployment's\n rollout is not complete, it has more than one deployment, or it runs\n fewer tasks than it wants. When nothing else decides the runtime read,\n the check reads once more, after the next inventory collection, and\n records this only from that read. A failed rollout or a ledger\n successor decides the check at the first read, which records this\n beside it.",
2693
+ "type": "string"
2694
+ },
2695
+ {
2696
+ "const": "RUNTIME_COMMIT_BINDING_MISSING",
2697
+ "description": "A serving revision or container shows no commit: neither a qualified\n attestation of a Cloud Run revision's image digest nor its\n `commit-sha` label names a commit, an ECS image has no single\n qualified attestation of its commit, or every running container was\n built elsewhere.",
2698
+ "type": "string"
2699
+ },
2700
+ {
2701
+ "const": "RUNTIME_ATTESTATIONS_PERMISSION_PENDING",
2702
+ "description": "The running image's commit binding was not read because the\n repository's GitHub installation has not accepted the App's\n attestations permission. It replaces `RuntimeCommitBindingMissing`.",
2703
+ "type": "string"
2704
+ },
2705
+ {
2706
+ "const": "RUNTIME_IMAGE_BUILT_EARLIER",
2707
+ "description": "A running ECS container binds to a commit the deployed revision\n descends from, and the images its ECR repository received after it were\n not all read or bound, so whether a later build at or before the\n deployed revision replaced it is unknown. The newest such build runs the\n deploy, and a replaced one is a mismatch.",
2708
+ "type": "string"
2709
+ },
2710
+ {
2711
+ "const": "RUNTIME_TASK_UNMAPPED",
2712
+ "description": "The repository deploys several GitHub deployment tasks into the\n environment, and its delivery target's task map does not name this\n deploy's task. No other task's services stand for it.",
2713
+ "type": "string"
2714
+ },
2715
+ {
2716
+ "const": "TELEMETRY_CONNECTION_UNAVAILABLE",
2717
+ "description": "Proofline holds no Cloud Monitoring read access for the environment.",
2718
+ "type": "string"
2719
+ },
2720
+ {
2721
+ "const": "TELEMETRY_CREDENTIAL_UNAVAILABLE",
2722
+ "description": "The read credential could not be minted for this window.",
2723
+ "type": "string"
2724
+ },
2725
+ {
2726
+ "const": "NO_SIGNALS_CONFIGURED",
2727
+ "description": "The environment watches no signal. A check whose every ECS service's\n rollout completed records it under the report's `suggestions`\n instead.",
2728
+ "type": "string"
2729
+ },
2730
+ {
2731
+ "const": "NO_SIGNALS_FOR_TASK_SERVICES",
2732
+ "description": "The environment watches signals, but the deploy's task is mapped to\n services and every watched signal names a service the check does not\n compare, so it compared none. A mapped task's check compares a signal\n that names one of its services in the signal's Cloud Run project, and\n in its location when it names one, or in the signal's ECS account and\n region, and in its cluster when it names one.",
2733
+ "type": "string"
2734
+ },
2735
+ {
2736
+ "const": "SIGNAL_PROJECT_NOT_CONNECTED",
2737
+ "description": "No verified Cloud Build connection of the environment reads the\n signal's project. A Cloud Run, GKE or other connection to the same\n project does not read its metrics.",
2738
+ "type": "string"
2739
+ },
2740
+ {
2741
+ "const": "SIGNAL_CONFIGURATION_INVALID",
2742
+ "description": "The signal's descriptors or statistic do not form a valid query, the\n project has no such metric, or the statistic cannot apply to the\n metric's kind and value type.",
2743
+ "type": "string"
2744
+ },
2745
+ {
2746
+ "const": "SIGNAL_RESPONSE_INVALID",
2747
+ "description": "Cloud Monitoring answered with something the reader refused.",
2748
+ "type": "string"
2749
+ },
2750
+ {
2751
+ "const": "SIGNAL_READ_PARTIAL",
2752
+ "description": "The provider read covered only part of the window, for the reason\n the reading records.",
2753
+ "type": "string"
2754
+ },
2755
+ {
2756
+ "const": "SIGNAL_READ_UNAVAILABLE",
2757
+ "description": "The provider read returned nothing for the window, for the reason\n the reading records, such as a refused permission.",
2758
+ "type": "string"
2759
+ },
2760
+ {
2761
+ "const": "SIGNAL_NO_DATA",
2762
+ "description": "A complete read returned no point and the signal does not treat that\n as zero.",
2763
+ "type": "string"
2764
+ },
2765
+ {
2766
+ "const": "SIGNAL_NOT_SINGLE_SERIES",
2767
+ "description": "The provider reduced the read to more than one series.",
2768
+ "type": "string"
2769
+ },
2770
+ {
2771
+ "const": "SIGNAL_BUCKET_UNEXPECTED",
2772
+ "description": "The read returned more than one bucket for the window.",
2773
+ "type": "string"
2774
+ },
2775
+ {
2776
+ "const": "BASELINE_UNAVAILABLE",
2777
+ "description": "The window has a value and its baseline before landing has none.",
2778
+ "type": "string"
2779
+ },
2780
+ {
2781
+ "const": "BELOW_TRAFFIC_FLOOR",
2782
+ "description": "A compared service's traffic signal counted fewer requests than its\n floor in the check's window or in its baseline, so that service's\n other signals say too little to call the check healthy. Each of the\n service's signal reports names the floor, both windows and their\n counts under `traffic`.",
2783
+ "type": "string"
2784
+ },
2785
+ {
2786
+ "const": "BASELINE_HELD_REGRESSION",
2787
+ "description": "An earlier deploy of the same task found the signal regressed in a\n check whose window overlaps the hour before this deploy started, and\n the baseline that check compared with is not usable: its window ended\n more than a day before this deploy started, or the signal would no\n longer send the query it cites. The regressed hour is never compared\n in its place, so the signal is not compared.",
2788
+ "type": "string"
2789
+ }
2790
+ ]
2791
+ },
2312
2792
  "DomainView": {
2313
2793
  "properties": {
2314
2794
  "domain": {
@@ -3628,6 +4108,21 @@
3628
4108
  }
3629
4109
  ]
3630
4110
  },
4111
+ "KianFindingSource": {
4112
+ "description": "What published a supported Kian finding.",
4113
+ "oneOf": [
4114
+ {
4115
+ "const": "CONFIRMED_REQUIREMENT",
4116
+ "description": "A service violates a confirmed gate requirement of its delivery\n target ([`requirements`]).",
4117
+ "type": "string"
4118
+ },
4119
+ {
4120
+ "const": "INVESTIGATION",
4121
+ "description": "The environment investigation found it ([`kian_investigation`]).",
4122
+ "type": "string"
4123
+ }
4124
+ ]
4125
+ },
3631
4126
  "LinkedIssueCapture": {
3632
4127
  "description": "The count and outcome of a review's linked-issue receipt. Issue numbers,\n titles and the receipt's gaps stay in the receipt.",
3633
4128
  "properties": {
@@ -3694,6 +4189,17 @@
3694
4189
  }
3695
4190
  ],
3696
4191
  "description": "The local re-verification result; it does not change the original finding."
4192
+ },
4193
+ "stored_check": {
4194
+ "anyOf": [
4195
+ {
4196
+ "$ref": "#/components/schemas/LocalStoredCheck"
4197
+ },
4198
+ {
4199
+ "type": "null"
4200
+ }
4201
+ ],
4202
+ "description": "The check a code reproduction stored for the finding, which a pushed\n head runs again; run its command against the local changes before\n pushing. The patch review does not run it. Absent for a finding with\n no stored check."
3697
4203
  }
3698
4204
  },
3699
4205
  "required": [
@@ -3714,6 +4220,35 @@
3714
4220
  ],
3715
4221
  "type": "string"
3716
4222
  },
4223
+ "LocalStoredCheck": {
4224
+ "description": "A finding's stored check and the newest result it gave. Its runs show\n what the code did under the conditions the test exercised in a sandbox,\n and establish no fact about a deployed environment.",
4225
+ "properties": {
4226
+ "check_id": {
4227
+ "format": "uuid",
4228
+ "type": "string"
4229
+ },
4230
+ "command": {
4231
+ "description": "The command the sandbox ran the test with, as the agent recorded it,\n with the reproducing review's protected values withheld, and withheld\n whole when that provenance is gone. Untrusted text: render it as text.",
4232
+ "type": "string"
4233
+ },
4234
+ "last_result": {
4235
+ "anyOf": [
4236
+ {
4237
+ "$ref": "#/components/schemas/StoredCheckResult"
4238
+ },
4239
+ {
4240
+ "type": "null"
4241
+ }
4242
+ ],
4243
+ "description": "Absent only for a check with no recorded run."
4244
+ }
4245
+ },
4246
+ "required": [
4247
+ "check_id",
4248
+ "command"
4249
+ ],
4250
+ "type": "object"
4251
+ },
3717
4252
  "MatchedLocalFinding": {
3718
4253
  "description": "A local occurrence with the same semantic fingerprint as this finding.",
3719
4254
  "properties": {
@@ -4806,6 +5341,28 @@
4806
5341
  "description": "Model text with protected values withheld. Render it as plain text.",
4807
5342
  "type": "string"
4808
5343
  },
5344
+ "requirement": {
5345
+ "anyOf": [
5346
+ {
5347
+ "$ref": "#/components/schemas/ReviewRequirementTarget"
5348
+ },
5349
+ {
5350
+ "type": "null"
5351
+ }
5352
+ ],
5353
+ "description": "The delivery target whose confirmed gate requirement the finding\n reports. Absent for an investigation's finding."
5354
+ },
5355
+ "source": {
5356
+ "anyOf": [
5357
+ {
5358
+ "$ref": "#/components/schemas/KianFindingSource"
5359
+ },
5360
+ {
5361
+ "type": "null"
5362
+ }
5363
+ ],
5364
+ "description": "What published the finding: a confirmed gate requirement its\n delivery target's services violate, or the environment investigation.\n Every listed finding carries it."
5365
+ },
4809
5366
  "title": {
4810
5367
  "description": "Model text with protected values withheld. Render it as plain text.",
4811
5368
  "type": "string"
@@ -5007,6 +5564,36 @@
5007
5564
  ],
5008
5565
  "type": "object"
5009
5566
  },
5567
+ "ReviewRequirementTarget": {
5568
+ "description": "The delivery target whose confirmed entry a finding reports, as its Gate\n requirements page addresses it.",
5569
+ "properties": {
5570
+ "delivery_target_id": {
5571
+ "description": "The delivery target.",
5572
+ "format": "uuid",
5573
+ "type": "string"
5574
+ },
5575
+ "environment_id": {
5576
+ "description": "The environment of the assessment that asked the requirement.",
5577
+ "format": "uuid",
5578
+ "type": "string"
5579
+ },
5580
+ "repository_full_name": {
5581
+ "description": "The repository's `owner/name`, which names the target to a reader.",
5582
+ "type": "string"
5583
+ },
5584
+ "repository_name": {
5585
+ "description": "The repository's name, as the page's address names it.",
5586
+ "type": "string"
5587
+ }
5588
+ },
5589
+ "required": [
5590
+ "environment_id",
5591
+ "repository_name",
5592
+ "repository_full_name",
5593
+ "delivery_target_id"
5594
+ ],
5595
+ "type": "object"
5596
+ },
5010
5597
  "ReviewRoutingView": {
5011
5598
  "oneOf": [
5012
5599
  {
@@ -5938,7 +6525,7 @@
5938
6525
  "type": "string"
5939
6526
  },
5940
6527
  "SpendExportRow": {
5941
- "description": "UTC daily debit totals using only the account and transport recorded at charge time.",
6528
+ "description": "UTC daily debit totals using only the account and transport recorded at\n charge time, each split by what paid for it as Billing's Usage splits it.",
5942
6529
  "properties": {
5943
6530
  "account": {
5944
6531
  "description": "Recorded attribution, not a current credential label or inferred account.",
@@ -5972,6 +6559,12 @@
5972
6559
  "format": "int64",
5973
6560
  "type": "integer"
5974
6561
  },
6562
+ "free_review_microcredits": {
6563
+ "default": 0,
6564
+ "description": "The part the free review month paid: this organization's\n `free-review:{debit}` grants for the row's debits.",
6565
+ "format": "int64",
6566
+ "type": "integer"
6567
+ },
5975
6568
  "microcredits": {
5976
6569
  "description": "Exact integer charge units; one credit contains one million microcredits.",
5977
6570
  "format": "int64",
@@ -5982,6 +6575,24 @@
5982
6575
  "format": "uuid",
5983
6576
  "type": "string"
5984
6577
  },
6578
+ "organization_microcredits": {
6579
+ "default": 0,
6580
+ "description": "The part the organization's shared credit balance paid.",
6581
+ "format": "int64",
6582
+ "type": "integer"
6583
+ },
6584
+ "own_key_microcredits": {
6585
+ "default": 0,
6586
+ "description": "The part run on this organization's own provider key: a tariff\n equivalent its provider bills, not credit spend. The four funding\n columns add up to `microcredits`.",
6587
+ "format": "int64",
6588
+ "type": "integer"
6589
+ },
6590
+ "plan_microcredits": {
6591
+ "default": 0,
6592
+ "description": "The part of `microcredits` the workspace allowance or the author's seat paid.",
6593
+ "format": "int64",
6594
+ "type": "integer"
6595
+ },
5985
6596
  "transport": {
5986
6597
  "description": "The model transport recorded at charge time, null when the debit records none.",
5987
6598
  "type": [
@@ -6053,6 +6664,57 @@
6053
6664
  ],
6054
6665
  "type": "object"
6055
6666
  },
6667
+ "StoredCheckOutcome": {
6668
+ "description": "What the test did: `FAILED` as at the reproduction or otherwise,\n `DID_NOT_FAIL` when it exited cleanly, which shows only that this test\n did not fail under the conditions it exercised, or `UNAVAILABLE` when it\n could not answer.",
6669
+ "enum": [
6670
+ "FAILED",
6671
+ "DID_NOT_FAIL",
6672
+ "UNAVAILABLE"
6673
+ ],
6674
+ "type": "string"
6675
+ },
6676
+ "StoredCheckResult": {
6677
+ "description": "The newest result of a stored check: its newest settled rerun at a later\n pull request head, or the reproduction's own head run when it has not\n run again.",
6678
+ "properties": {
6679
+ "commit_sha": {
6680
+ "description": "The commit the check ran at, or would have run at when a rerun could\n not start.",
6681
+ "type": [
6682
+ "string",
6683
+ "null"
6684
+ ]
6685
+ },
6686
+ "reason": {
6687
+ "description": "Why a rerun did not pass, such as `STILL_FAILS` or\n `SERVICE_NOT_STARTED`. Absent for a pass and for the reproduction.",
6688
+ "type": [
6689
+ "string",
6690
+ "null"
6691
+ ]
6692
+ },
6693
+ "result": {
6694
+ "$ref": "#/components/schemas/StoredCheckOutcome"
6695
+ },
6696
+ "source": {
6697
+ "allOf": [
6698
+ {
6699
+ "$ref": "#/components/schemas/StoredCheckResultSource"
6700
+ }
6701
+ ],
6702
+ "description": "`RERUN` or `REPRODUCTION`."
6703
+ }
6704
+ },
6705
+ "required": [
6706
+ "source",
6707
+ "result"
6708
+ ],
6709
+ "type": "object"
6710
+ },
6711
+ "StoredCheckResultSource": {
6712
+ "enum": [
6713
+ "REPRODUCTION",
6714
+ "RERUN"
6715
+ ],
6716
+ "type": "string"
6717
+ },
6056
6718
  "SubjectAuthorization": {
6057
6719
  "description": "One assessment's authorization of one subject, by identity.\n\n The display name is not the answer on its own: an environment's external key\n is unique within its organization and a display name is mutable metadata,\n so two environments of one review can carry the same one.\n Collapsing to it would leave a reader unable to tell which assessment\n authorized the subject and which one gapped, which is the confusion this\n field exists to remove.",
6058
6720
  "properties": {
@@ -6191,6 +6853,25 @@
6191
6853
  ],
6192
6854
  "type": "object"
6193
6855
  },
6856
+ "SubmittedReview": {
6857
+ "description": "One review Proofline submitted on the pull request.",
6858
+ "properties": {
6859
+ "commit_sha": {
6860
+ "description": "The commit the review was submitted for.",
6861
+ "type": [
6862
+ "string",
6863
+ "null"
6864
+ ]
6865
+ },
6866
+ "url": {
6867
+ "type": "string"
6868
+ }
6869
+ },
6870
+ "required": [
6871
+ "url"
6872
+ ],
6873
+ "type": "object"
6874
+ },
6194
6875
  "SummaryRoute": {
6195
6876
  "enum": [
6196
6877
  "DETERMINISTIC_ONLY",
@@ -6462,7 +7143,7 @@
6462
7143
  },
6463
7144
  "info": {
6464
7145
  "title": "Proofline Review API",
6465
- "version": "7.1.0"
7146
+ "version": "7.3.0"
6466
7147
  },
6467
7148
  "openapi": "3.1.0",
6468
7149
  "paths": {
@@ -7002,6 +7683,74 @@
7002
7683
  "x-proofline-token-scope": "reviews:request"
7003
7684
  }
7004
7685
  },
7686
+ "/api/v1/organizations/{org_id}/repositories/{repo_id}/commits/{commit_sha}/deploy-verifications": {
7687
+ "get": {
7688
+ "description": "Returns each deploy of one exact commit in the repository that Proofline recorded, across the organization's environments: its environment ID, GitHub Environment, task, workflow run and attempt, where its verification stands, whether a check regressed, each check's result and due time, the gaps that leave it unproven and its console page. `commit_sha` must be a full 40-character lowercase commit SHA; a branch, tag or abbreviated SHA gets 400. A commit with no recorded deploy returns `recorded: false` and no deploys, which is never a result about a deploy. A repository outside the token's repository restriction or organization returns 404.",
7689
+ "operationId": "get_commit_deploy_verifications",
7690
+ "parameters": [
7691
+ {
7692
+ "description": "The full 40-character lowercase commit SHA the job deployed. A branch,\n tag or abbreviated SHA is refused.",
7693
+ "in": "path",
7694
+ "name": "commit_sha",
7695
+ "required": true,
7696
+ "schema": {
7697
+ "description": "The full 40-character lowercase commit SHA the job deployed. A branch,\n tag or abbreviated SHA is refused.",
7698
+ "type": "string"
7699
+ },
7700
+ "style": "simple"
7701
+ },
7702
+ {
7703
+ "in": "path",
7704
+ "name": "org_id",
7705
+ "required": true,
7706
+ "schema": {
7707
+ "format": "uuid",
7708
+ "type": "string"
7709
+ },
7710
+ "style": "simple"
7711
+ },
7712
+ {
7713
+ "in": "path",
7714
+ "name": "repo_id",
7715
+ "required": true,
7716
+ "schema": {
7717
+ "format": "uuid",
7718
+ "type": "string"
7719
+ },
7720
+ "style": "simple"
7721
+ }
7722
+ ],
7723
+ "responses": {
7724
+ "200": {
7725
+ "content": {
7726
+ "application/json": {
7727
+ "schema": {
7728
+ "$ref": "#/components/schemas/CommitDeployVerifications"
7729
+ }
7730
+ }
7731
+ },
7732
+ "description": "The deploys of one commit that Proofline recorded, across the\n organization's environments."
7733
+ },
7734
+ "default": {
7735
+ "content": {
7736
+ "application/problem+json": {
7737
+ "schema": {
7738
+ "$ref": "#/components/schemas/Problem"
7739
+ }
7740
+ }
7741
+ },
7742
+ "description": "An RFC 9457 problem; the HTTP status remains authoritative."
7743
+ }
7744
+ },
7745
+ "security": [
7746
+ {
7747
+ "bearerAuth": []
7748
+ }
7749
+ ],
7750
+ "summary": "Get a commit's deploy verifications",
7751
+ "x-proofline-token-scope": "reviews:read"
7752
+ }
7753
+ },
7005
7754
  "/api/v1/organizations/{org_id}/repositories/{repo_id}/coverage-reports": {
7006
7755
  "post": {
7007
7756
  "description": "Records the LCOV, Cobertura, JaCoCo or Go coverage reports a CI run produced for one exact commit GitHub has in the repository, for COVERAGE checks that accept uploads. A branch, tag or abbreviated SHA, or a report that cannot be read, gets 422 and stores nothing. Requires a repository-restricted token and live GitHub write access; the same reports for the same commit return the report already recorded.",