Release v1.0.1: Fix STDIO MCP Server Installation

Release v1.0.1: Fix STDIO MCP Server Installation

🔧 Bug Fixes

STDIO MCP Server Installation

• Resolves ENOENT error when installing STDIO MCP servers that prevented users from setting up local MCP tools
• Fixed package distribution by adding catalog/ and schema/ directories to npm package files array

Windows Compatibility

• Enhanced npx handling with automatic .cmd extension normalization on Windows
• Improved command detection to check for .cmd and .exe variants
• Cross-platform reliability for STDIO tool setup across Windows, macOS, and Linux

Robustness & Error Handling

• Added fallback catalog with embedded essential MCP tools (filesystem-mcp, memory-mcp, github-mcp)
• Enhanced error messages with actionable troubleshooting guidance and recovery instructions
• Graceful degradation when schema validation fails

Agent Support

Ensures seamless STDIO MCP server setup across all supported agents:

• ✅ Gemini CLI (~/.gemini/settings.json)
• ✅ Cursor (~/.cursor/mcp.json)
• ✅ Claude Code (~/.claude.json)
• ✅ Windsurf (~/.codeium/windsurf/mcp_config.json)
• ✅ Codex CLI (with proxy support)
• ✅ Kiro (~/.kiro/settings/mcp.json)

🚀 Usage

Try the fix immediately:

# Interactive setup (recommended)
npx @aqualia/alph-cli@latest

# Or install globally
npm install -g @aqualia/alph-cli@latest

The STDIO MCP server setup flow that previously failed with "ENOENT: no such file or directory, open '...catalog/tools.yaml'" now works perfectly on all platforms.

📦 Package Details

• npm version: 1.0.1 (published)
• Package size: 206.6 KB
• Total files: 162 (including catalog and schema files)

🧪 Testing

• ✅ All 78 existing tests pass
• ✅ Published package verified working
• ✅ STDIO catalog loading tested with and without files
• ✅ Windows command normalization confirmed
• ✅ Cross-platform compatibility maintained