chore(gradle): fix codeql for java

Updating Nx from 21.5.0-beta.1 to 21.5.0-beta.2

.cargo/config.toml

@@ -1,5 +1,5 @@
 [build]
-target-dir = 'build/target'
+target-dir = 'dist/target'
 
 [target.x86_64-unknown-linux-musl]
 rustflags = [

.claude/commands/commit.md

@@ -0,0 +1,47 @@
+# Commit Command
+
+## Description
+
+Create a git commit following Nx repository standards and validation requirements.
+
+## Usage
+
+```bash
+/commit [message]
+```
+
+## What this command does:
+
+1. **Pre-commit validation**: Runs the full validation suite (`pnpm nx prepush`) to ensure code quality
+2. **Formatting**: Automatically formats changed files with Prettier
+3. **Testing**: Runs tests on affected projects to validate changes
+4. **Commit creation**: Creates a well-formed commit with proper message formatting (without co-author attribution)
+5. **Status reporting**: Provides clear feedback on the commit process
+
+## Workflow:
+
+1. Format any modified files with Prettier
+2. Run the prepush validation suite
+3. If validation passes, stage relevant changes
+4. Create commit with descriptive message
+5. Provide summary of what was committed
+
+## Commit Message Format:
+
+- Use conventional commit format when appropriate
+- Include scope (e.g., `feat(core):`, `fix(angular):`, `docs(nx):`)
+- Keep first line under 72 characters
+- Include detailed description if needed
+
+## Examples:
+
+- `/commit "feat(core): add new project graph visualization"`
+- `/commit "fix(react): resolve build issues with webpack config"`
+- `/commit "docs(nx): update getting started guide"`
+
+## Validation Requirements:
+
+- All tests must pass
+- Code must be properly formatted
+- No linting errors
+- E2E tests for affected areas should pass

.claude/commands/gh-issue-plan.md

@@ -0,0 +1,155 @@
+# GitHub Issue Planning and Resolution
+
+This command provides guidance for both automated and manual GitHub issue workflows.
+
+## Automated Workflow (GitHub Actions)
+
+The automated workflow consists of two phases:
+
+### Phase 1: Planning (`@claude plan` or `claude:plan` label)
+
+- Claude analyzes the issue and creates a detailed implementation plan
+- Plan is posted as a comment on the issue
+- Issue is labeled with `claude:planned`
+
+### Phase 2: Implementation (`@claude implement` or `claude:implement` label)
+
+- Claude implements the solution based on the plan
+- Runs validation tests and creates a feature branch
+- Suggests opening a PR with proper formatting
+
+## Planning Phase Template
+
+When creating a plan (either automated or manual), include these sections:
+
+### Problem Analysis
+
+- Root cause identification
+- Impact assessment
+- Related components or systems affected
+
+### Proposed Solution
+
+- High-level approach
+- Alternative solutions considered
+- Trade-offs and rationale
+
+### Implementation Details
+
+- Files that need to be modified
+- Key changes required
+- Dependencies or prerequisites
+
+### Testing Strategy
+
+- Unit tests to add/modify
+- Integration tests needed
+- E2E test considerations
+
+### Validation Steps
+
+```bash
+# Test specific affected projects
+nx run-many -t test,build,lint -p PROJECT_NAME
+
+# Test all affected projects
+nx affected -t build,test,lint
+
+# Run affected e2e tests
+nx affected -t e2e-local
+
+# Format code
+npx nx prettier -- FILES
+
+# Final validation
+pnpm nx prepush
+```
+
+### Risks and Considerations
+
+- Breaking changes
+- Performance implications
+- Migration requirements
+
+## Manual Workflow
+
+When working on a GitHub issue manually, follow this systematic approach:
+
+## 1. Get Issue Details
+
+```bash
+# Get issue details using GitHub CLI (replace ISSUE_NUMBER with actual number)
+gh issue view ISSUE_NUMBER
+```
+
+When cloning reproduction repos, please clone within `./tmp/claude/repro-ISSUE_NUMBER`
+
+## 2. Analyze the Plan
+
+- Look for a plan or implementation details in the issue description
+- Check comments for additional context or clarification
+- Identify affected projects and components
+
+## 3. Implement the Solution
+
+- Follow the plan outlined in the issue
+- Make focused changes that address the specific problem
+- Ensure code follows existing patterns and conventions
+
+## 4. Run Full Validation
+
+```bash
+# Test specific affected projects first
+nx run-many -t test,build,lint -p PROJECT_NAME
+
+# Test all affected projects
+nx affected -t build,test,lint
+
+# Run affected e2e tests
+nx affected -t e2e-local
+
+# Final pre-push validation
+pnpm nx prepush
+```
+
+## 5. Submit Pull Request
+
+- Create a descriptive PR title that references the issue
+- Include "Fixes #ISSUE_NUMBER" in the PR description
+- Provide a clear summary of changes made
+- Request appropriate reviewers
+
+## Pull Request Template
+
+When creating a pull request, follow the template found in `.github/PULL_REQUEST_TEMPLATE.md`. The template includes:
+
+### Required Sections
+
+1. **Current Behavior**: Describe the behavior we have today
+2. **Expected Behavior**: Describe the behavior we should expect with the changes in this PR
+3. **Related Issue(s)**: Link the issue being fixed so it gets closed when the PR is merged
+
+### Template Format
+
+```markdown
+## Current Behavior
+
+<!-- This is the behavior we have today -->
+
+## Expected Behavior
+
+<!-- This is the behavior we should expect with the changes in this PR -->
+
+## Related Issue(s)
+
+<!-- Please link the issue being fixed so it gets closed when this is merged. -->
+
+Fixes #ISSUE_NUMBER
+```
+
+### Guidelines
+
+- Ensure your commit message follows the conventional commit format (use `pnpm commit`)
+- Read the submission guidelines in CONTRIBUTING.md before posting
+- For complex changes, you can request a dedicated Nx release by mentioning the Nx team
+- Always link the related issue using "Fixes #ISSUE_NUMBER" to automatically close it when merged

.claude/commands/issue-workflow-guide.md

@@ -0,0 +1,30 @@
+# Claude Issue Workflow Usage Guide
+
+## Quick Start
+
+## Expected Outputs
+
+### Planning Phase
+
+- Detailed analysis comment posted to issue
+- Implementation plan with steps and file changes
+- Testing strategy and validation steps
+- Risk assessment
+
+### Implementation Phase
+
+- Code changes made according to plan
+- Tests run and validated
+- Feature branch created: `fix/issue-{number}`
+- PR suggestion with proper title format
+
+## Manual Override
+
+If you need to work on an issue manually, use the `/gh-issue-plan` command for structured guidance following the same workflow patterns.
+
+## Troubleshooting
+
+- Ensure you're on the authorized users list
+- Check that the issue has sufficient detail for analysis
+- For implementation, ensure a plan comment exists from the planning phase
+- If workflows fail, check the Actions tab for detailed logs

.claude/settings.json

@@ -0,0 +1,34 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find:*)",
+      "Bash(ls:*)",
+      "Bash(mkdir:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:www.typescriptlang.org)",
+      "Bash(git log:*)",
+      "Bash(gh issue list:*)",
+      "Bash(gh issue view:*)",
+      "Bash(npx prettier:*)",
+      "Bash(nx prepush:*)",
+      "Bash(pnpm commit:*)",
+      "Bash(rg:*)",
+      "mcp__nx__nx_docs",
+      "mcp__nx__nx_workspace",
+      "mcp__nx__nx_project_details",
+      "Bash(nx show projects:*)",
+      "Bash(nx run-many:*)",
+      "Bash(nx run:*)",
+      "Bash(nx affected:*)",
+      "Bash(nx lint:*)",
+      "Bash(nx test:*)",
+      "Bash(nx build:*)",
+      "Bash(nx documentation:*)"
+    ],
+    "deny": []
+  },
+  "enableAllProjectMcpServers": true,
+  "env": {
+    "BASH_MAX_TIMEOUT_MS": "1800000"
+  }
+}

.cursor/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "nx-mcp": {
+      "command": "npx",
+      "args": ["-y", "nx-mcp@latest"]
+    }
+  }
+}

.gitattributes

@@ -3,7 +3,8 @@
 #
 # Linux start script should use lf
 /gradlew        text eol=lf
-
 # These are Windows script files and should use crlf
 *.bat           text eol=crlf
