name: Lint

on:
  push:
    tags:
      - 'v*'
  workflow_dispatch:

jobs:
  lint:
    runs-on: ubuntu-latest
    env:
      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true

    steps:
      - uses: actions/checkout@v4

      - name: Install dependencies
        run: |
          sudo apt-get update && sudo apt-get install -y --no-install-recommends \
            git emacs-nox

      - name: Check for forbidden patterns
        run: |
          ! grep -r "json\." --include="*.lisp" . && \
            echo "OK: No JSON in Lisp files"

      - name: Check skills have lisp source blocks
        run: |
          FAIL=0
          for f in skills/*.org; do
            if ! grep -q "#+begin_src lisp" "$f"; then
              echo "WARNING: $f has no lisp blocks"
              FAIL=1
            fi
          done
          find . -name "*.org" -path "*/skills/*" -exec grep -L "#+begin_src lisp" {} \; | \
            grep -v "CLA\|CONTRIBUTING\|CHANGELOG\|README\|USER_MANUAL" || true
          echo "OK: All skills have lisp blocks"

      - name: Verify each .lisp has a corresponding .org source
        run: |
          FAIL=0
          for f in harness/*.lisp tests/*.lisp; do
            [ -f "$f" ] || continue
            org="${f%.lisp}.org"
            [ -f "$org" ] && continue
            base=$(basename "$f" .lisp)
            # Check if generated from a parent org via :tangle
            parent="${base%-tests}.org"
            parent="${parent%-validator}.org"
            parent="${parent%-client}.org"
            if [ -f "harness/$parent" ] || [ -f "skills/$parent" ]; then
              : # generated from parent org via :tangle
            elif grep -q ":tangle.*$(basename "$f")" harness/*.org skills/*.org 2>/dev/null; then
              : # :tangle reference found in another org
            else
              echo "WARNING: $f has no corresponding .org source"
              FAIL=1
            fi
          done
          for f in skills/*.lisp; do
            [ -f "$f" ] || continue
            org="${f%.lisp}.org"
            if [ ! -f "$org" ]; then
              echo "ERROR: $f has no .org source"
              FAIL=1
            fi
          done
          [ "$FAIL" = 0 ] && echo "OK: All .lisp files have .org sources"

      - name: Check literate granularity (one function per block)
        run: |
          for f in skills/*.org; do
            blocks=$(grep -c "^[[:space:]]*(defun " "$f" 2>/dev/null || true)
            srcblocks=$(grep -c "#+begin_src lisp" "$f" 2>/dev/null || true)
            if [ "$blocks" -gt "$srcblocks" ] && [ "$srcblocks" -gt 0 ]; then
              echo "WARNING: $f has $blocks defuns but only $srcblocks src blocks"
            fi
          done
          echo "OK: Granularity check complete"

      - name: Check README has quick install
        run: |
          grep -q "curl.*opencortex" README.org && \
            echo "OK: Quick install in README" || \
            echo "WARNING: Quick install curl command not found in README"