flowbase-cli 0.1.17__tar.gz → 0.1.18__tar.gz

{flowbase_cli-0.1.17 → flowbase_cli-0.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.17
+Version: 0.1.18
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0
@@ -318,9 +318,10 @@ Transport requests time out after 60 seconds. A lost write response has an unkno
 
 ### Recent feature authoring
 
+- `flowbase docs catalogs field-types`: includes template autonumber configuration and date/time/datetime v2 creation examples. Numbering rules and temporal precision are immutable after creation; legacy numbering and temporal v1 remain supported.
 - `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 formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Supports reuse of calculated results through single relations and multi-level rollups (up to 10 dependency levels). Validation returns `dependencyGraph`, or `valid=false` with `code`/`errorPath` for invalid dependencies. Pass `fieldId` when validating an existing field. 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.17 → flowbase_cli-0.1.18}/README.md

@@ -309,9 +309,10 @@ Transport requests time out after 60 seconds. A lost write response has an unkno
 
 ### Recent feature authoring
 
+- `flowbase docs catalogs field-types`: includes template autonumber configuration and date/time/datetime v2 creation examples. Numbering rules and temporal precision are immutable after creation; legacy numbering and temporal v1 remain supported.
 - `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 formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Supports reuse of calculated results through single relations and multi-level rollups (up to 10 dependency levels). Validation returns `dependencyGraph`, or `valid=false` with `code`/`errorPath` for invalid dependencies. Pass `fieldId` when validating an existing field. 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.17 → flowbase_cli-0.1.18}/pyproject.toml

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

{flowbase_cli-0.1.17 → flowbase_cli-0.1.18}/src/flowbase_cli/__init__.py

@@ -1,3 +1,3 @@
 """FlowBase OpenAPI CLI."""
 
-__version__ = "0.1.17"
+__version__ = "0.1.18"

{flowbase_cli-0.1.17 → flowbase_cli-0.1.18}/src/flowbase_cli/endpoints.py

@@ -663,7 +663,7 @@ def _field_type(
 ) -> dict:
     payload = {
         "type": type_name,
-        "typeVersion": "v1",
+        "typeVersion": "v2" if type_name in ("date", "time", "datetime") else "v1",
         "writable": writable,
         "permissions": list(_PERMISSIONS),
         "constraints": list(constraints),
@@ -710,8 +710,9 @@ FIELD_TYPES = (
         }},
     ),
     _field_type(
-        "date", ("minimum", "maximum", "unique", "displayFormat"),
-        filter_operators=_DATE_FILTERS, record_value="YYYY-MM-DD | null",
+        "date", ("precision", "minimum", "maximum", "unique", "displayFormat"),
+        filter_operators=_DATE_FILTERS, record_value="YYYY | YYYY-MM | YYYY-MM-DD | null; precision year/month/day is immutable",
+        extra={"createExample": {"label": "Month", "key": "month", "description": "Reporting month", "type": "date", "typeVersion": "v2", "permission": "optional", "constraints": {"precision": "month"}}},
     ),
     _field_type(
         "select.single", ("options", "unique", "showColorDot"),
@@ -762,11 +763,13 @@ FIELD_TYPES = (
     ),
     _field_type(
         "time", ("precision", "minimum", "maximum", "unique", "displayFormat"),
-        filter_operators=_DATE_FILTERS, record_value="HH:MM or HH:MM:SS | null",
+        filter_operators=_DATE_FILTERS, record_value="HH | HH:mm | HH:mm:ss | null; precision hour/minute/second is immutable",
+        extra={"createExample": {"label": "Hour", "key": "hour", "description": "Scheduled hour", "type": "time", "typeVersion": "v2", "permission": "optional", "constraints": {"precision": "hour"}}},
     ),
     _field_type(
-        "datetime", ("minimum", "maximum", "unique", "displayFormat"),
-        filter_operators=_DATE_FILTERS, record_value="ISO-8601 datetime | null",
+        "datetime", ("precision", "minimum", "maximum", "unique", "displayFormat"),
+        filter_operators=_DATE_FILTERS, record_value="UTC YYYY-MM-DDTHH:mm:ssZ | null; precision hour/minute/second, aligned in Asia/Shanghai; no fractional seconds",
+        extra={"createExample": {"label": "Occurred at", "key": "occurred_at", "description": "Event timestamp", "type": "datetime", "typeVersion": "v2", "permission": "optional", "constraints": {"precision": "second"}}},
     ),
     _field_type(
         "email", ("maxLength", "placeholder", "unique"),
@@ -790,12 +793,12 @@ FIELD_TYPES = (
         record_value="Markdown string | null",
     ),
     _field_type(
-        "autonumber", ("prefix", "start", "minDigits"),
+        "autonumber", ("template", "start", "reset", "timezone", "prefix", "minDigits"),
         writable=False, filter_operators=_TEXT_FILTERS, record_value="server-assigned string; omit on write",
-        extra={"createExample": {
+        extra={"ruleChanges": "Numbering rules are immutable after creation. Use template/start/reset/timezone, or legacy prefix/start/minDigits; never mix both forms. Omit the value on record writes.", "createExample": {
             "label": "Class no", "key": "class_no", "description": "Auto number",
             "type": "autonumber", "typeVersion": "v1", "permission": "readonly",
-            "constraints": {"prefix": "CLS", "start": 2023001, "minDigits": 7},
+            "constraints": {"template": "CLS{DATE:yyyyMM}{SEQ:3}", "start": 1, "reset": "month", "timezone": "Asia/Shanghai"},
         }},
     ),
     _field_type(
@@ -1643,6 +1646,7 @@ CATALOGS = {
         "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": {
+        "dependencies": "Single relations and collections can reuse formula/rollup results. Maximum dependency depth is 10; cycles are rejected. sources returns depth/dependencyIds; collections includes calculation metadata. validate returns dependencyGraph, or valid=false with code/errorPath. Pass fieldId when validating an existing field.",
         "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"}}},

{flowbase_cli-0.1.17 → flowbase_cli-0.1.18}/src/flowbase_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.17
+Version: 0.1.18
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0
@@ -318,9 +318,10 @@ Transport requests time out after 60 seconds. A lost write response has an unkno
 
 ### Recent feature authoring
 
+- `flowbase docs catalogs field-types`: includes template autonumber configuration and date/time/datetime v2 creation examples. Numbering rules and temporal precision are immutable after creation; legacy numbering and temporal v1 remain supported.
 - `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 formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Supports reuse of calculated results through single relations and multi-level rollups (up to 10 dependency levels). Validation returns `dependencyGraph`, or `valid=false` with `code`/`errorPath` for invalid dependencies. Pass `fieldId` when validating an existing field. 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).