@qingflow-tech/qingflow-cli 1.1.1 → 1.1.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/README.md +2 -2
  2. package/package.json +1 -1
  3. package/pyproject.toml +1 -1
  4. package/skills/qingflow-cli/SKILL.md +59 -45
  5. package/skills/qingflow-cli/manifest.yaml +1 -1
  6. package/skills/qingflow-cli/reference/00-INDEX.md +35 -0
  7. package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_APP_DELIVERY_WORKFLOW.md +21 -477
  8. package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_VIEWS_WORKFLOW.md +44 -290
  9. package/skills/qingflow-cli/reference/QINGFLOW_CLI_SCHEMA_APPLY_FIELD_TYPES_AND_SCENARIOS.md +11 -102
  10. package/skills/qingflow-cli/reference/builder/10-build-single-app.md +57 -0
  11. package/skills/qingflow-cli/reference/builder/20-build-complete-system.md +84 -0
  12. package/skills/qingflow-cli/reference/builder/30-schema-fields.md +317 -0
  13. package/skills/qingflow-cli/reference/builder/40-layout.md +70 -0
  14. package/skills/qingflow-cli/reference/builder/50-views.md +540 -0
  15. package/skills/qingflow-cli/reference/builder/60-charts.md +328 -0
  16. package/skills/qingflow-cli/reference/builder/70-portal.md +372 -0
  17. package/skills/qingflow-cli/reference/builder/80-buttons-associated-resources.md +148 -0
  18. package/skills/qingflow-cli/reference/builder/90-workflow.md +41 -0
  19. package/skills/qingflow-cli/reference/builder/99-publish-verify.md +64 -0
  20. package/skills/qingflow-cli/reference/builder/README.md +62 -0
  21. package/skills/qingflow-cli/reference/builder/code-integrations/README.md +130 -0
  22. package/skills/qingflow-cli/reference/builder/code-integrations/code-block.md +66 -0
  23. package/skills/qingflow-cli/reference/builder/code-integrations/q-linker.md +77 -0
  24. package/skills/qingflow-cli/reference/builder/reference/app-delivery-sop.md +511 -0
  25. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/README.md +308 -0
  26. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/build-complete-system.md +819 -0
  27. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/build-single-app.md +836 -0
  28. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/complete-system-development-guide.md +137 -0
  29. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/create-app.md +203 -0
  30. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/environments.md +63 -0
  31. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/flow-actors-and-permissions.md +142 -0
  32. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/gotchas.md +116 -0
  33. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/match-rules.md +114 -0
  34. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/public-surface-sync.md +75 -0
  35. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/single-app-development-guide.md +69 -0
  36. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/solution-playbooks.md +52 -0
  37. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/tool-selection.md +113 -0
  38. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-flow.md +7 -0
  39. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-layout.md +7 -0
  40. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-schema.md +7 -0
  41. package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-views.md +7 -0
  42. package/skills/qingflow-cli/reference/builder/reference/match-rules.md +229 -0
  43. package/skills/qingflow-cli/reference/builder/reference/workspace-icons.md +89 -0
  44. package/skills/qingflow-cli/reference/builder/workflow/01-overview.md +47 -0
  45. package/skills/qingflow-cli/reference/builder/workflow/02-update-mode.md +63 -0
  46. package/skills/qingflow-cli/reference/builder/workflow/03-flow-patterns.md +59 -0
  47. package/skills/qingflow-cli/reference/builder/workflow/04-stage1-business-modeling.md +131 -0
  48. package/skills/qingflow-cli/reference/builder/workflow/05-stage2-members-roles.md +29 -0
  49. package/skills/qingflow-cli/reference/builder/workflow/06-stage3-build-spec.md +217 -0
  50. package/skills/qingflow-cli/reference/builder/workflow/07-stage4-validate-spec.md +42 -0
  51. package/skills/qingflow-cli/reference/builder/workflow/08-stage5-apply-verify.md +67 -0
  52. package/skills/qingflow-cli/reference/builder/workflow/09-stage6-summary.md +88 -0
  53. package/skills/qingflow-cli/reference/builder/workflow/10-node-config-reference.md +93 -0
  54. package/skills/qingflow-cli/reference/builder/workflow/11-troubleshooting.md +17 -0
  55. package/skills/qingflow-cli/reference/builder/workflow/README.md +88 -0
  56. package/skills/qingflow-cli/reference/builder/workflow/workflow-schema.json +1754 -0
  57. package/skills/qingflow-cli/reference/charts_upsert_dashboard_starter.example.json +81 -0
  58. package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_ADMIN_CHEATSHEET.md +94 -0
  59. package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md +139 -0
  60. package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_EXPLORATION_REPORT.md +84 -0
  61. package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_FIELD_DATA_TYPES.md +129 -0
  62. package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_MEMBER_CHEATSHEET.md +195 -0
  63. package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_ONE_SHOT_CHEATSHEET.md +159 -0
  64. package/skills/qingflow-cli/reference/examples/README.md +17 -0
  65. package/skills/qingflow-cli/reference/examples/associated/associated_resources_semantic_full.example.json +50 -0
  66. package/skills/qingflow-cli/reference/examples/buttons/custom_buttons_advanced.example.json +56 -0
  67. package/skills/qingflow-cli/reference/examples/charts/charts_remove.example.json +1 -0
  68. package/skills/qingflow-cli/reference/examples/charts/charts_reorder.example.json +1 -0
  69. package/skills/qingflow-cli/reference/examples/charts/charts_upsert_bar.example.json +8 -0
  70. package/skills/qingflow-cli/reference/examples/charts/charts_upsert_dashboard_starter.example.json +118 -0
  71. package/skills/qingflow-cli/reference/examples/charts/charts_upsert_minimal.example.json +13 -0
  72. package/skills/qingflow-cli/reference/examples/layout/layout_sections_full.example.json +22 -0
  73. package/skills/qingflow-cli/reference/examples/portal/portal_sections_all_types.example.json +145 -0
  74. package/skills/qingflow-cli/reference/examples/portal/portal_sections_five_types.example.json +126 -0
  75. package/skills/qingflow-cli/reference/examples/portal/portal_sections_standard_workbench.example.json +178 -0
  76. package/skills/qingflow-cli/reference/examples/record/record_insert_all_field_types.example.json +35 -0
  77. package/skills/qingflow-cli/reference/examples/schema/_batch_schema_complex.json +18 -0
  78. package/skills/qingflow-cli/reference/examples/schema/_batch_schema_scalar.json +17 -0
  79. package/skills/qingflow-cli/reference/examples/schema/schema_add_fields_minimal.example.json +7 -0
  80. package/skills/qingflow-cli/reference/examples/schema/schema_apply_add_fields_all_types.json +78 -0
  81. package/skills/qingflow-cli/reference/examples/schema/schema_multi_app_form_relation_layout.example.json +166 -0
  82. package/skills/qingflow-cli/reference/examples/schema/schema_single_app_form_standard.example.json +95 -0
  83. package/skills/qingflow-cli/reference/examples/views/views_batch_full.example.json +159 -0
  84. package/skills/qingflow-cli/reference/examples/views/views_upsert_table_minimal.example.json +42 -0
  85. package/skills/qingflow-cli/reference/portal_sections_all_types.example.json +18 -4
  86. package/skills/qingflow-cli/reference/portal_sections_five_types.example.json +3 -3
  87. package/skills/qingflow-cli/reference/portal_sections_standard_workbench.example.json +57 -7
  88. package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_CREATE_WORKFLOW.md +22 -0
  89. package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_DELETE_WORKFLOW.md +31 -0
  90. package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_IMPORT_WORKFLOW.md +176 -0
  91. package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_UPDATE_WORKFLOW.md +167 -0
  92. package/skills/qingflow-cli/reference/record/analysis/README.md +130 -0
  93. package/skills/qingflow-cli/reference/record/analysis/analysis-gotchas.md +91 -0
  94. package/skills/qingflow-cli/reference/record/analysis/analysis-patterns.md +112 -0
  95. package/skills/qingflow-cli/reference/record/analysis/business-context.md +74 -0
  96. package/skills/qingflow-cli/reference/record/analysis/confidence-reporting.md +69 -0
  97. package/skills/qingflow-cli/reference/record/analysis/data-access-playbook.md +106 -0
  98. package/skills/qingflow-cli/reference/record/analysis/pandas-recipes.md +172 -0
  99. package/skills/qingflow-cli/reference/record/analysis/report-format.md +76 -0
  100. package/skills/qingflow-cli/reference/record/insert/README.md +125 -0
  101. package/skills/qingflow-cli/reference/schema_apply_add_fields_all_types.json +1 -1
  102. package/skills/qingflow-cli/reference/task/QINGFLOW_CLI_TASK_CONTEXT_WORKFLOW.md +153 -0
  103. package/skills/qingflow-cli/reference/task/ops/README.md +134 -0
  104. package/skills/qingflow-cli/reference/task/ops/environments.md +43 -0
  105. package/skills/qingflow-cli/reference/task/ops/workflow-usage.md +29 -0
  106. package/skills/qingflow-cli/reference/views_upsert_table_minimal.example.json +42 -7
  107. package/skills/qingflow-cli/scripts/validate_system_build_summary.py +124 -0
  108. package/skills/qingflow-cli/scripts/workflow/diff_flow_spec.py +275 -0
  109. package/skills/qingflow-cli/scripts/workflow/validate_flow_spec.py +605 -0
  110. package/src/qingflow_mcp/builder_facade/models.py +413 -119
  111. package/src/qingflow_mcp/builder_facade/service.py +4211 -676
  112. package/src/qingflow_mcp/cli/commands/builder.py +233 -74
  113. package/src/qingflow_mcp/cli/main.py +34 -0
  114. package/src/qingflow_mcp/public_surface.py +10 -0
  115. package/src/qingflow_mcp/server_app_builder.py +68 -34
  116. package/src/qingflow_mcp/solution/compiler/workflow_compiler.py +173 -0
  117. package/src/qingflow_mcp/solution/executor.py +2 -0
  118. package/src/qingflow_mcp/tools/ai_builder_tools.py +2662 -451
  119. package/src/qingflow_mcp/tools/record_tools.py +23 -11
  120. package/src/qingflow_mcp/tools/task_context_tools.py +35 -11
