guardrail-core 1.0.0

package/src/autopilot/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Autopilot Module Exports
+ */
+
+export * from './types';
+export { AutopilotRunner, autopilotRunner, runAutopilot } from './autopilot-runner';

package/src/autopilot/types.ts

@@ -0,0 +1,119 @@
+/**
+ * Autopilot Mode Types
+ * 
+ * Type definitions for the Autopilot batch remediation system.
+ * PRO/COMPLIANCE+ feature.
+ */
+
+export type AutopilotMode = 'plan' | 'apply';
+
+export type AutopilotFixPackCategory = 
+  | 'security'
+  | 'quality'
+  | 'type-errors'
+  | 'build-blockers'
+  | 'test-failures'
+  | 'placeholders'
+  | 'route-integrity';
+
+export interface AutopilotFinding {
+  id: string;
+  category: AutopilotFixPackCategory;
+  severity: 'critical' | 'high' | 'medium' | 'low';
+  file: string;
+  line: number;
+  message: string;
+  fixable: boolean;
+}
+
+export interface AutopilotFixPack {
+  id: string;
+  category: AutopilotFixPackCategory;
+  name: string;
+  description: string;
+  findings: AutopilotFinding[];
+  estimatedRisk: 'low' | 'medium' | 'high';
+  impactedFiles: string[];
+  priority: number;
+}
+
+export interface AutopilotOptions {
+  projectPath: string;
+  mode: AutopilotMode;
+  profile?: 'quick' | 'full' | 'ship' | 'ci';
+  maxFixes?: number;
+  verify?: boolean;
+  branchStrategy?: 'none' | 'worktree' | 'copy';
+  dryRun?: boolean;
+  json?: boolean;
+  onProgress?: (stage: string, message: string) => void;
+}
+
+export interface AutopilotVerificationResult {
+  passed: boolean;
+  typecheck: { passed: boolean; errors: string[] };
+  build: { passed: boolean; errors: string[] };
+  tests: { passed: boolean; errors: string[] };
+  duration: number;
+}
+
+export interface AppliedFix {
+  packId: string;
+  findingId: string;
+  file: string;
+  success: boolean;
+  error?: string;
+}
+
+export interface AutopilotPlanResult {
+  mode: 'plan';
+  projectPath: string;
+  profile: string;
+  timestamp: string;
+  totalFindings: number;
+  fixableFindings: number;
+  packs: AutopilotFixPack[];
+  estimatedDuration: string;
+  riskAssessment: {
+    low: number;
+    medium: number;
+    high: number;
+  };
+}
+
+export interface AutopilotApplyResult {
+  mode: 'apply';
+  projectPath: string;
+  profile: string;
+  timestamp: string;
+  startTime: string;
+  endTime: string;
+  duration: number;
+  packsAttempted: number;
+  packsSucceeded: number;
+  packsFailed: number;
+  appliedFixes: AppliedFix[];
+  verification: AutopilotVerificationResult | null;
+  remainingFindings: number;
+  newScanVerdict: 'pass' | 'fail' | 'skipped';
+  errors: string[];
+}
+
+export type AutopilotResult = AutopilotPlanResult | AutopilotApplyResult;
+
+export interface AutopilotScanResult {
+  findings: AutopilotFinding[];
+  score: number;
+  verdict: 'pass' | 'fail';
+  duration: number;
+}
+
+export const AUTOPILOT_FIX_PACK_PRIORITY: Record<AutopilotFixPackCategory, number> = {
+  'security': 1,
+  'build-blockers': 2,
+  'type-errors': 3,
+  'test-failures': 4,
+  'route-integrity': 5,
+  'placeholders': 6,
+  'quality': 7,
+};

package/src/cache/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Cache Module
+ * 
+ * Provides caching utilities for Guardrail AI
+ */
+
+export * from './redis-cache';

