Reorganize project structure

Signed-off-by: timflannagan <timflannagan@gmail.com>

Author: timflannagan

README.md

@@ -8,13 +8,29 @@ krtequals is designed to catch common bugs in `Equals()` method implementations,
 
 ## Installation
 
+### Standalone CLI
+
+```bash
+go install github.com/kgateway-dev/krtequals/cmd/krtequals@latest
+```
+
+### As a Library
+
+```bash
+go get github.com/kgateway-dev/krtequals
+```
+
+## Usage
+
+### Standalone
+
 ```bash
-go install github.com/kgateway-dev/krtequals@latest
+krtequals ./...
 ```
 
-## Usage with golangci-lint
+### With golangci-lint
 
-krtequals is designed to be used as a [golangci-lint](https://golangci-lint.run/) custom plugin. Add it to your `.golangci.yaml`:
+krtequals can be used as a [golangci-lint](https://golangci-lint.run/) custom plugin. Add it to your `.golangci.yaml`:
 
 ```yaml
 linters-settings:
@@ -26,6 +42,20 @@ linters-settings:
         deepEqual: true  # Enable reflect.DeepEqual detection (optional)
 ```
 
+### Programmatic Usage
+
+```go
+import "github.com/kgateway-dev/krtequals/pkg/analyzer"
+
+// Use the default analyzer
+a := analyzer.Analyzer
+
+// Or create a custom configured analyzer
+a := analyzer.NewAnalyzer(&analyzer.Config{
+    DeepEqual: true,
+})
+```
+
 ## What It Checks
 
 ### Missing Field Comparisons
@@ -87,6 +117,19 @@ type MyStruct struct {
 |--------|------|---------|-------------|
 | `deepEqual` | bool | `false` | Enable detection of `reflect.DeepEqual` usage in `Equals()` methods |
 
+## Project Structure
+
+```
+.
+├── cmd/krtequals/     # Standalone CLI
+│   └── main.go
+├── pkg/analyzer/      # Core analyzer library
+│   ├── analyzer.go    # Main analysis logic
+│   ├── plugin.go      # golangci-lint plugin integration
+│   └── testdata/      # Test fixtures
+└── README.md
+```
+
 ## Development
 
 ### Running Tests
@@ -98,7 +141,7 @@ go test -v ./...
 ### Building
 
 ```bash
-go build ./...
+go build ./cmd/krtequals
 ```
 
 ## License

analyzer_test.go

@@ -0,0 +1,11 @@
+// Command krtequals runs the krtequals analyzer as a standalone tool.
+package main
+
+import (
+	"github.com/kgateway-dev/krtequals/pkg/analyzer"
+	"golang.org/x/tools/go/analysis/singlechecker"
+)
+
+func main() {
+	singlechecker.Main(analyzer.Analyzer)
+}

cmd/krtequals/main.go

@@ -1,4 +1,6 @@
-package krtequals
+// Package analyzer provides a static analysis tool that checks Equals() method
+// implementations for KRT-style semantic equality issues.
+package analyzer
 
 import (
 	"go/ast"
@@ -11,25 +13,23 @@ import (
 	"golang.org/x/tools/go/ast/inspector"
 )
 
-// TODO(tim): Determine if we need to add a way for devs that define an Equals() method that's
-// unrelated to KRT collection to opt out of the analyzer.
-
-// TODO(tim): [krtEqualsNone, krtEqualsTODO] the right naming for these markers?
-
 // Config controls optional checks performed by the krtequals analyzer.
 type Config struct {
 	// DeepEqual toggles the rule that flags usage of reflect.DeepEqual inside Equals methods.
 	// This check is disabled by default for incremental rollout.
 	DeepEqual bool `json:"deepEqual"`
-	// TODO(time): time.Equals() for direct time.Time comparisons
 }
 
-type analyzer struct {
-	cfg Config
-}
+// Analyzer is the default analyzer instance with all checks disabled.
+// Use NewAnalyzer for custom configuration.
+var Analyzer = NewAnalyzer(&Config{})
 
-func newAnalyzer(cfg *Config) *analysis.Analyzer {
-	a := &analyzer{cfg: *cfg}
+// NewAnalyzer creates a new krtequals analyzer with the given configuration.
+func NewAnalyzer(cfg *Config) *analysis.Analyzer {
+	if cfg == nil {
+		cfg = &Config{}
+	}
+	a := &analyzerImpl{cfg: *cfg}
 	return &analysis.Analyzer{
 		Name:     "krtequals",
 		Doc:      "Checks Equals() implementations for KRT-style semantic equality issues",
@@ -38,6 +38,10 @@ func newAnalyzer(cfg *Config) *analysis.Analyzer {
 	}
 }
 
+type analyzerImpl struct {
+	cfg Config
+}
+
 type structInfo struct {
 	name   string
 	fields map[string]*fieldInfo
@@ -51,7 +55,7 @@ type fieldInfo struct {
 	todo     bool
 }
 
-func (a *analyzer) Run(pass *analysis.Pass) (any, error) {
+func (a *analyzerImpl) Run(pass *analysis.Pass) (any, error) {
 	ins := pass.ResultOf[inspect.Analyzer].(*inspector.Inspector)
 
 	structs := collectStructs(ins)

analyzer.go pkg/analyzer/analyzer.goanalyzer.go renamed to pkg/analyzer/analyzer.go

@@ -0,0 +1,25 @@
+package analyzer
+
+import (
+	"testing"
+
+	"golang.org/x/tools/go/analysis/analysistest"
+)
+
+func TestDeepEqualCheckEnabled(t *testing.T) {
+	testdata := analysistest.TestData()
+	a := NewAnalyzer(&Config{DeepEqual: true})
+	analysistest.Run(t, testdata, a, "deepequalon")
+}
+
+func TestDeepEqualCheckDisabled(t *testing.T) {
+	testdata := analysistest.TestData()
+	a := NewAnalyzer(&Config{DeepEqual: false})
+	analysistest.Run(t, testdata, a, "deepequaloff")
+}
+
+func TestMarkers(t *testing.T) {
+	testdata := analysistest.TestData()
+	a := NewAnalyzer(&Config{})
+	analysistest.Run(t, testdata, a, "markers")
+}

pkg/analyzer/analyzer_test.go

@@ -1,4 +1,4 @@
-package krtequals
+package analyzer
 
 import (
 	"github.com/golangci/plugin-module-register/register"
@@ -25,7 +25,7 @@ func New(settings any) (register.LinterPlugin, error) {
 }
 
 func (p *plugin) BuildAnalyzers() ([]*analysis.Analyzer, error) {
-	return []*analysis.Analyzer{newAnalyzer(&p.cfg)}, nil
+	return []*analysis.Analyzer{NewAnalyzer(&p.cfg)}, nil
 }
 
 func (p *plugin) GetLoadMode() string {