feat(assessors): add lint suppression density assessor

.agentready-config.example.yaml

@@ -82,6 +82,12 @@ report_theme: default
 #   border: "#334155"
 #   shadow: "rgba(0, 0, 0, 0.5)"
 
+# Lint suppression density thresholds
+# lint_suppression_density:
+#   pass_per_kloc: 5.0        # density at which score=100 (pass); default 5.0
+#   fail_per_kloc: 15.0       # density at which score=0 (fail); default 15.0
+#   exclude_tests: false      # set true to exclude test files from LOC count
+
 # Example: Increase weight for CLAUDE.md and tests
 # This increases CLAUDE.md from 7% to 15% and test_execution from 10% to 15%
 # Other attributes are automatically rescaled to maintain sum of 1.0

docs/attributes.md

@@ -3,7 +3,7 @@ layout: page
 title: Attributes Reference
 ---
 
-Complete reference for all 27 agent-ready attributes assessed by AgentReady.
+Complete reference for all 30 agent-ready attributes assessed by AgentReady.
 
 <div class="feature" style="background-color: #dbeafe; border-left: 4px solid #2563eb; padding: 1rem; margin: 1rem 0;">
   <h3 style="margin-top: 0;">🤖 Bootstrap Automation</h3>
@@ -26,7 +26,7 @@ Complete reference for all 27 agent-ready attributes assessed by AgentReady.
 
 ## Overview
 
-AgentReady evaluates repositories against 27 attributes derived from research by Anthropic, Microsoft, Google, ETH Zurich, and Red Hat. Each attribute has specific pass/fail criteria, a tier-based weight, and concrete remediation steps.
+AgentReady evaluates repositories against 30 attributes derived from research by Anthropic, Microsoft, Google, ETH Zurich, and Red Hat. Each attribute has specific pass/fail criteria, a tier-based weight, and concrete remediation steps.
 
 Each entry below covers: what the assessor checks, the scoring breakdown, and how to fix a failing result.
 
@@ -39,8 +39,8 @@ Attributes are organized into four weighted tiers:
 | Tier | Weight | Focus | Attribute Count |
 |------|--------|-------|-----------------|
 | **Tier 1: Essential** | 58% | Fundamentals enabling basic AI functionality | 9 attributes |
-| **Tier 2: Critical** | 27% | Major quality improvements and safety nets | 9 attributes |
-| **Tier 3: Important** | 13% | Significant improvements in specific areas | 7 attributes |
+| **Tier 2: Critical** | 27% | Major quality improvements and safety nets | 10 attributes |
+| **Tier 3: Important** | 13% | Significant improvements in specific areas | 9 attributes |
 | **Tier 4: Advanced** | 2% | Refinement and optimization | 2 attributes |
 
 Missing a Tier 1 attribute (up to 12% weight) has up to 12x the score impact of missing a Tier 4 attribute (1% weight).
@@ -1501,6 +1501,51 @@ EOF
 
 ---
 
