fix: resolve semantic-release CI configuration issues

- Add missing pyyaml dependency for CI scripts
- Ensure full git history with fetch-tags for proper version detection
- Clarify version_source configuration in semantic-release setup

Author: catinspace-au

.github/workflows/release-python.yml

@@ -32,6 +32,7 @@ jobs:
       uses: actions/checkout@v4
       with:
         fetch-depth: 0
+        fetch-tags: true
         token: ${{ secrets.GITHUB_TOKEN }}
 
     - name: Set up Python
@@ -46,7 +47,7 @@ jobs:
     
     - name: Install dependencies
       run: |
-        uv pip install --system python-semantic-release build twine
+        uv pip install --system python-semantic-release build twine pyyaml
     
     - name: Check current version
       run: |

CLAUDE.md

@@ -268,12 +268,6 @@ When creating the generic template:
 ## Future Enhancements
 
 ### High Priority
-- **Fix Semantic-Release CI**: Troubleshoot and fix GitHub Actions semantic-release automation
-  - Currently disabled due to failing builds causing CI spam
-  - Workflow has permissions and environment loading issues
-  - Debug output added but automation still not triggering version bumps
-  - Need to investigate GitHub token permissions and semantic-release configuration
-  - Version manually updated to 3.2.0 until automation is fixed
 - **Metrics Integration**: Metrics functionality has been moved to a separate module for better separation of concerns
 
 ### Medium Priority
@@ -365,6 +359,33 @@ Run `python scripts/check_dev_tools.py` to verify all tools are installed and pr
 - All commits should use conventional commit format for proper automation
 - Push changes to trigger CI/CD pipeline and version bumps
 
+#### Semantic Release Commit Types
+The project uses standard conventional commit types for automated version bumping:
+
+**Version Bumping:**
+- `feat:` - New features (triggers **minor** version bump)
+- `fix:` - Bug fixes (triggers **patch** version bump)
+- `perf:` - Performance improvements (triggers **patch** version bump)
+- `refactor:` - Code refactoring (triggers **patch** version bump)
+
+**Non-versioning (allowed but no version bump):**
+- `docs:` - Documentation changes
+- `style:` - Code style/formatting changes  
+- `test:` - Test additions/modifications
+- `chore:` - Maintenance tasks
+- `ci:` - CI/CD configuration changes
+- `build:` - Build system changes
+
+**Breaking Changes:**
+- Any commit with `BREAKING CHANGE:` in the footer triggers **major** version bump
+- Use `!` after type for breaking changes: `feat!:` or `fix!:`
+
+**Examples:**
+- `feat: add anomaly detection mode` → 3.2.0 → 3.3.0
+- `fix: resolve memory leak in pattern extractor` → 3.2.0 → 3.2.1  
+- `refactor: consolidate scripts architecture` → 3.2.0 → 3.2.1
+- `docs: update API documentation` → No version bump
+
 ### Key Configuration
 - Logging is OFF by default (`enable_logging: bool = False`)
 - Output directory is `/data/output` (moved from `/output`)
@@ -377,6 +398,4 @@ Run `python scripts/check_dev_tools.py` to verify all tools are installed and pr
 - Python floor version: 3.11 (this project uses 3.12 via .python-version)
 
 ### Known Issues
-- **Semantic-release CI**: GitHub Actions automation failing, currently disabled to prevent spam
-- Need to debug semantic-release configuration and GitHub token permissions
-- Manual version management in use until CI is fixed
+- None currently - all core features are working properly

CLAUDE_END_OF_DAY.md

