@tantawowa/hosanna-tools 3.17.0 → 3.18.0

package/README.md

@@ -3,7 +3,8 @@
 ## Documentation
 
 - **[MCP debugger](src/support-tools/mcp-server/README.md)** — `hst mcp:start`, debugger tools, commands by use case, examples, and RASP certification capture.
-- **[Video capture](docs/video-capture.md)** — standalone, agent-driven, and test-run recording for Apple simulators, Roku capture cards, and macOS windows.
+- **[Video capture](docs/video-capture.md)** — standalone, agent-driven, and test-run recording for Apple simulators, physical-TV capture cards, and macOS windows.
+- **[Browser, Tizen, and webOS](docs/browser-tizen-webos.md)** — canonical commands, desktop previews, package/device workflows, vendor trust, and CSP/LAN policy.
 - **[docs/README.md](docs/README.md)** — index of docs in this repo (MCP + source-map note).
 - **hosanna-ui** (separate repo): `docs/README.md` for agentic debugging and links back to this README.
 
@@ -102,7 +103,7 @@ Common build-script replacements:
 
 Long-running APIs such as `dev.run`, `debugger.start`, `mcp.start`, and RASP-owned certification capture workflows keep the same operational behavior as the corresponding CLI commands: they start services, attach to debuggers, or wait for user/session activity. `mcp.start` and `dev.run` are wired for programmatic no-exit behavior through the top-level API.
 
-### Installable web builds
+### Installable Browser builds
 
 `hosannaPwaPlugin` is a build-only Vite plugin for the generic install shell. The
 host application supplies its identity, artwork, launch selection, offline page,
@@ -205,7 +206,7 @@ Useful commands:
 ```bash
 npx hst app-config:compile --expression tv --platform web \
   --static-bundle-manifest asset-bundles/static-bundles.json
-npx hst run web dev browser --rebuild-app-config
+npx hst run browser dev emulator --rebuild-app-config
 npx hst app-config:clean --expression tv --platform web \
   --static-bundle-manifest asset-bundles/static-bundles.json
 ```
@@ -303,8 +304,10 @@ Hosanna Tools is a comprehensive CLI toolset for the Hosanna framework that prov
 The CLI commands are organized into logical groups using colon-separated namespacing:
 
 ### Development Commands
-- `run` - Canonical cross-platform app launcher. Bare interactive runs show one destination picker; explicit platform options support web, Roku, iOS, Apple TV, Android, and Android TV launch targets.
-- `capture` - Record an Apple simulator, Roku capture-card input, or macOS screen/window. The default timeout is 180 seconds; use `--timeout` to override it.
+- `run` - Canonical cross-platform app launcher. Bare interactive runs show one destination picker; explicit platform options include Browser, Samsung Tizen, LG webOS, Roku, Apple, and Android hosts.
+- `build` - Build/package without device discovery, deployment, launch, browser opening, or log streaming. Successful Tizen/webOS builds print their absolute `.wgt`/`.ipk` path.
+- `device:setup <tizen|webos>` - Guided, dry-runnable vendor setup: connect/authorize Samsung with SDB and verify an external signing profile, or register an LG ares alias and optionally run the official interactive key flow. HST never stores keys, certificates, or passphrases.
+- `capture` - Record an Apple simulator, a physical-TV capture-card input, or a macOS screen/window. The default timeout is 180 seconds; use `--timeout` to override it.
 - `target:list` - List launch targets for humans or agents, including web emulators, sims, and physical devices.
 - `dev:start` - Run dev processes: vite, generator watch, and optional debugger
 - `debugger:start` - Start the command debugger WebSocket proxy (only one debugger is needed for multiple apps; if the port is already in use, a friendly message is shown instead of crashing)
