fix: add rlm_core Python stub package for maturin 1.12 compatibility

Maturin 1.12 (PR #2986) changed the behavior of python-source config:
a missing Python module directory is now an error instead of a warning.
This broke wheel builds since rlm_core/ didn't exist as a Python package.

Creates a proper rlm_core/ package with:
- __init__.py: re-exports all types from compiled extension with graceful ImportError
- py.typed: PEP 561 marker for type checker discovery
- Comprehensive .pyi type stubs for all 50+ PyO3-exported classes across
  context, memory, LLM, trajectory, complexity, and epistemic modules

Bumps version to 0.7.2.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rand

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "rlm-claude-code",
       "source": "./",
       "description": "Recursive Language Model integration for Claude Code - Go binary hooks (~5ms startup), cross-plugin event coordination (DP/RLM), version-aware config migration, and intelligent multi-provider routing",
-      "version": "0.7.1"
+      "version": "0.7.2"
     }
   ]
 }

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "rlm-claude-code",
   "description": "Recursive Language Model integration for Claude Code - intelligent multi-provider routing and unbounded context handling",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "author": {
     "name": "Rand",
     "url": "https://github.com/rand"

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.7.2] - 2026-02-19
+
+### Fixed
+- **maturin 1.12 build compatibility**: Created `rlm_core/` Python stub package to satisfy `python-source = "."` config (maturin 1.12 changed missing module directory from warning to error)
+- Added PEP 561 `py.typed` marker and comprehensive `.pyi` type stubs for all PyO3-exported types (context, memory, LLM, trajectory, complexity, epistemic)
+
+### Added
+- Full IDE type support for `rlm_core` native extension (autocompletion, type checking)
+
 ## [0.7.1] - 2026-02-19
 
 ### Fixed

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rlm-claude-code"
-version = "0.7.1"
+version = "0.7.2"
 description = "Recursive Language Model integration for Claude Code"
 readme = "README.md"
 requires-python = ">=3.12"

rlm_core/__init__.py

@@ -0,0 +1,125 @@
+"""rlm_core — Rust-native RLM orchestration library with Python bindings.
+
+This package provides Python access to the rlm-core Rust library via PyO3.
+All types are defined in the compiled extension module; this file re-exports
+them for convenient access and provides a graceful error message if the
+native extension is unavailable.
+"""
+
+from __future__ import annotations
+
+try:
+    from rlm_core.rlm_core import *  # noqa: F401, F403
+    from rlm_core.rlm_core import (
+        # Module-level functions
+        available_features,
+        has_feature,
+        quick_hallucination_check,
+        version,
+        version_tuple,
+        # Context
+        Message,
+        Role,
+        SessionContext,
+        ToolOutput,
+        # Memory
+        HyperEdge,
+        MemoryStats,
+        MemoryStore,
+        Node,
+        NodeType,
+        Tier,
+        # LLM
+        ChatMessage,
+        CompletionRequest,
+        CompletionResponse,
+        CostTracker,
+        ModelSpec,
+        ModelTier,
+        Provider,
+        QueryType,
+        RoutingContext,
+        RoutingDecision,
+        SmartRouter,
+        TokenUsage,
+        # Trajectory
+        TrajectoryEvent,
+        TrajectoryEventType,
+        # Complexity
+        ActivationDecision,
+        PatternClassifier,
+        # Epistemic
+        BudgetResult,
+        Claim,
+        ClaimCategory,
+        ClaimExtractor,
+        EvidenceRef,
+        EvidenceType,
+        GroundingStatus,
+        KL,
+        Probability,
+        VerificationConfig,
+        VerificationStats,
+        VerificationVerdict,
+    )
+except ImportError as _e:
+    _msg = (
+        "rlm_core native extension is not available. "
+        "This typically means the Rust library was not compiled for your platform. "
+        "Install from a pre-built wheel: pip install rlm-claude-code\n"
+        f"Original error: {_e}"
+    )
+    raise ImportError(_msg) from _e
+
+__all__ = [
+    # Functions
+    "available_features",
+    "has_feature",
+    "quick_hallucination_check",
+    "version",
+    "version_tuple",
+    # Context
+    "Message",
+    "Role",
+    "SessionContext",
+    "ToolOutput",
+    # Memory
+    "HyperEdge",
+    "MemoryStats",
+    "MemoryStore",
+    "Node",
+    "NodeType",
+    "Tier",
+    # LLM
+    "ChatMessage",
+    "CompletionRequest",
+    "CompletionResponse",
+    "CostTracker",
+    "ModelSpec",
+    "ModelTier",
+    "Provider",
+    "QueryType",
+    "RoutingContext",
+    "RoutingDecision",
+    "SmartRouter",
+    "TokenUsage",
+    # Trajectory
+    "TrajectoryEvent",
+    "TrajectoryEventType",
+    # Complexity
+    "ActivationDecision",
+    "PatternClassifier",
+    # Epistemic
+    "BudgetResult",
+    "Claim",
+    "ClaimCategory",
+    "ClaimExtractor",
+    "EvidenceRef",
+    "EvidenceType",
+    "GroundingStatus",
+    "KL",
+    "Probability",
+    "VerificationConfig",
+    "VerificationStats",
+    "VerificationVerdict",
+]