-
+# Exclude files from Graphite reviews
+docs/generated/* linguist-generated=true
+*.pdf,*.gif,*.mp4,*.webp,*.avif,*.png,*.jpeg,*.jpg,*.tiff filter=lfs diff=lfs merge=lfs -text

.github/workflows/ci.yml

@@ -4,12 +4,14 @@ on:
   push:
     branches:
       - master
+      - '[0-9]+.[0-9]+.x'
   pull_request:
     branches:
       - "**"
 
 env:
   NX_CLOUD_ACCESS_TOKEN: ${{ secrets.NX_CLOUD_ACCESS_TOKEN }}
+  PNPM_HOME: ~/.pnpm
 
 jobs:
   main-linux:
@@ -57,13 +59,26 @@ jobs:
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
-      - name: Install project dependencies
-        run: |
-          pnpm install --frozen-lockfile
-          pnpm playwright install --with-deps
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Cache Rust toolchain and cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
 
       - name: Install Rust
         uses: dtolnay/rust-toolchain@stable
@@ -74,6 +89,14 @@ jobs:
           distribution: temurin
           java-version: 17
 
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Install project dependencies
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm playwright install --with-deps
+
       - name: Check Documentation
         run: pnpm nx documentation
         timeout-minutes: 20
@@ -143,10 +166,100 @@ jobs:
 
       - name: Configure Detox Environment, Install applesimutils
         run: |
-          HOMEBREW_NO_AUTO_UPDATE=1 brew tap wix/brew >/dev/null
-          HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null
-          xcrun simctl shutdown all && xcrun simctl erase all
-        timeout-minutes: 20
+          # Ensure Xcode command line tools are installed and configured
+          xcode-select --print-path || sudo xcode-select --reset
+          sudo xcode-select -s /Applications/Xcode.app
+          
+          # Install or update applesimutils with error handling
+          if ! brew list applesimutils &>/dev/null; then
+            echo "Installing applesimutils..."
+            HOMEBREW_NO_AUTO_UPDATE=1 brew tap wix/brew >/dev/null
+            HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null || {
+              echo "Failed to install applesimutils, retrying with update..."
+              brew update
+              HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils
+            }
+          else
+            echo "Updating applesimutils..."
+            HOMEBREW_NO_AUTO_UPDATE=1 brew upgrade applesimutils || true
+          fi
+          
+          # Verify applesimutils installation
+          applesimutils --version || (echo "applesimutils installation failed" && exit 1)
+          
+          # Configure environment for M-series Mac
+          echo "DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer" >> $GITHUB_ENV
+          echo "PLATFORM_NAME=iOS Simulator" >> $GITHUB_ENV
+          
+          # Set additional environment variables for better debugging
+          echo "DETOX_DISABLE_TELEMETRY=1" >> $GITHUB_ENV
+          echo "DETOX_LOG_LEVEL=trace" >> $GITHUB_ENV
+          
+          # Verify Xcode installation
+          xcodebuild -version
+          
+          # List available simulators
+          xcrun simctl list devices available
+        timeout-minutes: 10
+        continue-on-error: false
+  
+      - name: Reset iOS Simulators
+        id: reset-simulators
+        run: |
+          echo "Resetting iOS Simulators..."
+          
+          # Kill simulator processes
+          sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+          killall "Simulator" 2>/dev/null || true
+          killall "iOS Simulator" 2>/dev/null || true
+          
+          # Wait for processes to terminate
+          sleep 3
+          
+          # Shutdown and erase all simulators (ignore failures)
+          xcrun simctl shutdown all 2>/dev/null || true
+          sleep 5
+          xcrun simctl erase all 2>/dev/null || true
+          
+          # If erase failed, try the nuclear option
+          if xcrun simctl list devices | grep -q "Booted" 2>/dev/null; then
+            echo "Standard reset failed, using nuclear option..."
+            rm -rf ~/Library/Developer/CoreSimulator/Devices/* 2>/dev/null || true
+            launchctl remove com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+            sleep 3
+          fi
+          
+          # Clean up additional directories
+          rm -rf ~/Library/Developer/CoreSimulator/Caches/* 2>/dev/null || true
+          rm -rf ~/Library/Logs/CoreSimulator/* 2>/dev/null || true
+          rm -rf ~/Library/Developer/Xcode/DerivedData/* 2>/dev/null || true
+          
+          echo "Simulator reset completed"
+        timeout-minutes: 5
+        continue-on-error: true
+
+      - name: Verify Simulator Reset
+        if: ${{ steps.reset-simulators.outcome == 'success' }}
+        run: |
+          # Verify CoreSimulator service restarted
+          pgrep -fl "CoreSimulator" || (echo "CoreSimulator service not running" && exit 1)
+          
+          # Check simulator list is clean
+          xcrun simctl list devices
+          
+          # Verify simulator runtime paths exist and are writable
+          test -d ~/Library/Developer/CoreSimulator/Devices || (echo "Simulator devices directory missing" && exit 1)
+          touch ~/Library/Developer/CoreSimulator/Devices/test || (echo "Simulator devices directory not writable" && exit 1)
+          rm ~/Library/Developer/CoreSimulator/Devices/test
+        timeout-minutes: 5
+
+      - name: Diagnose Simulator Reset Failure
+        if: ${{ steps.reset-simulators.outcome == 'failure' }}
+        run: |
+          echo "Simulator reset failed. Collecting diagnostic information..."
+          xcrun simctl list
+          echo "Checking simulator logs..."
+          ls -la ~/Library/Logs/CoreSimulator/ || echo "No simulator logs found"
 
       - name: Save Homebrew Cache
         uses: actions/cache@v4
@@ -159,17 +272,35 @@ jobs:
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Cache Rust toolchain and cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
       - name: Install project dependencies
         run: |
           pnpm install --frozen-lockfile
           pnpm playwright install --with-deps
 
-      - name: Install Rust
-        uses: dtolnay/rust-toolchain@stable
-
       - name: Set SHAs
         uses: nrwl/nx-set-shas@v4
         with:

.github/workflows/claude.yml

@@ -0,0 +1,93 @@
+name: Claude Code
+
+env:
+  PNPM_HOME: ~/.pnpm
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      contains(fromJson('["AgentEnder", "barbados-clemens", "Cammisuli", "Coly010", "FrozenPandaz", "JamesHenry", "jaysoo", "leosvelperez", "MaxKless", "meeroslav", "nartc", "philipjfulcher", "vsavkin"]'), github.actor) &&
+      ((github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+       (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+       (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+       (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude'))))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+      actions: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 250
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ca-certificates lsof libvips-dev libglib2.0-dev libgirepository1.0-dev
+
+      - name: Install Chrome
+        uses: browser-actions/setup-chrome@v1
+
+      - uses: pnpm/action-setup@v4
+        name: Install pnpm
+        with:
+          version: 10.11.1
+          run_install: false
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Cache cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            .cargo-cache
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 17
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Install project dependencies
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm playwright install --with-deps
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@beta
+        timeout-minutes: 90
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          allowed_tools: "Bash,Edit,Read,Write,Glob,Grep,LS,MultiEdit,NotebookRead,NotebookEdit"
+

.github/workflows/e2e-matrix.yml

@@ -25,7 +25,8 @@ jobs:
         os:
           - ubuntu-latest
           - macos-latest
-          - windows-latest
+          # - windows-latest Windows fails to build gradle wrapper which always runs when we build nx.
+          ## https://staging.nx.app/runs/LgD4vxGn8w?utm_source=pull-request&utm_medium=comment
         node_version:
           - 20
           - 22
@@ -36,9 +37,9 @@ jobs:
             node_version: 22
           # - os: macos-latest
           #   node_version: 23
-          - os: windows-latest
-            node_version: 22
-          # - os: windows-latest
+          # - os: windows-latest TODO (emily): Windows fails to build gradle wrapper which always runs when we build nx. Re-enable when we fix this.
+            # node_version: 22
+          # - os: windows-latest TODO (emily): Windows fails to build gradle wrapper which always runs when we build nx. Re-enable when we fix this.
           #   node_version: 23
 
     name: Cache install (${{ matrix.os }}, node v${{ matrix.node_version }})
@@ -52,7 +53,7 @@ jobs:
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
       - name: Set node
@@ -61,13 +62,17 @@ jobs:
           node-version: ${{ matrix.node_version }}
           cache: 'pnpm'
 
-      - name: Cache node_modules
-        id: cache-modules
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        run: echo "path=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - name: Cache pnpm store
         uses: actions/cache@v4
         with:
-          lookup-only: true
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ matrix.node_version }}-${{ hashFiles('pnpm-lock.yaml') }}
+          path: ${{ steps.pnpm-cache.outputs.path }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
 
       - name: Ensure Python setuptools Installed on Macos
         if: ${{ matrix.os == 'macos-latest' }}
@@ -75,8 +80,9 @@ jobs:
         run: brew install python-setuptools
 
       - name: Install packages
-        if: steps.cache-modules.outputs.cache-hit != 'true'
-        run: pnpm install --frozen-lockfile
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm playwright install --with-deps
 
       - name: Homebrew cache directory path
         if: ${{ matrix.os == 'macos-latest' }}
@@ -132,7 +138,7 @@ jobs:
     permissions:
       contents: read
     runs-on: ${{ matrix.os }}
-    timeout-minutes: 70     # <- cap each job to 70 minutes
+    timeout-minutes: 200     # <- cap each job to 200 minutes
     strategy:
       matrix: ${{fromJson(needs.prepare-matrix.outputs.matrix)}} # Load matrix from previous job
       fail-fast: false
@@ -151,7 +157,7 @@ jobs:
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
       - name: Use Node.js ${{ matrix.node_version }}
@@ -178,7 +184,9 @@ jobs:
           bun-version: latest
 
       - name: Install packages
-        run: pnpm install --frozen-lockfile
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm playwright install --with-deps
 
       - name: Cleanup
         if: ${{ matrix.os == 'ubuntu-latest' }}
@@ -220,33 +228,110 @@ jobs:
       - name: Configure Detox Environment, Install applesimutils
         if: ${{ matrix.os == 'macos-latest' }}
         run: |
-          # Check if applesimutils is already installed
+          # Ensure Xcode command line tools are installed and configured
+          xcode-select --print-path || sudo xcode-select --reset
+          sudo xcode-select -s /Applications/Xcode.app
+          
+          # Install or update applesimutils with error handling
           if ! brew list applesimutils &>/dev/null; then
+            echo "Installing applesimutils..."
             HOMEBREW_NO_AUTO_UPDATE=1 brew tap wix/brew >/dev/null
-            HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null
+            HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null || {
+              echo "Failed to install applesimutils, retrying with update..."
+              brew update
+              HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils
+            }
           else
-            echo "applesimutils is already installed, skipping installation"
+            echo "Updating applesimutils..."
+            HOMEBREW_NO_AUTO_UPDATE=1 brew upgrade applesimutils || true
           fi
+          
+          # Verify applesimutils installation
+          applesimutils --version || (echo "applesimutils installation failed" && exit 1)
+          
+          # Configure environment for M-series Mac
+          echo "DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer" >> $GITHUB_ENV
+          echo "PLATFORM_NAME=iOS Simulator" >> $GITHUB_ENV
+          
+          # Set additional environment variables for better debugging
+          echo "DETOX_DISABLE_TELEMETRY=1" >> $GITHUB_ENV
+          echo "DETOX_LOG_LEVEL=trace" >> $GITHUB_ENV
+          
+          # Verify Xcode installation
+          xcodebuild -version
+          
         timeout-minutes: 10
+        continue-on-error: false
 
       - name: Reset iOS Simulators
         if: ${{ matrix.os == 'macos-latest' }}
+        id: reset-simulators
         run: |
-          xcrun simctl shutdown all && xcrun simctl erase all
+          echo "Resetting iOS Simulators..."
+          
+          # Kill simulator processes
+          sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+          killall "Simulator" 2>/dev/null || true
+          killall "iOS Simulator" 2>/dev/null || true
+          
+          # Wait for processes to terminate
+          sleep 3
+          
+          # Shutdown and erase all simulators (ignore failures)
+          xcrun simctl shutdown all 2>/dev/null || true
+          sleep 5
+          xcrun simctl erase all 2>/dev/null || true
+          
+          # If erase failed, try the nuclear option
+          if xcrun simctl list devices | grep -q "Booted" 2>/dev/null; then
+            echo "Standard reset failed, using nuclear option..."
+            rm -rf ~/Library/Developer/CoreSimulator/Devices/* 2>/dev/null || true
+            launchctl remove com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+            sleep 3
+          fi
+          
+          # Clean up additional directories
+          rm -rf ~/Library/Developer/CoreSimulator/Caches/* 2>/dev/null || true
+          rm -rf ~/Library/Logs/CoreSimulator/* 2>/dev/null || true
+          rm -rf ~/Library/Developer/Xcode/DerivedData/* 2>/dev/null || true
+          
+          echo "Simulator reset completed"
+        timeout-minutes: 5
+        continue-on-error: true
+
+      - name: Verify Simulator Reset
+        if: ${{ matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success' }}
+        run: |
+          # Verify CoreSimulator service restarted
+          pgrep -fl "CoreSimulator" || (echo "CoreSimulator service not running" && exit 1)
+          
+          # Verify simulator runtime paths exist and are writable
+          test -d ~/Library/Developer/CoreSimulator/Devices || (echo "Simulator devices directory missing" && exit 1)
+          touch ~/Library/Developer/CoreSimulator/Devices/test || (echo "Simulator devices directory not writable" && exit 1)
+          rm ~/Library/Developer/CoreSimulator/Devices/test
         timeout-minutes: 5
 
+      - name: Diagnose Simulator Reset Failure
+        if: ${{ matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'failure' }}
+        run: |
+          echo "Simulator reset failed. Collecting diagnostic information..."
+          xcrun simctl list
+          echo "Checking simulator logs..."
+          ls -la ~/Library/Logs/CoreSimulator/ || echo "No simulator logs found"
+
       - name: Configure git metadata (needed for lerna smoke tests)
+        if: ${{ (matrix.os != 'macos-latest') || (matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success') }}
         run: |
           git config --global user.email test@test.com
           git config --global user.name "Test Test"
 
       - name: Set starting timestamp
+        if: ${{ (matrix.os != 'macos-latest') || (matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success') }}
         id: before-e2e
         shell: bash
         run: |
           echo "timestamp=$(date +%s)" >> $GITHUB_OUTPUT
 
-
       - name: Run e2e tests with pnpm (Linux/Windows)
         id: e2e-run-pnpm
         if: ${{ matrix.os != 'macos-latest' }}
@@ -270,7 +355,7 @@ jobs:
   
       - name: Run e2e tests with npm (macOS)
         id: e2e-run-npm
-        if: ${{ matrix.os == 'macos-latest' }}
+        if: ${{ matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success' }}
         run: |
           # Run the tests
           if [[ "${{ matrix.project }}" == "e2e-detox" ]] || [[ "${{ matrix.project }}" == "e2e-react-native" ]] || [[ "${{ matrix.project }}" == "e2e-expo" ]]; then
@@ -328,16 +413,23 @@ jobs:
           sudo: ${{ matrix.os != 'windows-latest' }} # disable sudo for windows debugging
 
   process-result:
-    if: ${{ always() && github.repository_owner == 'nrwl' }}
+    if: ${{ always() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
     runs-on: ubuntu-latest
     needs: e2e
     timeout-minutes: 10
     outputs:
-      message: ${{ steps.process-json.outputs.SLACK_MESSAGE }}
-      proj-duration: ${{ steps.process-json.outputs.SLACK_PROJ_DURATION }}
-      pm-duration: ${{ steps.process-json.outputs.SLACK_PM_DURATION }}
-      codeowners: ${{ steps.process-json.outputs.CODEOWNERS }}
+      message: ${{ steps.process-json.outputs.slack_message }}
+      proj_duration: ${{ steps.process-json.outputs.slack_proj_duration }}
+      pm_duration: ${{ steps.process-json.outputs.slack_pm_duration }}
+      codeowners: ${{ steps.process-json.outputs.codeowners }}
+      has_golden_failures: ${{ steps.process-json.outputs.has_golden_failures }}
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          filter: tree:0
+
       - name: Prepare dir for output
         run: mkdir -p outputs
 
@@ -349,145 +441,16 @@ jobs:
       - name: Join and stringify matrix configs
         id: combine-json
         run: |
-          combined=$((jq -s . outputs/*/matrix.json) | jq tostring)
+          combined=$(jq -sc . outputs/*/matrix.json)
           echo "combined=$combined" >> $GITHUB_OUTPUT
 
-      - name: Make slack outputs
+      - name: Process results with TypeScript script
         id: process-json
-        uses: actions/github-script@v7
-        env:
-          GITHUB_TOKEN: ${{ github.token }}
-        with:
-          script: |
-            const combined = JSON.parse(${{ steps.combine-json.outputs.combined }});
-            const failedProjects = combined.filter(c => c.status === 'failure').sort((a, b) => a.project.localeCompare(b.project));
-
-            // codeowners
-            const codeowners = new Set();
-            failedProjects.forEach(c => {
-              codeowners.add(c.codeowners);
-            });
-            core.setOutput('CODEOWNERS', Array.from(codeowners).join(','));
-
-            function trimSpace(res) {
-              return res.split('\n').map((l) => l.trim()).join('\n');
-            }
-
-            // failed message
-            let lastProject;
-            let result = `
-              \`\`\`
-              | Failed project                 | PM   | OS    | Node |
-              |--------------------------------|------|-------|------|`;
-            failedProjects.forEach(matrix => {
-              const project = matrix.project !== lastProject ? matrix.project : '...';
-              result += `\n| ${project.padEnd(30)} | ${matrix.package_manager.padEnd(4)} | ${matrix.os_name} | v${matrix.node_version}  |`
-              lastProject = matrix.project;
-            });
-            result += `\`\`\``;
-            core.setOutput('SLACK_MESSAGE', trimSpace(result));
-            console.log(trimSpace(result));
-
-            function humanizeDuration(num) {
-              let res = '';
-              const hours = Math.floor(num / 3600);
-              if (hours) {
-                res += `${hours}h `;
-              }
-              const mins = Math.floor((num % 3600) / 60);
-              if (mins) {
-                res += `${mins}m `;
-              }
-              const sec = num % 60;
-              if (sec) {
-                res += `${sec}s`
-              }
-              return res;
-            }
-
-            // duration message
-            const timeReport = {};
-            const pmReport = {
-              npm: 0,
-              yarn: 0,
-              pnpm: 0
-            };
-            const macosProjects = ['e2e-detox', 'e2e-expo', 'e2e-react-native'];
-            combined.forEach((matrix) => {
-              if (matrix.os_name === 'Linux' && matrix.node_version === 20) {
-                pmReport[matrix.package_manager] += matrix.duration;
-              }
-              if (matrix.os_name === 'Linux' || macosProjects.includes(matrix.project)) {
-                if (timeReport[matrix.project]) {
-                  if (matrix.duration > timeReport[matrix.project].max) {
-                    timeReport[matrix.project].max = matrix.duration;
-                    timeReport[
-                      matrix.project
-                    ].maxEnv = `${matrix.os_name}, ${matrix.package_manager}`;
-                  }
-                  if (matrix.duration < timeReport[matrix.project].min) {
-                    timeReport[matrix.project].min = matrix.duration;
-                    timeReport[
-                      matrix.project
-                    ].minEnv = `${matrix.os_name}, ${matrix.package_manager}`;
-                  }
-                } else {
-                  timeReport[matrix.project] = {
-                    min: matrix.duration,
-                    max: matrix.duration,
-                    minEnv: `${matrix.os_name}, ${matrix.package_manager}`,
-                    maxEnv: `${matrix.os_name}, ${matrix.package_manager}`,
-                  };
-                }
-              }
-            });
-
-            // project time report
-            let resultPkg = `
-                \`\`\`
-                | Project                        | Time                      |
-                |--------------------------------|---------------------------|`;
-            function mapProjectTime(proj, section) {
-              let res = '';
-              res += `${humanizeDuration(timeReport[proj][section])}`;
-              res += ` (${timeReport[proj][section + 'Env']})`
-              return res;
-            }
-            function durationIcon(proj, section) {
-              if (timeReport[proj][section] < 12 * 60) {
-                return `${section} ✅`;
-              }
-              if (timeReport[proj][section] < 15 * 60) {
-                return `${section} ❗`;
-              }
-              return `${section} ❌`;
-            }
-            Object.keys(timeReport).forEach(proj => {
-              resultPkg += `\n| ${proj.padEnd(30)} |                           |`;
-              resultPkg += `\n| ${durationIcon(proj, 'min').padStart(29)} | ${mapProjectTime(proj, 'min').padEnd(25)} |`;
-              resultPkg += `\n| ${durationIcon(proj, 'max').padStart(29)} | ${mapProjectTime(proj, 'max').padEnd(25)} |`;
-            });
-            resultPkg += `\`\`\``;
-            core.setOutput('SLACK_PROJ_DURATION', trimSpace(resultPkg));
-
-            // Print project duration report inline to allow reviewing on manual runs (when no slack message will be sent)
-            console.log(trimSpace(resultPkg));
-
-            let resultPm = `
-                \`\`\`
-                | PM   | Total time  |
-                |------|-------------|`;
-            Object.keys(pmReport).forEach(pm => {
-              resultPm += `\n| ${pm.padEnd(4)} | ${humanizeDuration(pmReport[pm]).padEnd(11)} |`
-            });
-            resultPm += `\`\`\``;
-            core.setOutput('SLACK_PM_DURATION', trimSpace(resultPm));
-
-            // Print package manager duration report inline to allow reviewing on manual runs (when no slack message will be sent)
-            console.log(trimSpace(resultPm));
+        run: |
+          echo '${{ steps.combine-json.outputs.combined }}' | npx tsx .github/workflows/nightly/process-result.ts
 
   report-failure:
-    if: ${{ failure() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
+    if: ${{ always() && needs.process-result.outputs.has_golden_failures == 'true' && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
     needs: process-result
     runs-on: ubuntu-latest
     name: Report failure
@@ -497,16 +460,16 @@ jobs:
         uses: ravsamhq/notify-slack-action@v2
         with:
           status: 'failure'
-          message_format: '{emoji} Workflow has {status_message} ${{ needs.process-result.outputs.message }}'
-          notification_title: '{workflow}'
+          message_format: '${{ needs.process-result.outputs.message }}'
+          notification_title: 'Golden Test Failure'
           footer: '<{run_url}|View Run> / Last commit <{commit_url}|{commit_sha}>'
           mention_groups: ${{ needs.process-result.outputs.codeowners }}
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}
 
   report-success:
-    if: ${{ success() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
-    needs: e2e
+    if: ${{ always() && needs.process-result.outputs.has_golden_failures == 'false' && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
+    needs: process-result
     runs-on: ubuntu-latest
     name: Report status
     timeout-minutes: 10
@@ -514,9 +477,9 @@ jobs:
       - name: Send notification
         uses: ravsamhq/notify-slack-action@v2
         with:
-          status: ${{ needs.e2e.result }}
-          message_format: '{emoji} Workflow has {status_message}'
-          notification_title: '{workflow}'
+          status: 'success'
+          message_format: '${{ needs.process-result.outputs.message }}'
+          notification_title: '✅ Golden Tests: All Passed!'
           footer: '<{run_url}|View Run> / Last commit <{commit_url}|{commit_sha}>'
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}
@@ -532,8 +495,8 @@ jobs:
         uses: ravsamhq/notify-slack-action@v2
         with:
           status: 'skipped'
-          message_format: '${{ needs.process-result.outputs.pm-duration }}'
-          notification_title: 'Total duration per package manager (ubuntu only)'
+          message_format: '${{ needs.process-result.outputs.pm_duration }}'
+          notification_title: '⌛ Total duration per package manager (ubuntu only)'
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}
 
@@ -542,13 +505,13 @@ jobs:
     needs: process-result
     runs-on: ubuntu-latest
     timeout-minutes: 10
-    name: Report duration per package manager
+    name: Report duration per project
     steps:
       - name: Send notification
         uses: ravsamhq/notify-slack-action@v2
         with:
           status: 'skipped'
-          message_format: '${{ needs.process-result.outputs.proj-duration }}'
-          notification_title: 'E2E Project duration stats'
+          message_format: '${{ needs.process-result.outputs.proj_duration }}'
+          notification_title: '⌛ E2E Project duration stats'
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}

.github/workflows/generate-embeddings.yml

@@ -25,7 +25,7 @@ jobs:
         uses: pnpm/action-setup@v4
         id: pnpm-install
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
       - name: Get pnpm store directory

.github/workflows/issue-notifier.yml

@@ -20,7 +20,7 @@ jobs:
 
       - uses: pnpm/action-setup@v4
         with:
-          version: 9.8.0
+          version: 10.11.1
 
       - name: Use Node.js ${{ matrix.node_version }}
         uses: actions/setup-node@v3

.github/workflows/nightly/process-matrix.ts

@@ -1,6 +1,7 @@
 type MatrixDataProject = {
   name: string,
   codeowners: string,
+  is_golden?: boolean, // true if this is a golden project, false otherwise
 };
 
 type MatrixDataOS = {
@@ -19,58 +20,70 @@ type MatrixData = {
   setup: MatrixDataOS[],
 }
 
-// TODO: Extract Slack groups into named groups for easier maintenance
-const matrixData: MatrixData = {
-  coreProjects: [
-    { name: 'e2e-lerna-smoke-tests', codeowners: 'S04TNCVEETS' },
-    { name: 'e2e-js', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-nx-init', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-nx', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-release', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-workspace-create', codeowners: 'S04SYHYKGNP' }
-  ],
-  projects: [
-    { name: 'e2e-angular', codeowners: 'S04SS457V38' },
-    { name: 'e2e-cypress', codeowners: 'S04T16BTJJY' },
-    { name: 'e2e-detox', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-esbuild', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-expo', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-gradle', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-jest', codeowners: 'S04T16BTJJY' },
-    { name: 'e2e-eslint', codeowners: 'S04SYJGKSCT' },
-    { name: 'e2e-next', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-node', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-plugin', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-react', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-react-native', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-web', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-rollup', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-storybook', codeowners: 'S04SVQ8H0G5' },
-    { name: 'e2e-playwright', codeowners: 'S04SVQ8H0G5' },
-    { name: 'e2e-remix', codeowners: 'S04SVQ8H0G5' },
-    { name: 'e2e-rspack', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-vite', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-vue', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-nuxt', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-webpack', codeowners: 'S04SJ6PL98X' }
-  ],
-  nodeTLS: 20,
-  setup: [
-    { os: 'ubuntu-latest', os_name: 'Linux', os_timeout: 60, package_managers: ['npm', 'pnpm', 'yarn'], node_versions: ['20.19.0', "22.12.0"], excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo'] },
-    { os: 'macos-latest', os_name: 'MacOS', os_timeout: 90, package_managers: ['npm'], node_versions: ['20.19.0'] },
-    { os: 'windows-latest', os_name: 'WinOS', os_timeout: 180, package_managers: ['npm'], node_versions: ['20.19.0'], excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo'] }
-  ]
-};
-
-const matrix: Array<{
+export type MatrixItem = {
   project: string,
   codeowners: string,
   node_version: number | string,
   package_manager: string,
   os: string,
   os_name: string,
-  os_timeout: number
-}> = [];
+  os_timeout: number,
+  is_golden?: boolean,
+};
+
+// TODO: Extract Slack groups into named groups for easier maintenance
+const matrixData: MatrixData = {
+  coreProjects: [
+    { name: 'e2e-lerna-smoke-tests', codeowners: 'S04TNCVEETS', is_golden: true },
+    { name: 'e2e-js', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-nx-init', codeowners: 'S04SYHYKGNP', is_golden: true },
+    { name: 'e2e-nx', codeowners: 'S04SYHYKGNP' },
+    { name: 'e2e-release', codeowners: 'S04SYHYKGNP' },
+    { name: 'e2e-workspace-create', codeowners: 'S04SYHYKGNP' }
+  ],
+  projects: [
+    { name: 'e2e-cypress', codeowners: 'S04T16BTJJY', is_golden: true },
+    { name: 'e2e-docker', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-detox', codeowners: 'S04TNCNJG5N', is_golden: true },
+    { name: 'e2e-esbuild', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-gradle', codeowners: 'S04TNCNJG5N', is_golden: true },
+    { name: 'e2e-eslint', codeowners: 'S04SYJGKSCT', is_golden: true },
+    { name: 'e2e-node', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-playwright', codeowners: 'S04SVQ8H0G5', is_golden: true },
+    { name: 'e2e-remix', codeowners: 'S04SVQ8H0G5', is_golden: true },
+    { name: 'e2e-rspack', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-vite', codeowners: 'S04SJ6PL98X', is_golden: true },
+    { name: 'e2e-vue', codeowners: 'S04SJ6PL98X', is_golden: true },
+    { name: 'e2e-web', codeowners: 'S04SJ6PL98X', is_golden: true },
+    { name: 'e2e-webpack', codeowners: 'S04SJ6PL98X', is_golden: true },
+    { name: 'e2e-jest', codeowners: 'S04T16BTJJY', is_golden: true },
+    { name: 'e2e-expo', codeowners: 'S04TNCNJG5N', is_golden: true },
+    { name: 'e2e-react-native', codeowners: 'S04TNCNJG5N', is_golden: true },
+    { name: 'e2e-angular', codeowners: 'S04SS457V38' },
+    { name: 'e2e-next', codeowners: 'S04TNCNJG5N' },
+    { name: 'e2e-plugin', codeowners: 'S04SYHYKGNP' },
+    { name: 'e2e-react', codeowners: 'S04TNCNJG5N' },
+    { name: 'e2e-rollup', codeowners: 'S04SJ6PL98X' },
+    { name: 'e2e-storybook', codeowners: 'S04SVQ8H0G5' },
+    { name: 'e2e-nuxt', codeowners: 'S04SJ6PL98X' }
+  ],
+  nodeTLS: 20,
+  setup: [
+    {
+      os: 'ubuntu-latest',
+      os_name: 'Linux',
+      os_timeout: 60,
+      package_managers: ['npm', 'pnpm', 'yarn'],
+      node_versions: ['20.19.0', '22.12.0'],
+      excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo']
+    },
+    { os: 'macos-latest', os_name: 'MacOS', os_timeout: 90, package_managers: ['npm'], node_versions: ['20.19.0'] }
+    // TODO (emily): Fix Windows support as gradle fails when running nx build https://staging.nx.app/runs/LgD4vxGn8w?utm_source=pull-request&utm_medium=comment
+    // { os: 'windows-latest', os_name: 'WinOS', os_timeout: 180, package_managers: ['npm'], node_versions: ['20.19.0'], excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo'] }
+  ]
+};
+
+const matrix: Array<MatrixItem> = [];
 
 function addMatrixCombo(project: MatrixDataProject, nodeVersion: number | string, pm: number, os: number) {
   matrix.push({
@@ -81,6 +94,7 @@ function addMatrixCombo(project: MatrixDataProject, nodeVersion: number | string
     os: matrixData.setup[os].os,
     os_name: matrixData.setup[os].os_name,
     os_timeout: matrixData.setup[os].os_timeout,
+    is_golden: !!project.is_golden // Mark golden projects as true, others as false
   });
 }
 

.github/workflows/nightly/process-result.ts

@@ -0,0 +1,197 @@
+import * as fs from 'fs';
+import { MatrixItem } from './process-matrix';
+
+interface MatrixResult extends MatrixItem {
+  status: 'success' | 'failure' | 'cancelled';
+  duration: number;
+}
+
+interface ProcessedResults {
+  codeowners: string;
+  slack_message: string;
+  slack_proj_duration: string;
+  slack_pm_duration: string;
+  has_golden_failures: string;
+}
+
+function trimSpace(res: string): string {
+  return res.split('\n').map((l) => l.trim()).join('\n');
+}
+
+function humanizeDuration(num: number): string {
+  let res = '';
+  const hours = Math.floor(num / 3600);
+  if (hours) res += `${hours}h `;
+  const mins = Math.floor((num % 3600) / 60);
+  if (mins) res += `${mins}m `;
+  const sec = num % 60;
+  if (sec) res += `${sec}s`;
+  return res;
+}
+
+function processResults(combined: MatrixResult[]): ProcessedResults {
+  const failedProjects = combined.filter(c => c.status === 'failure' || c.status === 'cancelled').sort((a, b) => a.project.localeCompare(b.project));
+  const failedGoldenProjects = failedProjects.filter(c => c.is_golden);
+  const hasGoldenFailures = failedGoldenProjects.length > 0;
+  const codeowners = new Set<string>();
+  failedGoldenProjects.forEach(c => codeowners.add(c.codeowners));
+
+  let result = '';
+
+  const allGoldenProjects = combined.filter(c => c.is_golden);
+  const uniqueGoldenProjects = new Set(allGoldenProjects.map(c => c.project));
+  const uniqueFailedGoldenProjects = new Set(failedGoldenProjects.map(c => c.project));
+  const goldenPassingCount = uniqueGoldenProjects.size - uniqueFailedGoldenProjects.size;
+  const goldenFailingCount = uniqueFailedGoldenProjects.size;
+
+  const allOtherProjects = combined.filter(c => !c.is_golden);
+  const uniqueOtherProjects = new Set(allOtherProjects.map(c => c.project));
+  const failedRegularProjects = failedProjects.filter(c => !c.is_golden);
+  const uniqueFailedOtherProjects = new Set(failedRegularProjects.map(c => c.project));
+  const otherPassingCount = uniqueOtherProjects.size - uniqueFailedOtherProjects.size;
+  const otherFailingCount = uniqueFailedOtherProjects.size;
+
+  result += `\n🌟 *Golden Projects*`;
+  result += `\n✅ Passing: ${goldenPassingCount}`;
+  result += `\n❌ Failing: ${goldenFailingCount}`;
+
+  if (failedGoldenProjects.length > 0) {
+    result += `\n\n🚨 *Failed Golden Projects*\n\`\`\``;
+    result += `\n| Failed project                 |`;
+    result += `\n|--------------------------------|`;
+    let lastProject: string | undefined;
+    failedGoldenProjects.forEach(matrix => {
+      const project = matrix.project !== lastProject ? matrix.project : '';
+      if (project) {
+        result += `\n| ${project.padEnd(30)} |`;
+        lastProject = matrix.project;
+      }
+    });
+    result += `\n\`\`\``;
+  }
+
+  result += `\n\n🔧 *Other Projects*`;
+  result += `\n✅ Passing: ${otherPassingCount}`;
+  result += `\n❌ Failing: ${otherFailingCount}`;
+
+  // Failed Other Projects Table (if any)
+  if (failedRegularProjects.length > 0) {
+    result += `\n\n⚠️ *Failed Other Projects*\n\`\`\``;
+    result += `\n| Failed project                 |`;
+    result += `\n|--------------------------------|`;
+    let lastProject: string | undefined;
+    failedRegularProjects.forEach(matrix => {
+      const project = matrix.project !== lastProject ? matrix.project : '';
+      if (project) {
+        result += `\n| ${project.padEnd(30)} |`;
+        lastProject = matrix.project;
+      }
+    });
+    result += `\n\`\`\``;
+  }
+
+  if (failedProjects.length === 0) {
+    result = '🎉 *No test failures detected!* All systems green! 🟢';
+  }
+
+  const timeReport: Record<string, { min: number; max: number; minEnv: string; maxEnv: string }> = {};
+  const pmReport = { npm: 0, yarn: 0, pnpm: 0 };
+  const macosProjects = ['e2e-detox', 'e2e-expo', 'e2e-react-native'];
+
+  combined.forEach(matrix => {
+    const nodeVersion = parseInt(matrix.node_version.toString());
+    if (matrix.os_name === 'Linux' && nodeVersion === 20 && matrix.package_manager in pmReport) {
+      pmReport[matrix.package_manager as keyof typeof pmReport] += matrix.duration;
+    }
+    if (matrix.os_name === 'Linux' || macosProjects.includes(matrix.project)) {
+      if (timeReport[matrix.project]) {
+        if (matrix.duration > timeReport[matrix.project].max) {
+          timeReport[matrix.project].max = matrix.duration;
+          timeReport[matrix.project].maxEnv = `${matrix.os_name}, ${matrix.package_manager}`;
+        }
+        if (matrix.duration < timeReport[matrix.project].min) {
+          timeReport[matrix.project].min = matrix.duration;
+          timeReport[matrix.project].minEnv = `${matrix.os_name}, ${matrix.package_manager}`;
+        }
+      } else {
+        timeReport[matrix.project] = {
+          min: matrix.duration,
+          max: matrix.duration,
+          minEnv: `${matrix.os_name}, ${matrix.package_manager}`,
+          maxEnv: `${matrix.os_name}, ${matrix.package_manager}`,
+        };
+      }
+    }
+  });
+
+  let resultPkg = `
+    \`\`\`
+    | Project                        | Time                      |
+    |--------------------------------|---------------------------|`;
+
+  function mapProjectTime(proj: string, section: 'min' | 'max'): string {
+    return `${humanizeDuration(timeReport[proj][section])} (${timeReport[proj][`${section}Env`]})`;
+  }
+
+  function durationIcon(proj: string, section: 'min' | 'max'): string {
+    const duration = timeReport[proj][section];
+    if (duration < 12 * 60) return `${section} ✅`;
+    if (duration < 15 * 60) return `${section} ❗`;
+    return `${section} ❌`;
+  }
+
+  Object.keys(timeReport).forEach(proj => {
+    resultPkg += `\n| ${proj.padEnd(30)} |                           |`;
+    resultPkg += `\n| ${durationIcon(proj, 'min').padStart(29)} | ${mapProjectTime(proj, 'min').padEnd(25)} |`;
+    resultPkg += `\n| ${durationIcon(proj, 'max').padStart(29)} | ${mapProjectTime(proj, 'max').padEnd(25)} |`;
+  });
+  resultPkg += `\`\`\``;
+
+  let resultPm = `
+    \`\`\`
+    | PM   | Total time  |
+    |------|-------------|`;
+  Object.keys(pmReport).forEach(pm => {
+    resultPm += `\n| ${pm.padEnd(4)} | ${humanizeDuration(pmReport[pm as keyof typeof pmReport]).padEnd(11)} |`;
+  });
+  resultPm += `\`\`\``;
+
+  return {
+    codeowners: Array.from(codeowners).join(','),
+    slack_message: trimSpace(result),
+    slack_proj_duration: trimSpace(resultPkg),
+    slack_pm_duration: trimSpace(resultPm),
+    has_golden_failures: hasGoldenFailures.toString(),
+  };
+}
+
+function setOutput(key: string, value: string) {
+  const outputPath = process.env.GITHUB_OUTPUT;
+  if (!outputPath) {
+    console.warn(`GITHUB_OUTPUT not set. Skipping output for "${key}".`);
+    return;
+  }
+
+  if (value.includes('\n')) {
+    const delimiter = `EOF_${key}_${Date.now()}`;
+    fs.appendFileSync(outputPath, `${key}<<${delimiter}\n${value}\n${delimiter}\n`);
+  } else {
+    fs.appendFileSync(outputPath, `${key}=${value}\n`);
+  }
+}
+
+try {
+  const combinedInput = process.argv[2]
+    ? process.argv[2]
+    : fs.readFileSync(0, 'utf-8').trim();
+
+  const combined: MatrixResult[] = JSON.parse(combinedInput);
+  const results = processResults(combined);
+
+  Object.entries(results).forEach(([key, value]) => {
+    setOutput(key, value);
+  });
+} catch (error) {
+  console.error('Error processing results:', error);
+  process.exit(1);
+}

.github/workflows/npm-audit.yml

@@ -18,7 +18,7 @@ jobs:
 
       - uses: pnpm/action-setup@v4
         with:
-          version: 9.8.0 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
+          version: 10.11.1 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
 
       - name: Run a security audit
         run: pnpm dlx audit-ci --critical --report-type summary

.github/workflows/pr-title-validation.yml

@@ -0,0 +1,29 @@
+name: PR Title Validation
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+permissions: read-all
+
+jobs:
+  validate-pr-title:
+    name: Validate PR Title
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          # Ensure's validate-pr-title.js is the copy from master
+          ref: master
+          
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          
+      - name: Validate PR title
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          PR_BODY: ${{ github.event.pull_request.body }}
+        run: node ./scripts/validate-pr-title.js

.github/workflows/publish.yml

@@ -3,14 +3,7 @@ name: publish
 on:
   # Automated schedule - canary releases from master
   schedule:
-    - cron: "0 3 * * 2-6" # Tuesdays - Saturdays, at 3am UTC
-  # Manual trigger - PR releases or dry-runs (based on workflow inputs)
-  workflow_dispatch:
-    inputs:
-      pr:
-        description: "PR Number - If set, a real release will be created for the branch associated with the given PR number. If blank, a dry-run of the currently selected branch will be performed."
-        required: false
-        type: number
+    - cron: "0 20 * * 1-5" # Monday - Friday, at 20:00 UTC (8pm UTC)
   release:
     types: [ published ]
 
@@ -21,8 +14,8 @@ env:
   DEBUG: napi:*
   NX_RUN_GROUP: ${{ github.run_id }}-${{ github.run_attempt }}
   CYPRESS_INSTALL_BINARY: 0
-  NODE_VERSION: 20.19.0
-  PNPM_VERSION: 9.8.0 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
+  NODE_VERSION: 22.16.0
+  PNPM_VERSION: 10.11.1 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
 
 jobs:
   # We first need to determine the version we are releasing, and if we need a custom repo or ref to use for the git checkout in subsequent steps.
@@ -51,13 +44,10 @@ jobs:
       publish_branch: ${{ steps.script.outputs.publish_branch }}
       ref: ${{ steps.script.outputs.ref }}
       repo: ${{ steps.script.outputs.repo }}
-    env:
-      NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
     steps:
       # Default checkout on the triggering branch so that the latest publish-resolve-data.js script is available
       - uses: actions/checkout@v4
 
-      # Set up pnpm and node so that we can verify our setup and that the NPM_TOKEN secret will work later
       - uses: pnpm/action-setup@v4
         with:
           version: ${{ env.PNPM_VERSION }}
@@ -69,10 +59,6 @@ jobs:
           registry-url: 'https://registry.npmjs.org'
           check-latest: true
 
-      # Ensure that the NPM_TOKEN secret is still valid before wasting any time deriving data or building projects
-      - name: Check NPM Credentials
-        run: npm whoami && echo "NPM credentials are valid" || (echo "NPM credentials are invalid or have expired." && exit 1)
-
       - name: Resolve and set checkout and version data to use for release
         id: script
         uses: actions/github-script@v7
@@ -140,23 +126,50 @@ jobs:
           - host: ubuntu-latest
             target: x86_64-unknown-linux-gnu
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-debian
-            build: |-
-              set -e &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
-              rustup target add aarch64-unknown-linux-gnu &&
+            build: |
+              set -e
+              apt-get update
+
+              curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+              apt-get install -y nodejs=22.16.0-1nodesource1
+            
+              export PATH="/usr/local/bin:$PATH"
+              node --version
+              npm --version
+            
+              npm i -g pnpm@${PNPM_VERSION} --force
+              pnpm --version
+            
+              pnpm install --frozen-lockfile
+              rustup target add x86_64-unknown-linux-gnu
               pnpm nx run-many --verbose --target=build-native -- --target=x86_64-unknown-linux-gnu
           - host: ubuntu-latest
             target: x86_64-unknown-linux-musl
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-alpine
-            build: |-
-              set -e &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
-              rustup target add x86_64-unknown-linux-musl &&
-              pnpm nx run-many --verbose --target=build-native -- --target=x86_64-unknown-linux-musl
+            build: |
+              bash -c "
+                set -e
+                echo 'https://dl-cdn.alpinelinux.org/alpine/edge/community' >> /etc/apk/repositories
+                apk add --no-cache curl xz
+
+                curl -fsSL https://unofficial-builds.nodejs.org/download/release/v22.16.0/node-v22.16.0-linux-x64-musl.tar.xz -o node.tar.xz
+                tar -xJf node.tar.xz
+                mv node-v22.16.0-linux-x64-musl /usr/local/node
+            
+                export PATH=\"/usr/local/node/bin:\$PATH\"
+            
+                echo Node: \$(node -v)
+                echo NPM: \$(npm -v)
+            
+                # Install PNPM
+                npm i -g pnpm@${PNPM_VERSION} --force
+                pnpm --version
+            
+                # Install deps and run native build
+                pnpm install --frozen-lockfile
+                rustup target add x86_64-unknown-linux-musl
+                pnpm nx run-many --verbose --target=build-native -- --target=x86_64-unknown-linux-musl
+              "
           - host: macos-13
             target: aarch64-apple-darwin
             setup: |-
@@ -171,12 +184,22 @@ jobs:
           - host: ubuntu-latest
             target: aarch64-unknown-linux-gnu
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-debian-aarch64
-            build: |-
-              set -e &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
-              rustup target add aarch64-unknown-linux-gnu &&
+            build: |
+              set -e
+              apt-get update
+            
+              curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+              apt-get install -y nodejs=22.16.0-1nodesource1
+            
+              export PATH="/usr/local/bin:$PATH"
+              node --version
+              npm --version
+            
+              npm i -g pnpm@${PNPM_VERSION} --force
+              pnpm --version
+            
+              pnpm install --frozen-lockfile
+              rustup target add aarch64-unknown-linux-gnu
               pnpm nx run-many --verbose --target=build-native -- --target=aarch64-unknown-linux-gnu
           - host: ubuntu-latest
             target: armv7-unknown-linux-gnueabihf
@@ -198,19 +221,36 @@ jobs:
           - host: ubuntu-latest
             target: aarch64-unknown-linux-musl
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-alpine
-            build: |-
-              set -e &&
-              rustup target add aarch64-unknown-linux-musl &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
-              pnpm nx run-many --verbose --target=build-native -- --target=aarch64-unknown-linux-musl
+            build: |
+              bash -c "
+                set -e
+                echo 'https://dl-cdn.alpinelinux.org/alpine/edge/community' >> /etc/apk/repositories
+                apk add --no-cache curl xz
+            
+                curl -fsSL https://unofficial-builds.nodejs.org/download/release/v22.16.0/node-v22.16.0-linux-x64-musl.tar.xz -o node.tar.xz
+                tar -xJf node.tar.xz
+                mv node-v22.16.0-linux-x64-musl /usr/local/node
+            
+                export PATH=\"/usr/local/node/bin:\$PATH\"
+            
+                echo Node: \$(node -v)
+                echo NPM: \$(npm -v)
+            
+                # Install PNPM
+                npm i -g pnpm@${PNPM_VERSION} --force
+                pnpm --version
+            
+                # Install deps and run native build
+                pnpm install --frozen-lockfile
+                rustup target add aarch64-unknown-linux-musl  
+                pnpm nx run-many --verbose --target=build-native -- --target=aarch64-unknown-linux-musl  
+              "
           - host: windows-latest
             target: aarch64-pc-windows-msvc
             setup: |-
               rustup target add aarch64-pc-windows-msvc
             build: pnpm nx run-many --target=build-native -- --target=aarch64-pc-windows-msvc
-    name: stable - ${{ matrix.settings.target }} - node@18
+    name: stable - ${{ matrix.settings.target }} - node@22.16.0
     runs-on: ${{ matrix.settings.host }}
     steps:
       - uses: actions/checkout@v4
@@ -294,8 +334,8 @@ jobs:
         with:
           name: bindings-${{ matrix.settings.target }}
           path: |
-            packages/**/*.node
-            packages/**/*.wasm
+            packages/nx/src/native/*.node
+            packages/nx/src/native/*.wasm
           if-no-files-found: error
 
   build-freebsd:
@@ -318,17 +358,18 @@ jobs:
           RUSTUP_IO_THREADS: 1
           NX_PREFER_TS_NODE: true
           PLAYWRIGHT_BROWSERS_PATH: 0
+          NODE_VERSION: 22.16.0
         with:
           operating_system: freebsd
           version: '14.0'
           architecture: x86-64
-          environment_variables: DEBUG RUSTUP_IO_THREADS CI NX_PREFER_TS_NODE PLAYWRIGHT_BROWSERS_PATH
+          environment_variables: DEBUG RUSTUP_IO_THREADS CI NX_PREFER_TS_NODE PLAYWRIGHT_BROWSERS_PATH NODE_VERSION
           shell: bash
           run: |
             env
             whoami
             sudo pkg install -y -f node libnghttp2 www/npm git
-            sudo npm install --location=global --ignore-scripts pnpm@9.8.0
+            sudo npm install --location=global --ignore-scripts pnpm@10.11.1
             curl https://sh.rustup.rs -sSf --output rustup.sh
             sh rustup.sh -y --profile minimal --default-toolchain stable
             source "$HOME/.cargo/env"
@@ -343,8 +384,11 @@ jobs:
             whoami
             env
             freebsd-version
+            echo "Installing dependencies"
             pnpm install --frozen-lockfile --ignore-scripts
+            echo "Building FreeBSD bindings"
             pnpm nx run-many --verbose --outputStyle stream --target=build-native -- --target=x86_64-unknown-freebsd
+            echo "Cleaning up"
             pnpm nx reset
             rm -rf node_modules
             rm -rf dist
@@ -356,13 +400,15 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: bindings-freebsd
-          path: packages/**/*.node
+          path: |
+            packages/nx/src/native/*.node
           if-no-files-found: error
 
   publish:
     if: ${{ github.repository_owner == 'nrwl' }}
     name: Publish
     runs-on: ubuntu-latest
+    environment: npm-registry
     permissions:
       id-token: write
       contents: write
@@ -373,8 +419,6 @@ jobs:
       - build
     env:
       GH_TOKEN: ${{ github.token }}
-      NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      NPM_CONFIG_PROVENANCE: true
     steps:
       - uses: actions/checkout@v4
         with:
@@ -392,6 +436,9 @@ jobs:
           registry-url: 'https://registry.npmjs.org'
           check-latest: true
           cache: 'pnpm'
+     
+      - name: Use npm 11.5.2
+        run: npm install -g npm@11.5.2
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.gitignore

@@ -2,8 +2,8 @@ node_modules
 /.idea
 /.fleet
 /.vscode
-/.cursor
 dist
+out-tsc
 /build
 /coverage
 ./test
@@ -36,6 +36,7 @@ CHANGELOG.md
 .next
 out
 
+
 # Angular Cache
 .angular
 
@@ -73,5 +74,47 @@ storybook-static
 .gradle
 .kotlin
 
+.claude/settings.local.json
+
 .cursor/rules/nx-rules.mdc
-.github/instructions/nx.instructions.md
+.cursor/mcp.json
+.github/instructions/nx.instructions.md
+
+# Added by Claude Task Master
+# Logs
+logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+dev-debug.log
+# Dependency directories
+node_modules/
+# Environment variables
+.env
+# Editor directories and files
+.idea
+.vscode
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+.specstory/**
+.cursorindexingignore
+# OS specific
+# Task files
+tasks.json
+tasks/
+
+# Upstream docs local configuration (machine-specific)
+.upstreamdocs.local.json
+
+astro-docs/.netlify
+
+# Angular Rspack Specific Options
+packages/angular-rspack/coverage
+packages/angular-rspack-compiler/coverage
+
+# Angular Rspack Packages use a template to generate the correct README
+packages/angular-rspack/README.md
+packages/angular-rspack-compiler/README.md

.husky/commit-msg

@@ -0,0 +1 @@
+node ./scripts/commit-lint.js "$1"

.husky/post-checkout

@@ -1,2 +1,12 @@
+# Skip if this is a worktree creation (previous ref is null)
+if [ "$1" = "0000000000000000000000000000000000000000" ]; then
+  exit 0
+fi
+
+# Skip if this is a file checkout (not branch switch) - $3 would be 0
+if [ "$3" = "0" ]; then
+  exit 0
+fi
+
 changedFiles="$(git diff-tree -r --name-only --no-commit-id $1 $2)"
-node ./scripts/notify-lockfile-changes.js $changedFiles
+node ./scripts/notify-lockfile-changes.js $changedFiles

.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "nx": {
+      "command": "pnpm",
+      "args": ["nx-mcp"],
+      "env": {}
+    }
+  }
+}

.nx/workflows/agents.yaml

@@ -1,6 +1,6 @@
 launch-templates:
-  linux-medium:
-    resource-class: 'docker_linux_amd64/medium+'
+  linux-large:
+    resource-class: 'docker_linux_amd64/large'
     image: 'us-east1-docker.pkg.dev/nxcloudoperations/nx-cloud/nx-agents-base-images:ubuntu22.04-node20.19-v1'
     env:
       GIT_AUTHOR_EMAIL: test@test.com
@@ -65,11 +65,11 @@ launch-templates:
       - name: Load Cargo Env
         script: echo "PATH=$HOME/.cargo/bin:$PATH" >> $NX_CLOUD_ENV
 
-      - name: Setup Java 17
+      - name: Setup Java 21
         script: |
           sudo apt update
-          sudo apt install -y openjdk-17-jdk
-          sudo update-alternatives --set java /usr/lib/jvm/java-17-openjdk-amd64/bin/java
+          sudo apt install -y openjdk-21-jdk
+          sudo update-alternatives --set java /usr/lib/jvm/java-21-openjdk-amd64/bin/java
           java -version
 
       - name: Setup Gradle
@@ -148,3 +148,8 @@ launch-templates:
           sudo apt install -y openjdk-21-jdk
           sudo update-alternatives --set java /usr/lib/jvm/java-21-openjdk-amd64/bin/java
           java -version
+
+      - name: Setup Gradle
+        script: |
+          ./gradlew wrapper
+          ./gradlew --version

.nx/workflows/dynamic-changesets.yaml

@@ -1,14 +1,35 @@
 distribute-on:
-  default: auto linux-medium, 1 linux-extra-large
+  default: auto linux-large, 1 linux-extra-large
 assignment-rules:
+  # e2e-release tests must run sequentially due to shared git state and publishing operations
+  - projects:
+      - e2e-release
+    targets:
+      - e2e-ci**
+    run-on:
+      - agent: linux-large
+        parallelism: 1
+
+  - projects:
+      - e2e-gradle
+    targets:
+      - e2e-ci**
+    run-on:
+        - agent: linux-large
+          parallelism: 1
+        - agent: linux-extra-large
+          parallelism: 1
+
+  # All other e2e tests can run in parallel
   - targets:
       - e2e-ci**
     run-on:
-      - agent: linux-medium
-        parallelism: 1
+      - agent: linux-large
+        parallelism: 2
       - agent: linux-extra-large
-        parallelism: 1
+        parallelism: 3
 
+  # These projects should not need to be isolated.
   - projects:
       - nx-dev
     targets:
@@ -16,17 +37,25 @@ assignment-rules:
     run-on:
       - agent: linux-extra-large
         parallelism: 1
+  - projects:
+      - angular
+      - react
+    targets:
+      - test
+    run-on:
+      - agent: linux-extra-large
+        parallelism: 1
 
   - targets:
       - lint
     run-on:
-      - agent: linux-medium
+      - agent: linux-large
         parallelism: 6
 
   - targets:
       - '*'
     run-on:
-      - agent: linux-medium
+      - agent: linux-large
         parallelism: 3
       - agent: linux-extra-large
         parallelism: 3

.pnpmrc

@@ -0,0 +1,13 @@
+# Enable pre/post-install which are disabled by default. Installing peer deps which is also disabled by default
+auto-install-peers=true
+enable-pre-post-scripts=true
+
+# Enable lifecycle scripts for specific packages that require them (like post-install)
+enable-scripts=@napi-rs/canvas,sharp,@swc/core,@swc/cli,@swc-node/register,esbuild
+
+# Compatibility
+strict-peer-dependencies=false
+lockfile-version-strict=false
+
+# Consistency across environments
+use-node-version=20.19.0 

.prettierignore

@@ -51,3 +51,6 @@ CODEOWNERS
 /.nx/workflows/dynamic-changesets.yaml
 _files
 _solution
+
+# this file uses TS import attributes which the current prettier version does not support
+tools/documentation/create-embeddings/src/main.mts

.upstreamdocs.json

@@ -0,0 +1,10 @@
+{
+  "include": ["apps/**/*", "libs/**/*", "packages/**/*"],
+  "exclude": [
+    "**/*.spec.*",
+    "**/test/**/*",
+    "**/__tests__/**/*",
+    "**/*.test.*",
+    "node_modules/**/*"
+  ]
+}

