Module migration 

One-way import of the pre-view semantic snapshot format.

The importer deliberately leaves semantic.bin untouched until a complete manifest is visible. A caller can therefore roll back by removing the view directory and continue to use the legacy snapshot.

Configure maintenance calls import_legacy_semantic once when views are enabled, the checkout owns shared artifact writes, and no manifest exists. Admission uses the shared cold-build limiter and runs after the configure acknowledgement. The importer reads the whole snapshot, then re-reads and hashes every eligible source row before writing compatible rows, so its cost scales with the corpus. A RebuildRequired outcome records migration-state.json; later attempts observe that marker rather than repeatedly scheduling the same rebuild.

Structs

SemanticMigrationReport

Observable result of a semantic migration attempt.

SemanticMigrationRequest

Input for importing the semantic snapshot that predates view assembly.

Enums

CallgraphMigrationOutcome

Whether the existing staged callgraph build had to do cold work.

MigrationError

Errors returned before a migration has a terminal report.

SemanticMigrationOutcome

Terminal classification of one import attempt.

Functions

import_legacy_semantic

Imports an eligible root’s old semantic.bin without making embedding requests.

rebuild_legacy_callgraph_once

Runs the existing staged cold callgraph build exactly when no usable store exists. A later rebind opens the published store and returns CallgraphMigrationOutcome::AlreadyCurrent.