vite-plugin-ai-annotator 1.15.0 → 1.16.0

package/README.md

@@ -92,81 +92,54 @@ export default defineNuxtConfig({
 
 **That's it!** Nuxt handles the rest automatically.
 
-#### Configure MCP (Vite and Nuxt)
-
-**Option A: Auto Setup (Recommended)**
-
-Enable automatic MCP configuration in your Vite config:
+#### Step 3: Start your dev server
 
-```typescript
-annotator({
-  autoSetupMcp: true,
-})
+```bash
+bun dev
 ```
 
-For Nuxt, configure in `nuxt.config.ts`:
+The annotator toolbar will automatically appear in your application. The plugin auto-writes a skill file (`.claude/skills/ai-annotator/SKILL.md`) so Claude Code knows how to read your feedback over the REST API on every restart.
 
-```typescript
-export default defineNuxtConfig({
-  modules: ['vite-plugin-ai-annotator/nuxt'],
-  aiAnnotator: {
-    autoSetupMcp: true,
-  }
-})
-```
+## Usage
 
-This automatically creates/updates `.mcp.json`, `.cursor/mcp.json`, and `.vscode/mcp.json` based on your project.
+### With the channel plugin (push, recommended)
 
-**Option B: Manual Setup**
+The Vite plugin prints these install commands on dev-server start when the channel plugin isn't enabled — copy/paste once:
 
 ```bash
-claude mcp add annotator -- npx vite-plugin-ai-annotator mcp -s http://localhost:7318
+/plugin marketplace add nguyenvanduocit/claude-annotator-plugin
+/plugin install claude-annotator-plugin@claude-annotator-plugin
+# Restart with the channel flag (Claude Code v2.1.80+; research preview)
+claude --dangerously-load-development-channels plugin:claude-annotator-plugin@claude-annotator-plugin
 ```
 
-#### Step 3: Start your dev server
-
-```bash
-bun dev
-```
+After that the hint stays silent (the Vite plugin reads `~/.claude/settings.json` to detect it; it never writes to that file). Set `autoSetupChannelPlugin: false` if you want to silence the hint without installing.
 
-The annotator toolbar will automatically appear in your application.
+1. Click the **inspect** button on the toolbar to enter feedback mode
+2. Click any element(s) you want to give feedback on, type a comment
+3. Click **send** — Claude Code's session immediately receives a `<channel source="ai-annotator">` event with your `session_id`, `page_url`, and `count`
+4. Claude fetches the details from the REST API, edits the source files, and pushes a toast back to your toolbar with progress
 
-## Usage
+### Without the channel plugin (pull)
 
-1. Click the **inspect button** on the toolbar to enter feedback mode
-2. Click on any element(s) you want to provide feedback on
-3. Ask Claude Code to modify them - it will use `annotator_get_feedback` to get the selected feedback with their source locations
-4. Claude modifies the source code directly
+Same first three steps. Then ask Claude Code to apply your feedback — it follows the auto-installed skill, calls `GET /api/sessions/<id>/feedback`, edits the files, and `DELETE`s the feedback when done.
 
-Example prompt: *"Make the selected button larger and change its color to blue"*
+Example prompt: *"Apply the feedback I just left in the browser."*
 
 ## Configuration
 
 ```typescript
 annotator({
-  port: 7318,              // Server port (default: 7318)
-  autoSetupMcp: true,      // Auto-configure MCP files (default: false)
-  autoSetupSkills: true,   // Auto-write AI tool skill files (default: true)
-  verbose: false,          // Enable detailed logging (default: false)
+  port: 7318,                     // Server port (default: 7318)
+  autoSetupSkills: true,          // Auto-write AI tool skill files (default: true)
+  autoSetupChannelPlugin: true,   // Print one-time install hint for the Claude Code
+                                  // channel plugin if it isn't already enabled in
+                                  // ~/.claude/settings.json (default: true; read-only)
+  injectSourceLoc: true,          // Inject data-source-loc attrs into HTML (default: true)
+  verbose: false,                 // Enable detailed logging (default: false)
 })
 ```
 
-### Auto MCP Setup
-
-When `autoSetupMcp: true`, the plugin automatically:
-
-1. **Detects your package manager** from lockfile:
-   - `bun.lockb` / `bun.lock` → uses `bunx`
-   - `pnpm-lock.yaml` → uses `pnpm dlx`
-   - Otherwise → uses `npx`
-
-2. **Creates/updates MCP config files**:
-   - `.mcp.json` - Claude Code, Cline, Roo Code
-   - `.cursor/mcp.json` - Cursor (only if `.cursor/` exists)
-   - `.vscode/mcp.json` - VS Code (only if `.vscode/` exists)
-
-3. **Preserves existing config** - merges with other MCP servers, doesn't overwrite
-
 ### Auto AI Skills Setup
 
 When `autoSetupSkills: true` (default), the plugin writes skill/instruction files on every dev server start with the correct server address baked in. This means AI tools automatically know how to call the REST API:

package/dist/annotator-toolbar.js

@@ -6238,14 +6238,14 @@
       while (currentElement && currentElement !== document.body) {
         let selector = currentElement.tagName.toLowerCase();
         if (currentElement.id && this.isUniqueId(currentElement.id)) {
-          selector += `#${currentElement.id}`;
+          selector += `#${CSS.escape(currentElement.id)}`;
           parts2.unshift(selector);
           break;
         }
         if (currentElement.className && typeof currentElement.className === "string") {
-          const classes = currentElement.className.split(" ").filter((c4) => c4 && !c4.includes("css-") && !c4.includes("emotion-")).slice(0, 2);
+          const classes = currentElement.className.split(/\s+/).filter((c4) => c4 && !c4.includes("css-") && !c4.includes("emotion-")).slice(0, 2);
           if (classes.length > 0) {
-            selector += "." + classes.join(".");
+            selector += "." + classes.map((c4) => CSS.escape(c4)).join(".");
           }
         }
         const siblings = Array.from(currentElement.parentElement?.children || []).filter((sibling) => sibling.tagName === currentElement.tagName);
@@ -6344,7 +6344,7 @@
       const primary = this.generateElementSelector(element);
       const fallbacks = [];
       if (element.id && this.isUniqueId(element.id)) {
-        fallbacks.push(`#${element.id}`);
+        fallbacks.push(`#${CSS.escape(element.id)}`);
       }
       if (element.getAttribute("data-testid")) {
         fallbacks.push(`[data-testid="${element.getAttribute("data-testid")}"]`);

package/dist/nuxt-module.js

@@ -5,7 +5,8 @@ import { defineNuxtModule, addVitePlugin } from "@nuxt/kit";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { dirname as dirname2, join as join2, relative } from "node:path";
-import { existsSync as existsSync2 } from "node:fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { homedir } from "node:os";
 
 // node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs
 var comma = ",".charCodeAt(0);
@@ -1221,6 +1222,27 @@ ${body}
 }
 
 // src/vite-plugin.ts
+var CHANNEL_PLUGIN_KEY = "claude-annotator-plugin@claude-annotator-plugin";
+var CHANNEL_PLUGIN_REPO = "nguyenvanduocit/claude-annotator-plugin";
+function isChannelPluginEnabled() {
+  try {
+    const settingsPath = join2(homedir(), ".claude", "settings.json");
+    if (!existsSync2(settingsPath)) return false;
+    const settings = JSON.parse(readFileSync2(settingsPath, "utf-8"));
+    return Boolean(settings?.enabledPlugins?.[CHANNEL_PLUGIN_KEY]);
+  } catch {
+    return false;
+  }
+}
+function printChannelPluginSuggestion() {
+  console.log(
+    `[ai-annotator] \u{1F4A1} Channel push plugin not detected. For instant push to Claude Code (instead of copy-paste), run once:
+  /plugin marketplace add ${CHANNEL_PLUGIN_REPO}
+  /plugin install ${CHANNEL_PLUGIN_KEY}
+  claude --dangerously-load-development-channels plugin:${CHANNEL_PLUGIN_KEY}
+  (Claude Code v2.1.80+; set autoSetupChannelPlugin: false in your vite.config to hide this.)`
+  );
+}
 var SOURCE_LOC_ATTR = "data-source-loc";
 function injectSourceLocations(code, id, root) {
   if (!code.includes("<")) return null;
@@ -1304,7 +1326,8 @@ var AiAnnotatorServer = class {
       publicAddress: options.publicAddress ?? `http://${listenAddress}:${port}`,
       verbose: options.verbose ?? false,
       injectSourceLoc: options.injectSourceLoc ?? true,
-      autoSetupSkills: options.autoSetupSkills ?? true
+      autoSetupSkills: options.autoSetupSkills ?? true,
+      autoSetupChannelPlugin: options.autoSetupChannelPlugin ?? true
     };
     const currentFileDir = dirname2(fileURLToPath(import.meta.url));
     this.isRunningFromSource = currentFileDir.endsWith("/src") || currentFileDir.endsWith("\\src");
@@ -1454,6 +1477,9 @@ function aiAnnotator(options = {}) {
           console.log(`[ai-annotator] \u2705 AI skills updated: ${skillsResult.updated.map((f) => f.replace(root + "/", "")).join(", ")}`);
         }
       }
+      if (options.autoSetupChannelPlugin !== false && !isChannelPluginEnabled()) {
+        printChannelPluginSuggestion();
+      }
     },
     async buildStart() {
       await serverManager.start();