intake-ai-cli 0.3.0__tar.gz → 0.5.0__tar.gz

intake_ai_cli-0.5.0/.intake.yaml.example

@@ -0,0 +1,145 @@
+# intake configuration
+# Copy this file to .intake.yaml and customize as needed.
+# All values shown below are the defaults — only override what you need.
+#
+# Configuration priority (highest wins):
+#   CLI flags > .intake.yaml > preset > hardcoded defaults
+#
+# Presets:
+#   --preset minimal      → fast & cheap for prototyping
+#   --preset standard     → balanced (default behavior)
+#   --preset enterprise   → detailed with full traceability
+
+# ─── LLM settings for requirement analysis ───────────────────────────────────
+
+llm:
+  model: claude-sonnet-4           # Any model supported by LiteLLM
+  api_key_env: ANTHROPIC_API_KEY     # Environment variable holding the API key
+  max_cost_per_spec: 0.50           # Budget limit per spec generation (USD)
+  temperature: 0.2                   # Lower = more deterministic
+  max_retries: 3                     # Retry count on LLM failures
+  timeout: 120                       # Timeout per LLM call (seconds)
+
+# ─── Project metadata ────────────────────────────────────────────────────────
+
+project:
+  name: ""                           # Auto-detected from description if empty
+  stack: []                          # Auto-detected from project files if empty
+                                     # E.g.: ["python", "fastapi", "postgresql"]
+  language: en                       # Language for generated spec content
+                                     # Supported: en, es, fr, de, pt, ja, zh, ...
+  conventions: {}                    # Custom conventions, e.g.:
+                                     #   testing: pytest
+                                     #   linting: ruff
+                                     #   style: google-docstrings
+
+# ─── Spec generation settings ────────────────────────────────────────────────
+
+spec:
+  output_dir: ./specs                # Where to write generated specs
+  requirements_format: ears          # ears | user-stories | bdd | free
+  design_depth: moderate             # minimal | moderate | detailed
+  task_granularity: medium           # coarse | medium | fine
+  include_sources: true              # Include source traceability in spec
+  version_specs: true                # Create versioned spec directories
+  generate_lock: true                # Generate spec.lock.yaml for reproducibility
+  risk_assessment: true              # Include risk matrix in analysis
+  auto_mode: true                    # Auto-detect quick/standard/enterprise mode
+                                     # based on input complexity
+
+# ─── Verification settings ───────────────────────────────────────────────────
+
+verification:
+  auto_generate_tests: true          # Generate acceptance checks from requirements
+  test_output_dir: ./tests/generated # Where to write generated tests
+  checks: []                         # Additional custom checks (list of strings)
+  timeout_per_check: 120             # Timeout per acceptance check (seconds)
+
+# ─── Export settings ─────────────────────────────────────────────────────────
+
+export:
+  default_format: generic            # architect | claude-code | cursor | kiro
+                                     # | copilot | generic
+  architect_include_guardrails: true # Include guardrails in architect pipeline
+  architect_pipeline_template: standard
+  claude_code_generate_claude_md: true  # Generate CLAUDE.md for Claude Code
+  claude_code_task_dir: .intake/tasks   # Task files directory for Claude Code
+  cursor_rules_dir: .cursor/rules       # Rules directory for Cursor
+
+# ─── Security settings ──────────────────────────────────────────────────────
+
+security:
+  redact_patterns: []                # Regex patterns to redact before LLM analysis
+                                     # Examples:
+                                     #   - '\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b'  # Emails
+                                     #   - '\b\d{3}-\d{2}-\d{4}\b'        # SSN
+                                     #   - 'password\s*[:=]\s*\S+'         # Passwords in text
+  redact_files:                      # File patterns to never include
+    - "*.env"
+    - "*.pem"
+    - "*.key"
+
+# ─── Live API connectors ────────────────────────────────────────────────────
+# Requires: pip install intake-ai-cli[connectors]
+# Source URIs: jira://PROJ-123, confluence://SPACE/Title, github://org/repo/issues/42
+
+connectors:
+  jira:
+    url: ""                          # Jira instance URL (e.g., https://your-org.atlassian.net)
+    auth_type: token                 # token | oauth | api_key
+    token_env: JIRA_API_TOKEN        # Environment variable for Jira API token
+    email_env: JIRA_EMAIL            # Environment variable for Jira email
+    default_project: ""              # Default project key (e.g., PROJ)
+    include_comments: true           # Include issue comments
+    max_comments: 5                  # Max comments per issue
+    fields:                          # Jira fields to fetch
+      - summary
+      - description
+      - labels
+      - priority
+      - status
+      - issuelinks
+      - comment
+
+  confluence:
+    url: ""                          # Confluence URL (e.g., https://your-org.atlassian.net/wiki)
+    auth_type: token                 # token | oauth
+    token_env: CONFLUENCE_API_TOKEN  # Environment variable for Confluence API token
+    email_env: CONFLUENCE_EMAIL      # Environment variable for Confluence email
+    default_space: ""                # Default space key (e.g., ENG)
+    include_child_pages: false       # Fetch child pages recursively
+    max_depth: 1                     # Max recursion depth for child pages
+
+  github:
+    token_env: GITHUB_TOKEN          # Environment variable for GitHub token
+    default_repo: ""                 # Default repo (e.g., org/repo)
+
+# ─── Feedback loop ──────────────────────────────────────────────────────────
+# Analyzes verification failures and suggests fixes
+
+feedback:
+  auto_amend_spec: false             # Auto-apply spec amendments from feedback
+  max_suggestions: 10                # Max suggestions per feedback analysis
+  include_code_snippets: true        # Include code examples in suggestions
+
+# ─── MCP server (Model Context Protocol) ────────────────────────────────────
+# Requires: pip install intake-ai-cli[mcp]
+# Exposes intake as an MCP server for AI agents
+
+mcp:
+  specs_dir: ./specs                 # Base directory for specs
+  project_dir: .                     # Project root for verification
+  transport: stdio                   # stdio (for CLI agents) | sse (for HTTP)
+  sse_port: 8080                     # Port for SSE transport
+
+# ─── Watch mode (file monitoring + auto-verification) ───────────────────────
+# Requires: pip install intake-ai-cli[watch]
+
+watch:
+  debounce_seconds: 2.0              # Wait after last change before re-checking
+  ignore_patterns:                   # Files/directories to ignore
+    - "*.pyc"
+    - "__pycache__"
+    - ".git"
+    - "node_modules"
+    - ".intake"