package/src/cache/redis-cache.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Redis Caching Layer
+ *
+ * Production-ready caching implementation with:
+ * - Connection pooling
+ * - Automatic serialization/deserialization
+ * - TTL management
+ * - Cache invalidation patterns
+ * - Metrics tracking
+ */
+export interface RedisCacheConfig {
+  host: string;
+  port: number;
+  password?: string;
+  db?: number;
+  keyPrefix?: string;
+  defaultTTL?: number;
+  maxRetries?: number;
+  retryDelay?: number;
+  enableMetrics?: boolean;
+}
+export interface CacheEntry<T> {
+  value: T;
+  createdAt: number;
+  expiresAt: number;
+  tags?: string[];
+}
+export interface CacheStats {
+  hits: number;
+  misses: number;
+  sets: number;
+  deletes: number;
+  errors: number;
+  hitRate: number;
+  avgLatency: number;
+}
+export declare class RedisCache {
+  private client;
+  private config;
+  private stats;
+  private latencies;
+  private connected;
+  private memoryFallback;
+  constructor(config?: Partial<RedisCacheConfig>);
+  /**
+   * Connect to Redis
+   */
+  connect(): Promise<void>;
+  /**
+   * Disconnect from Redis
+   */
+  disconnect(): Promise<void>;
+  /**
+   * Get prefixed key
+   */
+  private getKey;
+  /**
+   * Get value from cache
+   */
+  get<T>(key: string): Promise<T | null>;
+  /**
+   * Set value in cache
+   */
+  set<T>(
+    key: string,
+    value: T,
+    ttl?: number,
+    tags?: string[],
+  ): Promise<boolean>;
+  /**
+   * Delete value from cache
+   */
+  delete(key: string): Promise<boolean>;
+  /**
+   * Delete multiple keys by pattern
+   */
+  deletePattern(pattern: string): Promise<number>;
+  /**
+   * Invalidate cache by tag
+   */
+  invalidateByTag(tag: string): Promise<number>;
+  /**
+   * Add key to tag set
+   */
+  private addKeyToTag;
+  /**
+   * Check if key exists
+   */
+  exists(key: string): Promise<boolean>;
+  /**
+   * Get remaining TTL
+   */
+  getTTL(key: string): Promise<number>;
+  /**
+   * Get or set (cache-aside pattern)
+   */
+  getOrSet<T>(
+    key: string,
+    factory: () => Promise<T>,
+    ttl?: number,
+    tags?: string[],
+  ): Promise<T>;
+  /**
+   * Flush all cache
+   */
+  flush(): Promise<boolean>;
+  /**
+   * Health check
+   */
+  ping(): Promise<boolean>;
+  /**
+   * Get cache statistics
+   */
+  getStats(): CacheStats;
+  /**
+   * Reset statistics
+   */
+  resetStats(): void;
+  /**
+   * Record latency for metrics
+   */
+  private recordLatency;
+  /**
+   * Update hit rate
+   */
+  private updateHitRate;
+  /**
+   * Check if connected to Redis
+   */
+  isConnected(): boolean;
+}
+export declare const CacheKeys: {
+  scanResult: (projectId: string, scanType: string) => string;
+  knowledgeBase: (projectPath: string) => string;
+  embedding: (contentHash: string) => string;
+  vulnerability: (packageName: string, version: string) => string;
+  license: (packageName: string) => string;
+  compliance: (projectId: string, framework: string) => string;
+  session: (sessionId: string) => string;
+  rateLimit: (identifier: string, action: string) => string;
+};
+export declare const CacheTTL: {
+  SHORT: number;
+  MEDIUM: number;
+  LONG: number;
+  WEEK: number;
+  SCAN_RESULT: number;
+  KNOWLEDGE: number;
+  EMBEDDING: number;
+  VULNERABILITY: number;
+  LICENSE: number;
+  SESSION: number;
+};
+export declare const cache: RedisCache;
+//# sourceMappingURL=redis-cache.d.ts.map

package/src/cache/redis-cache.d.ts.map

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