better-ccflare 3.2.0-beta8 → 3.2.0

package/README.md

@@ -71,6 +71,8 @@ npm install -g better-ccflare
 better-ccflare
 ```
 Continue to [Configure Claude SDK](https://github.com/tombii/better-ccflare#configure-claude-sdk).
+
+**⚠️ Windows npm Installation Issue**: If you installed via npm on Windows and encounter a path error like `"C:\\Program Files\\nodejs\\\\node_modules\\better-ccflare\\dist\\better-ccflare" is either misspelled or could not be found`, this is a known [npm bug on Windows](https://github.com/npm/cli/issues/969) affecting how npm generates wrapper scripts. See [Windows Troubleshooting](#windows-troubleshooting) for workarounds.
 ### Install via bun
 
 ```bash
@@ -533,6 +535,75 @@ No `NODE_OPTIONS` needed - Traefik provides trusted certificates automatically!
    curl -k https://yourhostname:8080/health
    ```
 
+## Windows Troubleshooting
+
+### Issue: "Command is misspelled or could not be found" after npm install
+
+If you installed better-ccflare via npm on Windows and encounter an error like:
+
+```
+The command "C:\Program Files\nodejs\\node_modules\better-ccflare\dist\better-ccflare" is either
+misspelled or could not be found.
+```
+
+This is a **known npm bug on Windows** (see [npm/cli#969](https://github.com/npm/cli/issues/969) and [nodejs/node#39010](https://github.com/nodejs/node/issues/39010)) affecting how npm generates wrapper scripts with double backslashes in paths.
+
+### Workarounds
+
+**Option 1: Use `npx` (Recommended)**
+
+```powershell
+npx better-ccflare
+```
+
+This bypasses the npm wrapper script entirely and runs better-ccflare directly.
+
+**Option 2: Use the Pre-compiled Binary**
+
+Download the standalone Windows executable from [GitHub Releases](https://github.com/tombii/better-ccflare/releases/latest):
+
+```powershell
+# Download better-ccflare-windows-x64.exe and run it directly
+.\better-ccflare-windows-x64.exe
+```
+
+**Option 3: Update npm**
+
+Sometimes updating to the latest npm version fixes the issue:
+
+```powershell
+npm install -g npm@latest
+npm install -g better-ccflare
+```
+
+**Option 4: Direct Execution**
+
+If you need to use the npm-installed version, you can execute the binary directly:
+
+```powershell
+node "%APPDATA%\npm\node_modules\better-ccflare\dist\better-ccflare"
+```
+
+**Option 5: Use Bun Package Manager**
+
+Bun doesn't have this bug and works correctly on Windows:
+
+```powershell
+# Install bun from https://bun.sh
+bun install -g better-ccflare
+better-ccflare
+```
+
+### Root Cause
+
+This issue is caused by a bug in npm's wrapper script generation on Windows, where it incorrectly constructs paths with double backslashes (`\\nodejs\\\\node_modules`). This is a longstanding npm bug that affects many CLI packages, not just better-ccflare.
+
+The issue is being tracked in:
+- [npm/cli#969](https://github.com/npm/cli/issues/969) - Generated .cmd script bugs
+- [nodejs/node#39010](https://github.com/nodejs/node/issues/39010) - Double slashes in Windows paths
+
+We recommend using one of the workarounds above until the npm bug is fixed.
+
 ## Features
 
 ### 🎯 Intelligent Load Balancing
@@ -573,7 +644,7 @@ No `NODE_OPTIONS` needed - Traefik provides trusted certificates automatically!
 - **OpenAI-Compatible** - OpenAI-compatible providers (OpenRouter, Together AI, etc.) with Claude API format
 - **Universal API Format** - Use OpenAI-compatible providers (OpenRouter, Together AI, etc.) with Claude API format
 - **Automatic Format Conversion** - Seamless conversion between Anthropic and OpenAI request/response formats
-- **Model Mapping** - Map Claude models (opus, sonnet, haiku) to equivalent OpenAI models
+- **Model Mapping** - Map Claude models (Opus, Sonnet, Haiku) to equivalent OpenAI models
 - **Streaming Support** - Full support for streaming responses from OpenAI-compatible providers
 - **API Key Authentication** - Secure API key management for OpenAI-compatible providers
 - **Cost Tracking** - Automatic cost calculation for usage monitoring and budgeting
@@ -660,7 +731,9 @@ Inspired by [snipeship/ccflare](https://github.com/snipeship/ccflare) - thanks f
 - [@anonym-uz](https://github.com/anonym-uz) - Critical auto-pause bug fix, analytics performance optimizations, request body truncation, and incremental vacuum implementation
 - [@makhweeb](https://github.com/makhweeb) - Enhanced request handling and analytics improvements
 - [@jw409](https://github.com/jw409) - Fixed OAuth account addition in WSL2 and compiled binaries by replacing unreliable prompt() with readline
-- [@materemias](https://github.com/materemias) - Testing and validation of Vertex AI provider implementation, thorough debugging of OAuth API key authentication (issue #54), extensive testing of new releases and features including AWS Bedrock support
+- [@materemias](https://github.com/materemias) - Testing and validation of Vertex AI provider implementation, thorough debugging of OAuth API key authentication (issue #54), requesting and validating AWS Bedrock support (issue #49), and extensive testing of new releases and features
+- [@tqtensor](https://github.com/tqtensor) - Comprehensive memory leak fix preventing OOM kills with smart chunk capping, memory monitoring, and optimized cleanup (PR #67)
+- [@lunetics](https://github.com/lunetics) - Force-reset rate limit feature allowing manual clearing of stale rate-limit locks via API, CLI, and dashboard with immediate usage polling (PR #68), OOM kill prevention with periodic data retention cleanup, 3-day default retention, and time-scoped stats queries (PR #70), model registry sync removing retired models and adding sonnet-4.6 CLI shortcut (PR #71)
 
 ## Contributing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-ccflare",
-  "version": "3.2.0-beta8",
+  "version": "3.2.0",
   "description": "Load balancer proxy for Claude API with intelligent distribution across multiple OAuth accounts to avoid rate limiting",
   "license": "MIT",
   "repository": {