feat(ogar-vocab): PortSpec trait + OpenProjectPort/RedminePort

[AdaWorldAPI]

PortSpec trait + the first two impls

Per the user's direction: enforce the migration of WoaBridge /
MedcareBridge style per-port bridges to a generic
UnifiedBridge<P: PortSpec> harness where the differences between
bridges come from the OGAR class schema, not from per-bridge hardcoded
tables.

This PR delivers the OGAR side of that migration. The
lance-graph-ontology side (define UnifiedBridge<P>, replace
OpenProjectBridge/RedmineBridge with type aliases) lands as a
follow-up PR depending on this one.

What ships

pub trait PortSpec: 'static + Send + Sync {
    const NAMESPACE: &'static str;      // "OpenProject" / "Redmine"
    const BRIDGE_ID: &'static str;      // "openproject" / "redmine"
    fn aliases() -> &'static [(&'static str, u16)];
    fn class_id(public_name: &str) -> Option<u16> { /* linear scan */ }
}

pub struct OpenProjectPort;   // impl PortSpec — 25 aliases
pub struct RedminePort;       // impl PortSpec — 25 aliases

Both ports reference the same class_ids::* constants for converging
concepts, so:

OpenProjectPort::class_id("WorkPackage") == RedminePort::class_id("Issue")
                                         == Some(class_ids::PROJECT_WORK_ITEM)
                                         == Some(0x0102)

Convergence test pins (24 concept pairs)

let pairs: &[(&str, &str, u16)] = &[
    ("Project",       "Project",       class_ids::PROJECT),
    ("WorkPackage",   "Issue",         class_ids::PROJECT_WORK_ITEM),
    ("TimeEntry",     "TimeEntry",     class_ids::BILLABLE_WORK_ENTRY),
    ("Status",        "IssueStatus",   class_ids::PROJECT_STATUS),
    ("Type",          "Tracker",       class_ids::PROJECT_TYPE),
    ("Membership",    "Member",        class_ids::PROJECT_MEMBERSHIP),
    ("Relation",      "IssueRelation", class_ids::PROJECT_RELATION),
    ("Forum",         "Board",         class_ids::PROJECT_FORUM),
    // ... 16 more identity pairs
];

What this unlocks (the lance-graph follow-up)

// In lance-graph-ontology, after this lands:
pub struct UnifiedBridge<P: PortSpec> {
    registry: Arc<OntologyRegistry>,
    g_lock: NamespaceId,
    _spec: PhantomData<P>,
}

impl<P: PortSpec> NamespaceBridge for UnifiedBridge<P> {
    fn bridge_id(&self) -> &'static str { P::BRIDGE_ID }
    fn entity(&self, name: &str) -> Result<EntityRef, BridgeError> {
        if let Some(id) = P::class_id(name) { /* synthesize */ }
        else { /* fall back to registry */ }
    }
}

pub type OpenProjectBridge = UnifiedBridge<ogar_vocab::ports::OpenProjectPort>;
pub type RedmineBridge     = UnifiedBridge<ogar_vocab::ports::RedminePort>;

The duplicated OPENPROJECT_CODEBOOK / REDMINE_CODEBOOK tables in
crates/lance-graph-ontology/src/bridges/{openproject,redmine}_bridge.rs
(currently 25 entries each, duplicated across the two files) get
deleted — the canonical class schema is the only source of truth.

Files

• crates/ogar-vocab/src/ports.rs (new) — trait + two impls + 8 tests
• crates/ogar-vocab/src/lib.rs — pub mod ports;

🤖 Generated with Claude Code

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bf1010da8e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Include Principal and Group actor aliases

When the follow-up UnifiedBridge asks this table for actual Rails actor classes, class_id("Principal") and class_id("Group") return None because User is the only alias for PROJECT_ACTOR. The existing real-source coverage in crates/ogar-from-rails/src/lib.rs (redmine_and_openproject_actors_converge_through_canonical) documents that both Redmine and OpenProject ship User and Principal, and later coverage also folds Group into project_actor; falling back for those names will give them non-codebook entity ids instead of the shared 0x0104.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Map IssuePriority instead of Priority

The port table is matched with exact string equality, but both Rails curators expose the priority class as IssuePriority, not Priority (see redmine_and_openproject_issuepriority_converge_through_canonical in crates/ogar-from-rails/src/lib.rs). As written, OpenProject returns None for class_id("IssuePriority"), and the Redmine table has no priority alias at all, so the unified bridge will miss the promoted priority codebook id for the actual class name.

Useful? React with 👍 / 👎.