chore: release prep v0.12.0 — version bumps, package metadata, CI fix

Phase 1 - Repo Hygiene:
- Fix CI workflow stale path: services/mcp-server → packages/mcp-server
- Create ep-cli README.md with installation and command docs

Phase 2 - Package Prep:
- Add files, publishConfig, repository, bugs, homepage, engines to ep-cli
- Add publishConfig, repository, bugs, homepage to pipeline-state
- Update @effect/schema dep 0.68 → 0.75 in pipeline-state
- Exclude dist/__tests__ from toolkit package
- Add repository, bugs, homepage, engines to ep-shared-services
- Copy LICENSE to all publishable packages

Phase 3 - Versions & Changelogs:
- Root: 0.11.0 → 0.12.0
- toolkit: 0.3.0 → 0.4.0
- ep-cli: 0.2.0 → 0.3.0
- ep-shared-services: 1.0.0 → 1.0.1
- pipeline-state: 1.1.0 → 1.1.1
- mcp-server: 0.7.6 → 0.7.7
- Update/create changelogs for all packages
- Delete stale changeset files

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

Author: PaulJPhilp

.changeset/0000-deploy-mcp.md

@@ -186,15 +186,15 @@ jobs:
           path: packages/toolkit/dist/
 
       - name: Build MCP server
-        run: cd services/mcp-server && bun run build
+        run: cd packages/mcp-server && bun run build
         env:
           SKIP_ENV_VALIDATION: true
 
       - name: Upload build artifacts
         uses: actions/upload-artifact@v6
         with:
           name: mcp-server-dist
-          path: services/mcp-server/.next/
+          path: packages/mcp-server/.next/
           retention-days: 7
 
   test-integration:

.changeset/0000-fix-unused-extractavoidwhen.md

@@ -1,6 +1,17 @@
 # Changelog
 
-## [Unreleased]
+## [0.12.0] - 2026-02-10
+
+### 🚀 First npm Publish
+- **npm Packages**: Prepared all four public packages for first npm publish
+  - `@effect-patterns/toolkit` 0.4.0
+  - `@effect-patterns/ep-cli` 0.3.0
+  - `@effect-patterns/ep-shared-services` 1.0.1
+  - `@effect-patterns/pipeline-state` 1.1.1
+- **MCP Server**: `@effect-patterns/mcp-server` 0.7.7 patch release
+
+### 📦 New Content
+- **5 New Patterns**: core-concepts-chunk-vs-array, error-management-extract-cause, observability-compose-metrics, resource-management-guarantee-cleanup, resource-management-runtime-vs-provide
 
 ### 🔒 Security
 - **MCP Streamable Auth**: Enforced strict API key validation in streamable transport (presence-only bypass removed) with constant-time comparison.
@@ -14,6 +25,12 @@
 - **Regression Coverage**: Added auth and admin-route regression tests for transport auth, PKCE/client auth, and DB mutation authorization.
 - **EP CLI Publishability**: Enabled npm release path by removing package `private` flag from `@effect-patterns/ep-cli`.
 
+### 🔧 Fixes
+- **CI Workflow**: Fixed stale `services/mcp-server` path → `packages/mcp-server` in CI build step
+- **Package Metadata**: Added repository, bugs, homepage, engines, publishConfig to all packages
+- **Toolkit**: Excluded test artifacts from npm package via `!dist/__tests__`
+- **Pipeline State**: Updated `@effect/schema` dependency from 0.68 → 0.75
+
 ## [0.10.0-patterns] - 2026-01-12
 
 ### 🚀 Features

.github/workflows/ci.yml

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "effect-patterns-hub",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "packageManager": "bun@1.2.23",
   "private": true,
   "description": "A community-driven knowledge base for Effect-TS patterns.",

CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+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.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
+- **Pattern Authoring**: `pattern new` interactive wizard
+- **Release Management**: `release preview/create` for versioning and changelog
+- **Admin Pipeline**: `admin lint/validate/test/generate/pipeline` for publishing workflow
+
+### 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

bun.lock

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PaulJPhilp
+
+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.

package.json

@@ -0,0 +1,125 @@
+# @effect-patterns/ep-cli
+
+> End-user CLI for the Effect Patterns Hub
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
+[![Effect](https://img.shields.io/badge/Effect-3.19+-purple.svg)](https://effect.website/)
+
+Search, browse, and install Effect-TS patterns directly from your terminal. Built with `@effect/cli` for type-safe command parsing and Effect-native error handling.
+
+## Installation
+
+```bash
+# npm
+npm install -g @effect-patterns/ep-cli
+
+# bun
+bun add -g @effect-patterns/ep-cli
+
+# pnpm
+pnpm add -g @effect-patterns/ep-cli
+```
+
+## Commands
+
+### Pattern Discovery
+
+```bash
+# Search patterns by keyword
+ep search "retry"
+
+# List all patterns with optional filters
+ep list --difficulty intermediate --category error-handling
+
+# Show detailed pattern information
+ep show retry-with-backoff
+```
+
+### Install Rules
+
+Install Effect pattern rules into your AI tool configuration.
+
+```bash
+# Add rules for a specific AI tool
+ep install add --tool cursor
+ep install add --tool cursor --skill-level intermediate --use-case error-handling
+
+# Interactive rule selection
+ep install add --tool cursor -i
+
+# List supported AI tools
+ep install list
+
+# Show installed rules
+ep install list --installed
+```
+
+Supported tools: `agents`, `cursor`, `vscode`, `windsurf`
+
+### Pattern Authoring
+
+```bash
+# Scaffold a new pattern (interactive wizard)
+ep pattern new
+```
+
+### Skills Management
+
+Manage and validate Claude Skills built from patterns.
+
+```bash
+# List all available skills
+ep skills list
+
+# Preview a skill's content
+ep skills preview error-management
+
+# Validate all skills
+ep skills validate
+
+# Show skill statistics
+ep skills stats
+```
+
+### Release Management
+
+```bash
+# Preview next release version and changelog
+ep release preview
+
+# Create a release (version bump, changelog, tag, push)
+ep release create
+```
+
+### Admin / Publishing Pipeline
+
+```bash
+# Lint patterns for Effect-TS best practices
+ep admin lint
+ep admin lint --fix
+
+# Validate pattern files
+ep admin validate -v
+
+# Run example tests
+ep admin test
+
+# Generate documentation
+ep admin generate
+
+# Run the full publishing pipeline (test -> validate -> generate -> ingest)
+ep admin pipeline
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `LOG_LEVEL` | Set log level (`debug`, `info`, `warn`, `error`) | `info` |
+| `DEBUG` | Enable debug logging | - |
+| `VERBOSE` | Enable verbose logging | - |
+
+## License
+
+MIT

packages/ep-cli/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "@effect-patterns/ep-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "End-user CLI for Effect Patterns Hub",
   "private": false,
   "type": "module",
@@ -38,5 +38,33 @@
   "devDependencies": {
     "tsx": "^4.21.0",
     "typescript": "5.9.3"
-  }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PaulJPhilp/Effect-Patterns.git",
+    "directory": "packages/ep-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/PaulJPhilp/Effect-Patterns/issues"
+  },
+  "homepage": "https://github.com/PaulJPhilp/Effect-Patterns#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "effect",
+    "effect-ts",
+    "cli",
+    "patterns",
+    "code-generation",
+    "typescript"
+  ]
 }