proofline-sdk 3.2.1__tar.gz → 3.3.1__tar.gz

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.
Files changed (227) hide show
  1. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/PKG-INFO +23 -3
  2. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/README.md +22 -2
  3. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/openapi.public.json +3 -3
  4. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/ci_failure_line.py +1 -1
  5. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_open_items.py +2 -2
  6. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_mcp.py +24 -2
  7. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_transport.py +1 -1
  8. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/client.py +4 -0
  9. proofline_sdk-3.3.1/proofline/fixes.py +93 -0
  10. proofline_sdk-3.3.1/proofline/knowledge.py +135 -0
  11. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/outcomes.py +29 -10
  12. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/pyproject.toml +1 -1
  13. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/scripts/install_smoke.py +25 -2
  14. proofline_sdk-3.3.1/tests/fixtures/review-outcomes.json +1833 -0
  15. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/tests/test_http.py +278 -5
  16. proofline_sdk-3.2.1/proofline/fixes.py +0 -61
  17. proofline_sdk-3.2.1/proofline/knowledge.py +0 -65
  18. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/.gitignore +0 -0
  19. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/LICENSE +0 -0
  20. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/generator.json +0 -0
  21. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/__init__.py +0 -0
  22. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/LICENSE +0 -0
  23. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/__init__.py +0 -0
  24. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/__init__.py +0 -0
  25. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/__init__.py +0 -0
  26. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_agent_session.py +0 -0
  27. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_agent_session_prompt.py +0 -0
  28. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_assessment.py +0 -0
  29. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_deployment_review.py +0 -0
  30. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_finding.py +0 -0
  31. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_finding_fix_prompt.py +0 -0
  32. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_pull_request_review.py +0 -0
  33. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_review.py +0 -0
  34. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_review_guidance.py +0 -0
  35. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/get_review_routing.py +0 -0
  36. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/list_pull_request_reviews.py +0 -0
  37. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/list_repositories.py +0 -0
  38. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/list_reviews.py +0 -0
  39. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/request_commit_review.py +0 -0
  40. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/request_file_review.py +0 -0
  41. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/request_patch_review.py +0 -0
  42. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/request_review.py +0 -0
  43. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/request_scan.py +0 -0
  44. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/rerun_review.py +0 -0
  45. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/start_agent_session.py +0 -0
  46. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/stop_review.py +0 -0
  47. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/default/upload_coverage_reports.py +0 -0
  48. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/api/operations.py +0 -0
  49. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/client.py +0 -0
  50. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/errors.py +0 -0
  51. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/__init__.py +0 -0
  52. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/action_unavailability.py +0 -0
  53. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/actor_view.py +0 -0
  54. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/agent_session.py +0 -0
  55. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/agent_session_prompt_type_0.py +0 -0
  56. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/agent_session_prompt_type_1.py +0 -0
  57. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/agent_session_target.py +0 -0
  58. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/agent_vendor.py +0 -0
  59. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/assessment_projection.py +0 -0
  60. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/author_choice.py +0 -0
  61. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/change_diagram_kind_view.py +0 -0
  62. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/change_diagram_outcome_type_0.py +0 -0
  63. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/change_diagram_view.py +0 -0
  64. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/change_summary.py +0 -0
  65. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/check_file.py +0 -0
  66. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/ci_failure_attribution.py +0 -0
  67. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/code_assessment_status_type_0.py +0 -0
  68. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/comment_address_evaluation_view.py +0 -0
  69. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/comment_address_outcome.py +0 -0
  70. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/comment_reaction.py +0 -0
  71. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/comment_reaction_view.py +0 -0
  72. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/commit_review_request.py +0 -0
  73. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/commit_review_response.py +0 -0
  74. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/coverage_refused.py +0 -0
  75. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/coverage_upload_request.py +0 -0
  76. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/coverage_upload_response.py +0 -0
  77. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_assessment.py +0 -0
  78. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_assessment_detail.py +0 -0
  79. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_check.py +0 -0
  80. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_checks.py +0 -0
  81. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_code_assessment.py +0 -0
  82. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_evidence_ref.py +0 -0
  83. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_finding.py +0 -0
  84. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_finding_validation.py +0 -0
  85. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/customer_review_detail.py +0 -0
  86. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/dataset.py +0 -0
  87. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/deep_review_escalation.py +0 -0
  88. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/deep_review_escalation_status.py +0 -0
  89. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/domain_view.py +0 -0
  90. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/earlier_open_finding.py +0 -0
  91. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_evidence_kind.py +0 -0
  92. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_evidence_ref.py +0 -0
  93. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_finding_lifecycle.py +0 -0
  94. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_finding_severity.py +0 -0
  95. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_review_kind.py +0 -0
  96. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_review_status.py +0 -0
  97. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_validation.py +0 -0
  98. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/export_validation_source.py +0 -0
  99. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/file_fact.py +0 -0
  100. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/file_projection.py +0 -0
  101. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/file_review_request.py +0 -0
  102. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/file_review_response.py +0 -0
  103. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/file_scope.py +0 -0
  104. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/filter_choice.py +0 -0
  105. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_causal_edge_view.py +0 -0
  106. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_causal_graph_view.py +0 -0
  107. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_causal_node_view.py +0 -0
  108. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_evidence_class_type_0.py +0 -0
  109. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_fix_prompt_type_0.py +0 -0
  110. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_fix_prompt_type_1.py +0 -0
  111. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_count.py +0 -0
  112. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_drilldown.py +0 -0
  113. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_export_row.py +0 -0
  114. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_group_by.py +0 -0
  115. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_outcome.py +0 -0
  116. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_outcome_count.py +0 -0
  117. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_post_merge_count.py +0 -0
  118. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_post_merge_counts.py +0 -0
  119. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_post_merge_outcome.py +0 -0
  120. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_selector.py +0 -0
  121. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_outcomes_validation_sources.py +0 -0
  122. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_placement_view.py +0 -0
  123. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_promotion_view.py +0 -0
  124. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_rule_ref_view.py +0 -0
  125. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_rule_revision_view.py +0 -0
  126. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_support.py +0 -0
  127. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/finding_validations_export_row.py +0 -0
  128. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/findings_export_row.py +0 -0
  129. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/gate_status.py +0 -0
  130. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/local_reverification.py +0 -0
  131. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/local_reverification_outcome.py +0 -0
  132. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/matched_local_finding.py +0 -0
  133. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/not_assessed_view.py +0 -0
  134. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_finding_counts.py +0 -0
  135. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_item_environment.py +0 -0
  136. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_items_gap_reason.py +0 -0
  137. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_items_head_state.py +0 -0
  138. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_items_review_status.py +0 -0
  139. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_items_thread_unknown.py +0 -0
  140. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_items_threads_type_0.py +0 -0
  141. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_items_threads_type_1.py +0 -0
  142. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/open_items_view.py +0 -0
  143. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/outcome.py +0 -0
  144. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/pass_projection.py +0 -0
  145. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/patch_review_request.py +0 -0
  146. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/patch_review_response.py +0 -0
  147. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/patch_trigger_source.py +0 -0
  148. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/patch_verification.py +0 -0
  149. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/plan_projection.py +0 -0
  150. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/problem.py +0 -0
  151. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/prose.py +0 -0
  152. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/prose_outcome_type_0.py +0 -0
  153. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/pull_request_merge_gate.py +0 -0
  154. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/refresh_view.py +0 -0
  155. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/refused_environment.py +0 -0
  156. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/related_review.py +0 -0
  157. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/repository_guidance.py +0 -0
  158. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/repository_name.py +0 -0
  159. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/repository_names.py +0 -0
  160. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/rerun_response.py +0 -0
  161. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_actions.py +0 -0
  162. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_depth.py +0 -0
  163. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_diff_stats.py +0 -0
  164. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_filters.py +0 -0
  165. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_page.py +0 -0
  166. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_routing_view_type_0.py +0 -0
  167. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_routing_view_type_1.py +0 -0
  168. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_routing_view_type_2.py +0 -0
  169. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/review_summary.py +0 -0
  170. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/reviews_export_row.py +0 -0
  171. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/routing_finding_view.py +0 -0
  172. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/rule_source.py +0 -0
  173. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_mode.py +0 -0
  174. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_0.py +0 -0
  175. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_1.py +0 -0
  176. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_10.py +0 -0
  177. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_11.py +0 -0
  178. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_2.py +0 -0
  179. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_3.py +0 -0
  180. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_4.py +0 -0
  181. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_5.py +0 -0
  182. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_6.py +0 -0
  183. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_7.py +0 -0
  184. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_8.py +0 -0
  185. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refusal_view_type_9.py +0 -0
  186. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_refused.py +0 -0
  187. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_request.py +0 -0
  188. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/run_now_response.py +0 -0
  189. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/scan_request_body.py +0 -0
  190. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/scan_response.py +0 -0
  191. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/spend_account_kind.py +0 -0
  192. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/spend_export_row.py +0 -0
  193. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/start_session.py +0 -0
  194. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/stop_response.py +0 -0
  195. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/subject_authorization.py +0 -0
  196. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/subject_view.py +0 -0
  197. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/summary_route.py +0 -0
  198. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/thread_observation_freshness.py +0 -0
  199. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/thread_observation_view.py +0 -0
  200. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/thread_provider_state.py +0 -0
  201. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/thread_reply_evidence.py +0 -0
  202. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/untrusted_text.py +0 -0
  203. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/uploaded_report.py +0 -0
  204. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/walkthrough_file_view.py +0 -0
  205. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/walkthrough_group_view.py +0 -0
  206. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/models/walkthrough_view.py +0 -0
  207. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_generated/types.py +0 -0
  208. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/_sync_http.py +0 -0
  209. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/exports.py +0 -0
  210. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/proofline/py.typed +0 -0
  211. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/requirements-dev.txt +0 -0
  212. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/scripts/_uv.py +0 -0
  213. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/scripts/check.py +0 -0
  214. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/scripts/contracts.py +0 -0
  215. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/scripts/generate.py +0 -0
  216. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/scripts/release-files.py +0 -0
  217. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/scripts/release-version.py +0 -0
  218. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/templates/LICENSE.openapi-python-client +0 -0
  219. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/templates/client.py.jinja +0 -0
  220. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/templates/errors.py.jinja +0 -0
  221. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/templates/operations.py.jinja +0 -0
  222. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/templates/property_templates/const_property.py.jinja +0 -0
  223. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/tests/__init__.py +0 -0
  224. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/tests/fixtures.py +0 -0
  225. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/tests/http_server.py +0 -0
  226. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/tests/test_generated_operation.py +0 -0
  227. {proofline_sdk-3.2.1 → proofline_sdk-3.3.1}/tests/test_release_version.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: proofline-sdk
