prr-kit 1.0.0 → 1.1.1

package/tools/cli/installers/lib/core/installer.js

@@ -1,162 +1,162 @@
-/**
- * Installer — main installation orchestrator
- * Main installation orchestrator for PR Review Framework
- */
-const path = require('node:path');
-const fs = require('fs-extra');
-const { Manifest } = require('./manifest');
-const { ManifestGenerator } = require('./manifest-generator');
-const { ConfigCollector } = require('./config-collector');
-const { Detector, PRR_FOLDER_NAME } = require('./detector');
-const { IdeManager } = require('../ide/manager');
-const { compileAgent } = require('../../../lib/agent/compiler');
-const prompts = require('../../../lib/prompts');
-const packageJson = require('../../../../../package.json');
-
-const SRC_DIR = path.join(__dirname, '..', '..', '..', '..', '..', 'src');
-const TEXT_EXTENSIONS = new Set(['.md', '.yaml', '.yml', '.txt', '.json', '.js', '.csv', '.xml', '.toml']);
-
-class Installer {
-  constructor() {
-    this.manifest = new Manifest();
-    this.manifestGenerator = new ManifestGenerator();
-    this.configCollector = new ConfigCollector();
-    this.detector = new Detector();
-    this.ideManager = new IdeManager();
-  }
-
-  async install(config) {
-    const { projectDir, selectedModules = ['prr'], selectedIdes = [], actionType = 'install' } = config;
-
-    await this.ideManager.ensureInitialized();
-
-    const prrDir = path.join(projectDir, PRR_FOLDER_NAME);
-    await fs.ensureDir(prrDir);
-
-    await prompts.log.step(`Installing PR Review to ${projectDir}...`);
-
-    // Copy module files from src/
-    const modulesToInstall = ['core', ...selectedModules.filter((m) => m !== 'core')];
-    for (const mod of modulesToInstall) {
-      const srcModDir = path.join(SRC_DIR, mod === 'core' ? 'core' : mod);
-      const dstModDir = path.join(prrDir, mod);
-
-      if (!(await fs.pathExists(srcModDir))) {
-        await prompts.log.warn(`Module '${mod}' not found in src/ — skipping`);
-        continue;
-      }
-
-      await fs.remove(dstModDir);
-      await this.copyModuleFiles(srcModDir, dstModDir);
-      await prompts.log.info(`  ✓ Module '${mod}' installed`);
-    }
-
-    // Compile agents (YAML → XML/MD)
-    await this.compileModuleAgents(prrDir, modulesToInstall);
-
-    // Write config files
-    await this.configCollector.writeConfigs(prrDir, config);
-    await prompts.log.info('  ✓ Configuration written');
-
-    // Create output directories
-    const outputFolderAbs = path.join(projectDir, config.outputFolder || '_prr-output');
-    await fs.ensureDir(path.join(outputFolderAbs, 'reviews'));
-    await prompts.log.info('  ✓ Output directories created');
-
-    // Generate manifests
-    const cfgDir = path.join(prrDir, '_config');
-    await fs.ensureDir(cfgDir);
-    await this.manifestGenerator.generateManifests(prrDir, selectedModules);
-    await this.manifest.create(prrDir, {
-      version: packageJson.version,
-      modules: modulesToInstall,
-      ides: selectedIdes,
-    });
-    await prompts.log.info('  ✓ Manifests generated');
-
-    // Configure IDEs
-    for (const ide of selectedIdes) {
-      const result = await this.ideManager.setup(ide, projectDir, prrDir, { selectedModules: modulesToInstall });
-      if (result.success) {
-        await prompts.log.info(`  ✓ ${ide} configured (${result.detail || 'done'})`);
-      }
-    }
-
-    await prompts.log.success('PR Review installed successfully!');
-    await prompts.log.info('Open your AI IDE and use the reviewer agents to start reviewing PRs.');
-
-    return { success: true };
-  }
-
-  async copyModuleFiles(srcDir, dstDir) {
-    await fs.ensureDir(dstDir);
-    const entries = await fs.readdir(srcDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const srcPath = path.join(srcDir, entry.name);
-      const dstPath = path.join(dstDir, entry.name);
-
-      if (entry.isDirectory()) {
-        await this.copyModuleFiles(srcPath, dstPath);
-      } else {
-        const ext = path.extname(entry.name).toLowerCase();
-        if (TEXT_EXTENSIONS.has(ext)) {
-          const content = await fs.readFile(srcPath, 'utf8');
-          await fs.ensureDir(path.dirname(dstPath));
-          await fs.writeFile(dstPath, content, 'utf8');
-        } else {
-          await fs.copy(srcPath, dstPath, { overwrite: true });
-        }
-      }
-    }
-  }
-
-  async compileModuleAgents(prrDir, modules) {
-    for (const mod of modules) {
-      const agentsYamlDir = path.join(prrDir, mod, 'agents');
-      if (!(await fs.pathExists(agentsYamlDir))) continue;
-
-      const files = await fs.readdir(agentsYamlDir);
-      for (const file of files) {
-        if (!file.endsWith('.agent.yaml')) continue;
-
-        const yamlPath = path.join(agentsYamlDir, file);
-        const baseName = file.replace('.agent.yaml', '');
-        const outputPath = path.join(agentsYamlDir, `${baseName}.md`);
-
-        try {
-          const yamlContent = await fs.readFile(yamlPath, 'utf8');
-          const { xml } = await compileAgent(yamlContent, {}, baseName, `_prr/${mod}/agents/${baseName}.md`);
-          await fs.writeFile(outputPath, xml, 'utf8');
-        } catch (err) {
-          await prompts.log.warn(`  Warning: Could not compile agent ${file}: ${err.message}`);
-        }
-      }
-    }
-  }
-
-  async uninstall(projectDir) {
-    const prrDir = path.join(projectDir, PRR_FOLDER_NAME);
-    if (await fs.pathExists(prrDir)) {
-      await fs.remove(prrDir);
-    }
-    // Also clean IDE configurations
-    await this.ideManager.ensureInitialized();
-    await this.ideManager.cleanup(projectDir);
-  }
-
-  async quickUpdate(config) {
-    const { projectDir } = config;
-    const existing = await this.detector.detect(projectDir);
-    if (!existing.installed) {
-      throw new Error('PR Review is not installed in this directory.');
-    }
-    return this.install({ ...config, selectedModules: existing.modules, selectedIdes: existing.ides });
-  }
-
-  async status(projectDir) {
-    return this.detector.detect(projectDir);
-  }
-}
-
-module.exports = { Installer };
+/**
+ * Installer — main installation orchestrator
+ * Main installation orchestrator for PR Review Kit
+ */
+const path = require('node:path');
+const fs = require('fs-extra');
+const { Manifest } = require('./manifest');
+const { ManifestGenerator } = require('./manifest-generator');
+const { ConfigCollector } = require('./config-collector');
+const { Detector, PRR_FOLDER_NAME } = require('./detector');
+const { IdeManager } = require('../ide/manager');
+const { compileAgent } = require('../../../lib/agent/compiler');
+const prompts = require('../../../lib/prompts');
+const packageJson = require('../../../../../package.json');
+
+const SRC_DIR = path.join(__dirname, '..', '..', '..', '..', '..', 'src');
+const TEXT_EXTENSIONS = new Set(['.md', '.yaml', '.yml', '.txt', '.json', '.js', '.csv', '.xml', '.toml']);
+
+class Installer {
+  constructor() {
+    this.manifest = new Manifest();
+    this.manifestGenerator = new ManifestGenerator();
+    this.configCollector = new ConfigCollector();
+    this.detector = new Detector();
+    this.ideManager = new IdeManager();
+  }
+
+  async install(config) {
+    const { projectDir, selectedModules = ['prr'], selectedIdes = [], actionType = 'install' } = config;
+
+    await this.ideManager.ensureInitialized();
+
+    const prrDir = path.join(projectDir, PRR_FOLDER_NAME);
+    await fs.ensureDir(prrDir);
+
+    await prompts.log.step(`Installing PR Review to ${projectDir}...`);
+
+    // Copy module files from src/
+    const modulesToInstall = ['core', ...selectedModules.filter((m) => m !== 'core')];
+    for (const mod of modulesToInstall) {
+      const srcModDir = path.join(SRC_DIR, mod === 'core' ? 'core' : mod);
+      const dstModDir = path.join(prrDir, mod);
+
+      if (!(await fs.pathExists(srcModDir))) {
+        await prompts.log.warn(`Module '${mod}' not found in src/ — skipping`);
+        continue;
+      }
+
+      await fs.remove(dstModDir);
+      await this.copyModuleFiles(srcModDir, dstModDir);
+      await prompts.log.info(`  ✓ Module '${mod}' installed`);
+    }
+
+    // Compile agents (YAML → XML/MD)
+    await this.compileModuleAgents(prrDir, modulesToInstall);
+
+    // Write config files
+    await this.configCollector.writeConfigs(prrDir, config);
+    await prompts.log.info('  ✓ Configuration written');
+
+    // Create output directories
+    const outputFolderAbs = path.join(projectDir, config.outputFolder || '_prr-output');
+    await fs.ensureDir(path.join(outputFolderAbs, 'reviews'));
+    await prompts.log.info('  ✓ Output directories created');
+
+    // Generate manifests
+    const cfgDir = path.join(prrDir, '_config');
+    await fs.ensureDir(cfgDir);
+    await this.manifestGenerator.generateManifests(prrDir, selectedModules);
+    await this.manifest.create(prrDir, {
+      version: packageJson.version,
+      modules: modulesToInstall,
+      ides: selectedIdes,
+    });
+    await prompts.log.info('  ✓ Manifests generated');
+
+    // Configure IDEs
+    for (const ide of selectedIdes) {
+      const result = await this.ideManager.setup(ide, projectDir, prrDir, { selectedModules: modulesToInstall });
+      if (result.success) {
+        await prompts.log.info(`  ✓ ${ide} configured (${result.detail || 'done'})`);
+      }
+    }
+
+    await prompts.log.success('PR Review installed successfully!');
+    await prompts.log.info('Open your AI IDE and use the reviewer agents to start reviewing PRs.');
+
+    return { success: true };
+  }
+
+  async copyModuleFiles(srcDir, dstDir) {
+    await fs.ensureDir(dstDir);
+    const entries = await fs.readdir(srcDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const srcPath = path.join(srcDir, entry.name);
+      const dstPath = path.join(dstDir, entry.name);
+
+      if (entry.isDirectory()) {
+        await this.copyModuleFiles(srcPath, dstPath);
+      } else {
+        const ext = path.extname(entry.name).toLowerCase();
+        if (TEXT_EXTENSIONS.has(ext)) {
+          const content = await fs.readFile(srcPath, 'utf8');
+          await fs.ensureDir(path.dirname(dstPath));
+          await fs.writeFile(dstPath, content, 'utf8');
+        } else {
+          await fs.copy(srcPath, dstPath, { overwrite: true });
+        }
+      }
+    }
+  }
+
+  async compileModuleAgents(prrDir, modules) {
+    for (const mod of modules) {
+      const agentsYamlDir = path.join(prrDir, mod, 'agents');
+      if (!(await fs.pathExists(agentsYamlDir))) continue;
+
+      const files = await fs.readdir(agentsYamlDir);
+      for (const file of files) {
+        if (!file.endsWith('.agent.yaml')) continue;
+
+        const yamlPath = path.join(agentsYamlDir, file);
+        const baseName = file.replace('.agent.yaml', '');
+        const outputPath = path.join(agentsYamlDir, `${baseName}.md`);
+
+        try {
+          const yamlContent = await fs.readFile(yamlPath, 'utf8');
+          const { xml } = await compileAgent(yamlContent, {}, baseName, `_prr/${mod}/agents/${baseName}.md`);
+          await fs.writeFile(outputPath, xml, 'utf8');
+        } catch (err) {
+          await prompts.log.warn(`  Warning: Could not compile agent ${file}: ${err.message}`);
+        }
+      }
+    }
+  }
+
+  async uninstall(projectDir) {
+    const prrDir = path.join(projectDir, PRR_FOLDER_NAME);
+    if (await fs.pathExists(prrDir)) {
+      await fs.remove(prrDir);
+    }
+    // Also clean IDE configurations
+    await this.ideManager.ensureInitialized();
+    await this.ideManager.cleanup(projectDir);
+  }
+
+  async quickUpdate(config) {
+    const { projectDir } = config;
+    const existing = await this.detector.detect(projectDir);
+    if (!existing.installed) {
+      throw new Error('PR Review is not installed in this directory.');
+    }
+    return this.install({ ...config, selectedModules: existing.modules, selectedIdes: existing.ides });
+  }
+
+  async status(projectDir) {
+    return this.detector.detect(projectDir);
+  }
+}
+
+module.exports = { Installer };

