wry 0.5.1.dev3__tar.gz → 0.5.1.dev4__tar.gz

{wry-0.5.1.dev3 → wry-0.5.1.dev4}/.cursorrules

@@ -7,10 +7,10 @@
 
 Before making any commit, AI assistants MUST:
 
-1. **Update Documentation**:
+1. **Update Documentation** (ALWAYS update CHANGELOG.md):
+   - **CHANGELOG.md**: ALWAYS add entry under [Unreleased] for ANY change
    - README.md if user-facing changes
    - AI_KNOWLEDGE_BASE.md if architecture/API changes
-   - CHANGELOG.md with entry under [Unreleased]
    - Module docstrings if relevant
 
 2. **Ensure Code Quality**:
@@ -49,6 +49,7 @@ Before making any commit, AI assistants MUST:
 - Code patterns: `CONTRIBUTING.md` "Configuration Models" section
 - Testing guide: `CONTRIBUTING.md` "Testing" section
 - Pre-commit checklist: `CONTRIBUTING.md` "Pre-Commit Checklist" section
+- Release workflow: `RELEASE_PROCESS.md` for creating releases
 
 ## Enforcement
 

{wry-0.5.1.dev3 → wry-0.5.1.dev4}/AI_KNOWLEDGE_BASE.md

@@ -1,9 +1,16 @@
 # wry - Comprehensive AI/LLM Knowledge Base
 
-**Last Updated**: 2025-10-04
-**Version**: 0.3.2+
+**Last Updated**: 2025-10-14
+**Version**: 0.5.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
+- 📝 **`CHANGELOG.md`** - Version history and changes
+- 🚀 **`RELEASE_PROCESS.md`** - Release workflow (how to convert [Unreleased] → [X.Y.Z])
+
 ---
 
 ## Executive Summary
@@ -19,7 +26,9 @@
 
 **Key Innovation**: Single source of truth for configuration with comprehensive source tracking.
 
-**Stats**: 436 tests (all passing), 92%+ coverage, supports Python 3.10-3.12, Pydantic v2.11+ compatible
+**Stats**: 494 tests (all passing), 92%+ 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
 
 ---
 
@@ -2814,19 +2823,29 @@ Single source of truth: Pydantic model defines everything.
 - ✅ Multi-source configuration (CLI/ENV/JSON/DEFAULT)
 - ✅ Source tracking (know where every value came from)
 - ✅ Type safety (Pydantic + Click)
-- ✅ Comprehensive testing (407 tests, 92% coverage)
-- ✅ Excellent documentation (README + AI KB + examples)
+- ✅ Comprehensive testing (494 tests, 92% coverage)
+- ✅ Excellent documentation (README + AI KB + examples + CONTRIBUTING)
 
 **For AI assistants**:
 
-- Start with `examples/source_tracking_comprehensive.py` to understand the system
-- Reference this knowledge base for details
-- Check version for bug fixes (v0.2.2 critical)
+- **Follow** `.cursorrules` for quick development rules
+- **Reference** this knowledge base (AI_KNOWLEDGE_BASE.md) for technical details
+- **Check** `CONTRIBUTING.md` for complete development guidelines
+- Start with comprehensive examples to understand the system
+- Check version for bug fixes (v0.2.2 critical, v0.5.0 adds list support)
 - Point users to examples for patterns
 - Use `show_help_index()` to help users find documentation
 
+**For Contributors**:
+
+- **Read** `CONTRIBUTING.md` for complete guidelines
+- **Follow** `.cursorrules` if using Cursor AI
+- **Reference** this knowledge base for architecture details
+- **Check** `CHANGELOG.md` for version history
+- **See** `RELEASE_PROCESS.md` for creating releases
+
 ---
 
-**End of Knowledge Base** - Version 0.2.3+ - Last Updated: 2025-10-01
+**End of Knowledge Base** - Version 0.5.0+ - Last Updated: 2025-10-14
 
 **Access this**: `python -m wry.help_system ai` or `from wry import print_help; print_help('ai')`

{wry-0.5.1.dev3 → wry-0.5.1.dev4}/CHANGELOG.md

@@ -15,6 +15,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `.cursorrules` references `CONTRIBUTING.md` for detailed explanations
   - Both tailored specifically for wry development patterns
 
