kandev/docs/plans/pr-documentation-coverage/task-04-exempt-plugin-registry-source.md

id, title, status, wave, depends_on, plan, requirements, acceptance_criteria, system_design

id	title	status	wave	depends_on	plan	requirements	acceptance_criteria	system_design
04-exempt-plugin-registry-source	Exempt the canonical plugin registry source	done	4	03-queue-coverage	plan.md	REQ-CI-PR-DOCS-001	AC-CI-PR-DOCS-001.7	../../specs/ci/system-design/pull-request-documentation-coverage.md

Task 04: Exempt the canonical plugin registry source

Summary

Allow a pull request that updates only the curated plugin-registry/plugins.yaml source to pass documentation coverage without a linked delivery package. Keep all other registry paths and mixed registry-plus-runtime changes covered.

In scope

• Add the exact plugin-registry/plugins.yaml path to the classifier exemption list.
• Add regression coverage for the registry-only and mixed-path cases.
• Reconcile the CI requirement, system design, decision, and plan records.

Out of scope

• Exempting the full plugin-registry/ directory.
• Changing the registry index workflow, registry schema, package validation, labels, or rulesets.
• Updating public product documentation.

Acceptance

• A registry-only change is classified as exempt and does not require delivery artifacts.
• A registry change combined with any non-exempt path still requires coverage.
• Existing path exemptions and generic YAML classification remain unchanged.

Verification

Run from the repository root:

node --test .github/scripts/pr-docs.test.cjs
python3 .github/scripts/pr-docs-workflow-contract_test.py
python3 .github/scripts/lint-action-pinning_test.py
python3 .github/scripts/lint-action-pinning.py
zizmor .github/workflows/pr-docs.yml
python3 scripts/list-docs.py validate
python3 scripts/lint-spec-files.py --all
git diff --check

Files likely touched

• .github/scripts/pr-docs.cjs
• .github/scripts/pr-docs.test.cjs
• docs/specs/ci/requirements/pull-request-documentation-coverage.md
• docs/specs/ci/system-design/pull-request-documentation-coverage.md
• docs/decisions/2026-09-10-pr-documentation-coverage.md
• docs/plans/pr-documentation-coverage/plan.md

Dependencies

Task 03. The existing coverage validator and workflow must remain the implementation boundary.

Risks

• A prefix or glob exemption could accidentally cover registry schema, generator, or generated-catalog changes. Use exact-path matching and a negative mixed-path test.

Parallelism

sequential

Inputs

• Requirements
• System design
• Plan
• Decision
• .github/AGENTS.md and the existing validator tests.

Results

Implemented the exact plugin-registry/plugins.yaml exemption in the path classifier and added positive and mixed-path regression coverage. Other registry files still trigger coverage, and mixed changes retain their non-exempt paths.

Verification:

• node --test .github/scripts/pr-docs.test.cjs: 77 tests passed.
• python3 .github/scripts/pr-docs-workflow-contract_test.py: 7 tests passed.
• python3 .github/scripts/lint-action-pinning_test.py: 9 tests passed.
• python3 .github/scripts/lint-action-pinning.py: 24 workflows passed.
• zizmor .github/workflows/pr-docs.yml: no findings.
• python3 scripts/list-docs.py validate: 279 decisions and 959 specifications validated.
• python3 scripts/lint-spec-files.py --all: passed.
• git diff --check: passed.