@arthai/agents 1.0.3 → 1.0.5

package/README.md

@@ -90,6 +90,28 @@ After installing, use skills in Claude Code:
 /restart                    # restart local dev servers
 ```
 
+## Uninstall
+
+```bash
+npx @arthai/agents uninstall forge .
+```
+
+Remove everything:
+
+```bash
+rm -rf .claude/skills .claude/agents .claude/hooks
+```
+
+Note: hooks merged into `.claude/settings.json` need to be removed manually.
+
+## Troubleshooting
+
+| Problem | Fix |
+|---------|-----|
+| Skills not showing | Restart Claude Code in the project |
+| `/planning` says unknown skill | Verify files exist: `ls .claude/skills/planning/SKILL.md` |
+| Install says "not found in dist/" | Update: `npx @arthai/agents@latest install forge .` |
+
 ## Also available as Claude Code plugin
 
 ```

package/VERSION

@@ -1 +1 @@
-1.0.3
+1.0.5

package/bin/cli.js

@@ -26,6 +26,10 @@ switch (command) {
   case 'info':
     handleInfo(args[1]);
     break;
+  case 'uninstall':
+  case 'remove':
+    handleUninstall(args.slice(1));
+    break;
   case 'legacy':
     handleLegacy(args.slice(1));
     break;
@@ -94,7 +98,13 @@ function handleInstall(rawArgs) {
     process.exit(1);
   }
 
-  const pluginsTargetDir = path.join(targetDir, '.claude', 'plugins');
+  const claudeDir = path.join(targetDir, '.claude');
+  const skillsDir = path.join(claudeDir, 'skills');
+  const agentsDir = path.join(claudeDir, 'agents');
+
+  let totalCommands = 0;
+  let totalAgents = 0;
+  let totalHooks = 0;
 
   for (const name of resolved) {
     // Defense-in-depth: verify the resolved path stays inside PLUGINS_DIR
@@ -107,11 +117,13 @@ function handleInstall(rawArgs) {
       console.error(`Plugin '${name}' not found in dist/plugins/. Run compiler.sh first.`);
       process.exit(1);
     }
-    copyPlugin(pluginDir, pluginsTargetDir, name);
-    console.log(`  Installed: ${name} → ${path.join(pluginsTargetDir, name)}`);
+    const counts = installBundle(pluginDir, claudeDir, skillsDir, agentsDir, name);
+    totalCommands += counts.commands;
+    totalAgents += counts.agents;
+    totalHooks += counts.hooks;
   }
 
-  console.log(`\nDone. ${resolved.length} plugin(s) installed to ${pluginsTargetDir}`);
+  console.log(`\nDone. ${resolved.length} bundle(s) installed: ${totalCommands} skills, ${totalAgents} agents, ${totalHooks} hooks`);
 }
 
 // ── list ──────────────────────────────────────────────────────────────────────
@@ -199,6 +211,71 @@ function handleLegacy(legacyArgs) {
   process.exit(result.status || 0);
 }
 
