@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.
package/dist/schema.d.ts CHANGED
@@ -585,15 +585,6 @@ export interface components {
585
585
  };
586
586
  /** @enum {string} */
587
587
  AgentVendor: "CURSOR_CLOUD_AGENTS" | "DEVIN";
588
- ApprovalGap: {
589
- /**
590
- * Format: uuid
591
- * @description Assessment whose approval could not supply deferred occurrence questions.
592
- */
593
- assessment_id: string;
594
- /** @description Reason the assessment's approval could not supply deferred occurrence questions. */
595
- code: string;
596
- };
597
588
  AssessmentProjection: {
598
589
  /**
599
590
  * Format: uuid
@@ -614,28 +605,6 @@ export interface components {
614
605
  /** @description Environment reach retained by the plan. */
615
606
  reach: string;
616
607
  };
617
- /** @description How one condition relates to the review's base revision. */
618
- AttributedChange: "INTRODUCED" | "CHANGED" | "UNCHANGED" | "RESOLVED" | "UNATTRIBUTED";
619
- AttributedConditionView: {
620
- /** @description How this condition relates to the review's base revision. */
621
- change: components["schemas"]["AttributedChange"];
622
- /** @description The member that declares the site at each revision that declares it. */
623
- reviewed_tree_citations: components["schemas"]["ReviewedTreeCitationView"][];
624
- /**
625
- * @description The revision that holds the condition: the base for `RESOLVED`, the
626
- * proposed revision for `INTRODUCED`, `CHANGED` and `UNCHANGED`, and
627
- * either for `UNATTRIBUTED`.
628
- */
629
- revision: components["schemas"]["AttributedRevision"];
630
- /**
631
- * @description World's label of the condition's site and what it declares, such as
632
- * `.github/workflows/ci.yml jobs.test.steps[0].uses: actions/checkout@v4`.
633
- * It quotes repository text.
634
- */
635
- subject: components["schemas"]["UntrustedText"];
636
- };
637
- AttributedRevision: "PROPOSED_CODE_REVISION" | "BASE_CODE_REVISION";
638
- AttributionStatus: "COMPARED" | "UNAVAILABLE" | "UNREADABLE";
639
608
  AuthorChoice: {
640
609
  /**
641
610
  * Format: int64
@@ -650,84 +619,6 @@ export interface components {
650
619
  login?: string | null;
651
620
  };
652
621
  /** @enum {string} */
653
- Authority: "ADVISORY" | "DEPLOYMENT_POLICY";
654
- Availability: ("RECORDED" | "NOT_RECORDED" | "LEGACY" | "OPERATIONAL_FAILURE") | "LIMITED";
655
- /** @description How the capture ended. */
656
- CaptureState: "PENDING" | "RECORDED" | "UNBOUND" | "NOT_EXECUTED" | "INCOMPLETE";
657
- /**
658
- * @description Which conditions behind a check's result the change brought, and which
659
- * World found at the review's base revision. It sits beside the result and
660
- * never changes it: a condition already at the base is still a condition.
661
- */
662
- ChangeAttributionView: {
663
- /**
664
- * @description Where every condition is recorded when some are omitted. Absent when
665
- * `conditions` lists them all.
666
- */
667
- complete_record?: components["schemas"]["CompleteRecordView"] | null;
668
- /**
669
- * Format: uint32
670
- * @description How many conditions World attributed, listed or not. Zero unless
671
- * `status` is `COMPARED`.
672
- */
673
- condition_count: number;
674
- /**
675
- * @description Every condition, each once, in World's order, never netted against
676
- * another. Empty unless `status` is `COMPARED`, and empty when some are
677
- * omitted: it never lists only some of them.
678
- */
679
- conditions: components["schemas"]["AttributedConditionView"][];
680
- /**
681
- * @description How many conditions there are of each change at each revision, over
682
- * every condition, listed or not. Changes with none are left out.
683
- */
684
- counts: components["schemas"]["ChangeCountView"][];
685
- /**
686
- * @description World's code for why it could not read that revision, such as
687
- * `BASE_REVIEWED_TREE_NOT_DECLARED`. Present exactly when `status` is
688
- * `UNAVAILABLE`.
689
- */
690
- detail_code?: string | null;
691
- /**
692
- * @description The conditions a summary lists when some are omitted: the first ones
693
- * in the order `counts` gives, each whole, at most 50 and always fewer
694
- * than `condition_count`. Present exactly when `omitted_condition_count`
695
- * is not zero.
696
- */
697
- listed_conditions?: components["schemas"]["AttributedConditionView"][] | null;
698
- /**
699
- * Format: uint32
700
- * @description How many of those conditions this response does not list. Zero when
701
- * the result kept World's attribution whole. Otherwise the result kept a
702
- * summary: `listed_conditions` lists the first ones, `counts` is still
703
- * exact, and World's recorded evaluation holds every condition.
704
- */
705
- omitted_condition_count: number;
706
- /**
707
- * @description The revision World could not read. Present exactly when `status` is
708
- * `UNAVAILABLE`.
709
- */
710
- revision?: components["schemas"]["AttributedRevision"] | null;
711
- /**
712
- * @description Whether World compared both revisions, could not read one, or recorded
713
- * an attribution this build cannot read.
714
- */
715
- status: components["schemas"]["AttributionStatus"];
716
- };
717
- /** @description How many conditions are of one change at one revision. */
718
- ChangeCountView: {
719
- /** @description How the counted conditions relate to the review's base revision. */
720
- change: components["schemas"]["AttributedChange"];
721
- /**
722
- * Format: uint32
723
- * @description How many conditions have this `change` at this `revision`, over every
724
- * condition, listed or not.
725
- */
726
- count: number;
727
- /** @description The revision that holds the counted conditions. */
728
- revision: components["schemas"]["AttributedRevision"];
729
- };
730
- /** @enum {string} */
731
622
  ChangeDiagramKindView: "FLOWCHART" | "SEQUENCE";
732
623
  ChangeDiagramOutcome: "DRAWN" | "NO_INTERACTION" | "INDEX_INCOMPLETE" | "OVER_CAPS" | "DECISION_UNAVAILABLE";
733
624
  /** @description The change-level diagram recorded for a review, or why there is none. */
@@ -773,6 +664,15 @@ export interface components {
773
664
  */
774
665
  route?: components["schemas"]["SummaryRoute"] | null;
775
666
  };
667
+ /** @description One file World cited for a check's result. */
668
+ CheckFile: {
669
+ /** @description The repository-relative path. It is repository text. */
670
+ path: components["schemas"]["UntrustedText"];
671
+ /** @description The revision World read the file at. */
672
+ revision: components["schemas"]["CheckFileRevision"];
673
+ };
674
+ /** @description The revision a cited file was read at. */
675
+ CheckFileRevision: "PROPOSED_CODE_REVISION" | "BASE_CODE_REVISION";
776
676
  /**
777
677
  * @description World's lifecycle disclosure for the evaluator version that answered, as
778
678
  * the receipt recorded it. A deployment gate counts only `GATING` results
@@ -780,6 +680,46 @@ export interface components {
780
680
  * evaluates a deployment; the lifecycle alone permits or blocks nothing.
781
681
  */
782
682
  CheckLifecycle: "GATING" | "SHADOW" | "QUARANTINED" | "RETIRED" | "UNKNOWN";
683
+ /**
684
+ * @description What the control plane records as a failure's cause.
685
+ * @enum {string}
686
+ */
687
+ CiFailureAttribution: "CAUSED_BY_CHANGE" | "PRE_EXISTING_ON_BASE" | "FLAKY_OR_INFRASTRUCTURE" | "ENVIRONMENT_STATE" | "UNKNOWN";
688
+ /** @description One failed CI job as the Check states it. */
689
+ CiFailureLine: {
690
+ /**
691
+ * @description The recorded cause: `CAUSED_BY_CHANGE`, `PRE_EXISTING_ON_BASE`,
692
+ * `FLAKY_OR_INFRASTRUCTURE`, `ENVIRONMENT_STATE` or `UNKNOWN`. `UNKNOWN`
693
+ * means the failure was not diagnosed, and `undiagnosed` says why.
694
+ */
695
+ attribution: components["schemas"]["CiFailureAttribution"];
696
+ /**
697
+ * @description The first failed step's name, admitted the same way. Null when no
698
+ * step concluded as failed.
699
+ */
700
+ failed_step?: string | null;
701
+ /**
702
+ * @description The job's name as the diagnosis admitted it: masked, or `<withheld>`.
703
+ * A protected value of the observing review reads as the withheld
704
+ * marker.
705
+ */
706
+ job_name: string;
707
+ /**
708
+ * Format: int64
709
+ * @description The GitHub Actions run attempt the job failed in, from 1. The line
710
+ * is the newest diagnosed attempt of its run.
711
+ */
712
+ run_attempt: number;
713
+ /** @description Whether the job timed out rather than failed. */
714
+ timed_out: boolean;
715
+ /**
716
+ * @description Why the failure was not diagnosed. Set exactly when `attribution` is
717
+ * `UNKNOWN`.
718
+ */
719
+ undiagnosed?: components["schemas"]["CiFailureUndiagnosed"] | null;
720
+ };
721
+ /** @description Why a failed job's attribution is `UNKNOWN`. */
722
+ CiFailureUndiagnosed: "LOG_UNAVAILABLE" | "LOG_TOO_LARGE" | "LOG_NOT_ADMITTED" | "DECISION_UNAVAILABLE" | "SHADOW" | "UNDETERMINED";
783
723
  /**
784
724
  * @description A code assessment's recorded execution status. It is never a verdict on
785
725
  * the change: only `COMPLETED` says the assessment covered what it read.
@@ -848,16 +788,6 @@ export interface components {
848
788
  */
849
789
  review_id: string;
850
790
  };
