@shundoo-ai/dsh-cosmic 1.0.21 → 1.0.22

package/skills/cosmic-build/skills/cosmic-meta-api/scripts/_core/cmd_formactions.py

@@ -332,7 +332,6 @@ def do_resolve_project_form_read_target(cfg, token, name, project_root,
     }}
 
 
-
 def do_resolve_form_action_target(cfg, token, name, app_root, limit=5):
     """Resolve one form without exposing an unbounded fuzzy result to the model."""
     archive = _read_app_identity_json(
@@ -545,7 +544,12 @@ def _extension_terminal(error_code, message, phase, *, precheck=None,
 
 
 def _form_selection_required(error_code, message, phase, candidates, *, extra=None):
-    """在用户选择准确表单编码前停止本次修改。"""
+    """Stop one mutation until the user selects an exact form number.
+
+    Candidate order, archive order, naming style, and a form that looks like an
+    "original" are not selection evidence. The result makes that boundary
+    explicit for every domain command that uses form preparation.
+    """
     rows = [item for item in candidates or [] if isinstance(item, dict)]
     data = {
         "phase": phase,
@@ -1454,7 +1458,7 @@ def normalize_add_field_biz_word(value):
     return raw
 
 
-def validate_add_field_input(field_name, biz_word, field_type="TextField",
+def validate_add_field_input(field_name, biz_word, field_type=None,
                              combo=None, combo_json=None, basedata=None,
                              mul_table=None, unit_field=None, flex_type=None,
                              ref_base_field=None, ref_display_prop=None,
@@ -1592,7 +1596,7 @@ def _verify_add_field_contract(cfg, token, form_number, field_type,
             return {
                 "ok": False,
                 "scope": ["identity", "fieldType", "tableName"],
-                "message": "MulBasedataField 的关联表未通过独立回读验证",
+                "message": "MulBasedataField association table was not independently verified",
                 "tableNameReadBack": {
                     "requested": requested,
                     "observed": observed,
@@ -1714,7 +1718,7 @@ def _ensure_add_field_complex_properties(
 
 
 def do_add_field(cfg, token, form_name, field_name, biz_word,
-                 field_type="TextField", app_root=None,
+                 field_type=None, app_root=None,
                  project_root=None, app_name=None, app_code=None,
                  selected_ext_app_id=None, required=False,
                  entry=False, entity_name=None, entity_key=None,
@@ -1824,7 +1828,8 @@ def do_add_field(cfg, token, form_name, field_name, biz_word,
             if not hit.get("inLayout"):
                 return _extension_terminal(
                     "FIELD_CONTROL_MISSING",
-                    "实体字段存在，但没有对应的 FieldAp/EntryFieldAp；可见字段并未完整创建。",
+                    "The entity field exists but has no rendered FieldAp/EntryFieldAp; "
+                    "the requested visible field is incomplete",
                     "verify_field",
                     extra={"editableTarget": editable, "field": hit,
                            "writeAttempted": False},
@@ -1839,7 +1844,7 @@ def do_add_field(cfg, token, form_name, field_name, biz_word,
             ):
                 return _extension_terminal(
                     "FIELD_READBACK_MISMATCH",
-                    "现有 MulBasedataField 的关联表无法修复并验证",
+                    "Existing MulBasedataField association table could not be repaired",
                     "verify_field", cause=complex_result,
                     extra={"editableTarget": editable, "field": hit},
                 )
@@ -1903,7 +1908,8 @@ def do_add_field(cfg, token, form_name, field_name, biz_word,
     if not verification.get("inLayout"):
         return _extension_terminal(
             "FIELD_CONTROL_MISSING_AFTER_WRITE",
-            "字段已写入实体，但独立回读没有对应 FieldAp/EntryFieldAp；禁止报告为完成。",
+            "The field was created in the entity but no FieldAp/EntryFieldAp was "
+            "present on independent read-back; do not report the field as complete",
             "verify_field", cause=quick,
             extra={"editableTarget": editable, "writeAttempted": True},
         )
@@ -1917,7 +1923,7 @@ def do_add_field(cfg, token, form_name, field_name, biz_word,
     ):
         return _extension_terminal(
             "UNKNOWN_AFTER_WRITE",
-            "字段已创建，但多选基础资料关联表未通过验证",
+            "Field was created but its multi-select association table did not verify",
             "verify_field", cause=complex_result,
             extra={"editableTarget": editable, "field": verification},
         )
@@ -2017,7 +2023,7 @@ def validate_add_fields_input(fields):
                     f"FIELD_BATCH_INVALID: fields[{index}] non-ASCII selection labels require "
                     "comboJson/comboOptions with explicit stable values"
                 )
-        result = validate_add_field_input(field.get("name"), field.get("bizWord"), field.get("fieldType", "TextField"),
+        result = validate_add_field_input(field.get("name"), field.get("bizWord"), field.get("fieldType"),
                                           combo=field.get("combo"), combo_json=field.get("comboJson"),
                                           **_batch_field_options(field))
         if not result.get("status"):
@@ -2030,7 +2036,7 @@ def validate_add_fields_input(fields):
 def do_add_fields(cfg, token, form_name, fields, *, app_root=None, project_root=None,
                   app_name=None, app_code=None, entry=False, entity_name=None,
                   entity_key=None, _prepared=None):
-    """一次经过鉴权的领域批量写入，逐字段独立回读，并显式暴露部分失败。"""
+    """One authenticated domain batch, verified per field, with explicit partial failure."""
     validate_add_fields_input(fields)
     prepared = _prepared or do_prepare_form_mutation_target(
         cfg, token, name=form_name, app_root=app_root,
@@ -2043,14 +2049,14 @@ def do_add_fields(cfg, token, form_name, fields, *, app_root=None, project_root=
     results = []
     for index, field in enumerate(fields):
         result = do_add_field(cfg, token, form_name, field["name"], field["bizWord"],
-            field_type=field.get("fieldType", "TextField"), combo=field.get("combo"), combo_json=field.get("comboJson"),
+            field_type=field.get("fieldType"), combo=field.get("combo"), combo_json=field.get("comboJson"),
             required=field.get("required", False), app_root=app_root, project_root=project_root,
             app_name=app_name, app_code=app_code, entry=entry, entity_name=entity_name, entity_key=entity_key,
             _prepared=prepared, **_batch_field_options(field))
         results.append(result)
         if not _is_api_success(result) or not (result.get("data") or {}).get("verified"):
             return {"status": False, "errorCode": "FIELD_BATCH_INCOMPLETE",
-                    "message": "批量写入在第一个未通过回读的字段处停止；请勿重放已完成的条目",
+                    "message": "Batch stopped at the first unverified field; do not replay completed items",
                     "data": {"results": results, "failedIndex": index, "pending": fields[index + 1:],
                              "editableTarget": data.get("editableTarget")}}
     return {"status": True, "data": {"verified": True, "results": results,
@@ -2058,7 +2064,7 @@ def do_add_fields(cfg, token, form_name, fields, *, app_root=None, project_root=
 
 
 def do_add_simple_field(cfg, token, form_name, field_name, biz_word,
-                        field_type="TextField", app_root=None,
+                        field_type=None, app_root=None,
                         project_root=None, app_name=None, app_code=None,
                         selected_ext_app_id=None, required=False,
                         entry=False, entity_name=None, entity_key=None):
@@ -2073,7 +2079,7 @@ def do_add_simple_field(cfg, token, form_name, field_name, biz_word,
 
 
 def summary_delete_dependencies(metadata, fields):
-    """查找仍然指向本次待删除字段的汇总来源字段。"""
+    """Find surviving summary sources that point at a requested deletion."""
     keys = {str(field.get("fieldKey") or "") for field in fields}
     dependencies = []
     def visit(value):
@@ -2121,11 +2127,11 @@ def rule_delete_dependencies(metadata, fields):
 def do_remove_field(cfg, token, form_name, field_name, *, app_root=None,
                     project_root=None, app_name=None, app_code=None,
                     entity_key=None, before_delete=None):
-    """在一次删除与独立回读前，先解析全部请求字段。"""
+    """Resolve all requested fields before one deletion and independent read-back."""
     form_name = str(form_name or "").strip()
     field_names = field_name if isinstance(field_name, list) else [field_name]
     if not field_names or any(not isinstance(name, str) or not name.strip() for name in field_names):
-        return _extension_terminal("REMOVE_FIELD_INPUT_INVALID", "请提供非空的准确字段名/字段标识数组", "preflight")
+        return _extension_terminal("REMOVE_FIELD_INPUT_INVALID", "Provide a non-empty array of exact field names/keys", "preflight")
     field_names = [name.strip() for name in field_names]
     entity_key = str(entity_key or "").strip()
     if not form_name or not field_name:
@@ -2175,7 +2181,7 @@ def do_remove_field(cfg, token, form_name, field_name, *, app_root=None,
             return {
                 "status": False,
                 "errorCode": "FIELD_NOT_FOUND" if not matches else "FIELD_TARGET_AMBIGUOUS",
-                "message": "删除前每个字段都必须唯一解析；请使用准确的字段标识或 --entity-key",
+                "message": "Every field must resolve uniquely before any deletion; use an exact key or --entity-key",
                 "data": {"writeAttempted": False, "requestedField": selector,
                          "phase": "resolve_field", "success": False,
                          "candidates": [{"fieldKey": row.get("key"), "fieldName": row.get("name"),
@@ -2209,7 +2215,7 @@ def do_remove_field(cfg, token, form_name, field_name, *, app_root=None,
                 "FIELD_DEPENDENCY_READ_FAILED", "Legacy entity read did not return field metadata",
                 "preflight", cause=metadata, extra={"writeAttempted": False})
     if not _is_api_success(metadata) or not isinstance(metadata.get("data"), dict):
-        return _extension_terminal("FIELD_DEPENDENCY_READ_FAILED", "删除前无法校验字段依赖关系",
+        return _extension_terminal("FIELD_DEPENDENCY_READ_FAILED", "Cannot verify field dependencies before deletion",
                                    "preflight", cause=metadata, extra={"writeAttempted": False})
     dependencies = (summary_delete_dependencies(metadata.get("data"), candidates)
                     + rule_delete_dependencies(metadata.get("data"), candidates))
@@ -2268,7 +2274,7 @@ def do_remove_field(cfg, token, form_name, field_name, *, app_root=None,
     if remaining or after_ids != before_ids - requested:
         return _extension_terminal(
             "UNKNOWN_AFTER_WRITE",
-            "字段删除后的回读结果与请求的最终字段集合不一致",
+            "Field deletion read-back differs from the requested final field set",
             "verify_field", cause={"remaining": remaining, "unexpectedMissing": sorted(before_ids - requested - after_ids),
                                     "unexpectedAdded": sorted(after_ids - before_ids)},
             extra={"editableTarget": editable, "field": field, "fields": candidates, "writeAttempted": True},
@@ -2941,7 +2947,7 @@ def do_move_form(cfg, token, form_id, biz_app_id, target_biz_unit_id):
 
     if _is_api_success(result):
         data = result.get("data") or {}
-        # 仅写入回执：权威结果由调用方的独立回读给出。
+        # Write receipt only: the authoritative outcome comes from the caller's read-back.
         print(f"[moveForm] 写入回执succeeded (待回读验证): formId={data.get('formId')} → bizUnitId={data.get('targetBizUnitId')}", flush=True)
     else:
         msg = _extract_error_message(result)
@@ -3174,11 +3180,13 @@ def _unit_node_in_tree(units, unit_id, *, root=True):
 
 
 def _read_form_unit_state(cfg, token, app_id, form_id, form_number):
-    """解析表单当前功能分组。内部路由保持内部。
+    """Resolve a form's current functional group. Internal routing stays internal.
 
-    调用方与模型只应看到 getFormUnit 契约：由哪些平台端点回答这个问题属于实现细节，
-    因此内部调用的诊断输出一律捕获而不打印。直接返回内部错误码会泄漏同样的细节，
-    所以失败统一映射到 getFormUnit 已发布的错误码。
+    Callers and the model only ever see the getFormUnit contract: which platform
+    endpoints answer the question is an implementation detail, so every internal
+    call's diagnostics are captured instead of printed. Returning the internal
+    error codes would leak the same detail, so failures are mapped onto the
+    published getFormUnit codes.
     """
     import contextlib
     import io
@@ -3243,17 +3251,18 @@ def _read_form_unit_state(cfg, token, app_id, form_id, form_number):
 
 
 def do_get_form_unit(cfg, token, biz_app_id, form_id=None, form_number=None):
-    """通过已注册的回退查询读取表单当前功能分组。
+    """Read a form's current functional group through registered fallback queries.
 
-    内部平台路由不属于公开 CLI 契约。formId 与 formNumber 二选一，同时提供时以 formId 为准。
+    Internal platform routes are deliberately not part of this public CLI contract.
+    formId and formNumber are alternatives; formId wins when both are present.
     """
     app_id = str(biz_app_id or "").strip()
     if not app_id:
-        raise ValueError("getFormUnit 需要 --bizAppId")
+        raise ValueError("getFormUnit requires --bizAppId")
     resolved_form_id = str(form_id or "").strip()
     resolved_form_number = str(form_number or "").strip()
     if not resolved_form_id and not resolved_form_number:
-        raise ValueError("getFormUnit 需要 --formId 或 --formNumber 之一")
+        raise ValueError("getFormUnit requires --formId or --formNumber")
 
     state, failure = _read_form_unit_state(
         cfg, token, app_id, resolved_form_id, resolved_form_number