rtu_v5/.planning/quick/4-create-full-remote-hd-web-interface-at-p/4-PLAN.md

phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves

phase	plan	type	wave	depends_on	files_modified	autonomous	requirements	must_haves
quick	4	execute	1		start.sh install_everything.sh README.md WIKI.md sample_interface/src/app/hooks/useDisplayMode.ts	true	QUICK-04-01 QUICK-04-02 QUICK-04-03 QUICK-04-04 QUICK-04-05	truths artifacts key_links Port 9999 recognized as "remote HD" display mode start.sh runs both 8888 (kiosk) and 9999 (remote HD) by default when no args start.sh menu includes option for dev:9999 All documentation updated with port 9999 and dual-mode default behavior path provides start.sh Dual-mode default execution and dev:9999 menu option path provides install_everything.sh Dual-mode installation documentation path provides README.md Port 9999 and dual-mode documentation path provides WIKI.md Port 9999 and dual-mode technical documentation path provides sample_interface/src/app/hooks/useDisplayMode.ts Port 9999 recognized as remote HD mode from to via start.sh dev server on ports 8888 and 9999 concurrent process spawning from to via useDisplayMode.ts port 9999 window.location.port check

Add port 9999 as a new "remote HD" display mode and update scripts/documentation for dual-mode default startup.

Purpose: Provide a dedicated Full HD remote interface port (9999) alongside the kiosk port (8888), with both servers starting by default for seamless local touchscreen and remote desktop access. Output: Updated scripts, documentation, and display mode detection supporting port 9999.

<execution_context> @./.opencode/get-shit-done/workflows/execute-plan.md @./.opencode/get-shit-done/templates/summary.md </execution_context>

@./sample_interface/src/app/hooks/useDisplayMode.ts @./start.sh @./README.md @./WIKI.md task 1: Update useDisplayMode hook for port 9999 sample_interface/src/app/hooks/useDisplayMode.ts Update the DisplayMode type to include 'remote-hd' as a third option. Modify useDisplayMode() and getDisplayMode() functions to recognize port '9999' and return 'remote-hd'. Port 9090 should continue to return 'remote'. All other ports should continue to return 'kiosk'.

Export type DisplayMode = 'kiosk' | 'remote' | 'remote-hd';

grep -q "remote-hd" sample_interface/src/app/hooks/useDisplayMode.ts && echo "PASS: remote-hd type added" || echo "FAIL: remote-hd not found" grep -q "port === '9999'" sample_interface/src/app/hooks/useDisplayMode.ts && echo "PASS: port 9999 check added" || echo "FAIL: port 9999 check not found" DisplayMode type includes 'remote-hd', port 9999 returns 'remote-hd' mode task 2: Update start.sh for dual-mode default and dev:9999 option start.sh 1. Add new menu option "4) dev:9999" after dev:9090 (renumber existing options 4-10 to 5-11) 2. Add case handler for "4|dev:9999" that runs dev server on port 9999 3. Modify the script to detect when NO arguments are provided (interactive menu mode is already handled by the while loop at the end) 4. When no arguments provided AND not in interactive mode, default to starting BOTH servers: - Start dev server on port 8888 in background - Start dev server on port 9999 in background - Show connection info for both ports - Wait for both processes 5. Update the show_menu() function to include the new option and renumber others

The key change is in the argument parsing section - when $# -eq 0, instead of going to the interactive menu, it should start both servers. Add a check at the beginning for a "--dual" flag or similar to trigger dual mode.

Actually, simpler approach: When run with no arguments, start both servers in background and show info for both.

grep -q "dev:9999" start.sh && echo "PASS: dev:9999 menu option exists" || echo "FAIL: dev:9999 not found" grep -q "9999" start.sh && grep -q "8888" start.sh && echo "PASS: Both ports referenced" || echo "FAIL: Missing port reference" bash -n start.sh && echo "PASS: start.sh syntax valid" || echo "FAIL: Syntax error in start.sh" start.sh has dev:9999 menu option, starts both 8888 and 9999 by default when run without arguments task 3: Update documentation (README.md, WIKI.md, install_everything.sh) README.md, WIKI.md, install_everything.sh Update all three files to document: 1. Port 9999 as "remote HD" mode for Full HD desktop interface 2. Dual-mode default behavior (8888 + 9999 both start when running ./start.sh without arguments) 3. Update port tables to include 9999

README.md changes:
- Add port 9999 to the "Display Modes" table
- Update "Essential files to run" section to mention dual-mode default
- Add note that ./start.sh without args starts both servers

WIKI.md changes:
- Add "Remote HD Mode (Port 9999)" section after Remote Mode
- Update Display Modes section with port 9999 info
- Update Start Script Options table to include dev:9999
- Update Installation Script section to mention dual-mode

install_everything.sh changes:
- Update final message to mention both ports will be available
- Add comments about dual-mode behavior

grep -q "9999" README.md && echo "PASS: README.md mentions port 9999" || echo "FAIL: README.md missing port 9999" grep -q "9999" WIKI.md && echo "PASS: WIKI.md mentions port 9999" || echo "FAIL: WIKI.md missing port 9999" grep -qi "dual" README.md && echo "PASS: README.md mentions dual mode" || echo "FAIL: README.md missing dual mode" All documentation files updated with port 9999 and dual-mode default behavior - useDisplayMode.ts recognizes port 9999 as 'remote-hd' - start.sh runs both 8888 and 9999 when invoked without arguments - start.sh menu includes dev:9999 option - README.md, WIKI.md, and install_everything.sh document the new port and dual-mode behavior - All scripts have valid bash syntax

<success_criteria>

• Port 9999 is recognized as 'remote-hd' display mode in useDisplayMode hook
• ./start.sh without arguments starts both 8888 and 9999 servers concurrently
• ./start.sh dev:9999 starts server on port 9999
• Documentation in README.md, WIKI.md, and install_everything.sh is updated with port 9999 and dual-mode info </success_criteria>

After completion, create `.planning/quick/4-create-full-remote-hd-web-interface-at-p/4-SUMMARY.md`