@codeledger/cli 0.6.3 → 0.6.4

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":"AAEA,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvD,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,aAAa,GACb,kBAAkB,CAAC;AAEvB,oCAAoC;AACpC,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE1D,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,oBAAoB,GACpB,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,IAAI,EAAE,aAAa,CAAC;IACpB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,CAAC;AAExB,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,uBAAuB;IACvB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,cAAc,CAAC;IACnC,UAAU,EAAE;QACV,kBAAkB,EAAE,eAAe,CAAC;QACpC,WAAW,EAAE,eAAe,CAAC;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC,CAAC;CACH;AAED,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,gCAAgC;IAChC,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,iCAAiC;IACjC,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,qBAAqB;IACrB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,wBAAwB,CAAC;IACjC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,IAAI,EAAE,eAAe,CAAC;IACtB,8DAA8D;IAC9D,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,aAAa,EAAE,CAAC;CAChD;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gCAAgC;IAChC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;CAClB"}

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.3",
+  "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.3",
-    "@codeledger/core-engine": "0.6.3",
-    "@codeledger/core": "0.6.3",
-    "@codeledger/repo": "0.6.3",
-    "@codeledger/harness": "0.6.3",
-    "@codeledger/selector": "0.6.3",
-    "@codeledger/instrument": "0.6.3",
-    "@codeledger/cowork": "0.6.3"
+    "@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"