@dxtmisha/scripts 0.11.8 → 1.0.0

package/src/classes/Ai/AiAbstract.ts

@@ -1,242 +0,0 @@
-import type { AiImageItem, AiImageList } from '../../types/aiTypes'
-
-/**
- * Abstract AI base class providing common mechanics for AI integrations.
- * Handles prompt accumulation, model selection and unified response workflow.
- *
- * Абстрактный базовый класс AI, обеспечивающий общую механику интеграций:
- * накопление prompt, выбор модели и унифицированный цикл получения ответа.
- *
- * Responsibilities / Ответственности:
- * - Accumulate and compose prompt context / Накопление и компоновка контекста
- * - Select active model / Выбор активной модели
- * - Normalize generation call flow / Нормализация вызова генерации
- *
- * Extension points / Точки расширения:
- * - init(): client / auth / transport setup
- * - response(): concrete model invocation
- *
- * Расширение через методы:
- * - init(): инициализация клиента / авторизация / транспорт
- * - response(): конкретный вызов модели
- */
-export abstract class AiAbstract<AI = any> {
-  /** AI client instance / Экземпляр AI-клиента */
-  protected ai?: AI
-
-  /** Prompt prefix / Префикс prompt */
-  protected prompt: string = ''
-
-  /** Accumulated image list / Накопленный список изображений */
-  protected images: AiImageList = []
-
-  /** Accumulated contents / Накопленные содержимое */
-  protected contents: string[] = []
-
-  /**
-   * Constructor initializes implementation specific resources.
-   *
-   * Конструктор инициализирует ресурсы конкретной реализации.
-   * @param key - API key / API ключ
-   * @param model - initial model id / начальный идентификатор модели
-   * @param config - configuration object / объект конфигурации
-   */
-  constructor(
-    protected key: string,
-    protected model: string,
-    protected config: Record<string, any> = {}
-  ) {
-  }
-
-  /**
-   * Returns accumulated image list.
-   *
-   * Возвращает накопленный список изображений.
-   */
-  getImages(): AiImageList {
-    return this.images
-  }
-
-  /**
-   * Returns accumulated contents.
-   *
-   * Возвращает накопленное содержимое.
-   */
-  getContents(): string[] {
-    return this.contents
-  }
-
-  /**
-   * Appends an image to the accumulated image list.
-   *
-   * Добавляет изображение к накопленному списку изображений.
-   * @param image - image item / элемент изображения
-   */
-  addImage(image: AiImageItem): this {
-    this.images.push(image)
-    return this
-  }
-
-  /**
-   * Appends content to the accumulated contents.
-   *
-   * Добавляет содержимое к накопленному содержимому.
-   * @param content - content string / строка содержимого
-   */
-  addContent(content: string): this {
-    this.contents.push(content)
-    return this
-  }
-
-  /**
-   * Appends a new line to the accumulated prompt block.
-   *
-   * Добавляет новую строку к накопленному блоку prompt.
-   */
-  addPrompt(prompt: string): void {
-    this.prompt += `\n${prompt}`
-  }
-
-  /**
-   * Clears entire accumulated image list.
-   *
-   * Очищает весь накопленный список изображений.
-   */
-  resetImages(): this {
-    this.images = []
-    return this
-  }
-
-  /**
-   * Clears entire accumulated contents.
-   *
-   * Очищает все накопленное содержимое.
-   */
-  resetContents(): this {
-    this.contents = []
-    return this
-  }
-
-  /**
-   * Clears entire accumulated prompt.
-   *
-   * Полностью очищает накопленный prompt.
-   */
-  resetPrompt(): void {
-    this.prompt = ''
-  }
-
-  /**
-   * Sets / switches API key for authentication.
-   *
-   * Устанавливает / переключает API ключ для аутентификации.
-   * @param key - new API key / новый API ключ
-   */
-  setKey(key: string): this {
-    this.key = key
-
-    if (this.ai) {
-      this.init()
-    }
-
-    return this
-  }
-
-  /**
-   * Sets / switches current model for generation.
-   *
-   * Устанавливает / переключает текущую модель для генерации.
-   */
-  setModel(model: string): this {
-    this.model = model
-    return this
-  }
-
-  /**
-   * Sets / switches configuration object.
-   *
-   * Устанавливает / переключает объект конфигурации.
-   * @param config - configuration object / объект конфигурации
-   */
-  setConfig(config: Record<string, any>): this {
-    this.config = config
-    return this
-  }
-
-  /**
-   * Generates AI response using active model and composed contents.
-   *
-   * Генерирует отклик ИИ, используя активную модель и собранный контент.
-   */
-  async generate(contents: string): Promise<string> {
-    if (!this.ai) {
-      this.init()
-
-      console.log(
-        `[Ai] Initialized AI client with model: ${this.model}`
-      )
-    }
-
-    if (this.ai) {
-      console.log('[Ai] Generating')
-
-      try {
-        const generate = await this.response(
-          this.model,
-          this.getMainContents(contents)
-        )
-
-        console.log(`[Ai] End (length: ${generate.length})`)
-
-        return generate
-      } catch (error) {
-        console.error('[Ai] Generation error:', error)
-        process.exit(603)
-      }
-    }
-
-    return ''
-  }
-
-  /**
-   * Combines persistent prompt prefix with provided contents.
-   *
-   * Объединяет постоянный префикс prompt с переданным содержимым.
-   */
-  protected getMainContents(contents: string): string {
-    return `${this.prompt}\n${contents}`
-  }
-
-  /**
-   * Implementation hook: initialize client / transport / auth.
-   *
-   * Хук реализации: инициализация клиента / транспорта / авторизации.
-   */
-  protected abstract init(): void
-
-  /**
-   * Implementation hook: convert accumulated images to model-specific format.
-   *
-   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
-   */
-  protected abstract toImages(): void
-
-  /**
-   * Implementation hook: convert accumulated contents to model-specific format.
-   *
-   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
-   */
-  protected abstract toContents(): void
-
-  /**
-   * Implementation hook: perform model call and return textual result.
-   *
-   * Хук реализации: выполнить вызов модели и вернуть текстовый результат.
-   * @param model - active model id / идентификатор активной модели
-   * @param contents - composed prompt + contents / собранный prompt + содержимое
-   */
-  protected abstract response(
-    model: string,
-    contents: string
-  ): Promise<string>
-}

