🛠️ Update various documentation, scripts, and configuration templates to enhance clarity, functionality, and maintainability across the project

docs/troubleshooting.md

@@ -15,6 +15,22 @@ Treat hot reload as likely but not guaranteed. If needed:
 - restart the Copilot CLI session
 - reopen VS Code
 
+## Session Start Hook Permission Denied
+
+If you see `/bin/sh: .../report-hook-event.sh: Permission denied` when a Copilot
+session starts:
+
+- Pull the latest repo changes and rerun `install/update.sh`.
+- If you need to refresh links and generated config without pulling, rerun
+	`install/bootstrap.sh`.
+- Run `install/verify.sh --quick` and resolve any missing managed files it
+	reports.
+- Start a new Copilot session and confirm
+	`~/.copilot-resources-state/hook-events.log` receives a new JSON line.
+
+The shared hook now invokes the shell script through `bash`, so the session
+start hook no longer depends on the script file itself being executable.
+
 ## Publish Refused To Overwrite
 
 The publish scripts stop on collisions by default. Use a new name or rerun with