@@ -314,7 +317,13 @@ Examples:
 ```bash
 hst run
 hst run --last
-hst run --platform web
+hst run browser dev emulator
+hst run tizen dev emulator
+hst run webos dev emulator
+hst build tizen dev device --signing-profile samsung-tv-dev
+hst build webos dev device
+hst run tizen dev device "Samsung living room" --signing-profile samsung-tv-dev
+hst run webos dev device "LG living room"
 hst run --platform roku --target emulator
 hst run --platform ios --target emulator
 hst run --platform android --target emulator
@@ -337,7 +346,7 @@ hst target:list --form-factor tv --json
 
 Bare `hst run` in an interactive terminal discovers runnable web previews, vendor simulators, and online physical devices, then presents one flat destination picker. The last selection is placed first, so pressing Enter repeats it; `hst run --last` skips discovery and immediately uses that remembered destination. The selection is stored in the user-level `~/.hosanna-tools/run.json`, preserving existing defaults. Explicit commands remain deterministic, and non-interactive runs never open the picker.
 
-`--target emulator` starts or reuses the shared Vite/debugger dev services for any platform and opens a profiled DOM runtime URL for interactive runs; use `--device <preset-id>` to override defaults such as `iphone-15`, `pixel-8`, `apple-tv-4k`, `android-tv-1080p`, or `rokufhd`, and use `--no-open` for server-only launches. `--target sim` launches the vendor virtual device for platforms that have one: Apple Simulator for iOS and Apple TV, Android Emulator for Android and Android TV. `--target device` launches or deploys to physical local hardware. `web` and `browser` remain accepted aliases for the web emulator; `simulator` and `simulated` remain accepted aliases for `sim`; `emulated` remains an accepted alias for the web emulator. Device/sim runs record the target and refuse to overwrite a recorded session or safe-to-kill occupied resource in non-interactive mode unless `--replace` is passed. Preferred run defaults live in `.hosanna-tools/run.json`, and preferred devices live in `.hosanna-tools/devices.json` or `~/.hosanna-tools/devices.json`. Legacy `.hs-devices.json` files are still read for compatibility.
+`browser` is the canonical public platform; legacy platform input `web` is normalized to `browser`. `emulator` is the public desktop-preview target and HST retains internal target kind `web`. For Tizen and webOS, emulator mode launches the target-specific Vite config so compile-time initializers are selected; it is not a vendor simulator. `--target sim` launches a real vendor virtual device only for supported Apple/Android platforms. `--target device` launches or deploys to physical local hardware. Device/sim runs record the target and refuse to overwrite a recorded session or safe-to-kill occupied resource in non-interactive mode unless `--replace` is passed. Tizen/webOS previews cannot reuse a Browser session because their compiled alias graphs differ. Preferred run defaults live in `.hosanna-tools/run.json`, and friendly device aliases live in `.hosanna-tools/devices.json` or `~/.hosanna-tools/devices.json`; signing keys and device passphrases remain in vendor stores.
 
 ### Roku Commands (`roku:*`) - Roku Deployment & Packaging
 - `roku:run` - Deploy a Roku app to a device (supports .zip file or folder)
@@ -402,6 +411,14 @@ Production JavaScript bundles strip `console.*` calls by default. Configure this
 
 Roku builds also populate `assetServer.baseUrl` when an overlay does not define it. `hst run` uses the resolved project Vite port and a reachable LAN IPv4 address. Override either the complete URL with `HS_ASSET_SERVER_BASE_URL`, or its parts with `HS_ASSET_SERVER_HOST` and `HS_ASSET_SERVER_PORT`; the equivalent `HOSANNA_ASSET_SERVER_*` names are also accepted. Explicit build-config overlays remain authoritative. The legacy `game.assetBaseUrl` setting is generated independently for backward compatibility.
 
+Tizen/webOS builds prefer exact target overlays and fall back to the matching
+Web overlay only when the exact file is absent. Physical development builds
+resolve remote-debug loopback hosts to a reachable LAN address; override with
+`HS_REMOTE_DEBUG_HOST`. Production TV builds force remote debugging off. Exact
+non-secret service origins can be supplied with `--connect-origin` or
+`HS_TV_CONNECT_ORIGINS`; unresolved package tokens and wildcard origins fail
+staging. See [Browser, Tizen, and webOS](docs/browser-tizen-webos.md).
+
 Native builds can resolve config immediately before the platform build:
 
 ```bash
