docs: update docs for FR-031, FR-033, and test count to 308

Add --clipboard and --exclude to CLI reference in CLAUDE.md, README.md,
and DOCS.md. Add exclude_patterns to config examples. Mark FR-031 and
FR-033 as shipped in PRD, update Phase 4 status to shipped, and sync
test count from 295 to 308 across all docs.

Author: Sephyi

CLAUDE.md

@@ -46,6 +46,8 @@ commitbee --verbose          # Show symbol extraction details
 commitbee --show-prompt      # Debug: show the LLM prompt
 commitbee --no-split         # Disable commit split suggestions
 commitbee --no-scope         # Disable scope in commit messages
+commitbee --clipboard        # Copy message to clipboard (no commit)
+commitbee --exclude "*.lock" # Exclude files matching glob pattern
 commitbee --locale de        # Generate message in German (type/scope stay English)
 commitbee init               # Create config file
 commitbee config             # Show current configuration
@@ -75,6 +77,7 @@ rename_threshold = 70
 learn_from_history = false
 history_sample_size = 50
 # locale = "de"
+# exclude_patterns = ["*.lock", "**/*.generated.*"]
 # system_prompt_path = "/path/to/system.txt"
 # template_path = "/path/to/template.txt"
 
@@ -184,7 +187,7 @@ src/
 ### Running Tests
 
 ```bash
-cargo test                    # All tests (295 tests)
+cargo test                    # All tests (308 tests)
 cargo test --test sanitizer   # CommitSanitizer tests
 cargo test --test safety      # Safety module tests
 cargo test --test context     # ContextBuilder tests
@@ -297,4 +300,4 @@ Common mistake: calling a new safeguard/check `fix` — if there was no bug, it'
 
 ### Documentation Sync
 
-Keep README.md test count in sync (currently 295).
+Keep README.md test count in sync (currently 308).

DOCS.md

@@ -179,6 +179,10 @@ rename_threshold = 70
 # Disable built-in secret patterns by name (case-insensitive).
 # disabled_secret_patterns = ["Generic Secret (unquoted)"]
 
+# Exclude files matching glob patterns from analysis and diff context.
+# Excluded files are listed in output but not sent to the LLM.
+# exclude_patterns = ["*.lock", "**/*.generated.*"]
+
 # Commit message format options
 [format]
 # Include body/description in commit message
@@ -234,6 +238,8 @@ When run without a command, CommitBee generates a commit message for your staged
 | `--generate N` | `-n N` | Generate N candidates (1-5), pick interactively |
 | `--no-split` | | Disable commit split suggestions |
 | `--no-scope` | | Disable scope in commit messages |
+| `--clipboard` | | Copy message to clipboard instead of committing |
+| `--exclude <GLOB>` | | Exclude files matching glob pattern (repeatable) |
 | `--allow-secrets` | | Allow committing with detected secrets (Ollama only) |
 | `--show-prompt` | | Display the full prompt sent to the LLM |
 | `--verbose` | `-v` | Show symbol extraction details |
@@ -268,6 +274,13 @@ COMMITBEE_LOG=debug commitbee    # Full debug logging
 # Multiple candidates
 commitbee -n 3                   # Generate 3 options, pick the best
 
+# Clipboard
+commitbee --clipboard            # Copy message to clipboard (no commit)
+
+# Exclude files
+commitbee --exclude "*.lock"     # Skip lock files from analysis
+commitbee --exclude "*.lock" --exclude "vendor/**"  # Multiple patterns
+
 # Scripting / CI
 commitbee --yes --dry-run        # Generate message, print to stdout, exit
 commitbee --no-split --yes       # Skip split suggestion, auto-commit
@@ -679,7 +692,7 @@ No panics in user-facing code paths. The sanitizer and validator are tested with
 
 ### Testing Strategy
 
-CommitBee has 295 tests across multiple strategies:
+CommitBee has 308 tests across multiple strategies:
 
 | Strategy | What It Covers |
 | --- | --- |
@@ -692,7 +705,7 @@ CommitBee has 295 tests across multiple strategies:
 Run them:
 
 ```bash
-cargo test                    # All 295 tests
+cargo test                    # All 308 tests
 cargo test --test sanitizer   # Just sanitizer tests
 cargo test --test integration # LLM provider mocks
 COMMITBEE_LOG=debug cargo test -- --nocapture  # With logging

