Module domain 

Pure domain model types.

Structs

AuditEventRecord

Redacted durable audit event.

ClaimRecord

Claim fact extracted from or supported by evidence.

CodeCallRecord

Call relationship extracted from code.

CodeChunkRecord

Versioned retrievable code chunk.

CodeDependencyRecord

Dependency declaration extracted from package manager manifest or lock files.

CodeExtractionMetadata

Tree-sitter query metadata attached to extracted code facts.

CodeFeatureFlagGraph

Feature flag graph grouped by stable configuration source.

CodeFeatureFlagRecord

Feature flag or runtime configuration relationship extracted from code.

CodeFeatureFlagRequest

Feature-flag graph query over an indexed repository scope.

CodeFeatureFlagUsage

One code location where a feature flag is defined, read, or guards code.

CodeFileDiagnostic

File-level diagnostic produced by indexing.

CodeFileFields

Input fields for one parsed repository file.

CodeFileFingerprint

Previously indexed file hash used to skip unchanged incremental parses.

CodeFileRecord

Parser output for one repository file.

CodeGraphArtifact

Code graph artifact tied to a shared retrieval result.

CodeGraphBatch

Atomic code graph mutation batch.

CodeGraphCommitReceipt

Receipt returned after code graph facts commit.

CodeImpactPathGroups

Diff paths split by the effective repository selector.

CodeImpactRequest

Code impact analysis request over a Git diff.

CodeImportRecord

Import relationship extracted from code.

CodeIndexBatch

One bounded parse result committed under a checkpointed index session.

CodeIndexCheckpoint

Durable progress checkpoint for a repository indexing session.

CodeIndexProgressSummary

Coarse phase timing and counts reported by repository indexing.

CodeIndexRequest

Code repository indexing request shared by interfaces.

CodeIndexResourceBudget

Resource budget used to partition repository indexing into bounded batches.

CodeIndexSession

Stable metadata for one resumable repository indexing session.

CodeIndexSnapshot

Parsed index changes ready to commit into storage.

CodeIndexSummary

Result of applying a code index snapshot.

CodeIndexTaskRecord

Durable background task for one code repository index request.

CodeParseStatusCounts

Parse-status counts surfaced by graph diagnostics.

CodePathTombstone

Rename/delete lineage marker retained after incremental updates.

CodeRange

Inclusive source line range and half-open byte range in a repository file.

CodeReferenceFields

Input fields for a syntax-level reference.

CodeReferenceRecord

Versioned syntax-level reference or dependency edge candidate.

CodeRepositoryCrossEdge

Cross-repository overlay edge derived after member snapshots are indexed.

CodeRepositoryExcludedPath

Path excluded from indexing by preset, ignore file, or request scope.

CodeRepositoryLanguagePreview

Language bucket in a repository scope preview.

CodeRepositoryLargestFile

Large file surfaced before a full repository index starts.

CodeRepositoryLatencySample

Representative query latency captured for an operations report.

CodeRepositoryRegistration

Code repository identity persisted after registration.

CodeRepositoryReport

Reusable repository operations report.

CodeRepositoryScopePreview

Non-mutating preview of the effective repository indexing scope.

CodeRepositorySelector

Repository selector accepted by code index and retrieval APIs.

CodeRepositorySet

Persisted repository-set metadata.

CodeRepositorySetAddMemberRequest

Request to attach one indexed repository snapshot to a repository set.

CodeRepositorySetCreateRequest

Repository-set creation request shared by API adapters.

CodeRepositorySetMember

Persisted repository-set membership pointing at a real repository snapshot.

CodeRepositorySetMemberStatus

Status for one repository-set member snapshot.

CodeRepositorySetOverlayStatus

Overlay freshness and task-independent diagnostics.

CodeRepositorySetQueryHit

Query hit with explicit repository-set provenance.

CodeRepositorySetQueryRequest

Multi-repository query request.

CodeRepositorySetRefreshSummary

Summary returned after rebuilding a repository-set overlay.

CodeRepositorySetRefreshTaskRecord

Durable repository-set overlay refresh task record.

CodeRepositorySetRemoveMemberRequest

