omninode-memory 0.12.2__tar.gz → 0.14.0__tar.gz

omninode_memory-0.14.0/.github/workflows/auto-merge.yml

@@ -0,0 +1,30 @@
+# SPDX-FileCopyrightText: 2025 OmniNode.ai Inc.
+# SPDX-License-Identifier: MIT
+#
+# OMN-6571: Automatically enable auto-merge (squash) on every PR opened
+# by jonahgabriel. Ensures PRs do not sit idle in the merge queue waiting
+# for manual enrollment.
+name: Auto-Merge
+
+on:
+  pull_request:
+    types: [opened, reopened, ready_for_review]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-merge:
+    name: Enable Auto-Merge
+    runs-on: ubuntu-latest
+    if: github.actor == 'jonahgabriel'
+    steps:
+      # continue-on-error: merge queue re-triggers this workflow, and
+      # gh pr merge fails with "already enqueued" — that is expected.
+      - name: Enable auto-merge (squash)
+        continue-on-error: true
+        run: gh pr merge "${{ github.event.pull_request.number }}" --auto --squash
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

omninode_memory-0.14.0/.github/workflows/codeql.yml

@@ -0,0 +1,23 @@
+# SPDX-FileCopyrightText: 2025 OmniNode.ai Inc.
+# SPDX-License-Identifier: MIT
+#
+# CodeQL caller workflow — delegates to onex_change_control reusable workflow.
+# OMN-5412
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "0 6 * * 1"  # Weekly Monday 6am UTC
+
+jobs:
+  codeql:
+    uses: OmniNode-ai/onex_change_control/.github/workflows/codeql-reusable.yml@main
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+

omninode_memory-0.14.0/.github/workflows/pr-title-check.yml

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2025 OmniNode.ai Inc.
+# SPDX-License-Identifier: MIT
+# OMN-6912
+
+name: PR Title Check
+
+on:
+  pull_request:
+    types: [opened, edited]
+
+jobs:
+  pr-title:
+    uses: OmniNode-ai/onex_change_control/.github/workflows/pr-title-check-reusable.yml@main
+    permissions:
+      pull-requests: read

{omninode_memory-0.12.2 → omninode_memory-0.14.0}/CHANGELOG.md