PRD.md

@@ -6,10 +6,10 @@ SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
 
 # CommitBee — Product Requirements Document
 
-**Version**: 4.0
-**Date**: 2026-03-13
-**Status**: Active
-**Author**: Sephyi + Claude
+**Version**: 4.0  
+**Date**: 2026-03-13  
+**Status**: Active  
+**Author**: [Sephyi](https://github.com/Sephyi) + [Claude Opus 4.6](https://www.anthropic.com/news/claude-opus-4-6)  
 
 ## Changelog
 
@@ -18,8 +18,8 @@ SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
 
 | Version | Date       | Summary |
 |---------|------------|---------|
-| 4.0     | 2026-03-13 | PRD normalization: aligned phases with shipped versions (v0.2.0/v0.3.x/v0.4.0), collapsed revision history, unified status markers, resolved stale critical issues, canonicalized test count to 295, removed dead cross-references. |
-| 3.3     | 2026-03-13 | v0.4.0 full feature completion — FR-030 (Custom Prompt Templates), FR-032 (Multi-Language), FR-036 (Tree-sitter Query Patterns), FR-057 (Additional Languages), FR-058 (History Learning), TR-006 (Eval Harness), TR-007 (Fuzzing). 295 tests. |
+| 4.0     | 2026-03-13 | PRD normalization: aligned phases with shipped versions (v0.2.0/v0.3.x/v0.4.0), collapsed revision history, unified status markers, resolved stale critical issues, canonicalized test count to 308, removed dead cross-references. |
+| 3.3     | 2026-03-13 | v0.4.0 full feature completion — FR-030 (Custom Prompt Templates), FR-032 (Multi-Language), FR-036 (Tree-sitter Query Patterns), FR-057 (Additional Languages), FR-058 (History Learning), TR-006 (Eval Harness), TR-007 (Fuzzing). 308 tests. |
 | 3.2     | 2026-03-13 | FR-035 (Rename Detection), FR-037 (Expanded Secret Scanning), FR-038 (Progress Indicators). 202 tests. |
 | 3.1     | 2026-03-13 | Deep codebase audit + streaming hardening: `Provider::new()` returns `Result`, 1 MB response cap, EOF buffer parsing, zero-allocation streaming, HTTP error body propagation. 188 tests. |
 | 3.0     | 2026-03-08 | v0.3.1 multi-pass retry + prompt enforcement. FR-041 expanded to 7 rules. 182 tests. |
@@ -90,7 +90,7 @@ CommitBee is a Rust-native CLI tool that uses tree-sitter semantic analysis and
 | Multiple message generation (pick from N)          | Common (aicommits, aicommit2) | ✅ v0.2.0       |
 | Commit splitting (multi-concern detection)         | No competitor has this        | ✅ v0.2.0       |
 | Custom prompt/instruction files                    | Growing (Copilot, aicommit2)  | ✅ v0.4.0       |
-| Unit/integration tests                             | Non-negotiable for quality    | ✅ 295 tests    |
+| Unit/integration tests                             | Non-negotiable for quality    | ✅ 308 tests    |
 
 ## 3. Architecture
 
@@ -443,15 +443,13 @@ Config: `learn_from_history` (default `false`), `history_sample_size` (default 5
 
 3 `cargo-fuzz` targets: `fuzz_sanitizer`, `fuzz_safety`, `fuzz_diff_parser`. `fuzz/Cargo.toml` with `libfuzzer-sys`.
 
-### 4.4 Unshipped — Remaining v0.4.x Scope
+#### FR-031: Exclude Files ✅
 
-#### FR-031: Exclude Files
+`--exclude` CLI flag (repeatable) and `exclude_patterns` config option. Glob patterns via `globset` (e.g., `*.lock`, `**/*.generated.*`, `vendor/**`). Excluded files listed in output but not analyzed or included in diff context. CLI patterns additive with config patterns. Returns `NoStagedChanges` if all files excluded. 4 glob matching tests + 3 TOML tests + 3 CLI parsing tests.
 
-`--exclude` CLI flag and `exclude_patterns` config option. Glob patterns (e.g., `*.lock`, `**/*.generated.*`). Excluded files listed but not analyzed or included in diff context.
+#### FR-033: Copy to Clipboard ✅
 
-#### FR-033: Copy to Clipboard
-
-`--clipboard` flag copies generated message to clipboard instead of committing. Uses system clipboard (pbcopy/xclip/xsel/clip). Works with `--dry-run`.
+`--clipboard` flag copies generated message to system clipboard and prints to stdout. Skips commit confirmation prompt. Uses platform-specific commands: `pbcopy` (macOS), `clip` (Windows), `xclip -selection clipboard` (Linux). Descriptive error if clipboard command unavailable. 3 CLI parsing tests.
 
 ### 4.5 Future — v0.5.0+ (Market Leadership)
 
@@ -635,7 +633,7 @@ commitbee eval                         # Run evaluation harness (dev, feature-ga
 
 ## 8. Testing Requirements
 
-**Current test count: 295**
+**Current test count: 308**
 
 ### TR-001: Unit Tests
 
@@ -792,7 +790,7 @@ Invalid JSON → retry once with repair prompt. Second failure → heuristic ext
 | 1 | v0.2.0 | ✅ Shipped | Stability, correctness, providers, developer experience |
 | 2 | v0.3.x | ✅ Shipped | Differentiation — heuristics, validation, spec compliance |
 | 3 | v0.4.0 | ✅ Shipped | Feature completion — templates, languages, rename, history, eval, fuzzing |
-| 4 | v0.4.x | 🔧 In progress | Remaining polish — exclude files (FR-031), clipboard (FR-033) |
+| 4 | v0.4.x | ✅ Shipped | Remaining polish — exclude files (FR-031), clipboard (FR-033) |
 | 5 | v0.5.0+ | 📋 Planned | Market leadership — MCP server, changelog, monorepo, version bumping, GitHub Action |
 
 ## 12. Success Metrics
@@ -807,7 +805,7 @@ Invalid JSON → retry once with repair prompt. Second failure → heuristic ext
 | Commit message quality | > 80% "good enough" first try | Manual evaluation + `commitbee eval` |
 | Secret leak rate | 0 | Integration tests with known patterns |
 | MSRV | Rust 1.94 (edition 2024) | CI matrix (stable + 1.94) |
-| Test count | ≥ 295 | `cargo test` (current: 295) |
+| Test count | ≥ 308 | `cargo test` (current: 308) |
 
 ## 13. Non-Goals
 

README.md

@@ -96,7 +96,7 @@ When your staged changes mix independent work (a bugfix in one module + a refact
 - **🐚 Shell completions** — bash, zsh, fish, powershell via `commitbee completions`.
 - **⚙️ 5-level config** — Defaults → project `.commitbee.toml` → user config → env vars → CLI flags.
 - **🦀 Single binary** — ~18K lines of Rust. Compiles to one static binary with LTO. No runtime dependencies.
-- **🧪 295 tests** — Unit, snapshot, property (proptest for never-panic guarantees), and integration (wiremock).
+- **🧪 308 tests** — Unit, snapshot, property (proptest for never-panic guarantees), and integration (wiremock).
 
 ## 📦 Installation
 
@@ -175,6 +175,8 @@ commitbee [OPTIONS] [COMMAND]
 | `-n, --generate` | Generate N candidates (1-5, default 1) |
 | `--no-split` | Disable commit split suggestions |
 | `--no-scope` | Disable scope in commit messages |
+| `--clipboard` | Copy message to clipboard instead of committing |
+| `--exclude <GLOB>` | Exclude files matching glob pattern (repeatable) |
 | `--allow-secrets` | Allow committing with detected secrets |
 | `--verbose` | Show symbol extraction details |
 | `--show-prompt` | Debug: display the full LLM prompt |
@@ -217,7 +219,7 @@ The default provider (Ollama) runs entirely on your machine. No data leaves your
 ## 🧪 Testing
 
 ```bash
-cargo test   # 295 tests — unit, snapshot (insta), property (proptest), integration (wiremock)
+cargo test   # 308 tests — unit, snapshot (insta), property (proptest), integration (wiremock)
 ```
 
 See [Testing Strategy](DOCS.md#testing-strategy) for the full breakdown.