devlyn-cli 0.5.4 → 0.5.7

package/bin/devlyn.js

@@ -6,10 +6,46 @@ const readline = require('readline');
 const { execSync } = require('child_process');
 
 const CONFIG_SOURCE = path.join(__dirname, '..', 'config');
+const AGENTS_SOURCE = path.join(__dirname, '..', 'config', 'agents');
 const OPTIONAL_SKILLS_SOURCE = path.join(__dirname, '..', 'optional-skills');
 const OPTIONAL_COMMANDS_SOURCE = path.join(__dirname, '..', 'optional-commands');
 const PKG = require('../package.json');
 
+// Cross-CLI agent installation targets
+// Each entry maps a CLI tool to where its agent instructions should be placed
+const CLI_TARGETS = {
+  codex: {
+    name: 'Codex CLI (OpenAI)',
+    instructionsFile: 'AGENTS.md',
+    configDir: null, // Codex uses AGENTS.md at project root
+    detect: () => fs.existsSync(path.join(process.cwd(), 'AGENTS.md')) || fs.existsSync(path.join(process.cwd(), '.codex')),
+  },
+  gemini: {
+    name: 'Gemini CLI (Google)',
+    instructionsFile: 'GEMINI.md',
+    configDir: null, // Gemini uses GEMINI.md at project root
+    detect: () => fs.existsSync(path.join(process.cwd(), 'GEMINI.md')) || fs.existsSync(path.join(process.cwd(), '.gemini')),
+  },
+  cursor: {
+    name: 'Cursor',
+    instructionsFile: '.cursorrules',
+    configDir: '.cursor/rules',
+    detect: () => fs.existsSync(path.join(process.cwd(), '.cursorrules')) || fs.existsSync(path.join(process.cwd(), '.cursor')),
+  },
+  copilot: {
+    name: 'GitHub Copilot',
+    instructionsFile: '.github/copilot-instructions.md',
+    configDir: '.github/copilot/agents',
+    detect: () => fs.existsSync(path.join(process.cwd(), '.github', 'copilot-instructions.md')) || fs.existsSync(path.join(process.cwd(), '.github', 'copilot')),
+  },
+  windsurf: {
+    name: 'Windsurf',
+    instructionsFile: '.windsurfrules',
+    configDir: '.windsurf/rules',
+    detect: () => fs.existsSync(path.join(process.cwd(), '.windsurfrules')) || fs.existsSync(path.join(process.cwd(), '.windsurf')),
+  },
+};
+
 // Files removed in previous versions that should be cleaned up on upgrade
 const DEPRECATED_FILES = [
   'commands/devlyn.handoff.md', // removed in v0.2.0
@@ -78,6 +114,7 @@ const OPTIONAL_ADDONS = [
   { name: 'supabase/agent-skills', desc: 'Supabase integration patterns', type: 'external' },
   { name: 'coreyhaines31/marketingskills', desc: 'Marketing automation and content skills', type: 'external' },
   { name: 'anthropics/skills', desc: 'Official Anthropic skill-creator with eval framework and description optimizer', type: 'external' },
+  { name: 'Leonxlnx/taste-skill', desc: 'Premium frontend design skills — modern layouts, animations, and visual refinement', type: 'external' },
 ];
 
 function log(msg, color = 'reset') {
@@ -371,6 +408,77 @@ function installAddon(addon) {
   return installSkillPack(addon.name);
 }
 
+function detectOtherCLIs() {
+  const detected = [];
+  for (const [key, cli] of Object.entries(CLI_TARGETS)) {
+    if (cli.detect()) {
+      detected.push(key);
+    }
+  }
+  return detected;
+}
+
+function installAgentsForCLI(cliKey) {
+  const cli = CLI_TARGETS[cliKey];
+  if (!cli) return false;
+  if (!fs.existsSync(AGENTS_SOURCE)) return false;
+
+  const agents = fs.readdirSync(AGENTS_SOURCE).filter((f) => f.endsWith('.md'));
+  if (agents.length === 0) return false;
+
+  log(`\n🤖 Installing agents for ${cli.name}...`, 'cyan');
+
+  if (cli.configDir) {
+    // CLI supports an agents directory — copy agent files there
+    const destDir = path.join(process.cwd(), cli.configDir);
+    if (!fs.existsSync(destDir)) {
+      fs.mkdirSync(destDir, { recursive: true });
+    }
+    for (const file of agents) {
+      const src = path.join(AGENTS_SOURCE, file);
+      const dest = path.join(destDir, file);
+      fs.copyFileSync(src, dest);
+      log(`  → ${cli.configDir}/${file}`, 'dim');
+    }
+  } else {
+    // CLI uses a single instructions file — append agent content
+    const destFile = path.join(process.cwd(), cli.instructionsFile);
+    const separator = '\n\n---\n\n# Devlyn Agent Instructions\n\n';
+    const agentContent = agents.map((file) => {
+      return fs.readFileSync(path.join(AGENTS_SOURCE, file), 'utf8');
+    }).join('\n\n---\n\n');
+
+    let existing = '';
+    if (fs.existsSync(destFile)) {
+      existing = fs.readFileSync(destFile, 'utf8');
+      // Remove previous devlyn agent section if present
+      const devlynMarker = '# Devlyn Agent Instructions';
+      const markerIdx = existing.indexOf(devlynMarker);
+      if (markerIdx > 0) {
+        // Find the separator before the marker (---\n\n)
+        const sepIdx = existing.lastIndexOf('---', markerIdx);
+        existing = existing.slice(0, sepIdx > 0 ? sepIdx : markerIdx).trimEnd();
+      }
+    }
+
+    fs.writeFileSync(destFile, existing + separator + agentContent + '\n');
+    log(`  → ${cli.instructionsFile} (agent instructions appended)`, 'dim');
+  }
+
+  return true;
+}
+
+function installAgentsForAllDetected() {
+  const detected = detectOtherCLIs();
+  if (detected.length === 0) return 0;
+
+  let installed = 0;
+  for (const cliKey of detected) {
+    if (installAgentsForCLI(cliKey)) installed++;
+  }
+  return installed;
+}
+
 async function init(skipPrompts = false) {
   showLogo();
   log('─'.repeat(44), 'dim');
@@ -416,6 +524,16 @@ async function init(skipPrompts = false) {
     log('  → settings.json (agent teams enabled)', 'dim');
   }
 
+  // Install agents for other detected CLIs
+  const detected = detectOtherCLIs();
+  if (detected.length > 0) {
+    log(`\n🔍 Detected other AI CLIs: ${detected.map((k) => CLI_TARGETS[k].name).join(', ')}`, 'blue');
+    const agentsInstalled = installAgentsForAllDetected();
+    if (agentsInstalled > 0) {
+      log(`  ✅ Agent instructions installed for ${agentsInstalled} CLI${agentsInstalled > 1 ? 's' : ''}`, 'green');
+    }
+  }
+
   log('\n✅ Core config installed!', 'green');
 
   // Skip prompts if -y flag or non-interactive
@@ -453,10 +571,12 @@ async function init(skipPrompts = false) {
 function showHelp() {
   showLogo();
   log('Usage:', 'green');
-  log('  npx devlyn-cli          Install/update .claude config');
-  log('  npx devlyn-cli list     List available commands & templates');
-  log('  npx devlyn-cli -y       Install without prompts');
-  log('  npx devlyn-cli --help   Show this help\n');
+  log('  npx devlyn-cli              Install/update .claude config');
+  log('  npx devlyn-cli list         List available commands & templates');
+  log('  npx devlyn-cli -y           Install without prompts');
+  log('  npx devlyn-cli agents       Install agents for detected CLIs');
+  log('  npx devlyn-cli agents all   Install agents for all supported CLIs');
+  log('  npx devlyn-cli --help       Show this help\n');
   log('Optional skills (select during install):', 'green');
   OPTIONAL_ADDONS.filter((a) => a.type === 'local').forEach((skill) => {
     log(`  ${skill.name}  ${COLORS.dim}${skill.desc}${COLORS.reset}`);
@@ -465,6 +585,10 @@ function showHelp() {
   OPTIONAL_ADDONS.filter((a) => a.type === 'external').forEach((pack) => {
     log(`  npx skills add ${pack.name}`);
   });
+  log('\nSupported CLIs for agent installation:', 'green');
+  for (const [key, cli] of Object.entries(CLI_TARGETS)) {
+    log(`  ${key.padEnd(10)} ${cli.name}`);
+  }
   log('');
 }
 
@@ -485,6 +609,38 @@ switch (command) {
   case 'ls':
     listContents();
     break;
+  case 'agents': {
+    showLogo();
+    log('─'.repeat(44), 'dim');
+    const subArg = args[1];
+    if (subArg === 'all') {
+      // Install for all supported CLIs regardless of detection
+      log('\n🤖 Installing agents for all supported CLIs...', 'blue');
+      let count = 0;
+      for (const cliKey of Object.keys(CLI_TARGETS)) {
+        if (installAgentsForCLI(cliKey)) count++;
+      }
+      log(`\n✅ Agents installed for ${count} CLI${count !== 1 ? 's' : ''}`, 'green');
+    } else if (subArg && CLI_TARGETS[subArg]) {
+      // Install for a specific CLI
+      installAgentsForCLI(subArg);
+      log('\n✅ Done!', 'green');
+    } else {
+      // Auto-detect and install
+      const detected = detectOtherCLIs();
+      if (detected.length === 0) {
+        log('\n🔍 No other AI CLIs detected in this project.', 'yellow');
+        log('   Use `npx devlyn-cli agents all` to install for all supported CLIs', 'dim');
+        log(`   Supported: ${Object.keys(CLI_TARGETS).join(', ')}`, 'dim');
+      } else {
+        log(`\n🔍 Detected: ${detected.map((k) => CLI_TARGETS[k].name).join(', ')}`, 'blue');
+        const count = installAgentsForAllDetected();
+        log(`\n✅ Agents installed for ${count} CLI${count !== 1 ? 's' : ''}`, 'green');
+      }
+    }
+    log('');
+    break;
+  }
   case 'init':
   case undefined:
     init(false);

package/config/agents/evaluator.md

@@ -0,0 +1,40 @@
+# Evaluator Agent
+
+You are a code quality evaluator. Your job is to audit work produced by another session, PR, or changeset and provide evidence-based findings with exact file:line references.
+
+## Evaluation Process
+
+1. **Discover scope**: Read the changeset (git diff, PR diff, or specified files)
+2. **Assess correctness**: Find bugs, logic errors, silent failures, missing error handling
+3. **Check architecture**: Verify patterns match existing codebase, no type duplication, proper wiring
+4. **Verify spec compliance**: If a spec exists (HANDOFF.md, RFC, issue), compare requirements vs implementation
+5. **Check error handling**: Every async operation needs loading, error, and empty states in UI. No silent catches.
+6. **Review API contracts**: New endpoints must follow existing conventions for naming, validation, error envelopes
+7. **Assess test coverage**: New modules need tests. Run the test suite and report results.
+
+## Rules
+
+- Every finding must have a file:line reference. No guesswork.
+- Classify by severity: CRITICAL (must fix), HIGH (should fix), MEDIUM (fix or justify), LOW (note)
+- Call out what's done well, not just problems
+- Look for cross-cutting patterns (e.g., same mistake repeated in multiple files)
+
+## Output Format
+
+```
+### Verdict: [PASS / PASS WITH ISSUES / NEEDS WORK / BLOCKED]
+
+**Findings by Severity:**
+
+CRITICAL:
+- [domain] `file:line` - description
+
+HIGH:
+- [domain] `file:line` - description
+
+**What's Good:**
+- [positive observations]
+
+**Recommendation:**
+[next action]
+```