Sergey Chernyshev

This commit **significantly simplifies and automates the local development environment setup** for the `telescopetest-io` project, representing a key **maintenance and developer experience improvement**. It introduces a **new `dev-setup.sh` script** and associated `npm run dev:setup` command, which now handles automated database, R2 bucket, and type generation, alongside a new `npm run dev:clean` script for environment cleanup. The **`README.md` documentation** has been thoroughly updated and re-arranged to reflect these streamlined processes, providing clearer instructions and enhancing **developer onboarding and productivity**.

This commit performs a **workflow optimization** by **excluding the `telescopetest-io` directory** from triggering the main **CI/CD test workflow**. Changes made solely within the `telescopetest-io` directory will no longer initiate GitHub Actions tests for push and pull request events, as configured in `.github/workflows/test.yml`. This **maintenance chore** aims to **reduce unnecessary CI runs**, thereby improving the efficiency of the development feedback loop and conserving CI resources.

This commit **introduces** the **Telescope Browser Agent** as the **default opencode agent** for the project. It includes a new Markdown document, `.opencode/agents/telescope.md`, providing an overview, project structure, and operational guidelines for this agent. Additionally, a new `opencode.json` configuration file is added, which designates 'telescope' as the default agent and specifies its permissions for various bash commands and operations. This **feature addition** establishes the foundational setup for agent interaction within the project, defining its initial capabilities and security context.

This commit introduces **configurable browser selection and headless mode** through environment variables, enhancing flexibility for test execution. It implements parsing for `BROWSERS` and `HEADLESS` environment variables within the **browser execution logic** in `src/browsers.ts`, including special handling for **CI environments**. New tests in `__tests__/envVars.test.ts` verify the correct interaction and parsing of these variables. This **new capability** allows users to easily control which browsers are used and whether they run headlessly, with updated `README.md` documentation reflecting these **new configuration options** for improved developer experience, especially in automated pipelines.

This commit introduces a **new capability** to **delay network requests** during execution, enhancing control over network conditions for testing or scraping. It implements request delaying using Playwright's `page.route()` mechanism, specifically through new functions like `delayUsingFulfill` and `delayUsingContinue` within the **network handling module**. Users can configure this behavior via new **CLI options** `--delay` and `--delayUsing`, which are parsed in `src/config.ts` and integrated into the `testRunner.ts` execution flow. Extensive new tests in `__tests__/delay.test.ts` validate the functionality, supported by new test fixtures and a `retrieveResources` helper. The `README.md` is updated to document these additions, significantly expanding the tool's ability to simulate real-world network latencies.

This commit **updates the GitHub issue templates** to standardize how issue types are assigned. It **refactors** the `.github/ISSUE_TEMPLATE/bug-report.md` and `.github/ISSUE_TEMPLATE/feature_request.md` templates to utilize the dedicated `type` field instead of relying on labels. Specifically, bug reports will now be assigned `type: bug` and feature requests `type: feature`, enhancing the **automatic classification and organization of new issues**. This **maintenance** change improves the clarity and consistency of issue tracking within the project.

This commit introduces a **configuration update** to the **CI/CD deployment pipeline** for `telescopetest.io`. It modifies the **GitHub Actions workflow** defined in `.github/workflows/deploy.yml` to strictly limit its execution. The deployment job will now only run when triggered from the main `cloudflare/telescope` repository, preventing deployments from forks or other unauthorized sources. This **maintenance chore** enhances the security and control over the `telescopetest.io` deployment process by ensuring deployments originate from the intended source.

This commit **fixes a theme flicker issue** by implementing a **server-side rendering (SSR)** approach for theme application. It **refactors** the **theme toggling mechanism** in the **`TopNav` component** to persist user preferences using **cookies** and a `data-theme-override` attribute. The **global `Layout` component** now reads this cookie server-side to apply the theme directly to the `<html>` tag, ensuring a consistent theme on initial page load. This change, facilitated by enabling `output: 'server'` in `astro.config.mjs`, eliminates the visual flicker and provides a smoother user experience.

This commit performs a significant **refactoring and optimization of the homepage's visual effects and navigation** within `index.astro`. It **migrates JavaScript-based smooth scrolling and back-to-top functionality to more performant CSS implementations**, while also **improving accessibility** by adding comprehensive reduced motion support and `aria` labels. The commit **reworks the background stars and mouse-trail sparkles** (`createStars`, `createSparkle`) and **removes several inefficient animations** such as shooting stars, text pulse, and hero parallax. This results in a **smoother, more performant, and accessible user experience** on the homepage.

This commit introduces a **new capability** by implementing parsing for the **`--blockDomains` CLI option**, enabling users to specify and block unwanted domains during performance tests. The **CLI configuration** in `lib/config.js` now handles this option similarly to `--block`, and the **request blocking subsystem** in `lib/testRunner.js` is updated to effectively apply these domain blocks. Concurrently, the **test suite has been significantly refactored** to enhance maintainability and coverage, including the introduction of new test helpers in `__tests__/helpers.js` and dedicated tests for parameter parsing in `__tests__/params.test.js`. This ensures robust handling of CLI options and improves the overall reliability of the testing framework.

