claude-smart 0.1.14 → 0.1.16

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.1.14-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.1.16-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">
@@ -37,7 +37,7 @@
 </p>
 
 <p align="center">
-  It learns both corrections and successful execution patterns—so Claude Code avoids repeating mistakes and reuses what works. Claude Code steadily adapts to <i>how you like</i> to work—across projects, codebases, and sessions.
+  It learns both corrections and successful execution patterns—so Claude Code avoids repeating mistakes and reuses what works. Playbook rules travel with you across every project; per-project profiles capture how you like to work on each repo.
 </p>
 
 <p align="center">
@@ -69,7 +69,7 @@ Four ways this changes what Claude Code can do for you:
 
   Instead of re-exploring, Claude starts from the proven path—reducing planning steps, latency, and token usage.
 
-- 🌐 **Project-wide, not session-siloed:** Session memory disappears with the conversation. The project playbook persists and improves across every session in that repo.
+- 🌐 **Global playbook, project-scoped profiles:** Session memory disappears with the conversation. The playbook persists *globally* — rules learned in one repo are available in every repo you work in — while user profiles stay scoped to the current project so per-repo preferences don't leak across projects.
 
 - 🪶 **Better context without prompt bloat:** Distilled, deduplicated playbooks stay in dozens of tokens—not thousands—even as the project grows.
 
@@ -105,6 +105,7 @@ claude plugin uninstall claude-smart@reflexioai
 Local data under `~/.reflexio/` and `~/.claude-smart/` is left in place — remove manually if desired.
 
 Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-locally).
+> **Not supported:** Claude Code Cowork and claude.ai/code web — they run in a remote sandbox, so the local backend/dashboard and `~/.reflexio/` aren't reachable.
 
 ---
 
@@ -123,7 +124,7 @@ Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-local
 
 ## Dashboard
 
-A web UI for browsing session histories, inspecting user profiles, and editing project playbooks. The dashboard auto-starts alongside the backend, so you can open **http://localhost:3001** directly. Or run `/claude-smart:dashboard` in Claude Code to launch dashboard in browser.
+A web UI for browsing session histories, inspecting user profiles, and editing playbook rules. The dashboard auto-starts alongside the backend, so you can open **http://localhost:3001** directly. Or run `/claude-smart:dashboard` in Claude Code to launch dashboard in browser.
 
 <p align="center">
   <img src="assets/profile_dashboard.png" alt="Profile dashboard" width="49%">
@@ -136,8 +137,8 @@ A web UI for browsing session histories, inspecting user profiles, and editing p
 
 claude-smart builds two artifacts as you work and injects them into Claude at the start of every new session:
 
-- **User profile** — session-scoped preferences (stack, role, small quirks). *e.g.* "uses pnpm, not npm"; "prefers terse answers"; "backend engineer — explain frontend with backend analogues."
-- **Project playbook** — durable, generalized rules accumulated across every session in the repo. Each says when it applies and why. *e.g.* "always pass `--run` to `npm test` — watch mode hangs CI"; "use real Postgres for integration tests — mocks once hid a broken migration."
+- **User profile** (project-scoped) — preferences about how you work in this specific repo (stack, role, small quirks). *e.g.* "uses pnpm, not npm"; "prefers terse answers"; "backend engineer — explain frontend with backend analogues."
+- **Playbook** (global, cross-project) — durable, generalized rules accumulated across every session, shared across every project you use claude-smart in. Each rule says when it applies and why, so a rule learned in one repo only fires in the contexts where it's relevant. *e.g.* "always pass `--run` to `npm test` — watch mode hangs CI"; "use real Postgres for integration tests — mocks once hid a broken migration."
 
 Playbooks clean themselves up: correct the same thing twice and they merge; change your mind and the old one is archived.
 
