wry 0.5.1.dev5__tar.gz → 0.5.3.dev1__tar.gz

{wry-0.5.1.dev5 → wry-0.5.3.dev1}/AI_KNOWLEDGE_BASE.md

@@ -1,10 +1,11 @@
 # wry - Comprehensive AI/LLM Knowledge Base
 
-**Last Updated**: 2025-10-14
-**Version**: 0.5.0+
+**Last Updated**: 2025-10-19
+**Version**: 0.6.0+
 **Purpose**: Complete reference for AI assistants and LLMs to understand wry without reading the entire codebase
 
 **Related Documentation**:
+
 - 📖 **`CONTRIBUTING.md`** - Comprehensive contributor guide (referenced by `.cursorrules`)
 - 🤖 **`.cursorrules`** - AI assistant quick reference (references this file and CONTRIBUTING.md)
 - 📘 **`README.md`** - User-facing documentation
@@ -23,10 +24,13 @@
 4. Tracking exactly where each value came from
 5. Enforcing strict precedence: CLI > JSON > ENV > DEFAULT
 6. **NEW v0.3.2**: Automatic alias-based CLI option generation
+7. **NEW v0.6.0**: Boolean on/off flags (`--option/--no-option` pattern)
+8. **NEW v0.6.0**: Callable marker API with parameters (`AutoOption()`, `AutoArgument()`, `AutoExclude()`)
+9. **NEW v0.6.0**: wry-prefixed ClassVars for future-proof configuration
 
 **Key Innovation**: Single source of truth for configuration with comprehensive source tracking.
 
-**Stats**: 494 tests (all passing), 92%+ coverage, supports Python 3.10-3.12, Pydantic v2.11+ compatible
+**Stats**: 535 tests (all passing), 88%+ coverage, supports Python 3.10-3.12, Pydantic v2.11+ compatible
 
 **For Contributors**: See `CONTRIBUTING.md` for development guidelines and `.cursorrules` for AI assistant rules
 
@@ -878,26 +882,42 @@ def eager_json_config(ctx, param, value):
 
 ## Edge Cases & Gotchas
 
-### 1. env_prefix Must Be ClassVar ⚠️
+### 1. wry_ Prefixed ClassVars (v0.6.0+) ⚠️
+
+**NEW v0.6.0**: Use `wry_` prefixed ClassVars for configuration.
 
 ```python
-# WRONG - Creates a field, shadows parent
+# OLD (deprecated but still works):
 class Config(AutoWryModel):
-    env_prefix: str = "MYAPP_"  # ❌
+    env_prefix: ClassVar[str] = "MYAPP_"  # ⚠️ Deprecated
+    comma_separated_lists: ClassVar[bool] = True  # ⚠️ Deprecated
 
-# CORRECT - Class attribute, not a field
+# NEW (recommended):
 class Config(AutoWryModel):
-    env_prefix: ClassVar[str] = "MYAPP_"  # ✅
+    wry_env_prefix: ClassVar[str] = "MYAPP_"  # ✅ New naming
+    wry_comma_separated_lists: ClassVar[bool] = True  # ✅ New naming
+    wry_boolean_off_prefix: ClassVar[str] = "no"  # ✅ New feature
+
+# WRONG - Not using ClassVar:
+class Config(AutoWryModel):
+    wry_env_prefix: str = "MYAPP_"  # ❌ Still wrong!
 ```
 
-**Why this matters**:
+**Why ClassVar matters**:
 
 - Without `ClassVar`, Pydantic treats it as a field
 - Field appears in `model_fields`, gets CLI option generated
-- Shadows `WryModel.env_prefix` class attribute
-- Env var detection breaks
+- Shadows `WryModel` class attributes
+- Configuration breaks
+
+**Why wry_ prefix?**
 
-**How to detect**: Warning message about shadowing parent attribute.
+- Avoids namespace collisions with user fields
+- Makes wry configuration explicit
+- Future-proof for new configuration options
+- Old names auto-migrate with deprecation warnings
+
+**Migration**: Old names still work (auto-migrated) but emit `DeprecationWarning`.
 
 ### 2. Source Tracking Requires Context
 
