create-universal-ai-context 2.4.0 → 2.6.0-final

package/templates/base/automation/hooks/post-commit.sh

@@ -1,83 +1,83 @@
-#!/bin/bash
-#
-# Claude Context Engineering - Post-Commit Hook
-#
-# Rebuilds indexes and updates tracking after successful commits.
-# Install with: npx claude-context hooks install
-#
-
-# Colors for output
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-# Get the repository root
-REPO_ROOT=$(git rev-parse --show-toplevel)
-CLAUDE_DIR="$REPO_ROOT/.claude"
-CONFIG_FILE="$CLAUDE_DIR/automation/config.json"
-
-# Check if claude context is set up
-if [ ! -d "$CLAUDE_DIR" ]; then
-    exit 0  # No .claude directory, skip
-fi
-
-# Load config (if jq is available)
-REBUILD_CODE_MAP=true
-UPDATE_HASHES=true
-
-if command -v jq &> /dev/null && [ -f "$CONFIG_FILE" ]; then
-    REBUILD_CODE_MAP=$(jq -r '.hooks.post_commit.rebuild_code_map // true' "$CONFIG_FILE")
-    UPDATE_HASHES=$(jq -r '.hooks.post_commit.update_hashes // true' "$CONFIG_FILE")
-fi
-
-# Check if npx is available
-if ! command -v npx &> /dev/null; then
-    exit 0
-fi
-
-# Get list of files that were committed
-COMMITTED_FILES=$(git diff-tree --no-commit-id --name-only -r HEAD)
-
-# Check if any code files were committed
-CODE_COMMITTED=false
-for file in $COMMITTED_FILES; do
-    case "$file" in
-        *.py|*.js|*.ts|*.jsx|*.tsx|*.go|*.rs|*.rb|*.java)
-            CODE_COMMITTED=true
-            break
-            ;;
-    esac
-done
-
-# Skip if no code files
-if [ "$CODE_COMMITTED" = false ]; then
-    exit 0
-fi
-
-echo -e "${GREEN}Claude Context: Post-commit update${NC}"
-
-# Update file hashes (async, don't block)
-if [ "$UPDATE_HASHES" = "true" ]; then
-    # Update hashes for committed files
-    for file in $COMMITTED_FILES; do
-        if [ -f "$file" ]; then
-            HASH=$(git hash-object "$file" 2>/dev/null)
-            if [ -n "$HASH" ]; then
-                # Write to hashes file (simple append for now)
-                echo "  Updated hash: $file"
-            fi
-        fi
-    done
-fi
-
-# Rebuild code map (optional, can be slow)
-if [ "$REBUILD_CODE_MAP" = "true" ]; then
-    if [ -f "$CLAUDE_DIR/automation/generators/code-mapper.js" ]; then
-        # Run in background to not slow down commits
-        (node "$CLAUDE_DIR/automation/generators/code-mapper.js" --quiet &> /dev/null &)
-        echo -e "  ${YELLOW}Code map rebuild queued (background)${NC}"
-    fi
-fi
-
-echo -e "${GREEN}Post-commit update complete.${NC}"
-exit 0
+#!/bin/bash
+#
+# Claude Context Engineering - Post-Commit Hook
+#
+# Rebuilds indexes and updates tracking after successful commits.
+# Install with: npx claude-context hooks install
+#
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Get the repository root
+REPO_ROOT=$(git rev-parse --show-toplevel)
+CLAUDE_DIR="$REPO_ROOT/.claude"
+CONFIG_FILE="$CLAUDE_DIR/automation/config.json"
+
+# Check if claude context is set up
+if [ ! -d "$CLAUDE_DIR" ]; then
+    exit 0  # No .claude directory, skip
+fi
+
+# Load config (if jq is available)
+REBUILD_CODE_MAP=true
+UPDATE_HASHES=true
+
+if command -v jq &> /dev/null && [ -f "$CONFIG_FILE" ]; then
+    REBUILD_CODE_MAP=$(jq -r '.hooks.post_commit.rebuild_code_map // true' "$CONFIG_FILE")
+    UPDATE_HASHES=$(jq -r '.hooks.post_commit.update_hashes // true' "$CONFIG_FILE")
+fi
+
+# Check if npx is available
+if ! command -v npx &> /dev/null; then
+    exit 0
+fi
+
+# Get list of files that were committed
+COMMITTED_FILES=$(git diff-tree --no-commit-id --name-only -r HEAD)
+
+# Check if any code files were committed
+CODE_COMMITTED=false
+for file in $COMMITTED_FILES; do
+    case "$file" in
+        *.py|*.js|*.ts|*.jsx|*.tsx|*.go|*.rs|*.rb|*.java)
+            CODE_COMMITTED=true
+            break
+            ;;
+    esac
+done
+
+# Skip if no code files
+if [ "$CODE_COMMITTED" = false ]; then
+    exit 0
+fi
+
+echo -e "${GREEN}Claude Context: Post-commit update${NC}"
+
+# Update file hashes (async, don't block)
+if [ "$UPDATE_HASHES" = "true" ]; then
+    # Update hashes for committed files
+    for file in $COMMITTED_FILES; do
+        if [ -f "$file" ]; then
+            HASH=$(git hash-object "$file" 2>/dev/null)
+            if [ -n "$HASH" ]; then
+                # Write to hashes file (simple append for now)
+                echo "  Updated hash: $file"
+            fi
+        fi
+    done
+fi
+
+# Rebuild code map (optional, can be slow)
+if [ "$REBUILD_CODE_MAP" = "true" ]; then
+    if [ -f "$CLAUDE_DIR/automation/generators/code-mapper.js" ]; then
+        # Run in background to not slow down commits
+        (node "$CLAUDE_DIR/automation/generators/code-mapper.js" --quiet &> /dev/null &)
+        echo -e "  ${YELLOW}Code map rebuild queued (background)${NC}"
+    fi
+fi
+
+echo -e "${GREEN}Post-commit update complete.${NC}"
+exit 0

