liteagents 2.5.3 → 2.6.0

package/CHANGELOG.md

@@ -17,6 +17,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.6.0] - 2026-04-19
+
+### Added
+- **live-canvas skill** — Design interview, generates 5 UI variations, collects click-to-annotate feedback from the browser, produces a final implementation plan. Available as a skill in Claude Code and as a command in Droid/Ampcode/Opencode.
+  - **Vanilla overlay** (`overlay-vanilla.js`, ~400 lines, zero deps) — framework-agnostic click-to-annotate HUD with pin placement, selector inference (`data-testid` > `id` > class chain, CSS-in-JS hashes filtered), variant detection via `data-variant` attribute, and a v1.0 schema wire-compatible with the upstream React template.
+  - **React overlay** (`FeedbackOverlay.tsx`) kept for React/Next/Vite projects.
+  - **Demo** (`templates/demo/post-variants.html`) — standalone 5-variant post card playground for review without starting a dev server.
+  - **Handholding activation flow** — Phase 0 probes the channel on every invocation and offers `AskUserQuestion` choices: first-time users get the full 4-step setup; returning users who forgot the dev flag get the restart command; channel-up sessions proceed silently.
+- **live-canvas-channel plugin** (Claude Code only) — MCP channel server that bridges the overlay's HTTP POSTs into the live session as `notifications/claude/channel` events. Packaged as a Claude Code marketplace under `packages/claude/plugins/live-canvas-marketplace/`.
+  - HTTP listener on `127.0.0.1:8788` with `/health` probe and `/feedback` POST endpoint
+  - MCP server using `@modelcontextprotocol/sdk` with `experimental: {'claude/channel': {}}` capability
+  - `instructions` field added to tell Claude how to act on incoming `<channel source="live-canvas">` tags: acknowledge in chat → locate variant file → edit → confirm
+  - `setup.sh` helper that runs `npm install` and prints the 3 remaining manual steps
+- **Installer: plugins as first-class category** — `packages/<tool>/plugins/` now discovered, selected per variant, and copied to `<target>/plugins/`, parallel to skills. `node_modules/` excluded during copy and size computation. Manifest generation includes a `plugins` component count, installed-files list, and path entry.
+- **Friction report: project attribution in cluster output** — `antigen_review.md` now shows which projects each cluster spans (new "Projects" column in the summary table; new `**Projects:**` line per cluster). Data was always in `session_id`; the previous version dropped it during clustering.
+
+### Changed
+- **README restructured for Hot Memory visibility** — new top-level `🧠 Hot Memory` section between Quick Start and What's Included, with pipeline diagram and sample friction output. Manual Skills/Commands list regrouped into named sub-sections (Hot Memory Pipeline, Design, Workflow & analysis). Old duplicated Hot Memory section removed.
+- **Command/skill count 22 → 23** per tool across README, subagentic-manual, and per-package `AGENTS.md` / `AGENT.md` / `CLAUDE.md`.
+- **opencode.jsonc** — added `live-canvas` entry under `"command"` block.
+
+### Fixed
+- **Friction clustering dropped project names** — cluster object converted `{sessionId: true}` dict to a count before rendering, so `antigen_review.md` never surfaced which repos contributed to each pattern. Fix preserves `session_ids[]` and `projects[]` on every cluster.
+- **Live Canvas overlay counter flicker in live mode** — counter went 0→1→0 during successful push roundtrip. Rewrote so successful live pushes never enter the pending-batch state; counter stays at 0 unless a push actually fails.
+
+### Notes
+- The Claude Code channel plugin is subject to Claude Code's research preview: custom channels require `--dangerously-load-development-channels` at session start, and steps 2-4 of setup (`/plugin marketplace add`, `/plugin install`, session restart) cannot be automated. The skill prints copyable commands and an alias suggestion.
+- Droid, Ampcode, and Opencode run live-canvas in batch mode only — channels are Claude-Code-specific.
+
+---
+
 ## [2.5.2] - 2026-02-11
 
 ### Added

