Skip to main content

code_system_graph_core/
lib.rs

1//! Application logic and ports for federated repository intelligence.
2
3mod batch;
4mod builtin_extractors;
5mod capability_dir;
6mod change_analysis;
7mod changes;
8mod codegraph;
9mod communities;
10mod config;
11mod contract_compat;
12mod corroboration;
13mod data_contracts;
14mod documents;
15mod event_graph;
16mod events;
17mod execution_policy;
18mod extraction_budget;
19mod extraction_graph;
20mod extractor;
21mod generated_client;
22mod graphql_contracts;
23mod graphql_graph;
24mod http;
25mod ignore_policy;
26mod impact;
27mod incremental;
28mod infrastructure;
29mod interfaces;
30mod linker;
31mod manifest;
32mod manifest_edit;
33mod package_graph;
34mod packages;
35mod protobuf_contracts;
36mod protobuf_graph;
37mod provider;
38mod pull_requests;
39mod query;
40mod registry;
41mod secret_safety;
42mod source_graph;
43mod source_http;
44mod source_polyglot;
45mod source_symbol;
46mod source_syntax;
47mod test_links;
48mod trace;
49mod yaml;
50
51pub use batch::{
52    ArtifactKey, BatchAction, BatchPlanError, ExtractorBatch, ExtractorBatchPlan, PlannedBatch, affected_link_keys, load_extractor_batch, load_extractor_batch_with_budgets, plan_extractor_batches, store_extractor_batch
53};
54pub use builtin_extractors::{
55    FocusedSourceExtractor, FocusedSourceLanguage, GeneratedClientMetadataExtractor, PackageManifestExtractor, charge_source_observation, precheck_focused_source_values
56};
57pub use capability_dir::{
58    CapabilityDir, CapabilityError, MAX_REPOSITORY_CONFIG_BYTES, RegularFileEntry
59};
60pub use change_analysis::{
61    CHANGE_ANALYZER_VERSION, ChangeAnalysisCoverage, ChangeAnalysisError, ChangeAnalysisOptions, ChangeAnalysisSummary, ChangeConclusion, ChangeImpactReport, ChangedArtifactMapping, ChangedEntity, ChangedEntityRole, ChangedPathSide, ContractCompatibilityInput, EvidenceMatchKind, HunkLineMatch, MappingCompleteness, SemanticContractDelta, analyze_changes, validate_change_analysis
62};
63pub use changes::{
64    AnalyzerVersions, ChangeError, ChangeHunk, ChangeProvider, ChangeRequest, ChangeScope, ChangeSet, ChangeSourceLayer, ChangeValidity, ChangeValidityInput, ChangedFile, ChangedFileStatus, ChangedLine, ChangedLineKind, CommitFileSelection, CommitGate, CommitIntent, CommitSelection, GitCliChangeProvider, StaleReason, evaluate_commit_gate, validate_change_set
65};
66pub use codegraph::{CodeGraphConfig, CodeGraphProvider};
67pub use communities::{
68    CommunityError, analyze_communities, analyze_communities_with_progress, compare_community_snapshots
69};
70pub use config::{
71    ConfigError, ConfigSource, EffectiveRepositoryConfig, apply_openapi_override, resolve_repository_config, resolve_repository_config_with_use_gitignore
72};
73pub use contract_compat::{
74    CompatibilityFinding, CompatibilityReport, CompatibilityStatus, compare_database_contracts, compare_event_contracts, compare_graphql_contracts, compare_http_contracts, compare_package_contracts, compare_protobuf_contracts
75};
76pub use corroboration::{
77    CorroborationReport, SymbolAnchor, SymbolCorroboration, corroborate_repository
78};
79pub use data_contracts::{
80    DataAccessObservation, DataAccessRole, DataArtifactKind, DataArtifactReference, DataArtifactReferenceKind, DataDocument, DataEvidenceLine, DataExtractionError, DataFramework, DataOperation, DataWarning, DatabaseColumn, DatabaseForeignKey, DatabaseIndex, DatabaseTable, MigrationMetadata, extract_data_artifact, parse_literal_sql_source, parse_literal_sql_source_at_root
81};
82pub use documents::{
83    DocumentKind, DocumentRecord, DocumentationDocument, DocumentationExtractionError, ExplicitReference, ExplicitReferenceKind, LineEvidence, OwnershipRule, extract_codeowners, extract_markdown, extract_service_catalog
84};
85pub use event_graph::{
86    EventDeliveryProjection, EventDeliveryProjectionReport, EventGraphFacts, event_documents_to_graph, project_event_deliveries, project_event_deliveries_bounded
87};
88pub use events::{
89    DeliverySemantics, EventBroker, EventDocument, EventEvidenceLine, EventExtractionError, EventObservation, EventRole, EventSchemaDefinition, EventSchemaField, extract_asyncapi, parse_event_source
90};
91pub use execution_policy::{
92    CodeGraphCorroborationAnchorLimit, DEFAULT_MAX_CODEGRAPH_CORROBORATION_ANCHORS_PER_REPO, ExecutionLimitExceeded, ExecutionPolicy, ExecutionPolicyOverrides, ExecutionResource, ExecutionSummary, InvalidExecutionPolicy, JobPhase, MIN_MCP_MARKDOWN_BYTES, MonotonicClock, ScanJobTracker
93};
94pub use extraction_budget::{
95    BoundedJsonWriter, EXTRACTION_CONTRACT_VERSION, ExtractionBudgetOverrides, ExtractionBudgets, ExtractionClock, ExtractionLimitExceeded, ExtractionResource, ExtractionTracker, InvalidExtractionBudget
96};
97pub use extraction_graph::{ExtractionGraphFacts, documents_to_graph};
98pub use extractor::{
99    BoundaryExtractor, ContentFingerprint, DiscoverContext, DiscoveredInput, ExtractInput, ExtractionBatch, ExtractionCompleteness, ExtractionReport, ExtractorError, FileDescriptor, MAX_EXTRACTOR_INPUT_BYTES, fingerprint_content
100};
101pub use generated_client::{
102    GeneratedClientError, GeneratedClientMetadata, extract_generated_client_metadata
103};
104pub use graphql_contracts::{
105    GraphqlArgumentDefinition, GraphqlDocument, GraphqlExtractionError, GraphqlFederationMetadata, GraphqlFieldDefinition, GraphqlFragment, GraphqlLineRange, GraphqlLiteralKind, GraphqlOperation, GraphqlOperationKind, GraphqlPersistedOperation, GraphqlResolver, GraphqlSelection, GraphqlTypeDefinition, GraphqlTypeKind, GraphqlTypeRef, extract_graphql_document, extract_graphql_document_with_tracker, extract_graphql_persisted_operations, extract_graphql_persisted_operations_with_tracker, parse_graphql_source, parse_graphql_source_with_tracker
106};
107pub use graphql_graph::{GraphqlGraphFacts, graphql_documents_to_graph};
108pub use http::{
109    BoundaryRole, HttpBoundary, HttpExtractionError, extract_openapi, extract_openapi_with_tracker, normalize_http_path
110};
111pub use ignore_policy::{
112    DEFAULT_EXCLUDES, IGNORE_POLICY_VERSION, IgnorePatternError, IgnorePolicy, PROTECTED_EXCLUDES, RepositoryDiscoveryError, RepositoryPathMatcher, discover_repository_files, validate_excludes, validate_include_defaults
113};
114pub use impact::{
115    CompatibilityInput, ContractImpact, CoverageSummary, CriticalityAssignment, CriticalityTag, EnvironmentAssignment, ImpactClassification, ImpactCompatibilityStatus, ImpactContext, ImpactDepthBucket, ImpactDirection, ImpactError, ImpactItem, ImpactOptions, ImpactPathStep, ImpactReport, ImpactRequest, ImpactTarget, LocalEnrichmentInput, LocalEnrichmentStatus, LocalImpactItem, LocalImpactSummary, RecommendedCommand, RepositoryImpact, ResolvedTarget, RiskFactor, RiskLevel, ServiceImpact, TestRecommendation, TestRecommendationSource, TruncationInfo, analyze_impact
116};
117pub use incremental::{IncrementalPlan, plan_incremental_scan};
118pub use infrastructure::{
119    DeploymentKind, DeploymentUnit, InfrastructureArtifactKind, InfrastructureDocument, InfrastructureEvidence, InfrastructureEvidenceKind, InfrastructureExtractionError, InfrastructurePort, InfrastructureResource, InfrastructureResourceKind, InfrastructureSelector, extract_docker_compose, extract_helm, extract_kubernetes, extract_terraform
120};
121pub use interfaces::{
122    Ambiguity, CONTRACT_NODE_KINDS, ConfigDoctorInput, ContractAction, ContractCompatibility, ContractCompatibilitySummary, ContractDifference, ContractFinding, ContractIssue, ContractIssueSeverity, ContractLink, ContractReport, ContractRequest, ContractView, DELIVERY_METADATA_VERSION, DoctorCategory, DoctorCheck, DoctorReport, DoctorRequest, DoctorStatus, DomainErrorKind, EvidenceMetadata, ExitCode, ExportFormat, ExportReport, ExportRequest, FreshnessDoctorInput, INTERFACE_RESULT_VERSION, INTERFACE_SCHEMA_VERSION, IntegrityDoctorInput, InterfaceError, MAX_EXPORT_EDGES, MAX_EXPORT_NODES, NextAction, Page, Pagination, ProviderDoctorInput, ProviderDoctorStatus, PublicSchema, PublicSchemaCatalog, SchemaDoctorInput, Summary, Warning, classify_exit_code, classify_interface_error, doctor, export_graph, inspect_contracts, paginate, public_schema_catalog
123};
124pub use linker::{
125    HttpLinkAmbiguity, HttpLinkResolution, LinkError, ManualLinkEndpoint, ManualLinkError, ManualLinkResolution, link_http_boundaries, link_http_boundaries_with_ambiguities, merge_affected_link_neighborhoods, resolve_manual_links
126};
127pub use manifest::{
128    ContractImplementationConfig, HttpConsumerConfig, HttpContractConfig, IntegrationTestConfig, ManifestError, ManifestExtensions, ManualLinkConfig, RepositoryConfig, WorkspaceManifest, parse_manifest, parse_manifest_with_extensions, validate_manual_links
129};
130pub use manifest_edit::{
131    ManifestEdit, ManifestEditError, ManifestWriteReport, commit_manifest_edit, preview_add_manual_link, preview_add_repository, preview_remove_repository
132};
133pub use package_graph::{
134    PackageDependencyFact, PackageGraphFacts, PackageIdentity, link_registered_package_owners, package_manifest_to_graph
135};
136pub use packages::{
137    DependencyScope, LockfileMetadata, PackageCoordinate, PackageDependency, PackageEcosystem, PackageEvidenceLine, PackageManifest, PackageManifestError, PackageManifestValue, extract_package_manifest, extract_package_manifest_with_tracker
138};
139pub use protobuf_contracts::{
140    ProtoEnum, ProtoEnumValue, ProtoField, ProtoFieldCardinality, ProtoFile, ProtoGeneratedMarker, ProtoGeneratedRole, ProtoMessage, ProtoRpcMethod, ProtoService, ProtoSyntax, ProtoWireType, ProtobufDocument, ProtobufExtractionError, extract_protobuf, extract_protobuf_with_tracker, parse_protobuf_generated_source
141};
142pub use protobuf_graph::{ProtobufGraphFacts, protobuf_documents_to_graph};
143pub use provider::{
144    AffectedTestsRequest, AffectedTestsResult, LocalCodeIntelligenceProvider, LocalContextRequest, LocalContextResult, LocalImpactRequest, LocalImpactResult, LocalNeighbor, LocalNeighborDirection, LocalNeighborResult, LocalNeighborsRequest, ProviderBudget, ProviderCapability, ProviderDegradation, ProviderError, ProviderExecution, ProviderOperation, ProviderOperationCapability, ProviderRequest, ProviderStatus, ProviderTransport, ResolveSymbolsRequest, ResolveSymbolsResult, ResolvedSymbol
145};
146pub use pull_requests::{
147    BitbucketProvider, ChangedFileStatus as PullRequestChangedFileStatus, CheckState, ContractRole, GitHubProvider, PrAuthToken, PrHttpAuthentication, PrHttpMethod, PrHttpRequest, PrHttpResponse, PrHttpTransport, PrHttpTransportError, PullRequestChangedFile, PullRequestCheck, PullRequestCi, PullRequestContractChange, PullRequestCoordinates, PullRequestError, PullRequestInspectRequest, PullRequestInspection, PullRequestListPage, PullRequestListRequest, PullRequestListState, PullRequestMetadata, PullRequestOrder, PullRequestOrderSuggestion, PullRequestOverlap, PullRequestOverlapKind, PullRequestProvider, PullRequestProviderConfig, PullRequestProviderKind, PullRequestRateLimit, PullRequestReadiness, PullRequestRef, PullRequestRepository, PullRequestReview, PullRequestReviewSummary, PullRequestSemanticInput, PullRequestState, PullRequestSummary, PullRequestWarning, ReqwestPrHttpTransport, ReviewState, semantic_pull_request_overlap, suggest_pull_request_order
148};
149pub use query::{
150    AgentNextAction, EdgeKindCost, PathSegment, PathSegmentScope, QueryError, SearchCoverage, SearchExplanation, SearchFilters, SearchHit, SearchReport, SearchRequest, TraversalAlgorithm, TraversalDirection, TraversalFilters, TraversalLimits, TraversalOptions, TraversalPath, TraversalReport, TraversalRequest, search, traverse
151};
152pub use registry::{RegisteredWorkspace, RegistryError, encode_native_path, register_workspace};
153pub use secret_safety::{
154    ConfigArtifactKind, ConfigExtractionError, SafeConfigDocument, SafeConfigKey, SensitiveKeyKind, classify_sensitive_key, extract_safe_config, is_safe_literal_reference
155};
156pub use source_graph::{SourceGraphFacts, source_observations_to_graph};
157pub use source_http::{
158    SourceEpistemicStatus, SourceFramework, SourceLanguage, SourceLineRange, SourceObservation, SourceRole, SourceWarning, normalize_source_http_path, parse_python_source, parse_python_source_with_tracker, parse_rust_source, parse_rust_source_with_tracker
159};
160pub use source_polyglot::{
161    parse_go_source, parse_go_source_with_tracker, parse_java_source, parse_java_source_with_tracker, parse_javascript_source, parse_javascript_source_at_path, parse_javascript_source_at_path_with_tracker, parse_typescript_source, parse_typescript_source_at_path, parse_typescript_source_at_path_with_tracker
162};
163pub use source_symbol::SourceSymbolIdentity;
164pub use source_syntax::{
165    SourceSyntaxError, SourceSyntaxInspection, SourceSyntaxLanguage, inspect_source_syntax
166};
167pub use test_links::{
168    DeclaredImplementation, DeclaredTestCase, declared_implementation, declared_test_case, link_declared_implementations, link_declared_implementations_with_ambiguities, link_declared_tests, link_declared_tests_with_ambiguities
169};
170pub use trace::{FederatedGraph, TraceError};