Add docblocks for Psalm annotations

Author: kberzinch

app/Exceptions/QuickBooksFault.php

@@ -11,6 +11,8 @@ class QuickBooksFault extends Exception
 {
     /**
      * Construct a new instance.
+     *
+     * @psalm-mutation-free
      */
     public function __construct(IPPFault $fault)
     {

app/HorizonHealthCheck.php

@@ -22,6 +22,11 @@ class HorizonHealthCheck extends HealthCheck
      */
     protected string $name = 'horizon';
 
+    /**
+     * Construct a new instance of this health check
+     *
+     * @psalm-mutation-free
+     */
     public function __construct(private readonly MasterSupervisorRepository $supervisorRepository)
     {
     }

app/Http/Controllers/EngagePurchaseRequestController.php

@@ -109,6 +109,11 @@ public function update(EngagePurchaseRequest $purchaseRequest, UpdateEngagePurch
         return response()->json($purchaseRequest);
     }
 
+    /**
+     * Simplify the finance stage name.
+     *
+     * @psalm-pure
+     */
     private static function cleanFinanceStageName(string $input): string
     {
         if (str_contains($input, ':')) {

app/Http/Requests/UpdateEngagePurchaseRequest.php

@@ -10,6 +10,8 @@ class UpdateEngagePurchaseRequest extends FormRequest
 {
     /**
      * Determine if the user is authorized to make this request.
+     *
+     * @psalm-pure
      */
     public function authorize(): true
     {
@@ -20,6 +22,8 @@ public function authorize(): true
      * Get the validation rules that apply to the request.
      *
      * @return array<string, array<string>>
+     *
+     * @psalm-pure
      */
     public function rules(): array
     {

app/Http/Requests/UpdateExpenseReport.php

@@ -10,6 +10,8 @@ class UpdateExpenseReport extends FormRequest
 {
     /**
      * Determine if the user is authorized to make this request.
+     *
+     * @psalm-pure
      */
     public function authorize(): true
     {
@@ -20,6 +22,8 @@ public function authorize(): true
      * Get the validation rules that apply to the request.
      *
      * @return array<string, array<string>>
+     *
+     * @psalm-pure
      */
     public function rules(): array
     {

app/Http/Requests/UpdateExpenseReportLine.php

@@ -10,6 +10,8 @@ class UpdateExpenseReportLine extends FormRequest
 {
     /**
      * Determine if the user is authorized to make this request.
+     *
+     * @psalm-pure
      */
     public function authorize(): true
     {
@@ -20,6 +22,8 @@ public function authorize(): true
      * Get the validation rules that apply to the request.
      *
      * @return array<string, array<string>>
+     *
+     * @psalm-pure
      */
     public function rules(): array
     {

app/Http/Requests/UploadEngageAttachment.php

@@ -10,6 +10,8 @@ class UploadEngageAttachment extends FormRequest
 {
     /**
      * Determine if the user is authorized to make this request.
+     *
+     * @psalm-pure
      */
     public function authorize(): true
     {
@@ -20,6 +22,8 @@ public function authorize(): true
      * Get the validation rules that apply to the request.
      *
      * @return array<string, array<string>>
+     *
+     * @psalm-pure
      */
     public function rules(): array
     {

app/Http/Requests/UploadWorkdayAttachment.php

@@ -10,6 +10,8 @@ class UploadWorkdayAttachment extends FormRequest
 {
     /**
      * Determine if the user is authorized to make this request.
+     *
+     * @psalm-pure
      */
     public function authorize(): true
     {
@@ -20,6 +22,8 @@ public function authorize(): true
      * Get the validation rules that apply to the request.
      *
      * @return array<string, array<string>>
+     *
+     * @psalm-pure
      */
     public function rules(): array
     {

app/Http/Requests/UpsertEngagePurchaseRequests.php

@@ -10,6 +10,8 @@ class UpsertEngagePurchaseRequests extends FormRequest
 {
     /**
      * Determine if the user is authorized to make this request.
+     *
+     * @psalm-pure
      */
     public function authorize(): true
     {
@@ -20,6 +22,8 @@ public function authorize(): true
      * Get the validation rules that apply to the request.
      *
      * @return array<string, array<string>>
+     *
+     * @psalm-pure
      */
     public function rules(): array
     {

app/Http/Requests/UpsertExpenseReports.php

@@ -10,6 +10,8 @@ class UpsertExpenseReports extends FormRequest
 {
     /**
      * Determine if the user is authorized to make this request.
+     *
+     * @psalm-pure
      */
     public function authorize(): true
     {
@@ -20,6 +22,8 @@ public function authorize(): true
      * Get the validation rules that apply to the request.
      *
      * @return array<string, array<string>>
+     *
+     * @psalm-pure
      */
     public function rules(): array
     {