@rigour-labs/cli 2.9.4 → 2.11.0

package/dist/cli.js

@@ -1,23 +1,22 @@
 #!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const init_js_1 = require("./commands/init.js");
-const check_js_1 = require("./commands/check.js");
-const explain_js_1 = require("./commands/explain.js");
-const run_js_1 = require("./commands/run.js");
-const guide_js_1 = require("./commands/guide.js");
-const setup_js_1 = require("./commands/setup.js");
-const chalk_1 = __importDefault(require("chalk"));
-const program = new commander_1.Command();
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { checkCommand } from './commands/check.js';
+import { explainCommand } from './commands/explain.js';
+import { runLoop } from './commands/run.js';
+import { guideCommand } from './commands/guide.js';
+import { setupCommand } from './commands/setup.js';
+import { indexCommand } from './commands/index.js';
+import { studioCommand } from './commands/studio.js';
+import chalk from 'chalk';
+const program = new Command();
+program.addCommand(indexCommand);
+program.addCommand(studioCommand);
 program
     .name('rigour')
     .description('🛡️ Rigour: The Quality Gate Loop for AI-Assisted Engineering')
     .version('2.0.0')
-    .addHelpText('before', chalk_1.default.bold.cyan(`
+    .addHelpText('before', chalk.bold.cyan(`
    ____  _                               
   / __ \\(_)____ ___  __  __ _____        
  / /_/ // // __ \`/ / / / / // ___/        
@@ -41,7 +40,7 @@ Examples:
   $ rigour init --ide all              # Create files for all IDEs
     `)
     .action(async (options) => {
-    await (0, init_js_1.initCommand)(process.cwd(), options);
+    await initCommand(process.cwd(), options);
 });
 program
     .command('check')
@@ -59,7 +58,7 @@ Examples:
   $ rigour check --ci                  # Run in CI environment
     `)
     .action(async (files, options) => {
-    await (0, check_js_1.checkCommand)(process.cwd(), files, options);
+    await checkCommand(process.cwd(), files, options);
 });
 program
     .command('explain')
@@ -69,7 +68,7 @@ Examples:
   $ rigour explain                     # Get a human-readable violation summary
     `)
     .action(async () => {
-    await (0, explain_js_1.explainCommand)(process.cwd());
+    await explainCommand(process.cwd());
 });
 program
     .command('run')
@@ -83,7 +82,7 @@ Examples:
   $ rigour run -c 5 -- cursor-agent     # Run Cursor agent for up to 5 cycles
     `)
     .action(async (args, options) => {
-    await (0, run_js_1.runLoop)(process.cwd(), args, {
+    await runLoop(process.cwd(), args, {
         iterations: parseInt(options.maxCycles),
         failFast: !!options.failFast
     });
@@ -92,12 +91,12 @@ program
     .command('guide')
     .description('Show the interactive engineering guide')
     .action(async () => {
-    await (0, guide_js_1.guideCommand)();
+    await guideCommand();
 });
 program
     .command('setup')
     .description('Show installation and global setup guidance')
     .action(async () => {
-    await (0, setup_js_1.setupCommand)();
+    await setupCommand();
 });
 program.parse();

package/dist/commands/check.js

@@ -1,50 +1,77 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkCommand = checkCommand;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const yaml_1 = __importDefault(require("yaml"));
-const core_1 = require("@rigour-labs/core");
-const inquirer_1 = __importDefault(require("inquirer"));
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import yaml from 'yaml';
+import { GateRunner, ConfigSchema } from '@rigour-labs/core';
+import inquirer from 'inquirer';
+import { randomUUID } from 'crypto';
 // Exit codes per spec
 const EXIT_PASS = 0;
 const EXIT_FAIL = 1;
 const EXIT_CONFIG_ERROR = 2;
 const EXIT_INTERNAL_ERROR = 3;
-async function checkCommand(cwd, files = [], options = {}) {
-    const configPath = path_1.default.join(cwd, 'rigour.yml');
-    if (!(await fs_extra_1.default.pathExists(configPath))) {
+// Helper to log events for Rigour Studio
+async function logStudioEvent(cwd, event) {
+    try {
+        const rigourDir = path.join(cwd, ".rigour");
+        await fs.ensureDir(rigourDir);
+        const eventsPath = path.join(rigourDir, "events.jsonl");
+        const logEntry = JSON.stringify({
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+            ...event
+        }) + "\n";
+        await fs.appendFile(eventsPath, logEntry);
+    }
+    catch {
+        // Silent fail
+    }
+}
+export async function checkCommand(cwd, files = [], options = {}) {
+    const configPath = path.join(cwd, 'rigour.yml');
+    if (!(await fs.pathExists(configPath))) {
         if (options.json) {
             console.log(JSON.stringify({ error: 'CONFIG_ERROR', message: 'rigour.yml not found' }));
         }
         else if (!options.ci) {
-            console.error(chalk_1.default.red('Error: rigour.yml not found. Run `rigour init` first.'));
+            console.error(chalk.red('Error: rigour.yml not found. Run `rigour init` first.'));
         }
         process.exit(EXIT_CONFIG_ERROR);
     }
     try {
-        const configContent = await fs_extra_1.default.readFile(configPath, 'utf-8');
-        const rawConfig = yaml_1.default.parse(configContent);
-        const config = core_1.ConfigSchema.parse(rawConfig);
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const rawConfig = yaml.parse(configContent);
+        const config = ConfigSchema.parse(rawConfig);
         if (!options.ci && !options.json) {
-            console.log(chalk_1.default.blue('Running Rigour checks...\n'));
+            console.log(chalk.blue('Running Rigour checks...\n'));
         }
-        const runner = new core_1.GateRunner(config);
+        const runner = new GateRunner(config);
+        const requestId = randomUUID();
+        await logStudioEvent(cwd, {
+            type: "tool_call",
+            requestId,
+            tool: "rigour_check",
+            arguments: { files }
+        });
         const report = await runner.run(cwd, files.length > 0 ? files : undefined);
         // Write machine report
-        const reportPath = path_1.default.join(cwd, config.output.report_path);
-        await fs_extra_1.default.writeJson(reportPath, report, { spaces: 2 });
+        const reportPath = path.join(cwd, config.output.report_path);
+        await fs.writeJson(reportPath, report, { spaces: 2 });
+        await logStudioEvent(cwd, {
+            type: "tool_response",
+            requestId,
+            tool: "rigour_check",
+            status: report.status === 'PASS' ? 'success' : 'error',
+            content: [{ type: "text", text: `Audit Result: ${report.status}` }],
+            _rigour_report: report
+        });
         // Generate Fix Packet v2 on failure
         if (report.status === 'FAIL') {
             const { FixPacketService } = await import('@rigour-labs/core');
             const fixPacketService = new FixPacketService();
             const fixPacket = fixPacketService.generate(report, config);
-            const fixPacketPath = path_1.default.join(cwd, 'rigour-fix-packet.json');
-            await fs_extra_1.default.writeJson(fixPacketPath, fixPacket, { spaces: 2 });
+            const fixPacketPath = path.join(cwd, 'rigour-fix-packet.json');
+            await fs.writeJson(fixPacketPath, fixPacket, { spaces: 2 });
         }
         // JSON output mode
         if (options.json) {
@@ -70,25 +97,25 @@ async function checkCommand(cwd, files = [], options = {}) {
         }
         // Normal human-readable output
         if (report.status === 'PASS') {
-            console.log(chalk_1.default.green.bold('✔ PASS - All quality gates satisfied.'));
+            console.log(chalk.green.bold('✔ PASS - All quality gates satisfied.'));
         }
         else {
-            console.log(chalk_1.default.red.bold('✘ FAIL - Quality gate violations found.\n'));
+            console.log(chalk.red.bold('✘ FAIL - Quality gate violations found.\n'));
             for (const failure of report.failures) {
-                console.log(chalk_1.default.red(`[${failure.id}] ${failure.title}`));
-                console.log(chalk_1.default.dim(`  Details: ${failure.details}`));
+                console.log(chalk.red(`[${failure.id}] ${failure.title}`));
+                console.log(chalk.dim(`  Details: ${failure.details}`));
                 if (failure.files && failure.files.length > 0) {
-                    console.log(chalk_1.default.dim('  Files:'));
-                    failure.files.forEach((f) => console.log(chalk_1.default.dim(`    - ${f}`)));
+                    console.log(chalk.dim('  Files:'));
+                    failure.files.forEach((f) => console.log(chalk.dim(`    - ${f}`)));
                 }
                 if (failure.hint) {
-                    console.log(chalk_1.default.cyan(`  Hint: ${failure.hint}`));
+                    console.log(chalk.cyan(`  Hint: ${failure.hint}`));
                 }
                 console.log('');
             }
-            console.log(chalk_1.default.yellow(`See ${config.output.report_path} for full details.`));
+            console.log(chalk.yellow(`See ${config.output.report_path} for full details.`));
         }
-        console.log(chalk_1.default.dim(`\nFinished in ${report.stats.duration_ms}ms`));
+        console.log(chalk.dim(`\nFinished in ${report.stats.duration_ms}ms`));
         process.exit(report.status === 'PASS' ? EXIT_PASS : EXIT_FAIL);
     }
     catch (error) {
@@ -97,9 +124,9 @@ async function checkCommand(cwd, files = [], options = {}) {
                 console.log(JSON.stringify({ error: 'CONFIG_ERROR', details: error.issues }));
             }
             else {
-                console.error(chalk_1.default.red('\nInvalid rigour.yml configuration:'));
+                console.error(chalk.red('\nInvalid rigour.yml configuration:'));
                 error.issues.forEach((issue) => {
-                    console.error(chalk_1.default.red(`  • ${issue.path.join('.')}: ${issue.message}`));
+                    console.error(chalk.red(`  • ${issue.path.join('.')}: ${issue.message}`));
                 });
             }
             process.exit(EXIT_CONFIG_ERROR);
@@ -108,24 +135,24 @@ async function checkCommand(cwd, files = [], options = {}) {
             console.log(JSON.stringify({ error: 'INTERNAL_ERROR', message: error.message }));
         }
         else if (!options.ci) {
-            console.error(chalk_1.default.red(`Internal error: ${error.message}`));
+            console.error(chalk.red(`Internal error: ${error.message}`));
         }
         process.exit(EXIT_INTERNAL_ERROR);
     }
 }
 async function interactiveMode(report, config) {
     console.clear();
-    console.log(chalk_1.default.bold.blue('══ Rigour Interactive Review ══\n'));
-    console.log(chalk_1.default.yellow(`${report.failures.length} violations found.\n`));
+    console.log(chalk.bold.blue('══ Rigour Interactive Review ══\n'));
+    console.log(chalk.yellow(`${report.failures.length} violations found.\n`));
     const choices = report.failures.map((f, i) => ({
         name: `[${f.id}] ${f.title}`,
         value: i
     }));
-    choices.push(new inquirer_1.default.Separator());
+    choices.push(new inquirer.Separator());
     choices.push({ name: 'Exit', value: -1 });
     let exit = false;
     while (!exit) {
-        const { index } = await inquirer_1.default.prompt([
+        const { index } = await inquirer.prompt([
             {
                 type: 'list',
                 name: 'index',
@@ -140,19 +167,19 @@ async function interactiveMode(report, config) {
         }
         const failure = report.failures[index];
         console.clear();
-        console.log(chalk_1.default.bold.red(`\nViolation: ${failure.title}`));
-        console.log(chalk_1.default.dim(`ID: ${failure.id}`));
-        console.log(`\n${chalk_1.default.bold('Details:')}\n${failure.details}`);
+        console.log(chalk.bold.red(`\nViolation: ${failure.title}`));
+        console.log(chalk.dim(`ID: ${failure.id}`));
+        console.log(`\n${chalk.bold('Details:')}\n${failure.details}`);
         if (failure.files && failure.files.length > 0) {
-            console.log(`\n${chalk_1.default.bold('Impacted Files:')}`);
-            failure.files.forEach((f) => console.log(chalk_1.default.dim(`  - ${f}`)));
+            console.log(`\n${chalk.bold('Impacted Files:')}`);
+            failure.files.forEach((f) => console.log(chalk.dim(`  - ${f}`)));
         }
         if (failure.hint) {
-            console.log(`\n${chalk_1.default.bold.cyan('Hint:')} ${failure.hint}`);
+            console.log(`\n${chalk.bold.cyan('Hint:')} ${failure.hint}`);
         }
-        console.log(chalk_1.default.dim('\n' + '─'.repeat(40)));
-        await inquirer_1.default.prompt([{ type: 'input', name: 'continue', message: 'Press Enter to return to list...' }]);
+        console.log(chalk.dim('\n' + '─'.repeat(40)));
+        await inquirer.prompt([{ type: 'input', name: 'continue', message: 'Press Enter to return to list...' }]);
         console.clear();
-        console.log(chalk_1.default.bold.blue('══ Rigour Interactive Review ══\n'));
+        console.log(chalk.bold.blue('══ Rigour Interactive Review ══\n'));
     }
 }

package/dist/commands/constants.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGNOSTIC_AI_INSTRUCTIONS = exports.COLLABORATION_RULES = exports.DEBUGGING_RULES = exports.CODE_QUALITY_RULES = void 0;
-exports.CODE_QUALITY_RULES = `
+export const CODE_QUALITY_RULES = `
 # Code Quality Standards
 
 ## PRODUCTION-GRADE CODE ONLY
@@ -60,7 +57,7 @@ Before asking for "approval," internally verify:
 - **Cost Impact**: Does this change increase egress costs (e.g., unnecessary cross-region logging)?
 - **Error Handling**: Does the UI have a graceful fallback if the backend service is slow?
 `;
-exports.DEBUGGING_RULES = `
+export const DEBUGGING_RULES = `
 # Investigation & Debugging Protocol
 
 ## INVESTIGATION PROTOCOL
@@ -109,7 +106,7 @@ Before proposing any fix:
 3. Trace the data flow that led to the error
 4. Verify the fix doesn't break other paths
 `;
-exports.COLLABORATION_RULES = `
+export const COLLABORATION_RULES = `
 # Role & Collaboration
 
 You are a Senior Staff Engineer working alongside a Principal Engineer (the user). 
@@ -186,7 +183,7 @@ If thresholds genuinely need adjustment, escalate to the team lead with justific
 8. ❌ Losing context between messages
 9. ❌ Modifying rigour.yml to pass quality checks
 `;
-exports.AGNOSTIC_AI_INSTRUCTIONS = `
+export const AGNOSTIC_AI_INSTRUCTIONS = `
 # 🤖 CRITICAL INSTRUCTION FOR AI
 
 When asked to implement a feature or fix an issue:

package/dist/commands/explain.js

@@ -1,73 +1,67 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.explainCommand = explainCommand;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-async function explainCommand(cwd) {
-    const configPath = path_1.default.join(cwd, 'rigour.yml');
-    let reportPath = path_1.default.join(cwd, 'rigour-report.json');
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+export async function explainCommand(cwd) {
+    const configPath = path.join(cwd, 'rigour.yml');
+    let reportPath = path.join(cwd, 'rigour-report.json');
     // Try to read custom path from config
-    if (await fs_extra_1.default.pathExists(configPath)) {
+    if (await fs.pathExists(configPath)) {
         try {
             const yaml = await import('yaml');
-            const configContent = await fs_extra_1.default.readFile(configPath, 'utf-8');
+            const configContent = await fs.readFile(configPath, 'utf-8');
             const config = yaml.parse(configContent);
             if (config?.output?.report_path) {
-                reportPath = path_1.default.join(cwd, config.output.report_path);
+                reportPath = path.join(cwd, config.output.report_path);
             }
         }
         catch (e) { }
     }
-    if (!(await fs_extra_1.default.pathExists(reportPath))) {
-        console.error(chalk_1.default.red(`Error: No report found at ${reportPath}`));
-        console.error(chalk_1.default.dim('Run `rigour check` first to generate a report.'));
+    if (!(await fs.pathExists(reportPath))) {
+        console.error(chalk.red(`Error: No report found at ${reportPath}`));
+        console.error(chalk.dim('Run `rigour check` first to generate a report.'));
         process.exit(2);
     }
     try {
-        const reportContent = await fs_extra_1.default.readFile(reportPath, 'utf-8');
+        const reportContent = await fs.readFile(reportPath, 'utf-8');
         const report = JSON.parse(reportContent);
-        console.log(chalk_1.default.bold('\n📋 Rigour Report Explanation\n'));
-        console.log(chalk_1.default.bold('Status: ') + (report.status === 'PASS'
-            ? chalk_1.default.green.bold('✅ PASS')
-            : chalk_1.default.red.bold('🛑 FAIL')));
-        console.log(chalk_1.default.bold('\nGate Summary:'));
+        console.log(chalk.bold('\n📋 Rigour Report Explanation\n'));
+        console.log(chalk.bold('Status: ') + (report.status === 'PASS'
+            ? chalk.green.bold('✅ PASS')
+            : chalk.red.bold('🛑 FAIL')));
+        console.log(chalk.bold('\nGate Summary:'));
         for (const [gate, status] of Object.entries(report.summary || {})) {
             const icon = status === 'PASS' ? '✅' : status === 'FAIL' ? '❌' : '⏭️';
             console.log(`  ${icon} ${gate}: ${status}`);
         }
         if (report.failures && report.failures.length > 0) {
-            console.log(chalk_1.default.bold.red(`\n🔧 ${report.failures.length} Violation(s) to Fix:\n`));
+            console.log(chalk.bold.red(`\n🔧 ${report.failures.length} Violation(s) to Fix:\n`));
             report.failures.forEach((failure, index) => {
-                console.log(chalk_1.default.white(`${index + 1}. `) + chalk_1.default.bold.yellow(`[${failure.id.toUpperCase()}]`) + chalk_1.default.white(` ${failure.title}`));
-                console.log(chalk_1.default.dim(`   └─ ${failure.details}`));
+                console.log(chalk.white(`${index + 1}. `) + chalk.bold.yellow(`[${failure.id.toUpperCase()}]`) + chalk.white(` ${failure.title}`));
+                console.log(chalk.dim(`   └─ ${failure.details}`));
                 if (failure.files && failure.files.length > 0) {
-                    console.log(chalk_1.default.cyan(`   📁 Files: ${failure.files.join(', ')}`));
+                    console.log(chalk.cyan(`   📁 Files: ${failure.files.join(', ')}`));
                 }
                 if (failure.hint) {
-                    console.log(chalk_1.default.green(`   💡 Hint: ${failure.hint}`));
+                    console.log(chalk.green(`   💡 Hint: ${failure.hint}`));
                 }
                 console.log('');
             });
         }
         else if (report.status === 'PASS') {
-            console.log(chalk_1.default.green('\n✨ All quality gates passed! No violations found.\n'));
+            console.log(chalk.green('\n✨ All quality gates passed! No violations found.\n'));
         }
         if (report.status === 'FAIL') {
-            console.log(chalk_1.default.bold('\n👉 Next Steps:'));
-            console.log(chalk_1.default.dim('   1. Refactor the code to address the violations above.'));
-            console.log(chalk_1.default.dim('   2. Run `rigour check` again to verify your fixes.'));
-            console.log(chalk_1.default.dim('   3. If using an agent, pass it the violations as constraints.\n'));
+            console.log(chalk.bold('\n👉 Next Steps:'));
+            console.log(chalk.dim('   1. Refactor the code to address the violations above.'));
+            console.log(chalk.dim('   2. Run `rigour check` again to verify your fixes.'));
+            console.log(chalk.dim('   3. If using an agent, pass it the violations as constraints.\n'));
         }
         if (report.stats) {
-            console.log(chalk_1.default.dim(`Duration: ${report.stats.duration_ms}ms`));
+            console.log(chalk.dim(`Duration: ${report.stats.duration_ms}ms`));
         }
     }
     catch (error) {
-        console.error(chalk_1.default.red(`Error reading report: ${error.message}`));
+        console.error(chalk.red(`Error reading report: ${error.message}`));
         process.exit(3);
     }
 }

package/dist/commands/guide.js

@@ -1,22 +1,16 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.guideCommand = guideCommand;
-const chalk_1 = __importDefault(require("chalk"));
-async function guideCommand() {
-    console.log(chalk_1.default.bold.cyan('\n🛡️ Rigour Labs | The Engineering Guide\n'));
-    console.log(chalk_1.default.bold('Getting Started:'));
-    console.log(chalk_1.default.dim('  1. Run ') + chalk_1.default.cyan('rigour init') + chalk_1.default.dim(' to detect your project role and apply standards.'));
-    console.log(chalk_1.default.dim('  2. Run ') + chalk_1.default.cyan('rigour check') + chalk_1.default.dim(' to see existing violations.'));
-    console.log(chalk_1.default.dim('  3. Run ') + chalk_1.default.cyan('rigour run -- <your-agent-command>') + chalk_1.default.dim(' to automate the fix loop.\n'));
-    console.log(chalk_1.default.bold('Key Concepts:'));
-    console.log(chalk_1.default.yellow('  • Fix Packet v2') + chalk_1.default.dim(': Structured diagnostics fed directly into AI agents.'));
-    console.log(chalk_1.default.yellow('  • Safety Rails') + chalk_1.default.dim(': Prevents "explosive" refactoring (max files changed).'));
-    console.log(chalk_1.default.yellow('  • Strategic Guardians') + chalk_1.default.dim(': Dependency and Architectural boundary enforcement.\n'));
-    console.log(chalk_1.default.bold('Workflow Integration:'));
-    console.log(chalk_1.default.green('  • Cursor') + chalk_1.default.dim(': Add the MCP server or use the ') + chalk_1.default.cyan('.cursor/rules/rigour.mdc') + chalk_1.default.dim(' handshake.'));
-    console.log(chalk_1.default.green('  • CI/CD') + chalk_1.default.dim(': Use ') + chalk_1.default.cyan('rigour check --ci') + chalk_1.default.dim(' to fail PRs that violate quality gates.\n'));
-    console.log(chalk_1.default.dim('For more detailed docs, visit: ') + chalk_1.default.underline('https://github.com/erashu212/rigour/docs\n'));
+import chalk from 'chalk';
+export async function guideCommand() {
+    console.log(chalk.bold.cyan('\n🛡️ Rigour Labs | The Engineering Guide\n'));
+    console.log(chalk.bold('Getting Started:'));
+    console.log(chalk.dim('  1. Run ') + chalk.cyan('rigour init') + chalk.dim(' to detect your project role and apply standards.'));
+    console.log(chalk.dim('  2. Run ') + chalk.cyan('rigour check') + chalk.dim(' to see existing violations.'));
+    console.log(chalk.dim('  3. Run ') + chalk.cyan('rigour run -- <your-agent-command>') + chalk.dim(' to automate the fix loop.\n'));
+    console.log(chalk.bold('Key Concepts:'));
+    console.log(chalk.yellow('  • Fix Packet v2') + chalk.dim(': Structured diagnostics fed directly into AI agents.'));
+    console.log(chalk.yellow('  • Safety Rails') + chalk.dim(': Prevents "explosive" refactoring (max files changed).'));
+    console.log(chalk.yellow('  • Strategic Guardians') + chalk.dim(': Dependency and Architectural boundary enforcement.\n'));
+    console.log(chalk.bold('Workflow Integration:'));
+    console.log(chalk.green('  • Cursor') + chalk.dim(': Add the MCP server or use the ') + chalk.cyan('.cursor/rules/rigour.mdc') + chalk.dim(' handshake.'));
+    console.log(chalk.green('  • CI/CD') + chalk.dim(': Use ') + chalk.cyan('rigour check --ci') + chalk.dim(' to fail PRs that violate quality gates.\n'));
+    console.log(chalk.dim('For more detailed docs, visit: ') + chalk.underline('https://github.com/erashu212/rigour/docs\n'));
 }

package/dist/commands/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Index Command
+ *
+ * Builds and updates the Rigour Pattern Index to prevent code reinvention.
+ */
+import { Command } from 'commander';
+export declare const indexCommand: Command;

package/dist/commands/index.js

@@ -0,0 +1,88 @@
+/**
+ * Index Command
+ *
+ * Builds and updates the Rigour Pattern Index to prevent code reinvention.
+ */
+import { Command } from 'commander';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import { randomUUID } from 'crypto';
+// Helper to log events for Rigour Studio
+async function logStudioEvent(cwd, event) {
+    try {
+        const rigourDir = path.join(cwd, ".rigour");
+        await fs.ensureDir(rigourDir);
+        const eventsPath = path.join(rigourDir, "events.jsonl");
+        const logEntry = JSON.stringify({
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+            ...event
+        }) + "\n";
+        await fs.appendFile(eventsPath, logEntry);
+    }
+    catch {
+        // Silent fail
+    }
+}
+// Dynamic imports are used inside the action handler below to prevent
+// native dependency issues from affecting the rest of the CLI.
+export const indexCommand = new Command('index')
+    .description('Build or update the pattern index for the current project')
+    .option('-s, --semantic', 'Generate semantic embeddings for better matching (requires Transformers.js)', false)
+    .option('-f, --force', 'Force a full rebuild of the index', false)
+    .option('-o, --output <path>', 'Custom path for the index file')
+    .action(async (options) => {
+    const cwd = process.cwd();
+    // Dynamic import to isolate native dependencies
+    const { PatternIndexer, savePatternIndex, loadPatternIndex, getDefaultIndexPath } = await import('@rigour-labs/core/pattern-index');
+    const indexPath = options.output || getDefaultIndexPath(cwd);
+    const spinner = ora('Initializing pattern indexer...').start();
+    try {
+        const requestId = randomUUID();
+        await logStudioEvent(cwd, {
+            type: "tool_call",
+            requestId,
+            tool: "rigour_index",
+            arguments: options
+        });
+        const indexer = new PatternIndexer(cwd, {
+            useEmbeddings: options.semantic
+        });
+        let index;
+        const existingIndex = await loadPatternIndex(indexPath);
+        if (existingIndex && !options.force) {
+            spinner.text = 'Updating existing pattern index...';
+            index = await indexer.updateIndex(existingIndex);
+        }
+        else {
+            spinner.text = 'Building fresh pattern index (this may take a while)...';
+            index = await indexer.buildIndex();
+        }
+        spinner.text = 'Saving index to disk...';
+        await savePatternIndex(index, indexPath);
+        spinner.succeed(chalk.green(`Pattern index built successfully!`));
+        await logStudioEvent(cwd, {
+            type: "tool_response",
+            requestId,
+            tool: "rigour_index",
+            status: "success",
+            content: [{ type: "text", text: `Index built: ${index.stats.totalPatterns} patterns` }]
+        });
+        console.log(chalk.blue(`- Total Patterns: ${index.stats.totalPatterns}`));
+        console.log(chalk.blue(`- Total Files: ${index.stats.totalFiles}`));
+        console.log(chalk.blue(`- Index Path: ${indexPath}`));
+        if (options.semantic) {
+            console.log(chalk.magenta(`- Semantic Search: Enabled (Local Transformers.js)`));
+        }
+        const byType = Object.entries(index.stats.byType)
+            .map(([type, count]) => `${type}: ${count}`)
+            .join(', ');
+        console.log(chalk.gray(`Types: ${byType}`));
+    }
+    catch (error) {
+        spinner.fail(chalk.red(`Failed to build pattern index: ${error.message}`));
+        process.exit(1);
+    }
+});