.verdaccio/config.yml

@@ -5,7 +5,7 @@ auth:
   htpasswd:
     file: ./htpasswd
 
-max_body_size: 15mb
+max_body_size: 20mb
 
 # a list of other known repositories we can talk to
 uplinks:

CLAUDE.md

@@ -0,0 +1,184 @@
+When responding to queries about this repository:
+
+1. Use the `nx_workspace` mcp tool for understanding the workspace architecture when appropriate
+2. When working in projects, use the `nx_project` mcp tool to analyze and understand the specific project structure and
+   dependencies
+3. Suggest relevant commands from the "Essential Commands" section when applicable
+4. Highlight Nx's focus on monorepos and its key features like smart task execution, code generation, and project graph
+   analysis
+5. Mention the plugin ecosystem and support for various frameworks when relevant
+6. Emphasize the importance of running the full validation suite before committing changes
+
+Always strive to provide accurate, helpful responses that align with the best practices and workflows described in this
+file.
+
+## GitHub Issue Response Mode
+
+When responding to GitHub issues, determine your approach based on how the request is phrased:
+
+### Plan-First Mode (Default)
+
+Use this approach when users ask you to:
+
+- "analyze", "investigate", "assess", "review", "examine", or "plan"
+- Or when the request is ambiguous
+
+In this mode:
+
+1. Provide a detailed analysis of the issue
+2. Create a comprehensive implementation plan
+3. Break down the solution into clear steps
+4. Then please post the plan as a comment on the issue
+
+### Immediate Implementation Mode
+
+Use this approach when users ask you to:
+
+- "fix", "implement", "solve", "build", "create", "update", or "add"
+- Or when they explicitly request immediate action
+
+In this mode:
+
+1. Analyze the issue quickly
+2. Implement the complete solution immediately
+3. Make all necessary code changes. Please make multiple commits so that the changes are easier to review.
+4. Run appropriate tests and validation
+5. If the tests, are not passing, please fix the issues and continue doing this up to 3 more times until the tests pass
+6. Once the tests pass, push a branch and then suggest opening a PR which has a description of the changes made, and
+   that
+   it make sure that it explicitly says "Fixes #ISSUE_NUMBER" to automatically close the issue when the PR is merged.
+
+## Avoid making changes to generated files
+
+Files under `generated` directories are generated based on a different source file and should not be modified directly.
+Find the underlying source and modify that instead.
+
+## Essential Commands
+
+### Code Formatting
+
+After code changes are made, please make sure to format the files with prettier via `npx prettier -- FILE_NAME`
+
+### Pre-push Validation
+
+```bash
+# Full validation suite - run before committing
+nx prepush
+```
+
+If the prepush validation suite fails, please fix the issues before proceeding with your work. This ensures that all
+code adheres to the project's standards and passes all tests. DO NOT make a new commit to fix these issues. Instead,
+amend the current commit.
+
+### Testing Changes
+
+After code changes are made, first test the specific project where the changes were made:
+
+```bash
+nx run-many -t test,build,lint -p PROJECT_NAME
+```
+
+After verifying the individual project, validate that the changes in projects which have been affected:
+
+```bash
+# Test only affected projects (recommended for development)
+nx affected -t build,test,lint
+```
+
+As the last step, run the e2e tests to fully ensure that changes are valid:
+
+```bash
+# Run affected e2e tests (recommended for development)
+nx affected -t e2e-local
+```
+
+## Fixing GitHub Issues
+
+When working on a GitHub issue, follow this systematic approach:
+
+### 1. Get Issue Details
+
+```bash
+# Get issue details using GitHub CLI (replace ISSUE_NUMBER with actual number)
+gh issue view ISSUE_NUMBER
+
+# View multiple issues efficiently in one command
+gh issue list --limit 50 --json number,title,state,labels,assignees,updatedAt,body --jq '.[] | select(.number == 123 or .number == 456 or .number == 789)'
+
+# Or filter by specific criteria to get multiple related issues
+gh issue list --label "bug" --state "open" --json number,title,body,labels --jq '.[]'
+gh issue list --assignee "@me" --json number,title,body,state --jq '.[]'
+```
+
+**Tip**: Instead of running `gh issue view` multiple times, use `gh issue list` with JSON output and filtering to gather
+information about multiple issues in a single command. This is much more efficient than viewing issues one at a time.
+
+**Always provide clickable links**: When discussing GitHub issues or PRs, always include the full GitHub URL so the user
+can easily open them in their browser. For example:
+
+- Issue #12345: https://github.com/nrwl/nx/issues/12345
+- PR #67890: https://github.com/nrwl/nx/pull/67890
+
+When cloning reproduction repos, please clone within `./tmp/claude/repro-ISSUE_NUMBER`
+
+### 2. Analyze the Plan
+
+- Look for a plan or implementation details in the issue description
+- Check comments for additional context or clarification
+- Identify affected projects and components
+
+### 3. Implement the Solution
+
+- Follow the plan outlined in the issue
+- Make focused changes that address the specific problem
+- Ensure code follows existing patterns and conventions
+
+### 4. Run Full Validation
+
+Use the testing workflow from the "Essential Commands" section.
+
+### 5. Submit Pull Request
+
+- Create a descriptive PR title that references the issue
+- **Always fill in the PR template** - don't leave it empty
+- Include "Fixes #ISSUE_NUMBER" in the PR description
+- Provide a clear summary of changes made
+- Request appropriate reviewers
+
+## Pull Request Template
+
+**IMPORTANT**: When creating a pull request, you MUST fill in the template found in `.github/PULL_REQUEST_TEMPLATE.md`.
+Do not leave the template sections empty. The template includes:
+
+### Required Sections
+
+1. **Current Behavior**: Describe the behavior we have today
+2. **Expected Behavior**: Describe the behavior we should expect with the changes in this PR
+3. **Related Issue(s)**: Link the issue being fixed so it gets closed when the PR is merged
+
+### Template Format
+
+```markdown
+## Current Behavior
+
+<!-- This is the behavior we have today -->
+
+## Expected Behavior
+
+<!-- This is the behavior we should expect with the changes in this PR -->
+
+## Related Issue(s)
+
+<!-- Please link the issue being fixed so it gets closed when this is merged. -->
+
+Fixes #ISSUE_NUMBER
+```
+
+### Guidelines
+
+- Ensure your commit message follows the conventional commit format (use `pnpm commit`)
+  - Use `fix:`, `feat:`, `chore:`, etc. as appropriate types.
+  - Scope is **required** for all commits. Possible scopes are listed in `scripts/commitizen.js`.
+- Read the submission guidelines in CONTRIBUTING.md before posting
+- For complex changes, you can request a dedicated Nx release by mentioning the Nx team
+- Always link the related issue using "Fixes #ISSUE_NUMBER" to automatically close it when merged