@@ -511,7 +528,7 @@ silently break an install.
 - `mcp:start` - Start the Hosanna MCP server for AI agent debugging
 - `mcp:stop` - Stop the Hosanna MCP server
 
-**Cursor and MCP:** Cursor does not magically attach to a terminal `hst mcp:start`. Add Hosanna as a Command MCP server (project **`.cursor/mcp.json`** or **Cursor Settings → MCP → Add Custom MCP**) so Cursor spawns **`hosanna-mcp`** over stdio. Start the command debugger/app explicitly with `hst run --platform web --target web`, `hst run --platform ios --target web`, `hst run --platform android-tv --target web`, or `hst run --platform roku --target device`.
+**Cursor and MCP:** Cursor does not magically attach to a terminal `hst mcp:start`. Add Hosanna as a Command MCP server (project **`.cursor/mcp.json`** or **Cursor Settings → MCP → Add Custom MCP**) so Cursor spawns **`hosanna-mcp`** over stdio. Start the command debugger/app explicitly with `hst run browser dev emulator`, `hst run tizen dev emulator`, `hst run webos dev emulator`, or `hst run roku dev device`.
 
 ### Deterministic UI testing
 
@@ -534,8 +551,9 @@ defineHosannaTestConfig({
 The finalized recording is written below
 `test-results/<testRunId>/<platform>-<target>/` and embedded in the HTML report.
 Browser targets use Playwright WebM. iOS/Apple TV simulators use `simctl` MP4.
-Physical Roku targets use AVFoundation or a configured macOS screen/window
-source. Native/device capture defaults to 180 seconds; override it with
+Physical Roku, Tizen, and webOS targets use AVFoundation or a configured macOS
+screen/window source; HST does not claim vendor-native TV recording.
+Native/device capture defaults to 180 seconds; override it with
 `timeoutSeconds`. This is a review artifact, not a replay format or executable
 test source.
 
@@ -611,7 +629,13 @@ For Roku device suites, the launcher builds and deploys before the test launch,
 
 ```bash
 # Development workflow
-hst run --platform web            # Start/reuse web dev services
+hst run browser dev emulator      # Canonical Browser host
+hst run tizen dev emulator        # Desktop Tizen composition preview
+hst run webos dev emulator        # Desktop webOS composition preview
+hst build tizen dev device --signing-profile samsung-tv-dev
+hst build webos dev device
+hst run tizen dev device "Samsung living room" --signing-profile samsung-tv-dev
+hst run webos dev device "LG living room"
 hst run --platform roku --target emulator
 hst run --platform ios --target emulator
 hst run --platform android --target emulator

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-08-13T19:41:42+00:00",
-  "buildDateISO": "2026-08-13T19:41:42.252Z",
+  "buildDate": "2026-08-14T06:25:48+00:00",
+  "buildDateISO": "2026-08-14T06:25:48.573Z",
   "timeZone": "UTC",
-  "gitHash": "40dd06c"
+  "gitHash": "ba52fa6"
 }

package/dist/capture/mcp-tools.d.ts

@@ -1,5 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type VideoCaptureManager } from './video-capture.js';
+export declare const VIDEO_CAPTURE_PLATFORMS: readonly ["ios", "apple-tv", "roku", "tizen", "webos", "macos"];
 export declare function registerVideoCaptureTools(server: McpServer, options?: {
     cwd?: string;
     manager?: VideoCaptureManager;

package/dist/capture/mcp-tools.js

@@ -3,10 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIDEO_CAPTURE_PLATFORMS = void 0;
 exports.registerVideoCaptureTools = registerVideoCaptureTools;
 const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
 const video_capture_js_1 = require("./video-capture.js");
+exports.VIDEO_CAPTURE_PLATFORMS = ['ios', 'apple-tv', 'roku', 'tizen', 'webos', 'macos'];
 function registerVideoCaptureTools(server, options = {}) {
     var _a, _b;
     const cwd = node_path_1.default.resolve((_a = options.cwd) !== null && _a !== void 0 ? _a : process.cwd());
@@ -14,7 +16,7 @@ function registerVideoCaptureTools(server, options = {}) {
     server.tool('start_video_capture', `Start an independent video capture session for an agent-driven scenario, manual demonstration, or test.
 
 The capture stops and finalizes automatically after ${video_capture_js_1.DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS} seconds by default. Override timeoutSeconds for a shorter or longer recording. Only one capture can be active in this MCP process at a time.`, {
-        platform: zod_1.z.enum(['ios', 'apple-tv', 'roku', 'macos']).describe('Platform being recorded'),
+        platform: zod_1.z.enum(exports.VIDEO_CAPTURE_PLATFORMS).describe('Platform being recorded'),
         source: zod_1.z.enum(['apple-simulator', 'avfoundation', 'macos-screen', 'macos-window']).optional()
             .describe('Capture source. Defaults from platform and supplied window/screen options.'),
         outputPath: zod_1.z.string().optional().describe('Output video path, relative to the project when not absolute'),

package/dist/capture/mcp-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../../src/capture/mcp-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../../src/capture/mcp-tools.ts"],"names":[],"mappings":"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"}

package/dist/capture/video-capture.d.ts

@@ -2,7 +2,7 @@ import { spawn } from 'node:child_process';
 import { listIosSimulatorTargets } from '../run/ios-simulator.js';
 import { listAppleTvSimulatorTargets } from '../run/apple-tv.js';
 export declare const DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS = 180;
-export type VideoCapturePlatform = 'ios' | 'apple-tv' | 'roku' | 'macos';
+export type VideoCapturePlatform = 'ios' | 'apple-tv' | 'roku' | 'tizen' | 'webos' | 'macos';
 export type VideoCaptureSource = 'apple-simulator' | 'avfoundation' | 'macos-screen' | 'macos-window';
 export type VideoCaptureStopReason = 'requested' | 'timeout' | 'signal' | 'shutdown' | 'process-exit' | 'start-failed';
 export type VideoCaptureState = 'recording' | 'stopping' | 'completed' | 'failed';

package/dist/cli.js

@@ -139,6 +139,11 @@ function runPlanFlagsFromCliArgs(args, format) {
         fontDelivery: rawHasFlag('font-delivery') ? args['font-delivery'] : undefined,
         bundleRevision: rawHasFlag('bundle-revision') ? args['bundle-revision'] : undefined,
         rebuildAppConfig: rawHasFlag('rebuild-app-config') ? Boolean(args['rebuild-app-config']) : undefined,
+        buildCmd: rawHasFlag('build-cmd') ? args['build-cmd'] : undefined,
+        viteConfig: rawHasFlag('vite-config') ? args['vite-config'] : undefined,
+        signingProfile: rawHasFlag('signing-profile') ? args['signing-profile'] : undefined,
+        appId: rawHasFlag('app-id') ? args['app-id'] : undefined,
+        connectOrigins: rawHasFlag('connect-origin') ? args['connect-origin'] : undefined,
         passthroughArgs: args['--'],
     };
 }
@@ -212,6 +217,9 @@ async function runRunPlanCommand(command, args) {
         else if (result.url) {
             console.info(`hst ${command}: ${(_c = result.appName) !== null && _c !== void 0 ? _c : 'app'} available at ${result.url}`);
         }
+        else if (result.artifactPath) {
+            console.info(`hst ${command}: package created at ${path.resolve(result.artifactPath)}`);
+        }
     }
     catch (err) {
         console.error(`❌ ${command} failed`);
@@ -240,7 +248,7 @@ const NATIVE_PLATFORM_CHOICES = [
     'cars', 'watches', 'all',
 ];
 const RUN_PLATFORM_CHOICES = [
-    'web', 'roku', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
+    'browser', 'web', 'tizen', 'webos', 'roku', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
     'android', 'android-tv', 'android-auto', 'wear-os', 'wearos', 'android-watch',
 ];
 function nativeInputFromArgs(args) {
@@ -305,7 +313,7 @@ async function runVideoCaptureCommand(args) {
     try {
         const platform = ((_a = args.platform) !== null && _a !== void 0 ? _a : args.platformArg);
         if (!platform)
-            throw new Error('Capture platform is required. Use ios, apple-tv, roku, or macos.');
+            throw new Error('Capture platform is required. Use ios, apple-tv, roku, tizen, webos, or macos.');
         const mod = await Promise.resolve().then(() => __importStar(require('./capture/video-capture.js')));
         const session = await mod.startVideoCapture({
             platform,
@@ -404,12 +412,12 @@ catch (err) {
     .command('capture [platformArg]', 'Record an Apple simulator, capture-card input, or macOS screen/window', yargs => yargs
     .positional('platformArg', {
     type: 'string',
-    choices: ['ios', 'apple-tv', 'roku', 'macos'],
+    choices: ['ios', 'apple-tv', 'roku', 'tizen', 'webos', 'macos'],
     describe: 'Platform being recorded',
 })
     .option('platform', {
     type: 'string',
-    choices: ['ios', 'apple-tv', 'roku', 'macos'],
+    choices: ['ios', 'apple-tv', 'roku', 'tizen', 'webos', 'macos'],
     describe: 'Platform being recorded (alternative to the positional argument)',
 })
     .option('source', {
@@ -1774,11 +1782,45 @@ catch (err) {
         console.error('❌ complib:serve failed:', err instanceof Error ? err.message : err);
         process.exit(1);
     }
+})
+    .command('device:setup <type>', 'Run the automatable, credential-safe portion of Samsung Tizen or LG webOS device setup', yargs => yargs
+    .positional('type', { type: 'string', choices: ['tizen', 'webos'] })
+    .option('host', { type: 'string', demandOption: true, describe: 'TV IP address or hostname' })
+    .option('alias', { type: 'string', default: 'myTV', describe: 'webOS ares device alias' })
+    .option('port', { type: 'number', default: 9922, describe: 'webOS Developer Mode SSH port' })
+    .option('username', { type: 'string', default: 'prisoner', describe: 'webOS Developer Mode SSH username' })
+    .option('default', { type: 'boolean', default: false, describe: 'Make the webOS alias the ares default' })
+    .option('get-key', { type: 'boolean', default: false, describe: 'Run the official interactive webOS ares-novacom key flow' })
+    .option('signing-profile', { type: 'string', describe: 'Verify an existing external Samsung signing profile' })
+    .option('dry-run', { type: 'boolean', default: false, describe: 'Print exact commands and manual prerequisites without changing vendor state' })
+    .example('$0 device:setup tizen --host 192.168.1.50 --signing-profile samsung-tv-dev --dry-run', 'Preview Samsung connection/profile checks')
+    .example('$0 device:setup webos --host 192.168.1.60 --alias living-room --get-key', 'Register an LG alias and enter the passphrase only in the official ares prompt'), async (args) => {
+    try {
+        const mod = await Promise.resolve().then(() => __importStar(require('./device/setup.js')));
+        const result = await mod.setupTvDevice({
+            cwd: process.cwd(),
+            type: args.type,
+            host: args.host,
+            alias: stringArg(args.alias),
+            port: args.port,
+            username: stringArg(args.username),
+            makeDefault: Boolean(args.default),
+            getKey: Boolean(args['get-key']),
+            signingProfile: stringArg(args['signing-profile']),
+            dryRun: Boolean(args['dry-run']),
+            env: process.env,
+        });
+        console.info(mod.formatDeviceSetupResult(result, Boolean(args['dry-run'])));
+    }
+    catch (error) {
+        console.error(`❌ device:setup failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
 })
     .command('device:list', 'List devices discovered by hst, merged with .hosanna-tools/devices.json preferences', yargs => yargs
     .option('type', {
     type: 'string',
-    choices: ['roku', 'ios', 'apple-tv', 'android', 'android-tv'],
+    choices: ['roku', 'tizen', 'webos', 'ios', 'apple-tv', 'android', 'android-tv'],
     describe: 'Filter devices by platform type',
 })
     .option('json', {
@@ -1804,6 +1846,48 @@ catch (err) {
         console.error(err instanceof Error ? err.message : String(err));
         process.exit(1);
     }
+})
+    .command('device:inspect <type>', 'Open the supported vendor inspector for an installed application', yargs => yargs
+    .positional('type', { type: 'string', choices: ['tizen', 'webos'] })
+    .option('device', { type: 'string', describe: 'Configured device alias, serial, IP, or name' })
+    .option('app-id', { type: 'string', describe: 'Application id override' })
+    .option('source-root', { type: 'string', describe: 'Staged project root containing the platform manifest' }), async (args) => {
+    try {
+        const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
+        await mod.runDeviceInspectCommand({
+            cwd: process.cwd(),
+            type: args.type,
+            device: stringArg(args.device),
+            appId: stringArg(args['app-id']),
+            sourceRoot: stringArg(args['source-root']),
+            env: process.env,
+        });
+    }
+    catch (error) {
+        console.error(`❌ device:inspect failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+})
+    .command('device:terminate <type>', 'Terminate an installed application through the supported vendor CLI', yargs => yargs
+    .positional('type', { type: 'string', choices: ['tizen', 'webos'] })
+    .option('device', { type: 'string', describe: 'Configured device alias, serial, IP, or name' })
+    .option('app-id', { type: 'string', describe: 'Application id override' })
+    .option('source-root', { type: 'string', describe: 'Staged project root containing the platform manifest' }), async (args) => {
+    try {
+        const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
+        await mod.runDeviceTerminateCommand({
+            cwd: process.cwd(),
+            type: args.type,
+            device: stringArg(args.device),
+            appId: stringArg(args['app-id']),
+            sourceRoot: stringArg(args['source-root']),
+            env: process.env,
+        });
+    }
+    catch (error) {
+        console.error(`❌ device:terminate failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
 })
     .command('target:list [platform]', 'List run targets discovered by hst, including web emulators, sims, and physical devices', yargs => yargs
     .positional('platform', {
@@ -1874,7 +1958,7 @@ catch (err) {
     .parserConfiguration({ 'boolean-negation': false, 'populate--': true })
     .positional('platform', {
     type: 'string',
-    describe: 'Build platform. Defaults from flags, env, .hosanna-tools/run.json, then web.',
+    describe: 'Build platform. Defaults from flags, env, .hosanna-tools/run.json, then Browser.',
 })
     .positional('env', {
     type: 'string',
@@ -1934,19 +2018,26 @@ catch (err) {
     .option('hsc-project', { type: 'string', describe: 'Explicit Roku HSC project file for hst build planning' })
     .option('config', { type: 'string', describe: 'Back-compatible alias for --hsconfig / --hsc-project' })
     .option('source-root', { type: 'string', describe: 'Roku source root to preserve in build planning output' })
+    .option('build-cmd', { type: 'string', describe: 'Override the platform bundle command; parsed and executed without a shell' })
+    .option('vite-config', { type: 'string', describe: 'Target Vite config for Browser/Tizen/webOS builds' })
+    .option('signing-profile', { type: 'string', describe: 'External Samsung certificate profile name (env: TIZEN_SECURITY_PROFILE)' })
+    .option('app-id', { type: 'string', describe: 'Override the packaged TV application id for launch/inspect' })
+    .option('connect-origin', { type: 'array', string: true, describe: 'Exact non-secret origin to allow in packaged-TV CSP/WARP; repeat as needed' })
     .example('$0 build roku dev device', 'Build the dev Roku output without deploying or streaming logs')
     .example('$0 build roku prod device --hsc-project platforms/hsconfig-roku.prod.json', 'Build Roku with an explicit HSC project file')
     .example('$0 build ios dev sim --device "iPhone 17 Pro"', 'Build an iOS simulator target without install, launch, or logs')
     .example('$0 build apple-watch dev sim --device "Apple Watch Series 11 (46mm)"', 'Build the paired Apple Watch simulator target')
     .example('$0 build wear-os dev sim --device "Wear_OS_Large_Round"', 'Build the Wear OS emulator target')
-    .example('$0 build web dev emulator', 'Resolve web runtime build config without opening a browser'), async (args) => {
+    .example('$0 build browser dev emulator', 'Resolve Browser runtime build config without opening a browser')
+    .example('$0 build tizen dev device --signing-profile samsung-tv-dev', 'Create a signed Samsung .wgt without contacting a TV')
+    .example('$0 build webos dev device', 'Create an LG .ipk without contacting a TV'), async (args) => {
     await runRunPlanCommand('build', args);
 })
     .command('run [platform] [env] [target] [deviceSelector]', 'Launch a Hosanna app on a platform target, including car and watch surfaces', yargs => yargs
     .parserConfiguration({ 'boolean-negation': false, 'populate--': true })
     .positional('platform', {
     type: 'string',
-    describe: 'Launch platform. Bare interactive runs show a destination picker; non-interactive runs default to web.',
+    describe: 'Launch platform. Bare interactive runs show a destination picker; non-interactive runs default to Browser.',
 })
     .positional('env', {
     type: 'string',
@@ -2010,7 +2101,11 @@ catch (err) {
     .option('no-build', { type: 'boolean', default: false, describe: 'Skip the platform build step for device runs' })
     .option('build-only', { type: 'boolean', default: false, describe: 'Plan or run build steps without opening browser/log streams where supported' })
     .option('no-logs', { type: 'boolean', default: false, describe: 'Do not stream device logs after launch where supported' })
-    .option('build-cmd', { type: 'string', describe: 'Override the platform build command for device runs' })
+    .option('build-cmd', { type: 'string', describe: 'Override the platform bundle or emulator dev command; parsed and executed without a shell' })
+    .option('vite-config', { type: 'string', describe: 'Target Vite config for Browser/Tizen/webOS builds' })
+    .option('signing-profile', { type: 'string', describe: 'External Samsung certificate profile name (env: TIZEN_SECURITY_PROFILE)' })
+    .option('app-id', { type: 'string', describe: 'Override the packaged TV application id for launch/inspect' })
+    .option('connect-origin', { type: 'array', string: true, describe: 'Exact non-secret origin to allow in packaged-TV CSP/WARP; repeat as needed' })
     .option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku/native run planning' })
     .option('hsc-project', { type: 'string', describe: 'Explicit Roku HSC project file for hst run planning' })
     .option('config', { type: 'string', describe: 'Back-compatible alias for --hsconfig / --hsc-project' })
@@ -2022,7 +2117,9 @@ catch (err) {
     .option('installer-password', { type: 'string', describe: 'Roku installer password (env: ROKU_DEVPASSWORD)' })
     .option('logs', { type: 'boolean', default: false, describe: 'Enable verbose deploy logging where supported' })
     .option('applySourceMapToPaths', { type: 'boolean', default: true, describe: 'Resolve Roku stack trace paths with source maps during log streaming' })
-    .example('$0 run --platform web', 'Start/reuse web dev services for this app')
+    .example('$0 run browser dev emulator', 'Start or reuse the canonical Browser preview')
+    .example('$0 run tizen dev emulator', 'Start or reuse the Samsung Tizen desktop preview')
+    .example('$0 run webos dev emulator', 'Start or reuse the LG webOS desktop preview')
     .example('$0 run', 'Choose once from all available web, simulator, and physical-device destinations')
     .example('$0 run --last', 'Immediately run on the last selected destination')
     .example('$0 run --platform roku --target emulator', 'Start/reuse the Roku TV web emulator')
@@ -2041,6 +2138,8 @@ catch (err) {
     .example('$0 run --platform apple-watch --target sim --device "Apple Watch Series 11 (46mm)"', 'Build and launch through the paired Apple Watch simulator')
     .example('$0 run --platform wear-os --target sim --device "Wear_OS_Large_Round"', 'Build, install, and launch on a Wear OS emulator')
     .example('$0 run --platform roku --target device --device "living room"', 'Build, deploy, launch, and stream logs on a Roku device')
+    .example('$0 run tizen dev device "living room" --signing-profile samsung-tv-dev', 'Build, install, and launch on a trusted Samsung TV')
+    .example('$0 run webos dev device "living room"', 'Build, install, and launch on a paired LG TV')
     .example('$0 run roku dev device --app criterion', 'Run a configured monorepo app/flavor')
     .example('$0 run roku prod device --hsc-project platforms/hsconfig.criterion.prod.json', 'Override the Roku HSC project file'), async (args) => {
     await runRunPlanCommand('run', args);
@@ -2049,7 +2148,7 @@ catch (err) {
     .parserConfiguration({ 'boolean-negation': false })
     .option('type', {
     type: 'string',
-    choices: ['roku', 'ios', 'apple-tv', 'android', 'android-tv'],
+    choices: ['roku', 'tizen', 'webos', 'ios', 'apple-tv', 'android', 'android-tv'],
     demandOption: true,
     describe: 'Target platform type',
 })
@@ -2073,7 +2172,11 @@ catch (err) {
 })
     .option('app-package', {
     type: 'string',
-    describe: 'Roku app .zip or folder to deploy',
+    describe: 'Built Roku .zip/folder, Tizen .wgt, or webOS .ipk to deploy',
+})
+    .option('app-id', {
+    type: 'string',
+    describe: 'Packaged Tizen/webOS application id override',
 })
     .option('source-root', {
     type: 'string',
@@ -2102,7 +2205,9 @@ catch (err) {
     describe: 'Resolve Roku stack trace paths with source maps during log streaming',
 })
     .example('$0 device:run --type roku', 'Build, deploy, launch, and stream Roku logs')
-    .example('$0 device:run --type roku --device "living room" --no-build', 'Deploy to a preferred Roku by name'), async (args) => {
+    .example('$0 device:run --type roku --device "living room" --no-build', 'Deploy to a preferred Roku by name')
+    .example('$0 device:run --type tizen --device "living room" --no-build --app-package ./app.wgt', 'Install and launch an existing Samsung package')
+    .example('$0 device:run --type webos --device "living room" --no-build --app-package ./app.ipk', 'Install and launch an existing LG package'), async (args) => {
     try {
         const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
         await mod.runDeviceRunCommand({
@@ -2113,6 +2218,7 @@ catch (err) {
             noLogs: Boolean(args['no-logs']),
             buildCmd: args['build-cmd'],
             appPackage: args['app-package'],
+            appId: args['app-id'],
             sourceRoot: args['source-root'],
             sourceMapRoot: args['source-map-root'],
             files: args.files,
@@ -2283,6 +2389,7 @@ catch (err) {
     .option('deviceAppPort', { type: 'number', description: 'Port for device app client', default: 59152 })
     .option('extensionPort', { type: 'number', description: 'Port for extension client', default: 59153 })
     .option('defaultClientType', { type: 'string', choices: ['web', 'device'], default: 'web', description: 'Default target client for extension messages' })
+    .option('vite-config', { type: 'string', description: 'Project-relative Vite config selecting the Web DOM host composition' })
     .option('appName', { type: 'string', description: 'App name for multi-app debugger (e.g. FanDuel). Shown in the extension and used when registering with assign-port. Exposed as VITE_HOSANNA_APP_NAME.' }), async (args) => {
     if (args.verbose) {
         process.env.HOSANNA_VERBOSE = '1';
@@ -2295,6 +2402,7 @@ catch (err) {
         deviceAppPort: args.deviceAppPort,
         extensionPort: args.extensionPort,
         defaultClientType: args.defaultClientType || 'web',
+        viteConfig: args['vite-config'],
         appName: args.appName,
     });
 })