npm - claude-smart - Versions diffs - 0.2.45 → 0.2.47 - Mend

claude-smart 0.2.45 → 0.2.47

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (353) hide show

package/plugin/src/claude_smart/cs_cite.py CHANGED Viewed

@@ -85,36 +85,83 @@ WHEN_TO_CITE_COMPACT = (
 _COMPACT_INTRO = f"_{WHEN_TO_CITE}"
+# Public repo the citation marker attributes its learnings to. The cue rides
+# along on every emitted marker so users see that the applied learning was
+# generated by Reflexio (and can star the repo).
+REFLEXIO_REPO_URL = "https://github.com/ReflexioAI/reflexio"
+MARKER_PREFIX = "✨ claude-smart rule applied:"
+_ATTRIBUTION_LABEL = "⚡Reflexio"
+def _osc8_link(url: str, text: str) -> str:
+    """Wrap ``text`` in an OSC 8 terminal hyperlink pointing at ``url``."""
+    return f"\x1b]8;;{url}\x1b\\{text}\x1b]8;;\x1b\\"
+def marker_attribution(link_style: str = "markdown") -> str:
+    """Return the trailing ``· ⚡Reflexio`` attribution, linked to the repo.
+    Args:
+        link_style (str): ``"markdown"`` for a markdown link, or ``"osc8"`` for
+            a terminal-native hyperlink. Unknown values fall back to markdown.
+    Returns:
+        str: The attribution segment, beginning with a leading separator.
+    """
+    if link_style == "osc8":
+        return f" · {_osc8_link(REFLEXIO_REPO_URL, _ATTRIBUTION_LABEL)}"
+    return f" · [{_ATTRIBUTION_LABEL}]({REFLEXIO_REPO_URL})"
+def build_marker(body: str, link_style: str = "markdown") -> str:
+    """Build the full citation marker line, including the Reflexio attribution.
+    Single source of truth for the marker line so the prefix and attribution
+    cannot drift across the markdown / OSC 8 / compact render paths.
+    Args:
+        body (str): The linked memory title(s) — already formatted as markdown
+            or OSC 8 links, joined with `` | `` for multiple items.
+        link_style (str): ``"markdown"`` or ``"osc8"``; selects the attribution
+            link form.
+    Returns:
+        str: ``✨ claude-smart rule applied: <body> · ⚡Reflexio``.
+    """
+    return f"{MARKER_PREFIX} {body}{marker_attribution(link_style)}"
+MARKDOWN_EXAMPLE_ONE = build_marker(
+    "[verify process state](http://localhost:3001/rules/s1-123)", "markdown"
+)
+_MARKDOWN_EXAMPLE_MULTI = build_marker(
+    "[git safety](http://localhost:3001/rules/s1-123) | "
+    "[brief answer preference](http://localhost:3001/rules/p1-pref)",
+    "markdown",
+)
 _MARKDOWN_MARKER_PARAGRAPH = (
     "How to format: use human-readable linked titles, not raw ids. "
     "Format for one item: "
-    "`✨ claude-smart rule applied: "
-    "[verify process state](http://localhost:3001/rules/s1-123)`. "
+    f"`{MARKDOWN_EXAMPLE_ONE}`. "
     "For multiple items: "
-    "`✨ claude-smart rule applied: "
-    "[git safety](http://localhost:3001/rules/s1-123) | "
-    "[brief answer preference](http://localhost:3001/rules/p1-pref)`. "
+    f"`{_MARKDOWN_EXAMPLE_MULTI}`. "
+    "Always end the marker with the ` · ⚡Reflexio` attribution shown — a link "
+    "to the reflexio repo — exactly as given. "
     "Separate multiple linked memories with the visible ` | ` separator. "
     "Use the dashboard URL shown beside each cited item; do not invent URLs. "
     "Do not include `[cs:…]` ids in the marker line. Never use the old "
     "`✨ 1 claude-smart learning applied [cs:...]` marker format._"
 )
-_OSC8_EXAMPLE_ONE = (
-    "✨ claude-smart rule applied: "
-    "\x1b]8;;http://localhost:3001/rules/s1-123\x1b\\"
-    "verify process state"
-    "\x1b]8;;\x1b\\"
+_OSC8_EXAMPLE_ONE = build_marker(
+    _osc8_link("http://localhost:3001/rules/s1-123", "verify process state"),
+    "osc8",
 )
-_OSC8_EXAMPLE_MULTI = (
-    "✨ claude-smart rule applied: "
-    "\x1b]8;;http://localhost:3001/rules/s1-123\x1b\\"
-    "git safety"
-    "\x1b]8;;\x1b\\"
-    " | "
-    "\x1b]8;;http://localhost:3001/rules/p1-pref\x1b\\"
-    "brief answer preference"
-    "\x1b]8;;\x1b\\"
+_OSC8_EXAMPLE_MULTI = build_marker(
+    _osc8_link("http://localhost:3001/rules/s1-123", "git safety")
+    + " | "
+    + _osc8_link("http://localhost:3001/rules/p1-pref", "brief answer preference"),
+    "osc8",
 )
 _OSC8_MARKER_PARAGRAPH = (
     "How to format: use human-readable OSC 8 terminal hyperlinks, not raw ids "

package/plugin/src/claude_smart/env_config.py CHANGED Viewed

@@ -1,11 +1,19 @@
-"""Shared ``~/.reflexio/.env`` helpers for claude-smart."""
+"""Shared ``~/.claude-smart/.env`` helpers for claude-smart.
+claude-smart keeps its env under ``~/.claude-smart`` (not ``~/.reflexio``) so an
+OSS reflexio backend sharing this machine never leaks its ``.env`` into
+claude-smart. The data directory stays shared at ``~/.reflexio/data``. This path
+must stay in sync with the ``REFLEXIO_ENV_FILE`` export in
+``scripts/backend-service.sh`` and the source path in
+``scripts/_lib.sh`` (``claude_smart_source_reflexio_env``).
+"""
 from __future__ import annotations
 import os
 from pathlib import Path
-REFLEXIO_ENV_PATH = Path.home() / ".reflexio" / ".env"
+REFLEXIO_ENV_PATH = Path.home() / ".claude-smart" / ".env"
 MANAGED_REFLEXIO_URL = "https://www.reflexio.ai/"
 REFLEXIO_URL_ENV = "REFLEXIO_URL"
 REFLEXIO_API_KEY_ENV = "REFLEXIO_API_KEY"
@@ -60,7 +68,7 @@ def parse_env_line(line: str) -> tuple[str, str] | None:
 def load_reflexio_env(path: Path | None = None) -> None:
-    """Load ``~/.reflexio/.env`` into ``os.environ`` without overriding values."""
+    """Load ``~/.claude-smart/.env`` into ``os.environ`` without overriding values."""
     path = path or REFLEXIO_ENV_PATH
     try:
         text = path.read_text()
@@ -111,7 +119,7 @@ def set_env_vars(path: Path, values: dict[str, str]) -> list[str]:
 def ensure_local_env_defaults(path: Path | None = None) -> list[str]:
-    """Create or augment ``~/.reflexio/.env`` for claude-smart local mode.
+    """Create or augment ``~/.claude-smart/.env`` for claude-smart local mode.
     Existing active assignments win. This repairs first installs and deleted
     env files without clobbering explicit user overrides such as

package/plugin/src/claude_smart/events/session_start.py CHANGED Viewed

@@ -5,8 +5,10 @@ from __future__ import annotations
 import json
 import os
 import sys
+from contextlib import suppress
 from pathlib import Path
 from typing import Any
+from urllib.parse import urlparse
 from claude_smart import hook
 from claude_smart.reflexio_adapter import Adapter
@@ -41,10 +43,12 @@ def _int_env(name: str, default: int) -> int:
 _CLAUDE_SMART_WINDOW_SIZE = _int_env("CLAUDE_SMART_WINDOW_SIZE", 5)
 _CLAUDE_SMART_STRIDE_SIZE = _int_env("CLAUDE_SMART_STRIDE_SIZE", 3)
-# Optimizer is on by default. Set this env var to "0" to skip pushing the
-# claude-smart optimizer defaults on SessionStart (kill switch).
-_DISABLE_OPTIMIZER_ENV = "CLAUDE_SMART_ENABLE_OPTIMIZER"
+# Optimizer defaults are local-only by default because they store an absolute
+# path to the claude-smart helper process. Set this env var to "1" to force
+# enabling against a non-local Reflexio URL, or "0" to disable everywhere.
+_OPTIMIZER_ENV = "CLAUDE_SMART_ENABLE_OPTIMIZER"
 _OPTIMIZER_TIMEOUT_SECONDS = 300
+_LOCAL_REFLEXIO_HOSTS = {"", "localhost", "127.0.0.1", "::1"}
 def _adapter() -> Adapter:
@@ -109,7 +113,7 @@ def handle(payload: dict[str, Any]) -> None:
         window_size=_CLAUDE_SMART_WINDOW_SIZE,
         stride_size=_CLAUDE_SMART_STRIDE_SIZE,
     )
-    if os.environ.get(_DISABLE_OPTIMIZER_ENV) != "0":
+    if _should_apply_optimizer_defaults(adapter):
         adapter.apply_optimizer_defaults(
             script_path=_optimizer_assistant_path(),
             timeout_seconds=_OPTIMIZER_TIMEOUT_SECONDS,
@@ -131,13 +135,28 @@ def handle(payload: dict[str, Any]) -> None:
     )
     sys.stdout.write("\n")
-    try:
+    with suppress(Exception):
         adapter.mark_stall_notified()
-    except Exception:  # noqa: BLE001 — telemetry must not break session.
-        pass
 def _optimizer_assistant_path() -> str:
     executable = Path(sys.executable)
     suffix = ".exe" if os.name == "nt" else ""
     return str(executable.with_name(f"claude-smart-optimizer-assistant{suffix}"))
+def _should_apply_optimizer_defaults(adapter: Any) -> bool:
+    flag = os.environ.get(_OPTIMIZER_ENV, "").strip().lower()
+    if flag in {"0", "false", "no", "off"}:
+        return False
+    if flag in {"1", "true", "yes", "on"}:
+        return True
+    return _is_local_reflexio_url(getattr(adapter, "url", ""))
+def _is_local_reflexio_url(url: str) -> bool:
+    if not url:
+        return True
+    parsed = urlparse(url)
+    host = parsed.hostname if parsed.scheme else url.split(":", 1)[0]
+    return (host or "").lower() in _LOCAL_REFLEXIO_HOSTS

package/plugin/src/claude_smart/events/stop.py CHANGED Viewed

@@ -377,7 +377,7 @@ def handle(payload: dict[str, Any]) -> tuple[publish.PublishStatus, int] | None:
     last_assistant_message = payload.get("last_assistant_message")
     assistant_text = (
         last_assistant_message
-        if runtime.is_codex()
+        if (runtime.is_codex() or runtime.is_opencode())
         and isinstance(last_assistant_message, str)
         and last_assistant_message
         else _scan_transcript_for_assistant_text(entries)

package/plugin/src/claude_smart/ids.py CHANGED Viewed

@@ -77,7 +77,7 @@ def resolve_user_id(cwd: str | os.PathLike[str] | None = None) -> str:
     Honors the ``REFLEXIO_USER_ID`` env var as an explicit override (e.g. so a
     user can point multiple projects at a single Reflexio identity), and
     otherwise falls back to :func:`resolve_project_id`. The env var is
-    loaded from ``~/.reflexio/.env`` before reading the process environment so
+    loaded from ``~/.claude-smart/.env`` before reading the process environment so
     CLI commands and hooks use the same identity resolution.
     Args:

package/plugin/src/claude_smart/reflexio_adapter.py CHANGED Viewed

@@ -6,16 +6,15 @@ Exists so hook handlers (a) don't import reflexio directly at module scope
 from __future__ import annotations
+import inspect
 import logging
 import os
-import inspect
 from collections.abc import Sequence
 from concurrent.futures import ThreadPoolExecutor
 from dataclasses import dataclass, field
 from typing import Any
-from claude_smart import env_config
-from claude_smart import runtime
+from claude_smart import env_config, runtime
 _LOGGER = logging.getLogger(__name__)
@@ -174,8 +173,9 @@ class Adapter:
         Idempotent compare-then-write: reads ``Config``, only issues a
         ``set_config`` when the server-side values differ from the desired
-        dict below. Called unconditionally from SessionStart; the caller's
-        only escape hatch is ``CLAUDE_SMART_ENABLE_OPTIMIZER=0``.
+        dict below. SessionStart calls this only for local Reflexio URLs by
+        default; ``CLAUDE_SMART_ENABLE_OPTIMIZER=1`` forces hosted URLs, and
+        ``CLAUDE_SMART_ENABLE_OPTIMIZER=0`` disables it everywhere.
         """
         client = self._get_client()
         if client is None:

package/plugin/src/claude_smart/runtime.py CHANGED Viewed

@@ -14,7 +14,8 @@ INTERNAL_ENV = "CLAUDE_SMART_INTERNAL"
 HOST_CLAUDE_CODE = "claude-code"
 HOST_CODEX = "codex"
-VALID_HOSTS = frozenset({HOST_CLAUDE_CODE, HOST_CODEX})
+HOST_OPENCODE = "opencode"
+VALID_HOSTS = frozenset({HOST_CLAUDE_CODE, HOST_CODEX, HOST_OPENCODE})
 _SHARED_AGENT_VERSION = "claude-code"
 _current_host: str | None = None
@@ -42,6 +43,11 @@ def is_codex() -> bool:
     return host() == HOST_CODEX
+def is_opencode() -> bool:
+    """True when the current hook invocation came from OpenCode."""
+    return host() == HOST_OPENCODE
 def agent_version() -> str:
     """Reflexio agent version used for shared learning across hosts."""
     return _SHARED_AGENT_VERSION

package/plugin/uv.lock CHANGED Viewed

@@ -476,7 +476,7 @@ wheels = [
 [[package]]
 name = "claude-smart"
-version = "0.2.45"
+version = "0.2.47"
 source = { editable = "." }
 dependencies = [
     { name = "chromadb" },
@@ -494,7 +494,7 @@ dev = [
 requires-dist = [
     { name = "chromadb", specifier = ">=0.5" },
     { name = "einops", specifier = ">=0.8.0" },
-    { name = "reflexio-ai", specifier = ">=0.2.25" },
+    { name = "reflexio-ai", specifier = ">=0.2.27" },
     { name = "sqlite-vec", specifier = ">=0.1.6" },
 ]
@@ -2760,7 +2760,7 @@ wheels = [
 [[package]]
 name = "reflexio-ai"
-version = "0.2.25"
+version = "0.2.27"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiohttp" },
@@ -2800,9 +2800,9 @@ dependencies = [
     { name = "websocket-client" },
     { name = "xlsxwriter" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/0f/da/323d788e55db2041caf1ffbb52a3536b959ac12ee8e22d40e7d53da10e96/reflexio_ai-0.2.25.tar.gz", hash = "sha256:4435145c865e397a9e4fb86560fa9378ba9094e99646f9c2df65cb4de7dd4fac", size = 754836, upload-time = "2026-06-10T18:03:11.997Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/85/22/64429eb84ae74aaa6d36f0a2e0d91a27b35ee33ef17c18411d54f08706ba/reflexio_ai-0.2.27.tar.gz", hash = "sha256:e433209ca848245e957943c6476f2bba32581de8804d535d25ca0596b0da0afd", size = 1112139, upload-time = "2026-06-30T06:26:21.88Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/16/7c/ef6cfaf172eecc02d6834828c549c314d013b6b3019bf7186dc50eeb9c5c/reflexio_ai-0.2.25-py3-none-any.whl", hash = "sha256:927b20323cbfe6a32df2092ce617ed2abec78a57b8c70e61eff501862b455dca", size = 1024584, upload-time = "2026-06-10T18:03:13.525Z" },
+    { url = "https://files.pythonhosted.org/packages/68/22/d65332c75b9072e8838d51f68354d8d17c7636aa1cf73a20cfc1147b4364/reflexio_ai-0.2.27-py3-none-any.whl", hash = "sha256:4598f4aaa61e3c755a04573ab9711a7b5673ebf268029b2cef21cdcd5d4abfcf", size = 1461400, upload-time = "2026-06-30T06:26:19.965Z" },
 ]
 [[package]]

package/plugin/vendor/reflexio/.env.example CHANGED Viewed

@@ -1,17 +1,32 @@
-# .env
+# =============================================================================
+# Reflexio (open source) — example environment file
+# =============================================================================
+# Copy to `.env` and fill in the values you need. The open-source CLI runs with
+# SQLite storage and no auth by default, so the only thing you must set is one
+# LLM provider key.
+#
+# LEGEND:
+#   (optional) = safe to leave empty; code default shown
+#   options:   = allowed values for a categorical variable
+# =============================================================================
-# ====================
-# LLM API Keys
-# ====================
+# =============================================================================
+# 1. LLM PROVIDER KEYS
+# =============================================================================
 # Set at least one API key. The system auto-detects available providers and
-# selects appropriate default models per role (generation, evaluation, should_run,
-# pre_retrieval, embedding). Provider priority when multiple keys are set:
-# Anthropic > Gemini > OpenRouter > DeepSeek > MiniMax > DashScope > xAI > Moonshot > ZAI > OpenAI
+# selects appropriate default models per role (generation, evaluation,
+# should_run, pre_retrieval, embedding).
+#
+# Provider priority when multiple keys are set:
+#   Anthropic > Gemini > OpenRouter > DeepSeek > MiniMax > DashScope > xAI >
+#   Moonshot > ZAI > OpenAI
 # For the embedding role, if the top-priority provider has no embedding support,
 # the next embedding-capable provider is used (currently OpenAI or Gemini).
+#
 # Model resolution order (highest priority first):
 #   1. Org-level LLMConfig override
-#   2. Non-empty values in reflexio/server/site_var/site_var_sources/llm_model_setting.json
+#   2. Non-empty values in
+#      reflexio/server/site_var/site_var_sources/llm_model_setting.json
 #   3. Auto-detected default for the primary available provider
 OPENAI_API_KEY=
 ANTHROPIC_API_KEY=
@@ -24,39 +39,48 @@ ZAI_API_KEY=
 MOONSHOT_API_KEY=
 XAI_API_KEY=
-# ====================
-# Observability (Optional)
-# ====================
-# Set to enable Braintrust LLM observability (https://www.braintrust.dev)
+# =============================================================================
+# 2. OBSERVABILITY (optional)
+# =============================================================================
+# Set to enable Braintrust LLM observability (https://www.braintrust.dev).
 # BRAINTRUST_API_KEY=
 # BRAINTRUST_PROJECT_NAME=reflexio
-# ====================
-# Local Storage Configuration
-# ====================
+# =============================================================================
+# 3. STORAGE
+# =============================================================================
 # Local storage directory — houses disk-storage artifacts and the SQLite
-# database file (reflexio.db). Defaults to ~/.reflexio/data/.
+# database file (reflexio.db). (optional; default ~/.reflexio/data/)
 LOCAL_STORAGE_PATH=
+# Default org id for no-auth / local mode. Controls the request org, and hence
+# the config file name (config_<org>.json) and the SQLite data scope. Override
+# it to run a second local backend under a distinct org so the two don't collide
+# on the same config file under ~/.reflexio/. (optional; default self-host-org)
+REFLEXIO_DEFAULT_ORG_ID=self-host-org
-# ====================
-# Extraction
-# ====================
+# =============================================================================
+# 4. EXTRACTION
+# =============================================================================
 # Per-interaction content token budget when formatting interactions into an
 # extraction/evaluation prompt. When an interaction's content exceeds this many
 # tokens, the first half and last half are kept (head + tail) and the middle is
-# elided. Set to <=0 to disable slicing (pass full content). Default 512.
+# elided. (optional; default 512; set <= 0 to disable slicing and pass full
+# content)
 REFLEXIO_MAX_INTERACTION_CONTENT_TOKENS=512
+# Inactivity delay in seconds before a quiet session is evaluated by agent-success
+# evaluation. (optional; default 600 = 10 minutes)
+GROUP_EVALUATION_DELAY_SECONDS=600
-# ====================
-# Testing & Logging
-# ====================
-# Set to true to enable test environment mode
-IS_TEST_ENV=true
-# Set to enable debug logging to console
+# =============================================================================
+# 5. TESTING & LOGGING
+# =============================================================================
+# Verbose debug logging to console.  options: true | false
 DEBUG_LOG_TO_CONSOLE=true
-# Mock LLM call response
+# Mark the process as a test environment.  options: true | false
+IS_TEST_ENV=true
+# Return canned LLM responses instead of calling providers.  options: true | false
 MOCK_LLM_RESPONSE=false
-# Override the base directory for log files. The .reflexio/logs suffix is
-# always preserved, so e.g. REFLEXIO_LOG_DIR=/tmp/foo writes logs to
-# /tmp/foo/.reflexio/logs/. Defaults to $HOME (i.e. ~/.reflexio/logs/).
+# Override the base directory for log files. The .reflexio/logs suffix is always
+# preserved, so e.g. REFLEXIO_LOG_DIR=/tmp/foo writes logs to
+# /tmp/foo/.reflexio/logs/. (optional; default $HOME -> ~/.reflexio/logs/)
 REFLEXIO_LOG_DIR=

package/plugin/vendor/reflexio/README.md CHANGED Viewed

@@ -7,12 +7,13 @@
 [![Python >= 3.12](https://img.shields.io/badge/python-%3E%3D3.12-blue)](https://www.python.org/)
 [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
-[![PyPI](https://img.shields.io/pypi/v/reflexio-client)](https://pypi.org/project/reflexio-client/)
+[![PyPI](https://img.shields.io/pypi/v/reflexio-ai)](https://pypi.org/project/reflexio-ai/)
 [![Downloads](https://static.pepy.tech/badge/reflexio-ai/month)](https://pepy.tech/project/reflexio-ai)
 [![Search p50 57ms](https://img.shields.io/badge/search-57ms%20p50-brightgreen)](reflexio/benchmarks/retrieval_latency/results/report.md)
 [![GitHub stars](https://img.shields.io/github/stars/ReflexioAI/reflexio)](https://github.com/ReflexioAI/reflexio/stargazers)
+[![Discord](https://img.shields.io/badge/Discord-Join%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/7fnCxahase)
-[Quick Start](#quick-start) · [Features](#features) · [Integrations](#integrations) · [SDK](#sdk-usage) · [CLI](reflexio/cli/README.md) · [Architecture](#architecture) · [Docs](https://www.reflexio.ai/docs) · [Contributing](#contributing)
+[Quick Start](#quick-start) · [Features](#features) · [Integrations](#integrations) · [SDK](#sdk-usage) · [CLI](reflexio/cli/README.md) · [Architecture](#architecture) · [Docs](https://www.reflexio.ai/docs) · [Community](#community) · [Contributing](#contributing)
 </div>
@@ -85,6 +86,7 @@ Publish conversations from your agent, and Reflexio closes the self-improvement
 - [SDK Usage](#sdk-usage)
 - [Architecture](#architecture)
 - [Documentation](#documentation)
+- [Community](#community)
 - [Contributing](#contributing)
 - [Star History](#star-history)
 - [License](#license)
@@ -116,7 +118,7 @@ Publish conversations from your agent, and Reflexio closes the self-improvement
 pip install reflexio-ai
 # start/stop services. data saved under ~/.reflexio
-reflexio services start           # API (8081), Docs (8082), SQLite storage
+reflexio services start           # API (8061), Docs (8062), SQLite storage
 reflexio services stop            # Stop all services
 ```
@@ -135,13 +137,13 @@ uv sync                                    # Python (includes workspace packages
 npm --prefix docs install                  # API docs
 # start/stop services. data saved under ~/.reflexio
-uv run reflexio services start             # API (8081), Docs (8082), SQLite storage
+uv run reflexio services start             # API (8061), Docs (8062), SQLite storage
 uv run reflexio services stop              # Stop all services
 ```
 > Alternative: `python -m reflexio.cli services start` or `./run_services.sh`
-Once running, open **[http://localhost:8082](http://localhost:8082)** to interactively browse and try out the API.
+Once running, open **[http://localhost:8062](http://localhost:8062)** to interactively browse and try out the API.
 <p align="center">
   <img src="docs/images/doc_website.png" width="800px" alt="Reflexio Doc Website">
 </p>
@@ -172,7 +174,7 @@ One conversation, two artifacts: a user profile (`production region is us-west-2
 import reflexio
 client = reflexio.ReflexioClient(
-    url_endpoint="http://localhost:8081/"
+    url_endpoint="http://localhost:8061/"
 )
 # Publish a multi-turn conversation where the user corrects the agent —
@@ -222,7 +224,7 @@ Reflexio will automatically generate profiles and extract playbooks in the backg
 - Session-level evaluation triggered automatically (10 min after last request)
 - Shadow comparison mode: A/B test regular vs shadow agent responses
 - Tool usage analysis for blocking issue detection
-- **Causal measurement of Reflexio's impact** — session-level A/B grouping on the Evaluation page driven by `Request.metadata.reflexio_retrieval_enabled` (with per-turn shadow comparison in development)
+- **Causal measurement of Reflexio's impact** — source-set comparison on the Evaluation page groups evaluated sessions by the first request's `source`
 [Read more about evaluation →](https://www.reflexio.ai/docs/examples/agent-evaluation)
@@ -242,10 +244,10 @@ Reflexio will automatically generate profiles and extract playbooks in the backg
 For detailed API documentation, see the [full API reference](https://www.reflexio.ai/docs/api-reference).
-Install the client:
+Install the package:
 ```shell
-pip install reflexio-client
+pip install reflexio-ai
 ```
 ### Basic usage
@@ -254,7 +256,7 @@ pip install reflexio-client
 import reflexio
 client = reflexio.ReflexioClient(
-    url_endpoint="http://localhost:8081/"
+    url_endpoint="http://localhost:8061/"
 )
 # Publish interactions
@@ -265,7 +267,7 @@ client.publish_interaction(
         {"role": "assistant", "content": "..."},
     ],
     agent_version="v1",       # optional: track agent versions
-    session_id="session-abc", # optional: group requests into sessions
+    session_id="session-abc", # required: stable conversation/session id
 )
 # Search profiles
@@ -325,6 +327,10 @@ For comprehensive guides, examples, and API reference, visit the **[Reflexio Doc
 For coding agents adding Reflexio to another agent, see **[Integrating an AI Agent with Reflexio](AI_AGENT_INTEGRATION.md)**.
+## Community
+Join the Reflexio community on Discord: [discord.gg/7fnCxahase](https://discord.gg/7fnCxahase).
 ## Contributing
 We welcome contributions! Please see [developer.md](developer.md) for guidelines.

package/plugin/vendor/reflexio/pyproject.toml CHANGED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "reflexio-ai"
-version = "0.2.24"
+version = "0.2.27"
 description = "A Python library for the Reflexio"
 authors = [{name = "Reflexio Team"}]
 readme = "README.md"
@@ -139,6 +139,9 @@ markers = [
     "e2e: Full workflow tests with real storage and services",
     "requires_credentials: Tests that need API keys (costs money)",
 ]
+filterwarnings = [
+    "ignore:This process \\(pid=.*\\) is multi-threaded, use of fork\\(\\) may lead to deadlocks in the child\\.:DeprecationWarning:multiprocessing\\.popen_fork",
+]
 [tool.coverage.run]
 # Measure branch coverage — ensures both if/else paths are tested, not just lines
@@ -217,6 +220,12 @@ ignore = [
 "reflexio/server/api.py" = ["B008", "ARG001", "ARG002"]
 "reflexio/server/api_endpoints/**" = ["B008", "ARG001", "ARG002"]
 "reflexio/integrations/**" = ["ARG002"]
+# The openclaw plugin is a nested package; its tests/scripts/cli are not reached
+# by the top-level "tests/**" / "reflexio/cli/**" globs above (those only match
+# at the tree root), so mirror the same standard test/cli ignores here.
+"reflexio/integrations/openclaw/plugin/tests/**" = ["S101", "ARG001", "ARG002", "ARG005", "PTH", "ANN", "S105", "S106", "S107", "S108", "S310", "N802", "N806"]
+"reflexio/integrations/openclaw/plugin/scripts/**" = ["S101", "G004", "ANN", "S603", "S607"]
+"reflexio/integrations/openclaw/plugin/src/openclaw_smart/cli.py" = ["S603", "S607"]
 "reflexio/server/services/configurator/test_config_storage.py" = ["S101", "ANN", "S108"]
 "demo/**" = ["S101", "PTH", "G004", "ANN"]
 "reflexio/server/services/storage/sqlite_storage/**" = ["S608"]
@@ -261,6 +270,9 @@ version_toml = ["pyproject.toml:project.version"]
 tag_format = "reflexio-v{version}"
 commit_message = "chore(release): reflexio v{version}"
 build_command = "pip install build && python -m build"
+# Pre-1.0 convention: a breaking change bumps the MINOR (0.x.y -> 0.(x+1).0),
+# not MAJOR. So the B3 Task 7 breaking removal releases as 0.3.0, not 1.0.0.
+major_on_zero = false
 [tool.semantic_release.branches.main]
 match = "^(main|master)$"

package/plugin/vendor/reflexio/reflexio/README.md CHANGED Viewed

@@ -102,6 +102,7 @@ Description: FastAPI backend server that processes user interactions to generate
 ### Main Entry Points
 - **API**: `api.py` - FastAPI routes
+- **Extension Registry**: `extensions.py` - optional capability/service registration for OSS and enterprise integrations
 - **Endpoint Helpers**: `api_endpoints/` - Request handlers calling `Reflexio` (reflexio_lib)
 - **Core Service**: `services/generation_service.py` - Main orchestrator
@@ -140,7 +141,9 @@ client (Python SDK)
   - `evaluation_overview/` - Evaluation-page aggregates and hero metrics
   - `playbook_optimizer/` - Scenario-based playbook optimization experiments
   - `braintrust/` - Braintrust eval export/sync support
-  - `storage/` - Abstract layer (SQLite prod, LocalJSON test)
+  - `lineage/` - Resolve current records and schedule tombstone garbage collection for superseded profile/playbook rows
+  - `governance/` - Subject-reference contracts and retention/barrier helpers used by storage and lineage
+  - `storage/` - Abstract layer (SQLite prod, LocalJSON test) with governance-aware write validation
   - `pre_retrieval/` - Query rewriting and document expansion helpers
   - `configurator/` - YAML config loader
 - **`site_var/`**: Global settings singleton