@next-vibe/checker 1.0.11 → 1.0.12

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

@@ -0,0 +1,21 @@
+/**
+ * Run ESLint Route
+ * API route for run eslint
+ */
+
+import "server-only";
+
+import { endpointsHandler } from "@/app/api/[locale]/system/unified-interface/shared/endpoints/route/multi";
+import { Methods } from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
+
+import endpoints from "./definition";
+import { lintRepository } from "./repository";
+
+export const { POST, tools } = endpointsHandler({
+  endpoint: endpoints,
+  [Methods.POST]: {
+    handler: async ({ data, logger }) => {
+      return await lintRepository.execute(data, logger);
+    },
+  },
+});

package/src/app/api/[locale]/system/check/oxlint/README.md

@@ -0,0 +1,190 @@
+# Oxlint Configuration System
+
+This directory contains the oxlint implementation for the Next-Vibe project. Oxlint is a Rust-based linter that provides fast, comprehensive code quality checks.
+
+## Overview
+
+The oxlint system uses a **TypeScript configuration wrapper** (`lint.config.ts` in project root) that is automatically converted to JSON at runtime. This approach provides the best of both worlds:
+
+- **TypeScript benefits**: Type safety, logic, switches, and IDE autocomplete
+- **Oxlint compatibility**: Native JSON config format for maximum performance
+
+## Project Structure
+
+```
+/lint.config.ts              # TypeScript config with logic (project root)
+├── .tmp/.oxlintrc.json      # Auto-generated JSON config (git-ignored)
+└── src/app/api/.../oxlint/
+    ├── config-generator.ts  # Converts TS to JSON
+    ├── repository.ts        # Parallel execution engine
+    ├── definition.ts        # API endpoint definition
+    ├── route.ts             # API route handler
+    └── i18n/                # Translations
+```
+
+## Configuration
+
+### TypeScript Config (lint.config.ts)
+
+The main configuration file is `lint.config.ts` in the project root. It provides:
+
+**Feature Switches:**
+
+```typescript
+const enableI18nRules = true;
+const enableStrictTypeScript = true;
+const enableReactRules = true;
+const enableAccessibilityRules = true;
+const strictMode = true; // Use "error" instead of "warn"
+```
+
+**Dynamic Logic:**
+
+```typescript
+const severity = (enabled: boolean): Severity => {
+  return enabled ? (strictMode ? "error" : "warn") : "off";
+};
+```
+
+**Full Type Safety:**
+
+```typescript
+interface OxlintConfig {
+  plugins?: string[];
+  categories?: Record<string, Severity>;
+  rules?: Record<string, Severity | [Severity, unknown]>;
+  // ... full type definitions
+}
+```
+
+### Automatic Config Generation
+
+The config generator (`config-generator.ts`) automatically:
+
+1. Detects changes to `lint.config.ts`
+2. Converts TypeScript config to `.oxlintrc.json`
+3. Caches the JSON for fast subsequent runs
+4. Regenerates only when TS file is modified
+
+## Usage
+
+### CLI Commands
+
+```bash
+# Lint entire project
+vibe olint
+
+# Lint specific file/directory
+vibe olint path/to/file.ts
+vibe olint src/app
+
+# Auto-fix issues
+vibe olint --fix=true
+
+# Verbose output
+vibe olint --verbose=true
+```
+
+### API Usage
+
+```typescript
+import { oxlintRepository } from "./repository";
+
+const result = await oxlintRepository.execute(
+  {
+    path: "./src",
+    fix: false,
+    verbose: false,
+    timeout: 3600,
+    cacheDir: "./.tmp",
+  },
+  locale,
+  logger,
+);
+```
+
+## Performance
+
+### Parallel Execution
+
+The repository uses a worker distribution system:
+
+- **Automatic CPU detection**: Determines optimal worker count
+- **Memory-aware**: Scales based on available RAM
+- **File distribution**: Evenly distributes files across workers
+- **Parallel processing**: Runs multiple oxlint instances simultaneously
+
+## Supported Rules
+
+### Categories
+
+- **correctness**: Code that is outright wrong (error)
+- **suspicious**: Code that is likely wrong (error)
+- **pedantic**: Strict rules (configurable)
+- **style**: Code style rules (error/warn)
+
+### Plugins
+
+- **typescript**: TypeScript-specific rules
+- **react**: React best practices
+- **jsx-a11y**: Accessibility rules
+- **import**: Import/export rules
+- **nextjs**: Next.js-specific rules
+- **unicorn**: Additional quality rules
+- **oxc**: Oxlint unique rules
+
+### Rule Examples
+
+```json
+{
+  "no-debugger": "error",
+  "no-console": "error",
+  "typescript/no-explicit-any": "error",
+  "react/jsx-key": "error",
+  "jsx-a11y/alt-text": "error",
+  "import/no-duplicates": "error"
+}
+```
+
+## Troubleshooting
+
+### Config Not Regenerating
+
+If changes to `lint.config.ts` aren't being picked up:
+
+```bash
+# Force regeneration by removing cached JSON
+rm .tmp/.oxlintrc.json
+
+# Run oxlint again
+vibe olint
+```
+
+### High Error Count
+
+If you're seeing thousands of errors:
+
+1. **Adjust switches in `lint.config.ts`**:
+
+   ```typescript
+   const enablePedanticRules = false; // Reduce noise
+   const strictMode = false; // Use warnings
+   ```
+
+2. **Disable specific rules**:
+
+   ```typescript
+   rules: {
+     "eslint(sort-keys)": "off",
+     "eslint(no-magic-numbers)": "off",
+   }
+   ```
+
+3. **Use categories**:
+
+   ```typescript
+   categories: {
+     pedantic: "off",  // Disable all pedantic rules
+     style: "warn",    // Downgrade style to warnings
+   }
+   ```

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

