docs: fix ep-cli user-facing documentation

- Fix wrong flag --skill-level → --difficulty for ep list in ABOUT.md
- Fix non-existent --tool claude → --tool vscode in ABOUT.md
- Fix non-existent --dry-run and install list-tools commands in ABOUT.md
- Add CHANGELOG entries for v0.3.1 and v0.3.2
- Update RELEASE_CHECKLIST with manual publish steps (CI workflow removed)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: PaulJPhilp

docs/getting-started/ABOUT.md

@@ -146,8 +146,8 @@ ep install add --tool cursor
 # Search by keyword
 ep search "error handling"
 
-# Filter by skill level
-ep list --skill-level intermediate
+# Filter by difficulty
+ep list --difficulty intermediate
 
 # Show pattern details
 ep show handle-errors-with-catch
@@ -159,14 +159,14 @@ ep show handle-errors-with-catch
 # Install rules for Cursor
 ep install add --tool cursor
 
-# Install intermediate-level rules
-ep install add --tool claude --skill-level intermediate
+# Install intermediate-level rules for VS Code
+ep install add --tool vscode --skill-level intermediate
 
-# Preview without installing
-ep install add --tool windsurf --dry-run
+# Interactive rule selection for Windsurf
+ep install add --tool windsurf -i
 
 # List supported tools
-ep install list-tools
+ep install list
 ```
 
 ### Create New Patterns

packages/ep-cli/CHANGELOG.md

@@ -5,19 +5,30 @@ All notable changes to `@effect-patterns/ep-cli` 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).
 
+## [0.3.2] - 2026-02-26
+
+### Fixed
+- Resolve Effect version mismatch warnings by bumping `@effect/cluster` to 0.56.4 and `@effect/rpc` to 0.73.2
+- Fix default API URL to point to correct Vercel deployment
+
+## [0.3.1] - 2026-02-26
+
+### Added
+- Published `@effect-patterns/ep-cli` to npm for global installation (`bun add -g @effect-patterns/ep-cli`)
+- Added `@effect/cluster`, `@effect/rpc`, and `@effect/sql` as dependencies to satisfy `@effect/platform-node` peer requirements
+
+### Fixed
+- Fix missing peer dependencies that caused `Cannot find module '@effect/cluster/RunnerStorage'` at runtime
+
 ## [0.3.0] - 2026-02-10
 
 ### Added
-- **First public npm release**
 - **Pattern Discovery**: `search`, `list`, `show` commands for browsing 700+ Effect-TS patterns
 - **Rule Installation**: `install add/list` for installing Effect pattern rules into AI tools (Cursor, VS Code, Windsurf, Agents)
 - **Skills Management**: `skills list/preview/validate/stats` for Claude Skills
 
-### Security
-- Strict API key validation for MCP transport
-- OAuth/PKCE hardening for authentication flows
-
 ### Dependencies
-- effect ^3.19.14
-- @effect/cli ^0.73.0
-- @effect/platform ^0.94.1
+- effect 3.19.19
+- @effect/cli 0.73.2
+- @effect/platform 0.94.5
+- @effect/platform-node 0.104.1

packages/ep-cli/RELEASE_CHECKLIST.md

@@ -23,20 +23,41 @@
 
 ## Publish
 
-1. Go to GitHub Actions → "Publish to npm" → Run workflow
-2. First run with `dry-run: true` to verify
-3. Then run with `dry-run: false` to publish
+Publish order: toolkit → ep-shared-services → ep-cli
 
-Publish order (handled by workflow): toolkit → ep-shared-services → ep-cli
+1. Build all packages:
+   ```bash
+   bun run build
+   ```
+2. Publish dependencies first (skip if versions haven't changed):
+   ```bash
+   cd packages/toolkit && npm publish --access public
+   cd ../ep-shared-services && npm publish --access public
+   ```
+3. Temporarily pin workspace deps in `packages/ep-cli/package.json`:
+   ```diff
+   - "@effect-patterns/ep-shared-services": "workspace:*",
+   - "@effect-patterns/toolkit": "workspace:*",
+   + "@effect-patterns/ep-shared-services": "<version>",
+   + "@effect-patterns/toolkit": "<version>",
+   ```
+4. Publish ep-cli:
+   ```bash
+   cd packages/ep-cli && npm publish --access public
+   ```
+5. Revert workspace deps back to `workspace:*`
 
 ## Post-Publish Verification
 
 - [ ] Verify package is on npm:
   ```bash
   npm view @effect-patterns/ep-cli
   ```
-- [ ] Install and test:
+- [ ] Install globally and test:
   ```bash
-  bunx @effect-patterns/ep-cli --version
-  bunx @effect-patterns/ep-cli search "error handling"
+  bun add -g @effect-patterns/ep-cli
+  ep --version
+  ep list
+  ep search "retry"
   ```
+- [ ] Update CHANGELOG.md with new version entry