@rigour-labs/core 2.21.2 → 3.0.0

package/src/pattern-index/types.ts

@@ -1,339 +0,0 @@
-/**
- * Pattern Index - Types
- * 
- * Core type definitions for the Pattern Index system.
- * Rigour's Pattern Index prevents AI from reinventing existing code.
- */
-
-/**
- * All supported pattern types that can be indexed.
- * Organized by category for clarity.
- */
-export type PatternType =
-    // === CODE PATTERNS ===
-    | 'function'           // Standalone functions, utilities
-    | 'class'              // Classes
-    | 'method'             // Class methods (indexed separately for reuse)
-    | 'component'          // React/Vue/Svelte components
-    | 'hook'               // React hooks (useX)
-    | 'decorator'          // Python/TS decorators
-    | 'middleware'         // Express/FastAPI middleware
-
-    // === DATA PATTERNS ===
-    | 'type'               // TypeScript types
-    | 'interface'          // TypeScript interfaces
-    | 'schema'             // Zod, Yup, JSON Schema validators
-    | 'model'              // Database models (Prisma, SQLAlchemy, etc.)
-    | 'enum'               // Enumerations
-
-    // === CONFIGURATION ===
-    | 'constant'           // Constants, magic values
-    | 'config'             // Configuration objects
-    | 'env'                // Environment variable patterns
-
-    // === API PATTERNS ===
-    | 'route'              // API routes/endpoints
-    | 'handler'            // Route handlers
-    | 'resolver'           // GraphQL resolvers
-    | 'rpc'                // tRPC procedures
-
-    // === STATE PATTERNS ===
-    | 'store'              // State stores (Zustand, Redux)
-    | 'reducer'            // Redux reducers
-    | 'action'             // Actions/mutations
-    | 'selector'           // State selectors
-
-    // === ERROR HANDLING ===
-    | 'error'              // Custom error classes
-    | 'exception'          // Exception types
-
-    // === TESTING ===
-    | 'mock'               // Mock objects/functions
-    | 'fixture'            // Test fixtures
-    | 'factory'            // Test factories
-
-    // === INFRASTRUCTURE ===
-    | 'command'            // CLI commands
-    | 'task'               // Background tasks/jobs
-    | 'event'              // Event types/handlers
-    | 'protocol';          // Python protocols, abstract classes
-
-/**
- * A single indexed pattern entry.
- */
-export interface PatternEntry {
-    /** Unique identifier (hash of file + name) */
-    id: string;
-
-    /** The type of pattern */
-    type: PatternType;
-
-    /** Name of the pattern (e.g., "formatDate") */
-    name: string;
-
-    /** Relative path to the file */
-    file: string;
-
-    /** Line number where the pattern is defined */
-    line: number;
-
-    /** End line number */
-    endLine: number;
-
-    /** Function/method signature if applicable */
-    signature: string;
-
-    /** Description from JSDoc/docstring */
-    description: string;
-
-    /** Extracted semantic keywords for matching */
-    keywords: string[];
-
-    /** Content hash for change detection */
-    hash: string;
-
-    /** Is this pattern exported? */
-    exported: boolean;
-
-    /** How many files import this pattern */
-    usageCount: number;            // How many files import this?
-
-    /** User-defined category/grouping */
-    category?: string;             // User-defined grouping
-    embedding?: number[];          // Vector embedding for semantic search
-
-    /** Last indexed timestamp */
-    indexedAt: string;
-}
-
-/**
- * The complete pattern index structure.
- */
-export interface PatternIndex {
-    /** Index format version */
-    version: string;
-
-    /** When the index was last updated */
-    lastUpdated: string;
-
-    /** Root directory that was indexed */
-    rootDir: string;
-
-    /** All indexed patterns */
-    patterns: PatternEntry[];
-
-    /** Index statistics */
-    stats: PatternIndexStats;
-
-    /** Files that were indexed */
-    files: IndexedFile[];
-}
-
-/**
- * Statistics about the pattern index.
- */
-export interface PatternIndexStats {
-    totalPatterns: number;
-    totalFiles: number;
-    byType: Record<PatternType, number>;
-    indexDurationMs: number;
-}
-
-/**
- * Information about an indexed file.
- */
-export interface IndexedFile {
-    path: string;
-    hash: string;
-    patternCount: number;
-    indexedAt: string;
-}
-
-/**
- * Configuration for the pattern indexer.
- */
-export interface PatternIndexConfig {
-    /** Directories to index (defaults to src/) */
-    include: string[];
-
-    /** Directories to exclude */
-    exclude: string[];
-
-    /** File extensions to index */
-    extensions: string[];
-
-    /** Whether to index test files */
-    indexTests: boolean;
-
-    /** Whether to index node_modules */
-    indexNodeModules: boolean;
-
-    /** Minimum pattern name length to index */
-    minNameLength: number;
-
-    /** Custom categories for patterns */
-    categories: Record<string, string[]>;
-
-    /** Whether to generate semantic embeddings for patterns */
-    useEmbeddings?: boolean;
-}
-
-/**
- * Result from matching against the pattern index.
- */
-export interface PatternMatchResult {
-    /** The query that was matched */
-    query: string;
-
-    /** All matches found */
-    matches: PatternMatch[];
-
-    /** Suggestion for what to do */
-    suggestion: string;
-
-    /** Whether human override is available */
-    canOverride: boolean;
-
-    /** Overall status */
-    status: 'FOUND_SIMILAR' | 'NO_MATCH' | 'OVERRIDE_ALLOWED';
-
-    /** Recommended action */
-    action: 'BLOCK' | 'WARN' | 'ALLOW';
-}
-
-/**
- * A single pattern match.
- */
-export interface PatternMatch {
-    /** The matched pattern */
-    pattern: PatternEntry;
-
-    /** How the match was determined */
-    matchType: 'exact' | 'fuzzy' | 'signature' | 'semantic';
-
-    /** Confidence score 0-100 */
-    confidence: number;
-
-    /** Human-readable reason for the match */
-    reason: string;
-}
-
-/**
- * Human override entry.
- */
-export interface PatternOverride {
-    /** Pattern name or glob */
-    pattern: string;
-
-    /** Why the override was granted */
-    reason: string;
-
-    /** When the override expires */
-    expiresAt?: string;
-
-    /** Who approved the override */
-    approvedBy?: string;
-
-    /** When the override was created */
-    createdAt: string;
-}
-
-/**
- * Staleness detection result.
- */
-export interface StalenessResult {
-    /** Overall status */
-    status: 'FRESH' | 'STALE' | 'DEPRECATED';
-
-    /** All staleness issues found */
-    issues: StalenessIssue[];
-
-    /** Project context (versions) */
-    projectContext: Record<string, string>;
-}
-
-/**
- * A single staleness issue.
- */
-export interface StalenessIssue {
-    /** Line number */
-    line: number;
-
-    /** The stale pattern */
-    pattern: string;
-
-    /** Severity */
-    severity: 'error' | 'warning' | 'info';
-
-    /** Why it's stale */
-    reason: string;
-
-    /** What to use instead */
-    replacement: string;
-
-    /** Link to documentation */
-    docs?: string;
-}
-
-/**
- * Security/CVE entry for a package.
- */
-export interface SecurityEntry {
-    /** CVE Identifier (e.g., CVE-2021-1234) */
-    cveId: string;
-
-    /** Package name */
-    packageName: string;
-
-    /** Vulnerable version range (semver) */
-    vulnerableRange: string;
-
-    /** Severity level */
-    severity: 'critical' | 'high' | 'moderate' | 'low';
-
-    /** Brief description of the vulnerability */
-    title: string;
-
-    /** Link to advisory */
-    url: string;
-
-    /** The version of the package in the current project */
-    currentVersion?: string;
-}
-
-/**
- * Result from security check.
- */
-export interface SecurityResult {
-    /** Overall security status */
-    status: 'SECURE' | 'VULNERABLE';
-
-    /** All CVEs/vulnerabilities found */
-    vulnerabilities: SecurityEntry[];
-}
-
-/**
- * Deprecation entry in the deprecation database.
- */
-export interface DeprecationEntry {
-    /** Pattern to match (can be regex) */
-    pattern: string;
-
-    /** Library this belongs to */
-    library?: string;
-
-    /** Version when deprecated */
-    deprecatedIn: string;
-
-    /** Suggested replacement */
-    replacement: string;
-
-    /** Severity level */
-    severity: 'error' | 'warning' | 'info';
-
-    /** Additional context */
-    reason?: string;
-
-    /** Documentation link */
-    docs?: string;
-}

