Copy approved GameFoundryStudio assets tree for root migration stability - PR_26152_044-root-gamefoundrystudio-assets-copy & Recover root migration path loading for GameFoundryStudio pages - PR_26152_045-root-migration-path-recovery

Author: ToolboxAid

docs/dev/reports/root_migration_path_recovery_validation.md

@@ -0,0 +1,75 @@
+# PR_26152_045 Root Migration Path Recovery Validation
+
+## Scope
+
+- Treated the current uncommitted root migration path state as broken and recovered it.
+- Limited work to root-migrated GameFoundryStudio pages and path references.
+- Restored migrated pages to the confirmed working `GameFoundryStudio/assets/**` loading path.
+- Preserved root `/tools/index.html` and root `/tools/ai-assistant.html`.
+- Did not add CSS.
+- Did not change Theme V2 CSS.
+- Did not redesign pages.
+- Did not migrate additional pages.
+- Did not change tool runtime behavior.
+- Did not change HTML classes or IDs.
+
+## Recovery Result
+
+- Root top-level pages use:
+  - `<base href="GameFoundryStudio/">`
+- Root Admin and Tools pages use:
+  - `<base href="../GameFoundryStudio/">`
+- Migrated pages load:
+  - `assets/css/theme/v2/theme.css`
+  - `assets/js/gamefoundry-partials.js`
+- `/tools/ai-assistant.html` also loads:
+  - `assets/js/tool-display-mode.js`
+- `/tools/index.html` also loads:
+  - `assets/js/tools-page-accordions.js`
+- `/index.html` direct Tools links point to root `/tools/index.html` using `../tools/index.html`.
+- `/tools/index.html` AI Assistant link points to root `/tools/ai-assistant.html` using `../tools/ai-assistant.html`.
+- Unmigrated tools/pages continue resolving under the existing `GameFoundryStudio/` tree.
+
+## Changed Files
+
+- `index.html`
+- `docs/dev/commit_comment.txt`
+- `docs/dev/reports/codex_changed_files.txt`
+- `docs/dev/reports/codex_review.diff`
+- `docs/dev/reports/root_migration_path_recovery_validation.md`
+
+## Validation Commands
+
+- PASS: `node --check GameFoundryStudio/assets/js/gamefoundry-partials.js; node --check GameFoundryStudio/assets/js/tools-page-accordions.js; node --check GameFoundryStudio/assets/js/tool-display-mode.js`
+  - Shared navigation, Tools index renderer, and Tool Display Mode scripts are syntactically valid.
+- PASS: `rg -n "<base href=\"GameFoundryStudio/\"|<base href=\"\.\./GameFoundryStudio/\"|assets/css/theme/v2/theme\.css|assets/js/gamefoundry-partials\.js" index.html about.html vision.html mission.html roadmap.html release-notes.html account.html profile.html preferences.html security.html admin tools/index.html tools/ai-assistant.html -g "*.html"`
+  - Migrated pages use the recovered base path pattern and load Theme V2/shared partial JS.
+- PASS: `rg -n --pcre2 "<script(?![^>]*\bsrc=)|<style|\son[a-z]+\s*=" index.html about.html vision.html mission.html roadmap.html release-notes.html account.html profile.html preferences.html security.html admin tools/index.html tools/ai-assistant.html -g "*.html"`
+  - No inline script blocks, style blocks, or inline event handlers found.
+- PASS: `rg -n "href: \"\.\./tools/ai-assistant\.html\"|render\(\"ascending\"\)|getGroupedTools|createAccordion|tools\.sort|tools\.reverse|control-card \$\{groupClass\(tool\.group\)\}|assets/images/tools|assets/images/badges|brand-color-swatch" GameFoundryStudio/assets/js/tools-page-accordions.js`
+  - `/tools/index.html` preserves AI Assistant root link, sorting, grouping, images, data, badges, and group-colored outline hooks.
+- PASS: `rg -n "\.\./tools/index\.html|tools/index\.html|admin/branding\.html|arcade/index\.html" index.html`
+  - Root Home navigation preserves root Tools links and existing product/admin links.
+
+## Blocked Root Assets Copy
+
+The requested root `assets/**` copy could not be completed. The following commands were attempted and blocked before process startup:
+
+- Node `fs.cpSync`
+- PowerShell `Copy-Item`
+- `robocopy`
+
+Error:
+
+```text
+windows sandbox: spawn setup refresh
+```
+
+Because the physical root asset copy could not be completed, this recovery restores the migrated pages to load from the existing approved `GameFoundryStudio/assets/**` tree so pages are not left broken.
+
+## Skipped
+
+- Repo-wide tests were not run by request.
+- Tests outside root-migrated GameFoundryStudio pages were not run by request.
+- Full samples smoke test was not run by request.
+- Browser/page-load automation was not run because the requested recovery was validated through targeted static and syntax checks only.