blindspot

Knowledge resilience report

Repository: /private/tmp/cohort10/pydantic-ai
Generated 2026-05-20 13:18 UTC · window: last 90 days · blindspot v0.2.0

Executive brief

Moderate Resilience 67/100 · D · team profile

Top 3 risks
  1. HIGH Diversify ownership of 'pydantic_graph' (currently single-owner) pydantic_graph
  2. MEDIUM Diversify ownership of 'agent_docs' (currently single-owner) agent_docs
  3. MEDIUM Knowledge transfer for pydantic_ai_slim/pydantic_ai/agent/__init__.py pydantic_ai_slim/pydantic_ai/agent/__init__.py

Patterns detected Fragile Velocity

Business implication An unexpected departure of the top contributor would orphan 604 critical files and likely slow feature delivery by 3–5 weeks while the team learns the surface.

Executive summary

Pair David Montague (dmontagu@github) on 'pydantic_graph' — bus factor 1 across 35 files

Resilience is **Moderate** (67/100). Weakest dimension: ownership concentration (D).

Risk inventory: 2 service(s) rest on a single contributor; 604 file(s) would become orphans if the top contributor leaves; 21 file(s) carry high correction load (≥35% fix/revert); 10 service(s) lack AI-readable operational context.

Top recommended action: Pair David Montague (dmontagu@github) on 'pydantic_graph' — bus factor 1 across 35 files

💡 Want a richer, prose-style executive summary? Add a cloud LLM key (Anthropic or OpenAI) to your scan:
--api-key sk-ant-... --provider anthropic --model claude-sonnet-4-6
or set narrative.api_key in .blindspot.yaml. Without a key, this rule-based narrator is used — deterministic, in-process, no network.

Overview

Engineering Resilience Score

Overall
67/100 D
Moderate

Moderate resilience overall (score 67). Weakest dimension: AI operational readiness at 4.

Team-based Multiple maintainers without a single dominant contributor.

Key signals — the six questions

Six concrete questions, each with a one-number answer. This is the report. Everything below is supporting detail; run with --detailed for the deep-dive sections.

Ownership concentration D
3 services rest on a single owner
If that person is unavailable, no one else can confidently change these areas.
Single-engineer dependency
604 files orphan if the top contributor leaves
These files would have no confident owner the day that person walks out.
Knowledge decay
No file is critically decayed
Owners are still close to the code they own.
Review depth
Reviews carry substantive comments
Approvals reflect real scrutiny, not rubber-stamping.
Correction load B
21 files carry a heavy bugfix tail
After each feature these files get a stream of fix/revert commits — stability is paying for delivery pace.
AI-readable context F
Repo lacks AI-readable operational context (1/5)
No specs, architecture notes / ADRs, prompts at the repo root — a new human or AI agent must reverse-engineer the codebase.

Recommended actions

Concrete next steps derived from the signals in this report. Each action is tied to a specific finding — treat them as conversation starters with the team, not directives.

Priority Confidence Category Title Target Evidence
High High Ownership Diversification Single-owner concentration Diversify ownership of 'pydantic_graph' (currently single-owner)
Service 'pydantic_graph' has bus factor 1 across 35 files; David Montague (dmontagu@github) holds 95% of effective ownership. Pair them with at least two additional engineers and rotate code reviews for this area over the next 60 days. Start with these 2 files: pydantic_graph/pydantic_graph/basenode.py, pydantic_graph/pydantic_graph/__init__.py. Cadence: aim to cover the top files this quarter.
▸ Bus factor 1 over 35 files — David Montague (dmontagu@github) holds 95% of effective ownership.
pydantic_graph bus_factor=1, top_owner_coverage=95%, files=35, top_files=pydantic_graph/pydantic_graph/basenode.py+1
Medium High Knowledge Transfer Knowledge transfer for pydantic_ai_slim/pydantic_ai/agent/__init__.py
Decay is elevated (58%). Aditya Vardhan (adtyavrdhn@github) last touched this file 7 days ago, and 484 lines have been changed since by others. Schedule a transfer session and designate a secondary owner before the next non-trivial change.
▸ Decay 58% — owner last touched 7 days ago, 484 lines changed by others since.
pydantic_ai_slim/pydantic_ai/agent/__init__.py decay=58%, days_since_touch=7, lines_after=484
Medium High Knowledge Transfer Knowledge transfer for pydantic_ai_slim/pydantic_ai/models/instrumented.py
Decay is elevated (54%). Douwe Maan (douwe@pydantic.dev) last touched this file 7 days ago, and 344 lines have been changed since by others. Schedule a transfer session and designate a secondary owner before the next non-trivial change.
▸ Decay 54% — owner last touched 7 days ago, 344 lines changed by others since.
pydantic_ai_slim/pydantic_ai/models/instrumented.py decay=54%, days_since_touch=7, lines_after=344
Medium High Ownership Diversification Single-owner concentration Diversify ownership of 'agent_docs' (currently single-owner)
Service 'agent_docs' has bus factor 1 across 4 files; Douwe Maan (douwe@pydantic.dev) holds 88% of effective ownership. Pair them with at least two additional engineers and rotate code reviews for this area over the next 60 days.
▸ Bus factor 1 over 4 files — Douwe Maan (douwe@pydantic.dev) holds 88% of effective ownership.
agent_docs bus_factor=1, top_owner_coverage=88%, files=4