CODEOWNERS

@@ -9,9 +9,10 @@ pnpm-lock.yaml @nrwl/nx-core-reviewers
 rust-toolchain.toml @nrwl/nx-native-reviewers
 
 # Docs Site + Graph
+/astro-docs @nrwl/nx-docs-reviewers
 /docs @nrwl/nx-docs-reviewers
 /docs/nx-cloud @StalkAltan @rarmatei @nixallover @nrwl/nx-docs-reviewers
-/graph/** @philipjfulcher @FrozenPandaz @bcabanes @MaxKless @xiongemi
+/graph/** @philipjfulcher @FrozenPandaz @bcabanes @MaxKless @Coly010 @jaysoo
 /images @nrwl/nx-docs-reviewers
 /nx-dev/** @nrwl/nx-docs-reviewers
 /typedoc-theme @nrwl/nx-docs-reviewers
@@ -22,6 +23,9 @@ rust-toolchain.toml @nrwl/nx-native-reviewers
 /docs/generated/packages/angular/** @nrwl/nx-angular-reviewers @nrwl/nx-docs-reviewers
 /docs/shared/packages/angular/** @nrwl/nx-angular-reviewers @nrwl/nx-docs-reviewers
 /packages/angular/** @nrwl/nx-angular-reviewers
+/packages/angular-rspack/** @nrwl/nx-angular-reviewers
+/packages/angular-rspack-compiler/** @nrwl/nx-angular-reviewers
+/examples/angular-rspack/** @nrwl/nx-angular-reviewers
 /e2e/angular/** @nrwl/nx-angular-reviewers
 /packages/angular/plugins/component-testing.ts @nrwl/nx-angular-reviewers @nrwl/nx-testing-tools-reviewers
 /packages/angular/src/generators/cypress-component-configuration/** @nrwl/nx-angular-reviewers @nrwl/nx-testing-tools-reviewers
@@ -137,6 +141,9 @@ rust-toolchain.toml @nrwl/nx-native-reviewers
 /packages/storybook/** @nrwl/nx-storybook-reviewers
 /e2e/storybook/** @nrwl/nx-storybook-reviewers
 
+# Docker
+/packages/docker/** @nrwl/nx-core-reviewers @Coly010
+
 ## Devkit
 /docs/generated/devkit/** @nrwl/nx-devkit-reviewers @nrwl/nx-docs-reviewers
 /docs/generated/packages/devkit/** @nrwl/nx-devkit-reviewers @nrwl/nx-docs-reviewers
@@ -145,8 +152,8 @@ rust-toolchain.toml @nrwl/nx-native-reviewers
 /packages/devkit/public-api.ts @FrozenPandaz @vsavkin
 
 # Gradle
-/packages/gradle/** @FrozenPandaz @MaxKless @xiongemi
-/e2e/gradle/** @FrozenPandaz @MaxKless @xiongemi
+/packages/gradle/** @FrozenPandaz @MaxKless @lourw
+/e2e/gradle/** @FrozenPandaz @MaxKless @lourw
 
 # Nx-Plugin
 /docs/generated/packages/plugin/** @nrwl/nx-devkit-reviewers @nrwl/nx-docs-reviewers
@@ -174,10 +181,10 @@ rust-toolchain.toml @nrwl/nx-native-reviewers
 
 # Misc
 /e2e/lerna-smoke-tests/** @vsavkin @JamesHenry
-/e2e/utils/** @meeroslav @nrwl/nx-testing-tools-reviewers @vsavkin @mandarini
+/e2e/utils/** @meeroslav @nrwl/nx-testing-tools-reviewers @vsavkin
 /community @nrwl/nx-docs-reviewers
-/CONTRIBUTING.md @FrozenPandaz @isaacplmann
-/CODE_OF_CONDUCT.md @FrozenPandaz @isaacplmann
+/CONTRIBUTING.md @FrozenPandaz
+/CODE_OF_CONDUCT.md @FrozenPandaz
 /CODEOWNERS @FrozenPandaz @AgentEnder
 /packages/nx/src/nx-cloud/utilities/url-shorten.ts @MaxKless
 
@@ -191,6 +198,11 @@ rust-toolchain.toml @nrwl/nx-native-reviewers
 /.husky/** @nrwl/nx-pipelines-reviewers
 /packages/workspace/src/generators/ci-workflow/** @nrwl/nx-pipelines-reviewers
 
+# Claude AI Integration
+CLAUDE.md @FrozenPandaz
+.claude/** @FrozenPandaz
+.mcp.json @FrozenPandaz
+
 # Global Files
 project.json @FrozenPandaz @vsavkin
 jest.config.ts @nrwl/nx-testing-tools-reviewers @FrozenPandaz

CONTRIBUTING.md

@@ -27,14 +27,25 @@ can [submit a Pull Request](https://github.com/nrwl/nx/blob/master/CONTRIBUTING.
 
 Source code and documentation are included in the top-level folders listed below.
 
-- `docs` - Markdown and configuration files for documentation including tutorials, guides for each supported platform,
-  and API docs.
-- `e2e` - E2E tests.
 - `packages` - Source code for Nx packages such as Angular, React, Web, NestJS, Next and others including generators and
   executors (or builders).
+- `e2e` - E2E tests for the Nx packages
+- `graph` - Source code for the Nx Graph application which shows the project graph, task graph, project details, and more in the browser.
+- `docs` - Markdown and configuration files for documentation including tutorials, guides for each supported platform,
+  and API docs.
+- `nx-dev` - Source code for the Nx documentation site which displays the markdown in `docs` and more.
+- `tools` - Workspace-specific tooling and plugins
 - `scripts` - Miscellaneous scripts for project tasks such as building documentation, testing, and code formatting.
 - `tmp` - Folder used by e2e tests. If you are a WebStorm user, make sure to mark this folder as excluded.
 
+## Technologies
+
+This repo contains a mix of different technologies, including:
+
+- **Rust**: The core of Nx is written in Rust, which provides performance and safety.
+- **TypeScript**: The primary language for Nx packages and the Nx DevKit.
+- **Kotlin**: Used for the Gradle and Java plugins.
+
 ## Development Workstation Setup
 
 If you are using `VSCode`, and provided you have [Docker](https://docker.com) installed on your machine, then you can leverage [Dev Containers](https://containers.dev) through this [VSCode extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers), to easily setup your development environment, with everything needed to contribute to Nx, already installed (namely `NodeJS`, `Yarn`, `Rust`, `Cargo`, plus some useful extensions like `Nx Console`).
@@ -333,6 +344,7 @@ The scope must be one of the following:
 - express - anything Express specific
 - js - anything related to @nx/js package or general js/ts support
 - linter - anything Linter specific
+- module-federation - anything Nx Module Federation specific
 - nest - anything Nest specific
 - nextjs - anything Next specific
 - node - anything Node specific
@@ -374,6 +386,57 @@ To simplify and automate the process of committing with this format,
 **Nx is a [Commitizen](https://github.com/commitizen/cz-cli) friendly repository**, just do `git add` and
 execute `pnpm commit`.
 
+##### Using the Interactive Commit Tool
+
+Instead of `git commit`, use:
+
+```bash
+pnpm commit
+```
+
+This will launch an interactive prompt that will:
+
+1. Ask you to select the type of change (feat, fix, docs, cleanup, chore)
+2. Let you choose the appropriate scope from the predefined list
+3. Guide you through writing a clear, descriptive commit message
+4. Ensure your commit follows the conventional commit format
+
+##### Available Commit Types
+
+- **feat**: A new feature
+- **fix**: A bug fix
+- **docs**: Documentation only changes
+- **cleanup**: A code change that neither fixes a bug nor adds a feature
+- **chore**: Other changes that don't modify src or test files
+
+##### Available Scopes
+
+The repository includes many predefined scopes. Use the one which is most specific to the changes being committed
+
+- **core**: anything Nx core specific
+- **angular**: anything Angular specific
+- **react**: anything React specific
+- **nextjs**: anything Next specific
+- **node**: anything Node specific
+- **devkit**: devkit-related changes
+- **graph**: anything graph app specific
+- **testing**: anything testing specific (e.g. jest or cypress)
+- **misc**: misc stuff
+- **repo**: anything related to managing the repo itself
+- **nx-dev**: anything related to docs infrastructure
+
+For the complete list of available scopes, see `/scripts/commitizen.js`.
+
+##### Example Commits
+
+```bash
+feat(core): add new project graph visualization
+fix(angular): resolve build issues with standalone components
+docs(misc): update contributing guidelines
+chore(repo): bump dependencies
+cleanup(devkit): refactor utility functions for better readability
+```
+
 #### PR releases
 
 If you are working on a particularly complex change or feature addition, you can request a dedicated Nx release for the associated pull request branch. Mention someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they will confirm if the PR warrants its own release for testing purposes, and generate it for you if appropriate.

Cargo.lock

@@ -1527,26 +1527,30 @@ dependencies = [
  "hyper-util",
  "log",
  "rustls",
+ "rustls-native-certs",
  "rustls-pki-types",
  "tokio",
  "tokio-rustls",
  "tower-service",
- "webpki-roots",
 ]
 
 [[package]]
 name = "hyper-util"
-version = "0.1.11"
+version = "0.1.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "497bbc33a26fdd4af9ed9c70d63f61cf56a938375fbb32df34db9b1cd6d643f2"
+checksum = "7f66d5bd4c6f02bf0542fad85d626775bab9258cf795a4256dcaf3161114d1df"
 dependencies = [
+ "base64",
  "bytes",
  "futures-channel",
+ "futures-core",
  "futures-util",
  "http",
  "http-body",
  "hyper",
+ "ipnet",
  "libc",
+ "percent-encoding",
  "pin-project-lite",
  "socket2",
  "tokio",
@@ -1756,6 +1760,16 @@ version = "2.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "469fb0b9cefa57e3ef31275ee7cacb78f2fdca44e4765491884a2b119d4eb130"
 
+[[package]]
+name = "iri-string"
+version = "0.7.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dbc5ebe9c3a1a7a5127f920a418f7585e9e758e911d0466ed004f393b0e380b2"
+dependencies = [
+ "memchr",
+ "serde",
+]
+
 [[package]]
 name = "is-macro"
 version = "0.3.5"
@@ -2086,12 +2100,6 @@ dependencies = [
  "syn 2.0.100",
 ]
 
-[[package]]
-name = "mime"
-version = "0.3.17"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"
-
 [[package]]
 name = "minimal-lexical"
 version = "0.2.1"
@@ -2309,11 +2317,10 @@ dependencies = [
 
 [[package]]
 name = "num-bigint"
-version = "0.4.4"
+version = "0.4.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "608e7659b5c3d7cba262d894801b9ec9d00de989e8a82bd4bef91d08da45cdc0"
+checksum = "a5e44f723f1133c9deac646763579fdb3ac745e418f2a7af9cd0c431da1f20b9"
 dependencies = [
- "autocfg",
  "num-integer",
  "num-traits",
  "serde",
@@ -3018,30 +3025,26 @@ dependencies = [
 
 [[package]]
 name = "reqwest"
-version = "0.12.15"
+version = "0.12.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d19c46a6fdd48bc4dab94b6103fccc55d34c67cc0ad04653aad4ea2a07cd7bbb"
+checksum = "cbc931937e6ca3a06e3b6c0aa7841849b160a90351d6ab467a8b9b9959767531"
 dependencies = [
  "base64",
  "bytes",
  "futures-core",
- "futures-util",
  "http",
  "http-body",
  "http-body-util",
  "hyper",
  "hyper-rustls",
  "hyper-util",
- "ipnet",
  "js-sys",
  "log",
- "mime",
- "once_cell",
  "percent-encoding",
  "pin-project-lite",
  "quinn",
  "rustls",
- "rustls-pemfile",
+ "rustls-native-certs",
  "rustls-pki-types",
  "serde",
  "serde_json",
@@ -3050,13 +3053,12 @@ dependencies = [
  "tokio",
  "tokio-rustls",
  "tower",
+ "tower-http",
  "tower-service",
  "url",
  "wasm-bindgen",
  "wasm-bindgen-futures",
  "web-sys",
- "webpki-roots",
- "windows-registry",
 ]
 
 [[package]]
@@ -3187,15 +3189,6 @@ dependencies = [
  "security-framework",
 ]
 
-[[package]]
-name = "rustls-pemfile"
-version = "2.2.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dce314e5fee3f39953d46bb63bb8a46d40c2f8fb7cc5a3b6cab2bde9721d6e50"
-dependencies = [
- "rustls-pki-types",
-]
-
 [[package]]
 name = "rustls-pki-types"
 version = "1.11.0"
@@ -4093,6 +4086,24 @@ dependencies = [
  "tower-service",
 ]
 
+[[package]]
+name = "tower-http"
+version = "0.6.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adc82fd73de2a9722ac5da747f12383d2bfdb93591ee6c58486e0097890f05f2"
+dependencies = [
+ "bitflags 2.9.0",
+ "bytes",
+ "futures-util",
+ "http",
+ "http-body",
+ "iri-string",
+ "pin-project-lite",
+ "tower",
+ "tower-layer",
+ "tower-service",
+]
+
 [[package]]
 name = "tower-layer"
 version = "0.3.3"
@@ -4605,15 +4616,6 @@ dependencies = [
  "rustls-pki-types",
 ]
 
-[[package]]
-name = "webpki-roots"
-version = "0.26.8"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2210b291f7ea53617fbafcc4939f10914214ec15aace5ba62293a668f322c5c9"
-dependencies = [
- "rustls-pki-types",
-]
-
 [[package]]
 name = "weezl"
 version = "0.1.8"
@@ -4687,7 +4689,7 @@ checksum = "d2ed2439a290666cd67ecce2b0ffaad89c2a56b976b736e6ece670297897832d"
 dependencies = [
  "windows-implement",
  "windows-interface",
- "windows-result 0.1.2",
+ "windows-result",
  "windows-targets 0.52.6",
 ]
 
@@ -4719,17 +4721,6 @@ version = "0.1.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "76840935b766e1b0a05c0066835fb9ec80071d4c09a16f6bd5f7e655e3c14c38"
 
-[[package]]
-name = "windows-registry"
-version = "0.4.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4286ad90ddb45071efd1a66dfa43eb02dd0dfbae1545ad6cc3c51cf34d7e8ba3"
-dependencies = [
- "windows-result 0.3.2",
- "windows-strings",
- "windows-targets 0.53.0",
-]
-
 [[package]]
 name = "windows-result"
 version = "0.1.2"
@@ -4739,24 +4730,6 @@ dependencies = [
  "windows-targets 0.52.6",
 ]
 
-[[package]]
-name = "windows-result"
-version = "0.3.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c64fd11a4fd95df68efcfee5f44a294fe71b8bc6a91993e2791938abcc712252"
-dependencies = [
- "windows-link",
-]
-
-[[package]]
-name = "windows-strings"
-version = "0.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "87fa48cc5d406560701792be122a10132491cff9d0aeb23583cc2dcafc847319"
-dependencies = [
- "windows-link",
-]
-
 [[package]]
 name = "windows-sys"
 version = "0.45.0"
@@ -4832,29 +4805,13 @@ dependencies = [
  "windows_aarch64_gnullvm 0.52.6",
  "windows_aarch64_msvc 0.52.6",
  "windows_i686_gnu 0.52.6",
- "windows_i686_gnullvm 0.52.6",
+ "windows_i686_gnullvm",
  "windows_i686_msvc 0.52.6",
  "windows_x86_64_gnu 0.52.6",
  "windows_x86_64_gnullvm 0.52.6",
  "windows_x86_64_msvc 0.52.6",
 ]
 
-[[package]]
-name = "windows-targets"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1e4c7e8ceaaf9cb7d7507c974735728ab453b67ef8f18febdd7c11fe59dca8b"
-dependencies = [
- "windows_aarch64_gnullvm 0.53.0",
- "windows_aarch64_msvc 0.53.0",
- "windows_i686_gnu 0.53.0",
- "windows_i686_gnullvm 0.53.0",
- "windows_i686_msvc 0.53.0",
- "windows_x86_64_gnu 0.53.0",
- "windows_x86_64_gnullvm 0.53.0",
- "windows_x86_64_msvc 0.53.0",
-]
-
 [[package]]
 name = "windows_aarch64_gnullvm"
 version = "0.42.2"
@@ -4873,12 +4830,6 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
 
-[[package]]
-name = "windows_aarch64_gnullvm"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "86b8d5f90ddd19cb4a147a5fa63ca848db3df085e25fee3cc10b39b6eebae764"
-
 [[package]]
 name = "windows_aarch64_msvc"
 version = "0.42.2"
@@ -4897,12 +4848,6 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
 
-[[package]]
-name = "windows_aarch64_msvc"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c7651a1f62a11b8cbd5e0d42526e55f2c99886c77e007179efff86c2b137e66c"
-
 [[package]]
 name = "windows_i686_gnu"
 version = "0.42.2"
@@ -4921,24 +4866,12 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
 
-[[package]]
-name = "windows_i686_gnu"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c1dc67659d35f387f5f6c479dc4e28f1d4bb90ddd1a5d3da2e5d97b42d6272c3"
-
 [[package]]
 name = "windows_i686_gnullvm"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
 
-[[package]]
-name = "windows_i686_gnullvm"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ce6ccbdedbf6d6354471319e781c0dfef054c81fbc7cf83f338a4296c0cae11"
-
 [[package]]
 name = "windows_i686_msvc"
 version = "0.42.2"
@@ -4957,12 +4890,6 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
 
-[[package]]
-name = "windows_i686_msvc"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "581fee95406bb13382d2f65cd4a908ca7b1e4c2f1917f143ba16efe98a589b5d"
-
 [[package]]
 name = "windows_x86_64_gnu"
 version = "0.42.2"
@@ -4981,12 +4908,6 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
 
-[[package]]
-name = "windows_x86_64_gnu"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2e55b5ac9ea33f2fc1716d1742db15574fd6fc8dadc51caab1c16a3d3b4190ba"
-
 [[package]]
 name = "windows_x86_64_gnullvm"
 version = "0.42.2"
@@ -5005,12 +4926,6 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
 
-[[package]]
-name = "windows_x86_64_gnullvm"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0a6e035dd0599267ce1ee132e51c27dd29437f63325753051e71dd9e42406c57"
-
 [[package]]
 name = "windows_x86_64_msvc"
 version = "0.42.2"
@@ -5029,12 +4944,6 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
 
-[[package]]
-name = "windows_x86_64_msvc"
-version = "0.53.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "271414315aff87387382ec3d271b52d7ae78726f5d44ac98b4f4030c91880486"
-
 [[package]]
 name = "winnow"
 version = "0.5.40"

README.md

@@ -1,7 +1,7 @@
 <p style="text-align: center;">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-dark.svg">
-    <img alt="Nx - Smart Monorepos · Fast CI" src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-light.svg" width="100%">
+    <img alt="Nx - Smart Repos · Fast Builds" src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-light.svg" width="100%">
   </picture>
 </p>
 
@@ -19,9 +19,9 @@
 
 <hr>
 
-# Smart Monorepos · Fast CI
+# Smart Repos · Fast Builds
 
-Build system, optimized for monorepos, with AI-powered architectural awareness and advanced CI capabilities.
+An AI-first build platform that connects everything from your editor to CI. Helping you deliver fast, without breaking things.
 
 Create a new Nx workspace with
 
@@ -35,7 +35,7 @@ npx create-nx-workspace
 npx nx init
 ```
 
-to add Nx to your existing workspace to get faster task scheduling, caching and more. More [in the docs](https://nx.dev/getting-started/intro#try-nx-yourself).
+to add Nx to your existing workspace to get faster task scheduling, caching and more. More [in the docs](https://nx.dev/getting-started/intro).
 
 ## Learn about CI with Nx Cloud
 
@@ -58,7 +58,7 @@ Learn more in the [Nx CI docs &raquo;](https://nx.dev/ci/intro?utm_source=nxrepo
 - [Our Twitter/X](https://x.com/nxdevtools)
 
 <p style="text-align: center;"><a href="https://www.youtube.com/@nxdevtools/videos" target="_blank" rel="noreferrer"><img src="./images/nx-courses-and-videos.svg" 
-width="100%" alt="Nx - Smart Monorepos · Fast CI"></a></p>
+width="100%" alt="Nx - Smart Repos · Fast Builds"></a></p>
 
 ## Want to help?
 
@@ -82,17 +82,17 @@ help you get started.
 | ![James Henry](https://avatars.githubusercontent.com/u/900523?s=160&v=4) | ![Jon Cammisuli](https://avatars2.githubusercontent.com/u/4332460?s=160) | ![Isaac Mann](https://avatars1.githubusercontent.com/u/861504?s=160) | ![Juri Strumpflohner](https://avatars1.githubusercontent.com/u/542458?s=160) |
 | [JamesHenry](https://github.com/JamesHenry)                              | [cammisuli](https://github.com/cammisuli)                                | [isaacplmann](https://github.com/isaacplmann)                        | [juristr](https://github.com/juristr)                                        |
 
-| Philip Fulcher                                                            | Caleb Ukle                                                            | Katerina Skroumpelou                                                            | Colum Ferry                                                            |
-| ------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| ![Philip Fulcher](https://avatars1.githubusercontent.com/u/1536471?s=160) | ![Caleb Ukle](https://avatars.githubusercontent.com/u/23272162?s=160) | ![Katerina Skroumpelou](https://avatars0.githubusercontent.com/u/6603745?s=160) | ![Colum Ferry](https://avatars.githubusercontent.com/u/12140467?s=160) |
-| [philipjfulcher](https://github.com/philipjfulcher)                       | [barbados-clemens](https://github.com/barbados-clemens)               | [mandarini](https://github.com/mandarini)                                       | [Coly010](https://github.com/Coly010)                                  |
+| Philip Fulcher                                                            | Caleb Ukle                                                            | Colum Ferry                                                            | Emily Xiong                                                            |
+| ------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| ![Philip Fulcher](https://avatars1.githubusercontent.com/u/1536471?s=160) | ![Caleb Ukle](https://avatars.githubusercontent.com/u/23272162?s=160) | ![Colum Ferry](https://avatars.githubusercontent.com/u/12140467?s=160) | ![Emily Xiong](https://avatars.githubusercontent.com/u/16211801?s=160) |
+| [philipjfulcher](https://github.com/philipjfulcher)                       | [barbados-clemens](https://github.com/barbados-clemens)               | [Coly010](https://github.com/Coly010)                                  | [xiongemi](https://github.com/xiongemi)                                |
 
-| Emily Xiong                                                            | Miroslav Jonaš                                                          | Leosvel Pérez Espinosa                                                            | Zachary DeRose                                                           |
-| ---------------------------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
-| ![Emily Xiong](https://avatars.githubusercontent.com/u/16211801?s=160) | ![Miroslav Jonaš](https://avatars.githubusercontent.com/u/881612?s=160) | ![Leosvel Pérez Espinosa](https://avatars.githubusercontent.com/u/12051310?s=160) | ![Zachary DeRose](https://avatars.githubusercontent.com/u/3788405?s=160) |
-| [xiongemi](https://github.com/xiongemi)                                | [meeroslav](https://github.com/meeroslav)                               | [leosvelperez](https://github.com/leosvelperez)                                   | [ZackDeRose](https://github.com/ZackDeRose)                              |
+| Miroslav Jonaš                                                          | Leosvel Pérez Espinosa                                                            | Zachary DeRose                                                           | Craigory Coppola                                                           |
+| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
+| ![Miroslav Jonaš](https://avatars.githubusercontent.com/u/881612?s=160) | ![Leosvel Pérez Espinosa](https://avatars.githubusercontent.com/u/12051310?s=160) | ![Zachary DeRose](https://avatars.githubusercontent.com/u/3788405?s=160) | ![Craigory Coppola](https://avatars.githubusercontent.com/u/6933928?s=160) |
+| [meeroslav](https://github.com/meeroslav)                               | [leosvelperez](https://github.com/leosvelperez)                                   | [ZackDeRose](https://github.com/ZackDeRose)                              | [AgentEnder](https://github.com/AgentEnder)                                |
 
-| Craigory Coppola                                                           | Chau Tran                                                            | Nicholas Cunningham                                                          | Max Kless                                                            |
-| -------------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| ![Craigory Coppola](https://avatars.githubusercontent.com/u/6933928?s=160) | ![Chau Tran](https://avatars.githubusercontent.com/u/25516557?s=160) | ![Nicholas Cunningham](https://avatars.githubusercontent.com/u/338948?s=160) | ![Max Kless](https://avatars.githubusercontent.com/u/34165455?s=160) |
-| [AgentEnder](https://github.com/AgentEnder)                                | [nartc](https://github.com/nartc)                                    | [ndcunningham](https://github.com/ndcunningham)                              | [MaxKless](https://github.com/MaxKless)                              |
+| Chau Tran                                                            | Nicholas Cunningham                                                          | Max Kless                                                            |
+| -------------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| ![Chau Tran](https://avatars.githubusercontent.com/u/25516557?s=160) | ![Nicholas Cunningham](https://avatars.githubusercontent.com/u/338948?s=160) | ![Max Kless](https://avatars.githubusercontent.com/u/34165455?s=160) |
+| [nartc](https://github.com/nartc)                                    | [ndcunningham](https://github.com/ndcunningham)                              | [MaxKless](https://github.com/MaxKless)                              |

SECURITY.md

@@ -0,0 +1,15 @@
+# Security Policy
+
+Nx/Nrwl takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations.
+
+If you believe you have found a security vulnerability in any Nx-owned repository that meets Nx's definition of a security vulnerability, please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Security Team at security@nrwl.io.
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message.
+
+Nx follows the principle of Coordinated Vulnerability Disclosure.

astro-docs/.gitignore

@@ -0,0 +1,24 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# Local Netlify folder
+.netlify

astro-docs/README.md

@@ -0,0 +1,235 @@
+# Nx Documentation Site
+
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+
+The Nx documentation site built with Astro and Starlight, featuring advanced content management through Markdoc and dynamic plugin documentation generation.
+
+## Architecture Overview
+
+This documentation site leverages Astro's static site generation capabilities with Starlight for documentation-specific features. The architecture consists of:
+
+### Core Technologies
+
+- [**Astro**](https://docs.astro.build) - Static site generator with island architecture
+- [**Starlight**](https://starlight.astro.build) - Documentation theme with built-in navigation, search, and i18n
+- **React** - For implementing UI components
+- **Netlify** - Deployment and hosting
+
+### Key Features
+
+- [Markdoc](https://markdoc.dev) with custom tags for rich content such as videos, graphs, etc.
+- TailwindCSS for styling in Astro and React components
+- Dynamic API documentation generation from Nx packages and CLI commands
+- Community plugin registry
+
+## Project Structure
+
+```
+astro-docs/
+├── src/
+│   ├── assets/          # Images and static assets to be optimized by Astro
+│   │   ├── nx/          # Nx branding assets
+│   │   ├── nx-cloud/    # Nx Cloud assets
+│   │   └── nx-console/  # Nx Console assets
+│   ├── components/      # React and Astro components
+│   │   ├── layout/      # Layout components (e.g. Sidebar)
+│   │   ├── markdoc/     # Markdoc tag components
+│   │   └── utils/       # Utility functions
+│   ├── content/         # Documentation content
+│   │   ├── docs/        # Main documentation files (.mdoc, .mdx)
+│   │   ├── approved-community-plugins.json               # Powers plugin registry
+│   │   └── notifications.json                            # Notifications banners for docs site
+│   ├── pages/           # Dynamic pages and routes (e.g. devkit)
+│   ├── plugins/         # Content loaders and plugins
+│   │   ├── *.loader.ts  # Dynamic content loaders (e.g. CLI commands and API docs generation)
+│   │   └── utils/       # Plugin utilities
+│   └── styles/          # Global styles
+├── public/              # Static assets not to be optimized by Astro (fonts, robots.txt)
+├── astro.config.mjs     # Astro configuration
+├── markdoc.config.mjs   # Markdoc tags configuration
+├── sidebar.mts          # Sidebar structure definition
+└── package.json
+```
+
+## Plugins and Loaders
+
+### Content Loaders
+
+The site uses custom content loaders to dynamically generate documentation:
+
+- **PluginLoader** (`plugin.loader.ts`) - Generates official plugin documentation (generators, executors, migrations)
+- **CommunityPluginsLoader** (`community-plugins.loader.ts`) - Generates data for plugin registry (e.g. GitHub stars, npm downloads)
+- **NxReferencePackagesLoader** (`nx-reference-packages.loader.ts`) - Generated data for CNW, Devkit, nx cli (e.g. nx core related things)
+
+## Content Management
+
+### Content Types
+
+1. **Regular Documentation** (`src/content/docs/`)
+
+   - Written in `.mdoc` (Markdoc) or `.mdx` (MDX) format
+   - Organized by sections: getting-started, concepts, guides, api
+   - File-based routing (filename = URL path)
+
+2. **Dynamic Plugin Documentation**
+
+   - Auto-generated from Nx packages
+   - Includes generators, executors, and migrations
+   - Updated during build process
+   - **Note**: Requires a rebuild and restart to reflect changes
+
+3. **CLI Documentation**
+   - Auto-generated from Nx CLI commands
+   - Parsed from actual CLI implementation
+   - **Note**: Requires a rebuild and restart to reflect changes
+
+### Markdoc Tags
+
+The site includes custom Markdoc tags for rich content.
+
+**Note**: Starlight supports many Markdown and Markdoc features, such as code blocks, asides, etc.
+
+- https://starlight.astro.build/components/using-components/#using-a-component-in-markdoc
+- https://starlight.astro.build/guides/authoring-content
+
+#### Layout & Organization
+
+- `{% aside %}` - Highlighted information boxes
+- `{% cardgrid %}`, `{% card|linkcard %}` - Card layouts
+- `{% tabs %}`, `{% tabitem label="some-label" %}` - Tab layouts
+  - Use the `syncKey` so tabs are auto switched to the users preference if it makes sense.
+  - e.g. `{% tabs syncKey="package-manager" %}`
+
+#### Interactive Components
+
+- `{% graph %}` - Interactive project/task graph visualization
+- `{% project_details %}` - Project configuration viewer
+
+#### Media & Embeds
+
+- `{% youtube %}` - YouTube video embeds
+- `{% video_player %}` - Custom video player
+- `{% iframe %}` - Generic iframe embeds
+
+#### Developer Tools
+
+- `{% github_repository %}` - GitHub repo cards
+- `{% stackblitz_button %}` - StackBlitz demo launcher
+- `{% install_nx_console %}` - IDE extension installer
+
+#### Content Enhancement
+
+- `{% badge %}` - Status/label pills
+- `{% metrics %}` - Metrics display
+- `{% testimonial %}` - Customer testimonials
+
+## Development Workflow
+
+### Getting Started
+
+```bash
+# Install dependencies and link workspace packages
+# This will build Nx packages as well for API docs
+nx serve astro-docs
+
+# Or run astro dev directly
+# This will not build Nx packages
+cd astro-docs
+npx astro dev
+
+# Custom ports (useful for AI agents with git worktrees)
+npx astro dev --port 3000
+```
+
+### Adding New Content
+
+#### Regular Documentation
+
+1. Create `.mdoc` file in `src/content/docs/`
+2. Add frontmatter with title and description
+3. Use Markdoc tags for rich content
+4. File location determines URL structure
+
+Example:
+
+```markdown
+---
+title: 'My New Guide'
+description: 'Learn how to use this feature'
+---
+
+# Introduction
+
+{% aside type="note" title="Important" %}
+This is a note about the feature.
+{% /aside %}
+```
+
+#### Adding Custom Markdoc Tags
+
+1. Create Astro component in `src/components/markdoc/`
+2. (Optional) Create React component for more complex components, or ones that need to be shared with blog or non-docs pages
+3. Register in `markdoc.config.mjs`
+4. Define attributes and validation
+
+### Updating Plugin Documentation
+
+Plugin documentation is auto-generated during build. To update:
+
+1. Make changes to the plugin's schema/implementation
+2. Run the build process
+3. The loader will automatically fetch and generate updated docs
+
+### Sidebar Management
+
+The sidebar structure is defined in `sidebar.mts`. To add new sections:
+
+```javascript
+export const sidebar = [
+  {
+    label: 'Section Name',
+    items: [
+      {
+        label: 'Page Title',
+        link: 'path/to/page',
+      },
+      // Nested sections
+      {
+        label: 'Subsection',
+        collapsed: true,
+        items: [...]
+      }
+    ]
+  }
+];
+```
+
+> Note there is a special case for sidebar items appearing in the sidebar. Such as the `Reference` section which is handled via the `[sidebar-reference-updater](./src/plugins/sidebar-reference-updater.middleware.ts)` middleware.
+
+## Styling and Theming
+
+- Uses Tailwind CSS v4 with Vite plugin
+- Global styles in `src/styles/global.css`
+- Component-specific styles use Tailwind utilities
+- Dark/light mode support built into Starlight and customized in `global.css`
+
+## Configuration Files
+
+### `astro.config.mjs`
+
+- Site configuration
+- Integration setup (React, Markdoc, Starlight)
+- Vite plugins
+- Build options
+
+### `markdoc.config.mjs`
+
+- Custom tag definitions
+- Attribute validation
+- Component mappings
+
+### `sidebar.mts`
+
+- Navigation structure
+- Section organization
+- Dynamic content injection points

astro-docs/astro.config.mjs

@@ -0,0 +1,90 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+import netlify from '@astrojs/netlify';
+import react from '@astrojs/react';
+import markdoc from '@astrojs/markdoc';
+import tailwindcss from '@tailwindcss/vite';
+import { sidebar } from './sidebar.mts';
+
+// https://astro.build/config
+export default defineConfig({
+  base: '/docs',
+  vite: { plugins: [tailwindcss()] },
+  // Allow this to be configured per environment
+  // Note: this happens during build time so we don't use `import.meta.env`
+  site: process.env.NX_DEV_URL ?? 'https://nx.dev',
+  image: {
+    service: {
+      entrypoint: 'astro/assets/services/sharp',
+      config: {
+        limitInputPixels: false, // Disable pixel limit
+      },
+    },
+  },
+  trailingSlash: 'never',
+  // This adapter doesn't support local previews, so only load it on Netlify.
+  adapter: process.env['NETLIFY'] ? netlify() : undefined,
+  integrations: [
+    markdoc(),
+    // https://starlight.astro.build/reference/configuration/
+    starlight({
+      title: 'Nx',
+      tagline:
+        'An AI-first build platform that connects everything from your editor to CI. Helping you deliver fast, without breaking things.',
+      customCss: ['./src/styles/global.css'],
+      favicon: '/favicon.svg',
+      logo: {
+        light: './src/assets/nx/Nx-dark.png',
+        dark: './src/assets/nx/Nx-light.png',
+        replacesTitle: true,
+      },
+      plugins: [],
+      routeMiddleware: [
+        './src/plugins/banner.middleware.ts',
+        // NOTE: this is responsibile for populating the Reference section
+        // with generated routes from the nx-reference-packages content collection
+        // since the sidebar doesn't auto generate w/ dynamic routes from src/pages/reference
+        // only the src/content/docs/reference files
+        './src/plugins/sidebar-reference-updater.middleware.ts',
+      ],
+      markdown: {
+        // this breaks the renderMarkdown function in the plugin loader due to starlight path normalization
+        // as to _why_ it has to normalize a path?
+        // idk just working around the issue for now but we'll want to have linked headers so will need to fix
+        headingLinks: false,
+      },
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/nrwl/nx' },
+        {
+          icon: 'youtube',
+          label: 'YouTube',
+          href: 'https://www.youtube.com/@NxDevtools?utm_source=nx.dev',
+        },
+        {
+          icon: 'x.com',
+          label: 'X',
+          href: 'https://x.com/NxDevTools?utm_source=nx.dev',
+        },
+        {
+          icon: 'discord',
+          label: 'Discord',
+          href: 'https://go.nx.dev/community',
+        },
+      ],
+      editLink: {
+        baseUrl: 'https://github.com/nrwl/nx/tree/main/',
+      },
+      sidebar,
+      components: {
+        Header: './src/components/layout/Header.astro',
+        Footer: './src/components/layout/Footer.astro',
+        PageFrame: './src/components/layout/PageFrame.astro',
+        Sidebar: './src/components/layout/Sidebar.astro',
+        TwoColumnContent: './src/components/layout/TwoColumnContent.astro',
+        PageTitle: './src/components/layout/PageTitle.astro',
+      },
+    }),
+    react(),
+  ],
+});

astro-docs/fixlinks

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+
+# | xargs -0 sed -i '' 's/<match>/<replace>/g'
+
+# replace links that start with /concepts to /docs/concepts
+rg "\(/concepts" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/concepts|](/docs/concepts|g'
+# usage in link card aka href="/concepts/..."
+rg "=\"/concepts" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/concepts|="/docs/concepts|g'
+
+# /recipes -> /docs/guides
+rg "\(/recipes" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/recipes|](/docs/guides|g'
+rg "=\"/recipes" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/recipes|="/docs/guides|g'
+
+# /deprecated -> /docs/reference/deprecated
+rg "\(/deprecated" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/deprecated|](/docs/reference/deprecated|g'
+rg "=\"/deprecated" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/deprecated|="/docs/reference/deprecated|g'
+
+# /troubleshooting -> /docs/troublshooting
+rg "\(/troubleshooting" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/troubleshooting|](/docs/troubleshooting|g'
+rg "=\"/troubleshooting" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/troubleshooting|="/docs/troubleshooting|g'
+
+# /plugin-registry -> /docs/plugin-registry
+rg "\(/plugin-registry" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/plugin-registry|](/docs/plugin-registry|g'
+rg "=\"/plugin-registry" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/plugin-registry|="/docs/plugin-registry|g'
+
+# /features -> /docs/features
+rg "\(/features" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/features|](/docs/features|g'
+rg "=\"/features" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/features|="/docs/features|g'
+
+# /extending-nx -> /docs/extending-nx
+rg "\(/extending-nx" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/extending-nx|](/docs/extending-nx|g'
+rg "=\"/extending-nx" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/extending-nx|="/docs/extending-nx|g'
+rg "/extending-nx/recipes" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|/extending-nx/recipes|/extending-nx|g'
+
+# /tech -> /docs/tech
+rg "\(/tech" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/tech|](/docs/tech|g'
+rg "=\"/tech" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/tech|="/docs/tech|g'
+
+## /recipes/running-tasks -> /docs/guides/tasks--caching
+rg "\(/recipes/running-tasks" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/recipes/running-tasks|](/docs/guides/tasks--caching|g'
+rg "=\"/recipes/running-tasks" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/recipes/running-tasks|="/docs/guides/tasks--caching|g'
+
+# /ci/features -> /docs/features/ci-features
+rg "\(/ci/features" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/features|](/docs/features/ci-features|g'
+rg "=\"/ci/features" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/features|="/docs/features/ci-features|g'
+
+# /ci/concepts -> /docs/concepts/ci-concepts
+rg "\(/ci/concepts" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/concepts|](/docs/concepts/ci-concepts|g'
+rg "=\"/ci/concepts" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/concepts|="/docs/concepts/ci-concepts|g'
+
+# /ci/guides/security -> /docs/guides/nx-cloud
+rg "\(/ci/guides/security" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/guides/security|](/docs/guides/nx-cloud|g'
+rg "=\"/ci/guides/security" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/guides/security|="/docs/guides/nx-cloud|g'
+rg "\(/ci/recipes/security" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/recipes/security|](/docs/guides/nx-cloud|g'
+rg "=\"/ci/recipes/security" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/recipes/security|="/docs/guides/nx-cloud|g'
+
+# /ci/recipes/enterprise -> /docs/enterprise
+rg "\(/ci/recipes/enterprise" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/recipes/enterprise|](/docs/enterprise|g'
+rg "=\"/ci/recipes/enterprise" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/recipes/enterprise|="/docs/enterprise|g'
+
+# /ci/recipes -> /docs/guides/nx-cloud
+rg "\(/ci/guides" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/guides|](/docs/guides/nx-cloud|g'
+rg "=\"/ci/guides" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/guides|="/docs/guides/nx-cloud|g'
+rg "\(/ci/recipes" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/recipes|](/docs/guides/nx-cloud|g'
+rg "=\"/ci/recipes" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/recipes|="/docs/guides/nx-cloud|g'
+
+# /getting-started -> /docs/getting-started
+rg "\(/getting" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/getting|](/docs/getting|g'
+rg "=\"/getting" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/getting|="/docs/getting|g'
+
+# /ci/recipes/set-up -> /docs/guides/nx-cloud/setup-ci
+rg "\(/ci/recipes/set-up" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/recipes/set-up|](/docs/guides/nx-cloud/setup-ci|g'
+rg "=\"/ci/recipes/set-up" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/recipes/set-up|="/docs/guides/nx-cloud/setup-ci|g'
+# I merged all the set-up ci guides into 1 page with tabs so we need to remove any links that go to specific guides
+rg "/monorepo-ci-" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|\(/[^)]*\)/monorepo-ci-[^)]*\()\)|\1\2|g'
+
+# /ci/reference/nx-cloud-cli -> /docs/reference/nx-cloud-cli
+rg "\(/ci/reference/nx-cloud-cli" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/ci/reference/nx-cloud-cli|](/docs/reference/nx-cloud-cli|g'
+rg "=\"/ci/reference/nx-cloud-cli" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/ci/reference/nx-cloud-cli|="/docs/reference/nx-cloud-cli|g'
+
+# /blog -> https://nx.dev/blog
+rg "\(/blog" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/blog|](https://nx.dev/blog|g'
+rg "=\"/blog" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/blog|="https://nx.dev/blog|g'
+
+# /enterprise -> https://nx.dev/enterprise
+rg "\(/enterprise" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/enterprise|](https://nx.dev/enterprise|g'
+rg "=\"/enterprise" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/enterprise|="https://nx.dev/enterprise|g'
+
+# /pricing -> https://nx.dev/pricing
+rg "\(/pricing" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/pricing|](https://nx.dev/pricing|g'
+rg "=\"/pricing" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/pricing|="https://nx.dev/pricing|g'
+
+# /contact -> https://nx.dev/contact
+rg "\(/contact" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/contact|](https://nx.dev/contact|g'
+rg "=\"/contact" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/contact|="https://nx.dev/contact|g'
+
+# /nx-cloud -> https://nx.dev/nx-cloud
+rg "\(/nx-cloud" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/nx-cloud|](https://nx.dev/nx-cloud|g'
+rg "=\"/nx-cloud" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/nx-cloud|="https://nx.dev/nx-cloud|g'
+
+# /courses -> https://nx.dev/courses
+rg "\(/courses" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/courses|](https://nx.dev/courses|g'
+rg "=\"/courses" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/courses|="https://nx.dev/courses|g'
+# /community -> https://nx.dev/community
+rg "\(/community" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/community|](https://nx.dev/community|g'
+rg "=\"/community" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/community|="https://nx.dev/community|g'
+
+# though these URLS that have `core-api` in them need to be special handled
+# but we can search for 'core-api' later and do a different replace mechinism
+# /reference -> /docs/reference
+rg "\(/reference" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/reference|](/docs/reference|g'
+rg "=\"/reference" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/reference|="/docs/reference|g'
+
+# /docs/reference/core-api/nx/documents/:command -> /docs/reference/nx-commands#:command
+rg "\(/docs/reference/core-api/nx/documents/" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|](/docs/reference/core-api/nx/documents/|](/docs/reference/nx-commands#|g'
+rg "=\"/docs/reference/core-api/nx/documents/" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|="/docs/reference/core-api/nx/documents/|="/docs/reference/nx-commands#|g'
+
+# /docs/reference/core-api/:remote-cache-plugin/overview -> /docs/reference/remote-cache-plugins/:remote-cache-plugin/overview
+# For s3-cache
+rg "/docs/reference/core-api/s3-cache" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|/docs/reference/core-api/s3-cache|/docs/reference/remote-cache-plugins/s3-cache|g'
+
+# For azure-cache
+rg "/docs/reference/core-api/azure-cache" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|/docs/reference/core-api/azure-cache|/docs/reference/remote-cache-plugins/azure-cache|g'
+
+# For gcs-cache
+rg "/docs/reference/core-api/gcs-cache" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|/docs/reference/core-api/gcs-cache|/docs/reference/remote-cache-plugins/gcs-cache|g'
+
+# For shared-fs-cache
+rg "/docs/reference/core-api/shared-fs-cache" --type-add "mdoc:*mdoc" -t mdoc -l --null | xargs -0 sed -i '' 's|/docs/reference/core-api/shared-fs-cache|/docs/reference/remote-cache-plugins/shared-fs-cache|g'

astro-docs/markdoc.config.mjs

@@ -0,0 +1,391 @@
+import { defineMarkdocConfig, component } from '@astrojs/markdoc/config';
+import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+export default defineMarkdocConfig({
+  extends: [starlightMarkdoc()],
+  tags: {
+    call_to_action: {
+      render: component('./src/components/markdoc/CallToAction.astro'),
+      attributes: {
+        url: {
+          type: 'String',
+          required: true,
+        },
+        title: {
+          type: 'String',
+          required: true,
+        },
+        description: {
+          type: 'String',
+          required: false,
+        },
+        icon: {
+          type: 'String',
+          required: false,
+        },
+        variant: {
+          type: 'String',
+          required: false,
+          default: 'default',
+          matches: ['default', 'gradient', 'inverted', 'gradient-alt'],
+        },
+        size: {
+          type: 'String',
+          required: false,
+          default: 'sm',
+          matches: ['sm', 'md', 'lg'],
+        },
+      },
+    },
+    callout: {
+      render: component('./src/components/markdoc/Callout.astro'),
+      children: ['paragraph', 'tag', 'list'],
+      attributes: {
+        type: {
+          type: 'String',
+          default: 'note',
+          matches: [
+            'announcement',
+            'caution',
+            'check',
+            'note',
+            'warning',
+            'deepdive',
+          ],
+          errorLevel: 'critical',
+        },
+        title: {
+          type: 'String',
+          required: true,
+        },
+        expanded: {
+          type: 'Boolean',
+          default: false,
+        },
+      },
+    },
+    card: {
+      render: component('./src/components/markdoc/Card.astro'),
+      attributes: {
+        title: {
+          type: 'String',
+          required: true,
+        },
+        description: {
+          type: 'String',
+          default: '',
+        },
+        type: {
+          type: 'String',
+          default: 'documentation',
+        },
+        url: {
+          type: 'String',
+          default: '',
+        },
+      },
+    },
+    cards: {
+      render: component('./src/components/markdoc/Cards.astro'),
+      attributes: {
+        cols: {
+          type: 'Number',
+        },
+        smCols: {
+          type: 'Number',
+        },
+        mdCols: {
+          type: 'Number',
+        },
+        lgCols: {
+          type: 'Number',
+        },
+        moreLink: {
+          type: 'String',
+        },
+      },
+    },
+    course_video: {
+      render: component('./src/components/markdoc/CourseVideo.astro'),
+      attributes: {
+        src: {
+          type: 'String',
+          required: true,
+        },
+        courseTitle: {
+          type: 'String',
+          required: true,
+        },
+        courseUrl: {
+          type: 'String',
+          required: true,
+        },
+      },
+    },
+    github_repository: {
+      render: component('./src/components/markdoc/GithubRepository.astro'),
+      attributes: {
+        url: {
+          type: 'String',
+          required: true,
+        },
+        title: {
+          type: 'String',
+          required: false,
+        },
+      },
+    },
+    graph: {
+      render: component('./src/components/markdoc/Graph.astro'),
+      children: [],
+      attributes: {
+        jsonFile: {
+          type: 'String',
+        },
+        title: {
+          type: 'String',
+        },
+        type: {
+          type: 'String',
+          matches: ['project', 'task'],
+          default: 'project',
+        },
+        height: {
+          type: 'String',
+          required: true,
+        },
+      },
+    },
+    iframe: {
+      render: component('./src/components/markdoc/Iframe.astro'),
+      attributes: {
+        src: {
+          type: 'String',
+          required: true,
+        },
+        title: {
+          type: 'String',
+          required: true,
+        },
+        width: {
+          type: 'String',
+          default: '50%',
+        },
+      },
+    },
+    install_nx_console: {
+      render: component('./src/components/markdoc/InstallNxConsole.astro'),
+      attributes: {},
+    },
+    link_card: {
+      render: component('./src/components/markdoc/LinkCard.astro'),
+      attributes: {
+        title: {
+          type: 'String',
+          required: true,
+        },
+        type: {
+          type: 'String',
+          required: true,
+        },
+        icon: {
+          type: 'String',
+          required: false,
+        },
+        url: {
+          type: 'String',
+          default: '',
+        },
+        appearance: {
+          type: 'String',
+          default: 'default',
+        },
+      },
+    },
+    index_page_cards: {
+      render: component('./src/components/markdoc/IndexPageCards.astro'),
+      attributes: {
+        path: {
+          type: 'String',
+          required: true,
+        },
+      },
+    },
+    metrics: {
+      render: component('./src/components/markdoc/Metrics.astro'),
+      attributes: {
+        metrics: {
+          type: 'Array',
+          required: true,
+        },
+      },
+    },
+    persona: {
+      render: component('./src/components/markdoc/Persona.astro'),
+      children: ['paragraph', 'tag', 'list'],
+      attributes: {
+        title: {
+          type: 'String',
+        },
+        type: {
+          type: 'String',
+          default: 'integrated',
+          required: true,
+          matches: [
+            'cache',
+            'distribute',
+            'javascript',
+            'lerna',
+            'react',
+            'angular',
+            'integrated',
+          ],
+          errorLevel: 'critical',
+        },
+        url: {
+          type: 'String',
+          required: true,
+          errorLevel: 'critical',
+        },
+      },
+    },
+    personas: {
+      render: component('./src/components/markdoc/Personas.astro'),
+    },
+    pill: {
+      render: component('./src/components/markdoc/Pill.astro'),
+      attributes: {
+        url: {
+          type: 'String',
+          default: '',
+        },
+      },
+    },
+    project_details: {
+      render: component('./src/components/markdoc/ProjectDetails.astro'),
+      children: [],
+      attributes: {
+        jsonFile: {
+          type: 'String',
+        },
+        title: {
+          type: 'String',
+        },
+        height: {
+          type: 'String',
+        },
+        expandedTargets: {
+          type: 'Array',
+        },
+      },
+    },
+    stackblitz_button: {
+      render: component('./src/components/markdoc/StackblitzButton.astro'),
+      attributes: {
+        url: {
+          type: 'String',
+          required: true,
+        },
+        title: {
+          type: 'String',
+          required: false,
+        },
+      },
+    },
+    testimonial: {
+      render: component('./src/components/markdoc/Testimonial.astro'),
+      children: ['paragraph'],
+      attributes: {
+        name: {
+          type: 'String',
+        },
+        title: {
+          type: 'String',
+        },
+        image: {
+          type: 'String',
+        },
+      },
+    },
+    video_link: {
+      render: component('./src/components/markdoc/VideoLink.astro'),
+      attributes: {
+        link: {
+          type: 'String',
+          required: true,
+        },
+        text: {
+          type: 'String',
+          required: false,
+        },
+      },
+    },
+    video_player: {
+      render: component('./src/components/markdoc/VideoPlayer.astro'),
+      attributes: {
+        src: {
+          type: 'String',
+          required: true,
+        },
+        alt: {
+          type: 'String',
+          required: false,
+        },
+        link: {
+          type: 'String',
+          required: false,
+        },
+        showDescription: {
+          type: 'Boolean',
+          required: false,
+          default: false,
+        },
+        showControls: {
+          type: 'Boolean',
+          required: false,
+          default: false,
+        },
+        autoPlay: {
+          type: 'Boolean',
+          required: false,
+          default: false,
+        },
+        loop: {
+          type: 'Boolean',
+          required: false,
+          default: false,
+        },
+      },
+    },
+    youtube: {
+      render: component('./src/components/markdoc/Youtube.astro'),
+      attributes: {
+        src: {
+          type: 'String',
+          required: true,
+        },
+        title: {
+          type: 'String',
+          required: true,
+        },
+        width: {
+          type: 'String',
+          default: '100%',
+        },
+        caption: {
+          type: 'String',
+          required: false,
+        },
+      },
+    },
+    side_by_side: {
+      render: component('./src/components/markdoc/SideBySide.astro'),
+      attributes: {
+        align: {
+          type: 'String',
+          default: 'center',
+        },
+      },
+    },
+  },
+});

astro-docs/netlify.toml

@@ -0,0 +1,22 @@
+# Permanent redirects (301 by default)
+[[redirects]]
+from = "/"
+to = "/docs/getting-started/intro"
+
+[[redirects]]
+from = "/showcase"
+to = "/docs/quickstart"
+
+[[redirects]]
+from = "/showcase/example-repos/*"
+to = "/docs/quickstart"
+
+[[redirects]]
+from = "/showcase/benchmarks/*"
+to = "/docs/reference/benchmarks/:splat"
+
+# Rewrite for base path handling (keeps URL the same)
+[[redirects]]
+from = "/docs/*"
+to = "/:splat"
+status = 200

astro-docs/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "astro-docs",
+  "version": "0.0.1",
+  "private": true,
+  "dependencies": {
+    "@astrojs/check": "^0.7.0",
+    "@astrojs/markdoc": "^0.15.0",
+    "@astrojs/netlify": "^6.4.0",
+    "@astrojs/react": "^4.3.0",
+    "@astrojs/starlight": "0.34.6",
+    "@astrojs/starlight-markdoc": "^0.4.0",
+    "@astrojs/starlight-tailwind": "^4.0.1",
+    "@nx/nx-dev-ui-common": "workspace:*",
+    "@nx/nx-dev-ui-icons": "workspace:*",
+    "@nx/nx-dev-ui-markdoc": "workspace:*",
+    "@tailwindcss/vite": "^4.1.11",
+    "astro": "^5.10.1",
+    "tailwindcss": "4.1.11"
+  }
+}

astro-docs/project.json

@@ -0,0 +1,70 @@
+{
+  "name": "astro-docs",
+  "$schema": "../node_modules/nx/schemas/project-schema.json",
+  "comment": "package.json#scripts runs in the project root directory with astro assumes is where the node_modules is. which fails. so run the scripts in project.json#targets with --root command instead",
+  "targets": {
+    "serve": {
+      "continuous": true,
+      "dependsOn": [
+        {
+          "projects": ["devkit", "create-nx-workspace"],
+          "target": "build"
+        }
+      ],
+      "command": "astro dev",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    },
+    "build": {
+      "dependsOn": [
+        {
+          "projects": ["devkit", "create-nx-workspace"],
+          "target": "build"
+        }
+      ],
+      "outputs": [
+        "{projectRoot}/dist",
+        "{projectRoot}/.astro",
+        "{projectRoot}/.netlify"
+      ],
+      "command": "astro build",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    },
+    "preview": {
+      "dependsOn": ["build"],
+      "command": "astro preview",
+      "continuous": true,
+      "options": {
+        "cwd": "astro-docs"
+      }
+    },
+    "astro": {
+      "command": "astro",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    },
+    "test": {
+      "dependsOn": ["validate-links"],
+      "command": "echo done"
+    },
+    "validate-links": {
+      "dependsOn": ["build"],
+      "inputs": [
+        "{projectRoot}/src/**/*",
+        "{projectRoot}/astro.config.mjs",
+        "{projectRoot}/sidebar.mts",
+        "{projectRoot}/markdoc.config.mjs",
+        "{projectRoot}/tsconfig.json",
+        "{projectRoot}/package.json"
+      ],
+      "command": "npx tsx validate-links.ts",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    }
+  }
+}