851
- /**
852
- * @description World's immutable record of the complete answer an omitted list comes
853
- * from.
854
- */
855
- CompleteRecordView: {
856
- /** @description The `sha256:` digest of the complete attribution in that record. */
857
- attribution_digest: string;
858
- /** @description The evaluation World recorded, which holds every condition. */
859
- world_evaluation_id: string;
860
- };
861
791
  /**
862
792
  * @description An upload refused for its content: a symbolic or unknown commit, or a
863
793
  * report that cannot be read. Nothing is stored.
@@ -920,18 +850,6 @@ export interface components {
920
850
  * @description When the assessment completed. Null while it has not.
921
851
  */
922
852
  completed_at?: string | null;
923
- /**
924
- * @description The retained decision disclosure, which grants no deployment
925
- * authorization. Absent when none is recorded and the review kind
926
- * records no decision basis.
927
- */
928
- decision_presentation?: components["schemas"]["CustomerDecision"] | null;
929
- /**
930
- * @description What World declares depends on what this change deploys in this
931
- * environment, at the assessment's pinned snapshot. Absent when the
932
- * assessment's kind records no declared reach.
933
- */
934
- declared_reach?: components["schemas"]["DeclaredReachView"] | null;
935
853
  /**
936
854
  * @description The risk domains the assessment evaluated, each with its status and
937
855
  * reason, ordered by domain.
@@ -983,18 +901,6 @@ export interface components {
983
901
  * @description When the assessment completed. Null while it has not.
984
902
  */
