omninode-memory 0.9.3__tar.gz → 0.12.0__tar.gz

omninode_memory-0.9.3/.github/workflows/test.yml → omninode_memory-0.12.0/.github/workflows/ci.yml

@@ -1,13 +1,13 @@
 # SPDX-FileCopyrightText: 2025 OmniNode.ai Inc.
 # SPDX-License-Identifier: MIT
 
-name: Test Suite
+name: CI
 
 on:
   push:
-    branches: [main, develop]
+    branches: [main]
   pull_request:
-    branches: [main, develop]
+    branches: [main]
   merge_group:
   workflow_dispatch:
 

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/.github/workflows/omni-standards-compliance.yml

@@ -50,3 +50,29 @@ jobs:
 
       - name: Check for Optional/Union usage (PEP 604)
         run: uv run ruff check src/ --select UP007,UP006
+
+  ci-naming-convention:
+    name: CI Naming Convention
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Verify CI workflow naming convention
+        run: |
+          if [ ! -f .github/workflows/ci.yml ]; then
+            echo "::error::Missing .github/workflows/ci.yml"
+            exit 1
+          fi
+          CI_NAME=$(grep -m1 "^name:" .github/workflows/ci.yml | sed "s/name: *//")
+          if [ "$CI_NAME" != "CI" ]; then
+            echo "::error::ci.yml has name '$CI_NAME' — must be 'CI'"
+            exit 1
+          fi
+          for legacy in test.yml ci.yaml; do
+            if [ -f ".github/workflows/$legacy" ]; then
+              echo "::error::Legacy workflow .github/workflows/$legacy exists"
+              exit 1
+            fi
+          done
+          echo "CI naming convention: PASS"

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/.github/workflows/stale-todo-gate.yml

@@ -33,7 +33,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/.github/workflows/todo-audit-on-merge.yml

@@ -37,7 +37,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Extract ticket ID from branch name
         id: extract

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/CHANGELOG.md

