@rigour-labs/cli 2.19.0 → 2.19.2

package/README.md

@@ -0,0 +1,85 @@
+# @rigour-labs/cli
+
+[![npm version](https://img.shields.io/npm/v/@rigour-labs/cli?color=cyan)](https://www.npmjs.com/package/@rigour-labs/cli)
+[![npm downloads](https://img.shields.io/npm/dm/@rigour-labs/cli?color=blue)](https://www.npmjs.com/package/@rigour-labs/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Local-first quality gates for AI-generated code.**  
+Rigour forces AI agents to meet strict engineering standards before marking tasks "Done".
+
+> **Zero cloud. Zero telemetry. PASS/FAIL is always free.**
+
+## 🚀 Quick Start
+
+```bash
+npx rigour init     # Initialize quality gates
+npx rigour check    # Verify code quality
+npx rigour run -- claude "Build feature X"  # Agent loop
+```
+
+## 🛑 The Problem
+
+AI agents often fall into **"Vibe Coding"**—claiming success based on narrative, not execution:
+
+1. Agent makes a change
+2. Agent **claims** "Task 100% complete"
+3. **CI Fails** with type errors, lint failures, or broken tests
+
+**Rigour breaks this cycle** by forcing agents to face the same verification tools (ruff, mypy, vitest) that CI runs—locally and immediately.
+
+## 🔄 How It Works
+
+```
+Agent writes code → Rigour checks → FAIL? → Fix Packet → Agent retries → PASS ✓
+```
+
+## ⚙️ Quality Gates
+
+| Gate | Description |
+|:---|:---|
+| **File Size** | Max lines per file (default: 300-500) |
+| **Hygiene** | No TODO/FIXME comments allowed |
+| **Complexity** | Cyclomatic complexity limits (AST-based) |
+| **Required Docs** | SPEC.md, ARCH.md, README must exist |
+| **Safety Rails** | Protected paths, max files changed |
+| **Context Alignment** | Prevents drift by anchoring on project patterns |
+
+## 🛠️ Commands
+
+| Command | Purpose |
+|:---|:---|
+| `rigour init` | Setup Rigour in your project |
+| `rigour check` | Validate code against quality gates |
+| `rigour check --ci` | CI mode with appropriate output |
+| `rigour explain` | Detailed explanation of validation results |
+| `rigour run` | Supervisor loop for iterative refinement |
+| `rigour studio` | Dashboard for monitoring |
+| `rigour index` | Build semantic index of codebase patterns |
+
+## 🤖 Works With
+
+- **Claude Code**: `rigour run -- claude "..."`
+- **Cursor / Cline / Gemini**: Via MCP server (`rigour_check`, `rigour_explain`)
+
+## 📖 Documentation
+
+**[📚 Full Documentation →](https://docs.rigour.run/)**
+
+| Quick Links | |
+|:---|:---|
+| [Getting Started](https://docs.rigour.run/getting-started) | Install and run in 60 seconds |
+| [CLI Reference](https://docs.rigour.run/cli/commands) | All commands and options |
+| [Configuration](https://docs.rigour.run/reference/configuration) | Customize quality gates |
+| [MCP Integration](https://docs.rigour.run/mcp/mcp-server) | AI agent setup |
+
+## 🧪 CI Integration
+
+```yaml
+- run: npx rigour check --ci
+```
+
+## 📜 License
+
+MIT © [Rigour Labs](https://github.com/rigour-labs)
+
+> *"Rigour adds the engineering."*

package/dist/cli.js

@@ -8,14 +8,16 @@ 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 { checkForUpdates } from './utils/version.js';
 import chalk from 'chalk';
+const CLI_VERSION = '2.0.0';
 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')
+    .version(CLI_VERSION)
     .addHelpText('before', chalk.bold.cyan(`
    ____  _                               
   / __ \\(_)____ ___  __  __ _____        
@@ -32,6 +34,7 @@ program
     .option('--ide <name>', 'Target IDE (cursor, vscode, all). Auto-detects if not specified.')
     .option('--dry-run', 'Show detected configuration without writing files')
     .option('--explain', 'Show detection markers for roles and paradigms')
+    .option('-f, --force', 'Force re-initialization, overwriting existing rigour.yml')
     .addHelpText('after', `
 Examples:
   $ rigour init                        # Auto-discover role & paradigm
@@ -100,4 +103,17 @@ program
     .action(async () => {
     await setupCommand();
 });
-program.parse();
+// Check for updates before parsing (non-blocking)
+(async () => {
+    try {
+        const updateInfo = await checkForUpdates(CLI_VERSION);
+        if (updateInfo?.hasUpdate) {
+            console.log(chalk.yellow(`\n⚡ Update available: ${updateInfo.currentVersion} → ${updateInfo.latestVersion}`));
+            console.log(chalk.dim(`   Run: npx @rigour-labs/cli@latest init --force\n`));
+        }
+    }
+    catch {
+        // Ignore version check errors
+    }
+    program.parse();
+})();

package/dist/commands/init.d.ts

@@ -4,5 +4,6 @@ export interface InitOptions {
     ide?: 'cursor' | 'vscode' | 'cline' | 'claude' | 'gemini' | 'codex' | 'windsurf' | 'all';
     dryRun?: boolean;
     explain?: boolean;
+    force?: boolean;
 }
 export declare function initCommand(cwd: string, options?: InitOptions): Promise<void>;

package/dist/commands/init.js

@@ -127,8 +127,16 @@ export async function initCommand(cwd, options = {}) {
     }
     const configPath = path.join(cwd, 'rigour.yml');
     if (await fs.pathExists(configPath)) {
-        console.log(chalk.yellow('rigour.yml already exists. Skipping initialization.'));
-        return;
+        if (!options.force) {
+            console.log(chalk.yellow('rigour.yml already exists.'));
+            console.log(chalk.dim('  → Run with --force to regenerate with latest templates'));
+            console.log(chalk.dim('  → Your current config will be backed up to rigour.yml.bak'));
+            return;
+        }
+        // Backup existing config
+        const backupPath = path.join(cwd, 'rigour.yml.bak');
+        await fs.copy(configPath, backupPath);
+        console.log(chalk.dim(`  Backed up existing config to rigour.yml.bak`));
     }
     console.log(chalk.bold.blue('\n🔍 Rigour Auto-Discovery:'));
     const requestId = randomUUID();

package/dist/utils/version.d.ts

@@ -0,0 +1,7 @@
+interface UpdateCheckResult {
+    hasUpdate: boolean;
+    currentVersion: string;
+    latestVersion: string;
+}
+export declare function checkForUpdates(currentVersion: string): Promise<UpdateCheckResult | null>;
+export {};

package/dist/utils/version.js

@@ -0,0 +1,81 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+const CACHE_FILE = path.join(os.homedir(), '.rigour-version-cache.json');
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@rigour-labs/cli/latest';
+async function getCachedVersion() {
+    try {
+        if (await fs.pathExists(CACHE_FILE)) {
+            const cache = await fs.readJson(CACHE_FILE);
+            if (Date.now() - cache.timestamp < CACHE_TTL_MS) {
+                return cache.latestVersion;
+            }
+        }
+    }
+    catch {
+        // Ignore cache read errors
+    }
+    return null;
+}
+async function cacheVersion(version) {
+    try {
+        await fs.writeJson(CACHE_FILE, {
+            latestVersion: version,
+            timestamp: Date.now()
+        });
+    }
+    catch {
+        // Ignore cache write errors
+    }
+}
+async function fetchLatestVersion() {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        const response = await fetch(NPM_REGISTRY_URL, {
+            signal: controller.signal,
+            headers: { 'Accept': 'application/json' }
+        });
+        clearTimeout(timeout);
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        return data.version || null;
+    }
+    catch {
+        // Network errors are non-fatal
+        return null;
+    }
+}
+function compareVersions(current, latest) {
+    const currentParts = current.replace(/^v/, '').split('.').map(Number);
+    const latestParts = latest.replace(/^v/, '').split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const c = currentParts[i] || 0;
+        const l = latestParts[i] || 0;
+        if (l > c)
+            return true;
+        if (l < c)
+            return false;
+    }
+    return false;
+}
+export async function checkForUpdates(currentVersion) {
+    // Try cache first
+    let latestVersion = await getCachedVersion();
+    // Fetch from npm if no cache
+    if (!latestVersion) {
+        latestVersion = await fetchLatestVersion();
+        if (latestVersion) {
+            await cacheVersion(latestVersion);
+        }
+    }
+    if (!latestVersion)
+        return null;
+    return {
+        hasUpdate: compareVersions(currentVersion, latestVersion),
+        currentVersion,
+        latestVersion
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rigour-labs/cli",
-  "version": "2.19.0",
+  "version": "2.19.2",
   "type": "module",
   "bin": {
     "rigour": "dist/cli.js"
@@ -28,7 +28,7 @@
     "inquirer": "9.2.16",
     "ora": "^8.0.1",
     "yaml": "^2.8.2",
-    "@rigour-labs/core": "2.19.0"
+    "@rigour-labs/core": "2.19.2"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",