{intake_ai_cli-0.3.0 → intake_ai_cli-0.5.0}/CHANGELOG.md

@@ -5,6 +5,117 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-03-07
+
+### Added
+
+#### GitHub Actions action
+
+- **`action/action.yml`** (NEW): Composite GitHub Action for verifying spec compliance in CI/CD. Inputs: `spec-dir`, `project-dir`, `report-format` (terminal/json/junit), `report-output`, `tags`, `fail-fast`, `python-version`, `intake-version`. Outputs: `result`, `total-checks`, `passed-checks`, `failed-checks`, `report-path`. Automatically uploads report as artifact.
+
+#### CI pipeline
+
+- **`.github/workflows/ci.yml`** (NEW): Full CI pipeline with 4 jobs: lint (ruff check + format), typecheck (mypy strict), test (Python 3.12 + 3.13 with coverage), build (package + verify install). Runs on push to main/develop and PRs to main. Concurrency groups cancel in-progress runs.
+
+#### Examples
+
+- **`examples/from-jira-api/`** (NEW): Live Jira API connector walkthrough with URI format reference and troubleshooting.
+- **`examples/mcp-session/`** (NEW): MCP server setup guide for Claude Code, Cursor, and SSE transport. Tool/resource/prompt reference. Complete implementation walkthrough.
+- **`examples/feedback-loop/`** (NEW): Verify-feedback-fix cycle documentation with failure types, auto-apply amendments, and watch mode integration.
+- **`examples/quick-mode/`** (NEW): Quick mode usage for simple tasks with auto-detection rules and output comparison.
+- **`examples/plugin-custom-parser/`** (NEW): Complete plugin development guide covering parser, exporter, and connector creation with V1 vs V2 protocol reference.
+
+#### Documentation
+
+- **README.md** updated with MCP setup guides (Claude Code `.mcp.json`, Cursor settings, SSE), GitHub Action usage, plugin development section, 9 examples table.
+- **`.intake.yaml.example`** updated with ALL configuration fields: connectors (jira/confluence/github), feedback, mcp, watch sections with full documentation.
+
+#### Test suite
+
+- **775 tests** (up from 772), **0 failures**, **10 skipped** (MCP prompts tests when mcp package not installed). 3 new tests for connector temp file error handling.
+
+### Fixed
+
+#### mypy strict compliance
+
+- **0 mypy --strict errors** (down from 39): Added `[[tool.mypy.overrides]]` for optional dependencies without type stubs (mcp, atlassian, github, uvicorn, starlette, watchfiles). Fixed `type: ignore` comments in MCP modules (tools, resources, prompts, server) to use correct error codes (`attr-defined`, `untyped-decorator`). Changed `create_server()` return type from `object` to `Any`. Removed stale `type: ignore[arg-type]` comments on Starlette Route calls.
+
+#### Error handling hardening
+
+- **Feedback command** (`cli.py`): Added specific `FileNotFoundError` check for verify report file with actionable hint. Added `json.JSONDecodeError` handling with suggestion to regenerate report.
+- **Connector fetch** (`cli.py`): Added `TimeoutError` and `OSError` handling in `_fetch_connector_source` for graceful degradation on network failures with actionable hints.
+- **Connector temp files** (`connectors/`): All 3 connectors (Jira, Confluence, GitHub) now wrap temp file creation in `try/except OSError` and raise `ConnectorError` with disk space suggestion.
+- **Verify engine** (`verify/engine.py`): Added `logger.warning` for `OSError` when reading files during pattern checks instead of silently continuing.
+
+## [0.4.0] - 2026-03-05
+
+### Added
+
+#### MCP (Model Context Protocol) server
+
+- **MCP server module** (`mcp/`): Full MCP server implementation with stdio and SSE transports. Requires `pip install intake-ai-cli[mcp]`.
+- **`create_server()`** (`mcp/server.py`): Creates and configures the MCP server with all tools, resources, and prompts registered. `MCP_SERVER_NAME = "intake-spec"`.
+- **`run_stdio()`** and **`run_sse()`** (`mcp/server.py`): Two transport modes — stdio for CLI agent integration, SSE (HTTP) for browser/IDE integration via starlette + uvicorn.
+- **7 MCP tools** (`mcp/tools.py`):
+  - `intake_show`: Show spec summary with truncated file content (MAX_SECTION_LENGTH = 3000).
+  - `intake_get_context`: Read `context.md` for a spec.
+  - `intake_get_tasks`: List tasks with status filtering (all/pending/in_progress/done/blocked).
+  - `intake_update_task`: Update task status with optional note.
+  - `intake_verify`: Run acceptance checks with optional tag filtering.
+  - `intake_feedback`: Run verification + analyze failures.
+  - `intake_list_specs`: List available specs (filters directories without `requirements.md`).
+- **MCP resources** (`mcp/resources.py`): Dynamic spec file resources via `intake://specs/{name}/{section}` URIs. Supports 6 sections: requirements, tasks, context, acceptance, design, sources. `FILE_MAP` maps section names to actual filenames.
+- **MCP prompts** (`mcp/prompts.py`): Two structured prompt templates:
+  - `implement_next_task`: Reads spec files and generates implementation instructions referencing MCP tools.
+  - `verify_and_fix`: Generates a verify → fix → re-verify loop until all checks pass.
+- **MCPError exception** (`mcp/__init__.py`): Error with `reason` and `suggestion` attributes.
+- **Lazy imports**: `mcp`, `starlette`, `uvicorn` imported lazily with clear `ImportError` messages and installation commands.
+
+#### Watch mode (file monitoring + auto-verification)
+
+- **Watch module** (`watch/`): File watcher with selective re-verification. Requires `pip install intake-ai-cli[watch]`.
+- **SpecWatcher** (`watch/watcher.py`): Monitors project directory using `watchfiles` (Rust-based, efficient). On file change, re-runs verification checks and displays results.
+  - `run_once()`: Single verification without watching.
+  - `run()`: Continuous watch loop with debouncing.
+  - `_filter_ignored()`: Filters files by ignore patterns (fnmatch per path component).
+  - `_matches_any()`: Static method for pattern matching against individual path components.
+  - `_extract_changed_files()`: Extracts relative paths from watchfiles change sets.
+  - `MAX_CHANGED_FILES_DISPLAY = 5`: Limits terminal output.
+- **WatchError exception** (`watch/__init__.py`): Error with `reason` and `suggestion` attributes.
+- **Debouncing**: Configurable via `WatchConfig.debounce_seconds`, passed to watchfiles native debouncing.
+
+#### Configuration
+
+- **MCPConfig** (`config/schema.py`): `specs_dir`, `project_dir`, `transport` (stdio/sse), `sse_port`.
+- **WatchConfig** (`config/schema.py`): `debounce_seconds` (default: 2.0), `ignore_patterns` (default: `["*.pyc", "__pycache__", ".git", "node_modules", ".intake"]`).
+- Both added to `IntakeConfig` as `mcp` and `watch` fields.
+
+#### CLI commands
+
+- **`intake mcp serve`**: Start the MCP server. Options: `--transport` (stdio/sse), `--port`, `--specs-dir`, `--project-dir`.
+- **`intake watch`**: Watch project files and re-run verification. Options: `--project-dir`, `--tags`, `--debounce`, `--verbose`.
+
+#### Optional dependencies
+
+- `mcp = ["mcp[cli]>=1.0"]`: MCP server support.
+- `watch = ["watchfiles>=1.0"]`: Watch mode support.
+- `all = [connectors + watch + mcp]`: Install everything.
+
+#### Test suite
+
+- **772 tests** (up from 673), **0 failures**, **10 skipped** (MCP prompts tests when mcp package not installed). 99 new tests added.
+- 5 new test files: `test_mcp/test_tools.py` (31), `test_mcp/test_resources.py` (17), `test_mcp/test_prompts.py` (10), `test_mcp/test_server.py` (10), `test_watch/test_watcher.py` (27).
+- Config tests: 2 new tests for MCPConfig and WatchConfig nested overrides.
+- CLI tests: 4 new tests for MCP and Watch help output.
+
+### Fixed
+
+- **`_filter_ignored` path matching** (`watch/watcher.py`): Fixed fnmatch to check individual path components (e.g., `.git` now correctly matches `.git/objects/abc`). Added `_matches_any()` static method.
+- **Silent exception in `_handle_get_tasks`** (`mcp/tools.py`): Added `logger.debug("task_state_manager_fallback", ...)` to bare `except Exception` block.
+- **Missing `run_sse` export** (`mcp/__init__.py`): Added `run_sse` to `__all__` and convenience re-export function.
+- **`__all__` sort order** (`mcp/__init__.py`): Fixed RUF022 by sorting alphabetically.
+- **ruff TC003 in tests**: Added `per-file-ignores` rule for `tests/**/*.py` to allow stdlib imports at runtime in test fixtures.
+
 ## [0.3.0] - 2026-03-04
 
 ### Added

