@fugood/bricks-cli 2.26.0-beta.20 → 2.26.0-beta.22

package/README.md

@@ -170,9 +170,18 @@ bricks device list [-k keyword] [-j|--json]
 # Resolve a device name or ID
 bricks device resolve <query> [-l limit] [-j|--json]
 
-# Get device details
+# Get device details (incl. stored Lock, Activity Log and Local Sync settings)
 bricks device get <device-id> [-j|--json]
 
+# Update device settings (only the given settings change; other ENV variables are kept)
+bricks device update <device-id> [-n name] [-d description] [--tags a,b] [--dry-run] [-j|--json]
+bricks device update <device-id> [-e KEY=VALUE ...] [--env-json '{"KEY":"value"}'] [--unset-env KEY ...]
+bricks device update <device-id> [--[no-]activity-log] [--activity-log-filter filter] [--[no-]activity-log-screenshot]
+bricks device update <device-id> [--[no-]local-sync] [--local-sync-priority 0-9] [--[no-]local-sync-dynamic-latency] [--local-sync-latency-offset ms]
+bricks device update <device-id> --lock | --unlock
+# --lock / --unlock run alone. A locked device refuses other updates: unlock it first.
+# ENV changes reach the running app after `bricks device refresh <device-id>` (not automatic).
+
 # Bind a new device with passcode
 bricks device bind <passcode> [-n device-name]
 bricks device bind <passcode> [--dry-run] [-j|--json]
@@ -206,8 +215,8 @@ bricks app resolve <query> [-l limit] [-j|--json]
 # Get application details
 bricks app get <app-id> [-c|--composed] [-j|--json]
 
-# Update application
-bricks app update <app-id> [-n name] [-d description] [-c config-json] [-f config-file] [--validate]
+# Update application (`-t ''` clears the tags; a locked application refuses all changes until --unlock)
+bricks app update <app-id> [-n name] [-d description] [-t tags] [--lock|--unlock] [-c config-json] [-f config-file] [--validate]
 
 # Short edit application (requires valid shortIds from app config)
 bricks app short-edit <app-id> -l '[{"shortId":"<subspace-short-id>","path":"property.name","content":"value"}]'
@@ -215,6 +224,12 @@ bricks app short-edit <app-id> -l '[{"shortId":"<subspace-short-id>","path":"pro
 # Bind/unbind devices
 bricks app bind <app-id> [-b device-ids] [-u device-ids]
 bricks app bind <app-id> [-b device-ids] [-u device-ids] [--dry-run] [-j|--json]
+# Set the viewport of new or bound devices (JSON or a JSON file keyed by device ID).
+# Fields: x, y, width, height, rotate, type (rotate|scroll), rotateType (crop|fit|physical-rotate),
+# scrollType (crop|fit), maintainAspectRatio, forceDeviceRatio, mirrorHorizontal, mirrorVertical, content.
+# Fields not given keep the current viewport, else the root layout (full size at 0,0).
+# A bound device keeps its other settings (automation, cron tests, control toggles, env).
+bricks app bind <app-id> --viewport '{"<device-id>":{"x":0,"y":0,"width":960,"height":540,"rotate":90}}' [--dry-run] [-j|--json]
 
 # Trigger automation
 bricks app trigger <app-id> <test-id> [--play|--stop] [--setup-at-launch] [-g match-group]
@@ -228,6 +243,11 @@ bricks app control-page <app-id> -t <short-edit,canvas-control,device-control,de
 # Preview a release without publishing
 bricks app release <app-id> -c <config-path-or-json> [-n name] [--version version] [--changelogs text] [--dry-run] [-j|--json]
 
+# List release versions, then switch the platform config to one (ID or name).
+# The local CTOR project is not changed. Unreleased changes are dropped: confirm, or pass -y.
+bricks app versions <app-id> [-j|--json]
+bricks app switch-version <app-id> <version-id-or-name> [-y|--yes] [--dry-run] [-j|--json]
+
 # Diagnose a config: schema validation + semantic lint rules
 # (data-update-race, redundant-rect-overlay, off-grid-frame, out-of-bounds-frame,
 #  wait-async-no-op, missing-result-param, unused-data-node, z-order-cover,