inspiring 0.1.0-rc.3

InspiRING.Pack: a single-primitive ring-packing crate (eprint 2025/1352, Algorithm 1) on top of spiral-rs.
Documentation
# InspiRING.Pack project root Makefile.
#
# Targets dispatch to subprojects under tools/ and (later) the Rust crate.
# Run `make help` for the full list. Conventions:
#
#   <ns>-sync          install/update dependencies for namespace <ns>
#   <ns>-test          run all tests for namespace <ns>
#   <ns>-test-stage    run a single stage's tests (uses STAGE=<name>)
#   <ns>-clean         remove build artifacts for namespace <ns>
#
# Namespaces:
#   oracle             Python reference oracle at tools/python-oracle/
#   crate              Rust crate (this directory; Phase 4 skeleton +)

ORACLE_DIR := tools/python-oracle

FIXTURES_DIR := fixtures

# Cargo lives in this directory (the Rust crate root).
CARGO ?= cargo

.DEFAULT_GOAL := help
.PHONY: help \
        oracle-sync oracle-test oracle-test-stage oracle-test-fast oracle-clean \
        oracle-fixtures \
        crate-fmt crate-fmt-check crate-clippy crate-check crate-test crate-bench crate-doc crate-clean \
        test sync clean

help: ## Show this help
	@awk 'BEGIN { FS = ":.*##"; printf "\n%-22s %s\n", "Target", "Description"; printf "%-22s %s\n", "------", "-----------" } \
	      /^[a-zA-Z_-]+:.*##/ { printf "%-22s %s\n", $$1, $$2 }' $(MAKEFILE_LIST)
	@printf "\nExamples:\n"
	@printf "  make oracle-test                          # run all oracle tests\n"
	@printf "  make oracle-test-stage STAGE=params       # run Stage 0 only\n"
	@printf "  make crate-check                          # cargo check the Rust crate\n"
	@printf "  make crate-test                           # cargo test the Rust crate\n\n"

# ---- Aggregate targets (operate across all namespaces) ----

sync: oracle-sync ## Install/update all dependencies (Rust toolchain auto-installed by rust-toolchain.toml)

test: oracle-test crate-test ## Run all tests across all namespaces

clean: oracle-clean crate-clean ## Remove all build/test artifacts

# ---- Python oracle (tools/python-oracle/) ----

oracle-sync: ## Install/update Python oracle dependencies via uv
	cd $(ORACLE_DIR) && uv sync

oracle-test: oracle-sync ## Run the full Python oracle pytest suite (verbose)
	cd $(ORACLE_DIR) && uv run pytest -v

oracle-test-fast: oracle-sync ## Run the full Python oracle pytest suite (quiet)
	cd $(ORACLE_DIR) && uv run pytest -q

oracle-test-stage: oracle-sync ## Run one stage's tests; usage: make oracle-test-stage STAGE=<name>
	@if [ -z "$(STAGE)" ]; then \
	  echo "Usage: make oracle-test-stage STAGE=<name>"; \
	  echo "Available stages:"; \
	  ls $(ORACLE_DIR)/tests/test_*.py 2>/dev/null | sed 's|.*/test_||;s|\.py$$||' | awk '{ printf "  - %s\n", $$0 }'; \
	  exit 1; \
	fi
	cd $(ORACLE_DIR) && uv run pytest -v tests/test_$(STAGE).py

oracle-fixtures: oracle-sync ## Regenerate JSON fixtures into ./fixtures/ for the Rust crate
	cd $(ORACLE_DIR) && uv run python scripts/generate_fixtures.py --output ../../$(FIXTURES_DIR)

oracle-clean: ## Remove Python oracle build/test artifacts
	rm -rf $(ORACLE_DIR)/.pytest_cache $(ORACLE_DIR)/.hypothesis
	find $(ORACLE_DIR) -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
	find $(ORACLE_DIR) -type d -name '*.egg-info' -exec rm -rf {} + 2>/dev/null || true

# ---- Rust crate (this directory) ----
#
# Requires the stable Rust toolchain pinned in rust-toolchain.toml.
# rustup auto-installs the right toolchain via rust-toolchain.toml.

crate-fmt: ## cargo fmt the Rust crate
	$(CARGO) fmt --all

crate-fmt-check: ## cargo fmt --check the Rust crate
	$(CARGO) fmt --all -- --check

crate-clippy: ## cargo clippy on the Rust crate (warnings denied)
	$(CARGO) clippy --all-targets --all-features -- -D warnings

crate-check: ## cargo check the Rust crate
	$(CARGO) check --all-targets --all-features

crate-test: ## cargo test the Rust crate (skeleton smoke test in Phase 4)
	$(CARGO) test --all-features

crate-bench: ## cargo bench the Rust crate (Phase 10 benchmarks)
	$(CARGO) bench

crate-doc: ## cargo doc --open for the Rust crate
	$(CARGO) doc --no-deps --open

crate-clean: ## cargo clean the Rust crate
	$(CARGO) clean