@codeledger/cli 0.6.2 → 0.6.4

package/dist/review-intelligence/standards-discovery.js

@@ -0,0 +1,221 @@
+import { readFileSync, readdirSync, statSync, existsSync } from 'node:fs';
+import { join, extname } from 'node:path';
+/** Maximum files to scan during discovery */
+const MAX_DISCOVERY_FILES = 200;
+/** Minimum import/usage count to qualify as a "standard" */
+const MIN_USAGE_COUNT = 2;
+/**
+ * Discover repository-standard helpers, wrappers, and patterns
+ * by analyzing import frequency and repeated usage patterns.
+ *
+ * Uses lightweight heuristics:
+ *   - import frequency analysis
+ *   - repeated wrapper/helper name detection
+ *   - callsite clustering in utility/helper directories
+ */
+export function discoverRepoStandards(cwd, changedFiles) {
+    const standards = [];
+    // Collect analyzable files from common helper/utility directories
+    const helperDirs = findHelperDirectories(cwd);
+    const helperFiles = collectHelperFiles(cwd, helperDirs);
+    // Also scan the changed files and their siblings
+    const relevantFiles = new Set();
+    for (const f of changedFiles) {
+        relevantFiles.add(f);
+    }
+    for (const f of helperFiles) {
+        relevantFiles.add(f);
+    }
+    // Analyze exports from helper files to identify standard patterns
+    const exportedHelpers = analyzeHelperExports(cwd, helperFiles);
+    // Count usage of these helpers across the codebase
+    const usageCounts = countHelperUsage(cwd, exportedHelpers, relevantFiles);
+    // Build standards from sufficiently-used helpers
+    for (const [helperName, info] of usageCounts.entries()) {
+        if (info.count >= MIN_USAGE_COUNT) {
+            standards.push({
+                helper_name: helperName,
+                example_paths: info.definedIn,
+                recommendation: `Use ${helperName} from ${info.definedIn[0] ?? 'shared helpers'}`,
+                usage_count: info.count,
+            });
+        }
+    }
+    return standards;
+}
+/**
+ * Find directories likely to contain shared helpers/utilities.
+ */
+function findHelperDirectories(cwd) {
+    const candidates = [
+        'src/utils',
+        'src/helpers',
+        'src/lib',
+        'src/shared',
+        'src/common',
+        'lib',
+        'utils',
+        'helpers',
+        'shared',
+        'common',
+    ];
+    const found = [];
+    // Also check packages/*/src/{utils,helpers,lib,shared,common}
+    const packagesDir = join(cwd, 'packages');
+    if (existsSync(packagesDir)) {
+        try {
+            const pkgs = readdirSync(packagesDir);
+            for (const pkg of pkgs) {
+                const pkgDir = join('packages', pkg);
+                for (const sub of ['src/utils', 'src/helpers', 'src/lib', 'src/shared', 'src/common', 'utils', 'helpers', 'lib']) {
+                    candidates.push(join(pkgDir, sub));
+                }
+            }
+        }
+        catch {
+            // Skip if can't read packages dir
+        }
+    }
+    for (const candidate of candidates) {
+        const fullPath = join(cwd, candidate);
+        if (existsSync(fullPath)) {
+            try {
+                const stat = statSync(fullPath);
+                if (stat.isDirectory()) {
+                    found.push(candidate);
+                }
+            }
+            catch {
+                // Skip inaccessible directories
+            }
+        }
+    }
+    return found;
+}
+/**
+ * Collect TypeScript/JavaScript files from helper directories.
+ */
+function collectHelperFiles(cwd, dirs) {
+    const files = [];
+    const analyzableExts = new Set(['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs']);
+    for (const dir of dirs) {
+        const fullDir = join(cwd, dir);
+        try {
+            const entries = readdirSync(fullDir);
+            for (const entry of entries) {
+                if (files.length >= MAX_DISCOVERY_FILES)
+                    break;
+                const ext = extname(entry);
+                if (analyzableExts.has(ext) && !entry.endsWith('.test.ts') && !entry.endsWith('.spec.ts')) {
+                    files.push(join(dir, entry));
+                }
+            }
+        }
+        catch {
+            // Skip unreadable directories
+        }
+    }
+    return files;
+}
+/**
+ * Analyze helper files for exported functions/classes that look like
+ * shared utilities.
+ */
+function analyzeHelperExports(cwd, helperFiles) {
+    const helpers = [];
+    for (const filePath of helperFiles) {
+        const fullPath = join(cwd, filePath);
+        let content;
+        try {
+            content = readFileSync(fullPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        // Find exported function/const/class names
+        const exportPattern = /export\s+(?:async\s+)?(?:function|const|class)\s+(\w+)/g;
+        let match;
+        while ((match = exportPattern.exec(content)) !== null) {
+            const name = match[1];
+            const category = categorizeHelper(name, content);
+            helpers.push({ name, filePath, category });
+        }
+        // Also find export { name } patterns
+        const reExportPattern = /export\s*\{([^}]+)\}/g;
+        while ((match = reExportPattern.exec(content)) !== null) {
+            const names = match[1].split(',').map((n) => n.trim().split(/\s+as\s+/)[0].trim());
+            for (const name of names) {
+                if (name && /^[a-zA-Z_]/.test(name)) {
+                    const category = categorizeHelper(name, content);
+                    helpers.push({ name, filePath, category });
+                }
+            }
+        }
+    }
+    return helpers;
+}
+function categorizeHelper(name, content) {
+    const lower = name.toLowerCase();
+    if (lower.includes('fetch') || lower.includes('http') || lower.includes('request') || lower.includes('api')) {
+        return 'fetch';
+    }
+    if (lower.includes('error') || lower.includes('response') || lower.includes('reply')) {
+        return 'error';
+    }
+    if (lower.includes('cache') || lower.includes('redis') || lower.includes('key')) {
+        return 'cache';
+    }
+    if (lower.includes('valid') || lower.includes('schema') || lower.includes('parse')) {
+        return 'validation';
+    }
+    if (lower.includes('rate') || lower.includes('limit') || lower.includes('throttle')) {
+        return 'rate_limit';
+    }
+    // Also check content context
+    if (/fetch|axios|http\.request/.test(content))
+        return 'fetch';
+    if (/redis|cache/.test(content))
+        return 'cache';
+    return 'general';
+}
+/**
+ * Count how many files import or reference each discovered helper.
+ */
+function countHelperUsage(cwd, helpers, filesToScan) {
+    const usage = new Map();
+    // Initialize with helper definitions
+    for (const helper of helpers) {
+        const existing = usage.get(helper.name);
+        if (existing) {
+            if (!existing.definedIn.includes(helper.filePath)) {
+                existing.definedIn.push(helper.filePath);
+            }
+        }
+        else {
+            usage.set(helper.name, { count: 0, definedIn: [helper.filePath] });
+        }
+    }
+    // Count imports/usage across scanned files
+    for (const filePath of filesToScan) {
+        const fullPath = join(cwd, filePath);
+        let content;
+        try {
+            content = readFileSync(fullPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        for (const helper of helpers) {
+            // Skip counting usage in the file where it's defined
+            if (filePath === helper.filePath)
+                continue;
+            // Check for import or direct usage
+            if (content.includes(helper.name)) {
+                const info = usage.get(helper.name);
+                info.count++;
+            }
+        }
+    }
+    return usage;
+}
+//# sourceMappingURL=standards-discovery.js.map

package/dist/review-intelligence/standards-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards-discovery.js","sourceRoot":"","sources":["../../src/review-intelligence/standards-discovery.ts"],"names":[],"mappings":"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"}

package/dist/review-intelligence/triggers.d.ts

@@ -0,0 +1,15 @@
+import type { DetectedTrigger } from './types.js';
+/**
+ * Scan file content for trigger patterns. Returns all detected triggers
+ * with file path, line number, and matched text.
+ */
+export declare function detectTriggers(filePath: string, content: string): DetectedTrigger[];
+/**
+ * Check if triggers indicate typed route definitions (Body/Params/Querystring).
+ */
+export declare function isTypedRouteTrigger(trigger: DetectedTrigger): boolean;
+/**
+ * Check if triggers indicate outbound I/O.
+ */
+export declare function isOutboundIOTrigger(trigger: DetectedTrigger): boolean;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/review-intelligence/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/review-intelligence/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AA8D/D;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAkCnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAMrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAMrE"}

package/dist/review-intelligence/triggers.js

@@ -0,0 +1,104 @@
+const TRIGGER_PATTERNS = [
+    // Fastify route definitions
+    {
+        type: 'fastify_route',
+        pattern: /\b(?:server|app|fastify|instance)\s*\.\s*(?:get|post|put|patch|delete|head|options|all|route)\s*[<(]/,
+    },
+    // Typed route body
+    {
+        type: 'typed_route_body',
+        pattern: /[<{]\s*(?:Body|body)\s*:/,
+    },
+    // Typed route params
+    {
+        type: 'typed_route_params',
+        pattern: /[<{]\s*(?:Params|params)\s*:/,
+    },
+    // Typed route query
+    {
+        type: 'typed_route_query',
+        pattern: /[<{]\s*(?:Querystring|querystring|Query|query)\s*:/,
+    },
+    // fetch() calls
+    {
+        type: 'fetch_call',
+        pattern: /\bfetch\s*\(/,
+    },
+    // axios calls
+    {
+        type: 'axios_call',
+        pattern: /\baxios\s*(?:\.\s*(?:get|post|put|patch|delete|head|options|request))?\s*\(/,
+    },
+    // http.request / https.request
+    {
+        type: 'http_request',
+        pattern: /\b(?:https?)\s*\.\s*(?:request|get)\s*\(/,
+    },
+    // Raw error responses (reply.status(...).send / res.status(...).send / res.status(...).json)
+    {
+        type: 'raw_error_response',
+        pattern: /\b(?:reply|res|response)\s*\.\s*(?:status|code)\s*\(\s*(?:4\d{2}|5\d{2})\s*\)/,
+    },
+    // Redis/cache key construction
+    {
+        type: 'redis_cache_key',
+        pattern: /\b(?:redis|cache|client)\s*\.\s*(?:get|set|del|hget|hset|sadd|srem|zadd|zrem|expire|ttl)\s*\(\s*[`'"]/,
+    },
+    // Circuit breaker
+    {
+        type: 'circuit_breaker',
+        pattern: /\b(?:circuitBreaker|circuit_breaker|breaker)\s*\.\s*(?:fire|execute|run|call)\s*\(/,
+    },
+];
+/**
+ * Scan file content for trigger patterns. Returns all detected triggers
+ * with file path, line number, and matched text.
+ */
+export function detectTriggers(filePath, content) {
+    const triggers = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip comments and import lines
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*')) {
+            continue;
+        }
+        if (trimmed.startsWith('import ') || trimmed.startsWith('import{')) {
+            continue;
+        }
+        for (const tp of TRIGGER_PATTERNS) {
+            const match = tp.pattern.exec(line);
+            if (match) {
+                // Skip if it's a type import or type definition
+                if (/\btype\b/.test(line) && !line.includes('('))
+                    continue;
+                triggers.push({
+                    type: tp.type,
+                    file: filePath,
+                    line: i + 1,
+                    matched_text: match[0],
+                    context: trimmed.length > 120 ? trimmed.slice(0, 120) + '...' : trimmed,
+                });
+            }
+        }
+    }
+    return triggers;
+}
+/**
+ * Check if triggers indicate typed route definitions (Body/Params/Querystring).
+ */
+export function isTypedRouteTrigger(trigger) {
+    return (trigger.type === 'typed_route_body' ||
+        trigger.type === 'typed_route_params' ||
+        trigger.type === 'typed_route_query');
+}
+/**
+ * Check if triggers indicate outbound I/O.
+ */
+export function isOutboundIOTrigger(trigger) {
+    return (trigger.type === 'fetch_call' ||
+        trigger.type === 'axios_call' ||
+        trigger.type === 'http_request');
+}
+//# sourceMappingURL=triggers.js.map

package/dist/review-intelligence/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/review-intelligence/triggers.ts"],"names":[],"mappings":"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"}

package/dist/review-intelligence/types.d.ts

@@ -0,0 +1,137 @@
+/** Severity levels for review intelligence findings */
+export type ReviewSeverity = 'P0' | 'P1' | 'P2' | 'P3';
+/** Categories of review intelligence findings */
+export type FindingCategory = 'runtime_validation' | 'outbound_io' | 'platform_helpers';
+/** Confidence level of a finding */
+export type FindingConfidence = 'high' | 'medium' | 'low';
+/** A trigger detected in source code */
+export interface DetectedTrigger {
+    /** Type of trigger pattern found */
+    type: TriggerType;
+    /** File where trigger was found */
+    file: string;
+    /** Line number (1-based) */
+    line: number;
+    /** The matched source text */
+    matched_text: string;
+    /** Additional context about the trigger */
+    context?: string;
+}
+export type TriggerType = 'fastify_route' | 'typed_route_body' | 'typed_route_params' | 'typed_route_query' | 'fetch_call' | 'axios_call' | 'http_request' | 'raw_error_response' | 'redis_cache_key' | 'circuit_breaker';
+/** A companion safeguard expected alongside a trigger */
+export interface ExpectedCompanion {
+    /** What kind of companion is expected */
+    type: CompanionType;
+    /** Human-readable description of what is expected */
+    description: string;
+    /** Whether the companion was found */
+    found: boolean;
+    /** Where the companion was found, if present */
+    evidence?: string;
+}
+export type CompanionType = 'zod_validation' | 'ajv_validation' | 'fastify_schema' | 'abort_controller' | 'timeout_config' | 'sanctioned_wrapper' | 'shared_error_helper' | 'shared_cache_helper' | 'shared_middleware';
+/** A discovered repository standard (helper, wrapper, pattern) */
+export interface RepoStandard {
+    /** Name of the helper/wrapper/pattern */
+    helper_name: string;
+    /** File paths where this standard is defined or commonly used */
+    example_paths: string[];
+    /** Short recommendation text */
+    recommendation: string;
+    /** How many times this pattern is used in the repo */
+    usage_count: number;
+}
+/** A review intelligence finding */
+export interface ReviewFinding {
+    /** Unique rule identifier */
+    rule_id: string;
+    /** Human-readable title */
+    title: string;
+    /** Severity level */
+    severity: ReviewSeverity;
+    /** Finding category */
+    category: FindingCategory;
+    /** File where the issue was found */
+    file: string;
+    /** Line number (1-based) */
+    line: number;
+    /** What triggered the finding */
+    trigger: string;
+    /** Missing companion safeguards */
+    missing_companions: string[];
+    /** Why this matters */
+    why_it_matters: string;
+    /** Repository standard that should be used, if discovered */
+    repo_standard?: RepoStandard;
+    /** Confidence level */
+    confidence: FindingConfidence;
+}
+/** Configuration for an individual invariant module */
+export interface InvariantConfig {
+    enabled: boolean;
+}
+/** Policy configuration for Review Intelligence */
+export interface ReviewIntelligencePolicy {
+    enabled: boolean;
+    severity_threshold: ReviewSeverity;
+    invariants: {
+        runtime_validation: InvariantConfig;
+        outbound_io: InvariantConfig;
+        platform_helpers: InvariantConfig;
+    };
+}
+/** Result of running the review intelligence engine */
+export interface ReviewIntelligenceResult {
+    /** All findings, sorted by severity then file */
+    findings: ReviewFinding[];
+    /** Discovered repo standards */
+    repo_standards: RepoStandard[];
+    /** Summary counts by severity */
+    summary: {
+        p0: number;
+        p1: number;
+        p2: number;
+        p3: number;
+        total: number;
+    };
+    /** Overall status */
+    status: 'PASS' | 'WARN' | 'FAIL';
+    /** Duration in milliseconds */
+    duration_ms: number;
+}
+/** Options for running the review intelligence engine */
+export interface ReviewIntelligenceOptions {
+    /** Root directory of the repository */
+    cwd: string;
+    /** Files to analyze (changed/relevant files) */
+    files: string[];
+    /** Policy configuration */
+    policy: ReviewIntelligencePolicy;
+    /** Whether to include verbose reasoning */
+    explain: boolean;
+    /** Whether to include debug details */
+    debug: boolean;
+    /** Narrow to specific invariant module */
+    invariant?: string;
+}
+/** Interface that detector modules implement */
+export interface InvariantDetector {
+    /** Unique module name */
+    name: FindingCategory;
+    /** Detect triggers and check invariants for a set of files */
+    analyze(ctx: DetectorContext): ReviewFinding[];
+}
+/** Context passed to each detector */
+export interface DetectorContext {
+    /** Root directory of the repository */
+    cwd: string;
+    /** Files to analyze (paths relative to cwd) */
+    files: string[];
+    /** File contents map (path → content) */
+    fileContents: Map<string, string>;
+    /** Discovered repo standards */
+    repoStandards: RepoStandard[];
+    /** Whether to include verbose reasoning */
+    explain: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/review-intelligence/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/review-intelligence/types.ts"],"names":[],"mappings":"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"}

package/dist/review-intelligence/types.js

@@ -0,0 +1,3 @@
+// ─── Review Intelligence Types ──────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/review-intelligence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/review-intelligence/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeledger/cli",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "type": "module",
   "description": "CLI for CodeLedger — deterministic context selection for AI coding agents",
   "license": "MIT",
@@ -27,14 +27,14 @@
     }
   },
   "dependencies": {
-    "@codeledger/types": "0.6.2",
-    "@codeledger/core": "0.6.2",
-    "@codeledger/core-engine": "0.6.2",
-    "@codeledger/repo": "0.6.2",
-    "@codeledger/instrument": "0.6.2",
-    "@codeledger/harness": "0.6.2",
-    "@codeledger/cowork": "0.6.2",
-    "@codeledger/selector": "0.6.2"
+    "@codeledger/types": "0.6.4",
+    "@codeledger/core": "0.6.4",
+    "@codeledger/core-engine": "0.6.4",
+    "@codeledger/repo": "0.6.4",
+    "@codeledger/instrument": "0.6.4",
+    "@codeledger/cowork": "0.6.4",
+    "@codeledger/selector": "0.6.4",
+    "@codeledger/harness": "0.6.4"
   },
   "devDependencies": {
     "typescript": "^5.4.0"