@dxtmisha/scripts 1.1.10 → 1.2.1

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.2.1] - 2026-09-19
+
+### Fixed
+- **Empty Type Declaration File Saving (`DesignTypesMake`)**:
+  - Fixed an issue in `DesignTypesMake.make()` where declaration files with empty content (such as files without exportable declarations or with bodies removed during preprocessing) were treated as failures, triggering false `[Warning] Failed to generate AI types for: ...` warnings. Checking `content !== undefined` instead of `if (content)` ensures empty declaration files are saved and cached properly.
+
+### Changed
+- **Documentation & Workflow Overhaul (`README.md`)**:
+  - Restructured `README.md` to document the full AI pipeline and design system toolchain.
+  - Added a numbered CLI workflow guide covering `dxt-types`, `dxt-types-save`, `dxt-prompt`, `dxt-component`, `dxt-constructor`, `dxt-library`, `dxt-screenshot`, and `dxt-build-packages`.
+  - Updated programmatic usage examples demonstrating `DesignTypes`, `LibraryAiPrompt`, `ComponentCreator`, and `LibraryExport`.
+  - Detailed foundational principles: Zero Hallucination by Design, Search Before Full Scan, Non-Destructive Agent Rules, Developer Experience First, and TypeScript-first.
+  - Clarified architectural differentiation of `@dxtmisha/scripts` as an integrated bridge between design system architecture and AI coding agents.
+
+## [1.2.0] - 2026-09-18
+
+### Added
+- **`LibraryAiPromptAgents` Class**:
+  - Implemented `LibraryAiPromptAgents` to synchronize and inject `ai-prompt.md` instructions into `AGENTS.md`.
+  - Added boundary markers (`<!-- START:ai-prompt md5:... -->` ... `<!-- END:ai-prompt -->`) with non-fixed length MD5 checksums to detect prompt changes, update the block in place, and preserve surrounding user-defined rules.
+  - Added automatic file initialization if `AGENTS.md` does not exist and appending logic for files without markers.
+  - Exported `LibraryAiPromptAgents` from `src/library.ts`.
+- **AI Agents Prompt Templates**:
+  - Added bilingual template files `src/media/templates/prompts/aiPromptAgents.en.md` and `src/media/templates/prompts/aiPromptAgents.ru.md` specifying preparation rules and strict action protocols for AI agents.
+- **Configuration Constant**:
+  - Added `UI_FILE_AI_AGENTS = 'AGENTS.md'` in `src/config.ts`.
+- **Unit Tests**:
+  - Added comprehensive test suite `LibraryAiPromptAgents.test.ts` for MD5 verification, marker detection, and update mechanics.
+
+### Changed
+- **`LibraryAiPrompt` Workflow**:
+  - Integrated `this.makeAgents()` into `LibraryAiPrompt.make()` to automatically synchronize `AGENTS.md` during prompt generation (`dxt-prompt`).
+  - Extracted `new LibraryAiMcp().make()` into a dedicated protected method `makeMcp()`.
+
 ## [1.1.10] - 2026-09-14
 
 ### Changed

package/README.md

@@ -4,27 +4,31 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
 
-`@dxtmisha/scripts` is a powerful suite of development scripts and CLI tools designed specifically for automating workflows in modern UI libraries.
+`@dxtmisha/scripts` is a powerful suite of development scripts, CLI tools, and an AI context engineering engine designed specifically for modern UI libraries and TypeScript monorepos. It bridges the gap between design systems and Large Language Models (LLMs) — transforming complex codebases into token-efficient, context-rich type summaries (`ai-types.md`) and consolidated system prompts (`ai-prompt.md`, `AGENTS.md`), while automating component scaffolding, token compilation, and library exports.
 
 ## Why this library?
 
