Skip to content

v4.0.0 - CommitCraft Architecture Simplification & Automated Releases

Choose a tag to compare

View all tags
@randynov randynov released this 24 Oct 00:00
· 65 commits to main since this release
v4.0.0
41d8d1e

🚨 Breaking Changes

CommitCraft: Architecture simplified to 2-tier system

  • Old workflow: Install globally → Run per-repo setup → Commands work
  • New workflow: Install globally → Commands work everywhere immediately
  • Removed:
    • commitcraft-init.sh - Per-repo installer no longer needed
    • post-checkout hook - No git hook-based discovery
    • Git template directory setup
    • Shell alias auto-configuration
  • Impact: Existing users need to re-run ./commitcraft-install.sh to update. Local .claude/ directories are no longer used—commands reference ~/.claude/scripts/ directly.

✨ Features

CommitCraft: Add automated release command with semantic versioning

  • New /commitcraft-release command for automated GitHub releases
  • Auto-detects version bump from conventional commits (BREAKING CHANGE/feat/fix)
  • Generates structured release notes with categorized sections
  • Integrates with GitHub CLI (gh) for release publishing
  • Includes commitcraft-release-analyze.sh for version analysis and validation
  • Comprehensive user guide at docs/commitcraft-release.md (390 lines)

CommitCraft: Add development workflow enhancement toolkit

  • New CommitCraft system for propagating Claude Code enhancements across repositories
  • /commitcraft-push command for AI-assisted commits with security scanning
  • Pre-commit analysis with secret detection, sync status, and large file warnings
  • TUI installer with hash-based state detection and delta diffs
  • Comprehensive documentation with setup guides and extension patterns

ExtensionAuditor: Add Chrome extension security scanner

  • Cross-platform tool for analyzing installed browser extensions
  • Hybrid approach: local manifests + web enrichment
  • Generates CRXplorer-compatible CSV for security analysis
  • Zero external dependencies (Python stdlib only)
  • Professional output with progress tracking

📚 Documentation

CommitCraft Documentation Overhaul

  • README.md: Rewrite for 2-tier architecture (-50% complexity, 337 lines)
  • docs/commitcraft-release.md: Complete user guide with troubleshooting (390 lines)
  • docs/commitcraft-push.md: Updated workflow without per-repo setup
  • docs/adding-tools.md: Rewritten for global-only pattern (493 lines)
  • Main README.md: Add strategy/goals section with contributing guidelines
  • Update repository structure diagrams to reflect current files

🔧 Other Changes

CommitCraft: Installer improvements

  • Remove git template directory setup (no longer used)
  • Remove shell alias prompts (manual configuration via shell-aliases file)
  • Fix obsolete script references (install-hooks.sh → commitcraft-install.sh)
  • Keep cleanup logic for users upgrading from v3.x
  • Update file counts: 2 scripts + 2 commands (previously showed 1 command)

📝 Upgrade Instructions

For CommitCraft Users (v3.x → v4.0.0)

Breaking change: Architecture simplified. Follow these steps:

  1. Pull latest code:

    cd ~/Code/AppletScriptorium
git pull

  2. Re-run installer:

    cd CommitCraft
./commitcraft-install.sh

    This updates ~/.claude/ with new commands and removes obsolete hooks.

  3. Clean up local directories (optional):

    # In any repo where you previously ran commitcraft-init
rm -rf .claude/

    Local .claude/ directories are no longer used. Commands now reference ~/.claude/scripts/ directly.

  4. Test commands:

    # Commands work immediately in any repository
/commitcraft-push
/commitcraft-release

What changed:

  • ✗ No more per-repo setup required
  • ✗ No git hooks for passive discovery
  • ✓ Commands work in all repos after single global install
  • ✓ Simpler, faster workflow

🎯 What's New in v4.0.0

Major improvements:

  • Simpler setup: One install, works everywhere (no per-repo configuration)
  • Automated releases: New /commitcraft-release command with semver detection
  • Better docs: Strategy/goals, comprehensive guides, troubleshooting
  • New tools: ExtensionAuditor for browser security scanning

Files changed: 12 files, 1,420 insertions, 678 deletions

Key additions:

  • commitcraft-release-analyze.sh - Release version analysis script
  • commitcraft-release.md - Automated release command
  • docs/commitcraft-release.md - Release command user guide

Key deletions:

  • commitcraft-init.sh - No longer needed (2-tier architecture)
  • post-checkout - No longer needed (no git hooks)

🙏 Credits

All commits co-authored by Claude Code.

🤖 Generated with Claude Code

Assets 2
Loading