package/src/classes/Ai/AiClaude.ts

@@ -1,26 +0,0 @@
-import { getConfigAi } from '../../functions/getConfigAi'
-import { AiClaudeLite } from './AiClaudeLite'
-
-/**
- * Claude AI implementation of AiAbstract.
- * Initializes Anthropic client and performs text generation requests.
- *
- * Реализация Claude AI поверх AiAbstract.
- * Инициализирует клиент Anthropic и выполняет запросы генерации текста.
- *
- * Responsibilities / Ответственности:
- * - Provide API key / Предоставить API ключ
- * - Initialize low-level client / Инициализировать низкоуровневый клиент
- * - Call messages.create and extract plain text / Вызвать messages.create и извлечь текст
- *
- * Notes / Примечания:
- * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
- * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
- */
-export class AiClaude extends AiClaudeLite {
-  constructor() {
-    super(
-      ...getConfigAi()
-    )
-  }
-}

package/src/classes/Ai/AiClaudeAgent.ts

@@ -1,16 +0,0 @@
-import { getConfigAi } from '../../functions/getConfigAi'
-import { AiClaudeAgentLite } from './AiClaudeAgentLite'
-
-/**
- * Claude AI implementation via Agent SDK.
- * Uses @anthropic-ai/claude-agent-sdk to interact with Claude as an agent.
- *
- * Реализация Claude AI через Agent SDK.
- */
-export class AiClaudeAgent extends AiClaudeAgentLite {
-  constructor() {
-    super(
-      ...getConfigAi()
-    )
-  }
-}

package/src/classes/Ai/AiClaudeAgentLite.ts

