Module storage 

Storage contracts and SQLite-backed graph state.

Storage owns persisted graph facts, mutation log entries, derived index metadata, and health snapshots. Domain and interface modules must not depend on SQL or concrete database types.

Re-exports

pub use crate::domain::IndexCursor;

pub use crate::domain::IndexLag;

pub use crate::domain::IndexRefreshDiagnostics;

pub use crate::domain::IndexStalenessReason;

Structs

AuditQueryRequest

Audit query filter.

CodeChunkSearchRequest

Bounded code chunk search against an explicit graph snapshot.

CodeImpactChanges

Diff-derived inputs used to seed code impact expansion.

CodeIndexPublicationTarget

Durable task target whose already-complete publication may be adopted by a later fenced attempt without rebuilding code or software facts.

CodeIndexTaskClaimRequest

Lease acquisition request for one background code index task.

CodeIndexTaskCompletion

Completion report guarded by task lease and attempt token.

CodeIndexTaskFailure

Failure report for retry and dead-letter handling.

CodeIndexTaskLeaseRecord

Active code-index task lease used by service startup recovery.

CodeIndexTaskLeaseRecovery

Recovery request carrying the exact running leases observed as orphaned.

CodeIndexTaskLeaseRenewal

Strict renewal request for one still-live fenced code-index attempt.

CodeIndexTaskSeed

New background code index task to persist or deduplicate.

CodeReferenceSearchRequest

Bounded code reference search against an explicit graph snapshot.

CodeRepositorySetEdgeSelector

Bounded repository-set overlay keys needed to decorate retrieval candidates.

CodeRepositorySetMemberSeed

New or replaced repository-set member pointer.

CodeRepositorySetRefreshPublication

Attempt-scoped authority required to publish a repository-set overlay.

CodeRepositorySetRefreshTaskClaimRequest

Lease acquisition request for one repository-set overlay task.

CodeRepositorySetRefreshTaskCompletion

Completion report guarded by task lease and attempt token.

CodeRepositorySetRefreshTaskFailure

Failure report for retry and dead-letter handling.

CodeRepositorySetRefreshTaskSeed

Repository-set overlay refresh task to persist or deduplicate.

CodeRepositorySetSeed

New repository set metadata to persist.

CodeScopeRetentionRequest

Scope retention request after a repository index completes.

CodeSymbolSearchRequest

Bounded code symbol search against an explicit graph snapshot.

FileContentChunk

Text chunk extracted from an authorized local file.

FileContentEntry

Content read-model record produced by a bounded scan.

FileContentReadModelCursor

Scoped derived cursor state for one file-content read-model input.

FileContentSearchHit

One file-content search hit with provenance and prompt-role isolation.

FileContentSearchRequest

Bounded file-content query.

FileIndexDiagnostics

Aggregated file-index diagnostics.

FileIndexEntry

Indexed file-location record produced by a bounded scan.

FileIndexRoot

Authorized root scanned by the local file indexer.

FileIndexRootStatus

Root-level status surfaced to health and service diagnostics.

FileIndexRootUpdate

Full-root replacement produced by one scan pass.

FileIndexScanSummary

Summary returned after one or more roots are indexed.

FileKnowledgeFactCandidate

Deterministic candidate fact extracted from file content.

FileSearchHit

One file-location search hit.

FileSearchRequest

Bounded file-location query.

GraphCanvasStorageEdge

Storage edge projected into the Web graph canvas contract.

GraphCanvasStorageNode

Storage node projected into the Web graph canvas contract.

GraphCanvasStorageRequest

Bounded graph canvas request against an explicit graph snapshot.

GraphCanvasStorageSnapshot

Bounded storage snapshot for one graph canvas view.

GraphInspection

Aggregated graph status for diagnostics.

GraphSearchOutcome

Search hits plus the bounded traversal trace that produced them.

GraphSearchRequest

Bounded graph search request against an explicit graph snapshot.

HealthStorageSnapshot

Read-only storage view used by service health without mutating indexes.

IndexRefreshClaimRequest

Lease acquisition request for bounded foreground workers.

IndexRefreshCompletion

Completion report guarded by the active task lease and attempt token.

IndexRefreshFailure

Failure report for retry backoff and dead-letter isolation.

IndexRefreshQueueRequest

Queue request created by refresh APIs or the reconciler.

IndexRefreshTask

Persistent task used by foreground refresh and startup recovery.

MutationLogEntry

Mutation log entry returned for replay and index refresh planning.

NewAuditEvent

