flowbase-cli 0.1.2__tar.gz → 0.1.4__tar.gz

flowbase_cli-0.1.4/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: flowbase-cli
+Version: 0.1.4
+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
+
+Install from this checkout:
+
+```bash
+python -m pip install ./packages/flowbase-cli
+```
+
+Configure an environment Base URL and an API key:
+
+```bash
+export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
+export FLOWBASE_API_KEY=fbk_xxx
+
+flowbase objects list
+flowbase views list obj_xxx
+flowbase views create obj_xxx --json-file view.json
+flowbase pages list --object-id obj_xxx
+flowbase pages create --json-file page.json
+flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
+flowbase versions list --resource customer --change-type business-change
+flowbase versions show abc1234
+flowbase versions releases
+flowbase changes commit --message "Add customer field" --yes
+flowbase changes release --message "Release customer field" --yes
+flowbase environments restart --confirm "A 测试环境" --yes
+flowbase docs list
+```
+
+`--host` selects the environment through its Host. Version history commands are read-only and limited to the history visible from that Host; production release records are available only on the production Host. A test release can succeed only when its current version meets FlowBase's fast-forward checks. `environments restart` first shows a destructive preflight and then clears the current test configuration and records before starting from the latest production version. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

flowbase_cli-0.1.4/README.md

@@ -0,0 +1,30 @@
+# FlowBase CLI
+
+Install from this checkout:
+
+```bash
+python -m pip install ./packages/flowbase-cli
+```
+
+Configure an environment Base URL and an API key:
+
+```bash
+export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
+export FLOWBASE_API_KEY=fbk_xxx
+
+flowbase objects list
+flowbase views list obj_xxx
+flowbase views create obj_xxx --json-file view.json
+flowbase pages list --object-id obj_xxx
+flowbase pages create --json-file page.json
+flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
+flowbase versions list --resource customer --change-type business-change
+flowbase versions show abc1234
+flowbase versions releases
+flowbase changes commit --message "Add customer field" --yes
+flowbase changes release --message "Release customer field" --yes
+flowbase environments restart --confirm "A 测试环境" --yes
+flowbase docs list
+```
+
+`--host` selects the environment through its Host. Version history commands are read-only and limited to the history visible from that Host; production release records are available only on the production Host. A test release can succeed only when its current version meets FlowBase's fast-forward checks. `environments restart` first shows a destructive preflight and then clears the current test configuration and records before starting from the latest production version. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

{flowbase_cli-0.1.2 → flowbase_cli-0.1.4}/pyproject.toml

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

{flowbase_cli-0.1.2 → flowbase_cli-0.1.4}/src/flowbase_cli/__init__.py

