makea-cli 0.2.14__tar.gz → 0.2.16__tar.gz

{makea_cli-0.2.14 → makea_cli-0.2.16}/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 0.2.16
+
+New: an admin can read, add, edit and remove the AI playbook rules of one
+person (backend 2026-10-18, deploy e408a077 or later).
+
+- `admin list rule --user <user_id|email> [--status …] [--all]`: every rule
+  that holds for the person, from their team, their own account and, for a
+  factory, its company. Archived rules only with `--all`.
+- `admin get rule <rule_id> --user …`: one rule with its evidence.
+- `admin create rule --user … --text … --reason …`: admin-authored, active
+  unless `--status`. Goes to the team when there is one (`--scope` to pick).
+  A repeat or a conflict is refused unless `--force`.
+- `admin update rule <rule_id> --user … --reason …`: text, status,
+  applies_to, which products (`--when`) or mode.
+- `admin delete rule <rule_id> --user … --reason …`: archives the rule, the
+  way the brand's own dismiss does. It leaves the brand's Rules page and every
+  prompt, and Beeboo will not propose the same words again. `update rule
+  --status active` brings it back.
+
+Every write needs `--reason`; the rule records who changed it, why and what
+it was before. An email on two accounts is refused with both user ids.
+
+## 0.2.15
+
+**Behaviour change: `admin get currency-conversion` returns different
+numbers.** This is not only a bug fix. Anyone who reconciled figures with
+this command should expect them to move, by up to several percent per
+currency. The same call on 2026-10-16:
+
+| GBP per | 0.2.14 | 0.2.15 | 1,000 converted, 0.2.14 → 0.2.15 |
+|---|---|---|---|
+| CNY | 0.12 | 0.113 | 120.00 → 113.00 (−5.8%) |
+| USD | 0.76 | 0.752 | 760.00 → 752.00 |
+| EUR | 0.85 | 0.848 | 850.00 → 848.00 |
+
+What changed:
+
+- Rates now come from the platform (`GET /admin/fx/rates`, backend
+  2026-10-16) instead of the CLI fetching the free FX source itself. They are
+  rounded **up to 3 decimals**, as the platform rounds them; 0.2.14 rounded
+  up to 2, which overstated cheap currencies such as CNY most.
+- With one `--from` and `--amount`, `converted` is the platform's own
+  conversion, rounded **up** to the cent; 0.2.14 rounded to the nearest cent.
+- So the numbers now match the platform's prices and revenue metrics, which
+  the 0.2.14 ones did not.
+- Output keys are unchanged except `rounding` (now `"up"`, was
+  `"ceil_2dp"`), plus new `rate_decimals` and `unavailable`. A currency with
+  no rate still fails the command. Needs an admin login, like every `admin`
+  command.
+
 ## 0.2.14
 
 - `admin update tracking-status`: help text no longer describes it as "the

{makea_cli-0.2.14 → makea_cli-0.2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.14
+Version: 0.2.16
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -92,20 +92,23 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin backfill supplier-id` | write（never） | `POST /admin/supplier/backfill_supplier_id_with_quote_requests` | Migrate supplier_id from a wrong UUID to the Cognito user sub (user_id): profile + Cognito supplierReferenceId, optio… | `backfill-supplier-id` |
 | `makea-cli admin create library-element` | write（auto） | `POST /admin/designer/{user_id}/library_components` | save a reusable component under a designer. Provide --section and --values (see admin get library-schema). | `library-create` |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). | `create-quote-request` |
+| `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/users/{user}/rules` | add a rule to one person's AI playbook (user_id or email); admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
 | `makea-cli admin create supplier` | write（ask） | `POST /admin/supplier/add_supplier` | create supplier from JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the field taxonomy (… | `add-supplier` |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
+| `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/users/{user}/rules/{rule_id}` | remove a rule: archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
 | `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
-| `makea-cli admin get currency-conversion` | read | `currency-api` | avoids repeated lookups. | `convert-currency` |
+| `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
 | `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
 | `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
+| `makea-cli admin get rule` | read | `GET /admin/playbook/users/{user}/rules/{rule_id}` | one rule in full, with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
 | `makea-cli admin get tech-spec-extraction` | read | `GET /admin/products/{id}/extract-tech-specifications` | AI-generate specs (not saved). | `extract-ai-tech-spec` |
 | `makea-cli admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
@@ -116,6 +119,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list production-order` | read | `GET /admin/production_orders?type=PRODUCTION` | 大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | `list-all-production-orders` |
 | `makea-cli admin list quote-request` | read | `GET /admin/quote_requests` | quote requests, optionally for one product (--product) or one supplier (--supplier, GET /admin/quote_requests/supplie… | — |
 | `makea-cli admin list restock-order` | read | `GET /admin/production_orders?type=RESTOCK` | restock orders only. Restock shares the production_orders table; this filters to type=RESTOCK. | `list-all-restock-orders` |
+| `makea-cli admin list rule` | read | `GET /admin/playbook/users/{user}/rules` | every AI playbook rule that holds for one person (team, own account, factory): status, scope, text, which products, effect, source. Archived ones only with --all. | — |
 | `makea-cli admin list sampling-order` | read | `GET /admin/sampling_orders/get_all` | paginated list of all sampling orders (admin). | `list-all-sampling-orders` |
 | `makea-cli admin list shipping-order` | read | `GET /admin/shipping_orders` | paginated list of all shipping orders (admin). | `list-all-shipping-orders` |
 | `makea-cli admin list supplier` | read | `GET /admin/supplier/get_all_suppliers` | list all suppliers (admin). | `list-suppliers` |
@@ -129,6 +133,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
+| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
 | `makea-cli admin update tracking-status` | write（ask） | `POST /admin/tracking/carrier_status` | apply a carrier status looked up by hand (tracking-sweep skill) to one order: status, fan-out, delivered emails (--silent: state only). | — |

{makea_cli-0.2.14 → makea_cli-0.2.16}/README.md

@@ -80,20 +80,23 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin backfill supplier-id` | write（never） | `POST /admin/supplier/backfill_supplier_id_with_quote_requests` | Migrate supplier_id from a wrong UUID to the Cognito user sub (user_id): profile + Cognito supplierReferenceId, optio… | `backfill-supplier-id` |
 | `makea-cli admin create library-element` | write（auto） | `POST /admin/designer/{user_id}/library_components` | save a reusable component under a designer. Provide --section and --values (see admin get library-schema). | `library-create` |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). | `create-quote-request` |
