From c976799f8cd43f0e21c4fa15ee1c2e0461b69683 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 18 Dec 2025 01:10:31 +0000
Subject: [PATCH] CLI/docs: mention canvas.* alias

---
 docs/ios/spec.md     | 3 +++
 src/cli/nodes-cli.ts | 5 ++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/ios/spec.md b/docs/ios/spec.md
index d1815661c..936f390d0 100644
--- a/docs/ios/spec.md
+++ b/docs/ios/spec.md
@@ -123,6 +123,9 @@ These are values for `node.invoke.command`:
 - `screen.snapshot` with `{ maxWidth?, quality?, format? }`
 - `screen.setMode` with `{ mode: "canvas" | "web" }`
 
+Alias:
+- `canvas.*` is accepted as a synonym for `screen.*` (e.g. `canvas.eval` → `screen.eval`).
+
 Result pattern:
 - Request is a standard `req/res` with `ok` / `error`.
 - Long operations (loads, streaming drawing, etc.) may also emit `node.event` progress.
diff --git a/src/cli/nodes-cli.ts b/src/cli/nodes-cli.ts
index 33e4e0ec7..7766cd27f 100644
--- a/src/cli/nodes-cli.ts
+++ b/src/cli/nodes-cli.ts
@@ -345,7 +345,10 @@ export function registerNodesCli(program: Command) {
       .command("invoke")
       .description("Invoke a command on a paired node")
       .requiredOption("--node <idOrNameOrIp>", "Node id, name, or IP")
-      .requiredOption("--command <command>", "Command (e.g. screen.eval)")
+      .requiredOption(
+        "--command <command>",
+        "Command (e.g. screen.eval or canvas.eval)",
+      )
       .option("--params <json>", "JSON object string for params", "{}")
       .option(
         "--invoke-timeout <ms>",