🎨 Palette: Improve README accessibility for screen readers - #136

#!/bin/bash
set -euo pipefail

echo "== repo files (top-level/config candidates) =="
git ls-files | sed -n '1,120p'

echo
echo "== README first 20 lines =="
sed -n '1,20p' README.md || true

echo
echo "== markdownlint config files =="
for f in .markdownlint.json .markdownlint.yaml .markdownlint.yml markdownlint.config.json markdownlint.config.yaml markdownlint.config.yml; do
  if [ -f "$f" ]; then
    echo "--- $f ---"
    cat -n "$f"
  fi
done

echo
echo "== package/config references to markdownlint =="
rg -n "markdownlint|MD041|first-line-heading|no-multiple-blanks|lines" package.json README.md .github .markdownlint* 2>/dev/null || true

echo
echo "== workflow files mentioning Markdown lint =="
for f in $(git ls-files .github/workflows); do
  echo "--- $f ---"
  rg -n "markdownlint|markdownlint-cli2|MD041" "$f" || true
done

#!/bin/bash
set -euo pipefail

set +e
echo "== README exactly first line =="
python3 - <<'PY'
from pathlib import Path
p=Path('README.md')
if p.exists():
    txt=p.read_text()
    lines=txt.splitlines()
    print("line_count", len(lines))
    print("first_line", repr(lines[0] if lines else ""))
    print("starts_heading", lines[0].startswith("#") if lines else False)
    print("first_image", "<img" in lines[0].lower() if lines else False)
PY

echo
echo "== deterministic MD041 rule check from markdownlint-docs local if present =="
# Read-only check: detect whether README starts with a heading and whether any file has first-heading exception.
python3 - <<'PY'
from pathlib import Path
import re, json, yaml
start = Path('README.md').read_text().splitlines()[0] if Path('README.md').exists() else ''
config_found=[]
has_exception=False
for f in Path('.').glob('**/.markdownlint*'):
    if f.is_file():
        text=f.read_text(errors='ignore')
        if 'MD041' in text or 'first-line-heading' in text or 'first-line-h1' in text:
            config_found.append(str(f))
            if re.search(r'(MD041|first-line-heading|first-line-h1).*false|false.*MD041|false.*first-line-heading|false.*first-line-h1', text, re.I|re.S):
                has_exception=True
root = Path('.')
for f in root.glob('.markdownlint*json') or []:
    if f.exists():
        try:
            data=json.loads(f.read_text(errors='ignore'))
            if 'MD041' in data and data['MD041'] is False:
                has_exception=True
            if 'MD041' in data.get('default', {}) and data['default']['MD041'] is False:
                has_exception=True
        except Exception as e:
            print("json_parse_error", f, e)
print({
  "readme_starts_with_heading": start.startswith("#"),
  "readme_first_line": start[:100],
  "markdownlint_config_files": config_found,
  "apparent_MD041_disabled_exception": has_exception,
})
PY