3
- Version: 3.2.1
3
+ Version: 3.3.1
4
4
  Summary: Typed synchronous and asynchronous clients for the Proofline review API
5
5
  Project-URL: Homepage, https://proofline.sh
6
6
  Project-URL: Documentation, https://proofline.sh/docs/sdks/
@@ -98,9 +98,29 @@ with ProoflineClient() as client:
98
98
 
99
99
  The response names the recorded report and its covered and instrumented line counts. An identical upload returns that report with `created=False`. Refused reports raise `ProoflineError`. Uploading a report does not establish a check verdict.
100
100
 
101
+ ## MCP organization selection
102
+
103
+ With an MCP OAuth credential approved for several organizations, discover its currently authorized targets with `client.mcp.list_organizations()`. It returns a `KnowledgeResult`; inspect `isError` before reading `structuredContent["data"]["organizations"]`. Each entry contains `organization_id`, `github_login`, and `scopes`.
104
+
105
+ Pass the chosen UUID string as the optional keyword `organization_id` on any `knowledge` or `fixes` method:
106
+
107
+ ```python
108
+ organizations = client.mcp.list_organizations()
109
+ if organizations.get("isError"):
110
+ raise RuntimeError("Organization discovery was refused.")
111
+ print(organizations["structuredContent"]["data"]["organizations"])
112
+ # Set organization_id to the UUID of the organization you intend to use.
113
+ result = client.fixes.get_fix_context(finding_id, organization_id=organization_id)
114
+ result = client.knowledge.get_wiki_page(
115
+ "owner/name", "index", organization_id=organization_id,
116
+ )
117
+ ```
118
+
119
+ The async client exposes the same helpers with `await`. Selection applies only to that call, including concurrent calls on one client. A single-organization credential can omit the keyword. An ambiguous omission retains the server's `ORGANIZATION_REQUIRED` tool refusal; a foreign or revoked target retains `NOT_AUTHORIZED` and `isError`. The SDK chooses no default and never retries a tool call. Discovery and targeting use MCP only; an MCP OAuth credential cannot call the REST API. Each organization's scopes and repository restrictions still apply.
120
+
101
121
  ## Knowledge and plans
