feat: publish ep-cli to npm and update install docs

Publish @effect-patterns/ep-cli@0.3.1 to npm (with toolkit@0.4.2 and
ep-shared-services@1.0.1 as dependencies). Add npm install option to
docs, fix package name in ABOUT.md, add missing @effect/cluster peer
deps to prevent runtime errors.

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

Author: PaulJPhilp

docs/getting-started/ABOUT.md

@@ -47,7 +47,7 @@ ep show retry-based-on-specific-errors
 ep install add --tool cursor --skill-level intermediate
 
 # List all patterns
-ep list --skill-level advanced
+ep list --difficulty advanced
 ```
 
 ### Effect Patterns Toolkit
@@ -117,37 +117,27 @@ bun test
 
 ### Using the CLI
 
-#### Option 1: Install CLI Package Globally (Recommended)
+#### Install CLI Globally (Recommended)
 
-The CLI is published as a standalone npm package:
+The `ep` CLI is published on npm as `@effect-patterns/ep-cli`:
 
 ```bash
-# Install globally with bun
-bun install -g @effect-patterns/cli
+# Install globally with bun (recommended)
+bun add -g @effect-patterns/ep-cli
 
 # Or with npm
-npm install -g @effect-patterns/cli
+npm install -g @effect-patterns/ep-cli
 
 # Verify installation
 ep --version
 
 # Use anywhere
 ep search "error handling"
-ep list --skill-level intermediate
+ep list --difficulty intermediate
 ep show handle-errors-with-catch
 ep install add --tool cursor
 ```
 
-#### Option 2: Run from Project Directory
-
-If you prefer to run from the development repository:
-
-```bash
-# From the project root
-bun run ep --version
-bun run ep search "error handling"
-```
-
 ## Usage
 
 ### Search Patterns

packages/ep-cli/QUICK_START.md

@@ -3,7 +3,11 @@
 ## Install
 
 ```bash
+# Install globally with bun (recommended)
 bun add -g @effect-patterns/ep-cli
+
+# Or with npm
+npm install -g @effect-patterns/ep-cli
 ```
 
 ## First Commands

packages/ep-cli/README.md

@@ -24,10 +24,14 @@ Maintainer workflows are intentionally out of scope and live in `ep-admin`.
 
 ## Installation
 
-Requires Bun (package declares `bun >= 1.0.0`).
+Published on npm as `@effect-patterns/ep-cli`:
 
 ```bash
+# Install globally with bun (recommended)
 bun add -g @effect-patterns/ep-cli
+
+# Or with npm
+npm install -g @effect-patterns/ep-cli
 ```
 
 Verify:
@@ -123,7 +127,7 @@ If stdin is empty, command fails with:
 | `PATTERN_API_KEY` | API key sent as `x-api-key` to pattern API | unset |
 | `EP_API_KEY_FILE` | File containing API key text | unset |
 | `EP_CONFIG_FILE` | Path to JSON config (expects `{"apiKey":"..."}`) | `${XDG_CONFIG_HOME:-~/.config}/ep-cli/config.json` |
-| `EFFECT_PATTERNS_API_URL` | Base URL for pattern API | `https://effect-patterns-mcp.vercel.app` |
+| `EFFECT_PATTERNS_API_URL` | Base URL for pattern API | `https://effect-patterns-mcp-server-buddybuilder.vercel.app` |
 | `EP_API_TIMEOUT_MS` | Request timeout in ms | `10000` |
 | `EP_INSTALLED_STATE_FILE` | Installed-rules state file path override | `${XDG_STATE_HOME:-~/.local/state}/ep-cli/installed-rules.json` |
 | `EP_SKILLS_DIR` | Explicit skills directory override | auto-discovered from cwd upward |
@@ -281,7 +285,7 @@ Supported tool values:
 
 Target files:
 
-- `agents` -> `AGENTS.md`
+- `agents` -> rule content is written to `docs/Effect-Patterns-Rules.md`; `AGENTS.md` (in cwd) is updated with a managed block that points to that file.
 - `cursor` -> `.cursor/rules.md`
 - `vscode` -> `.vscode/rules.md`
 - `windsurf` -> `.windsurf/rules.md`
@@ -300,10 +304,7 @@ Notes:
 - `--interactive` opens multi-select prompt.
 - `--skill-level` maps to pattern difficulty filter.
 - `--use-case` filters results client-side by use case tag.
-- For `agents`, managed block markers are used:
-  - `<!-- EP_RULES_START -->`
-  - `<!-- EP_RULES_END -->`
-- Existing managed block in `AGENTS.md` is replaced in place.
+- For `agents`, rule content is written to `docs/Effect-Patterns-Rules.md`; `AGENTS.md` is then updated with a managed block (`<!-- EP_RULES_START -->` / `<!-- EP_RULES_END -->`) that references that file. An existing managed block in `AGENTS.md` is replaced in place.
 - State is recorded in installed-rules state JSON file.
 
 Unsupported tool behavior:
@@ -560,7 +561,8 @@ Defaults:
 
 `agents` tool install target:
 
-- `AGENTS.md` in current working directory
+- Rule content: `docs/Effect-Patterns-Rules.md`
+- `AGENTS.md` in current working directory is updated with a managed block that points to `docs/Effect-Patterns-Rules.md`
 
 Other install targets:
 
@@ -624,7 +626,7 @@ Expected when non-TTY or when `NO_COLOR`, `CI`, or `TERM=dumb` is set.
 This document tracks behavior for:
 
 - CLI name: `ep`
-- Version: `0.3.0`
+- Version: `0.3.1`
 
 When command surface or behavior changes, update this file first, then derivative docs.
 

packages/ep-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-patterns/ep-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "End-user CLI for Effect Patterns Hub",
   "private": false,
   "type": "module",
@@ -22,7 +22,10 @@
     "@effect-patterns/toolkit": "workspace:*",
     "@effect/cli": "0.73.2",
     "@effect/platform": "0.94.5",
+    "@effect/cluster": "0.56.1",
     "@effect/platform-node": "0.104.1",
+    "@effect/rpc": "0.73.0",
+    "@effect/sql": "0.49.0",
     "effect": "3.19.19",
     "effect-cli-tui": "^2.2.0",
     "effect-env": "^0.4.1"