@@ -1125,18 +1145,36 @@ timeout: Optional[int] = Field(default=None)
 # Generates: click.option("--timeout", type=click.INT, default=None)
 ```
 
-### 7. Boolean Fields Become Flags
+### 7. Boolean Fields Use On/Off Pattern (NEW v0.6.0)
+
+**Changed in v0.6.0**: Boolean fields now generate `--option/--no-option` pattern by default.
 
 ```python
 debug: bool = Field(default=False)
 
-# Auto-generates:
-click.option("--debug", is_flag=True)
+# Auto-generates (NEW):
+click.option("--debug/--no-debug", default=False)
+
+# Usage:
+# --debug (sets to True)
+# --no-debug (sets to False)
 
-# Usage: --debug (sets to True)
-# NOT: --debug true (doesn't work with flags)
+# Customization:
+verbose: Annotated[bool, AutoOption(flag_off_option="quiet")] = Field(default=False)
+# → --verbose/--quiet
+
+# Opt-out to single flag (old behavior):
+simple: Annotated[bool, AutoOption(flag_enable_on_off=False)] = Field(default=False)
+# → --simple (single flag)
 ```
 
+**Why the change?**
+
+- More explicit: users can clearly specify both on and off states
+- Follows Click best practices
+- Better UX: `--no-debug` is clearer than absence of `--debug`
+- Backwards compatible via opt-out
+
 ### 8. Arguments Are Always Optional (For --config)
 
 ```python
@@ -1705,8 +1743,32 @@ class TrackedValue
 class FieldWithSource
     """Value wrapper exposing .source attribute."""
 
+# NEW v0.6.0: Callable marker classes
+class WryOption
+    """Marker for auto-generated Click options with customization.
+
+    Parameters:
+        required: bool = False
+        flag_enable_on_off: bool = True (for bool fields)
+        flag_off_prefix: str | None = None (for bool fields)
+        flag_off_option: str | None = None (for bool fields)
+    """
+
+class WryArgument
+    """Marker for auto-generated Click arguments."""
+
+class WryExclude
+    """Marker to exclude field from CLI generation."""
+
+# Public API aliases
+AutoOption = WryOption      # Backwards-compatible name
+AutoArgument = WryArgument  # Backwards-compatible name
+AutoExclude = WryExclude    # Backwards-compatible name
+
+# DEPRECATED v0.6.0: Old enum-based API
 class AutoClickParameter(Enum)
-    """OPTION, REQUIRED_OPTION, ARGUMENT, EXCLUDE"""
+    """Deprecated: Use AutoOption(), AutoArgument(), AutoExclude() instead.
+    OPTION, REQUIRED_OPTION, ARGUMENT, EXCLUDE"""
 
 # Accessors (returned by @property)
 class SourceAccessor

{wry-0.5.1.dev5 → wry-0.5.3.dev1}/CHANGELOG.md