New durable audit event.

NewProposal

New proposal to persist before manual approval.

NewProposalConflict

New proposal conflict to persist with a proposal.

PartitionedSqliteKnowledgeStore

SQLite topology that keeps global control state in one DB and code facts in one DB per registered repository.

ProposalDecision

Proposal decision request.

ProposalListRequest

Proposal list filter.

ServiceOperatorUpdate

Service operator state update.

SqliteGraphStore

SQLite implementation of graph facts, mutation log, and index metadata.

SqliteStorageDiagnostics

SQLite-specific health data included in shared graph diagnostics.

StorageHealth

Storage health surfaced to diagnostics.

StorageShardCatalogEntry

One repository shard entry from the partitioned SQLite catalog.

StorageTopologySnapshot

Runtime storage topology snapshot surfaced through service diagnostics.

WorkerTaskClaimRequest

Worker lease acquisition request.

WorkerTaskCompletion

Worker completion guarded by the active lease.

WorkerTaskFailure

Worker failure report for retry and dead-letter handling.

WorkerTaskSeed

Worker task input inserted after graph changes or service reconciliation.

Enums

CodeIndexFinalizationStep

Result of advancing one durable code-index finalization writer quantum.

GraphCanvasSelection

Storage-level graph canvas selection without depending on Web API types.

IndexRefreshTaskState

Persistent index refresh task lifecycle state.

StorageError

Storage boundary failure.

StorageTopology

Storage topology selected at runtime.

Constants

CODE_INDEX_FINALIZATION_COARSE_PHASE_COUNT

Stable coarse states in the durable code-index finalization plan.

CODE_INDEX_FINALIZATION_MAX_STEPS

Hard bound for missing index units, coarse phases, and terminal observation.

CODE_INDEX_TASK_LEASE_RECOVERY_UNAVAILABLE

Default error text for stores that do not support code task lease recovery.

CODE_INDEX_TASK_LEASE_RENEWAL_UNAVAILABLE

Default error text for stores that do not support code task lease renewal.

DEFAULT_INDEX_SOURCE_SCOPE

Synthetic scope used for graph-wide index work that is not tied to evidence.

MAX_GRAPH_SEARCH_FTS_CODEPOINTS

Conservative tokenizer-work bound when Unicode category rules split a phrase.

MAX_GRAPH_SEARCH_FTS_TOKENS

Maximum lexical terms admitted to the FTS5 query builder.

MAX_GRAPH_SEARCH_LIMIT

Maximum candidate limit accepted by the SQLite graph-search implementation.

MAX_GRAPH_SEARCH_QUERY_CHARS

Maximum Unicode scalar values accepted by every graph-search adapter.

MAX_GRAPH_SEARCH_TOKEN_BYTES

Maximum UTF-8 bytes in one lexical term admitted to FTS5.

Traits

BusinessKnowledgeStore

Repository-scoped business projection writes and immutable indexed reads.

CodeGraphStore

Code graph fact persistence and query contract for tree-sitter output.

CodeIndexPublicationStore

Checkpointed snapshot, batch, workspace, and final publication capability.

CodeIndexSourceStore

Bounded indexed-source reads used by incremental planning and fallbacks.

CodeIndexTaskStore

Durable task queue, attempt lease, retry, and completion capability.

CodeQueryReadStore

Snapshot-scoped code retrieval, impact, report, and view read capability.

CodeRepositorySetStore

Repository-set membership, overlay, and refresh-task capability.

CodeRepositoryStore

Compatibility facade that combines all persisted code repository capabilities. New workflows depend on the narrow capability they consume.

CodeScopeRetentionStore

Scope and whole-repository retention planning and execution capability.

FrameworkGraphStore

Read-only framework graph capabilities shared by repository stores.

GraphStore

Graph fact persistence and query contract.

IndexStore

Derived index metadata and operational persistence contract.

KnowledgeStore

Combined storage facade used by the application service.

KnowledgeStoreFactory

Configured outer-layer factory used for lazy storage initialization.

MutationLogStore

Mutation log contract consumed by reconcilers and indexers.

RepositoryCatalogStore

Repository registration, lookup, and lifecycle capability.

SoftwareProjectionStore

Software graph projection refresh and snapshot read capability.

Functions

code_index_finalization_max_steps

Derives the hard finalization quantum bound including worst-case byte-limited reference resolution plus reference-search cleanup, group discovery, and build pages.

Type Aliases

KnowledgeStoreFactoryFuture

Async result returned by a configured storage factory.

StorageFuture