flowbase-cli 0.1.1__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.1 → flowbase_cli-0.1.3}/pyproject.toml

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

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

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

flowbase_cli-0.1.3/src/flowbase_cli/endpoints.py

@@ -0,0 +1,107 @@
+"""CLI endpoint catalog, contract-tested against the server OpenAPI schema."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class Endpoint:
+    key: str
+    operation_id: str
+    method: str
+    path: str
+    scope: str
+    summary: str
+    example: str
+    requires_confirmation: bool = False
+    environments: tuple[str, ...] = ("production", "test-a", "test-b")
+    preflight_operation_id: str | None = None
+    audit_event: str | None = None
+
+
+ENDPOINTS = (
+    Endpoint("objects.list", "flowbase_objects_list", "GET", "/objects", "metadata:read", "List object metadata.", "flowbase objects list"),
+    Endpoint("objects.get", "flowbase_objects_get", "GET", "/objects/{object_id}", "metadata:read", "Get object and field metadata.", "flowbase objects get obj_xxx"),
+    Endpoint("objects.create", "flowbase_objects_create", "POST", "/objects", "metadata:write", "Create an object draft.", "flowbase objects create --json-file object.json"),
+    Endpoint("objects.update", "flowbase_objects_update", "PUT", "/objects/{object_id}", "metadata:write", "Update an object draft.", "flowbase objects update obj_xxx --label Customer --description 'Customer records'"),
+    Endpoint("objects.delete", "flowbase_objects_delete", "DELETE", "/objects/{object_id}", "metadata:write", "Logically delete an object.", "flowbase objects delete obj_xxx --yes", True),
+    Endpoint("objects.restore", "flowbase_objects_restore", "POST", "/objects/{object_id}/restore", "metadata:write", "Restore an object.", "flowbase objects restore obj_xxx --yes", True),
+    Endpoint("fields.create", "flowbase_fields_create", "POST", "/objects/{object_id}/fields", "metadata:write", "Create a field draft.", "flowbase fields create obj_xxx --json-file field.json"),
+    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(
+        "changes.direct-release-preflight",
+        "flowbase_changes_direct_release_preflight",
+        "POST",
+        "/changes/direct-release/preflight",
+        "metadata:write",
+        "Preflight a production direct release.",
+        "flowbase changes direct-release --message 'Fix production field' --yes",
+        environments=("production",),
+    ),
+    Endpoint(
+        "changes.direct-release",
+        "flowbase_changes_direct_release",
+        "POST",
+        "/changes/direct-release",
+        "metadata:write",
+        "Directly release production drafts.",
+        "flowbase changes direct-release --message 'Fix production field' --yes",
+        requires_confirmation=True,
+        environments=("production",),
+        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"),
+    Endpoint("records.update", "flowbase_records_update", "PUT", "/objects/{object_id}/records/{record_id}", "records:write", "Replace active field values on a record.", "flowbase records update obj_xxx rec_xxx --json-file record.json"),
+    Endpoint("records.delete", "flowbase_records_delete", "DELETE", "/objects/{object_id}/records/{record_id}", "records:write", "Delete a record.", "flowbase records delete obj_xxx rec_xxx --yes", True),
+)
+
+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": "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."},
+    {"key": "metadata.purge", "status": "pending", "reason": "Physical purge is not delivered."},
+)

{flowbase_cli-0.1.1 → flowbase_cli-0.1.3}/src/flowbase_cli/main.py

@@ -12,7 +12,12 @@ from urllib.error import HTTPError, URLError
 from urllib.parse import quote, urlencode
 from urllib.request import Request, urlopen
 
-from flowbase_cli.endpoints import ENDPOINTS, ENDPOINT_BY_KEY, Endpoint
+from flowbase_cli.endpoints import (
+    ENDPOINTS,
+    ENDPOINT_BY_KEY,
+    PENDING_MANAGEMENT_OPERATIONS,
+    Endpoint,
+)
 
 DEFAULT_HOST = "http://flowbase.localhost:5001"
 API_PREFIX = "/api/openapi/v1"
@@ -97,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")
@@ -202,9 +211,42 @@ def run_request(
 
 
 def handle_docs(args: argparse.Namespace) -> int:
+    if args.docs_action == "operations":
+        delivered = [
+            {
+                "key": endpoint.key,
+                "status": "delivered",
+                "operationId": endpoint.operation_id,
+                "method": endpoint.method,
+                "path": endpoint.path,
+                "scope": endpoint.scope,
+                "environments": list(endpoint.environments),
+                "requiresPreflight": endpoint.preflight_operation_id is not None,
+                "requiresConfirmation": endpoint.requires_confirmation,
+                "auditEvent": endpoint.audit_event,
+            }
+            for endpoint in ENDPOINTS
+            if endpoint.scope.startswith("metadata:")
+        ]
+        print(
+            json.dumps(
+                delivered + list(PENDING_MANAGEMENT_OPERATIONS),
+                ensure_ascii=False,
+                indent=2 if args.pretty else None,
+            )
+        )
+        return 0
     if args.docs_action == "list":
         payload = [
-            {"key": e.key, "operationId": e.operation_id, "method": e.method, "path": e.path, "scope": e.scope, "summary": e.summary}
+            {
+                "key": e.key,
+                "operationId": e.operation_id,
+                "method": e.method,
+                "path": e.path,
+                "scope": e.scope,
+                "environments": list(e.environments),
+                "summary": e.summary,
+            }
             for e in ENDPOINTS
         ]
         print(json.dumps(payload, ensure_ascii=False, indent=2 if args.pretty else None))
@@ -218,6 +260,9 @@ def handle_docs(args: argparse.Namespace) -> int:
         "scope": endpoint.scope,
         "summary": endpoint.summary,
         "requiresConfirmation": endpoint.requires_confirmation,
+        "environments": list(endpoint.environments),
+        "preflightOperationId": endpoint.preflight_operation_id,
+        "auditEvent": endpoint.audit_event,
         "example": endpoint.example,
     }
     print(json.dumps(payload, ensure_ascii=False, indent=2 if args.pretty else None))
@@ -268,10 +313,170 @@ 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)
+        body = {"message": args.message}
+        preflight_data = client.request(
+            "changes.direct-release-preflight",
+            body=body,
+        )
+        try:
+            preflight = json.loads(preflight_data)
+        except json.JSONDecodeError as exc:
+            raise CliError("Direct-release preflight returned invalid JSON.") from exc
+        token = preflight.get("confirmationToken")
+        if not isinstance(token, str):
+            raise CliError("Direct-release preflight did not return a confirmation token.")
+        _print_direct_release_preflight(preflight)
+        endpoint = get_endpoint("changes.direct-release")
+        confirm_change(endpoint, args.yes)
+        data = client.request(
+            "changes.direct-release",
+            body={"message": args.message, "confirmationToken": token},
+        )
+        print_output(data, pretty=args.pretty, raw=args.raw)
+        return 0
     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)
+    print(f"  Draft revision: {preflight.get('draftRevision', 'unknown')}", file=sys.stderr)
+    print(
+        f"  Changes: {preflight.get('semanticCount', 0)} semantic, "
+        f"{preflight.get('fileCount', 0)} files",
+        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', '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}
@@ -317,6 +522,7 @@ def build_parser() -> argparse.ArgumentParser:
     docs = groups.add_parser("docs", help="Inspect the offline endpoint catalog.")
     docs_actions = docs.add_subparsers(dest="docs_action", required=True)
     docs_actions.add_parser("list")
+    docs_actions.add_parser("operations")
     docs_show = docs_actions.add_parser("show")
     docs_show.add_argument("endpoint", choices=sorted(ENDPOINT_BY_KEY))
     docs.set_defaults(handler=handle_docs)
@@ -354,14 +560,69 @@ def build_parser() -> argparse.ArgumentParser:
         add_yes(item)
     fields.set_defaults(handler=handle_fields)
 
-    changes = groups.add_parser("changes", help="Commit or release eligible test-environment metadata versions.")
+    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"):
+    for action in ("commit", "release", "direct-release"):
         item = change_actions.add_parser(action)
         item.add_argument("--message", required=True)
         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.3/tests/test_cli.py

@@ -0,0 +1,309 @@
+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))
+
+    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.1/PKG-INFO

@@ -1,31 +0,0 @@
-Metadata-Version: 2.4
-Name: flowbase-cli
-Version: 0.1.1
-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.1/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.1/src/flowbase_cli/endpoints.py

@@ -1,39 +0,0 @@
-"""CLI endpoint catalog, contract-tested against the server OpenAPI schema."""
-from __future__ import annotations
-
-from dataclasses import dataclass
-
-
-@dataclass(frozen=True)
-class Endpoint:
-    key: str
-    operation_id: str
-    method: str
-    path: str
-    scope: str
-    summary: str
-    example: str
-    requires_confirmation: bool = False
-
-
-ENDPOINTS = (
-    Endpoint("objects.list", "flowbase_objects_list", "GET", "/objects", "metadata:read", "List object metadata.", "flowbase objects list"),
-    Endpoint("objects.get", "flowbase_objects_get", "GET", "/objects/{object_id}", "metadata:read", "Get object and field metadata.", "flowbase objects get obj_xxx"),
-    Endpoint("objects.create", "flowbase_objects_create", "POST", "/objects", "metadata:write", "Create an object draft.", "flowbase objects create --json-file object.json"),
-    Endpoint("objects.update", "flowbase_objects_update", "PUT", "/objects/{object_id}", "metadata:write", "Update an object draft.", "flowbase objects update obj_xxx --label Customer --description 'Customer records'"),
-    Endpoint("objects.delete", "flowbase_objects_delete", "DELETE", "/objects/{object_id}", "metadata:write", "Logically delete an object.", "flowbase objects delete obj_xxx --yes", True),
-    Endpoint("objects.restore", "flowbase_objects_restore", "POST", "/objects/{object_id}/restore", "metadata:write", "Restore an object.", "flowbase objects restore obj_xxx --yes", True),
-    Endpoint("fields.create", "flowbase_fields_create", "POST", "/objects/{object_id}/fields", "metadata:write", "Create a field draft.", "flowbase fields create obj_xxx --json-file field.json"),
-    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("changes.commit", "flowbase_changes_commit", "POST", "/changes/commit", "metadata:write", "Commit current test-environment drafts.", "flowbase changes commit --message 'Add customer field' --yes", True),
-    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),
-    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"),
-    Endpoint("records.update", "flowbase_records_update", "PUT", "/objects/{object_id}/records/{record_id}", "records:write", "Replace active field values on a record.", "flowbase records update obj_xxx rec_xxx --json-file record.json"),
-    Endpoint("records.delete", "flowbase_records_delete", "DELETE", "/objects/{object_id}/records/{record_id}", "records:write", "Delete a record.", "flowbase records delete obj_xxx rec_xxx --yes", True),
-)
-
-ENDPOINT_BY_KEY = {endpoint.key: endpoint for endpoint in ENDPOINTS}

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

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

@@ -1,101 +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_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())
-
-
-if __name__ == "__main__":
-    unittest.main()