feat(filter): :state accepts a list of state names

I made :state polymorphic, mirroring :state-type. A string still compiles to state.name.eq. A list now compiles to state.name.in, so (:state ("Todo" "In Review")) matches issues in either state. The reverse-compile inverts state.name.in back to a scalar (one name) or a list (several), so copy-down no longer refuses a Linear view filtering on a set of named states. The validator accepts a string or a list of non-empty names, the same shape it already enforces for :labels, and a list-valued :state keeps its precedence over :state-type and :open.

Phase 1 of docs/multi-state-filter-spec.org. Suite, compile, and lint green.

1 files changed, 26 insertions, 0 deletions

diff --git a/tests/test-pearl-filter.el b/tests/test-pearl-filter.el
index 38d254e..d3fca88 100644
--- a/tests/test-pearl-filter.el
+++ b/tests/test-pearl-filter.el
@@ -83,6 +83,16 @@
   (should (equal (pearl--build-issue-filter '(:state-type "started"))
                  '(("state" ("type" ("in" . ["started"])))))))
 
+(ert-deftest test-pearl-filter-state-name-list ()
+  ":state with a list of names compiles to state.name.in."
+  (should (equal (pearl--build-issue-filter '(:state ("Todo" "In Review")))
+                 '(("state" ("name" ("in" . ["Todo" "In Review"])))))))
+
+(ert-deftest test-pearl-filter-state-list-beats-open ()
+  "A list-valued :state keeps precedence over :open."
+  (should (equal (pearl--build-issue-filter '(:state ("Todo" "Done") :open t))
+                 '(("state" ("name" ("in" . ["Todo" "Done"])))))))
+
 (ert-deftest test-pearl-filter-project-team-cycle ()
   ":project / :cycle compile to id.eq; :team to key.eq."
   (should (equal (pearl--build-issue-filter '(:project "p-1"))
@@ -189,6 +199,22 @@
   "A non-string entry in :labels is a user-error."
   (should-error (pearl--validate-issue-filter '(:labels ("bug" 7))) :type 'user-error))
 
+(ert-deftest test-pearl-filter-validate-accepts-state-list ()
+  "A :state list of non-empty names validates."
+  (should (eq t (pearl--validate-issue-filter '(:state ("Todo" "In Review"))))))
+
+(ert-deftest test-pearl-filter-validate-accepts-state-string ()
+  "A single-string :state still validates."
+  (should (eq t (pearl--validate-issue-filter '(:state "In Progress")))))
+
+(ert-deftest test-pearl-filter-validate-rejects-empty-name-in-state-list ()
+  "An empty name anywhere in a :state list is a user-error."
+  (should-error (pearl--validate-issue-filter '(:state ("" "Todo"))) :type 'user-error))
+
+(ert-deftest test-pearl-filter-validate-rejects-empty-state-string ()
+  "An empty single :state string is a user-error."
+  (should-error (pearl--validate-issue-filter '(:state "")) :type 'user-error))
+
 ;;; id-based forms (rename-proof; used by favorite-derived filter sources)
 
 (ert-deftest test-pearl-filter-assignee-id ()