Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
perf(server): load repowise.server.schemas submodules on first access (#2507)
Raghav Chamadiya7b17c47c8f07
diff --git a/packages/server/src/repowise/server/schemas/__init__.py b/packages/server/src/repowise/server/schemas/__init__.pyindex ffd0f4e69..5608c9f05 100644--- a/packages/server/src/repowise/server/schemas/__init__.py+++ b/packages/server/src/repowise/server/schemas/__init__.py@@ -7,297 +7,580 @@ public model is re-exported here so existingfrom __future__ import annotations-from .architecture import (- ArchEdgeResponse,- ArchitectureViewResponse,- ArchLayerResponse,- ArchNodeResponse,- ArchSubGroupResponse,- ArchTourStepResponse,-)-from .blast_radius import (- BlastRadiusRequest,- BlastRadiusResponse,- CochangeWarning,- DirectRiskEntry,- ReviewerEntry,- TransitiveEntry,-)-from .c4 import (- C4ComponentResponse,- C4ContainerResponse,- C4ExternalSystemResponse,- C4L1Response,- C4L2Response,- C4L3Response,- C4PersonResponse,- C4RelationResponse,- C4SystemResponse,-)-from .chat import (- ArtifactUpdateRequest,- ChatArtifactEnvelope,- ChatMessageResponse,- ChatRequest,- ChatSuggestion,- ChatSuggestionsResponse,- ConversationDetailResponse,- ConversationForkRequest,- ConversationResponse,- ConversationUpdateRequest,-)-from .claude_md import ClaudeMdGenerateResponse, ClaudeMdResponse-from .code_health import (- ChurnComplexityPoint,- ChurnComplexityResponse,- FileHealthTrendResponse,- FileTrendPointResponse,- HealthBadgeResponse,- HealthFileDelta,- HealthFindingResponse,- HealthFindingWithSymbolResponse,- HealthTrendAlert,- HealthTrendKpiRow,- HealthTrendResponse,- HealthTrendSummary,- HealthWorkItem,- HealthWorkQueueResponse,-)-from .code_quality import (- DeadCodeAnalyzeResponse,- DeadCodeFindingResponse,- DeadCodePatchRequest,- DeadCodeSummaryResponse,- RepoStatsResponse,- SecurityFindingResponse,-)-from .coupling import (- CouplingEdgeResponse,- CouplingGraphResponse,- CouplingNodeResponse,-)-from .decisions import (- DecisionCodeEdge,- DecisionCountsResponse,- DecisionCreate,- DecisionDiscoveryBudget,- DecisionDiscoveryPatch,- DecisionEvidenceListResponse,- DecisionEvidenceResponse,- DecisionGraphEdge,- DecisionGraphNode,- DecisionGraphResponse,- DecisionHealthResponse,- DecisionLaneCountsResponse,- DecisionLineageEntry,- DecisionLineageResponse,- DecisionRecordResponse,- DecisionSettings,- DecisionSettingsUpdate,- DecisionSourcePatch,- DecisionSourceState,- DecisionStatusUpdate,-)-from .doc_drift import (- DocDriftDocumentDriftResponse,- DocDriftFindingResponse,- DocDriftReferenceResponse,- DocDriftReferencesResponse,- DocDriftResponse,- DocDriftSummaryResponse,-)-from .episodes import (- EpisodeCountsResponse,- EpisodeDetail,- EpisodeListResponse,- EpisodeSummary,-)-from .external_systems import (- ExternalSystemEntry,- ExternalSystemsResponse,-)-from .git import (- AgentTrendBucket,- AgentTrendResponse,- ChangeFeaturesResponse,- CoChangeResponse,- CommitDetailResponse,- CommitEvolutionBucket,- CommitEvolutionResponse,- CommitFileResponse,- CommitHealthFindingResponse,- CommitHealthResponse,- CommitResponse,- CommitStatsResponse,- FixHistoryFileResponse,- FixHistoryResponse,- GitMetadataResponse,- GitSummaryResponse,- HotspotResponse,- OwnershipEntry,- RiskDriverResponse,- RiskHistogramBucket,- RiskRangeResponse,-)-from .graph import (- ArchitectureEdgeResponse,- ArchitectureGraphResponse,- ArchitectureNodeResponse,- CommunitySliceNodeResponse,- CommunitySliceResponse,- DeadCodeGraphNodeResponse,- DeadCodeGraphResponse,- DependencyPathResponse,- EgoGraphResponse,- GraphEdgeResponse,- GraphExportResponse,- GraphNodeResponse,- HotFilesGraphResponse,- HotFilesNodeResponse,- ModuleEdgeResponse,- ModuleGraphResponse,- ModuleNodeResponse,- NodeSearchResult,- PopulationBreakdown,- UnclusteredFiles,-)-from .health import (- CoordinatorHealthResponse,- HealthResponse,-)-from .intelligence import (- CallerCalleeEntry,- CallersCalleesResponse,- CommunityDetailResponse,- CommunityMember,- CommunitySummaryItem,- ExecutionFlowEntry,- ExecutionFlowsResponse,- GraphMetricsResponse,- NeighboringCommunity,- SymbolNodeSummary,-)-from .mcp import (- McpToolInfo,- McpToolSurfaceResponse,- UpdateMcpToolsRequest,-)-from .meta import (- ChangelogEntryModel,- ChangelogResponse,- ChangelogSectionModel,- VersionResponse,-)-from .ownership import (- GoverningDecisionRef,- KnowledgeMapOwner,- KnowledgeMapResponse,- KnowledgeMapSilo,- KnowledgeMapTarget,- ModuleHealthDetail,- ModuleHealthOwner,- ModuleHealthSummary,- OwnerAgentCollab,- OwnerCoAuthor,- OwnerFileEntry,- OwnerListEntry,- OwnerModuleRollup,- OwnerProfileResponse,- ReviewerSuggestion,- ReviewerSuggestionsResponse,-)-from .pages import (- JobResponse,- PageResponse,- PageSummaryResponse,- PageVersionResponse,-)-from .pagination import Paginated-from .refactoring import (- RefactoringOpportunitiesResponse,- RefactoringOpportunityDetailResponse,- RefactoringOpportunityStatusResponse,- RefactoringPlanStatusResponse,- RefactoringRollupResponse,-)-from .repository import (- JobAcceptedResponse,- RepoCreate,- RepoDeletedResponse,- RepoResponse,- ReposSummaryResponse,- RepoSummaryRow,- RepoUpdate,-)-from .search import (- SearchRequest,- SearchResultResponse,-)-from .symbols import (- SymbolImportanceComponents,- SymbolResponse,-)-from .ui_helpers import (- ActiveProviderSelection,- CostGroupResponse,- CostSummaryResponse,- OkResponse,- ProviderEntry,- ProviderStatusResponse,- ProviderValidationResponse,- SavingsAgentRow,- SavingsBreakdownRow,- SavingsOpportunityRow,- SavingsResponse,- SetActiveProviderRequest,- SetApiKeyRequest,- WebhookResponse,-)-from .workspace import (- WorkspaceArchitectureResponse,- WorkspaceBlastRadiusResponse,- WorkspaceBreakingChange,- WorkspaceBreakingChangesResponse,- WorkspaceCoChangeEntry,- WorkspaceCoChangesResponse,- WorkspaceCoChangeStructure,- WorkspaceConformanceResponse,- WorkspaceConformanceViolation,- WorkspaceContractDetail,- WorkspaceContractEntry,- WorkspaceContractLinkEntry,- WorkspaceContractsResponse,- WorkspaceContractSummary,- WorkspaceCrossRepoSummary,- WorkspaceDependencyCycle,- WorkspaceExtractionDiagnostics,- WorkspaceGraphEdge,- WorkspaceGraphNode,- WorkspaceGraphResponse,- WorkspaceImpactedConsumer,- WorkspaceImpactedNode,- WorkspaceOrphanProvider,- WorkspaceRepoDiagnostics,- WorkspaceRepoEntry,- WorkspaceRepoRemovedResponse,- WorkspaceResponse,- WorkspaceSyncResponse,- WorkspaceSyncResult,- WorkspaceSystemEdge,- WorkspaceSystemGraphResponse,- WorkspaceSystemNode,- WorkspaceTestImpactFile,- WorkspaceTestImpactResponse,- WorkspaceTestRecommendation,- WorkspaceUnmatchedConsumer,- WorkspaceUnresolvedLink,-)-from .zoom import (- ZoomMapResponse,- ZoomMetricsResponse,- ZoomNodeResponse,- ZoomRelationResponse,-)+import importlib+from typing import TYPE_CHECKING, Any++if TYPE_CHECKING:+ from .architecture import (+ ArchEdgeResponse,+ ArchitectureViewResponse,+ ArchLayerResponse,+ ArchNodeResponse,+ ArchSubGroupResponse,+ ArchTourStepResponse,+ )+ from .blast_radius import (+ BlastRadiusRequest,+ BlastRadiusResponse,+ CochangeWarning,+ DirectRiskEntry,+ ReviewerEntry,+ TransitiveEntry,+ )+ from .c4 import (+ C4ComponentResponse,+ C4ContainerResponse,+ C4ExternalSystemResponse,+ C4L1Response,+ C4L2Response,+ C4L3Response,+ C4PersonResponse,+ C4RelationResponse,+ C4SystemResponse,+ )+ from .chat import (+ ArtifactUpdateRequest,+ ChatArtifactEnvelope,+ ChatMessageResponse,+ ChatRequest,+ ChatSuggestion,+ ChatSuggestionsResponse,+ ConversationDetailResponse,+ ConversationForkRequest,+ ConversationResponse,+ ConversationUpdateRequest,+ )+ from .claude_md import ClaudeMdGenerateResponse, ClaudeMdResponse+ from .code_health import (+ ChurnComplexityPoint,+ ChurnComplexityResponse,+ FileHealthTrendResponse,+ FileTrendPointResponse,+ HealthBadgeResponse,+ HealthFileDelta,+ HealthFindingResponse,+ HealthFindingWithSymbolResponse,+ HealthTrendAlert,+ HealthTrendKpiRow,+ HealthTrendResponse,+ HealthTrendSummary,+ HealthWorkItem,+ HealthWorkQueueResponse,+ )+ from .code_quality import (+ DeadCodeAnalyzeResponse,+ DeadCodeFindingResponse,+ DeadCodePatchRequest,+ DeadCodeSummaryResponse,+ RepoStatsResponse,+ SecurityFindingResponse,+ )+ from .coupling import (+ CouplingEdgeResponse,+ CouplingGraphResponse,+ CouplingNodeResponse,+ )+ from .decisions import (+ DecisionCodeEdge,+ DecisionCountsResponse,+ DecisionCreate,+ DecisionDiscoveryBudget,+ DecisionDiscoveryPatch,+ DecisionEvidenceListResponse,+ DecisionEvidenceResponse,+ DecisionGraphEdge,+ DecisionGraphNode,+ DecisionGraphResponse,+ DecisionHealthResponse,+ DecisionLaneCountsResponse,+ DecisionLineageEntry,+ DecisionLineageResponse,+ DecisionRecordResponse,+ DecisionSettings,+ DecisionSettingsUpdate,+ DecisionSourcePatch,+ DecisionSourceState,+ DecisionStatusUpdate,+ )+ from .doc_drift import (+ DocDriftDocumentDriftResponse,+ DocDriftFindingResponse,+ DocDriftReferenceResponse,+ DocDriftReferencesResponse,+ DocDriftResponse,+ DocDriftSummaryResponse,+ )+ from .episodes import (+ EpisodeCountsResponse,+ EpisodeDetail,+ EpisodeListResponse,+ EpisodeSummary,+ )+ from .external_systems import (+ ExternalSystemEntry,+ ExternalSystemsResponse,+ )+ from .git import (+ AgentTrendBucket,+ AgentTrendResponse,+ ChangeFeaturesResponse,+ CoChangeResponse,+ CommitDetailResponse,+ CommitEvolutionBucket,+ CommitEvolutionResponse,+ CommitFileResponse,+ CommitHealthFindingResponse,+ CommitHealthResponse,+ CommitResponse,+ CommitStatsResponse,+ FixHistoryFileResponse,+ FixHistoryResponse,+ GitMetadataResponse,+ GitSummaryResponse,+ HotspotResponse,+ OwnershipEntry,+ RiskDriverResponse,+ RiskHistogramBucket,+ RiskRangeResponse,+ )+ from .graph import (+ ArchitectureEdgeResponse,+ ArchitectureGraphResponse,+ ArchitectureNodeResponse,+ CommunitySliceNodeResponse,+ CommunitySliceResponse,+ DeadCodeGraphNodeResponse,+ DeadCodeGraphResponse,+ DependencyPathResponse,+ EgoGraphResponse,+ GraphEdgeResponse,+ GraphExportResponse,+ GraphNodeResponse,+ HotFilesGraphResponse,+ HotFilesNodeResponse,+ ModuleEdgeResponse,+ ModuleGraphResponse,+ ModuleNodeResponse,+ NodeSearchResult,+ PopulationBreakdown,+ UnclusteredFiles,+ )+ from .health import (+ CoordinatorHealthResponse,+ HealthResponse,+ )+ from .intelligence import (+ CallerCalleeEntry,+ CallersCalleesResponse,+ CommunityDetailResponse,+ CommunityMember,+ CommunitySummaryItem,+ ExecutionFlowEntry,+ ExecutionFlowsResponse,+ GraphMetricsResponse,+ NeighboringCommunity,+ SymbolNodeSummary,+ )+ from .mcp import (+ McpToolInfo,+ McpToolSurfaceResponse,+ UpdateMcpToolsRequest,+ )+ from .meta import (+ ChangelogEntryModel,+ ChangelogResponse,+ ChangelogSectionModel,+ VersionResponse,+ )+ from .ownership import (+ GoverningDecisionRef,+ KnowledgeMapOwner,+ KnowledgeMapResponse,+ KnowledgeMapSilo,+ KnowledgeMapTarget,+ ModuleHealthDetail,+ ModuleHealthOwner,+ ModuleHealthSummary,+ OwnerAgentCollab,+ OwnerCoAuthor,+ OwnerFileEntry,+ OwnerListEntry,+ OwnerModuleRollup,+ OwnerProfileResponse,+ ReviewerSuggestion,+ ReviewerSuggestionsResponse,+ )+ from .pages import (+ JobResponse,+ PageResponse,+ PageSummaryResponse,+ PageVersionResponse,+ )+ from .pagination import Paginated+ from .refactoring import (+ RefactoringOpportunitiesResponse,+ RefactoringOpportunityDetailResponse,+ RefactoringOpportunityStatusResponse,+ RefactoringPlanStatusResponse,+ RefactoringRollupResponse,+ )+ from .repository import (+ JobAcceptedResponse,+ RepoCreate,+ RepoDeletedResponse,+ RepoResponse,+ ReposSummaryResponse,+ RepoSummaryRow,+ RepoUpdate,+ )+ from .search import (+ SearchRequest,+ SearchResultResponse,+ )+ from .symbols import (+ SymbolImportanceComponents,+ SymbolResponse,+ )+ from .ui_helpers import (+ ActiveProviderSelection,+ CostGroupResponse,+ CostSummaryResponse,+ OkResponse,+ ProviderEntry,+ ProviderStatusResponse,+ ProviderValidationResponse,+ SavingsAgentRow,+ SavingsBreakdownRow,+ SavingsOpportunityRow,+ SavingsResponse,+ SetActiveProviderRequest,+ SetApiKeyRequest,+ WebhookResponse,+ )+ from .workspace import (+ WorkspaceArchitectureResponse,+ WorkspaceBlastRadiusResponse,+ WorkspaceBreakingChange,+ WorkspaceBreakingChangesResponse,+ WorkspaceCoChangeEntry,+ WorkspaceCoChangesResponse,+ WorkspaceCoChangeStructure,+ WorkspaceConformanceResponse,+ WorkspaceConformanceViolation,+ WorkspaceContractDetail,+ WorkspaceContractEntry,+ WorkspaceContractLinkEntry,+ WorkspaceContractsResponse,+ WorkspaceContractSummary,+ WorkspaceCrossRepoSummary,+ WorkspaceDependencyCycle,+ WorkspaceExtractionDiagnostics,+ WorkspaceGraphEdge,+ WorkspaceGraphNode,+ WorkspaceGraphResponse,+ WorkspaceImpactedConsumer,+ WorkspaceImpactedNode,+ WorkspaceOrphanProvider,+ WorkspaceRepoDiagnostics,+ WorkspaceRepoEntry,+ WorkspaceRepoRemovedResponse,+ WorkspaceResponse,+ WorkspaceSyncResponse,+ WorkspaceSyncResult,+ WorkspaceSystemEdge,+ WorkspaceSystemGraphResponse,+ WorkspaceSystemNode,+ WorkspaceTestImpactFile,+ WorkspaceTestImpactResponse,+ WorkspaceTestRecommendation,+ WorkspaceUnmatchedConsumer,+ WorkspaceUnresolvedLink,+ )+ from .zoom import (+ ZoomMapResponse,+ ZoomMetricsResponse,+ ZoomNodeResponse,+ ZoomRelationResponse,+ )++# Loaded on first access (PEP 562), so importing one model does not pay for+# every submodule, one of which pulls in the whole dead-code analyzer.+_EXPORTS: dict[str, tuple[str, ...]] = {+ "architecture": (+ "ArchEdgeResponse",+ "ArchitectureViewResponse",+ "ArchLayerResponse",+ "ArchNodeResponse",+ "ArchSubGroupResponse",+ "ArchTourStepResponse",+ ),+ "blast_radius": (+ "BlastRadiusRequest",+ "BlastRadiusResponse",+ "CochangeWarning",+ "DirectRiskEntry",+ "ReviewerEntry",+ "TransitiveEntry",+ ),+ "c4": (+ "C4ComponentResponse",+ "C4ContainerResponse",+ "C4ExternalSystemResponse",+ "C4L1Response",+ "C4L2Response",+ "C4L3Response",+ "C4PersonResponse",+ "C4RelationResponse",+ "C4SystemResponse",+ ),+ "chat": (+ "ArtifactUpdateRequest",+ "ChatArtifactEnvelope",+ "ChatMessageResponse",+ "ChatRequest",+ "ChatSuggestion",+ "ChatSuggestionsResponse",+ "ConversationDetailResponse",+ "ConversationForkRequest",+ "ConversationResponse",+ "ConversationUpdateRequest",+ ),+ "claude_md": ("ClaudeMdGenerateResponse", "ClaudeMdResponse"),+ "code_health": (+ "ChurnComplexityPoint",+ "ChurnComplexityResponse",+ "FileHealthTrendResponse",+ "FileTrendPointResponse",+ "HealthBadgeResponse",+ "HealthFileDelta",+ "HealthFindingResponse",+ "HealthFindingWithSymbolResponse",+ "HealthTrendAlert",+ "HealthTrendKpiRow",+ "HealthTrendResponse",+ "HealthTrendSummary",+ "HealthWorkItem",+ "HealthWorkQueueResponse",+ ),+ "code_quality": (+ "DeadCodeAnalyzeResponse",+ "DeadCodeFindingResponse",+ "DeadCodePatchRequest",+ "DeadCodeSummaryResponse",+ "RepoStatsResponse",+ "SecurityFindingResponse",+ ),+ "coupling": ("CouplingEdgeResponse", "CouplingGraphResponse", "CouplingNodeResponse"),+ "decisions": (+ "DecisionCodeEdge",+ "DecisionCountsResponse",+ "DecisionCreate",+ "DecisionDiscoveryBudget",+ "DecisionDiscoveryPatch",+ "DecisionEvidenceListResponse",+ "DecisionEvidenceResponse",+ "DecisionGraphEdge",+ "DecisionGraphNode",+ "DecisionGraphResponse",+ "DecisionHealthResponse",+ "DecisionLaneCountsResponse",+ "DecisionLineageEntry",+ "DecisionLineageResponse",+ "DecisionRecordResponse",+ "DecisionSettings",+ "DecisionSettingsUpdate",+ "DecisionSourcePatch",+ "DecisionSourceState",+ "DecisionStatusUpdate",+ ),+ "doc_drift": (+ "DocDriftDocumentDriftResponse",+ "DocDriftFindingResponse",+ "DocDriftReferenceResponse",+ "DocDriftReferencesResponse",+ "DocDriftResponse",+ "DocDriftSummaryResponse",+ ),+ "episodes": ("EpisodeCountsResponse", "EpisodeDetail", "EpisodeListResponse", "EpisodeSummary"),+ "external_systems": ("ExternalSystemEntry", "ExternalSystemsResponse"),+ "git": (+ "AgentTrendBucket",+ "AgentTrendResponse",+ "ChangeFeaturesResponse",+ "CoChangeResponse",+ "CommitDetailResponse",+ "CommitEvolutionBucket",+ "CommitEvolutionResponse",+ "CommitFileResponse",+ "CommitHealthFindingResponse",+ "CommitHealthResponse",+ "CommitResponse",+ "CommitStatsResponse",+ "FixHistoryFileResponse",+ "FixHistoryResponse",+ "GitMetadataResponse",+ "GitSummaryResponse",+ "HotspotResponse",+ "OwnershipEntry",+ "RiskDriverResponse",+ "RiskHistogramBucket",+ "RiskRangeResponse",+ ),+ "graph": (+ "ArchitectureEdgeResponse",+ "ArchitectureGraphResponse",+ "ArchitectureNodeResponse",+ "CommunitySliceNodeResponse",+ "CommunitySliceResponse",+ "DeadCodeGraphNodeResponse",+ "DeadCodeGraphResponse",+ "DependencyPathResponse",+ "EgoGraphResponse",+ "GraphEdgeResponse",+ "GraphExportResponse",+ "GraphNodeResponse",+ "HotFilesGraphResponse",+ "HotFilesNodeResponse",+ "ModuleEdgeResponse",+ "ModuleGraphResponse",+ "ModuleNodeResponse",+ "NodeSearchResult",+ "PopulationBreakdown",+ "UnclusteredFiles",+ ),+ "health": ("CoordinatorHealthResponse", "HealthResponse"),+ "intelligence": (+ "CallerCalleeEntry",+ "CallersCalleesResponse",+ "CommunityDetailResponse",+ "CommunityMember",+ "CommunitySummaryItem",+ "ExecutionFlowEntry",+ "ExecutionFlowsResponse",+ "GraphMetricsResponse",+ "NeighboringCommunity",+ "SymbolNodeSummary",+ ),+ "mcp": ("McpToolInfo", "McpToolSurfaceResponse", "UpdateMcpToolsRequest"),+ "meta": (+ "ChangelogEntryModel",+ "ChangelogResponse",+ "ChangelogSectionModel",+ "VersionResponse",+ ),+ "ownership": (+ "GoverningDecisionRef",+ "KnowledgeMapOwner",+ "KnowledgeMapResponse",+ "KnowledgeMapSilo",+ "KnowledgeMapTarget",+ "ModuleHealthDetail",+ "ModuleHealthOwner",+ "ModuleHealthSummary",+ "OwnerAgentCollab",+ "OwnerCoAuthor",+ "OwnerFileEntry",+ "OwnerListEntry",+ "OwnerModuleRollup",+ "OwnerProfileResponse",+ "ReviewerSuggestion",+ "ReviewerSuggestionsResponse",+ ),+ "pages": ("JobResponse", "PageResponse", "PageSummaryResponse", "PageVersionResponse"),+ "pagination": ("Paginated",),+ "refactoring": (+ "RefactoringOpportunitiesResponse",+ "RefactoringOpportunityDetailResponse",+ "RefactoringOpportunityStatusResponse",+ "RefactoringPlanStatusResponse",+ "RefactoringRollupResponse",+ ),+ "repository": (+ "JobAcceptedResponse",+ "RepoCreate",+ "RepoDeletedResponse",+ "RepoResponse",+ "ReposSummaryResponse",+ "RepoSummaryRow",+ "RepoUpdate",+ ),+ "search": ("SearchRequest", "SearchResultResponse"),+ "symbols": ("SymbolImportanceComponents", "SymbolResponse"),+ "ui_helpers": (+ "ActiveProviderSelection",+ "CostGroupResponse",+ "CostSummaryResponse",+ "OkResponse",+ "ProviderEntry",+ "ProviderStatusResponse",+ "ProviderValidationResponse",+ "SavingsAgentRow",+ "SavingsBreakdownRow",+ "SavingsOpportunityRow",+ "SavingsResponse",+ "SetActiveProviderRequest",+ "SetApiKeyRequest",+ "WebhookResponse",+ ),+ "workspace": (+ "WorkspaceArchitectureResponse",+ "WorkspaceBlastRadiusResponse",+ "WorkspaceBreakingChange",+ "WorkspaceBreakingChangesResponse",+ "WorkspaceCoChangeEntry",+ "WorkspaceCoChangesResponse",+ "WorkspaceCoChangeStructure",+ "WorkspaceConformanceResponse",+ "WorkspaceConformanceViolation",+ "WorkspaceContractDetail",+ "WorkspaceContractEntry",+ "WorkspaceContractLinkEntry",+ "WorkspaceContractsResponse",+ "WorkspaceContractSummary",+ "WorkspaceCrossRepoSummary",+ "WorkspaceDependencyCycle",+ "WorkspaceExtractionDiagnostics",+ "WorkspaceGraphEdge",+ "WorkspaceGraphNode",+ "WorkspaceGraphResponse",+ "WorkspaceImpactedConsumer",+ "WorkspaceImpactedNode",+ "WorkspaceOrphanProvider",+ "WorkspaceRepoDiagnostics",+ "WorkspaceRepoEntry",+ "WorkspaceRepoRemovedResponse",+ "WorkspaceResponse",+ "WorkspaceSyncResponse",+ "WorkspaceSyncResult",+ "WorkspaceSystemEdge",+ "WorkspaceSystemGraphResponse",+ "WorkspaceSystemNode",+ "WorkspaceTestImpactFile",+ "WorkspaceTestImpactResponse",+ "WorkspaceTestRecommendation",+ "WorkspaceUnmatchedConsumer",+ "WorkspaceUnresolvedLink",+ ),+ "zoom": ("ZoomMapResponse", "ZoomMetricsResponse", "ZoomNodeResponse", "ZoomRelationResponse"),+}++_SUBMODULE_OF = {name: module for module, names in _EXPORTS.items() for name in names}++# Runtime only: a visible module __getattr__ would make type checkers accept+# any misspelled name as Any.+if not TYPE_CHECKING:++ def __getattr__(name: str) -> Any:+ module = _SUBMODULE_OF.get(name)+ if module is None:+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")+ value = getattr(importlib.import_module(f".{module}", __name__), name)+ globals()[name] = value+ return value++ def __dir__() -> list[str]:+ return sorted({*globals(), *__all__})+__all__ = ["ActiveProviderSelection",diff --git a/tests/unit/server/test_schemas_package.py b/tests/unit/server/test_schemas_package.pyindex 6300049a0..22c702540 100644--- a/tests/unit/server/test_schemas_package.py+++ b/tests/unit/server/test_schemas_package.py@@ -3,11 +3,20 @@These guard the split of the former single ``schemas.py`` module into apackage: the public import surface must be unchanged, and the deduplicatedgraph-node models must serialize identically to their pre-split form-(same field set, order, and JSON output).+(same field set, order, and JSON output). Submodules load on first access,+so the facade must not import them all."""from __future__ import annotations+import ast+import os+import subprocess+import sys+from pathlib import Path++import pytest+from repowise.server import schemas@@ -89,3 +98,47 @@ def test_graph_node_serialization_unchanged() -> None:**expected_base,"commit_count": 7,}+++def test_lazy_map_matches_the_static_imports_and_all() -> None:+ """The runtime map, the type-checking imports and ``__all__`` list one set."""+ tree = ast.parse(Path(schemas.__file__).read_text(encoding="utf-8"))+ guarded = next(+ n+ for n in tree.body+ if isinstance(n, ast.If) and isinstance(n.test, ast.Name) and n.test.id == "TYPE_CHECKING"+ )+ static = {+ alias.name: node.module+ for node in guarded.body+ if isinstance(node, ast.ImportFrom)+ for alias in node.names+ }+ assert static == schemas._SUBMODULE_OF+ assert sum(map(len, schemas._EXPORTS.values())) == len(static)+ assert sorted(schemas.__all__) == sorted(static)+++ ("statement", "loaded"),+ [+ ("from repowise.server.schemas import ZoomMapResponse", "zoom"),+ ("from repowise.server.schemas.risk_semantics import RiskScalarSemantics", "risk_semantics"),+ ],+)+def test_one_model_does_not_load_every_submodule(statement: str, loaded: str) -> None:+ probe = (+ f"import sys; {statement}; "+ "print(sorted(m for m in sys.modules if m.startswith('repowise.server.schemas.')))"+ )+ # Same sys.path as this process, so the child imports this checkout.+ env = {**os.environ, "PYTHONPATH": os.pathsep.join(sys.path)}+ out = subprocess.run(+ [sys.executable, "-c", probe],+ capture_output=True,+ text=True,+ check=True,+ env=env,+ timeout=60,+ ).stdout+ assert out.strip() == f"['repowise.server.schemas.{loaded}']"