@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.
- package/README.md +2 -2
- package/package.json +1 -1
- package/pyproject.toml +1 -1
- package/skills/qingflow-cli/SKILL.md +59 -45
- package/skills/qingflow-cli/manifest.yaml +1 -1
- package/skills/qingflow-cli/reference/00-INDEX.md +35 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_APP_DELIVERY_WORKFLOW.md +21 -477
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_VIEWS_WORKFLOW.md +44 -290
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_SCHEMA_APPLY_FIELD_TYPES_AND_SCENARIOS.md +11 -102
- package/skills/qingflow-cli/reference/builder/10-build-single-app.md +57 -0
- package/skills/qingflow-cli/reference/builder/20-build-complete-system.md +84 -0
- package/skills/qingflow-cli/reference/builder/30-schema-fields.md +317 -0
- package/skills/qingflow-cli/reference/builder/40-layout.md +70 -0
- package/skills/qingflow-cli/reference/builder/50-views.md +540 -0
- package/skills/qingflow-cli/reference/builder/60-charts.md +328 -0
- package/skills/qingflow-cli/reference/builder/70-portal.md +372 -0
- package/skills/qingflow-cli/reference/builder/80-buttons-associated-resources.md +148 -0
- package/skills/qingflow-cli/reference/builder/90-workflow.md +41 -0
- package/skills/qingflow-cli/reference/builder/99-publish-verify.md +64 -0
- package/skills/qingflow-cli/reference/builder/README.md +62 -0
- package/skills/qingflow-cli/reference/builder/code-integrations/README.md +130 -0
- package/skills/qingflow-cli/reference/builder/code-integrations/code-block.md +66 -0
- package/skills/qingflow-cli/reference/builder/code-integrations/q-linker.md +77 -0
- package/skills/qingflow-cli/reference/builder/reference/app-delivery-sop.md +511 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/README.md +308 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/build-complete-system.md +819 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/build-single-app.md +836 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/complete-system-development-guide.md +137 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/create-app.md +203 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/environments.md +63 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/flow-actors-and-permissions.md +142 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/gotchas.md +116 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/match-rules.md +114 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/public-surface-sync.md +75 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/single-app-development-guide.md +69 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/solution-playbooks.md +52 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/tool-selection.md +113 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-flow.md +7 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-layout.md +7 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-schema.md +7 -0
- package/skills/qingflow-cli/reference/builder/reference/legacy-playbooks/update-views.md +7 -0
- package/skills/qingflow-cli/reference/builder/reference/match-rules.md +229 -0
- package/skills/qingflow-cli/reference/builder/reference/workspace-icons.md +89 -0
- package/skills/qingflow-cli/reference/builder/workflow/01-overview.md +47 -0
- package/skills/qingflow-cli/reference/builder/workflow/02-update-mode.md +63 -0
- package/skills/qingflow-cli/reference/builder/workflow/03-flow-patterns.md +59 -0
- package/skills/qingflow-cli/reference/builder/workflow/04-stage1-business-modeling.md +131 -0
- package/skills/qingflow-cli/reference/builder/workflow/05-stage2-members-roles.md +29 -0
- package/skills/qingflow-cli/reference/builder/workflow/06-stage3-build-spec.md +217 -0
- package/skills/qingflow-cli/reference/builder/workflow/07-stage4-validate-spec.md +42 -0
- package/skills/qingflow-cli/reference/builder/workflow/08-stage5-apply-verify.md +67 -0
- package/skills/qingflow-cli/reference/builder/workflow/09-stage6-summary.md +88 -0
- package/skills/qingflow-cli/reference/builder/workflow/10-node-config-reference.md +93 -0
- package/skills/qingflow-cli/reference/builder/workflow/11-troubleshooting.md +17 -0
- package/skills/qingflow-cli/reference/builder/workflow/README.md +88 -0
- package/skills/qingflow-cli/reference/builder/workflow/workflow-schema.json +1754 -0
- package/skills/qingflow-cli/reference/charts_upsert_dashboard_starter.example.json +81 -0
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_ADMIN_CHEATSHEET.md +94 -0
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md +139 -0
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_EXPLORATION_REPORT.md +84 -0
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_FIELD_DATA_TYPES.md +129 -0
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_MEMBER_CHEATSHEET.md +195 -0
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_ONE_SHOT_CHEATSHEET.md +159 -0
- package/skills/qingflow-cli/reference/examples/README.md +17 -0
- package/skills/qingflow-cli/reference/examples/associated/associated_resources_semantic_full.example.json +50 -0
- package/skills/qingflow-cli/reference/examples/buttons/custom_buttons_advanced.example.json +56 -0
- package/skills/qingflow-cli/reference/examples/charts/charts_remove.example.json +1 -0
- package/skills/qingflow-cli/reference/examples/charts/charts_reorder.example.json +1 -0
- package/skills/qingflow-cli/reference/examples/charts/charts_upsert_bar.example.json +8 -0
- package/skills/qingflow-cli/reference/examples/charts/charts_upsert_dashboard_starter.example.json +118 -0
- package/skills/qingflow-cli/reference/examples/charts/charts_upsert_minimal.example.json +13 -0
- package/skills/qingflow-cli/reference/examples/layout/layout_sections_full.example.json +22 -0
- package/skills/qingflow-cli/reference/examples/portal/portal_sections_all_types.example.json +145 -0
- package/skills/qingflow-cli/reference/examples/portal/portal_sections_five_types.example.json +126 -0
- package/skills/qingflow-cli/reference/examples/portal/portal_sections_standard_workbench.example.json +178 -0
- package/skills/qingflow-cli/reference/examples/record/record_insert_all_field_types.example.json +35 -0
- package/skills/qingflow-cli/reference/examples/schema/_batch_schema_complex.json +18 -0
- package/skills/qingflow-cli/reference/examples/schema/_batch_schema_scalar.json +17 -0
- package/skills/qingflow-cli/reference/examples/schema/schema_add_fields_minimal.example.json +7 -0
- package/skills/qingflow-cli/reference/examples/schema/schema_apply_add_fields_all_types.json +78 -0
- package/skills/qingflow-cli/reference/examples/schema/schema_multi_app_form_relation_layout.example.json +166 -0
- package/skills/qingflow-cli/reference/examples/schema/schema_single_app_form_standard.example.json +95 -0
- package/skills/qingflow-cli/reference/examples/views/views_batch_full.example.json +159 -0
- package/skills/qingflow-cli/reference/examples/views/views_upsert_table_minimal.example.json +42 -0
- package/skills/qingflow-cli/reference/portal_sections_all_types.example.json +18 -4
- package/skills/qingflow-cli/reference/portal_sections_five_types.example.json +3 -3
- package/skills/qingflow-cli/reference/portal_sections_standard_workbench.example.json +57 -7
- package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_CREATE_WORKFLOW.md +22 -0
- package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_DELETE_WORKFLOW.md +31 -0
- package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_IMPORT_WORKFLOW.md +176 -0
- package/skills/qingflow-cli/reference/record/QINGFLOW_CLI_RECORD_UPDATE_WORKFLOW.md +167 -0
- package/skills/qingflow-cli/reference/record/analysis/README.md +130 -0
- package/skills/qingflow-cli/reference/record/analysis/analysis-gotchas.md +91 -0
- package/skills/qingflow-cli/reference/record/analysis/analysis-patterns.md +112 -0
- package/skills/qingflow-cli/reference/record/analysis/business-context.md +74 -0
- package/skills/qingflow-cli/reference/record/analysis/confidence-reporting.md +69 -0
- package/skills/qingflow-cli/reference/record/analysis/data-access-playbook.md +106 -0
- package/skills/qingflow-cli/reference/record/analysis/pandas-recipes.md +172 -0
- package/skills/qingflow-cli/reference/record/analysis/report-format.md +76 -0
- package/skills/qingflow-cli/reference/record/insert/README.md +125 -0
- package/skills/qingflow-cli/reference/schema_apply_add_fields_all_types.json +1 -1
- package/skills/qingflow-cli/reference/task/QINGFLOW_CLI_TASK_CONTEXT_WORKFLOW.md +153 -0
- package/skills/qingflow-cli/reference/task/ops/README.md +134 -0
- package/skills/qingflow-cli/reference/task/ops/environments.md +43 -0
- package/skills/qingflow-cli/reference/task/ops/workflow-usage.md +29 -0
- package/skills/qingflow-cli/reference/views_upsert_table_minimal.example.json +42 -7
- package/skills/qingflow-cli/scripts/validate_system_build_summary.py +124 -0
- package/skills/qingflow-cli/scripts/workflow/diff_flow_spec.py +275 -0
- package/skills/qingflow-cli/scripts/workflow/validate_flow_spec.py +605 -0
- package/src/qingflow_mcp/builder_facade/models.py +413 -119
- package/src/qingflow_mcp/builder_facade/service.py +4211 -676
- package/src/qingflow_mcp/cli/commands/builder.py +233 -74
- package/src/qingflow_mcp/cli/main.py +34 -0
- package/src/qingflow_mcp/public_surface.py +10 -0
- package/src/qingflow_mcp/server_app_builder.py +68 -34
- package/src/qingflow_mcp/solution/compiler/workflow_compiler.py +173 -0
- package/src/qingflow_mcp/solution/executor.py +2 -0
- package/src/qingflow_mcp/tools/ai_builder_tools.py +2662 -451
- package/src/qingflow_mcp/tools/record_tools.py +23 -11
- 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
|
-
|
|
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": "
|
|
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
|
-
"
|
|
14210
|
-
|
|
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 =
|
|
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
|
-
|
|
2496
|
-
|
|
2497
|
-
|
|
2498
|
-
|
|
2499
|
-
|
|
2500
|
-
|
|
2501
|
-
|
|
2502
|
-
|
|
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,
|
|
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,
|