@josephyan/qingflow-app-builder-mcp 0.2.0-beta.987 → 0.2.0-beta.988

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-builder-mcp",
-  "version": "0.2.0-beta.987",
+  "version": "0.2.0-beta.988",
   "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.2.0b987"
+version = "0.2.0b988"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/skills/qingflow-app-builder/SKILL.md

@@ -40,6 +40,7 @@ Default modeling rules:
 - Directory: `member_search`, `role_search`, `role_create`
 - Writes: `app_schema_apply`, `app_layout_apply`, `app_flow_apply`, `app_views_apply`, `app_charts_apply`, `portal_apply`, `app_release_edit_lock_if_mine`
 - Verification: `app_publish_verify`
+- Cross-cutting escalation: `feedback_submit` after explicit user confirmation when the public builder surface still cannot satisfy the user's need
 
 Treat these as the official surface. Do not default to `package_create`, `package_attach_app`, raw `portal_*` writes, or raw `qingbi_report_*` writes.
 
@@ -102,6 +103,7 @@ Treat these as the official surface. Do not default to `package_create`, `packag
 - For workflow assignees, prefer `role_search` over explicit members unless the user explicitly wants named members.
 - Public flow building is still intentionally limited to stable linear workflows. If a requirement sounds like branches/conditions, explain the limitation instead of freehanding unsupported graph shapes.
 - Respect collaborative edit locks. Only use `app_release_edit_lock_if_mine` when the lock owner is the current authenticated user.
+- If the supported builder surface is still awkward or blocked after reasonable use, summarize the gap, ask whether to submit feedback, and call `feedback_submit` only after explicit user confirmation.
 
 ## Response Interpretation
 

package/src/qingflow_mcp/__init__.py

@@ -5,7 +5,7 @@ from pathlib import Path
 
 __all__ = ["__version__"]
 
-_FALLBACK_VERSION = "0.2.0b987"
+_FALLBACK_VERSION = "0.2.0b988"
 
 
 def _resolve_local_pyproject_version() -> str | None:

package/src/qingflow_mcp/builder_facade/service.py

@@ -13454,6 +13454,7 @@ def _canonicalize_reference_questions_for_save(
     source: dict[str, Any],
     field: dict[str, Any],
 ) -> list[dict[str, Any]]:
+    relation_config_explicit = bool(field.get("_relation_config_explicit"))
     normalized_source_questions = [
         item
         for item in (
@@ -13462,6 +13463,8 @@ def _canonicalize_reference_questions_for_save(
         )
         if item is not None
     ]
+    if not relation_config_explicit:
+        return normalized_source_questions
 
     display_field = field.get("display_field") if isinstance(field.get("display_field"), dict) else None
     visible_fields = [item for item in cast(list[Any], field.get("visible_fields") or []) if isinstance(item, dict)]
@@ -13498,14 +13501,19 @@ def _canonicalize_reference_questions_for_save(
         if matched_index is not None:
             used_source_indexes.add(matched_index)
 
-    next_ordinal = len(canonical_questions) + 1
-    for index, item in enumerate(normalized_source_questions):
-        if index in used_source_indexes:
-            continue
-        remaining_item = deepcopy(item)
-        remaining_item["ordinal"] = next_ordinal
-        next_ordinal += 1
-        canonical_questions.append(remaining_item)
+    source_target_app_key = str(source.get("referAppKey") or "").strip()
+    target_app_key = str(field.get("target_app_key") or "").strip()
+    preserve_remaining_source_questions = not source_target_app_key or source_target_app_key == target_app_key
+
+    if preserve_remaining_source_questions:
+        next_ordinal = len(canonical_questions) + 1
+        for index, item in enumerate(normalized_source_questions):
+            if index in used_source_indexes:
+                continue
+            remaining_item = deepcopy(item)
+            remaining_item["ordinal"] = next_ordinal
+            next_ordinal += 1
+            canonical_questions.append(remaining_item)
 
     return canonical_questions
 
@@ -13514,6 +13522,7 @@ def _canonicalize_reference_auth_questions_for_save(
     *,
     source: dict[str, Any],
     refer_questions: list[dict[str, Any]],
+    relation_config_explicit: bool,
 ) -> list[dict[str, Any]]:
     source_auth_questions = [
         item
@@ -13530,6 +13539,40 @@ def _canonicalize_reference_auth_questions_for_save(
             continue
         source_auth_by_que_id[que_id] = item
 
+    if not relation_config_explicit:
+        auth_questions: list[dict[str, Any]] = []
+        seen_que_ids: set[int] = set()
+        refer_question_auth_by_que_id: dict[int, int] = {}
+        for item in refer_questions:
+            que_id = _coerce_any_int(item.get("queId"))
+            que_auth = _coerce_nonnegative_int(item.get("queAuth"))
+            if que_id is None or que_auth is None or que_id in refer_question_auth_by_que_id:
+                continue
+            refer_question_auth_by_que_id[que_id] = que_auth
+
+        for item in source_auth_questions:
+            que_id = _coerce_any_int(item.get("queId"))
+            if que_id is None or que_id in seen_que_ids:
+                continue
+            payload = deepcopy(item)
+            if que_id in refer_question_auth_by_que_id:
+                payload["queAuth"] = refer_question_auth_by_que_id[que_id]
+            auth_questions.append(payload)
+            seen_que_ids.add(que_id)
+
+        for item in refer_questions:
+            que_id = _coerce_any_int(item.get("queId"))
+            que_auth = _coerce_nonnegative_int(item.get("queAuth"))
+            if que_id is None or que_auth is None or que_id in seen_que_ids:
+                continue
+            payload = deepcopy(source_auth_by_que_id.get(que_id) or {"queId": que_id})
+            payload["queId"] = que_id
+            payload["queAuth"] = que_auth
+            auth_questions.append(payload)
+            seen_que_ids.add(que_id)
+
+        return _dedupe_reference_auth_questions(auth_questions)
+
     auth_questions: list[dict[str, Any]] = []
     for item in refer_questions:
         que_id = _coerce_any_int(item.get("queId"))
@@ -13548,6 +13591,7 @@ def _enforce_reference_config_consistency_for_save(
     *,
     field: dict[str, Any],
 ) -> dict[str, Any]:
+    relation_config_explicit = bool(field.get("_relation_config_explicit"))
     refer_questions = [
         item
         for item in (
@@ -13583,28 +13627,29 @@ def _enforce_reference_config_consistency_for_save(
         if display_field_que_id is not None:
             payload["referQueId"] = display_field_que_id
 
-    if display_field_que_id is not None and not any(
-        _coerce_any_int(item.get("queId")) == display_field_que_id for item in refer_questions
-    ):
-        display_selector = field.get("display_field") if isinstance(field.get("display_field"), dict) else None
-        display_question = (
-            _build_reference_question_from_visible_selector(display_selector, ordinal=1)
-            if display_selector is not None
-            else None
-        )
-        if display_question is not None:
-            display_question["queId"] = display_field_que_id
-            display_question["queAuth"] = _REFERENCE_FIELD_VISIBLE_AUTH
-            refer_questions = [display_question, *refer_questions]
+    if relation_config_explicit:
+        if display_field_que_id is not None and not any(
+            _coerce_any_int(item.get("queId")) == display_field_que_id for item in refer_questions
+        ):
+            display_selector = field.get("display_field") if isinstance(field.get("display_field"), dict) else None
+            display_question = (
+                _build_reference_question_from_visible_selector(display_selector, ordinal=1)
+                if display_selector is not None
+                else None
+            )
+            if display_question is not None:
+                display_question["queId"] = display_field_que_id
+                display_question["queAuth"] = _REFERENCE_FIELD_VISIBLE_AUTH
+                refer_questions = [display_question, *refer_questions]
 
-    if display_field_que_id is not None:
-        display_questions = [
-            item for item in refer_questions if _coerce_any_int(item.get("queId")) == display_field_que_id
-        ]
-        trailing_questions = [
-            item for item in refer_questions if _coerce_any_int(item.get("queId")) != display_field_que_id
-        ]
-        refer_questions = [*display_questions, *trailing_questions]
+        if display_field_que_id is not None:
+            display_questions = [
+                item for item in refer_questions if _coerce_any_int(item.get("queId")) == display_field_que_id
+            ]
+            trailing_questions = [
+                item for item in refer_questions if _coerce_any_int(item.get("queId")) != display_field_que_id
+            ]
+            refer_questions = [*display_questions, *trailing_questions]
 
     for ordinal, item in enumerate(refer_questions, start=1):
         que_id = _coerce_any_int(item.get("queId"))
@@ -13622,6 +13667,7 @@ def _enforce_reference_config_consistency_for_save(
     payload["referAuthQues"] = _canonicalize_reference_auth_questions_for_save(
         source={"referAuthQues": refer_auth_ques},
         refer_questions=refer_questions,
+        relation_config_explicit=relation_config_explicit,
     )
     return payload
 
@@ -13661,7 +13707,11 @@ def _normalize_reference_config_for_save(
     if refer_fill_rules or "referFillRules" in source:
         payload["referFillRules"] = refer_fill_rules
 
-    refer_auth_ques = _canonicalize_reference_auth_questions_for_save(source=source, refer_questions=refer_questions)
+    refer_auth_ques = _canonicalize_reference_auth_questions_for_save(
+        source=source,
+        refer_questions=refer_questions,
+        relation_config_explicit=bool(field.get("_relation_config_explicit")),
+    )
     if not refer_auth_ques:
         refer_auth_ques = _synthesize_reference_auth_questions_for_save(source=source, field=field)
     if refer_auth_ques or "referAuthQues" in source:
@@ -13917,6 +13967,13 @@ def _field_to_question(field: dict[str, Any], *, temp_id: int) -> dict[str, Any]
                 if isinstance(built_question.get("referenceConfig"), dict)
                 else {}
             )
+            original_target_app_key = str(existing_reference.get("referAppKey") or "").strip()
+            next_target_app_key = str(field.get("target_app_key") or "").strip()
+            preserve_existing_reference_questions = (
+                relation_config_explicit
+                and bool(original_target_app_key)
+                and original_target_app_key == next_target_app_key
+            )
             if relation_config_explicit:
                 for stale_key in ("customButtonText", "customAdvancedSetting", "configShowForm", "dataShowForm"):
                     reference.pop(stale_key, None)
@@ -13928,7 +13985,7 @@ def _field_to_question(field: dict[str, Any], *, temp_id: int) -> dict[str, Any]
                 "fieldNameShow",
                 "_targetFieldId",
             ):
-                if relation_config_explicit and key in {"referQuestions", "referAuthQues"}:
+                if preserve_existing_reference_questions and key in {"referQuestions", "referAuthQues"}:
                     continue
                 if key in built_reference:
                     reference[key] = deepcopy(built_reference[key])

package/src/qingflow_mcp/server_app_builder.py

@@ -93,6 +93,16 @@ def build_builder_server() -> FastMCP:
             include_external=include_external,
         )
 
+    @server.tool()
+    def workspace_get(
+        profile: str = DEFAULT_PROFILE,
+        ws_id: int | None = None,
+    ) -> dict:
+        return workspace.workspace_get(
+            profile=profile,
+            ws_id=ws_id,
+        )
+
     @server.tool()
     def file_upload_local(
         profile: str = DEFAULT_PROFILE,

package/src/qingflow_mcp/server_app_user.py

@@ -228,6 +228,16 @@ If the current MCP capability is unsupported, the workflow is awkward, or the us
             include_external=include_external,
         )
 
+    @server.tool()
+    def workspace_get(
+        profile: str = DEFAULT_PROFILE,
+        ws_id: int | None = None,
+    ) -> dict:
+        return workspace.workspace_get(
+            profile=profile,
+            ws_id=ws_id,
+        )
+
     @server.tool()
     def app_list(profile: str = DEFAULT_PROFILE) -> dict:
         return apps.app_list(profile=profile)