From f1a6a7eb96c701ff8e2b940798547a55d1906056 Mon Sep 17 00:00:00 2001
From: Atsushi Matsuo <famlog@gmail.com>
Date: Sat, 14 Feb 2026 19:40:39 +0900
Subject: [PATCH 1/3] Add psalm.xml and psalm.yml for GitHub Actions

---
 .github/workflows/psalm.yml | 21 +++++++++++++++++++++
 psalm.xml                   | 18 ++++++++++++++++++
 2 files changed, 39 insertions(+)
 create mode 100644 .github/workflows/psalm.yml
 create mode 100644 psalm.xml

diff --git a/.github/workflows/psalm.yml b/.github/workflows/psalm.yml
new file mode 100644
index 0000000..31aba0f
--- /dev/null
+++ b/.github/workflows/psalm.yml
@@ -0,0 +1,21 @@
+name: Psalm
+
+permissions:
+  contents: read
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  run:
+    name: Run Psalm
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Run Psalm
+        uses: docker://ghcr.io/psalm/psalm-github-actions:6.14.3
+        with:
+          security_analysis: true
diff --git a/psalm.xml b/psalm.xml
new file mode 100644
index 0000000..eb6a1e5
--- /dev/null
+++ b/psalm.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0"?>
+<psalm
+    errorLevel="7"
+    resolveFromConfigFile="true"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns="https://getpsalm.org/schema/config"
+    xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
+    findUnusedBaselineEntry="true"
+    findUnusedCode="false"
+    ensureOverrideAttribute="false"
+>
+    <projectFiles>
+        <directory name="src" />
+        <ignoreFiles>
+            <directory name="vendor" />
+        </ignoreFiles>
+    </projectFiles>
+</psalm>

From dd4d6f6f2242f854ef9b2de21fc5b2769d3460da Mon Sep 17 00:00:00 2001
From: Atsushi Matsuo <famlog@gmail.com>
Date: Sat, 14 Feb 2026 20:29:21 +0900
Subject: [PATCH 2/3] Add `@implements` annotation to FileMakerRelation class
 for Psalm

---
 src/Supporting/FileMakerRelation.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Supporting/FileMakerRelation.php b/src/Supporting/FileMakerRelation.php
index 140d810..02f1295 100644
--- a/src/Supporting/FileMakerRelation.php
+++ b/src/Supporting/FileMakerRelation.php
@@ -11,6 +11,7 @@
  * and you shouldn't call the constructor of this class.
  *
  * @package INTER-Mediator\FileMakerServer\RESTAPI
+ * @implements Iterator<int, mixed>
  * @link https://github.com/msyk/FMDataAPI GitHub Repository
  * @property string $fieldName The field value named as the property name accessed via __get().
  * @property FileMakerRelation $portalName A FileMakerRelation object associated with the property name accessed via __get().

From 14c60b7927ce755b48caf553f3bf8c77cea3d4fd Mon Sep 17 00:00:00 2001
From: Atsushi Matsuo <famlog@gmail.com>
Date: Sat, 14 Feb 2026 20:38:36 +0900
Subject: [PATCH 3/3] Modify psalm.yml for GitHub Actions

---
 .github/workflows/psalm.yml | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/psalm.yml b/.github/workflows/psalm.yml
index 31aba0f..9b08a74 100644
--- a/.github/workflows/psalm.yml
+++ b/.github/workflows/psalm.yml
@@ -15,7 +15,11 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
+      - name: Setup PHP
+        uses: ./.github/actions/setup-php
+
+      - name: Install Psalm
+        run: composer require --dev vimeo/psalm:6.15.1
+
       - name: Run Psalm
-        uses: docker://ghcr.io/psalm/psalm-github-actions:6.14.3
-        with:
-          security_analysis: true
+        run: ./vendor/bin/psalm --no-cache