Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions .github/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# GitHub Actions CI — Agent Instructions

## `setup-uv@v7` Cache Behavior

- **Parameter name**: Use `version:` not `uv-version:` — the old name is silently ignored.
- **Cache key**: Exact hash of `uv.lock` + `pyproject.toml` + `*requirements*.txt` + arch/OS/Python. No `restore-keys` fallback — any `uv.lock` change is a total miss.
- **Cache save rule**: GitHub Actions skips save when the key already exists. If job A saves a cache and job B restores it with the same key, job B's changes are never persisted. The first job to complete with a given key "wins."
- **`prune-cache: true` (default)**: Runs `uv cache prune --ci` before save. Source-built wheels survive pruning; pre-built PyPI wheels do not.
- **Implication for source-built deps**: If a job that only validates (e.g. `uv lock --check`) saves the cache before a job that installs (e.g. `uv sync`), the compiled wheel never enters the persisted cache. Either disable caching on the validation job or use a separate `actions/cache` step with a different key.

## `dtolnay/rust-toolchain`

Only needed in jobs that run `uv sync`/`uv pip install` with Rust/PyO3 source deps. Not needed for `uv lock --check` (lockfile validation doesn't build packages).

## `api-simulator` Dependency

Private Rust/PyO3 crate at `TalonT-Org/api-simulator`, built via maturin. Requires `dtolnay/rust-toolchain@stable` and git auth (`GH_USER`/`GH_PAT` secrets via URL rewrite). Gated to `sys_platform == 'linux'` — not built on macOS CI targets.
37 changes: 36 additions & 1 deletion .github/workflows/tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ jobs:
- uses: actions/checkout@v4

- name: Install uv
id: setup-uv
uses: astral-sh/setup-uv@v7
with:
uv-version: "0.9.21"
Expand All @@ -81,8 +82,42 @@ jobs:
- name: Install Rust toolchain
uses: dtolnay/rust-toolchain@stable

- name: Check api-simulator cache status (diagnostic - issue 2135)
run: |
echo "=== uv cache-hit output ==="
echo "Cache hit: ${{ steps.setup-uv.outputs.cache-hit }}"
echo ""
echo "=== uv cache dir ==="
uv cache dir
echo ""
echo "=== Looking for api-simulator in uv cache ==="
find "$(uv cache dir)" -path "*simulator*" -type f 2>/dev/null || echo "api-simulator NOT found in uv cache (will need Rust compilation)"
echo ""
echo "=== uv cache size ==="
du -sh "$(uv cache dir)" 2>/dev/null || echo "cache dir not found"

- name: Install dependencies
run: uv sync --locked --extra dev
run: |
echo "=== Starting uv sync (timestamp: $(date -u +%H:%M:%S)) ==="
uv sync --locked --extra dev -v 2>&1 | tee /tmp/uv-sync.log
echo "=== Finished uv sync (timestamp: $(date -u +%H:%M:%S)) ==="
echo ""
echo "=== Rust/maturin compilation evidence ==="
grep -i "building\|compiling\|maturin\|cargo\|rustc\|Built api" /tmp/uv-sync.log || echo "No Rust compilation detected"
echo ""
echo "=== Cache/wheel reuse evidence ==="
grep -i "cached\|using cached\|found cached\|Installed.*api.simulator" /tmp/uv-sync.log || echo "No cache hit detected for api-simulator"

- name: Post-install api-simulator cache status (diagnostic - issue 2135)
run: |
echo "=== api-simulator in uv cache AFTER install ==="
find "$(uv cache dir)" -path "*simulator*" -type f 2>/dev/null | head -20
echo ""
echo "=== uv cache size AFTER install ==="
du -sh "$(uv cache dir)" 2>/dev/null || echo "cache dir not found"
echo ""
echo "=== Wheel file details ==="
find "$(uv cache dir)" -path "*simulator*" -name "*.whl" -exec ls -lh {} \; 2>/dev/null || echo "No wheel found"

- name: Generate recipe diagrams
run: uv run autoskillit recipes render
Expand Down
Loading