feat: add commit-msg hook and simplify session-commit

Add a Husky commit-msg hook that validates conventional commit
type prefix, authorship trailer, and no em dashes. Remove the
redundant commit-user command and strip progress/blocker logging
from session-commit.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: Cragsmann

.claude/commands/commit-user.md

@@ -1,48 +1,31 @@
 ---
-allowed-tools: Bash(git *), Read, Edit, Write
-description: Stage changes, update progress log, and commit (end-of-session)
+allowed-tools: Bash(git *)
+description: Stage changes and commit (end-of-session)
 ---
 
 # Session Commit
 
-Automate end-of-session cleanup: stage, log progress, commit.
+Automate end-of-session cleanup: stage and commit.
 
 ## Steps
 
-1. **Assess changes** — run these in parallel:
+1. **Assess changes** -- run these in parallel:
    - `git status`
    - `git diff HEAD`
    - `git branch --show-current`
    - `git log --oneline -10`
 
-2. **Stage everything** — if there are unstaged or untracked changes:
+2. **Stage everything** -- if there are unstaged or untracked changes:
    - Use `git add <specific-files>` (not `git add .`)
    - Never stage files that likely contain secrets (.env, credentials, etc.)
    - Skip if everything is already staged
 
-3. **Update progress log** — read `docs/claude-progress.txt`, then prepend a new entry at the top (after the header line) following the format in `docs/references/claude-progress-readme.md`.
-   - Analyze the staged diff to determine what was done
-   - Use today's actual date
-   - Be concise but complete
-   - Stage the updated file: `git add docs/claude-progress.txt`
+3. **Draft and commit** -- follow all rules from `docs/references/commit-message-guide.md`:
+   - Subject: `<type>: <description>`, imperative mood
+   - Body is optional if the subject is descriptive enough, otherwise explain what and why
+   - No em dashes anywhere in the message
 
-4. **Migrate blockers** — if the progress entry you just wrote has a `Blockers:` line that is NOT `None`:
-   - Read `docs/agent-struggles.json`
-   - For each blocker, append an entry:
-
-     ```json
-     {
-       "date": "<today>",
-       "description": "<blocker text from progress entry>",
-       "cause": "<your best short assessment>",
-       "suggestion": "<what would fix or prevent this>",
-       "resolved": false
-     }
-     ```
-
-   - Stage: `git add docs/agent-struggles.json`
-
-5. **Draft and commit** — follow all rules from `docs/references/commit-message-guide.md`. Determine authorship mode (tandem vs autonomous) from the guide. Use a HEREDOC:
+   Determine authorship mode (tandem vs autonomous) from the guide. Use a HEREDOC:
 
    ```bash
    git commit -m "$(cat <<'EOF'
@@ -55,11 +38,11 @@ Automate end-of-session cleanup: stage, log progress, commit.
    )"
    ```
 
-6. **Verify** — run `git status` and `git log --oneline -1` to confirm success.
+4. **Verify** -- run `git status` and `git log --oneline -1` to confirm success. If the commit fails due to the commit-msg hook, read the error output, fix the message, and create a NEW commit (never amend).
 
 ## Rules
 
-- Analyze the FULL diff for accurate progress and commit message
+- Analyze the FULL diff for an accurate commit message
 - Never commit secrets or sensitive files
-- If commit fails due to pre-commit hook, fix and create a NEW commit (never amend)
+- If commit fails due to pre-commit or commit-msg hook, fix and create a NEW commit (never amend)
 - Do NOT push to remote

.claude/commands/session-commit.md

@@ -0,0 +1,45 @@
+#!/usr/bin/env sh
+
+MSG_FILE="$1"
+
+# Strip comment lines
+MSG=$(grep -v '^#' "$MSG_FILE")
+
+SUBJECT=$(echo "$MSG" | head -1)
+
+# Skip merge, fixup, and squash commits
+case "$SUBJECT" in
+  Merge\ branch\ *|Merge\ remote-tracking\ *|Merge\ tag\ *) exit 0 ;;
+  fixup\!\ *|squash\!\ *) exit 0 ;;
+esac
+
+ERRORS=""
+
+# 1. Conventional commit format
+TYPES="feat|fix|refactor|docs|test|chore|style|perf|ci|build"
+if ! echo "$SUBJECT" | grep -qE "^($TYPES): .+"; then
+  ERRORS="$ERRORS
+  Subject must match '<type>: <description>'.
+  Types: feat, fix, refactor, docs, test, chore, style, perf, ci, build"
+fi
+
+# 2. Authorship trailer
+if ! echo "$MSG" | grep -qE '^(Co-Authored-By|Signed-off-by): .+'; then
+  ERRORS="$ERRORS
+  Missing authorship trailer (Co-Authored-By or Signed-off-by)."
+fi
+
+# 3. No em dashes
+if echo "$MSG" | grep -q '—'; then
+  ERRORS="$ERRORS
+  Em dashes are not allowed. Use commas, periods, or parentheses."
+fi
+
+if [ -n "$ERRORS" ]; then
+  echo ""
+  echo "commit-msg: FAILED"
+  echo "$ERRORS"
+  echo ""
+  echo "See docs/references/commit-message-guide.md for rules."
+  exit 1
+fi