+// ── uninstall ────────────────────────────────────────────────────────────────
+
+function handleUninstall(rawArgs) {
+  if (rawArgs.length === 0) {
+    console.error('Usage: arthai uninstall <bundle> [bundle...] [target-path]');
+    process.exit(1);
+  }
+
+  const targetDir = looksLikePath(rawArgs[rawArgs.length - 1])
+    ? rawArgs.pop()
+    : process.cwd();
+
+  const bundleNames = rawArgs.filter(a => isValidBundleName(a));
+  if (bundleNames.length === 0) {
+    console.error('No valid bundle names provided.');
+    process.exit(1);
+  }
+
+  const claudeDir = path.join(targetDir, '.claude');
+  const skillsDir = path.join(claudeDir, 'skills');
+  const agentsDir = path.join(claudeDir, 'agents');
+
+  for (const name of bundleNames) {
+    const pluginDir = path.resolve(PLUGINS_DIR, name);
+    if (!fs.existsSync(pluginDir)) {
+      console.error(`Bundle '${name}' not found in dist/plugins/.`);
+      continue;
+    }
+
+    let removed = 0;
+
+    // Remove skills that came from this bundle's commands/
+    const commandsDir = path.join(pluginDir, 'commands');
+    if (fs.existsSync(commandsDir)) {
+      for (const file of fs.readdirSync(commandsDir)) {
+        if (!file.endsWith('.md')) continue;
+        const skillName = file.replace('.md', '');
+        const skillPath = path.join(skillsDir, skillName);
+        if (fs.existsSync(skillPath)) {
+          fs.rmSync(skillPath, { recursive: true });
+          removed++;
+        }
+      }
+    }
+
+    // Remove agents that came from this bundle
+    const srcAgents = path.join(pluginDir, 'agents');
+    if (fs.existsSync(srcAgents)) {
+      for (const file of fs.readdirSync(srcAgents)) {
+        if (!file.endsWith('.md')) continue;
+        const agentPath = path.join(agentsDir, file);
+        if (fs.existsSync(agentPath)) {
+          fs.unlinkSync(agentPath);
+          removed++;
+        }
+      }
+    }
+
+    console.log(`  Removed ${name}: ${removed} files`);
+  }
+
+  console.log('\nNote: hooks in .claude/settings.json were not removed — edit manually if needed.');
+  console.log('Done.');
+}
+
 // ── helpers ───────────────────────────────────────────────────────────────────
 
 // Validate bundle names: only lowercase alphanumeric and hyphens, max 64 chars.
@@ -257,28 +334,76 @@ function resolveDependencies(names) {
   return resolved;
 }
 
-function copyPlugin(sourceDir, targetPluginsDir, name) {
-  const dest = path.join(targetPluginsDir, name);
+function installBundle(pluginDir, claudeDir, skillsDir, agentsDir, name) {
+  const counts = { commands: 0, agents: 0, hooks: 0 };
+
+  // 1. Copy commands/ → .claude/skills/<name>/SKILL.md (each .md becomes a skill dir)
+  const commandsDir = path.join(pluginDir, 'commands');
+  if (fs.existsSync(commandsDir)) {
+    for (const file of fs.readdirSync(commandsDir)) {
+      if (!file.endsWith('.md')) continue;
+      const skillName = file.replace('.md', '');
+      const destDir = path.join(skillsDir, skillName);
+      fs.mkdirSync(destDir, { recursive: true });
+      fs.copyFileSync(path.join(commandsDir, file), path.join(destDir, 'SKILL.md'));
+      counts.commands++;
+    }
+    console.log(`  ${name}: ${counts.commands} skills → ${skillsDir}`);
+  }
 
-  // Remove existing
-  if (fs.existsSync(dest)) {
-    fs.rmSync(dest, { recursive: true });
+  // 2. Copy agents/ → .claude/agents/
+  const srcAgents = path.join(pluginDir, 'agents');
+  if (fs.existsSync(srcAgents)) {
+    fs.mkdirSync(agentsDir, { recursive: true });
+    for (const file of fs.readdirSync(srcAgents)) {
+      if (!file.endsWith('.md')) continue;
+      fs.copyFileSync(path.join(srcAgents, file), path.join(agentsDir, file));
+      counts.agents++;
+    }
+    console.log(`  ${name}: ${counts.agents} agents → ${agentsDir}`);
   }
-  fs.mkdirSync(dest, { recursive: true });
 
-  // Recursive copy
-  copyDirRecursive(sourceDir, dest);
+  // 3. Merge hooks into .claude/settings.json
+  const hooksJson = path.join(pluginDir, 'hooks', 'hooks.json');
+  if (fs.existsSync(hooksJson)) {
+    const pluginHooks = JSON.parse(fs.readFileSync(hooksJson, 'utf8'));
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) { settings = {}; }
+    }
+    if (!settings.hooks) settings.hooks = {};
+
+    // Copy hook scripts to .claude/hooks/
+    const hooksDir = path.join(claudeDir, 'hooks');
+    fs.mkdirSync(hooksDir, { recursive: true });
+    const srcHooksDir = path.join(pluginDir, 'hooks');
+    for (const file of fs.readdirSync(srcHooksDir)) {
+      if (!file.endsWith('.sh')) continue;
+      const dest = path.join(hooksDir, file);
+      fs.copyFileSync(path.join(srcHooksDir, file), dest);
+      fs.chmodSync(dest, 0o755);
+    }
 
-  // Register plugin in .claude/settings.local.json so Claude Code discovers it
-  const projectDir = path.resolve(targetPluginsDir, '..');  // .claude/
-  const settingsPath = path.join(projectDir, 'settings.local.json');
-  let settings = {};
-  if (fs.existsSync(settingsPath)) {
-    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) { settings = {}; }
+    // Merge hook entries (rewrite CLAUDE_PLUGIN_ROOT to project hooks path)
+    const hookData = pluginHooks.hooks || pluginHooks;
+    for (const [event, entries] of Object.entries(hookData)) {
+      if (!settings.hooks[event]) settings.hooks[event] = [];
+      for (const entry of entries) {
+        // Rewrite command paths from ${CLAUDE_PLUGIN_ROOT} to $CLAUDE_PROJECT_DIR/.claude
+        const rewritten = JSON.parse(
+          JSON.stringify(entry).replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, '$CLAUDE_PROJECT_DIR/.claude')
+        );
+        settings.hooks[event].push(rewritten);
+        counts.hooks++;
+      }
+    }
+
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    console.log(`  ${name}: ${counts.hooks} hook entries merged into settings.json`);
   }