+### Changed
+
+- **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
+  - AI_KNOWLEDGE_BASE.md: Updated version to 0.5.0+ and test count to 494
+  - AI_KNOWLEDGE_BASE.md: Added separate guidance sections for AI assistants and contributors
+  - Creates clear documentation hierarchy and navigation
+
+- **CHANGELOG requirements strengthened** ⚠️
+  - .cursorrules: Made CHANGELOG.md update mandatory and explicit (first item)
+  - CONTRIBUTING.md: Added prominent warning that CHANGELOG.md updates are required for every commit
+  - CONTRIBUTING.md: Listed all CHANGELOG sections (Added/Changed/Fixed/Deprecated/Removed/Security)
+  - RELEASE_PROCESS.md: Clarified [Unreleased] → versioned section workflow
+  - RELEASE_PROCESS.md: Documented that commits add to [Unreleased] during development
+  - RELEASE_PROCESS.md: Explained that release commit converts [Unreleased] to [X.Y.Z]
+
 ### Tests
 
 - **Additional comma-separated test** (494 total tests)

{wry-0.5.1.dev3 → wry-0.5.1.dev4}/CONTRIBUTING.md

@@ -434,9 +434,17 @@ def test_feature_with_clear_name():
 
 ### 1. Documentation Updates
 
+**⚠️ ALWAYS UPDATE CHANGELOG.md - This is required for every commit!**
+
+- [ ] **CHANGELOG.md**: **ALWAYS** add entry under `[Unreleased]` with appropriate section:
+  - `Added` - New features, new files, new capabilities
+  - `Changed` - Changes to existing functionality, documentation updates
+  - `Fixed` - Bug fixes
+  - `Deprecated` - Features that will be removed
+  - `Removed` - Removed features
+  - `Security` - Security fixes
 - [ ] **README.md**: Update if user-facing features, usage, or API changed
 - [ ] **AI_KNOWLEDGE_BASE.md**: Update if architecture, implementation details, or patterns changed
-- [ ] **CHANGELOG.md**: Add entry under `[Unreleased]` with section (Added/Changed/Fixed/Deprecated/Removed)
 - [ ] **Module docstrings**: Update docstrings in modified modules
 - [ ] **Examples**: Add or update examples if demonstrating new features
 
@@ -624,10 +632,21 @@ If pre-commit hooks are failing:
 ❌ Make breaking changes without major version bump
 ❌ Ignore linter/type checker errors
 
+## Release Process
+
+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`
+- See RELEASE_PROCESS.md for complete step-by-step instructions
+
 ## Questions?
 
 - Check `examples/` for usage patterns
 - Check `AI_KNOWLEDGE_BASE.md` for complete technical reference
 - Check `README.md` for user documentation
+- Check `RELEASE_PROCESS.md` for release workflow
 - Check `tests/features/test_source_precedence.py` for source tracking examples
 - Open an issue for questions or clarifications

{wry-0.5.1.dev3/wry.egg-info → wry-0.5.1.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wry
-Version: 0.5.1.dev3
+Version: 0.5.1.dev4
 Summary: Why Repeat Yourself? - Define your CLI once with Pydantic models
 Author-email: Tyler House <26489166+tahouse@users.noreply.github.com>
 License: MIT
@@ -892,7 +892,14 @@ The wry codebase is organized into focused modules:
 
 ## Contributing
 
-We welcome contributions! Please follow these guidelines to ensure a smooth process.
+We welcome contributions! Please see **`CONTRIBUTING.md`** for comprehensive guidelines.
+
+**Quick links**:
+
+- 📖 **`CONTRIBUTING.md`** - Complete contributor guide (for humans)
+- 🤖 **`.cursorrules`** - AI assistant quick reference
+- 📚 **`AI_KNOWLEDGE_BASE.md`** - Complete technical reference
+- 🚀 **`RELEASE_PROCESS.md`** - Release workflow and versioning
 
 ### Development Setup
 

{wry-0.5.1.dev3 → wry-0.5.1.dev4}/README.md

@@ -848,7 +848,14 @@ The wry codebase is organized into focused modules:
 
 ## Contributing
 
-We welcome contributions! Please follow these guidelines to ensure a smooth process.
+We welcome contributions! Please see **`CONTRIBUTING.md`** for comprehensive guidelines.
+
+**Quick links**:
+
+- 📖 **`CONTRIBUTING.md`** - Complete contributor guide (for humans)
+- 🤖 **`.cursorrules`** - AI assistant quick reference
+- 📚 **`AI_KNOWLEDGE_BASE.md`** - Complete technical reference
+- 🚀 **`RELEASE_PROCESS.md`** - Release workflow and versioning
 
 ### Development Setup
 

{wry-0.5.1.dev3 → wry-0.5.1.dev4}/RELEASE_PROCESS.md

@@ -2,31 +2,60 @@
 
 This document outlines the correct process for creating a new release.
 
-## Release Checklist
+## Development Workflow
 
-Follow these steps IN ORDER for each release:
+### During Development (Between Releases)
 
-1. **Make all code changes**
-   - Implement features/fixes
-   - Ensure all tests pass (`./check.sh`)
+As you make commits, **ALWAYS update CHANGELOG.md** under `[Unreleased]`:
+
+```markdown
+## [Unreleased]
+
+### Added
+- New feature X
+
+### Fixed
+- Bug Y
+```
+
+**Every commit** should add its changes to the `[Unreleased]` section. This keeps the changelog up-to-date continuously.
+
+### When Ready to Release
+
+Follow these steps IN ORDER:
+
+1. **Verify all changes are in [Unreleased]**
+   - Check that CHANGELOG.md `[Unreleased]` section has all changes since last release
+   - Ensure all tests pass (`pytest`)
    - Fix any linting issues
 
-2. **Update documentation**
+2. **Update CHANGELOG.md for release**
+   - Change `## [Unreleased]` to `## [X.Y.Z] - YYYY-MM-DD`
+   - Add a new empty `## [Unreleased]` section above it
+   - Update comparison links at bottom if present
+
+   **Example**:
+   ```markdown
+   ## [Unreleased]
+
+   ## [0.5.0] - 2025-10-14
+
+   ### Added
+   - Feature from unreleased section (now part of 0.5.0)
+   ```
+
+3. **Update documentation**
    - Update README.md if needed
