@next-vibe/checker 1.0.11 → 1.0.12

package/src/app/api/[locale]/system/check/config/utils.ts

@@ -0,0 +1,171 @@
+/**
+ * Check Configuration Utilities
+ *
+ * Shared utilities for code quality configuration:
+ * - Ignore pattern conversion (oxlint vs eslint format)
+ * - ESLint stub creation for oxlint-handled rules
+ * - System resource detection for parallel workers
+ */
+
+import { cpus, freemem, totalmem } from "node:os";
+
+// ============================================================
+// Types
+// ============================================================
+
+/** ESLint stub plugin structure */
+export interface EslintStubPlugin {
+  rules: Record<
+    string,
+    {
+      create: () => Record<string, never>;
+      meta: { docs: { description: string } };
+    }
+  >;
+}
+
+/** Ignore pattern formats */
+export interface IgnoreFormats {
+  /** Raw patterns for oxlint (directories, files, globs) */
+  oxlintIgnores: string[];
+  /** Glob patterns for ESLint flat config */
+  eslintIgnores: string[];
+}
+
+/** System resource information for worker allocation */
+export interface SystemResources {
+  cpuCores: number;
+  availableMemoryMB: number;
+  maxWorkers: number;
+}
+
+// ============================================================
+// Constants - Worker Memory Configuration
+// ============================================================
+
+/** Memory configuration for parallel workers */
+const WORKER_MEMORY_CONFIG = {
+  /** Minimum system buffer to reserve (512MB) */
+  MIN_SYSTEM_BUFFER_BYTES: 512 * 1024 * 1024,
+  /** Percentage of total memory to reserve as buffer */
+  SYSTEM_BUFFER_PERCENTAGE: 0.1,
+  /** Maximum worker hard cap */
+  MAX_WORKER_HARD_CAP: 4,
+  /** Memory thresholds (GB) and corresponding worker memory (bytes) */
+  MEMORY_THRESHOLDS: [
+    { minGB: 32, workerMemoryMB: 400 },
+    { minGB: 16, workerMemoryMB: 300 },
+    { minGB: 8, workerMemoryMB: 250 },
+    { minGB: 4, workerMemoryMB: 200 },
+    { minGB: 0, workerMemoryMB: 150 },
+  ] as const,
+} as const;
+
+// ============================================================
+// System Resources
+// ============================================================
+
+/**
+ * Calculate memory per worker based on system total memory.
+ *
+ * Scales memory allocation based on available system resources.
+ * Larger systems get more memory per worker for better performance.
+ *
+ * @param totalMemoryBytes - Total system memory in bytes
+ * @returns Memory to allocate per worker in bytes
+ */
+export function calculateMemoryPerWorker(totalMemoryBytes: number): number {
+  const totalMemoryGB = totalMemoryBytes / (1024 * 1024 * 1024);
+
+  for (const threshold of WORKER_MEMORY_CONFIG.MEMORY_THRESHOLDS) {
+    if (totalMemoryGB >= threshold.minGB) {
+      return threshold.workerMemoryMB * 1024 * 1024;
+    }
+  }
+
+  // Fallback (should never reach due to minGB: 0 threshold)
+  return 150 * 1024 * 1024;
+}
+
+/**
+ * Calculate maximum worker cap based on system capabilities.
+ *
+ * Considers both CPU cores and available memory to prevent
+ * over-allocation that could cause system instability.
+ *
+ * @param cpuCores - Number of CPU cores
+ * @param totalMemoryBytes - Total system memory in bytes
+ * @returns Maximum number of workers to spawn
+ */
+export function calculateMaxWorkerCap(
+  cpuCores: number,
+  totalMemoryBytes: number,
+): number {
+  const totalMemoryGB = totalMemoryBytes / (1024 * 1024 * 1024);
+
+  // Base cap on CPU cores, but consider memory constraints
+  const cpuBasedCap = Math.max(2, cpuCores); // At least 2, up to CPU cores
+  const memoryBasedCap = Math.floor(totalMemoryGB / 2); // 1 worker per 2GB of RAM
+
+  // Use the minimum, but cap at reasonable limits
+  const dynamicCap = Math.min(cpuBasedCap, memoryBasedCap);
+  return Math.max(
+    1,
+    Math.min(
+      dynamicCap,
+      WORKER_MEMORY_CONFIG.MAX_WORKER_HARD_CAP,
+      cpuCores * 2,
+    ),
+  );
+}
+
+/**
+ * Get system resources and calculate optimal worker count.
+ *
+ * Detects available CPU and memory, then calculates the optimal
+ * number of parallel workers for linting operations.
+ *
+ * @returns System resource info with recommended worker count
+ *
+ * @example
+ * ```typescript
+ * const resources = getSystemResources();
+ * console.log(`Using ${resources.maxWorkers} workers`);
+ * console.log(`Available memory: ${resources.availableMemoryMB}MB`);
+ * ```
+ */
+export function getSystemResources(): SystemResources {
+  const cpuCores = cpus().length;
+  const totalMemoryBytes = totalmem();
+  const freeMemoryBytes = freemem();
+
+  // Use actual available memory, but leave some buffer for the system
+  const systemBufferBytes = Math.max(
+    totalMemoryBytes * WORKER_MEMORY_CONFIG.SYSTEM_BUFFER_PERCENTAGE,
+    WORKER_MEMORY_CONFIG.MIN_SYSTEM_BUFFER_BYTES,
+  );
+  const availableMemoryBytes = Math.max(0, freeMemoryBytes - systemBufferBytes);
+
+  // Dynamic memory per worker based on total system memory
+  const memoryPerWorkerBytes = calculateMemoryPerWorker(totalMemoryBytes);
+
+  // Calculate optimal worker count based on CPU cores and memory
+  const memoryBasedWorkers = Math.floor(
+    availableMemoryBytes / memoryPerWorkerBytes,
+  );
+  const cpuBasedWorkers = Math.max(1, cpuCores - 1); // Leave one core for main process
+
+  // Dynamic worker cap based on system capabilities
+  const maxWorkerCap = calculateMaxWorkerCap(cpuCores, totalMemoryBytes);
+  const maxWorkers = Math.min(
+    memoryBasedWorkers,
+    cpuBasedWorkers,
+    maxWorkerCap,
+  );
+
+  return {
+    cpuCores,
+    availableMemoryMB: Math.floor(availableMemoryBytes / (1024 * 1024)),
+    maxWorkers: Math.max(1, maxWorkers), // Ensure at least 1 worker
+  };
+}

