claude-smart 0.2.30 → 0.2.32

package/plugin/scripts/_lib.sh

@@ -32,6 +32,77 @@ claude_smart_prepend_node_bins() {
   export PATH="$_CS_NODE_ROOT/bin:$_CS_NODE_ROOT:$PATH"
 }
 
+claude_smart_env_unquote() {
+  local value first last
+  value="$1"
+  first="${value%"${value#?}"}"
+  last="${value#"${value%?}"}"
+  if { [ "$first" = '"' ] && [ "$last" = '"' ]; } || { [ "$first" = "'" ] && [ "$last" = "'" ]; }; then
+    value="${value#?}"
+    value="${value%?}"
+  fi
+  printf '%s\n' "$value"
+}
+
+claude_smart_source_reflexio_env() {
+  local env_file line key value
+  env_file="$HOME/.reflexio/.env"
+  [ -f "$env_file" ] || return 0
+  while IFS= read -r line || [ -n "$line" ]; do
+    line="${line#"${line%%[![:space:]]*}"}"
+    line="${line%"${line##*[![:space:]]}"}"
+    [ -n "$line" ] || continue
+    case "$line" in
+      \#*) continue ;;
+      export\ *) line="${line#export }" ;;
+    esac
+    key="${line%%=*}"
+    [ "$key" != "$line" ] || continue
+    value="${line#*=}"
+    key="${key%"${key##*[![:space:]]}"}"
+    value="${value#"${value%%[![:space:]]*}"}"
+    value="${value%"${value##*[![:space:]]}"}"
+    case "$key" in
+      REFLEXIO_URL|REFLEXIO_API_KEY|CLAUDE_SMART_USE_LOCAL_CLI|CLAUDE_SMART_USE_LOCAL_EMBEDDING|CLAUDE_SMART_BACKEND_AUTOSTART|CLAUDE_SMART_DASHBOARD_AUTOSTART|CLAUDE_SMART_CLI_PATH|CLAUDE_SMART_CLI_TIMEOUT|CLAUDE_SMART_STATE_DIR|CLAUDE_SMART_ENABLE_OPTIMIZER)
+        if [ -z "$(eval "printf '%s' \"\${$key:-}\"")" ]; then
+          value="$(claude_smart_env_unquote "$value")"
+          export "$key=$value"
+        fi
+        ;;
+    esac
+  done < "$env_file"
+}
+
+claude_smart_reflexio_url_is_remote() {
+  local url
+  url="${REFLEXIO_URL:-}"
+  [ -n "$url" ] || return 1
+  case "$url" in
+    http://localhost|http://localhost/|http://localhost:*|http://127.0.0.1|http://127.0.0.1/|http://127.0.0.1:*|http://0.0.0.0|http://0.0.0.0/|http://0.0.0.0:*|http://\[::1\]|http://\[::1\]/|http://\[::1\]:*)
+      return 1
+      ;;
+  esac
+  return 0
+}
+
+claude_smart_is_internal_invocation_env() {
+  if [ "${CLAUDE_SMART_INTERNAL:-}" = "1" ]; then
+    return 0
+  fi
+  if [ -n "${CLAUDE_CODE_ENTRYPOINT:-}" ] && [ "${CLAUDE_CODE_ENTRYPOINT:-}" != "cli" ]; then
+    return 0
+  fi
+  return 1
+}
+
+claude_smart_emit_continue() {
+  if [ "${CLAUDE_SMART_HOST:-claude-code}" = "codex" ]; then
+    echo '{"continue":true}'
+  else
+    echo '{"continue":true,"suppressOutput":true}'
+  fi
+}
+
 claude_smart_dashboard_unavailable_marker() {
   printf '%s\n' "$HOME/.claude-smart/dashboard-unavailable"
 }
@@ -196,6 +267,61 @@ PY
   return 1
 }
 
+# Print a short fingerprint line for a file ("<cksum>:<size>" or "missing").
+claude_smart_fingerprint_file() {
+  local path
+  path="$1"
+  if [ -f "$path" ]; then
+    cksum "$path" 2>/dev/null | awk '{print $1 ":" $2}'
+  else
+    printf 'missing\n'
+  fi
+}
+
+# Print a multi-line fingerprint covering every input that determines
+# whether smart-install.sh can succeed. Order is stable so the hash is
+# reproducible. Args: $1 = plugin_root, $2 = scripts_dir.
+claude_smart_install_fingerprint() {
+  local plugin_root script_dir
+  plugin_root="$1"
+  script_dir="$2"
+  printf 'plugin_root=%s\n' "$plugin_root"
+  printf 'smart_install=%s\n' "$(claude_smart_fingerprint_file "$script_dir/smart-install.sh")"
+  printf 'lib=%s\n' "$(claude_smart_fingerprint_file "$script_dir/_lib.sh")"
+  printf 'pyproject=%s\n' "$(claude_smart_fingerprint_file "$plugin_root/pyproject.toml")"
+  printf 'uv_lock=%s\n' "$(claude_smart_fingerprint_file "$plugin_root/uv.lock")"
+  # Resolved python interpreter — catches a system upgrade (3.12.4 → 3.12.5)
+  # that would otherwise let install_complete return true against a venv
+  # built against a now-deleted interpreter.
+  if command -v uv >/dev/null 2>&1; then
+    printf 'python=%s\n' "$(uv python find 3.12 2>/dev/null || echo missing)"
+  else
+    printf 'python=no-uv\n'
+  fi
+  if [ -d "$plugin_root/dashboard" ]; then
+    printf 'dashboard_pkg=%s\n' "$(claude_smart_fingerprint_file "$plugin_root/dashboard/package.json")"
+    printf 'dashboard_lock=%s\n' "$(claude_smart_fingerprint_file "$plugin_root/dashboard/package-lock.json")"
+  else
+    printf 'dashboard_pkg=none\n'
+    printf 'dashboard_lock=none\n'
+  fi
+}
+
+# Hash the install fingerprint to a single short hex string. Used by the
+# install-failed marker so hook_entry.sh can detect when inputs change and
+# auto-clear a stale marker. Args: $1 = plugin_root, $2 = scripts_dir.
+claude_smart_install_fingerprint_hash() {
+  local plugin_root script_dir tmp rc
+  plugin_root="$1"
+  script_dir="$2"
+  tmp=$(mktemp 2>/dev/null) || return 1
+  claude_smart_install_fingerprint "$plugin_root" "$script_dir" > "$tmp"
+  claude_smart_sha256_file "$tmp"
+  rc=$?
+  rm -f "$tmp"
+  return $rc
+}
+
 # Return 0 if `node` exists and satisfies the minimum major/minor pair.
 # Patch versions are intentionally ignored because our requirement is a
 # floor, not an exact runtime pin.

package/plugin/scripts/backend-service.sh

@@ -22,18 +22,25 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 . "$HERE/_lib.sh"
 claude_smart_source_login_path
 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
 # binds to PORT instead of reflexio's library default (8081).
 export BACKEND_PORT="$PORT"
+export EMBEDDING_PORT
 
 # Default: route extraction through the active host CLI + ONNX embedder
 # so claude-smart works without any LLM API key. Users can opt out by
 # pre-exporting these to 0.
 export CLAUDE_SMART_USE_LOCAL_CLI="${CLAUDE_SMART_USE_LOCAL_CLI:-1}"
 export CLAUDE_SMART_USE_LOCAL_EMBEDDING="${CLAUDE_SMART_USE_LOCAL_EMBEDDING:-1}"
+if [ "${CLAUDE_SMART_USE_LOCAL_EMBEDDING:-}" = "1" ]; then
+  export REFLEXIO_EMBEDDING_PROVIDER="${REFLEXIO_EMBEDDING_PROVIDER:-local_service}"
+  export REFLEXIO_EMBEDDING_SERVICE_URL="${REFLEXIO_EMBEDDING_SERVICE_URL:-http://127.0.0.1:$EMBEDDING_PORT}"
+fi
 # The backend can be spawned from contexts whose PATH lacks the host
 # CLI dir (commonly ~/.local/bin or /opt/homebrew/bin). Pin the CLI
 # explicitly if we can resolve it from our own (post-login-path) PATH.
@@ -61,7 +68,7 @@ LOG_MAX_BYTES="$(claude_smart_log_max_bytes)"
 mkdir -p "$STATE_DIR"
 claude_smart_trim_log_file "$LOG_FILE" "$LOG_MAX_BYTES"
 
-emit_ok() { echo '{"continue":true,"suppressOutput":true}'; }
+emit_ok() { claude_smart_emit_continue; }
 
 emit_start_failure() {
   reason="$1"
@@ -173,6 +180,13 @@ full_stop() {
 
 case "$CMD" in
   start)
+    if claude_smart_is_internal_invocation_env; then
+      emit_ok; exit 0
+    fi
+    if claude_smart_reflexio_url_is_remote; then
+      claude_smart_append_capped_log "$LOG_FILE" "$LOG_MAX_BYTES" "[claude-smart] backend: remote REFLEXIO_URL configured; skipping local backend start"
+      emit_ok; exit 0
+    fi
     # Opt-out: users who don't want the backend managed by the hook can
     # set CLAUDE_SMART_BACKEND_AUTOSTART=0.
     if [ "${CLAUDE_SMART_BACKEND_AUTOSTART:-1}" = "0" ]; then
@@ -206,16 +220,21 @@ case "$CMD" in
     export INTERACTION_CLEANUP_THRESHOLD="${INTERACTION_CLEANUP_THRESHOLD:-500}"
     export INTERACTION_CLEANUP_DELETE_COUNT="${INTERACTION_CLEANUP_DELETE_COUNT:-200}"
 
-    # --no-reload: uvicorn's reloader forks a supervisor; makes
-    # bookkeeping harder and we don't need hot-reload for a user-facing
-    # service. Detach via claude_smart_spawn_detached so the same code
-    # path covers Linux (setsid), macOS (python3 os.setsid), and Windows
     # (nohup; no process groups). backend-log-runner.sh owns stdout/stderr
     # capture so process output cannot grow backend.log past its cap.
+    #
+    # --workers: reflexio defaults to 2 (zero-downtime worker recycling
+    # for server deployments). For a single-user Claude Code plugin
+    # that's pure overhead: ~1.1 GB extra RSS, periodic 5–10 s spawn
+    # hiccups during worker rotation, and SQLite can't accept concurrent
+    # writers anyway. Default to 1 here; opt in to N via
+    # CLAUDE_SMART_BACKEND_WORKERS for power users running concurrent
+    # Claude Code sessions or wanting zero-downtime recycling.
+    workers="${CLAUDE_SMART_BACKEND_WORKERS:-1}"
     claude_smart_spawn_detached bash "$HERE/backend-log-runner.sh" \
       "$LOG_FILE" "$LOG_MAX_BYTES" -- \
       uv run --project "$PLUGIN_ROOT" --quiet \
-      reflexio services start --only backend --no-reload
+      reflexio 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;
@@ -255,7 +274,13 @@ case "$CMD" in
     emit_ok
     ;;
   status)
-    if is_our_backend_running; then echo "running on http://localhost:$PORT"; else echo "not running"; fi
+    if claude_smart_reflexio_url_is_remote; then
+      echo "remote configured at $REFLEXIO_URL"
+    elif is_our_backend_running; then
+      echo "running on http://localhost:$PORT"
+    else
+      echo "not running"
+    fi
     ;;
   *)
     emit_ok

