claude-smart 0.2.32 → 0.2.33

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.32-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.2.33-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

@@ -39,6 +39,7 @@ const CODEX_MARKETPLACE_DISPLAY_NAME = "ReflexioAI";
 const CODEX_PLUGIN_ID = `claude-smart@${CODEX_MARKETPLACE_NAME}`;
 const REFLEXIO_ENV_PATH = join(homedir(), ".reflexio", ".env");
 const MANAGED_REFLEXIO_URL = "https://www.reflexio.ai/";
+const REFLEXIO_USER_ID_ENV = "REFLEXIO_USER_ID";
 const REFLEXIO_DIR = join(homedir(), ".reflexio");
 const CLAUDE_SMART_STATE_DIR = join(homedir(), ".claude-smart");
 const CODEX_CONFIG_PATH = join(homedir(), ".codex", "config.toml");
@@ -256,6 +257,25 @@ function setReflexioEnvVars(values) {
   return added;
 }
 
+function readReflexioEnvValue(key) {
+  const existing = existsSync(REFLEXIO_ENV_PATH)
+    ? readFileSync(REFLEXIO_ENV_PATH, "utf8")
+    : "";
+  for (const line of existing.split(/\r?\n/)) {
+    const parsed = parseEnvLine(line);
+    if (!parsed || parsed.key !== key) continue;
+    let value = line.slice(line.indexOf("=") + 1).trim();
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    }
+    return value;
+  }
+  return "";
+}
+
 function maskSecret(value) {
   if (!value) return "";
   if (value.length <= 8) return "*".repeat(value.length);
@@ -267,9 +287,11 @@ function configureReflexioSetup(args) {
   const apiKey = parseOptionalArg(args, "--api-key").trim();
   if (apiKey) {
     const reflexioUrl = parseOptionalArg(args, "--reflexio-url") || MANAGED_REFLEXIO_URL;
+    const userId = readReflexioEnvValue(REFLEXIO_USER_ID_ENV) || crypto.randomUUID();
     const added = setReflexioEnvVars({
       REFLEXIO_URL: reflexioUrl,
       REFLEXIO_API_KEY: apiKey,
+      [REFLEXIO_USER_ID_ENV]: userId,
     });
     const changed = added.length > 0 ? added.join(", ") : "managed Reflexio settings";
     process.stdout.write(
@@ -302,6 +324,8 @@ function findClaudeCodePluginRoot() {
     // Fall through to marketplace/package fallbacks.
   }
   candidates.sort((a, b) => {
+    const versionCompare = compareSemverLikePathNames(b, a);
+    if (versionCompare !== 0) return versionCompare;
     try {
       return statSync(b).mtimeMs - statSync(a).mtimeMs;
     } catch {
@@ -323,6 +347,27 @@ function findClaudeCodePluginRoot() {
   return null;
 }
 
+function semverLikePathName(path) {
+  const base = String(path).split(/[\\/]/).pop() || "";
+  const match = base.match(/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
+  if (!match) return null;
+  return match.slice(1).map((part) => Number.parseInt(part, 10));
+}
+
+function compareSemverLikePathNames(a, b) {
+  const av = semverLikePathName(a);
+  const bv = semverLikePathName(b);
+  if (av && bv) {
+    for (let i = 0; i < 3; i += 1) {
+      if (av[i] !== bv[i]) return av[i] - bv[i];
+    }
+    return 0;
+  }
+  if (av) return 1;
+  if (bv) return -1;
+  return 0;
+}
+
 function forcePluginRoot(pluginRoot) {
   mkdirSync(REFLEXIO_DIR, { recursive: true });
   const link = join(REFLEXIO_DIR, "plugin-root");
@@ -808,7 +853,7 @@ function printHelp() {
       `  2. claude plugin install ${PLUGIN_SPEC}`,
       "  3. Appends CLAUDE_SMART_USE_LOCAL_CLI=1 and CLAUDE_SMART_USE_LOCAL_EMBEDDING=1",
       "     to ~/.reflexio/.env (idempotent).",
-      "     Passing --api-key writes REFLEXIO_URL and REFLEXIO_API_KEY instead.",
+      "     Passing --api-key writes REFLEXIO_URL, REFLEXIO_API_KEY, and REFLEXIO_USER_ID instead.",
       "",
       "Codex install:",
       `  1. Copies the bundled marketplace to ${CODEX_MARKETPLACE_DIR}`,
@@ -821,6 +866,7 @@ function printHelp() {
       "",
       "Update:",
       "  npx claude-smart update                        Update to the latest version",
+      "  npx claude-smart update --api-key <key>        Update and configure managed Reflexio",
       "",
       "Uninstall:",
       "  npx claude-smart uninstall                     Remove the plugin from Claude Code",
@@ -1246,7 +1292,7 @@ function installCodexPluginCache(pluginRoot) {
   return cacheDir;
 }
 
-async function runUpdate() {
+async function runUpdate(args) {
   if (!hasClaudeCli()) {
     process.stderr.write(
       "error: 'claude' CLI not found on PATH. " +
@@ -1264,6 +1310,7 @@ async function runUpdate() {
   }
 
   process.stdout.write("\nclaude-smart updated. Restart Claude Code to apply.\n");
+  if (args.includes("--api-key")) configureReflexioSetup(args);
 }
 
 async function runUninstall(args) {
@@ -1316,6 +1363,8 @@ async function runInstall(args) {
   }
 
   const source = parseSource(args);
+  configureReflexioSetup(args);
+
   const steps = [
     { args: ["plugin", "marketplace", "add", source], label: "Adding marketplace…" },
     { args: ["plugin", "install", PLUGIN_SPEC], label: "Installing claude-smart…" },
@@ -1331,7 +1380,6 @@ async function runInstall(args) {
     }
   }
 
-  configureReflexioSetup(args);
   try {
     const pluginRoot = await bootstrapClaudeCodeInstall();
     process.stdout.write(`Prepared claude-smart runtime at ${pluginRoot}.\n`);
@@ -1364,6 +1412,7 @@ async function runInstallCodex(args) {
     process.stderr.write("error: 'codex' CLI not found on PATH. Install Codex first.\n");
     process.exit(1);
   }
+  configureReflexioSetup(args);
 
   const marketplaceRoot = copyCodexMarketplace();
   process.stdout.write(`Prepared Codex marketplace at ${marketplaceRoot}.\n`);
@@ -1406,7 +1455,6 @@ async function runInstallCodex(args) {
   try {
     cacheDir = installCodexPluginCache(codexMarketplacePluginRoot(marketplaceRoot));
     process.stdout.write(`Installed Codex plugin cache at ${cacheDir}.\n`);
-    configureReflexioSetup(args);
     await bootstrapPluginRuntime(cacheDir);
     if (refreshDashboardService(cacheDir)) {
       process.stdout.write("Refreshed claude-smart dashboard service.\n");
@@ -1496,7 +1544,7 @@ async function main() {
   }
 
   if (cmd === "update") {
-    await runUpdate();
+    await runUpdate(args.slice(1));
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.32",
+  "version": "0.2.33",
   "description": "Self-improving Claude Code plugin — learns from corrections via reflexio",
   "keywords": [
     "claude",

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

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.32",
+  "version": "0.2.33",
   "description": "Self-improving Claude Code plugin — learns from corrections across sessions via reflexio",
   "author": {
     "name": "Yi Lu"

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

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

package/plugin/dashboard/lib/config-file.ts

@@ -11,6 +11,7 @@ import type { ClaudeSmartConfig } from "./types";
 const KNOWN_KEYS = [
   "REFLEXIO_URL",
   "REFLEXIO_API_KEY",
+  "REFLEXIO_USER_ID",
   "CLAUDE_SMART_USE_LOCAL_CLI",
   "CLAUDE_SMART_USE_LOCAL_EMBEDDING",
   "CLAUDE_SMART_CLI_PATH",
@@ -49,6 +50,7 @@ export async function readConfig(): Promise<ClaudeSmartConfig> {
   const defaults: ClaudeSmartConfig = {
     REFLEXIO_URL: "http://localhost:8071/",
     REFLEXIO_API_KEY: "",
+    REFLEXIO_USER_ID: "",
     CLAUDE_SMART_USE_LOCAL_CLI: false,
     CLAUDE_SMART_USE_LOCAL_EMBEDDING: false,
     CLAUDE_SMART_CLI_PATH: "",

package/plugin/dashboard/lib/types.ts

@@ -114,6 +114,7 @@ export interface SessionDetail {
 export interface ClaudeSmartConfig {
   REFLEXIO_URL: string;
   REFLEXIO_API_KEY: string;
+  REFLEXIO_USER_ID: string;
   REFLEXIO_API_KEY_SET?: boolean;
   CLAUDE_SMART_USE_LOCAL_CLI: boolean;
   CLAUDE_SMART_USE_LOCAL_EMBEDDING: boolean;

package/plugin/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-smart"
-version = "0.2.32"
+version = "0.2.33"
 description = "Self-improving Claude Code plugin — learns from corrections via reflexio"
 readme = "README.md"
 requires-python = ">=3.12"

package/plugin/scripts/_lib.sh

@@ -63,7 +63,7 @@ claude_smart_source_reflexio_env() {
     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)
+      REFLEXIO_URL|REFLEXIO_API_KEY|REFLEXIO_USER_ID|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"

package/plugin/scripts/codex-hook.js

@@ -183,6 +183,7 @@ function loadReflexioEnv() {
   const allowed = new Set([
     "REFLEXIO_URL",
     "REFLEXIO_API_KEY",
+    "REFLEXIO_USER_ID",
     "CLAUDE_SMART_USE_LOCAL_CLI",
     "CLAUDE_SMART_USE_LOCAL_EMBEDDING",
     "CLAUDE_SMART_BACKEND_AUTOSTART",

package/plugin/src/claude_smart/cli.py

@@ -30,6 +30,7 @@ import shutil
 import subprocess
 import sys
 import time
+import uuid
 from dataclasses import dataclass
 from pathlib import Path
 
@@ -144,15 +145,52 @@ def _seed_reflexio_env() -> list[str]:
 
 def _seed_managed_reflexio_env(*, api_key: str, reflexio_url: str) -> list[str]:
     """Write managed Reflexio connection settings to ``~/.reflexio/.env``."""
+    user_id = _read_reflexio_env_value(env_config.REFLEXIO_USER_ID_ENV) or str(
+        uuid.uuid4()
+    )
     return env_config.set_env_vars(
         _REFLEXIO_ENV_PATH,
         {
             env_config.REFLEXIO_URL_ENV: reflexio_url,
             env_config.REFLEXIO_API_KEY_ENV: api_key,
+            env_config.REFLEXIO_USER_ID_ENV: user_id,
         },
     )
 
 
+def _read_reflexio_env_value(key: str) -> str:
+    try:
+        text = _REFLEXIO_ENV_PATH.read_text()
+    except OSError:
+        return ""
+    for line in text.splitlines():
+        parsed = env_config.parse_env_line(line)
+        if parsed is None:
+            continue
+        parsed_key, value = parsed
+        if parsed_key == key:
+            return value
+    return ""
+
+
+def _semver_tuple(path: Path) -> tuple[int, int, int] | None:
+    parts = path.name.split(".", 2)
+    if len(parts) != 3:
+        return None
+    try:
+        patch = parts[2].split("-", 1)[0].split("+", 1)[0]
+        return (int(parts[0]), int(parts[1]), int(patch))
+    except ValueError:
+        return None
+
+
+def _installed_plugin_sort_key(path: Path) -> tuple[int, int, int, int, float]:
+    version = _semver_tuple(path)
+    if version is not None:
+        return (1, *version, path.stat().st_mtime)
+    return (0, 0, 0, 0, path.stat().st_mtime)
+
+
 def _find_claude_code_plugin_root() -> Path | None:
     """Locate the installed Claude Code plugin root after native install."""
     cache_root = (
@@ -172,7 +210,7 @@ def _find_claude_code_plugin_root() -> Path | None:
                 and (child / "scripts" / "smart-install.sh").is_file()
             ):
                 candidates.append(child)
-    candidates.sort(key=lambda path: path.stat().st_mtime, reverse=True)
+    candidates.sort(key=_installed_plugin_sort_key, reverse=True)
     candidates.extend(
         [
             Path.home()
@@ -797,6 +835,7 @@ def cmd_install_codex(args: argparse.Namespace) -> int:
             "error: 'uv' not found on PATH. Install uv or restart your shell.\n"
         )
         return 1
+    _configure_reflexio_setup(args)
 
     missing = _missing_codex_marketplace_files(_REPO_ROOT)
     if missing:
@@ -808,8 +847,6 @@ def cmd_install_codex(args: argparse.Namespace) -> int:
         return 1
     marketplace_root = _prepare_codex_local_marketplace()
 
-    _configure_reflexio_setup(args)
-
     hooks_ok, hooks_msg = _enable_codex_plugin_hooks()
     if hooks_ok:
         sys.stdout.write(f"Enabled Codex plugin hooks ({hooks_msg}).\n")
@@ -899,6 +936,7 @@ def cmd_install(args: argparse.Namespace) -> int:
             "Install Claude Code first: https://claude.com/claude-code\n"
         )
         return 1
+    _configure_reflexio_setup(args)
 
     for cmd in (
         ["claude", "plugin", "marketplace", "add", args.source],
@@ -910,8 +948,6 @@ def cmd_install(args: argparse.Namespace) -> int:
             sys.stderr.write(f"error: {' '.join(cmd)} failed (exit {exc.returncode})\n")
             return exc.returncode or 1
 
-    _configure_reflexio_setup(args)
-
     bootstrapped, message = _bootstrap_claude_code_install()
     if not bootstrapped:
         sys.stderr.write(
@@ -930,7 +966,7 @@ def cmd_install(args: argparse.Namespace) -> int:
     return 0
 
 
-def cmd_update(_args: argparse.Namespace) -> int:
+def cmd_update(args: argparse.Namespace) -> int:
     """Update claude-smart to the latest version via the native plugin CLI.
 
     Runs ``claude plugin update claude-smart@reflexioai``.
@@ -956,6 +992,8 @@ def cmd_update(_args: argparse.Namespace) -> int:
         return exc.returncode or 1
 
     sys.stdout.write("\nclaude-smart updated. Restart Claude Code to apply.\n")
+    if getattr(args, "api_key", ""):
+        _configure_reflexio_setup(args)
     return 0
 
 
@@ -1744,6 +1782,16 @@ def _build_parser() -> argparse.ArgumentParser:
     inst.set_defaults(func=cmd_install)
 
     upd = sub.add_parser("update", help="Update claude-smart to the latest version")
+    upd.add_argument(
+        "--api-key",
+        default="",
+        help="Configure managed Reflexio with this API key after updating",
+    )
+    upd.add_argument(
+        "--reflexio-url",
+        default=_MANAGED_REFLEXIO_URL,
+        help="Managed Reflexio URL used only when --api-key is provided",
+    )
     upd.set_defaults(func=cmd_update)
 
     uni = sub.add_parser("uninstall", help="Remove claude-smart")

package/plugin/src/claude_smart/env_config.py

@@ -9,6 +9,7 @@ REFLEXIO_ENV_PATH = Path.home() / ".reflexio" / ".env"
 MANAGED_REFLEXIO_URL = "https://www.reflexio.ai/"
 REFLEXIO_URL_ENV = "REFLEXIO_URL"
 REFLEXIO_API_KEY_ENV = "REFLEXIO_API_KEY"
+REFLEXIO_USER_ID_ENV = "REFLEXIO_USER_ID"
 
 
 def parse_env_line(line: str) -> tuple[str, str] | None:

package/plugin/src/claude_smart/ids.py

@@ -19,14 +19,22 @@ from __future__ import annotations
 import logging
 import os
 import subprocess  # noqa: S404 — git invocation with a fixed flag set.
+import uuid
 from pathlib import Path
 
+from claude_smart import env_config
+
 _LOGGER = logging.getLogger(__name__)
 
 
 def resolve_project_id(cwd: str | os.PathLike[str] | None = None) -> str:
     """Return a stable project identifier for the given working directory.
 
+    Managed Reflexio installs are user-scoped instead of project-scoped:
+    when ``REFLEXIO_API_KEY`` is configured, the persisted
+    ``REFLEXIO_USER_ID`` UUID is returned. Local installs without an API key
+    keep using the git/project name.
+
     Prefers the basename of the git toplevel (so worktrees, submodules, and
     `cd src/` all still map to the same project). Falls back to the cwd
     basename when the directory is not inside a git repo.
@@ -37,6 +45,10 @@ def resolve_project_id(cwd: str | os.PathLike[str] | None = None) -> str:
     Returns:
         str: A non-empty identifier. Never raises.
     """
+    managed_user_id = _managed_user_id()
+    if managed_user_id:
+        return managed_user_id
+
     base = Path(cwd) if cwd is not None else Path.cwd()
     try:
         result = subprocess.run(  # noqa: S603, S607 — fixed argv, cwd is a Path.
@@ -54,3 +66,23 @@ def resolve_project_id(cwd: str | os.PathLike[str] | None = None) -> str:
     except (FileNotFoundError, subprocess.TimeoutExpired) as exc:
         _LOGGER.debug("git toplevel resolution failed: %s", exc)
     return base.name or "unknown-project"
+
+
+def _managed_user_id() -> str:
+    env_config.load_reflexio_env()
+    if not os.environ.get(env_config.REFLEXIO_API_KEY_ENV):
+        return ""
+    user_id = os.environ.get(env_config.REFLEXIO_USER_ID_ENV, "").strip()
+    if user_id:
+        return user_id
+
+    user_id = str(uuid.uuid4())
+    try:
+        env_config.set_env_vars(
+            env_config.REFLEXIO_ENV_PATH,
+            {env_config.REFLEXIO_USER_ID_ENV: user_id},
+        )
+    except OSError as exc:
+        _LOGGER.debug("could not persist managed Reflexio user id: %s", exc)
+    os.environ[env_config.REFLEXIO_USER_ID_ENV] = user_id
+    return user_id

package/plugin/src/claude_smart/publish.py

@@ -29,9 +29,9 @@ def publish_unpublished(
 
     Args:
         session_id (str): Claude Code session id, attached to each interaction.
-        project_id (str): Stable project name; used as reflexio's
-            ``user_id`` (preferences) so preferences accumulate at the project
-            level across sessions. ``agent_version`` is hardcoded to
+        project_id (str): Stable user-scope id resolved by ``ids``. Local mode
+            uses the project name; managed/API-key mode uses the persisted
+            ``REFLEXIO_USER_ID`` UUID. ``agent_version`` is hardcoded to
             ``"claude-code"`` in the adapter so skills roll up
             globally per agent rather than per project.
         force_extraction (bool): Whether to ask reflexio to run extraction

package/plugin/src/claude_smart/reflexio_adapter.py

@@ -250,9 +250,10 @@ class Adapter:
     def fetch_user_playbooks(self, *, project_id: str, top_k: int = 10) -> list[Any]:
         """Fetch CURRENT user playbooks for ``project_id``.
 
-        User playbooks are project-scoped: filtering by ``user_id=project_id``
-        mirrors the publish path (``publish_interaction(user_id=project_id, …)``)
-        so each project only sees the playbooks it produced.
+        User playbooks are scoped by the resolved user id: local installs use
+        the project name, while managed installs use ``REFLEXIO_USER_ID``.
+        Filtering mirrors the publish path
+        (``publish_interaction(user_id=project_id, …)``).
 
         Args:
             project_id (str): reflexio ``user_id`` for this repo.

package/plugin/uv.lock

@@ -419,7 +419,7 @@ wheels = [
 
 [[package]]
 name = "claude-smart"
-version = "0.2.32"
+version = "0.2.33"
 source = { editable = "." }
 dependencies = [
     { name = "chromadb" },