Skip to content

v3.1.1 - Deep Cleanup: Only Essential Scripts Remain

Choose a tag to compare

View all tags
@ChanMeng666 ChanMeng666 released this 06 Nov 04:21
· 129 commits to master since this release
v3.1.1
3ec5b46

🧹 Deep Cleanup: Removing All Redundant Scripts

This release completes the minimalist vision by removing truly unnecessary internal scripts and fixing all broken documentation references. Only actively-used, essential files remain.

🎯 What Changed

This is a surgical cleanup targeting redundant code that provides zero value to users:

🗑️ Removed (~39KB of Dead Code)

1. scripts/internal/detect-environment.sh (25KB) - Completely Redundant

  • ❌ Problem: Environment detection already integrated in hooks/shared/path_utils.sh
  • ❌ Never actually called - only mentioned in log messages
  • ✅ Solution: Deleted. Installer uses the path_utils.sh function directly
  • 🎁 Bonus: Removed entire /scripts/internal/ directory (now empty)

2. scripts/.internal-tests/check-setup.sh (8.3KB) - Unused Diagnostic Script

  • ❌ Problem: Not called by install-complete.sh or any other script
  • ❌ Had broken path references in test-audio.sh
  • ✅ Solution: Deleted. Installation already has comprehensive logging

3. scripts/.internal-tests/test-path-conversion.sh (5.7KB) - Never Invoked

  • ❌ Problem: No script in the entire project calls it
  • ❌ Pure legacy code from older versions
  • ✅ Solution: Deleted

🔧 Fixed

Broken References in test-audio.sh

  • ❌ Referenced non-existent ./scripts/check-setup.sh
  • ❌ Referenced non-existent docs/AUDIO_CREATION.md
  • ✅ Updated to point users to installer and README.md

Misleading Suggestions in install-complete.sh

  • ❌ Suggested manually running detect-environment.sh (which doesn't exist anymore)
  • ✅ Replaced with advice to re-run the installer

📊 Impact

Metric Before v3.1.1 After v3.1.1 Change
Scripts in /scripts/internal/ 1 file (25KB) 0 files 🗑️ -100%
Scripts in /.internal-tests/ 3 files (22KB) 1 file (9KB) 🗑️ -67%
Total redundant code ~39KB 0KB ✅ All removed
Broken doc references 4 broken links 0 ✅ All fixed
Duplicate functionality Yes (env detection) No ✅ Single source

✅ What Remains

User-Facing Scripts (4 files)

scripts/
├── install-complete.sh    # The ONLY installation entry point
├── configure.sh           # Interactive configuration
├── test-audio.sh          # Audio playback testing
└── uninstall.sh           # Clean removal

Internal Test Script (1 file)

scripts/.internal-tests/
└── test-path-utils.sh     # The ONLY test script actually used by installer

Total: Just 5 scripts. Everything else is gone.

🚀 Quick Install (Unchanged)

git clone https://github.com/ChanMeng666/claude-code-audio-hooks.git
cd claude-code-audio-hooks
bash scripts/install-complete.sh

That's it! One command, zero redundancy, zero confusion.

📈 Cumulative Cleanup Stats (v3.0 → v3.1.1)

Since v3.0.0, we've removed:

  • v3.1.0: ~4,100 lines (examples/, docs/, obsolete patches)
  • v3.1.1: ~1,222 lines (redundant internal scripts)
  • Total: ~5,322 lines of code removed 🎉

The project is now ultra-minimal - containing only what's truly necessary.

🔍 Full Details

See CHANGELOG.md for complete technical details.

📦 What You Still Get

  • ✅ 9 audio notification hooks for Claude Code
  • ✅ Dual audio system (voice or chimes)
  • ✅ Automatic environment detection
  • ✅ 98%+ installation success rate
  • ✅ Comprehensive logging and validation
  • ✅ Now with ZERO redundant code!

Installation Time: 1-2 minutes
Success Rate: 98%+
Platforms: Windows (WSL/Git Bash/Cygwin) | macOS | Linux
Lines of Code: Minimalist ✨

Assets 2
Loading