@josephyan/qingflow-app-user-mcp 1.1.30 → 1.1.31

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-user-mcp@1.1.30
+npm install @josephyan/qingflow-app-user-mcp@1.1.31
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-user-mcp@1.1.30 qingflow-app-user-mcp
+npx -y -p @josephyan/qingflow-app-user-mcp@1.1.31 qingflow-app-user-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-user-mcp",
-  "version": "1.1.30",
+  "version": "1.1.31",
   "description": "Operational end-user MCP for Qingflow records, tasks, comments, and directory workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "1.1.30"
+version = "1.1.31"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/builder_facade/models.py

@@ -1092,6 +1092,7 @@ class ViewUpsertPatch(StrictModel):
     columns: list[str] = Field(default_factory=list)
     group_by: str | None = None
     filters: list[ViewFilterRulePatch] = Field(default_factory=list)
+    filter_groups: list[list[ViewFilterRulePatch]] = Field(default_factory=list, validation_alias=AliasChoices("filter_groups", "filterGroups", "or_filters", "orFilters"))
     start_field: str | None = Field(default=None, validation_alias=AliasChoices("start_field", "startField"))
     end_field: str | None = Field(default=None, validation_alias=AliasChoices("end_field", "endField"))
     title_field: str | None = Field(default=None, validation_alias=AliasChoices("title_field", "titleField"))
@@ -1131,6 +1132,12 @@ class ViewUpsertPatch(StrictModel):
             payload["filters"] = payload.pop("filter_rules")
         if "filterRules" in payload and "filters" not in payload:
             payload["filters"] = payload.pop("filterRules")
+        if "filterGroups" in payload and "filter_groups" not in payload:
+            payload["filter_groups"] = payload.pop("filterGroups")
+        if "or_filters" in payload and "filter_groups" not in payload:
+            payload["filter_groups"] = payload.pop("or_filters")
+        if "orFilters" in payload and "filter_groups" not in payload:
+            payload["filter_groups"] = payload.pop("orFilters")
         if "queryConditions" in payload and "query_conditions" not in payload:
             payload["query_conditions"] = payload.pop("queryConditions")
         if "query_condition" in payload and "query_conditions" not in payload:

package/src/qingflow_mcp/builder_facade/service.py

@@ -7181,7 +7181,11 @@ class AiBuilderFacade:
                 missing_gantt_fields = [name for name in (start_field, end_field, title_field) if name and name not in field_names]
                 if missing_gantt_fields:
                     blocking_issues.append({"error_code": "UNKNOWN_VIEW_FIELD", "view_name": patch.get("name"), "missing_fields": missing_gantt_fields})