@@ -0,0 +1,178 @@
+# Claude Code End-of-Day Sequence
+
+## Copy & Paste This Into Any Claude Session
+
+```
+Please perform the end-of-day sequence:
+
+1. **Summarize Today's Work**
+   - List key accomplishments
+   - Note any unfinished tasks
+   - Document important decisions made
+
+2. **Update CLAUDE.md**
+   - Add today's work to the development log
+   - Update any changed configurations or decisions
+   - Note any warnings for future sessions
+
+3. **Check Git Status**
+   - Run: git status
+   - List any uncommitted changes
+   - Note which files should NOT be committed (like claude-sync)
+
+4. **Sync Claude State** (if claude-sync exists)
+   - Run: /usr/bin/python3 scripts/claude-sync --message "eod: End of day sync - [brief description]"
+   - Confirm sync successful
+   - Note: This is standalone, doesn't affect project git
+
+5. **Create Session Handover Notes**
+   - Current state of the project
+   - Next steps to tackle
+   - Any blockers or issues
+   - Environment state (venv, dependencies, etc.)
+
+6. **Final Checks**
+   - Ensure no sensitive data in logs
+   - Verify CI/CD still works if changes were made
+   - Check that .gitignore still excludes Claude files
+
+Please provide the output in a format I can save for the next session.
+```
+
+## Standard End-of-Day Report Template
+
+When Claude executes the above, it should produce something like:
+
+```markdown
+# End of Day Report - [DATE]
+
+## Today's Accomplishments
+- ✅ [Task 1 completed]
+- ✅ [Task 2 completed]
+- 🔄 [Task 3 in progress]
+- ⏸️ [Task 4 not started]
+
+## Key Decisions/Changes
+- [Important decision 1]
+- [Configuration change 2]
+- [Architecture decision 3]
+
+## Git Status
+**Modified files (to commit):**
+- file1.py - [reason for change]
+- file2.md - [reason for change]
+
+**Files to exclude from commit:**
+- CLAUDE.md - Claude documentation
+- scripts/claude-sync - Standalone utility
+- .claude/ - Claude settings
+
+## Claude State Sync
+✅ Successfully synced to https://github.com/[user]/claude-state/[project]/
+- Sync message: "eod: [description]"
+- Files synced: 9 items
+- No interference with project git confirmed
+
+## Handover Notes for Next Session
+
+### Current State
+- Project version: X.X.X
+- Branch: main
+- Tests: ✅ All passing
+- Build: ✅ Successful
+- CI/CD: ✅ Functional
+
+### Next Steps
+1. [Priority task 1]
+2. [Priority task 2]
+3. [Priority task 3]
+
+### Blockers/Issues
+- [Any blocking issues]
+- [Dependencies needed]
+- [Questions for user]
+
+### Environment Notes
+- Python: 3.12
+- Virtual env: .venv (active)
+- Key dependencies: [list any added today]
+
+## Important Reminders for Next Session
+- ⚠️ [Warning 1]
+- ⚠️ [Warning 2]
+- 📝 [Note 1]
+
+## Session Metadata
+- Session duration: [X hours]
+- Lines of code changed: ~[X]
+- Files modified: [X]
+- Tests added/modified: [X]
+```
+
+## Quick Commands Reference
+
+For easy copy-paste during end-of-day:
+
+```bash
+# Check git status
+git status --short
+
+# Check what would be synced (dry run)
+/usr/bin/python3 scripts/claude-sync --dry-run
+
+# Perform actual sync
+/usr/bin/python3 scripts/claude-sync --message "eod: Summary of today's work"
+
+# Verify tests still pass
+scripts/pdev test-unit
+
+# Check version consistency
+scripts/pdev version-check
+
+# See recent commits
+git log --oneline -5
+```
+
+## Customization Notes
+
+You can customize this sequence for different projects by:
+
+1. **Project-Specific Checks**: Add project-specific validation
+2. **Different Sync Repos**: Adjust the claude-sync repo URL
+3. **Team Handovers**: Add team-specific notes if sharing
+4. **Time Zones**: Include timezone in timestamps
+5. **Metrics**: Add productivity metrics if desired
+
+## Usage Instructions
+
+1. **At End of Session**: Copy the first code block and paste into Claude
+2. **Save the Report**: Copy Claude's response to a file or notes
+3. **Next Session Start**: Reference the saved report to continue work
+4. **Weekly Reviews**: Collect daily reports for weekly summaries
+
+## Example End-of-Day Message
+
+```
+Please perform the end-of-day sequence:
+
+1. Summarize today's work on the LogReducer project
+2. Update CLAUDE.md with today's accomplishments  
+3. Check git status and list uncommitted changes
+4. Run claude-sync to backup Claude state
+5. Create handover notes for tomorrow's session
+6. Verify CI/CD and tests are still working
+
+Today we worked on making claude-sync completely standalone and tested the CI/CD pipeline.
+```
+
+## Benefits
+
+- **Consistency**: Same process across all projects
+- **Continuity**: Smooth handover between sessions
+- **Safety**: Ensures Claude files don't interfere with project
+- **Documentation**: Builds a development history
+- **Recovery**: Can restore context if session is lost
+
+---
+
+*This template is designed to work across any project. Keep it in your notes for quick access at the end of each Claude Code session.*

data/output/apache_access.meta.json

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:08f64f23e86266c095916cf9edea2d63d36e6757620f09f211c038a9c92429a6
-size 1135
+oid sha256:268a56aeebc07abc36e6c05df00277155d5a9d46297fac7f302d2e473785e95a
+size 1136

data/output/bgl_supercomputer.meta.json

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6ee51eb420148e12c3e238ac48b34b47ead519383602dd0ac5ffebd167d43957
-size 1140
+oid sha256:e58de8130421efabeae8a5b48ed80e23c037d02ab7c3855c3cb6a7175e4e87d7
+size 1139

data/output/comprehensive_apache_access.meta.json

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:5ebd41fbb129d67fa621fd6e62bc57aa0da164b46e5eb4697ef0a5a8ae760ef6
-size 1135
+oid sha256:0f6441350ef097146b8965547e73d321199538a5dfe10ae244f654c857798a3f
+size 1136

data/output/comprehensive_bgl_supercomputer.meta.json

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6628cbcaf2cb6d4c95036e8f3da708683e6b5087d142d3587fc7486d7c3b8a6b
-size 1138
+oid sha256:c80683840b47e8f1a57a0bf6f68cf876d6068319e25976016cb7fb691c81d1a3
+size 1140

data/output/comprehensive_hdfs_system.meta.json

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:527816e2fceb7d536fea633867ace32926a656ae65f7ef3854bf4bde2662cfb1
-size 1133
+oid sha256:9a64caa54334fa1a969c49aa99dcf0778008abbf88ced3ba5ce052715371b660
+size 1132

data/output/comprehensive_healthapp_android.meta.json

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:97c51663c3606026ac333bc619a80757fb8bd999cbb4c77ed5942e9c1e288b93
-size 1149
+oid sha256:05884230d47d038376f38e6d871d5877fbce5b7d068bb88554f89af8f30d8d35
+size 1147

data/output/comprehensive_linux_system.meta.json

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:2c3763d404edb231fd9dc49d20c8b29f4c24707b0b35b637ee96b2d4739cbc42
+oid sha256:5f1990c97f026bbac708e994493f9ec78e465861321de5489a89a679a319d77a
 size 1148