+### Lint Suppression Density (`lint_suppression_density`, 2%)
+
+Counts suppression directives (`//nolint`, `# noqa`, `# type: ignore`, `# pylint: disable`, `// eslint-disable`, `// @ts-ignore`, `# rubocop:disable`, `<!-- markdownlint-disable -->`) across source files and normalizes the count per 1,000 lines of code. A high density means lint passes not because code is clean, but because violations are silenced — degrading lint as a quality signal for AI agents.
+
+**Supported languages**: Go, Python, JavaScript, TypeScript, Ruby, Java, Terraform, Shell, Dockerfile, YAML (including kube-linter directives), Markdown.
+
+**File scanning**: Only git-tracked regular files are scanned (`.gitignore` is honored; symlinks and non-regular files are skipped). Generated directories (`vendor/`, `node_modules/`, `.venv/`, etc.) are excluded even if tracked. Each file read is capped at 1 MiB. Returns **skipped** if git inventory is unavailable (missing git, non-git checkout, or timeout) — does not fall back to ignore-unaware directory walks.
+
+**Scoring**:
+
+| Condition | Score |
+|-----------|-------|
+| ≤5 suppressions/1k LOC | 100 (pass) |
+| 5–15 suppressions/1k LOC | Linear 100→0 (fail) |
+| >15 suppressions/1k LOC | 0 (fail) |
+
+**Pass threshold**: density ≤5 suppressions per 1,000 source lines.
+
+**Evidence reported**: total suppression count, total LOC scanned, density ratio, and the top files by suppression concentration.
+
+**Configuration** (`.agentready-config.yaml`):
+
+```yaml
+lint_suppression_density:
+  pass_per_kloc: 5.0       # density at which score=100 (pass)
+  fail_per_kloc: 15.0      # density at which score=0 (fail)
+  exclude_tests: false     # set true to exclude test files from LOC count
+```
+
+#### Remediation
+
+Fix the underlying lint violations instead of suppressing them. For unavoidable suppressions, use narrow rule-specific directives with explanatory comments:
+
+```python
+# Python — specific rule + rationale (not blanket noqa)
+result = legacy_func()  # noqa: ERA001  # legacy API, refactor tracked in #123
+
+# Go — rule name + reason
+//nolint:errcheck // legacy path, full error handling in #456
+```
+
+For generated or vendored code, exclude the directory from lint config rather than adding inline suppressions.
+
+---
+
 *Full details for each attribute available in the [research document](https://github.com/ambient-code/agentready/blob/main/RESEARCH_REPORT.md).*
 
 ---
@@ -1520,12 +1565,12 @@ EOF
 
 ## Implementation Status
 
-All 27 assessors are fully implemented across all four tiers.
+All 30 assessors are fully implemented across all four tiers.
 
 **Current State**:
 - ✅ **Tier 1 (Essential)**: Fully implemented (9 attributes)
-- ✅ **Tier 2 (Critical)**: Fully implemented (9 attributes)
-- ✅ **Tier 3 (Important)**: Fully implemented (7 attributes)
+- ✅ **Tier 2 (Critical)**: Fully implemented (10 attributes)
+- ✅ **Tier 3 (Important)**: Fully implemented (9 attributes)
 - ✅ **Tier 4 (Advanced)**: Fully implemented (2 attributes)
 
 See the [GitHub repository](https://github.com/ambient-code/agentready) for current implementation details.

src/agentready/assessors/__init__.py

@@ -11,6 +11,7 @@
 from .code_quality import (
     CyclomaticComplexityAssessor,
     LintConfigCoverageAssessor,
+    LintSuppressionAssessor,
     StructuredLoggingAssessor,
     TypeAnnotationsAssessor,
 )
@@ -59,6 +60,7 @@
 __all__ = [
     "create_all_assessors",
     "BaseAssessor",
+    "LintSuppressionAssessor",
     "LockFilesAssessor",
     "AdrFrontmatterAssessor",
 ]
@@ -99,15 +101,16 @@ def create_all_assessors() -> list[BaseAssessor]:
         LintConfigCoverageAssessor(),  # 2% (issue #511)
         DbtDataTestsAssessor(),  # dbt conditional
         DbtProjectStructureAssessor(),  # dbt conditional
-        # Tier 3 Important — 13% total (8 attributes)
+        # Tier 3 Important — 13% total (9 attributes)
         ArchitectureDecisionsAssessor(),  # 1%
         AdrFrontmatterAssessor(),  # 2% (2.4 - ADR Frontmatter Completeness)
         OpenAPISpecsAssessor(),  # 2%
-        CyclomaticComplexityAssessor(),  # 2%
+        CyclomaticComplexityAssessor(),  # 1%
         StructuredLoggingAssessor(),  # 1%
         ProgressiveDisclosureAssessor(),  # 1% (moved from T4)
-        ArchitecturalBoundaryAssessor(),  # 2% (ADR B.1)
+        ArchitecturalBoundaryAssessor(),  # 1% (ADR B.1)
         ThreatModelAssessor(),  # 2% (ADR B.2)
+        LintSuppressionAssessor(),  # 2%
         # Tier 4 Advanced — 2% total (2 attributes, 1% each)
         IssuePRTemplatesAssessor(),
         ContainerSetupAssessor(),