@@ -9,6 +9,159 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **Boolean on/off flags** - Boolean fields now generate `--option/--no-option` pattern by default 🎚️
+  - Makes CLI interfaces more explicit - users can explicitly set false: `--no-debug`
+  - Default behavior: `debug: bool = Field(default=False)` → `--debug/--no-debug`
+  - Custom off-option: `AutoOption(flag_off_option="quiet")` → `--verbose/--quiet`
+  - Custom prefix: `AutoOption(flag_off_prefix="skip")` → `--check/--skip-check`
+  - Single flag opt-out: `AutoOption(flag_enable_on_off=False)` → `--debug` (old behavior)
+  - Model-wide customization: `wry_boolean_off_prefix: ClassVar[str] = "disable"`
+  - Collision detection: warns and falls back to single flag if off-option conflicts with existing field
+  - Works with aliases: `debug: bool = Field(alias="verbose")` → `--verbose/--no-verbose`
+  - Full source tracking support (CLI/ENV/JSON/DEFAULT)
+  - Follows Click best practices: <https://click.palletsprojects.com/en/stable/options/#boolean>
+  - **39 new tests** covering all scenarios
+
+- **Callable marker API** - Refactored Auto* markers from Enum to callable classes 🔧
+  - `AutoOption()` replaces `AutoClickParameter.OPTION`
+  - `AutoOption(required=True)` replaces `AutoClickParameter.REQUIRED_OPTION`
+  - `AutoArgument()` replaces `AutoClickParameter.ARGUMENT`
+  - `AutoExclude()` replaces `AutoClickParameter.EXCLUDE`
+  - All markers now support parameters for future extensibility
+  - Boolean-specific parameters: `flag_enable_on_off`, `flag_off_prefix`, `flag_off_option`
+  - List-specific parameter: `comma_separated` - replaces standalone `CommaSeparated` marker
+  - Example: `AutoOption(comma_separated=True)` replaces `Annotated[list[str], CommaSeparated]`
+  - Internal: Uses Wry-specific naming (WryOption, WryArgument, WryExclude classes)
+  - Public API: AutoOption, AutoArgument, AutoExclude are aliases to Wry* classes
+  - Follows PEP 593 Annotated pattern: <https://peps.python.org/pep-0593/>
+
+- **wry_ prefixed ClassVars** - New naming convention for class-level configuration 🏷️
+  - `wry_env_prefix: ClassVar[str]` replaces `env_prefix`
+  - `wry_comma_separated_lists: ClassVar[bool]` replaces `comma_separated_lists`
+  - `wry_boolean_off_prefix: ClassVar[str]` - new feature for boolean flags
+  - Avoids namespace collisions with user fields
+  - Future-proof for additional configuration options
+  - **10 new tests** for migration and new features
+
+### Deprecated
+
+- `AutoClickParameter` enum - Use `AutoOption()`, `AutoArgument()`, `AutoExclude()` instead
+  - Old enum values still work but emit `DeprecationWarning`
+  - Will be removed in next major version (v1.0.0)
+
+- `CommaSeparated` standalone marker - Use `AutoOption(comma_separated=True)` instead
+  - Old standalone marker still works but emits `DeprecationWarning`
+  - Will be removed in next major version (v1.0.0)
+
+- `env_prefix` ClassVar - Use `wry_env_prefix` instead
+  - Auto-migrates with `DeprecationWarning`
+  - Will be removed in next major version (v1.0.0)
+
+- `comma_separated_lists` ClassVar - Use `wry_comma_separated_lists` instead
+  - Auto-migrates with `DeprecationWarning`
+  - Will be removed in next major version (v1.0.0)
+
+### Migration Guide
+
+**From Enum to Callable API:**
+
+```python
+# Old (deprecated):
+field: Annotated[str, AutoClickParameter.OPTION] = Field(default="value")
+required: Annotated[str, AutoClickParameter.REQUIRED_OPTION] = Field(...)
+
+# New (recommended):
+field: Annotated[str, AutoOption()] = Field(default="value")
+required: Annotated[str, AutoOption(required=True)] = Field(...)
+```
+
+**ClassVar Migration:**
+
+```python
+# Old (deprecated):
+class Config(AutoWryModel):
+    env_prefix: ClassVar[str] = "MYAPP_"
+    comma_separated_lists: ClassVar[bool] = True
+
+# New (recommended):
+class Config(AutoWryModel):
+    wry_env_prefix: ClassVar[str] = "MYAPP_"
+    wry_comma_separated_lists: ClassVar[bool] = True
+    wry_boolean_off_prefix: ClassVar[str] = "no"  # Optional, "no" is default
+```
+
+**Comma-Separated Lists:**
+
+```python
+# Old (deprecated):
+tags: Annotated[list[str], CommaSeparated] = Field(default_factory=list)
+
+# New (recommended):
+tags: Annotated[list[str], AutoOption(comma_separated=True)] = Field(default_factory=list)
+```
+
+**Boolean On/Off Examples:**
+
+```python
+# Default on/off pattern
+debug: bool = Field(default=False)  # --debug/--no-debug
+
+# Custom off-option
+verbose: Annotated[bool, AutoOption(flag_off_option="quiet")] = Field(default=False)
+# → --verbose/--quiet
+
+# Opt-out to single flag
+simple: Annotated[bool, AutoOption(flag_enable_on_off=False)] = Field(default=False)
+# → --simple (old behavior)
+```
+
+### Internal Changes
+
+- Updated all internal code to use `wry_*` prefixed ClassVars
+- Metadata processing loop refactored to support multiple marker types
+- Boolean flag generation supports on/off pattern with customization
+- Comprehensive backwards compatibility layer with migration warnings
+- **Total test count: 535 tests (all passing)** ✨
+- Coverage: 88.5%+ (slight drop due to new features, will improve with more usage)
+
+## [0.5.2] - 2025-10-14
+
+### Fixed
+
+- **Optional list fields with comma-separated parsing** 🐛
+  **THE BIG ONE:** Fixed critical bug where `list[str] | None` and `Optional[list[str]]` fields didn't work with comma-separated parsing
+  - **Root cause**: Nested `Annotated` types created by `AutoWryModel` (e.g., `Annotated[Optional[Annotated[list[str], CommaSeparated]], AutoOption]`) weren't being properly unwrapped
+  - **Fix 1**: Extract metadata from inner `Annotated` types within `Optional`/`Union` wrappers
+  - **Fix 2**: Unwrap `Annotated` types after unwrapping `Optional` to get to the base list type
+  - Works with both model-wide `comma_separated_lists` ClassVar and per-field `CommaSeparated` annotation
+  - Works with `list[str] | None`, `Optional[list[T]]`, and all numeric types (int, float)
+
+### Added
+
+- **Comprehensive tests for optional comma-separated lists** ✅
+  Added 13 test cases covering all use cases and edge cases:
+  - MVP bug: `list[str] | None` with model-wide `comma_separated_lists`
+  - Per-field `Annotated[list[T], CommaSeparated] | None`
+  - Old-style `Optional[list[T]]` syntax
+  - Multiple types: str, int, float
+  - Required vs optional lists
+  - Source tracking verification
+  - Default values: `None`, `[]`, `default_factory`
+  - Space handling in comma-separated input
+  - Double-nested `Annotated` types (the actual bug pattern)
+  - **Total test count: 507 tests (all passing)** ✨
+
+## [0.5.1] - 2025-10-14
+
+### Fixed
+
+- **Comma-separated lists with `default_factory`** 🐛
+  - Fixed bug where fields with `default_factory=list` would receive `None` instead of empty list when not provided
+  - Added proper handling in `click_integration.py` to call `default_factory()` for default values
+  - All comma-separated list tests now pass without validation errors
+
+### Added
+
 - **Development guidelines** 📚
   - Created `.cursorrules` as AI assistant's quick reference guide
   - Created `CONTRIBUTING.md` as comprehensive contributor guide