package/src/app/api/[locale]/system/check/i18n/de/index.ts

@@ -0,0 +1,15 @@
+import { translations as lintTranslations } from "../../lint/i18n/de";
+import { translations as oxlintTranslations } from "../../oxlint/i18n/de";
+import { translations as typecheckTranslations } from "../../typecheck/i18n/de";
+import { translations as vibeCheckTranslations } from "../../vibe-check/i18n/de";
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  oxlint: oxlintTranslations,
+  lint: lintTranslations,
+  typecheck: typecheckTranslations,
+  vibeCheck: vibeCheckTranslations,
+  codeQuality: {
+    noIssues: "Keine Codequalitätsprobleme gefunden",
+  },
+};

package/src/app/api/[locale]/system/check/i18n/en/index.ts

@@ -0,0 +1,14 @@
+import { translations as lintTranslations } from "../../lint/i18n/en";
+import { translations as oxlintTranslations } from "../../oxlint/i18n/en";
+import { translations as typecheckTranslations } from "../../typecheck/i18n/en";
+import { translations as vibeCheckTranslations } from "../../vibe-check/i18n/en";
+
+export const translations = {
+  oxlint: oxlintTranslations,
+  lint: lintTranslations,
+  typecheck: typecheckTranslations,
+  vibeCheck: vibeCheckTranslations,
+  codeQuality: {
+    noIssues: "No code quality issues found",
+  },
+};

