@next-vibe/checker 1.0.11 → 1.0.12

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

@@ -0,0 +1,262 @@
+export const translations = {
+  category: "Help & Documentation",
+  tag: "Help",
+  interactive: {
+    post: {
+      title: "Interactive Mode",
+      description:
+        "Start interactive file explorer mode for navigating and executing routes",
+      category: "System Help",
+      tags: {
+        system: "system",
+        help: "help",
+      },
+      summary: "Start interactive mode",
+    },
+    ui: {
+      title: "Interactive API Explorer",
+      description: "Browse and execute all",
+      availableEndpoints: "available endpoints",
+      endpointsLabel: "Endpoints",
+      aliasesLabel: "Aliases:",
+      selectEndpoint: "Select an endpoint from the list to get started",
+    },
+    response: {
+      started: "Interactive mode started successfully",
+    },
+    errors: {
+      cliOnly: {
+        title: "CLI Only",
+        description: "Interactive mode is only available from CLI",
+      },
+      unauthorized: {
+        title: "Unauthorized",
+        description: "Authentication required for interactive mode",
+      },
+      server: {
+        title: "Server Error",
+        description: "Failed to start interactive mode",
+      },
+    },
+    success: {
+      title: "Success",
+      description: "Interactive mode started successfully",
+    },
+    grouping: {
+      category: "Category",
+      tags: "Tags",
+      path: "Path",
+    },
+  },
+  post: {
+    title: "Show Help Information",
+    description: "Display help information about CLI commands",
+    form: {
+      title: "Help Options",
+      description: "Get help for specific commands or general usage",
+    },
+    errors: {
+      validation: {
+        title: "Validation Error",
+        description: "Invalid help command parameters",
+      },
+      network: {
+        title: "Network Error",
+        description: "Failed to fetch help information",
+      },
+      unauthorized: {
+        title: "Unauthorized",
+        description: "You are not authorized to view help",
+      },
+      forbidden: {
+        title: "Forbidden",
+        description: "You do not have permission to view help",
+      },
+      notFound: {
+        title: "Command Not Found",
+        description: "The specified command was not found",
+      },
+      server: {
+        title: "Server Error",
+        description: "Failed to generate help information",
+      },
+      unknown: {
+        title: "Unknown Error",
+        description: "An unexpected error occurred while generating help",
+      },
+      conflict: {
+        title: "Conflict",
+        description: "Help generation conflict detected",
+      },
+    },
+    success: {
+      title: "Help Generated",
+      description: "Successfully generated help information",
+    },
+  },
+  fields: {
+    command: {
+      label: "Command",
+      description:
+        "Specific command to get help for (leave empty for general help)",
+      placeholder: "e.g., check, list, db:ping",
+    },
+    header: {
+      title: "Header",
+      description: "Header Description",
+    },
+    title: {
+      label: "Title",
+    },
+    description: {
+      label: "Description",
+    },
+    usage: {
+      title: "Usage",
+      patterns: {
+        item: "Pattern",
+      },
+    },
+    commonCommands: {
+      title: "Common Commands",
+      items: "Commands",
+      command: "Command",
+      description: "Description",
+    },
+    options: {
+      title: "Options",
+      items: "Options",
+      flag: "Flag",
+      description: "Description",
+    },
+    examples: {
+      title: "Examples",
+      items: "Examples",
+      command: "Command",
+      description: "Description",
+    },
+    details: {
+      title: "Details",
+      category: {
+        content: "Category",
+      },
+      path: {
+        content: "Path",
+      },
+      method: {
+        content: "Method",
+      },
+      aliases: {
+        content: "Aliases",
+      },
+    },
+  },
+  list: {
+    post: {
+      title: "List Available Commands",
+      description:
+        "Show all available CLI commands with their descriptions and aliases",
+      form: {
+        title: "Command List Options",
+        description: "Configure how commands are displayed",
+      },
+      errors: {
+        validation: {
+          title: "Validation Error",
+          description: "Invalid list command parameters",
+        },
+        network: {
+          title: "Network Error",
+          description: "Failed to fetch command list",
+        },
+        unauthorized: {
+          title: "Unauthorized",
+          description: "You are not authorized to list commands",
+        },
+        forbidden: {
+          title: "Forbidden",
+          description: "You do not have permission to list commands",
+        },
+        notFound: {
+          title: "Not Found",
+          description: "Command list not found",
+        },
+        server: {
+          title: "Server Error",
+          description: "Failed to generate command list",
+          errorLoading: "Error loading commands: {{error}}",
+        },
+        unknown: {
+          title: "Unknown Error",
+          description: "An unexpected error occurred while listing commands",
+        },
+        conflict: {
+          title: "Conflict",
+          description: "Command list conflict detected",
+        },
+      },
+      success: {
+        title: "Commands Listed",
+        description: "Successfully retrieved command list",
+      },
+    },
+    tag: "Help",
+    fields: {
+      category: {
+        label: "Filter by Category",
+        description: "Show only commands in this category",
+        placeholder: "e.g., system, database, user",
+      },
+      format: {
+        label: "Output Format",
+        description: "How to display the command list",
+        options: {
+          tree: "Tree View (nested hierarchy)",
+          flat: "Flat List (simple listing)",
+          json: "JSON Format (for parsing)",
+        },
+      },
+      showAliases: {
+        label: "Show Aliases",
+        description: "Display all available command aliases",
+      },
+      showDescriptions: {
+        label: "Show Descriptions",
+        description: "Include command descriptions in the output",
+      },
+      success: {
+        label: "Success",
+      },
+      totalCommands: {
+        label: "Total Commands",
+        description: "Number of available commands",
+      },
+      commandsText: {
+        label: "Available Commands",
+        description: "Formatted list of all available commands",
+      },
+      commands: {
+        alias: "Command Alias",
+        message: "Command Message",
+        description: "Command Description",
+        category: "Command Category",
+        aliases: "Command Aliases",
+        rule: "Command Rule",
+      },
+    },
+    response: {
+      commands: {
+        title: "Available Commands",
+        emptyState: {
+          description: "No commands found",
+        },
+        alias: "Command",
+        path: "API Path",
+        method: "HTTP Method",
+        category: "Category",
+        description: "Description",
+        aliases: "Aliases",
+      },
+    },
+  },
+};

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