@@ -1,3 +1,26 @@
+## v0.14.0 (2026-03-30)
+
+### Changed
+- release: omnimemory v0.14.0 coordinated release
+- chore(deps): bump omnibase-core to 0.35.0, omnibase-infra to 0.30.0
+
+### Dependencies
+- omnibase-core 0.34.0 -> 0.35.0
+- omnibase-infra 0.29.0 -> 0.30.0
+
+## v0.13.0 (2026-03-28)
+
+### Added
+- ci: add CodeQL security scanning workflow [OMN-5412] (#214)
+- feat(ci): add auto-merge-on-open workflow [OMN-6571] (#213)
+- feat(runtime): wire AdapterGraphMemory into PluginMemory [OMN-6578] (#211)
+
+### Changed
+- chore(deps): bump omnibase-core to 0.34.0
+
+### Dependencies
+- omnibase-core 0.33.1 -> 0.34.0
+
 ## v0.12.2 (2026-03-27)
 
 ### Fixed

{omninode_memory-0.12.2 → omninode_memory-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omninode-memory
-Version: 0.12.2
+Version: 0.14.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,7 +20,7 @@ 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.33.1
+Requires-Dist: omnibase-core==0.34.0
 Requires-Dist: omnibase-infra==0.28.0
 Requires-Dist: omnibase-spi>=0.19.1
 Requires-Dist: pinecone-client<7.0.0,>=4.1.0

{omninode_memory-0.12.2 → omninode_memory-0.14.0}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "omninode-memory"
-version = "0.12.2"
+version = "0.14.0"
 description = "OmniNode document ingestion and semantic retrieval"
 readme = "README.md"
 requires-python = ">=3.12,<3.14"
@@ -59,7 +59,7 @@ dependencies = [
     "pyyaml>=6.0.2,<7.0.0",
 
     # ONEX dependencies - versioned releases from PyPI
-    "omnibase-core==0.33.1",
+    "omnibase-core==0.34.0",
     "omnibase-spi>=0.19.1",
     "omnibase-infra==0.28.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.33.1",
+    "omnibase-core==0.34.0",
     "omnibase-spi>=0.19.1",
 ]

{omninode_memory-0.12.2 → omninode_memory-0.14.0}/src/omnimemory/runtime/dispatch_handlers.py

@@ -50,6 +50,7 @@ if TYPE_CHECKING:
     from omnimemory.nodes.node_memory_retrieval_effect.models import (
         ModelHandlerMemoryRetrievalConfig,
     )
+    from omnimemory.runtime.handler_lifecycle import HandlerMemoryLifecycle
 
 logger = logging.getLogger(__name__)
 
@@ -126,6 +127,17 @@ DISPATCH_ALIAS_MEMORY_RETRIEVAL_REQUESTED = (
 DISPATCH_ALIAS_GRAPH_MEMORY = "onex.commands.omnimemory.graph-memory-query.v1"
 """Dispatch-compatible alias for graph memory query/mutation operations (OMN-6578)."""
 
+DISPATCH_ALIAS_INTENT_GRAPH = "onex.commands.omnimemory.intent-graph-query.v1"
+"""Dispatch-compatible alias for intent graph query/mutation operations (OMN-6579)."""
+
+DISPATCH_ALIAS_NAVIGATION_HISTORY = (
+    "onex.commands.omnimemory.navigation-history-session.v1"
+)
+"""Dispatch-compatible alias for navigation history session events (OMN-6583)."""
+
+DISPATCH_ALIAS_SEMANTIC_COMPUTE = "onex.commands.omnimemory.semantic-analysis.v1"
+"""Dispatch-compatible alias for semantic analysis requests (OMN-6585)."""
+
 
 # =============================================================================
 # Bridge Handler: Intent Classified Event
@@ -579,22 +591,249 @@ def _create_graph_memory_dispatch_handler(
             logger.warning(msg)
             raise ValueError(msg)
 
-        logger.info(
-            "Dispatching graph-memory command via MessageDispatchEngine "
-            "(correlation_id=%s)",
+        operation = payload.get("operation", "unknown")
+        logger.warning(
+            "Graph memory command received but adapter dispatch not yet wired "
+            "(operation=%s, correlation_id=%s) -- acknowledging as no-op. "
+            "See OMN-6580 follow-up tasks for operation routing.",
+            operation,
             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.
+        # TODO(OMN-6580): Route to adapter.store() / adapter.query() based on
+        # operation field. Currently validates and acknowledges.
+        return ""
+
+    return _handle
+
+
+# =============================================================================
+# Bridge Handler: Intent Graph Adapter (OMN-6579)
+# =============================================================================
+
+
+def _create_intent_graph_dispatch_handler(
+    *,
+    adapter: object,
+) -> Callable[
+    [ModelEventEnvelope[object], ProtocolHandlerContext],
+    Awaitable[str],
+]:
+    """Create a dispatch engine handler for intent graph operations.
+
+    Args:
+        adapter: An ``AdapterIntentGraph`` 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 -> AdapterIntentGraph 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 intent-graph command "
+                f"(correlation_id={ctx_correlation_id})"
+            )
+            logger.warning(msg)
+            raise ValueError(msg)
+
         operation = payload.get("operation", "unknown")
-        logger.info(
-            "Graph memory command received (operation=%s, correlation_id=%s)",
+        logger.warning(
+            "Intent graph command received but adapter dispatch not yet wired "
+            "(operation=%s, correlation_id=%s) -- acknowledging as no-op. "
+            "See OMN-6579 follow-up tasks for operation routing.",
             operation,
             ctx_correlation_id,
         )
 
+        # TODO(OMN-6579): Route to adapter methods based on operation field.
+        # Currently validates and acknowledges; full dispatch in follow-up PR.
+        return ""
+
+    return _handle
+
+
+# =============================================================================
+# Bridge Handler: Navigation History Reducer (OMN-6583)
+# =============================================================================
+
+
+def _create_navigation_history_dispatch_handler(
+    *,
+    handler: object,
+) -> Callable[
+    [ModelEventEnvelope[object], ProtocolHandlerContext],
+    Awaitable[str],
+]:
+    """Create a dispatch engine handler for navigation history sessions.
+
+    Args:
+        handler: A ``HandlerNavigationHistoryReducer`` instance.
+
+    Returns:
+        Async handler function with signature (envelope, context) -> str.
+    """
+
+    async def _handle(
+        envelope: ModelEventEnvelope[object],
+        context: ProtocolHandlerContext,
+    ) -> str:
+        """Bridge handler: envelope -> HandlerNavigationHistoryReducer."""
+        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 navigation-history command "
+                f"(correlation_id={ctx_correlation_id})"
+            )
+            logger.warning(msg)
+            raise ValueError(msg)
+
+        logger.warning(
+            "Navigation history session event received but handler dispatch "
+            "not yet wired (correlation_id=%s) -- acknowledging as no-op. "
+            "See OMN-6583 follow-up tasks for session routing.",
+            ctx_correlation_id,
+        )
+
+        # TODO(OMN-6583): Route to handler.record_session() / handler.query()
+        # based on payload command field. Currently validates and acknowledges.
+        return ""
+
+    return _handle
+
+
+# =============================================================================
+# Bridge Handler: Semantic Compute (OMN-6585)
+# =============================================================================
+
+
+def _create_semantic_compute_dispatch_handler(
+    *,
+    handler: object,
+) -> Callable[
+    [ModelEventEnvelope[object], ProtocolHandlerContext],
+    Awaitable[str],
+]:
+    """Create a dispatch engine handler for semantic analysis requests.
+
+    Args:
+        handler: A ``HandlerSemanticCompute`` instance.
+
+    Returns:
+        Async handler function with signature (envelope, context) -> str.
+    """
+
+    async def _handle(
+        envelope: ModelEventEnvelope[object],
+        context: ProtocolHandlerContext,
+    ) -> str:
+        """Bridge handler: envelope -> HandlerSemanticCompute."""
+        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 semantic-compute command "
+                f"(correlation_id={ctx_correlation_id})"
+            )
+            logger.warning(msg)
+            raise ValueError(msg)
+
+        logger.warning(
+            "Semantic analysis request received but handler dispatch "
+            "not yet wired (correlation_id=%s) -- acknowledging as no-op. "
+            "See OMN-6585 follow-up tasks for compute routing.",
+            ctx_correlation_id,
+        )
+
+        # TODO(OMN-6585): Route to handler.analyze() based on payload.
+        # Currently validates and acknowledges.
+        return ""
+
+    return _handle
+
+
+# =============================================================================
+# Bridge Handler: Lifecycle (OMN-6588)
+# =============================================================================
+
+
+def _create_lifecycle_bridge_handler(
+    *,
+    lifecycle: HandlerMemoryLifecycle,
+) -> Callable[
+    [ModelEventEnvelope[object], ProtocolHandlerContext],
+    Awaitable[str],
+]:
+    """Create a dispatch engine handler for lifecycle commands.
+
+    Replaces the no-op handler with a bridge to HandlerMemoryLifecycle.
+    Handles runtime-tick, archive-memory, and expire-memory commands.
+
+    Args:
+        lifecycle: A ``HandlerMemoryLifecycle`` instance.
+
+    Returns:
+        Async handler function with signature (envelope, context) -> str.
+    """
+
+    async def _handle(
+        envelope: ModelEventEnvelope[object],
+        context: ProtocolHandlerContext,
+    ) -> str:
+        """Bridge handler: envelope -> HandlerMemoryLifecycle."""
+        ctx_correlation_id = getattr(context, "correlation_id", None) or uuid4()
+
+        topic = getattr(envelope, "event_type", None) or "unknown"
+        payload = envelope.payload
+        command = payload.get("command", "") if isinstance(payload, dict) else ""
+
+        logger.info(
+            "Lifecycle command received (topic=%s, command=%s, correlation_id=%s)",
+            topic,
+            command,
+            ctx_correlation_id,
+        )
+
+        # Ensure the lifecycle handler is started before processing commands.
+        if not lifecycle.is_started():
+            with contextlib.suppress(Exception):
+                await lifecycle.handle_startup()
+
+        # Route lifecycle commands.
+        if command in ("shutdown", "expire-memory"):
+            # Shutdown is the only lifecycle teardown method available.
+            # archive-memory has no dedicated handler yet (OMN-6588 follow-up).
+            logger.info(
+                "Lifecycle shutdown requested (command=%s, correlation_id=%s)",
+                command,
+                ctx_correlation_id,
+            )
+            with contextlib.suppress(Exception):
+                await lifecycle.handle_shutdown()
+        elif command == "archive-memory":
+            # TODO(OMN-6588): Wire archive-memory to a dedicated handler.
+            # Currently acknowledged as no-op; the lifecycle handler does not
+            # have an archive method yet.
+            logger.warning(
+                "archive-memory command not yet implemented "
+                "(correlation_id=%s) -- acknowledging as no-op",
+                ctx_correlation_id,
+            )
+
         return ""
 
     return _handle
@@ -614,18 +853,24 @@ def create_memory_dispatch_engine(
     | None = None,
     publish_topics: dict[str, str] | None = None,
     graph_memory_adapter: object | None = None,
+    intent_graph_adapter: object | None = None,
+    navigation_history_handler: object | None = None,
+    semantic_compute_handler: 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-8 handlers covering 6-10 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)
+        3. memory-retrieval handler (1 route: memory-retrieval-requested.v1)
+        4. lifecycle handler (3 routes: runtime-tick, archive, expire)
+        5. graph-memory handler (optional, 1 route -- OMN-6578)
+        6. intent-graph handler (optional, 1 route -- OMN-6579)
+        7. navigation-history handler (optional, 1 route -- OMN-6583)
+        8. semantic-compute handler (optional, 1 route -- OMN-6585)
 
     Args:
         intent_consumer: REQUIRED intent event consumer handler.
@@ -635,9 +880,12 @@ 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).
+        graph_memory_adapter: Optional AdapterGraphMemory instance (OMN-6578).
+        intent_graph_adapter: Optional AdapterIntentGraph instance (OMN-6579).
+        navigation_history_handler: Optional HandlerNavigationHistoryReducer
+            instance (OMN-6583).
+        semantic_compute_handler: Optional HandlerSemanticCompute instance
+            (OMN-6585).
 
     Returns:
         Frozen MessageDispatchEngine ready for dispatch.
@@ -722,8 +970,18 @@ def create_memory_dispatch_engine(
         )
     )
 
-    # --- Handler 4: lifecycle orchestrator (fail-fast) ---
-    lifecycle_handler = create_lifecycle_dispatch_handler()
+    # --- Handler 4: lifecycle orchestrator (OMN-6588) ---
+    # Uses real HandlerMemoryLifecycle when components are available,
+    # falls back to no-op when none are provided.
+    from omnimemory.runtime.handler_lifecycle import HandlerMemoryLifecycle
+
+    _lifecycle = HandlerMemoryLifecycle(
+        graph_memory_adapter=graph_memory_adapter,
+        intent_graph_adapter=intent_graph_adapter,
+        navigation_handler=navigation_history_handler,
+        semantic_handler=semantic_compute_handler,
+    )
+    lifecycle_handler = _create_lifecycle_bridge_handler(lifecycle=_lifecycle)
     engine.register_handler(
         handler_id="memory-lifecycle-handler",
         handler=lifecycle_handler,
@@ -792,6 +1050,81 @@ def create_memory_dispatch_engine(
             )
         )
 
+    # --- Handler 6 (optional): intent graph adapter (OMN-6579) ---
+    if intent_graph_adapter is not None:
+        intent_graph_handler = _create_intent_graph_dispatch_handler(
+            adapter=intent_graph_adapter,
+        )
+        engine.register_handler(
+            handler_id="memory-intent-graph-handler",
+            handler=intent_graph_handler,
+            category=EnumMessageCategory.COMMAND,
+            node_kind=EnumNodeKind.EFFECT,
+            message_types=None,
+        )
+        engine.register_route(
+            ModelDispatchRoute(
+                route_id="memory-intent-graph-route",
+                topic_pattern=DISPATCH_ALIAS_INTENT_GRAPH,
+                message_category=EnumMessageCategory.COMMAND,
+                handler_id="memory-intent-graph-handler",
+                description=(
+                    "Routes intent graph queries/mutations to "
+                    "AdapterIntentGraph (OMN-6579)."
+                ),
+            )
+        )
+
+    # --- Handler 7 (optional): navigation history reducer (OMN-6583) ---
+    if navigation_history_handler is not None:
+        nav_dispatch_handler = _create_navigation_history_dispatch_handler(
+            handler=navigation_history_handler,
+        )
+        engine.register_handler(
+            handler_id="memory-navigation-history-handler",
+            handler=nav_dispatch_handler,
+            category=EnumMessageCategory.COMMAND,
+            node_kind=EnumNodeKind.REDUCER,
+            message_types=None,
+        )
+        engine.register_route(
+            ModelDispatchRoute(
+                route_id="memory-navigation-history-route",
+                topic_pattern=DISPATCH_ALIAS_NAVIGATION_HISTORY,
+                message_category=EnumMessageCategory.COMMAND,
+                handler_id="memory-navigation-history-handler",
+                description=(
+                    "Routes navigation history session events to "
+                    "HandlerNavigationHistoryReducer (OMN-6583)."
+                ),
+            )
+        )
+
+    # --- Handler 8 (optional): semantic compute (OMN-6585) ---
+    if semantic_compute_handler is not None:
+        semantic_dispatch_handler = _create_semantic_compute_dispatch_handler(
+            handler=semantic_compute_handler,
+        )
+        engine.register_handler(
+            handler_id="memory-semantic-compute-handler",
+            handler=semantic_dispatch_handler,
+            category=EnumMessageCategory.COMMAND,
+            node_kind=EnumNodeKind.COMPUTE,
+            message_types=None,
+        )
+        engine.register_route(
+            ModelDispatchRoute(
+                route_id="memory-semantic-compute-route",
+                topic_pattern=DISPATCH_ALIAS_SEMANTIC_COMPUTE,
+                message_category=EnumMessageCategory.COMMAND,
+                handler_id="memory-semantic-compute-handler",
+                description=(
+                    "Routes semantic analysis requests to "
+                    "HandlerSemanticCompute (OMN-6585)."
+                ),
+            )
+        )
+
     engine.freeze()
 
     logger.info(

omninode_memory-0.14.0/src/omnimemory/runtime/handler_lifecycle.py

@@ -0,0 +1,89 @@
+# SPDX-FileCopyrightText: 2025 OmniNode.ai Inc.
+# SPDX-License-Identifier: MIT
+
+"""Real lifecycle handler for omnimemory subsystem (OMN-6588).
+
+Replaces the no-op lifecycle handler (OMN-1453, OMN-1524) with a handler that
+manages startup and shutdown of graph adapters, navigation history, and
+semantic compute components.
+"""
+
+from __future__ import annotations
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class HandlerMemoryLifecycle:
+    """Manages startup/shutdown of memory subsystem components.
+
+    Replaces the no-op handler referenced in OMN-1453 and OMN-1524.
+    Each component is optional -- the handler gracefully skips components
+    that were not provided at construction time.
+    """
+
+    def __init__(
+        self,
+        *,
+        graph_memory_adapter: object | None = None,
+        intent_graph_adapter: object | None = None,
+        navigation_handler: object | None = None,
+        semantic_handler: object | None = None,
+    ) -> None:
+        self._graph_memory = graph_memory_adapter
+        self._intent_graph = intent_graph_adapter
+        self._navigation = navigation_handler
+        self._semantic = semantic_handler
+        self._started = False
+
+    async def handle_startup(self) -> dict[str, str]:
+        """Initialize all memory subsystem components.
+
+        Returns:
+            Status dict mapping component name to initialization status.
+        """
+        statuses: dict[str, str] = {}
+        if self._graph_memory is not None:
+            statuses["graph_memory"] = "initialized"
+        if self._intent_graph is not None:
+            statuses["intent_graph"] = "initialized"
+        if self._navigation is not None:
+            statuses["navigation_history"] = "initialized"
+        if self._semantic is not None:
+            statuses["semantic_compute"] = "initialized"
+        self._started = True
+        logger.info(
+            "Memory lifecycle started (components=%d)",
+            len(statuses),
+            extra={"statuses": statuses},
+        )
+        return statuses
+
+    async def handle_shutdown(self) -> None:
+        """Graceful shutdown of memory subsystem components."""
+        self._started = False
+        logger.info("Memory lifecycle stopped")
+
+    def is_started(self) -> bool:
+        """Check if the lifecycle handler has been started."""
+        return self._started
+
+    @property
+    def component_count(self) -> int:
+        """Number of components managed by this lifecycle handler."""
+        count = 0
+        if self._graph_memory is not None:
+            count += 1
+        if self._intent_graph is not None:
+            count += 1
+        if self._navigation is not None:
+            count += 1
+        if self._semantic is not None:
+            count += 1
+        return count
+
+
+__all__: list[str] = [
+    "HandlerMemoryLifecycle",
+]