@@ -1,3 +1,3 @@
 """FlowBase OpenAPI CLI."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.4"

{flowbase_cli-0.1.2 → flowbase_cli-0.1.4}/src/flowbase_cli/endpoints.py

@@ -30,6 +30,23 @@ ENDPOINTS = (
     Endpoint("fields.update", "flowbase_fields_update", "PUT", "/objects/{object_id}/fields/{field_id}", "metadata:write", "Update a field draft.", "flowbase fields update obj_xxx fld_xxx --label Name --description 'Customer name'"),
     Endpoint("fields.delete", "flowbase_fields_delete", "DELETE", "/objects/{object_id}/fields/{field_id}", "metadata:write", "Logically delete a field.", "flowbase fields delete obj_xxx fld_xxx --yes", True),
     Endpoint("fields.restore", "flowbase_fields_restore", "POST", "/objects/{object_id}/fields/{field_id}/restore", "metadata:write", "Restore a field.", "flowbase fields restore obj_xxx fld_xxx --yes", True),
+    Endpoint("views.list", "flowbase_views_list", "GET", "/objects/{object_id}/views", "metadata:read", "List object view metadata.", "flowbase views list obj_xxx"),
+    Endpoint("views.create", "flowbase_views_create", "POST", "/objects/{object_id}/views", "metadata:write", "Create an object view draft.", "flowbase views create obj_xxx --json-file view.json"),
+    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.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\"]}'"),
+    Endpoint("views.set-enabled", "flowbase_views_set_enabled", "POST", "/objects/{object_id}/views/{view_id}/enabled", "metadata:write", "Enable or disable an object view.", "flowbase views set-enabled obj_xxx viw_xxx --base-revision 4 --enabled --yes", True),
+    Endpoint("views.delete", "flowbase_views_delete", "DELETE", "/objects/{object_id}/views/{view_id}", "metadata:write", "Logically delete an object view.", "flowbase views delete obj_xxx viw_xxx --base-revision 4 --yes", True),
+    Endpoint("pages.list", "flowbase_pages_list", "GET", "/pages", "metadata:read", "List custom Page metadata.", "flowbase pages list --object-id obj_xxx"),
+    Endpoint("pages.options", "flowbase_pages_options", "GET", "/pages/options", "metadata:read", "Get custom Page design options.", "flowbase pages options"),
+    Endpoint("pages.get", "flowbase_pages_get", "GET", "/pages/{page_id}", "metadata:read", "Get a custom Page.", "flowbase pages get pag_xxx"),
+    Endpoint("pages.create", "flowbase_pages_create", "POST", "/pages", "metadata:write", "Create a custom Page draft.", "flowbase pages create --json-file page.json"),
+    Endpoint("pages.update", "flowbase_pages_update", "PUT", "/pages/{page_id}", "metadata:write", "Update a custom Page draft.", "flowbase pages update pag_xxx --json-file page.json"),
+    Endpoint("pages.set-default", "flowbase_pages_set_default", "POST", "/pages/{page_id}/set-default", "metadata:write", "Set a default custom Page.", "flowbase pages set-default pag_xxx --base-revision 4 --yes", True),
+    Endpoint("pages.delete", "flowbase_pages_delete", "POST", "/pages/{page_id}/delete", "metadata:write", "Logically delete a custom Page.", "flowbase pages delete pag_xxx --base-revision 4 --yes", True),
+    Endpoint("pages.restore", "flowbase_pages_restore", "POST", "/pages/{page_id}/restore", "metadata:write", "Restore a custom Page.", "flowbase pages restore pag_xxx --base-revision 4 --yes", True),
+    Endpoint("versions.list", "flowbase_versions_list", "GET", "/versions", "metadata:read", "List visible configuration versions.", "flowbase versions list"),
+    Endpoint("versions.get", "flowbase_versions_get", "GET", "/versions/{version_id}", "metadata:read", "Get a version with semantic and file diffs.", "flowbase versions show abc1234"),
+    Endpoint("releases.list", "flowbase_releases_list", "GET", "/releases", "metadata:read", "List production release records.", "flowbase versions releases", environments=("production",)),
     Endpoint("changes.commit", "flowbase_changes_commit", "POST", "/changes/commit", "metadata:write", "Commit current test-environment drafts.", "flowbase changes commit --message 'Add customer field' --yes", True, environments=("test-a", "test-b"), audit_event="version.commit"),
     Endpoint("changes.release", "flowbase_changes_release", "POST", "/changes/release", "metadata:write", "Release the current test-environment version.", "flowbase changes release --message 'Release customer field' --yes", True, environments=("test-a", "test-b"), audit_event="version.release"),
     Endpoint(
@@ -55,6 +72,29 @@ ENDPOINTS = (
         preflight_operation_id="flowbase_changes_direct_release_preflight",
         audit_event="version.forward-fix",
     ),
+    Endpoint(
+        "environments.restart-preflight",
+        "flowbase_environments_restart_preflight",
+        "GET",
+        "/environments/restart/preflight",
+        "metadata:write",
+        "Preflight restarting the current test environment from production.",
+        "flowbase environments restart --confirm 'A 测试环境' --yes",
+        environments=("test-a", "test-b"),
+    ),
+    Endpoint(
+        "environments.restart",
+        "flowbase_environments_restart",
+        "POST",
+        "/environments/restart",
+        "metadata:write",
+        "Clear and restart the current test environment from production.",
+        "flowbase environments restart --confirm 'A 测试环境' --yes",
+        requires_confirmation=True,
+        environments=("test-a", "test-b"),
+        preflight_operation_id="flowbase_environments_restart_preflight",
+        audit_event="version.base-update",
+    ),
     Endpoint("records.list", "flowbase_records_list", "GET", "/objects/{object_id}/records", "records:read", "List records.", "flowbase records list obj_xxx --page 1"),
     Endpoint("records.get", "flowbase_records_get", "GET", "/objects/{object_id}/records/{record_id}", "records:read", "Get a record.", "flowbase records get obj_xxx rec_xxx"),
     Endpoint("records.create", "flowbase_records_create", "POST", "/objects/{object_id}/records", "records:write", "Create a record.", "flowbase records create obj_xxx --json-file record.json"),
@@ -66,7 +106,6 @@ ENDPOINT_BY_KEY = {endpoint.key: endpoint for endpoint in ENDPOINTS}
 
 PENDING_MANAGEMENT_OPERATIONS = (
     {"key": "environments.enable", "status": "pending", "reason": "Requires an independent capability and confirmation contract."},
-    {"key": "environments.restart", "status": "pending", "reason": "Requires destructive data-reset confirmation."},
     {"key": "changes.clear-drafts", "status": "pending", "reason": "Requires an independent capability and confirmation contract."},
     {"key": "api-keys.manage", "status": "pending", "reason": "API keys cannot delegate or expand their own authority."},
     {"key": "git-credentials.manage", "status": "pending", "reason": "Requires a dedicated credential-management capability."},

{flowbase_cli-0.1.2 → flowbase_cli-0.1.4}/src/flowbase_cli/main.py

@@ -102,7 +102,11 @@ class OpenApiClient:
         if not self.api_key:
             raise CliError(f"Missing API key. Set {ENV_API_KEY} or pass --api-key.")
         url = self.build_url(endpoint, path_params, query)
-        headers = {"Accept": "application/json", "Authorization": f"Bearer {self.api_key}"}
+        headers = {
+            "Accept": "application/json",
+            "Authorization": f"Bearer {self.api_key}",
+            "X-FlowBase-Channel": "cli",
+        }
         data = None
         if body is not None:
             data = exact_json_dumps(body).encode("utf-8")
@@ -309,6 +313,76 @@ def handle_fields(args: argparse.Namespace) -> int:
     return run_request(args, f"fields.{action}", path_params=path)
 
 
+def handle_views(args: argparse.Namespace) -> int:
+    action = args.views_action
+    path = {"object_id": args.object_id}
+    if hasattr(args, "view_id"):
+        path["view_id"] = args.view_id
+    if action == "list":
+        return run_request(args, "views.list", path_params=path)
+    if action in ("create", "update"):
+        body = load_json_payload(args.json, args.json_file)
+        require_fields(body, "baseRevision", "name", "defaultFieldIds")
+        if not isinstance(body["defaultFieldIds"], list):
+            raise CliError("Request field 'defaultFieldIds' must be an array.")
+        return run_request(args, f"views.{action}", path_params=path, body=body)
+    if action == "reorder":
+        body = load_json_payload(args.json, args.json_file)
+        require_fields(body, "baseRevision", "viewIds")
+        if not isinstance(body["viewIds"], list):
+            raise CliError("Request field 'viewIds' must be an array.")
+        return run_request(args, "views.reorder", path_params=path, body=body)
+    if action == "set-enabled":
+        body = {
+            "baseRevision": args.base_revision,
+            "enabled": args.enabled,
+        }
+        return run_request(args, "views.set-enabled", path_params=path, body=body)
+    return run_request(
+        args,
+        "views.delete",
+        path_params=path,
+        body={"baseRevision": args.base_revision},
+    )
+
+
+def handle_pages(args: argparse.Namespace) -> int:
+    action = args.pages_action
+    if action == "list":
+        return run_request(
+            args,
+            "pages.list",
+            query={
+                "status": args.status,
+                "objectId": args.object_id,
+                "type": args.type,
+                "keyword": args.keyword,
+                "page": args.page,
+            },
+        )
+    if action == "options":
+        return run_request(args, "pages.options")
+    if action == "get":
+        return run_request(args, "pages.get", path_params={"page_id": args.page_id})
+    if action in ("create", "update"):
+        body = load_json_payload(args.json, args.json_file)
+        require_fields(body, "baseRevision", "page")
+        if not isinstance(body["page"], dict):
+            raise CliError("Request field 'page' must be an object.")
+        return run_request(
+            args,
+            f"pages.{action}",
+            path_params={"page_id": args.page_id} if action == "update" else None,
+            body=body,
+        )
+    return run_request(
+        args,
+        f"pages.{action}",
+        path_params={"page_id": args.page_id},
+        body={"baseRevision": args.base_revision},
+    )
+
+
 def handle_changes(args: argparse.Namespace) -> int:
     if args.changes_action == "direct-release":
         client = client_from_args(args)
@@ -336,6 +410,28 @@ def handle_changes(args: argparse.Namespace) -> int:
     return run_request(args, f"changes.{args.changes_action}", body={"message": args.message})
 
 
+def handle_versions(args: argparse.Namespace) -> int:
+    if args.versions_action == "show":
+        return run_request(
+            args,
+            "versions.get",
+            path_params={"version_id": args.version_id},
+        )
+    if args.versions_action == "releases":
+        return run_request(args, "releases.list")
+    return run_request(
+        args,
+        "versions.list",
+        query={
+            "q": args.query,
+            "resource": args.resource,
+            "changeType": args.change_type,
+            "releaseStatus": args.release_status,
+            "channel": args.channel,
+        },
+    )
+
+
 def _print_direct_release_preflight(preflight: dict[str, Any]) -> None:
     print("Production direct-release preflight:", file=sys.stderr)
     print(f"  Current main: {preflight.get('mainCommit', 'unknown')}", file=sys.stderr)
@@ -352,6 +448,68 @@ def _print_direct_release_preflight(preflight: dict[str, Any]) -> None:
     print(f"  RISK: {preflight.get('risk', 'This bypasses test environments.')}", file=sys.stderr)
 
 
+def _environment_confirmation(args: argparse.Namespace, label: str) -> str:
+    value = (args.confirm or "").strip()
+    if not value:
+        if not sys.stdin.isatty():
+            raise CliError(
+                "Refusing to restart without --confirm '<environment name>' in non-interactive mode."
+            )
+        value = input(f"Type {label} to confirm: ").strip()
+    if value != label:
+        raise CliError("Environment confirmation does not match the preflight result.")
+    return value
+
+
+def _print_environment_restart_preflight(preflight: dict[str, Any]) -> None:
+    current = str(preflight.get("currentCommit", "unknown"))
+    main = str(preflight.get("mainCommit", "unknown"))
+    print("Test-environment restart preflight:", file=sys.stderr)
+    print(f"  Environment: {preflight.get('environmentLabel', 'unknown')}", file=sys.stderr)
+    print(f"  Current test version: {current[:7]}", file=sys.stderr)
+    print(f"  Latest production version: {main[:7]}", file=sys.stderr)
+    print(f"  Drafts: {preflight.get('draftCount', 0)}", file=sys.stderr)
+    print(f"  Test records: {preflight.get('recordCount', 0)}", file=sys.stderr)
+    for check in preflight.get("checks", []):
+        if isinstance(check, dict):
+            mark = "OK" if check.get("ok") else "FAIL"
+            print(f"  [{mark}] {check.get('label', '')}", file=sys.stderr)
+    print(
+        f"  RISK: {preflight.get('risk', 'All test configuration and records will be cleared.')}",
+        file=sys.stderr,
+    )
+
+
+def handle_environments(args: argparse.Namespace) -> int:
+    client = client_from_args(args)
+    preflight_data = client.request("environments.restart-preflight")
+    try:
+        preflight = json.loads(preflight_data)
+    except json.JSONDecodeError as exc:
+        raise CliError("Environment restart preflight returned invalid JSON.") from exc
+    _print_environment_restart_preflight(preflight)
+    if not preflight.get("canRestart"):
+        raise CliError("Environment restart preflight failed. Resolve failed checks first.")
+    label = preflight.get("environmentLabel")
+    if not isinstance(label, str) or not label:
+        raise CliError("Environment restart preflight did not return an environment label.")
+    confirm = _environment_confirmation(args, label)
+    endpoint = get_endpoint("environments.restart")
+    confirm_change(endpoint, args.yes)
+    body = {
+        "confirm": confirm,
+        "expectedCurrentCommit": preflight.get("currentCommit"),
+        "expectedMainCommit": preflight.get("mainCommit"),
+        "expectedDraftRevision": preflight.get("draftRevision"),
+        "expectedRecordCount": preflight.get("recordCount"),
+    }
+    if any(value is None for value in body.values()):
+        raise CliError("Environment restart preflight returned incomplete binding state.")
+    data = client.request("environments.restart", body=body)
+    print_output(data, pretty=args.pretty, raw=args.raw)
+    return 0
+
+
 def handle_records(args: argparse.Namespace) -> int:
     action = args.records_action
     path = {"object_id": args.object_id}
@@ -435,6 +593,58 @@ def build_parser() -> argparse.ArgumentParser:
         add_yes(item)
     fields.set_defaults(handler=handle_fields)
 
+    views = groups.add_parser("views", help="Manage object view metadata.")
+    view_actions = views.add_subparsers(dest="views_action", required=True)
+    view_list = view_actions.add_parser("list")
+    view_list.add_argument("object_id")
+    for action in ("create", "reorder"):
+        item = view_actions.add_parser(action)
+        item.add_argument("object_id")
+        add_json_args(item)
+    view_update = view_actions.add_parser("update")
+    view_update.add_argument("object_id")
+    view_update.add_argument("view_id")
+    add_json_args(view_update)
+    view_enabled = view_actions.add_parser("set-enabled")
+    view_enabled.add_argument("object_id")
+    view_enabled.add_argument("view_id")
+    view_enabled.add_argument("--base-revision", required=True, type=int)
+    view_enabled.add_argument(
+        "--enabled",
+        action=argparse.BooleanOptionalAction,
+        required=True,
+    )
+    add_yes(view_enabled)
+    view_delete = view_actions.add_parser("delete")
+    view_delete.add_argument("object_id")
+    view_delete.add_argument("view_id")
+    view_delete.add_argument("--base-revision", required=True, type=int)
+    add_yes(view_delete)
+    views.set_defaults(handler=handle_views)
+
+    pages = groups.add_parser("pages", help="Manage custom Page metadata.")
+    page_actions = pages.add_subparsers(dest="pages_action", required=True)
+    page_list = page_actions.add_parser("list")
+    page_list.add_argument("--status", choices=("active", "deleted"), default="active")
+    page_list.add_argument("--object-id")
+    page_list.add_argument("--type", choices=("create", "detail"))
+    page_list.add_argument("--keyword")
+    page_list.add_argument("--page", type=int, default=1)
+    page_actions.add_parser("options")
+    page_get = page_actions.add_parser("get")
+    page_get.add_argument("page_id")
+    page_create = page_actions.add_parser("create")
+    add_json_args(page_create)
+    page_update = page_actions.add_parser("update")
+    page_update.add_argument("page_id")
+    add_json_args(page_update)
+    for action in ("set-default", "delete", "restore"):
+        item = page_actions.add_parser(action)
+        item.add_argument("page_id")
+        item.add_argument("--base-revision", required=True, type=int)
+        add_yes(item)
+    pages.set_defaults(handler=handle_pages)
+
     changes = groups.add_parser("changes", help="Commit or release metadata versions.")
     change_actions = changes.add_subparsers(dest="changes_action", required=True)
     for action in ("commit", "release", "direct-release"):
@@ -443,6 +653,38 @@ def build_parser() -> argparse.ArgumentParser:
         add_yes(item)
     changes.set_defaults(handler=handle_changes)
 
+    versions = groups.add_parser("versions", help="Inspect read-only configuration history.")
+    version_actions = versions.add_subparsers(dest="versions_action", required=True)
+    version_list = version_actions.add_parser("list")
+    version_list.add_argument("--query")
+    version_list.add_argument("--resource")
+    version_list.add_argument(
+        "--change-type",
+        choices=("business-change", "format-migration"),
+    )
+    version_list.add_argument(
+        "--release-status",
+        choices=("released", "unreleased"),
+    )
+    version_list.add_argument(
+        "--channel",
+        choices=("web", "openapi", "cli", "ai", "system-migration"),
+    )
+    version_show = version_actions.add_parser("show")
+    version_show.add_argument("version_id")
+    version_actions.add_parser("releases")
+    versions.set_defaults(handler=handle_versions)
+
+    environments = groups.add_parser("environments", help="Manage the current test environment.")
+    environment_actions = environments.add_subparsers(dest="environments_action", required=True)
+    environment_restart = environment_actions.add_parser("restart")
+    environment_restart.add_argument(
+        "--confirm",
+        help="Exact environment name returned by preflight. Required in non-interactive mode.",
+    )
+    add_yes(environment_restart)
+    environments.set_defaults(handler=handle_environments)
+
     records = groups.add_parser("records", help="Manage business records.")
     record_actions = records.add_subparsers(dest="records_action", required=True)
     record_list = record_actions.add_parser("list")

flowbase_cli-0.1.4/src/flowbase_cli.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: flowbase-cli
+Version: 0.1.4
+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
+
+Install from this checkout:
+
+```bash
+python -m pip install ./packages/flowbase-cli
+```
+
+Configure an environment Base URL and an API key:
+
+```bash
+export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
+export FLOWBASE_API_KEY=fbk_xxx
+
+flowbase objects list
+flowbase views list obj_xxx
+flowbase views create obj_xxx --json-file view.json
+flowbase pages list --object-id obj_xxx
+flowbase pages create --json-file page.json
+flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
+flowbase versions list --resource customer --change-type business-change
+flowbase versions show abc1234
+flowbase versions releases
+flowbase changes commit --message "Add customer field" --yes
+flowbase changes release --message "Release customer field" --yes
+flowbase environments restart --confirm "A 测试环境" --yes
+flowbase docs list
+```
+
+`--host` selects the environment through its Host. Version history commands are read-only and limited to the history visible from that Host; production release records are available only on the production Host. A test release can succeed only when its current version meets FlowBase's fast-forward checks. `environments restart` first shows a destructive preflight and then clears the current test configuration and records before starting from the latest production version. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

flowbase_cli-0.1.4/tests/test_cli.py

@@ -0,0 +1,381 @@
+from __future__ import annotations
+
+import io
+import json
+import unittest
+from decimal import Decimal
+from pathlib import Path
+from tempfile import TemporaryDirectory
+from unittest.mock import MagicMock, patch
+
+from flowbase_cli.endpoints import ENDPOINTS
+from flowbase_cli.main import (
+    CliError,
+    OpenApiClient,
+    api_root,
+    exact_json_dumps,
+    load_json_payload,
+    main,
+)
+
+
+class FlowBaseCliTest(unittest.TestCase):
+    def test_endpoint_keys_and_operation_ids_are_unique(self):
+        self.assertEqual(len({item.key for item in ENDPOINTS}), len(ENDPOINTS))
+        self.assertEqual(len({item.operation_id for item in ENDPOINTS}), len(ENDPOINTS))
+
+    def test_api_root_appends_prefix_once(self):
+        self.assertEqual(api_root("https://example.com/"), "https://example.com/api/openapi/v1")
+        self.assertEqual(api_root("https://example.com/api/openapi/v1"), "https://example.com/api/openapi/v1")
+
+    def test_json_payload_requires_one_object_source(self):
+        self.assertEqual(load_json_payload('{"values":{}}', None), {"values": {}})
+        with self.assertRaisesRegex(CliError, "cannot be used together"):
+            load_json_payload("{}", "body.json")
+        with self.assertRaisesRegex(CliError, "must be an object"):
+            load_json_payload("[]", None)
+
+    def test_json_file_is_utf8(self):
+        with TemporaryDirectory() as directory:
+            path = Path(directory) / "body.json"
+            path.write_text('{"label":"客户"}', encoding="utf-8")
+            self.assertEqual(load_json_payload(None, str(path)), {"label": "客户"})
+
+    def test_decimal_payload_preserves_json_number_text(self):
+        payload = load_json_payload(
+            '{"values":{"amount":12345678901234.5678}}', None
+        )
+        self.assertEqual(
+            payload["values"]["amount"], Decimal("12345678901234.5678")
+        )
+        self.assertEqual(
+            exact_json_dumps(payload),
+            '{"values":{"amount":12345678901234.5678}}',
+        )
+
+    def test_missing_key_is_rejected_before_network(self):
+        client = OpenApiClient("https://example.com", None)
+        with patch("flowbase_cli.main.urlopen") as mocked:
+            with self.assertRaisesRegex(CliError, "Missing API key"):
+                client.request("objects.list")
+            mocked.assert_not_called()
+
+    def test_url_encodes_path_and_query(self):
+        client = OpenApiClient("https://example.com", "fbk_test")
+        endpoint = next(item for item in ENDPOINTS if item.key == "records.get")
+        url = client.build_url(endpoint, {"object_id": "obj/a", "record_id": "rec b"}, {"page": 2})
+        self.assertEqual(url, "https://example.com/api/openapi/v1/objects/obj%2Fa/records/rec%20b?page=2")
+
+    def test_requests_identify_cli_channel_without_exposing_key_in_url(self):
+        client = OpenApiClient("https://example.com", "fbk_secret")
+        response = MagicMock()
+        response.read.return_value = b"[]"
+        context = MagicMock()
+        context.__enter__.return_value = response
+        with patch("flowbase_cli.main.urlopen", return_value=context) as mocked:
+            client.request("versions.list")
+        request = mocked.call_args.args[0]
+        self.assertEqual(request.get_header("X-flowbase-channel"), "cli")
+        self.assertNotIn("fbk_secret", request.full_url)
+
+    def test_docs_list_needs_no_api_key(self):
+        stdout = io.StringIO()
+        with patch("sys.stdout", stdout):
+            code = main(["docs", "list"])
+        self.assertEqual(code, 0)
+        payload = json.loads(stdout.getvalue())
+        self.assertTrue(any(item["key"] == "records.create" for item in payload))
+        self.assertTrue(any(item["key"] == "changes.release" for item in payload))
+        self.assertTrue(any(item["key"] == "versions.get" for item in payload))
+        self.assertTrue(any(item["key"] == "pages.create" for item in payload))
+        self.assertTrue(any(item["key"] == "views.create" for item in payload))
+
+    def test_view_create_sends_complete_snapshot(self):
+        body = {
+            "baseRevision": 4,
+            "name": "Active customers",
+            "defaultFieldIds": ["fld_1"],
+        }
+        stdout = io.StringIO()
+        with (
+            patch(
+                "flowbase_cli.main.OpenApiClient.request",
+                return_value=b'{"viewId":"viw_1","draftRevision":5}',
+            ) as request,
+            patch("sys.stdout", stdout),
+        ):
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "views",
+                "create",
+                "obj_1",
+                "--json",
+                json.dumps(body),
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "views.create")
+        self.assertEqual(
+            request.call_args.kwargs["path_params"],
+            {"object_id": "obj_1"},
+        )
+        self.assertEqual(request.call_args.kwargs["body"], body)
+
+    def test_view_set_enabled_sends_revision_and_requires_yes(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "views",
+                "set-enabled",
+                "obj_1",
+                "viw_1",
+                "--base-revision",
+                "4",
+                "--no-enabled",
+            ])
+        self.assertEqual(code, 1)
+        self.assertIn("without --yes", stderr.getvalue())
+
+        with patch(
+            "flowbase_cli.main.OpenApiClient.request",
+            return_value=b'{"ok":true,"draftRevision":5}',
+        ) as request:
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "views",
+                "set-enabled",
+                "obj_1",
+                "viw_1",
+                "--base-revision",
+                "4",
+                "--no-enabled",
+                "--yes",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "views.set-enabled")
+        self.assertEqual(
+            request.call_args.kwargs["body"],
+            {"baseRevision": 4, "enabled": False},
+        )
+
+    def test_page_set_default_sends_revision_and_requires_yes(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
+            code = main(["--api-key", "fbk_test", "pages", "set-default", "pag_1", "--base-revision", "4"])
+        self.assertEqual(code, 1)
+        self.assertIn("without --yes", stderr.getvalue())
+
+        stdout = io.StringIO()
+        with (
+            patch("flowbase_cli.main.OpenApiClient.request", return_value=b'{"draftRevision":5}') as request,
+            patch("sys.stdout", stdout),
+        ):
+            code = main([
+                "--api-key", "fbk_test", "pages", "set-default", "pag_1",
+                "--base-revision", "4", "--yes",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "pages.set-default")
+        self.assertEqual(request.call_args.kwargs["body"], {"baseRevision": 4})
+
+    def test_page_create_requires_full_request_body(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr):
+            code = main(["pages", "create", "--json", '{"baseRevision":0}'])
+        self.assertEqual(code, 1)
+        self.assertIn("page", stderr.getvalue())
+
+    def test_version_show_uses_read_only_version_endpoint(self):
+        stdout = io.StringIO()
+        with (
+            patch(
+                "flowbase_cli.main.OpenApiClient.request",
+                return_value=b'{"commit":"abcdef0"}',
+            ) as request,
+            patch("sys.stdout", stdout),
+        ):
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "versions",
+                "show",
+                "abcdef0",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_args.args[0], "versions.get")
+        self.assertEqual(
+            request.call_args.kwargs["path_params"],
+            {"version_id": "abcdef0"},
+        )
+
+    def test_management_operation_catalog_identifies_pending_gaps(self):
+        stdout = io.StringIO()
+        with patch("sys.stdout", stdout):
+            code = main(["docs", "operations"])
+        self.assertEqual(code, 0)
+        payload = json.loads(stdout.getvalue())
+        self.assertTrue(any(item["key"] == "changes.direct-release" and item["status"] == "delivered" for item in payload))
+        self.assertTrue(any(item["key"] == "changes.clear-drafts" and item["status"] == "pending" for item in payload))
+
+    def test_object_create_requires_business_description(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr):
+            code = main(["objects", "create", "--label", "Customer", "--key", "customer"])
+        self.assertEqual(code, 1)
+        self.assertIn("description", stderr.getvalue())
+
+    def test_noninteractive_delete_requires_yes(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
+            code = main(["--api-key", "fbk_test", "records", "delete", "obj_1", "rec_1"])
+        self.assertEqual(code, 1)
+        self.assertIn("without --yes", stderr.getvalue())
+
+    def test_noninteractive_commit_requires_yes(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
+            code = main(["--api-key", "fbk_test", "changes", "commit", "--message", "Add customer field"])
+        self.assertEqual(code, 1)
+        self.assertIn("without --yes", stderr.getvalue())
+
+    def test_direct_release_always_preflights_before_execution(self):
+        preflight = {
+            "confirmationToken": "fbc_secret",
+            "mainCommit": "abc1234",
+            "draftRevision": 4,
+            "semanticCount": 2,
+            "fileCount": 1,
+            "checks": [{"label": "Configuration valid", "ok": True}],
+            "risk": "Bypasses test environments.",
+        }
+        stdout = io.StringIO()
+        stderr = io.StringIO()
+        with (
+            patch(
+                "flowbase_cli.main.OpenApiClient.request",
+                side_effect=[
+                    json.dumps(preflight).encode(),
+                    b'{"mainCommit":"def5678"}',
+                ],
+            ) as request,
+            patch("sys.stdout", stdout),
+            patch("sys.stderr", stderr),
+        ):
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "changes",
+                "direct-release",
+                "--message",
+                "Production fix",
+                "--yes",
+            ])
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_count, 2)
+        self.assertEqual(
+            request.call_args_list[0].args[0],
+            "changes.direct-release-preflight",
+        )
+        self.assertEqual(
+            request.call_args_list[1].kwargs["body"]["confirmationToken"],
+            "fbc_secret",
+        )
+        self.assertNotIn("fbc_secret", stdout.getvalue())
+        self.assertNotIn("fbc_secret", stderr.getvalue())
+        self.assertIn("Bypasses test environments", stderr.getvalue())
+
+    def test_environment_restart_preflights_and_binds_execution(self):
+        preflight = {
+            "environmentId": "test-a",
+            "environmentLabel": "A 测试环境",
+            "currentCommit": "a" * 40,
+            "mainCommit": "b" * 40,
+            "draftRevision": 7,
+            "draftCount": 0,
+            "recordCount": 3,
+            "checks": [
+                {"label": "当前环境为已启用测试环境", "ok": True},
+                {"label": "当前环境无待提交草稿", "ok": True},
+            ],
+            "canRestart": True,
+            "risk": "All test records will be deleted.",
+        }
+        stdout = io.StringIO()
+        stderr = io.StringIO()
+        with (
+            patch(
+                "flowbase_cli.main.OpenApiClient.request",
+                side_effect=[
+                    json.dumps(preflight).encode(),
+                    b'{"currentCommit":"bbbbbbb","clearedRecordCount":3}',
+                ],
+            ) as request,
+            patch("sys.stdout", stdout),
+            patch("sys.stderr", stderr),
+        ):
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "environments",
+                "restart",
+                "--confirm",
+                "A 测试环境",
+                "--yes",
+            ])
+
+        self.assertEqual(code, 0)
+        self.assertEqual(request.call_count, 2)
+        self.assertEqual(request.call_args_list[0].args[0], "environments.restart-preflight")
+        self.assertEqual(request.call_args_list[1].args[0], "environments.restart")
+        self.assertEqual(
+            request.call_args_list[1].kwargs["body"],
+            {
+                "confirm": "A 测试环境",
+                "expectedCurrentCommit": "a" * 40,
+                "expectedMainCommit": "b" * 40,
+                "expectedDraftRevision": 7,
+                "expectedRecordCount": 3,
+            },
+        )
+        self.assertIn("All test records will be deleted", stderr.getvalue())
+
+    def test_environment_restart_noninteractive_requires_name_confirmation(self):
+        preflight = {
+            "environmentId": "test-a",
+            "environmentLabel": "A 测试环境",
+            "currentCommit": "a" * 40,
+            "mainCommit": "b" * 40,
+            "draftRevision": 0,
+            "draftCount": 0,
+            "recordCount": 0,
+            "checks": [],
+            "canRestart": True,
+            "risk": "Destructive.",
+        }
+        stderr = io.StringIO()
+        with (
+            patch(
+                "flowbase_cli.main.OpenApiClient.request",
+                return_value=json.dumps(preflight).encode(),
+            ) as request,
+            patch("sys.stderr", stderr),
+            patch("sys.stdin.isatty", return_value=False),
+        ):
+            code = main([
+                "--api-key",
+                "fbk_test",
+                "environments",
+                "restart",
+                "--yes",
+            ])
+
+        self.assertEqual(code, 1)
+        self.assertEqual(request.call_count, 1)
+        self.assertIn("--confirm", stderr.getvalue())
+
+
+if __name__ == "__main__":
+    unittest.main()

flowbase_cli-0.1.2/PKG-INFO

@@ -1,31 +0,0 @@
-Metadata-Version: 2.4
-Name: flowbase-cli
-Version: 0.1.2
-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
-
-Install from this checkout:
-
-```bash
-python -m pip install ./packages/flowbase-cli
-```
-
-Configure an environment Base URL and an API key:
-
-```bash
-export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
-export FLOWBASE_API_KEY=fbk_xxx
-
-flowbase objects list
-flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
-flowbase changes commit --message "Add customer field" --yes
-flowbase changes release --message "Release customer field" --yes
-flowbase docs list
-```
-
-`--host` selects the environment through its Host. Version commands are limited to the current enabled test environment; release can succeed only when its current version meets FlowBase's fast-forward checks. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

flowbase_cli-0.1.2/README.md

@@ -1,22 +0,0 @@
-# FlowBase CLI
-
-Install from this checkout:
-
-```bash
-python -m pip install ./packages/flowbase-cli
-```
-
-Configure an environment Base URL and an API key:
-
-```bash
-export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
-export FLOWBASE_API_KEY=fbk_xxx
-
-flowbase objects list
-flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
-flowbase changes commit --message "Add customer field" --yes
-flowbase changes release --message "Release customer field" --yes
-flowbase docs list
-```
-
-`--host` selects the environment through its Host. Version commands are limited to the current enabled test environment; release can succeed only when its current version meets FlowBase's fast-forward checks. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

flowbase_cli-0.1.2/src/flowbase_cli.egg-info/PKG-INFO

@@ -1,31 +0,0 @@
-Metadata-Version: 2.4
-Name: flowbase-cli
-Version: 0.1.2
-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
-
-Install from this checkout:
-
-```bash
-python -m pip install ./packages/flowbase-cli
-```
-
-Configure an environment Base URL and an API key:
-
-```bash
-export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
-export FLOWBASE_API_KEY=fbk_xxx
-
-flowbase objects list
-flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
-flowbase changes commit --message "Add customer field" --yes
-flowbase changes release --message "Release customer field" --yes
-flowbase docs list
-```
-
-`--host` selects the environment through its Host. Version commands are limited to the current enabled test environment; release can succeed only when its current version meets FlowBase's fast-forward checks. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

flowbase_cli-0.1.2/tests/test_cli.py

@@ -1,156 +0,0 @@
-from __future__ import annotations
-
-import io
-import json
-import unittest
-from decimal import Decimal
-from pathlib import Path
-from tempfile import TemporaryDirectory
-from unittest.mock import patch
-
-from flowbase_cli.endpoints import ENDPOINTS
-from flowbase_cli.main import (
-    CliError,
-    OpenApiClient,
-    api_root,
-    exact_json_dumps,
-    load_json_payload,
-    main,
-)
-
-
-class FlowBaseCliTest(unittest.TestCase):
-    def test_endpoint_keys_and_operation_ids_are_unique(self):
-        self.assertEqual(len({item.key for item in ENDPOINTS}), len(ENDPOINTS))
-        self.assertEqual(len({item.operation_id for item in ENDPOINTS}), len(ENDPOINTS))
-
-    def test_api_root_appends_prefix_once(self):
-        self.assertEqual(api_root("https://example.com/"), "https://example.com/api/openapi/v1")
-        self.assertEqual(api_root("https://example.com/api/openapi/v1"), "https://example.com/api/openapi/v1")
-
-    def test_json_payload_requires_one_object_source(self):
-        self.assertEqual(load_json_payload('{"values":{}}', None), {"values": {}})
-        with self.assertRaisesRegex(CliError, "cannot be used together"):
-            load_json_payload("{}", "body.json")
-        with self.assertRaisesRegex(CliError, "must be an object"):
-            load_json_payload("[]", None)
-
-    def test_json_file_is_utf8(self):
-        with TemporaryDirectory() as directory:
-            path = Path(directory) / "body.json"
-            path.write_text('{"label":"客户"}', encoding="utf-8")
-            self.assertEqual(load_json_payload(None, str(path)), {"label": "客户"})
-
-    def test_decimal_payload_preserves_json_number_text(self):
-        payload = load_json_payload(
-            '{"values":{"amount":12345678901234.5678}}', None
-        )
-        self.assertEqual(
-            payload["values"]["amount"], Decimal("12345678901234.5678")
-        )
-        self.assertEqual(
-            exact_json_dumps(payload),
-            '{"values":{"amount":12345678901234.5678}}',
-        )
-
-    def test_missing_key_is_rejected_before_network(self):
-        client = OpenApiClient("https://example.com", None)
-        with patch("flowbase_cli.main.urlopen") as mocked:
-            with self.assertRaisesRegex(CliError, "Missing API key"):
-                client.request("objects.list")
-            mocked.assert_not_called()
-
-    def test_url_encodes_path_and_query(self):
-        client = OpenApiClient("https://example.com", "fbk_test")
-        endpoint = next(item for item in ENDPOINTS if item.key == "records.get")
-        url = client.build_url(endpoint, {"object_id": "obj/a", "record_id": "rec b"}, {"page": 2})
-        self.assertEqual(url, "https://example.com/api/openapi/v1/objects/obj%2Fa/records/rec%20b?page=2")
-
-    def test_docs_list_needs_no_api_key(self):
-        stdout = io.StringIO()
-        with patch("sys.stdout", stdout):
-            code = main(["docs", "list"])
-        self.assertEqual(code, 0)
-        payload = json.loads(stdout.getvalue())
-        self.assertTrue(any(item["key"] == "records.create" for item in payload))
-        self.assertTrue(any(item["key"] == "changes.release" for item in payload))
-
-    def test_management_operation_catalog_identifies_pending_gaps(self):
-        stdout = io.StringIO()
-        with patch("sys.stdout", stdout):
-            code = main(["docs", "operations"])
-        self.assertEqual(code, 0)
-        payload = json.loads(stdout.getvalue())
-        self.assertTrue(any(item["key"] == "changes.direct-release" and item["status"] == "delivered" for item in payload))
-        self.assertTrue(any(item["key"] == "changes.clear-drafts" and item["status"] == "pending" for item in payload))
-
-    def test_object_create_requires_business_description(self):
-        stderr = io.StringIO()
-        with patch("sys.stderr", stderr):
-            code = main(["objects", "create", "--label", "Customer", "--key", "customer"])
-        self.assertEqual(code, 1)
-        self.assertIn("description", stderr.getvalue())
-
-    def test_noninteractive_delete_requires_yes(self):
-        stderr = io.StringIO()
-        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
-            code = main(["--api-key", "fbk_test", "records", "delete", "obj_1", "rec_1"])
-        self.assertEqual(code, 1)
-        self.assertIn("without --yes", stderr.getvalue())
-
-    def test_noninteractive_commit_requires_yes(self):
-        stderr = io.StringIO()
-        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
-            code = main(["--api-key", "fbk_test", "changes", "commit", "--message", "Add customer field"])
-        self.assertEqual(code, 1)
-        self.assertIn("without --yes", stderr.getvalue())
-
-    def test_direct_release_always_preflights_before_execution(self):
-        preflight = {
-            "confirmationToken": "fbc_secret",
-            "mainCommit": "abc1234",
-            "draftRevision": 4,
-            "semanticCount": 2,
-            "fileCount": 1,
-            "checks": [{"label": "Configuration valid", "ok": True}],
-            "risk": "Bypasses test environments.",
-        }
-        stdout = io.StringIO()
-        stderr = io.StringIO()
-        with (
-            patch(
-                "flowbase_cli.main.OpenApiClient.request",
-                side_effect=[
-                    json.dumps(preflight).encode(),
-                    b'{"mainCommit":"def5678"}',
-                ],
-            ) as request,
-            patch("sys.stdout", stdout),
-            patch("sys.stderr", stderr),
-        ):
-            code = main([
-                "--api-key",
-                "fbk_test",
-                "changes",
-                "direct-release",
-                "--message",
-                "Production fix",
-                "--yes",
-            ])
-        self.assertEqual(code, 0)
-        self.assertEqual(request.call_count, 2)
-        self.assertEqual(
-            request.call_args_list[0].args[0],
-            "changes.direct-release-preflight",
-        )
-        self.assertEqual(
-            request.call_args_list[1].kwargs["body"]["confirmationToken"],
-            "fbc_secret",
-        )
-        self.assertNotIn("fbc_secret", stdout.getvalue())
-        self.assertNotIn("fbc_secret", stderr.getvalue())
-        self.assertIn("Bypasses test environments", stderr.getvalue())
-
-
-if __name__ == "__main__":
-    unittest.main()