@next-vibe/checker 1.0.52 → 3.0.0

package/src/app/api/[locale]/system/generators/shared/utils.ts

@@ -1,215 +0,0 @@
-/**
- * Shared Generator Utilities
- * Simple utilities for all generators
- */
-
-import "server-only";
-
-import { existsSync, mkdirSync, readdirSync } from "node:fs";
-import { writeFile } from "node:fs/promises";
-import { dirname, join, relative } from "node:path";
-
-import { PATH_SEPARATOR } from "@/app/api/[locale]/system/unified-interface/shared/utils/path";
-
-/**
- * Default directories to exclude from scanning
- */
-export const DEFAULT_EXCLUDE_DIRS = ["node_modules", ".git", ".next", "dist", ".dist", "generated"];
-
-/**
- * Recursively find files with specific filename in a directory
- */
-export function findFilesRecursively(
-  dir: string,
-  targetFilename: string,
-  excludeDirs: string[] = DEFAULT_EXCLUDE_DIRS,
-): string[] {
-  const results: string[] = [];
-
-  if (!existsSync(dir)) {
-    return results;
-  }
-
-  const entries = readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-
-    // Skip excluded directories
-    if (entry.isDirectory() && excludeDirs.includes(entry.name)) {
-      continue;
-    }
-
-    if (entry.isDirectory()) {
-      // Recursively search subdirectories
-      results.push(...findFilesRecursively(fullPath, targetFilename, excludeDirs));
-    } else if (entry.isFile() && entry.name === targetFilename) {
-      // Found a matching file
-      results.push(fullPath);
-    }
-  }
-
-  return results;
-}
-
-/**
- * Get relative import path from source file to output file
- */
-export function getRelativeImportPath(sourceFile: string, outputFile: string): string {
-  const outputDir = dirname(outputFile);
-  let relativePath = relative(outputDir, sourceFile);
-
-  // Remove .ts extension and normalize path separators
-  relativePath = relativePath.replace(/\.ts$/, "").replaceAll("\\", "/");
-
-  // Ensure it starts with ./ or ../
-  if (!relativePath.startsWith(".")) {
-    relativePath = `./${relativePath}`;
-  }
-
-  return relativePath;
-}
-
-/**
- * Extract nested path segments from a file path
- * Example: src/app/api/[locale]/agent/chat/characters/definition.ts
- * Returns: ["agent", "chat", "characters"]
- */
-export function extractNestedPath(
-  filePath: string,
-  startMarker = "[locale]",
-  endMarker?: string,
-): string[] {
-  const pathParts = filePath.split("/");
-
-  const startIndex = pathParts.findIndex((p) => p === startMarker);
-  if (startIndex === -1) {
-    // eslint-disable-next-line oxlint-plugin-restricted/restricted-syntax -- Build-time generator that throws for invalid configuration at startup
-    throw new Error(`Could not find ${startMarker} in path: ${filePath}`);
-  }
-
-  // If no end marker provided, auto-detect definition.ts or route.ts
-  let actualEndMarker = endMarker;
-  if (!actualEndMarker) {
-    if (pathParts.includes("definition.ts")) {
-      actualEndMarker = "definition.ts";
-    } else if (pathParts.includes("route.ts")) {
-      actualEndMarker = "route.ts";
-    } else {
-      // eslint-disable-next-line oxlint-plugin-restricted/restricted-syntax -- Build-time generator that throws for invalid configuration at startup
-      throw new Error(
-        `Could not auto-detect end marker (definition.ts or route.ts) in path: ${filePath}`,
-      );
-    }
-  }
-
-  const endIndex = pathParts.findIndex((p) => p === actualEndMarker);
-  if (endIndex === -1) {
-    // eslint-disable-next-line oxlint-plugin-restricted/restricted-syntax -- Build-time generator that throws for invalid configuration at startup
-    throw new Error(`Could not find ${actualEndMarker} in path: ${filePath}`);
-  }
-
-  // Extract path segments between locale and the target file
-  // Skip the [locale] marker itself, start from the next segment
-  return pathParts.slice(startIndex + 1, endIndex);
-}
-
-/**
- * Extract module name from file path
- * Example: .../core/leads/seeds.ts -> "leads"
- * Example: .../core/emails/smtp-client/seeds.ts -> "smtp-client"
- */
-export function extractModuleName(filePath: string, coreMarker = "core"): string {
-  const pathParts = filePath.split("/");
-  const coreIndex = pathParts.findIndex((p) => p === coreMarker);
-
-  if (coreIndex === -1 || coreIndex >= pathParts.length - 1) {
-    return pathParts.at(-2) || "unknown";
-  }
-
-  const moduleParts = pathParts.slice(coreIndex + 1, pathParts.length - 1);
-  return moduleParts.at(-1) || moduleParts.join("-");
-}
-
-/**
- * Write generated content to file
- */
-export async function writeGeneratedFile(
-  filePath: string,
-  content: string,
-  dryRun = false,
-): Promise<void> {
-  if (dryRun) {
-    return;
-  }
-
-  const outputDir = dirname(filePath);
-  if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
-  }
-
-  await writeFile(filePath, content, "utf8");
-}
-
-/**
- * Generate standard file header
- */
-export function generateFileHeader(
-  title: string,
-  generatedBy: string,
-  additionalInfo?: Record<string, string | number>,
-): string {
-  const lines = ["/**"];
-  lines.push(` * ${title}`);
-  lines.push(` * Generated by ${generatedBy}`);
-
-  if (additionalInfo) {
-    lines.push(" *");
-    for (const [key, value] of Object.entries(additionalInfo)) {
-      lines.push(` * ${key}: ${value}`);
-    }
-  }
-
-  lines.push(" */");
-
-  return lines.join("\n");
-}
-
-/**
- * Sanitize a path segment to remove invalid characters for tool names
- * Removes square brackets from dynamic routes like [id]
- * This must match the sanitization in endpointToToolName to ensure consistency
- */
-function sanitizePathSegment(segment: string): string {
-  // Remove square brackets to handle dynamic routes like [id]
-  // Example: "[id]" becomes "id", "[threadId]" becomes "threadId"
-  return segment.replaceAll(/\[|\]/g, "");
-}
-
-/**
- * Extract path from definition file for flat structure
- * Returns path only - no duplicate parameter format aliases
- * Real aliases come from definition files, not parameter format variations
- * Uses PATH_SEPARATOR constant for consistency
- * Sanitizes path segments to match endpointToToolName behavior
- */
-export function extractPathKey(filePath: string, startMarker = "[locale]"): { path: string } {
-  const nestedPath = extractNestedPath(filePath, startMarker);
-  // Sanitize each segment to remove brackets from dynamic routes
-  const sanitizedPath = nestedPath.map(sanitizePathSegment);
-  const path = sanitizedPath.join(PATH_SEPARATOR);
-  return { path };
-}
-
-/**
- * Generate absolute import path for definition or route file
- * nestedPath extracts segments after [locale], which we then append to the base path
- */
-export function generateAbsoluteImportPath(
-  filePath: string,
-  fileType: "definition" | "route",
-): string {
-  const nestedPath = extractNestedPath(filePath);
-  const pathStr = nestedPath.join("/");
-  return `@/app/api/[locale]/${pathStr}/${fileType}`;
-}

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