Request to remove one repository snapshot from a repository set.

CodeRepositorySetStatus

Aggregated repository-set status.

CodeRepositoryStatus

Repository index status and diagnostics summary.

CodeRepositoryTotals

Aggregated totals for repository indexes separate from graph-evidence code rows.

CodeRetrievalHit

Code retrieval hit with source location, layers, and freshness metadata.

CodeRetrievalRequest

Code repository retrieval request.

CodeScopeRetentionSummary

Scope retention result after pruning old repository snapshots.

CodeSymbolRecord

Versioned syntax-level symbol definition.

CommitReceipt

Receipt returned after graph facts and mutation log entries commit.

ConfidenceScore

Confidence score in basis points so it remains sortable and exact.

ContextEntity

Entity projection retained with each context item.

ContextGraphFact

Structured relation, claim, or event that supports a retrieval hit.

ContextGraphPath

Direct graph path evidence derived from a structured graph fact.

ContextGraphPathEdge

One edge in a graph path returned through the context pack.

ContextPackItem

Context-pack item tied to a retrieval hit.

DomainError

Domain-level validation failure.

EventRecord

Event fact tied to entities and optional valid-time text.

EvidenceExtractionMetadata

Metadata shared by text, image, OCR, caption, table, layout, and embedding evidence.

EvidenceRecord

Evidence accepted by the graph mutation pipeline.

EvidenceSpan

Source byte and line span for evidence-backed facts.

ExtractionDiagnostic

Diagnostic emitted by an extractor without blocking other modalities.

FusionDiagnostics

Diagnostics for reciprocal-rank fusion.

GraphMutationBatch

A transactional graph mutation unit.

GraphRelationRecord

Typed relation between graph entities.

GraphVersion

Monotonic graph state version.

GraphVersionRange

Graph-version validity range for facts.

IndexStatus

Versioned status for a derived index.

KnowledgeEntity

A minimal entity model used by early graph-building code.

KnowledgeMap

Versioned repository contract that tells agents where project knowledge lives.

KnowledgeMapChange

Optional source changes accepted by the update command.

KnowledgeMapHistoryEntry

Version history entry written after CLI mutations.

KnowledgeMapRoute

Ordered source route for a topic.

KnowledgeMapSource

Addressable knowledge source that remains authoritative outside the map.

KnowledgeMapTopic

Human-readable topic bucket used by agents for routing.

LayoutRegion

Page-space rectangle for table and layout evidence.

ProposalConflictRecord

Stored conflict associated with a proposal.

ProposalProvenance

Auditable model, prompt, and source lineage for a stored proposal.

ProposalRecord

Stored proposal ready for CLI/Web review.

RankingSignal

Per-retriever ranking signal preserved after fusion.

RepositoryCodeChunkRecord

Searchable code chunk.

RepositoryCodeFileRecord

File-level code index row.

RepositoryCodeRange

Inclusive byte or line range for repository code index rows.

RepositoryCodeReferenceRecord

Reference extracted from tree-sitter syntax and optionally resolved.

RepositoryCodeSymbolRecord

Symbol definition extracted from tree-sitter syntax.

RerankDiagnostics

Diagnostics for post-fusion reranking.

RerankModeError

Invalid rerank backend mode supplied by runtime configuration.

RerankSignal

Final rerank signal applied after hybrid retrieval fusion.

RetrievalBackendStatus

Per-backend status preserved so callers can distinguish fallback from complete hybrid retrieval.

RetrievalBudgetUsed

Budget actually consumed by retrieval context packing.

RetrievalHit

A context item returned by retrieval.

RetrievedContextPack

A compact, auditable context pack for agent and UI adapters.

ServiceDefinitionPlan

Service definition rendering without privileged execution.

ServiceOperatorStatus

Persisted silent-update operator status.

SoftwareBuildTarget

Build target, script, profile, or generator entry projected from indexed repository evidence.

SoftwareBuildTargetInput

Constructor input for SoftwareBuildTarget.

SoftwareComponent

Projected dependency component from repository manifests and lockfiles.

SoftwareComponentInput

Constructor input for SoftwareComponent.

SoftwareDependencyUsage

