Fix CI: Prettier formatting, macOS version accuracy, and stricter AGENTS.md

- Fix Prettier table formatting in BROKEN-LINKS-AND-REDIRECTS.md
- Add missing trailing newline in network-traffic-monitoring.md
- Correct "macOS 26" to "macOS Sequoia (15) and later" in faq.md
- Update AGENTS.md with strict pre-push quality gate and knip check

Author: AvdLee

docs/AGENTS.md

@@ -1,10 +1,18 @@
 # Docs Agent Guidelines
 
-## After Making Changes
+## After Making Changes — Required Quality Gate
 
-Always run these checks from the `docs/` directory after modifying files:
+CI will **reject** the PR if any of the checks below fail. Always run every check from the `docs/` directory **before** committing and pushing:
 
-1. `npm run lint` - Verify ESLint passes
-2. `npm run format:check` - Verify Prettier formatting
-3. `npm run typecheck` - Verify TypeScript types
-4. `npm run build` - Verify production build succeeds
+```bash
+cd docs
+npm run lint          # ESLint
+npm run format:check  # Prettier (fix with: npx prettier --write .)
+npm run typecheck     # astro check (TypeScript)
+npm run build         # Production build
+npm run knip          # Unused files and dependencies
+```
+
+If `format:check` fails, run `npx prettier --write .` and commit the result.
+
+All five commands must exit with code 0 before you push.

docs/BROKEN-LINKS-AND-REDIRECTS.md

