@synapta/skills 0.1.1 → 0.2.0

package/skills/repo-bootstrap/scripts/analyze-git-history.sh

@@ -0,0 +1,315 @@
+#!/usr/bin/env bash
+# Analyze git history for patterns (commit conventions, branching, releases)
+set -euo pipefail
+
+PROJECT_DIR="${1:-.}"
+cd "$PROJECT_DIR"
+
+# Check if we're in a git repository
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+    echo '{"error": "Not a git repository"}'
+    exit 0
+fi
+
+SAMPLE_SIZE=100
+
+# Helper to count grep matches (returns 0 if no matches instead of error)
+count_matches() {
+    local pattern="$1"
+    local input="$2"
+    local flags="${3:-}"
+    local count
+    # shellcheck disable=SC2086  # flags must be unquoted to work as separate arguments
+    count=$(echo "$input" | grep $flags -cE "$pattern" 2>/dev/null) || count=0
+    echo "$count"
+}
+
+# Analyze commit message conventions
+analyze_commit_convention() {
+    local commits
+    commits=$(git log --oneline -"$SAMPLE_SIZE" --pretty=format:"%s" 2>/dev/null || echo "")
+
+    if [ -z "$commits" ]; then
+        echo '{"convention": "unknown", "confidence": 0}'
+        return
+    fi
+
+    local total_commits
+    total_commits=$(echo "$commits" | wc -l)
+
+    # Count conventional commits (feat:, fix:, docs:, style:, refactor:, test:, chore:, etc.)
+    local conventional_count
+    conventional_count=$(count_matches '^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?(!)?:' "$commits")
+
+    # Count [TAG] style commits
+    local tag_count
+    tag_count=$(count_matches '^\[.+\]' "$commits")
+
+    # Count ticket reference commits (JIRA-123, #123, etc.)
+    local ticket_count
+    ticket_count=$(count_matches '([A-Z]+-[0-9]+|#[0-9]+)' "$commits" "-i")
+
+    # Count emoji commits
+    local emoji_count
+    emoji_count=$(count_matches '^(✨|🐛|📝|🎨|♻️|🚀|✅|🔧|⬆️|🔒)' "$commits")
+
+    # Determine convention
+    local convention="freeform"
+    local confidence=0
+
+    local conventional_pct=$((conventional_count * 100 / total_commits))
+    local tag_pct=$((tag_count * 100 / total_commits))
+    local ticket_pct=$((ticket_count * 100 / total_commits))
+    local emoji_pct=$((emoji_count * 100 / total_commits))
+
+    if [ "$conventional_pct" -ge 50 ]; then
+        convention="conventional-commits"
+        confidence=$conventional_pct
+    elif [ "$tag_pct" -ge 50 ]; then
+        convention="tag-prefix"
+        confidence=$tag_pct
+    elif [ "$emoji_pct" -ge 30 ]; then
+        convention="emoji"
+        confidence=$emoji_pct
+    elif [ "$ticket_pct" -ge 50 ]; then
+        convention="ticket-reference"
+        confidence=$ticket_pct
+    fi
+
+    # Extract common prefixes
+    local prefixes=()
+    if [ "$convention" = "conventional-commits" ]; then
+        mapfile -t prefixes < <(echo "$commits" | grep -oE '^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)' | sort | uniq -c | sort -rn | head -5 | awk '{print $2}')
+    elif [ "$convention" = "tag-prefix" ]; then
+        mapfile -t prefixes < <(echo "$commits" | grep -oE '^\[[^\]]+\]' | sort | uniq -c | sort -rn | head -5 | awk '{print $2}')
+    fi
+
+    local prefixes_json="[]"
+    [ ${#prefixes[@]} -gt 0 ] && prefixes_json=$(printf '%s\n' "${prefixes[@]}" | jq -R . | jq -s .)
+
+    jq -n \
+        --arg convention "$convention" \
+        --arg confidence "$confidence" \
+        --argjson prefixes "$prefixes_json" \
+        --arg total "$total_commits" \
+        --arg conventional "$conventional_count" \
+        --arg tag "$tag_count" \
+        --arg ticket "$ticket_count" \
+        '{
+            convention: $convention,
+            confidence: ($confidence | tonumber),
+            common_prefixes: $prefixes,
+            stats: {
+                total_analyzed: ($total | tonumber),
+                conventional_commits: ($conventional | tonumber),
+                tag_style: ($tag | tonumber),
+                ticket_references: ($ticket | tonumber)
+            }
+        }'
+}
+
+# Analyze branch naming
+analyze_branch_naming() {
+    local branches
+    branches=$(git branch -r 2>/dev/null | grep -v HEAD | sed 's/.*\///' | head -50 || echo "")
+
+    if [ -z "$branches" ]; then
+        echo '{"pattern": "unknown", "stats": {"total_branches": 0}}'
+        return
+    fi
+
+    local total_branches
+    total_branches=$(echo "$branches" | grep -c . || echo "0")
+
+    if [ "$total_branches" -eq 0 ]; then
+        echo '{"pattern": "unknown", "stats": {"total_branches": 0}}'
+        return
+    fi
+
+    # Count different patterns
+    local feature_count
+    feature_count=$(count_matches '^feature[/-]' "$branches")
+
+    local fix_count
+    fix_count=$(count_matches '^(fix|bugfix|hotfix)[/-]' "$branches")
+
+    local release_count
+    release_count=$(count_matches '^release[/-]' "$branches")
+
+    local ticket_count
+    ticket_count=$(count_matches '[A-Z]+-[0-9]+' "$branches" "-i")
+
+    # Determine pattern
+    local pattern="freeform"
+    local has_feature="false"
+    local has_fix="false"
+
+    [[ "$feature_count" -gt 2 ]] && has_feature="true"
+    [[ "$fix_count" -gt 2 ]] && has_fix="true"
+
+    if [[ "$has_feature" == "true" ]] || [[ "$has_fix" == "true" ]]; then
+        pattern="gitflow-style"
+    fi
+    if [ "$total_branches" -gt 0 ] && [ "$ticket_count" -gt $((total_branches / 3)) ]; then
+        pattern="ticket-based"
+    fi
+
+    jq -n \
+        --arg pattern "$pattern" \
+        --argjson has_feature "$has_feature" \
+        --argjson has_fix "$has_fix" \
+        --arg total "$total_branches" \
+        --arg feature "$feature_count" \
+        --arg fix "$fix_count" \
+        --arg release "$release_count" \
+        '{
+            pattern: $pattern,
+            uses_feature_branches: $has_feature,
+            uses_fix_branches: $has_fix,
+            stats: {
+                total_branches: ($total | tonumber),
+                feature_branches: ($feature | tonumber),
+                fix_branches: ($fix | tonumber),
+                release_branches: ($release | tonumber)
+            }
+        }'
+}
+
+# Analyze merge strategy
+analyze_merge_strategy() {
+    local merge_commits
+    merge_commits=$(git log --oneline -"$SAMPLE_SIZE" --merges 2>/dev/null | wc -l || echo "0")
+
+    local total_commits
+    total_commits=$(git log --oneline -"$SAMPLE_SIZE" 2>/dev/null | wc -l || echo "0")
+
+    if [ "$total_commits" -eq 0 ]; then
+        echo '{"strategy": "unknown"}'
+        return
+    fi
+
+    local merge_pct=$((merge_commits * 100 / total_commits))
+
+    local strategy="unknown"
+    if [ "$merge_pct" -lt 5 ]; then
+        strategy="squash-and-merge"
+    elif [ "$merge_pct" -gt 20 ]; then
+        strategy="merge-commits"
+    else
+        strategy="mixed"
+    fi
+
+    # Check for squash patterns in commit messages
+    local squash_patterns
+    squash_patterns=$(git log --oneline -"$SAMPLE_SIZE" 2>/dev/null | grep -cE '\(#[0-9]+\)$' || echo "0")
+
+    if [ "$squash_patterns" -gt $((total_commits / 3)) ]; then
+        strategy="squash-and-merge"
+    fi
+
+    jq -n \
+        --arg strategy "$strategy" \
+        --arg merge_pct "$merge_pct" \
+        --arg merge_commits "$merge_commits" \
+        --arg total "$total_commits" \
+        '{
+            strategy: $strategy,
+            merge_commit_percentage: ($merge_pct | tonumber),
+            stats: {
+                merge_commits: ($merge_commits | tonumber),
+                total_commits: ($total | tonumber)
+            }
+        }'
+}
+
+# Analyze release tagging
+analyze_releases() {
+    local tags
+    tags=$(git tag -l 2>/dev/null | tail -20 || echo "")
+
+    if [ -z "$tags" ]; then
+        echo '{"pattern": "none", "total_tags": 0}'
+        return
+    fi
+
+    local total_tags
+    total_tags=$(echo "$tags" | wc -l)
+
+    # Check for semver pattern (v1.2.3 or 1.2.3)
+    local semver_count
+    semver_count=$(echo "$tags" | grep -cE '^v?[0-9]+\.[0-9]+\.[0-9]+' 2>/dev/null || echo "0")
+
+    # Check for calver pattern (2024.01.15 or similar)
+    local calver_count
+    calver_count=$(echo "$tags" | grep -cE '^[0-9]{4}\.[0-9]{2}' 2>/dev/null || echo "0")
+
+    local pattern="custom"
+    if [ "$semver_count" -gt $((total_tags / 2)) ]; then
+        pattern="semver"
+    elif [ "$calver_count" -gt $((total_tags / 2)) ]; then
+        pattern="calver"
+    fi
+
+    # Check for v prefix
+    local has_v_prefix
+    has_v_prefix=$([[ $(echo "$tags" | grep -cE '^v' || echo "0") -gt $((total_tags / 2)) ]] && echo "true" || echo "false")
+
+    # Get latest tag
+    local latest_tag
+    latest_tag=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+    jq -n \
+        --arg pattern "$pattern" \
+        --argjson has_v_prefix "$has_v_prefix" \
+        --arg latest "$latest_tag" \
+        --arg total "$total_tags" \
+        --arg semver "$semver_count" \
+        '{
+            pattern: $pattern,
+            uses_v_prefix: $has_v_prefix,
+            latest_tag: $latest,
+            stats: {
+                total_tags: ($total | tonumber),
+                semver_tags: ($semver | tonumber)
+            }
+        }'
+}
+
+# Analyze default branch
+analyze_default_branch() {
+    local default_branch
+    default_branch=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' || echo "")
+
+    if [ -z "$default_branch" ]; then
+        # Try to detect from common names
+        if git show-ref --verify --quiet refs/heads/main 2>/dev/null; then
+            default_branch="main"
+        elif git show-ref --verify --quiet refs/heads/master 2>/dev/null; then
+            default_branch="master"
+        fi
+    fi
+
+    jq -n --arg branch "$default_branch" '{default_branch: $branch}'
+}
+
+# Run all analyses
+COMMIT_CONVENTION=$(analyze_commit_convention)
+BRANCH_NAMING=$(analyze_branch_naming)
+MERGE_STRATEGY=$(analyze_merge_strategy)
+RELEASES=$(analyze_releases)
+DEFAULT_BRANCH=$(analyze_default_branch)
+
+# Build final JSON output
+jq -n \
+    --argjson commits "$COMMIT_CONVENTION" \
+    --argjson branches "$BRANCH_NAMING" \
+    --argjson merge "$MERGE_STRATEGY" \
+    --argjson releases "$RELEASES" \
+    --argjson default "$DEFAULT_BRANCH" \
+    '{
+        commit_convention: $commits,
+        branch_naming: $branches,
+        merge_strategy: $merge,
+        releases: $releases,
+        default_branch: $default.default_branch
+    }'