rlm_core/__init__.pyi

@@ -0,0 +1,49 @@
+"""Type stubs for the rlm_core native extension module."""
+
+from __future__ import annotations
+
+# Re-export everything from submodules for flat access
+from rlm_core._context import Message as Message
+from rlm_core._context import Role as Role
+from rlm_core._context import SessionContext as SessionContext
+from rlm_core._context import ToolOutput as ToolOutput
+from rlm_core._memory import HyperEdge as HyperEdge
+from rlm_core._memory import MemoryStats as MemoryStats
+from rlm_core._memory import MemoryStore as MemoryStore
+from rlm_core._memory import Node as Node
+from rlm_core._memory import NodeType as NodeType
+from rlm_core._memory import Tier as Tier
+from rlm_core._llm import ChatMessage as ChatMessage
+from rlm_core._llm import CompletionRequest as CompletionRequest
+from rlm_core._llm import CompletionResponse as CompletionResponse
+from rlm_core._llm import CostTracker as CostTracker
+from rlm_core._llm import ModelSpec as ModelSpec
+from rlm_core._llm import ModelTier as ModelTier
+from rlm_core._llm import Provider as Provider
+from rlm_core._llm import QueryType as QueryType
+from rlm_core._llm import RoutingContext as RoutingContext
+from rlm_core._llm import RoutingDecision as RoutingDecision
+from rlm_core._llm import SmartRouter as SmartRouter
+from rlm_core._llm import TokenUsage as TokenUsage
+from rlm_core._trajectory import TrajectoryEvent as TrajectoryEvent
+from rlm_core._trajectory import TrajectoryEventType as TrajectoryEventType
+from rlm_core._complexity import ActivationDecision as ActivationDecision
+from rlm_core._complexity import PatternClassifier as PatternClassifier
+from rlm_core._epistemic import BudgetResult as BudgetResult
+from rlm_core._epistemic import Claim as Claim
+from rlm_core._epistemic import ClaimCategory as ClaimCategory
+from rlm_core._epistemic import ClaimExtractor as ClaimExtractor
+from rlm_core._epistemic import EvidenceRef as EvidenceRef
+from rlm_core._epistemic import EvidenceType as EvidenceType
+from rlm_core._epistemic import GroundingStatus as GroundingStatus
+from rlm_core._epistemic import KL as KL
+from rlm_core._epistemic import Probability as Probability
+from rlm_core._epistemic import VerificationConfig as VerificationConfig
+from rlm_core._epistemic import VerificationStats as VerificationStats
+from rlm_core._epistemic import VerificationVerdict as VerificationVerdict
+
+def version() -> str: ...
+def version_tuple() -> tuple[int, int, int]: ...
+def has_feature(feature_name: str) -> bool: ...
+def available_features() -> list[str]: ...
+def quick_hallucination_check(response: str) -> float: ...

rlm_core/_complexity.pyi

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from rlm_core._context import SessionContext
+
+class ActivationDecision:
+    should_activate: bool
+    reason: str
+    score: int
+
+class PatternClassifier:
+    def __init__(self) -> None: ...
+    def should_activate(self, query: str, context: SessionContext) -> ActivationDecision: ...

rlm_core/_context.pyi

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+from typing import Any
+
+class Role:
+    User: Role
+    Assistant: Role
+    System: Role
+    Tool: Role
+
+class Message:
+    role: Role
+    content: str
+    timestamp: str | None
+
+    def __init__(self, role: Role, content: str, timestamp: str | None = None) -> None: ...
+    @staticmethod
+    def user(content: str) -> Message: ...
+    @staticmethod
+    def assistant(content: str) -> Message: ...
+    @staticmethod
+    def system(content: str) -> Message: ...
+    @staticmethod
+    def tool(content: str) -> Message: ...
+
+class ToolOutput:
+    tool_name: str
+    content: str
+    exit_code: int | None
+    timestamp: str | None
+
+    def __init__(self, tool_name: str, content: str, exit_code: int | None = None) -> None: ...
+    def is_success(self) -> bool: ...
+
+class SessionContext:
+    def __init__(self) -> None: ...
+    def add_message(self, message: Message) -> None: ...
+    def add_user_message(self, content: str) -> None: ...
+    def add_assistant_message(self, content: str) -> None: ...
+    def cache_file(self, path: str, content: str) -> None: ...
+    def add_tool_output(self, output: ToolOutput) -> None: ...
+    def set_memory(self, key: str, value: Any) -> None: ...
+    def get_memory(self, key: str) -> Any: ...
+    def messages(self) -> list[Message]: ...
+    def last_messages(self, n: int) -> list[Message]: ...
+    def files(self) -> dict[str, str]: ...
+    def get_file(self, path: str) -> str | None: ...
+    def tool_outputs(self) -> list[ToolOutput]: ...
+    def message_count(self) -> int: ...
+    def file_count(self) -> int: ...
+    def spans_multiple_directories(self) -> bool: ...
+    def total_message_tokens(self) -> int: ...