@@ -1,3 +1,40 @@
+## v0.12.0 (2026-03-25)
+
+### Added
+- feat: env-configurable retrieval stubs + wire similarity handler (#199)
+- feat(runtime): wire AdapterGraphMemory initialization in PluginMemory [OMN-6578] (#198)
+
+### Changed
+- chore(deps): pin omnibase-core==0.32.0, omnibase-infra==0.27.0 for coordinated release
+- chore(deps): bump omnibase_core to 0.31.0 (#197)
+- chore(ci): rename test.yml -> ci.yml for cross-repo standardization [OMN-6215] (#194)
+- build(deps): bump actions/checkout from 4 to 6 in the actions group (#195)
+
+### Fixed
+- fix(deps): update stale omnibase-infra and spi version pins [OMN-6112] (#193)
+
+## v0.11.0 (2026-03-24)
+
+### Changed
+- chore(deps): bump omnibase_core to 0.30.2 (#192)
+- release: omnimemory v0.11.0 (#196)
+
+## v0.9.3 (2026-03-22)
+
+### Changed
+- ci: add check-handshake workflow [OMN-5858] (#190)
+- chore: bump omnibase-core to >=0.30.1 [OMN-5812] (#189)
+- chore(deps): bump omnibase_core to 0.30.1 (#188)
+
+## v0.9.2 (2026-03-21)
+
+### Changed
+- ci: deploy TODO enforcement hooks and workflows OMN-5694, OMN-5695 (#186)
+- chore: remove canceled TODO for OMN-1589 (pyright strictness) [OMN-5690] (#185)
+
+### Fixed
+- fix: restructure omnimemory root contract with top-level fields [OMN-5703] (#184)
+
 ## v0.9.1 (2026-03-20)
 
 ### Changed

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omninode-memory
-Version: 0.9.3
+Version: 0.12.0
 Summary: OmniNode document ingestion and semantic retrieval
 Project-URL: Homepage, https://github.com/OmniNode-ai/omnimemory
 Project-URL: Repository, https://github.com/OmniNode-ai/omnimemory
@@ -20,9 +20,9 @@ Requires-Dist: cachetools<8.0.0,>=6.2.4
 Requires-Dist: fastapi<1.0.0,>=0.120.1
 Requires-Dist: httpx<1.0.0,>=0.28.0
 Requires-Dist: mcp<2.0.0,>=1.8.0
-Requires-Dist: omnibase-core>=0.30.1
-Requires-Dist: omnibase-infra==0.22.0
-Requires-Dist: omnibase-spi==0.18.0
+Requires-Dist: omnibase-core==0.32.0
+Requires-Dist: omnibase-infra==0.27.0
+Requires-Dist: omnibase-spi>=0.19.1
 Requires-Dist: pinecone-client<7.0.0,>=4.1.0
 Requires-Dist: psutil<8.0.0,>=7.0.0
 Requires-Dist: psycopg2-binary<3.0.0,>=2.9.10

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "omninode-memory"
-version = "0.9.3"
+version = "0.12.0"
 description = "OmniNode document ingestion and semantic retrieval"
 readme = "README.md"
 requires-python = ">=3.12,<3.14"
@@ -59,9 +59,9 @@ dependencies = [
     "pyyaml>=6.0.2,<7.0.0",
 
     # ONEX dependencies - versioned releases from PyPI
-    "omnibase-core>=0.30.1",
-    "omnibase-spi==0.18.0",
-    "omnibase-infra==0.22.0",
+    "omnibase-core==0.32.0",
+    "omnibase-spi>=0.19.1",
+    "omnibase-infra==0.27.0",
 
     # Logging and monitoring
     # Version ^23.3.0 required for compatibility with omnibase-infra (requires ^23.2.0)
@@ -363,6 +363,6 @@ markers = [
 [tool.uv]
 # Override omnibase-infra's transitive pins on core/spi so our direct pins win.
 override-dependencies = [
-    "omnibase-core>=0.30.1",
-    "omnibase-spi==0.18.0",
+    "omnibase-core==0.32.0",
+    "omnibase-spi>=0.19.1",
 ]

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/scripts/validate_ci_precommit_alignment.py

@@ -4,7 +4,7 @@
 
 """Validate alignment between CI workflow jobs and pre-commit hooks.
 
-This script ensures that the CI workflow (.github/workflows/test.yml) and
+This script ensures that the CI workflow (.github/workflows/ci.yml) and
 pre-commit configuration (.pre-commit-config.yaml) stay synchronized.
 
 It checks:
@@ -117,7 +117,7 @@ def main() -> int:
     verbose = "--verbose" in sys.argv or "-v" in sys.argv
 
     precommit_path = Path(".pre-commit-config.yaml")
-    ci_path = Path(".github/workflows/test.yml")
+    ci_path = Path(".github/workflows/ci.yml")
     required_checks_path = Path(".github/required-checks.yaml")
 
     precommit_content = load_file(precommit_path)

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/src/omnimemory/runtime/dispatch_handlers.py

@@ -30,6 +30,7 @@ import contextlib
 import inspect
 import json
 import logging
+import os
 from collections.abc import Awaitable, Callable
 from typing import TYPE_CHECKING, Protocol, cast, runtime_checkable
 from uuid import UUID, uuid4
@@ -46,6 +47,10 @@ if TYPE_CHECKING:
         ProtocolHandlerContext,
     )
 
+    from omnimemory.nodes.node_memory_retrieval_effect.models import (
+        ModelHandlerMemoryRetrievalConfig,
+    )
+
 logger = logging.getLogger(__name__)
 
 # =============================================================================
@@ -118,6 +123,9 @@ DISPATCH_ALIAS_MEMORY_RETRIEVAL_REQUESTED = (
 )
 """Dispatch-compatible alias for memory-retrieval-requested command topic."""
 
+DISPATCH_ALIAS_GRAPH_MEMORY = "onex.commands.omnimemory.graph-memory-query.v1"
+"""Dispatch-compatible alias for graph memory query/mutation operations (OMN-6578)."""
+
 
 # =============================================================================
 # Bridge Handler: Intent Classified Event
@@ -392,6 +400,47 @@ def create_lifecycle_dispatch_handler(
 # =============================================================================
 
 
+def build_retrieval_config_from_env() -> (  # stub-ok: references stub_handlers field name — fully implemented
+    ModelHandlerMemoryRetrievalConfig
+):
+    """Build retrieval config from environment variables.
+
+    Reads ``OMNIMEMORY_USE_STUB_HANDLERS`` (default ``"true"``).  When the
+    value is anything other than ``"false"`` (case-insensitive, whitespace
+    stripped), in-memory test doubles are used.  Otherwise a
+    ``ModelHandlerQdrantConfig`` is constructed from ``QDRANT_HOST``,
+    ``QDRANT_PORT``, and ``LLM_EMBEDDING_URL``.
+
+    Returns:
+        Fully-populated retrieval config ready for ``HandlerMemoryRetrieval``.
+    """
+    from omnimemory.nodes.node_memory_retrieval_effect.models import (
+        ModelHandlerMemoryRetrievalConfig,
+    )
+    from omnimemory.nodes.node_memory_retrieval_effect.models.model_handler_qdrant_config import (
+        ModelHandlerQdrantConfig,
+    )
+
+    use_stubs = (
+        os.getenv("OMNIMEMORY_USE_STUB_HANDLERS", "true").strip().lower() != "false"
+    )
+    qdrant_config = (
+        None
+        if use_stubs
+        else ModelHandlerQdrantConfig(
+            qdrant_host=os.getenv("QDRANT_HOST", "localhost"),
+            qdrant_port=int(os.getenv("QDRANT_PORT", "6333")),
+            embedding_server_url=os.getenv(
+                "LLM_EMBEDDING_URL", "http://localhost:8100"
+            ),
+        )
+    )
+    return ModelHandlerMemoryRetrievalConfig(
+        use_stub_handlers=use_stubs,
+        qdrant_config=qdrant_config,
+    )
+
+
 def create_memory_retrieval_dispatch_handler(  # stub-ok: references stub_handlers field name — fully implemented
     *,
     correlation_id: UUID | None = None,
@@ -417,7 +466,6 @@ def create_memory_retrieval_dispatch_handler(  # stub-ok: references stub_handle
         HandlerMemoryRetrieval,
     )
     from omnimemory.nodes.node_memory_retrieval_effect.models import (
-        ModelHandlerMemoryRetrievalConfig,
         ModelMemoryRetrievalRequest,
     )
 
@@ -426,7 +474,7 @@ def create_memory_retrieval_dispatch_handler(  # stub-ok: references stub_handle
     async def _get_retrieval_handler() -> HandlerMemoryRetrieval:
         nonlocal _retrieval_handler
         if _retrieval_handler is None:
-            config = ModelHandlerMemoryRetrievalConfig(use_stub_handlers=True)
+            config = build_retrieval_config_from_env()
             _retrieval_handler = HandlerMemoryRetrieval(config)
             await _retrieval_handler.initialize()
         return _retrieval_handler
@@ -488,6 +536,70 @@ def create_memory_retrieval_dispatch_handler(  # stub-ok: references stub_handle
     return _handle
 
 
+# =============================================================================
+# Bridge Handler: Graph Memory Adapter (OMN-6578)
+# =============================================================================
+
+
+def _create_graph_memory_dispatch_handler(
+    *,
+    adapter: object,
+) -> Callable[
+    [ModelEventEnvelope[object], ProtocolHandlerContext],
+    Awaitable[str],
+]:
+    """Create a dispatch engine handler for graph memory operations.
+
+    Returns an async handler function compatible with MessageDispatchEngine's
+    handler signature.  The handler delegates to the ``AdapterGraphMemory``
+    instance passed as *adapter*.
+
+    Args:
+        adapter: An ``AdapterGraphMemory`` instance (typed as ``object`` to
+            avoid importing the adapter at module level).
+
+    Returns:
+        Async handler function with signature (envelope, context) -> str.
+    """
+
+    async def _handle(
+        envelope: ModelEventEnvelope[object],
+        context: ProtocolHandlerContext,
+    ) -> str:
+        """Bridge handler: envelope -> AdapterGraphMemory operation."""
+        ctx_correlation_id = getattr(context, "correlation_id", None) or uuid4()
+
+        payload = envelope.payload
+        if not isinstance(payload, dict):
+            msg = (
+                f"Unexpected payload type {type(payload).__name__} "
+                f"for graph-memory command "
+                f"(correlation_id={ctx_correlation_id})"
+            )
+            logger.warning(msg)
+            raise ValueError(msg)
+
+        logger.info(
+            "Dispatching graph-memory command via MessageDispatchEngine "
+            "(correlation_id=%s)",
+            ctx_correlation_id,
+        )
+
+        # The adapter operation is determined by the payload content.
+        # For now, this is a placeholder that logs receipt; the full
+        # operation routing will be wired by downstream tasks.
+        operation = payload.get("operation", "unknown")
+        logger.info(
+            "Graph memory command received (operation=%s, correlation_id=%s)",
+            operation,
+            ctx_correlation_id,
+        )
+
+        return ""
+
+    return _handle
+
+
 # =============================================================================
 # Dispatch Engine Factory
 # =============================================================================
@@ -501,17 +613,19 @@ def create_memory_dispatch_engine(
     | Callable[[str, dict[str, object]], None]
     | None = None,
     publish_topics: dict[str, str] | None = None,
+    graph_memory_adapter: object | None = None,
 ) -> MessageDispatchEngine:
     """Create and configure a MessageDispatchEngine for OmniMemory domain.
 
     Creates the engine, registers all omnimemory domain handlers and routes,
     and freezes it. The engine is ready for dispatch after this call.
 
-    Registers 4 handlers covering 6 routes:
+    Registers 4+ handlers covering 6+ routes:
         1. intent-classified handler (1 route: intent-classified.v1 events)
         2. intent-query handler (1 route: intent-query-requested.v1 commands)
         3. memory-retrieval handler (1 route: memory-retrieval-requested.v1 -- fail-fast)
         4. lifecycle handler (3 routes: runtime-tick, archive, expire -- fail-fast)
+        5. graph-memory handler (optional, 1 route: graph query/mutation -- OMN-6578)
 
     Args:
         intent_consumer: REQUIRED intent event consumer handler.
@@ -521,6 +635,9 @@ def create_memory_dispatch_engine(
         publish_topics: Optional mapping of handler name to publish topic.
             Keys: "intent_query". Values: full topic strings from contract
             event_bus.publish_topics.
+        graph_memory_adapter: Optional AdapterGraphMemory instance.  When
+            provided the adapter is registered as a handler for graph query
+            and mutation operations (OMN-6578).
 
     Returns:
         Frozen MessageDispatchEngine ready for dispatch.
@@ -650,6 +767,31 @@ def create_memory_dispatch_engine(
         )
     )
 
+    # --- Handler 5 (optional): graph memory adapter (OMN-6578) ---
+    if graph_memory_adapter is not None:
+        graph_memory_handler = _create_graph_memory_dispatch_handler(
+            adapter=graph_memory_adapter,
+        )
+        engine.register_handler(
+            handler_id="memory-graph-memory-handler",
+            handler=graph_memory_handler,
+            category=EnumMessageCategory.COMMAND,
+            node_kind=EnumNodeKind.EFFECT,
+            message_types=None,
+        )
+        engine.register_route(
+            ModelDispatchRoute(
+                route_id="memory-graph-memory-route",
+                topic_pattern=DISPATCH_ALIAS_GRAPH_MEMORY,
+                message_category=EnumMessageCategory.COMMAND,
+                handler_id="memory-graph-memory-handler",
+                description=(
+                    "Routes graph memory queries/mutations to "
+                    "AdapterGraphMemory (OMN-6578)."
+                ),
+            )
+        )
+
     engine.freeze()
 
     logger.info(

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/src/omnimemory/runtime/plugin.py

@@ -74,6 +74,7 @@ if TYPE_CHECKING:
     from omnibase_core.runtime.runtime_message_dispatch import MessageDispatchEngine
     from omnibase_infra.runtime.registry import RegistryMessageType
 
+    from omnimemory.handlers.adapters.adapter_graph_memory import AdapterGraphMemory
     from omnimemory.runtime.introspection import MemoryNodeIntrospectionProxy
 
 from omnibase_infra.runtime.models.model_handshake_result import ModelHandshakeResult
@@ -173,6 +174,7 @@ class PluginMemory:
         self._event_bus: ProtocolEventBus | None = None
         self._introspection_nodes: list[str] = []
         self._introspection_proxies: list[MemoryNodeIntrospectionProxy] = []
+        self._graph_memory_adapter: AdapterGraphMemory | None = None
 
     @property
     def message_type_registry(self) -> RegistryMessageType | None:
@@ -456,11 +458,54 @@ class PluginMemory:
                 collect_publish_topics_for_dispatch,
             )
 
+            # Graph memory adapter — connects to Memgraph (OMN-6578).
+            # ModelGraphMemoryConfig has no host/port fields; connection
+            # details are passed to initialize(connection_uri=...).
+            graph_memory_adapter = None
+            memgraph_host = os.environ.get("OMNIMEMORY_MEMGRAPH_HOST")
+            if memgraph_host:
+                from omnimemory.handlers.adapters.adapter_graph_memory import (
+                    AdapterGraphMemory,
+                )
+                from omnimemory.models.adapters.model_graph_memory_config import (
+                    ModelGraphMemoryConfig,
+                )
+
+                memgraph_port = int(os.environ.get("OMNIMEMORY_MEMGRAPH_PORT", "7687"))
+                graph_config = ModelGraphMemoryConfig()
+                graph_memory_adapter = AdapterGraphMemory(config=graph_config)
+                connection_uri = f"bolt://{memgraph_host}:{memgraph_port}"
+
+                # Probe TCP before attempting full bolt handshake to provide
+                # a clearer error message if Memgraph is unreachable.
+                reachable = await _probe_tcp_reachable(memgraph_host, memgraph_port)
+                if reachable:
+                    await graph_memory_adapter.initialize(
+                        connection_uri=connection_uri, auth=None
+                    )
+                    logger.info(
+                        "Graph memory adapter initialized (uri=%s, correlation_id=%s)",
+                        connection_uri,
+                        correlation_id,
+                    )
+                    self._graph_memory_adapter = graph_memory_adapter
+                else:
+                    logger.warning(
+                        "Memgraph unreachable at %s:%d — graph memory "
+                        "adapter will not be registered "
+                        "(correlation_id=%s)",
+                        memgraph_host,
+                        memgraph_port,
+                        correlation_id,
+                    )
+                    graph_memory_adapter = None
+
             self._dispatch_engine = create_memory_dispatch_engine(
                 intent_consumer=intent_consumer,
                 intent_query_handler=intent_query_handler,
                 publish_callback=publish_callback,
                 publish_topics=publish_topics,
+                graph_memory_adapter=graph_memory_adapter,
             )
 
             # Store event_bus reference for introspection publishing.

{omninode_memory-0.9.3 → omninode_memory-0.12.0}/src/omnimemory/runtime/wiring.py

@@ -55,6 +55,11 @@ _HANDLER_SPECS: list[tuple[str, str, bool]] = [
         "HandlerSubscription",
         False,  # Requires ModelONEXContainer
     ),
+    (
+        "omnimemory.nodes.node_similarity_compute.handlers.handler_similarity_compute",
+        "HandlerSimilarityCompute",
+        False,  # Requires ModelONEXContainer — verify-only
+    ),
 ]