ci: skip release when no Solidity source changed

Only create a release when src/**/*.sol files differ from the last
Soldeer-published version. README, CI, docs, and test-only changes
no longer trigger a version bump.

Remove @semantic-release/commit-analyzer so it cannot independently
trigger releases for conventional commits that only touch non-source
files. Claude via analyze-bump.sh is now the sole release gatekeeper.

Also: CLAUDE.md is now a symlink to AGENTS.md, copilot-instructions
updated for current naming.

Author: 0xferit

.github/copilot-instructions.md

@@ -4,12 +4,12 @@
 
 `uint-quantization-lib` is a pure-function Solidity library for shift-based `uint256` compression.
 The core implementation is `UintQuantizationLib` in `src/UintQuantizationLib.sol`, built around
-`Quant` (a `uint16` value type that packs `shift` and `targetBits`).
+`Quant` (a `uint16` value type that packs `discardedBitWidth` and `encodedBitWidth`).
 
 ## Repository-specific guidance
 
 - Keep library functions `internal pure` unless there is a strong reason not to.
-- `Quant` layout is fixed: bits 0-7 = `shift`, bits 8-15 = `targetBits`.
+- `Quant` layout is fixed: bits 0-7 = `discardedBitWidth`, bits 8-15 = `encodedBitWidth`.
 - Keep custom errors file-level with bare names (`BadConfig`, `Overflow`, `NotAligned`).
 - Keep fuzz constraints consistent with existing tests (`bound()` instead of `vm.assume`).
 - For resolution-sensitive flows, prefer `encode(value, true)`; for floor truncation use `encode`.

.releaserc.json

