@dxtmisha/scripts 0.11.2 → 0.11.4

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.11.4] - 2026-08-19
+
+### Changed
+- **AI Types Save Workflow (`dxt-types-save`)**:
+  - Added MCP resources generation (`await this.mcp.make()`) into `DesignTypes.makeSave()` to automatically generate and synchronize MCP resource manifests (`ai-mcp.json`) when running fast type saving.
+
+## [0.11.3] - 2026-08-19
+
+### Added
+- **Constants**: Added `UI_DIR_RESOURCES` (`'resources'`) directory constant in `src/config.ts`.
+- **Scaffolding Template**: Added `"screenshot": "dxt-screenshot"` script entry to the library package template (`src/media/templates/packages/library/package.json`).
+
+### Changed
+- **AI Prompt Metadata Separation & Granular Cache**:
+  - Split prompt metadata caching from monolithic `prompts.json` files into individual JSON files saved in `ai-types-list/resources/`.
+  - Updated `DesignTypesPrompts` to read, aggregate, and persist prompt cache items as separate `.json` files in the resources directory.
+  - Added `getCacheDir()`, `getCachePath()`, and `saveCacheItem()` methods in `DesignTypesPrompts` to manage individual prompt metadata files.
+  - Refactored `make()` and `toAiPromptItem()` to write prompt cache files immediately on change.
+- **AI Types Save Workflow (`dxt-types-save`)**:
+  - Made `DesignTypes.makeSave()` asynchronous (`Promise<this>`) and added automatic package description generation via `await this.description.make()`.
+  - Updated `bin/design-types-save.ts` to await `makeSave()`.
+
 ## [0.11.2] - 2026-08-14
 
 ### Changed

package/bin/design-types-save.ts

@@ -7,3 +7,4 @@ const resourcesDir: string = process.argv?.[3]
 
 new DesignTypes(dir, resourcesDir)
   .makeSave()