Import/include evidence that uses a declared dependency component.

SoftwareDependencyUsageInput

Constructor input for SoftwareDependencyUsage.

SoftwareDesignElement

Design, architecture, module, component, interface, or capability evidence.

SoftwareDesignElementInput

Constructor input for SoftwareDesignElement.

SoftwareFile

Projected repository file node for the software global model.

SoftwareFileInput

Constructor input for SoftwareFile.

SoftwareGlobalProjection

Projected software global facts for one repository scope.

SoftwareGlobalRequest

Repository-scoped software global model query.

SoftwareGlobalStatus

Freshness and count summary for the software global projection.

SoftwareIacResource

Infrastructure, deployment, or service-operation resource projected from indexed IaC evidence.

SoftwareIacResourceInput

Constructor input for SoftwareIacResource.

SoftwareRelationship

Cross-domain relationship between projected software files, topics, components, and usages.

SoftwareRelationshipInput

Constructor input for SoftwareRelationship.

SoftwareSdkUsage

Projected SDK or external API usage from unresolved import/include evidence.

SoftwareSdkUsageInput

Constructor input for SoftwareSdkUsage.

SoftwareTopic

Topic extracted from repository documentation or the repository knowledge map.

SoftwareTopicInput

Constructor input for SoftwareTopic.

SourceScope

Authorized source boundary for evidence and retrieval.

WorkerStatus

Aggregated status for a worker family.

WorkerTaskRecord

Persistent worker task used by service, CLI, Web, and recovery diagnostics.

Enums

AuditStatus

Persistent audit status shared by CLI/Web/service/agent surfaces.

CodeGraphArtifactKind

Code artifact category returned through the general GraphRAG context pack.

CodeIndexMode

Code index mode tied to Git snapshots or diffs.

CodeIndexTaskState

Persistent lifecycle for background code repository index tasks.

CodeParseStatus

Parser status for a repository file at a graph version.

CodeQueryKind

Retrieval query kind for code graph and lexical search.

CodeReferenceKind

Reference category extracted from tree-sitter captures.

CodeRepositorySetRefreshTaskState

Durable state for a repository-set overlay refresh task.

CodeResolutionState

Resolution certainty for syntax-level code references.

CodeRetrievalLayer

Retrieval layer that contributed to a code hit.

CodeSymbolKind

Symbol definition category extracted from tree-sitter captures.

ContextGraphFactKind

Structured graph fact kind referenced from a context item.

EvidenceModality

Evidence media unit tracked by multimodal ingestion and retrieval.

ExtractionStatus

Extraction outcome recorded when multimodal workers degrade or fail.

FactStatus

Lifecycle status for graph facts created from evidence or extraction.

FreshnessPolicy

Freshness policy for hybrid retrieval.

IndexKind

Derived index families maintained from the graph mutation log.

IndexModality

Source modality covered by a derived index cursor.

IndexState

Operational state of a derived index.

KnowledgeMapSourceKind

Supported source category labels in the YAML contract.

ProposalConflictSeverity

Conflict severity shown before manual approval.

ProposalKind

Proposal fact family stored before user approval.

ProposalState

Proposal approval lifecycle.

RerankMode

Rerank backend requested for the hybrid retrieval candidate set.

RetrievalBackendState

Availability state for optional retrieval backends.

RetrievalMode

Retrieval path used to satisfy a query.

RetrieverSource

Retrieval source that contributed to a fused context result.

ServiceManagerAction

Service manager action surfaced as a generated, user-executed plan.

ServiceOperatorState

Installed background operator state.

SoftwareGlobalKind

Query kind for repository-scoped software global model facts.

WorkerBackendState

Runtime availability of an external worker backend.

WorkerKind

External or fallback worker family used by background productization tasks.

WorkerTaskState

Persistent task lifecycle for bounded worker queues.

Constants

RECIPROCAL_RANK_FUSION_K

RRF constant used by Phase 1 hybrid retrieval.

Functions

code_snapshot_expected_scope_id

code_snapshot_scope_id

Builds the stable source scope id for a Git snapshot partition.

normalize_actor

Normalizes a required actor identifier for lifecycle decisions.