{intake_ai_cli-0.3.0 → intake_ai_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intake-ai-cli
-Version: 0.3.0
+Version: 0.5.0
 Summary: From requirements in any format to verified implementation
 Project-URL: Homepage, https://diego303.github.io/intake-docs/
 Project-URL: Repository, https://github.com/Diego303/intake-cli
@@ -28,6 +28,11 @@ Requires-Dist: python-docx>=1.1
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0
 Requires-Dist: structlog>=24.0
+Provides-Extra: all
+Requires-Dist: atlassian-python-api>=3.40; extra == 'all'
+Requires-Dist: mcp>=1.0; extra == 'all'
+Requires-Dist: pygithub>=2.0; extra == 'all'
+Requires-Dist: watchfiles>=0.21; extra == 'all'
 Provides-Extra: connectors
 Requires-Dist: atlassian-python-api>=3.40; extra == 'connectors'
 Requires-Dist: pygithub>=2.0; extra == 'connectors'
@@ -94,6 +99,12 @@ intake processes requirements through a 5-phase pipeline:
 
 ```bash
 pip install intake-ai-cli
+
+# With optional features
+pip install intake-ai-cli[mcp]         # MCP server support
+pip install intake-ai-cli[watch]       # Watch mode support
+pip install intake-ai-cli[connectors]  # Jira, Confluence, GitHub API connectors
+pip install intake-ai-cli[all]         # Everything
 ```
 
 Requires Python 3.12+. The CLI command is `intake`.
@@ -137,6 +148,14 @@ intake init "Sprint planning" -s jira://PROJ/sprint/42
 intake init "Wiki review" -s confluence://SPACE/Page-Title
 intake init "Bug triage" -s github://org/repo/issues?labels=bug
 
+# Start MCP server for AI agent integration
+intake mcp serve --transport stdio
+intake mcp serve --transport sse --port 8080
+
+# Watch project files and auto-verify on changes
+intake watch ./specs/auth-oauth2 --project-dir . --verbose
+intake watch ./specs/auth-oauth2 --tags test,lint --debounce 3
+
 # Export for specific agents
 intake init "Payments" -s reqs.pdf --format claude-code
 intake export ./specs/auth -f cursor -o .
@@ -231,6 +250,8 @@ connectors:
 | `intake plugins check` | Validate plugin compatibility | **Available** |
 | `intake task list` | List tasks from a spec with current status | **Available** |
 | `intake task update` | Update a task's status (pending/in_progress/done/blocked) | **Available** |
+| `intake mcp serve` | Start MCP server (stdio or SSE transport) | **Available** |
+| `intake watch` | Watch project files and re-run verification on changes | **Available** |
 
 ---
 
@@ -270,6 +291,21 @@ connectors:
   confluence:
     url: https://your-org.atlassian.net/wiki
   github: {}                   # Uses GITHUB_TOKEN env var
+
+mcp:
+  specs_dir: ./specs           # Where specs live
+  project_dir: .               # Project root for verification
+  transport: stdio             # stdio | sse
+  sse_port: 8080               # Port for SSE transport
+
+watch:
+  debounce_seconds: 2.0        # Wait before re-running verification
+  ignore_patterns:             # Files/dirs to ignore
+    - "*.pyc"
+    - "__pycache__"
+    - ".git"
+    - "node_modules"
+    - ".intake"
 ```
 
 ### Presets
@@ -298,8 +334,13 @@ See the [`examples/`](examples/) directory for ready-to-run scenarios:
 |---------|-------------|
 | [`from-markdown`](examples/from-markdown/) | Single Markdown file with OAuth2 requirements |
 | [`from-jira`](examples/from-jira/) | Jira JSON export with 3 issues |
+| [`from-jira-api`](examples/from-jira-api/) | Live Jira API connector (no manual export) |
 | [`from-scratch`](examples/from-scratch/) | Free-text meeting notes |
 | [`multi-source`](examples/multi-source/) | Combining Markdown + Jira JSON + text notes |
+| [`quick-mode`](examples/quick-mode/) | Simple task with minimal output |
+| [`mcp-session`](examples/mcp-session/) | MCP server setup and walkthrough |
+| [`feedback-loop`](examples/feedback-loop/) | Verify, analyze failures, fix, repeat |
+| [`plugin-custom-parser`](examples/plugin-custom-parser/) | How to create a custom parser plugin |
 
 ---
 
@@ -309,7 +350,7 @@ See the [`examples/`](examples/) directory for ready-to-run scenarios:
 src/intake/
 ├── cli.py                  # Click CLI — thin adapter, no logic
 ├── config/                 # Pydantic v2 models, presets, layered loader
-│   ├── schema.py           #   9 config models (LLM, Project, Spec, Verification, Export, Security, Connectors, Feedback)
+│   ├── schema.py           #   11 config models (LLM, Project, Spec, Verification, Export, Security, Connectors, Feedback, MCP, Watch)
 │   ├── presets.py           #   minimal / standard / enterprise presets
 │   ├── loader.py            #   Layered merge: defaults → preset → YAML → CLI
 │   └── defaults.py          #   Centralized constants
@@ -366,6 +407,15 @@ src/intake/
 │   └── generic.py          #   SPEC.md + verify.sh generation
 ├── diff/                   # Spec comparison
 │   └── differ.py           #   Compare two specs by requirement/task IDs
+├── mcp/                    # MCP server (Model Context Protocol)
+│   ├── __init__.py         #   MCPError + re-exports
+│   ├── server.py           #   Server creation + stdio/SSE transports
+│   ├── tools.py            #   7 tools: show, context, tasks, update, verify, feedback, list
+│   ├── resources.py        #   Dynamic spec file resources (intake://specs/{name}/{section})
+│   └── prompts.py          #   Prompt templates: implement_next_task, verify_and_fix
+├── watch/                  # Watch mode (file monitoring + auto-verification)
+│   ├── __init__.py         #   WatchError exception
+│   └── watcher.py          #   SpecWatcher with watchfiles integration
 ├── feedback/               # Feedback loop (analyze failures, suggest fixes)
 │   ├── analyzer.py         #   LLM-based failure analysis
 │   ├── prompts.py          #   Feedback analysis prompt
@@ -448,6 +498,80 @@ intake export ./specs/auth -f copilot -o .
 # Generates .github/copilot-instructions.md (auto-loaded by Copilot)
 ```
 
+### MCP Server (AI Agent Integration)
+
+intake exposes specs via the [Model Context Protocol](https://modelcontextprotocol.io/), allowing AI agents to consume specs in real time during development.
+
+Install MCP support: `pip install intake-ai-cli[mcp]`
+
+#### Setup for Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "intake": {
+      "command": "intake",
+      "args": ["mcp", "serve", "--specs-dir", "./specs", "--project-dir", "."]
+    }
+  }
+}
+```
+
+#### Setup for Cursor
+
+Add to Cursor MCP settings (Settings > MCP Servers):
+
+```json
+{
+  "intake": {
+    "command": "intake",
+    "args": ["mcp", "serve", "--specs-dir", "./specs", "--project-dir", "."]
+  }
+}
+```
+
+#### SSE Transport (Remote/IDE)
+
+```bash
+intake mcp serve --transport sse --port 8080
+```
+
+#### MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `intake_show` | View spec summary |
+| `intake_get_context` | Read project context (stack, conventions) |
+| `intake_get_tasks` | List tasks with status filtering |
+| `intake_update_task` | Mark tasks as done/in_progress/blocked |
+| `intake_verify` | Run acceptance checks |
+| `intake_feedback` | Analyze verification failures |
+| `intake_list_specs` | List available specs |
+
+**MCP resources:** Direct access to spec files via `intake://specs/{name}/{section}` URIs.
+
+**MCP prompts:** `implement_next_task` and `verify_and_fix` provide structured starting points for agents.
+
+See [`examples/mcp-session/`](examples/mcp-session/) for a complete walkthrough.
+
+### Watch Mode
+
+Automatically re-run verification checks when project files change:
+
+```bash
+# Watch with default settings
+intake watch ./specs/auth-oauth2 --project-dir .
+
+# Watch with tags filter and custom debounce
+intake watch ./specs/auth-oauth2 --tags test,lint --debounce 3 --verbose
+```
+
+Uses `watchfiles` (Rust-based) for efficient file monitoring with configurable debounce and ignore patterns.
+
+Install watch support: `pip install intake-ai-cli[watch]`
+
 ### Feedback Loop
 
 ```bash
@@ -463,12 +587,26 @@ intake feedback ./specs/auth --agent-format claude-code
 
 ### With CI/CD
 
+#### GitHub Actions (built-in action)
+
+```yaml
+# .github/workflows/verify.yml
+- name: Verify spec compliance
+  uses: Diego303/intake-cli/action@main
+  with:
+    spec-dir: ./specs/auth-system
+    project-dir: .
+    report-format: junit
+    report-output: intake-report.xml
+```
+
+#### Manual setup
+
 ```yaml
