feat: add automated release pipeline with release-please

- Configure release-please for automated changelog and version bumps
- Single-source version via importlib.metadata (pyproject.toml only)
- Add conventional commits guide to CLAUDE.md
- Update CLAUDE.md for src layout and new CLI entry points

https://claude.ai/code/session_01KvtJxwu7mCzSWEwX8wANCL

Author: claude

.github/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.1"
+}

.github/release-please-config.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "packages": {
+    ".": {
+      "release-type": "python",
+      "package-name": "webex-bot-mcp",
+      "changelog-path": "CHANGELOG.md"
+    }
+  }
+}

.github/workflows/release-please.yml

@@ -0,0 +1,19 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@v4
+        with:
+          config-file: .github/release-please-config.json
+          manifest-file: .github/.release-please-manifest.json

CLAUDE.md

@@ -9,10 +9,17 @@ guides) and prompt templates for common workflows.
 ## Repository Layout
 
 ```
+pyproject.toml       — Project metadata, version (single source of truth), and dependencies (uv)
+Dockerfile           — Multi-stage build; non-root user, health checks
+docker-compose.yml   — Compose stack with optional Prometheus + Grafana
+
 src/webex_bot_mcp/
+  __init__.py        — Package init; reads __version__ from importlib.metadata
+  __main__.py        — Enables `python -m webex_bot_mcp`
   main.py            — MCP server entry point; registers all tools/resources/prompts
   config.py          — WebexConfig dataclass; loaded via get_config() or WebexConfig.from_env()
   health_check.py    — Standalone diagnostic script; validates env and API connectivity
+
   tools/
     __init__.py      — Re-exports every tool function
     common.py        — Shared: WebexAPI client, create_error_response, create_success_response,
@@ -23,12 +30,15 @@ src/webex_bot_mcp/
     memberships.py   — Membership CRUD (list, add, update, delete) + space aliases
     people.py        — get_webex_me, list_webex_people
 
-pyproject.toml       — Project metadata and dependencies (uses uv, src layout)
-Dockerfile           — Multi-stage build; non-root user, health checks
-docker-compose.yml   — Compose stack with optional Prometheus + Grafana
-
 tests/
   test_messages.py   — Unit tests (85 cases); mocks webexpythonsdk at sys.modules level
+
+.github/
+  workflows/
+    publish.yml           — Builds + publishes to TestPyPI then PyPI on tag/workflow_dispatch
+    release-please.yml    — Creates release PRs and tags from conventional commits
+  release-please-config.json    — release-please package config
+  .release-please-manifest.json — Tracks current released version
 ```
 
 ## Key Conventions
@@ -74,18 +84,25 @@ params['files'] = [files] if isinstance(files, str) else files
 ## Running the Server
 
 ```bash
-# stdio (default — for Claude Desktop / MCP clients)
+# If installed from PyPI (pip install webex-bot-mcp)
+webex-bot-mcp                                          # stdio (default)
+webex-bot-mcp --transport streamable-http --port 8000  # HTTP transport
+
+# From source checkout (development)
 uv run webex-bot-mcp
+uv run python -m webex_bot_mcp --transport streamable-http --host 0.0.0.0 --port 8000
 
-# HTTP transport
-uv run webex-bot-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+# Health check
+webex-bot-mcp-health
 ```
 
 Required environment variable: `WEBEX_ACCESS_TOKEN`
 
 ## Running Tests
 
 ```bash
+python -m unittest discover -s tests -v
+# or, from a source checkout with uv:
 uv run python -m unittest discover -s tests -v
 ```
 
@@ -116,6 +133,63 @@ Must run via `uv run` so the `src/webex_bot_mcp` package is on the Python path.
 | `METRICS_ENABLED` | | `false` | Enable metrics endpoint |
 | `METRICS_ENDPOINT` | | — | Prometheus push endpoint |
 
+## Releases & Conventional Commits
+
+Releases are fully automated via **release-please** + **GitHub Actions**. No manual version
+bumping or tagging is needed for normal releases.
+
+### How it works
+
+1. Merge commits to `main` using the **conventional commit** format (see below).
+2. release-please watches `main` and maintains a "Release PR" that accumulates unreleased
+   changes, updating `CHANGELOG.md` and `pyproject.toml` version automatically.
+3. When you're ready to release, **merge the Release PR** — release-please creates a GitHub
+   tag + release automatically.
+4. The `publish.yml` workflow fires on the new tag, builds the wheel, publishes to TestPyPI
+   (requires approval from the `testpypi` environment), then publishes to PyPI (requires
+   approval from the `pypi` environment).
+
+You can also trigger a publish manually from the GitHub Actions tab via `workflow_dispatch`
+(useful if you need to republish without a new tag).
+
+### Conventional commit format
+
+```
+<type>(<scope>): <short description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+| Type | Version bump | Use for |
+|---|---|---|
+| `feat:` | minor | New tool, resource, or user-visible feature |
+| `fix:` | patch | Bug fix |
+| `feat!:` or `BREAKING CHANGE:` footer | major | Breaking API change |
+| `chore:` | none | Build, CI, dependency updates |
+| `docs:` | none | Documentation only |
+| `refactor:` | none | Code restructure, no behavior change |
+| `test:` | none | Test additions or fixes |
+| `perf:` | patch | Performance improvement |
+
+**Examples:**
+```
+feat(messages): add markdown formatting support
+fix(rooms): handle 404 when room already deleted
+chore(deps): update fastmcp to 2.5.0
+docs: add conventional commits guide to CLAUDE.md
+feat!: rename list_webex_rooms to list_rooms
+
+BREAKING CHANGE: tool name changed for consistency
+```
+
+### Version source of truth
+
+Version lives **only** in `pyproject.toml`. Code reads it at runtime via
+`importlib.metadata.version("webex-bot-mcp")`. Never hard-code a version string anywhere
+else in the source.
+
 ## Dependency Management
 
 Uses `uv`. The declared runtime dependency for dotenv is `python-dotenv>=1.0.0`

src/webex_bot_mcp/__init__.py

@@ -1,3 +1,8 @@
 """Webex Bot MCP — Model Context Protocol server for Webex Teams."""
 
-__version__ = "0.1.1"
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("webex-bot-mcp")
+except PackageNotFoundError:
+    __version__ = "unknown"

src/webex_bot_mcp/tools/common.py

@@ -4,10 +4,14 @@
 import os
 from datetime import datetime, timezone
 from typing import Dict, Any
+from importlib.metadata import version, PackageNotFoundError
 from webexpythonsdk import WebexAPI
 
-# Server version information
-MCP_SERVER_VERSION = "0.1.1"
+# Server version information — single source of truth is pyproject.toml
+try:
+    MCP_SERVER_VERSION = version("webex-bot-mcp")
+except PackageNotFoundError:
+    MCP_SERVER_VERSION = "unknown"
 MCP_SPEC_VERSION = "2024-11-05"
 
 # Error codes for structured error handling