claude-smart 0.2.49 → 0.2.50

package/.claude-plugin/marketplace.json

@@ -9,9 +9,9 @@
   "plugins": [
     {
       "name": "claude-smart",
-      "version": "0.2.49",
       "source": "./plugin",
-      "description": "Turns corrections into Preferences, Project-specific skills, and Shared skills — uses Claude Code, Codex, or OpenCode as the LLM backend (no external API key required)"
+      "description": "Turns corrections into Preferences, Project-specific skills, and Shared skills — uses Claude Code, Codex, or OpenCode as the LLM backend (no external API key required)",
+      "version": "0.2.50"
     }
   ]
 }

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.49-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.2.50-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">
@@ -58,6 +58,8 @@
 
 ## Quick Start
 
+Requires Node.js 20+ (for `npx`) and the host CLI you're installing into (`claude`, `codex`, or `opencode`) on `PATH`.
+
 ### Claude Code
 
 ```bash
@@ -66,27 +68,6 @@ npx claude-smart install
 
 Then restart Claude Code.
 
-Requires Node.js (for `npx`) to already exist.
-
-Alternatively, install via Claude Code's plugin marketplace:
-
-```bash
-claude plugin marketplace add ReflexioAI/claude-smart
-claude plugin install claude-smart@reflexioai
-```
-
-To uninstall:
-
-```bash
-npx claude-smart uninstall
-```
-
-Or, if installed via the plugin marketplace:
-
-```bash
-claude plugin uninstall claude-smart@reflexioai
-```
-
 ### Codex
 
 ```bash
@@ -95,39 +76,25 @@ npx claude-smart install --host codex
 
 Then fully quit and reopen Codex so hooks reload.
 
-Requires the `codex` CLI on `PATH` and Node.js (for `npx`).
-
-To uninstall:
-
-```bash
-npx claude-smart uninstall --host codex
-```
-
-Restart Codex after uninstalling. The uninstaller stops local claude-smart services and removes plugin/cache/config state; learned data under `~/.reflexio/` and `~/.claude-smart/` is preserved and shared with Claude Code, so you can switch between hosts without losing skills or preferences.
-
 ### OpenCode
 
 ```bash
 npx claude-smart install --host opencode
 ```
 
-Then restart OpenCode in your project so it loads the plugin from `opencode.json`, the documented project config file. If that project does not already have a root config but does have `.opencode/opencode.json` or `.opencode/opencode.jsonc`, the installer updates that existing file instead of creating a second config. If both locations exist, the root config wins. Use `--global` to install into `~/.config/opencode/opencode.json` for all OpenCode projects on this machine. The installer copies the active package to `~/.claude-smart/opencode/claude-smart`, prepares that runtime immediately, and writes a `file://` plugin entry so OpenCode reloads the same prepared package after restart.
-
-The installer prepares claude-smart's runtime dependencies, but expects the OpenCode CLI to already be installed. It resolves and records the OpenCode executable in `~/.claude-smart/.env` for later backend restarts; set `CLAUDE_SMART_OPENCODE_PATH` before install if `opencode` is not on `PATH`.
-
-OpenCode support is new and uses OpenCode's plugin loader to inject relevant learned context before each model request. Learning extraction runs `opencode run --pure` from an isolated temp project, so it uses OpenCode's default model unless you set `CLAUDE_SMART_OPENCODE_MODEL=provider/model`. Set that env var if your normal project config pins a different provider or model.
-
-On native Windows, install Git for Windows and make `bash.exe` available on `PATH` before starting OpenCode, or run OpenCode from WSL. The installer also checks the Windows local embedding runtime and writes actionable setup failures to `~/.claude-smart/install-failed`.
+Then restart OpenCode in your project so it loads the plugin from `opencode.json`. Add `--global` to install for all OpenCode projects on this machine instead.
 
-To uninstall:
+### Uninstall
 
 ```bash
-npx claude-smart uninstall --host opencode
+npx claude-smart uninstall                    # Claude Code
+npx claude-smart uninstall --host codex       # Codex
+npx claude-smart uninstall --host opencode    # OpenCode
 ```
 