astro-docs/public/favicon.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Nx</title><path d="M11.987 14.138l-3.132 4.923-5.193-8.427-.012 8.822H0V4.544h3.691l5.247 8.833.005-3.998 3.044 4.759zm.601-5.761c.024-.048 0-3.784.008-3.833h-3.65c.002.059-.005 3.776-.003 3.833h3.645zm5.634 4.134a2.061 2.061 0 0 0-1.969 1.336 1.963 1.963 0 0 1 2.343-.739c.396.161.917.422 1.33.283a2.1 2.1 0 0 0-1.704-.88zm3.39 1.061c-.375-.13-.8-.277-1.109-.681-.06-.08-.116-.17-.176-.265a2.143 2.143 0 0 0-.533-.642c-.294-.216-.68-.322-1.18-.322a2.482 2.482 0 0 0-2.294 1.536 2.325 2.325 0 0 1 4.002.388.75.75 0 0 0 .836.334c.493-.105.46.36 1.203.518v-.133c-.003-.446-.246-.55-.75-.733zm2.024 1.266a.723.723 0 0 0 .347-.638c-.01-2.957-2.41-5.487-5.37-5.487a5.364 5.364 0 0 0-4.487 2.418c-.01-.026-1.522-2.39-1.538-2.418H8.943l3.463 5.423-3.379 5.32h3.54l1.54-2.366 1.568 2.366h3.541l-3.21-5.052a.7.7 0 0 1-.084-.32 2.69 2.69 0 0 1 2.69-2.691h.001c1.488 0 1.736.89 2.057 1.308.634.826 1.9.464 1.9 1.541a.707.707 0 0 0 1.066.596zm.35.133c-.173.372-.56.338-.755.639-.176.271.114.412.114.412s.337.156.538-.311c.104-.231.14-.488.103-.74z"/></svg>

