@fugood/bricks-cli 2.26.0-beta.18 → 2.26.0-beta.19

package/README.md

@@ -285,6 +285,32 @@ bricks group refresh <group-id> [--dry-run] [-j|--json]
 bricks group monitor <group-id> [-i interval-seconds]
 ```
 
+### Blueprints
+
+A Blueprint is a workspace-level map of a site: its applications, modules, devices, Data Bank
+properties and Media Flow boxes as nodes, with role cards and the edges between them. The CLI
+reads Blueprints; edit them in CTOR. These commands need the `query_blueprint` token permission.
+
+```bash
+# List blueprints (name, node count, revision, Orchestrator run state)
+bricks blueprint list [-k keyword] [-j|--json]
+
+# Resolve a blueprint name or ID
+bricks blueprint resolve <query> [-l limit] [-j|--json]
+
+# Get blueprint details (overview, counts, run state, referenced entities with no node)
+bricks blueprint get <blueprint-id> [-j|--json]
+
+# Nodes with authored edges and edges derived from the workspace (bindings, used modules, ...)
+bricks blueprint graph <blueprint-id> [-j|--json]
+
+# Nodes grouped by kind; removed or moved entities are flagged as missing
+bricks blueprint members <blueprint-id> [-j|--json]
+
+# Print the projection text that the Blueprint Orchestrator gets as its context
+bricks blueprint projection <blueprint-id>
+```
+
 ### Media Flow
 
 Media Flow commands require:
@@ -352,6 +378,9 @@ Notes:
 - When no `-v/--value-file` is given, `set` keeps the current value (useful to change only tags or the definition).
 - `-v` parses the input as JSON and falls back to a plain string (`-v '{"a":1}'` → object, `-v hello` → string).
 - Revoking the auto-provisioned `manager` / `used-by-device` keys rotates them instead of deleting them.
+- Space key values come back masked (last 4 characters) unless the login may read them: the
+  workspace owner, a role with `update-workspace`, or a token with the `manage_devtools` scope.
+  A key the login creates is always returned in full, and a masked key revokes by its full value.
 - The Data Bank endpoint is derived from the configured BRICKS endpoint
   (prod → `bank.bricks.tools`, beta → `bank-beta.bricks.tools`, dev → `localhost:8080`).
 - Environment overrides for CI / custom setups: `BRICKS_BANK_SPACENAME` + `BRICKS_BANK_SPACEKEY`