@@ -146,8 +147,10 @@ Under the hood: hooks watch your turns, tool calls, and Claude's replies, auto-f
 **Citations (`cs-cite`).** At the end of a reply, Claude may run:
 
 ```
-⏺ Bash(cs-cite p1-2d57)
-  ⎿  ✨ 1 claude-smart learning applied
+⏺ Bash(cs-cite r1-252,p1-5aed)
+  ⎿  (No output)
+
+⏺ ✨ 2 claude-smart learnings applied
 ```
 
 That signals a profile entry (`p…`) or playbook rule (`r…`) materially shaped the reply. Open the interaction's detail page in the [dashboard](#dashboard) to see the exact cited item.
@@ -161,7 +164,7 @@ See [ARCHITECTURE.md](./ARCHITECTURE.md) for hooks, data flow, and reflexio deta
 | Command | What it does |
 | --- | --- |
 | `/dashboard` | Open the dashboard in your browser, auto-starting the reflexio backend and dashboard services if they aren't already running. |
-| `/show` | Print the current project playbook plus the current session's user profiles (same markdown that `SessionStart` injects). Use it to audit what playbooks and preferences Claude is being told to follow. |
+| `/show` | Print the current (global) playbook plus the current project's user profiles (same markdown that `SessionStart` injects). Use it to audit what playbooks and preferences Claude is being told to follow. |
 | `/learn` | Force reflexio to run extraction *now* on the current session's unpublished interactions. Without this, extraction runs at the end of the session or on reflexio's batch interval. |
 | `/tag [note]` | Tag the most recent turn as a correction, for cases the automatic heuristic missed. The note becomes the correction description the extractor sees. |
 | `/restart` | Restart the reflexio backend and dashboard to pick up new changes (e.g. after upgrading the plugin or editing local reflexio code). |

package/bin/claude-smart.js

@@ -9,7 +9,7 @@
  */
 "use strict";
 
-const { execFileSync, execSync } = require("child_process");
+const { execFileSync, execSync, spawn } = require("child_process");
 const { appendFileSync, existsSync, mkdirSync, readFileSync } = require("fs");
 const { homedir } = require("os");
 const { dirname, join } = require("path");
@@ -18,6 +18,45 @@ const DEFAULT_MARKETPLACE_SOURCE = "ReflexioAI/claude-smart";
 const PLUGIN_SPEC = "claude-smart@reflexioai";
 const REFLEXIO_ENV_PATH = join(homedir(), ".reflexio", ".env");
 