-Maintaining a UI library inevitably involves a lot of repetitive boilerplate: creating component files, writing basic props interfaces, setting up Storybook configuration, keeping index barrel files updated, and maintaining documentation. Typically each project solves these by copying and pasting folders or writing ad-hoc shell scripts that break over time.
+Maintaining a UI library and pairing with AI coding assistants (Claude, Gemini, ChatGPT, Antigravity, Cursor) introduces two major challenges. On one hand, developers face repetitive boilerplate: scaffolding components, writing props interfaces, managing barrel exports, compiling tokens, and taking screenshots. On the other hand, feeding raw codebases or standard `.d.ts` declaration files into LLMs quickly exhausts context windows with internal implementation noise, leading to hallucinations, invented props, and broken design token conventions.
 
-`scripts` brings all these solutions together in one place — thoughtful, tested, and ready to use. It automates the mundane work, providing a cohesive toolset to scaffold components, generate documentation (including AI-assisted text), and automatically manage library exports, ensuring your UI project remains structured and easy to scale.
+`scripts` brings all these solutions together into a unified, tested toolkit. It provides an automated AI pipeline that cleans TypeScript declarations via AST transforms and generates search-optimized type definitions (`dxt-types`), assembles consolidated system prompts with safe `AGENTS.md` synchronization (`dxt-prompt`), and automates the entire UI lifecycle from component creation (`dxt-component`) to monorepo package building (`dxt-build-packages`).
 
 ## What does it do?
 
-For **component scaffolding** — automatic generation of full Vue component templates. A single command sets up `.vue` files, `props.ts`, `styleToken.scss`, and barrel exports, complete with TypeScript definitions.
+For **AI prompt consolidation (`dxt-prompt`)** — `LibraryAiPrompt` scans workspace packages and dependencies to build a unified `ai-prompt.md` system prompt. It consolidates global development rules, Vue style guides (`--vue`), package overviews, links to specialized `ai-resources/*.md` guides, type definitions, and visual screenshot references. It safely synchronizes rules into `AGENTS.md` using MD5-tracked boundary comments without overwriting developer instructions, and generates MCP (Model Context Protocol) configurations (`--mcp`).
 
-For **design system orchestration** — a robust suite of classes to parse TypeScript props, manage constructor configurations, and synchronize design tokens.
+For **AI-optimized type generation (`dxt-types`)** — `DesignTypes` compiles TypeScript declarations, strips private/internal symbols via AST transformation (`DesignTypesMakeTsTransformer`), caches unchanged files via MD5 diffing, and uses AI to generate a minimal, token-efficient `ai-types.md`. It injects searchable `@keywords` tags and concise bilingual (EN/RU) JSDoc comments so AI agents can look up signatures instantly before scanning files. It also generates package summaries (`ai-description.md`), MCP server definitions (`ai-mcp.json`), and handles gitignore rules.
 
-For **documentation & Storybook** — tools to generate `.stories.ts` and `.mdx` files automatically. It can even utilize Google's AI (Gemini) or Anthropic's Claude to generate component descriptions and technical docs.
+For **fast cached type rebuilding (`dxt-types-save`)** — an instant offline command that re-assembles `ai-types.md` and MCP resources directly from cached `ai-types-list/` chunks without calling external LLM APIs, ideal for CI/CD pipelines and fast local builds.
 
-For **Figma integration** — a complete Figma API client capable of fetching styles, analyzing design nodes, and translating them into usable code structures.
+For **component scaffolding (`dxt-component`)** — automatic generation of full Vue component templates. A single command sets up `.vue` files, `props.ts`, `styleToken.scss`, and barrel exports, complete with TypeScript definitions.
 
-For **visual testing** — browser automation using Puppeteer to capture and process component screenshots across different states and themes.
+For **design system orchestration (`dxt-constructor`)** — a robust suite of classes to parse TypeScript props, manage constructor configurations, and synchronize design tokens.
 
-For **library management** — automated maintenance of `index.ts` files (barrel exports) across packages, ensuring all components and utilities are correctly exposed.
+For **visual screenshot capture (`dxt-screenshot`)** — browser automation using Puppeteer to capture high-resolution WebP component screenshots across themes and states, extracting rendered DOM HTML and computed styles for multimodal AI visual inspection.
+
+For **library management (`dxt-library`)** — automated maintenance of `index.ts` files (barrel exports) across packages, ensuring all components and utilities are correctly exposed.
+
+For **monorepo build orchestration (`dxt-build-packages`)** — topologically ordered compilation and publishing (`dxt-build-publish-packages`) of workspace packages.
 
 ## Installation
 