+   - Update AI_KNOWLEDGE_BASE.md version numbers
    - Update any affected documentation
 
-3. **Update CHANGELOG.md**
-   - Add a new version section under `## [Unreleased]`
-   - Document all changes following [Keep a Changelog](https://keepachangelog.com/) format
-   - Update the comparison links at the bottom of the file
-
-4. **Commit all changes**
+4. **Commit the release preparation**
    ```bash
    git add -A
    git commit -m "chore: prepare for vX.Y.Z release"
    ```
 
-5. **Create signed tag**
+5. **Create signed tag on the release commit**
    ```bash
    git tag -s vX.Y.Z -m "Release vX.Y.Z: brief description"
    ```
@@ -37,6 +66,10 @@ Follow these steps IN ORDER for each release:
    git push origin vX.Y.Z
    ```
 
+### After the Release
+
+Continue development by adding changes to the (now empty) `[Unreleased]` section.
+
 ## Example
 
 For v0.1.8 release:

{wry-0.5.1.dev3 → wry-0.5.1.dev4}/wry/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.5.1.dev3'
-__version_tuple__ = version_tuple = (0, 5, 1, 'dev3')
+__version__ = version = '0.5.1.dev4'
+__version_tuple__ = version_tuple = (0, 5, 1, 'dev4')
 
-__commit_id__ = commit_id = 'ga2ad84576'
+__commit_id__ = commit_id = 'g338dafeb9'

{wry-0.5.1.dev3 → wry-0.5.1.dev4/wry.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wry
-Version: 0.5.1.dev3
+Version: 0.5.1.dev4
 Summary: Why Repeat Yourself? - Define your CLI once with Pydantic models
 Author-email: Tyler House <26489166+tahouse@users.noreply.github.com>
 License: MIT
@@ -892,7 +892,14 @@ The wry codebase is organized into focused modules:
 
 ## Contributing
 
-We welcome contributions! Please follow these guidelines to ensure a smooth process.
+We welcome contributions! Please see **`CONTRIBUTING.md`** for comprehensive guidelines.
+
+**Quick links**:
+
+- 📖 **`CONTRIBUTING.md`** - Complete contributor guide (for humans)
+- 🤖 **`.cursorrules`** - AI assistant quick reference
+- 📚 **`AI_KNOWLEDGE_BASE.md`** - Complete technical reference
+- 🚀 **`RELEASE_PROCESS.md`** - Release workflow and versioning
 
 ### Development Setup