+function runClaude(args, { spinnerLabel } = {}) {
+  const useSpinner = Boolean(spinnerLabel) && process.stdout.isTTY && !process.env.CI;
+  return new Promise((resolve) => {
+    const child = spawn("claude", args, {
+      stdio: useSpinner ? ["inherit", "pipe", "pipe"] : "inherit",
+    });
+
+    let spinnerActive = false;
+    let timer = null;
+    if (useSpinner) {
+      const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+      let i = 0;
+      spinnerActive = true;
+      const render = () => {
+        process.stdout.write(`\r${frames[i = (i + 1) % frames.length]} ${spinnerLabel}`);
+      };
+      render();
+      timer = setInterval(render, 80);
+
+      const clear = () => {
+        if (!spinnerActive) return;
+        spinnerActive = false;
+        clearInterval(timer);
+        process.stdout.write("\r\x1b[2K");
+      };
+      const passthrough = (stream) => (chunk) => {
+        clear();
+        stream.write(chunk);
+      };
+      child.stdout.on("data", passthrough(process.stdout));
+      child.stderr.on("data", passthrough(process.stderr));
+      child.on("exit", clear);
+    }
+
+    child.on("exit", (code) => resolve(typeof code === "number" ? code : 1));
+    child.on("error", () => resolve(1));
+  });
+}
+
 function hasClaudeCli() {
   const probe = process.platform === "win32" ? "where claude" : "command -v claude";
   try {
@@ -79,7 +118,7 @@ function parseSource(args) {
   return value;
 }
 
-function runUpdate() {
+async function runUpdate() {
   if (!hasClaudeCli()) {
     process.stderr.write(
       "error: 'claude' CLI not found on PATH. " +
@@ -88,10 +127,10 @@ function runUpdate() {
     process.exit(1);
   }
 
-  try {
-    execFileSync("claude", ["plugin", "update", PLUGIN_SPEC], { stdio: "inherit" });
-  } catch (err) {
-    const code = typeof err.status === "number" ? err.status : 1;
+  const code = await runClaude(["plugin", "update", PLUGIN_SPEC], {
+    spinnerLabel: "Checking for claude-smart updates…",
+  });
+  if (code !== 0) {
     process.stderr.write(`error: \`claude plugin update ${PLUGIN_SPEC}\` failed (exit ${code})\n`);
     process.exit(code);
   }
@@ -99,7 +138,7 @@ function runUpdate() {
   process.stdout.write("\nclaude-smart updated. Restart Claude Code to apply.\n");
 }
 
-function runUninstall() {
+async function runUninstall() {
   if (!hasClaudeCli()) {
     process.stderr.write(
       "error: 'claude' CLI not found on PATH. " +
@@ -108,10 +147,10 @@ function runUninstall() {
     process.exit(1);
   }
 
-  try {
-    execFileSync("claude", ["plugin", "uninstall", PLUGIN_SPEC], { stdio: "inherit" });
-  } catch (err) {
-    const code = typeof err.status === "number" ? err.status : 1;
+  const code = await runClaude(["plugin", "uninstall", PLUGIN_SPEC], {
+    spinnerLabel: "Uninstalling claude-smart…",
+  });
+  if (code !== 0) {
     process.stderr.write(
       `error: \`claude plugin uninstall ${PLUGIN_SPEC}\` failed (exit ${code})\n`,
     );
@@ -128,7 +167,7 @@ function runUninstall() {
   );
 }
 
-function runInstall(args) {
+async function runInstall(args) {
   if (!hasClaudeCli()) {
     process.stderr.write(
       "error: 'claude' CLI not found on PATH. " +
@@ -139,17 +178,15 @@ function runInstall(args) {
 
   const source = parseSource(args);
   const steps = [
-    ["plugin", "marketplace", "add", source],
-    ["plugin", "install", PLUGIN_SPEC],
+    { args: ["plugin", "marketplace", "add", source], label: "Adding marketplace…" },
+    { args: ["plugin", "install", PLUGIN_SPEC], label: "Installing claude-smart…" },
   ];
 
-  for (const stepArgs of steps) {
-    try {
-      execFileSync("claude", stepArgs, { stdio: "inherit" });
-    } catch (err) {
-      const code = typeof err.status === "number" ? err.status : 1;
+  for (const step of steps) {
+    const code = await runClaude(step.args, { spinnerLabel: step.label });
+    if (code !== 0) {
       process.stderr.write(
-        `error: \`claude ${stepArgs.join(" ")}\` failed (exit ${code})\n`,
+        `error: \`claude ${step.args.join(" ")}\` failed (exit ${code})\n`,
       );
       process.exit(code);
     }
@@ -173,7 +210,7 @@ function runInstall(args) {
   );
 }
 
-function main() {
+async function main() {
   const args = process.argv.slice(2);
   const cmd = args[0] || "install";
 
@@ -183,17 +220,17 @@ function main() {
   }
 
   if (cmd === "install") {
-    runInstall(args.slice(1));
+    await runInstall(args.slice(1));
     return;
   }
 
   if (cmd === "update") {
-    runUpdate();
+    await runUpdate();
     return;
   }
 
   if (cmd === "uninstall") {
-    runUninstall();
+    await runUninstall();
     return;
   }
 
@@ -203,4 +240,7 @@ function main() {
   process.exit(1);
 }
 
-main();
+main().catch((err) => {
+  process.stderr.write(`claude-smart: ${err && err.message ? err.message : err}\n`);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Self-improving Claude Code plugin — learns from corrections via reflexio",
   "keywords": [
     "claude",
@@ -31,6 +31,6 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.9.0"
   }
 }