@josephyan/qingflow-app-user-mcp 1.1.14 → 1.1.15

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-user-mcp",
-  "version": "1.1.14",
+  "version": "1.1.15",
   "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.14"
+version = "1.1.15"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/cli/commands/builder.py

@@ -563,7 +563,7 @@ def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
         file_create_if_missing = _coerce_apps_file_bool(
             apps_payload.get("create_if_missing"),
             field_name="create_if_missing",
-            default=False,
+            default=True,
         )
         file_publish = _coerce_apps_file_bool(
             apps_payload.get("publish"),
@@ -580,7 +580,7 @@ def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
             )
         if args.app_key or args.app_name or args.app_title or args.add_fields_file or args.update_fields_file or args.remove_fields_file:
             raise_config_error(
-                "schema apply multi-app mode accepts --package-id/--create-if-missing plus --apps-file only.",
+                "schema apply multi-app mode accepts --package-id plus --apps-file only; --create-if-missing is optional.",
                 fix_hint="Use `--apps-file` for batch mode, or remove `--apps-file` and use the single-app arguments.",
             )
         if package_id is None:

package/src/qingflow_mcp/server_app_builder.py

@@ -197,7 +197,7 @@ def build_builder_server() -> FastMCP:
         profile: str = DEFAULT_PROFILE,
         package_id: int | None = None,
         package_name: str | None = None,
-        create_if_missing: bool = False,
+        create_if_missing: bool | None = None,
         icon: str | None = None,
         color: str | None = None,
         visibility: dict | None = None,
@@ -426,7 +426,7 @@ def build_builder_server() -> FastMCP:
         icon: str = "",
         color: str = "",
         visibility: dict | None = None,
-        create_if_missing: bool = False,
+        create_if_missing: bool | None = None,
         publish: bool = True,
         add_fields: list[dict] | None = None,
         update_fields: list[dict] | None = None,
@@ -436,7 +436,7 @@ def build_builder_server() -> FastMCP:
         if apps:
             if app_key or app_name or app_title or add_fields or update_fields or remove_fields:
                 return _config_failure(
-                    "app_schema_apply multi-app mode accepts package_id/create_if_missing plus apps only.",
+                    "app_schema_apply multi-app mode accepts package_id plus apps only; create_if_missing is optional.",
                     fix_hint="Use `apps` for batch mode, or use the single-app arguments without `apps`.",
                 )
             if package_id is None:
@@ -448,7 +448,7 @@ def build_builder_server() -> FastMCP:
                 profile=profile,
                 package_id=package_id,
                 visibility=visibility,
-                create_if_missing=create_if_missing,
+                create_if_missing=True if create_if_missing is None else bool(create_if_missing),
                 publish=publish,
                 add_fields=[],
                 update_fields=[],
@@ -459,13 +459,14 @@ def build_builder_server() -> FastMCP:
         has_app_name = bool((app_name or "").strip())
         has_app_title = bool((app_title or "").strip())
         has_package_id = package_id is not None
+        effective_create_if_missing = bool(create_if_missing)
         if has_app_key:
-            if create_if_missing or has_package_id:
+            if effective_create_if_missing or has_package_id:
                 return _config_failure(
                     "app_schema_apply edit mode accepts app_key and optional app_name rename only.",
                     fix_hint="For existing apps, use `app_key` and optionally `app_name`. For create mode, use `package_id + app_name + create_if_missing=true`.",
                 )
