chore(release): client v0.11.0

Author: github-actions[bot]

docs/CHANGELOG.md

@@ -2,6 +2,356 @@
 
 <!-- version list -->
 
+## v0.11.0 (2025-11-11)
+
+### Build System
+
+- **deps**: Bump mdformat from 0.7.22 to 1.0.0
+  ([#97](https://github.com/dougborg/stocktrim-openapi-client/pull/97),
+  [`470d704`](https://github.com/dougborg/stocktrim-openapi-client/commit/470d7044606273923b77961f4e36efe9e2de5e7f))
+
+Bumps [mdformat](https://github.com/hukkin/mdformat) from 0.7.22 to 1.0.0. -
+[Commits](https://github.com/hukkin/mdformat/compare/0.7.22...1.0.0)
+
+--- updated-dependencies: - dependency-name: mdformat dependency-version: 1.0.0
+
+dependency-type: direct:production
+
+update-type: version-update:semver-major
+
+...
+
+Signed-off-by: dependabot[bot] <support@github.com>
+
+Co-authored-by: Doug Borg <dougborg@dougborg.org>
+
+- **deps**: Bump openapi-python-client from 0.27.0 to 0.27.1
+  ([`4749d3f`](https://github.com/dougborg/stocktrim-openapi-client/commit/4749d3fa5550dee1fa8f36b7262579601c22d1dc))
+
+Bumps
+[openapi-python-client](https://github.com/openapi-generators/openapi-python-client)
+from 0.27.0 to 0.27.1. -
+[Release notes](https://github.com/openapi-generators/openapi-python-client/releases) -
+[Changelog](https://github.com/openapi-generators/openapi-python-client/blob/main/CHANGELOG.md)
+\-
+[Commits](https://github.com/openapi-generators/openapi-python-client/compare/v0.27.0...v0.27.1)
+
+--- updated-dependencies: - dependency-name: openapi-python-client dependency-version:
+0.27.1
+
+dependency-type: direct:production
+
+update-type: version-update:semver-patch
+
+...
+
+Signed-off-by: dependabot[bot] <support@github.com>
+
+- **deps**: Bump pre-commit from 4.3.0 to 4.4.0
+  ([`57c1849`](https://github.com/dougborg/stocktrim-openapi-client/commit/57c1849c09732a1a56a092b2f02f518ada1350c7))
+
+Bumps [pre-commit](https://github.com/pre-commit/pre-commit) from 4.3.0 to 4.4.0. -
+[Release notes](https://github.com/pre-commit/pre-commit/releases) -
+[Changelog](https://github.com/pre-commit/pre-commit/blob/main/CHANGELOG.md) -
+[Commits](https://github.com/pre-commit/pre-commit/compare/v4.3.0...v4.4.0)
+
+--- updated-dependencies: - dependency-name: pre-commit dependency-version: 4.4.0
+
+dependency-type: direct:production
+
+update-type: version-update:semver-minor
+
+...
+
+Signed-off-by: dependabot[bot] <support@github.com>
+
+- **deps**: Bump pydantic from 2.12.3 to 2.12.4
+  ([`3c4f712`](https://github.com/dougborg/stocktrim-openapi-client/commit/3c4f712f03458d5d7a3ccf82dd382d0620251666))
+
+Bumps [pydantic](https://github.com/pydantic/pydantic) from 2.12.3 to 2.12.4. -
+[Release notes](https://github.com/pydantic/pydantic/releases) -
+[Changelog](https://github.com/pydantic/pydantic/blob/v2.12.4/HISTORY.md) -
+[Commits](https://github.com/pydantic/pydantic/compare/v2.12.3...v2.12.4)
+
+--- updated-dependencies: - dependency-name: pydantic dependency-version: 2.12.4
+
+dependency-type: direct:production
+
+update-type: version-update:semver-patch
+
+...
+
+Signed-off-by: dependabot[bot] <support@github.com>
+
+- **deps**: Bump python-semantic-release from 10.4.1 to 10.5.0
+  ([`89a11ed`](https://github.com/dougborg/stocktrim-openapi-client/commit/89a11ed5011e7ff6cb371c94dca26fd6cd83e4f1))
+
+## Bumps [python-semantic-release](https://github.com/python-semantic-release/python-semantic-release) from 10.4.1 to 10.5.0. - [Release notes](https://github.com/python-semantic-release/python-semantic-release/releases) - [Changelog](https://github.com/python-semantic-release/python-semantic-release/blob/master/CHANGELOG.rst)
+
+[Commits](https://github.com/python-semantic-release/python-semantic-release/compare/v10.4.1...v10.5)
+
+--- updated-dependencies: - dependency-name: python-semantic-release dependency-version:
+10.5.0
+
+dependency-type: direct:production
+
+update-type: version-update:semver-minor
+
+...
+
+Signed-off-by: dependabot[bot] <support@github.com>
+
+### Chores
+
+- **release**: Mcp v0.11.0
+  ([`e129cbb`](https://github.com/dougborg/stocktrim-openapi-client/commit/e129cbb0baba6fd7a17d47e52312fadc43b5af88))
+
+### Documentation
+
+- Add ADRs and update documentation
+  ([#90](https://github.com/dougborg/stocktrim-openapi-client/pull/90),
+  [`ec871c2`](https://github.com/dougborg/stocktrim-openapi-client/commit/ec871c2d02db7e636ee6b233ba428d75e62e7a00))
+
+* docs: add ADRs and update documentation
+
+- Add ADR 002: Tool Interface Pattern (Pydantic + FastMCP) - Add ADR 003: Automated Tool
+  Documentation strategy - Update overview.md and README.md with current features -
+  Organize tool documentation investigation into docs/ - Add session summary for
+  2025-11-07
+
+Related: #84, #85, #86
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+### Features
+
+- Replace product search with keyword search using Order Plan API
+  ([#99](https://github.com/dougborg/stocktrim-openapi-client/pull/99),
+  [`102cae9`](https://github.com/dougborg/stocktrim-openapi-client/commit/102cae9d858581ae3c3cfbd7336ecbf64d53a851))
+
+* feat: replace product search with keyword search using Order Plan API
+
+Replace nearly-useless prefix-based product search with comprehensive keyword search
+that works across product names, codes, and categories.
+
+Changes: - tools/foundation/products.py: - Rename SearchProductsRequest.prefix →
+search_query - Replace Products API call with Order Plan API searchString - Update
+docstring with keyword search examples - tests: Update mocks to use Order Plan API and
+SkuOptimizedResultsDto
+
+Benefits: - Search by product name: "blue widget" - Search by category: "electronics" -
+Search by partial code: "WIDG" matches "WIDGET-001" - Much more useful than prefix-only
+search
+
+Before: search_products(prefix="WIDG") - must know exact prefix
+
+After: search_products(search_query="widget") - natural search
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+- fix: use OrderPlanFilterCriteria instead of DTO for 415 error
+
+The Order Plan API endpoint expects OrderPlanFilterCriteria, not
+OrderPlanFilterCriteriaDto. Using the DTO version caused 415 "Unsupported Media Type"
+errors.
+
+Changes: - Import OrderPlanFilterCriteria instead of OrderPlanFilterCriteriaDto - Update
+test to be more robust when checking call arguments
+
+Fixes the 415 errors seen in production logs.
+
+- feat: add unpack decorator for flattened MCP parameters
+
+Add @unpack_pydantic_params decorator to enable flattened parameter calls instead of
+nested request objects, matching the pattern from katana-mcp.
+
+Changes: - Add unpack.py module with Unpack marker and decorator - Apply decorator to
+search_products tool - Update tests to use flattened parameters
+
+Benefits: - Better DX: search_products(search_query="widget") instead of
+search_products(request={"search_query": "widget"}) - Maintains Pydantic validation
+while exposing flat params to MCP - Compatible with FastMCP's parameter introspection
+
+Pattern from: https://github.com/dougborg/katana-openapi-client
+
+- feat(mcp): implement parameter flattening for all tools
+
+Apply @unpack_pydantic_params decorator to all MCP tools to expose flattened parameters
+instead of nested objects. This improves compatibility with Claude Code and other MCP
+clients that have issues serializing nested parameter objects.
+
+Changes: - Add unpack.py module with @unpack_pydantic_params decorator (from Katana) -
+Apply decorator to all 27 tools across 11 tool files - Update all foundation tool tests
+to use flattened parameters - Add ADR 0001 documenting parameter flattening decision -
+Update README with parameter flattening pattern documentation
+
+Technical Details: The decorator transforms function signatures at import time: - Scans
+for Annotated[Model, Unpack()] parameters - Extracts Pydantic model fields as individual
+KEYWORD_ONLY params - Updates __signature__ and __annotations__ for FastMCP
+introspection - At runtime, reconstructs validated model instances from flat params
+
+This provides: - Flat parameters for MCP protocol compatibility - Pydantic validation
+for type safety - Clean tool code working with typed model objects - Automatic parameter
+documentation from Field descriptions
+
+All 276 tests passing.
+
+Related: Katana MCP implementation (ef59809, 862ce79, a025ca9)
+
+- fix: address PR review feedback
+
+Address review comments from PR #99:
+
+1. Revert nullable supplier code - The SupplierInfo.code field should remain required
+   (str) as it's fundamental for identifying suppliers and the underlying
+   SupplierResponseDto has it as non-nullable.
+
+1. Improve 404 handling documentation - Add detailed comment explaining why StockTrim
+   API returns 404 for "no results" instead of the more conventional 200 with empty
+   list, and why we treat it as expected behavior rather than an error.
+
+1. Fix empty product code handling - Instead of using empty string fallback which
+   violates ProductInfo schema, filter out order plan items that have missing/empty
+   product codes to prevent creating invalid product records.
+
+- **mcp**: Add Docker MCP Registry support
+  ([#93](https://github.com/dougborg/stocktrim-openapi-client/pull/93),
+  [`7428599`](https://github.com/dougborg/stocktrim-openapi-client/commit/74285990b3617fae10f96afac598978b1c45aeae))
+
+* docs: add ADR 001 documenting user confirmation pattern
+
+Add Architecture Decision Record documenting the choice to use FastMCP Elicitation for
+user confirmation on destructive operations.
+
+Documents: - Context and problem statement - 4 options considered (pre-flight,
+parameter, prompt, elicitation) - Decision rationale (MCP-native, industry best
+practice) - Implementation pattern with code examples - Tool categorization by risk
+level - Testing requirements - Consequences and validation criteria
+
+Decision: Use FastMCP Elicitation (MCP native protocol)
+
+Rationale: Standard protocol, strong safety guarantees, rich context,
+
+excellent developer experience
+
+Part of Issue #80 implementation.
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+- test: update purchase order and sales order deletion tests for elicitation
+
+* Replace old deletion tests with elicitation pattern tests - Add imports for
+  AcceptedElicitation, DeclinedElicitation, CancelledElicitation - Test all elicitation
+  response paths (not found, accepted, declined, cancelled) - Align with product and
+  supplier test patterns - All 276 tests passing
+
+- test: implement autospec for service mocks to enforce interface compliance
+
+Use create_autospec() for all service mocks in conftest.py to prevent tests from passing
+while mocking non-existent methods. This ensures that test mocks always match the actual
+service interfaces.
+
+Benefits: - Tests will fail immediately if they mock non-existent methods - Prevents
+bugs where tests pass but production code fails - Provides better refactoring safety -
+Catches method name typos and signature mismatches
+
+This change was implemented after discovering that tests were mocking
+services.suppliers.list_suppliers() instead of list_all(), which allowed the bug to slip
+through to the resource implementation.
+
+All 276 tests pass with autospec enforcement.
+
+Addresses: #82
+
+- fix: add nullable enum support to client regeneration + fix resource bug
+
+1. Add nullable enum field support to regeneration script - Add
+   `add_nullable_to_enum_fields()` function - Mark OrderPlanFilterCriteria.currentStatus
+   as nullable - Fixes "None is not a valid CurrentStatusEnum" errors - Addresses: #83
+
+1. Fix supplier directory resource method name - Change `list_suppliers()` to
+   `list_all()` - This bug was caught by autospec implementation - Related: #82
+
+The regeneration script now handles enum fields that can be null in API responses, using
+the allOf + nullable pattern for OpenAPI 3.0.
+
+- fix: regenerate client with nullable currentStatus enum field
+
+Regenerated Python client from StockTrim OpenAPI spec with the nullable enum field fix
+applied. The currentStatus field in OrderPlanFilterCriteria can now handle null values
+from the API.
+
+Changes: - OrderPlanFilterCriteria.currentStatus is now CurrentStatusEnum | None | Unset
+\- from_dict() properly handles None values without throwing validation errors
+
+This fixes the "None is not a valid CurrentStatusEnum" error when querying order plan
+data.
+
+Fixes: #83
+
+- fix: remove limit parameter from ProductService.list_all() calls
+
+The ProductService.list_all() method doesn't accept a limit parameter, but foundation.py
+was calling it with limit=50. This was caught when testing resources with MCP Inspector
+at runtime.
+
+Root cause: test_foundation.py was using mock_foundation_context which overrode the
+autospec'd services from conftest.py with plain AsyncMock, so tests couldn't catch the
+interface mismatch.
+
+Changes: - foundation.py: Remove limit=50 from list_all() call, use slicing instead -
+test_foundation.py: Remove mock_foundation_context fixture that was overriding
+autospec'd services with plain AsyncMock - test_foundation.py: Update all tests to use
+mock_context directly - test_foundation.py: Fix catalog limit test to verify slicing
+behavior
+
+This ensures autospec catches interface mismatches in resource tests.
+
+- fix: use bulk endpoint for listing all suppliers
+
+The Suppliers.get_all() method was incorrectly using /api/Suppliers endpoint without a
+code parameter, which returns 404. The StockTrim API has separate endpoints for
+different supplier operations: - /api/Suppliers?code=X - returns single supplier
+(requires code) - /api/SuppliersBulk
+
+- returns all suppliers (no parameters)
+
+This is different from other endpoints like Customers and Products which return arrays
+from their main endpoint.
+
+Changes: - Import get_api_suppliers_bulk from generated API - Use bulk endpoint when
+code is UNSET (listing all) - Use single endpoint when code is provided (get specific
+supplier) - Update docstring to clarify the conditional behavior
+
+This fixes the 404 error in the supplier directory MCP resource.
+
+- feat(mcp): add Dockerfile for Docker MCP Registry
+
+Add Dockerfile to support publishing MCP server to Docker Hub via Docker MCP Registry.
+Image installs stocktrim-openapi-client from PyPI and runs the MCP server.
+
+Related to #2
+
+- feat(mcp): add tools.json generation script
+
+Add script to auto-generate tools.json from registered MCP tools to keep Docker MCP
+Registry submission in sync with actual tool implementations.
+
+Script introspects FastMCP tool manager and extracts tool names and descriptions from
+registered tools.
+
+______________________________________________________________________
+
+Co-authored-by: Doug Borg <dougborg@apple.com>
+
+Co-authored-by: Claude <noreply@anthropic.com>
+
 ## v0.10.0 (2025-11-09)
 
 ### Chores

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stocktrim-openapi-client"
-version = "0.10.0"
+version = "0.11.0"
 description = "A modern, pythonic StockTrim Inventory Management API client with automatic retries, rate limiting, and smart pagination"
 authors = [
     {name = "Doug Borg", email = "dougborg@dougborg.org"},

stocktrim_public_api_client/__init__.py

@@ -5,7 +5,7 @@
 retries and custom authentication.
 """
 
-__version__ = "0.10.0"
+__version__ = "0.11.0"
 
 from .stocktrim_client import StockTrimClient
 from .utils import (