@@ -0,0 +1,265 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  category: "Pomoc i Dokumentacja",
+  tag: "Pomoc",
+  interactive: {
+    post: {
+      title: "Tryb interaktywny",
+      description:
+        "Uruchom interaktywny tryb eksploratora plików do nawigacji i wykonywania tras",
+      category: "Pomoc systemowa",
+      tags: {
+        system: "system",
+        help: "pomoc",
+      },
+      summary: "Uruchom tryb interaktywny",
+    },
+    ui: {
+      title: "Interaktywny Eksplorator API",
+      description: "Przeglądaj i wykonuj wszystkie",
+      availableEndpoints: "dostępne punkty końcowe",
+      endpointsLabel: "Punkty końcowe",
+      aliasesLabel: "Aliasy:",
+      selectEndpoint: "Wybierz punkt końcowy z listy, aby rozpocząć",
+    },
+    response: {
+      started: "Tryb interaktywny uruchomiony pomyślnie",
+    },
+    errors: {
+      cliOnly: {
+        title: "Tylko CLI",
+        description: "Tryb interaktywny jest dostępny tylko z CLI",
+      },
+      unauthorized: {
+        title: "Nieautoryzowany",
+        description: "Wymagana autentykacja dla trybu interaktywnego",
+      },
+      server: {
+        title: "Błąd serwera",
+        description: "Nie udało się uruchomić trybu interaktywnego",
+      },
+    },
+    success: {
+      title: "Sukces",
+      description: "Tryb interaktywny uruchomiony pomyślnie",
+    },
+    grouping: {
+      category: "Kategoria",
+      tags: "Tagi",
+      path: "Ścieżka",
+    },
+  },
+  post: {
+    title: "Pokaż informacje pomocy",
+    description: "Wyświetl informacje pomocy dotyczące poleceń CLI",
+    form: {
+      title: "Opcje pomocy",
+      description: "Uzyskaj pomoc dla konkretnych poleceń lub ogólne użycie",
+    },
+    errors: {
+      validation: {
+        title: "Błąd walidacji",
+        description: "Nieprawidłowe parametry pomocy",
+      },
+      network: {
+        title: "Błąd sieci",
+        description: "Nie udało się pobrać informacji pomocy",
+      },
+      unauthorized: {
+        title: "Brak autoryzacji",
+        description: "Nie masz uprawnień do wyświetlania pomocy",
+      },
+      forbidden: {
+        title: "Zabronione",
+        description: "Nie masz uprawnień do wyświetlania pomocy",
+      },
+      notFound: {
+        title: "Polecenie nie znalezione",
+        description: "Określone polecenie nie zostało znalezione",
+      },
+      server: {
+        title: "Błąd serwera",
+        description: "Nie udało się wygenerować informacji pomocy",
+      },
+      unknown: {
+        title: "Nieznany błąd",
+        description: "Wystąpił nieoczekiwany błąd podczas generowania pomocy",
+      },
+      conflict: {
+        title: "Konflikt",
+        description: "Wykryto konflikt generowania pomocy",
+      },
+    },
+    success: {
+      title: "Pomoc wygenerowana",
+      description: "Pomyślnie wygenerowano informacje pomocy",
+    },
+  },
+  fields: {
+    command: {
+      label: "Polecenie",
+      description:
+        "Konkretne polecenie, dla którego uzyskać pomoc (pozostaw puste dla ogólnej pomocy)",
+      placeholder: "np. check, list, db:ping",
+    },
+    header: {
+      title: "Nagłówek",
+      description: "Opis nagłówka",
+    },
+    title: {
+      label: "Tytuł",
+    },
+    description: {
+      label: "Opis",
+    },
+    usage: {
+      title: "Użycie",
+      patterns: {
+        item: "Wzorzec",
+      },
+    },
+    commonCommands: {
+      title: "Popularne polecenia",
+      items: "Polecenia",
+      command: "Polecenie",
+      description: "Opis",
+    },
+    options: {
+      title: "Opcje",
+      items: "Opcje",
+      flag: "Flaga",
+      description: "Opis",
+    },
+    examples: {
+      title: "Przykłady",
+      items: "Przykłady",
+      command: "Polecenie",
+      description: "Opis",
+    },
+    details: {
+      title: "Szczegóły",
+      category: {
+        content: "Kategoria",
+      },
+      path: {
+        content: "Ścieżka",
+      },
+      method: {
+        content: "Metoda",
+      },
+      aliases: {
+        content: "Aliasy",
+      },
+    },
+  },
+  list: {
+    post: {
+      title: "Lista dostępnych poleceń",
+      description:
+        "Pokaż wszystkie dostępne polecenia CLI z opisami i aliasami",
+      form: {
+        title: "Opcje listy poleceń",
+        description: "Skonfiguruj sposób wyświetlania poleceń",
+      },
+      errors: {
+        validation: {
+          title: "Błąd walidacji",
+          description: "Nieprawidłowe parametry polecenia listy",
+        },
+        network: {
+          title: "Błąd sieci",
+          description: "Nie udało się pobrać listy poleceń",
+        },
+        unauthorized: {
+          title: "Brak autoryzacji",
+          description: "Nie masz uprawnień do wyświetlania poleceń",
+        },
+        forbidden: {
+          title: "Zabronione",
+          description: "Nie masz uprawnień do wyświetlania poleceń",
+        },
+        notFound: {
+          title: "Nie znaleziono",
+          description: "Lista poleceń nie została znaleziona",
+        },
+        server: {
+          title: "Błąd serwera",
+          description: "Nie udało się wygenerować listy poleceń",
+          errorLoading: "Błąd podczas ładowania poleceń: {{error}}",
+        },
+        unknown: {
+          title: "Nieznany błąd",
+          description:
+            "Wystąpił nieoczekiwany błąd podczas wyświetlania poleceń",
+        },
+        conflict: {
+          title: "Konflikt",
+          description: "Wykryto konflikt listy poleceń",
+        },
+      },
+      success: {
+        title: "Polecenia wyświetlone",
+        description: "Pomyślnie pobrano listę poleceń",
+      },
+    },
+    tag: "Pomoc",
+    fields: {
+      category: {
+        label: "Filtruj według kategorii",
+        description: "Pokaż tylko polecenia z tej kategorii",
+        placeholder: "np. system, database, user",
+      },
+      format: {
+        label: "Format wyjściowy",
+        description: "Sposób wyświetlania listy poleceń",
+        options: {
+          tree: "Widok drzewa (zagnieżdżona hierarchia)",
+          flat: "Lista płaska (proste wyświetlanie)",
+          json: "Format JSON (do parsowania)",
+        },
+      },
+      showAliases: {
+        label: "Pokaż aliasy",
+        description: "Wyświetl wszystkie dostępne aliasy poleceń",
+      },
+      showDescriptions: {
+        label: "Pokaż opisy",
+        description: "Uwzględnij opisy poleceń w wyniku",
+      },
+      success: {
+        label: "Sukces",
+      },
+      totalCommands: {
+        label: "Łączna liczba poleceń",
+        description: "Liczba dostępnych poleceń",
+      },
+      commandsText: {
+        label: "Dostępne polecenia",
+        description: "Sformatowana lista wszystkich dostępnych poleceń",
+      },
+      commands: {
+        alias: "Alias polecenia",
+        message: "Komunikat polecenia",
+        description: "Opis polecenia",
+        category: "Kategoria polecenia",
+        aliases: "Aliasy polecenia",
+        rule: "Reguła polecenia",
+      },
+    },
+    response: {
+      commands: {
+        title: "Dostępne polecenia",
+        emptyState: {
+          description: "Nie znaleziono poleceń",
+        },
+        alias: "Polecenie",
+        path: "Ścieżka API",
+        method: "Metoda HTTP",
+        category: "Kategoria",
+        description: "Opis",
+        aliases: "Aliasy",
+      },
+    },
+  },
+};

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