@@ -0,0 +1,414 @@
+/**
+ * Run Oxlint Endpoint Definition
+ * Production-ready endpoint for run oxlint
+ */
+
+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", "oxlint"],
+  title: "app.api.system.check.oxlint.title",
+  description: "app.api.system.check.oxlint.description",
+  category: "app.api.system.check.oxlint.category",
+  tags: ["app.api.system.check.oxlint.tag"],
+  icon: "shield",
+  allowedRoles: [
+    UserRole.ADMIN,
+    UserRole.WEB_OFF,
+    UserRole.PRODUCTION_OFF,
+    UserRole.AI_TOOL_OFF,
+    UserRole.MCP_OFF,
+    UserRole.CLI_AUTH_BYPASS,
+  ],
+  aliases: ["l", "oxlint", "ox", "lint"],
+
+  cli: {
+    firstCliArgKey: "path",
+  },
+
+  fields: objectField(
+    {
+      type: WidgetType.CONTAINER,
+      title: "app.api.system.check.oxlint.container.title",
+      description: "app.api.system.check.oxlint.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.oxlint.fields.path.label",
+          description: "app.api.system.check.oxlint.fields.path.description",
+          placeholder: "app.api.system.check.oxlint.fields.path.placeholder",
+          columns: 6,
+        },
+        z
+          .union([z.string(), z.array(z.string())])
+          .optional()
+          .default("./"),
+      ),
+
+      fix: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.oxlint.fields.fix.label",
+          description: "app.api.system.check.oxlint.fields.fix.description",
+          columns: 3,
+        },
+        z.boolean().default(false),
+      ),
+
+      timeout: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.oxlint.fields.timeoutSeconds.label",
+          description:
+            "app.api.system.check.oxlint.fields.timeoutSeconds.description",
+          columns: 3,
+        },
+        z.coerce.number().min(1).max(3600).default(3600),
+      ),
+
+      createConfig: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.oxlint.fields.createConfig.label",
+          description:
+            "app.api.system.check.oxlint.fields.createConfig.description",
+          columns: 3,
+        },
+        z.boolean().default(false),
+      ),
+
+      limit: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.oxlint.fields.limit.label",
+          description: "app.api.system.check.oxlint.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.oxlint.fields.page.label",
+          description: "app.api.system.check.oxlint.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.oxlint.fields.maxFilesInSummary.label",
+          description:
+            "app.api.system.check.oxlint.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.oxlint.fields.skipSorting.label",
+          description:
+            "app.api.system.check.oxlint.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.oxlint.response.issues.title",
+              description:
+                "app.api.system.check.oxlint.response.issues.emptyState.description",
+              layoutType: LayoutType.GRID,
+              columns: 12,
+            },
+            objectField(
+              {
+                type: WidgetType.CONTAINER,
+                title: "app.api.system.check.oxlint.response.issues.title",
+                description:
+                  "app.api.system.check.oxlint.response.issues.emptyState.description",
+                layoutType: LayoutType.GRID,
+                columns: 12,
+              },
+              { response: true },
+              {
+                file: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.oxlint.response.issues.title",
+                  },
+                  z.string(),
+                ),
+                line: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.oxlint.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                column: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.oxlint.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                rule: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.oxlint.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                code: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.oxlint.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                severity: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.oxlint.response.issues.title",
+                  },
+                  z.enum(["error", "warning", "info"]),
+                ),
+                message: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.oxlint.response.success",
+                  },
+                  z.string(),
+                ),
+                type: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.oxlint.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.oxlint.errors.validation.title",
+      description: "app.api.system.check.oxlint.errors.validation.description",
+    },
+    [EndpointErrorTypes.NETWORK_ERROR]: {
+      title: "app.api.system.check.oxlint.errors.internal.title",
+      description: "app.api.system.check.oxlint.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNAUTHORIZED]: {
+      title: "app.api.system.check.oxlint.errors.unauthorized.title",
+      description:
+        "app.api.system.check.oxlint.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.FORBIDDEN]: {
+      title: "app.api.system.check.oxlint.errors.forbidden.title",
+      description: "app.api.system.check.oxlint.errors.forbidden.description",
+    },
+    [EndpointErrorTypes.NOT_FOUND]: {
+      title: "app.api.system.check.oxlint.errors.internal.title",
+      description: "app.api.system.check.oxlint.errors.internal.description",
+    },
+    [EndpointErrorTypes.SERVER_ERROR]: {
+      title: "app.api.system.check.oxlint.errors.internal.title",
+      description: "app.api.system.check.oxlint.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNKNOWN_ERROR]: {
+      title: "app.api.system.check.oxlint.errors.internal.title",
+      description: "app.api.system.check.oxlint.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNSAVED_CHANGES]: {
+      title: "app.api.system.check.oxlint.errors.internal.title",
+      description: "app.api.system.check.oxlint.errors.internal.description",
+    },
+    [EndpointErrorTypes.CONFLICT]: {
+      title: "app.api.system.check.oxlint.errors.internal.title",
+      description: "app.api.system.check.oxlint.errors.internal.description",
+    },
+  },
+
+  successTypes: {
+    title: "app.api.system.check.oxlint.success.title",
+    description: "app.api.system.check.oxlint.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 OxlintRequestInput = typeof POST.types.RequestInput;
+export type OxlintRequestOutput = typeof POST.types.RequestOutput;
+export type OxlintResponseInput = typeof POST.types.ResponseInput;
+export type OxlintResponseOutput = typeof POST.types.ResponseOutput;
+
+export type OxlintIssue = OxlintResponseOutput["issues"]["items"][number];
+
+const endpoints = { POST };
+export default endpoints;

package/src/app/api/[locale]/system/check/oxlint/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.oxlint.status.passed" as const,
+    FAILED: "app.api.system.check.oxlint.status.failed" as const,
+    RUNNING: "app.api.system.check.oxlint.status.running" as const,
+    SKIPPED: "app.api.system.check.oxlint.status.skipped" as const,
+  });
+
+/**
+ * Lint Severity
+ */
+export const { enum: LintSeverity, options: LintSeverityOptions } =
+  createEnumOptions({
+    ERROR: "app.api.system.check.oxlint.severity.error" as const,
+    WARNING: "app.api.system.check.oxlint.severity.warning" as const,
+    INFO: "app.api.system.check.oxlint.severity.info" as const,
+  });
+
+/**
+ * Lint Fix Action
+ */
+export const { enum: LintFixAction, options: LintFixActionOptions } =
+  createEnumOptions({
+    AUTO_FIX: "app.api.system.check.oxlint.fixAction.autoFix" as const,
+    MANUAL_FIX: "app.api.system.check.oxlint.fixAction.manualFix" as const,
+    IGNORE: "app.api.system.check.oxlint.fixAction.ignore" as const,
+  });