flowbase-cli 0.1.13__tar.gz → 0.1.15__tar.gz

{flowbase_cli-0.1.13/src/flowbase_cli.egg-info → flowbase_cli-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.13
+Version: 0.1.15
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0
@@ -125,6 +125,7 @@ flowbase docs catalogs permissions        # function permission points + data sc
 flowbase docs catalogs dashboard-filters  # filter types + date-range presets
 flowbase docs catalogs page-components    # Page component shapes, placement, fields, and enums
 flowbase docs catalogs page-rules         # Page condition operators and action shapes
+flowbase docs catalogs forms              # custom form fields, rules, appearance, and settings
 flowbase docs catalogs id-prefixes        # resource ID prefix meanings
 flowbase docs catalogs icons              # icon guidance + examples
 ```
@@ -279,3 +280,12 @@ flowbase roles update rol_xxx --json-file role.json
 - `docs catalogs page-buttons`, `workflow-branches`, `approval-rules`, and `dashboard-runtime` describe complex configuration and runtime limits.
 
 Transport requests time out after 60 seconds. A lost write response has an unknown outcome: read the resource and current revision before retrying. The CLI never automatically retries writes.
+
+### Recent feature authoring
+
+- `flowbase docs catalogs planning`: tree/Gantt view snapshots, candidate queries and optimistic plan updates. Read a full view with `views list` before updating; preserve `displayMode`, `parentFieldId` and `gantt`.
+- `flowbase docs catalogs record-bundles`: initialize, atomically submit and recover a parent/detail submission. Reuse a submission ID only with the identical request body.
+- `flowbase docs catalogs formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Derived values are read-only.
+- `flowbase docs catalogs workflow-python`: record creation examples and failed-task retry. `workflows python-runtime OBJECT new` discovers current object bindings; `workflows executions` includes Python attempts, logs and `canRetry`.
+
+Use `records list OBJECT --view-id VIEW --view-layout` for tree/Gantt projections; the default remains a flat list. `records update` accepts `updatedAt` and `planViewId` in its JSON body for version-checked plan edits. Formula validation/trials require both metadata read and record read; workflow retry requires both metadata write and record write and explicit CLI confirmation (`--yes` in automation).

flowbase_cli-0.1.13/PKG-INFO → flowbase_cli-0.1.15/README.md

@@ -1,12 +1,3 @@
-Metadata-Version: 2.4
-Name: flowbase-cli
-Version: 0.1.13
-Summary: Command line client for the FlowBase OpenAPI
-Author: DeepFlowAI
-License: Apache-2.0
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-
 # FlowBase CLI
 
 `flowbase` is the official command line client for the FlowBase OpenAPI. It manages apps, objects, fields, views, custom pages, workflows, approval flows, dashboards, business records, roles, and configuration versions across the three FlowBase environments.
@@ -125,6 +116,7 @@ flowbase docs catalogs permissions        # function permission points + data sc
 flowbase docs catalogs dashboard-filters  # filter types + date-range presets
 flowbase docs catalogs page-components    # Page component shapes, placement, fields, and enums
 flowbase docs catalogs page-rules         # Page condition operators and action shapes
+flowbase docs catalogs forms              # custom form fields, rules, appearance, and settings
 flowbase docs catalogs id-prefixes        # resource ID prefix meanings
 flowbase docs catalogs icons              # icon guidance + examples
 ```
@@ -279,3 +271,12 @@ flowbase roles update rol_xxx --json-file role.json
 - `docs catalogs page-buttons`, `workflow-branches`, `approval-rules`, and `dashboard-runtime` describe complex configuration and runtime limits.
 
 Transport requests time out after 60 seconds. A lost write response has an unknown outcome: read the resource and current revision before retrying. The CLI never automatically retries writes.
+
+### Recent feature authoring
+
+- `flowbase docs catalogs planning`: tree/Gantt view snapshots, candidate queries and optimistic plan updates. Read a full view with `views list` before updating; preserve `displayMode`, `parentFieldId` and `gantt`.
+- `flowbase docs catalogs record-bundles`: initialize, atomically submit and recover a parent/detail submission. Reuse a submission ID only with the identical request body.
+- `flowbase docs catalogs formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Derived values are read-only.
+- `flowbase docs catalogs workflow-python`: record creation examples and failed-task retry. `workflows python-runtime OBJECT new` discovers current object bindings; `workflows executions` includes Python attempts, logs and `canRetry`.
+
+Use `records list OBJECT --view-id VIEW --view-layout` for tree/Gantt projections; the default remains a flat list. `records update` accepts `updatedAt` and `planViewId` in its JSON body for version-checked plan edits. Formula validation/trials require both metadata read and record read; workflow retry requires both metadata write and record write and explicit CLI confirmation (`--yes` in automation).

{flowbase_cli-0.1.13 → flowbase_cli-0.1.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flowbase-cli"
-version = "0.1.13"
+version = "0.1.15"
 description = "Command line client for the FlowBase OpenAPI"
 readme = "README.md"
 requires-python = ">=3.11"

{flowbase_cli-0.1.13 → flowbase_cli-0.1.15}/src/flowbase_cli/__init__.py

@@ -1,3 +1,3 @@
 """FlowBase OpenAPI CLI."""
 
-__version__ = "0.1.13"
+__version__ = "0.1.15"

{flowbase_cli-0.1.13 → flowbase_cli-0.1.15}/src/flowbase_cli/endpoints.py

@@ -22,6 +22,17 @@ class Endpoint:
 
 
 ENDPOINTS = (
+    Endpoint('formulas.sources', 'flowbase_formulas_sources', 'GET', '/objects/{object_id}/formula/sources', 'metadata:read', 'Discover scalar formula sources in the draft.', 'flowbase formulas sources obj_xxx'),
+    Endpoint('formulas.collections', 'flowbase_formulas_collections', 'GET', '/objects/{object_id}/formula/collections', 'metadata:read', 'Discover collection object and field IDs in the draft.', 'flowbase formulas collections obj_xxx'),
+    Endpoint('formulas.validate', 'flowbase_formulas_validate', 'POST', '/objects/{object_id}/formula/validate', 'metadata:read', 'Validate formula or rollup; trial also supported. Requires records:read. No writes.', 'flowbase formulas validate obj_xxx --json-file formula.json', request_body='{"constraints":{"expression":"amount * 2","resultType":"number","scale":2},"samples":{"amount":12.50},"trial":true}'),
+    Endpoint('records.formula-preview', 'flowbase_records_formula_preview', 'POST', '/objects/{object_id}/formula-preview', 'records:read', 'Preview runtime formulas without saving. New rollups remain pending; saved rollups use saved data.', 'flowbase records formula-preview obj_xxx --json-file preview.json', request_body='{"values":{"amount":12.50}}'),
+    Endpoint('records.bundle-init', 'flowbase_records_bundle_init', 'GET', '/objects/{object_id}/bundle/init', 'records:read', 'Load configuration and collection versions before an atomic write.', 'flowbase records bundle-init obj_xxx --record-id rec_xxx'),
+    Endpoint('records.bundle-save', 'flowbase_records_bundle_save', 'POST', '/objects/{object_id}/bundle', 'records:write', 'Atomically save parent and configured related rows. Reuse submissionId only for identical retries.', 'flowbase records bundle-save obj_xxx --json-file bundle.json', request_body='{"submissionId":"unique-submission-0001","configVersion":"from-bundle-init","values":{"name":"Order"},"components":[]}'),
+    Endpoint('records.bundle-status', 'flowbase_records_bundle_status', 'GET', '/objects/{object_id}/bundle/submissions/{submission_id}', 'records:read', "Query this API key's submission receipt after a timeout; unknown does not prove failure.", 'flowbase records bundle-status obj_xxx unique-submission-0001'),
+    Endpoint('records.hierarchy-candidates', 'flowbase_records_hierarchy_candidates', 'GET', '/objects/{object_id}/hierarchy/candidates', 'records:read', 'Discover eligible parent records, excluding self and descendants.', 'flowbase records hierarchy-candidates obj_xxx --field fld_parent --exclude rec_xxx'),
+    Endpoint('records.gantt-candidates', 'flowbase_records_gantt_candidates', 'GET', '/objects/{object_id}/gantt/candidates', 'records:read', 'Discover eligible predecessors, excluding cycles and hierarchy conflicts.', 'flowbase records gantt-candidates obj_xxx --field fld_predecessors --exclude rec_xxx'),
+    Endpoint('workflows.python-runtime', 'flowbase_workflows_python_runtime', 'GET', '/objects/{object_id}/workflows/{workflow_id}/python-runtime', 'metadata:read', 'Discover Python APIs and creation methods. Use workflow ID new before creation.', 'flowbase workflows python-runtime obj_xxx new'),
+    Endpoint('workflows.retry', 'flowbase_workflows_retry', 'POST', '/objects/{object_id}/workflows/{workflow_id}/executions/{execution_id}/retry', 'metadata:write', 'Retry a failed Python execution; also requires records:write.', 'flowbase workflows retry obj_xxx wfl_xxx exe_xxx --yes', requires_confirmation=True),
     Endpoint("pages.evaluate", "flowbase_pages_evaluate", "POST", "/pages/{page_id}/evaluate", "metadata:read", "Evaluate draft page rule effects on sample field-key values; no writes or visual rendering.", "flowbase pages evaluate pag_xxx --json-file values.json", request_body='{"values":{"done":true}}'),
     Endpoint("dashboards.run", "flowbase_dashboards_run", "POST", "/dashboards/{dashboard_id}/components/{component_id}/run", "metadata:read", "Run a saved draft component; also requires records:read. Inspect ok/output/error, not visual rendering.", "flowbase dashboards run dsh_xxx dcm_xxx --json-file filters.json", request_body='{"filterValues":{}}'),
     Endpoint("organization.employees", "flowbase_organization_employees", "GET", "/organization/employees", "metadata:read", "Paginated employee IDs/names; follow pages with --page, optionally --query.", "flowbase organization employees --page 1"),
@@ -169,6 +180,26 @@ ENDPOINTS = (
              )),
     Endpoint("dashboards.copy", "flowbase_dashboards_copy", "POST", "/dashboards/{dashboard_id}/copy", "metadata:write", "Copy a dashboard (not added to any app).", "flowbase dashboards copy dsh_xxx"),
     Endpoint("dashboards.delete", "flowbase_dashboards_delete", "POST", "/dashboards/{dashboard_id}/delete", "metadata:write", "Logically delete a dashboard (also removed from all apps).", "flowbase dashboards delete dsh_xxx --yes", True),
+    Endpoint("forms.list", "flowbase_forms_list", "GET", "/forms", "metadata:read", "List custom forms with collection status.", "flowbase forms list"),
+    Endpoint("forms.get", "flowbase_forms_get", "GET", "/forms/{form_id}", "metadata:read", "Get a custom form definition and its placeable field options. Read docs catalogs forms before update.", "flowbase forms get frm_xxx"),
+    Endpoint("forms.create", "flowbase_forms_create", "POST", "/forms", "metadata:write", "Create a custom form draft; object-required fields are pre-added.", "flowbase forms create --label 'Website inquiry' --key website_inquiry --object-id obj_xxx",
+             request_body='{"label":"Website inquiry","key":"website_inquiry","objectId":"obj_xxx","description":""}'),
+    Endpoint("forms.update", "flowbase_forms_update", "PUT", "/forms/{form_id}", "metadata:write", "Update a custom form draft (full snapshot: fields, rules, appearance, settings). Read docs catalogs forms first.", "flowbase forms update frm_xxx --json-file form.json",
+             request_body=(
+                 '{"label":"Website inquiry","description":"","baseRevision":3,'
+                 '"fields":[{"fieldId":"fld_xxx","label":"","description":"","state":"required","prefill":false}],'
+                 '"rules":[],'
+                 '"appearance":{"title":"Website inquiry","description":"","logo":null,"cover":null,"themeColor":"#171717",'
+                 '"background":"gray","submitText":"提交","language":"zh-CN"},'
+                 '"settings":{"afterSubmit":"message","successTitle":"提交成功","successBody":"感谢你的填写",'
+                 '"allowResubmit":true,"redirectUrl":"","deadline":null,"limit":null}}'
+             )),
+    Endpoint("forms.copy", "flowbase_forms_copy", "POST", "/forms/{form_id}/copy", "metadata:write", "Copy a custom form (collection state is not copied).", "flowbase forms copy frm_xxx"),
+    Endpoint("forms.delete", "flowbase_forms_delete", "POST", "/forms/{form_id}/delete", "metadata:write", "Logically delete a custom form.", "flowbase forms delete frm_xxx --yes", True),
+    Endpoint("forms.share.get", "flowbase_forms_share_get", "GET", "/forms/{form_id}/share", "metadata:read", "Get the public link and collection state in this environment.", "flowbase forms share frm_xxx"),
+    Endpoint("forms.share.set-accepting", "flowbase_forms_share_set_accepting", "PUT", "/forms/{form_id}/share/accepting", "metadata:write", "Turn public collection on or off in this environment (immediate, not a draft change).", "flowbase forms set-accepting frm_xxx --on",
+             request_body='{"accepting":true}'),
+    Endpoint("forms.share.reset", "flowbase_forms_share_reset", "POST", "/forms/{form_id}/share/reset", "metadata:write", "Reset the public link; the old link stops working immediately.", "flowbase forms reset-link frm_xxx --yes", True),
     Endpoint("objects.list", "flowbase_objects_list", "GET", "/objects", "metadata:read", "List object metadata.", "flowbase objects list"),
     Endpoint("objects.get", "flowbase_objects_get", "GET", "/objects/{object_id}", "metadata:read", "Get object and field metadata.", "flowbase objects get obj_xxx"),
     Endpoint("objects.create", "flowbase_objects_create", "POST", "/objects", "metadata:write", "Create an object draft.", "flowbase objects create --json-file object.json",
@@ -225,15 +256,15 @@ ENDPOINTS = (
                  '"filters":['
                  '{"fieldId":"fld_status","operator":"eq","value":"opt_xxx"},'
                  '{"fieldId":"fld_done","operator":"is_true"}'
-                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null}'
+                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null,"displayMode":"table","parentFieldId":null,"gantt":{}}'
              )),
