feat: adopt yankrun test strategy and improve project infrastructure

- Update module path to github.com/AxeForging/structlint
- Refactor tests to use binary-first approach (buildBinary helper)
- Update Makefile with cross-platform builds (9 OS/arch combos)
- Add GitHub Actions workflows for tests and releases
- Create docs/user/ with getting-started, configuration, CLI reference
- Create docs/AI/ with codebase map, contributing guide, testing guide
- Add lefthook.yml for pre-commit hooks (gofmt, govet, commitlint)
- Update .structlint.yaml to allow .claude and .github directories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: machado144

.github/workflows/release.yml

@@ -0,0 +1,62 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Release tag (e.g., v1.0.0)'
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+          cache: true
+
+      - name: Run tests
+        run: go test ./... -v
+
+      - name: Build binaries for all platforms
+        run: VERSION=${{ github.event.inputs.tag }} make build-all
+
+      - name: Create archives
+        run: |
+          cd dist
+          for file in structlint-*; do
+            if [[ "$file" == *.exe ]]; then
+              # Windows: create zip
+              base="${file%.exe}"
+              zip "${base}.zip" "$file"
+              rm "$file"
+            else
+              # Unix: create tar.gz
+              tar -czvf "${file}.tar.gz" "$file"
+              rm "$file"
+            fi
+          done
+          ls -la
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.inputs.tag }}
+          name: Release ${{ github.event.inputs.tag }}
+          generate_release_notes: true
+          draft: false
+          prerelease: false
+          files: |
+            dist/*.tar.gz
+            dist/*.zip

.github/workflows/test.yml

@@ -0,0 +1,54 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+    branches:
+      - main
+      - master
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+          cache: true
+
+      - name: Download dependencies
+        run: go mod download
+
+      - name: Run tests
+        run: go test ./... -v
+
+      - name: Build binary
+        run: make build
+
+      - name: Self-validate
+        run: ./bin/structlint validate --config .structlint.yaml
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+          cache: true
+
+      - name: Run golangci-lint
+        uses: golangci/golangci-lint-action@v6
+        with:
+          version: latest
+          args: --timeout=5m

.structlint.yaml

@@ -11,6 +11,8 @@ dir_structure:
     - "scripts/**"          # Build and utility scripts
     - "bin/**"              # Built binaries
     - "dist/**"             # Distribution files
+    - ".claude/**"          # Claude Code configuration
+    - ".github/**"          # GitHub configuration
   disallowedPaths:
     - "vendor/**"           # Vendor dependencies
     - "node_modules/**"     # Node.js dependencies

Makefile

@@ -1,31 +1,67 @@
 SHELL := /usr/bin/env bash
 APP := structlint
 BIN := bin/$(APP)
-PKG := github.com/youngestaxe/structlint
+PKG := github.com/AxeForging/structlint
+DIST_DIR := dist
+
+# Cross-compilation targets
+GOOS_ARCH := linux/amd64 linux/arm64 linux/386 linux/arm darwin/amd64 darwin/arm64 windows/amd64 windows/arm64 windows/386
+
+# Version information - can be overridden by environment variable
+ifeq ($(origin VERSION), environment)
+  # VERSION is set from environment
+else
+  VERSION := $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
+endif
+
+BUILD_TIME := $(shell date -u '+%Y-%m-%dT%H:%M:%SZ')
+GIT_COMMIT := $(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+BUILT_BY := $(shell whoami)
+
+# Build flags
 LDFLAGS := -s -w \
-  -X $(PKG)/internal/build.Version=$$(git describe --tags --always --dirty) \
-  -X $(PKG)/internal/build.Commit=$$(git rev-parse --short HEAD) \
-  -X $(PKG)/internal/build.Date=$$(date -u +%Y-%m-%dT%H:%M:%SZ) \
-  -X $(PKG)/internal/build.BuiltBy=$$(whoami)
+  -X $(PKG)/internal/build.Version=$(VERSION) \
+  -X $(PKG)/internal/build.Commit=$(GIT_COMMIT) \
+  -X $(PKG)/internal/build.Date=$(BUILD_TIME) \
+  -X $(PKG)/internal/build.BuiltBy=$(BUILT_BY)
 
-.PHONY: all build run test test-self lint tidy clean completion validate-self
+.PHONY: all build build-all run test test-self lint tidy clean completion validate-self fmt format check ci version tag release-check
 
 all: build
 
+# Build for current platform
 build:
 	@mkdir -p bin
-	GOFLAGS="-trimpath" CGO_ENABLED=0 go build -ldflags "$(LDFLAGS)" -o $(BIN) ./cmd/$(APP)
+	CGO_ENABLED=0 go build -trimpath -ldflags "$(LDFLAGS)" -o $(BIN) ./cmd/$(APP)
+	@echo "Built $(BIN) ($(VERSION))"
+
+# Build for all platforms
+build-all:
+	@echo "Building binaries for all platforms..."
+	@echo "Version: $(VERSION)"
+	@echo "Build time: $(BUILD_TIME)"
+	@echo "Git commit: $(GIT_COMMIT)"
+	@mkdir -p $(DIST_DIR)
+	@for t in $(GOOS_ARCH); do \
+		os=$${t%/*}; arch=$${t#*/}; \
+		bin_name=$(APP)-$${os}-$${arch}; \
+		if [ "$$os" = "windows" ]; then bin_name="$${bin_name}.exe"; fi; \
+		bin_path=$(DIST_DIR)/$$bin_name; \
+		echo "  Building for $$os/$$arch..."; \
+		CGO_ENABLED=0 GOOS=$$os GOARCH=$$arch go build -trimpath -ldflags "$(LDFLAGS)" -o $$bin_path ./cmd/$(APP); \
+	done
+	@echo "Build complete. Binaries in $(DIST_DIR)/"
 
 run: build
 	@$(BIN) $(ARGS)
 
 test:
