qapu-cli 0.74.0__tar.gz → 0.76.0__tar.gz

{qapu_cli-0.74.0 → qapu_cli-0.76.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapu-cli
-Version: 0.74.0
+Version: 0.76.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

{qapu_cli-0.74.0 → qapu_cli-0.76.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qapu-cli"
-version = "0.74.0"
+version = "0.76.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.74.0 → qapu_cli-0.76.0}/qapu_cli/command_packages.py

@@ -63,6 +63,17 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"calibration_get": frozenset({"calibration:read"}),
 	"calibration_list": frozenset({"calibration:read"}),
 	"calibration_update": frozenset({"calibration:write"}),
+	"calibration_assignment_add": frozenset({"calibration:write"}),
+	"calibration_assignment_delete": frozenset({"calibration:write"}),
+	"calibration_assignment_get": frozenset({"calibration:read"}),
+	"calibration_assignment_list": frozenset({"calibration:read"}),
+	"calibration_assignment_retire": frozenset({"calibration:write"}),
+	"calibration_assignment_update": frozenset({"calibration:write"}),
+	"calibration_profile_add": frozenset({"calibration:write"}),
+	"calibration_profile_delete": frozenset({"calibration:write"}),
+	"calibration_profile_get": frozenset({"calibration:read"}),
+	"calibration_profile_list": frozenset({"calibration:read"}),
+	"calibration_profile_update": frozenset({"calibration:write"}),
 	"cinga_ai_list": frozenset({"mcp:read-only"}),
 	"cinga_ai_log": frozenset({"observability:write"}),
 	"crop_type_add": frozenset({"operations-catalog:write"}),
@@ -90,6 +101,7 @@ COMMAND_REQUIRED_PACKAGES: dict[str, frozenset[str]] = {
 	"device_power": frozenset({"telemetry:read"}),
 	"device_purge_history": frozenset({"devices:destructive"}),
 	"device_reliability": frozenset({"telemetry:read"}),
+	"device_windows": frozenset({"telemetry:read"}),
 	"device_trend": frozenset({"telemetry:read"}),
 	"device_voltage": frozenset({"telemetry:read"}),
 	"equipment_add": frozenset({"infrastructure:write"}),

{qapu_cli-0.74.0 → qapu_cli-0.76.0}/qapu_cli/main.py

@@ -78,7 +78,11 @@ app.add_typer(equipment_relation_app, name="equipment-relation", rich_help_panel
 blockchain_app = typer.Typer(no_args_is_help=True, help="Device blockchain commands (mined block ledger).")
 app.add_typer(blockchain_app, name="blockchain", rich_help_panel="Analiz & Skor")
 calibration_app = typer.Typer(no_args_is_help=True, help="Device calibration commands (Gain/Offset per variable).")
+calibration_profile_app = typer.Typer(no_args_is_help=True, help="Reusable calibration profile commands (2026-10-15 redesign - share one Gain/Offset definition across many assignments).")
+calibration_assignment_app = typer.Typer(no_args_is_help=True, help="Calibration assignment commands (2026-10-15 redesign - DEVICE/GROUP/GLOBAL scope, priority, time-windowed validity).")
 app.add_typer(calibration_app, name="calibration", rich_help_panel="Analiz & Skor")
+app.add_typer(calibration_profile_app, name="calibration-profile", rich_help_panel="Analiz & Skor")
+app.add_typer(calibration_assignment_app, name="calibration-assignment", rich_help_panel="Analiz & Skor")
 score_app = typer.Typer(no_args_is_help=True, help="Cinga Score commands (cinga_score_snapshot rows - list/get/bundle/revisions/calculate/analysis-request/narrative/delete).")
 app.add_typer(score_app, name="score", rich_help_panel="Analiz & Skor")
 crop_type_app = typer.Typer(no_args_is_help=True, help="Crop type catalog commands.")
@@ -1161,6 +1165,91 @@ def device_reliability(
 	]))
 
 
+_WINDOWS_PERIOD_TYPE_TO_CODE = {"day": 1, "week": 7, "month": 30}
+_WINDOWS_PERIOD_CODE_TO_LABEL = {1: "Günlük", 7: "Haftalık", 30: "Aylık"}
+
+
+@device_app.command("windows")
+def device_windows(
+	device_id: str = typer.Argument(..., help="Device ID."),
+	variable_id: Optional[str] = typer.Option(None, "--variable-id", help="Restrict to one variable (e.g. VRMS_A). Omit for every in-scope variable."),
+	period: Optional[str] = typer.Option(None, "--period", help="day | week | month. Omit for all three."),
+	days: Optional[int] = typer.Option(None, "--days", help="Window size in days, by window_start, ending now. Ignored if --start/--end are given."),
+	start: Optional[str] = typer.Option(None, "--start", help="ISO date/datetime lower bound on window_start, inclusive. Takes priority over --days."),
+	end: Optional[str] = typer.Option(None, "--end", help="ISO date/datetime upper bound on window_start, exclusive. Takes priority over --days."),
+	limit: Optional[int] = typer.Option(None, "--limit", help="Cap the number of rows shown. Omit to page through everything interactively."),
+	as_json: bool = typer.Option(False, "--json", help="Print raw JSON instead of a human-readable table."),
+):
+	"""Pre-computed daily/weekly/monthly statistics for a device, voltage/current/power/energy only (GET /hermes/windows/{device_id}). Not real-time - see `qapu trend`/`qapu data` for live readings."""
+
+	# Translate --period's Friendly Name Into the Raw int the API Expects
+	period_type: Optional[int] = None
+	if period is not None:
+		period_type = _WINDOWS_PERIOD_TYPE_TO_CODE.get(period.strip().lower())
+		if period_type is None:
+			console.print(f"[red]Geçersiz --period değeri: {period!r} (day, week veya month olmalı)[/red]")
+			raise typer.Exit(code=1)
+
+	# Fetch the Rows
+	params: dict[str, Any] = {}
+	if variable_id:
+		params["variable_id"] = variable_id
+	if period_type is not None:
+		params["period_type"] = period_type
+	if start or end:
+		if start:
+			params["start"] = start
+		if end:
+			params["end"] = end
+	elif days is not None:
+		params["days"] = days
+	rows: list[dict[str, Any]] = client.get(f"/hermes/windows/{device_id}", params=params)
+
+	# JSON Output - Nothing Further to Format
+	if as_json:
+		typer.echo(json.dumps(rows, indent=2))
+		return
+
+	# No Rows - Say so Plainly
+	if not rows:
+		console.print(f"[yellow]{device_id} için kayıt bulunamadı.[/yellow]")
+		return
+
+	# Build and Print the Table, Paginated Like Every Other Long List in
+	# This CLI (device/variable/synthesis list) - a Device's own Window
+	# History Can Easily Run Into the Hundreds of Rows Once Every Variable
+	# and Period Type is Included.
+	build_table = _simple_table_builder([
+		("DÖNEM", "period_type"),
+		("DEĞİŞKEN", "variable_id"),
+		("BAŞLANGIÇ", "window_start"),
+		("ORT", "mean"),
+		("MIN", "min"),
+		("MAKS", "max"),
+		("ÖRNEK", "sample_count"),
+		("TAMLIK", "completeness_ratio"),
+	])
+
+	# Pretty-Print Each Row's period_type/window_start/completeness_ratio
+	# Before Handing off to the Generic Table Builder - Raw int Period
+	# Codes and ISO Timestamps/Ratios Read Poorly Side by Side With Every
+	# Other Column's Already-Human Values.
+	display_rows = []
+	for row in rows:
+		display_row = dict(row)
+		display_row["period_type"] = _WINDOWS_PERIOD_CODE_TO_LABEL.get(row.get("period_type"), row.get("period_type"))
+		display_row["window_start"] = _format_time(row.get("window_start"))
+		ratio = row.get("completeness_ratio")
+		display_row["completeness_ratio"] = f"%{ratio * 100:.0f}" if ratio is not None else "-"
+		for numeric_col in ("mean", "min", "max"):
+			value = row.get(numeric_col)
+			if isinstance(value, (int, float)):
+				display_row[numeric_col] = round(value, 3)
+		display_rows.append(display_row)
+
+	_print_paginated(display_rows, build_table, limit, "pencere")
+
+
 @device_app.command("purge-history")
 def device_purge_history(
 	device_id: str = typer.Argument(..., help="Device ID."),
@@ -5419,9 +5508,14 @@ def calibration_list(device_id: str = typer.Argument(...), as_json: bool = typer
 		typer.echo("Bu cihaz için kalibrasyon kaydı yok.")
 		return
 
-	# Build the Table
+	# Build the Table - SCOPE (2026-10-15, calibration_profiles/
+	# calibration_assignments Redesign) Shows Which Scope Tier This
+	# Device's Effective Value Actually Came From; ID is Blank for a
+	# GROUP/GLOBAL-Inherited row (not Directly Editable at This Device's
+	# Level - See Calibration.list()'s own Docstring)
 	table = Table(show_header=True, header_style="bold")
 	table.add_column("ID", justify="right")
+	table.add_column("SCOPE")
 	table.add_column("VARIABLE")
 	table.add_column("GAIN", justify="right")
 	table.add_column("OFFSET", justify="right")
@@ -5430,7 +5524,8 @@ def calibration_list(device_id: str = typer.Argument(...), as_json: bool = typer
 	for item in items:
 		variable = item.get("Variable") or {}
 		table.add_row(
-			str(item.get("ID")),
+			str(item.get("ID")) if item.get("ID") is not None else "-",
+			item.get("Scope") or "-",
 			variable.get("ID") or "-",
 			str(item.get("Gain")) if item.get("Gain") is not None else "-",
 			str(item.get("Offset")) if item.get("Offset") is not None else "-",
@@ -5496,6 +5591,195 @@ def calibration_delete(calibration_id: int = typer.Argument(...)):
 	typer.echo(result.get("Message", result))
 
 
+# Calibration Profile Commands (2026-10-15) - Reusable Gain/Offset
+# Definitions, Genuinely Shareable Across Many Calibration_Assignment rows
+
+@calibration_profile_app.command("list")
+def calibration_profile_list(variable_id: Optional[str] = typer.Option(None, "--variable-id"), as_json: bool = typer.Option(False, "--json")):
+	"""List reusable calibration profiles (GET /hermes/calibration-profiles)."""
+	items: list[dict[str, Any]] = client.get("/hermes/calibration-profiles", params={"variable_id": variable_id} if variable_id else None)
+	if as_json:
+		typer.echo(json.dumps(items, indent=2))
+		return
+	if not items:
+		typer.echo("Hiç kalibrasyon profili yok.")
+		return
+	table = Table(show_header=True, header_style="bold")
+	table.add_column("ID", justify="right")
+	table.add_column("VARIABLE")
+	table.add_column("GAIN", justify="right")
+	table.add_column("OFFSET", justify="right")
+	table.add_column("ACTIVE")
+	table.add_column("DESCRIPTION")
+	for item in items:
+		variable = item.get("Variable") or {}
+		table.add_row(str(item.get("ID")), variable.get("ID") or "-", str(item.get("Gain")), str(item.get("Offset")), "✓" if item.get("Is_Active") else "-", item.get("Description") or "-")
+	console.print(table)
+
+
+@calibration_profile_app.command("get")
+def calibration_profile_get(profile_id: int = typer.Argument(...), as_json: bool = typer.Option(False, "--json")):
+	"""Get one calibration profile's detail (GET /hermes/calibration-profiles/{profile_id})."""
+	result = client.get(f"/hermes/calibration-profiles/{profile_id}")
+	if as_json:
+		typer.echo(json.dumps(result, indent=2))
+		return
+	_print_detail(result)
+
+
+@calibration_profile_app.command("add")
+def calibration_profile_add(
+	variable_id: str = typer.Argument(..., help="Variable ID this profile applies to."),
+	gain: float = typer.Option(..., "--gain"),
+	offset: float = typer.Option(..., "--offset"),
+	description: Optional[str] = typer.Option(None, "--description"),
+):
+	"""Create a new, standalone calibration profile - not assigned to anything until a calibration-assignment points at it (POST /hermes/calibration-profiles)."""
+	body: dict[str, Any] = {"Variable": {"ID": variable_id}, "Gain": gain, "Offset": offset}
+	if description is not None:
+		body["Description"] = description
+	result = client.post("/hermes/calibration-profiles", json_body=body)
+	typer.echo(result.get("Message", result))
+
+
+@calibration_profile_app.command("update")
+def calibration_profile_update(
+	profile_id: int = typer.Argument(...),
+	gain: Optional[float] = typer.Option(None, "--gain"),
+	offset: Optional[float] = typer.Option(None, "--offset"),
+	is_active: Optional[bool] = typer.Option(None, "--active/--inactive"),
+	description: Optional[str] = typer.Option(None, "--description"),
+):
+	"""Update a calibration profile - only the fields passed are changed. Affects every assignment pointing at it (PUT /hermes/calibration-profiles/{profile_id})."""
+	body: dict[str, Any] = {}
+	if gain is not None:
+		body["Gain"] = gain
+	if offset is not None:
+		body["Offset"] = offset
+	if is_active is not None:
+		body["Is_Active"] = is_active
+	if description is not None:
+		body["Description"] = description
+	result = client.put(f"/hermes/calibration-profiles/{profile_id}", json_body=body)
+	typer.echo(result.get("Message", result))
+
+
+@calibration_profile_app.command("delete")
+def calibration_profile_delete(profile_id: int = typer.Argument(...)):
+	"""Delete a calibration profile - refuses if any assignment still points at it (DELETE /hermes/calibration-profiles/{profile_id})."""
+	result = client.delete(f"/hermes/calibration-profiles/{profile_id}")
+	typer.echo(result.get("Message", result))
+
+
+# Calibration Assignment Commands (2026-10-15) - DEVICE/GROUP/GLOBAL
+# Scope, Priority, Time-Windowed Validity. The Only way to Create a
+# GROUP/GLOBAL Assignment, or to Point a new Assignment at an Existing
+# Profile for Real Reuse.
+
+@calibration_assignment_app.command("list")
+def calibration_assignment_list(
+	variable_id: Optional[str] = typer.Option(None, "--variable-id"),
+	device_id: Optional[str] = typer.Option(None, "--device-id"),
+	group_id: Optional[int] = typer.Option(None, "--group-id"),
+	scope_type: Optional[str] = typer.Option(None, "--scope", help="DEVICE / GROUP / GLOBAL"),
+	calibration_id: Optional[int] = typer.Option(None, "--profile-id"),
+	as_json: bool = typer.Option(False, "--json"),
+):
+	"""List calibration assignments (GET /hermes/calibration-assignments)."""
+	params = {"variable_id": variable_id, "device_id": device_id, "group_id": group_id, "scope_type": scope_type, "calibration_id": calibration_id}
+	items: list[dict[str, Any]] = client.get("/hermes/calibration-assignments", params={k: v for k, v in params.items() if v is not None})
+	if as_json:
+		typer.echo(json.dumps(items, indent=2))
+		return
+	if not items:
+		typer.echo("Hiç kalibrasyon ataması yok.")
+		return
+	table = Table(show_header=True, header_style="bold")
+	table.add_column("ID", justify="right")
+	table.add_column("PROFILE", justify="right")
+	table.add_column("VARIABLE")
+	table.add_column("SCOPE")
+	table.add_column("TARGET")
+	table.add_column("PRIORITY", justify="right")
+	table.add_column("ACTIVE")
+	table.add_column("EFFECTIVE FROM")
+	table.add_column("EFFECTIVE TO")
+	for item in items:
+		target = item.get("Device_ID") or (f"group:{item.get('Group_ID')}" if item.get("Group_ID") else "-")
+		table.add_row(
+			str(item.get("ID")), str(item.get("Calibration_ID")), item.get("Variable_ID") or "-", item.get("Scope_Type") or "-",
+			target, str(item.get("Priority_Override")) if item.get("Priority_Override") is not None else "-",
+			"✓" if item.get("Is_Active") else "-", item.get("Effective_From") or "-", item.get("Effective_To") or "-",
+		)
+	console.print(table)
+
+
+@calibration_assignment_app.command("get")
+def calibration_assignment_get(assignment_id: int = typer.Argument(...), as_json: bool = typer.Option(False, "--json")):
+	"""Get one calibration assignment's detail (GET /hermes/calibration-assignments/{assignment_id})."""
+	result = client.get(f"/hermes/calibration-assignments/{assignment_id}")
+	if as_json:
+		typer.echo(json.dumps(result, indent=2))
+		return
+	_print_detail(result)
+
+
+@calibration_assignment_app.command("add")
+def calibration_assignment_add(
+	profile_id: int = typer.Argument(..., help="The calibration-profile ID this assignment points at."),
+	scope: str = typer.Option(..., "--scope", help="DEVICE / GROUP / GLOBAL"),
+	device_id: Optional[str] = typer.Option(None, "--device-id", help="Required for --scope DEVICE."),
+	group_id: Optional[int] = typer.Option(None, "--group-id", help="Required for --scope GROUP."),
+	priority: Optional[int] = typer.Option(None, "--priority", help="Lower value wins ties (e.g. a device belonging to multiple groups)."),
+):
+	"""Create a new calibration assignment - the only way to create a GROUP/GLOBAL-scope assignment, or to point a new assignment at an existing profile for real reuse (POST /hermes/calibration-assignments)."""
+	body: dict[str, Any] = {"Calibration_ID": profile_id, "Scope_Type": scope.upper()}
+	if device_id is not None:
+		body["Device_ID"] = device_id
+	if group_id is not None:
+		body["Group_ID"] = group_id
+	if priority is not None:
+		body["Priority_Override"] = priority
+	result = client.post("/hermes/calibration-assignments", json_body=body)
+	typer.echo(result.get("Message", result))
+
+
+@calibration_assignment_app.command("update")
+def calibration_assignment_update(
+	assignment_id: int = typer.Argument(...),
+	priority: Optional[int] = typer.Option(None, "--priority"),
+	effective_from: Optional[str] = typer.Option(None, "--effective-from"),
+	effective_to: Optional[str] = typer.Option(None, "--effective-to"),
+	is_active: Optional[bool] = typer.Option(None, "--active/--inactive"),
+):
+	"""Update an assignment's priority/validity window/active flag - scope/target/profile are not editable here (delete+add instead) (PUT /hermes/calibration-assignments/{assignment_id})."""
+	body: dict[str, Any] = {}
+	if priority is not None:
+		body["Priority_Override"] = priority
+	if effective_from is not None:
+		body["Effective_From"] = effective_from
+	if effective_to is not None:
+		body["Effective_To"] = effective_to
+	if is_active is not None:
+		body["Is_Active"] = is_active
+	result = client.put(f"/hermes/calibration-assignments/{assignment_id}", json_body=body)
+	typer.echo(result.get("Message", result))
+
+
+@calibration_assignment_app.command("retire")
+def calibration_assignment_retire(assignment_id: int = typer.Argument(...)):
+	"""Retire an assignment (Effective_To=now(), Is_Active=false) - preserves it as real history instead of deleting it (POST /hermes/calibration-assignments/{assignment_id}/retire)."""
+	result = client.post(f"/hermes/calibration-assignments/{assignment_id}/retire", json_body={})
+	typer.echo(result.get("Message", result))
+
+
+@calibration_assignment_app.command("delete")
+def calibration_assignment_delete(assignment_id: int = typer.Argument(...)):
+	"""Delete a calibration assignment outright - loses history, prefer 'retire' when the point is to preserve it (DELETE /hermes/calibration-assignments/{assignment_id})."""
+	result = client.delete(f"/hermes/calibration-assignments/{assignment_id}")
+	typer.echo(result.get("Message", result))
+
+
 # Device Trigger-Rule Commands (2026-10-10) - This is the Real Device-
 # Side Rule Engine services/rule Evaluates on Every qapu.stream Message
 # (Low Voltage/High Current/Pump Active/etc.) - Distinct From `synthesis`
@@ -7661,7 +7945,7 @@ def _console_fetch(device_id: str) -> dict[str, Any]:
 @auth_token_app.command("create")
 def auth_token_create(
 	label: str = typer.Argument(..., help="A human-readable label for this token, e.g. 'macbook-mcp'."),
-	packages: str = typer.Option(..., "--packages", help="Comma-separated permission package codes, e.g. catalog:read,telemetry:read - must be a subset of your own granted packages."),
+	packages: str = typer.Option(..., "--packages", help="Comma-separated permission package codes, e.g. devices:read,telemetry:read,infrastructure:read - must be a subset of your own granted packages (see `qapu user tiers` for the current catalog; `catalog:read`/`infrastructure:*`/`telemetry:write` are the RETIRED pre-2026-10-10 names and no longer unlock any route)."),
 	expires_in_days: int = typer.Option(90, "--expires-in-days"),
 	no_save: bool = typer.Option(False, "--no-save", help="Skip the 'save as active Hermes token?' prompt entirely - print the raw token and nothing else."),
 ):

{qapu_cli-0.74.0 → qapu_cli-0.76.0}/qapu_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapu-cli
-Version: 0.74.0
+Version: 0.76.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