@@ -17,6 +170,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- **Test quality improvements** ✨
+  - Fixed Pydantic shadow warnings by renaming `source` field to `source_path`/`source_file` in test cases
+  - Added `@pytest.mark.filterwarnings` to suppress intentional warnings in tests
+  - Tests that validate warning behavior no longer pollute test output
+  - All 494 tests pass cleanly with zero warnings
+
+- **Test quality improvements** ✨
+  - Fixed Pydantic shadow warnings by renaming `source` field to `source_path`/`source_file` in test cases
+  - Added `@pytest.mark.filterwarnings` to suppress intentional warnings in tests
+  - Tests that validate warning behavior no longer pollute test output
+  - All 494 tests pass cleanly with zero warnings
+
 - **Documentation cross-references** 🔗
   - README.md: Added Contributing section with links to CONTRIBUTING.md, .cursorrules, AI_KNOWLEDGE_BASE.md
   - AI_KNOWLEDGE_BASE.md: Updated header with related documentation links

{wry-0.5.1.dev5 → wry-0.5.3.dev1}/CONTRIBUTING.md

@@ -228,11 +228,13 @@ def test_your_feature_with_click():
 - If an ignore directive is truly necessary, add a detailed comment explaining why
 
 **Example - Bad**:
+
 ```python
 result = some_function()  # type: ignore  # ❌ Don't do this
 ```
 
 **Example - Good**:
+
 ```python
 # Fix the type annotation properly
 def some_function() -> dict[str, Any]:  # ✅ Proper return type
@@ -289,9 +291,10 @@ from wry import AutoWryModel, AutoOption
 class MyConfig(AutoWryModel):
     """Configuration for my CLI tool."""
 
-    # Class-level configuration (NOT a field)
-    env_prefix: ClassVar[str] = "MYAPP_"
-    comma_separated_lists: ClassVar[bool] = False  # Optional
+    # Class-level configuration (NOT a field) - use wry_ prefix (v0.6.0+)
+    wry_env_prefix: ClassVar[str] = "MYAPP_"
+    wry_comma_separated_lists: ClassVar[bool] = False  # Optional
+    wry_boolean_off_prefix: ClassVar[str] = "no"  # Optional, customize boolean off-options
 
     # Fields become CLI options automatically
     host: str = Field(
@@ -324,7 +327,8 @@ def main(ctx: click.Context, **kwargs: Any) -> None:
 **Key Points**:
 
 - Extend `AutoWryModel` for automatic option generation
-- Use `ClassVar` for class-level config (`env_prefix`, `comma_separated_lists`)
+- Use `ClassVar` for class-level config (`wry_env_prefix`, `wry_comma_separated_lists`, `wry_boolean_off_prefix`)
+- Use new callable API: `AutoOption()`, `AutoArgument()`, `AutoExclude()`
 - Use `generate_click_parameters()` decorator
 - Load config with `from_click_context(ctx, **kwargs)` for source tracking
 - Access sources with `config.source.field_name`
@@ -343,7 +347,7 @@ class Config(AutoWryModel):
 
 # Or model-wide comma-separated:
 class CommaSepConfig(AutoWryModel):
-    comma_separated_lists: ClassVar[bool] = True  # All lists use comma-separated
+    wry_comma_separated_lists: ClassVar[bool] = True  # All lists use comma-separated
 
     tags: list[str] = Field(default_factory=list)  # Now: --tags python,rust,go
 ```
