@josephyan/qingflow-cli 0.2.0-beta.74 → 0.2.0-beta.76

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-cli@0.2.0-beta.74
+npm install @josephyan/qingflow-cli@0.2.0-beta.76
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-cli@0.2.0-beta.74 qingflow
+npx -y -p @josephyan/qingflow-cli@0.2.0-beta.76 qingflow
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-cli",
-  "version": "0.2.0-beta.74",
+  "version": "0.2.0-beta.76",
   "description": "Human-friendly Qingflow command line interface for auth, record operations, import, tasks, and stable builder flows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

package/src/qingflow_mcp/builder_facade/models.py

@@ -35,6 +35,11 @@ class PublicRelationMode(str, Enum):
     multiple = "multiple"
 
 
+class PublicDepartmentScopeMode(str, Enum):
+    all = "all"
+    custom = "custom"
+
+
 FIELD_TYPE_ALIASES: dict[str, PublicFieldType] = {
     "textarea": PublicFieldType.long_text,
     "amount": PublicFieldType.amount,
@@ -291,6 +296,56 @@ class FieldSelector(StrictModel):
         return self
 
 
+class DepartmentSelectorPatch(StrictModel):
+    dept_id: int | None = Field(default=None, validation_alias=AliasChoices("dept_id", "deptId", "id"))
+    dept_name: str | None = Field(default=None, validation_alias=AliasChoices("dept_name", "deptName", "name", "value"))
+
+    @model_validator(mode="after")
+    def validate_selector(self) -> "DepartmentSelectorPatch":
+        if self.dept_id is None and not str(self.dept_name or "").strip():
+            raise ValueError("department selector must include dept_id or dept_name")
+        return self
+
+
+class DepartmentScopePatch(StrictModel):
+    mode: PublicDepartmentScopeMode | None = None
+    departments: list[DepartmentSelectorPatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("departments", "departs", "depart"),
+    )
+    include_sub_departs: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("include_sub_departs", "includeSubDeparts"),
+    )
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "depart" in payload and "departments" not in payload:
+            payload["departments"] = payload.pop("depart")
+        if "departs" in payload and "departments" not in payload:
+            payload["departments"] = payload.pop("departs")
+        normalized_mode = _normalize_public_department_scope_mode(payload.get("mode"))
+        if normalized_mode is None:
+            if "departments" in payload:
+                normalized_mode = PublicDepartmentScopeMode.custom.value
+            else:
+                normalized_mode = PublicDepartmentScopeMode.all.value
+        payload["mode"] = normalized_mode
+        return payload
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "DepartmentScopePatch":
+        if self.mode == PublicDepartmentScopeMode.custom and not self.departments:
+            raise ValueError("custom department scope requires departments")
+        if self.mode == PublicDepartmentScopeMode.custom and any(item.dept_id is None for item in self.departments):
+            raise ValueError("custom department scope requires departments[].dept_id")
+        return self
+
+
 class CodeBlockAliasPathPatch(StrictModel):
     alias_name: str = Field(validation_alias=AliasChoices("alias_name", "aliasName"))
     alias_path: str = Field(validation_alias=AliasChoices("alias_path", "aliasPath"))
@@ -555,6 +610,10 @@ class FieldPatch(StrictModel):
     display_field: FieldSelector | None = None
     visible_fields: list[FieldSelector] = Field(default_factory=list)
     relation_mode: PublicRelationMode | None = Field(default=None, validation_alias=AliasChoices("relation_mode", "relationMode", "selection_mode", "selectionMode"))
+    department_scope: DepartmentScopePatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("department_scope", "departmentScope"),
+    )
     remote_lookup_config: RemoteLookupConfigPatch | None = Field(
         default=None,
         validation_alias=AliasChoices("remote_lookup_config", "remoteLookupConfig"),
@@ -586,10 +645,16 @@ class FieldPatch(StrictModel):
     def validate_shape(self) -> "FieldPatch":
         if self.type == PublicFieldType.relation and not self.target_app_key:
             raise ValueError("relation field requires target_app_key")
+        if self.type == PublicFieldType.relation and self.display_field is None:
+            raise ValueError("relation field requires display_field")
+        if self.type == PublicFieldType.relation and not self.visible_fields:
+            raise ValueError("relation field requires visible_fields")
         if self.type != PublicFieldType.relation and self.target_app_key:
             raise ValueError("target_app_key is only allowed for relation fields")
         if self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields or self.relation_mode is not None):
             raise ValueError("display_field, visible_fields, and relation_mode are only allowed for relation fields")