@@ -8,28 +8,28 @@ Analysis of all internal doc links and redirects after the docs restructure (com
 
 Every internal doc link was checked against existing files. **All current link targets have a corresponding page** in the repo.
 
-| Link target | Used in | File exists |
-|-------------|---------|-------------|
-| `/docs/docs/features/app-actions/app-directory-access` | user-defaults-editor.mdx | ✓ app-directory-access.md |
-| `/docs/features/capturing/simulator-camera-support` | setting-up-rocketsim-connect.md | ✓ |
-| `/docs/features/networking/network-traffic-monitoring` | setting-up-rocketsim-connect.md, network-speed-control.mdx, network-traffic-monitoring.md (Networking Insights), index.mdx | ✓ |
-| `/docs/features/networking/networking-insights` | network-traffic-monitoring.md | ✓ |
-| `/docs/getting-started/setting-up-rocketsim-connect` | network-traffic-monitoring.md, simulator-camera-support.md, networking-insights.md, index.mdx | ✓ |
-| `/docs/docs/features/capturing/app-store-connect-optimization` | recordings.md | ✓ |
-| `/docs/docs/features/capturing/touch-indicators` | recordings.md | ✓ |
-| `/docs/docs/features/capturing/floating-thumbnail` | recordings.md, app-store-connect-optimization.md | ✓ |
-| `/docs/docs/features/build-insights/team-build-insights` | build-insights.md | ✓ |
-| `/docs/docs/settings/side-window` | onboarding.md | ✓ |
-| `/docs/getting-started/onboarding` | index.mdx, PageTitle.astro | ✓ |
-| `/docs/getting-started/product-tour-and-quick-demos` | index.mdx, PageTitle.astro | ✓ |
-| `/docs/getting-started/how-large-teams-use-rocketsim` | index.mdx | ✓ |
-| `/docs/features/capturing/screenshots` | index.mdx | ✓ |
-| `/docs/features/design-comparison/comparing-designs` | index.mdx | ✓ |
-| `/docs/getting-started/configuring-app-actions` | index.mdx | ✓ |
-| `/docs/features/accessibility/toggles-and-dynamic-text` | index.mdx | ✓ |
-| `/docs/settings/side-window` | index.mdx | ✓ |
-| `/docs/support/faq` | index.mdx, menu.json | ✓ |
-| `/docs/support/reporting-an-issue` | index.mdx | ✓ |
+| Link target                                                    | Used in                                                                                                                    | File exists               |
+| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| `/docs/docs/features/app-actions/app-directory-access`         | user-defaults-editor.mdx                                                                                                   | ✓ app-directory-access.md |
+| `/docs/features/capturing/simulator-camera-support`            | setting-up-rocketsim-connect.md                                                                                            | ✓                         |
+| `/docs/features/networking/network-traffic-monitoring`         | setting-up-rocketsim-connect.md, network-speed-control.mdx, network-traffic-monitoring.md (Networking Insights), index.mdx | ✓                         |
+| `/docs/features/networking/networking-insights`                | network-traffic-monitoring.md                                                                                              | ✓                         |
+| `/docs/getting-started/setting-up-rocketsim-connect`           | network-traffic-monitoring.md, simulator-camera-support.md, networking-insights.md, index.mdx                              | ✓                         |
+| `/docs/docs/features/capturing/app-store-connect-optimization` | recordings.md                                                                                                              | ✓                         |
+| `/docs/docs/features/capturing/touch-indicators`               | recordings.md                                                                                                              | ✓                         |
+| `/docs/docs/features/capturing/floating-thumbnail`             | recordings.md, app-store-connect-optimization.md                                                                           | ✓                         |
+| `/docs/docs/features/build-insights/team-build-insights`       | build-insights.md                                                                                                          | ✓                         |
+| `/docs/docs/settings/side-window`                              | onboarding.md                                                                                                              | ✓                         |
+| `/docs/getting-started/onboarding`                             | index.mdx, PageTitle.astro                                                                                                 | ✓                         |
+| `/docs/getting-started/product-tour-and-quick-demos`           | index.mdx, PageTitle.astro                                                                                                 | ✓                         |
+| `/docs/getting-started/how-large-teams-use-rocketsim`          | index.mdx                                                                                                                  | ✓                         |
+| `/docs/features/capturing/screenshots`                         | index.mdx                                                                                                                  | ✓                         |
+| `/docs/features/design-comparison/comparing-designs`           | index.mdx                                                                                                                  | ✓                         |
+| `/docs/getting-started/configuring-app-actions`                | index.mdx                                                                                                                  | ✓                         |
+| `/docs/features/accessibility/toggles-and-dynamic-text`        | index.mdx                                                                                                                  | ✓                         |
+| `/docs/settings/side-window`                                   | index.mdx                                                                                                                  | ✓                         |
+| `/docs/support/faq`                                            | index.mdx, menu.json                                                                                                       | ✓                         |
+| `/docs/support/reporting-an-issue`                             | index.mdx                                                                                                                  | ✓                         |
 
 **Conclusion:** No broken internal links remain. The fixes applied earlier (index.mdx + simulator-camera-support.md) resolved all invalid targets.
 
@@ -48,22 +48,22 @@ If the built site serves doc pages under **/docs/docs/...**, then links that use
 
 Redirects cover both possible old URL styles (single and double `docs`) so bookmarks and external links keep working.
 
-| From | To |
-|------|----|
-| `/docs/features/rocketsim-connect/introduction-and-setup` | `/docs/getting-started/setting-up-rocketsim-connect` |
-| `/docs/features/rocketsim-connect/network-traffic-monitoring` | `/docs/features/networking/network-traffic-monitoring` |
-| `/docs/appearance/side-window` | `/docs/settings/side-window` |
-| `/docs/appearance/shortcuts` | `/docs/settings/shortcuts` |
-| `/docs/features/app-actions/general-app-actions` | `/docs/getting-started/configuring-app-actions` |
-| `/docs/features/app-actions/build-insights` | `/docs/features/build-insights/build-insights` |
-| `/docs/features/app-actions/network-speed-control-and-simulator-airplane-mode` | `/docs/features/networking/network-speed-control` |
-| `/docs/docs/features/rocketsim-connect/introduction-and-setup` | `/docs/getting-started/setting-up-rocketsim-connect` |
-| `/docs/docs/features/rocketsim-connect/network-traffic-monitoring` | `/docs/features/networking/network-traffic-monitoring` |
-| `/docs/docs/appearance/side-window` | `/docs/settings/side-window` |
-| `/docs/docs/appearance/shortcuts` | `/docs/settings/shortcuts` |
-| `/docs/docs/features/app-actions/general-app-actions` | `/docs/getting-started/configuring-app-actions` |
-| `/docs/docs/features/app-actions/build-insights` | `/docs/features/build-insights/build-insights` |
-| `/docs/docs/features/app-actions/network-speed-control-and-simulator-airplane-mode` | `/docs/features/networking/network-speed-control` |
+| From                                                                                | To                                                     |
+| ----------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `/docs/features/rocketsim-connect/introduction-and-setup`                           | `/docs/getting-started/setting-up-rocketsim-connect`   |
+| `/docs/features/rocketsim-connect/network-traffic-monitoring`                       | `/docs/features/networking/network-traffic-monitoring` |
+| `/docs/appearance/side-window`                                                      | `/docs/settings/side-window`                           |
+| `/docs/appearance/shortcuts`                                                        | `/docs/settings/shortcuts`                             |
+| `/docs/features/app-actions/general-app-actions`                                    | `/docs/getting-started/configuring-app-actions`        |
+| `/docs/features/app-actions/build-insights`                                         | `/docs/features/build-insights/build-insights`         |
+| `/docs/features/app-actions/network-speed-control-and-simulator-airplane-mode`      | `/docs/features/networking/network-speed-control`      |
+| `/docs/docs/features/rocketsim-connect/introduction-and-setup`                      | `/docs/getting-started/setting-up-rocketsim-connect`   |
+| `/docs/docs/features/rocketsim-connect/network-traffic-monitoring`                  | `/docs/features/networking/network-traffic-monitoring` |
+| `/docs/docs/appearance/side-window`                                                 | `/docs/settings/side-window`                           |
+| `/docs/docs/appearance/shortcuts`                                                   | `/docs/settings/shortcuts`                             |
+| `/docs/docs/features/app-actions/general-app-actions`                               | `/docs/getting-started/configuring-app-actions`        |
+| `/docs/docs/features/app-actions/build-insights`                                    | `/docs/features/build-insights/build-insights`         |
+| `/docs/docs/features/app-actions/network-speed-control-and-simulator-airplane-mode` | `/docs/features/networking/network-speed-control`      |
 
 If the live site uses **/docs/docs/...** for docs, update the **To** column (and `astro.config.ts`) to use that pattern (e.g. `/docs/docs/getting-started/setting-up-rocketsim-connect`).
 

docs/src/content/docs/docs/features/networking/network-traffic-monitoring.md

@@ -41,4 +41,4 @@ Basically, yes! However, RocketSim does not yet allow configuring breakpoints or
 
 ## Powered by open-sourced framework Pulse
 
-Network monitoring is made possible by [Pulse](https://github.com/kean/Pulse), an open-sourced library developed by [Alex Grebenyuk](https://github.com/kean). For a more advanced Network Logger that includes powerful mocking capabilities, advanced filtering, and more — check out [Pulse Pro](https://pulselogger.com/).
+Network monitoring is made possible by [Pulse](https://github.com/kean/Pulse), an open-sourced library developed by [Alex Grebenyuk](https://github.com/kean). For a more advanced Network Logger that includes powerful mocking capabilities, advanced filtering, and more — check out [Pulse Pro](https://pulselogger.com/).

docs/src/content/docs/docs/support/faq.md

@@ -65,7 +65,7 @@ This is usually caused by missing system permissions.
 
 2. Open **System Settings → Privacy & Security** and approve any pending **RocketSim** permissions.
 3. Open System Settings → Network → Filter and verify whether RocketSim is present & enabled
-4. On **macOS 26**, enable the Network Extension:
+4. On **macOS Sequoia (15) and later**, enable the Network Extension:
    - **System Settings → General → Login Items & Extensions**
    - Find **RocketSim**, click **(i)**, and enable **Network Extension**
      You may need to approve permissions more than once.