@josephyan/qingflow-app-builder-mcp 0.1.0-beta.13 → 0.1.0-beta.15

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-builder-mcp@0.1.0-beta.13
+npm install @josephyan/qingflow-app-builder-mcp@0.1.0-beta.15
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-builder-mcp@0.1.0-beta.13 qingflow-app-builder-mcp
+npx -y -p @josephyan/qingflow-app-builder-mcp@0.1.0-beta.15 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-builder-mcp",
-  "version": "0.1.0-beta.13",
+  "version": "0.1.0-beta.15",
   "description": "Builder MCP for Qingflow app/package/system design and staged solution workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

package/src/qingflow_mcp/__init__.py

@@ -2,4 +2,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.0b13"
+__version__ = "0.1.0b15"

package/src/qingflow_mcp/builder_facade/__init__.py

@@ -0,0 +1,3 @@
+from .service import AiBuilderFacade
+
+__all__ = ["AiBuilderFacade"]

package/src/qingflow_mcp/builder_facade/models.py

@@ -0,0 +1,156 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import Any
+
+from pydantic import Field, model_validator
+
+from ..solution.spec_models import StrictModel
+
+
+class PublicFieldType(str, Enum):
+    text = "text"
+    long_text = "long_text"
+    number = "number"
+    amount = "amount"
+    date = "date"
+    datetime = "datetime"
+    member = "member"
+    department = "department"
+    single_select = "single_select"
+    multi_select = "multi_select"
+    phone = "phone"
+    email = "email"
+    address = "address"
+    attachment = "attachment"
+    boolean = "boolean"
+    relation = "relation"
+    subtable = "subtable"
+
+
+class PublicViewType(str, Enum):
+    table = "table"
+    card = "card"
+    board = "board"
+
+
+class PublicFlowNodeType(str, Enum):
+    start = "start"
+    approve = "approve"
+    fill = "fill"
+    copy = "copy"
+    branch = "branch"
+    condition = "condition"
+    webhook = "webhook"
+    end = "end"
+
+
+class FieldSelector(StrictModel):
+    field_id: str | None = None
+    que_id: int | None = None
+    name: str | None = None
+
+    @model_validator(mode="after")
+    def validate_selector(self) -> "FieldSelector":
+        if not any((self.field_id, self.que_id, self.name)):
+            raise ValueError("selector must include field_id, que_id, or name")
+        return self
+
+
+class FieldPatch(StrictModel):
+    name: str
+    type: PublicFieldType
+    required: bool = False
+    description: str | None = None
+    options: list[str] = Field(default_factory=list)
+    target_app_key: str | None = None
+    subfields: list["FieldPatch"] = Field(default_factory=list)
+
+    @model_validator(mode="after")
+    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.target_app_key:
+            raise ValueError("target_app_key is only allowed for relation fields")
+        if self.type == PublicFieldType.subtable and not self.subfields:
+            raise ValueError("subtable field requires subfields")
+        if self.type != PublicFieldType.subtable and self.subfields:
+            raise ValueError("subfields are only allowed for subtable fields")
+        return self
+
+
+class FieldMutation(StrictModel):
+    name: str | None = None
+    type: PublicFieldType | None = None
+    required: bool | None = None
+    description: str | None = None
+    options: list[str] | None = None
+    target_app_key: str | None = None
+    subfields: list[FieldPatch] | None = None
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "FieldMutation":
+        if self.type == PublicFieldType.relation and not self.target_app_key:
+            raise ValueError("relation field requires target_app_key")
+        if self.type == PublicFieldType.subtable and not self.subfields:
+            raise ValueError("subtable field requires subfields")
+        return self
+
+
+class FieldUpdatePatch(StrictModel):
+    selector: FieldSelector
+    set: FieldMutation
+
+
+class FieldRemovePatch(StrictModel):
+    field_id: str | None = None
+    que_id: int | None = None
+    name: str | None = None
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "FieldRemovePatch":
+        if not any((self.field_id, self.que_id, self.name)):
+            raise ValueError("remove patch must include field_id, que_id, or name")
+        return self
+
+
+class LayoutSectionPatch(StrictModel):
+    section_id: str
+    title: str
+    rows: list[list[str]] = Field(default_factory=list)
+
+    @model_validator(mode="after")
+    def validate_rows(self) -> "LayoutSectionPatch":
+        if not self.rows:
+            raise ValueError("section rows must be a non-empty list")
+        return self
+
+
+class FlowNodePatch(StrictModel):
+    id: str
+    type: PublicFlowNodeType
+    name: str
+    config: dict[str, Any] = Field(default_factory=dict)
+
+
+class FlowTransitionPatch(StrictModel):
+    source: str = Field(alias="from")
+    target: str = Field(alias="to")
+
+
+class ViewUpsertPatch(StrictModel):
+    name: str
+    type: PublicViewType
+    columns: list[str] = Field(default_factory=list)
+    group_by: str | None = None
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "ViewUpsertPatch":
+        if self.type in {PublicViewType.table, PublicViewType.card} and not self.columns:
+            raise ValueError("table/card views require columns")
+        if self.type == PublicViewType.board and not self.group_by:
+            raise ValueError("board view requires group_by")
+        return self
+
+
+FieldPatch.model_rebuild()