Crate projectatlas_service 

Purpose: Provide shared ProjectAtlas query services for CLI and MCP adapters.

Structs

AnalysisFinding

One deterministic bounded analysis finding.

AnalysisNode

One reusable analysis node retaining its authoritative navigation evidence.

CodeSlice

Exact code slice returned after orientation.

CodeSliceBudget

Encoded-output ceiling shared by line and symbol slices.

CodeSliceDraft

Unrendered exact slice with its selected adapter-output ceiling.

CoverageDigest

Compact relationship and parse coverage attached to one selected-file summary.

CoverageDiscoveryReport

Agent-facing bounded coverage discovery report.

CoverageDiscoveryRow

One actionable row in an opt-in coverage page.

CoverageStateCounts

Per-state counts retained by one selected-file coverage digest.

DetailedRelationBudget

Aggregate budgets for one detailed relation page and its resumable state.

DetailedRelationNode

One endpoint with authoritative purpose state projected at response time.

DetailedRelationPageDraft

Fully hydrated candidate page whose row prefix can be fit to an exact adapter envelope.

DetailedRelationQuery

Complete typed request for one bounded detailed relation traversal.

DetailedRelationReport

Bounded detailed relation traversal returned to CLI and MCP adapters.

DetailedRelationRow

One ranked node-simple step in a detailed relation response.

DetailedRelationWork

Exact aggregate work retained for one detailed relation page.

FederatedAnalysisDraft

Unrendered federated analysis response that fits the exact adapter envelope.

FederatedAnalysisReport

Federated closed-analysis response on the existing relation route.

FederatedDetailedRelationDraft

Unrendered federated detailed response that fits the exact adapter envelope.

FederatedDetailedRelationReport

Federated detailed-relation response on the existing relation route.

FederatedInputWork

Exact read-only freshness work completed before one root joined federation.

FederatedParticipant

One ordered participant retained without exposing its machine-local root.

FederatedRelationEvidence

One project-qualified relation supporting an exact typed external rendezvous.

FederatedRelationWork

Aggregate bounded work for one federated response.

FederatedRendezvous

Exact shared external identity observed in at least two projects.

FederatedStore

One already verified root-bound read-only store admitted by an adapter.

FileCallSummary

Compact file-summary call row.

FilePathMatcher

Reusable repository-relative file path matcher.

FileSummaryReport

Structured deterministic intelligence for one indexed file.

FileSymbolSummary

Compact file-summary symbol row.

NextStepReport

Agent-facing next-step recommendation report built from indexed metadata.

RelationAnalysisDraft

Unrendered analysis report that can fit an adapter’s exact final envelope.

RelationAnalysisQuery

Complete request for one bounded closed analysis projection.

RelationAnalysisReport

Bounded analysis report returned through the existing CLI and MCP relation route.

RelationAnalysisWork

Exact work performed in addition to the existing detailed traversal.

SearchMatch

Result row for indexed text search.

SearchQuery

Complete typed request for one bounded indexed-text search.

SearchReport

Search report returned by CLI and MCP adapters.

SymbolSliceSelector

Optional selectors for disambiguating a symbol slice.

Enums

AnalysisFindingKind

Closed finding families emitted by relation analysis.

AnalysisStatus

Confidence disposition of one analysis finding.

CoverageExtractionPass

Closed producer family represented by one coverage row.

CoverageTotalState

Typed cardinality knowledge for one bounded coverage page.

CoverageTrustState

Closed trust projection for one normalized coverage state.

GitImpactSelection

Version-control scope used by the impact projection.

RelationAnalysisMode

Closed analysis projection selected on the existing relation route.

RelationAnchor

Exact local starting point for relation navigation.

RelationDirection

Direction of one detailed relation request from its selected anchor.

RelationNextCall

Exact existing call that can consume one resolved local target directly.

RelationPurpose

Purpose state projected from the authoritative indexed owner at query time.

RelationResolutionFilter

Closed filter for persisted resolution state.

RelationTotalState

Typed cardinality knowledge for one bounded relation page.

SearchRetrievalMode

Caller-selected retrieval family for repository search.

ServiceError

Service-layer failures.

TokenReport

Typed token-report result returned without transport rendering.

TokenReportRequest

Closed token-report request selected by CLI and MCP adapters.

VcsImpact

Typed VCS availability retained in impact responses.

Constants

COVERAGE_PAGE_MAX_LIMIT

Maximum rows returned by one agent-facing coverage page.

MAX_FEDERATED_DATABASE_BYTES

Maximum total size of participating project databases.

MAX_FEDERATED_INPUT_BYTES

Maximum current source bytes inspected while validating all roots.

Functions

build_file_summary

Build structured file intelligence from the durable index.

build_file_summary_from_source

Build structured file intelligence from caller-verified source bytes.

build_next_report

Build an indexed-metadata recommendation report for the next inspection step.

file_path_matches_glob

Return whether one repository-relative path matches an optional file glob.

file_summary_baseline_text

Serialize the exact file summary payload for token telemetry.

filter_files_by_glob

Filter file nodes through a repository-relative glob.

load_coverage_discovery

Load one bounded opt-in coverage page without starting index work.

load_detailed_relation_page

Load one detailed relation traversal through a stable store snapshot.

load_detailed_relations

Load and compact-fit one detailed relation report for direct library callers.

load_federated_detailed_relations

Load one federated detailed relation page through already verified stores.

load_federated_relation_analysis

Load one federated closed analysis through already verified stores.

load_ranked_file_nodes

Load ranked file nodes and apply the shared repository-relative glob policy.

load_ranked_file_nodes_with_reasons

Load ranked files with concise reasons.

load_ranked_folder_nodes_with_reasons

Load ranked folders with concise reasons.

load_relation_analysis

Load one closed analysis view over the existing bounded relation service.

load_token_report

Load one token report through the selected-project service boundary.

parse_coverage_parser

Parse one public parser/provider coverage filter.

parse_coverage_relation

Parse one public relation-family coverage filter.

parse_coverage_state

Parse one public coverage lifecycle filter.

parse_relation_confidence

Parse one user-facing detailed-relation confidence floor.

parse_relation_direction

Parse one user-facing detailed-relation direction.

parse_relation_resolution

Parse one user-facing detailed-relation resolution filter.

parse_symbol_kind

Parse a user-facing symbol kind selector.

read_indexed_code_slice

Read an exact line slice from an indexed project file.

read_indexed_code_slice_from_source

Read an exact line slice from caller-verified source bytes.

read_indexed_code_slice_from_source_bounded

Read a byte-bounded exact line slice from caller-verified source bytes.

read_symbol_slice

Read a symbol body by exact symbol name and optional disambiguators.

read_symbol_slice_from_source

Read a symbol body from caller-verified source bytes.

read_symbol_slice_from_source_bounded

Read a byte-bounded symbol body from caller-verified source bytes.

search_indexed_files

Search indexed project files with bounded source reads and globset filters.

search_indexed_files_with_control

Search indexed project files through one bounded, cancellable retrieval request.

validate_federated_root_count

Validate the explicit root count before an adapter opens any database.

Type Aliases

ServiceResult

Convenient result alias for service operations.