noteflow/.serena/memories/basedpyright_validation_rules.md

Basedpyright Validation Rules

Zero Tolerance Policy

ALL basedpyright errors must be fixed. No exceptions. No rationalizations.

Forbidden Behaviors

1. Never dismiss errors as "just warnings" - If basedpyright says ERROR, it's an error
2. Never rationalize errors as "intentional" - Fix them properly instead
3. Never proceed with validation when errors exist - 0 errors required

Required Validation Steps

After any code changes, run:

source .venv/bin/activate && basedpyright src/noteflow/

Expected output: 0 errors, 0 warnings, 0 notes

Hygiene Round Checklist

1. Run basedpyright on modified files
2. Run basedpyright on FULL codebase
3. Confirm exactly: 0 errors, 0 warnings, 0 notes
4. Run quality suite (pytest tests/quality/)
5. Run backend tests
6. Only then report success

Lesson Learned

On 2026-01-06, I dismissed 93 basedpyright errors as acceptable. This violated CLAUDE.md. Errors are errors. Fix them.