@@ -39,47 +43,65 @@ npm install -D @dxtmisha/scripts
 ### CLI Commands
 
 ```bash
-# Generate component scaffolds in empty directories
-npx dxt-component
+# 1. Compile declarations and generate AI-optimized type definitions (ai-types.md)
+npx dxt-types
 
-# Generate wiki documentation for a specific component
-npx dxt-component-wiki MyButton
+# 2. Fast rebuild of ai-types.md from cache without calling AI APIs
+npx dxt-types-save
 
-# Build component constructors
+# 3. Generate consolidated ai-prompt.md, update AGENTS.md, and create MCP resources
+npx dxt-prompt --mcp --vue
+
+# 4. Scaffold component templates in empty directories
+npx dxt-component
+
+# 5. Build component constructors and token bindings
 npx dxt-constructor
 
-# Rebuild library exports
+# 6. Rebuild library index exports
 npx dxt-library
 
-# Full UI project build
-npx dxt-ui
+# 7. Capture component screenshots for multimodal AI context
+npx dxt-screenshot
+
+# 8. Build all monorepo packages in dependency order
+npx dxt-build-packages
 ```
 
 ### Programmatic Usage
 
 ```typescript
-import { ComponentCreator, AiGoogle, LibraryExport } from '@dxtmisha/scripts'
-
-// Generate component scaffolds
+import {
+  DesignTypes,
+  LibraryAiPrompt,
+  ComponentCreator,
+  LibraryExport
+} from '@dxtmisha/scripts'
+
+// 1. Generate AI-optimized types (ai-types.md, ai-description.md, ai-mcp.json)
+const types = new DesignTypes()
+await types.make()
+
+// 2. Consolidate repository AI prompt (ai-prompt.md) and sync AGENTS.md
+const prompt = new LibraryAiPrompt([], true, true)
+prompt.make()
+
+// 3. Scaffold component templates
 const creator = new ComponentCreator()
 creator.make()
 
-// AI-powered generation
-const ai = new AiGoogle()
-ai.setModel('gemini-1.5-flash')
-const result = await ai.generate('Create props interface for Button component')
-
-// Library export management
+// 4. Manage barrel exports
 const library = new LibraryExport()
 library.make()
 ```
 
 ## Principles
 
-- **Developer Experience First** — commands are simple, outputs are predictable. You shouldn't have to write boilerplate.
-- **TypeScript-first** — strict typing and autocomplete out of the box. Ships source directly, making it easy to integrate into modern tooling environments.
-- **AI-Enhanced** — embraces LLMs to speed up tedious documentation and scaffolding tasks.
-- **Clean API** — predictable behavior and clear naming for programmatically managing UI systems.
+- **Zero Hallucination by Design** — bounded, verified AI context. Generating compact `ai-types.md` and consolidated `ai-prompt.md` files prevents LLMs from guessing signatures or misinterpreting tokens.
+- **Search Before Full Scan** — `@keywords` indexing and structured headers allow AI agents to quickly retrieve needed types via text search without burning context tokens on massive files.
+- **Non-Destructive Agent Rules** — updates to `AGENTS.md` are performed strictly within MD5-tracked marker blocks, preserving developer-specific instructions.
+- **Developer Experience First** — commands are simple, outputs are predictable. You shouldn't have to write boilerplate or manually maintain exports and documentation prompts.
+- **TypeScript-first** — strict typing and AST-level transformations out of the box, integrating seamlessly into modern monorepo tooling.
 
 ## Documentation
 
@@ -89,7 +111,7 @@ Full API reference, examples, and guides:
 
 ## Difference from other tools
 
-- **`@dxtmisha/scripts`** — specifically tailored for the internal architecture of DXT UI, integrating deeply with our property management and Storybook setup. Not a generic scaffolding tool like Yeoman or Plop.
+- **`@dxtmisha/scripts`** — an integrated design system engine combining UI scaffolding, token compilation, and specialized AI context generation (`ai-types.md`, `ai-prompt.md`, `AGENTS.md`, MCP). Not just a generic generator like Yeoman or Plop, but an end-to-end bridge between design system architecture and AI coding agents.
 
 ## License
 