-    Endpoint("views.update", "flowbase_views_update", "PUT", "/objects/{object_id}/views/{view_id}", "metadata:write", "Update an object view draft.", "flowbase views update obj_xxx viw_xxx --json-file view.json",
+    Endpoint("views.update", "flowbase_views_update", "PUT", "/objects/{object_id}/views/{view_id}", "metadata:write", "Update a complete view snapshot. Preserve displayMode, parentFieldId and gantt from views.list; omission resets to table.", "flowbase views update obj_xxx viw_xxx --json-file view.json",
              request_body=(
                  '{"baseRevision":4,"name":"Active","enabled":true,"match":"all",'
                  '"filters":['
                  '{"fieldId":"fld_status","operator":"eq","value":"opt_xxx"},'
                  '{"fieldId":"fld_done","operator":"is_true"}'
-                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null}'
+                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null,"displayMode":"table","parentFieldId":null,"gantt":{}}'
              )),
     Endpoint("views.reorder", "flowbase_views_reorder", "PUT", "/objects/{object_id}/views/order", "metadata:write", "Reorder object views.", "flowbase views reorder obj_xxx --json '{\"baseRevision\":4,\"viewIds\":[\"viw_xxx\"]}'",
              request_body='{"baseRevision":4,"viewIds":["viw_a","viw_b"]}'),