package/src/app/api/[locale]/system/check/i18n/pl/index.ts

@@ -0,0 +1,15 @@
+import { translations as lintTranslations } from "../../lint/i18n/pl";
+import { translations as oxlintTranslations } from "../../oxlint/i18n/pl";
+import { translations as typecheckTranslations } from "../../typecheck/i18n/pl";
+import { translations as vibeCheckTranslations } from "../../vibe-check/i18n/pl";
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  oxlint: oxlintTranslations,
+  lint: lintTranslations,
+  typecheck: typecheckTranslations,
+  vibeCheck: vibeCheckTranslations,
+  codeQuality: {
+    noIssues: "Nie znaleziono problemów z jakością kodu",
+  },
+};

package/src/app/api/[locale]/system/check/lint/definition.ts

@@ -0,0 +1,414 @@
+/**
+ * Run ESLint Endpoint Definition
+ * Production-ready endpoint for run eslint
+ */
+
+import { z } from "zod";
+
+import { createEndpoint } from "@/app/api/[locale]/system/unified-interface/shared/endpoints/definition/create";
+import {
+  objectField,
+  requestDataField,
+  responseArrayField,
+  responseField,
+} from "@/app/api/[locale]/system/unified-interface/shared/field/utils";
+import {
+  EndpointErrorTypes,
+  FieldDataType,
+  LayoutType,
+  Methods,
+  WidgetType,
+} from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
+
+import { UserRole } from "../../../user/user-roles/enum";
+
+const { POST } = createEndpoint({
+  method: Methods.POST,
+  path: ["system", "check", "lint"],
+  title: "app.api.system.check.lint.title",
+  description: "app.api.system.check.lint.description",
+  category: "app.api.system.check.lint.category",
+  tags: ["app.api.system.check.lint.tag"],
+  icon: "bug",
+  allowedRoles: [
+    UserRole.ADMIN,
+    UserRole.WEB_OFF,
+    UserRole.PRODUCTION_OFF,
+    UserRole.AI_TOOL_OFF,
+    UserRole.MCP_OFF,
+    UserRole.CLI_AUTH_BYPASS,
+  ],
+  aliases: ["eslint", "elint", "el"],
+
+  cli: {
+    firstCliArgKey: "path",
+  },
+  fields: objectField(
+    {
+      type: WidgetType.CONTAINER,
+      title: "app.api.system.check.lint.container.title",
+      description: "app.api.system.check.lint.container.description",
+      layoutType: LayoutType.GRID,
+      columns: 12,
+    },
+    { request: "data", response: true },
+    {
+      // === REQUEST FIELDS ===
+      path: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.TEXT,
+          label: "app.api.system.check.lint.fields.path.label",
+          description: "app.api.system.check.lint.fields.path.description",
+          placeholder: "app.api.system.check.lint.fields.path.placeholder",
+          columns: 6,
+        },
+        z.string().optional().default("./"),
+      ),
+
+      fix: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.lint.fields.fix.label",
+          description: "app.api.system.check.lint.fields.fix.description",
+          columns: 3,
+        },
+        // fix is false by default as it makes it way slower
+        z.boolean().default(false),
+      ),
+
+      timeout: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.lint.fields.timeoutSeconds.label",
+          description:
+            "app.api.system.check.lint.fields.timeoutSeconds.description",
+          columns: 3,
+        },
+        z.coerce.number().min(1).max(3600).default(3600),
+      ),
+
+      cacheDir: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.TEXT,
+          label: "app.api.system.check.lint.fields.cacheDir.label",
+          description: "app.api.system.check.lint.fields.cacheDir.description",
+          columns: 3,
+        },
+        z.string().optional().default("./.tmp"),
+      ),
+
+      createConfig: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.lint.fields.createConfig.label",
+          description:
+            "app.api.system.check.lint.fields.createConfig.description",
+          columns: 3,
+        },
+        z.boolean().default(false),
+      ),
+
+      limit: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.lint.fields.limit.label",
+          description: "app.api.system.check.lint.fields.limit.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).optional().default(200),
+      ),
+
+      page: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.lint.fields.page.label",
+          description: "app.api.system.check.lint.fields.page.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).optional().default(1),
+      ),
+
+      maxFilesInSummary: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.lint.fields.maxFilesInSummary.label",
+          description:
+            "app.api.system.check.lint.fields.maxFilesInSummary.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).default(50),
+      ),
+
+      skipSorting: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.lint.fields.skipSorting.label",
+          description:
+            "app.api.system.check.lint.fields.skipSorting.description",
+          columns: 3,
+        },
+        z.boolean().default(false),
+      ),
+
+      // === RESPONSE FIELDS ===
+      issues: objectField(
+        {
+          type: WidgetType.CODE_QUALITY_LIST,
+          groupBy: "file",
+          sortBy: "severity",
+          showSummary: true,
+          layoutType: LayoutType.GRID,
+          columns: 1,
+        },
+        { response: true },
+        {
+          items: responseArrayField(
+            {
+              type: WidgetType.CONTAINER,
+              title: "app.api.system.check.lint.response.issues.title",
+              description:
+                "app.api.system.check.lint.response.issues.emptyState.description",
+              layoutType: LayoutType.GRID,
+              columns: 12,
+            },
+            objectField(
+              {
+                type: WidgetType.CONTAINER,
+                title: "app.api.system.check.lint.response.issues.title",
+                description:
+                  "app.api.system.check.lint.response.issues.emptyState.description",
+                layoutType: LayoutType.GRID,
+                columns: 12,
+              },
+              { response: true },
+              {
+                file: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.issues.title",
+                  },
+                  z.string(),
+                ),
+                line: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                column: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                rule: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                code: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                severity: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.issues.title",
+                  },
+                  z.enum(["error", "warning", "info"]),
+                ),
+                message: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.success",
+                  },
+                  z.string(),
+                ),
+                type: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.lint.response.issues.title",
+                  },
+                  z.enum(["oxlint", "lint", "type"]),
+                ),
+              },
+            ),
+          ),
+
+          files: responseField(
+            {
+              type: WidgetType.CODE_QUALITY_FILES,
+            },
+            z.array(
+              z.object({
+                file: z.string(),
+                errors: z.number(),
+                warnings: z.number(),
+                total: z.number(),
+              }),
+            ),
+          ),
+
+          summary: responseField(
+            {
+              type: WidgetType.CODE_QUALITY_SUMMARY,
+            },
+            z.object({
+              totalIssues: z.number(),
+              totalFiles: z.number(),
+              totalErrors: z.number(),
+              displayedIssues: z.number(),
+              displayedFiles: z.number(),
+              truncatedMessage: z.string().optional(),
+              currentPage: z.number(),
+              totalPages: z.number(),
+            }),
+          ),
+        },
+      ),
+    },
+  ),
+
+  errorTypes: {
+    [EndpointErrorTypes.VALIDATION_FAILED]: {
+      title: "app.api.system.check.lint.errors.validation.title",
+      description: "app.api.system.check.lint.errors.validation.description",
+    },
+    [EndpointErrorTypes.NETWORK_ERROR]: {
+      title: "app.api.system.check.lint.errors.internal.title",
+      description: "app.api.system.check.lint.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNAUTHORIZED]: {
+      title: "app.api.system.check.lint.errors.unauthorized.title",
+      description: "app.api.system.check.lint.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.FORBIDDEN]: {
+      title: "app.api.system.check.lint.errors.forbidden.title",
+      description: "app.api.system.check.lint.errors.forbidden.description",
+    },
+    [EndpointErrorTypes.NOT_FOUND]: {
+      title: "app.api.system.check.lint.errors.internal.title",
+      description: "app.api.system.check.lint.errors.internal.description",
+    },
+    [EndpointErrorTypes.SERVER_ERROR]: {
+      title: "app.api.system.check.lint.errors.internal.title",
+      description: "app.api.system.check.lint.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNKNOWN_ERROR]: {
+      title: "app.api.system.check.lint.errors.internal.title",
+      description: "app.api.system.check.lint.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNSAVED_CHANGES]: {
+      title: "app.api.system.check.lint.errors.internal.title",
+      description: "app.api.system.check.lint.errors.internal.description",
+    },
+    [EndpointErrorTypes.CONFLICT]: {
+      title: "app.api.system.check.lint.errors.internal.title",
+      description: "app.api.system.check.lint.errors.internal.description",
+    },
+  },
+
+  successTypes: {
+    title: "app.api.system.check.lint.success.title",
+    description: "app.api.system.check.lint.success.description",
+  },
+
+  examples: {
+    requests: {
+      default: {
+        fix: false,
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+      verbose: {
+        fix: false,
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+      fix: {
+        path: "src/app/api/[locale]/system/unified-interface/cli",
+        fix: true,
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+    },
+    responses: {
+      default: {
+        issues: {
+          items: [],
+          files: [],
+          summary: {
+            totalIssues: 0,
+            totalFiles: 0,
+            totalErrors: 0,
+            displayedIssues: 0,
+            displayedFiles: 0,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+      verbose: {
+        issues: {
+          items: [],
+          files: [],
+          summary: {
+            totalIssues: 0,
+            totalFiles: 0,
+            totalErrors: 0,
+            displayedIssues: 0,
+            displayedFiles: 0,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+      fix: {
+        issues: {
+          items: [],
+          files: [],
+          summary: {
+            totalIssues: 0,
+            totalFiles: 0,
+            totalErrors: 0,
+            displayedIssues: 0,
+            displayedFiles: 0,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+    },
+    urlPathParams: undefined,
+  },
+});
+
+// Export types following migration guide pattern
+export type LintRequestInput = typeof POST.types.RequestInput;
+export type LintRequestOutput = typeof POST.types.RequestOutput;
+export type LintResponseInput = typeof POST.types.ResponseInput;
+export type LintResponseOutput = typeof POST.types.ResponseOutput;
+
+export type LintIssue = LintResponseOutput["issues"]["items"][number];
+
+const endpoints = { POST };
+export default endpoints;

package/src/app/api/[locale]/system/check/lint/enum.ts

@@ -0,0 +1,37 @@
+/**
+ * Lint Enums
+ * Enums for ESLint code linting functionality
+ */
+
+import { createEnumOptions } from "@/app/api/[locale]/system/unified-interface/shared/field/enum";
+
+/**
+ * Lint Status
+ */
+export const { enum: LintStatus, options: LintStatusOptions } =
+  createEnumOptions({
+    PASSED: "app.api.system.check.lint.status.passed" as const,
+    FAILED: "app.api.system.check.lint.status.failed" as const,
+    RUNNING: "app.api.system.check.lint.status.running" as const,
+    SKIPPED: "app.api.system.check.lint.status.skipped" as const,
+  });
+
+/**
+ * Lint Severity
+ */
+export const { enum: LintSeverity, options: LintSeverityOptions } =
+  createEnumOptions({
+    ERROR: "app.api.system.check.lint.severity.error" as const,
+    WARNING: "app.api.system.check.lint.severity.warning" as const,
+    INFO: "app.api.system.check.lint.severity.info" as const,
+  });
+
+/**
+ * Lint Fix Action
+ */
+export const { enum: LintFixAction, options: LintFixActionOptions } =
+  createEnumOptions({
+    AUTO_FIX: "app.api.system.check.lint.fixAction.autoFix" as const,
+    MANUAL_FIX: "app.api.system.check.lint.fixAction.manualFix" as const,
+    IGNORE: "app.api.system.check.lint.fixAction.ignore" as const,
+  });