@@ -14153,6 +14153,7 @@ class RecordTools(ToolBase):
14153
14153
  original_error: QingflowApiError,
14154
14154
  ) -> JSONObject:
14155
14155
  """执行内部辅助逻辑。"""
14156
+ readback_error = _record_write_readback_error_payload(original_error)
14156
14157
  for page_num in range(1, VERIFY_TASK_FALLBACK_MAX_PAGES + 1):
14157
14158
  task_page = self.backend.request(
14158
14159
  "POST",
@@ -14175,6 +14176,12 @@ class RecordTools(ToolBase):
14175
14176
  candidate_apply_id = _coerce_count(item.get("rowRecordId") or item.get("recordId") or item.get("applyId"))
14176
14177
  if candidate_apply_id != apply_id:
14177
14178
  continue
14179
+ warning: JSONObject = {
14180
+ "code": "WRITE_VERIFIED_VIA_TASK_BOX",
14181
+ "message": "Immediate field-level readback was unavailable; write was confirmed via the initiated task box fallback.",
14182
+ "readback_error": readback_error,
14183
+ }
14184
+ warning.update(_record_detail_error_warning_fields(original_error))
14178
14185
  return {
14179
14186
  "verified": True,
14180
14187
  "verification_mode": "initiated_task_box",
@@ -14182,10 +14189,8 @@ class RecordTools(ToolBase):
14182
14189
  "missing_fields": [],
14183
14190
  "empty_fields": [],
14184
14191
  "count_mismatches": [],
14185
- "warnings": [{
14186
- "code": "WRITE_VERIFIED_VIA_TASK_BOX",
14187
- "message": "Field-level readback was blocked by browse permission; write was confirmed via the initiated task box instead.",
14188
- }],
14192
+ "warnings": [warning],
14193
+ "readback_error": readback_error,
14189
14194
  "task_match": {
14190
14195
  "task_id": item.get("id") or item.get("taskId"),
14191
14196
  "record_id": candidate_apply_id,
@@ -14204,14 +14209,12 @@ class RecordTools(ToolBase):
14204
14209
  "count_mismatches": [],
14205
14210
  "warnings": [{
14206
14211
  "code": "WRITE_VERIFY_FALLBACK_FAILED",
14207
- "message": "Field-level readback was blocked by browse permission, and the record was not found in the initiated task box fallback.",
14212
+ "message": "Immediate field-level readback was unavailable, and the record was not found in the initiated task box fallback.",
14213
+ "readback_error": readback_error,
14214
+ **_record_detail_error_warning_fields(original_error),
14208
14215
  }],
14209
- "original_error": {
14210
- "category": original_error.category,
14211
- "message": original_error.message,
14212
- "backend_code": original_error.backend_code,
14213
- "http_status": original_error.http_status,
14214
- },
14216
+ "readback_error": readback_error,
14217
+ "original_error": readback_error,
14215
14218
  }
14216
14219
 
14217
14220
  def _verify_subtable_write_result(
@@ -16266,6 +16269,15 @@ def _record_detail_error_warning_fields(exc: QingflowApiError) -> JSONObject:
16266
16269
  return payload
16267
16270
 
16268
16271
 
16272
+ def _record_write_readback_error_payload(exc: QingflowApiError) -> JSONObject:
16273
+ payload: JSONObject = {
16274
+ "category": exc.category,
16275
+ "message": exc.message,
16276
+ }
16277
+ payload.update(_record_detail_error_warning_fields(exc))
16278
+ return payload
16279
+
16280
+
16269
16281
  def _record_detail_refreshed_source_url(refresh_result: Any) -> str | None:
16270
16282
  if isinstance(refresh_result, dict):
16271
16283
  return _normalize_optional_text(refresh_result.get("source_url"))
@@ -33,6 +33,7 @@ from .record_tools import (
33
33
  _collect_question_relations,
34
34
  _field_ref_payload,
35
35
  _merge_field_indexes,
36
+ _normalize_form_schema,
36
37
  _subtable_descendant_ids,
37
38
  )
38
39
  from .task_tools import TaskTools, _task_page_amount, _task_page_items, _task_page_total
@@ -2487,21 +2488,43 @@ class TaskContextTools(ToolBase):
2487
2488
  ) -> dict[str, Any]:
2488
2489
  """执行内部辅助逻辑。"""
2489
2490
  record_id_text = stringify_backend_id(record_id)
2491
+ schema_warnings: list[JSONObject] = []
2490
2492
  try:
2491
- app_schema = self._record_tools._get_form_schema(profile, context, app_key, force_refresh=False)
2493
+ app_schema = _normalize_form_schema(
2494
+ self.backend.request(
2495
+ "GET",
2496
+ context,
2497
+ f"/app/{app_key}/form",
2498
+ params={"type": 3, "auditNodeId": workflow_node_id},
2499
+ )
2500
+ )
2492
2501
  except QingflowApiError as error:
2493
2502
  if not _is_task_optional_read_error(error):
2494
2503
  raise
2495
- return self._build_task_update_schema_from_runtime_answers(
2496
- profile=profile,
2497
- context=context,
2498
- app_key=app_key,
2499
- record_id=record_id,
2500
- workflow_node_id=workflow_node_id,
2501
- node_info=node_info,
2502
- current_answers=current_answers,
2503
- source_error=error,
2504
+ schema_warnings.append(
2505
+ {
2506
+ "code": "TASK_NODE_UPDATE_SCHEMA_UNAVAILABLE",
2507
+ "message": "task update schema fell back to the applicant form because the processing-node form was unavailable in this permission context.",
2508
+ "backend_code": error.backend_code,
2509
+ "http_status": error.http_status,
2510
+ "request_id": error.request_id,
2511
+ }
2504
2512
  )
2513
+ try:
2514
+ app_schema = self._record_tools._get_form_schema(profile, context, app_key, force_refresh=False)
2515
+ except QingflowApiError as fallback_error:
2516
+ if not _is_task_optional_read_error(fallback_error):
2517
+ raise
2518
+ return self._build_task_update_schema_from_runtime_answers(
2519
+ profile=profile,
2520
+ context=context,
2521
+ app_key=app_key,
2522
+ record_id=record_id,
2523
+ workflow_node_id=workflow_node_id,
2524
+ node_info=node_info,
2525
+ current_answers=current_answers,
2526
+ source_error=fallback_error,
2527
+ )
2505
2528
 
2506
2529
  question_relations = _collect_question_relations(app_schema)
2507
2530
  linked_field_ids = _collect_linked_required_field_ids(question_relations)
@@ -2512,12 +2535,13 @@ class TaskContextTools(ToolBase):
2512
2535
  linked_field_ids=linked_field_ids,
2513
2536
  )
2514
2537
  index = _merge_field_indexes(base_index, linked_hidden_index)
2515
- editable_question_ids, schema_warnings, source = self._resolve_task_editable_question_ids(
2538
+ editable_question_ids, editable_warnings, source = self._resolve_task_editable_question_ids(
2516
2539
  context,
2517
2540
  app_key=app_key,
2518
2541
  workflow_node_id=workflow_node_id,
2519
2542
  node_info=node_info,
2520
2543
  )
2544
+ schema_warnings.extend(editable_warnings)
2521
2545
  index, augmentation_warnings = self._augment_task_editable_field_index(
2522
2546
  index=index,
2523
2547
  current_answers=current_answers,