@dxtmisha/scripts 0.10.10 → 0.10.11

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.10.11] - 2026-08-05
+
+### Changed
+- **DesignTypes**: Updated AI JSDoc generation prompt rules in `toAiEdit` to delete JSDocs for obvious entities and generate concise (1-line) or detailed descriptions for non-obvious entities based on JS code inspection.
+- **DesignTypes**: Extended `toAiMcpPrompts` to include `ai-types.md` and `ai-description.md` alongside prompt files when generating MCP server resources (`ai-mcp.json`).
+
+## [0.10.10] - 2026-08-05
+
+### Changed
+- **AI Prompts**: Updated prompt templates (`aiCodeGlobalPrompt.en.md`, `aiCodeGlobalPrompt.ru.md`) to strictly mandate recording developer preferences into package `ai-memory.md` files.
+
 ## [0.10.9] - 2026-08-03
 
 ### Changed

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.10.10",
+  "version": "0.10.11",
   "type": "module",
   "description": "Development scripts and CLI tools for DXT UI projects - automated component generation, library building and project management tools",
   "keywords": [

package/src/classes/Design/DesignTypes.ts

@@ -60,9 +60,22 @@ export class DesignTypes {
     const promptList = this.getListPrompts()
     const prompts = await this.toAiPrompts(promptList)
 
-    this.saveDescription(`${aiDescription}\n${prompts}`)
-
-    const mcpPrompts = await this.toAiMcpPrompts(promptList)
+    const fullDescription = `${aiDescription}\n${prompts}`
+    this.saveDescription(fullDescription)
+
+    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)
@@ -233,12 +246,7 @@ export class DesignTypes {
       PropertiesFile.writeByPath(
         UI_FILE_AI_TYPES,
         [
-          `1) All these methods are in the ${packageJson.name} library.`,
-          '2) Everything that is exported can be used.',
-          '3) Use what is in this library if it exists; do not use other libraries if there is an analogue here. Do not create new ones if an analogue already exists here.',
-          '',
-          'The following is the content of "exports" from package.json:',
-          JSON.stringify(packageJson.exports, null, 2),
+          `All these methods are in the ${packageJson.name} library.`,
           '',
           content
         ].join('\n')
@@ -337,14 +345,16 @@ export class DesignTypes {
       + '- Do NOT return the provided JS code in your response.\n\n'
       + 'JSDOC & COMMENT RULES:\n'
       + '- STUDY THE PROVIDED JS CODE: You are explicitly provided with the JS implementation code (`File JS Code`). You MUST study the JS code for every function/method/property to understand its exact logic, behavior, and purpose.\n'
-      + '- GENERATE MISSING JSDOCS FROM JS CODE: If an entity lacks a JSDoc comment in the input declarations, but its provided JS code implementation reveals its behavior or purpose, you MUST generate and add a clear, fluff-free English JSDoc description directly above its declaration.\n'
-      + '- DEFINITION OF OBVIOUS (NO JSDOC): An entity is "obvious" ONLY IF its name uses clear, standard English naming conventions (e.g., `isString`, `capitalize`, `copyObject`) AND its functionality is 100% self-evident from its signature alone. Obvious entities MUST NOT have a JSDoc.\n'
-      + '- MANDATORY JSDOC FOR NON-OBVIOUS ENTITIES: Any entity with an obscure, non-standard, custom, abbreviated, or ambiguous name (e.g., `abutaSudatoho`, `transformation`), or complex logic, MUST have a clear English JSDoc description generated by inspecting its JS implementation code.\n'
-      + '- Write JSDoc comments WITHOUT fluff or filler text, focusing strictly on operational logic and behavior.\n'
+      + '- IF AN EXISTING JSDOC / COMMENT IS PRESENT:\n'
+      + '  * Obvious entities (e.g., `isString`, `capitalize`, `copyObject`): DELETE the JSDoc / comment entirely.\n'
+      + '  * Non-obvious entities: OPTIMIZE the existing JSDoc — remove fluff, translate to clear English, and PRESERVE ONLY `@example`, `@remarks`, `@note`, and `@warning` tags (remove all other JSDoc tags).\n'
+      + '- IF NO JSDOC / COMMENT IS PRESENT:\n'
+      + '  * Obvious entities: DO NOTHING (do NOT add any JSDoc).\n'
+      + '  * Moderately non-obvious entities (obscure, custom, abbreviated, or ambiguous naming): Generate and add a SHORT, concise, 1-line English JSDoc description derived from inspecting its JS implementation code.\n'
+      + '  * Very unclear or highly complex entities (intricate operational logic, complex parameters, or subtle side effects): Generate and add a DETAILED, comprehensive English JSDoc description derived from inspecting its JS implementation code.\n'
       + '- Place all JSDoc comments STRICTLY directly above the target declaration.\n'
       + '- Translate all non-English comments and JSDocs to English.\n'
       + '- Remove regular inline comments (`//` or `/* ... */`).\n'
-      + '- STRICTLY PRESERVE all JSDoc tags like `@example`, `@remarks`, `@note`, and warnings—keep them intact, translating only to English if needed.\n\n'
       + 'CLEANING & OPTIMIZATION:\n'
       + '- Remove all `import` statements and local internal re-exports (e.g., `export * from "./..."`). Strictly KEEP exports from external packages.\n'
       + '- Delete all non-public content (private/protected class members, unexported elements). Keep all public API surfaces.\n'
@@ -447,10 +457,10 @@ export class DesignTypes {
   }
 
   /**
-   * Generates MCP server resources structure for prompt files using AI.
+   * Generates MCP server resources structure for prompt, type definition, and description files using AI.
    *
-   * Генерирует структуру ресурсов MCP-сервера для файлов промптов с помощью ИИ.
-   * @param list list of prompt files / список файлов промптов
+   * Генерирует структуру ресурсов MCP-сервера для файлов промптов, определений типов и описаний с помощью ИИ.
+   * @param list list of documentation files / список файлов документации
    * @returns object with resources array or undefined / объект со массивом ресурсов или undefined
    */
   protected async toAiMcpPrompts(list: DesignTypesList): Promise<DesignMcpResources | undefined> {