feat: intel mac support (#5)

* feat: add Intel Mac (x86_64) support to CI/CD

- Add x86_64-apple-darwin to CLI build matrix using macos-13 runner
- Add Intel Mac to Python wheel build matrix
- Update release notes to document Intel Mac binaries and wheels
- Make pgvector download graceful when binary unavailable (404)

Note: Intel Mac builds will initially skip pgvector extension until
x86_64-apple-darwin binaries are added to pgvector_compiled repo.
PostgreSQL core functionality works without it.

Resolves macOS Intel installation issues with hindsight-api.

* docs: add platform support requirements - pgvector is mandatory

All supported platforms must include PostgreSQL, pgvector, and pgbouncer.
Never ship platform support without all three components.

* fix: make build fail if pgvector is unavailable

Reverted graceful fallback. Build now fails with error if pgvector
binary is not available for the target platform.

pgvector is a mandatory component - builds must not succeed without it.

* docs: clarify that builds must fail on missing components

No graceful fallbacks - builds must fail if any required component
(PostgreSQL, pgvector, pgbouncer) is missing.

* chore: update pgvector to v0.18.237 with Intel Mac support

Includes pgvector binary for x86_64-apple-darwin, unblocking Intel Mac builds.

* fix: use macos-15-intel runner and remove pgbouncer changes

- Change Intel Mac runner from macos-13 to macos-15-intel to match
  pgvector_compiled workflow
- Update wheel platform tag to macosx_15_0_x86_64
- Revert all pgbouncer-related changes from build.rs
- Remove pgbouncer build-dependencies from Cargo.toml

This branch should only add Intel Mac support, not pgbouncer features.

* feat: add Intel Mac to build-python-wheels workflow

Add x86_64-apple-darwin to the build matrix in build-python-wheels.yml
to ensure Intel Mac wheels are built in this workflow as well.

Author: nicoloboschi

.github/workflows/build-python-wheels.yml

@@ -28,6 +28,12 @@ jobs:
             wheel_platform: macosx_14_0_arm64
             rust_target: aarch64-apple-darwin
 
+          # macOS Intel
+          - os: macos-15-intel
+            platform: darwin-x86_64
+            wheel_platform: macosx_15_0_x86_64
+            rust_target: x86_64-apple-darwin
+
           # Linux x86_64 glibc
           - os: ubuntu-22.04
             platform: linux-x86_64-gnu

.github/workflows/release-cli.yml

@@ -31,6 +31,9 @@ jobs:
           - target: aarch64-apple-darwin
             os: macos-latest
             name: darwin-aarch64
+          - target: x86_64-apple-darwin
+            os: macos-15-intel
+            name: darwin-x86_64
           - target: x86_64-pc-windows-msvc
             os: windows-latest
             name: windows-x86_64
@@ -118,6 +121,13 @@ jobs:
             cli_artifact: cli-darwin-aarch64
             cli_binary: pg0-darwin-aarch64
 
+          # macOS Intel - reuse darwin-x86_64 CLI
+          - os: macos-15-intel
+            platform: darwin-x86_64
+            wheel_platform: macosx_15_0_x86_64
+            cli_artifact: cli-darwin-x86_64
+            cli_binary: pg0-darwin-x86_64
+
           # Linux x86_64 glibc - reuse linux-x86_64-gnu CLI
           - os: ubuntu-22.04
             platform: linux-x86_64-gnu
@@ -259,6 +269,7 @@ jobs:
 
           ### CLI Binaries
           - `pg0-darwin-aarch64` - macOS Apple Silicon
+          - `pg0-darwin-x86_64` - macOS Intel
           - `pg0-linux-x86_64-gnu` - Linux x86_64 for Debian/Ubuntu (glibc)
           - `pg0-linux-x86_64-musl` - Linux x86_64 for Alpine (musl, statically linked)
           - `pg0-linux-aarch64-gnu` - Linux ARM64 for Debian/Ubuntu (glibc)
@@ -273,6 +284,7 @@ jobs:
 
           Pre-built wheels available for:
           - macOS Apple Silicon (`macosx_14_0_arm64`)
+          - macOS Intel (`macosx_15_0_x86_64`)
           - Linux x86_64 glibc (`manylinux_2_35_x86_64`)
           - Linux ARM64 glibc (`manylinux_2_35_aarch64`)
           - Windows x64 (`win_amd64`)

CLAUDE.md

@@ -0,0 +1,43 @@
+# Claude Code Development Guidelines
+
+## Platform Support Requirements
+
+### Mandatory Components for All Platforms
+
+**CRITICAL:** All supported platforms MUST include the following components:
+
+1. **PostgreSQL** - Core database (required)
+2. **pgvector** - Vector similarity search extension (required)
+3. **pgbouncer** - Connection pooling (required)
+
+### Platform Support Policy
+
+- **Never suggest or ship** platform support without all three components
+- If a component is missing for a platform (e.g., pgvector not compiled for that platform):
+  - DO NOT suggest shipping without it
+  - DO NOT present it as an optional component
+  - The platform is NOT supported until all components are available
+
+### Adding New Platform Support
+
+When adding support for a new platform (e.g., `x86_64-apple-darwin`):
+
+1. Ensure PostgreSQL binaries exist for the platform
+2. Ensure pgvector compiled binaries exist for the platform
+3. Ensure pgbouncer compiled binaries exist for the platform
+4. Add the platform to CI/CD workflows
+5. Test the complete build with all three components
+
+### Current Platform Support
+
+All platforms in `build.rs` and `.github/workflows/release-cli.yml` must have:
+- PostgreSQL from `theseus-rs/postgresql-binaries`
+- pgvector from `nicoloboschi/pgvector_compiled`
+- pgbouncer from `nicoloboschi/pgbouncer_compiled`
+
+## Build Requirements
+
+- **All builds must succeed with all three components bundled**
+- **Build MUST FAIL if any component is missing** for supported platforms
+- No graceful fallbacks - missing components = build failure
+- This ensures platforms are only released when fully functional

versions.env

@@ -1,4 +1,9 @@
 PG_VERSION=18.1.0
 PGVECTOR_VERSION=0.8.1
-PGVECTOR_COMPILED_TAG=v0.18.209
+PGVECTOR_COMPILED_TAG=v0.18.237
 PGVECTOR_COMPILED_REPO=nicoloboschi/pgvector_compiled
+
+# PgBouncer for connection pooling
+PGBOUNCER_VERSION=1.23.1
+PGBOUNCER_COMPILED_TAG=v1.23.1
+PGBOUNCER_COMPILED_REPO=nicoloboschi/pgbouncer_compiled