-  if (!settings.enabledPlugins) settings.enabledPlugins = {};
-  settings.enabledPlugins[`${name}@local`] = true;
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+
+  return counts;
 }
 
 function copyDirRecursive(src, dest) {

package/dist/plugins/canvas/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "canvas",
   "description": "Design-driven development — adversarial design critique + frontend",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/compass/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "compass",
   "description": "Product strategy — PM, GTM, user research, content strategy",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/counsel/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "counsel",
   "description": "AI consulting toolkit — client discovery, proposals, deliverables",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/cruise/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cruise",
   "description": "Autopilot mode — autonomous task execution (requires forge+scalpel+sentinel)",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/forge/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "forge",
   "description": "Full development workflow — plan, build, test, ship",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/prime/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "prime",
   "description": "Everything — all agents, skills, and hooks in one plugin",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/prism/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "prism",
   "description": "Deep QA — multi-agent testing, baseline tracking, incident analysis",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/scalpel/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "scalpel",
   "description": "Surgical bug fixing — targeted fixes, CI repair, issue triage",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/sentinel/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "sentinel",
   "description": "Operations and reliability — SRE, incidents, deploy monitoring",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/shield/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "shield",
   "description": "Safety guardrails — bash guards, edit protection, session bootstrap",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/dist/plugins/spark/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "spark",
   "description": "Project setup and onboarding — calibrate, scan, bootstrap",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "Arth AI"
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arthai/agents",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "AI-powered development toolkit for Claude Code — agents, skills, and hooks",
   "bin": {
     "arthai": "bin/cli.js"

package/skills/publish/SKILL.md

@@ -216,3 +216,6 @@ Tell the user to test in Claude Code:
 | `marketplace.json not found` | File at repo root instead of `.claude-plugin/` | Move to `.claude-plugin/marketplace.json` |
 | `E403 cannot publish over previous version` | VERSION not bumped | Derive from git tag, not VERSION file |
 | `Plugin directory not found at path` | `source` path in marketplace.json is wrong | Must be `./plugins/<name>` relative to marketplace root |
+| Version defaults to 1.0.0 | `actions/checkout` uses shallow clone, tags not fetched | Add `fetch-depth: 0` and `fetch-tags: true` to checkout step |
+| Skills not showing in Claude Code | Skills in `skills/` not `commands/` | User-invocable skills must be in `commands/` as flat .md files |
+| npx install doesn't register | Files in `.claude/plugins/` not discovered | npx should copy to `.claude/skills/` + `.claude/agents/`, not `.claude/plugins/` |