mirror of https://github.com/lukaszraczylo/claude-mnemonic.git synced 2026-06-08 23:39:40 +00:00

Files

T

lukaszraczylo 19514bdc55 docs: add testing documentation and macOS ARM64 known issue

Document the macOS ARM64 CGO linking issue with sqlite-vec-go-bindings
that prevents hybrid package tests from compiling locally.

Added:
- .github/TESTING.md: Comprehensive testing guide with platform-specific
  issues, workarounds, and CI configuration details
- internal/vector/hybrid/README.md: Package-specific documentation
  explaining the macOS limitation
- .github/CI_FIX_SUMMARY.md: Technical details of the CI fix

Key points:
- 41 out of 42 packages test successfully on all platforms
- hybrid package tests fail only on macOS ARM64 (local dev issue)
- Linux CI tests pass with proper build-tags: "fts5" configuration
- Production builds and runtime functionality unaffected

This is a known limitation of sqlite-vec-go-bindings on macOS ARM64
and does not impact CI/CD or production deployments.

2026-01-07 21:27:49 +00:00

2.2 KiB

Raw Blame History

CI Test Failure Fix Summary

Problem

Tests were failing in GitHub Actions for PR #20 because the go-pr.yaml shared workflow didn't support:

CGO_ENABLED=1 (required for sqlite-vec-go-bindings)
Build tags -tags "fts5" (required for SQLite FTS5 support)

Root Cause

The hybrid vector storage feature in PR #20 depends on:

github.com/asg017/sqlite-vec-go-bindings/cgo - requires CGO
SQLite with FTS5 support - requires -tags "fts5" build flag

The shared workflow was running go test without these requirements.

Solution

1. Updated shared-actions (commit 8f7f235)

.github/actions/go-test/action.yml

Added build-tags input parameter
Modified test command to use tags when provided

.github/workflows/go-pr.yaml

Added build-tags input parameter
Set CGO_ENABLED: 1 in test job
Pass tags to test command

.github/workflows/go-release-cgo.yaml

Pass build-tags: "fts5" to go-test action

2. Updated claude-mnemonic (commit `90ab909`)

.github/workflows/ci.yaml

Pass build-tags: "fts5" to shared workflow

What Was Already Working

The workflow-prepare.sh script already handled:

Downloading ONNX runtime libraries
Setting up SQLite on Windows for CGO

Testing Status

✅ Linux CI - Should now pass (ubuntu-latest in GitHub Actions) ⚠️ macOS Local - Still has linking issues (macOS-specific sqlite-vec-go-bindings problem)

The macOS local testing issue is unrelated to CI and is caused by how sqlite-vec-go-bindings links on macOS ARM64 with Homebrew Go. This doesn't affect CI since it runs on Linux.

Verification

The next CI run for PR #20 should pass. The workflow will:

Run workflow-prepare.sh to download ONNX libs
Run go test -tags "fts5" -race -coverprofile=coverage.out -covermode=atomic ./... with CGO_ENABLED=1
All packages including internal/vector/hybrid should compile and test successfully

References

PR #20: https://github.com/lukaszraczylo/claude-mnemonic/pull/20
Failed CI run: https://github.com/lukaszraczylo/claude-mnemonic/actions/runs/20795930707/job/59729327008
shared-actions fix: https://github.com/lukaszraczylo/shared-actions/commit/8f7f235
claude-mnemonic fix: https://github.com/lukaszraczylo/claude-mnemonic/commit/90ab909

2.2 KiB Raw Blame History