package/README.md

@@ -9,7 +9,7 @@
          ╚══════╝╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝
 ```
 
-**AI development toolkit with 11 specialized agents and 22 commands per tool**
+**AI development toolkit with 11 specialized agents and 23 commands per tool**
 
 [![npm version](https://img.shields.io/npm/v/liteagents)](https://www.npmjs.com/package/liteagents)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -43,10 +43,10 @@ liteagents
 
 ### Supported Tools
 
-- **Claude Code** - 11 subagents + 10 skills + 12 commands
-- **Opencode** - 11 agent references + 22 commands
-- **Ampcode** - 11 subagents + 22 commands
-- **Droid** - 11 agent references + 22 commands
+- **Claude Code** - 11 subagents + 11 skills + 12 commands (+ optional live-canvas channel plugin)
+- **Opencode** - 11 agent references + 23 commands
+- **Ampcode** - 11 subagents + 23 commands
+- **Droid** - 11 agent references + 23 commands
 
 **Key Difference:**
 - **Claude Code**: Full subagent system with orchestrator + skills (auto-triggering)
@@ -69,6 +69,39 @@ liteagents
 
 ---
 
+## 🧠 Hot Memory — project-local learning from your own sessions
+
+Liteagents ships a three-command pipeline that turns Claude Code's session logs into project-local memory. No databases, no external services, just markdown files the assistant reads via `@MEMORY.md`.
+
+```
+/stash  →  /friction  →  /remember
+capture    analyze        consolidate
+```
+
+- **`/stash`** — snapshot the current session's context before compaction or handoff
+- **`/friction`** — mine JSONL session logs for frustration signals, failed flows, and abandonment patterns; cluster them into antigen candidates per project
+- **`/remember`** — consolidate stashes + friction antigens into `.claude/memory/MEMORY.md`; auto-injected into `CLAUDE.md` via `@MEMORY.md` so every future session in the project benefits
+
+What you get is a memory that *learns from your own mistakes and interventions*, grows quietly in your repo, and works anywhere Claude Code runs. The friction analyzer alone scans all your projects and gives you a per-repo reliability verdict:
+
+```
+Per-Project:
+  my-app         56% BAD (40/72)  median: 16.0  🔴
+  api-service    40% BAD (2/5)    median:  0.5  🟡
+  web-client      0% BAD (0/1)    median:  0.0  ✅
+
+WORST: my-app/0203-1630-11eb903a  peak=225  turns=127
+BEST:  web-client/0202-2121-8d8608e1  peak=0  turns=4
+
+Verdict: ✓ USEFUL    Intervention predictability: 93%
+```
+
+Results land in `.claude/friction/antigen_review.md` with projects, error patterns, and offending tool sequences called out per cluster — so `/remember` can pick them up and encode them as rules the next session sees.
+
+> This is the thing in liteagents that nothing else ships. Normal skill bundles give you instructions. The hot-memory pipeline gives you instructions the assistant wrote for itself, from your own logs.
+
+---
+
 ## 🤖 What's Included
 
 ### 11 Agents
@@ -88,14 +121,24 @@ liteagents
 - **system-architect** - System design, technology selection, API design, scalability planning
 - **ui-designer** - UI/UX design, wireframes, prototypes, accessibility, design systems
 
-### 22 Commands/Skills
+### 23 Commands/Skills
 
 **Auto-Triggering Skills (3)** - Claude Code only:
 - **test-driven-development** - Write test first, watch fail, minimal passing code
 - **testing-anti-patterns** - Prevent mocking anti-patterns
 - **verification-before-completion** - Verify before claiming done
 
-**Manual Skills/Commands (19):**
+**Manual Skills/Commands (20):**
+
+*Hot Memory Pipeline (3)* — see the [🧠 Hot Memory](#-hot-memory--project-local-learning-from-your-own-sessions) section above for the full walkthrough:
+- **stash** - Snapshot session context to `.claude/stash/` before compaction, handoff, or ending complex work
+- **friction** - Analyze all JSONL sessions for frustration signals, cluster failures per project, surface antigens
+- **remember** - Consolidate stashes + friction antigens into `.claude/memory/MEMORY.md`; auto-injected via `@MEMORY.md`
+
+*Design*:
+- **live-canvas** - Design UI variations with click-to-annotate feedback in the browser; ships a companion MCP channel plugin for Claude Code so Saves stream into the session in real time. Other tools use batch mode.
+
+*Workflow & analysis*:
 - **brainstorming** - Structured brainstorming sessions
 - **code-review** - Implementation review against requirements
 - **condition-based-waiting** - Replace timeouts with condition polling
@@ -105,52 +148,15 @@ liteagents
 - **systematic-debugging** - Four-phase debugging framework
 - **debug** - Systematic issue investigation
 - **explain** - Explain code for newcomers
-- **friction** - Analyze session logs for failure patterns and behavioral signals
 - **git-commit** - Intelligent commit creation
 - **optimize** - Performance analysis
 - **refactor** - Safe refactoring with behavior preservation
-- **remember** - Consolidate stashes + friction into project memory
 - **review** - Comprehensive code review
 - **security** - Vulnerability scanning
 - **ship** - Pre-deployment checklist
-- **stash** - Save session context for compaction recovery or handoffs
 - **test-generate** - Generate test suites
 
-### Hot Memory (3-step pipeline)
-
-Lightweight session memory that learns from your usage patterns.
-
-```
-/stash → /friction → /remember
-```
-
-1. **`/stash`** - Snapshot current session context to `.claude/stash/`. Use before compaction, handoffs, or ending complex work.
-2. **`/friction`** - Analyze session logs for failure patterns. Scores sessions, clusters failures, outputs actionable antigens.
-3. **`/remember`** - Consolidate stashes + friction into `.claude/memory/MEMORY.md`. Extracts facts, episodes, and behavioral preferences. Injects into CLAUDE.md via `@MEMORY.md`.
-
-**Result:** Project-local memory that accumulates across sessions — no external dependencies, no databases, just markdown.
-
-```bash
-# Standalone CLI — analyze all projects
-liteagents friction ~/.claude/projects
-
-Per-Project:
-my-app         56% BAD (40/72)  median: 16.0  🔴
-api-service    40% BAD (2/5)    median: 0.5   🟡
-web-client      0% BAD (0/1)    median: 0.0   ✅
-
-Session Extremes:
-WORST: my-app/0203-1630-11eb903a  peak=225  turns=127
-BEST:  web-client/0202-2121-8d8608e1  peak=0  turns=4
-
-Last 2 Weeks:
-2026-02-02  15 sessions  10 BAD  ██████░░░░  67%
-2026-02-03  29 sessions  12 BAD  ████░░░░░░  41%
-2026-02-04   6 sessions   2 BAD  ███░░░░░░░  33%
-
-Verdict: ✓ USEFUL
-Intervention predictability: 93%
-```
+> **Claude-only plugin:** `live-canvas-channel` is a bundled Claude Code MCP channel plugin that ships under `~/.claude/plugins/live-canvas-marketplace/`. One-time `/plugin install` + a session started with `--dangerously-load-development-channels` unlocks live mode. Skill probes for the channel on each invocation and handholds setup when missing. See [`packages/claude/skills/live-canvas/README.md`](packages/claude/skills/live-canvas/README.md) for the full walkthrough.
 
 ---
 

package/installer/cli.js

@@ -456,7 +456,7 @@ ${colors.bright}${colors.cyan}██╔══██║██║   ██║█
 ${colors.bright}${colors.cyan}██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ██║╚██████╗    ██║  ██╗██║   ██║${colors.reset}
 ${colors.bright}${colors.cyan}╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝ ╚═════╝    ╚═╝  ╚═╝╚═╝   ╚═╝${colors.reset}
 
-${colors.bright}v2.5.3 | 11 agents + 22 commands per tool${colors.reset}
+${colors.bright}v2.6.0 | 11 agents + 23 commands per tool${colors.reset}
     `);
   }
 