@@ -449,6 +453,7 @@ def test_feature_with_clear_name():
 - [ ] **Examples**: Add or update examples if demonstrating new features
 
 **Documentation Management**:
+
 - **Do not create excessive markdown files** unless explicitly needed
 - If markdown files exist, add content to the appropriate existing file
 - If unsure which file is appropriate, consider whether the content belongs in README.md, AI_KNOWLEDGE_BASE.md, or CHANGELOG.md
@@ -460,7 +465,7 @@ def test_feature_with_clear_name():
 - [ ] **Docstrings**: All public functions/classes/modules have comprehensive docstrings (Google style)
 - [ ] **No dead code**: Remove unused imports, variables, commented code
 - [ ] **DRY principle**: No duplicate code - extract common logic
-- [ ] **ClassVar for class config**: Use `ClassVar` for `env_prefix`, `comma_separated_lists`
+- [ ] **ClassVar for class config**: Use `ClassVar` for `wry_env_prefix`, `wry_comma_separated_lists`, `wry_boolean_off_prefix`
 
 ### 3. Tests
 
@@ -497,7 +502,7 @@ mypy wry/
 
 - [ ] **Source tracking works**: If touching config/model code, verify source tracking
 - [ ] **Precedence correct**: CLI > JSON > ENV > DEFAULT (verify if changing)
-- [ ] **ClassVar not in fields**: Ensure `env_prefix`, `comma_separated_lists` use `ClassVar`
+- [ ] **ClassVar not in fields**: Ensure `wry_env_prefix`, `wry_comma_separated_lists`, `wry_boolean_off_prefix` use `ClassVar`
 - [ ] **Examples still work**: Run examples if you changed core functionality
 - [ ] **Help text clear**: Generated --help output is helpful
 
