harness-evolver 0.5.1 → 0.7.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Raphael Valdetaro Christi Cordeiro
+Copyright (c) 2026 Raphael Valdetaro
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/bin/install.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Harness Evolver installer.
- * Interactive setup with runtime selection, global/local choice.
+ * Copies skills/agents/tools directly to runtime directories (GSD pattern).
  *
  * Usage: npx harness-evolver@latest
  */
@@ -15,7 +15,6 @@ const VERSION = require("../package.json").version;
 const PLUGIN_ROOT = path.resolve(__dirname, "..");
 const HOME = process.env.HOME || process.env.USERPROFILE;
 
-// ANSI colors
 const MAGENTA = "\x1b[35m";
 const BRIGHT_MAGENTA = "\x1b[95m";
 const GREEN = "\x1b[32m";
@@ -40,13 +39,6 @@ ${BRIGHT_MAGENTA}  ██╗  ██╗ █████╗ ██████╗
   ╚══════╝  ╚═══╝   ╚═════╝ ╚══════╝ ╚═══╝  ╚══════╝╚═╝  ╚═╝${RESET}
 `;
 
-const RUNTIMES = [
-  { name: "Claude Code", dir: ".claude", detected: () => fs.existsSync(path.join(HOME, ".claude")) },
-  { name: "Cursor", dir: ".cursor", detected: () => fs.existsSync(path.join(HOME, ".cursor")) },
-  { name: "Codex", dir: ".codex", detected: () => fs.existsSync(path.join(HOME, ".codex")) },
-  { name: "Windsurf", dir: ".windsurf", detected: () => fs.existsSync(path.join(HOME, ".windsurf")) },
-];
-
 function ask(rl, question) {
   return new Promise((resolve) => rl.question(question, resolve));
 }
@@ -86,18 +78,18 @@ function installForRuntime(runtimeDir, scope) {
   const commandsDir = path.join(baseDir, "commands", "harness-evolver");
   const agentsDir = path.join(baseDir, "agents");
 
-  // Skills
+  // Skills → commands/harness-evolver/
   const skillsSource = path.join(PLUGIN_ROOT, "skills");
   if (fs.existsSync(skillsSource)) {
     for (const skill of fs.readdirSync(skillsSource, { withFileTypes: true })) {
       if (skill.isDirectory()) {
         copyDir(path.join(skillsSource, skill.name), path.join(commandsDir, skill.name));
-        console.log(`  ${GREEN}✓${RESET} Installed skill: ${skill.name}`);
+        console.log(`  ${GREEN}✓${RESET} Installed command: harness-evolver:${skill.name}`);
       }
     }
   }
 
-  // Agents
+  // Agents → agents/
   const agentsSource = path.join(PLUGIN_ROOT, "agents");
   if (fs.existsSync(agentsSource)) {
     fs.mkdirSync(agentsDir, { recursive: true });
@@ -116,9 +108,9 @@ function installTools() {
     for (const tool of fs.readdirSync(toolsSource)) {
       if (tool.endsWith(".py")) {
         copyFile(path.join(toolsSource, tool), path.join(toolsDir, tool));
-        console.log(`  ${GREEN}✓${RESET} Installed tool: ${tool}`);
       }
     }
+    console.log(`  ${GREEN}✓${RESET} Installed tools to ~/.harness-evolver/tools/`);
   }
 }
 
@@ -127,26 +119,51 @@ function installExamples() {
   const examplesSource = path.join(PLUGIN_ROOT, "examples");
   if (fs.existsSync(examplesSource)) {
     copyDir(examplesSource, examplesDir);
-    console.log(`  ${GREEN}✓${RESET} Installed examples: classifier`);
+    console.log(`  ${GREEN}✓${RESET} Installed examples to ~/.harness-evolver/examples/`);
   }
 }
 
+function cleanupBrokenPluginEntry(runtimeDir) {
+  // Remove the harness-evolver@local entry that doesn't work
+  const installedPath = path.join(HOME, runtimeDir, "plugins", "installed_plugins.json");
+  try {
+    const data = JSON.parse(fs.readFileSync(installedPath, "utf8"));
+    if (data.plugins && data.plugins["harness-evolver@local"]) {
+      delete data.plugins["harness-evolver@local"];
+      fs.writeFileSync(installedPath, JSON.stringify(data, null, 2) + "\n");
+    }
+  } catch {}
+
+  const settingsPath = path.join(HOME, runtimeDir, "settings.json");
+  try {
+    const data = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    if (data.enabledPlugins && data.enabledPlugins["harness-evolver@local"] !== undefined) {
+      delete data.enabledPlugins["harness-evolver@local"];
+      fs.writeFileSync(settingsPath, JSON.stringify(data, null, 2) + "\n");
+    }
+  } catch {}
+}
+
 async function main() {
   console.log(LOGO);
   console.log(`  ${DIM}Harness Evolver v${VERSION}${RESET}`);
   console.log(`  ${DIM}Meta-Harness-style autonomous harness optimization${RESET}`);
   console.log();
 
-  // Check python
   if (!checkPython()) {
     console.error(`  ${RED}ERROR:${RESET} python3 not found in PATH. Install Python 3.8+ first.`);
     process.exit(1);
   }
   console.log(`  ${GREEN}✓${RESET} python3 found`);
 
-  // Detect runtimes
-  const available = RUNTIMES.filter((r) => r.detected());
-  if (available.length === 0) {
+  const RUNTIMES = [
+    { name: "Claude Code", dir: ".claude" },
+    { name: "Cursor", dir: ".cursor" },
+    { name: "Codex", dir: ".codex" },
+    { name: "Windsurf", dir: ".windsurf" },
+  ].filter(r => fs.existsSync(path.join(HOME, r.dir)));
+
+  if (RUNTIMES.length === 0) {
     console.error(`\n  ${RED}ERROR:${RESET} No supported runtime detected.`);
     console.error(`  Install Claude Code, Cursor, Codex, or Windsurf first.`);
     process.exit(1);
@@ -154,76 +171,61 @@ async function main() {
 
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 
-  // Runtime selection
   console.log(`\n  ${YELLOW}Which runtime(s) would you like to install for?${RESET}\n`);
-  available.forEach((r, i) => {
-    console.log(`  ${i + 1}) ${r.name.padEnd(14)} (~/${r.dir})`);
-  });
-  if (available.length > 1) {
-    console.log(`  ${available.length + 1}) All`);
+  RUNTIMES.forEach((r, i) => console.log(`  ${i + 1}) ${r.name.padEnd(14)} (~/${r.dir})`));
+  if (RUNTIMES.length > 1) {
+    console.log(`  ${RUNTIMES.length + 1}) All`);
     console.log(`\n  ${DIM}Select multiple: 1,2 or 1 2${RESET}`);
   }
 
-  const defaultChoice = "1";
-  const runtimeAnswer = await ask(rl, `\n  ${YELLOW}Choice [${defaultChoice}]:${RESET} `);
-  const runtimeInput = (runtimeAnswer.trim() || defaultChoice);
+  const runtimeAnswer = await ask(rl, `\n  ${YELLOW}Choice [1]:${RESET} `);
+  const runtimeInput = (runtimeAnswer.trim() || "1");
 
-  let selectedRuntimes;
-  if (runtimeInput === String(available.length + 1)) {
-    selectedRuntimes = available;
+  let selected;
+  if (runtimeInput === String(RUNTIMES.length + 1)) {
+    selected = RUNTIMES;
   } else {
-    const indices = runtimeInput.split(/[,\s]+/).map((s) => parseInt(s, 10) - 1);
-    selectedRuntimes = indices
-      .filter((i) => i >= 0 && i < available.length)
-      .map((i) => available[i]);
-  }
-
-  if (selectedRuntimes.length === 0) {
-    selectedRuntimes = [available[0]];
+    const indices = runtimeInput.split(/[,\s]+/).map(s => parseInt(s, 10) - 1);
+    selected = indices.filter(i => i >= 0 && i < RUNTIMES.length).map(i => RUNTIMES[i]);
   }
+  if (selected.length === 0) selected = [RUNTIMES[0]];
 
-  // Scope selection
   console.log(`\n  ${YELLOW}Where would you like to install?${RESET}\n`);
-  console.log(`  1) Global  (~/${selectedRuntimes[0].dir}) - available in all projects`);
-  console.log(`  2) Local   (./${selectedRuntimes[0].dir}) - this project only`);
+  console.log(`  1) Global  (~/${selected[0].dir}) - available in all projects`);
+  console.log(`  2) Local   (./${selected[0].dir}) - this project only`);
 
   const scopeAnswer = await ask(rl, `\n  ${YELLOW}Choice [1]:${RESET} `);
   const scope = (scopeAnswer.trim() === "2") ? "local" : "global";
 
   console.log();
 
-  // Install for each selected runtime
-  for (const runtime of selectedRuntimes) {
-    const target = scope === "local" ? `./${runtime.dir}` : `~/${runtime.dir}`;
-    console.log(`  Installing for ${BRIGHT_MAGENTA}${runtime.name}${RESET} to ${target}`);
-    console.log();
+  for (const runtime of selected) {
+    console.log(`  Installing for ${BRIGHT_MAGENTA}${runtime.name}${RESET}\n`);
+    cleanupBrokenPluginEntry(runtime.dir);
     installForRuntime(runtime.dir, scope);
+    console.log();
   }
 
-  // Tools and examples are always global
   installTools();
   installExamples();
 
-  // Write version file
   const versionPath = path.join(HOME, ".harness-evolver", "VERSION");
   fs.mkdirSync(path.dirname(versionPath), { recursive: true });
   fs.writeFileSync(versionPath, VERSION);
-  console.log(`  ${GREEN}✓${RESET} Wrote VERSION (${VERSION})`);
+  console.log(`  ${GREEN}✓${RESET} VERSION ${VERSION}`);
 
-  console.log(`\n  ${GREEN}Done!${RESET} Open a project in Claude Code and run ${BRIGHT_MAGENTA}/harness-evolver:init${RESET}`);
+  console.log(`\n  ${GREEN}Done!${RESET} Run ${BRIGHT_MAGENTA}/reload-plugins${RESET} in Claude Code, then ${BRIGHT_MAGENTA}/harness-evolver:init${RESET}`);
   console.log(`\n  ${DIM}Quick start with example:${RESET}`);
   console.log(`    cp -r ~/.harness-evolver/examples/classifier ./my-project`);
   console.log(`    cd my-project && claude`);
   console.log(`    /harness-evolver:init`);
   console.log(`    /harness-evolver:evolve`);
-
-  console.log(`\n  ${DIM}GitHub: https://github.com/raphaelchristi/harness-evolver${RESET}`);
-  console.log();
+  console.log(`\n  ${DIM}GitHub: https://github.com/raphaelchristi/harness-evolver${RESET}\n`);
 
   rl.close();
 }
 
