[gkennos]

Summary

Adds optional configuration linting for plugins, plus groundworkers lint-plugins command

• New optional GroundworkersPluginLinter protocol: a plugin can implement lint_config(config) -> PluginLintReport to check its settings beyond the schema (for example, files the config points to, or rules that span several fields).
• New shared report types in groundworkers.plugins: PluginLintReport, PluginLintDiagnostic and PluginLintSeverity.
• lint_plugin_config(plugin, config) lets other tools call a plugin's linter without the command. It returns None when a plugin has no hook.
• groundworkers lint-plugins --config-path <file> prints a JSON report and exits 1 if any plugin reports an error. Plugins without the hook are listed under skipped.

Existing plugins need no changes - the hook is opt-in

Checklist

• Applied exactly one label (breaking, feature, fix, dependencies, or chore)
• Tests pass locally (uv run pytest -q)
• Lint passes (uv run ruff check .)

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.