This commit introduces a **new `--dry` run option** to the **CLI**, enabling users to validate their **test configurations** and perform cleanup without executing the full test suite. This **enhancement** primarily impacts the **test execution workflow** and **configuration management**, with `index.js` implementing the core dry-run logic and `lib/config.js` integrating the option into the normalized CLI configuration. The change also includes **refactoring** in `lib/testRunner.js` to encapsulate configuration saving, improving modularity. **CLI tests** in `__tests__/cli.test.js` are updated to cover this new functionality, and the `README.md` is synchronized to document the option. This allows for safer and more efficient validation of test setups.

This commit introduces a new **npm script**, `test:ci`, to the project's `package.json`. This **maintenance** change enhances the **developer workflow** by providing a standardized way to run tests locally with environment variables configured to mimic a **Continuous Integration (CI)** environment. The new script ensures that developers can more accurately replicate and debug CI test failures, improving the reliability of local testing and reducing integration issues.

This commit primarily **refactors** the **`processors` module's EJS templates** to enhance compatibility with **Prettier formatting**. It **inlines the `_head.ejs` and `_footer.ejs` partials** directly into `processors/templates/index.ejs`, eliminating the use of nested partials that previously caused formatting issues. Additionally, minor **style adjustments** were applied to `processors/templates/partials/_console.ejs` and `processors/templates/partials/_metrics.ejs` for improved readability. This **maintenance** work ensures more consistent and automatically formatted template code within the `processors` subsystem, streamlining future development and code hygiene.

This commit **establishes a new CI pipeline using GitHub Actions** to automate project testing with Playwright. It **configures the `.github/workflows/test.yml` workflow** to run tests in a Playwright container, installing dependencies like `xz-utils` and `FFmpeg`, and handling browser setup and caching. **Test suites are updated** across `__tests__/*.test.js` to improve CI compatibility, notably by **removing image and video discrepancies** in `artifacts.test.js` and ensuring comprehensive browser iteration. Additionally, **browser configuration in `lib/browsers.js` is adjusted** for headless mode and CI-specific filtering, significantly **enhancing project reliability** through continuous, automated validation.

This commit performs a **cleanup** operation by **removing several files** that are no longer referenced or required by the project. This **maintenance task** improves **repository hygiene** and reduces unnecessary clutter within the codebase. By eliminating these unused assets, the commit contributes to a leaner project structure, potentially leading to minor improvements in build performance and overall developer experience.

This commit signifies the **transition of the project repository to a public domain**, making its source code and development history openly accessible. This major **infrastructure change** affects the entire project's visibility and distribution, moving it from a private development environment. The primary impact is to broaden the project's reach, enabling external users to view, clone, and potentially contribute to the codebase. This action establishes the project as a **publicly available resource** for the community.

This commit primarily **refactors** the project by **renaming the command-line interface (CLI)** from `browser-agent` to `telescope`. This **branding update** affects the core **CLI configuration** as reflected in `index.js`, where the tool's identifier was updated. Consequently, users will now interact with the application by invoking the new `telescope` command. A minor `.bleep` file update was also included to maintain build consistency.

This commit primarily **fixes** a bug in the **configuration parsing** for `cpuThrottle` by switching from `parseInt` to `parseFloat` in `lib/config.js`, ensuring accurate decimal values are handled for browser settings. This core **bug fix** enables subsequent **refactorings** across `lib/browsers.js`, `lib/chromeRunner.js`, and `lib/testRunner.js` to remove redundant parsing logic, streamlining **browser configuration** and **test setup**. The `executeTest` function in `index.js` is also refactored for earlier configuration normalization, improving the overall **test execution logic**. Furthermore, the **testing infrastructure** is updated to **un-parallelize Jest tests** by adding `--maxWorkers=1` to `package.json`, which may improve test stability or debugging. This comprehensive update enhances both the robustness of **configuration handling** and the reliability of the **test suite**.

This commit provides a **bug fix** addressing **redundant JSON parsing** and **incorrect option normalization** across several core modules. It specifically prevents options like `auth`, `headers`, and `cookies` from being parsed multiple times within **`TestRunner`** methods and when handling Firefox user preferences in **`BrowserConfig`**. Furthermore, the `normalizeConfig` function in `lib/config.js` is adjusted to correctly normalize the `auth` option, avoiding re-parsing if it's already an object. This ensures more robust and efficient configuration handling, preventing potential runtime errors or unexpected behavior caused by malformed or over-parsed options.

This commit **updates the `playwright-webkit` dependency** to its `next` version, signifying a move to the latest pre-release or cutting-edge build of the browser automation library. This **maintenance** task ensures the project benefits from the newest features, bug fixes, and performance improvements offered by `playwright-webkit`. The `package.json` file reflects this version bump, and the `.bleep` file is updated to maintain build system integrity. This change primarily impacts the **testing and browser automation infrastructure**, potentially introducing new WebKit capabilities or requiring adjustments to existing tests.