astro-docs/public/img/nx.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Nx</title><path d="M11.987 14.138l-3.132 4.923-5.193-8.427-.012 8.822H0V4.544h3.691l5.247 8.833.005-3.998 3.044 4.759zm.601-5.761c.024-.048 0-3.784.008-3.833h-3.65c.002.059-.005 3.776-.003 3.833h3.645zm5.634 4.134a2.061 2.061 0 0 0-1.969 1.336 1.963 1.963 0 0 1 2.343-.739c.396.161.917.422 1.33.283a2.1 2.1 0 0 0-1.704-.88zm3.39 1.061c-.375-.13-.8-.277-1.109-.681-.06-.08-.116-.17-.176-.265a2.143 2.143 0 0 0-.533-.642c-.294-.216-.68-.322-1.18-.322a2.482 2.482 0 0 0-2.294 1.536 2.325 2.325 0 0 1 4.002.388.75.75 0 0 0 .836.334c.493-.105.46.36 1.203.518v-.133c-.003-.446-.246-.55-.75-.733zm2.024 1.266a.723.723 0 0 0 .347-.638c-.01-2.957-2.41-5.487-5.37-5.487a5.364 5.364 0 0 0-4.487 2.418c-.01-.026-1.522-2.39-1.538-2.418H8.943l3.463 5.423-3.379 5.32h3.54l1.54-2.366 1.568 2.366h3.541l-3.21-5.052a.7.7 0 0 1-.084-.32 2.69 2.69 0 0 1 2.69-2.691h.001c1.488 0 1.736.89 2.057 1.308.634.826 1.9.464 1.9 1.541a.707.707 0 0 0 1.066.596zm.35.133c-.173.372-.56.338-.755.639-.176.271.114.412.114.412s.337.156.538-.311c.104-.231.14-.488.103-.74z"/></svg>

