Add main-based PR evaluation harness #38

	name: docs-context

	on:
	pull_request:
	types: [opened, synchronize, reopened, ready_for_review]
	workflow_dispatch:

	jobs:
	docs-quality:
	runs-on: ubuntu-latest
	steps:
	- name: Checkout
	uses: actions/checkout@v4
	with:
	fetch-depth: 0

	- name: Setup Python
	uses: actions/setup-python@v5
	with:
	python-version: "3.11"

	- name: Lint docs structure and links
	run: python3 scripts/docs_lint.py

	- name: Generate artifacts
	run: python3 scripts/generate_context_artifacts.py

	- name: Verify generated files are committed
	run: git diff --exit-code docs/generated/

	- name: Guard code changes require docs updates
	if: github.event_name == 'pull_request'
	run: \|
	python3 scripts/docs_changed_guard.py \
	--base "${{ github.event.pull_request.base.sha }}" \
	--head "${{ github.sha }}"

	- name: Build stale docs report (advisory)
	run: python3 scripts/docs_garden.py --output docs/generated/stale-docs-report.md

	- name: Upload docs reports
	uses: actions/upload-artifact@v4
	with:
	name: docs-quality-report
	path: docs/generated/

Navigation Menu