Judyzc

This commit introduces a **new configuration display and download functionality** for test results within the `telescopetest-io` project. It adds a **`ConfigTab` component** to the test results page, allowing users to view detailed test options and browser configurations. Concurrently, a **new API endpoint (`downloadZIP.ts`)** is implemented, enabling the download of all test artifacts as a ZIP archive, complete with content rating checks. This **new feature** required **expanding the `ConfigJson` interface** to mirror `SavedConfig` from the `telescope` project and **refactoring existing API logic** to utilize a new `contentRatingCache` utility, significantly enhancing the ability to analyze and share test outcomes.

This commit **upgrades the `telescopetest-io` project's opencode configurations** to align with **Astro v6** and current project status. It updates several **AI agent configurations** (`db`, `review`, `ttio`, `ui`) with new models, expanded guidelines, and comprehensive details on the Astro v6 stack, Prisma, and development workflows. Additionally, a new `opencode.json` file is introduced to define the project's schema and default AI agent. As a related **maintenance** task, the **deployment workflow** in `.github/workflows/deploy.yml` is modified to **prevent unnecessary triggers** when only these opencode configuration files change, streamlining the CI/CD process.

This commit **introduces a comprehensive Vitest test suite** across the `telescopetest-io` project, significantly enhancing code reliability and maintainability. It adds extensive **unit tests** for various **utility functions** including Core Web Vitals, metric extractors, formatters, ratings, resources, and security, alongside tests for npm scripts. Concurrently, it **refactors file path handling** by introducing a `toPosixPath` utility in `src/lib/utils/security.ts` and applying it to API routes (`src/pages/api/tests/[testId]/[...filename].ts`, `src/pages/api/upload.ts`) to ensure **cross-platform compatibility**. This work establishes a robust testing framework and improves the consistency and reliability of file operations, particularly for **security and upload functionalities**.

This commit **updates the documentation** for the **`telescopetest-io`** project, specifically modifying its `README.md` file. The change reflects an update in the recommended Node.js version from 20 to 24 within the deployment workflow description. This **documentation update** ensures that the project's deployment instructions are accurate for developers. Additionally, this **maintenance task** was performed to intentionally trigger the `deploy.yml` CI/CD workflow, verifying its functionality.

This commit introduces a **maintenance chore** to the project's **CI/CD deployment workflow**. It specifically adds the `CLOUDFLARE_API_TOKEN` environment variable to the 'build astro site' step defined in the `.github/workflows/deploy.yml` configuration. This crucial update provides the necessary authentication for the Astro site's build process to interact with Cloudflare, directly enabling and supporting successful **production environment deployments**. Without this token, the deployment pipeline would fail to properly publish the site to its production destination.

This commit introduces a **bug fix** to the **`telescopetest-io` API** that resolves **500 errors** encountered during per-asset `content_rating` checks. It implements a **cached content rating check** within the `GET` handler of `/api/tests/[testId]/[...filename].ts` to prevent these errors and improve response times. Additionally, the change **optimizes R2 bucket access** by ensuring the Cloudflare cache is opened efficiently for both reads and writes, and by logging fetch durations and errors for better observability. This enhancement significantly improves the **stability and performance** of asset retrieval by preventing server errors and leveraging caching.

This commit **introduces a navigation bar to the home page** of the `telescopetest-io` application, significantly **enhancing user navigation**. It **refactors the `TopNav` component** (`telescopetest-io/src/components/TopNav.astro`) to be fixed at the top of the viewport and adds a `hideThemeSwitcher` prop for greater display control. To accommodate this change, the `Page` layout's (`telescopetest-io/src/layouts/Page.astro`) top padding is adjusted, ensuring proper content display. This **new feature** provides a consistent and accessible navigation experience on the main landing page (`telescopetest-io/src/pages/index.astro`).

This commit implements a **critical security fix** to prevent **Cross-Site Scripting (XSS) vulnerabilities** within the `telescopetest-io` application. It introduces **strict allowlisting and filtering** on the `upload.ts` API to ensure only expected Telescope output files are processed from ZIP archives and validates URLs in `config.json`. Furthermore, the `[testId]/[...filename].ts` endpoint now **validates file serving requests**, adds security headers, and forces downloads for non-media files to prevent direct execution of potentially malicious content. The `TestInfoPanel.astro` component also receives a **fix** to sanitize displayed URLs, ensuring only `http:` or `https:` protocols are rendered, thereby comprehensively mitigating XSS risks from arbitrary ZIP uploads and malicious URL injection.

This commit implements a **new feature** by introducing an initial **Filmstrip & Video tab** on the **test results page**, significantly enhancing **visual debugging** for test runs. It integrates a new `FilmstripVideo.astro` component to display visual progress frames and a video recording. To enable this, the **API route** `src/pages/api/tests/[testId]/[...filename].ts` was updated to support nested file paths and serve `.webm` video files, ensuring proper **media serving**. This provides users with a comprehensive visual overview of test execution, alongside minor documentation updates.

This commit **fixes a bug** in the **`telescopetest-io` service** related to **manual ZIP uploads**. It introduces **path normalization** within the `POST` handler of the `/api/upload` endpoint, utilizing a new `normalizeZipFilePaths` function. This ensures that `config.json` and other critical files are correctly located and processed, even when they are nested within directories inside the uploaded ZIP archive. The change resolves issues where uploads would fail due to incorrect file path resolution, significantly improving the robustness of the **upload functionality**.

