Crate projectatlas_core

Expand description

Purpose: Define ProjectAtlas 3 core domain models and shared helpers.

Re-exports§

graph: Typed, project-qualified repository graph contracts.
health: Purpose: Detect structural health issues in ProjectAtlas indexes.
index_work: Cooperative cancellation and failure contracts for bounded index work.
language: Purpose: Own deterministic language capability and detection truth.
optional_parser_pack: Validated accepted-capability manifest for the optional native parser pack.
optional_parser_protocol: Closed, bounded wire contract between the parser supervisor and resident workers.
outline: Purpose: Build compressed file outlines for agent context.
relation_capabilities: Own the accepted relation-family inventory and its content-free projections.
support_catalog: Own the fixed complete-support schema and public ecosystem catalog projections.
symbols: Purpose: Define ProjectAtlas symbol graph domain types.
telemetry: Purpose: Track ProjectAtlas token savings telemetry.
toon: Purpose: Render ProjectAtlas responses with the TOON standard encoder.

IndexGeneration: Monotonic identity of one completely published derived index.
IndexedNode: A node with attached purpose state.
NavigationNextCall: Directly reusable next navigation call for one ranked row.
Node: Repository node stored in the ProjectAtlas index.
Overview: Overview returned by startup/overview commands.
Purpose: Purpose metadata attached to a node.
PurposeReviewSignal: Review signal used by agent-facing purpose curation queues.
RankedConnection: One bounded high-value connection sampled for a ranked node.
RankedConnectionCount: Bounded count metadata for one connection family.
RankedNode: A ranked node with concise evidence for why it was selected.

CoreError: Core error type for ProjectAtlas domain operations.
NavigationNextCapability: Existing navigation capability recommended after one ranked row.
NodeKind: File or folder node kind.
PurposeReviewPriority: Agent-facing priority for purpose curation.
PurposeSource: Source for purpose metadata.
PurposeStatus: Status for purpose metadata.
RankedConnectionDirection: Direction of one sampled relationship relative to the ranked node.
RankedConnectionKind: Closed connection families exposed by folder and file navigation rows.
RankedConnectionTarget: Compact typed target for a sampled ranked-node connection.
RankedReasonCode: Compact deterministic reasons used by agent-facing repository ranking.

AGENT_REVIEWED_SOURCE_VALUES: Stored purpose source values that represent reviewed agent-owned purposes.
HIGH_IMPACT_FILE_NAMES: File names that belong in default file-purpose curation.
HIGH_IMPACT_PATH_PREFIXES: Path prefixes that belong in default file-purpose curation.
HIGH_IMPACT_PATH_SEGMENTS: Path segments that belong in default file-purpose curation.
LEGACY_HUMAN_PURPOSE_SOURCE: Legacy stored source value used by older approved human-curated purposes.

is_high_impact_file_path: Return whether a file path is important enough for default purpose curation.
normalize_native_path_display: Normalize a native filesystem path for stable diagnostics and metadata.
normalize_native_path_display_str: Normalize a native filesystem path string for stable diagnostics and metadata.
normalize_repo_path: Convert an absolute path into a stable repository-relative slash path.
normalize_repo_path_prefix: Normalize a repository-relative path prefix used by query filters.
normalized_extension: Return a normalized extension for indexing.
normalized_parent: Return the parent path for a normalized repository path.
purpose_review_signal: Return the purpose-curation review signal for an indexed node.
repo_path_to_native: Convert a stable slash-separated repository key into a native path.
validated_repo_file_key: Normalize and validate a user-supplied path as a repository-relative file key.
validated_repo_node_key: Normalize and validate a user-supplied path as a repository-relative node key.