claude-smart 0.2.43 → 0.2.45

package/.claude-plugin/marketplace.json

@@ -4,14 +4,14 @@
     "name": "Yi Lu"
   },
   "metadata": {
-    "description": "claude-smart — self-improving Claude Code and Codex plugin via reflexio"
+    "description": "claude-smart — self-improving Claude Code and Codex plugin powered by Reflexio"
   },
   "plugins": [
     {
       "name": "claude-smart",
-      "version": "0.2.43",
+      "version": "0.2.45",
       "source": "./plugin",
-      "description": "Turns user corrections into project-specific and shared skills via reflexio — uses Claude Code or Codex as the LLM backend (no external API key required)"
+      "description": "Turns corrections into Preferences, Project-specific skills, and Shared skills — uses Claude Code or Codex as the LLM backend (no external API key required)"
     }
   ]
 }

package/README.md

@@ -13,7 +13,7 @@
     <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
   </a>
   <a href="plugin/pyproject.toml">
-    <img src="https://img.shields.io/badge/version-0.2.43-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.2.45-green.svg" alt="Version">
   </a>
   <a href="plugin/pyproject.toml">
     <img src="https://img.shields.io/badge/python-%3E%3D3.12-brightgreen.svg" alt="Python">

package/bin/claude-smart.js