package/src/safety.test.ts

@@ -1,53 +0,0 @@
-import { describe, it, expect, vi } from 'vitest';
-import { FileGuardGate } from './gates/safety.js';
-import { Gates } from './types/index.js';
-import { execa } from 'execa';
-
-vi.mock('execa');
-
-describe('FileGuardGate', () => {
-    const config: Gates = {
-        safety: {
-            protected_paths: ['docs/'],
-            max_files_changed_per_cycle: 10
-        }
-    } as any;
-
-    it('should flag modified (M) protected files', async () => {
-        const gate = new FileGuardGate(config);
-        vi.mocked(execa).mockResolvedValueOnce({ stdout: ' M docs/SPEC.md\n' } as any);
-
-        const failures = await gate.run({ cwd: '/test', record: {} as any });
-        expect(failures).toHaveLength(1);
-        expect(failures[0].title).toContain("Protected file 'docs/SPEC.md' was modified.");
-    });
-
-    it('should flag added (A) protected files', async () => {
-        const gate = new FileGuardGate(config);
-        vi.mocked(execa).mockResolvedValueOnce({ stdout: 'A  docs/NEW.md\n' } as any);
-
-        const failures = await gate.run({ cwd: '/test', record: {} as any });
-        expect(failures).toHaveLength(1);
-        expect(failures[0].title).toContain("Protected file 'docs/NEW.md' was modified.");
-    });
-
-    it('should NOT flag untracked (??) protected files', async () => {
-        const gate = new FileGuardGate(config);
-        vi.mocked(execa).mockResolvedValueOnce({ stdout: '?? docs/UNTRAKED.md\n' } as any);
-
-        const failures = await gate.run({ cwd: '/test', record: {} as any });
-        expect(failures).toHaveLength(0);
-    });
-
-    it('should correctly handle multiple mixed statuses', async () => {
-        const gate = new FileGuardGate(config);
-        vi.mocked(execa).mockResolvedValueOnce({
-            stdout: ' M docs/MODIFIED.md\n?? docs/NEW_UNTRACKED.md\n D docs/DELETED.md\n'
-        } as any);
-
-        const failures = await gate.run({ cwd: '/test', record: {} as any });
-        expect(failures).toHaveLength(2);
-        expect(failures.map(f => f.title)).toContain("Protected file 'docs/MODIFIED.md' was modified.");
-        expect(failures.map(f => f.title)).toContain("Protected file 'docs/DELETED.md' was modified.");
-    });
-});

