mypy.ini

[mypy]
# Global settings.
# NOTE: this file is mypy's authoritative config (pyproject [tool.mypy] is
# ignored when mypy.ini exists). Edit strictness HERE, not in pyproject.
python_version = 3.12
warn_unused_configs = True
show_error_codes = True
show_column_numbers = True
pretty = True

# Relaxed settings for practical development
# These can be tightened incrementally as code improves
strict_optional = False
no_implicit_optional = False
check_untyped_defs = False
disallow_incomplete_defs = False
disallow_untyped_defs = False
warn_return_any = False
warn_redundant_casts = False
warn_unused_ignores = False

# Ignore missing imports for third-party libraries
[mypy-google.*]
ignore_missing_imports = True

[mypy-playwright.*]
ignore_missing_imports = True

[mypy-docx.*]
ignore_missing_imports = True

[mypy-colorama.*]
ignore_missing_imports = True

[mypy-httpx.*]
ignore_missing_imports = True

[mypy-bs4.*]
ignore_missing_imports = True

[mypy-dotenv.*]
ignore_missing_imports = True

[mypy-pytest.*]
ignore_missing_imports = True

[mypy-docx2pdf.*]
ignore_missing_imports = True


# Per-module overrides for files with many third-party type issues
# These files have complex interactions with external libraries
[mypy-primr.data.scraping.browsers]
ignore_errors = True

[mypy-primr.output.markdown_parser]
ignore_errors = True

[mypy-primr.output.style_engine]
ignore_errors = True

[mypy-primr.output.table_builder]
ignore_errors = True

[mypy-primr.utils.console]
ignore_errors = True

# AI modules with complex Gemini SDK interactions
[mypy-primr.ai.deep_research]
ignore_errors = True

[mypy-primr.ai.competitive]
ignore_errors = True

# Data scraping modules with complex BeautifulSoup/Playwright interactions
[mypy-primr.data.scraping.content]
ignore_errors = True

[mypy-primr.data.scraping.structured_content]
ignore_errors = True

# MCP server modules (experimental API)
[mypy-primr.mcp_server.versioning]
ignore_errors = True


# Output modules with python-docx type issues
[mypy-primr.output.polish_elements]
ignore_errors = True

[mypy-primr.output.markdown_converter]
ignore_errors = True

[mypy-primr.output.document_builder]
ignore_errors = True

[mypy-primr.output.content_pattern_detector]
ignore_errors = True

# Prompts modules with Jinja2 type issues
[mypy-primr.prompts.shared_loader]
ignore_errors = True

[mypy-primr.prompts.registry]
ignore_errors = True

[mypy-primr.prompts.composer]
ignore_errors = True

# QA modules with complex dict patterns
[mypy-primr.qa.report_analyzer]
ignore_errors = True

[mypy-primr.qa.issue_classifier]
ignore_errors = True

[mypy-primr.qa.config]
ignore_errors = True

# Utils with complex type guard patterns
[mypy-primr.utils.type_guards]
ignore_errors = True

[mypy-primr.utils.security]
ignore_errors = True

# Agentic subagents (experimental)
[mypy-primr.agentic.subagents.writer]
ignore_errors = True


# Data scraping modules
[mypy-primr.data.scraping.discovery]
ignore_errors = True

[mypy-primr.data.scraping.http_clients]
ignore_errors = True

[mypy-primr.data.scraping.vertical_slice]
ignore_errors = True

[mypy-primr.data.scraping.tier_registry]
ignore_errors = True

[mypy-primr.data.scraping.orchestrator]
ignore_errors = True

# MCP server modules
[mypy-primr.mcp_server.security]
ignore_errors = True

[mypy-primr.mcp_server.auth]
ignore_errors = True

[mypy-primr.mcp_server.spike]
ignore_errors = True

[mypy-primr.mcp_server.pipeline_runner]
ignore_errors = True

[mypy-primr.mcp_server.agentic_tools]
ignore_errors = True

[mypy-primr.mcp_server.agentic_resources]
ignore_errors = True

[mypy-primr.mcp_server.resources]
ignore_errors = True

[mypy-primr.mcp_server.server]
ignore_errors = True

[mypy-primr.mcp_server.cli]
ignore_errors = True

# Core modules with complex patterns
[mypy-primr.core.ai_strategy]
ignore_errors = True

[mypy-primr.core.deep_research_runner]
ignore_errors = True

[mypy-primr.core.research_agent]
ignore_errors = True

# AI modules
[mypy-primr.ai.preflight]
ignore_errors = True

# QA modules
[mypy-primr.qa.analyzer]
ignore_errors = True

[mypy-primr.qa.report_loader]
ignore_errors = True

# Utils
[mypy-primr.utils.errors]
ignore_errors = True

[mypy-primr.utils.telemetry]
ignore_errors = True

# Prompts
[mypy-primr.prompts.loader]
ignore_errors = True

[mypy-primr.prompts.migration]
ignore_errors = True


# =============================================================================
# STRICT ALLOWLIST — incremental type-strictness ratchet (grow, never regress)
# =============================================================================
# These modules require fully-annotated defs. Add a module here only once it is
# verified clean (`mypy <mod> --disallow-untyped-defs --disallow-incomplete-defs`).
# This is the real, in-effect strict ratchet (the global above stays relaxed).
[mypy-primr.skill_pack.schema]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.config]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.curation]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.planner]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.saved_plan]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.industry]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.code_comment_projection]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.command_grammar]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.execution_dataflow]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.eval_validation]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.markdown_safety]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.script_safety]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.skill_pack.verifier_asset]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.utils.content_sanitizer]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.utils.sensitive_instruction_safety]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.utils.logging_config]
disallow_untyped_defs = True
disallow_incomplete_defs = True

[mypy-primr.data.hiring_signals]
disallow_untyped_defs = True
disallow_incomplete_defs = True