@dxtmisha/scripts 0.11.8 → 1.1.0

package/src/classes/Library/LibraryAiPrompt.ts

@@ -1,268 +0,0 @@
-import {
-  UI_FILE_AI_MCP_ALL,
-  UI_FILE_AI_PROMPT_INSTRUCTION,
-  UI_FILE_AI_PROMPT_PROMPT,
-  UI_MODULES
-} from '../../config'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { LibraryAiPromptItem } from './LibraryAiPromptItem'
-
-import vuePromptText from '../../media/templates/prompts/aiCodeVuePrompt.en.md?raw'
-import globalPromptText from '../../media/templates/prompts/aiCodeGlobalPrompt.en.md?raw'
-
-const LIBRARY_AI_PROMPT_LIST_DIRS = [
-  UI_MODULES
-]
-
-/**
- * Class for generating a consolidated AI prompt for the library.
- * It scans directories for prompt items and instructions to create a final prompt file.
- *
- * Класс для генерации консолидированного промпта ИИ для библиотеки.
- * Сканирует директории на наличие элементов промпта и инструкций для создания итогового файла промпта.
- */
-export class LibraryAiPrompt {
-  /** List of directories to scan. / Список директорий для сканирования. */
-  protected readonly dirs: string[]
-
-  /** Regular expression to identify files in directories. / Регулярное выражение для идентификации файлов в директориях. */
-  protected readonly exFileOnDirs = /^.+\.[^.]{2,4}$/
-  /** Regular expression to exclude hidden files/directories. / Регулярное выражение для исключения скрытых файлов/директорий. */
-  protected readonly exNotRead = /^\./
-
-  /**
-   * Constructor for LibraryAiPrompt.
-   *
-   * Конструктор для LibraryAiPrompt.
-   * @param dirs Additional directories to scan / Дополнительные директории для сканирования
-   * @param isMcp Flag indicating whether to generate MCP configuration file / Флаг, указывающий, нужно ли генерировать конфигурационный файл MCP
-   */
-  constructor(
-    dirs: string[] = [],
-    protected readonly isMcp: boolean = false
-  ) {
-    this.dirs = [
-      ...LIBRARY_AI_PROMPT_LIST_DIRS,
-      ...dirs
-    ]
-  }
-
-  /**
-   * Main method to generate the AI prompt file.
-   *
-   * Основной метод для генерации файла промпта ИИ.
-   */
-  make(): void {
-    console.log('Generating AI prompt...')
-
-    const list = this.getList()
-    const prompts = [
-      `
-# System Role: AI Coding Assistant & Project Analyzer
-Consolidated documentation, architectural guidelines, and mandatory rules for the project.
-      `.trim(),
-      this.getGlobalPrompt(),
-      this.getVuePrompt()
-    ]
-    const mcpData: Record<string, any>[] = []
-
-    if (list.length > 0) {
-      list.forEach((item) => {
-        const prompt = item.make()
-
-        if (prompt) {
-          prompts.push(prompt)
-        }
-
-        if (this.isMcp) {
-          const mcp = item.getMcp()
-
-          if (mcp) {
-            mcpData.push(...mcp)
-          }
-        }
-      })
-    }
-
-    const instruction = this.getInstruction()
-
-    if (instruction) {
-      prompts.push(instruction)
-    }
-
-    prompts.push(this.getAuditPrompt())
-
-    this.write(prompts)
-
-    if (this.isMcp) {
-      this.writeMcp(mcpData)
-    }
-
-    console.log('end')
-  }
-
-  /**
-   * Checks if there are any files in the provided list.
-   *
-   * Проверяет, есть ли файлы в предоставленном списке.
-   * @param dirs list of file/directory names / список имен файлов/директорий
-   * @returns true if any file is found / true, если найден хотя бы один файл
-   * @protected
-   */
-  protected isFileOnDirs(dirs: string[]): boolean {
-    return dirs.some(path => this.exFileOnDirs.test(path))
-  }
-
-  /**
-   * Retrieves the final self-audit prompt for AI code verification.
-   *
-   * Получает итоговый промпт самоаудита для проверки кода ИИ.
-   * @returns formatted audit prompt / отформатированный промпт аудита
-   * @protected
-   */
-  protected getAuditPrompt(): string {
-    return `
-## Mandatory Final Self-Audit (CRITICAL GUARD & STRICT COMPLIANCE)
-
-🔴 **STOP! BEFORE DECLARING WORK COMPLETE OR ENDING YOUR TURN, YOU MUST AUDIT ALL CODE!** 🔴
-
-1. **Mandatory Full Re-Study**: Inspect EVERY single line of code created or modified in this task.
-2. **Rule-by-Rule Compliance Check**: Cross-reference all code changes against ALL architectural conventions, coding standards, JSDoc/TSDoc guidelines, and package rules defined in \`ai-prompt.md\`.
-3. **Zero Ignored Rules**: Ensure NO project rule, typing constraint, or code structure guideline was bypassed, forgotten, or ignored.
-4. **Self-Correction**: If any discrepancy, missing typing, bad JSDoc formatting, or rule violation is found during this audit, fix it IMMEDIATELY before concluding your turn.
-    `.trim()
-  }
-
-  /**
-   * Retrieves high-priority instructions from a specific file.
-   *
-   * Получает высокоприоритетные инструкции из специального файла.
-   * @returns formatted instructions or undefined / отформатированные инструкции или undefined
-   * @protected
-   */
-  protected getInstruction(): string | undefined {
-    if (PropertiesFile.is(UI_FILE_AI_PROMPT_INSTRUCTION)) {
-      return `
-## High-Priority Directives (Overrides Base Rules)
-${PropertiesFile.readFileOnly(UI_FILE_AI_PROMPT_INSTRUCTION)}
-      `.trim()
-    }
-  }
-
-  /**
-   * Retrieves the Vue component implementation prompt.
-   *
-   * Получает промпт по реализации Vue-компонентов.
-   * @returns formatted Vue prompt or undefined / отформатированный промпт Vue или undefined
-   * @protected
-   */
-  protected getVuePrompt(): string {
-    return `
-## Vue Component Implementation Rules
-${vuePromptText}
-    `.trim()
-  }
-
-  /**
-   * Retrieves the global code implementation prompt.
-   *
-   * Получает глобальный промпт по реализации кода.
-   * @returns formatted global prompt or undefined / отформатированный глобальный промпт или undefined
-   * @protected
-   */
-  protected getGlobalPrompt(): string {
-    return `
-## Global Code Implementation Rules
-${globalPromptText}
-    `.trim()
-  }
-
-  /**
-   * Recursively scans directories to collect LibraryAiPromptItem instances.
-   *
-   * Рекурсивно сканирует директории для сбора экземпляров LibraryAiPromptItem.
-   * @param dirs directories to scan / директории для сканирования
-   * @param path current path segments / текущие сегменты пути
-   * @param limit recursion depth limit / лимит глубины рекурсии
-   * @returns list of prompt items / список элементов промпта
-   * @protected
-   */
-  protected getList(
-    dirs: string[] = this.dirs,
-    path: string[] = [],
-    limit = 4
-  ): LibraryAiPromptItem[] {
-    if (limit <= 0) {
-      return []
-    }
-
-    const items: LibraryAiPromptItem[] = []
-
-    for (const dir of dirs) {
-      if (this.exNotRead.test(dir)) {
-        continue
-      }
-
-      const pathDir = [...path, dir]
-      const list = PropertiesFile.readDir(pathDir)
-
-      if (
-        !this.isFileOnDirs(list)
-        || dir === UI_MODULES
-      ) {
-        items.push(...this.getList(
-          list,
-          pathDir,
-          limit - 1
-        ))
-      } else {
-        const promptItem = new LibraryAiPromptItem(pathDir)
-
-        if (promptItem.isPrompt()) {
-          items.push(promptItem)
-        }
-      }
-    }
-
-    return items
-  }
-
-  /**
-   * Writes the collected prompts to a file.
-   *
-   * Записывает собранные промпты в файл.
-   * @param prompts list of prompt strings / список строк промптов
-   * @returns this instance / этот экземпляр
-   * @protected
-   */
-  protected write(prompts: string[]): this {
-    PropertiesFile.writeByPath(
-      UI_FILE_AI_PROMPT_PROMPT,
-      prompts.join(`
-
----
-
-`)
-    )
-
-    return this
-  }
-
-  /**
-   * Writes the collected MCP definitions to a file.
-   *
-   * Записывает собранные определения MCP в файл.
-   * @param mcpData list of MCP resource definitions / список определений ресурсов MCP
-   * @returns this instance / этот экземпляр
-   * @protected
-   */
-  protected writeMcp(mcpData: Record<string, any>[]): this {
-    PropertiesFile.writeByPath(
-      UI_FILE_AI_MCP_ALL,
-      mcpData
-    )
-
-    return this
-  }
-}

