feat: add gRPC-protoc framework support

.github/workflows/ci.yml

@@ -99,5 +99,11 @@ jobs:
           java-version: "25"
           distribution: "temurin"
 
+      - name: Set up Protoc
+        uses: arduino/setup-protoc@v3
+
+      - name: Set up protoc-gen-connect-openapi
+        run: go install github.com/sudorandom/protoc-gen-connect-openapi@latest
+
       - name: Run E2E tests
         run: make test-e2e

CLAUDE.md

@@ -29,11 +29,11 @@ make verify
 
 ## Architecture Overview
 
-Spec Forge is a CLI tool that generates enriched OpenAPI specifications from Spring Boot projects.
+Spec Forge is a CLI tool that generates enriched OpenAPI specifications from various frameworks (Spring Boot, go-zero, gRPC-protoc).
 
 **Core workflow:**
 ```
-Source Code → Detect → Patch → Generate → Validate → Enrich → Restore
+Source Code → Detect → Patch → Generate → Validate → Enrich → Publish
 ```
 
 ### Package Structure
@@ -43,27 +43,41 @@ cmd/                      # Cobra CLI commands
 ├── root.go               # Entry point, config initialization
 ├── generate.go           # `spec-forge generate` - full pipeline
 ├── enrich.go             # `spec-forge enrich` - standalone enrichment
-├── spring.go             # `spec-forge spring` - patch/detect subcommands
+├── publish.go            # `spec-forge publish` - publish to platforms
 
 internal/
 ├── config/               # Viper configuration loading
 ├── executor/             # Shell command execution with timeout
 ├── extractor/            # OpenAPI spec extraction
 │   ├── types.go          # GenerateOptions, GenerateResult, etc.
-│   └── spring/           # Spring Boot specific implementation
-│       ├── detector.go   # Project type detection (Maven/Gradle)
-│       ├── patcher.go    # springdoc dependency injection
-│       ├── generator.go  # Maven/Gradle command execution
-│       ├── maven.go      # POM parsing, spring-boot plugin config
-│       └── gradle.go     # build.gradle parsing
+│   ├── builtin/          # Built-in extractor registry
+│   ├── spring/           # Spring Boot implementation
+│   │   ├── detector.go   # Project type detection (Maven/Gradle)
+│   │   ├── patcher.go    # springdoc dependency injection
+│   │   ├── generator.go  # Maven/Gradle command execution
+│   │   ├── maven.go      # POM parsing, spring-boot plugin config
+│   │   └── gradle.go     # build.gradle parsing
+│   ├── gozero/           # go-zero implementation
+│   │   ├── detector.go   # go.mod parsing, dependency detection
+│   │   ├── patcher.go    # go-swagger installation check
+│   │   └── generator.go  # goctl command execution
+│   └── grpcprotoc/       # gRPC-protoc implementation
+│       ├── detector.go   # .proto file detection, buf.yaml rejection
+│       ├── patcher.go    # protoc tools check
+│       ├── generator.go  # protoc command execution
+│       └── grpcprotoc.go # Info struct with ProtoFiles, ServiceProtoFiles
 ├── validator/            # kin-openapi validation
