forge-memory-bridge 0.1.1

Transform Forge export envelopes into projection import batches for semantic-memory
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! # forge-memory-bridge
//!
//! Transforms Forge export envelopes into projection
//! import batches for consumption by
//! `semantic-memory`'s projection importer.
//!
//! ## Authority boundary
//!
//! This crate owns the **transformation** from Forge's export vocabulary to
//! memory's import vocabulary. It does NOT:
//! - evaluate comparability or decide promotion,
//! - guess missing semantics from live memory,
//! - become a query service,
//! - persist any state of its own.
//!
//! ## Phase status: current / implemented now

mod batch;
mod error;
#[allow(deprecated)]
mod legacy;
mod transform;

pub use batch::*;
pub use error::{
    BridgeError, BridgeImportFailureArtifact, BRIDGE_IMPORT_FAILURE_ARTIFACT_V1_SCHEMA,
};
pub use transform::*;

/// Compatibility-only legacy bridge helpers.
///
/// The canonical path is `ExportEnvelopeV3` -> `transform_envelope_v3()` ->
/// `ProjectionImportBatchV3`.
/// V1/V2 helpers remain only for migration compatibility and should not be
/// used for new integrations.
///
/// Phase status: migration-only
/// Removal condition: remove when all consumers have migrated to `transform_envelope_v3()` + `ProjectionImportBatchV3`
#[doc(hidden)]
#[deprecated(
    since = "0.2.0",
    note = "Legacy bridge helpers are compatibility-only. Use `transform_envelope_v3()` + `ProjectionImportBatchV3`."
)]
#[allow(deprecated)]
pub mod compat {
    pub use crate::legacy::{
        transform_legacy_envelope, upgrade_legacy_envelope, LegacyEpisodeMeta,
        LegacyImportEnvelopeV1, LegacyImportRecord,
    };
}

/// Phase status: migration-only
/// Removal condition: remove when all consumers have migrated to `transform_envelope_v3()` + `ProjectionImportBatchV3`
#[deprecated(
    since = "0.1.0",
    note = "Legacy bridge helpers are compatibility-only. Use `transform_envelope_v3()` + `ProjectionImportBatchV3`."
)]
#[doc(hidden)]
#[allow(deprecated)]
pub use compat::transform_legacy_envelope;
/// Phase status: migration-only
/// Removal condition: remove when all consumers have migrated to `transform_envelope_v3()` + `ProjectionImportBatchV3`
#[deprecated(
    since = "0.1.0",
    note = "Legacy bridge helpers are compatibility-only. Use `transform_envelope_v3()` + `ProjectionImportBatchV3`."
)]
#[doc(hidden)]
#[allow(deprecated)]
pub use compat::upgrade_legacy_envelope;
/// Phase status: migration-only
/// Removal condition: remove when all consumers have migrated to `transform_envelope_v3()` + `ProjectionImportBatchV3`
#[deprecated(
    since = "0.1.0",
    note = "Legacy bridge helpers are compatibility-only. Use `transform_envelope_v3()` + `ProjectionImportBatchV3`."
)]
#[doc(hidden)]
#[allow(deprecated)]
pub use compat::LegacyEpisodeMeta;
/// Phase status: migration-only
/// Removal condition: remove when all consumers have migrated to `transform_envelope_v3()` + `ProjectionImportBatchV3`
#[deprecated(
    since = "0.1.0",
    note = "Legacy bridge helpers are compatibility-only. Use `transform_envelope_v3()` + `ProjectionImportBatchV3`."
)]
#[doc(hidden)]
#[allow(deprecated)]
pub use compat::LegacyImportEnvelopeV1;
/// Phase status: migration-only
/// Removal condition: remove when all consumers have migrated to `transform_envelope_v3()` + `ProjectionImportBatchV3`
#[deprecated(
    since = "0.1.0",
    note = "Legacy bridge helpers are compatibility-only. Use `transform_envelope_v3()` + `ProjectionImportBatchV3`."
)]
#[doc(hidden)]
#[allow(deprecated)]
pub use compat::LegacyImportRecord;