ALFA 009 add owner browser launch

Author: ToolboxAid

dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_manual-validation-notes.md

@@ -12,6 +12,7 @@ Expected diagnostics:
 - `Role: owner`
 - `Web URL: http://127.0.0.1:5510`
 - `API URL: http://127.0.0.1:5511/api`
+- `Browser launch: opened http://127.0.0.1:5510/index.html`
 
 ## Primary Alfa Codex Command
 
@@ -25,6 +26,7 @@ Expected diagnostics:
 - `Role: codex`
 - `Web URL: http://127.0.0.1:5512`
 - `API URL: http://127.0.0.1:5513/api`
+- `Browser launch: suppressed for codex role`
 
 ## Legacy Command
 

dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_report.md

@@ -28,6 +28,8 @@ Per OWNER instruction, those uncommitted changes were discarded with `git reset
 - Added `dev/scripts/team-port-config.mjs` for full team name and role-aware port resolution.
 - Added `dev/scripts/start-dev.mjs` as the bootstrap orchestrator.
 - Added focused node tests for team resolution, role offsets, invalid team/role validation, script wiring, `.env` loading behavior, and bootstrap diagnostics.
+- Added automatic browser launch for owner-role `dev:bootstrap` after the API and web servers are both ready.
+- Suppressed automatic browser launch for the `codex` role.
 
 ## Supported Teams
 
@@ -87,6 +89,14 @@ Codex role example:
 npm run dev:bootstrap -- --team alfa --role codex
 ```
 
+## Browser Launch Behavior
+
+- `owner` role launches the browser automatically to the selected team's `index.html`.
+- `codex` role suppresses browser launch.
+- Browser launch happens only after both API and web servers are ready.
+- The Alfa owner launch target is `http://127.0.0.1:5510/index.html`.
+- The Alfa codex launch target is suppressed while using web `5512` and API `5513`.
+
 ## Files Changed
 
 - `package.json` - updated

dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_requirement-checklist.md

@@ -21,5 +21,8 @@
 | Start Local API | PASS | `dev:bootstrap` starts the existing Local API server on resolved API port. |
 | Start web server when requested | PASS | `dev:bootstrap` starts web plus API; `dev:web` mode is wired. |
 | Print startup diagnostics | PASS | Diagnostics include mode, team, role, web URL, API URL, environment source, supported teams, and supported roles. |
+| Owner role launches browser automatically | PASS | Live startup validation opened `http://127.0.0.1:5510/index.html` after API and web were ready. |
+| Codex role suppresses browser launch | PASS | Live startup validation reported `Browser launch: suppressed for codex role`. |
+| Wait for both servers before browser launch | PASS | Targeted unit test asserts API ready, web ready, then browser launch order. |
 | Preserve legacy behavior | PASS | `dev:local-api` command unchanged and startup validation passed. |
 | No unrelated cleanup | PASS | Scope limited to package scripts, new dev scripts, targeted tests, and reports. |

dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_validation-report.md

@@ -8,15 +8,15 @@
 | `node --check dev/scripts/start-dev.mjs` | PASS | Syntax valid. |
 | `node --check dev/scripts/start-local-api-server.mjs` | PASS | Legacy startup entrypoint remains valid. |
 | `node --check dev/tests/dev-runtime/TeamAwareBootstrap.test.mjs` | PASS | Test syntax valid. |
-| `node ./dev/scripts/run-node-test-files.mjs dev/tests/dev-runtime/TeamAwareBootstrap.test.mjs dev/tests/dev-runtime/LocalApiStartupLogging.test.mjs` | PASS | 2 targeted files passed; 10 subtests passed. |
+| `node ./dev/scripts/run-node-test-files.mjs dev/tests/dev-runtime/TeamAwareBootstrap.test.mjs dev/tests/dev-runtime/LocalApiStartupLogging.test.mjs` | PASS | 2 targeted files passed; 14 subtests passed. |
 | Unsupported team token scan in new bootstrap files | PASS | No unsupported old team names or single-letter public team commands found. |
 | `npm run validate:canonical-structure` | PASS | Canonical repository structure guardrail passed. |
-| `npm run dev:bootstrap -- --team alfa` | PASS | Started with team `alfa`, role `owner`, web `5510`, API `5511`, then process tree was stopped. |
-| `npm run dev:bootstrap -- --team alfa --role codex` | PASS | Started with team `alfa`, role `codex`, web `5512`, API `5513`, then process tree was stopped. |
+| `npm run dev:bootstrap -- --team alfa` | PASS | Started with team `alfa`, role `owner`, web `5510`, API `5511`, launched browser to `http://127.0.0.1:5510/index.html`, then process tree was stopped. |
+| `npm run dev:bootstrap -- --team alfa --role codex` | PASS | Started with team `alfa`, role `codex`, web `5512`, API `5513`, suppressed browser launch, then process tree was stopped. |
 | `npm run dev:bootstrap -- --team omega` | PASS | Failed clearly with supported team list. |
 | `npm run dev:bootstrap -- --team alfa --role reviewer` | PASS | Failed clearly with supported role list. |
 | `npm run dev:local-api` | PASS | Legacy command started and printed legacy startup diagnostics, then process tree was stopped. |
 
 ## Notes
 
-The startup-command validations used short-lived process launches and `taskkill /T /F` cleanup after expected diagnostics appeared, so no dev servers were left running.
+The startup-command validations used short-lived process launches and `taskkill /T /F` cleanup after expected diagnostics appeared, so no dev servers were left running. The owner-role validation opened the configured browser target after both server diagnostics were available.

dev/reports/codex_changed_files.txt

@@ -1,24 +1,19 @@
 # git status --short
-M package.json
-?? dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_branch-validation.md
-?? dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_manual-validation-notes.md
-?? dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_report.md
-?? dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_requirement-checklist.md
-?? dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_validation-report.md
-?? dev/scripts/start-dev.mjs
-?? dev/scripts/team-port-config.mjs
-?? dev/tests/dev-runtime/TeamAwareBootstrap.test.mjs
+M dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_manual-validation-notes.md
+ M dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_report.md
+ M dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_requirement-checklist.md
+ M dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_validation-report.md
+ M dev/scripts/start-dev.mjs
+ M dev/tests/dev-runtime/TeamAwareBootstrap.test.mjs
 
 # git ls-files --others --exclude-standard
-dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_branch-validation.md
-dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_manual-validation-notes.md
-dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_report.md
-dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_requirement-checklist.md
-dev/reports/PR_26171_ALFA_009-team-aware-bootstrap_validation-report.md
-dev/scripts/start-dev.mjs
-dev/scripts/team-port-config.mjs
-dev/tests/dev-runtime/TeamAwareBootstrap.test.mjs
+(no output)
 
 # git diff --stat
-package.json | 3 +++
- 1 file changed, 3 insertions(+)
+...team-aware-bootstrap_manual-validation-notes.md |   2 +
+ ...R_26171_ALFA_009-team-aware-bootstrap_report.md |  10 ++
+ ...9-team-aware-bootstrap_requirement-checklist.md |   3 +
+ ...A_009-team-aware-bootstrap_validation-report.md |   8 +-
+ dev/scripts/start-dev.mjs                          |  76 +++++++++++--
+ dev/tests/dev-runtime/TeamAwareBootstrap.test.mjs  | 119 +++++++++++++++++++++
+ 6 files changed, 208 insertions(+), 10 deletions(-)