985
903
  completed_at?: string | null;
986
- /**
987
- * @description The retained decision disclosure, which grants no deployment
988
- * authorization. Absent when none is recorded and the review kind
989
- * records no decision basis.
990
- */
991
- decision_presentation?: components["schemas"]["CustomerDecision"] | null;
992
- /**
993
- * @description What World declares depends on what this change deploys in this
994
- * environment, at the assessment's pinned snapshot. Absent when the
995
- * assessment's kind records no declared reach.
996
- */
997
- declared_reach?: components["schemas"]["DeclaredReachView"] | null;
998
904
  /**
999
905
  * @description The risk domains the assessment evaluated, each with its status and
1000
906
  * reason, ordered by domain.
@@ -1049,13 +955,6 @@ export interface components {
1049
955
  subjects: components["schemas"]["SubjectView"][];
1050
956
  };
1051
957
  CustomerCheck: {
1052
- /**
1053
- * @description Which conditions behind the outcome the change brought and which were
1054
- * already at the review's base revision. It never changes the outcome:
1055
- * a condition already at the base is pre-existing, not safe. Absent for
1056
- * a check whose evaluator does not compare the two revisions.
1057
- */
1058
- change_attribution?: components["schemas"]["ChangeAttributionView"] | null;
1059
958
  /**
1060
959
  * @description Why World refused the check, or otherwise World's recorded explanation
1061
960
  * of the result. Null when neither is recorded.
@@ -1066,6 +965,12 @@ export interface components {
1066
965
  * this instant, which can precede the assessment.
1067
966
  */
1068
967
  evaluated_at?: string | null;
968
+ /**
969
+ * @description The files World cited as evidence for this result, once each in
970
+ * World's order, with the revision World read each at. Empty when World
971
+ * cited no file, and on results recorded before World cited files.
972
+ */
973
+ files: components["schemas"]["CheckFile"][];
1069
974
  /**
1070
975
  * @description The lifecycle of the evaluator version that answered. It says whether
1071
976
  * a deployment gate could count this result, not whether one did.
@@ -1115,6 +1020,11 @@ export interface components {
1115
1020
  * @description When the code assessment ended. Null while it has not.
1116
1021
  */
1117
1022
  completed_at?: string | null;
1023
+ /**
1024
+ * @description Recorded check coverage counts and fixed cancellation causes, without source text.
1025
+ * Absent coverage does not establish that every check ran.
1026
+ */
1027
+ coverage_details?: string[];
1118
1028
  /**
1119
1029
  * @description The code-only findings the code assessment recorded, `SERIOUS` first.
1120
1030
  * An empty list does not establish deployment safety.
@@ -1141,33 +1051,6 @@ export interface components {
1141
1051
  /** @description The code assessment's recorded execution status. */
1142
1052
  status: components["schemas"]["CodeAssessmentStatus"];
1143
1053
  };