package/tools/cli/installers/lib/ide/_config-driven.js

@@ -17,6 +17,11 @@ class ConfigDrivenIdeSetup extends BaseIdeSetup {
   async setup(projectDir, prrDir, options = {}) {
     if (!this.installerConfig) return { success: false, reason: 'no-config' };
 
+    // Multi-target support (e.g. opencode: agents → one dir, workflows → another)
+    if (this.installerConfig.targets) {
+      return this._setupMultiTarget(projectDir, prrDir, options);
+    }
+
     await this.cleanup(projectDir, options);
 
     const { target_dir, template_type } = this.installerConfig;
@@ -114,6 +119,71 @@ class ConfigDrivenIdeSetup extends BaseIdeSetup {
     return { success: true, results };
   }
 
+  async _setupMultiTarget(projectDir, prrDir, options = {}) {
+    const results = { agents: 0, workflows: 0 };
+    const selectedModules = options.selectedModules || ['prr'];
+    const allModules = ['core', ...selectedModules.filter((m) => m !== 'core')];
+
+    for (const target of this.installerConfig.targets) {
+      const { target_dir, template_type, artifact_types } = target;
+      const targetPath = path.join(projectDir, target_dir);
+      await this.ensureDir(targetPath);
+
+      const installAgents = !artifact_types || artifact_types.includes('agents');
+      const installWorkflows = !artifact_types || artifact_types.includes('workflows');
+
+      if (installAgents) {
+        for (const mod of allModules) {
+          const agentsDir = path.join(prrDir, mod, 'agents');
+          if (!(await fs.pathExists(agentsDir))) continue;
+          const agentFiles = await glob('**/*.md', { cwd: agentsDir });
+          for (const agentFile of agentFiles) {
+            const agentContent = await fs.readFile(path.join(agentsDir, agentFile), 'utf8');
+            if (/^no-launcher:\s*true/m.test(agentContent)) continue;
+            const nameMatch = agentContent.match(/^name:\s*[\"']?([^\"'\n]+)[\"']?/m);
+            const descMatch = agentContent.match(/^description:\s*[\"']?([^\"'\n]+)[\"']?/m);
+            const agentName = nameMatch?.[1]?.trim() || path.basename(agentFile, '.md');
+            const agentDesc = descMatch?.[1]?.trim() || `${agentName} reviewer`;
+            const relAgentPath = `${mod}/agents/${agentFile}`.replaceAll('\\', '/');
+            const launcherContent = this.generateAgentLauncher(agentName, agentDesc, relAgentPath, template_type);
+            const launcherFileName = `${path.basename(agentFile, '.md')}.md`;
+            await fs.writeFile(path.join(targetPath, launcherFileName), launcherContent, 'utf8');
+            results.agents++;
+          }
+        }
+      }
+
+      if (installWorkflows) {
+        for (const mod of allModules) {
+          const workflowsDir = path.join(prrDir, mod, 'workflows');
+          if (!(await fs.pathExists(workflowsDir))) continue;
+          const workflowFiles = await glob('**/workflow{.md,.yaml}', { cwd: workflowsDir });
+          for (const wfFile of workflowFiles) {
+            const wfContent = await fs.readFile(path.join(workflowsDir, wfFile), 'utf8');
+            let wfName = path.basename(path.dirname(wfFile));
+            let wfDesc = '';
+            if (wfFile.endsWith('.yaml')) {
+              try { const d = require('yaml').parse(wfContent); wfName = d.name || wfName; wfDesc = d.description || ''; } catch { /* ignore */ }
+            } else {
+              const normalized = wfContent.replace(/\r\n/g, '\n');
+              const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+              if (fmMatch) { try { const fm = require('yaml').parse(fmMatch[1]); wfName = fm.name || wfName; wfDesc = fm.description || ''; } catch { /* ignore */ } }
+            }
+            const dirParts = path.dirname(wfFile).split(path.sep).filter(Boolean);
+            const leafDir = dirParts.at(-1) || wfName;
+            const relWfPath = `${mod}/workflows/${wfFile}`.replaceAll('\\', '/');
+            const launcherContent = this.generateWorkflowLauncher(wfName, wfDesc, relWfPath, template_type);
+            const launcherFileName = `prr-${leafDir}.md`;
+            await fs.writeFile(path.join(targetPath, launcherFileName), launcherContent, 'utf8');
+            results.workflows++;
+          }
+        }
+      }
+    }
+
+    return { success: true, results };
+  }
+
   generateAgentLauncher(name, description, agentRelPath, templateType) {
     const template = this.loadTemplate(`${templateType}-agent`) || this.loadTemplate('default-agent');
     return template

package/tools/cli/installers/lib/ide/codex.js

@@ -0,0 +1,128 @@
+/**
+ * Codex CLI setup handler
+ * Installs prompts to ~/.codex/prompts (global) or .codex/prompts (project)
+ */
+const path = require('node:path');
+const os = require('node:os');
+const { BaseIdeSetup } = require('./_base-ide');
+const fs = require('fs-extra');
+const { glob } = require('glob');
+const yaml = require('yaml');
+
+class CodexSetup extends BaseIdeSetup {
+  constructor() {
+    super('codex', 'Codex', false);
+  }
+
+  async setup(projectDir, prrDir, options = {}) {
+    const installLocation = options.preCollectedConfig?.installLocation || 'global';
+    const destDir = this._getPromptDir(projectDir, installLocation);
+    await fs.ensureDir(destDir);
+    await this._clearPrrFiles(destDir);
+
+    const selectedModules = options.selectedModules || ['prr'];
+    const allModules = ['core', ...selectedModules.filter((m) => m !== 'core')];
+    let count = 0;
+
+    // Write agent launchers
+    for (const mod of allModules) {
+      const agentsSrcDir = path.join(prrDir, mod, 'agents');
+      if (!(await fs.pathExists(agentsSrcDir))) continue;
+
+      const agentFiles = await glob('**/*.md', { cwd: agentsSrcDir });
+      for (const agentFile of agentFiles) {
+        const agentContent = await fs.readFile(path.join(agentsSrcDir, agentFile), 'utf8');
+        if (/^no-launcher:\s*true/m.test(agentContent)) continue;
+
+        const nameMatch = agentContent.match(/^name:\s*[\"']?([^\"'\n]+)[\"']?/m);
+        const agentName = nameMatch?.[1]?.trim() || path.basename(agentFile, '.md');
+        const relPath = `${this.prrFolderName}/${mod}/agents/${agentFile}`.replaceAll('\\', '/');
+
+        const content = `---
+name: '${agentName}'
+description: '${agentName} agent'
+disable-model-invocation: true
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/${relPath}
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
+`;
+        const fileName = `prr-${mod}-${path.basename(agentFile, '.md')}.md`;
+        await fs.writeFile(path.join(destDir, fileName), content, 'utf8');
+        count++;
+      }
+    }
+
+    // Write workflow launchers
+    for (const mod of allModules) {
+      const workflowsSrcDir = path.join(prrDir, mod, 'workflows');
+      if (!(await fs.pathExists(workflowsSrcDir))) continue;
+
+      const workflowFiles = await glob('**/workflow{.md,.yaml}', { cwd: workflowsSrcDir });
+      for (const wfFile of workflowFiles) {
+        const wfContent = await fs.readFile(path.join(workflowsSrcDir, wfFile), 'utf8');
+        let wfName = path.basename(path.dirname(wfFile));
+
+        if (wfFile.endsWith('.yaml')) {
+          try { const d = yaml.parse(wfContent); wfName = d.name || wfName; } catch { /* ignore */ }
+        } else {
+          const normalized = wfContent.replace(/\r\n/g, '\n');
+          const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+          if (fmMatch) { try { const fm = yaml.parse(fmMatch[1]); wfName = fm.name || wfName; } catch { /* ignore */ } }
+        }
+
+        const dirParts = path.dirname(wfFile).split(path.sep).filter(Boolean);
+        const leafDir = dirParts.at(-1) || wfName;
+        const relPath = `${this.prrFolderName}/${mod}/workflows/${wfFile}`.replaceAll('\\', '/');
+
+        const content = `---
+name: 'prr-${leafDir}'
+description: '${wfName}'
+disable-model-invocation: true
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/${relPath}, READ its entire contents and follow its directions exactly!
+`;
+        const fileName = `prr-${mod}-${leafDir}.md`;
+        await fs.writeFile(path.join(destDir, fileName), content, 'utf8');
+        count++;
+      }
+    }
+
+    return { success: true, results: { agents: count, workflows: 0 } };
+  }
+
+  async cleanup(projectDir) {
+    for (const loc of ['global', 'project']) {
+      const dir = this._getPromptDir(projectDir, loc);
+      await this._clearPrrFiles(dir);
+    }
+  }
+
+  _getPromptDir(projectDir, location) {
+    if (location === 'project' && projectDir) {
+      return path.join(projectDir, '.codex', 'prompts');
+    }
+    return path.join(os.homedir(), '.codex', 'prompts');
+  }
+
+  async _clearPrrFiles(dir) {
+    if (!(await fs.pathExists(dir))) return;
+    const entries = await fs.readdir(dir);
+    for (const entry of entries) {
+      if (entry.startsWith('prr-') && entry.endsWith('.md')) {
+        await fs.remove(path.join(dir, entry));
+      }
+    }
+  }
+}
+
+module.exports = { CodexSetup };