Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

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__.py
index 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 existing
from __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.py
index 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 a
package: the public import surface must be unchanged, and the deduplicated
graph-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}']"