refactor: update CLI command structure to use 'generate' subcommand

- Change commitment invocation from `commitment --message-only` to `commitment generate --message-only` across all documentation and examples
- Update hook scripts in git-hooks, husky, lefthook, lint-staged, and simple-git-hooks examples
- Enhance lefthook and lint-staged examples with detailed commit message validation and formatting steps
- Update init.ts to reflect new command structure in generated hooks
- Update CHANGELOG.md and all documentation (CLI.md, HOOKS.md) to reflect new command syntax
- Maintain backward compatibility with $2 parameter check for preserving user-specified messages

🤖 Generated with Claude via commitment

Author: arittr

CHANGELOG.md

@@ -30,7 +30,7 @@ If you previously used `--no-ai`:
    npx commitment --no-ai --message-only > "$1"
 
    # After
-   npx commitment --message-only > "$1"
+   npx commitment generate --message-only > "$1"
    ```
 
 **Why This Change?**

docs/CLI.md

@@ -93,7 +93,7 @@ Output only the commit message to stdout (no decorations, no commit).
 - **Default**: `false`
 - **Example**:
   ```bash
-  npx commitment --message-only
+  npx commitment generate --message-only
   ```
 
 **Use Cases:**
@@ -103,7 +103,7 @@ Output only the commit message to stdout (no decorations, no commit).
 
 **Output:**
 ```bash
-$ npx commitment --message-only
+$ npx commitment generate --message-only
 feat: add user authentication
 
 - Implement JWT token generation
@@ -223,7 +223,7 @@ Creates `.husky/prepare-commit-msg`:
 #!/bin/sh
 # commitment: AI-powered commit messages
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || exit 1
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -234,7 +234,7 @@ Updates `package.json`:
 ```json
 {
   "simple-git-hooks": {
-    "prepare-commit-msg": "[ -z \"$2\" ] && npx commitment --message-only > $1"
+    "prepare-commit-msg": "[ -z \"$2\" ] && npx commitment generate --message-only > $1"
   }
 }
 ```
@@ -247,7 +247,7 @@ Creates `.git/hooks/prepare-commit-msg`:
 #!/bin/sh
 # commitment: AI-powered commit messages
 if [ -z "$2" ]; then
-  npx commitment --message-only > "$1" || exit 1
+  npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 

docs/HOOKS.md

@@ -133,7 +133,7 @@ npx husky add .husky/prepare-commit-msg
 # commitment: AI-powered commit messages
 # Only run for regular commits (not merge, squash, or when message specified)
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || exit 1
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -196,7 +196,7 @@ npm install -D simple-git-hooks
     "prepare": "simple-git-hooks"
   },
   "simple-git-hooks": {
-    "prepare-commit-msg": "[ -z \"$2\" ] && npx commitment --message-only > $1"
+    "prepare-commit-msg": "[ -z \"$2\" ] && npx commitment generate --message-only > $1"
   }
 }
 ```
@@ -213,13 +213,13 @@ npx simple-git-hooks
 
 The hook is a one-liner shell command:
 ```bash
-[ -z "$2" ] && npx commitment --message-only > $1
+[ -z "$2" ] && npx commitment generate --message-only > $1
 ```
 
 **Breakdown:**
 - `[ -z "$2" ]` - Check if `$2` (commit source) is empty
 - `&&` - If true (regular commit), run commitment
-- `npx commitment --message-only` - Generate message
+- `npx commitment generate --message-only` - Generate message
 - `> $1` - Write to commit message file
 
 ### Plain Git Hooks
@@ -253,7 +253,7 @@ chmod +x .git/hooks/prepare-commit-msg
 # commitment: AI-powered commit messages
 # Only run for regular commits (not merge, squash, or when message specified)
 if [ -z "$2" ]; then
-  npx commitment --message-only > "$1" || exit 1
+  npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -315,7 +315,7 @@ The hook uses git's `$2` parameter (commit source) to decide whether to generate
 ```bash
 if [ -z "$2" ]; then
   # $2 is empty → regular commit → generate
-  npx commitment --message-only > "$1"
+  npx commitment generate --message-only > "$1"
 fi
 ```
 
@@ -377,7 +377,7 @@ fi
 
 # Otherwise generate AI message
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || exit 1
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -389,7 +389,7 @@ fi
 
 if [ -z "$2" ]; then
   # Generate message, fail commit if AI fails
-  npx commitment --message-only > "$1"
+  npx commitment generate --message-only > "$1"
 
   if [ $? -ne 0 ]; then
     echo "❌ Failed to generate commit message"
@@ -406,7 +406,7 @@ fi
 
 if [ -z "$2" ]; then
   # Try AI generation
-  if ! npx commitment --message-only > "$1" 2>/dev/null; then
+  if ! npx commitment generate --message-only > "$1" 2>/dev/null; then
     # If AI fails, use template
     cat > "$1" << EOF
 feat:
@@ -440,7 +440,7 @@ Add timeout to prevent hanging:
 
 if [ -z "$2" ]; then
   # 30 second timeout
-  timeout 30 npx commitment --message-only > "$1" || exit 1
+  timeout 30 npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -460,7 +460,7 @@ if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
 fi
 
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || exit 1
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -474,7 +474,7 @@ fi
 if git diff --cached --name-only | grep -v "\.md$" > /dev/null; then
   # Has non-markdown changes, use AI
   if [ -z "$2" ]; then
-    exec < /dev/tty && npx commitment --message-only > "$1" || exit 1
+    exec < /dev/tty && npx commitment generate --message-only > "$1" || exit 1
   fi
 else
   # Only markdown changes, use simple message
@@ -576,7 +576,7 @@ cat .husky/prepare-commit-msg
 Should have `if [ -z "$2" ]` check:
 ```bash
 if [ -z "$2" ]; then