+| `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/users/{user}/rules` | add a rule to one person's AI playbook (user_id or email); admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
 | `makea-cli admin create supplier` | write（ask） | `POST /admin/supplier/add_supplier` | create supplier from JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the field taxonomy (… | `add-supplier` |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
+| `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/users/{user}/rules/{rule_id}` | remove a rule: archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
 | `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
-| `makea-cli admin get currency-conversion` | read | `currency-api` | avoids repeated lookups. | `convert-currency` |
+| `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
 | `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
 | `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
+| `makea-cli admin get rule` | read | `GET /admin/playbook/users/{user}/rules/{rule_id}` | one rule in full, with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
 | `makea-cli admin get tech-spec-extraction` | read | `GET /admin/products/{id}/extract-tech-specifications` | AI-generate specs (not saved). | `extract-ai-tech-spec` |
 | `makea-cli admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
@@ -104,6 +107,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list production-order` | read | `GET /admin/production_orders?type=PRODUCTION` | 大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | `list-all-production-orders` |
 | `makea-cli admin list quote-request` | read | `GET /admin/quote_requests` | quote requests, optionally for one product (--product) or one supplier (--supplier, GET /admin/quote_requests/supplie… | — |
 | `makea-cli admin list restock-order` | read | `GET /admin/production_orders?type=RESTOCK` | restock orders only. Restock shares the production_orders table; this filters to type=RESTOCK. | `list-all-restock-orders` |
+| `makea-cli admin list rule` | read | `GET /admin/playbook/users/{user}/rules` | every AI playbook rule that holds for one person (team, own account, factory): status, scope, text, which products, effect, source. Archived ones only with --all. | — |
 | `makea-cli admin list sampling-order` | read | `GET /admin/sampling_orders/get_all` | paginated list of all sampling orders (admin). | `list-all-sampling-orders` |
 | `makea-cli admin list shipping-order` | read | `GET /admin/shipping_orders` | paginated list of all shipping orders (admin). | `list-all-shipping-orders` |
 | `makea-cli admin list supplier` | read | `GET /admin/supplier/get_all_suppliers` | list all suppliers (admin). | `list-suppliers` |
@@ -117,6 +121,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
+| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
 | `makea-cli admin update tracking-status` | write（ask） | `POST /admin/tracking/carrier_status` | apply a carrier status looked up by hand (tracking-sweep skill) to one order: status, fan-out, delivered emails (--silent: state only). | — |

makea_cli-0.2.16/makea_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.16"

{makea_cli-0.2.14 → makea_cli-0.2.16}/makea_cli/api_client.py

@@ -5,7 +5,7 @@ import mimetypes
 from pathlib import Path
 from pathlib import PurePosixPath
 from typing import Any
-from urllib.parse import unquote
+from urllib.parse import quote, unquote
 
 import httpx
 
@@ -197,8 +197,14 @@ def patch_json(path: str, body: Any, *, timeout: float = 60.0) -> Any:
     return _request("PATCH", path, json_body=body, timeout=timeout)
 
 
-def delete_json(path: str, *, params: dict[str, Any] | None = None, timeout: float = 60.0) -> Any:
-    return _request("DELETE", path, params=params, timeout=timeout)
+def delete_json(
+    path: str,
+    *,
+    params: dict[str, Any] | None = None,
+    body: Any = None,
+    timeout: float = 60.0,
+) -> Any:
+    return _request("DELETE", path, params=params, json_body=body, timeout=timeout)
 
 
 def send_admin_raw_email(body: dict[str, Any]) -> Any:
@@ -844,6 +850,18 @@ def get_cumulative_payment_and_platform_revenue(
     )
 
 
+def get_fx_rates(*, to: str, sources: list[str], amount: float | None = None) -> Any:
+    """
+    GET /admin/fx/rates — the platform's own exchange rates (rounded up to its
+    RATE_DECIMALS), and with one source and an amount, that amount converted the
+    way the platform converts it.
+    """
+    params: dict[str, Any] = {"to": to, "from": ",".join(sources)}
+    if amount is not None:
+        params["amount"] = amount
+    return get_json("/admin/fx/rates", params=params)
+
+
 def extract_ai_tech_specifications(product_reference_id: str, *, timeout: float = 300.0) -> Any:
     """
     GET /admin/products/{id}/extract-tech-specifications — synchronous AI extraction;
@@ -1035,6 +1053,51 @@ def admin_delete_library_component(
     )
 
 
+# --- admin: one person's AI playbook rules ---------------------------------------
+# Addressed by user_id or email; the backend resolves every scope the person's
+# rules live in (team, own account, factory) and refuses an email that is on
+# more than one account. Every write carries a reason the rule keeps.
+
+
+def _user_rules_path(user: str, rule_id: str | None = None) -> str:
+    path = f"/admin/playbook/users/{quote(user.strip(), safe='@')}/rules"
+    return f"{path}/{quote(rule_id, safe='')}" if rule_id else path
+
+
+def admin_list_user_rules(
+    user: str, *, status: str | None = None, include_archived: bool = False
+) -> Any:
+    """GET /admin/playbook/users/{user}/rules — every rule that holds for one person."""
+    params: dict[str, Any] = {}
+    if status:
+        params["status"] = status
+    if include_archived:
+        params["include_archived"] = "1"
+    return get_json(_user_rules_path(user), params=params or None)
+
+
+def admin_get_user_rule(user: str, rule_id: str) -> Any:
+    """GET /admin/playbook/users/{user}/rules/{rule_id} — one rule, evidence included."""
+    return get_json(_user_rules_path(user, rule_id))
+
+
+def admin_create_user_rule(user: str, body: dict[str, Any]) -> Any:
+    """POST /admin/playbook/users/{user}/rules — {text, reason, scope?, applies_to?,
+    when?, mode?, category?, polarity?, status?, force?}."""
+    return post_json(_user_rules_path(user), body)
+
+
+def admin_update_user_rule(user: str, rule_id: str, body: dict[str, Any]) -> Any:
+    """PATCH /admin/playbook/users/{user}/rules/{rule_id} — {text?, status?,
+    applies_to?, when?, mode?, reason}."""
+    return patch_json(_user_rules_path(user, rule_id), body)
+
+
+def admin_delete_user_rule(user: str, rule_id: str, reason: str) -> Any:
+    """DELETE /admin/playbook/users/{user}/rules/{rule_id} — archives it, with the reason."""
+    return delete_json(_user_rules_path(user, rule_id), body={"reason": reason})
+
+
 # --- supplier persona: a factory acting on its own RFQs, quotes and orders --------
 
 

{makea_cli-0.2.14 → makea_cli-0.2.16}/makea_cli/commands/__init__.py

@@ -13,6 +13,7 @@ from makea_cli.commands.factory.cmd import register as register_factory
 from makea_cli.commands.library.cmd import register as register_library
 from makea_cli.commands.metrics.cmd import register as register_metrics
 from makea_cli.commands.orders.cmd import register as register_orders
+from makea_cli.commands.playbook.cmd import register as register_playbook
 from makea_cli.commands.product.cmd import register as register_product
 from makea_cli.commands.production.cmd import register as register_production
 from makea_cli.commands.supplier.cmd import register as register_supplier
@@ -33,3 +34,4 @@ def register_all(app: typer.Typer) -> None:
     register_library(app)
     register_factory(app)
     register_brand(app)
+    register_playbook(app)

{makea_cli-0.2.14 → makea_cli-0.2.16}/makea_cli/commands/metrics/cmd.py

@@ -1,8 +1,5 @@
 from __future__ import annotations
 
-import math
-
-import httpx
 import typer
 from rich.console import Console
 
@@ -16,38 +13,6 @@ console = Console()
 _GRANULARITIES = ("day", "week", "month")
 _ORDER_TYPES = ("all", "sampling", "production")
 
-# Same free FX source the backend uses (FreeCurrencyService), so converted
-# amounts match the platform's revenue metrics.
-_FX_PRIMARY = (
-    "https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1/currencies/{base}.json"
-)
-_FX_FALLBACK = "https://latest.currency-api.pages.dev/v1/currencies/{base}.json"
-
-
-def _fx_rate(base: str, target: str) -> float:
-    """Exchange rate base -> target, rounded UP to 2dp exactly like the backend
-    (math.ceil(raw * 100) / 100) so totals reconcile with revenue metrics."""
-    base, target = base.lower(), target.lower()
-    if base == target:
-        return 1.0
-    last_err: Exception | None = None
-    for url in (_FX_PRIMARY.format(base=base), _FX_FALLBACK.format(base=base)):
-        try:
-            with httpx.Client(timeout=10) as client:
-                resp = client.get(url)
-                resp.raise_for_status()
-                data = resp.json()
-            raw = data.get(base, {}).get(target)
-            if raw is not None:
-                return math.ceil(float(raw) * 100) / 100
-        except Exception as e:  # noqa: BLE001 - try fallback URL
-            last_err = e
-            continue
-    raise RuntimeError(
-        f"FX rate {base.upper()}->{target.upper()} unavailable"
-        + (f": {last_err}" if last_err else "")
-    )
-
 
 def register(app: typer.Typer) -> None:
     @command(
@@ -141,13 +106,13 @@ def register(app: typer.Typer) -> None:
         "get",
         "currency-conversion",
         legacy="convert-currency",
-        api="GET currency-api",
-        external="currency-api",
+        api="GET /admin/fx/rates",
         help=(
-            "Convert money between currencies using the same free FX source and "
-            "rounding as the platform's revenue metrics. Pass several source "
-            "currencies via --from (comma-separated) to get a full rate table in "
-            "one call, then convert locally — avoids repeated lookups."
+            "GET /admin/fx/rates — convert money between currencies at the "
+            "platform's own rates and rounding, so totals reconcile with its "
+            "prices and revenue metrics. Pass several source currencies via --from "
+            "(comma-separated) to get a full rate table in one call, then convert "
+            "locally — avoids repeated lookups."
         ),
     )
     def convert_currency(
@@ -165,17 +130,20 @@ def register(app: typer.Typer) -> None:
             help="Optional amount to convert (only meaningful with a single --from).",
         ),
     ) -> None:
-        """Return source->target rates (rounded like the backend), and optionally a
-        converted amount.
+        """Return source->target rates, and optionally a converted amount, as the
+        platform computes them.
 
         Use it to collapse a mixed-currency set into one currency: collect the
         distinct currencies, call once with --from a,b,c to get every rate, then
-        multiply locally. Rates use math.ceil(raw * 100) / 100, matching the
-        platform's FreeCurrencyService, so totals reconcile with revenue metrics.
-
-        Output JSON: {"to", "rates": {CUR: rate, ...}, "rounding", "source"} plus
-        {"from", "rate", "amount", "converted"} when a single --from and --amount
-        are given.
+        multiply locally. The rates are the platform's (FreeCurrencyService,
+        rounded up to ``rate_decimals``) and come from the backend rather than
+        being fetched and rounded here, so they cannot drift from it.
+
+        Output JSON: {"to", "rates": {CUR: rate, ...}, "rate_decimals",
+        "rounding", "source", "unavailable"} plus {"from", "rate", "amount",
+        "converted"} when a single --from and --amount are given; "converted" is
+        the platform's own conversion, rounding included. A currency with no
+        rate fails the command rather than coming back null.
         """
         sources = [s.strip() for s in from_.split(",") if s.strip()]
         if not sources:
@@ -183,22 +151,16 @@ def register(app: typer.Typer) -> None:
             raise typer.Exit(1)
 
         def _do() -> dict:
-            rates = {s.upper(): _fx_rate(s, to) for s in sources}
-            out: dict = {
-                "to": to.upper(),
-                "rates": rates,
-                "rounding": "ceil_2dp",
-                "source": "fawazahmed0/currency-api",
-            }
-            if amount is not None and len(sources) == 1:
-                rate = rates[sources[0].upper()]
-                out.update(
-                    {
-                        "from": sources[0].upper(),
-                        "rate": rate,
-                        "amount": amount,
-                        "converted": round(amount * rate, 2),
-                    }
+            payload = api_client.get_fx_rates(
+                to=to,
+                sources=sources,
+                amount=amount if len(sources) == 1 else None,
+            )
+            out = (payload or {}).get("result") or {}
+            if out.get("unavailable"):
+                raise RuntimeError(
+                    "FX rate unavailable: "
+                    + ", ".join(f"{s}->{to.upper()}" for s in out["unavailable"])
                 )
             return out