-# GitHub Actions
 - name: Verify spec compliance
   run: |
     pip install intake-ai-cli
-    intake verify specs/auth-system/ -p . --format junit
+    intake verify specs/auth-system/ -p . --format junit -o report.xml
 ```
 
 ---
@@ -492,7 +630,7 @@ ruff format src/ tests/
 mypy src/ --strict
 ```
 
-Current test suite: **673 tests**, **0 mypy --strict errors**, **0 ruff warnings**.
+Current test suite: **775 tests**, **0 mypy --strict errors**, **0 ruff warnings**.
 
 ### Implementation Status
 
@@ -506,9 +644,11 @@ Current test suite: **673 tests**, **0 mypy --strict errors**, **0 ruff warnings
 | Plugins | `plugins/` (protocols + discovery + hooks) | Implemented |
 | Connectors | `connectors/` (Jira, Confluence, GitHub API connectors) | Implemented |
 | Feedback | `feedback/` (analyzer + suggestions + spec updater) | Implemented |
+| MCP Server | `mcp/` (server + 7 tools + resources + prompts) | Implemented |
+| Watch Mode | `watch/` (SpecWatcher with watchfiles) | Implemented |
 | Standalone | `doctor/`, `config/`, `llm/`, `utils/` | Implemented |
 | Standalone | `diff/` (spec differ) | Implemented |