package/installer/installation-engine.js

@@ -194,18 +194,23 @@ class InstallationEngine {
       }
     };
 
-    // Helper function to recursively collect all files in a directory
-    const collectDirectoryFiles = async (dirPath, relativePath = '') => {
+    // Helper function to recursively collect all files in a directory.
+    // Skips node_modules directories (callers may set skipNodeModules=true for plugins).
+    const collectDirectoryFiles = async (dirPath, relativePath = '', skipNodeModules = false) => {
       const items = await fs.promises.readdir(dirPath);
       const filesInDir = [];
 
       for (const item of items) {
+        if (skipNodeModules && item === 'node_modules') {
+          continue;
+        }
+
         const itemPath = path.join(dirPath, item);
         const itemRelativePath = path.join(relativePath, item);
         const stat = await fs.promises.stat(itemPath);
 
         if (stat.isDirectory()) {
-          const subFiles = await collectDirectoryFiles(itemPath, itemRelativePath);
+          const subFiles = await collectDirectoryFiles(itemPath, itemRelativePath, skipNodeModules);
           filesInDir.push(...subFiles);
         } else {
           filesInDir.push({
@@ -310,6 +315,23 @@ class InstallationEngine {
       totalBytes += size;
     }
 
+    // Collect all plugin files (plugins are directories like skills; skip node_modules)
+    for (const pluginPath of (packageContents.plugins || [])) {
+      const baseRelativePath = path.relative(sourceBase, pluginPath);
+      const pluginFiles = await collectDirectoryFiles(pluginPath, baseRelativePath, true);
+
+      for (const file of pluginFiles) {
+        filesToCopy.push({
+          sourcePath: file.sourcePath,
+          relativePath: file.relativePath,
+          size: file.size,
+          type: 'plugin'
+        });
+        totalFiles++;
+        totalBytes += file.size;
+      }
+    }
+
     // Now copy all files with progress tracking
     let filesCompleted = 0;
     let bytesTransferred = 0;
@@ -364,6 +386,11 @@ class InstallationEngine {
     const items = await fs.promises.readdir(source);
 
     for (const item of items) {
+      // Skip node_modules - callers (plugins, backups) should never ship bundled deps
+      if (item === 'node_modules') {
+        continue;
+      }
+
       const sourcePath = path.join(source, item);
       const targetPath = path.join(target, item);
 
@@ -433,19 +460,22 @@ class InstallationEngine {
         agents: contents.agents.length,
         skills: contents.skills.length,
         resources: contents.resources.length,
-        hooks: contents.hooks.length
+        hooks: contents.hooks.length,
+        plugins: (contents.plugins || []).length
       },
       installedFiles: {
         agents: contents.agents.map(extractAgentName),
         skills: contents.skills.map(extractSkillName),
         resources: contents.resources.map(p => path.basename(p)),
-        hooks: contents.hooks.map(p => path.basename(p))
+        hooks: contents.hooks.map(p => path.basename(p)),
+        plugins: (contents.plugins || []).map(extractSkillName)
       },
       paths: {
         agents: path.join(targetPath, 'agents'),
         skills: path.join(targetPath, 'skills'),
         resources: path.join(targetPath, 'resources'),
-        hooks: path.join(targetPath, 'hooks')
+        hooks: path.join(targetPath, 'hooks'),
+        plugins: path.join(targetPath, 'plugins')
       },
       files: {
         total: contents.totalFiles,
@@ -538,7 +568,7 @@ class InstallationEngine {
 
             // Remove files listed in manifest
             if (manifest.installedFiles) {
-              for (const category of ['agents', 'skills', 'resources', 'hooks']) {
+              for (const category of ['agents', 'skills', 'resources', 'hooks', 'plugins']) {
                 if (manifest.installedFiles[category] && manifest.paths && manifest.paths[category]) {
                   const categoryPath = manifest.paths[category];
 
@@ -548,8 +578,8 @@ class InstallationEngine {
                     if (category === 'agents') {
                       // Agents have .md extension
                       itemPath = path.join(categoryPath, `${item}.md`);
-                    } else if (category === 'skills') {
-                      // Skills are directories
+                    } else if (category === 'skills' || category === 'plugins') {
+                      // Skills and plugins are directories
                       itemPath = path.join(categoryPath, item);
                     } else {
                       // Resources and hooks have their full names
@@ -650,7 +680,7 @@ class InstallationEngine {
    * @param {string} targetPath - Base installation path
    */
   async cleanupEmptyDirectories(targetPath) {
-    const categories = ['agents', 'skills', 'resources', 'hooks'];
+    const categories = ['agents', 'skills', 'resources', 'hooks', 'plugins'];
 
     for (const category of categories) {
       const categoryPath = path.join(targetPath, category);
@@ -762,7 +792,8 @@ class InstallationEngine {
         agents: { expected: 0, found: 0, missing: [] },
         skills: { expected: 0, found: 0, missing: [] },
         resources: { expected: 0, found: 0, missing: [] },
-        hooks: { expected: 0, found: 0, missing: [] }
+        hooks: { expected: 0, found: 0, missing: [] },
+        plugins: { expected: 0, found: 0, missing: [] }
       },
       timestamp: new Date().toISOString()
     };
@@ -785,8 +816,16 @@ class InstallationEngine {
       const manifest = JSON.parse(await fs.promises.readFile(manifestPath, 'utf8'));
       result.manifest = manifest;
 
-      // Verify all required directories exist
+      // Verify all required directories exist (skip categories with 0 expected items)
       for (const [component, componentPath] of Object.entries(manifest.paths || {})) {
+        const expectedCount = (manifest.installedFiles && Array.isArray(manifest.installedFiles[component]))
+          ? manifest.installedFiles[component].length
+          : 0;
+
+        if (expectedCount === 0) {
+          continue;
+        }
+
         if (!fs.existsSync(componentPath)) {
           result.valid = false;
           result.issues.push({
@@ -799,7 +838,7 @@ class InstallationEngine {
       }
 
       // Verify installed files for each component category
-      for (const category of ['agents', 'skills', 'resources', 'hooks']) {
+      for (const category of ['agents', 'skills', 'resources', 'hooks', 'plugins']) {
         if (manifest.installedFiles && manifest.installedFiles[category]) {
           const expectedFiles = manifest.installedFiles[category];
           result.components[category].expected = expectedFiles.length;
@@ -812,7 +851,7 @@ class InstallationEngine {
             // Construct full path based on category
             if (category === 'agents') {
               itemPath = path.join(categoryPath, `${item}.md`);
-            } else if (category === 'skills') {
+            } else if (category === 'skills' || category === 'plugins') {
               itemPath = path.join(categoryPath, item);
             } else {
               itemPath = path.join(categoryPath, item);
@@ -847,7 +886,7 @@ class InstallationEngine {
 
       // Verify file counts match
       if (manifest.components) {
-        for (const category of ['agents', 'skills', 'resources', 'hooks']) {
+        for (const category of ['agents', 'skills', 'resources', 'hooks', 'plugins']) {
           if (manifest.components[category] !== undefined) {
             const expectedCount = manifest.components[category];
             const foundCount = result.components[category].found;
@@ -967,7 +1006,7 @@ class InstallationEngine {
 
       // Collect all files from manifest
       if (manifest.installedFiles) {
-        for (const category of ['agents', 'skills', 'resources', 'hooks']) {
+        for (const category of ['agents', 'skills', 'resources', 'hooks', 'plugins']) {
           if (manifest.installedFiles[category] && manifest.paths && manifest.paths[category]) {
             const categoryPath = manifest.paths[category];
 
@@ -977,8 +1016,8 @@ class InstallationEngine {
               if (category === 'agents') {
                 // Agents have .md extension
                 itemPath = path.join(categoryPath, `${item}.md`);
-              } else if (category === 'skills') {
-                // Skills are directories - need to count all files inside
+              } else if (category === 'skills' || category === 'plugins') {
+                // Skills and plugins are directories - need to count all files inside
                 itemPath = path.join(categoryPath, item);
               } else {
                 // Resources and hooks have their full names
@@ -989,7 +1028,7 @@ class InstallationEngine {
                 path: itemPath,
                 category: category,
                 name: item,
-                isDirectory: category === 'skills'
+                isDirectory: category === 'skills' || category === 'plugins'
               });
             }
           }
@@ -1443,6 +1482,26 @@ class InstallationEngine {
       }
     }
 
+    // Compare plugins (directories, like skills)
+    const currentPluginsList = currentContents.plugins || [];
+    const newPluginsList = newContents.plugins || [];
+    const currentPlugins = new Set(currentPluginsList.map(p => path.basename(p)));
+    const newPlugins = new Set(newPluginsList.map(p => path.basename(p)));
+
+    for (const plugin of newPluginsList) {
+      const basename = path.basename(plugin);
+      if (!currentPlugins.has(basename)) {
+        toAdd.push({ type: 'plugin', source: plugin, name: basename });
+      }
+    }
+
+    for (const plugin of currentPluginsList) {
+      const basename = path.basename(plugin);
+      if (!newPlugins.has(basename)) {
+        toRemove.push({ type: 'plugin', name: basename, category: 'plugins' });
+      }
+    }
+
     return { toAdd, toRemove };
   }
 
@@ -1456,7 +1515,8 @@ class InstallationEngine {
       agents: new Set(manifest.installedFiles.agents),
       skills: new Set(manifest.installedFiles.skills),
       resources: new Set(manifest.installedFiles.resources),
-      hooks: new Set(manifest.installedFiles.hooks)
+      hooks: new Set(manifest.installedFiles.hooks),
+      plugins: new Set(manifest.installedFiles.plugins || [])
     };
 
     for (const file of filesToRemove) {
@@ -1503,7 +1563,8 @@ class InstallationEngine {
       const sourcePath = file.source;
       const targetCategory = file.type === 'agent' ? 'agents' :
                             file.type === 'skill' ? 'skills' :
-                            file.type === 'resource' ? 'resources' : 'hooks';
+                            file.type === 'resource' ? 'resources' :
+                            file.type === 'plugin' ? 'plugins' : 'hooks';
 
       const targetDir = path.join(targetPath, targetCategory);
 

package/installer/package-manager.js

@@ -137,7 +137,8 @@ class PackageManager {
       skills: [],
       commands: [],
       resources: [],
-      hooks: []
+      hooks: [],
+      plugins: []
     };
 
     // Helper function to process each content category
@@ -182,6 +183,7 @@ class PackageManager {
     selected.commands = selectItems('commands', variantConfig.commands, availableContent.commands || [], true);
     selected.resources = selectItems('resources', variantConfig.resources, availableContent.resources || []);
     selected.hooks = selectItems('hooks', variantConfig.hooks, availableContent.hooks || []);
+    selected.plugins = selectItems('plugins', variantConfig.plugins, availableContent.plugins || []);
 
     return selected;
   }
@@ -227,6 +229,7 @@ class PackageManager {
       commands: [],
       resources: [],
       hooks: [],
+      plugins: [],
       totalFiles: 0,
       totalSize: 0
     };
@@ -295,12 +298,24 @@ class PackageManager {
       }
     }
 
+    // Build directory paths for selected plugins (plugins are directories, like skills)
+    const pluginsDir = path.join(packageDir, 'plugins');
+    if (fs.existsSync(pluginsDir)) {
+      for (const plugin of (selectedContent.plugins || [])) {
+        const pluginPath = path.join(pluginsDir, plugin);
+        if (fs.existsSync(pluginPath)) {
+          contents.plugins.push(pluginPath);
+        }
+      }
+    }
+
     // Calculate total files
     contents.totalFiles = contents.agents.length +
                          contents.skills.length +
                          contents.commands.length +
                          contents.resources.length +
-                         contents.hooks.length;
+                         contents.hooks.length +
+                         contents.plugins.length;
 
     return contents;
   }
@@ -349,6 +364,7 @@ class PackageManager {
     const commandsResult = await getItemsInDir(path.join(packageDir, commandsDir), true);
     const resourcesResult = await getItemsInDir(path.join(packageDir, 'resources'));
     const hooksResult = await getItemsInDir(path.join(packageDir, 'hooks'));
+    const pluginsResult = await getItemsInDir(path.join(packageDir, 'plugins'));
 
     return {
       agents: agentsResult.items,
@@ -357,7 +373,8 @@ class PackageManager {
       commands: commandsResult.items,
       commandsDir: commandsDir,
       resources: resourcesResult.items,
-      hooks: hooksResult.items
+      hooks: hooksResult.items,
+      plugins: pluginsResult.items
     };
   }
   
@@ -399,6 +416,7 @@ class PackageManager {
     let totalSize = 0;
 
     // Helper function to calculate size of a file or directory recursively
+    // Skips node_modules directories (plugins may have local installs)
     const calculatePathSize = async (itemPath) => {
       try {
         const stat = await fs.promises.stat(itemPath);
@@ -406,6 +424,11 @@ class PackageManager {
         if (stat.isFile()) {
           return stat.size;
         } else if (stat.isDirectory()) {
+          // Skip node_modules to avoid bundling local dependencies
+          if (path.basename(itemPath) === 'node_modules') {
+            return 0;
+          }
+
           // Recursively calculate directory size
           let dirSize = 0;
           const items = await fs.promises.readdir(itemPath);
@@ -445,6 +468,11 @@ class PackageManager {
       totalSize += await calculatePathSize(hookPath);
     }
 
+    // Calculate size for all selected plugins (directories, excluding node_modules)
+    for (const pluginPath of (contents.plugins || [])) {
+      totalSize += await calculatePathSize(pluginPath);
+    }
+
     return {
       size: totalSize,
       formattedSize: this.formatBytes(totalSize)
@@ -601,6 +629,9 @@ class PackageManager {
       const commandsDirName = availableContent.commandsDir || 'commands';
       await checkContentExists('commands', selectedContent.commands || [], commandsDirName, true);
 
+      // Validate plugins (directories, like skills)
+      await checkContentExists('plugins', selectedContent.plugins || [], 'plugins', false);
+
     } catch (error) {
       return {
         valid: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "liteagents",
-  "version": "2.5.3",
-  "description": "AI development toolkit with 11 specialized agents and 22 commands. Simple one-question installer for Claude, Opencode, Ampcode, and Droid.",
+  "version": "2.6.0",
+  "description": "AI development toolkit with 11 specialized agents and 23 commands including live-canvas UI design with click-to-annotate feedback. Simple one-question installer for Claude, Opencode, Ampcode, and Droid.",
   "main": "index.js",
   "bin": {
     "liteagents": "./installer/cli.js",
@@ -16,6 +16,7 @@
     "clean:git": "git clean -fdx tests/tmp/",
     "validate": "node ./scripts/validate-package.js",
     "validate-packages": "node scripts/validate-all-packages.js",
+    "prepack": "rm -rf packages/*/plugins/*/plugins/*/node_modules",
     "prepublishOnly": "npm run clean && npm run validate",
     "postinstall": "node postinstall.js"
   },

package/packages/ampcode/AGENT.md

@@ -45,6 +45,7 @@ These subagents are available when using Ampcode CLI.
 | explain | Explain code for someone new to the codebase | /explain <code-section> |
 | friction | Analyze session logs for failure patterns and behavioral signals | /friction <sessions-path> |
 | git-commit | Analyze changes and create intelligent git commits | /git-commit |
+| live-canvas | Design UI variations and collect click-to-annotate feedback from the browser (batch mode only on Amp) | /live-canvas |
 | optimize | Analyze and optimize performance issues | /optimize <target-area> |
 | refactor | Refactor code while maintaining behavior and tests | /refactor <code-section> |
 | remember | Consolidate stashes + friction into project memory | /remember |

package/packages/ampcode/commands/friction/friction.js

@@ -1940,12 +1940,21 @@ function clusterCandidates(allCandidates) {
   const clusters = Object.values(clusterMap).map(cl => {
     const weight = signalWeights[cl.anchor_signal] || 1;
     const peaks = cl.peaks.sort((a, b) => a - b);
+    // Session IDs follow "project/dateStr-shortId", so the first segment is
+    // the project. Preserve both the ID list and the deduped project set so
+    // downstream renderers can surface which repos produced the cluster.
+    const sessionIds = Object.keys(cl.sessions);
+    const projects = [...new Set(
+      sessionIds.map(s => s.includes('/') ? s.split('/')[0] : 'unknown')
+    )].sort();
     return {
       anchor_signal: cl.anchor_signal,
       tool_pattern: cl.tool_pattern,
       count: cl.count,
       score: cl.count * weight,
-      sessions: Object.keys(cl.sessions).length,
+      sessions: sessionIds.length,
+      session_ids: sessionIds,
+      projects: projects,
       median_peak: peaks[Math.floor(peaks.length / 2)],
       max_peak: peaks[peaks.length - 1],
       contexts: cl.contexts,
@@ -2048,10 +2057,13 @@ function extractMain(sessionsDir) {
 
   // Summary table
   reviewLines.push('## Cluster Summary\n\n');
-  reviewLines.push('| # | Signal | Tool Pattern | Count | Sessions | Score | Median Peak |\n');
-  reviewLines.push('|---|--------|-------------|-------|----------|-------|-------------|\n');
+  reviewLines.push('| # | Signal | Tool Pattern | Count | Sessions | Projects | Score | Median Peak |\n');
+  reviewLines.push('|---|--------|-------------|-------|----------|----------|-------|-------------|\n');
   reviewClusters.forEach((cl, idx) => {
-    reviewLines.push(`| ${idx + 1} | ${cl.anchor_signal} | ${cl.tool_pattern} | ${cl.count} | ${cl.sessions} | ${cl.score} | ${cl.median_peak} |\n`);
+    const projs = cl.projects || [];
+    const projectsShort = projs.slice(0, 3).join(', ') +
+      (projs.length > 3 ? `, +${projs.length - 3}` : '');
+    reviewLines.push(`| ${idx + 1} | ${cl.anchor_signal} | ${cl.tool_pattern} | ${cl.count} | ${cl.sessions} | ${projectsShort || '-'} | ${cl.score} | ${cl.median_peak} |\n`);
   });
   reviewLines.push('\n---\n\n');
 
@@ -2059,6 +2071,9 @@ function extractMain(sessionsDir) {
   reviewClusters.forEach((cl, idx) => {
     reviewLines.push(`## Cluster ${idx + 1}: ${cl.anchor_signal} | ${cl.tool_pattern}\n\n`);
     reviewLines.push(`**Occurrences:** ${cl.count} across ${cl.sessions} sessions | **Score:** ${cl.score} | **Median peak:** ${cl.median_peak} | **Max peak:** ${cl.max_peak}\n\n`);
+    if (cl.projects && cl.projects.length > 0) {
+      reviewLines.push(`**Projects:** ${cl.projects.join(', ')}\n\n`);
+    }
 
     if (cl.contexts.length > 0) {
       reviewLines.push('### User Context (what the user said)\n\n');