@@ -1,86 +0,0 @@
-import { query } from '@anthropic-ai/claude-agent-sdk'
-import { AiAbstract } from './AiAbstract'
-
-/**
- * Claude AI implementation via Agent SDK.
- * Uses @anthropic-ai/claude-agent-sdk to interact with Claude as an agent.
- *
- * Реализация Claude AI через Agent SDK.
- * Использует @anthropic-ai/claude-agent-sdk для взаимодействия с Claude в режиме агента.
- *
- * Responsibilities / Ответственности:
- * - Initialize Agent SDK client / Инициализировать Agent SDK клиент
- * - Execute query via Agent SDK / Выполнить запрос через Agent SDK
- * - Extract and return textual result / Извлечь и вернуть текстовый результат
- */
-export class AiClaudeAgentLite extends AiAbstract<{}> {
-  /**
-   * Initializes the "client".
-   * For Agent SDK, we mark it as initialized.
-   */
-  protected init(): void {
-    this.ai = {}
-  }
-
-  /**
-   * Implementation hook: convert accumulated images to model-specific format.
-   * Agent SDK implementation logic for images can be added if supported by the SDK.
-   */
-  protected toImages(): any {
-    return []
-  }
-
-  /**
-   * Implementation hook: convert accumulated contents to model-specific format.
-   */
-  protected toContents(): any {
-    return this.contents.join('\n\n')
-  }
-
-  /**
-   * Performs content generation request via Agent SDK and returns textual result.
-   *
-   * @param model Model identifier / Идентификатор модели
-   * @param contents Composed contents for generation / Собранный контент для генерации
-   */
-  protected async response(
-    model: string,
-    contents: string
-  ): Promise<string> {
-    const fullPrompt = [
-      this.toContents(),
-      contents
-    ].filter(Boolean).join('\n\n')
-
-    try {
-      const q = query({
-        prompt: fullPrompt,
-        options: {
-          model: model || undefined,
-          env: {
-            ...process.env,
-            ANTHROPIC_API_KEY: this.key
-          },
-          permissionMode: 'acceptEdits', // Auto-accept file changes if any
-          allowDangerouslySkipPermissions: true,
-          ...this.config
-        }
-      })
-
-      let lastResult = ''
-
-      for await (const message of q) {
-        if (message.type === 'result') {
-          if (message.subtype === 'success') {
-            lastResult = message.result
-          }
-        }
-      }
-
-      return lastResult.trim()
-    } catch (error) {
-      console.error('[AiClaudeAgent] Error:', error)
-      return ''
-    }
-  }
-}

package/src/classes/Ai/AiClaudeCli.ts

@@ -1,24 +0,0 @@
-import { getConfigAi } from '../../functions/getConfigAi'
-import { AiClaudeCliLite } from './AiClaudeCliLite'
-
-/**
- * Claude AI implementation via CLI.
- * Extends AiClaudeCliLite and provides configuration from the project environment.
- *
- * Реализация Claude AI через CLI.
- * Расширяет AiClaudeCliLite и предоставляет конфигурацию из окружения проекта.
- *
- * Responsibilities / Ответственности:
- * - Provide API key and model from config / Предоставить API ключ и модель из конфигурации
- * - Initialize CLI wrapper / Инициализировать обертку CLI
- *
- * Notes / Примечания:
- * - Uses getConfigAi() to retrieve credentials / Использует getConfigAi() для получения учетных данных
- */
-export class AiClaudeCli extends AiClaudeCliLite {
-  constructor() {
-    super(
-      ...getConfigAi()
-    )
-  }
-}

package/src/classes/Ai/AiClaudeCliLite.ts

