@qingflow-tech/qingflow-app-builder-mcp 1.0.17 → 1.0.19

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.17
+npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.19
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.17 qingflow-app-builder-mcp
+npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.19 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

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

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

@@ -25,14 +25,14 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     repair.add_argument("--authorized-file-modification", action="store_true")
     repair.add_argument("--output-path")
     repair.add_argument("--repair", dest="selected_repairs", action="append", default=[])
-    repair.set_defaults(handler=_handle_repair, format_hint="")
+    repair.set_defaults(handler=_handle_repair, format_hint="import_repair")
 
     start = import_subparsers.add_parser("start", help="启动导入")
     start.add_argument("--app-key", required=True)
     start.add_argument("--verification-id", required=True)
     start.add_argument("--being-enter-auditing", type=parse_bool_text, required=True)
     start.add_argument("--view-key")
-    start.set_defaults(handler=_handle_start, format_hint="")
+    start.set_defaults(handler=_handle_start, format_hint="import_start")
 
     status = import_subparsers.add_parser("status", help="查询导入状态")
     status.add_argument("--app-key")

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

@@ -82,7 +82,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     log = task_subparsers.add_parser("log", help="读取流程日志；--task-id 必须来自 task list 的 data.items[].task_id")
     log.add_argument("--task-id", help="来自 `qingflow --json task list` 的 data.items[].task_id；不是列表序号")
-    log.set_defaults(handler=_handle_log, format_hint="", app_key="", record_id="", workflow_node_id=0)
+    log.set_defaults(handler=_handle_log, format_hint="task_workflow_log_get", app_key="", record_id="", workflow_node_id=0)
 
 
 def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:

package/src/qingflow_mcp/cli/formatters.py

@@ -566,6 +566,50 @@ def _format_task_get(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_task_workflow_log(result: dict[str, Any]) -> str:
+    data = result.get("data") if isinstance(result.get("data"), dict) else {}
+    selection = data.get("selection") if isinstance(data.get("selection"), dict) else {}
+    visibility = data.get("visibility") if isinstance(data.get("visibility"), dict) else {}
+    items = data.get("items") if isinstance(data.get("items"), list) else []
+    lines: list[str] = []
+    if selection.get("task_id") not in (None, ""):
+        lines.append(f"Task ID: {selection.get('task_id')}")
+    locator = " / ".join(
+        str(value or "-")
+        for value in (
+            selection.get("app_key"),
+            selection.get("record_id"),
+            selection.get("workflow_node_id"),
+        )
+    )
+    if locator != "- / - / -":
+        lines.append(f"Locator: {locator}")
+    if visibility:
+        lines.append(
+            "Visibility: "
+            f"audit_record={visibility.get('audit_record_visible')} / "
+            f"qrobot_record={visibility.get('qrobot_record_visible')}"
+        )
+    lines.append(f"Workflow Logs: {len(items)}")
+    for item in items[:20]:
+        if not isinstance(item, dict):
+            continue
+        operator = item.get("operator") if isinstance(item.get("operator"), dict) else {}
+        operator_name = operator.get("name") or operator.get("email") or operator.get("uid") or "-"
+        parts = [
+            str(item.get("operation_time") or "-"),
+            str(item.get("node_name") or item.get("node_id") or "-"),
+            str(operator_name),
+            str(item.get("remark") or item.get("operation") or "-"),
+        ]
+        lines.append("- " + " / ".join(parts))
+    if len(items) > 20:
+        lines.append(f"... {len(items) - 20} more")
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
 def _format_task_action(result: dict[str, Any]) -> str:
     data = result.get("data") if isinstance(result.get("data"), dict) else {}
     action = str(data.get("action") or "").strip().lower()
@@ -741,6 +785,59 @@ def _format_import_status(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_import_repair(result: dict[str, Any]) -> str:
+    lines = [
+        f"Status: {result.get('status') or '-'}",
+        f"Source File: {result.get('source_file_path') or '-'}",
+        f"Repaired File: {result.get('repaired_file_path') or '-'}",
+        f"Can Import After Repair: {result.get('can_import_after_repair')}",
+    ]
+    verification_id = result.get("verification_id") or result.get("new_verification_id")
+    if verification_id:
+        lines.append(f"Verification ID: {verification_id}")
+    applied_repairs = result.get("applied_repairs") if isinstance(result.get("applied_repairs"), list) else []
+    skipped_repairs = result.get("skipped_repairs") if isinstance(result.get("skipped_repairs"), list) else []
+    lines.append(f"Applied Repairs: {', '.join(map(str, applied_repairs)) if applied_repairs else '-'}")
+    if skipped_repairs:
+        lines.append(f"Skipped Repairs: {', '.join(map(str, skipped_repairs))}")
+    issue_summary = result.get("post_repair_issue_summary") if isinstance(result.get("post_repair_issue_summary"), dict) else {}
+    if issue_summary:
+        lines.append(
+            "Post Repair Issues: "
+            f"total={issue_summary.get('total', 0)}, "
+            f"errors={issue_summary.get('errors', 0)}, "
+            f"warnings={issue_summary.get('warnings', 0)}"
+        )
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
+def _format_import_start(result: dict[str, Any]) -> str:
+    lines = [
+        f"Status: {result.get('status') or '-'}",
+        f"Accepted: {result.get('accepted')}",
+        f"Write Executed: {result.get('write_executed')}",
+        f"Safe To Retry: {result.get('safe_to_retry')}",
+        f"Import ID: {result.get('import_id') or '-'}",
+        f"Process ID: {result.get('process_id_str') or '-'}",
+    ]
+    if result.get("file_url"):
+        lines.append(f"File URL: {result.get('file_url')}")
+    for key, label in (
+        ("total", "Total Rows"),
+        ("finished", "Finished Rows"),
+        ("succeeded", "Succeeded Rows"),
+        ("failed", "Failed Rows"),
+    ):
+        value = result.get(key)
+        if value not in (None, ""):
+            lines.append(f"{label}: {value}")
+    _append_warnings(lines, result.get("warnings"))
+    _append_verification(lines, result.get("verification"))
+    return "\n".join(lines) + "\n"
+
+
 def _format_export_common(result: dict[str, Any], *, title: str | None = None) -> str:
     lines: list[str] = []
     if title:
@@ -1025,10 +1122,13 @@ _FORMATTERS = {
     "task_list": _format_task_list,
     "task_workbench": _format_task_workbench,
     "task_get": _format_task_get,
+    "task_workflow_log_get": _format_task_workflow_log,
     "task_action_execute": _format_task_action,
     "task_associated_report_detail_get": _format_task_associated_report_detail,
     "import_template": _format_import_template,
     "import_verify": _format_import_verify,
+    "import_repair": _format_import_repair,
+    "import_start": _format_import_start,
     "import_status": _format_import_status,
     "export_start": _format_export_start,
     "export_status": _format_export_status,