unified-tvdevelopment-cli 1.0.1-beta.0

package/docs/RELEASE.md

@@ -0,0 +1,37 @@
+# Release Process
+
+## Quick release
+
+```bash
+npm version patch   # or minor / major
+git push origin main --follow-tags
+```
+
+The `npm version` command:
+1. Updates `package.json` version
+2. Creates a git commit (`chore(release): vX.Y.Z`)
+3. Creates a git tag (`vX.Y.Z`)
+
+Pushing the tag triggers the `release.yml` workflow which:
+- Runs tests
+- Validates tag matches `package.json`
+- Publishes to npm
+- Creates a GitHub Release
+
+## Pre-releases (beta)
+
+```bash
+npm version prerelease --preid=beta   # e.g. 1.0.1-beta.0
+git push origin main --follow-tags
+```
+
+Beta releases publish to npm with `--tag beta` and are marked as pre-release on GitHub.
+
+## Platform CLI dependencies
+
+| Platform | Required tools |
+|---|---|
+| LG webOS | `npm install -g @webosose/ares-cli` |
+| Samsung Tizen | Tizen Studio (tizen + sdb) |
+| Amazon Fire TV | `adb` (Android Platform Tools) + `inputd-cli` + `LoggingCtl` |
+| Android TV | Android SDK (`adb`, `gradle`, `avdmanager`, `emulator`) |

package/install.ps1

@@ -0,0 +1,81 @@
+# unified-tvdevelopment-cli — Windows installer
+# Run: iwr -useb https://raw.githubusercontent.com/FernandoHaeser/unified-tvdevelopment-cli/main/install.ps1 | iex
+
+$ErrorActionPreference = 'Stop'
+$Package = "unified-tvdevelopment-cli"
+$Bin     = "tvdev"
+
+function Write-Banner {
+  Write-Host ""
+  Write-Host "  [TV Dev Manager]" -ForegroundColor Cyan
+  Write-Host "  Universal Smart TV Development CLI" -ForegroundColor DarkGray
+  Write-Host "  LG webOS · Samsung Tizen · Amazon Fire TV · Android TV" -ForegroundColor DarkGray
+  Write-Host ""
+}
+
+function Write-Step  { param($msg) Write-Host "`n  > $msg" -ForegroundColor Cyan }
+function Write-Ok    { param($msg) Write-Host "  [OK] $msg" -ForegroundColor Green }
+function Write-Warn  { param($msg) Write-Host "  [!!] $msg" -ForegroundColor Yellow }
+function Write-Fail  { param($msg) Write-Host "  [XX] $msg" -ForegroundColor Red; exit 1 }
+
+Write-Banner
+
+# Node.js
+Write-Step "Checking Node.js"
+try {
+  $nodeVer = (node --version 2>$null)
+  Write-Ok "Node.js $nodeVer"
+} catch {
+  Write-Fail "Node.js not found. Install from https://nodejs.org"
+}
+
+# npm
+Write-Step "Checking npm"
+try {
+  $npmVer = (npm --version 2>$null)
+  Write-Ok "npm $npmVer"
+} catch {
+  Write-Fail "npm not found."
+}
+
+# Install
+Write-Step "Installing $Package"
+npm install -g $Package
+Write-Ok "$Package installed"
+
+# Verify
+Write-Step "Verifying"
+try {
+  $binPath = (Get-Command $Bin -ErrorAction Stop).Path
+  Write-Ok "$Bin -> $binPath"
+} catch {
+  Write-Warn "$Bin not found in PATH. You may need to restart your terminal."
+}
+
+# Platform tools check
+Write-Step "Checking platform-specific tools"
+
+if (Get-Command "ares-setup-device" -ErrorAction SilentlyContinue) {
+  Write-Ok "ares-cli (LG webOS) found"
+} else {
+  Write-Warn "ares-cli not found. Install: npm install -g @webosose/ares-cli"
+}
+
+if (Get-Command "sdb" -ErrorAction SilentlyContinue) {
+  Write-Ok "sdb (Samsung Tizen) found"
+} else {
+  Write-Warn "sdb not found. Install Tizen Studio from developer.samsung.com/smarttv"
+}
+
+if (Get-Command "adb" -ErrorAction SilentlyContinue) {
+  Write-Ok "adb (Amazon Fire TV / Android TV) found"
+} else {
+  Write-Warn "adb not found. Install Android SDK Platform Tools"
+}
+
+Write-Host ""
+Write-Host "  Installation complete!" -ForegroundColor Green
+Write-Host ""
+Write-Host "  Launch TV Dev Manager: " -NoNewline
+Write-Host $Bin -ForegroundColor Cyan
+Write-Host ""

package/install.sh

