Module projection_import 

V10 legacy projection import boundary.

Phase status: compatibility / migration-only

This module provides the legacy (V10) import path. It remains functional for backward compatibility during the migration cycle but is not the canonical import path for new integrations.

Canonical path: Use MemoryStore::import_projection_batch() (V11+), which accepts ProjectionImportBatchV3 output from forge-memory-bridge. ProjectionImportBatchV2 remains a compatibility-normalized import shape.

Removal condition: This module and its types (ImportEnvelope, ImportRecord, import_envelope()) will be removed once all callers have migrated to the bridge pipeline. The V10 import_log table is retained read-only for audit after removal.

Authority boundary

semantic-memory owns queryable knowledge persistence. This module accepts already-interpreted projection inputs and writes them atomically. It does NOT interpret raw verification data, decide promotion policy, or contain Forge-specific transformation logic.

Import semantics

• Atomic per envelope: all records in an envelope are committed together or not at all.
• Idempotent: re-importing the same envelope (identified by envelope_id + schema_version + content_digest) is a safe no-op.
• No partial visibility: if any record fails, the entire envelope is rolled back.
• Provenance preserved: every imported record carries envelope metadata in its JSON metadata for traceability.

Structs

EnvelopeId

Opaque identifier for an import/export envelope.

ImportEnvelope

An import envelope containing projection records to be atomically ingested.

ImportReceipt

Receipt confirming the outcome of an import attempt.

Enums

ImportProjectionFreshness

Freshness/lifecycle status for imported projections.

ImportRecord

A single record within an import envelope.

ImportStatus

Lifecycle status of an import.