qapu-cli 0.78.0__tar.gz → 0.83.0__tar.gz

{qapu_cli-0.78.0 → qapu_cli-0.83.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapu-cli
-Version: 0.78.0
+Version: 0.83.0
 Summary: CLI client for the Qapu API - built for the Hermes agent, but usable by anyone talking to api.ovoo.com.tr from outside the Swarm.
 Author: OVOO Technology
 Classifier: Programming Language :: Python :: 3
@@ -67,7 +67,7 @@ Either way installs a `qapu` command (see `pyproject.toml`'s `[project.scripts]`
 | `qapu data` | Readings per variable for a device - latest value, last N buffered readings (--last), daily min/avg/max (--days), an explicit --start/--end range, or a live-refreshed view (--watch) (GET /hermes/data/{device_id}). |
 | `qapu energy` | One day's active/reactive energy breakdown per phase, or --days/--start/--end for a per-day breakdown plus a cumulative Total (GET /hermes/energy/{device_id}). |
 | `qapu health` | Check CLI/server version, connectivity, and server status (GET /health, no auth required). |
-| `qapu login` | Log in and save a Bearer JWT locally for `auth-token *` - `qapu login [username]` (operator/CLI, Username+Password, POST /auth/login/cli) is the **default**, prompting for whatever wasn't given, password always hidden, never a CLI flag. `qapu login --phone <number>` (mobile-app Phone+Pin, POST /auth/login) is an explicit opt-in, never mixed with a username. |
+| `qapu login` | Log in and save a Bearer JWT locally for `auth-token *` - `qapu login [username]` (operator/CLI, Username+Password, POST /auth/login/cli) is the **default**, prompting for whatever wasn't given, password always hidden, never a CLI flag. `qapu login --phone <number>` (mobile-app Phone+Pin, POST /auth/login) is an explicit opt-in, never mixed with a username. `qapu login --browser` logs in on auth.ovoo.com.tr's own page (SSO; no password at all when the browser is already logged in), needs a browser on this machine. |
 | `qapu logout` | Clear the locally saved Bearer JWT (client-side only) - does **not** clear a saved Hermes API token, see "Auth" below. |
 | `qapu whoami` | Show the currently logged-in account, from the locally saved credentials. |
 | `qapu pipeline` | Fleet-wide pipeline throughput for a time window - ingest/data/rule/blockchain packet+event counts (GET /hermes/pipeline/stats). `--watch` live-refreshes in place. |
@@ -85,6 +85,7 @@ Either way installs a `qapu` command (see `pyproject.toml`'s `[project.scripts]`
 | `qapu device list` | List every device Qapu knows about (GET /hermes/devices). |
 | `qapu device reliability` | Analyze a device's periodic packet delivery over a time window - total/expected packets, delivery rate, average/min/max interval, estimated missed packets, longest gap (GET /hermes/reliability/{device_id}). |
 | `qapu score list` | List recent Cinga Score snapshot rows, optionally filtered by device/window type (GET /hermes/scores). |
+| `qapu score fleet-summary --device-ids A,B,C [--window-type ...] [--json]` | Latest four cards per device, worst card first, with the change since the window start (GET /hermes/scores/fleet-summary). |
 | `qapu score get` | Single snapshot detail (GET /hermes/scores/{score_id}). |
 | `qapu score bundle` | The AI-facing structured packet for one snapshot (GET /hermes/scores/{score_id}/bundle). |
 | `qapu score revisions` | Every revision (ACTIVE/SUPERSEDED) of the same logical period (GET /hermes/scores/{score_id}/revisions). |
@@ -99,6 +100,7 @@ Either way installs a `qapu` command (see `pyproject.toml`'s `[project.scripts]`
 |---|---|
 | `qapu variable get` | Get one variable's detail (GET /hermes/variables/{variable_id}). |
 | `qapu variable list` | List the variable catalog (GET /hermes/variables). |
+| `qapu variable stats` | Stored readings per variable - typed table, reading/device counts, first/last time, last 24 h; `--segment`, `--stored-only` (GET /hermes/variables/stats, recomputed hourly by services/windows). |
 
 #### `group` - device groups
 

{qapu_cli-0.78.0 → qapu_cli-0.83.0}/README.md

@@ -50,7 +50,7 @@ Either way installs a `qapu` command (see `pyproject.toml`'s `[project.scripts]`
 | `qapu data` | Readings per variable for a device - latest value, last N buffered readings (--last), daily min/avg/max (--days), an explicit --start/--end range, or a live-refreshed view (--watch) (GET /hermes/data/{device_id}). |
 | `qapu energy` | One day's active/reactive energy breakdown per phase, or --days/--start/--end for a per-day breakdown plus a cumulative Total (GET /hermes/energy/{device_id}). |
 | `qapu health` | Check CLI/server version, connectivity, and server status (GET /health, no auth required). |
-| `qapu login` | Log in and save a Bearer JWT locally for `auth-token *` - `qapu login [username]` (operator/CLI, Username+Password, POST /auth/login/cli) is the **default**, prompting for whatever wasn't given, password always hidden, never a CLI flag. `qapu login --phone <number>` (mobile-app Phone+Pin, POST /auth/login) is an explicit opt-in, never mixed with a username. |
+| `qapu login` | Log in and save a Bearer JWT locally for `auth-token *` - `qapu login [username]` (operator/CLI, Username+Password, POST /auth/login/cli) is the **default**, prompting for whatever wasn't given, password always hidden, never a CLI flag. `qapu login --phone <number>` (mobile-app Phone+Pin, POST /auth/login) is an explicit opt-in, never mixed with a username. `qapu login --browser` logs in on auth.ovoo.com.tr's own page (SSO; no password at all when the browser is already logged in), needs a browser on this machine. |
 | `qapu logout` | Clear the locally saved Bearer JWT (client-side only) - does **not** clear a saved Hermes API token, see "Auth" below. |
 | `qapu whoami` | Show the currently logged-in account, from the locally saved credentials. |
 | `qapu pipeline` | Fleet-wide pipeline throughput for a time window - ingest/data/rule/blockchain packet+event counts (GET /hermes/pipeline/stats). `--watch` live-refreshes in place. |
@@ -68,6 +68,7 @@ Either way installs a `qapu` command (see `pyproject.toml`'s `[project.scripts]`
 | `qapu device list` | List every device Qapu knows about (GET /hermes/devices). |
 | `qapu device reliability` | Analyze a device's periodic packet delivery over a time window - total/expected packets, delivery rate, average/min/max interval, estimated missed packets, longest gap (GET /hermes/reliability/{device_id}). |
 | `qapu score list` | List recent Cinga Score snapshot rows, optionally filtered by device/window type (GET /hermes/scores). |
+| `qapu score fleet-summary --device-ids A,B,C [--window-type ...] [--json]` | Latest four cards per device, worst card first, with the change since the window start (GET /hermes/scores/fleet-summary). |
 | `qapu score get` | Single snapshot detail (GET /hermes/scores/{score_id}). |
 | `qapu score bundle` | The AI-facing structured packet for one snapshot (GET /hermes/scores/{score_id}/bundle). |
 | `qapu score revisions` | Every revision (ACTIVE/SUPERSEDED) of the same logical period (GET /hermes/scores/{score_id}/revisions). |
@@ -82,6 +83,7 @@ Either way installs a `qapu` command (see `pyproject.toml`'s `[project.scripts]`
 |---|---|
 | `qapu variable get` | Get one variable's detail (GET /hermes/variables/{variable_id}). |
 | `qapu variable list` | List the variable catalog (GET /hermes/variables). |
+| `qapu variable stats` | Stored readings per variable - typed table, reading/device counts, first/last time, last 24 h; `--segment`, `--stored-only` (GET /hermes/variables/stats, recomputed hourly by services/windows). |
 
 #### `group` - device groups
 

{qapu_cli-0.78.0 → qapu_cli-0.83.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qapu-cli"
-version = "0.78.0"
+version = "0.83.0"
 description = "CLI client for the Qapu API - built for the Hermes agent, but usable by anyone talking to api.ovoo.com.tr from outside the Swarm."
 readme = "README.md"
 requires-python = ">=3.10"

{qapu_cli-0.78.0 → qapu_cli-0.83.0}/qapu_cli/client.py

@@ -261,6 +261,21 @@ def _request(method: str, path: str, params: dict[str, Any] | None = None, json_
 		raise ClientError(_report_request_error(e, method, url))
 
 
+# Upload one File as multipart/form-data (2026-10-26, Firmware Files) - a
+# Longer Write/Read Timeout Than JSON Calls: the Server Also Relays it to FTP
+def post_file(path: str, file_path: str, field: str = "file", data: dict[str, Any] | None = None) -> Any:
+	url = f"{_base_url()}{path}"
+	try:
+		with open(file_path, "rb") as handle:
+			response = httpx.post(url, headers=_headers(), files={field: (os.path.basename(file_path), handle, "application/octet-stream")}, data=data or {}, timeout=httpx.Timeout(connect=5.0, read=120.0, write=120.0, pool=5.0))
+		response.raise_for_status()
+		return response.json()
+	except httpx.HTTPStatusError as e:
+		raise ClientError(_report_http_status_error(e, "POST", url))
+	except httpx.RequestError as e:
+		raise ClientError(_report_request_error(e, "POST", url))
+
+
 def post(path: str, params: dict[str, Any] | None = None, json_body: dict[str, Any] | None = None) -> Any:
 
 	# Issue a POST Request

{qapu_cli-0.78.0 → qapu_cli-0.83.0}/qapu_cli/command_packages.py

@@ -125,7 +125,12 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"fleet_data": frozenset({"telemetry:read"}),
 	"fleet_score": frozenset({"scores:read"}),
 	"fleet_status": frozenset({"devices:read", "infrastructure:read", "platform-config:read"}),
+	"fota_approvals": frozenset({"hardware-catalog:read"}),
+	"fota_approve": frozenset({"hardware-catalog:write"}),
+	"fota_confirmations": frozenset({"hardware-catalog:read"}),
+	"fota_reports": frozenset({"hardware-catalog:read"}),
 	"fota_ftp": frozenset({"device-actuation:write", "hardware-catalog:read"}),
+	"fota_revoke": frozenset({"hardware-catalog:write"}),
 	"fota_http": frozenset({"device-actuation:write", "hardware-catalog:read"}),
 	"fota_upload": frozenset({"hardware-catalog:read", "hardware-catalog:write"}),
 	"group_add": frozenset({"infrastructure:write"}),
@@ -165,8 +170,11 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"model_get": frozenset({"hardware-catalog:read"}),
 	"model_list": frozenset({"hardware-catalog:read"}),
 	"model_update": frozenset({"hardware-catalog:write"}),
+	"modem_add": frozenset({"hardware-catalog:write"}),
+	"modem_delete": frozenset({"hardware-catalog:write"}),
 	"modem_get": frozenset({"hardware-catalog:read"}),
 	"modem_list": frozenset({"hardware-catalog:read"}),
+	"modem_update": frozenset({"hardware-catalog:write"}),
 	"mqtt_provision": frozenset({"device-actuation:write"}),
 	"pipeline_stats": frozenset({"platform-config:read"}),
 	"project_add": frozenset({"platform-config:write"}),
@@ -193,6 +201,7 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"score_bundle": frozenset({"scores:read"}),
 	"score_calculate": frozenset({"scores:write"}),
 	"score_delete": frozenset({"scores:write"}),
+	"score_fleet_summary": frozenset({"telemetry:read"}),
 	"score_get": frozenset({"scores:read"}),
 	"score_list": frozenset({"scores:read"}),
 	"score_narrative": frozenset({"scores:write"}),
@@ -246,6 +255,16 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"user_update": frozenset({"users:write"}),
 	"variable_get": frozenset({"platform-config:read"}),
 	"variable_list": frozenset({"platform-config:read"}),
+	"variable_stats": frozenset({"platform-config:read"}),
+	# Notifications (2026-11-11) - hermes_notifications.py routes (not in the hermes.py route table the
+	# derivation reads): always visible, Hermes enforces devices:read / users:* / notifications:*
+	"notification_channel_set": frozenset(),
+	"notification_channels": frozenset(),
+	"notification_log": frozenset(),
+	"notification_set": frozenset(),
+	"notification_settings": frozenset(),
+	"notification_type_update": frozenset(),
+	"notification_types": frozenset(),
 	"whoami": frozenset(),
 }