astro-docs/public/robots.txt

@@ -0,0 +1,9 @@
+# *
+User-agent: *
+Allow: /
+
+# Host
+Host: https://nx.dev
+
+# Sitemaps
+Sitemap: https://nx.dev/sitemap-index.xml

astro-docs/public/sitemap.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+    <sitemap>
+        <loc>https://nx.dev/docs/sitemap-0.xml</loc>
+    </sitemap>
+</sitemapindex>

astro-docs/sidebar.mts

@@ -0,0 +1,218 @@
+import type { StarlightUserConfig } from '@astrojs/starlight/types';
+import { getPluginItems } from './src/plugins/utils/plugin-mappings';
+
+export const sidebar: StarlightUserConfig['sidebar'] = [
+  {
+    label: 'Getting Started',
+    collapsed: false,
+    autogenerate: { directory: 'getting-started', collapsed: true },
+  },
+  {
+    label: 'Features',
+    collapsed: false,
+    autogenerate: { directory: 'features', collapsed: true },
+  },
+  {
+    label: 'Guides',
+    collapsed: true,
+    autogenerate: { directory: 'guides', collapsed: true },
+  },
+  {
+    label: 'Concepts',
+    collapsed: true,
+    autogenerate: { directory: 'concepts', collapsed: true },
+  },
+  {
+    label: 'Technologies',
+    collapsed: false,
+    // manually type the tech routes due to complexity of order and structure
+    items: [
+      {
+        label: 'TypeScript',
+        collapsed: true,
+        items: getPluginItems('js'),
+      },
+      {
+        label: 'Angular',
+        collapsed: true,
+        items: [
+          ...getPluginItems('angular'),
+          {
+            label: 'Angular Rspack',
+            items: getPluginItems('angular-rspack', 'angular'),
+          },
+          {
+            label: 'Angular Rsbuild',
+            items: getPluginItems('angular-rsbuild', 'angular'),
+          },
+        ],
+      },
+      {
+        label: 'React',
+        collapsed: true,
+        items: [
+          ...getPluginItems('react'),
+          {
+            label: 'Next',
+            collapsed: true,
+            items: getPluginItems('next', 'react'),
+          },
+          {
+            label: 'Remix',
+            collapsed: true,
+            items: getPluginItems('remix', 'react'),
+          },
+          {
+            label: 'React Native',
+            collapsed: true,
+            items: getPluginItems('react-native', 'react'),
+          },
+          {
+            label: 'Expo',
+            collapsed: true,
+            items: getPluginItems('expo', 'react'),
+          },
+        ],
+      },
+      {
+        label: 'Vue',
+        collapsed: true,
+        items: [
+          ...getPluginItems('vue'),
+          {
+            label: 'Nuxt',
+            collapsed: true,
+            items: getPluginItems('nuxt', 'vue'),
+          },
+        ],
+      },
+      {
+        label: 'Node.js',
+        collapsed: true,
+        items: [
+          ...getPluginItems('node'),
+          {
+            label: 'Express',
+            collapsed: true,
+            items: getPluginItems('express', 'node'),
+          },
+          {
+            label: 'Nest',
+            collapsed: true,
+            items: getPluginItems('nest', 'node'),
+          },
+        ],
+      },
+      {
+        label: 'Java',
+        collapsed: true,
+        // when we have maven this will change to not have gradle as the top docs for Java
+        items: getPluginItems('gradle', 'java'),
+      },
+      {
+        label: 'Module Federation',
+        collapsed: true,
+        items: getPluginItems('module-federation'),
+      },
+      {
+        label: 'ESLint',
+        collapsed: true,
+        items: [
+          ...getPluginItems('eslint'),
+          {
+            label: 'ESLint Plugin',
+            collapsed: true,
+            items: getPluginItems('eslint-plugin', 'eslint'),
+          },
+        ],
+      },
+      {
+        label: 'Build Tools',
+        collapsed: true,
+        items: [
+          {
+            label: 'Webpack',
+            collapsed: true,
+            items: getPluginItems('webpack', 'build-tools'),
+          },
+          {
+            label: 'Vite',
+            collapsed: true,
+            items: getPluginItems('vite', 'build-tools'),
+          },
+          {
+            label: 'Rollup',
+            collapsed: true,
+            items: getPluginItems('rollup', 'build-tools'),
+          },
+          {
+            label: 'ESBuild',
+            collapsed: true,
+            items: getPluginItems('esbuild', 'build-tools'),
+          },
+          {
+            label: 'Rspack',
+            collapsed: true,
+            items: getPluginItems('rspack', 'build-tools'),
+          },
+          {
+            label: 'Rsbuild',
+            collapsed: true,
+            items: getPluginItems('rsbuild', 'build-tools'),
+          },
+        ],
+      },
+      {
+        label: 'Test Tools',
+        collapsed: true,
+        items: [
+          {
+            label: 'Cypress',
+            collapsed: true,
+            items: getPluginItems('cypress', 'test-tools'),
+          },
+          {
+            label: 'Jest',
+            collapsed: true,
+            items: getPluginItems('jest', 'test-tools'),
+          },
+          {
+            label: 'Playwright',
+            collapsed: true,
+            items: getPluginItems('playwright', 'test-tools'),
+          },
+          {
+            label: 'Storybook',
+            collapsed: true,
+            items: getPluginItems('storybook', 'test-tools'),
+          },
+          {
+            label: 'Detox',
+            collapsed: true,
+            items: getPluginItems('detox', 'test-tools'),
+          },
+        ],
+      },
+    ],
+  },
+  {
+    label: 'Enterprise',
+    collapsed: true,
+    autogenerate: { directory: 'enterprise', collapsed: true },
+  },
+  {
+    label: 'Extending Nx',
+    collapsed: true,
+    autogenerate: { directory: 'extending-nx', collapsed: true },
+  },
+  {
+    label: 'Reference',
+    collapsed: false,
+    autogenerate: { directory: 'reference', collapsed: true },
+  },
+  {
+    label: 'Troubleshooting',
+    collapsed: false,
+    autogenerate: { directory: 'troubleshooting', collapsed: true },
+  },
+];

