Merge pull request #157 from link-foundation/claude/review-test-standards-01GsYvAqSF7k3oxTeEwYsX9W

Review test standardization and coverage plans

Author: konard

.githooks/README.md

@@ -0,0 +1,74 @@
+# Git Hooks
+
+This directory contains git hooks for the Links Notation project to ensure code quality and consistency.
+
+## Installation
+
+To install the git hooks, run:
+
+```bash
+bash .githooks/install-hooks.sh
+```
+
+Or configure git to use this directory for hooks:
+
+```bash
+git config core.hooksPath .githooks
+```
+
+## Available Hooks
+
+### pre-commit
+
+Automatically regenerates `TEST_CASE_COMPARISON.md` when test files are modified.
+
+**Triggers when:**
+- Any Python test file (`*/tests/*.py`) is staged
+- Any JavaScript test file (`*/tests/*.js`) is staged
+- Any Rust test file (`*/tests/*.rs`) is staged
+- Any C# test file (`*/tests/*.cs`) is staged
+
+**What it does:**
+1. Detects that test files have been modified
+2. Runs `node scripts/create-test-case-comparison.mjs` to regenerate the comparison document
+3. If `TEST_CASE_COMPARISON.md` changed, automatically stages it for the commit
+4. Fails the commit if regeneration fails (with instructions to fix)
+
+**Why this is important:**
+The test comparison document provides a comprehensive overview of test parity across all language implementations. Keeping it up-to-date ensures developers can always see the current state of test coverage.
+
+## Bypassing Hooks
+
+If you need to bypass the hooks for a specific commit (not recommended), use:
+
+```bash
+git commit --no-verify
+```
+
+## Troubleshooting
+
+### Hook not running
+
+Make sure the hooks are executable:
+
+```bash
+chmod +x .githooks/*
+```
+
+### Regeneration fails
+
+If the comparison script fails:
+
+1. Check that Node.js is installed
+2. Run the script manually: `node scripts/create-test-case-comparison.mjs`
+3. Review any error messages
+4. Fix any issues and try committing again
+
+## Adding New Hooks
+
+To add a new hook:
+
+1. Create the hook file in `.githooks/`
+2. Make it executable: `chmod +x .githooks/your-hook`
+3. Update this README to document it
+4. Run the install script or notify team members to reinstall hooks

.githooks/install-hooks.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+#
+# Install git hooks from .githooks directory
+#
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOKS_DIR="$(git rev-parse --git-dir)/hooks"
+
+echo "Installing git hooks..."
+
+for hook in "$SCRIPT_DIR"/*; do
+    hook_name=$(basename "$hook")
+
+    # Skip this install script and README
+    if [[ "$hook_name" == "install-hooks.sh" ]] || [[ "$hook_name" == "README.md" ]]; then
+        continue
+    fi
+
+    # Skip if not a file
+    if [[ ! -f "$hook" ]]; then
+        continue
+    fi
+
+    target="$HOOKS_DIR/$hook_name"
+
+    # Copy hook
+    cp "$hook" "$target"
+    chmod +x "$target"
+
+    echo "✓ Installed $hook_name"
+done
+
+echo ""
+echo "Git hooks installed successfully!"
+echo "These hooks will now run automatically on git operations."

.githooks/pre-commit

@@ -0,0 +1,38 @@
+#!/bin/bash
+#
+# Pre-commit hook to automatically regenerate TEST_CASE_COMPARISON.md
+# when test files are modified.
+#
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check if any test files are being committed
+test_files_changed=$(git diff --cached --name-only | grep -E 'tests?/.*\.(py|js|rs|cs)$')
+
+if [ -n "$test_files_changed" ]; then
+    echo -e "${YELLOW}Test files modified, regenerating TEST_CASE_COMPARISON.md...${NC}"
+
+    # Run the comparison script
+    if node scripts/create-test-case-comparison.mjs > /dev/null 2>&1; then
+        # Check if TEST_CASE_COMPARISON.md was modified
+        if git diff --name-only TEST_CASE_COMPARISON.md | grep -q "TEST_CASE_COMPARISON.md"; then
+            echo -e "${GREEN}✓ TEST_CASE_COMPARISON.md regenerated${NC}"
+            git add TEST_CASE_COMPARISON.md
+            echo -e "${GREEN}✓ TEST_CASE_COMPARISON.md staged for commit${NC}"
+        else
+            echo -e "${GREEN}✓ TEST_CASE_COMPARISON.md is up-to-date${NC}"
+        fi
+    else
+        echo -e "${RED}✗ Failed to regenerate TEST_CASE_COMPARISON.md${NC}"
+        echo -e "${YELLOW}Please run: node scripts/create-test-case-comparison.mjs${NC}"
+        exit 1
+    fi
+fi
+
+# Run any other pre-commit checks here
+
+exit 0