@@ -1,433 +0,0 @@
-/**
- * Help Command Endpoint Definition
- * Production-ready endpoint for displaying help information
- */
-
-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", "help"],
-  title: "app.api.system.help.post.title",
-  description: "app.api.system.help.post.description",
-  category: "app.api.system.help.category",
-  tags: ["app.api.system.help.tag"],
-  icon: "help-circle",
-  allowedRoles: [
-    UserRole.ADMIN,
-    UserRole.AI_TOOL_OFF,
-    UserRole.MCP_OFF,
-    UserRole.PRODUCTION_OFF,
-    UserRole.CLI_AUTH_BYPASS,
-  ],
-  aliases: ["help", "h"],
-  cli: {
-    firstCliArgKey: "command",
-  },
-
-  fields: objectField(
-    {
-      type: WidgetType.CONTAINER,
-      layoutType: LayoutType.STACKED,
-    },
-    { request: "data", response: true },
-    {
-      // === REQUEST FIELDS ===
-      command: requestDataField(
-        {
-          type: WidgetType.FORM_FIELD,
-          fieldType: FieldDataType.TEXT,
-          label: "app.api.system.help.fields.command.label",
-          description: "app.api.system.help.fields.command.description",
-          placeholder: "app.api.system.help.fields.command.placeholder",
-          columns: 12,
-        },
-        z.string().optional(),
-      ),
-
-      // === RESPONSE FIELDS ===
-      // Header section
-      header: objectField(
-        {
-          type: WidgetType.SECTION,
-          layoutType: LayoutType.STACKED,
-        },
-        { response: true },
-        {
-          title: responseField(
-            {
-              type: WidgetType.TITLE,
-              content: "app.api.system.help.fields.header.title" as const,
-            },
-            z.string(),
-          ),
-          description: responseField(
-            {
-              type: WidgetType.TEXT,
-              content: "app.api.system.help.fields.header.description" as const,
-            },
-            z.string().optional(),
-          ),
-        },
-      ),
-
-      // Usage section
-      usage: objectField(
-        {
-          type: WidgetType.SECTION,
-          title: "app.api.system.help.fields.usage.title",
-          layoutType: LayoutType.STACKED,
-        },
-        { response: true },
-        {
-          patterns: responseArrayField(
-            {
-              type: WidgetType.DATA_LIST,
-            },
-            responseField(
-              {
-                type: WidgetType.TEXT,
-                content: "app.api.system.help.fields.usage.patterns.item" as const,
-              },
-              z.string(),
-            ),
-          ),
-        },
-      ),
-
-      // Options section
-      options: objectField(
-        {
-          type: WidgetType.SECTION,
-          title: "app.api.system.help.fields.options.title",
-          layoutType: LayoutType.STACKED,
-        },
-        { response: true },
-        {
-          items: responseArrayField(
-            {
-              type: WidgetType.DATA_LIST,
-            },
-            objectField(
-              {
-                type: WidgetType.CONTAINER,
-                layoutType: LayoutType.HORIZONTAL,
-              },
-              { response: true },
-              {
-                flag: responseField(
-                  {
-                    type: WidgetType.TEXT,
-                    content: "app.api.system.help.fields.options.flag" as const,
-                  },
-                  z.string(),
-                ),
-                description: responseField(
-                  {
-                    type: WidgetType.TEXT,
-                    content: "app.api.system.help.fields.options.description" as const,
-                  },
-                  z.string(),
-                ),
-              },
-            ),
-          ),
-        },
-      ),
-
-      // Examples section
-      examples: objectField(
-        {
-          type: WidgetType.SECTION,
-          title: "app.api.system.help.fields.examples.title",
-          layoutType: LayoutType.STACKED,
-        },
-        { response: true },
-        {
-          items: responseArrayField(
-            {
-              type: WidgetType.DATA_LIST,
-            },
-            objectField(
-              {
-                type: WidgetType.CONTAINER,
-                layoutType: LayoutType.HORIZONTAL,
-              },
-              { response: true },
-              {
-                command: responseField(
-                  {
-                    type: WidgetType.TEXT,
-                    content: "app.api.system.help.fields.examples.command" as const,
-                  },
-                  z.string(),
-                ),
-                description: responseField(
-                  {
-                    type: WidgetType.TEXT,
-                    content: "app.api.system.help.fields.examples.description" as const,
-                  },
-                  z.string().optional(),
-                ),
-              },
-            ),
-          ),
-        },
-      ),
-
-      // Common Commands section (only for general help)
-      commonCommands: objectField(
-        {
-          type: WidgetType.SECTION,
-          title: "app.api.system.help.fields.commonCommands.title",
-          layoutType: LayoutType.STACKED,
-        },
-        { response: true },
-        {
-          items: responseArrayField(
-            {
-              type: WidgetType.DATA_LIST,
-            },
-            objectField(
-              {
-                type: WidgetType.CONTAINER,
-                layoutType: LayoutType.HORIZONTAL,
-              },
-              { response: true },
-              {
-                command: responseField(
-                  {
-                    type: WidgetType.TEXT,
-                    content: "app.api.system.help.fields.examples.command" as const,
-                  },
-                  z.string(),
-                ),
-                description: responseField(
-                  {
-                    type: WidgetType.TEXT,
-                    content: "app.api.system.help.fields.options.description" as const,
-                  },
-                  z.string(),
-                ),
-              },
-            ),
-          ),
-        },
-      ),
-
-      // Details section (only for specific command help)
-      details: objectField(
-        {
-          type: WidgetType.SECTION,
-          title: "app.api.system.help.fields.details.title",
-          layoutType: LayoutType.GRID,
-        },
-        { response: true },
-        {
-          category: responseField(
-            {
-              type: WidgetType.TEXT,
-              content: "app.api.system.help.fields.details.category.content" as const,
-              label: "app.api.system.help.fields.details.category.content",
-            },
-            z.string().optional(),
-          ),
-          path: responseField(
-            {
-              type: WidgetType.TEXT,
-              content: "app.api.system.help.fields.details.path.content" as const,
-              label: "app.api.system.help.fields.details.path.content",
-            },
-            z.string().optional(),
-          ),
-          method: responseField(
-            {
-              type: WidgetType.TEXT,
-              content: "app.api.system.help.fields.details.method.content" as const,
-              label: "app.api.system.help.fields.details.method.content",
-            },
-            z.string().optional(),
-          ),
-          aliases: responseField(
-            {
-              type: WidgetType.TEXT,
-              content: "app.api.system.help.fields.details.aliases.content" as const,
-              label: "app.api.system.help.fields.details.aliases.content",
-            },
-            z.string().optional(),
-          ),
-        },
-      ),
-    },
-  ),
-
-  // === ERROR HANDLING ===
-  errorTypes: {
-    [EndpointErrorTypes.VALIDATION_FAILED]: {
-      title: "app.api.system.help.post.errors.validation.title",
-      description: "app.api.system.help.post.errors.validation.description",
-    },
-    [EndpointErrorTypes.NETWORK_ERROR]: {
-      title: "app.api.system.help.post.errors.network.title",
-      description: "app.api.system.help.post.errors.network.description",
-    },
-    [EndpointErrorTypes.UNAUTHORIZED]: {
-      title: "app.api.system.help.post.errors.unauthorized.title",
-      description: "app.api.system.help.post.errors.unauthorized.description",
-    },
-    [EndpointErrorTypes.FORBIDDEN]: {
-      title: "app.api.system.help.post.errors.forbidden.title",
-      description: "app.api.system.help.post.errors.forbidden.description",
-    },
-    [EndpointErrorTypes.NOT_FOUND]: {
-      title: "app.api.system.help.post.errors.notFound.title",
-      description: "app.api.system.help.post.errors.notFound.description",
-    },
-    [EndpointErrorTypes.SERVER_ERROR]: {
-      title: "app.api.system.help.post.errors.server.title",
-      description: "app.api.system.help.post.errors.server.description",
-    },
-    [EndpointErrorTypes.UNKNOWN_ERROR]: {
-      title: "app.api.system.help.post.errors.unknown.title",
-      description: "app.api.system.help.post.errors.unknown.description",
-    },
-    [EndpointErrorTypes.UNSAVED_CHANGES]: {
-      title: "app.api.system.help.post.errors.server.title",
-      description: "app.api.system.help.post.errors.server.description",
-    },
-    [EndpointErrorTypes.CONFLICT]: {
-      title: "app.api.system.help.post.errors.conflict.title",
-      description: "app.api.system.help.post.errors.conflict.description",
-    },
-  },
-
-  // === SUCCESS HANDLING ===
-  successTypes: {
-    title: "app.api.system.help.post.success.title",
-    description: "app.api.system.help.post.success.description",
-  },
-
-  // === EXAMPLES ===
-  examples: {
-    urlPathParams: undefined,
-    requests: {
-      default: {
-        command: undefined,
-      },
-      specificCommand: {
-        command: "check",
-      },
-    },
-    responses: {
-      default: {
-        header: {
-          title: "Vibe CLI - Next-generation API execution tool",
-          description: "Command-line interface for Next-Vibe API with real-time execution",
-        },
-        usage: {
-          patterns: ["vibe <command> [options]", "vibe <command> --help"],
-        },
-        commonCommands: {
-          items: [
-            { command: "list", description: "List all available commands" },
-            { command: "check", description: "Run code quality checks" },
-            { command: "db:migrate", description: "Run database migrations" },
-            { command: "test", description: "Run test suite" },
-          ],
-        },
-        options: {
-          items: [
-            { flag: "-d, --data <json>", description: "Pass JSON data" },
-            {
-              flag: "-o, --output <format>",
-              description: "Output format (pretty|json)",
-            },
-            { flag: "-v, --verbose", description: "Enable verbose output" },
-            {
-              flag: "-l, --locale <locale>",
-              description: "Set locale (en-GLOBAL|de-DE|pl-PL)",
-            },
-            { flag: "--help", description: "Show this help" },
-          ],
-        },
-        examples: {
-          items: [
-            { command: "vibe list", description: "List all commands" },
-            { command: "vibe check", description: "Run checks" },
-            { command: "vibe db:migrate", description: "Run migrations" },
-            { command: "vibe help check", description: "Get command help" },
-          ],
-        },
-        details: {
-          category: undefined,
-          path: undefined,
-          method: undefined,
-          aliases: undefined,
-        },
-      },
-      specificCommand: {
-        header: {
-          title: "check - Run comprehensive code quality checks",
-          description: "Runs linting, type checking, and other code quality tools",
-        },
-        usage: {
-          patterns: ["vibe check [paths] [options]"],
-        },
-        details: {
-          category: "system",
-          path: "/system/check",
-          method: "POST",
-          aliases: "check, c",
-        },
-        options: {
-          items: [
-            { flag: "--fix", description: "Automatically fix issues" },
-            { flag: "--skip-lint", description: "Skip linting" },
-            { flag: "--skip-types", description: "Skip type checking" },
-            { flag: "-v, --verbose", description: "Enable verbose output" },
-          ],
-        },
-        examples: {
-          items: [
-            { command: "vibe check", description: "Run all checks" },
-            { command: "vibe check --fix", description: "Fix issues" },
-            { command: "vibe c --skip-lint", description: "Skip linting" },
-          ],
-        },
-        commonCommands: {
-          items: [
-            { command: "list", description: "List all available commands" },
-            { command: "check", description: "Run code quality checks" },
-            { command: "db:migrate", description: "Run database migrations" },
-            { command: "test", description: "Run test suite" },
-          ],
-        },
-      },
-    },
-  },
-});
-
-export type HelpRequestInput = typeof POST.types.RequestInput;
-export type HelpRequestOutput = typeof POST.types.RequestOutput;
-export type HelpResponseInput = typeof POST.types.ResponseInput;
-export type HelpResponseOutput = typeof POST.types.ResponseOutput;
-
-const endpoints = { POST };
-export default endpoints;