-└── enricher/             # LLM-based description enrichment
-    ├── enricher.go       # Main enricher interface
-    ├── config.go         # Enricher configuration
-    ├── prompt/           # Prompt templates
-    ├── processor/        # Batching and concurrent processing
-    └── provider/         # LLM providers (factory pattern)
-        └── factory.go    # Use NewProvider(cfg Config) to create providers
+├── enricher/             # LLM-based description enrichment
+│   ├── enricher.go       # Main enricher interface
+│   ├── config.go         # Enricher configuration
+│   ├── prompt/           # Prompt templates
+│   ├── processor/        # Batching and concurrent processing
+│   ├── specctx/          # Spec context extraction (reserved for future)
+│   └── provider/         # LLM providers (factory pattern)
+│       └── factory.go    # Use NewProvider(cfg Config) to create providers
+└── publisher/            # OpenAPI spec publishing
+    ├── local.go          # Local file publishing
+    └── readme.go         # ReadMe.com publishing via rdme CLI
 ```
 
 ### Data Flow

README.md

@@ -99,9 +99,33 @@ LLM_API_KEY="sk-xxx" spec-forge enrich ./openapi.json \
 |----------------------------------------------------------------------------------------------------------------------------------------------|----------------|----------------|
 | [Spring Boot](https://springdoc.org/#plugins)                                                                                                | Java           | ✅ Supported    |
 | [go-zero](https://go-zero.dev/reference/cli-guide/swagger/)                                                                                  | Go             | ✅ Supported    |
+| [gRPC (protoc)](https://github.com/sudorandom/protoc-gen-connect-openapi)                                                                    | Multi-language | ✅ Supported    |
 | [Hertz](https://github.com/hertz-contrib/swagger-generate/tree/main/protoc-gen-http-swagger)                                                 | Go             | 🚧 Coming soon |
 | [Kitex](https://github.com/hertz-contrib/swagger-generate/tree/main/protoc-gen-rpc-swagger)                                                  | Go             | 🚧 Coming soon |
-| [gRPC](https://github.com/grpc-ecosystem/grpc-gateway?tab=readme-ov-file#6-optional-generate-openapi-definitions-using-protoc-gen-openapiv2) | Multi-language | 🚧 Coming soon |
+
+### gRPC Projects (Native protoc)
+
+For gRPC projects using native protoc (not buf-managed):
+
+```bash
+# Generate OpenAPI spec from proto files
+spec-forge generate ./my-grpc-project
+
+# With additional import paths
+spec-forge generate ./my-grpc-project --proto-import-path ./third_party --proto-import-path ./vendor
+
+# Generate with AI enrichment
+LLM_API_KEY="your-key" spec-forge generate ./my-grpc-project --enrich --language zh
+```
+
+**Requirements:**
+- `protoc` installed ([install guide](https://github.com/protocolbuffers/protobuf/releases))
+- `protoc-gen-connect-openapi` installed:
+  ```bash
+  go install github.com/sudorandom/protoc-gen-connect-openapi@latest
+  ```
+
+**Note:** buf-managed projects are not supported in this mode. Use `buf generate` with the plugin, then use `spec-forge enrich` on the generated OpenAPI spec.
 
 ## Supported Publishers
 

cmd/generate.go

@@ -44,6 +44,8 @@ var (
 	generatePublishTarget string
 	// generatePublishOverwrite controls whether to overwrite existing remote spec
 	generatePublishOverwrite bool
+	// generateProtoImportPaths are additional import paths for protoc (-I flags)
+	generateProtoImportPaths []string
 )
 
 // generateCmd represents the generate command
@@ -123,10 +125,11 @@ func runGenerate(cmd *cobra.Command, args []string) error { //nolint:gocyclo //
 	}
 
 	genOpts := &extractor.GenerateOptions{
-		OutputDir: outputDir,
-		Format:    config.Get().Output.Format,
-		Timeout:   generateTimeout,
-		SkipTests: true,
+		OutputDir:        outputDir,
+		Format:           config.Get().Output.Format,
+		Timeout:          generateTimeout,
+		SkipTests:        true,
+		ProtoImportPaths: generateProtoImportPaths,
 	}
 
 	genResult, err := extractorImpl.Generate(ctx, path, info, genOpts)
@@ -262,6 +265,8 @@ func init() {
 		"publish target (local, readme)")
 	generateCmd.Flags().BoolVar(&generatePublishOverwrite, "publish-overwrite", false,
 		"overwrite existing spec (applies to both local and remote publishers)")
+	generateCmd.Flags().StringSliceVar(&generateProtoImportPaths, "proto-import-path", nil,
+		"additional import paths for protoc (-I flags), can be specified multiple times")
 }
 
 // enrichGeneratedSpec enriches the generated spec with AI-generated descriptions