+        if self.type != PublicFieldType.department and self.department_scope is not None:
+            raise ValueError("department_scope is only allowed for department fields")
         if self.type != PublicFieldType.q_linker and (
             self.remote_lookup_config is not None
             or self.q_linker_binding is not None
@@ -625,6 +690,10 @@ class FieldMutation(StrictModel):
     display_field: FieldSelector | None = None
     visible_fields: list[FieldSelector] | None = None
     relation_mode: PublicRelationMode | None = Field(default=None, validation_alias=AliasChoices("relation_mode", "relationMode", "selection_mode", "selectionMode"))
+    department_scope: DepartmentScopePatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("department_scope", "departmentScope"),
+    )
     remote_lookup_config: RemoteLookupConfigPatch | None = Field(
         default=None,
         validation_alias=AliasChoices("remote_lookup_config", "remoteLookupConfig"),
@@ -656,8 +725,17 @@ class FieldMutation(StrictModel):
     def validate_shape(self) -> "FieldMutation":
         if self.type == PublicFieldType.relation and not self.target_app_key:
             raise ValueError("relation field requires target_app_key")
+        relation_patch = (
+            self.type == PublicFieldType.relation
+            or self.target_app_key is not None
+            or self.display_field is not None
+            or self.visible_fields is not None
+            or self.relation_mode is not None
+        )
         if self.type is not None and self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields or self.relation_mode is not None):
             raise ValueError("display_field, visible_fields, and relation_mode are only allowed for relation fields")
+        if self.type is not None and self.type != PublicFieldType.department and self.department_scope is not None:
+            raise ValueError("department_scope is only allowed for department fields")
         if self.type is not None and self.type != PublicFieldType.q_linker and (
             self.remote_lookup_config is not None
             or self.q_linker_binding is not None
@@ -981,6 +1059,17 @@ class CustomButtonWingsConfigPatch(StrictModel):
         return payload
 
 
+def _is_white_button_color(value: str | None) -> bool:
+    normalized = str(value or "").strip().lower().replace(" ", "")
+    return normalized in {
+        "#fff",
+        "#ffffff",
+        "white",
+        "rgb(255,255,255)",
+        "rgba(255,255,255,1)",
+    }
+
+
 class CustomButtonPatch(StrictModel):
     button_text: str = Field(validation_alias=AliasChoices("button_text", "buttonText"))
     background_color: str = Field(validation_alias=AliasChoices("background_color", "backgroundColor"))
@@ -1017,6 +1106,8 @@ class CustomButtonPatch(StrictModel):
             raise ValueError("qRobot buttons require external_qrobot_config")
         if self.trigger_action == PublicButtonTriggerAction.wings and self.trigger_wings_config is None:
             raise ValueError("wings buttons require trigger_wings_config")
+        if _is_white_button_color(self.background_color) and _is_white_button_color(self.text_color):
+            raise ValueError("background_color and text_color cannot both be white")
         return self
 
 
@@ -1079,6 +1170,8 @@ class ViewButtonBindingPatch(StrictModel):
             ]
             if missing:
                 raise ValueError(f"system button bindings require {', '.join(missing)}")
+        if _is_white_button_color(self.background_color) and _is_white_button_color(self.text_color):
+            raise ValueError("background_color and text_color cannot both be white")
         return self
 
 
@@ -1599,6 +1692,34 @@ def _normalize_public_relation_mode(value: Any) -> str | None:
     return None
 
 
+def _normalize_public_department_scope_mode(value: Any) -> str | None:
+    if value is None:
+        return None
+    if isinstance(value, int):
+        if value == 1:
+            return PublicDepartmentScopeMode.all.value
+        if value == 2:
+            return PublicDepartmentScopeMode.custom.value
+        return None
+    if isinstance(value, str):
+        normalized = value.strip().lower()
+        aliases = {
+            "all": PublicDepartmentScopeMode.all.value,
+            "workspace_all": PublicDepartmentScopeMode.all.value,
+            "workspace-all": PublicDepartmentScopeMode.all.value,
+            "default": PublicDepartmentScopeMode.all.value,
+            "default_all": PublicDepartmentScopeMode.all.value,
+            "default-all": PublicDepartmentScopeMode.all.value,
+            "1": PublicDepartmentScopeMode.all.value,
+            "custom": PublicDepartmentScopeMode.custom.value,
+            "explicit": PublicDepartmentScopeMode.custom.value,
+            "selected": PublicDepartmentScopeMode.custom.value,
+            "2": PublicDepartmentScopeMode.custom.value,
+        }
+        return aliases.get(normalized, normalized or None)
+    return None
+
+
 CustomButtonMatchRulePatch.model_rebuild()
 CustomButtonAddDataConfigPatch.model_rebuild()
 CodeBlockAliasPathPatch.model_rebuild()