Merge pull request #589 from AdaWorldAPI/claude/medcare-bridge-lance-graph-wmx76z

docs+deprecate(bridges): preemptive landing shape for OGAR consumer migration

Author: AdaWorldAPI

crates/lance-graph-consumer-conformance/src/lib.rs

@@ -1,3 +1,8 @@
+// Exercises the deprecated `MedcareBridge` / `OgitBridge` / `WoaBridge`
+// symbols on purpose — this harness IS the conformance gate for them.
+// See `docs/CONSUMER-BRIDGE-DEPRECATION.md`.
+#![allow(deprecated)]
+
 //! `lance-graph-consumer-conformance` — cross-crate registry conformance harness.
 //!
 //! This crate is the CI gate that prevents a consumer crate from shipping a

crates/lance-graph-ogar/src/bridges/medcare_bridge.rs

@@ -33,6 +33,13 @@ use ogar_vocab::ports::PortSpec;
 
 /// MedCare `NamespaceBridge` — alias over the generic harness, locked to
 /// the `Healthcare` namespace via [`HealthcarePort`].
+///
+/// **Deprecated:** pull the classid via the OGAR PortSpec instead —
+/// `ogar_vocab::ports::HealthcarePort::class_id(name)`. See
+/// `docs/CONSUMER-BRIDGE-DEPRECATION.md` + AdaWorldAPI/OGAR#95.
+#[deprecated(
+    note = "pull the classid via `HealthcarePort::class_id(name)` — see AdaWorldAPI/OGAR#95 + docs/CONSUMER-BRIDGE-DEPRECATION.md"
+)]
 pub type MedcareBridge = UnifiedBridge<HealthcarePort>;
 
 /// Canonical namespace name for MedCare / Healthcare. Mirrors
@@ -41,6 +48,7 @@ pub type MedcareBridge = UnifiedBridge<HealthcarePort>;
 pub const NAMESPACE: &str = HealthcarePort::NAMESPACE;
 
 #[cfg(test)]
+#[allow(deprecated)] // exercises the deprecated bridge alias on purpose
 mod tests {
     //! Co-located unit tests for the migrated alias — constructor
     //! success/failure, contract methods, codebook resolution, fallback

crates/lance-graph-ogar/src/bridges/odoo_bridge.rs

@@ -25,12 +25,20 @@ use ogar_vocab::ports::PortSpec;
 
 /// Odoo `NamespaceBridge` — alias over the generic harness, locked to
 /// the `Odoo` namespace via [`OdooPort`].
+///
+/// **Deprecated:** pull the classid via the OGAR PortSpec instead —
+/// `ogar_vocab::ports::OdooPort::class_id(name)`. See
+/// `docs/CONSUMER-BRIDGE-DEPRECATION.md` + AdaWorldAPI/OGAR#95.
+#[deprecated(
+    note = "pull the classid via `OdooPort::class_id(name)` — see AdaWorldAPI/OGAR#95 + docs/CONSUMER-BRIDGE-DEPRECATION.md"
+)]
 pub type OdooBridge = UnifiedBridge<OdooPort>;
 
 /// Canonical namespace name for Odoo. Mirrors `OdooPort::NAMESPACE`.
 pub const NAMESPACE: &str = OdooPort::NAMESPACE;
 
 #[cfg(test)]
+#[allow(deprecated)] // exercises the deprecated bridge alias on purpose
 mod tests {
     use super::*;
     use lance_graph_ontology::bridge::{BridgeError, NamespaceBridge};

crates/lance-graph-ogar/src/bridges/openproject_bridge.rs

@@ -22,6 +22,14 @@ pub use ogar_vocab::ports::OpenProjectPort;
 use ogar_vocab::ports::PortSpec;
 
 /// OpenProject `NamespaceBridge` — alias over the generic harness.
+///
+/// **Deprecated:** pull the classid via the OGAR PortSpec instead —
+/// `ogar_vocab::ports::OpenProjectPort::class_id(name)`. The bridge will
+/// be removed once all consumers migrate. See
+/// `docs/CONSUMER-BRIDGE-DEPRECATION.md` + AdaWorldAPI/OGAR#95.
+#[deprecated(
+    note = "pull the classid via `OpenProjectPort::class_id(name)` — see AdaWorldAPI/OGAR#95 + docs/CONSUMER-BRIDGE-DEPRECATION.md"
+)]
 pub type OpenProjectBridge = UnifiedBridge<OpenProjectPort>;
 
 /// Canonical namespace name for OpenProject. Mirrors
@@ -41,6 +49,7 @@ pub const NAMESPACE: &str = OpenProjectPort::NAMESPACE;
 pub const OPENPROJECT_CODEBOOK: &[(&str, u16)] = ogar_vocab::ports::OPENPROJECT_ALIASES;
 
 #[cfg(test)]
+#[allow(deprecated)] // exercises the deprecated bridge alias on purpose
 mod tests {
     //! Co-located unit tests retained from the pre-migration shape —
     //! constructor success/failure, contract methods, codebook

crates/lance-graph-ogar/src/bridges/redmine_bridge.rs

@@ -17,6 +17,13 @@ use ogar_vocab::ports::PortSpec;
 pub use ogar_vocab::ports::RedminePort;
 
 /// Redmine `NamespaceBridge` — alias over the generic harness.
+///
+/// **Deprecated:** pull the classid via the OGAR PortSpec instead —
+/// `ogar_vocab::ports::RedminePort::class_id(name)`. See
+/// `docs/CONSUMER-BRIDGE-DEPRECATION.md` + AdaWorldAPI/OGAR#95.
+#[deprecated(
+    note = "pull the classid via `RedminePort::class_id(name)` — see AdaWorldAPI/OGAR#95 + docs/CONSUMER-BRIDGE-DEPRECATION.md"
+)]
 pub type RedmineBridge = UnifiedBridge<RedminePort>;
 
 /// Canonical namespace name for Redmine. Mirrors `RedminePort::NAMESPACE`