This commit **fixes a security vulnerability** within `telescopetest-io` by preventing 'UNSAFE' rated content from being exposed or displayed. It introduces a critical content rating check to the **`GET` API route** (`/api/tests/[testId]/[filename]`), effectively blocking the serving of files associated with unsafe tests. Concurrently, the **test results page** (`/results/[testId].astro`) is modified to conditionally render content, ensuring that unsafe or unknown materials are not fully presented in the user interface. This **enhances content moderation** and user safety by restricting access to inappropriate materials across the platform.

This commit introduces a **new capability** by adding a dedicated **Bottlenecks tab** to the `results/[testId].astro` page, providing users with a comprehensive view of performance bottlenecks. This feature integrates a new `Bottlenecks` component, which displays top files, longest requests, blocking resources, and distribution charts, leveraging new data processing utilities in `chartData.ts` and a new `PieChart` component. The work significantly enhances the application's **diagnostic features** by allowing users to identify and understand performance issues more effectively. Related **refactoring** in `Waterfall.astro` and `Layout.astro` centralizes chart styling with a consistent color palette.

This commit **implements initial AI content filtering** for the platform, introducing a new capability to automatically assess the safety of uploaded content. It integrates **Llama-Guard and Llama-3.2-11b-vision-instruct** into a new `ai-content-rater` module to analyze text and screenshots. The **database schema** is updated with a `content_rating` field, and the **test upload API** now triggers AI analysis, while **UI components** like `TestCard` and results pages display content ratings and filter unsafe items. This **feature implementation** significantly enhances content moderation by flagging potentially unsafe tests and providing visual cues to users.

This commit significantly **enhances the metrics tab display** by introducing a **detailed interactive navigation timing diagram** and integrating **Core Web Vitals (LCP and CLS)** reporting. It involves a major **feature enhancement** to the **`AllMetrics` component**, which now leverages new utility functions (`firstRequest.ts`, `pageLoad.ts`, `navTiming.ts`) to build comprehensive performance visualizations. Additionally, existing metric extraction utilities (`extractors.ts`) and the **results page** (`results/[testId].astro`) have been **refactored** to support these new capabilities and improve overall code structure. This work provides users with richer and more accurate performance insights, alongside general **code cleanup** and **documentation updates**.

This commit introduces a **new feature** to the `telescopetest-io` application by adding a **Console tab** to the **test results page**. It provides a dedicated `Console.astro` component for displaying and filtering console messages, supported by new TypeScript interfaces (`ConsoleLocation`, `ConsoleMessage`) for structured data. The generic `Tabs.astro` component is updated to include this new tab, and the `results/[testId].astro` page now integrates the `Console` component, fetching relevant messages from the results bucket. This enhancement allows users to easily view and analyze console output directly alongside other test results, significantly improving the **test result analysis workflow**.

This commit performs **maintenance** by **removing** the `opencode.jsonc` configuration file from the project. This action streamlines the **project configuration** by eliminating an unused or deprecated metadata file. The change simplifies the repository structure and ensures that only relevant configuration assets are maintained, with no direct impact on runtime functionality.

This commit introduces a **new capability** to the **Telescopetest-io results page**, providing a dedicated **Resources tab** for in-depth web performance resource timing analysis. Users can now view summary statistics, a breakdown by resource type, and a detailed table of all loaded resources, significantly enhancing diagnostic capabilities. This involved creating the new `Resources.astro` component, integrating it via `Tabs.astro`, and developing extensive utility functions in `utils/resources.ts` along with new TypeScript types in `types/resources.ts` to process and display this data. Minor **refactoring** was also performed to update import paths for existing metric utility functions.

This commit primarily focuses on **documentation improvement** and **developer experience enhancements** for the `telescopetest-io` project. It **clarifies Prisma setup instructions** and **reorders database migration steps** within the `README.md` to provide a more coherent guide, specifically adding a note for **Windows users**. Concurrently, a **new utility script**, `migrate:local`, is added to `package.json` to simplify the process of applying **local database migrations**. This work collectively **streamlines project setup** and **local development workflows**, making the project more accessible and easier to manage for developers.

This commit introduces a **new capability** to the **Telescopetest-io application** by adding an interactive **waterfall chart** for visualizing network request timings. A new `Waterfall.astro` component is integrated into the `Tabs.astro` component and the **test results page** (`results/[testId].astro`), enabling users to analyze HAR data directly. This **feature addition** includes comprehensive **HAR 1.2 specification TypeScript interfaces** in `src/lib/types/har.ts` and a suite of new utility functions in `src/lib/waterfall/` for data processing, formatting, and DOM manipulation. The work significantly enhances the **performance analysis features** by providing a detailed visual breakdown of network activity, improving debugging and optimization workflows.

This commit introduces a **major new capability** to the **`telescopetest-io` results page**, enabling comprehensive visualization of performance metrics from `metrics.json` data. It adds numerous **Astro components** for displaying a summary and detailed views of metrics like Largest Contentful Paint, Layout Shifts, Navigation Timing, Paint Timing, and User Timing, accessible via **tabbed navigation**. Additionally, it includes a **bug fix** for the `extractTtfb` function in `lib/metrics/extractors.ts` to ensure accurate Time to First Byte calculation, alongside new utility functions for metric formatting and updated TypeScript interfaces for metric data. This significantly enhances the analytical depth available for test results by providing detailed performance insights directly on the page.