lint-docs.sh

#!/bin/bash
#
# Convenience wrapper for documentation linters
# Can run from any directory!
#
# Usage:
#   ./lint-docs.sh seo file1.txt file2.rst ...
#   ./lint-docs.sh 404 file1.txt file2.rst ...
#   ./lint-docs.sh redirects netlify.toml ...
#   ./lint-docs.sh all file1.txt file2.rst ...
#

# Find repo root - try git first, then fall back to script location
REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
if [ -z "$REPO_ROOT" ]; then
  # Not in a git repo - use script's own location
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
  if [ -d "$SCRIPT_DIR/.github/lint-docs" ]; then
    REPO_ROOT="$SCRIPT_DIR"
  else
    echo "❌ Cannot find repo root. Run from within the repo or use absolute path to this script."
    exit 1
  fi
fi

LINT_DIR="$REPO_ROOT/.github/lint-docs"

# Check if node is available
if ! command -v node &> /dev/null; then
  echo "❌ Node.js is required but not installed"
  exit 1
fi

# Parse command
CMD="${1:-help}"
shift

case "$CMD" in
  seo)
    npx tsx "$LINT_DIR/seo-lint-cli.ts" "$@"
    ;;
  404|links)
    npx tsx "$LINT_DIR/404-lint-cli.ts" "$@"
    ;;
  redirects|redirect)
    npx tsx "$LINT_DIR/redirect-lint-cli.ts" "$@"
    ;;
  all|both)
    echo "=== SEO Linter ==="
    npx tsx "$LINT_DIR/seo-lint-cli.ts" "$@"
    echo ""
    echo "=== 404 Linter ==="
    npx tsx "$LINT_DIR/404-lint-cli.ts" "$@"
    ;;
  help|--help|-h)
    echo "Documentation Linters"
    echo ""
    echo "Usage: ./lint-docs.sh <command> <files...>"
    echo ""
    echo "Commands:"
    echo "  seo        Run SEO linter (titles, descriptions, headings)"
    echo "  404        Run broken link checker"
    echo "  redirects  Run circular redirect checker"
    echo "  all        Run SEO + 404 linters"
    echo ""
    echo "Examples:"
    echo "  ./lint-docs.sh seo content/manual/source/intro.txt"
    echo "  ./lint-docs.sh 404 content/atlas/source/*.txt"
    echo "  ./lint-docs.sh redirects content/atlas/netlify.toml"
    echo "  ./lint-docs.sh all my-file.rst another-file.md"
    ;;
  *)
    echo "Unknown command: $CMD"
    echo "Run './lint-docs.sh help' for usage"
    exit 1
    ;;
esac