From 11fbc219b53b2364ce7b1468293a04aeccef3969 Mon Sep 17 00:00:00 2001 From: tck Date: Thu, 19 Mar 2026 09:48:41 +0800 Subject: [PATCH] docs(quick-4): complete quick task artifacts --- .../4-PLAN.md | 166 ++++++++++++++++++ 1 file changed, 166 insertions(+) create mode 100644 .planning/quick/4-create-full-remote-hd-web-interface-at-p/4-PLAN.md diff --git a/.planning/quick/4-create-full-remote-hd-web-interface-at-p/4-PLAN.md b/.planning/quick/4-create-full-remote-hd-web-interface-at-p/4-PLAN.md new file mode 100644 index 000000000..bbce4a69c --- /dev/null +++ b/.planning/quick/4-create-full-remote-hd-web-interface-at-p/4-PLAN.md @@ -0,0 +1,166 @@ +--- +phase: quick +plan: 4 +type: execute +wave: 1 +depends_on: [] +files_modified: + - start.sh + - install_everything.sh + - README.md + - WIKI.md + - sample_interface/src/app/hooks/useDisplayMode.ts +autonomous: true +requirements: + - QUICK-04-01 + - QUICK-04-02 + - QUICK-04-03 + - QUICK-04-04 + - QUICK-04-05 + +must_haves: + truths: + - 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 + artifacts: + - path: "start.sh" + provides: "Dual-mode default execution and dev:9999 menu option" + - path: "install_everything.sh" + provides: "Dual-mode installation documentation" + - path: "README.md" + provides: "Port 9999 and dual-mode documentation" + - path: "WIKI.md" + provides: "Port 9999 and dual-mode technical documentation" + - path: "sample_interface/src/app/hooks/useDisplayMode.ts" + provides: "Port 9999 recognized as remote HD mode" + key_links: + - from: "start.sh" + to: "dev server on ports 8888 and 9999" + via: "concurrent process spawning" + - from: "useDisplayMode.ts" + to: "port 9999" + via: "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. + + + +@./.opencode/get-shit-done/workflows/execute-plan.md +@./.opencode/get-shit-done/templates/summary.md + + + +@./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 + + + +- 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 + + + +After completion, create `.planning/quick/4-create-full-remote-hd-web-interface-at-p/4-SUMMARY.md` +