-main().catch((err) => {
+main().catch(err => {
   console.error(`  ${RED}ERROR:${RESET} ${err.message}`);
   process.exit(1);
 });

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "harness-evolver",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Meta-Harness-style autonomous harness optimization for Claude Code",
-  "author": "Raphael Valdetaro Christi Cordeiro",
+  "author": "Raphael Valdetaro",
   "license": "MIT",
   "repository": {
     "type": "git",

package/skills/compare/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: compare
+name: harness-evolver:compare
 description: "Use when the user wants to compare two harness versions, understand what changed between iterations, see why one version scored better than another, or debug a regression."
 argument-hint: "<vA> <vB>"
 allowed-tools: [Read, Bash, Glob, Grep]

package/skills/deploy/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: deploy
+name: harness-evolver:deploy
 description: "Use when the user wants to use the best evolved harness in their project, promote a version to production, copy the winning harness back, or is done evolving and wants to apply the result."
 argument-hint: "[version]"
 allowed-tools: [Read, Write, Bash, Glob]

package/skills/diagnose/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: diagnose
+name: harness-evolver:diagnose
 description: "Use when the user wants to understand why a specific harness version failed, investigate a regression, analyze trace data, or debug a low score. Also use when the user says 'why did v003 fail' or 'what went wrong'."
 argument-hint: "[version]"
 allowed-tools: [Read, Bash, Glob, Grep]

package/skills/evolve/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: evolve
+name: harness-evolver:evolve
 description: "Use when the user wants to run the optimization loop, improve harness performance, evolve the harness, or iterate on harness quality. Requires .harness-evolver/ to exist (run harness-evolver:init first)."
 argument-hint: "[--iterations N]"
 allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Agent]

package/skills/init/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: init
+name: harness-evolver:init
 description: "Use when the user wants to set up harness optimization in their project, optimize an LLM agent, improve a harness, or mentions harness-evolver for the first time in a project without .harness-evolver/ directory."
 argument-hint: "[directory]"
 allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Agent]

package/skills/status/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: status
+name: harness-evolver:status
 description: "Use when the user asks about evolution progress, current scores, best harness version, how many iterations ran, or whether the loop is stagnating. Also use when the user says 'status', 'progress', or 'how is it going'."
 allowed-tools: [Read, Bash]
 ---