@formant/formant-cli 0.3.0 → 0.4.2

package/oclif.manifest.json

@@ -140,7 +140,7 @@
         "tables.js"
       ]
     },
-    "events:get": {
+    "event:get": {
       "aliases": [],
       "args": {
         "id": {
@@ -151,8 +151,8 @@
       },
       "description": "Get detailed information about a specific event by its ID.",
       "examples": [
-        "<%= config.bin %> events get <event-id>",
-        "<%= config.bin %> events get <event-id> --json"
+        "<%= config.bin %> event get <event-id>",
+        "<%= config.bin %> event get <event-id> --json"
       ],
       "flags": {
         "json": {
@@ -185,7 +185,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "events:get",
+      "id": "event:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -196,19 +196,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "events",
+        "event",
         "get.js"
       ]
     },
-    "events:list": {
+    "event:list": {
       "aliases": [],
       "args": {},
       "description": "View important events emitted by devices with optional filters.\n\nEvents are significant occurrences from robots and sensors (e.g., device online/offline,\nerrors, state changes, commands). They can trigger signals for investigation.\n\nEvent types include: triggered-event, datapoint-event, device-online, device-offline,\nintervention-request, intervention-response, teleop-session-record, command-request,\ncommand-response, custom, comment, system, annotation, task-summary, stateful.\n\nSeverities: info, warning, error, critical.",
       "examples": [
-        "<%= config.bin %> events list",
-        "<%= config.bin %> events list --device <id> --severity critical",
-        "<%= config.bin %> events list --type device-offline --start 2026-01-01 --end 2026-01-02",
-        "<%= config.bin %> events list --limit 100 --json"
+        "<%= config.bin %> event list",
+        "<%= config.bin %> event list --device <id> --severity critical",
+        "<%= config.bin %> event list --type device-offline --start 2026-01-01 --end 2026-01-02",
+        "<%= config.bin %> event list --limit 100 --json"
       ],
       "flags": {
         "json": {
@@ -292,7 +292,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "events:list",
+      "id": "event:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -303,23 +303,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "events",
+        "event",
         "list.js"
       ]
     },
-    "commands:for-device": {
+    "event-trigger:get": {
       "aliases": [],
       "args": {
-        "deviceId": {
-          "description": "Device ID (UUID)",
-          "name": "deviceId",
+        "id": {
+          "description": "Event trigger ID (UUID)",
+          "name": "id",
           "required": true
         }
       },
-      "description": "List command templates available for a specific device.\n\nReturns commands that match the device's tags and filters. Only enabled commands\nthat apply to this device are shown.",
+      "description": "Get detailed information about an event trigger.\n\nShows the full trigger configuration including conditions, exit conditions, commands\nit executes, and device targeting filters.",
       "examples": [
-        "<%= config.bin %> commands for-device <device-id>",
-        "<%= config.bin %> commands for-device <device-id> --json"
+        "<%= config.bin %> event-trigger get <trigger-id>",
+        "<%= config.bin %> event-trigger get <trigger-id> --json"
       ],
       "flags": {
         "json": {
@@ -352,34 +352,28 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "commands:for-device",
+      "id": "event-trigger:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List commands available for a device",
+      "summary": "Get event trigger details",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "commands",
-        "for-device.js"
+        "event-trigger",
+        "get.js"
       ]
     },
-    "commands:get": {
+    "event-trigger:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Command template ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get detailed information about a command template.\n\nShows the full template configuration including command string, parameter schema,\ndevice targeting filters, and delivery settings. If the template has structured\nparameters (schema), they are displayed in a readable format.",
+      "args": {},
+      "description": "List all event trigger rules in your organization.\n\nEvent triggers monitor device data and generate events/signals when conditions are met.\nThey can trigger investigations, send notifications, or execute commands.",
       "examples": [
-        "<%= config.bin %> commands get <template-id>",
-        "<%= config.bin %> commands get <template-id> --json"
+        "<%= config.bin %> event-trigger list",
+        "<%= config.bin %> event-trigger list --json"
       ],
       "flags": {
         "json": {
@@ -412,29 +406,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "commands:get",
+      "id": "event-trigger:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get command template details",
+      "summary": "List event trigger rules",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "commands",
-        "get.js"
+        "event-trigger",
+        "list.js"
       ]
     },
-    "commands:history": {
+    "fleet:get": {
       "aliases": [],
-      "args": {},
-      "description": "Query command history for a device.\n\nShows commands that have been sent to a device, including delivery status and responses.\nUse this to check if commands were delivered and executed successfully.",
+      "args": {
+        "id": {
+          "description": "Fleet (group) ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a device group (fleet).\n\nShows the full fleet configuration including member devices and settings.",
       "examples": [
-        "<%= config.bin %> commands history --device <device-id>",
-        "<%= config.bin %> commands history --device <device-id> --limit 50",
-        "<%= config.bin %> commands history --device <device-id> --json"
+        "<%= config.bin %> fleet get <fleet-id>",
+        "<%= config.bin %> fleet get <fleet-id> --json"
       ],
       "flags": {
         "json": {
@@ -463,50 +462,32 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of commands to return",
-          "name": "limit",
-          "default": 25,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "commands:history",
+      "id": "fleet:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Query command history",
+      "summary": "Get fleet details",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "commands",
-        "history.js"
+        "fleet",
+        "get.js"
       ]
     },
-    "commands:list": {
+    "fleet:list": {
       "aliases": [],
       "args": {},
-      "description": "List all command templates defined in your organization.\n\nCommand templates define the commands that can be sent to devices. Each template\nspecifies the command string, parameters, delivery settings, and device targeting.",
+      "description": "List all device groups (fleets) in your organization.\n\nDevice groups allow you to organize and manage sets of devices together.",
       "examples": [
-        "<%= config.bin %> commands list",
-        "<%= config.bin %> commands list --json"
+        "<%= config.bin %> fleet list",
+        "<%= config.bin %> fleet list --json"
       ],
       "flags": {
         "json": {
@@ -539,42 +520,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "commands:list",
+      "id": "fleet:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List command templates",
+      "summary": "List device groups",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "commands",
+        "fleet",
         "list.js"
       ]
     },
-    "commands:send": {
+    "command:for-device": {
       "aliases": [],
       "args": {
         "deviceId": {
           "description": "Device ID (UUID)",
           "name": "deviceId",
           "required": true
-        },
-        "templateId": {
-          "description": "Command template ID (UUID)",
-          "name": "templateId",
-          "required": true
         }
       },
-      "description": "Send a command to a device using a command template.\n\nFetches the template, validates parameters against its schema, and sends the command\nto the specified device. Use --param flags to override parameter values.\n\nFor templates with structured parameters (schema), parameter names and types are\nvalidated. For unstructured parameters, the raw value is sent as-is.\n\nUse --dry-run to preview the payload without actually sending.",
+      "description": "List command templates available for a specific device.\n\nReturns commands that match the device's tags and filters. Only enabled commands\nthat apply to this device are shown.",
       "examples": [
-        "<%= config.bin %> commands send <device-id> <template-id>",
-        "<%= config.bin %> commands send <device-id> <template-id> --param speed=5 --param mode=fast",
-        "<%= config.bin %> commands send <device-id> <template-id> --dry-run",
-        "<%= config.bin %> commands send <device-id> <template-id> --raw-value '{\"x\":1,\"y\":2}'",
-        "<%= config.bin %> commands send <device-id> <template-id> --json"
+        "<%= config.bin %> command for-device <device-id>",
+        "<%= config.bin %> command for-device <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -603,59 +576,38 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "dry-run": {
-          "description": "Preview the command payload without sending",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "param": {
-          "char": "p",
-          "description": "Parameter override (name=value), can be specified multiple times",
-          "name": "param",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "raw-value": {
-          "description": "Send a raw parameter value string (bypasses schema validation)",
-          "name": "raw-value",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "commands:send",
+      "id": "command:for-device",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Send a command to a device",
+      "summary": "List commands available for a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "commands",
-        "send.js"
+        "command",
+        "for-device.js"
       ]
     },
-    "fleets:get": {
+    "command:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Fleet (group) ID (UUID)",
+          "description": "Command template ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get detailed information about a device group (fleet).\n\nShows the full fleet configuration including member devices and settings.",
+      "description": "Get detailed information about a command template.\n\nShows the full template configuration including command string, parameter schema,\ndevice targeting filters, and delivery settings. If the template has structured\nparameters (schema), they are displayed in a readable format.",
       "examples": [
-        "<%= config.bin %> fleets get <fleet-id>",
-        "<%= config.bin %> fleets get <fleet-id> --json"
+        "<%= config.bin %> command get <template-id>",
+        "<%= config.bin %> command get <template-id> --json"
       ],
       "flags": {
         "json": {
@@ -688,28 +640,29 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "fleets:get",
+      "id": "command:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get fleet details",
+      "summary": "Get command template details",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "fleets",
+        "command",
         "get.js"
       ]
     },
-    "fleets:list": {
+    "command:history": {
       "aliases": [],
       "args": {},
-      "description": "List all device groups (fleets) in your organization.\n\nDevice groups allow you to organize and manage sets of devices together.",
+      "description": "Query command history for a device.\n\nShows commands that have been sent to a device, including delivery status and responses.\nUse this to check if commands were delivered and executed successfully.",
       "examples": [
-        "<%= config.bin %> fleets list",
-        "<%= config.bin %> fleets list --json"
+        "<%= config.bin %> command history --device <device-id>",
+        "<%= config.bin %> command history --device <device-id> --limit 50",
+        "<%= config.bin %> command history --device <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -738,38 +691,50 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of commands to return",
+          "name": "limit",
+          "default": 25,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "fleets:list",
+      "id": "command:history",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List device groups",
+      "summary": "Query command history",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "fleets",
-        "list.js"
+        "command",
+        "history.js"
       ]
     },
-    "event-triggers:get": {
+    "command:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Event trigger ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get detailed information about an event trigger.\n\nShows the full trigger configuration including conditions, exit conditions, commands\nit executes, and device targeting filters.",
+      "args": {},
+      "description": "List all command templates defined in your organization.\n\nCommand templates define the commands that can be sent to devices. Each template\nspecifies the command string, parameters, delivery settings, and device targeting.",
       "examples": [
-        "<%= config.bin %> event-triggers get <trigger-id>",
-        "<%= config.bin %> event-triggers get <trigger-id> --json"
+        "<%= config.bin %> command list",
+        "<%= config.bin %> command list --json"
       ],
       "flags": {
         "json": {
@@ -802,28 +767,42 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "event-triggers:get",
+      "id": "command:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get event trigger details",
+      "summary": "List command templates",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "event-triggers",
-        "get.js"
+        "command",
+        "list.js"
       ]
     },
-    "event-triggers:list": {
+    "command:send": {
       "aliases": [],
-      "args": {},
-      "description": "List all event trigger rules in your organization.\n\nEvent triggers monitor device data and generate events/signals when conditions are met.\nThey can trigger investigations, send notifications, or execute commands.",
+      "args": {
+        "deviceId": {
+          "description": "Device ID (UUID)",
+          "name": "deviceId",
+          "required": true
+        },
+        "templateId": {
+          "description": "Command template ID (UUID)",
+          "name": "templateId",
+          "required": true
+        }
+      },
+      "description": "Send a command to a device using a command template.\n\nFetches the template, validates parameters against its schema, and sends the command\nto the specified device. Use --param flags to override parameter values.\n\nFor templates with structured parameters (schema), parameter names and types are\nvalidated. For unstructured parameters, the raw value is sent as-is.\n\nUse --dry-run to preview the payload without actually sending.",
       "examples": [
-        "<%= config.bin %> event-triggers list",
-        "<%= config.bin %> event-triggers list --json"
+        "<%= config.bin %> command send <device-id> <template-id>",
+        "<%= config.bin %> command send <device-id> <template-id> --param speed=5 --param mode=fast",
+        "<%= config.bin %> command send <device-id> <template-id> --dry-run",
+        "<%= config.bin %> command send <device-id> <template-id> --raw-value '{\"x\":1,\"y\":2}'",
+        "<%= config.bin %> command send <device-id> <template-id> --json"
       ],
       "flags": {
         "json": {
@@ -852,34 +831,59 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Preview the command payload without sending",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "param": {
+          "char": "p",
+          "description": "Parameter override (name=value), can be specified multiple times",
+          "name": "param",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "raw-value": {
+          "description": "Send a raw parameter value string (bypasses schema validation)",
+          "name": "raw-value",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "event-triggers:list",
+      "id": "command:send",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List event trigger rules",
+      "summary": "Send a command to a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "event-triggers",
-        "list.js"
+        "command",
+        "send.js"
       ]
     },
-    "ingest:batch": {
+    "kv:get": {
       "aliases": [],
-      "args": {},
-      "description": "Ingest multiple data points in a single batch request.\n\nReads a JSON file (or stdin) containing a batch ingestion payload and sends all data points\nin a single API request. This is more efficient than sending individual data points when you\nhave multiple values to ingest.\n\nINPUT FORMAT:\nThe input JSON must have the following structure:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"device-uuid\",        // Required: Device ID (UUID)\n      \"name\": \"stream-name\",             // Required: Stream name\n      \"type\": \"numeric|text|json|...\",   // Required: Data type (see below)\n      \"tags\": {\"key\": \"value\"},          // Optional: Tags object (string key-value pairs)\n      \"points\": [[timestamp_ms, value]]  // Required: Array of [timestamp, value] pairs\n    }\n  ]\n}\n\nSUPPORTED TYPES AND VALUE FORMATS:\n- numeric: Number value\n    Example: \"points\": [[1708272000000, 42.5]]\n\n- text: String value\n    Example: \"points\": [[1708272000000, \"hello world\"]]\n\n- json: JSON object encoded as string\n    Example: \"points\": [[1708272000000, \"{\\\"x\\\":10,\\\"y\\\":20}\"]]\n\n- image: Object with url (required), size and annotations (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/img.jpg\", \"size\": 102400}]]\n\n- video: Object with url, duration, mimeType (required), size (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/vid.mp4\", \"duration\": 30000, \"mimeType\": \"video/mp4\"}]]\n\n- bitset: Object with keys array and values array (1-1000 pairs)\n    Example: \"points\": [[1708272000000, {\"keys\": [\"door\", \"window\"], \"values\": [true, false]}]]\n\n- health: Object with status (required) and clockSkewMs (optional)\n    Example: \"points\": [[1708272000000, {\"status\": \"operational\", \"clockSkewMs\": 150}]]\n    Valid status values: \"unknown\", \"operational\", \"offline\", \"error\"\n\nEach item can have multiple points (timestamp/value pairs) for the same stream.\nTimestamps are Unix milliseconds (use Date.now() for current time).",
+      "args": {
+        "key": {
+          "description": "Key to retrieve",
+          "name": "key",
+          "required": true
+        }
+      },
+      "description": "Get a value from the key-value store.\n\nThe key-value store allows devices and applications to store metadata.",
       "examples": [
-        "<%= config.bin %> ingest batch --file data.json",
-        "<%= config.bin %> ingest batch --stdin < data.json",
-        "cat payload.json | <%= config.bin %> ingest batch --stdin",
-        "# Example payload.json with multiple types:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"battery_level\",\n      \"type\": \"numeric\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, 42.5], [1708272060000, 41.8]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"status\",\n      \"type\": \"text\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, \"operational\"]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"health\",\n      \"type\": \"health\",\n      \"tags\": {},\n      \"points\": [[1708272000000, {\"status\": \"operational\"}]]\n    }\n  ]\n}"
+        "<%= config.bin %> kv get my-key",
+        "<%= config.bin %> kv get my-key --json"
       ],
       "flags": {
         "json": {
@@ -908,53 +912,34 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file containing batch payload",
-          "exclusive": [
-            "stdin"
-          ],
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stdin": {
-          "description": "Read JSON payload from stdin",
-          "exclusive": [
-            "file"
-          ],
-          "name": "stdin",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ingest:batch",
+      "id": "kv:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Ingest batch data from file or stdin",
+      "summary": "Get key-value",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "ingest",
-        "batch.js"
+        "kv",
+        "get.js"
       ]
     },
-    "ingest:bitset": {
+    "kv:list": {
       "aliases": [],
       "args": {},
-      "description": "Ingest a bitset data point to a device stream.\n\nSends a bitset (array of named boolean values) to the specified device stream. A bitset\nconsists of parallel arrays of keys (strings) and values (booleans).\n\nBitsets are useful for representing sets of binary states, flags, or boolean sensor readings\nwhere you have multiple named on/off states.\n\nConstraints:\n- Must have 1-1000 key/value pairs\n- Keys must be max 255 characters each\n- Keys and values arrays must have the same length",
+      "description": "List all keys in the key-value store.\n\nShows all stored keys in the organization's key-value store. Use --prefix to filter\nkeys that start with a specific prefix, or --keys to query specific keys.",
       "examples": [
-        "<%= config.bin %> ingest bitset --device <device-id> --stream sensors --keys \"door,window,motion\" --values \"true,false,true\"",
-        "<%= config.bin %> ingest bitset --device <device-id> --stream flags --keys \"active,paused,error\" --values \"true,false,false\" --tag system=main",
-        "<%= config.bin %> ingest bitset --device <device-id> --stream states --keys \"a,b\" --values \"false,true\""
+        "<%= config.bin %> kv list",
+        "<%= config.bin %> kv list --prefix config",
+        "<%= config.bin %> kv list --keys key1 --keys key2 --keys key3",
+        "<%= config.bin %> kv list --json"
       ],
       "flags": {
         "json": {
@@ -984,20 +969,232 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
+        "keys": {
+          "char": "k",
+          "description": "Specific keys to query (can be specified multiple times)",
+          "name": "keys",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "stream": {
-          "char": "s",
-          "description": "Stream name",
-          "name": "stream",
-          "required": true,
+        "prefix": {
+          "char": "p",
+          "description": "Filter keys by prefix",
+          "name": "prefix",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "kv:list",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List key-value keys",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "kv",
+        "list.js"
+      ]
+    },
+    "kv:set": {
+      "aliases": [],
+      "args": {
+        "key": {
+          "description": "Key to set",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Value to store (JSON string)",
+          "name": "value",
+          "required": true
+        }
+      },
+      "description": "Set a value in the key-value store.\n\nStores a value associated with a key. The value should be a JSON string.",
+      "examples": [
+        "<%= config.bin %> kv set my-key '{\"data\": \"value\"}'",
+        "<%= config.bin %> kv set config '{\"setting\": true}'"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "kv:set",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Set key-value",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "kv",
+        "set.js"
+      ]
+    },
+    "ingest:batch": {
+      "aliases": [],
+      "args": {},
+      "description": "Ingest multiple data points in a single batch request.\n\nReads a JSON file (or stdin) containing a batch ingestion payload and sends all data points\nin a single API request. This is more efficient than sending individual data points when you\nhave multiple values to ingest.\n\nINPUT FORMAT:\nThe input JSON must have the following structure:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"device-uuid\",        // Required: Device ID (UUID)\n      \"name\": \"stream-name\",             // Required: Stream name\n      \"type\": \"numeric|text|json|...\",   // Required: Data type (see below)\n      \"tags\": {\"key\": \"value\"},          // Optional: Tags object (string key-value pairs)\n      \"points\": [[timestamp_ms, value]]  // Required: Array of [timestamp, value] pairs\n    }\n  ]\n}\n\nSUPPORTED TYPES AND VALUE FORMATS:\n- numeric: Number value\n    Example: \"points\": [[1708272000000, 42.5]]\n\n- text: String value\n    Example: \"points\": [[1708272000000, \"hello world\"]]\n\n- json: JSON object encoded as string\n    Example: \"points\": [[1708272000000, \"{\\\"x\\\":10,\\\"y\\\":20}\"]]\n\n- image: Object with url (required), size and annotations (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/img.jpg\", \"size\": 102400}]]\n\n- video: Object with url, duration, mimeType (required), size (optional)\n    Example: \"points\": [[1708272000000, {\"url\": \"https://example.com/vid.mp4\", \"duration\": 30000, \"mimeType\": \"video/mp4\"}]]\n\n- bitset: Object with keys array and values array (1-1000 pairs)\n    Example: \"points\": [[1708272000000, {\"keys\": [\"door\", \"window\"], \"values\": [true, false]}]]\n\n- health: Object with status (required) and clockSkewMs (optional)\n    Example: \"points\": [[1708272000000, {\"status\": \"operational\", \"clockSkewMs\": 150}]]\n    Valid status values: \"unknown\", \"operational\", \"offline\", \"error\"\n\nEach item can have multiple points (timestamp/value pairs) for the same stream.\nTimestamps are Unix milliseconds (use Date.now() for current time).",
+      "examples": [
+        "<%= config.bin %> ingest batch --file data.json",
+        "<%= config.bin %> ingest batch --stdin < data.json",
+        "cat payload.json | <%= config.bin %> ingest batch --stdin",
+        "# Example payload.json with multiple types:\n{\n  \"items\": [\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"battery_level\",\n      \"type\": \"numeric\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, 42.5], [1708272060000, 41.8]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"status\",\n      \"type\": \"text\",\n      \"tags\": {\"env\": \"prod\"},\n      \"points\": [[1708272000000, \"operational\"]]\n    },\n    {\n      \"deviceId\": \"abc-123\",\n      \"name\": \"health\",\n      \"type\": \"health\",\n      \"tags\": {},\n      \"points\": [[1708272000000, {\"status\": \"operational\"}]]\n    }\n  ]\n}"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file containing batch payload",
+          "exclusive": [
+            "stdin"
+          ],
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stdin": {
+          "description": "Read JSON payload from stdin",
+          "exclusive": [
+            "file"
+          ],
+          "name": "stdin",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ingest:batch",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Ingest batch data from file or stdin",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ingest",
+        "batch.js"
+      ]
+    },
+    "ingest:bitset": {
+      "aliases": [],
+      "args": {},
+      "description": "Ingest a bitset data point to a device stream.\n\nSends a bitset (array of named boolean values) to the specified device stream. A bitset\nconsists of parallel arrays of keys (strings) and values (booleans).\n\nBitsets are useful for representing sets of binary states, flags, or boolean sensor readings\nwhere you have multiple named on/off states.\n\nConstraints:\n- Must have 1-1000 key/value pairs\n- Keys must be max 255 characters each\n- Keys and values arrays must have the same length",
+      "examples": [
+        "<%= config.bin %> ingest bitset --device <device-id> --stream sensors --keys \"door,window,motion\" --values \"true,false,true\"",
+        "<%= config.bin %> ingest bitset --device <device-id> --stream flags --keys \"active,paused,error\" --values \"true,false,false\" --tag system=main",
+        "<%= config.bin %> ingest bitset --device <device-id> --stream states --keys \"a,b\" --values \"false,true\""
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name",
+          "name": "stream",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1786,211 +1983,14 @@
         "update.js"
       ]
     },
-    "kv:get": {
+    "investigation:analytics": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Key to retrieve",
-          "name": "key",
-          "required": true
-        }
-      },
-      "description": "Get a value from the key-value store.\n\nThe key-value store allows devices and applications to store metadata.",
+      "args": {},
+      "description": "Get investigation analytics with time-series data.\n\nReturns aggregated analytics about investigation runs over a time range,\noptionally grouped by result type or signal type.",
       "examples": [
-        "<%= config.bin %> kv get my-key",
-        "<%= config.bin %> kv get my-key --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dev": {
-          "description": "Target the dev environment",
-          "exclusive": [
-            "stage"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "dev",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "stage": {
-          "description": "Target the stage environment",
-          "exclusive": [
-            "dev"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "stage",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "kv:get",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Get key-value",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "kv",
-        "get.js"
-      ]
-    },
-    "kv:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List all keys in the key-value store.\n\nShows all stored keys in the organization's key-value store. Use --prefix to filter\nkeys that start with a specific prefix, or --keys to query specific keys.",
-      "examples": [
-        "<%= config.bin %> kv list",
-        "<%= config.bin %> kv list --prefix config",
-        "<%= config.bin %> kv list --keys key1 --keys key2 --keys key3",
-        "<%= config.bin %> kv list --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dev": {
-          "description": "Target the dev environment",
-          "exclusive": [
-            "stage"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "dev",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "stage": {
-          "description": "Target the stage environment",
-          "exclusive": [
-            "dev"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "stage",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "keys": {
-          "char": "k",
-          "description": "Specific keys to query (can be specified multiple times)",
-          "name": "keys",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "prefix": {
-          "char": "p",
-          "description": "Filter keys by prefix",
-          "name": "prefix",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "kv:list",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "List key-value keys",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "kv",
-        "list.js"
-      ]
-    },
-    "kv:set": {
-      "aliases": [],
-      "args": {
-        "key": {
-          "description": "Key to set",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Value to store (JSON string)",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Set a value in the key-value store.\n\nStores a value associated with a key. The value should be a JSON string.",
-      "examples": [
-        "<%= config.bin %> kv set my-key '{\"data\": \"value\"}'",
-        "<%= config.bin %> kv set config '{\"setting\": true}'"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dev": {
-          "description": "Target the dev environment",
-          "exclusive": [
-            "stage"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "dev",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "stage": {
-          "description": "Target the stage environment",
-          "exclusive": [
-            "dev"
-          ],
-          "helpGroup": "GLOBAL",
-          "name": "stage",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "kv:set",
-      "pluginAlias": "@formant/formant-cli",
-      "pluginName": "@formant/formant-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Set key-value",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "kv",
-        "set.js"
-      ]
-    },
-    "investigations:analytics": {
-      "aliases": [],
-      "args": {},
-      "description": "Get investigation analytics with time-series data.\n\nReturns aggregated analytics about investigation runs over a time range,\noptionally grouped by result type or signal type.",
-      "examples": [
-        "<%= config.bin %> investigations analytics --start 2026-01-01 --end 2026-02-01",
-        "<%= config.bin %> investigations analytics --start 2026-01-01 --end 2026-02-01 --interval hourly",
-        "<%= config.bin %> investigations analytics --start 2026-01-01 --end 2026-02-01 --group-by resultType --json"
+        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01",
+        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01 --interval hourly",
+        "<%= config.bin %> investigation analytics --start 2026-01-01 --end 2026-02-01 --group-by resultType --json"
       ],
       "flags": {
         "json": {
@@ -2062,7 +2062,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:analytics",
+      "id": "investigation:analytics",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2073,11 +2073,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "analytics.js"
       ]
     },
-    "investigations:get": {
+    "investigation:get": {
       "aliases": [],
       "args": {
         "id": {
@@ -2088,8 +2088,8 @@
       },
       "description": "Get detailed information about a specific investigation by ID.",
       "examples": [
-        "<%= config.bin %> investigations get <id>",
-        "<%= config.bin %> investigations get <id> --json"
+        "<%= config.bin %> investigation get <id>",
+        "<%= config.bin %> investigation get <id> --json"
       ],
       "flags": {
         "json": {
@@ -2122,7 +2122,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:get",
+      "id": "investigation:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2133,18 +2133,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "get.js"
       ]
     },
-    "investigations:list": {
+    "investigation:list": {
       "aliases": [],
       "args": {},
       "description": "List investigations (AI-powered analysis workflows) in your organization.\n\nInvestigations are automated AI workflows that analyze signals, diagnose problems,\nand produce reports. Use --signal-handler to filter for investigations that are\ntriggered automatically by signals.",
       "examples": [
-        "<%= config.bin %> investigations list",
-        "<%= config.bin %> investigations list --signal-handler",
-        "<%= config.bin %> investigations list --json"
+        "<%= config.bin %> investigation list",
+        "<%= config.bin %> investigation list --signal-handler",
+        "<%= config.bin %> investigation list --json"
       ],
       "flags": {
         "json": {
@@ -2183,7 +2183,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:list",
+      "id": "investigation:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2194,11 +2194,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "list.js"
       ]
     },
-    "investigations:run": {
+    "investigation:run": {
       "aliases": [],
       "args": {
         "investigationId": {
@@ -2214,9 +2214,9 @@
       },
       "description": "Get detailed information about a specific investigation run.\n\nShows run details including status, signal information, events, and the complete execution \nlog with node inputs/outputs, task messages, tool usage, and results.\n\nUse this to trace the investigation run back to its signal and triggering event.",
       "examples": [
-        "<%= config.bin %> investigations run <investigation-id> <run-id>",
-        "<%= config.bin %> investigations run <investigation-id> <run-id> --log-only",
-        "<%= config.bin %> investigations run <investigation-id> <run-id> --json"
+        "<%= config.bin %> investigation run <investigation-id> <run-id>",
+        "<%= config.bin %> investigation run <investigation-id> <run-id> --log-only",
+        "<%= config.bin %> investigation run <investigation-id> <run-id> --json"
       ],
       "flags": {
         "json": {
@@ -2261,7 +2261,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:run",
+      "id": "investigation:run",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2272,11 +2272,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "run.js"
       ]
     },
-    "investigations:runs-list": {
+    "investigation:runs-list": {
       "aliases": [],
       "args": {
         "id": {
@@ -2287,9 +2287,9 @@
       },
       "description": "List actual investigation runs (not evaluation runs) for a specific investigation.\n\nShows runs with their status, signal IDs, and timestamps. Use 'investigations run' to see\ndetailed execution logs for a specific run.",
       "examples": [
-        "<%= config.bin %> investigations runs-list <id>",
-        "<%= config.bin %> investigations runs-list <id> --limit 50",
-        "<%= config.bin %> investigations runs-list <id> --details --json"
+        "<%= config.bin %> investigation runs-list <id>",
+        "<%= config.bin %> investigation runs-list <id> --limit 50",
+        "<%= config.bin %> investigation runs-list <id> --details --json"
       ],
       "flags": {
         "json": {
@@ -2346,7 +2346,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:runs-list",
+      "id": "investigation:runs-list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2357,11 +2357,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "runs-list.js"
       ]
     },
-    "investigations:runs": {
+    "investigation:runs": {
       "aliases": [],
       "args": {
         "id": {
@@ -2372,8 +2372,8 @@
       },
       "description": "List evaluation runs for a specific investigation.",
       "examples": [
-        "<%= config.bin %> investigations runs <id>",
-        "<%= config.bin %> investigations runs <id> --json"
+        "<%= config.bin %> investigation runs <id>",
+        "<%= config.bin %> investigation runs <id> --json"
       ],
       "flags": {
         "json": {
@@ -2406,7 +2406,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:runs",
+      "id": "investigation:runs",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2417,17 +2417,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "runs.js"
       ]
     },
-    "investigations:stats": {
+    "investigation:stats": {
       "aliases": [],
       "args": {},
       "description": "Get investigation statistics for a time range.",
       "examples": [
-        "<%= config.bin %> investigations stats --start 2026-01-01 --end 2026-02-01",
-        "<%= config.bin %> investigations stats --start 2026-01-01 --end 2026-02-01 --json"
+        "<%= config.bin %> investigation stats --start 2026-01-01 --end 2026-02-01",
+        "<%= config.bin %> investigation stats --start 2026-01-01 --end 2026-02-01 --json"
       ],
       "flags": {
         "json": {
@@ -2476,7 +2476,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:stats",
+      "id": "investigation:stats",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2487,11 +2487,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "stats.js"
       ]
     },
-    "investigations:trigger": {
+    "investigation:trigger": {
       "aliases": [],
       "args": {
         "id": {
@@ -2502,8 +2502,8 @@
       },
       "description": "Trigger an investigation to run. Provide input text describing the problem\nor context for the investigation. The investigation runs asynchronously and\nreturns a run ID you can use to check results.",
       "examples": [
-        "<%= config.bin %> investigations trigger <id> --input \"Robot stopped responding\"",
-        "<%= config.bin %> investigations trigger <id> --input \"Battery draining fast on device X\" --json"
+        "<%= config.bin %> investigation trigger <id> --input \"Robot stopped responding\"",
+        "<%= config.bin %> investigation trigger <id> --input \"Battery draining fast on device X\" --json"
       ],
       "flags": {
         "json": {
@@ -2552,7 +2552,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "investigations:trigger",
+      "id": "investigation:trigger",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
@@ -2563,19 +2563,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "investigations",
+        "investigation",
         "trigger.js"
       ]
     },
-    "query": {
+    "device:config": {
       "aliases": [],
-      "args": {},
-      "description": "Query telemetry stream data for a device over a time range.\n\nReturns time-series datapoints for the specified stream(s). Supports aggregation\nfor downsampling large datasets, and --latest to get only the most recent value.\n\nStream types: numeric, text, image, video, location, json, bitset, battery, health,\n\"numeric set\", \"point cloud\", localization, \"transform tree\", file.\n\nAggregate levels: second, 5 seconds, 30 seconds, minute, 5 minutes, 30 minutes,\nhour, 4 hours, 12 hours, day, week, month, year.",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get the device configuration including stream definitions.\n\nShows the device's current configuration including telemetry streams, commands,\nand other settings.",
       "examples": [
-        "<%= config.bin %> query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02",
-        "<%= config.bin %> query --device <id> --stream speed --aggregate hour --start 2026-01-01 --end 2026-02-01",
-        "<%= config.bin %> query --device <id> --stream battery_level --latest",
-        "<%= config.bin %> query --device <id> --stream temperature --type numeric --json"
+        "<%= config.bin %> device config <device-id>",
+        "<%= config.bin %> device config <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -2604,95 +2608,39 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "aggregate": {
-          "char": "a",
-          "description": "Aggregation level for downsampling",
-          "name": "aggregate",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end": {
-          "description": "End time (ISO 8601)",
-          "name": "end",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "latest": {
-          "description": "Only return the most recent value per stream",
-          "name": "latest",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of datapoints",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start": {
-          "description": "Start time (ISO 8601)",
-          "name": "start",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name(s), can be specified multiple times",
-          "name": "stream",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "type": {
-          "description": "Filter by stream type",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "query",
+      "id": "device:config",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Query telemetry stream data",
+      "summary": "Get device configuration",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "query",
-        "index.js"
+        "device",
+        "config.js"
       ]
     },
-    "query:latest-values": {
+    "device:create": {
       "aliases": [],
-      "args": {},
-      "description": "Get the latest values for streams across devices.\n\nReturns the most recent value for specified streams without needing to specify\na time range. Useful for checking current sensor readings.\n\nUse --all-streams with a single device to automatically discover and query all\nconfigured streams from the device configuration.",
+      "args": {
+        "name": {
+          "description": "Name for the new device",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Create a new device in your fleet.\n\nThe device is created as enabled by default. You can optionally specify tags.",
       "examples": [
-        "<%= config.bin %> query latest-values --device <id> --stream battery_level",
-        "<%= config.bin %> query latest-values --device <id> --stream temperature --stream humidity",
-        "<%= config.bin %> query latest-values --device <id> --all-streams",
-        "<%= config.bin %> query latest-values --device <id> --all-streams --json"
+        "<%= config.bin %> device create my-robot",
+        "<%= config.bin %> device create my-robot --tag location=warehouse --tag env=prod",
+        "<%= config.bin %> device create my-robot --json"
       ],
       "flags": {
         "json": {
@@ -2722,25 +2670,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "all-streams": {
-          "description": "Query all configured streams for the device (requires single --device)",
-          "name": "all-streams",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "Device ID (UUID)",
-          "name": "device",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "stream": {
-          "char": "s",
-          "description": "Stream name(s), can be specified multiple times",
-          "name": "stream",
+        "tag": {
+          "char": "t",
+          "description": "Tag to apply (key=value), can be specified multiple times",
+          "name": "tag",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -2748,34 +2681,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "query:latest-values",
+      "id": "device:create",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get latest stream values",
+      "summary": "Create a new device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "query",
-        "latest-values.js"
+        "device",
+        "create.js"
       ]
     },
-    "schedules:get": {
+    "device:delete": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Schedule ID (UUID)",
+          "description": "Device ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get detailed information about a schedule.\n\nShows the full schedule configuration including cron expression, command template,\ninvestigation link, and execution settings.",
+      "description": "Delete (disable) a device from your fleet.\n\nThis performs a soft-delete by disabling the device. The device and its telemetry\nhistory are preserved but it will no longer appear in device listings.",
       "examples": [
-        "<%= config.bin %> schedules get <schedule-id>",
-        "<%= config.bin %> schedules get <schedule-id> --json"
+        "<%= config.bin %> device delete <device-id>",
+        "<%= config.bin %> device delete <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -2808,28 +2741,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "schedules:get",
+      "id": "device:delete",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get schedule details",
+      "summary": "Delete (disable) a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "schedules",
-        "get.js"
+        "device",
+        "delete.js"
       ]
     },
-    "schedules:list": {
+    "device:get": {
       "aliases": [],
-      "args": {},
-      "description": "List all schedules in your organization.\n\nSchedules can trigger commands or investigations on a recurring (cron) or one-time basis.",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a specific device by its ID.",
       "examples": [
-        "<%= config.bin %> schedules list",
-        "<%= config.bin %> schedules list --json"
+        "<%= config.bin %> device get <device-id>",
+        "<%= config.bin %> device get <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -2862,34 +2801,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "schedules:list",
+      "id": "device:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List schedules",
+      "summary": "Get a device by ID",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "schedules",
-        "list.js"
+        "device",
+        "get.js"
       ]
     },
-    "users:get": {
+    "device:last-seen": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "User ID (UUID)",
+          "description": "Device ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get detailed information about a user.\n\nShows user details including email, name, roles, and account settings.",
+      "description": "Get when a device was last seen online.\n\nShows the most recent timestamp when the device was detected as online.",
       "examples": [
-        "<%= config.bin %> users get <user-id>",
-        "<%= config.bin %> users get <user-id> --json"
+        "<%= config.bin %> device last-seen <device-id>",
+        "<%= config.bin %> device last-seen <device-id> --json"
       ],
       "flags": {
         "json": {
@@ -2922,28 +2861,31 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:get",
+      "id": "device:last-seen",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get user details",
+      "summary": "Get device last seen timestamp",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "get.js"
+        "device",
+        "last-seen.js"
       ]
     },
-    "users:list": {
+    "device:list": {
       "aliases": [],
       "args": {},
-      "description": "List all users in your organization.\n\nShows user accounts, their email addresses, and account status.",
+      "description": "List robots and sensors in your fleet. Shows only online devices by default.\n\nUse --all to include offline devices.",
       "examples": [
-        "<%= config.bin %> users list",
-        "<%= config.bin %> users list --json"
+        "<%= config.bin %> device list",
+        "<%= config.bin %> device list --all",
+        "<%= config.bin %> device list --all --limit 100",
+        "<%= config.bin %> device list --tag location=warehouse",
+        "<%= config.bin %> device list --name robot --dev --json"
       ],
       "flags": {
         "json": {
@@ -2972,33 +2914,75 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "all": {
+          "char": "a",
+          "description": "Show all devices (online and offline)",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of devices to return",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Filter devices by name (search)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "char": "t",
+          "description": "Filter by tag (key=value), can be specified multiple times",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:list",
+      "id": "device:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List users",
+      "summary": "List robots and sensors in your fleet",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "device",
         "list.js"
       ]
     },
-    "signals:count": {
+    "device:rename": {
       "aliases": [],
-      "args": {},
-      "description": "Get counts of signals grouped by type.\n\nReturns total counts and per-type breakdowns (manual, eventTrigger, schedule, slack).",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        },
+        "name": {
+          "description": "New name for the device",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Rename a device by updating its name.",
       "examples": [
-        "<%= config.bin %> signals count",
-        "<%= config.bin %> signals count --start 2026-01-01 --end 2026-02-01",
-        "<%= config.bin %> signals count --json"
+        "<%= config.bin %> device rename <device-id> new-robot-name",
+        "<%= config.bin %> device rename <device-id> new-robot-name --json"
       ],
       "flags": {
         "json": {
@@ -3027,17 +3011,72 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:rename",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Rename a device",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "device",
+        "rename.js"
+      ]
+    },
+    "device:streams": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "List telemetry streams for a device.\n\nShows streams parsed from the device configuration as well as any streams\ndiscovered from actual ingested data (even if not explicitly configured).\nUnconfigured streams are marked with a SOURCE of \"data\" in the output.",
+      "examples": [
+        "<%= config.bin %> device streams <device-id>",
+        "<%= config.bin %> device streams <device-id> --json",
+        "<%= config.bin %> device streams <device-id> --days 30"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "end": {
-          "description": "End time (ISO 8601)",
-          "name": "end",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "start": {
-          "description": "Start time (ISO 8601)",
-          "name": "start",
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "days": {
+          "description": "How many days back to look for unconfigured streams in ingested data",
+          "name": "days",
+          "default": 14,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3045,35 +3084,35 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "signals:count",
+      "id": "device:streams",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get signal counts by type",
+      "summary": "List device streams",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "signals",
-        "count.js"
+        "device",
+        "streams.js"
       ]
     },
-    "signals:get": {
+    "device:tag": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Signal ID (UUID)",
+          "description": "Device ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get detailed information about a specific signal by its ID.\n\nShows signal details including the triggering event, goal, status, and type (manual, \neventTrigger, schedule, slack). Use --trace to also fetch the event and event trigger \ninformation.",
+      "description": "Add or update tags on a device.\n\nTags are key-value pairs. If a tag key already exists, its value will be updated.\nSpecify one or more tags with --tag key=value.",
       "examples": [
-        "<%= config.bin %> signals get <signal-id>",
-        "<%= config.bin %> signals get <signal-id> --trace",
-        "<%= config.bin %> signals get <signal-id> --json"
+        "<%= config.bin %> device tag <device-id> --tag location=warehouse",
+        "<%= config.bin %> device tag <device-id> --tag env=prod --tag region=us-east",
+        "<%= config.bin %> device tag <device-id> --tag location=factory --json"
       ],
       "flags": {
         "json": {
@@ -3103,37 +3142,47 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "trace": {
-          "description": "Fetch and display the triggering event and event trigger information",
-          "name": "trace",
-          "allowNo": false,
-          "type": "boolean"
+        "tag": {
+          "char": "t",
+          "description": "Tag to add or update (key=value), can be specified multiple times",
+          "name": "tag",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "signals:get",
+      "id": "device:tag",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get a signal by ID",
+      "summary": "Add or update tags on a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "signals",
-        "get.js"
+        "device",
+        "tag.js"
       ]
     },
-    "signals:list": {
+    "device:untag": {
       "aliases": [],
-      "args": {},
-      "description": "List all signals in your organization.\n\nSignals are points of interest that trigger AI-powered investigations. They can be\ncreated manually, generated from device events, scheduled, or from Slack/Teams integrations.",
+      "args": {
+        "id": {
+          "description": "Device ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Remove tags from a device.\n\nSpecify one or more tag keys to remove with --key.",
       "examples": [
-        "<%= config.bin %> signals list",
-        "<%= config.bin %> signals list --json"
+        "<%= config.bin %> device untag <device-id> --key location",
+        "<%= config.bin %> device untag <device-id> --key env --key region",
+        "<%= config.bin %> device untag <device-id> --key location --json"
       ],
       "flags": {
         "json": {
@@ -3162,33 +3211,440 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "key": {
+          "char": "k",
+          "description": "Tag key to remove, can be specified multiple times",
+          "name": "key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "signals:list",
+      "id": "device:untag",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List all signals",
+      "summary": "Remove tags from a device",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "signals",
-        "list.js"
+        "device",
+        "untag.js"
       ]
     },
-    "signals:query": {
+    "query": {
       "aliases": [],
       "args": {},
-      "description": "Query signals by time range and type.\n\nSignal types: manual, eventTrigger, schedule, slack.",
+      "description": "Query telemetry stream data for a device over a time range.\n\nReturns time-series datapoints for the specified stream(s). Supports aggregation\nfor downsampling large datasets, and --latest to get only the most recent value.\n\nStream types: numeric, text, image, video, location, json, bitset, battery, health,\n\"numeric set\", \"point cloud\", localization, \"transform tree\", file.\n\nAggregate levels: second, 5 seconds, 30 seconds, minute, 5 minutes, 30 minutes,\nhour, 4 hours, 12 hours, day, week, month, year.",
+      "examples": [
+        "<%= config.bin %> query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02",
+        "<%= config.bin %> query --device <id> --stream speed --aggregate hour --start 2026-01-01 --end 2026-02-01",
+        "<%= config.bin %> query --device <id> --stream battery_level --latest",
+        "<%= config.bin %> query --device <id> --stream temperature --type numeric --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "aggregate": {
+          "char": "a",
+          "description": "Aggregation level for downsampling",
+          "name": "aggregate",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end": {
+          "description": "End time (ISO 8601)",
+          "name": "end",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "latest": {
+          "description": "Only return the most recent value per stream",
+          "name": "latest",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of datapoints",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start": {
+          "description": "Start time (ISO 8601)",
+          "name": "start",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name(s), can be specified multiple times",
+          "name": "stream",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "type": {
+          "description": "Filter by stream type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "query",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Query telemetry stream data",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "query",
+        "index.js"
+      ]
+    },
+    "query:latest-values": {
+      "aliases": [],
+      "args": {},
+      "description": "Get the latest values for streams across devices.\n\nReturns the most recent value for specified streams without needing to specify\na time range. Useful for checking current sensor readings.\n\nUse --all-streams with a single device to automatically discover and query all\nstreams — both from the device configuration and from actual ingested data\n(unconfigured streams included).",
+      "examples": [
+        "<%= config.bin %> query latest-values --device <id> --stream battery_level",
+        "<%= config.bin %> query latest-values --device <id> --stream temperature --stream humidity",
+        "<%= config.bin %> query latest-values --device <id> --all-streams",
+        "<%= config.bin %> query latest-values --device <id> --all-streams --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all-streams": {
+          "description": "Query all streams for the device — from config and from ingested data (requires single --device)",
+          "name": "all-streams",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "days": {
+          "description": "How many days back to look for unconfigured streams when using --all-streams",
+          "name": "days",
+          "default": 14,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "device": {
+          "char": "d",
+          "description": "Device ID (UUID)",
+          "name": "device",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "stream": {
+          "char": "s",
+          "description": "Stream name(s), can be specified multiple times",
+          "name": "stream",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "query:latest-values",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get latest stream values",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "query",
+        "latest-values.js"
+      ]
+    },
+    "schedule:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Schedule ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a schedule.\n\nShows the full schedule configuration including cron expression, command template,\ninvestigation link, and execution settings.",
+      "examples": [
+        "<%= config.bin %> schedule get <schedule-id>",
+        "<%= config.bin %> schedule get <schedule-id> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "schedule:get",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get schedule details",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "schedule",
+        "get.js"
+      ]
+    },
+    "schedule:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all schedules in your organization.\n\nSchedules can trigger commands or investigations on a recurring (cron) or one-time basis.",
+      "examples": [
+        "<%= config.bin %> schedule list",
+        "<%= config.bin %> schedule list --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "schedule:list",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List schedules",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "schedule",
+        "list.js"
+      ]
+    },
+    "persona:delegate-task": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Persona ID (UUID)",
+          "name": "id",
+          "required": true
+        },
+        "goal": {
+          "description": "The task goal / instruction for the persona",
+          "name": "goal",
+          "required": true
+        }
+      },
+      "description": "Delegate a task to a persona for async execution.\n\nCreates a task with the given goal, assigns it to the persona, and queues it to run in the background. Returns immediately with a task ID you can use to check status later via \"persona task-status\".",
+      "examples": [
+        "<%= config.bin %> persona delegate-task <persona-id> \"Analyze recent device failures and summarize findings\"",
+        "<%= config.bin %> persona delegate-task <persona-id> \"Generate a daily report of fleet health\" --name \"Daily Fleet Report\"",
+        "<%= config.bin %> persona delegate-task <persona-id> \"Check all offline devices\" --dev"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "description": "Target the dev environment",
+          "exclusive": [
+            "stage"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "dev",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "stage": {
+          "description": "Target the stage environment",
+          "exclusive": [
+            "dev"
+          ],
+          "helpGroup": "GLOBAL",
+          "name": "stage",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "name": {
+          "char": "n",
+          "description": "Task name (defaults to first 50 chars of goal)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "persona:delegate-task",
+      "pluginAlias": "@formant/formant-cli",
+      "pluginName": "@formant/formant-cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Delegate an async task to a persona",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "persona",
+        "delegate-task.js"
+      ]
+    },
+    "persona:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Persona ID (UUID)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get detailed information about a persona including its integrations and available tools.\n\nUses the user-level persona endpoint which merges org, persona, and user configurations.",
       "examples": [
-        "<%= config.bin %> signals query --start 2026-01-01",
-        "<%= config.bin %> signals query --start 2026-01-01 --end 2026-02-01 --type eventTrigger",
-        "<%= config.bin %> signals query --start 2026-01-01 --json"
+        "<%= config.bin %> personas get <persona-id>",
+        "<%= config.bin %> personas get <persona-id> --json",
+        "<%= config.bin %> personas get <persona-id> --dev"
       ],
       "flags": {
         "json": {
@@ -3217,66 +3673,33 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "end": {
-          "description": "End time (ISO 8601)",
-          "name": "end",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start": {
-          "description": "Start time (ISO 8601)",
-          "name": "start",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "description": "Filter by signal type",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "manual",
-            "eventTrigger",
-            "schedule",
-            "slack"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "signals:query",
+      "id": "persona:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Query signals by time range",
+      "summary": "Get persona details and tools",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "signals",
-        "query.js"
+        "persona",
+        "get.js"
       ]
     },
-    "devices:config": {
+    "persona:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get the device configuration including stream definitions.\n\nShows the device's current configuration including telemetry streams, commands,\nand other settings.",
+      "args": {},
+      "description": "List AI personas available in your organization.\n\nShows both built-in and custom personas with their ID, name, and description.",
       "examples": [
-        "<%= config.bin %> devices config <device-id>",
-        "<%= config.bin %> devices config <device-id> --json"
+        "<%= config.bin %> personas list",
+        "<%= config.bin %> personas list --json",
+        "<%= config.bin %> personas list --dev"
       ],
       "flags": {
         "json": {
@@ -3309,35 +3732,35 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:config",
+      "id": "persona:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get device configuration",
+      "summary": "List AI personas",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "config.js"
+        "persona",
+        "list.js"
       ]
     },
-    "devices:create": {
+    "persona:task-status": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "Name for the new device",
-          "name": "name",
+        "taskId": {
+          "description": "Task ID (from delegate-task output)",
+          "name": "taskId",
           "required": true
         }
       },
-      "description": "Create a new device in your fleet.\n\nThe device is created as enabled by default. You can optionally specify tags.",
+      "description": "Check the status and results of a delegated task.\n\nShows all runs for a task including their status, result summary, and timestamps.",
       "examples": [
-        "<%= config.bin %> devices create my-robot",
-        "<%= config.bin %> devices create my-robot --tag location=warehouse --tag env=prod",
-        "<%= config.bin %> devices create my-robot --json"
+        "<%= config.bin %> persona task-status <task-id>",
+        "<%= config.bin %> persona task-status <task-id> --json",
+        "<%= config.bin %> persona task-status <task-id> --dev"
       ],
       "flags": {
         "json": {
@@ -3366,46 +3789,38 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "tag": {
-          "char": "t",
-          "description": "Tag to apply (key=value), can be specified multiple times",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:create",
+      "id": "persona:task-status",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a new device",
+      "summary": "Check status of a delegated task",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "create.js"
+        "persona",
+        "task-status.js"
       ]
     },
-    "devices:delete": {
+    "user:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Device ID (UUID)",
+          "description": "User ID (UUID)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Delete (disable) a device from your fleet.\n\nThis performs a soft-delete by disabling the device. The device and its telemetry\nhistory are preserved but it will no longer appear in device listings.",
+      "description": "Get detailed information about a user.\n\nShows user details including email, name, roles, and account settings.",
       "examples": [
-        "<%= config.bin %> devices delete <device-id>",
-        "<%= config.bin %> devices delete <device-id> --json"
+        "<%= config.bin %> user get <user-id>",
+        "<%= config.bin %> user get <user-id> --json"
       ],
       "flags": {
         "json": {
@@ -3438,34 +3853,28 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:delete",
+      "id": "user:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Delete (disable) a device",
+      "summary": "Get user details",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "delete.js"
+        "user",
+        "get.js"
       ]
     },
-    "devices:get": {
+    "user:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get detailed information about a specific device by its ID.",
+      "args": {},
+      "description": "List all users in your organization.\n\nShows user accounts, their email addresses, and account status.",
       "examples": [
-        "<%= config.bin %> devices get <device-id>",
-        "<%= config.bin %> devices get <device-id> --json"
+        "<%= config.bin %> user list",
+        "<%= config.bin %> user list --json"
       ],
       "flags": {
         "json": {
@@ -3498,34 +3907,29 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:get",
+      "id": "user:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get a device by ID",
+      "summary": "List users",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "get.js"
+        "user",
+        "list.js"
       ]
     },
-    "devices:last-seen": {
+    "signal:count": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get when a device was last seen online.\n\nShows the most recent timestamp when the device was detected as online.",
+      "args": {},
+      "description": "Get counts of signals grouped by type.\n\nReturns total counts and per-type breakdowns (manual, eventTrigger, schedule, slack).",
       "examples": [
-        "<%= config.bin %> devices last-seen <device-id>",
-        "<%= config.bin %> devices last-seen <device-id> --json"
+        "<%= config.bin %> signal count",
+        "<%= config.bin %> signal count --start 2026-01-01 --end 2026-02-01",
+        "<%= config.bin %> signal count --json"
       ],
       "flags": {
         "json": {
@@ -3554,35 +3958,55 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "end": {
+          "description": "End time (ISO 8601)",
+          "name": "end",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start": {
+          "description": "Start time (ISO 8601)",
+          "name": "start",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:last-seen",
+      "id": "signal:count",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Get device last seen timestamp",
+      "summary": "Get signal counts by type",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "last-seen.js"
+        "signal",
+        "count.js"
       ]
     },
-    "devices:list": {
+    "signal:create": {
       "aliases": [],
-      "args": {},
-      "description": "List robots and sensors in your fleet. Shows only online devices by default.\n\nUse --all to include offline devices.",
+      "args": {
+        "goal": {
+          "description": "Goal or description for the signal",
+          "name": "goal",
+          "required": true
+        }
+      },
+      "description": "Create a manual signal.\n\nSignals are points of interest that can trigger AI-powered investigations. Use this to\nmanually create a signal with a goal description, optionally targeting a specific device\nor persona.",
       "examples": [
-        "<%= config.bin %> devices list",
-        "<%= config.bin %> devices list --all",
-        "<%= config.bin %> devices list --all --limit 100",
-        "<%= config.bin %> devices list --tag location=warehouse",
-        "<%= config.bin %> devices list --name robot --dev --json"
+        "<%= config.bin %> signal create \"Robot arm jammed at joint 3\"",
+        "<%= config.bin %> signal create \"Battery draining fast\" --device <device-id>",
+        "<%= config.bin %> signal create \"Investigate sensor anomaly\" --persona <persona-id>",
+        "<%= config.bin %> signal create \"Test alarm scenario\" --investigation <taskflow-id>",
+        "<%= config.bin %> signal create \"Motor overheated\" --investigation <id> --ground-truth \"Should identify motor thermal fault\""
       ],
       "flags": {
         "json": {
@@ -3612,74 +4036,73 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "all": {
-          "char": "a",
-          "description": "Show all devices (online and offline)",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "device": {
+          "char": "d",
+          "description": "Device ID to associate with this signal",
+          "name": "device",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of devices to return",
-          "name": "limit",
-          "default": 50,
+        "ground-truth": {
+          "char": "g",
+          "dependsOn": [
+            "investigation"
+          ],
+          "description": "Expected outcome (ground truth) for this signal — requires --investigation",
+          "name": "ground-truth",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Filter devices by name (search)",
-          "name": "name",
+        "investigation": {
+          "char": "i",
+          "description": "Investigation (taskflow) ID this signal targets",
+          "name": "investigation",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tag": {
-          "char": "t",
-          "description": "Filter by tag (key=value), can be specified multiple times",
-          "name": "tag",
+        "persona": {
+          "char": "p",
+          "description": "Persona ID to handle this signal",
+          "name": "persona",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:list",
+      "id": "signal:create",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List robots and sensors in your fleet",
+      "summary": "Create a manual signal",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "list.js"
+        "signal",
+        "create.js"
       ]
     },
-    "devices:rename": {
+    "signal:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Device ID (UUID)",
+          "description": "Signal ID (UUID)",
           "name": "id",
           "required": true
-        },
-        "name": {
-          "description": "New name for the device",
-          "name": "name",
-          "required": true
         }
       },
-      "description": "Rename a device by updating its name.",
+      "description": "Get detailed information about a specific signal by its ID.\n\nShows signal details including the triggering event, goal, status, and type (manual, \neventTrigger, schedule, slack). Use --trace to also fetch the event and event trigger \ninformation.",
       "examples": [
-        "<%= config.bin %> devices rename <device-id> new-robot-name",
-        "<%= config.bin %> devices rename <device-id> new-robot-name --json"
+        "<%= config.bin %> signal get <signal-id>",
+        "<%= config.bin %> signal get <signal-id> --trace",
+        "<%= config.bin %> signal get <signal-id> --json"
       ],
       "flags": {
         "json": {
@@ -3708,38 +4131,39 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "trace": {
+          "description": "Fetch and display the triggering event and event trigger information",
+          "name": "trace",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:rename",
+      "id": "signal:get",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Rename a device",
+      "summary": "Get a signal by ID",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "rename.js"
+        "signal",
+        "get.js"
       ]
     },
-    "devices:streams": {
+    "signal:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "List telemetry streams configured on a device.\n\nShows a clean view of stream definitions parsed from the device configuration,\nincluding stream names, types, topics, and quality settings.",
+      "args": {},
+      "description": "List all signals in your organization.\n\nSignals are points of interest that trigger AI-powered investigations. They can be\ncreated manually, generated from device events, scheduled, or from Slack/Teams integrations.\n\nUse --investigation to also show ground truth (expected outcome) for each signal\nthat has one assigned for that investigation.",
       "examples": [
-        "<%= config.bin %> devices streams <device-id>",
-        "<%= config.bin %> devices streams <device-id> --json"
+        "<%= config.bin %> signal list",
+        "<%= config.bin %> signal list --investigation <taskflow-id>",
+        "<%= config.bin %> signal list --json"
       ],
       "flags": {
         "json": {
@@ -3768,39 +4192,42 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
+        },
+        "investigation": {
+          "char": "i",
+          "description": "Investigation (taskflow) ID — shows ground truth for signals that have one",
+          "name": "investigation",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:streams",
+      "id": "signal:list",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "List device streams",
+      "summary": "List all signals",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "streams.js"
+        "signal",
+        "list.js"
       ]
     },
-    "devices:tag": {
+    "signal:query": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Add or update tags on a device.\n\nTags are key-value pairs. If a tag key already exists, its value will be updated.\nSpecify one or more tags with --tag key=value.",
+      "args": {},
+      "description": "Query signals by time range and type.\n\nSignal types: manual, eventTrigger, schedule, slack.\n\nUse --investigation to also show ground truth (expected outcome) for each signal.",
       "examples": [
-        "<%= config.bin %> devices tag <device-id> --tag location=warehouse",
-        "<%= config.bin %> devices tag <device-id> --tag env=prod --tag region=us-east",
-        "<%= config.bin %> devices tag <device-id> --tag location=factory --json"
+        "<%= config.bin %> signal query --start 2026-01-01",
+        "<%= config.bin %> signal query --start 2026-01-01 --end 2026-02-01 --type eventTrigger",
+        "<%= config.bin %> signal query --start 2026-01-01 --investigation <taskflow-id>",
+        "<%= config.bin %> signal query --start 2026-01-01 --json"
       ],
       "flags": {
         "json": {
@@ -3830,47 +4257,83 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "tag": {
-          "char": "t",
-          "description": "Tag to add or update (key=value), can be specified multiple times",
-          "name": "tag",
+        "end": {
+          "description": "End time (ISO 8601)",
+          "name": "end",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "investigation": {
+          "char": "i",
+          "description": "Investigation (taskflow) ID — shows ground truth for signals that have one",
+          "name": "investigation",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start": {
+          "description": "Start time (ISO 8601)",
+          "name": "start",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Filter by signal type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "manual",
+            "eventTrigger",
+            "schedule",
+            "slack"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:tag",
+      "id": "signal:query",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Add or update tags on a device",
+      "summary": "Query signals by time range",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "tag.js"
+        "signal",
+        "query.js"
       ]
     },
-    "devices:untag": {
+    "signal:set-ground-truth": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Device ID (UUID)",
-          "name": "id",
+        "signalId": {
+          "description": "Signal ID (UUID)",
+          "name": "signalId",
+          "required": true
+        },
+        "investigationId": {
+          "description": "Investigation (taskflow) ID",
+          "name": "investigationId",
+          "required": true
+        },
+        "expectedOutcome": {
+          "description": "The expected outcome / ground truth for this signal",
+          "name": "expectedOutcome",
           "required": true
         }
       },
-      "description": "Remove tags from a device.\n\nSpecify one or more tag keys to remove with --key.",
+      "description": "Assign a ground truth (expected outcome) to a signal for an investigation.\n\nGround truths define what the correct outcome should be when an investigation processes\na given signal. They are used for evaluation and quality measurement of investigation\nworkflows.",
       "examples": [
-        "<%= config.bin %> devices untag <device-id> --key location",
-        "<%= config.bin %> devices untag <device-id> --key env --key region",
-        "<%= config.bin %> devices untag <device-id> --key location --json"
+        "<%= config.bin %> signal set-ground-truth <signal-id> <investigation-id> \"The alarm should be dismissed as a false positive\"",
+        "<%= config.bin %> signal set-ground-truth <signal-id> <investigation-id> \"Root cause: overheated motor in joint 3\" --json"
       ],
       "flags": {
         "json": {
@@ -3899,34 +4362,25 @@
           "name": "stage",
           "allowNo": false,
           "type": "boolean"
-        },
-        "key": {
-          "char": "k",
-          "description": "Tag key to remove, can be specified multiple times",
-          "name": "key",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devices:untag",
+      "id": "signal:set-ground-truth",
       "pluginAlias": "@formant/formant-cli",
       "pluginName": "@formant/formant-cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Remove tags from a device",
+      "summary": "Assign ground truth to a signal",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "devices",
-        "untag.js"
+        "signal",
+        "set-ground-truth.js"
       ]
     }
   },
-  "version": "0.3.0"
+  "version": "0.4.2"
 }