package/plugin/scripts/cli.sh

@@ -15,6 +15,7 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 claude_smart_source_login_path
 claude_smart_prepend_astral_bins
 claude_smart_prepend_node_bins
+claude_smart_source_reflexio_env
 
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
 
@@ -24,7 +25,7 @@ PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
 # on a broken install.
 FAILURE_MARKER="$HOME/.claude-smart/install-failed"
 if [ -f "$FAILURE_MARKER" ]; then
-  msg="$(cat "$FAILURE_MARKER" 2>/dev/null || echo "")"
+  msg="$(head -n 1 "$FAILURE_MARKER" 2>/dev/null || echo "")"
   [ -n "$msg" ] || msg="unknown error"
   echo "claude-smart is not installed correctly: $msg" >&2
   echo "Re-run the plugin's Setup (restart Claude Code) or fix the underlying issue and delete $FAILURE_MARKER to retry." >&2
@@ -50,7 +51,8 @@ if ! command -v uv >/dev/null 2>&1; then
   fi
   if ! command -v uv >/dev/null 2>&1; then
     if [ -f "$FAILURE_MARKER" ]; then
-      msg="$(cat "$FAILURE_MARKER" 2>/dev/null || echo "unknown error")"
+      msg="$(head -n 1 "$FAILURE_MARKER" 2>/dev/null || echo "")"
+      [ -n "$msg" ] || msg="unknown error"
       echo "claude-smart: install failed: $msg" >&2
       echo "Fix the underlying issue and delete $FAILURE_MARKER to retry." >&2
     else