@@ -0,0 +1,194 @@
+#!/usr/bin/env bash
+# unified-tvdevelopment-cli — one-line installer
+# Supports: LG webOS, Samsung Tizen, Amazon Fire TV, Android TV
+#
+#   curl -fsSL https://raw.githubusercontent.com/FernandoHaeser/unified-tvdevelopment-cli/main/install.sh | bash
+#
+set -euo pipefail
+
+PACKAGE="unified-tvdevelopment-cli"
+BIN="tvdev"
+REQUIRED_NODE=18
+NVM_VERSION="v0.39.7"
+INSTALL_NODE_VERSION="20"
+
+if [ -t 1 ]; then
+  INDIGO='\033[38;5;99m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+  RED='\033[0;31m'; BOLD='\033[1m'; DIM='\033[2m'; RESET='\033[0m'
+else
+  INDIGO=''; GREEN=''; YELLOW=''; RED=''; BOLD=''; DIM=''; RESET=''
+fi
+
+banner() {
+  echo ""
+  echo -e "${BOLD}${INDIGO}  ◉  TV Dev Manager${RESET}"
+  echo -e "  ${INDIGO}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  echo -e "  ${DIM}Universal Smart TV Development CLI${RESET}"
+  echo -e "  ${DIM}LG webOS · Samsung Tizen · Amazon Fire TV · Android TV${RESET}"
+  echo ""
+}
+
+step()  { echo -e "\n${BOLD}${INDIGO}  ▶  $*${RESET}"; }
+ok()    { echo -e "  ${GREEN}✓${RESET}  $*"; }
+info()  { echo -e "  ${INDIGO}●${RESET}  $*"; }
+warn()  { echo -e "  ${YELLOW}⚠${RESET}  $*"; }
+skip()  { echo -e "  ${DIM}–  $* (skipped)${RESET}"; }
+fail()  { echo -e "\n  ${RED}✗  $*${RESET}\n"; exit 1; }
+
+detect_shell_rc() {
+  case "${SHELL:-}" in
+    */zsh)  echo "$HOME/.zshrc"  ;;
+    */bash)
+      [ -f "$HOME/.bash_profile" ] && echo "$HOME/.bash_profile" || echo "$HOME/.bashrc"
+      ;;
+    */fish) echo "$HOME/.config/fish/config.fish" ;;
+    *)      echo "$HOME/.profile" ;;
+  esac
+}
+
+idempotent_path_export() {
+  local bin_dir rc_file export_line
+  bin_dir=$(npm prefix -g 2>/dev/null)/bin
+  rc_file=$(detect_shell_rc)
+
+  if echo ":${PATH}:" | grep -q ":${bin_dir}:"; then
+    ok "PATH already contains npm global bin"
+    return
+  fi
+
+  if [[ "${SHELL:-}" == */fish ]]; then
+    export_line="set -gx PATH \$PATH ${bin_dir}"
+  else
+    export_line="export PATH=\"\$PATH:${bin_dir}\""
+  fi
+
+  if [ -f "$rc_file" ] && grep -qF "$bin_dir" "$rc_file" 2>/dev/null; then
+    ok "PATH entry already in ${rc_file}"
+    return
+  fi
+
+  echo "" >> "$rc_file"
+  echo "# added by unified-tvdevelopment-cli installer" >> "$rc_file"
+  echo "$export_line" >> "$rc_file"
+  ok "Added PATH entry to ${rc_file}"
+  export PATH="${PATH}:${bin_dir}"
+}
+
+# ── Idempotency ───────────────────────────────────────────────────────────────
+banner
+
+step "Checking existing installation"
+
+if command -v "$BIN" &>/dev/null; then
+  INSTALLED_VER=$(npm list -g --depth=0 "$PACKAGE" 2>/dev/null \
+    | grep "$PACKAGE" | sed 's/.*@//' | tr -d '[:space:]' || true)
+  LATEST_VER=$(npm show "$PACKAGE" version 2>/dev/null || true)
+
+  ok "${BIN} already installed"
+  [ -n "$INSTALLED_VER" ] && info "Installed : ${INSTALLED_VER}"
+  [ -n "$LATEST_VER"    ] && info "Latest    : ${LATEST_VER}"
+
+  if [ -n "$INSTALLED_VER" ] && [ "$INSTALLED_VER" = "$LATEST_VER" ]; then
+    ok "Already up to date — nothing to do"
+    echo ""
+    echo -e "  ${BOLD}Run: ${INDIGO}${BIN}${RESET}"
+    echo ""
+    exit 0
+  fi
+else
+  info "${BIN} not yet installed — starting fresh install"
+fi
+
+# ── Node.js ───────────────────────────────────────────────────────────────────
+step "Checking Node.js"
+
+install_node_via_nvm() {
+  warn "Node.js not found — installing via nvm"
+  export NVM_DIR="${HOME}/.nvm"
+  curl -fsSL "https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh" | bash
+  [ -s "$NVM_DIR/nvm.sh" ] && source "$NVM_DIR/nvm.sh"
+  nvm install "$INSTALL_NODE_VERSION" --lts
+  nvm use "$INSTALL_NODE_VERSION"
+  nvm alias default "$INSTALL_NODE_VERSION"
+  ok "Node.js $(node --version) installed via nvm"
+}
+
+if ! command -v node &>/dev/null; then
+  NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
+  if [ -s "$NVM_DIR/nvm.sh" ]; then
+    source "$NVM_DIR/nvm.sh"
+    if ! command -v node &>/dev/null; then nvm install "$INSTALL_NODE_VERSION" --lts && nvm use "$INSTALL_NODE_VERSION"; fi
+  else
+    install_node_via_nvm
+  fi
+fi
+
+! command -v node &>/dev/null && fail "Node.js install failed. Install manually: https://nodejs.org"
+
+NODE_MAJOR=$(node --version | sed 's/v//' | cut -d. -f1)
+[ "$NODE_MAJOR" -lt "$REQUIRED_NODE" ] && fail "Node.js ${REQUIRED_NODE}+ required. Current: $(node --version)"
+
+ok "Node.js $(node --version)"
+
+# ── npm ───────────────────────────────────────────────────────────────────────
+step "Checking npm"
+! command -v npm &>/dev/null && fail "npm not found."
+ok "npm $(npm --version)"
+
+# ── Install ───────────────────────────────────────────────────────────────────
+step "Installing ${PACKAGE}"
+info "Running: npm install -g ${PACKAGE}"
+echo ""
+npm install -g "$PACKAGE"
+echo ""
+ok "${PACKAGE} installed"
+
+# ── PATH ──────────────────────────────────────────────────────────────────────
+step "Setting up PATH"
+idempotent_path_export
+hash -r 2>/dev/null || true
+
+if command -v "$BIN" &>/dev/null; then
+  ok "${BIN} is in PATH → $(command -v ${BIN})"
+else
+  warn "${BIN} not in PATH for this session. Restart your terminal or:"
+  echo -e "\n  ${BOLD}source $(detect_shell_rc)${RESET}\n"
+fi
+
+# ── Platform tools ────────────────────────────────────────────────────────────
+step "Checking platform-specific tools"
+
+if command -v ares-setup-device &>/dev/null; then
+  ok "ares-cli (LG webOS) → $(command -v ares-setup-device)"
+else
+  warn "ares-cli not found. Install for webOS: npm install -g @webosose/ares-cli"
+fi
+
+if command -v sdb &>/dev/null; then
+  ok "sdb (Samsung Tizen) → $(command -v sdb)"
+else
+  warn "sdb not found. Install Tizen Studio from developer.samsung.com/smarttv"
+fi
+
+if command -v adb &>/dev/null; then
+  ok "adb (Amazon Fire TV / Android TV) → $(command -v adb)"
+else
+  warn "adb not found. Install: brew install android-platform-tools (macOS) or Android Studio SDK"
+fi
+
+if command -v inputd-cli &>/dev/null; then
+  ok "inputd-cli (Amazon Fire TV input) → $(command -v inputd-cli)"
+else
+  warn "inputd-cli not found (optional — Amazon Fire TV remote input simulation)"
+fi
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}${INDIGO}  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+echo -e "${BOLD}${GREEN}  ✓  Installation complete!${RESET}"
+echo ""
+echo -e "  Launch TV Dev Manager:  ${BOLD}${INDIGO}${BIN}${RESET}"
+echo ""
+echo -e "  ${DIM}GitHub : https://github.com/FernandoHaeser/unified-tvdevelopment-cli${RESET}"
+echo -e "  ${DIM}npm    : https://npmjs.com/package/unified-tvdevelopment-cli${RESET}"
+echo ""

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "unified-tvdevelopment-cli",
+  "version": "1.0.1-beta.0",
+  "description": "Universal TUI manager for Smart TV development — LG webOS, Samsung Tizen, Amazon Fire TV, Android TV",
+  "type": "module",
+  "bin": {
+    "tvdev": "dist/cli.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "mkdir -p dist && esbuild src/index.js --bundle --packages=external --platform=node --format=esm --outfile=dist/_bundle.mjs --loader:.js=jsx && printf '#!/usr/bin/env node\\n' | cat - dist/_bundle.mjs > dist/cli.mjs && chmod +x dist/cli.mjs && rm dist/_bundle.mjs",
+    "start": "npm run build && node dist/cli.mjs",
+    "dev": "npm run build && node dist/cli.mjs",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:e2e": "vitest run tests/e2e",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "webos",
+    "tizen",
+    "android-tv",
+    "fire-tv",
+    "amazon",
+    "ares-cli",
+    "sdb",
+    "adb",
+    "tui",
+    "cli",
+    "smart-tv",
+    "lg",
+    "samsung"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FernandoHaeser/unified-tvdevelopment-cli"
+  },
+  "files": [
+    "dist/",
+    "install.sh",
+    "install.ps1",
+    "README.md",
+    "docs/"
+  ],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "execa": "^9.3.0",
+    "ink": "^5.0.1",
+    "ink-text-input": "^6.0.0",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.9",
+    "esbuild": "^0.28.0",
+    "vitest": "^2.1.9"
+  }
+}