lint-and-fix

name: lint-and-fix description: Run linters and fix violations, formatting errors, or style mismatches using Trunk. Use when code quality checks fail, before submitting PRs, or to repair "broken" linting states.

Lint and Fix Loop: Trunk

Purpose

An autonomous loop for the agent to identify, fix, and verify linting and formatting violations using Trunk.

Loop Logic

1. Format: Run pnpm format (which executes trunk fmt) to automatically fix trivial formatting issues.
2. Identify: Run pnpm lint (which executes trunk check) to list any remaining violations.
3. Analyze: Examine the output from Trunk, focusing on the file path, line number, and error message. Refer to ../common-references/troubleshooting.md for environment or runtime issues.
4. Fix: Apply the minimum necessary change to the source code to resolve the reported linting violations.
5. Verify: Re-run the loop (starting from Format) until all issues are resolved.
   • If pnpm lint passes: Finish.
   • If it fails: Analyze the new failure and repeat the loop.

Termination Criteria

• No more errors reported by pnpm lint.
• Reached max iteration limit (default: 5).

Examples

Scenario: Fixing violations in a modified file

1. Agent runs pnpm format to ensure consistent style.
2. Agent runs pnpm lint and finds a linting violation in src/index.ts.
3. Agent analyzes the error and applies a manual fix.
4. Agent runs pnpm format again (part of the loop).
5. Agent runs pnpm lint and it now passes.

Resources

• Trunk CLI Reference: Common commands for linting and formatting.
• Trunk Documentation: Official documentation for the Trunk CLI.