@next-vibe/checker 1.0.11 → 1.0.13

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

@@ -0,0 +1,568 @@
+/**
+ * Vibe Check Command Endpoint Definition
+ * Production-ready endpoint for comprehensive code quality checks
+ */
+
+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", "vibe-check"],
+  title: "app.api.system.check.vibeCheck.title",
+  description: "app.api.system.check.vibeCheck.description",
+  category: "app.api.system.check.vibeCheck.category",
+  tags: ["app.api.system.check.vibeCheck.tag"],
+  icon: "wrench",
+  allowedRoles: [
+    UserRole.ADMIN,
+    UserRole.WEB_OFF,
+    UserRole.PRODUCTION_OFF,
+    UserRole.AI_TOOL_OFF,
+    UserRole.CLI_AUTH_BYPASS,
+  ],
+  aliases: ["check", "c"],
+
+  cli: {
+    firstCliArgKey: "paths",
+  },
+
+  fields: objectField(
+    {
+      type: WidgetType.CONTAINER,
+      title: "app.api.system.check.vibeCheck.title",
+      description: "app.api.system.check.vibeCheck.description",
+      layoutType: LayoutType.GRID,
+      columns: 12,
+    },
+    { request: "data", response: true },
+    {
+      // === REQUEST FIELDS ===
+      // Default: check.config.ts vibeCheck.fix ?? false
+      fix: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.vibeCheck.fields.fix.label",
+          description: "app.api.system.check.vibeCheck.fields.fix.description",
+          columns: 4,
+        },
+        z.boolean().optional(),
+      ),
+
+      // Default: check.config.ts vibeCheck.skipLint ?? false
+      skipLint: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.vibeCheck.fields.skipLint.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.skipLint.description",
+          columns: 3,
+        },
+        z.boolean().optional(),
+      ),
+
+      // Default: check.config.ts vibeCheck.skipEslint ?? false
+      skipEslint: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.vibeCheck.fields.skipEslint.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.skipEslint.description",
+          columns: 3,
+        },
+        z.boolean().optional(),
+      ),
+
+      // Default: check.config.ts vibeCheck.skipOxlint ?? false
+      skipOxlint: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.vibeCheck.fields.skipOxlint.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.skipOxlint.description",
+          columns: 3,
+        },
+        z.boolean().optional(),
+      ),
+
+      // Default: check.config.ts vibeCheck.skipTypecheck ?? false
+      skipTypecheck: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.vibeCheck.fields.skipTypecheck.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.skipTypecheck.description",
+          columns: 3,
+        },
+        z.boolean().optional(),
+      ),
+
+      // Default: false (not configurable in check.config.ts)
+      createConfig: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.vibeCheck.fields.createConfig.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.createConfig.description",
+          columns: 3,
+        },
+        z.boolean().optional().default(false),
+      ),
+
+      // Default: check.config.ts vibeCheck.timeout ?? 3600
+      timeout: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.vibeCheck.fields.timeoutSeconds.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.timeoutSeconds.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).max(36000).optional(),
+      ),
+
+      paths: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.TAGS,
+          label: "app.api.system.check.vibeCheck.fields.paths.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.paths.description",
+          placeholder:
+            "app.api.system.check.vibeCheck.fields.paths.placeholder",
+          columns: 8,
+          options: [
+            {
+              value: "src/",
+              label: "app.api.system.check.vibeCheck.fields.paths.options.src",
+            },
+            {
+              value: "src/components",
+              label:
+                "app.api.system.check.vibeCheck.fields.paths.options.components",
+            },
+            {
+              value: "src/utils",
+              label:
+                "app.api.system.check.vibeCheck.fields.paths.options.utils",
+            },
+            {
+              value: "src/pages",
+              label:
+                "app.api.system.check.vibeCheck.fields.paths.options.pages",
+            },
+            {
+              value: "src/app",
+              label: "app.api.system.check.vibeCheck.fields.paths.options.app",
+            },
+          ],
+        },
+        z.union([z.string(), z.array(z.string())]).optional(),
+      ),
+
+      // Default: check.config.ts vibeCheck.limit ?? 200
+      limit: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.vibeCheck.fields.limit.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.limit.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).optional(),
+      ),
+
+      // Default: 1 (not configurable in check.config.ts)
+      page: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.vibeCheck.fields.page.label",
+          description: "app.api.system.check.vibeCheck.fields.page.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).optional().default(1),
+      ),
+
+      // Default: check.config.ts vibeCheck.maxFilesInSummary ?? 50
+      maxFilesInSummary: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label:
+            "app.api.system.check.vibeCheck.fields.maxFilesInSummary.label",
+          description:
+            "app.api.system.check.vibeCheck.fields.maxFilesInSummary.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).optional(),
+      ),
+
+      // === 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.vibeCheck.response.issues.title",
+              description:
+                "app.api.system.check.vibeCheck.response.issues.emptyState.description",
+              layoutType: LayoutType.GRID,
+              columns: 12,
+            },
+            objectField(
+              {
+                type: WidgetType.CONTAINER,
+                title: "app.api.system.check.vibeCheck.response.issues.title",
+                description:
+                  "app.api.system.check.vibeCheck.response.issues.emptyState.description",
+                layoutType: LayoutType.GRID,
+                columns: 12,
+              },
+              { response: true },
+              {
+                file: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.vibeCheck.response.issues.title",
+                  },
+                  z.string(),
+                ),
+                line: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.vibeCheck.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                column: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.vibeCheck.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                rule: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.vibeCheck.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                code: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.vibeCheck.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                severity: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.vibeCheck.response.issues.title",
+                  },
+                  z.enum(["error", "warning", "info"]),
+                ),
+                message: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.vibeCheck.response.success",
+                  },
+                  z.string(),
+                ),
+                type: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.vibeCheck.response.issues.title",
+                  },
+                  z.enum(["oxlint", "lint", "type"]),
+                ),
+              },
+            ),
+          ),
+
+          // === FILES LIST ===
+          files: responseField(
+            {
+              type: WidgetType.CODE_QUALITY_FILES,
+            },
+            z.array(
+              z.object({
+                file: z.string(),
+                errors: z.number(),
+                warnings: z.number(),
+                total: z.number(),
+              }),
+            ),
+          ),
+
+          // === SUMMARY STATS ===
+          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(),
+            }),
+          ),
+        },
+      ),
+    },
+  ),
+
+  // === ERROR HANDLING ===
+  errorTypes: {
+    [EndpointErrorTypes.VALIDATION_FAILED]: {
+      title: "app.api.system.check.vibeCheck.errors.validation.title",
+      description:
+        "app.api.system.check.vibeCheck.errors.validation.description",
+    },
+    [EndpointErrorTypes.NETWORK_ERROR]: {
+      title: "app.api.system.check.vibeCheck.errors.internal.title",
+      description: "app.api.system.check.vibeCheck.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNAUTHORIZED]: {
+      title: "app.api.system.check.vibeCheck.errors.unauthorized.title",
+      description:
+        "app.api.system.check.vibeCheck.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.FORBIDDEN]: {
+      title: "app.api.system.check.vibeCheck.errors.forbidden.title",
+      description:
+        "app.api.system.check.vibeCheck.errors.forbidden.description",
+    },
+    [EndpointErrorTypes.NOT_FOUND]: {
+      title: "app.api.system.check.vibeCheck.errors.notFound.title",
+      description: "app.api.system.check.vibeCheck.errors.notFound.description",
+    },
+    [EndpointErrorTypes.SERVER_ERROR]: {
+      title: "app.api.system.check.vibeCheck.errors.server.title",
+      description: "app.api.system.check.vibeCheck.errors.server.description",
+    },
+    [EndpointErrorTypes.UNKNOWN_ERROR]: {
+      title: "app.api.system.check.vibeCheck.errors.unknown.title",
+      description: "app.api.system.check.vibeCheck.errors.unknown.description",
+    },
+    [EndpointErrorTypes.UNSAVED_CHANGES]: {
+      title: "app.api.system.check.vibeCheck.errors.unsaved.title",
+      description: "app.api.system.check.vibeCheck.errors.unsaved.description",
+    },
+    [EndpointErrorTypes.CONFLICT]: {
+      title: "app.api.system.check.vibeCheck.errors.conflict.title",
+      description: "app.api.system.check.vibeCheck.errors.conflict.description",
+    },
+  },
+
+  // === SUCCESS HANDLING ===
+  successTypes: {
+    title: "app.api.system.check.vibeCheck.success.title",
+    description: "app.api.system.check.vibeCheck.success.description",
+  },
+
+  // === EXAMPLES ===
+  examples: {
+    requests: {
+      default: {
+        fix: true,
+        skipLint: false,
+        skipEslint: false,
+        skipOxlint: false,
+        skipTypecheck: false,
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+      success: {
+        fix: false,
+        skipLint: false,
+        skipEslint: false,
+        skipOxlint: false,
+        skipTypecheck: false,
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+      withErrors: {
+        fix: true,
+        skipLint: false,
+        skipEslint: false,
+        skipOxlint: false,
+        skipTypecheck: false,
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+      quickCheck: {
+        fix: false,
+        skipLint: false,
+        skipEslint: false,
+        skipOxlint: false,
+        skipTypecheck: false,
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+      specificPaths: {
+        fix: true,
+        skipLint: false,
+        skipEslint: false,
+        skipOxlint: false,
+        skipTypecheck: false,
+        paths: ["src/components", "src/utils"],
+        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,
+          },
+        },
+      },
+      success: {
+        issues: {
+          items: [],
+          files: [],
+          summary: {
+            totalIssues: 0,
+            totalFiles: 0,
+            totalErrors: 0,
+            displayedIssues: 0,
+            displayedFiles: 0,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+      withErrors: {
+        issues: {
+          items: [
+            {
+              file: "src/components/example.tsx",
+              line: 42,
+              column: 10,
+              rule: "no-unused-vars",
+              code: "unused-variable",
+              severity: "error" as const,
+              message: "Variable 'example' is defined but never used",
+              type: "lint" as const,
+            },
+          ],
+          files: [
+            {
+              file: "src/components/example.tsx",
+              errors: 1,
+              warnings: 0,
+              total: 1,
+            },
+          ],
+          summary: {
+            totalIssues: 1,
+            totalFiles: 1,
+            totalErrors: 1,
+            displayedIssues: 1,
+            displayedFiles: 1,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+      quickCheck: {
+        issues: {
+          items: [],
+          files: [],
+          summary: {
+            totalIssues: 0,
+            totalFiles: 0,
+            totalErrors: 0,
+            displayedIssues: 0,
+            displayedFiles: 0,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+      specificPaths: {
+        issues: {
+          items: [],
+          files: [],
+          summary: {
+            totalIssues: 0,
+            totalFiles: 0,
+            totalErrors: 0,
+            displayedIssues: 0,
+            displayedFiles: 0,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+    },
+  },
+});
+
+export type VibeCheckRequestInput = typeof POST.types.RequestInput;
+export type VibeCheckRequestOutput = typeof POST.types.RequestOutput;
+export type VibeCheckResponseInput = typeof POST.types.ResponseInput;
+export type VibeCheckResponseOutput = typeof POST.types.ResponseOutput;
+
+const vibeCheckEndpoints = { POST };
+export default vibeCheckEndpoints;

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

@@ -0,0 +1,69 @@
+/**
+ * Vibe Check Enums
+ * Enums for vibe check system functionality
+ */
+
+import { createEnumOptions } from "@/app/api/[locale]/system/unified-interface/shared/field/enum";
+
+/**
+ * Check Type
+ */
+export const { enum: CheckType, options: CheckTypeOptions } = createEnumOptions(
+  {
+    LINT: "app.api.system.check.vibeCheck.checkType.lint" as const,
+    TYPECHECK: "app.api.system.check.vibeCheck.checkType.typecheck" as const,
+    TEST: "app.api.system.check.vibeCheck.checkType.test" as const,
+    STRUCTURE: "app.api.system.check.vibeCheck.checkType.structure" as const,
+    MIGRATION: "app.api.system.check.vibeCheck.checkType.migration" as const,
+    ALL: "app.api.system.check.vibeCheck.checkType.all" as const,
+  },
+);
+
+/**
+ * Check Status
+ */
+export const { enum: CheckStatus, options: CheckStatusOptions } =
+  createEnumOptions({
+    PENDING: "app.api.system.check.vibeCheck.status.pending" as const,
+    RUNNING: "app.api.system.check.vibeCheck.status.running" as const,
+    PASSED: "app.api.system.check.vibeCheck.status.passed" as const,
+    FAILED: "app.api.system.check.vibeCheck.status.failed" as const,
+    WARNING: "app.api.system.check.vibeCheck.status.warning" as const,
+    SKIPPED: "app.api.system.check.vibeCheck.status.skipped" as const,
+  });
+
+/**
+ * Check Severity
+ */
+export const { enum: CheckSeverity, options: CheckSeverityOptions } =
+  createEnumOptions({
+    ERROR: "app.api.system.check.vibeCheck.severity.error" as const,
+    WARNING: "app.api.system.check.vibeCheck.severity.warning" as const,
+    INFO: "app.api.system.check.vibeCheck.severity.info" as const,
+    SUGGESTION: "app.api.system.check.vibeCheck.severity.suggestion" as const,
+  });
+
+/**
+ * Fix Action
+ */
+export const { enum: FixAction, options: FixActionOptions } = createEnumOptions(
+  {
+    AUTO_FIX: "app.api.system.check.vibeCheck.fixAction.autoFix" as const,
+    MANUAL_FIX: "app.api.system.check.vibeCheck.fixAction.manualFix" as const,
+    IGNORE: "app.api.system.check.vibeCheck.fixAction.ignore" as const,
+    REVIEW: "app.api.system.check.vibeCheck.fixAction.review" as const,
+  },
+);
+
+const vibeCheckEnums = {
+  CheckType,
+  CheckTypeOptions,
+  CheckStatus,
+  CheckStatusOptions,
+  CheckSeverity,
+  CheckSeverityOptions,
+  FixAction,
+  FixActionOptions,
+};
+
+export default vibeCheckEnums;