# Pre-commit guardrails — deterministic checks that run before every commit. # Cheap things live here (seconds); slow things (typecheck, build, tests, # Snyk, AI review) stay in CI (.gitea/workflows/pr-checker.yml). # # One-time setup per machine: # pre-commit install # pre-commit stage # pre-commit install --hook-type commit-msg # commit-msg stage (release-please!) # pre-commit run --all-files # first full pass # # ARM64 + x86_64 both supported by every hook below. repos: # ---------------------------------------------------------------- gitleaks # Block secrets before they enter history. CI scans history too (gitleaks # job), but this prevents the commit from ever existing. - repo: https://github.com/gitleaks/gitleaks rev: v8.30.1 hooks: - id: gitleaks # -------------------------------------------------- basic file hygiene --- - repo: https://github.com/pre-commit/pre-commit-hooks rev: v6.0.0 hooks: - id: trailing-whitespace - id: end-of-file-fixer - id: mixed-line-ending args: [--fix=lf] - id: check-yaml - id: check-json - id: check-toml - id: check-merge-conflict - id: check-added-large-files args: [--maxkb=1024] # Self-hosted variable fonts are multi-MB by design (page-weight is # a serving-layer concern, not a repo concern). exclude: \.woff2$ - id: detect-private-key # ------------------------------------------------ conventional commits --- # release-please silently ignores non-conventional messages, so a bad # subject line means "no release and no idea why". This makes it # impossible. Runs on the commit-msg stage, not pre-commit. - repo: https://github.com/commitizen-tools/commitizen rev: v4.19.2 hooks: - id: commitizen stages: [commit-msg] # ---------------------------------------------------- workflow linting --- # Validates .gitea/workflows syntax and ${{ }} expressions - the class of # bug that hashFiles-skipping and broken YAML came from. - repo: https://github.com/rhysd/actionlint rev: v1.7.12 hooks: - id: actionlint files: \.gitea/workflows/.*\.ya?ml$ # actionlint only auto-loads its config when the file is # .github/actionlint.yaml *and* it recognises a project root by # .github/workflows, which this repo does not have (it uses # .gitea/workflows). Pass the config explicitly, or the custom # `publish` runner label is reported as unknown. args: [-config-file, .github/actionlint.yaml] # --------------------------------------------------------- ESLint (Nuxt) - # Local hook: needs `pnpm install` to have run in this repo. --fix makes # it a helper; only staged files are linted (fast). When --fix rewrites # a staged file, pre-commit aborts the commit ("files were modified") - # re-stage and commit again; that re-stage loop is the standard price # of a fixer hook. - repo: local hooks: - id: eslint name: eslint --fix (staged files) # no shell wrapper: pre-commit appends the staged filenames to the # entry itself. A 'bash -c' wrapper would eat the first filename # as $0 and eslint would get no file arguments at all (linting the # whole repo instead - review finding on this PR, empirically # verified). entry: pnpm exec eslint --fix language: system files: \.(vue|ts|js|mjs|cjs)$ # When Go services arrive, add: # - repo: https://github.com/dnephin/pre-commit-golang # rev: # hooks: # - id: go-fmt # - id: go-imports # - id: golangci-lint # or go-vet for a lighter pass