-  npx commitment --message-only > "$1"
+  npx commitment generate --message-only > "$1"
 fi
 ```
 
@@ -612,7 +612,7 @@ if [ -n "$CI" ]; then
 fi
 
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || exit 1
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -705,7 +705,7 @@ npm run lint-staged
 
 # commitment integration
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || exit 1
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || exit 1
 fi
 ```
 
@@ -741,7 +741,7 @@ Provide template for when AI fails:
 # .husky/prepare-commit-msg
 
 if [ -z "$2" ]; then
-  if ! exec < /dev/tty npx commitment --message-only > "$1" 2>/dev/null; then
+  if ! exec < /dev/tty npx commitment generate --message-only > "$1" 2>/dev/null; then
     # AI failed, use template
     cat > "$1" << 'EOF'
 # Enter commit message following Conventional Commits:
@@ -787,7 +787,7 @@ echo "[$(date)] prepare-commit-msg started" >> "$LOG_FILE"
 echo "  Args: $*" >> "$LOG_FILE"
 
 if [ -z "$2" ]; then
-  if exec < /dev/tty npx commitment --message-only > "$1" 2>> "$LOG_FILE"; then
+  if exec < /dev/tty npx commitment generate --message-only > "$1" 2>> "$LOG_FILE"; then
     echo "  Result: Success" >> "$LOG_FILE"
   else
     echo "  Result: Failed ($?)" >> "$LOG_FILE"

docs/constitutions/v3/architecture.md

@@ -626,7 +626,7 @@ lefthook.yml text eol=lf
 ```bash
 # Only run for regular commits (not merge, squash, or when message specified)
 if [ -z "$2" ]; then
-  npx commitment --message-only > "$1"
+  npx commitment generate --message-only > "$1"
 fi
 ```
 

docs/constitutions/v3/patterns.md

@@ -373,12 +373,12 @@ async function initCommand(options: InitOptions): Promise<void> {
 #!/bin/sh
 # Only run for regular commits (not merge, squash, or when message specified)
 if [ -z "$2" ]; then
-  npx commitment --message-only > "$1"
+  npx commitment generate --message-only > "$1"
 fi
 
 ❌ Wrong:
 #!/bin/sh
-npx commitment --message-only > "$1"  # ❌ Overrides user messages!
+npx commitment generate --message-only > "$1"  # ❌ Overrides user messages!
 ```
 
 **Why:** `$2` contains commit source:

examples/git-hooks/README.md

@@ -43,7 +43,7 @@ cat > .git/hooks/prepare-commit-msg << 'EOF'
 #!/bin/sh
 # Only run for regular commits
 if [ -z "$2" ]; then
-  npx commitment --message-only > "$1" || true
+  npx commitment generate --message-only > "$1" || true
 fi
 EOF
 
@@ -100,7 +100,7 @@ You can combine multiple prepare-commit-msg behaviors:
 # Only run for regular commits
 if [ -z "$2" ]; then
   # Generate AI commit message
-  npx commitment --message-only > "$1" || true
+  npx commitment generate --message-only > "$1" || true
 
   # Add issue number from branch name
   BRANCH_NAME=$(git symbolic-ref --short HEAD)
@@ -123,7 +123,7 @@ BRANCH_NAME=$(git symbolic-ref --short HEAD)
 
 # Only generate for feature branches
 if [[ $BRANCH_NAME == feature/* ]] && [ -z "$2" ]; then
-  npx commitment --message-only > "$1" || true
+  npx commitment generate --message-only > "$1" || true
 fi
 ```
 

examples/git-hooks/prepare-commit-msg

@@ -4,5 +4,5 @@
 
 # Only run for regular commits
 if [ -z "$2" ]; then
-  npx commitment --message-only > "$1" || true
+  npx commitment generate --message-only > "$1" || true
 fi

examples/global-install/README.md

@@ -62,7 +62,7 @@ cat > .git/hooks/prepare-commit-msg << 'EOF'
 #!/bin/sh
 # Generate commit message with commitment (global install)
 if [ -z "$2" ]; then
-  commitment --message-only > "$1" || true
+  commitment generate --message-only > "$1" || true
 fi
 EOF
 
@@ -204,7 +204,7 @@ mkdir -p ~/.git-templates/hooks
 cat > ~/.git-templates/hooks/prepare-commit-msg << 'EOF'
 #!/bin/sh
 if [ -z "$2" ]; then
-  commitment --message-only > "$1" || true
+  commitment generate --message-only > "$1" || true
 fi
 EOF
 

examples/husky/README.md

@@ -52,7 +52,7 @@ cat > .husky/prepare-commit-msg << 'EOF'
 #!/bin/sh
 # Generate commit message with AI
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || true
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || true
 fi
 EOF
 

examples/husky/prepare-commit-msg

@@ -4,5 +4,5 @@
 
 # Only run for regular commits (not merge, squash, etc.)
 if [ -z "$2" ]; then
-  exec < /dev/tty && npx commitment --message-only > "$1" || true
+  exec < /dev/tty && npx commitment generate --message-only > "$1" || true
 fi