uilint 0.2.6 → 0.2.8

package/dist/index.js

@@ -237,8 +237,8 @@ async function initializeLangfuseIfEnabled() {
               },
               { asType: "generation" }
             );
-            await new Promise((resolve8) => {
-              resolveTrace = resolve8;
+            await new Promise((resolve7) => {
+              resolveTrace = resolve7;
             });
             if (endData && generationRef) {
               const usageDetails = endData.usage ? Object.fromEntries(
@@ -1249,14 +1249,14 @@ import {
 } from "uilint-core";
 import { ensureOllamaReady as ensureOllamaReady3 } from "uilint-core/node";
 async function readStdin2() {
-  return new Promise((resolve8) => {
+  return new Promise((resolve7) => {
     let data = "";
     const rl = createInterface({ input: process.stdin });
     rl.on("line", (line) => {
       data += line;
     });
     rl.on("close", () => {
-      resolve8(data);
+      resolve7(data);
     });
   });
 }
@@ -1837,7 +1837,7 @@ function detectPackageManager(projectPath) {
   return "npm";
 }
 function spawnAsync(command, args, cwd) {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve7, reject) => {
     const child = spawn(command, args, {
       cwd,
       stdio: "inherit",
@@ -1845,7 +1845,7 @@ function spawnAsync(command, args, cwd) {
     });
     child.on("error", reject);
     child.on("close", (code) => {
-      if (code === 0) resolve8();
+      if (code === 0) resolve7();
       else
         reject(new Error(`${command} ${args.join(" ")} exited with ${code}`));
     });
@@ -2427,39 +2427,15 @@ async function installEslintPlugin(opts) {
 }
 
 // src/commands/install/analyze.ts
-var LEGACY_HOOK_FILES = ["uilint-validate.sh", "uilint-validate.js"];
-function safeParseJson(filePath) {
-  try {
-    const content = readFileSync5(filePath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return void 0;
-  }
-}
 async function analyze2(projectPath = process.cwd()) {
   const workspaceRoot = findWorkspaceRoot5(projectPath);
   const packageManager = detectPackageManager(projectPath);
   const cursorDir = join8(projectPath, ".cursor");
   const cursorDirExists = existsSync9(cursorDir);
-  const mcpPath = join8(cursorDir, "mcp.json");
-  const mcpExists = existsSync9(mcpPath);
-  const mcpConfig = mcpExists ? safeParseJson(mcpPath) : void 0;
-  const hooksPath = join8(cursorDir, "hooks.json");
-  const hooksExists = existsSync9(hooksPath);
-  const hooksConfig = hooksExists ? safeParseJson(hooksPath) : void 0;
-  const hooksDir = join8(cursorDir, "hooks");
-  const legacyPaths = [];
-  for (const legacyFile of LEGACY_HOOK_FILES) {
-    const legacyPath = join8(hooksDir, legacyFile);
-    if (existsSync9(legacyPath)) {
-      legacyPaths.push(legacyPath);
-    }
-  }
   const styleguidePath = join8(projectPath, ".uilint", "styleguide.md");
   const styleguideExists = existsSync9(styleguidePath);
   const commandsDir = join8(cursorDir, "commands");
   const genstyleguideExists = existsSync9(join8(commandsDir, "genstyleguide.md"));
-  const genrulesExists = existsSync9(join8(commandsDir, "genrules.md"));
   const nextApps = [];
   const directDetection = detectNextAppRouter(projectPath);
   if (directDetection) {
@@ -2518,25 +2494,12 @@ async function analyze2(projectPath = process.cwd()) {
       exists: cursorDirExists,
       path: cursorDir
     },
-    mcp: {
-      exists: mcpExists,
-      path: mcpPath,
-      config: mcpConfig
-    },
-    hooks: {
-      exists: hooksExists,
-      path: hooksPath,
-      config: hooksConfig,
-      hasLegacy: legacyPaths.length > 0,
-      legacyPaths
-    },
     styleguide: {
       exists: styleguideExists,
       path: styleguidePath
     },
     commands: {
-      genstyleguide: genstyleguideExists,
-      genrules: genrulesExists
+      genstyleguide: genstyleguideExists
     },
     nextApps,
     viteApps,
@@ -2549,171 +2512,6 @@ import { join as join11 } from "path";
 import { createRequire as createRequire2 } from "module";
 
 // src/commands/install/constants.ts
-var HOOKS_CONFIG = {
-  version: 1,
-  hooks: {
-    beforeSubmitPrompt: [{ command: ".cursor/hooks/uilint-session-start.sh" }],
-    afterFileEdit: [{ command: ".cursor/hooks/uilint-track.sh" }],
-    stop: [{ command: ".cursor/hooks/uilint-session-end.sh" }]
-  }
-};
-var MCP_CONFIG = {
-  mcpServers: {
-    uilint: {
-      command: "npx",
-      args: ["uilint-mcp"]
-    }
-  }
-};
-var LEGACY_HOOK_COMMANDS = [
-  ".cursor/hooks/uilint-validate.sh",
-  ".cursor/hooks/uilint-validate.js"
-];
-var SESSION_START_SCRIPT = `#!/bin/bash
-# UILint session start hook
-# Clears tracked files at the start of each agent turn
-#
-# IMPORTANT: Cursor hooks communicate over stdio using JSON.
-# - stdout must be JSON (Cursor will parse it)
-# - stderr is for logs
-
-echo "[UILint] Session start - clearing tracked files" >&2
-
-# Prefer local monorepo build when developing UILint itself.
-# Fall back to npx for normal consumers.
-uilint() {
-  if [ -f "packages/uilint/dist/index.js" ]; then
-    node "packages/uilint/dist/index.js" "$@"
-  else
-    npx uilint "$@"
-  fi
-}
-
-# Read JSON input from stdin (required by hook protocol)
-cat > /dev/null
-
-# Clear session state
-result=$(uilint session clear)
-status=$?
-
-echo "[UILint] Clear exit: $status" >&2
-
-if [ $status -eq 0 ] && [ -n "$result" ]; then
-  echo "$result"
-else
-  echo '{"cleared":false}'
-fi
-
-exit 0
-`;
-var TRACK_SCRIPT = `#!/bin/bash
-# UILint file tracking hook
-# Tracks UI file edits for batch validation on agent stop
-#
-# IMPORTANT: Cursor hooks communicate over stdio using JSON.
-# - stdout must be JSON (Cursor will parse it)
-# - stderr is for logs
-
-out='{}'
-
-# Read JSON input from stdin
-input=$(cat)
-
-echo "[UILint] afterFileEdit hook triggered" >&2
-
-# Prefer local monorepo build when developing UILint itself.
-# Fall back to npx for normal consumers.
-uilint() {
-  if [ -f "packages/uilint/dist/index.js" ]; then
-    node "packages/uilint/dist/index.js" "$@"
-  else
-    npx uilint "$@"
-  fi
-}
-
-# Extract file_path using grep/sed (works without jq)
-file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/"file_path"[[:space:]]*:[[:space:]]*"\\([^"]*\\)"/\\1/')
-
-echo "[UILint] Extracted file_path: $file_path" >&2
-
-if [ -z "$file_path" ]; then
-  echo "[UILint] No file_path found in input, skipping" >&2
-  printf '%s\\n' "$out"
-  exit 0
-fi
-
-# Track the file (session command filters for UI files internally)
-echo "[UILint] Tracking file: $file_path" >&2
-result=$(uilint session track "$file_path")
-status=$?
-
-echo "[UILint] Track exit: $status" >&2
-
-if [ $status -eq 0 ] && [ -n "$result" ]; then
-  out="$result"
-fi
-
-printf '%s\\n' "$out"
-exit 0
-`;
-var SESSION_END_SCRIPT = `#!/bin/bash
-# UILint session end hook
-# Scans tracked markup files and returns followup_message for auto-fix
-#
-# IMPORTANT: Cursor hooks communicate over stdio using JSON.
-# - stdout must be JSON (Cursor will parse it)
-# - stderr is for logs
-
-echo "[UILint] Session end hook triggered" >&2
-
-# Read JSON input from stdin (contains status, loop_count)
-input=$(cat)
-
-echo "[UILint] Stop input: $input" >&2
-
-# Prefer local monorepo build when developing UILint itself.
-# Fall back to npx for normal consumers.
-uilint() {
-  if [ -f "packages/uilint/dist/index.js" ]; then
-    node "packages/uilint/dist/index.js" "$@"
-  else
-    npx uilint "$@"
-  fi
-}
-
-# Extract loop_count to prevent infinite loops
-loop_count=$(echo "$input" | grep -o '"loop_count"[[:space:]]*:[[:space:]]*[0-9]*' | grep -o '[0-9]*$')
-loop_count=\${loop_count:-0}
-
-echo "[UILint] Loop count: $loop_count" >&2
-
-# Don't trigger followup if we've already looped 3+ times
-if [ "$loop_count" -ge 3 ]; then
-  echo "[UILint] Max loops reached, skipping scan" >&2
-  echo '{}' 
-  exit 0
-fi
-
-# First check what files are tracked
-echo "[UILint] Checking tracked files..." >&2
-tracked=$(uilint session list)
-echo "[UILint] Tracked files: $tracked" >&2
-
-# Run scan with --hook flag for direct JSON output
-echo "[UILint] Running scan..." >&2
-result=$(uilint session scan --hook)
-status=$?
-
-echo "[UILint] Scan exit: $status" >&2
-
-if [ $status -eq 0 ] && [ -n "$result" ]; then
-  echo "$result"
-else
-  echo '{}'
-fi
-
-exit 0
-`;
 var GENSTYLEGUIDE_COMMAND_MD = `# React Style Guide Generator
 
 Analyze the React UI codebase to produce a **prescriptive, semantic** style guide. Focus on consistency, intent, and relationships\u2014not specific values.
@@ -2832,107 +2630,6 @@ conventions:
 - **Omit if N/A**: Skip sections that don't apply
 - **Max 5 items** per section \u2014 highest impact only
 `;
-var GENRULES_COMMAND_MD = `# ESLint Rule Generator
-
-Generate custom ESLint rules from your UILint styleguide (\`.uilint/styleguide.md\`).
-
-## Purpose
-
-Transform your semantic styleguide rules into concrete, enforceable ESLint rules that:
-- Run automatically during development
-- Integrate with your editor
-- Catch issues before commit
-- Provide actionable error messages
-
-## Analysis Steps
-
-### 1. Read the Styleguide
-
-Look at \`.uilint/styleguide.md\` for:
-- **Component Usage** (\`use:\` section) - which components should be used
-- **Forbidden** patterns - what to disallow
-- **Semantic Rules** - spacing, consistency, hierarchy
-- **Patterns** - form handling, conditionals, state management
-
-### 2. Identify Rule Candidates
-
-Focus on rules that can be statically analyzed:
-- Import patterns (e.g., "use Button from shadcn, not raw HTML button")
-- Forbidden patterns (e.g., "no inline style={{}}")
-- Component library mixing (e.g., "don't mix MUI and shadcn")
-- Tailwind patterns (e.g., "no arbitrary values")
-
-### 3. Generate Rule Files
-
-Create TypeScript ESLint rules in \`.uilint/rules/\`:
-
-\`\`\`typescript
-// .uilint/rules/prefer-shadcn-button.ts
-import { createRule } from 'uilint-eslint';
-
-export default createRule({
-  name: 'prefer-shadcn-button',
-  meta: {
-    type: 'problem',
-    docs: { description: 'Use Button from shadcn instead of raw <button>' },
-    messages: {
-      preferButton: 'Use <Button> from @/components/ui/button instead of raw <button>',
-    },
-    schema: [],
-  },
-  defaultOptions: [],
-  create(context) {
-    return {
-      JSXOpeningElement(node) {
-        if (node.name.type === 'JSXIdentifier' && node.name.name === 'button') {
-          context.report({ node, messageId: 'preferButton' });
-        }
-      },
-    };
-  },
-});
-\`\`\`
-
-### 4. Generate ESLint Config
-
-Create or update \`eslint.config.js\` to include the generated rules:
-
-\`\`\`javascript
-import uilint from 'uilint-eslint';
-import preferShadcnButton from './.uilint/rules/prefer-shadcn-button.js';
-
-export default [
-  uilint.configs.recommended,
-  {
-    plugins: {
-      'uilint-custom': {
-        rules: {
-          'prefer-shadcn-button': preferShadcnButton,
-        },
-      },
-    },
-    rules: {
-      'uilint-custom/prefer-shadcn-button': 'error',
-    },
-  },
-];
-\`\`\`
-
-## Output
-
-Generate in \`.uilint/rules/\`:
-- One TypeScript file per rule
-- An \`index.ts\` that exports all rules
-- Update instructions for \`eslint.config.js\`
-
-## Guidelines
-
-- **Focus on static analysis** - rules must work without runtime info
-- **Clear error messages** - tell devs exactly what to do
-- **No false positives** - better to miss issues than over-report
-- **Performance** - rules run on every file, keep them fast
-- **Minimal rules** - generate 3-5 high-impact rules, not dozens
-`;
 
 // src/utils/skill-loader.ts
 import { readFileSync as readFileSync6, readdirSync as readdirSync4, statSync as statSync2, existsSync as existsSync10 } from "fs";
@@ -3148,106 +2845,18 @@ function toInstallSpecifier(pkgName) {
   if (range.startsWith("link:")) return pkgName;
   return `${pkgName}@${range}`;
 }
-function mergeHooksConfig(existing, ours) {
-  const result = { ...existing };
-  for (const [hookName, hookArray] of Object.entries(result.hooks)) {
-    if (!Array.isArray(hookArray)) continue;
-    result.hooks[hookName] = hookArray.filter(
-      (h) => !LEGACY_HOOK_COMMANDS.includes(h.command)
-    );
-  }
-  for (const [hookName, ourHooks] of Object.entries(ours.hooks)) {
-    if (!Array.isArray(ourHooks)) continue;
-    const existingHooks = result.hooks[hookName] || [];
-    for (const ourHook of ourHooks) {
-      const alreadyExists = existingHooks.some(
-        (h) => h.command === ourHook.command
-      );
-      if (!alreadyExists) {
-        existingHooks.push(ourHook);
-      }
-    }
-    result.hooks[hookName] = existingHooks;
-  }
-  return result;
-}
 function createPlan(state, choices, options = {}) {
   const actions = [];
   const dependencies = [];
   const { force = false } = options;
   const { items } = choices;
-  const needsCursorDir = items.includes("mcp") || items.includes("hooks") || items.includes("genstyleguide") || items.includes("genrules") || items.includes("skill");
+  const needsCursorDir = items.includes("genstyleguide") || items.includes("skill");
   if (needsCursorDir && !state.cursorDir.exists) {
     actions.push({
       type: "create_directory",
       path: state.cursorDir.path
     });
   }
-  if (items.includes("mcp")) {
-    if (!state.mcp.exists || force) {
-      actions.push({
-        type: "create_file",
-        path: state.mcp.path,
-        content: JSON.stringify(MCP_CONFIG, null, 2)
-      });
-    } else if (choices.mcpMerge) {
-      const merged = {
-        mcpServers: {
-          ...state.mcp.config?.mcpServers || {},
-          ...MCP_CONFIG.mcpServers
-        }
-      };
-      actions.push({
-        type: "create_file",
-        path: state.mcp.path,
-        content: JSON.stringify(merged, null, 2)
-      });
-    }
-  }
-  if (items.includes("hooks")) {
-    const hooksDir = join11(state.cursorDir.path, "hooks");
-    actions.push({
-      type: "create_directory",
-      path: hooksDir
-    });
-    for (const legacyPath of state.hooks.legacyPaths) {
-      actions.push({
-        type: "delete_file",
-        path: legacyPath
-      });
-    }
-    let finalHooksConfig;
-    if (!state.hooks.exists || force) {
-      finalHooksConfig = HOOKS_CONFIG;
-    } else if (choices.hooksMerge && state.hooks.config) {
-      finalHooksConfig = mergeHooksConfig(state.hooks.config, HOOKS_CONFIG);
-    } else {
-      finalHooksConfig = HOOKS_CONFIG;
-    }
-    actions.push({
-      type: "create_file",
-      path: state.hooks.path,
-      content: JSON.stringify(finalHooksConfig, null, 2)
-    });
-    actions.push({
-      type: "create_file",
-      path: join11(hooksDir, "uilint-session-start.sh"),
-      content: SESSION_START_SCRIPT,
-      permissions: 493
-    });
-    actions.push({
-      type: "create_file",
-      path: join11(hooksDir, "uilint-track.sh"),
-      content: TRACK_SCRIPT,
-      permissions: 493
-    });
-    actions.push({
-      type: "create_file",
-      path: join11(hooksDir, "uilint-session-end.sh"),
-      content: SESSION_END_SCRIPT,
-      permissions: 493
-    });
-  }
   if (items.includes("genstyleguide")) {
     const commandsDir = join11(state.cursorDir.path, "commands");
     actions.push({
@@ -3260,18 +2869,6 @@ function createPlan(state, choices, options = {}) {
       content: GENSTYLEGUIDE_COMMAND_MD
     });
   }
-  if (items.includes("genrules")) {
-    const commandsDir = join11(state.cursorDir.path, "commands");
-    actions.push({
-      type: "create_directory",
-      path: commandsDir
-    });
-    actions.push({
-      type: "create_file",
-      path: join11(commandsDir, "genrules.md"),
-      content: GENRULES_COMMAND_MD
-    });
-  }
   if (items.includes("skill")) {
     const skillsDir = join11(state.cursorDir.path, "skills");
     actions.push({
@@ -3472,80 +3069,52 @@ function walkAst(node, visit) {
     }
   }
 }
-function ensureNamedImport(program2, from, name) {
-  if (!program2 || program2.type !== "Program") return { changed: false };
-  const existing = findImportDeclaration(program2, from);
-  if (existing) {
-    const has = (existing.specifiers ?? []).some(
-      (s) => s?.type === "ImportSpecifier" && (s.imported?.name === name || s.imported?.value === name)
-    );
-    if (has) return { changed: false };
-    const spec = parseModule2(`import { ${name} } from "${from}";`).$ast.body?.[0]?.specifiers?.[0];
-    if (!spec) return { changed: false };
-    existing.specifiers = [...existing.specifiers ?? [], spec];
-    return { changed: true };
-  }
-  const importDecl = parseModule2(`import { ${name} } from "${from}";`).$ast.body?.[0];
-  if (!importDecl) return { changed: false };
-  const body = program2.body ?? [];
-  let insertAt = 0;
-  while (insertAt < body.length && isUseClientDirective(body[insertAt])) {
-    insertAt++;
-  }
-  while (insertAt < body.length && body[insertAt]?.type === "ImportDeclaration") {
-    insertAt++;
-  }
-  program2.body.splice(insertAt, 0, importDecl);
-  return { changed: true };
-}
-function hasUILintProviderJsx(program2) {
+function hasUILintDevtoolsJsx(program2) {
   let found = false;
   walkAst(program2, (node) => {
     if (found) return;
     if (node.type !== "JSXElement") return;
     const name = node.openingElement?.name;
-    if (name?.type === "JSXIdentifier" && name.name === "UILintProvider") {
-      found = true;
+    if (name?.type === "JSXIdentifier") {
+      if (name.name === "UILintProvider" || name.name === "uilint-devtools") {
+        found = true;
+      }
     }
   });
   return found;
 }
-function wrapFirstChildrenExpressionWithProvider(program2) {
+function addDevtoolsElementNextJs(program2) {
   if (!program2 || program2.type !== "Program") return { changed: false };
-  if (hasUILintProviderJsx(program2)) return { changed: false };
-  const providerMod = parseModule2(
-    'const __uilint_provider = (<UILintProvider enabled={process.env.NODE_ENV !== "production"}>{children}</UILintProvider>);'
+  if (hasUILintDevtoolsJsx(program2)) return { changed: false };
+  const devtoolsMod = parseModule2(
+    "const __uilint_devtools = (<uilint-devtools />);"
   );
-  const providerJsx = providerMod.$ast.body?.[0]?.declarations?.[0]?.init ?? null;
-  if (!providerJsx || providerJsx.type !== "JSXElement")
+  const devtoolsJsx = devtoolsMod.$ast.body?.[0]?.declarations?.[0]?.init ?? null;
+  if (!devtoolsJsx || devtoolsJsx.type !== "JSXElement")
     return { changed: false };
-  let replaced = false;
+  let added = false;
   walkAst(program2, (node) => {
-    if (replaced) return;
-    if (node.type === "JSXExpressionContainer" && node.expression?.type === "Identifier" && node.expression.name === "children") {
-      Object.keys(node).forEach((k) => delete node[k]);
-      Object.assign(node, providerJsx);
-      replaced = true;
-    }
+    if (added) return;
+    if (node.type !== "JSXElement" && node.type !== "JSXFragment") return;
+    const children = node.children ?? [];
+    const childrenIndex = children.findIndex(
+      (child) => child?.type === "JSXExpressionContainer" && child.expression?.type === "Identifier" && child.expression.name === "children"
+    );
+    if (childrenIndex === -1) return;
+    children.splice(childrenIndex + 1, 0, devtoolsJsx);
+    added = true;
   });
-  if (!replaced) {
-    throw new Error("Could not find `{children}` in target file to wrap.");
+  if (!added) {
+    throw new Error("Could not find `{children}` in target file to add devtools.");
   }
   return { changed: true };
 }
-function wrapFirstRenderCallArgumentWithProvider(program2) {
+function addDevtoolsElementVite(program2) {
   if (!program2 || program2.type !== "Program") return { changed: false };
-  if (hasUILintProviderJsx(program2)) return { changed: false };
-  const providerMod = parseModule2(
-    'const __uilint_provider = (<UILintProvider enabled={process.env.NODE_ENV !== "production"}></UILintProvider>);'
-  );
-  const providerJsx = providerMod.$ast.body?.[0]?.declarations?.[0]?.init ?? null;
-  if (!providerJsx || providerJsx.type !== "JSXElement")
-    return { changed: false };
-  providerJsx.children = providerJsx.children ?? [];
-  let wrapped = false;
+  if (hasUILintDevtoolsJsx(program2)) return { changed: false };
+  let added = false;
   walkAst(program2, (node) => {
-    if (wrapped) return;
+    if (added) return;
     if (node.type !== "CallExpression") return;
     const callee = node.callee;
     if (callee?.type !== "MemberExpression") return;
@@ -3555,17 +3124,44 @@ function wrapFirstRenderCallArgumentWithProvider(program2) {
     const arg0 = node.arguments?.[0];
     if (!arg0) return;
     if (arg0.type !== "JSXElement" && arg0.type !== "JSXFragment") return;
-    providerJsx.children = [arg0];
-    node.arguments[0] = providerJsx;
-    wrapped = true;
+    const devtoolsMod = parseModule2(
+      "const __uilint_devtools = (<uilint-devtools />);"
+    );
+    const devtoolsJsx = devtoolsMod.$ast.body?.[0]?.declarations?.[0]?.init ?? null;
+    if (!devtoolsJsx) return;
+    const fragmentMod = parseModule2(
+      "const __fragment = (<></>);"
+    );
+    const fragmentJsx = fragmentMod.$ast.body?.[0]?.declarations?.[0]?.init ?? null;
+    if (!fragmentJsx) return;
+    fragmentJsx.children = [arg0, devtoolsJsx];
+    node.arguments[0] = fragmentJsx;
+    added = true;
   });
-  if (!wrapped) {
+  if (!added) {
     throw new Error(
-      "Could not find a `.render(<...>)` call to wrap. Expected a React entry like `createRoot(...).render(<App />)`."
+      "Could not find a `.render(<...>)` call to add devtools. Expected a React entry like `createRoot(...).render(<App />)`."
     );
   }
   return { changed: true };
 }
+function ensureSideEffectImport(program2, from) {
+  if (!program2 || program2.type !== "Program") return { changed: false };
+  const existing = findImportDeclaration(program2, from);
+  if (existing) return { changed: false };
+  const importDecl = parseModule2(`import "${from}";`).$ast.body?.[0];
+  if (!importDecl) return { changed: false };
+  const body = program2.body ?? [];
+  let insertAt = 0;
+  while (insertAt < body.length && isUseClientDirective(body[insertAt])) {
+    insertAt++;
+  }
+  while (insertAt < body.length && body[insertAt]?.type === "ImportDeclaration") {
+    insertAt++;
+  }
+  program2.body.splice(insertAt, 0, importDecl);
+  return { changed: true };
+}
 async function installReactUILintOverlay(opts) {
   const candidates = getDefaultCandidates(opts.projectPath, opts.appRoot);
   if (!candidates.length) {
@@ -3590,17 +3186,15 @@ async function installReactUILintOverlay(opts) {
     );
   }
   const program2 = mod.$ast;
-  const alreadyConfigured = !!findImportDeclaration(program2, "uilint-react") && hasUILintProviderJsx(program2);
+  const hasDevtoolsImport = !!findImportDeclaration(program2, "uilint-react/devtools");
+  const hasOldImport = !!findImportDeclaration(program2, "uilint-react");
+  const alreadyConfigured = (hasDevtoolsImport || hasOldImport) && hasUILintDevtoolsJsx(program2);
   let changed = false;
-  const importRes = ensureNamedImport(
-    program2,
-    "uilint-react",
-    "UILintProvider"
-  );
+  const importRes = ensureSideEffectImport(program2, "uilint-react/devtools");
   if (importRes.changed) changed = true;
   const mode = opts.mode ?? "next";
-  const wrapRes = mode === "vite" ? wrapFirstRenderCallArgumentWithProvider(program2) : wrapFirstChildrenExpressionWithProvider(program2);
-  if (wrapRes.changed) changed = true;
+  const addRes = mode === "vite" ? addDevtoolsElementVite(program2) : addDevtoolsElementNextJs(program2);
+  if (addRes.changed) changed = true;
   const updated = changed ? generateCode2(mod).code : original;
   const modified = updated !== original;
   if (modified) {
@@ -4605,7 +4199,7 @@ async function executeInjectReact(action, options) {
     return {
       action,
       success: true,
-      wouldDo: `Inject UILintProvider into React app: ${action.projectPath}`
+      wouldDo: `Inject <uilint-devtools /> into React app: ${action.projectPath}`
     };
   }
   const result = await installReactUILintOverlay({
@@ -4796,10 +4390,7 @@ async function execute(plan, options = {}) {
     if (!result.success) continue;
     const { action } = result;
     if (action.type === "create_file") {
-      if (action.path.includes("mcp.json")) items.push("mcp");
-      if (action.path.includes("hooks.json")) items.push("hooks");
       if (action.path.includes("genstyleguide.md")) items.push("genstyleguide");
-      if (action.path.includes("genrules.md")) items.push("genrules");
       if (action.path.includes("/skills/") && action.path.includes("SKILL.md")) items.push("skill");
     }
     if (action.type === "inject_eslint") items.push("eslint");
@@ -4838,33 +4429,18 @@ var cliPrompter = {
         {
           value: "next",
           label: "UI overlay",
-          hint: "Installs routes + UILintProvider (Alt+Click to inspect)"
+          hint: "Installs routes + devtools (Alt+Click to inspect)"
         },
         {
           value: "vite",
           label: "UI overlay (Vite)",
-          hint: "Installs jsx-loc-plugin + UILintProvider (Alt+Click to inspect)"
+          hint: "Installs jsx-loc-plugin + devtools (Alt+Click to inspect)"
         },
         {
           value: "genstyleguide",
           label: "/genstyleguide command",
           hint: "Adds .cursor/commands/genstyleguide.md"
         },
-        {
-          value: "mcp",
-          label: "MCP Server",
-          hint: "Recommended - works with any MCP-compatible agent"
-        },
-        {
-          value: "hooks",
-          label: "Cursor Hooks",
-          hint: "Auto-validates UI files when the agent stops"
-        },
-        {
-          value: "genrules",
-          label: "/genrules command",
-          hint: "Adds .cursor/commands/genrules.md for ESLint rule generation"
-        },
         {
           value: "skill",
           label: "UI Consistency Agent Skill",
@@ -4875,22 +4451,6 @@ var cliPrompter = {
       initialValues: ["eslint", "next", "genstyleguide", "skill"]
     });
   },
-  async confirmMcpMerge() {
-    return confirm2({
-      message: `${pc.dim(
-        ".cursor/mcp.json"
-      )} already exists. Merge UILint config?`,
-      initialValue: true
-    });
-  },
-  async confirmHooksMerge() {
-    return confirm2({
-      message: `${pc.dim(
-        ".cursor/hooks.json"
-      )} already exists. Merge UILint hooks?`,
-      initialValue: true
-    });
-  },
   async selectNextApp(apps) {
     const chosen = await select2({
       message: "Which Next.js App Router project should UILint install into?",
@@ -5069,33 +4629,16 @@ async function promptForField(field, ruleName) {
 }
 async function gatherChoices(state, options, prompter) {
   let items;
-  const hasExplicitFlags = options.mcp !== void 0 || options.hooks !== void 0 || options.genstyleguide !== void 0 || options.genrules !== void 0 || options.skill !== void 0 || options.routes !== void 0 || options.react !== void 0;
+  const hasExplicitFlags = options.genstyleguide !== void 0 || options.skill !== void 0 || options.routes !== void 0 || options.react !== void 0;
   if (hasExplicitFlags || options.eslint) {
     items = [];
-    if (options.mcp) items.push("mcp");
-    if (options.hooks) items.push("hooks");
     if (options.genstyleguide) items.push("genstyleguide");
-    if (options.genrules) items.push("genrules");
     if (options.skill) items.push("skill");
     if (options.routes || options.react) items.push("next");
     if (options.eslint) items.push("eslint");
-  } else if (options.mode) {
-    items = [];
-    if (options.mode === "mcp" || options.mode === "both") items.push("mcp");
-    if (options.mode === "hooks" || options.mode === "both")
-      items.push("hooks");
-    items.push("genstyleguide");
   } else {
     items = await prompter.selectInstallItems();
   }
-  let mcpMerge = true;
-  if (items.includes("mcp") && state.mcp.exists && !options.force) {
-    mcpMerge = await prompter.confirmMcpMerge();
-  }
-  let hooksMerge = true;
-  if (items.includes("hooks") && state.hooks.exists && !options.force) {
-    hooksMerge = await prompter.confirmHooksMerge();
-  }
   let nextChoices;
   if (items.includes("next")) {
     if (state.nextApps.length === 0) {
@@ -5170,8 +4713,6 @@ async function gatherChoices(state, options, prompter) {
   }
   return {
     items,
-    mcpMerge,
-    hooksMerge,
     next: nextChoices,
     vite: viteChoices,
     eslint: eslintChoices
@@ -5202,23 +4743,11 @@ async function configureRuleOptions(rules, prompter) {
 function displayResults(result) {
   const { summary } = result;
   const installedItems = [];
-  if (summary.installedItems.includes("mcp")) {
-    installedItems.push(`${pc.cyan("MCP Server")} \u2192 .cursor/mcp.json`);
-  }
-  if (summary.installedItems.includes("hooks")) {
-    installedItems.push(`${pc.cyan("Hooks")} \u2192 .cursor/hooks.json`);
-    installedItems.push(`  ${pc.dim("\u251C")} uilint-session-start.sh`);
-    installedItems.push(`  ${pc.dim("\u251C")} uilint-track.sh`);
-    installedItems.push(`  ${pc.dim("\u2514")} uilint-session-end.sh`);
-  }
   if (summary.installedItems.includes("genstyleguide")) {
     installedItems.push(
       `${pc.cyan("Command")} \u2192 .cursor/commands/genstyleguide.md`
     );
   }
-  if (summary.installedItems.includes("genrules")) {
-    installedItems.push(`${pc.cyan("Command")} \u2192 .cursor/commands/genrules.md`);
-  }
   if (summary.nextApp) {
     installedItems.push(
       `${pc.cyan("Next Routes")} \u2192 ${pc.dim(
@@ -5226,7 +4755,7 @@ function displayResults(result) {
       )}`
     );
     installedItems.push(
-      `${pc.cyan("Next Overlay")} \u2192 ${pc.dim("<UILintProvider> injected")}`
+      `${pc.cyan("Next Devtools")} \u2192 ${pc.dim("<uilint-devtools /> injected")}`
     );
     installedItems.push(
       `${pc.cyan("JSX Loc Plugin")} \u2192 ${pc.dim(
@@ -5236,7 +4765,7 @@ function displayResults(result) {
   }
   if (summary.viteApp) {
     installedItems.push(
-      `${pc.cyan("Vite Overlay")} \u2192 ${pc.dim("<UILintProvider> injected")}`
+      `${pc.cyan("Vite Devtools")} \u2192 ${pc.dim("<uilint-devtools /> injected")}`
     );
     installedItems.push(
       `${pc.cyan("JSX Loc Plugin")} \u2192 ${pc.dim(
@@ -5274,15 +4803,9 @@ function displayResults(result) {
   if (!hasStyleguide) {
     steps.push(`Create a styleguide: ${pc.cyan("/genstyleguide")}`);
   }
-  if (summary.installedItems.includes("mcp") || summary.installedItems.includes("hooks") || summary.installedItems.includes("genstyleguide")) {
+  if (summary.installedItems.includes("genstyleguide")) {
     steps.push("Restart Cursor to load the new configuration");
   }
-  if (summary.installedItems.includes("mcp")) {
-    steps.push(`The MCP server exposes: ${pc.dim("scan_file, scan_snippet")}`);
-  }
-  if (summary.installedItems.includes("hooks")) {
-    steps.push("Hooks will auto-validate UI files when the agent stops");
-  }
   if (summary.nextApp) {
     steps.push(
       "Run your Next.js dev server - use Alt+Click on any element to inspect"
@@ -6180,12 +5703,12 @@ async function serve(options) {
     `UILint WebSocket server running on ${pc.cyan(`ws://localhost:${port}`)}`
   );
   logInfo("Press Ctrl+C to stop");
-  await new Promise((resolve8) => {
+  await new Promise((resolve7) => {
     process.on("SIGINT", () => {
       logInfo("Shutting down...");
       wss.close();
       fileWatcher?.close();
-      resolve8();
+      resolve7();
     });
   });
 }
@@ -6673,184 +6196,9 @@ async function vision(options) {
   await flushLangfuse();
 }
 
-// src/commands/session.ts
-import { existsSync as existsSync20, readFileSync as readFileSync14, writeFileSync as writeFileSync10, unlinkSync as unlinkSync2 } from "fs";
-import { basename, dirname as dirname13, resolve as resolve7 } from "path";
-import { createStyleSummary as createStyleSummary3 } from "uilint-core";
-import {
-  ensureOllamaReady as ensureOllamaReady7,
-  parseCLIInput as parseCLIInput2,
-  readStyleGuideFromProject as readStyleGuideFromProject2,
-  readTailwindThemeTokens as readTailwindThemeTokens3
-} from "uilint-core/node";
-var SESSION_FILE = "/tmp/uilint-session.json";
-var UI_FILE_EXTENSIONS = [".tsx", ".jsx", ".css", ".scss", ".module.css"];
-function readSession() {
-  if (!existsSync20(SESSION_FILE)) {
-    return { files: [], startedAt: (/* @__PURE__ */ new Date()).toISOString() };
-  }
-  try {
-    const content = readFileSync14(SESSION_FILE, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return { files: [], startedAt: (/* @__PURE__ */ new Date()).toISOString() };
-  }
-}
-function writeSession(state) {
-  writeFileSync10(SESSION_FILE, JSON.stringify(state, null, 2), "utf-8");
-}
-function isUIFile(filePath) {
-  return UI_FILE_EXTENSIONS.some((ext) => filePath.endsWith(ext));
-}
-function isScannableMarkupFile(filePath) {
-  return [".tsx", ".jsx", ".html", ".htm"].some(
-    (ext) => filePath.endsWith(ext)
-  );
-}
-async function sessionClear() {
-  if (existsSync20(SESSION_FILE)) {
-    unlinkSync2(SESSION_FILE);
-  }
-  console.log(JSON.stringify({ cleared: true }));
-}
-async function sessionTrack(filePath) {
-  if (!isUIFile(filePath)) {
-    console.log(
-      JSON.stringify({
-        tracked: false,
-        reason: "not_ui_file",
-        file: filePath,
-        message: `Skipped non-UI file: ${basename(filePath)}`
-      })
-    );
-    return;
-  }
-  const session = readSession();
-  const wasAlreadyTracked = session.files.includes(filePath);
-  if (!wasAlreadyTracked) {
-    session.files.push(filePath);
-    writeSession(session);
-  }
-  console.log(
-    JSON.stringify({
-      tracked: true,
-      file: filePath,
-      total: session.files.length,
-      newlyAdded: !wasAlreadyTracked,
-      message: wasAlreadyTracked ? `Already tracking: ${basename(filePath)} (${session.files.length} files total)` : `Now tracking: ${basename(filePath)} (${session.files.length} files total)`
-    })
-  );
-}
-async function sessionScan(options = {}) {
-  const session = readSession();
-  if (session.files.length === 0) {
-    if (options.hookFormat) {
-      console.log("{}");
-    } else {
-      const result = {
-        totalFiles: 0,
-        filesWithIssues: 0,
-        results: [],
-        followupMessage: null
-      };
-      console.log(JSON.stringify(result));
-    }
-    return;
-  }
-  const projectPath = process.cwd();
-  let styleGuide;
-  try {
-    styleGuide = await readStyleGuideFromProject2(projectPath);
-  } catch {
-    if (options.hookFormat) {
-      console.log("{}");
-    } else {
-      const result = {
-        totalFiles: session.files.length,
-        filesWithIssues: 0,
-        results: [],
-        followupMessage: null
-      };
-      console.log(JSON.stringify(result));
-    }
-    return;
-  }
-  await ensureOllamaReady7();
-  const client = await createLLMClient({});
-  const results = [];
-  for (const filePath of session.files) {
-    if (!existsSync20(filePath)) continue;
-    if (!isScannableMarkupFile(filePath)) continue;
-    try {
-      const absolutePath = resolve7(process.cwd(), filePath);
-      const htmlLike = readFileSync14(filePath, "utf-8");
-      const snapshot = parseCLIInput2(htmlLike);
-      const tailwindSearchDir = dirname13(absolutePath);
-      const tailwindTheme = readTailwindThemeTokens3(tailwindSearchDir);
-      const styleSummary = createStyleSummary3(snapshot.styles, {
-        html: snapshot.html,
-        tailwindTheme
-      });
-      const analysis = await client.analyzeStyles(styleSummary, styleGuide);
-      results.push({
-        file: filePath,
-        issues: analysis.issues
-      });
-    } catch {
-      continue;
-    }
-  }
-  const filesWithIssues = results.filter((r) => r.issues.length > 0);
-  let followupMessage = null;
-  if (filesWithIssues.length > 0) {
-    const issueLines = [];
-    for (const fileResult of filesWithIssues) {
-      const fileName = basename(fileResult.file);
-      for (const issue of fileResult.issues) {
-        const type = issue.type?.toUpperCase?.() ?? "ISSUE";
-        const detail = issue.currentValue && issue.expectedValue ? ` (${issue.currentValue} \u2192 ${issue.expectedValue})` : issue.currentValue ? ` (${issue.currentValue})` : "";
-        issueLines.push(`- ${fileName}: [${type}] ${issue.message}${detail}`);
-        if (issue.suggestion) {
-          issueLines.push(`  Suggestion: ${issue.suggestion}`);
-        }
-      }
-    }
-    followupMessage = [
-      `UILint scan found UI consistency issues in ${filesWithIssues.length} file(s):`,
-      "",
-      ...issueLines,
-      "",
-      "See .uilint/styleguide.md for style rules. Please fix these issues."
-    ].join("\n");
-  }
-  if (options.hookFormat) {
-    if (followupMessage) {
-      console.log(JSON.stringify({ followup_message: followupMessage }));
-    } else {
-      console.log("{}");
-    }
-  } else {
-    const result = {
-      totalFiles: results.length,
-      filesWithIssues: filesWithIssues.length,
-      results,
-      followupMessage
-    };
-    console.log(JSON.stringify(result));
-  }
-  if (existsSync20(SESSION_FILE)) {
-    unlinkSync2(SESSION_FILE);
-  }
-  await flushLangfuse();
-}
-async function sessionList() {
-  const session = readSession();
-  console.log(JSON.stringify(session));
-}
-
 // src/index.ts
-import { readFileSync as readFileSync15 } from "fs";
-import { dirname as dirname14, join as join20 } from "path";
+import { readFileSync as readFileSync14 } from "fs";
+import { dirname as dirname13, join as join20 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function assertNodeVersion(minMajor) {
   const ver = process.versions.node || "";
@@ -6867,9 +6215,9 @@ assertNodeVersion(20);
 var program = new Command();
 function getCLIVersion2() {
   try {
-    const __dirname3 = dirname14(fileURLToPath4(import.meta.url));
+    const __dirname3 = dirname13(fileURLToPath4(import.meta.url));
     const pkgPath = join20(__dirname3, "..", "package.json");
-    const pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
     return pkg.version || "0.0.0";
   } catch {
     return "0.0.0";
@@ -6942,26 +6290,16 @@ program.command("update").description("Update existing style guide with new styl
     llm: options.llm
   });
 });
-program.command("install").description("Install UILint integration (MCP server and/or Cursor hooks)").option("--force", "Overwrite existing configuration files").option("--mcp", "Install MCP server integration (.cursor/mcp.json)").option("--hooks", "Install Cursor hooks integration (.cursor/hooks.json)").option("--genstyleguide", "Install /genstyleguide Cursor command").option(
-  "--genrules",
-  "Install /genrules Cursor command for ESLint rule generation"
-).option("--eslint", "Install uilint-eslint plugin and configure ESLint").option(
+program.command("install").description("Install UILint integration").option("--force", "Overwrite existing configuration files").option("--genstyleguide", "Install /genstyleguide Cursor command").option("--eslint", "Install uilint-eslint plugin and configure ESLint").option(
   "--routes",
   "Back-compat: install Next.js overlay (routes + deps + inject)"
 ).option(
   "--react",
   "Back-compat: install Next.js overlay (routes + deps + inject)"
-).option(
-  "--mode <mode>",
-  "Integration mode: mcp, hooks, or both (skips interactive prompt)"
 ).action(async (options) => {
   await install({
     force: options.force,
-    mode: options.mode,
-    mcp: options.mcp,
-    hooks: options.hooks,
     genstyleguide: options.genstyleguide,
-    genrules: options.genrules,
     eslint: options.eslint,
     routes: options.routes,
     react: options.react
@@ -7006,20 +6344,5 @@ program.command("vision").description("Analyze a screenshot with Ollama vision m
     debugDump: options.debugDump
   });
 });
-var sessionCmd = program.command("session").description(
-  "Manage file tracking for agentic sessions (used by Cursor hooks)"
-);
-sessionCmd.command("clear").description("Clear tracked files (called at start of agent turn)").action(async () => {
-  await sessionClear();
-});
-sessionCmd.command("track <file>").description("Track a file edit (called on each file edit)").action(async (file) => {
-  await sessionTrack(file);
-});
-sessionCmd.command("scan").description("Scan all tracked markup files (called on agent stop)").option("--hook", "Output in Cursor hook format (followup_message JSON only)").action(async (options) => {
-  await sessionScan({ hookFormat: options.hook });
-});
-sessionCmd.command("list").description("List tracked files (for debugging)").action(async () => {
-  await sessionList();
-});
 program.parse();
 //# sourceMappingURL=index.js.map