Files
kandev/docs/specs/platform/requirements/go-pre-commit-lint.md
T
João Salavisa 6e3fc6cc2a perf(hooks): lint only changed Go packages (#3860)
Co-authored-by: Kandev Agent <agent@kandev.dev>
2026-09-22 09:50:15 +01:00

61 lines
2.6 KiB
Markdown

---
status: active
system: platform
created: 2026-09-22
owners:
- kandev
---
# Go pre-commit lint requirements
## Overview
Contributors need Go commit checks whose analysis targets follow the staged
change. Platform owns development validation performance and shared operational
guarantees; the CI system retains ownership of hosted workflow trust policy.
## Terminology
- **Selected files:** Existing Go source or test files supplied to the commit
check. Ordinary commits select staged files; explicit manual runs can select
other files.
- **Selected package:** The complete Go package containing a selected file.
Loading dependencies for type information does not select them as lint targets.
## Requirements
### REQ-PLATFORM-GO-PRE-COMMIT-LINT-001: Bound local Go lint analysis
**Intent:** Avoid analyzing unrelated backend packages on every commit while
retaining package context and changed-code enforcement.
#### Acceptance criteria
- **AC-PLATFORM-GO-PRE-COMMIT-LINT-001.1:** Selected source and test files shall
select their complete containing packages. Unrelated packages and unchanged
descendants shall not become lint targets solely because another package changed.
- **AC-PLATFORM-GO-PRE-COMMIT-LINT-001.2:** Each package shall appear once in each
supplied batch. Batches shall run serially to avoid competing linter processes.
- **AC-PLATFORM-GO-PRE-COMMIT-LINT-001.3:** A selection without eligible Go files
shall finish without invoking the linter or falling back to a full scan.
- **AC-PLATFORM-GO-PRE-COMMIT-LINT-001.4:** The check shall preserve the existing
pull-request comparison-base and changed-code reporting policy. Base-resolution
errors and linter failures shall prevent the commit.
- **AC-PLATFORM-GO-PRE-COMMIT-LINT-001.5:** Inherited repository-location, index,
and object-storage overrides shall not redirect the check to another repository.
- **AC-PLATFORM-GO-PRE-COMMIT-LINT-001.6:** Ordinary commits shall retain
pre-commit's staged-file selection and restoration of unstaged edits.
- **AC-PLATFORM-GO-PRE-COMMIT-LINT-001.7:** CI and the explicit full-backend lint
command shall retain backend-wide analysis, including impacts on other packages.
## Out of scope
- Changed-line-only compilation, reverse-dependency selection, or lint caching.
- Changing other commit hooks, lint rules, comparison-base precedence, or CI scope.
- Adding checks for deleted-only files or module/configuration-only changes.
- Application behavior and user interfaces.
## Implementation plans
- [Go pre-commit lint](../../../plans/go-pre-commit-lint/plan.md)