-        elif not (create_if_missing and has_package_id and (has_app_name or has_app_title)):
+        elif not (effective_create_if_missing and has_package_id and (has_app_name or has_app_title)):
             return _config_failure(
                 "app_schema_apply create mode requires package_id, app_name, and create_if_missing=true.",
                 fix_hint="Use `app_key` for existing apps, or pass `package_id + app_name + create_if_missing=true` to create a new app.",
@@ -479,7 +480,7 @@ def build_builder_server() -> FastMCP:
             icon=icon,
             color=color,
             visibility=visibility,
-            create_if_missing=create_if_missing,
+            create_if_missing=effective_create_if_missing,
             publish=publish,
             add_fields=add_fields or [],
             update_fields=update_fields or [],

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -330,7 +330,7 @@ class AiBuilderTools(ToolBase):
             profile: str = DEFAULT_PROFILE,
             package_id: int | None = None,
             package_name: str | None = None,
-            create_if_missing: bool = False,
+            create_if_missing: bool | None = None,
             icon: str | JSONObject | None = None,
             color: str | None = None,
             icon_name: str | None = None,
@@ -573,7 +573,7 @@ class AiBuilderTools(ToolBase):
             icon_color: str | None = None,
             icon_config: JSONObject | None = None,
             visibility: JSONObject | None = None,
-            create_if_missing: bool = False,
+            create_if_missing: bool | None = None,
             publish: bool = True,
             add_fields: list[JSONObject] | None = None,
             update_fields: list[JSONObject] | None = None,
@@ -584,7 +584,7 @@ class AiBuilderTools(ToolBase):
                 if app_key or app_name or app_title or add_fields or update_fields or remove_fields:
                     return _config_failure(
                         tool_name="app_schema_apply",
-                        message="app_schema_apply multi-app mode accepts package_id/create_if_missing plus apps only.",
+                        message="app_schema_apply multi-app mode accepts package_id plus apps only; create_if_missing is optional.",
                         fix_hint="Use `apps` for batch mode, or use the single-app arguments without `apps`.",
                     )
                 if package_id is None:
@@ -597,7 +597,7 @@ class AiBuilderTools(ToolBase):
                     profile=profile,
                     package_id=package_id,
                     visibility=visibility,
-                    create_if_missing=create_if_missing,
+                    create_if_missing=True if create_if_missing is None else bool(create_if_missing),
                     publish=publish,
                     apps=apps,
                     add_fields=[],
@@ -608,14 +608,15 @@ class AiBuilderTools(ToolBase):
             has_app_name = bool((app_name or "").strip())
             has_app_title = bool((app_title or "").strip())
             has_package_id = package_id is not None
+            effective_create_if_missing = bool(create_if_missing)
             if has_app_key:
-                if create_if_missing or has_package_id:
+                if effective_create_if_missing or has_package_id:
                     return _config_failure(
                         tool_name="app_schema_apply",
                         message="app_schema_apply edit mode accepts app_key and optional app_name rename only.",
                         fix_hint="For existing apps, use `app_key` and optionally `app_name`. For create mode, use `package_id + app_name + create_if_missing=true`.",
                     )
-            elif not (create_if_missing and has_package_id and (has_app_name or has_app_title)):
+            elif not (effective_create_if_missing and has_package_id and (has_app_name or has_app_title)):
                 return _config_failure(
                     tool_name="app_schema_apply",
                     message="app_schema_apply create mode requires package_id, app_name, and create_if_missing=true.",
@@ -633,7 +634,7 @@ class AiBuilderTools(ToolBase):
                 icon_color=icon_color,
                 icon_config=icon_config,
                 visibility=visibility,
-                create_if_missing=create_if_missing,
+                create_if_missing=effective_create_if_missing,
                 publish=publish,
                 add_fields=add_fields or [],
                 update_fields=update_fields or [],
@@ -979,7 +980,7 @@ class AiBuilderTools(ToolBase):
         profile: str,
         package_id: int | None = None,
         package_name: str | None = None,
-        create_if_missing: bool = False,
+        create_if_missing: bool | None = None,
         icon: str | JSONObject | None = None,
         color: str | None = None,
         icon_name: str | None = None,
@@ -1849,7 +1850,7 @@ class AiBuilderTools(ToolBase):
         icon: str = "",
         color: str = "",
         visibility: JSONObject | None = None,
-        create_if_missing: bool = False,
+        create_if_missing: bool | None = None,
         add_fields: list[JSONObject],
         update_fields: list[JSONObject],
         remove_fields: list[JSONObject],
@@ -2077,7 +2078,7 @@ class AiBuilderTools(ToolBase):
         icon_color: str | None = None,
         icon_config: JSONObject | None = None,
         visibility: JSONObject | None = None,
-        create_if_missing: bool = False,
+        create_if_missing: bool | None = None,
         publish: bool = True,
         add_fields: list[JSONObject],
         update_fields: list[JSONObject],
@@ -2108,7 +2109,7 @@ class AiBuilderTools(ToolBase):
                 profile=profile,
                 package_id=package_id,
                 visibility=visibility,
-                create_if_missing=create_if_missing,
+                create_if_missing=True if create_if_missing is None else bool(create_if_missing),
                 publish=publish,
                 apps=apps,
             )
@@ -2126,7 +2127,7 @@ class AiBuilderTools(ToolBase):
             icon=icon,
             color=color,
             visibility=visibility,
-            create_if_missing=create_if_missing,
+            create_if_missing=bool(create_if_missing),
             publish=publish,
             add_fields=add_fields,
             update_fields=update_fields,
@@ -3745,8 +3746,8 @@ def _multi_app_static_validation_failure(
                     "row_number": index + 1,
                     "path": f"apps[{index}]",
                     "error_code": "CREATE_IF_MISSING_REQUIRED",
-                    "message": "new multi-app items require create_if_missing=true",
-                    "fix_hint": "Set create_if_missing=true, or pass app_key for an existing app.",
+                    "message": "apps[] item with app_name but no app_key cannot run when create_if_missing=false",
+                    "fix_hint": "Omit create_if_missing in multi-app mode, set it to true, or pass app_key for every existing app item.",
                 }
             )
 
@@ -6092,9 +6093,9 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "edit mode: app_key, optional app_name to rename the existing app",
             "create mode: package_id + app_name + create_if_missing=true",
             "create mode follows backend CreateAppBean: package add_app permission is checked on the target package; package edit_app is not required for the create precheck",
-            "multi-app mode: pass package_id + create_if_missing + apps[]; do not mix apps with top-level app_key/app_name/add_fields/update_fields/remove_fields",
+            "multi-app mode: pass package_id + apps[]; create_if_missing defaults to true for app_name items and may be set false only when every item uses app_key",
             "CLI --apps-file primary shape is {package_id, apps:[...]}; raw app arrays and singleton wrapper arrays are compatibility paths, not recommended examples",
-            "multi-app mode preflights static errors before writing: duplicate client_key/app_name, missing data title on new apps, create_if_missing omissions, and unresolved target_app_ref/target_app",
+            "multi-app mode preflights static errors before writing: duplicate client_key/app_name, missing data title on new apps, explicit create_if_missing=false with app_name items, and unresolved target_app_ref/target_app",
             "multi-app relation fields may use target_app_ref to point at another apps[].client_key; the tool creates/resolves app shells first and compiles it to target_app_key",
             "multi-app relation fields may also use target_app with another apps[].app_name; prefer target_app_ref/client_key when names may collide",
             "multi-app mode is not transactional; read created_app_keys and apps[].status before retrying, and retry only failed app items",
@@ -6147,7 +6148,6 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
         "multi_app_example": {
             "profile": "default",
             "package_id": 1001,
-            "create_if_missing": True,
             "publish": True,
             "apps": [
                 {