-| CLI | 15 commands/subcommands wired end-to-end | Implemented |
+| CLI | 19 commands/subcommands wired end-to-end | Implemented |
 
 ---
 
@@ -531,6 +671,40 @@ export OPENAI_API_KEY=sk-...
 
 ---
 
+## Plugin Development
+
+intake supports custom parsers, exporters, and connectors via Python entry points (PEP 621). Any pip-installable package can extend intake.
+
+```python
+# Example: custom parser plugin
+from intake.plugins.protocols import ParserPlugin, PluginMeta
+from intake.ingest.base import ParsedContent
+
+class NotionParser:
+    @property
+    def meta(self) -> PluginMeta:
+        return PluginMeta(name="notion", version="0.1.0", description="Notion parser")
+
+    @property
+    def supported_extensions(self) -> list[str]:
+        return [".html"]
+
+    def can_parse(self, source: str) -> bool: ...
+    def confidence(self, source: str) -> float: ...
+    def parse(self, source: str) -> ParsedContent: ...
+```
+
+Register in your package's `pyproject.toml`:
+
+```toml
+[project.entry-points."intake.parsers"]
+notion = "my_package:NotionParser"
+```
+
+See [`examples/plugin-custom-parser/`](examples/plugin-custom-parser/) for a complete guide covering parsers, exporters, and connectors.
+
+---
+
 ## License
 
 MIT