style(proto): ignore tmp-swagger-gen/**/*.swagger.json

proto/Makefile

@@ -55,9 +55,18 @@ test:
 ###############################################################################
 swagger-gen:
 	@gum log --level info "Generating OpenAPI documentation..."
-	@buf generate --template buf.gen.openapi.yaml
-	@gum log --level info "✅ OpenAPI documentation generated in docs/static/openapi/"
-	@gum log --level info "✅ Merged API specification: docs/static/openapi/sonr.swagger.yaml"
+	@$(protoImage) buf generate --template proto/buf.gen.openapi.yaml
+	@gum log --level info "Combining swagger files into unified specification..."
+	@mkdir -p $(GIT_ROOT)/client/docs/swagger-ui
+	@npx swagger-combine $(GIT_ROOT)/client/docs/config.json \
+		-o $(GIT_ROOT)/client/docs/swagger-ui/swagger.yaml \
+		-f yaml \
+		--continueOnConflictingPaths true \
+		--includeDefinitions true
+	@gum log --level info "Cleaning up temporary files..."
+	@rm -rf $(GIT_ROOT)/tmp-swagger-gen
+	@gum log --level info "✅ OpenAPI documentation generated successfully"
+	@gum log --level info "✅ Unified API specification: client/docs/swagger-ui/swagger.yaml"
 
 push:
 	@npx buf push	

proto/buf.gen.openapi.yaml

@@ -1,15 +1,16 @@
 version: v1
 plugins:
   # Generate OpenAPI v2 (Swagger) documentation
+  # Follows Cosmos SDK standard approach: generate to tmp directory, then combine
   - name: openapiv2
-    out: ../docs/static/openapi
+    out: ../tmp-swagger-gen
     opt:
       - logtostderr=true
+      - fqn_for_swagger_name=true
       - simple_operation_ids=true
-      - openapi_naming_strategy=simple
       - json_names_for_fields=true
       - allow_merge=false
-      - output_format=yaml
+      - output_format=json
       # Generate methods without HTTP bindings
       - generate_unbound_methods=true
       # Include service tags