1144
- CustomerDecision: {
1145
- /** @description Whether the decision is `ADVISORY` or comes from a `DEPLOYMENT_POLICY`. */
1146
- authority: components["schemas"]["Authority"];
1147
- /**
1148
- * @description Whether a verified decision record is present, absent, legacy, failed,
1149
- * or too large for this projection.
1150
- */
1151
- availability: components["schemas"]["Availability"];
1152
- /**
1153
- * @description The permission, evidence classification and reason code of the
1154
- * verified recorded basis. Null when no verified basis is recorded.
1155
- */
1156
- basis?: components["schemas"]["CustomerDecisionBasis"] | null;
1157
- /**
1158
- * @description The local deployment gate state and any recorded override. Null unless
1159
- * the decision belongs to a deployment gate.
1160
- */
1161
- gate_state?: components["schemas"]["GateState"] | null;
1162
- };
1163
- CustomerDecisionBasis: {
1164
- /** @description How the recorded basis classified its evidence. */
1165
- evidence: components["schemas"]["EvidenceView"];
1166
- /** @description The permission the recorded basis reached: `PERMIT` or `BLOCK`. */
1167
- permission: components["schemas"]["PermissionView"];
1168
- /** @description The reason code the recorded basis gives for its permission. */
1169
- reason_code: string;
1170
- };
1171
1054
  CustomerEvidenceRef: {
1172
1055
  /**
1173
1056
  * @description The commit a file or commit reference reads. Null for other kinds, and
@@ -1298,6 +1181,11 @@ export interface components {
1298
1181
  * or `REINTRODUCED`.
1299
1182
  */
1300
1183
  lifecycle_state: string;
1184
+ /**
1185
+ * @description Earlier occurrences in the author's local reviews linked by exact patch
1186
+ * identity. These links carry no verdict or finding decision.
1187
+ */
1188
+ local_findings?: components["schemas"]["MatchedLocalFinding"][];
1301
1189
  /**
1302
1190
  * @description Where this review's comment gate placed the finding, as it recorded
1303
1191
  * the placement. Null when the review recorded none.
@@ -1349,6 +1237,11 @@ export interface components {
1349
1237
  * the automatic decision.
1350
1238
  */
1351
1239
  actor_login?: string | null;
1240
+ /**
1241
+ * @description The actor's GitHub profile name, when known. Lead with it; the login
1242
+ * is the fallback. Null for the automatic decision.
1243
+ */
1244
+ actor_name?: string | null;
1352
1245
  /** @description For `ALREADY_COVERED`, `HUMAN` or `BOT`. Null for every other decision. */
1353
1246
  covering_author_kind?: string | null;
1354
1247
  /**
@@ -1556,6 +1449,11 @@ export interface components {
1556
1449
  pull_request_author_github_user_id?: number | null;
1557
1450
  /** @description Provider display metadata for the pull request author, not the rerun requester. */
1558
1451
  pull_request_author_login?: string | null;
1452
+ /**
1453
+ * @description The author's GitHub profile name, when known. Lead with it; the login
1454
+ * is the fallback. Display metadata, never identity.
1455
+ */
1456
+ pull_request_author_name?: string | null;
1559
1457
  /** @description The author's profile on the deployment's GitHub host. Absent when no author login is known. */
1560
1458
  pull_request_author_url?: string | null;
1561
1459
  /**
@@ -1676,44 +1574,6 @@ export interface components {
1676
1574
  };
1677
1575
  /** @enum {string} */
1678
1576
  Dataset: "reviews" | "finding_outcomes" | "finding_validations" | "spend" | "findings";
1679
- /** @enum {string} */
1680
- DeclaredReachOutcome: "READ" | "NO_ROOTS" | "ROOTS_UNKNOWN" | "UNAVAILABLE";
1681
- /**
1682
- * @description One assessment's declared reach receipt. A reached entity declares a
1683
- * dependency on what the change deploys; it is never a claim that the change
1684
- * breaks it.
1685
- */
1686
- DeclaredReachView: {
1687
- /**
1688
- * @description Whether World's walk ended with no gap. An empty, incomplete reach
1689
- * says nothing about what depends on the change.
1690
- */
1691
- complete: boolean;
1692
- /** @description Every reached entity, shorter paths first, then by kind. */
1693
- entities: components["schemas"]["ReachedEntityView"][];
1694
- /** @description Where World's walk or its evidence stopped. */
1695
- gaps: components["schemas"]["ReachGapView"][];
1696
- /**
1697
- * @description `READ` when World answered, `NO_ROOTS` when no evidence bound a
1698
- * deployed artifact or workload to the repository, `ROOTS_UNKNOWN` when
1699
- * World's evidence does not establish which revision runs, and
1700
- * `UNAVAILABLE` when World gave no answer. Only `READ` carries entities or gaps.
1701
- */
1702
- outcome: components["schemas"]["DeclaredReachOutcome"];
1703
- /** @description World's digest of its full answer. Null unless `READ`. */
1704
- receipt_digest?: string | null;
1705
- /**
1706
- * Format: uuid
1707
- * @description The World snapshot the reach was read at. Null unless `READ`.
1708
- */
1709
- snapshot_id?: string | null;
1710
- /**
1711
- * @description The Terraform addresses the reach also started from, or why it took
1712
- * none. Absent when the assessment read reach only from the deployed
1713
- * revision.
1714
- */
1715
- terraform?: components["schemas"]["TerraformRootsView"] | null;
1716
- };
1717
1577
  DeepReviewEscalation: {
1718
1578
  /** @description A fixed customer explanation; internal admission errors are withheld. */
1719
1579
  reason: string;
@@ -1733,8 +1593,31 @@ export interface components {
1733
1593
  /** @description `CONSIDERED` or `SKIPPED`. */
1734
1594
  status: string;
1735
1595
  };
1736
- /** @enum {string} */
1737
- EvidenceView: "REQUIRED_PROPERTIES_ESTABLISHED" | "INCOMPLETE" | "NO_APPLICABLE_OBLIGATIONS";
1596
+ /** @description A published occurrence of an unresolved series absent from the current run. */
1597
+ EarlierOpenFinding: {
1598
+ /**
1599
+ * Format: uuid
1600
+ * @description The occurrence in the series' first published review.
1601
+ */
1602
+ finding_id: string;
1603
+ /**
1604
+ * Format: uuid
1605
+ * @description The unresolved environment finding series counted for this run.
1606
+ */
1607
+ finding_series_id: string;
1608
+ /**
1609
+ * Format: uuid
1610
+ * @description The first published review containing this occurrence.
1611
+ */
1612
+ review_id: string;
1613
+ /**
1614
+ * Format: int64
1615
+ * @description The earlier pull-request run that contains this occurrence.
1616
+ */
1617
+ run_number: number;
1618
+ /** @description Severity used by the series count; the linked occurrence may be less severe. */
1619
+ severity: string;
1620
+ };
1738
1621
  /** @enum {string} */
1739
1622
  ExportEvidenceKind: "repository_file" | "repository_file_at_commit" | "companion_repository_file" | "commit" | "workflow_run" | "world_entity" | "deterministic_test" | "recorded_read" | "text";
1740
1623
  ExportEvidenceRef: {
@@ -2210,21 +2093,6 @@ export interface components {
2210
2093
  /** @description The finding's recorded severity. */
2211
2094
  severity: components["schemas"]["ExportFindingSeverity"];
2212
2095
  };
2213
- GateState: {
2214
- /**
2215
- * @description The occurrence questions the gate's approval deferred, as each
2216
- * observed execution of its deployment answered them. Outcome-only
2217
- * records: none of them changes the gate or grades a prediction.
2218
- */
2219
- occurrence_captures: components["schemas"]["OccurrenceCapture"][];
2220
- /** @description Recorded override authorization, not confirmation of provider delivery. */
2221
- override_record?: components["schemas"]["Override"] | null;
2222
- /**
2223
- * @description Local gate state. ALLOWED/BLOCKED can precede provider delivery.
2224
- * This field does not confirm that GitHub released or blocked a run.
2225
- */
2226
- status: string;
2227
- };
2228
2096
  /** @enum {string} */
2229
2097
  GateStatus: "REQUESTED" | "EVALUATING" | "ALLOWED" | "BLOCKED" | "BYPASSED" | "SUPERSEDED";
2230
2098
  /**
@@ -2260,6 +2128,24 @@ export interface components {
2260
2128
  * @enum {string}
2261
2129
  */
2262
2130
  LocalReverificationOutcome: "RESOLVED_VERIFIED" | "STILL_PRESENT" | "NOT_VERIFIED" | "PENDING";
2131
+ /** @description A local occurrence with the same semantic fingerprint as this finding. */
2132
+ MatchedLocalFinding: {
2133
+ /**
2134
+ * Format: date-time
2135
+ * @description When the local review was requested.
2136
+ */
2137
+ created_at: string;
2138
+ /**
2139
+ * Format: uuid
2140
+ * @description The occurrence in that local review.
2141
+ */
2142
+ finding_id: string;
2143
+ /**
2144
+ * Format: uuid
2145
+ * @description The author's local review, linked by exact patch identity.
2146
+ */
2147
+ review_id: string;
2148
+ };
2263
2149
  NotAssessedView: {
2264
2150
  /**
2265
2151
  * @description The display name of the environment whose assessment is not
@@ -2272,42 +2158,6 @@ export interface components {
2272
2158
  */
2273
2159
  incompleteness_kind?: string | null;
2274
2160
  };
2275
- /** @description The capture of one observed execution of a gate's deployment. */
2276
- OccurrenceCapture: {
2277
- /** @description Assessments whose approval could defer nothing, with the reason. */
2278
- approval_gaps: components["schemas"]["ApprovalGap"][];
2279
- /** @description Explanation of the capture's outcome, when available. */
2280
- detail?: string | null;
2281
- /** @description Retained identity of the deployment occurrence, when available. */
2282
- occurrence_key?: string | null;
2283
- /** @description Deferred questions and their binding or observed results for this occurrence. */
2284
- questions: components["schemas"]["OccurrenceQuestion"][];
2285
- /** @description Whether the capture is pending, recorded, unbound, not executed, or incomplete. */
2286
- state: components["schemas"]["CaptureState"];
2287
- };
2288
- /** @description One deferred question as the gate presents it. */
2289
- OccurrenceQuestion: {
2290
- /**
2291
- * Format: uuid
2292
- * @description Assessment whose approval deferred this question.
2293
- */
2294
- assessment_id: string;
2295
- /** @description World's binding or refusal code, or the control plane's own gap. */
2296
- code?: string | null;
2297
- /** @description Hypothesis family key for the deferred question. */
2298
- family_key: string;
2299
- /**
2300
- * Format: int32
2301
- * @description Hypothesis family version for the deferred question.
2302
- */
2303
- family_version: number;
2304
- /** @description World's observed result once it recorded the question. */
2305
- observed_result?: string | null;
2306
- /** @description World outcome record identifier, when an observed result was recorded. */
2307
- outcome_id?: string | null;
2308
- /** @description Whether the question is pending, recorded, unbound, or not executed. */
2309
- state: components["schemas"]["QuestionState"];
2310
- };
2311
2161
  OpenFindingCounts: {
2312
2162
  /**
2313
2163
  * Format: uint64
@@ -2371,6 +2221,8 @@ export interface components {
2371
2221
  * @description Finding series whose current decision is an unexpired `ACCEPTED_RISK`.
2372
2222
  */
2373
2223
  accepted_risks: number;
2224
+ /** @description Exact published occurrences of earlier unresolved environment findings. */
2225
+ earlier_findings?: components["schemas"]["EarlierOpenFinding"][];
2374
2226
  /** @description Recorded assessment gaps, including explicit policy exclusions. */
2375
2227
  not_assessed: components["schemas"]["NotAssessedView"][];
2376
2228
  /**
@@ -2389,29 +2241,6 @@ export interface components {
2389
2241
  };
2390
2242
  /** @enum {string} */
2391
2243
  Outcome: "ALLOW" | "BLOCK";
2392
- Override: {
2393
- /**
2394
- * @description The comment recorded with the approval, truncated past 8000
2395
- * characters.
2396
- */
2397
- comment?: string | null;
2398
- /**
2399
- * Format: int64
2400
- * @description The GitHub environment ID the approval applied to.
2401
- */
2402
- github_environment_id: number;
2403
- /**
2404
- * Format: int64
2405
- * @description The GitHub user ID of the person whose GitHub deployment approval
2406
- * overrode the gate.
2407
- */
2408
- github_user_id: number;
2409
- /**
2410
- * @description That person's GitHub login as recorded with the approval, a display
2411
- * label truncated past 128 characters.
2412
- */
2413
- github_user_login: string;
2414
- };
2415
2244
  PassProjection: {
2416
2245
  /** @description Symbolic configuration binding, not a historical model identity. */
2417
2246
  model_binding: string;
@@ -2493,8 +2322,6 @@ export interface components {
2493
2322
  */
2494
2323
  iteration: number;
2495
2324
  };
2496
- /** @enum {string} */
2497
- PermissionView: "PERMIT" | "BLOCK";
2498
2325
  PlanProjection: {
2499
2326
  /** @description Environment assessment bindings recorded in the plan. */
2500
2327
  assessments: components["schemas"]["AssessmentProjection"][];
@@ -2609,44 +2436,6 @@ export interface components {
2609
2436
  /** @description The current gate projection, including a recorded bypass or supersession by a newer head. */
2610
2437
  status: components["schemas"]["GateStatus"];
2611
2438
  };
2612
- /** @description Where one deferred question stands. */
2613
- QuestionState: "PENDING" | "RECORDED" | "UNBOUND" | "NOT_EXECUTED";
2614
- ReachGapView: {
2615
- /** @description `COVERAGE_INCOMPLETE`, `SOURCE_CAPABILITY_MISSING` or `BOUND_REACHED`. */
2616
- code: string;
2617
- };
2618
- ReachStepView: {
2619
- /**
2620
- * Format: uuid
2621
- * @description The World relation assertion behind this step.
2622
- */
2623
- assertion_id: string;
2624
- /**
2625
- * @description `OUT` when the step follows the relation from its subject, `IN` when
2626
- * it follows it back to the subject.
2627
- */
2628
- direction: string;
2629
- /** @description The relation key, such as `proofline.relation.consumes_api`. */
2630
- relation: string;
2631
- };
2632
- ReachedEntityView: {
2633
- /**
2634
- * Format: uuid
2635
- * @description World's entity ID.
2636
- */
2637
- entity_id: string;
2638
- /** @description The entity's kind, such as `service` or `queue`. */
2639
- kind: string;
2640
- /**
2641
- * @description World's display label for the entity: environment evidence for
2642
- * readers of this organization, never published to GitHub.
2643
- */
2644
- label: string;
2645
- /** @description The recorded relation assertions from the deployed root to the entity. */
2646
- path: components["schemas"]["ReachStepView"][];
2647
- /** @description World's registry type keys for the entity. */
2648
- type_keys: string[];
2649
- };
2650
2439
  /** @description A recorded refresh decision, as the console shows it. */
2651
2440
  RefreshView: {
2652
2441
  /**
@@ -2831,6 +2620,29 @@ export interface components {
2831
2620
  * @description Finding series whose current decision is an unexpired `ACCEPTED_RISK`.
2832
2621
  */
2833
2622
  accepted_risk_count: number;
2623
+ /**
2624
+ * @description Failed CI jobs diagnosed on the reviewed head, the newest diagnosed
2625
+ * attempt of each run, in diagnosis order. The Check states each one;
2626
+ * none is a Proofline open item. Absent when no job was diagnosed.
2627
+ */
2628
+ ci_failures?: components["schemas"]["CiFailureLine"][];
2629
+ /**
2630
+ * Format: uint64
2631
+ * @description Diagnosed failed CI jobs on the reviewed head beyond `ci_failures`.
2632
+ */
2633
+ ci_failures_omitted?: number;
2634
+ /**
2635
+ * Format: uint64
2636
+ * @description Failed CI run attempts on the reviewed head whose diagnosis is queued
2637
+ * or running, so none of their jobs has a line yet.
2638
+ */
2639
+ ci_runs_pending?: number;
2640
+ /**
2641
+ * Format: uint64
2642
+ * @description Failed CI run attempts on the reviewed head whose diagnosis failed or
2643
+ * was cancelled, so none of their jobs has a line.
2644
+ */
2645
+ ci_runs_unfinished?: number;
2834
2646
  /**
2835
2647
  * Format: date-time
2836
2648
  * @description GitHub's update time for the recorded pull request state that
@@ -2842,6 +2654,11 @@ export interface components {
2842
2654
  * GitHub. Null when no pull request state is recorded.
2843
2655
  */
2844
2656
  current_head_sha?: string | null;
2657
+ /**
2658
+ * @description Exact published occurrences of earlier unresolved environment findings.
2659
+ * Absent from observations recorded before destinations were captured.
2660
+ */
2661
+ earlier_findings?: components["schemas"]["EarlierOpenFinding"][];
2845
2662
  /**
2846
2663
  * @description This review's environment assessments that are not `COMPLETED`, ordered
2847
2664
  * by environment key.
@@ -2929,8 +2746,6 @@ export interface components {
2929
2746
  findings: components["schemas"]["RoutingFindingView"][];
2930
2747
  /** @description Safe routing projection bound to this review's retained inputs. */
2931
2748
  plan: components["schemas"]["PlanProjection"];
2932
- /** @description Actual specialist selection and pass receipts for the applied workflow. */
2933
- specialist_execution?: components["schemas"]["SpecialistExecutionView"] | null;
2934
2749
  /** @constant */
2935
2750
  status: "SUPPORTED";
2936
2751
  /** @description Version of the validated routing plan. */
@@ -3006,6 +2821,11 @@ export interface components {
3006
2821
  pull_request_author_github_user_id?: number | null;
3007
2822
  /** @description Provider display metadata for the pull request author, not the rerun requester. */
3008
2823
  pull_request_author_login?: string | null;
2824
+ /**
2825
+ * @description The author's GitHub profile name, when known. Lead with it; the login
2826
+ * is the fallback. Display metadata, never identity.
2827
+ */
2828
+ pull_request_author_name?: string | null;
3009
2829
  /** @description The author's profile on the deployment's GitHub host. Absent when no author login is known. */
3010
2830
  pull_request_author_url?: string | null;
3011
2831
  /**
@@ -3059,32 +2879,6 @@ export interface components {
3059
2879
  */
3060
2880
  trigger_origin: string;
3061
2881
  };
3062
- /** @description One member of a review's declared tree that World cited. */
3063
- ReviewedTreeCitationView: {
3064
- /**
3065
- * @description The member's content hash. Absent for a member a `REJECTED`
3066
- * population refused, because such a population keeps no members.
3067
- */
3068
- content_sha256?: string | null;
3069
- /** @description The overlay World read the member from. */
3070
- overlay_digest: string;
3071
- /**
3072
- * @description The member's path in the repository at that revision. Repository
3073
- * text, so it can hold bidirectional controls that reorder what the
3074
- * reader sees.
3075
- */
3076
- path: components["schemas"]["UntrustedText"];
3077
- /**
3078
- * @description The population the member belongs to, such as
3079
- * `WORKFLOW_DEFINITIONS`.
3080
- */
3081
- population_kind: string;
3082
- /**
3083
- * @description `PROPOSED_CODE_REVISION` (the reviewed commit) or
3084
- * `BASE_CODE_REVISION` (its merge base).
3085
- */
3086
- role: string;
3087
- };
3088
2882
  /**
3089
2883
  * @description The NDJSON row and CSV column contract. Repository names are display data;
3090
2884
  * the stable repository ID and recorded commit identify the reviewed input.
@@ -3179,6 +2973,13 @@ export interface components {
3179
2973
  placement: string;
3180
2974
  /** @description Human override beside the original decision, when one was requested. */
3181
2975
  promotion?: components["schemas"]["FindingPromotionView"] | null;
2976
+ /**
2977
+ * Format: uuid
2978
+ * @description The finding that represents this finding's publication group, when an
2979
+ * applied group publishes it in one comment with other findings. Every
2980
+ * member names the same finding, the representative included.
2981
+ */
2982
+ publication_group?: string | null;
3182
2983
  /** @description Recognized safe reason codes; unknown values are represented as `UNRECOGNIZED`. */
3183
2984
  reason_codes: string[];
3184
2985
  /** @description Rule that produced the recorded placement. */
@@ -3308,40 +3109,6 @@ export interface components {
3308
3109
  */
3309
3110
  run_number: number;
3310
3111
  };
3311
- SpecialistAssessmentExecution: {
3312
- /**
3313
- * Format: uuid
3314
- * @description The immutable assessment whose specialist execution is reported.
3315
- */
3316
- assessment_id: string;
3317
- /** @description Selected specialist passes and their retained execution outputs. */
3318
- passes: components["schemas"]["SpecialistPassExecution"][];
3319
- };
3320
- SpecialistExecutionView: {
3321
- /** @description The applied specialist roster per exact assessment execution. */
3322
- assessments: components["schemas"]["SpecialistAssessmentExecution"][];
3323
- /** @description False until the applied parent captures its specialist choices. */
3324
- selection_recorded: boolean;
3325
- };
3326
- /** @description A pass receipt's bounded operational facts, without its proposals or prose. */
3327
- SpecialistOutputProjection: {
3328
- /** @description Closed evidence-gap class, absent when the pass produced output. */
3329
- gap_kind?: string | null;
3330
- /** @description Verified digest of the retained output bytes. */
3331
- output_sha256: string;
3332
- /** @description `PRODUCED`, `UNAVAILABLE`, `INCOMPLETE` or `MALFORMED`. */
3333
- status: string;
3334
- };
3335
- SpecialistPassExecution: {
3336
- /** @description Exact selected paths from the validated captured change. */
3337
- files: string[];
3338
- /** @description Whether captured file facts required this pass. */
3339
- floor: boolean;
3340
- /** @description Closed registry key of the selected specialist. */
3341
- name: string;
3342
- /** @description Missing means selected, with no retained output. It never means success. */
3343
- output?: components["schemas"]["SpecialistOutputProjection"] | null;
3344
- };
3345
3112
  /** @enum {string} */
3346
3113
  SpendAccountKind: "DEPLOYMENT" | "TENANT_CREDENTIAL" | "UNATTRIBUTED";
3347
3114
  /** @description UTC daily debit totals using only the account and transport recorded at charge time. */
@@ -3510,27 +3277,6 @@ export interface components {
3510
3277
  /** @enum {string} */
3511
3278
  SummaryRoute: "DETERMINISTIC_ONLY" | "SHORT" | "FULL";
3512
3279
  /** @enum {string} */
3513
- TerraformPlanView: "TAKEN" | "NOT_DECLARED" | "NOT_PINNED" | "HEAD_DIFFERS" | "ADDRESSES_UNREPORTED";
3514
- /** @description The Terraform roots of one declared reach read. */
3515
- TerraformRootsView: {
3516
- /** @description The changed resource instance addresses taken as roots. */
3517
- addresses: string[];
3518
- /**
3519
- * Format: uint
3520
- * @description Changed addresses left out at World's limit of 100 roots per read.
3521
- */
3522
- omitted: number;
3523
- /**
3524
- * @description `TAKEN` when the plan pinned for the reviewed commit named the roots,
3525
- * `NOT_DECLARED` when the environment captures no Terraform plan for this
3526
- * review, `NOT_PINNED` when it declares one and none was pinned,
3527
- * `HEAD_DIFFERS` when the pinned plan is for another commit, and
3528
- * `ADDRESSES_UNREPORTED` when the pinned plan records no changed
3529
- * addresses because it was pinned before World reported them.
3530
- */
3531
- plan: components["schemas"]["TerraformPlanView"];
3532
- };
3533
- /** @enum {string} */
3534
3280
  ThreadObservationFreshness: "FRESH" | "STALE";
3535
3281
  /** @description A read of GitHub's thread state. `observed_at` is when Proofline read it. */
3536
3282
  ThreadObservationView: {