Cross-platform CI matrix (Windows, Linux, macOS)

[elijahr]

Problem

Spellbook supports 5 platforms (Claude Code, OpenCode, Codex, Gemini CLI, Crush) across 3 operating systems. CI should prove it works on all of them.

Proposed CI Matrix

strategy:
  matrix:
    os: [ubuntu-latest, macos-latest, windows-latest]
    python-version: ["3.10", "3.11", "3.12", "3.13"]

What to Test

• Installer (install.py --dry-run) on all OS/Python combos
• Unit tests on all combos
• Integration tests (MCP server startup, skill loading) on all combos
• Shell script / Python script parity (critical for Windows)

Current Gap

The repo has shell/PowerShell parity rules (AGENTS.md) but no CI validation that they are actually equivalent across platforms.

[elijahr]

Partially implemented. Python test matrix already covers ubuntu-latest, macos-latest, and windows-latest (introduced in 65c3cd9, "feat: add Windows CI matrix and enforce UTF-8 encoding").

Remaining gaps:

• Node.js tests run on ubuntu-latest only
• Shell integration tests run on ubuntu-latest only
• Python version matrix only covers 3.11 (could expand to 3.10, 3.12, 3.13)

Updating this issue to reflect the remaining scope.