@@ -0,0 +1,125 @@
+/**
+ * Interactive Mode Endpoint Definition
+ * Provides file explorer-like navigation and form-based interface
+ */
+
+import { z } from "zod";
+
+import { createEndpoint } from "@/app/api/[locale]/system/unified-interface/shared/endpoints/definition/create";
+import {
+  objectField,
+  responseField,
+} from "@/app/api/[locale]/system/unified-interface/shared/field/utils";
+import {
+  EndpointErrorTypes,
+  LayoutType,
+  Methods,
+  WidgetType,
+} from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
+
+import { UserRole } from "../../../user/user-roles/enum";
+
+export const INTERACTIVE_MODE_ALIAS = "interactive" as const;
+
+const { POST } = createEndpoint({
+  method: Methods.POST,
+  path: ["system", "help", "interactive"],
+  title: "app.api.system.help.interactive.post.title",
+  description: "app.api.system.help.interactive.post.description",
+  category: "app.api.system.help.interactive.post.category",
+  tags: [
+    "app.api.system.help.interactive.post.tags.system",
+    "app.api.system.help.interactive.post.tags.help",
+  ],
+  icon: "book",
+  allowedRoles: [
+    UserRole.PRODUCTION_OFF,
+    UserRole.AI_TOOL_OFF,
+    UserRole.MCP_OFF,
+    UserRole.CLI_AUTH_BYPASS,
+  ],
+  aliases: [INTERACTIVE_MODE_ALIAS, "i"],
+
+  fields: objectField(
+    {
+      type: WidgetType.CONTAINER,
+      title: "app.api.system.help.interactive.post.title",
+      description: "app.api.system.help.interactive.post.description",
+      layoutType: LayoutType.GRID,
+      columns: 12,
+    },
+    { response: true },
+    {
+      started: responseField(
+        {
+          type: WidgetType.TEXT,
+          content: "app.api.system.help.interactive.response.started",
+        },
+        z.boolean(),
+      ),
+    },
+  ),
+
+  errorTypes: {
+    [EndpointErrorTypes.VALIDATION_FAILED]: {
+      title: "app.api.system.help.interactive.errors.unauthorized.title",
+      description:
+        "app.api.system.help.interactive.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.NETWORK_ERROR]: {
+      title: "app.api.system.help.interactive.errors.server.title",
+      description: "app.api.system.help.interactive.errors.server.description",
+    },
+    [EndpointErrorTypes.UNAUTHORIZED]: {
+      title: "app.api.system.help.interactive.errors.unauthorized.title",
+      description:
+        "app.api.system.help.interactive.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.FORBIDDEN]: {
+      title: "app.api.system.help.interactive.errors.unauthorized.title",
+      description:
+        "app.api.system.help.interactive.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.NOT_FOUND]: {
+      title: "app.api.system.help.interactive.errors.server.title",
+      description: "app.api.system.help.interactive.errors.server.description",
+    },
+    [EndpointErrorTypes.SERVER_ERROR]: {
+      title: "app.api.system.help.interactive.errors.server.title",
+      description: "app.api.system.help.interactive.errors.server.description",
+    },
+    [EndpointErrorTypes.UNKNOWN_ERROR]: {
+      title: "app.api.system.help.interactive.errors.server.title",
+      description: "app.api.system.help.interactive.errors.server.description",
+    },
+    [EndpointErrorTypes.UNSAVED_CHANGES]: {
+      title: "app.api.system.help.interactive.errors.server.title",
+      description: "app.api.system.help.interactive.errors.server.description",
+    },
+    [EndpointErrorTypes.CONFLICT]: {
+      title: "app.api.system.help.interactive.errors.server.title",
+      description: "app.api.system.help.interactive.errors.server.description",
+    },
+  },
+
+  successTypes: {
+    title: "app.api.system.help.interactive.success.title",
+    description: "app.api.system.help.interactive.success.description",
+  },
+
+  examples: {
+    responses: {
+      default: {
+        started: true,
+      },
+    },
+  },
+});
+
+export type InteractiveRequestInput = typeof POST.types.RequestInput;
+export type InteractiveRequestOutput = typeof POST.types.RequestOutput;
+export type InteractiveResponseInput = typeof POST.types.ResponseInput;
+export type InteractiveResponseOutput = typeof POST.types.ResponseOutput;
+
+const interactiveEndpoints = { POST };
+export default interactiveEndpoints;

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

@@ -0,0 +1,22 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  title: "Interaktiver API-Explorer",
+  description:
+    "Durchsuchen und testen Sie alle Endpunktdefinitionen interaktiv",
+  grouping: {
+    category: "Kategorie",
+    tags: "Tags",
+    path: "Pfad",
+  },
+  search: {
+    placeholder: "Endpunkte suchen...",
+  },
+  noEndpoints: "Keine Endpunkte gefunden",
+  selectEndpoint: "Wählen Sie einen Endpunkt aus, um Details anzuzeigen",
+  errors: {
+    cliOnly: {
+      title: "Nur CLI",
+    },
+  },
+};

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

@@ -0,0 +1,19 @@
+export const translations = {
+  title: "Interactive API Explorer",
+  description: "Browse and execute all endpoint definitions interactively",
+  grouping: {
+    category: "Category",
+    tags: "Tags",
+    path: "Path",
+  },
+  search: {
+    placeholder: "Search endpoints...",
+  },
+  noEndpoints: "No endpoints found",
+  selectEndpoint: "Select an endpoint to view details",
+  errors: {
+    cliOnly: {
+      title: "CLI only",
+    },
+  },
+};