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

flowbase_cli-0.1.3/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: flowbase-cli
+Version: 0.1.3
+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 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.3/README.md

@@ -0,0 +1,28 @@
+# 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 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.3}/pyproject.toml

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

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

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

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

@@ -30,6 +30,17 @@ 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("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 +66,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 +100,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.3}/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,43 @@ def handle_fields(args: argparse.Namespace) -> int:
     return run_request(args, f"fields.{action}", path_params=path)
 
 
+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 +377,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 +415,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 +560,29 @@ def build_parser() -> argparse.ArgumentParser:
         add_yes(item)
     fields.set_defaults(handler=handle_fields)
 
+    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 +591,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.3/src/flowbase_cli.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: flowbase-cli
+Version: 0.1.3
+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 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.3}/tests/test_cli.py

@@ -6,7 +6,7 @@ import unittest
 from decimal import Decimal
 from pathlib import Path
 from tempfile import TemporaryDirectory
-from unittest.mock import patch
+from unittest.mock import MagicMock, patch
 
 from flowbase_cli.endpoints import ENDPOINTS
 from flowbase_cli.main import (
@@ -66,6 +66,18 @@ class FlowBaseCliTest(unittest.TestCase):
         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):
@@ -74,6 +86,58 @@ class FlowBaseCliTest(unittest.TestCase):
         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))
+
+    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()
@@ -151,6 +215,95 @@ class FlowBaseCliTest(unittest.TestCase):
         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.