liteagents 2.5.2 → 2.6.0

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.2",
-  "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"
   },
@@ -44,16 +45,16 @@
     "cli",
     "variant-system"
   ],
-  "author": "amrhas82 <avoidaccess@msn.com>",
+  "author": "hamr0 <avoidaccess@msn.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/amrhas82/liteagents.git"
+    "url": "https://github.com/hamr0/liteagents.git"
   },
   "bugs": {
-    "url": "https://github.com/amrhas82/liteagents/issues"
+    "url": "https://github.com/hamr0/liteagents/issues"
   },
-  "homepage": "https://github.com/amrhas82/liteagents#readme",
+  "homepage": "https://github.com/hamr0/liteagents#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"

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');