package/skills/repo-bootstrap/scripts/check-freshness.sh

@@ -0,0 +1,230 @@
+#!/usr/bin/env bash
+# Check if AGENTS.md files are up to date with recent git commits
+# Compares the "Last updated" date in each AGENTS.md with commits affecting that scope
+set -euo pipefail
+
+PROJECT_DIR="${1:-.}"
+cd "$PROJECT_DIR"
+
+# Options
+VERBOSE=false
+DAYS_THRESHOLD=7  # Warn if commits are older than this many days after last update (used below)
+
+# Parse flags
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --verbose|-v)
+            VERBOSE=true
+            shift
+            ;;
+        --threshold=*)
+            # shellcheck disable=SC2034  # Reserved for future threshold-based staleness check
+            DAYS_THRESHOLD="${1#*=}"
+            shift
+            ;;
+        --help|-h)
+            cat <<EOF
+Usage: check-freshness.sh [PROJECT_DIR] [OPTIONS]
+
+Check if AGENTS.md files are up to date with recent git commits.
+
+Options:
+  --verbose, -v         Show detailed output including commit lists
+  --threshold=DAYS      Days after last update to consider stale (default: 7)
+  --help, -h            Show this help message
+
+Examples:
+  check-freshness.sh .                     # Check all AGENTS.md freshness
+  check-freshness.sh . --verbose           # Show commit details
+  check-freshness.sh . --threshold=14      # Use 14-day threshold
+EOF
+            exit 0
+            ;;
+        *)
+            PROJECT_DIR="$1"
+            shift
+            ;;
+    esac
+done
+
+# Ensure we're in a git repository
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+    echo "Error: Not a git repository"
+    exit 1
+fi
+
+STALE_COUNT=0
+FRESH_COUNT=0
+UNKNOWN_COUNT=0
+
+log() {
+    if [ "$VERBOSE" = true ]; then
+        echo "[INFO] $*" >&2
+    fi
+}
+
+# Extract the "Last updated" date from AGENTS.md header
+# Format: <!-- Managed by agent: ... Last updated: YYYY-MM-DD -->
+extract_last_updated() {
+    local file="$1"
+    local date_str
+
+    # Try to extract date from header comment
+    date_str=$(grep -o 'Last updated: [0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}' "$file" 2>/dev/null | head -1 | sed 's/Last updated: //')
+
+    if [ -n "$date_str" ]; then
+        echo "$date_str"
+        return 0
+    fi
+
+    # Try alternative formats
+    # "Created: YYYY-MM-DD" or "Updated: YYYY-MM-DD"
+    date_str=$(grep -oE '(Created|Updated): [0-9]{4}-[0-9]{2}-[0-9]{2}' "$file" 2>/dev/null | head -1 | grep -oE '[0-9]{4}-[0-9]{2}-[0-9]{2}')
+
+    if [ -n "$date_str" ]; then
+        echo "$date_str"
+        return 0
+    fi
+
+    return 1
+}
+
+# Get the scope directory for an AGENTS.md file
+# Root AGENTS.md covers the whole repo, scoped files cover their directory
+get_scope_path() {
+    local agents_file="$1"
+    local dir
+
+    dir=$(dirname "$agents_file")
+
+    if [ "$dir" = "." ]; then
+        echo "."  # Root covers everything
+    else
+        echo "$dir"
+    fi
+}
+
+# Count commits in a scope since a given date
+count_commits_since() {
+    local scope_path="$1"
+    local since_date="$2"
+    local count
+
+    if [ "$scope_path" = "." ]; then
+        # Root: check all commits except AGENTS.md files themselves
+        count=$(git log --oneline --since="$since_date" -- . ':(exclude)**/AGENTS.md' 2>/dev/null | wc -l)
+    else
+        # Scoped: check commits in that directory
+        count=$(git log --oneline --since="$since_date" -- "$scope_path" ':(exclude)**/AGENTS.md' 2>/dev/null | wc -l)
+    fi
+
+    echo "$count"
+}
+
+# Get commit summary for a scope since a given date
+get_commits_since() {
+    local scope_path="$1"
+    local since_date="$2"
+
+    if [ "$scope_path" = "." ]; then
+        git log --oneline --since="$since_date" -- . ':(exclude)**/AGENTS.md' 2>/dev/null | head -10
+    else
+        git log --oneline --since="$since_date" -- "$scope_path" ':(exclude)**/AGENTS.md' 2>/dev/null | head -10
+    fi
+}
+
+# Get files changed in a scope since a given date
+get_changed_files_since() {
+    local scope_path="$1"
+    local since_date="$2"
+
+    if [ "$scope_path" = "." ]; then
+        git log --name-only --pretty=format: --since="$since_date" -- . ':(exclude)**/AGENTS.md' 2>/dev/null | sort -u | grep -v '^$' | head -20
+    else
+        git log --name-only --pretty=format: --since="$since_date" -- "$scope_path" ':(exclude)**/AGENTS.md' 2>/dev/null | sort -u | grep -v '^$' | head -20
+    fi
+}
+
+# Check freshness of a single AGENTS.md file
+check_file_freshness() {
+    local agents_file="$1"
+    local rel_path="${agents_file#"$PROJECT_DIR"/}"
+    local last_updated
+    local scope_path
+    local commit_count
+
+    echo "Checking: $rel_path"
+
+    # Extract last updated date
+    if ! last_updated=$(extract_last_updated "$agents_file"); then
+        echo "  ⚠️  No 'Last updated' date found in header"
+        ((UNKNOWN_COUNT++)) || true
+        return 1
+    fi
+
+    log "  Last updated: $last_updated"
+
+    # Get scope path
+    scope_path=$(get_scope_path "$agents_file")
+    log "  Scope: $scope_path"
+
+    # Count commits since last update
+    commit_count=$(count_commits_since "$scope_path" "$last_updated")
+
+    if [ "$commit_count" -eq 0 ]; then
+        echo "  ✅ Up to date (no commits since $last_updated)"
+        ((FRESH_COUNT++)) || true
+        return 0
+    fi
+
+    # Check if commits are significant
+    echo "  ⚠️  Potentially stale: $commit_count commit(s) since $last_updated"
+    ((STALE_COUNT++)) || true
+
+    if [ "$VERBOSE" = true ]; then
+        echo "  Recent commits:"
+        get_commits_since "$scope_path" "$last_updated" | while read -r line; do
+            echo "    - $line"
+        done
+
+        echo "  Changed files:"
+        get_changed_files_since "$scope_path" "$last_updated" | while read -r line; do
+            echo "    - $line"
+        done
+    fi
+
+    return 1
+}
+
+# Main
+echo "Checking AGENTS.md freshness in: $PROJECT_DIR"
+echo ""
+
+# Find all AGENTS.md files
+AGENTS_FILES=$(find "$PROJECT_DIR" -name "AGENTS.md" -type f 2>/dev/null | sort)
+
+if [ -z "$AGENTS_FILES" ]; then
+    echo "No AGENTS.md files found"
+    exit 0
+fi
+
+# Check each file
+while read -r file; do
+    check_file_freshness "$file"
+    echo ""
+done <<< "$AGENTS_FILES"
+
+# Summary
+echo "=== Freshness Summary ==="
+echo "✅ Up to date: $FRESH_COUNT"
+echo "⚠️  Potentially stale: $STALE_COUNT"
+[ "$UNKNOWN_COUNT" -gt 0 ] && echo "❓ Unknown (no date): $UNKNOWN_COUNT"
+
+if [ "$STALE_COUNT" -gt 0 ]; then
+    echo ""
+    echo "Recommendation: Review the stale AGENTS.md files and update if needed."
+    echo "Use --verbose to see which commits and files have changed."
+    exit 1
+fi
+
+exit 0