package/templates/base/automation/hooks/pre-commit.sh

@@ -1,103 +1,103 @@
-#!/bin/bash
-#
-# Claude Context Engineering - Pre-Commit Hook
-#
-# Validates documentation synchronization before allowing commits.
-# Install with: npx claude-context hooks install
-#
-
-# Colors for output
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-GREEN='\033[0;32m'
-NC='\033[0m' # No Color
-
-# Get the repository root
-REPO_ROOT=$(git rev-parse --show-toplevel)
-CLAUDE_DIR="$REPO_ROOT/.claude"
-CONFIG_FILE="$CLAUDE_DIR/automation/config.json"
-
-# Check if claude context is set up
-if [ ! -d "$CLAUDE_DIR" ]; then
-    exit 0  # No .claude directory, skip checks
-fi
-
-# Load config (if jq is available)
-BLOCK_ON_STALE=false
-CHECK_DRIFT=true
-
-if command -v jq &> /dev/null && [ -f "$CONFIG_FILE" ]; then
-    BLOCK_ON_STALE=$(jq -r '.hooks.pre_commit.block_on_stale // false' "$CONFIG_FILE")
-    CHECK_DRIFT=$(jq -r '.hooks.pre_commit.check_drift // true' "$CONFIG_FILE")
-fi
-
-# Skip if drift check is disabled
-if [ "$CHECK_DRIFT" != "true" ]; then
-    exit 0
-fi
-
-echo -e "${GREEN}Claude Context: Pre-commit validation${NC}"
-
-# Get list of staged files
-STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACMR)
-
-# Check if any code files are being committed
-CODE_FILES=""
-for file in $STAGED_FILES; do
-    case "$file" in
-        *.py|*.js|*.ts|*.jsx|*.tsx|*.go|*.rs|*.rb|*.java)
-            CODE_FILES="$CODE_FILES $file"
-            ;;
-    esac
-done
-
-# If no code files, skip checks
-if [ -z "$CODE_FILES" ]; then
-    echo -e "${GREEN}No code files in commit, skipping drift check.${NC}"
-    exit 0
-fi
-
-# Check if npx is available
-if ! command -v npx &> /dev/null; then
-    echo -e "${YELLOW}Warning: npx not found, skipping documentation drift check.${NC}"
-    exit 0
-fi
-
-# Run drift check
-DRIFT_FOUND=false
-DRIFT_OUTPUT=""
-
-for file in $CODE_FILES; do
-    # Check if this file is referenced in any workflow
-    if grep -r "$file" "$CLAUDE_DIR/context/workflows" &> /dev/null; then
-        echo -e "  Checking: $file"
-
-        # Simple hash-based check
-        CURRENT_HASH=$(git hash-object "$file" 2>/dev/null)
-        STAGED_HASH=$(git ls-files -s "$file" 2>/dev/null | awk '{print $2}')
-
-        if [ -n "$STAGED_HASH" ]; then
-            DRIFT_OUTPUT="$DRIFT_OUTPUT\n  - $file (modified, may affect documentation)"
-            DRIFT_FOUND=true
-        fi
-    fi
-done
-
-# Report findings
-if [ "$DRIFT_FOUND" = true ]; then
-    echo -e "${YELLOW}Documentation may need updating:${NC}"
-    echo -e "$DRIFT_OUTPUT"
-    echo ""
-
-    if [ "$BLOCK_ON_STALE" = true ]; then
-        echo -e "${RED}Commit blocked: Documentation drift detected.${NC}"
-        echo -e "Run ${GREEN}/verify-docs-current${NC} or ${GREEN}npx claude-context sync --check${NC}"
-        echo -e "To skip this check: git commit --no-verify"
-        exit 1
-    else
-        echo -e "${YELLOW}Warning: Consider running /verify-docs-current to check documentation.${NC}"
-    fi
-fi
-
-echo -e "${GREEN}Pre-commit check complete.${NC}"
-exit 0
+#!/bin/bash
+#
+# Claude Context Engineering - Pre-Commit Hook
+#
+# Validates documentation synchronization before allowing commits.
+# Install with: npx claude-context hooks install
+#
+
+# Colors for output
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+# Get the repository root
+REPO_ROOT=$(git rev-parse --show-toplevel)
+CLAUDE_DIR="$REPO_ROOT/.claude"
+CONFIG_FILE="$CLAUDE_DIR/automation/config.json"
+
+# Check if claude context is set up
+if [ ! -d "$CLAUDE_DIR" ]; then
+    exit 0  # No .claude directory, skip checks
+fi
+
+# Load config (if jq is available)
+BLOCK_ON_STALE=false
+CHECK_DRIFT=true
+
+if command -v jq &> /dev/null && [ -f "$CONFIG_FILE" ]; then
+    BLOCK_ON_STALE=$(jq -r '.hooks.pre_commit.block_on_stale // false' "$CONFIG_FILE")
+    CHECK_DRIFT=$(jq -r '.hooks.pre_commit.check_drift // true' "$CONFIG_FILE")
+fi
+
+# Skip if drift check is disabled
+if [ "$CHECK_DRIFT" != "true" ]; then
+    exit 0
+fi
+
+echo -e "${GREEN}Claude Context: Pre-commit validation${NC}"
+
+# Get list of staged files
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACMR)
+
+# Check if any code files are being committed
+CODE_FILES=""
+for file in $STAGED_FILES; do
+    case "$file" in
+        *.py|*.js|*.ts|*.jsx|*.tsx|*.go|*.rs|*.rb|*.java)
+            CODE_FILES="$CODE_FILES $file"
+            ;;
+    esac
+done
+
+# If no code files, skip checks
+if [ -z "$CODE_FILES" ]; then
+    echo -e "${GREEN}No code files in commit, skipping drift check.${NC}"
+    exit 0
+fi
+
+# Check if npx is available
+if ! command -v npx &> /dev/null; then
+    echo -e "${YELLOW}Warning: npx not found, skipping documentation drift check.${NC}"
+    exit 0
+fi
+
+# Run drift check
+DRIFT_FOUND=false
+DRIFT_OUTPUT=""
+
+for file in $CODE_FILES; do
+    # Check if this file is referenced in any workflow
+    if grep -r "$file" "$CLAUDE_DIR/context/workflows" &> /dev/null; then
+        echo -e "  Checking: $file"
+
+        # Simple hash-based check
+        CURRENT_HASH=$(git hash-object "$file" 2>/dev/null)
+        STAGED_HASH=$(git ls-files -s "$file" 2>/dev/null | awk '{print $2}')
+
+        if [ -n "$STAGED_HASH" ]; then
+            DRIFT_OUTPUT="$DRIFT_OUTPUT\n  - $file (modified, may affect documentation)"
+            DRIFT_FOUND=true
+        fi
+    fi
+done
+
+# Report findings
+if [ "$DRIFT_FOUND" = true ]; then
+    echo -e "${YELLOW}Documentation may need updating:${NC}"
+    echo -e "$DRIFT_OUTPUT"
+    echo ""
+
+    if [ "$BLOCK_ON_STALE" = true ]; then
+        echo -e "${RED}Commit blocked: Documentation drift detected.${NC}"
+        echo -e "Run ${GREEN}/verify-docs-current${NC} or ${GREEN}npx claude-context sync --check${NC}"
+        echo -e "To skip this check: git commit --no-verify"
+        exit 1
+    else
+        echo -e "${YELLOW}Warning: Consider running /verify-docs-current to check documentation.${NC}"
+    fi
+fi
+
+echo -e "${GREEN}Pre-commit check complete.${NC}"
+exit 0