-	go test ./...
+	go test ./... -v
 
 test-self: build
-	@echo "🔍 Validating our own project structure..."
+	@echo "Validating our own project structure..."
 	@$(BIN) validate --config .structlint.yaml --json-output validation-report.json
-	@echo "📊 Validation report saved to validation-report.json"
+	@echo "Validation report saved to validation-report.json"
 
 lint:
 	golangci-lint run --timeout=5m
@@ -34,25 +70,49 @@ tidy:
 	go mod tidy
 
 clean:
-	rm -rf bin validation-report.json
+	rm -rf bin $(DIST_DIR) validation-report.json *.json
 
-completion:
-	@mkdir -p dist/completion
-	@$(BIN) completion bash       > dist/completion/$(APP).bash
-	@$(BIN) completion zsh        > dist/completion/_$(APP)
-	@$(BIN) completion fish       > dist/completion/$(APP).fish
+completion: build
+	@mkdir -p $(DIST_DIR)/completion
+	@$(BIN) completion bash > $(DIST_DIR)/completion/$(APP).bash
+	@$(BIN) completion zsh  > $(DIST_DIR)/completion/_$(APP)
+	@$(BIN) completion fish > $(DIST_DIR)/completion/$(APP).fish
+	@echo "Shell completions generated in $(DIST_DIR)/completion/"
 
 validate-self: test-self
 
 # Development helpers
 fmt:
 	go fmt ./...
-	goimports -w .
 
 format: fmt
-	gofumpt -w .
+	@command -v gofumpt >/dev/null 2>&1 && gofumpt -w . || echo "gofumpt not installed, skipping"
+	@command -v goimports >/dev/null 2>&1 && goimports -w . || echo "goimports not installed, skipping"
 
 check: lint test
 
 # CI/CD helpers
 ci: tidy check build test-self
+
+# Version information
+version:
+	@echo "Version: $(VERSION)"
+	@echo "Build time: $(BUILD_TIME)"
+	@echo "Git commit: $(GIT_COMMIT)"
+	@echo "Built by: $(BUILT_BY)"
+
+# Create a git tag for release
+tag:
+	@if [ "$(VERSION)" = "dev" ]; then \
+		echo "Error: Cannot tag dev version. Set VERSION env var (e.g., VERSION=v1.0.0 make tag)"; \
+		exit 1; \
+	fi
+	@echo "Creating git tag: $(VERSION)"
+	git tag -a $(VERSION) -m "Release $(VERSION)"
+	@echo "Tag created. Push with: git push origin $(VERSION)"
+
+# Build and test before release
+release-check: build-all
+	@echo "Running tests..."
+	go test ./... -v
+	@echo "All tests passed. Ready for release $(VERSION)"

README.md

@@ -27,7 +27,7 @@
 
 ```bash
 # Install
-go install github.com/youngestaxe/structlint@latest
+go install github.com/AxeForging/structlint@latest
 
 # Create a basic config
 cat > .structlint.yaml << 'EOF'
@@ -166,7 +166,7 @@ After: "Create a new API handler following our .structlint.yaml structure:
 
 ```bash
 # Clone and build
-git clone https://github.com/youngestaxe/structlint.git
+git clone https://github.com/AxeForging/structlint.git
 cd structlint
 make build
 

cmd/structlint/main.go

@@ -4,7 +4,7 @@ import (
 	"context"
 	"os"
 
-	"github.com/youngestaxe/structlint/internal/app"
+	"github.com/AxeForging/structlint/internal/app"
 )
 
 func main() {