package/src/services/adaptive-thresholds.test.ts

@@ -1,189 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import {
-    detectComplexityTier,
-    calculateAdaptiveThresholds,
-    recordGateRun,
-    getQualityTrend,
-    clearAdaptiveHistory,
-    getAdaptiveSummary,
-} from './adaptive-thresholds.js';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-
-describe('AdaptiveThresholds', () => {
-    let testDir: string;
-
-    beforeEach(() => {
-        testDir = fs.mkdtempSync(path.join(os.tmpdir(), 'adaptive-test-'));
-    });
-
-    afterEach(() => {
-        clearAdaptiveHistory(testDir);
-        fs.rmSync(testDir, { recursive: true, force: true });
-    });
-
-    describe('detectComplexityTier', () => {
-        it('should detect hobby tier for small projects', () => {
-            const tier = detectComplexityTier({ fileCount: 20 });
-            expect(tier).toBe('hobby');
-        });
-
-        it('should detect startup tier for medium projects', () => {
-            const tier = detectComplexityTier({ fileCount: 100 });
-            expect(tier).toBe('startup');
-        });
-
-        it('should detect enterprise tier for large projects', () => {
-            const tier = detectComplexityTier({ fileCount: 600 });
-            expect(tier).toBe('enterprise');
-        });
-
-        it('should consider commit count for tier detection', () => {
-            const tier = detectComplexityTier({ fileCount: 50, commitCount: 1500 });
-            expect(tier).toBe('enterprise');
-        });
-    });
-
-    describe('calculateAdaptiveThresholds', () => {
-        it('should return lenient thresholds for hobby tier', () => {
-            const adjustments = calculateAdaptiveThresholds(
-                testDir,
-                { fileCount: 20 }
-            );
-
-            expect(adjustments.tier).toBe('hobby');
-            expect(adjustments.coverageThreshold).toBeLessThan(80);
-            expect(adjustments.securityBlockLevel).toBe('critical');
-            expect(adjustments.leniencyFactor).toBeGreaterThan(0.5);
-        });
-
-        it('should return strict thresholds for enterprise tier', () => {
-            const adjustments = calculateAdaptiveThresholds(
-                testDir,
-                { fileCount: 600 }
-            );
-
-            expect(adjustments.tier).toBe('enterprise');
-            expect(adjustments.coverageThreshold).toBe(80);
-            expect(adjustments.securityBlockLevel).toBe('medium');
-            expect(adjustments.leniencyFactor).toBeLessThan(0.5);
-        });
-
-        it('should respect forced_tier config', () => {
-            const adjustments = calculateAdaptiveThresholds(
-                testDir,
-                { fileCount: 20 },
-                { forced_tier: 'enterprise' }
-            );
-
-            expect(adjustments.tier).toBe('enterprise');
-        });
-
-        it('should include reasoning for adjustments', () => {
-            const adjustments = calculateAdaptiveThresholds(
-                testDir,
-                { fileCount: 100 }
-            );
-
-            expect(adjustments.reasoning.length).toBeGreaterThan(0);
-            expect(adjustments.reasoning.some(r => r.includes('tier'))).toBe(true);
-        });
-    });
-
-    describe('historical tracking', () => {
-        it('should record gate runs', () => {
-            recordGateRun(testDir, 5, 2, 10);
-            recordGateRun(testDir, 6, 1, 5);
-
-            const historyPath = path.join(testDir, '.rigour', 'adaptive-history.json');
-            expect(fs.existsSync(historyPath)).toBe(true);
-
-            const history = JSON.parse(fs.readFileSync(historyPath, 'utf-8'));
-            expect(history.runs).toHaveLength(2);
-        });
-
-        it('should return stable trend for new projects', () => {
-            const trend = getQualityTrend(testDir);
-            expect(trend).toBe('stable');
-        });
-
-        it('should detect improving trend', () => {
-            // Record 20 runs: older ones with high failures, recent with low
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 3, 5, 20);
-            }
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 7, 1, 5);
-            }
-
-            const trend = getQualityTrend(testDir);
-            expect(trend).toBe('improving');
-        });
-
-        it('should detect degrading trend', () => {
-            // Record 20 runs: older ones with low failures, recent with high
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 7, 1, 3);
-            }
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 3, 5, 20);
-            }
-
-            const trend = getQualityTrend(testDir);
-            expect(trend).toBe('degrading');
-        });
-    });
-
-    describe('trend-based adjustments', () => {
-        it('should relax thresholds for improving trend', () => {
-            // Create improving history
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 3, 5, 20);
-            }
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 7, 1, 5);
-            }
-
-            const adjustments = calculateAdaptiveThresholds(
-                testDir,
-                { fileCount: 100 }
-            );
-
-            expect(adjustments.trend).toBe('improving');
-            expect(adjustments.reasoning.some(r => r.includes('bonus'))).toBe(true);
-        });
-
-        it('should tighten thresholds for degrading trend', () => {
-            // Create degrading history
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 7, 1, 3);
-            }
-            for (let i = 0; i < 10; i++) {
-                recordGateRun(testDir, 3, 5, 20);
-            }
-
-            const adjustments = calculateAdaptiveThresholds(
-                testDir,
-                { fileCount: 100 }
-            );
-
-            expect(adjustments.trend).toBe('degrading');
-            expect(adjustments.reasoning.some(r => r.includes('tightened'))).toBe(true);
-        });
-    });
-
-    describe('getAdaptiveSummary', () => {
-        it('should return formatted summary string', () => {
-            const adjustments = calculateAdaptiveThresholds(
-                testDir,
-                { fileCount: 100 }
-            );
-
-            const summary = getAdaptiveSummary(adjustments);
-            expect(summary).toContain('STARTUP');
-            expect(summary).toContain('Coverage:');
-            expect(summary).toContain('Quality:');
-        });
-    });
-});