package/skills/repo-bootstrap/scripts/detect-golden-samples.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+# Detect golden sample files (canonical patterns to follow)
+set -euo pipefail
+
+PROJECT_DIR="${1:-.}"
+cd "$PROJECT_DIR"
+
+# Check if git is available
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+    echo ""
+    exit 0
+fi
+
+# Get project language
+PROJECT_INFO=$(bash "$(dirname "$0")/detect-project.sh" "$PROJECT_DIR" 2>/dev/null || echo '{"language":"unknown"}')
+LANGUAGE=$(echo "$PROJECT_INFO" | jq -r '.language')
+
+# Find high-churn files (frequently modified = important)
+get_high_churn_files() {
+    git log --name-only --pretty=format: --since="6 months ago" 2>/dev/null | \
+        grep -v '^$' | \
+        sort | uniq -c | sort -rn | head -20
+}
+
+# Find entrypoint files
+find_entrypoints() {
+    case "$LANGUAGE" in
+        "go")
+            find . -name "main.go" -type f 2>/dev/null | head -5
+            ;;
+        "typescript")
+            for f in src/index.ts src/index.tsx src/main.ts src/main.tsx app/page.tsx pages/index.tsx; do
+                [ -f "$f" ] && echo "$f"
+            done
+            ;;
+        "php")
+            for f in public/index.php src/Kernel.php ext_localconf.php; do
+                [ -f "$f" ] && echo "$f"
+            done
+            ;;
+        "python")
+            for f in src/main.py main.py app/main.py __main__.py; do
+                [ -f "$f" ] && echo "$f"
+            done
+            ;;
+    esac
+}
+
+# Find component/model examples
+find_examples() {
+    case "$LANGUAGE" in
+        "go")
+            # Find a service or handler file
+            find . -path ./vendor -prune -o -name "*_service.go" -type f -print 2>/dev/null | head -1
+            find . -path ./vendor -prune -o -name "*_handler.go" -type f -print 2>/dev/null | head -1
+            ;;
+        "typescript")
+            # Find a component
+            find . -path ./node_modules -prune -o -name "*.tsx" -type f -print 2>/dev/null | \
+                grep -E "(Button|Card|Modal|Form)" | head -1
+            # Find an API route
+            find . -path ./node_modules -prune -o -path "*/api/*" -name "*.ts" -type f -print 2>/dev/null | head -1
+            ;;
+        "php")
+            # Find a controller
+            find . -path ./vendor -prune -o -name "*Controller.php" -type f -print 2>/dev/null | head -1
+            # Find a service
+            find . -path ./vendor -prune -o -name "*Service.php" -type f -print 2>/dev/null | head -1
+            ;;
+        "python")
+            # Find a service or model
+            find . -path ./.venv -prune -o -name "*_service.py" -type f -print 2>/dev/null | head -1
+            find . -path ./.venv -prune -o -name "models.py" -type f -print 2>/dev/null | head -1
+            ;;
+    esac
+}
+
+# Find test examples
+find_test_examples() {
+    case "$LANGUAGE" in
+        "go")
+            find . -path ./vendor -prune -o -name "*_test.go" -type f -print 2>/dev/null | head -1
+            ;;
+        "typescript")
+            find . -path ./node_modules -prune -o -name "*.test.ts" -o -name "*.test.tsx" -type f -print 2>/dev/null | head -1
+            ;;
+        "php")
+            find . -path ./vendor -prune -o -name "*Test.php" -type f -print 2>/dev/null | head -1
+            ;;
+        "python")
+            find . -path ./.venv -prune -o -name "test_*.py" -type f -print 2>/dev/null | head -1
+            ;;
+    esac
+}
+
+# Describe file based on name/path
+describe_file() {
+    local file="$1"
+    case "$file" in
+        *main.go|*main.ts|*main.py|*/index.ts*) echo "Entrypoint" ;;
+        *Controller*) echo "Controller" ;;
+        *Service*|*_service*) echo "Service" ;;
+        *Handler*|*_handler*) echo "Handler" ;;
+        *Model*|*models*) echo "Model" ;;
+        *Test*|*_test*) echo "Test" ;;
+        *Button*|*Card*|*Modal*) echo "Component" ;;
+        */api/*) echo "API route" ;;
+        *) echo "Reference" ;;
+    esac
+}
+
+# Describe key patterns in file
+describe_patterns() {
+    local file="$1"
+    local patterns=""
+
+    if [ -f "$file" ]; then
+        # Check for common patterns
+        grep -l "interface" "$file" > /dev/null 2>&1 && patterns="$patterns, interface"
+        grep -l "async" "$file" > /dev/null 2>&1 && patterns="$patterns, async"
+        grep -l "class" "$file" > /dev/null 2>&1 && patterns="$patterns, class"
+        grep -l "test\|describe\|it(" "$file" > /dev/null 2>&1 && patterns="$patterns, tests"
+        grep -l "func.*error" "$file" > /dev/null 2>&1 && patterns="$patterns, error handling"
+    fi
+
+    # Remove leading ", "
+    echo "${patterns#, }"
+}
+
+# Generate output in table row format
+output=""
+
+# Add entrypoints
+while IFS= read -r file; do
+    [ -z "$file" ] && continue
+    file="${file#./}"
+    desc=$(describe_file "$file")
+    patterns=$(describe_patterns "$file")
+    [ -n "$patterns" ] && patterns=" ($patterns)"
+    output="$output| $desc | \`$file\` | ${patterns:-standard patterns} |\n"
+done < <(find_entrypoints)
+
+# Add examples
+while IFS= read -r file; do
+    [ -z "$file" ] && continue
+    file="${file#./}"
+    desc=$(describe_file "$file")
+    patterns=$(describe_patterns "$file")
+    [ -n "$patterns" ] && patterns=" ($patterns)"
+    output="$output| $desc | \`$file\` | ${patterns:-standard patterns} |\n"
+done < <(find_examples)
+
+# Add test example
+while IFS= read -r file; do
+    [ -z "$file" ] && continue
+    file="${file#./}"
+    output="$output| Test | \`$file\` | test structure |\n"
+done < <(find_test_examples)
+
+# Output (remove empty lines, duplicates)
+echo -e "$output" | sed '/^$/d' | sort -u | head -10