Crate projectatlas_db 

Purpose: Persist ProjectAtlas 3 indexes in SQLite.

Modules

sqlite_progress_test_observer

Deterministic observation of production SQLite progress boundaries for downstream tests.

Structs

AtlasStore

SQLite-backed ProjectAtlas index store.

CapturedProjectBinding

Root and project identity captured when one store binding was validated.

DatabaseCoverageSample

One content-free project-scope graph coverage row.

DatabaseCoverageSummary

One bounded project-scope graph coverage sample with honest total state.

DatabaseOperatingProfileReport

Required and observed database connection and maintenance policy.

DatabasePublicationReport

Content-free active publication identity for settings diagnostics.

DatabaseSchemaReport

Content-free schema and migration state.

DatabaseSettingsReport

Bounded content-free database state for CLI and MCP settings projection.

DerivedGraphSnapshot

Integrity-checked, project-independent graph snapshot.

DerivedGraphSnapshotImport

Result of one normal projection publication from a portable snapshot.

DerivedGraphSnapshotMetadata

Portable snapshot metadata that contains no project or machine identity.

DerivedSnapshotContent

Exact portable columns and row count exported from one derived owner.

FileTextFtsCandidate

One FTS-ranked candidate carrying only authoritative persisted metadata.

FileTextFtsPage

Bounded FTS candidate page for service-owned exact verification.

FileTextFtsQuery

Bounded safe-token request for FTS candidate acceleration.

FileTextFtsState

Content-free synchronization state for the rebuildable FTS projection.

FileTextMetadata

Persisted file metadata available before source-content decoding.

HealthFindingsPage

Bounded health findings page returned by the database layer.

HealthQuery

Bounded health query used by agent-facing adapters.

HealthResolution

Agent-approved resolution for a deterministic health finding.

IndexPublication

Persisted state needed to reject mixed or incompatible derived projections.

IndexPublicationGuard

Exclusive parent-owned atomic publication over all derived projections.

IndexedFileText

UTF-8 source text persisted for indexed search.

ProjectRootTransitionResult

Result of one completed root transition.

PurposeConditionalApplyRequest

One stale-safe purpose approval copied from a queue item.

PurposeConditionalApplyResult

Per-item outcome from one atomic conditional purpose-review batch.

PurposeCurationBatch

Bounded purpose-curation work selected from one project generation.

PurposeCurationCandidate

One unapproved purpose row bound to deterministic curator work.

RepositoryAffectedSourceFootprint

Conservative persisted footprint owned by exact affected source paths.

RepositoryCoverageQuery

Bounded filters for opt-in project-wide coverage discovery.

RepositoryCoverageRow

One discovered coverage row with parse and fact-provider provenance.

RepositoryGraphAdjacencyContinuation

Opaque keyset used only to continue one bounded adjacency request.

RepositoryGraphAdjacencyPage

One bounded direction-specific adjacency page.

RepositoryGraphAdjacencyReadPage

One bounded adjacency page plus exact database work for the page attempt.

RepositoryGraphAdjacencyRow

One logical relation paired with the frontier entity that selected it.

RepositoryGraphPage

One bounded page of typed normalized graph rows.

RepositoryGraphReadBatch

Fully reconstructed graph rows plus their exact bounded read work.

RepositoryGraphReadBudget

Validated resource envelope for one bounded repository-graph database read.

RepositoryGraphReadPage

One stable paged graph result plus exact database work for the page attempt.

RepositoryGraphReadPages

Ordered per-owner graph pages plus exact aggregate database work.

RepositoryGraphReadWork

Exact work observed while hydrating one stable-key graph batch.

RepositoryGraphRelationRow

One normalized relation with the endpoint entities already hydrated.

RepositoryGraphStagingGuard

Disposable typed repository-graph writer used before main index publication.

RepositoryNavigationConnections

Bounded current graph evidence for one folder or file navigation row.

RepositoryNavigationNode

One folder or file whose current graph context should enrich navigation.

RepositoryResolutionCandidate

One persisted export candidate paired with the canonical key that selected it.

SqliteCompileOptionsIdentity

Deterministic fixed-size identity of the active SQLite compile options.

SqliteRuntimeReport

Content-free identity of the linked SQLite runtime.

StoredImportRelation

Lightweight persisted import fact used by alias resolution.

SymbolBatchRead

Bounded symbols and truncation state returned for exact paths.

SymbolBatchReadBudget

Typed database envelope for one exact-path symbol batch.

SymbolBatchReadWork

Exact work retained by one bounded symbol batch read.

TelemetryRetentionPolicy

Retention limits for telemetry inside one authoritative database.

TelemetryRetentionState

Content-free retention and page-lifecycle state.

Enums

DatabaseCoverageTotalState

Whether a bounded coverage total is exact or a lower bound.

DatabaseFilesystemSupport

WAL suitability of the selected database filesystem.

DatabasePublicationContractState

Validation state of persisted publication-contract identity metadata.

DatabaseSchemaCompatibility

Compatibility of the selected database with the current runtime.

DbError

Database-layer error type.

FileTextAdmission

Service decision made before one fallback row decodes source content.

HealthScope

Scope controls for bounded health and purpose-curation queries.

IndexPublicationState

Durable state of the multi-projection derived index publication.

PlannerStatisticsPolicy

Planner-statistics maintenance policy currently owned by ProjectAtlas.

PlannerStatisticsState

Availability of SQLite planner statistics in the selected database.

ProjectRootTransition

Explicit root-binding behavior selected by a caller.

PurposeConditionalApplyState

Result of applying a purpose through the stale-safe curator path.

RepositoryGraphDirection

Direction of one batched normalized-graph adjacency read.

RepositoryGraphRelationQuery

Closed relation lookup shapes owned by normalized graph storage.

SpillCleanupState

Spill cleanup state for the selected storage design.

SymbolBatchReadLimit

Closed database limits that can truncate an exact-path symbol batch.

TelemetryCheckpointState

Persisted passive-checkpoint lifecycle state.

Constants

MAX_DERIVED_SNAPSHOT_JSON_BYTES

Maximum encoded JSON accepted before deserialization.

MAX_FILE_TEXT_FTS_CANDIDATES

Maximum FTS candidates decoded for one exact-verification request.

MAX_PURPOSE_CURATION_BATCH_ROWS

Maximum paths admitted to one purpose-curation hydration statement.

MAX_REPOSITORY_GRAPH_FRONTIER

Maximum unique entities admitted to one batched adjacency statement.

MAX_SYMBOL_BATCH_DECODED_BYTES

Maximum decoded symbol bytes admitted to one bounded hydration request.

MAX_SYMBOL_BATCH_PATHS

Maximum exact paths admitted to one bounded symbol hydration request.

MAX_SYMBOL_BATCH_ROWS

Maximum symbol rows admitted to one bounded hydration request.

Functions

database_settings_report

Build bounded content-free database settings without creating, migrating, or repairing state.

read_project_root_read_only

Read the recorded project root without creating or migrating a database.

validate_database_location

Validate the database location without creating its parent or opening SQLite.

verify_project_database

Verify the current project database schema, identity, and full integrity read-only.

Type Aliases

DbResult

Convenient result alias for database operations.