package/dist/config.d.ts

@@ -82,6 +82,9 @@ export declare const UI_DIRS_WIKI: string[];
 /** SCSS file extension/ Расширение файлов SCSS */
 export declare const UI_EXTENSION_STYLE = "scss";
 
+/** AI agents instruction file name / Название файла инструкций для агентов AI */
+export declare const UI_FILE_AI_AGENTS = "AGENTS.md";
+
 /** AI description file name / Название файла с описанием AI */
 export declare const UI_FILE_AI_DESCRIPTION = "ai-description.md";
 

package/dist/config.js

@@ -10,11 +10,11 @@ var e = "design.config.json", t = "@dxtmisha", n = "constructor", r = `${t}/${n}
 	"functions",
 	"global",
 	"types"
-], P = ".gitignore", ee = "package.json", F = "properties.json", I = "ai-description.md", L = "ai-doc.md", R = "ai-instruction.md", z = "ai-prompt.md", B = "ai-types.md", V = "ai-developer.md", H = "screenshot.json", U = "screenshot-code.html", W = "screenshot-styles.css", G = "flags", K = "media", q = "design", J = "plugin", Y = "style", X = "wiki", Z = "vite.config.ts", Q = "vite-workers.config.ts", $ = "index.ts", te = "ai-types.md", ne = "ai-description.md", re = "ai-mcp-resources.json", ie = "ai-mcp-all-resources.json", ae = "ai-mcp-all-resources.ts", oe = "style.scss", se = "ui-properties.scss", ce = "scss", le = "classes", ue = [
+], P = ".gitignore", ee = "package.json", F = "properties.json", I = "AGENTS.md", L = "ai-description.md", R = "ai-doc.md", z = "ai-instruction.md", B = "ai-prompt.md", V = "ai-types.md", H = "ai-developer.md", U = "screenshot.json", W = "screenshot-code.html", G = "screenshot-styles.css", K = "flags", q = "media", J = "design", Y = "plugin", X = "style", Z = "wiki", Q = "vite.config.ts", $ = "vite-workers.config.ts", te = "index.ts", ne = "ai-types.md", re = "ai-description.md", ie = "ai-mcp-resources.json", ae = "ai-mcp-all-resources.json", oe = "ai-mcp-all-resources.ts", se = "style.scss", ce = "ui-properties.scss", le = "scss", ue = "classes", de = [
 	"disabled",
 	"focus",
 	"readonly",
 	"read-only"
 ];
 //#endregion
-export { e as UI_CONFIG_FILE, w as UI_DIRS_AI_WIKI, D as UI_DIRS_COMPONENTS, O as UI_DIRS_CONSTRUCTOR, M as UI_DIRS_FILE_EXPORT, E as UI_DIRS_ICONS, A as UI_DIRS_LIBRARY, N as UI_DIRS_LIST_EXPORT, k as UI_DIRS_STYLES, T as UI_DIRS_TOKENS, j as UI_DIRS_WIKI, l as UI_DIR_AI, u as UI_DIR_AI_PROMPT_SCREENSHOT, d as UI_DIR_AI_TYPES, f as UI_DIR_AI_TYPES_LIST, p as UI_DIR_AI_TYPES_TEMPORARY, h as UI_DIR_COMPONENTS, g as UI_DIR_CONSTRUCTOR, b as UI_DIR_DIST, x as UI_DIR_DIST_TEMPORARY, c as UI_DIR_IN, C as UI_DIR_PACKAGES, S as UI_DIR_PROMPT, m as UI_DIR_RESOURCES, _ as UI_DIR_STRUCTURE, y as UI_DIR_TEMPORARY, v as UI_DIR_WIKI, ce as UI_EXTENSION_STYLE, ne as UI_FILE_AI_DESCRIPTION, re as UI_FILE_AI_MCP, ie as UI_FILE_AI_MCP_ALL, ae as UI_FILE_AI_MCP_ALL_TS, I as UI_FILE_AI_PROMPT_DESCRIPTION, V as UI_FILE_AI_PROMPT_DEVELOPER, L as UI_FILE_AI_PROMPT_INFO, R as UI_FILE_AI_PROMPT_INSTRUCTION, z as UI_FILE_AI_PROMPT_PROMPT, U as UI_FILE_AI_PROMPT_SCREENSHOT_CODE, H as UI_FILE_AI_PROMPT_SCREENSHOT_JSON, W as UI_FILE_AI_PROMPT_SCREENSHOT_STYLES, B as UI_FILE_AI_PROMPT_TYPES, te as UI_FILE_AI_TYPES, P as UI_FILE_GITIGNORE, $ as UI_FILE_INDEX, q as UI_FILE_NAME_DESIGN, G as UI_FILE_NAME_FLAGS, K as UI_FILE_NAME_MEDIA, J as UI_FILE_NAME_PLUGIN, Y as UI_FILE_NAME_STYLE, Z as UI_FILE_NAME_VITE, Q as UI_FILE_NAME_VITE_WORKERS, X as UI_FILE_NAME_WIKI, ee as UI_FILE_PACKAGE, F as UI_FILE_PROPERTY, se as UI_FILE_STYLE_PROPERTIES, oe as UI_FILE_STYLE_SCSS, s as UI_FLAG_NOT_EXPORT, a as UI_KEY_CONSTRUCTOR, o as UI_KEY_CUSTOM, i as UI_MODULES, r as UI_PROJECT_CONSTRUCTOR_FULL_NAME, n as UI_PROJECT_CONSTRUCTOR_NAME, t as UI_PROJECT_NAME, ue as UI_PROPERTY_FOR_PROPS, le as UI_STRUCTURE_CLASSES };
+export { e as UI_CONFIG_FILE, w as UI_DIRS_AI_WIKI, D as UI_DIRS_COMPONENTS, O as UI_DIRS_CONSTRUCTOR, M as UI_DIRS_FILE_EXPORT, E as UI_DIRS_ICONS, A as UI_DIRS_LIBRARY, N as UI_DIRS_LIST_EXPORT, k as UI_DIRS_STYLES, T as UI_DIRS_TOKENS, j as UI_DIRS_WIKI, l as UI_DIR_AI, u as UI_DIR_AI_PROMPT_SCREENSHOT, d as UI_DIR_AI_TYPES, f as UI_DIR_AI_TYPES_LIST, p as UI_DIR_AI_TYPES_TEMPORARY, h as UI_DIR_COMPONENTS, g as UI_DIR_CONSTRUCTOR, b as UI_DIR_DIST, x as UI_DIR_DIST_TEMPORARY, c as UI_DIR_IN, C as UI_DIR_PACKAGES, S as UI_DIR_PROMPT, m as UI_DIR_RESOURCES, _ as UI_DIR_STRUCTURE, y as UI_DIR_TEMPORARY, v as UI_DIR_WIKI, le as UI_EXTENSION_STYLE, I as UI_FILE_AI_AGENTS, re as UI_FILE_AI_DESCRIPTION, ie as UI_FILE_AI_MCP, ae as UI_FILE_AI_MCP_ALL, oe as UI_FILE_AI_MCP_ALL_TS, L as UI_FILE_AI_PROMPT_DESCRIPTION, H as UI_FILE_AI_PROMPT_DEVELOPER, R as UI_FILE_AI_PROMPT_INFO, z as UI_FILE_AI_PROMPT_INSTRUCTION, B as UI_FILE_AI_PROMPT_PROMPT, W as UI_FILE_AI_PROMPT_SCREENSHOT_CODE, U as UI_FILE_AI_PROMPT_SCREENSHOT_JSON, G as UI_FILE_AI_PROMPT_SCREENSHOT_STYLES, V as UI_FILE_AI_PROMPT_TYPES, ne as UI_FILE_AI_TYPES, P as UI_FILE_GITIGNORE, te as UI_FILE_INDEX, J as UI_FILE_NAME_DESIGN, K as UI_FILE_NAME_FLAGS, q as UI_FILE_NAME_MEDIA, Y as UI_FILE_NAME_PLUGIN, X as UI_FILE_NAME_STYLE, Q as UI_FILE_NAME_VITE, $ as UI_FILE_NAME_VITE_WORKERS, Z as UI_FILE_NAME_WIKI, ee as UI_FILE_PACKAGE, F as UI_FILE_PROPERTY, ce as UI_FILE_STYLE_PROPERTIES, se as UI_FILE_STYLE_SCSS, s as UI_FLAG_NOT_EXPORT, a as UI_KEY_CONSTRUCTOR, o as UI_KEY_CUSTOM, i as UI_MODULES, r as UI_PROJECT_CONSTRUCTOR_FULL_NAME, n as UI_PROJECT_CONSTRUCTOR_NAME, t as UI_PROJECT_NAME, de as UI_PROPERTY_FOR_PROPS, ue as UI_STRUCTURE_CLASSES };

package/dist/library-ui.js

@@ -1,6 +1,6 @@
 import { n as e, t } from "./PropertiesConfig-BBsuNndv.js";
 import { UI_DIRS_COMPONENTS as n, UI_DIRS_CONSTRUCTOR as r, UI_DIRS_ICONS as i, UI_DIRS_LIBRARY as a, UI_DIRS_STYLES as o, UI_DIRS_TOKENS as s, UI_DIRS_WIKI as c, UI_DIR_COMPONENTS as l, UI_DIR_CONSTRUCTOR as u, UI_DIR_DIST as d, UI_DIR_STRUCTURE as f, UI_EXTENSION_STYLE as p, UI_FILE_NAME_DESIGN as ee, UI_FILE_NAME_MEDIA as te, UI_FILE_NAME_PLUGIN as ne, UI_FILE_NAME_STYLE as re, UI_FILE_NAME_WIKI as ie, UI_FILE_PACKAGE as ae, UI_FILE_PROPERTY as m, UI_FILE_STYLE_PROPERTIES as oe, UI_FILE_STYLE_SCSS as se, UI_KEY_CUSTOM as ce, UI_PROJECT_CONSTRUCTOR_FULL_NAME as le, UI_PROJECT_CONSTRUCTOR_NAME as h, UI_PROPERTY_FOR_PROPS as ue, UI_STRUCTURE_CLASSES as de } from "./config.js";
-import { a as g, i as fe, n as _, r as v, t as y } from "./propertyTypes-CstobYcc.js";
+import { a as g, i as fe, n as _, r as v, t as y } from "./propertyTypes-CeW8CD8G.js";
 import { ServerStorage as pe, copyObject as me, forEach as b, getColumn as x, isArray as S, isFilled as C, isNull as he, isObject as w, isObjectNotArray as T, isSelected as E, isString as ge, replaceComponentName as _e, replaceRecursive as D, splice as ve, strFill as ye, toArray as O, toCamelCase as k, toCamelCaseFirst as A, toKebabCase as j, uniqueArray as be } from "@dxtmisha/functional-basic";
 import M from "typescript";
 import * as xe from "sass";

package/dist/library.d.ts

@@ -3482,6 +3482,20 @@ export declare class LibraryAiPrompt {
      * Основной метод для генерации файла промпта ИИ.
      */
     make(): void;
+    /**
+     * Injects and synchronizes the ai-prompt guidelines in AGENTS.md.
+     *
+     * Внедряет и синхронизирует инструкции ai-prompt в AGENTS.md.
+     * @protected
+     */
+    protected makeAgents(): void;
+    /**
+     * Generates MCP configuration and resources.
+     *
+     * Генерирует конфигурацию и ресурсы MCP.
+     * @protected
+     */
+    protected makeMcp(): void;
     /**
      * Checks whether the library should be excluded from the ai-prompt.md file based on configuration.
      *
@@ -3595,6 +3609,104 @@ export declare class LibraryAiPrompt {
     protected writeMcp(mcpData: Record<string, any>[]): this;
 }
 
+/**
+ * Class for injecting and synchronizing the ai-prompt guidelines into AGENTS.md.
+ * Tracks changes using MD5 hashes and boundary markers to preserve existing content in AGENTS.md.
+ *
+ * Класс для внедрения и синхронизации инструкций ai-prompt в AGENTS.md.
+ * Отслеживает изменения с помощью хэшей MD5 и граничных меток для сохранения существующего контента в AGENTS.md.
+ */
+export declare class LibraryAiPromptAgents {
+    protected readonly targetFile: string;
+    /** Regular expression to find marked ai-prompt section with MD5 / Регулярное выражение для поиска размеченной секции ai-prompt с MD5 */
+    protected readonly exMarker: RegExp;
+    /**
+     * Constructor for LibraryAiPromptAgents.
+     *
+     * Конструктор для LibraryAiPromptAgents.
+     * @param targetFile Target agents file path / Путь к целевому файлу agents
+     */
+    constructor(targetFile?: string);
+    /**
+     * Generates or updates the ai-prompt section in AGENTS.md if changed.
+     *
+     * Генерирует или обновляет секцию ai-prompt в AGENTS.md при наличии изменений.
+     */
+    make(): void;
+    /**
+     * Checks if boundary markers exist in the given content.
+     *
+     * Проверяет, присутствуют ли граничные метки в переданном контенте.
+     * @param content File content to check / Содержимое файла для проверки
+     * @returns true if markers found / true, если метки найдены
+     * @protected
+     */
+    protected isMarker(content: string): boolean;
+    /**
+     * Returns the prompt template content.
+     *
+     * Возвращает содержимое шаблона промпта.
+     * @returns Raw prompt content string / Исходная строка содержимого промпта
+     * @protected
+     */
+    protected getContent(): string;
+    /**
+     * Generates initial content for a new AGENTS.md file.
+     *
+     * Генерирует начальное содержимое для нового файла AGENTS.md.
+     * @param section Formatted ai-prompt section / Отформатированная секция ai-prompt
+     * @returns Initial file content / Начальное содержимое файла
+     * @protected
+     */
+    protected getInitial(section: string): string;
+    /**
+     * Calculates MD5 hash of the prompt template content.
+     *
+     * Вычисляет MD5 хэш содержимого шаблона промпта.
+     * @returns Calculated MD5 hex string / Вычисленная hex-строка MD5
+     * @protected
+     */
+    protected getMd5(): string;
+    /**
+     * Wraps the prompt content in HTML comment boundary markers with MD5 hash.
+     *
+     * Оборачивает контент промпта в граничные маркеры комментариев HTML с MD5 хэшем.
+     * @param md5 MD5 hash checksum (defaults to this.getMd5()) / Контрольная сумма хэша MD5 (по умолчанию this.getMd5())
+     * @returns Formatted section with start and end markers / Отформатированная секция с начальной и конечной метками
+     * @protected
+     */
+    protected getSection(md5?: string): string;
+    /**
+     * Updates the marked ai-prompt section if boundary markers exist.
+     *
+     * Обновляет размеченную секцию ai-prompt, если граничные метки существуют.
+     * @param existingContent Current file content / Текущее содержимое файла
+     * @param section Formatted section to insert / Отформатированная секция для вставки
+     * @returns true if updated, false if up to date or markers not found / true, если обновлено, false, если актуально или метки не найдены
+     * @protected
+     */
+    protected updateMarker(existingContent: string, section: string): boolean;
+    /**
+     * Appends the ai-prompt section to the end of the file.
+     *
+     * Добавляет секцию ai-prompt в конец файла.
+     * @param existingContent Current file content / Текущее содержимое файла
+     * @param section Formatted section to append / Отформатированная секция для добавления
+     * @returns true if file was updated / true, если файл был обновлен
+     * @protected
+     */
+    protected append(existingContent: string, section: string): boolean;
+    /**
+     * Writes content to the target file.
+     *
+     * Записывает контент в целевой файл.
+     * @param content Content to write / Контент для записи
+     * @returns this instance / этот экземпляр
+     * @protected
+     */
+    protected write(content: string): this;
+}
+
 /**
  * Class representing an item in the AI prompt generation process.
  * Handles reading and aggregating various project-related files (descriptions, info, types, screenshots)