astro-docs/src/assets/concepts/caching/myreactapp.json

@@ -0,0 +1,233 @@
+{
+  "project": {
+    "name": "myreactapp",
+    "type": "app",
+    "data": {
+      "root": "apps/myreactapp",
+      "targets": {
+        "build": {
+          "options": {
+            "cwd": "apps/myreactapp",
+            "command": "vite build"
+          },
+          "cache": true,
+          "dependsOn": ["^build"],
+          "inputs": [
+            "production",
+            "^production",
+            {
+              "externalDependencies": ["vite"]
+            }
+          ],
+          "outputs": ["{workspaceRoot}/dist/apps/myreactapp"],
+          "executor": "nx:run-commands",
+          "configurations": {},
+          "metadata": {
+            "technologies": ["vite"]
+          }
+        },
+        "serve": {
+          "options": {
+            "cwd": "apps/myreactapp",
+            "command": "vite serve",
+            "continuous": true
+          },
+          "executor": "nx:run-commands",
+          "configurations": {},
+          "metadata": {
+            "technologies": ["vite"]
+          }
+        },
+        "preview": {
+          "options": {
+            "cwd": "apps/myreactapp",
+            "command": "vite preview"
+          },
+          "executor": "nx:run-commands",
+          "configurations": {},
+          "metadata": {
+            "technologies": ["vite"]
+          }
+        },
+        "serve-static": {
+          "executor": "@nx/web:file-server",
+          "options": {
+            "buildTarget": "build",
+            "continuous": true
+          },
+          "configurations": {}
+        },
+        "test": {
+          "options": {
+            "cwd": "apps/myreactapp",
+            "command": "vitest run"
+          },
+          "cache": true,
+          "inputs": [
+            "default",
+            "^production",
+            {
+              "externalDependencies": ["vitest"]
+            }
+          ],
+          "outputs": ["{workspaceRoot}/coverage/apps/myreactapp"],
+          "executor": "nx:run-commands",
+          "configurations": {},
+          "metadata": {
+            "technologies": ["vite"]
+          }
+        },
+        "lint": {
+          "cache": true,
+          "options": {
+            "cwd": "apps/myreactapp",
+            "command": "eslint ."
+          },
+          "inputs": [
+            "default",
+            "{workspaceRoot}/.eslintrc.json",
+            "{workspaceRoot}/apps/myreactapp/.eslintrc.json",
+            "{workspaceRoot}/tools/eslint-rules/**/*",
+            {
+              "externalDependencies": ["eslint"]
+            }
+          ],
+          "executor": "nx:run-commands",
+          "configurations": {},
+          "metadata": {
+            "technologies": ["eslint"]
+          }
+        }
+      },
+      "name": "myreactapp",
+      "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+      "sourceRoot": "apps/myreactapp/src",
+      "projectType": "application",
+      "tags": [],
+      "implicitDependencies": [],
+      "metadata": {
+        "technologies": ["react"]
+      }
+    }
+  },
+  "sourceMap": {
+    "root": ["apps/myreactapp/project.json", "nx/core/project-json"],
+    "targets": ["apps/myreactapp/project.json", "nx/core/project-json"],
+    "targets.build": ["apps/myreactapp/vite.config.ts", "@nx/vite/plugin"],
+    "targets.build.command": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.build.options": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.build.cache": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.build.dependsOn": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.build.inputs": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.build.outputs": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.build.options.cwd": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.serve": ["apps/myreactapp/vite.config.ts", "@nx/vite/plugin"],
+    "targets.serve.command": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.serve.options": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.serve.options.cwd": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.preview": ["apps/myreactapp/vite.config.ts", "@nx/vite/plugin"],
+    "targets.preview.command": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.preview.options": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.preview.options.cwd": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.serve-static": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.serve-static.executor": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.serve-static.options": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.serve-static.options.buildTarget": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.test": ["apps/myreactapp/vite.config.ts", "@nx/vite/plugin"],
+    "targets.test.command": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.test.options": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.test.cache": ["apps/myreactapp/vite.config.ts", "@nx/vite/plugin"],
+    "targets.test.inputs": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.test.outputs": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.test.options.cwd": [
+      "apps/myreactapp/vite.config.ts",
+      "@nx/vite/plugin"
+    ],
+    "targets.lint": ["apps/myreactapp/project.json", "@nx/eslint/plugin"],
+    "targets.lint.command": [
+      "apps/myreactapp/project.json",
+      "@nx/eslint/plugin"
+    ],
+    "targets.lint.cache": ["apps/myreactapp/project.json", "@nx/eslint/plugin"],
+    "targets.lint.options": [
+      "apps/myreactapp/project.json",
+      "@nx/eslint/plugin"
+    ],
+    "targets.lint.inputs": [
+      "apps/myreactapp/project.json",
+      "@nx/eslint/plugin"
+    ],
+    "targets.lint.options.cwd": [
+      "apps/myreactapp/project.json",
+      "@nx/eslint/plugin"
+    ],
+    "name": ["apps/myreactapp/project.json", "nx/core/project-json"],
+    "$schema": ["apps/myreactapp/project.json", "nx/core/project-json"],
+    "sourceRoot": ["apps/myreactapp/project.json", "nx/core/project-json"],
+    "projectType": ["apps/myreactapp/project.json", "nx/core/project-json"],
+    "tags": ["apps/myreactapp/project.json", "nx/core/project-json"]
+  }
+}

astro-docs/src/assets/concepts/mental-model/connected-tasks.json

@@ -0,0 +1,64 @@
+{
+  "projects": [
+    {
+      "name": "app1",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "app2",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "taskId": "lib:test",
+  "taskGraphs": {
+    "lib:test": {
+      "roots": ["app1:test", "app2:test", "lib:test"],
+      "tasks": {
+        "app1:test": {
+          "id": "app1:test",
+          "target": { "project": "app1", "target": "test" },
+          "projectRoot": "apps/app1",
+          "overrides": {}
+        },
+        "app2:test": {
+          "id": "app2:test",
+          "target": { "project": "app2", "target": "test" },
+          "projectRoot": "apps/app2",
+          "overrides": {}
+        },
+        "lib:test": {
+          "id": "lib:test",
+          "target": { "project": "lib", "target": "test" },
+          "projectRoot": "libs/lib",
+          "overrides": {}
+        }
+      },
+      "dependencies": {
+        "app1:test": ["lib:test"],
+        "app2:test": ["lib:test"]
+      }
+    }
+  }
+}

astro-docs/src/assets/concepts/mental-model/disconnected-tasks.json

@@ -0,0 +1,61 @@
+{
+  "projects": [
+    {
+      "name": "app1",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "app2",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "taskId": "lib:test",
+  "taskGraphs": {
+    "lib:test": {
+      "roots": ["app1:test", "app2:test", "lib:test"],
+      "tasks": {
+        "app1:test": {
+          "id": "app1:test",
+          "target": { "project": "app1", "target": "test" },
+          "projectRoot": "apps/app1",
+          "overrides": {}
+        },
+        "app2:test": {
+          "id": "app2:test",
+          "target": { "project": "app2", "target": "test" },
+          "projectRoot": "apps/app2",
+          "overrides": {}
+        },
+        "lib:test": {
+          "id": "lib:test",
+          "target": { "project": "lib", "target": "test" },
+          "projectRoot": "libs/lib",
+          "overrides": {}
+        }
+      },
+      "dependencies": {}
+    }
+  }
+}

astro-docs/src/assets/concepts/mental-model/single-task.json

@@ -0,0 +1,29 @@
+{
+  "projects": [
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "taskId": "lib:test",
+  "taskGraphs": {
+    "lib:test": {
+      "roots": ["lib:test"],
+      "tasks": {
+        "lib:test": {
+          "id": "lib:test",
+          "target": { "project": "lib", "target": "test" },
+          "projectRoot": "libs/lib",
+          "overrides": {}
+        }
+      },
+      "dependencies": {}
+    }
+  }
+}

astro-docs/src/assets/concepts/mental-model/three-projects.json

@@ -0,0 +1,47 @@
+{
+  "projects": [
+    {
+      "name": "app1",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "app2",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "dependencies": {
+    "app1": [{ "source": "app1", "target": "lib", "type": "static" }],
+    "app2": [{ "source": "app2", "target": "lib", "type": "static" }],
+    "lib": []
+  },
+  "workspaceLayout": {
+    "appsDir": "apps",
+    "libsDir": "libs"
+  },
+  "affectedProjectIds": [],
+  "focus": null,
+  "groupByFolder": false,
+  "exclude": []
+}