@trillboards/cli 0.1.0 → 0.1.3

package/oclif.manifest.json

@@ -133,6 +133,60 @@
         "billing.js"
       ]
     },
+    "code": {
+      "aliases": [],
+      "args": {},
+      "description": "Wrap your coding agent and earn from its dead-time (plays text/image/video ads while it thinks)",
+      "examples": [
+        "<%= config.bin %> code",
+        "<%= config.bin %> code claude",
+        "<%= config.bin %> code -- codex --foo"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "code",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "code.js"
+      ]
+    },
     "debug": {
       "aliases": [],
       "args": {
@@ -754,20 +808,12 @@
         "whoami.js"
       ]
     },
-    "audience:live": {
+    "ads:disable": {
       "aliases": [],
-      "args": {
-        "screen_id": {
-          "description": "Screen ID to monitor",
-          "name": "screen_id",
-          "required": true
-        }
-      },
-      "description": "Real-time audience sensing data for a screen",
+      "args": {},
+      "description": "Turn off the in-place sponsored lines (removes the Claude Code dead-time hook).",
       "examples": [
-        "<%= config.bin %> audience live scr_abc123",
-        "<%= config.bin %> audience live scr_abc123 --format json",
-        "<%= config.bin %> audience live scr_abc123 --interval 3"
+        "<%= config.bin %> ads disable"
       ],
       "flags": {
         "api-key": {
@@ -797,19 +843,11 @@
             "yaml"
           ],
           "type": "option"
-        },
-        "interval": {
-          "description": "Polling interval in seconds",
-          "name": "interval",
-          "default": 5,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "audience:live",
+      "id": "ads:disable",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -819,18 +857,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "audience",
-        "live.js"
+        "ads",
+        "disable.js"
       ]
     },
-    "billing:usage": {
+    "ads:enable": {
       "aliases": [],
       "args": {},
-      "description": "Billing usage details with optional per-product breakdown",
+      "description": "Turn on in-place sponsored lines in Claude Code (installs the dead-time hook). Opt-in; undo with `ads disable`.",
       "examples": [
-        "<%= config.bin %> billing usage",
-        "<%= config.bin %> billing usage --breakdown",
-        "<%= config.bin %> billing usage --format json"
+        "<%= config.bin %> ads enable"
       ],
       "flags": {
         "api-key": {
@@ -860,17 +896,11 @@
             "yaml"
           ],
           "type": "option"
-        },
-        "breakdown": {
-          "description": "Show per-product breakdown table",
-          "name": "breakdown",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "ads:enable",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -880,24 +910,40 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "usage.js"
+        "ads",
+        "enable.js"
       ]
     },
-    "errors": {
+    "ads:hook": {
       "aliases": [],
-      "args": {
-        "code": {
-          "description": "Error code to look up (e.g. screen_not_found)",
-          "name": "code",
-          "required": false
-        }
-      },
-      "description": "Look up error codes from the error catalog",
+      "args": {},
+      "description": "Internal: Claude Code dead-time hook handler (renders an in-place sponsor line).",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "ads:hook",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ads",
+        "hook.js"
+      ]
+    },
+    "ads:login": {
+      "aliases": [],
+      "args": {},
+      "description": "Log in to the agent-ads program with your Trillboards account (email + password)",
       "examples": [
-        "<%= config.bin %> errors",
-        "<%= config.bin %> errors screen_not_found",
-        "<%= config.bin %> errors --format json"
+        "<%= config.bin %> ads login",
+        "<%= config.bin %> ads login --email you@example.com",
+        "TRILLBOARDS_USER_TOKEN=<jwt> <%= config.bin %> ads login"
       ],
       "flags": {
         "api-key": {
@@ -927,11 +973,25 @@
             "yaml"
           ],
           "type": "option"
+        },
+        "email": {
+          "description": "Account email (prompts if omitted)",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "description": "Account password (prompts hidden if omitted; avoid passing on the command line)",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "errors",
+      "id": "ads:login",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -941,18 +1001,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "errors",
-        "index.js"
+        "ads",
+        "login.js"
       ]
     },
-    "endpoints": {
+    "ads:start": {
       "aliases": [],
       "args": {},
-      "description": "Discover available API endpoints",
+      "description": "Register this machine as a virtual screen and rent its AI-coding-agent dead-time for money",
       "examples": [
-        "<%= config.bin %> endpoints",
-        "<%= config.bin %> endpoints --search screens",
-        "<%= config.bin %> endpoints --format json"
+        "<%= config.bin %> ads start",
+        "<%= config.bin %> ads start --once",
+        "<%= config.bin %> ads start --simulate --interval 30"
       ],
       "flags": {
         "api-key": {
@@ -983,10 +1043,28 @@
           ],
           "type": "option"
         },
-        "search": {
-          "char": "s",
-          "description": "Search query to filter endpoints",
-          "name": "search",
+        "name": {
+          "description": "Display name for this virtual screen (defaults to \"Claude Code on <hostname>\")",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "once": {
+          "description": "Register, heartbeat once, serve a single ad, then exit (great for testing)",
+          "name": "once",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "simulate": {
+          "description": "Treat each interval tick as a dead-time trigger (v0 stand-in for real detection)",
+          "name": "simulate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interval": {
+          "description": "Seconds between dead-time fills in --simulate mode (default 60)",
+          "name": "interval",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -994,7 +1072,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "endpoints",
+      "id": "ads:start",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1004,19 +1082,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "endpoints",
-        "index.js"
+        "ads",
+        "start.js"
       ]
     },
-    "logs:tail": {
+    "audience:live": {
       "aliases": [],
-      "args": {},
-      "description": "Tail real-time request logs via server-sent events",
+      "args": {
+        "screen_id": {
+          "description": "Screen ID to monitor",
+          "name": "screen_id",
+          "required": true
+        }
+      },
+      "description": "Real-time audience sensing data for a screen",
       "examples": [
-        "<%= config.bin %> logs tail",
-        "<%= config.bin %> logs tail --events error.occurred",
-        "<%= config.bin %> logs tail --status 4xx,5xx",
-        "<%= config.bin %> logs tail --events request.logged,error.occurred --status 5xx"
+        "<%= config.bin %> audience live scr_abc123",
+        "<%= config.bin %> audience live scr_abc123 --format json",
+        "<%= config.bin %> audience live scr_abc123 --interval 3"
       ],
       "flags": {
         "api-key": {
@@ -1047,17 +1130,10 @@
           ],
           "type": "option"
         },
-        "events": {
-          "description": "Comma-separated SSE event types to subscribe to",
-          "name": "events",
-          "default": "request.logged,error.occurred",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "description": "Filter by status code pattern (e.g. \"4xx\", \"5xx\", \"4xx,5xx\", \"404\")",
-          "name": "status",
+        "interval": {
+          "description": "Polling interval in seconds",
+          "name": "interval",
+          "default": 5,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1065,7 +1141,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:tail",
+      "id": "audience:live",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1075,19 +1151,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "tail.js"
+        "audience",
+        "live.js"
       ]
     },
-    "screens:watch": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "Live fleet dashboard — watch all screens in real-time",
+      "description": "Billing usage details with optional per-product breakdown",
       "examples": [
-        "<%= config.bin %> screens watch",
-        "<%= config.bin %> screens watch --filter online",
-        "<%= config.bin %> screens watch --sort earnings",
-        "<%= config.bin %> screens watch --format json"
+        "<%= config.bin %> billing usage",
+        "<%= config.bin %> billing usage --breakdown",
+        "<%= config.bin %> billing usage --format json"
       ],
       "flags": {
         "api-key": {
@@ -1118,42 +1193,16 @@
           ],
           "type": "option"
         },
-        "filter": {
-          "description": "Filter screens by status",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "online",
-            "offline"
-          ],
-          "type": "option"
-        },
-        "interval": {
-          "description": "Refresh interval in seconds",
-          "name": "interval",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort": {
-          "description": "Sort column",
-          "name": "sort",
-          "default": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "name",
-            "earnings",
-            "fill-rate"
-          ],
-          "type": "option"
+        "breakdown": {
+          "description": "Show per-product breakdown table",
+          "name": "breakdown",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "screens:watch",
+      "id": "billing:usage",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1163,16 +1212,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "screens",
-        "watch.js"
+        "billing",
+        "usage.js"
       ]
     },
-    "generated:generated-changelog-query": {
+    "devices:reconcile": {
       "aliases": [],
-      "args": {},
-      "description": "Query API changelog",
+      "args": {
+        "file": {
+          "description": "Path to your device external IDs — a JSON array, {\"external_ids\":[...]}, or one ID per line",
+          "name": "file",
+          "required": true
+        }
+      },
+      "description": "Reconcile your device fleet — diff your external IDs against what Trillboards has registered (matched / missing / orphan / malformed / duplicate)",
       "examples": [
-        "$ trillboards generated changelog query"
+        "<%= config.bin %> devices reconcile my-devices.json",
+        "<%= config.bin %> devices reconcile ids.txt --format json"
       ],
       "flags": {
         "api-key": {
@@ -1202,12 +1258,189 @@
             "yaml"
           ],
           "type": "option"
-        },
-        "since": {
-          "description": "Only entries dated on or after this date (YYYY-MM-DD). Unreleased entries always included.",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "devices:reconcile",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "devices",
+        "reconcile.js"
+      ]
+    },
+    "endpoints": {
+      "aliases": [],
+      "args": {},
+      "description": "Discover available API endpoints",
+      "examples": [
+        "<%= config.bin %> endpoints",
+        "<%= config.bin %> endpoints --search screens",
+        "<%= config.bin %> endpoints --format json"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "search": {
+          "char": "s",
+          "description": "Search query to filter endpoints",
+          "name": "search",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "endpoints",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "endpoints",
+        "index.js"
+      ]
+    },
+    "errors": {
+      "aliases": [],
+      "args": {
+        "code": {
+          "description": "Error code to look up (e.g. screen_not_found)",
+          "name": "code",
+          "required": false
+        }
+      },
+      "description": "Look up error codes from the error catalog",
+      "examples": [
+        "<%= config.bin %> errors",
+        "<%= config.bin %> errors screen_not_found",
+        "<%= config.bin %> errors --format json"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "errors",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "errors",
+        "index.js"
+      ]
+    },
+    "generated:generated-changelog-query": {
+      "aliases": [],
+      "args": {},
+      "description": "Query API changelog",
+      "examples": [
+        "$ trillboards generated changelog query"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "since": {
+          "description": "Only entries dated on or after this date (YYYY-MM-DD). Unreleased entries always included.",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
         "type": {
@@ -1234,12 +1467,432 @@
         "generated-changelog-query.js"
       ]
     },
-    "generated:generated-data-api-aggregate": {
+    "generated:generated-csi-venue-history": {
+      "aliases": [],
+      "args": {
+        "screenId": {
+          "description": "Mongo ObjectId of the screen / venue sensing node (24-char lowercase hex).",
+          "name": "screenId",
+          "required": true
+        }
+      },
+      "description": "Historical venue occupancy in 10-minute CSI buckets.",
+      "examples": [
+        "$ trillboards generated csi-venue-history"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "hours": {
+          "description": "Look-back window in hours. Absent or non-positive values fall back to 24; values above 168 are capped to 168 (7 days).",
+          "name": "hours",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-csi-venue-history",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-csi-venue-history.js"
+      ]
+    },
+    "generated:generated-csi-venue-occupancy": {
+      "aliases": [],
+      "args": {
+        "screenId": {
+          "description": "Mongo ObjectId of the screen / venue sensing node (24-char lowercase hex).",
+          "name": "screenId",
+          "required": true
+        }
+      },
+      "description": "Real-time venue occupancy from WiFi CSI sensing.",
+      "examples": [
+        "$ trillboards generated csi-venue-occupancy"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-csi-venue-occupancy",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-csi-venue-occupancy.js"
+      ]
+    },
+    "generated:generated-data-api-aggregate": {
+      "aliases": [],
+      "args": {},
+      "description": "Aggregate audience analytics for a time window.",
+      "examples": [
+        "$ trillboards generated data-api-aggregate"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "group_by": {
+          "description": "Dimension to group aggregations by.",
+          "name": "group_by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metric": {
+          "description": "Metric to aggregate on.",
+          "name": "metric",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "since": {
+          "description": "Relative time window (e.g. \"24h\", \"7d\").",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-data-api-aggregate",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-data-api-aggregate.js"
+      ]
+    },
+    "generated:generated-data-api-list-screens": {
+      "aliases": [],
+      "args": {},
+      "description": "List screens visible to the caller.",
+      "examples": [
+        "$ trillboards generated data-api-list-screens"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "limit": {
+          "description": "limit",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "description": "offset",
+          "name": "offset",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "venue_type": {
+          "description": "Filter by venue taxonomy type (e.g. bar, restaurant).",
+          "name": "venue_type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "country": {
+          "description": "ISO-3166 alpha-2 country code.",
+          "name": "country",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-data-api-list-screens",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-data-api-list-screens.js"
+      ]
+    },
+    "generated:generated-data-api-lookalike-screens": {
+      "aliases": [],
+      "args": {},
+      "description": "Find screens with similar audience profiles.",
+      "examples": [
+        "$ trillboards generated data-api-lookalike-screens"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "screen_id": {
+          "description": "Internal screen identifier.",
+          "name": "screen_id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "limit",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "min_similarity": {
+          "description": "min_similarity",
+          "name": "min_similarity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-data-api-lookalike-screens",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-data-api-lookalike-screens.js"
+      ]
+    },
+    "generated:generated-data-api-query-dsl": {
+      "aliases": [],
+      "args": {},
+      "description": "Composable query DSL over approved datasets.",
+      "examples": [
+        "$ trillboards generated data-api-query-dsl"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON request body",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-data-api-query-dsl",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-data-api-query-dsl.js"
+      ]
+    },
+    "generated:generated-data-api-screen-audience-history": {
       "aliases": [],
-      "args": {},
-      "description": "Aggregate audience analytics for a time window.",
+      "args": {
+        "screenId": {
+          "description": "Internal screen identifier.",
+          "name": "screenId",
+          "required": true
+        }
+      },
+      "description": "Historical audience_metrics rows for a screen.",
       "examples": [
-        "$ trillboards generated data-api-aggregate"
+        "$ trillboards generated data-api-screen-audience-history"
       ],
       "flags": {
         "api-key": {
@@ -1270,23 +1923,23 @@
           ],
           "type": "option"
         },
-        "group_by": {
-          "description": "Dimension to group aggregations by.",
-          "name": "group_by",
+        "since": {
+          "description": "ISO-8601 start timestamp.",
+          "name": "since",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metric": {
-          "description": "Metric to aggregate on.",
-          "name": "metric",
+        "until": {
+          "description": "ISO-8601 end timestamp.",
+          "name": "until",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "since": {
-          "description": "Relative time window (e.g. \"24h\", \"7d\").",
-          "name": "since",
+        "limit": {
+          "description": "limit",
+          "name": "limit",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1294,7 +1947,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-aggregate",
+      "id": "generated:generated-data-api-screen-audience-history",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1305,15 +1958,21 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-aggregate.js"
+        "generated-data-api-screen-audience-history.js"
       ]
     },
-    "generated:generated-data-api-list-screens": {
+    "generated:generated-data-api-screen-audience-live": {
       "aliases": [],
-      "args": {},
-      "description": "List screens visible to the caller.",
+      "args": {
+        "screenId": {
+          "description": "Internal screen identifier.",
+          "name": "screenId",
+          "required": true
+        }
+      },
+      "description": "Real-time audience snapshot for a screen.",
       "examples": [
-        "$ trillboards generated data-api-list-screens"
+        "$ trillboards generated data-api-screen-audience-live"
       ],
       "flags": {
         "api-key": {
@@ -1343,39 +2002,11 @@
             "yaml"
           ],
           "type": "option"
-        },
-        "limit": {
-          "description": "limit",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "offset": {
-          "description": "offset",
-          "name": "offset",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "venue_type": {
-          "description": "Filter by venue taxonomy type (e.g. bar, restaurant).",
-          "name": "venue_type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "country": {
-          "description": "ISO-3166 alpha-2 country code.",
-          "name": "country",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-list-screens",
+      "id": "generated:generated-data-api-screen-audience-live",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1386,15 +2017,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-list-screens.js"
+        "generated-data-api-screen-audience-live.js"
       ]
     },
-    "generated:generated-data-api-lookalike-screens": {
+    "generated:generated-data-api-semantic-search": {
       "aliases": [],
       "args": {},
-      "description": "Find screens with similar audience profiles.",
+      "description": "Similarity search over scene embeddings.",
       "examples": [
-        "$ trillboards generated data-api-lookalike-screens"
+        "$ trillboards generated data-api-semantic-search"
       ],
       "flags": {
         "api-key": {
@@ -1425,9 +2056,9 @@
           ],
           "type": "option"
         },
-        "screen_id": {
-          "description": "Internal screen identifier.",
-          "name": "screen_id",
+        "q": {
+          "description": "q",
+          "name": "q",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1439,6 +2070,13 @@
           "multiple": false,
           "type": "option"
         },
+        "since": {
+          "description": "Relative time window (e.g. \"24h\", \"7d\").",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "min_similarity": {
           "description": "min_similarity",
           "name": "min_similarity",
@@ -1449,7 +2087,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-lookalike-screens",
+      "id": "generated:generated-data-api-semantic-search",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1460,15 +2098,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-lookalike-screens.js"
+        "generated-data-api-semantic-search.js"
       ]
     },
-    "generated:generated-data-api-query-dsl": {
+    "generated:generated-data-api-stats": {
       "aliases": [],
       "args": {},
-      "description": "Composable query DSL over approved datasets.",
+      "description": "Platform-wide counters.",
       "examples": [
-        "$ trillboards generated data-api-query-dsl"
+        "$ trillboards generated data-api-stats"
       ],
       "flags": {
         "api-key": {
@@ -1498,18 +2136,11 @@
             "yaml"
           ],
           "type": "option"
-        },
-        "data": {
-          "description": "JSON request body",
-          "name": "data",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-query-dsl",
+      "id": "generated:generated-data-api-stats",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1520,21 +2151,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-query-dsl.js"
+        "generated-data-api-stats.js"
       ]
     },
-    "generated:generated-data-api-screen-audience-history": {
+    "generated:generated-data-api-stream": {
       "aliases": [],
-      "args": {
-        "screenId": {
-          "description": "Internal screen identifier.",
-          "name": "screenId",
-          "required": true
-        }
-      },
-      "description": "Historical audience_metrics rows for a screen.",
+      "args": {},
+      "description": "Server-Sent Events stream of live audience/observation events.",
       "examples": [
-        "$ trillboards generated data-api-screen-audience-history"
+        "$ trillboards generated data-api-stream"
       ],
       "flags": {
         "api-key": {
@@ -1565,23 +2190,16 @@
           ],
           "type": "option"
         },
-        "since": {
-          "description": "ISO-8601 start timestamp.",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "until": {
-          "description": "ISO-8601 end timestamp.",
-          "name": "until",
+        "observation_family": {
+          "description": "observation_family",
+          "name": "observation_family",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "limit",
-          "name": "limit",
+        "venue_type": {
+          "description": "venue_type",
+          "name": "venue_type",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1589,7 +2207,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-screen-audience-history",
+      "id": "generated:generated-data-api-stream",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1600,21 +2218,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-screen-audience-history.js"
+        "generated-data-api-stream.js"
       ]
     },
-    "generated:generated-data-api-screen-audience-live": {
+    "generated:generated-data-api-usage": {
       "aliases": [],
-      "args": {
-        "screenId": {
-          "description": "Internal screen identifier.",
-          "name": "screenId",
-          "required": true
-        }
-      },
-      "description": "Real-time audience snapshot for a screen.",
+      "args": {},
+      "description": "API usage for the authenticated key (billing dashboard).",
       "examples": [
-        "$ trillboards generated data-api-screen-audience-live"
+        "$ trillboards generated data-api-usage"
       ],
       "flags": {
         "api-key": {
@@ -1644,11 +2256,18 @@
             "yaml"
           ],
           "type": "option"
+        },
+        "days": {
+          "description": "days",
+          "name": "days",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-screen-audience-live",
+      "id": "generated:generated-data-api-usage",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1659,15 +2278,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-screen-audience-live.js"
+        "generated-data-api-usage.js"
       ]
     },
-    "generated:generated-data-api-semantic-search": {
+    "generated:generated-device-ota-manifest": {
       "aliases": [],
       "args": {},
-      "description": "Similarity search over scene embeddings.",
+      "description": "Signed OTA manifest for managed-device update clients.",
       "examples": [
-        "$ trillboards generated data-api-semantic-search"
+        "$ trillboards generated device-ota-manifest"
       ],
       "flags": {
         "api-key": {
@@ -1698,30 +2317,69 @@
           ],
           "type": "option"
         },
-        "q": {
-          "description": "q",
-          "name": "q",
+        "agent": {
+          "description": "Optional agent type filter (`agent-core`, `agent-core-lite`, etc.). When omitted the caller receives the default manifest bundle.",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-device-ota-manifest",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-device-ota-manifest.js"
+      ]
+    },
+    "generated:generated-example-healthcheck": {
+      "aliases": [],
+      "args": {},
+      "description": "Example healthcheck (Phase 3 pipeline proof)",
+      "examples": [
+        "$ trillboards generated example-healthcheck"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "limit",
-          "name": "limit",
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "since": {
-          "description": "Relative time window (e.g. \"24h\", \"7d\").",
-          "name": "since",
+        "format": {
+          "description": "Output format",
+          "name": "format",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
           "type": "option"
         },
-        "min_similarity": {
-          "description": "min_similarity",
-          "name": "min_similarity",
+        "verbose": {
+          "description": "When `true`, include diagnostic fields in the response.",
+          "name": "verbose",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1729,7 +2387,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-semantic-search",
+      "id": "generated:generated-example-healthcheck",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1740,15 +2398,21 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-semantic-search.js"
+        "generated-example-healthcheck.js"
       ]
     },
-    "generated:generated-data-api-stats": {
+    "generated:generated-federated-get-latest-model-descriptor": {
       "aliases": [],
-      "args": {},
-      "description": "Platform-wide counters.",
+      "args": {
+        "modelType": {
+          "description": "Federated model name.",
+          "name": "modelType",
+          "required": true
+        }
+      },
+      "description": "Fetch the latest aggregated model descriptor (download URL + sha256 + version).",
       "examples": [
-        "$ trillboards generated data-api-stats"
+        "$ trillboards generated federated-get-latest-model-descriptor"
       ],
       "flags": {
         "api-key": {
@@ -1778,11 +2442,46 @@
             "yaml"
           ],
           "type": "option"
+        },
+        "venue_type": {
+          "description": "Venue category (required).",
+          "name": "venue_type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "venue_subtype": {
+          "description": "venue_subtype",
+          "name": "venue_subtype",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "daypart": {
+          "description": "daypart",
+          "name": "daypart",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "geo": {
+          "description": "geo",
+          "name": "geo",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "device_profile": {
+          "description": "device_profile",
+          "name": "device_profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-stats",
+      "id": "generated:generated-federated-get-latest-model-descriptor",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1793,15 +2492,21 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-stats.js"
+        "generated-federated-get-latest-model-descriptor.js"
       ]
     },
-    "generated:generated-data-api-stream": {
+    "generated:generated-federated-get-model-weights": {
       "aliases": [],
-      "args": {},
-      "description": "Server-Sent Events stream of live audience/observation events.",
+      "args": {
+        "modelType": {
+          "description": "Federated model name.",
+          "name": "modelType",
+          "required": true
+        }
+      },
+      "description": "Fetch aggregated weights for the device-specific slice.",
       "examples": [
-        "$ trillboards generated data-api-stream"
+        "$ trillboards generated federated-get-model-weights"
       ],
       "flags": {
         "api-key": {
@@ -1832,16 +2537,37 @@
           ],
           "type": "option"
         },
-        "observation_family": {
-          "description": "observation_family",
-          "name": "observation_family",
+        "venue_type": {
+          "description": "Venue category for slice lookup. Snake_case query alias of venueType.",
+          "name": "venue_type",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "venue_type": {
-          "description": "venue_type",
-          "name": "venue_type",
+        "venue_subtype": {
+          "description": "venue_subtype",
+          "name": "venue_subtype",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "daypart": {
+          "description": "daypart",
+          "name": "daypart",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "geo": {
+          "description": "geo",
+          "name": "geo",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "device_profile": {
+          "description": "device_profile",
+          "name": "device_profile",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1849,7 +2575,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-stream",
+      "id": "generated:generated-federated-get-model-weights",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1860,15 +2586,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-stream.js"
+        "generated-federated-get-model-weights.js"
       ]
     },
-    "generated:generated-data-api-usage": {
+    "generated:generated-federated-gradient-upload": {
       "aliases": [],
       "args": {},
-      "description": "API usage for the authenticated key (billing dashboard).",
+      "description": "Upload sparsified gradients for multi-slice federated aggregation.",
       "examples": [
-        "$ trillboards generated data-api-usage"
+        "$ trillboards generated federated-gradient-upload"
       ],
       "flags": {
         "api-key": {
@@ -1899,9 +2625,9 @@
           ],
           "type": "option"
         },
-        "days": {
-          "description": "days",
-          "name": "days",
+        "data": {
+          "description": "JSON request body",
+          "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1909,7 +2635,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-data-api-usage",
+      "id": "generated:generated-federated-gradient-upload",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1920,15 +2646,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-data-api-usage.js"
+        "generated-federated-gradient-upload.js"
       ]
     },
-    "generated:generated-device-ota-manifest": {
+    "generated:generated-federated-performance-upload": {
       "aliases": [],
       "args": {},
-      "description": "Signed OTA manifest for managed-device update clients.",
+      "description": "Report on-device model performance metrics.",
       "examples": [
-        "$ trillboards generated device-ota-manifest"
+        "$ trillboards generated federated-performance-upload"
       ],
       "flags": {
         "api-key": {
@@ -1959,9 +2685,9 @@
           ],
           "type": "option"
         },
-        "agent": {
-          "description": "Optional agent type filter (`agent-core`, `agent-core-lite`, etc.). When omitted the caller receives the default manifest bundle.",
-          "name": "agent",
+        "data": {
+          "description": "JSON request body",
+          "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1969,7 +2695,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-device-ota-manifest",
+      "id": "generated:generated-federated-performance-upload",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -1980,15 +2706,15 @@
         "dist",
         "commands",
         "generated",
-        "generated-device-ota-manifest.js"
+        "generated-federated-performance-upload.js"
       ]
     },
-    "generated:generated-example-healthcheck": {
+    "generated:generated-federated-taste-upload": {
       "aliases": [],
       "args": {},
-      "description": "Example healthcheck (Phase 3 pipeline proof)",
+      "description": "Upload a screen-taste embedding for content personalization aggregation.",
       "examples": [
-        "$ trillboards generated example-healthcheck"
+        "$ trillboards generated federated-taste-upload"
       ],
       "flags": {
         "api-key": {
@@ -2019,9 +2745,9 @@
           ],
           "type": "option"
         },
-        "verbose": {
-          "description": "When `true`, include diagnostic fields in the response.",
-          "name": "verbose",
+        "data": {
+          "description": "JSON request body",
+          "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2029,7 +2755,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "generated:generated-example-healthcheck",
+      "id": "generated:generated-federated-taste-upload",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -2040,7 +2766,7 @@
         "dist",
         "commands",
         "generated",
-        "generated-example-healthcheck.js"
+        "generated-federated-taste-upload.js"
       ]
     },
     "generated:generated-playground-dry-run": {
@@ -2461,6 +3187,165 @@
         "generated-sensing-paired-training-upload.js"
       ]
     },
+    "logs:tail": {
+      "aliases": [],
+      "args": {},
+      "description": "Tail real-time request logs via server-sent events",
+      "examples": [
+        "<%= config.bin %> logs tail",
+        "<%= config.bin %> logs tail --events error.occurred",
+        "<%= config.bin %> logs tail --status 4xx,5xx",
+        "<%= config.bin %> logs tail --events request.logged,error.occurred --status 5xx"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "events": {
+          "description": "Comma-separated SSE event types to subscribe to",
+          "name": "events",
+          "default": "request.logged,error.occurred",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Filter by status code pattern (e.g. \"4xx\", \"5xx\", \"4xx,5xx\", \"404\")",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logs:tail",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logs",
+        "tail.js"
+      ]
+    },
+    "screens:watch": {
+      "aliases": [],
+      "args": {},
+      "description": "Live fleet dashboard — watch all screens in real-time",
+      "examples": [
+        "<%= config.bin %> screens watch",
+        "<%= config.bin %> screens watch --filter online",
+        "<%= config.bin %> screens watch --sort earnings",
+        "<%= config.bin %> screens watch --format json"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "filter": {
+          "description": "Filter screens by status",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "online",
+            "offline"
+          ],
+          "type": "option"
+        },
+        "interval": {
+          "description": "Refresh interval in seconds",
+          "name": "interval",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort column",
+          "name": "sort",
+          "default": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "name",
+            "earnings",
+            "fill-rate"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "screens:watch",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "screens",
+        "watch.js"
+      ]
+    },
     "sandbox:create": {
       "aliases": [],
       "args": {},
@@ -2693,5 +3578,5 @@
       ]
     }
   },
-  "version": "0.1.0"
+  "version": "0.1.3"
 }