claude-smart 0.2.44 → 0.2.46

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

@@ -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

@@ -11,8 +11,9 @@
 [![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)
 
@@ -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

@@ -1,6 +1,6 @@
 [project]
 name = "reflexio-ai"
-version = "0.2.24"
+version = "0.2.26"
 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

@@ -140,6 +140,7 @@ client (Python SDK)
   - `evaluation_overview/` - Evaluation-page aggregates and hero metrics
   - `playbook_optimizer/` - Scenario-based playbook optimization experiments
   - `braintrust/` - Braintrust eval export/sync support
+  - `lineage/` - Resolve current records and schedule tombstone garbage collection for superseded profile/playbook rows
   - `storage/` - Abstract layer (SQLite prod, LocalJSON test)
   - `pre_retrieval/` - Query rewriting and document expansion helpers
   - `configurator/` - YAML config loader

package/plugin/vendor/reflexio/reflexio/cli/README.md

@@ -62,7 +62,7 @@ Example: `uv run reflexio --json search "refund policy"`.
 Start and stop the backend, docs server, and optional local embedding daemon.
 
 ```shell
-uv run reflexio services start                          # backend :8081, docs :8082
+uv run reflexio services start                          # backend :8061, docs :8062
 uv run reflexio services start --storage sqlite         # sqlite (default) | supabase | postgres
 uv run reflexio services start --backend-port 9000 --docs-port 9001
 uv run reflexio services start --only backend --no-reload
@@ -92,6 +92,7 @@ Reflexio learns most from interactions that contain a **signal** — a user corr
 ```shell
 uv run reflexio publish \
   --user-id alice \
+  --session-id style-session-1 \
   --user-message "Stop adding disclaimers and caveats. Give me the answer in one line." \
   --agent-response "Understood — I'll drop the boilerplate from now on." \
   --wait
@@ -102,7 +103,7 @@ uv run reflexio publish \
 For real dialogues (3+ turns, tool calls, corrections mid-conversation), pass a JSON object whose `interactions` field is a list of `{role, content}` items. Each item becomes one turn, in order. Roles are `user` and `assistant`; `system` and `tool` turns are also accepted.
 
 ```shell
-uv run reflexio publish --user-id alice --wait --data '{
+uv run reflexio publish --user-id alice --session-id deploy-session-1 --wait --data '{
   "interactions": [
     {"role": "user",      "content": "Deploy the payments service to us-east-1."},
     {"role": "assistant", "content": "Starting deployment to us-east-1..."},
@@ -123,11 +124,11 @@ You can also load inline JSON from a file with `@`: `--data @conversation.json`.
 For bulk publishing or conversations you already have on disk, point at a file. A `.json` file should be a single object (or a list of objects); a `.jsonl` file is one JSON object per line, one conversation per line.
 
 ```shell
-uv run reflexio publish --file conversations.jsonl --user-id alice --wait
-cat conversations.jsonl | uv run reflexio publish --stdin --user-id alice
+uv run reflexio publish --file conversations.jsonl --user-id alice --session-id bulk-session --wait
+cat conversations.jsonl | uv run reflexio publish --stdin --user-id alice --session-id bulk-session
 ```
 
-Each payload object accepts the same fields as Mode 2 (`interactions`, and optionally per-payload overrides for `user_id`, `session_id`, `source`, `agent_version`). A payload's own `user_id` wins over the `--user-id` flag, so you can publish a mixed-user JSONL file in a single call.
+Each payload object accepts the same fields as Mode 2 (`interactions`, `session_id`, and optionally per-payload overrides for `user_id`, `source`, `agent_version`). A payload's own `user_id` and `session_id` win over the corresponding flags, so you can publish a mixed-user or mixed-session JSONL file in a single call.
 
 ### Common flags
 
@@ -136,11 +137,12 @@ Apply to all three modes:
 | Flag                | Purpose                                                                 |
 | ------------------- | ----------------------------------------------------------------------- |
 | `--wait`            | Block until server-side extraction finishes (returns real counts).      |
-| `--session-id`      | Group multiple `publish` calls into one session.                         |
+| `--session-id`      | Required unless each payload includes `session_id`; group publishes into one session. |
 | `--agent-version`   | Tag the interaction with an agent version (used by playbook filtering). |
 | `--source`          | Free-form source tag (defaults to `cli`).                                |
 | `--skip-aggregation`| Extract profiles/playbooks but skip playbook aggregation.                |
 | `--force-extraction`| Bypass all extraction gates (`stride_size`, cheap pre-filter, LLM `should_run`) and always run extractors. |
+| `--evaluation-only` | Store the request for session-level evaluation only; requires `--session-id` and skips profile/playbook extraction. |
 
 Full options via `uv run reflexio interactions publish --help`.
 
@@ -214,7 +216,7 @@ uv run reflexio config pull                              # pull server config to
 ## Auth
 
 ```shell
-uv run reflexio auth login --api-key $REFLEXIO_API_KEY --server-url http://localhost:8081
+uv run reflexio auth login --api-key $REFLEXIO_API_KEY --server-url http://localhost:8061
 uv run reflexio auth status
 uv run reflexio auth logout
 ```

package/plugin/vendor/reflexio/reflexio/cli/__main__.py

@@ -36,8 +36,17 @@ def main(argv: list[str] | None = None) -> None:
     ``reflexio.cli`` entry-point group before falling back to the
     default open-source app factory.
     """
-    from reflexio.cli.env_loader import load_reflexio_env
+    from reflexio.cli.env_loader import (
+        block_implicit_dotenv_walkup,
+        load_reflexio_env,
+    )
 
+    # Stop third-party import-time ``load_dotenv()`` calls (notably litellm)
+    # from walking UP the tree and loading a parent ``.env`` — e.g. the
+    # enterprise-root ``.env`` when the OSS launcher runs from the
+    # ``open_source/reflexio`` submodule. Must precede any import that pulls in
+    # litellm. Reflexio's own scoped loader runs right after.
+    block_implicit_dotenv_walkup()
     load_reflexio_env()
 
     from importlib.metadata import entry_points

package/plugin/vendor/reflexio/reflexio/cli/bootstrap_config.py

@@ -20,6 +20,19 @@ _VALID_STORAGE_BACKENDS = frozenset({"sqlite", "supabase", "postgres"})
 _DEFAULT_ORG_ID = "self-host-org"
 _DEFAULT_STORAGE = "sqlite"
 
+
+def default_org_id() -> str:
+    """Resolve the default org id, honoring ``REFLEXIO_DEFAULT_ORG_ID``.
+
+    Mirrors :func:`reflexio.server._auth.default_get_org_id` so the local CLI
+    helpers (``setup``, ``config show`` / ``config local``) resolve the same
+    ``config_<org>.json`` the running no-auth server reads. Uses ``os.environ``
+    directly (not ``env_utils``) to keep this module's import lightweight — see
+    the ``_TYPE_TO_BACKEND`` note above.
+    """
+    return os.environ.get("REFLEXIO_DEFAULT_ORG_ID", "").strip() or _DEFAULT_ORG_ID
+
+
 # Maps StorageConfig subclass to backend string.  Lazy-imported in functions
 # that need it so module-level import stays lightweight (no Pydantic at import).
 _TYPE_TO_BACKEND: dict[type, str] = {}  # populated on first use
@@ -71,24 +84,26 @@ def default_config_path(base_dir: str | None = None) -> Path:
     Returns:
         Path: Absolute path to the default-org config file (may not exist).
     """
-    return _config_dir(base_dir) / f"config_{_DEFAULT_ORG_ID}.json"
+    return _config_dir(base_dir) / f"config_{default_org_id()}.json"
 
 
 def load_storage_from_config(
-    org_id: str = _DEFAULT_ORG_ID,
+    org_id: str | None = None,
     *,
     base_dir: str | None = None,
 ) -> str | None:
     """Read storage type from the local config file.
 
     Args:
-        org_id: Organization ID for the config file name.
+        org_id: Organization ID for the config file name. Defaults to the
+            ``REFLEXIO_DEFAULT_ORG_ID``-aware default org.
         base_dir: Override base directory (for testing). If None, uses ~/.reflexio/.
 
     Returns:
         Storage backend string ("sqlite", "supabase", "postgres") or None if
         no config file exists or storage_config is unset.
     """
+    org_id = org_id or default_org_id()
     config_path = _config_dir(base_dir) / f"config_{org_id}.json"
     if not config_path.exists():
         return None
@@ -114,7 +129,7 @@ def load_storage_from_config(
 
 def save_storage_to_config(
     storage_type: str,
-    org_id: str = _DEFAULT_ORG_ID,
+    org_id: str | None = None,
     *,
     base_dir: str | None = None,
 ) -> None:
@@ -125,7 +140,8 @@ def save_storage_to_config(
 
     Args:
         storage_type: Backend name ("sqlite", "supabase", "postgres").
-        org_id: Organization ID for the config file name.
+        org_id: Organization ID for the config file name. Defaults to the
+            ``REFLEXIO_DEFAULT_ORG_ID``-aware default org.
         base_dir: Override base directory (for testing).
     """
     from reflexio.models.config_schema import (
@@ -137,6 +153,7 @@ def save_storage_to_config(
         LocalFileConfigStorage,
     )
 
+    org_id = org_id or default_org_id()
     storage_obj = LocalFileConfigStorage(org_id, base_dir=base_dir)
     config = storage_obj.load_config()
 

package/plugin/vendor/reflexio/reflexio/cli/commands/interactions.py

@@ -122,6 +122,20 @@ def _interactions_from_payload(payload: dict) -> list[InteractionData]:
         ) from exc
 
 
+def _resolve_session_id(raw_session_id: object, *, source_hint: str) -> str:
+    """Return a non-empty session id or raise a CLI validation error."""
+    if not isinstance(raw_session_id, str) or not raw_session_id.strip():
+        raise CliError(
+            error_type="validation",
+            message=(
+                "session_id is required and cannot be empty "
+                f"({source_hint}; pass --session-id or include 'session_id' in the payload)"
+            ),
+            exit_code=EXIT_VALIDATION,
+        )
+    return raw_session_id.strip()
+
+
 def _read_data_arg(data: str) -> str:
     """Read inline JSON or from a file path prefixed with ``@``.
 
@@ -233,7 +247,7 @@ def publish(
         ),
     ] = None,
     session_id: Annotated[
-        str | None, typer.Option(help="Session ID for grouping")
+        str | None, typer.Option(help="Required session ID for grouping")
     ] = None,
     source: Annotated[str, typer.Option(help="Source tag")] = "cli",
     agent_version: Annotated[
@@ -265,6 +279,13 @@ def publish(
             help="Bypass all extraction gates (stride_size, cheap pre-filter, LLM should_run) and always run extractors",
         ),
     ] = False,
+    evaluation_only: Annotated[
+        bool,
+        typer.Option(
+            "--evaluation-only",
+            help="Store for session-level evaluation only and skip profile/playbook extraction",
+        ),
+    ] = False,
     override_learning_stall: Annotated[
         bool,
         typer.Option(
@@ -310,6 +331,9 @@ def publish(
                 message="--user-id is required with --user-message (or set REFLEXIO_USER_ID)",
                 exit_code=EXIT_VALIDATION,
             )
+        resolved_session_id = _resolve_session_id(
+            session_id, source_hint="single-turn publish"
+        )
         interactions: list[InteractionData | dict] = [
             InteractionData(role="user", content=user_message),
             InteractionData(role="assistant", content=agent_response),
@@ -319,10 +343,11 @@ def publish(
             interactions=interactions,
             source=source,
             agent_version=resolve_agent_version(agent_version),
-            session_id=session_id,
+            session_id=resolved_session_id,
             wait_for_response=wait,
             skip_aggregation=skip_aggregation,
             force_extraction=force_extraction,
+            evaluation_only=evaluation_only,
             override_learning_stall=override_learning_stall,
         )
         if json_mode:
@@ -371,15 +396,20 @@ def publish(
                 ),
                 exit_code=EXIT_VALIDATION,
             )
+        resolved_session_id = _resolve_session_id(
+            payload.get("session_id", session_id),
+            source_hint="payload publish",
+        )
         result = client.publish_interaction(
             user_id=resolved_user_id,
             interactions=interaction_items,  # type: ignore[arg-type]
             source=payload.get("source", source),
             agent_version=payload.get("agent_version", resolved_version),
-            session_id=payload.get("session_id", session_id),
+            session_id=resolved_session_id,
             wait_for_response=wait,
             skip_aggregation=payload.get("skip_aggregation", skip_aggregation),
             force_extraction=payload.get("force_extraction", force_extraction),
+            evaluation_only=payload.get("evaluation_only", evaluation_only),
             override_learning_stall=payload.get(
                 "override_learning_stall", override_learning_stall
             ),
@@ -441,7 +471,7 @@ def search(
 @handle_errors
 def delete(
     ctx: typer.Context,
-    interaction_id: Annotated[str, typer.Option(help="Interaction ID to delete")],
+    interaction_id: Annotated[int, typer.Option(help="Interaction ID to delete")],
     user_id: Annotated[str, typer.Option(help="User ID that owns the interaction")],
 ) -> None:
     """Delete a single interaction by ID."""

package/plugin/vendor/reflexio/reflexio/cli/commands/profiles.py

@@ -157,15 +157,22 @@ def delete(
     ],
     profile_id: Annotated[
         str,
-        typer.Option("--profile-id", help="Specific profile ID to delete"),
+        typer.Option(
+            "--profile-id",
+            help="Specific profile ID to delete (required; use 'delete-all' for bulk)",
+        ),
     ] = "",
 ) -> None:
-    """Delete a user profile.
+    """Delete a specific user profile.
+
+    A ``--profile-id`` is required: the server rejects an empty profile id
+    with "Profile id or search query is required". To remove every profile
+    for an org, use ``reflexio user-profiles delete-all`` instead.
 
     Args:
         ctx: Typer context with CliState in ctx.obj
         user_id: User ID owning the profile
-        profile_id: Specific profile ID to delete (empty string for all user profiles)
+        profile_id: Specific profile ID to delete
     """
     client = get_client(ctx)
     resp = client.delete_profile(
@@ -178,10 +185,8 @@ def delete(
     if json_mode:
         render(resp, json_mode=True)
     else:
-        label = (
-            f"profile {profile_id}" if profile_id else f"profiles for user {user_id}"
-        )
-        print_info(f"Deleted {label}")
+        raise_if_failed(resp, default="Failed to delete user profile")
+        print_info(f"Deleted profile {profile_id} for user {user_id}")
 
 
 @app.command(name="delete-all")

package/plugin/vendor/reflexio/reflexio/cli/commands/services.py

@@ -123,6 +123,13 @@ def _ensure_llm_configured(env_path: Path) -> None:
         )
         _prompt_embedding_provider(env_path, non_embedding_provider)
 
+    # override=True is required here: the wizard wrote the operator's chosen key
+    # to the .env FILE only (via set_env_var), never to os.environ. A fresh
+    # install ships an empty OPENAI_API_KEY placeholder already in os.environ, so
+    # with override=False this reload would skip the (present-but-empty) var and
+    # the key just entered would never reach the process env. For this OSS local
+    # first-run path the file value must win. (The enterprise mode-file path uses
+    # override=False in load_reflexio_env_for_mode and is unaffected.)
     load_dotenv(dotenv_path=env_path, override=True)
     typer.echo()
 
@@ -159,13 +166,13 @@ def validate_storage_backend(storage: str | None) -> None:
 @app.command()
 def start(
     backend_port: Annotated[
-        int | None, typer.Option(help="Backend server port (default: 8081)")
+        int | None, typer.Option(help="Backend server port (default: 8061)")
     ] = None,
     docs_port: Annotated[
-        int | None, typer.Option(help="Docs server port (default: 8082)")
+        int | None, typer.Option(help="Docs server port (default: 8062)")
     ] = None,
     embedding_port: Annotated[
-        int | None, typer.Option(help="Embedding service port (default: 8072)")
+        int | None, typer.Option(help="Embedding service port (default: 8069)")
     ] = None,
     only: Annotated[
         str | None,
@@ -264,13 +271,13 @@ def start(
 @app.command()
 def stop(
     backend_port: Annotated[
-        int | None, typer.Option(help="Backend server port (default: 8081)")
+        int | None, typer.Option(help="Backend server port (default: 8061)")
     ] = None,
     docs_port: Annotated[
-        int | None, typer.Option(help="Docs server port (default: 8082)")
+        int | None, typer.Option(help="Docs server port (default: 8062)")
     ] = None,
     embedding_port: Annotated[
-        int | None, typer.Option(help="Embedding service port (default: 8072)")
+        int | None, typer.Option(help="Embedding service port (default: 8069)")
     ] = None,
     only: Annotated[
         str | None,