package/plugin/scripts/codex-hook.js

@@ -16,7 +16,46 @@ const DASHBOARD_PORT = 3001;
 const LOG_MAX_BYTES = 10000000;
 
 function emitOk() {
-  process.stdout.write('{"continue":true,"suppressOutput":true}\n');
+  process.stdout.write('{"continue":true}\n');
+}
+
+function emitHookOk() {
+  process.stdout.write('{"continue":true}\n');
+}
+
+function emitNormalizedHookOutput(stdout) {
+  const lines = String(stdout || "")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+  if (lines.length === 0) {
+    emitHookOk();
+    return;
+  }
+
+  const merged = {};
+  for (const line of lines) {
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch {
+      appendLog("backend.log", `[claude-smart] codex hook emitted non-JSON stdout: ${line.slice(0, 500)}`);
+      emitHookOk();
+      return;
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      appendLog("backend.log", `[claude-smart] codex hook emitted non-object JSON stdout: ${line.slice(0, 500)}`);
+      emitHookOk();
+      return;
+    }
+    Object.assign(merged, parsed);
+  }
+
+  if (!Object.prototype.hasOwnProperty.call(merged, "continue")) {
+    merged.continue = true;
+  }
+  delete merged.suppressOutput;
+  process.stdout.write(`${JSON.stringify(merged)}\n`);
 }
 
 function ensureDir(dir) {
@@ -121,6 +160,56 @@ function writeBackendUrl(port) {
   fs.writeFileSync(backendUrlFile(), `http://localhost:${port}/\n`);
 }
 
+function unquoteEnvValue(value) {
+  const trimmed = String(value || "").trim();
+  if (trimmed.length >= 2) {
+    const first = trimmed[0];
+    const last = trimmed[trimmed.length - 1];
+    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+      return trimmed.slice(1, -1);
+    }
+  }
+  return trimmed;
+}
+
+function loadReflexioEnv() {
+  const file = path.join(REFLEXIO_DIR, ".env");
+  let text;
+  try {
+    text = fs.readFileSync(file, "utf8");
+  } catch {
+    return;
+  }
+  const allowed = new Set([
+    "REFLEXIO_URL",
+    "REFLEXIO_API_KEY",
+    "CLAUDE_SMART_USE_LOCAL_CLI",
+    "CLAUDE_SMART_USE_LOCAL_EMBEDDING",
+    "CLAUDE_SMART_BACKEND_AUTOSTART",
+    "CLAUDE_SMART_DASHBOARD_AUTOSTART",
+    "CLAUDE_SMART_CLI_PATH",
+    "CLAUDE_SMART_CLI_TIMEOUT",
+    "CLAUDE_SMART_STATE_DIR",
+    "CLAUDE_SMART_ENABLE_OPTIMIZER",
+  ]);
+  for (const rawLine of text.split(/\r?\n/)) {
+    let line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    if (line.startsWith("export ")) line = line.slice("export ".length).trimStart();
+    const eq = line.indexOf("=");
+    if (eq < 0) continue;
+    const key = line.slice(0, eq).trim();
+    if (!allowed.has(key) || process.env[key]) continue;
+    process.env[key] = unquoteEnvValue(line.slice(eq + 1));
+  }
+}
+
+function reflexioUrlIsRemote() {
+  const url = process.env.REFLEXIO_URL || "";
+  if (!url) return false;
+  return !/^http:\/\/(?:localhost|127\.0\.0\.1|0\.0\.0\.0|\[::1\])(?::\d+)?\/?$/i.test(url);
+}
+
 function codexCompatPath(root) {
   const filename = process.platform === "win32"
     ? "codex-claude-compat.cmd"
@@ -294,6 +383,11 @@ async function startBackend(root) {
     emitOk();
     return;
   }
+  if (reflexioUrlIsRemote()) {
+    appendLog("backend.log", "[claude-smart] backend: remote REFLEXIO_URL configured; skipping local backend start");
+    emitOk();
+    return;
+  }
   const pidFile = path.join(STATE_DIR, "backend.pid");
   for (const port of [DEFAULT_BACKEND_PORT, FALLBACK_BACKEND_PORT]) {
     if (pidAlive(readPid(pidFile)) && await healthOk(port, "/health")) {
@@ -419,7 +513,7 @@ function runHook(root, event) {
     }
     if (!uv) {
       appendLog("backend.log", "[claude-smart] hook: uv not on PATH after installer; skipping");
-      emitOk();
+      emitHookOk();
       return 0;
     }
   }
@@ -434,17 +528,20 @@ function runHook(root, event) {
         REFLEXIO_URL: readBackendUrl(),
         CLAUDE_SMART_HOST: "codex",
         CLAUDE_SMART_CLI_PATH: process.env.CLAUDE_SMART_CLI_PATH || codexCompatPath(root),
+        CLAUDE_SMART_CITATION_LINK_STYLE: process.env.CLAUDE_SMART_CITATION_LINK_STYLE || "osc8",
       },
       input,
-      stdio: ["pipe", "inherit", "inherit"],
+      stdio: ["pipe", "pipe", "inherit"],
       windowsHide: true,
     },
   );