@@ -1,19 +1,6 @@
 {
   "branches": ["main"],
   "plugins": [
-    [
-      "@semantic-release/commit-analyzer",
-      {
-        "preset": "conventionalcommits",
-        "releaseRules": [
-          { "breaking": true, "release": "major" },
-          { "type": "feat", "release": "minor" },
-          { "type": "fix", "release": "patch" },
-          { "type": "perf", "release": "patch" },
-          { "type": "refactor", "release": "patch" }
-        ]
-      }
-    ],
     [
       "@semantic-release/exec",
       {

AGENTS.md

@@ -0,0 +1,63 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`uint-quantization-lib` is a pure-function Solidity library for shift-based `uint256` lossy compression. The core mechanism is floor quantization via right-shifting. A `Quant` value type packs `(discardedBitWidth, encodedBitWidth)` into a single `uint16`, making the compression scheme explicit and reusable. The recommended pattern is `immutable` + `create(discardedBitWidth, encodedBitWidth)`.
+
+## Commands
+
+```bash
+forge build                                                          # compile
+forge test                                                           # all tests (includes 65536 fuzz runs)
+forge test --match-path test/UintQuantizationLib.t.sol               # library tests only
+forge test --match-test test_encodePrecise_notAligned_reverts        # single test
+forge test --match-test testFuzz_                                    # fuzz tests only
+forge test --match-path test/showcase/ShowcaseGas.t.sol --gas-report -vv  # gas benchmarks
+forge fmt                                                            # format Solidity files
+```
+
+## Architecture
+
+### Core library: `src/UintQuantizationLib.sol`
+
+- UDT `Quant` wraps `uint16`: bits 0-7 = discardedBitWidth, bits 8-15 = encodedBitWidth.
+- All library functions are `internal pure`.
+- Errors (`BadConfig`, `Overflow`, `NotAligned`) are file-level, not inside the library block.
+- `using UintQuantizationLib for Quant global` at file bottom propagates method-call syntax to all importers automatically (no local `using` needed).
+- `VERSION` constant is bumped automatically by semantic-release; do not edit it manually.
+
+### Showcase: `src/showcase/ShowcaseSolidityFixtures.sol`
+
+Production-style contracts for gas benchmarks only. Raw vs quantized pairs: `RawETHStakingShowcase` / `QuantizedETHStakingShowcase` (real-life staking) and `RawExtremePackingShowcase` / `QuantizedExtremePackingShowcase` (12 slots into 1).
+
+### Tests: `test/`
+
+- `UintQuantizationLib.t.sol`: `QuantHarness` exposes library via method-call syntax for external calls. `UintQuantizationLibSmokeTest` has concrete regression tests and fuzz tests. Fuzz parameters use `uint8` for discardedBitWidth/encodedBitWidth; use `bound()` over `vm.assume` for value-in-range constraints.
+- `showcase/ShowcaseGas.t.sol`: Asserts quantized paths save >= 32% (real-life) and >= 80% (extreme) gas vs raw on zero-to-nonzero writes.
+
+### Configuration
+
+- `foundry.toml`: optimizer runs = 0x10000, fuzz runs = 0x10000, deps via Soldeer (`libs = ["dependencies"]`).
+- `remappings.txt`: maps `forge-std/` from `dependencies/`.
+
+## Conventions
+
+- Solidity `^0.8.25`, 4-space indentation, NatSpec on public-facing behavior.
+- Errors are file-level with bare names (not namespaced inside the library).
+- Create schemes with `UintQuantizationLib.create(...)`; never use `Quant.wrap(...)` directly.
+- Showcase pairs follow `Raw...` / `Quantized...` naming.
+- Test names: `test_` prefix for concrete, `testFuzz_` for fuzz. Descriptive: `test_encode_overflow_reverts`.
+- Fuzz tests: `uint8` params for scheme dimensions, `bound()` not `vm.assume` for bounding values.
+- Conventional Commits: `feat:`, `fix:`, `ci:`, `docs:`, `chore:`, `refactor:`, `perf:`.
+- If gas numbers change, include before/after output from the showcase gas report.
+
+## Release pipeline
+
+Fully automated on push to main (`.github/workflows/release.yml`):
+1. `scripts/analyze-bump.sh` checks if any `src/**/*.sol` files changed since the last Soldeer publish (`soldeer-published` tag). If no Solidity source changed, no release is created.
+2. If source changed, Claude (Opus, max effort) analyzes the diff and determines the semver bump (major/minor/patch). Falls back to "patch" if Claude is unavailable.
+3. `@semantic-release/exec` bumps the `VERSION` constant in `UintQuantizationLib.sol`.
+4. GitHub release created, CHANGELOG.md + source committed with `[skip ci]`.
+5. `forge soldeer push` publishes to the Soldeer registry, then tags `soldeer-published`.

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

CLAUDE.md

@@ -3,13 +3,9 @@ set -euo pipefail
 
 # Called by @semantic-release/exec as analyzeCommitsCmd.
 # Asks Claude to determine the semantic version bump from the diff.
+# Skips release entirely when no Solidity source files under src/ changed.
 # Falls back to "patch" if the token is missing or the call fails.
 
-if [ -z "${CLAUDE_CODE_OAUTH_TOKEN:-}" ]; then
-  echo "patch"
-  exit 0
-fi
-
 # Comparison base: last successful Soldeer publish, then last release tag, then repo root.
 # This ensures the bump reflects what users actually have, not intermediate failed publishes.
 if git rev-parse soldeer-published >/dev/null 2>&1; then
@@ -20,16 +16,26 @@ else
   BASE=$(git rev-list --max-parents=0 HEAD)
 fi
 
+# No release when library source is unchanged (README, CI, docs, tests are chore).
+SOL_DIFF=$(git diff "$BASE"..HEAD -- 'src/*.sol' 'src/**/*.sol' 2>/dev/null || echo "")
+if [ -z "$SOL_DIFF" ]; then
+  exit 0
+fi
+
+if [ -z "${CLAUDE_CODE_OAUTH_TOKEN:-}" ]; then
+  echo "patch"
+  exit 0
+fi
+
 COMMIT_LOG=$(git log "$BASE"..HEAD --pretty=format:"- %s" 2>/dev/null || echo "- initial release")
 DIFF_STAT=$(git diff "$BASE"..HEAD --stat 2>/dev/null | tail -30 || echo "no diff")
-SOL_DIFF=$(git diff "$BASE"..HEAD -- '*.sol' 2>/dev/null | head -200 || echo "no diff")
 
 PROMPT="You are a semantic versioning expert for a Solidity library (uint-quantization-lib).
 
 Rules:
 - major: breaking changes to the consumer-facing API (renamed functions, changed signatures, renamed/removed errors, changed type definitions)
 - minor: new features (new functions, new error types, new capabilities)
-- patch: bug fixes, docs, CI/CD, tests, internal refactoring, performance improvements
+- patch: bug fixes, internal refactoring, performance improvements
 
 Respond with exactly one word: major, minor, or patch.
 
@@ -40,7 +46,7 @@ Changed files:
 ${DIFF_STAT}
 
 Solidity diff (truncated):
-${SOL_DIFF}"
+$(echo "$SOL_DIFF" | head -200)"
 
 RESPONSE=$(echo "$PROMPT" | claude --print --model opus --effort max 2>/dev/null) || { echo "patch"; exit 0; }