chore: update Deno requirement to 2.1.x and add context7 config

[jumski]

Setup context7.json and update missed Deno version specifiers

This PR adds context7.json configuration file with project rules and documentation guidelines

Additionally:

• Updated the documentation to specify Deno 2.1.x or higher as the required version for pgflow compilation, replacing the previous requirement of 1.45.2 or higher. The change is reflected across multiple documentation files.
• Modified the lefthook.yml script to automatically accept symlinks by adding the --yes flag to the Claude symlink script

These changes ensure consistent documentation about version requirements and improve the developer experience with automated tooling.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 4501f43

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[jumski]

• sort out supabase start issues #409
• introduce prepush git hook #408
• chore: update Deno requirement to 2.1.x and add context7 config #407 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• merge:queue - adds this PR to the back of the merge queue
• hotfix:queue - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 4501f43

Command	Status	Duration	Result
nx affected -t verify-exports --base=origin/mai...	✅ Succeeded	<1s	View ↗
nx affected -t build --configuration=production...	✅ Succeeded	18s	View ↗
nx affected -t lint typecheck test --parallel -...	✅ Succeeded	1s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-11-21 11:55:47 UTC

[graphite-app]

The ss command is Linux-specific and not available on macOS. This function will fail silently on macOS systems, leaving ports occupied and causing "port already in use" errors when starting Supabase.

Fix by adding cross-platform support:

cleanup_port_processes() {
  local project_dir="$1"
  local ports=$(get_project_ports "$project_dir")

  for port in $ports; do
    if nc -z localhost "$port" 2>/dev/null; then
      # Cross-platform: use lsof on macOS, ss on Linux
      local pid=""
      if command -v lsof >/dev/null 2>&1; then
        pid=$(lsof -ti:"$port" 2>/dev/null | head -1)
      elif command -v ss >/dev/null 2>&1; then
        pid=$(ss -lpn 2>/dev/null | grep ":$port " | grep -oE "pid=[0-9]+" | cut -d= -f2 | head -1)
      fi
      
      if [ -n "$pid" ]; then
        echo -e "${YELLOW}Killing process holding port $port (PID: $pid)${NC}"
        kill -9 "$pid" 2>/dev/null || true
      fi
    fi
  done
  sleep 2
}

Suggested change

	if nc -z localhost "$port" 2>/dev/null; then
	# Find process holding the port using ss
	local pid=$(ss -lpn 2>/dev/null | grep ":$port " | grep -oE "pid=[0-9]+" | cut -d= -f2 | head -1)
	if [ -n "$pid" ]; then
	echo -e "${YELLOW}Killing process holding port $port (PID: $pid)${NC}"
	kill -9 "$pid" 2>/dev/null || true
	fi
	fi
	done
	if nc -z localhost "$port" 2>/dev/null; then
	# Cross-platform: use lsof on macOS, ss on Linux
	local pid=""
	if command -v lsof >/dev/null 2>&1; then
	pid=$(lsof -ti:"$port" 2>/dev/null | head -1)
	elif command -v ss >/dev/null 2>&1; then
	pid=$(ss -lpn 2>/dev/null | grep ":$port " | grep -oE "pid=[0-9]+" | cut -d= -f2 | head -1)
	fi
	if [ -n "$pid" ]; then
	echo -e "${YELLOW}Killing process holding port $port (PID: $pid)${NC}"
	kill -9 "$pid" 2>/dev/null || true
	fi
	fi
	done
	sleep 2

Spotted by Graphite Agent



Is this helpful? React 👍 or 👎 to let us know.

[graphite-app]

Merge activity

• Nov 21, 11:56 AM UTC: jumski added this pull request to the Graphite merge queue.
• Nov 21, 11:56 AM UTC: CI is running for this pull request on a draft pull request (#410) due to your merge queue CI optimization settings.
• Nov 21, 11:57 AM UTC: Merged by the Graphite merge queue via draft PR: #410.

[github-actions]

🔍 Preview Deployment: Website

✅ Deployment successful!

🔗 Preview URL: https://pr-407.pgflow.pages.dev

📝 Details:

• Branch: 11-20-docs_setup_context7.json_fix_missing_deno_version_updates
• Commit: 271cd72c1252217b7a7d809981074b5291e9873d
• View Logs

_Last updated: _