@@ -33,6 +40,7 @@ pub const NAMESPACE: &str = RedminePort::NAMESPACE;
 pub const REDMINE_CODEBOOK: &[(&str, u16)] = ogar_vocab::ports::REDMINE_ALIASES;
 
 #[cfg(test)]
+#[allow(deprecated)] // exercises the deprecated bridge alias on purpose
 mod tests {
     use super::*;
     use lance_graph_ontology::bridge::{BridgeError, NamespaceBridge};

crates/lance-graph-ogar/src/bridges/smb_bridge.rs

@@ -24,12 +24,20 @@ pub use ogar_vocab::ports::SmbPort;
 
 /// SMB `NamespaceBridge` — alias over the generic harness, locked to
 /// the `SMB` namespace via [`SmbPort`].
+///
+/// **Deprecated:** pull the classid via the OGAR PortSpec instead —
+/// `ogar_vocab::ports::SmbPort::class_id(name)`. See
+/// `docs/CONSUMER-BRIDGE-DEPRECATION.md` + AdaWorldAPI/OGAR#95.
+#[deprecated(
+    note = "pull the classid via `SmbPort::class_id(name)` — see AdaWorldAPI/OGAR#95 + docs/CONSUMER-BRIDGE-DEPRECATION.md"
+)]
 pub type SmbBridge = UnifiedBridge<SmbPort>;
 
 /// Canonical namespace name for SMB. Mirrors `SmbPort::NAMESPACE`.
 pub const NAMESPACE: &str = SmbPort::NAMESPACE;
 
 #[cfg(test)]
+#[allow(deprecated)] // exercises the deprecated bridge alias on purpose
 mod tests {
     use super::*;
     use lance_graph_ontology::bridge::{BridgeError, NamespaceBridge};

crates/lance-graph-ogar/src/bridges/woa_bridge.rs

@@ -31,12 +31,20 @@ pub use ogar_vocab::ports::WoaPort;
 
 /// WoA `NamespaceBridge` — alias over the generic harness, locked to
 /// the `WorkOrder` namespace via [`WoaPort`].
+///
+/// **Deprecated:** pull the classid via the OGAR PortSpec instead —
+/// `ogar_vocab::ports::WoaPort::class_id(name)`. See
+/// `docs/CONSUMER-BRIDGE-DEPRECATION.md` + AdaWorldAPI/OGAR#95.
+#[deprecated(
+    note = "pull the classid via `WoaPort::class_id(name)` — see AdaWorldAPI/OGAR#95 + docs/CONSUMER-BRIDGE-DEPRECATION.md"
+)]
 pub type WoaBridge = UnifiedBridge<WoaPort>;
 
 /// Canonical namespace name for WoA. Mirrors `WoaPort::NAMESPACE`.
 pub const NAMESPACE: &str = WoaPort::NAMESPACE;
 
 #[cfg(test)]
+#[allow(deprecated)] // exercises the deprecated bridge alias on purpose
 mod tests {
     use super::*;
     use lance_graph_ontology::bridge::{BridgeError, NamespaceBridge};

crates/lance-graph-ogar/src/lib.rs

@@ -82,9 +82,18 @@ pub use ogar_vocab::Class;
 //    which is OGIT and must not depend on ogar-vocab) ──
 pub mod bridges;
 
+// Per-port bridge aliases (`MedcareBridge` / `OpenProjectBridge` /
+// `RedmineBridge` / `OdooBridge` / `SmbBridge` / `WoaBridge`) are
+// `#[deprecated]` (2026-06-22) — pull the classid via the corresponding
+// PortSpec instead. The `Port` types and `UnifiedBridge` harness are
+// NOT deprecated. See `docs/CONSUMER-BRIDGE-DEPRECATION.md` +
+// AdaWorldAPI/OGAR#95.
 pub use bridges::{
-    HealthcarePort, MedcareBridge, OpenProjectBridge, OpenProjectPort, RedmineBridge, RedminePort,
-    UnifiedBridge,
+    HealthcarePort, OdooPort, OpenProjectPort, RedminePort, SmbPort, UnifiedBridge, WoaPort,
+};
+#[allow(deprecated)]
+pub use bridges::{
+    MedcareBridge, OdooBridge, OpenProjectBridge, RedmineBridge, SmbBridge, WoaBridge,
 };
 
 /// Codebook parity-guard — the drift fuse between OGAR's authoritative codebook

crates/lance-graph-ogar/tests/bridge_codebook_convergence.rs

@@ -1,6 +1,10 @@
 // Skip under Miri — TTL fixtures use `tempfile::tempdir()` +
 // `std::fs::create_dir_all/write`, both blocked by Miri's isolation.
 #![cfg(not(miri))]
+// Exercises the deprecated `OpenProjectBridge` / `RedmineBridge` aliases on
+// purpose — the convergence pin is what we're testing. See
+// `docs/CONSUMER-BRIDGE-DEPRECATION.md`.
+#![allow(deprecated)]
 
 //! Bridge codebook convergence test — codex P1 on PR #559.
 //!

crates/lance-graph-ogar/tests/bridge_scope_lock.rs

@@ -3,6 +3,9 @@
 // isolation blocks `mkdir`/`open`. Stable and nightly without Miri run it
 // normally.
 #![cfg(not(miri))]
+// Exercises the deprecated bridge aliases on purpose — see
+// `docs/CONSUMER-BRIDGE-DEPRECATION.md`.
+#![allow(deprecated)]
 
 //! Bridge scope-lock test.
 //!