@@ -905,7 +905,7 @@ async function installVendoredReflexio(pluginRoot, uv, env) {
   process.stdout.write(`Installing bundled Reflexio source from ${vendorRoot}...\n`);
   let code = await runChecked(
     uv,
-    ["pip", "install", "--project", pluginRoot, "--python", pythonPath, "--quiet", "-e", vendorRoot],
+    ["pip", "install", "--project", pluginRoot, "--python", pythonPath, "--quiet", "--reinstall", "--no-deps", vendorRoot],
     { cwd: pluginRoot, env },
   );
   if (code !== 0) {
@@ -914,7 +914,7 @@ async function installVendoredReflexio(pluginRoot, uv, env) {
     );
     code = await runChecked(
       uv,
-      ["pip", "install", "--project", pluginRoot, "--python", pythonPath, "-e", vendorRoot],
+      ["pip", "install", "--project", pluginRoot, "--python", pythonPath, "--reinstall", "--no-deps", vendorRoot],
       { cwd: pluginRoot, env },
     );
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-smart",
-  "version": "0.2.43",
-  "description": "Self-improving Claude Code and Codex plugin — turns corrections into durable skills via reflexio",
+  "version": "0.2.45",
+  "description": "Self-improving Claude Code and Codex plugin that turns corrections into Preferences, Project-specific skills, and Shared skills",
   "keywords": [
     "claude",
     "claude-code",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-smart",
-  "version": "0.2.43",
-  "description": "Self-improving Claude Code and Codex plugin — turns corrections into durable skills via reflexio",
+  "version": "0.2.45",
+  "description": "Self-improving Claude Code and Codex plugin that turns corrections into Preferences, Project-specific skills, and Shared skills",
   "author": {
     "name": "Yi Lu"
   },

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.43",
+  "version": "0.2.45",
   "description": "Self-improving coding assistant plugin — learns from corrections across sessions via reflexio",
   "author": {
     "name": "Yi Lu"

package/plugin/README.md

@@ -6,6 +6,8 @@ This directory is the published Python package (`claude-smart` on PyPI) and the
 
 ## Install
 
+### Claude Code
+
 ```bash
 claude plugin marketplace add ReflexioAI/claude-smart
 claude plugin install claude-smart@reflexioai
@@ -25,8 +27,19 @@ embedding/ML dependency stack does not provide a complete native wheel set.
 
 Then restart Claude Code.
 
+### Codex
+
+```bash
+npx claude-smart install --host codex
+```
+
+Then fully quit and reopen Codex so hooks reload. Codex installs reuse the same
+local Preferences, Project-specific skills, and Shared skills as Claude Code.
+
 ## Uninstall
 
+### Claude Code
+
 ```bash
 claude plugin uninstall claude-smart@reflexioai
 ```
@@ -37,7 +50,14 @@ Or, if Node.js or uv is already installed:
 npx claude-smart uninstall   # or: uvx claude-smart uninstall
 ```
 
-Local data under `~/.reflexio/` and `~/.claude-smart/` is left in place — remove manually if desired.
+### Codex
+
+```bash
+npx claude-smart uninstall --host codex
+```
+
+Restart Codex after uninstalling. Local data under `~/.reflexio/` and
+`~/.claude-smart/` is left in place for both hosts — remove manually if desired.
 
 ## License
 

package/plugin/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "claude-smart"
-version = "0.2.43"
-description = "Self-improving Claude Code and Codex plugin — turns corrections into durable skills via reflexio"
+version = "0.2.45"
+description = "Self-improving Claude Code and Codex plugin that turns corrections into Preferences, Project-specific skills, and Shared skills"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
@@ -9,7 +9,7 @@ dependencies = [
     # normal installs; vendor releases may override it after uv sync by
     # installing plugin/vendor/reflexio. Keep in sync via
     # scripts/sync-reflexio-dep.py.
-    "reflexio-ai>=0.2.23",
+    "reflexio-ai>=0.2.25",
     # Needed when Reflexio runs the local embedding provider (ONNXMiniLM_L6_V2).
     # Pulls in onnxruntime + tokenizers; the ~80 MB ONNX model itself is
     # downloaded on first use, not at install time.

package/plugin/scripts/_lib.sh

@@ -3,11 +3,53 @@
 # Claude Code hooks run with a minimal non-interactive PATH that often omits
 # nvm/asdf/brew shims where `npm`, `uv`, etc. live. Pull the user's login-shell
 # PATH the same way claude-mem does so hook-spawned scripts find them without
-# the user having to mutate their global PATH. Best-effort — failures silent.
+# the user having to mutate their global PATH. Best-effort and bounded: shell
+# profile startup can be slow or stuck on Windows, so this must never outlive a
+# hook's timeout budget.
+claude_smart_login_path_timeout_seconds() {
+  local _VALUE
+  _VALUE="${CLAUDE_SMART_LOGIN_PATH_TIMEOUT_SECONDS:-2}"
+  case "$_VALUE" in
+    ''|*[!0-9]*) printf '%s\n' "2" ;;
+    *) printf '%s\n' "$_VALUE" ;;
+  esac
+}
+
+claude_smart_capture_login_path() {
+  local _TIMEOUT _TMP _PID _WAITED _LINE
+  _TIMEOUT="$(claude_smart_login_path_timeout_seconds)"
+  [ "$_TIMEOUT" -gt 0 ] || return 1
+
+  _TMP="${TMPDIR:-/tmp}/claude-smart-login-path.$$"
+  rm -f "$_TMP" 2>/dev/null || true
+  "$SHELL" -lc 'printf %s "$PATH"' >"$_TMP" 2>/dev/null &
+  _PID=$!
+  _WAITED=0
+  while kill -0 "$_PID" 2>/dev/null; do
+    if [ "$_WAITED" -ge "$_TIMEOUT" ]; then
+      kill "$_PID" 2>/dev/null || true
+      wait "$_PID" 2>/dev/null || true
+      rm -f "$_TMP" 2>/dev/null || true
+      return 1
+    fi
+    sleep 1
+    _WAITED=$((_WAITED + 1))
+  done
+  if wait "$_PID" 2>/dev/null; then
+    while IFS= read -r _LINE || [ -n "$_LINE" ]; do
+      printf '%s' "$_LINE"
+    done <"$_TMP"
+    rm -f "$_TMP" 2>/dev/null || true
+    return 0
+  fi
+  rm -f "$_TMP" 2>/dev/null || true
+  return 1
+}
+
 claude_smart_source_login_path() {
   local _SHELL_PATH
   if [ -n "${SHELL:-}" ] && [ -x "$SHELL" ]; then
-    if _SHELL_PATH="$("$SHELL" -lc 'printf %s "$PATH"' 2>/dev/null)"; then
+    if _SHELL_PATH="$(claude_smart_capture_login_path)"; then
       [ -n "$_SHELL_PATH" ] && export PATH="$_SHELL_PATH:$PATH"
     fi
   fi
@@ -116,30 +158,24 @@ claude_smart_dashboard_unavailable_marker() {
 }
 
 claude_smart_node_recovery_hint() {
-  cat <<'EOF'
-Recovery:
-  1. Restart Claude Code to let claude-smart retry its private Node.js install.
-  2. If the retry is blocked by your network or OS policy, install Node.js 20.9+ manually:
-EOF
+  printf '%s\n' \
+    "Recovery:" \
+    "  1. Restart Claude Code to let claude-smart retry its private Node.js install." \
+    "  2. If the retry is blocked by your network or OS policy, install Node.js 20.9+ manually:"
   if claude_smart_is_windows; then
-    cat <<'EOF'
-     - winget install OpenJS.NodeJS.LTS
-     - or download the LTS installer from https://nodejs.org/
-EOF
+    printf '%s\n' \
+      "     - winget install OpenJS.NodeJS.LTS" \
+      "     - or download the LTS installer from https://nodejs.org/"
   elif [ "$(uname -s 2>/dev/null)" = "Darwin" ]; then
-    cat <<'EOF'
-     - brew install node
-     - or download the LTS installer from https://nodejs.org/
-EOF
+    printf '%s\n' \
+      "     - brew install node" \
+      "     - or download the LTS installer from https://nodejs.org/"
   else
-    cat <<'EOF'
-     - use your distro package manager for nodejs/npm
-     - or download the LTS archive from https://nodejs.org/
-EOF
+    printf '%s\n' \
+      "     - use your distro package manager for nodejs/npm" \
+      "     - or download the LTS archive from https://nodejs.org/"
   fi
-  cat <<'EOF'
-  3. Run /claude-smart:restart, then /claude-smart:dashboard.
-EOF
+  printf '%s\n' "  3. Run /claude-smart:restart, then /claude-smart:dashboard."
 }
 
 claude_smart_write_dashboard_unavailable() {
@@ -527,14 +563,22 @@ claude_smart_append_capped_log() {
 # POSIX: setsid → python3 os.setsid → nohup (in that order of strength).
 # Windows: nohup alone — Git Bash has no setsid, no process groups, and
 # `os.setsid()` is POSIX-only; nohup ignores SIGHUP which is enough to
-# survive the parent console closing. The python3 fallback is gated on a
-# real-interpreter probe (-V) so the Windows App Execution Alias stub
-# doesn't get invoked. Caller is responsible for redirecting stdout/stderr;
-# we do not impose a log destination here. Stdin is closed so the child
-# cannot inherit a tty. Use `$!` after this call to capture the pid.
+# survive the parent console closing. On Windows, stdout/stderr are also
+# closed here so hook-runner pipes cannot be kept alive by long-lived
+# background children after the hook script exits unless the caller explicitly
+# opts into preserving stdout/stderr for a file redirection. The python3
+# fallback is gated on a real-interpreter probe (-V) so the Windows App
+# Execution Alias stub doesn't get invoked. POSIX callers are responsible for
+# redirecting stdout/stderr; we do not impose a log destination there. Stdin is
+# closed so the child cannot inherit a tty. Use `$!` after this call to capture
+# the pid.
 claude_smart_spawn_detached() {
   if claude_smart_is_windows; then
-    nohup "$@" < /dev/null &
+    if [ "${CLAUDE_SMART_SPAWN_KEEP_OUTPUT:-}" = "1" ]; then
+      nohup "$@" < /dev/null &
+    else
+      nohup "$@" < /dev/null > /dev/null 2>&1 &
+    fi
     return 0
   fi
   if command -v setsid >/dev/null 2>&1; then

package/plugin/scripts/backend-service.sh

@@ -5,8 +5,8 @@
 #
 # Subcommands:
 #   start         probe /health; if nothing we recognize is on the port,
-#                 spawn `uv run reflexio services start --only backend
-#                 --no-reload` detached. Polls /health briefly so first
+#                 spawn the prepared venv's `reflexio services start --only
+#                 backend --no-reload` detached. Polls /health briefly so first
 #                 use after session start lands on a warm server, then
 #                 returns a continue payload regardless.
 #   stop          SIGTERM the recorded process group, escalating to
@@ -20,11 +20,13 @@ set -eu
 HERE="$(cd "$(dirname "$0")" && pwd)"
 # shellcheck source=_lib.sh
 . "$HERE/_lib.sh"
-claude_smart_source_login_path
+CMD="${1:-start}"
+if [ "$CMD" != "session-end" ]; then
+  claude_smart_source_login_path
+fi
 claude_smart_prepend_astral_bins
 claude_smart_source_reflexio_env
 
-CMD="${1:-start}"
 PORT=8071
 EMBEDDING_PORT="${EMBEDDING_PORT:-8072}"
 # Pass through to `reflexio services start/stop` so the spawned backend
@@ -183,6 +185,35 @@ port_holder() {
     | awk 'NR==2 {print $1" (pid "$2")"; exit}'
 }
 
+ensure_vendored_reflexio_active() {
+  vendor="$PLUGIN_ROOT/vendor/reflexio"
+  [ -f "$vendor/pyproject.toml" ] || return 0
+  plugin_python="$(claude_smart_plugin_python "$PLUGIN_ROOT")"
+  [ -x "$plugin_python" ] || return 0
+  if "$plugin_python" - "$vendor/pyproject.toml" <<'PY' >/dev/null 2>&1; then
+import importlib.metadata
+import re
+import sys
+from pathlib import Path
+
+text = Path(sys.argv[1]).read_text(encoding="utf-8")
+match = re.search(r'^version\s*=\s*"([^"]+)"', text, re.MULTILINE)
+if not match:
+    raise SystemExit(1)
+expected = match.group(1)
+try:
+    installed = importlib.metadata.version("reflexio-ai")
+except importlib.metadata.PackageNotFoundError:
+    raise SystemExit(1)
+raise SystemExit(0 if installed == expected else 1)
+PY
+    return 0
+  fi
+  claude_smart_append_capped_log "$LOG_FILE" "$LOG_MAX_BYTES" \
+    "[claude-smart] backend: repairing vendored Reflexio install before start"
+  uv pip install --project "$PLUGIN_ROOT" --python "$plugin_python" --quiet --reinstall --no-deps "$vendor" >&2
+}
+
 # Full shutdown: kill the recorded process group (if any) then sweep
 # both the backend port and the embedding-service port for surviving
 # reflexio listeners. Used by both `stop` and the opt-in `session-end`
@@ -233,7 +264,7 @@ case "$CMD" in
     if ! command -v uv >/dev/null 2>&1; then
       if [ "${CLAUDE_SMART_BOOTSTRAPPING:-}" != "1" ] && [ -x "$PLUGIN_ROOT/scripts/smart-install.sh" ]; then
         claude_smart_append_capped_log "$LOG_FILE" "$LOG_MAX_BYTES" "[claude-smart] backend: uv not on PATH; starting installer in background"
-        claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
+        CLAUDE_SMART_SPAWN_KEEP_OUTPUT=1 claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
           bash "$PLUGIN_ROOT/scripts/smart-install.sh" \
           >>"$STATE_DIR/install.log" 2>&1 || true
       fi
@@ -243,6 +274,7 @@ case "$CMD" in
       fi
     fi
     cd "$PLUGIN_ROOT"
+    ensure_vendored_reflexio_active
 
     # Cap local interaction history to keep the SQLite store small for
     # claude-smart users. Reflexio's library defaults are much higher
@@ -266,6 +298,21 @@ case "$CMD" in
     # without touching the file on disk.
     export REFLEXIO_STORAGE="sqlite"
 
+    backend_pythonpath="${PYTHONPATH:-}"
+    if [ -d "$PLUGIN_ROOT/vendor/reflexio/reflexio" ]; then
+      vendor_pythonpath="$PLUGIN_ROOT/vendor/reflexio"
+      pythonpath_sep=":"
+      if claude_smart_is_windows; then
+        # Native Windows Python expects ;-separated Windows-style paths in
+        # PYTHONPATH; MSYS does not auto-convert arbitrary env vars.
+        pythonpath_sep=";"
+        if command -v cygpath >/dev/null 2>&1; then
+          vendor_pythonpath="$(cygpath -w "$vendor_pythonpath")"
+        fi
+      fi
+      backend_pythonpath="$vendor_pythonpath${backend_pythonpath:+$pythonpath_sep$backend_pythonpath}"
+    fi
+
     # (nohup; no process groups). backend-log-runner.sh owns stdout/stderr
     # capture so process output cannot grow backend.log past its cap.
     #
@@ -277,11 +324,12 @@ case "$CMD" in
     # CLAUDE_SMART_BACKEND_WORKERS for power users running concurrent
     # Claude Code sessions or wanting zero-downtime recycling.
     workers="${CLAUDE_SMART_BACKEND_WORKERS:-1}"
+    backend_python="$(claude_smart_plugin_python "$PLUGIN_ROOT")"
     claude_smart_spawn_detached bash "$HERE/backend-log-runner.sh" \
       "$LOG_FILE" "$LOG_MAX_BYTES" -- \
       env PYTHONIOENCODING="${PYTHONIOENCODING:-utf-8}" \
-      uv run --project "$PLUGIN_ROOT" --no-sync --quiet \
-      reflexio services start --only backend --no-reload --workers "$workers"
+      PYTHONPATH="$backend_pythonpath" \
+      "$backend_python" -m reflexio.cli services start --only backend --no-reload --workers "$workers"
     svc_pid=$!
     # Record the spawned pid, not a pgid sampled with ps. On POSIX,
     # setsid/python os.setsid make this pid the new process group leader;

package/plugin/scripts/cli.sh

@@ -91,4 +91,5 @@ if ! claude_smart_python_imports "$PLUGIN_ROOT" claude_smart.cli; then
   fi
 fi
 
-exec uv run --project "$PLUGIN_ROOT" --no-sync --quiet python -m claude_smart.cli "$@"
+PLUGIN_PYTHON="$(claude_smart_plugin_python "$PLUGIN_ROOT")"
+exec "$PLUGIN_PYTHON" -m claude_smart.cli "$@"

package/plugin/scripts/dashboard-service.sh

@@ -21,11 +21,13 @@ set -eu
 HERE="$(cd "$(dirname "$0")" && pwd)"
 # shellcheck source=_lib.sh
 . "$HERE/_lib.sh"
-claude_smart_source_login_path
+CMD="${1:-start}"
+if [ "$CMD" != "session-end" ]; then
+  claude_smart_source_login_path
+fi
 claude_smart_prepend_node_bins
 claude_smart_source_reflexio_env
 
-CMD="${1:-start}"
 PORT=3001
 
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
@@ -192,7 +194,7 @@ case "$CMD" in
     if [ -z "$NPM_BIN" ] || ! "$NPM_BIN" --version >/dev/null 2>&1; then
       if [ "${CLAUDE_SMART_BOOTSTRAPPING:-}" != "1" ] && [ -x "$PLUGIN_ROOT/scripts/smart-install.sh" ]; then
         echo "[claude-smart] dashboard: npm is not on PATH; starting installer in background" >>"$LOG_FILE"
-        claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
+        CLAUDE_SMART_SPAWN_KEEP_OUTPUT=1 claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
           bash "$PLUGIN_ROOT/scripts/smart-install.sh" \
           >>"$STATE_DIR/install.log" 2>&1 || true
       fi
@@ -214,7 +216,7 @@ case "$CMD" in
       BUILD_PID_FILE="$STATE_DIR/dashboard-build.pid"
       if ! claude_smart_pid_alive_file "$BUILD_PID_FILE"; then
         echo "[claude-smart] dashboard: .next missing — starting background build (~1-2 min)" >>"$LOG_FILE"
-        claude_smart_spawn_detached bash "$HERE/dashboard-build.sh" >>"$LOG_FILE" 2>&1
+        CLAUDE_SMART_SPAWN_KEEP_OUTPUT=1 claude_smart_spawn_detached bash "$HERE/dashboard-build.sh" >>"$LOG_FILE" 2>&1
       fi
       emit_ok; exit 0
     fi
@@ -229,7 +231,7 @@ case "$CMD" in
     # Caller-side `>>file 2>&1` redirection is honoured before the child
     # detaches, so per-OS log paths stay identical.
     export CLAUDE_SMART_DASHBOARD_WORKSPACE="$WORKSPACE_CWD"
-    claude_smart_spawn_detached "$NPM_BIN" run start >>"$LOG_FILE" 2>&1
+    CLAUDE_SMART_SPAWN_KEEP_OUTPUT=1 claude_smart_spawn_detached "$NPM_BIN" run start >>"$LOG_FILE" 2>&1
     dash_pid=$!
     # Record the spawned pid, not a pgid sampled with ps. On POSIX,
     # setsid/python os.setsid make this pid the new process group leader;

package/plugin/scripts/ensure-plugin-root.sh

@@ -20,6 +20,7 @@ if [ ! -f "$TARGET/pyproject.toml" ]; then
     echo "[claude-smart] ensure-plugin-root: $TARGET is not a plugin dir (no pyproject.toml)" >&2
     exit 1
 fi
+TARGET="$(cd "$TARGET" && pwd -P)"
 
 LINK="$HOME/.reflexio/plugin-root"
 mkdir -p "$(dirname "$LINK")"

package/plugin/scripts/hook_entry.sh

@@ -3,8 +3,9 @@
 # CLAUDE_PLUGIN_ROOT points at the plugin dir (dev: <repo>/plugin;
 # installed: ~/.claude/plugins/cache/reflexioai/claude-smart/<version>),
 # which is also the Python project root with pyproject.toml + uv.lock.
-# We invoke via `uv run --project --no-sync` so the prepared env is used without
-# undoing editable Reflexio installs from local development.
+# We invoke the prepared venv Python directly so hooks use the dependency set
+# produced by smart-install.sh, including the vendored Reflexio snapshot it
+# installs non-editably (--reinstall --no-deps).
 #
 # If the Setup hook recorded an install failure at
 # ~/.claude-smart/install-failed, short-circuit with a user-visible
@@ -95,7 +96,7 @@ if ! command -v uv >/dev/null 2>&1; then
   fi
   if [ -x "$PLUGIN_ROOT/scripts/smart-install.sh" ]; then
     mkdir -p "$STATE_DIR"
-    claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
+    CLAUDE_SMART_SPAWN_KEEP_OUTPUT=1 claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
       bash "$PLUGIN_ROOT/scripts/smart-install.sh" \
       >>"$STATE_DIR/install.log" 2>&1 || true
   fi
@@ -122,7 +123,7 @@ ensure_hook_package_importable() {
     printf '%s\n' "[claude-smart] hook: claude_smart.hook is not importable; retrying install in background"
     date 2>/dev/null || true
   } >>"$STATE_DIR/install.log" 2>&1
-  claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
+  CLAUDE_SMART_SPAWN_KEEP_OUTPUT=1 claude_smart_spawn_detached env CLAUDE_SMART_BOOTSTRAPPING=1 \
     bash "$PLUGIN_ROOT/scripts/smart-install.sh" \
     >>"$STATE_DIR/install.log" 2>&1 || true
 
@@ -135,4 +136,5 @@ if ! ensure_hook_package_importable; then
 fi
 
 # Stdin is the hook payload JSON — stream it through to the Python CLI.
-exec uv run --project "$PLUGIN_ROOT" --no-sync --quiet python -m claude_smart.hook "$HOST" "$EVENT"
+PLUGIN_PYTHON="$(claude_smart_plugin_python "$PLUGIN_ROOT")"
+exec "$PLUGIN_PYTHON" -m claude_smart.hook "$HOST" "$EVENT"

package/plugin/scripts/smart-install.sh

@@ -142,12 +142,12 @@ install_vendored_reflexio() {
   fi
 
   echo "[claude-smart] installing bundled Reflexio source from $VENDORED_REFLEXIO" >&2
-  if uv pip install --project "$PLUGIN_ROOT" --python "$PLUGIN_PYTHON" --quiet -e "$VENDORED_REFLEXIO" >&2; then
+  if uv pip install --project "$PLUGIN_ROOT" --python "$PLUGIN_PYTHON" --quiet --reinstall --no-deps "$VENDORED_REFLEXIO" >&2; then
     return 0
   fi
 
   echo "[claude-smart] warning: quiet vendored Reflexio install failed in $PLUGIN_ROOT; retrying with full output." >&2
-  if ! uv pip install --project "$PLUGIN_ROOT" --python "$PLUGIN_PYTHON" -e "$VENDORED_REFLEXIO" >&2; then
+  if ! uv pip install --project "$PLUGIN_ROOT" --python "$PLUGIN_PYTHON" --reinstall --no-deps "$VENDORED_REFLEXIO" >&2; then
     write_failure "vendored Reflexio install failed in $PLUGIN_ROOT"
   fi
 }

package/plugin/src/README.md

@@ -0,0 +1,57 @@
+# claude_smart (plugin/src)
+Description: Python package powering the claude-smart plugin — hook handlers that buffer Claude Code / Codex session activity, publish it to a local Reflexio backend, and inject the learned skills/preferences back into future sessions.
+
+> User-facing install/usage docs live in [`../README.md`](../README.md). This is the code map for the `claude_smart` package.
+
+## Main Entry Points
+
+| File | Purpose |
+|------|---------|
+| `hook.py` | Hook dispatcher. Parses the stdin JSON payload and routes each event (Setup, SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd) to its handler in `events/`. |
+| `cli.py` | `claude-smart` CLI: `install`, `uninstall`, `show`, `learn`, `restart`, `dashboard`, `clear-all`. |
+| `state.py` | Per-session JSONL buffer at `~/.claude-smart/sessions/{session_id}.jsonl`; high-water mark for idempotent publish retries. |
+| `publish.py` | Drains the session buffer, calls the Reflexio adapter, and stamps the watermark. Used by Stop, SessionEnd, and `learn`. |
+| `reflexio_adapter.py` | Thin wrapper over `reflexio.ReflexioClient` — isolates import failures, 5s HTTP timeout, injects/queries learnings, degrades gracefully when the backend is down. |
+
+## Event Handlers (`events/`)
+
+| Handler | Hook | Role |
+|---------|------|------|
+| `session_start.py` | SessionStart | Apply extraction defaults, render stall banner, push optimizer context. |
+| `user_prompt.py` | UserPromptSubmit | Inject learned playbooks/preferences into context. |
+| `pre_tool.py` | PreToolUse (Edit/Write/Bash/NotebookEdit) | Inject project-specific context before tool execution. |
+| `post_tool.py` | PostToolUse | Buffer the tool invocation (name, input, response, duration) into session state. |
+| `stop.py` | Stop | Publish unpublished interactions (force extraction if configured). |
+| `session_end.py` | SessionEnd | Final publish + aggregation; optional backend/dashboard shutdown. |
+
+## Supporting Modules
+
+| File | Purpose |
+|------|---------|
+| `env_config.py` | Parses `~/.reflexio/.env` (`REFLEXIO_URL`, `REFLEXIO_API_KEY`, `CLAUDE_SMART_READ_ONLY`, local embedding/CLI flags). |
+| `runtime.py` | Host detection (Claude Code vs Codex); shared agent version. |
+| `ids.py` | Session / project ID generation and resolution. |
+| `context_inject.py`, `context_format.py`, `query_compose.py`, `cs_cite.py` | Build search queries, format learned skills as markdown, inject into context, format citations. |
+| `stall_banner.py` | User-facing message when the Reflexio provider hits an auth/billing stall. |
+| `optimizer_assistant.py` | Claude-code CLI agent that extracts Reflexio optimization hints. |
+| `hook_log.py`, `internal_call.py` | Structured JSON logging to `~/.claude-smart/hook.log`; detect internal/test invocations to skip learning. |
+
+## Architecture
+
+```
+SessionStart -> bootstrap Reflexio backend (8071) + Next.js dashboard (3001)
+PostToolUse  -> state.py buffers each tool call to ~/.claude-smart/sessions/{id}.jsonl
+Stop/SessionEnd -> publish.py -> reflexio_adapter -> Reflexio extracts playbooks + preferences
+UserPromptSubmit / PreToolUse -> context_inject pulls relevant learnings back into context
+```
+
+- **Dual-host** — the same package runs under Claude Code (native slash commands) and Codex (shell-script fallbacks in `../scripts/`); host shape is normalized in `runtime.py`.
+- **Offline-resilient** — if Reflexio is unreachable, interactions stay buffered and drain on the next successful publish.
+- **Hooks registered** in `../hooks/hooks.json` (Claude Code) and `../hooks/codex-hooks.json` (Codex), dispatched through `../scripts/hook_entry.sh`.
+
+## Requirements / Problems to Avoid
+
+- **All learned state is external to the repo** — sessions buffer under `~/.claude-smart/`, Reflexio state under `~/.reflexio/`. Don't write generated runtime artifacts inside the plugin root.
+- **Backend lives at `http://localhost:8071`**, dashboard at `http://localhost:3001`; both are long-lived across sessions (no hard shutdown on SessionEnd by default).
+- **`CLAUDE_SMART_READ_ONLY`** skips publishing entirely — respect it in any new publish path.
+- **Keep handlers fast** — tool-use hooks run on a 10–15s timeout; heavy work belongs in the backend, not the hook.