@dxtmisha/scripts 0.10.13 → 0.10.15

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.10.15] - 2026-08-10
+
+### Added
+- **AI Prompt Self-Audit Directive**: Added `getAuditPrompt` method in `LibraryAiPrompt` to append a strict, mandatory self-audit directive (`## Mandatory Final Self-Audit (CRITICAL GUARD & STRICT COMPLIANCE)`) at the end of generated AI prompt files (`ai-prompt.md`), instructing AI models to re-study and audit all generated code against project rules before concluding work.
+
 ## [0.10.13] - 2026-08-06
 
 ### Changed

package/bin/design-types.ts

@@ -2,8 +2,10 @@
 
 import { DesignTypes } from '../src/classes/Design/DesignTypes'
 
-const dir: string = process.argv?.[2] ?? 'dist'
+const isRaw: boolean = process.argv?.[2] === 'raw' || process.argv?.[2] === '1' || process.argv?.[2] === 'true'
+const dir: string = process.argv?.[3]
+const resourcesDir: string = process.argv?.[4]
 
-new DesignTypes(dir)
+new DesignTypes(dir, resourcesDir, isRaw)
   .make()
   .then()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.10.13",
+  "version": "0.10.15",
   "type": "module",
   "description": "CLI tools, AI integration scripts, and automation utilities for DXT UI — automated component scaffolding, Figma layout generation, library packaging, documentation building, screenshot captures, and AI prompt processing.",
   "keywords": [
@@ -14,7 +14,7 @@
     "component-generator",
     "figma-sync",
     "ai-tools",
-    "ai-prompts",
+    "ai-resources",
     "storybook",
     "documentation",
     "typescript",

package/src/classes/Ai/AiClaudeCliLite.ts

@@ -106,4 +106,3 @@ export class AiClaudeCliLite extends AiAbstract<{}> {
     })
   }
 }
-

package/src/classes/Design/DesignFigma.ts

@@ -1,9 +1,25 @@
 import { FigmaApi } from '../FigmaApi'
 import { PropertiesConfig } from '../Properties/PropertiesConfig.ts'
 
