feat: Dev(improve docs, backend error handling, frontend UX, and asset security)

[Shreyas-Microsoft]

Purpose

This pull request introduces several improvements across the documentation, backend, and frontend of the project. The most significant changes include the addition of a comprehensive local development guide, enhanced error handling in backend agent responses, improved frontend file upload feedback, and strengthened security for serving frontend assets.

Documentation Improvements:

• Added a detailed LocalSetupGuide.md with step-by-step instructions for setting up, running, debugging, and troubleshooting the solution locally, including Docker and VS Code Dev Container support.

Backend Robustness:

• Improved error handling in convert_script.py for both Picker and Semantic Verifier agents by catching invalid responses, logging errors, and providing fallback responses to prevent failures during agent execution. [1] [2]

Frontend User Experience:

• Enhanced the file upload UI in uploadButton.tsx to display a clear error message bar when any file upload fails, and only show the success message when all uploads are complete and error-free.
• Updated the file upload list to visually indicate errors by changing the color of the remove (X) button for files with upload errors.
• Minor UI adjustment to ensure proper positioning of file upload items.

Frontend Security:

• Improved static file serving logic in frontend_server.py to prevent directory traversal and dotfile access, ensuring only intended files are served and falling back to index.html for invalid paths.

Other:

• Minor whitespace adjustment for readability in frontend_server.py.

Does this introduce a breaking change?

• Yes
• No

Golden Path Validation

• I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

• I have validated the deployment process successfully and all services are running as expected with this change.

What to Check

Verify that the following are valid

• ...

Other Information

[github-actions]

🎉 This PR is included in version 1.5.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