@rigour-labs/cli 1.0.0 → 1.4.0

package/src/commands/run.ts

@@ -5,12 +5,18 @@ import yaml from 'yaml';
 import { execa } from 'execa';
 import { GateRunner, ConfigSchema } from '@rigour-labs/core';
 
-export async function runLoop(cwd: string, agentArgs: string[], options: { iterations: number }) {
+// Exit codes per spec
+const EXIT_PASS = 0;
+const EXIT_FAIL = 1;
+const EXIT_CONFIG_ERROR = 2;
+const EXIT_INTERNAL_ERROR = 3;
+
+export async function runLoop(cwd: string, agentArgs: string[], options: { iterations: number, failFast?: boolean }) {
     const configPath = path.join(cwd, 'rigour.yml');
 
     if (!(await fs.pathExists(configPath))) {
         console.error(chalk.red('Error: rigour.yml not found. Run `rigour init` first.'));
-        process.exit(1);
+        process.exit(EXIT_CONFIG_ERROR);
     }
 
     try {
@@ -28,52 +34,98 @@ export async function runLoop(cwd: string, agentArgs: string[], options: { itera
             console.log(chalk.bold.blue(`  RIGOUR LOOP: Iteration ${iteration}/${maxIterations}`));
             console.log(chalk.bold.blue(`══════════════════════════════════════════════════════════════════`));
 
-            // 1. Run the agent command
-            if (agentArgs.length > 0) {
+            // 1. Prepare Command
+            let currentArgs = [...agentArgs];
+            if (iteration > 1 && agentArgs.length > 0) {
+                // Iteration contract: In later cycles, we focus strictly on the fix packet
+                console.log(chalk.yellow(`\n🔄 REFINEMENT CYCLE - Instructing agent to fix specific violations...`));
+                // We keep the first part of the command (the agent) but can append or wrap
+                // For simplicity, we assume the agent can read the JSON file we generate
+            }
+
+            // Snapshot changed files before agent runs
+            let beforeFiles: string[] = [];
+            try {
+                const { stdout } = await execa('git', ['status', '--porcelain'], { cwd });
+                beforeFiles = stdout.split('\n').filter(l => l.trim()).map(l => l.slice(3).trim());
+            } catch (e) { }
+
+            // 2. Run the agent command
+            if (currentArgs.length > 0) {
                 console.log(chalk.cyan(`\n🚀 DEPLOYING AGENT:`));
-                console.log(chalk.dim(`   Command: ${agentArgs.join(' ')}`));
+                console.log(chalk.dim(`   Command: ${currentArgs.join(' ')}`));
                 try {
-                    await execa(agentArgs[0], agentArgs.slice(1), { shell: true, stdio: 'inherit', cwd });
+                    await execa(currentArgs[0], currentArgs.slice(1), { shell: true, stdio: 'inherit', cwd });
                 } catch (error: any) {
                     console.warn(chalk.yellow(`\n⚠️  Agent command finished with non-zero exit code. Rigour will now verify state...`));
                 }
             }
 
-            // 2. Run Rigour Check
+            // Snapshot changed files after agent runs
+            let afterFiles: string[] = [];
+            try {
+                const { stdout } = await execa('git', ['status', '--porcelain'], { cwd });
+                afterFiles = stdout.split('\n').filter(l => l.trim()).map(l => l.slice(3).trim());
+            } catch (e) { }
+
+            const changedThisCycle = afterFiles.filter(f => !beforeFiles.includes(f));
+            const maxFiles = config.gates.safety?.max_files_changed_per_cycle || 10;
+
+            if (changedThisCycle.length > maxFiles) {
+                console.log(chalk.red.bold(`\n🛑 SAFETY RAIL ABORT: Agent changed ${changedThisCycle.length} files (max: ${maxFiles}).`));
+                console.log(chalk.red(`   This looks like explosive behavior. Check your agent's instructions.`));
+                process.exit(EXIT_FAIL);
+            }
+
+            // 3. Run Rigour Check
             console.log(chalk.magenta('\n🔍 AUDITING QUALITY GATES...'));
             const report = await runner.run(cwd);
 
+            // Write report
+            const reportPath = path.join(cwd, config.output.report_path);
+            await fs.writeJson(reportPath, report, { spaces: 2 });
+
             if (report.status === 'PASS') {
                 console.log(chalk.green.bold('\n✨ PASS - All quality gates satisfied.'));
                 console.log(chalk.green(`   Your solution meets the required Engineering Rigour criteria.\n`));
                 return;
             }
 
-            // 3. Generate and print Fix Packet for next iteration
+            // 4. Generate Fix Packet v2
+            const { FixPacketService } = await import('@rigour-labs/core');
+            const fixPacketService = new FixPacketService();
+            const fixPacket = fixPacketService.generate(report, config);
+            const fixPacketPath = path.join(cwd, 'rigour-fix-packet.json');
+            await fs.writeJson(fixPacketPath, fixPacket, { spaces: 2 });
+
             console.log(chalk.red.bold(`\n🛑 FAIL - Found ${report.failures.length} engineering violations.`));
+            console.log(chalk.dim(`   Fix Packet generated: rigour-fix-packet.json`));
 
-            const fixPacket = report.failures.map((f, i) => {
-                let msg = chalk.white(`${i + 1}. `) + chalk.bold.red(`[${f.id.toUpperCase()}] `) + chalk.white(f.title);
-                msg += `\n   ├─ ` + chalk.dim(`Details: ${f.details}`);
-                if (f.hint) msg += `\n   └─ ` + chalk.yellow(`FIX: ${f.hint}`);
-                return msg;
-            }).join('\n\n');
+            if (options.failFast) {
+                console.log(chalk.red.bold(`\n🛑 FAIL-FAST: Aborting loop as requested.`));
+                process.exit(EXIT_FAIL);
+            }
 
-            console.log(chalk.bold.white('\n📋 ACTIONABLE FIX PACKET:'));
-            console.log(fixPacket);
-            console.log(chalk.dim('\nReturning control to agent for the next refinement cycle...'));
+            // Print summary
+            const summary = report.failures.map((f, i) => {
+                return chalk.white(`${i + 1}. `) + chalk.bold.red(`[${f.id.toUpperCase()}] `) + chalk.white(f.title);
+            }).join('\n');
+            console.log(chalk.bold.white('\n📋 VIOLATIONS SUMMARY:'));
+            console.log(summary);
 
             if (iteration === maxIterations) {
                 console.log(chalk.red.bold(`\n❌ CRITICAL: Reached maximum iterations (${maxIterations}).`));
                 console.log(chalk.red(`   Quality gates remain unfulfilled. Refactor manually or check agent logs.`));
-                process.exit(1);
+                process.exit(EXIT_FAIL);
             }
+
+            console.log(chalk.dim('\nReturning control to agent for the next refinement cycle...'));
         }
     } catch (error: any) {
         console.error(chalk.red(`\n❌ FATAL ERROR: ${error.message}`));
         if (error.issues) {
             console.error(chalk.dim(JSON.stringify(error.issues, null, 2)));
         }
-        process.exit(1);
+        process.exit(EXIT_INTERNAL_ERROR);
     }
 }

package/src/commands/setup.ts

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+
+export async function setupCommand() {
+    console.log(chalk.bold.cyan('\n🛠️ Rigour Labs | Setup & Installation\n'));
+
+    console.log(chalk.bold('1. Global Installation (Recommended)'));
+    console.log(chalk.dim('   To use Rigour anywhere in your terminal:'));
+    console.log(chalk.green('   $ npm install -g @rigour-labs/cli\n'));
+
+    console.log(chalk.bold('2. Project-Local installation'));
+    console.log(chalk.dim('   To keep Rigour versioned with your project:'));
+    console.log(chalk.green('   $ npm install --save-dev @rigour-labs/cli\n'));
+
+    console.log(chalk.bold('3. Standalone Binaries (Zero-Install)'));
+    console.log(chalk.dim('   If you do not want to use Node.js:'));
+    console.log(chalk.dim('   • macOS: ') + chalk.cyan('https://github.com/erashu212/rigour/releases/latest/download/rigour-macos'));
+    console.log(chalk.dim('   • Linux: ') + chalk.cyan('https://github.com/erashu212/rigour/releases/latest/download/rigour-linux'));
+    console.log(chalk.dim('   • Windows: ') + chalk.cyan('https://github.com/erashu212/rigour/releases/latest/download/rigour-windows.exe\n'));
+
+    console.log(chalk.bold('4. MCP Integration (for AI Agents)'));
+    console.log(chalk.dim('   To let Cursor or Claude use Rigour natively:'));
+    console.log(chalk.dim('   Path to MCP: ') + chalk.cyan('packages/rigour-mcp/dist/index.js'));
+    console.log(chalk.dim('   Add this to your Cursor/Claude settings.\n'));
+
+    console.log(chalk.bold('Update Guidance:'));
+    console.log(chalk.dim('   Keep Rigour sharp by updating regularly:'));
+    console.log(chalk.green('   $ npm install -g @rigour-labs/cli@latest\n'));
+}