@@ -1,108 +0,0 @@
-import { forEach } from '@dxtmisha/functional-basic'
-import { exec } from 'node:child_process'
-
-import { AiAbstract } from './AiAbstract'
-import { ApiTmp } from './ApiTmp'
-
-/**
- * Claude AI implementation via CLI.
- * Uses system shell to execute Claude CLI commands.
- *
- * Реализация Claude AI через CLI.
- * Использует системную оболочку для выполнения команд Claude CLI.
- *
- * Responsibilities / Ответственности:
- * - Construct CLI command / Сформировать CLI команду
- * - Execute command via shell / Выполнить команду через оболочку
- * - Return stdout as result / Вернуть stdout как результат
- *
- * Notes / Примечания:
- * - Requires 'claude' CLI tool installed / Требует установленной утилиты 'claude'
- * - API key is passed via environment variable or config / API ключ передается через переменную окружения или конфиг
- */
-export class AiClaudeCliLite extends AiAbstract<{}> {
-  protected readonly tmp = new ApiTmp()
-
-  /**
-   * Initializes the "client".
-   * For CLI, we just mark it as initialized.
-   *
-   * Инициализирует "клиента".
-   * Для CLI мы просто помечаем его как инициализированный.
-   */
-  protected init(): void {
-    this.ai = {}
-  }
-
-  /**
-   * Implementation hook: convert accumulated images to model-specific format.
-   * CLI implementation currently ignores images.
-   *
-   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
-   * Реализация CLI в настоящее время игнорирует изображения.
-   */
-  protected toImages(): any {
-    return []
-  }
-
-  /**
-   * Implementation hook: convert accumulated contents to model-specific format.
-   * Returns array of strings.
-   *
-   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
-   * Возвращает массив строк.
-   */
-  protected toContents(): any {
-    return forEach(
-      this.contents,
-      content => this.tmp.createFile(content)
-    )
-  }
-
-  /**
-   * Performs content generation request via CLI and returns textual result.
-   *
-   * Выполняет запрос генерации контента через CLI и возвращает текстовый результат.
-   * @param model Model identifier / Идентификатор модели
-   * @param contents Composed contents for generation / Собранный контент для генерации
-   */
-  protected async response(
-    model: string,
-    contents: string
-  ): Promise<string> {
-    return new Promise((resolve) => {
-      const fullPrompt = [
-        ...this.toContents(),
-        this.tmp.createFile(contents)
-      ].join('\n\n##################\n\n')
-
-      const escapedPrompt = fullPrompt.replace(/"/g, '\\"')
-      const modelFlag = model ? ` --model "${model}"` : ''
-      const command = `claude "${escapedPrompt} -- Output strictly the code/answer. No preamble, no chatter, no reasoning" ${modelFlag}`
-
-      try {
-        exec(
-          command,
-          {
-            encoding: 'utf8',
-            env: {
-              ...process.env
-            }
-          },
-          (error, stdout, stderr) => {
-            if (error) {
-              console.error('Error executing Claude CLI:', stderr || error.message)
-              resolve('')
-            } else {
-              resolve(stdout.trim())
-            }
-
-            this.tmp.removeFile()
-          }
-        )
-      } catch (_) {
-        this.tmp.removeFile()
-      }
-    })
-  }
-}

package/src/classes/Ai/AiClaudeLite.ts

@@ -1,112 +0,0 @@
-import { Anthropic } from '@anthropic-ai/sdk'
-import { forEach } from '@dxtmisha/functional-basic'
-
-import { AiAbstract } from './AiAbstract'
-
-/**
- * Claude AI implementation of AiAbstract.
- * Initializes Anthropic client and performs text generation requests.
- *
- * Реализация Claude AI поверх AiAbstract.
- * Инициализирует клиент Anthropic и выполняет запросы генерации текста.
- *
- * Responsibilities / Ответственности:
- * - Provide API key / Предоставить API ключ
- * - Initialize Anthropic client / Инициализировать клиент Anthropic
- * - Call messages.create and extract text content / Вызвать messages.create и извлечь текст
- *
- * Notes / Примечания:
- * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
- * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
- */
-export class AiClaudeLite extends AiAbstract<Anthropic> {
-  /**
-   * Initializes Anthropic client instance.
-   *
-   * Инициализирует экземпляр клиента Anthropic.
-   */
-  protected init(): void {
-    this.ai = new Anthropic({
-      apiKey: this.key
-    })
-  }
-
-  /**
-   * Implementation hook: convert accumulated images to model-specific format.
-   * Claude expects images as content blocks with type 'image'.
-   *
-   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
-   * Claude ожидает изображения как блоки контента с типом 'image'.
-   */
-  protected toImages(): any {
-    return forEach(this.images, image => ({
-      type: 'image',
-      source: {
-        type: 'base64',
-        media_type: image.mime,
-        data: image.base64
-      }
-    }))
-  }
-
-  /**
-   * Implementation hook: convert accumulated contents to model-specific format.
-   * Claude expects text as content blocks with type 'text'.
-   *
-   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
-   * Claude ожидает текст как блоки контента с типом 'text'.
-   */
-  protected toContents(): any {
-    return forEach(this.contents, content => ({
-      type: 'text',
-      text: content
-    }))
-  }
-
-  /**
-   * Performs content generation request and returns textual result.
-   *
-   * Выполняет запрос генерации контента и возвращает текстовый результат.
-   * @param model Model identifier (e.g., 'claude-3-5-sonnet-20241022') / Идентификатор модели
-   * @param contents Composed contents for generation / Собранный контент для генерации
-   */
-  protected async response(
-    model: string,
-    contents: string
-  ): Promise<string> {
-    const message = await this.ai?.messages.create({
-      model,
-      max_tokens: this.config.maxTokens ?? 4096,
-      messages: [
-        {
-          role: 'user',
-          content: [
-            ...this.toImages(),
-            ...this.toContents(),
-            { type: 'text', text: contents }
-          ]
-        }
-      ],
-      ...this.config
-    })
-
-    if (message?.content) {
-      return forEach(
-        message.content,
-        (block) => {
-          if (
-            block.type === 'text'
-            && 'text' in block
-          ) {
-            return block.text
-          }
-
-          return undefined
-        }
-      )
-        .join('\n')
-    }
-
-    return ''
-  }
-}

package/src/classes/Ai/AiDoc.ts

@@ -1,81 +0,0 @@
-import { ServerStorage } from '@dxtmisha/functional-basic'
-
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-import { GitRead } from '../Git/GitRead'
-import { AiDocType } from './AiDocType'
-
-/**
- * Class for generating AI documentation.
- * It manages the process of reading directories, fetching files, and
- * delegating the documentation generation to specific processors.
- *
- * Класс для генерации AI-документации.
- * Управляет процессом чтения директорий, получения файлов и делегирования
- * генерации документации специализированным процессорам.
- */
-export class AiDoc {
-  /**
-   * Constructor for AiDoc. Sets error status config for ServerStorage.
-   *
-   * Конструктор для AiDoc. Устанавливает конфигурацию статуса ошибок для ServerStorage.
-   */
-  constructor() {
-    ServerStorage.setErrorStatus(true)
-  }
-
-  /**
-   * Main method to generate documentation for configured directories.
-   *
-   * Основной метод для генерации документации по настроенным директориям.
-   * @returns promise that resolves when generation is complete / промис, завершающийся по окончании генерации
-   */
-  async make() {
-    const dirs = PropertiesConfig.getAiDocDirectory()
-    const path = PropertiesConfig.getAiDocStorybookPath()
-
-    console.log(`AI documentation: ${path}`)
-
-    if (
-      dirs
-      && dirs.length
-    ) {
-      for (const dir of dirs) {
-        await this.makeDirectory(dir)
-      }
-    }
-  }
-
-  /**
-   * Process a specific directory, generating documentation for its files.
-   *
-   * Обрабатывает конкретную директорию, генерируя документацию для её файлов.
-   * @param dir directory path / путь к директории
-   * @returns promise that resolves when processing is complete / промис, завершающийся по окончании обработки
-   */
-  async makeDirectory(dir: string) {
-    console.log('')
-    console.log(`Dir: ${dir}...`)
-
-    for (const item of this.getListByDirectory(dir)) {
-      try {
-        await AiDocType.make(item)
-      } catch (e) {
-        console.error(`Error processing file ${item}:`, e)
-        process.exit(602)
-      }
-    }
-  }
-
-  /**
-   * Get filtered list of files in a directory via Git tracker.
-   *
-   * Получает отфильтрованный список файлов в директории через Git трекер.
-   * @param dir directory path / путь к директории
-   * @returns list of file paths / список путей к файлам
-   */
-  protected getListByDirectory(dir: string) {
-    return GitRead.filterByDirectory(
-      GitRead.getListByDirectory(dir)
-    )
-  }
-}