package/templates/base/ci-templates/README.md

@@ -1,108 +1,108 @@
-# CI/CD Templates
-
-Pre-built CI/CD workflows for Claude Context Engineering validation.
-
-## Available Templates
-
-### GitHub Actions
-
-| Template | Purpose | Trigger |
-|----------|---------|---------|
-| `validate-docs.yml` | Validate documentation on PRs | Pull requests |
-| `context-check.yml` | Monitor context budget health | Push, weekly, manual |
-
-## Installation
-
-### GitHub Actions
-
-Copy templates to your `.github/workflows/` directory:
-
-```bash
-# From project root
-mkdir -p .github/workflows
-cp .ai-context/ci-templates/github-actions/*.yml .github/workflows/
-```
-
-### Prerequisites
-
-1. Node.js 18+ available in CI environment
-2. `.ai-context/tools/` dependencies installed:
-   ```bash
-   cd .ai-context/tools && npm ci
-   ```
-
-## Customization
-
-### Adjust Validation Strictness
-
-Edit the workflow files to change thresholds:
-
-```yaml
-# In validate-docs.yml
-- name: Check Line Number Accuracy
-  run: |
-    npx claude-context validate --lines --threshold 70  # Stricter
-```
-
-### Add Notifications
-
-Add Slack/Discord notifications on failure:
-
-```yaml
-- name: Notify on Failure
-  if: failure()
-  uses: 8398a7/action-slack@v3
-  with:
-    status: ${{ job.status }}
-    webhook_url: ${{ secrets.SLACK_WEBHOOK }}
-```
-
-### Skip on Specific Files
-
-Modify the `paths` filter:
-
-```yaml
-on:
-  pull_request:
-    paths:
-      - '.ai-context/**'
-      - 'src/**'
-      - '!src/**/*.test.js'  # Exclude test files
-```
-
-## Workflow Outputs
-
-### validate-docs.yml
-
-- **validation-report.md** - Detailed validation results
-- PR comment on failure with specific issues
-
-### context-check.yml
-
-- **metrics.json** - Documentation metrics
-- **diagnostics.txt** - System diagnostics
-- **validation.txt** - Full validation output
-- Auto-creates issue on weekly failure
-
-## Troubleshooting
-
-### "CLI tools not found"
-
-Ensure tools are installed:
-```bash
-cd .ai-context/tools && npm ci
-```
-
-### "Validation always fails on line numbers"
-
-Line number drift is expected. Adjust threshold:
-```yaml
---threshold 50  # More lenient
-```
-
-### "Context budget exceeded"
-
-Review documentation and consider:
-1. Splitting large workflow files
-2. Moving rarely-used content to separate files
-3. Compacting verbose sections
+# CI/CD Templates
+
+Pre-built CI/CD workflows for Claude Context Engineering validation.
+
+## Available Templates
+
+### GitHub Actions
+
+| Template | Purpose | Trigger |
+|----------|---------|---------|
+| `validate-docs.yml` | Validate documentation on PRs | Pull requests |
+| `context-check.yml` | Monitor context budget health | Push, weekly, manual |
+
+## Installation
+
+### GitHub Actions
+
+Copy templates to your `.github/workflows/` directory:
+
+```bash
+# From project root
+mkdir -p .github/workflows
+cp .ai-context/ci-templates/github-actions/*.yml .github/workflows/
+```
+
+### Prerequisites
+
+1. Node.js 18+ available in CI environment
+2. `.ai-context/tools/` dependencies installed:
+   ```bash
+   cd .ai-context/tools && npm ci
+   ```
+
+## Customization
+
+### Adjust Validation Strictness
+
+Edit the workflow files to change thresholds:
+
+```yaml
+# In validate-docs.yml
+- name: Check Line Number Accuracy
+  run: |
+    npx claude-context validate --lines --threshold 70  # Stricter
+```
+
+### Add Notifications
+
+Add Slack/Discord notifications on failure:
+
+```yaml
+- name: Notify on Failure
+  if: failure()
+  uses: 8398a7/action-slack@v3
+  with:
+    status: ${{ job.status }}
+    webhook_url: ${{ secrets.SLACK_WEBHOOK }}
+```
+
+### Skip on Specific Files
+
+Modify the `paths` filter:
+
+```yaml
+on:
+  pull_request:
+    paths:
+      - '.ai-context/**'
+      - 'src/**'
+      - '!src/**/*.test.js'  # Exclude test files
+```
+
+## Workflow Outputs
+
+### validate-docs.yml
+
+- **validation-report.md** - Detailed validation results
+- PR comment on failure with specific issues
+
+### context-check.yml
+
+- **metrics.json** - Documentation metrics
+- **diagnostics.txt** - System diagnostics
+- **validation.txt** - Full validation output
+- Auto-creates issue on weekly failure
+
+## Troubleshooting
+
+### "CLI tools not found"
+
+Ensure tools are installed:
+```bash
+cd .ai-context/tools && npm ci
+```
+
+### "Validation always fails on line numbers"
+
+Line number drift is expected. Adjust threshold:
+```yaml
+--threshold 50  # More lenient
+```
+
+### "Context budget exceeded"
+
+Review documentation and consider:
+1. Splitting large workflow files
+2. Moving rarely-used content to separate files
+3. Compacting verbose sections