+/**
+ * Class for downloading and processing design assets from Figma API.
+ * Serves as an abstraction for initializing SVG graphics and frame exports from specified Figma files.
+ *
+ * Класс для скачивания и обработки дизайн-ассетов из Figma API.
+ * Служит абстракцией для инициализации SVG-графики и экспорта кадров из указанных файлов Figma.
+ */
 export class DesignFigma {
+  /** Figma REST API client instance / Экземпляр клиента REST API Figma */
   protected readonly api: FigmaApi
 
+  /**
+   * Creates an instance of DesignFigma.
+   *
+   * Создает экземпляр DesignFigma.
+   * @param fileKey unique Figma file identifier / уникальный идентификатор файла Figma
+   * @param nodeId target node or frame identifier in Figma file / идентификатор целевого узла или кадра в файле Figma
+   * @param token Figma API access token / токен доступа к API Figma
+   */
   constructor(
     protected readonly fileKey: string,
     protected readonly nodeId?: string,
@@ -12,10 +28,21 @@ export class DesignFigma {
     this.api = new FigmaApi(token, fileKey, nodeId)
   }
 
+  /**
+   * Executes the main workflow for retrieving and logging Figma design image assets.
+   *
+   * Выполняет основной процесс получения и логирования графических ассетов дизайна Figma.
+   */
   async make(): Promise<void> {
     console.log('Design Figma', await this.initImage())
   }
 
+  /**
+   * Requests SVG image export URLs for the specified node from Figma API.
+   *
+   * Запрашивает URL-адреса экспорта SVG-изображений для указанного узла через API Figma.
+   * @returns map of node IDs to SVG image URLs, or undefined on error / карта ID узлов к URL SVG-изображений или undefined в случае ошибки
+   */
   async initImage(): Promise<Record<string, string> | undefined> {
     const image = await this.api.fileImages({
       ids: this.nodeId as string,

package/src/classes/Design/DesignTypes.ts

@@ -29,10 +29,12 @@ export class DesignTypes {
    * Конструктор для DesignTypes.
    * @param dir input directory path containing declaration files / входной путь к директории, содержащей файлы деклараций
    * @param promptsDir input directory path containing prompt files / входной путь к директории, содержащей файлы промптов
+   * @param isRaw flag disabling AI processing to create raw types and empty description / флаг отключения ИИ обработки для создания сырых типов и пустого описания
    */
   constructor(
     protected readonly dir: string = 'dist',
-    protected readonly promptsDir: string = 'ai-prompts'
+    protected readonly promptsDir: string = 'ai-resources',
+    protected readonly isRaw: boolean = false
   ) {
     ServerStorage.setErrorStatus(true)
     this.dirArray = this.dir.split('/')
@@ -49,38 +51,43 @@ export class DesignTypes {
     const files = this.getListByFilter()
     const jsFiles = this.getListByFilterJs()
 
-    const fullContent = this.toOneFile(files)
+    const fullContent = this.cleanContent(this.toOneFile(files))
     const fullJsContent = this.toOneFile(jsFiles)
 
-    const aiContent = await this.toAiEdit(fullContent, fullJsContent)
+    const aiContent = this.isRaw
+      ? fullContent
+      : await this.toAiEdit(fullContent, fullJsContent)
+    let fullDescription = ''
+    let mcpPrompts: DesignMcpResources | undefined
+
     this.save(aiContent)
 
-    const aiDescription = await this.toAiDescription(fullContent, fullJsContent)
+    if (!this.isRaw) {
+      const aiDescription = await this.toAiDescription(fullContent, fullJsContent)
 
-    const promptList = this.getListPrompts()
-    const prompts = await this.toAiPrompts(promptList)
+      const promptList = this.getListPrompts()
+      const prompts = await this.toAiPrompts(promptList)
 
-    const fullDescription = `${aiDescription}\n${prompts}`
-    this.saveDescription(fullDescription)
+      fullDescription = `${aiDescription}\n${prompts}`
+
+      const mcpList: DesignTypesList = [
+        {
+          path: UI_FILE_AI_TYPES,
+          content: aiContent
+        },
+        {
+          path: UI_FILE_AI_DESCRIPTION,
+          content: fullDescription
+        },
+        ...promptList
+      ]
 
-    const mcpList: DesignTypesList = [
-      {
-        path: UI_FILE_AI_TYPES,
-        content: aiContent
-      },
-      {
-        path: UI_FILE_AI_DESCRIPTION,
-        content: fullDescription
-      },
-      ...promptList
-    ]
-
-    const mcpPrompts = await this.toAiMcpPrompts(mcpList)
-
-    if (mcpPrompts) {
-      this.saveMcp(mcpPrompts)
+      mcpPrompts = await this.toAiMcpPrompts(mcpList)
     }
 
+    this.saveDescription(fullDescription)
+    this.saveMcp(mcpPrompts ?? [])
+
     console.log('DesignTypes: AI types saved.')
   }
 
@@ -243,10 +250,11 @@ export class DesignTypes {
     const packageJson = getPackageJson()
 
     if (packageJson) {
+      const versionStr = packageJson.version ? ` (v${packageJson.version})` : ''
       PropertiesFile.writeByPath(
         UI_FILE_AI_TYPES,
         [
-          `All these methods are in the ${packageJson.name} library.`,
+          `All these methods are in the ${packageJson.name}${versionStr} library.`,
           '',
           content
         ].join('\n')
@@ -307,6 +315,10 @@ export class DesignTypes {
     prompt: string,
     code?: string
   ): Promise<string | undefined> {
+    if (this.isRaw) {
+      return undefined
+    }
+
     const ai = useAi()
 
     if (ai) {
@@ -329,6 +341,28 @@ export class DesignTypes {
     return undefined
   }
 
+  /**
+   * Cleans up the content by removing imports, local exports, and empty lines.
+   *
+   * Очищает контент, удаляя импорты, локальные экспорты и пустые строки.
+   * @param content content to clean / контент для очистки
+   */
+  protected cleanContent(content: string): string {
+    return content
+      // Remove multi-line and single-line imports (only local files)
+      .replace(/^import\s+(?:{[^}]+}|[^{]+)\s+from\s+['"]\.[^'"]+['"];?/gm, '')
+      .replace(/^import\s+['"]\.[^'"]+['"];?/gm, '')
+      // Remove local internal re-exports (e.g., export * from "./...")
+      .replace(/^export\s+(?:\*|{[^}]+})\s+from\s+['"]\.[^'"]+['"];?/gm, '')
+      // Remove single-line private and protected properties
+      .replace(/^\s*(?:private|protected)\s+[^({]+;/gm, '')
+      // Remove lines that only contain inline comments
+      .replace(/^\s*\/\/.*$/gm, '')
+      // Remove empty lines
+      .replace(/^\s*[\r\n]/gm, '')
+      .trim()
+  }
+
   /**
    * Sends content to AI for optimization.
    *

package/src/classes/Design/DesignWikiStorm.ts

@@ -43,12 +43,12 @@ export class DesignWikiStorm {
 
     if (packageFile) {
       const data: WebTypesVueJson = {
-        $schema: 'https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json',
-        framework: 'vue',
-        name: toCamelCaseFirst(PropertiesConfig.getDesignName()),
-        version: packageFile.version,
+        '$schema': 'https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json',
+        'framework': 'vue',
+        'name': toCamelCaseFirst(PropertiesConfig.getDesignName()),
+        'version': packageFile.version,
         'js-types-syntax': 'typescript',
-        contributions: {
+        'contributions': {
           html: {
             'description-markup': 'markdown',
             'vue-components': await this.getComponents()

package/src/classes/Design/DesignWikiStormItem.ts

@@ -127,7 +127,7 @@ export class DesignWikiStormItem {
       const slots: WebTypesSlots = []
 
       data.slots.forEach(
-        slot => {
+        (slot) => {
           const vueProperties: WebTypesProperty[] = (slot.properties ?? []).map(p => ({
             name: p.name,
             type: p.type ? this.cleanType(p.type) : undefined,
@@ -160,7 +160,7 @@ export class DesignWikiStormItem {
       const events: WebTypesEventItem[] = []
 
       data.events.forEach(
-        event => {
+        (event) => {
           let typeString = '() => void'
           if (event.properties && event.properties.length > 0) {
             const args = event.properties

package/src/classes/Library/LibraryAiMcpItem.ts

@@ -6,10 +6,10 @@ import {
 
 /**
  * Class representing an MCP item in the AI prompt generation process.
- * Handles reading `ai-mcp.json` configuration files for a package directory.
+ * Handles reading `ai-mcp-resources.json` configuration files for a package directory.
  *
  * Класс, представляющий элемент MCP в процессе создания промпта для ИИ.
- * Управляет чтением конфигурационных файлов `ai-mcp.json` для директории пакета.
+ * Управляет чтением конфигурационных файлов `ai-mcp-resources.json` для директории пакета.
  */
 export class LibraryAiMcpItem {
   /**
@@ -23,19 +23,19 @@ export class LibraryAiMcpItem {
   ) { }
 
   /**
-   * Checks if the ai-mcp.json file exists in the directory.
+   * Checks if the ai-mcp-resources.json file exists in the directory.
    *
-   * Проверяет, существует ли файл ai-mcp.json в директории.
-   * @returns true if ai-mcp.json file exists / true, если файл ai-mcp.json существует
+   * Проверяет, существует ли файл ai-mcp-resources.json в директории.
+   * @returns true if ai-mcp-resources.json file exists / true, если файл ai-mcp-resources.json существует
    */
   isMcp(): boolean {
     return PropertiesFile.is(this.getPath(UI_FILE_AI_MCP))
   }
 
   /**
-   * Reads and returns the list of MCP resource definitions from ai-mcp.json.
+   * Reads and returns the list of MCP resource definitions from ai-mcp-resources.json.
    *
-   * Читает и возвращает список определений ресурсов MCP из ai-mcp.json.
+   * Читает и возвращает список определений ресурсов MCP из ai-mcp-resources.json.
    * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
    */
   make(): Record<string, any>[] | undefined {

package/src/classes/Library/LibraryAiPrompt.ts

@@ -1,5 +1,5 @@
 import {
-  UI_FILE_AI_MCP,
+  UI_FILE_AI_MCP_ALL,
   UI_FILE_AI_PROMPT_INSTRUCTION,
   UI_FILE_AI_PROMPT_PROMPT,
   UI_MODULES
@@ -97,6 +97,8 @@ Consolidated documentation, architectural guidelines, and mandatory rules for th
       prompts.push(instruction)
     }
 
+    prompts.push(this.getAuditPrompt())
+
     this.write(prompts)
 
     if (this.isMcp) {
@@ -118,6 +120,26 @@ Consolidated documentation, architectural guidelines, and mandatory rules for th
     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.
    *
@@ -243,7 +265,7 @@ ${globalPromptText}
    */
   protected writeMcp(mcpData: Record<string, any>[]): this {
     PropertiesFile.writeByPath(
-      UI_FILE_AI_MCP,
+      UI_FILE_AI_MCP_ALL,
       mcpData
     )
 

package/src/classes/Library/LibraryAiPromptItem.ts

@@ -46,9 +46,9 @@ export class LibraryAiPromptItem {
   }
 
   /**
-   * Reads and returns the list of MCP resource definitions from ai-mcp.json.
+   * Reads and returns the list of MCP resource definitions from ai-mcp-resources.json.
    *
-   * Читает и возвращает список определений ресурсов MCP из ai-mcp.json.
+   * Читает и возвращает список определений ресурсов MCP из ai-mcp-resources.json.
    * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
    */
   getMcp(): Record<string, any>[] | undefined {
@@ -111,10 +111,10 @@ export class LibraryAiPromptItem {
   }
 
   /**
-   * Checks if the ai-mcp.json file exists.
+   * Checks if the ai-mcp-resources.json file exists.
    *
-   * Проверяет, существует ли файл ai-mcp.json.
-   * @returns true if ai-mcp.json file exists / true, если файл ai-mcp.json существует
+   * Проверяет, существует ли файл ai-mcp-resources.json.
+   * @returns true if ai-mcp-resources.json file exists / true, если файл ai-mcp-resources.json существует
    */
   isMcp(): boolean {
     return this.itemMcp.isMcp()

package/src/config.ts

@@ -121,7 +121,9 @@ export const UI_FILE_AI_TYPES = 'ai-types.md'
 /** AI description file name / Название файла с описанием AI */
 export const UI_FILE_AI_DESCRIPTION = 'ai-description.md'
 /** AI MCP resources file name / Название файла с ресурсами MCP AI */
-export const UI_FILE_AI_MCP = 'ai-mcp.json'
+export const UI_FILE_AI_MCP = 'ai-mcp-resources.json'
+/** AI MCP all resources file name / Название файла со всеми ресурсами MCP AI */
+export const UI_FILE_AI_MCP_ALL = 'ai-mcp-all-resources.json'
 /** Style SCSS file name / Название файла стилей SCSS */
 export const UI_FILE_STYLE_SCSS = 'style.scss'
 /** UI properties SCSS file name / Название файла свойств UI в SCSS */

package/src/media/templates/packages/library/package.json

@@ -17,12 +17,12 @@
     "publish-to-npm": "npm publish --access public"
   },
   "files": [
-    "ai-prompts/",
+    "ai-resources/",
     "ai-screenshot/",
     "dist",
     "ai-description.md",
     "ai-doc.md",
-    "ai-mcp.json",
+    "ai-mcp-resources.json",
     "ai-types.md",
     "CHANGELOG.md",
     "LICENSE",

package/src/media/templates/prompts/aiCodeGlobalPrompt.en.md

@@ -17,5 +17,5 @@ Strictly follow these rules for flawless dxt-ui code:
 7. **Security & Performance**: Error-proof code (`?.`, `??`, guard clauses). Use explicit `try-catch` for async. Never swallow errors. Avoid heavy ops in loops/reactivity.
 8. **Aesthetics & Conciseness**: Group logically. Save tokens by avoiding redundant comments if code is self-explanatory.
 9. **Strict Adherence & Optimization**: Follow instructions precisely without guessing. Propose relevant technical optimizations while strictly adhering to plans.
-10. **AI Workspace Memory (`ai-memory.md`)**: Actively APPLY its rules (highest priority). Update local `ai-memory.md` **ONLY** upon explicit developer command (e.g., "remember", "save to memory") or for critical architectural rules/fixes. Do NOT add routine edits indiscriminately, change logs, or absolute paths (use relative only). Keep it focused strictly on critical architectural constraints and explicit developer instructions.
+10. **AI Workspace Memory (`ai-memory.md`)**: Actively APPLY its rules (highest priority). Update local `ai-memory.md` **ONLY** upon explicit developer command (e.g., "remember", "save to memory") or for critical architectural rules/fixes. **STRICTLY FORBIDDEN** to overwrite or delete existing file contents: you MUST **ONLY append** new directives to the end of the file. Do NOT add routine edits indiscriminately, change logs, or absolute paths (use relative only). Keep it focused strictly on critical architectural constraints and explicit developer instructions.
 11. **Mandatory Full-File Self-Audit**: When creating new entities, you MUST audit the ENTIRE file (not just modified parts) to ensure no logic duplication (DRY) and full compliance with project rules. *Exception: minor bug fixes to existing code do not require a full audit.*

package/src/media/templates/prompts/aiCodeGlobalPrompt.ru.md

@@ -17,5 +17,5 @@
 7. **Безопасность и Производительность**: Защищенный код (`?.`, `??`, guard clauses). Явный `try-catch` для асинхронности. Не скрывай ошибки. Избегай тяжелых операций в циклах/реактивности.
 8. **Эстетика и Лаконичность**: Логическая группировка. Экономь токены, избегая избыточных комментариев, если код очевиден.
 9. **Строгое следование инструкциям**: Выполняй команды без додумывания, но предлагай уместные технические оптимизации, придерживаясь плана.
-10. **Память ИИ (`ai-memory.md`)**: Активно ПРИМЕНЯЙ ее правила (высший приоритет). Обновляй локальный `ai-memory.md` **ТОЛЬКО** по явной команде разработчика (напр., «запомни», «сохрани в память») или при критических архитектурных правках/правилах. ЗАПРЕЩЕНО добавлять всё подряд, историю изменений (changelogs) и абсолютные пути (только относительные). Храни только действительно важные архитектурные ограничения и явные указания разработчика.
+10. **Память ИИ (`ai-memory.md`)**: Активно ПРИМЕНЯЙ ее правила (высший приоритет). Обновляй локальный `ai-memory.md` **ТОЛЬКО** по явной команде разработчика (напр., «запомни», «сохрани в память») или при критических архитектурных правках/правилах. **СТРОГО ЗАПРЕЩЕНО** полностью переписывать или удалять содержимое файла: записи разрешено **ТОЛЬКО дополнять** (append) в конец существующего содержимого. ЗАПРЕЩЕНО добавлять всё подряд, историю изменений (changelogs) и абсолютные пути (только относительные). Храни только действительно важные архитектурные ограничения и явные указания разработчика.
 11. **Обязательный полный самоаудит**: При создании новых сущностей ОБЯЗАТЕЛЬНО проверяй ВЕСЬ файл целиком. Строго контролируй отсутствие дублирования (DRY) и соблюдение всех правил проекта. *Исключение: мелкие правки существующего кода не требуют полного аудита.*

package/src/types/webTypes.ts

@@ -120,12 +120,12 @@ export type WebTypesVueComponentItem = WebTypesInfo & {
  * Корневой объект для JSON Web Types.
  */
 export type WebTypesVueJson = {
-  $schema: string
-  framework: 'vue'
-  name: string
-  version: string
+  '$schema': string
+  'framework': 'vue'
+  'name': string
+  'version': string
   'js-types-syntax'?: 'typescript'
-  contributions: {
+  'contributions': {
     html: {
       'description-markup': 'markdown'
       'vue-components': WebTypesVueComponentItem[]