@@ -563,7 +594,8 @@ ENDPOINT_BY_KEY = {endpoint.key: endpoint for endpoint in ENDPOINTS}
 
 # Closed-domain catalogs for offline authoring of complex request bodies.
 # Keep in sync with server registries (field types, workflow/approval node kinds,
-# permission points, dashboard filter presets, page component kinds).
+# permission points, dashboard filter presets, page component kinds, form
+# snapshot validation).
 # Icons intentionally reference the server file because the full Tabler set is large.
 _PERMISSIONS = ("required", "optional", "readonly", "hidden")
 _TEXT_FILTERS = ("eq", "neq", "contains", "not_contains", "is_empty", "is_not_empty")
@@ -604,6 +636,17 @@ def _field_type(
 
 
 FIELD_TYPES = (
+    _field_type(
+        "rollup", ("source", "operation", "resultType", "scale", "currency", "unit"),
+        writable=False, record_value="derived scalar | null; omit on writes; see formulaStates",
+        extra={"permissions": ["readonly", "hidden"], "operations": ["sum", "avg", "count", "count_values", "min", "max"], "sourceModes": ["reverse", "forward", "children"]},
+    ),
+    _field_type(
+        "formula", ("expression", "resultType", "scale", "currency", "bindings", "languageVersion", "collections"),
+        writable=False, record_value="derived scalar | null; omit on writes; see formulaStates for failures",
+        extra={"permissions": ["readonly", "hidden"], "resultTypes": ["number", "number.currency", "number.percent", "text.singleLine", "date", "boolean"],
+               "createExample": {"label": "Total", "key": "total", "description": "Calculated total", "type": "formula", "typeVersion": "v1", "permission": "readonly", "constraints": {"expression": "quantity * unit_price", "resultType": "number", "scale": 2}}},
+    ),
     _field_type(
         "text.singleLine", ("maxLength", "minLength", "placeholder", "unique"),
         filter_operators=_TEXT_FILTERS, record_value="string | null",
@@ -802,7 +845,10 @@ AUTHORING = {
         ],
     },
     "documentationKeys": "docs list returns endpoint keys. Use apps.objects.add for apps add-objects; docs show includes the CLI example.",
-    "requiredUpdateFields": {"apps.update": ["label", "icon", "color"]},
+    "requiredUpdateFields": {
+        "apps.update": ["label", "icon", "color"],
+        "forms.update": ["label", "appearance", "settings"],
+    },
     "requiredCreateFields": {
         "objects.create": ["label", "key", "description"],
         "fields.create": ["label", "key", "description", "type"],
@@ -811,22 +857,27 @@ AUTHORING = {
         "pages.create": ["baseRevision", "page"],
         "records.create": ["values"],
         "print-templates.create": ["name", "html"],
+        "forms.create": ["label", "key", "objectId"],
     },
     "draftRevision": {
         "notReturnedBy": ["objects.get", "objects.list", "apps.get", "apps.list"],
         "returnedBy": [
             "views.list", "pages.list", "pages.get",
             "print-templates.list", "print-templates.get",
+            "forms.get",
             "every metadata write response (draftRevision)",
         ],
         "note": "Capture draftRevision from the last write or from views.list/pages.list/print-templates.list before writes.",
     },
     "readThenWrite": (
-        "For update of views/pages/dashboards/fields with constraints: get the snapshot, "
-        "edit it, set baseRevision from draftRevision. fields.update.constraints is a full replace; "
-        "sending {} wipes options. print-templates.update is partial: send only changed fields, "
-        "baseRevision, and baseUpdatedAt copied from updatedAt. Resending id, key, enabled, "
-        "updatedAt, or draftRevision is rejected."
+        "For update of views/pages/dashboards/forms/fields with constraints: get the snapshot, "
+        "edit it, set baseRevision from draftRevision. forms.update unwraps forms.get: send "
+        "label, description, fields, rules, appearance, settings, and baseRevision; omit the "
+        "form wrapper, id, key, objectId, updatedAt, and fieldOptions. Omitting fields or rules "
+        "clears them. fields.update.constraints is a full replace; sending {} wipes options. "
+        "print-templates.update is partial: send only changed fields, baseRevision, and "
+        "baseUpdatedAt copied from updatedAt. Resending id, key, enabled, updatedAt, or "
+        "draftRevision is rejected."
     ),
     "recordsNeedReleasedMetadata": (
         "On production, records.create/list/get use the released runtime, not the current draft. "
@@ -840,6 +891,7 @@ AUTHORING = {
         "dashboards.run": "{ok,output,error,logs,durationMs,cached,mode:draft-preview}; inspect ok and error.",
         "apps.create": "{appId,draftRevision}",
         "dashboards.create": "{dashboardId,draftRevision}",
+        "forms.create": "{formId,draftRevision}",
         "workflows.create": "{workflowId,draftRevision}",
         "approvals.create": "{approvalId,draftRevision}",
         "print-templates.create": "{templateId,draftRevision}",
@@ -876,6 +928,10 @@ AUTHORING = {
             "wrong": "select/lookup filter or record value uses the display label",
             "right": "Use opt_/rec_/emp_ ids from objects.get / records.get.",
         },
+        {
+            "wrong": "forms update with the forms.get body, or fields omitted",
+            "right": "Unwrap form, keep every placed field, and set baseRevision from draftRevision. See docs catalogs forms.",
+        },
         {
             "wrong": "records.list.values is the full record",
             "right": "List is a column projection. records.get for all field keys.",
@@ -984,7 +1040,7 @@ APPROVAL_NODE_TYPES = (
 )
 
 FUNCTION_PERMISSIONS = (
-    "workspace.access", "app.manage", "object.manage", "dashboard.manage",
+    "workspace.access", "app.manage", "object.manage", "dashboard.manage", "form.manage",
     "version.manage", "org.manage", "system.manage",
 )
 
@@ -1065,7 +1121,8 @@ PAGE_COMPONENTS = {
                 "kind", "label", "hideLabel", "objectId", "relationFieldId",
                 "columnFieldIds", "sort", "limit", "showViewAll", "createAction",
             ),
-            "optionalKeys": ("id", "filters", "carryIns"),
+            "optionalKeys": ("id", "filters", "carryIns", "editMode", "editOptions", "editColumns"),
+            "editMode": {"withParent": "Atomic editing on create/detail pages; initialize with records bundle-init, then bundle-save."},
             "limit": (5, 10, 20),
             "sortDirections": ("asc", "desc"),
             "carryInSources": (
@@ -1285,7 +1342,8 @@ RESOURCE_ID_PREFIXES = {
     "reg_": "page region", "cmp_": "page component",
     "dsh_": "dashboard", "dcm_": "dashboard component", "rol_": "role",
     "rec_": "record", "att_": "attachment", "emp_": "employee", "dep_": "department",
-    "ptp_": "print template",
+    "ptp_": "print template", "frm_": "custom form", "fim_": "form image",
+    "rule_": "form or page rule",
 }
 
 WORKFLOW_BRANCHES = {
@@ -1379,7 +1437,136 @@ PRINT_TEMPLATES = {
     "verify": "The management CLI cannot render a template. get returns the source. A saved {{ }} that names the wrong key prints blank. There is no print-templates run command.",
 }
 
+FORMS = {
+    "command": "flowbase docs catalogs forms",
+    "readFirst": (
+        "forms get returns form, fieldOptions, and draftRevision. "
+        "fieldOptions[].availability is the placement contract: placeable, reason, states, "
+        "preset, presetRequired, prefill, plus objectRequired and usableDefault. "
+        "Use field IDs from fieldOptions, never field keys."
+    ),
+    "write": {
+        "create": (
+            "Requires label, key, and objectId. description defaults to empty. "
+            "Placeable object-required fields are pre-added. key starts with a lowercase letter, "
+            "contains only lowercase letters, digits, and underscores, max 50, and cannot change later."
+        ),
+        "update": (
+            "Full snapshot. Requires label, appearance, and settings. "
+            "fields and rules default to [] and clear the form when omitted. "
+            "Copy draftRevision to baseRevision. Unwrap forms.get: do not send the form wrapper, "
+            "id, key, objectId, updatedAt, or fieldOptions."
+        ),
+        "channel": (
+            "set-accepting and reset-link take effect immediately in this environment and are not "
+            "draft changes. copy does not copy collection state or the public link. delete and "
+            "reset-link require --yes."
+        ),
+    },
+    "limits": {
+        "formsPerEnvironment": 200,
+        "fields": 100,
+        "rules": 50,
+        "label": "1 to 50 characters",
+        "description": "max 200 characters",
+        "conditionsPerRule": "1 to 10",
+    },
+    "field": {
+        "requiredKeys": ["fieldId", "label", "description", "state", "prefill"],
+        "optionalKeys": ["preset"],
+        "label": "Display override. Empty string keeps the object field label. Max 100.",
+        "description": "Max 500. Empty string is allowed.",
+        "state": (
+            "One of availability.states. Ordinary fields use required, optional, readonly, hidden. "
+            "lookup.record, lookup.record.multiple, lookup.employee, and lookup.department are "
+            "hidden only. attachment cannot be readonly."
+        ),
+        "prefill": "true only when availability.prefill is true. Hidden-only, attachment, and text.rich cannot be prefilled.",
+        "preset": (
+            "Omit the key when there is no preset. Required when availability.presetRequired. "
+            "A fixed value uses the record value shape from record-values. "
+            "A dynamic preset is {\"mode\":\"dynamic\",\"value\":\"<dynamic default>\"}; currentEmployee is rejected."
+        ),
+        "objectRequired": (
+            "Every placeable object-required field must stay in fields. It cannot be optional. "
+            "readonly or hidden needs a preset unless usableDefault is true."
+        ),
+        "fillable": "At least one placed field is required or optional, or an enabled rule sets one of those states.",
+    },
+    "rule": {
+        "requiredKeys": ["name", "enabled", "match", "conditions", "actions"],
+        "optionalKeys": ["id"],
+        "id": "Omit id, or send a value that does not start with rule_, to allocate a new rule_ id. Preserve an existing rule_ id on update.",
+        "name": "1 to 50 characters, unique in the form.",
+        "match": ["all", "any"],
+        "conditions": (
+            "Same operators as page-rules. Candidates are placed fields that are not "
+            "lookup.record, lookup.record.multiple, lookup.employee, or lookup.department."
+        ),
+        "actions": (
+            "Only setFieldState: {\"type\":\"setFieldState\",\"fieldId\":\"fld_...\",\"state\":\"required\"}. "
+            "state must be in that field's availability.states. No component visibility."
+        ),
+    },
+    "appearance": {
+        "requiredKeys": [
+            "title", "description", "logo", "cover", "themeColor",
+            "background", "submitText", "language",
+        ],
+        "title": "1 to 100 characters.",
+        "description": "Max 2000 characters.",
+        "logo": "null or an existing fim_ id. The management CLI cannot upload images.",
+        "cover": "null or an existing fim_ id. The management CLI cannot upload images.",
+        "themeColor": "#RRGGBB",
+        "background": ["gray", "white", "tint"],
+        "submitText": "Max 20 characters. Empty string is allowed.",
+        "language": ["zh-CN", "en"],
+    },
+    "settings": {
+        "requiredKeys": [
+            "afterSubmit", "successTitle", "successBody", "allowResubmit",
+            "redirectUrl", "deadline", "limit",
+        ],
+        "afterSubmit": ["message", "redirect"],
+        "successTitle": "Max 50 characters.",
+        "successBody": "Max 500 characters.",
+        "redirectUrl": "An https URL when afterSubmit is redirect, max 2048. Otherwise an empty string is allowed.",
+        "deadline": "null, or an ISO-8601 datetime with a timezone. A newly set deadline cannot be in the past.",
+        "limit": "null, or an integer from 1 to 1000000.",
+    },
+    "collectStatus": ["inactive", "invalid", "closed", "deadline", "full", "collecting"],
+    "notInCli": (
+        "Public form read, submit, and attachment upload need no API key and are not management commands. "
+        "Logo and cover upload exist only on the signed-in admin API."
+    ),
+}
+
 CATALOGS = {
+    "planning": {
+        "viewUpdate": "Read views.list, preserve the complete snapshot, then views.update with baseRevision. Omitting displayMode/parentFieldId/gantt resets them to table/null/{}.",
+        "tree": {"displayMode": "tree", "parentFieldId": "fld_parent", "gantt": {}},
+        "gantt": {"displayMode": "gantt", "parentFieldId": None, "gantt": {"startFieldId": "fld_start", "endFieldId": "fld_end", "predecessorFieldId": "fld_dependencies"}},
+        "read": "records list OBJECT --view-id VIEW --view-layout; use --parent, --root, --locate and --hierarchy-version for tree navigation. Default is flat.",
+        "write": {"values": {"start": "2026-10-24", "end": "2026-10-25"}, "planViewId": "viw_plan", "updatedAt": "from-records-get"},
+        "candidates": "records hierarchy-candidates / gantt-candidates use field IDs. Record values use field keys.",
+    },
+    "record-bundles": {
+        "steps": ["Configure relatedList editMode=withParent on the default create/detail page.", "records bundle-init OBJECT [--record-id RECORD] returns configVersion, updatedAt and component collection versions.", "records bundle-save OBJECT --json-file bundle.json commits the entire write set or rolls back.", "After a timeout, bundle-status OBJECT SUBMISSION; retry only the identical body with the same submissionId."],
+        "example": {"submissionId": "unique-submission-0001", "configVersion": "from-init", "recordId": "rec_parent", "updatedAt": "from-init", "values": {}, "components": [{"componentId": "cmp_lines", "version": 1, "rows": [{"clientId": "line-1", "operation": "create", "values": {"quantity": 2}}]}]},
+        "rules": "Copy every visible component and its version. Update/delete rows also require recordId and updatedAt. Relation is injected by the server; omit it from row values. API-key receipts are isolated per key. Conflict: reload, reconcile and use a new submissionId. Max 200 resulting detail rows.",
+    },
+    "formula-authoring": {
+        "steps": ["formulas sources OBJECT discovers scalar paths; formulas collections OBJECT discovers stable object/field IDs.", "formulas validate OBJECT --json-file formula.json validates constraints; trial=true uses samples or a saved recordId.", "fields create/update saves metadata. records formula-preview previews runtime values without saving."],
+        "rollupExample": {"fieldType": "rollup", "constraints": {"source": {"mode": "reverse", "objectId": "obj_lines", "relationFieldId": "fld_order", "fieldId": "fld_amount"}, "operation": "sum", "resultType": "number", "scale": 2}, "trial": True, "recordId": "rec_order"},
+        "collectionExample": {"expression": "sum(lines)", "resultType": "number", "scale": 2, "languageVersion": 2, "collections": {"lines": {"mode": "reverse", "objectId": "obj_lines", "relationFieldId": "fld_order", "fieldId": "fld_amount"}}},
+        "readOnly": "formula/rollup values cannot be written, filtered, sorted or SQL-aggregated through the employee CLI. Read results and formulaStates instead.",
+    },
+    "workflow-python": {
+        "discover": "workflows python-runtime OBJECT new (or WORKFLOW) returns creationObjects, relation bindings and limits.",
+        "example": 'import flowbase\n\ndef run():\n    first = flowbase.records.create(object="task", values={"title": "Review"})\n    others = flowbase.records.create_many(object="task", records=[{"title": "Prepare"}])\n    flowbase.records.update(first, values={"title": "Review order"})\n',
+        "atomicity": "Creates and updates commit together after successful execution. Use object/field keys, writable ordinary fields, and returned handles. At most 100 created+updated records.",
+        "retry": "workflows executions OBJECT WORKFLOW lists results; workflows retry OBJECT WORKFLOW EXECUTION --yes retries eligible failed tasks using the original task contract.",
+    },
     "workflow-branches": WORKFLOW_BRANCHES,
     "approval-rules": APPROVAL_RULES,
     "page-buttons": PAGE_BUTTONS,
@@ -1402,6 +1589,7 @@ CATALOGS = {
     },
     "page-components": PAGE_COMPONENTS,
     "page-rules": PAGE_RULES,
+    "forms": FORMS,
     "id-prefixes": RESOURCE_ID_PREFIXES,
     "icons": {
         "note": "6146 Tabler icon names are supported; any Icon* name from the "

{flowbase_cli-0.1.13 → flowbase_cli-0.1.15}/src/flowbase_cli/guide.py

@@ -8,7 +8,8 @@ GUIDE = {
         "flowbase apps list；flowbase objects list：发现已有应用和对象，优先复用，不猜测 ID。",
         "flowbase objects get <object_id>：读取字段 key、类型、约束和真实选项 ID；关联字段继续读取目标对象。",
         "flowbase docs catalogs authoring；flowbase docs list；flowbase docs show <endpoint_key>：查请求和更新方式。",
-        "配置页面前读取 pages options、page-components、page-rules、page-buttons；配置流程前读取 workflow-nodes、workflow-branches 或 approval-rules；配置打印模板前读取 print-templates。",
+        "配置页面前读取 pages options、page-components、page-rules、page-buttons；配置流程前读取 workflow-nodes、workflow-branches 或 approval-rules；配置打印模板前读取 print-templates；配置自定义表单前读取 forms。",
+        "表单先 forms get，按目录把快照拆成 label、fields、rules、appearance、settings 再 update，baseRevision 用返回的 draftRevision。对象必填且可放入的字段必须保留。set-accepting 与 reset-link 立即生效，不进草稿。",
         "先 get 再修改，保留未修改的配置。按目录转换更新 envelope；从最近读取或写入返回值获取 draftRevision，作为 baseRevision。",
         "写后回读验证。records create 返回 recordId，再 records get；values 使用字段 key，选择和关联使用真实 ID。",
         "遍历列表的所有分页。records list --view-id <view_id> 验证特定视图，records get 获取完整记录。",
@@ -31,6 +32,7 @@ GUIDE = {
         "docs/guide 离线可读；业务调用需要权限和已启用环境。",
         "页面规则求值不是浏览器渲染；仪表盘输出验证不是图表视觉验证。打印模板 get 返回源码，管理 CLI 不能生成打印内容；写错的 {{ }} 会保存成功并打印成空白。",
         "组织候选只读；不能通过管理 CLI 替员工做审批决定。",
+        "公开表单的读取、提交和附件上传不是管理命令。logo 与 cover 只能引用已有 fim_ 图片，管理 CLI 不能上传图片。",
         "删除对象/字段/页面是逻辑删除；没有物理 purge，审计与回收站会保留。",
     ],
 }

{flowbase_cli-0.1.13 → flowbase_cli-0.1.15}/src/flowbase_cli/main.py

@@ -522,6 +522,40 @@ def handle_dashboards(args: argparse.Namespace) -> int:
     )
 
 
+def handle_forms(args: argparse.Namespace) -> int:
+    action = args.forms_action
+    if action == "list":
+        return run_request(args, "forms.list")
+    if action == "create":
+        body = _payload_from_args(
+            args,
+            {
+                "label": args.label,
+                "key": args.key,
+                "objectId": args.object_id,
+                "description": args.description,
+            },
+            ("label", "key", "objectId"),
+        )
+        return run_request(args, "forms.create", body=body)
+    path_params = {"form_id": args.form_id}
+    if action == "get":
+        return run_request(args, "forms.get", path_params=path_params)
+    if action == "update":
+        body = load_json_payload(args.json, args.json_file)
+        require_fields(body, "label", "appearance", "settings")
+        return run_request(args, "forms.update", path_params=path_params, body=body)
+    if action == "copy":
+        return run_request(args, "forms.copy", path_params=path_params)
+    if action == "share":
+        return run_request(args, "forms.share.get", path_params=path_params)
+    if action == "set-accepting":
+        return run_request(args, "forms.share.set-accepting", path_params=path_params, body={"accepting": args.on})
+    if action == "reset-link":
+        return run_request(args, "forms.share.reset", path_params=path_params)
+    return run_request(args, "forms.delete", path_params=path_params)
+
+
 def handle_groups(args: argparse.Namespace) -> int:
     action = args.groups_action
     path = {"app_id": args.app_id}
@@ -647,6 +681,10 @@ def handle_workflows(args: argparse.Namespace) -> int:
     path = {"object_id": args.object_id}
     if hasattr(args, "workflow_id"):
         path["workflow_id"] = args.workflow_id
+    if action in ("python-runtime", "retry"):
+        if action == "retry":
+            path["execution_id"] = args.execution_id
+        return run_request(args, f"workflows.{action}", path_params=path)
     if action == "list":
         return run_request(args, "workflows.list", path_params=path)
     if action == "get":
@@ -907,8 +945,26 @@ def handle_environments(args: argparse.Namespace) -> int:
     return 0
 
 
+def handle_formulas(args: argparse.Namespace) -> int:
+    body = load_json_payload(args.json, args.json_file) if args.formulas_action == "validate" else None
+    return run_request(args, f"formulas.{args.formulas_action}", path_params={"object_id": args.object_id}, body=body)
+
+
 def handle_records(args: argparse.Namespace) -> int:
     action = args.records_action
+    if action in ("bundle-init", "bundle-status", "bundle-save", "formula-preview", "hierarchy-candidates", "gantt-candidates"):
+        path = {"object_id": args.object_id}
+        query = {}
+        body = None
+        if action == "bundle-init":
+            query = {"record_id": args.record_id}
+        elif action == "bundle-status":
+            path["submission_id"] = args.submission_id
+        elif action in ("bundle-save", "formula-preview"):
+            body = load_json_payload(args.json, args.json_file)
+        else:
+            query = {"field": args.field, "exclude": args.exclude, "q": args.query}
+        return run_request(args, f"records.{action}", path_params=path, query=query, body=body)
     path = {"object_id": args.object_id}
     if action == "upload-attachment":
         body, content_type = multipart_upload(args.file)
@@ -938,7 +994,7 @@ def handle_records(args: argparse.Namespace) -> int:
     if hasattr(args, "record_id"):
         path["record_id"] = args.record_id
     if action == "list":
-        return run_request(args, "records.list", path_params=path, query={"page": args.page, "viewId": args.view_id})
+        return run_request(args, "records.list", path_params=path, query={"page": args.page, "viewId": args.view_id, **({"flat": "false"} if args.view_layout else {}), **{key: value for key, value in {"root": args.root, "parent": args.parent, "locate": args.locate, "hierarchyVersion": args.hierarchy_version}.items() if value is not None}})
     if action == "get" or action == "delete":
         return run_request(args, f"records.{action}", path_params=path)
     body = load_json_payload(args.json, args.json_file)
@@ -1136,6 +1192,37 @@ def build_parser() -> argparse.ArgumentParser:
     add_yes(dashboard_delete)
     dashboards.set_defaults(handler=handle_dashboards)
 
+    forms = groups.add_parser("forms", help="Manage custom forms (public collection links).")
+    form_actions = forms.add_subparsers(dest="forms_action", required=True)
+    form_actions.add_parser("list")
+    form_get = form_actions.add_parser("get")
+    form_get.add_argument("form_id")
+    form_create = form_actions.add_parser("create")
+    form_create.add_argument("--label")
+    form_create.add_argument("--key")
+    form_create.add_argument("--object-id")
+    form_create.add_argument("--description")
+    add_json_args(form_create, endpoint_key="forms.create")
+    form_update = form_actions.add_parser("update")
+    form_update.add_argument("form_id")
+    add_json_args(form_update, endpoint_key="forms.update")
+    form_copy = form_actions.add_parser("copy")
+    form_copy.add_argument("form_id")
+    form_delete = form_actions.add_parser("delete")
+    form_delete.add_argument("form_id")
+    add_yes(form_delete)
+    form_share = form_actions.add_parser("share", help="Show the public link and collection state.")
+    form_share.add_argument("form_id")
+    form_accepting = form_actions.add_parser("set-accepting", help="Turn public collection on or off (immediate).")
+    form_accepting.add_argument("form_id")
+    accepting_group = form_accepting.add_mutually_exclusive_group(required=True)
+    accepting_group.add_argument("--on", dest="on", action="store_true")
+    accepting_group.add_argument("--off", dest="on", action="store_false")
+    form_reset = form_actions.add_parser("reset-link", help="Reset the public link; the old link stops working.")
+    form_reset.add_argument("form_id")
+    add_yes(form_reset)
+    forms.set_defaults(handler=handle_forms)
+
     app_groups = groups.add_parser("groups", help="Manage app object groups.")
     group_actions = app_groups.add_subparsers(dest="groups_action", required=True)
     group_create = group_actions.add_parser("create")
@@ -1271,6 +1358,14 @@ def build_parser() -> argparse.ArgumentParser:
     workflow_executions.add_argument("object_id")
     workflow_executions.add_argument("workflow_id")
     workflow_executions.add_argument("--result", choices=("success", "failure"))
+    runtime_help = workflow_actions.add_parser("python-runtime")
+    runtime_help.add_argument("object_id")
+    runtime_help.add_argument("workflow_id", help="Use new for a workflow not yet created.")
+    retry = workflow_actions.add_parser("retry")
+    retry.add_argument("object_id")
+    retry.add_argument("workflow_id")
+    retry.add_argument("execution_id")
+    add_yes(retry)
     workflows.set_defaults(handler=handle_workflows)
 
     approvals = groups.add_parser("approvals", help="Manage object approval flow metadata.")
@@ -1408,6 +1503,11 @@ def build_parser() -> argparse.ArgumentParser:
     record_list = record_actions.add_parser("list")
     record_list.add_argument("object_id")
     record_list.add_argument("--page", type=int, default=1)
+    record_list.add_argument("--view-layout", action="store_true", help="Return tree/Gantt projection instead of the default flat list.")
+    record_list.add_argument("--root")
+    record_list.add_argument("--parent")
+    record_list.add_argument("--locate")
+    record_list.add_argument("--hierarchy-version")
     record_list.add_argument("--view-id", help="Select a view returned by views list.")
     record_get = record_actions.add_parser("get")
     record_get.add_argument("object_id")
@@ -1432,6 +1532,19 @@ def build_parser() -> argparse.ArgumentParser:
     record_delete.add_argument("object_id")
     record_delete.add_argument("record_id")
     add_yes(record_delete)
+    for action in ("bundle-init", "bundle-status", "bundle-save", "formula-preview", "hierarchy-candidates", "gantt-candidates"):
+        item = record_actions.add_parser(action)
+        item.add_argument("object_id")
+        if action == "bundle-init":
+            item.add_argument("--record-id")
+        elif action == "bundle-status":
+            item.add_argument("submission_id")
+        elif action in ("bundle-save", "formula-preview"):
+            add_json_args(item, endpoint_key=f"records.{action}")
+        else:
+            item.add_argument("--field", required=True, help="Stable field ID.")
+            item.add_argument("--exclude", required=action == "gantt-candidates", default="")
+            item.add_argument("--query", default="")
     records.set_defaults(handler=handle_records)
 
     roles = groups.add_parser("roles", help="Manage organization roles (production Host only).")
@@ -1451,6 +1564,14 @@ def build_parser() -> argparse.ArgumentParser:
     role_delete.add_argument("role_id")
     add_yes(role_delete)
     roles.set_defaults(handler=handle_roles)
+    formulas = groups.add_parser("formulas", help="Discover, validate and trial formula/rollup fields.")
+    formula_actions = formulas.add_subparsers(dest="formulas_action", required=True)
+    for action in ("sources", "collections", "validate"):
+        item = formula_actions.add_parser(action)
+        item.add_argument("object_id")
+        if action == "validate":
+            add_json_args(item, endpoint_key="formulas.validate")
+    formulas.set_defaults(handler=handle_formulas)
     return parser
 
 

flowbase_cli-0.1.13/README.md → flowbase_cli-0.1.15/src/flowbase_cli.egg-info/PKG-INFO

@@ -1,3 +1,12 @@
+Metadata-Version: 2.4
+Name: flowbase-cli
+Version: 0.1.15
+Summary: Command line client for the FlowBase OpenAPI
+Author: DeepFlowAI
+License: Apache-2.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
 # FlowBase CLI
 
 `flowbase` is the official command line client for the FlowBase OpenAPI. It manages apps, objects, fields, views, custom pages, workflows, approval flows, dashboards, business records, roles, and configuration versions across the three FlowBase environments.
@@ -116,6 +125,7 @@ flowbase docs catalogs permissions        # function permission points + data sc
 flowbase docs catalogs dashboard-filters  # filter types + date-range presets
 flowbase docs catalogs page-components    # Page component shapes, placement, fields, and enums
 flowbase docs catalogs page-rules         # Page condition operators and action shapes
+flowbase docs catalogs forms              # custom form fields, rules, appearance, and settings
 flowbase docs catalogs id-prefixes        # resource ID prefix meanings
 flowbase docs catalogs icons              # icon guidance + examples
 ```
@@ -270,3 +280,12 @@ flowbase roles update rol_xxx --json-file role.json
 - `docs catalogs page-buttons`, `workflow-branches`, `approval-rules`, and `dashboard-runtime` describe complex configuration and runtime limits.
 
 Transport requests time out after 60 seconds. A lost write response has an unknown outcome: read the resource and current revision before retrying. The CLI never automatically retries writes.
+
+### Recent feature authoring
+
+- `flowbase docs catalogs planning`: tree/Gantt view snapshots, candidate queries and optimistic plan updates. Read a full view with `views list` before updating; preserve `displayMode`, `parentFieldId` and `gantt`.
+- `flowbase docs catalogs record-bundles`: initialize, atomically submit and recover a parent/detail submission. Reuse a submission ID only with the identical request body.
+- `flowbase docs catalogs formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Derived values are read-only.
+- `flowbase docs catalogs workflow-python`: record creation examples and failed-task retry. `workflows python-runtime OBJECT new` discovers current object bindings; `workflows executions` includes Python attempts, logs and `canRetry`.
+
+Use `records list OBJECT --view-id VIEW --view-layout` for tree/Gantt projections; the default remains a flat list. `records update` accepts `updatedAt` and `planViewId` in its JSON body for version-checked plan edits. Formula validation/trials require both metadata read and record read; workflow retry requires both metadata write and record write and explicit CLI confirmation (`--yes` in automation).

{flowbase_cli-0.1.13 → flowbase_cli-0.1.15}/src/flowbase_cli.egg-info/SOURCES.txt

@@ -10,4 +10,5 @@ src/flowbase_cli.egg-info/dependency_links.txt
 src/flowbase_cli.egg-info/entry_points.txt
 src/flowbase_cli.egg-info/top_level.txt
 tests/test_autonomy.py
-tests/test_cli.py
+tests/test_cli.py
+tests/test_recent_commands.py

{flowbase_cli-0.1.13 → flowbase_cli-0.1.15}/tests/test_cli.py

@@ -191,7 +191,7 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertEqual(code, 0)
         field_types = json.loads(stdout.getvalue())
         type_names = {item["type"] for item in field_types}
-        self.assertEqual(len(field_types), 25)
+        self.assertEqual(len(field_types), 27)
         self.assertIn("select.single", type_names)
         self.assertIn("lookup.employee", type_names)
         self.assertTrue({
@@ -335,6 +335,22 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertEqual(prefixes["reg_"], "page region")
         self.assertEqual(prefixes["cmp_"], "page component")
         self.assertEqual(prefixes["ptp_"], "print template")
+        self.assertEqual(prefixes["frm_"], "custom form")
+        self.assertEqual(prefixes["fim_"], "form image")
+
+        stdout = io.StringIO()
+        with patch("sys.stdout", stdout):
+            code = main(["docs", "catalogs", "forms"])
+        self.assertEqual(code, 0)
+        forms = json.loads(stdout.getvalue())
+        self.assertEqual(
+            forms["field"]["requiredKeys"],
+            ["fieldId", "label", "description", "state", "prefill"],
+        )
+        self.assertEqual(forms["appearance"]["background"], ["gray", "white", "tint"])
+        self.assertEqual(forms["settings"]["afterSubmit"], ["message", "redirect"])
+        self.assertIn("setFieldState", forms["rule"]["actions"])
+        self.assertIn("forms", names)
 
     def test_docs_list_marks_body_and_confirmation(self):
         stdout = io.StringIO()

flowbase_cli-0.1.15/tests/test_recent_commands.py

@@ -0,0 +1,30 @@
+"""New discovery commands and retry confirmation remain usable without a browser."""
+import io
+from unittest.mock import patch
+
+import pytest
+
+from flowbase_cli.main import main
+
+
+@pytest.mark.parametrize('args,endpoint,path,query', [
+    (['formulas', 'sources', 'obj_x'], 'formulas.sources', {'object_id': 'obj_x'}, None),
+    (['formulas', 'collections', 'obj_x'], 'formulas.collections', {'object_id': 'obj_x'}, None),
+    (['records', 'bundle-init', 'obj_x', '--record-id', 'rec_x'], 'records.bundle-init', {'object_id': 'obj_x'}, {'record_id': 'rec_x'}),
+    (['records', 'bundle-status', 'obj_x', 'submission'], 'records.bundle-status', {'object_id': 'obj_x', 'submission_id': 'submission'}, {}),
+    (['records', 'hierarchy-candidates', 'obj_x', '--field', 'fld_x'], 'records.hierarchy-candidates', {'object_id': 'obj_x'}, {'field': 'fld_x', 'exclude': '', 'q': ''}),
+    (['records', 'gantt-candidates', 'obj_x', '--field', 'fld_x', '--exclude', 'rec_x'], 'records.gantt-candidates', {'object_id': 'obj_x'}, {'field': 'fld_x', 'exclude': 'rec_x', 'q': ''}),
+    (['workflows', 'python-runtime', 'obj_x', 'new'], 'workflows.python-runtime', {'object_id': 'obj_x', 'workflow_id': 'new'}, None),
+])
+def test_discovery_request(args, endpoint, path, query):
+    with patch('flowbase_cli.main.OpenApiClient.request', return_value=b'{}') as request, patch('sys.stdout', io.StringIO()):
+        assert main(args) == 0
+    assert request.call_args.args[0] == endpoint
+    assert request.call_args.kwargs['path_params'] == path
+    assert request.call_args.kwargs['query'] == query
+
+
+def test_retry_noninteractive_requires_explicit_confirmation():
+    with patch('flowbase_cli.main.OpenApiClient.request') as request, patch('sys.stdin.isatty', return_value=False), patch('sys.stderr', io.StringIO()):
+        assert main(['workflows', 'retry', 'obj_x', 'wfl_x', 'exe_x']) == 1
+    request.assert_not_called()