-            translated_filters, filter_issues = _build_view_filter_groups(current_fields_by_name=current_fields_by_name, filters=patch.get("filters") or [])
+            translated_filters, filter_issues = _build_view_filter_groups(
+                current_fields_by_name=current_fields_by_name,
+                filters=patch.get("filters") or [],
+                filter_groups=patch.get("filter_groups") or [],
+            )
             if filter_issues:
                 blocking_issues.extend(
                     {
@@ -8924,7 +8928,11 @@ class AiBuilderFacade:
                 translated_filters = None
                 filter_issues = []
             else:
-                translated_filters, filter_issues = _build_view_filter_groups(current_fields_by_name=current_fields_by_name, filters=patch.filters)
+                translated_filters, filter_issues = _build_view_filter_groups(
+                    current_fields_by_name=current_fields_by_name,
+                    filters=patch.filters,
+                    filter_groups=patch.filter_groups,
+                )
             if filter_issues:
                 first_issue = filter_issues[0]
                 return _failed(
@@ -24069,31 +24077,51 @@ def _build_view_filter_groups(
     *,
     current_fields_by_name: dict[str, dict[str, Any]],
     filters: list[Any],
+    filter_groups: list[list[Any]] | None = None,
 ) -> tuple[list[list[dict[str, Any]]], list[dict[str, Any]]]:
-    translated_rules: list[dict[str, Any]] = []
     issues: list[dict[str, Any]] = []
-    for raw_rule in filters:
-        if hasattr(raw_rule, "model_dump"):
-            raw_rule = raw_rule.model_dump(mode="json")
-        if not isinstance(raw_rule, dict):
-            continue
-        field_name = str(raw_rule.get("field_name") or "").strip()
-        field = current_fields_by_name.get(field_name)
-        if field is None:
+    raw_groups: list[list[Any]] = []
+    if filters:
+        raw_groups.append(list(filters))
+    for raw_group in filter_groups or []:
+        if not isinstance(raw_group, list):
             issues.append(
                 {
-                    "error_code": "UNKNOWN_VIEW_FIELD",
-                    "missing_fields": [field_name] if field_name else [],
-                    "reason_path": "filters[].field_name",
+                    "error_code": "INVALID_VIEW_FILTER_GROUP",
+                    "reason_path": "filter_groups[]",
+                    "message": "filter_groups must be a list of filter rule lists",
                 }
             )
             continue
-        translated_rule, issue = _translate_view_filter_rule(field=field, rule=raw_rule)
-        if issue:
-            issues.append(issue)
-            continue
-        translated_rules.append(translated_rule)
-    return ([translated_rules] if translated_rules else []), issues
+        raw_groups.append(raw_group)
+
+    translated_groups: list[list[dict[str, Any]]] = []
+    for group_index, raw_group in enumerate(raw_groups):
+        translated_rules: list[dict[str, Any]] = []
+        for raw_rule in raw_group:
+            if hasattr(raw_rule, "model_dump"):
+                raw_rule = raw_rule.model_dump(mode="json")
+            if not isinstance(raw_rule, dict):
+                continue
+            field_name = str(raw_rule.get("field_name") or "").strip()
+            field = current_fields_by_name.get(field_name)
+            if field is None:
+                issues.append(
+                    {
+                        "error_code": "UNKNOWN_VIEW_FIELD",
+                        "missing_fields": [field_name] if field_name else [],
+                        "reason_path": f"filter_groups[{group_index}].field_name" if filter_groups else "filters[].field_name",
+                    }
+                )
+                continue
+            translated_rule, issue = _translate_view_filter_rule(field=field, rule=raw_rule)
+            if issue:
+                issues.append(issue)
+                continue
+            translated_rules.append(translated_rule)
+        if translated_rules:
+            translated_groups.append(translated_rules)
+    return translated_groups, issues
 
 
 def _translate_view_filter_rule(*, field: dict[str, Any], rule: dict[str, Any]) -> tuple[dict[str, Any], dict[str, Any] | None]:

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -5763,6 +5763,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "upsert_views[].type",
             "upsert_views[].columns",
             "upsert_views[].filters",
+            "upsert_views[].filter_groups",
             "upsert_views[].buttons",
             "upsert_views[].visibility",
             "upsert_views[].query_conditions",
@@ -5781,6 +5782,9 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "kanban": "board",
             "filter_rules": "filters",
             "filterRules": "filters",
+            "filterGroups": "filter_groups",
+            "or_filters": "filter_groups",
+            "orFilters": "filter_groups",
             "queryConditions": "query_conditions",
             "query_condition": "query_conditions",
             "queryCondition": "query_conditions",
@@ -5807,7 +5811,8 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
         },
         "execution_notes": [
             "upsert_views[].visibility may set per-view visibility; omit it to preserve an existing view's auth or default a new view to workspace/not",
-            "filters are saved fixed filters that apply when the view opens; query_conditions configure the frontend query panel and only apply after a user enters query values",
+            "filters are saved fixed filters that apply when the view opens; filters is one AND group, filter_groups is OR across groups with AND inside each group",
+            "query_conditions configure the frontend query panel and only apply after a user enters query values",
             "upsert_views[].query_conditions.rows is a layout matrix of field names; it is compiled to backend queryCondition queIds",
             "use patch_views for partial parameter replacement on existing views; the tool reads current config, merges patch_views[].set/unset, then submits the backend full-save payload internally",
             "remove_views accepts a raw view_key or an exact unique view name; after DELETE the tool verifies deletion by single view_key readback, not by a full app view list",
@@ -5891,6 +5896,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "views[].type",
             "views[].columns",
             "views[].filters",
+            "views[].filter_groups",
             "views[].query_conditions",
             "views[].visibility",
             "views[].set",
@@ -5908,6 +5914,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "upsert_views[].type",
             "upsert_views[].columns",
             "upsert_views[].filters",
+            "upsert_views[].filter_groups",
             "upsert_views[].buttons",
             "upsert_views[].visibility",
             "upsert_views[].query_conditions",
@@ -5926,6 +5933,9 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "kanban": "board",
             "filter_rules": "filters",
             "filterRules": "filters",
+            "filterGroups": "filter_groups",
+            "or_filters": "filter_groups",
+            "orFilters": "filter_groups",
             "queryConditions": "query_conditions",
             "query_condition": "query_conditions",
             "queryCondition": "query_conditions",
@@ -5968,7 +5978,8 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "views[].action_buttons are applied after the target view_key is resolved; action_buttons require publish=true because the button writer publishes button configuration",
             "buttons omitted preserves existing button config; buttons=[] clears all buttons; buttons=[...] replaces the full button config",
             "upsert_views[].visibility may set per-view visibility; omit it to preserve an existing view's auth or default a new view to workspace/not",
-            "filters are saved fixed filters that apply when the view opens; query_conditions configure the frontend query panel and only apply after a user enters query values",
+            "filters are saved fixed filters that apply when the view opens; filters is one AND group, filter_groups is OR across groups with AND inside each group",
+            "query_conditions configure the frontend query panel and only apply after a user enters query values",
             "upsert_views[].query_conditions.rows is a layout matrix of field names; it is compiled to backend queryCondition queIds",
             "use patch_views for partial parameter replacement on existing views; the public update mode is patch even though the backend save is still a full view payload",
             "remove_views accepts a raw view_key or an exact unique view name; after DELETE the tool verifies deletion by single view_key readback, not by a full app view list",