CHANGELOG¶

v0.31.0 (2025-11-05)¶

Bug Fixes¶

ci: Convert pre-commit to local hooks via uv (#135, 12d86d6)
copilot: Address review comments on custom agent definitions (#139, b1558f4)
mcp: Address PR review comments on purchase order tools (#125, 5f1351b)
test: Use .test TLD for mock URLs to avoid DNS lookups (#140, 5e78ef8)

Chores¶

actions)(deps: Bump the github-actions group with 6 updates (#130, 4da0481)
docker)(deps: Bump python in /katana_mcp_server (#129, 286b536)
release: Mcp v0.6.0 (ec773ed)

Documentation¶

Initial plan for custom GitHub Copilot agents (#139, b1558f4)
Update workflows README with automated dependency management (#122, 30510f5)

Features¶

Add automated MCP dependency update workflow (#122, 30510f5)
Add custom GitHub Copilot agents for specialized tasks (#139, b1558f4)
Define custom GitHub Copilot agents for specialized development tasks (#139, b1558f4)
mcp: Add structured logging with performance metrics (dbba41e)
mcp: Add stub purchase order foundation tools (#125, 5f1351b)
mcp: Automate MCP dependency updates on client releases (#122, 30510f5)
mcp: Implement create_purchase_order with real API integration (#125, 5f1351b)
mcp: Implement purchase order foundation tools (#125, 5f1351b)
mcp: Implement receive_purchase_order with real API integration (#125, 5f1351b)
mcp: Implement verify_order_document tool (#125, 5f1351b)

Performance Improvements¶

mcp: Optimize variant fetching with API-level ID filtering (#125, 5f1351b)

Testing¶

mcp: Add comprehensive logging tests and documentation (dbba41e)

v0.30.0 (2025-11-05)¶

Chores¶

Clean up trigger file (#121, b5346bc)
Trigger push of README badge changes (#121, b5346bc)
infra: Add Dependabot configuration for GitHub Actions and Docker updates (#119, 555122b)
infra: Add Dependabot configuration for weekly dependency updates (#119, 555122b)
infra: Remove Python pip config from Dependabot (uv incompatibility) (#119, 555122b)

Continuous Integration¶

Add path filters to skip CI for docs-only changes (#123, 722a6f8)
Add path filters to skip unnecessary CI runs (#123, 722a6f8)

Documentation¶

Add CI, coverage, and docs status badges to README (#121, b5346bc)
Add CI, coverage, docs, and security status badges to README (#121, b5346bc)
client: Fix inline comment to reflect actual priority order (#117, 509a010)

Features¶

client: Add netrc support for API authentication (#117, 509a010)
client: Add ~/.netrc support for API authentication (#117, 509a010)

Refactoring¶

client: Address code review feedback (#117, 509a010)
client: Improve hostname extraction robustness and type safety (#117, 509a010)
client: Improve netrc hostname extraction robustness (#117, 509a010)

v0.29.0 (2025-11-05)¶

Bug Fixes¶

client: Correct BatchCreateBomRowsRequest field name from bom_rows to data (#115, 5bb9918)

Chores¶

release: Mcp v0.4.0 (c3594e4)
release: Mcp v0.5.0 (0c67647)

Documentation¶

Fix 66 OpenAPI spec example warnings (#116, d20997c)

Features¶

mcp: Complete unified item CRUD interface (9c123e3)
mcp: Migrate to StockTrim architecture with unified item creation (8645d9d)

v0.28.0 (2025-11-05)¶

Bug Fixes¶

Address additional review feedback on PR #78 (#78, 0547845)
Address code review feedback from PR #78 (#78, 0547845)
Correct Product converter to use archived_at instead of deleted_at (#78, 0547845)
Remove reference to non-existent variant.product_or_material_name field (#78, 0547845)
Update devcontainer and deployment docs with corrected MCP doc references (#78, 0547845)
Update MCP issue creation scripts to reference new documentation paths (#78, 0547845)

Chores¶

client: Regenerate client after removing product_or_material_name field (fa53c7c)

Continuous Integration¶

Prevent race conditions in release workflow with proper concurrency control (#109, 4fc496f)

Documentation¶

Create AGENT_WORKFLOW.md for AI agent development guide (#78, 0547845)
Enhance agent coordination guidelines with detailed patterns (#110, 9478f42)
Update copilot-instructions.md and CLAUDE.md with uv and validation tiers (#107, 9d3c383)
mcp: Add StockTrim architecture migration plan (#112, 8d081e4)
mcp: Reorganize MCP documentation and align issues with v0.1.0 plan (#78, 0547845)

Features¶

client: Add Product, Material, Service domain models with helper integration (#78, 0547845)
client: Add Pydantic domain models for ETL and data processing (#78, 0547845)
client: Add pytest-xdist for parallel test execution (#111, c96bee1)
client+mcp: Add Pydantic domain models for catalog entities (#78, 0547845)

v0.27.0 (2025-10-28)¶

Bug Fixes¶

Correct incomplete sentence in import comment (#72, 6d046f2)
client: Implement client-side fuzzy search for products (4fa5907)
client: Use enum for extend parameter in variant search (ad36ea9)
client+mcp: Handle nested product_or_material object in variant responses (9dd0251)
mcp: Configure semantic-release to update init.py version (#75, fd58272)
mcp: Correct context access pattern to use request_context.lifespan_context (#75, fd58272)
mcp: Correct semantic-release paths for subdirectory execution (#75, fd58272)
mcp: Correct semantic-release paths for subdirectory execution (#74, 804beee)
mcp: Extract SKU from first product variant in search results (d4c8594)
mcp: Implement proper FastMCP tool registration pattern (b6aee3c)
mcp: Import tools/resources/prompts modules to register decorators (#70, de4eaa2)
mcp: Register tools with MCP server and release v0.1.0 (#70, de4eaa2)
mcp: Use context.server_context instead of context.state (#75, fd58272)
mcp: Use full path to uv and add prerequisites documentation (a95feb3)
spec: Remove non-existent product_or_material_name field from Variant schema (b04fa35)

Chores¶

Add pytest to pre-commit hooks (#75, fd58272)
Remove CLIENT_README.md with Poetry references (#72, 6d046f2)
Remove generated CLIENT_README.md and stop generating it (#72, 6d046f2)
Update uv.lock after rebase (d72fb38)
mcp: Remove alpha version specifier for v0.1.0 release (#70, de4eaa2)
mcp: Sync version to 0.2.0 in init.py (#75, fd58272)
release: Mcp v0.2.0 (59989e8)
release: Mcp v0.2.1 (f3ce21e)
release: Mcp v0.3.0 (70d5546)

Documentation¶

mcp: Improve comment explaining side-effect imports (#71, 0910a93)

Features¶

client: Add variant search caching with relevance ranking (754a3c8)
client+mcp: Format variant names to match Katana UI (78922b9)
mcp: Add Docker support and MCP registry submission materials (#73, 01f1671)
mcp: Add hot-reload development workflow with mcp-hmr (0bcc707)

Refactoring¶

Address code review feedback (5112abb)
Extract variant display name logic to shared utility (ed33fc8)
Use generated API models instead of dicts in client helpers (#75, fd58272)
client+mcp: Search variants instead of products (d22ac02)
mcp: Add error handling, logging, and validation to tools (#75, fd58272)
mcp: Use importlib.metadata for version instead of hardcoded string (#75, fd58272)

Testing¶

mcp: Update inventory tool tests for new interfaces (#75, fd58272)

v0.26.5 (2025-10-27)¶

Bug Fixes¶

Add Production enum option for InventoryMovement resource_type (#69, 1962398)

Chores¶

Remove and ignore claude settings file (#69, 1962398)

v0.26.4 (2025-10-27)¶

Bug Fixes¶

Correct MCP artifact upload path (336fe14)

v0.26.3 (2025-10-27)¶

Bug Fixes¶

Use inputs context instead of github.event.inputs (78924e5)

v0.26.2 (2025-10-27)¶

Bug Fixes¶

Handle skipped release steps in build conditions (f565b7a)

v0.26.1 (2025-10-27)¶

Bug Fixes¶

Correct boolean comparison in workflow_dispatch conditions (a4d3c54)

v0.26.0 (2025-10-26)¶

Bug Fixes¶

mcp: Correct semantic-release paths for subdirectory execution (7b4119e)
mcp: Use python -m build instead of uv build in semantic-release (c7071c2)
mcp: Use same build_command pattern as client - format changelog only (7603014)

Chores¶

Remove duplicate Release MCP Server workflow (314c591)
release: Mcp v0.1.0 (93e2583)

Documentation¶

Add comprehensive monorepo semantic-release guide (#68, db1eef3)
Add MCP deployment summary (#68, db1eef3)
Update all documentation for monorepo semantic-release (#68, db1eef3)
Update deployment docs and fix release workflow (#68, db1eef3)
mcp: Update DEPLOYMENT.md for automated semantic-release (#68, db1eef3)

Features¶

Add manual publish triggers for both packages (29c1377)
Prepare MCP server v0.1.0a1 for PyPI deployment (#68, db1eef3)
mcp: Configure monorepo semantic-release for independent versioning (#68, db1eef3)

v0.25.0 (2025-10-24)¶

Bug Fixes¶

client: Remove invalid root_options parameter from workflow (8e313f3)

Features¶

mcp: Add package README for better documentation (9f9cebf)

v0.24.0 (2025-10-24)¶

Documentation¶

Add comprehensive monorepo semantic-release guide (#67, b10ad4a)
Add MCP deployment summary (#67, b10ad4a)
Update all documentation for monorepo semantic-release (#67, b10ad4a)

Features¶

Prepare MCP server v0.1.0a1 for PyPI deployment (#67, b10ad4a)
mcp: Configure monorepo semantic-release for independent versioning (#67, b10ad4a)

v0.23.0 (2025-10-24)¶

Features¶

Implement MCP Server v0.1.0-alpha with 3 inventory tools, comprehensive tests, and documentation (#66, ef22a8c)

v0.22.0 (2025-10-23)¶

Bug Fixes¶

Add future annotations import for Python 3.11 compatibility (#62, ea504d1)
Add type parameters to dict return types in MCP scripts (3ca82d1)
Resolve mypy type errors in domain helpers (#62, ea504d1)

Chores¶

Remove temporary CI cache refresh comment (#62, ea504d1)
Trigger CI re-run after annotations fix (#62, ea504d1)

Continuous Integration¶

Force cache refresh for test environment (#62, ea504d1)
Use SEMANTIC_RELEASE_TOKEN for protected branch bypass (#62, ea504d1)

Documentation¶

Accept ADR-007 and add domain helpers implementation plan (#62, ea504d1)
Accept ADR-007 and add domain helpers implementation plan (#61, 6fa8526)
Accept ADR-010 with monorepo approach using uv workspace (8fcdb5c)
Add ADR-010 for Katana MCP server implementation (eea4b21)
Add issue number mapping to MCP implementation plan (#59, d3e2764)
Add MCP server setup completion summary (f386182)
Add release workflow setup guide with PAT instructions (#62, ea504d1)
Add Repository Rulesets setup guide for automated releases (#62, ea504d1)
Finalize ADR-010 with purchase orders and answer open questions (da22985)
Move ADR-009 and ADR-010 to accepted list in README (5c9fce7)
Split release documentation into separate RELEASE.md (#62, ea504d1)
Update all Poetry references to uv throughout documentation (f550972)

Features¶

Add GitHub Codespaces devcontainer with prebuilds for MCP server development (1a8da47)
Add MCP server implementation plan and issue generation (ca2779b)
Create katana_mcp_server package structure (4d7da0f)
Implement Inventory domain class with full CRUD support (Phase 1 of #60) (#62, ea504d1)
Set up uv workspace for monorepo (4f31a93)
mcp: Implement basic FastMCP server with authentication (#58, 9cdfbff)
mcp: Implement basic FastMCP server with authentication (MCP-03) (#58, 9cdfbff)

Refactoring¶

Split into 5 domain classes with proper separation (#62, ea504d1)
Use getattr() instead of hasattr() for attribute checking (#62, ea504d1)
Use models-only parameters in domain helpers (#62, ea504d1)

v0.21.0 (2025-10-21)¶

Chores¶

Regenerate client with improved docstring formatting (4b66b20)

Features¶

Add comprehensive cookbook documentation and examples (59ebc5e)

Testing¶

Add comprehensive edge case tests for transport layer (5dadd7a)
Add comprehensive KatanaClient init and integration tests (1602409)
Add comprehensive tests for RateLimitAwareRetry class (f566057)

v0.20.0 (2025-10-21)¶

Chores¶

Update uv.lock and CLIENT_README from regeneration (9d4f781)

Features¶

Add comprehensive validation constraints for ISO standards and data formats (241ba05)

v0.19.1 (2025-10-20)¶

Bug Fixes¶

Add minItems constraint to UpdateProductRequest configs field (ed1f7b3)

v0.19.0 (2025-10-20)¶

Features¶

Add type overloads for unwrap() to improve type safety (9e6c656)

v0.18.0 (2025-10-20)¶

Features¶

Enhanced validation error logging with nested details support (66ee086)

v0.17.0 (2025-10-20)¶

Chores¶

Ignore Claude local settings file (53243c2)

Documentation¶

Simplify README to focus on KatanaClient only (eaf43f4)
Update CLAUDE.md to focus on KatanaClient only (ec2915b)

Features¶

Comprehensive error logging improvements (5958927)

v0.16.1 (2025-10-20)¶

Bug Fixes¶

Correct SerialNumber endpoint response schemas to match actual API (5a3ce74)

Documentation¶

Optimize documentation build (112x size reduction, 2x speed improvement) (88a7baf)

v0.16.0 (2025-10-17)¶

Continuous Integration¶

Complete migration to uv across all workflows and add optimizations (f856a1c)
Upgrade to setup-uv@v7 and consolidate Python setup (ac2851f)

Documentation¶

Accept ADR-009 for Poetry to uv migration (9dafbbb)
Add ADR-009 for Poetry to uv package manager migration (7a29915)
Update CLAUDE.md and ADR docs to reflect consolidation changes (49cef79)

Features¶

Migrate from Poetry to uv package manager (ADR-009) (570ab88)

v0.15.0 (2025-10-17)¶

Documentation¶

Add Architecture Decision Records (ADRs) infrastructure (41eacdd)
Clean up temporary analysis files and consolidate documentation (dc0fcd9)

Features¶

Add comprehensive codebase assessment and coverage analysis (c7befd7)

v0.14.1 (2025-10-17)¶

Bug Fixes¶

Correct unwrap_data type overloads and handle single objects (6bb7500)

v0.14.0 (2025-10-17)¶

Documentation¶

Improve documentation deployment configuration (82477bc)
Update documentation to reflect current retry logic and remove outdated content (5ba4b48)

Features¶

Add response unwrapping and error handling utilities (a237907)

v0.13.1 (2025-10-15)¶

Bug Fixes¶

Add missing status_forcelist to enable retry logic for 429 errors (ad4cbb3)

v0.13.0 (2025-10-10)¶

Features¶

Add smart retry logic for non-idempotent operations (64de3e6)

v0.12.1 (2025-10-10)¶

Bug Fixes¶

Handle Unset fields in 429 error logging and enable POST/PATCH retries (259692c)

v0.12.0 (2025-10-10)¶

Features¶

Refactor to layered transport architecture with httpx-retries (9f11717)

v0.11.0 (2025-10-08)¶

Features¶

openapi: Standardize per-resource extend query parameters and regenerate client (b5a6c35)

v0.10.0 (2025-09-18)¶

Bug Fixes¶

Add missing format: date-time specifications to date fields in OpenAPI schema (d8d335c)
Remove unused schema components and fix validation warnings (eea4e33)

Features¶

Comprehensive OpenAPI schema validation and fixes (95784ef)
Comprehensive schema restructuring for POs, BaseEntity inheritance and updated service endpoints and schemas to match documentation (1c79b18)
Implement InventoryItem base schema with Product/Material inheritance (7d2237a)
Improve documentation extraction and update comprehensive API docs (dec9725)

v0.9.0 (2025-08-21)¶

Chores¶

Add automated setup workflow for GitHub Copilot coding agent (112930e)
Add pre-commit hooks installation to Copilot setup workflow (e3eef1a)

Features¶

Implement comprehensive API documentation validation framework and add missing endpoints (5bb6873)

v0.8.1 (2025-08-19)¶

Bug Fixes¶

Align sales order schemas with official Katana API documentation (7d6b9e2)

Unreleased¶

Bug Fixes¶

Test semantic-release changelog automation for future releases (d83a575)
Update semantic-release changelog configuration for v10 compatibility (3351d8a)
Update test file to validate semantic-release changelog generation (e42e5d6)

Chores¶

Add test file to verify semantic-release changelog generation (0168c54)

Documentation¶

Regenerate comprehensive changelog from git history (1463edb)

v0.8.0 (2025-08-13)¶

Chores¶

Restore comprehensive Katana docs and cleanup redundant files (2f2127d)

Features¶

Add comprehensive webhook documentation and fix pagination headers (fc43b5f)

v0.7.0 (2025-08-13)¶

Features¶

Streamline regeneration script and flatten import structure (#26, d091c46)

v0.6.0 (2025-08-12)¶

Chores¶

✨Set up Copilot instructions (#25, 69bf6ce)

Features¶

Complete comprehensive programmatic OpenAPI schema validation standards for property descriptions and payload examples (#23, 650f769)

v0.5.1 (2025-08-07)¶

Bug Fixes¶

Improve BOM row schemas and validate against official documentation (42d5bda)

Chores¶

Document established OpenAPI schema patterns in copilot instructions (fcd31de)

v0.5.0 (2025-08-07)¶

Features¶

Enhance schema patterns and improve OpenAPI validation (7e6fd3a)

v0.4.0 (2025-08-07)¶

Features¶

Introduce BaseEntity schema and improve parameter descriptions (ef41c57)

v0.3.3 (2025-08-07)¶

Bug Fixes¶

BomRow and Location schemas and endpoints (f017310)

v0.3.2 (2025-08-01)¶

Bug Fixes¶

Update sku parameter to accept list of strings in get_all_variants (7a1379a)

v0.3.1 (2025-07-31)¶

Bug Fixes¶

Add missing 'service' value to VariantResponseType enum (707ba13)

v0.3.0 (2025-07-30)¶

Features¶

DRY OpenAPI spec, regenerate client, and simplify error handling (519d9b4)

Breaking Changes¶

Many generated model and API files were removed or renamed; client and error handling patterns have changed. Review migration notes before upgrading.

v0.2.2 (2025-07-30)¶

Bug Fixes¶

Align OpenAPI spec with Katana docs and prep for DRY improvements (cdaba92)

v0.2.1 (2025-07-28)¶

Bug Fixes¶

Convert optional enum definitions to use anyOf pattern (#14, 4ec9ed5)

Chores¶

Remove AST check from CI workflow to resolve build failures (#14, 4ec9ed5)

Documentation¶

Refresh documentation with current project structure and patterns (#8, 4988ca0)

v0.2.0 (2025-07-24)¶

Bug Fixes¶

Complete ruff linting fixes for modern Python syntax (f1b88d6)
Configure ruff to properly ignore generated code (c112157)
Resolve OpenAPI nullable enum issues and enhance code generation (283b74f)

Chores¶

Add comprehensive documentation generation and GitHub Pages publishing (#4, 38b0cc7)
Add pre-commit hooks and development tooling (#6, d6511e6)
Clean up cruft files and improve .gitignore (fe76ad4)
Configure semantic-release for pre-1.0 development (159f3b4)
Optimize regeneration workflow and add systematic patches (0b0560f)
docs: Update README.md for python version support (ba2aeb7)

Documentation¶

Include generated API files in documentation (2ffb10c)
Update documentation and GitHub workflows (1c0de0b)

Features¶

Add OpenTracing support for distributed tracing integration (#2, 289184b)
Complete OpenTracing removal and optimize documentation testing (acc71cd)
Eliminate confusing client.client pattern - cleaner API design (#5, 116ea04)
Enhance error logging with beautiful human-readable formatting (aa9fda1)
Update generated OpenAPI client with latest improvements (29e2e2e)

v0.1.0 (2025-07-16)¶

Initial Release