+  .then()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.11.2",
+  "version": "0.11.4",
   "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": [

package/src/classes/Design/DesignTypes.ts

@@ -76,10 +76,12 @@ export class DesignTypes {
    * Генерирует определения типов путем объединения обработанных файлов из директории ai-types-list без запуска ИИ.
    * @returns current instance / текущий экземпляр
    */
-  makeSave(): this {
+  async makeSave(): Promise<this> {
     console.log('DesignTypes: saving AI types from list...')
 
     this.makeTypes.makeSave()
+    await this.description.make()
+    await this.mcp.make()
 
     console.log('DesignTypes: AI types saved.')
 

package/src/classes/Design/DesignTypesPrompts.ts

@@ -12,12 +12,12 @@ import type {
   DesignTypesPromptResult
 } from '../../types/designTypes'
 
-import { UI_MODULES } from '../../config'
+import { UI_DIR_AI_TYPES_LIST, UI_DIR_RESOURCES, UI_MODULES } from '../../config'
 
 /**
- * Class for reading prompt files and generating AI project rules and prompt triggers description.
+ * Class for reading prompt files, managing individual prompt metadata files, and generating AI project rules and prompt triggers description.
  *
- * Класс для чтения файлов промптов и генерации описания правил проекта ИИ и триггеров промптов.
+ * Класс для чтения файлов промптов, управления отдельными файлами метаданных промптов и генерации описания правил проекта ИИ и триггеров промптов.
  */
 export class DesignTypesPrompts {
   /** Cached list of prompt files / Кэшированный список файлов с промптами */
@@ -39,17 +39,33 @@ export class DesignTypesPrompts {
   ) { }
 
   /**
-   * Reads and returns the prompt cache list from the JSON cache file.
+   * Reads and returns the prompt cache list from individual JSON files in the resources directory.
    *
-   * Читает и возвращает список кэша промптов из JSON файла кэша.
+   * Читает и возвращает список кэша промптов из отдельных JSON файлов в директории ресурсов.
    * @returns prompt cache list / список кэша промптов
    */
   getCacheList(): DesignTypesPromptCacheList {
     if (this.cacheList === undefined) {
-      const cachePath = this.getCachePath()
-      const data = PropertiesFile.readFile<DesignTypesPromptCacheList>(cachePath)
+      const cacheDir = this.getCacheDir()
+      const files = PropertiesFile.readDirRecursive(cacheDir)
+      const list: DesignTypesPromptCacheList = []
+
+      for (const file of files) {
+        if (file.endsWith('.json')) {
+          const item = PropertiesFile.readFile<DesignTypesPromptCacheItem>([cacheDir, file])
+
+          if (
+            item
+            && isFilled(item.path)
+            && isFilled(item.name)
+            && isFilled(item.description)
+          ) {
+            list.push(item)
+          }
+        }
+      }
 
-      this.cacheList = Array.isArray(data) ? data : []
+      this.cacheList = list
     }
 
     return this.cacheList
@@ -114,25 +130,16 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Processes prompt files using AI and updates the JSON cache file if changes are detected.
+   * Processes prompt files using AI and updates individual JSON cache files if changes are detected.
    *
-   * Обрабатывает файлы промптов с помощью ИИ и обновляет JSON файл кэша при обнаружении изменений.
+   * Обрабатывает файлы промптов с помощью ИИ и обновляет отдельные JSON файлы кэша при обнаружении изменений.
    * @returns current instance / текущий экземпляр
    */
   async make(): Promise<this> {
     const list = this.getListPrompts()
-    let isCacheChanged = false
 
     for (const item of list) {
-      const result = await this.toAiPromptItem(item)
-
-      if (result.isChanged) {
-        isCacheChanged = true
-      }
-    }
-
-    if (isCacheChanged) {
-      this.saveCacheList(this.getCacheList())
+      await this.toAiPromptItem(item)
     }
 
     return this
@@ -157,13 +164,31 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Gets the cache JSON file path for prompts.
+   * Gets the cache directory path for individual prompt JSON files.
    *
-   * Получает путь к JSON файлу кэша для промптов.
+   * Получает путь к директории кэша для отдельных JSON файлов промптов.
+   * @returns cache directory path / путь к директории кэша
+   */
+  protected getCacheDir(): string {
+    return PropertiesFile.joinPath([UI_DIR_AI_TYPES_LIST, UI_DIR_RESOURCES])
+  }
+
+  /**
+   * Gets the cache JSON file path for a specific prompt file path.
+   *
+   * Получает путь к JSON файлу кэша для конкретного пути к файлу промпта.
+   * @param path relative file path of the prompt / относительный путь к файлу промпта
    * @returns cache JSON file path / путь к JSON файлу кэша
    */
-  protected getCachePath(): string {
-    return `${this.promptsDir}/prompts.json`
+  protected getCachePath(path: string): string {
+    const relativePath = path
+      .replace(new RegExp(`^${this.promptsDir}/`), '')
+      .replace(/\.[^/.]+$/, '.json')
+
+    return PropertiesFile.joinPath([
+      this.getCacheDir(),
+      relativePath
+    ])
   }
 
   /**
@@ -193,14 +218,30 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Saves the prompt cache list to the JSON cache file.
+   * Saves an individual prompt cache item to its JSON cache file.
+   *
+   * Сохраняет отдельный элемент кэша промпта в его JSON файл кэша.
+   * @param item prompt cache item to save / элемент кэша промпта для сохранения
+   */
+  protected saveCacheItem(item: DesignTypesPromptCacheItem): void {
+    PropertiesFile.writeByPath(
+      this.getCachePath(item.path),
+      item
+    )
+  }
+
+  /**
+   * Saves the prompt cache list to individual JSON cache files.
    *
-   * Сохраняет список кэша промптов в JSON файл кэша.
+   * Сохраняет список кэша промптов в отдельные JSON файлы кэша.
    * @param cache cache list to save / список кэша для сохранения
    */
   protected saveCacheList(cache: DesignTypesPromptCacheList): void {
     this.cacheList = cache
-    PropertiesFile.writeByPath(this.getCachePath(), cache)
+
+    for (const item of cache) {
+      this.saveCacheItem(item)
+    }
   }
 
   /**
@@ -230,9 +271,9 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Processes a single prompt file item using cache or AI into a formatted rule entry string and updates cache list if changed.
+   * Processes a single prompt file item using cache or AI into a formatted rule entry string and updates individual cache file if changed.
    *
-   * Обрабатывает один элемент файла промпта с использованием кэша или ИИ в отформатированную строку правила и обновляет список кэша при изменениях.
+   * Обрабатывает один элемент файла промпта с использованием кэша или ИИ в отформатированную строку правила и обновляет отдельный файл кэша при изменениях.
    * @param item prompt file item / элемент файла промпта
    * @returns object with formatted rule string and changed flag / объект с отформатированной строкой правила и флагом изменений
    */
@@ -278,6 +319,8 @@ export class DesignTypesPrompts {
         cache.push(newItem)
       }
 
+      this.saveCacheItem(newItem)
+
       return {
         prompt: this.getPromptLine(item.path, data.description),
         isChanged: true

package/src/config.ts

@@ -27,6 +27,8 @@ export const UI_DIR_AI = 'ai'
 export const UI_DIR_AI_PROMPT_SCREENSHOT = 'ai-screenshot'
 /** AI types list directory name / Название директории со списком типов AI */
 export const UI_DIR_AI_TYPES_LIST = 'ai-types-list'
+/** Resources directory name / Название директории ресурсов */
+export const UI_DIR_RESOURCES = 'resources'
 /** Components directory name/ Название директории компонентов */
 export const UI_DIR_COMPONENTS = 'components'
 /** Constructors directory name/ Название директории конструкторов */

package/src/media/templates/packages/library/_.gitignore.txt

@@ -12,6 +12,8 @@ dist-ssr
 *.local
 
 ai-types.md
+ai-description.md
+ai-resources
 
 # Editor directories and files
 .vscode/*

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

@@ -12,6 +12,7 @@
     "component": "dxt-component",
     "library": "dxt-library",
     "types": "npm run library && npm run build && dxt-types",
+    "screenshot": "dxt-screenshot",
     "wiki": "dxt-ai-doc",
     "prepublishOnly": "npm run library && npm run build && dxt-types-save",
     "publish-to-npm": "npm publish --access public"