package/src/classes/Library/LibraryAiPromptItem.ts

@@ -1,331 +0,0 @@
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { LibraryAiMcpItem } from './LibraryAiMcpItem'
-import { getPackageJson } from '../../functions/getPackageJson'
-
-import {
-  UI_DIR_AI_PROMPT_SCREENSHOT,
-  UI_FILE_AI_PROMPT_DESCRIPTION,
-  UI_FILE_AI_PROMPT_DEVELOPER,
-  UI_FILE_AI_PROMPT_INFO,
-  UI_FILE_AI_PROMPT_TYPES
-} from '../../config'
-
-/**
- * Class representing an item in the AI prompt generation process.
- * Handles reading and aggregating various project-related files (descriptions, info, types, screenshots)
- * to build a context-rich prompt for AI.
- *
- * Класс, представляющий элемент в процессе создания промпта для ИИ.
- * Управляет чтением и агрегацией различных файлов проекта (описания, информация, типы, скриншоты)
- * для создания насыщенного контекстом промпта для ИИ.
- */
-export class LibraryAiPromptItem {
-  /** Item instance for working with MCP files. / Экземпляр элемента для работы с файлами MCP. */
-  protected readonly itemMcp: LibraryAiMcpItem
-
-  /**
-   * Constructor for LibraryAiPromptItem.
-   *
-   * Конструктор для LibraryAiPromptItem.
-   * @param dir Path segments to the directory / Сегменты пути к директории
-   */
-  constructor(
-    protected readonly dir: string[] = []
-  ) {
-    this.itemMcp = new LibraryAiMcpItem(this.dir)
-  }
-
-  /**
-   * Returns directory path segments.
-   *
-   * Возвращает сегменты пути к директории.
-   * @returns path segments / сегменты пути
-   */
-  getDir(): string[] {
-    return this.dir
-  }
-
-  /**
-   * Reads and returns the list of MCP resource definitions from ai-mcp-resources.json.
-   *
-   * Читает и возвращает список определений ресурсов MCP из ai-mcp-resources.json.
-   * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
-   */
-  getMcp(): Record<string, any>[] | undefined {
-    return this.itemMcp.make()
-  }
-
-  /**
-   * Returns the project name from package.json.
-   *
-   * Возвращает название проекта из package.json.
-   * @returns project name or 'none' / название проекта или 'none'
-   */
-  getProjectName(): string {
-    return getPackageJson(this.dir)?.name ?? 'none'
-  }
-
-  /**
-   * Checks if any prompt-related files or directories exist.
-   *
-   * Проверяет, существуют ли какие-либо файлы или директории, связанные с промптами.
-   * @returns true if any prompt content is found / true, если найден какой-либо контент для промпта
-   */
-  isPrompt(): boolean {
-    return this.isDescription()
-      || this.isInfo()
-      || this.isTypes()
-      || this.isScreenshot()
-      || this.isDeveloper()
-      || this.isMcp()
-  }
-
-  /**
-   * Checks if the description file exists.
-   *
-   * Проверяет, существует ли файл описания.
-   * @returns true if description file exists / true, если файл описания существует
-   */
-  isDescription(): boolean {
-    return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_DESCRIPTION))
-  }
-
-  /**
-   * Checks if the developer prompt file exists.
-   *
-   * Проверяет, существует ли файл промпта разработчика.
-   * @returns true if developer prompt file exists / true, если файл промпта разработчика существует
-   */
-  isDeveloper(): boolean {
-    return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_DEVELOPER))
-  }
-
-  /**
-   * Checks if the information file exists.
-   *
-   * Проверяет, существует ли файл с информацией.
-   * @returns true if info file exists / true, если файл информации существует
-   */
-  isInfo(): boolean {
-    return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_INFO))
-  }
-
-  /**
-   * Checks if the ai-mcp-resources.json file exists.
-   *
-   * Проверяет, существует ли файл ai-mcp-resources.json.
-   * @returns true if ai-mcp-resources.json file exists / true, если файл ai-mcp-resources.json существует
-   */
-  isMcp(): boolean {
-    return this.itemMcp.isMcp()
-  }
-
-  /**
-   * Checks if the screenshot directory exists.
-   *
-   * Проверяет, существует ли директория со скриншотами.
-   * @returns true if screenshot directory exists / true, если директория скриншотов существует
-   */
-  isScreenshot(): boolean {
-    return PropertiesFile.is(this.getPath(UI_DIR_AI_PROMPT_SCREENSHOT))
-  }
-
-  /**
-   * Checks if the types file exists.
-   *
-   * Проверяет, существует ли файл с типами.
-   * @returns true if types file exists / true, если файл типов существует
-   */
-  isTypes(): boolean {
-    return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_TYPES))
-  }
-
-  /**
-   * Gathers all available prompt content and formats it as a single string.
-   *
-   * Собирает весь доступный контент промпта и форматирует его в виде одной строки.
-   * @returns formatted prompt content or undefined / отформатированный контент промпта или undefined
-   */
-  make(): string | undefined {
-    console.log(this.getProjectName())
-
-    const data = [
-      this.getDescription(),
-      this.getInfo(),
-      this.getTypes(),
-      this.getScreenshot(),
-      this.getDeveloper()
-    ].filter(item => item !== undefined) as string[]
-
-    if (data.length > 0) {
-      return `
-# ${this.getProjectName()}
-## Project location: Root directory
-The project is located at: '${this.getPathString()}'.
-
-${data.join('\n\n')}
-    `.trim()
-    }
-
-    return undefined
-  }
-
-  /**
-   * Formats and returns the description section for the prompt.
-   *
-   * Форматирует и возвращает секцию описания для промпта.
-   * @returns formatted description or undefined / отформатированное описание или undefined
-   * @protected
-   */
-  protected getDescription(): string | undefined {
-    if (this.isDescription()) {
-      console.log('-- Description')
-
-      return `
-## Package Description & Module Overview
-${this.readFile(UI_FILE_AI_PROMPT_DESCRIPTION)}
-      `.trim()
-    }
-
-    return undefined
-  }
-
-  /**
-   * Formats and returns the developer prompt section.
-   *
-   * Форматирует и возвращает секцию промпта для разработчика.
-   * @returns formatted developer prompt or undefined / отформатированный промпт разработчика или undefined
-   * @protected
-   */
-  protected getDeveloper(): string | undefined {
-    if (this.isDeveloper()) {
-      console.log('-- Developer')
-
-      return `
-## Developer Rules (Must Read Before Modifying Code)
-'${this.getPathString()}/${UI_FILE_AI_PROMPT_DEVELOPER}'
-      `.trim()
-    }
-
-    return undefined
-  }
-
-  /**
-   * Formats and returns the info section for the prompt.
-   *
-   * Форматирует и возвращает секцию информации для промпта.
-   * @returns formatted info or undefined / отформатированная информация или undefined
-   * @protected
-   */
-  protected getInfo(): string | undefined {
-    if (this.isInfo()) {
-      console.log('-- Info')
-
-      return `
-## Package Core Information
-${this.readFile(UI_FILE_AI_PROMPT_INFO)}
-      `.trim()
-    }
-
-    return undefined
-  }
-
-  /**
-   * Constructs a full path for a file within the item's directory.
-   *
-   * Создает полный путь к файлу внутри директории элемента.
-   * @param dirFile File name / Имя файла
-   * @returns path segments / сегменты пути
-   * @protected
-   */
-  protected getPath(dirFile: string): string[] {
-    return [...this.dir, dirFile]
-  }
-
-  /**
-   * Returns the directory path as a string joined by a slash.
-   *
-   * Возвращает путь к директории в виде строки, объединенной слешем.
-   * @returns path string / строка пути
-   * @protected
-   */
-  protected getPathString(): string {
-    return this.dir.join('/')
-  }
-
-  /**
-   * Formats and returns the screenshot section for the prompt.
-   *
-   * Форматирует и возвращает секцию скриншотов для промпта.
-   * @returns formatted screenshot list or undefined / отформатированный список скриншотов или undefined
-   * @protected
-   */
-  protected getScreenshot(): string | undefined {
-    const list = this.getScreenshotList()
-
-    if (list) {
-      console.log('-- Screenshot')
-
-      const screenshot: string = list.map(item => `- '${this.getPathString()}/${UI_DIR_AI_PROMPT_SCREENSHOT}/${item}'`).join('\n')
-
-      return `## Component Visual References (Screenshots)
-${screenshot}
-      `.trim()
-    }
-
-    return undefined
-  }
-
-  /**
-   * Retrieves the list of files in the screenshot directory.
-   *
-   * Получает список файлов в директории скриншотов.
-   * @returns list of screenshot file names or undefined / список имен файлов скриншотов или undefined
-   * @protected
-   */
-  protected getScreenshotList(): string[] | undefined {
-    if (this.isScreenshot()) {
-      return PropertiesFile.readDir(this.getPath(UI_DIR_AI_PROMPT_SCREENSHOT))
-    }
-
-    return undefined
-  }
-
-  /**
-   * Formats and returns the types section for the prompt.
-   *
-   * Форматирует и возвращает секцию типов для промпта.
-   * @returns formatted types reference or undefined / отформатированная ссылка на типы или undefined
-   * @protected
-   */
-  protected getTypes(): string | undefined {
-    if (this.isTypes()) {
-      console.log('-- Types')
-
-      return `
-## Package Type Definitions (Must Read in Full When Working with Package)
-'${this.getPathString()}/${UI_FILE_AI_PROMPT_TYPES}'
-      `.trim()
-    }
-
-    return undefined
-  }
-
-  /**
-   * Reads content of a file by its name relative to the item's directory.
-   *
-   * Читает содержимое файла по его имени относительно директории элемента.
-   * @param dirFile File name / Имя файла
-   * @returns file content / содержимое файла
-   * @protected
-   */
-  protected readFile(dirFile: string): string {
-    const file = PropertiesFile.readFileOnly(this.getPath(dirFile))
-
-    if (file) {
-      return file.replace(/([ '"`]|^)\.\//g, `$1${this.getPathString()}/`)
-    }
-
-    return ''
-  }
-}