@revealui/mcp 0.0.1-pre.0 → 0.1.0

package/dist/packages/core/src/utils/request-context.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Request Context Management
+ *
+ * Provides request ID generation and context propagation for distributed tracing.
+ * Request IDs enable tracking a single request across multiple services and logs.
+ *
+ * WARNING: This module uses Node.js-specific APIs (async_hooks, crypto).
+ * Do NOT import in client-side code or edge runtime.
+ */
+/**
+ * Request context data stored in AsyncLocalStorage
+ */
+export interface RequestContext {
+    /** Unique request identifier */
+    requestId: string;
+    /** Request start timestamp */
+    startTime: number;
+    /** User ID (if authenticated) */
+    userId?: string;
+    /** IP address */
+    ip?: string;
+    /** User agent */
+    userAgent?: string;
+    /** Request path */
+    path?: string;
+    /** Request method */
+    method?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Generate a new request ID
+ * Uses UUID v4 for guaranteed uniqueness
+ */
+export declare function generateRequestId(): string;
+/**
+ * Get the current request context
+ * Returns undefined if not in a request context
+ */
+export declare function getRequestContext(): RequestContext | undefined;
+/**
+ * Get the current request ID
+ * Returns undefined if not in a request context
+ */
+export declare function getRequestId(): string | undefined;
+/**
+ * Run a function within a request context
+ *
+ * @param context - Request context data
+ * @param fn - Function to run within the context
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * await runInRequestContext(
+ *   {
+ *     requestId: generateRequestId(),
+ *     startTime: Date.now(),
+ *     userId: 'user-123',
+ *     path: '/api/users',
+ *     method: 'GET',
+ *   },
+ *   async () => {
+ *     // All code here has access to request context
+ *     const requestId = getRequestId()
+ *     logger.info('Processing request', { requestId })
+ *   }
+ * )
+ * ```
+ */
+export declare function runInRequestContext<T>(context: RequestContext, fn: () => T): T;
+/**
+ * Update the current request context with additional data
+ *
+ * @param updates - Partial context updates to merge
+ *
+ * @example
+ * ```typescript
+ * updateRequestContext({ userId: 'user-123' })
+ * ```
+ */
+export declare function updateRequestContext(updates: Partial<RequestContext>): void;
+/**
+ * Extract request ID from various header formats
+ *
+ * Checks multiple common header names:
+ * - x-request-id (standard)
+ * - x-correlation-id (correlation pattern)
+ * - x-trace-id (OpenTelemetry)
+ * - request-id (simple)
+ *
+ * @param headers - Request headers (any format)
+ * @returns Request ID or undefined
+ */
+export declare function extractRequestId(headers: Record<string, string | string[] | undefined>): string | undefined;
+/**
+ * Create request context from HTTP request
+ *
+ * @param options - Request information
+ * @returns Request context
+ *
+ * @example
+ * ```typescript
+ * const context = createRequestContext({
+ *   headers: request.headers,
+ *   path: request.url,
+ *   method: request.method,
+ *   ip: request.ip,
+ * })
+ * ```
+ */
+export declare function createRequestContext(options: {
+    headers?: Record<string, string | string[] | undefined>;
+    path?: string;
+    method?: string;
+    ip?: string;
+    userId?: string;
+}): RequestContext;
+/**
+ * Get request duration in milliseconds
+ *
+ * @returns Duration in ms, or undefined if not in request context
+ */
+export declare function getRequestDuration(): number | undefined;
+/**
+ * Request context headers for propagating across services
+ *
+ * Use these when making HTTP requests to other services to maintain trace continuity
+ *
+ * @returns Headers object with request ID
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('https://api.example.com/users', {
+ *   headers: {
+ *     ...getRequestHeaders(),
+ *     'Authorization': 'Bearer token',
+ *   }
+ * })
+ * ```
+ */
+export declare function getRequestHeaders(): Record<string, string>;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/packages/core/src/utils/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../../../../core/src/utils/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IAEjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,iBAAiB;IACjB,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAK3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,cAAc,CAajB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAKvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1D"}

package/dist/packages/core/src/utils/request-context.js

@@ -0,0 +1,169 @@
+/**
+ * Request Context Management
+ *
+ * Provides request ID generation and context propagation for distributed tracing.
+ * Request IDs enable tracking a single request across multiple services and logs.
+ *
+ * WARNING: This module uses Node.js-specific APIs (async_hooks, crypto).
+ * Do NOT import in client-side code or edge runtime.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+/**
+ * AsyncLocalStorage for request context
+ * Provides request-scoped storage without passing context through every function
+ */
+const requestContextStorage = new AsyncLocalStorage();
+/**
+ * Generate a new request ID
+ * Uses UUID v4 for guaranteed uniqueness
+ */
+export function generateRequestId() {
+    return randomUUID();
+}
+/**
+ * Get the current request context
+ * Returns undefined if not in a request context
+ */
+export function getRequestContext() {
+    return requestContextStorage.getStore();
+}
+/**
+ * Get the current request ID
+ * Returns undefined if not in a request context
+ */
+export function getRequestId() {
+    return getRequestContext()?.requestId;
+}
+/**
+ * Run a function within a request context
+ *
+ * @param context - Request context data
+ * @param fn - Function to run within the context
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * await runInRequestContext(
+ *   {
+ *     requestId: generateRequestId(),
+ *     startTime: Date.now(),
+ *     userId: 'user-123',
+ *     path: '/api/users',
+ *     method: 'GET',
+ *   },
+ *   async () => {
+ *     // All code here has access to request context
+ *     const requestId = getRequestId()
+ *     logger.info('Processing request', { requestId })
+ *   }
+ * )
+ * ```
+ */
+export function runInRequestContext(context, fn) {
+    return requestContextStorage.run(context, fn);
+}
+/**
+ * Update the current request context with additional data
+ *
+ * @param updates - Partial context updates to merge
+ *
+ * @example
+ * ```typescript
+ * updateRequestContext({ userId: 'user-123' })
+ * ```
+ */
+export function updateRequestContext(updates) {
+    const current = getRequestContext();
+    if (current) {
+        Object.assign(current, updates);
+    }
+}
+/**
+ * Extract request ID from various header formats
+ *
+ * Checks multiple common header names:
+ * - x-request-id (standard)
+ * - x-correlation-id (correlation pattern)
+ * - x-trace-id (OpenTelemetry)
+ * - request-id (simple)
+ *
+ * @param headers - Request headers (any format)
+ * @returns Request ID or undefined
+ */
+export function extractRequestId(headers) {
+    const headerNames = ['x-request-id', 'x-correlation-id', 'x-trace-id', 'request-id'];
+    for (const name of headerNames) {
+        const value = headers[name];
+        if (value) {
+            return Array.isArray(value) ? value[0] : value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Create request context from HTTP request
+ *
+ * @param options - Request information
+ * @returns Request context
+ *
+ * @example
+ * ```typescript
+ * const context = createRequestContext({
+ *   headers: request.headers,
+ *   path: request.url,
+ *   method: request.method,
+ *   ip: request.ip,
+ * })
+ * ```
+ */
+export function createRequestContext(options) {
+    // Try to extract existing request ID from headers, or generate new one
+    const requestId = options.headers ? extractRequestId(options.headers) : undefined;
+    return {
+        requestId: requestId || generateRequestId(),
+        startTime: Date.now(),
+        path: options.path,
+        method: options.method,
+        ip: options.ip,
+        userId: options.userId,
+        userAgent: options.headers?.['user-agent'],
+    };
+}
+/**
+ * Get request duration in milliseconds
+ *
+ * @returns Duration in ms, or undefined if not in request context
+ */
+export function getRequestDuration() {
+    const context = getRequestContext();
+    if (!context)
+        return undefined;
+    return Date.now() - context.startTime;
+}
+/**
+ * Request context headers for propagating across services
+ *
+ * Use these when making HTTP requests to other services to maintain trace continuity
+ *
+ * @returns Headers object with request ID
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('https://api.example.com/users', {
+ *   headers: {
+ *     ...getRequestHeaders(),
+ *     'Authorization': 'Bearer token',
+ *   }
+ * })
+ * ```
+ */
+export function getRequestHeaders() {
+    const requestId = getRequestId();
+    if (!requestId)
+        return {};
+    return {
+        'x-request-id': requestId,
+    };
+}
+//# sourceMappingURL=request-context.js.map

package/dist/packages/core/src/utils/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../../../../../core/src/utils/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AA+BxC;;;GAGG;AACH,MAAM,qBAAqB,GAAG,IAAI,iBAAiB,EAAkB,CAAA;AAErE;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,EAAE,CAAA;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,qBAAqB,CAAC,QAAQ,EAAE,CAAA;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,iBAAiB,EAAE,EAAE,SAAS,CAAA;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CAAI,OAAuB,EAAE,EAAW;IACzE,OAAO,qBAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgC;IACnE,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAA;IACnC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACjC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAsD;IAEtD,MAAM,WAAW,GAAG,CAAC,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,CAAC,CAAA;IAEpF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAChD,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAMpC;IACC,uEAAuE;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEjF,OAAO;QACL,SAAS,EAAE,SAAS,IAAI,iBAAiB,EAAE;QAC3C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,YAAY,CAAuB;KACjE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAA;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAE9B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAA;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAChC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAA;IAEzB,OAAO;QACL,cAAc,EAAE,SAAS;KAC1B,CAAA;AACH,CAAC"}

package/dist/packages/dev/src/code-validator/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Code Validator
+ *
+ * AI Code Standards Enforcer - Prevents technical debt in AI-generated code
+ *
+ * @example
+ * ```typescript
+ * import { createValidator } from 'dev/code-validator'
+ *
+ * const validator = await createValidator('.revealui/code-standards.json')
+ * const result = validator.validate(code, { filePath: 'src/foo.ts' })
+ *
+ * if (!result.valid) {
+ *   process.stdout.write(validator.formatResult(result))
+ * }
+ * ```
+ */
+export * from './types';
+export * from './validator';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/dev/src/code-validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../dev/src/code-validator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/packages/dev/src/code-validator/index.js

@@ -0,0 +1,20 @@
+/**
+ * Code Validator
+ *
+ * AI Code Standards Enforcer - Prevents technical debt in AI-generated code
+ *
+ * @example
+ * ```typescript
+ * import { createValidator } from 'dev/code-validator'
+ *
+ * const validator = await createValidator('.revealui/code-standards.json')
+ * const result = validator.validate(code, { filePath: 'src/foo.ts' })
+ *
+ * if (!result.valid) {
+ *   process.stdout.write(validator.formatResult(result))
+ * }
+ * ```
+ */
+export * from './types';
+export * from './validator';
+//# sourceMappingURL=index.js.map

package/dist/packages/dev/src/code-validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../dev/src/code-validator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/packages/dev/src/code-validator/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Code Validator Types
+ *
+ * Type definitions for the AI code standards enforcer
+ */
+export interface ValidationRule {
+    id: string;
+    name: string;
+    pattern: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    suggestedFix?: string;
+    exemptions?: {
+        paths?: string[];
+        comments?: string[];
+    };
+}
+export interface AutoFixRule {
+    id: string;
+    find: string;
+    replace: string;
+}
+export interface CodeStandards {
+    $schema?: string;
+    title: string;
+    description: string;
+    version: string;
+    rules: ValidationRule[];
+    autoFix?: {
+        enabled: boolean;
+        rules: AutoFixRule[];
+    };
+    reporting?: {
+        format: 'detailed' | 'summary';
+        showContext: boolean;
+        contextLines: number;
+    };
+}
+export interface ValidationViolation {
+    ruleId: string;
+    ruleName: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    line: number;
+    column: number;
+    lineContent: string;
+    context?: string[];
+    suggestedFix?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    violations: ValidationViolation[];
+    errors: number;
+    warnings: number;
+    info: number;
+    stats: {
+        linesScanned: number;
+        rulesApplied: number;
+        exemptionsApplied: number;
+    };
+}
+export interface ValidateCodeOptions {
+    filePath?: string;
+    autoFix?: boolean;
+    exemptionComments?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/packages/dev/src/code-validator/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../dev/src/code-validator/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,EAAE,WAAW,EAAE,CAAA;KACrB,CAAA;IACD,SAAS,CAAC,EAAE;QACV,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;QAC9B,WAAW,EAAE,OAAO,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;QACpB,iBAAiB,EAAE,MAAM,CAAA;KAC1B,CAAA;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC7B"}

package/dist/packages/dev/src/code-validator/types.js

@@ -0,0 +1,7 @@
+/**
+ * Code Validator Types
+ *
+ * Type definitions for the AI code standards enforcer
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/packages/dev/src/code-validator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../dev/src/code-validator/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/packages/dev/src/code-validator/validator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Code Validator
+ *
+ * Core validation logic for AI-generated code
+ */
+import type { CodeStandards, ValidateCodeOptions, ValidationResult } from './types.ts';
+export declare class CodeValidator {
+    private standards;
+    constructor(standards: CodeStandards);
+    /**
+     * Validate code content against standards
+     */
+    validate(code: string, options?: ValidateCodeOptions): ValidationResult;
+    /**
+     * Auto-fix violations (if enabled)
+     */
+    autoFix(code: string): {
+        code: string;
+        fixesApplied: number;
+    };
+    /**
+     * Check if file path is exempted from rule
+     */
+    private isPathExempted;
+    /**
+     * Check if line has exemption comment
+     */
+    private hasExemptionComment;
+    /**
+     * Get context lines around a violation
+     */
+    private getContext;
+    /**
+     * Format validation result for display
+     */
+    formatResult(result: ValidationResult, options?: {
+        colors?: boolean;
+    }): string;
+}
+/**
+ * Load code standards from JSON file
+ */
+export declare function loadStandards(filePath: string): Promise<CodeStandards>;
+/**
+ * Create validator instance with standards
+ */
+export declare function createValidator(standardsPath: string): Promise<CodeValidator>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/packages/dev/src/code-validator/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../dev/src/code-validator/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAGjB,MAAM,YAAY,CAAA;AAEnB,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,gBAAgB;IA+D3E;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAoB7D;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM;CAqDnF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGnF"}

package/dist/packages/dev/src/code-validator/validator.js

@@ -0,0 +1,176 @@
+/**
+ * Code Validator
+ *
+ * Core validation logic for AI-generated code
+ */
+import { minimatch } from 'minimatch';
+export class CodeValidator {
+    standards;
+    constructor(standards) {
+        this.standards = standards;
+    }
+    /**
+     * Validate code content against standards
+     */
+    validate(code, options = {}) {
+        const violations = [];
+        const lines = code.split('\n');
+        let exemptionsApplied = 0;
+        for (const rule of this.standards.rules) {
+            // Check if file path is exempted
+            if (options.filePath && this.isPathExempted(options.filePath, rule)) {
+                exemptionsApplied++;
+                continue;
+            }
+            const regex = new RegExp(rule.pattern, 'g');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (!line)
+                    continue;
+                const lineNumber = i + 1;
+                // Check if line has exemption comment
+                if (this.hasExemptionComment(line, rule, options.exemptionComments)) {
+                    exemptionsApplied++;
+                    continue;
+                }
+                // Check for violations
+                let match;
+                // biome-ignore lint/suspicious/noAssignInExpressions: Standard regex iteration pattern
+                while ((match = regex.exec(line)) !== null) {
+                    violations.push({
+                        ruleId: rule.id,
+                        ruleName: rule.name,
+                        severity: rule.severity,
+                        message: rule.message,
+                        line: lineNumber,
+                        column: match.index + 1,
+                        lineContent: line.trim(),
+                        context: this.getContext(lines, i),
+                        suggestedFix: rule.suggestedFix,
+                    });
+                }
+            }
+        }
+        const errors = violations.filter((v) => v.severity === 'error').length;
+        const warnings = violations.filter((v) => v.severity === 'warning').length;
+        const info = violations.filter((v) => v.severity === 'info').length;
+        return {
+            valid: errors === 0,
+            violations,
+            errors,
+            warnings,
+            info,
+            stats: {
+                linesScanned: lines.length,
+                rulesApplied: this.standards.rules.length,
+                exemptionsApplied,
+            },
+        };
+    }
+    /**
+     * Auto-fix violations (if enabled)
+     */
+    autoFix(code) {
+        if (!(this.standards.autoFix?.enabled && this.standards.autoFix.rules)) {
+            return { code, fixesApplied: 0 };
+        }
+        let fixedCode = code;
+        let fixesApplied = 0;
+        for (const fixRule of this.standards.autoFix.rules) {
+            const regex = new RegExp(fixRule.find, 'g');
+            const matches = fixedCode.match(regex);
+            if (matches) {
+                fixedCode = fixedCode.replace(regex, fixRule.replace);
+                fixesApplied += matches.length;
+            }
+        }
+        return { code: fixedCode, fixesApplied };
+    }
+    /**
+     * Check if file path is exempted from rule
+     */
+    isPathExempted(filePath, rule) {
+        if (!rule.exemptions?.paths)
+            return false;
+        return rule.exemptions.paths.some((pattern) => minimatch(filePath, pattern));
+    }
+    /**
+     * Check if line has exemption comment
+     */
+    hasExemptionComment(line, rule, additionalComments) {
+        const exemptionComments = [...(rule.exemptions?.comments || []), ...(additionalComments || [])];
+        return exemptionComments.some((comment) => line.includes(comment));
+    }
+    /**
+     * Get context lines around a violation
+     */
+    getContext(lines, index) {
+        const contextLines = this.standards.reporting?.contextLines || 2;
+        if (!this.standards.reporting?.showContext)
+            return undefined;
+        const start = Math.max(0, index - contextLines);
+        const end = Math.min(lines.length, index + contextLines + 1);
+        return lines.slice(start, end).map((line, i) => {
+            const lineNumber = start + i + 1;
+            const marker = lineNumber === index + 1 ? '>' : ' ';
+            return `${marker} ${lineNumber.toString().padStart(4)} | ${line}`;
+        });
+    }
+    /**
+     * Format validation result for display
+     */
+    formatResult(result, options = {}) {
+        const { colors = true } = options;
+        const lines = [];
+        // Summary
+        if (result.violations.length === 0) {
+            lines.push(colors ? '\x1b[32m✓ Code passes all standards\x1b[0m' : '✓ Code passes all standards');
+            return lines.join('\n');
+        }
+        lines.push(colors ? '\x1b[31m✗ Code violations found\x1b[0m' : '✗ Code violations found');
+        lines.push('');
+        // Violations
+        for (const violation of result.violations) {
+            const severityColor = colors
+                ? violation.severity === 'error'
+                    ? '\x1b[31m'
+                    : violation.severity === 'warning'
+                        ? '\x1b[33m'
+                        : '\x1b[36m'
+                : '';
+            const reset = colors ? '\x1b[0m' : '';
+            lines.push(`${severityColor}${violation.severity.toUpperCase()}${reset} [${violation.ruleId}] ${violation.ruleName}`);
+            lines.push(`  at line ${violation.line}:${violation.column}`);
+            lines.push(`  ${violation.message}`);
+            if (violation.context && this.standards.reporting?.showContext) {
+                lines.push('');
+                lines.push(...violation.context.map((line) => `    ${line}`));
+            }
+            if (violation.suggestedFix) {
+                lines.push(`  ${colors ? '\x1b[36m' : ''}Suggested fix:${reset}`);
+                lines.push(`    ${violation.suggestedFix}`);
+            }
+            lines.push('');
+        }
+        // Stats
+        lines.push(`Summary: ${result.errors} errors, ${result.warnings} warnings, ${result.info} info`);
+        lines.push(`Scanned ${result.stats.linesScanned} lines with ${result.stats.rulesApplied} rules (${result.stats.exemptionsApplied} exemptions)`);
+        return lines.join('\n');
+    }
+}
+/**
+ * Load code standards from JSON file
+ */
+export async function loadStandards(filePath) {
+    const fs = await import('node:fs/promises');
+    const content = await fs.readFile(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Create validator instance with standards
+ */
+export async function createValidator(standardsPath) {
+    const standards = await loadStandards(standardsPath);
+    return new CodeValidator(standards);
+}
+//# sourceMappingURL=validator.js.map