feat(cli): support filtered OpenAPI specs

[miclle]

Summary

Add a post-generation filter pipeline so fox-openapi can derive narrower OpenAPI documents from the full generated contract.

Changes

• Add reusable Go filters for operation predicates and unused component pruning.
• Add repeatable --filter / filters: expressions with =, ==, !=, and || support.
• Keep legacy --filter-extension / --exclude-extension-value flags as hidden compatibility options.
• Wire filters through entry-based driver generation and route manifest generation.
• Refresh English and Chinese README guidance around auto-discovered entries, filtered specs, and CLI flags.

Validation

• go test ./...

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, allowing users to exclude operations based on extension values and prune unused components. Key changes include new CLI flags, updated configuration schemas, and documentation for these features. Feedback identifies performance inefficiencies in the reachability analysis due to repeated marshaling and points out fragile string parsing in the filter and JSON pointer logic. Additionally, the reviewer noted that errors from the generation pipeline are currently ignored in several public methods, which could result in silent failures.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, allowing operations to be excluded based on extension values and unused components to be pruned. These features are exposed via new CLI flags (--filter, --prune-unused-components) and a WithFilters option in the Go API. The update also includes a new filter expression parser, enhanced error handling in the generation pipeline, and updated documentation. Review feedback suggests improving the filter parser to handle escaped single quotes and notes that the generator's state management should be verified to prevent inconsistent cached specifications when filters fail.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces post-generation filtering for OpenAPI specifications, allowing users to exclude operations based on extension values (e.g., x-public) and prune resulting unused components. The changes include a new expression-based filter language, CLI flags (--filter, --prune-unused-components), and library support via the WithFilters option and SpecErr method. Feedback indicates that the component pruning logic currently misses references within discriminator.mapping and link.operationRef fields. Additionally, there is a concern that the Spec() method's silent error handling may return unfiltered specifications if a filter fails, which could be misleading for users.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, enabling users to exclude operations based on extension values and prune unused components via new CLI flags and configuration options. Documentation has been updated to reflect these changes. Feedback was provided regarding a potential panic in the filtering logic when comparing non-comparable extension types, suggesting the use of the scalarEqual helper for safety.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, allowing operations to be excluded based on extension values and unused components to be pruned. The implementation includes new CLI flags, configuration options, and updated documentation in English and Chinese. Additionally, the Generator now provides enhanced error handling for the generation process. Feedback was provided regarding the scalarEqual function in filter.go, suggesting the use of type switches instead of string-based comparisons to ensure more robust equality checks across different scalar types.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, enabling users to exclude operations based on extension values and prune unused components. Key additions include new CLI flags (--filter, --prune-unused-components), corresponding configuration fields, and a library API via the WithFilters option. The documentation has been extensively updated to reflect these features and clarify entry function discovery. Review feedback highlights an opportunity to improve numeric filtering by adding numeric parsing to the expression evaluator and notes that the modification to Spec() returning nil on failure constitutes a breaking change for library consumers.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, enabling users to exclude operations based on extension values and prune unused components. It adds new CLI flags, updates the configuration schema, and enhances the library API with filtering options. Documentation has been updated to reflect these changes. Feedback identified a bug in the reachability analysis where simple schema names in discriminator mappings are not correctly resolved, which could lead to incorrect pruning of referenced components.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, enabling the exclusion of operations based on extension values and the pruning of unused components. These features are supported via new CLI flags, configuration options, and an updated generation pipeline. Documentation has been expanded to cover these additions. Feedback was provided concerning the reachability analysis used for pruning, specifically suggesting that the logic for identifying discriminator mappings be tightened to avoid false positives from regular properties named 'mapping'.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, allowing users to exclude operations based on extension values and prune unused components. It adds new CLI flags (--filter, --prune-unused-components), updates the configuration schema, and enhances the Generator API with error-aware methods like SpecErr. Documentation in both English and Chinese has been updated to reflect these features and improved entry function discovery. Feedback was provided to simplify the scalarEqual logic in filter.go to improve readability by consolidating type checks.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, allowing operations to be excluded based on extension values and unused components to be pruned. It adds new CLI flags, updates the configuration schema, and provides a programmatic Go API for these features. Documentation in both English and Chinese has been updated accordingly. Feedback suggests clarifying that *Config in entry function signatures is a placeholder for user-defined types to avoid ambiguity for new users.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request implements a post-generation filtering system for OpenAPI specifications, allowing for the exclusion of operations based on extension values and the pruning of unused components. The changes include new CLI flags (--filter, --prune-unused-components), updated configuration structures, and an enhanced Generator API with improved error handling. Review feedback points out that the ExcludeOperationsWithExtensionValue helper's automatic deletion of extensions is inconsistent with the non-destructive behavior of CLI filters. Additionally, it was suggested to document or deprecate the Spec() method, as it now suppresses generation errors that may occur during the filtering stage.

[miclle]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces a post-generation filtering system for OpenAPI specifications, enabling users to exclude operations based on extension values and prune unused components through new CLI flags and configuration options. The Generator API has been updated to support these filters and provides enhanced error handling via new methods like SpecErr. Feedback was provided regarding the performance impact of using JSON serialization for specification cloning, suggesting a more direct traversal to avoid overhead in performance-sensitive environments.