Installation & Deployment

CCCP can be deployed in two complementary modes: globally across your entire development workstation, or locally inside individual Git repositories via lightweight hook wrappers.

1. Global Installation (System PATH)

Installing CCCP into your system PATH makes the cccp executable universally available from any directory or terminal:

# Automated one-liner installation (installs into ~/.local/bin/cccp)
curl -fsSL https://cccp.2lp.in | sh

# Or install the rolling nightly development build:
curl -fsSL https://cccp.2lp.in | sh -s -- nightly

If you already have cloned the repository locally:

./cccp.sh install --global

2. Local Repository Hooks Installation

Within any Git project, you can install portable Git hook wrappers without modifying system directories:

cd my-git-repo
cccp install

This configures four standard hooks in .git/hooks/:

• commit-msg: Validates commit message syntax before commits are finalized.
• post-commit: Updates CHANGELOG.md and synchronizes predictive development versioning in VERSION.
• pre-push: Verifies that pushed release tags contain clean matching version files.
• reference-transaction: Prevents creating tags pointing to non-compliant or development commits.

3. Safety & Non-Destructive Backups

Whenever cccp install encounters pre-existing Git hooks not created by CCCP, it safely backs them up into timestamped/incremented files (e.g. commit-msg.old) so that no custom logic is ever destroyed.

4. Uninstallation

# Remove Git hooks from active repository:
cccp uninstall

# Remove global executable:
rm -f ~/.local/bin/cccp