-Restart OpenCode after uninstalling. The uninstaller removes the `claude-smart` entry from OpenCode's plugin list and deletes the copied OpenCode package; learned data under `~/.reflexio/` and `~/.claude-smart/` is preserved and shared across hosts.
+Restart the host afterward. Learned data under `~/.reflexio/` and `~/.claude-smart/` is preserved and shared across hosts, so you can uninstall or switch hosts without losing skills or preferences.
 
-Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-locally) for what the installer does, manual toggles via `/plugins`, and clone-based development.
+For per-host details — what the installers and uninstallers touch, OpenCode config resolution and model/env overrides, and Windows notes — see [Host install notes](./DEVELOPER.md#host-install-notes) in DEVELOPER.md. Developing the plugin itself? See [Developing locally](./DEVELOPER.md#developing-locally).
 
 > **Not supported:** Claude Code Cowork, claude.ai/code web, or remote Codex environments without local plugin hooks — they run outside your local machine, so the local backend/dashboard and `~/.reflexio/` aren't reachable.
 

package/bin/claude-smart.js

@@ -816,6 +816,66 @@ function fileSha256(path) {
   return crypto.createHash("sha256").update(readFileSync(path)).digest("hex");
 }
 
+function claudeCodeCacheRoot() {
+  return join(homedir(), ".claude", "plugins", "cache", CODEX_MARKETPLACE_NAME, "claude-smart");
+}
+
+// Version of the plugin this npm package ships. The Claude Code cache is keyed
+// by this version, and each version vendors a different Reflexio — so the
+// vendor payload may only ever be compared against the cache dir for *this*
+// version. Comparing against some other version's cache reports a spurious
+// mismatch (its vendor legitimately differs) and would force a pointless
+// reinstall.
+function claudeCodePackageVersion(sourceRoot = join(PACKAGE_ROOT, "plugin")) {
+  try {
+    const manifest = JSON.parse(
+      readFileSync(join(sourceRoot, ".claude-plugin", "plugin.json"), "utf8"),
+    );
+    if (typeof manifest.version === "string" && manifest.version) return manifest.version;
+  } catch {
+    // Fall through to pyproject.toml.
+  }
+  try {
+    const match = readFileSync(join(sourceRoot, "pyproject.toml"), "utf8").match(
+      /^version\s*=\s*"([^"]+)"/m,
+    );
+    if (match) return match[1];
+  } catch {
+    // No readable version.
+  }
+  return null;
+}
+
+function claudeCodeVendorPayloadMismatch(
+  pluginRoot,
+  sourceRoot = join(PACKAGE_ROOT, "plugin"),
+) {
+  // A sentinel pair, not a full tree hash: it catches the failure this exists
+  // for (a cache with no vendor bundle at all, or one from a different build),
+  // not a vendor tree that is individually corrupt past these two files.
+  const vendorFiles = [
+    "vendor/reflexio/pyproject.toml",
+    "vendor/reflexio/reflexio/__init__.py",
+  ];
+  // A git checkout gitignores the generated vendor bundle, so a source tree
+  // without one is a dev install, not a broken cache. Nothing to compare.
+  const sourceHasVendor = vendorFiles.some((rel) =>
+    existsSync(join(sourceRoot, rel)),
+  );
+  if (!sourceHasVendor) return null;
+
+  for (const rel of vendorFiles) {
+    const source = join(sourceRoot, rel);
+    const cached = join(pluginRoot, rel);
+    if (!existsSync(source)) {
+      throw new Error(`installed claude-smart package is missing ${rel}`);
+    }
+    if (!existsSync(cached)) return rel;
+    if (fileSha256(source) !== fileSha256(cached)) return rel;
+  }
+  return null;
+}
+
 function verifyOpenCodePluginPackage(packageRoot) {
   const sourceScript = join(PACKAGE_ROOT, "plugin", "scripts", "smart-install.sh");
   const copiedScript = join(packageRoot, "plugin", "scripts", "smart-install.sh");
@@ -951,6 +1011,48 @@ async function bootstrapClaudeCodeInstall() {
   return pluginRoot;
 }
 
+async function refreshClaudeCodeCacheIfVendorMissing() {
+  const version = claudeCodePackageVersion();
+  if (!version) return null;
+  // Only ever inspect and repair the cache dir for the version we are
+  // installing. Other version dirs coexist in the cache and are not ours to
+  // judge — `findClaudeCodePluginRoot()` returns the highest one, which is a
+  // different plugin build whenever this package is a downgrade.
+  const pluginRoot = join(claudeCodeCacheRoot(), version);
+  if (!existsSync(pluginRoot)) return null;
+
+  const mismatch = claudeCodeVendorPayloadMismatch(pluginRoot);
+  if (!mismatch) return pluginRoot;
+
+  process.stderr.write(
+    `warning: cached claude-smart plugin is missing or has stale ${mismatch}; reinstalling from the bundled npm package.\n`,
+  );
+  let code = await runClaude(["plugin", "uninstall", PLUGIN_SPEC], {
+    spinnerLabel: "Removing stale claude-smart cache…",
+  });
+  if (code !== 0) {
+    throw new Error(`could not remove stale ${PLUGIN_SPEC} cache (exit ${code})`);
+  }
+  code = await runClaude(["plugin", "install", PLUGIN_SPEC], {
+    spinnerLabel: "Refreshing claude-smart cache…",
+  });
+  if (code !== 0) {
+    throw new Error(`could not reinstall ${PLUGIN_SPEC} from the bundled package (exit ${code})`);
+  }
+
+  if (!existsSync(pluginRoot)) {
+    throw new Error(`Claude Code did not recreate the claude-smart plugin cache at ${pluginRoot}`);
+  }
+  const remainingMismatch = claudeCodeVendorPayloadMismatch(pluginRoot);
+  if (remainingMismatch) {
+    throw new Error(
+      `refreshed claude-smart cache still does not match the bundled npm package: ${remainingMismatch}`,
+    );
+  }
+  process.stdout.write("Refreshed stale claude-smart plugin cache from the bundled npm package.\n");
+  return pluginRoot;
+}
+
 function isWindows() {
   return currentPlatform() === "win32";
 }
@@ -2181,6 +2283,7 @@ async function runInstall(args, options = {}) {
   }
 
   try {
+    await refreshClaudeCodeCacheIfVendorMissing();
     const pluginRoot = await bootstrapClaudeCodeInstall();
     restorePublishHooksFromSource(pluginRoot);
     if (readOnly) {
@@ -2492,6 +2595,8 @@ if (require.main === module) {
 module.exports = {
   assertSupportedRuntimePlatform,
   bootstrapPluginRuntime,
+  claudeCodePackageVersion,
+  claudeCodeVendorPayloadMismatch,
   codexMarketplacePluginRoot,
   copyCodexMarketplace,
   ensurePrivateNode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.49",
+  "version": "0.2.50",
   "description": "Self-improving Claude Code, Codex, and OpenCode plugin that turns corrections into Preferences, Project-specific skills, and Shared skills",
   "keywords": [
     "claude",
@@ -40,7 +40,8 @@
   },
   "scripts": {
     "build:opencode": "tsc -p plugin/opencode/tsconfig.json",
-    "prepack": "npm run build:opencode"
+    "prepack": "npm run gen:marketplace && npm run build:opencode",
+    "gen:marketplace": "node scripts/generate-marketplace.js"
   },
   "bin": {
     "claude-smart": "bin/claude-smart.js"

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

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.49",
+  "version": "0.2.50",
   "description": "Self-improving Claude Code, Codex, and OpenCode 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.49",
+  "version": "0.2.50",
   "description": "Self-improving coding assistant plugin — learns from corrections across sessions via reflexio",
   "author": {
     "name": "Yi Lu"

package/plugin/README.md

@@ -9,13 +9,14 @@ This directory is the Claude Code/Codex/OpenCode plugin payload shipped through
 ### Claude Code
 
 ```bash
-claude plugin marketplace add ReflexioAI/claude-smart
-claude plugin install claude-smart@reflexioai
+npx claude-smart install
 ```
 
 The Setup hook bootstraps `uv`, Python 3.12, and a private Node.js/npm runtime
 under `~/.claude-smart/` when they are missing. If Node.js is already installed,
-`npx claude-smart install` is equivalent.
+the npm installer also supplies the generated Reflexio runtime bundle that is
+not committed to the GitHub repository. Installing this repository directly as
+a Claude Code marketplace is therefore unsupported.
 
 Add `--read-only` to either install command to skip hooks that publish
 interactions for learning.

package/plugin/dashboard/app/api/reflexio/[...path]/route.ts

@@ -4,7 +4,9 @@ import { readConfig } from "@/lib/config-file";
 
 export const dynamic = "force-dynamic";
 
-const DEFAULT_URL = "http://localhost:8071";
+function defaultUrl(): string {
+  return `http://localhost:${process.env.BACKEND_PORT || "8071"}`;
+}
 
 async function reflexioConfig(): Promise<{ base: string; apiKey: string }> {
   const config = await readConfig();
@@ -13,7 +15,7 @@ async function reflexioConfig(): Promise<{ base: string; apiKey: string }> {
   const fromConfig = originOnly(config.REFLEXIO_URL ?? "");
   const configuredBase = fromEnv ?? fromConfig;
   return {
-    base: configuredBase ?? DEFAULT_URL,
+    base: configuredBase ?? defaultUrl(),
     apiKey: configuredBase ? apiKey : "",
   };
 }

package/plugin/dashboard/app/dashboard/page.tsx

@@ -11,6 +11,7 @@ import {
   Users,
 } from "lucide-react";
 import { LearningsBadge } from "@/components/common/learnings-badge";
+import { HostBadge } from "@/components/common/host-badge";
 import { PageHeader } from "@/components/common/page-header";
 import { StatCard } from "@/components/common/stat-card";
 import { EmptyState } from "@/components/common/empty-state";
@@ -217,7 +218,11 @@ export default function DashboardPage() {
                       <code className="font-mono text-xs truncate">
                         {truncateId(s.session_id, 10, 6)}
                       </code>
-                      <LearningsBadge count={s.learning_interaction_count} />
+                      <LearningsBadge
+                        count={s.learning_interaction_count}
+                        size="sm"
+                      />
+                      <HostBadge host={s.host} size="sm" />
                     </div>
                     <div className="flex w-full items-center justify-end gap-4 text-xs text-muted-foreground sm:w-auto sm:shrink-0">
                       <span>{s.turn_count} turns</span>

package/plugin/dashboard/app/preferences/[id]/page.tsx

@@ -21,6 +21,7 @@ import {
   FolderGit2,
 } from "lucide-react";
 import { PageHeader } from "@/components/common/page-header";
+import { LearningHostProvenance } from "@/components/common/host-badge";
 import { EmptyState } from "@/components/common/empty-state";
 import { DeleteLearningDangerZone } from "@/components/common/delete-learning-danger-zone";
 import { Button } from "@/components/ui/button";
@@ -29,6 +30,7 @@ import { Badge } from "@/components/ui/badge";
 import { Separator } from "@/components/ui/separator";
 import { reflexio } from "@/lib/reflexio-client";
 import { formatTimestamp, truncateId } from "@/lib/format";
+import { useRequestHostAttribution } from "@/lib/host-attribution";
 import { cn } from "@/lib/utils";
 import { statusLabel as status } from "@/lib/status";
 import type { UserProfile } from "@/lib/types";
@@ -49,6 +51,7 @@ export default function PreferenceDetailPage({
   const [deleting, setDeleting] = useState(false);
   const [editing, setEditing] = useState(false);
   const [content, setContent] = useState("");
+  const attribution = useRequestHostAttribution();
 
   useEffect(() => {
     let cancelled = false;
@@ -205,11 +208,6 @@ export default function PreferenceDetailPage({
                   <FolderGit2 className="h-3 w-3" />
                   {truncateId(profile.user_id, 32, 8)}
                 </Badge>
-                {profile.source && (
-                  <Badge variant="secondary" className="font-mono text-[10px]">
-                    {profile.source}
-                  </Badge>
-                )}
                 {dirty && (
                   <Badge variant="destructive" className="gap-1.5">
                     unsaved changes
@@ -343,6 +341,20 @@ export default function PreferenceDetailPage({
                       display={truncateId(profile.generated_from_request_id, 8, 4)}
                     />
                   )}
+                  {attribution && profile.generated_from_request_id && (
+                    <Meta
+                      label="Origin"
+                      value={
+                        <LearningHostProvenance
+                          attribution={attribution}
+                          requestId={profile.generated_from_request_id}
+                        />
+                      }
+                    />
+                  )}
+                  {profile.source && (
+                    <Meta label="Integration" value={profile.source} mono />
+                  )}
                 </dl>
               </div>
             </aside>
@@ -428,7 +440,7 @@ function Meta({
 }: {
   icon?: React.ComponentType<{ className?: string }>;
   label: string;
-  value: string;
+  value: React.ReactNode;
   mono?: boolean;
 }) {
   return (

package/plugin/dashboard/app/preferences/page.tsx

@@ -2,8 +2,10 @@
 
 import { useEffect, useMemo, useState } from "react";
 import Link from "next/link";
-import { Users, ChevronRight } from "lucide-react";
+import { AlertTriangle, Users, ChevronRight } from "lucide-react";
 import { PageHeader } from "@/components/common/page-header";
+import { HostBadge } from "@/components/common/host-badge";
+import { LearningApplicationBadge } from "@/components/common/learning-application-badge";
 import { EmptyState } from "@/components/common/empty-state";
 import { DeleteAllButton } from "@/components/common/delete-all-button";
 import { Badge } from "@/components/ui/badge";
@@ -17,6 +19,7 @@ import {
 } from "@/components/ui/select";
 import { reflexio } from "@/lib/reflexio-client";
 import { formatRelative, truncateId } from "@/lib/format";
+import { useRequestHostAttribution } from "@/lib/host-attribution";
 import type { PlaybookApplicationStat, UserProfile } from "@/lib/types";
 
 type PreferenceSort = "newest" | "applied";
@@ -33,6 +36,7 @@ export default function PreferencesPage() {
   const [error, setError] = useState<string | null>(null);
   const [sortBy, setSortBy] = useState<PreferenceSort>("newest");
   const [filter, setFilter] = useState("");
+  const attribution = useRequestHostAttribution();
 
   useEffect(() => {
     let cancelled = false;
@@ -141,6 +145,13 @@ export default function PreferencesPage() {
             {error}. Is reflexio running on the configured backend URL?
           </div>
         )}
+        {attribution?.unavailable && !error && (
+          <div className="mb-4 flex items-center gap-2 rounded-md border border-amber-500/30 bg-amber-500/10 px-3 py-2 text-sm text-amber-800 dark:text-amber-200">
+            <AlertTriangle className="h-4 w-4 shrink-0" />
+            Preference source details are temporarily unavailable. Preferences
+            remain available.
+          </div>
+        )}
 
         {profiles === null && !error ? (
           <div className="text-sm text-muted-foreground">Loading…</div>
@@ -162,6 +173,7 @@ export default function PreferencesPage() {
                 >
                   <header className="mb-2 flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
                     <div className="flex min-w-0 flex-wrap items-center gap-2">
+                      <LearningApplicationBadge stat={stat} />
                       <Badge variant="outline" className="h-5 font-mono text-[10px]">
                         {truncateId(p.user_id, 32, 8)}
                       </Badge>
@@ -170,7 +182,6 @@ export default function PreferencesPage() {
                           {p.status}
                         </Badge>
                       )}
-                      <PreferenceApplicationStatBadge stat={stat} />
                     </div>
                     <div className="flex items-center gap-1.5 shrink-0">
                       <span className="text-[11px] text-muted-foreground">
@@ -182,11 +193,25 @@ export default function PreferencesPage() {
                   <p className="max-w-5xl text-sm leading-relaxed line-clamp-3">
                     {p.content}
                   </p>
-                  {p.source && (
-                    <p className="text-[11px] text-muted-foreground mt-2 font-mono">
-                      source: {p.source}
-                    </p>
-                  )}
+                  <div className="mt-2 flex flex-wrap items-center gap-3">
+                    {attribution &&
+                      !attribution.unavailable &&
+                      p.generated_from_request_id && (
+                        <HostBadge
+                          host={
+                            attribution.hosts.get(
+                              p.generated_from_request_id,
+                            ) ?? null
+                          }
+                          display="provenance"
+                        />
+                      )}
+                    {p.source && (
+                      <span className="text-[11px] text-muted-foreground font-mono">
+                        Integration: {p.source}
+                      </span>
+                    )}
+                  </div>
                 </Link>
               );
             })}
@@ -196,31 +221,3 @@ export default function PreferencesPage() {
     </div>
   );
 }
-
-function PreferenceApplicationStatBadge({
-  stat,
-}: {
-  stat: PlaybookApplicationStat | undefined;
-}) {
-  if (!stat || stat.applied_count === 0) {
-    return (
-      <Badge
-        variant="outline"
-        className="h-5 text-[10px] text-muted-foreground"
-        title="No citations recorded yet for this preference. It will count once an assistant reply cites it."
-      >
-        Never applied
-      </Badge>
-    );
-  }
-  const last = formatRelative(stat.last_applied_at);
-  return (
-    <Badge
-      variant="secondary"
-      className="h-5 text-[10px]"
-      title={`Last applied ${last}`}
-    >
-      Applied {stat.applied_count}×{stat.last_applied_at ? ` · ${last}` : ""}
-    </Badge>
-  );
-}

package/plugin/dashboard/app/sessions/[sessionId]/page.tsx

@@ -16,6 +16,8 @@ import {
   Sparkles,
 } from "lucide-react";
 import { PageHeader } from "@/components/common/page-header";
+import { HostBadge } from "@/components/common/host-badge";
+import { LearningsBadge } from "@/components/common/learnings-badge";
 import { EmptyState } from "@/components/common/empty-state";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
@@ -75,7 +77,20 @@ export default function InteractionDetailPage({
     <div className="flex-1 overflow-auto">
       <PageHeader
         title="Session transcript"
-        description={sessionId}
+        description={
+          <span className="flex flex-wrap items-center gap-2">
+            <span>{sessionId}</span>
+            {detail && (
+              <>
+                <LearningsBadge
+                  count={detail.learning_interaction_count}
+                  size="sm"
+                />
+                <HostBadge host={detail.host} size="sm" />
+              </>
+            )}
+          </span>
+        }
         actions={
           <div className="flex items-center gap-2">
             <Link href="/sessions">

package/plugin/dashboard/app/sessions/page.tsx

@@ -7,6 +7,7 @@ import { PageHeader } from "@/components/common/page-header";
 import { EmptyState } from "@/components/common/empty-state";
 import { DeleteAllButton } from "@/components/common/delete-all-button";
 import { LearningsBadge } from "@/components/common/learnings-badge";
+import { HostBadge } from "@/components/common/host-badge";
 import { Input } from "@/components/ui/input";
 import { dayBucket, formatRelative, truncateId } from "@/lib/format";
 import type { SessionSummary } from "@/lib/types";
@@ -153,6 +154,7 @@ export default function SessionsPage() {
                             count={s.learning_interaction_count}
                             size="sm"
                           />
+                          <HostBadge host={s.host} size="sm" />
                         </div>
                         <div className="flex items-center gap-3 text-[11px] text-muted-foreground mt-0.5">
                           <code className="font-mono">