solidworks-mcp-server 3.0.9 → 3.1.3

package/CHANGELOG.md

@@ -1,132 +1,176 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [3.0.9] - 2025-09-10
-
-### Fixed
-- **Critical: Winax Module Loading** - Reverted to simple ES module import pattern that matches working version
-- **COM Object Access** - Fixed GetTitle/GetType/GetPathName property access on Document objects
-- **Part Creation** - Use NewPart() method instead of NewDocument() with template
-
-### Changed  
-- **Installation Method** - Documented that local installation is required due to winax native module compilation
-- **README Documentation** - Added clear warnings and explanations about winax installation requirements
-
-### Technical
-- Removed complex eval-based winax loading in favor of direct import
-- Cleaned up test files and debugging artifacts
-- Updated documentation to reflect installation limitations
-
-### Known Issues
-- Global npm installation does not work due to winax native module requirements
-- Each Windows system must compile winax locally during npm install
-
-## [3.0.8] - 2025-09-10
-
-### Fixed
-- **COM Object Method Access** - GetTitle/GetType are properties on Document objects, not Application
-- **Part Creation** - Added fallback to NewDocument when NewPart fails
-
-## [3.0.1 to 3.0.7] - 2025-09-10
-
-### Fixed
-- Multiple attempts to fix winax module loading and COM object creation
-- Winston logger file-only output to prevent MCP protocol corruption
-- Zod schema to JSON schema conversion for Claude Desktop tool visibility
-
-## [2.2.0] - 2025-08-19
-
-### Fixed
-- **Critical: Handlebars Helper Registration** - Added all necessary Handlebars helpers (eq, ne, lt, gt, lte, gte, and, or, not) to fix VBA generation tools
-- **Template Name Mismatch** - Fixed batch_export template mapping and created proper batch_export.vba template
-- **Rebuild Model API** - Updated to use correct SolidWorks API methods (ForceRebuild3, EditRebuild, Rebuild) with fallback strategies
-- **Close Model Error Handling** - Added safe error handling for title retrieval preventing COM object access errors
-- **Export File Robustness** - Enhanced export functionality with format-specific handling and retry logic
-- **Mass Properties Extraction** - Improved getMassProperties with comprehensive error handling
-
-### Added
-- batch_export.vba template for batch export operations
-- Debug scripts (debug-server.mjs, debug-wrapper.mjs, test-fixes.mjs) for troubleshooting
-- SWChecklist.md comprehensive testing checklist
-- zod-to-json-schema dependency for schema validation
-- ensureCurrentModel helper method in api.ts
-
-### Improved
-- Enhanced error handling across all API methods with multiple fallback strategies
-- Better COM object access patterns for Windows SolidWorks compatibility
-- Template compilation with proper error recovery
-- API compatibility for different SolidWorks versions
-
-## [2.1.0] - 2025-01-11
-
-### Added
-- **Massive VBA Generation Expansion** - Added 5 new comprehensive VBA generation modules
-- **Part Modeling VBA Tools** - Reference geometry, advanced features (sweep, loft, boundary), patterns, sheet metal, surface modeling
-- **Assembly Automation VBA** - Complete mate types, component management, interference analysis, configuration management
-- **Drawing Automation VBA** - View creation, dimensioning, annotations, tables, sheet format management
-- **File Management & PDM VBA** - Batch operations, custom properties, PDM vault operations, design tables
-- **Advanced Features VBA** - Configurations, equations, simulation setup, API automation, error handling
-
-### Improved
-- Fixed TypeScript compilation errors for better CI/CD stability
-- Added proper type definitions for dotenv
-- Corrected template string interpolation in VBA code generation
-- Enhanced error handling in VBA generation
-
-### Technical
-- Added 3,300+ lines of sophisticated VBA generation code
-- Modular architecture with domain-specific modules
-- Full TypeScript support with Zod validation
-- Comprehensive error handling and logging capabilities
-
-## [2.0.1] - 2025-01-11
-
-### Fixed
-- Repository URLs corrected to GitHub repo
-- Package-lock.json added for CI/CD
-- ESLint errors resolved
-
-## [2.0.0] - 2025-01-11
-
-### Added
-- Complete architecture rewrite with enterprise features
-- Macro recording and playback system
-- SQL integration for design tables
-- PDM vault management
-- Knowledge base with ChromaDB integration
-- State management system
-- Cache management
-- Advanced resource registry
-
-## [1.0.0] - 2025-01-08
-
-### Added
-- Initial release of SolidWorks MCP Server
-- Full SolidWorks API integration via COM
-- VBA script generation from templates
-- Support for modeling operations (create, modify, dimension control)
-- Drawing automation tools
-- Multi-format export capabilities (STEP, IGES, STL, PDF, DXF, DWG)
-- Analysis tools (mass properties, interference, geometry checks)
-- Batch processing capabilities
-- Automatic Claude Desktop configuration
-- Comprehensive TypeScript implementation
-- Windows-native COM integration via winax
-
-### Features
-- 25+ MCP tools for SolidWorks automation
-- Handlebars-based VBA template system
-- Support for SolidWorks 2021-2025
-- One-command npm installation
-- Auto-configuration of Claude Desktop
-- Type-safe TypeScript architecture
-
-### Documentation
-- Comprehensive README with examples
-- Installation guide
-- Contributing guidelines
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.1.1] - 2026-03-23
+
+### Fixed
+- Removed hardcoded user-specific file path from extrusion error message (Issue #14)
+- Error now includes actual failure details instead of pointing to a non-existent local file
+
+### Changed
+- Rewrote README.md to honestly reflect project status (alpha/experimental)
+- Removed fabricated performance metrics and unverified success rate claims
+- Added clear "What Has Worked" vs "Untested" status for all tool categories
+- Rewrote TESTING.md with honest assessment of test coverage gaps and prioritized testing checklist
+- Fixed stale repository URLs in CONTRIBUTING.md
+- **Replaced ESLint + Prettier with Biome** for faster, unified lint + format
+- Moved `winax` from dependencies to `optionalDependencies` (allows `npm install` on non-Windows)
+- Removed eslint, prettier, and typescript-eslint devDependencies
+- Cleaned up tsconfig.json exclude list (removed references to deleted files)
+- Fixed all test failures (env var isolation, test expectations matching actual code behavior)
+- Removed dead adapter test that imported modules deleted in v3.1.0
+- Rewrote version test to not require full server initialization
+- Applied Biome auto-fixes across 52 source files (import types, node: protocol, formatting)
+- Fixed `console.error` in solidworks-config.ts (was polluting test output)
+- Fixed Handlebars helpers to use rest params instead of `arguments`
+- Added `npm run check` script (typecheck + lint in one command)
+
+## [3.1.0] - 2026-03-11
+
+### Fixed
+- **Critical: SelectByID2 Type Mismatch** (Issue #8) - Replace `null` with `undefined` for COM optional parameters across all `SelectByID2` and `SaveAs` calls. COM interprets `null` as VT_NULL which causes DispInvoke type mismatch errors.
+- **Sketch Selection Strategy** - Prioritize feature tree traversal (`FeatureByPositionReverse` + `GetTypeName2`) over `SelectByID2` for sketch selection. This approach is more reliable and avoids COM selection issues entirely.
+- **Mass Properties Null Safety** - Add null coalescing guards in analysis tools to prevent `TypeError` when calling `.toFixed()` on sketch-only documents that return null for numeric properties.
+
+### Removed
+- Dead refactored modules (`index.refactored.ts`, `modeling-refactored.ts`, `api-refactored.ts`, `tsconfig.refactored.json`) that were never integrated
+- Incomplete clean architecture directories (`src/application/`, `src/commands/`, `src/infrastructure/`) that added complexity without being wired into the server
+- Duplicate `.eslintrc.json` (project uses `eslint.config.js` flat config)
+- Unused package.json scripts (`build:refactored`, `dev:refactored`, `start:refactored`, `migrate`)
+
+### Added
+- `CLAUDE.md` project guide for AI contributors
+
+### Changed
+- Moved 7 analysis/architecture docs from repo root to `docs/` directory
+- Updated package.json description and keywords to reflect actual architecture
+
+## [3.0.9] - 2025-09-10
+
+### Fixed
+- **Critical: Winax Module Loading** - Reverted to simple ES module import pattern that matches working version
+- **COM Object Access** - Fixed GetTitle/GetType/GetPathName property access on Document objects
+- **Part Creation** - Use NewPart() method instead of NewDocument() with template
+
+### Changed  
+- **Installation Method** - Documented that local installation is required due to winax native module compilation
+- **README Documentation** - Added clear warnings and explanations about winax installation requirements
+
+### Technical
+- Removed complex eval-based winax loading in favor of direct import
+- Cleaned up test files and debugging artifacts
+- Updated documentation to reflect installation limitations
+
+### Known Issues
+- Global npm installation does not work due to winax native module requirements
+- Each Windows system must compile winax locally during npm install
+
+## [3.0.8] - 2025-09-10
+
+### Fixed
+- **COM Object Method Access** - GetTitle/GetType are properties on Document objects, not Application
+- **Part Creation** - Added fallback to NewDocument when NewPart fails
+
+## [3.0.1 to 3.0.7] - 2025-09-10
+
+### Fixed
+- Multiple attempts to fix winax module loading and COM object creation
+- Winston logger file-only output to prevent MCP protocol corruption
+- Zod schema to JSON schema conversion for Claude Desktop tool visibility
+
+## [2.2.0] - 2025-08-19
+
+### Fixed
+- **Critical: Handlebars Helper Registration** - Added all necessary Handlebars helpers (eq, ne, lt, gt, lte, gte, and, or, not) to fix VBA generation tools
+- **Template Name Mismatch** - Fixed batch_export template mapping and created proper batch_export.vba template
+- **Rebuild Model API** - Updated to use correct SolidWorks API methods (ForceRebuild3, EditRebuild, Rebuild) with fallback strategies
+- **Close Model Error Handling** - Added safe error handling for title retrieval preventing COM object access errors
+- **Export File Robustness** - Enhanced export functionality with format-specific handling and retry logic
+- **Mass Properties Extraction** - Improved getMassProperties with comprehensive error handling
+
+### Added
+- batch_export.vba template for batch export operations
+- Debug scripts (debug-server.mjs, debug-wrapper.mjs, test-fixes.mjs) for troubleshooting
+- SWChecklist.md comprehensive testing checklist
+- zod-to-json-schema dependency for schema validation
+- ensureCurrentModel helper method in api.ts
+
+### Improved
+- Enhanced error handling across all API methods with multiple fallback strategies
+- Better COM object access patterns for Windows SolidWorks compatibility
+- Template compilation with proper error recovery
+- API compatibility for different SolidWorks versions
+
+## [2.1.0] - 2025-01-11
+
+### Added
+- **Massive VBA Generation Expansion** - Added 5 new comprehensive VBA generation modules
+- **Part Modeling VBA Tools** - Reference geometry, advanced features (sweep, loft, boundary), patterns, sheet metal, surface modeling
+- **Assembly Automation VBA** - Complete mate types, component management, interference analysis, configuration management
+- **Drawing Automation VBA** - View creation, dimensioning, annotations, tables, sheet format management
+- **File Management & PDM VBA** - Batch operations, custom properties, PDM vault operations, design tables
+- **Advanced Features VBA** - Configurations, equations, simulation setup, API automation, error handling
+
+### Improved
+- Fixed TypeScript compilation errors for better CI/CD stability
+- Added proper type definitions for dotenv
+- Corrected template string interpolation in VBA code generation
+- Enhanced error handling in VBA generation
+
+### Technical
+- Added 3,300+ lines of sophisticated VBA generation code
+- Modular architecture with domain-specific modules
+- Full TypeScript support with Zod validation
+- Comprehensive error handling and logging capabilities
+
+## [2.0.1] - 2025-01-11
+
+### Fixed
+- Repository URLs corrected to GitHub repo
+- Package-lock.json added for CI/CD
+- ESLint errors resolved
+
+## [2.0.0] - 2025-01-11
+
+### Added
+- Complete architecture rewrite with enterprise features
+- Macro recording and playback system
+- SQL integration for design tables
+- PDM vault management
+- Knowledge base with ChromaDB integration
+- State management system
+- Cache management
+- Advanced resource registry
+
+## [1.0.0] - 2025-01-08
+
+### Added
+- Initial release of SolidWorks MCP Server
+- Full SolidWorks API integration via COM
+- VBA script generation from templates
+- Support for modeling operations (create, modify, dimension control)
+- Drawing automation tools
+- Multi-format export capabilities (STEP, IGES, STL, PDF, DXF, DWG)
+- Analysis tools (mass properties, interference, geometry checks)
+- Batch processing capabilities
+- Automatic Claude Desktop configuration
+- Comprehensive TypeScript implementation
+- Windows-native COM integration via winax
+
+### Features
+- 25+ MCP tools for SolidWorks automation
+- Handlebars-based VBA template system
+- Support for SolidWorks 2021-2025
+- One-command npm installation
+- Auto-configuration of Claude Desktop
+- Type-safe TypeScript architecture
+
+### Documentation
+- Comprehensive README with examples
+- Installation guide
+- Contributing guidelines
 - VBA template examples

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 ESPO Corporation
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2025 ESPO Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.