@@ -529,7 +534,7 @@ Use [Conventional Commits](https://www.conventionalcommits.org/) format:
 feat: add comma-separated list support
 
 - Add CommaSeparated marker for per-field annotation
-- Add comma_separated_lists ClassVar for model-wide setting
+- Add wry_comma_separated_lists ClassVar for model-wide setting
 - Per-field annotation takes priority over model-wide
 - Full Pydantic validation preserved
 
@@ -547,6 +552,7 @@ Closes #42
 - Always pass `--yes` or appropriate non-interactive flags to avoid user prompts
 
 **Example**:
+
 ```bash
 # Bad - Git sees this as delete + add
 rm old_file.py
@@ -576,16 +582,20 @@ git mv old_file.py new_file.py
 ## Pull Request Process
 
 1. **Branch**: Create feature branch from `main`
+
    ```bash
    git checkout -b feature/your-feature-name
    ```
+
 2. **Complete checklist**: Follow Pre-Commit Checklist above
 3. **Commit**: Make your commit with conventional commit message
 4. **Test**: Pre-commit hook will run checks automatically
 5. **Push**: Push to remote
+
    ```bash
    git push -u origin feature/your-feature-name
    ```
+
 6. **PR**: Submit with clear description referencing checklist items
 
 ## Critical Rules
@@ -614,9 +624,10 @@ If pre-commit hooks are failing:
 2. **DRY everywhere**: Configuration defined once, used everywhere
 3. **Examples are crucial**: Users learn from examples - keep them clear and comprehensive
 4. **Test all 4 sources**: When adding config features, test CLI/ENV/JSON/DEFAULT
-5. **ClassVar correctness**: `env_prefix` and `comma_separated_lists` must be ClassVar
-6. **Explicit decorators work**: Users can always use explicit `click.option()` - preserve this
-7. **No surprises**: Behavior should match documentation exactly
+5. **ClassVar correctness**: `wry_env_prefix`, `wry_comma_separated_lists`, `wry_boolean_off_prefix` must be ClassVar
+6. **New callable API**: Use `AutoOption()`, `AutoArgument()`, `AutoExclude()` not old enum
+7. **Explicit decorators work**: Users can always use explicit `click.option()` - preserve this
+8. **No surprises**: Behavior should match documentation exactly
 
 ## Guidelines
 
@@ -633,7 +644,7 @@ If pre-commit hooks are failing:
 ### DON'T
 
 ❌ Break source precedence (CLI > JSON > ENV > DEFAULT)
-❌ Make `env_prefix` or `comma_separated_lists` regular fields
+❌ Make `wry_env_prefix`, `wry_comma_separated_lists`, or `wry_boolean_off_prefix` regular fields
 ❌ Skip testing source tracking
 ❌ Bypass pre-commit hooks
 ❌ Create duplicate functionality
@@ -645,6 +656,7 @@ If pre-commit hooks are failing:
 For information about creating releases, see **`RELEASE_PROCESS.md`**.
 
 **Key points**:
+
 - During development: Add all changes to `[Unreleased]` in CHANGELOG.md
 - When releasing: Convert `[Unreleased]` to `[X.Y.Z] - YYYY-MM-DD`
 - Tag the release commit: `git tag -s vX.Y.Z`

wry-0.5.3.dev1/DEPRECATION.md

@@ -0,0 +1,189 @@
+# Deprecation Tracking
+
+This document tracks all deprecated features for easy removal in future versions.
+
+## Deprecated in v0.6.0 → Remove in v1.0.0
+
+### 1. AutoClickParameter Enum
+
+**Location**: `wry/click_integration.py:97-115`
+**Deprecated**: v0.6.0
+**Remove**: v1.0.0
+**Replacement**: `AutoOption()`, `AutoArgument()`, `AutoExclude()`
+
+**Code markers**:
+
+- Class definition: `wry/click_integration.py:97` (marked with `# DEPRECATED v0.6.0`)
+- Detection logic: `wry/click_integration.py:492-517` (marked with `# DEPRECATED v0.6.0` and `# TODO: Remove in v1.0.0`)
+
+**Migration**:
+
+```python
+# Old:
+field: Annotated[str, AutoClickParameter.OPTION]
+
+# New:
+field: Annotated[str, AutoOption()]
+```
+
+### 2. Standalone CommaSeparated Marker
+
+**Location**: `wry/comma_separated.py:171-203`
+**Deprecated**: v0.6.0
+**Remove**: v1.0.0
+**Replacement**: `AutoOption(comma_separated=True)`
+
+**Code markers**:
+
+- Class definition: `wry/comma_separated.py:171` (marked with `# DEPRECATED v0.6.0`)
+- Detection logic: `wry/click_integration.py:463-480` (marked with `# DEPRECATED v0.6.0` and `# TODO: Remove in v1.0.0`)
+
+**Migration**:
+
+```python
+# Old:
+tags: Annotated[list[str], CommaSeparated]
+
+# New:
+tags: Annotated[list[str], AutoOption(comma_separated=True)]
+```
+
+### 3. Unprefixed env_prefix ClassVar
+
+**Location**: `wry/core/model.py:67`
+**Deprecated**: v0.6.0
+**Remove**: v1.0.0
+**Replacement**: `wry_env_prefix`
+
+**Code markers**:
+
+- ClassVar definition: `wry/core/model.py:67` (marked with `# DEPRECATED v0.6.0`)
+- Migration logic: `wry/core/model.py:77-88` (marked with `# DEPRECATED v0.6.0` and `# TODO: Remove in v1.0.0`)
+
+**Migration**:
+
+```python
+# Old:
+class Config(AutoWryModel):
+    env_prefix: ClassVar[str] = "MYAPP_"
+
+# New:
+class Config(AutoWryModel):
+    wry_env_prefix: ClassVar[str] = "MYAPP_"
+```
+
+### 4. Unprefixed comma_separated_lists ClassVar
+
+**Location**: `wry/core/model.py:68`
+**Deprecated**: v0.6.0
+**Remove**: v1.0.0
+**Replacement**: `wry_comma_separated_lists`
+
+**Code markers**:
+
+- ClassVar definition: `wry/core/model.py:68` (marked with `# DEPRECATED v0.6.0`)
+- Migration logic: `wry/core/model.py:90-101` (marked with `# DEPRECATED v0.6.0` and `# TODO: Remove in v1.0.0`)
+
+**Migration**:
+
+```python
+# Old:
+class Config(AutoWryModel):
+    comma_separated_lists: ClassVar[bool] = True
+
+# New:
+class Config(AutoWryModel):
+    wry_comma_separated_lists: ClassVar[bool] = True
+```
+
+### 5. Using Wry Marker Classes Without Calling Them
+
+**Location**: `wry/click_integration.py:481-491`
+**Deprecated**: v0.6.0
+**Remove**: v1.0.0
+**Replacement**: Call the class (add parentheses)
+
+**Code markers**:
+
+- Detection logic: `wry/click_integration.py:481-491` (marked with `# DEPRECATED v0.6.0` and `# TODO: Remove in v1.0.0`)
+
+**Migration**:
+
+```python
+# Old (works but not recommended):
+field: Annotated[str, AutoOption]
+
+# New:
+field: Annotated[str, AutoOption()]
+```
+
+## Removal Checklist for v1.0.0
+
+When removing deprecated features in v1.0.0:
+
+### Code Removal
+
+- [ ] Remove `AutoClickParameter` enum class (`wry/click_integration.py:97-115`)
+- [ ] Remove AutoClickParameter detection block (`wry/click_integration.py:492-517`)
+- [ ] Remove `CommaSeparated` marker class (`wry/comma_separated.py:171-203`)
+- [ ] Remove CommaSeparated detection block (`wry/click_integration.py:463-480`)
+- [ ] Remove `env_prefix` ClassVar (`wry/core/model.py:67`)
+- [ ] Remove env_prefix migration block (`wry/core/model.py:77-88`)
+- [ ] Remove `comma_separated_lists` ClassVar (`wry/core/model.py:68`)
+- [ ] Remove comma_separated_lists migration block (`wry/core/model.py:90-101`)
+- [ ] Remove uncalled marker class detection (`wry/click_integration.py:481-491`)
+
+### Test Updates
+
+- [ ] Remove or update tests using `AutoClickParameter` enum
+- [ ] Remove or update tests using standalone `CommaSeparated`
+- [ ] Remove or update tests using `env_prefix` without deprecation expectations
+- [ ] Remove or update tests using `comma_separated_lists` without deprecation expectations
+- [ ] Update `test_classvar_migration.py` - these tests won't be needed
+
+### Documentation Updates
+
+- [ ] Remove deprecation sections from `CHANGELOG.md`
+- [ ] Remove migration guide from `CHANGELOG.md`
+- [ ] Remove deprecated patterns from examples
+- [ ] Update `AI_KNOWLEDGE_BASE.md` to remove old API references
+- [ ] Update `README.md` to remove old patterns
+- [ ] Archive this `DEPRECATION.md` file
+
+## Search Commands for Finding Deprecated Code
+
+Use these to find all deprecated code for removal:
+
+```bash
+# Find all TODO: Remove in v1.0.0 markers
+grep -r "TODO: Remove in v1.0.0" wry/
+
+# Find all DEPRECATED v0.6.0 markers
+grep -r "DEPRECATED v0.6.0" wry/
+
+# Find AutoClickParameter usage
+grep -r "AutoClickParameter" wry/ tests/
+
+# Find CommaSeparated standalone usage
+grep -r "CommaSeparated" wry/ tests/ | grep -v "comma_separated"
+
+# Find old ClassVar names
+grep -r "env_prefix:" wry/ tests/ | grep -v "wry_env_prefix"
+grep -r "comma_separated_lists:" wry/ tests/ | grep -v "wry_comma_separated_lists"
+```
+
+## Testing Deprecated Features
+
+Before removal, ensure all deprecated features have:
+
+1. ✅ Deprecation warnings in place
+2. ✅ Backwards compatibility tests
+3. ✅ Migration documented in CHANGELOG
+4. ✅ Clear TODO markers in code
+
+After removal in v1.0.0:
+
+1. Run full test suite
+2. Update all examples
+3. Create migration guide
+4. Update version compatibility matrix