102
122
 
103
- Both clients expose typed methods under `client.knowledge` over Proofline's stateless MCP endpoint:
123
+ Both clients expose typed methods under `client.knowledge` over Proofline's stateless MCP endpoint. Every method accepts the optional `organization_id` keyword described above:
104
124
 
105
125
  - `list_wiki_pages(repository, commit=...)`
106
126
  - `get_wiki_page(repository, page_key, commit=...)`
@@ -124,7 +144,7 @@ Each call initializes MCP and makes one tool request without retries, including
124
144
 
125
145
  ## Fix context and re-verification
126
146
 
127
- Both clients expose finding and re-verification methods under `client.fixes` over the stateless MCP endpoint:
147
+ Both clients expose finding and re-verification methods under `client.fixes` over the stateless MCP endpoint. Every method accepts the optional `organization_id` keyword described above:
128
148
 
129
149
  - `list_open_findings(repository, pull_request_number)`
130
150
  - `get_fix_context(finding_id)`
@@ -65,9 +65,29 @@ with ProoflineClient() as client:
65
65
 
66
66
  The response names the recorded report and its covered and instrumented line counts. An identical upload returns that report with `created=False`. Refused reports raise `ProoflineError`. Uploading a report does not establish a check verdict.
67
67
 
68
+ ## MCP organization selection
69
+
70
+ With an MCP OAuth credential approved for several organizations, discover its currently authorized targets with `client.mcp.list_organizations()`. It returns a `KnowledgeResult`; inspect `isError` before reading `structuredContent["data"]["organizations"]`. Each entry contains `organization_id`, `github_login`, and `scopes`.
71
+
72
+ Pass the chosen UUID string as the optional keyword `organization_id` on any `knowledge` or `fixes` method:
73
+
74
+ ```python
75
+ organizations = client.mcp.list_organizations()
76
+ if organizations.get("isError"):
77
+ raise RuntimeError("Organization discovery was refused.")
78
+ print(organizations["structuredContent"]["data"]["organizations"])
79
+ # Set organization_id to the UUID of the organization you intend to use.
80
+ result = client.fixes.get_fix_context(finding_id, organization_id=organization_id)
81
+ result = client.knowledge.get_wiki_page(
82
+ "owner/name", "index", organization_id=organization_id,
83
+ )
84
+ ```
85
+
86
+ The async client exposes the same helpers with `await`. Selection applies only to that call, including concurrent calls on one client. A single-organization credential can omit the keyword. An ambiguous omission retains the server's `ORGANIZATION_REQUIRED` tool refusal; a foreign or revoked target retains `NOT_AUTHORIZED` and `isError`. The SDK chooses no default and never retries a tool call. Discovery and targeting use MCP only; an MCP OAuth credential cannot call the REST API. Each organization's scopes and repository restrictions still apply.
87
+
68
88
  ## Knowledge and plans