+  emitNormalizedHookOutput(result.stdout);
   return typeof result.status === "number" ? result.status : 1;
 }
 
 async function main() {
   prependRuntimePath();
+  loadReflexioEnv();
   const root = pluginRoot();
   process.env.PLUGIN_ROOT = root;
   process.env.CLAUDE_PLUGIN_ROOT = root;

package/plugin/scripts/dashboard-service.sh

@@ -23,6 +23,7 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 . "$HERE/_lib.sh"
 claude_smart_source_login_path
 claude_smart_prepend_node_bins
+claude_smart_source_reflexio_env
 
 CMD="${1:-start}"
 PORT=3001
@@ -36,7 +37,7 @@ PID_FILE="$STATE_DIR/dashboard.pid"
 LOG_FILE="$STATE_DIR/dashboard.log"
 mkdir -p "$STATE_DIR"
 
-emit_ok() { echo '{"continue":true,"suppressOutput":true}'; }
+emit_ok() { claude_smart_emit_continue; }
 
 # Tree-kill the recorded process. Delegates to claude_smart_kill_tree
 # (POSIX: signal the process group; Windows: taskkill /T /F /PID).
@@ -45,15 +46,96 @@ kill_group() {
 }
 
 # True if the marker header served by app/api/health is present on the
-# port. Requires curl — absence is reported as false.
+# port. Requires curl — absence is reported as false. This deliberately
+# accepts any claude-smart dashboard, including stale cache versions, so
+# stop/uninstall can safely reap them without touching foreign listeners.
 marker_responds() {
   command -v curl >/dev/null 2>&1 || return 1
   curl -sfI "http://127.0.0.1:$PORT/api/health" 2>/dev/null \
     | grep -qi '^x-claude-smart-dashboard:'
 }
 
-# True only if *our* dashboard is on the port. Uses the marker header so a
-# foreign listener on 3001 doesn't cause us to silently skip starting.
+dashboard_health_headers() {
+  command -v curl >/dev/null 2>&1 || return 1
+  curl -sfI --connect-timeout 2 --max-time 5 "http://127.0.0.1:$PORT/api/health" 2>/dev/null
+}
+
+header_value_from() {
+  header_name="$1"
+  awk -v wanted="$header_name" '
+    BEGIN { wanted = tolower(wanted) ":" }
+    {
+      line = $0
+      sub(/\r$/, "", line)
+      lower = tolower(line)
+      if (index(lower, wanted) == 1) {
+        sub(/^[^:]*:[[:space:]]*/, "", line)
+        print line
+        exit
+      }
+    }
+  '
+}
+
+canonical_dir() {
+  dir="$1"
+  (cd "$dir" 2>/dev/null && pwd -P) || printf '%s\n' "$dir"
+}
+
+normalize_identity_path() {
+  path="$1"
+  if claude_smart_is_windows; then
+    if command -v cygpath >/dev/null 2>&1; then
+      path="$(cygpath -u "$path" 2>/dev/null || printf '%s\n' "$path")"
+    else
+      path="$(
+        printf '%s\n' "$path" | awk '{
+          gsub(/\\/, "/")
+          if ($0 ~ /^[A-Za-z]:/) {
+            drive = tolower(substr($0, 1, 1))
+            sub(/^[A-Za-z]:/, "/" drive)
+          }
+          print
+        }'
+      )"
+    fi
+  fi
+  while [ "${path%/}" != "$path" ] && [ "$path" != "/" ]; do
+    path="${path%/}"
+  done
+  printf '%s\n' "$path"
+}
+
+# True only if *this plugin root's* dashboard is on the port. The generic
+# x-claude-smart-dashboard marker is intentionally not enough: after an
+# install/update, an older cache can keep serving port 3001 until restarted.
+dashboard_matches_current_root() {
+  expected_root="$(normalize_identity_path "$(canonical_dir "$PLUGIN_ROOT")")"
+  headers="$(dashboard_health_headers)" || return 1
+  printf '%s\n' "$headers" | grep -qi '^x-claude-smart-dashboard:' || return 1
+  actual_root="$(printf '%s\n' "$headers" | header_value_from "x-claude-smart-plugin-root")"
+  [ -n "$actual_root" ] || return 1
+  actual_root="$(normalize_identity_path "$actual_root")"
+  [ "$actual_root" = "$expected_root" ]
+}
+
+# Kill a claude-smart dashboard listener currently holding the port. Gated by
+# marker_responds so a foreign app on 3001 is never killed.
+stop_dashboard_listener() {
+  marker_responds || return 0
+  command -v lsof >/dev/null 2>&1 || return 0
+  port_pid=$(lsof -t -i ":$PORT" -sTCP:LISTEN 2>/dev/null | head -n1)
+  [ -n "$port_pid" ] || return 0
+  kill -TERM "$port_pid" 2>/dev/null || true
+  for _ in 1 2 3 4 5; do
+    kill -0 "$port_pid" 2>/dev/null || return 0
+    sleep 0.2
+  done
+  kill -KILL "$port_pid" 2>/dev/null || true
+}
+
+# True only if *our* dashboard is on the port. Uses plugin-root identity so a
+# stale claude-smart listener doesn't cause us to silently skip starting.
 is_our_dashboard_running() {
   if [ -f "$PID_FILE" ]; then
     pid=$(cat "$PID_FILE" 2>/dev/null || echo "")
@@ -62,7 +144,7 @@ is_our_dashboard_running() {
       # don't claim "running" when the server crashed but the group leader
       # lingered.
       if command -v curl >/dev/null 2>&1; then
-        marker_responds && return 0
+        dashboard_matches_current_root && return 0
       else
         # No curl — fall back to PID liveness alone.
         return 0
@@ -71,7 +153,7 @@ is_our_dashboard_running() {
   fi
   # No PID or dead PID — probe the port for our marker (recovers after a
   # stale PID file from a crash).
-  marker_responds && return 0
+  dashboard_matches_current_root && return 0
   return 1
 }
 
@@ -87,6 +169,9 @@ port_occupied() {
 
 case "$CMD" in
   start)
+    if claude_smart_is_internal_invocation_env; then
+      emit_ok; exit 0
+    fi
     # Opt-out: users who don't want the dashboard long-lived can set
     # CLAUDE_SMART_DASHBOARD_AUTOSTART=0 in their environment.
     if [ "${CLAUDE_SMART_DASHBOARD_AUTOSTART:-1}" = "0" ]; then
@@ -94,6 +179,10 @@ case "$CMD" in
     fi
     if [ ! -d "$DASHBOARD_DIR" ]; then emit_ok; exit 0; fi
     if is_our_dashboard_running; then claude_smart_clear_dashboard_unavailable; emit_ok; exit 0; fi
+    if marker_responds; then
+      echo "[claude-smart] dashboard: stale claude-smart dashboard on port $PORT; restarting from $PLUGIN_ROOT" >>"$LOG_FILE"
+      stop_dashboard_listener
+    fi
     if port_occupied; then
       echo "[claude-smart] dashboard: port $PORT held by another process; skipping" >>"$LOG_FILE"
       emit_ok; exit 0
@@ -149,7 +238,7 @@ case "$CMD" in
     echo "$dash_pid" > "$PID_FILE"
     dashboard_ready=0
     for _ in 1 2 3 4 5; do
-      if marker_responds; then
+      if dashboard_matches_current_root; then
         dashboard_ready=1
         claude_smart_clear_dashboard_unavailable
         break
@@ -166,21 +255,11 @@ case "$CMD" in
       kill_group "$(cat "$PID_FILE" 2>/dev/null)"
       rm -f "$PID_FILE"
     fi
-    # Fallback: if our dashboard is still responding on the port (e.g.,
+    # Fallback: if a claude-smart dashboard is still responding on the port (e.g.,
     # was started outside this script, or the PGID kill missed because
     # the process wasn't the group leader) kill whoever owns the port.
     # Gated on the marker header so we never touch a foreign listener.
-    if marker_responds && command -v lsof >/dev/null 2>&1; then
-      port_pid=$(lsof -t -i ":$PORT" -sTCP:LISTEN 2>/dev/null | head -n1)
-      if [ -n "$port_pid" ]; then
-        kill -TERM "$port_pid" 2>/dev/null || true
-        for _ in 1 2 3 4 5; do
-          kill -0 "$port_pid" 2>/dev/null || break
-          sleep 0.2
-        done
-        kill -KILL "$port_pid" 2>/dev/null || true
-      fi
-    fi
+    stop_dashboard_listener
     emit_ok
     ;;
   session-end)

package/plugin/scripts/hook_entry.sh

@@ -18,14 +18,23 @@ case "$EVENT" in
     EVENT="${2:-}"
     ;;
 esac
-if [ -z "$EVENT" ]; then
-  echo '{"continue":true,"suppressOutput":true}'
-  exit 0
+export CLAUDE_SMART_HOST="$HOST"
+if [ "$HOST" = "codex" ] && [ -z "${CLAUDE_SMART_CITATION_LINK_STYLE:-}" ]; then
+  export CLAUDE_SMART_CITATION_LINK_STYLE="osc8"
 fi
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 # shellcheck source=_lib.sh
 . "$HERE/_lib.sh"
+if [ -z "$EVENT" ]; then
+  claude_smart_emit_continue
+  exit 0
+fi
+
+if claude_smart_is_internal_invocation_env; then
+  claude_smart_emit_continue
+  exit 0
+fi
 # Pick up uv from the user's login-shell PATH (covers ~/.local/bin populated
 # by the astral.sh installer) so a fresh install works before the user
 # restarts their terminal. Matches the pattern used by smart-install.sh.
@@ -33,16 +42,27 @@ claude_smart_source_login_path
 # Explicit fallback for the astral.sh installer's default paths, in case
 # the user's login-shell rc hasn't yet been re-sourced to pick them up.
 claude_smart_prepend_astral_bins
+claude_smart_source_reflexio_env
 
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
 
 FAILURE_MARKER="$HOME/.claude-smart/install-failed"
 STATE_DIR="$HOME/.claude-smart"
 if [ -f "$FAILURE_MARKER" ]; then
-  if [ "$EVENT" = "session-start" ] && command -v python3 >/dev/null 2>&1; then
-    python3 - "$FAILURE_MARKER" <<'PY'
+  # Auto-clear the marker when install inputs have changed since the
+  # failure was recorded (pyproject.toml / uv.lock / smart-install.sh /
+  # python interpreter etc.). Without this the plugin stays muted forever
+  # after a transient sync failure even when the user has fixed it.
+  stored_fp="$(awk -F= '$1=="fingerprint"{print $2; exit}' "$FAILURE_MARKER" 2>/dev/null || true)"
+  current_fp="$(claude_smart_install_fingerprint_hash "$PLUGIN_ROOT" "$HERE" 2>/dev/null || true)"
+  if [ -z "$stored_fp" ] || [ "$stored_fp" != "$current_fp" ]; then
+    rm -f "$FAILURE_MARKER"
+  else
+    if [ "$EVENT" = "session-start" ] && command -v python3 >/dev/null 2>&1; then
+      python3 - "$FAILURE_MARKER" <<'PY'
 import json, pathlib, sys
-msg = pathlib.Path(sys.argv[1]).read_text().strip() or "unknown error"
+first = pathlib.Path(sys.argv[1]).read_text().splitlines()
+msg = (first[0].strip() if first else "") or "unknown error"
 print(json.dumps({
     "hookSpecificOutput": {
         "hookEventName": "SessionStart",
@@ -55,10 +75,11 @@ print(json.dumps({
     }
 }))
 PY
-  else
-    echo '{"continue":true,"suppressOutput":true}'
+    else
+      claude_smart_emit_continue
+    fi
+    exit 0
   fi
-  exit 0
 fi
 
 if ! command -v uv >/dev/null 2>&1; then
@@ -67,7 +88,7 @@ if ! command -v uv >/dev/null 2>&1; then
   # the same installer detached so normal work is not blocked by first-run
   # dependency setup.
   if [ "${CLAUDE_SMART_BOOTSTRAPPING:-}" = "1" ]; then
-    echo '{"continue":true,"suppressOutput":true}'
+    claude_smart_emit_continue
     exit 0
   fi
   if [ -x "$PLUGIN_ROOT/scripts/smart-install.sh" ]; then
@@ -87,7 +108,7 @@ if ! command -v uv >/dev/null 2>&1; then
     fi
   fi
   if ! command -v uv >/dev/null 2>&1; then
-    echo '{"continue":true,"suppressOutput":true}'
+    claude_smart_emit_continue
     exit 0
   fi
 fi