69
89
 
70
- Both clients expose typed methods under `client.knowledge` over Proofline's stateless MCP endpoint:
90
+ Both clients expose typed methods under `client.knowledge` over Proofline's stateless MCP endpoint. Every method accepts the optional `organization_id` keyword described above:
71
91
 
72
92
  - `list_wiki_pages(repository, commit=...)`
73
93
  - `get_wiki_page(repository, page_key, commit=...)`
@@ -91,7 +111,7 @@ Each call initializes MCP and makes one tool request without retries, including
91
111
 
92
112
  ## Fix context and re-verification
93
113
 
94
- Both clients expose finding and re-verification methods under `client.fixes` over the stateless MCP endpoint:
114
+ Both clients expose finding and re-verification methods under `client.fixes` over the stateless MCP endpoint. Every method accepts the optional `organization_id` keyword described above:
95
115
 
96
116
  - `list_open_findings(repository, pull_request_number)`
97
117
  - `get_fix_context(finding_id)`
@@ -549,7 +549,7 @@
549
549
  "type": "string"
550
550
  },
551
551
  "CiFailureLine": {
552
- "description": "One failed CI job as the Check states it.",
552
+ "description": "One failed CI job in the observation.",
553
553
  "properties": {
554
554
  "attribution": {
555
555
  "allOf": [
@@ -4263,7 +4263,7 @@
4263
4263
  "type": "integer"
4264
4264
  },
4265
4265
  "ci_failures": {
4266
- "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.",
4266
+ "description": "Failed CI jobs diagnosed on the reviewed head, the newest diagnosed\n attempt of each run, in diagnosis order. The pull-request Check counts\n them; none is a Proofline open item. Absent when no job was diagnosed.",
4267
4267
  "items": {
4268
4268
  "$ref": "#/components/schemas/CiFailureLine"
4269
4269
  },
@@ -5831,7 +5831,7 @@
5831
5831
  },
5832
5832
  "info": {
5833
5833
  "title": "Proofline Review API",
5834
- "version": "3.2.0"
5834
+ "version": "3.3.0"
5835
5835
  },
5836
5836
  "openapi": "3.1.0",
5837
5837
  "paths": {
@@ -14,7 +14,7 @@ T = TypeVar("T", bound="CiFailureLine")
14
14
 
15
15
  @_attrs_define
16
16
  class CiFailureLine:
17
- """One failed CI job as the Check states it.
17
+ """One failed CI job in the observation.
18
18
 
19
19
  Attributes:
20
20
  attribution (CiFailureAttribution): What the control plane records as a failure's cause.
@@ -44,8 +44,8 @@ class ReviewOpenItems:
44
44
  review_status (OpenItemsReviewStatus):
45
45
  threads (OpenItemsThreadsType0 | OpenItemsThreadsType1):
46
46
  ci_failures (list[CiFailureLine] | Unset): Failed CI jobs diagnosed on the reviewed head, the newest diagnosed
47
- attempt of each run, in diagnosis order. The Check states each one;
48
- none is a Proofline open item. Absent when no job was diagnosed.
47
+ attempt of each run, in diagnosis order. The pull-request Check counts
48
+ them; none is a Proofline open item. Absent when no job was diagnosed.
49
49
  ci_failures_omitted (int | Unset): Diagnosed failed CI jobs on the reviewed head beyond `ci_failures`.
50
50
  ci_runs_pending (int | Unset): Failed CI run attempts on the reviewed head whose diagnosis is queued
51
51
  or running, so none of their jobs has a line yet.
@@ -95,7 +95,11 @@ class McpTools:
95
95
  def __init__(self, http: httpx.Client) -> None:
96
96
  self._http = http
97
97
 
98
- def _call(self, name: str, args: dict[str, Any]) -> KnowledgeResult:
98
+ def _call(
99
+ self, name: str, args: dict[str, Any], *, organization_id: str | None = None
100
+ ) -> KnowledgeResult:
101
+ if organization_id is not None:
102
+ args = {**args, "organization_id": organization_id}
99
103
  call = _body("tools/call", {"name": name, "arguments": args}, 2)
100
104
  frames = [
101
105
  (
@@ -140,7 +144,11 @@ class AsyncMcpTools:
140
144
  def __init__(self, http: httpx.AsyncClient) -> None:
141
145
  self._http = http
142
146
 
143
- async def _call(self, name: str, args: dict[str, Any]) -> KnowledgeResult:
147
+ async def _call(
148
+ self, name: str, args: dict[str, Any], *, organization_id: str | None = None
149
+ ) -> KnowledgeResult:
150
+ if organization_id is not None:
151
+ args = {**args, "organization_id": organization_id}
144
152
  call = _body("tools/call", {"name": name, "arguments": args}, 2)
145
153
  frames = [
146
154
  (
@@ -177,3 +185,17 @@ class AsyncMcpTools:
177
185
  if identity == 1 and result.get("protocolVersion") != PROTOCOL:
178
186
  raise _refused()
179
187
  return _result(result)
188
+
189
+
190
+ class McpClient(McpTools):
191
+ """Discover the organizations currently authorized for this MCP credential."""
192
+
193
+ def list_organizations(self) -> KnowledgeResult:
194
+ return self._call("list_organizations", {})
195
+
196
+
197
+ class AsyncMcpClient(AsyncMcpTools):
198
+ """Discover the organizations currently authorized for this MCP credential."""
199
+
200
+ async def list_organizations(self) -> KnowledgeResult:
201
+ return await self._call("list_organizations", {})
@@ -22,7 +22,7 @@ from pydantic import SecretStr
22
22
  from ._sync_http import IO_DEADLINE
23
23
  from ._sync_http import Transport as SyncHTTPTransport
24
24
 
25
- VERSION = "3.2.1"
25
+ VERSION = "3.3.1"
26
26
  MAX_RESPONSE_BYTES = 8 * 1024 * 1024
27
27
  WEEKDAY = r"(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)"
28
28
  FULL_WEEKDAY = r"(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday)"
@@ -69,6 +69,7 @@ from ._generated.models.run_now_response import RunNowResponse
69
69
  from ._generated.models.start_session import StartSession
70
70
  from ._generated.models.stop_response import StopResponse
71
71
  from ._generated.types import UNSET, Response, Unset
72
+ from ._mcp import AsyncMcpClient, McpClient
72
73
  from ._transport import ProoflineError
73
74
  from .exports import ExportDataset, ExportFormat, ExportPage, decode_export
74
75
  from .fixes import AsyncFixesClient, FixesClient
@@ -109,6 +110,7 @@ class ReviewFilters(TypedDict, total=False):
109
110
  findings: str | None
110
111
  kind: str | None
111
112
  limit: int | None
113
+ query: str | None
112
114
  repository: UUID | None
113
115
  search: str | None
114
116
  status: str | None
@@ -202,6 +204,7 @@ class ProoflineClient(Operations):
202
204
  transport=_transport.RetryTransport(self._api.token, timeout),
203
205
  )
204
206
  self._api.set_httpx_client(self._http)
207
+ self.mcp = McpClient(self._http)
205
208
  self.knowledge = KnowledgeClient(self._http)
206
209
  self.fixes = FixesClient(self._http)
207
210
 
@@ -530,6 +533,7 @@ class AsyncProoflineClient(AsyncOperations):
530
533
  transport=_transport.AsyncRetryTransport(self._api.token, timeout),
531
534
  )
532
535
  self._api.set_async_httpx_client(self._http)
536
+ self.mcp = AsyncMcpClient(self._http)
533
537
  self.knowledge = AsyncKnowledgeClient(self._http)
534
538
  self.fixes = AsyncFixesClient(self._http)
535
539
 
@@ -0,0 +1,93 @@
1
+ """Fix context and pushed-head verification. Tool refusals retain isError."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any
6
+
7
+ from ._mcp import AsyncMcpTools, KnowledgeResult, McpTools
8
+
9
+
10
+ class FixesClient(McpTools):
11
+ def list_open_findings(
12
+ self, repository: str, pull_request_number: int, *, organization_id: str | None = None
13
+ ) -> KnowledgeResult:
14
+ return self._call(
15
+ "list_open_findings",
16
+ {"repository": repository, "pull_request_number": pull_request_number},
17
+ organization_id=organization_id,
18
+ )
19
+
20
+ def get_fix_context(
21
+ self, finding_id: str, *, organization_id: str | None = None
22
+ ) -> KnowledgeResult:
23
+ return self._call(
24
+ "get_fix_context", {"finding_id": finding_id}, organization_id=organization_id
25
+ )
26
+
27
+ def request_reverification(
28
+ self,
29
+ review_id: str,
30
+ finding_ids: list[str],
31
+ commit_sha: str,
32
+ *,
33
+ note: str | None = None,
34
+ organization_id: str | None = None,
35
+ ) -> KnowledgeResult:
36
+ args: dict[str, Any] = {
37
+ "review_id": review_id,
38
+ "finding_ids": finding_ids,
39
+ "commit_sha": commit_sha,
40
+ }
41
+ if note is not None:
42
+ args["note"] = note
43
+ return self._call("request_reverification", args, organization_id=organization_id)
44
+
45
+ def get_reverification(
46
+ self, request_id: str, *, organization_id: str | None = None
47
+ ) -> KnowledgeResult:
48
+ return self._call(
49
+ "get_reverification", {"request_id": request_id}, organization_id=organization_id
50
+ )
51
+
52
+
53
+ class AsyncFixesClient(AsyncMcpTools):
54
+ async def list_open_findings(
55
+ self, repository: str, pull_request_number: int, *, organization_id: str | None = None
56
+ ) -> KnowledgeResult:
57
+ return await self._call(
58
+ "list_open_findings",
59
+ {"repository": repository, "pull_request_number": pull_request_number},
60
+ organization_id=organization_id,
61
+ )
62
+
63
+ async def get_fix_context(
64
+ self, finding_id: str, *, organization_id: str | None = None
65
+ ) -> KnowledgeResult:
66
+ return await self._call(
67
+ "get_fix_context", {"finding_id": finding_id}, organization_id=organization_id
68
+ )
69
+
70
+ async def request_reverification(
71
+ self,
72
+ review_id: str,
73
+ finding_ids: list[str],
74
+ commit_sha: str,
75
+ *,
76
+ note: str | None = None,
77
+ organization_id: str | None = None,
78
+ ) -> KnowledgeResult:
79
+ args: dict[str, Any] = {
80
+ "review_id": review_id,
81
+ "finding_ids": finding_ids,
82
+ "commit_sha": commit_sha,
83
+ }
84
+ if note is not None:
85
+ args["note"] = note
86
+ return await self._call("request_reverification", args, organization_id=organization_id)
87
+
88
+ async def get_reverification(
89
+ self, request_id: str, *, organization_id: str | None = None
90
+ ) -> KnowledgeResult:
91
+ return await self._call(
92
+ "get_reverification", {"request_id": request_id}, organization_id=organization_id
93
+ )
@@ -0,0 +1,135 @@
1
+ """Published knowledge operations through the scoped MCP server."""
2
+
3
+ from ._mcp import AsyncMcpTools, KnowledgeResult, McpTools, _repository
4
+
5
+
6
+ class KnowledgeClient(McpTools):
7
+ def list_wiki_pages(
8
+ self, repository: str, *, commit: str | None = None, organization_id: str | None = None
9
+ ) -> KnowledgeResult:
10
+ return self._call(
11
+ "list_wiki_pages", _repository(repository, commit), organization_id=organization_id
12
+ )
13
+
14
+ def get_wiki_page(
15
+ self,
16
+ repository: str,
17
+ page_key: str,
18
+ *,
19
+ commit: str | None = None,
20
+ organization_id: str | None = None,
21
+ ) -> KnowledgeResult:
22
+ return self._call(
23
+ "get_wiki_page",
24
+ {**_repository(repository, commit), "page_key": page_key},
25
+ organization_id=organization_id,
26
+ )
27
+
28
+ def ask_codebase(
29
+ self,
30
+ repository: str,
31
+ question: str,
32
+ *,
33
+ commit: str | None = None,
34
+ organization_id: str | None = None,
35
+ ) -> KnowledgeResult:
36
+ return self._call(
37
+ "ask_codebase",
38
+ {**_repository(repository, commit), "question": question},
39
+ organization_id=organization_id,
40
+ )
41
+
42
+ def get_architecture_document(
43
+ self, environment_id: str, *, organization_id: str | None = None
44
+ ) -> KnowledgeResult:
45
+ return self._call(
46
+ "get_architecture_document",
47
+ {"environment_id": environment_id},
48
+ organization_id=organization_id,
49
+ )
50
+
51
+ def get_plan(self, plan_id: str, *, organization_id: str | None = None) -> KnowledgeResult:
52
+ return self._call("get_plan", {"plan_id": plan_id}, organization_id=organization_id)
53
+
54
+ def start_plan_implementation(
55
+ self, plan_id: str, *, organization_id: str | None = None
56
+ ) -> KnowledgeResult:
57
+ return self._call(
58
+ "start_plan_implementation", {"plan_id": plan_id}, organization_id=organization_id
59
+ )
60
+
61
+ def get_plan_implementation(
62
+ self, implementation_id: str, *, organization_id: str | None = None
63
+ ) -> KnowledgeResult:
64
+ return self._call(
65
+ "get_plan_implementation",
66
+ {"implementation_id": implementation_id},
67
+ organization_id=organization_id,
68
+ )
69
+
70
+
71
+ class AsyncKnowledgeClient(AsyncMcpTools):
72
+ async def list_wiki_pages(
73
+ self, repository: str, *, commit: str | None = None, organization_id: str | None = None
74
+ ) -> KnowledgeResult:
75
+ return await self._call(
76
+ "list_wiki_pages", _repository(repository, commit), organization_id=organization_id
77
+ )
78
+
79
+ async def get_wiki_page(
80
+ self,
81
+ repository: str,
82
+ page_key: str,
83
+ *,
84
+ commit: str | None = None,
85
+ organization_id: str | None = None,
86
+ ) -> KnowledgeResult:
87
+ return await self._call(
88
+ "get_wiki_page",
89
+ {**_repository(repository, commit), "page_key": page_key},
90
+ organization_id=organization_id,
91
+ )
92
+
93
+ async def ask_codebase(
94
+ self,
95
+ repository: str,
96
+ question: str,
97
+ *,
98
+ commit: str | None = None,
99
+ organization_id: str | None = None,
100
+ ) -> KnowledgeResult:
101
+ return await self._call(
102
+ "ask_codebase",
103
+ {**_repository(repository, commit), "question": question},
104
+ organization_id=organization_id,
105
+ )
106
+
107
+ async def get_architecture_document(
108
+ self, environment_id: str, *, organization_id: str | None = None
109
+ ) -> KnowledgeResult:
110
+ return await self._call(
111
+ "get_architecture_document",
112
+ {"environment_id": environment_id},
113
+ organization_id=organization_id,
114
+ )
115
+
116
+ async def get_plan(
117
+ self, plan_id: str, *, organization_id: str | None = None
118
+ ) -> KnowledgeResult:
119
+ return await self._call("get_plan", {"plan_id": plan_id}, organization_id=organization_id)
120
+
121
+ async def start_plan_implementation(
122
+ self, plan_id: str, *, organization_id: str | None = None
123
+ ) -> KnowledgeResult:
124
+ return await self._call(
125
+ "start_plan_implementation", {"plan_id": plan_id}, organization_id=organization_id
126
+ )
127
+
128
+ async def get_plan_implementation(
129
+ self, implementation_id: str, *, organization_id: str | None = None
130
+ ) -> KnowledgeResult:
131
+ return await self._call(
132
+ "get_plan_implementation",
133
+ {"implementation_id": implementation_id},
134
+ organization_id=organization_id,
135
+ )
@@ -14,6 +14,10 @@ from ._transport import ProoflineError
14
14
  OutcomeStatus = Literal["COMPLETED", "INCOMPLETE", "FAILED", "STOPPED", "TIMED_OUT"]
15
15
  COMPLETE_CHECKS = frozenset(("READY", "BLOCKED", "NOT_APPLICABLE"))
16
16
  COMPLETE_LIFECYCLES = frozenset(("GATING", "SHADOW", "QUARANTINED", "RETIRED"))
17
+ _KNOWN_ASSESSMENTS = frozenset(
18
+ ("PENDING", "RUNNING", "COMPLETED", "INCOMPLETE", "FAILED", "STOPPED", "SUPERSEDED", "EXCLUDED")
19
+ )
20
+ _WITHHELD_MARKER = "[withheld: environment value]"
17
21
 
18
22
 
19
23
  @dataclass(frozen=True)
@@ -29,7 +33,7 @@ class CheckGap:
29
33
  class AssessmentGap:
30
34
  assessment_id: UUID | None
31
35
  status: str
32
- reason_codes: tuple[str, ...] = ()
36
+ reason_codes: tuple[str, ...] = field(default=(), repr=False)
33
37
  incompleteness_kind: str | None = None
34
38
  release_evidence_gap: str | None = field(default=None, repr=False)
35
39
  checks: tuple[CheckGap, ...] = field(default=(), repr=False)
@@ -75,6 +79,14 @@ def _code_assessment(review: CustomerReviewDetail) -> CustomerCodeAssessment | N
75
79
  or not _optional_text(code.incompleteness_kind)
76
80
  ):
77
81
  return None
82
+ for recorded, actual in (
83
+ (review.head_commit_sha, code.head_commit_sha),
84
+ (review.base_commit_sha, code.base_commit_sha),
85
+ ):
86
+ if isinstance(recorded, str) and recorded.lower() != actual.lower():
87
+ return None
88
+ if any(finding.risk_domain == _WITHHELD_MARKER for finding in code.findings):
89
+ return None
78
90
  return code
79
91
 
80
92
 
@@ -143,18 +155,20 @@ def outcome(
143
155
  AssessmentGap(
144
156
  code.id,
145
157
  code.status,
146
- () if kind else ("CODE_ASSESSMENT_STATE_UNAVAILABLE",),
158
+ (kind,) if kind else ("CODE_ASSESSMENT_STATE_UNAVAILABLE",),
147
159
  kind,
148
160
  )
149
161
  )
150
- elif review.assessment_count != len(review.assessments):
151
- gaps.append(AssessmentGap(None, "UNKNOWN", ("ASSESSMENT_HISTORY_UNAVAILABLE",)))
152
162
  for assessment in review.assessments:
153
163
  reasons = (
154
164
  tuple(assessment.reason_codes) if isinstance(assessment.reason_codes, list) else ()
155
165
  )
156
166
  kind = text(assessment.incompleteness_kind)
157
167
  evidence = text(assessment.release_evidence_gap)
168
+ if kind:
169
+ reasons = (*reasons, kind)
170
+ if evidence:
171
+ reasons = (*reasons, evidence)
158
172
  checks = tuple(
159
173
  CheckGap(
160
174
  check.name,
@@ -166,17 +180,22 @@ def outcome(
166
180
  for check in assessment.checks.families
167
181
  if check.outcome not in COMPLETE_CHECKS or check.lifecycle not in COMPLETE_LIFECYCLES
168
182
  )
169
- if (
170
- not assessment.checks.receipt_recorded
171
- or assessment.checks.status not in COMPLETE_CHECKS
172
- ):
173
- reasons = (*reasons, "CHECK_RECEIPT_UNAVAILABLE")
183
+ if not assessment.checks.receipt_recorded:
184
+ reasons = (*reasons, "CHECK_RECEIPT_ABSENT")
185
+ elif assessment.checks.status not in COMPLETE_CHECKS or checks:
186
+ reasons = (*reasons, "CHECKS_UNRESOLVED")
174
187
  if assessment.status != "COMPLETED" or reasons or kind or evidence or checks:
175
188
  if not reasons and not kind and not evidence and not checks:
176
- reasons = ("ASSESSMENT_STATE_UNAVAILABLE",)
189
+ reasons = (
190
+ "ASSESSMENT_RESULT_UNAVAILABLE"
191
+ if assessment.status in _KNOWN_ASSESSMENTS
192
+ else "UNKNOWN_ASSESSMENT_STATUS",
193
+ )
177
194
  gaps.append(
178
195
  AssessmentGap(assessment.id, assessment.status, reasons, kind, evidence, checks)
179
196
  )
197
+ if review.assessment_count != len(review.assessments):
198
+ gaps.append(AssessmentGap(None, "UNKNOWN", ("ASSESSMENT_HISTORY_UNAVAILABLE",)))
180
199
  if forced is not None:
181
200
  status = forced
182
201
  elif review.status in ("PENDING", "RUNNING"):
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "proofline-sdk"
7
- version = "3.2.1"
7
+ version = "3.3.1"
8
8
  description = "Typed synchronous and asynchronous clients for the Proofline review API"
9
9
  readme = "README.md"
10
10
  license = "Apache-2.0 AND MIT"
@@ -9,16 +9,18 @@ import sys
9
9
  import threading
10
10
  from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
11
11
  from pathlib import Path
12
+ from urllib.parse import parse_qs, urlsplit
12
13
  from uuid import UUID
13
14
 
14
15
  import proofline
15
- from proofline import AsyncProoflineClient, ProoflineClient, SecretStr
16
+ from proofline import AsyncProoflineClient, ProoflineClient, ReviewFilters, SecretStr
16
17
 
17
18
  ORG = UUID("00000000-0000-4000-8000-000000000001")
18
19
  REVIEW = UUID("00000000-0000-4000-8000-000000000002")
19
20
  ASSESSMENT = UUID("00000000-0000-4000-8000-000000000003")
20
21
  FINDING = UUID("00000000-0000-4000-8000-000000000004")
21
22
  TOKEN = "pln_synthetic_installed_package_token"
23
+ QUERY = '(status:COMPLETED OR status:FAILED) AND -author:"release bot"'
22
24
 
23
25
 
24
26
  def main() -> None:
@@ -27,6 +29,7 @@ def main() -> None:
27
29
  package_version = importlib.metadata.version("proofline-sdk")
28
30
  assert proofline.__version__ == package_version
29
31
  calls: list[str] = []
32
+ filters: ReviewFilters = {"query": QUERY}
30
33
  finding = {
31
34
  "id": str(FINDING),
32
35
  "severity": "HIGH",
@@ -82,6 +85,18 @@ def main() -> None:
82
85
  assert self.headers["User-Agent"] == f"proofline-python/{package_version}"
83
86
  calls.append(self.path)
84
87
  body = finding if "/findings/" in self.path else review
88
+ path = urlsplit(self.path)
89
+ if path.path in (
90
+ f"/api/v1/organizations/{ORG}/reviews",
91
+ f"/api/v1/organizations/{ORG}/reviews/pr/repo%2Fname/42",
92
+ ):
93
+ assert parse_qs(path.query)["query"] == [QUERY]
94
+ assert "search" not in parse_qs(path.query)
95
+ body = {
96
+ "filters": {"repositories": [], "environments": [], "authors": []},
97
+ "items": [],
98
+ "truncated": False,
99
+ }
85
100
  payload = json.dumps(body).encode()
86
101
  self.send_response(200)
87
102
  self.send_header("Content-Type", "application/json")
@@ -96,6 +111,10 @@ def main() -> None:
96
111
 
97
112
  async def asynchronous() -> None:
98
113
  async with AsyncProoflineClient(SecretStr(TOKEN), base_url=url) as client:
114
+ assert (await client.list_reviews(ORG, query=QUERY)).items == []
115
+ history = await client.list_pull_request_reviews(ORG, "repo/name", 42, filters=filters)
116
+ assert history.items == []
117
+ assert [item async for item in client.iter_reviews(ORG, filters=filters)] == []
99
118
  assert (await client.get_finding(ORG, FINDING)).id == FINDING
100
119
  result = await client.wait_for_review(ORG, REVIEW, timeout=2)
101
120
  assert result.status == "INCOMPLETE"
@@ -104,13 +123,17 @@ def main() -> None:
104
123
 
105
124
  try:
106
125
  with ProoflineClient(SecretStr(TOKEN), base_url=url) as client:
126
+ assert client.list_reviews(ORG, query=QUERY).items == []
127
+ history = client.list_pull_request_reviews(ORG, "repo/name", 42, filters=filters)
128
+ assert history.items == []
129
+ assert list(client.iter_reviews(ORG, filters=filters)) == []
107
130
  assert client.get_finding(ORG, FINDING).id == FINDING
108
131
  result = client.wait_for_review(ORG, REVIEW, timeout=2)
109
132
  assert result.status == "INCOMPLETE"
110
133
  assert result.gaps[0].reason_codes[0] == "WORLD_UNAVAILABLE"
111
134
  assert TOKEN not in repr(client)
112
135
  asyncio.run(asynchronous())
113
- assert len(calls) == 4
136
+ assert len(calls) == 10
114
137
  finally:
115
138
  server.shutdown()
116
139
  server.server_close()